@searsuite/sear-domain-doc

Registry that maps persisted rich-document node types to constructors.

Built-in paragraph node.

Base class for rich-document nodes used by the document layout engine.

Ordered registry for plugin-owned top-level block flow resolution.

Ordered registry for plugin-owned rich-text inline style readers and mutations.

Ordered registry for plugin-owned rich-text line box resolution.

Built-in table cell node.

Built-in table block node.

Built-in table row node.

Built-in text leaf node.

Cursor position inside a RichDocNode tree.

path is an array of integer indices that navigates from the implicit document root (the RichDocNode[] array treated as root.content) down to the text node that contains the cursor.

Examples for a flat document: [0, 0] → paragraph 0 → text node 0 (the most common case in P0) [1, 2] → paragraph 1 → inline span 2

The path aligns with OT operation paths: a StringInsert at this cursor becomes { p: [...path, offset], si: text } applied to the root wrapper { type: 'doc', content: doc }.

offset is the character position within the leaf text node: 0 = before first character n = after the nth character (= text.length means "end of node")

Registration contract for one persisted rich-document node type.

Anchor + head selection model. Collapsed selection (cursor only): anchor === head. head moves freely; anchor is fixed until a non-Shift action resets it.

One text-node replacement produced by an inline text range edit.

Context supplied when patching one selected text-node segment.

Minimal factory interface for creating document nodes. Implemented by DocNodeRegistry (static or injected).

Plugin-owned contribution that can refine block flow metrics.

Input used to resolve the flow spacing after one top-level document block.

Domain-side contract for services that provide measured rich-text block layout.

Plugin-owned contribution for one inline text style concern.

Plugin-owned mutation for one persisted inline text-style concern.

Input supplied when an inline-style contribution mutates persisted text-node attrs.

Input supplied when an inline-style contribution reads document attrs.

Flow metrics for one rich-text line.

Plugin-owned contribution that can refine rich-text line flow metrics.

Input used to resolve the flow box for one measured rich-text line.

Persisted or default line-spacing policy resolved by paragraph layout.

Resolved paragraph layout values consumed by line and block flow.

Default paragraph layout values supplied by the owning document runtime.

A generic text attribute range in document-relative character offsets.

One grapheme range expressed in UTF-16 source offsets.

Public contract for TextSelection.

Stable identity used by document layout and retained render nodes.

Type contract for DocNodeRole.

Patches the attrs for the selected segment of one text node.

Measured inline character/token used by rich-text line wrapping.

Domain-neutral inline style bag carried by measured rich-text chars.

One laid-out rich-text line with aggregate dimensions.

Supported paragraph line-spacing semantics.

Attributes merged into a text node for one presentation range.

Neutral defaults for runtimes that do not configure document paragraph spacing.

Node roles used by generic rich-document editing and layout helpers.

Persisted paragraph attribute keys owned by the paragraph feature.

Applies an inline text range patch plan to an immutable document snapshot.

Applies or removes one persisted inline-text style property.

Replaces registered styles while retaining text, structure and unrelated attributes.

Applies presentation attributes to text ranges without owning their meaning. Plugins decide how to interpret the resulting text-node attrs.

Builds reusable text-node split/replacement patches for a document selection.

Captures the leading text run's explicit registered styles, excluding host defaults.

Returns a detached mutable snapshot of a rich document.

Lexicographic comparison of two cursor positions. Compares path element-by-element, then offset. Returns -1 | 0 | 1.

Compute the Y coordinate of the first text line's baseline for vertical centering.

Text painters in this engine position runs by their alphabetic baseline, so the correct formula to visually center a line inside a padded box is:

baseline = center + (fontAscent - fontDescent) / 2

Since lineHeight = fontAscent + fontDescent, this simplifies to:

baseline = offsetY + cellPadding + (boxHeight - 2·cellPadding + 2·fontAscent - lineHeight) / 2

Creates the paragraph-owned default after-spacing contribution.

Creates the default line box contribution used by document composition roots.

Creates a typed document node id from a non-empty string value.

Creates a fallback document node id from a rich-document path.

Create a single empty paragraph containing one empty text node.

Creates the compatibility inline text-style attrs patcher for property/value callers.

Creates the paragraph-owned line-spacing contribution.

Converts a cursor position into a zero-based offset in the document's plain text, using one newline character between paragraphs.

Character length of the text node at path. Returns 0 for missing / non-text nodes.

Runs the is collapsed helper.

Returns true if every paragraph in doc contains no meaningful text.

Returns true when a rich-document node is a text leaf.

Repositions a cursor after an inline text range patch plan has been applied.

Ensure doc has at least one paragraph. Returns the same array if already valid; otherwise [createEmptyParagraph()].

Normalize selection so start ≤ end regardless of direction.

Extract the concatenated plain text of a paragraph node.

Total plain-text length of a paragraph node (sums all direct text children).

Parses a persisted line-spacing override, returning null when invalid.

Parses a persisted paragraph-spacing override, returning null when invalid.

Reads the inline text-style attribute bag from a node's attributes.

Registers the paragraph node type owned by paragraph-oriented document features.

Registers the table node types owned by table-oriented document features.

Registers the text node type owned by text-input document features.

Replaces one inline text-style property on the selected document range.

Resolves a block-level document id, preferring persisted node identity over path fallback.

Resolve the text node at path inside doc (treated as the root content array). Returns undefined if the path is invalid.

Resolves paragraph-owned overrides over the runtime defaults.

Get the plain-text string of the node at path. Convenience wrapper around resolveNode.

Segments text into grapheme ranges, with a code-point fallback for older hosts.

Convert a plain string to a single-paragraph RichDocNode[]. Used for backward-compat when cell data is still stored as a plain string.

Updates one entry in a text node's style attrs bag.

Persisted rich-document node schema shared by document runtime, commands, and OT.

Persisted rich-document schema node.

Persisted text-bearing rich-document node schema.