@koobiq/components 20.4.2 → 21.0.0

package/{list/index.d.ts → types/koobiq-components-list.d.ts}

@@ -1,14 +1,13 @@
 import * as _angular_core from '@angular/core';
-import { Provider, AfterContentInit, AfterViewInit, OnDestroy, OnInit, ElementRef, QueryList, EventEmitter } from '@angular/core';
+import { Provider, AfterContentChecked, AfterContentInit, AfterViewInit, OnDestroy, OnInit, ElementRef, QueryList, EventEmitter } from '@angular/core';
 import * as i1$1 from '@angular/cdk/a11y';
 import { FocusMonitor } from '@angular/cdk/a11y';
-import { BooleanInput } from '@angular/cdk/coercion';
 import { SelectionModel } from '@angular/cdk/collections';
 import * as i1 from '@angular/cdk/drag-drop';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
 import { ControlValueAccessor } from '@angular/forms';
 import * as i3 from '@koobiq/components/core';
-import { FocusKeyManager, IFocusableOption, KbqTitleTextRef, KbqOptgroup, KbqOptionActionComponent, KbqPseudoCheckbox, KbqPseudoCheckboxState, MultipleMode, KbqLine } from '@koobiq/components/core';
+import { FocusKeyManager, IFocusableOption, KbqTitleTextRef, KbqOptgroup, KbqOptionActionComponent, KbqPseudoCheckbox, KbqPseudoCheckboxState, KbqMultipleInput, MultipleMode } from '@koobiq/components/core';
 import { KbqDropdownTrigger } from '@koobiq/components/dropdown';
 import { KbqTooltipTrigger } from '@koobiq/components/tooltip';
 import { Subject, Observable } from 'rxjs';
@@ -67,43 +66,46 @@ type KbqListSelectionDroppedEvent = Pick<CdkDragDrop<KbqListSelection>, 'previou
     /** Pointer event that ended the drag. */
     event: MouseEvent | TouchEvent;
 };
-declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewInit, OnDestroy, ControlValueAccessor {
+declare class KbqListSelection<T = any> implements AfterContentChecked, AfterContentInit, AfterViewInit, OnDestroy, ControlValueAccessor {
     private elementRef;
     private changeDetectorRef;
     private clipboard;
     protected readonly focusMonitor: FocusMonitor;
     keyManager: FocusKeyManager<KbqListOption<T>>;
-    options: QueryList<KbqListOption<T>>;
+    private readonly optionsQuery;
+    private readonly optionsList;
+    get options(): QueryList<KbqListOption<T>>;
+    /** Whether `ngAfterContentInit` has run. The options are not settled before that, so nothing reads them. */
+    private contentReady;
     readonly onSelectAll: _angular_core.OutputEmitterRef<KbqListSelectAllEvent<KbqListOption<T>>>;
     /**
-     * Kept as a decorator `@Output()`/`EventEmitter` on purpose: `copyActiveOption` branches on
-     * `onCopy.observed` to decide between the consumer handler and the built-in clipboard copy.
-     * `output()` exposes no subscriber introspection, so migrating it would silently run both
-     * paths for every existing `(onCopy)` consumer. Mirrors `KbqTreeSelection.onCopy`.
+     * Emits when the active option is copied with Ctrl/Cmd + C. Subscribing replaces the built-in clipboard
+     * copy, so the event stays 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 onCopy: EventEmitter<KbqListCopyEvent<KbqListOption<T>>>;
+    /** @docs-private */
+    readonly onCopyOutput: _angular_core.OutputRef<KbqListCopyEvent<KbqListOption<T>>>;
+    /** @docs-private */
+    readonly autoSelectInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
     /**
-     * Whether clicking an option clears the rest of the selection.
-     * Stays an accessor input: the constructor turns it off for `multiple="checkbox"`, which a
-     * signal `input()` cannot do (inputs are read-only from inside the component).
+     * Whether clicking an option clears the rest of the selection. Defaults to `true`, and to `false` for
+     * `multiple="checkbox"`, where a click is expected to toggle a single row. A bound value replaces the
+     * default derived from {@link multiple}.
      */
     get autoSelect(): boolean;
-    set autoSelect(value: boolean);
-    private _autoSelect;
-    /**
-     * Whether the last selected option can be deselected.
-     * Stays an accessor input for the same reason as {@link autoSelect}.
-     */
+    /** @docs-private */
+    readonly noUnselectLastInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** Whether the last selected option can be deselected. Derived from the mode like {@link autoSelect}. */
     get noUnselectLast(): boolean;
-    set noUnselectLast(value: boolean);
-    private _noUnselectLast;
+    /** @docs-private */
+    readonly draggableInput: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
     /**
      * Whether options can be reordered by dragging them.
      * Reordering never mutates the data — handle the `dropped` event and move the item yourself.
      */
     get draggable(): boolean;
-    set draggable(value: boolean);
-    private _draggable;
+    private readonly resolvedDraggable;
     /**
      * Lists that options of this list can be moved into. Accepts `KbqListSelection` instances or the
      * `id` of another list. `cdkDropListGroup` on a common ancestor connects lists automatically.
@@ -150,6 +152,7 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      * Kept apart from {@link options} because that query is public API and means "the options the consumer
      * projected" — a synthetic entry there would corrupt `getSelectedOptionValues`, the drop-indicator
      * geometry and every consumer tally built on it.
+     *
      * @docs-private
      */
     readonly navigableOptions: QueryList<KbqListOption<T>>;
@@ -171,10 +174,8 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      */
     protected get showSelectAll(): boolean;
     /** Label of the "select all" row. Follows the active locale. */
-    protected selectAllText: string;
-    private readonly localeService?;
-    /** Updates locale parameters from the locale service. */
-    private updateLocaleParams;
+    protected get selectAllText(): string;
+    private readonly selectConfiguration;
     /** Whether every option "select all" can act on is selected. */
     get allOptionsSelected(): boolean;
     /** State of the "select all" master checkbox. */
@@ -184,32 +185,47 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      * {@link options}, so the row it renders itself is never among them.
      */
     private get selectAllTargets();
+    private readonly selectAllTargetsState;
     /**
-     * Adapter shared by the master checkbox and the Ctrl/Cmd + A handler, so the two cannot drift apart.
-     *
-     * Takes the items rather than reading {@link selectAllTargets} itself: the toggle needs that array for
-     * the emitted event anyway, and deriving it here as well would walk the whole option list twice.
+     * Adapter shared by the master checkbox and the Ctrl/Cmd + A handler, so the two cannot drift apart. Takes the
+     * items, which the toggle emits as well.
      */
     private selectAllAdapter;
-    multipleMode: MultipleMode | null;
-    get multiple(): boolean;
-    readonly horizontal: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Tab index of the list.
-     * Stays an accessor input: the getter is derived from {@link disabled} and the setter also
-     * records the user-provided value, which the roving focus logic restores after `tabOut`.
+     * Selection mode of the list.
+     *
+     * `checkbox` renders a checkbox in every option, `keyboard` selects without one. A bare `multiple` and
+     * `true` both mean `checkbox`; `single`, `false` and an absent attribute mean single selection. The mode
+     * can be changed at any time — narrowing it to single selection keeps the first selected option and
+     * reports the shortened value through the `ControlValueAccessor`.
+     *
+     * The getter reports whether more than one option can be selected; read {@link multipleMode} for the
+     * mode itself.
      */
-    get tabIndex(): number;
-    set tabIndex(value: number);
-    private _tabIndex;
+    get multiple(): boolean;
+    /** @docs-private */
+    readonly multipleInput: _angular_core.InputSignal<KbqMultipleInput>;
+    /** Resolved selection mode, or `null` when only one option can be selected. */
+    get multipleMode(): MultipleMode | null;
+    set multipleMode(value: MultipleMode | null);
     /**
-     * Whether the list is disabled.
-     * Stays an accessor input: `setDisabledState` writes it from the `ControlValueAccessor`, which a
-     * signal `input()` cannot do.
+     * Backing signal of {@link multipleMode}. A signal rather than a field because the mode is also written
+     * from inside the component: options read it through `multiple` and `showCheckbox`, and only a signal
+     * read re-runs their `OnPush` views and host bindings.
      */
+    private readonly mode;
+    readonly horizontal: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** @docs-private */
+    readonly tabIndexInput: _angular_core.InputSignalWithTransform<number | undefined, string | number | null | undefined>;
+    /** Tab index of the list, `-1` while it is disabled. */
+    get tabIndex(): number;
+    /** Tab index the list holds while enabled. Also written outside any listener, hence a signal. */
+    private readonly ownTabIndex;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** Whether the list is disabled, bound with `[disabled]` or set by a form control. */
     get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
+    private readonly disabledState;
     /**
      * Function used for comparing an option against the selected value when determining which
      * options should appear as selected. The first argument is the value of an options. The second
@@ -222,6 +238,13 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
     userTabIndex: number | null;
     get showCheckbox(): boolean;
     readonly selectionChange: _angular_core.OutputEmitterRef<KbqListSelectionChange<T>>;
+    /**
+     * Model backing the selection.
+     *
+     * The instance is replaced whenever {@link multiple} changes the multiplicity, because CDK freezes that
+     * flag at construction. Subscribe to {@link selectionChange} rather than to `selectionModel.changed`:
+     * a subscription taken on the model directly is left behind on the discarded instance.
+     */
     selectionModel: SelectionModel<KbqListOption<T>>;
     get optionFocusChanges(): Observable<KbqOptionEvent<T>>;
     get optionBlurChanges(): Observable<KbqOptionEvent<T>>;
@@ -244,6 +267,14 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
     private pendingSelectionInit;
     /** Whether a form control has ever written to the list, i.e. whether {@link _value} speaks for a model. */
     private hasWrittenValue;
+    private selectionModelSubscription;
+    /** Whether a value report is already queued for the end of the current tick. */
+    private pendingValueReport;
+    /** The `multiple` binding the mode was last set from, see `applyMultipleInput`. */
+    private appliedMultipleInput;
+    /** The `disabled` binding the state was last set from, see `applyDisabledInput`. */
+    private appliedDisabledInput;
+    private destroyed;
     constructor();
     /** Rebuilds {@link navigableOptions}: the "select all" row, when rendered, leads the projected options. */
     private syncNavigableOptions;
@@ -255,6 +286,7 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      * their own bindings. Without this the row keeps painting a state the options have already left, and
      * a click on a checkbox showing `indeterminate` over an already-full selection takes the deselect
      * branch — doing the opposite of what the user was shown.
+     *
      * @docs-private
      */
     refreshSelectAllState(): void;
@@ -273,7 +305,40 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      * not quietly change what Ctrl/Cmd + A does.
      */
     private get allowSelectAllDeselect();
+    /**
+     * Sets the mode from the `multiple` binding, once per bound value: an unbound input leaves what the
+     * {@link multipleMode} setter wrote, and a value bound back to `undefined` means single selection.
+     *
+     * Called by an effect, and by `writeValue` ahead of it: a forms directive on this element writes the
+     * value from its own `ngOnChanges`, which runs before any effect of the view.
+     */
+    private applyMultipleInput;
+    /**
+     * Sets the disabled state from the `disabled` binding, once per bound value, so that whichever of the binding
+     * and the form control changed last wins. An unbound input leaves what the form control wrote.
+     *
+     * Called by an effect, and by `setDisabledState` ahead of it: a forms directive on this element calls that
+     * from its own `ngOnChanges`, after the binding is set but before any effect of the view runs.
+     */
+    private applyDisabledInput;
+    /**
+     * Applies a new selection mode, rebuilding the `SelectionModel` when the multiplicity itself changes —
+     * CDK freezes that flag at construction, so the model has to be replaced rather than reconfigured.
+     */
+    private setMultipleMode;
+    /** Replaces the `SelectionModel` with one of the given multiplicity, keeping what the new one can hold. */
+    private rebuildSelectionModel;
+    /**
+     * Reports the value once the current change-detection pass is over: a bound `[multiple]` is written
+     * during change detection, and reporting straight back to the form control there would raise
+     * "Expression has changed after it was checked". Coalesced so that several mode changes in one tick
+     * produce one notification, and dropped if the list is gone by the time it runs.
+     */
+    private scheduleValueReport;
+    /** (Re)points the change subscription at the current {@link selectionModel}. */
+    private bindSelectionModel;
     ngAfterContentInit(): void;
+    ngAfterContentChecked(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     focus(): void;
@@ -304,9 +369,15 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
     canDeselectLast(listOption: KbqListOption<T>): boolean;
     /**
      * Rendered height of the element, or 0 when it is not laid out (SSR, jsdom, `display: none`).
+     *
      * @docs-private
      */
     getHeight(): number;
+    /**
+     * Called when the control is blurred. Needed to properly implement `ControlValueAccessor`.
+     *
+     * @docs-private
+     */
     onTouched: () => void;
     removeOptionFromList(option: KbqListOption<T>): void;
     /** Handles keydown events on the list. */
@@ -329,6 +400,7 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
     private setOptionsFromValues;
     /**
      * Utility to ensure all indexes are valid.
+     *
      * @param index The index to be checked.
      * @returns True if the index is valid for our list of options.
      */
@@ -383,18 +455,17 @@ declare class KbqListSelection<T = any> implements AfterContentInit, AfterViewIn
      */
     private followMovedOption;
     private onChange;
+    /** @docs-private */
+    readonly selectAllHandlerInput: _angular_core.InputSignalWithTransform<((event: KeyboardEvent, list: KbqListSelection<T>) => void) | undefined, ((event: KeyboardEvent, list: KbqListSelection<T>) => 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 options.
      */
     get selectAllHandler(): (event: KeyboardEvent, list: KbqListSelection<T>) => void;
-    set selectAllHandler(fn: (event: KeyboardEvent, list: KbqListSelection<T>) => void);
-    private _selectAllHandler;
+    private defaultSelectAllHandler;
     private copyActiveOption;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqListSelection<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListSelection<any>, "kbq-list-selection", ["kbqListSelection"], { "autoSelect": { "alias": "autoSelect"; "required": false; }; "noUnselectLast": { "alias": "noUnselectLast"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "connectedTo": { "alias": "connectedTo"; "required": false; "isSignal": true; }; "dragPreview": { "alias": "dragPreview"; "required": false; "isSignal": true; }; "dragCursor": { "alias": "dragCursor"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAllEnabled": { "alias": "selectAll"; "required": false; "isSignal": true; }; "horizontal": { "alias": "horizontal"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "selectAllHandler": { "alias": "selectAllHandler"; "required": false; }; }, { "onSelectAll": "onSelectAll"; "onCopy": "onCopy"; "dropped": "dropped"; "selectionChange": "selectionChange"; }, ["virtualScroll", "options"], ["*"], true, [{ directive: typeof i1.CdkDropList; inputs: { "id": "id"; }; outputs: {}; }]>;
-    static ngAcceptInputType_draggable: unknown;
-    static ngAcceptInputType_disabled: unknown;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListSelection<any>, "kbq-list-selection", ["kbqListSelection"], { "autoSelectInput": { "alias": "autoSelect"; "required": false; "isSignal": true; }; "noUnselectLastInput": { "alias": "noUnselectLast"; "required": false; "isSignal": true; }; "draggableInput": { "alias": "draggable"; "required": false; "isSignal": true; }; "connectedTo": { "alias": "connectedTo"; "required": false; "isSignal": true; }; "dragPreview": { "alias": "dragPreview"; "required": false; "isSignal": true; }; "dragCursor": { "alias": "dragCursor"; "required": false; "isSignal": true; }; "selectAllToggle": { "alias": "selectAllToggle"; "required": false; "isSignal": true; }; "selectAllEnabled": { "alias": "selectAll"; "required": false; "isSignal": true; }; "multipleInput": { "alias": "multiple"; "required": false; "isSignal": true; }; "horizontal": { "alias": "horizontal"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "compareWith": { "alias": "compareWith"; "required": false; "isSignal": true; }; "selectAllHandlerInput": { "alias": "selectAllHandler"; "required": false; "isSignal": true; }; }, { "onSelectAll": "onSelectAll"; "onCopyOutput": "onCopy"; "dropped": "dropped"; "selectionChange": "selectionChange"; }, ["optionsQuery", "virtualScroll"], ["*"], true, [{ directive: typeof i1.CdkDropList; inputs: { "id": "id"; }; outputs: {}; }]>;
 }
 /**
  * Marker directive for the secondary line of a `kbq-list-option`.
@@ -414,18 +485,24 @@ declare class KbqListOptionCaption {
 declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOption, KbqTitleTextRef {
     private elementRef;
     private changeDetector;
-    private ngZone;
+    private readonly environmentInjector;
     private readonly drag;
     private readonly destroyRef;
     listSelection: KbqListSelection<T>;
     readonly group: KbqOptgroup | null;
-    hasFocus: boolean;
+    get hasFocus(): boolean;
+    set hasFocus(value: boolean);
+    private readonly focused;
     preventBlur: boolean;
     readonly onFocus: Subject<KbqOptionEvent<T>>;
     readonly onBlur: Subject<KbqOptionEvent<T>>;
     readonly actionButton: _angular_core.Signal<KbqOptionActionComponent | undefined>;
-    tooltipTrigger?: KbqTooltipTrigger;
-    dropdownTrigger?: KbqDropdownTrigger;
+    private readonly tooltipTriggerQuery;
+    private readonly dropdownTriggerQuery;
+    /** Tooltip trigger projected into the option. */
+    get tooltipTrigger(): KbqTooltipTrigger | undefined;
+    /** Dropdown trigger projected into the option. */
+    get dropdownTrigger(): KbqDropdownTrigger | undefined;
     readonly pseudoCheckbox: _angular_core.Signal<KbqPseudoCheckbox | undefined>;
     /**
      * Drag handles the consumer has projected into the option. Nothing else reads them — `CdkDrag`
@@ -433,12 +510,12 @@ declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOpt
      */
     private readonly dragHandles;
     readonly text: _angular_core.Signal<ElementRef<any>>;
+    private readonly titleText;
     /**
      * Not a duplicate of {@link text}: this is the `KbqTitleTextRef` property that `title.directive.ts`
-     * reads through `KBQ_TITLE_TEXT_REF`. The interface is a plain `ElementRef`, so it cannot become a
-     * signal query without breaking that contract — same class of constraint as #DS-5079.
+     * reads through `KBQ_TITLE_TEXT_REF`, a plain `ElementRef` rather than a signal.
      */
-    textElement: ElementRef;
+    get textElement(): ElementRef<HTMLElement> | undefined;
     readonly checkboxPosition: _angular_core.InputSignal<"before" | "after">;
     /**
      * Whether this option is the list's "select all" row rather than one the consumer projected.
@@ -446,55 +523,44 @@ declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOpt
      * Such a row has no `value` and no place in the `SelectionModel`, so everything that would resolve
      * it against the list's selection is skipped; its checkbox state and its selected look are driven
      * from the outside instead. It also stays out of the drag-and-drop registry — see the constructor.
+     *
      * @docs-private
      */
     readonly selectAllRow: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /**
-     * This is set to true after the first OnChanges cycle so we don't clear the value of `selected`
-     * in the first cycle.
-     */
-    private inputsInitialized;
-    /**
-     * Value of the option, reported through the list's `ControlValueAccessor`.
-     * Stays an accessor input: the setter drops the selection when the value is replaced.
-     */
+    /** @docs-private */
+    readonly valueInput: _angular_core.InputSignal<T>;
+    /** Value of the option, reported through the list's `ControlValueAccessor`. */
     get value(): T;
-    set value(newValue: T);
-    private _value;
-    /**
-     * Whether the option is disabled.
-     * Stays an accessor input: the getter also reports the disabled state inherited from the list
-     * and the option group, which a signal `input()` cannot express.
-     */
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
+    /** Whether the option is disabled, through its own input, its group or the list. */
     get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
+    private readonly disabledState;
+    /** @docs-private */
+    readonly draggableInput: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
     /**
      * Whether the option can be reordered by dragging. Set it to `false` to pin a single option while
      * the rest of the list stays draggable. Unrelated to `disabled`: the option keeps taking focus and
-     * selection.
-     *
-     * Stays an accessor input: the getter reports the resolved state, which the option can only narrow —
-     * the list gates its whole drop list, so an option cannot opt back in on its own.
+     * selection. Reads the resolved state, which the option can only narrow — the list gates its whole drop
+     * list, so an option cannot opt back in on its own.
      */
     get draggable(): boolean;
-    set draggable(value: boolean);
-    private _draggable;
-    /**
-     * Whether the option renders a pseudo-checkbox.
-     * Stays an accessor input: when unset the getter falls back to the list's own mode.
-     */
+    private readonly resolvedDraggable;
+    /** @docs-private */
+    readonly showCheckboxInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** Whether the option renders a pseudo-checkbox. Falls back to the list's own mode until bound. */
     get showCheckbox(): boolean;
-    set showCheckbox(value: BooleanInput);
-    private _showCheckbox;
+    /** @docs-private */
+    readonly selectedInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
     /**
-     * Whether the option is selected.
-     * Stays an accessor input: the state lives in the list's `SelectionModel`, not on the option.
+     * Whether the option is selected. The state lives in the list's `SelectionModel`, not on the option,
+     * so it can also be set from code.
      */
     get selected(): boolean;
     set selected(value: boolean);
     private _selected;
     get tabIndex(): number | null;
+    private readonly tabIndexState;
     /** `aria-selected` of the row. The "select all" row reports `aria-checked` instead. */
     protected get ariaSelected(): boolean | null;
     /**
@@ -509,6 +575,7 @@ declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOpt
      * CSS, which already hands the grab over to a projected `cdkDragHandle`.
      */
     protected get showsGrabCursor(): boolean;
+    private readonly grabCursorState;
     constructor();
     /**
      * Keeps the underlying `CdkDrag` in sync with the resolved `draggable` state.
@@ -540,10 +607,11 @@ declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOpt
         label: string;
         caption: string;
     };
-    /** Sets the selected state directly on the list's `SelectionModel`, bypassing the `selected` input setter. */
+    /** Sets the selected state on the list's `SelectionModel`; the `selected` property and input go through it. */
     setSelected(selected: boolean): void;
     /**
      * Rendered height of the element, or 0 when it is not laid out (SSR, jsdom, `display: none`).
+     *
      * @docs-private
      */
     getHeight(): number;
@@ -553,15 +621,12 @@ declare class KbqListOption<T = any> implements OnDestroy, OnInit, IFocusableOpt
     protected onKeydown($event: KeyboardEvent): void;
     /** Moves DOM focus to this option, unless it is disabled or already focused. */
     focus(): void;
-    /** Marks this option as blurred once the zone stabilizes, unless {@link preventBlur} is set. */
+    /** Marks this option as blurred after the next render, unless {@link preventBlur} is set. */
     blur(): void;
     /** The option's host DOM element. */
     getHostElement(): HTMLElement;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqListOption<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListOption<any>, "kbq-list-option", ["kbqListOption"], { "checkboxPosition": { "alias": "checkboxPosition"; "required": false; "isSignal": true; }; "selectAllRow": { "alias": "selectAllRow"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "showCheckbox": { "alias": "showCheckbox"; "required": false; }; "selected": { "alias": "selected"; "required": false; }; }, {}, ["actionButton", "pseudoCheckbox", "dragHandles", "tooltipTrigger", "dropdownTrigger"], ["kbq-pseudo-checkbox", "[kbq-icon]", "*", "[kbq-list-option-caption]", "kbq-option-action"], true, [{ directive: typeof i1.CdkDrag; inputs: {}; outputs: {}; }]>;
-    static ngAcceptInputType_disabled: unknown;
-    static ngAcceptInputType_draggable: unknown;
-    static ngAcceptInputType_selected: unknown;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListOption<any>, "kbq-list-option", ["kbqListOption"], { "checkboxPosition": { "alias": "checkboxPosition"; "required": false; "isSignal": true; }; "selectAllRow": { "alias": "selectAllRow"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "draggableInput": { "alias": "draggable"; "required": false; "isSignal": true; }; "showCheckboxInput": { "alias": "showCheckbox"; "required": false; "isSignal": true; }; "selectedInput": { "alias": "selected"; "required": false; "isSignal": true; }; }, {}, ["actionButton", "tooltipTriggerQuery", "dropdownTriggerQuery", "pseudoCheckbox", "dragHandles"], ["kbq-pseudo-checkbox", "[kbq-icon]", "*", "[kbq-list-option-caption]", "kbq-option-action"], true, [{ directive: typeof i1.CdkDrag; inputs: {}; outputs: {}; }]>;
 }
 
 /**
@@ -576,20 +641,18 @@ declare class KbqList {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqList, "kbq-list", never, {}, {}, never, ["*"], true, never>;
 }
 /** A single row of a `kbq-list`. Non-selectable — see `kbq-list-option` for the selectable variant. */
-declare class KbqListItem implements AfterContentInit {
+declare class KbqListItem {
     private elementRef;
-    lines: QueryList<KbqLine>;
-    ngAfterContentInit(): void;
     getHostElement(): HTMLElement;
     protected handleFocus(): void;
     protected handleBlur(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqListItem, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListItem, "kbq-list-item, a[kbq-list-item]", never, {}, {}, ["lines"], ["[kbq-list-icon], [mcListIcon]", "[kbq-line], [mcLine]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqListItem, "kbq-list-item, a[kbq-list-item]", never, {}, {}, never, ["[kbq-list-icon]", "[kbq-line]", "*"], true, never>;
 }
 
 declare class KbqListModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqListModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqListModule, never, [typeof i1$1.A11yModule, typeof i1.CdkDragHandle, typeof i3.KbqPseudoCheckboxModule, typeof i3.KbqLine, typeof i3.KbqOptionModule, typeof i3.KbqActionContainer, typeof i4.KbqIconModule, typeof KbqList, typeof KbqListSelection, typeof KbqListItem, typeof KbqListOption, typeof KbqListOptionCaption], [typeof i1.CdkDragHandle, typeof KbqList, typeof KbqListSelection, typeof KbqListItem, typeof KbqListOption, typeof KbqListOptionCaption, typeof i3.KbqOptionModule]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqListModule, never, [typeof i1$1.A11yModule, typeof i1.CdkDragHandle, typeof i3.KbqPseudoCheckboxModule, typeof i3.KbqOptionModule, typeof i3.KbqActionContainer, typeof i4.KbqIconModule, typeof KbqList, typeof KbqListSelection, typeof KbqListItem, typeof KbqListOption, typeof KbqListOptionCaption], [typeof i1.CdkDragHandle, typeof KbqList, typeof KbqListSelection, typeof KbqListItem, typeof KbqListOption, typeof KbqListOptionCaption, typeof i3.KbqOptionModule]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqListModule>;
 }
 

package/types/koobiq-components-loader-overlay.d.ts

@@ -0,0 +1,101 @@
+import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
+import { KbqDefaultSizes } from '@koobiq/components/core';
+import * as i3 from '@koobiq/components/progress-spinner';
+import { ProgressSpinnerSize } from '@koobiq/components/progress-spinner';
+import * as i1 from '@angular/cdk/a11y';
+import * as i2 from '@angular/cdk/platform';
+
+/** Semantic background variants for `KbqLoaderOverlay`. */
+type KbqLoaderOverlaySurface = 'solid' | 'bg' | 'bg-secondary' | 'bg-tertiary' | 'card';
+/** Directive that marks a custom loading indicator projected into the overlay. */
+declare class KbqLoaderOverlayIndicator {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqLoaderOverlayIndicator, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqLoaderOverlayIndicator, "[kbq-loader-overlay-indicator]", never, {}, {}, never, never, true, never>;
+}
+/** Directive that marks custom text projected into the overlay. */
+declare class KbqLoaderOverlayText {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqLoaderOverlayText, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqLoaderOverlayText, "[kbq-loader-overlay-text]", never, {}, {}, never, never, true, never>;
+}
+/** Directive that marks a custom caption projected into the overlay. */
+declare class KbqLoaderOverlayCaption {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqLoaderOverlayCaption, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqLoaderOverlayCaption, "[kbq-loader-overlay-caption]", never, {}, {}, never, never, true, never>;
+}
+/** Component that covers its parent element while an operation is in progress. */
+declare class KbqLoaderOverlay implements OnInit, OnDestroy {
+    private readonly nativeElement;
+    private readonly renderer;
+    private readonly document;
+    private readonly focusMonitor;
+    private readonly inputModalityDetector;
+    private readonly environmentInjector;
+    private readonly mutationObserverFactory;
+    private readonly ngZone;
+    private readonly isBrowser;
+    private readonly externalIndicator;
+    private readonly externalText;
+    private readonly externalCaption;
+    private parent;
+    private readonly inertSiblings;
+    private siblingsObserver;
+    private previouslyFocused;
+    private previousFocusOrigin;
+    /** Text shown under the indicator. Ignored when a `[kbq-loader-overlay-text]` is projected. */
+    readonly text: _angular_core.InputSignal<string | undefined>;
+    /** Caption shown under the text. Ignored when a `[kbq-loader-overlay-caption]` is projected. */
+    readonly caption: _angular_core.InputSignal<string | undefined>;
+    /** Size of the overlay and of its default indicator. */
+    readonly size: _angular_core.InputSignal<KbqDefaultSizes>;
+    /**
+     * Sets the surface and opacity mode used by the overlay.
+     *
+     * `solid` is an opaque overlay. Other values select a transparent overlay that matches the corresponding surface.
+     */
+    readonly surface: _angular_core.InputSignal<KbqLoaderOverlaySurface | null | undefined>;
+    /**
+     * Controls the legacy overlay opacity when `surface` is not set and `card` is disabled.
+     *
+     * @deprecated Use `surface="bg"` for a transparent overlay or `surface="solid"` for an opaque overlay. Will
+     * be removed in 22.0.0.
+     */
+    readonly transparent: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Uses a semi-transparent card background and overrides `transparent` when `surface` is not set.
+     *
+     * @deprecated Use `surface="card"` instead. Will be removed in 22.0.0.
+     */
+    readonly card: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** @docs-private */
+    protected readonly isExternalIndicator: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    protected readonly isExternalText: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    protected readonly isExternalCaption: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    protected readonly isEmpty: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    protected readonly spinnerSize: _angular_core.Signal<ProgressSpinnerSize>;
+    /** @docs-private */
+    protected readonly loaderSizeClass: _angular_core.Signal<string>;
+    /** @docs-private */
+    protected readonly resolvedSurface: _angular_core.Signal<KbqLoaderOverlaySurface>;
+    ngOnInit(): void;
+    ngOnDestroy(): void;
+    private blockSiblings;
+    private makeInert;
+    private saveFocus;
+    private restoreFocus;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqLoaderOverlay, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqLoaderOverlay, "kbq-loader-overlay", never, { "text": { "alias": "text"; "required": false; "isSignal": true; }; "caption": { "alias": "caption"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "surface": { "alias": "surface"; "required": false; "isSignal": true; }; "transparent": { "alias": "transparent"; "required": false; "isSignal": true; }; "card": { "alias": "card"; "required": false; "isSignal": true; }; }, {}, ["externalIndicator", "externalText", "externalCaption"], ["[kbq-loader-overlay-indicator]", "[kbq-loader-overlay-text]", "[kbq-loader-overlay-caption]"], true, never>;
+}
+
+declare class KbqLoaderOverlayModule {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqLoaderOverlayModule, never>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqLoaderOverlayModule, never, [typeof i1.A11yModule, typeof i2.PlatformModule, typeof i3.KbqProgressSpinnerModule, typeof KbqLoaderOverlay, typeof KbqLoaderOverlayIndicator, typeof KbqLoaderOverlayText, typeof KbqLoaderOverlayCaption], [typeof KbqLoaderOverlay, typeof KbqLoaderOverlayIndicator, typeof KbqLoaderOverlayText, typeof KbqLoaderOverlayCaption]>;
+    static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqLoaderOverlayModule>;
+}
+
+export { KbqLoaderOverlay, KbqLoaderOverlayCaption, KbqLoaderOverlayIndicator, KbqLoaderOverlayModule, KbqLoaderOverlayText };
+export type { KbqLoaderOverlaySurface };