@olddevs/ui 0.0.0-stage → 4.0.0

package/dist/editor/core/sourceFormat.js

@@ -0,0 +1,136 @@
+export function formatSourceHtml(html) {
+    const root = parse(html);
+    if (!root || !expands(html, root))
+        return html;
+    return root.children
+        .filter((child) => !isBlank(html, child))
+        .map((child) => render(html, child, ""))
+        .join("\n");
+}
+const VOID = new Set("area base br col embed hr img input link meta source track wbr".split(" "));
+const PHRASING = new Set(("a abbr b bdi bdo br button cite code data del dfn em i img input ins kbd label mark q s " +
+    "samp small span strong sub sup time u var wbr").split(" "));
+const VERBATIM = new Set(["pre", "textarea", "script", "style"]);
+function parse(html) {
+    const root = {
+        kind: "element",
+        name: "#root",
+        start: 0,
+        end: html.length,
+        openEnd: 0,
+        closeStart: html.length,
+        children: [],
+    };
+    const stack = [root];
+    const lower = html.toLowerCase();
+    let index = 0;
+    let textStart = -1;
+    const closeText = (at) => {
+        if (textStart < 0)
+            return;
+        stack[stack.length - 1].children.push({ kind: "text", start: textStart, end: at });
+        textStart = -1;
+    };
+    while (index < html.length) {
+        const top = stack[stack.length - 1];
+        if (VERBATIM.has(top.name)) {
+            const close = lower.indexOf(`</${top.name}`, index);
+            if (close < 0)
+                return null;
+            const closeEnd = html.indexOf(">", close);
+            if (closeEnd < 0)
+                return null;
+            top.closeStart = close;
+            top.end = closeEnd + 1;
+            stack.pop();
+            index = closeEnd + 1;
+            continue;
+        }
+        const tag = html[index] === "<" ? /^<(\/?)([a-zA-Z][^\s/>]*)/.exec(html.slice(index)) : null;
+        if (!tag) {
+            if (textStart < 0)
+                textStart = index;
+            index += 1;
+            continue;
+        }
+        closeText(index);
+        const tagEnd = endOfTag(html, index);
+        if (tagEnd < 0)
+            return null;
+        const name = tag[2].toLowerCase();
+        if (tag[1]) {
+            if (top.name !== name)
+                return null;
+            top.closeStart = index;
+            top.end = tagEnd;
+            stack.pop();
+        }
+        else {
+            const element = {
+                kind: "element",
+                name,
+                start: index,
+                end: tagEnd,
+                openEnd: tagEnd,
+                closeStart: tagEnd,
+                children: [],
+            };
+            top.children.push(element);
+            if (!VOID.has(name) && html[tagEnd - 2] !== "/")
+                stack.push(element);
+        }
+        index = tagEnd;
+    }
+    closeText(html.length);
+    return stack.length === 1 ? root : null;
+}
+function endOfTag(html, from) {
+    let quote = null;
+    for (let index = from + 1; index < html.length; index += 1) {
+        const char = html[index];
+        if (quote) {
+            if (char === quote)
+                quote = null;
+        }
+        else if (char === '"' || char === "'") {
+            quote = char;
+        }
+        else if (char === ">") {
+            return index + 1;
+        }
+    }
+    return -1;
+}
+function isBlank(html, child) {
+    return child.kind === "text" && html.slice(child.start, child.end).trim() === "";
+}
+function expands(html, element) {
+    if (VERBATIM.has(element.name))
+        return false;
+    let block = false;
+    for (const child of element.children) {
+        if (child.kind === "text") {
+            if (!isBlank(html, child))
+                return false;
+        }
+        else if (!PHRASING.has(child.name)) {
+            block = true;
+        }
+    }
+    return block;
+}
+function render(html, node, indent) {
+    if (node.kind === "text" || !expands(html, node)) {
+        return indent + html.slice(node.start, node.end);
+    }
+    const inner = indent + "  ";
+    const children = node.children
+        .filter((child) => !isBlank(html, child))
+        .map((child) => render(html, child, inner));
+    return [
+        indent + html.slice(node.start, node.openEnd),
+        ...children,
+        indent + html.slice(node.closeStart, node.end),
+    ].join("\n");
+}
+//# sourceMappingURL=sourceFormat.js.map

package/dist/editor/core/sourceFormat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceFormat.js","sourceRoot":"","sources":["../../../src/editor/core/sourceFormat.ts"],"names":[],"mappings":"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"}

package/dist/editor/core/toolButtons.d.ts

@@ -0,0 +1,58 @@
+import { Extension, type Editor } from "@tiptap/core";
+import type { ReactNode } from "react";
+import type { KitToolButton, ToolLabel } from "./toolDescriptor.js";
+declare module "@tiptap/core" {
+    interface Commands<ReturnType> {
+        toolButtons: {
+            /**
+             * Внутренняя команда кита, не API: открыть поповер записи описания.
+             * Кнопка — у выделения (сочетание, рамка `anchor: "selection"`); пункт
+             * вставки — у каретки; Действие над Блоком — у Блока `block`. В
+             * нередактируемом поле и при невыполненном `can` кнопки — нет.
+             */
+            openToolPopover: (id: string, block?: number) => ReturnType;
+        };
+    }
+}
+/** Запись с поповером, кроме кнопки: пункт вставки или Действие над Блоком. */
+export interface ToolPopoverEntry {
+    id: string;
+    label: ToolLabel;
+    popover: ToolPopoverRequest["popover"];
+}
+/** Что открыть: рамку держит `RichTextEditor` (`SelectionPopover`). */
+export interface ToolPopoverRequest {
+    /** Подпись записи — имя рамки. */
+    label: ToolLabel;
+    /** Содержимое; `pos` — Блок у поповера или, у каретки, начало выделения. */
+    popover: (props: {
+        editor: Editor;
+        close: () => void;
+        pos: number;
+    }) => ReactNode;
+    /** Классы рамки вместо умолчания (`popoverFrame` кнопки кита). */
+    className?: string;
+    /** Позиция Блока: поповер у Блока. Нет — у выделения. */
+    block?: number;
+}
+export interface ToolButtonsOptions {
+    /** Кнопки описаний включённых Инструментов — в порядке списка. */
+    buttons: readonly KitToolButton[];
+    /** Пункты вставки и Действия над Блоком с поповером. */
+    entries: readonly ToolPopoverEntry[];
+    /** Открыть поповер у выделения или у Блока: его держит `RichTextEditor`. */
+    openPopover: (request: ToolPopoverRequest) => void;
+}
+/**
+ * Сочетание из нотации Панели (`["mod", "K"]`) — в имя клавиши ProseMirror
+ * (`Mod-k`). Буква — строчной: заглавную keymap читает как клавишу с Shift.
+ */
+export declare function keymapName(keys: readonly string[]): string;
+/**
+ * Часть для движка у кнопок описаний (ADR-0058, п. 5.7): сочетание — поле
+ * записи и единственный его источник, поэтому клавишу вешает кит, а не Часть
+ * для движка Инструмента. `run` выполняется, поповер открывается у выделения.
+ * Недоступная кнопка клавишу не берёт: она идёт дальше, в Документ.
+ */
+export declare const ToolButtons: Extension<ToolButtonsOptions, any>;
+//# sourceMappingURL=toolButtons.d.ts.map

package/dist/editor/core/toolButtons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolButtons.d.ts","sourceRoot":"","sources":["../../../src/editor/core/toolButtons.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,QAAQ,cAAc,CAAC;IAC5B,UAAU,QAAQ,CAAC,UAAU;QAC3B,WAAW,EAAE;YACX;;;;;eAKG;YACH,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,UAAU,CAAC;SAC7D,CAAC;KACH;CACF;AAED,+EAA+E;AAC/E,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;CACxC;AAED,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,kCAAkC;IAClC,KAAK,EAAE,SAAS,CAAC;IACjB,4EAA4E;IAC5E,OAAO,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,SAAS,CAAC;IAClF,kEAAkE;IAClE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,kEAAkE;IAClE,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;IAClC,wDAAwD;IACxD,OAAO,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACrC,4EAA4E;IAC5E,WAAW,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACpD;AAeD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAI1D;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,oCAuDtB,CAAC"}

package/dist/editor/core/toolButtons.js

@@ -0,0 +1,64 @@
+"use client";
+import { Extension } from "@tiptap/core";
+function available(editor, button) {
+    return editor.isEditable && (button.isVisible?.(editor) ?? true) && button.can(editor);
+}
+const KEY_NAMES = {
+    mod: "Mod",
+    alt: "Alt",
+    shift: "Shift",
+    "↑": "ArrowUp",
+    "↓": "ArrowDown",
+};
+export function keymapName(keys) {
+    return keys
+        .map((key) => KEY_NAMES[key] ?? (/^[A-Z]$/.test(key) ? key.toLowerCase() : key))
+        .join("-");
+}
+export const ToolButtons = Extension.create({
+    name: "toolButtons",
+    addOptions: () => ({ buttons: [], entries: [], openPopover: () => { } }),
+    addCommands() {
+        return {
+            openToolPopover: (id, block) => ({ editor, dispatch }) => {
+                const button = this.options.buttons.find((candidate) => candidate.id === id);
+                const entry = this.options.entries.find((candidate) => candidate.id === id);
+                if (!editor.isEditable)
+                    return false;
+                if (button ? !button.popover || !available(editor, button) : !entry)
+                    return false;
+                if (!dispatch)
+                    return true;
+                if (button?.popover) {
+                    const { label, popover, popoverFrame } = button;
+                    this.options.openPopover({ label, popover, className: popoverFrame?.className });
+                }
+                else if (entry) {
+                    requestAnimationFrame(() => {
+                        if (!editor.isDestroyed)
+                            this.options.openPopover({ ...entry, block });
+                    });
+                }
+                return true;
+            },
+        };
+    },
+    addKeyboardShortcuts() {
+        return Object.fromEntries(this.options.buttons.flatMap((button) => button.shortcut
+            ? [
+                [
+                    keymapName(button.shortcut),
+                    () => {
+                        if (button.popover)
+                            return this.editor.commands.openToolPopover(button.id);
+                        if (!available(this.editor, button))
+                            return false;
+                        button.run(this.editor);
+                        return true;
+                    },
+                ],
+            ]
+            : []));
+    },
+});
+//# sourceMappingURL=toolButtons.js.map

package/dist/editor/core/toolButtons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolButtons.js","sourceRoot":"","sources":["../../../src/editor/core/toolButtons.ts"],"names":[],"mappings":"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"}

package/dist/editor/core/toolDescriptor.d.ts

@@ -0,0 +1,304 @@
+import type { Editor, Extensions } from "@tiptap/core";
+import type { ComponentType, ReactNode } from "react";
+import type { UiMessages } from "../../i18n/messages.js";
+import type { IconProps } from "../../icons.js";
+import type { BlockTypeItem } from "./blockTypes.js";
+import type { TextCardRangeAt, CustomTextCardRender, CustomTool, CustomTrigger, PrefixedName } from "./customTool.js";
+import type { EditorExtensionOptions } from "./extensions.js";
+import type { InsertItem } from "./insertItems.js";
+import type { ShortcutCommand, ShortcutGroup } from "./shortcuts.js";
+import type { ToolLoader } from "./toolLoader.js";
+import type { Tool } from "./tools.js";
+/**
+ * Внутреннее описание встроенного Инструмента (ADR-0058, п. 10).
+ *
+ * НАДФОРМА. Тип — надмножество будущего публичного описания своего
+ * Инструмента: те же Часть для движка, Признаки Блока и UI-записи, а сверху
+ * привилегии кита, которых своему Инструменту не дают (теги Схемы кита,
+ * модель содержимого, виджеты Панели, своё место в порядке поверхности).
+ * Наружу описания встроенных не экспортируются: публичны только имена и
+ * пресеты.
+ *
+ * ОДИН СПИСОК. `tools` и `preset` разворачиваются в список описаний
+ * (`expandTools`, `features/builtins.ts`), и реестры по имени — движок, Меню
+ * вставки, «¶», справочник сочетаний и следующие за ними — читают его
+ * проекцию (`projectRecords`). Правило «выключенный Инструмент убирает и
+ * кнопку, и Схему» этим держится само: записи и Часть для движка Инструмента,
+ * которого нет в списке, не попадают никуда.
+ *
+ * ПЕРЕЕЗД ПОСТЕПЕННЫЙ. Встроенный Инструмент без описания стоит в списке
+ * заглушкой `legacy` и берётся из старых реестров (`INSERT_ITEMS`, `SHORTCUTS`,
+ * `createEditorExtensions`…). Переезд Инструмента — его записи удаляются из
+ * старых реестров и ложатся в описание в `BUILTIN_TOOLS`; место на поверхности
+ * при этом не меняется — его держит порядок кита этой поверхности
+ * (`INSERT_ORDER`, `BLOCK_TYPE_ORDER`), а не реестр записей.
+ */
+export interface ToolDescriptor {
+    /** Имя Инструмента — то же, что в `tools`; у своего — с Префиксом потребителя. */
+    name: Tool | PrefixedName;
+    /**
+     * Заглушка не переехавшего встроенного: его записи и Часть для движка — в
+     * старых реестрах. Остальные поля у заглушки пусты, кроме `blockActions`:
+     * Действия над Блоком переезжают отдельно от остального и
+     * читаются у всех описаний списка, переехавших и нет (`blockActionsOf`).
+     */
+    legacy?: true;
+    /**
+     * Часть для движка: расширения Tiptap Инструмента — Node, Mark, Extension,
+     * плагины ProseMirror. Функция от контекста — привилегия кита: встроенным
+     * нужны мосты `RichTextEditor` (поповер ссылки, Меню вставки, `Alt+F10`).
+     */
+    engine?: (context: ToolEngineContext) => Extensions;
+    /**
+     * Загрузчик Части для движка (`toolLoader.ts`): движок создаётся после
+     * загрузчиков всех описаний списка, и `engine` читает отданное `loaded`.
+     */
+    load?: ToolLoader;
+    /**
+     * Форма Блоков для Скелета, пока загрузчик не отработал (`skeleton.ts`):
+     * лёгкие узлы с той же разметкой и тем же разбором атрибутов, без плагинов
+     * и тяжёлых пакетов. Привилегия ленивого встроенного: без неё его Блоки в
+     * Скелете видны текстом, и поле прыгает по высоте с приходом чанка.
+     */
+    skeleton?: () => Extensions;
+    /** Признаки Блока по имени узла; кит переносит их в spec узла. Нет — обычный Блок. */
+    blocks?: Readonly<Record<string, BlockTraits>>;
+    /**
+     * Кнопки Панели (фиксированной и плавающей — набор один), флагом — и Меню
+     * выделения. Место встроенной кнопки на Панели — привилегия кита: её
+     * отводит Панель по имени Инструмента (`EditorToolbar.tsx`).
+     */
+    buttons?: readonly KitToolButton[];
+    /** Пункты Меню вставки: «/», «+», «Добавить ›» и «Формат ›» Ручки Блока. */
+    insertItems?: readonly InsertItem[];
+    /** Действия над Блоком в меню Ручки Блока. */
+    blockActions?: readonly BlockAction[];
+    /** Карточки у текста: у встроенных их пока нет, но форма одна (ADR-0058, п. 7.6). */
+    textCards?: readonly TextCardRecord[];
+    /** Символы-триггеры: у встроенных их нет, у своего Инструмента — один (ADR-0064). */
+    triggers?: readonly TriggerRecord[];
+    /**
+     * Публичное описание своего Инструмента, из которого собрано это
+     * (`customToolEngine.ts`): по нему набор проверяется при сборке.
+     */
+    custom?: CustomTool;
+    /**
+     * Теги Схемы кита, которые пишет Инструмент (`p`, `h1`–`h4`, `a`, `table`…).
+     * Свой Инструмент их не получает: его HTML — `data-block` и `data-mark`.
+     */
+    kitTags?: readonly string[];
+    /**
+     * Модель содержимого: узлы, которые Документ называет поимённо, а не через
+     * группу `block`, — контейнеры верхнего уровня, как Раскладка и Обёртка
+     * (`document.ts`).
+     */
+    documentContent?: readonly string[];
+    /** Пункты виджета «¶» Панели: у него свои слова и иконки (`blockTypes.ts`). */
+    blockTypes?: readonly BlockTypeItem[];
+    /**
+     * Строки справочника сочетаний для клавиш, которые вешает Часть для движка
+     * (`shortcuts.ts`): у записи сочетание — её поле, а у Метки из движка — нет.
+     */
+    shortcuts?: readonly ShortcutCommand[];
+}
+/** Символ-триггер Инструмента в списке описаний: публичная запись и имя владельца для сообщений. */
+export type TriggerRecord = CustomTrigger & {
+    tool: string;
+};
+/** Что Часть для движка встроенного получает от `RichTextEditor`. */
+export type ToolEngineContext = Omit<EditorExtensionOptions, "tools">;
+type EditorMessages = UiMessages["editor"];
+/**
+ * Признаки Блока, которые понимает только кит. Все выключены по умолчанию:
+ * обычный Блок — не контейнер, без «Превратить в», с меню форматирования.
+ */
+export interface BlockTraits {
+    /** Контейнер: Блоки внутри — со своей Ручкой Блока (`blockContainer` в spec узла). */
+    container?: boolean;
+    /** Блок можно превратить в другой: «Формат ›» Ручки Блока и «¶». */
+    turnInto?: boolean;
+    /** Атом без меню форматирования: кнопки Меток над ним не показываются. */
+    plainAtom?: boolean;
+}
+/**
+ * Подпись записи — строка или функция от контекста (ADR-0058, п. 6.1). Кит
+ * зовёт её при отрисовке, поэтому смена локали `UiProvider` перерисовывает
+ * запись. Встроенным в контекст кладутся ещё и `messages` кита: форма подписи
+ * у своего и встроенного одна.
+ */
+export type ToolLabel = string | ((context: ToolLabelContext) => string);
+export interface ToolLabelContext {
+    /** Локаль `UiProvider` (`useUiLocale`). */
+    locale: string;
+    /** Строки Редактора из каталога кита — для встроенных Инструментов. */
+    messages: EditorMessages;
+}
+/** Подпись записи в текущем контексте. */
+export declare function toolLabel(label: ToolLabel, context: ToolLabelContext): string;
+/**
+ * Содержимое поповера кнопки. Рамку держит кит: слой, якорь, стек Escape
+ * (ADR-0041), имя рамки — подпись кнопки, возврат фокуса и выделения в
+ * Документ. `close` закрывает поповер тем же путём, что Escape.
+ */
+export type ToolPopover = (props: {
+    editor: Editor;
+    close: () => void;
+}) => ReactNode;
+interface ToolButtonFields {
+    /** Стабильный ключ, уникальный среди кнопок Панели. */
+    id: string;
+    label: ToolLabel;
+    icon: ComponentType<IconProps>;
+    /** Доступна ли кнопка сейчас. В нередактируемом поле кит выключает кнопки сам, проверять это здесь не нужно. */
+    can: (editor: Editor) => boolean;
+    /** Есть — кнопка-переключатель с `aria-pressed`; нет — разовое действие. */
+    isActive?: (editor: Editor) => boolean;
+    /** Предикат видимости по контексту; нет — кнопка видна всегда. */
+    isVisible?: (editor: Editor) => boolean;
+    /** Кнопка стоит и в Меню выделения. */
+    selectionMenu?: boolean;
+    /**
+     * Сочетание в нотации Панели (`mod`, `alt`, `shift`, клавиша) — единственный
+     * его источник: кит сам вешает клавишу, пишет её в подсказку,
+     * `aria-keyshortcuts` и справочник сочетаний.
+     */
+    shortcut?: readonly string[];
+}
+/**
+ * Кнопка Панели (фиксированной и плавающей — набор один), флагом — и Меню
+ * выделения. Подсказка — подпись и `Kbd` сочетания; `aria-pressed` — только
+ * при `isActive`. Форма та же, что у будущей публичной кнопки своего
+ * Инструмента (ADR-0058, п. 5).
+ *
+ * ДЕЙСТВИЕ ИЛИ ПОПОВЕР — ровно одно из двух. `run` выполняется щелчком и
+ * сочетанием. `popover` открывается щелчком у кнопки, а сочетанием — у
+ * каретки: кнопки на экране может и не быть (`toolbar="none"`, спрятанная
+ * плавающая Панель).
+ */
+export type ToolButton = ToolButtonFields & ({
+    run: (editor: Editor) => void;
+    popover?: undefined;
+} | {
+    popover: ToolPopover;
+    run?: undefined;
+});
+/**
+ * Кнопка встроенного Инструмента: публичная форма и привилегии кита, которых
+ * своей кнопке не дают.
+ */
+export type KitToolButton = ToolButton & {
+    /**
+     * Группа справочника сочетаний. Нет — строка встаёт в группу Инструмента без
+     * заголовка после групп кита, как у своего Инструмента.
+     */
+    shortcutGroup?: ShortcutGroup;
+    /** Рамка поповера, если она не умолчание кита (у кнопки, по содержимому). */
+    popoverFrame?: {
+        /**
+         * `selection` — рамка всегда у выделения, и щелчком по кнопке тоже: поповер
+         * правит выделенный текст, и стоит у него при любом способе открыть
+         * (поповер ссылки).
+         */
+        anchor?: "selection";
+        /** Классы размера и отступов рамки вместо умолчания `w-auto p-2`. */
+        className?: string;
+    };
+};
+/** Действие над Блоком: пункт меню Ручки Блока, в секции Инструмента перед «Удалить». */
+export interface BlockAction {
+    id: string;
+    /** Подпись в локали `UiProvider`: у встроенных — строка каталога, у своих — `ToolLabel`. */
+    label: (messages: EditorMessages, locale: string) => string;
+    icon: ComponentType<IconProps>;
+    /**
+     * Имена Блоков, для которых действие показывается: имя Блока Ручки или
+     * контейнера, в котором он стоит прямо (`blockContainer` в spec узла). Так
+     * «Снять обёртку» с `["wrapper"]` есть и у самой Обёртки, и у Блока в ней.
+     */
+    blocks: readonly string[];
+    /**
+     * Сочетание, которое вешает кит (ADR-0058, п. 5.7): на Блок под кареткой, у
+     * которого действие видно. У встроенных нет.
+     */
+    shortcut?: readonly string[];
+    /** `pos` — позиция Блока Ручки в Документе. */
+    run: (editor: Editor, pos: number) => void;
+    /**
+     * Поповер своего Инструмента у Блока (ADR-0058, п. 5.6). `run` такого
+     * Действия открывает его — меню Ручки и сочетание о поповере не знают.
+     */
+    popover?: (props: {
+        editor: Editor;
+        close: () => void;
+        pos: number;
+    }) => ReactNode;
+    isVisible?: (editor: Editor, pos: number) => boolean;
+}
+/**
+ * Карточка у текста: диапазон у каретки и тело; рамку держит кит
+ * (`TextCard.tsx`, ADR-0058, п. 7.6–7.11).
+ */
+export interface TextCardRecord {
+    id: string;
+    /** Подпись в локали `UiProvider`: доступное имя рамки и часть фразы о появлении. */
+    label: (messages: EditorMessages, locale: string) => string;
+    rangeAt: TextCardRangeAt;
+    render: CustomTextCardRender;
+}
+/**
+ * Развёрнутый набор Инструментов: список описаний и — как `Set` — имена
+ * включённых Инструментов кита.
+ *
+ * Набор имён — тоже проекция списка: реестры, которые ещё фильтруют свои
+ * записи по имени (`tools.has("table")`), читают его без правок. Свои
+ * Инструменты есть только в списке описаний.
+ */
+export interface ToolList extends ReadonlySet<Tool> {
+    /**
+     * Описания включённых Инструментов: встроенные в порядке кита (у не
+     * переехавших — заглушки `legacy`), за ними свои в порядке `tools`.
+     */
+    readonly descriptors: readonly ToolDescriptor[];
+}
+/**
+ * Набор из имён кита и списка описаний — единственный способ его собрать:
+ * развернуть `tools` (`expandTools`) или сузить готовый (Скелет).
+ */
+export declare function toolList(names: Iterable<Tool>, descriptors: readonly ToolDescriptor[]): ToolList;
+/** Описания переехавших Инструментов набора — в порядке списка. */
+export declare function describedTools(tools: ToolList): readonly ToolDescriptor[];
+/**
+ * Действия над Блоком набора — проекция списка описаний, в порядке кита. Фильтра
+ * по Блоку здесь нет: имя и предикат видимости спрашивает меню Ручки на
+ * своём Блоке (`blockActionVisible`).
+ */
+export declare function blockActionsOf(tools: ToolList): readonly BlockAction[];
+/**
+ * Карточки у текста набора в порядке списка: при равной ширине диапазона
+ * выигрывает та, что раньше, то есть Инструмент раньше в `tools`.
+ */
+export declare function textCardsOf(tools: ToolList): readonly TextCardRecord[];
+/** Символы-триггеры набора в порядке списка (ADR-0064). */
+export declare function triggersOf(tools: ToolList): readonly TriggerRecord[];
+/**
+ * Показывается ли действие у Блока `pos`: `block` — имя этого Блока, `container`
+ * — имя контейнера, в котором он стоит прямо (у Блока Документа это сам Документ).
+ */
+export declare function blockActionVisible(action: BlockAction, editor: Editor, pos: number, block: {
+    name: string;
+    container: string;
+}): boolean;
+/**
+ * Записи одной поверхности — проекция списка описаний.
+ *
+ * - `order` — место встроенных Инструментов на поверхности, привилегия кита.
+ *   Инструменты набора вне него идут следом, в порядке списка: так встаёт
+ *   запись, у которой своего места на поверхности нет.
+ * - `legacy` — старый реестр: записи Инструмента, ещё не переехавшего на описание.
+ * - `own` — поле описания с записями этой поверхности.
+ *
+ * Фильтра по включённым Инструментам здесь нет: его держит сам список.
+ */
+export declare function projectRecords<R>(tools: ToolList, order: readonly Tool[], legacy: (name: Tool) => readonly R[] | undefined, own: (descriptor: ToolDescriptor) => readonly R[] | undefined): R[];
+export {};
+//# sourceMappingURL=toolDescriptor.d.ts.map

package/dist/editor/core/toolDescriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptor.d.ts","sourceRoot":"","sources":["../../../src/editor/core/toolDescriptor.ts"],"names":[],"mappings":"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"}

package/dist/editor/core/toolDescriptor.js

@@ -0,0 +1,29 @@
+export function toolLabel(label, context) {
+    return typeof label === "string" ? label : label(context);
+}
+export function toolList(names, descriptors) {
+    return Object.assign(new Set(names), { descriptors });
+}
+export function describedTools(tools) {
+    return tools.descriptors.filter((descriptor) => !descriptor.legacy);
+}
+export function blockActionsOf(tools) {
+    return tools.descriptors.flatMap((descriptor) => descriptor.blockActions ?? []);
+}
+export function textCardsOf(tools) {
+    return tools.descriptors.flatMap((descriptor) => descriptor.textCards ?? []);
+}
+export function triggersOf(tools) {
+    return tools.descriptors.flatMap((descriptor) => descriptor.triggers ?? []);
+}
+export function blockActionVisible(action, editor, pos, block) {
+    return ((action.blocks.includes(block.name) || action.blocks.includes(block.container)) &&
+        (action.isVisible?.(editor, pos) ?? true));
+}
+export function projectRecords(tools, order, legacy, own) {
+    const list = tools.descriptors;
+    const placed = order.flatMap((name) => list.filter((descriptor) => descriptor.name === name));
+    const rest = list.filter((descriptor) => !order.includes(descriptor.name));
+    return [...placed, ...rest].flatMap((descriptor) => (descriptor.legacy ? legacy(descriptor.name) : own(descriptor)) ?? []);
+}
+//# sourceMappingURL=toolDescriptor.js.map

package/dist/editor/core/toolDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolDescriptor.js","sourceRoot":"","sources":["../../../src/editor/core/toolDescriptor.ts"],"names":[],"mappings":"AA4JA,MAAM,UAAU,SAAS,CAAC,KAAgB,EAAE,OAAyB;IACnE,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC5D,CAAC;AAiID,MAAM,UAAU,QAAQ,CAAC,KAAqB,EAAE,WAAsC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;AACxD,CAAC;AAGD,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,OAAO,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;AACtE,CAAC;AAOD,MAAM,UAAU,cAAc,CAAC,KAAe;IAC5C,OAAO,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;AAClF,CAAC;AAMD,MAAM,UAAU,WAAW,CAAC,KAAe;IACzC,OAAO,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC;AAGD,MAAM,UAAU,UAAU,CAAC,KAAe;IACxC,OAAO,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;AAC9E,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,MAAc,EACd,GAAW,EACX,KAA0C;IAE1C,OAAO,CACL,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAC/E,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,CAC1C,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,cAAc,CAC5B,KAAe,EACf,KAAsB,EACtB,MAAgD,EAChD,GAA6D;IAE7D,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;IAC/B,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;IAC9F,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAE,KAA2B,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,OAAO,CAEjC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAY,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAC9F,CAAC;AACJ,CAAC"}