@kodaeditor/core 1.0.0 → 1.0.2

package/dist/web-component.d.ts

@@ -1,15 +1,14 @@
 import type { DocxImportResult } from './docx-import';
 import { type Strings } from './i18n';
 /**
- * База класса. В браузере это HTMLElement, в среде без DOM - пустой класс.
+ * Class base: HTMLElement in a browser, an empty class where there is no DOM.
  *
- * Нужно потому, что `class X extends HTMLElement` исполняется при ЗАГРУЗКЕ
- * модуля, а не при создании элемента: без подмены сам факт
- * `import '@kodaeditor/core'` падал с «HTMLElement is not defined» при
- * серверном рендеринге (Next.js, Nuxt, SvelteKit импортируют модули хоста в
- * Node). Регистрация <koda-editor> и без того выполняется только при наличии
- * window - см. index.ts, - так что на сервере этот класс просто никогда не
- * используется.
+ * `class X extends HTMLElement` runs when the MODULE LOADS, not when an
+ * element is created, so without this substitution the mere act of
+ * `import '@kodaeditor/core'` threw "HTMLElement is not defined" during
+ * server-side rendering (Next.js, Nuxt and SvelteKit import host modules in
+ * Node). Registration of <koda-editor> already happens only when a window
+ * exists, so on the server this class is simply never used.
  */
 declare const ElementBase: typeof HTMLElement;
 export declare class KodaEditorElement extends ElementBase {
@@ -18,30 +17,14 @@ export declare class KodaEditorElement extends ElementBase {
     private buttons;
     private contentEl?;
     private stringsValue;
+    private localeValue;
+    private localeExplicit;
     private internals?;
     private pendingValue?;
-    /** Словарь клиента, заданный свойством до монтирования. */
     private pendingStrings?;
     private suppressChange;
     private fsKeyHandler?;
-    /**
-     * Номер цикла монтирования. Нужен, чтобы асинхронная проверка лицензии
-     * знала, тот ли редактор она застала: при реконсиляции во фреймворках
-     * элемент отключают и тут же подключают снова, и результаты проверок
-     * прошлых циклов приходили в уже новый редактор - водяные знаки копились
-     * (проверено: три знака после трёх циклов remove/append).
-     */
     private mountGeneration;
-    /**
-     * Запасное поле формы для браузеров без ElementInternals.
-     *
-     * attachInternals появился в Safari только в 16.4 (март 2023), а корпоративные
-     * маки застревают на старых версиях macOS надолго. Там Shadow DOM есть, то
-     * есть редактор поднимается полноценно и откат на textarea НЕ срабатывает -
-     * а значение в форму не попадает, потому что некому его туда положить.
-     * Пользователь печатает, жмёт «Отправить», на сервер не уходит ничего. Тот же
-     * молчаливый класс, что и потерянный name в откате (исправлено 11.09.2026).
-     */
     private shadowFormInput?;
     private searchBar?;
     private searchFindInput?;
@@ -54,14 +37,14 @@ export declare class KodaEditorElement extends ElementBase {
     private readonly onPasteRich;
     static get observedAttributes(): string[];
     /**
-     * Реакция на смену атрибутов после монтирования.
+     * Reacts to attribute changes after the element is mounted.
      *
-     * Раньше observedAttributes был объявлен, а самого коллбэка в пакете не было
-     * вовсе: интегратор менял placeholder или aria-label и получал молчаливое
-     * бездействие вместо заявленного спецификацией поведения.
+     * Before mounting, values are picked up in connectedCallback, so early
+     * calls are ignored - the browser also fires this callback while parsing
+     * the markup.
      *
-     * До монтирования значения подхватываются в connectedCallback, поэтому
-     * ранние вызовы (браузер дёргает коллбэк и при разборе разметки) игнорируем.
+     * Note that `locale` and `lang` are read once, when the element connects.
+     * Changing them later logs a warning instead of silently doing nothing.
      */
     attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
     connectedCallback(): void;
@@ -72,142 +55,105 @@ export declare class KodaEditorElement extends ElementBase {
     private getSavedLayout;
     private saveLayout;
     private clearLayout;
-    /** Токены текущей раскладки (для редактора). Дефолт - из TOOLBAR + выпадашки.
-     * Без 'style' (выпадашка «Абзац») - её заменяет галерея «Стили» в TOOLBAR;
-     * 'style' остаётся доступной в палитре карандаша. */
     private defaultTokens;
-    /** Человекочитаемая подпись токена для диалога настройки. */
     private tokenLabel;
-    /** Иконка токена (HTML svg) - для палитры/превью карандаша. '' если без иконки. */
     private tokenIcon;
-    /** Все токены, доступные для добавления в палитре карандаша (без разделителя). */
     private allTokens;
-    /**
-     * Разбор сохранённой раскладки. Поддерживает два формата (обратносовместимо):
-     *  - строка токенов: "style | bold italic | export" (старый, конфиг интегратора)
-     *  - JSON-массив LayoutEntry с группами (новый, карандаш) - начинается с '['
-     */
     private parseLayout;
-    /** Нормализация одной записи раскладки из недоверенного JSON. */
     private normalizeEntry;
-    /** Текущая раскладка как записи (для карандаша). Дефолт - плоский список токенов. */
     private currentEntries;
-    /** Сериализовать раскладку: JSON если есть группы, иначе компактная строка токенов. */
     private serializeEntries;
-    /** Сохранить раскладку (из карандаша) и пересобрать панель. */
     private saveEntries;
     private appendCustomizeButton;
-    /** Запуск редактора панели «карандаш» (drag-and-drop прямо на тулбаре). */
     private openToolbarEditor;
-    /**
-     * Кнопка-группа: обложка + название + ▾, по клику раскрывает меню с вложенными
-     * кнопками. Сами кнопки внутри выполняют свои команды (как на панели).
-     */
     private appendGroupButton;
-    /** Выпадающее меню кнопки-группы со вложенными кнопками. */
     private openGroupMenu;
-    /** Выполнить действие редактора и обновить состояние тулбара. */
     private menuRun;
-    /** Пункты меню «Таблица» - переиспользуются и в верхнем меню, и в контекстном. */
     private tableMenuItems;
-    /** Декларативная структура верхнего меню. Действия переиспуют методы редактора. */
     private buildMenus;
-    /** Контекстное меню по элементу под курсором (правый клик). */
     private buildContextMenu;
     private onContextMenu;
-    /** Вырезать/копировать через нативную команду (выделение редактора). */
     private execEdit;
-    /** Запомнить формат текущей позиции и включить «кисть» (следующее выделение - применит). */
     private armFormatPainter;
     private disarmFormatPainter;
-    /** Анализ документа на типичные проблемы доступности (WCAG-ориентировочно). */
+    /** Checks the document for common accessibility problems (WCAG-oriented). */
     checkAccessibility(): {
         issue: string;
         count: number;
     }[];
-    /** Диалог результатов проверки доступности. */
     private openAccessibilityCheck;
     private spellcheckOn;
-    /** Включить/выключить браузерную проверку орфографии (язык - из locale). */
+    /**
+     * Turns the browser spell checker on or off.
+     *
+     * The browser picks the dictionary from the lang attribute, so the language
+     * of the editing area is not cosmetic: under the wrong dictionary every
+     * word is underlined.
+     *
+     * If you set a language (the locale or lang attribute on the element), that
+     * is what is used. If you do not, the language of the page is copied
+     * instead - imposing a default here would put, say, a Japanese page on an
+     * English dictionary.
+     *
+     * The page language is copied EXPLICITLY rather than left to inheritance,
+     * because Firefox does not pass lang across the shadow boundary while
+     * Chromium and WebKit do. If the page has no language either, no attribute
+     * is set and the browser decides.
+     */
     setSpellcheck(on: boolean): void;
     isSpellcheckOn(): boolean;
     setPagination(on: boolean): void;
     isPaginated(): boolean;
-    /** Строка диалога свойств: подпись + поле. */
     private propRow;
     private propSelect;
     private propInput;
-    /**
-     * Word-подобная вставка таблицы: сетка с наведением (динамически расширяется
-     * до 20×20) + ручной ввод числа строк/столбцов для больших таблиц.
-     */
     private openTableGridPicker;
     /**
-     * Словарь интерфейса клиента: СВОЙ язык без нашего участия.
+     * Your own interface dictionary: any language, without waiting for us.
      *
-     * Зачем: встроенных локалей две (en, ru), а редактор встраивают в системы,
-     * где с документами весь день работают люди, английского не знающие -
-     * госуслуги, банки, страховые, медицина. Держать в ядре словари всех рынков
-     * означало бы поддерживать их вечно и всё равно не угадать. Поэтому клиент
-     * может задать свой словарь сам: полный перевод или несколько переименованных
-     * кнопок.
+     * Seven locales ship with the editor, but it gets embedded in systems whose
+     * users work with documents all day and may not read any of them. Shipping
+     * a dictionary for every market would mean maintaining them forever and
+     * still missing one, so you can supply your own: a full translation or just
+     * a few renamed buttons.
      *
-     * Два способа, оба читаются при монтировании (как и атрибут locale):
-     *   - свойство: el.strings = { bold: 'Negrita', ... } ДО вставки в DOM;
-     *   - атрибут strings-ref="id" -> <script type="application/json"> с тем же
-     *     объектом; удобно для серверного рендера и разметки без JS.
+     * Two ways, both read when the element mounts (like the locale attribute):
+     *   - property: el.strings = { bold: 'Negrita', ... } BEFORE it enters the DOM;
+     *   - attribute strings-ref="id" pointing at a
+     *     <script type="application/json"> holding the same object, which suits
+     *     server-side rendering and markup without JavaScript.
      *
-     * Переопределения накладываются ПОВЕРХ выбранной локали, поэтому переводить
-     * всё необязательно: незаданные ключи остаются как были. Тип Strings
-     * экспортируется пакетом, так что у клиента на TypeScript есть проверка имён.
+     * Overrides are applied ON TOP of the chosen locale, so you need not
+     * translate everything: keys you leave out keep their original text. The
+     * Strings type is exported by the package, so TypeScript checks the names.
      */
     set strings(overrides: Partial<Strings>);
     get strings(): Strings;
-    /** Собрать переопределения из свойства и из strings-ref. Только строки. */
     private collectStringOverrides;
-    /**
-     * Кладёт значение в форму там, где ElementInternals недоступен: скрытым
-     * полем с тем же именем. Ничего не делает, если internals есть (современные
-     * браузеры) или если имя не задано - без имени поле всё равно не отправится.
-     */
     private syncFallbackFormValue;
-    /** Транзиентная подсказка внизу редактора (автоисчезает). */
     private flashNotice;
-    /**
-     * Разделить ячейку как в Word. Объединённую - сразу разъединяем (понятное
-     * действие). Обычную - диалог «Столбцов × Строк».
-     */
     private openSplitCellDialog;
-    /** Объединить ячейки; при одиночном выделении - понятная подсказка. */
     private mergeCellsWithHint;
-    /** Каркас диалога свойств: backdrop + заголовок + строки + Отмена/Применить. */
     private buildPropsDialog;
     private openTablePropsDialog;
     private openCellPropsDialog;
-    /** Доступные поля: из атрибута merge-fields (JSON) или дефолтный набор реквизитов. */
     private getMergeFields;
-    /** Диалог вставки поля шаблона. */
     private openMergeFieldPicker;
-    /** Публичный API: вставить поле шаблона программно. */
+    /** Inserts a merge field programmatically. */
     insertMergeField(key: string, label?: string): void;
-    /** Публичный API: HTML с полями, развёрнутыми в {{key}} (для ЭДО-подстановки). */
+    /** Returns the HTML with merge fields expanded to {{key}}, ready for mail merge. */
     getMergeText(): string;
-    /** Диалог ввода текста сноски, затем вставка маркера. */
     private openFootnotePrompt;
-    /** Публичный API: вставить сноску / получить тексты сносок / вставить оглавление. */
+    /** Inserts a footnote, reads footnote texts, or inserts a table of contents. */
     insertFootnote(text: string): void;
     getFootnotes(): string[];
     insertTableOfContents(): void;
-    /** Набор быстрых стилей: тип блока + интервалы + превью для галереи. */
     private styleGallery;
-    /** Галерея стилей - выпадающая панель с превью каждого стиля. */
     private openStyleGallery;
-    /** Диалог ввода комментария к выделению. */
     private openCommentPrompt;
     private onCommentClick;
-    /** Попап комментария: текст + кнопка «Разрешить». */
     private openCommentPopup;
-    /** Публичный API комментариев. */
+    /** Comment API. */
     addComment(text: string, author?: string): string | null;
     getComments(): {
         id: string;
@@ -228,7 +174,7 @@ export declare class KodaEditorElement extends ElementBase {
     private versionsKey;
     private readVersions;
     private writeVersions;
-    /** Сохранить снимок текущего документа как именованную версию. */
+    /** Saves a snapshot of the current document as a named version. */
     saveVersion(name?: string): void;
     getVersions(): {
         id: string;
@@ -238,146 +184,91 @@ export declare class KodaEditorElement extends ElementBase {
     }[];
     restoreVersion(id: string): void;
     deleteVersion(id: string): void;
-    /** Диалог истории версий: сохранить текущую, восстановить/удалить прошлые. */
     private openVersionHistory;
-    /** Пересобирает панель из текущей раскладки (после сохранения/сброса). */
     private rebuildToolbar;
-    /** Один токен спецификации `toolbar="..."` -> элемент панели. Неизвестный - пропуск. */
     private appendToolbarToken;
-    /** Рендер одной записи панели (разделитель / контрол цвета / кнопка). */
     private appendEntry;
     private onToolbarKeydown;
     private refreshToolbar;
-    /** Общий конструктор выпадашки панели. */
     private makeSelect;
     private buildStyleSelect;
     private buildFontSelect;
     private buildSizeSelect;
-    /** Кнопка выбора цвета (текст/выделение): иконка + скрытый input[type=color]. */
     private buildColorControl;
-    /** Простой диалог ссылки (URL): ставит/снимает ссылку на выделении. */
+    private pendingColorInputs;
+    private placeColorInput;
     private openLinkPrompt;
-    /**
-     * Диалог выбора режима импорта PDF: текст (редактируемо) / картинки (точный
-     * растр) / как PDF (встроить файл). Возвращает выбор или null (отмена).
-     */
     private pickPdfMode;
-    /**
-     * Меню экспорта: PDF / Word / HTML / Markdown / TXT / CSV. Всё client-side -
-     * содержимое не уходит на сервер. Выбор формата вызывает нужный метод Editor.
-     */
     private openExportPicker;
-    /**
-     * Чекер импорта: «Файл с компьютера» или «По ссылке (URL)». Оба пути -
-     * client-side: файл читается в браузере, URL загружается fetch-ом самого
-     * браузера (наш сервер не участвует).
-     */
     private openImportPicker;
     /**
-     * Импорт файла по URL (client-side fetch браузером). Картинки вставляются
-     * по ссылке напрямую (без скачивания - обходит CORS на отображение).
-     * Документы скачиваются в Blob и идут тем же путём, что файл с диска;
-     * PDF спрашивает режим (текст/картинки/встроить). Ошибки CORS/сети -
-     * понятное событие importerror.
+     * Imports a file from a URL, fetched by the browser. Images are inserted by
+     * link without downloading, which avoids CORS restrictions on display.
+     * Documents are fetched into a Blob and follow the same path as a file from
+     * disk; for a PDF the editor asks how to insert it (text, images or
+     * embedded). CORS and network failures surface as an importerror event.
      */
     importFromUrl(url: string): Promise<void>;
-    /** Единое событие об ошибке импорта. */
     private emitImportError;
-    /**
-     * Показывает оверлей «Обработка…» поверх редактора на время долгой операции
-     * (парсинг PDF/конвертация). Возвращает функцию-скрывалку. Без него медленные
-     * импорты выглядят как «клик не сработал».
-     */
     private showLoading;
     private static readonly IMPORT_ACCEPT_ALL;
-    /**
-     * Открыть системный диалог выбора файла с заданным accept и импортировать
-     * выбранный файл. Используется и атомарными кнопками (Word/PDF/Excel/Текст),
-     * и общей кнопкой (полный accept).
-     */
     private openFilePicker;
-    /**
-     * Общая обработка импортируемого файла: PDF - с выбором режима (текст/картинки/
-     * встроить), остальное - автодетект. Индикатор загрузки + события change/importerror.
-     */
     private handleImportedFile;
-    /** Общая кнопка импорта «Файл с компьютера» (legacy): полный accept. */
     private pickImportFile;
     /**
-     * Публичный API: программный импорт .docx (File/ArrayBuffer). Возвращает
-     * предупреждения движка (неподдержанные стили, текст в текстовых полях
-     * и т.п.) - раньше терялись здесь молча (Promise<void>), хотя editor.ts
-     * их уже собирал; хост может их показать пользователю или проигнорировать.
+     * Imports a .docx programmatically (File or ArrayBuffer) and returns the
+     * converter's warnings - unsupported styles, text inside shapes and the
+     * like. Show them to the user or ignore them, as suits your application.
      */
     importDocx(source: File | ArrayBuffer): Promise<DocxImportResult | undefined>;
-    /** Публичный API: импорт файла (.docx/.csv/.txt/.md/картинка) с автодетектом. */
+    /** Imports a file (.docx, .csv, .txt, .md or an image), detecting the type. */
     importFile(file: File): Promise<void>;
-    /** Публичный API: экспорт в Markdown (скачивание .md). */
+    /** Exports to Markdown and downloads the .md file. */
     exportMarkdown(): void;
-    /** Публичный API: экспорт в HTML / TXT / CSV / Word (.doc). Client-side. */
+    /** Exports to HTML, TXT, CSV or Word (.doc). Runs entirely in the browser. */
     exportHtml(): void;
     exportText(): void;
     exportCsv(): void;
     exportWord(): void;
-    /** Публичный API: импорт PDF как картинок (страницы -> изображения). */
+    /** Imports a PDF as images, one image per page. */
     importPdfAsImages(file: File): Promise<void>;
-    /** Публичный API: встроить PDF «как есть» (iframe, client-side). */
+    /** Embeds a PDF as it is, in an iframe, without converting it. */
     importPdfAsEmbed(file: File): Promise<void>;
-    /** Публичный API: следующая вставка - только текст. */
+    /** Makes the next paste plain text only. */
     armPlainPaste(): void;
     /**
-     * Публичный API: вставка «богатого» буфера из companion-расширения
-     * (полный HTML + RTF в обход песочницы). Расширение зовёт этот метод
-     * напрямую или через DOM-событие `koda-paste-rich`.
+     * Pastes rich clipboard content supplied by the companion browser
+     * extension (full HTML plus RTF, which the page sandbox cannot read on its
+     * own). The extension calls this method directly or dispatches the
+     * `koda-paste-rich` DOM event.
      */
     pasteRich(html: string, rtf?: string): void;
-    /** Диалог вставки картинки: по ссылке/пути или загрузкой файла. */
     private openImageDialog;
-    /**
-     * Загрузка картинки: на сервер клиента (upload-url) или встраивание base64.
-     *
-     * Две вещи, которых здесь раньше не было:
-     *  - проверка типа и размера ДО отправки. Атрибут accept у поля выбора -
-     *    только подсказка, перетаскивание его не спрашивает;
-     *  - отказ сервера больше не подменяется тихо на data-URI. Раньше клиент,
-     *    отклонивший файл на 20 МБ, получал ровно тот же файл, но внутри
-     *    документа в base64: пользователь видел успех, а в базу уезжал
-     *    многомегабайтный кусок. Если upload-url задан, встраивание base64 -
-     *    это не «запасной путь», а тихая подмена договорённости.
-     */
     private handleImageFile;
-    /** Вставка картинки в редактор (ProseMirror). */
     private insertImageSmart;
     private checkLicense;
-    /**
-     * Агрессивный демо-знак: диагональное замощение по всей канве (фон листа,
-     * растёт с документом и покрывает все страницы) + sticky-пилюля сверху для
-     * доступности. Не блокирует ввод (pointer-events:none / фон).
-     */
     private applyDemoWatermark;
-    /** SVG-тайл с диагональным текстом знака → data-URI для background-image. */
     private demoWatermarkUri;
     getContent(): string;
     setContent(html: string): void;
     getJSON(): unknown;
-    /** Экспорт документа в PDF (печать средствами браузера, client-side). */
+    /** Exports to PDF through the browser print dialog, with no server involved. */
     exportPdf(): void;
-    /** value - как у нативного поля: чтение/запись HTML. Работает с v-model. */
+    /** value behaves like a native form field: reads and writes HTML. Works with v-model. */
     get value(): string;
     set value(html: string);
-    /** Сброс формы (<form>.reset() или кнопка type=reset) - очищаем редактор. */
+    /** Form reset (<form>.reset() or a type=reset button) clears the editor. */
     formResetCallback(): void;
-    /** Переключить полноэкранный режим (на весь экран, без сервера/прав). */
+    /** Toggles full-screen mode. */
     toggleFullscreen(): void;
-    /** Панель найти/заменить (скрыта по умолчанию). */
     private buildSearchBar;
-    /** Показать/скрыть панель поиска. */
+    /** Shows or hides the search bar. */
     toggleSearch(show?: boolean): void;
 }
 /**
- * Регистрирует <koda-editor>. Идемпотентно по конкретному тегу.
- * Для произвольного тега используется анонимный подкласс - один класс
- * нельзя зарегистрировать под двумя именами (define бросит ошибку).
+ * Registers <koda-editor>. Calling it twice for the same tag is harmless.
+ * A custom tag gets an anonymous subclass, because one class cannot be
+ * registered under two names - customElements.define would throw.
  */
 export declare function defineKodaEditor(tag?: string): void;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kodaeditor/core",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "WYSIWYG rich-text editor as a web component. Pastes Word, Excel and Google Docs content without losing tables, lists or formatting. Self-hosted, framework-agnostic.",
   "keywords": [
     "wysiwyg",
@@ -19,17 +19,17 @@
   "homepage": "https://kodaeditor.com",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/mynameisilhom/editoruz-core.git",
+    "url": "git+https://github.com/silkhorizonstudios/kodaeditor-issues.git",
     "directory": "packages/core"
   },
   "bugs": {
+    "url": "https://github.com/silkhorizonstudios/kodaeditor-issues/issues",
     "email": "support@kodaeditor.com"
   },
   "type": "module",
   "main": "./dist/kodaeditor.umd.cjs",
   "module": "./dist/kodaeditor.js",
   "types": "./dist/index.d.ts",
-  "//exports": "Два варианта поставки в ОДНОМ пакете, выбор за покупателем и без переписки с нами. По умолчанию (\".\") - полная сборка: всё внутри, ни одного обращения в сеть, это важнее веса для закрытых контуров. \"./light\" - сборка без pdf.js и xlsx (1,1 МБ вместо 3,1): их файлы лежат в \"./vendor\" и грузятся только когда пользователь реально открывает PDF или Excel. Оба варианта обфусцируются при публикации.",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -49,17 +49,15 @@
   ],
   "scripts": {
     "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "build": "npm run clean && tsc -p tsconfig.json && vite build",
+    "build": "npm run clean && tsc -p tsconfig.json && node ../../scripts/strip-private-docs.mjs dist && node ../../scripts/prune-internal-types.mjs dist && vite build",
     "build:split": "vite build --config vite.config.split.ts && node ../../scripts/copy-vendor.mjs",
     "build:protected": "npm run build:split && node ../../scripts/obfuscate.mjs dist/kodaeditor-core.umd.cjs dist/kodaeditor-core.obf.umd.cjs",
     "build:standalone-protected": "npm run build && node ../../scripts/obfuscate.mjs dist/kodaeditor.js dist/kodaeditor.js && node ../../scripts/obfuscate.mjs dist/kodaeditor.umd.cjs dist/kodaeditor.umd.cjs",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "prepack": "npm run build:standalone-protected && npm run build:split && node ../../scripts/obfuscate.mjs dist/kodaeditor-core.umd.cjs dist/kodaeditor-core.umd.cjs && node -e \"require('fs').copyFileSync('../../LICENSE.md','LICENSE.md')\" && node ../../scripts/check-ssr-import.mjs",
-    "//postpack": "Возвращает ОБА варианта сборки читаемыми. Оба - потому что npm run build начинается с clean и стирает лёгкую сборку вместе с vendor: после упаковки в рабочем каталоге не оставалось того, что уехало в пакет, и \"./light\" переставал резолвиться локально. prepack обфусцирует dist ПРЯМО В РАБОЧЕМ КАТАЛОГЕ. Тарбол уже собран, на его содержимое это не влияет, но разработчик остаётся с нечитаемой сборкой и теряет время, не понимая почему. Возвращаем обычную сборку сразу, а не помним об этом.",
     "postpack": "npm run build && npm run build:split"
   },
-  "comment": "ВСЕ библиотеки ВСТРОЕНЫ в dist (один файл, inlineDynamicImports). Поэтому у пакета НЕТ runtime-зависимостей: npm i тарболла НЕ тянет ничего из npm/CDN. Сборочные либы - в devDependencies. build:protected/build:split - отдельный, сейчас НЕ используемый нигде путь поставки (лёгкий CDN-вариант без pdf.js/xlsx, грузит их с внешнего CDN vendor-хостинга) - ссылается на chayxonajon.uz, который больше не наш домен; не трогаем, не часть текущей npm-поставки. Для npm publish защищённость обеспечивает НОВЫЙ build:standalone-protected - обфусцирует именно те файлы (dist/kodaeditor.js, dist/kodaeditor.umd.cjs), на которые ссылаются main/module/exports; запускается автоматически через prepack перед npm pack/publish, поэтому руками вызывать не обязательно.",
   "devDependencies": {
     "@types/turndown": "^5.0.6",
     "dompurify": "^3.4.15",

package/dist/commands.d.ts

@@ -1,15 +0,0 @@
-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

@@ -1,14 +0,0 @@
-/**
- * Восстановление выравнивания абзацев при импорте .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

@@ -1,31 +0,0 @@
-/**
- * Разрывы страниц/секций при импорте .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

@@ -1,28 +0,0 @@
-/**
- * Чекбоксы форм при импорте .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

@@ -1,22 +0,0 @@
-/**
- * Извлечение колонтитулов (шапка/футер) из .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>;