@netless/appliance-plugin 1.1.28 → 1.1.30-beta.0

package/dist/ObserverMap-BudneEfB.mjs

@@ -0,0 +1,58 @@
+var o = Object.defineProperty;
+var h = (r, e, s) => e in r ? o(r, e, { enumerable: !0, configurable: !0, writable: !0, value: s }) : r[e] = s;
+var a = (r, e, s) => h(r, typeof e != "symbol" ? e + "" : e, s);
+class p {
+  constructor(e) {
+    a(this, "_map");
+    a(this, "_observers", /* @__PURE__ */ new Set());
+    this._map = new Map(e);
+  }
+  notifyObservers(e, s, t) {
+    for (const i of this._observers)
+      i(e, s, t);
+  }
+  observe(e) {
+    this._observers.add(e);
+  }
+  unobserve(e) {
+    this._observers.delete(e);
+  }
+  get(e) {
+    return this._map.get(e);
+  }
+  set(e, s, t = !0) {
+    const i = this._map.has(e) ? "update" : "add";
+    return this._map.set(e, s), t && this.notifyObservers(i, e, s), this;
+  }
+  has(e) {
+    return this._map.has(e);
+  }
+  delete(e, s = !0) {
+    const t = this._map.get(e), i = this._map.delete(e);
+    return s && t && this.notifyObservers("delete", e, t), i;
+  }
+  clear(e = !0) {
+    const s = this._map.keys();
+    if (this._map.clear(), e)
+      for (const t of s)
+        this.notifyObservers("clear", t, void 0);
+  }
+  get size() {
+    return this._map.size;
+  }
+  keys() {
+    return this._map.keys();
+  }
+  values() {
+    return this._map.values();
+  }
+  entries() {
+    return this._map.entries();
+  }
+  forEach(e, s) {
+    this._map.forEach(e, s);
+  }
+}
+export {
+  p as O
+};

package/dist/ObserverMap-DTz9zucn.js

@@ -0,0 +1 @@
+"use strict";var o=Object.defineProperty;var h=(r,e,s)=>e in r?o(r,e,{enumerable:!0,configurable:!0,writable:!0,value:s}):r[e]=s;var a=(r,e,s)=>h(r,typeof e!="symbol"?e+"":e,s);class n{constructor(e){a(this,"_map");a(this,"_observers",new Set);this._map=new Map(e)}notifyObservers(e,s,t){for(const i of this._observers)i(e,s,t)}observe(e){this._observers.add(e)}unobserve(e){this._observers.delete(e)}get(e){return this._map.get(e)}set(e,s,t=!0){const i=this._map.has(e)?"update":"add";return this._map.set(e,s),t&&this.notifyObservers(i,e,s),this}has(e){return this._map.has(e)}delete(e,s=!0){const t=this._map.get(e),i=this._map.delete(e);return s&&t&&this.notifyObservers("delete",e,t),i}clear(e=!0){const s=this._map.keys();if(this._map.clear(),e)for(const t of s)this.notifyObservers("clear",t,void 0)}get size(){return this._map.size}keys(){return this._map.keys()}values(){return this._map.values()}entries(){return this._map.entries()}forEach(e,s){this._map.forEach(e,s)}}exports.ObserverMap=n;

package/dist/appliance-plugin.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-DBSetQlP.js");exports.ActiveContainerType=e.ActiveContainerType;exports.ApplianceMultiPlugin=e.ApplianceMultiPlugin;exports.ApplianceNames=e.ApplianceNames;exports.ApplianceSigleWrapper=e.ApplianceSigleWrapper;exports.ApplianceSinglePlugin=e.ApplianceSinglePlugin;exports.Cursor_Hover_Id=e.Cursor_Hover_Id;exports.ECanvasShowType=e.ECanvasShowType;exports.EDataType=e.EDataType;exports.EForceStopReason=e.EForceStopReason;exports.EImageType=e.EImageType;exports.EMatrixrRelationType=e.EMatrixrRelationType;exports.EOperationType=e.EOperationType;exports.EPostMessageType=e.EPostMessageType;exports.ERenderFilterType=e.ERenderFilterType;exports.EScaleType=e.EScaleType;exports.EStrokeType=e.EStrokeType;exports.EToolsKey=e.EToolsKey;exports.ElayerType=e.ElayerType;exports.EmitEventType=e.EmitEventType;exports.EventMessageType=e.EventMessageType;exports.EvevtWorkState=e.EvevtWorkState;exports.EvevtWorkType=e.EvevtWorkType;exports.InternalMsgEmitterType=e.InternalMsgEmitterType;exports.Main_View_Id=e.Main_View_Id;exports.Plugin=e.Plugin;exports.ShapeType=e.ShapeType;exports.Task_Time_Interval=e.Task_Time_Interval;exports.fullWorkerUrl=e.fullWorker;exports.subWorkerUrl=e.subWorker;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-GdF83s93.js");exports.ActiveContainerType=e.ActiveContainerType;exports.ApplianceMultiPlugin=e.ApplianceMultiPlugin;exports.ApplianceNames=e.ApplianceNames;exports.ApplianceSigleWrapper=e.ApplianceSigleWrapper;exports.ApplianceSinglePlugin=e.ApplianceSinglePlugin;exports.Cursor_Hover_Id=e.Cursor_Hover_Id;exports.ECanvasShowType=e.ECanvasShowType;exports.EDataType=e.EDataType;exports.EForceStopReason=e.EForceStopReason;exports.EImageType=e.EImageType;exports.EMatrixrRelationType=e.EMatrixrRelationType;exports.EOperationType=e.EOperationType;exports.EPostMessageType=e.EPostMessageType;exports.ERenderFilterType=e.ERenderFilterType;exports.ESVGType=e.ESVGType;exports.EScaleType=e.EScaleType;exports.EStrokeType=e.EStrokeType;exports.EToolsKey=e.EToolsKey;exports.ElayerType=e.ElayerType;exports.EmitEventType=e.EmitEventType;exports.EventMessageType=e.EventMessageType;exports.EvevtWorkState=e.EvevtWorkState;exports.EvevtWorkType=e.EvevtWorkType;exports.InternalMsgEmitterType=e.InternalMsgEmitterType;exports.Main_View_Id=e.Main_View_Id;exports.Plugin=e.Plugin;exports.ShapeType=e.ShapeType;exports.Task_Time_Interval=e.Task_Time_Interval;exports.fullWorkerUrl=e.fullWorker;exports.subWorkerUrl=e.subWorker;

package/dist/appliance-plugin.mjs

@@ -1,32 +1,33 @@
-import { ae as s, a8 as p, ab as r, aa as t, a9 as l, a0 as i, U as n, o, af as E, l as T, E as y, aj as g, n as v, ak as c, m as k, t as S, k as m, ah as u, a2 as M, ag as _, q as A, ai as I, ad as W, R as d, al as P, ac as R, a3 as f, a6 as h, a7 as C } from "./index-Be0GtbHC.mjs";
+import { af as s, a9 as p, ac as r, ab as t, aa as i, a4 as l, Z as n, b as E, ag as T, t as o, j as y, ak as v, a as g, al as c, d as S, u, w as k, c as m, ai as M, E as _, ah as d, v as A, aj as I, ae as W, Y as P, am as b, ad as f, a6 as h, a7 as w, a8 as C } from "./index-OkrVupZ5.mjs";
 export {
   s as ActiveContainerType,
   p as ApplianceMultiPlugin,
   r as ApplianceNames,
   t as ApplianceSigleWrapper,
-  l as ApplianceSinglePlugin,
-  i as Cursor_Hover_Id,
+  i as ApplianceSinglePlugin,
+  l as Cursor_Hover_Id,
   n as ECanvasShowType,
-  o as EDataType,
-  E as EForceStopReason,
-  T as EImageType,
+  E as EDataType,
+  T as EForceStopReason,
+  o as EImageType,
   y as EMatrixrRelationType,
-  g as EOperationType,
-  v as EPostMessageType,
+  v as EOperationType,
+  g as EPostMessageType,
   c as ERenderFilterType,
-  k as EScaleType,
-  S as EStrokeType,
+  S as ESVGType,
+  u as EScaleType,
+  k as EStrokeType,
   m as EToolsKey,
-  u as ElayerType,
-  M as EmitEventType,
-  _ as EventMessageType,
+  M as ElayerType,
+  _ as EmitEventType,
+  d as EventMessageType,
   A as EvevtWorkState,
   I as EvevtWorkType,
   W as InternalMsgEmitterType,
-  d as Main_View_Id,
-  P as Plugin,
-  R as ShapeType,
-  f as Task_Time_Interval,
-  h as fullWorkerUrl,
+  P as Main_View_Id,
+  b as Plugin,
+  f as ShapeType,
+  h as Task_Time_Interval,
+  w as fullWorkerUrl,
   C as subWorkerUrl
 };

package/dist/collector/collector.d.ts

@@ -26,10 +26,16 @@ export declare class Collector extends BaseCollector<ISerializableStorageViewDat
     private limitNums;
     private syncInterval;
     constructor(control: BaseApplianceManager, plugin: AppliancePluginLike, syncInterval: number);
+    hasId(viewId: string, scenePath: string, key: string): boolean;
     private getLimitNum;
     private getLimitNums;
     getViewIdBySecenPath(scenePath: string): string | undefined;
     getScenePathData(scenePath: string): ISerializableStorageData | undefined;
+    hasTargetDataByViewId(viewId: string, key: string): true | undefined;
+    getTargetDataByViewId(viewId: string, key: string): {
+        data: BaseCollectorReducerAction | undefined;
+        scenePath: string | undefined;
+    };
     getStorageData(viewId: string, scenePath: string): ISerializableStorageData | undefined;
     hasSelector(viewId: string, scenePath: string): boolean;
     hasIncludeSelector(targetKey: string, targetViewId?: string, targetScenePath?: string): boolean;

package/dist/component/svg/base.d.ts

@@ -0,0 +1,30 @@
+import { EToolsKey } from "../../core/enum";
+import { BaseShapeToolProps } from "../../core/tools";
+import { ISVGOptions } from "../../core/types";
+import { VNodeManager } from "../../core/vNodeManager";
+import { VBackgroundNodeManager } from "./vNodeManager";
+import { ISvgElement } from "./svgElemt";
+import { BackgroundThreadEngineImpl } from "./manager";
+import { BackgroundSnapshotThreadImpl } from "./snapshot";
+export interface IActiveBackgroundToolsDataType {
+    toolsType: EToolsKey.BackgroundSVG;
+    toolsOpt: ISVGOptions;
+    combineUnitTime?: number;
+    maxCombineEraserTime?: number;
+}
+export interface ISVGShapeToolProps extends Omit<BaseShapeToolProps, "vNodes"> {
+    vNodes: VBackgroundNodeManager;
+    toolsOpt: ISVGOptions;
+}
+export interface ISVGShadowShapeToolProps extends BaseShapeToolProps {
+    vNodes?: VNodeManager;
+    toolsOpt: ISVGOptions;
+}
+export declare function getShapeToolsForBackgroundThread(toolsType: EToolsKey): typeof ISvgElement | undefined;
+export declare function getShapeInstanceForBackgroundThread(param: {
+    workId: string;
+    toolsType: EToolsKey;
+    toolsOpt: ISVGOptions;
+    vNodes: VBackgroundNodeManager;
+    manager: BackgroundThreadEngineImpl | BackgroundSnapshotThreadImpl;
+}): ISvgElement | undefined;

package/dist/component/svg/manager.d.ts

@@ -0,0 +1,44 @@
+import { IMarkmapOptions } from "markmap-view";
+import { ICameraOpt, IWorkerMessage } from "../../core";
+import { IBackgroundThreadInitOption } from "../../core/backGroundThread";
+import { MasterControlForWorker } from "../../core/mainEngine";
+import { View } from "../../plugin";
+import { VBackgroundNodeManager } from "./vNodeManager";
+export interface BackgroundThreadEngine {
+    readonly viewId: string;
+    readonly fullLayer: HTMLDivElement;
+    readonly vNodes: VBackgroundNodeManager;
+    readonly master: MasterControlForWorker;
+    setCameraOpt(cameraOpt: ICameraOpt): Promise<void>;
+    on(msg: IWorkerMessage): Promise<void>;
+    destroy(): void;
+}
+export declare class BackgroundThreadEngineImpl implements BackgroundThreadEngine {
+    opt: IBackgroundThreadInitOption;
+    viewId: string;
+    fullLayer: HTMLDivElement;
+    vNodes: VBackgroundNodeManager;
+    master: MasterControlForWorker;
+    private cameraOpt?;
+    private methodBuilder;
+    constructor(viewId: string, opt: IBackgroundThreadInitOption);
+    get camera(): ICameraOpt;
+    get view(): View | undefined;
+    get markmapOptions(): Partial<IMarkmapOptions> | undefined;
+    getPagePoint(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+    setCameraOpt(cameraOpt: ICameraOpt): Promise<void>;
+    private clearAll;
+    private canUseFullLayer;
+    consumeFull(msg: IWorkerMessage): Promise<void>;
+    private setFullWork;
+    private createWorkShapeNode;
+    private removeWork;
+    private removeNode;
+    on(msg: IWorkerMessage): Promise<void>;
+    private toggleFullLayer;
+    private updateCamera;
+    destroy(): void;
+}

package/dist/component/svg/markmap.d.ts

@@ -0,0 +1,41 @@
+import * as markmap from "markmap-view";
+import type { IMarkmapOptions } from "markmap-view";
+import { type ITransformPlugin, Transformer } from "markmap-lib";
+export interface IMermaidTransformerOptions extends Array<ITransformPlugin | (() => ITransformPlugin)> {
+}
+declare class MermaidTransformer extends Transformer {
+    private currentWorkId;
+    constructor(options?: IMermaidTransformerOptions);
+    /**
+     * 设置当前工作 ID（用于命名空间隔离）
+     * @param workId 工作 ID
+     */
+    setWorkId(workId: string): void;
+    transform(content: string, fallbackParserOptions?: any): import("markmap-lib").ITransformResult;
+    /**
+     * 将 markdown 内容中的 katex 公式转换为普通文本
+     * 处理 $...$ 和 $$...$$ 格式的公式
+     * 由于 Safari 对 katex 的兼容性问题，将公式转换为普通文本显示
+     * @param content markdown 内容
+     * @returns 处理后的内容
+     */
+    private convertKatexToText;
+    /**
+     * 处理转换结果中的 katex HTML，将其转换为普通文本
+     * 递归处理节点树，查找包含 katex 的内容并转换
+     * 由于 Safari 对 katex 的兼容性问题，将 katex HTML 转换为普通文本显示
+     * @param node markmap 节点
+     */
+    private processKatexInRoot;
+    /**
+     * 等待 markmap foreignObject 内所有图片加载完成
+     * 用于在调用 fit() 之前确保所有图片都已加载，以便正确计算尺寸
+     * @param svgElement SVG 元素
+     * @param timeout 超时时间（毫秒），默认 10 秒
+     * @returns Promise<void> 当所有图片加载完成时 resolve
+     */
+    static waitForImagesInForeignObjects(svgElement: SVGSVGElement, timeout?: number): Promise<void>;
+}
+export declare const transformer: MermaidTransformer;
+declare const Markmap: typeof markmap.Markmap;
+export { IMarkmapOptions, markmap, Transformer, Markmap, MermaidTransformer };

package/dist/component/svg/mermaid-check.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Mermaid 检查和验证工具
+ * 用于验证 mermaid.js 是否正确引入和加载
+ *
+ * 注意：此文件已废弃，请使用 mermaid-loader.ts 中的按需加载功能
+ */
+export declare function checkMermaidAvailability(): Promise<{
+    available: boolean;
+    version?: string;
+    hasInitialize?: boolean;
+    hasRender?: boolean;
+    error?: string;
+}>;
+export declare function testMermaidRender(): Promise<{
+    success: boolean;
+    svg?: string;
+    error?: string;
+}>;

package/dist/component/svg/mermaid-loader.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Mermaid.js 按需加载管理器
+ * 只在检测到 markdown 中有 mermaid 代码块时才加载 mermaid.js
+ */
+/**
+ * 检查 markdown 中是否包含 mermaid 代码块
+ */
+export declare function hasMermaidCodeBlock(markdown: string): boolean;
+/**
+ * 动态加载 mermaid.js
+ * @returns Promise<mermaid 模块>
+ */
+export declare function loadMermaid(): Promise<typeof import("mermaid")>;
+/**
+ * 初始化 mermaid（如果还未初始化）
+ */
+export declare function ensureMermaidInitialized(): Promise<typeof import("mermaid")>;
+/**
+ * 获取 mermaid 实例（需要先调用 ensureMermaidInitialized）
+ */
+export declare function getMermaid(): (typeof import("mermaid"))["default"] | null;
+/**
+ * 检查 mermaid 是否已加载
+ */
+export declare function isMermaidLoaded(): boolean;
+/**
+ * 重置状态（主要用于测试）
+ */
+export declare function resetMermaidLoader(): void;

package/dist/component/svg/mermaid.d.ts

@@ -0,0 +1,109 @@
+import { Transformer } from "./markmap";
+/**
+ * Mermaid 管理器（单例模式）
+ * 统一管理 mermaid 代码块的存储、HTML 生成和 markdown 扩展
+ * 使用 workId 作为命名空间，避免多个 ISvgElement 实例互相影响
+ */
+export declare class MermaidManager {
+    private static instance;
+    private mermaidCodeBlocksByWorkId;
+    private constructor();
+    /**
+     * 获取 MermaidManager 单例实例
+     */
+    static getInstance(): MermaidManager;
+    /**
+     * 生成唯一的 mermaid ID
+     */
+    generateId(): string;
+    /**
+     * 生成 mermaid HTML 容器
+     * @param id mermaid ID
+     * @param mermaidCode mermaid 代码（可选，如果提供则存储）
+     * @param workId 工作 ID（用于命名空间隔离）
+     * @returns HTML 字符串
+     */
+    createContainer(id: string, mermaidCode?: string, workId?: string): string;
+    /**
+     * 获取 mermaid 代码块
+     * @param id mermaid ID
+     * @param workId 工作 ID（用于命名空间隔离）
+     * @returns mermaid 代码或 undefined
+     */
+    getCode(id: string, workId: string): string | undefined;
+    /**
+     * 清空指定 workId 的 mermaid 代码块
+     * @param workId 工作 ID（如果未提供，清空所有）
+     */
+    clear(workId?: string): void;
+    /**
+     * 扩展 markdown-it 的渲染规则，处理 mermaid 代码块
+     * @param transformer Transformer 实例
+     * @param workId 工作 ID（用于命名空间隔离）
+     */
+    extendMarkdown(transformer: Transformer, workId: string): void;
+    static generateId(): string;
+    static createContainer(id: string, mermaidCode?: string, workId?: string): string;
+    static getCode(id: string, workId: string): string | undefined;
+    static clear(workId?: string): void;
+    static extendMarkdown(transformer: Transformer, workId: string): void;
+}
+/**
+ * Mermaid 渲染器工具类
+ * 负责处理 markmap 中的 mermaid 图表渲染相关逻辑
+ */
+export declare class MermaidRenderer {
+    /**
+     * 检查 markmap 节点及其子节点是否包含 mermaid 代码块
+     * @param node markmap 节点数据
+     * @returns 如果节点或其子节点包含 mermaid 代码块，返回 true
+     */
+    static checkNodeHasMermaid(node: any): boolean;
+    /**
+     * 等待 DOM 更新后渲染 Mermaid 图表
+     * @param svgElement SVG 元素
+     * @param workId 工作 ID
+     * @returns Promise<void>
+     */
+    static renderMermaidAfterDOMUpdate(svgElement: SVGSVGElement, workId: string): Promise<void>;
+    /**
+     * 渲染所有 mermaid 容器中的图表
+     * @param svgElement SVG 元素
+     * @param workId 工作 ID
+     * @returns Promise<void>
+     */
+    static renderMermaidBlocks(svgElement: SVGSVGElement, workId: string): Promise<void>;
+    /**
+     * 检测是否是 Safari 浏览器
+     * @returns 如果是 Safari 返回 true，否则返回 false
+     */
+    static isSafari(): boolean;
+    /**
+     * 将 mermaid SVG 从 foreignObject 移出，直接添加到 markmap SVG 中（Safari 兼容性处理）
+     * 克隆 mermaid SVG 元素，设置正确的尺寸和位置，然后将 foreignObject 中的 mermaid-container 透明度设为 0
+     * @param svgElement markmap SVG 元素
+     * @returns Promise<void>
+     */
+    static transformMermaidSvgToMarkmapSvg(svgElement: SVGSVGElement): Promise<void>;
+    /**
+     * 在 root 数据中注入 mermaid HTML
+     * 找到包含 mermaid 代码块的节点，将 HTML 添加到其 content 中
+     * @param root markmap root 数据
+     * @param markdown markdown 文本
+     * @param workId 工作 ID（用于命名空间隔离）
+     * @returns 修改后的 root 数据
+     */
+    static injectMermaidHtml(root: any, markdown: string, workId: string): any;
+    /**
+     * 解码 HTML 实体
+     * @param str HTML 字符串
+     * @returns 解码后的字符串
+     */
+    private static decodeHtmlEntities;
+    /**
+     * 检查 divElement 中是否包含 mermaid SVG 元素
+     * @param divElement HTMLDivElement 或 SVGSVGElement 元素
+     * @returns 如果包含 mermaid SVG 元素，返回 true，否则返回 false
+     */
+    static hasMermaidSvg(divElement: HTMLDivElement | SVGSVGElement): boolean;
+}

package/dist/component/svg/snapshot.d.ts

@@ -0,0 +1,31 @@
+import { IBackgroundThreadInitOption } from "../../core/backGroundThread";
+import { MasterControlForWorker } from "../../core/mainEngine";
+import { BaseShapeTool } from "../../core/tools";
+import { ICameraOpt, IWorkerMessage } from "../../core/types";
+import { VBackgroundNodeManager } from "./vNodeManager";
+import { View } from "../../plugin/types";
+import { IMarkmapOptions } from "./markmap";
+export declare class BackgroundSnapshotThreadImpl {
+    viewId: string;
+    fullLayer: HTMLDivElement;
+    master: MasterControlForWorker;
+    vNodes: VBackgroundNodeManager;
+    private cameraOpt?;
+    readonly opt: IBackgroundThreadInitOption;
+    workShapes: Map<string, BaseShapeTool>;
+    get camera(): ICameraOpt;
+    get view(): View | undefined;
+    get markmapOptions(): Partial<IMarkmapOptions> | undefined;
+    constructor(viewId: string, opt: IBackgroundThreadInitOption);
+    createOffscreenCanvas(opt: IBackgroundThreadInitOption): void;
+    setCameraOpt(cameraOpt: ICameraOpt): Promise<void>;
+    getPagePoint(x: number, y: number): {
+        x: number;
+        y: number;
+    };
+    getSnapshot(data: IWorkerMessage): Promise<void>;
+    private createWorkShapeNode;
+    private setFullWork;
+    runFullWork(data: IWorkerMessage): Promise<void>;
+    destroy(): void;
+}

package/dist/component/svg/svgElemt.d.ts

@@ -0,0 +1,43 @@
+import { EToolsKey, ISVGOptions } from "../../core";
+import { ISVGElementToolProps } from "./types";
+import { VBackgroundNodeManager } from "./vNodeManager";
+import type { BackgroundThreadEngineImpl } from "./manager";
+import { Markmap } from "./markmap";
+import type { Collector } from "../../collector";
+import type { BackgroundSnapshotThreadImpl } from "./snapshot";
+export declare class ISvgElement {
+    readonly toolsType: EToolsKey;
+    readonly vNodes: VBackgroundNodeManager;
+    private workOptions;
+    readonly workId: string;
+    markmapInstance: ReturnType<typeof Markmap.create> | null;
+    private isDestroyed;
+    private element;
+    readonly manager: BackgroundThreadEngineImpl | BackgroundSnapshotThreadImpl;
+    get fullLayer(): HTMLDivElement;
+    get collector(): Collector | undefined;
+    get scenePath(): string | undefined;
+    constructor(props: ISVGElementToolProps);
+    init(): Promise<void>;
+    private createElement;
+    private render;
+    private isSameSize;
+    private isSamePosition;
+    private isSameZIndex;
+    private isSameState;
+    private isSameData;
+    private updateElementPosition;
+    private updateSvg;
+    private fit;
+    private serializeData;
+    private transformState;
+    updateCamera(): Promise<void>;
+    setWorkOptions(toolsOpt: ISVGOptions, forceRender?: boolean): Promise<void>;
+    destroy(): void;
+    getRectFromLayer(): {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+}

package/dist/component/svg/svgToImageLoader.d.ts

@@ -0,0 +1,25 @@
+/**
+ * SVG to Image 库的按需加载工具
+ * 使用 dom-to-image 库，用于将包含 SVG foreignObject 的 DOM 转换为图片
+ * dom-to-image 支持 SVG foreignObject，可以可靠地将 DOM 节点转换为图片
+ */
+type DomToImageLib = {
+    toPng: (node: Node, options?: any) => Promise<string>;
+    toBlob: (node: Node, options?: any) => Promise<Blob>;
+    toJpeg: (node: Node, options?: any) => Promise<string>;
+    toSvg: (node: Node, options?: any) => Promise<string>;
+};
+/**
+ * 按需加载 svg-to-image 库（使用 dom-to-image）
+ * @returns Promise<DomToImageLib> 返回加载的库对象
+ */
+export declare function loadSvgToImageLib(): Promise<DomToImageLib>;
+/**
+ * 检查库是否已加载
+ */
+export declare function isSvgToImageLibLoaded(): boolean;
+/**
+ * 获取已加载的库（如果未加载则返回 null）
+ */
+export declare function getSvgToImageLib(): DomToImageLib | null;
+export {};

package/dist/component/svg/types.d.ts

@@ -0,0 +1,10 @@
+import { ISVGOptions } from "../../core";
+import { BackgroundThreadEngineImpl } from "./manager";
+import { BackgroundSnapshotThreadImpl } from "./snapshot";
+import { VBackgroundNodeManager } from "./vNodeManager";
+export interface ISVGElementToolProps {
+    workId: string;
+    toolsOpt: ISVGOptions;
+    vNodes: VBackgroundNodeManager;
+    manager: BackgroundThreadEngineImpl | BackgroundSnapshotThreadImpl;
+}

package/dist/component/svg/utils.d.ts

@@ -0,0 +1,9 @@
+export declare function loadAllImages(element: HTMLDivElement): Promise<unknown[]>;
+export declare function loadSvg(svg: SVGSVGElement): Promise<void>;
+export declare function loadAllSvgs(divElement: HTMLDivElement): Promise<void>;
+export declare function loadMermaidSvg(divElement: HTMLDivElement | SVGSVGElement): Promise<void>;
+export declare function divToImageElement(container: HTMLDivElement, options?: {
+    width?: number;
+    height?: number;
+    scale?: number;
+}): Promise<HTMLImageElement | null>;

package/dist/component/svg/vNodeManager.d.ts

@@ -0,0 +1,28 @@
+import { ObserverMap } from "../../core/utils/ObserverMap";
+import { ISvgElement } from "./svgElemt";
+export interface IBackgroundNodeMapItem {
+    name: string;
+    workShape: ISvgElement;
+}
+/**
+ * 背景节点管理器
+ * 覆盖父类的 curNodeMap 类型，使用 IBackgroundNodeMapItem 作为节点项类型
+ * IBackgroundNodeMapItem 是 BaseNodeMapItem 的简化版本，专门用于背景节点管理
+ */
+export declare class VBackgroundNodeManager {
+    viewId: string;
+    fullLayer?: HTMLDivElement;
+    curNodeMap: ObserverMap<string, IBackgroundNodeMapItem>;
+    constructor(viewId: string);
+    init(fullLayer: HTMLDivElement): void;
+    get(name: string): IBackgroundNodeMapItem | undefined;
+    setInfo(name: string, info: Partial<IBackgroundNodeMapItem>): void;
+    getNodeRectFormShape(key: string): {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    } | undefined;
+    delete(name: string): void;
+    clear(): void;
+}

package/dist/core/backGroundThread/index.d.ts

@@ -0,0 +1,35 @@
+import { MasterControlForWorker } from "../mainEngine";
+import { IBatchMainMessage, ILayerOptionType, IWorkerMessage } from "../types";
+import { AppViewDisplayerManager, MainViewDisplayerManager } from "../../plugin/baseViewContainerManager";
+import { BackgroundThreadEngineImpl } from "../../component/svg/manager";
+import { ICanvasOptionType } from "./types";
+import { BackgroundSnapshotThreadImpl } from "../../component/svg/snapshot";
+export interface IBackgroundThreadInitOption {
+    master: MasterControlForWorker;
+    container: HTMLDivElement;
+    canvasOpt: ICanvasOptionType;
+    layerOpt: ILayerOptionType;
+    displayer: MainViewDisplayerManager | AppViewDisplayerManager;
+    post(sp: Omit<IBatchMainMessage, "render">): void;
+}
+export interface BackgroundThreadManager {
+    master: MasterControlForWorker;
+    backgroundThreadMap: Map<string, BackgroundThreadEngineImpl>;
+    createBackgroundThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundThreadEngineImpl;
+    createSnapshotThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundSnapshotThreadImpl;
+    consume(msg: Set<IWorkerMessage>): Promise<void>;
+    post(sp: Omit<IBatchMainMessage, "render">): void;
+    destroy(): void;
+}
+export declare class BackgroundThreadManagerImpl implements BackgroundThreadManager {
+    backgroundThreadMap: Map<string, BackgroundThreadEngineImpl>;
+    private snapshotThread?;
+    master: MasterControlForWorker;
+    constructor(master: MasterControlForWorker);
+    createBackgroundThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundThreadEngineImpl;
+    createSnapshotThread(viewId: string, opt: IBackgroundThreadInitOption): BackgroundSnapshotThreadImpl;
+    consume(msg: Set<IWorkerMessage>): Promise<void>;
+    consumeTargetOne(viewId: string, msg: IWorkerMessage): Promise<void>;
+    post: (msg: Omit<IBatchMainMessage, "render">) => void;
+    destroy(): void;
+}

package/dist/core/backGroundThread/types.d.ts

@@ -0,0 +1,12 @@
+import { IOffscreenCanvasOptionType, ILayerOptionType, IBatchMainMessage } from "..";
+import { MainViewDisplayerManager, AppViewDisplayerManager } from "../../plugin/baseViewContainerManager";
+import { MasterControlForWorker } from "../mainEngine";
+export type ICanvasOptionType = IOffscreenCanvasOptionType;
+export interface IMainThreadInitOption {
+    container: HTMLDivElement;
+    canvasOpt: ICanvasOptionType;
+    layerOpt: ILayerOptionType;
+    master: MasterControlForWorker;
+    displayer: MainViewDisplayerManager | AppViewDisplayerManager;
+    post(sp: Omit<IBatchMainMessage, "render">): void;
+}

package/dist/core/enum.d.ts

@@ -36,7 +36,9 @@ export declare enum EToolsKey {
     /** 聊天泡泡框 */
     SpeechBalloon = 18,
     /** 图片 */
-    Image = 19
+    Image = 19,
+    /** background svg工具 */
+    BackgroundSVG = 20
 }
 export declare enum EDataType {
     /** 本地数据 */
@@ -125,7 +127,11 @@ export declare enum EPostMessageType {
     /** 上报错误 */
     ReportError = 31,
     /** 上报日志 */
-    ReportLog = 32
+    ReportLog = 32,
+    /** 更新 background svg */
+    BackgroundSVGUpdate = 33,
+    /** delete background svg */
+    BackgroundSVGDelete = 34
 }
 export type ECanvasContextType = "webgl2" | "webgl" | "2d";
 export declare enum ECanvasShowType {
@@ -218,3 +224,7 @@ export declare enum EImageType {
     Image = "image",
     Iconify = "iconify"
 }
+export declare enum ESVGType {
+    url = "url",
+    markmap = "markmap"
+}