edytor 4.0.0 → 6.0.0

package/dist/crdt/edytor-doc.d.ts

@@ -6,6 +6,7 @@ import { type RunView } from './text/runs.js';
 import { type BlockAttribution } from './attribution/block.js';
 import type { JSONBlock, JSONDoc } from '../utils/json.js';
 import { assertSchema, checkSchema, isInitialized, META_KEY, registryEmpty, SCHEMA_NAME, SCHEMA_VERSION, SchemaMismatchError, schemaVersion } from './doc/gate.js';
+import type { SuggestContext } from './doc/suggest.js';
 import type { EngineNode } from './engine-api.js';
 import type { ContentItem, InlineSpec, ModelView, SplitTail } from './placement/model.js';
 import type { Anchor } from './text/model.js';
@@ -49,24 +50,71 @@ type Layers = {
  */
 export declare const adoptRules: <D extends object>(doc: D) => D;
 export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (doc: EngineDoc, config?: EdytorDocConfig) => {
+    init: (opts?: Parameters<(doc: EngineDoc, opts?: {
+        content?: import("./index.js").BlockSpec[];
+        defaultType?: string;
+    }) => void>[1]) => void;
+    /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
+    seed: (value: JSONBlock[], data?: JsonObj) => void;
+    isInitialized: () => boolean;
+    /** Replicated `meta.v` schema version (the module-level read, bound). */
+    schemaVersion: () => number | undefined;
+    /**
+     * The schema gate for this doc — throws {@link SchemaMismatchError}
+     * on unversioned-content or unsupported-version state. Consumers
+     * (`Edytor.sync()`, packed consumers) call it before trusting
+     * a synced doc.
+     */
+    checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
+    assertSchema: () => void;
+    dispose: () => void;
+    createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+    /** @internal What a part built over the document reads and writes (`doc/suggest.ts`). */
+    part: SuggestContext;
+    /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
+    childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
+    slotOf: (id: string) => {
+        parent: BlockId | null;
+        rank: string;
+    } | null;
+    crdtId: (id: string) => string | null;
+    resolveBlock: (id: string) => EngineNode | null;
+    followUndo: (anchor: DocAnchor) => DocAnchor;
+    /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
+    rolesChanged: (place?: boolean) => void;
+    defaultChild: (id: string | null) => string;
+    contentJSON: (id: string) => ({
+        text: string;
+        marks?: Record<string, unknown>;
+    } | {
+        id?: string;
+        type: string;
+        data?: unknown;
+    })[];
+    model: L["model"];
+    text: L["text"];
+    runsView: RunView;
+    /** The public members' names (`EdytorDocument` forwards them). */
+    api: object;
+} & {
     /** Every op prepared: pure, a plan of named steps + its effect, or `refused`. */
     prepare: {
-        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
-        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
-        moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
         /**
          * Move `id` to the last position under `parent` — under a container
          * it is no item of, under its last item (`nestParent`: Tab after a list).
          */
         nestBlock: (id: BlockId, parent: BlockId) => Prepared;
-        unNestBlock: (id: BlockId) => Prepared;
+        /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
+        deleteBlocks: (ids: readonly BlockId[]) => Prepared;
+        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
+        moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
         unNestBlocks: (ids: readonly BlockId[]) => Prepared;
+        unNestBlock: (id: BlockId) => Prepared;
         liftOut: (id: BlockId, kind: string, { keep, after }?: {
             keep?: boolean;
             after?: readonly import("./index.js").BlockSpec[];
         }) => Prepared;
+        duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
         placeBeside: (ids: readonly BlockId[], target: BlockId, side: "left" | "right", kind?: string) => Prepared;
         wrapInLayout: (ids: readonly BlockId[], kind?: string, columns?: number) => Prepared;
         splitBlock: (id: BlockId, offset: number, newId: BlockId, tail?: SplitTail) => Prepared;
@@ -76,44 +124,40 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
         deleteBlock: (id: BlockId, opts?: {
             keepChildren?: boolean;
         }) => Prepared;
+        setBlockType: (id: BlockId, type: string) => Prepared;
+        patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
         setBlock: (id: BlockId, value: {
             type?: string;
             data?: Record<string, unknown>;
             content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
             children?: (import("./index.js").BlockSpec | JSONBlock)[];
         }) => Prepared;
-        setBlockType: (id: BlockId, type: string) => Prepared;
-        patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
-        duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
         insertText: (id: BlockId, offset: number, text: string, marks?: Record<string, unknown>) => Prepared;
         deleteText: (id: BlockId, offset: number, length: number) => Prepared;
         formatRange: (id: BlockId, offset: number, length: number, marks: Record<string, unknown>) => Prepared;
         clearMarks: (id: BlockId, offset: number, length: number) => Prepared;
-        insertInline: (id: BlockId, offset: number, atom: import("./doc/content.js").NewInline) => Prepared;
+        insertInline: (id: BlockId, offset: number, atom: import("./doc/ops.js").NewInline) => Prepared;
         removeInline: (id: BlockId, inlineId: string) => Prepared;
-        /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
-        deleteBlocks: (ids: readonly BlockId[]) => Prepared;
+        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
+        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
+        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
     };
     /** Write a prepared plan exactly (refusals pass through). */
-    apply: (p: Prepared) => OpResult;
+    apply: (p: Prepared, quiet?: boolean) => OpResult;
     compose: (...parts: Prepared[]) => Prepared;
     transact: <R>(fn: () => R, origin?: unknown) => R;
-    model: L["model"];
-    text: L["text"];
-    runsView: RunView;
     version: number;
-    insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
-    deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-    replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-    insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => OpResult;
-    moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
     nestBlock: (id: string, parent: string) => OpResult;
-    unNestBlock: (id: string) => OpResult;
+    deleteBlocks: (ids: readonly string[]) => OpResult;
+    insertBlocks: (dest: import("./index.js").Destination, specs: readonly (JSONBlock | import("./index.js").BlockSpec)[]) => OpResult;
+    moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
     unNestBlocks: (ids: readonly string[]) => OpResult;
+    unNestBlock: (id: string) => OpResult;
     liftOut: (id: string, kind: string, args_2?: {
         keep?: boolean;
         after?: readonly import("./index.js").BlockSpec[];
     } | undefined) => OpResult;
+    duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
     placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => OpResult;
     wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => OpResult;
     splitBlock: (id: string, offset: number, newId: string, tail?: SplitTail | undefined) => OpResult;
@@ -123,51 +167,29 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
     deleteBlock: (id: string, opts?: {
         keepChildren?: boolean;
     } | undefined) => OpResult;
+    setBlockType: (id: string, type: string) => OpResult;
+    patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
     setBlock: (id: string, value: {
         type?: string;
         data?: Record<string, unknown>;
         content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
         children?: (import("./index.js").BlockSpec | JSONBlock)[];
     }) => OpResult;
-    setBlockType: (id: string, type: string) => OpResult;
-    patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
-    duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
     insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => OpResult;
     deleteText: (id: string, offset: number, length: number) => OpResult;
     formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => OpResult;
     clearMarks: (id: string, offset: number, length: number) => OpResult;
-    insertInline: (id: string, offset: number, atom: import("./doc/content.js").NewInline) => OpResult;
+    insertInline: (id: string, offset: number, atom: import("./doc/ops.js").NewInline) => OpResult;
     removeInline: (id: string, inlineId: string) => OpResult;
-    deleteBlocks: (ids: readonly string[]) => OpResult;
-    init: (opts?: Parameters<(doc: EngineDoc, opts?: {
-        content?: import("./index.js").BlockSpec[];
-        defaultType?: string;
-    }) => void>[1]) => void;
-    /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
-    seed: (value: JSONBlock[], data?: JsonObj) => void;
-    isInitialized: () => boolean;
-    /** Replicated `meta.v` schema version (the module-level read, bound). */
-    schemaVersion: () => number | undefined;
-    /**
-     * The schema gate for this doc — throws {@link SchemaMismatchError}
-     * on unversioned-content or unsupported-version state. Consumers
-     * (`Edytor.sync()`, packed consumers) call it before trusting
-     * a synced doc.
-     */
-    checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
-    assertSchema: () => void;
-    dispose: () => void;
-    createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+    insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
+    deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
+    replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
     project: () => import("./index.js").ProjectedDoc;
-    toJSON: () => JSONDoc;
+    toJSON: (options?: {
+        suggestions?: boolean;
+    }) => JSONDoc;
     blockJSON: (id: string) => JSONBlock;
     childrenIds: (id: string | null) => string[];
-    /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
-    childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
-    slotOf: (id: string) => {
-        parent: BlockId | null;
-        rank: string;
-    } | null;
     positionOf: (id: string) => import("./index.js").Destination | null;
     pathOf: (id: string) => number[] | null;
     parentOf: (id: string) => string | null;
@@ -190,8 +212,6 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
      * O(1) per call; live-replicated (remote values read the same).
      */
     blockAttribution: (id: string) => BlockAttribution | undefined;
-    crdtId: (id: string) => string | null;
-    resolveBlock: (id: string) => EngineNode | null;
     displayLength: (id: string) => number;
     contentItems: (id: string) => ContentItem[];
     hasBlock: (id: string) => boolean;
@@ -205,9 +225,6 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
         blockId: BlockId;
         offset: number;
     } | null;
-    followUndo: (anchor: DocAnchor) => DocAnchor;
-    /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
-    rolesChanged: () => void;
     isVoid: (id: string) => boolean;
     isIsland: (id: string) => boolean;
     isLines: (id: string) => boolean;
@@ -254,16 +271,7 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
         parent: string | null;
         levels: string[];
     };
-    defaultChild: (id: string | null) => string;
     runs: (id: string) => readonly ContentRun[];
-    contentJSON: (id: string) => ({
-        text: string;
-        marks?: Record<string, unknown>;
-    } | {
-        id?: string;
-        type: string;
-        data?: unknown;
-    })[];
     onChange: (cb: (change: DocChange) => void) => (() => void);
 };
 /**
@@ -275,7 +283,7 @@ export declare const docFacade: <L extends Layers>(Y: EngineApi, layers: L) => (
 export declare const bindDocModel: (Y: EngineApi) => {
     /** The schema manifest constants table. */
     SCHEMA: {
-        readonly version: 10;
+        readonly version: 11;
         readonly name: "edytor-doc";
         readonly roots: {
             readonly registry: "blocks";
@@ -286,7 +294,7 @@ export declare const bindDocModel: (Y: EngineApi) => {
             readonly schema: "schema";
         };
     };
-    SCHEMA_VERSION: 10;
+    SCHEMA_VERSION: 11;
     SCHEMA_NAME: "edytor-doc";
     META_KEY: "meta";
     /** Doc-level API (no facade needed). */
@@ -304,55 +312,47 @@ export declare const bindDocModel: (Y: EngineApi) => {
     SchemaMismatchError: typeof SchemaMismatchError;
     /** Attach the per-doc facade. */
     create: (doc: EngineDoc, config?: EdytorDocConfig) => {
-        /** Every op prepared: pure, a plan of named steps + its effect, or `refused`. */
-        prepare: {
-            insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
-            deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-            replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
-            moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
-            /**
-             * Move `id` to the last position under `parent` — under a container
-             * it is no item of, under its last item (`nestParent`: Tab after a list).
-             */
-            nestBlock: (id: BlockId, parent: BlockId) => Prepared;
-            unNestBlock: (id: BlockId) => Prepared;
-            unNestBlocks: (ids: readonly BlockId[]) => Prepared;
-            liftOut: (id: BlockId, kind: string, { keep, after }?: {
-                keep?: boolean;
-                after?: readonly import("./index.js").BlockSpec[];
-            }) => Prepared;
-            placeBeside: (ids: readonly BlockId[], target: BlockId, side: "left" | "right", kind?: string) => Prepared;
-            wrapInLayout: (ids: readonly BlockId[], kind?: string, columns?: number) => Prepared;
-            splitBlock: (id: BlockId, offset: number, newId: BlockId, tail?: SplitTail) => Prepared;
-            mergeBlocks: (fromId: BlockId, intoId: BlockId) => Prepared;
-            mergeBackward: (id: BlockId) => Prepared;
-            mergeForward: (id: BlockId) => Prepared;
-            deleteBlock: (id: BlockId, opts?: {
-                keepChildren?: boolean;
-            }) => Prepared;
-            setBlock: (id: BlockId, value: {
-                type?: string;
-                data?: Record<string, unknown>;
-                content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
-                children?: (import("./index.js").BlockSpec | JSONBlock)[];
-            }) => Prepared;
-            setBlockType: (id: BlockId, type: string) => Prepared;
-            patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
-            duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
-            insertText: (id: BlockId, offset: number, text: string, marks?: Record<string, unknown>) => Prepared;
-            deleteText: (id: BlockId, offset: number, length: number) => Prepared;
-            formatRange: (id: BlockId, offset: number, length: number, marks: Record<string, unknown>) => Prepared;
-            clearMarks: (id: BlockId, offset: number, length: number) => Prepared;
-            insertInline: (id: BlockId, offset: number, atom: import("./doc/content.js").NewInline) => Prepared;
-            removeInline: (id: BlockId, inlineId: string) => Prepared;
-            /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
-            deleteBlocks: (ids: readonly BlockId[]) => Prepared;
-        };
-        /** Write a prepared plan exactly (refusals pass through). */
-        apply: (p: Prepared) => OpResult;
-        compose: (...parts: Prepared[]) => Prepared;
-        transact: <R>(fn: () => R, origin?: unknown) => R;
+        init: (opts?: Parameters<(doc: EngineDoc, opts?: {
+            content?: import("./index.js").BlockSpec[];
+            defaultType?: string;
+        }) => void>[1]) => void;
+        /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
+        seed: (value: JSONBlock[], data?: JsonObj) => void;
+        isInitialized: () => boolean;
+        /** Replicated `meta.v` schema version (the module-level read, bound). */
+        schemaVersion: () => number | undefined;
+        /**
+         * The schema gate for this doc — throws {@link SchemaMismatchError}
+         * on unversioned-content or unsupported-version state. Consumers
+         * (`Edytor.sync()`, packed consumers) call it before trusting
+         * a synced doc.
+         */
+        checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
+        assertSchema: () => void;
+        dispose: () => void;
+        createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+        /** @internal What a part built over the document reads and writes (`doc/suggest.ts`). */
+        part: SuggestContext;
+        /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
+        childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
+        slotOf: (id: string) => {
+            parent: BlockId | null;
+            rank: string;
+        } | null;
+        crdtId: (id: string) => string | null;
+        resolveBlock: (id: string) => EngineNode | null;
+        followUndo: (anchor: DocAnchor) => DocAnchor;
+        /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
+        rolesChanged: (place?: boolean) => void;
+        defaultChild: (id: string | null) => string;
+        contentJSON: (id: string) => ({
+            text: string;
+            marks?: Record<string, unknown>;
+        } | {
+            id?: string;
+            type: string;
+            data?: unknown;
+        })[];
         model: {
             REGISTRY_KEY: string;
             registryOf: (doc: EngineDoc) => EngineNode;
@@ -422,19 +422,70 @@ export declare const bindDocModel: (Y: EngineApi) => {
             };
         };
         runsView: RunView;
+        /** The public members' names (`EdytorDocument` forwards them). */
+        api: object;
+    } & {
+        /** Every op prepared: pure, a plan of named steps + its effect, or `refused`. */
+        prepare: {
+            /**
+             * Move `id` to the last position under `parent` — under a container
+             * it is no item of, under its last item (`nestParent`: Tab after a list).
+             */
+            nestBlock: (id: BlockId, parent: BlockId) => Prepared;
+            /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
+            deleteBlocks: (ids: readonly BlockId[]) => Prepared;
+            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
+            moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
+            unNestBlocks: (ids: readonly BlockId[]) => Prepared;
+            unNestBlock: (id: BlockId) => Prepared;
+            liftOut: (id: BlockId, kind: string, { keep, after }?: {
+                keep?: boolean;
+                after?: readonly import("./index.js").BlockSpec[];
+            }) => Prepared;
+            duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
+            placeBeside: (ids: readonly BlockId[], target: BlockId, side: "left" | "right", kind?: string) => Prepared;
+            wrapInLayout: (ids: readonly BlockId[], kind?: string, columns?: number) => Prepared;
+            splitBlock: (id: BlockId, offset: number, newId: BlockId, tail?: SplitTail) => Prepared;
+            mergeBlocks: (fromId: BlockId, intoId: BlockId) => Prepared;
+            mergeBackward: (id: BlockId) => Prepared;
+            mergeForward: (id: BlockId) => Prepared;
+            deleteBlock: (id: BlockId, opts?: {
+                keepChildren?: boolean;
+            }) => Prepared;
+            setBlockType: (id: BlockId, type: string) => Prepared;
+            patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
+            setBlock: (id: BlockId, value: {
+                type?: string;
+                data?: Record<string, unknown>;
+                content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
+                children?: (import("./index.js").BlockSpec | JSONBlock)[];
+            }) => Prepared;
+            insertText: (id: BlockId, offset: number, text: string, marks?: Record<string, unknown>) => Prepared;
+            deleteText: (id: BlockId, offset: number, length: number) => Prepared;
+            formatRange: (id: BlockId, offset: number, length: number, marks: Record<string, unknown>) => Prepared;
+            clearMarks: (id: BlockId, offset: number, length: number) => Prepared;
+            insertInline: (id: BlockId, offset: number, atom: import("./doc/ops.js").NewInline) => Prepared;
+            removeInline: (id: BlockId, inlineId: string) => Prepared;
+            insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
+            deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
+            replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
+        };
+        /** Write a prepared plan exactly (refusals pass through). */
+        apply: (p: Prepared, quiet?: boolean) => OpResult;
+        compose: (...parts: Prepared[]) => Prepared;
+        transact: <R>(fn: () => R, origin?: unknown) => R;
         version: number;
-        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
-        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => OpResult;
-        moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
         nestBlock: (id: string, parent: string) => OpResult;
-        unNestBlock: (id: string) => OpResult;
+        deleteBlocks: (ids: readonly string[]) => OpResult;
+        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (JSONBlock | import("./index.js").BlockSpec)[]) => OpResult;
+        moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
         unNestBlocks: (ids: readonly string[]) => OpResult;
+        unNestBlock: (id: string) => OpResult;
         liftOut: (id: string, kind: string, args_2?: {
             keep?: boolean;
             after?: readonly import("./index.js").BlockSpec[];
         } | undefined) => OpResult;
+        duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
         placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => OpResult;
         wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => OpResult;
         splitBlock: (id: string, offset: number, newId: string, tail?: SplitTail | undefined) => OpResult;
@@ -444,51 +495,29 @@ export declare const bindDocModel: (Y: EngineApi) => {
         deleteBlock: (id: string, opts?: {
             keepChildren?: boolean;
         } | undefined) => OpResult;
+        setBlockType: (id: string, type: string) => OpResult;
+        patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
         setBlock: (id: string, value: {
             type?: string;
             data?: Record<string, unknown>;
             content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
             children?: (import("./index.js").BlockSpec | JSONBlock)[];
         }) => OpResult;
-        setBlockType: (id: string, type: string) => OpResult;
-        patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
-        duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
         insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => OpResult;
         deleteText: (id: string, offset: number, length: number) => OpResult;
         formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => OpResult;
         clearMarks: (id: string, offset: number, length: number) => OpResult;
-        insertInline: (id: string, offset: number, atom: import("./doc/content.js").NewInline) => OpResult;
+        insertInline: (id: string, offset: number, atom: import("./doc/ops.js").NewInline) => OpResult;
         removeInline: (id: string, inlineId: string) => OpResult;
-        deleteBlocks: (ids: readonly string[]) => OpResult;
-        init: (opts?: Parameters<(doc: EngineDoc, opts?: {
-            content?: import("./index.js").BlockSpec[];
-            defaultType?: string;
-        }) => void>[1]) => void;
-        /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
-        seed: (value: JSONBlock[], data?: JsonObj) => void;
-        isInitialized: () => boolean;
-        /** Replicated `meta.v` schema version (the module-level read, bound). */
-        schemaVersion: () => number | undefined;
-        /**
-         * The schema gate for this doc — throws {@link SchemaMismatchError}
-         * on unversioned-content or unsupported-version state. Consumers
-         * (`Edytor.sync()`, packed consumers) call it before trusting
-         * a synced doc.
-         */
-        checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
-        assertSchema: () => void;
-        dispose: () => void;
-        createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
+        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
+        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
         project: () => import("./index.js").ProjectedDoc;
-        toJSON: () => JSONDoc;
+        toJSON: (options?: {
+            suggestions?: boolean;
+        } | undefined) => JSONDoc;
         blockJSON: (id: string) => JSONBlock;
         childrenIds: (id: string | null) => string[];
-        /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
-        childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
-        slotOf: (id: string) => {
-            parent: BlockId | null;
-            rank: string;
-        } | null;
         positionOf: (id: string) => import("./index.js").Destination | null;
         pathOf: (id: string) => number[] | null;
         parentOf: (id: string) => string | null;
@@ -511,8 +540,6 @@ export declare const bindDocModel: (Y: EngineApi) => {
          * O(1) per call; live-replicated (remote values read the same).
          */
         blockAttribution: (id: string) => BlockAttribution | undefined;
-        crdtId: (id: string) => string | null;
-        resolveBlock: (id: string) => EngineNode | null;
         displayLength: (id: string) => number;
         contentItems: (id: string) => ContentItem[];
         hasBlock: (id: string) => boolean;
@@ -526,9 +553,6 @@ export declare const bindDocModel: (Y: EngineApi) => {
             blockId: BlockId;
             offset: number;
         } | null;
-        followUndo: (anchor: DocAnchor) => DocAnchor;
-        /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
-        rolesChanged: () => void;
         isVoid: (id: string) => boolean;
         isIsland: (id: string) => boolean;
         isLines: (id: string) => boolean;
@@ -575,16 +599,7 @@ export declare const bindDocModel: (Y: EngineApi) => {
             parent: string | null;
             levels: string[];
         };
-        defaultChild: (id: string | null) => string;
         runs: (id: string) => readonly ContentRun[];
-        contentJSON: (id: string) => ({
-            text: string;
-            marks?: Record<string, unknown>;
-        } | {
-            id?: string;
-            type: string;
-            data?: unknown;
-        })[];
         onChange: (cb: (change: DocChange) => void) => (() => void);
     };
     /**
@@ -675,7 +690,7 @@ export declare const bindDocModel: (Y: EngineApi) => {
 export declare const bindEdytorDoc: (Y: EngineApi) => {
     /** The schema manifest constants table. */
     SCHEMA: {
-        readonly version: 10;
+        readonly version: 11;
         readonly name: "edytor-doc";
         readonly roots: {
             readonly registry: "blocks";
@@ -686,7 +701,7 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
             readonly schema: "schema";
         };
     };
-    SCHEMA_VERSION: 10;
+    SCHEMA_VERSION: 11;
     SCHEMA_NAME: "edytor-doc";
     META_KEY: "meta";
     /** Doc-level API (no facade needed). */
@@ -704,55 +719,47 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
     SchemaMismatchError: typeof SchemaMismatchError;
     /** Attach the per-doc facade. */
     create: (doc: EngineDoc, config?: EdytorDocConfig) => {
-        /** Every op prepared: pure, a plan of named steps + its effect, or `refused`. */
-        prepare: {
-            insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
-            deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-            replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
-            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
-            moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
-            /**
-             * Move `id` to the last position under `parent` — under a container
-             * it is no item of, under its last item (`nestParent`: Tab after a list).
-             */
-            nestBlock: (id: BlockId, parent: BlockId) => Prepared;
-            unNestBlock: (id: BlockId) => Prepared;
-            unNestBlocks: (ids: readonly BlockId[]) => Prepared;
-            liftOut: (id: BlockId, kind: string, { keep, after }?: {
-                keep?: boolean;
-                after?: readonly import("./index.js").BlockSpec[];
-            }) => Prepared;
-            placeBeside: (ids: readonly BlockId[], target: BlockId, side: "left" | "right", kind?: string) => Prepared;
-            wrapInLayout: (ids: readonly BlockId[], kind?: string, columns?: number) => Prepared;
-            splitBlock: (id: BlockId, offset: number, newId: BlockId, tail?: SplitTail) => Prepared;
-            mergeBlocks: (fromId: BlockId, intoId: BlockId) => Prepared;
-            mergeBackward: (id: BlockId) => Prepared;
-            mergeForward: (id: BlockId) => Prepared;
-            deleteBlock: (id: BlockId, opts?: {
-                keepChildren?: boolean;
-            }) => Prepared;
-            setBlock: (id: BlockId, value: {
-                type?: string;
-                data?: Record<string, unknown>;
-                content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
-                children?: (import("./index.js").BlockSpec | JSONBlock)[];
-            }) => Prepared;
-            setBlockType: (id: BlockId, type: string) => Prepared;
-            patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
-            duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
-            insertText: (id: BlockId, offset: number, text: string, marks?: Record<string, unknown>) => Prepared;
-            deleteText: (id: BlockId, offset: number, length: number) => Prepared;
-            formatRange: (id: BlockId, offset: number, length: number, marks: Record<string, unknown>) => Prepared;
-            clearMarks: (id: BlockId, offset: number, length: number) => Prepared;
-            insertInline: (id: BlockId, offset: number, atom: import("./doc/content.js").NewInline) => Prepared;
-            removeInline: (id: BlockId, inlineId: string) => Prepared;
-            /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
-            deleteBlocks: (ids: readonly BlockId[]) => Prepared;
-        };
-        /** Write a prepared plan exactly (refusals pass through). */
-        apply: (p: Prepared) => OpResult;
-        compose: (...parts: Prepared[]) => Prepared;
-        transact: <R>(fn: () => R, origin?: unknown) => R;
+        init: (opts?: Parameters<(doc: EngineDoc, opts?: {
+            content?: import("./index.js").BlockSpec[];
+            defaultType?: string;
+        }) => void>[1]) => void;
+        /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
+        seed: (value: JSONBlock[], data?: JsonObj) => void;
+        isInitialized: () => boolean;
+        /** Replicated `meta.v` schema version (the module-level read, bound). */
+        schemaVersion: () => number | undefined;
+        /**
+         * The schema gate for this doc — throws {@link SchemaMismatchError}
+         * on unversioned-content or unsupported-version state. Consumers
+         * (`Edytor.sync()`, packed consumers) call it before trusting
+         * a synced doc.
+         */
+        checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
+        assertSchema: () => void;
+        dispose: () => void;
+        createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+        /** @internal What a part built over the document reads and writes (`doc/suggest.ts`). */
+        part: SuggestContext;
+        /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
+        childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
+        slotOf: (id: string) => {
+            parent: BlockId | null;
+            rank: string;
+        } | null;
+        crdtId: (id: string) => string | null;
+        resolveBlock: (id: string) => EngineNode | null;
+        followUndo: (anchor: DocAnchor) => DocAnchor;
+        /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
+        rolesChanged: (place?: boolean) => void;
+        defaultChild: (id: string | null) => string;
+        contentJSON: (id: string) => ({
+            text: string;
+            marks?: Record<string, unknown>;
+        } | {
+            id?: string;
+            type: string;
+            data?: unknown;
+        })[];
         model: {
             REGISTRY_KEY: string;
             registryOf: (doc: EngineDoc) => EngineNode;
@@ -822,19 +829,70 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
             };
         };
         runsView: RunView;
+        /** The public members' names (`EdytorDocument` forwards them). */
+        api: object;
+    } & {
+        /** Every op prepared: pure, a plan of named steps + its effect, or `refused`. */
+        prepare: {
+            /**
+             * Move `id` to the last position under `parent` — under a container
+             * it is no item of, under its last item (`nestParent`: Tab after a list).
+             */
+            nestBlock: (id: BlockId, parent: BlockId) => Prepared;
+            /** Delete a block selection — one plan; only the members leave (`deleteBlocks` above). */
+            deleteBlocks: (ids: readonly BlockId[]) => Prepared;
+            insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => Prepared;
+            moveBlocks: (ids: readonly BlockId[], dest: import("./index.js").Destination) => Prepared;
+            unNestBlocks: (ids: readonly BlockId[]) => Prepared;
+            unNestBlock: (id: BlockId) => Prepared;
+            liftOut: (id: BlockId, kind: string, { keep, after }?: {
+                keep?: boolean;
+                after?: readonly import("./index.js").BlockSpec[];
+            }) => Prepared;
+            duplicateBlock: (id: BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => Prepared;
+            placeBeside: (ids: readonly BlockId[], target: BlockId, side: "left" | "right", kind?: string) => Prepared;
+            wrapInLayout: (ids: readonly BlockId[], kind?: string, columns?: number) => Prepared;
+            splitBlock: (id: BlockId, offset: number, newId: BlockId, tail?: SplitTail) => Prepared;
+            mergeBlocks: (fromId: BlockId, intoId: BlockId) => Prepared;
+            mergeBackward: (id: BlockId) => Prepared;
+            mergeForward: (id: BlockId) => Prepared;
+            deleteBlock: (id: BlockId, opts?: {
+                keepChildren?: boolean;
+            }) => Prepared;
+            setBlockType: (id: BlockId, type: string) => Prepared;
+            patchData: (target: DataTarget, patches: readonly DataPatch[]) => Prepared;
+            setBlock: (id: BlockId, value: {
+                type?: string;
+                data?: Record<string, unknown>;
+                content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
+                children?: (import("./index.js").BlockSpec | JSONBlock)[];
+            }) => Prepared;
+            insertText: (id: BlockId, offset: number, text: string, marks?: Record<string, unknown>) => Prepared;
+            deleteText: (id: BlockId, offset: number, length: number) => Prepared;
+            formatRange: (id: BlockId, offset: number, length: number, marks: Record<string, unknown>) => Prepared;
+            clearMarks: (id: BlockId, offset: number, length: number) => Prepared;
+            insertInline: (id: BlockId, offset: number, atom: import("./doc/ops.js").NewInline) => Prepared;
+            removeInline: (id: BlockId, inlineId: string) => Prepared;
+            insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView) => Prepared;
+            deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
+            replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView) => Prepared;
+        };
+        /** Write a prepared plan exactly (refusals pass through). */
+        apply: (p: Prepared, quiet?: boolean) => OpResult;
+        compose: (...parts: Prepared[]) => Prepared;
+        transact: <R>(fn: () => R, origin?: unknown) => R;
         version: number;
-        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
-        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
-        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (import("./index.js").BlockSpec | JSONBlock)[]) => OpResult;
-        moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
         nestBlock: (id: string, parent: string) => OpResult;
-        unNestBlock: (id: string) => OpResult;
+        deleteBlocks: (ids: readonly string[]) => OpResult;
+        insertBlocks: (dest: import("./index.js").Destination, specs: readonly (JSONBlock | import("./index.js").BlockSpec)[]) => OpResult;
+        moveBlocks: (ids: readonly string[], dest: import("./index.js").Destination) => OpResult;
         unNestBlocks: (ids: readonly string[]) => OpResult;
+        unNestBlock: (id: string) => OpResult;
         liftOut: (id: string, kind: string, args_2?: {
             keep?: boolean;
             after?: readonly import("./index.js").BlockSpec[];
         } | undefined) => OpResult;
+        duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
         placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => OpResult;
         wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => OpResult;
         splitBlock: (id: string, offset: number, newId: string, tail?: SplitTail | undefined) => OpResult;
@@ -844,51 +902,29 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
         deleteBlock: (id: string, opts?: {
             keepChildren?: boolean;
         } | undefined) => OpResult;
+        setBlockType: (id: string, type: string) => OpResult;
+        patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
         setBlock: (id: string, value: {
             type?: string;
             data?: Record<string, unknown>;
             content?: (ContentItem | import("./index.js").JSONText | import("./index.js").JSONInlineBlock)[];
             children?: (import("./index.js").BlockSpec | JSONBlock)[];
         }) => OpResult;
-        setBlockType: (id: string, type: string) => OpResult;
-        patchData: (target: DataTarget, patches: readonly DataPatch[]) => OpResult;
-        duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => OpResult;
         insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => OpResult;
         deleteText: (id: string, offset: number, length: number) => OpResult;
         formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => OpResult;
         clearMarks: (id: string, offset: number, length: number) => OpResult;
-        insertInline: (id: string, offset: number, atom: import("./doc/content.js").NewInline) => OpResult;
+        insertInline: (id: string, offset: number, atom: import("./doc/ops.js").NewInline) => OpResult;
         removeInline: (id: string, inlineId: string) => OpResult;
-        deleteBlocks: (ids: readonly string[]) => OpResult;
-        init: (opts?: Parameters<(doc: EngineDoc, opts?: {
-            content?: import("./index.js").BlockSpec[];
-            defaultType?: string;
-        }) => void>[1]) => void;
-        /** Apply the deterministic seed of `value` and the document's `data` — the document's seed decision. */
-        seed: (value: JSONBlock[], data?: JsonObj) => void;
-        isInitialized: () => boolean;
-        /** Replicated `meta.v` schema version (the module-level read, bound). */
-        schemaVersion: () => number | undefined;
-        /**
-         * The schema gate for this doc — throws {@link SchemaMismatchError}
-         * on unversioned-content or unsupported-version state. Consumers
-         * (`Edytor.sync()`, packed consumers) call it before trusting
-         * a synced doc.
-         */
-        checkSchema: () => import("./edytor-doc.js").SchemaProblem | null;
-        assertSchema: () => void;
-        dispose: () => void;
-        createUndoManager: (options?: import("./doc/history.js").HistoryOptions) => import("./doc/history.js").UndoManager;
+        insertFlow: (target: import("./flow.js").FlowTarget, flow: import("./flow.js").Flow, view?: import("./flow.js").FlowView | undefined) => OpResult;
+        deleteRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
+        replaceRange: (from: DocPosition, to: DocPosition, view?: import("./rangeDelete.js").RangeView | undefined) => OpResult;
         project: () => import("./index.js").ProjectedDoc;
-        toJSON: () => JSONDoc;
+        toJSON: (options?: {
+            suggestions?: boolean;
+        } | undefined) => JSONDoc;
         blockJSON: (id: string) => JSONBlock;
         childrenIds: (id: string | null) => string[];
-        /** Visible children of `parent` with their ranks, in `(rank, id)` order. */
-        childSlots: (parent: BlockId | null) => import("./placement/model.js").ChildSlot[];
-        slotOf: (id: string) => {
-            parent: BlockId | null;
-            rank: string;
-        } | null;
         positionOf: (id: string) => import("./index.js").Destination | null;
         pathOf: (id: string) => number[] | null;
         parentOf: (id: string) => string | null;
@@ -911,8 +947,6 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
          * O(1) per call; live-replicated (remote values read the same).
          */
         blockAttribution: (id: string) => BlockAttribution | undefined;
-        crdtId: (id: string) => string | null;
-        resolveBlock: (id: string) => EngineNode | null;
         displayLength: (id: string) => number;
         contentItems: (id: string) => ContentItem[];
         hasBlock: (id: string) => boolean;
@@ -926,9 +960,6 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
             blockId: BlockId;
             offset: number;
         } | null;
-        followUndo: (anchor: DocAnchor) => DocAnchor;
-        /** Re-read the roles after `roleOf` answers differently (roles adopted later). */
-        rolesChanged: () => void;
         isVoid: (id: string) => boolean;
         isIsland: (id: string) => boolean;
         isLines: (id: string) => boolean;
@@ -975,16 +1006,7 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
             parent: string | null;
             levels: string[];
         };
-        defaultChild: (id: string | null) => string;
         runs: (id: string) => readonly ContentRun[];
-        contentJSON: (id: string) => ({
-            text: string;
-            marks?: Record<string, unknown>;
-        } | {
-            id?: string;
-            type: string;
-            data?: unknown;
-        })[];
         onChange: (cb: (change: DocChange) => void) => (() => void);
     };
     /**
@@ -1000,7 +1022,7 @@ export declare const bindEdytorDoc: (Y: EngineApi) => {
      * and the horizon record every history reads (`hist.purge.horizon`).
      * The room's purge task runs it; `facade` is a facade over `doc`.
      */
-    purge: (doc: EngineDoc, facade: {
+    purge: (doc: EngineDoc, facade: Partial<import("./doc/suggest.js").SuggestFacade> & {
         model: import("./placement/model.js").PlacementModel;
         text: import("./text/model.js").TextEngine;
     }, horizon: import("./purge.js").Horizon | null) => import("./purge.js").PurgeReport;