@acorex/components 20.2.47 → 20.2.49

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "20.2.47",
+  "version": "20.2.49",
   "peerDependencies": {
-    "@acorex/core": "20.2.47",
-    "@acorex/cdk": "20.2.47",
+    "@acorex/core": "20.2.49",
+    "@acorex/cdk": "20.2.49",
     "@angular/common": "^20.0.0",
     "@angular/core": "^20.0.0",
     "@angular/cdk": "^20.0.0",

package/tree-view/index.d.ts

@@ -235,6 +235,138 @@ declare class AXTreeViewComponent {
      * Check if a node is currently loading
      */
     isNodeLoading(nodeId: string): boolean;
+    /**
+     * Edit/update a node's properties
+     * @param nodeId - The ID of the node to edit
+     * @param updates - Partial node object with properties to update
+     * @returns true if node was found and updated, false otherwise
+     */
+    editNode(nodeId: string, updates: Partial<AXTreeViewNode>): boolean;
+    /**
+     * Add a child node to a parent node
+     * @param parentId - The ID of the parent node
+     * @param childNode - The child node to add
+     * @param index - Optional index to insert at (default: append to end)
+     * @returns true if parent was found and child was added, false otherwise
+     */
+    addChild(parentId: string, childNode: AXTreeViewNode, index?: number): boolean;
+    /**
+     * Remove a node from the tree
+     * @param nodeId - The ID of the node to remove
+     * @returns The removed node if found, null otherwise
+     */
+    removeNode(nodeId: string): AXTreeViewNode | null;
+    /**
+     * Expand a specific node
+     * @param nodeId - The ID of the node to expand
+     * @returns Promise that resolves when expansion is complete (if lazy loading)
+     */
+    expandNode(nodeId: string): Promise<void>;
+    /**
+     * Collapse a specific node
+     * @param nodeId - The ID of the node to collapse
+     */
+    collapseNode(nodeId: string): void;
+    /**
+     * Toggle expansion state of a specific node
+     * @param nodeId - The ID of the node to toggle
+     * @returns Promise that resolves when toggle is complete (if lazy loading)
+     */
+    toggleNodeExpansion(nodeId: string): Promise<void>;
+    /**
+     * Programmatically select a node
+     * @param nodeId - The ID of the node to select
+     * @returns true if node was found and selected, false otherwise
+     */
+    selectNode(nodeId: string): boolean;
+    /**
+     * Programmatically deselect a node
+     * @param nodeId - The ID of the node to deselect
+     * @returns true if node was found and deselected, false otherwise
+     */
+    deselectNode(nodeId: string): boolean;
+    /**
+     * Get parent node of a given node
+     * @param nodeId - The ID of the node
+     * @returns The parent node if found, null otherwise
+     */
+    getParent(nodeId: string): AXTreeViewNode | null;
+    /**
+     * Get children of a node
+     * @param nodeId - The ID of the parent node
+     * @returns Array of child nodes, or null if node not found
+     */
+    getChildren(nodeId: string): AXTreeViewNode[] | null;
+    /**
+     * Get all root nodes
+     * @returns Array of root nodes
+     */
+    getRootNodes(): AXTreeViewNode[];
+    /**
+     * Get all nodes in a flat array
+     * @returns Array of all nodes in the tree
+     */
+    getAllNodes(): AXTreeViewNode[];
+    /**
+     * Get the path to a node (array of parent IDs from root to node)
+     * @param nodeId - The ID of the node
+     * @returns Array of node IDs representing the path, or empty array if node not found
+     */
+    getNodePath(nodeId: string): string[];
+    /**
+     * Get the level/depth of a node (0 = root level)
+     * @param nodeId - The ID of the node
+     * @returns The level of the node, or -1 if node not found
+     */
+    getNodeLevel(nodeId: string): number;
+    /**
+     * Programmatically move a node to a new parent
+     * @param nodeId - The ID of the node to move
+     * @param newParentId - The ID of the new parent (undefined for root level)
+     * @param index - Optional index to insert at (default: append to end)
+     * @returns true if move was successful, false otherwise
+     */
+    moveNode(nodeId: string, newParentId?: string, index?: number): boolean;
+    /**
+     * Clone a node (creates a deep copy)
+     * @param nodeId - The ID of the node to clone
+     * @returns The cloned node, or null if node not found
+     */
+    cloneNode(nodeId: string): AXTreeViewNode | null;
+    /**
+     * Focus a specific node by ID
+     * @param nodeId - The ID of the node to focus
+     * @returns true if node was found and focused, false otherwise
+     */
+    focusNode(nodeId: string): boolean;
+    /**
+     * Get all expanded nodes
+     * @returns Array of expanded nodes
+     */
+    getExpandedNodes(): AXTreeViewNode[];
+    /**
+     * Get all collapsed nodes that have children
+     * @returns Array of collapsed nodes with children
+     */
+    getCollapsedNodes(): AXTreeViewNode[];
+    /**
+     * Check if a node is expanded
+     * @param nodeId - The ID of the node
+     * @returns true if node is expanded, false otherwise
+     */
+    isNodeExpanded(nodeId: string): boolean;
+    /**
+     * Check if a node is selected
+     * @param nodeId - The ID of the node
+     * @returns true if node is selected, false otherwise
+     */
+    isNodeSelected(nodeId: string): boolean;
+    /**
+     * Check if a node has children
+     * @param nodeId - The ID of the node
+     * @returns true if node has children, false otherwise
+     */
+    hasChildren(nodeId: string): boolean;
     /**
      * Get template context for a node
      */
@@ -317,8 +449,14 @@ declare class AXTreeViewComponent {
     private loadNodeChildren;
     /**
      * Internal method to refresh nodes signal and sync back to datasource if it's an array
+     * Creates new array references for all nested children to ensure reactivity
      */
     private refreshNodes;
+    /**
+     * Recursively ensure all children arrays have new references to trigger change detection
+     * Mutates the tree structure by replacing children arrays with new array references
+     */
+    private ensureNewArrayReferences;
     /**
      * Handle single selection mode
      */
@@ -501,6 +639,33 @@ declare class AXTreeViewService {
      * Get list prefix constant
      */
     getListPrefix(): string;
+    /**
+     * Get all nodes in a flat array
+     */
+    getAllNodes(nodes: AXTreeViewNode[]): AXTreeViewNode[];
+    /**
+     * Get the path to a node (array of parent nodes from root to node)
+     */
+    getNodePath(nodes: AXTreeViewNode[], nodeId: string): AXTreeViewNode[];
+    /**
+     * Get the level/depth of a node (0 = root level)
+     */
+    getNodeLevel(nodes: AXTreeViewNode[], nodeId: string): number;
+    /**
+     * Get sibling nodes of a given node
+     */
+    getSiblings(nodes: AXTreeViewNode[], nodeId: string): AXTreeViewNode[];
+    /**
+     * Clone a node (creates a deep copy)
+     */
+    cloneNode(node: AXTreeViewNode): AXTreeViewNode;
+    /**
+     * Validate node structure (check for required fields and circular references)
+     */
+    validateNode(node: AXTreeViewNode, visitedIds?: Set<string>): {
+        valid: boolean;
+        errors: string[];
+    };
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXTreeViewService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXTreeViewService>;
 }