edytor 0.1.0-next.38 → 0.1.0-next.40

package/README.md

@@ -16,7 +16,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.
 
-> **Work in progress.** Edytor is a pre-release (`0.1.0-next.38`, `edytor@next` on npm) and not ready for production; the API changes between releases without a compatibility layer. The untagged `edytor@0.0.11` on npm predates the current API. Issues and PRs are welcome: when you report a bug, include the document's JSON value.
+> **Work in progress.** Edytor is a pre-release (`0.1.0-next.40`, `edytor@next` on npm) and not ready for production; the API changes between releases without a compatibility layer. The untagged `edytor@0.0.11` on npm predates the current API. Issues and PRs are welcome: when you report a bug, include the document's JSON value.
 
 ## Features
 
@@ -108,7 +108,7 @@ The [documentation site](https://edytor.dev/docs) is the single source for the A
 
 ## Contributing
 
-`CONTRIBUTING.md` lists the test lanes, what CI runs, and the pull request checklist; `AGENTS.md` describes the architecture (one owner per fact) and where to fix what. The docs live in `site/content/docs`; a change to public behavior updates them in the same commit.
+`CONTRIBUTING.md` lists the test lanes, what CI runs, and the pull request checklist; `AGENTS.md` describes the architecture (one owner per fact) and where to fix what, and `docs/agents/` holds the rules of each area. The docs live in `site/content/docs`; a change to public behavior updates them in the same commit.
 
 ```bash
 pnpm install

package/dist/block/block.svelte.d.ts

@@ -64,13 +64,6 @@ export declare class Block {
     get path(): number[];
     /** The block is visible in the document (a dead handle answers false). */
     get isInTree(): boolean;
-    /**
-     * @deprecated `edytor.suggestions` with `{ end: block.id }`. The content of
-     * this block's latest `end` suggestion, as parts (a text's runs, or an
-     * atom); setting it replaces this block's `end` suggestions, `null` drops them.
-     */
-    get suggestions(): (JSONText[] | JSONInlineBlock)[] | null;
-    set suggestions(value: (JSONText[] | JSONInlineBlock)[] | null);
     get nextBlock(): Block | null;
     get previousBlock(): Block | null;
     get closestPreviousBlock(): Block | null;
@@ -177,10 +170,6 @@ export declare class Block {
     }) => Text | null | undefined;
     normalizeContent: () => void;
     normalizeChildren: () => void;
-    /** @deprecated `edytor.suggestions.add({ end: block.id }, …)`. */
-    suggestText: (payload: BlockOperations["suggestText"]) => void;
-    /** @deprecated `suggestion.accept()`. */
-    acceptSuggestedText: () => void;
     deleteContentAtRange: (payload: {
         start: [number, number];
         end: [number, number];

package/dist/block/block.svelte.js

@@ -1,5 +1,5 @@
 import { Text } from '../text/text.svelte.js';
-import { batch, removeInlineBlock, addChildBlock, insertBlockAfter, insertBlockBefore, mergeBlockBackward, mergeBlockForward, nestBlock, removeBlock, setBlock, splitBlock, prepareSplit, duplicateBlock, prepareDuplicate, prepareSet, prepareMove, prepareMoves, prepareInsertAfter, prepareInsertBefore, prepareRemove, prepareMergeBackward, prepareMergeForward, prepareUnNest, prepareNest, prepareRemoveInline, preparePatch, patchData, prepareDeleteRange, addChildBlocks, pushContentIntoBlock, unNestBlock, moveBlock, moveBlocks, normalizeContent, addInlineBlock, textAfterAtom, blockOf, acceptSuggestedText, suggestText, deleteContentAtRange, normalizeChildren } from './block.utils.js';
+import { batch, removeInlineBlock, addChildBlock, insertBlockAfter, insertBlockBefore, mergeBlockBackward, mergeBlockForward, nestBlock, removeBlock, setBlock, splitBlock, prepareSplit, duplicateBlock, prepareDuplicate, prepareSet, prepareMove, prepareMoves, prepareInsertAfter, prepareInsertBefore, prepareRemove, prepareMergeBackward, prepareMergeForward, prepareUnNest, prepareNest, prepareRemoveInline, preparePatch, patchData, prepareDeleteRange, addChildBlocks, pushContentIntoBlock, unNestBlock, moveBlock, moveBlocks, normalizeContent, addInlineBlock, textAfterAtom, blockOf, deleteContentAtRange, normalizeChildren } from './block.utils.js';
 import { jsonBlockToSpec, jsonContentToItems } from '../utils/json.js';
 import { InlineBlock } from './inlineBlock.svelte.js';
 import { revealed } from '../selection/replaceSelection.js';
@@ -194,32 +194,6 @@ export class Block {
         this.#track();
         return this.edytor.facade.isVisibleBlock(this.id);
     }
-    /**
-     * @deprecated `edytor.suggestions` with `{ end: block.id }`. The content of
-     * this block's latest `end` suggestion, as parts (a text's runs, or an
-     * atom); setting it replaces this block's `end` suggestions, `null` drops them.
-     */
-    get suggestions() {
-        const content = this.edytor.suggestions?.at(this.id).end.at(-1)?.content[0]?.content;
-        if (!content?.length)
-            return null;
-        const parts = [];
-        for (const part of content)
-            if ('type' in part)
-                parts.push(part);
-            else if (Array.isArray(parts.at(-1)))
-                parts.at(-1).push(part);
-            else
-                parts.push([part]);
-        return parts;
-    }
-    set suggestions(value) {
-        const { suggestions } = this.edytor;
-        for (const suggestion of suggestions.at(this.id).end)
-            suggestion.discard();
-        if (value)
-            suggestions.add({ end: this.id }, [{ type: this.type, content: value.flat() }]);
-    }
     get nextBlock() {
         return this.parent ? this.parent.children[this.index + 1] : null;
     }
@@ -350,10 +324,6 @@ export class Block {
     };
     normalizeContent = batch('normalizeContent', normalizeContent);
     normalizeChildren = batch('normalizeChildren', normalizeChildren);
-    /** @deprecated `edytor.suggestions.add({ end: block.id }, …)`. */
-    suggestText = (payload) => suggestText.call(this, payload);
-    /** @deprecated `suggestion.accept()`. */
-    acceptSuggestedText = () => acceptSuggestedText.call(this);
     deleteContentAtRange = batch('deleteContentAtRange', deleteContentAtRange, prepareDeleteRange);
     /** Mark an element inside the block's markup as non-editable chrome (a header, a caption bar). */
     void = voidChrome;
@@ -382,7 +352,7 @@ export class Block {
         }
         return hit;
     };
-    // ── JSON insertion (K5: specs are data; `new Block({block})` is gone) ──
+    // ── JSON insertion (specs are data; `new Block({block})` is gone) ──
     /**
      * Insert children at `index`: a JSON spec is created (its id kept, minted
      * when missing); a block handle moves there with its identity.
@@ -425,9 +395,9 @@ export class Block {
     /** The declared view state (`open` on a `details`) the block's last element held. */
     #viewState = [];
     /**
-     * Register the element the core rendered for this block (O45) and run the
+     * Register the element the core rendered for this block and run the
      * attach hooks. A re-rendered block (moved, re-parented) keeps its declared
-     * view state (R11): an open toggle stays open.
+     * view state: an open toggle stays open.
      * @internal
      */
     attach = (node) => {

package/dist/block/block.utils.d.ts

@@ -1,5 +1,5 @@
 /**
- * View-side command adapter for block operations (U2 delegation contract).
+ * View-side command adapter for block operations: each delegates to one document operation.
  *
  * These functions are the `BlockOperations` layer bound onto `Block` via
  * `batch()`, which dispatches each call as a command (admission, plugin
@@ -8,8 +8,8 @@
  * sibling lookup for `nestBlock`), the plan of an operation
  * that is one document op (`prepare*`) and its normalization requests.
  *
- * OPERATIONS READ AND WRITE ONLY THE DOCUMENT (R3): `Block`/`Text` are id-only
- * handles whose getters read the index (R4), so what a caller needs after the
+ * OPERATIONS READ AND WRITE ONLY THE DOCUMENT: `Block`/`Text` are id-only
+ * handles whose getters read the index, so what a caller needs after the
  * write (the new block, the text after an inserted atom, the caret a range op
  * decided) is the op's document result as a handle (`batch`'s `resolve`) —
  * inside an outer transaction too.
@@ -19,13 +19,13 @@
  * as "refused" — no view-side re-checks of the rules the document already
  * enforces (island sealing, void/island destinations, own-subtree moves,
  * merges across island boundaries; see `edytor-doc.ts` `canPlace` and
- * `canMerge`, R5). Removing a view-side semantic guard must never
+ * `canMerge`). Removing a view-side semantic guard must never
  * change document behavior — if a rule matters here it belongs in the
  * facade, not in this file.
  *
  * Content preparation produces `BlockSpec`/`ContentItem` DIRECTLY from
  * JSON (`jsonBlockToSpec`/`jsonContentToItems` in `utils/json.ts`): specs are
- * data (K5: `new Block({block})` is gone). The live-content invariant
+ * data (`new Block({block})` is gone). The live-content invariant
  * (text-first/text-last, no adjacent same-kind parts) is derived by the
  * document's projection on read, so stored content needs no
  * pre-normalization.
@@ -36,7 +36,7 @@ import type { Flow, FlowTarget } from '../crdt/flow.js';
 import type { Plan, Prepared } from '../crdt/edytor-doc.js';
 import type { DataPatch } from '../crdt/data.js';
 import type { ResolvedAt } from '../session/suggestions.svelte.js';
-import { type JSONBlock, type JSONInlineBlock, type JSONText } from '../utils/json.js';
+import { type JSONBlock, type JSONInlineBlock } from '../utils/json.js';
 import { InlineBlock } from './inlineBlock.svelte.js';
 /** A move beside `target`, to its `side` (`prepare.placeBeside`, `layout.place-beside`). */
 export type BlockBeside = {
@@ -108,12 +108,6 @@ export type BlockOperations = {
     };
     normalizeContent: {};
     normalizeChildren: {};
-    /** @deprecated `edytor.suggestions.add({ end: block.id }, …)`. */
-    suggestText: {
-        value: (JSONText | JSONInlineBlock)[] | string | null;
-    };
-    /** @deprecated `suggestion.accept()`; the command hooks see is `acceptSuggestion`. */
-    acceptSuggestedText: {};
     /** A suggestion placed in the document (`edytor.suggestions`, `suggestion.accept()`). */
     acceptSuggestion: {
         suggestion: {
@@ -292,7 +286,7 @@ export declare function prepareMove(this: Block, { path }: BlockOperations['move
 export declare function moveBlock(this: Block, payload: BlockOperations['moveBlock'], plan?: Prepared): Block | null;
 /**
  * Grouped move — the operation-layer counterpart of `moveBlock` for
- * drags/multi-moves (D5). `path` is the same view-tree address shape:
+ * drags/multi-moves. `path` is the same view-tree address shape:
  * the prefix resolves the destination PARENT block, the last element is
  * the FINAL index — already discounted for the moved members by the
  * caller (the `facade.moveBlocks` contract, which counts the
@@ -329,20 +323,16 @@ export declare function patchData(this: Block, payload: BlockOperations['patchDa
  * ({@link textAfterAtom}), where the caret's pending marks follow.
  */
 export declare function addInlineBlock(this: Block, { index, block, text }: BlockOperations['addInlineBlock']): string;
-/** The text after atom `atom` of this block; the caret's pending marks follow it there (L4). */
+/** The text after atom `atom` of this block; the caret's pending marks follow it there. */
 export declare function textAfterAtom(this: Block, atom: string | undefined): Text | null | undefined;
 /**
  * Normalization runs at the end of the command's transaction
  * (`Dispatcher.drain`): a normalizer reads handles over the index; when a
  * plugin hook answers work, the work runs in the same transaction and the
- * block is requested again (bounded by the dispatcher's pass limit, D25).
+ * block is requested again (bounded by the dispatcher's pass limit).
  */
 export declare function normalizeContent(this: Block): void;
 export declare function normalizeChildren(this: Block): void;
-/** @deprecated A thin wrapper over an `{ end: block.id }` suggestion (`edytor.suggestions`). */
-export declare function suggestText(this: Block, { value }: BlockOperations['suggestText']): void;
-/** @deprecated Accepts this block's latest `{ end }` suggestion (`suggestion.accept()`). */
-export declare function acceptSuggestedText(this: Block): void;
 export declare function prepareDeleteRange(this: Block, { start: [startIndex, startOffset], end: [endIndex, endOffset] }: {
     start: number[];
     end: number[];

package/dist/block/block.utils.js

@@ -96,7 +96,7 @@ export function duplicateBlock(_ = {}, plan = prepareDuplicate.call(this)) {
 export function prepareSplit({ index, text }) {
     if (!text || !this.parent || !this.model)
         return REFUSED;
-    // G5: the sibling takes its parent's default child type and no data — a
+    // The sibling takes its parent's default child type and no data — a
     // list-like kind (`continues`) keeps its own, with its first preset's data.
     const { continues, presets } = this.definition;
     const tail = continues
@@ -183,7 +183,7 @@ export function moveBlock(payload, plan = prepareMove.call(this, payload)) {
 }
 /**
  * Grouped move — the operation-layer counterpart of `moveBlock` for
- * drags/multi-moves (D5). `path` is the same view-tree address shape:
+ * drags/multi-moves. `path` is the same view-tree address shape:
  * the prefix resolves the destination PARENT block, the last element is
  * the FINAL index — already discounted for the moved members by the
  * caller (the `facade.moveBlocks` contract, which counts the
@@ -298,7 +298,7 @@ export function addInlineBlock({ index, block, text }) {
     this.normalizeContent();
     return atom.id;
 }
-/** The text after atom `atom` of this block; the caret's pending marks follow it there (L4). */
+/** The text after atom `atom` of this block; the caret's pending marks follow it there. */
 export function textAfterAtom(atom) {
     if (atom === undefined)
         return undefined;
@@ -317,7 +317,7 @@ export function textAfterAtom(atom) {
  * Normalization runs at the end of the command's transaction
  * (`Dispatcher.drain`): a normalizer reads handles over the index; when a
  * plugin hook answers work, the work runs in the same transaction and the
- * block is requested again (bounded by the dispatcher's pass limit, D25).
+ * block is requested again (bounded by the dispatcher's pass limit).
  */
 export function normalizeContent() {
     if (this.edytor.dispatcher.defer(this, normalizeContent))
@@ -341,17 +341,6 @@ export function normalizeChildren() {
         this.normalizeChildren();
     }
 }
-/** @deprecated A thin wrapper over an `{ end: block.id }` suggestion (`edytor.suggestions`). */
-export function suggestText({ value }) {
-    this.suggestions =
-        typeof value === 'string'
-            ? [[{ text: value }]]
-            : (value?.map((part) => ('type' in part ? part : [part])) ?? null);
-}
-/** @deprecated Accepts this block's latest `{ end }` suggestion (`suggestion.accept()`). */
-export function acceptSuggestedText() {
-    this.edytor.suggestions.at(this.id).end.at(-1)?.accept();
-}
 export function prepareDeleteRange({ start: [startIndex, startOffset], end: [endIndex, endOffset] }) {
     const parts = this.edytor.idToBlock.parts(this.id);
     const [startPart, endPart] = [parts.at(startIndex), parts.at(endIndex)];

package/dist/clipboard/createClipboardFragment.js

@@ -101,7 +101,7 @@ const withoutUncopied = (edytor, fragment) => {
 };
 export const createEdytorClipboardFragment = (edytor) => withoutUncopied(edytor, fragmentOf(edytor));
 const fragmentOf = (edytor) => {
-    // A layout the block selection covers whole is copied as the layout (D3).
+    // A layout the block selection covers whole is copied as the layout.
     const selectedBlocks = selectedMembers(edytor, liftLayouts(edytor.selection.selectedBlocks));
     if (selectedBlocks.length > 0) {
         return {

package/dist/clipboard/htmlFlow.d.ts

@@ -10,7 +10,7 @@ type Values = Record<string, SerializableContent>;
 /** The tag a kind writes for `data`: its export form's first tag, else its element's, else its content element's. */
 export declare const tagOf: (type: string, kind: BlockDefinition, data: Values) => string | undefined;
 /**
- * External HTML as a flow (P4.1): the browser parses (inert: no script
+ * External HTML as a flow: the browser parses (inert: no script
  * runs, nothing loads), and the tag tables are the records inverted — a
  * catalogue kind's tag per preset (a content-less container takes its
  * default child's tag, one child per text line), a value-less mark's
@@ -20,7 +20,7 @@ export declare const tagOf: (type: string, kind: BlockDefinition, data: Values)
  * `iframe`, `video` or `audio` no hook claims carries nothing. An atom
  * kind's `parse` hook claims inline elements (an equation's `<math>`): the
  * atom, never its text. Unknown
- * elements degrade to text runs; whitespace collapses as HTML renders it. `null` when the HTML carries nothing (`flow.shape`, F-P10).
+ * elements degrade to text runs; whitespace collapses as HTML renders it. `null` when the HTML carries nothing (`flow.shape`).
  */
 export declare const flowOfHtml: (kinds: ImportKinds, html: string | undefined) => Flow | null;
 export {};

package/dist/clipboard/htmlFlow.js

@@ -54,7 +54,7 @@ export const tagOf = (type, kind, data) => {
     return undefined;
 };
 /**
- * External HTML as a flow (P4.1): the browser parses (inert: no script
+ * External HTML as a flow: the browser parses (inert: no script
  * runs, nothing loads), and the tag tables are the records inverted — a
  * catalogue kind's tag per preset (a content-less container takes its
  * default child's tag, one child per text line), a value-less mark's
@@ -64,7 +64,7 @@ export const tagOf = (type, kind, data) => {
  * `iframe`, `video` or `audio` no hook claims carries nothing. An atom
  * kind's `parse` hook claims inline elements (an equation's `<math>`): the
  * atom, never its text. Unknown
- * elements degrade to text runs; whitespace collapses as HTML renders it. `null` when the HTML carries nothing (`flow.shape`, F-P10).
+ * elements degrade to text runs; whitespace collapses as HTML renders it. `null` when the HTML carries nothing (`flow.shape`).
  */
 export const flowOfHtml = (kinds, html) => {
     if (!html || html.length > 8 * 1024 * 1024 || typeof DOMParser === 'undefined')

package/dist/clipboard/serializeClipboardFragment.js

@@ -7,7 +7,7 @@ const escapeHtml = (value) => value.replace(/&/g, '&amp;').replace(/</g, '&lt;')
 const tag = (name, inner, attributes = {}) => `<${name}${Object.entries(attributes)
     .map(([key, value]) => (value === undefined ? '' : ` ${key}="${escapeHtml(value)}"`))
     .join('')}>${inner}</${name}>`;
-/** A mark exports the element it renders (P2.7): its `tag` and `attributes`. */
+/** A mark exports the element it renders: its `tag` and `attributes`. */
 const textHtml = (part, kinds) => {
     let html = escapeHtml(part.text).replace(/\n/g, '<br>');
     for (const [name, mark] of kinds.marks) {

package/dist/cloudflare/DocumentRoom.d.ts

@@ -36,7 +36,7 @@
  *   rows ≤ `maxRowBytes` (2 MB row cap) in one `transactionSync`, then
  *   broadcast; after `compactAfter` update records the rows are replaced
  *   by one snapshot record of the live document's state (its healed
- *   state, deleted content collected: P2), after the message is
+ *   state, deleted content collected), after the message is
  *   acknowledged — never inside the engine's `update` observer, where one
  *   throw would silence every later emit. Memory never runs ahead of
  *   storage: when an append fails, nothing is relayed or acknowledged, the
@@ -52,7 +52,7 @@
  *   left out of the ack), the rest applied. Compaction reclaims the
  *   waiting deletes of client ids no user registered and no socket holds;
  *   `dropWaitingDeletes()` every one.
- * - storage format (P5): the generation record says `storage: 'v2'` —
+ * - storage format: the generation record says `storage: 'v2'` —
  *   snapshots in the v2 encoding, compressed in place after they are
  *   stored (`compressLater`), inflated at start (`inflate`); update and
  *   pending records stay v1. A container without `storage` (0.1.0-next.22)
@@ -216,7 +216,7 @@ export declare const ROOM_ORIGIN: unique symbol;
 export declare const RESTORE_ORIGIN: unique symbol;
 /** The transaction origin of the room's purge: tracked by no history. */
 export declare const PURGE_ORIGIN: unique symbol;
-/** The header `routeDocumentHistory` sets on an authorized history request (H11). */
+/** The header `routeDocumentHistory` sets on an authorized history request. */
 export declare const HISTORY_HEADER = "X-Edytor-History";
 /** The version key of a history `read` or `restore` request. */
 export declare const HISTORY_KEY_HEADER = "X-Edytor-History-Key";
@@ -888,14 +888,6 @@ export declare class AttachedDocument {
  * `false` for a socket that is not the document's).
  */
 export declare const attachRoom: (host: DurableObject<any>, options?: AttachRoomOptions) => AttachedDocument;
-/**
- * @deprecated Use {@link attachRoom} (the client's `attachDocument` attaches
- * a document to an engine doc, a different thing). Removed in the next
- * release.
- */
-export declare const attachDocument: (host: DurableObject<any>, options?: AttachRoomOptions) => AttachedDocument;
-/** @deprecated Use {@link AttachRoomOptions}. Removed in the next release. */
-export type AttachDocumentOptions = AttachRoomOptions;
 /**
  * The ready-made room: a Durable Object hosting one document, configured
  * by `vars` ({@link DocumentRoomEnv}). Subclass it to override `onLoad` and

package/dist/cloudflare/DocumentRoom.js

@@ -36,7 +36,7 @@
  *   rows ≤ `maxRowBytes` (2 MB row cap) in one `transactionSync`, then
  *   broadcast; after `compactAfter` update records the rows are replaced
  *   by one snapshot record of the live document's state (its healed
- *   state, deleted content collected: P2), after the message is
+ *   state, deleted content collected), after the message is
  *   acknowledged — never inside the engine's `update` observer, where one
  *   throw would silence every later emit. Memory never runs ahead of
  *   storage: when an append fails, nothing is relayed or acknowledged, the
@@ -52,7 +52,7 @@
  *   left out of the ack), the rest applied. Compaction reclaims the
  *   waiting deletes of client ids no user registered and no socket holds;
  *   `dropWaitingDeletes()` every one.
- * - storage format (P5): the generation record says `storage: 'v2'` —
+ * - storage format: the generation record says `storage: 'v2'` —
  *   snapshots in the v2 encoding, compressed in place after they are
  *   stored (`compressLater`), inflated at start (`inflate`); update and
  *   pending records stay v1. A container without `storage` (0.1.0-next.22)
@@ -193,7 +193,7 @@ export const ROOM_ORIGIN = Symbol('edytor-room');
 export const RESTORE_ORIGIN = Symbol('edytor-restore');
 /** The transaction origin of the room's purge: tracked by no history. */
 export const PURGE_ORIGIN = Symbol('edytor-purge');
-/** The header `routeDocumentHistory` sets on an authorized history request (H11). */
+/** The header `routeDocumentHistory` sets on an authorized history request. */
 export const HISTORY_HEADER = 'X-Edytor-History';
 /** The version key of a history `read` or `restore` request. */
 export const HISTORY_KEY_HEADER = 'X-Edytor-History-Key';
@@ -430,7 +430,7 @@ export class AttachedDocument {
     lastUpdated() {
         return this.room.storage.lastUpdated();
     }
-    // ── History (H11) ────────────────────────────────────────────────────
+    // ── History ────────────────────────────────────────────────────
     /**
      * Resolves once the versions the room is writing are stored (a slot a
      * write closed is written in the background).
@@ -485,7 +485,7 @@ export class AttachedDocument {
     comment(request, actor) {
         return this.room.comments.apply(request, actor);
     }
-    // ── Moves (H10, `room.move`) ─────────────────────────────────────────
+    // ── Moves (`room.move`) ─────────────────────────────────────────
     /**
      * Export blocks `ids` for a move (`room.move`, step 1): their visible
      * subtrees as JSON, the outermost only, in document order. Writes
@@ -537,7 +537,7 @@ export class AttachedDocument {
     applyLateEdits(batch) {
         return this.room.moves.applyLateEdits(batch);
     }
-    // ── Purge (H7) ───────────────────────────────────────────────────────
+    // ── Purge ───────────────────────────────────────────────────────
     /**
      * The purge task, also over RPC (`room.purge.timing`): record an epoch
      * (the state vector, now) when the document changed since the last one,
@@ -685,12 +685,6 @@ export const attachRoom = (host, options = {}) => {
     }
     return document;
 };
-/**
- * @deprecated Use {@link attachRoom} (the client's `attachDocument` attaches
- * a document to an engine doc, a different thing). Removed in the next
- * release.
- */
-export const attachDocument = attachRoom;
 /**
  * The ready-made room: a Durable Object hosting one document, configured
  * by `vars` ({@link DocumentRoomEnv}). Subclass it to override `onLoad` and

package/dist/cloudflare/history.d.ts

@@ -10,8 +10,7 @@
 /**
  * The structural subset of a KV namespace {@link kvHistory} uses — a
  * Workers `KVNamespace` binding satisfies it, and so does an in-memory
- * fake. Passed as `history.store` itself it is wrapped by
- * {@link kvHistory} (deprecated: pass `kvHistory(namespace)`).
+ * fake. As `history.store` it goes through {@link kvHistory}.
  */
 export type KVLike = {
     put(key: string, value: ArrayBuffer | ArrayBufferView | string, options?: {
@@ -110,10 +109,10 @@ export type HistoryStoreFactory = (room: HistoryRoomStorage) => HistoryStore;
 export type HistoryOptions = {
     /**
      * The store: a {@link HistoryStore} ({@link kvHistory}, {@link r2History}
-     * or your own), {@link roomHistory}`()`, or — deprecated — a KV namespace
-     * itself (any {@link KVLike}, wrapped by {@link kvHistory}).
+     * or your own) or {@link roomHistory}`()`. A KV namespace goes through
+     * {@link kvHistory}.
      */
-    store: HistoryStore | HistoryStoreFactory | KVLike;
+    store: HistoryStore | HistoryStoreFactory;
     /** How long a version is kept, in days (default 30). */
     retentionDays?: number;
     /** The IANA time zone whose noon and midnight end the slots (default `'UTC'`). */
@@ -235,6 +234,7 @@ export declare const isR2Bucket: (store: unknown) => store is R2BucketLike;
 /**
  * The store `history.store` names, built for this room: a
  * {@link HistoryStore} as it is, a factory ({@link roomHistory}) over the
- * room's storage, and a bare KV namespace through {@link kvHistory}.
+ * room's storage. Anything else (a KV namespace itself) is refused: it goes
+ * through {@link kvHistory}.
  */
 export declare const resolveHistoryStore: (store: HistoryOptions["store"], room: HistoryRoomStorage) => HistoryStore;

package/dist/cloudflare/history.js

@@ -324,7 +324,7 @@ export const roomHistory = (options = {}) => ({ sql, transactionSync, tablePrefi
         }
     };
 };
-/** A {@link HistoryStore} (its numeric `maxValueBytes` says so), as opposed to a bare KV namespace. */
+/** A {@link HistoryStore} (its numeric `maxValueBytes` and its `delete` say so). */
 const isHistoryStore = (store) => typeof store?.maxValueBytes === 'number' &&
     typeof store.delete === 'function';
 /** An R2 bucket binding (it has multipart uploads; a KV namespace does not). */
@@ -333,12 +333,13 @@ export const isR2Bucket = (store) => typeof store?.createMultipartUpload ===
 /**
  * The store `history.store` names, built for this room: a
  * {@link HistoryStore} as it is, a factory ({@link roomHistory}) over the
- * room's storage, and a bare KV namespace through {@link kvHistory}.
+ * room's storage. Anything else (a KV namespace itself) is refused: it goes
+ * through {@link kvHistory}.
  */
 export const resolveHistoryStore = (store, room) => {
     if (typeof store === 'function')
         return store(room);
     if (isHistoryStore(store))
         return store;
-    return kvHistory(store);
+    throw new TypeError('history.store: not a HistoryStore. Wrap a KV namespace in kvHistory(namespace), an R2 bucket in r2History(bucket)');
 };

package/dist/cloudflare/index.d.ts

@@ -4,10 +4,10 @@
  * `cloudflare:workers`); built on the Worker-safe CRDT entry. Documented in
  * the site's `server/` section (room, authorization, extending, protocol).
  */
-export { DocumentRoom, AttachedDocument, attachRoom, attachDocument, SOCKET_TAG, closedSocket, type AttachRoomOptions, type AttachDocumentOptions, type CommentOptions, DEFAULT_COMPACT_AFTER, DEFAULT_MAX_ROW_BYTES, DEFAULT_SAVE_AFTER, DEFAULT_MAX_DOCUMENT_BYTES, DEFAULT_MAX_INBOUND_FRAME_BYTES, DEFAULT_MAX_BUFFERED_BYTES, DEFAULT_MAX_UPDATES_PER_SECOND, DEFAULT_MAX_PRESENCE_BYTES, DEFAULT_MAX_PRESENCE_PER_SECOND, DEFAULT_MAX_PRESENCE_FANOUT, MAX_REFUSALS, MAX_WAITING_DELETES, ROOM_ORIGIN, RESTORE_ORIGIN, PURGE_ORIGIN, IDENTITY_HEADERS, PROBE_HEADER, noTimers, type Attachment, type DocumentRoomEnv, type LoadedDocument, type Refusal, type ReplicaOwner, type SavedDocument, type SocketIdentity, type StoredRecord, type FrameValidation, type ValidatedBlock, type RoomMetrics, type RoomLogEntry, type RestoreResult, type Timing } from './DocumentRoom.js';
+export { DocumentRoom, AttachedDocument, attachRoom, SOCKET_TAG, closedSocket, type AttachRoomOptions, type CommentOptions, DEFAULT_COMPACT_AFTER, DEFAULT_MAX_ROW_BYTES, DEFAULT_SAVE_AFTER, DEFAULT_MAX_DOCUMENT_BYTES, DEFAULT_MAX_INBOUND_FRAME_BYTES, DEFAULT_MAX_BUFFERED_BYTES, DEFAULT_MAX_UPDATES_PER_SECOND, DEFAULT_MAX_PRESENCE_BYTES, DEFAULT_MAX_PRESENCE_PER_SECOND, DEFAULT_MAX_PRESENCE_FANOUT, MAX_REFUSALS, MAX_WAITING_DELETES, ROOM_ORIGIN, RESTORE_ORIGIN, PURGE_ORIGIN, IDENTITY_HEADERS, PROBE_HEADER, noTimers, type Attachment, type DocumentRoomEnv, type LoadedDocument, type Refusal, type ReplicaOwner, type SavedDocument, type SocketIdentity, type StoredRecord, type FrameValidation, type ValidatedBlock, type RoomMetrics, type RoomLogEntry, type RestoreResult, type Timing } from './DocumentRoom.js';
 export { DEFAULT_RETENTION_DAYS, HISTORY_MAX_VALUE_BYTES, R2_HISTORY_MAX_VALUE_BYTES, ROOM_HISTORY_MAX_BYTES, ROOM_HISTORY_MAX_VALUE_BYTES, kvHistory, r2History, roomHistory, type HistoryEntry, type HistoryMetadata, type HistoryOptions, type HistoryRoomStorage, type HistoryStore, type HistoryStoreFactory, type HistoryStoreRecord, type KVLike, type R2BucketLike } from './history.js';
 export { type PurgeReport } from '../crdt/purge.js';
 export { COMMENT_STATUS, MAX_COMMENT_LENGTH, MAX_COMMENTS_PER_THREAD, MAX_THREADS, commentAnchors, decideComment, type ThreadComment, type CommentActor, type CommentChange, type CommentOutcome, type CommentRefusal, type CommentRequest, type CommentRun, type CommentSnapshot, type CommentThread } from '../crdt/protocols/comments.js';
 export { lockedBlocks, type LockOptions } from './locks.js';
-export { moveBlocksBetweenRooms, moveBlocks, forwardLateEdits, DEFAULT_MOVE_GRACE_DAYS, type CommitResult, type ExportedBlocks, type ImportReceipt, type ImportRequest, type LateEdit, type LateEditBatch, type MoveDestination, type MovedState, type MoveNamespace, type MoveRoom } from './move.js';
+export { moveBlocksBetweenRooms, forwardLateEdits, DEFAULT_MOVE_GRACE_DAYS, type CommitResult, type ExportedBlocks, type ImportReceipt, type ImportRequest, type LateEdit, type LateEditBatch, type MoveDestination, type MovedState, type MoveNamespace, type MoveRoom } from './move.js';
 export { routeDocumentSocket, routeDocumentHistory, routeDocumentComments, requestedReplica, type AuthorizeDocumentSocket, type ExpiredCredential, type DocumentNamespace, type DocumentIdentity, type RouteDocumentOptions } from './routeDocumentSocket.js';

package/dist/cloudflare/index.js

@@ -4,10 +4,10 @@
  * `cloudflare:workers`); built on the Worker-safe CRDT entry. Documented in
  * the site's `server/` section (room, authorization, extending, protocol).
  */
-export { DocumentRoom, AttachedDocument, attachRoom, attachDocument, SOCKET_TAG, closedSocket, DEFAULT_COMPACT_AFTER, DEFAULT_MAX_ROW_BYTES, DEFAULT_SAVE_AFTER, DEFAULT_MAX_DOCUMENT_BYTES, DEFAULT_MAX_INBOUND_FRAME_BYTES, DEFAULT_MAX_BUFFERED_BYTES, DEFAULT_MAX_UPDATES_PER_SECOND, DEFAULT_MAX_PRESENCE_BYTES, DEFAULT_MAX_PRESENCE_PER_SECOND, DEFAULT_MAX_PRESENCE_FANOUT, MAX_REFUSALS, MAX_WAITING_DELETES, ROOM_ORIGIN, RESTORE_ORIGIN, PURGE_ORIGIN, IDENTITY_HEADERS, PROBE_HEADER, noTimers } from './DocumentRoom.js';
+export { DocumentRoom, AttachedDocument, attachRoom, SOCKET_TAG, closedSocket, DEFAULT_COMPACT_AFTER, DEFAULT_MAX_ROW_BYTES, DEFAULT_SAVE_AFTER, DEFAULT_MAX_DOCUMENT_BYTES, DEFAULT_MAX_INBOUND_FRAME_BYTES, DEFAULT_MAX_BUFFERED_BYTES, DEFAULT_MAX_UPDATES_PER_SECOND, DEFAULT_MAX_PRESENCE_BYTES, DEFAULT_MAX_PRESENCE_PER_SECOND, DEFAULT_MAX_PRESENCE_FANOUT, MAX_REFUSALS, MAX_WAITING_DELETES, ROOM_ORIGIN, RESTORE_ORIGIN, PURGE_ORIGIN, IDENTITY_HEADERS, PROBE_HEADER, noTimers } from './DocumentRoom.js';
 export { DEFAULT_RETENTION_DAYS, HISTORY_MAX_VALUE_BYTES, R2_HISTORY_MAX_VALUE_BYTES, ROOM_HISTORY_MAX_BYTES, ROOM_HISTORY_MAX_VALUE_BYTES, kvHistory, r2History, roomHistory } from './history.js';
 export {} from '../crdt/purge.js';
 export { COMMENT_STATUS, MAX_COMMENT_LENGTH, MAX_COMMENTS_PER_THREAD, MAX_THREADS, commentAnchors, decideComment } from '../crdt/protocols/comments.js';
 export { lockedBlocks } from './locks.js';
-export { moveBlocksBetweenRooms, moveBlocks, forwardLateEdits, DEFAULT_MOVE_GRACE_DAYS } from './move.js';
+export { moveBlocksBetweenRooms, forwardLateEdits, DEFAULT_MOVE_GRACE_DAYS } from './move.js';
 export { routeDocumentSocket, routeDocumentHistory, routeDocumentComments, requestedReplica } from './routeDocumentSocket.js';

package/dist/cloudflare/locks.d.ts

@@ -1,6 +1,6 @@
 /**
- * Per-block locks (H10, `room.locks` in `docs/editor-delete-contract.md`):
- * a `validate` hook (H2, accept-then-compensate) that keeps a locked block
+ * Per-block locks (`room.locks` in `docs/editor-delete-contract.md`):
+ * a `validate` hook (accept-then-compensate) that keeps a locked block
  * its owner's. Worker-safe: no timers, no browser globals.
  *
  * A block is locked when its data names a user under `key` (default

package/dist/cloudflare/move.d.ts

@@ -1,5 +1,5 @@
 /**
- * Cross-document moves (H10, `room.move` in `docs/editor-delete-contract.md`):
+ * Cross-document moves (`room.move` in `docs/editor-delete-contract.md`):
  * blocks leave document A for document B so that no concurrent edit is
  * lost. Worker-safe; the room (`DocumentRoom.ts`) owns the storage and the
  * transactions, this module the protocol and the merge.
@@ -150,16 +150,6 @@ export declare const moveBlocksBetweenRooms: (namespace: MoveNamespace, move: {
     ids: string[];
     dest: MoveDestination;
 }) => Promise<ImportReceipt>;
-/**
- * @deprecated Use {@link moveBlocksBetweenRooms} (`edytor.moveBlocks` moves
- * blocks inside one document). Removed in the next release.
- */
-export declare const moveBlocks: (namespace: MoveNamespace, move: {
-    from: string;
-    to: string;
-    ids: string[];
-    dest: MoveDestination;
-}) => Promise<ImportReceipt>;
 /**
  * Forward the late edits document `from` holds (`room.move.late`) to their
  * destinations and acknowledge them — for a room without `rooms()`, which

package/dist/cloudflare/move.js

@@ -148,11 +148,6 @@ export const moveBlocksBetweenRooms = async (namespace, move) => {
         throw new Error(`moveBlocksBetweenRooms: commit refused (${committed.reason ?? 'unknown'})`);
     return receipt;
 };
-/**
- * @deprecated Use {@link moveBlocksBetweenRooms} (`edytor.moveBlocks` moves
- * blocks inside one document). Removed in the next release.
- */
-export const moveBlocks = moveBlocksBetweenRooms;
 /**
  * Forward the late edits document `from` holds (`room.move.late`) to their
  * destinations and acknowledge them — for a room without `rooms()`, which

package/dist/cloudflare/room/access.js

@@ -57,7 +57,7 @@ export class RoomAccess {
     /** A request forwarded by the host Worker (`AttachedDocument.fetch`). */
     async fetch(request) {
         const room = this.room;
-        // A history request (H11), forwarded by `routeDocumentHistory` once authorized.
+        // A history request, forwarded by `routeDocumentHistory` once authorized.
         const op = request.headers.get(HISTORY_HEADER);
         if (op !== null) {
             const identity = readIdentity(request.headers);
@@ -77,7 +77,7 @@ export class RoomAccess {
             return room.comments.request(comments, identity, body);
         }
         // The probes, forwarded by `routeDocumentSocket` once authorized:
-        // `lastUpdated` (H12) and `snapshot` (P8: the document as JSON).
+        // `lastUpdated` and `snapshot` (the document as JSON).
         const probe = request.headers.get(PROBE_HEADER);
         if (probe === 'lastUpdated' || probe === 'snapshot') {
             if (readIdentity(request.headers) === null) {