@kodaeditor/core 1.0.0

package/dist/toc-view.d.ts

@@ -0,0 +1,23 @@
+/**
+ * NodeView оглавления: наполняется динамически из заголовков документа.
+ * Сам toc-узел — atom (без редактируемого содержимого); список строится по
+ * h1–h6. Перерисовывается при изменении документа (Editor зовёт refresh() из
+ * dispatchTransaction). Клик по пункту прокручивает к заголовку.
+ */
+import type { NodeView } from 'prosemirror-view';
+import type { EditorView } from 'prosemirror-view';
+import type { Node as PMNode } from 'prosemirror-model';
+export declare class TocView implements NodeView {
+    readonly dom: HTMLElement;
+    private node;
+    private view;
+    private title;
+    private registry;
+    constructor(node: PMNode, view: EditorView, title: string, registry: Set<TocView>);
+    refresh(): void;
+    private render;
+    private scrollTo;
+    update(node: PMNode): boolean;
+    ignoreMutation(): boolean;
+    destroy(): void;
+}

package/dist/toolbar-editor.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Редактор панели «карандаш» - настройка тулбара прямо на месте, без диалога:
+ *  - drag-and-drop: кнопки перетаскиваются по панели и из палитры снизу;
+ *  - × убирает кнопку (она возвращается в палитру доступных);
+ *  - группы: кнопка-группа с обложкой+названием и вложенными кнопками, можно
+ *    группировать/разгруппировать, перетаскивать кнопки в группу и из неё;
+ *  - обложка группы: иконка из пакета панели / emoji / загруженное изображение.
+ *
+ * Во время редактирования источник правды - DOM (chips в контейнерах). При
+ * «Готово» раскладка считывается из DOM и сохраняется хостом.
+ */
+import type { Strings } from './i18n';
+import { type GroupIconKind } from './group-icons';
+/** Группа панели: обложка + название + вложенные кнопки (один уровень). */
+export interface GroupSpec {
+    type: 'group';
+    icon: string;
+    iconKind: GroupIconKind;
+    label: string;
+    items: string[];
+}
+/** Запись раскладки: токен кнопки/разделителя ('|') или группа. */
+export type LayoutEntry = string | GroupSpec;
+export declare function isGroupSpec(e: unknown): e is GroupSpec;
+/** Что редактору нужно от хоста (web-component), чтобы не зависеть от него напрямую. */
+export interface ToolbarEditorHost {
+    shell: HTMLElement;
+    toolbar: HTMLElement;
+    strings: Strings;
+    currentEntries(): LayoutEntry[];
+    allTokens(): string[];
+    tokenLabel(token: string): string;
+    tokenIcon(token: string): string;
+    save(entries: LayoutEntry[]): void;
+    reset(): void;
+}
+export declare class ToolbarEditor {
+    private host;
+    private active;
+    private overlay?;
+    private editRow?;
+    private palette?;
+    private drag?;
+    private onMove;
+    private onUp;
+    private onKey;
+    constructor(host: ToolbarEditorHost);
+    isActive(): boolean;
+    open(): void;
+    /** Сброс к дефолтной раскладке: чистим сохранённую + перерисовываем чипы. */
+    private resetLayout;
+    private done;
+    /**
+     * Принудительно закрыть снаружи: вызывается при отключении редактора от
+     * DOM. Без этого открытая палитра оставляла на document слушатель keydown,
+     * который держал в памяти весь отсоединённый редактор.
+     */
+    destroy(): void;
+    private close;
+    private readback;
+    private readGroupChip;
+    private buildEntryChip;
+    /** Перетаскиваемая «фишка» обычной кнопки/разделителя. */
+    private buildTokenChip;
+    /** Капсула группы в режиме редактирования: обложка, название, вложенные chips, controls. */
+    private buildGroupChip;
+    private addRemoveBtn;
+    private createGroup;
+    private ungroup;
+    private editGroup;
+    private refreshPalette;
+    private buildPaletteChip;
+    private addToken;
+    private makeDraggable;
+    private startDrag;
+    private positionGhost;
+    private handleMove;
+    /** Ближайшая фишка-сосед в зоне, перед которой вставлять (по X-середине). */
+    private nearestChip;
+    private handleUp;
+    private endDrag;
+    private cancelDrag;
+    private openIconPicker;
+    private iconCell;
+    /** Файл → нормализованный data-URL (контейн 64×64 PNG), чтобы не раздувать localStorage. */
+    private fileToIcon;
+    private actionBtn;
+    private esc;
+}

package/dist/validate-signature.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Проверка подписи ответа license-сервера.
+ *
+ * Зачем. Ветка «лицензия подтверждена по кэшу» опирается на localStorage, то
+ * есть на данные, которые клиент пишет сам. Без подписи обход выглядит так:
+ * закрыть наш домен в hosts, положить одну запись в localStorage - и выгрузки
+ * чистые навсегда. Существенно, что это ЛЕГЧЕ, чем снять пометку из кода:
+ * патчить бандл умеет разработчик, подделать localStorage - любой по
+ * инструкции. Подписанный ответ поднимает цену подделки до обладания нашим
+ * приватным ключом.
+ *
+ * Пара для этих подписей ОТДЕЛЬНАЯ, не та, которой подписываются офлайн-
+ * лицензии. Причина несимметричности ущерба: приватный ключ офлайн-пары
+ * сознательно не лежит на боевом сервере (см. .env.example license-сервера),
+ * потому что его кража позволяет печатать бессрочные лицензии на любой домен,
+ * а отозвать их нечем - офлайн-лицензии к нам не обращаются никогда. Ключ для
+ * подписи ответов, наоборот, обязан лежать на сервере, смотрящем в интернет;
+ * его компрометация стоит ровно перевыпуска пары и обновления константы.
+ *
+ * Формат: ECDSA P-256 / SHA-256, подпись raw IEEE-P1363 (r||s, 64 байта) в
+ * base64url - то, что принимает Web Crypto. Node подписывает в DER по
+ * умолчанию, поэтому серверу нужен { dsaEncoding: 'ieee-p1363' }.
+ */
+/**
+ * Публичная половина пары, которой license-сервер подписывает ответы /validate.
+ * Не секрет по своей природе: нужна только для проверки подписи, не для её
+ * создания. Приватная лежит на сервере лицензий в отдельном каталоге, НЕ рядом
+ * с keys.json - скрипт бэкапа архивирует весь каталог данных и отправляет в
+ * Telegram, так что ключ по соседству уехал бы в мессенджер первым же ночным
+ * бэкапом.
+ */
+export declare const VALIDATE_PUBLIC_KEY_SPKI_B64: string;
+/** Ответ /validate в подписанном виде. */
+export interface SignedAnswer {
+    valid: boolean;
+    plugins: string[];
+    /** Момент подписи на сервере, unix-секунды. Подделать нельзя - он под подписью. */
+    at: number;
+    /** base64url, raw IEEE-P1363. */
+    sig: string;
+}
+/**
+ * Каноническая строка, над которой считается подпись.
+ *
+ * Плагины сортируются: порядок приходит из хранилища сервера и может
+ * измениться при любой его правке, а несовпадение порядка ломало бы подпись
+ * только у клиентов с двумя и более плагинами - дефект плавающий и
+ * мучительный в отладке.
+ *
+ * Разделитель `|` безопасен: его нет ни в ключе (там A-Z, 0-9 и дефис), ни в
+ * домене, ни в именах плагинов. Иначе подпись можно было бы переклеить между
+ * полями, сдвинув границу.
+ */
+export declare function canonicalAnswer(key: string, domain: string, valid: boolean, plugins: string[], at: number): string;
+/**
+ * Проверяет подпись ответа сервера. Никогда не бросает: любая проблема -
+ * битая base64, чужая подпись, отсутствующее поле - это `false`.
+ *
+ * Мягкого режима нет намеренно: если принимать ответы без подписи, обход
+ * сводится к тому, чтобы отдать ответ без неё, и вся защита исчезает. Из
+ * этого следует порядок выката - сервер начинает подписывать РАНЬШЕ, чем
+ * выходит ядро с этой проверкой.
+ */
+export declare function verifyAnswerSignature(publicKeySpkiB64: string, answer: SignedAnswer, key: string, domain: string): Promise<boolean>;