@kodaeditor/core 1.0.1 → 1.0.3

package/dist/editor.d.ts

@@ -3,26 +3,26 @@ import { type ImportFormat } from './import-formats';
 import { type DocxImportResult } from './docx-import';
 import { type Strings } from './i18n';
 export interface EditorOptions {
-    /** Контейнер, в который монтируется редактор. */
+    /** Element the editor mounts into. */
     element: HTMLElement;
-    /** Начальный HTML-контент. */
+    /** Initial HTML content. */
     content?: string;
-    /** Подсказка, когда документ пуст. */
+    /** Placeholder shown while the document is empty. */
     placeholder?: string;
-    /** Доступное имя для скринридеров (ARIA). */
+    /** Accessible name for screen readers (ARIA). */
     ariaLabel?: string;
-    /** Локализованные строки UI (для slash-меню и floating-тулбара). */
+    /** Localised interface strings, used by the slash menu and floating toolbar. */
     strings?: Strings;
-    /** Колбэк при каждом изменении документа. */
+    /** Called on every change to the document. */
     onChange?: (html: string) => void;
-    /** Колбэки для плавающей панели таблицы (открыть диалог вместо «голой» команды). */
+    /** Hooks for the floating table toolbar, so a host can open its own dialog. */
     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>>;
-/** Свойства ячейки таблицы (диалог «Свойства ячейки»). */
+/** Table cell properties, as edited in the cell properties dialog. */
 export interface CellProps {
     background?: string;
     textAlign?: string;
@@ -30,7 +30,7 @@ export interface CellProps {
     borderWidth?: number;
     borderColor?: string;
 }
-/** Свойства таблицы (диалог «Свойства таблицы»). */
+/** Table properties, as edited in the table properties dialog. */
 export interface TableProps {
     width?: string;
     align?: string;
@@ -40,26 +40,8 @@ export interface TableProps {
 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;
@@ -70,151 +52,129 @@ export declare class Editor {
     private readonly trackState;
     private readonly paginationState;
     constructor(opts: EditorOptions);
-    /** Текущий документ как чистый HTML. */
+    /** The current document as plain HTML. */
     getHTML(): string;
     /**
-     * Заменить содержимое из HTML-строки.
+     * Replaces the content with the given HTML.
      *
-     * Через транзакцию, а не пересозданием state, чтобы сохранить историю
-     * undo/redo - иначе Ctrl+Z после программной установки молча не работает.
+     * Applied as a transaction rather than by recreating the state, so the
+     * undo history survives - otherwise Ctrl+Z after a programmatic write
+     * would silently do nothing.
      */
     setHTML(html: string): void;
     /**
-     * Импорт файла .docx прямо в редактор. Возвращает предупреждения движка
-     * (неподдержанные стили и т.п.) - UI может их показать или проигнорировать.
+     * Imports a .docx straight into the editor and returns the converter's
+     * warnings, such as unsupported styles. Show them or ignore them.
      */
     importDocx(source: File | ArrayBuffer): Promise<DocxImportResult>;
-    /** Вставляет HTML в позицию курсора (НЕ заменяя весь документ). */
+    /** Inserts HTML at the cursor, leaving the rest of the document alone. */
     insertHtmlAtCursor(html: string): void;
     /**
-     * Единый импорт файла: детект типа -> нужный обработчик. .docx ОТКРЫВАЕТ
-     * (заменяет документ); картинка/CSV/txt ВСТАВЛЯЮТСЯ в курсор. Бросает для
-     * неподдержанного типа. Точка подключения для кнопки/drag-drop/paste.
+     * One entry point for any file: the type is detected and routed. A .docx
+     * OPENS, replacing the document; an image, CSV or text file is INSERTED at
+     * the cursor. Throws on an unsupported type. This is what a toolbar button,
+     * a drag-and-drop handler or a paste handler should call.
      */
     importFile(file: File): Promise<ImportFormat>;
-    /** Импорт PDF как картинок: каждая страница -> PNG, вставляется в документ. */
+    /** Imports a PDF as images: each page becomes a PNG inserted into the document. */
     importPdfAsImages(file: File): Promise<void>;
     /**
-     * Импорт PDF «как есть»: встраивает сам файл (data-URL) блоком-iframe.
-     * Полностью client-side, на сервер не уходит. Просмотр - встроенным
-     * PDF-вьюером браузера; редактировать содержимое нельзя (atom-узел).
+     * Embeds a PDF as it is, as an iframe holding the file itself. Entirely
+     * client-side - nothing is uploaded. The browser's own PDF viewer renders
+     * it; its contents cannot be edited.
      */
     importPdfAsEmbed(file: File): Promise<void>;
-    /** Хост задаёт спрашивалку режима PDF (текст/картинки/встроить). */
+    /** Lets the host decide how a PDF is inserted: as text, as images or embedded. */
     setPdfModeResolver(fn: () => Promise<'text' | 'images' | 'embed' | null>): void;
     /**
-     * Импорт PDF с выбором режима, если хост задал резолвер (drag-drop, буфер).
-     * Без резолвера - поведение по умолчанию (текст), как раньше.
+     * Imports a PDF, asking the host for the mode when it provided a resolver
+     * (used by drag-and-drop and paste). Without one, text is used.
      */
     importPdfWithChoice(file: File): Promise<void>;
     /**
-     * Вставка «богатого» буфера, полученного из companion-расширения в обход
-     * браузерной песочницы: на вход полный сырой HTML + RTF (с встроенными
-     * картинками). Прогоняем тот же премиум-пайплайн и вставляем в курсор.
+     * Pastes rich clipboard content captured by the companion extension, which
+     * can read what the page sandbox cannot: the full raw HTML plus RTF with
+     * embedded images. It goes through the same cleanup pipeline as a normal
+     * paste and is inserted at the cursor.
      */
     pasteRich(html: string, rtf?: string): void;
     /**
-     * Сменить подсказку пустого документа на лету. Нужна хосту: атрибут
-     * placeholder заявлен в observedAttributes веб-компонента, и до этого
-     * изменение атрибута молча ничего не делало - подсказка была вшита в
-     * плагин при создании редактора.
+     * Changes the empty-document placeholder at runtime. The web component
+     * needs this: `placeholder` is a watched attribute, and changing it has to
+     * take effect rather than silently do nothing.
      */
     setPlaceholder(text: string): void;
-    /** Сменить доступное имя области ввода (атрибут aria-label у хоста). */
+    /** Changes the accessible name of the editing area (the host's aria-label). */
     setAriaLabel(label: string): void;
-    /** Документ как JSON (для хранения в БД без потери структуры). */
+    /** The document as JSON, for storing in a database without losing structure. */
     getJSON(): Record<string, unknown>;
-    /** Пустой ли документ (нет текстового содержимого). */
+    /** Whether the document has no text content. */
     isEmpty(): boolean;
-    /** Включает/выключает премиум smart-paste (по лицензии). */
+    /** Turns the licensed smart-paste pipeline on or off. */
     /**
-     * Отметить лицензию подтверждённой. Ставит хост после проверки (valid или
-     * grace). До этого выгрузки несут ознакомительную пометку.
+     * Marks the license as confirmed. The host sets this after validation
+     * succeeds, or while the grace period is in effect. Until then every export
+     * carries the trial mode line.
      */
     setLicensed(on: boolean): void;
-    /**
-     * Ознакомительная пометка в ВЫГРУЗКАХ.
-     *
-     * Зачем она нужна отдельно от знака на экране: знак видит тот, кто работает
-     * в редакторе, а платит не он. Пометка же уходит туда, где продукт отдаёт
-     * ценность наружу - в договор, счёт, отчёт, которые компания отправляет
-     * своему клиенту. Отправить такой документ со строкой об ознакомительном
-     * режиме нельзя, и это делает работу без лицензии невозможной по деловым
-     * причинам, а не по техническим.
-     *
-     * Что при этом НЕ делается: ничего не отключается, экспорт работает
-     * полностью, файл открывается и читается. Деградация, а не блокировка.
-     *
-     * Честно: снять это со стороны страницы по-прежнему можно - код исполняется
-     * у клиента. Барьер остаётся юридическим, пометка лишь делает нарушение
-     * видимым тому, кому документ придёт.
-     */
     private trialNotice;
-    /** Пометка для текстовых форматов (txt, md, csv): отдельной строкой в конце. */
     private appendTrialText;
-    /** Пометка для HTML-подобных форматов: абзацем в конце документа. */
     private appendTrialHtml;
     setPremiumPaste(on: boolean): void;
-    /** Следующая вставка - только текст (для кнопки тулбара). */
+    /** Makes the next paste plain text only, for the toolbar button. */
     armPlainPaste(): void;
     /**
-     * Передаёт редактору промис идущей проверки лицензии. Вызывает web-компонент
-     * сразу после монтирования; при использовании ядра напрямую промиса нет и
-     * поведение прежнее.
+     * Hands the editor the promise of the validation request in flight. The web
+     * component does this right after mounting; when the core is used directly
+     * there is no promise and behaviour is unchanged.
      */
     setLicenseCheck(p: Promise<unknown>): void;
-    /**
-     * Ждёт решения по лицензии перед выгрузкой. Потолок 7 секунд - чуть больше
-     * сетевого таймаута самой проверки (6 с), то есть в норме мы упираемся в её
-     * собственный таймаут, а не в этот. Потолок здесь на случай проверки, которая
-     * по какой-то причине не завершилась вовсе: выгрузка не должна зависнуть.
-     */
     private licenseSettled;
     /**
-     * Экспорт документа в PDF средствами браузера (печать). Client-side:
-     * содержимое не уходит на сервер (важно для ЭДО), рендер браузерный = WYSIWYG.
+     * Exports to PDF through the browser print dialog. Client-side: the content
+     * never leaves the machine, and what you see is what gets printed.
      */
     exportPdf(): Promise<void>;
-    /** Экспорт документа в Markdown (скачивание .md). Client-side. */
+    /** Exports to Markdown and downloads the .md file. Runs in the browser. */
     exportMarkdown(): Promise<void>;
-    /** Экспорт в самодостаточный HTML-файл (.html). Client-side. */
+    /** Exports to a self-contained .html file. Runs in the browser. */
     exportHtml(): Promise<void>;
-    /** Экспорт в простой текст (.txt). Client-side. */
+    /** Exports to plain text (.txt). Runs in the browser. */
     exportText(): Promise<void>;
-    /** Экспорт таблиц документа в CSV (.csv). Client-side. */
+    /** Exports the document's tables to CSV. Runs in the browser. */
     exportCsv(): Promise<void>;
-    /** Экспорт в Word (.doc - Word-совместимый HTML). Client-side, без библиотек. */
+    /** Exports to Word (.doc, Word-compatible HTML). Runs in the browser, no libraries. */
     exportWord(): Promise<void>;
     focus(): void;
-    /** Текущее состояние поиска для UI: всего совпадений и номер активного (1-based). */
+    /** Current search state: total matches and the index of the active one, from 1. */
     searchInfo(): {
         count: number;
         current: number;
     };
     private scrollToActiveMatch;
-    /** Задать поисковый запрос (подсветит все совпадения, перейдёт к первому). */
+    /** Sets the search query, highlights every match and jumps to the first. */
     setSearchQuery(query: string): {
         count: number;
         current: number;
     };
-    /** К следующему совпадению (с циклом). */
+    /** Moves to the next match, wrapping around. */
     searchNext(): {
         count: number;
         current: number;
     };
-    /** К предыдущему совпадению (с циклом). */
+    /** Moves to the previous match, wrapping around. */
     searchPrev(): {
         count: number;
         current: number;
     };
-    /** Заменить активное совпадение. */
+    /** Replaces the active match. */
     replaceCurrentMatch(replacement: string): {
         count: number;
         current: number;
     };
-    /** Заменить все совпадения. Возвращает число замен. */
+    /** Replaces every match and returns how many were replaced. */
     replaceAll(replacement: string): number;
-    /** Сбросить поиск (убрать подсветку). */
+    /** Clears the search and removes the highlighting. */
     clearSearch(): void;
     destroy(): void;
     private run;
@@ -222,8 +182,8 @@ export declare class Editor {
     setHeading(level: number): void;
     setParagraph(): void;
     /**
-     * Применить стиль из галереи (система стилей): тип блока + интервалы одним
-     * действием. blockquote оборачивает; heading/paragraph меняют тип с атрибутами.
+     * Applies a style from the gallery: block type and spacing in one action.
+     * A blockquote wraps the selection; headings and paragraphs change type.
      */
     applyBlockStyle(style: {
         type: 'paragraph' | 'heading' | 'blockquote';
@@ -233,140 +193,130 @@ export declare class Editor {
     toggleBulletList(): void;
     toggleOrderedList(): void;
     wrapBlockquote(): void;
-    /** Выделить весь документ (для пункта меню «Выделить всё»). */
+    /** Selects the whole document. */
     selectAll(): void;
-    /** Пустое ли выделение (каретка без диапазона). */
+    /** Whether the selection is empty, i.e. a caret with no range. */
     isSelectionEmpty(): boolean;
     private copiedMarks;
-    /** Запомнить форматирование текущей позиции (для «кисти формата»). */
+    /** Copies the formatting at the cursor, for the format painter. */
     copyFormat(): void;
     hasCopiedFormat(): boolean;
-    /** Применить запомненное форматирование к выделению (заменяет инлайн-формат). */
+    /** Applies the copied formatting to the selection, replacing inline formatting. */
     applyCopiedFormat(): void;
     setCodeBlock(): void;
-    /** Применить марку с атрибутами к выделению (или к будущему вводу, если пусто). */
     private applyAttrMark;
     private clearAttrMark;
-    /**
-     * Безопасно ли CSS-значение для подстановки в одно объявление style:
-     * запрещаем выход из объявления (`;{}`), HTML-брейкаут (`<>`) и опасные
-     * CSS-функции (url(), expression(), @import, комментарии). Защита от
-     * хранимой CSS-инъекции, если в сеттер передадут недоверенную строку.
-     */
     private safeCss;
-    /** Размер шрифта, напр. "16px" (пусто - сбросить; невалидное - игнор). */
+    /** Font size, e.g. "16px". Empty clears it; an invalid value is ignored. */
     setFontSize(size: string): void;
-    /** Семейство шрифта (пусто - сбросить; невалидное - игнор). */
+    /** Font family. Empty clears it; an invalid value is ignored. */
     setFontFamily(family: string): void;
-    /** Цвет текста (пусто - сбросить; невалидное - игнор). */
+    /** Text colour. Empty clears it; an invalid value is ignored. */
     setTextColor(color: string): void;
-    /** Выделение фоном (пусто - снять; невалидное - игнор). */
+    /** Highlight colour. Empty removes it; an invalid value is ignored. */
     setHighlight(color: string): void;
-    /** Снять всё инлайн-форматирование в выделении (или у каретки - отложенные марки). */
+    /** Clears all inline formatting in the selection, or the pending marks at the caret. */
     clearFormatting(): void;
-    /** Поставить/заменить ссылку на выделении (пусто - вставить URL текстом). */
+    /** Sets or replaces a link on the selection; with no selection the URL is inserted as text. */
     setLink(href: string): void;
-    /** Снять ссылку с выделения. */
+    /** Removes the link from the selection. */
     unsetLink(): void;
-    /** Текущее значение атрибута марки у каретки (для отражения в выпадашке). */
+    /** The mark attribute currently in effect at the caret, for reflecting in a dropdown. */
     currentMarkAttr(name: keyof typeof schema.marks, attr: string): string | null;
-    /** Текущий блочный стиль: 'paragraph' | 'h1'..'h6' | 'blockquote'. */
+    /** The current block style: 'paragraph', 'h1' to 'h6', or 'blockquote'. */
     currentBlock(): string;
-    /** Выравнивание текущих абзацев/заголовков. */
+    /** Alignment of the current paragraphs or headings. */
     setAlign(align: string): void;
-    /** Активно ли выравнивание (для подсветки кнопок). */
+    /** Whether that alignment is active, for highlighting toolbar buttons. */
     isAlignActive(align: string): boolean;
-    /** Вставить изображение по src (URL, путь или data-URI). */
+    /** Inserts an image by src: a URL, a path or a data URI. */
     insertImage(src: string, alt?: string): void;
-    /** Вставить поле шаблона (merge field) - inline-чип для подстановки реквизита ЭДО. */
+    /** Inserts a merge field: an inline chip replaced by a real value later. */
     insertMergeField(key: string, label?: string): void;
     /**
-     * HTML документа с полями шаблона, развёрнутыми в плейсхолдеры {{key}} -
-     * для ЭДО-систем, которые подставляют значения по {{...}}, а не по
-     * data-атрибутам. Без аргумента берёт текущий документ.
+     * The document's HTML with merge fields expanded to {{key}} placeholders,
+     * for systems that substitute values by {{...}} rather than by data
+     * attributes. With no argument it uses the current document.
      */
     getMergeText(html?: string): string;
-    /** Вставить сноску с текстом (надстрочный номер; нумерация - авто). */
+    /** Inserts a footnote with the given text; the superscript number is assigned automatically. */
     insertFootnote(text: string): void;
-    /** Тексты всех сносок документа по порядку (для секции сносок при печати/экспорте). */
+    /** The text of every footnote, in document order, for the notes section when printing or exporting. */
     getFootnotes(): string[];
-    /** Вставить блок оглавления (наполняется заголовками автоматически). */
+    /** Inserts a table of contents, filled from the document's headings. */
     insertTableOfContents(): void;
     private commentSeq;
-    /** Добавить комментарий к выделению; возвращает id (или null, если нет выделения/текста). */
+    /** Adds a comment on the selection and returns its id, or null if there is no selected text. */
     addComment(text: string, author?: string): string | null;
-    /** Все комментарии документа (по первому появлению), в порядке текста. */
+    /** Every comment in the document, in the order the text appears. */
     getComments(): {
         id: string;
         text: string;
         author: string | null;
     }[];
-    /** Снять (разрешить) комментарий по id - убирает подсветку с текста. */
+    /** Resolves a comment by id, removing its highlight from the text. */
     resolveComment(id: string): void;
-    /** Комментарии под кареткой/выделением (для всплывающего попапа). */
+    /** Comments at the caret or selection, for a popup. */
     commentsAtSelection(): {
         id: string;
         text: string;
         author: string | null;
     }[];
-    /** Включить/выключить режим рецензирования (новый текст помечается как вставка). */
+    /** Turns track changes on or off; new text is then marked as an insertion. */
     setTrackChanges(on: boolean): void;
     isTrackingChanges(): boolean;
-    /** Включить/выключить страничный вид (границы страниц A4). */
+    /** Turns the page view on or off, showing A4 page boundaries. */
     setPagination(on: boolean): void;
     isPaginated(): boolean;
-    /** Предложить удаление выделенного текста (зачёркивается, не удаляется). */
+    /** Suggests deleting the selected text: it is struck through, not removed. */
     markDeletion(): void;
-    /** Диапазоны помеченных правок (текстовые узлы с insertion/deletion). */
     private collectChangeRanges;
-    /** Кол-во предложенных правок (для UI). */
+    /** How many suggested changes the document holds. */
     getChangeCount(): {
         insertions: number;
         deletions: number;
     };
-    /** Принять все правки: вставки остаются (снимаем метку), удаления применяются. */
+    /** Accepts every change: insertions lose their marks, deletions are applied. */
     acceptAllChanges(): void;
-    /** Отклонить все правки: вставки удаляются, удаления отменяются (текст остаётся). */
+    /** Rejects every change: insertions are removed, deletions are undone. */
     rejectAllChanges(): void;
-    /** Вставить горизонтальную линию (<hr>) в позицию курсора. */
+    /** Inserts a horizontal rule at the cursor. */
     insertHorizontalRule(): void;
     insertTable(rows?: number, cols?: number): void;
     tableAddRow(): void;
     tableAddColumn(): void;
     tableDeleteRow(): void;
     tableDeleteColumn(): void;
-    /** Объединить выделенные ячейки (нужно выделение нескольких ячеек). */
+    /** Merges the selected cells; more than one cell must be selected. */
     tableMergeCells(): void;
     /**
-     * Разделить ячейку. С аргументами (cols, rows) - Word-режим: делит одиночную
-     * ячейку на сетку cols×rows. Без аргументов или для уже объединённой ячейки -
-     * встроенный splitCell (разъединяет обратно в 1×1).
+     * Splits a cell. With (cols, rows) it behaves like Word and splits a single
+     * cell into that grid. Without arguments, or on an already merged cell, it
+     * splits it back into single cells.
      */
     tableSplitCell(cols?: number, rows?: number): void;
-    /** Можно ли разъединить текущую ячейку (она объединена: colspan/rowspan > 1). */
+    /** Whether the current cell can be split, i.e. it spans more than one column or row. */
     isMergedCell(): boolean;
-    /** Выделено ли 2+ ячейки (CellSelection охватывает несколько ячеек). */
+    /** Whether two or more cells are selected. */
     hasMultiCellSelection(): boolean;
     tableDelete(): void;
-    /** Найти таблицу, охватывающую текущее выделение. */
     private findCurrentTable;
-    /** Применить колбэк к каждой выделенной ячейке (или текущей, если выделения ячеек нет). */
     private forEachSelectedCell;
-    /** Свойства текущей ячейки - для предзаполнения диалога. */
+    /** Properties of the current cell, for pre-filling a dialog. */
     getCellProps(): CellProps;
-    /** Применить свойства к выделенным ячейкам. */
+    /** Applies properties to the selected cells. */
     setCellProps(props: CellProps): void;
-    /** Свойства текущей таблицы - для предзаполнения диалога. */
+    /** Properties of the current table, for pre-filling a dialog. */
     getTableProps(): TableProps;
-    /** Применить свойства к таблице (ширина/выравнивание) и, опционально, рамку ко всем ячейкам. */
+    /** Applies width and alignment to the table, and optionally a border to every cell. */
     setTableProps(props: TableProps): void;
-    /** В таблице ли сейчас курсор (для активации пунктов «Свойства…»). */
+    /** Whether the cursor is inside a table, for enabling the properties menu items. */
     isInTable(): boolean;
     undo(): void;
     redo(): void;
-    /** Активна ли марка в текущем выделении (для подсветки кнопок). */
+    /** Whether a mark is active in the current selection, for highlighting buttons. */
     isMarkActive(name: keyof typeof schema.marks): boolean;
-    /** Является ли текущий блок узлом данного типа (для подсветки H1/H2/абзаца). */
+    /** Whether the current block is of the given type, for highlighting H1, H2 or paragraph. */
     isNodeType(name: string, attrs?: Record<string, unknown>): boolean;
 }
 export {};

package/dist/fallback.d.ts

@@ -1,13 +1,12 @@
 /**
- * Деградация для старых браузеров.
+ * Graceful degradation for old browsers.
  *
- * Корпоративное требование — «не ломаться». На современных браузерах работает
- * полноценный редактор (Web Component + Shadow DOM). Если браузер их не
- * поддерживает (очень старые версии), вместо редактора показывается обычная
- * textarea: ввод работает, формы получают значение, продукт не падает белым
- * экраном.
+ * Modern browsers get the full editor, built on a web component and shadow
+ * DOM. Where those are not supported, a plain textarea is shown instead:
+ * typing works, forms still receive the value, and nothing greets the user
+ * with a blank screen.
  */
-/** Поддерживает ли браузер полноценный редактор. */
+/** Whether this browser can run the full editor. */
 export declare function supportsModernEditor(): boolean;
-/** Заменяет все <koda-editor> на textarea (режим деградации). */
+/** Replaces every <koda-editor> with a textarea. */
 export declare function installFallback(tag?: string): void;

package/dist/i18n.d.ts

@@ -1,21 +1,15 @@
 /**
- * Локализация интерфейса KodaEditor.
+ * Interface localisation for KodaEditor.
  *
- * Поддержка: английский (по умолчанию - глобальный рынок) и русский.
- * Локаль задаётся атрибутом locale на <koda-editor> ("en" | "ru") или
- * наследуется из lang. Переводятся только строки UI (подсказки кнопок,
- * ARIA-метки, водяной знак) - содержимое документа не трогается.
+ * Seven locales ship with the editor. Set one with the locale attribute on
+ * <koda-editor>, or let it be inherited from lang. Only interface strings are
+ * translated - button tooltips, ARIA labels, the watermark. The content of
+ * the document is never touched.
  *
- * До 01.09.2026 английской локали не было вообще, а resolveLocale() без
- * явного locale-атрибута откатывалась на 'ru' - для нового глобального
- * бренда это было реальной проблемой (не косметика: любой англоязычный
- * покупатель без явного locale получал русский тулбар). Добавлен 'en',
- * дефолт сменён.
- *
- * Узбекский (uz-latn/uz-cyrl) убран в тот же день - был сделан под
- * конкретного локального заказчика (meplab), тот больше не действует.
- * Полная версия с узбекским сохранена в git-ветке
- * archive/meplab-uzbek-locale, не удалена безвозвратно.
+ * English is the default when nothing is specified. If your users need a
+ * language that is not here, supply your own dictionary through the strings
+ * property or the strings-ref attribute: overrides are applied on top of the
+ * chosen locale, so a partial translation is fine.
  */
 export type Locale = 'en' | 'ru' | 'es' | 'de' | 'ja' | 'fr' | 'ko';
 export interface Strings {
@@ -120,7 +114,7 @@ export interface Strings {
     imageWrongType: string;
     imageUploadFailed: string;
     watermark: string;
-    /** Короткий текст для замощения канвы (диагональный водяной знак демо). */
+    /** Short text tiled across the canvas as the diagonal watermark. */
     watermarkShort: string;
     menubarLabel: string;
     menuFile: string;
@@ -198,17 +192,12 @@ export interface Strings {
     pagination: string;
 }
 /**
- * Нормализует произвольную строку локали к поддерживаемой.
- * По умолчанию (locale-атрибут не задан или не распознан) - 'en': продукт
- * продаётся глобально под брендом KodaEditor, английский - базовый язык
- * рынка. Явный 'ru' по-прежнему распознаётся и работает как раньше.
+ * Normalises an arbitrary locale string to a supported one.
  *
- * Узбекский (uz-latn/uz-cyrl) убран из публичного пакета 01.09.2026 -
- * был сделан под конкретного локального заказчика (meplab), тот больше
- * не действует; полная версия с узбекским сохранена в git-ветке
- * archive/meplab-uzbek-locale, не удалена безвозвратно. Старое значение
- * locale="uz-latn"/"uz-cyrl" теперь просто тихо откатывается на 'en' -
- * не ошибка, деградация в духе остального проекта (не блокировка).
+ * Anything unrecognised, or nothing at all, resolves to 'en'. A regional tag
+ * is matched by its language part, so "de-AT" and "fr-CA" work as expected.
+ * An unsupported language is never an error: the editor falls back to English
+ * rather than refusing to start.
  */
 export declare function resolveLocale(input?: string | null): Locale;
 export declare function getStrings(locale: Locale): Strings;