velo-text 1.0.0-beta.1

package/dist/core/model/primitives.js

@@ -0,0 +1,3 @@
+export const SCHEMA_VERSION = 1;
+export const SCHEMA_TYPE = "portable-doc";
+//# sourceMappingURL=primitives.js.map

package/dist/core/model/primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.js","sourceRoot":"","sources":["../../../src/core/model/primitives.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAU,CAAC;AACzC,MAAM,CAAC,MAAM,WAAW,GAAG,cAAuB,CAAC"}

package/dist/core/model/table-look.d.ts

@@ -0,0 +1,12 @@
+import type { TableCell, TableDensity, TableLook, TableNode, TablePreset } from "./types.js";
+export declare const DENSITY_UM: Record<TableDensity, number>;
+export declare const DENSITY_PT: Record<TableDensity, number>;
+export declare function tableClassName(block: TableNode): string;
+export declare function applyDensity(tbl: TableNode, density: TableDensity): void;
+export declare function applyPreset(tbl: TableNode, preset: TablePreset): void;
+export declare function toggleLook(tbl: TableNode, key: keyof TableLook): void;
+export declare function shadeCell(cell: TableCell, color: string | undefined): void;
+export declare function clearTableStyle(tbl: TableNode): void;
+export declare function hexToRgb01(hex: string): [number, number, number] | null;
+export declare function cellFill(cell: TableCell | undefined, tbl: TableNode, ri: number, ci: number): string | undefined;
+//# sourceMappingURL=table-look.d.ts.map

package/dist/core/model/table-look.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-look.d.ts","sourceRoot":"","sources":["../../../src/core/model/table-look.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7F,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAkD,CAAC;AACvG,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAA0C,CAAC;AAW/F,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAYvD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAIxE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAIrE;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,SAAS,GAAG,IAAI,CAKrE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAI1E;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CASpD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAOvE;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAYhH"}

package/dist/core/model/table-look.js

@@ -0,0 +1,99 @@
+export const DENSITY_UM = { compact: 7000, normal: 11000, large: 16000 };
+export const DENSITY_PT = { compact: 18, normal: 28, large: 42 };
+const PRESET_LOOK = {
+    plain: {},
+    grid: { headerRow: true },
+    "grid-banded": { headerRow: true, bandedRows: true },
+    list: { headerRow: true },
+    "list-header": { headerRow: true, firstColumn: true },
+    accent: { headerRow: true, bandedRows: true, firstColumn: true },
+};
+export function tableClassName(block) {
+    const st = block.style ?? {};
+    const look = st.look ?? {};
+    const parts = ["pde-table"];
+    if (st.density)
+        parts.push(`pde-table--${st.density}`);
+    if (st.preset)
+        parts.push(`pde-table--${st.preset}`);
+    if (look.bandedRows)
+        parts.push("pde-table--banded-rows");
+    if (look.bandedColumns)
+        parts.push("pde-table--banded-cols");
+    if (look.firstColumn)
+        parts.push("pde-table--first-col");
+    if (look.lastColumn)
+        parts.push("pde-table--last-col");
+    if (look.totalRow)
+        parts.push("pde-table--total-row");
+    return parts.join(" ");
+}
+export function applyDensity(tbl, density) {
+    tbl.style = { ...tbl.style, density };
+    const um = DENSITY_UM[density];
+    for (const row of tbl.rows)
+        row.heightUm = um;
+}
+export function applyPreset(tbl, preset) {
+    const look = { ...PRESET_LOOK[preset] };
+    tbl.style = { ...tbl.style, preset, look };
+    if (tbl.rows[0])
+        tbl.rows[0].header = !!look.headerRow;
+}
+export function toggleLook(tbl, key) {
+    const look = { ...(tbl.style?.look ?? {}) };
+    look[key] = !look[key];
+    tbl.style = { ...tbl.style, look };
+    if (key === "headerRow" && tbl.rows[0])
+        tbl.rows[0].header = !!look.headerRow;
+}
+export function shadeCell(cell, color) {
+    cell.style = { ...cell.style };
+    if (color)
+        cell.style.background = color;
+    else
+        delete cell.style.background;
+}
+export function clearTableStyle(tbl) {
+    tbl.style = {};
+    if (tbl.rows[0])
+        tbl.rows[0].header = true;
+    for (const row of tbl.rows) {
+        delete row.heightUm;
+        for (const cell of row.cells) {
+            if (cell.style)
+                delete cell.style.background;
+        }
+    }
+}
+export function hexToRgb01(hex) {
+    const h = hex.replace("#", "");
+    if (h.length !== 6 && h.length !== 3)
+        return null;
+    const full = h.length === 3 ? h.split("").map((c) => c + c).join("") : h;
+    const n = Number.parseInt(full, 16);
+    if (!Number.isFinite(n))
+        return null;
+    return [((n >> 16) & 255) / 255, ((n >> 8) & 255) / 255, (n & 255) / 255];
+}
+export function cellFill(cell, tbl, ri, ci) {
+    const custom = cell?.style?.background;
+    if (typeof custom === "string" && custom)
+        return custom;
+    const look = tbl.style?.look ?? {};
+    const last = tbl.rows.length - 1;
+    if (look.headerRow && ri === 0)
+        return "#3659e3";
+    if (look.totalRow && ri === last)
+        return "#e8efff";
+    if (look.firstColumn && ci === 0 && ri > 0)
+        return "#eef2ff";
+    if (look.lastColumn && ci === (tbl.columns.length - 1) && ri > 0)
+        return "#eef2ff";
+    if (look.bandedRows && ri > 0 && ri % 2 === 0)
+        return "#f4f7ff";
+    if (look.bandedColumns && ci % 2 === 1 && ri > 0)
+        return "#f7f8fa";
+    return undefined;
+}
+//# sourceMappingURL=table-look.js.map

package/dist/core/model/table-look.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-look.js","sourceRoot":"","sources":["../../../src/core/model/table-look.ts"],"names":[],"mappings":"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"}

package/dist/core/model/types.d.ts

@@ -0,0 +1,5 @@
+export * from "./primitives.js";
+export * from "./inline.js";
+export * from "./block.js";
+export * from "./document.js";
+//# sourceMappingURL=types.d.ts.map

package/dist/core/model/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/model/types.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/core/model/types.js

@@ -0,0 +1,5 @@
+export * from "./primitives.js";
+export * from "./inline.js";
+export * from "./block.js";
+export * from "./document.js";
+//# sourceMappingURL=types.js.map

package/dist/core/model/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/model/types.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/core/normalize/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./normalize.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/normalize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/normalize/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/core/normalize/index.js

@@ -0,0 +1,2 @@
+export * from "./normalize.js";
+//# sourceMappingURL=index.js.map

package/dist/core/normalize/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/normalize/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/core/normalize/normalize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Normalizer — Phase 2.1.3
+ * Idempotent: merge adjacent texts with same marks, remove illegal empties.
+ */
+import type { PortableDocument } from "../model/types.js";
+export declare function normalizeDocument(doc: PortableDocument): PortableDocument;
+export declare function isIdempotent(doc: PortableDocument): boolean;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/core/normalize/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/core/normalize/normalize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAkC,MAAM,mBAAmB,CAAC;AAM1F,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,GAAG,gBAAgB,CAKzE;AA2HD,wBAAgB,YAAY,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAI3D"}

package/dist/core/normalize/normalize.js

@@ -0,0 +1,145 @@
+function marksEqual(a, b) {
+    return JSON.stringify(a ?? {}) === JSON.stringify(b ?? {});
+}
+export function normalizeDocument(doc) {
+    const copy = JSON.parse(JSON.stringify(doc));
+    normalizeRoot(copy.root);
+    canonicalizeInlineIds(copy.root);
+    return copy;
+}
+/**
+ * Assign deterministic inline IDs derived from their parent block so that
+ * factory-created documents and DOM-parsed documents converge to the same
+ * canonical form. This keeps history snapshots stable (undo/redo idempotence).
+ *  - text node in block B: `B_t<index>`
+ *  - hard break in block B: `B_br<index>`
+ *  - atomic nodes (variable/equation/inline-image) keep their stable IDs
+ *  - link children derive from the link ID
+ */
+function canonicalizeInlineIds(root) {
+    const walkBlocks = (blocks) => {
+        for (const b of blocks) {
+            if (b.type === "paragraph" || b.type === "heading" || b.type === "quote") {
+                canonicalizeInlineArray(b.children, b.id);
+            }
+            else if (b.type === "list") {
+                for (const item of b.items ?? []) {
+                    canonicalizeInlineArray(item.content, item.id);
+                    if (item.nested)
+                        walkBlocks([item.nested]);
+                }
+            }
+            else if (b.type === "table") {
+                for (let ci2 = 0; ci2 < b.columns.length; ci2++) {
+                    b.columns[ci2].id = `${b.id}_c${ci2}`;
+                }
+                for (let ri = 0; ri < b.rows.length; ri++) {
+                    const row = b.rows[ri];
+                    row.id = `${b.id}_r${ri}`;
+                    let ci = 0;
+                    for (const cell of row.cells) {
+                        cell.id = `${b.id}_r${ri}c${ci}`;
+                        ci += cell.colSpan ?? 1;
+                        walkBlocks(cell.blocks);
+                    }
+                }
+            }
+            else if (b.type === "columns") {
+                for (const col of b.columns)
+                    walkBlocks(col.blocks);
+            }
+        }
+    };
+    walkBlocks(root.children);
+}
+function canonicalizeInlineArray(inlines, baseId) {
+    let t = 0;
+    let br = 0;
+    for (const n of inlines) {
+        if (n.type === "text") {
+            n.id = `${baseId}_t${t++}`;
+        }
+        else if (n.type === "hard-break") {
+            n.id = `${baseId}_br${br++}`;
+        }
+        else if (n.type === "link" && n.children) {
+            let lt = 0;
+            for (const c of n.children) {
+                if (c.type === "text")
+                    c.id = `${n.id}_t${lt++}`;
+                else if (c.type === "hard-break")
+                    c.id = `${n.id}_br${br++}`;
+            }
+        }
+    }
+}
+function normalizeRoot(root) {
+    if (!root.children)
+        root.children = [];
+    for (const block of root.children)
+        normalizeBlock(block);
+}
+function normalizeBlock(block) {
+    if (block.type === "paragraph" || block.type === "heading" || block.type === "quote") {
+        normalizeInlineChildren(block);
+    }
+    else if (block.type === "list") {
+        for (const item of block.items ?? []) {
+            normalizeInlineChildren({ children: item.content });
+            if (item.nested)
+                normalizeBlock(item.nested);
+        }
+    }
+    else if (block.type === "table") {
+        for (const row of block.rows ?? []) {
+            for (const cell of row.cells ?? []) {
+                if (!cell.blocks || cell.blocks.length === 0) {
+                    cell.blocks = [
+                        {
+                            type: "paragraph",
+                            id: `${cell.id}_p`,
+                            children: [{ type: "text", id: `${cell.id}_t`, text: "" }],
+                        },
+                    ];
+                }
+                for (const b of cell.blocks)
+                    normalizeBlock(b);
+            }
+        }
+    }
+    else if (block.type === "columns") {
+        for (const col of block.columns ?? []) {
+            if (!col.blocks || col.blocks.length === 0) {
+                col.blocks = [{ type: "paragraph", id: `${col.id}_p`, children: [{ type: "text", id: `${col.id}_t`, text: "" }] }];
+            }
+            for (const b of col.blocks)
+                normalizeBlock(b);
+        }
+    }
+}
+function normalizeInlineChildren(parent) {
+    if (!Array.isArray(parent.children))
+        return;
+    const out = [];
+    for (const child of parent.children) {
+        if (child.type === "text") {
+            const last = out[out.length - 1];
+            if (last && last.type === "text" && marksEqual(last.marks, child.marks)) {
+                last.text = (last.text ?? "") + (child.text ?? "");
+            }
+            else {
+                out.push({ ...child });
+            }
+        }
+        else {
+            out.push(child);
+        }
+    }
+    parent.children = out;
+}
+export function isIdempotent(doc) {
+    const a = normalizeDocument(doc);
+    const b = normalizeDocument(a);
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+//# sourceMappingURL=normalize.js.map

package/dist/core/normalize/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/core/normalize/normalize.ts"],"names":[],"mappings":"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"}

package/dist/core/operations/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./operations.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/core/operations/index.js

@@ -0,0 +1,2 @@
+export * from "./operations.js";
+//# sourceMappingURL=index.js.map

package/dist/core/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/operations/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/dist/core/operations/operations.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Primitive operations — Phase 2.2.1
+ * Insert, delete, split, join, move and apply marks. Preconditions, inverse.
+ */
+import type { PortableDocument, BlockNode, InlineNode, TextMarks } from "../model/types.js";
+export type Operation = {
+    type: "insertBlock";
+    index: number;
+    block: BlockNode;
+} | {
+    type: "deleteBlock";
+    index: number;
+    block?: BlockNode;
+} | {
+    type: "insertInline";
+    blockId: string;
+    offset: number;
+    node: InlineNode;
+} | {
+    type: "deleteInline";
+    blockId: string;
+    offset: number;
+    removed?: InlineNode[];
+} | {
+    type: "insertInlineBulk";
+    blockId: string;
+    offset: number;
+    nodes: InlineNode[];
+} | {
+    type: "applyMarks";
+    blockId: string;
+    index: number;
+    marks: TextMarks;
+};
+export interface TransactionResult {
+    document: PortableDocument;
+    ops: Operation[];
+    inverses: Operation[];
+    intent: string;
+}
+export declare function createTransaction(doc: PortableDocument, intent?: string): {
+    readonly doc: PortableDocument;
+    readonly ops: readonly Operation[];
+    insertBlock(index: number, block: BlockNode): void;
+    deleteBlock(index: number): void;
+    insertInline(blockId: string, offset: number, inlineNode: InlineNode): void;
+    deleteInline(blockId: string, offset: number, count?: number): void;
+    applyMarks(blockId: string, start: number, end: number, marks: TextMarks): void;
+    commit(): TransactionResult;
+    rollback(): void;
+};
+export type Transaction = ReturnType<typeof createTransaction>;
+//# sourceMappingURL=operations.d.ts.map

package/dist/core/operations/operations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.d.ts","sourceRoot":"","sources":["../../../src/core/operations/operations.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE5F,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACxD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACzD;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC3E;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,UAAU,EAAE,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,EAAE,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE7E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,GAAG,EAAE,SAAS,EAAE,CAAC;IACjB,QAAQ,EAAE,SAAS,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAsBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,SAAY;;;uBAiBpD,MAAM,SAAS,SAAS,GAAG,IAAI;uBAM/B,MAAM,GAAG,IAAI;0BAMV,MAAM,UAAU,MAAM,cAAc,UAAU,GAAG,IAAI;0BAQrD,MAAM,UAAU,MAAM,mBAAc,IAAI;wBAO1C,MAAM,SAAS,MAAM,OAAO,MAAM,SAAS,SAAS,GAAG,IAAI;cAarE,iBAAiB;gBAKf,IAAI;EAInB;AAED,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/core/operations/operations.js

@@ -0,0 +1,92 @@
+function findBlock(root, blockId) {
+    for (const b of root.children) {
+        if (b.id === blockId)
+            return { block: b, parent: root };
+        if (b.type === "table") {
+            for (const row of b.rows)
+                for (const cell of row.cells)
+                    for (const bl of cell.blocks)
+                        if (bl.id === blockId)
+                            return { block: bl, parent: cell };
+        }
+        if (b.type === "list") {
+            for (const item of b.items) {
+                if (item.nested && item.nested.id === blockId)
+                    return { block: item.nested, parent: item };
+            }
+        }
+    }
+    return null;
+}
+export function createTransaction(doc, intent = "generic") {
+    let working = JSON.parse(JSON.stringify(doc));
+    const ops = [];
+    const inverses = [];
+    function push(op, inverse) {
+        ops.push(op);
+        inverses.unshift(inverse);
+    }
+    return {
+        get doc() {
+            return working;
+        },
+        get ops() {
+            return ops;
+        },
+        insertBlock(index, block) {
+            const before = working.root.children.length;
+            if (index < 0 || index > before)
+                throw new Error(`insertBlock out of bounds ${index}/${before}`);
+            working.root.children.splice(index, 0, block);
+            push({ type: "insertBlock", index, block }, { type: "deleteBlock", index });
+        },
+        deleteBlock(index) {
+            const block = working.root.children[index];
+            if (!block)
+                throw new Error(`deleteBlock ${index} not found`);
+            working.root.children.splice(index, 1);
+            push({ type: "deleteBlock", index, block }, { type: "insertBlock", index, block });
+        },
+        insertInline(blockId, offset, inlineNode) {
+            const loc = findBlock(working.root, blockId);
+            if (!loc)
+                throw new Error(`block ${blockId} not found`);
+            const children = loc.block.children;
+            if (offset < 0 || offset > children.length)
+                throw new Error(`insertInline offset ${offset} out of bounds`);
+            children.splice(offset, 0, inlineNode);
+            push({ type: "insertInline", blockId, offset, node: inlineNode }, { type: "deleteInline", blockId, offset });
+        },
+        deleteInline(blockId, offset, count = 1) {
+            const loc = findBlock(working.root, blockId);
+            if (!loc)
+                throw new Error(`block ${blockId} not found`);
+            const children = loc.block.children;
+            const removed = children.splice(offset, count);
+            push({ type: "deleteInline", blockId, offset, removed }, { type: "insertInlineBulk", blockId, offset, nodes: removed });
+        },
+        applyMarks(blockId, start, end, marks) {
+            const loc = findBlock(working.root, blockId);
+            if (!loc)
+                throw new Error(`block ${blockId} not found`);
+            const children = loc.block.children;
+            for (let i = start; i < Math.min(end, children.length); i++) {
+                const node = children[i];
+                if (node.type === "text") {
+                    const prev = { ...(node.marks ?? {}) };
+                    node.marks = { ...(node.marks ?? {}), ...marks };
+                    push({ type: "applyMarks", blockId, index: i, marks }, { type: "applyMarks", blockId, index: i, marks: prev });
+                }
+            }
+        },
+        commit() {
+            working.updatedAt = new Date().toISOString();
+            working.revision = (working.revision ?? 0) + 1;
+            return { document: working, ops: [...ops], inverses: [...inverses], intent };
+        },
+        rollback() {
+            working = JSON.parse(JSON.stringify(doc));
+        },
+    };
+}
+//# sourceMappingURL=operations.js.map

package/dist/core/operations/operations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.js","sourceRoot":"","sources":["../../../src/core/operations/operations.ts"],"names":[],"mappings":"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"}

package/dist/core/plugin/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Plugin system — Phase 12.1 & 11.2
+ * Allows internal and external extensions to add node types, formatters, commands and export adapters.
+ * Designed for zero coupling: core never imports plugins; plugins declare capabilities explicitly.
+ *
+ * Internal plugins are bundled (e.g., equation, variable). External plugins are registered at runtime
+ * via `registerPlugin` and are validated (schema, version, no prototype pollution, no `javascript:` URLs).
+ */
+import type { BlockNode, InlineNode } from "../model/types.js";
+import type { FormatterFn } from "../../template/formatter/index.js";
+import type { CommandDef } from "../../editor-web/toolbar/index.js";
+/**
+ * Plugin definition — the contract an extension must satisfy.
+ * See roadmap 12.1 for full list; for v1 we implement a minimal but extensible subset.
+ */
+export interface PluginDef {
+    /** Unique type identifier, e.g. "my-widget" (must be kebab-case) */
+    type: string;
+    /** Schema version of the plugin (not the document) */
+    version: number;
+    /** JSON Schema for the node payload (validated at registration) */
+    schema?: unknown;
+    /** Factory to create a new node of this type */
+    createNode?: (idGen: {
+        next(): string;
+    }, payload?: unknown) => BlockNode | InlineNode;
+    /** Optional normalizer for the node subtree */
+    normalize?: (node: BlockNode | InlineNode) => void;
+    /** Web renderer — returns HTML string for the node */
+    renderWeb?: (node: BlockNode | InlineNode) => string;
+    /** PDF adapter — optional; if missing, strict export fails with code `missing-export-adapter` */
+    renderPdf?: (node: BlockNode | InlineNode, ctx: unknown) => void;
+    /** ODT adapter */
+    renderOdt?: (node: BlockNode | InlineNode, ctx: unknown) => string;
+    /** DOCX adapter */
+    renderDocx?: (node: BlockNode | InlineNode, ctx: unknown) => string;
+    /** Commands contributed by the plugin */
+    commands?: CommandDef[];
+    /** Formatters contributed */
+    formatters?: Record<string, FormatterFn>;
+    /** Migration for schema upgrades: (doc) => void */
+    migrate?: (doc: unknown) => void;
+    /** Contract tests — array of fixture names the plugin must pass */
+    fixtures?: string[];
+}
+export type PluginRegistryEvent = {
+    type: "registered";
+    plugin: PluginDef;
+} | {
+    type: "unregistered";
+    pluginType: string;
+};
+/**
+ * Register a plugin — validates and stores it. Throws if type already exists or validation fails.
+ * All comments and diagnostics are in English.
+ */
+export declare function registerPlugin(def: PluginDef): void;
+/**
+ * Unregister a plugin — removes its contributions. Used for hot-reload in playground and tests.
+ */
+export declare function unregisterPlugin(type: string): void;
+export declare function getPlugin(type: string): PluginDef | undefined;
+export declare function listPlugins(): string[];
+export declare function getNodeTypePlugin(type: string): PluginDef | undefined;
+export declare function getFormatter(name: string): FormatterFn | undefined;
+export declare function listFormatters(): string[];
+export declare function getCommand(id: string): CommandDef | undefined;
+export declare function listCommands(): string[];
+export declare function onRegistryEvent(listener: (e: PluginRegistryEvent) => void): () => void;
+/**
+ * Check if a node type is handled by a plugin — used by renderers and validators to delegate.
+ */
+export declare function isPluginNodeType(type: string): boolean;
+/**
+ * Validate that all plugin node types have at least a web renderer; otherwise warn.
+ * For strict export, missing PDF/ODT/DOCX adapters cause `missing-export-adapter` errors.
+ */
+export declare function validatePluginCoverage(): Array<{
+    plugin: string;
+    missing: string[];
+}>;
+export declare function registerNodeType(type: string, plugin: PluginDef): void;
+export declare function registerFormatter(name: string, fn: FormatterFn): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/plugin/index.ts"],"names":[],"mappings":"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"}