@inkbrick/react 0.0.0-stage → 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,1431 @@
+import * as react from 'react';
+import { ReactNode, PointerEvent, MouseEvent, CSSProperties, ComponentType, SVGProps } from 'react';
+import * as _inkbrick_engine from '@inkbrick/engine';
+import { RangeFormats, Editor, EditorIntent, CaretResult, BlockController, TypedBlock, BlockDefinition, BlockContext, Fragment } from '@inkbrick/engine';
+import * as _inkbrick_document from '@inkbrick/document';
+import { Alignment, BlockId, BaseBlock, BlockProps as BlockProps$1 } from '@inkbrick/document';
+
+type DropPosition = 'before' | 'after';
+interface BlockAnchor {
+    readonly blockId: string;
+    readonly x: number;
+    readonly y: number;
+}
+interface DropIndicatorRect {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+}
+interface DragState {
+    readonly blockId: string;
+    readonly targetId: string | null;
+    readonly position: DropPosition | null;
+    readonly indicator: DropIndicatorRect | null;
+}
+interface BlockHandleState {
+    readonly hover: BlockAnchor | null;
+    readonly menu: BlockAnchor | null;
+    readonly drag: DragState | null;
+}
+declare class BlockHandleController {
+    private state;
+    private readonly listeners;
+    getState: () => BlockHandleState;
+    subscribe: (listener: () => void) => (() => void);
+    setHover(hover: BlockAnchor | null): void;
+    openMenu(menu: BlockAnchor): void;
+    closeMenu(): void;
+    startDrag(blockId: string): void;
+    updateDrag(patch: Partial<Omit<DragState, 'blockId'>>): void;
+    endDrag(): void;
+    private set;
+}
+
+/**
+ * Английский словарь — эталон: набор его ключей определяет `MessageKey`, а недостающие ключи любого другого
+ * словаря берутся отсюда. В строках можно использовать подстановки `{name}`.
+ */
+declare const en: {
+    readonly 'editor.hint': "Press / to open the menu";
+    readonly 'editor.label': "Document";
+    readonly 'block.list.done': "Done";
+    readonly 'block.code.language': "Code language";
+    readonly 'block.code.copy': "Copy code";
+    readonly 'block.code.copied': "Copied";
+    readonly 'block.callout.label': "Callout style: {tone}. Click to change";
+    readonly 'block.callout.change': "Change style";
+    readonly 'block.callout.tone.info': "info";
+    readonly 'block.callout.tone.warning': "warning";
+    readonly 'block.callout.tone.success': "success";
+    readonly 'block.callout.tone.danger': "danger";
+    readonly 'block.unknown.title': "Unknown block type:";
+    readonly 'block.unknown.hint': "Register a component for it via";
+    readonly 'image.options': "Image options";
+    readonly 'image.align.left': "Align left";
+    readonly 'image.align.center': "Align center";
+    readonly 'image.align.right': "Align right";
+    readonly 'image.width': "Image width";
+    readonly 'image.alt': "Alt text";
+    readonly 'image.caption.label': "Caption";
+    readonly 'image.caption.placeholder': "Write a caption…";
+    readonly 'image.replace': "Replace image";
+    readonly 'image.url.label': "Image URL";
+    readonly 'image.url.placeholder': "Paste an image link…";
+    readonly 'image.embed': "Embed";
+    readonly 'image.upload': "Upload";
+    readonly 'image.status.uploading': "Uploading…";
+    readonly 'image.status.none': "No image";
+    readonly 'image.status.unsupported': "This image address is not supported";
+    readonly 'image.status.failed': "The image could not be loaded";
+    readonly 'image.status.retry': "Replace";
+    readonly 'image.error.invalidLink': "Enter a valid http(s) image link";
+    readonly 'image.error.unsupportedAddress': "This image address is not supported";
+    readonly 'image.error.type': "Unsupported image type \"{type}\"";
+    readonly 'image.error.size': "The image is larger than {size} KB. Provide \"images.upload\" to store larger images.";
+    readonly 'image.error.uploadAddress': "The upload returned an unsupported image address";
+    readonly 'image.error.read': "Could not read the file";
+    readonly 'image.error.generic': "Could not add the image";
+    readonly 'formula.source': "LaTeX formula";
+    readonly 'formula.placeholder': "Type LaTeX, e.g. \\frac{a}{b}";
+    readonly 'formula.hint': "Ctrl+Enter to apply, Esc to cancel";
+    readonly 'formula.empty': "Add a formula";
+    readonly 'formula.edit': "Edit formula";
+    readonly 'formula.inline.title': "Inline formula";
+    readonly 'formula.apply': "Apply";
+    readonly 'formula.remove': "Remove formula";
+    readonly 'formula.cancel': "Cancel";
+    readonly 'formula.palette.label': "Math symbols";
+    readonly 'formula.palette.functions': "Functions";
+    readonly 'formula.palette.structures': "Structures";
+    readonly 'formula.palette.greek': "Greek letters";
+    readonly 'formula.palette.operators': "Operators";
+    readonly 'formula.palette.relations': "Relations";
+    readonly 'formula.palette.arrows': "Arrows";
+    readonly 'formula.palette.sets': "Sets and logic";
+    readonly 'color.black': "Black";
+    readonly 'color.white': "White";
+    readonly 'color.gray': "Gray";
+    readonly 'color.brown': "Brown";
+    readonly 'color.orange': "Orange";
+    readonly 'color.yellow': "Yellow";
+    readonly 'color.green': "Green";
+    readonly 'color.blue': "Blue";
+    readonly 'color.purple': "Purple";
+    readonly 'color.pink': "Pink";
+    readonly 'color.red': "Red";
+    readonly 'toolbar.label': "Text formatting";
+    readonly 'toolbar.bold.label': "Bold";
+    readonly 'toolbar.bold.title': "Bold (Ctrl+B)";
+    readonly 'toolbar.italic.label': "Italic";
+    readonly 'toolbar.italic.title': "Italic (Ctrl+I)";
+    readonly 'toolbar.underline.label': "Underline";
+    readonly 'toolbar.underline.title': "Underline (Ctrl+U)";
+    readonly 'toolbar.strike.label': "Strikethrough";
+    readonly 'toolbar.strike.title': "Strikethrough (Ctrl+Shift+X)";
+    readonly 'toolbar.code.label': "Code";
+    readonly 'toolbar.code.title': "Code (Ctrl+E)";
+    readonly 'toolbar.formula.label': "Formula";
+    readonly 'toolbar.formula.title': "Formula (Ctrl+Shift+M)";
+    readonly 'toolbar.color.label': "Text color";
+    readonly 'toolbar.color.title': "Text color";
+    readonly 'toolbar.color.default': "Default color";
+    readonly 'toolbar.highlight.label': "Highlight color";
+    readonly 'toolbar.highlight.title': "Highlight";
+    readonly 'toolbar.highlight.none': "No highlight";
+    readonly 'toolbar.align.left.label': "Align left";
+    readonly 'toolbar.align.left.title': "Align left (Ctrl+Shift+L)";
+    readonly 'toolbar.align.center.label': "Align center";
+    readonly 'toolbar.align.center.title': "Align center (Ctrl+Shift+E)";
+    readonly 'toolbar.align.right.label': "Align right";
+    readonly 'toolbar.align.right.title': "Align right (Ctrl+Shift+R)";
+    readonly 'toolbar.align.justify.label': "Justify";
+    readonly 'toolbar.align.justify.title': "Justify (Ctrl+Shift+J)";
+    readonly 'toolbar.link.label': "Link";
+    readonly 'toolbar.link.title': "Link (Ctrl+K)";
+    readonly 'toolbar.link.url': "Link URL";
+    readonly 'toolbar.link.placeholder': "Paste a link…";
+    readonly 'toolbar.link.apply': "Apply link";
+    readonly 'toolbar.link.remove': "Remove link";
+    readonly 'handle.add': "Add block below";
+    readonly 'handle.grip': "Drag to move, click for options";
+    readonly 'menu.label': "Block options";
+    readonly 'menu.duplicate': "Duplicate";
+    readonly 'menu.moveUp': "Move up";
+    readonly 'menu.moveDown': "Move down";
+    readonly 'menu.delete': "Delete";
+    readonly 'menu.turnInto': "Turn into";
+    readonly 'menu.empty': "No actions";
+    readonly 'history.undo': "Undo";
+    readonly 'history.redo': "Redo";
+    readonly 'slash.label': "Insert block";
+    readonly 'slash.empty': "No results";
+    readonly 'slash.item.text.title': "Text";
+    readonly 'slash.item.text.description': "Plain paragraph";
+    readonly 'slash.item.text.keywords': "paragraph, p";
+    readonly 'slash.item.heading-1.title': "Heading 1";
+    readonly 'slash.item.heading-1.description': "Large section heading";
+    readonly 'slash.item.heading-1.keywords': "h1, title";
+    readonly 'slash.item.heading-2.title': "Heading 2";
+    readonly 'slash.item.heading-2.description': "Medium section heading";
+    readonly 'slash.item.heading-2.keywords': "h2, subtitle";
+    readonly 'slash.item.heading-3.title': "Heading 3";
+    readonly 'slash.item.heading-3.description': "Small section heading";
+    readonly 'slash.item.heading-3.keywords': "h3";
+    readonly 'slash.item.heading-4.title': "Heading 4";
+    readonly 'slash.item.heading-4.description': "Subsection heading";
+    readonly 'slash.item.heading-4.keywords': "h4";
+    readonly 'slash.item.heading-5.title': "Heading 5";
+    readonly 'slash.item.heading-5.description': "Minor subsection heading";
+    readonly 'slash.item.heading-5.keywords': "h5";
+    readonly 'slash.item.heading-6.title': "Heading 6";
+    readonly 'slash.item.heading-6.description': "Smallest heading";
+    readonly 'slash.item.heading-6.keywords': "h6";
+    readonly 'slash.item.bullet-list.title': "Bulleted list";
+    readonly 'slash.item.bullet-list.description': "Simple bulleted list";
+    readonly 'slash.item.bullet-list.keywords': "ul, unordered, list";
+    readonly 'slash.item.numbered-list.title': "Numbered list";
+    readonly 'slash.item.numbered-list.description': "List with numbering";
+    readonly 'slash.item.numbered-list.keywords': "ol, ordered, list";
+    readonly 'slash.item.todo-list.title': "To-do list";
+    readonly 'slash.item.todo-list.description': "Track tasks with checkboxes";
+    readonly 'slash.item.todo-list.keywords': "todo, task, checkbox, check";
+    readonly 'slash.item.quote.title': "Quote";
+    readonly 'slash.item.quote.description': "Capture a quote";
+    readonly 'slash.item.quote.keywords': "blockquote, citation";
+    readonly 'slash.item.code.title': "Code";
+    readonly 'slash.item.code.description': "Code snippet with monospace font";
+    readonly 'slash.item.code.keywords': "snippet, pre, program";
+    readonly 'slash.item.callout.title': "Callout";
+    readonly 'slash.item.callout.description': "Highlight important information";
+    readonly 'slash.item.callout.keywords': "info, note, warning, tip, alert";
+    readonly 'slash.item.image.title': "Image";
+    readonly 'slash.item.image.description': "Upload or embed an image";
+    readonly 'slash.item.image.keywords': "picture, photo, img, upload";
+    readonly 'slash.item.formula.title': "Formula";
+    readonly 'slash.item.formula.description': "Display a LaTeX formula";
+    readonly 'slash.item.formula.keywords': "math, equation, latex, tex";
+    readonly 'slash.item.divider.title': "Divider";
+    readonly 'slash.item.divider.description': "Visually separate sections";
+    readonly 'slash.item.divider.keywords': "hr, line, separator, rule";
+};
+type MessageKey = keyof typeof en;
+type Messages = Readonly<Record<MessageKey, string>>;
+type PartialMessages = Readonly<Partial<Record<MessageKey, string>>>;
+
+type MessageParams = Readonly<Record<string, string | number>>;
+type TFunction = (key: MessageKey, params?: MessageParams) => string;
+/**
+ * Подключает словарь под кодом языка (`'de'`, `'uk'`, `'pt-BR'`). Словарь может быть неполным: недостающие
+ * ключи берутся из английского. Повторная регистрация того же кода заменяет словарь (в том числе встроенный).
+ */
+declare function registerLocale(code: string, messages: PartialMessages): void;
+declare function getLocales(): string[];
+interface ResolveMessagesOptions {
+    readonly locale?: string;
+    readonly locales?: Readonly<Record<string, PartialMessages>>;
+    readonly messages?: PartialMessages;
+}
+declare function resolveMessages(options?: ResolveMessagesOptions): Messages;
+declare function createTranslator(messages: Messages): TFunction;
+
+type ImageErrorCode = 'type' | 'size' | 'uploadAddress' | 'read';
+interface ImageErrorInfo {
+    readonly message: string;
+    readonly code?: ImageErrorCode;
+    readonly params?: MessageParams;
+}
+
+/**
+ * Какие блоки-картинки сейчас загружаются и какие ошибки загрузки показать. Состояние живёт здесь, а не в
+ * компоненте: пока файл обрабатывается, выбор файла заменяется индикатором и локальное состояние пропало бы.
+ */
+declare class UploadTracker {
+    private readonly active;
+    private readonly errors;
+    private readonly listeners;
+    has: (blockId: string) => boolean;
+    errorOf: (blockId: string) => string | undefined;
+    errorDetailsOf: (blockId: string) => ImageErrorInfo | undefined;
+    subscribe: (listener: () => void) => (() => void);
+    start(blockId: string): void;
+    finish(blockId: string, error?: string | ImageErrorInfo): void;
+    clearError(blockId: string): void;
+    private notify;
+}
+
+/**
+ * Какие блоки сейчас затронуты непустым выделением. Подписка идёт на уровне отдельного блока:
+ * при смене выделения перерисовываются только те блоки, у которых флаг `selected` изменился.
+ */
+declare class BlockSelectionController {
+    private selected;
+    private readonly listeners;
+    isSelected: (blockId: string) => boolean;
+    subscribe: (listener: () => void) => (() => void);
+    set(ids: readonly string[]): void;
+}
+
+type FormulaEditorMode = 'insert' | 'edit';
+interface FormulaEditorState {
+    readonly open: boolean;
+    readonly mode: FormulaEditorMode;
+    readonly blockId: string;
+    readonly from: number;
+    readonly to: number;
+    readonly latex: string;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+        readonly top: number;
+    };
+}
+declare class FormulaController {
+    private state;
+    private readonly listeners;
+    getState: () => FormulaEditorState;
+    subscribe: (listener: () => void) => (() => void);
+    open(state: Omit<FormulaEditorState, 'open'>): void;
+    close(): void;
+    private set;
+}
+
+/**
+ * В каком блоке сейчас стоит каретка (выделение свёрнуто). Подписка идёт на уровне блока: при переносе каретки
+ * перерисовываются только два блока — тот, который она покинула, и тот, куда попала.
+ */
+declare class CaretController {
+    private blockId;
+    private readonly listeners;
+    has: (blockId: string) => boolean;
+    subscribe: (listener: () => void) => (() => void);
+    set(blockId: string | null): void;
+}
+
+interface SlashMenuState {
+    readonly open: boolean;
+    readonly blockId: string | null;
+    readonly slashOffset: number;
+    readonly query: string;
+    readonly activeIndex: number;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+}
+declare class SlashMenuController {
+    private state;
+    private readonly listeners;
+    getState: () => SlashMenuState;
+    subscribe: (listener: () => void) => (() => void);
+    open(blockId: string, slashOffset: number): void;
+    close(): void;
+    update(patch: Partial<Pick<SlashMenuState, 'query' | 'activeIndex' | 'position'>>): void;
+    move(delta: number, count: number): void;
+    private set;
+}
+
+interface DocPoint {
+    blockId: string;
+    offset: number;
+}
+interface DocSelection {
+    from: DocPoint;
+    to: DocPoint;
+    collapsed: boolean;
+}
+
+type InlineFormat = 'bold' | 'italic' | 'underline' | 'strike' | 'code';
+type ToolbarPanel = 'color' | 'highlight';
+interface ToolbarProps {
+    readonly formats: RangeFormats;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly linkOpen: boolean;
+    readonly onToggle: (format: InlineFormat) => void;
+    readonly onOpenLink: () => void;
+    readonly onApplyLink: (url: string | null) => boolean;
+    readonly onCancelLink: () => void;
+    readonly panel: ToolbarPanel | null;
+    readonly onTogglePanel: (panel: ToolbarPanel) => void;
+    readonly onApplyColor: (kind: 'color' | 'backgroundColor', value: string | null) => void;
+    readonly onAlign: (align: Alignment) => void;
+    readonly onInsertFormula: () => void;
+}
+
+interface ToolbarState {
+    readonly visible: boolean;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    } | null;
+    readonly formats: RangeFormats | null;
+    readonly range: DocSelection | null;
+    readonly linkOpen: boolean;
+    readonly panel: ToolbarPanel | null;
+}
+declare class ToolbarController {
+    private state;
+    private readonly listeners;
+    getState: () => ToolbarState;
+    subscribe: (listener: () => void) => (() => void);
+    show(range: DocSelection, formats: RangeFormats, position: {
+        x: number;
+        y: number;
+    }): void;
+    hide(): void;
+    openLink(): void;
+    togglePanel(panel: ToolbarPanel): void;
+    closePanel(): void;
+    closeLink(): void;
+    private set;
+}
+
+/**
+ * Какие блоки обязаны оставаться в DOM при виртуальной отрисовке: края выделения (там стоит каретка или
+ * начинается/кончается выделение) и блоки, которые редактор попросил показать (`reveal`), например перед
+ * установкой каретки в блок за пределами окна. Обычный рендерер это состояние не читает.
+ */
+declare class ViewportController {
+    private edges;
+    private revealed;
+    private lists;
+    private version;
+    private readonly listeners;
+    getVersion: () => number;
+    subscribe: (listener: () => void) => (() => void);
+    getPinned(): readonly string[];
+    get virtual(): boolean;
+    attach(): () => void;
+    setEdges(ids: readonly string[]): void;
+    reveal(ids: readonly string[]): boolean;
+    private notify;
+}
+
+/**
+ * Связь модели с DOM: корневой редактируемый элемент и элементы текстовых блоков.
+ * Нужна, чтобы после изменения модели вернуть курсор/выделение на место.
+ */
+declare class EditorView {
+    private readonly elements;
+    private root;
+    readonly slash: SlashMenuController;
+    readonly uploads: UploadTracker;
+    readonly selection: BlockSelectionController;
+    readonly caret: CaretController;
+    readonly blocks: BlockHandleController;
+    readonly formula: FormulaController;
+    readonly toolbar: ToolbarController;
+    readonly viewport: ViewportController;
+    pointerDown: boolean;
+    private pending;
+    setRoot(element: HTMLElement | null): () => void;
+    getRoot(): HTMLElement | null;
+    register(id: BlockId, element: HTMLElement): () => void;
+    getElement(id: BlockId): HTMLElement | undefined;
+    placeCaret(id: BlockId, offset: number): void;
+    placeSelection(from: DocPoint, to: DocPoint): void;
+}
+
+declare const EditorContext: react.Context<Editor | null>;
+declare const EditorViewContext: react.Context<EditorView | null>;
+
+/**
+ * Тип токена подсветки. Стандартные типы получают цвета из `@inkbrick/styles` (`--inkbrick-syntax-*`); свой подсветчик может
+ * вернуть и любой другой тип — он попадёт в `data-inkbrick-token` как есть, и вы раскрасите его своим CSS.
+ */
+type HighlightTokenType = 'keyword' | 'string' | 'comment' | 'number' | 'function' | 'type' | 'constant' | 'builtin' | 'variable' | 'property' | 'tag' | 'attribute' | 'meta' | 'regex' | (string & {});
+interface HighlightToken {
+    readonly from: number;
+    readonly to: number;
+    readonly type: HighlightTokenType;
+}
+/**
+ * Подсветчик кода: по тексту и языку (`props.language` блока) возвращает токены. Результат не обязан быть
+ * упорядоченным и не должен быть идеальным: пересечения, выход за границы и неверные типы отбрасываются, а текст
+ * блока подсветка изменить не может. Встроенный подсветчик — `highlightCode`; подключить Shiki, Prism или
+ * highlight.js можно, обернув их в такую функцию (`<EditorProvider highlighter={…}>`).
+ */
+type CodeHighlighter = (code: string, language: string) => readonly HighlightToken[];
+
+interface FormulaRenderOptions {
+    readonly display: boolean;
+}
+/**
+ * Рисует формулу в `target`: по коду LaTeX строит DOM (MathML, HTML, SVG…). Может быть асинхронной — например, для
+ * подгрузки библиотеки. Если код ошибочен, функция должна бросить исключение: редактор покажет исходный текст и
+ * сообщение об ошибке. Встроенный `temmlRenderer` строит MathML; KaTeX подключается так:
+ * `(latex, target, { display }) => katex.render(latex, target, { displayMode: display, throwOnError: true })`.
+ *
+ * Результат вставляется в страницу как есть, поэтому используйте только безопасные режимы библиотек
+ * (например, `trust: false`): LaTeX приходит из документа и может быть недоверенным.
+ */
+type FormulaRenderer = (latex: string, target: HTMLElement, options: FormulaRenderOptions) => void | Promise<void>;
+declare const temmlRenderer: FormulaRenderer;
+/**
+ * Подключает стили MathML (Temml) к документу или теневому корню встроенной формулы. В документе стили кладутся
+ * в слой `inkbrick.math`, поэтому любое ваше правило без слоя сильнее. Стили подгружаются при первом вызове
+ * и применяются, как только загрузятся (одновременно с самой формулой).
+ */
+declare function ensureMathStyles(scope: Document | ShadowRoot): void;
+type FormulaState = 'empty' | 'source' | 'loading' | 'ready' | 'error';
+interface MountFormulaOptions {
+    readonly display: boolean;
+    readonly renderer: FormulaRenderer | null;
+    readonly onSettled?: (state: 'ready' | 'error', message?: string) => void;
+}
+/**
+ * Рисует формулу в `target`. Пока идёт расчёт, виден исходный код (`data-state="loading"`); готовый результат кладётся
+ * в кэш, поэтому одинаковые формулы (и перерисовка блока на каждое нажатие клавиши) появляются сразу, без мигания.
+ * Возвращает функцию отмены: после неё устаревший результат в `target` не попадёт.
+ */
+declare function mountFormula(target: HTMLElement, latex: string, { display, renderer, onSettled }: MountFormulaOptions): () => void;
+
+interface SlashMenuItem {
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    readonly keywords?: readonly string[];
+    readonly icon?: ReactNode;
+    readonly flavour: string;
+    readonly props?: Readonly<Record<string, unknown>>;
+}
+interface SlashMenuProps {
+    readonly items: readonly SlashMenuItem[];
+    readonly query: string;
+    readonly activeIndex: number;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly onSelect: (item: SlashMenuItem) => void;
+    readonly onHover: (index: number) => void;
+    readonly onClose: () => void;
+}
+
+interface KeymapContext {
+    readonly editor: Editor;
+    readonly view: EditorView;
+    readonly root: HTMLElement;
+    readonly event: KeyboardEvent;
+    readonly slashItems: readonly SlashMenuItem[];
+    selection(): DocSelection | null;
+    exec<T = unknown>(intent: EditorIntent): T | undefined;
+    run(action: () => CaretResult | undefined): void;
+    replaceSelection(selection: DocSelection, text: string): CaretResult | undefined;
+    undo(): void;
+    redo(): void;
+    toggleFormat(format: string): void;
+}
+interface KeyBinding {
+    /**
+     * Уникальное имя. Привязка с тем же `id`, что у стандартной, заменяет её (на её месте в порядке проверки);
+     * остальные проверяются раньше стандартных.
+     */
+    readonly id: string;
+    /**
+     * Комбинации: `'Mod-b'`, `'Mod-Shift-z'`, `'Tab'`, `'Shift-Tab'`, `'ArrowDown'`. `Mod` — Ctrl или Cmd.
+     * Shift и Alt учитываются точно (`'Tab'` не срабатывает на Shift+Tab). Пустой массив отключает привязку.
+     */
+    readonly keys: string | readonly string[];
+    readonly when?: (context: KeymapContext) => boolean;
+    /**
+     * Обработчик. `false` — «не моё»: событие идёт дальше по списку привязок и в браузер.
+     * Любой другой результат считается обработкой: `preventDefault` вызывается автоматически.
+     */
+    readonly run: (context: KeymapContext) => boolean | void;
+}
+
+interface ImageOptions {
+    /**
+     * Загружает файл и возвращает адрес картинки (http(s) или относительный). Без него картинки
+     * встраиваются в документ как data:-адреса (до `maxInlineBytes`).
+     */
+    readonly upload?: (file: File) => Promise<string>;
+    /** Предел размера для встраивания data:-картинки, байт (по умолчанию 1,5 МБ). */
+    readonly maxInlineBytes?: number;
+    /** Допустимые MIME-типы (по умолчанию PNG, JPEG, GIF, WebP, AVIF). SVG не поддерживается. */
+    readonly acceptedTypes?: readonly string[];
+    readonly onError?: (error: unknown, file: File) => void;
+}
+
+/**
+ * Props встроенного жеста для элемента-«хваталки»: клик открывает меню, протягивание мышью
+ * или долгое нажатие пальцем переносит блок. Свой DnD может их не вешать (см. `useBlockDrag`).
+ */
+interface GripProps {
+    readonly onPointerDown: (event: PointerEvent<HTMLElement>) => void;
+    /** Долгое нажатие пальцем не должно открывать системное контекстное меню. */
+    readonly onContextMenu: (event: MouseEvent<HTMLElement>) => void;
+    /** `touch-action: none`: палец на хваталке не прокручивает страницу. */
+    readonly style: CSSProperties;
+    readonly 'data-inkbrick-grip': '';
+}
+interface BlockHandleProps {
+    readonly blockId: string;
+    /** Левый верхний угол блока в координатах окна (для position: fixed). */
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly canAdd: boolean;
+    readonly dragging: boolean;
+    readonly menuOpen: boolean;
+    readonly onAdd: () => void;
+    /** Открывает меню действий (например, по клавиатуре). Обычный клик по «хваталке» открывает его сам. */
+    readonly onOpenMenu: () => void;
+    /**
+     * Повесьте на элемент-«хваталку»: клик открывает меню, протягивание мышью или долгое нажатие пальцем
+     * переносит блок. Для своего DnD не вешайте их, а вызовите `onOpenMenu` по клику и `useBlockDrag()` для переноса.
+     */
+    readonly gripProps: GripProps;
+}
+interface DropIndicatorProps {
+    readonly blockId: string;
+    readonly targetId: string;
+    readonly position: DropPosition;
+    /** Где рисовать линию, в координатах окна (для position: fixed). */
+    readonly indicator: DropIndicatorRect;
+}
+interface BlockMenuAction {
+    readonly id: string;
+    readonly title: string;
+    readonly icon?: ReactNode;
+    readonly disabled?: boolean;
+    readonly danger?: boolean;
+    readonly run: () => void;
+}
+interface BlockMenuProps {
+    readonly block: BaseBlock;
+    readonly position: {
+        readonly x: number;
+        readonly y: number;
+    };
+    readonly actions: readonly BlockMenuAction[];
+    readonly turnInto: readonly BlockMenuAction[];
+    readonly onClose: () => void;
+}
+
+/**
+ * Props, которые получает React-представление блока.
+ *
+ * Блок нельзя изменять напрямую: все изменения документа идут через
+ * `editor.dispatch(...)`. Для редактируемого текста используйте компонент
+ * `<Editable block={block} placeholder="…" />` — он подключает ввод, выделение и
+ * клавиатурные действия редактора. Дочерние блоки выводит `<BlockChildren id={block.id} />`.
+ */
+interface BlockViewProps<TBlock extends BaseBlock = BaseBlock> {
+    readonly block: TBlock;
+    readonly editor: Editor;
+    readonly selected: boolean;
+    readonly readOnly: boolean;
+    /**
+     * Контроллер типа блока (`defineBlock({ controller })`), если есть. Удобнее хук `useBlockController(block)`:
+     * его `execute`/`can` сами подставляют `blockId`.
+     */
+    readonly controller?: BlockController<any>;
+}
+type BlockComponent<TBlock extends BaseBlock = BaseBlock> = ComponentType<BlockViewProps<TBlock>>;
+type BlockComponentRegistry = Readonly<Partial<Record<string, BlockComponent>>>;
+interface UnknownBlockViewProps extends BlockViewProps {
+    /** Уже выведенные дочерние блоки (данные не теряются, даже если тип блока неизвестен). */
+    readonly children?: ReactNode;
+}
+interface EditorSlots {
+    readonly UnknownBlock?: ComponentType<UnknownBlockViewProps>;
+    readonly SlashMenu?: ComponentType<SlashMenuProps>;
+    readonly Toolbar?: ComponentType<ToolbarProps> | null;
+    /**
+     * Ручка слева от блока («+» и хваталка для переноса); `null` отключает ручки, меню и встроенное перетаскивание.
+     * Свой DnD подключается через `useBlockDrag()` — в своей ручке или в любом компоненте внутри `<EditorProvider>`.
+     */
+    readonly BlockHandle?: ComponentType<BlockHandleProps> | null;
+    readonly BlockMenu?: ComponentType<BlockMenuProps>;
+    readonly DropIndicator?: ComponentType<DropIndicatorProps> | null;
+}
+interface EditorUIConfig {
+    readonly components: BlockComponentRegistry;
+    readonly slots: EditorSlots;
+    readonly slashItems: readonly SlashMenuItem[];
+    readonly highlighter: CodeHighlighter | null;
+    readonly formulaRenderer: FormulaRenderer | null;
+    readonly locale: string;
+    readonly t: TFunction;
+    readonly keymap: readonly KeyBinding[];
+    readonly images: ImageOptions;
+    readonly readOnly?: boolean;
+}
+
+/**
+ * Визуальный слой редактора одним объектом: представления блоков, элементы оболочки (меню, toolbar, ручки),
+ * пункты slash-меню, подсветка кода и отрисовка формул. Модель документа и команды от него не зависят, поэтому
+ * дизайн-систему можно подключить к любому редактору: `<EditorProvider presentation={myDesignSystem}>`.
+ *
+ * Отдельные props провайдера (`components`, `slots`, …) уточняют presentation: `components` и `slots`
+ * сливаются с ним (одинаковый ключ — из prop), остальное заменяется целиком.
+ */
+interface EditorPresentation {
+    readonly components?: BlockComponentRegistry;
+    readonly slots?: EditorSlots;
+    readonly slashItems?: readonly SlashMenuItem[] | false;
+    readonly highlighter?: CodeHighlighter | false;
+    readonly formulaRenderer?: FormulaRenderer | false;
+}
+declare function definePresentation<T extends EditorPresentation>(presentation: T): T;
+
+type CustomBlockViewProps<TProps extends BlockProps$1 = BlockProps$1> = BlockViewProps<TypedBlock<TProps> & {
+    props: TProps;
+}>;
+/**
+ * Пользовательский блок целиком: схема документа, React-компонент и (необязательно) контроллер поведения.
+ * Схема и контроллер нужны движку (`new Editor({ blocks: [...] })`), компонент — UI (`<EditorProvider blocks>`).
+ */
+interface ReactBlockDefinition<TProps extends BlockProps$1 = BlockProps$1> extends BlockDefinition<TProps> {
+    readonly component: ComponentType<CustomBlockViewProps<TProps>>;
+    readonly controller?: BlockController<TProps>;
+}
+/**
+ * Объявляет пользовательский блок одним объектом:
+ *
+ * ```ts
+ * export const counterBlock = defineBlock<CounterProps>({ schema, component: CounterView, controller });
+ * const editor = new Editor({ blocks: [counterBlock] });
+ * <EditorProvider editor={editor} blocks={[counterBlock]}>…
+ * ```
+ *
+ * Объект создавайте один раз (вне компонента).
+ */
+declare function defineBlock<TProps extends BlockProps$1 = BlockProps$1>(definition: ReactBlockDefinition<TProps>): ReactBlockDefinition<TProps>;
+
+interface EditorProviderProps {
+    readonly editor: Editor;
+    readonly children: ReactNode;
+    /**
+     * Визуальный слой одним объектом (дизайн-система): представления блоков, оболочка, slash-меню, подсветка кода
+     * и формулы — см. `definePresentation`. Отдельные props ниже уточняют его. Держите объект стабильным.
+     */
+    readonly presentation?: EditorPresentation;
+    /**
+     * Пользовательские блоки из `defineBlock`: их компоненты добавляются к `components` (prop `components`
+     * с тем же flavour важнее). Схемы и контроллеры этих блоков передайте и в `new Editor({ blocks })`:
+     * пункты slash-меню, меню блока и клавиши берутся из контроллеров редактора. Держите массив стабильным.
+     */
+    readonly blocks?: readonly ReactBlockDefinition<any>[];
+    /**
+     * Свои React-представления блоков: `{ 'block:paragraph': MyParagraph }`.
+     * Не указанные flavour используют стандартные компоненты Inkbrick.
+     * Чтобы не перерисовывать документ без необходимости, держите объект стабильным
+     * (вынесите из компонента или оберните в useMemo).
+     */
+    readonly components?: BlockComponentRegistry;
+    readonly slots?: EditorSlots;
+    /**
+     * Пункты slash-меню. Дополняют стандартные (одинаковый `id` заменяет стандартный пункт);
+     * `false` выключает меню. Держите массив стабильным (вынесите из компонента или useMemo).
+     */
+    readonly slashItems?: readonly SlashMenuItem[] | false;
+    /**
+     * Подсветка синтаксиса в блоках кода. По умолчанию — встроенный `highlightCode` (без зависимостей);
+     * свой подсветчик (Shiki, Prism, highlight.js) — функция `(code, language) => токены`; `false` выключает подсветку.
+     * Держите функцию стабильной: смена функции перерисовывает все блоки кода.
+     */
+    readonly highlighter?: CodeHighlighter | false;
+    /**
+     * Отрисовка формул (блоки и встроенные): по умолчанию Temml → MathML, подгружается при первой формуле.
+     * Свой подсчётчик (KaTeX, MathJax) — функция `(latex, target, { display }) => void | Promise<void>`;
+     * `false` — показывать только исходный код. Держите функцию стабильной: её смена перерисовывает все формулы.
+     */
+    readonly formulaRenderer?: FormulaRenderer | false;
+    /**
+     * Язык интерфейса: код подключённого словаря (`'en'`, `'ru'` или свой, см. `registerLocale` и `locales`).
+     * `'pt-BR'` без своего словаря возьмёт `'pt'`; неизвестный код — английский. По умолчанию `'en'`.
+     */
+    readonly locale?: string;
+    /**
+     * Словари, подключаемые только к этому редактору: `{ de: { 'menu.delete': 'Löschen', … } }`.
+     * Словарь может быть неполным — недостающее берётся из английского. Держите объект стабильным.
+     */
+    readonly locales?: Readonly<Record<string, PartialMessages>>;
+    /** Точечные замены строк поверх выбранного языка: `{ 'menu.delete': 'Убрать' }`. Держите объект стабильным. */
+    readonly messages?: PartialMessages;
+    /**
+     * Свои привязки клавиш. Привязка с `id` стандартной (`'undo'`, `'format.bold'`, `'indent'`, …) заменяет её,
+     * новая проверяется раньше стандартных; `unbind('id')` отключает стандартную. Держите массив стабильным.
+     */
+    readonly keymap?: readonly KeyBinding[];
+    /**
+     * Режим только чтения: ввод, команды, undo, toolbar, ручки блоков и slash-меню отключены,
+     * выделение и копирование работают. Применяется к редактору (`editor.setReadOnly`), поэтому
+     * защищает документ и от вызовов из кода.
+     */
+    readonly readOnly?: boolean;
+    /**
+     * Изображения: `upload` — куда сохранять файлы (иначе картинки встраиваются в документ как data:-адреса
+     * до `maxInlineBytes`), `acceptedTypes`, `onError`. Держите объект стабильным.
+     */
+    readonly images?: ImageOptions;
+}
+declare function EditorProvider({ editor, children, presentation, blocks, components, slots, slashItems, keymap, highlighter, formulaRenderer, locale, locales, messages, readOnly, images, }: EditorProviderProps): react.JSX.Element;
+
+declare function useEditor(): _inkbrick_engine.Editor;
+
+declare function useEditorView(): EditorView;
+
+declare function useDocument(): _inkbrick_document.Document;
+
+/**
+ * Подписывается на один блок. Блоки в документе иммутабельны (каждое изменение
+ * создаёт новый объект), поэтому ссылка — корректный snapshot для React.
+ */
+declare function useBlock(id: BlockId): _inkbrick_document.BaseBlock | undefined;
+
+/**
+ * Идентификаторы дочерних блоков. Возвращает стабильную ссылку, пока children
+ * не изменились (создавать новый массив в getSnapshot нельзя — это приводит
+ * к бесконечному циклу рендера в useSyncExternalStore).
+ */
+declare function useChildren(parentId: BlockId): readonly BlockId[];
+
+interface HistoryControls {
+    readonly canUndo: boolean;
+    readonly canRedo: boolean;
+    undo(): boolean;
+    redo(): boolean;
+}
+declare function useHistory(): HistoryControls;
+
+declare function useReadOnly(): boolean;
+
+interface BlockControllerHandle<TProps extends BlockProps$1 = BlockProps$1> extends BlockContext<TProps> {
+    readonly controller: BlockController<TProps> | undefined;
+}
+/**
+ * Контроллер блока для его React-компонента: `execute('counter.increment')` и `can(...)` уже знают `blockId`.
+ * Команды уважают режим только чтения (возвращают undefined); для разметки используйте prop `readOnly`.
+ */
+declare function useBlockController<TProps extends BlockProps$1 = BlockProps$1>(block: BaseBlock): BlockControllerHandle<TProps>;
+
+declare function embeddedFragment(html: string): Fragment | null;
+declare function htmlToFragment(html: string): Fragment | null;
+
+declare function uploadImage(file: File, options: ImageOptions): Promise<string>;
+declare function normalizeImageUrl(input: string): string | null;
+
+/** Props встроенных компонентов; пользовательским компонентам доступны также `editor`, `selected` и `readOnly`. */
+type BlockProps = Pick<BlockViewProps, 'block'> & Partial<Pick<BlockViewProps, 'selected' | 'readOnly'>>;
+
+/**
+ * Выводит дочерние блоки `id` — для пользовательских компонентов-контейнеров. Как именно (все сразу или только
+ * видимые), решает рендерер документа (`<DocumentView renderer>`).
+ */
+declare function BlockChildren({ id }: {
+    readonly id: BlockId;
+}): react.JSX.Element;
+
+/**
+ * Стандартная заглушка для блока с незарегистрированным flavour.
+ * Не редактируется; данные блока остаются в документе нетронутыми.
+ */
+declare function UnknownBlockView({ block, children }: UnknownBlockViewProps): react.JSX.Element;
+
+interface EditableProps {
+    readonly block: BaseBlock;
+    /**
+     * Собственная подсказка пустого блока (показывается всегда, пока блок пуст). Не нужна: по умолчанию редактор
+     * сам показывает одну общую подсказку («Нажмите / …») в пустом блоке, где стоит каретка.
+     */
+    readonly placeholder?: string;
+}
+/**
+ * Текст блока. Сам по себе не является contenteditable: редактируемым элементом
+ * служит корень `<DocumentView>`, благодаря чему выделение может охватывать несколько блоков.
+ * Содержимое рисуется из `block.content`, а ввод обрабатывается корнем через движок.
+ *
+ * Атрибуты для стилизации: `data-empty`, `data-focused` (каретка в этом блоке), `data-hint` (текст общей
+ * подсказки; есть только там, где работает slash-меню), `data-placeholder` (своя подсказка, если задана).
+ */
+declare function Editable({ block, placeholder }: EditableProps): react.JSX.Element;
+
+declare function PageBlock({ block }: BlockProps): react.JSX.Element;
+
+declare function NoteBlock({ block }: BlockProps): react.JSX.Element;
+
+declare function ParagraphBlock({ block, selected }: BlockProps): react.JSX.Element;
+
+declare function HeadingBlock({ block, selected }: BlockProps): react.JSX.Element;
+
+declare function ListBlock({ block, selected, readOnly }: BlockProps): react.JSX.Element;
+
+declare function QuoteBlock({ block, selected }: BlockProps): react.JSX.Element;
+
+/**
+ * Языки в выпадающем списке. Редактор хранит только `language`; подсветку делает `highlighter` провайдера
+ * (по умолчанию встроенный — он знает эти языки и их псевдонимы).
+ */
+declare const CODE_LANGUAGES: readonly ["plain", "typescript", "javascript", "json", "html", "css", "python", "bash", "sql", "go", "rust", "java", "c", "cpp", "markdown", "yaml"];
+declare function CodeBlock({ block, editor, selected, readOnly }: BlockViewProps): react.JSX.Element;
+
+declare function DividerBlock({ block, selected }: BlockProps): react.JSX.Element;
+
+declare function CalloutBlock({ block, editor, selected, readOnly }: BlockViewProps): react.JSX.Element;
+
+declare function ImageBlock({ block, editor, selected, readOnly }: BlockViewProps): react.JSX.Element;
+
+interface BlockRendererProps {
+    readonly id: BlockId;
+}
+declare const BlockRenderer: react.NamedExoticComponent<BlockRendererProps>;
+
+interface ChildListProps {
+    readonly parentId: BlockId;
+    readonly ids: readonly BlockId[];
+}
+/**
+ * Способ отрисовки документа: как выводить детей каждого контейнера (страницы, заметки, вложенного списка).
+ * Модель и команды от него не зависят. Встроенные варианты — `fullRenderer` (всё дерево, по умолчанию)
+ * и `virtualRenderer()` (только блоки около видимой области).
+ */
+interface DocumentRenderer {
+    readonly ChildList: ComponentType<ChildListProps>;
+}
+declare const fullRenderer: DocumentRenderer;
+
+interface DocumentViewProps {
+    readonly label?: string;
+    /**
+     * Как рисовать блоки: `'full'` (по умолчанию) — всё дерево; `'virtual'` или `virtualRenderer({...})` — только
+     * блоки около видимой области (для документов на тысячи блоков); либо свой `DocumentRenderer`.
+     */
+    readonly renderer?: 'full' | 'virtual' | DocumentRenderer;
+}
+/**
+ * Единственный редактируемый элемент документа. Все блоки лежат внутри него, поэтому
+ * выделение работает через границы блоков; ввод перехватывается и превращается в команды движка.
+ */
+declare function DocumentView({ label, renderer }?: DocumentViewProps): react.JSX.Element;
+
+type BlockHeightEstimate = (block: BaseBlock) => number;
+/**
+ * Оценка по умолчанию под стандартные стили: строки текста × высота строки + отступы блока.
+ * Ошибка оценки сказывается только на длине полосы прокрутки: отрисованный блок измеряется точно.
+ */
+declare const estimateBlockHeight: BlockHeightEstimate;
+
+interface VirtualRendererOptions {
+    /** Контейнер с меньшим числом детей рисуется целиком. По умолчанию 100. */
+    readonly threshold?: number;
+    /** Запас над и под видимой областью, в котором блоки уже отрисованы, px. По умолчанию 1200. */
+    readonly overscan?: number;
+    /** Не больше стольких блоков подряд в окне (защита от нулевых высот). По умолчанию 400. */
+    readonly maxRendered?: number;
+    readonly estimateHeight?: BlockHeightEstimate;
+}
+/**
+ * Виртуальный рендерер: в DOM только блоки около видимой области, остальные заменены распорками известной
+ * (измеренной) или оценённой высоты. Подключение: `<DocumentView renderer={virtualRenderer()} />` (или
+ * `renderer="virtual"` с настройками по умолчанию). Создавайте рендерер один раз, вне компонента.
+ */
+declare function virtualRenderer(options?: VirtualRendererOptions): DocumentRenderer;
+
+declare function useEditorUI(): EditorUIConfig;
+
+declare const defaultBlockComponents: BlockComponentRegistry;
+
+declare function resolveBlockComponent(flavour: string, custom: BlockComponentRegistry): BlockComponent | undefined;
+
+/** Длиннее этого текста блок не подсвечивается: подсветка пересчитывается на каждое нажатие клавиши. */
+declare const HIGHLIGHT_LIMIT = 100000;
+declare function normalizeLanguage(language: string): string;
+/**
+ * Встроенный подсветчик: без зависимостей, по правилам для распространённых языков (JavaScript/TypeScript, Python,
+ * Go, Rust, Java, C/C++, Bash, SQL, JSON, YAML, HTML/XML, CSS, Markdown). Это не полноценный разбор, а быстрая
+ * лексическая раскраска; для точности подключите свой `CodeHighlighter` (Shiki, Prism, highlight.js).
+ * Неизвестный язык, `plain` и слишком длинный текст дают пустой список токенов.
+ */
+declare const highlightCode: CodeHighlighter;
+
+interface FormulaViewProps {
+    readonly latex: string;
+    readonly display?: boolean;
+    readonly showError?: boolean;
+    readonly onSettled?: (state: 'ready' | 'error', message?: string) => void;
+}
+/**
+ * Формула, нарисованная выбранным в `EditorProvider` подсчётчиком (по умолчанию Temml → MathML). Пока считается и при
+ * ошибке виден исходный код. Атрибуты: `data-inkbrick-part="formula-render"`, `data-state="empty|source|loading|ready|error"`.
+ */
+declare function FormulaView({ latex, display, showError, onSettled, }: FormulaViewProps): react.JSX.Element;
+
+declare function useT(): TFunction;
+declare function useLocale(): string;
+
+declare const ru: Messages;
+
+declare const ICON_SHAPES: {
+    readonly bold: readonly [readonly ["path", {
+        readonly d: "M6 12h9a4 4 0 010 8H7a1 1 0 01-1-1V5a1 1 0 011-1h7a4 4 0 010 8";
+    }]];
+    readonly italic: readonly [readonly ["line", {
+        readonly x1: "19";
+        readonly x2: "10";
+        readonly y1: "4";
+        readonly y2: "4";
+    }], readonly ["line", {
+        readonly x1: "14";
+        readonly x2: "5";
+        readonly y1: "20";
+        readonly y2: "20";
+    }], readonly ["line", {
+        readonly x1: "15";
+        readonly x2: "9";
+        readonly y1: "4";
+        readonly y2: "20";
+    }]];
+    readonly underline: readonly [readonly ["path", {
+        readonly d: "M6 4v6a6 6 0 0 0 12 0V4";
+    }], readonly ["line", {
+        readonly x1: "4";
+        readonly x2: "20";
+        readonly y1: "20";
+        readonly y2: "20";
+    }]];
+    readonly strike: readonly [readonly ["path", {
+        readonly d: "M16 4H9a3 3 0 0 0-2.83 4";
+    }], readonly ["path", {
+        readonly d: "M14 12a4 4 0 0 1 0 8H6";
+    }], readonly ["line", {
+        readonly x1: "4";
+        readonly x2: "20";
+        readonly y1: "12";
+        readonly y2: "12";
+    }]];
+    readonly code: readonly [readonly ["path", {
+        readonly d: "m18 16 4-4-4-4";
+    }], readonly ["path", {
+        readonly d: "m6 8-4 4 4 4";
+    }], readonly ["path", {
+        readonly d: "m14.5 4-5 16";
+    }]];
+    readonly link: readonly [readonly ["path", {
+        readonly d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71";
+    }], readonly ["path", {
+        readonly d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71";
+    }]];
+    readonly unlink: readonly [readonly ["path", {
+        readonly d: "m18.84 12.25 1.72-1.71h-.02a5.004 5.004 0 0 0-.12-7.07 5.006 5.006 0 0 0-6.95 0l-1.72 1.71";
+    }], readonly ["path", {
+        readonly d: "m5.17 11.75-1.71 1.71a5.004 5.004 0 0 0 .12 7.07 5.006 5.006 0 0 0 6.95 0l1.71-1.71";
+    }], readonly ["line", {
+        readonly x1: "8";
+        readonly x2: "8";
+        readonly y1: "2";
+        readonly y2: "5";
+    }], readonly ["line", {
+        readonly x1: "2";
+        readonly x2: "5";
+        readonly y1: "8";
+        readonly y2: "8";
+    }], readonly ["line", {
+        readonly x1: "16";
+        readonly x2: "16";
+        readonly y1: "19";
+        readonly y2: "22";
+    }], readonly ["line", {
+        readonly x1: "19";
+        readonly x2: "22";
+        readonly y1: "16";
+        readonly y2: "16";
+    }]];
+    readonly check: readonly [readonly ["path", {
+        readonly d: "M20 6 9 17l-5-5";
+    }]];
+    readonly x: readonly [readonly ["path", {
+        readonly d: "M18 6 6 18";
+    }], readonly ["path", {
+        readonly d: "m6 6 12 12";
+    }]];
+    readonly plus: readonly [readonly ["path", {
+        readonly d: "M5 12h14";
+    }], readonly ["path", {
+        readonly d: "M12 5v14";
+    }]];
+    readonly grip: readonly [readonly ["circle", {
+        readonly cx: "9";
+        readonly cy: "12";
+        readonly r: "1";
+    }], readonly ["circle", {
+        readonly cx: "9";
+        readonly cy: "5";
+        readonly r: "1";
+    }], readonly ["circle", {
+        readonly cx: "9";
+        readonly cy: "19";
+        readonly r: "1";
+    }], readonly ["circle", {
+        readonly cx: "15";
+        readonly cy: "12";
+        readonly r: "1";
+    }], readonly ["circle", {
+        readonly cx: "15";
+        readonly cy: "5";
+        readonly r: "1";
+    }], readonly ["circle", {
+        readonly cx: "15";
+        readonly cy: "19";
+        readonly r: "1";
+    }]];
+    readonly trash: readonly [readonly ["path", {
+        readonly d: "M10 11v6";
+    }], readonly ["path", {
+        readonly d: "M14 11v6";
+    }], readonly ["path", {
+        readonly d: "M19 6v14a2 2 0 0 1-2 2H7a2 2 0 0 1-2-2V6";
+    }], readonly ["path", {
+        readonly d: "M3 6h18";
+    }], readonly ["path", {
+        readonly d: "M8 6V4a2 2 0 0 1 2-2h4a2 2 0 0 1 2 2v2";
+    }]];
+    readonly copy: readonly [readonly ["rect", {
+        readonly width: "14";
+        readonly height: "14";
+        readonly x: "8";
+        readonly y: "8";
+        readonly rx: "2";
+        readonly ry: "2";
+    }], readonly ["path", {
+        readonly d: "M4 16c-1.1 0-2-.9-2-2V4c0-1.1.9-2 2-2h10c1.1 0 2 .9 2 2";
+    }]];
+    readonly 'arrow-up': readonly [readonly ["path", {
+        readonly d: "m5 12 7-7 7 7";
+    }], readonly ["path", {
+        readonly d: "M12 19V5";
+    }]];
+    readonly 'arrow-down': readonly [readonly ["path", {
+        readonly d: "M12 5v14";
+    }], readonly ["path", {
+        readonly d: "m19 12-7 7-7-7";
+    }]];
+    readonly 'chevron-down': readonly [readonly ["path", {
+        readonly d: "m6 9 6 6 6-6";
+    }]];
+    readonly text: readonly [readonly ["path", {
+        readonly d: "M13 4v16";
+    }], readonly ["path", {
+        readonly d: "M17 4v16";
+    }], readonly ["path", {
+        readonly d: "M19 4H9.5a4.5 4.5 0 0 0 0 9H13";
+    }]];
+    readonly 'heading-1': readonly [readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }], readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["path", {
+        readonly d: "m17 12 3-2v8";
+    }]];
+    readonly 'heading-2': readonly [readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }], readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["path", {
+        readonly d: "M21 18h-4c0-4 4-3 4-6 0-1.5-2-2.5-4-1";
+    }]];
+    readonly 'heading-3': readonly [readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }], readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["path", {
+        readonly d: "M17.5 10.5c1.7-1 3.5 0 3.5 1.5a2 2 0 0 1-2 2";
+    }], readonly ["path", {
+        readonly d: "M17 17.5c2 1.5 4 .3 4-1.5a2 2 0 0 0-2-2";
+    }]];
+    readonly 'heading-4': readonly [readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["path", {
+        readonly d: "M17 10v3a1 1 0 0 0 1 1h3";
+    }], readonly ["path", {
+        readonly d: "M21 10v8";
+    }], readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }]];
+    readonly 'heading-5': readonly [readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }], readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["path", {
+        readonly d: "M17 13v-3h4";
+    }], readonly ["path", {
+        readonly d: "M17 17.7c.4.2.8.3 1.3.3 1.5 0 2.7-1.1 2.7-2.5S19.8 13 18.3 13H17";
+    }]];
+    readonly 'heading-6': readonly [readonly ["path", {
+        readonly d: "M4 12h8";
+    }], readonly ["path", {
+        readonly d: "M4 18V6";
+    }], readonly ["path", {
+        readonly d: "M12 18V6";
+    }], readonly ["circle", {
+        readonly cx: "19";
+        readonly cy: "16";
+        readonly r: "2";
+    }], readonly ["path", {
+        readonly d: "M20 10c-2 2-3 3.5-3 6";
+    }]];
+    readonly list: readonly [readonly ["path", {
+        readonly d: "M3 5h.01";
+    }], readonly ["path", {
+        readonly d: "M3 12h.01";
+    }], readonly ["path", {
+        readonly d: "M3 19h.01";
+    }], readonly ["path", {
+        readonly d: "M8 5h13";
+    }], readonly ["path", {
+        readonly d: "M8 12h13";
+    }], readonly ["path", {
+        readonly d: "M8 19h13";
+    }]];
+    readonly 'list-ordered': readonly [readonly ["path", {
+        readonly d: "M11 5h10";
+    }], readonly ["path", {
+        readonly d: "M11 12h10";
+    }], readonly ["path", {
+        readonly d: "M11 19h10";
+    }], readonly ["path", {
+        readonly d: "M4 4h1v5";
+    }], readonly ["path", {
+        readonly d: "M4 9h2";
+    }], readonly ["path", {
+        readonly d: "M6.5 20H3.4c0-1 2.6-1.925 2.6-3.5a1.5 1.5 0 0 0-2.6-1.02";
+    }]];
+    readonly 'list-todo': readonly [readonly ["path", {
+        readonly d: "M13 5h8";
+    }], readonly ["path", {
+        readonly d: "M13 12h8";
+    }], readonly ["path", {
+        readonly d: "M13 19h8";
+    }], readonly ["path", {
+        readonly d: "m3 17 2 2 4-4";
+    }], readonly ["path", {
+        readonly d: "m3 7 2 2 4-4";
+    }]];
+    readonly quote: readonly [readonly ["path", {
+        readonly d: "M17 5H3";
+    }], readonly ["path", {
+        readonly d: "M21 12H8";
+    }], readonly ["path", {
+        readonly d: "M21 19H8";
+    }], readonly ["path", {
+        readonly d: "M3 12v7";
+    }]];
+    readonly divider: readonly [readonly ["path", {
+        readonly d: "M5 12h14";
+    }]];
+    readonly info: readonly [readonly ["circle", {
+        readonly cx: "12";
+        readonly cy: "12";
+        readonly r: "10";
+    }], readonly ["path", {
+        readonly d: "M12 16v-4";
+    }], readonly ["path", {
+        readonly d: "M12 8h.01";
+    }]];
+    readonly warning: readonly [readonly ["path", {
+        readonly d: "m21.73 18-8-14a2 2 0 0 0-3.48 0l-8 14A2 2 0 0 0 4 21h16a2 2 0 0 0 1.73-3";
+    }], readonly ["path", {
+        readonly d: "M12 9v4";
+    }], readonly ["path", {
+        readonly d: "M12 17h.01";
+    }]];
+    readonly success: readonly [readonly ["circle", {
+        readonly cx: "12";
+        readonly cy: "12";
+        readonly r: "10";
+    }], readonly ["path", {
+        readonly d: "m16 9-5.5 5.5L8 12";
+    }]];
+    readonly danger: readonly [readonly ["path", {
+        readonly d: "m15 9-6 6";
+    }], readonly ["path", {
+        readonly d: "M2.586 16.726A2 2 0 0 1 2 15.312V8.688a2 2 0 0 1 .586-1.414l4.688-4.688A2 2 0 0 1 8.688 2h6.624a2 2 0 0 1 1.414.586l4.688 4.688A2 2 0 0 1 22 8.688v6.624a2 2 0 0 1-.586 1.414l-4.688 4.688a2 2 0 0 1-1.414.586H8.688a2 2 0 0 1-1.414-.586z";
+    }], readonly ["path", {
+        readonly d: "m9 9 6 6";
+    }]];
+    readonly image: readonly [readonly ["rect", {
+        readonly width: "18";
+        readonly height: "18";
+        readonly x: "3";
+        readonly y: "3";
+        readonly rx: "2";
+        readonly ry: "2";
+    }], readonly ["circle", {
+        readonly cx: "9";
+        readonly cy: "9";
+        readonly r: "2";
+    }], readonly ["path", {
+        readonly d: "m21 15-3.086-3.086a2 2 0 0 0-2.828 0L6 21";
+    }]];
+    readonly replace: readonly [readonly ["path", {
+        readonly d: "M14 4a1 1 0 0 1 1-1";
+    }], readonly ["path", {
+        readonly d: "M15 10a1 1 0 0 1-1-1";
+    }], readonly ["path", {
+        readonly d: "M21 4a1 1 0 0 0-1-1";
+    }], readonly ["path", {
+        readonly d: "M21 9a1 1 0 0 1-1 1";
+    }], readonly ["path", {
+        readonly d: "m3 7 3 3 3-3";
+    }], readonly ["path", {
+        readonly d: "M6 10V5a2 2 0 0 1 2-2h2";
+    }], readonly ["rect", {
+        readonly x: "3";
+        readonly y: "14";
+        readonly width: "7";
+        readonly height: "7";
+        readonly rx: "1";
+    }]];
+    readonly 'align-left': readonly [readonly ["path", {
+        readonly d: "M21 5H3";
+    }], readonly ["path", {
+        readonly d: "M15 12H3";
+    }], readonly ["path", {
+        readonly d: "M17 19H3";
+    }]];
+    readonly 'align-center': readonly [readonly ["path", {
+        readonly d: "M21 5H3";
+    }], readonly ["path", {
+        readonly d: "M17 12H7";
+    }], readonly ["path", {
+        readonly d: "M19 19H5";
+    }]];
+    readonly 'align-right': readonly [readonly ["path", {
+        readonly d: "M21 5H3";
+    }], readonly ["path", {
+        readonly d: "M21 12H9";
+    }], readonly ["path", {
+        readonly d: "M21 19H7";
+    }]];
+    readonly 'align-justify': readonly [readonly ["path", {
+        readonly d: "M3 5h18";
+    }], readonly ["path", {
+        readonly d: "M3 12h18";
+    }], readonly ["path", {
+        readonly d: "M3 19h18";
+    }]];
+    readonly baseline: readonly [readonly ["path", {
+        readonly d: "M4 20h16";
+    }], readonly ["path", {
+        readonly d: "m6 16 6-12 6 12";
+    }], readonly ["path", {
+        readonly d: "M8 12h8";
+    }]];
+    readonly highlighter: readonly [readonly ["path", {
+        readonly d: "m9 11-6 6v3h9l3-3";
+    }], readonly ["path", {
+        readonly d: "m22 12-4.6 4.6a2 2 0 0 1-2.8 0l-5.2-5.2a2 2 0 0 1 0-2.8L14 4";
+    }]];
+    readonly sigma: readonly [readonly ["path", {
+        readonly d: "M18 7V5a1 1 0 0 0-1-1H6.5a.5.5 0 0 0-.4.8l4.5 6a2 2 0 0 1 0 2.4l-4.5 6a.5.5 0 0 0 .4.8H17a1 1 0 0 0 1-1v-2";
+    }]];
+};
+type IconName = keyof typeof ICON_SHAPES;
+
+interface IconProps extends Omit<SVGProps<SVGSVGElement>, 'name' | 'children'> {
+    readonly name: IconName;
+}
+/**
+ * Иконка из набора Lucide (ISC). Рисуется текущим цветом текста; размер задаётся CSS (`--inkbrick-icon-size`
+ * или `width`/`height` у `[data-inkbrick-icon]`). Годится и для пользовательских пунктов slash-меню и меню блока.
+ */
+declare function Icon({ name, ...props }: IconProps): react.JSX.Element;
+
+/**
+ * Стандартные привязки редактора, в порядке проверки. Свои привязки передаются в `<EditorProvider keymap>`:
+ * тот же `id` заменяет стандартную, новый `id` проверяется раньше стандартных.
+ */
+declare const defaultKeymap: readonly KeyBinding[];
+
+/**
+ * Собирает итоговый список привязок: свои привязки с `id` стандартной занимают её место, остальные идут
+ * перед стандартными (проверяются первыми).
+ */
+declare function resolveKeymap(custom?: readonly KeyBinding[]): readonly KeyBinding[];
+declare function unbind(id: string): KeyBinding;
+
+/**
+ * Нажата ли ровно эта комбинация: Shift и Alt должны совпадать точно; Ctrl/Meta, если не упомянуты,
+ * не должны быть нажаты (`Mod` принимает любую из двух).
+ */
+declare function matchesShortcut(event: KeyboardEvent, spec: string): boolean;
+
+declare const defaultSlashItems: readonly SlashMenuItem[];
+
+declare function filterSlashItems(items: readonly SlashMenuItem[], query: string): SlashMenuItem[];
+
+declare function DefaultSlashMenu({ items, activeIndex, position, onSelect, onHover, }: SlashMenuProps): react.JSX.Element;
+
+declare function DefaultToolbar({ formats, position, linkOpen, panel, onToggle, onOpenLink, onApplyLink, onCancelLink, onTogglePanel, onApplyColor, onAlign, onInsertFormula, }: ToolbarProps): react.JSX.Element;
+
+declare function DefaultBlockHandle({ blockId, position, canAdd, dragging, menuOpen, onAdd, onOpenMenu, gripProps, }: BlockHandleProps): react.JSX.Element;
+
+declare function DefaultDropIndicator({ indicator, position }: DropIndicatorProps): react.JSX.Element;
+
+interface BlockDropTarget {
+    readonly targetId: string;
+    readonly position: DropPosition;
+    readonly indicator: DropIndicatorRect;
+}
+interface BlockRects {
+    /** Строка самого блока (его текст), без вложенных блоков. */
+    readonly row: DOMRect;
+    /** Весь блок вместе с вложенными блоками. */
+    readonly box: DOMRect;
+}
+/**
+ * Всё, что нужно своей системе перетаскивания блоков (dnd-kit, pragmatic-drag-and-drop, своя на pointer events):
+ * геометрия, проверка цели, линия вставки и сам перенос. Встроенное перетаскивание построено на этом же API.
+ *
+ * Обычный порядок: `start(blockId)` → на каждое движение `update(x, y)` → `drop()` или `cancel()`.
+ */
+interface BlockDragApi {
+    /** Блок с ручкой под точкой окна; точку в полосе слева от текста прижимает к тексту. */
+    blockAtPoint(x: number, y: number): string | null;
+    blockRects(blockId: string): BlockRects | null;
+    /** Можно ли перенести блок `blockId` перед/после `targetId` (схема, вложенность, глубина). */
+    canMove(blockId: string, targetId: string, position: DropPosition): boolean;
+    /** Допустимое место вставки под точкой окна для блока `blockId`; верхняя половина строки — «перед». */
+    dropTargetAt(blockId: string, x: number, y: number): BlockDropTarget | null;
+    start(blockId: string): void;
+    /** Задаёт текущее место вставки (или убирает его) и рисует линию. Цель, которую движок не примет, отбрасывается. */
+    setTarget(target: BlockDropTarget | null): void;
+    /** Удобная связка `dropTargetAt` + `setTarget` с автопрокруткой у края окна. Возвращает найденную цель. */
+    update(x: number, y: number): BlockDropTarget | null;
+    /** Завершает перенос: применяет его к текущей цели одним шагом undo. `true`, если блок перенесён. */
+    drop(): boolean;
+    cancel(): void;
+    /** Переносит блок сразу, без жеста (например, из своего DnD без линии вставки). Один шаг undo. */
+    move(blockId: string, targetId: string, position: DropPosition): boolean;
+    autoScroll(clientY: number): void;
+    getState(): DragState | null;
+    subscribe(listener: () => void): () => void;
+}
+
+/**
+ * API перетаскивания блоков текущего редактора: на нём строится своя система DnD
+ * (dnd-kit, pragmatic-drag-and-drop и т. п.). Объект стабилен между рендерами.
+ * Работает внутри `<EditorProvider>`, в том числе в компоненте `slots.BlockHandle`.
+ */
+declare function useBlockDrag(): BlockDragApi;
+declare function useBlockDragState(): DragState | null;
+
+declare function DefaultBlockMenu({ position, actions, turnInto, onClose }: BlockMenuProps): react.JSX.Element;
+
+export { BlockChildren, type BlockComponent, type BlockComponentRegistry, type BlockControllerHandle, type BlockDragApi, type DragState as BlockDragState, type BlockDropTarget, type BlockHandleProps, type BlockHeightEstimate, type BlockMenuAction, type BlockMenuProps, type BlockProps, type BlockRects, BlockRenderer, type BlockRendererProps, type BlockViewProps, CODE_LANGUAGES, CalloutBlock, type ChildListProps, CodeBlock, type CodeHighlighter, type CustomBlockViewProps, DefaultBlockHandle, DefaultBlockMenu, DefaultDropIndicator, DefaultSlashMenu, DefaultToolbar, DividerBlock, type DocumentRenderer, DocumentView, type DocumentViewProps, type DropIndicatorProps, type DropIndicatorRect, type DropPosition, Editable, type EditableProps, EditorContext, type EditorPresentation, EditorProvider, type EditorProviderProps, type EditorSlots, type EditorUIConfig, EditorView, EditorViewContext, type FormulaRenderOptions, type FormulaRenderer, type FormulaState, FormulaView, type GripProps, HIGHLIGHT_LIMIT, HeadingBlock, type HighlightToken, type HighlightTokenType, type HistoryControls, Icon, type IconName, type IconProps, ImageBlock, type ImageOptions, type InlineFormat, type KeyBinding, type KeymapContext, ListBlock, type MessageKey, type MessageParams, type Messages, NoteBlock, PageBlock, ParagraphBlock, type PartialMessages, QuoteBlock, type ReactBlockDefinition, type SlashMenuItem, type SlashMenuProps, type TFunction, type ToolbarProps, UnknownBlockView, type UnknownBlockViewProps, type VirtualRendererOptions, createTranslator, defaultBlockComponents, defaultKeymap, defaultSlashItems, defineBlock, definePresentation, embeddedFragment, en, ensureMathStyles, estimateBlockHeight, filterSlashItems, fullRenderer, getLocales, highlightCode, htmlToFragment, matchesShortcut, mountFormula, normalizeImageUrl, normalizeLanguage, registerLocale, resolveBlockComponent, resolveKeymap, resolveMessages, ru, temmlRenderer, unbind, uploadImage, useBlock, useBlockController, useBlockDrag, useBlockDragState, useChildren, useDocument, useEditor, useEditorUI, useEditorView, useHistory, useLocale, useReadOnly, useT, virtualRenderer };