@koobiq/components 21.0.0 → 21.1.0

package/types/koobiq-components-tree.d.ts

@@ -11,17 +11,33 @@ import { KbqTooltipTrigger } from '@koobiq/components/tooltip';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i2 from '@koobiq/components/icon';
 
+/** Options of `FlatTreeControl` and `NestedTreeControl`. */
+interface KbqTreeControlOptions<T, K> {
+    /** Initial value of the control's `trackBy`. */
+    trackBy?: (dataNode: T) => K;
+}
 /**
  * Tree control interface. User can implement TreeControl to expand/collapse dataNodes in the tree.
  * The Tree will use this TreeControl to expand/collapse a node.
  * User can also use it outside the `<kbq-tree>` to control the expansion status of the tree.
  */
-interface TreeControl<T> {
+interface TreeControl<T, K = T> {
     /** The saved tree nodes data for `expandAll` action. */
     dataNodes: T[];
-    /** The expansion model */
-    expansionModel: SelectionModel<T>;
+    /** The expansion model: the keys of the expanded data nodes, which are the nodes themselves by default. */
+    expansionModel: SelectionModel<K>;
     filterModel: SelectionModel<T>;
+    /** The query of the active filter, or `null` when no filter is active. */
+    readonly filterQuery: string | null;
+    /** Whether a filter is active: the filter model holds at least one node, or a query is set. */
+    readonly hasActiveFilter: boolean;
+    /** Gives the key a data node is expanded by. Without it the node object is its own key. */
+    trackBy?: (dataNode: T) => K;
+    /**
+     * Stream with the filter query or result. Published for backward compatibility.
+     *
+     * @deprecated Use `filterQuery` for the query string and `filterModel` for the filter state. Will be removed in 22.0.0.
+     */
     filterValue: BehaviorSubject<T[] | string | null>;
     /** Get depth of a given data node, return the level number. This is for flat tree node. */
     getLevel(dataNode: T): number;
@@ -55,12 +71,31 @@ interface TreeControl<T> {
 }
 
 /** Base tree control. It has basic toggle/expand/collapse operations on a single data node. */
-declare abstract class BaseTreeControl<T> implements TreeControl<T> {
+declare abstract class BaseTreeControl<T, K = T> implements TreeControl<T, K> {
     dataNodes: T[];
-    /** A selection model with multi-selection to track expansion status. */
-    expansionModel: SelectionModel<T>;
+    /** A selection model with multi-selection to track expansion status: it holds the key of every expanded node. */
+    expansionModel: SelectionModel<K>;
+    /**
+     * Gives the key a data node is expanded by. Without it the node object is its own key, so a node
+     * rebuilt as a new object — as a flattener does whenever its data changes — comes back collapsed.
+     *
+     * Set it before anything is expanded: keys stored under another function no longer match.
+     */
+    trackBy?: (dataNode: T) => K;
     filterModel: SelectionModel<T>;
+    /**
+     * Stream with the filter query or result. Published for backward compatibility.
+     *
+     * @deprecated Use `filterQuery` for the query string and `filterModel` for the filter state. Will be removed in 22.0.0.
+     */
     filterValue: BehaviorSubject<string | T[] | null>;
+    /**
+     * The query of the active filter, or `null` when no filter is active. Defaults to `null`.
+     * Set by `FlatTreeControl.applyFilter`; stays `null` on controls without filtering, such as `NestedTreeControl`.
+     */
+    filterQuery: string | null;
+    /** Whether a filter is active: the filter model holds at least one node, or a query is set. */
+    get hasActiveFilter(): boolean;
     /** Get depth of a given data node, return the level number. This is for flat tree node. */
     getLevel: (dataNode: T) => number;
     /**
@@ -90,6 +125,8 @@ declare abstract class BaseTreeControl<T> implements TreeControl<T> {
     expandDescendants(dataNode: T): void;
     /** Collapses a subtree rooted at given data node recursively. */
     collapseDescendants(dataNode: T): void;
+    /** The key `expansionModel` holds for a data node. */
+    protected expansionKey(dataNode: T): K;
 }
 
 declare const kbqTreeSelectAllValue = "selectAll";
@@ -99,13 +136,15 @@ interface FlatTreeControlFilter<T> {
 }
 /**
  * Default first stage of the filter pipeline: keeps the nodes whose view value matches the query.
+ * An optional `matches` predicate keeps a node matched by anything else, e.g. by another field.
  *
  * @docs-private
  */
-declare class FilterByViewValue<T> implements FlatTreeControlFilter<T> {
+declare class FilterByViewValue<T, K = T> implements FlatTreeControlFilter<T> {
     private control;
+    private matches?;
     result: T[];
-    constructor(control: FlatTreeControl<T>);
+    constructor(control: FlatTreeControl<T, K>, matches?: ((node: T, query: string | null) => boolean) | undefined);
     handle(value: string | null): T[];
 }
 /**
@@ -114,17 +153,17 @@ declare class FilterByViewValue<T> implements FlatTreeControlFilter<T> {
  *
  * @docs-private
  */
-declare class FilterParentsForNodes<T> implements FlatTreeControlFilter<T> {
+declare class FilterParentsForNodes<T, K = T> implements FlatTreeControlFilter<T> {
     private control;
     result: T[];
-    constructor(control: FlatTreeControl<T>);
+    constructor(control: FlatTreeControl<T, K>);
     handle(_: any, prevFilter: FlatTreeControlFilter<T>): T[];
 }
-declare class FilterByValues<T> implements FlatTreeControlFilter<T> {
+declare class FilterByValues<T, K = T> implements FlatTreeControlFilter<T> {
     private control;
     result: T[];
     private values;
-    constructor(control: FlatTreeControl<T>);
+    constructor(control: FlatTreeControl<T, K>);
     handle(_: any, prevFilter?: FlatTreeControlFilter<T>): T[];
     setValues: (values: string[]) => void;
     getValues(): string[];
@@ -133,7 +172,7 @@ declare class FilterByValues<T> implements FlatTreeControlFilter<T> {
 declare function defaultCompareValues(firstValue: string, secondValue: string): boolean;
 declare function defaultCompareViewValues(firstViewValue: string, secondViewValue: string): boolean;
 /** Flat tree control. Able to expand/collapse a subtree recursively for flattened tree. */
-declare class FlatTreeControl<T> extends BaseTreeControl<T> {
+declare class FlatTreeControl<T, K = T> extends BaseTreeControl<T, K> {
     getLevel: (dataNode: T) => number;
     isExpandable: (dataNode: T) => boolean;
     /** getValue will be used to determine if the tree contains value or not. Used in method hasValue */
@@ -146,8 +185,9 @@ declare class FlatTreeControl<T> extends BaseTreeControl<T> {
     compareViewValues: (firstViewValue: any, secondViewValue: any) => boolean;
     /** isDisabled will be used to determine if the node is disabled. */
     isDisabled: (dataNode: T) => boolean;
-    expandedItemsBeforeFiltration: T[];
+    expandedItemsBeforeFiltration: K[];
     private filters;
+    private readonly nodeIndexes;
     /** Construct with flat tree data node functions getLevel, isExpandable, getValue and getViewValue. */
     constructor(getLevel: (dataNode: T) => number, isExpandable: (dataNode: T) => boolean, 
     /** getValue will be used to determine if the tree contains value or not. Used in method hasValue */
@@ -159,7 +199,9 @@ declare class FlatTreeControl<T> extends BaseTreeControl<T> {
     /** compareValues will be used to comparing values. */
     compareViewValues?: (firstViewValue: any, secondViewValue: any) => boolean, 
     /** isDisabled will be used to determine if the node is disabled. */
-    isDisabled?: (dataNode: T) => boolean);
+    isDisabled?: (dataNode: T) => boolean, 
+    /** Further options: the `trackBy` the nodes are expanded by. */
+    options?: KbqTreeControlOptions<T, K>);
     getFilters(): FlatTreeControlFilter<T>[];
     setFilters(...filters: FlatTreeControlFilter<T>[]): void;
     /**
@@ -189,14 +231,28 @@ declare class FlatTreeControl<T> extends BaseTreeControl<T> {
      */
     getParents(node: T, result?: T[]): T[];
     hasValue(value: string): T | undefined;
+    /** Filters nodes by a query and expands the ancestors of every match. An empty string resets the filter. */
+    applyFilter(value?: string | null): void;
+    /** Clears the active filter and restores the expansion state saved before filtering. */
+    resetFilter(): void;
+    /**
+     * Filters nodes by a query and expands the ancestors of every match.
+     *
+     * @deprecated Use `applyFilter` instead. Will be removed in 22.0.0.
+     */
     filterNodes(value?: string | null): void;
     private updateFilterValue;
     private saveExpansionState;
     private restoreExpansionState;
+    /**
+     * Position of the node in `dataNodes`, constant-time while the index matches the array. With `trackBy` a node
+     * rebuilt as a new object since is found by its key, as the expansion methods accept it too.
+     */
+    private indexOfNode;
 }
 
 /** Nested tree control. Able to expand/collapse a subtree recursively for NestedNode type. */
-declare class NestedTreeControl<T> extends BaseTreeControl<T> {
+declare class NestedTreeControl<T, K = T> extends BaseTreeControl<T, K> {
     getChildren: (dataNode: T) => Observable<T[]>;
     /**
      * Construct with nested tree function getChildren.
@@ -205,7 +261,7 @@ declare class NestedTreeControl<T> extends BaseTreeControl<T> {
      * `getDescendants` walks the tree with `take(1)` and returns as soon as the recursion unwinds, so
      * an asynchronous source yields an incomplete — usually empty — descendant list.
      */
-    constructor(getChildren: (dataNode: T) => Observable<T[]>);
+    constructor(getChildren: (dataNode: T) => Observable<T[]>, options?: KbqTreeControlOptions<T, K>);
     /**
      * Expands all dataNodes in the tree.
      *
@@ -280,8 +336,10 @@ declare class KbqTreeFlattener<T, F> {
     /**
      * Expand flattened node with current expansion status.
      * The returned list may have different length.
+     *
+     * Reads only `isExpanded` of the tree control, so it takes a control of any key type.
      */
-    expandFlattenedNodes(nodes: F[], treeControl: TreeControl<F>): F[];
+    expandFlattenedNodes(nodes: F[], treeControl: Pick<TreeControl<F>, 'isExpanded'>): F[];
 }
 /**
  * Data source for flat tree.
@@ -290,7 +348,7 @@ declare class KbqTreeFlattener<T, F> {
  * The nested tree nodes of type `T` are flattened through `KbqTreeFlattener`, and converted
  * to type `F` for `KbqTree` to consume.
  */
-declare class KbqTreeFlatDataSource<T, F> extends DataSource<F> {
+declare class KbqTreeFlatDataSource<T, F, K = F> extends DataSource<F> {
     private treeControl;
     private treeFlattener;
     flattenedData: BehaviorSubject<F[]>;
@@ -299,10 +357,10 @@ declare class KbqTreeFlatDataSource<T, F> extends DataSource<F> {
     get data(): T[];
     set data(value: T[]);
     private readonly _data;
-    constructor(treeControl: FlatTreeControl<F>, treeFlattener: KbqTreeFlattener<T, F>, initialData?: T[]);
+    constructor(treeControl: FlatTreeControl<F, K>, treeFlattener: KbqTreeFlattener<T, F>, initialData?: T[]);
     connect(collectionViewer: CollectionViewer): Observable<F[]>;
     filterHandler(): F[];
-    expansionHandler(_change: SelectionChange<F>): F[];
+    expansionHandler(_change: SelectionChange<K>): F[];
     disconnect(): void;
 }
 
@@ -368,8 +426,10 @@ type KbqTreeState = string[];
  * ported by hand.
  *
  * `C` narrows the tree control a concrete tree accepts, and so the type its `treeControl` binding is checked against.
+ * The bound leaves out `expansionModel` and `trackBy`, the members typed by the control's key, so that it admits
+ * a control of any key type: the model makes a control invariant in that type.
  */
-declare class KbqTreeBase<T, C extends TreeControl<T> = TreeControl<T>> implements AfterContentChecked, AfterContentInit, CollectionViewer, OnDestroy, OnInit {
+declare class KbqTreeBase<T, C extends Omit<TreeControl<T>, 'expansionModel' | 'trackBy'> = TreeControl<T>> implements AfterContentChecked, AfterContentInit, CollectionViewer, OnDestroy, OnInit {
     protected differs: IterableDiffers;
     protected changeDetectorRef: ChangeDetectorRef;
     /**
@@ -391,6 +451,8 @@ declare class KbqTreeBase<T, C extends TreeControl<T> = TreeControl<T>> implemen
      *
      * Views are reused for nodes the function reports as unchanged, which a data source that rebuilds
      * its node objects on every emission — a flattener among them — otherwise cannot get.
+     *
+     * Defaults to the `trackBy` of the tree control, read when the tree initializes and when the data source changes.
      */
     readonly trackBy: _angular_core.InputSignal<TrackByFunction<T>>;
     private readonly nodeOutletQuery;
@@ -438,7 +500,7 @@ declare class KbqTreeBase<T, C extends TreeControl<T> = TreeControl<T>> implemen
     private warnedAboutTreeControl;
     private warnedAboutValues;
     /** @docs-private */
-    readonly dataSourceInput: _angular_core.InputSignal<DataSource<T> | T[] | Observable<T[]> | null | undefined>;
+    readonly dataSourceInput: _angular_core.InputSignal<T[] | DataSource<T> | Observable<T[]> | null | undefined>;
     /**
      * Provides a stream containing the latest data array to render. Influenced by the tree's
      * stream of view window (what dataNodes are currently on screen).
@@ -530,7 +592,7 @@ declare class KbqTreeBase<T, C extends TreeControl<T> = TreeControl<T>> implemen
 }
 declare class KbqTreeNode<T> implements IFocusableOption, OnDestroy {
     protected elementRef: ElementRef<HTMLElement>;
-    tree: KbqTreeBase<T, TreeControl<T>>;
+    tree: KbqTreeBase<T, TreeControl<T, T>>;
     /**
      * The most recently created `KbqTreeNode`, across every tree on the page.
      *
@@ -567,7 +629,7 @@ declare class KbqTreeNode<T> implements IFocusableOption, OnDestroy {
 
 declare class KbqTreeNodePadding<T> implements AfterViewInit {
     protected treeNode: KbqTreeNode<T>;
-    protected tree: KbqTreeBase<T, _koobiq_components_tree.TreeControl<T>>;
+    protected tree: KbqTreeBase<T, _koobiq_components_tree.TreeControl<T, T>>;
     private renderer;
     private element;
     private option;
@@ -666,6 +728,10 @@ interface KbqTreeOptionParent<T = any> {
     selectionModel: SelectionModel<T>;
     unorderedOptions: QueryList<KbqTreeOption<T>>;
     setSelectedOptionsByClick(option: KbqTreeOption<T>, shiftKey: boolean, ctrlKey: boolean): void;
+    /** Called when an option takes focus. */
+    reportOptionFocus?(event: KbqTreeOptionEvent): void;
+    /** Called when an option loses focus. */
+    reportOptionBlur?(event: KbqTreeOptionEvent): void;
 }
 /** Injection token used to provide the parent component to options. */
 declare const KBQ_TREE_OPTION_PARENT_COMPONENT: InjectionToken<KbqTreeOptionParent>;
@@ -677,10 +743,12 @@ declare class KbqTreeOptionChange {
     /** The tree option that has been modified or selected. */
     source: KbqTreeOption);
 }
-declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements AfterContentInit, DoCheck, KbqTitleTextRef {
+declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements OnInit, AfterContentInit, DoCheck, KbqTitleTextRef {
     private changeDetectorRef;
     private readonly environmentInjector;
     private readonly destroyRef;
+    private readonly ngZone;
+    private readonly renderer;
     tree: KbqTreeOptionParent<T> & KbqTreeBase<T>;
     private readonly focusEvents;
     private readonly blurEvents;
@@ -709,6 +777,8 @@ declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements AfterCont
     set value(value: any);
     private _value;
     /** @docs-private */
+    readonly viewValueInput: _angular_core.InputSignal<string | undefined>;
+    /** @docs-private */
     readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
     /** Whether the option is disabled: through its own input, the tree, or the tree control's `isDisabled`. */
     get disabled(): boolean;
@@ -758,10 +828,12 @@ declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements AfterCont
     private readonly selectedState;
     get id(): string;
     private _id;
+    /** The displayed value used by type-ahead. Falls back to the text of the option. */
     get viewValue(): string;
     get hasFocus(): boolean;
     set hasFocus(value: boolean);
     private readonly focused;
+    private focusReported;
     get isExpandable(): boolean;
     /** The "select all" row sits above the tree at root depth; `getLevel` has no node to resolve for it. */
     get level(): number;
@@ -786,6 +858,7 @@ declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements AfterCont
     /** `aria-selected` of the row as of the last check. Options with a checkbox report `aria-checked` instead. */
     protected get ariaSelected(): boolean | null;
     constructor();
+    ngOnInit(): void;
     ngDoCheck(): void;
     ngAfterContentInit(): void;
     /**
@@ -829,14 +902,14 @@ declare class KbqTreeOption<T = any> extends KbqTreeNode<T> implements AfterCont
     private toAriaChecked;
     private resolvePredicates;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTreeOption<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeOption<any>, "kbq-tree-option", ["kbqTreeOption"], { "checkboxThirdState": { "alias": "checkboxThirdState"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selectAllRow": { "alias": "selectAllRow"; "required": false; "isSignal": true; }; "showCheckboxInput": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "onSelectionChange": "onSelectionChange"; }, ["toggleElementDirective", "toggleElementComponent", "pseudoCheckbox", "actionButton", "tooltipTriggerQuery", "dropdownTriggerQuery"], ["kbq-tree-node-toggle, [kbq-tree-node-toggle], [kbqTreeNodeToggle]", "kbq-pseudo-checkbox", "kbq-checkbox", "[kbq-icon]", "kbq-progress-spinner", "*", "kbq-option-action"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeOption<any>, "kbq-tree-option", ["kbqTreeOption"], { "checkboxThirdState": { "alias": "checkboxThirdState"; "required": false; "isSignal": true; }; "viewValueInput": { "alias": "viewValue"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "selectAllRow": { "alias": "selectAllRow"; "required": false; "isSignal": true; }; "showCheckboxInput": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; }, { "selectionChange": "selectionChange"; "onSelectionChange": "onSelectionChange"; }, ["toggleElementDirective", "toggleElementComponent", "pseudoCheckbox", "actionButton", "tooltipTriggerQuery", "dropdownTriggerQuery"], ["kbq-tree-node-toggle, [kbq-tree-node-toggle], [kbqTreeNodeToggle]", "kbq-pseudo-checkbox", "kbq-checkbox", "[kbq-icon]", "kbq-progress-spinner", "*", "kbq-option-action"], true, never>;
 }
 
 declare const KBQ_SELECTION_TREE_VALUE_ACCESSOR: Provider;
-declare class KbqTreeSelectAllEvent<T, N = any> {
-    source: KbqTreeSelection<N>;
+declare class KbqTreeSelectAllEvent<T, N = any, K = N> {
+    source: KbqTreeSelection<N, K>;
     options: T[];
-    constructor(source: KbqTreeSelection<N>, options: T[]);
+    constructor(source: KbqTreeSelection<N, K>, options: T[]);
 }
 /**
  * Event class that occurs when copying an item from the KbqTreeSelection.
@@ -846,24 +919,24 @@ declare class KbqTreeSelectAllEvent<T, N = any> {
  * @param option - instance of KbqTreeOption
  * @param event - original keyboard event (optional) that triggered the copy
  */
-declare class KbqTreeCopyEvent<T, N = any> {
-    source: KbqTreeSelection<N>;
+declare class KbqTreeCopyEvent<T, N = any, K = N> {
+    source: KbqTreeSelection<N, K>;
     option: T;
     event?: KeyboardEvent | undefined;
-    constructor(source: KbqTreeSelection<N>, option: T, event?: KeyboardEvent | undefined);
+    constructor(source: KbqTreeSelection<N, K>, option: T, event?: KeyboardEvent | undefined);
 }
-declare class KbqTreeNavigationChange<T, N = any> {
-    source: KbqTreeSelection<N>;
+declare class KbqTreeNavigationChange<T, N = any, K = N> {
+    source: KbqTreeSelection<N, K>;
     option: T;
-    constructor(source: KbqTreeSelection<N>, option: T);
+    constructor(source: KbqTreeSelection<N, K>, option: T);
 }
-declare class KbqTreeSelectionChange<T, N = any> {
-    source: KbqTreeSelection<N>;
+declare class KbqTreeSelectionChange<T, N = any, K = N> {
+    source: KbqTreeSelection<N, K>;
     option: T;
     options?: T[] | undefined;
-    constructor(source: KbqTreeSelection<N>, option: T, options?: T[] | undefined);
+    constructor(source: KbqTreeSelection<N, K>, option: T, options?: T[] | undefined);
 }
-declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T>> implements ControlValueAccessor, AfterContentInit, AfterViewInit, OnDestroy {
+declare class KbqTreeSelection<T = any, K = T> extends KbqTreeBase<T, FlatTreeControl<T, K>> implements ControlValueAccessor, AfterContentInit, AfterViewInit, OnDestroy {
     private elementRef;
     private scheduler;
     private clipboard;
@@ -905,7 +978,8 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
      * a subscription taken on the model directly is left behind on the discarded instance.
      *
      * `T` is the type of the data nodes, inferred from `[treeControl]` in a template. A query names it:
-     * `viewChild.required<KbqTreeSelection<Node>>(KbqTreeSelection)`.
+     * `viewChild.required<KbqTreeSelection<Node>>(KbqTreeSelection)`, and a tree whose control has a `trackBy`
+     * names the key type too: `KbqTreeSelection<Node, string>`.
      */
     selectionModel: SelectionModel<T>;
     resetFocusedItemOnBlur: boolean;
@@ -921,30 +995,30 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     private readonly unorderedOptionsQuery;
     private readonly unorderedOptionsList;
     get unorderedOptions(): QueryList<KbqTreeOption<T>>;
-    readonly navigationChange: _angular_core.OutputEmitterRef<KbqTreeNavigationChange<KbqTreeOption<T>, T>>;
+    readonly navigationChange: _angular_core.OutputEmitterRef<KbqTreeNavigationChange<KbqTreeOption<T>, T, K>>;
     /**
      * Emits when the selection changes. A stream rather than an `output()`: `KbqTreeSelect` pipes it with rxjs.
      */
-    readonly selectionChange: EventEmitter<KbqTreeSelectionChange<KbqTreeOption<T>, T>>;
+    readonly selectionChange: EventEmitter<KbqTreeSelectionChange<KbqTreeOption<T>, T, K>>;
     /** @docs-private */
-    readonly selectionChangeOutput: _angular_core.OutputRef<KbqTreeSelectionChange<KbqTreeOption<T>, T>>;
+    readonly selectionChangeOutput: _angular_core.OutputRef<KbqTreeSelectionChange<KbqTreeOption<T>, T, K>>;
     /** Emits after "select all" ran, with the options it could act on. */
-    readonly selectAllChange: _angular_core.OutputEmitterRef<KbqTreeSelectAllEvent<KbqTreeOption<T>, T>>;
+    readonly selectAllChange: _angular_core.OutputEmitterRef<KbqTreeSelectAllEvent<KbqTreeOption<T>, T, K>>;
     /** @deprecated Use `selectAllChange` instead. Will be removed in 22.0.0. */
-    readonly onSelectAll: _angular_core.OutputEmitterRef<KbqTreeSelectAllEvent<KbqTreeOption<T>, T>>;
+    readonly onSelectAll: _angular_core.OutputEmitterRef<KbqTreeSelectAllEvent<KbqTreeOption<T>, T, K>>;
     /**
      * Emits when the active option is copied with Ctrl/Cmd + C. Subscribing replaces the built-in
      * clipboard handler, so the event has to stay an `EventEmitter`: the decision is made by reading
      * `observed`, which `OutputEmitterRef` does not have. A template listener subscribes to it through
      * the output below.
      */
-    readonly copyChange: EventEmitter<KbqTreeCopyEvent<KbqTreeOption<T>, T>>;
+    readonly copyChange: EventEmitter<KbqTreeCopyEvent<KbqTreeOption<T>, T, K>>;
     /** @docs-private */
-    readonly copyChangeOutput: _angular_core.OutputRef<KbqTreeCopyEvent<KbqTreeOption<T>, T>>;
+    readonly copyChangeOutput: _angular_core.OutputRef<KbqTreeCopyEvent<KbqTreeOption<T>, T, K>>;
     /** @deprecated Use `copyChange` instead. Will be removed in 22.0.0. */
-    readonly onCopy: EventEmitter<KbqTreeCopyEvent<KbqTreeOption<T>, T>>;
+    readonly onCopy: EventEmitter<KbqTreeCopyEvent<KbqTreeOption<T>, T, K>>;
     /** @docs-private */
-    readonly onCopyOutput: _angular_core.OutputRef<KbqTreeCopyEvent<KbqTreeOption<T>, T>>;
+    readonly onCopyOutput: _angular_core.OutputRef<KbqTreeCopyEvent<KbqTreeOption<T>, T, K>>;
     private sortedNodes;
     private lastSyncedDataNodes;
     /** @docs-private */
@@ -960,7 +1034,11 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
      */
     get autoSelect(): boolean;
     set autoSelect(value: boolean);
+    private readonly optionFocusEvents;
+    private readonly optionBlurEvents;
+    /** Emits when an option of the tree takes focus. */
     get optionFocusChanges(): Observable<KbqTreeOptionEvent>;
+    /** Emits when an option of the tree loses focus. */
     get optionBlurChanges(): Observable<KbqTreeOptionEvent>;
     /**
      * Selection mode of the tree.
@@ -1063,9 +1141,8 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
      * reactive pass and would otherwise make a consumer's own node count race against that pass.
      */
     get nodesCount(): number;
-    private optionFocusSubscription;
-    private optionBlurSubscription;
     private selectionModelSubscription;
+    private readonly selectionSweeps;
     /** Whether a value report is queued for the end of the current tick. Cleared by `writeValue` to cancel it. */
     private pendingValueReport;
     /** The `multiple` binding the mode was last set from, see `applyMultipleInput`. */
@@ -1166,6 +1243,10 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     /** @docs-private */
     setSelectedOptionsByKey(option: KbqTreeOption<T>, shiftKey: boolean, ctrlKey: boolean): void;
     /** @docs-private */
+    reportOptionFocus(event: KbqTreeOptionEvent): void;
+    /** @docs-private */
+    reportOptionBlur(event: KbqTreeOptionEvent): void;
+    /** @docs-private */
     setSelectedOptionsByClick(option: KbqTreeOption<T>, shiftKey: boolean, ctrlKey: boolean): void;
     /** @docs-private */
     protected selectActiveOptions(): void;
@@ -1176,7 +1257,7 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     /**
      * Recomputes every option's checkbox state where no selection change follows to do it: after `dataNodes` is
      * replaced, which moves the descendants a branch counts, and once a hidden checkbox appears. A microtask later, as
-     * a flat data source assigns `dataNodes` only after it emits.
+     * a consumer's data source can assign `dataNodes` after it emits.
      */
     private scheduleCheckboxSync;
     /** @docs-private */
@@ -1184,12 +1265,12 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     /** @docs-private */
     protected emitChangeEvent(option: KbqTreeOption<T>): void;
     /** @docs-private */
-    readonly selectAllHandlerInput: _angular_core.InputSignalWithTransform<((event: KeyboardEvent, tree: KbqTreeSelection<T>) => void) | undefined, ((event: KeyboardEvent, tree: KbqTreeSelection<T>) => void) | undefined>;
+    readonly selectAllHandlerInput: _angular_core.InputSignalWithTransform<((event: KeyboardEvent, tree: KbqTreeSelection<T, K>) => void) | undefined, ((event: KeyboardEvent, tree: KbqTreeSelection<T, K>) => void) | undefined>;
     /**
      * Function for handling the combination Ctrl + A (select all). By default, the internal handler is used,
      * which toggles the selection of all non-disabled, selectable options.
      */
-    get selectAllHandler(): (event: KeyboardEvent, tree: KbqTreeSelection<T>) => void;
+    get selectAllHandler(): (event: KeyboardEvent, tree: KbqTreeSelection<T, K>) => void;
     private defaultSelectAllHandler;
     selectAllOptions(allowDeselect?: boolean): void;
     copyActiveOption(event: KeyboardEvent): void;
@@ -1259,10 +1340,13 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     private getHeight;
     /** A tree with nothing rendered leaves the tab order, unless a tab index other than `0` is bound. */
     private updateTabIndex;
+    /**
+     * Whether the same options as before now stand for the rows in another order. A different count means rows were
+     * added or removed, which the options query reports itself.
+     */
+    private renderedOptionsOutOfOrder;
     private updateRenderedOptions;
     private getSortedNodes;
-    private resetOptions;
-    private dropSubscriptions;
     private listenToOptionsFocus;
     /**
      * Utility to ensure all indexes are valid.
@@ -1276,8 +1360,8 @@ declare class KbqTreeSelection<T = any> extends KbqTreeBase<T, FlatTreeControl<T
     private updateOptionsFocus;
     private canDeselectLast;
     private isFocusReceivedFromNestedOption;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTreeSelection<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeSelection<any>, "kbq-tree-selection", ["kbqTreeSelection"], { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "autoSelectInput": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "multipleInput": { "alias": "multiple"; "required": false; "isSignal": true; }; "noUnselectLastInput": { "alias": "noUnselectLast"; "required": false; "isSignal": true; }; "typeAheadInput": { "alias": "typeAhead"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAllInput": { "alias": "selectAll"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "selectAllHandlerInput": { "alias": "selectAllHandler"; "required": false; "isSignal": true; }; }, { "navigationChange": "navigationChange"; "selectionChangeOutput": "selectionChange"; "selectAllChange": "selectAllChange"; "onSelectAll": "onSelectAll"; "copyChangeOutput": "copyChange"; "onCopyOutput": "onCopy"; }, ["unorderedOptionsQuery"], never, true, [{ directive: typeof i1.KbqStateSaving; inputs: { "useStateSaving": "useStateSaving"; "stateSavingKey": "stateSavingKey"; }; outputs: {}; }, { directive: typeof i1.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTreeSelection<any, any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTreeSelection<any, any>, "kbq-tree-selection", ["kbqTreeSelection"], { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "autoSelectInput": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "multipleInput": { "alias": "multiple"; "required": false; "isSignal": true; }; "noUnselectLastInput": { "alias": "noUnselectLast"; "required": false; "isSignal": true; }; "typeAheadInput": { "alias": "typeAhead"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAllInput": { "alias": "selectAll"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "selectAllHandlerInput": { "alias": "selectAllHandler"; "required": false; "isSignal": true; }; }, { "navigationChange": "navigationChange"; "selectionChangeOutput": "selectionChange"; "selectAllChange": "selectAllChange"; "onSelectAll": "onSelectAll"; "copyChangeOutput": "copyChange"; "onCopyOutput": "onCopy"; }, ["unorderedOptionsQuery"], never, true, [{ directive: typeof i1.KbqStateSaving; inputs: { "useStateSaving": "useStateSaving"; "stateSavingKey": "stateSavingKey"; }; outputs: {}; }, { directive: typeof i1.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
 }
 
 declare class KbqTreeModule {
@@ -1287,4 +1371,4 @@ declare class KbqTreeModule {
 }
 
 export { BaseTreeControl, FilterByValues, FilterByViewValue, FilterParentsForNodes, FlatTreeControl, KBQ_SELECTION_TREE_VALUE_ACCESSOR, KBQ_TREE_OPTION_PARENT_COMPONENT, KbqTree, KbqTreeBase, KbqTreeCopyEvent, KbqTreeFlatDataSource, KbqTreeFlattener, KbqTreeModule, KbqTreeNavigationChange, KbqTreeNestedDataSource, KbqTreeNode, KbqTreeNodeDef, KbqTreeNodeOutlet, KbqTreeNodeOutletContext, KbqTreeNodePadding, KbqTreeNodeToggleBaseDirective, KbqTreeNodeToggleComponent, KbqTreeNodeToggleDirective, KbqTreeOption, KbqTreeOptionChange, KbqTreeSelectAllEvent, KbqTreeSelection, KbqTreeSelectionChange, NestedTreeControl, defaultCompareValues, defaultCompareViewValues, kbqTreeSelectAllValue };
-export type { FlatTreeControlFilter, KbqTreeOptionEvent, KbqTreeOptionParent, KbqTreeState, TreeControl };
+export type { FlatTreeControlFilter, KbqTreeControlOptions, KbqTreeOptionEvent, KbqTreeOptionParent, KbqTreeState, TreeControl };

package/schematics/migrations/angular-animations-removal/index.js

@@ -1,20 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var warnOnlyMigration = require('../../warn-only-migration-BISJBODk.js');
-var migrations_angularAnimationsRemoval_data = require('./data.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-
-/**
- * Reports the uses of the removed animation triggers and of the members that carried an `AnimationEvent`.
- * Never writes: what replaces a member depends on what the code did with the event.
- */
-function angularAnimationsRemoval(options) {
-    return warnOnlyMigration.warnOnlyRule({ label: '[angular-animations-removal]', warnPatterns: migrations_angularAnimationsRemoval_data.warnPatterns, summary: migrations_angularAnimationsRemoval_data.SUMMARY }, options);
-}
-
-exports.default = angularAnimationsRemoval;

package/schematics/migrations/color-signals/index.js

@@ -1,19 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var signalMembersMigration = require('../../signal-members-migration-BoAJKutT.js');
-var migrations_colorSignals_data = require('./data.js');
-require('typescript');
-require('../../utils/ast.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-require('../../utils/typescript.js');
-
-function colorSignals(options) {
-    return signalMembersMigration.signalMembersRule(migrations_colorSignals_data.config, options);
-}
-
-exports.default = colorSignals;

package/schematics/migrations/core-mixins-removal/index.js

@@ -1,17 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var warnOnlyMigration = require('../../warn-only-migration-BISJBODk.js');
-var migrations_coreMixinsRemoval_data = require('./data.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-
-/** Reports the uses of the removed `mixinDisabled` and `mixinTabIndex`. Never writes. */
-function coreMixinsRemoval(options) {
-    return warnOnlyMigration.warnOnlyRule({ label: '[core-mixins-removal]', warnPatterns: migrations_coreMixinsRemoval_data.warnPatterns, summary: migrations_coreMixinsRemoval_data.SUMMARY }, options);
-}
-
-exports.default = coreMixinsRemoval;

package/schematics/migrations/datepicker-signals/index.js

@@ -1,17 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var warnOnlyMigration = require('../../warn-only-migration-BISJBODk.js');
-var migrations_datepickerSignals_data = require('./data.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-
-/** Reports subclasses of the datepicker classes and direct calls of their `ngOnChanges`. Never writes. */
-function datepickerSignals(options) {
-    return warnOnlyMigration.warnOnlyRule({ label: '[datepicker-signals]', warnPatterns: migrations_datepickerSignals_data.warnPatterns, summary: migrations_datepickerSignals_data.SUMMARY }, options);
-}
-
-exports.default = datepickerSignals;

package/schematics/migrations/dropdown-signals/index.js

@@ -1,19 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var signalMembersMigration = require('../../signal-members-migration-BoAJKutT.js');
-var migrations_dropdownSignals_data = require('./data.js');
-require('typescript');
-require('../../utils/ast.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-require('../../utils/typescript.js');
-
-function dropdownSignals(options) {
-    return signalMembersMigration.signalMembersRule(migrations_dropdownSignals_data.config, options);
-}
-
-exports.default = dropdownSignals;

package/schematics/migrations/input-signals/index.js

@@ -1,17 +0,0 @@
-'use strict';
-
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var warnOnlyMigration = require('../../warn-only-migration-BISJBODk.js');
-var migrations_inputSignals_data = require('./data.js');
-require('../../utils/messages.js');
-require('../../package-config-BhU2TfC8.js');
-require('@angular-devkit/schematics');
-require('@schematics/angular/utility');
-
-/** Reports programmatic writes to the signal inputs of `KbqNumberInput` and `KbqInput`. Never writes. */
-function inputSignals(options) {
-    return warnOnlyMigration.warnOnlyRule({ label: '[input-signals]', warnPatterns: migrations_inputSignals_data.warnPatterns, summary: migrations_inputSignals_data.SUMMARY }, options);
-}
-
-exports.default = inputSignals;