@umbraci/jsmind 0.9.8 → 0.9.10

package/lib/jsmind.multiline-text.js

@@ -0,0 +1,9 @@
+/**
+* @license BSD-3-Clause
+* @copyright 2014-2025 hizzgdev@163.com
+*
+* Project Home:
+*   https://github.com/hizzgdev/jsmind/
+*/
+"use strict";function e(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}Object.defineProperty(exports,"__esModule",{value:!0});var t=e(require("@umbraci/jsmind"));if(!t.default)throw new Error("jsMind is not defined");const n=t.default.$,i={text_width:200,line_height:"1.5"};function o(e={}){const t=Object.assign({},i,e);return function(e,n,i){return!(!i.topic||!i.topic.includes("\n"))&&(n.style.whiteSpace="pre-wrap",n.style.wordBreak="break-word",n.style.maxWidth=t.text_width+"px",n.textContent=i.topic,!0)}}function d(e,o){console.log("[Multiline Plugin] Initializing...",o);const d=Object.assign({},i,o),l=e.view;let r=null,a=null;function s(){if(!r||!a)return;const e=r._data.view.element;a.parentNode&&a.parentNode.removeChild(a),e.style.zIndex="auto",r=null,l.editing_node=null,a=null}l.opts.custom_node_render&&(l.render_node=l._custom_node_render.bind(l),console.log("[Multiline Plugin] Re-bound view.render_node")),e.mind&&e.mind.root&&(!function(e){const t=e.view,n=e.mind;if(!n||!n.root)return;const i=[];for(const e in n.nodes){const t=n.nodes[e];t._data&&t._data.view&&t._data.view.element&&i.push(t)}for(const e of i){const n=e._data.view.element;t.render_node(n,e)}for(const t of i)if(e.layout.is_visible(t)){const e=t._data.view.element;t._data.view.width=e.clientWidth,t._data.view.height=e.clientHeight}e.layout.layout(),e.view.show(!1)}(e),console.log("[Multiline Plugin] Re-rendered all nodes")),l.edit_node_begin=function(e){if(console.log("[Multiline Plugin] edit_node_begin called",e),!e.topic)return;r&&l.edit_node_end(),r=e,l.editing_node=e;const t=n.c("div");t.contentEditable="plaintext-only",t.className="jsmind-multiline-editor",t.textContent=e.topic,a=t;const i=e._data.view.element;Object.assign(t.style,{width:"auto",minHeight:i.clientHeight+"px",lineHeight:d.line_height,border:"none",outline:"none",whiteSpace:"pre-wrap",wordBreak:"break-word",boxSizing:"border-box",overflow:"hidden"});const o=()=>{t.style.height="auto",t.style.height=t.scrollHeight+"px"};n.on(t,"input",o),setTimeout(o,0),n.on(t,"keydown",e=>{"Enter"!==e.key||e.shiftKey?"Escape"===e.key?(e.preventDefault(),e.stopPropagation(),function(){if(!r||!a)return;const e=r;s(),l.render_node(e._data.view.element,e),l.e_panel.focus()}()):"Tab"===e.key&&(e.preventDefault(),e.stopPropagation(),l.edit_node_end()):(e.preventDefault(),e.stopPropagation(),l.edit_node_end())}),n.on(t,"blur",()=>{setTimeout(()=>{r&&l.edit_node_end()},100)}),i.innerHTML="",i.appendChild(t),i.style.zIndex=5,t.focus();const u=n.d.createRange();u.selectNodeContents(t);const c=n.w.getSelection();c.removeAllRanges(),c.addRange(u)},l.edit_node_end=function(){if(!r||!a)return;const n=r,i=(a.textContent||"").trim().replace(/\r\n/g,"\n").replace(/\r/g,"\n").replace(/\n{3,}/g,"\n\n");s(),t.default.util.text.is_empty(i)||n.topic===i?l.render_node(n._data.view.element,n):e.update_node(n.id,i),l.e_panel.focus()}}t.default.register_plugin(new t.default.plugin("multiline_text",d));var l={name:"multiline_text",init:d,createMultilineRender:o};exports.createMultilineRender=o,exports.default=l;
+//# sourceMappingURL=jsmind.multiline-text.js.map

package/lib/jsmind.multiline-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsmind.multiline-text.js","sources":["../src/plugins/jsmind.multiline-text.js"],"sourcesContent":["/**\n * @license BSD\n * @copyright 2014-2025 UmbraCi\n *\n * Project Home:\n *   https://github.com/hizzgdev/jsmind/\n */\n\nimport jsMind from '@umbraci/jsmind';\n\nif (!jsMind) {\n    throw new Error('jsMind is not defined');\n}\n\nconst $ = jsMind.$;\n\n/**\n * Multiline Text Plugin\n * Provides multiline text support for jsMind nodes\n */\n\n/**\n * Default plugin options\n * @typedef {Object} MultilineTextOptions\n * @property {number} text_width - Maximum width for multiline text nodes (default: 200)\n * @property {string} line_height - Line height for text (default: '1.5')\n */\nconst DEFAULT_OPTIONS = {\n    text_width: 200,\n    line_height: '1.5',\n};\n\n/**\n * Create a custom node render function for multiline text\n * @param {MultilineTextOptions} [options={}] - Plugin options\n * @param {number} [options.text_width=200] - Maximum width for multiline text nodes\n * @param {string} [options.line_height='1.5'] - Line height for text\n * @returns {function(jsMind, HTMLElement, Node): boolean} Custom render function\n * @example\n * const options = {\n *     view: {\n *         custom_node_render: createMultilineRender({\n *             text_width: 250,\n *             line_height: '1.6',\n *         })\n *     }\n * };\n */\nexport function createMultilineRender(options = {}) {\n    const opts = Object.assign({}, DEFAULT_OPTIONS, options);\n\n    return function (jm, element, node) {\n        if (node.topic && node.topic.includes('\\n')) {\n            // Multiline text - apply styles BEFORE setting content\n            element.style.whiteSpace = 'pre-wrap';\n            element.style.wordBreak = 'break-word';\n            element.style.maxWidth = opts.text_width + 'px';\n            element.textContent = node.topic;\n            return true;\n        }\n        // Single line text - use default render\n        return false;\n    };\n}\n\n/**\n * Re-render all nodes to apply multiline styles and recalculate sizes\n * @param {import('../jsmind.js').default} jm - jsMind instance\n * @private\n */\nfunction _rerender_all_nodes(jm) {\n    const view = jm.view;\n    const mind = jm.mind;\n\n    if (!mind || !mind.root) {\n        return;\n    }\n\n    // Collect all nodes to update\n    const nodesToUpdate = [];\n    for (const nodeId in mind.nodes) {\n        const node = mind.nodes[nodeId];\n        if (node._data && node._data.view && node._data.view.element) {\n            nodesToUpdate.push(node);\n        }\n    }\n\n    // Batch render nodes (only update DOM, no layout trigger)\n    for (const node of nodesToUpdate) {\n        const element = node._data.view.element;\n        view.render_node(element, node);\n    }\n\n    // Batch update node sizes (read all sizes at once to avoid layout thrashing)\n    for (const node of nodesToUpdate) {\n        if (jm.layout.is_visible(node)) {\n            const element = node._data.view.element;\n            node._data.view.width = element.clientWidth;\n            node._data.view.height = element.clientHeight;\n        }\n    }\n\n    // Finally recalculate layout and show (only trigger reflow/repaint once)\n    jm.layout.layout();\n    jm.view.show(false);\n}\n\n/**\n * Plugin initialization function\n * @param {import('../jsmind.js').default} jm - jsMind instance\n * @param {MultilineTextOptions} options - Plugin options\n * @private\n */\nfunction init(jm, options) {\n    console.log('[Multiline Plugin] Initializing...', options);\n\n    const opts = Object.assign({}, DEFAULT_OPTIONS, options);\n    const view = jm.view;\n\n    // Plugin state\n    let editing_node = null;\n    let multiline_editor = null;\n\n    // IMPORTANT: Re-set view.render_node to use custom render\n    // Because ViewProvider constructor already set it based on options.custom_node_render\n    // We need to ensure it uses the custom render function\n    if (view.opts.custom_node_render) {\n        view.render_node = view._custom_node_render.bind(view);\n        console.log('[Multiline Plugin] Re-bound view.render_node');\n    }\n\n    // Re-render all nodes to apply multiline styles\n    if (jm.mind && jm.mind.root) {\n        _rerender_all_nodes(jm);\n        console.log('[Multiline Plugin] Re-rendered all nodes');\n    }\n\n    /**\n     * Begin editing a node with multiline support\n     * @param {import('../jsmind.node.js').Node} node\n     */\n    view.edit_node_begin = function (node) {\n        console.log('[Multiline Plugin] edit_node_begin called', node);\n        if (!node.topic) {\n            return;\n        }\n\n        // End editing if another node is being edited\n        if (editing_node) {\n            view.edit_node_end();\n        }\n\n        editing_node = node;\n        view.editing_node = node;\n\n        // Create editor (div with contentEditable)\n        const editor = $.c('div');\n        editor.contentEditable = 'plaintext-only';\n        editor.className = 'jsmind-multiline-editor';\n        editor.textContent = node.topic;\n        multiline_editor = editor;\n\n        // Get element and set editor styles to match\n        const element = node._data.view.element;\n\n        // Set editor styles to match element width, auto-expand height\n        Object.assign(editor.style, {\n            width: 'auto',\n            minHeight: element.clientHeight + 'px',\n            lineHeight: opts.line_height,\n            border: 'none',\n            outline: 'none',\n            whiteSpace: 'pre-wrap',\n            wordBreak: 'break-word',\n            boxSizing: 'border-box',\n            overflow: 'hidden',\n        });\n\n        // Auto-expand height on input\n        const autoExpand = () => {\n            editor.style.height = 'auto';\n            editor.style.height = editor.scrollHeight + 'px';\n        };\n        $.on(editor, 'input', autoExpand);\n        // Initial expand\n        setTimeout(autoExpand, 0);\n\n        // Keyboard events\n        $.on(editor, 'keydown', e => {\n            if (e.key === 'Enter' && !e.shiftKey) {\n                e.preventDefault();\n                e.stopPropagation(); // Prevent jsMind shortcut from triggering\n                view.edit_node_end();\n            } else if (e.key === 'Escape') {\n                e.preventDefault();\n                e.stopPropagation();\n                cancel_editing();\n            } else if (e.key === 'Tab') {\n                e.preventDefault();\n                e.stopPropagation();\n                view.edit_node_end();\n            }\n        });\n\n        // Blur event - save on blur\n        $.on(editor, 'blur', () => {\n            setTimeout(() => {\n                if (editing_node) {\n                    view.edit_node_end();\n                }\n            }, 100);\n        });\n\n        // Replace node content and focus\n        element.innerHTML = '';\n        element.appendChild(editor);\n        element.style.zIndex = 5;\n        editor.focus();\n\n        // Select all text\n        const range = $.d.createRange();\n        range.selectNodeContents(editor);\n        const selection = $.w.getSelection();\n        selection.removeAllRanges();\n        selection.addRange(range);\n    };\n\n    /**\n     * End editing and save changes\n     */\n    view.edit_node_end = function () {\n        if (!editing_node || !multiline_editor) {\n            return;\n        }\n\n        const node = editing_node;\n        const topic = (multiline_editor.textContent || '')\n            .trim()\n            .replace(/\\r\\n/g, '\\n')\n            .replace(/\\r/g, '\\n')\n            .replace(/\\n{3,}/g, '\\n\\n');\n\n        // Clean up editor\n        cleanup_editor();\n\n        // Update node if content changed\n        if (!jsMind.util.text.is_empty(topic) && node.topic !== topic) {\n            jm.update_node(node.id, topic);\n        } else {\n            view.render_node(node._data.view.element, node);\n        }\n\n        // Focus panel\n        view.e_panel.focus();\n    };\n\n    /**\n     * Cancel editing without saving changes\n     */\n    function cancel_editing() {\n        if (!editing_node || !multiline_editor) {\n            return;\n        }\n\n        const node = editing_node;\n\n        // Clean up editor\n        cleanup_editor();\n\n        // Re-render node\n        view.render_node(node._data.view.element, node);\n\n        // Focus panel\n        view.e_panel.focus();\n    }\n\n    /**\n     * Clean up editor and reset state\n     */\n    function cleanup_editor() {\n        if (!editing_node || !multiline_editor) {\n            return;\n        }\n\n        const element = editing_node._data.view.element;\n\n        // Remove editor\n        if (multiline_editor.parentNode) {\n            multiline_editor.parentNode.removeChild(multiline_editor);\n        }\n\n        // Reset styles and state\n        element.style.zIndex = 'auto';\n        editing_node = null;\n        view.editing_node = null;\n        multiline_editor = null;\n    }\n}\n\n// Register plugin\njsMind.register_plugin(new jsMind.plugin('multiline_text', init));\n\n// Export for ES6 modules\nexport default {\n    name: 'multiline_text',\n    init,\n    createMultilineRender,\n};\n"],"names":["jsMind","Error","$","DEFAULT_OPTIONS","text_width","line_height","createMultilineRender","options","opts","Object","assign","jm","element","node","topic","includes","style","whiteSpace","wordBreak","maxWidth","textContent","init","console","log","view","editing_node","multiline_editor","cleanup_editor","_data","parentNode","removeChild","zIndex","custom_node_render","render_node","_custom_node_render","bind","mind","root","nodesToUpdate","nodeId","nodes","push","layout","is_visible","width","clientWidth","height","clientHeight","show","_rerender_all_nodes","edit_node_begin","edit_node_end","editor","c","contentEditable","className","minHeight","lineHeight","border","outline","boxSizing","overflow","autoExpand","scrollHeight","on","setTimeout","e","key","shiftKey","preventDefault","stopPropagation","e_panel","focus","cancel_editing","innerHTML","appendChild","range","d","createRange","selectNodeContents","selection","w","getSelection","removeAllRanges","addRange","trim","replace","util","text","is_empty","update_node","id","register_plugin","plugin","jsmind_multilineText","name"],"mappings":"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"}

package/lib/jsmind.screenshot.js

@@ -0,0 +1,9 @@
+/**
+* @license BSD-3-Clause
+* @copyright 2014-2025 hizzgdev@163.com
+*
+* Project Home:
+*   https://github.com/hizzgdev/jsmind/
+*/
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@umbraci/jsmind"),t=require("dom-to-image");function i(e){return e&&"object"==typeof e&&"default"in e?e:{default:e}}var n=i(e),r=i(t);if(!n.default)throw new Error("jsMind is not defined");if(!r.default)throw new Error("dom-to-image is required");const o=n.default.$,s={filename:null,watermark:{left:o.w.location,right:"https://github.com/UmbraCi/jsmind"},background:"transparent"};class a{constructor(e,t){var i={};n.default.util.json.merge(i,s),n.default.util.json.merge(i,t),this.version="0.2.0",this.jm=e,this.options=i,this.dpr=e.view.device_pixel_ratio}shoot(){let e=this.create_canvas(),t=e.getContext("2d");t.scale(this.dpr,this.dpr),Promise.resolve(t).then(()=>this.draw_background(t)).then(()=>this.draw_lines(t)).then(()=>this.draw_nodes(t)).then(()=>this.draw_watermark(e,t)).then(()=>this.download(e)).then(()=>this.clear(e))}create_canvas(){let e=o.c("canvas");const t=this.jm.view.size.w,i=this.jm.view.size.h;return e.width=t*this.dpr,e.height=i*this.dpr,e.style.width=t+"px",e.style.height=i+"px",e.style.visibility="hidden",this.jm.view.e_panel.appendChild(e),e}clear(e){e.parentNode.removeChild(e)}draw_background(e){return new Promise(function(t,i){const n=this.options.background;n&&"transparent"!==n&&(e.fillStyle=this.options.background,e.fillRect(0,0,this.jm.view.size.w,this.jm.view.size.h)),t(e)}.bind(this))}draw_lines(e){return new Promise(function(t,i){this.jm.view.graph.copy_to(e,function(){t(e)})}.bind(this))}draw_nodes(e){return r.default.toSvg(this.jm.view.e_nodes,{style:{zoom:1}}).then(this.load_image).then(function(t){return e.drawImage(t,0,0),e})}draw_watermark(e,t){return t.textBaseline="bottom",t.fillStyle="#000",t.font="11px Verdana,Arial,Helvetica,sans-serif",this.options.watermark.left&&(t.textAlign="left",t.fillText(this.options.watermark.left,5.5,e.height-2.5)),this.options.watermark.right&&(t.textAlign="right",t.fillText(this.options.watermark.right,e.width-5.5,e.height-2.5)),t}load_image(e){return new Promise(function(t,i){let n=new Image;n.onload=function(){t(n)},n.onerror=i,n.src=e})}download(e){var t=(this.options.filename||this.jm.mind.name)+".png";if(navigator.msSaveBlob&&e.msToBlob){var i=e.msToBlob();navigator.msSaveBlob(i,t)}else{var n=e.toDataURL(),r=o.c("a");if("download"in r){r.style.visibility="hidden",r.href=n,r.download=t,o.d.body.appendChild(r);var s=o.d.createEvent("MouseEvents");s.initEvent("click",!0,!0),r.dispatchEvent(s),o.d.body.removeChild(r)}else location.href=n}}}const l=new n.default.plugin("screenshot",function(e,t){var i=new a(e,t);e.screenshot=i,e.shoot=function(){i.shoot()}});n.default.register_plugin(l),exports.JmScreenshot=a,exports.default=a,exports.screenshot_plugin=l;
+//# sourceMappingURL=jsmind.screenshot.js.map

package/lib/jsmind.screenshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsmind.screenshot.js","sources":["../src/plugins/jsmind.screenshot.js"],"sourcesContent":["/**\n * @license BSD\n * @copyright 2014-2025 UmbraCi\n *\n * Project Home:\n *   https://github.com/UmbraCi/jsmind/\n */\n\nimport jsMind from '@umbraci/jsmind';\nimport domtoimage from 'dom-to-image';\n\nif (!jsMind) {\n    throw new Error('jsMind is not defined');\n}\n\nif (!domtoimage) {\n    throw new Error('dom-to-image is required');\n}\n\nconst $ = jsMind.$;\n\n/**\n * Default options for screenshot plugin.\n * @typedef {Object} ScreenshotOptions\n * @property {string|null} [filename]\n * @property {{left?:string|Location,right?:string}} [watermark]\n * @property {string} [background]\n */\nconst DEFAULT_OPTIONS = {\n    filename: null,\n    watermark: {\n        left: $.w.location,\n        right: 'https://github.com/UmbraCi/jsmind',\n    },\n    background: 'transparent',\n};\n\n/**\n * Screenshot plugin for jsMind.\n */\nexport class JmScreenshot {\n    /**\n     * Create screenshot plugin instance.\n     * @param {import('../jsmind.js').default} jm - jsMind instance\n     * @param {Partial<ScreenshotOptions>} options - Plugin options\n     */\n    constructor(jm, options) {\n        var opts = {};\n        jsMind.util.json.merge(opts, DEFAULT_OPTIONS);\n        jsMind.util.json.merge(opts, options);\n\n        this.version = '0.2.0';\n        /** @type {import('../jsmind.js').default} */\n        this.jm = jm;\n        /** @type {ScreenshotOptions} */\n        this.options = opts;\n        /** @type {number} */\n        this.dpr = jm.view.device_pixel_ratio;\n    }\n\n    /** Take a screenshot of the mind map. */\n    shoot() {\n        let c = this.create_canvas();\n        let ctx = c.getContext('2d');\n        ctx.scale(this.dpr, this.dpr);\n        Promise.resolve(ctx)\n            .then(() => this.draw_background(ctx))\n            .then(() => this.draw_lines(ctx))\n            .then(() => this.draw_nodes(ctx))\n            .then(() => this.draw_watermark(c, ctx))\n            .then(() => this.download(c))\n            .then(() => this.clear(c));\n    }\n\n    /**\n     * Create canvas for screenshot.\n     * @returns {HTMLCanvasElement} Canvas element\n     */\n    create_canvas() {\n        let c = $.c('canvas');\n        const w = this.jm.view.size.w;\n        const h = this.jm.view.size.h;\n        c.width = w * this.dpr;\n        c.height = h * this.dpr;\n        c.style.width = w + 'px';\n        c.style.height = h + 'px';\n\n        c.style.visibility = 'hidden';\n        this.jm.view.e_panel.appendChild(c);\n        return c;\n    }\n\n    /**\n     * Clean up canvas element.\n     * @param {HTMLCanvasElement} c - Canvas to remove\n     */\n    clear(c) {\n        c.parentNode.removeChild(c);\n    }\n\n    /**\n     * Draw background on canvas.\n     * @param {CanvasRenderingContext2D} ctx - Canvas context\n     * @returns {Promise<CanvasRenderingContext2D>} Promise resolving to context\n     */\n    draw_background(ctx) {\n        return new Promise(\n            function (resolve, _) {\n                const bg = this.options.background;\n                if (!!bg && bg !== 'transparent') {\n                    ctx.fillStyle = this.options.background;\n                    ctx.fillRect(0, 0, this.jm.view.size.w, this.jm.view.size.h);\n                }\n                resolve(ctx);\n            }.bind(this)\n        );\n    }\n\n    /**\n     * Draw connection lines on canvas by copying from view graph.\n     * @param {CanvasRenderingContext2D} ctx\n     * @returns {Promise<CanvasRenderingContext2D>}\n     */\n    draw_lines(ctx) {\n        return new Promise(\n            function (resolve, _) {\n                this.jm.view.graph.copy_to(ctx, function () {\n                    resolve(ctx);\n                });\n            }.bind(this)\n        );\n    }\n\n    /**\n     * Draw node DOM into canvas via SVG snapshot.\n     * @param {CanvasRenderingContext2D} ctx\n     * @returns {Promise<CanvasRenderingContext2D>}\n     */\n    draw_nodes(ctx) {\n        return domtoimage\n            .toSvg(this.jm.view.e_nodes, { style: { zoom: 1 } })\n            .then(this.load_image)\n            .then(function (img) {\n                ctx.drawImage(img, 0, 0);\n                return ctx;\n            });\n    }\n\n    /**\n     * Draw watermark text on canvas.\n     * @param {HTMLCanvasElement} c\n     * @param {CanvasRenderingContext2D} ctx\n     * @returns {CanvasRenderingContext2D}\n     */\n    draw_watermark(c, ctx) {\n        ctx.textBaseline = 'bottom';\n        ctx.fillStyle = '#000';\n        ctx.font = '11px Verdana,Arial,Helvetica,sans-serif';\n        if (!!this.options.watermark.left) {\n            ctx.textAlign = 'left';\n            ctx.fillText(this.options.watermark.left, 5.5, c.height - 2.5);\n        }\n        if (!!this.options.watermark.right) {\n            ctx.textAlign = 'right';\n            ctx.fillText(this.options.watermark.right, c.width - 5.5, c.height - 2.5);\n        }\n        return ctx;\n    }\n\n    /**\n     * Load image from URL and resolve img element.\n     * @param {string} url\n     * @returns {Promise<HTMLImageElement>}\n     */\n    load_image(url) {\n        return new Promise(function (resolve, reject) {\n            let img = new Image();\n            img.onload = function () {\n                resolve(img);\n            };\n            img.onerror = reject;\n            img.src = url;\n        });\n    }\n\n    /**\n     * Trigger download of canvas content as PNG.\n     * @param {HTMLCanvasElement} c\n     */\n    download(c) {\n        var name = (this.options.filename || this.jm.mind.name) + '.png';\n\n        if (navigator.msSaveBlob && !!c.msToBlob) {\n            var blob = c.msToBlob();\n            navigator.msSaveBlob(blob, name);\n        } else {\n            var blob_url = c.toDataURL();\n            var anchor = $.c('a');\n            if ('download' in anchor) {\n                anchor.style.visibility = 'hidden';\n                anchor.href = blob_url;\n                anchor.download = name;\n                $.d.body.appendChild(anchor);\n                var evt = $.d.createEvent('MouseEvents');\n                evt.initEvent('click', true, true);\n                anchor.dispatchEvent(evt);\n                $.d.body.removeChild(anchor);\n            } else {\n                location.href = blob_url;\n            }\n        }\n    }\n}\n\n/**\n * Screenshot plugin registration.\n * @type {import('../jsmind.plugin.js').Plugin<Partial<ScreenshotOptions>>}\n */\nexport const screenshot_plugin = new jsMind.plugin('screenshot', function (jm, options) {\n    var jmss = new JmScreenshot(jm, options);\n    jm.screenshot = jmss;\n    jm.shoot = function () {\n        jmss.shoot();\n    };\n});\n\njsMind.register_plugin(screenshot_plugin);\n\nexport default JmScreenshot;\n"],"names":["jsMind","Error","domtoimage","$","DEFAULT_OPTIONS","filename","watermark","left","w","location","right","background","JmScreenshot","constructor","jm","options","opts","util","json","merge","this","version","dpr","view","device_pixel_ratio","shoot","c","create_canvas","ctx","getContext","scale","Promise","resolve","then","draw_background","draw_lines","draw_nodes","draw_watermark","download","clear","size","h","width","height","style","visibility","e_panel","appendChild","parentNode","removeChild","_","bg","fillStyle","fillRect","bind","graph","copy_to","toSvg","e_nodes","zoom","load_image","img","drawImage","textBaseline","font","textAlign","fillText","url","reject","Image","onload","onerror","src","name","mind","navigator","msSaveBlob","msToBlob","blob","blob_url","toDataURL","anchor","href","d","body","evt","createEvent","initEvent","dispatchEvent","screenshot_plugin","plugin","jmss","screenshot","register_plugin"],"mappings":"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"}

package/package.json

@@ -1,30 +1,38 @@
 {
     "name": "@umbraci/jsmind",
-    "version": "0.9.8",
+    "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": "es6/jsmind.js",
+    "main": "lib/jsmind.js",
+    "module": "es/jsmind.js",
+    "unpkg": "dist/jsmind.js",
+    "jsdelivr": "dist/jsmind.js",
     "types": "types/generated/index.d.ts",
     "exports": {
         ".": {
-            "import": "./es6/jsmind.esm.js",
-            "require": "./es6/jsmind.js",
+            "import": "./es/jsmind.js",
+            "require": "./lib/jsmind.js",
             "types": "./types/generated/index.d.ts"
         },
         "./draggable-node": {
-            "import": "./es6/jsmind.draggable-node.esm.js",
-            "require": "./es6/jsmind.draggable-node.js",
+            "import": "./es/jsmind.draggable-node.js",
+            "require": "./lib/jsmind.draggable-node.js",
             "types": "./types/generated/plugins/jsmind.draggable-node.d.ts"
         },
         "./screenshot": {
-            "import": "./es6/jsmind.screenshot.esm.js",
-            "require": "./es6/jsmind.screenshot.js",
+            "import": "./es/jsmind.screenshot.js",
+            "require": "./lib/jsmind.screenshot.js",
             "types": "./types/generated/plugins/jsmind.screenshot.d.ts"
         },
         "./multiline-text": {
-            "import": "./es6/jsmind.multiline-text.esm.js",
-            "require": "./es6/jsmind.multiline-text.js",
+            "import": "./es/jsmind.multiline-text.js",
+            "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": {
@@ -32,7 +40,9 @@
         "example": "example"
     },
     "files": [
-        "es6",
+        "es",
+        "lib",
+        "dist",
         "style",
         "types",
         "LICENSE",
@@ -72,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",
@@ -88,5 +100,8 @@
     },
     "sideEffects": [
         "./es6/*"
-    ]
+    ],
+    "dependencies": {
+        "fast-equals": "^5.3.2"
+    }
 }

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

@@ -1,9 +1,9 @@
 /**
  * @license BSD
- * @copyright 2014-2025 hizzgdev@163.com
+ * @copyright 2014-2025 UmbraCi
  *
  * Project Home:
- *   https://github.com/hizzgdev/jsmind/
+ *   https://github.com/UmbraCi/jsmind/
  */
 /**
  * Library version string.
@@ -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

@@ -5,7 +5,7 @@
 /**
  * jsMind runtime: orchestrates data/layout/view/shortcut and exposes public API.
  */
-export default class jsMind {
+declare class jsMind {
     static mind: typeof Mind;
     static node: typeof Node;
     static direction: import("./jsmind.common.js").DirectionType;
@@ -14,6 +14,8 @@ export default class jsMind {
         resize: number;
         edit: number;
         select: number;
+        reset: number;
+        history_change: number;
     };
     static $: {
         w: Window;
@@ -44,6 +46,22 @@ export default class jsMind {
             is_empty: (s?: string) => boolean;
         };
     };
+    static enhanced_plugin: typeof EnhancedPlugin;
+    /** @type {Array<import('./jsmind.enhanced-plugin.js').PluginDescriptor>} */
+    static enhancedPluginList: Array<import("./jsmind.enhanced-plugin.js").PluginDescriptor>;
+    /**
+     * Register an enhanced plugin
+     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     * @param {object} [options={}] - Plugin options
+     * @returns {typeof jsMind}
+     */
+    static usePlugin(PluginClass: typeof EnhancedPlugin, options?: object): typeof jsMind;
+    /**
+     * Check if an enhanced plugin is registered
+     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     * @returns {boolean}
+     */
+    static hasEnhancedPlugin(PluginClass: typeof EnhancedPlugin): boolean;
     /**
      * Deprecated: static show constructor helper.
      * @param {import('./jsmind.option.js').JsMindRuntimeOptions} options
@@ -64,6 +82,7 @@ export default class jsMind {
     event_handles: Array<(type: number, data: EventData) => void>;
     /** Initialize sub-systems and plugins. */
     init(): void;
+    enhancedPluginManager: EnhancedPluginManager;
     data: DataProvider;
     layout: LayoutProvider;
     view: ViewProvider;
@@ -347,7 +366,26 @@ export default class jsMind {
     invoke_event_handle(type: number, data: EventData): void;
     /** @param {number} type @param {EventData} data */
     _invoke_event_handle(type: number, data: EventData): void;
+    /**
+     * Remove an enhanced plugin
+     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     */
+    removePlugin(PluginClass: typeof EnhancedPlugin): void;
+    removePlugin(PluginClass: typeof EnhancedPlugin): void;
+    /**
+     * Get an enhanced plugin instance
+     * @param {string} instanceName - Plugin instance name
+     * @returns {EnhancedPlugin | undefined}
+     */
+    getPlugin(instanceName: string): EnhancedPlugin | undefined;
+    getPlugin(instanceName: string): EnhancedPlugin | undefined;
+    /**
+     * Destroy the jsMind instance and clean up resources
+     */
+    destroy(): void;
+    destroy(): void;
 }
+export default jsMind;
 /**
  * Event callback payload
  */
@@ -356,11 +394,14 @@ export type EventData = {
     data?: unknown[];
     node?: string;
 };
+export namespace jsMind { }
 import { Mind } from './jsmind.mind.js';
+import { EnhancedPluginManager } from './jsmind.enhanced-plugin.js';
 import { DataProvider } from './jsmind.data_provider.js';
 import { LayoutProvider } from './jsmind.layout_provider.js';
 import { ViewProvider } from './jsmind.view_provider.js';
 import { ShortcutProvider } from './jsmind.shortcut_provider.js';
+import { EnhancedPlugin } from './jsmind.enhanced-plugin.js';
 import { Node } from './jsmind.node.js';
 import { Plugin } from './jsmind.plugin.js';
 import { register as _register_plugin } from './jsmind.plugin.js';

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

@@ -1,10 +1,10 @@
 export const $: Dom;
 /**
  * @license BSD
- * @copyright 2014-2025 hizzgdev@163.com
+ * @copyright 2014-2025 UmbraCi
  *
  * Project Home:
- *   https://github.com/hizzgdev/jsmind/
+ *   https://github.com/UmbraCi/jsmind/
  */
 /**
  * Lightweight DOM helpers bound to a window.

package/types/generated/jsmind.enhanced-plugin.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Enhanced Plugin Manager
+ * Manages the lifecycle of enhanced plugins with synchronous initialization,
+ * preload support, and lifecycle hooks.
+ */
+export class EnhancedPluginManager {
+    /**
+     * @param {import('./jsmind.js').default} jm - jsMind instance
+     */
+    constructor(jm: import("./jsmind.js").default);
+    jm: import("./jsmind.js").default;
+    /** @type {Map<string, EnhancedPlugin>} */
+    plugins: Map<string, EnhancedPlugin>;
+    /**
+     * Initialize preload plugins (before core modules)
+     */
+    initPreloadPlugins(): void;
+    /**
+     * Initialize normal plugins (after core modules)
+     */
+    initNormalPlugins(): void;
+    /**
+     * Internal method: Initialize a single plugin
+     * @param {PluginDescriptor} descriptor
+     * @private
+     */
+    private _initPlugin;
+    /**
+     * Remove a plugin
+     * @param {typeof EnhancedPlugin} PluginClass
+     */
+    removePlugin(PluginClass: typeof EnhancedPlugin): void;
+    /**
+     * Destroy all plugins
+     */
+    destroyAllPlugins(): void;
+    /**
+     * Get plugin instance by name
+     * @param {string} instanceName
+     * @returns {EnhancedPlugin | undefined}
+     */
+    getPlugin(instanceName: string): EnhancedPlugin | undefined;
+}
+/**
+ * Enhanced Plugin Base Class
+ * Provides standard interface for enhanced plugins
+ */
+export class EnhancedPlugin {
+    /**
+     * Plugin instance name (must be defined by subclass)
+     * @type {string}
+     */
+    static instanceName: string;
+    /**
+     * Whether to initialize before core modules
+     * @type {boolean}
+     */
+    static preload: boolean;
+    /**
+     * @param {{ jm: import('./jsmind.js').default, pluginOpt: object }} params
+     */
+    constructor({ jm, pluginOpt }: {
+        jm: import("./jsmind.js").default;
+        pluginOpt: object;
+    });
+    jm: import("./jsmind.js").default;
+    options: any;
+    /**
+     * Called before plugin is removed
+     * Override this method to clean up resources
+     */
+    beforePluginRemove(): void;
+    /**
+     * Called before jsMind instance is destroyed
+     * Override this method to clean up resources
+     */
+    beforePluginDestroy(): void;
+}
+/**
+ * Plugin descriptor
+ */
+export type PluginDescriptor = {
+    /**
+     * - Plugin class
+     */
+    PluginClass: typeof EnhancedPlugin;
+    /**
+     * - Plugin instance name
+     */
+    instanceName: string;
+    /**
+     * - Whether to preload
+     */
+    preload: boolean;
+    /**
+     * - Plugin options
+     */
+    pluginOpt: object;
+    /**
+     * - Plugin instance (after initialization)
+     */
+    instance: EnhancedPlugin | null;
+};

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;
     /**