@notectl/core 2.2.6 → 2.3.1

package/dist/serialization/markdown/GfmTableParser.d.ts

@@ -0,0 +1,26 @@
+/**
+ * GFM table detection and row parsing.
+ *
+ * A table is a header row, a delimiter row (`| --- | :--: |`), and zero or more
+ * body rows. Column alignment is derived from the colons in the delimiter row.
+ * Cells hold raw inline text, parsed later by the inline tokenizer.
+ */
+/** Column alignment derived from the delimiter row. */
+export type ColumnAlign = 'start' | 'center' | 'end' | null;
+/** A parsed GFM table (cells are raw inline strings). */
+export interface TableData {
+    readonly aligns: readonly ColumnAlign[];
+    readonly header: readonly string[];
+    readonly rows: readonly (readonly string[])[];
+    readonly linesConsumed: number;
+}
+/**
+ * Attempts to parse a GFM table beginning at `start`. Returns the table data or
+ * null when the two leading lines are not a header + delimiter pair. The body
+ * extends until a blank line or the start of another block (`interrupts`); a
+ * plain paragraph-like line inside that range is a lazy single-cell row, per
+ * the GFM spec ("the table is broken at the first empty line or beginning of
+ * another block-level structural element").
+ */
+export declare function matchTable(lines: readonly string[], start: number, interrupts?: (line: string) => boolean): TableData | null;
+//# sourceMappingURL=GfmTableParser.d.ts.map

package/dist/serialization/markdown/GfmTableParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GfmTableParser.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/GfmTableParser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,uDAAuD;AACvD,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,CAAC;AAE5D,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,CAAC;IAC9C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAC/B;AAyCD;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,GACpC,SAAS,GAAG,IAAI,CAqBlB"}

package/dist/serialization/markdown/InlineAst.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Inline AST node model + linked-list helpers shared by the inline parser.
+ *
+ * A doubly-linked list of nodes is used during parsing so the emphasis
+ * delimiter-stack algorithm runs in linear time (no array splicing), which is
+ * the ReDoS-safety guarantee for untrusted pasted Markdown (D1).
+ */
+/** Inline AST node kind. */
+export type InlineKind = 'text' | 'code' | 'softbreak' | 'hardbreak' | 'emph' | 'strong' | 'strike' | 'highlight' | 'sup' | 'sub' | 'link' | 'image' | 'inline_node' | 'html_inline';
+/** A single inline AST node (mutable; linked into a sibling list). */
+export interface InlineAstNode {
+    type: InlineKind;
+    /** Literal text for `text` / `code` / `html_inline`. */
+    literal: string;
+    /** Container children (`emph`, `strong`, `link`, …). */
+    children: InlineAstNode[];
+    /** Link/image destination + title. */
+    href: string;
+    title: string;
+    /** Image alt text (plain). */
+    alt: string;
+    /** Generic inline-node passthrough (plugin extensions, e.g. math). */
+    inlineType: string;
+    attrs: Record<string, string | number | boolean>;
+    prev: InlineAstNode | null;
+    next: InlineAstNode | null;
+}
+/** Creates a fresh inline AST node of the given kind. */
+export declare function makeNode(type: InlineKind, literal?: string): InlineAstNode;
+/** Appends `node` after `target` in the sibling linked list. */
+export declare function insertAfter(target: InlineAstNode, node: InlineAstNode): void;
+/** Removes `node` from its sibling linked list. */
+export declare function unlink(node: InlineAstNode): void;
+//# sourceMappingURL=InlineAst.d.ts.map

package/dist/serialization/markdown/InlineAst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineAst.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/InlineAst.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4BAA4B;AAC5B,MAAM,MAAM,UAAU,GACnB,MAAM,GACN,MAAM,GACN,WAAW,GACX,WAAW,GACX,MAAM,GACN,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,aAAa,GACb,aAAa,CAAC;AAEjB,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,UAAU,CAAC;IACjB,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;IAChB,wDAAwD;IACxD,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IACjD,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAC3B;AAED,yDAAyD;AACzD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,SAAK,GAAG,aAAa,CAatE;AAED,gEAAgE;AAChE,wBAAgB,WAAW,CAAC,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI,CAK5E;AAED,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAKhD"}

package/dist/serialization/markdown/InlineSerializers.d.ts

@@ -0,0 +1,5 @@
+import { InlineNode, TextNode } from '../../model/Document.js';
+import { SerContext } from './MarkdownContext.js';
+/** Serializes inline children of a leaf block to a Markdown string. */
+export declare function serializeInlineContent(children: readonly (TextNode | InlineNode)[], ctx: SerContext): string;
+//# sourceMappingURL=InlineSerializers.d.ts.map

package/dist/serialization/markdown/InlineSerializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineSerializers.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/InlineSerializers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAQ,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAI1E,OAAO,EAAE,KAAK,UAAU,EAAiB,MAAM,sBAAsB,CAAC;AAqQtE,uEAAuE;AACvE,wBAAgB,sBAAsB,CACrC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,UAAU,CAAC,EAAE,EAC5C,GAAG,EAAE,UAAU,GACb,MAAM,CAyCR"}

package/dist/serialization/markdown/InlineTokenizer.d.ts

@@ -0,0 +1,5 @@
+import { InlineNode, TextNode } from '../../model/Document.js';
+import { ParseContext } from './MarkdownParseContext.js';
+/** Parses inline Markdown into text/inline nodes (linear-time, ReDoS-safe). */
+export declare function parseInline(text: string, ctx: ParseContext): (TextNode | InlineNode)[];
+//# sourceMappingURL=InlineTokenizer.d.ts.map

package/dist/serialization/markdown/InlineTokenizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InlineTokenizer.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/InlineTokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAQ,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAmB1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AA66B9D,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,GAAG,CAAC,QAAQ,GAAG,UAAU,CAAC,EAAE,CAOtF"}

package/dist/serialization/markdown/LinkReferenceExtractor.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Link reference definition extraction (`[label]: dest "title"`).
+ *
+ * Runs as a pre-pass over the source before block tokenization, mirroring how
+ * commonmark.js resolves references before inline parsing. CommonMark rules
+ * honored here:
+ *
+ * - A definition never interrupts an open paragraph (a def-shaped line that
+ *   lazily continues a paragraph stays paragraph text).
+ * - Def-shaped lines inside fenced code are code and survive verbatim.
+ * - The destination may sit on the line after the label, and a title may sit
+ *   on its own following line (multi-line labels and multi-line titles are not
+ *   supported; such lines stay paragraph text, which never drops content).
+ * - Titles honor backslash escapes; destinations and titles decode escapes and
+ *   entity references; labels match case-folded (Unicode, `ẞ` ↔ `SS`).
+ * - A definition inside a blockquote is recognized too; the quote marker line
+ *   is kept so the (now empty) container survives.
+ *
+ * First definition of a label wins, as per spec.
+ */
+/** A link reference definition target. */
+export interface LinkRef {
+    readonly href: string;
+    readonly title?: string;
+}
+/**
+ * Case-folds a reference label for matching. `toUpperCase().toLowerCase()`
+ * approximates Unicode case folding (it maps `ẞ`/`ß` and `SS` to the same
+ * string), which plain `toLowerCase()` does not.
+ */
+export declare function foldReferenceLabel(label: string): string;
+/** Removes link reference definitions from the source and returns them as a map. */
+export declare function extractLinkReferences(source: string): {
+    source: string;
+    linkRefs: Map<string, LinkRef>;
+};
+//# sourceMappingURL=LinkReferenceExtractor.d.ts.map

package/dist/serialization/markdown/LinkReferenceExtractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LinkReferenceExtractor.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/LinkReferenceExtractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH,0CAA0C;AAC1C,MAAM,WAAW,OAAO;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACxB;AAcD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD;AAED,oFAAoF;AACpF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG;IACtD,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CA+CA"}

package/dist/serialization/markdown/MarkdownContext.d.ts

@@ -0,0 +1,32 @@
+import { MarkdownExportContext } from '../../model/NodeSpec.js';
+import { SchemaRegistry } from '../../model/SchemaRegistry.js';
+import { MarkdownSerializeOptions } from '../MarkdownTypes.js';
+/** Fully-resolved serialization options (no `undefined`). */
+export interface ResolvedSerializeOptions {
+    readonly flavor: 'commonmark' | 'gfm';
+    readonly gfm: boolean;
+    readonly htmlFallback: boolean;
+    readonly headingStyle: 'atx' | 'setext';
+    readonly bullet: string;
+    readonly emphasis: string;
+    readonly codeFence: string;
+    readonly listIndent: number;
+}
+/** Internal context shared by all serialization helpers. */
+export interface SerContext {
+    readonly registry?: SchemaRegistry;
+    readonly opts: ResolvedSerializeOptions;
+    /** Precomputed mark rank map (built once per pass) for HTML-fallback marks. */
+    readonly markOrder?: Map<string, number>;
+    /**
+     * True while serializing the block children of a list item (#194): thematic
+     * breaks emit `***` there, because `---` on an indented continuation line
+     * would re-parse as a setext underline or a bullet marker.
+     */
+    readonly inListItem?: boolean;
+}
+/** Resolves user-facing options into a complete settings object with defaults. */
+export declare function resolveSerializeOptions(options?: MarkdownSerializeOptions): ResolvedSerializeOptions;
+/** Builds the public {@link MarkdownExportContext} passed to per-spec hooks. */
+export declare function exportContext(opts: ResolvedSerializeOptions): MarkdownExportContext;
+//# sourceMappingURL=MarkdownContext.d.ts.map

package/dist/serialization/markdown/MarkdownContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownContext.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/MarkdownContext.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAEpE,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACxC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,KAAK,GAAG,QAAQ,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,kFAAkF;AAClF,wBAAgB,uBAAuB,CACtC,OAAO,CAAC,EAAE,wBAAwB,GAChC,wBAAwB,CAY1B;AAED,gFAAgF;AAChF,wBAAgB,aAAa,CAAC,IAAI,EAAE,wBAAwB,GAAG,qBAAqB,CAEnF"}

package/dist/serialization/markdown/MarkdownEntities.d.ts

@@ -0,0 +1,33 @@
+/**
+ * HTML entity and backslash-escape decoding shared by the Markdown parser.
+ *
+ * CommonMark recognizes entity and numeric character references (and backslash
+ * escapes) not only in inline text but also inside link destinations, link
+ * titles, link reference definitions, and code-fence info strings. The small
+ * built-in table covers the common names; uncommon names are decoded through
+ * the environment's HTML parser when a DOM is available (browser, happy-dom),
+ * because embedding the full HTML5 table (~2200 names) would bloat the chunk.
+ * Without a DOM (pure Node) unknown entities stay literal, which never loses
+ * content.
+ */
+/** Characters a backslash may escape (CommonMark ASCII punctuation). */
+export declare const ESCAPABLE: RegExp;
+/**
+ * Decodes a single HTML entity body (without `&`/`;`), or returns it verbatim.
+ * Per CommonMark, U+0000 and invalid code points decode to U+FFFD; decoded
+ * line separators become plain spaces so a text node never carries a raw
+ * newline (block boundaries are structural in the editor model).
+ */
+export declare function decodeEntity(body: string): string;
+/** Matches an entity reference at `pos` in `text`, or null. */
+export declare function matchEntityAt(text: string, pos: number): RegExpExecArray | null;
+/**
+ * Decodes backslash escapes and entity references in a single left-to-right
+ * pass (an escaped `&` therefore never starts an entity). Used for the string
+ * contexts CommonMark decodes outside inline text: link destinations, titles,
+ * reference definitions, and fence info strings.
+ */
+export declare function decodeEscapesAndEntities(text: string): string;
+/** Decodes only entity references (escapes were already consumed by the caller). */
+export declare function decodeEntitiesOnly(text: string): string;
+//# sourceMappingURL=MarkdownEntities.d.ts.map

package/dist/serialization/markdown/MarkdownEntities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownEntities.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/MarkdownEntities.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,wEAAwE;AACxE,eAAO,MAAM,SAAS,QAAmB,CAAC;AAmB1C;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcjD;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAG/E;AAiBD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB7D;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAiBvD"}

package/dist/serialization/markdown/MarkdownEscape.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CommonMark escaping rules for Markdown serialization.
+ *
+ * Escaping is contextual: inline text backslash-escapes characters that would
+ * otherwise start emphasis/code/links, while the start of a line additionally
+ * escapes block markers (`#`, `>`, `-`, …) so prose never accidentally becomes
+ * a heading or list on re-parse. Output stays minimal: we do not escape every
+ * punctuation character, only those that are actually ambiguous in context.
+ */
+/**
+ * Escapes inline text so it round-trips as literal content. `~` is escaped only
+ * for GFM (where `~~` is strikethrough); `_` is escaped only when it is not
+ * intra-word, matching CommonMark's emphasis rules (so `a_b_c` stays literal).
+ */
+export declare function escapeInline(text: string, gfm: boolean): string;
+/**
+ * Escapes leading block markers at the start of a paragraph line so the text
+ * does not re-parse as a heading, blockquote, list, thematic break, setext
+ * underline, or code fence.
+ */
+export declare function escapeLineStart(line: string): string;
+/** Escapes the destination of a link/image so spaces and parens stay intact. */
+export declare function escapeLinkDestination(url: string): string;
+/** Escapes a link/image title for the `"..."` form. */
+export declare function escapeLinkTitle(title: string): string;
+/**
+ * Picks a backtick fence long enough to wrap `content` as an inline code span.
+ * CommonMark requires a fence longer than any backtick run inside the content.
+ */
+export declare function codeSpanFence(content: string): string;
+/** Wraps `content` in a correctly sized inline code span, padding when needed. */
+export declare function wrapCodeSpan(content: string): string;
+//# sourceMappingURL=MarkdownEscape.d.ts.map

package/dist/serialization/markdown/MarkdownEscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownEscape.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/MarkdownEscape.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAeH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,MAAM,CAuB/D;AA0BD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsBpD;AAED,gFAAgF;AAChF,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKzD;AAED,uDAAuD;AACvD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAErD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAYrD;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAUpD"}

package/dist/serialization/markdown/MarkdownHTMLRegistry.d.ts

@@ -0,0 +1,4 @@
+import { SchemaRegistry } from '../../model/SchemaRegistry.js';
+/** Resolves the schema at an HTML boundary without supplementing an explicit schema. */
+export declare function resolveMarkdownHTMLRegistry(registry?: SchemaRegistry): SchemaRegistry;
+//# sourceMappingURL=MarkdownHTMLRegistry.d.ts.map

package/dist/serialization/markdown/MarkdownHTMLRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownHTMLRegistry.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/MarkdownHTMLRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAU/D,wFAAwF;AACxF,wBAAgB,2BAA2B,CAAC,QAAQ,CAAC,EAAE,cAAc,GAAG,cAAc,CAIrF"}

package/dist/serialization/markdown/MarkdownParseContext.d.ts

@@ -0,0 +1,23 @@
+import { SchemaRegistry } from '../../model/SchemaRegistry.js';
+import { MarkdownParseOptions, MarkdownSyntaxExtension } from '../MarkdownTypes.js';
+/** Fully-resolved parse options (no `undefined`). */
+export interface ResolvedParseOptions {
+    readonly flavor: 'commonmark' | 'gfm';
+    readonly gfm: boolean;
+    readonly extendedInlineSyntax: boolean;
+    readonly htmlFallback: boolean;
+    readonly syntaxExtensions: readonly MarkdownSyntaxExtension[];
+}
+/** Internal context shared by the block and inline parsers. */
+export interface ParseContext {
+    readonly registry?: SchemaRegistry;
+    readonly opts: ResolvedParseOptions;
+    /** Link reference definitions collected from the source (`[ref]: url "title"`). */
+    readonly linkRefs: ReadonlyMap<string, {
+        readonly href: string;
+        readonly title?: string;
+    }>;
+}
+/** Resolves user-facing parse options into a complete settings object with defaults. */
+export declare function resolveParseOptions(options?: MarkdownParseOptions): ResolvedParseOptions;
+//# sourceMappingURL=MarkdownParseContext.d.ts.map

package/dist/serialization/markdown/MarkdownParseContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MarkdownParseContext.d.ts","sourceRoot":"","sources":["../../../src/serialization/markdown/MarkdownParseContext.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,OAAO,KAAK,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAEzF,qDAAqD;AACrD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,MAAM,EAAE,YAAY,GAAG,KAAK,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,oBAAoB,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,uBAAuB,EAAE,CAAC;CAC9D;AAED,+DAA+D;AAC/D,MAAM,WAAW,YAAY;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,mFAAmF;IACnF,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,oBAAoB,CASxF"}

package/dist/state/Mapping.d.ts

@@ -81,16 +81,37 @@ export interface BlockRemovalMap {
  * (`{blockId, offset}`) is unaffected — the new block has no prior
  * positions, and positions inside other siblings keep their offsets.
  *
- * Only consumed by {@link mapChildIndex}.
+ * Consumed by {@link mapChildIndex}, {@link mapInsertionIndex}, and exact
+ * structural inverse detection during history replay.
  */
 export interface ChildIndexShiftMap {
     readonly type: 'childIndexShift';
     readonly parentPath: readonly BlockId[];
     readonly fromIndex: number;
     readonly delta: number;
+    /**
+     * IDs introduced by an InsertNodeStep. Optional for synthetic/test maps;
+     * when present it makes the map an exact structural inverse of the matching
+     * BlockRemovalMap during history replay.
+     */
+    readonly insertedBlockIds?: ReadonlySet<BlockId>;
+}
+/**
+ * One existing subtree moves between child lists. Positions inside the moved
+ * subtree keep their block IDs and offsets; sibling child indices in both
+ * parents are shifted by the removal followed by the insertion.
+ */
+export interface MoveNodeMap {
+    readonly type: 'moveNode';
+    readonly movedNodeId: BlockId;
+    readonly fromParentPath: readonly BlockId[];
+    readonly fromIndex: number;
+    readonly toParentPath: readonly BlockId[];
+    /** Destination index after removing the source node. */
+    readonly destinationIndex: number;
 }
 /** Discriminated union of all StepMap variants. */
-export type StepMap = IdentityMap | ShiftMap | SplitMap | MergeMap | BlockRemovalMap | ChildIndexShiftMap;
+export type StepMap = IdentityMap | ShiftMap | SplitMap | MergeMap | BlockRemovalMap | ChildIndexShiftMap | MoveNodeMap;
 /** Result of mapping a single position. */
 export interface MapResult {
     readonly pos: Position;
@@ -147,9 +168,10 @@ export declare class Mapping {
      */
     map(pos: Position, assoc?: Assoc): Position;
     /**
-     * Like {@link map}, but returns whether the position landed in deleted
-     * content at any step. Once a position is marked deleted, the flag is
-     * sticky — subsequent steps do not "un-delete" it.
+     * Like {@link map}, but returns whether the position is deleted in the final
+     * frame. Content deletion remains sticky across every later map. Structural
+     * deletion can be recovered by an `insertNode` map carrying the same block
+     * ID; a later removal can mark that identity deleted again.
      */
     mapResult(pos: Position, assoc?: Assoc): MapResult;
     /**
@@ -207,7 +229,7 @@ export declare function mapOffsetInBlock(blockId: BlockId, offset: number, mappi
  *
  * Child-indices live in a coordinate space orthogonal to positions
  * (`{blockId, offset}`): they describe a slot in a parent's child list,
- * not a place inside text. Only two {@link StepMap} categories carry
+ * not a place inside text. Three {@link StepMap} categories carry
  * child-index-affecting information:
  *
  * - {@link ChildIndexShiftMap} (produced by `insertNode`): shifts
@@ -215,6 +237,8 @@ export declare function mapOffsetInBlock(blockId: BlockId, offset: number, mappi
  * - {@link BlockRemovalMap} (produced by `removeNode`): removes the child
  *   at `index` (the input index becomes invalid → `null`), and shifts
  *   sibling indices `> index` down by `1`.
+ * - {@link MoveNodeMap} (produced by `moveNode`): combines the source removal
+ *   and destination insertion while preserving the moved subtree's identity.
  *
  * Maps whose `parentPath` differs from the input pass through; all
  * non-structural categories (`shift`, `split`, `merge`, `identity`) are
@@ -247,10 +271,9 @@ export declare function mapInsertionIndex(parentPath: readonly BlockId[], index:
  * and cancel them, sidestepping the round-trip clamping for cases where
  * the rebase is a no-op in content terms.
  *
- * `BlockRemovalMap`'s inverse is {@link IDENTITY_MAP}: re-inserting a
- * removed block subtree does not shift positions in *other* blocks, so the
- * inverse direction is invisible to position-mapping. Callers that need to
- * re-validate "did the block come back" must check the document instead.
+ * Structural maps include enough metadata to recover their exact inverse
+ * where possible. Synthetic ChildIndexShiftMaps without inserted subtree IDs
+ * remain position-only and therefore invert to {@link IDENTITY_MAP}.
  */
 export declare function invertStepMap(map: StepMap): StepMap;
 /**

package/dist/state/Mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Mapping.d.ts","sourceRoot":"","sources":["../../src/state/Mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;CACpB;AAED,2CAA2C;AAC3C,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAI3B,mDAAmD;AACnD,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;CACpC;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,eAAe;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAC/C,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACvB;AAED,mDAAmD;AACnD,MAAM,MAAM,OAAO,GAChB,WAAW,GACX,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,eAAe,GACf,kBAAkB,CAAC;AAItB,2CAA2C;AAC3C,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B;AAED,6CAA6C;AAC7C,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACtB;AAID,yEAAyE;AACzE,eAAO,MAAM,YAAY,EAAE,WAAkC,CAAC;AAE9D;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,GAAG,CAAC,OAAO,CAAC,CAUpE;AAID;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,KAAU,GAAG,SAAS,CAmBhG;AAgFD;;;;;;;GAOG;AACH,qBAAa,OAAO;IACnB,4BAA4B;IAC5B,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAmB;IAEjD,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;IAElC,OAAO;IAIP,yEAAyE;IACzE,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO;IAS9C,iDAAiD;IACjD,SAAS,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO;IAKhC,gDAAgD;IAChD,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAMtC,8DAA8D;IAC9D,IAAI,OAAO,IAAI,OAAO,CAErB;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,KAAU,GAAG,QAAQ;IAI/C;;;;OAIG;IACH,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,KAAK,GAAE,KAAU,GAAG,SAAS;IAWtD;;;;;;;;;;;;OAYG;IACH,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,GAAE,KAAU,EAAE,OAAO,GAAE,KAAS,GAAG,aAAa,GAAG,IAAI;CAW/F;AAID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAC9B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,OAAO,EAChB,SAAS,GAAE,KAAS,EACpB,OAAO,GAAE,KAAU,GACjB,kBAAkB,GAAG,IAAI,CA4B3B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC/B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,OAAO,EAChB,KAAK,GAAE,KAAU,GACf,kBAAkB,GAAG,IAAI,CAO3B;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,aAAa,CAC5B,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACd,MAAM,GAAG,IAAI,CAEf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAChC,UAAU,EAAE,SAAS,OAAO,EAAE,EAC9B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,OAAO,GACd,MAAM,CAMR;AA0ED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA6CnD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,GAAG,OAAO,CA0C7D"}
+{"version":3,"file":"Mapping.d.ts","sourceRoot":"","sources":["../../src/state/Mapping.ts"],"names":[],"mappings":"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"}

package/dist/state/StepApplication.d.ts

@@ -1,5 +1,5 @@
 import { Document } from '../model/Document.js';
-import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SplitBlockStep } from './Transaction.js';
+import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, MoveNodeStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SplitBlockStep } from './Transaction.js';
 export declare function applyInsertText(doc: Document, step: InsertTextStep): Document;
 export declare function applyDeleteText(doc: Document, step: DeleteTextStep): Document;
 export declare function applySplitBlock(doc: Document, step: SplitBlockStep): Document;
@@ -18,5 +18,7 @@ export declare function applySetInlineNodeAttr(doc: Document, step: SetInlineNod
 export declare function applySetBlockType(doc: Document, step: SetBlockTypeStep): Document;
 export declare function applyInsertNode(doc: Document, step: InsertNodeStep): Document;
 export declare function applyRemoveNode(doc: Document, step: RemoveNodeStep): Document;
+/** Moves a subtree while preserving every block identity inside it. */
+export declare function applyMoveNode(doc: Document, step: MoveNodeStep): Document;
 export declare function applySetNodeAttr(doc: Document, step: SetNodeAttrStep): Document;
 //# sourceMappingURL=StepApplication.d.ts.map

package/dist/state/StepApplication.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepApplication.d.ts","sourceRoot":"","sources":["../../src/state/StepApplication.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIN,KAAK,QAAQ,EAQb,MAAM,sBAAsB,CAAC;AAc9B,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAM7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAI7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAsD7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAoC/E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,CAIvE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAE3D;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAIzF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAIzF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,GAAG,QAAQ,CAO3F;AAsBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,GAAG,QAAQ,CASjF;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAa7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAa7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAQ/E"}
+{"version":3,"file":"StepApplication.d.ts","sourceRoot":"","sources":["../../src/state/StepApplication.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAIN,KAAK,QAAQ,EAQb,MAAM,sBAAsB,CAAC;AAe9B,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,cAAc,EACd,MAAM,kBAAkB,CAAC;AAE1B,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAM7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAI7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAuD7E;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAoC/E;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,CAIvE;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAI7E;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,QAAQ,CAE3D;AAID,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAIzF;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAIzF;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,qBAAqB,GAAG,QAAQ,CAO3F;AAsBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,gBAAgB,GAAG,QAAQ,CASjF;AAID,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAa7E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAa7E;AAED,uEAAuE;AACvE,wBAAgB,aAAa,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,QAAQ,CAgBzE;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAQ/E"}

package/dist/state/StepHandlers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepHandlers.d.ts","sourceRoot":"","sources":["../../src/state/StepHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAgB,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAkEnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,IAAI;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CACxE;AA4GD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAE7D;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAGhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAc9D"}
+{"version":3,"file":"StepHandlers.d.ts","sourceRoot":"","sources":["../../src/state/StepHandlers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAgB,OAAO,EAAE,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAsEnE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,IAAI;IAC1C,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,QAAQ,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC;IACrD,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,KAAK,IAAI,GAAG,IAAI,CAAC;CACxE;AAkHD,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,QAAQ,CAE7D;AAED,yDAAyD;AACzD,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAE7D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAGhF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,WAAW,GAAG,WAAW,CAc9D"}

package/dist/state/StepInversion.d.ts

@@ -1,5 +1,5 @@
 import { Mark } from '../model/Document.js';
-import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep, Step } from './Steps.js';
+import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, MoveNodeStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep, Step } from './Steps.js';
 import { Transaction } from './Transaction.js';
 export declare function invertInsertText(step: InsertTextStep): Step;
 export declare function invertDeleteText(step: DeleteTextStep): Step;
@@ -11,6 +11,7 @@ export declare function invertSetStoredMarks(step: SetStoredMarksStep): Step;
 export declare function invertSetBlockType(step: SetBlockTypeStep): Step;
 export declare function invertInsertNode(step: InsertNodeStep): Step;
 export declare function invertRemoveNode(step: RemoveNodeStep): Step;
+export declare function invertMoveNode(step: MoveNodeStep): Step;
 export declare function invertSetNodeAttr(step: SetNodeAttrStep): Step;
 export declare function invertInsertInlineNode(step: InsertInlineNodeStep): Step;
 export declare function invertRemoveInlineNode(step: RemoveInlineNodeStep): Step;

package/dist/state/StepInversion.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepInversion.d.ts","sourceRoot":"","sources":["../../src/state/StepInversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,IAAI,EACJ,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAW3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAU3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAU3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAU7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CASrD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAS3D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAMnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAU/D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAO3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAO3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAO7D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAQvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAQvE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CASzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,IAAI,EAAE,GAAG,IAAI,CAO/E"}
+{"version":3,"file":"StepInversion.d.ts","sourceRoot":"","sources":["../../src/state/StepInversion.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAIjD,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,IAAI,EACJ,MAAM,YAAY,CAAC;AAEpB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AASpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAW3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAU3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAW3D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAW7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CASrD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAS3D;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,IAAI,CAMnE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAU/D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAO3D;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAO3D;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAkBvD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CAO7D;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAQvE;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAQvE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CASzE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,WAAW,GAAG,SAAS,IAAI,EAAE,GAAG,IAAI,CAO/E"}

package/dist/state/StepMapping.d.ts

@@ -1,6 +1,6 @@
 import { Document } from '../model/Document.js';
 import { Mapping } from './Mapping.js';
-import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep, Step } from './Steps.js';
+import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, MoveNodeStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep, Step } from './Steps.js';
 export declare function mapInsertText(step: InsertTextStep, mapping: Mapping, _doc: Document): Step | null;
 export declare function mapDeleteText(step: DeleteTextStep, mapping: Mapping, doc: Document): Step | null;
 export declare function mapInsertInlineNode(step: InsertInlineNodeStep, mapping: Mapping, _doc: Document): Step | null;
@@ -13,6 +13,7 @@ export declare function mapSetStoredMarks(step: SetStoredMarksStep, _mapping: Ma
 export declare function mapSetBlockType(step: SetBlockTypeStep, mapping: Mapping, doc: Document): Step | null;
 export declare function mapSetNodeAttr(step: SetNodeAttrStep, mapping: Mapping, doc: Document): Step | null;
 export declare function mapSetInlineNodeAttr(step: SetInlineNodeAttrStep, mapping: Mapping, doc: Document): Step | null;
-export declare function mapInsertNode(step: InsertNodeStep, mapping: Mapping, _doc: Document): Step | null;
+export declare function mapInsertNode(step: InsertNodeStep, mapping: Mapping, doc: Document): Step | null;
 export declare function mapRemoveNode(step: RemoveNodeStep, mapping: Mapping, doc: Document): Step | null;
+export declare function mapMoveNode(step: MoveNodeStep, mapping: Mapping, doc: Document): Step | null;
 //# sourceMappingURL=StepMapping.d.ts.map

package/dist/state/StepMapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepMapping.d.ts","sourceRoot":"","sources":["../../src/state/StepMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAa,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AAW5E,OAAO,EAEN,KAAK,OAAO,EAKZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,IAAI,EACJ,MAAM,YAAY,CAAC;AAuDpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAajG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CA2BhG;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAWb;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CA6Bb;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAajG;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAoCb;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAc3F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAcjG;AAID,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAGb;AAED,wBAAgB,eAAe,CAC9B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CA6Bb;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAWb;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAoBb;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAajG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAiChG"}
+{"version":3,"file":"StepMapping.d.ts","sourceRoot":"","sources":["../../src/state/StepMapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAa,QAAQ,EAAc,MAAM,sBAAsB,CAAC;AAY5E,OAAO,EAEN,KAAK,OAAO,EAKZ,MAAM,cAAc,CAAC;AACtB,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,IAAI,EACJ,MAAM,YAAY,CAAC;AA4DpB,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAajG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CA2BhG;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAWb;AAED,wBAAgB,mBAAmB,CAClC,IAAI,EAAE,oBAAoB,EAC1B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CA6Bb;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAcjG;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAqCb;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAc3F;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAcjG;AAID,wBAAgB,iBAAiB,CAChC,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,OAAO,EACjB,IAAI,EAAE,QAAQ,GACZ,IAAI,GAAG,IAAI,CAGb;AAED,wBAAgB,eAAe,CAC9B,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CA6Bb;AAED,wBAAgB,cAAc,CAC7B,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAWb;AAED,wBAAgB,oBAAoB,CACnC,IAAI,EAAE,qBAAqB,EAC3B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,QAAQ,GACX,IAAI,GAAG,IAAI,CAoBb;AAID,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAahG;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CAiChG;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,IAAI,GAAG,IAAI,CA0B5F"}

package/dist/state/StepMaps.d.ts

@@ -1,6 +1,6 @@
 import { Document } from '../model/Document.js';
-import { BlockRemovalMap, ChildIndexShiftMap, MergeMap, ShiftMap, SplitMap, StepMap } from './Mapping.js';
-import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep } from './Steps.js';
+import { BlockRemovalMap, ChildIndexShiftMap, IDENTITY_MAP, MergeMap, MoveNodeMap, ShiftMap, SplitMap, StepMap } from './Mapping.js';
+import { AddMarkStep, DeleteTextStep, InsertInlineNodeStep, InsertNodeStep, InsertTextStep, MergeBlocksStep, MoveNodeStep, RemoveInlineNodeStep, RemoveMarkStep, RemoveNodeStep, SetBlockTypeStep, SetInlineNodeAttrStep, SetNodeAttrStep, SetStoredMarksStep, SplitBlockStep } from './Steps.js';
 export declare function getMapInsertText(_doc: Document, step: InsertTextStep): ShiftMap;
 export declare function getMapDeleteText(_doc: Document, step: DeleteTextStep): ShiftMap;
 export declare function getMapInsertInlineNode(_doc: Document, step: InsertInlineNodeStep): ShiftMap;
@@ -16,6 +16,7 @@ export declare function getMapRemoveNode(_doc: Document, step: RemoveNodeStep):
  * parent.
  */
 export declare function getMapInsertNode(_doc: Document, step: InsertNodeStep): ChildIndexShiftMap;
+export declare function getMapMoveNode(doc: Document, step: MoveNodeStep): MoveNodeMap | typeof IDENTITY_MAP;
 export declare function getMapAddMark(_doc: Document, _step: AddMarkStep): StepMap;
 export declare function getMapRemoveMark(_doc: Document, _step: RemoveMarkStep): StepMap;
 export declare function getMapSetStoredMarks(_doc: Document, _step: SetStoredMarksStep): StepMap;

package/dist/state/StepMaps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StepMaps.d.ts","sourceRoot":"","sources":["../../src/state/StepMaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,kBAAkB,EAEvB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,EAEZ,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,MAAM,YAAY,CAAC;AAIpB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAQ/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAQ/E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAQ3F;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAQ3F;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAO/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAOjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,CAOtF;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,kBAAkB,CAOzF;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAE/E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAEvF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEnF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAE7F"}
+{"version":3,"file":"StepMaps.d.ts","sourceRoot":"","sources":["../../src/state/StepMaps.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EACN,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,YAAY,EACZ,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,OAAO,EAEZ,MAAM,cAAc,CAAC;AAEtB,OAAO,KAAK,EACX,WAAW,EACX,cAAc,EACd,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,MAAM,YAAY,CAAC;AAKpB,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAQ/E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAQ/E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAQ3F;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,oBAAoB,GAAG,QAAQ,CAQ3F;AAID,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,QAAQ,CAO/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,eAAe,GAAG,QAAQ,CAOjF;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,eAAe,CAOtF;AAID;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,cAAc,GAAG,kBAAkB,CAQzF;AAED,wBAAgB,cAAc,CAC7B,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,GAChB,WAAW,GAAG,OAAO,YAAY,CAWnC;AAUD,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAEzE;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAE/E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAEvF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAEnF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAEjF;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAE7F"}

package/dist/state/Steps.d.ts

@@ -1,4 +1,4 @@
-import { BlockAttrs, BlockNode, ContentSegment, InlineNode, Mark } from '../model/Document.js';
+import { BlockAttrs, BlockNode, ContentSegment, Document, InlineNode, Mark } from '../model/Document.js';
 import { BlockId, NodeTypeName } from '../model/TypeBrands.js';
 export interface InsertTextStep {
     readonly type: 'insertText';
@@ -44,6 +44,8 @@ export interface SplitBlockStep {
      * as-is (an absent value here means "the source block had no attrs").
      */
     readonly newBlockAttrs?: BlockAttrs;
+    /** Semantic HTML ID restored by an inverse split, if the source block had one. */
+    readonly newBlockHTMLId?: string;
     readonly path?: readonly BlockId[];
 }
 export interface MergeBlocksStep {
@@ -58,6 +60,8 @@ export interface MergeBlocksStep {
     readonly sourceType?: NodeTypeName;
     /** Source block's attrs at merge time, if any. */
     readonly sourceAttrs?: BlockAttrs;
+    /** Source block's semantic HTML ID at merge time, if any. */
+    readonly sourceHTMLId?: string;
     readonly path?: readonly BlockId[];
 }
 /**
@@ -120,6 +124,19 @@ export interface RemoveNodeStep {
     readonly index: number;
     readonly removedNode: BlockNode;
 }
+/**
+ * Moves one existing block node between parent child lists without changing
+ * its identity or descendants. `toIndex` is an insertion slot in the document
+ * before removal; same-parent moves adjust it after removing the source.
+ */
+export interface MoveNodeStep {
+    readonly type: 'moveNode';
+    readonly fromParentPath: readonly BlockId[];
+    readonly fromIndex: number;
+    readonly toParentPath: readonly BlockId[];
+    readonly toIndex: number;
+    readonly movedNode: BlockNode;
+}
 export interface SetNodeAttrStep {
     readonly type: 'setNodeAttr';
     readonly path: readonly BlockId[];
@@ -148,8 +165,23 @@ export interface SetInlineNodeAttrStep {
     readonly previousAttrs: Readonly<Record<string, string | number | boolean>>;
     readonly path?: readonly BlockId[];
 }
-export type Step = InsertTextStep | DeleteTextStep | SplitBlockStep | MergeBlocksStep | AddMarkStep | RemoveMarkStep | SetStoredMarksStep | SetBlockTypeStep | InsertNodeStep | RemoveNodeStep | SetNodeAttrStep | InsertInlineNodeStep | RemoveInlineNodeStep | SetInlineNodeAttrStep;
+export type Step = InsertTextStep | DeleteTextStep | SplitBlockStep | MergeBlocksStep | AddMarkStep | RemoveMarkStep | SetStoredMarksStep | SetBlockTypeStep | InsertNodeStep | RemoveNodeStep | MoveNodeStep | SetNodeAttrStep | InsertInlineNodeStep | RemoveInlineNodeStep | SetInlineNodeAttrStep;
 export type TransactionOrigin = 'input' | 'paste' | 'command' | 'history' | 'api';
+/** Returns the moved node's index in its destination parent after removal. */
+export declare function moveNodeDestinationIndex(step: MoveNodeStep): number;
+/** True when a same-parent move leaves the child list unchanged. */
+export declare function isMoveNodeNoOp(step: MoveNodeStep): boolean;
+/** A move resolved and validated against the document it will be applied to. */
+export interface ResolvedMoveNodeStep {
+    readonly movedNode: BlockNode;
+    readonly destinationIndex: number;
+}
+/**
+ * Resolves both sides of a move before any mutation occurs. This is shared by
+ * application and StepMap production so an invalid move is consistently an
+ * identity operation and can never remove its source without reinserting it.
+ */
+export declare function resolveMoveNodeStep(doc: Document, step: MoveNodeStep): ResolvedMoveNodeStep | null;
 /**
  * Block-space width an {@link InsertTextStep} occupies once applied. When the
  * step carries `segments` (which may include inline nodes, each width 1), the