@mozaic-ds/angular 2.0.33 → 2.0.34

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozaic-ds/angular",
-  "version": "2.0.33",
+  "version": "2.0.34",
   "type": "module",
   "peerDependencies": {
     "@angular/common": ">=20.3.15",

package/types/mozaic-ds-angular.d.ts

@@ -3645,6 +3645,7 @@ declare class TreeStateService<T = unknown> {
 }
 
 declare class TreeSelectionService<T = unknown> {
+    private readonly stateService;
     readonly selectedIds: _angular_core.WritableSignal<Set<string | number>>;
     readonly selectionMode: _angular_core.WritableSignal<TreeSelectionMode>;
     readonly rootNodes: _angular_core.WritableSignal<TreeNode<T>[]>;
@@ -3653,14 +3654,45 @@ declare class TreeSelectionService<T = unknown> {
     setRootNodes(nodes: TreeNode<T>[]): void;
     isSelected(id: string | number): boolean;
     isDisabled(node: TreeNode<T>, ancestors: TreeNode<T>[]): boolean;
+    /**
+     * A node is indeterminate when it has loaded children AND
+     * some (but not all) of its leaf-level descendants are selected.
+     */
     isIndeterminate(node: TreeNode<T>): boolean;
+    /**
+     * A node is checked when:
+     * - Leaf node (no children or children not loaded): its ID is in selectedIds
+     * - Parent with loaded children: ALL leaf descendants are selected
+     */
     isCheckedComputed(node: TreeNode<T>): boolean;
+    /**
+     * Select a node: add all leaf descendant IDs (or the node's own ID if leaf).
+     */
     selectNode(node: TreeNode<T>): void;
+    /**
+     * Deselect a node: remove all leaf descendant IDs (or the node's own ID if leaf).
+     * Also remove the node's own ID in case it's in the set from external sources.
+     */
     deselectNode(node: TreeNode<T>): void;
     toggleNode(node: TreeNode<T>): void;
-    private _collectEnabledIds;
-    private _collectEnabledDescendantIds;
+    /**
+     * Called when children are loaded for a node.
+     * - If parent ID was in selectedIds: replace it with children's leaf IDs (propagate down).
+     * - If parent ID was NOT in selectedIds: remove any orphan children IDs that
+     *   may have been left from a prior bulk operation (e.g. Select All → deselect parent).
+     */
+    propagateOnChildrenLoaded(parentId: string | number): void;
+    /**
+     * Collect leaf-level IDs (terminal nodes that have no loaded children).
+     * Returns empty array if the node itself is a leaf.
+     */
+    private _collectLeafIds;
+    /**
+     * Collect ALL descendant IDs (both parents and leaves) for thorough cleanup on deselect.
+     */
+    private _collectAllDescendantIds;
     readonly allSelectedIds: _angular_core.Signal<Set<string | number>>;
+    private _resolveNode;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TreeSelectionService<any>, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<TreeSelectionService<any>>;
 }