@kodaeditor/core 1.0.0

package/dist/editor.d.ts

@@ -0,0 +1,372 @@
+import { EditorView } from 'prosemirror-view';
+import { type ImportFormat } from './import-formats';
+import { type DocxImportResult } from './docx-import';
+import { type Strings } from './i18n';
+export interface EditorOptions {
+    /** Контейнер, в который монтируется редактор. */
+    element: HTMLElement;
+    /** Начальный HTML-контент. */
+    content?: string;
+    /** Подсказка, когда документ пуст. */
+    placeholder?: string;
+    /** Доступное имя для скринридеров (ARIA). */
+    ariaLabel?: string;
+    /** Локализованные строки UI (для slash-меню и floating-тулбара). */
+    strings?: Strings;
+    /** Колбэк при каждом изменении документа. */
+    onChange?: (html: string) => void;
+    /** Колбэки для плавающей панели таблицы (открыть диалог вместо «голой» команды). */
+    tableCallbacks?: {
+        onSplitCell?: () => void;
+        onMergeCells?: () => void;
+    };
+}
+declare const schema: import("prosemirror-model").Schema<keyof import("orderedmap").default<import("prosemirror-model").NodeSpec>, keyof import("orderedmap").default<import("prosemirror-model").MarkSpec>>;
+/** Свойства ячейки таблицы (диалог «Свойства ячейки»). */
+export interface CellProps {
+    background?: string;
+    textAlign?: string;
+    verticalAlign?: string;
+    borderWidth?: number;
+    borderColor?: string;
+}
+/** Свойства таблицы (диалог «Свойства таблицы»). */
+export interface TableProps {
+    width?: string;
+    align?: string;
+    borderWidth?: number;
+    borderColor?: string;
+}
+export declare class Editor {
+    readonly view: EditorView;
+    private readonly onChange?;
+    /**
+     * Подтверждена ли лицензия. Влияет ТОЛЬКО на пометку в выгрузках - ничего
+     * не отключает и не блокирует: принцип «деградация, а не блокировка»
+     * остаётся, редактор работает целиком в любом случае.
+     */
+    private licensed;
+    /**
+     * Промис идущей проверки лицензии. Нужен потому, что licensed стартует с
+     * false, а решение приходит только после сети: без ожидания ЛЮБАЯ выгрузка
+     * в первые секунды после монтирования уносила бы ознакомительную пометку в
+     * документ оплатившего клиента. Окно тем шире, чем хуже наша связь - до 6
+     * секунд при недоступном сервере лицензий, - и сценарий «открыл документ,
+     * нажал Печать» в него укладывается, а маршрут вида /print/:id в
+     * хост-приложении попадает туда почти всегда.
+     *
+     * Обратное решение (считать лицензию действующей до ответа) не годится: оно
+     * дало бы неоплатившим повторяемое окно чистых выгрузок.
+     */
+    private licenseCheck;
+    /** Строки интерфейса - нужны для текста пометки на языке пользователя. */
+    private readonly strings;
+    private placeholderText;
+    private premiumPaste;
+    private pendingRtf;
+    private pastePlainOnce;
+    private pdfModeResolver?;
+    private readonly tocViews;
+    private readonly trackState;
+    private readonly paginationState;
+    constructor(opts: EditorOptions);
+    /** Текущий документ как чистый HTML. */
+    getHTML(): string;
+    /**
+     * Заменить содержимое из HTML-строки.
+     *
+     * Через транзакцию, а не пересозданием state, чтобы сохранить историю
+     * undo/redo - иначе Ctrl+Z после программной установки молча не работает.
+     */
+    setHTML(html: string): void;
+    /**
+     * Импорт файла .docx прямо в редактор. Возвращает предупреждения движка
+     * (неподдержанные стили и т.п.) - UI может их показать или проигнорировать.
+     */
+    importDocx(source: File | ArrayBuffer): Promise<DocxImportResult>;
+    /** Вставляет HTML в позицию курсора (НЕ заменяя весь документ). */
+    insertHtmlAtCursor(html: string): void;
+    /**
+     * Единый импорт файла: детект типа -> нужный обработчик. .docx ОТКРЫВАЕТ
+     * (заменяет документ); картинка/CSV/txt ВСТАВЛЯЮТСЯ в курсор. Бросает для
+     * неподдержанного типа. Точка подключения для кнопки/drag-drop/paste.
+     */
+    importFile(file: File): Promise<ImportFormat>;
+    /** Импорт PDF как картинок: каждая страница -> PNG, вставляется в документ. */
+    importPdfAsImages(file: File): Promise<void>;
+    /**
+     * Импорт PDF «как есть»: встраивает сам файл (data-URL) блоком-iframe.
+     * Полностью client-side, на сервер не уходит. Просмотр - встроенным
+     * PDF-вьюером браузера; редактировать содержимое нельзя (atom-узел).
+     */
+    importPdfAsEmbed(file: File): Promise<void>;
+    /** Хост задаёт спрашивалку режима PDF (текст/картинки/встроить). */
+    setPdfModeResolver(fn: () => Promise<'text' | 'images' | 'embed' | null>): void;
+    /**
+     * Импорт PDF с выбором режима, если хост задал резолвер (drag-drop, буфер).
+     * Без резолвера - поведение по умолчанию (текст), как раньше.
+     */
+    importPdfWithChoice(file: File): Promise<void>;
+    /**
+     * Вставка «богатого» буфера, полученного из companion-расширения в обход
+     * браузерной песочницы: на вход полный сырой HTML + RTF (с встроенными
+     * картинками). Прогоняем тот же премиум-пайплайн и вставляем в курсор.
+     */
+    pasteRich(html: string, rtf?: string): void;
+    /**
+     * Сменить подсказку пустого документа на лету. Нужна хосту: атрибут
+     * placeholder заявлен в observedAttributes веб-компонента, и до этого
+     * изменение атрибута молча ничего не делало - подсказка была вшита в
+     * плагин при создании редактора.
+     */
+    setPlaceholder(text: string): void;
+    /** Сменить доступное имя области ввода (атрибут aria-label у хоста). */
+    setAriaLabel(label: string): void;
+    /** Документ как JSON (для хранения в БД без потери структуры). */
+    getJSON(): Record<string, unknown>;
+    /** Пустой ли документ (нет текстового содержимого). */
+    isEmpty(): boolean;
+    /** Включает/выключает премиум smart-paste (по лицензии). */
+    /**
+     * Отметить лицензию подтверждённой. Ставит хост после проверки (valid или
+     * grace). До этого выгрузки несут ознакомительную пометку.
+     */
+    setLicensed(on: boolean): void;
+    /**
+     * Ознакомительная пометка в ВЫГРУЗКАХ.
+     *
+     * Зачем она нужна отдельно от знака на экране: знак видит тот, кто работает
+     * в редакторе, а платит не он. Пометка же уходит туда, где продукт отдаёт
+     * ценность наружу - в договор, счёт, отчёт, которые компания отправляет
+     * своему клиенту. Отправить такой документ со строкой об ознакомительном
+     * режиме нельзя, и это делает работу без лицензии невозможной по деловым
+     * причинам, а не по техническим.
+     *
+     * Что при этом НЕ делается: ничего не отключается, экспорт работает
+     * полностью, файл открывается и читается. Деградация, а не блокировка.
+     *
+     * Честно: снять это со стороны страницы по-прежнему можно - код исполняется
+     * у клиента. Барьер остаётся юридическим, пометка лишь делает нарушение
+     * видимым тому, кому документ придёт.
+     */
+    private trialNotice;
+    /** Пометка для текстовых форматов (txt, md, csv): отдельной строкой в конце. */
+    private appendTrialText;
+    /** Пометка для HTML-подобных форматов: абзацем в конце документа. */
+    private appendTrialHtml;
+    setPremiumPaste(on: boolean): void;
+    /** Следующая вставка - только текст (для кнопки тулбара). */
+    armPlainPaste(): void;
+    /**
+     * Передаёт редактору промис идущей проверки лицензии. Вызывает web-компонент
+     * сразу после монтирования; при использовании ядра напрямую промиса нет и
+     * поведение прежнее.
+     */
+    setLicenseCheck(p: Promise<unknown>): void;
+    /**
+     * Ждёт решения по лицензии перед выгрузкой. Потолок 7 секунд - чуть больше
+     * сетевого таймаута самой проверки (6 с), то есть в норме мы упираемся в её
+     * собственный таймаут, а не в этот. Потолок здесь на случай проверки, которая
+     * по какой-то причине не завершилась вовсе: выгрузка не должна зависнуть.
+     */
+    private licenseSettled;
+    /**
+     * Экспорт документа в PDF средствами браузера (печать). Client-side:
+     * содержимое не уходит на сервер (важно для ЭДО), рендер браузерный = WYSIWYG.
+     */
+    exportPdf(): Promise<void>;
+    /** Экспорт документа в Markdown (скачивание .md). Client-side. */
+    exportMarkdown(): Promise<void>;
+    /** Экспорт в самодостаточный HTML-файл (.html). Client-side. */
+    exportHtml(): Promise<void>;
+    /** Экспорт в простой текст (.txt). Client-side. */
+    exportText(): Promise<void>;
+    /** Экспорт таблиц документа в CSV (.csv). Client-side. */
+    exportCsv(): Promise<void>;
+    /** Экспорт в Word (.doc - Word-совместимый HTML). Client-side, без библиотек. */
+    exportWord(): Promise<void>;
+    focus(): void;
+    /** Текущее состояние поиска для UI: всего совпадений и номер активного (1-based). */
+    searchInfo(): {
+        count: number;
+        current: number;
+    };
+    private scrollToActiveMatch;
+    /** Задать поисковый запрос (подсветит все совпадения, перейдёт к первому). */
+    setSearchQuery(query: string): {
+        count: number;
+        current: number;
+    };
+    /** К следующему совпадению (с циклом). */
+    searchNext(): {
+        count: number;
+        current: number;
+    };
+    /** К предыдущему совпадению (с циклом). */
+    searchPrev(): {
+        count: number;
+        current: number;
+    };
+    /** Заменить активное совпадение. */
+    replaceCurrentMatch(replacement: string): {
+        count: number;
+        current: number;
+    };
+    /** Заменить все совпадения. Возвращает число замен. */
+    replaceAll(replacement: string): number;
+    /** Сбросить поиск (убрать подсветку). */
+    clearSearch(): void;
+    destroy(): void;
+    private run;
+    toggleMark(name: keyof typeof schema.marks): void;
+    setHeading(level: number): void;
+    setParagraph(): void;
+    /**
+     * Применить стиль из галереи (система стилей): тип блока + интервалы одним
+     * действием. blockquote оборачивает; heading/paragraph меняют тип с атрибутами.
+     */
+    applyBlockStyle(style: {
+        type: 'paragraph' | 'heading' | 'blockquote';
+        level?: number;
+        spacing?: string | null;
+    }): void;
+    toggleBulletList(): void;
+    toggleOrderedList(): void;
+    wrapBlockquote(): void;
+    /** Выделить весь документ (для пункта меню «Выделить всё»). */
+    selectAll(): void;
+    /** Пустое ли выделение (каретка без диапазона). */
+    isSelectionEmpty(): boolean;
+    private copiedMarks;
+    /** Запомнить форматирование текущей позиции (для «кисти формата»). */
+    copyFormat(): void;
+    hasCopiedFormat(): boolean;
+    /** Применить запомненное форматирование к выделению (заменяет инлайн-формат). */
+    applyCopiedFormat(): void;
+    setCodeBlock(): void;
+    /** Применить марку с атрибутами к выделению (или к будущему вводу, если пусто). */
+    private applyAttrMark;
+    private clearAttrMark;
+    /**
+     * Безопасно ли CSS-значение для подстановки в одно объявление style:
+     * запрещаем выход из объявления (`;{}`), HTML-брейкаут (`<>`) и опасные
+     * CSS-функции (url(), expression(), @import, комментарии). Защита от
+     * хранимой CSS-инъекции, если в сеттер передадут недоверенную строку.
+     */
+    private safeCss;
+    /** Размер шрифта, напр. "16px" (пусто - сбросить; невалидное - игнор). */
+    setFontSize(size: string): void;
+    /** Семейство шрифта (пусто - сбросить; невалидное - игнор). */
+    setFontFamily(family: string): void;
+    /** Цвет текста (пусто - сбросить; невалидное - игнор). */
+    setTextColor(color: string): void;
+    /** Выделение фоном (пусто - снять; невалидное - игнор). */
+    setHighlight(color: string): void;
+    /** Снять всё инлайн-форматирование в выделении (или у каретки - отложенные марки). */
+    clearFormatting(): void;
+    /** Поставить/заменить ссылку на выделении (пусто - вставить URL текстом). */
+    setLink(href: string): void;
+    /** Снять ссылку с выделения. */
+    unsetLink(): void;
+    /** Текущее значение атрибута марки у каретки (для отражения в выпадашке). */
+    currentMarkAttr(name: keyof typeof schema.marks, attr: string): string | null;
+    /** Текущий блочный стиль: 'paragraph' | 'h1'..'h6' | 'blockquote'. */
+    currentBlock(): string;
+    /** Выравнивание текущих абзацев/заголовков. */
+    setAlign(align: string): void;
+    /** Активно ли выравнивание (для подсветки кнопок). */
+    isAlignActive(align: string): boolean;
+    /** Вставить изображение по src (URL, путь или data-URI). */
+    insertImage(src: string, alt?: string): void;
+    /** Вставить поле шаблона (merge field) - inline-чип для подстановки реквизита ЭДО. */
+    insertMergeField(key: string, label?: string): void;
+    /**
+     * HTML документа с полями шаблона, развёрнутыми в плейсхолдеры {{key}} -
+     * для ЭДО-систем, которые подставляют значения по {{...}}, а не по
+     * data-атрибутам. Без аргумента берёт текущий документ.
+     */
+    getMergeText(html?: string): string;
+    /** Вставить сноску с текстом (надстрочный номер; нумерация - авто). */
+    insertFootnote(text: string): void;
+    /** Тексты всех сносок документа по порядку (для секции сносок при печати/экспорте). */
+    getFootnotes(): string[];
+    /** Вставить блок оглавления (наполняется заголовками автоматически). */
+    insertTableOfContents(): void;
+    private commentSeq;
+    /** Добавить комментарий к выделению; возвращает id (или null, если нет выделения/текста). */
+    addComment(text: string, author?: string): string | null;
+    /** Все комментарии документа (по первому появлению), в порядке текста. */
+    getComments(): {
+        id: string;
+        text: string;
+        author: string | null;
+    }[];
+    /** Снять (разрешить) комментарий по id - убирает подсветку с текста. */
+    resolveComment(id: string): void;
+    /** Комментарии под кареткой/выделением (для всплывающего попапа). */
+    commentsAtSelection(): {
+        id: string;
+        text: string;
+        author: string | null;
+    }[];
+    /** Включить/выключить режим рецензирования (новый текст помечается как вставка). */
+    setTrackChanges(on: boolean): void;
+    isTrackingChanges(): boolean;
+    /** Включить/выключить страничный вид (границы страниц A4). */
+    setPagination(on: boolean): void;
+    isPaginated(): boolean;
+    /** Предложить удаление выделенного текста (зачёркивается, не удаляется). */
+    markDeletion(): void;
+    /** Диапазоны помеченных правок (текстовые узлы с insertion/deletion). */
+    private collectChangeRanges;
+    /** Кол-во предложенных правок (для UI). */
+    getChangeCount(): {
+        insertions: number;
+        deletions: number;
+    };
+    /** Принять все правки: вставки остаются (снимаем метку), удаления применяются. */
+    acceptAllChanges(): void;
+    /** Отклонить все правки: вставки удаляются, удаления отменяются (текст остаётся). */
+    rejectAllChanges(): void;
+    /** Вставить горизонтальную линию (<hr>) в позицию курсора. */
+    insertHorizontalRule(): void;
+    insertTable(rows?: number, cols?: number): void;
+    tableAddRow(): void;
+    tableAddColumn(): void;
+    tableDeleteRow(): void;
+    tableDeleteColumn(): void;
+    /** Объединить выделенные ячейки (нужно выделение нескольких ячеек). */
+    tableMergeCells(): void;
+    /**
+     * Разделить ячейку. С аргументами (cols, rows) - Word-режим: делит одиночную
+     * ячейку на сетку cols×rows. Без аргументов или для уже объединённой ячейки -
+     * встроенный splitCell (разъединяет обратно в 1×1).
+     */
+    tableSplitCell(cols?: number, rows?: number): void;
+    /** Можно ли разъединить текущую ячейку (она объединена: colspan/rowspan > 1). */
+    isMergedCell(): boolean;
+    /** Выделено ли 2+ ячейки (CellSelection охватывает несколько ячеек). */
+    hasMultiCellSelection(): boolean;
+    tableDelete(): void;
+    /** Найти таблицу, охватывающую текущее выделение. */
+    private findCurrentTable;
+    /** Применить колбэк к каждой выделенной ячейке (или текущей, если выделения ячеек нет). */
+    private forEachSelectedCell;
+    /** Свойства текущей ячейки - для предзаполнения диалога. */
+    getCellProps(): CellProps;
+    /** Применить свойства к выделенным ячейкам. */
+    setCellProps(props: CellProps): void;
+    /** Свойства текущей таблицы - для предзаполнения диалога. */
+    getTableProps(): TableProps;
+    /** Применить свойства к таблице (ширина/выравнивание) и, опционально, рамку ко всем ячейкам. */
+    setTableProps(props: TableProps): void;
+    /** В таблице ли сейчас курсор (для активации пунктов «Свойства…»). */
+    isInTable(): boolean;
+    undo(): void;
+    redo(): void;
+    /** Активна ли марка в текущем выделении (для подсветки кнопок). */
+    isMarkActive(name: keyof typeof schema.marks): boolean;
+    /** Является ли текущий блок узлом данного типа (для подсветки H1/H2/абзаца). */
+    isNodeType(name: string, attrs?: Record<string, unknown>): boolean;
+}
+export {};

package/dist/fallback.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Деградация для старых браузеров.
+ *
+ * Корпоративное требование — «не ломаться». На современных браузерах работает
+ * полноценный редактор (Web Component + Shadow DOM). Если браузер их не
+ * поддерживает (очень старые версии), вместо редактора показывается обычная
+ * textarea: ввод работает, формы получают значение, продукт не падает белым
+ * экраном.
+ */
+/** Поддерживает ли браузер полноценный редактор. */
+export declare function supportsModernEditor(): boolean;
+/** Заменяет все <koda-editor> на textarea (режим деградации). */
+export declare function installFallback(tag?: string): void;

package/dist/floatingToolbar.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Floating toolbar (Notion-UX): по выделению текста всплывает мини-панель
+ * форматирования над выделением (жирный/курсив/подчёркнутый/зачёркнутый).
+ */
+import { Plugin } from 'prosemirror-state';
+import type { Strings } from './i18n';
+export declare function floatingToolbarPlugin(strings: Strings): Plugin;

package/dist/group-icons.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Нейтральные обложки-контейнеры (нарисованы в том же line-стиле, что и пакет
+ * панели). Их нет среди команд, поэтому держим здесь — для группы это
+ * естественнее, чем «B»/«ссылка» в роли обложки.
+ */
+export declare const GROUP_EXTRA_ICONS: Record<string, string>;
+/** Популярные emoji для обложки группы (iconKind:'emoji', сам символ хранится). */
+export declare const GROUP_EMOJI: string[];
+/** Тип обложки кнопки-группы. */
+export type GroupIconKind = 'builtin' | 'emoji' | 'image';
+/**
+ * Ключи иконок для вкладки «Иконки» лого-пикера: сперва нейтральные обложки,
+ * затем все иконки панели (тот же пакет). Дедуп на случай пересечений.
+ */
+export declare function groupIconKeys(): string[];
+/** Отрисовать обложку группы в HTML (для кнопки/превью). */
+export declare function renderGroupIcon(kind: GroupIconKind, icon: string): string;

package/dist/i18n.d.ts

@@ -0,0 +1,214 @@
+/**
+ * Локализация интерфейса KodaEditor.
+ *
+ * Поддержка: английский (по умолчанию - глобальный рынок) и русский.
+ * Локаль задаётся атрибутом locale на <koda-editor> ("en" | "ru") или
+ * наследуется из lang. Переводятся только строки UI (подсказки кнопок,
+ * ARIA-метки, водяной знак) - содержимое документа не трогается.
+ *
+ * До 01.09.2026 английской локали не было вообще, а resolveLocale() без
+ * явного locale-атрибута откатывалась на 'ru' - для нового глобального
+ * бренда это было реальной проблемой (не косметика: любой англоязычный
+ * покупатель без явного locale получал русский тулбар). Добавлен 'en',
+ * дефолт сменён.
+ *
+ * Узбекский (uz-latn/uz-cyrl) убран в тот же день - был сделан под
+ * конкретного локального заказчика (meplab), тот больше не действует.
+ * Полная версия с узбекским сохранена в git-ветке
+ * archive/meplab-uzbek-locale, не удалена безвозвратно.
+ */
+export type Locale = 'en' | 'ru' | 'es' | 'de' | 'ja' | 'fr' | 'ko';
+export interface Strings {
+    bold: string;
+    italic: string;
+    underline: string;
+    strike: string;
+    h1: string;
+    h2: string;
+    h3: string;
+    paragraph: string;
+    font: string;
+    textSize: string;
+    bulletList: string;
+    orderedList: string;
+    quote: string;
+    codeBlock: string;
+    undo: string;
+    redo: string;
+    pastePlain: string;
+    openDocx: string;
+    exportPdf: string;
+    importFile: string;
+    exportMarkdown: string;
+    export: string;
+    exportTitle: string;
+    importTitle: string;
+    importFromFile: string;
+    importFromUrl: string;
+    importUrlPlaceholder: string;
+    importUrlInvalid: string;
+    importUrlFailed: string;
+    importing: string;
+    importPdfImages: string;
+    importDocx: string;
+    importPdf: string;
+    importExcel: string;
+    importText: string;
+    exportWord: string;
+    exportHtml: string;
+    exportText: string;
+    exportCsv: string;
+    insertTable: string;
+    tableRows: string;
+    tableCols: string;
+    tableAddRow: string;
+    tableAddColumn: string;
+    tableDeleteRow: string;
+    tableDeleteColumn: string;
+    tableMergeCells: string;
+    tableSplitCell: string;
+    mergeCellsHint: string;
+    splitCellTitle: string;
+    splitCellHint: string;
+    commentHint: string;
+    formatPainterHint: string;
+    tableDelete: string;
+    image: string;
+    link: string;
+    textColor: string;
+    highlight: string;
+    clearFormat: string;
+    superscript: string;
+    subscript: string;
+    horizontalRule: string;
+    find: string;
+    replace: string;
+    replaceAll: string;
+    searchNext: string;
+    searchPrev: string;
+    searchClose: string;
+    fullscreen: string;
+    imageUrl: string;
+    imageInsert: string;
+    imageUpload: string;
+    cancel: string;
+    customizeToolbar: string;
+    customizeAdd: string;
+    customizeSeparator: string;
+    customizeReset: string;
+    customizeDone: string;
+    customizeHint: string;
+    customizeAvailable: string;
+    customizeRemove: string;
+    customizeGroup: string;
+    customizeGroupCreate: string;
+    customizeUngroup: string;
+    customizeGroupName: string;
+    customizeGroupIcon: string;
+    customizeIconBuiltin: string;
+    customizeIconEmoji: string;
+    customizeIconUpload: string;
+    alignLeft: string;
+    alignCenter: string;
+    alignRight: string;
+    editorLabel: string;
+    toolbarLabel: string;
+    toolbarHint: string;
+    trialExportNotice: string;
+    importFailed: string;
+    imageTooBig: string;
+    imageWrongType: string;
+    imageUploadFailed: string;
+    watermark: string;
+    /** Короткий текст для замощения канвы (диагональный водяной знак демо). */
+    watermarkShort: string;
+    menubarLabel: string;
+    menuFile: string;
+    menuEdit: string;
+    menuInsert: string;
+    menuFormat: string;
+    menuTable: string;
+    menuView: string;
+    menuImport: string;
+    menuExport: string;
+    menuRow: string;
+    menuColumn: string;
+    menuCell: string;
+    menuStyle: string;
+    menuAlign: string;
+    selectAll: string;
+    cut: string;
+    copy: string;
+    print: string;
+    tableProps: string;
+    cellProps: string;
+    propWidth: string;
+    propAlign: string;
+    propBorder: string;
+    propBorderColor: string;
+    propBackground: string;
+    propTextAlign: string;
+    propVerticalAlign: string;
+    valNone: string;
+    valTop: string;
+    valMiddle: string;
+    valBottom: string;
+    apply: string;
+    mergeField: string;
+    mergeFieldTitle: string;
+    mfDate: string;
+    mfDocNumber: string;
+    mfFullName: string;
+    mfOrg: string;
+    mfInn: string;
+    mfPosition: string;
+    mfAddress: string;
+    mfSignature: string;
+    footnote: string;
+    footnotePrompt: string;
+    toc: string;
+    tocTitle: string;
+    styles: string;
+    styleNormal: string;
+    styleCompact: string;
+    styleSpacious: string;
+    h4: string;
+    comment: string;
+    commentPrompt: string;
+    commentResolve: string;
+    commentSelectText: string;
+    trackChanges: string;
+    suggestDelete: string;
+    acceptAll: string;
+    rejectAll: string;
+    versionHistory: string;
+    versionSave: string;
+    versionRestore: string;
+    versionNone: string;
+    versionNamePh: string;
+    versionUnnamed: string;
+    formatPainter: string;
+    a11yCheck: string;
+    a11yNoIssues: string;
+    a11yImgNoAlt: string;
+    a11yHeadingSkip: string;
+    a11yEmptyLink: string;
+    a11yTableNoHeader: string;
+    spellcheck: string;
+    pagination: string;
+}
+/**
+ * Нормализует произвольную строку локали к поддерживаемой.
+ * По умолчанию (locale-атрибут не задан или не распознан) - 'en': продукт
+ * продаётся глобально под брендом KodaEditor, английский - базовый язык
+ * рынка. Явный 'ru' по-прежнему распознаётся и работает как раньше.
+ *
+ * Узбекский (uz-latn/uz-cyrl) убран из публичного пакета 01.09.2026 -
+ * был сделан под конкретного локального заказчика (meplab), тот больше
+ * не действует; полная версия с узбекским сохранена в git-ветке
+ * archive/meplab-uzbek-locale, не удалена безвозвратно. Старое значение
+ * locale="uz-latn"/"uz-cyrl" теперь просто тихо откатывается на 'en' -
+ * не ошибка, деградация в духе остального проекта (не блокировка).
+ */
+export declare function resolveLocale(input?: string | null): Locale;
+export declare function getStrings(locale: Locale): Strings;

package/dist/icons.d.ts

@@ -0,0 +1 @@
+export declare const TOOLBAR_ICONS: Record<string, string>;

package/dist/image-view.d.ts

@@ -0,0 +1,27 @@
+/**
+ * NodeView картинки с ручкой ресайза (правый-нижний угол). Тянем мышью —
+ * меняется ширина; по отпусканию ширина пишется в атрибут width узла (т.е.
+ * сохраняется в HTML как style="width:NNpx"). Ручка видна при наведении или
+ * когда картинка выделена.
+ */
+import type { Node as PMNode } from 'prosemirror-model';
+import type { EditorView, NodeView } from 'prosemirror-view';
+export declare class ImageNodeView implements NodeView {
+    dom: HTMLElement;
+    private img;
+    private node;
+    private view;
+    private getPos;
+    constructor(node: PMNode, view: EditorView, getPos: () => number | undefined);
+    /**
+     * Режим обрезки: накладывает слой поверх картинки, пользователь тянет рамку
+     * выделения (pointer = мышь/touch), затем «Применить» вырезает область через
+     * canvas в новый data-URL (client-side, на сервер не уходит).
+     */
+    private enterCrop;
+    /** Вырезает область (в координатах отображения) через canvas -> новый src. */
+    private applyCrop;
+    private startResize;
+    update(node: PMNode): boolean;
+    ignoreMutation(): boolean;
+}