@umbraci/jsmind 0.9.1-rich-text

package/types/generated/jsmind.d.ts

@@ -0,0 +1,343 @@
+/**
+ * Event callback payload
+ * @typedef {{ evt?: string, data?: unknown[], node?: string }} EventData
+ */
+/**
+ * jsMind runtime: orchestrates data/layout/view/shortcut and exposes public API.
+ */
+export default class jsMind {
+    static mind: typeof Mind;
+    static node: typeof Node;
+    static direction: import("./jsmind.common.js").DirectionType;
+    static event_type: {
+        show: number;
+        resize: number;
+        edit: number;
+        select: number;
+    };
+    static $: {
+        w: Window;
+        d: Document;
+        g: (id: string) => HTMLElement | null;
+        c: (tag: string) => HTMLElement;
+        t: (n: HTMLElement, t: string) => void;
+        h: (n: HTMLElement, t: string | HTMLElement) => void;
+        i: (el: unknown) => el is HTMLElement;
+        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;
+            save: (data: string, type: string, name: string) => void;
+        };
+        json: {
+            json2string: (v: unknown) => string;
+            string2json: (s: string) => unknown;
+            merge: (b: object, a: object) => object;
+        };
+        uuid: {
+            newid: () => string;
+        };
+        text: {
+            is_empty: (s?: string) => boolean;
+        };
+    };
+    /**
+     * Deprecated: static show constructor helper.
+     * @param {import('./jsmind.option.js').JsMindRuntimeOptions} options
+     * @param {object | null} mind
+     * @returns {jsMind}
+     */
+    static show(options: import("./jsmind.option.js").JsMindRuntimeOptions, mind: object | null): jsMind;
+    /**
+     * Create a jsMind instance.
+     * @param {import('./jsmind.option.js').JsMindRuntimeOptions} options
+     */
+    constructor(options: import("./jsmind.option.js").JsMindRuntimeOptions);
+    options: import("./jsmind.option.js").JsMindRuntimeOptions;
+    version: string;
+    initialized: boolean;
+    mind: Mind;
+    /** @type {Array<(type: number, data: EventData) => void>} */
+    event_handles: Array<(type: number, data: EventData) => void>;
+    /** Initialize sub-systems and plugins. */
+    init(): void;
+    data: DataProvider;
+    layout: LayoutProvider;
+    view: ViewProvider;
+    shortcut: ShortcutProvider;
+    /** @returns {boolean} whether current mind map is editable */
+    get_editable(): boolean;
+    /** enable editing */
+    enable_edit(): void;
+    /** disable editing */
+    disable_edit(): void;
+    /** @returns {boolean} whether view is draggable */
+    get_view_draggable(): boolean;
+    /** enable view dragging */
+    enable_view_draggable(): void;
+    /** disable view dragging */
+    disable_view_draggable(): void;
+    /**
+     * Enable default event handle.
+     * @param {'mousedown'|'click'|'dblclick'|'mousewheel'} event_handle
+     */
+    enable_event_handle(event_handle: "mousedown" | "click" | "dblclick" | "mousewheel"): void;
+    /**
+     * Disable default event handle.
+     * @param {'mousedown'|'click'|'dblclick'|'mousewheel'} event_handle
+     */
+    disable_event_handle(event_handle: "mousedown" | "click" | "dblclick" | "mousewheel"): void;
+    /**
+     * Set theme name.
+     * @param {string|null=} theme
+     */
+    set_theme(theme?: (string | null) | undefined): void;
+    /** bind internal DOM events */
+    _event_bind(): void;
+    /** @param {MouseEvent} e */
+    mousedown_handle(e: MouseEvent): void;
+    /** @param {MouseEvent} e */
+    click_handle(e: MouseEvent): void;
+    /** @param {MouseEvent} e */
+    dblclick_handle(e: MouseEvent): void;
+    /** @param {WheelEvent} e */
+    mousewheel_handle(e: WheelEvent): void;
+    /**
+     * Begin editing a node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {boolean|void}
+     */
+    begin_edit(node: string | import("./jsmind.node.js").Node): boolean | void;
+    /** End editing */
+    end_edit(): void;
+    /**
+     * Toggle a node's expanded state.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {void}
+     */
+    toggle_node(node: string | import("./jsmind.node.js").Node): void;
+    /**
+     * Expand a node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {void}
+     */
+    expand_node(node: string | import("./jsmind.node.js").Node): void;
+    /**
+     * Collapse a node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {void}
+     */
+    collapse_node(node: string | import("./jsmind.node.js").Node): void;
+    /** Expand all nodes */
+    expand_all(): void;
+    /** Collapse all nodes */
+    collapse_all(): void;
+    /**
+     * Expand nodes up to a specified depth level.
+     * @param {number} depth
+     */
+    expand_to_depth(depth: number): void;
+    /** reset view/layout/data */
+    _reset(): void;
+    /**
+     * Internal show flow.
+     * @param {object | null} mind
+     * @param {boolean=} skip_centering
+     */
+    _show(mind: object | null, skip_centering?: boolean | undefined): void;
+    /**
+     * Show a mind (or example) on the canvas.
+     * @param {object | null} mind
+     * @param {boolean=} skip_centering
+     */
+    show(mind: object | null, skip_centering?: boolean | undefined): void;
+    /** @returns {{name:string,author:string,version:string}} */
+    get_meta(): {
+        name: string;
+        author: string;
+        version: string;
+    };
+    /**
+     * Serialize current mind to given format.
+     * @param {'node_tree'|'node_array'|'freemind'|'text'} [data_format]
+     * @returns {object}
+     */
+    get_data(data_format?: "node_tree" | "node_array" | "freemind" | "text"): object;
+    /** @returns {import('./jsmind.node.js').Node} */
+    get_root(): import("./jsmind.node.js").Node;
+    /**
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {import('./jsmind.node.js').Node}
+     */
+    get_node(node: string | import("./jsmind.node.js").Node): import("./jsmind.node.js").Node;
+    /**
+     * Add node data to the mind map without triggering UI refresh.
+     * @private
+     * @param {import('./jsmind.node.js').Node} parent_node
+     * @param {string} node_id
+     * @param {string} topic
+     * @param {Record<string, any>=} data
+     * @param {('left'|'center'|'right'|'-1'|'0'|'1'|number)=} direction
+     * @returns {import('./jsmind.node.js').Node|null}
+     */
+    private _add_node_data;
+    /**
+     * Refresh UI after node changes.
+     * @private
+     * @param {import('./jsmind.node.js').Node} parent_node
+     */
+    private _refresh_node_ui;
+    /**
+     * Add a new node to the mind map.
+     * @param {string | import('./jsmind.node.js').Node} parent_node
+     * @param {string} node_id
+     * @param {string} topic
+     * @param {Record<string, any>=} data
+     * @param {('left'|'center'|'right'|'-1'|'0'|'1'|number)=} direction - Direction for node placement. Supports string values ('left', 'center', 'right'), numeric strings ('-1', '0', '1'), and numbers (-1, 0, 1)
+     * @returns {import('./jsmind.node.js').Node|null}
+     */
+    add_node(parent_node: string | import("./jsmind.node.js").Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): import("./jsmind.node.js").Node | null;
+    /**
+     * Add multiple nodes to the mind map with optimized performance.
+     * @param {string | import('./jsmind.node.js').Node} parent_node - Parent node for all new nodes
+     * @param {Array<{node_id: string, topic: string, data?: Record<string, any>, direction?: ('left'|'center'|'right'|'-1'|'0'|'1'|number)}>} nodes_data - Array of node data objects
+     * @returns {Array<import('./jsmind.node.js').Node|null>} Array of created nodes
+     */
+    add_nodes(parent_node: string | import("./jsmind.node.js").Node, nodes_data: Array<{
+        node_id: string;
+        topic: string;
+        data?: Record<string, any>;
+        direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number);
+    }>): Array<import("./jsmind.node.js").Node | null>;
+    /**
+     * Insert a node before target node.
+     * @param {string | import('./jsmind.node.js').Node} node_before
+     * @param {string} node_id
+     * @param {string} topic
+     * @param {Record<string, any>=} data
+     * @param {('left'|'center'|'right'|'-1'|'0'|'1'|number)=} direction - Direction for node placement. Supports string values ('left', 'center', 'right'), numeric strings ('-1', '0', '1'), and numbers (-1, 0, 1)
+     * @returns {import('./jsmind.node.js').Node|null}
+     */
+    insert_node_before(node_before: string | import("./jsmind.node.js").Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): import("./jsmind.node.js").Node | null;
+    /**
+     * Insert a node after target node.
+     * @param {string | import('./jsmind.node.js').Node} node_after
+     * @param {string} node_id
+     * @param {string} topic
+     * @param {Record<string, any>=} data
+     * @param {('left'|'center'|'right'|'-1'|'0'|'1'|number)=} direction - Direction for node placement. Supports string values ('left', 'center', 'right'), numeric strings ('-1', '0', '1'), and numbers (-1, 0, 1)
+     * @returns {import('./jsmind.node.js').Node|null}
+     */
+    insert_node_after(node_after: string | import("./jsmind.node.js").Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): import("./jsmind.node.js").Node | null;
+    /**
+     * Remove a node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {boolean}
+     */
+    remove_node(node: string | import("./jsmind.node.js").Node): boolean;
+    /**
+     * Update the topic (text content) of a node.
+     * @param {string} node_id
+     * @param {string} topic
+     */
+    update_node(node_id: string, topic: string): void;
+    /**
+     * Move a node and optionally change direction.
+     * @param {string} node_id
+     * @param {string=} before_id - The ID of the node before which to place the moved node. Special values: "_first_", "_last_"
+     * @param {string=} parent_id
+     * @param {('left'|'center'|'right'|'-1'|'0'|'1'|number)=} direction - Direction for node placement. Supports string values ('left', 'center', 'right'), numeric strings ('-1', '0', '1'), and numbers (-1, 0, 1). Only effective for second-level nodes (children of root). If not provided, direction will be determined automatically.
+     */
+    move_node(node_id: string, before_id?: string | undefined, parent_id?: string | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): void;
+    /**
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {void}
+     */
+    select_node(node: string | import("./jsmind.node.js").Node): void;
+    /** @returns {import('./jsmind.node.js').Node|null} */
+    get_selected_node(): import("./jsmind.node.js").Node | null;
+    /** clear selection */
+    select_clear(): void;
+    /** @param {string | import('./jsmind.node.js').Node} node */
+    is_node_visible(node: string | import("./jsmind.node.js").Node): boolean;
+    /**
+     * Scroll the mind map to center the specified node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     */
+    scroll_node_to_center(node: string | import("./jsmind.node.js").Node): void;
+    /**
+     * Find the previous sibling node of the given node.
+     *
+     * @param {string | import('./jsmind.node.js').Node} node - Node id or Node instance
+     * @returns {import('./jsmind.node.js').Node | null}
+     */
+    find_node_before(node: string | import("./jsmind.node.js").Node): import("./jsmind.node.js").Node | null;
+    /**
+     * Find the next sibling node of the given node.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {import('./jsmind.node.js').Node | null}
+     */
+    find_node_after(node: string | import("./jsmind.node.js").Node): import("./jsmind.node.js").Node | null;
+    /**
+     * Set background and foreground colors for a node.
+     * @param {string} node_id
+     * @param {string=} bg_color
+     * @param {string=} fg_color
+     * @returns {void}
+     */
+    set_node_color(node_id: string, bg_color?: string | undefined, fg_color?: string | undefined): void;
+    /**
+     * Set font style for a node.
+     * @param {string} node_id
+     * @param {number=} size
+     * @param {string=} weight
+     * @param {string=} style
+     * @returns {void}
+     */
+    set_node_font_style(node_id: string, size?: number | undefined, weight?: string | undefined, style?: string | undefined): void;
+    /**
+     * Set background image for a node.
+     * @param {string} node_id
+     * @param {string=} image
+     * @param {number=} width
+     * @param {number=} height
+     * @param {number=} rotation
+     * @returns {void}
+     */
+    set_node_background_image(node_id: string, image?: string | undefined, width?: number | undefined, height?: number | undefined, rotation?: number | undefined): void;
+    /**
+     * @param {string} node_id
+     * @param {number} rotation
+     * @returns {void}
+     */
+    set_node_background_rotation(node_id: string, rotation: number): void;
+    /** trigger view resize */
+    resize(): void;
+    /** @param {(type:number, data: EventData)=>void} callback */
+    add_event_listener(callback: (type: number, data: EventData) => void): void;
+    /** clear event listeners */
+    clear_event_listener(): void;
+    /** @param {number} type @param {EventData} data */
+    invoke_event_handle(type: number, data: EventData): void;
+    /** @param {number} type @param {EventData} data */
+    _invoke_event_handle(type: number, data: EventData): void;
+}
+/**
+ * Event callback payload
+ */
+export type EventData = {
+    evt?: string;
+    data?: unknown[];
+    node?: string;
+};
+import { Mind } from './jsmind.mind.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 { Node } from './jsmind.node.js';
+import { Plugin } from './jsmind.plugin.js';
+import { register as _register_plugin } from './jsmind.plugin.js';

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

@@ -0,0 +1,56 @@
+export class DataProvider {
+    /**
+     * Data provider: loads and serializes mind data by format.
+     * @param {import('./jsmind.js').default} jm - jsMind instance
+     */
+    constructor(jm: import("./jsmind.js").default);
+    jm: import("./jsmind.js").default;
+    /** Initialize data provider. */
+    init(): void;
+    /** Reset data provider state. */
+    reset(): void;
+    /**
+     * Load a Mind from mixed source.
+     * @param {import('./jsmind.format.js').NodeTreeFormat|import('./jsmind.format.js').NodeArrayFormat|{meta?:{name:string,author:string,version:string},format:'freemind',data:string}|{meta?:{name:string,author:string,version:string},format:'text',data:string}} mind_data - object with {format,data} or a format-specific payload
+     * @returns {import('./jsmind.mind.js').Mind|null}
+     */
+    load(mind_data: import("./jsmind.format.js").NodeTreeFormat | import("./jsmind.format.js").NodeArrayFormat | {
+        meta?: {
+            name: string;
+            author: string;
+            version: string;
+        };
+        format: "freemind";
+        data: string;
+    } | {
+        meta?: {
+            name: string;
+            author: string;
+            version: string;
+        };
+        format: "text";
+        data: string;
+    }): import("./jsmind.mind.js").Mind | null;
+    /**
+     * Serialize current mind to target format.
+     * @param {'node_tree'|'node_array'|'freemind'|'text'} data_format
+     * @returns {import('./jsmind.format.js').NodeTreeFormat|import('./jsmind.format.js').NodeArrayFormat|{meta:{name:string,author:string,version:string},format:'freemind',data:string}|{meta:{name:string,author:string,version:string},format:'text',data:string}}
+     */
+    get_data(data_format: "node_tree" | "node_array" | "freemind" | "text"): import("./jsmind.format.js").NodeTreeFormat | import("./jsmind.format.js").NodeArrayFormat | {
+        meta: {
+            name: string;
+            author: string;
+            version: string;
+        };
+        format: "freemind";
+        data: string;
+    } | {
+        meta: {
+            name: string;
+            author: string;
+            version: string;
+        };
+        format: "text";
+        data: string;
+    };
+}

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

@@ -0,0 +1,59 @@
+export const $: Dom;
+/**
+ * @license BSD
+ * @copyright 2014-2025 hizzgdev@163.com
+ *
+ * Project Home:
+ *   https://github.com/hizzgdev/jsmind/
+ */
+/**
+ * Lightweight DOM helpers bound to a window.
+ */
+declare class Dom {
+    /**
+     * @param {Window} w
+     */
+    constructor(w: Window);
+    /** @type {Window} */
+    w: Window;
+    /** @type {Document} */
+    d: Document;
+    /**
+     * Get element by id.
+     * @param {string} id
+     * @returns {HTMLElement|null}
+     */
+    g: (id: string) => HTMLElement | null;
+    /**
+     * Create element with given tag.
+     * @param {string} tag
+     * @returns {HTMLElement}
+     */
+    c: (tag: string) => HTMLElement;
+    /**
+     * Set text content for element.
+     * @param {HTMLElement} n
+     * @param {string} t
+     */
+    t: (n: HTMLElement, t: string) => void;
+    /**
+     * Set inner HTML or append element.
+     * @param {HTMLElement} n
+     * @param {string|HTMLElement} t
+     */
+    h: (n: HTMLElement, t: string | HTMLElement) => void;
+    /**
+     * Runtime check for HTMLElement.
+     * @param {unknown} el
+     * @returns {el is HTMLElement}
+     */
+    i: (el: unknown) => el is HTMLElement;
+    /**
+     * Add event listener with legacy fallback.
+     * @param {HTMLElement} t
+     * @param {string} e
+     * @param {(ev:Event)=>void} h
+     */
+    on: (t: HTMLElement, e: string, h: (ev: Event) => void) => void;
+}
+export {};

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

@@ -0,0 +1,100 @@
+/**
+ * Mind data format handlers.
+ * @type {{
+ *  node_tree: { example:NodeTreeFormat, get_mind:(src:NodeTreeFormat)=>Mind, get_data:(mind:Mind)=>NodeTreeFormat },
+ *  node_array: { example:NodeArrayFormat, get_mind:(src:NodeArrayFormat)=>Mind, get_data:(mind:Mind)=>NodeArrayFormat },
+ *  freemind: { example:{meta:MindMapMeta,format:'freemind',data:string}, get_mind:(src:{meta?:MindMapMeta,format:'freemind',data:string})=>Mind, get_data:(mind:Mind)=>{meta:MindMapMeta,format:'freemind',data:string} },
+ *  text: { example:{meta:MindMapMeta,format:'text',data:string}, get_mind:(src:{meta?:MindMapMeta,format:'text',data:string})=>Mind, get_data:(mind:Mind)=>{meta:MindMapMeta,format:'text',data:string} }
+ * }}
+ */
+export const format: {
+    node_tree: {
+        example: NodeTreeFormat;
+        get_mind: (src: NodeTreeFormat) => Mind;
+        get_data: (mind: Mind) => NodeTreeFormat;
+    };
+    node_array: {
+        example: NodeArrayFormat;
+        get_mind: (src: NodeArrayFormat) => Mind;
+        get_data: (mind: Mind) => NodeArrayFormat;
+    };
+    freemind: {
+        example: {
+            meta: MindMapMeta;
+            format: "freemind";
+            data: string;
+        };
+        get_mind: (src: {
+            meta?: MindMapMeta;
+            format: "freemind";
+            data: string;
+        }) => Mind;
+        get_data: (mind: Mind) => {
+            meta: MindMapMeta;
+            format: "freemind";
+            data: string;
+        };
+    };
+    text: {
+        example: {
+            meta: MindMapMeta;
+            format: "text";
+            data: string;
+        };
+        get_mind: (src: {
+            meta?: MindMapMeta;
+            format: "text";
+            data: string;
+        }) => Mind;
+        get_data: (mind: Mind) => {
+            meta: MindMapMeta;
+            format: "text";
+            data: string;
+        };
+    };
+};
+export type MindMapMeta = {
+    name: string;
+    author: string;
+    version: string;
+};
+/**
+ * Node tree data item
+ */
+export type NodeTreeData = {
+    id: string;
+    topic: string;
+    data?: Record<string, any>;
+    direction?: (number | string);
+    expanded?: boolean;
+    children?: NodeTreeData[];
+};
+/**
+ * Node tree formatted payload
+ */
+export type NodeTreeFormat = {
+    meta?: MindMapMeta;
+    format: "node_tree";
+    data: NodeTreeData;
+};
+/**
+ * Node array data item
+ */
+export type NodeArrayItem = {
+    id: string;
+    topic: string;
+    parentid?: string;
+    data?: Record<string, any>;
+    direction?: (number | string);
+    expanded?: boolean;
+    isroot?: boolean;
+};
+/**
+ * Node array formatted payload
+ */
+export type NodeArrayFormat = {
+    meta?: MindMapMeta;
+    format: "node_array";
+    data: NodeArrayItem[];
+};
+import { Mind } from './jsmind.mind.js';