edytor 1.0.0-rc.2 → 1.0.0

package/dist/crdt/text/rows.d.ts

@@ -90,5 +90,3 @@ export declare const streamOfSegment: (row: LiveRow, k: number, block: BlockId)
  * streams `placeText` returns for the row's scan.
  */
 export declare const placeRow: (row: LiveRow, delim: ReadonlyMap<BlockId, string>) => void;
-/** The row agrees with a fresh scan of its text (the index's self-check). */
-export declare const sameRow: (row: LiveRow, scan: TextRow) => boolean;

package/dist/crdt/text/rows.js

@@ -180,14 +180,3 @@ export const placeRow = (row, delim) => {
     row.cuts = cuts;
     row.head = delim.has(row.home) ? null : row.home;
 };
-/** The row agrees with a fresh scan of its text (the index's self-check). */
-export const sameRow = (row, scan) => {
-    if (row.key !== scan.key || row.bounds.length !== scan.bounds.length)
-        return false;
-    if (rowLength(row) !== scan.len)
-        return false;
-    for (let j = 0; j < scan.bounds.length; j++)
-        if (boundAt(row, j) !== scan.bounds[j].at)
-            return false;
-    return true;
-};

package/dist/crdt/text/runs.d.ts

@@ -5,7 +5,7 @@
  * children index and document order, and each block's visible content as
  * ordered, immutable runs.
  *
- * Lifetime: the engine doc's. `bindRuns(Y).attach(doc)` returns the doc's
+ * Lifetime: the engine doc's. `indexOf(doc)` returns the doc's
  * one index (built on first use, torn down on the doc's `destroy`); every
  * binding, facade and model read on that doc goes through it.
  *
@@ -59,7 +59,7 @@
  * (`anchored.ts`), the layout rules (`layout.ts`), placements and the
  * children index (`placement.ts`), block records (`records.ts`), the run
  * cache (`cache.ts`), the fold (`fold.ts`), the change report
- * (`report.ts`) and the self-checks (`checks.ts`). This module declares the
+ * (`report.ts`); the self-checks a test lane installs are `indexChecks`. This module declares the
  * index's types and wires the parts into the doc's one index.
  */
 import type { EngineApi, EngineDoc } from '../engine-api.js';
@@ -248,6 +248,9 @@ export type DisplayRoles = {
     /** Every table kind the roles declare, present in the document or not. */
     tableKinds: () => Iterable<string>;
 };
-export declare const bindRuns: (Y: EngineApi) => {
+/** The doc's index — built on first use, torn down when the doc is destroyed. */
+export declare const indexOf: (doc: EngineDoc) => RunView;
+/** The index binding (the public binding's `runs`): {@link indexOf}. */
+export declare const bindRuns: (_Y: EngineApi) => {
     attach: (doc: EngineDoc) => RunView;
 };

package/dist/crdt/text/runs.js

@@ -1,4 +1,3 @@
-import { bindText } from './model.js';
 import { isNodeLike } from '../schema.js';
 import { cloneJsonSafe } from '../../utils/json.js';
 import { indexState } from './index/state.js';
@@ -11,146 +10,142 @@ import { indexRecords } from './index/records.js';
 import { indexCache } from './index/cache.js';
 import { indexFold } from './index/fold.js';
 import { indexReporter } from './index/report.js';
-import { indexSelfChecks } from './index/checks.js';
 export { CONTENT_ATTR, ENTRY_FACET, indexChecks } from './index/shared.js';
 /** One index per engine doc, shared by every binding (the doc's lifetime). */
 const indexes = new WeakMap();
-export const bindRuns = (Y) => {
-    const T = bindText(Y);
-    /** The doc's index — built on first use, torn down when the doc is destroyed. */
-    const attach = (doc) => {
-        let index = indexes.get(doc);
-        if (index === undefined)
-            indexes.set(doc, (index = buildView(doc)));
-        return index;
+/** The doc's index — built on first use, torn down when the doc is destroyed. */
+export const indexOf = (doc) => {
+    let index = indexes.get(doc);
+    if (index === undefined)
+        indexes.set(doc, (index = buildView(doc)));
+    return index;
+};
+/** The index binding (the public binding's `runs`): {@link indexOf}. */
+export const bindRuns = (_Y) => ({ attach: indexOf });
+const buildView = (doc) => {
+    // The index's parts, each over the state and the parts before it (`index/*`).
+    const ix0 = indexState(doc);
+    const ix1 = Object.assign(ix0, indexClaims(ix0));
+    const ix2 = Object.assign(ix1, indexStreams(ix1));
+    const ix3 = Object.assign(ix2, indexAnchored(ix2));
+    const ix4 = Object.assign(ix3, indexLayout(ix3));
+    const ix5 = Object.assign(ix4, indexPlacement(ix4));
+    const ix6 = Object.assign(ix5, indexRecords(ix5));
+    const ix7 = Object.assign(ix6, indexCache(ix6));
+    const ix8 = Object.assign(ix7, indexFold(ix7));
+    const ix = Object.assign(ix8, indexReporter(ix8));
+    const { registry, blocks, rows, homeOfText, shells, placementsMap, frames, displays, ownShim, ensurePlacements, typeOf, order, rebuildTable, scanRow, applyRetargets, updateBlockRec, syncIncarnations, intern, debug, runs, settle, syncPending, syncAll, openTx, onCommit, committed, itemsOf, projectBlock, publish, onUpdate, onReport, hasSubscribers } = ix;
+    const ctx = {
+        blocks,
+        own: ownShim,
+        get placements() {
+            ensurePlacements();
+            return placementsMap;
+        },
+        get kids() {
+            ensurePlacements();
+            return ix.kidsMap;
+        },
+        get order() {
+            ensurePlacements();
+            return order();
+        },
+        // The publication boundary shares THIS interner, so a payload
+        // emitted by `project()`/`contentItems()` is `===` the runs' one.
+        intern,
+        displays
     };
-    const buildView = (doc) => {
-        // The index's parts, each over the state and the parts before it (`index/*`).
-        const ix0 = indexState(Y, T, doc);
-        const ix1 = Object.assign(ix0, indexClaims(ix0));
-        const ix2 = Object.assign(ix1, indexStreams(ix1));
-        const ix3 = Object.assign(ix2, indexAnchored(ix2));
-        const ix4 = Object.assign(ix3, indexLayout(ix3));
-        const ix5 = Object.assign(ix4, indexPlacement(ix4));
-        const ix6 = Object.assign(ix5, indexRecords(ix5));
-        const ix7 = Object.assign(ix6, indexCache(ix6));
-        const ix8 = Object.assign(ix7, indexFold(ix7));
-        const ix = Object.assign(ix8, indexReporter(ix8));
-        ix.checks = indexSelfChecks(ix);
-        const { registry, blocks, rows, homeOfText, shells, placementsMap, frames, displays, ownShim, ensurePlacements, typeOf, order, rebuildTable, scanRow, applyRetargets, updateBlockRec, syncIncarnations, intern, debug, runs, settle, syncPending, syncAll, openTx, onCommit, committed, itemsOf, projectBlock, publish, onUpdate, onReport, hasSubscribers } = ix;
-        const ctx = {
-            blocks,
-            own: ownShim,
-            get placements() {
-                ensurePlacements();
-                return placementsMap;
-            },
-            get kids() {
-                ensurePlacements();
-                return ix.kidsMap;
-            },
-            get order() {
-                ensurePlacements();
-                return order();
-            },
-            // The publication boundary shares THIS interner, so a payload
-            // emitted by `project()`/`contentItems()` is `===` the runs' one.
-            intern,
-            displays
-        };
-        // ── initial scan: index every existing block ────────────────────
-        registry.forEachAttr((v, id) => {
-            if (!isNodeLike(v))
-                return;
-            updateBlockRec(id);
-            for (const b of [id, ...syncIncarnations(id)]) {
-                const row = scanRow(b);
-                if (row !== undefined) {
-                    rows.set(b, row);
-                    homeOfText.set(row.text, b);
-                }
+    // ── initial scan: index every existing block ────────────────────
+    registry.forEachAttr((v, id) => {
+        if (!isNodeLike(v))
+            return;
+        updateBlockRec(id);
+        for (const b of [id, ...syncIncarnations(id)]) {
+            const row = scanRow(b);
+            if (row !== undefined) {
+                rows.set(b, row);
+                homeOfText.set(row.text, b);
             }
-        });
-        rebuildTable(new Set());
-        applyRetargets(null);
-        settle(shells, null);
-        const observer = (e) => onCommit(e);
-        registry.observeDeep(observer);
-        /** Derived state lives exactly as long as the doc. */
-        const teardown = () => {
-            registry.unobserveDeep(observer);
-            doc.off('destroy', teardown);
-            doc.off('update', onUpdate);
-            indexes.delete(doc);
-        };
-        doc.on('destroy', teardown);
-        // ── public surface ───────────────────────────────────────────────
-        const view = {
-            version: () => {
-                syncAll();
-                return ix.version;
-            },
-            runs,
-            contentItems: (b) => {
-                syncAll();
-                return blocks.get(b)?.deleted === false ? itemsOf(b) : [];
-            },
-            // Inline atoms always carry `data` (`{}` when absent) — the public
-            // `JSONInlineBlock` shape of `edytor.value`.
-            contentJSON: (b) => runs(b).map((r) => r.kind === 'text'
-                ? { text: r.text, ...(r.marks !== undefined && { marks: cloneJsonSafe(r.marks) }) }
-                : { id: r.id, type: r.type, data: r.data === undefined ? {} : cloneJsonSafe(r.data) }),
-            view: (tr) => {
-                syncAll();
-                if (tr !== undefined && !committed.has(tr))
-                    syncPending(tr);
-                return ctx;
-            },
-            displayType: (id) => {
-                if (ix.roles === null)
-                    return undefined;
-                syncAll();
-                ensurePlacements();
-                const shown = blocks.has(id) ? typeOf(id) : undefined;
-                return shown === blocks.get(id)?.type ? undefined : shown;
-            },
-            dissolved: (id) => {
-                syncAll();
-                ensurePlacements();
-                return ix.dissolved.has(id);
-            },
-            project: (root) => {
-                syncAll();
-                ensurePlacements();
-                return root === undefined
-                    ? (ix.kidsMap.get(null) ?? []).map((k) => projectBlock(k.id))
-                    : [projectBlock(root)];
-            },
-            roles: (next) => {
-                ix.roles = next;
-                ix.placementFull = true;
-                ix.version++;
-                // No commit carries a role change: report it now (not inside a
-                // transaction, whose commit reports it), so every view follows.
-                if (hasSubscribers() && !openTx())
-                    publish(null, false);
-            },
-            track: () => {
-                syncAll();
-                const f = { touched: new Map(), wrote: false };
-                frames.add(f);
-                return {
-                    end: () => {
-                        syncAll();
-                        frames.delete(f);
-                        return f;
-                    }
-                };
-            },
-            onReport,
-            debug
-        };
-        return view;
+        }
+    });
+    rebuildTable(new Set());
+    applyRetargets(null);
+    settle(shells, null);
+    // Every commit folds once, before the document's `afterTransaction` listeners.
+    doc.on('commit', onCommit);
+    /** Derived state lives exactly as long as the doc. */
+    const teardown = () => {
+        doc.off('commit', onCommit);
+        doc.off('destroy', teardown);
+        doc.off('update', onUpdate);
+        indexes.delete(doc);
+    };
+    doc.on('destroy', teardown);
+    // ── public surface ───────────────────────────────────────────────
+    const view = {
+        version: () => {
+            syncAll();
+            return ix.version;
+        },
+        runs,
+        contentItems: (b) => {
+            syncAll();
+            return blocks.get(b)?.deleted === false ? itemsOf(b) : [];
+        },
+        // Inline atoms always carry `data` (`{}` when absent) — the public
+        // `JSONInlineBlock` shape of `edytor.value`.
+        contentJSON: (b) => runs(b).map((r) => r.kind === 'text'
+            ? { text: r.text, ...(r.marks !== undefined && { marks: cloneJsonSafe(r.marks) }) }
+            : { id: r.id, type: r.type, data: r.data === undefined ? {} : cloneJsonSafe(r.data) }),
+        view: (tr) => {
+            syncAll();
+            if (tr !== undefined && !committed.has(tr))
+                syncPending(tr);
+            return ctx;
+        },
+        displayType: (id) => {
+            if (ix.roles === null)
+                return undefined;
+            syncAll();
+            ensurePlacements();
+            const shown = blocks.has(id) ? typeOf(id) : undefined;
+            return shown === blocks.get(id)?.type ? undefined : shown;
+        },
+        dissolved: (id) => {
+            syncAll();
+            ensurePlacements();
+            return ix.dissolved.has(id);
+        },
+        project: (root) => {
+            syncAll();
+            ensurePlacements();
+            return root === undefined
+                ? (ix.kidsMap.get(null) ?? []).map((k) => projectBlock(k.id))
+                : [projectBlock(root)];
+        },
+        roles: (next) => {
+            ix.roles = next;
+            ix.placementFull = true;
+            ix.version++;
+            // No commit carries a role change: report it now (not inside a
+            // transaction, whose commit reports it), so every view follows.
+            if (hasSubscribers() && !openTx())
+                publish(null, false);
+        },
+        track: () => {
+            syncAll();
+            const f = { touched: new Map(), wrote: false };
+            frames.add(f);
+            return {
+                end: () => {
+                    syncAll();
+                    frames.delete(f);
+                    return f;
+                }
+            };
+        },
+        onReport,
+        debug
     };
-    return { attach };
+    return view;
 };

package/dist/crdt/text/streams.d.ts

@@ -5,7 +5,7 @@
  */
 import type { EngineNode } from '../engine-api.js';
 import type { BlockId, Ownership, Seg, Stream, TextBlockRec, TextRow } from './model.js';
-/** Scan `text` (live space, renderer-free) for its boundary items. */
+/** Scan `text` (live space) for its boundary items. */
 export declare const scanText: (home: BlockId, text: EngineNode) => TextRow;
 export declare const byId: (a: string, b: string) => number;
 /** Each block's delimiting boundary: the lowest-id live boundary whose nonce matches its record. */

package/dist/crdt/text/streams.js

@@ -1,5 +1,5 @@
 import { isBoundary, nodeStart } from './items.js';
-/** Scan `text` (live space, renderer-free) for its boundary items. */
+/** Scan `text` (live space) for its boundary items. */
 export const scanText = (home, text) => {
     const bounds = [];
     let at = 0;

package/dist/crdt/vendor/yjs/API-NOTES.md

@@ -15,8 +15,29 @@ Source of truth: `src/index.js` exports + JSDoc in `src/ynode.js`.
 > `intersectUpdateWithContentIds[V2]`, `convertUpdateFormatV1ToV2`, the id-map
 > algebra (`mergeIdMaps`, `diffIdMap`, `intersectMaps`, `filterIdMap`, …), the
 > content-id helpers, `$node`, `getNodeChildren`, `getPathTo`, `tryGc`,
-> `undoContentIds` and `logNode`. The table below is the rc.26 probe record;
-> read it against that list.
+> `undoContentIds` and `logNode`.
+>
+> **Since patch YP16 it ships no delta layer either:** no `toDelta`/
+> `toDeltaDeep`/`applyDelta`, no maintained `node.delta` (`clearCache`), no
+> `node.change`, no `'delta'` event, no `YNode.from`, no delta inserted as
+> content, no `YEvent#delta`/`deltaDeep`/`getDelta`, no renderer
+> (`AbstractRenderer`, `$renderer`, `useRenderer`, the `renderer` arguments of
+> `RangeCursor` and the relative positions), no schemas (`$doc`, `$nodeAny`,
+> `$idSet`, `$idMapAny`, `$contentIds`, `$contentMap`) and no id/content maps
+> (`IdMap`, `ContentAttribute`, `ContentMap` and their codecs). Text reads:
+> `toArray()` (a run of text under one set of formats is one string),
+> `toJSON()`, `RangeCursor#read`.
+>
+> **Since patch YP17 it has one update encoding,** upstream's v2 under the
+> unsuffixed names (`applyUpdate`, `encodeStateAsUpdate`, `mergeUpdates`,
+> `diffUpdate`, `decodeUpdate`, `UpdateEncoder`, `UpdateDecoder`, the
+> `update` event): no v1 encoding, no `*V2` names, no `updateV2` event, no
+> format conversion.
+>
+> **Since patch YP18 it ships no `UndoManager`:** the history is edytor's
+> (`document.history`, `createUndoManager`); the engine keeps `redoItem`,
+> `keepItem` and `followRedone`. The table below is the rc.26 probe record;
+> read it against these lists.
 
 ## v13 → v14 name map (what's gone, what's renamed)
 
@@ -35,16 +56,12 @@ Source of truth: `src/index.js` exports + JSDoc in `src/ynode.js`.
 
 ## Behavioral caveats measured
 
-- **Detached reads are empty.** Reading `delta`/`toString`/`slice` on a node
+- **Detached reads are empty.** Reading `toString`/`slice` on a node
   before it is integrated into a `Doc` logs `Invalid access: Add Yjs type to a
   document before reading data.` and renders empty. Writes pre-integration
   persist and appear after `insert` into an integrated parent.
-- **`node.delta` is a live cache** — do not mutate it (`applyDelta` is the write
-  path); `clone()` for a snapshot. Integration after a detached `.delta` read
-  does not retroactively refresh the cached delta — read `.delta` only once
-  integrated.
 - `toString()` is the element renderer (`<p id="b1">hi</p>`), not raw text —
-  use `toArray()`/`delta` for text content.
+  use `toArray()` for text content.
 - `doc.get(key)` is memoized; the root node's `name` is `null` even though the
   key exists (keys live in `tname` of relative positions, not `node.name`).