edytor 1.0.0 → 3.0.0

package/dist/export/markdownWriter.js

@@ -0,0 +1,133 @@
+import { isTextPart } from '../block/contentRange.js';
+import { contentOf } from '../clipboard/serializeClipboardFragment.js';
+/** Characters markdown reads as syntax inside a line: escaped in exported text. */
+const MD_SPECIAL = /[\\`*_[\]~<]/g;
+/** A line start markdown reads as a block (a heading, a list item, a quote, a rule): escaped. */
+const MD_LINE_START = /^(\s*)(#{1,6}(?=\s|$)|[-+](?=\s)|\d+(?=[.)]\s)|>|=+\s*$|-{3,}\s*$)/;
+/** Text as markdown: its syntax characters escaped, a soft break a hard break (`\` + newline). */
+const escapeMarkdown = (text) => text.replace(MD_SPECIAL, (c) => `\\${c}`).replace(/\n/g, '\\\n');
+/** The delimiters a mark's value exports as, or none. */
+const delimitersOf = (mark, value) => typeof mark.markdown === 'function' ? mark.markdown(value) : mark.markdown;
+/** A code span's fence: one backtick more than the longest run inside it. */
+const codeFence = (text) => '`'.repeat(Math.max(0, ...[...text.matchAll(/`+/g)].map((m) => m[0].length)) + 1);
+/**
+ * Rich text as inline markdown. Marks open in their registration order
+ * reversed (the first registered innermost, as HTML wraps them), a mark
+ * spanning several runs opens once (`**a *b***`), a mark without a
+ * `markdown` form is left out, and a delimiter never sits on a space
+ * (`** x**` is no emphasis): the spaces move outside it.
+ */
+const inlineMarkdown = (content = [], kinds) => {
+    // A code span holds no markup: it opens last, innermost.
+    const order = [...kinds.marks.keys()]
+        .reverse()
+        .sort((a, b) => Number(a === 'code') - Number(b === 'code'));
+    /** The open marks, outermost first: name, value key and closing delimiter. */
+    const open = [];
+    let out = '';
+    const closeTo = (depth) => {
+        // A delimiter closes after the text's last non-space: trailing spaces move out.
+        const spaces = /[ \t]*$/.exec(out)[0];
+        out = out.slice(0, out.length - spaces.length);
+        while (open.length > depth)
+            out += open.pop().close;
+        out += spaces;
+    };
+    for (const part of content) {
+        if (!isTextPart(part)) {
+            closeTo(0);
+            const atom = kinds.inlineBlocks.get(part.type);
+            out += atom?.markdown?.(part.data) ?? escapeMarkdown(atom?.plain?.(part.data) ?? '');
+            continue;
+        }
+        const wanted = order
+            .map((name) => {
+            const mark = kinds.marks.get(name);
+            const value = part.marks?.[name];
+            const delimiters = value ? delimitersOf(mark, value) : undefined;
+            return delimiters && { name, key: JSON.stringify(value), delimiters };
+        })
+            .filter((m) => !!m);
+        // Keep the open marks this run still has, in order; close from the first it lacks.
+        let keep = 0;
+        while (keep < open.length &&
+            wanted.some((m) => m.name === open[keep].name && m.key === open[keep].key))
+            keep++;
+        // A mark opening inside an open code span would be literal: the span closes first.
+        const opening = wanted.some((m) => !open.slice(0, keep).some((o) => o.name === m.name));
+        const span = open.findIndex((m) => m.name === 'code');
+        if (opening && span !== -1 && span < keep)
+            keep = span;
+        closeTo(keep);
+        const code = wanted.some((m) => m.name === 'code');
+        const raw = part.text;
+        const lead = /^[ \t]*/.exec(raw)[0];
+        const body = raw.slice(lead.length);
+        out += lead;
+        if (!body)
+            continue;
+        for (const mark of wanted)
+            if (!open.some((m) => m.name === mark.name)) {
+                const [start, end] = mark.delimiters;
+                const fence = mark.name === 'code' ? codeFence(body) : '';
+                const pad = fence && /^`|`$/.test(body) ? ' ' : '';
+                out += fence ? fence + pad : start;
+                open.push({ name: mark.name, key: mark.key, close: fence ? pad + fence : end });
+            }
+        out += code ? body : escapeMarkdown(body);
+    }
+    closeTo(0);
+    return out;
+};
+/** Every line of `text` prefixed with `prefix` (an empty line with its trimmed form). */
+const indent = (text, prefix) => text
+    .split('\n')
+    .map((line) => (line ? prefix + line : prefix.trimEnd()))
+    .join('\n');
+/** A list item's markdown (`- `, `1. `, `- [ ] `): its block's first line starts one. */
+const LIST_LINE = /^(?:[-*+]|\d+[.)])\s/;
+/**
+ * Sibling blocks as markdown: a blank line between blocks, a single
+ * newline between items of one list (a tight list).
+ */
+const siblingsMarkdown = (blocks, kinds) => {
+    let out = '';
+    let previous = null;
+    let run = 0;
+    let type = null;
+    for (const block of blocks) {
+        run = block.type === type ? run + 1 : 1;
+        type = block.type;
+        const md = blockMarkdown(block, kinds, run);
+        if (!md)
+            continue;
+        if (previous !== null)
+            out += LIST_LINE.test(previous) && LIST_LINE.test(md) ? '\n' : '\n\n';
+        out += md;
+        previous = md;
+    }
+    return out;
+};
+/** A block and its subtree as markdown, by its kind's form. */
+const blockMarkdown = (block, kinds, index) => {
+    const kind = kinds.blocks.get(block.type);
+    const content = inlineMarkdown(block.content, kinds);
+    const children = siblingsMarkdown(block.children ?? [], kinds);
+    if (kind?.markdown) {
+        const context = {
+            index,
+            indent,
+            inline: (parts) => inlineMarkdown(parts, kinds)
+        };
+        return kind.markdown(block, content, children, context);
+    }
+    if (kind?.plain) {
+        const plain = kind.plain(block, contentOf(block.content, kinds, false), '');
+        return [plain && escapeMarkdown(plain), children].filter(Boolean).join('\n\n');
+    }
+    // A paragraph: its text, a leading block marker escaped (`\# not a heading`).
+    const text = content.replace(MD_LINE_START, (_, space, marker) => /^\d/.test(marker) ? `${space}${marker}\\` : `${space}\\${marker}`);
+    return [text, children].filter(Boolean).join('\n\n');
+};
+/** Blocks as markdown (`toMarkdown`), by each kind's, mark's and atom's `markdown` form. */
+export const blocksToMarkdown = (blocks, kinds) => siblingsMarkdown(blocks, kinds);

package/dist/export/mdx.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MDX-lite tags as markdown (`toMarkdown`): a block written as
+ * `<Name a="x" n={1} on={true} />`, the tag `fromMarkdown` reads back.
+ */
+import type { SerializableContent } from '../utils/json.js';
+/**
+ * A component tag, for a kind's `markdown` form: `mdxComponent('Endpoint',
+ * block.data, content, children)`. Each data value that has a literal is an
+ * attribute (a string `"x"`, a number `{1}`, a boolean `{true}`); others
+ * (objects, arrays, `null`, a string holding a newline or both quotes) are
+ * left out. No text and no children: a self-closing tag. Text only: the
+ * text inside the tag on one line. Children: the tag on its own lines, the
+ * text first (a paragraph), then the children.
+ */
+export declare const mdxComponent: (name: string, data?: Record<string, SerializableContent> | undefined, content?: string, children?: string) => string;

package/dist/export/mdx.js

@@ -0,0 +1,33 @@
+const ATTRIBUTE = /^[A-Za-z_][\w:-]*$/;
+/** A data value as an attribute, or `null` when MDX-lite has no literal for it. */
+const attribute = (name, value) => {
+    if (!ATTRIBUTE.test(name))
+        return null;
+    if (typeof value === 'boolean' || (typeof value === 'number' && Number.isFinite(value)))
+        return `${name}={${value}}`;
+    if (typeof value !== 'string' || /\n/.test(value))
+        return null;
+    if (!value.includes('"'))
+        return `${name}="${value}"`;
+    return value.includes("'") ? null : `${name}='${value}'`;
+};
+/**
+ * A component tag, for a kind's `markdown` form: `mdxComponent('Endpoint',
+ * block.data, content, children)`. Each data value that has a literal is an
+ * attribute (a string `"x"`, a number `{1}`, a boolean `{true}`); others
+ * (objects, arrays, `null`, a string holding a newline or both quotes) are
+ * left out. No text and no children: a self-closing tag. Text only: the
+ * text inside the tag on one line. Children: the tag on its own lines, the
+ * text first (a paragraph), then the children.
+ */
+export const mdxComponent = (name, data = {}, content = '', children = '') => {
+    const attributes = Object.entries(data)
+        .map(([key, value]) => attribute(key, value))
+        .filter((part) => part !== null);
+    const open = `<${[name, ...attributes].join(' ')}`;
+    if (!content && !children)
+        return `${open} />`;
+    if (!children)
+        return `${open}>${content}</${name}>`;
+    return `${open}>\n${[content, children].filter(Boolean).join('\n\n')}\n</${name}>`;
+};

package/dist/index.d.ts

@@ -35,17 +35,17 @@ export { InlineBlock } from './block/inlineBlock.svelte.js';
 export { Text } from './text/text.svelte.js';
 export type { BlockMoveDirection, BlockMovePosition, BlockMoveRequest } from './session/moves.js';
 export type { HotKey, HotKeyCombination } from './session/keymap.js';
-export type { Plugin, KindPreset, KindMenuAction, EditorCommand, BlockDefinition, MarkDefinition, InlineBlockDefinition, BlockSnippetPayload, MarkSnippetPayload, InlineBlockSnippetPayload, Placeholder, PlaceholderView, ChangePayload, Commands, AfterOperationPayload, Prevent, InputRule, InputRuleContext, Trigger, TriggerContext, TextRuleContext } from './plugins.js';
+export type { Plugin, KindPreset, KindMenuAction, EditorCommand, BlockDefinition, MarkdownContext, MarkDefinition, InlineBlockDefinition, BlockSnippetPayload, MarkSnippetPayload, InlineBlockSnippetPayload, Placeholder, PlaceholderView, ChangePayload, Commands, AfterOperationPayload, Prevent, InputRule, InputRuleContext, Trigger, TriggerContext, TextRuleContext } from './plugins.js';
 export type { Caret } from './selection/selection.svelte.js';
 export { PreventionError, isPrevention } from './utils.js';
 export type { CommandResult } from './session/commands.js';
 export { convertToKind, turnCommands, wrapBlocks, wrappable, type KindRow } from './kinds.js';
 export { textToBlocks, type TextToBlocksOptions } from './clipboard/textBlocks.js';
 export type { Suggestion, Suggestions, SuggestionAt, SuggestionContent, SuggestionOptions, SuggestionRange, SuggestionStatus, SuggestionsAt, ResolvedAt } from './session/suggestions.svelte.js';
-export { createRichTextPlugin, richTextOperations, richTextPlaceholder, CALLOUT_ICONS, createCalloutIconsPlugin, createUploadsPlugin, type UploadsOptions, type CalloutIconPicker, type CalloutIconsOptions, type RichTextPluginOptions, type TodoCheckboxPayload, type CalloutIconPayload, type EmptyBodyPayload, createArrowMovePlugin, createCodePlugin, CODE_LANGUAGES, loadCodeLanguage, type CodeLanguage, type CodePluginOptions, type CodeHeader, type LanguageMenu, type LanguageMenuItem, type LanguageRow, createMarkdownShortcutsPlugin, createMentionPlugin, type MentionItem, type MentionData, type MentionPluginOptions, createPageLinkPlugin, type PageLinkItem, type PageLinkData, type PageLinkPluginOptions, type TriggerMenuController, withRulesAndTriggers, BLOCK_ACTIVATE_EVENT, BLOCK_ADD_EVENT, type BlockActivation, type BlockAddition, createBlockHandlesPlugin, type BlockHandlesOptions, type BlockHandleSnippetPayload, type BlockHandleController, createSlashMenuPlugin, type SlashMenuOptions, type SlashMenuController, createToolbarPlugin, type ToolbarOptions, type ToolbarController, createBlockMenuPlugin, type BlockMenuOptions, type BlockMenuController, type BlockMenuAction, type BlockMenuColor, createSuggestionsPlugin, createSuggestionBarPlugin, type SuggestionBarOptions, type SuggestionBarPayload, createImagePlugin, safeImageSrc, storableImageSrc, MAX_INLINE_IMAGE_BYTES, createColumnsPlugin, type ColumnsPluginOptions, createEmbedPlugin, EMBED_PROVIDERS, EMBED_SANDBOX, EMBED_ALLOW, embedSourceOf, type EmbedProvider, type EmbedPluginOptions, type EmbedFallbackPayload, createBookmarkPlugin, type BookmarkPluginOptions, type BookmarkPreview, type BookmarkCardPayload, createFilePlugin, type FilePluginOptions, type FileRowPayload, createVideoPlugin, createAudioPlugin, safeWebUrl, safeMediaSrc, type MediaKind, createMediaEmptyPlugin, type MediaEmptyOptions, createImageToolbarPlugin, type ImageToolbar, type ImageToolbarOptions, type MediaEmptyController, type MediaEmptyFailure, type UrlPasteController, type UrlPasteOffer, type UrlPasteOption, type ImageControls, type ImageBox, type MenuItemPayload, createFindPlugin, findController, findMatches, type FindPluginOptions, type FindController, type ReplaceMatches, type FindMatch, type FindOptions, createMarqueePlugin, type MarqueePluginOptions, type MarqueeBoxPayload, createCommentsPlugin, commentsController, type CommentsPluginOptions, type CommentCardPayload, type CommentsController, type CommentDraft, type CommentNotice, type CommentUser, type PlacedThread, createPagePlugin, type PagePluginOptions, type PageBlockLinkPayload, createTocPlugin, type TocPluginOptions, type TocHeadingLevel, type TocEntryPayload, type TocEmptyPayload, createTablePlugin, type TablePluginOptions, insertTableRow, deleteTableRows, insertTableColumn, deleteTableColumn, moveTableColumn, moveTableRows, fillTableCell, type TableChrome, type TableMenu, type TableMenuRow, type TableMenuItem, type TableGripPayload, type TableAddPayload, tableBlock, type TableBlockOptions, createEquationPlugin, KATEX_CDN, KATEX_VERSION, type EquationPluginOptions, type EquationData, type EquationEditor, type EquationErrorPayload, type EquationPlaceholderPayload, type EquationTarget, type KatexLike, type KatexLoader } from './plugins/index.js';
+export { createRichTextPlugin, richTextOperations, richTextPlaceholder, CALLOUT_ICONS, createCalloutIconsPlugin, type CalloutIconPicker, type CalloutIconsOptions, type RichTextPluginOptions, type TodoCheckboxPayload, type CalloutIconPayload, type EmptyBodyPayload, createArrowMovePlugin, createCodePlugin, CODE_LANGUAGES, loadCodeLanguage, type CodeLanguage, type CodePluginOptions, type CodeHeader, type LanguageMenu, type LanguageMenuItem, type LanguageRow, createMarkdownShortcutsPlugin, createMentionPlugin, type MentionItem, type MentionData, type MentionPluginOptions, createPageLinkPlugin, type PageLinkItem, type PageLinkData, type PageLinkPluginOptions, type TriggerMenuController, withRulesAndTriggers, BLOCK_ACTIVATE_EVENT, BLOCK_ADD_EVENT, type BlockActivation, type BlockAddition, createBlockHandlesPlugin, type BlockHandlesOptions, type BlockHandleSnippetPayload, type BlockHandleController, createSlashMenuPlugin, type SlashMenuOptions, type SlashMenuController, createToolbarPlugin, type ToolbarOptions, type ToolbarController, createBlockMenuPlugin, type BlockMenuOptions, type BlockMenuController, type BlockMenuAction, type BlockMenuColor, createSuggestionsPlugin, createSuggestionBarPlugin, type SuggestionBarOptions, type SuggestionBarPayload, createImagePlugin, type ImagePluginOptions, safeImageSrc, storableImageSrc, MAX_INLINE_IMAGE_BYTES, createColumnsPlugin, type ColumnsPluginOptions, createEmbedPlugin, EMBED_PROVIDERS, EMBED_SANDBOX, EMBED_ALLOW, embedSourceOf, type EmbedProvider, type EmbedPluginOptions, type EmbedFallbackPayload, createBookmarkPlugin, type BookmarkPluginOptions, type BookmarkPreview, type BookmarkCardPayload, createFilePlugin, type FilePluginOptions, type FileRowPayload, createVideoPlugin, type VideoPluginOptions, createAudioPlugin, type AudioPluginOptions, safeWebUrl, safeMediaSrc, type MediaKind, createMediaEmptyPlugin, type MediaEmptyOptions, createImageToolbarPlugin, type ImageToolbar, type ImageToolbarOptions, type MediaEmptyController, type MediaEmptyFailure, type UrlPasteController, type UrlPasteOffer, type UrlPasteOption, type ImageControls, type ImageBox, type ChromeAnchor, type MenuItemPayload, createFindPlugin, findController, findMatches, type FindPluginOptions, type FindController, type ReplaceMatches, type FindMatch, type FindOptions, createMarqueePlugin, type MarqueePluginOptions, type MarqueeBoxPayload, createCommentsPlugin, commentsController, type CommentsPluginOptions, type CommentCardPayload, type CommentsController, type CommentDraft, type CommentNotice, type CommentUser, type PlacedThread, createPagePlugin, type PagePluginOptions, type PageBlockLinkPayload, createTocPlugin, type TocPluginOptions, type TocHeadingLevel, type TocEntryPayload, type TocEmptyPayload, createTablePlugin, type TablePluginOptions, insertTableRow, deleteTableRows, insertTableColumn, deleteTableColumn, moveTableColumn, moveTableRows, fillTableCell, type TableChrome, type TableMenu, type TableMenuRow, type TableMenuItem, type TableGripPayload, type TableAddPayload, tableBlock, type TableBlockOptions, createEquationPlugin, KATEX_CDN, KATEX_VERSION, type EquationPluginOptions, type EquationData, type EquationEditor, type EquationErrorPayload, type EquationPlaceholderPayload, type EquationTarget, type KatexLike, type KatexLoader } from './plugins/index.js';
 export { BLOCK_COLORS, setBlockColor, type BlockColorField } from './block/colors.js';
 export { englishLabels, type Labels, type PartialLabels } from './labels.js';
-export { EdytorDocument, createDocument, loadDocument, attachDocument, defaultSemantics, semanticsOf, mergeSemantics, SemanticConflictError, DocumentNotReadyError, DocumentDestroyedError, SchemaMismatchError, UndecodableUpdateError, UnsupportedDocError, SyncRefusedError, type CreateDocumentOptions, type LoadDocumentOptions, type DocumentActor, type DocumentReadiness, type KindSemantics, type JSONDoc, type JSONBlock, type JSONText, type JSONInlineBlock, type OpResult, type Plan, type Prepared, type DocChange } from './crdt/index.js';
+export { EdytorDocument, createDocument, loadDocument, attachDocument, defaultSemantics, semanticsOf, mergeSemantics, SemanticConflictError, DocumentNotReadyError, DocumentDestroyedError, SchemaMismatchError, UndecodableUpdateError, SyncRefusedError, type CreateDocumentOptions, type LoadDocumentOptions, type DocumentActor, type DocumentReadiness, type KindSemantics, type JSONDoc, type JSONBlock, type JSONText, type JSONInlineBlock, type OpResult, type Plan, type Prepared, type DocChange } from './crdt/index.js';
 export { createIndexeddbSync, createWebsocketSync, clearDocument, prefetch, lastUpdated, documentSnapshot, DEFAULT_PRESENCE_THROTTLE, type EdytorSync, type EdytorSyncPayload, type IndexeddbSyncOptions, type WebsocketSync, type WebsocketSyncOptions, type PresenceOptions, type PresenceShare } from './collaboration/index.js';
 export { createCommentsClient, createMemoryCommentsClient, CommentRequestError, commentAnchors, type CommentDocument, type CommentFeed, type CommentResult, type CommentsClient, type CommentsClientOptions, type MemoryCommentsClient, type MemoryCommentsClientOptions, type CommentChange, type CommentRequest, type CommentRun, type CommentSnapshot, type CommentThread, type ThreadComment } from './collaboration/comments/index.js';
 export { VersionHistory, createHistoryClient, HistoryRequestError, versionDiff, type HistoryClient, type HistoryClientOptions, type HistoryRestoreResult, type HistoryUndoResult, type HistoryVersion, type VersionHistoryStatus, type VersionHistoryOptions, type VersionChange, type VersionDiff } from './collaboration/history/index.js';
@@ -60,7 +60,7 @@ export type { Key, Modifier, Modifiers } from './session/keymap.js';
 export type { TriggerRange } from './plugins/triggers/TriggerController.svelte.js';
 export type { RichTextLink, RichTextMark } from './plugins/richtext/richTextOperations.js';
 export type { KindUpload, UploadReport, Uploader } from './plugins/uploads.svelte.js';
-export type { AwarenessLike, PresenceWriter } from './collaboration/awarenessSelection.js';
+export type { AwarenessLike, PresencePeer, PresenceSource, PresenceWriter } from './collaboration/awarenessSelection.js';
 export type { DataPatch } from './crdt/data.js';
 export type { AnchorAffinity, BlockRole, DocAnchor, TextRange } from './crdt/doc/types.js';
 export type { Flow, FlowLine, FlowTarget } from './crdt/flow.js';

package/dist/index.js

@@ -35,7 +35,7 @@ export { PreventionError, isPrevention } from './utils.js';
 export { convertToKind, turnCommands, wrapBlocks, wrappable } from './kinds.js';
 export { textToBlocks } from './clipboard/textBlocks.js';
 // ── The bundled plugins ────────────────────────────────────────────────
-export { createRichTextPlugin, richTextOperations, richTextPlaceholder, CALLOUT_ICONS, createCalloutIconsPlugin, createUploadsPlugin, createArrowMovePlugin, createCodePlugin, CODE_LANGUAGES, loadCodeLanguage, createMarkdownShortcutsPlugin, createMentionPlugin, createPageLinkPlugin, withRulesAndTriggers, BLOCK_ACTIVATE_EVENT, BLOCK_ADD_EVENT, createBlockHandlesPlugin, createSlashMenuPlugin, createToolbarPlugin, createBlockMenuPlugin, createSuggestionsPlugin, createSuggestionBarPlugin, createImagePlugin, safeImageSrc, storableImageSrc, MAX_INLINE_IMAGE_BYTES, createColumnsPlugin, createEmbedPlugin, EMBED_PROVIDERS, EMBED_SANDBOX, EMBED_ALLOW, embedSourceOf, createBookmarkPlugin, createFilePlugin, createVideoPlugin, createAudioPlugin, safeWebUrl, safeMediaSrc, createMediaEmptyPlugin, createImageToolbarPlugin, createFindPlugin, findController, findMatches, createMarqueePlugin, createCommentsPlugin, commentsController, createPagePlugin, createTocPlugin, createTablePlugin, insertTableRow, deleteTableRows, insertTableColumn, deleteTableColumn, moveTableColumn, moveTableRows, fillTableCell, tableBlock, createEquationPlugin, KATEX_CDN, KATEX_VERSION } from './plugins/index.js';
+export { createRichTextPlugin, richTextOperations, richTextPlaceholder, CALLOUT_ICONS, createCalloutIconsPlugin, createArrowMovePlugin, createCodePlugin, CODE_LANGUAGES, loadCodeLanguage, createMarkdownShortcutsPlugin, createMentionPlugin, createPageLinkPlugin, withRulesAndTriggers, BLOCK_ACTIVATE_EVENT, BLOCK_ADD_EVENT, createBlockHandlesPlugin, createSlashMenuPlugin, createToolbarPlugin, createBlockMenuPlugin, createSuggestionsPlugin, createSuggestionBarPlugin, createImagePlugin, safeImageSrc, storableImageSrc, MAX_INLINE_IMAGE_BYTES, createColumnsPlugin, createEmbedPlugin, EMBED_PROVIDERS, EMBED_SANDBOX, EMBED_ALLOW, embedSourceOf, createBookmarkPlugin, createFilePlugin, createVideoPlugin, createAudioPlugin, safeWebUrl, safeMediaSrc, createMediaEmptyPlugin, createImageToolbarPlugin, createFindPlugin, findController, findMatches, createMarqueePlugin, createCommentsPlugin, commentsController, createPagePlugin, createTocPlugin, createTablePlugin, insertTableRow, deleteTableRows, insertTableColumn, deleteTableColumn, moveTableColumn, moveTableRows, fillTableCell, tableBlock, createEquationPlugin, KATEX_CDN, KATEX_VERSION } from './plugins/index.js';
 export { BLOCK_COLORS, setBlockColor } from './block/colors.js';
 // ── Localization ───────────────────────────────────────────────────────
 export { englishLabels } from './labels.js';
@@ -44,7 +44,7 @@ export { englishLabels } from './labels.js';
 // The application names of `edytor/crdt/edytor`: a Svelte app builds,
 // loads and catches its documents from here. The facade's full vocabulary
 // stays on that entry.
-export { EdytorDocument, createDocument, loadDocument, attachDocument, defaultSemantics, semanticsOf, mergeSemantics, SemanticConflictError, DocumentNotReadyError, DocumentDestroyedError, SchemaMismatchError, UndecodableUpdateError, UnsupportedDocError, SyncRefusedError } from './crdt/index.js';
+export { EdytorDocument, createDocument, loadDocument, attachDocument, defaultSemantics, semanticsOf, mergeSemantics, SemanticConflictError, DocumentNotReadyError, DocumentDestroyedError, SchemaMismatchError, UndecodableUpdateError, SyncRefusedError } from './crdt/index.js';
 // ── Sync and presence ──────────────────────────────────────────────────
 export { createIndexeddbSync, createWebsocketSync, clearDocument, prefetch, lastUpdated, documentSnapshot, DEFAULT_PRESENCE_THROTTLE } from './collaboration/index.js';
 // ── Comment threads ────────────────────────────────────────────────────

package/dist/kinds.js

@@ -209,7 +209,7 @@ export const convertToKind = (edytor, block, row, caret = row.replaces) => {
         let line = kind.children?.length ? at?.children[0] : at;
         while (line && !line.rendersContent && !line.definition.void && line.children[0])
             line = line.children[0];
-        edytor.dispatcher.caret(line?.firstText, 0);
+        edytor.dispatcher.caretIn(line?.firstText, 0);
     }
     return true;
 };

package/dist/labels.d.ts

@@ -116,6 +116,8 @@ export type MediaLabels = {
     audio: string;
     /** A file's size, in bytes. */
     fileSize: (bytes: number) => string;
+    /** A file that is uploading (its block's status, beside the progress). */
+    uploading: string;
 };
 export type CodeLabels = {
     /** The preset (a language's name is its `CodePluginOptions.languages` row's). */

package/dist/labels.js

@@ -118,7 +118,8 @@ export const mediaEnglish = /* @__PURE__ */ frozen({
     file: 'File',
     video: 'Video',
     audio: 'Audio',
-    fileSize: bytes
+    fileSize: bytes,
+    uploading: 'Uploading…'
 });
 /** The `code` section in English. */
 export const codeEnglish = /* @__PURE__ */ frozen({ code: 'Code' });

package/dist/plugins/anchored.svelte.d.ts

@@ -1,47 +1,43 @@
 /**
- * A panel the overlay draws under an element of the page (the code
- * language list under its button, the equation editor under its
- * equation): the anchor's box, measured on the overlay's frames, and the
- * one rule that closes the panel without moving the keys: its anchor gone,
- * a press or a focus outside the panel and its anchor, the view turning
- * readonly.
+ * A panel the app draws by an element of the page (the code language list
+ * by its button, the callout icon picker by its icon, the equation editor
+ * by its equation): that element as the panel's `anchor`, which the app's
+ * markup places itself by, and the one rule that closes the panel without
+ * moving the keys: its anchor gone, a press or a focus outside the panel
+ * and its anchor, the view turning readonly.
  */
-import type { Component } from 'svelte';
+import type { Snippet } from 'svelte';
 import type { Edytor } from '../edytor.svelte.js';
-import { type LayerBox } from '../surface/overlay.js';
 export declare class Anchored {
     #private;
     private edytor;
     /** The overlay host's name: its element is `[data-<name>]`. */
     private name;
-    /** The element the panel stands under: `null` when it left the page, `undefined` while closed. */
-    private anchor;
+    /** The element the panel stands by: `null` when it left the page, `undefined` while closed. */
+    private element;
     /** Close the panel, the keys where they are. */
     private dismiss;
-    /** The anchor's box in the overlay's frame while the panel is open, else `null` (reactive). */
-    box: LayerBox | null;
     constructor(edytor: Edytor, 
     /** The overlay host's name: its element is `[data-<name>]`. */
     name: string, 
-    /** The element the panel stands under: `null` when it left the page, `undefined` while closed. */
-    anchor: () => Element | null | undefined, 
+    /** The element the panel stands by: `null` when it left the page, `undefined` while closed. */
+    element: () => Element | null | undefined, 
     /** Close the panel, the keys where they are. */
     dismiss: () => void);
-    /** Where the panel stands: `gap` under its anchor, from its middle with `center`, layer-relative. */
-    place: (gap: number, center?: boolean) => {
-        left: number;
-        top: number;
-    } | null;
+    /** Where the panel stands: its element's box, read on every call (`ChromeAnchor`). */
+    readonly anchor: import("./chrome.js").ChromeAnchor;
     /**
      * Focus left a field of the panel (its `focusout`): for somewhere outside
-     * the panel and its anchor, it closes; with no new focus (the window went
-     * to the background), it stays.
+     * the panel and its element, it closes; with no new focus (the window
+     * went to the background), it stays.
      */
     blurred: (event: FocusEvent) => void;
     /**
-     * Mount the panel in the overlay at `zIndex` (above the block handles, 5,
-     * by default), with a press listener (capture) on `node`'s document and
-     * the readonly rule. Answers the teardown, which closes it.
+     * Mount the app's `snippet` with `payload` in the overlay at `zIndex`
+     * (above the block handles, 5, by default) while `shown` holds, with a
+     * press listener (capture) on `node`'s document, the anchor-gone rule
+     * (on the overlay's frames) and the readonly rule. Answers the teardown,
+     * which closes it.
      */
-    mount: <Props extends Record<string, unknown>>(node: HTMLElement, component: Component<Props>, props: Props, zIndex?: number) => () => void;
+    mount: <T>(node: HTMLElement, snippet: Snippet<[T]>, payload: T, shown: () => unknown, zIndex?: number) => () => void;
 }

package/dist/plugins/anchored.svelte.js

@@ -1,71 +1,55 @@
 import { onPress } from '../events/onFocus.js';
-import { layerBox, pin, sameValues } from '../surface/overlay.js';
+import { mountChrome, virtualAnchor } from './chrome.js';
 export class Anchored {
     edytor;
     name;
-    anchor;
+    element;
     dismiss;
-    /** The anchor's box in the overlay's frame while the panel is open, else `null` (reactive). */
-    box = $state.raw(null);
     constructor(edytor, 
     /** The overlay host's name: its element is `[data-<name>]`. */
     name, 
-    /** The element the panel stands under: `null` when it left the page, `undefined` while closed. */
-    anchor, 
+    /** The element the panel stands by: `null` when it left the page, `undefined` while closed. */
+    element, 
     /** Close the panel, the keys where they are. */
     dismiss) {
         this.edytor = edytor;
         this.name = name;
-        this.anchor = anchor;
+        this.element = element;
         this.dismiss = dismiss;
     }
-    /** Where the panel stands: `gap` under its anchor, from its middle with `center`, layer-relative. */
-    place = (gap, center = false) => {
-        const box = this.box;
-        return box && { left: box.x + (center ? box.width / 2 : 0), top: box.y + box.height + gap };
-    };
-    /** `at` is outside the panel's host and its anchor: the panel closes. */
+    /** Where the panel stands: its element's box, read on every call (`ChromeAnchor`). */
+    anchor = virtualAnchor(() => this.element()?.getBoundingClientRect(), () => this.element());
+    /** `at` is outside the panel's host and its element: the panel closes. */
     #outside = (at, host) => {
         if (!(at instanceof Node))
             return;
-        if (!host?.contains(at) && !this.anchor()?.contains(at))
+        if (!host?.contains(at) && !this.element()?.contains(at))
             this.dismiss();
     };
     /**
      * Focus left a field of the panel (its `focusout`): for somewhere outside
-     * the panel and its anchor, it closes; with no new focus (the window went
-     * to the background), it stays.
+     * the panel and its element, it closes; with no new focus (the window
+     * went to the background), it stays.
      */
     blurred = (event) => this.#outside(event.relatedTarget, event.currentTarget?.closest(`[data-${this.name}]`));
     /**
-     * Mount the panel in the overlay at `zIndex` (above the block handles, 5,
-     * by default), with a press listener (capture) on `node`'s document and
-     * the readonly rule. Answers the teardown, which closes it.
+     * Mount the app's `snippet` with `payload` in the overlay at `zIndex`
+     * (above the block handles, 5, by default) while `shown` holds, with a
+     * press listener (capture) on `node`'s document, the anchor-gone rule
+     * (on the overlay's frames) and the readonly rule. Answers the teardown,
+     * which closes it.
      */
-    mount = (node, component, props, zIndex = 7) => {
+    mount = (node, snippet, payload, shown, zIndex = 7) => {
         const { edytor } = this;
-        const offPress = onPress(edytor, node.ownerDocument, (event) => this.anchor() !== undefined &&
+        const offPress = onPress(edytor, node.ownerDocument, (event) => this.element() !== undefined &&
             this.#outside(event.target, event.target?.closest?.(`[data-${this.name}]`)), true);
-        const unmount = edytor.overlay.mount(component, props, this.name, zIndex, (host, origin) => {
-            const anchor = this.anchor();
-            const box = layerBox(anchor, origin);
-            return () => {
-                pin(host);
-                if (anchor === null)
-                    return this.dismiss();
-                if (!sameValues(box, this.box))
-                    this.box = box;
-            };
-        });
-        const offLock = $effect.root(() => {
-            $effect(() => {
-                if (edytor.readonly)
-                    this.dismiss();
-            });
-        });
+        const unmount = mountChrome(edytor, snippet, payload, shown, {
+            name: this.name,
+            zIndex,
+            measure: () => (this.element() === null ? this.dismiss : undefined)
+        }, this.dismiss);
         return () => {
             offPress();
-            offLock();
             unmount();
             this.dismiss();
         };

package/dist/plugins/arrowMove/arrowMove.d.ts

@@ -1,3 +1,3 @@
 import type { Plugin } from '../../plugins.js';
-/** Block moves from the keyboard (Mod+Up/Down, Mod+Shift+Up/Down): a default plugin. */
+/** Block moves from the keyboard (Mod+Up/Down, Mod+Shift+Up/Down): apps list it (`createArrowMovePlugin()`), it is not a default. */
 export declare const createArrowMovePlugin: () => Plugin;

package/dist/plugins/arrowMove/arrowMove.js

@@ -24,7 +24,7 @@ const move = (direction, caret = false) => ({ edytor, prevent }) => {
             selectMoved(edytor, moved, selected);
     });
 };
-/** Block moves from the keyboard (Mod+Up/Down, Mod+Shift+Up/Down): a default plugin. */
+/** Block moves from the keyboard (Mod+Up/Down, Mod+Shift+Up/Down): apps list it (`createArrowMovePlugin()`), it is not a default. */
 export const createArrowMovePlugin = () => branded('arrowMove', () => ({
     hotkeys: {
         'mod+arrowdown': move('down'),

package/dist/plugins/blockHandles/BlockHandleController.svelte.d.ts

@@ -53,6 +53,8 @@ export declare class BlockHandleController {
     private group;
     /** The drop bar and the nest backdrop in the overlay, while our drag runs. */
     private readonly indicator;
+    /** Where a drop lands (the one resolution a file drag reads too). */
+    private readonly drop;
     /** The selection the drag in progress replaced when it started: its undo step restores it. */
     private held;
     /** The handle the drag in progress started from: its width is the handle column's. */
@@ -100,57 +102,6 @@ export declare class BlockHandleController {
     registerHandle(element: HTMLElement, block: Block): () => void;
     /** A candidate drop target; registered at once when our drag is in progress. */
     addDropTarget(node: HTMLElement, target: Block): () => void;
-    /**
-     * The editor's content column (`start`…`end`, the root's content box:
-     * where its blocks' boxes start and end), the width of the handle column
-     * left of it (the drag's handle, measured: `+`, grip and the gap to the
-     * block) and how far the drag reaches past them (`dropReach`, the
-     * `--edytor-drop-reach` the root inherits).
-     */
-    private gutter;
-    /**
-     * A placement in the editor's margins at the pointer (`dnd.reach`), within
-     * the editor's height, for the row the content's near edge shows at the
-     * pointer's height (`rowAt`: a nested block's own row; over a layout, the
-     * row of its first column on the left, of its last on the right, never
-     * another), by the zone the pointer is in (`marginAt`):
-     * - the handle column left of the blocks (`gutter`): that row's reorder
-     *   (`reorder`): a drag straight down the handles reorders, row after
-     *   row, gaps included (never a beside band);
-     * - the first `BESIDE_MARGIN` px past it on the left, and past the
-     *   content's right edge: the beside band of that side (`beside`, as if
-     *   the pointer were at that edge) when the document has a layout kind
-     *   and the row offers one (a refused band shows nothing);
-     * - elsewhere within the reach (and there without a band): the reorder,
-     *   on the left the handle column's, on the right the one the row's
-     *   right edge offers (its halves as just inside the content, so nothing
-     *   jumps as the pointer leaves it).
-     * `undefined` past the reach, above or below the editor, and inside the
-     * content (the blocks' own targets answer there).
-     */
-    private margin;
-    /**
-     * The halves of `row` (`zones`) at the pointer, the one it is in first:
-     * the top half of `rect` (its own row by default) before, the bottom one
-     * after; with `plain`, only before or after a block — never inside one.
-     */
-    private halves;
-    /**
-     * The first placement of `halves` the document takes (a refused one gives
-     * way to the next, then to the other half's), `blocked` when the first
-     * half took none; `null` when none fits.
-     */
-    private pick;
-    /**
-     * The handle column's reorder over `row` at the pointer: its plain halves
-     * (`halves`, the pointer's x picking the level); `null` when neither half
-     * fits. Over an item of a container the dragged blocks do not fit in (a
-     * paragraph over a list's item: the document refuses every placement at
-     * the item's level), the container is the row: its whole box, the upper
-     * half before it, the lower half after it (round 4), so a drag down the
-     * handles meets the list as one row it can pass.
-     */
-    private reorder;
     /** The blocks a drop of `source` moves: the drag's own group, fixed when it started. */
     private moving;
     /** The blocks the selection covers when `source` is one of them, else `source` alone. */
@@ -168,75 +119,6 @@ export declare class BlockHandleController {
      * else `source`.
      */
     private select;
-    /** Whether the drag of `source` may land at a placement. */
-    private fits;
-    /**
-     * The block whose row the pointer is on over `node`: the last shown drop
-     * target in it whose row starts at or above the pointer (beside a nested
-     * block, over its ancestors' indent, the pointer is on that block's
-     * row), else `target`, over its own row (`emptied`). A layout's columns
-     * sit side by side: only the one under the pointer is measured (between
-     * two of them, the layout is the row: its gap).
-     */
-    private rowAt;
-    /** Whether the document has a layout kind: only then are there beside placements. */
-    private get layouts();
-    /**
-     * The block a beside placement over `block` stands beside: the document's
-     * own resolution (`facade.besideAt`, `placeBeside`'s): a list item's list,
-     * a code line's code block, a toggle's child itself, an item itself.
-     */
-    private besideOf;
-    /** The item (and its layout) a beside placement at `outer` (`besideOf`) adds a column beside. */
-    private layoutOf;
-    /**
-     * Notion's beside bands over `row` (`docs/columns-plan.md`, "View layer"), only while the
-     * pointer is within its own row's height, the document has a layout kind
-     * and the layout the drop makes or grows does not stack (`stacks`):
-     * - right: the row's last 15% (at least 32px), and the slop past it;
-     * - left: the slop left of the row (its sticky margin, left of its text
-     *   column), only for a row whose parent is the root or a column (a
-     *   list's item: its list's) — a nested row keeps the pointer's x for its
-     *   levels (`zones`) — and only
-     *   inside the editor (a column's gap): left of the editor's blocks is the
-     *   handle column, which reorders (`margin`);
-     * - over a layout's gap (the row is the layout): right of the column
-     *   before it, a new column between.
-     * `undefined` outside the bands (the hitbox's halves stand), else the
-     * placement, or `null` when the document refuses it: a refused band shows
-     * nothing.
-     */
-    private beside;
-    /** Where the editor's blocks start (`gutter`), or `fallback` without a host. */
-    private inside;
-    /** The children a block shows: none for a closed toggle's, or a container's items. */
-    private shown;
-    /**
-     * Over a dragged block, the parent it leaves when that parent shows no
-     * other child: the gap under the parent's own row, which reparents as
-     * the parent's lower half does (`zones`). Else `row`.
-     */
-    private emptied;
-    /**
-     * The placements over `row`, each half's in preference order (a refused
-     * one gives way to the next, then to the other half's):
-     * - the top half: before it;
-     * - the bottom half of a block whose children show (not a closed toggle):
-     *   its first child's slot. Pragmatic drag and drop's tree rule: an
-     *   expanded item offers no "after" on its own row;
-     * - else, after it at the level whose text column is nearest the pointer:
-     *   the last block of a nested group reparents to any ancestor it ends,
-     *   down to the root. Past one nesting step right of its text start,
-     *   inside it (its last child) first. A block every shown child of which
-     *   is dragged is not expanded: its levels, never inside it when the drag
-     *   moves only its children (they would stay where they are).
-     * None over a dragged block's own row or its subtree: released there, the
-     * drag changes nothing (its levels would outdent it) — unless it empties
-     * its parent's shown children (`emptied`): that parent's row. Over the
-     * hint of the row's empty body (`body.hint`: an open toggle's, a
-     * callout's), inside it first, either half.
-     */
-    private zones;
     /**
      * The placement a drop target record offers: the page's margins
      * (`margin`), else a beside band of the row first (`beside`; `false` when
@@ -245,7 +127,5 @@ export declare class BlockHandleController {
      * live.
      */
     private placement;
-    /** The dragged block that is `row` or holds it: its row offers nothing (it moves with the drag). */
-    private carrier;
 }
 export {};