edytor 5.0.0 → 6.0.0

package/dist/plugins/richtext/RichTextPlugin.svelte

@@ -1,6 +1,11 @@
 <script module lang="ts">
 	import './richtext.css';
-	import type { Plugin, BlockSnippetPayload, KindPreset, PlaceholderView } from '../../plugins.js';
+	import type {
+		Plugin,
+		BlockDefinition,
+		BlockSnippetPayload,
+		PlaceholderView
+	} from '../../plugins.js';
 	import { branded } from '../brand.js';
 	import type { Edytor } from '../../edytor.svelte.js';
 	import { presetId } from '../../kinds.js';
@@ -191,11 +196,15 @@
 		let retyping: string | null = null;
 		/** The disclosures this view created, opened once drawn (`onBlockAttached`). */
 		const opening = new Set<string>();
-		const presets = (type: string, rows: KindPreset[]) =>
-			rows.map((row, index) => {
-				const own = keywordsOf(edytor, presetId(type, index, rows.length), row.keywords);
-				return own ? { ...row, keywords: own } : row;
-			});
+		/** Each kind's presets, their keywords the view's (`labels`) where it names some. */
+		const named = (blocks: Record<string, BlockDefinition>) => {
+			for (const [type, kind] of Object.entries(blocks))
+				kind.presets = kind.presets?.map((row, index, rows) => {
+					const own = keywordsOf(edytor, presetId(type, index, rows.length), row.keywords);
+					return own ? { ...row, keywords: own } : row;
+				});
+			return blocks;
+		};
 		const operations = richTextOperations(edytor);
 		/** The space an autolink types itself: its own insertion is not looked at again. */
 		let autolinking = false;
@@ -395,62 +404,57 @@
 					])
 				)
 			},
-			blocks: {
+			blocks: named({
 				paragraph: {
 					snippet: paragraph,
-					presets: presets('paragraph', [
-						{ label: kinds.paragraph, icon: 'T', keywords: ['paragraph', 'plain'] }
-					])
+					presets: [{ label: kinds.paragraph, icon: 'T', keywords: ['paragraph', 'plain'] }]
 				},
 				heading: {
 					...headingRead,
 					...headingWrite,
 					snippet: textThenChildren,
-					presets: presets(
-						'heading',
-						HEADING_LEVELS.map((level, index) => ({
-							label: [kinds.heading1, kinds.heading2, kinds.heading3][index]!,
-							icon: `H${['₁', '₂', '₃'][index]}`,
-							keywords: [level, ...[['title'], ['subtitle'], []][index]!],
-							data: { level },
-							markdown: [`${'#'.repeat(index + 1)} `]
-						}))
-					)
+					presets: HEADING_LEVELS.map((level, index) => ({
+						label: [kinds.heading1, kinds.heading2, kinds.heading3][index]!,
+						icon: `H${['₁', '₂', '₃'][index]}`,
+						keywords: [level, ...[['title'], ['subtitle'], []][index]!],
+						data: { level },
+						markdown: [`${'#'.repeat(index + 1)} `]
+					}))
 				},
 				'bulleted-list-item': {
 					...itemRead,
 					...itemWrite,
 					continues: true,
 					snippet: listItem,
-					presets: presets('bulleted-list-item', [
+					presets: [
 						{
 							label: kinds.bulletedList,
 							icon: '•',
 							keywords: ['bullet', 'ul'],
 							markdown: ['- ', '* ', '+ ']
 						}
-					])
+					]
 				},
 				'numbered-list-item': {
 					...numberedRead,
 					...itemWrite,
 					continues: true,
 					snippet: listItem,
-					presets: presets('numbered-list-item', [
+					presets: [
 						{
 							label: kinds.numberedList,
 							icon: '1.',
 							keywords: ['number', 'ol'],
 							markdown: ['1. ', 'a. ', 'i. ']
 						}
-					])
+					]
 				},
 				'todo-item': {
 					...todoWrite,
 					continues: true,
 					// The app's control markup, if any, through its own snippet: the default costs no branch.
 					snippet: checkbox ? todoItemOwn : todoItem,
-					presets: presets('todo-item', [
+					presets: [
 						{
 							label: kinds.todoList,
 							icon: '☐',
@@ -458,7 +462,7 @@
 							data: { checked: false },
 							markdown: ['[ ] ', '[] ']
 						}
-					])
+					]
 				},
 				toggle: {
 					...toggleRead,
@@ -466,14 +470,14 @@
 					container: true,
 					snippet: emptyBody ? detailsOwn : details,
 					...disclosure,
-					presets: presets('toggle', [
+					presets: [
 						{
 							label: kinds.toggleList,
 							icon: '▸',
 							keywords: ['details', 'expand'],
 							markdown: ['> ']
 						}
-					])
+					]
 				},
 				// Notion's toggle headings: a heading's text as a toggle's header over its
 				// children. From a heading, `>` + space at its start makes it one (its level
@@ -485,23 +489,20 @@
 					container: true,
 					snippet: emptyBody ? detailsOwn : details,
 					...disclosure,
-					presets: presets(
-						'toggle-heading',
-						HEADING_LEVELS.map((level, index) => {
-							const hashes = '#'.repeat(index + 1);
-							return {
-								label: [kinds.toggleHeading1, kinds.toggleHeading2, kinds.toggleHeading3][index]!,
-								icon: `▸H${['₁', '₂', '₃'][index]}`,
-								keywords: ['toggle', 'heading', 'collapse'],
-								data: { level },
-								markdownFrom: {
-									heading: ['> '],
-									toggle: [`${hashes} `],
-									'toggle-heading': [`${hashes} `]
-								}
-							};
-						})
-					)
+					presets: HEADING_LEVELS.map((level, index) => {
+						const hashes = '#'.repeat(index + 1);
+						return {
+							label: [kinds.toggleHeading1, kinds.toggleHeading2, kinds.toggleHeading3][index]!,
+							icon: `▸H${['₁', '₂', '₃'][index]}`,
+							keywords: ['toggle', 'heading', 'collapse'],
+							data: { level },
+							markdownFrom: {
+								heading: ['> '],
+								toggle: [`${hashes} `],
+								'toggle-heading': [`${hashes} `]
+							}
+						};
+					})
 				},
 				// Notion's callout: an icon (`data.icon`, the picker's), a title (its own
 				// text) and a content (its children, any blocks), which shows even empty
@@ -511,9 +512,7 @@
 					container: true,
 					body: true,
 					snippet: calloutIcon || emptyBody ? calloutOwn : callout,
-					presets: presets('callout', [
-						{ label: kinds.callout, icon: '✦', keywords: ['note', 'tip'], data: { icon } }
-					]),
+					presets: [{ label: kinds.callout, icon: '✦', keywords: ['note', 'tip'], data: { icon } }],
 					// A callout without its own icon exports the view's.
 					...calloutWrite((data) => iconOf(data, edytor)),
 					// The block menu's Change icon, while the view lists a picker: the keyboard's way to it.
@@ -537,15 +536,15 @@
 					container: true,
 					snippet: textThenChildren,
 					// Notion: `"` + space is a quote; `>` + space is a toggle.
-					presets: presets('quote', [{ label: kinds.quote, icon: '❝', markdown: ['" '] }])
+					presets: [{ label: kinds.quote, icon: '❝', markdown: ['" '] }]
 				},
 				divider: {
 					...richTextKinds.divider,
 					...dividerRead,
 					...dividerWrite,
-					presets: presets('divider', [
+					presets: [
 						{ label: kinds.divider, icon: '—', keywords: ['hr', 'separator'], markdown: ['---'] }
-					]),
+					],
 					empty: { content: [], children: [] }
 				},
 				'ordered-list': {
@@ -561,7 +560,7 @@
 					snippet: list
 				},
 				'list-item': { ...itemRead, ...itemWrite, snippet: listItem }
-			}
+			})
 		};
 	};
 </script>
@@ -575,10 +574,13 @@
 	nested snippet or a text node between tags is one more node per block for
 	the browser to walk (`render.markers`).
 -->
+<!-- prettier-ignore -->
+{#snippet nested(children: Snippet)}<div data-edytor-children>{@render children()}</div>{/snippet}
+
 <!-- prettier-ignore -->
 {#snippet paragraph({ content, children }: BlockSnippetPayload)}<!--
 --><p>{@render content()}</p><!--
--->{#if children}<div data-edytor-children>{@render children()}</div>{/if}<!--
+-->{#if children}{@render nested(children)}{/if}<!--
 -->{/snippet}
 
 <!--
@@ -588,7 +590,7 @@
 <!-- prettier-ignore -->
 {#snippet details({ block, content, children }: BlockSnippetPayload)}<!--
 --><summary>{@render content()}</summary><!--
--->{#if children}<div data-edytor-children>{@render children()}</div><!--
+-->{#if children}{@render nested(children)}<!--
 -->{:else}<EmptyBody {block} kind="toggle" />{/if}<!--
 -->{/snippet}
 
@@ -600,7 +602,7 @@
 <!-- prettier-ignore -->
 {#snippet textThenChildren({ content, children }: BlockSnippetPayload)}<!--
 -->{@render content()}<!--
--->{#if children}<div data-edytor-children>{@render children()}</div>{/if}<!--
+-->{#if children}{@render nested(children)}{/if}<!--
 -->{/snippet}
 
 <!--
@@ -611,7 +613,7 @@
 {#snippet callout({ block, content, children }: BlockSnippetPayload<{ icon?: string }>)}<!--
 --><CalloutIcon {block} /><!--
 --><div data-edytor-callout-title>{@render content()}</div><!--
--->{#if children}<div data-edytor-children>{@render children()}</div><!--
+-->{#if children}{@render nested(children)}<!--
 -->{:else}<EmptyBody {block} kind="callout" />{/if}<!--
 -->{/snippet}
 
@@ -619,7 +621,7 @@
 {#snippet todoItem({ block, content, children }: BlockSnippetPayload<{ checked?: boolean }>)}<!--
 --><TodoCheckbox {block} /><!--
 --><div>{@render content()}</div><!--
--->{#if children}<div data-edytor-children>{@render children()}</div>{/if}<!--
+-->{#if children}{@render nested(children)}{/if}<!--
 -->{/snippet}
 
 <!--
@@ -630,13 +632,13 @@
 {#snippet todoItemOwn({ block, content, children }: BlockSnippetPayload<{ checked?: boolean }>)}<!--
 --><RichTextControl {block} control="checkbox" /><!--
 --><div>{@render content()}</div><!--
--->{#if children}<div data-edytor-children>{@render children()}</div>{/if}<!--
+-->{#if children}{@render nested(children)}{/if}<!--
 -->{/snippet}
 
 <!-- prettier-ignore -->
 {#snippet detailsOwn({ block, content, children }: BlockSnippetPayload)}<!--
 --><summary>{@render content()}</summary><!--
--->{#if children}<div data-edytor-children>{@render children()}</div><!--
+-->{#if children}{@render nested(children)}<!--
 -->{:else}<RichTextControl {block} control="toggle" />{/if}<!--
 -->{/snippet}
 
@@ -644,14 +646,14 @@
 {#snippet calloutOwn({ block, content, children }: BlockSnippetPayload<{ icon?: string }>)}<!--
 --><RichTextControl {block} control="calloutIcon" /><!--
 --><div data-edytor-callout-title>{@render content()}</div><!--
--->{#if children}<div data-edytor-children>{@render children()}</div><!--
+-->{#if children}{@render nested(children)}<!--
 -->{:else}<RichTextControl {block} control="callout" />{/if}<!--
 -->{/snippet}
 
 <!-- prettier-ignore -->
 {#snippet listItem({ content, children }: BlockSnippetPayload)}<!--
 --><div>{@render content()}</div><!--
--->{#if children}<div data-edytor-children>{@render children()}</div>{/if}<!--
+-->{#if children}{@render nested(children)}{/if}<!--
 -->{/snippet}
 
 <!--

package/dist/plugins/richtext/richTextOperations.js

@@ -74,9 +74,11 @@ export const openLink = (href, view = globalThis.window ?? null) => {
     if (safe)
         view?.open(safe, '_blank', 'noopener,noreferrer');
 };
+/** A mark's value as written: `true` when none is given. */
+const markValue = (value) => value === undefined ? true : value;
 /** Set `mark` to `value` (`null`: remove it) over `start`–`end` of `text`: the view's `formatRange`. */
 const markText = (edytor, text, start, end, mark, value) => edytor.formatRange(text.parent.id, text.segStart + start, end - start, {
-    [mark]: value === undefined ? true : value
+    [mark]: markValue(value)
 });
 const formatSelectedTextRange = (edytor, mark, value, toggle) => {
     const { yStart, yEnd, startText, endText } = edytor.selection.textRange();
@@ -87,7 +89,7 @@ const formatSelectedTextRange = (edytor, mark, value, toggle) => {
     // One decision for the whole range (Notion): a toggle removes the mark only
     // when every selected character has it, else it marks all of them.
     const on = spans.every(({ text, start, end }) => text.getMarksAtRange(start, end).every(({ marks }) => marks && mark in marks));
-    const next = toggle && on ? null : value === undefined ? true : value;
+    const next = toggle && on ? null : markValue(value);
     // One command per span: a vetoed one keeps its marks (`dispatcher.each`).
     edytor.dispatcher.each('format', spans, ({ text, start, end }) => edytor.formatRange(text.parent.id, text.segStart + start, end - start, { [mark]: next }));
     // Selected blocks stay selected (Notion; a divider's phantom text is no range).
@@ -99,6 +101,23 @@ const formatSelectedTextRange = (edytor, mark, value, toggle) => {
  * mark at (a lone selected divider's text is a phantom).
  */
 const selectsBlocks = (edytor) => edytor.selection.value.kind === 'blocks';
+/**
+ * At a caret (no block selection: a lone divider's text is a phantom),
+ * stage what `next` makes of the full set the next insertion carries
+ * (values kept), as a `format` command, and keep the caret; `false` over a
+ * range.
+ */
+const stageAtCaret = (edytor, next) => {
+    const { startText, yStart } = edytor.selection.textRange();
+    const { selection } = edytor;
+    if (!selection.projection.isCollapsed)
+        return false;
+    if (startText && !selectsBlocks(edytor)) {
+        edytor.dispatcher.run('format', () => selection.stage(next(marksForInsertion(startText, yStart, { pending: selection.pending }))));
+        selection.selectText(startText, yStart);
+    }
+    return true;
+};
 export const richTextOperations = (edytor) => ({
     /**
      * Insert a `divider` void block at the caret — the native
@@ -210,20 +229,8 @@ export const richTextOperations = (edytor) => ({
         const safeValue = mark === 'color' || mark === 'highlight' ? sanitizeCssColorValue(value) : value;
         if (safeValue === null)
             return;
-        const { startText, yStart } = edytor.selection.textRange();
-        const { isCollapsed } = edytor.selection.projection;
-        if (isCollapsed) {
-            if (startText && !selectsBlocks(edytor)) {
-                // Stage the full set the next insertion carries, values kept.
-                edytor.dispatcher.run('format', () => edytor.selection.stage({
-                    ...marksForInsertion(startText, yStart, { pending: edytor.selection.pending }),
-                    [mark]: safeValue
-                }));
-                edytor.selection.selectText(startText, yStart);
-            }
-            return;
-        }
-        formatSelectedTextRange(edytor, mark, safeValue, false);
+        if (!stageAtCaret(edytor, (marks) => ({ ...marks, [mark]: safeValue })))
+            formatSelectedTextRange(edytor, mark, safeValue, false);
     },
     /**
      * Toggle `mark` (any mark the editor defines: the rich text ones are
@@ -231,21 +238,8 @@ export const richTextOperations = (edytor) => ({
      * stage it for the next character typed.
      */
     setMarkAtRange: (mark, value) => {
-        const { yStart, yEnd, startText, endText } = edytor.selection.textRange();
-        const { selection } = edytor;
-        if (selection.projection.isCollapsed) {
-            if (startText && !selectsBlocks(edytor)) {
-                // A caret stages the full set the next insertion carries (values kept).
-                edytor.dispatcher.run('format', () => {
-                    const { [mark]: current = null, ...rest } = marksForInsertion(startText, yStart, {
-                        pending: selection.pending
-                    });
-                    selection.stage(current !== null ? rest : { ...rest, [mark]: value === undefined ? true : value });
-                });
-                selection.selectText(startText, yStart, endText, yEnd);
-            }
-            return;
-        }
-        formatSelectedTextRange(edytor, mark, value, true);
+        const toggled = ({ [mark]: current = null, ...rest }) => current !== null ? rest : { ...rest, [mark]: markValue(value) };
+        if (!stageAtCaret(edytor, toggled))
+            formatSelectedTextRange(edytor, mark, value, true);
     }
 });

package/dist/selection/selection.utils.js

@@ -1,4 +1,4 @@
-import { getTextContentOffsetAtPoint } from '../events/domTextOffset.js';
+import { getTextContentOffsetAtPoint, textLeaves } from '../events/domTextOffset.js';
 const TRAILING_NEWLINE_SELECTOR = '[data-edytor-trailing-newline]';
 export const SYNTHETIC_TEXT_OVERLAY_SELECTOR = '[data-edytor-text-suggestion]';
 /** A block suggestion's preview group: view-only, never a selection endpoint (`session/suggestions`). */
@@ -180,13 +180,10 @@ export const getInlineBlockInSelectedRange = (edytor, range) => {
  * point, outside when one does not; `undefined` when that character has none.
  */
 export const getMarkEdgeSide = (text, node, offset) => {
-    const walker = text.node?.ownerDocument.createTreeWalker(text.node, NodeFilter.SHOW_TEXT);
-    let leaf = null;
-    for (let start = 0; node && offset > 0 && (leaf = walker?.nextNode());) {
-        start += leaf.textContent?.length ?? 0;
-        if (offset <= start)
-            break;
-    }
+    let start = 0;
+    const leaf = node && offset > 0 && text.node
+        ? textLeaves(text.node).find((l) => offset <= (start += l.length))
+        : undefined;
     let side;
     for (let element = leaf?.parentElement; element && element !== text.node;) {
         if (element.hasAttribute('data-edytor-mark'))

package/dist/session/handles.js

@@ -16,6 +16,7 @@ import { Block } from '../block/block.svelte.js';
 import { InlineBlock } from '../block/inlineBlock.svelte.js';
 import { Text } from '../text/text.svelte.js';
 import { partsOf } from '../crdt/parts.js';
+import { getOr } from '../utils.js';
 /**
  * A text segment's items as `JSONText` runs (`text.value`): empty items
  * dropped, adjacent runs with the same marks joined, each run's marks a
@@ -61,10 +62,7 @@ export class Handles {
     block = (id) => {
         if (id === 'root')
             return this.root;
-        let block = this.#blocks.get(id);
-        if (!block)
-            this.#blocks.set(id, (block = new Block(this.edytor, id)));
-        return block;
+        return getOr(this.#blocks, id, () => new Block(this.edytor, id));
     };
     /** The handle of live block `id`; none for a dead or unknown id. */
     get = (id) => id === 'root' || (id && this.edytor.facade.isVisibleBlock(id)) ? this.block(id) : undefined;
@@ -84,9 +82,7 @@ export class Handles {
     };
     /** The handle of atom `atomId`, shown in block `blockId`. */
     atom = (blockId, atomId) => {
-        let atom = this.#atoms.get(atomId);
-        if (!atom)
-            this.#atoms.set(atomId, (atom = new InlineBlock(this.edytor, blockId, atomId)));
+        const atom = getOr(this.#atoms, atomId, () => new InlineBlock(this.edytor, blockId, atomId));
         atom.blockId = blockId;
         return atom;
     };

package/dist/surface/observer.svelte.js

@@ -45,7 +45,7 @@ import { runOccurrence } from '../events/onBeforeInput.js';
 import { getDomSelectionSnapshot } from '../selection/domSelection.js';
 import { domOffsetIn } from '../selection/selection.utils.js';
 import { diverges, heal, ownedOf } from './attributes.js';
-import { getTextContentOffsetAtPoint } from '../events/domTextOffset.js';
+import { getTextContentOffsetAtPoint, textLeaves } from '../events/domTextOffset.js';
 import { rendersMark } from './cells.js';
 const ZWSP = /\u200B/g;
 const ATOM = '\uFFFC';
@@ -73,13 +73,7 @@ const textOf = (cell) => cell.runs
 /** Svelte's anchors: comments and empty text nodes are never input and never removed. */
 const isAnchor = (node) => node.nodeType === Node.COMMENT_NODE || (node.nodeType === Node.TEXT_NODE && !node.nodeValue);
 /** The `nth` non-empty text node under `node`. */
-const textLeaf = (node, nth = 0) => {
-    const walker = (node.ownerDocument ?? document).createTreeWalker(node, NodeFilter.SHOW_TEXT);
-    while (walker.nextNode())
-        if (walker.currentNode.data && nth-- === 0)
-            return walker.currentNode;
-    return null;
-};
+const textLeaf = (node, nth = 0) => textLeaves(node).filter((leaf) => leaf.data)[nth] ?? null;
 const ZERO_WIDTH_SPACE = '\u200B';
 /**
  * What the browser shows for `text`: its element's text nodes in order (WebKit's
@@ -89,15 +83,10 @@ const ZERO_WIDTH_SPACE = '\u200B';
 export const readDomText = (text) => {
     let value = '';
     const node = text.node;
-    if (node) {
-        const walker = (node.ownerDocument ?? document).createTreeWalker(node, NodeFilter.SHOW_TEXT);
-        while (walker.nextNode()) {
-            const leaf = walker.currentNode;
-            value += leaf.parentElement?.closest('span.Apple-converted-space')
-                ? leaf.data.replaceAll('\u00A0', ' ')
-                : leaf.data;
-        }
-    }
+    for (const leaf of node ? textLeaves(node) : [])
+        value += leaf.parentElement?.closest('span.Apple-converted-space')
+            ? leaf.data.replaceAll('\u00A0', ' ')
+            : leaf.data;
     // An empty text's filler shares its node with what the browser typed, on either side.
     if (text.isEmpty)
         return value.replaceAll(ZERO_WIDTH_SPACE, '');
@@ -968,21 +957,17 @@ const shownMarks = (text, at) => {
     const element = text.node;
     if (!element)
         return null;
-    const walker = element.ownerDocument.createTreeWalker(element, NodeFilter.SHOW_TEXT);
     let offset = 0;
-    for (let node = walker.nextNode(); node; node = walker.nextNode()) {
-        offset += node.data.replace(ZWSP, '').length;
-        if (offset <= at)
-            continue;
-        const names = [];
-        for (let el = node.parentElement; el && el !== element; el = el.parentElement) {
-            const name = el.getAttribute('data-edytor-mark');
-            if (name)
-                names.push(name);
-        }
-        return names.sort().join();
+    const node = textLeaves(element).find((leaf) => (offset += leaf.data.replace(ZWSP, '').length) > at);
+    if (!node)
+        return null;
+    const names = [];
+    for (let el = node.parentElement; el && el !== element; el = el.parentElement) {
+        const name = el.getAttribute('data-edytor-mark');
+        if (name)
+            names.push(name);
     }
-    return null;
+    return names.sort().join();
 };
 /** The rendered marks the model gives the character at `at` of `text`. */
 const modelMarks = (edytor, text, at) => Object.keys(activeMarks(text.getMarksAtRange(at, at + 1)[0]?.marks))

package/dist/surface/projector.svelte.js

@@ -44,6 +44,7 @@ import { getMarkEdgeSide, getYIndex, isTextBoundSelectionPoint } from '../select
 import { project, sameEnds } from '../session/selection.js';
 import { isAndroidChromeBrowser } from '../events/events.utils.js';
 import { isKindControl, isOwnPoint } from '../events/nativeInteractiveControl.js';
+import { textLeaves } from '../events/domTextOffset.js';
 /**
  * Named rule: Android Chrome mutates the DOM after a
  * canceled `deleteContentBackward` and reports the caret one position right
@@ -54,9 +55,8 @@ const ANDROID_SNAP_BACK_MS = 250;
 const IME_POST_COMMIT_JUMP_MS = 100;
 /** The DOM point of a text-segment offset: its text leaf, else the element itself. */
 export const domPointOf = (element, offset) => {
-    const walker = element.ownerDocument.createTreeWalker(element, NodeFilter.SHOW_TEXT);
     let at = 0;
-    for (let leaf = walker.nextNode(); leaf; leaf = walker.nextNode()) {
+    for (const leaf of textLeaves(element)) {
         const end = at + leaf.length;
         if (offset <= end)
             return [leaf, offset - at];

package/dist/utils.d.ts

@@ -1,4 +1,9 @@
 export declare const id: (prefix: "t" | "b" | "i" | "v" | "s" | "c") => string;
+/** `key`'s value in `map`, made (`make`) and stored when it holds none. */
+export declare const getOr: <K, V>(map: {
+    get(key: K): V | undefined;
+    set(key: K, value: V): unknown;
+}, key: K, make: () => V) => V;
 /**
  * A hook's veto as the dispatcher carries it: what `prevent(cb?)` recorded,
  * and the extension that recorded it. Hooks never see one thrown at them:

package/dist/utils.js

@@ -6,6 +6,13 @@ export const id = (prefix) => {
         t += alphabet[61 & r[n]];
     return `${prefix}_${t}`;
 };
+/** `key`'s value in `map`, made (`make`) and stored when it holds none. */
+export const getOr = (map, key, make) => {
+    let value = map.get(key);
+    if (value === undefined)
+        map.set(key, (value = make()));
+    return value;
+};
 /**
  * A hook's veto as the dispatcher carries it: what `prevent(cb?)` recorded,
  * and the extension that recorded it. Hooks never see one thrown at them:

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "edytor",
 	"license": "MIT",
-	"version": "5.0.0",
+	"version": "6.0.0",
 	"repository": {
 		"type": "git",
 		"url": "git+https://github.com/beynar/edytor.git"

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

@@ -1,56 +0,0 @@
-/**
- * Structural capability: one answer in advance and at execution.
- *
- * ── Island/void enforcement (operation-layer, not stored) ──────────────
- *
- * Roles are resolved operation-time via `config.roleOf(type)`, through one
- * role table (`DisplayRoles`) that the index's display and every guard
- * below ask of a block's shown kind — the editor derives them from plugin
- * block definitions, exactly like the baseline's
- * `block.definition.island/void`. They are deliberately NOT replicated block
- * data: the schema stays policy-free, and a replica with different plugins
- * reads the same document. Enforced rules (baseline semantics, see
- * `plugins.ts` + `block.utils.ts`):
- *
- * - `void`: cannot accept children (insert/move/nest into void rejected),
- *   cannot merge either direction, cannot be split. Content edits ARE
- *   allowed — void rendered content (captions) stays editable per the
- *   baseline contract. Deletion is allowed (delete is not editing).
- * - `island`: editable content, but its subtree is structurally sealed —
- *   a block inside an island (`insideIsland`) cannot be moved, nested,
- *   unnested, or merged across the island boundary. Merges INSIDE one
- *   island are allowed; merging an island child into the island itself is
- *   allowed when the island renders its content. Moving or merging
- *   INTO an island subtree is rejected. An island declared `lines` (code)
- *   holds only lines of its `defaultChild` kind, and a line holds no
- *   children (the display enforces it against undo,
- *   `insertBlocks` refuses a line parent); any other island keeps its
- *   structure. `canPlace` and `canMerge` are the one answer, asked in
- *   advance or by the ops.
- * - Island merge: when an island block itself is merged (backward or
- *   forward), its children are unnested to the vacated sibling slot and
- *   reset to the default child of that slot's parent (`defaultChild`).
- * - Baseline merges NEVER adopt the merged block's children — they unnest
- *   to the vacated slot. The facade exposes both: `mergeBlocks` is the
- *   engine primitive (children adopt into the target
- *   by staying under the source, which the target's claim displays),
- *   `mergeBackward`/`mergeForward` reproduce the baseline command shape.
- *
- */
-import { type BlockId } from '../placement/model.js';
-import type { DocBase, DocReads } from './reads.js';
-/** The capability of the facade over its reads. */
-export declare const docCapability: (c: DocBase & DocReads) => {
-    canPlace: (ids: readonly BlockId[], parent?: BlockId | null, kindOf?: (id: BlockId) => string | undefined) => boolean;
-    isContainer: (id: BlockId) => boolean;
-    fits: (parent: BlockId | null, kind: string | undefined) => boolean;
-    fitsIn: (parentType: string, kind: string | undefined) => boolean;
-    fitted: (parent: BlockId | null, kind: string | undefined) => string | undefined;
-    emptiable: (id: BlockId) => boolean;
-    nestParent: (ids: readonly BlockId[], parent: BlockId) => BlockId;
-    canMerge: (fromId: BlockId, intoId: BlockId) => boolean;
-    rendersContent: (id: BlockId) => boolean;
-    defaultChild: (parent: BlockId | null) => string;
-    kindToCopy: (id: BlockId) => string;
-};
-export type DocCapability = ReturnType<typeof docCapability>;