@voithos-labs/aragonite 0.10.3 → 0.10.7

package/dist/invariants/single-node-sink.d.ts

@@ -1,9 +1,8 @@
 /**
- * G1.35 — a sink holding exactly one slot installs exactly one node. Bytes that reparse to
- * several blocks are refused before the write, never truncated to the first (a line vanishes from
- * the document) and never written whole into the surviving slot (the tree stops agreeing with its
- * own reload). Arriving plural is legal; installing plural is not, and this is asked at the
- * install so a sink that forgets the refusal answers for what it actually wrote.
+ * G1.35: a write target that holds one block installs exactly one node. Bytes that reparse to
+ * several blocks are refused before the write, never cut to the first (a line would vanish) nor
+ * written whole into one position (the tree would disagree with its own reload). The check runs
+ * at the write, so the caller that skipped the refusal is the one named.
  */
 import type { InvariantViolation } from '../assert';
 export declare function checkSingleNodeSink(sink: string, installed: number): InvariantViolation | null;

package/dist/invariants/single-node-sink.js

@@ -1,9 +1,8 @@
 /**
- * G1.35 — a sink holding exactly one slot installs exactly one node. Bytes that reparse to
- * several blocks are refused before the write, never truncated to the first (a line vanishes from
- * the document) and never written whole into the surviving slot (the tree stops agreeing with its
- * own reload). Arriving plural is legal; installing plural is not, and this is asked at the
- * install so a sink that forgets the refusal answers for what it actually wrote.
+ * G1.35: a write target that holds one block installs exactly one node. Bytes that reparse to
+ * several blocks are refused before the write, never cut to the first (a line would vanish) nor
+ * written whole into one position (the tree would disagree with its own reload). The check runs
+ * at the write, so the caller that skipped the refusal is the one named.
  */
 export function checkSingleNodeSink(sink, installed) {
     if (installed <= 1)

package/dist/invariants/snapshot-integrity.d.ts

@@ -1,13 +1,12 @@
 /**
- * G1.9 — no mutation may change the serialized bytes reachable through a node an undo
- * entry still shares. BYTES-scoped, so a shared node may still be MOVED: each snapshot
- * owns its children array. The digest is the formalization, over top-level children only —
- * a container's raw covers its whole subtree, so a write through any shared descendant
- * that matters to serialization surfaces without recursion.
+ * G1.9: no mutation may change the serialized bytes reachable through a node an undo entry still
+ * shares. It is about bytes, not identity, so a shared node may move: each snapshot owns its
+ * children array. The digest covers top-level children only, since a container's raw covers its
+ * whole subtree.
  */
 import type { Document } from '../core/nodes';
 import type { InvariantViolation } from '../assert';
-/** Structural slice of UndoEntry — keeps this leaf module free of undo/ imports. */
+/** The part of an undo entry this check needs, so the file imports nothing from `undo/`. */
 export interface SnapshotEntry {
     snapshot: Document;
     /** Digest of `snapshot` at push; absent outside DEV. */

package/dist/invariants/snapshot-integrity.js

@@ -3,7 +3,7 @@ export function checkSnapshotIntegrity(entry) {
         return null;
     return {
         code: 'snapshot-integrity',
-        message: 'snapshot digest mismatch — a mutation wrote through a shared node'
+        message: 'snapshot digest mismatch: a mutation wrote through a shared node'
     };
 }
 export function digestDoc(doc) {

package/dist/invariants/structural-descriptor.d.ts

@@ -1,21 +1,12 @@
 import type { CstNode } from '../core/nodes';
 import type { StructuralChange } from '../tree-operations/structural-change';
 import type { InvariantViolation } from '../assert';
-/**
- * G1.36, producer half — a descriptor's window fits the array it syncs and mints no negative
- * slot count. `Array.from({length: -1})` is `[]`, so a descriptor derived from a length diff
- * over the wrong window desyncs ids from children in silence.
- */
+/** G1.36, the writing half: a descriptor's range fits the array it keeps in step and never asks
+ *  for a negative count, which `Array.from({length: -1})` would silently turn into `[]`. */
 export declare function checkStructuralDescriptor(change: StructuralChange, length: number): InvariantViolation | null;
-/**
- * G1.36, consumer half — one id per child once a commit publishes. The producer check cannot
- * see a descriptor that fits its own array while describing the wrong window, which is what
- * a length-diff derivation over a settle-folded splice produces.
- */
+/** G1.36, the reading half: one id per child once a commit has written its state, which catches
+ *  a descriptor that fits its own array but describes the wrong range. */
 export declare function checkIdsChildrenLockstep(seam: string, idCount: number, childCount: number): InvariantViolation | null;
-/**
- * G1.36 over the other parallel array — one span PAIR per child once a rebuild has run
- * (`schema/child-spans.ts`). A rebuilder seeding the wrong length, or a shape change that
- * outlived its drop, is a stale-region splice waiting for the next keystroke.
- */
+/** G1.36 over the child spans: one pair of span bounds per child once a rebuild has run, or the
+ *  next keystroke splices a stale region. */
 export declare function checkChildSpansLockstep(node: CstNode): InvariantViolation | null;

package/dist/invariants/structural-descriptor.js

@@ -1,8 +1,5 @@
-/**
- * G1.36, producer half — a descriptor's window fits the array it syncs and mints no negative
- * slot count. `Array.from({length: -1})` is `[]`, so a descriptor derived from a length diff
- * over the wrong window desyncs ids from children in silence.
- */
+/** G1.36, the writing half: a descriptor's range fits the array it keeps in step and never asks
+ *  for a negative count, which `Array.from({length: -1})` would silently turn into `[]`. */
 export function checkStructuralDescriptor(change, length) {
     if (change.op === 'noop')
         return null;
@@ -16,11 +13,8 @@ export function checkStructuralDescriptor(change, length) {
         detail: { change, length }
     };
 }
-/**
- * G1.36, consumer half — one id per child once a commit publishes. The producer check cannot
- * see a descriptor that fits its own array while describing the wrong window, which is what
- * a length-diff derivation over a settle-folded splice produces.
- */
+/** G1.36, the reading half: one id per child once a commit has written its state, which catches
+ *  a descriptor that fits its own array but describes the wrong range. */
 export function checkIdsChildrenLockstep(seam, idCount, childCount) {
     if (idCount === childCount)
         return null;
@@ -30,11 +24,8 @@ export function checkIdsChildrenLockstep(seam, idCount, childCount) {
         detail: { seam, idCount, childCount }
     };
 }
-/**
- * G1.36 over the other parallel array — one span PAIR per child once a rebuild has run
- * (`schema/child-spans.ts`). A rebuilder seeding the wrong length, or a shape change that
- * outlived its drop, is a stale-region splice waiting for the next keystroke.
- */
+/** G1.36 over the child spans: one pair of span bounds per child once a rebuild has run, or the
+ *  next keystroke splices a stale region. */
 export function checkChildSpansLockstep(node) {
     const spans = node.childSpans;
     if (!spans)

package/dist/menu-icons.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Lucide glyphs the editor's own controls draw (menus, the selection bar, table buttons),
+ * inlined as path data so the library needs no icon dependency. A leaf module, so the insert
+ * catalogue in `schema/` can check an icon name without importing a component.
+ */
+export declare const MENU_GLYPHS: {
+    readonly plus: readonly ["M5 12h14", "M12 5v14"];
+    readonly type: readonly ["M4 7V4h16v3", "M9 20h6", "M12 4v16"];
+    readonly trash: readonly ["M3 6h18", "M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6", "M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2", "M10 11v6", "M14 11v6"];
+    readonly 'arrow-up': readonly ["m5 12 7-7 7 7", "M12 19V5"];
+    readonly 'arrow-down': readonly ["M12 5v14", "m19 12-7 7-7-7"];
+    readonly 'arrow-left': readonly ["m12 19-7-7 7-7", "M19 12H5"];
+    readonly 'arrow-right': readonly ["M5 12h14", "m12 5 7 7-7 7"];
+    readonly scissors: readonly ["M9 6a3 3 0 1 1-6 0 3 3 0 0 1 6 0", "M8.12 8.12 12 12", "M20 4 8.12 15.88", "M9 18a3 3 0 1 1-6 0 3 3 0 0 1 6 0", "M14.8 14.8 20 20"];
+    readonly copy: readonly ["M10 8h10a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2V10a2 2 0 0 1 2-2z", "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2"];
+    readonly clipboard: readonly ["M9 2h6a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z", "M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2"];
+    readonly 'align-left': readonly ["M15 12H3", "M17 18H3", "M21 6H3"];
+    readonly 'align-center': readonly ["M17 12H7", "M19 18H5", "M21 6H3"];
+    readonly 'align-right': readonly ["M21 12H9", "M21 18H7", "M21 6H3"];
+    readonly bold: readonly ["M6 12h9a4 4 0 0 1 0 8H7a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h7a4 4 0 0 1 0 8"];
+    readonly italic: readonly ["M19 4h-9", "M14 20H5", "M15 4 9 20"];
+    readonly strikethrough: readonly ["M16 4H9a3 3 0 0 0-2.83 4", "M14 12a4 4 0 0 1 0 8H6", "M4 12h16"];
+    readonly code: readonly ["m16 18 6-6-6-6", "m8 6-6 6 6 6"];
+    readonly link: readonly ["M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71", "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71"];
+    readonly 'external-link': readonly ["M15 3h6v6", "M10 14 21 3", "M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6"];
+    readonly unlink: readonly ["m18.84 12.25 1.72-1.71h-.02a5.004 5.004 0 0 0-.12-7.07 5.006 5.006 0 0 0-6.95 0l-1.72 1.71", "m5.17 11.75-1.71 1.71a5.004 5.004 0 0 0 .12 7.07 5.006 5.006 0 0 0 6.95 0l1.71-1.71", "M8 2v3", "M2 8h3", "M16 19v3", "M19 16h3"];
+    readonly heading: readonly ["M6 12h12", "M6 20V4", "M18 20V4"];
+    readonly list: readonly ["M3 12h.01", "M3 18h.01", "M3 6h.01", "M8 12h13", "M8 18h13", "M8 6h13"];
+    readonly 'list-ordered': readonly ["M10 12h11", "M10 18h11", "M10 6h11", "M4 10h2", "M4 6h1v4", "M6 18H4c0-1 2-2 2-3s-1-1.5-2-1"];
+    readonly 'square-check': readonly ["M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z", "m9 12 2 2 4-4"];
+    readonly 'text-quote': readonly ["M17 6H3", "M21 12H8", "M21 18H8", "M3 12v6"];
+    readonly minus: readonly ["M5 12h14"];
+    readonly table: readonly ["M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z", "M12 3v18", "M3 9h18", "M3 15h18"];
+    readonly sigma: readonly ["M18 7V5a1 1 0 0 0-1-1H6.5a.5.5 0 0 0-.4.8l4.5 6a2 2 0 0 1 0 2.4l-4.5 6a.5.5 0 0 0 .4.8H17a1 1 0 0 0 1-1v-2"];
+    readonly info: readonly ["M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0", "M12 16v-4", "M12 8h.01"];
+    readonly 'chevron-right': readonly ["m9 18 6-6-6-6"];
+    readonly 'chevron-down': readonly ["m6 9 6 6 6-6"];
+    readonly 'rows-2': readonly ["M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z", "M3 12h18"];
+    readonly 'columns-2': readonly ["M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z", "M12 3v18"];
+    readonly check: readonly ["M20 6 9 17l-5-5"];
+    readonly crop: readonly ["M6 2v14a2 2 0 0 0 2 2h14", "M18 22V8a2 2 0 0 0-2-2H2"];
+    readonly captions: readonly ["M5 5h14a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2z", "M7 15h4", "M15 15h2", "M7 11h2", "M13 11h4"];
+    readonly x: readonly ["M18 6 6 18", "m6 6 12 12"];
+    readonly 'grip-vertical': readonly ["M10 5a1 1 0 1 1-2 0 1 1 0 0 1 2 0", "M10 12a1 1 0 1 1-2 0 1 1 0 0 1 2 0", "M10 19a1 1 0 1 1-2 0 1 1 0 0 1 2 0", "M16 5a1 1 0 1 1-2 0 1 1 0 0 1 2 0", "M16 12a1 1 0 1 1-2 0 1 1 0 0 1 2 0", "M16 19a1 1 0 1 1-2 0 1 1 0 0 1 2 0"];
+};
+export type MenuIconName = keyof typeof MENU_GLYPHS;
+export declare function isMenuIconName(name: string): name is MenuIconName;

package/dist/menu-icons.js

@@ -0,0 +1,113 @@
+/**
+ * Lucide glyphs the editor's own controls draw (menus, the selection bar, table buttons),
+ * inlined as path data so the library needs no icon dependency. A leaf module, so the insert
+ * catalogue in `schema/` can check an icon name without importing a component.
+ */
+export const MENU_GLYPHS = {
+    plus: ['M5 12h14', 'M12 5v14'],
+    type: ['M4 7V4h16v3', 'M9 20h6', 'M12 4v16'],
+    trash: [
+        'M3 6h18',
+        'M19 6v14c0 1-1 2-2 2H7c-1 0-2-1-2-2V6',
+        'M8 6V4c0-1 1-2 2-2h4c1 0 2 1 2 2v2',
+        'M10 11v6',
+        'M14 11v6'
+    ],
+    'arrow-up': ['m5 12 7-7 7 7', 'M12 19V5'],
+    'arrow-down': ['M12 5v14', 'm19 12-7 7-7-7'],
+    'arrow-left': ['m12 19-7-7 7-7', 'M19 12H5'],
+    'arrow-right': ['M5 12h14', 'm12 5 7 7-7 7'],
+    scissors: [
+        'M9 6a3 3 0 1 1-6 0 3 3 0 0 1 6 0',
+        'M8.12 8.12 12 12',
+        'M20 4 8.12 15.88',
+        'M9 18a3 3 0 1 1-6 0 3 3 0 0 1 6 0',
+        'M14.8 14.8 20 20'
+    ],
+    copy: [
+        'M10 8h10a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H10a2 2 0 0 1-2-2V10a2 2 0 0 1 2-2z',
+        'M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2'
+    ],
+    clipboard: [
+        'M9 2h6a1 1 0 0 1 1 1v2a1 1 0 0 1-1 1H9a1 1 0 0 1-1-1V3a1 1 0 0 1 1-1z',
+        'M16 4h2a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H6a2 2 0 0 1-2-2V6a2 2 0 0 1 2-2h2'
+    ],
+    'align-left': ['M15 12H3', 'M17 18H3', 'M21 6H3'],
+    'align-center': ['M17 12H7', 'M19 18H5', 'M21 6H3'],
+    'align-right': ['M21 12H9', 'M21 18H7', 'M21 6H3'],
+    bold: ['M6 12h9a4 4 0 0 1 0 8H7a1 1 0 0 1-1-1V5a1 1 0 0 1 1-1h7a4 4 0 0 1 0 8'],
+    italic: ['M19 4h-9', 'M14 20H5', 'M15 4 9 20'],
+    strikethrough: ['M16 4H9a3 3 0 0 0-2.83 4', 'M14 12a4 4 0 0 1 0 8H6', 'M4 12h16'],
+    code: ['m16 18 6-6-6-6', 'm8 6-6 6 6 6'],
+    link: [
+        'M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71',
+        'M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71'
+    ],
+    'external-link': [
+        'M15 3h6v6',
+        'M10 14 21 3',
+        'M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6'
+    ],
+    unlink: [
+        'm18.84 12.25 1.72-1.71h-.02a5.004 5.004 0 0 0-.12-7.07 5.006 5.006 0 0 0-6.95 0l-1.72 1.71',
+        'm5.17 11.75-1.71 1.71a5.004 5.004 0 0 0 .12 7.07 5.006 5.006 0 0 0 6.95 0l1.71-1.71',
+        'M8 2v3',
+        'M2 8h3',
+        'M16 19v3',
+        'M19 16h3'
+    ],
+    heading: ['M6 12h12', 'M6 20V4', 'M18 20V4'],
+    list: ['M3 12h.01', 'M3 18h.01', 'M3 6h.01', 'M8 12h13', 'M8 18h13', 'M8 6h13'],
+    'list-ordered': [
+        'M10 12h11',
+        'M10 18h11',
+        'M10 6h11',
+        'M4 10h2',
+        'M4 6h1v4',
+        'M6 18H4c0-1 2-2 2-3s-1-1.5-2-1'
+    ],
+    'square-check': [
+        'M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z',
+        'm9 12 2 2 4-4'
+    ],
+    'text-quote': ['M17 6H3', 'M21 12H8', 'M21 18H8', 'M3 12v6'],
+    minus: ['M5 12h14'],
+    table: [
+        'M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z',
+        'M12 3v18',
+        'M3 9h18',
+        'M3 15h18'
+    ],
+    sigma: [
+        'M18 7V5a1 1 0 0 0-1-1H6.5a.5.5 0 0 0-.4.8l4.5 6a2 2 0 0 1 0 2.4l-4.5 6a.5.5 0 0 0 .4.8H17a1 1 0 0 0 1-1v-2'
+    ],
+    info: ['M22 12a10 10 0 1 1-20 0 10 10 0 0 1 20 0', 'M12 16v-4', 'M12 8h.01'],
+    'chevron-right': ['m9 18 6-6-6-6'],
+    'chevron-down': ['m6 9 6 6 6-6'],
+    'rows-2': ['M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z', 'M3 12h18'],
+    'columns-2': [
+        'M5 3h14a2 2 0 0 1 2 2v14a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2z',
+        'M12 3v18'
+    ],
+    check: ['M20 6 9 17l-5-5'],
+    crop: ['M6 2v14a2 2 0 0 0 2 2h14', 'M18 22V8a2 2 0 0 0-2-2H2'],
+    captions: [
+        'M5 5h14a2 2 0 0 1 2 2v10a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V7a2 2 0 0 1 2-2z',
+        'M7 15h4',
+        'M15 15h2',
+        'M7 11h2',
+        'M13 11h4'
+    ],
+    x: ['M18 6 6 18', 'm6 6 12 12'],
+    'grip-vertical': [
+        'M10 5a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+        'M10 12a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+        'M10 19a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+        'M16 5a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+        'M16 12a1 1 0 1 1-2 0 1 1 0 0 1 2 0',
+        'M16 19a1 1 0 1 1-2 0 1 1 0 0 1 2 0'
+    ]
+};
+export function isMenuIconName(name) {
+    return Object.hasOwn(MENU_GLYPHS, name);
+}

package/dist/perf/instruments.d.ts

@@ -3,13 +3,17 @@ export interface PerfSnapshot {
     snapshotCount: number;
     snapshotCloneBytes: number;
     rebuildDepths: Record<number, number>;
-    /** Container reparses the kind re-derivation gate let through (see rebuildUnsharedChain). */
+    /** Parses of a rebuilt container's own bytes, to re-derive its kind or metadata
+     *  (`schema/container-raw.ts :: parseContainerRaw`), and the bytes they read. */
     containerKindReparses: number;
+    containerReparseBytes: number;
+    /** Reads of a rebuilt container's first line alone, to re-derive its kind or metadata. */
+    openerLineReads: number;
     parseCount: number;
     parseMsTotal: number;
     parseBlockCount: number;
     inlineComputeCount: number;
-    /** Inline-format coverage reads that actually parsed — the pressed-state read's cost. */
+    /** Inline-format coverage reads that actually parsed: what a toolbar's pressed state costs. */
     formatCoverageReads: number;
     undoLiveBytes: number;
     undoEntryCount: number;
@@ -21,6 +25,14 @@ export interface PerfSnapshot {
     decorationRuns: number;
     islandRebuilds: number;
     islandKeyScans: number;
+    /** One entry per windowing height table built: the list's path and the width it estimated at. */
+    heightTableBuilds: {
+        path: string;
+        width: number;
+    }[];
+    /** Checks of whether a change moved the focused block past a neighbour, which only a rebuilt
+     *  height table pays for. */
+    neighbourPasses: number;
 }
 export declare function enablePerfInstruments(): void;
 export declare function disablePerfInstruments(): void;
@@ -29,7 +41,8 @@ export declare function perfEnabled(): boolean;
 export declare function perfSnapshot(): PerfSnapshot;
 export declare function recordSnapshotClone(bytes: number): void;
 export declare function recordRebuildDepth(depth: number): void;
-export declare function recordContainerKindReparse(): void;
+export declare function recordContainerKindReparse(bytes: number): void;
+export declare function recordOpenerLineRead(): void;
 export declare function recordParse(ms: number, blockCount: number): void;
 export declare function recordInlineCompute(): void;
 export declare function recordFormatCoverageRead(): void;
@@ -38,12 +51,14 @@ export declare function recordBlockRender(ms: number, path?: number[]): void;
 export declare function recordDecorationRun(): void;
 export declare function recordIslandRebuild(): void;
 export declare function recordIslandKeyScan(): void;
+export declare function recordHeightTableBuild(path: readonly number[], width: number): void;
+export declare function recordNeighbourPass(): void;
 export declare function incMountedBlocks(): void;
 export declare function decMountedBlocks(): void;
 export declare function markKeystrokeStart(): void;
 export declare function markKeystrokeSettle(): void;
 /**
- * Serialized-byte proxy without building the string. Counts UTF-16 code units: exact
- * against `serialize().length`, approximate against on-disk bytes for non-ASCII.
+ * A stand-in for the serialized byte count that never builds the string. Counts UTF-16 code
+ * units: exact against `serialize().length`, approximate against on-disk bytes for non-ASCII.
  */
 export declare function docByteLength(doc: DocumentView): number;

package/dist/perf/instruments.js

@@ -1,10 +1,10 @@
 /**
- * Dev-mode performance counters for the profiling harness. A leaf module, so the seams that
- * record into it can depend on it from anywhere. Recording stays off until a runtime switch
- * that only arms in dev/Vitest, leaving production one boolean check per record call.
- * Internal — never exported from the editor barrel.
+ * Dev-mode performance counters for the profiling harness. It depends only on the build flags,
+ * so anything that records into it can import it. Recording stays off until a runtime switch that
+ * turns on only in a dev build or a test run, leaving production one boolean check per record
+ * call. Internal: never exported from the editor barrel.
  */
-import { DEV } from 'esm-env';
+import { editorEnv, isDevChecks } from '../env';
 let enabled = false;
 let counters = emptySnapshot();
 let keystrokeStart = null;
@@ -14,6 +14,8 @@ function emptySnapshot() {
         snapshotCloneBytes: 0,
         rebuildDepths: {},
         containerKindReparses: 0,
+        containerReparseBytes: 0,
+        openerLineReads: 0,
         parseCount: 0,
         parseMsTotal: 0,
         parseBlockCount: 0,
@@ -28,14 +30,15 @@ function emptySnapshot() {
         mountedBlockCount: 0,
         decorationRuns: 0,
         islandRebuilds: 0,
-        islandKeyScans: 0
+        islandKeyScans: 0,
+        heightTableBuilds: [],
+        neighbourPasses: 0
     };
 }
 // ── Switch and readout ──────────────────────────────────────────────────────
 export function enablePerfInstruments() {
-    if (DEV || (typeof process !== 'undefined' && process?.env?.VITEST)) {
+    if (isDevChecks() || editorEnv.isTest)
         enabled = true;
-    }
 }
 export function disablePerfInstruments() {
     enabled = false;
@@ -52,7 +55,8 @@ export function perfSnapshot() {
         ...counters,
         rebuildDepths: { ...counters.rebuildDepths },
         keystrokeInPageMs: [...counters.keystrokeInPageMs],
-        blockRenderPaths: [...counters.blockRenderPaths]
+        blockRenderPaths: [...counters.blockRenderPaths],
+        heightTableBuilds: [...counters.heightTableBuilds]
     };
 }
 // ── Recorders ───────────────────────────────────────────────────────────────
@@ -67,10 +71,16 @@ export function recordRebuildDepth(depth) {
         return;
     counters.rebuildDepths[depth] = (counters.rebuildDepths[depth] ?? 0) + 1;
 }
-export function recordContainerKindReparse() {
+export function recordContainerKindReparse(bytes) {
     if (!enabled)
         return;
     counters.containerKindReparses++;
+    counters.containerReparseBytes += bytes;
+}
+export function recordOpenerLineRead() {
+    if (!enabled)
+        return;
+    counters.openerLineReads++;
 }
 export function recordParse(ms, blockCount) {
     if (!enabled)
@@ -103,8 +113,8 @@ export function recordBlockRender(ms, path) {
     if (path)
         counters.blockRenderPaths.push(path.join(','));
 }
-// notifyEdit runs every source, so a typing pass records keystrokes × sources — the
-// ceiling that catches a per-block cascade.
+// `notifyEdit` runs every source, so a typing pass records keystrokes × sources, the ceiling
+// that catches one block's change cascading into the rest.
 export function recordDecorationRun() {
     if (!enabled)
         return;
@@ -115,12 +125,22 @@ export function recordIslandRebuild() {
         return;
     counters.islandRebuilds++;
 }
-// One querySelectorAll per destructive/printable keystroke, even when the block holds none.
+// One `querySelectorAll` per delete or printable keystroke, even when the block has none.
 export function recordIslandKeyScan() {
     if (!enabled)
         return;
     counters.islandKeyScans++;
 }
+export function recordHeightTableBuild(path, width) {
+    if (!enabled)
+        return;
+    counters.heightTableBuilds.push({ path: path.join(','), width });
+}
+export function recordNeighbourPass() {
+    if (!enabled)
+        return;
+    counters.neighbourPasses++;
+}
 export function incMountedBlocks() {
     if (!enabled)
         return;
@@ -143,8 +163,8 @@ export function markKeystrokeSettle() {
     keystrokeStart = null;
 }
 /**
- * Serialized-byte proxy without building the string. Counts UTF-16 code units: exact
- * against `serialize().length`, approximate against on-disk bytes for non-ASCII.
+ * A stand-in for the serialized byte count that never builds the string. Counts UTF-16 code
+ * units: exact against `serialize().length`, approximate against on-disk bytes for non-ASCII.
  */
 export function docByteLength(doc) {
     let length = doc.prefix.length + doc.suffix.length;

package/dist/perf/use-mount-gauge.svelte.js

@@ -1,12 +1,12 @@
 /**
- * Count the calling component in the dev mount gauge. Rows and list items aren't
- * BlockHosts, so without this a windowed giant container would read as ~0 mounted blocks.
+ * Count the calling component in the dev-mode mount gauge. Rows and list items are not
+ * BlockHosts, so without this a huge windowed container would read as almost nothing mounted.
  */
 import { perfEnabled, incMountedBlocks, decMountedBlocks } from './instruments';
 export function useMountGauge() {
     $effect(() => {
-        // One decision per mount: the gauge is a net balance, so re-reading the flag at
-        // teardown would let an arm/disarm flip unbalance it.
+        // Decided once per mount: the gauge counts up and down, so re-reading the flag at
+        // teardown would let turning it on or off in between leave the count unbalanced.
         if (!perfEnabled())
             return;
         incMountedBlocks();

package/dist/plugin.d.ts

@@ -4,6 +4,7 @@ import type { ChromeLeafOptions } from './editor-actions/plugin/chrome-leaf';
 export { definePlugin, isPluginInstalled } from './schema/plugin-install';
 export type { EditorPlugin, EditorPluginEntry } from './schema/plugin-install';
 export type { PluginSetupContext, OnEditorCallback, EditorContext } from './schema/plugin-install';
+export type { InsertMarkdownOptions } from './editor-props';
 export type { PresentationMode } from './presentation-mode';
 export { definePluginBlock } from './schema/define-plugin-block';
 export { declarePluginKind, declaredPluginKind } from './schema/plugin-kind';
@@ -15,7 +16,8 @@ export type { InlineSyntaxRecognizer, InlineSyntaxOptions } from './core/inline/
 export { registerInlineWidgetKind, mintWidgetShell, isWidgetActivationClick } from './core/inline/inline-widgets';
 export type { InlineWidgetDescriptor, InlineWidgetComponentProps, InlineWidgetEditingPolicy, InlineWidgetEditingContext } from './core/inline/inline-widgets';
 export { registerBlockKind, augmentBlockKind } from './schema/block-kind-descriptor';
-export type { BlockKindDescriptor, BlockKindRegistration, BlockKindAugmentation, ContainerDescriptorGroup, MergeRole, UnwrapRole } from './schema/block-kind-descriptor';
+export type { BlockKindRegistration, BlockKindAugmentation, ContainerDescriptorGroup, MergeRole, ContainerUnwrapRole, WriteContext, WriteRule } from './schema/block-kind-descriptor';
+export type { HeightEstimateEnv } from './schema/height-estimates';
 export type { ChildRawChange } from './schema/child-spans';
 export type { ClosureBlock, ClosureColumn, ClosureCell, SimpleLeafClosureCells, ContainerClosureCells } from './schema/closure';
 export { simpleLeafClosure, containerClosure } from './schema/closure';
@@ -29,10 +31,18 @@ export type { OuterBlockScan } from './schema/block-openers';
 export { OPENER_PRIORITIES } from './schema/opener-priorities';
 export { registerBlockCompleter } from './schema/block-completions';
 export type { BlockCompleter, CompletionResult } from './schema/block-completions';
-export { registerLanguage, listLanguages } from './components/blocks/code/code-languages';
+export { registerLanguage } from './components/blocks/code/code-languages';
 export type { LanguageGrammar } from './components/blocks/code/code-languages';
-export { tokenizeBody as highlightCode } from './components/blocks/code/code-renderer';
+/** Every language once, under its canonical name, sorted. */
+export declare function listLanguages(): string[];
+/** The other spellings a language answers to, asked by any of them. */
+export declare function getLanguageAliases(name: string): readonly string[];
+/** The code block's own tokenizer, for a plugin's own source view (block math paints its LaTeX
+ *  with it). Text-preserving: the fragment's `textContent` is `body`. */
+export declare function highlightCode(body: string, language: string): DocumentFragment;
 export type { LanguageFn } from 'highlight.js';
+export { sliceFencedSource, renderFencedSource, fenceBodyAsDrawn } from './components/blocks/code/code-renderer';
+export type { FencedSource } from './components/blocks/code/code-renderer';
 export type { CommandId } from './schema/commands';
 export type { KeyBinding } from './schema/keybindings';
 export { registerBlockCommand } from './schema/block-commands';
@@ -47,11 +57,18 @@ export { serialize, concatChildren as serializeChildren } from './core/serialize
 export { trimTrailingLineEnding, normalizeLineEndings } from './core/lines';
 export { splitLines } from './core/lines';
 export type { ParsedLine } from './core/lines';
+export { documentLineEnding, firstLineEnding, ownTrailingLineEnding, trailingLineEnding, displayLines, joinDisplayLines } from './core/lines';
+export type { LineEnding } from './core/lines';
 export { isBlankLine } from './core/parser';
+export { isBlankText, isWhitespaceChar, trimWhitespace } from './core/lines';
 export { parseContainerBody } from './core/parser';
 export type { ContainerBodyWrap } from './core/parser';
-export { matchFenceOpen, matchFenceClose, escalatedFenceLength } from './core/parsers/fence-syntax';
-export type { FenceOpen } from './core/parsers/fence-syntax';
+export { matchFenceOpen, matchFenceClose, escalatedFenceLength, findFenceCloser, fenceAnatomy, matchFenceInfo } from './core/parsers/fence-syntax';
+export type { FenceOpen, FenceRun, FenceAnatomy } from './core/parsers/fence-syntax';
+export { scanFence } from './core/parsers/fenced-code';
+export type { FenceScan } from './core/parsers/fenced-code';
+export { fenceRawWrite, fenceShapeOfRaw } from './schema/fenced-code-raw';
+export type { FenceShape } from './schema/fenced-code-raw';
 export { htmlBlockTagLineMatcher } from './core/parsers/html-block';
 export { blockquoteExtent } from './core/parsers/blockquote';
 export type { CstNode } from './core/nodes';
@@ -61,9 +78,13 @@ export { getContentRange } from './core/inline';
 export type { ContentRange } from './core/inline';
 export { headingLevel } from './core/nodes';
 export { isProseKind } from './core/inline';
+export { walkBlocks } from './core/paths';
+export { blockNodeAt } from './tree-operations/node-primitives';
 /**
- * Inline-parse a prose leaf. No link-reference resolver is available to a plugin, so
- * reference links parse as `unresolvedReference`; every other construct fully resolves.
+ * Inline-parse a prose leaf with every installed plugin's syntax, for a pipeline with no editor
+ * mounted. Inside an editor use `EditorContext.computeInlineContent`, which reads only the plugins
+ * that editor lists and resolves the document's reference links. With no document here, a
+ * reference link reads as its bracketed text.
  */
 export declare function computeInlineContent(node: NodeView): InlineNode[];
 export { isBlockKindDeclared } from './schema/plugin-kind';
@@ -72,10 +93,12 @@ export { isBlockComponentRegistered } from './schema/block-component-registry';
 export { isBlockOpenerRegistered } from './schema/block-openers';
 export { isBlockCompleterRegistered } from './schema/block-completions';
 export { isPasteTransformRegistered } from './tree-operations/paste/paste-transforms';
+export { isLanguageRegistered } from './components/blocks/code/code-languages';
 export { default as BlockList } from './components/BlockList.svelte';
 export { createContainerBlock } from './editor-actions/plugin/container';
 export type { ContainerBlock, ContainerBlockComponent, ContainerBlockDeps, ContainerBlockListProps } from './editor-actions/plugin/container';
 export type { RefSlots } from './reactivity/publish-ref.svelte';
+export type { ChildList } from './reactivity/child-list';
 export declare function registerChromeLeaf(kind: AnyBlockKind, opts?: ChromeLeafOptions): void;
 export type { ChromeLeafOptions };
 export { chromeChild } from './editor-actions/plugin/chrome-leaf';
@@ -92,17 +115,24 @@ export { createDirectiveRebuild } from './editor-actions/plugin/directive-contai
 export { DIRECTIVE_BODY_WRAP } from './core/directive/kinds';
 export { createBoundedMemo } from './bounded-memo';
 export type { BoundedMemoOptions } from './bounded-memo';
+export { createRendererSlot, createAsyncRendererSlot, renderSourceFallback } from './renderer-slot';
+export type { RenderContext, RendererSlot, AsyncRendererSlot, RendererSlotSpec, SyncRendererSlotSpec } from './renderer-slot';
 export { createScanIndex } from './scan-index';
 export { registerPasteTransform } from './tree-operations/paste/paste-transforms';
 export type { PasteTransform } from './tree-operations/paste/paste-transforms';
 export type { Decoration, MarkDecoration, WidgetDecoration, ReplaceDecoration, BlockDecoration, DecorationWidgetSpec, ProvideContext, DecorationSource, DecorationSourceHandle, DecorationRegistry } from './decorations/types';
-export type { EditEvent, EditorEventMap, SelectionChangeEvent, EditorError } from './editor-events';
+export type { EditEvent, EditorEventMap, SelectionChangeEvent, EditorError, SourceSwapEvent } from './editor-events';
 export type { OperationKind } from './schema/operations';
+export type { InlineMenuRegistry, InlineMenuOpenOptions, InlineMenuSource, InlineMenuSourceHandle, InlineMenuItem, InlineMenuQuery, InlineMenuRowProps } from './inline-menu/types';
+export { registerInsertEntry } from './schema/insert-catalogue';
+export type { InsertEntry } from './schema/insert-catalogue';
+export type { MenuIconName } from './menu-icons';
 export type { EditorRects } from './editor-rects';
 export { caretOffsetAtPoint } from './cursor/point-offset';
 export type { CaretTarget } from './schema/block-kind-descriptor';
 export { CURSOR_END } from './block-component';
 export type { CursorEnd } from './block-component';
+export { POINTER_GESTURE_ATTR } from './selection/pointer-gesture';
 export type { EditorSelection, SelectionPoint } from './selection/primitives';
 export { SELECTION_END } from './block-component';
 export type { SelectionEnd } from './block-component';