Quillon.Transform.Normalize (Quillon v0.1.0)

Copy Markdown View Source

Normalization operations for text nodes.

Normalizes content by:

  1. Removing empty text nodes
  2. Merging adjacent text nodes with identical marks

Summary

Types

children()

List of inline children (text nodes)

text_node()

A text node tuple

Functions

empty_text?(arg)

Check if a text node is empty.

merge_adjacent(list)

Merge adjacent text nodes with identical marks.

mergeable?(arg1, arg2)

Check if two text nodes can be merged (same marks).

normalize(children)

Normalize a list of text nodes.

normalize_block(arg)

Normalize a paragraph or heading node.

remove_empty(children)

Remove empty text nodes from a list.

Types

children()

@type children() :: [text_node()]

List of inline children (text nodes)

text_node()

@type text_node() :: {:text, %{text: String.t(), marks: list()}, []}

A text node tuple

Functions

empty_text?(arg)

@spec empty_text?(text_node()) :: boolean()

Check if a text node is empty.

Examples

iex> Quillon.Transform.Normalize.empty_text?({:text, %{text: "", marks: []}, []})
true

iex> Quillon.Transform.Normalize.empty_text?({:text, %{text: "Hi", marks: []}, []})
false

merge_adjacent(list)

@spec merge_adjacent(children()) :: children()

Merge adjacent text nodes with identical marks.

Uses loose equality (compares marks only, ignores text content).

Examples

iex> children = [
...>   {:text, %{text: "A", marks: []}, []},
...>   {:text, %{text: "B", marks: []}, []},
...>   {:text, %{text: "C", marks: []}, []}
...> ]
iex> Quillon.Transform.Normalize.merge_adjacent(children)
[{:text, %{text: "ABC", marks: []}, []}]

iex> children = [
...>   {:text, %{text: "Hello", marks: [:bold]}, []},
...>   {:text, %{text: " world", marks: []}, []}
...> ]
iex> Quillon.Transform.Normalize.merge_adjacent(children)
[
  {:text, %{text: "Hello", marks: [:bold]}, []},
  {:text, %{text: " world", marks: []}, []}
]

mergeable?(arg1, arg2)

@spec mergeable?(text_node(), text_node()) :: boolean()

Check if two text nodes can be merged (same marks).

Examples

iex> n1 = {:text, %{text: "Hello", marks: [:bold, :italic]}, []}
iex> n2 = {:text, %{text: " world", marks: [:italic, :bold]}, []}
iex> Quillon.Transform.Normalize.mergeable?(n1, n2)
true

iex> n1 = {:text, %{text: "Hello", marks: [:bold]}, []}
iex> n2 = {:text, %{text: " world", marks: []}, []}
iex> Quillon.Transform.Normalize.mergeable?(n1, n2)
false

normalize(children)

@spec normalize(children()) :: children()

Normalize a list of text nodes.

Removes empty text nodes and merges adjacent nodes with identical marks.

Examples

iex> children = [
...>   {:text, %{text: "Hello", marks: [:bold]}, []},
...>   {:text, %{text: " world", marks: [:bold]}, []},
...>   {:text, %{text: "", marks: []}, []}
...> ]
iex> Quillon.Transform.Normalize.normalize(children)
[{:text, %{text: "Hello world", marks: [:bold]}, []}]

iex> Quillon.Transform.Normalize.normalize([])
[]

normalize_block(arg)

@spec normalize_block(tuple()) :: tuple()

Normalize a paragraph or heading node.

Examples

iex> para = {:paragraph, %{}, [
...>   {:text, %{text: "Hello", marks: [:bold]}, []},
...>   {:text, %{text: " world", marks: [:bold]}, []}
...> ]}
iex> Quillon.Transform.Normalize.normalize_block(para)
{:paragraph, %{}, [{:text, %{text: "Hello world", marks: [:bold]}, []}]}

remove_empty(children)

@spec remove_empty(children()) :: children()

Remove empty text nodes from a list.

Examples

iex> children = [
...>   {:text, %{text: "Hello", marks: []}, []},
...>   {:text, %{text: "", marks: []}, []},
...>   {:text, %{text: "world", marks: []}, []}
...> ]
iex> Quillon.Transform.Normalize.remove_empty(children)
[
  {:text, %{text: "Hello", marks: []}, []},
  {:text, %{text: "world", marks: []}, []}
]