edytor 1.0.0-rc.3 → 2.0.0

package/dist/crdt/index.d.ts

@@ -24,9 +24,9 @@
  *   (`BlockSpec`, `Destination`, `ProjectedDoc`, `DocChange`, `JSONDoc`,
  *   …), the provider/sync contract (`EdytorSync`), `Awareness`, the
  *   admission errors a load throws, the attribution read surface
- *   (`DocumentAttribution`), and migration.
+ *   (`DocumentAttribution`).
  * - **Composition** — `bindCrdt(Y)` for consumers that inject the engine
- *   themselves (node/SSR-side provider stacks, migration tooling,
+ *   themselves (node/SSR-side provider stacks,
  *   alternate engine instances) plus the engine typings that contract
  *   needs.
  *
@@ -49,15 +49,14 @@ export { defaultSemantics, richTextSemantics, codeSemantics, imageSemantics, med
 export { tableBlock, type TableBlockOptions } from './tables.js';
 export { markName, type MarkEdge } from './text/marks.js';
 export type { JSONDoc, JSONBlock, JSONText, JSONInlineBlock, SerializableContent } from '../utils/json.js';
-/** Canonical JSON → the `BlockSpec` `facade.insertBlock` takes (ids kept or minted). */
+/** Canonical JSON → the `BlockSpec` `facade.insertBlocks` takes (ids kept or minted). */
 export { toBlockSpec } from '../utils/json.js';
 export { type EdytorDoc, type OpResult, type Plan, type Prepared, type DocChange, type BlockRole, type OrderPolicy, type DocAnchor, type AnchorAffinity, type DataTarget } from './edytor-doc.js';
-export { DOCUMENT_OPERATIONS, type DocumentOperations, type DocumentReads, type DocumentWrites } from './operations.js';
+export { DOCUMENT_OPERATIONS, DOCUMENT_WRITES, type DocumentOperations, type DocumentReads, type DocumentWrites } from './operations.js';
 export { type DataPatch } from './data.js';
 export { type DocPosition, type RangeView } from './rangeDelete.js';
 export { type FlowView } from './flow.js';
 export { type BlockId, type Destination, type ContentItem, type BlockSpec, type InlineSpec, type ProjectedBlock, type ProjectedDoc } from './placement/model.js';
-export { type DocBlock } from './nodes.js';
 export { type ContentRun } from './text/runs.js';
 export type { YDoc, YUndoManager, YTransaction } from './engine-api.js';
 export { type EdytorSync, type EdytorSyncPayload, type EdytorSyncCleanup, type IndexeddbSyncOptions, type WebsocketSync, type WebsocketSyncOptions, type ProviderStack, type PrefetchOptions, type PrefetchResult, type LastUpdatedOptions } from './providers/index.js';
@@ -66,10 +65,9 @@ export { Awareness, type AwarenessDoc, type AwarenessStates, type AwarenessUpdat
 export { SchemaMismatchError, UndecodableUpdateError, UnsupportedDocError } from './admission.js';
 export { type DocumentAttribution, type AttributionActor, type ActorProfile, type AttributionController } from './attribution/index.js';
 export { type ActorId, type BlockAttribution } from './attribution/index.js';
-export { isLegacyDoc } from './migration/legacy-schema.js';
-export { type Migration, type MigrationStatus, type MigrationRecord, type MigrationPhase, type MigrateResult, type MigrateOptions } from './migration/migrate.js';
 import type { EngineApi, YDoc } from './engine-api.js';
 import { Awareness as _Awareness } from './protocols/awareness.js';
+import { type PrefetchOptions } from './providers/index.js';
 export declare const bindCrdt: (Y: EngineApi) => {
     /** Create a v14 edytor document — `new Y.Doc(opts)` on the bound engine, with the document's rules (`doc.newDoc`). */
     createDoc: (opts?: ConstructorParameters<EngineApi["Doc"]>[0]) => YDoc;
@@ -77,7 +75,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
     Awareness: typeof _Awareness;
     doc: {
         SCHEMA: {
-            readonly version: 5;
+            readonly version: 6;
             readonly name: "edytor-doc";
             readonly roots: {
                 readonly registry: "blocks";
@@ -88,7 +86,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 readonly schema: "schema";
             };
         };
-        SCHEMA_VERSION: 5;
+        SCHEMA_VERSION: 6;
         SCHEMA_NAME: "edytor-doc";
         META_KEY: "meta";
         init: (doc: import("./engine-api.js").EngineDoc, opts?: {
@@ -108,17 +106,8 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => import("./edytor-doc.js").Prepared;
                 deleteRange: (from: import("./rangeDelete.js").DocPosition, to: import("./rangeDelete.js").DocPosition, view?: import("./rangeDelete.js").RangeView) => import("./edytor-doc.js").Prepared;
                 replaceRange: (from: import("./rangeDelete.js").DocPosition, to: import("./rangeDelete.js").DocPosition, view?: import("./rangeDelete.js").RangeView) => import("./edytor-doc.js").Prepared;
-                insertTableRow: (table: import("./index.js").BlockId, index: number) => import("./edytor-doc.js").Prepared;
-                deleteTableRows: (rows: readonly import("./index.js").BlockId[]) => import("./edytor-doc.js").Prepared;
-                insertTableColumn: (table: import("./index.js").BlockId, index: number, width?: number) => import("./edytor-doc.js").Prepared;
-                deleteTableColumn: (table: import("./index.js").BlockId, column: string | number) => import("./edytor-doc.js").Prepared;
-                moveTableColumn: (table: import("./index.js").BlockId, column: string | number, to: number) => import("./edytor-doc.js").Prepared;
-                moveTableRows: (rows: readonly import("./index.js").BlockId[], to: number) => import("./edytor-doc.js").Prepared;
-                fillTableCell: (row: import("./index.js").BlockId, column: string | number) => import("./edytor-doc.js").Prepared;
                 insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | import("./index.js").JSONBlock)[]) => import("./edytor-doc.js").Prepared;
-                insertBlock: (dest: import("./index.js").Destination, spec: import("./index.js").BlockSpec | import("./index.js").JSONBlock) => import("./edytor-doc.js").Prepared;
                 moveBlocks: (ids: readonly import("./index.js").BlockId[], dest: import("./index.js").Destination) => import("./edytor-doc.js").Prepared;
-                moveBlock: (id: import("./index.js").BlockId, dest: import("./index.js").Destination) => import("./edytor-doc.js").Prepared;
                 nestBlock: (id: import("./index.js").BlockId, parent: import("./index.js").BlockId) => import("./edytor-doc.js").Prepared;
                 unNestBlock: (id: import("./index.js").BlockId) => import("./edytor-doc.js").Prepared;
                 unNestBlocks: (ids: readonly import("./index.js").BlockId[]) => import("./edytor-doc.js").Prepared;
@@ -138,22 +127,18 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 setBlock: (id: import("./index.js").BlockId, value: {
                     type?: string;
                     data?: Record<string, unknown>;
-                    content?: import("./index.js").ContentItem[];
-                    children?: import("./index.js").BlockSpec[];
+                    content?: (import("./index.js").ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
+                    children?: (import("./index.js").BlockSpec | import("./index.js").JSONBlock)[];
                 }) => import("./edytor-doc.js").Prepared;
                 setBlockType: (id: import("./index.js").BlockId, type: string) => import("./edytor-doc.js").Prepared;
                 patchData: (target: import("./edytor-doc.js").DataTarget, patches: readonly import("./data.js").DataPatch[]) => import("./edytor-doc.js").Prepared;
-                setBlockData: (id: import("./index.js").BlockId, data: Record<string, unknown>) => import("./edytor-doc.js").Prepared;
-                duplicateBlock: (id: import("./index.js").BlockId, freshId: (oldId: string, kind: "block" | "inline") => string) => import("./edytor-doc.js").Prepared;
+                duplicateBlock: (id: import("./index.js").BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => import("./edytor-doc.js").Prepared;
                 insertText: (id: import("./index.js").BlockId, offset: number, text: string, marks?: Record<string, unknown>) => import("./edytor-doc.js").Prepared;
                 deleteText: (id: import("./index.js").BlockId, offset: number, length: number) => import("./edytor-doc.js").Prepared;
                 formatRange: (id: import("./index.js").BlockId, offset: number, length: number, marks: Record<string, unknown>) => import("./edytor-doc.js").Prepared;
-                setMark: (id: import("./index.js").BlockId, offset: number, length: number, name: string, value: unknown) => import("./edytor-doc.js").Prepared;
-                unsetMark: (id: import("./index.js").BlockId, offset: number, length: number, name: string) => import("./edytor-doc.js").Prepared;
                 clearMarks: (id: import("./index.js").BlockId, offset: number, length: number) => import("./edytor-doc.js").Prepared;
-                insertInline: (id: import("./index.js").BlockId, offset: number, atom: import("./index.js").InlineSpec) => import("./edytor-doc.js").Prepared;
+                insertInline: (id: import("./index.js").BlockId, offset: number, atom: import("./doc/content.js").NewInline) => import("./edytor-doc.js").Prepared;
                 removeInline: (id: import("./index.js").BlockId, inlineId: string) => import("./edytor-doc.js").Prepared;
-                setInlineData: (id: import("./index.js").BlockId, inlineId: string, data: Record<string, unknown>) => import("./edytor-doc.js").Prepared;
                 deleteBlocks: (ids: readonly import("./index.js").BlockId[]) => import("./edytor-doc.js").Prepared;
             };
             apply: (p: import("./edytor-doc.js").Prepared) => import("./edytor-doc.js").OpResult;
@@ -178,7 +163,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 writePlacement: (doc: import("./engine-api.js").EngineDoc, node: import("./engine-api.js").EngineNode, p: import("./index.js").BlockId | null, r: string) => void;
                 withdrawOnUndo: (doc: import("./engine-api.js").EngineDoc) => (item: import("./engine-api.js").EngineItemRef, stackItem: {
                     inserts: {
-                        hasId(id: unknown): boolean;
+                        has(client: number, clock: number): boolean;
                     };
                 }) => boolean;
                 materializeSpec: (doc: import("./engine-api.js").EngineDoc, sp: import("./index.js").BlockSpec, parent: import("./index.js").BlockId | null, rank: string) => void;
@@ -228,21 +213,11 @@ export declare const bindCrdt: (Y: EngineApi) => {
             };
             runsView: import("./text/runs.js").RunView;
             version: number;
-            block: (id: import("./index.js").BlockId) => import("./nodes.js").DocBlock;
             insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => import("./edytor-doc.js").OpResult;
             deleteRange: (from: import("./rangeDelete.js").DocPosition, to: import("./rangeDelete.js").DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => import("./edytor-doc.js").OpResult;
             replaceRange: (from: import("./rangeDelete.js").DocPosition, to: import("./rangeDelete.js").DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => import("./edytor-doc.js").OpResult;
-            insertTableRow: (table: string, index: number) => import("./edytor-doc.js").OpResult;
-            deleteTableRows: (rows: readonly string[]) => import("./edytor-doc.js").OpResult;
-            insertTableColumn: (table: string, index: number, width?: number | undefined) => import("./edytor-doc.js").OpResult;
-            deleteTableColumn: (table: string, column: string | number) => import("./edytor-doc.js").OpResult;
-            moveTableColumn: (table: string, column: string | number, to: number) => import("./edytor-doc.js").OpResult;
-            moveTableRows: (rows: readonly string[], to: number) => import("./edytor-doc.js").OpResult;
-            fillTableCell: (row: string, column: string | number) => import("./edytor-doc.js").OpResult;
-            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").JSONBlock | import("./index.js").BlockSpec)[]) => import("./edytor-doc.js").OpResult;
-            insertBlock: (dest: import("./index.js").Destination, spec: import("./index.js").JSONBlock | import("./index.js").BlockSpec) => import("./edytor-doc.js").OpResult;
+            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | import("./index.js").JSONBlock)[]) => import("./edytor-doc.js").OpResult;
             moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => import("./edytor-doc.js").OpResult;
-            moveBlock: (id: string, dest: import("./index.js").Destination) => import("./edytor-doc.js").OpResult;
             nestBlock: (id: string, parent: string) => import("./edytor-doc.js").OpResult;
             unNestBlock: (id: string) => import("./edytor-doc.js").OpResult;
             unNestBlocks: (ids: readonly string[]) => import("./edytor-doc.js").OpResult;
@@ -262,22 +237,18 @@ export declare const bindCrdt: (Y: EngineApi) => {
             setBlock: (id: string, value: {
                 type?: string;
                 data?: Record<string, unknown>;
-                content?: import("./index.js").ContentItem[];
-                children?: import("./index.js").BlockSpec[];
+                content?: (import("./index.js").ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
+                children?: (import("./index.js").BlockSpec | import("./index.js").JSONBlock)[];
             }) => import("./edytor-doc.js").OpResult;
             setBlockType: (id: string, type: string) => import("./edytor-doc.js").OpResult;
             patchData: (target: import("./edytor-doc.js").DataTarget, patches: readonly import("./data.js").DataPatch[]) => import("./edytor-doc.js").OpResult;
-            setBlockData: (id: string, data: Record<string, unknown>) => import("./edytor-doc.js").OpResult;
-            duplicateBlock: (id: string, freshId: (oldId: string, kind: "block" | "inline") => string) => import("./edytor-doc.js").OpResult;
+            duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => import("./edytor-doc.js").OpResult;
             insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => import("./edytor-doc.js").OpResult;
             deleteText: (id: string, offset: number, length: number) => import("./edytor-doc.js").OpResult;
             formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => import("./edytor-doc.js").OpResult;
-            setMark: (id: string, offset: number, length: number, name: string, value: unknown) => import("./edytor-doc.js").OpResult;
-            unsetMark: (id: string, offset: number, length: number, name: string) => import("./edytor-doc.js").OpResult;
             clearMarks: (id: string, offset: number, length: number) => import("./edytor-doc.js").OpResult;
-            insertInline: (id: string, offset: number, atom: import("./index.js").InlineSpec) => import("./edytor-doc.js").OpResult;
+            insertInline: (id: string, offset: number, atom: import("./doc/content.js").NewInline) => import("./edytor-doc.js").OpResult;
             removeInline: (id: string, inlineId: string) => import("./edytor-doc.js").OpResult;
-            setInlineData: (id: string, inlineId: string, data: Record<string, unknown>) => import("./edytor-doc.js").OpResult;
             deleteBlocks: (ids: readonly string[]) => import("./edytor-doc.js").OpResult;
             init: (opts?: Parameters<(doc: import("./engine-api.js").EngineDoc, opts?: {
                 content?: import("./index.js").BlockSpec[];
@@ -289,10 +260,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
             checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
             assertSchema: () => void;
             dispose: () => void;
-            createUndoManager: (options?: ConstructorParameters<EngineApi["UndoManager"]>[1] & {
-                limit?: number;
-            }) => import("./engine-api.js").YUndoManager;
-            releaseHistory: (um: import("./engine-api.js").YUndoManager) => void;
+            createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
             project: () => import("./index.js").ProjectedDoc;
             toJSON: () => import("./index.js").JSONDoc;
             blockJSON: (id: string) => import("./index.js").JSONBlock;
@@ -312,6 +280,12 @@ export declare const bindCrdt: (Y: EngineApi) => {
             blockDataOf: (id: string) => Record<string, unknown> | undefined;
             docData: () => import("./doc/types.js").JsonObj;
             dataItemIds: (target: import("./edytor-doc.js").DataTarget, path: readonly string[]) => string[];
+            dataPreview: (target: import("./edytor-doc.js").DataTarget, pending: readonly import("./data.js").DataPatch[]) => {
+                data: {
+                    [x: string]: unknown;
+                };
+                ids: (path: readonly string[]) => string[];
+            } | null;
             blockAttribution: (id: string) => import("./index.js").BlockAttribution | undefined;
             crdtId: (id: string) => string | null;
             resolveBlock: (id: string) => import("./engine-api.js").EngineNode | null;
@@ -400,7 +374,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
             writePlacement: (doc: import("./engine-api.js").EngineDoc, node: import("./engine-api.js").EngineNode, p: import("./index.js").BlockId | null, r: string) => void;
             withdrawOnUndo: (doc: import("./engine-api.js").EngineDoc) => (item: import("./engine-api.js").EngineItemRef, stackItem: {
                 inserts: {
-                    hasId(id: unknown): boolean;
+                    has(client: number, clock: number): boolean;
                 };
             }) => boolean;
             materializeSpec: (doc: import("./engine-api.js").EngineDoc, sp: import("./index.js").BlockSpec, parent: import("./index.js").BlockId | null, rank: string) => void;
@@ -453,7 +427,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
         };
     };
     providers: {
-        prefetch: (options: import("./index.js").PrefetchOptions) => Promise<import("./index.js").PrefetchResult>;
+        prefetch: (options: PrefetchOptions) => Promise<import("./index.js").PrefetchResult>;
         lastUpdated: (options: import("./index.js").LastUpdatedOptions) => Promise<number | null>;
         documentSnapshot: (options: import("./index.js").LastUpdatedOptions) => Promise<import("./index.js").JSONDoc | null>;
         IndexeddbPersistence: {
@@ -479,7 +453,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 bcconnected: boolean;
                 disableBc: boolean;
                 _ownsAwareness: boolean;
-                _bcSubscriber: (data: ArrayBuffer, origin: unknown) => void;
+                _bcSubscriber: (data: ArrayBuffer | Uint8Array, origin: unknown) => void;
                 _awarenessUpdateHandler: (updates: {
                     added: number[];
                     updated: number[];
@@ -551,7 +525,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
                 bcChannel: string;
                 bcconnected: boolean;
                 disableBc: boolean;
-                _bcSubscriber: (data: ArrayBuffer, origin: unknown) => void;
+                _bcSubscriber: (data: ArrayBuffer | Uint8Array, origin: unknown) => void;
                 _fromTab: {};
                 wsUnsuccessfulReconnects: number;
                 wsLastMessageReceived: number;
@@ -618,31 +592,11 @@ export declare const bindCrdt: (Y: EngineApi) => {
             _dbsize: number;
             _destroyed: boolean;
         }, forceStore?: boolean) => Promise<undefined>;
-        clearDocument: (name: string) => Promise<any>;
+        clearDocument: (name: string) => Promise<void>;
         PREFERRED_TRIM_SIZE: number;
         createIndexeddbSync: (name: string) => import("./index.js").EdytorSync;
         createWebsocketSync: (options: import("./index.js").WebsocketSyncOptions) => import("./index.js").WebsocketSync;
     };
-    migration: {
-        migrate: (name: string, options?: import("./index.js").MigrateOptions) => Promise<import("./index.js").MigrateResult>;
-        rollback: (name: string) => Promise<void>;
-        status: (name: string) => Promise<import("./index.js").MigrationRecord>;
-        waitForSettled: (name: string) => Promise<import("./index.js").MigrationRecord>;
-    };
-    /** The generation cutover (4 → 5): a generation-4 state read as JSON. */
-    generations: {
-        isPreviousGenerationRecord: (v: unknown) => v is import("./protocol.js").GenerationRecord;
-        previousJSON: (updates: ReadonlyArray<Uint8Array | {
-            v2: Uint8Array;
-        }>, facadeOf: (doc: YDoc) => {
-            toJSON(): import("./index.js").JSONDoc;
-            dispose(): void;
-        }) => import("./index.js").JSONDoc;
-        seedOf: (value: import("./index.js").JSONDoc, semantics?: import("./document.js").DocumentSemanticsConfig) => Uint8Array;
-        previousJSONWith: (updates: ReadonlyArray<Uint8Array | {
-            v2: Uint8Array;
-        }>, semantics?: import("./document.js").DocumentSemanticsConfig) => import("./index.js").JSONDoc;
-    };
     sync: {
         messageYjsSyncStep1: number;
         messageYjsSyncStep2: number;
@@ -650,12 +604,7 @@ export declare const bindCrdt: (Y: EngineApi) => {
         remoteApplyOrigin: symbol;
         writeSyncStep1: (encoder: import("lib0-v14/encoding").Encoder, doc: YDoc) => void;
         writeSyncStep2: (encoder: import("lib0-v14/encoding").Encoder, doc: YDoc, encodedStateVector?: Uint8Array) => void;
-        step2Update: (payload: Uint8Array) => Uint8Array;
-        readSyncStep1: (decoder: import("lib0-v14/decoding").Decoder, encoder: import("lib0-v14/encoding").Encoder, doc: YDoc) => void;
-        readSyncStep2: (decoder: import("lib0-v14/decoding").Decoder, doc: YDoc, transactionOrigin: unknown, errorHandler?: (error: Error) => unknown) => void;
         writeUpdate: (encoder: import("lib0-v14/encoding").Encoder, update: Uint8Array) => void;
-        readUpdate: (decoder: import("lib0-v14/decoding").Decoder, doc: YDoc, transactionOrigin: unknown, errorHandler?: (error: Error) => unknown) => void;
-        readSyncMessage: (decoder: import("lib0-v14/decoding").Decoder, encoder: import("lib0-v14/encoding").Encoder, doc: YDoc, transactionOrigin: unknown, errorHandler?: (error: Error) => unknown) => number;
         applyRemote: (doc: YDoc, update: Uint8Array, transactionOrigin: unknown, errorHandler?: (error: Error) => unknown) => {
             applied: boolean;
             problem: import("./edytor-doc.js").SchemaProblem | null;
@@ -670,13 +619,11 @@ export declare const bindCrdt: (Y: EngineApi) => {
     };
     /** The document-admission boundary (`admitUpdate` staged restore + the shared gate vocabulary). */
     admission: {
-        admitUpdate: (update: Uint8Array | ReadonlyArray<Uint8Array | {
-            v2: Uint8Array;
-        }>, docName?: string, options?: {
+        admitUpdate: (update: Uint8Array | ReadonlyArray<Uint8Array>, docName?: string, options?: {
             prepare?: (doc: YDoc) => void;
         }) => YDoc;
     };
-    /** Bind the attribution service to this engine — actor dictionary + legacy `a/` reads + block attribution (documents attach it automatically). */
+    /** Bind the attribution service to this engine — actor dictionary + block attribution (documents attach it automatically). */
     attribution: {
         attach: (doc: import("./engine-api.js").EngineDoc, opts: {
             actor: import("./index.js").AttributionActor;
@@ -684,5 +631,5 @@ export declare const bindCrdt: (Y: EngineApi) => {
     };
 };
 export type Crdt = ReturnType<typeof bindCrdt>;
-export type { EngineApi, EngineDoc, EngineNode, EngineDeepEvent, EngineTransaction, EngineItemRef, YNode, YItem } from './engine-api.js';
+export type { EngineApi, EngineDoc, EngineNode, EngineTransaction, EngineItemRef, YNode, YItem } from './engine-api.js';
 export { EdytorDocDisposedError, DEFAULT_HISTORY_LIMIT } from './edytor-doc.js';

package/dist/crdt/index.js

@@ -24,9 +24,9 @@
  *   (`BlockSpec`, `Destination`, `ProjectedDoc`, `DocChange`, `JSONDoc`,
  *   …), the provider/sync contract (`EdytorSync`), `Awareness`, the
  *   admission errors a load throws, the attribution read surface
- *   (`DocumentAttribution`), and migration.
+ *   (`DocumentAttribution`).
  * - **Composition** — `bindCrdt(Y)` for consumers that inject the engine
- *   themselves (node/SSR-side provider stacks, migration tooling,
+ *   themselves (node/SSR-side provider stacks,
  *   alternate engine instances) plus the engine typings that contract
  *   needs.
  *
@@ -65,24 +65,23 @@ export { defaultSemantics, richTextSemantics, codeSemantics, imageSemantics, med
 export { tableBlock } from './tables.js';
 // Paired marks — a mark's edge as document semantics, the record a key names.
 export { markName } from './text/marks.js';
-/** Canonical JSON → the `BlockSpec` `facade.insertBlock` takes (ids kept or minted). */
+/** Canonical JSON → the `BlockSpec` `facade.insertBlocks` takes (ids kept or minted). */
 export { toBlockSpec } from '../utils/json.js';
 // ── 2 · The document's vocabulary ──────────────────────────────────────
 //
 // Types a consumer meets while driving the document's operations
-// (`DocumentOperations`: `document.insertBlock(…)`, a room's `transact`) — block specs, destinations, projected
+// (`DocumentOperations`: `document.insertBlocks(…)`, a room's `transact`) — block specs, destinations, projected
 // trees, change notifications — plus the engine-object types the
 // document's own members are typed as (`document.doc: YDoc`,
 // `document.history: YUndoManager`).
 export {} from './edytor-doc.js';
-export { DOCUMENT_OPERATIONS } from './operations.js';
+export { DOCUMENT_OPERATIONS, DOCUMENT_WRITES } from './operations.js';
 export {} from './data.js';
 export {} from './rangeDelete.js';
 export {} from './flow.js';
 export {} from './placement/model.js';
-export {} from './nodes.js';
-// `ContentRun` — the maintained-runs item the view layer's delta
-// serialization speaks (`text/deltas.ts`). Part of the public
+// `ContentRun` — the maintained-runs item the view layer's text values
+// read (`segmentJSON`, `session/handles.ts`). Part of the public
 // model→render vocabulary.
 export {} from './text/runs.js';
 // ── 3 · Sync, providers, awareness ─────────────────────────────────────
@@ -106,65 +105,40 @@ export { SchemaMismatchError, UndecodableUpdateError, UnsupportedDocError } from
 // ── 5 · Attribution (read surface) ─────────────────────────────────────
 //
 // `document.attribution` hands back a `DocumentAttribution` — compact
-// per-block records, the replicated actor dictionary, and `legacy()`
-// over pre-existing per-edit records. The types are the public read
-// vocabulary; ordinary editing writes no per-edit attribution.
+// per-block records and the replicated actor dictionary. The types are
+// the public read vocabulary; ordinary editing writes no per-edit
+// attribution.
 export {} from './attribution/index.js';
 // Compact per-BLOCK attribution read vocabulary (`b/<blockId>`
 // records + the block-node `l` attr — see `attribution/block.ts`).
-// `document.attribution.block(id)` / `facade.blockAttribution(id)` /
-// `DocBlock.attribution` are the read entry points.
+// `document.attribution.block(id)` / `document.blockAttribution(id)`
+// are the read entry points.
 export {} from './attribution/index.js';
-// ── 6 · Migration ──────────────────────────────────────────────────────
-//
-// v13 → v14 one-way import: `isLegacyDoc` detects a v13-era layout, the
-// `Migration` surface (via `bindCrdt(Y).migration` or `bindMigration`)
-// rebuilds an admitted document whose `MigrateResult.update` restores
-// through `loadDocument`. Runbook: `docs/crdt-v14-migration.md`.
-export { isLegacyDoc } from './migration/legacy-schema.js';
-export {} from './migration/migrate.js';
-// ── 7 · Composition — injecting the engine ─────────────────────────────
-//
-// `bindCrdt(Y)` is the supported one-shot entry for consumers that take
-// the engine themselves (the documented node/SSR path):
-//
-// ```ts
-// import * as Y from 'edytor/crdt';        // vendored v14 engine
-// import { bindCrdt } from 'edytor/crdt/edytor';
-// const crdt = bindCrdt(Y);
-// const doc = crdt.createDoc();
-// const provider = new crdt.providers.IndexeddbPersistence('my-doc', doc);
-// ```
-//
-// Everything `bindCrdt` composes is also available pre-bound through the
-// document factories above — reach for `bindCrdt` when the caller needs
-// the raw provider/migration/sync stacks on a doc it owns, not for
-// ordinary document work. `EngineApi`/`EngineDoc`/`YDoc` and friends are
-// the typings that injection contract speaks.
-import { bindGenerations } from './migration/generation.js';
 import { Awareness as _Awareness } from './protocols/awareness.js';
 import { bindAdmission } from './admission.js';
 import { bindAttribution } from './attribution/index.js';
 import { bindEdytorDoc } from './edytor-doc.js';
-import { bindProviders } from './providers/index.js';
-import { bindMigration } from './migration/migrate.js';
+import { bindProviders, documentSnapshot, lastUpdated, prefetchWith } from './providers/index.js';
 import { bindSync } from './protocols/sync.js';
 export const bindCrdt = (Y) => {
     const doc = bindEdytorDoc(Y);
+    const providers = bindProviders(Y);
     return {
         /** Create a v14 edytor document — `new Y.Doc(opts)` on the bound engine, with the document's rules (`doc.newDoc`). */
         createDoc: (opts) => doc.newDoc(opts),
         /** Engine-free — same class for every engine instance. */
         Awareness: _Awareness,
         doc,
-        providers: bindProviders(Y),
-        migration: bindMigration(Y),
-        /** The generation cutover (4 → 5): a generation-4 state read as JSON. */
-        generations: bindGenerations(Y),
+        providers: {
+            ...providers,
+            prefetch: (options) => prefetchWith(Y, providers, options),
+            lastUpdated,
+            documentSnapshot
+        },
         sync: bindSync(Y),
         /** The document-admission boundary (`admitUpdate` staged restore + the shared gate vocabulary). */
         admission: bindAdmission(Y),
-        /** Bind the attribution service to this engine — actor dictionary + legacy `a/` reads + block attribution (documents attach it automatically). */
+        /** Bind the attribution service to this engine — actor dictionary + block attribution (documents attach it automatically). */
         attribution: bindAttribution(Y)
     };
 };

package/dist/crdt/operations.d.ts

@@ -1,27 +1,27 @@
 /**
- * The document's public operations and reads (`DocumentOperations`): the
- * raw path, view-free, with no plugin hook, no view's undo and no readonly
- * check. An `EdytorDocument` carries them itself (`document.insertBlock(…)`),
- * and a room's `transact` callback and `validate` receive them. The
- * facade a document binds has more (the index, the engine hooks): those
- * stay internal. `DOCUMENT_OPERATIONS` lists the names, checked against
- * the interface here and against the facade in `document.ts`. Worker-safe:
- * types and one list.
+ * The document's public operations and reads (`DocumentOperations`). The
+ * writes (`DocumentWrites`) are the one operation set, entered two ways
+ * under the same names and arguments: on a bare `EdytorDocument`
+ * (`document.insertBlocks(…)`, a room's `transact` callback and `validate`)
+ * they are raw — no plugin hook, no view's undo, no readonly check; through
+ * a view (`edytor.insertBlocks(…)`) they are dispatched. The facade a
+ * document binds has more (the index, the engine hooks): those stay
+ * internal. `DOCUMENT_OPERATIONS` lists the names, `DOCUMENT_WRITES` the
+ * writes, checked against the interfaces here and against the facade in
+ * `document.ts`. Worker-safe: types and two lists.
  */
 import type { BlockAttribution } from './attribution/block.js';
 import type { AnchorAffinity, DataTarget, DocAnchor, DocChange, JsonObj, OpResult, OrderPolicy, Prepared } from './doc/types.js';
 import type { DataPatch } from './data.js';
+import type { NewInline } from './doc/content.js';
 import type { Flow, FlowTarget, FlowView } from './flow.js';
-import type { DocBlock } from './nodes.js';
-import type { BlockId, BlockSpec, ContentItem, Destination, InlineSpec, ProjectedDoc, SplitTail } from './placement/model.js';
+import type { BlockId, BlockSpec, ContentItem, Destination, ProjectedDoc, SplitTail } from './placement/model.js';
 import type { DocPosition, RangeView } from './rangeDelete.js';
 import type { ContentRun } from './text/runs.js';
-import type { JSONBlock, JSONDoc } from '../utils/json.js';
+import type { JSONBlock, JSONDoc, JSONInlineBlock, JSONText } from '../utils/json.js';
 /** The document's writes: each one transaction, answering what it did (`OpResult`). */
 export interface DocumentWrites {
-    insertBlock(dest: Destination, spec: JSONBlock | BlockSpec): OpResult;
     insertBlocks(dest: Destination, specs: readonly (JSONBlock | BlockSpec)[]): OpResult;
-    moveBlock(id: BlockId, dest: Destination): OpResult;
     moveBlocks(ids: readonly BlockId[], dest: Destination): OpResult;
     nestBlock(id: BlockId, parent: BlockId): OpResult;
     unNestBlock(id: BlockId): OpResult;
@@ -43,29 +43,20 @@ export interface DocumentWrites {
     setBlock(id: BlockId, value: {
         type?: string;
         data?: Record<string, unknown>;
-        content?: ContentItem[];
-        children?: BlockSpec[];
+        content?: (ContentItem | JSONText | JSONInlineBlock)[];
+        children?: (BlockSpec | JSONBlock)[];
     }): OpResult;
     setBlockType(id: BlockId, type: string): OpResult;
     patchData(target: DataTarget, patches: readonly DataPatch[]): OpResult;
-    setBlockData(id: BlockId, data: Record<string, unknown>): OpResult;
-    duplicateBlock(id: BlockId, freshId: (oldId: string, kind: 'block' | 'inline') => string): OpResult;
-    insertTableRow(table: BlockId, index: number): OpResult;
-    deleteTableRows(rows: readonly BlockId[]): OpResult;
-    insertTableColumn(table: BlockId, index: number, width?: number): OpResult;
-    deleteTableColumn(table: BlockId, column: string | number): OpResult;
-    moveTableColumn(table: BlockId, column: string | number, to: number): OpResult;
-    moveTableRows(rows: readonly BlockId[], to: number): OpResult;
-    fillTableCell(row: BlockId, column: string | number): OpResult;
+    /** `freshId` names each copy (fresh ids by default). */
+    duplicateBlock(id: BlockId, freshId?: (oldId: string, kind: 'block' | 'inline') => string): OpResult;
     insertText(id: BlockId, offset: number, text: string, marks?: Record<string, unknown>): OpResult;
     deleteText(id: BlockId, offset: number, length: number): OpResult;
     formatRange(id: BlockId, offset: number, length: number, marks: Record<string, unknown>): OpResult;
-    setMark(id: BlockId, offset: number, length: number, name: string, value: unknown): OpResult;
-    unsetMark(id: BlockId, offset: number, length: number, name: string): OpResult;
     clearMarks(id: BlockId, offset: number, length: number): OpResult;
-    insertInline(id: BlockId, offset: number, atom: InlineSpec): OpResult;
+    /** An atom without an id gets a fresh one. */
+    insertInline(id: BlockId, offset: number, atom: NewInline): OpResult;
     removeInline(id: BlockId, inlineId: string): OpResult;
-    setInlineData(id: BlockId, inlineId: string, data: Record<string, unknown>): OpResult;
     deleteRange(from: DocPosition, to: DocPosition, view?: RangeView): OpResult;
     replaceRange(from: DocPosition, to: DocPosition, view?: RangeView): OpResult;
     insertFlow(target: FlowTarget, flow: Flow, view?: FlowView): OpResult;
@@ -136,8 +127,8 @@ export interface DocumentReads {
 /**
  * The document's public operations: the writes, each also prepared
  * (`prepare.<op>(…)`, pure, then `apply(plan)`; `compose` joins plans),
- * the reads, a block's handle, `transact`, `onChange` and `version`. See
- * the document API reference.
+ * the reads, `transact`, `onChange` and `version`. See the document API
+ * reference.
  */
 export interface DocumentOperations extends DocumentWrites, DocumentReads {
     /** Every write, prepared: a plan of named steps and its effect, or `refused`. Writes nothing. */
@@ -150,12 +141,12 @@ export interface DocumentOperations extends DocumentWrites, DocumentReads {
     compose(...parts: Prepared[]): Prepared;
     /** Group writes in one transaction and one change event (no rollback on a throw). */
     transact<R>(fn: () => R, origin?: unknown): R;
-    /** A handle over block `id`: the same operations bound to it (cached; refused when absent). */
-    block(id: BlockId): DocBlock;
     /** Hear each transaction's change; answers the unsubscribe. */
     onChange(listener: (change: DocChange) => void): () => void;
     /** Changes on every write that changed the tree. */
     readonly version: number;
 }
+/** Every write of `DocumentWrites`: what a view dispatches under the same names (`edytor.insertBlocks(…)`). */
+export declare const DOCUMENT_WRITES: readonly ["insertBlocks", "moveBlocks", "nestBlock", "unNestBlock", "unNestBlocks", "liftOut", "wrapInLayout", "placeBeside", "splitBlock", "mergeBlocks", "mergeBackward", "mergeForward", "deleteBlock", "deleteBlocks", "setBlock", "setBlockType", "patchData", "duplicateBlock", "insertText", "deleteText", "formatRange", "clearMarks", "insertInline", "removeInline", "deleteRange", "replaceRange", "insertFlow"];
 /** Every name of `DocumentOperations`, for the document's own members (`EdytorDocument`). */
-export declare const DOCUMENT_OPERATIONS: readonly ["insertBlock", "insertBlocks", "moveBlock", "moveBlocks", "nestBlock", "unNestBlock", "unNestBlocks", "liftOut", "wrapInLayout", "placeBeside", "splitBlock", "mergeBlocks", "mergeBackward", "mergeForward", "deleteBlock", "deleteBlocks", "setBlock", "setBlockType", "patchData", "setBlockData", "duplicateBlock", "insertTableRow", "deleteTableRows", "insertTableColumn", "deleteTableColumn", "moveTableColumn", "moveTableRows", "fillTableCell", "insertText", "deleteText", "formatRange", "setMark", "unsetMark", "clearMarks", "insertInline", "removeInline", "setInlineData", "deleteRange", "replaceRange", "insertFlow", "toJSON", "docData", "dataItemIds", "project", "blockJSON", "childrenIds", "parentOf", "ancestorsOf", "positionOf", "pathOf", "blockTypeOf", "blockDataOf", "blockText", "contentItems", "displayLength", "runs", "hasBlock", "isVisibleBlock", "listBlockIds", "blockAttribution", "isVoid", "isIsland", "isLines", "islandOf", "insideIsland", "isLayout", "isLayoutItem", "besideAt", "isTable", "isTableRow", "isTableCell", "tableOf", "tableColumns", "tableGrid", "order", "compare", "next", "previous", "canPlace", "canMerge", "fits", "nestParent", "landingOf", "anchorAt", "resolveAnchor", "prepare", "apply", "compose", "transact", "block", "onChange", "version"];
+export declare const DOCUMENT_OPERATIONS: readonly ["insertBlocks", "moveBlocks", "nestBlock", "unNestBlock", "unNestBlocks", "liftOut", "wrapInLayout", "placeBeside", "splitBlock", "mergeBlocks", "mergeBackward", "mergeForward", "deleteBlock", "deleteBlocks", "setBlock", "setBlockType", "patchData", "duplicateBlock", "insertText", "deleteText", "formatRange", "clearMarks", "insertInline", "removeInline", "deleteRange", "replaceRange", "insertFlow", "toJSON", "docData", "dataItemIds", "dataPreview", "project", "blockJSON", "childrenIds", "parentOf", "ancestorsOf", "positionOf", "pathOf", "blockTypeOf", "blockDataOf", "blockText", "contentItems", "displayLength", "runs", "hasBlock", "isVisibleBlock", "listBlockIds", "blockAttribution", "isVoid", "isIsland", "isLines", "islandOf", "insideIsland", "isLayout", "isLayoutItem", "besideAt", "isTable", "isTableRow", "isTableCell", "tableOf", "tableColumns", "tableGrid", "order", "compare", "next", "previous", "canPlace", "canMerge", "fits", "nestParent", "landingOf", "anchorAt", "resolveAnchor", "prepare", "apply", "compose", "transact", "onChange", "version"];

package/dist/crdt/operations.js

@@ -1,8 +1,6 @@
-/** Every name of `DocumentOperations`, for the document's own members (`EdytorDocument`). */
-export const DOCUMENT_OPERATIONS = [
-    'insertBlock',
+/** Every write of `DocumentWrites`: what a view dispatches under the same names (`edytor.insertBlocks(…)`). */
+export const DOCUMENT_WRITES = [
     'insertBlocks',
-    'moveBlock',
     'moveBlocks',
     'nestBlock',
     'unNestBlock',
@@ -19,30 +17,24 @@ export const DOCUMENT_OPERATIONS = [
     'setBlock',
     'setBlockType',
     'patchData',
-    'setBlockData',
     'duplicateBlock',
-    'insertTableRow',
-    'deleteTableRows',
-    'insertTableColumn',
-    'deleteTableColumn',
-    'moveTableColumn',
-    'moveTableRows',
-    'fillTableCell',
     'insertText',
     'deleteText',
     'formatRange',
-    'setMark',
-    'unsetMark',
     'clearMarks',
     'insertInline',
     'removeInline',
-    'setInlineData',
     'deleteRange',
     'replaceRange',
-    'insertFlow',
+    'insertFlow'
+];
+/** Every name of `DocumentOperations`, for the document's own members (`EdytorDocument`). */
+export const DOCUMENT_OPERATIONS = [
+    ...DOCUMENT_WRITES,
     'toJSON',
     'docData',
     'dataItemIds',
+    'dataPreview',
     'project',
     'blockJSON',
     'childrenIds',
@@ -89,7 +81,6 @@ export const DOCUMENT_OPERATIONS = [
     'apply',
     'compose',
     'transact',
-    'block',
     'onChange',
     'version'
 ];

package/dist/crdt/placement/display.d.ts

@@ -33,8 +33,6 @@ export declare const textRanker: (blocks: ReadonlyMap<BlockId, BlockRec>, placem
     /** Drop what was decided for `home`'s text (every one, without it). */
     forget: (home?: BlockId) => void;
 };
-/** The inverse of `ownerOf` over `blocks`: each live owner → the blocks it displays. */
-export declare const displayIndex: (blocks: ReadonlyMap<BlockId, unknown>, ownerOf: (b: BlockId) => Owner) => Map<BlockId, BlockId[]>;
 /**
  * THE liveness answer: `id` carries no live delete mark, owns
  * itself (`own.hidden` covers both: a delete-marked or unknown block owns

package/dist/crdt/placement/display.js

@@ -139,21 +139,6 @@ export const textRanker = (blocks, placements, homeOf, inText) => {
         }
     };
 };
-/** The inverse of `ownerOf` over `blocks`: each live owner → the blocks it displays. */
-export const displayIndex = (blocks, ownerOf) => {
-    const by = new Map();
-    for (const b of blocks.keys()) {
-        const owner = ownerOf(b);
-        if (typeof owner !== 'string')
-            continue;
-        const list = by.get(owner);
-        if (list === undefined)
-            by.set(owner, [b]);
-        else
-            list.push(b);
-    }
-    return by;
-};
 /**
  * THE liveness answer: `id` carries no live delete mark, owns
  * itself (`own.hidden` covers both: a delete-marked or unknown block owns