@olddevs/ui 0.0.0-stage → 4.0.0

package/dist/components/table/SavedViews.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SavedViews.js","sourceRoot":"","sources":["../../../src/components/table/SavedViews.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAGb,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAoF1C,MAAM,UAAU,UAAU,CAAc,EACtC,KAAK,EACL,QAAQ,EACR,QAAQ,EACR,YAAY,EAAE,SAAS,EACvB,SAAS,GACU;IACnB,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAI/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEpC,OAAO,CACL,cACE,IAAI,EAAC,OAAO,gBACA,SAAS,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,EAClD,SAAS,EAAE,EAAE,CAAC,qCAAqC,EAAE,SAAS,CAAC,YAE9D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CACnB,KAAC,IAAI,IAEH,QAAQ,EAAE,IAAI,CAAC,EAAE,KAAK,QAAQ,EAG9B,OAAO,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,YAE5B,IAAI,CAAC,IAAI,IANL,IAAI,CAAC,EAAE,CAOP,CACR,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/components/table/TablePreferences.d.ts

@@ -0,0 +1,45 @@
+import { type ComponentPropsWithoutRef } from "react";
+import type { Density } from "../../lib/variants.js";
+export interface TablePreferencesColumn {
+    /** Идентификатор колонки; совпадает с `id` колонки таблицы. */
+    id: string;
+    /** Подпись. Строка, а не `ReactNode`: она же доступное имя флажка. */
+    label: string;
+    /** Колонку нельзя скрыть — например ту, что называет строку. */
+    required?: boolean;
+}
+export interface TablePreferencesProps extends Omit<ComponentPropsWithoutRef<"div">, "onChange" | "children"> {
+    /** Колонки таблицы в порядке объявления. */
+    columns: TablePreferencesColumn[];
+    /** Скрытые колонки. Компонент ничего не хранит — значение приходит сверху. */
+    hiddenColumns: Set<string>;
+    /** Получает новое множество скрытых колонок после смены флажка. */
+    onHiddenColumnsChange: (hidden: Set<string>) => void;
+    /** Порядок колонок. Пустой — порядок объявления. Нет обработчика — нет кнопок. */
+    columnOrder?: string[];
+    /** Получает полный новый порядок после нажатия «выше» или «ниже». Не передан — кнопок порядка нет. */
+    onColumnOrderChange?: (order: string[]) => void;
+    /** Текущая плотность строк: `comfortable` или `compact`. */
+    density: Density;
+    /** Получает выбранную плотность. */
+    onDensityChange: (density: Density) => void;
+}
+/**
+ * Настройки таблицы: видимость и порядок колонок, плотность.
+ *
+ * ЭТО ПАНЕЛЬ, А НЕ МЕНЮ, и это решение, а не оплошность. Меню кита включает в
+ * себя `Popover` и ждёт триггер; а главное — пункт меню не контейнер для
+ * кнопок: вложенные в него кнопки «выше/ниже» ломают клавиатурную семантику
+ * меню, где стрелки принадлежат самому меню. Поэтому обычные флажки и
+ * `Segmented`, а оболочку — `Popover`, `Drawer` или `Dialog` — выбирает
+ * потребитель.
+ *
+ * Состояния не хранит: видимость, порядок и плотность приходят сверху, обычно
+ * из `useTableState`.
+ *
+ * ПОРЯДОК МЕНЯЕТСЯ КНОПКАМИ, а не перетаскиванием. Перетаскивание без
+ * клавиатурной альтернативы недоступно вовсе, а альтернатива к нему — эти же
+ * кнопки; заводить оба способа ради одного экрана несоразмерно.
+ */
+export declare const TablePreferences: import("react").ForwardRefExoticComponent<TablePreferencesProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TablePreferences.d.ts.map

package/dist/components/table/TablePreferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TablePreferences.d.ts","sourceRoot":"","sources":["../../../src/components/table/TablePreferences.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,wBAAwB,EAAE,MAAM,OAAO,CAAC;AAKlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAKrD,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;IACd,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,IAAI,CACjD,wBAAwB,CAAC,KAAK,CAAC,EAC/B,UAAU,GAAG,UAAU,CACxB;IACC,4CAA4C;IAC5C,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,8EAA8E;IAC9E,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,mEAAmE;IACnE,qBAAqB,EAAE,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IACrD,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,sGAAsG;IACtG,mBAAmB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAChD,4DAA4D;IAC5D,OAAO,EAAE,OAAO,CAAC;IACjB,oCAAoC;IACpC,eAAe,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,kHAkH5B,CAAC"}

package/dist/components/table/TablePreferences.js

@@ -0,0 +1,41 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { ChevronDownIcon, ChevronUpIcon } from "../../icons.js";
+import { useMessages } from "../../i18n/useMessages.js";
+import { cn } from "../../lib/cn.js";
+import { orderColumns } from "../../lib/table-state.js";
+import { Button } from "../actions/Button.js";
+import { Checkbox } from "../inputs/Checkbox.js";
+import { Segmented } from "../actions/Segmented.js";
+export const TablePreferences = forwardRef(function TablePreferences({ columns, hiddenColumns, onHiddenColumnsChange, columnOrder, onColumnOrderChange, density, onDensityChange, className, ...rest }, ref) {
+    const messages = useMessages();
+    const ordered = orderColumns(columns, columnOrder ?? []);
+    const visibleCount = columns.filter((c) => !hiddenColumns.has(c.id)).length;
+    const toggle = (id, visible) => {
+        const next = new Set(hiddenColumns);
+        if (visible)
+            next.delete(id);
+        else
+            next.add(id);
+        onHiddenColumnsChange(next);
+    };
+    const move = (id, by) => {
+        const ids = ordered.map((c) => c.id);
+        const at = ids.indexOf(id);
+        const to = at + by;
+        if (at === -1 || to < 0 || to >= ids.length)
+            return;
+        [ids[at], ids[to]] = [ids[to], ids[at]];
+        onColumnOrderChange?.(ids);
+    };
+    return (_jsxs("div", { ref: ref, className: cn("flex w-[280px] flex-col gap-4", className), ...rest, children: [_jsxs("fieldset", { className: "flex flex-col gap-1", children: [_jsx("legend", { className: "text-fg-2 mb-1 text-[11px] font-semibold tracking-wide uppercase", children: messages.tablePreferences.columns }), ordered.map((column, index) => {
+                        const visible = !hiddenColumns.has(column.id);
+                        const last = visible && visibleCount === 1;
+                        return (_jsxs("div", { className: "flex items-center gap-2", children: [_jsx(Checkbox, { checked: visible, disabled: column.required || last, onCheckedChange: (next) => toggle(column.id, next), children: column.label }), onColumnOrderChange ? (_jsxs("span", { className: "ml-auto flex shrink-0 gap-0.5", children: [_jsx(Button, { variant: "ghost", size: "sm", iconOnly: true, icon: _jsx(ChevronUpIcon, { size: 12 }), "aria-label": messages.tablePreferences.moveUp({ column: column.label }), "aria-disabled": index === 0 || undefined, onClick: () => index !== 0 && move(column.id, -1) }), _jsx(Button, { variant: "ghost", size: "sm", iconOnly: true, icon: _jsx(ChevronDownIcon, { size: 12 }), "aria-label": messages.tablePreferences.moveDown({ column: column.label }), "aria-disabled": index === ordered.length - 1 || undefined, onClick: () => index !== ordered.length - 1 && move(column.id, 1) })] })) : null] }, column.id));
+                    })] }), _jsxs("div", { className: "flex flex-col gap-1", children: [_jsx("span", { className: "text-fg-2 text-[11px] font-semibold tracking-wide uppercase", children: messages.tablePreferences.density }), _jsx(Segmented, { value: density, onChange: onDensityChange, options: [
+                            { value: "comfortable", label: messages.tablePreferences.comfortable },
+                            { value: "compact", label: messages.tablePreferences.compact },
+                        ] })] })] }));
+});
+//# sourceMappingURL=TablePreferences.js.map

package/dist/components/table/TablePreferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TablePreferences.js","sourceRoot":"","sources":["../../../src/components/table/TablePreferences.tsx"],"names":[],"mappings":"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"}

package/dist/components/table/TableToolbar.d.ts

@@ -0,0 +1,38 @@
+import { type ComponentPropsWithoutRef, type ReactNode } from "react";
+export interface TableToolbarProps extends Omit<ComponentPropsWithoutRef<"div">, "title"> {
+    /** Заголовок таблицы. Обычно `Heading` или строка. */
+    title?: ReactNode;
+    /**
+     * Сколько записей всего. Число, а не готовая строка: склонение делает каталог
+     * по локали, а не вызывающий по своему разумению.
+     */
+    count?: number;
+    /**
+     * Своя подпись счётчика — когда нужно назвать сущность («12 документов»).
+     * Тот же приём, что у `SelectionBar`: каталог знает про склонение, но не про
+     * предметную область.
+     */
+    countLabel?: (count: number) => ReactNode;
+    /** Действия справа: «Создать», «Экспорт», меню. */
+    actions?: ReactNode;
+    /** Слот фильтров — обычно `FilterBar`. Стоит второй строкой. */
+    filters?: ReactNode;
+    /** Слот настроек — обычно `TablePreferences` внутри `Popover` или `Menu`. */
+    preferences?: ReactNode;
+}
+/**
+ * Полоса над таблицей: заголовок, счётчик, действия, фильтры и настройки.
+ *
+ * Состояния не хранит вовсе — ни счётчика, ни фильтров: всё приходит сверху,
+ * обычно из `useTableState`.
+ *
+ * РОЛИ `toolbar` ЗДЕСЬ НЕТ, и это решение. Роль обязывает к клавиатурной
+ * навигации стрелками между своими элементами, а ARIA сама её не даёт: объявив
+ * роль и не реализовав поведение, мы пообещали бы скринридеру то, чего нет.
+ * Обычный контейнер с заголовком внутри честнее и никого не обманывает.
+ *
+ * Работает и без `DataTable` — над обычной `Table` тоже: полоса ничего не знает
+ * о том, что под ней.
+ */
+export declare const TableToolbar: import("react").ForwardRefExoticComponent<TableToolbarProps & import("react").RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TableToolbar.d.ts.map

package/dist/components/table/TableToolbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableToolbar.d.ts","sourceRoot":"","sources":["../../../src/components/table/TableToolbar.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,wBAAwB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAIlF,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,wBAAwB,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACvF,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC1C,mDAAmD;IACnD,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,gEAAgE;IAChE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,YAAY,8GA+BvB,CAAC"}

package/dist/components/table/TableToolbar.js

@@ -0,0 +1,11 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+import { useMessages } from "../../i18n/useMessages.js";
+import { cn } from "../../lib/cn.js";
+export const TableToolbar = forwardRef(function TableToolbar({ title, count, countLabel, actions, filters, preferences, className, ...rest }, ref) {
+    const messages = useMessages();
+    const hasHeader = title != null || count != null || actions != null || preferences != null;
+    return (_jsxs("div", { ref: ref, className: cn("flex flex-col gap-3", className), ...rest, children: [hasHeader ? (_jsxs("div", { className: "flex flex-wrap items-center gap-3", children: [title != null ? _jsx("div", { className: "text-fg-0 text-base font-semibold", children: title }) : null, count != null ? (_jsx("span", { className: "text-fg-2 text-[13px]", children: countLabel ? countLabel(count) : messages.tableToolbar.total({ count }) })) : null, actions != null || preferences != null ? (_jsxs("div", { className: "ml-auto flex shrink-0 items-center gap-2", children: [actions, preferences] })) : null] })) : null, filters] }));
+});
+//# sourceMappingURL=TableToolbar.js.map

package/dist/components/table/TableToolbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TableToolbar.js","sourceRoot":"","sources":["../../../src/components/table/TableToolbar.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,UAAU,EAAiD,MAAM,OAAO,CAAC;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAsCrC,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAoC,SAAS,YAAY,CAC7F,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAC/E,GAAG;IAEH,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC;IAE3F,OAAO,CACL,eAAK,GAAG,EAAE,GAAG,EAAE,SAAS,EAAE,EAAE,CAAC,qBAAqB,EAAE,SAAS,CAAC,KAAM,IAAI,aACrE,SAAS,CAAC,CAAC,CAAC,CACX,eAAK,SAAS,EAAC,mCAAmC,aAC/C,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,cAAK,SAAS,EAAC,mCAAmC,YAAE,KAAK,GAAO,CAAC,CAAC,CAAC,IAAI,EAEvF,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,CACf,eAAM,SAAS,EAAC,uBAAuB,YACpC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,GACnE,CACR,CAAC,CAAC,CAAC,IAAI,EAEP,OAAO,IAAI,IAAI,IAAI,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,CACxC,eAAK,SAAS,EAAC,0CAA0C,aACtD,OAAO,EACP,WAAW,IACR,CACP,CAAC,CAAC,CAAC,IAAI,IACJ,CACP,CAAC,CAAC,CAAC,IAAI,EAEP,OAAO,IACJ,CACP,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/editor/RichTextEditor.d.ts

@@ -0,0 +1,274 @@
+import { type Editor } from "@tiptap/react";
+import { type ReactNode } from "react";
+import { type RichTextEditorHandleMethods } from "./core/handle.js";
+import type { ToolEntry } from "./core/customTool.js";
+import { type RichTextDocument } from "./core/jsonDocument.js";
+import { type RichTextSurface } from "./styles/surface.js";
+import type { RichTextEditorPreset } from "./core/tools.js";
+export interface RichTextEditorProps {
+    /**
+     * Документ — HTML-строка, ограниченная Схемой. Пустой документ — `""`.
+     *
+     * Всё, чего нет в Схеме (теги, атрибуты, `style`, обработчики, `javascript:`),
+     * отбрасывается при загрузке. Единственный `style`, который Схема знает, —
+     * цвет автора в строгой форме `color:#rrggbb` на `span` и
+     * `background-color:#rrggbb` на `mark` (`customColor.ts`). Это НЕ санитизация: HTML от пользователя
+     * чистит сервер потребителя, клиентская очистка от XSS не защищает.
+     */
+    value?: string;
+    /**
+     * Начальный документ неуправляемого режима: HTML-строка или JSON-конверт
+     * (`getJSON()`). Конверт проходит Схему, как `setJSON()`;
+     * отвергнутый — пустой документ и ошибка в консоли разработки. До Готовности
+     * Скелет при конверте — рамка без Документа: HTML конверта знает только движок.
+     * `onChange` и скрытое поле формы получают HTML, как всегда.
+     */
+    defaultValue?: string | RichTextDocument;
+    /**
+     * Новый HTML — не чаще раза в `changeDelay` мс, а также сразу на `blur`,
+     * перед отправкой формы и на применение правки HTML-режима. Замена документа
+     * новым `value` сюда не приходит.
+     */
+    onChange?: (html: string) => void;
+    /**
+     * Редактор готов: движок создан, методы Хэндла (`ref`) уже действуют — например,
+     * вставить шаблон. Без аргументов, один раз за монтаж, в том числе при
+     * `readOnly` и `disabled`; перерисовка и смена колбэка повторного вызова не
+     * дают. Ждёт загрузчики Частей для движка своих Инструментов. Серверный
+     * рендер, ошибка набора `tools` и упавший загрузчик (движка нет) его не вызывают.
+     */
+    onReady?: () => void;
+    /**
+     * Фокус вошёл в поле. Поле — целиком: Документ, Панель, поповеры кита и поле
+     * HTML; переход между ними фокус поля не теряет и `onFocus` не повторяет.
+     * Без аргументов: DOM-событие не пробрасывается.
+     */
+    onFocus?: () => void;
+    /**
+     * Фокус ушёл из поля (см. `onFocus`). Перед вызовом отложенный `onChange`
+     * выталкивается, поэтому автосохранение по `onBlur` получает свежий HTML.
+     * Вызов отложен на такт: за это время фокус может вернуться в поле — из
+     * Документа в Панель или поповер и обратно `onBlur` не даёт.
+     */
+    onBlur?: () => void;
+    /**
+     * Задержка `onChange`, мс. По умолчанию 300.
+     *
+     * Сериализация в HTML — проход по всему документу, и на документе в десятки
+     * тысяч символов она на каждую букву тормозила бы ввод. `0` — отдавать каждую
+     * правку сразу.
+     */
+    changeDelay?: number;
+    /** Имя поля формы: рендерит `<input type="hidden">` с текущим HTML. */
+    name?: string;
+    /**
+     * `id` редактируемой области — для внешних ссылок и тестов. Имя от подписи
+     * `FormField` от него не зависит: оно приходит контекстом.
+     */
+    id?: string;
+    /** Плейсхолдер пустого документа; по умолчанию — из каталога. */
+    placeholder?: string;
+    /**
+     * Предел символов. Счётчик остатка появляется у 80 % предела, ввод сверх
+     * него блокируется, вставка обрезается до предела. Длинный `value` грузится
+     * целиком: его можно сокращать, но не удлинять.
+     */
+    maxLength?: number;
+    /** Только чтение: текст выделяется и уходит в форму, но не правится. */
+    readOnly?: boolean;
+    /** Выключено, как у прочих полей: не правится, приглушено, не уходит в форму. */
+    disabled?: boolean;
+    /**
+     * Обязательное поле: `aria-required`, а в обычной `<form>` ещё и блокировка
+     * отправки, пока Документ пуст (нет ни текста, ни Атома, ни таблицы).
+     * Браузер покажет сообщение из каталога (`editor.required`) и вернёт фокус
+     * в Редактор. `readOnly` и `disabled` не проверяются — как у нативных полей.
+     * В `Form` из кита (`noValidate`) браузерной проверки нет — ошибку показывает
+     * потребитель.
+     */
+    required?: boolean;
+    /** Имя поля, когда подписи `FormField` нет. */
+    "aria-label"?: string;
+    /** Имя поля ссылкой на уже нарисованную подпись. Сильнее `aria-label`. */
+    "aria-labelledby"?: string;
+    /** Своё описание. Сливается с подсказкой и ошибкой `FormField`. */
+    "aria-describedby"?: string;
+    /** Невалидность. Без пропа берётся у `FormField` с `error`. */
+    "aria-invalid"?: boolean;
+    /**
+     * Панель форматирования. `"fixed"` (по умолчанию) — над полем, липнет при
+     * прокрутке под шапкой приложения (`--topbar-h`, ADR-0016); `"floating"` —
+     * над непустым выделением, а на сенсорном экране (`pointer: coarse`) —
+     * фиксированная: системное меню выделения iOS и Android она не перекрывает;
+     * `"bubble"` — Меню выделения вместо Панели: компактная плашка на инверсной
+     * поверхности над непустым выделением («¶», жирный, курсив, зачёркнутый,
+     * «…», ссылка, эмодзи), на сенсорном экране — так же фиксированная Панель;
+     * `"none"` — без Панели: форматирование остаётся за клавиатурой. В режиме
+     * `readOnly` Панели нет в любом случае. `Alt+F10` из Документа переводит
+     * фокус в Панель или Меню выделения.
+     */
+    toolbar?: "fixed" | "floating" | "bubble" | "none";
+    /**
+     * Меню выделения поверх фиксированной Панели. По умолчанию `true`: при
+     * `toolbar="fixed"` над непустым выделением появляется то же Меню
+     * выделения, что в режиме `"bubble"` (решение владельца: Панель
+     * сверху — для всего, Меню выделения — чтобы не уводить мышь от текста).
+     * `false` оставляет одну Панель. Остальные режимы проп не меняет: у
+     * `"bubble"` Меню выделения и так есть, у `"floating"` над выделением уже
+     * стоит Панель. На сенсорном экране Меню выделения кита нет — системное
+     * меню выделения iOS и Android занимает то же место.
+     */
+    selectionMenu?: boolean;
+    /**
+     * Пресет — готовый набор встроенных Инструментов: `"full"` (по умолчанию) —
+     * всё; `"basic"` — для комментариев: жирный, курсив, зачёркнутый, строчный
+     * код, ссылка, два вида списков, цитата, отмена и повтор. Игнорируется, если
+     * передан `tools`.
+     */
+    preset?: RichTextEditorPreset;
+    /**
+     * Точный список Инструментов; сильнее `preset`. Выключенный Инструмент
+     * убирает и кнопку, и Блок или Метку из Схемы: их не получить ни сочетанием
+     * клавиш, ни markdown-шорткатом, ни вставкой.
+     *
+     * Вперемешку с именами кита — описания своих Инструментов (`CustomTool`):
+     * `[...RICH_TEXT_PRESETS.full, mergeTagTool]`. Неизвестное имя отбрасывается
+     * молча; описание с ошибкой (имя без Префикса потребителя, совпадение имён,
+     * Часть для движка мимо правил Схемы) — ошибка поля: движок не создаётся,
+     * значение формы остаётся входящим, причина — в консоли разработчика.
+     *
+     * `preset` и `tools` читаются при создании движка: Схема ProseMirror после
+     * этого не меняется. Чтобы сменить набор у живого поля, перемонтируйте его
+     * (`key`) — история правок при этом теряется.
+     */
+    tools?: readonly ToolEntry[];
+    /**
+     * Загрузка картинки: получает файл, отдаёт абсолютный `http(s)`-адрес, по
+     * которому картинка будет жить, или отклоняет обещание.
+     *
+     * С ним картинку можно вставить из буфера, перетащить в поле и выбрать
+     * файлом в поповере картинки. Пока обещание не решено, на месте картинки
+     * плейсхолдер, а в Документе её нет; при отказе Документ не меняется, под
+     * полем — сообщение. Без него файлы не принимаются — только вставка по
+     * адресу. `data:` и `blob:` в Документ не пишутся никогда: адрес вне
+     * политики считается отказом. Читается в момент вставки — менять можно на
+     * лету.
+     */
+    onUploadImage?: (file: File) => Promise<string>;
+    /**
+     * Поверхность Документа: `"theme"` (по умолчанию) — в теме приложения;
+     * `"paper"` — светлый Лист в любой теме, для писем, печати и PDF. Лист —
+     * только редактируемая область: Панель, поповеры, меню и рамка фокуса поля
+     * остаются в теме приложения.
+     */
+    surface?: RichTextSurface;
+    /**
+     * Строка статуса: React-узел внутри рамки поля, в строке счётчика
+     * `maxLength` — своё содержимое у начала, счётчик кита в конце (число слов,
+     * «Сохранено», соавтор). Видна и при `readOnly`, и при `disabled`.
+     *
+     * Кит её не озвучивает: контейнер без `role`, и число слов не зачитывается на
+     * каждую правку. Чтобы «Сохранено» прозвучало, оберните его в
+     * `role="status"` сами. Данные берите из своего состояния: Строка статуса —
+     * пропс экрана, у Инструментов к ней доступа нет.
+     */
+    status?: ReactNode;
+    /**
+     * Предел высоты области Документа (ADR-0059): число — пиксели, строка —
+     * любая CSS-длина (`"32rem"`, `"60vh"`). До предела поле растёт вместе с
+     * Документом, дальше Документ прокручивается внутри рамки; Панель над ним и
+     * Строка статуса под ним остаются на месте. Без пропа своей прокрутки у поля
+     * нет. Предела в строках, как `maxRows` у `TextControl`, здесь нет: у Блоков
+     * разная высота.
+     */
+    maxHeight?: number | string;
+    /**
+     * Ручка высоты в углу области Документа: высоту тянут по вертикали. С
+     * `maxHeight` она задаёт стартовую высоту, а не предел — две системы,
+     * одновременно распоряжающиеся высотой, дают прыгающее поле (тот же довод у
+     * `autosize` в `TextControl`). Без `maxHeight` старт — высота Документа.
+     */
+    resizable?: boolean;
+    /** Классы на корень: ширина, отступы снаружи. */
+    className?: string;
+}
+/**
+ * Императивный доступ к Редактору. Вставка, чтение текста, фокус с позицией и
+ * история — `RichTextEditorHandleMethods` (`handle.ts`).
+ */
+export interface RichTextEditorHandle extends RichTextEditorHandleMethods {
+    /**
+     * Текущий HTML — сейчас, без ожидания `changeDelay`. Пустой документ — `""`.
+     * В HTML-режиме сначала применяет правку поля HTML (через Схему, с
+     * `onChange`, если Документ изменился).
+     */
+    getHTML(): string;
+    /** Очистить документ. Владелец значения узнаёт об этом через `onChange("")`. */
+    clear(): void;
+    /**
+     * Документ как Markdown — сейчас, без ожидания `changeDelay`. Пустой документ
+     * и вызов до монтажа (в серверном рендере движка нет) — `""`.
+     *
+     * Цвет, выравнивание, подчёркивание и размер картинки в Markdown не
+     * выражаются и при выгрузке теряются. В HTML-режиме — как `getHTML()`:
+     * сначала применяется правка поля HTML.
+     */
+    getMarkdown(): string;
+    /**
+     * Заменить документ разобранным Markdown. Как `clear()`, это замена снаружи:
+     * владелец значения узнаёт о ней через `onChange` сразу, предел `maxLength`
+     * её не режет. Всё, чего нет в Схеме, отбрасывается. До монтажа — ничего.
+     */
+    setMarkdown(markdown: string): void;
+    /**
+     * Документ как JSON-конверт — сейчас, без ожидания `changeDelay`.
+     * В отличие от Markdown, ничего не теряет. До монтажа и в серверном рендере —
+     * `null`. В HTML-режиме — как `getHTML()`: сначала применяется правка поля HTML.
+     */
+    getJSON(): RichTextDocument | null;
+    /**
+     * Заменить документ JSON-конвертом. Параметр — `unknown`: главный источник —
+     * `JSON.parse` файла, и форму проверяет Редактор. `true` — заменён, `false` —
+     * конверт отвергнут (не тот формат или версия, кривое дерево) или движка ещё
+     * нет; тогда Документ не тронут. Замена — снаружи, как `setMarkdown()`:
+     * `onChange` сразу, `maxLength` её не режет, всё, чего нет в Схеме,
+     * отбрасывается по тем же правилам, что у HTML.
+     */
+    setJSON(document: unknown): boolean;
+    /**
+     * Открыть панель «Поиск и замена» из кода экрана — то же, что
+     * кнопка «Поиск» и `Mod+F`; `replace` — фокус в поле замены. Без Инструмента
+     * `search`, в HTML-режиме и до монтажа — ничего.
+     */
+    openSearch(options?: {
+        replace?: boolean;
+    }): void;
+    /**
+     * Сырой движок Tiptap: честный выход для команд Меток, Блоков и своих
+     * Инструментов (`editor.chain().focus()…run()`). Его API следует мажору Tiptap,
+     * а не контракту кита. До монтажа и в серверном рендере — `null`.
+     */
+    editor: Editor | null;
+}
+/**
+ * Поле форматированного текста на Tiptap v3 — отдельный вход
+ * `@olddevs/ui/editor` (ADR-0050).
+ *
+ * ЗНАЧЕНИЕ И КУРСОР. Последний HTML, о котором знает владелец значения,
+ * хранится рядом с движком. Входящий `value`, равный ему, — эхо нашей же
+ * правки: документ не пересоздаётся, курсор остаётся на месте. Иначе
+ * управляемый режим сбрасывал бы курсор в начало на каждой букве.
+ *
+ * ФОРМА. Скрытое поле и `onChange` получают HTML по одному и тому же таймеру;
+ * отправка формы и `new FormData(form)` сбрасывают его досрочно, поэтому в
+ * отправке значение свежее даже посреди задержки.
+ *
+ * SSR И СКЕЛЕТ. Движок создаётся только в браузере (`immediatelyRender:
+ * false`) и после загрузчиков Инструментов: до того — на сервере, после
+ * гидратации, при сбое загрузчика — рисуется Скелет: рамка, место Панели и
+ * Документ статичным HTML с классом Документа, без ввода и без прыжка высоты.
+ * Документ Скелета — `value`, очищенный Схемой (`skeleton.ts`), и только в
+ * браузере после монтирования: на сервере Скелет — рамка и место Панели.
+ */
+export declare const RichTextEditor: import("react").ForwardRefExoticComponent<RichTextEditorProps & import("react").RefAttributes<RichTextEditorHandle>>;
+//# sourceMappingURL=RichTextEditor.d.ts.map

package/dist/editor/RichTextEditor.d.ts.map

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