@umbraci/jsmind 0.10.10 → 0.10.12

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@umbraci/jsmind",
-    "version": "0.10.10",
+    "version": "0.10.12",
     "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",

package/types/generated/jsmind.d.ts

@@ -78,6 +78,10 @@ declare class jsMind {
     version: string;
     initialized: boolean;
     mind: Mind;
+    /** @type {'single'|'multi'|null} */
+    _selection_mode: "single" | "multi" | null;
+    /** @type {import('./jsmind.node.js').Node|null} */
+    _last_selected_node: import("./jsmind.node.js").Node | null;
     /** @type {Array<(type: number, data: EventData) => void>} */
     event_handles: Array<(type: number, data: EventData) => void>;
     /** Initialize sub-systems and plugins. */
@@ -305,14 +309,11 @@ declare class jsMind {
      */
     remove_node(node: string | import("./jsmind.node.js").Node): boolean;
     /**
-     * Update the topic (text content) and/or data of a node.
-     * @param {string} node_id
-     * @param {string|{topic?:string, data?:Record<string,any>}} topic_or_options - Topic string or options object
+     * Update node topic text or 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
      */
-    update_node(node_id: string, topic_or_options: string | {
-        topic?: string;
-        data?: Record<string, any>;
-    }): void;
+    update_node(node_id: string, topic_or_updates: string | Partial<Pick<import("./jsmind.node.js").Node, "topic" | "data" | "id" | "index" | "expanded" | "direction">>): void;
     /**
      * Move a node and optionally change direction.
      * @param {string} node_id
@@ -335,8 +336,24 @@ declare class jsMind {
      * @returns {import('./jsmind.node.js').Node|null} Node instance or null
      */
     get_selected_node(): import("./jsmind.node.js").Node | null;
+    /**
+     * Get all currently selected nodes.
+     * @returns {import('./jsmind.node.js').Node[]}
+     */
+    get_selected_nodes(): import("./jsmind.node.js").Node[];
     /** clear selection */
     select_clear(): void;
+    /**
+     * Toggle multi-selection for a node (and optionally descendants).
+     * @param {string | import('./jsmind.node.js').Node} node
+     */
+    toggle_subtree_selection(node: string | import("./jsmind.node.js").Node): void;
+    /**
+     * Determine whether a node is currently selected.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @returns {boolean}
+     */
+    is_node_selected(node: string | import("./jsmind.node.js").Node): boolean;
     /** @param {string | import('./jsmind.node.js').Node} node */
     is_node_visible(node: string | import("./jsmind.node.js").Node): boolean;
     /**
@@ -344,6 +361,180 @@ declare class jsMind {
      * @param {string | import('./jsmind.node.js').Node} node
      */
     scroll_node_to_center(node: string | import("./jsmind.node.js").Node): void;
+    /**
+     * Add nodes into the current selection set without clearing existing ones.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    /**
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @param {{focusNode?: import('./jsmind.node.js').Node}=} options
+     * @private
+     */
+    private _append_selection;
+    /**
+     * Remove nodes from the current selection set.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _remove_selection;
+    /**
+     * Deselect a node and all its descendants from the current selection.
+     * @param {string | import('./jsmind.node.js').Node} node
+     * @private
+     */
+    private _deselect_subtree;
+    /**
+     * Clear all current selections and return the nodes that were cleared.
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _clear_selection_state;
+    /**
+     * Collect a node and optionally its descendants respecting filters.
+     * @param {import('./jsmind.node.js').Node} node
+     * @param {{includeChildren?:boolean, respectFilter?:boolean, skipRootFilter?:boolean}=} config
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _collect_subtree_nodes;
+    /**
+     * Ensure ancestors of provided nodes are also selected (up to first selected ancestor).
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @param {import('./jsmind.node.js').Node=} focusNode
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    /**
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @param {import('./jsmind.node.js').Node=} focusNode
+     * @param {{requireAncestorChainSelected?: boolean}=} options
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _ensure_ancestor_selection;
+    /**
+     * Get the configured selection filter callback, if any.
+     * @returns {((node: import('./jsmind.node.js').Node)=>boolean)|null}
+     * @private
+     */
+    private _get_selection_filter;
+    /**
+     * Determine the multi-select mode based on event modifiers.
+     * Returns: null (single select), 'ctrl' (add/remove), 'shift' (range select)
+     * @param {MouseEvent} e
+     * @returns {null|'ctrl'|'shift'}
+     * @private
+     */
+    private _get_multi_select_mode;
+    /**
+     * Toggle selection of a single node (add if not selected, remove if selected).
+     * Used for Ctrl+Click behavior.
+     * @param {string | import('./jsmind.node.js').Node} node_id
+     * @private
+     */
+    private _toggle_node_selection;
+    /**
+     * Range select nodes for Shift+Click behavior.
+     * Logic:
+     * - If no nodes are currently selected: select all nodes under the clicked node
+     * - If nodes are already selected: select nodes in the range from first selected to clicked node
+     * @param {string | import('./jsmind.node.js').Node} node_id
+     * @private
+     */
+    private _range_select_nodes;
+    /**
+     * Find all nodes between two nodes (for range selection).
+     * This includes both nodes and all nodes in between them in tree order.
+     * @param {import('./jsmind.node.js').Node} node1
+     * @param {import('./jsmind.node.js').Node} node2
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _find_nodes_between;
+    /**
+     * Check whether ancestor is an ancestor of node.
+     * @param {import('./jsmind.node.js').Node} ancestor
+     * @param {import('./jsmind.node.js').Node} node
+     * @returns {boolean}
+     * @private
+     */
+    private _is_ancestor_of;
+    /**
+     * Return nodes along the ancestor->descendant chain, inclusive. If 'ancestor' is not actually
+     * an ancestor of 'descendant', returns empty array.
+     * @param {import('./jsmind.node.js').Node} ancestor
+     * @param {import('./jsmind.node.js').Node} descendant
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _get_path_nodes;
+    /**
+     * Find nearest selected ancestor of the given node from current selection set.
+     * @param {import('./jsmind.node.js').Node} node
+     * @returns {import('./jsmind.node.js').Node|null}
+     * @private
+     */
+    private _find_nearest_selected_ancestor;
+    /**
+     * Find lowest common ancestor of two nodes.
+     * @param {import('./jsmind.node.js').Node} a
+     * @param {import('./jsmind.node.js').Node} b
+     * @returns {import('./jsmind.node.js').Node|null}
+     * @private
+     */
+    private _find_lca;
+    /**
+     * Given a lowest common ancestor 'lca' and a descendant 'node',
+     * return the direct child of lca that lies on the path to node.
+     * Returns null if node is not a descendant of lca or node === lca.
+     * @param {import('./jsmind.node.js').Node} lca
+     * @param {import('./jsmind.node.js').Node} node
+     * @returns {import('./jsmind.node.js').Node|null}
+     * @private
+     */
+    private _child_on_path;
+    /**
+     * From a list of nodes, remove those that are ancestors of any other node in the same list.
+     * Keeps only the deepest nodes so that we don't auto-select parents implicitly.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _remove_ancestor_nodes;
+    /**
+     * From a list of nodes, remove those that are descendants of any other node in the same list.
+     * Keeps only top-most nodes so that expanding subtrees covers full branches across siblings.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @returns {import('./jsmind.node.js').Node[]}
+     * @private
+     */
+    private _remove_descendant_nodes;
+    /**
+     * Expand a set of base nodes with all their descendants (and themselves).
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @param {{respectFilter?: boolean}=} opts
+     * @returns {Set<import('./jsmind.node.js').Node>}
+     * @private
+     */
+    private _expand_with_descendants;
+    /**
+     * Promote parents into selection ONLY when all their direct children are selected
+     * AND at least one ancestor of that parent is already selected (in previous selection set).
+     * This avoids auto-selecting parents when only siblings are selected.
+     * @param {Set<import('./jsmind.node.js').Node>} set
+     * @returns {Set<import('./jsmind.node.js').Node>}
+     * @private
+     */
+    private _promote_parents_when_children_selected;
+    /**
+     * Determine selection mode based on current selection size.
+     * @returns {'single'|'multi'|null}
+     * @private
+     */
+    private _derive_selection_mode;
     /**
      * Find the previous sibling node of the given node.
      *

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

@@ -9,6 +9,8 @@ export class Mind {
     root: Node | null;
     /** @type {Node | null} */
     selected: Node | null;
+    /** @type {Set<Node>} */
+    selected_nodes: Set<Node>;
     /** @type {Record<string, Node>} */
     nodes: Record<string, Node>;
     /**
@@ -106,6 +108,12 @@ export class Mind {
      * @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

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

@@ -60,6 +60,11 @@ export type JsMindRuntimeOptions = {
         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;

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

@@ -71,6 +71,8 @@ export class ViewProvider {
         h: number;
     };
     selected_node: import("./jsmind.node.js").Node;
+    /** @type {Map<string, import('./jsmind.node.js').Node>} */
+    multi_selected_nodes: Map<string, import("./jsmind.node.js").Node>;
     editing_node: import("./jsmind.node.js").Node;
     graph: {
         view: ViewProvider;
@@ -253,6 +255,19 @@ export class ViewProvider {
     select_node(node: import("./jsmind.node.js").Node | null): void;
     /** Clear node selection. */
     select_clear(): void;
+    /**
+     * Append nodes to the current selection without clearing existing ones.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     * @param {import('./jsmind.node.js').Node=} focus_node
+     */
+    append_selected_nodes(nodes: import("./jsmind.node.js").Node[], focus_node?: import("./jsmind.node.js").Node | undefined): void;
+    /**
+     * Remove the provided nodes from selection state.
+     * @param {import('./jsmind.node.js').Node[]} nodes
+     */
+    remove_selected_nodes(nodes: import("./jsmind.node.js").Node[]): void;
+    /** Clear all selections at once. */
+    clear_all_selected_nodes(): void;
     /**
      * Get currently editing node.
      * @returns {import('./jsmind.node.js').Node|null} Currently editing node
@@ -329,6 +344,18 @@ export class ViewProvider {
     restore_selected_node_custom_style(node: import("./jsmind.node.js").Node): void;
     /** @param {import('./jsmind.node.js').Node} node */
     clear_selected_node_custom_style(node: import("./jsmind.node.js").Node): void;
+    /**
+     * Mark the DOM/state for a selected node.
+     * @param {import('./jsmind.node.js').Node} node
+     * @private
+     */
+    private _mark_node_selected;
+    /**
+     * Remove DOM/state selection for a node.
+     * @param {import('./jsmind.node.js').Node} node
+     * @private
+     */
+    private _unmark_node_selected;
     clear_lines(): void;
     show_lines(): void;
     /**