attrValueEq

Attribute values are JSON-serializable so documents round-trip losslessly and a CRDT adapter can map them onto its own primitives without special-casing.

export type AttrValue
  = | string
    | number
    | boolean
    | null
    | readonly AttrValue[]
    | { readonly [key: string]: AttrValue };

An inline formatting mark applied to a run of text (bold, italic, link, ...). type is the registry key; attrs holds mark-specific data (e.g. link href).

interface Mark

A normalized set of marks: at most one per type, sorted by type.

export type Marks = readonly Mark[];

A run of text sharing the same marks. The chosen inline representation ("marked runs") renders to per-block contenteditable as a span list and maps isomorphically onto a character-sequence CRDT with formatting.

interface InlineNode

A block's inline content: an ordered, normalized list of runs.

export type Inline = readonly InlineNode[];

A document block. id is stable across split/merge/move.

interface Node

A block's content. Three shapes, chosen by the block's schema: - Inline for text blocks (paragraph, heading, list item), - readonly Node[] for container blocks (reserved; no default block uses it), - null for atom/void blocks (image, divider).

export type Content = Inline | readonly Node[] | null;

The writekit document: an ordered list of top-level blocks. Default blocks are flat (lists use indent attributes, not nesting), so document helpers operate on the top-level array.

interface WritekitDocument