edytor 1.0.0-rc.2 → 1.0.0

package/dist/plugins/table/table.js

@@ -1,5 +1,5 @@
-import { dispatchPlan } from '../../block/block.utils.js';
-import { domPointOf } from '../../surface/projector.svelte.js';
+import * as ops from './ops.js';
+import { caretBox, sameLine } from '../../surface/lines.js';
 /** The table `block` is, or whose row or cell it is. */
 export const tableOf = (block) => {
     if (!block?.id)
@@ -31,28 +31,31 @@ export const cellAt = (table, grid, row, column) => {
 };
 /** The cell holding the caret (or the selection's start), if it is a table's cell. */
 export const caretCell = (edytor) => {
-    const block = edytor.selection.state.startBlock;
+    const block = edytor.selection.textRange().startText?.parent;
     return block?.id && edytor.facade.isTableCell(block.id) ? block : null;
 };
-/** `prepare` dispatched as `operation` on `table`: one plan, its own undo step; the plan or `null`. */
-const run = (table, operation, payload, prepare) => dispatchPlan(table, operation, payload, prepare, []);
+/** `prepare` dispatched as `operation` on `table`: one plan, its own undo step; the plan's ids, or `null` when refused. */
+const run = (table, operation, payload, prepare) => {
+    const result = table.edytor.dispatcher.plan(operation, payload, prepare, table);
+    return result.status === 'refused' ? null : result;
+};
 /** Insert a row at `index` (`table.insert-row`); the caret goes to its first cell when `caret`. */
 export const insertRow = (table, index, caret = false) => {
     const { edytor } = table;
-    const plan = run(table, 'insertTableRow', { index }, (p) => edytor.facade.prepare.insertTableRow(table.id, p.index));
+    const plan = run(table, 'insertTableRow', { index }, (p) => ops.insertTableRow(edytor.facade, table.id, p.index));
     const row = plan ? (edytor.idToBlock.get(plan.ids[0]) ?? null) : null;
     if (row && caret)
         edytor.dispatcher.caret(row.children[0]?.firstText, 0);
     return row;
 };
 /** Delete `rows` with their cells (`table.delete-row`). */
-export const deleteRows = (table, rows) => run(table, 'deleteTableRows', { rows: [...rows] }, (p) => table.edytor.facade.prepare.deleteTableRows(p.rows.map((row) => row.id))) !== null;
+export const deleteRows = (table, rows) => run(table, 'deleteTableRows', { rows: [...rows] }, (p) => ops.deleteTableRows(table.edytor.facade, p.rows.map((row) => row.id))) !== null;
 /**
  * Insert a column at `index` (`table.insert-column`); with `caret` (a row's
  * position), the caret goes to the new column's cell in that row.
  */
 export const insertColumn = (table, index, width, caret) => {
-    const applied = run(table, 'insertTableColumn', { index, width }, (p) => table.edytor.facade.prepare.insertTableColumn(table.id, p.index, p.width)) !== null;
+    const applied = run(table, 'insertTableColumn', { index, width }, (p) => ops.insertTableColumn(table.edytor.facade, table.id, p.index, p.width)) !== null;
     const grid = applied && caret !== undefined ? gridOf(table) : null;
     if (grid) {
         const at = Math.max(0, Math.min(Math.trunc(index) || 0, grid.columns.length - 1));
@@ -63,18 +66,18 @@ export const insertColumn = (table, index, width, caret) => {
     return applied;
 };
 /** Delete a column, by id or position (`table.delete-column`). */
-export const deleteColumn = (table, column) => run(table, 'deleteTableColumn', { column }, (p) => table.edytor.facade.prepare.deleteTableColumn(table.id, p.column)) !== null;
+export const deleteColumn = (table, column) => run(table, 'deleteTableColumn', { column }, (p) => ops.deleteTableColumn(table.edytor.facade, table.id, p.column)) !== null;
 /** Move a column to position `to` (`table.move-column`). */
-export const moveColumn = (table, column, to) => run(table, 'moveTableColumn', { column, to }, (p) => table.edytor.facade.prepare.moveTableColumn(table.id, p.column, p.to)) !== null;
+export const moveColumn = (table, column, to) => run(table, 'moveTableColumn', { column, to }, (p) => ops.moveTableColumn(table.edytor.facade, table.id, p.column, p.to)) !== null;
 /** Move rows to position `to` among their table's rows (`table.move-row`). */
-export const moveRows = (table, rows, to) => run(table, 'moveTableRows', { rows: [...rows], to }, (p) => table.edytor.facade.prepare.moveTableRows(p.rows.map((row) => row.id), p.to)) !== null;
+export const moveRows = (table, rows, to) => run(table, 'moveTableRows', { rows: [...rows], to }, (p) => ops.moveTableRows(table.edytor.facade, p.rows.map((row) => row.id), p.to)) !== null;
 /**
  * Fill the padded cell of `row` in `column` (`table.pad`): the cell is
  * created, the caret placed in it. Its block, or `null` when refused.
  */
 export const fillCell = (table, row, column) => {
     const { edytor } = table;
-    const plan = run(table, 'fillTableCell', { row, column }, (p) => edytor.facade.prepare.fillTableCell(p.row, p.column));
+    const plan = run(table, 'fillTableCell', { row, column }, (p) => ops.fillTableCell(edytor.facade, p.row, p.column));
     const cell = plan ? (edytor.idToBlock.get(plan.ids[0]) ?? null) : null;
     if (cell)
         edytor.dispatcher.caret(cell.firstText, 0);
@@ -82,8 +85,10 @@ export const fillCell = (table, row, column) => {
 };
 /** Toggle `flag` (`headerRow` or `headerColumn`) of `table`'s data (`table.header`). */
 export const toggleHeader = (table, flag) => {
-    table.data[flag] = table.data[flag] !== true;
+    table.edytor.patchData(table.id, [{ path: [flag], value: table.data[flag] !== true }]);
 };
+/** A label key as a row id: `insertRowAbove` → `insert-row-above`. */
+export const kebab = (key) => key.replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`);
 /** A cell's width as set, else `fallback`: `data.columns[i].width`. */
 export const widthOf = (column, fallback) => {
     const width = column?.width;
@@ -107,7 +112,7 @@ export const tabFrom = (cell, step) => {
         const next = cellAt(table, grid, Math.floor(i / width), i % width);
         const text = next?.lastText;
         if (text) {
-            edytor.selection.setAtTextOffset(text, text.length);
+            edytor.selection.selectText(text, text.length);
             return true;
         }
     }
@@ -115,38 +120,6 @@ export const tabFrom = (cell, step) => {
         insertRow(table, grid.rows.length, true);
     return true;
 };
-/**
- * The box of the caret at `offset` in `text`, read from the character after
- * it (`after`: its left edge) or the one before it (its right edge), the
- * other one where there is none; `null` where nothing is laid out (no layout
- * engine). An offset where a line wraps is on both lines: `after` reads it
- * on the later one, `before` on the earlier one.
- */
-const caretBox = (text, offset, after) => {
-    const element = text.node;
-    if (!element)
-        return null;
-    const range = element.ownerDocument.createRange();
-    const box = (from) => {
-        if (from < 0 || from >= text.stringContent.length)
-            return null;
-        const [startNode, start] = domPointOf(element, from);
-        const [endNode, end] = domPointOf(element, from + 1);
-        range.setStart(startNode, start);
-        range.setEnd(endNode, end);
-        // No layout engine (a server, jsdom) lays nothing out: no box.
-        const list = typeof range.getClientRects === 'function' ? range.getClientRects() : null;
-        return [...(list ?? [])].find((r) => r.width > 0 || r.height > 0) ?? null;
-    };
-    const next = box(offset);
-    const previous = box(offset - 1);
-    const edge = (r, right) => new DOMRect(right ? r.right : r.left, r.top, 0, r.height);
-    if (after)
-        return next ? edge(next, false) : previous && edge(previous, true);
-    return previous ? edge(previous, true) : next && edge(next, false);
-};
-/** `a` and `b` are on one line box: their vertical middles are within half a line of each other. */
-const sameLine = (a, b) => Math.abs(a.top + a.height / 2 - (b.top + b.height / 2)) < Math.max(a.height, b.height) / 2;
 /**
  * ArrowUp (`step` -1) on a cell's first line, ArrowDown (`1`) on its last
  * (`table.keys`): the caret goes to the nearest shown cell above (below) in
@@ -160,7 +133,8 @@ const sameLine = (a, b) => Math.abs(a.top + a.height / 2 - (b.top + b.height / 2
 export const verticalFrom = (cell, step) => {
     const at = positionOf(cell);
     const { edytor } = cell;
-    const { startText, yStart, isCollapsed } = edytor.selection.state;
+    const { startText, yStart } = edytor.selection.textRange();
+    const { isCollapsed } = edytor.selection.projection;
     if (!at || !isCollapsed || !startText)
         return false;
     if (step < 0 ? startText !== cell.firstText : startText !== cell.lastText)
@@ -180,7 +154,7 @@ export const verticalFrom = (cell, step) => {
             const other = caretBox(startText, yStart, step > 0);
             if (!other || !sameLine(other, edge))
                 return false;
-            edytor.selection.setAtTextOffset(startText, landing(startText, -step, caret, column));
+            edytor.selection.selectText(startText, landing(startText, -step, caret, column));
             return true;
         }
     }
@@ -191,7 +165,7 @@ export const verticalFrom = (cell, step) => {
         const text = step < 0 ? target?.lastText : target?.firstText;
         if (!text)
             continue;
-        edytor.selection.setAtTextOffset(text, landing(text, step, caret, column));
+        edytor.selection.selectText(text, landing(text, step, caret, column));
         return true;
     }
     return false;

package/dist/plugins/toc/TableOfContents.svelte

@@ -3,17 +3,20 @@
 	import type { Edytor } from '../../edytor.svelte.js';
 	import { ownText } from '../../surface/attributes.js';
 	import { reveal } from '../../selection/replaceSelection.js';
-	import { tocLabels, type TocHeadingLevel } from './toc.js';
+	import { labelsOf, tocEnglish } from '../../labels.js';
+	import { attach, keepSelection } from '../chrome.js';
+	import { richTextHeadingLevel, tocViews, type TocEntryPayload } from './toc.js';
 
 	/**
 	 * The document's headings, live, in reading order (Notion's table of
 	 * contents): read from the view's cells, so an edit anywhere re-renders
 	 * only the entries it changes. Each entry scrolls its heading into view,
-	 * opening the closed toggles it sits in; the selection stays.
+	 * opening the closed toggles it sits in; the selection stays. The app's
+	 * `entry` and `empty` snippets draw them, else this markup.
 	 */
-	let { level }: { level: TocHeadingLevel } = $props();
 	const edytor = getContext<Edytor>('edytor');
-	const labels = tocLabels.of(edytor);
+	const labels = labelsOf(edytor, 'toc', tocEnglish);
+	const { headingLevel: level = richTextHeadingLevel, entry, empty } = tocViews.get(edytor) ?? {};
 
 	type Entry = { id: string; level: number; text: string };
 	const entries = $derived.by(() => {
@@ -40,44 +43,35 @@
 		reveal(block);
 		block.node.scrollIntoView?.({ behavior: 'smooth', block: 'start' });
 	};
+
+	const payloadOf = ({ id, level, text }: Entry): TocEntryPayload => ({
+		id,
+		level,
+		depth: level - top,
+		text,
+		label: text || labels.untitled,
+		go: () => go(id),
+		control: attach(
+			{ 'data-edytor-toc-entry': '' },
+			{ mousedown: keepSelection, click: () => go(id) }
+		)
+	});
 </script>
 
 {#if entries.length}
-	{#each entries as entry (entry.id)}
-		<button
-			type="button"
-			data-edytor-toc-entry
-			data-level={entry.level}
-			data-untitled={entry.text ? undefined : 'true'}
-			style:--edytor-toc-depth={entry.level - top}
-			onmousedown={(event) => event.preventDefault()}
-			onclick={() => go(entry.id)}>{entry.text || labels.untitled}</button
-		>
+	{#each entries as found (found.id)}
+		{@const payload = payloadOf(found)}
+		{#if entry}{@render entry(payload)}{:else}<button
+				type="button"
+				data-edytor-toc-entry
+				data-level={payload.level}
+				data-untitled={payload.text ? undefined : 'true'}
+				style:--edytor-toc-depth={payload.depth}
+				{@attach payload.control}>{payload.label}</button
+			>{/if}
 	{/each}
+{:else if empty}
+	{@render empty({ label: labels.empty })}
 {:else}
 	<p data-edytor-toc-empty>{labels.empty}</p>
 {/if}
-
-<style>
-	/*
-	 * The entries' structure, at zero specificity (`:where`): one line each,
-	 * one nesting step in per level; a theme draws them (`themes/notion.css`).
-	 */
-	:global(:where([data-edytor-toc-entry])) {
-		display: block;
-		width: 100%;
-		margin: 0;
-		padding: 0;
-		padding-inline-start: calc(var(--edytor-toc-depth, 0) * var(--edytor-nest-indent, 24px));
-		border: 0;
-		background: none;
-		color: inherit;
-		font: inherit;
-		text-align: start;
-		cursor: pointer;
-	}
-	:global(:where([data-edytor-toc-empty])) {
-		margin: 0;
-		opacity: 0.6;
-	}
-</style>

package/dist/plugins/toc/TableOfContents.svelte.d.ts

@@ -1,7 +1,3 @@
-import { type TocHeadingLevel } from './toc.js';
-type $$ComponentProps = {
-    level: TocHeadingLevel;
-};
-declare const TableOfContents: import("svelte").Component<$$ComponentProps, {}, "">;
+declare const TableOfContents: import("svelte").Component<Record<string, never>, {}, "">;
 type TableOfContents = ReturnType<typeof TableOfContents>;
 export default TableOfContents;

package/dist/plugins/toc/TocPlugin.svelte

@@ -1,35 +1,38 @@
 <script module lang="ts">
 	import type { Plugin, BlockSnippetPayload } from '../../plugins.js';
-	import type { Edytor } from '../../edytor.svelte.js';
 	import { tocKinds } from '../../crdt/semantics.js';
-	import { keywordsOf, labelsWith } from '../../labels.js';
+	import { tocEnglish, keywordsOf, labelsOf } from '../../labels.js';
 	import TableOfContents from './TableOfContents.svelte';
 	import {
 		richTextHeadingLevel,
-		tocLabels,
+		type TocEmptyPayload,
+		type TocEntryPayload,
 		type TocHeadingLevel,
-		type TocPluginOptions
+		type TocPluginOptions,
+		tocViews as views
 	} from './toc.js';
 
-	export type { TocHeadingLevel, TocPluginOptions };
-
-	const levelOf = new WeakMap<Edytor, TocHeadingLevel>();
+	export type { TocEmptyPayload, TocEntryPayload, TocHeadingLevel, TocPluginOptions };
 
 	/**
 	 * Notion's table of contents: a `toc` block lists the document's
 	 * headings, live, indented by level; a click scrolls to one (opening the
 	 * closed toggles it sits in). Void: it holds no text, and its list is
 	 * never stored, only drawn. Its preset in the slash menu turns an empty
-	 * line into one, or inserts it after the line; its words are `labels`
-	 * (English by default).
+	 * line into one, or inserts it after the line; its words are the view's
+	 * `toc` labels (English by default).
 	 */
 	export const createTocPlugin =
 		(options: TocPluginOptions = {}): Plugin =>
 		(edytor) => {
 			// First wins, as for the kind: a second listing never replaces it.
-			if (!levelOf.has(edytor)) levelOf.set(edytor, options.headingLevel ?? richTextHeadingLevel);
-			const labels = labelsWith('toc', options.labels);
-			tocLabels.claim(edytor, labels);
+			if (!views.has(edytor))
+				views.set(edytor, {
+					headingLevel: options.headingLevel ?? richTextHeadingLevel,
+					entry: options.entry,
+					empty: options.empty
+				});
+			const labels = labelsOf(edytor, 'toc', tocEnglish);
 			return {
 				blocks: {
 					toc: {
@@ -41,11 +44,12 @@
 							{
 								label: labels.toc,
 								icon: '☰',
-								keywords: keywordsOf(
-									'block.toc',
-									['toc', 'outline', 'headings', 'contents'],
-									options.keywords
-								),
+								keywords: keywordsOf(edytor, 'block.toc', [
+									'toc',
+									'outline',
+									'headings',
+									'contents'
+								]),
 								group: 'Advanced blocks'
 							}
 						],
@@ -58,14 +62,10 @@
 				}
 			};
 		};
-
-	/** The table of contents over the rich text headings. */
-	export const tocPlugin = createTocPlugin();
 </script>
 
 {#snippet toc({ block }: BlockSnippetPayload)}
-	{@const level = (block.handle && levelOf.get(block.handle.edytor)) || richTextHeadingLevel}
 	<div use:block.void data-edytor-toc>
-		<TableOfContents {level} />
+		<TableOfContents />
 	</div>
 {/snippet}

package/dist/plugins/toc/TocPlugin.svelte.d.ts

@@ -1,17 +1,15 @@
 import type { Plugin } from '../../plugins.js';
-import { type TocHeadingLevel, type TocPluginOptions } from './toc.js';
-export type { TocHeadingLevel, TocPluginOptions };
+import { type TocEmptyPayload, type TocEntryPayload, type TocHeadingLevel, type TocPluginOptions } from './toc.js';
+export type { TocEmptyPayload, TocEntryPayload, TocHeadingLevel, TocPluginOptions };
 /**
  * Notion's table of contents: a `toc` block lists the document's
  * headings, live, indented by level; a click scrolls to one (opening the
  * closed toggles it sits in). Void: it holds no text, and its list is
  * never stored, only drawn. Its preset in the slash menu turns an empty
- * line into one, or inserts it after the line; its words are `labels`
- * (English by default).
+ * line into one, or inserts it after the line; its words are the view's
+ * `toc` labels (English by default).
  */
 export declare const createTocPlugin: (options?: TocPluginOptions) => Plugin;
-/** The table of contents over the rich text headings. */
-export declare const tocPlugin: Plugin;
 interface $$__sveltets_2_IsomorphicComponent<Props extends Record<string, any> = any, Events extends Record<string, any> = any, Slots extends Record<string, any> = any, Exports = {}, Bindings = string> {
     new (options: import('svelte').ComponentConstructorOptions<Props>): import('svelte').SvelteComponent<Props, Events, Slots> & {
         $$bindings?: Bindings;

package/dist/plugins/toc/toc.d.ts

@@ -1,4 +1,5 @@
-import { type PartialLabels } from '../../labels.js';
+import type { Snippet } from 'svelte';
+import type { Attachment } from 'svelte/attachments';
 /**
  * A block's level in the table of contents (1 the outermost), or `null`
  * when it is not a heading: read from its kind and data.
@@ -7,11 +8,6 @@ export type TocHeadingLevel = (block: {
     type: string;
     data: Readonly<Record<string, unknown>>;
 }) => number | null;
-/** Each view's table of contents labels: the first toc plugin listed claims them, as its kind. */
-export declare const tocLabels: {
-    claim: (view: object | undefined, labels: import("../../labels.js").TocLabels) => void;
-    of: (view: object | undefined) => import("../../labels.js").TocLabels;
-};
 /** The table of contents plugin's options. */
 export type TocPluginOptions = {
     /**
@@ -20,10 +16,45 @@ export type TocPluginOptions = {
      * any other 3, as they are drawn).
      */
     headingLevel?: TocHeadingLevel;
-    /** The words the block and its preset show, over the English ones. */
-    labels?: PartialLabels<'toc'>;
-    /** The slash menu's keywords of the preset (`block.toc`), which replace its own. */
-    keywords?: Partial<Record<string, string[]>>;
+    /**
+     * One entry (default: a `button` with the heading's text, one nesting
+     * step in per level under the shallowest). Give it `{@attach
+     * entry.control}`: a click scrolls its heading into view, opening the
+     * closed toggles it sits in, and the selection stays.
+     */
+    entry?: Snippet<[TocEntryPayload]>;
+    /** What shows while the document has no heading (default: a `p` with the view's `toc.empty`). */
+    empty?: Snippet<[TocEmptyPayload]>;
+};
+/** What a table of contents' `entry` snippet receives: one heading. */
+export type TocEntryPayload = {
+    /** The heading's block id. */
+    id: string;
+    /** Its level (`headingLevel`'s answer, 1 the outermost). */
+    level: number;
+    /** How many steps in it sits: its level less the shallowest shown. */
+    depth: number;
+    /** Its text (`''` when it has none). */
+    text: string;
+    /** What it reads: its text, else the view's `toc.untitled`. */
+    label: string;
+    /** Scroll its heading into view (opening the closed toggles it sits in). */
+    go: () => void;
+    /**
+     * The entry's attachment (`{@attach entry.control}`): its marker
+     * (`data-edytor-toc-entry`), a press that keeps the editor's selection,
+     * and a click that scrolls to it.
+     */
+    control: Attachment<HTMLElement>;
+};
+/** What a table of contents' `empty` snippet receives. */
+export type TocEmptyPayload = {
+    /** The view's words for it (`toc.empty`). */
+    label: string;
 };
+/** A view's table of contents: the first plugin listed sets it. */
+export type TocView = Required<Pick<TocPluginOptions, 'headingLevel'>> & Pick<TocPluginOptions, 'entry' | 'empty'>;
 /** The rich text headings' levels (`heading`, `toggle-heading`), as they draw them. */
 export declare const richTextHeadingLevel: TocHeadingLevel;
+/** Each view's table of contents (the first plugin listed sets it). */
+export declare const tocViews: WeakMap<object, TocView>;

package/dist/plugins/toc/toc.js

@@ -1,6 +1,3 @@
-import { viewLabels } from '../../labels.js';
-/** Each view's table of contents labels: the first toc plugin listed claims them, as its kind. */
-export const tocLabels = viewLabels('toc');
 /** The rich text headings' levels (`heading`, `toggle-heading`), as they draw them. */
 export const richTextHeadingLevel = ({ type, data }) => {
     if (type !== 'heading' && type !== 'toggle-heading')
@@ -8,3 +5,5 @@ export const richTextHeadingLevel = ({ type, data }) => {
     const { level } = data;
     return level === undefined || level === 'h1' ? 1 : level === 'h2' ? 2 : 3;
 };
+/** Each view's table of contents (the first plugin listed sets it). */
+export const tocViews = new WeakMap();

package/dist/plugins/toolbar/ToolbarController.svelte.d.ts

@@ -1,76 +1,46 @@
+import type { Attachment } from 'svelte/attachments';
 import type { Edytor } from '../../edytor.svelte.js';
 import type { EdytorSelection } from '../../selection/selection.svelte.js';
 import { type KindRow } from '../../kinds.js';
-import type { Popup } from '../../surface/popups.svelte.js';
-import { type ToolbarLabels } from '../../labels.js';
-/** Notion's palette: text colors and their backgrounds, by name (shown through the labels' `colors`). */
-export declare const TOOLBAR_COLORS: readonly [{
-    readonly name: "Default";
-    readonly text: null;
-    readonly background: null;
-}, {
-    readonly name: "Gray";
-    readonly text: "#7d7a75";
-    readonly background: "#f0efed";
-}, {
-    readonly name: "Brown";
-    readonly text: "#9f765a";
-    readonly background: "#f5ede9";
-}, {
-    readonly name: "Orange";
-    readonly text: "#d27b2d";
-    readonly background: "#fbebde";
-}, {
-    readonly name: "Yellow";
-    readonly text: "#cb9434";
-    readonly background: "#f9f3dc";
-}, {
-    readonly name: "Green";
-    readonly text: "#50946e";
-    readonly background: "#e8f1ec";
-}, {
-    readonly name: "Blue";
-    readonly text: "#387dc9";
-    readonly background: "#e5f2fc";
-}, {
-    readonly name: "Purple";
-    readonly text: "#9a6bb4";
-    readonly background: "#f3ebf9";
-}, {
-    readonly name: "Pink";
-    readonly text: "#c14c8a";
-    readonly background: "#fae9f1";
-}, {
-    readonly name: "Red";
-    readonly text: "#cf5148";
-    readonly background: "#fce9e7";
-}];
 export declare class ToolbarController {
+    #private;
     private edytor;
-    /** The words the toolbar shows (the plugin's `labels`): read them in a custom `toolbar`. */
-    readonly labels: ToolbarLabels;
     /** Shown for the current selection; hidden while the editor is readonly. */
     private shown;
     linkUrl: string;
     /** The open panel: the kind menu, the link field or the colors. */
-    panel: "link" | "color" | "turn" | null;
-    /** The selection the toolbar acts on: a value (anchors), so peers' edits move it. */
-    private selectionSnapshot;
-    private isRestoringSelection;
-    /** The link panel's field takes the focus when it next mounts (it was opened, not re-rendered). */
-    private focusField;
+    panel: "color" | "link" | "turn" | null;
     /** The link under the pointer, for the link card (`link.card`). */
     hovered: HTMLAnchorElement | null;
-    constructor(edytor: Edytor, 
-    /** The words the toolbar shows (the plugin's `labels`): read them in a custom `toolbar`. */
-    labels?: ToolbarLabels);
-    /** A palette color's name as shown (`labels.colors`). */
-    colorName: (name: string) => string;
+    constructor(edytor: Edytor);
     get isVisible(): boolean;
     /** The bar's element id (page-unique), for the root's `aria-controls`. */
     get barId(): string;
-    /** Publish the shown bar to the view's root (`edytor.popups`), or withdraw it with `null`. */
-    publish: (popup: Popup | null) => void;
+    /** The link panel's field id (page-unique): a `label`'s `for`. */
+    get linkFieldId(): string;
+    /**
+     * The bar (`{@attach controller.popup}`, named by your markup): it takes
+     * the bar's id, its `toolbar` role unless it has its own, the placement's mark
+     * (`data-edytor-toolbar-bar`, which the toolbar's shortcut also reads),
+     * and is published to the view's root (`edytor.popups`, with that
+     * shortcut as its `aria-keyshortcuts`) while it is in the page.
+     */
+    popup: Attachment<HTMLElement>;
+    /**
+     * The bar's keys (`{@attach controller.keys}`, WAI-ARIA toolbar): one tab
+     * stop, the control it last held (`tabindex="0"`, every other `-1`); the
+     * arrows, Home and End walk its controls, Escape gives the focus back to
+     * the editor over the held selection (`release`). Every key in it is its
+     * own, never the editor's (Enter presses the button).
+     */
+    keys: Attachment<HTMLElement>;
+    /**
+     * The link panel's field (`{@attach controller.linkField}`): its id
+     * (`linkFieldId`), the focus when the panel was just opened (Mod+K, Edit,
+     * the Link button), Enter applies the link and Escape closes the panel,
+     * both giving the editor its focus and the selection back.
+     */
+    linkField: Attachment<HTMLInputElement>;
     /** Give the keyboard back to the editor (Escape in the bar), over the held selection. */
     release(): void;
     updateFromSelection(selection?: EdytorSelection): void;
@@ -114,8 +84,6 @@ export declare class ToolbarController {
     editHovered(): void;
     /** The card's Remove: unlink the whole hovered link (one undo step); the selection stays. */
     removeHovered(): void;
-    /** The hovered link element's text and link run, read from the model (never from the DOM). */
-    private hoveredLink;
     /** Convert every block the selection touches (Notion), as one undo step. */
     turnInto(kind: KindRow): void;
     /** Set (or clear, with `null`) the text color or background of the selection. */
@@ -123,9 +91,4 @@ export declare class ToolbarController {
     toggleMark(mark: string): void;
     applyLink(): void;
     removeLink(): void;
-    private canShowForSelection;
-    private getSelectedLinkUrl;
-    /** Act on the held selection, then select it again (the projector displays it). */
-    private runWithSelection;
-    private restoreSelection;
 }