edytor 1.0.0-rc.3 → 1.0.0

package/dist/components/Block.svelte.d.ts

@@ -1,11 +1,13 @@
 import type { PreviewCell } from '../surface/cells.js';
 import { Suggestion } from '../session/suggestions.svelte.js';
+/**
+ * A child in the flow: a block's id, a block suggestion's preview in the
+ * flow among its siblings (in place of a block), or a suggestion's own
+ * block, rendered from its preview cell, never registered (`Suggestion`).
+ */
+export type Kid = string | Suggestion | PreviewCell;
 type $$ComponentProps = {
-    id?: string;
-    /** A suggestion's block: rendered from its preview cell, never registered (`Suggestion`). */
-    preview?: PreviewCell;
-    /** A block suggestion's preview in the flow among its siblings, in place of a block. */
-    suggestion?: Suggestion;
+    kid: Kid;
 };
 declare const Block: import("svelte").Component<$$ComponentProps, {}, "">;
 type Block = ReturnType<typeof Block>;

package/dist/components/Content.svelte

@@ -51,11 +51,7 @@
 	/** Segments are keyed causally (the preceding atom's id, or `start`), never by ordinal. */
 	const keyOf = (part: Part) => (part.kind === 'text' ? `s:${part.key}:${epoch}` : `a:${part.id}`);
 
-	const view = (segment: Segment) =>
-		edytor.pin.render(id, segment.key) ?? {
-			deltas: segmentDeltas(cell!, segment, transform),
-			empty: segment.text === ''
-		};
+	const view = (segment: Segment) => edytor.pin.shown(cell!, segment, transform);
 
 	/** A suggestion's text after this block's (`end`): its first block's content. */
 	const ghosts = $derived(

package/dist/components/Edytor.svelte

@@ -2,7 +2,7 @@
 	// `EdytorClass` alias: the emitted `.svelte.d.ts` also declares `Edytor`
 	// (the component + its bindable instance type) — an unaliased import
 	// collides there (TS2440 for bundler-resolution consumers).
-	import { Edytor as EdytorClass, useEdytor, type Snippets } from '../edytor.svelte.js';
+	import { Edytor as EdytorClass, useEdytor } from '../edytor.svelte.js';
 	import {
 		SyncRefusedError,
 		type Awareness,
@@ -19,43 +19,28 @@
 	} from '../collaboration/awarenessSelection.js';
 	import { createIndexeddbSync, createWebsocketSync } from '../collaboration/providers.js';
 	export { EdytorClass as EdytorContext, useEdytor };
-	import type { Placeholder, Plugin } from '../plugins.js';
+	import type { Plugin } from '../plugins.js';
+	import { brandOf } from '../plugins/brand.js';
 	import type { PartialLabels } from '../labels.js';
-	import {
-		blockHandlesPlugin,
-		createBlockHandlesPlugin,
-		isBlockHandlesPlugin,
-		type BlockHandlesOptions
-	} from '../plugins/blockHandles/blockHandlesPlugin.js';
-	import { isRichTextPlugin, richTextPlugin } from '../plugins/richtext/RichTextPlugin.svelte';
-	import { arrowMovePlugin } from '../plugins/arrowMove/arrowMove.js';
-	import { imagePlugin, isImagePlugin } from '../plugins/image/ImagePlugin.svelte';
-	import {
-		isSuggestionsPlugin,
-		suggestionsPlugin
-	} from '../plugins/suggestions/suggestionsPlugin.js';
+	import { createRichTextPlugin } from '../plugins/richtext/RichTextPlugin.svelte';
+	import { createArrowMovePlugin } from '../plugins/arrowMove/arrowMove.js';
+	import { createImagePlugin } from '../plugins/image/ImagePlugin.svelte';
+	import { createSuggestionsPlugin } from '../plugins/suggestions/suggestionsPlugin.js';
 
 	/**
-	 * The plugins every view has unless it lists its own (or sets
+	 * The plugins every view has unless it lists one of their kind (or sets
 	 * `defaultPlugins={false}`), after the app's so its kinds and keys win:
 	 * block moves, the suggestion UI, the image kind, then rich text.
 	 */
-	const withDefaults = (plugins: Plugin[] = []): Plugin[] => [
-		...plugins,
-		...(plugins.includes(arrowMovePlugin) ? [] : [arrowMovePlugin]),
-		...(plugins.some(isSuggestionsPlugin) ? [] : [suggestionsPlugin]),
-		...(plugins.some(isImagePlugin) ? [] : [imagePlugin]),
-		...(plugins.some(isRichTextPlugin) ? [] : [richTextPlugin])
+	const DEFAULTS = [
+		createArrowMovePlugin(),
+		createSuggestionsPlugin(),
+		createImagePlugin(),
+		createRichTextPlugin()
 	];
-	/**
-	 * The handles: none with `false`, the configured ones (replacing any
-	 * listed) with options, else the listed ones or the default, first.
-	 */
-	const withHandles = (plugins: Plugin[] | undefined, handles: boolean | BlockHandlesOptions) => {
-		const others = plugins?.filter((plugin) => !isBlockHandlesPlugin(plugin));
-		if (handles === false) return others;
-		if (typeof handles === 'object') return [createBlockHandlesPlugin(handles), ...(others ?? [])];
-		return plugins?.some(isBlockHandlesPlugin) ? plugins : [blockHandlesPlugin, ...(plugins ?? [])];
+	const withDefaults = (plugins: Plugin[] = []): Plugin[] => {
+		const listed = new Set(plugins.map(brandOf));
+		return [...plugins, ...DEFAULTS.filter((plugin) => !listed.has(brandOf(plugin)))];
 	};
 	/**
 	 * The sync of a room id no dial can carry (`validRoomId`): no socket, the
@@ -80,10 +65,8 @@
 		children: []
 	};
 
-	export type EdytorProps = Snippets & {
+	export type EdytorProps = {
 		plugins?: Plugin[];
-		/** Show built-in block handles, with optional pointer dragging and activation callback. */
-		blockHandles?: boolean | BlockHandlesOptions;
 		/** Add rich text, arrow moves, the suggestion UI and images unless `plugins` lists them (default `true`). */
 		defaultPlugins?: boolean;
 		class?: string;
@@ -100,7 +83,7 @@
 		document?: EdytorDocument;
 		doc?: YDoc;
 		awareness?: Awareness;
-		/** The local author (id, name, color) of the document this view owns: history lineage and presence. */
+		/** The local author (id, name, color) of the document this view owns: attribution and presence. */
 		actor?: DocumentActor;
 		/**
 		 * What this view shares of its selection with peers (`share`: `'caret'`,
@@ -125,13 +108,12 @@
 		onSelectionChange?: (selection: EdytorSelection) => void;
 		/** The initial content, read once (not bindable): follow edits with `onChange` or `edytor.value`. */
 		value?: JSONDoc;
-		placeholder?: Placeholder;
 		/**
-		 * The words the view says itself, over the English ones: its
-		 * announcements to assistive technology and a suggestion's name. Each
-		 * plugin takes its own `labels`. Read once.
+		 * The words the package shows and says in this view, over the English
+		 * ones: any entry of any section (`editor`, `richText`, `table`…) and
+		 * the commands' slash `keywords` by id. Read once.
 		 */
-		labels?: PartialLabels<'editor'>;
+		labels?: PartialLabels;
 		translate?: 'yes' | 'no';
 		spellcheck?: boolean;
 		autocorrect?: 'on' | 'off';
@@ -195,7 +177,6 @@
 
 	let {
 		plugins: userPlugins,
-		blockHandles,
 		defaultPlugins = true,
 		class: className,
 		'aria-label': ariaLabel,
@@ -223,7 +204,6 @@
 		onChange,
 		onDocChange,
 		onSelectionChange,
-		placeholder,
 		labels,
 		translate = 'no',
 		spellcheck = true,
@@ -231,17 +211,12 @@
 		autocomplete = 'off',
 		autocapitalize = 'none',
 		inputmode,
-		enterkeyhint,
-		...snippets
+		enterkeyhint
 	}: EdytorProps = $props();
 
 	const initialEdytorOptions = untrack(() => ({
-		snippets,
 		readonly,
-		plugins: withHandles(
-			defaultPlugins ? withDefaults(userPlugins) : userPlugins,
-			blockHandles ?? true
-		),
+		plugins: defaultPlugins ? withDefaults(userPlugins) : userPlugins,
 		document: edytorDocument,
 		doc,
 		awareness,
@@ -253,7 +228,6 @@
 		onDocChange,
 		sync: !!sync || room !== undefined,
 		value,
-		placeholder,
 		labels
 	}));
 
@@ -354,25 +328,13 @@
 	$effect(edytor.surface.post);
 	$effect(edytor.projector.post);
 
-	const browserMutationGuardAttributes = $derived({
-		spellcheck,
-		autocorrect,
-		autocomplete,
-		autocapitalize,
-		inputmode,
-		enterkeyhint
-	});
-
 	/**
-	 * The root's browser attributes. Optional hints (`inputmode`,
-	 * `enterkeyhint`) stay absent when unset — emitting a guessed default
-	 * would override the browser/UA's own choice.
+	 * The root's browser hints, several of them unknown to Svelte's element
+	 * types; one left unset is absent (a guessed default would override the
+	 * browser's own choice).
 	 */
-	const editableRootBrowserAttributes = (
-		node: HTMLElement,
-		attributes: typeof browserMutationGuardAttributes
-	) => {
-		const apply = (next: typeof attributes) => {
+	const browserAttributes = (node: HTMLElement, attributes: Record<string, unknown>) => {
+		const apply = (next: Record<string, unknown>) => {
 			for (const [name, value] of Object.entries(next))
 				if (value === undefined) node.removeAttribute(name);
 				else node.setAttribute(name, String(value));
@@ -380,28 +342,25 @@
 		apply(attributes);
 		return { update: apply };
 	};
-
-	const nonNativeEditableBlockChromeSelection = (node: HTMLElement) => {
-		const { selection } = edytor;
-		// `selectstart` is the only event fired before a drag-selection
-		// begins — the guard keeps one from starting on non-editable
-		// chrome (markers, void/island chrome, plugin UI). A press on that
-		// chrome is the press's (`events/onFocus.ts`).
-		node.addEventListener('selectstart', selection.pointer.onSelectStart);
-		return {
-			destroy: () => node.removeEventListener('selectstart', selection.pointer.onSelectStart)
-		};
-	};
 </script>
 
 {#if edytor.synced}
 	<!-- The editing host is focusable (contenteditable): no tabindex of its own. -->
 	<!-- svelte-ignore a11y_aria_activedescendant_has_tabindex -->
+	<!-- `selectstart`, fired before a drag-selection begins, keeps one from starting on
+	non-editable chrome (a press there is the press's: `events/onFocus.ts`). -->
 	<div
 		class={className}
 		use:edytor.attach
-		use:editableRootBrowserAttributes={browserMutationGuardAttributes}
-		use:nonNativeEditableBlockChromeSelection
+		onselectstart={edytor.selection.pointer.onSelectStart}
+		use:browserAttributes={{
+			spellcheck,
+			autocorrect,
+			autocomplete,
+			autocapitalize,
+			inputmode,
+			enterkeyhint
+		}}
 		data-edytor
 		data-edytor-selection={edytor.selection.value.kind === 'blocks' ? 'blocks' : undefined}
 		contenteditable={!readonly}
@@ -419,8 +378,7 @@
 		{translate}
 	>
 		{#each edytor.suggestions.around(edytor.cells?.rootIds ?? []) as kid (kid)}<Block
-				id={typeof kid === 'string' ? kid : undefined}
-				suggestion={typeof kid === 'string' ? undefined : kid}
+				{kid}
 			/>{/each}<span
 			data-edytor-render-anchor
 			contenteditable="false"
@@ -433,19 +391,18 @@
 	<!-- The room's JSON, read-only, while this view's document hydrates. -->
 	<div data-edytor-snapshot style="display: contents">
 		<Snapshot
-			value={snapshot}
-			readonly
-			plugins={userPlugins}
-			{defaultPlugins}
-			{blockHandles}
-			class={className}
-			{placeholder}
-			{labels}
-			aria-label={ariaLabel}
-			aria-labelledby={ariaLabelledby}
-			aria-describedby={ariaDescribedby}
-			{id}
-			{...snippets}
+			{...{
+				value: snapshot,
+				readonly: true,
+				plugins: userPlugins,
+				defaultPlugins,
+				class: className,
+				labels,
+				'aria-label': ariaLabel,
+				'aria-labelledby': ariaLabelledby,
+				'aria-describedby': ariaDescribedby,
+				id
+			}}
 		/>
 	</div>
 {/if}

package/dist/components/Edytor.svelte.d.ts

@@ -1,15 +1,12 @@
-import { Edytor as EdytorClass, useEdytor, type Snippets } from '../edytor.svelte.js';
+import { Edytor as EdytorClass, useEdytor } from '../edytor.svelte.js';
 import { SyncRefusedError, type Awareness, type DocChange, type DocumentActor, type EdytorDocument, type YDoc } from '../crdt/index.js';
 import type { EdytorSync, WebsocketSyncOptions } from '../collaboration/index.js';
 import { type PresenceOptions } from '../collaboration/awarenessSelection.js';
 export { EdytorClass as EdytorContext, useEdytor };
-import type { Placeholder, Plugin } from '../plugins.js';
+import type { Plugin } from '../plugins.js';
 import type { PartialLabels } from '../labels.js';
-import { type BlockHandlesOptions } from '../plugins/blockHandles/blockHandlesPlugin.js';
-export type EdytorProps = Snippets & {
+export type EdytorProps = {
     plugins?: Plugin[];
-    /** Show built-in block handles, with optional pointer dragging and activation callback. */
-    blockHandles?: boolean | BlockHandlesOptions;
     /** Add rich text, arrow moves, the suggestion UI and images unless `plugins` lists them (default `true`). */
     defaultPlugins?: boolean;
     class?: string;
@@ -26,7 +23,7 @@ export type EdytorProps = Snippets & {
     document?: EdytorDocument;
     doc?: YDoc;
     awareness?: Awareness;
-    /** The local author (id, name, color) of the document this view owns: history lineage and presence. */
+    /** The local author (id, name, color) of the document this view owns: attribution and presence. */
     actor?: DocumentActor;
     /**
      * What this view shares of its selection with peers (`share`: `'caret'`,
@@ -51,13 +48,12 @@ export type EdytorProps = Snippets & {
     onSelectionChange?: (selection: EdytorSelection) => void;
     /** The initial content, read once (not bindable): follow edits with `onChange` or `edytor.value`. */
     value?: JSONDoc;
-    placeholder?: Placeholder;
     /**
-     * The words the view says itself, over the English ones: its
-     * announcements to assistive technology and a suggestion's name. Each
-     * plugin takes its own `labels`. Read once.
+     * The words the package shows and says in this view, over the English
+     * ones: any entry of any section (`editor`, `richText`, `table`…) and
+     * the commands' slash `keywords` by id. Read once.
      */
-    labels?: PartialLabels<'editor'>;
+    labels?: PartialLabels;
     translate?: 'yes' | 'no';
     spellcheck?: boolean;
     autocorrect?: 'on' | 'off';

package/dist/components/Ranges.svelte

@@ -0,0 +1,96 @@
+<script lang="ts" module>
+	import type { PresencePoint } from '../collaboration/awarenessSelection.js';
+	import type { Edytor } from '../edytor.svelte.js';
+
+	/** A run of text the overlay marks: its ends, and whether it is the current one (`data-current`). */
+	export type MarkedRange = { start: PresencePoint; end: PresencePoint; current?: boolean };
+
+	/** The run of `length` at block offset `offset` of block `id` (none where it is not shown). */
+	export const runOf = (
+		edytor: Edytor,
+		id: string,
+		offset: number,
+		length: number,
+		current?: boolean
+	): MarkedRange[] => {
+		const block = edytor.idToBlock.get(id);
+		const [start, end] = [block?.textAtOffset(offset), block?.textAtOffset(offset + length)];
+		return start && end ? [{ start, end, current }] : [];
+	};
+</script>
+
+<script lang="ts">
+	import { onMount } from 'svelte';
+	import { rangeRects, type RemoteSelectionRect } from '../collaboration/remoteSelection.js';
+
+	/**
+	 * Runs of text marked in the overlay (never inside the host), one
+	 * rectangle per line box, measured once per frame: the find matches, the
+	 * text a `replace` suggestion removes, the comment being written. Each
+	 * rectangle carries `data-edytor-<name>` (`data-current` on the current
+	 * run's); the layer is `z`.
+	 */
+	let {
+		edytor,
+		name,
+		z,
+		ranges
+	}: { edytor: Edytor; name: string; z: number; ranges: () => MarkedRange[] } = $props();
+
+	let rects: (RemoteSelectionRect & { current?: boolean })[] = $state([]);
+
+	onMount(() =>
+		edytor.overlay.add((origin) => {
+			const next = ranges().flatMap(({ start, end, current }) =>
+				rangeRects(edytor, start, end, origin).map((rect) => ({ ...rect, current }))
+			);
+			if (next.length || rects.length) return () => (rects = next);
+		})
+	);
+	// What the runs read changed: the overlay measures again.
+	$effect(() => {
+		void ranges();
+		edytor.overlay.invalidate();
+	});
+</script>
+
+<div data-edytor-ranges={name} contenteditable="false" aria-hidden="true" style:z-index={z}>
+	{#each rects as rect, index (index)}
+		<span
+			{...{ [`data-edytor-${name}`]: '' }}
+			data-current={rect.current || undefined}
+			style:left={`${rect.left}px`}
+			style:top={`${rect.top}px`}
+			style:width={`${rect.width}px`}
+			style:height={`${rect.height}px`}
+		></span>
+	{/each}
+</div>
+
+<style>
+	[data-edytor-ranges] {
+		position: absolute;
+		left: 0;
+		top: 0;
+		pointer-events: none;
+	}
+	[data-edytor-ranges] > span {
+		position: absolute;
+	}
+	:global([data-edytor-find-match]) {
+		border-radius: 2px;
+		background: var(--edytor-find-match, rgb(255 212 0 / 0.3));
+		mix-blend-mode: multiply;
+	}
+	:global([data-edytor-find-match][data-current]) {
+		background: var(--edytor-find-current, rgb(255 166 0 / 0.55));
+	}
+	:global([data-edytor-suggestion-range]) {
+		background: var(--edytor-suggestion-removed, rgb(235 87 87 / 0.18));
+		border-bottom: 1px solid var(--edytor-suggestion-removed-line, rgb(235 87 87 / 0.6));
+	}
+	:global([data-edytor-comment-draft]) {
+		background: var(--edytor-comment-active, rgb(255 212 0 / 0.42));
+		mix-blend-mode: multiply;
+	}
+</style>

package/dist/components/Ranges.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { PresencePoint } from '../collaboration/awarenessSelection.js';
+import type { Edytor } from '../edytor.svelte.js';
+/** A run of text the overlay marks: its ends, and whether it is the current one (`data-current`). */
+export type MarkedRange = {
+    start: PresencePoint;
+    end: PresencePoint;
+    current?: boolean;
+};
+/** The run of `length` at block offset `offset` of block `id` (none where it is not shown). */
+export declare const runOf: (edytor: Edytor, id: string, offset: number, length: number, current?: boolean) => MarkedRange[];
+type $$ComponentProps = {
+    edytor: Edytor;
+    name: string;
+    z: number;
+    ranges: () => MarkedRange[];
+};
+declare const Ranges: import("svelte").Component<$$ComponentProps, {}, "">;
+type Ranges = ReturnType<typeof Ranges>;
+export default Ranges;

package/dist/components/Suggestion.svelte

@@ -3,6 +3,7 @@
 	import type { Edytor } from '../edytor.svelte.js';
 	import type { Suggestion } from '../session/suggestions.svelte.js';
 	import { previewCells } from '../surface/cells.js';
+	import { editorEnglish, labelsOf } from '../labels.js';
 	import Block from './Block.svelte';
 
 	/**
@@ -28,12 +29,12 @@
 	data-edytor-suggestion={suggestion.id}
 	data-status={suggestion.status}
 	contenteditable="false"
-	aria-label={suggestion.label ?? edytor.labels.suggestion}
+	aria-label={suggestion.label ?? labelsOf(edytor, 'editor', editorEnglish).suggestion}
 	role="group"
 	use:edytor.surface.preview={suggestion.id}
 	onmousedown={cancel}
 >
-	{#each cells as cell (cell.id)}<Block id={cell.id} preview={cell} />{/each}
+	{#each cells as cell (cell.id)}<Block kid={cell} />{/each}
 </div>
 
 <style>

package/dist/components/Text.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import { getContext } from 'svelte';
 	import type { Edytor } from '../edytor.svelte.js';
-	import type { RenderDelta } from '../surface/cells.js';
+	import { rendersMark, type RenderDelta } from '../surface/cells.js';
 	import { Text } from '../text/text.svelte.js';
 	import Mark, { customAt } from './Mark.svelte';
 	import CustomMark from './CustomMark.svelte';
@@ -61,10 +61,7 @@
 
 	/** A delta's marks this view renders (an unknown mark renders its text only). */
 	const rendered = (delta: RenderDelta): RenderDelta => {
-		const known = delta.marks.filter(([name]) => {
-			const definition = edytor.marks.get(name);
-			return Boolean(definition?.snippet || definition?.tag);
-		});
+		const known = delta.marks.filter(([name]) => rendersMark(edytor.marks, name));
 		return known.length === delta.marks.length ? delta : { text: delta.text, marks: known };
 	};
 	const shown = $derived(empty ? FILLER : deltas);

package/dist/components/Text.svelte.d.ts

@@ -1,4 +1,4 @@
-import type { RenderDelta } from '../surface/cells.js';
+import { type RenderDelta } from '../surface/cells.js';
 import { Text } from '../text/text.svelte.js';
 type $$ComponentProps = {
     text: Text | undefined;

package/dist/crdt/admission.d.ts

@@ -5,8 +5,7 @@
  * gate here, in the same order, with the same refusal semantics:
  *
  *   1. **`assertUsableDoc`** — is this a v14 engine doc at all
- *      ({@link UnsupportedDocError} `'foreign'`), and is it a v13-era
- *      layout that must be migrated rather than adopted (`'legacy'`)?
+ *      ({@link UnsupportedDocError} `'foreign'`)?
  *   2. **`assertSchema`** — does the committed schema manifest allow
  *      this build to own the doc ({@link SchemaMismatchError}:
  *      `'unversioned'` content with no version stamp, `'unsupported'`
@@ -43,8 +42,6 @@
  *                             from the engine's pending store         pending store discarded; a
  *                                                                      stamp that got in anyway (raw
  *                                                                      apply) makes the doc read-only
- *   v13 migration             `bindLegacyReader` gate → rebuild via    legacy DB byte-identical; no
- *                             document-level `init` → `loadDocument`   v14 generation activated
  *
  * TWO LAYERS. The transport layer (`providers/*`, `protocols/*`) proves
  * the generation of every frame and container and refuses updates that
@@ -108,8 +105,6 @@ export declare class UndecodableUpdateError extends Error {
  * - {@link UnsupportedDocError} `'foreign'` — not a v14 engine doc
  *   (foreign roots/engines may still attach *content* later; this is
  *   about doc shape);
- * - {@link UnsupportedDocError} `'legacy'` — v13-era layout present;
- *   route through `crdt/migration` instead of attaching;
  * - {@link SchemaMismatchError} `'unversioned' | 'unsupported' |
  *   'foreign'` — a schema claim this build cannot own.
  *
@@ -137,9 +132,7 @@ export declare const bindAdmission: (Y: EngineApi) => {
      * Throws {@link UndecodableUpdateError} for payloads that fail to
      * decode/integrate at all, then the usual typed refusals.
      */
-    admitUpdate: (update: Uint8Array | ReadonlyArray<Uint8Array | {
-        v2: Uint8Array;
-    }>, docName?: string, options?: {
+    admitUpdate: (update: Uint8Array | ReadonlyArray<Uint8Array>, docName?: string, options?: {
         /** Prepare the scratch doc before anything is applied (e.g. its `gcFilter`). */
         prepare?: (doc: YDoc) => void;
     }) => YDoc;

package/dist/crdt/admission.js

@@ -5,8 +5,7 @@
  * gate here, in the same order, with the same refusal semantics:
  *
  *   1. **`assertUsableDoc`** — is this a v14 engine doc at all
- *      ({@link UnsupportedDocError} `'foreign'`), and is it a v13-era
- *      layout that must be migrated rather than adopted (`'legacy'`)?
+ *      ({@link UnsupportedDocError} `'foreign'`)?
  *   2. **`assertSchema`** — does the committed schema manifest allow
  *      this build to own the doc ({@link SchemaMismatchError}:
  *      `'unversioned'` content with no version stamp, `'unsupported'`
@@ -43,8 +42,6 @@
  *                             from the engine's pending store         pending store discarded; a
  *                                                                      stamp that got in anyway (raw
  *                                                                      apply) makes the doc read-only
- *   v13 migration             `bindLegacyReader` gate → rebuild via    legacy DB byte-identical; no
- *                             document-level `init` → `loadDocument`   v14 generation activated
  *
  * TWO LAYERS. The transport layer (`providers/*`, `protocols/*`) proves
  * the generation of every frame and container and refuses updates that
@@ -92,8 +89,6 @@ export class UndecodableUpdateError extends Error {
  * - {@link UnsupportedDocError} `'foreign'` — not a v14 engine doc
  *   (foreign roots/engines may still attach *content* later; this is
  *   about doc shape);
- * - {@link UnsupportedDocError} `'legacy'` — v13-era layout present;
- *   route through `crdt/migration` instead of attaching;
  * - {@link SchemaMismatchError} `'unversioned' | 'unsupported' |
  *   'foreign'` — a schema claim this build cannot own.
  *
@@ -138,10 +133,9 @@ export const bindAdmission = (Y) => ({
     admitUpdate: (update, docName = 'loaded document', options = {}) => {
         const doc = keepingReplaced(new Y.Doc());
         options.prepare?.(doc);
-        const apply = (part) => part instanceof Uint8Array ? Y.applyUpdate(doc, part) : Y.applyUpdateV2(doc, part.v2);
+        const apply = (part) => Y.applyUpdate(doc, part);
         try {
-            // Several updates (`{ v2 }`: in the v2 encoding) are applied in one
-            // transaction, with no merge pass.
+            // Several updates are applied in one transaction, with no merge pass.
             if (update instanceof Uint8Array)
                 apply(update);
             else