@olddevs/ui 4.4.0 → 4.5.0

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

@@ -0,0 +1,78 @@
+import type { RichTextTools, SearchToolOptions } from "./toolOptions.js";
+/**
+ * Команды Инструмента `search`. Каждая возвращает `boolean`: выполнена или нет
+ * (HTML-режим, нет совпадений, поле нельзя править). Команды ведут себя как
+ * панель «Поиск и замена»: тот же запрос, те же флажки, та же подсветка.
+ * Запрос и флажки живут в движке, поэтому `setQuery`, `next` и `replace` работают
+ * и без открытой панели — на них можно собрать свой интерфейс поиска.
+ */
+export interface SearchToolCommands {
+    /**
+     * Открыть панель — то же, что кнопка «Поиск» и `Mod+F`. `query` сразу ставит
+     * запрос в поле и в подсветку документа; без него запросом становится текст,
+     * выделенный в одном Блоке. `replace` ставит фокус в поле замены. Флажки на
+     * открытой панели не меняются, на закрытой панель стартует с Опций Инструмента.
+     * `false` — в HTML-режиме (Документа на экране нет).
+     */
+    open(options?: {
+        replace?: boolean;
+        query?: string;
+    }): boolean;
+    /**
+     * Закрыть панель и убрать подсветку. Фокус и каретка остаются где были:
+     * в отличие от Escape в панели, команда в Документ их не переводит. Панель,
+     * уже закрытая, — не ошибка: подсветка всё равно убирается.
+     */
+    close(): boolean;
+    /**
+     * Задать запрос. Не названные в `flags` флажки (и флажки со значением
+     * `undefined`) берутся из открытой панели, а если её нет — из Опций
+     * Инструмента. Открытая панель показывает новый запрос
+     * и флажки. Непустой запрос прокручивает к первому совпадению после каретки,
+     * как `next` (прокрутка приходит чуть позже). `true` — запрос применён, даже
+     * если совпадений нет (их число — Состояние Инструмента); `false` — в
+     * HTML-режиме.
+     */
+    setQuery(query: string, flags?: Partial<SearchToolOptions>): boolean;
+    /**
+     * Следующее совпадение по кругу, выделяет его и прокручивает к нему ближайшую
+     * прокручиваемую область поля или окно — как панель, даже когда фокус вне
+     * Документа; фокус при этом не забирается. Прокрутка приходит чуть позже
+     * вызова (микрозадачей и кадром): её код грузится при первом вызове. `false` —
+     * совпадений нет.
+     */
+    next(): boolean;
+    /** Предыдущее совпадение по кругу; выделяет и прокручивает, как `next`. `false` — совпадений нет. */
+    previous(): boolean;
+    /**
+     * Заменить текущее совпадение: одна правка, одна отмена. Текущим становится
+     * следующее. `false` — совпадений нет или поле нельзя править.
+     */
+    replace(text: string): boolean;
+    /** Заменить все совпадения: одна правка, одна отмена. Условия — как у `replace`. */
+    replaceAll(text: string): boolean;
+}
+/** Команды Инструмента `toc`. */
+export interface TocToolCommands {
+    /**
+     * Перейти к заголовку списка Оглавления — как клик по пункту. Индекс считается
+     * в том же списке, что и пункты: с учётом `levels`, с нуля, пустые заголовки
+     * пропускаются. В правке каретка встаёт в конец заголовка, в `readOnly` фокус
+     * получает сам заголовок; прокрутка ставит его под липкую шапку (`offsetVar`) и
+     * Панель, подсветка заголовка гаснет.
+     *
+     * `false` — нет заголовка с таким индексом, либо Оглавление ещё не готово: его
+     * UI грузится отдельным куском после создания движка, и в HTML-режиме его нет.
+     * Заголовков меньше двух — не причина отказа: полоса не рисуется, но список
+     * есть, и переход работает.
+     */
+    jumpTo(index: number): boolean;
+}
+/**
+ * Команды Инструмента по имени из карты `RichTextTools`. Имя вне карты — `unknown`:
+ * типизация добровольна, Инструмент работает и без неё.
+ */
+export type ToolCommandsOf<Name extends string> = Name extends keyof RichTextTools ? RichTextTools[Name] extends {
+    commands: infer Commands;
+} ? Commands : unknown : unknown;
+//# sourceMappingURL=toolCommands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolCommands.d.ts","sourceRoot":"","sources":["../../../src/editor/core/toolCommands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQzE;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;OAMG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IAC/D;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC;IACjB;;;;;;;;OAQG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC;IACrE;;;;;;OAMG;IACH,IAAI,IAAI,OAAO,CAAC;IAChB,qGAAqG;IACrG,QAAQ,IAAI,OAAO,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,oFAAoF;IACpF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CACnC;AAED,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,MAAM,aAAa,GAC9E,aAAa,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;CAAE,GACtD,QAAQ,GACR,OAAO,GACT,OAAO,CAAC"}

package/dist/editor/core/toolCommands.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=toolCommands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolCommands.js","sourceRoot":"","sources":["../../../src/editor/core/toolCommands.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,139 @@
+import type { Editor } from "@tiptap/core";
+import type { CustomTool, PrefixedName, ToolEntry } from "./customTool.js";
+/**
+ * Тело описания своего Инструмента: форма `CustomTool` без имени. Имя задаёт
+ * определение, поэтому оно не может разойтись с тем, под каким определение лежит
+ * в `tools`.
+ */
+export type CustomToolBody = Omit<CustomTool, "name">;
+/**
+ * Что получают `state` и `commands` определения: живой движок и Опции этого
+ * Редактора — умолчания `defaults`, слитые с `tool(definition, options)`.
+ */
+export interface ToolDefinitionContext<Options extends object = object> {
+    /** Живой движок: функцию зовут, только когда он создан и не уничтожен. */
+    editor: Editor;
+    /** Опции этого Редактора. Читать, а не менять: объект общий для `create`, `state` и `commands`. */
+    options: Options;
+}
+/**
+ * Что автор передаёт `defineTool()`: поля определения без служебной метки.
+ */
+export interface ToolDefinitionInput<Name extends PrefixedName = PrefixedName, Options extends object = object, State = unknown, Commands extends object = object> {
+    /** Имя с Префиксом потребителя, уникальное в `tools`. */
+    name: Name;
+    /** Умолчания Опций: полный набор полей. Из них выводится тип Опций. */
+    defaults: Options;
+    /** Тело описания Инструмента от Опций этого Редактора. */
+    create(options: Options): CustomToolBody;
+    /**
+     * Состояние Инструмента, если оно есть. Экран перерисовывается, только когда
+     * снимок сменился, и экономия работает для простых данных: примитивов, массивов
+     * и простых объектов, их кит сравнивает по значению. `Date`, `Map`, `Set` и
+     * экземпляры классов сравниваются по ссылке: новый экземпляр — новый снимок. Если
+     * функция создаёт такое значение заново на каждый вызов, экран перерисуется на
+     * каждой транзакции (а в худшем случае React уйдёт в цикл): отдавайте простые
+     * данные (`date.toISOString()`, массив из `Map`) или одну и ту же ссылку, пока
+     * данные не изменились.
+     */
+    state?(context: ToolDefinitionContext<Options>): State;
+    /** Команды Инструмента, если они есть. */
+    commands?(context: ToolDefinitionContext<Options>): Commands;
+}
+/**
+ * Определение своего Инструмента: то, что возвращает `defineTool()`. Элемент
+ * `tools` — его можно положить туда как есть (с `defaults`) или настроить через
+ * `tool(definition, options)`. Поля читает кит, экрану они не нужны.
+ */
+export interface ToolDefinition<Name extends PrefixedName = PrefixedName, Options extends object = object, State = unknown, Commands extends object = object> extends ToolDefinitionInput<Name, Options, State, Commands> {
+    /** Метка определения: по ней `tools` отличает его от обычного `CustomTool`. */
+    readonly defined: true;
+}
+/**
+ * Определить свой Инструмент с Опциями, Состоянием и Командами. Экран настраивает
+ * его тем же `tool()`, что и встроенный, а читает тем же `useRichTextToolState`
+ * и `handle.tool()`:
+ *
+ * ```ts
+ * export const mention = defineTool({
+ *   name: "acme_mention",
+ *   defaults: { labels: { insert: "Mention" }, limit: 5 },
+ *   create: (options) => ({
+ *     engine: () => import("./mentionEngine.js").then((module) => module.engine),
+ *     blocks: { acme_mention: { kind: "inline" } },
+ *     insertItems: [{ section: "insert", label: options.labels.insert, icon: AtIcon, run }],
+ *   }),
+ *   state: ({ editor }) => ({ mentions: countMentions(editor) }),
+ *   commands: ({ editor, options }) => ({ insert: (name: string) => … }),
+ * });
+ *
+ * <RichTextEditor tools={[mention]} />                                         // умолчания
+ * <RichTextEditor tools={[tool(mention, { labels: { insert: "Отметить" } })]} /> // настройка
+ * ```
+ *
+ * - `defaults` — полный набор Опций; тип Опций выводится из него, второй раз его
+ *   объявлять не нужно.
+ * - `create(options)` отдаёт тело описания — ту же форму, что `CustomTool`, без
+ *   имени: Часть для движка, правила Схемы, UI-записи. Зовётся один раз на запись
+ *   `tools` (определение само или объект, что вернул `tool(definition, options)`):
+ *   кит запоминает результат, и Остров, замкнутый над Опциями, один и тот же на
+ *   каждом рендере. Запись, созданная заново на каждом рендере экрана
+ *   (`tools={[tool(mention, …)]}` в теле компонента), для кита новая — выносите
+ *   `tools` из рендера. Загрузчик Части для движка стоит держать константой
+ *   модуля: кэш загрузчика живёт на самой функции, а новая функция на каждый
+ *   вызов `create` загружала бы Часть заново для каждой записи.
+ * - `state({ editor, options })` — Состояние для `useRichTextToolState(ref, name)`.
+ *   Зовётся при каждой транзакции и при каждом чтении хука, поэтому должна быть
+ *   быстрой и без побочных эффектов; вернуть — данные без DOM-узлов. Простые данные
+ *   (примитивы, массивы, простые объекты) сравниваются по значению, всё прочее
+ *   (`Date`, `Map`, `Set`, экземпляры классов) — по ссылке. Нет — у Инструмента нет
+ *   Состояния, и хук отдаёт `null`.
+ * - `commands({ editor, options })` — Команды для `handle.tool(name)`. Зовётся при
+ *   каждом обращении к Хэндлу: только обёртки над движком, без подписок. Команда
+ *   возвращает `boolean`, как у встроенных. Нет — `handle.tool(name)` отдаёт `null`.
+ *
+ * Слияние Опций: вложенные простые объекты сливаются с умолчаниями, массивы и
+ * функции заменяются целиком, как `configure` у Tiptap. Опции читаются один раз,
+ * при создании движка; чтобы сменить их, пересоздайте Редактор через `key`.
+ * Проверять значения Опций должен автор: кит этого не делает.
+ *
+ * Все правила своего Инструмента действуют (ADR-0058): имя с Префиксом
+ * потребителя, имя уникально в `tools` — и две записи одного определения, с
+ * `tool()` и без, тоже ошибка набора. Типизация `useRichTextToolState` и
+ * `handle.tool()` — через карту `RichTextTools`: автор дописывает Инструмент в неё
+ * через `declare module "@olddevs/ui/editor"`; без этого они отдают `unknown`.
+ *
+ * Серверно-безопасна: модуль без Tiptap и React. Определение содержит функции, как
+ * и `CustomTool`, поэтому набор с ним собирается в серверном модуле и отдаётся
+ * клиентскому компоненту только вместе с модулем, а не как проп через границу RSC.
+ */
+export declare function defineTool<Name extends PrefixedName, Options extends object, State = unknown, Commands extends object = object>(definition: ToolDefinitionInput<Name, Options, State, Commands>): ToolDefinition<Name, Options, State, Commands>;
+/** Определение, собранное под одни Опции: слитые Опции и `CustomTool` с телом из `create`. */
+interface ResolvedDefinition {
+    options: object;
+    tool: CustomTool;
+}
+/**
+ * Определение в обычное описание: Опции этого Редактора (умолчания, слитые с
+ * `given` — опциями `tool()`) и `CustomTool` с телом из `create`. Дальше
+ * Инструмент идёт тем же путём, что и описанный объектом.
+ *
+ * РЕЗУЛЬТАТ ЗАПОМИНАЕТСЯ по паре «определение + объект Опций записи `tool()`»
+ * (записи без `tool()` — по одному определению). `create` — функция автора, и
+ * Остров, замкнутый над Опциями, она создаёт заново на каждый вызов; а
+ * `richTextSchema`, `islandsFor`, `sanitizeRichText` и сборка набора читают
+ * определение каждый на своём рендере. Без запоминания клиентский родитель, что
+ * перерисовывает `RichTextView` с теми же `tools`, получал бы новый тип
+ * компонента на каждый рендер, а React размонтировал бы Остров. Одна запись
+ * `tools` — один `CustomTool`, пока жива запись.
+ */
+export declare function resolveDefinition(definition: ToolDefinition, given?: object): ResolvedDefinition;
+/**
+ * Описание своего Инструмента из элемента `tools`: обычный объект как есть,
+ * определение — собранное по умолчаниям или Опциям `tool()`. Имя кита и
+ * Настроенный встроенный Инструмент — `undefined`: Схемы и Острова у них нет.
+ * Для сервера: `richTextSchema` и `islandsFor` читают правила только отсюда.
+ */
+export declare function customToolOf(entry: ToolEntry): CustomTool | undefined;
+export {};
+//# sourceMappingURL=toolDefinition.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolDefinition.d.ts","sourceRoot":"","sources":["../../../src/editor/core/toolDefinition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAoB3E;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;AAEtD;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAC,OAAO,SAAS,MAAM,GAAG,MAAM;IACpE,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAClC,IAAI,SAAS,YAAY,GAAG,YAAY,EACxC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,GAAG,OAAO,EACf,QAAQ,SAAS,MAAM,GAAG,MAAM;IAEhC,yDAAyD;IACzD,IAAI,EAAE,IAAI,CAAC;IACX,uEAAuE;IACvE,QAAQ,EAAE,OAAO,CAAC;IAClB,0DAA0D;IAC1D,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,cAAc,CAAC;IACzC;;;;;;;;;OASG;IACH,KAAK,CAAC,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;IACvD,0CAA0C;IAC1C,QAAQ,CAAC,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;CAC9D;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc,CAC7B,IAAI,SAAS,YAAY,GAAG,YAAY,EACxC,OAAO,SAAS,MAAM,GAAG,MAAM,EAC/B,KAAK,GAAG,OAAO,EACf,QAAQ,SAAS,MAAM,GAAG,MAAM,CAChC,SAAQ,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC;IAC3D,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AACH,wBAAgB,UAAU,CACxB,IAAI,SAAS,YAAY,EACzB,OAAO,SAAS,MAAM,EACtB,KAAK,GAAG,OAAO,EACf,QAAQ,SAAS,MAAM,GAAG,MAAM,EAEhC,UAAU,EAAE,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,GAC9D,cAAc,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAEhD;AAED,8FAA8F;AAC9F,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAWD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAWhG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,SAAS,CAMrE"}

package/dist/editor/core/toolDefinition.js

@@ -0,0 +1,28 @@
+import { isConfiguredTool, mergeOptions } from "./toolOptions.js";
+export function defineTool(definition) {
+    return { ...definition, defined: true };
+}
+const NO_OPTIONS = {};
+const resolved = new WeakMap();
+export function resolveDefinition(definition, given) {
+    const key = given ?? NO_OPTIONS;
+    let byOptions = resolved.get(definition);
+    if (!byOptions)
+        resolved.set(definition, (byOptions = new WeakMap()));
+    let result = byOptions.get(key);
+    if (!result) {
+        const options = mergeOptions(definition.defaults, given ?? {});
+        result = { options, tool: { ...definition.create(options), name: definition.name } };
+        byOptions.set(key, result);
+    }
+    return result;
+}
+export function customToolOf(entry) {
+    if (typeof entry !== "object" || entry === null)
+        return undefined;
+    if (isConfiguredTool(entry)) {
+        return entry.definition && resolveDefinition(entry.definition, entry.options).tool;
+    }
+    return "defined" in entry ? resolveDefinition(entry).tool : entry;
+}
+//# sourceMappingURL=toolDefinition.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"toolDefinition.js","sourceRoot":"","sources":["../../../src/editor/core/toolDefinition.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA4IlE,MAAM,UAAU,UAAU,CAMxB,UAA+D;IAE/D,OAAO,EAAE,GAAG,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AASD,MAAM,UAAU,GAAW,EAAE,CAAC;AAM9B,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAuD,CAAC;AAgBpF,MAAM,UAAU,iBAAiB,CAAC,UAA0B,EAAE,KAAc;IAC1E,MAAM,GAAG,GAAG,KAAK,IAAI,UAAU,CAAC;IAChC,IAAI,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,SAAS;QAAE,QAAQ,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,SAAS,GAAG,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC;IACtE,IAAI,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QAC/D,MAAM,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACrF,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAQD,MAAM,UAAU,YAAY,CAAC,KAAgB;IAC3C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAClE,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC,UAAU,IAAI,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC;IACrF,CAAC;IACD,OAAO,SAAS,IAAI,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AACpE,CAAC"}

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

@@ -7,6 +7,7 @@ import type { TextCardRangeAt, CustomTextCardRender, CustomTool, CustomTrigger,
 import type { EditorExtensionOptions } from "./extensions.js";
 import type { InsertItem } from "./insertItems.js";
 import type { ShortcutCommand, ShortcutGroup } from "./shortcuts.js";
+import type { ConfigurableToolName, RichTextTools } from "./toolOptions.js";
 import type { ToolLoader } from "./toolLoader.js";
 import type { Tool } from "./tools.js";
 /**
@@ -47,8 +48,9 @@ export interface ToolDescriptor {
      * Часть для движка: расширения Tiptap Инструмента — Node, Mark, Extension,
      * плагины ProseMirror. Функция от контекста — привилегия кита: встроенным
      * нужны мосты `RichTextEditor` (поповер ссылки, Меню вставки, `Alt+F10`).
+     * Второй аргумент — Опции этого Редактора (`options`), если они есть.
      */
-    engine?: (context: ToolEngineContext) => Extensions;
+    engine?: (context: ToolEngineContext, options?: object) => Extensions;
     /**
      * Загрузчик Части для движка (`toolLoader.ts`): движок создаётся после
      * загрузчиков всех описаний списка, и `engine` читает отданное `loaded`.
@@ -63,6 +65,24 @@ export interface ToolDescriptor {
     skeleton?: () => Extensions;
     /** Признаки Блока по имени узла; кит переносит их в spec узла. Нет — обычный Блок. */
     blocks?: Readonly<Record<string, BlockTraits>>;
+    /**
+     * Умолчания Опций встроенного Инструмента: полный набор полей, из которого
+     * `tool()` меняет нужные. Нет — у Инструмента нет Опций. Поле — надформа:
+     * публичные Опции своего Инструмента задаёт `defineTool` (`defaults`).
+     */
+    defaults?: object;
+    /**
+     * Проверки значений Опций по имени поля — по одной на каждое поле `defaults`.
+     * Значение, не прошедшее проверку, заменяется умолчанием (`expandTools`):
+     * потребитель на JS обходит типы карты `RichTextTools`.
+     */
+    checks?: Readonly<Record<string, (value: unknown) => boolean>>;
+    /**
+     * Опции этого Редактора: умолчания, слитые с `tool()`. Ставит `expandTools`
+     * при сборке набора, поэтому описание в реестре — общее на все Редакторы, а
+     * это поле — своё в списке каждого. Читаются один раз, вместе с набором.
+     */
+    options?: object;
     /**
      * Кнопки Панели (фиксированной и плавающей — набор один), флагом — и Меню
      * выделения. Место встроенной кнопки на Панели — привилегия кита: её
@@ -100,6 +120,44 @@ export interface ToolDescriptor {
      * (`shortcuts.ts`): у записи сочетание — её поле, а у Метки из движка — нет.
      */
     shortcuts?: readonly ShortcutCommand[];
+    /**
+     * Команды Инструмента: то, что `handle.tool(name)` отдаёт экрану. Зовётся при
+     * каждом обращении к Хэндлу и обязана быть дешёвой: только обёртки над движком
+     * и мостом, без подписок и состояния. Нет — у Инструмента нет Команд, и
+     * `handle.tool(name)` отдаёт `null`.
+     */
+    commands?: (context: ToolCommandsContext) => object;
+    /**
+     * Состояние Инструмента: снимок для `useRichTextToolState(ref, name)`. Хук
+     * зовёт её на каждую транзакцию и каждое чтение, поэтому она быстрая и без
+     * побочных эффектов. Есть только у своего Инструмента (`defineTool`): снимки
+     * встроенных хук держит у себя (`SNAPSHOTS`), чтобы Поиск и Оглавление не
+     * тянули их код в стартовый кусок Редактора. Нет — Состояния у Инструмента нет.
+     */
+    state?: (editor: Editor) => unknown;
+}
+/** Что функция Команд получает от `RichTextEditor`. */
+export interface ToolCommandsContext {
+    /** Живой движок: функцию зовут, только когда он создан и не уничтожен. */
+    editor: Editor;
+    /** Мост к тому, что держит сам `RichTextEditor`: панели и ленивый UI. */
+    bridge: ToolBridge;
+}
+/**
+ * Что Команды встроенных берут у `RichTextEditor`: панель Поиска и ядро
+ * Оглавления живут в его React-дереве, а не в движке. Все методы возвращают
+ * `false`, когда сделать нельзя (HTML-режим, UI ещё не загружен). Привилегия
+ * кита: свой Инструмент моста не получает.
+ */
+export interface ToolBridge {
+    /** Открыть панель Поиска; `query` — сразу в поле, без него — выделенный текст. */
+    openSearch: (replace: boolean, query?: string) => boolean;
+    /** Закрыть панель Поиска и убрать подсветку, не трогая фокус. */
+    closeSearch: () => boolean;
+    /** Открыт ли HTML-режим: Документа на экране нет, искать и заменять в нём нельзя. */
+    sourceOpen: () => boolean;
+    /** Перейти к заголовку Оглавления с индексом списка. */
+    jumpToc: (index: number) => boolean;
 }
 /** Символ-триггер Инструмента в списке описаний: публичная запись и имя владельца для сообщений. */
 export type TriggerRecord = CustomTrigger & {
@@ -254,6 +312,12 @@ export interface TextCardRecord {
  * Инструменты есть только в списке описаний.
  */
 export interface ToolList extends ReadonlySet<Tool> {
+    /**
+     * Ошибка сборки набора, найденная до движка: две записи `tool()` с одним
+     * именем. Редактор показывает её тем же путём, что ошибки своих Инструментов
+     * (`customToolsError`): строкой поля и `console.error` в разработке.
+     */
+    readonly error?: string;
     /**
      * Описания включённых Инструментов: встроенные в порядке кита (у не
      * переехавших — заглушки `legacy`), за ними свои в порядке `tools`.
@@ -264,7 +328,12 @@ export interface ToolList extends ReadonlySet<Tool> {
  * Набор из имён кита и списка описаний — единственный способ его собрать:
  * развернуть `tools` (`expandTools`) или сузить готовый (Скелет).
  */
-export declare function toolList(names: Iterable<Tool>, descriptors: readonly ToolDescriptor[]): ToolList;
+export declare function toolList(names: Iterable<Tool>, descriptors: readonly ToolDescriptor[], error?: string): ToolList;
+/**
+ * Опции встроенного Инструмента этого Редактора: умолчания кита, слитые с
+ * `tool()`. Инструмента нет в наборе или у него нет Опций — `undefined`.
+ */
+export declare function toolOptions<Name extends ConfigurableToolName>(tools: ToolList, name: Name): RichTextTools[Name]["options"] | undefined;
 /** Описания переехавших Инструментов набора — в порядке списка. */
 export declare function describedTools(tools: ToolList): readonly ToolDescriptor[];
 /**

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

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

@@ -1,8 +1,12 @@
 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 toolList(names, descriptors, error) {
+    return Object.assign(new Set(names), { descriptors, ...(error !== undefined && { error }) });
+}
+export function toolOptions(tools, name) {
+    const descriptor = tools.descriptors.find((candidate) => candidate.name === name);
+    return descriptor?.options;
 }
 export function describedTools(tools) {
     return tools.descriptors.filter((descriptor) => !descriptor.legacy);

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

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

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

@@ -0,0 +1,157 @@
+import type { PrefixedName } from "./customTool.js";
+import type { ToolDefinition } from "./toolDefinition.js";
+import type { SearchToolState, TocToolState } from "./toolState.js";
+import type { SearchToolCommands, TocToolCommands } from "./toolCommands.js";
+import type { Tool as ToolName } from "./tools.js";
+/**
+ * Уровень заголовка в опциях Оглавления: 1 — `h1` … 4 — `h4`. Выше четвёртого
+ * Схема кита заголовков не знает.
+ */
+export type TocLevel = 1 | 2 | 3 | 4;
+/**
+ * Опции Инструмента `search` (все значения — со стартовыми умолчаниями кита).
+ * Это стартовые флажки поиска вообще, а не только панели: запрос, который
+ * задаёт Команда `setQuery`, берёт не названные в ней флажки отсюда, пока
+ * поиск не закрыт (`close()`, Escape в панели).
+ */
+export interface SearchToolOptions {
+    /**
+     * Панель открывается с включённым флажком «Регистр». Флажок остаётся
+     * переключаемым; кит не запоминает его между открытиями. По умолчанию `false`.
+     */
+    matchCase: boolean;
+    /** Панель открывается с включённым флажком «Слово целиком». По умолчанию `false`. */
+    wholeWord: boolean;
+    /** Панель открывается с включённым переключателем «Регулярное выражение». По умолчанию `false`. */
+    regex: boolean;
+}
+/** Опции Инструмента `toc` (ADR-0068). */
+export interface TocToolOptions {
+    /**
+     * Имя CSS-переменной с высотой липкой шапки экрана (ADR-0016): переход к
+     * заголовку ставит его под шапку, а подсветка считает раздел текущим от её
+     * нижнего края. Значение — имя переменной целиком, с двумя дефисами:
+     * `--header-h`. Липкую Панель Редактора это не двигает: она по-прежнему
+     * стоит под `--topbar-h`. По умолчанию `--topbar-h`.
+     */
+    offsetVar: string;
+    /**
+     * Уровни заголовков, которые попадают в Оглавление: подмножество 1–4. Заголовка
+     * другого уровня нет ни в полосе, ни в списке, и отступ пунктов считается
+     * от самого крупного из оставшихся. По умолчанию все четыре.
+     */
+    levels: readonly TocLevel[];
+    /**
+     * Ширина списка — длина CSS или пиксели. Постоянная, а не по самому длинному
+     * заголовку. По умолчанию 240.
+     */
+    listWidth: number | string;
+}
+/**
+ * Типы Инструментов Редактора по имени: что экран задаёт при настройке (`options`),
+ * что читает (`state`) и что вызывает (`commands`). Расширяемый интерфейс, как
+ * `Storage` и `Commands` у Tiptap: кит объявляет в нём `search` и `toc`, а
+ * потребитель дописывает свои Инструменты через declaration merging:
+ *
+ * ```ts
+ * declare module "@olddevs/ui/editor" {
+ *   interface RichTextTools {
+ *     acme_note: {
+ *       options: { tone: "info" | "warning" };
+ *       state: { count: number };
+ *       commands: { clear(): boolean };
+ *     };
+ *   }
+ * }
+ * ```
+ *
+ * Из карты выводятся типы `useRichTextToolState`, `handle.tool()` и Опции `tool()`
+ * встроенного; Опции своего Инструмента `tool()` берёт из `defaults` его определения.
+ * Инструмент, не дописанный в карту, работает: типизация добровольна.
+ */
+export interface RichTextTools {
+    search: {
+        options: SearchToolOptions;
+        state: SearchToolState;
+        commands: SearchToolCommands;
+    };
+    toc: {
+        options: TocToolOptions;
+        state: TocToolState;
+        commands: TocToolCommands;
+    };
+}
+/**
+ * Имена встроенных Инструментов, у которых есть опции: ключи карты, совпадающие
+ * с именами кита. Свой Инструмент, дописанный в карту, сюда не попадает —
+ * настраивается по определению, а не по имени.
+ */
+export type ConfigurableToolName = keyof RichTextTools & ToolName;
+/** Опции Инструмента из карты; нет карты или `options` — `never`. */
+type OptionsOf<Name extends ConfigurableToolName> = RichTextTools[Name] extends {
+    options: infer Options;
+} ? Options : never;
+/**
+ * Опции, которые экран передаёт `tool()`: каждое поле необязательно, остальное
+ * берётся из умолчаний. Вложенные объекты вкладываются так же, а массивы и
+ * функции — значение целиком (правило слияния, `mergeOptions`).
+ */
+export type ToolOptionsInput<Options> = {
+    [Key in keyof Options]?: Options[Key] extends readonly unknown[] | ((...args: never[]) => unknown) ? Options[Key] : Options[Key] extends object ? ToolOptionsInput<Options[Key]> : Options[Key];
+};
+/**
+ * Настроенный Инструмент: запись для `tools`, которую возвращает `tool()`.
+ * Непрозрачная — поля читает только кит. У встроенного это имя и опции, а не
+ * описание: описания встроенных наружу не выходят (ADR-0058, п. 10.3). У своего
+ * Инструмента добавляется определение, которое `tool()` настраивает.
+ */
+export interface ConfiguredTool<Name extends string = ToolName> {
+    /** Метка записи: по ней `tools` отличает Настроенный Инструмент от своего. */
+    readonly configured: true;
+    readonly name: Name;
+    readonly options: Readonly<Record<string, unknown>>;
+    /** Определение своего Инструмента (`defineTool`); у встроенного его нет. */
+    readonly definition?: ToolDefinition;
+}
+/**
+ * Слить Опции: вложенные простые объекты сливаются, массивы, функции и всё
+ * остальное заменяются целиком — как `configure` у Tiptap. Значение `undefined`
+ * не в счёт: остаётся то, что было. Новый объект, исходные не меняются (вложенный
+ * объект, которого нет в `given`, остаётся тем же).
+ */
+export declare function mergeOptions(base: object, given: object): object;
+/**
+ * Настроить Инструмент прямо в `tools`: встроенный — по имени, свой — по
+ * определению (`defineTool`).
+ *
+ * ```tsx
+ * <RichTextEditor
+ *   tools={[
+ *     ...RICH_TEXT_PRESETS.full,
+ *     tool("toc", { offsetVar: "--header-h", levels: [2, 3] }),
+ *     tool(mention, { labels: { insert: "Отметить коллегу" } }),
+ *   ]}
+ * />
+ * ```
+ *
+ * Запись включает Инструмент и без имени в `tools`; если в `tools` есть и голое
+ * имя (из пресета), побеждает Настроенный Инструмент. Две записи `tool()` с
+ * одним встроенным именем — ошибка набора, как и две записи одного своего
+ * Инструмента. Место на поверхности не меняется: у встроенного оно
+ * определяется порядком кита, у своего — порядком `tools`. Передавать нужно
+ * только те опции, которые меняются, остальные берутся из умолчаний; вложенные
+ * объекты сливаются, массивы и функции заменяются целиком.
+ *
+ * Опции читаются один раз, вместе с набором, при создании движка. Чтобы сменить
+ * их на лету, пересоздайте Редактор через `key`. Неверное значение встроенной
+ * опции (из JS без типов) заменяется умолчанием, в разработке — один
+ * `console.error`; опции своего Инструмента проверяет его автор.
+ *
+ * Встроенный — только Инструмент с опциями: `search` и `toc`. Серверно-безопасна.
+ */
+export declare function tool<Name extends ConfigurableToolName>(name: Name, options?: ToolOptionsInput<OptionsOf<Name>>): ConfiguredTool<Name>;
+export declare function tool<Name extends PrefixedName, Options extends object>(definition: ToolDefinition<Name, Options, unknown, object>, options?: ToolOptionsInput<Options>): ConfiguredTool<Name>;
+/** Запись `tools` — Настроенный Инструмент. `null` и строки — нет. */
+export declare function isConfiguredTool(entry: unknown): entry is ConfiguredTool<string>;
+export {};
+//# sourceMappingURL=toolOptions.d.ts.map

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

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