@umbraci/jsmind 0.10.17 → 1.0.0-beta

package/lib/jsmind.screenshot.js.map

@@ -1 +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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"}
+{"version":3,"file":"jsmind.screenshot.js","sources":["../src/jsmind.common.js","../src/jsmind.plugin.js","../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\n/**\n * Library version string.\n * @type {string}\n */\nexport const __version__ = '0.9.1';\n/**\n * Library author.\n * @type {string}\n */\nexport const __author__ = 'UmbraCi';\n\nif (typeof String.prototype.startsWith != 'function') {\n    String.prototype.startsWith = function (p) {\n        return this.slice(0, p.length) === p;\n    };\n}\n\n/**\n * Direction constants and parser.\n * @typedef {{left:number,center:number,right:number,of:(dir:(string|number))=>number|undefined}} DirectionType\n */\n/** @type {DirectionType} */\nexport const Direction = {\n    left: -1,\n    center: 0,\n    right: 1,\n    of: function (dir) {\n        if (!dir || dir === -1 || dir === 0 || dir === 1) {\n            return dir;\n        }\n        if (dir === '-1' || dir === '0' || dir === '1') {\n            return parseInt(dir);\n        }\n        if (dir.toLowerCase() === 'left') {\n            return this.left;\n        }\n        if (dir.toLowerCase() === 'right') {\n            return this.right;\n        }\n        if (dir.toLowerCase() === 'center') {\n            return this.center;\n        }\n    },\n};\n/** @enum {number} */\nexport const EventType = { show: 1, resize: 2, edit: 3, select: 4, reset: 5, history_change: 6 };\n/** @enum {number} */\nexport const Key = { meta: 1 << 13, ctrl: 1 << 12, alt: 1 << 11, shift: 1 << 10 };\n/** @enum {number} */\nexport const LogLevel = { debug: 1, info: 2, warn: 3, error: 4, disable: 9 };\n\n// an noop function define\nvar _noop = function () {};\n/**\n * Logger facade with dynamic level.\n * @type {{level:(lvl:number)=>void,log:Function,debug:Function,info:Function,warn:Function,error:Function}}\n */\nexport let logger =\n    typeof console === 'undefined'\n        ? {\n              level: _noop,\n              log: _noop,\n              debug: _noop,\n              info: _noop,\n              warn: _noop,\n              error: _noop,\n          }\n        : {\n              level: setup_logger_level,\n              log: console.log,\n              debug: console.debug,\n              info: console.info,\n              warn: console.warn,\n              error: console.error,\n          };\n\n/**\n * Set logger level.\n * @param {number} log_level\n */\nfunction setup_logger_level(log_level) {\n    if (log_level > LogLevel.debug) {\n        logger.debug = _noop;\n    } else {\n        logger.debug = console.debug;\n    }\n    if (log_level > LogLevel.info) {\n        logger.info = _noop;\n    } else {\n        logger.info = console.info;\n    }\n    if (log_level > LogLevel.warn) {\n        logger.warn = _noop;\n    } else {\n        logger.warn = console.warn;\n    }\n    if (log_level > LogLevel.error) {\n        logger.error = _noop;\n    } else {\n        logger.error = console.error;\n    }\n}\n","/**\n * @license BSD\n * @copyright 2014-2025 UmbraCi\n *\n * Project Home:\n *   https://github.com/UmbraCi/jsmind/\n */\n\nimport { logger } from './jsmind.common.js';\n\n/**\n * Plugin Manager\n * Manages plugin lifecycle with synchronous initialization,\n * preload support, and lifecycle hooks.\n */\nexport class PluginManager {\n    /**\n     * @param {import('./jsmind.js').default} jm - jsMind instance\n     */\n    constructor(jm) {\n        this.jm = jm;\n        /** @type {Map<string, Plugin>} */\n        this.plugins = new Map();\n    }\n\n    /**\n     * Initialize preload plugins (before core modules)\n     */\n    initPreloadPlugins() {\n        const preloadPlugins = this.jm.constructor.pluginList.filter(d => d.preload);\n        logger.info('Initializing ' + preloadPlugins.length + ' preload plugins');\n        preloadPlugins.forEach(descriptor => {\n            this._initPlugin(descriptor);\n        });\n    }\n\n    /**\n     * Initialize normal plugins (after core modules)\n     */\n    initNormalPlugins() {\n        const normalPlugins = this.jm.constructor.pluginList.filter(d => !d.preload);\n        logger.info('Initializing ' + normalPlugins.length + ' normal plugins');\n        normalPlugins.forEach(descriptor => {\n            this._initPlugin(descriptor);\n        });\n    }\n\n    /**\n     * Internal method: Initialize a single plugin\n     * @param {PluginDescriptor} descriptor\n     * @private\n     */\n    _initPlugin(descriptor) {\n        try {\n            const { PluginClass, pluginOpt } = descriptor;\n\n            if (!PluginClass.instanceName) {\n                throw new Error('Plugin ' + PluginClass.name + ' must define static instanceName');\n            }\n            if (this.plugins.has(PluginClass.instanceName)) {\n                logger.warn(\n                    'Plugin ' + PluginClass.instanceName + ' already exists, will be replaced'\n                );\n            }\n\n            const instance = new PluginClass({\n                jm: this.jm,\n                pluginOpt: pluginOpt || {},\n            });\n\n            this.plugins.set(PluginClass.instanceName, instance);\n            this.jm[PluginClass.instanceName] = instance;\n            descriptor.instance = instance;\n\n            logger.info('Plugin ' + PluginClass.instanceName + ' initialized');\n        } catch (error) {\n            logger.error('Failed to initialize plugin ' + descriptor.PluginClass.name + ':', error);\n        }\n    }\n\n    /**\n     * Remove a plugin\n     * @param {typeof Plugin} PluginClass\n     */\n    removePlugin(PluginClass) {\n        const instanceName = PluginClass.instanceName;\n        if (!instanceName) {\n            return;\n        }\n\n        const instance = this.plugins.get(instanceName);\n        if (!instance) {\n            return;\n        }\n\n        try {\n            if (typeof instance.beforePluginRemove === 'function') {\n                instance.beforePluginRemove();\n            }\n\n            this.plugins.delete(instanceName);\n            delete this.jm[instanceName];\n\n            const list = this.jm.constructor.pluginList;\n            const index = list.findIndex(d => d.PluginClass === PluginClass);\n            if (index !== -1) {\n                list.splice(index, 1);\n            }\n\n            logger.info('Plugin ' + instanceName + ' removed');\n        } catch (error) {\n            logger.error('Failed to remove plugin ' + instanceName + ':', error);\n        }\n    }\n\n    /**\n     * Destroy all plugins\n     */\n    destroyAllPlugins() {\n        this.plugins.forEach((instance, instanceName) => {\n            try {\n                if (typeof instance.beforePluginDestroy === 'function') {\n                    instance.beforePluginDestroy();\n                }\n            } catch (error) {\n                logger.error('Failed to destroy plugin ' + instanceName + ':', error);\n            }\n        });\n\n        this.plugins.clear();\n    }\n\n    /**\n     * Get plugin instance by name\n     * @param {string} instanceName\n     * @returns {Plugin | undefined}\n     */\n    getPlugin(instanceName) {\n        return this.plugins.get(instanceName);\n    }\n}\n\n/**\n * Plugin Base Class\n * Provides standard plugin interface.\n */\nexport class Plugin {\n    /**\n     * Plugin instance name (must be defined by subclass)\n     * @type {string}\n     */\n    static instanceName = '';\n\n    /**\n     * Whether to initialize before core modules\n     * @type {boolean}\n     */\n    static preload = false;\n\n    /**\n     * @param {{ jm: import('./jsmind.js').default, pluginOpt: object }} params\n     */\n    constructor({ jm, pluginOpt }) {\n        this.jm = jm;\n        this.options = pluginOpt || {};\n    }\n\n    /**\n     * Called before plugin is removed\n     */\n    beforePluginRemove() {}\n\n    /**\n     * Called before jsMind instance is destroyed\n     */\n    beforePluginDestroy() {\n        this.beforePluginRemove();\n    }\n}\n\n/**\n * Plugin descriptor\n * @typedef {object} PluginDescriptor\n * @property {typeof Plugin} PluginClass - Plugin class\n * @property {string} instanceName - Plugin instance name\n * @property {boolean} preload - Whether to preload\n * @property {object} pluginOpt - Plugin options\n * @property {Plugin | null} instance - Plugin instance (after initialization)\n */\n","/**\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';\nimport { Plugin } from '../jsmind.plugin.js';\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 for unified plugin system.\n */\nexport class ScreenshotPlugin extends Plugin {\n    static instanceName = 'screenshot';\n    static preload = false;\n\n    /**\n     * @param {{ jm: import('../jsmind.js').default, pluginOpt: Partial<ScreenshotOptions> }} params\n     */\n    constructor({ jm, pluginOpt }) {\n        super({ jm, pluginOpt });\n        this.screenshot = new JmScreenshot(jm, pluginOpt);\n        jm.screenshot = this.screenshot;\n        jm.shoot = () => {\n            this.screenshot.shoot();\n        };\n    }\n\n    beforePluginRemove() {\n        delete this.jm.shoot;\n        delete this.jm.screenshot;\n    }\n}\n\njsMind.usePlugin(ScreenshotPlugin);\n\nexport default JmScreenshot;\n"],"names":["String","prototype","startsWith","p","this","slice","length","Plugin","static","constructor","jm","pluginOpt","options","beforePluginRemove","beforePluginDestroy","jsMind","Error","domtoimage","$","DEFAULT_OPTIONS","filename","watermark","left","w","location","right","background","JmScreenshot","opts","util","json","merge","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","ScreenshotPlugin","super","screenshot","usePlugin"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@umbraci/jsmind",
-    "version": "0.10.17",
+    "version": "1.0.0-beta",
     "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",
@@ -13,29 +13,9 @@
             "require": "./lib/jsmind.js",
             "types": "./types/generated/index.d.ts"
         },
-        "./draggable-node": {
-            "import": "./es/jsmind.draggable-node.js",
-            "require": "./lib/jsmind.draggable-node.js",
-            "types": "./types/generated/plugins/jsmind.draggable-node.d.ts"
-        },
-        "./screenshot": {
-            "import": "./es/jsmind.screenshot.js",
-            "require": "./lib/jsmind.screenshot.js",
-            "types": "./types/generated/plugins/jsmind.screenshot.d.ts"
-        },
-        "./multiline-text": {
-            "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/history/jsmind.history.d.ts"
-        },
-        "./multi-select": {
-            "import": "./es/jsmind.multi-select.js",
-            "require": "./lib/jsmind.multi-select.js"
+        "./*": {
+            "import": "./es/jsmind.*.js",
+            "require": "./lib/jsmind.*.js"
         },
         "./style/jsmind.css": "./style/jsmind.css"
     },
@@ -54,8 +34,10 @@
     ],
     "scripts": {
         "server": "http-server",
+        "sync-plugins": "node scripts/sync-plugins.mjs",
+        "prebuild": "npm run sync-plugins",
         "build": "rollup -c .config/rollup.config.js",
-        "build-types": "npx -p typescript tsc -p types/tsconfig.declaration.json",
+        "build-types": "npm run sync-plugins && npx -p typescript tsc -p types/tsconfig.declaration.json",
         "test": "NODE_OPTIONS=--experimental-vm-modules jest tests/unit",
         "test-es6": "NODE_OPTIONS=--experimental-vm-modules jest tests/unit",
         "test-types": "NODE_OPTIONS=--experimental-vm-modules jest tests/types",
@@ -111,5 +93,24 @@
     ],
     "dependencies": {
         "fast-equals": "^5.3.2"
+    },
+    "typesVersions": {
+        "*": {
+            "draggable-node": [
+                "types/generated/plugins/jsmind.draggable-node.d.ts"
+            ],
+            "history": [
+                "types/generated/plugins/history/jsmind.history.d.ts"
+            ],
+            "multi-select": [
+                "types/generated/plugins/jsmind.multi-select.d.ts"
+            ],
+            "multiline-text": [
+                "types/generated/plugins/jsmind.multiline-text.d.ts"
+            ],
+            "screenshot": [
+                "types/generated/plugins/jsmind.screenshot.d.ts"
+            ]
+        }
     }
 }

package/types/generated/jsmind.d.ts

@@ -28,7 +28,6 @@ declare class jsMind {
         on: (t: HTMLElement, e: string, h: (ev: Event) => void) => void;
     };
     static plugin: typeof Plugin;
-    static register_plugin: typeof _register_plugin;
     static util: {
         file: {
             read: (file: File, cb: (result: string, name: string) => void) => void;
@@ -46,22 +45,22 @@ declare 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>;
+    static plugin_base: typeof Plugin;
+    /** @type {Array<import('./jsmind.plugin.js').PluginDescriptor>} */
+    static pluginList: Array<import("./jsmind.plugin.js").PluginDescriptor>;
     /**
-     * Register an enhanced plugin
-     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     * Register a plugin
+     * @param {typeof Plugin} PluginClass - Plugin class
      * @param {object} [options={}] - Plugin options
      * @returns {typeof jsMind}
      */
-    static usePlugin(PluginClass: typeof EnhancedPlugin, options?: object): typeof jsMind;
+    static usePlugin(PluginClass: typeof Plugin, options?: object): typeof jsMind;
     /**
-     * Check if an enhanced plugin is registered
-     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     * Check if a plugin is registered
+     * @param {typeof Plugin} PluginClass - Plugin class
      * @returns {boolean}
      */
-    static hasEnhancedPlugin(PluginClass: typeof EnhancedPlugin): boolean;
+    static hasPlugin(PluginClass: typeof Plugin): boolean;
     /**
      * Deprecated: static show constructor helper.
      * @param {import('./jsmind.option.js').JsMindRuntimeOptions} options
@@ -82,7 +81,7 @@ declare class jsMind {
     event_handles: Array<(type: number, data: EventData) => void>;
     /** Initialize sub-systems and plugins. */
     init(): void;
-    enhancedPluginManager: EnhancedPluginManager;
+    pluginManager: PluginManager;
     data: DataProvider;
     layout: LayoutProvider;
     view: ViewProvider;
@@ -305,7 +304,7 @@ declare class jsMind {
      */
     remove_node(node: string | import("./jsmind.node.js").Node): boolean;
     /**
-     * Update node topic text or multiple node properties.
+     * Update the topic (text content) of a node, or update multiple node properties.
      * @param {string} node_id - The ID of the node to update
      * @param {string|Partial<Pick<import('./jsmind.node.js').Node, 'topic' | 'data' | 'id' | 'index' | 'expanded' | 'direction'>>} topic_or_updates - Topic string for backward compatibility, or partial Node object for comprehensive updates
      */
@@ -398,18 +397,18 @@ declare class jsMind {
     /** @param {number} type @param {EventData} data */
     _invoke_event_handle(type: number, data: EventData): void;
     /**
-     * Remove an enhanced plugin
-     * @param {typeof EnhancedPlugin} PluginClass - Plugin class
+     * Remove a plugin
+     * @param {typeof Plugin} PluginClass - Plugin class
      */
-    removePlugin(PluginClass: typeof EnhancedPlugin): void;
-    removePlugin(PluginClass: typeof EnhancedPlugin): void;
+    removePlugin(PluginClass: typeof Plugin): void;
+    removePlugin(PluginClass: typeof Plugin): void;
     /**
-     * Get an enhanced plugin instance
+     * Get a plugin instance
      * @param {string} instanceName - Plugin instance name
-     * @returns {EnhancedPlugin | undefined}
+     * @returns {Plugin | undefined}
      */
-    getPlugin(instanceName: string): EnhancedPlugin | undefined;
-    getPlugin(instanceName: string): EnhancedPlugin | undefined;
+    getPlugin(instanceName: string): Plugin | undefined;
+    getPlugin(instanceName: string): Plugin | undefined;
     /**
      * Destroy the jsMind instance and clean up resources
      */
@@ -427,12 +426,10 @@ export type EventData = {
 };
 export namespace jsMind { }
 import { Mind } from './jsmind.mind.js';
-import { EnhancedPluginManager } from './jsmind.enhanced-plugin.js';
+import { PluginManager } from './jsmind.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';
+import { Node } from './jsmind.node.js';

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

@@ -106,6 +106,13 @@ export class Mind {
      * @returns {boolean}
      */
     remove_node(node: Node): boolean;
+    /**
+     * Change a node id while preserving object references.
+     * @param {string} old_id
+     * @param {string} new_id
+     * @returns {boolean}
+     */
+    change_node_id(old_id: string, new_id: string): boolean;
     /**
      * Put node into the map if id is not taken.
      * @param {Node} node

package/types/generated/{jsmind.enhanced-plugin.d.ts → jsmind.plugin-system.d.ts}

@@ -3,14 +3,14 @@
  * Manages the lifecycle of enhanced plugins with synchronous initialization,
  * preload support, and lifecycle hooks.
  */
-export class EnhancedPluginManager {
+export class PluginManager {
     /**
      * @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>;
+    /** @type {Map<string, Plugin>} */
+    plugins: Map<string, Plugin>;
     /**
      * Initialize preload plugins (before core modules)
      */
@@ -27,9 +27,9 @@ export class EnhancedPluginManager {
     private _initPlugin;
     /**
      * Remove a plugin
-     * @param {typeof EnhancedPlugin} PluginClass
+     * @param {typeof Plugin} PluginClass
      */
-    removePlugin(PluginClass: typeof EnhancedPlugin): void;
+    removePlugin(PluginClass: typeof Plugin): void;
     /**
      * Destroy all plugins
      */
@@ -37,15 +37,15 @@ export class EnhancedPluginManager {
     /**
      * Get plugin instance by name
      * @param {string} instanceName
-     * @returns {EnhancedPlugin | undefined}
+     * @returns {Plugin | undefined}
      */
-    getPlugin(instanceName: string): EnhancedPlugin | undefined;
+    getPlugin(instanceName: string): Plugin | undefined;
 }
 /**
  * Enhanced Plugin Base Class
  * Provides standard interface for enhanced plugins
  */
-export class EnhancedPlugin {
+export class Plugin {
     /**
      * Plugin instance name (must be defined by subclass)
      * @type {string}
@@ -83,7 +83,7 @@ export type PluginDescriptor = {
     /**
      * - Plugin class
      */
-    PluginClass: typeof EnhancedPlugin;
+    PluginClass: typeof Plugin;
     /**
      * - Plugin instance name
      */
@@ -99,5 +99,5 @@ export type PluginDescriptor = {
     /**
      * - Plugin instance (after initialization)
      */
-    instance: EnhancedPlugin | null;
+    instance: Plugin | null;
 };

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

@@ -1,21 +1,101 @@
 /**
- * Register a plugin instance.
- * @param {Plugin<object>} plugin
+ * Plugin Manager
+ * Manages plugin lifecycle with synchronous initialization,
+ * preload support, and lifecycle hooks.
  */
-export function register(plugin: Plugin<object>): void;
+export class PluginManager {
+    /**
+     * @param {import('./jsmind.js').default} jm - jsMind instance
+     */
+    constructor(jm: import("./jsmind.js").default);
+    jm: import("./jsmind.js").default;
+    /** @type {Map<string, Plugin>} */
+    plugins: Map<string, Plugin>;
+    /**
+     * 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 Plugin} PluginClass
+     */
+    removePlugin(PluginClass: typeof Plugin): void;
+    /**
+     * Destroy all plugins
+     */
+    destroyAllPlugins(): void;
+    /**
+     * Get plugin instance by name
+     * @param {string} instanceName
+     * @returns {Plugin | undefined}
+     */
+    getPlugin(instanceName: string): Plugin | undefined;
+}
 /**
- * Apply registered plugins asynchronously.
- * @param {import('./jsmind.js').default} jm
- * @param {Record<string, object>} options
+ * Plugin Base Class
+ * Provides standard plugin interface.
  */
-export function apply(jm: import("./jsmind.js").default, options: Record<string, object>): void;
 export class Plugin {
     /**
-     * @template [TOptions=object]
-     * @param {string} name
-     * @param {(jm: import('./jsmind.js').default, options: TOptions)=>void} fn_init
+     * Plugin instance name (must be defined by subclass)
+     * @type {string}
+     */
+    static instanceName: string;
+    /**
+     * Whether to initialize before core modules
+     * @type {boolean}
      */
-    constructor(name: string, fn_init: (jm: import("./jsmind.js").default, options: TOptions) => void);
-    name: string;
-    fn_init: (jm: import("./jsmind.js").default, options: TOptions) => void;
+    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
+     */
+    beforePluginRemove(): void;
+    /**
+     * Called before jsMind instance is destroyed
+     */
+    beforePluginDestroy(): void;
 }
+/**
+ * Plugin descriptor
+ */
+export type PluginDescriptor = {
+    /**
+     * - Plugin class
+     */
+    PluginClass: typeof Plugin;
+    /**
+     * - Plugin instance name
+     */
+    instanceName: string;
+    /**
+     * - Whether to preload
+     */
+    preload: boolean;
+    /**
+     * - Plugin options
+     */
+    pluginOpt: object;
+    /**
+     * - Plugin instance (after initialization)
+     */
+    instance: Plugin | null;
+};

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

@@ -316,7 +316,7 @@ export class ViewProvider {
         y: number;
     }): void;
     /** @param {import('./jsmind.node.js').Node} node */
-    _get_expander_text(node: import("./jsmind.node.js").Node): number | "..." | "-" | "+";
+    _get_expander_text(node: import("./jsmind.node.js").Node): number | "..." | "−" | "+";
     /** @param {HTMLElement} ele @param {import('./jsmind.node.js').Node} node */
     _default_node_render(ele: HTMLElement, node: import("./jsmind.node.js").Node): void;
     /** @param {HTMLElement} ele @param {import('./jsmind.node.js').Node} node */

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

@@ -255,6 +255,11 @@ export type FlattenOptions = {
      *     ['name', 'data', 'key'] to match the actual field names in the data.
      */
     fields?: string[];
+    /**
+     * - Array of field names to exclude from diff comparison. These fields will be ignored
+     *    even if they exist in the node data. Useful for filtering out temporary or UI-only fields.
+     */
+    excludeFields?: string[];
     /**
      * - The field name to use as the node ID. Defaults to 'id'.
      *     When using custom fieldNames (e.g., { id: 'key' }), this should be 'key'.
@@ -276,6 +281,11 @@ export type DiffOptions = {
      *     Note: When using jm.history.diff(), this is automatically handled.
      */
     fields?: string[];
+    /**
+     * - Array of field names to exclude from diff comparison. These fields will be ignored
+     *    even if they exist in the node data. Useful for filtering out temporary or UI-only fields.
+     */
+    excludeFields?: string[];
     /**
      * - The field name to use as the node ID. Defaults to 'id'.
      *     Note: When using jm.history.diff(), this is automatically handled.

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

@@ -5,7 +5,7 @@ export type DiffOptions = import("./history-diff.js").DiffOptions;
 /**
  * HistoryPlugin skeleton (Task 1)
  */
-export class HistoryPlugin extends EnhancedPlugin {
+export class HistoryPlugin extends Plugin {
     /**
      * @param {{ jm: JsMind, pluginOpt?: any }} params
      */
@@ -38,7 +38,7 @@ export class HistoryPlugin extends EnhancedPlugin {
     /** Mount public API on jm.history (placeholder defaults) */
     _mountAPI(): void;
 }
-import { EnhancedPlugin } from '../../jsmind.enhanced-plugin.js';
+import { Plugin } from '../../jsmind.plugin.js';
 declare class HistoryCore {
     /** @param {JsMind} jm @param {any} options */
     constructor(jm: JsMind, options: any);

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

@@ -241,10 +241,19 @@ export class DraggableNode {
     jm_event_handle(type: number | string, data?: object): void;
 }
 /**
- * Draggable node plugin registration.
- * @type {import('../jsmind.plugin.js').Plugin<Partial<DraggableNodeOptions>>}
+ * Draggable node plugin for unified plugin system.
  */
-export const draggable_plugin: import("../jsmind.plugin.js").Plugin<Partial<DraggableNodeOptions>>;
+export class DraggableNodePlugin extends Plugin {
+    /**
+     * @param {{ jm: import('../jsmind.js').default, pluginOpt: Partial<DraggableNodeOptions> }} params
+     */
+    constructor({ jm, pluginOpt }: {
+        jm: import("../jsmind.js").default;
+        pluginOpt: Partial<DraggableNodeOptions>;
+    });
+    draggable: DraggableNode;
+    _eventHandle: (type: any, data: any) => void;
+}
 export default DraggableNode;
 /**
  * Default options for draggable node plugin.
@@ -260,3 +269,4 @@ export type DraggableNodeOptions = {
     shadow_node_class_name?: string;
     validate_drag?: (draggedNode: import("../jsmind.node.js").Node, targetNode: import("../jsmind.node.js").Node | null) => boolean;
 };
+import { Plugin } from '../jsmind.plugin.js';

package/types/generated/plugins/jsmind.multi-select.d.ts

@@ -1,7 +1,7 @@
 /**
- * Multi-Select Plugin - Enhanced plugin for jsMind
+ * Multi-Select Plugin - Plugin for jsMind
  */
-export class MultiSelectPlugin extends EnhancedPlugin {
+export class MultiSelectPlugin extends Plugin {
     /**
      * @param {{ jm: import('../jsmind.js').default, pluginOpt: object }} params
      */
@@ -50,7 +50,7 @@ export type MultiSelectOptions = {
      */
     filter?: ((node: import("../jsmind.node.js").Node) => boolean) | null;
 };
-import { EnhancedPlugin } from '../jsmind.enhanced-plugin.js';
+import { Plugin } from '../jsmind.plugin.js';
 /**
  * Multi-Select Core - Handles all multi-select logic
  */