edytor 5.0.0 → 6.0.0

package/README.md

@@ -17,7 +17,7 @@
 
 Edytor aims to be for Svelte what Slate.js is for React: a heavily customizable editor with an API to build any kind of collaborative rich text editor.
 
-> **5.0.** Edytor `5.0.0` is on npm as `edytor`: its API follows semantic versioning, and every change is listed in the changelog. It has no production track record yet: read the [limitations](https://edytor.dev/docs/reference/limitations) before you build on it. Issues and PRs are welcome: when you report a bug, include the document's JSON value.
+> **6.0.** Edytor `6.0.0` is on npm as `edytor`: its API follows semantic versioning, and every change is listed in the changelog. It has no production track record yet: read the [limitations](https://edytor.dev/docs/reference/limitations) before you build on it. Issues and PRs are welcome: when you report a bug, include the document's JSON value.
 
 ## Features
 
@@ -40,7 +40,7 @@ Edytor aims to be for Svelte what Slate.js is for React: a heavily customizable
 
 ## Install
 
-Edytor `5.0.0` is on npm under `latest`:
+Edytor `6.0.0` is on npm under `latest`:
 
 ```bash
 pnpm add edytor

package/dist/cloudflare/room/context.d.ts

@@ -157,34 +157,8 @@ export declare const crdt: {
             api: object;
         } & {
             prepare: {
-                insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView) => import("../../index.js").Prepared;
-                deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
-                replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
                 nestBlock: (id: import("../../index.js").BlockId, parent: import("../../index.js").BlockId) => import("../../index.js").Prepared;
                 deleteBlocks: (ids: readonly import("../../index.js").BlockId[]) => import("../../index.js").Prepared;
-                insertText: (id: import("../../index.js").BlockId, offset: number, text: string, marks?: Record<string, unknown>) => import("../../index.js").Prepared;
-                deleteText: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
-                formatRange: (id: import("../../index.js").BlockId, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").Prepared;
-                clearMarks: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
-                insertInline: (id: import("../../index.js").BlockId, offset: number, atom: import("../../crdt/doc/content.js").NewInline) => import("../../index.js").Prepared;
-                removeInline: (id: import("../../index.js").BlockId, inlineId: string) => import("../../index.js").Prepared;
-                setBlockType: (id: import("../../index.js").BlockId, type: string) => import("../../index.js").Prepared;
-                patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").Prepared;
-                setBlock: (id: import("../../index.js").BlockId, value: {
-                    type?: string;
-                    data?: Record<string, unknown>;
-                    content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
-                    children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
-                }) => import("../../index.js").Prepared;
-                deleteBlock: (id: import("../../index.js").BlockId, opts?: {
-                    keepChildren?: boolean;
-                }) => import("../../index.js").Prepared;
-                splitBlock: (id: import("../../index.js").BlockId, offset: number, newId: import("../../index.js").BlockId, tail?: import("../../index.js").SplitTail) => import("../../index.js").Prepared;
-                mergeBlocks: (fromId: import("../../index.js").BlockId, intoId: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                mergeBackward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                mergeForward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
-                placeBeside: (ids: readonly import("../../index.js").BlockId[], target: import("../../index.js").BlockId, side: "left" | "right", kind?: string) => import("../../index.js").Prepared;
-                wrapInLayout: (ids: readonly import("../../index.js").BlockId[], kind?: string, columns?: number) => import("../../index.js").Prepared;
                 insertBlocks: (dest: import("../../index.js").Destination, specs: readonly (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[]) => import("../../index.js").Prepared;
                 moveBlocks: (ids: readonly import("../../index.js").BlockId[], dest: import("../../index.js").Destination) => import("../../index.js").Prepared;
                 unNestBlocks: (ids: readonly import("../../index.js").BlockId[]) => import("../../index.js").Prepared;
@@ -194,39 +168,39 @@ export declare const crdt: {
                     after?: readonly import("../../index.js").BlockSpec[];
                 }) => import("../../index.js").Prepared;
                 duplicateBlock: (id: import("../../index.js").BlockId, freshId?: (oldId: string, kind: "block" | "inline") => string) => import("../../index.js").Prepared;
+                placeBeside: (ids: readonly import("../../index.js").BlockId[], target: import("../../index.js").BlockId, side: "left" | "right", kind?: string) => import("../../index.js").Prepared;
+                wrapInLayout: (ids: readonly import("../../index.js").BlockId[], kind?: string, columns?: number) => import("../../index.js").Prepared;
+                splitBlock: (id: import("../../index.js").BlockId, offset: number, newId: import("../../index.js").BlockId, tail?: import("../../index.js").SplitTail) => import("../../index.js").Prepared;
+                mergeBlocks: (fromId: import("../../index.js").BlockId, intoId: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                mergeBackward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                mergeForward: (id: import("../../index.js").BlockId) => import("../../index.js").Prepared;
+                deleteBlock: (id: import("../../index.js").BlockId, opts?: {
+                    keepChildren?: boolean;
+                }) => import("../../index.js").Prepared;
+                setBlockType: (id: import("../../index.js").BlockId, type: string) => import("../../index.js").Prepared;
+                patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").Prepared;
+                setBlock: (id: import("../../index.js").BlockId, value: {
+                    type?: string;
+                    data?: Record<string, unknown>;
+                    content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
+                    children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
+                }) => import("../../index.js").Prepared;
+                insertText: (id: import("../../index.js").BlockId, offset: number, text: string, marks?: Record<string, unknown>) => import("../../index.js").Prepared;
+                deleteText: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
+                formatRange: (id: import("../../index.js").BlockId, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").Prepared;
+                clearMarks: (id: import("../../index.js").BlockId, offset: number, length: number) => import("../../index.js").Prepared;
+                insertInline: (id: import("../../index.js").BlockId, offset: number, atom: import("../../crdt/doc/ops.js").NewInline) => import("../../index.js").Prepared;
+                removeInline: (id: import("../../index.js").BlockId, inlineId: string) => import("../../index.js").Prepared;
+                insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView) => import("../../index.js").Prepared;
+                deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
+                replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView) => import("../../index.js").Prepared;
             };
             apply: (p: import("../../index.js").Prepared, quiet?: boolean) => import("../../index.js").OpResult;
             compose: (...parts: import("../../index.js").Prepared[]) => import("../../index.js").Prepared;
             transact: <R>(fn: () => R, origin?: unknown) => R;
             version: number;
-            insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView | undefined) => import("../../index.js").OpResult;
-            deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
-            replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
             nestBlock: (id: string, parent: string) => import("../../index.js").OpResult;
             deleteBlocks: (ids: readonly string[]) => import("../../index.js").OpResult;
-            insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => import("../../index.js").OpResult;
-            deleteText: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
-            formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").OpResult;
-            clearMarks: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
-            insertInline: (id: string, offset: number, atom: import("../../crdt/doc/content.js").NewInline) => import("../../index.js").OpResult;
-            removeInline: (id: string, inlineId: string) => import("../../index.js").OpResult;
-            setBlockType: (id: string, type: string) => import("../../index.js").OpResult;
-            patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").OpResult;
-            setBlock: (id: string, value: {
-                type?: string;
-                data?: Record<string, unknown>;
-                content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
-                children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
-            }) => import("../../index.js").OpResult;
-            deleteBlock: (id: string, opts?: {
-                keepChildren?: boolean;
-            } | undefined) => import("../../index.js").OpResult;
-            splitBlock: (id: string, offset: number, newId: string, tail?: import("../../index.js").SplitTail | undefined) => import("../../index.js").OpResult;
-            mergeBlocks: (fromId: string, intoId: string) => import("../../index.js").OpResult;
-            mergeBackward: (id: string) => import("../../index.js").OpResult;
-            mergeForward: (id: string) => import("../../index.js").OpResult;
-            placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => import("../../index.js").OpResult;
-            wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => import("../../index.js").OpResult;
             insertBlocks: (dest: import("../../index.js").Destination, specs: readonly (import("../../index.js").JSONBlock | import("../../index.js").BlockSpec)[]) => import("../../index.js").OpResult;
             moveBlocks: (ids: readonly string[], dest: import("../../index.js").Destination) => import("../../index.js").OpResult;
             unNestBlocks: (ids: readonly string[]) => import("../../index.js").OpResult;
@@ -236,6 +210,32 @@ export declare const crdt: {
                 after?: readonly import("../../index.js").BlockSpec[];
             } | undefined) => import("../../index.js").OpResult;
             duplicateBlock: (id: string, freshId?: ((oldId: string, kind: "block" | "inline") => string) | undefined) => import("../../index.js").OpResult;
+            placeBeside: (ids: readonly string[], target: string, side: "left" | "right", kind?: string | undefined) => import("../../index.js").OpResult;
+            wrapInLayout: (ids: readonly string[], kind?: string | undefined, columns?: number | undefined) => import("../../index.js").OpResult;
+            splitBlock: (id: string, offset: number, newId: string, tail?: import("../../index.js").SplitTail | undefined) => import("../../index.js").OpResult;
+            mergeBlocks: (fromId: string, intoId: string) => import("../../index.js").OpResult;
+            mergeBackward: (id: string) => import("../../index.js").OpResult;
+            mergeForward: (id: string) => import("../../index.js").OpResult;
+            deleteBlock: (id: string, opts?: {
+                keepChildren?: boolean;
+            } | undefined) => import("../../index.js").OpResult;
+            setBlockType: (id: string, type: string) => import("../../index.js").OpResult;
+            patchData: (target: import("../../index.js").DataTarget, patches: readonly import("../../index.js").DataPatch[]) => import("../../index.js").OpResult;
+            setBlock: (id: string, value: {
+                type?: string;
+                data?: Record<string, unknown>;
+                content?: (import("../../index.js").ContentItem | import("../../index.js").JSONText | import("../../index.js").JSONInlineBlock)[];
+                children?: (import("../../index.js").BlockSpec | import("../../index.js").JSONBlock)[];
+            }) => import("../../index.js").OpResult;
+            insertText: (id: string, offset: number, text: string, marks?: Record<string, unknown> | undefined) => import("../../index.js").OpResult;
+            deleteText: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
+            formatRange: (id: string, offset: number, length: number, marks: Record<string, unknown>) => import("../../index.js").OpResult;
+            clearMarks: (id: string, offset: number, length: number) => import("../../index.js").OpResult;
+            insertInline: (id: string, offset: number, atom: import("../../crdt/doc/ops.js").NewInline) => import("../../index.js").OpResult;
+            removeInline: (id: string, inlineId: string) => import("../../index.js").OpResult;
+            insertFlow: (target: import("../../index.js").FlowTarget, flow: import("../../index.js").Flow, view?: import("../../index.js").FlowView | undefined) => import("../../index.js").OpResult;
+            deleteRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
+            replaceRange: (from: import("../../index.js").DocPosition, to: import("../../index.js").DocPosition, view?: import("../../index.js").RangeView | undefined) => import("../../index.js").OpResult;
             project: () => import("../../index.js").ProjectedDoc;
             toJSON: (options?: {
                 suggestions?: boolean;
@@ -407,17 +407,12 @@ export declare const crdt: {
                 loadError: unknown;
                 _storeTimeout: number;
                 _storeTimeoutId: ReturnType<typeof setTimeout> | null;
-                _storeUpdate: (update: Uint8Array, origin: unknown) => void;
+                _unlisten: () => void;
                 awareness: import("../../index.js").Awareness;
                 bcconnected: boolean;
                 disableBc: boolean;
                 _ownsAwareness: boolean;
                 _bcSubscriber: (data: ArrayBuffer | Uint8Array, origin: unknown) => void;
-                _awarenessUpdateHandler: (updates: {
-                    added: number[];
-                    updated: number[];
-                    removed: number[];
-                }, origin: unknown) => void;
                 get synced(): boolean;
                 messageHandlers: Record<number, import("../../crdt/providers/room.js").RoomMessageHandler</*elided*/ any>>;
                 readMessage: (buf: Uint8Array, emitSynced: boolean) => E.Encoder;
@@ -425,7 +420,7 @@ export declare const crdt: {
                 connectBc(): void;
                 disconnectBc(): void;
                 destroy(): Promise<void>;
-                emit<N extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: N, args: Parameters<{
+                emit<N extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: N, args: Parameters<{
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -434,7 +429,7 @@ export declare const crdt: {
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[N]>): void;
                 _observers: Map<string, Set<any>>;
-                on<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                on<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -449,7 +444,7 @@ export declare const crdt: {
                     'schema-mismatch': (detail: E.SchemaMismatchDetail, provider: /*elided*/ any) => void;
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[NAME];
-                once<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                once<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -457,7 +452,7 @@ export declare const crdt: {
                     'schema-mismatch': (detail: E.SchemaMismatchDetail, provider: /*elided*/ any) => void;
                     failed: (error: unknown, provider: /*elided*/ any) => void;
                 }[NAME]): void;
-                off<NAME extends "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
+                off<NAME extends "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "load-error">(name: NAME, f: {
                     synced: (provider: /*elided*/ any) => void;
                     'protocol-mismatch': (mismatch: E.ProtocolMismatch, provider: /*elided*/ any) => void;
                     'load-error': (error: unknown, provider: /*elided*/ any) => void;
@@ -518,14 +513,7 @@ export declare const crdt: {
                 _resync: ReturnType<typeof setInterval> | undefined;
                 _connectTimer: ReturnType<typeof setTimeout> | undefined;
                 _checkInterval: ReturnType<typeof setInterval>;
-                _updateHandler: (update: Uint8Array, origin: unknown, doc?: unknown, transaction?: {
-                    local: boolean;
-                }) => void;
-                _awarenessUpdateHandler: (updates: {
-                    added: number[];
-                    updated: number[];
-                    removed: number[];
-                }, origin: unknown) => void;
+                _unlisten: () => void;
                 get url(): string;
                 get unsaved(): number;
                 get saved(): boolean;
@@ -535,11 +523,11 @@ export declare const crdt: {
                 destroy(): void;
                 disconnect(): void;
                 connect(): void;
-                emit<N extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: N, args: Parameters<E.WebsocketProviderEvents[N]>): void;
+                emit<N extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: N, args: Parameters<E.WebsocketProviderEvents[N]>): void;
                 _observers: Map<string, Set<any>>;
-                on<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): E.WebsocketProviderEvents[NAME];
-                once<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
-                off<NAME extends "refused" | "status" | "failed" | "schema-mismatch" | "message-error" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
+                on<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): E.WebsocketProviderEvents[NAME];
+                once<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
+                off<NAME extends "refused" | "status" | "failed" | "message-error" | "schema-mismatch" | "protocol-mismatch" | "synced" | "access" | "connection-close" | "connection-error" | "saved" | "permission-denied" | "expired" | "unreachable">(name: NAME, f: E.WebsocketProviderEvents[NAME]): void;
             };
         };
         watchComments: (server: string | null, roomName: string, listener: (message: E.CommentMessage) => void) => (() => void);

package/dist/crdt/doc/history.js

@@ -20,6 +20,7 @@ import { changedUnder, collectable, collectNow, collects, dropSearchMarkers, eng
 import { isInitialized } from './gate.js';
 import { DocumentDestroyedError } from './funnel.js';
 import { registryOf, withdrawOnUndo } from '../placement/model.js';
+import { getOr } from '../../utils.js';
 /** The undo steps a document's history keeps by default: older ones are released. */
 export const DEFAULT_HISTORY_LIMIT = 200;
 /** The origin of the transaction that releases a dropped history step's content. */
@@ -465,9 +466,7 @@ export const historyRules = (Y, doc) => {
             if (step.inserts.has(s.id.client, s.id.clock))
                 return;
             const values = s.content;
-            let attrs = lost.get(node);
-            if (attrs === undefined)
-                lost.set(node, (attrs = new Map()));
+            const attrs = getOr(lost, node, () => new Map());
             attrs.set(key, values.getContent().at(-1));
         });
         for (const [node, attrs] of lost) {

package/dist/crdt/doc/ops.d.ts

@@ -0,0 +1,81 @@
+import { type JSONBlock, type JSONInlineBlock, type JSONText } from '../../utils/json.js';
+import { type DataPatch } from '../data.js';
+import { type BlockId, type BlockSpec, type ContentItem, type Destination, type InlineSpec, type SplitTail } from '../placement/model.js';
+import type { DataTarget, Plan, PlanStep, Prepared } from './types.js';
+import type { DocBase, DocReads } from './reads.js';
+import type { DocPosition, RangeView } from '../rangeDelete.js';
+import { type Flow, type FlowTarget, type FlowView } from '../flow.js';
+/**
+ * A record's order among the records standing at one block, for the
+ * engine's sort of two records at one origin (fork patch YP22): what a split
+ * of a list around a block writes there — a new head list holding the items
+ * before it (`head`), new blocks placed after the items before it, which
+ * stay (`kept`), a head holding those items and the block (`with`), the
+ * block itself leaving (`self`), new blocks after it (`after`) — in the
+ * order every serial run of the gestures gives (`del.merge.container`).
+ */
+export declare const PART: {
+    readonly head: 0;
+    readonly kept: 1;
+    readonly with: 2;
+    readonly self: 3;
+    readonly after: 4;
+};
+/** An inline atom to insert: its id is minted when it names none. */
+export type NewInline = Omit<InlineSpec, 'id'> & {
+    id?: string;
+};
+/** The prepared ops of one facade over its reads. */
+export declare const docOps: (c: DocBase & DocReads) => {
+    plan: (ids: readonly BlockId[], writes: PlanStep[], at?: DocPosition) => Plan;
+    canPlace: (ids: readonly BlockId[], parent?: BlockId | null, kindOf?: (id: BlockId) => string | undefined) => boolean;
+    fits: (parent: BlockId | null, kind: string | undefined) => boolean;
+    nestParent: (ids: readonly BlockId[], parent: BlockId) => BlockId;
+    canMerge: (fromId: BlockId, intoId: BlockId) => boolean;
+    defaultChild: (parent: BlockId | null) => string;
+    landingOf: (id: BlockId, kind: string, after?: boolean) => {
+        parent: string | null;
+        levels: string[];
+    };
+    besideAt: (target: BlockId, kind?: string) => BlockId;
+    /** Every op of the families, prepared. */
+    prepare: {
+        insertBlocks: (dest: Destination, specs: readonly (BlockSpec | JSONBlock)[]) => Prepared;
+        moveBlocks: (ids: readonly BlockId[], dest: Destination) => Prepared;
+        unNestBlocks: (ids: readonly BlockId[]) => Prepared;
+        unNestBlock: (id: BlockId) => Prepared;
+        liftOut: (id: BlockId, kind: string, { keep, after }?: {
+            keep?: boolean;
+            after?: readonly 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;
+        deleteBlocks: (ids: readonly BlockId[], subtree?: boolean, filled?: BlockId | null) => 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 | JSONText | JSONInlineBlock)[];
+            children?: (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: NewInline) => Prepared;
+        removeInline: (id: BlockId, inlineId: string) => Prepared;
+        insertFlow: (target: FlowTarget, flow: Flow, view?: FlowView) => Prepared;
+        deleteRange: (from: DocPosition, to: DocPosition, view?: RangeView) => Prepared;
+        replaceRange: (from: DocPosition, to: DocPosition, view?: RangeView) => Prepared;
+    };
+};
+export type DocOps = ReturnType<typeof docOps>;