@kodaeditor/core 1.0.0

package/dist/web-component.d.ts

@@ -0,0 +1,383 @@
+import type { DocxImportResult } from './docx-import';
+import { type Strings } from './i18n';
+/**
+ * База класса. В браузере это HTMLElement, в среде без DOM - пустой класс.
+ *
+ * Нужно потому, что `class X extends HTMLElement` исполняется при ЗАГРУЗКЕ
+ * модуля, а не при создании элемента: без подмены сам факт
+ * `import '@kodaeditor/core'` падал с «HTMLElement is not defined» при
+ * серверном рендеринге (Next.js, Nuxt, SvelteKit импортируют модули хоста в
+ * Node). Регистрация <koda-editor> и без того выполняется только при наличии
+ * window - см. index.ts, - так что на сервере этот класс просто никогда не
+ * используется.
+ */
+declare const ElementBase: typeof HTMLElement;
+export declare class KodaEditorElement extends ElementBase {
+    static formAssociated: boolean;
+    private editor?;
+    private buttons;
+    private contentEl?;
+    private stringsValue;
+    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?;
+    constructor();
+    private selects;
+    private toolbarEditor?;
+    private menubar?;
+    private formatPainterArmed;
+    private readonly onSelectionMaybeChanged;
+    private readonly onPasteRich;
+    static get observedAttributes(): string[];
+    /**
+     * Реакция на смену атрибутов после монтирования.
+     *
+     * Раньше observedAttributes был объявлен, а самого коллбэка в пакете не было
+     * вовсе: интегратор менял placeholder или aria-label и получал молчаливое
+     * бездействие вместо заявленного спецификацией поведения.
+     *
+     * До монтирования значения подхватываются в connectedCallback, поэтому
+     * ранние вызовы (браузер дёргает коллбэк и при разборе разметки) игнорируем.
+     */
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    private buildToolbar;
+    private layoutId;
+    private layoutKey;
+    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-ориентировочно). */
+    checkAccessibility(): {
+        issue: string;
+        count: number;
+    }[];
+    /** Диалог результатов проверки доступности. */
+    private openAccessibilityCheck;
+    private spellcheckOn;
+    /** Включить/выключить браузерную проверку орфографии (язык - из locale). */
+    setSpellcheck(on: boolean): void;
+    isSpellcheckOn(): boolean;
+    setPagination(on: boolean): void;
+    isPaginated(): boolean;
+    /** Строка диалога свойств: подпись + поле. */
+    private propRow;
+    private propSelect;
+    private propInput;
+    /**
+     * Word-подобная вставка таблицы: сетка с наведением (динамически расширяется
+     * до 20×20) + ручной ввод числа строк/столбцов для больших таблиц.
+     */
+    private openTableGridPicker;
+    /**
+     * Словарь интерфейса клиента: СВОЙ язык без нашего участия.
+     *
+     * Зачем: встроенных локалей две (en, ru), а редактор встраивают в системы,
+     * где с документами весь день работают люди, английского не знающие -
+     * госуслуги, банки, страховые, медицина. Держать в ядре словари всех рынков
+     * означало бы поддерживать их вечно и всё равно не угадать. Поэтому клиент
+     * может задать свой словарь сам: полный перевод или несколько переименованных
+     * кнопок.
+     *
+     * Два способа, оба читаются при монтировании (как и атрибут locale):
+     *   - свойство: el.strings = { bold: 'Negrita', ... } ДО вставки в DOM;
+     *   - атрибут strings-ref="id" -> <script type="application/json"> с тем же
+     *     объектом; удобно для серверного рендера и разметки без JS.
+     *
+     * Переопределения накладываются ПОВЕРХ выбранной локали, поэтому переводить
+     * всё необязательно: незаданные ключи остаются как были. Тип Strings
+     * экспортируется пакетом, так что у клиента на TypeScript есть проверка имён.
+     */
+    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: вставить поле шаблона программно. */
+    insertMergeField(key: string, label?: string): void;
+    /** Публичный API: HTML с полями, развёрнутыми в {{key}} (для ЭДО-подстановки). */
+    getMergeText(): string;
+    /** Диалог ввода текста сноски, затем вставка маркера. */
+    private openFootnotePrompt;
+    /** Публичный API: вставить сноску / получить тексты сносок / вставить оглавление. */
+    insertFootnote(text: string): void;
+    getFootnotes(): string[];
+    insertTableOfContents(): void;
+    /** Набор быстрых стилей: тип блока + интервалы + превью для галереи. */
+    private styleGallery;
+    /** Галерея стилей - выпадающая панель с превью каждого стиля. */
+    private openStyleGallery;
+    /** Диалог ввода комментария к выделению. */
+    private openCommentPrompt;
+    private onCommentClick;
+    /** Попап комментария: текст + кнопка «Разрешить». */
+    private openCommentPopup;
+    /** Публичный API комментариев. */
+    addComment(text: string, author?: string): string | null;
+    getComments(): {
+        id: string;
+        text: string;
+        author: string | null;
+    }[];
+    resolveComment(id: string): void;
+    setTrackChanges(on: boolean): void;
+    isTrackingChanges(): boolean;
+    markDeletion(): void;
+    acceptAllChanges(): void;
+    rejectAllChanges(): void;
+    getChangeCount(): {
+        insertions: number;
+        deletions: number;
+    };
+    private versionSeq;
+    private versionsKey;
+    private readVersions;
+    private writeVersions;
+    /** Сохранить снимок текущего документа как именованную версию. */
+    saveVersion(name?: string): void;
+    getVersions(): {
+        id: string;
+        name: string;
+        ts: number;
+        html: string;
+    }[];
+    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 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.
+     */
+    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
+     * их уже собирал; хост может их показать пользователю или проигнорировать.
+     */
+    importDocx(source: File | ArrayBuffer): Promise<DocxImportResult | undefined>;
+    /** Публичный API: импорт файла (.docx/.csv/.txt/.md/картинка) с автодетектом. */
+    importFile(file: File): Promise<void>;
+    /** Публичный API: экспорт в Markdown (скачивание .md). */
+    exportMarkdown(): void;
+    /** Публичный API: экспорт в HTML / TXT / CSV / Word (.doc). Client-side. */
+    exportHtml(): void;
+    exportText(): void;
+    exportCsv(): void;
+    exportWord(): void;
+    /** Публичный API: импорт PDF как картинок (страницы -> изображения). */
+    importPdfAsImages(file: File): Promise<void>;
+    /** Публичный API: встроить PDF «как есть» (iframe, client-side). */
+    importPdfAsEmbed(file: File): Promise<void>;
+    /** Публичный API: следующая вставка - только текст. */
+    armPlainPaste(): void;
+    /**
+     * Публичный API: вставка «богатого» буфера из companion-расширения
+     * (полный HTML + RTF в обход песочницы). Расширение зовёт этот метод
+     * напрямую или через DOM-событие `koda-paste-rich`.
+     */
+    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). */
+    exportPdf(): void;
+    /** value - как у нативного поля: чтение/запись HTML. Работает с v-model. */
+    get value(): string;
+    set value(html: string);
+    /** Сброс формы (<form>.reset() или кнопка type=reset) - очищаем редактор. */
+    formResetCallback(): void;
+    /** Переключить полноэкранный режим (на весь экран, без сервера/прав). */
+    toggleFullscreen(): void;
+    /** Панель найти/заменить (скрыта по умолчанию). */
+    private buildSearchBar;
+    /** Показать/скрыть панель поиска. */
+    toggleSearch(show?: boolean): void;
+}
+/**
+ * Регистрирует <koda-editor>. Идемпотентно по конкретному тегу.
+ * Для произвольного тега используется анонимный подкласс - один класс
+ * нельзя зарегистрировать под двумя именами (define бросит ошибку).
+ */
+export declare function defineKodaEditor(tag?: string): void;
+export {};

package/dist/xlsx-import-cdn.d.ts

@@ -0,0 +1 @@
+export declare function xlsxToHtml(data: ArrayBuffer): Promise<string>;

package/dist/xlsx-import.d.ts

@@ -0,0 +1,2 @@
+/** .xlsx/.xls -> HTML (таблица на лист). */
+export declare function xlsxToHtml(data: ArrayBuffer): Promise<string>;

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@kodaeditor/core",
+  "version": "1.0.0",
+  "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",
+    "rich-text-editor",
+    "editor",
+    "word-paste",
+    "docx",
+    "html-editor",
+    "prosemirror",
+    "web-component",
+    "custom-element",
+    "xlsx",
+    "pdf-import",
+    "self-hosted"
+  ],
+  "homepage": "https://kodaeditor.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mynameisilhom/editoruz-core.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "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",
+      "import": "./dist/kodaeditor.js",
+      "require": "./dist/kodaeditor.umd.cjs"
+    },
+    "./light": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/kodaeditor-core.umd.cjs"
+    },
+    "./vendor/*": "./dist/vendor/*"
+  },
+  "files": [
+    "dist",
+    "THIRD-PARTY-LICENSES.txt",
+    "LICENSE.md"
+  ],
+  "scripts": {
+    "clean": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "build": "npm run clean && tsc -p tsconfig.json && 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",
+    "javascript-obfuscator": "^5.7.0",
+    "jsdom": "^29.1.1",
+    "jszip": "^3.10.2",
+    "mammoth": "^1.12.0",
+    "marked": "^18.0.12",
+    "pdfjs-dist": "^6.0.227",
+    "prosemirror-commands": "^1.6.0",
+    "prosemirror-history": "^1.4.1",
+    "prosemirror-keymap": "^1.2.2",
+    "prosemirror-model": "^1.23.0",
+    "prosemirror-schema-basic": "^1.2.3",
+    "prosemirror-schema-list": "^1.4.1",
+    "prosemirror-state": "^1.4.3",
+    "prosemirror-tables": "^1.8.5",
+    "prosemirror-view": "^1.34.3",
+    "turndown": "^7.2.4",
+    "turndown-plugin-gfm": "^1.0.2",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0",
+    "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz"
+  },
+  "license": "SEE LICENSE IN LICENSE.md"
+}