@mozaic-ds/angular 2.1.5 → 2.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mozaic-ds/angular",
-  "version": "2.1.5",
+  "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;
@@ -2704,7 +2713,7 @@ declare class MozTreeComponent<T = unknown> {
     protected readonly keyboardService: TreeKeyboardService<any>;
     readonly nodes: _angular_core.InputSignal<TreeNode<T>[]>;
     readonly selectionMode: _angular_core.InputSignal<TreeSelectionMode>;
-    readonly expandedIds: _angular_core.InputSignal<Set<string | number>>;
+    readonly expandedIds: _angular_core.ModelSignal<Set<string | number>>;
     readonly selectedIds: _angular_core.InputSignal<Set<string | number>>;
     readonly loadChildren: _angular_core.InputSignal<LoadChildrenFn<T> | null>;
     readonly canSelect: _angular_core.InputSignal<((node: TreeNode<T>) => boolean) | null>;
@@ -2717,7 +2726,6 @@ declare class MozTreeComponent<T = unknown> {
     readonly _typedTemplates: _angular_core.Signal<readonly MozTreeNodeTemplateDirective[]>;
     readonly nodeTemplate: _angular_core.Signal<TemplateRef<TreeNodeContext<T>> | null>;
     readonly nodeTemplates: _angular_core.Signal<Record<string, TemplateRef<TreeNodeContext<T>>> | null>;
-    readonly expandedIdsChange: _angular_core.OutputEmitterRef<Set<string | number>>;
     readonly selectionChange: _angular_core.OutputEmitterRef<Set<string | number>>;
     readonly useVirtualScroll: _angular_core.Signal<boolean>;
     readonly itemSize: _angular_core.Signal<number>;
@@ -2726,14 +2734,26 @@ 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;
     trackNode(_index: number, node: TreeNode<T>): string | number;
     trackFlatNode(_index: number, flat: FlatNode<T>): string | number;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MozTreeComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozTreeComponent<any>, "moz-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "loadChildren": { "alias": "loadChildren"; "required": false; "isSignal": true; }; "canSelect": { "alias": "canSelect"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollThreshold": { "alias": "virtualScrollThreshold"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; }, { "expandedIdsChange": "expandedIdsChange"; "selectionChange": "selectionChange"; }, ["_defaultTemplate", "_typedTemplates"], never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MozTreeComponent<any>, "moz-tree", never, { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "selectionMode": { "alias": "selectionMode"; "required": false; "isSignal": true; }; "expandedIds": { "alias": "expandedIds"; "required": false; "isSignal": true; }; "selectedIds": { "alias": "selectedIds"; "required": false; "isSignal": true; }; "loadChildren": { "alias": "loadChildren"; "required": false; "isSignal": true; }; "canSelect": { "alias": "canSelect"; "required": false; "isSignal": true; }; "indentSize": { "alias": "indentSize"; "required": false; "isSignal": true; }; "virtualScroll": { "alias": "virtualScroll"; "required": false; "isSignal": true; }; "virtualScrollThreshold": { "alias": "virtualScrollThreshold"; "required": false; "isSignal": true; }; "rowHeight": { "alias": "rowHeight"; "required": false; "isSignal": true; }; "viewportHeight": { "alias": "viewportHeight"; "required": false; "isSignal": true; }; }, { "expandedIds": "expandedIdsChange"; "selectionChange": "selectionChange"; }, ["_defaultTemplate", "_typedTemplates"], never, true, never>;
 }
 
 declare class MozTreeNodeComponent<T = unknown> {