@olddevs/ui 0.0.0-stage → 4.0.0

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

@@ -0,0 +1,407 @@
+import type { ChainedCommands, Editor, Extensions } from "@tiptap/core";
+import type { EditorState } from "@tiptap/pm/state";
+import type { ComponentType, ReactNode } from "react";
+import type { IconProps } from "../../icons.js";
+import type { Tool as ToolName } from "./tools.js";
+export type { ToolName };
+/**
+ * Имя с Префиксом потребителя: префикс, подчёркивание, остаток — `acme_mergeTag`.
+ * В именах кита подчёркивания не бывает, поэтому своё и встроенное не
+ * пересекаются. Подчёркивание, а не дефис: в выражениях content ProseMirror
+ * имя узла должно быть словом.
+ */
+export type PrefixedName = `${string}_${string}`;
+/**
+ * Вид значения своего атрибута. Проверяет код кита — и в Редакторе, и на
+ * сервере; функций-проверок у потребителя нет.
+ *
+ * - `list` — одно из значений `values`;
+ * - `pattern` — регулярное выражение строкой на ВСЁ значение (кит сам ставит
+ *   `^…$`), как `customColor` в Схеме кита;
+ * - `url` — адрес по политике протоколов кита: абсолютный `http`, `https` или
+ *   `mailto`, как у ссылки.
+ */
+export type CustomAttribute = {
+    kind: "list";
+    values: readonly string[];
+} | {
+    kind: "pattern";
+    pattern: string;
+} | {
+    kind: "url";
+};
+/**
+ * Правила Схемы своего Блока и его Признаки.
+ *
+ * HTML Блока пишет кит по соглашению: блочный — `div[data-block="<имя>"]`,
+ * строчный — `span[data-block="<имя>"]`, атрибут `acme_size` — `data-acme_size`.
+ */
+export interface CustomBlock {
+    /** Блочный (`div`, группа `block`) или строчный (`span`, группа `inline`). */
+    kind: "block" | "inline";
+    /**
+     * Где стоит блочный Блок: `anywhere` (по умолчанию) — везде, где Блок
+     * Документа; `top` — только верхний уровень Документа, как Раскладка.
+     */
+    place?: "anywhere" | "top";
+    /** Свои атрибуты: имя с Префиксом потребителя — вид значения. */
+    attributes?: Readonly<Record<PrefixedName, CustomAttribute>>;
+    /** Признак «контейнер»: Блоки внутри — со своей Ручкой Блока, как у Обёртки. */
+    container?: boolean;
+    /** Признак «можно превратить в»: «Формат ›» Ручки Блока доступен и для него. */
+    turnInto?: boolean;
+    /** Признак «атом без меню форматирования»: над выделенным Блоком нет Меню выделения. */
+    plainAtom?: boolean;
+    /**
+     * Остров Блока в `RichTextView` — клиентский компонент из модуля с
+     * директивой `"use client"` (ADR-0058, п. 3.3). Без него Блок в Просмотре —
+     * очищенный HTML. Редактор поле не читает: его вид — Часть для движка.
+     *
+     * Только компонент из модуля с директивой: серверный компонент и функция-
+     * загрузчик через границу RSC не проходят — сервер получает ссылку на
+     * клиентский компонент, а код его загружается, лишь когда Блок есть в
+     * Документе. Очистка и Схема поле не читают.
+     */
+    island?: ComponentType<CustomIslandProps>;
+}
+/**
+ * Что получает Остров своего Блока: имя Блока, его атрибуты и текст. Атрибуты —
+ * только объявленные в `attributes` Блока, по их именам без `data-`
+ * (`acme_size`), значения как в очищенном HTML Документа; необъявленный
+ * атрибут компонент не видит. Текст — `textContent` Блока из серверного HTML.
+ */
+export interface CustomIslandProps {
+    /** Имя Блока — ключ `blocks`, один компонент может обслуживать несколько Блоков. */
+    block: string;
+    /** Объявленные атрибуты Блока, которые есть в HTML. */
+    attributes: Readonly<Record<string, string>>;
+    /** Текст Блока: для атома — его Текст из серверного HTML, часто пустой. */
+    text: string;
+}
+/** Правила Схемы своей Метки: HTML — `span[data-mark="<имя>"]`. */
+export interface CustomMark {
+    /** Свои атрибуты Метки: имя с Префиксом потребителя — вид значения. */
+    attributes?: Readonly<Record<PrefixedName, CustomAttribute>>;
+}
+/**
+ * Описание своего Инструмента — публичное подмножество внутреннего описания
+ * встроенных (`ToolDescriptor`, ADR-0058, п. 10). Передаётся в `tools`
+ * вперемешку с именами Инструментов кита.
+ *
+ * Обязательное — имя, Часть для движка и правила Схемы для каждого Блока и
+ * Метки, которые она определяет. Остальное — по умолчанию (ADR-0058, п. 1.6):
+ * обычный Блок без Признаков, без UI-записей.
+ */
+export interface CustomTool {
+    /** Имя с Префиксом потребителя, уникальное в `tools`. */
+    name: PrefixedName;
+    /**
+     * Часть для движка — расширения Tiptap: Node, Mark, Extension, плагины
+     * ProseMirror, React-вид узла, `renderText` атома. Её контракт следует
+     * мажору Tiptap. Node и Mark стоят на верхнем уровне массива: группу,
+     * разбор HTML и свои атрибуты им ставит кит по правилам.
+     *
+     * Сразу массивом или загрузчиком — функцией с динамическим импортом, которая
+     * отдаёт промис того же массива: `() => import("./engine.js").then((m) =>
+     * m.engine)`. С загрузчиком модуль описания импортируется и на сервере, без
+     * Tiptap и React. Движок создаётся после загрузчиков всех Инструментов, до
+     * того поле показывает Скелет; промис кэшируется на функции загрузчика.
+     */
+    engine: Extensions | (() => Promise<Extensions>);
+    /** Правила Схемы для каждого Node Части для движка — по имени узла. */
+    blocks?: Readonly<Record<PrefixedName, CustomBlock>>;
+    /** Правила Схемы для каждой Mark Части для движка — по имени Метки. */
+    marks?: Readonly<Record<PrefixedName, CustomMark>>;
+    /**
+     * Кнопки Панели, фиксированной и плавающей (набор один). Встают одной
+     * группой перед «Отменить» и «Повторить», в порядке `tools` и порядке
+     * массива; выключенный Инструмент уносит их вместе с собой.
+     */
+    buttons?: readonly CustomToolButton[];
+    /** Пункты Меню вставки: «/», «+», «Добавить ›» и «Формат ›» Ручки Блока. */
+    insertItems?: readonly CustomInsertItem[];
+    /** Действия над Блоком в меню Ручки Блока — секцией перед «Удалить». */
+    blockActions?: readonly CustomBlockAction[];
+    /**
+     * Карточки у текста (ADR-0058, п. 7.6–7.11): кит показывает их под Меткой
+     * или другим диапазоном, у которого стоит каретка. Открыта не больше
+     * одной: побеждает самый узкий диапазон под кареткой, при равной ширине —
+     * Инструмент раньше в `tools`.
+     */
+    textCards?: readonly CustomTextCard[];
+    /**
+     * Свой символ-триггер (ADR-0064): набор `char` в начале Блока или после
+     * пробела открывает список пунктов у каретки — тот же, что рисует Меню
+     * вставки «/». Один триггер на Инструмент; символ уникален в `tools`.
+     */
+    trigger?: CustomTrigger;
+}
+/**
+ * Пункт списка своего триггера. Рисует его кит: иконка и подпись; фильтрует
+ * по набранному сам потребитель — в `items`, поэтому `aliases` здесь нет.
+ */
+export interface TriggerItem {
+    /** Ключ пункта, уникальный в одном ответе `items`. */
+    id: string;
+    /** Подпись — текст строки; на языке интерфейса её готовит потребитель. */
+    label: string;
+    /** Иконка строки — компонент с контрактом `IconProps`; нет — строка без иконки. */
+    icon?: ComponentType<IconProps>;
+    /** Любые данные потребителя: кит их не читает и отдаёт в `onSelect` как есть. */
+    data?: unknown;
+}
+/**
+ * Что получает `onSelect`: `range` — набранное вместе с символом (`@запрос`),
+ * его кит НЕ удаляет, а обработчик заменяет своим узлом; `query` — запрос без
+ * символа.
+ */
+export interface TriggerContext {
+    /** Редактор (сырой Tiptap) — для вставки своего узла. */
+    editor: Editor;
+    /** Диапазон `@запрос` в Документе: позиции ProseMirror, `from < to`. */
+    range: {
+        from: number;
+        to: number;
+    };
+    /** Набранное после символа, без самого символа. */
+    query: string;
+}
+/**
+ * Свой символ-триггер Инструмента (ADR-0064): упоминания по `@`, теги по `#`.
+ *
+ * Правила открытия те же, что у «/»: символ стоит в начале Блока или после
+ * пробела (внутри слова — `a@b.com` — список молчит), в блоке кода и в
+ * строчном коде не открывается. Запрос — до пробела. Фокус остаётся в
+ * Документе; стрелки, `Enter` и `Escape` — как у Меню вставки, пустой ответ —
+ * строка «Ничего не найдено».
+ */
+export interface CustomTrigger {
+    /**
+     * Один печатный знак, не `/` и не пробел: `@`, `#`, `:`. Два Инструмента с
+     * одним символом — ошибка набора (`console.error` в разработке и ошибка поля).
+     */
+    char: string;
+    /**
+     * Имя списка для скринридера: строка или функция от `{ locale }`. Нет — имя
+     * из каталога кита («Подсказки»).
+     */
+    label?: CustomToolLabel;
+    /**
+     * Пункты по запросу — сразу или промисом. Зовётся на каждое изменение
+     * запроса, в том числе с пустой строкой сразу после символа; ответ
+     * устаревшего запроса кит отбрасывает. Отклонённый промис — пустой список и
+     * `console.error` в разработке.
+     */
+    items: (query: string) => TriggerItem[] | Promise<TriggerItem[]>;
+    /**
+     * Пункт выбран (стрелки и `Enter` или щелчок). Обработчик заменяет
+     * `ctx.range` своим узлом одной транзакцией; кит после вызова закрывает
+     * список.
+     */
+    onSelect: (item: TriggerItem, ctx: TriggerContext) => void;
+}
+/**
+ * Годится ли символ в триггеры (ADR-0064): один печатный знак — не пробел и
+ * не управляющий, — кроме `/`, который занят Меню вставки. Знак вне BMP
+ * (эмодзи) — один знак.
+ */
+export declare function isTriggerChar(char: unknown): char is string;
+/** Диапазон Документа, к которому привязана Карточка: позиции ProseMirror, `from <= to`. */
+export interface TextCardRange {
+    from: number;
+    to: number;
+}
+/**
+ * Диапазон Карточки у каретки: `pos` — каретка (или место щелчка), ответ —
+ * диапазон, к которому привязана Карточка, или `null`, если здесь её нет.
+ * Для Метки готовый помощник — `markRange`. Функция читает только состояние и
+ * зовётся на каждой транзакции, поэтому должна быть быстрой и без побочных
+ * эффектов. Диапазон шире Документа или с `from > to` кит отбрасывает.
+ */
+export type TextCardRangeAt = (state: EditorState, pos: number) => TextCardRange | null;
+/**
+ * Тело Карточки у текста: `range` — диапазон из `rangeAt` на текущем состоянии
+ * (он едет за правкой), `close` прячет Карточку тем же путём, что Escape.
+ */
+export type CustomTextCardRender = (props: {
+    editor: Editor;
+    range: TextCardRange;
+    close: () => void;
+}) => ReactNode;
+/**
+ * Карточка у текста — четвёртый вид UI-записи (ADR-0058, п. 7.6–7.11):
+ * например, карточка комментария под Меткой-выделением.
+ *
+ * Рамку держит кит: слой и стек Escape как у `Popover` кита, якорь под
+ * диапазоном, переворот у края окна. Тело — React-узел `render`; заголовка и
+ * кнопок-данных у рамки нет, иконки у записи тоже. Карточка немодальна: фокус
+ * остаётся в Документе, печать продолжается; `Alt+F10` ведёт в Карточку, а
+ * Escape — обратно в Документ.
+ *
+ * Открывается свёрнутой кареткой внутри диапазона или щелчком по нему, но не
+ * наведением. При развёрнутом выделении закрыта (там работает Меню
+ * выделения). Escape и `close` прячут её, пока каретка не покинет диапазон;
+ * щелчок открывает снова. Работает и при `readOnly`: правки из `render` режет
+ * сам движок. В `RichTextView` Карточек нет.
+ */
+export interface CustomTextCard {
+    /**
+     * Подпись — строка или функция от `{ locale }`: доступное имя рамки и часть
+     * фразы, которой кит сообщает скринридеру о появлении Карточки. Иконки нет.
+     */
+    label: CustomToolLabel;
+    /** Диапазон под кареткой: для Метки — `markRange("acme_comment")`. */
+    rangeAt: TextCardRangeAt;
+    /** Тело Карточки; монтируется заново на каждое открытие. */
+    render: CustomTextCardRender;
+}
+/**
+ * Пункт Меню вставки своего Инструмента (ADR-0058, п. 5).
+ *
+ * Сам попадает в «/», «+», «Добавить ›» и «Формат ›» Ручки Блока: меню кит
+ * правит без потребителя. Пункт встаёт в конец своего раздела, свои пункты —
+ * в порядке `tools`. Выключенный Инструмент убирает и пункт.
+ *
+ * Раздел решает, что делается с Документом, а `run` — какой Блок: в `insert`
+ * кит готовит пустой абзац (текущий пустой или новый сразу за Блоком), в
+ * `turnInto` — снимает со Блока обёртки (список, цитату). Подготовка и `run`
+ * идут одной транзакцией, поэтому правка отменяется одним `Ctrl+Z`.
+ *
+ * Ровно одно из двух: `run` или `popover` (ADR-0058, п. 5.6). Поповер — та же
+ * рамка кита, что у кнопки, и встаёт у каретки при любом способе вызова.
+ */
+export type CustomInsertItem = CustomInsertItemFields & ({
+    /** Команда над цепочкой: вернуть её с командой Блока, `.run()` зовёт кит. */
+    run: (chain: ChainedCommands, editor: Editor) => ChainedCommands;
+    popover?: undefined;
+} | {
+    /**
+     * Поповер вместо команды — у каретки (из «/» — там, где стоял «/»).
+     * Документ кит не готовит: убирает набранную «/команду», а содержимое
+     * в Документ ставит сам поповер через `editor`.
+     */
+    popover: CustomToolPopover;
+    run?: undefined;
+});
+interface CustomInsertItemFields {
+    /** «Добавить» — новый Блок после текущего, «Превратить в» — сменить текущий. */
+    section: "insert" | "turnInto";
+    /** Подпись — строка или функция от `{ locale }`; поиск идёт и по ней. */
+    label: CustomToolLabel;
+    /** Компонент с контрактом `IconProps`: из словаря `@olddevs/ui/icons` или свой. */
+    icon: ComponentType<IconProps>;
+    /** Слова для поиска сверх подписи — на любом языке; подписи кит ищет сам. */
+    aliases?: readonly string[];
+    /**
+     * Сочетание в нотации Панели (`mod`, `alt`, `shift`, клавиша). Единственный
+     * источник: кит сам вешает клавишу, пишет её в подсказку пункта и в
+     * справочник сочетаний.
+     */
+    shortcut?: readonly string[];
+}
+/**
+ * Действие над Блоком своего Инструмента — пункт меню Ручки Блока (ADR-0058,
+ * п. 5). Свои Действия стоят секцией перед «Удалить», в порядке `tools`.
+ *
+ * Ровно одно из двух: `run` или `popover` (ADR-0058, п. 5.6). Поповер встаёт у
+ * Блока: выбором в меню Ручки — у её Блока, сочетанием — у Блока под кареткой.
+ */
+export type CustomBlockAction = CustomBlockActionFields & ({
+    /** `pos` — позиция Блока Ручки в Документе. Одна правка — одна отмена. */
+    run: (editor: Editor, pos: number) => void;
+    popover?: undefined;
+} | {
+    /** Поповер вместо действия — у Блока; содержимое получает и `pos` Блока. */
+    popover: CustomToolPopover<{
+        pos: number;
+    }>;
+    run?: undefined;
+});
+interface CustomBlockActionFields {
+    /** Подпись — строка или функция от `{ locale }`. */
+    label: CustomToolLabel;
+    /** Компонент с контрактом `IconProps`. */
+    icon: ComponentType<IconProps>;
+    /**
+     * Имена Блоков, для которых действие показывается: имя Блока Ручки или
+     * контейнера, в котором он стоит прямо.
+     */
+    blocks: readonly string[];
+    /** Сочетание в нотации Панели; кит вешает его на Блок под кареткой. */
+    shortcut?: readonly string[];
+    /** Видимость по контексту; нет — действие видно у всех своих `blocks`. */
+    isVisible?: (editor: Editor, pos: number) => boolean;
+}
+/**
+ * Подпись записи — строка или функция от контекста (ADR-0058, п. 6.1). Кит
+ * зовёт функцию при отрисовке с локалью `UiProvider`, поэтому смена локали
+ * перерисовывает запись. Строка подходит одноязычному приложению.
+ */
+export type CustomToolLabel = string | ((context: {
+    locale: string;
+}) => string);
+/**
+ * Содержимое поповера кнопки, пункта вставки и Действия над Блоком. Рамку
+ * держит кит: слой, якорь, стек Escape, возврат фокуса и выделения в Документ;
+ * `close` закрывает поповер тем же путём, что Escape. `Extra` — что запись
+ * добавляет к `editor` и `close`: у Действия над Блоком — `{ pos }` его Блока.
+ */
+export type CustomToolPopover<Extra extends object = object> = (props: {
+    editor: Editor;
+    close: () => void;
+} & Extra) => ReactNode;
+interface CustomToolButtonFields {
+    /** Ключ кнопки, уникальный в своём Инструменте: с id кита и чужих Инструментов не сталкивается. */
+    id: string;
+    /** Подпись: имя кнопки для скринридера, текст подсказки и имя поповера. Пустая — имя Инструмента. */
+    label: CustomToolLabel;
+    /** Иконка — компонент с контрактом `IconProps` из словаря кита или своя. Обязательна. */
+    icon: ComponentType<IconProps>;
+    /** Доступна ли кнопка сейчас. В нередактируемом поле кит выключает кнопки сам, проверять это здесь не нужно. */
+    can: (editor: Editor) => boolean;
+    /** Есть — кнопка-переключатель с `aria-pressed`; нет — разовое действие. */
+    isActive?: (editor: Editor) => boolean;
+    /** Предикат видимости по контексту; нет — кнопка видна всегда. */
+    isVisible?: (editor: Editor) => boolean;
+    /** Кнопка стоит ещё и в Меню выделения. */
+    selectionMenu?: boolean;
+    /**
+     * Сочетание в нотации Панели: `mod`, `alt`, `shift` и клавиша —
+     * `["mod", "shift", "Y"]`. Единственный источник: кит сам вешает клавишу,
+     * пишет её в подсказку, `aria-keyshortcuts` и справочник сочетаний.
+     */
+    shortcut?: readonly string[];
+}
+/**
+ * Кнопка своего Инструмента — данные, рисует её кит (ADR-0058, раздел 5).
+ *
+ * Ровно одно из двух: `run` выполняется щелчком и сочетанием, `popover`
+ * открывается щелчком у кнопки, а сочетанием — у каретки.
+ */
+export type CustomToolButton = CustomToolButtonFields & ({
+    /** Действие кнопки: выполняется над редактором по щелчку и по сочетанию клавиш. */
+    run: (editor: Editor) => void;
+    /** Не задаётся вместе с `run`: у кнопки одно действие. */
+    popover?: undefined;
+} | {
+    /** Поповер кнопки: открывается щелчком у кнопки, а сочетанием клавиш — у каретки. */
+    popover: CustomToolPopover;
+    /** Не задаётся вместе с `popover`: у кнопки одно действие. */
+    run?: undefined;
+});
+/** Элемент `tools`: имя Инструмента кита или описание своего. */
+export type ToolEntry = ToolName | CustomTool;
+/**
+ * Годится ли значение атрибута по его виду (`CustomAttribute`). Живёт в
+ * `schema.ts` рядом с политикой адресов: проверку читает и очистка на сервере.
+ */
+export { isAllowedAttributeValue } from "./schema.js";
+/**
+ * `rangeAt` для Метки: непрерывный отрезок текста с этой Меткой (с теми же
+ * значениями атрибутов) вокруг `pos`. Края входят — каретка сразу за словом
+ * или перед ним ещё «в» диапазоне, иначе щелчок по первой букве не открывал
+ * бы Карточку. Если каретка стоит между двумя отрезками, берётся тот, что
+ * кончается здесь: так пишут дальше. Метки нет — `null`.
+ */
+export declare function markRange(markName: string): TextCardRangeAt;
+//# sourceMappingURL=customTool.d.ts.map

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

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

package/dist/editor/core/customTool.js

@@ -0,0 +1,31 @@
+export function isTriggerChar(char) {
+    return typeof char === "string" && char !== "/" && /^[^\s\p{C}]$/u.test(char);
+}
+export { isAllowedAttributeValue } from "./schema.js";
+export function markRange(markName) {
+    return (state, pos) => {
+        const type = state.schema.marks[markName];
+        if (!type || pos < 0 || pos > state.doc.content.size)
+            return null;
+        const $pos = state.doc.resolve(pos);
+        const parent = $pos.parent;
+        const start = $pos.start();
+        const runs = [];
+        let last;
+        parent.forEach((child, offset) => {
+            const mark = type.isInSet(child.marks) || undefined;
+            const from = start + offset;
+            const to = from + child.nodeSize;
+            if (mark && last && last.to === from && mark.eq(last.mark)) {
+                runs[runs.length - 1].to = to;
+            }
+            else if (mark) {
+                runs.push({ from, to });
+            }
+            last = mark ? { mark, to } : undefined;
+        });
+        const inside = runs.find((run) => run.from < pos && pos < run.to);
+        return (inside ?? runs.find((run) => run.to === pos) ?? runs.find((run) => run.from === pos) ?? null);
+    };
+}
+//# sourceMappingURL=customTool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customTool.js","sourceRoot":"","sources":["../../../src/editor/core/customTool.ts"],"names":[],"mappings":"AAgOA,MAAM,UAAU,aAAa,CAAC,IAAa;IACzC,OAAO,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,GAAG,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChF,CAAC;AAmND,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAStD,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACpB,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QAClE,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAmC,EAAE,CAAC;QAChD,IAAI,IAA4C,CAAC;QACjD,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;YACpD,MAAM,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;YAC5B,MAAM,EAAE,GAAG,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC;YACjC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,EAAE,KAAK,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC3D,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC,EAAE,GAAG,EAAE,CAAC;YACjC,CAAC;iBAAM,IAAI,IAAI,EAAE,CAAC;gBAChB,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;YAC1B,CAAC;YACD,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACzC,CAAC,CAAC,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,CACL,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI,IAAI,CAC7F,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,31 @@
+import { type Extensions } from "@tiptap/core";
+import { type CustomTool } from "./customTool.js";
+import { type ToolDescriptor, type ToolList } from "./toolDescriptor.js";
+/** Внутреннее описание своего Инструмента — то, что кладёт в список `expandTools`. */
+export declare function describeCustomTool(tool: CustomTool): ToolDescriptor;
+/**
+ * Набор движка, который `RichTextEditor` собирает при ошибке набора: движок
+ * нужен хуку `useEditor` в любом случае, но наружу он не выходит.
+ */
+export declare const FALLBACK_EXTENSIONS: Extensions;
+/** Ошибка набора своих Инструментов: текст для консоли и исключение движка, если было. */
+export interface CustomToolsError {
+    message: string;
+    cause?: unknown;
+}
+/**
+ * Ошибка сборки набора своих Инструментов или `null` (ADR-0058, п. 1.5, 2.4).
+ *
+ * Имя без Префикса потребителя, совпадение имён, Node или Mark Части для
+ * движка без правил Схемы (и правило без них), атрибут, которого нет в
+ * правилах, HTML мимо соглашения, Схема, которую движок не собрал, — всё это
+ * потеря данных на сервере или в самом Редакторе, и автор должен увидеть её
+ * до первого сохранения. `extensions` — полный набор движка, свои уже в нём.
+ * Неизвестная строка в `tools` сюда не доходит: её отбрасывает `expandTools`.
+ *
+ * Текст — для консоли разработчика, по-английски (ADR-0034), коротко: каждая
+ * строка здесь — вес кода кита; автору поле показывает строку каталога.
+ * Исключение движка — отдельно, в `cause`: текст — ключ «один раз» у `devError`.
+ */
+export declare function customToolsError(tools: ToolList, extensions: Extensions): CustomToolsError | null;
+//# sourceMappingURL=customToolEngine.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"customToolEngine.d.ts","sourceRoot":"","sources":["../../../src/editor/core/customToolEngine.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,UAAU,EAEhB,MAAM,cAAc,CAAC;AAGtB,OAAO,EAML,KAAK,UAAU,EAEhB,MAAM,iBAAiB,CAAC;AAKzB,OAAO,EAKL,KAAK,cAAc,EAEnB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAuL7B,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,GAAG,cAAc,CAkBnE;AAED;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAyB,CAAC;AA+D5D,0FAA0F;AAC1F,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,GAAG,gBAAgB,GAAG,IAAI,CAmHjG"}