@mozaic-ds/angular 2.1.6 → 2.1.7

package/package.json

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

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

@@ -2599,6 +2599,15 @@ declare class TreeStateService<T = unknown> {
     setExpanded(ids: Set<string | number>): void;
     toggleExpanded(id: string | number): void;
     expandAndLoad(node: TreeNode<T>): Observable<void>;
+    /**
+     * Loads a node's children on demand when they haven't been loaded yet.
+     * Idempotent: a no-op (emits `[]`) when there is no `loadChildrenFn`, the
+     * node is already loading, or its children are already present. This is the
+     * single load primitive shared by the click-driven `expandAndLoad` and the
+     * declarative auto-load effect in `MozTreeComponent` — so expanding a node
+     * by clicking it and by writing to `expandedIds` go through the same path.
+     */
+    loadChildrenFor(node: TreeNode<T>): Observable<TreeNode<T>[]>;
     addLoading(id: string | number): void;
     removeLoading(id: string | number): void;
     patchChildren(nodeId: string | number, children: TreeNode<T>[]): void;
@@ -2725,7 +2734,19 @@ declare class MozTreeComponent<T = unknown> {
     onTreeFocus(): void;
     onExpandChange(): void;
     onSelectionChange(ids: Set<string | number>): void;
+    /**
+     * Convenience helper for the "expand a deep path, then scroll to it" pattern.
+     * Adds every ancestor in `path` (all ids except the last) to `expandedIds`,
+     * which lets the declarative auto-load effect fetch each lazy level, then
+     * resolves once those levels have finished loading — so callers can safely
+     * `scrollToNode(path.at(-1))` afterwards.
+     *
+     * Plain declarative usage — binding `[(expandedIds)]` and writing to it — does
+     * not need this method; the tree loads expanded lazy nodes on its own. It
+     * exists only to give an awaitable signal that the deep node is now visible.
+     */
     expandPath(path: Array<string | number>): Promise<void>;
+    private _waitForChildren;
     scrollToNode(nodeId: string | number): void;
     expandAll(): void;
     collapseAll(): void;