@umbraci/jsmind 0.9.9 → 0.9.10

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@umbraci/jsmind",
-    "version": "0.9.9",
+    "version": "0.9.10",
     "description": "jsMind is a pure javascript library for mindmap, it base on html5 canvas. jsMind was released under BSD license, you can embed it in any project, if only you observe the license.",
     "main": "lib/jsmind.js",
     "module": "es/jsmind.js",
@@ -28,6 +28,11 @@
             "require": "./lib/jsmind.multiline-text.js",
             "types": "./types/generated/plugins/jsmind.multiline-text.d.ts"
         },
+        "./history": {
+            "import": "./es/jsmind.history.js",
+            "require": "./lib/jsmind.history.js",
+            "types": "./types/generated/plugins/jsmind.history.d.ts"
+        },
         "./style/jsmind.css": "./style/jsmind.css"
     },
     "directories": {
@@ -77,6 +82,8 @@
         }
     ],
     "devDependencies": {
+        "@rollup/plugin-commonjs": "^28.0.8",
+        "@rollup/plugin-node-resolve": "^16.0.3",
         "@rollup/plugin-terser": "^0.4.4",
         "http-server": "^14.1.1",
         "jest": "^28.1.0",
@@ -93,5 +100,8 @@
     },
     "sideEffects": [
         "./es6/*"
-    ]
+    ],
+    "dependencies": {
+        "fast-equals": "^5.3.2"
+    }
 }

package/types/generated/jsmind.common.d.ts

@@ -27,6 +27,8 @@ export namespace EventType {
     let resize: number;
     let edit: number;
     let select: number;
+    let reset: number;
+    let history_change: number;
 }
 export type Key = number;
 export namespace Key {

package/types/generated/jsmind.d.ts

@@ -14,6 +14,8 @@ declare class jsMind {
         resize: number;
         edit: number;
         select: number;
+        reset: number;
+        history_change: number;
     };
     static $: {
         w: Window;

package/types/generated/plugins/history/history-diff.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Flatten a NodeTreeFormat/NodeTreeData by id
+ * @param {NodeTreeFormat|NodeTreeData} tree
+ * @param {{ fields?: string[], includeStructure?: boolean }=} opts
+ * @returns {Record<string, any>}
+ */
+export function flatten(tree: NodeTreeFormat | NodeTreeData, opts?: {
+    fields?: string[];
+    includeStructure?: boolean;
+} | undefined): Record<string, any>;
+/**
+ * Compute diff between two snapshots
+ * @param {NodeTreeFormat|NodeTreeData} a
+ * @param {NodeTreeFormat|NodeTreeData} b
+ * @param {{ fields?: string[], includeStructure?: boolean, maxSize?: number }=} opts
+ *   - fields: 可选。指定要参与 diff 的节点属性列表；默认比较所有属性（除 children）。与 includeStructure 组合使用时可同时比较 _parentid/_order。
+ * @returns {{
+ *   created: any[],
+ *   updated: { id:string, before:any, after:any, changes: { key:string, before:any, after:any }[] }[],
+ *   deleted: any[],
+ *   truncated: boolean
+ * }}
+ */
+export function diff(a: NodeTreeFormat | NodeTreeData, b: NodeTreeFormat | NodeTreeData, opts?: {
+    fields?: string[];
+    includeStructure?: boolean;
+    maxSize?: number;
+} | undefined): {
+    created: any[];
+    updated: {
+        id: string;
+        before: any;
+        after: any;
+        changes: {
+            key: string;
+            before: any;
+            after: any;
+        }[];
+    }[];
+    deleted: any[];
+    truncated: boolean;
+};
+export type NodeTreeFormat = {
+    meta?: any;
+    format?: "node_tree";
+    data: NodeTreeData;
+};
+export type NodeTreeData = {
+    id: string;
+    topic?: string;
+    expanded?: boolean;
+    direction?: "left" | "right";
+    data?: Record<string, any>;
+    children?: NodeTreeData[];
+};

package/types/generated/plugins/history/jsmind.history.d.ts

@@ -0,0 +1,84 @@
+export default HistoryPlugin;
+export type JsMind = import("../../jsmind.js").default;
+/**
+ * HistoryPlugin skeleton (Task 1)
+ */
+export class HistoryPlugin extends EnhancedPlugin {
+    /**
+     * @param {{ jm: JsMind, pluginOpt?: any }} params
+     */
+    constructor({ jm, pluginOpt }: {
+        jm: JsMind;
+        pluginOpt?: any;
+    });
+    options: any;
+    _mounted: boolean;
+    _core: HistoryCore;
+    /**
+     * Lifecycle hook: called when jsMind instance is destroyed
+     */
+    beforePluginDestroy(): void;
+    /** Default: call beforePluginRemove on destroy */
+    beforePluginDestroy(): void;
+    /** Initialize HistoryCore and wire API methods */
+    _initCore(): void;
+    _listener: (type: any, payload: any) => void;
+    /**
+     * Inject shortcut options so provider can register mapping in its init phase
+     * @param {{ enable?: boolean, handles: Record<string,Function>, mapping: Record<string, number|number[]> }} sc
+     * @param {boolean} redoUsesY
+     */
+    _injectShortcuts(sc: {
+        enable?: boolean;
+        handles: Record<string, Function>;
+        mapping: Record<string, number | number[]>;
+    }, redoUsesY: boolean): void;
+    /** Mount public API on jm.history (placeholder defaults) */
+    _mountAPI(): void;
+}
+import { EnhancedPlugin } from '../../jsmind.enhanced-plugin.js';
+declare class HistoryCore {
+    /** @param {JsMind} jm @param {any} options */
+    constructor(jm: JsMind, options: any);
+    jm: import("../../jsmind.js").default;
+    options: any;
+    enabled: boolean;
+    maxHistory: number;
+    throttleMs: number;
+    storageMode: any;
+    autoSwitchThreshold: number;
+    _history: any[];
+    _idx: number;
+    _paused: boolean;
+    _lastAddAt: number;
+    _timer: number;
+    _pending: boolean;
+    _pendingMeta: any;
+    _lastSig: any;
+    add(reason: string, meta: any): void;
+    pause(): void;
+    resume(flush?: boolean): void;
+    clear(): void;
+    canBack(): boolean;
+    canForward(): boolean;
+    back(steps?: number): boolean;
+    forward(steps?: number): boolean;
+    length(): number;
+    index(): number;
+    setMax(count: any): void;
+    setThrottle(ms: any): void;
+    exportSnapshot(): any;
+    importSnapshot(data: any, applyOptions: any): boolean;
+    getStackMeta(): {
+        items: any[];
+        index: number;
+    };
+    _notifyChange(): void;
+    _addNow(_reason: any, _meta: any): void;
+    _applyIndex(): boolean;
+    _takeSnapshot(): any;
+    _applySnapshot(data: any, applyOptions: any): boolean;
+    _countNodes(snapshot: any): number;
+    _deepFreeze(obj: any): any;
+    _cloneSnapshot(obj: any): any;
+}

package/types/generated/plugins/jsmind.draggable-node.d.ts

@@ -13,10 +13,14 @@ export class DraggableNode {
     jm: import("../jsmind.js").default;
     /** @type {DraggableNodeOptions} */
     options: DraggableNodeOptions;
-    /** @type {HTMLCanvasElement|null} */
-    e_canvas: HTMLCanvasElement | null;
+    /** @type {boolean} */
+    is_svg_engine: boolean;
+    /** @type {HTMLCanvasElement|SVGSVGElement|null} */
+    e_canvas: HTMLCanvasElement | SVGSVGElement | null;
     /** @type {CanvasRenderingContext2D|null} */
     canvas_ctx: CanvasRenderingContext2D | null;
+    /** @type {SVGPathElement|null} */
+    helper_line: SVGPathElement | null;
     /** @type {HTMLElement|null} */
     shadow: HTMLElement | null;
     /** @type {number} */
@@ -57,10 +61,17 @@ export class DraggableNode {
     view_panel_rect: DOMRect | null;
     /** Initialize the draggable node plugin. */
     init(): void;
-    /** Resize canvas and shadow elements. */
+    /** Resize canvas/SVG and shadow elements. */
     resize(): void;
-    /** Create canvas for drawing drag lines. */
+    /** Create canvas or SVG for drawing drag lines. */
     create_canvas(): void;
+    /**
+     * Create SVG element with proper namespace.
+     * @param {string} tag - SVG tag name
+     * @returns {SVGElement}
+     * @private
+     */
+    private _create_svg_element;
     create_shadow(): void;
     /**
      * Reset shadow element style and cache its size.
@@ -84,16 +95,37 @@ export class DraggableNode {
         x: number;
         y: number;
     }, invalid: boolean): void;
-    /** Clear helper lines from canvas. */
+    /** Clear helper lines from canvas or SVG. */
     clear_lines(): void;
     /**
-     * Draw a straight helper line.
+     * Draw a straight helper line on canvas.
      * @param {number} x1
      * @param {number} y1
      * @param {number} x2
      * @param {number} y2
      */
     canvas_lineto(x1: number, y1: number, x2: number, y2: number): void;
+    /**
+     * Draw a helper line on SVG using bezier curve.
+     * Reuses the line drawing logic from SvgGraph.
+     * @param {number} x1 - Start x coordinate
+     * @param {number} y1 - Start y coordinate
+     * @param {number} x2 - End x coordinate
+     * @param {number} y2 - End y coordinate
+     * @param {string} color - Line color
+     */
+    svg_draw_line(x1: number, y1: number, x2: number, y2: number, color: string): void;
+    /**
+     * Draw bezier curve to SVG path element.
+     * Reuses logic from SvgGraph._bezier_to.
+     * @param {SVGPathElement} path - SVG path element
+     * @param {number} x1 - Start x coordinate
+     * @param {number} y1 - Start y coordinate
+     * @param {number} x2 - End x coordinate
+     * @param {number} y2 - End y coordinate
+     * @private
+     */
+    private _svg_bezier_to;
     /** Bind mouse/touch events for dragging. */
     event_bind(): void;
     /**