@kodaeditor/core 1.0.0

package/dist/commands.d.ts

@@ -0,0 +1,15 @@
+import type { Command } from 'prosemirror-state';
+import type { Node as PMNode } from 'prosemirror-model';
+import type { Strings } from './i18n';
+/** Создаёт узел таблицы rows×cols с шапкой в первой строке. */
+export declare function createTable(rows: number, cols: number): PMNode;
+export interface SlashItem {
+    titleKey: keyof Strings;
+    icon: string;
+    keywords: string[];
+    command: Command;
+}
+/** Пункты slash-меню (порядок = порядок показа). */
+export declare const SLASH_ITEMS: SlashItem[];
+/** Фильтр пунктов по запросу (название + ключевые слова). */
+export declare function filterSlashItems(query: string, strings: Strings): SlashItem[];

package/dist/docx-alignment.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Восстановление выравнивания абзацев при импорте .docx (w:jc).
+ *
+ * mammoth не переносит прямое форматирование абзаца, включая text-align —
+ * из-за этого правое выравнивание сумм/дат в ячейках таблиц (частый паттерн
+ * реальных инвойсов) и центрированные заголовки терялись. Схема редактора
+ * это выравнивание УЖЕ поддерживает (paragraph.attrs.align, см. schema.ts) —
+ * не хватало только источника данных на стороне docx-импорта. Тот же
+ * text-match паттерн, что docx-text-styles.ts использует для цвета/размера.
+ */
+/** Читает .docx и возвращает text-align по тексту абзацев. Безопасно к ошибкам. */
+export declare function extractDocxAlignment(arrayBuffer: ArrayBuffer): Promise<Map<string, string>>;
+/** Накладывает text-align на блоки mammoth-вывода по тексту абзаца. */
+export declare function applyDocxAlignment(root: HTMLElement, alignment: Map<string, string>): void;

package/dist/docx-breaks.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Разрывы страниц/секций при импорте .docx.
+ *
+ * mammoth теряет ручной разрыв страницы (Ctrl+Enter -> <w:br w:type="page"/>) и
+ * разрыв секции «с новой страницы» (<w:sectPr> внутри w:pPr). В многостраничных
+ * ЭДО это смысловая граница: «приложение — с новой страницы», «акт / протокол».
+ * Без неё две страницы сливаются в сплошной поток.
+ *
+ * В потоковом HTML-редакторе постраничности нет, поэтому НАМЕРЕННЫЙ разрыв
+ * показываем горизонтальной линией <hr class="koda-pagebreak"> (схема её знает —
+ * это кнопка «Горизонтальная линия»). Автопагинацию (w:lastRenderedPageBreak —
+ * лишь подсказка рендера) и continuous-секции НЕ трогаем: это не границы.
+ *
+ * Делается в два шага: (1) в document.xml на месте разрыва ставим текстовый
+ * сентинел ДО mammoth; (2) в готовом HTML сентинел -> <hr>, разрезая абзац
+ * через Range (корректно делит вложенное форматирование).
+ */
+/** Невидимый маркер (private-use) на месте разрыва — переживает mammoth как текст. */
+export declare const PB_SENTINEL = "\uE000EUZPAGEBREAK\uE000";
+/**
+ * Мутирует parsed document.xml: ручной page-break и параграф-уровневый sectPr
+ * «с новой страницы» -> текстовый сентинел. Возвращает true при изменении.
+ * Часть общего препроцессинга (один repack zip).
+ */
+export declare function replaceBreaksInDoc(doc: Document): boolean;
+/**
+ * В готовом HTML: сентинел -> <hr class="koda-pagebreak">. Абзац, содержащий
+ * сентинел, разрезается через Range (хвост с сохранением вложенного
+ * форматирования выносится в новый блок). Возвращает true при изменении.
+ */
+export declare function splitPageBreaks(root: HTMLElement): boolean;

package/dist/docx-forms.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Чекбоксы форм при импорте .docx (анкеты ЭДО: ☒ Согласен / ☐ ...).
+ *
+ * mammoth теряет состояние чекбоксов: и современных content-control
+ * (w14:checkbox), и legacy form-field (w:checkBox в w:ffData). Остаётся только
+ * текст метки — не видно, отмечено или нет. Здесь чекбоксы заменяются в
+ * document.xml на символ ☒ (отмечен) / ☐ (пустой) ДО mammoth, так состояние
+ * сохраняется как читаемый символ.
+ */
+/**
+ * Мутирует parsed document.xml: чекбоксы -> ☒/☐. Возвращает true, если что-то
+ * заменено. Чистая DOM-операция (общий repack с формулами).
+ */
+export declare function replaceCheckboxesInDoc(doc: Document): boolean;
+/**
+ * Разворачивает w:fldSimple: mammoth ИГНОРИРУЕТ содержимое простых полей (DATE,
+ * NUMPAGES, REF и т.п.), теряя кэшированное значение. Здесь дети fldSimple
+ * (последний вычисленный результат) выносятся наружу как обычные прогоны, и
+ * значение поля сохраняется как текст. Возвращает true, если что-то развёрнуто.
+ */
+export declare function unwrapSimpleFields(doc: Document): boolean;
+/**
+ * Tab-лидеры (точечные/подчёркнутые линии заполнения — «Подпись.........» в
+ * формах ЭДО) mammoth теряет вместе с табом. Здесь tab-символ в абзаце с
+ * tab-стопом, у которого есть w:leader, заменяется на строку лид-символов —
+ * чтобы линия для подписи/заполнения осталась видимой. Возвращает true при замене.
+ */
+export declare function replaceTabLeadersInDoc(doc: Document): boolean;

package/dist/docx-headers.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Извлечение колонтитулов (шапка/футер) из .docx при импорте.
+ *
+ * mammoth берёт только тело документа и ИГНОРИРУЕТ колонтитулы. Для ЭДО это
+ * потеря: фирменный бланк, реквизиты организации, «УТВЕРЖДАЮ», номера страниц
+ * часто лежат именно в шапке/футере (word/header*.xml, word/footer*.xml).
+ *
+ * Здесь шапка/футер читаются прямо из zip и конвертируются в простой HTML
+ * (абзацы с выравниванием/жирным + таблицы), чтобы летерхед не пропал.
+ * Шапка ставится в НАЧАЛО документа, футер — в КОНЕЦ (один раз, т.к. в
+ * потоковом редакторе нет постраничного повтора).
+ */
+export interface DocxHeaderFooter {
+    header: string;
+    footer: string;
+}
+/**
+ * Читает .docx и возвращает HTML шапки и футера (самые «насыщенные» из
+ * нескольких, т.к. часто есть default/first/even — летерхед обычно в одном).
+ * Безопасно к ошибкам — при сбое отдаёт пустые строки.
+ */
+export declare function extractDocxHeaderFooter(arrayBuffer: ArrayBuffer): Promise<DocxHeaderFooter>;

package/dist/docx-images.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Извлечение картинок из .docx и вставка их в нужные ячейки таблиц.
+ *
+ * mammoth тащит только простые inline-картинки и теряет VML-фигуры (круглое
+ * фото в `v:oval`), плавающие рисунки и часть DrawingML. Для резюме/форм это
+ * критично — пропадает фото и логотипы. Здесь картинки достаются прямо из zip
+ * (`word/media/*`), сопоставляются с ячейками таблиц по позиции в OOXML и
+ * вставляются в соответствующие ячейки mammoth-вывода.
+ */
+/** Картинки по таблицам: cells[индекс ячейки row-major] = массив data-URI. */
+export interface DocxTableImages {
+    cells: string[][];
+}
+/** Читает .docx и возвращает картинки по таблицам/ячейкам. Безопасно к ошибкам. */
+export declare function extractDocxImages(arrayBuffer: ArrayBuffer): Promise<DocxTableImages[]>;
+/** Вставляет извлечённые картинки в ячейки таблиц mammoth-вывода по позиции. */
+export declare function applyDocxImages(root: HTMLElement, tables: DocxTableImages[]): void;
+/**
+ * Размеры ОТОБРАЖЕНИЯ картинок, которые рендерит mammoth, в порядке документа.
+ * Источники (mammoth теряет размер — рисует в натуральную величину):
+ *  - DrawingML инлайн: `<wp:inline>` → `<wp:extent cx cy>` (EMU);
+ *  - VML-картинка: `<v:shape|rect|oval style="width:..pt;height:..pt">` c
+ *    вложенным `<v:imagedata>` (pt). Чистые векторные фигуры (без imagedata,
+ *    напр. блок-схемы) пропускаются — mammoth их всё равно не рендерит.
+ * Возвращает по элементу на каждый рисунок-картинку (null, если размера нет).
+ */
+export declare function extractInlineImageSizes(arrayBuffer: ArrayBuffer): Promise<({
+    w: number;
+    h: number;
+} | null)[]>;
+/**
+ * Проставляет размеры отображения на инлайн-картинки mammoth-вывода.
+ * Безопасно: применяет ТОЛЬКО когда число `<img>` совпадает с числом инлайн-
+ * рисунков (тогда соответствие 1:1 по порядку надёжно). Иначе — пропуск, чтобы
+ * не проставить чужой размер (mammoth мог потерять часть рисунков или это VML).
+ * Вызывать на сыром mammoth-выводе, ДО инъекции табличных картинок.
+ */
+export declare function applyInlineImageSizes(root: HTMLElement, sizes: ({
+    w: number;
+    h: number;
+} | null)[]): void;

package/dist/docx-import.d.ts

@@ -0,0 +1,36 @@
+export interface DocxImportResult {
+    html: string;
+    warnings: string[];
+}
+export type DocxImportErrorCode = 'corrupt' | 'invalid' | 'parse';
+/**
+ * Ошибка импорта с готовым к показу пользователю сообщением (поле
+ * `userMessage`) и машинным кодом причины. UI показывает `userMessage`,
+ * а не сырой текст исключения движка.
+ */
+export declare class DocxImportError extends Error {
+    readonly code: DocxImportErrorCode;
+    readonly userMessage: string;
+    constructor(code: DocxImportErrorCode, userMessage: string, cause?: unknown);
+}
+/**
+ * Классифицирует сырое исключение движка/zip-распаковщика в код причины и
+ * человекочитаемое сообщение (RU). Чистая функция — тестируется отдельно.
+ */
+export declare function classifyDocxError(message: string): {
+    code: DocxImportErrorCode;
+    userMessage: string;
+};
+/**
+ * Превращает голый текст (аварийный fallback, когда богатый разбор упал) в
+ * минимальный безопасный HTML: непустые строки -> абзацы, с экранированием.
+ * Чистая функция — тестируется отдельно.
+ */
+export declare function rawTextToHtml(text: string): string;
+/**
+ * Конвертирует .docx (File или ArrayBuffer) в чистый HTML для редактора.
+ * Картинки приходят как data-URI (base64) и сохраняются в документе.
+ *
+ * Бросает {@link DocxImportError}, если файл невозможно открыть даже как текст.
+ */
+export declare function importDocxToHtml(source: File | ArrayBuffer): Promise<DocxImportResult>;

package/dist/docx-math.d.ts

@@ -0,0 +1,18 @@
+/**
+ * OMML-формулы (Office Math) при импорте .docx.
+ *
+ * mammoth ПОЛНОСТЬЮ выкидывает математику (m:oMath) — формула пропадает без
+ * следа. Полноценный рендер (MathML) схема редактора не пропустит, поэтому
+ * здесь формула конвертируется в ЧИТАЕМЫЙ Unicode-текст (дроби, степени,
+ * индексы, корни, интегралы/суммы) и подставляется НА МЕСТО формулы прямо в
+ * document.xml ДО mammoth — так текст формулы встаёт в правильную позицию.
+ * Лучше «(a)/(b) + x²», чем пустота.
+ */
+/** oMath -> текст. */
+export declare function omathToText(omath: Element): string;
+/**
+ * Мутирует parsed document.xml: заменяет m:oMath/m:oMathPara на текстовые
+ * w:r-прогоны. Возвращает true, если что-то заменено. Чистая DOM-операция —
+ * чтобы препроцессинг (формулы + чекбоксы) делал ОДИН repack zip.
+ */
+export declare function replaceMathInDoc(doc: Document): boolean;

package/dist/docx-styles.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Дочерпывание табличных стилей из OOXML при импорте .docx.
+ *
+ * mammoth даёт чистую семантику, но осознанно игнорирует оформление:
+ *  - ширины колонок (`w:tblGrid`),
+ *  - заливку ячеек (`w:shd` на ячейке),
+ *  - заливку из СТИЛЯ таблицы (`w:tblStyle` + conditional formatting: шапка,
+ *    бандинг строк/колонок) — частый кейс встроенных стилей Word (Light Shading,
+ *    Grid Table и т.п.) и форм ЭДО.
+ * Всё это читается прямо из zip и накладывается на таблицы mammoth-вывода
+ * (порядок таблиц и ячеек совпадает с документным).
+ */
+export interface DocxTableStyle {
+    /** Ширины колонок в px (из w:tblGrid, twips -> px). */
+    colWidths: number[];
+    /**
+     * Заливки ячеек ПО СТРОКАМ (на каждую отрисованную mammoth-строку — список
+     * заливок слева направо). vMerge-continue ячейки пропущены (mammoth их не
+     * рендерит). Раскладка по строкам локализует рассинхрон рамками строки.
+     */
+    cellFills: (string | null)[][];
+}
+/** Парсит theme1.xml -> Map слот(dk1/lt1/accent1…) -> hex(6). */
+export declare function parseThemeColors(xml: string): Map<string, string>;
+interface CondFills {
+    whole: string | null;
+    firstRow: string | null;
+    lastRow: string | null;
+    firstCol: string | null;
+    lastCol: string | null;
+    band1Horz: string | null;
+    band2Horz: string | null;
+    band1Vert: string | null;
+    band2Vert: string | null;
+    rowBandSize: number;
+    colBandSize: number;
+}
+type StyleMap = Map<string, CondFills>;
+/** Парсит word/styles.xml -> Map styleId -> CondFills (с разрешением basedOn). */
+export declare function parseTableStyleDefs(stylesXml: string, theme: Map<string, string>): StyleMap;
+/**
+ * Разбор таблиц из XML. styles/theme опциональны (тесты могут передать xml без
+ * стилей; тогда работает только явный w:shd).
+ */
+export declare function parseTablesFromXml(xml: string, styles?: StyleMap, theme?: Map<string, string>): DocxTableStyle[];
+/** Читает .docx и возвращает стили таблиц по порядку. Безопасно к ошибкам. */
+export declare function extractDocxTableStyles(arrayBuffer: ArrayBuffer): Promise<DocxTableStyle[]>;
+/**
+ * Накладывает стили на таблицы mammoth-вывода: ширины колонок (через
+ * `<colgroup>` — дальше их подхватит normalizeTableWidths) и заливку ячеек.
+ */
+export declare function applyDocxTableStyles(root: HTMLElement, styles: DocxTableStyle[]): void;
+export {};

package/dist/docx-symbols.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Символьные прогоны Wingdings/Symbol (w:sym) при импорте .docx.
+ *
+ * Старые формы ЭДО ставят чекбоксы и маркеры символьным шрифтом: не текст ☐, а
+ * <w:sym w:font="Wingdings" w:char="F0A8"/> — код глифа В ШРИФТЕ. Без самого
+ * шрифта Wingdings (а сайт его не грузит) mammoth выдаёт либо пусто, либо
+ * нестандартный глиф (🞎/🗹), не совпадающий с ☐/☒ из обычных чекбоксов форм.
+ *
+ * Здесь известные коды Wingdings/Symbol заменяются НА МЕСТЕ в document.xml на
+ * корректный Unicode ДО mammoth: пустой чекбокс -> ☐, отмеченный -> ☒/☑,
+ * телефон -> ☎, греческие буквы Symbol -> α/β/… Неизвестные коды не трогаем —
+ * пусть их обрабатывает mammoth, чтобы ничего не сломать.
+ */
+/**
+ * Мутирует parsed document.xml: w:sym с известным шрифтом/кодом -> текстовый
+ * прогон w:r/w:t с Unicode-символом. Неизвестные оставляет нетронутыми.
+ * Возвращает true, если что-то заменено. Общий repack с формулами/чекбоксами.
+ */
+export declare function replaceSymbolsInDoc(doc: Document): boolean;

package/dist/docx-text-styles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Восстановление оформления текста при импорте .docx (цвет и размер).
+ *
+ * mammoth маппит «Heading 1/2/3» и «Title» в <h1>/<h2>/<h3>, но выбрасывает
+ * цвет и кегль, заданные в именованных стилях (word/styles.xml). Из-за этого
+ * синие заголовки резюме (#548AB7) и крупное имя (48pt) теряются. Здесь цвет и
+ * размер вычисляются для каждого абзаца (прямой run-стиль > стиль абзаца) и
+ * накладываются на блоки mammoth по тексту.
+ */
+interface TextStyle {
+    color?: string;
+    size?: string;
+}
+/** Читает .docx и возвращает оформление по тексту абзацев. Безопасно к ошибкам. */
+export declare function extractDocxTextStyles(arrayBuffer: ArrayBuffer): Promise<Map<string, TextStyle>>;
+/** Накладывает цвет/размер на блоки mammoth-вывода по тексту. */
+export declare function applyDocxTextStyles(root: HTMLElement, styles: Map<string, TextStyle>): void;
+interface StyledRun {
+    text: string;
+    color: string | null;
+    size: string | null;
+    font: string | null;
+    background: string | null;
+}
+export declare function extractDocxRunColors(arrayBuffer: ArrayBuffer): Promise<Map<string, StyledRun[]>>;
+export declare function applyDocxRunColors(root: HTMLElement, map: Map<string, StyledRun[]>): void;
+export {};