@kodaeditor/core 1.0.1 → 1.0.3

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';