@umbraci/jsmind 0.10.14 → 0.10.15

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

@@ -0,0 +1,129 @@
+export class Mind {
+    /** @type {string | null} */
+    name: string | null;
+    /** @type {string | null} */
+    author: string | null;
+    /** @type {string | null} */
+    version: string | null;
+    /** @type {Node | null} */
+    root: Node | null;
+    /** @type {Node | null} */
+    selected: Node | null;
+    /** @type {Set<Node>} */
+    selected_nodes: Set<Node>;
+    /** @type {Record<string, Node>} */
+    nodes: Record<string, Node>;
+    /**
+     * Get a node by id.
+     * @param {string} node_id
+     * @returns {Node | null}
+     */
+    get_node(node_id: string): Node | null;
+    /**
+     * Set the root node, only once.
+     * @param {string} node_id
+     * @param {string} topic
+     * @param {Record<string, any>=} data
+     * @returns {Node | null}
+     */
+    set_root(node_id: string, topic: string, data?: Record<string, any> | undefined): Node | null;
+    /**
+     * Add a child node under parent.
+     * @param {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)
+     * @param {boolean=} expanded
+     * @param {number=} idx
+     * @returns {Node | null}
+     */
+    add_node(parent_node: Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined, expanded?: boolean | undefined, idx?: number | undefined): Node | null;
+    /**
+     * Insert a node before target node.
+     * @param {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 {Node | null}
+     */
+    insert_node_before(node_before: Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): Node | null;
+    /**
+     * Get previous sibling of a node or node id.
+     * @param {string | Node} node
+     * @returns {Node | null}
+     */
+    get_node_before(node: string | Node): Node | null;
+    /**
+     * Insert a node after target node.
+     * @param {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 {Node | null}
+     */
+    insert_node_after(node_after: Node, node_id: string, topic: string, data?: Record<string, any> | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): Node | null;
+    /**
+     * Get next sibling of a node or node id.
+     * @param {string | Node} node
+     * @returns {Node | null}
+     */
+    get_node_after(node: string | Node): Node | null;
+    /**
+     * Move a node to new parent/position.
+     * @param {Node} node
+     * @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)
+     * @returns {Node | null}
+     */
+    move_node(node: Node, before_id?: string | undefined, parent_id?: string | undefined, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): Node | null;
+    /**
+     * Propagate direction to descendants.
+     * @param {Node} node
+     * @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)
+     */
+    _flow_node_direction(node: Node, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): void;
+    /**
+     * Re-index node among siblings based on before_id marker.
+     * @param {Node} node
+     * @param {string} before_id
+     * @returns {Node}
+     */
+    _move_node_internal(node: Node, before_id: string): Node;
+    /**
+     * Internal move implementation.
+     * @param {Node} node
+     * @param {string} before_id
+     * @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)
+     * @returns {Node | null}
+     */
+    _move_node(node: Node, before_id: string, parent_id: string, direction?: ("left" | "center" | "right" | "-1" | "0" | "1" | number) | undefined): Node | null;
+    /**
+     * Remove a node from the mind.
+     * @param {Node} node
+     * @returns {boolean}
+     */
+    remove_node(node: Node): boolean;
+    /**
+     * Remove a node and its subtree from the cached selection set.
+     * @param {Node} node
+     * @private
+     */
+    private _purge_selection;
+    /**
+     * Put node into the map if id is not taken.
+     * @param {Node} node
+     * @returns {boolean}
+     */
+    _put_node(node: Node): boolean;
+    /**
+     * Re-index children by Node.compare.
+     * @param {Node} node
+     */
+    _update_index(node: Node): void;
+}
+import { Node } from './jsmind.node.js';

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

@@ -0,0 +1,69 @@
+export class Node {
+    /**
+     * Compare two nodes by index for ordering.
+     * @param {Node} node1
+     * @param {Node} node2
+     * @returns {number}
+     */
+    static compare(node1: Node, node2: Node): number;
+    /**
+     * Check if node is the same as or a descendant of parent_node.
+     * @param {Node} parent_node
+     * @param {Node} node
+     * @returns {boolean}
+     */
+    static inherited(parent_node: Node, node: Node): boolean;
+    /**
+     * Runtime check for Node instance.
+     * @param {unknown} n
+     * @returns {n is Node}
+     */
+    static is_node(n: unknown): n is Node;
+    /**
+     * Create a Node instance.
+     * @param {string} sId - Node id
+     * @param {number} iIndex - Node index (order among siblings). Use -1 for tail
+     * @param {string} sTopic - Node topic text
+     * @param {Record<string, any>=} oData - Arbitrary node data
+     * @param {boolean=} bIsRoot - Whether it is the root node
+     * @param {Node | null=} oParent - Parent node
+     * @param {number=} eDirection - Direction for children under root (-1 left, 0 center, 1 right)
+     * @param {boolean=} bExpanded - Expanded state
+     */
+    constructor(sId: string, iIndex: number, sTopic: string, oData?: Record<string, any> | undefined, bIsRoot?: boolean | undefined, oParent?: (Node | null) | undefined, eDirection?: number | undefined, bExpanded?: boolean | undefined);
+    id: string;
+    index: number;
+    topic: string;
+    /** @type {Record<string, any>} */
+    data: Record<string, any>;
+    isroot: boolean;
+    parent: Node;
+    direction: number;
+    expanded: boolean;
+    /** @type {Node[]} */
+    children: Node[];
+    _data: {};
+    /**
+     * Get absolute location of this node in view coordinates.
+     * @returns {{x:number,y:number}}
+     */
+    get_location(): {
+        x: number;
+        y: number;
+    };
+    /**
+     * Get rendered size of this node.
+     * @returns {{w:number,h:number}}
+     */
+    get_size(): {
+        w: number;
+        h: number;
+    };
+    /**
+     * Convert node to plain object with custom field names.
+     * @param {Record<string,string>=} fieldNames - Field names mapping
+     * @param {boolean=} includeChildren - Whether to include children nodes (default: false)
+     * @returns {Record<string, any>} Plain object representation of node
+     */
+    toObject(fieldNames?: Record<string, string> | undefined, includeChildren?: boolean | undefined): Record<string, any>;
+}

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

@@ -0,0 +1,78 @@
+/**
+ * Merge user options with defaults. Throws if container missing.
+ * @param {JsMindRuntimeOptions} options
+ * @returns {JsMindRuntimeOptions}
+ */
+export function merge_option(options: JsMindRuntimeOptions): JsMindRuntimeOptions;
+export type JsMindRuntimeOptions = {
+    container: string | HTMLElement;
+    editable?: boolean;
+    theme?: (string | null);
+    mode?: ("full" | "side");
+    support_html?: boolean;
+    log_level?: "debug" | "info" | "warn" | "error" | "disable";
+    view?: {
+        engine?: "canvas" | "svg";
+        enable_device_pixel_ratio?: boolean;
+        hmargin?: number;
+        vmargin?: number;
+        line_width?: number;
+        line_color?: string;
+        line_style?: "curved" | "straight";
+        custom_line_render?: (this: object, arg: {
+            ctx: CanvasRenderingContext2D | SVGPathElement;
+            start_point: {
+                x: number;
+                y: number;
+            };
+            end_point: {
+                x: number;
+                y: number;
+            };
+        }) => void;
+        draggable?: boolean;
+        hide_scrollbars_when_draggable?: boolean;
+        node_overflow?: "hidden" | "wrap" | "visible";
+        zoom?: {
+            min?: number;
+            max?: number;
+            step?: number;
+            mask_key?: number;
+        };
+        custom_node_render?: (null | ((jm: import("./jsmind.js").default, ele: HTMLElement, node: import("./jsmind.node.js").Node) => void));
+        expander_style?: "char" | "number";
+    };
+    layout?: {
+        hspace?: number;
+        vspace?: number;
+        pspace?: number;
+        cousin_space?: number;
+    };
+    default_event_handle?: {
+        enable_mousedown_handle?: boolean;
+        enable_click_handle?: boolean;
+        enable_dblclick_handle?: boolean;
+        enable_mousewheel_handle?: boolean;
+    };
+    shortcut?: {
+        enable?: boolean;
+        handles?: Record<string, (jm: import("./jsmind.js").default, e: KeyboardEvent) => void>;
+        mapping?: Record<string, number | number[]>;
+        id_generator?: () => string;
+    };
+    selection?: {
+        enable_multi_select?: boolean;
+        include_descendants?: boolean;
+        filter?: (node: import("./jsmind.node.js").Node) => boolean;
+    };
+    fieldNames?: {
+        id?: string;
+        topic?: string;
+        children?: string;
+        parentid?: string;
+        isroot?: string;
+        direction?: string;
+        expanded?: string;
+    };
+    plugin?: Record<string, object>;
+};

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

@@ -0,0 +1,21 @@
+/**
+ * Register a plugin instance.
+ * @param {Plugin<object>} plugin
+ */
+export function register(plugin: Plugin<object>): void;
+/**
+ * Apply registered plugins asynchronously.
+ * @param {import('./jsmind.js').default} jm
+ * @param {Record<string, object>} options
+ */
+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
+     */
+    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;
+}

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

@@ -0,0 +1,52 @@
+export class ShortcutProvider {
+    /**
+     * @param {import('./jsmind.js').default} jm
+     * @param {{ enable:boolean, handles: Record<string,(jm: import('./jsmind.js').default, e: KeyboardEvent)=>void>, mapping: Record<string, number|number[]>, id_generator?: ()=>string }} options
+     */
+    constructor(jm: import("./jsmind.js").default, options: {
+        enable: boolean;
+        handles: Record<string, (jm: import("./jsmind.js").default, e: KeyboardEvent) => void>;
+        mapping: Record<string, number | number[]>;
+        id_generator?: () => string;
+    });
+    jm: import("./jsmind.js").default;
+    opts: {
+        enable: boolean;
+        handles: Record<string, (jm: import("./jsmind.js").default, e: KeyboardEvent) => void>;
+        mapping: Record<string, number | number[]>;
+        id_generator?: () => string;
+    };
+    /** @type {Record<string, number|number[]>} */
+    mapping: Record<string, number | number[]>;
+    /** @type {Record<string,(jm: import('./jsmind.js').default, e: KeyboardEvent)=>void>} */
+    handles: Record<string, (jm: import("./jsmind.js").default, e: KeyboardEvent) => void>;
+    /** @type {()=>string|null} */
+    _newid: () => string | null;
+    /** @type {Record<number,(jm: import('./jsmind.js').default, e: KeyboardEvent)=>void>} */
+    _mapping: Record<number, (jm: import("./jsmind.js").default, e: KeyboardEvent) => void>;
+    init(): void;
+    enable_shortcut(): void;
+    disable_shortcut(): void;
+    /** @param {KeyboardEvent} e */
+    handler(e: KeyboardEvent): boolean;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_addchild(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_addbrother(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_editnode(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_delnode(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_toggle(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_up(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_down(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_left(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e */
+    handle_right(_jm: import("./jsmind.js").default, e: KeyboardEvent): void;
+    /** @param {import('./jsmind.js').default} _jm @param {KeyboardEvent} e @param {number} d */
+    _handle_direction(_jm: import("./jsmind.js").default, e: KeyboardEvent, d: number): void;
+}

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

@@ -0,0 +1,26 @@
+/**
+ * Misc utility collection.
+ * @type {{
+ *  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 }
+ * }}
+ */
+export const 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;
+    };
+};