@acorex/components 21.0.2-next.36 → 21.0.2-next.38

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@acorex/components",
-  "version": "21.0.2-next.36",
+  "version": "21.0.2-next.38",
   "peerDependencies": {
-    "@acorex/core": "21.0.2-next.36",
-    "@acorex/cdk": "21.0.2-next.36",
+    "@acorex/core": "21.0.2-next.38",
+    "@acorex/cdk": "21.0.2-next.38",
     "polytype": ">=0.17.0",
     "angular-imask": ">=7.6.1",
     "gridstack": ">=12.0.0",
@@ -424,6 +424,10 @@
       "types": "./step-wizard/index.d.ts",
       "default": "./fesm2022/acorex-components-step-wizard.mjs"
     },
+    "./switch": {
+      "types": "./switch/index.d.ts",
+      "default": "./fesm2022/acorex-components-switch.mjs"
+    },
     "./tabs": {
       "types": "./tabs/index.d.ts",
       "default": "./fesm2022/acorex-components-tabs.mjs"
@@ -432,14 +436,14 @@
       "types": "./tag/index.d.ts",
       "default": "./fesm2022/acorex-components-tag.mjs"
     },
+    "./text-area": {
+      "types": "./text-area/index.d.ts",
+      "default": "./fesm2022/acorex-components-text-area.mjs"
+    },
     "./tag-box": {
       "types": "./tag-box/index.d.ts",
       "default": "./fesm2022/acorex-components-tag-box.mjs"
     },
-    "./switch": {
-      "types": "./switch/index.d.ts",
-      "default": "./fesm2022/acorex-components-switch.mjs"
-    },
     "./text-box": {
       "types": "./text-box/index.d.ts",
       "default": "./fesm2022/acorex-components-text-box.mjs"
@@ -448,22 +452,10 @@
       "types": "./time-duration/index.d.ts",
       "default": "./fesm2022/acorex-components-time-duration.mjs"
     },
-    "./text-area": {
-      "types": "./text-area/index.d.ts",
-      "default": "./fesm2022/acorex-components-text-area.mjs"
-    },
     "./time-line": {
       "types": "./time-line/index.d.ts",
       "default": "./fesm2022/acorex-components-time-line.mjs"
     },
-    "./toast": {
-      "types": "./toast/index.d.ts",
-      "default": "./fesm2022/acorex-components-toast.mjs"
-    },
-    "./toolbar": {
-      "types": "./toolbar/index.d.ts",
-      "default": "./fesm2022/acorex-components-toolbar.mjs"
-    },
     "./tooltip": {
       "types": "./tooltip/index.d.ts",
       "default": "./fesm2022/acorex-components-tooltip.mjs"
@@ -476,6 +468,18 @@
       "types": "./tree-view-legacy/index.d.ts",
       "default": "./fesm2022/acorex-components-tree-view-legacy.mjs"
     },
+    "./toolbar": {
+      "types": "./toolbar/index.d.ts",
+      "default": "./fesm2022/acorex-components-toolbar.mjs"
+    },
+    "./toast": {
+      "types": "./toast/index.d.ts",
+      "default": "./fesm2022/acorex-components-toast.mjs"
+    },
+    "./uploader": {
+      "types": "./uploader/index.d.ts",
+      "default": "./fesm2022/acorex-components-uploader.mjs"
+    },
     "./video-player": {
       "types": "./video-player/index.d.ts",
       "default": "./fesm2022/acorex-components-video-player.mjs"
@@ -483,10 +487,6 @@
     "./wysiwyg": {
       "types": "./wysiwyg/index.d.ts",
       "default": "./fesm2022/acorex-components-wysiwyg.mjs"
-    },
-    "./uploader": {
-      "types": "./uploader/index.d.ts",
-      "default": "./fesm2022/acorex-components-uploader.mjs"
     }
   }
 }

package/tree-view/index.d.ts

@@ -97,6 +97,14 @@ interface AXTreeViewNodeToggleEvent extends AXHtmlEvent {
 }
 interface AXTreeViewNodeSelectEvent extends AXHtmlEvent {
     node: AXTreeViewNode;
+    /** When false, the selection change was applied programmatically (controlled sync, selectNode, etc.). */
+    isUserInteraction?: boolean;
+}
+type AXTreeViewSelectionSource = 'user' | 'programmatic';
+/** Options for {@link AXTreeViewComponent.selectAndReveal}. */
+interface AXTreeViewSelectAndRevealOptions {
+    /** Ancestor node ids from root to parent for each target id (parallel to nodeIds). */
+    ancestorPaths?: string[][];
 }
 interface AXTreeViewNodeDoubleClickEvent extends AXHtmlEvent {
     node: AXTreeViewNode;
@@ -106,6 +114,8 @@ interface AXTreeViewNodeClickEvent extends AXHtmlEvent {
 }
 interface AXTreeViewSelectionChangeEvent extends AXEvent {
     selectedNodes: AXTreeViewNode[];
+    selectedIds: string[];
+    source: AXTreeViewSelectionSource;
 }
 interface AXTreeViewDropEvent extends AXEvent {
     node: AXTreeViewNode;
@@ -260,6 +270,13 @@ declare class AXTreeViewComponent {
     readonly doubleClickDuration: _angular_core.InputSignal<number>;
     /** Duration in milliseconds for detecting double-clicks. Default: `50`. */
     readonly tooltipDelay: _angular_core.InputSignal<number>;
+    /**
+     * When true, {@link selectedIds} is the source of truth: the tree applies it on load/reload
+     * and emits updates on user interaction. Default: `false` (existing imperative API unchanged).
+     */
+    readonly controlledSelection: _angular_core.InputSignal<boolean>;
+    /** Selected node ids (two-way). Used when {@link controlledSelection} is true. */
+    readonly selectedIds: _angular_core.ModelSignal<string[]>;
     /** Emitted before a drop operation - set canceled to true to prevent drop */
     readonly onBeforeDrop: _angular_core.OutputEmitterRef<AXTreeViewBeforeDropEvent>;
     /** Emitted when a node is toggled (expanded/collapsed) */
@@ -297,6 +314,11 @@ declare class AXTreeViewComponent {
     protected readonly directionCollapsedIcon: _angular_core.Signal<string>;
     /** Flag to prevent infinite loops when syncing datasource */
     private isUpdatingFromDatasource;
+    /** Bumped when controlled selection changes so stale async sync is ignored. */
+    private selectionSyncRevision;
+    private pendingApplySelectedIdsTimeout?;
+    /** Prevents selectedIds effect from re-applying when the model was updated from the tree. */
+    private isUpdatingSelectedIdsModel;
     /** Computed to check if datasource is a function */
     private readonly isLazyDataSource;
     /** Computed: Returns true when selection is restricted to leaf nodes only */
@@ -423,6 +445,15 @@ declare class AXTreeViewComponent {
      * Get all selected nodes
      */
     getSelectedNodes(): AXTreeViewNode[];
+    /**
+     * Returns selected node ids (from {@link selectedIds} when controlled, otherwise from tree state).
+     */
+    getSelectedIds(): string[];
+    /**
+     * Expands ancestor paths (when provided) and applies selection.
+     * Intended for lazy trees with {@link controlledSelection}.
+     */
+    selectAndReveal(nodeIds: string[], options?: AXTreeViewSelectAndRevealOptions): Promise<void>;
     /**
      * Delete selected nodes from the tree
      */
@@ -659,6 +690,16 @@ declare class AXTreeViewComponent {
      * Emit selection change event with all selected nodes
      */
     private emitSelectionChange;
+    private bumpSelectionSyncRevision;
+    private isSelectionSyncCurrent;
+    private normalizeSelectedIdsForMode;
+    private areSelectedIdsEqual;
+    private setSelectedIdsModel;
+    private syncSelectedIdsModelFromTree;
+    private scheduleApplySelectedIdsToTree;
+    private applySelectedIdsToTree;
+    private applySelectedIdsToTreeWithRetry;
+    private expandAncestorPaths;
     /**
      * Handle node double click
      */
@@ -797,7 +838,7 @@ declare class AXTreeViewComponent {
      */
     private handleError;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXTreeViewComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXTreeViewComponent, "ax-tree-view", never, { "datasource": { "alias": "datasource"; "required": true; "isSignal": true; }; "selectMode": { "alias": "selectMode"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "dragArea": { "alias": "dragArea"; "required": false; "isSignal": true; }; "dragBehavior": { "alias": "dragBehavior"; "required": false; "isSignal": true; }; "showIcons": { "alias": "showIcons"; "required": false; "isSignal": true; }; "showChildrenBadge": { "alias": "showChildrenBadge"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "titleField": { "alias": "titleField"; "required": false; "isSignal": true; }; "tooltipField": { "alias": "tooltipField"; "required": false; "isSignal": true; }; "iconField": { "alias": "iconField"; "required": false; "isSignal": true; }; "expandedField": { "alias": "expandedField"; "required": false; "isSignal": true; }; "selectedField": { "alias": "selectedField"; "required": false; "isSignal": true; }; "indeterminateField": { "alias": "indeterminateField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "hiddenField": { "alias": "hiddenField"; "required": false; "isSignal": true; }; "childrenField": { "alias": "childrenField"; "required": false; "isSignal": true; }; "childrenCountField": { "alias": "childrenCountField"; "required": false; "isSignal": true; }; "dataField": { "alias": "dataField"; "required": false; "isSignal": true; }; "inheritDisabled": { "alias": "inheritDisabled"; "required": false; "isSignal": true; }; "expandOnDoubleClick": { "alias": "expandOnDoubleClick"; "required": false; "isSignal": true; }; "doubleClickDuration": { "alias": "doubleClickDuration"; "required": false; "isSignal": true; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; "isSignal": true; }; }, { "datasource": "datasourceChange"; "onBeforeDrop": "onBeforeDrop"; "onNodeToggle": "onNodeToggle"; "onNodeSelect": "onNodeSelect"; "onNodeDoubleClick": "onNodeDoubleClick"; "onNodeClick": "onNodeClick"; "onSelectionChange": "onSelectionChange"; "onOrderChange": "onOrderChange"; "onMoveChange": "onMoveChange"; "onItemsChange": "onItemsChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AXTreeViewComponent, "ax-tree-view", never, { "datasource": { "alias": "datasource"; "required": true; "isSignal": true; }; "selectMode": { "alias": "selectMode"; "required": false; "isSignal": true; }; "selectionBehavior": { "alias": "selectionBehavior"; "required": false; "isSignal": true; }; "dragArea": { "alias": "dragArea"; "required": false; "isSignal": true; }; "dragBehavior": { "alias": "dragBehavior"; "required": false; "isSignal": true; }; "showIcons": { "alias": "showIcons"; "required": false; "isSignal": true; }; "showChildrenBadge": { "alias": "showChildrenBadge"; "required": false; "isSignal": true; }; "expandedIcon": { "alias": "expandedIcon"; "required": false; "isSignal": true; }; "collapsedIcon": { "alias": "collapsedIcon"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "look": { "alias": "look"; "required": false; "isSignal": true; }; "nodeTemplate": { "alias": "nodeTemplate"; "required": false; "isSignal": true; }; "idField": { "alias": "idField"; "required": false; "isSignal": true; }; "titleField": { "alias": "titleField"; "required": false; "isSignal": true; }; "tooltipField": { "alias": "tooltipField"; "required": false; "isSignal": true; }; "iconField": { "alias": "iconField"; "required": false; "isSignal": true; }; "expandedField": { "alias": "expandedField"; "required": false; "isSignal": true; }; "selectedField": { "alias": "selectedField"; "required": false; "isSignal": true; }; "indeterminateField": { "alias": "indeterminateField"; "required": false; "isSignal": true; }; "disabledField": { "alias": "disabledField"; "required": false; "isSignal": true; }; "hiddenField": { "alias": "hiddenField"; "required": false; "isSignal": true; }; "childrenField": { "alias": "childrenField"; "required": false; "isSignal": true; }; "childrenCountField": { "alias": "childrenCountField"; "required": false; "isSignal": true; }; "dataField": { "alias": "dataField"; "required": false; "isSignal": true; }; "inheritDisabled": { "alias": "inheritDisabled"; "required": false; "isSignal": true; }; "expandOnDoubleClick": { "alias": "expandOnDoubleClick"; "required": false; "isSignal": true; }; "doubleClickDuration": { "alias": "doubleClickDuration"; "required": false; "isSignal": true; }; "tooltipDelay": { "alias": "tooltipDelay"; "required": false; "isSignal": true; }; "controlledSelection": { "alias": "controlledSelection"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; }, { "datasource": "datasourceChange"; "selectedIds": "selectedIdsChange"; "onBeforeDrop": "onBeforeDrop"; "onNodeToggle": "onNodeToggle"; "onNodeSelect": "onNodeSelect"; "onNodeDoubleClick": "onNodeDoubleClick"; "onNodeClick": "onNodeClick"; "onSelectionChange": "onSelectionChange"; "onOrderChange": "onOrderChange"; "onMoveChange": "onMoveChange"; "onItemsChange": "onItemsChange"; }, never, never, true, never>;
 }
 
 declare class AXTreeViewModule {
@@ -993,4 +1034,4 @@ declare class AXTreeViewService {
 }
 
 export { AXTreeViewComponent, AXTreeViewModule, AXTreeViewService };
-export type { AXTreeViewBeforeDropEvent, AXTreeViewCallback, AXTreeViewChildrenSelectionState, AXTreeViewDataSource, AXTreeViewDragArea, AXTreeViewDragBehavior, AXTreeViewDropEvent, AXTreeViewFlatNode, AXTreeViewItemTemplateContext, AXTreeViewNode, AXTreeViewNodeClickEvent, AXTreeViewNodeDoubleClickEvent, AXTreeViewNodeSelectEvent, AXTreeViewNodeToggleEvent, AXTreeViewSelectMode, AXTreeViewSelectionBehavior, AXTreeViewSelectionChangeEvent, AXTreeViewViewLook };
+export type { AXTreeViewBeforeDropEvent, AXTreeViewCallback, AXTreeViewChildrenSelectionState, AXTreeViewDataSource, AXTreeViewDragArea, AXTreeViewDragBehavior, AXTreeViewDropEvent, AXTreeViewFlatNode, AXTreeViewItemTemplateContext, AXTreeViewNode, AXTreeViewNodeClickEvent, AXTreeViewNodeDoubleClickEvent, AXTreeViewNodeSelectEvent, AXTreeViewNodeToggleEvent, AXTreeViewSelectAndRevealOptions, AXTreeViewSelectMode, AXTreeViewSelectionBehavior, AXTreeViewSelectionChangeEvent, AXTreeViewSelectionSource, AXTreeViewViewLook };