@spec delete(value :: delete_val(), attr :: attributes_val()) :: delete_op()

A shorthand for new("delete", value, attributes). See new/3.

Examples

iex> Op.delete(1, %{"bold" => true})
%{"delete" => 1, "attributes" => %{"bold" => true}}copy

@spec delete?(op :: t(), type :: any()) :: boolean()

A shorthand for type?(op, "delete", type). See type?/3.

Examples

iex> Op.delete(1) |> Op.delete?()
truecopy

@spec get_embed_data!(map(), map()) :: {any(), any(), any()}

Gets two embeds' data. An embed is always a one-key map

Examples

iex> Op.get_embed_data!(
...>   %{"image" => "https://quilljs.com/assets/images/icon.png"},
...>   %{"image" => "https://quilljs.com/assets/images/icon2.png"}
...> )
{"image", "https://quilljs.com/assets/images/icon.png", "https://quilljs.com/assets/images/icon2.png"}copy

@spec has_attributes?(any()) :: boolean()

Returns true if operation has attributes

Examples

iex> Op.has_attributes?(%{"insert" => "Hello", "attributes" => %{"bool" => true}})
true

iex> Op.has_attributes?(%{"insert" => "Hello"})
falsecopy

@spec insert(value :: insert_val(), attr :: attributes_val()) :: insert_op()

A shorthand for new("insert", value, attributes). See new/3.

Examples

iex> Op.insert("Hello", %{"bold" => true})
%{"insert" => "Hello", "attributes" => %{"bold" => true}}copy

@spec insert?(op :: t(), type :: any()) :: boolean()

A shorthand for type?(op, "insert", type). See type?/3.

Examples

iex> Op.insert("Hello") |> Op.insert?()
truecopy

@spec new(action :: operation(), value :: operation_val(), attr :: attributes_val()) ::
  t()

Create a new operation.

Note that operations are maps, and not structs.

Examples

iex> Op.new("insert", "Hello", %{"bold" => true})
%{"insert" => "Hello", "attributes" => %{"bold" => true}}copy

@spec retain(value :: retain_val(), attr :: attributes_val()) :: retain_op()

A shorthand for new("retain", value, attributes). See new/3.

Examples

iex> Op.retain(1, %{"bold" => true})
%{"retain" => 1, "attributes" => %{"bold" => true}}copy

@spec retain?(op :: t(), type :: any()) :: boolean()

A shorthand for type?(op, "insert", type). See type?/3.

Examples

iex> Op.retain(1) |> Op.retain?()
truecopy

@spec size(t()) :: non_neg_integer()

Returns operation size.

Examples

iex> Op.insert("Hello") |> Op.size()
5

iex> Op.retain(3) |> Op.size()
3copy

@spec take(op :: t(), length :: non_neg_integer(), opts :: Keyword.t()) ::
  {t(), t() | boolean()}

Takes length characters from an operation and returns it together with the remaining part in a tuple.

Options

• :align - when true, allow moving index left if we're likely to split a grapheme otherwise.

Examples

iex> Op.insert("Hello") |> Op.take(3)
{%{"insert" => "Hel"}, %{"insert" => "lo"}}

iex> assert_raise RuntimeError, fn -> Op.insert("🏴󠁧󠁢󠁳󠁣󠁴󠁿") |> Op.take(1) end

iex> Op.insert("🏴󠁧󠁢󠁳󠁣󠁴󠁿") |> Op.take(1, align: true)
{%{"insert" => ""}, %{"insert" => "🏴󠁧󠁢󠁳󠁣󠁴󠁿"}}copy

@spec text_size(text :: binary()) :: non_neg_integer()

Returns text size.

Examples

iex> Op.text_size("Hello")
5

iex> Op.text_size("🏴󠁧󠁢󠁳󠁣󠁴󠁿")
14copy

@spec type?(op :: t(), action :: any(), value_type :: any()) :: boolean()

Returns true if operation is of type type. Optionally check against more specific value_type.

Examples

iex> Op.insert("Hello") |> Op.type?("insert")
true

iex> Op.insert("Hello") |> Op.type?("insert", :string)
true

iex> Op.insert("Hello") |> Op.type?("insert", :number)
false

iex> Op.retain(1) |> Op.type?("retain", :number)
truecopy