@kodaeditor/core 1.0.0 → 1.0.2

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;

package/dist/import-formats.d.ts

@@ -1,23 +1,25 @@
 /**
- * Импорт «лёгких» форматов БЕЗ зависимостей и БЕЗ сервера (client-side):
- *   - CSV/TSV  -> HTML-таблица (первая строка = шапка)
- *   - txt      -> абзацы
- * Тяжёлые форматы (pdf, xlsx) и markdown подключаются отдельными модулями.
+ * Import of the lightweight formats, with no dependencies and no server:
+ *   - CSV and TSV become an HTML table, the first row its header
+ *   - plain text becomes paragraphs
+ * The heavier formats (PDF, xlsx) and Markdown live in their own modules.
  *
- * Единая точка детекта формата по имени/MIME — detectImportFormat(). Сами
- * функции принимают строку и возвращают HTML; вставку делает Editor.importFile.
+ * detectImportFormat() is the single place where the format is decided from
+ * the file name and MIME type. The functions here take a string and return
+ * HTML; inserting it is Editor.importFile's job.
  */
 export type ImportFormat = 'docx' | 'pdf' | 'xlsx' | 'csv' | 'txt' | 'md' | 'html' | 'doc' | 'image' | 'unknown';
-/** Определяет формат файла по имени и MIME-типу. */
+/** Determines the file format from its name and MIME type. */
 export declare function detectImportFormat(name: string, mime?: string): ImportFormat;
 /**
- * Разбирает CSV (RFC-4180-подобно): кавычки экранируют разделитель и перевод
- * строки, "" внутри кавычек = литеральная кавычка. Возвращает матрицу строк.
+ * Parses CSV along the lines of RFC 4180: quotes escape the separator and
+ * line breaks, and "" inside quotes is a literal quote. Returns a matrix of
+ * strings.
  */
 export declare function parseCsv(text: string, delimiter?: string): string[][];
-/** Матрица значений -> HTML-таблица (первая строка = заголовок th). */
+/** Turns a matrix of values into an HTML table, the first row its header. */
 export declare function rowsToTableHtml(rows: unknown[][]): string;
-/** Диапазон слияния ячеек (0-based, инклюзивно), формат SheetJS `!merges`. */
+/** A merged cell range, zero-based and inclusive, in the SheetJS `!merges` shape. */
 export interface CellMergeRange {
     s: {
         r: number;
@@ -29,13 +31,13 @@ export interface CellMergeRange {
     };
 }
 /**
- * Матрица значений + список слияний -> HTML-таблица с colspan/rowspan.
- * Схема (prosemirror-tables) уже умеет парсить colspan/rowspan из HTML —
- * тот же путь, которым уже работают слитые ячейки docx-таблиц, — не хватало
- * только генерации этих атрибутов на стороне xlsx-импорта (см. xlsx-import.ts).
+ * Turns a matrix of values plus a list of merges into an HTML table with
+ * colspan and rowspan. The schema already parses those attributes, which is
+ * how merged cells from Word tables survive; this generates them for
+ * spreadsheet import.
  */
 export declare function rowsToTableHtmlWithMerges(rows: unknown[][], merges: CellMergeRange[]): string;
-/** CSV/TSV -> HTML-таблица (первая строка = заголовок). */
+/** Turns CSV or TSV into an HTML table, the first row its header. */
 export declare function csvToTableHtml(text: string, delimiter?: string): string;
-/** Простой текст -> абзацы (пустая строка разделяет абзацы, перенос -> <br>). */
+/** Turns plain text into paragraphs: a blank line separates them, a single break becomes <br>. */
 export declare function plainTextToHtml(text: string): string;

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 /**
- * Точка входа @kodaeditor/core.
+ * Entry point of @kodaeditor/core.
  *
- * Экспортирует фреймворк-независимое ядро + регистрацию Web Component.
- * При импорте сразу определяет <koda-editor>, чтобы работало «из коробки»
- * в любом фреймворке и vanilla.
+ * Exports the framework-independent core plus the web component registration.
+ * Importing this module defines <koda-editor> straight away, so the editor
+ * works out of the box in any framework and in plain HTML.
  */
 export { Editor, type EditorOptions } from './editor';
 export { importDocxToHtml, type DocxImportResult, DocxImportError, classifyDocxError, rawTextToHtml, type DocxImportErrorCode, } from './docx-import';