@vervedoc/core 3.0.11 → 3.3.11

package/dist/docx-editor.d.ts

@@ -0,0 +1,110 @@
+import { IDocxDocumentMeta, IEditorOption, EditorPlugin } from '@vervedoc/docx-editor-schema';
+import { EventBus, Listener, RangeManager } from '@vervedoc/docx-editor-state';
+import { Draw } from '@vervedoc/docx-editor-view';
+import { Command } from '@vervedoc/docx-editor-transform';
+import { Search, BlockParticle, DateParticle, LaTexParticle, ControlComponent } from '@vervedoc/docx-editor-commands';
+import { HistoryComponent } from '@vervedoc/docx-editor-history';
+import { WorkerManager } from './workers/worker-manager';
+/**
+ * DocxEditor 文档编辑器主类
+ *
+ * 全新构造，零兼容：只接受 IDocxDocumentMeta。
+ * 组合 Listener / EventBus / RangeManager / Draw / Command / Comment / Revision / Search 等组件。
+ */
+export declare class DocxEditor {
+    /** 事件监听器（content/range/page/catalog 等命名空间） */
+    listener: Listener;
+    /** 全局事件总线（hyperlinkMenuClick / chartClick 等右键菜单事件） */
+    eventBus: EventBus;
+    /** 选区管理器（anchor/focus 位置与折叠/展开） */
+    range: RangeManager;
+    /** 视图绘制引擎（布局 + Canvas 渲染 + 交互） */
+    draw: Draw;
+    /** 命令入口（executeXxx 系列方法） */
+    command: Command;
+    private adapt;
+    private destroyed;
+    private clipboardEpoch;
+    private clipboardGuard;
+    /** 已注册插件表（按 name 索引） */
+    private plugins;
+    /** 插件命令注册表（命令名 → 处理函数），责任链中插件命令 handler 查此表分发 */
+    private pluginCommands;
+    /** 命令分发责任链 */
+    private commandChain;
+    /** 插件宿主契约实例，构造完成后赋值，use(plugin) 时注入给插件 */
+    private pluginHost;
+    /** 搜索组件 */
+    search: Search;
+    /** 块级粒子组件（图片/视频/音频/图表等块级元素） */
+    block: BlockParticle;
+    /** 日期粒子组件 */
+    date: DateParticle;
+    /** LaTeX 公式粒子组件 */
+    laTex: LaTexParticle;
+    /** 控件组件（checkbox/radio/dropdown 等） */
+    control: ControlComponent;
+    /** 历史管理组件（撤销/重做） */
+    history: HistoryComponent;
+    /** Worker 管理器（后台计算目录/搜索等） */
+    worker: WorkerManager;
+    private thumbnailWorker;
+    private thumbnailSources;
+    /**
+     * 构造 DocxEditor 实例
+     * @param container 编辑器挂载的 DOM 容器（必须为 HTMLDivElement）
+     * @param document 文档元数据（必须包含 elements 数组，不再兼容 IElement[] / IEditorData）
+     * @param options 编辑器选项（字体/字号/页边距等，缺省时自动合并默认值）
+     * @throws {TypeError} container 非 HTMLDivElement 或 document 非 IDocxDocumentMeta 时抛出
+     */
+    constructor(container: HTMLDivElement, document: IDocxDocumentMeta, options?: IEditorOption);
+    /**
+     * 订阅 after-render 生命周期事件，集中管理渲染后各组件的联动。
+     *
+     * Draw 只 emit `after-render` 事件，不直接调用插件/block/control/worker，
+     * 已注册插件的 `hooks.afterRender` 在此遍历调用，核心组件联动也在此集中订阅。
+     */
+    private wireAfterRenderHooks;
+    private refreshThumbnailAppearance;
+    /**
+     * 渲染嵌入块（iframe）：遍历 layout 中 kind === 'block' 的节点，
+     * 调 BlockParticle.render 挂载/复用 DOM。chart 已由 canvas drawImage 渲染，不在此处理。
+     */
+    private renderEmbedBlocks;
+    /**
+     * 获取当前文档元数据
+     * @returns 文档元数据（含 elements/sections/comments 等）
+     */
+    getDocument(): IDocxDocumentMeta;
+    /**
+     * 设置文档元数据，重置 zone 到 main 并通知插件同步数据
+     * @param doc 文档元数据（必须包含 elements 数组）
+     * @throws {TypeError} doc 非 IDocxDocumentMeta 时抛出
+     */
+    setDocument(doc: IDocxDocumentMeta): void;
+    /**
+     * 注册插件。core 在注册时自动注入 PluginHost、登记命令表；
+     * 若文档已加载，立即触发 `hooks.onSetDocument` 以同步初始数据。
+     *
+     * 核心引擎（view/transform）保持内置硬编码，不通过此方法注册。
+     *
+     * @param plugin 满足 EditorPlugin 契约的插件实例
+     */
+    use(plugin: EditorPlugin): void;
+    /**
+     * 获取已注册插件实例，供宿主层调用插件特有方法。
+     *
+     * @param name 插件名称
+     * @returns 插件实例，未注册时返回 undefined
+     */
+    getPlugin<T extends EditorPlugin>(name: string): T | undefined;
+    /**
+     * 分发命令到责任链（供宿主层触发插件命令）
+     */
+    dispatchCommand(command: string, ...args: any[]): any;
+    /**
+     * 销毁编辑器实例，释放所有资源（DOM/事件监听/定时器/组件/插件）
+     */
+    destroy(): void;
+}
+export default DocxEditor;

package/dist/index.d.ts

@@ -1,26 +1,23 @@
-import { default as DocxEditor } from './DocxEditor';
+import { default as DocxEditor } from './docx-editor';
 export default DocxEditor;
+export { DocxEditor };
+export { DocxEditor as Editor };
 export * from '@vervedoc/docx-editor-schema';
-export { Listener, RangeManager, EventBus } from '@vervedoc/docx-editor-state';
+export type { TitleLevel } from '@vervedoc/docx-editor-schema';
+export * from './constants';
+export { WorkerManager } from './workers/worker-manager';
+export type { TocResult, SearchResult } from './workers/worker-manager';
+export { EventBus, Listener, RangeManager } from '@vervedoc/docx-editor-state';
+export type { IRangeStyle, IEditorAbility, ListenerMap, EventHandler } from '@vervedoc/docx-editor-schema';
+export { Draw, LayoutEngine, CanvasRenderer, TextMeasure, getSharedMeasure, hitTest } from '@vervedoc/docx-editor-view';
+export type { DocumentLayout, PageLayout, BlockNode, ParagraphBlock, ImageBlock, PageBreakBlock, TableBlock, TableRowLayout, TableCellLayout, LineBox, InlineBox, Rect } from '@vervedoc/docx-editor-view';
 export { Command, CommandAdapt } from '@vervedoc/docx-editor-transform';
-export type { IDrawContext, ICursorContext, IBadgeContext, IZoneContext, IListParticleContext, IHyperlinkParticleContext, IGroupContext, IAreaContext, IRegisterContext, IPreviewerContext, ISearchContext, IEventBusContext, IWorkerManagerContext } from '@vervedoc/docx-editor-transform';
-export { BaseCommandAdapter, BaseAdapter, TextStyleAdapter, ParagraphAdapter, TableAdapter, PageAdapter } from '@vervedoc/docx-editor-transform';
-export type { IAdapterContext } from '@vervedoc/docx-editor-transform';
-export { Draw, Cursor, CursorAgent, Position, CanvasEvent, GlobalEvent, ImageObserver, MouseObserver, ScrollObserver, SelectionObserver, TextParticle, ImageParticle, HyperlinkParticle, SeparatorParticle, PageBreakParticle, ListParticle, SuperscriptParticle, SubscriptParticle, LineBreakParticle, CheckboxParticle, RadioParticle, TableParticle, TableOperate, TableTool, Previewer, Background, Badge, Footer, Header, LineNumber, Margin, PageBorder, PageNumber, Placeholder, Watermark, AbstractRichText, Highlight, ParagraphColor, Strikeout, Underline, Area, Group, FloatingBar, Override, Register } from '@vervedoc/docx-editor-view';
-export type { Plugin, IParticleRegistry, IHistoryProvider, ISearchProvider, IControlProvider } from '@vervedoc/docx-editor-view';
-export * from '@vervedoc/docx-editor-history';
-export { Shortcut, KeymapComponent } from '@vervedoc/docx-editor-keymap';
-export { Control, CheckboxControl, RadioControl, TextControl, SelectControl, DateControl, NumberControl, ControlSearch, ControlBorder, DateParticle, DatePicker, LaTexParticle, Search, BlockParticle, ControlComponent, GadgetComponent } from '@vervedoc/docx-editor-commands';
-export { WorkerManager } from './worker/WorkerManager';
-export { WorkerComponent } from './worker/WorkerComponent';
-export { I18n } from './i18n/I18n';
-export { Actuator } from './actuator/Actuator';
-export type { AutoSaveOptions } from './actuator/Actuator';
-export { ExportComponent } from './export/ExportComponent';
-export { CommentComponent, RevisionComponent } from '@vervedoc/docx-editor-comment';
-export type { DocxCommentMeta, RevisionCallbacks } from '@vervedoc/docx-editor-comment';
-export { getClipboardData, getIsClipboardContainFile, removeClipboardData } from './utils/clipboard';
-export { version } from '../package.json';
-export { DocxParser, createDocxParser, parseDocx } from './docxParser/index';
-export type { IDocxParseResult, IDocxParseOptions, IChartRenderer } from './docxParser/types';
-export { default as Editor } from './DocxEditor';
+export type { IHistoryManager, HistorySnapshot } from '@vervedoc/docx-editor-schema';
+export { CommandChain } from './command-chain';
+export type { CommandHandler, CommandNext } from './command-chain';
+export { HistoryManager, HistoryComponent, createSnapshot } from '@vervedoc/docx-editor-history';
+export type { HistorySnapshot as HistorySnapshotType } from '@vervedoc/docx-editor-history';
+export { Search, BlockParticle, DateParticle, LaTexParticle, ControlComponent } from '@vervedoc/docx-editor-commands';
+export type { ISearchResult, IReplaceOption, INavigateInfo, IElementPosition } from '@vervedoc/docx-editor-schema';
+/** VerveDocs Core 版本号 */
+export declare const version = "4.0.0-tree";

package/dist/shortcut.d.ts

@@ -0,0 +1,60 @@
+import { Draw } from '@vervedoc/docx-editor-view';
+import { Command, CommandAdapt } from '@vervedoc/docx-editor-transform';
+import { RangeManager } from '@vervedoc/docx-editor-state';
+/** 快捷键处理器依赖注入接口 */
+export interface ShortcutDeps {
+    /** 获取 Draw 视图实例 */
+    getDraw: () => Draw;
+    /** 获取 Command 命令实例 */
+    getCommand: () => Command;
+    dispatchCommand: (command: string, ...args: any[]) => any;
+    /** 获取 RangeManager 选区管理器 */
+    getRange: () => RangeManager;
+    /** 获取 CommandAdapt 适配器（可能未初始化） */
+    getAdapt: () => CommandAdapt | null;
+}
+/** 键盘快捷键处理器，分编辑/光标/格式/历史四组 */
+export declare class ShortcutHandler {
+    /** 依赖注入 */
+    private deps;
+    /**
+     * 构造快捷键处理器
+     * @param deps 依赖注入对象
+     */
+    constructor(deps: ShortcutDeps);
+    /**
+     * 处理键盘事件，依次尝试编辑/光标/格式/历史四组快捷键
+     * @param e 键盘事件
+     */
+    handle: (e: KeyboardEvent) => void;
+    /**
+     * 处理编辑类快捷键（复制/剪切/粘贴/全选/删除/Enter/Tab/Escape）
+     * @param e 键盘事件
+     * @param adapt 命令适配器
+     * @param draw 视图实例
+     * @returns 是否已处理该事件
+     */
+    private handleEditKeys;
+    /**
+     * 处理光标移动快捷键（方向键/Home/End/PageUp/PageDown，含 Ctrl 词移动/文档首尾）
+     * @param e 键盘事件
+     * @param adapt 命令适配器
+     * @param draw 视图实例
+     * @returns 是否已处理该事件
+     */
+    private handleCursorKeys;
+    /**
+     * 处理格式快捷键（加粗/斜体/下划线/删除线/字号/对齐/列表/标题/清除格式）
+     * @param e 键盘事件
+     * @param command 命令实例
+     * @returns 是否已处理该事件
+     */
+    private handleFormatKeys;
+    /**
+     * 处理历史快捷键（撤销/重做/分页）
+     * @param e 键盘事件
+     * @param command 命令实例
+     * @returns 是否已处理该事件
+     */
+    private handleHistoryKeys;
+}

package/dist/workers/compute.d.ts

@@ -0,0 +1,17 @@
+import { IElement, PathSegment } from '@vervedoc/docx-editor-schema';
+export declare function computeToc(elements: IElement[]): {
+    toc: {
+        id: string;
+        level: number;
+        name: string;
+        number?: string;
+    }[];
+};
+export declare function computeSearch(elements: IElement[], keyword: string): {
+    results: {
+        path: PathSegment[];
+        offset: number;
+        length: number;
+    }[];
+    count: number;
+};

package/dist/workers/thumbnail-manager.d.ts

@@ -0,0 +1,19 @@
+/** Background composition is isolated from document search/TOC work. */
+export declare class ThumbnailManager {
+    private publish;
+    private worker;
+    private epoch;
+    private sources;
+    private color;
+    private scheduled;
+    private sourcesDirty;
+    private disposed;
+    private failed;
+    private invalidated;
+    constructor(publish: (images: string[]) => void);
+    invalidate(): void;
+    update(sources: string[], color: string): void;
+    private flush;
+    private fail;
+    destroy(): void;
+}

package/dist/workers/worker-manager.d.ts

@@ -0,0 +1,44 @@
+import { IElement, PathSegment } from '@vervedoc/docx-editor-schema';
+export interface TocResult {
+    toc: {
+        id: string;
+        level: number;
+        name: string;
+        number?: string;
+    }[];
+}
+export interface SearchResult {
+    results: {
+        path: PathSegment[];
+        offset: number;
+        length: number;
+    }[];
+    count: number;
+}
+type TocListener = (result: TocResult) => void;
+type SearchListener = (result: SearchResult) => void;
+type CloneListener = (data: unknown) => void;
+type ErrorListener = (message: string) => void;
+export declare class WorkerManager {
+    private worker;
+    private failed;
+    private destroyed;
+    private pending;
+    private elements;
+    private tocListeners;
+    private searchListeners;
+    private cloneListeners;
+    private errorListeners;
+    init(): void;
+    private fallback;
+    updateElements(elements: IElement[]): void;
+    private flush;
+    search(keyword: string): void;
+    clone(data: unknown): void;
+    onTocResult(listener: TocListener): () => void;
+    onSearchResult(listener: SearchListener): () => void;
+    onCloneResult(listener: CloneListener): () => void;
+    onError(listener: ErrorListener): () => void;
+    destroy(): void;
+}
+export {};

package/package.json

@@ -1,60 +1,55 @@
-{
-  "name": "@vervedoc/core",
-  "version": "3.0.11",
-  "description": "VerveDoc Core 核心编辑器库",
-  "author": "wanghe",
-  "license": "MIT",
-  "type": "module",
-  "main": "./dist/core.umd.cjs",
-  "module": "./dist/core.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/core.js",
-      "require": "./dist/core.umd.cjs"
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "package.json"
-  ],
-  "scripts": {
-    "dev": "vite",
-    "clean": "node -e \"const fs = require('fs'); if(fs.existsSync('dist')) fs.rmSync('dist', {recursive: true})\"",
-    "build": "npm run clean && tsc && vite build",
-    "preview": "vite preview",
-    "type:check": "tsc --noEmit"
-  },
-  "devDependencies": {
-    "@eslint/js": "^10.0.1",
-    "@types/node": "^25.3.3",
-    "eslint": "^10.4.0",
-    "eslint-plugin-unused-imports": "^4.4.1",
-    "typescript": "^5.0.0",
-    "typescript-eslint": "^8.59.4",
-    "vite": "^6.4.3",
-    "vite-plugin-css-injected-by-js": "^3.0.0",
-    "vite-plugin-dts": "^4.5.4"
-  },
-  "engines": {
-    "node": ">=16.0.0"
-  },
-  "dependencies": {
-    "@vervedoc/docx-editor-commands": "1.0.4",
-    "@vervedoc/docx-editor-comment": "1.0.7",
-    "@vervedoc/docx-editor-history": "1.0.8",
-    "@vervedoc/docx-editor-keymap": "1.0.5",
-    "@vervedoc/docx-editor-schema": "1.0.9",
-    "@vervedoc/docx-editor-state": "1.0.3",
-    "@vervedoc/docx-editor-transform": "1.0.8",
-    "@vervedoc/docx-editor-view": "1.0.5",
-    "docx": "^9.1.0",
-    "jszip": "^3.10.1",
-    "vanilla-picker": "^2.12.3"
-  }
-}
+{
+  "name": "@vervedoc/core",
+  "version": "3.3.11",
+  "description": "VerveDoc Core 核心编辑器库（Canvas 2D 高性能实现）",
+  "author": "wanghe",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/core.umd.cjs",
+  "module": "./dist/core.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/core.js",
+      "require": "./dist/core.umd.cjs"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.10.0",
+    "eslint": "^10.4.0",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "typescript": "~5.6.2",
+    "typescript-eslint": "^8.59.4",
+    "vite": "^6.4.3",
+    "vite-plugin-css-injected-by-js": "^3.0.0",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "@vervedoc/docx-editor-schema": "^1.0.10",
+    "@vervedoc/docx-editor-view": "^1.0.6",
+    "@vervedoc/docx-editor-state": "^1.0.4",
+    "@vervedoc/docx-editor-transform": "^1.0.9",
+    "@vervedoc/docx-editor-history": "^1.0.9",
+    "@vervedoc/docx-editor-commands": "^1.0.5"
+  },
+  "scripts": {
+    "dev": "vite",
+    "clean": "node -e \"const fs = require('fs'); if(fs.existsSync('dist')) fs.rmSync('dist', {recursive: true})\"",
+    "build": "pnpm run clean && tsc && vite build",
+    "preview": "vite preview",
+    "type:check": "tsc --noEmit"
+  }
+}

package/dist/DocxEditor.d.ts

@@ -1,17 +0,0 @@
-import { IEditorData, IEditorOption, IElement, EventBusMap, UsePlugin } from '@vervedoc/docx-editor-schema';
-import { Command } from '@vervedoc/docx-editor-transform';
-import { Listener, EventBus } from '@vervedoc/docx-editor-state';
-import { Register, Override } from '@vervedoc/docx-editor-view';
-import { CommentComponent, RevisionComponent } from '@vervedoc/docx-editor-comment';
-export default class DocxEditor {
-    command: Command;
-    listener: Listener;
-    eventBus: EventBus<EventBusMap>;
-    override: Override;
-    register: Register;
-    comment: CommentComponent;
-    revision: RevisionComponent;
-    destroy: () => void;
-    use: UsePlugin;
-    constructor(container: HTMLDivElement, data: IEditorData | IElement[], options?: IEditorOption);
-}

package/dist/actuator/Actuator.d.ts

@@ -1,22 +0,0 @@
-export interface AutoSaveOptions {
-    interval?: number;
-    enabled?: boolean;
-    isReadonly?: () => boolean;
-    onSave: (content: any) => void | Promise<void>;
-    getContent: () => any;
-}
-export declare class Actuator {
-    private _saveTimer;
-    private _saving;
-    private _pendingSave;
-    private _autoSaveOptions;
-    install(): this;
-    configureAutoSave(options: AutoSaveOptions): void;
-    saveNow(_options?: {
-        silent?: boolean;
-    }): Promise<void>;
-    scheduleSave(): void;
-    stopAutoSave(): void;
-    isSaving(): boolean;
-    destroy(): void;
-}