@koobiq/components 20.4.2 → 21.0.0

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

@@ -1,274 +1,40 @@
 import * as _angular_core from '@angular/core';
-import { AfterViewInit, ChangeDetectorRef, DestroyRef, ElementRef, TemplateRef, InjectionToken, ModelSignal, Signal, OutputEmitterRef, Type, Provider, OnInit, AfterContentInit } from '@angular/core';
+import { InjectionToken, Signal, ModelSignal, TemplateRef, OutputEmitterRef, Provider, AfterViewInit, OnInit, ElementRef, DestroyRef, AfterContentInit, ChangeDetectorRef, Type } from '@angular/core';
 import * as _koobiq_components_core from '@koobiq/components/core';
-import { KbqPanelMaxHeight, PopUpPlacements, KbqComponentColors, PopUpSizes, KbqOption, DateAdapter, DateFormatter, KbqPseudoCheckboxState } from '@koobiq/components/core';
-import { Subject, BehaviorSubject, Observable } from 'rxjs';
+import { KbqFilterBarLocaleConfiguration, KbqPanelMaxHeight, KbqDeepPartial, PopUpPlacements, PopUpSizes, KbqOption, DateAdapter, DateFormatter, KbqComponentColors, KbqPseudoCheckboxState } from '@koobiq/components/core';
+export { KbqFilterBarLocaleConfiguration } from '@koobiq/components/core';
+import { BehaviorSubject, Subject } from 'rxjs';
+import { KbqButton, KbqButtonStyles } from '@koobiq/components/button';
 import { FocusMonitor, FocusOrigin } from '@angular/cdk/a11y';
 import { FormControl, FormGroup } from '@angular/forms';
-import { KbqButtonStyles, KbqButton } from '@koobiq/components/button';
 import { KbqDropdownTrigger } from '@koobiq/components/dropdown';
 import { KbqPopoverTrigger } from '@koobiq/components/popover';
+import * as _koobiq_components_filter_bar from '@koobiq/components/filter-bar';
 import { KbqSelect } from '@koobiq/components/select';
 import { KbqListSelection } from '@koobiq/components/list';
 import { KbqInput } from '@koobiq/components/input';
 import { FlatTreeControl, KbqTreeFlattener, KbqTreeFlatDataSource, KbqTreeSelection, KbqTreeOption } from '@koobiq/components/tree';
 import { KbqTreeSelect } from '@koobiq/components/tree-select';
 
-/** Injection Token for providing configuration of filter-bar */
-declare const KBQ_PIPE_DATA: InjectionToken<unknown>;
-/** function to get unique identifier of an element */
-declare function getId(item: KbqPipeTemplate): KbqPipeType | string | number;
-declare abstract class KbqBasePipe<V> implements AfterViewInit {
-    /** changes of state */
-    readonly stateChanges: Subject<void>;
-    /** pipe data. Provided from subclass */
-    readonly data: KbqPipeData<V>;
-    /** KbqFilterBar instance
-     * @docs-private */
-    protected readonly filterBar: KbqFilterBarHost | null;
-    /** @docs-private */
-    protected readonly changeDetectorRef: ChangeDetectorRef;
-    /** @docs-private */
-    protected readonly destroyRef: DestroyRef;
-    /** @docs-private */
-    protected readonly focusMonitor: FocusMonitor;
-    /** @docs-private */
-    protected readonly elementRef: ElementRef<HTMLElement>;
-    private readonly inputModalityDetector;
-    private readonly document;
-    /**
-     * Whether this pipe has been destroyed. Guards deferred (`setTimeout`) work that could otherwise
-     * read view queries or mutate `data` after the pipe was removed or the filter switched.
-     * @docs-private
-     */
-    protected destroyed: boolean;
-    /** values to select from the pipe template */
-    protected values: any;
-    /** TemplateRef for selecting an option */
-    protected valueTemplate?: TemplateRef<any> | string;
-    /**
-     * Optional equality comparator forwarded from the pipe template to the underlying `kbq-select`.
-     * Only consumed by the select / multi-select pipe components; when unset they fall back to their
-     * own id-based `compareByValue`.
-     */
-    protected optionCompareWith?: (o1: KbqSelectValue | null | undefined, o2: KbqSelectValue | null | undefined) => boolean;
-    /**
-     * Values forwarded from the pipe template whose selection the user cannot remove. Only consumed by
-     * the multi-select pipe components; other pipe types ignore it.
-     */
-    protected lockedValues?: unknown[];
-    /**
-     * Maximum height of the dropdown panel's scrollable list, forwarded from the pipe template to the
-     * underlying `kbq-select` / `kbq-tree-select`. Only consumed by the select-family pipe components;
-     * `undefined` leaves the list at the select-family default of 256px.
-     */
-    protected panelMaxHeight?: KbqPanelMaxHeight;
-    /**
-     * Whether the dropdown's option names and captions wrap instead of being truncated, forwarded from
-     * the pipe template. Only consumed by the select / multi-select pipe components.
-     */
-    protected multilineOptions?: boolean;
-    /**
-     * Whether the current platform is a Mac.
-     *
-     * @docs-private
-     */
-    isMac: boolean;
-    /** Data for the pipe.
-     *  @docs-private */
-    $implicit: unknown;
-    /** Whether the current pipe is empty. Used for apply style modifier */
-    get isEmpty(): boolean;
-    /** Whether the current pipe is removable or cleanable. Used for apply style modifier */
-    get showRemoveButton(): boolean;
-    /** localized data
-     * @docs-private */
-    get localeData(): KbqFilterBarConfiguration;
-    constructor();
-    ngAfterViewInit(): void;
-    /** templateRef checker utility */
-    isTemplateRef(value: unknown): boolean;
-    /** updates values for selection and value template */
-    updateTemplates: (templates: KbqPipeTemplate[] | null) => void;
-    /** removes pipe from filter-bar and triggers changes */
-    onRemove(): void;
-    /** clears the pipe and triggers changes */
-    onClear(): void;
-    /**
-     * Value a cleared pipe is left with. Overridden by pipes that keep part of their value across a clear
-     * — the multi-select pipes hold on to their locked options.
-     *
-     * @docs-private
-     */
-    protected clearedValue(): V | null;
-    /**
-     * Focus origin to hand to {@link FocusMonitor} whenever this pipe moves focus programmatically, so the
-     * `.cdk-keyboard-focused` ring is painted for keyboard navigation only and never for a mouse-driven one.
-     *
-     * `InputModalityDetector.mostRecentModality` reflects what the user is doing *right now*, and is the
-     * only source that stays correct while a panel is open: panel content lives in the CDK overlay
-     * container, which is not a DOM descendant of the pipe host, so a focus origin captured on the host
-     * itself would freeze at "how the trigger was focused" and couldn't tell a click inside the panel apart
-     * from the keypress that opened it. The detector reacts only to `keydown`/`mousedown`/`touchstart`
-     * (never to hover or scroll), so merely moving the mouse cannot strip a keyboard user's ring, and it
-     * maps a screen reader's synthetic mousedown to `keyboard`. It falls back to `'program'` only before any
-     * such interaction has ever occurred on the page — at which point no ring should be shown anyway.
-     *
-     * @docs-private
-     */
-    protected get currentFocusOrigin(): NonNullable<FocusOrigin>;
-    /**
-     * Restores focus to the pipe's trigger button after a value is chosen or the panel closes.
-     * Focuses via {@link FocusMonitor} with `currentFocusOrigin` so a keyboard-driven interaction keeps
-     * its focus ring, while a mouse-driven one does not.
-     *
-     * @docs-private
-     */
-    protected restoreTriggerFocus(): void;
-    /** @docs-private */
-    abstract open(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqBasePipe<any>, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqBasePipe<any>, never, never, {}, {}, never, never, true, never>;
-}
-/**
- * Keeps a pipe part at its natural width while its text is shorter than `maxSymbolsForFitContent`.
- *
- * @deprecated A pipe lays its name and value out as two shrinkable grid tracks, which already keeps a
- * short part intact; on a grid item this `min-width` only pushes the part past its track, where it is
- * clipped without an ellipsis. Will be removed in the next major.
- */
-declare class KbqPipeMinWidth {
-    /** KbqFilterBar instance */
-    protected readonly filterBar: KbqFilterBarHost | null;
-    /** @docs-private */
-    protected readonly elementRef: ElementRef<HTMLElement>;
-    /** @docs-private */
-    protected readonly changeDetectorRef: ChangeDetectorRef;
-    /** @docs-private */
-    protected minWidth: string;
-    /** maximal symbols for apply fit-content to min-width */
-    maxSymbolsForFitContent: number;
-    /** current length of text */
-    get textLength(): number;
-    constructor();
-    update: () => void;
-    /** Schedules a deferred min-width recompute and returns the effect-cleanup that cancels it. */
-    private scheduleMinWidthUpdate;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqPipeMinWidth, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqPipeMinWidth, "[kbqPipeMinWidth]", never, {}, {}, never, never, true, never>;
-}
-
 /**
  * Default localized strings for the filter-bar, used when no `KBQ_LOCALE_SERVICE` (nor an explicit
- * `KBQ_FILTER_BAR_CONFIGURATION`) is provided. These are the Russian (`ru-RU`) strings, matching the
- * library-wide default-locale convention (every `KBQ_*_DEFAULT_CONFIGURATION` resolves to `ruRULocaleData`).
+ * `KBQ_FILTER_BAR_LOCALE_CONFIGURATION`) is provided. These are the Russian (`ru-RU`) strings, matching the
+ * library-wide default-locale convention (every `KBQ_*_DEFAULT_LOCALE_CONFIGURATION` resolves to
+ * `ruRULocaleData`).
  * Provide `KBQ_LOCALE_SERVICE` at the application root to localize the filter-bar for other locales.
  */
-declare const KBQ_FILTER_BAR_DEFAULT_CONFIGURATION: {
-    reset: {
-        buttonName: string;
-    };
-    search: {
-        tooltip: string;
-        placeholder: string;
-    };
-    filters: {
-        defaultName: string;
-        saveNewFilterTooltip: string;
-        searchPlaceholder: string;
-        searchEmptyResult: string;
-        saveAsNewFilter: string;
-        saveChanges: string;
-        saveAsNew: string;
-        change: string;
-        resetChanges: string;
-        remove: string;
-        name: string;
-        error: string;
-        errorHint: string;
-        saveButton: string;
-        cancelButton: string;
-        actionsTooltip: string;
-    };
-    add: {
-        tooltip: string;
-        addedAnnouncement: string;
-    };
-    refresher: {
-        refresh: string;
-        settings: string;
-    };
-    pipe: {
-        clearButtonTooltip: string;
-        removeButtonTooltip: string;
-        applyButton: string;
-        emptySearchResult: string;
-        selectAll: string;
-    };
-    datePipe: {
-        customPeriod: string;
-        customPeriodFrom: string;
-        customPeriodTo: string;
-        customPeriodErrorHint: string;
-        customPeriodMinIntervalErrorHint: string;
-        customPeriodMaxIntervalErrorHint: string;
-        backToPeriodSelection: string;
-    };
-};
-/** Shape of the localized strings consumed by the filter-bar and its pipes. */
-type KbqFilterBarConfiguration = typeof KBQ_FILTER_BAR_DEFAULT_CONFIGURATION;
+declare const KBQ_FILTER_BAR_DEFAULT_LOCALE_CONFIGURATION: KbqFilterBarLocaleConfiguration;
 /** Injection Token for providing configuration of filter-bar */
-declare const KBQ_FILTER_BAR_CONFIGURATION: InjectionToken<{
-    reset: {
-        buttonName: string;
-    };
-    search: {
-        tooltip: string;
-        placeholder: string;
-    };
-    filters: {
-        defaultName: string;
-        saveNewFilterTooltip: string;
-        searchPlaceholder: string;
-        searchEmptyResult: string;
-        saveAsNewFilter: string;
-        saveChanges: string;
-        saveAsNew: string;
-        change: string;
-        resetChanges: string;
-        remove: string;
-        name: string;
-        error: string;
-        errorHint: string;
-        saveButton: string;
-        cancelButton: string;
-        actionsTooltip: string;
-    };
-    add: {
-        tooltip: string;
-        addedAnnouncement: string;
-    };
-    refresher: {
-        refresh: string;
-        settings: string;
-    };
-    pipe: {
-        clearButtonTooltip: string;
-        removeButtonTooltip: string;
-        applyButton: string;
-        emptySearchResult: string;
-        selectAll: string;
-    };
-    datePipe: {
-        customPeriod: string;
-        customPeriodFrom: string;
-        customPeriodTo: string;
-        customPeriodErrorHint: string;
-        customPeriodMinIntervalErrorHint: string;
-        customPeriodMaxIntervalErrorHint: string;
-        backToPeriodSelection: string;
-    };
-}>;
+declare const KBQ_FILTER_BAR_LOCALE_CONFIGURATION: InjectionToken<KbqFilterBarLocaleConfiguration>;
+/**
+ * Utility provider for `KBQ_FILTER_BAR_LOCALE_CONFIGURATION`. Only the strings you pass are overridden; the rest
+ * keep following the active locale.
+ */
+declare const kbqFilterBarLocaleConfigurationProvider: (configuration: KbqDeepPartial<KbqFilterBarLocaleConfiguration>) => Provider;
+/** @deprecated Use {@link KBQ_FILTER_BAR_DEFAULT_LOCALE_CONFIGURATION}. Will be removed in 22.0.0. */
+declare const KBQ_FILTER_BAR_DEFAULT_CONFIGURATION: KbqFilterBarLocaleConfiguration;
+/** @deprecated Use {@link KBQ_FILTER_BAR_LOCALE_CONFIGURATION}. Will be removed in 22.0.0. */
+declare const KBQ_FILTER_BAR_CONFIGURATION: InjectionToken<KbqFilterBarLocaleConfiguration>;
 /**
  * Contract a pipe (or filter-bar sub-component) depends on instead of the concrete `KbqFilterBar`.
  * `KbqFilterBar` provides itself as {@link KBQ_FILTER_BAR_HOST}, so a pipe can be unit-tested against a
@@ -276,8 +42,12 @@ declare const KBQ_FILTER_BAR_CONFIGURATION: InjectionToken<{
  * they are expected to slim down once the state model moves to signals.
  */
 interface KbqFilterBarHost {
-    /** Localized strings and configuration for the filter-bar and its pipes. */
-    configuration: KbqFilterBarConfiguration;
+    /**
+     * Localized strings and configuration for the filter-bar and its pipes. Read via `localeConfiguration()`:
+     * the bar derives it from the active locale, so an override is registered with
+     * `kbqFilterBarLocaleConfigurationProvider` or bound as `[localeOverrides]`.
+     */
+    readonly localeConfiguration: Signal<KbqFilterBarLocaleConfiguration>;
     /** Currently selected filter. A two-way-bindable `model()`: read via `filter()`, write via `filter.set()`. */
     readonly filter: ModelSignal<KbqFilter | null>;
     /** Templates used when adding a pipe (also hold the option lists). Read via `pipeTemplates()`. */
@@ -324,13 +94,16 @@ interface KbqFilterBarHost {
  */
 declare const KBQ_FILTER_BAR_HOST: InjectionToken<KbqFilterBarHost>;
 /**
- * Injection Token for providing pipes in filter-bar. Defaults to {@link defaultFilterBarPipes} so the
- * standalone `KbqFilterBar` works without `KbqFilterBarModule`; override it with
- * {@link kbqFilterBarPipesProvider} or a provider of your own.
+ * Contract a projected child depends on instead of the concrete `KbqFilters`. `KbqFilters` provides
+ * itself as {@link KBQ_FILTERS}, so a child declared in its template does not import the component that
+ * declares it.
  */
-declare const KBQ_FILTER_BAR_PIPES: InjectionToken<Map<KbqPipeType, Type<KbqBasePipe<unknown>>>>;
-/** Utility provider for `KBQ_FILTER_BAR_PIPES`. */
-declare const kbqFilterBarPipesProvider: () => Provider;
+interface KbqFiltersHost {
+    /** Remembers the control focus returns to once the save popover closes. */
+    saveFocusedElement(button?: KbqButton): void;
+}
+/** Injection token exposing the {@link KbqFiltersHost} seam. */
+declare const KBQ_FILTERS: InjectionToken<KbqFiltersHost>;
 /** list of pipe types available out of the box */
 declare enum KbqPipeTypes {
     ReadOnly = "readonly",
@@ -345,8 +118,6 @@ declare enum KbqPipeTypes {
     Datetime = "datetime"
 }
 type KbqPipeType = `${KbqPipeTypes}` | (string & {});
-/** list of pipes available out of the box. */
-declare const defaultFilterBarPipes: [KbqPipeType, Type<KbqBasePipe<unknown>>][];
 interface KbqDateTimeValue {
     name?: string;
     start?: string;
@@ -385,12 +156,33 @@ interface KbqPipe {
      * Default is true
      * */
     selectedAllEqualsSelectedNothing?: boolean;
-    /** @deprecated use cleanable = false and removable = false instead */
-    required?: boolean;
     cleanable: boolean;
     removable: boolean;
     disabled: boolean;
 }
+/**
+ * One pipe as it is persisted: what identifies it, and what the user put in it.
+ *
+ * Deliberately not the pipe itself. A pipe built from a template keeps whatever that template carried
+ * (`pipe-add.ts` strips only `values` and `valueTemplate`), so it can hold a `compareWith` function or a
+ * `DateTime` bound — things `JSON.stringify` drops silently rather than rejecting. Everything but the
+ * value is rebuilt from the application's own filters and templates while restoring.
+ */
+interface KbqFilterBarPipeState {
+    /** `getId(pipe)` — the pipe's `id`, or its `name` when it has none. */
+    id: string | number;
+    /** The pipe's value, in whatever shape the pipe stores it. Has to survive `JSON.stringify`. */
+    value: unknown;
+}
+/** The persisted state of a filter bar: which filter was selected, and the edits made to it. */
+interface KbqFilterBarState {
+    /** `KbqFilter.name`, the only identity a filter has. Empty for a filter the user never saved. */
+    name: string;
+    /** Whether the filter carried unsaved changes. */
+    changed: boolean;
+    /** The filter's pipes, in order. */
+    pipes: KbqFilterBarPipeState[];
+}
 interface KbqPipeData<V> extends KbqPipe {
     value: V | null;
 }
@@ -432,6 +224,12 @@ interface KbqPipeTemplate extends Omit<KbqPipe, 'value'> {
      * `KbqSelect.multiline`, which lays the trigger's values out in rows.
      */
     multilineOptions?: boolean;
+    /**
+     * Message shown in the dropdown of the `select`, `multiselect`, `tree-select` and `multi-tree-select`
+     * pipes when `values` is empty. Defaults to the localized `pipe.noOptions` string. Ignored by other pipe
+     * types.
+     */
+    noOptionsText?: string;
     /**
      * Earliest selectable instant for the `date` / `datetime` pipe custom period. Accepts any value the
      * configured `DateAdapter` can deserialize (with the default Luxon adapter: an ISO-8601 string, a
@@ -502,9 +300,12 @@ declare class KbqFilterReset {
     private readonly filterBar;
     /** Event that is generated whenever the user reset a filter. */
     readonly onResetFilter: _angular_core.OutputEmitterRef<KbqFilter | null>;
-    /** localized data
-     * @docs-private */
-    get localeData(): string;
+    /**
+     * Default label of the reset button, shown when no content is projected.
+     *
+     * @docs-private
+     */
+    protected readonly buttonName: _angular_core.Signal<string>;
     protected resetFilter(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFilterReset, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFilterReset, "kbq-filter-reset", never, {}, { "onResetFilter": "onResetFilter"; }, never, ["*"], true, never>;
@@ -549,30 +350,16 @@ declare class KbqFilterSavePopover implements AfterViewInit {
     /** Custom error text passed to `showError()`; `null` when the locale-derived default should be used. */
     private customErrorText;
     isSaving: boolean;
-    /** localized data
-     * @docs-private */
-    get localeData(): {
-        defaultName: string;
-        saveNewFilterTooltip: string;
-        searchPlaceholder: string;
-        searchEmptyResult: string;
-        saveAsNewFilter: string;
-        saveChanges: string;
-        saveAsNew: string;
-        change: string;
-        resetChanges: string;
-        remove: string;
-        name: string;
-        error: string;
-        errorHint: string;
-        saveButton: string;
-        cancelButton: string;
-        actionsTooltip: string;
-    };
-    /** Filter saving error text (custom or locale-derived).
-     * @docs-private */
+    /**
+     * Filter saving error text (custom or locale-derived).
+     *
+     * @docs-private
+     */
     get filterSavingErrorText(): string;
-    /** header of popover. Depends on the mode */
+    /**
+     * Header of the popover, which depends on the mode: a new filter or a new name for the current one.
+     * It doubles as the caption of the unlabelled name field.
+     */
     get popoverHeader(): string;
     ngAfterViewInit(): void;
     openSaveAsNewFilterPopover(): void;
@@ -598,33 +385,28 @@ declare class KbqFilters implements OnInit {
     protected readonly focusMonitor: FocusMonitor;
     /** @docs-private */
     protected readonly placements: typeof PopUpPlacements;
-    /** @docs-private */
-    protected readonly styles: typeof KbqButtonStyles;
-    /** @docs-private */
-    protected readonly colors: typeof KbqComponentColors;
     /** KbqFilterBar instance */
     protected readonly filterBar: KbqFilterBar;
     /** @docs-private */
-    private readonly changeDetectorRef;
-    /** @docs-private */
-    protected readonly mainButton: _angular_core.Signal<KbqButton>;
+    protected readonly mainButton: Signal<KbqButton>;
     /** @docs-private */
-    protected readonly saveNewFilterButton: _angular_core.Signal<KbqButton>;
+    protected readonly saveNewFilterButton: Signal<KbqButton>;
     /** @docs-private */
-    protected readonly filterActionsButton: _angular_core.Signal<KbqButton>;
+    protected readonly filterActionsButton: Signal<KbqButton>;
     /** @docs-private */
-    protected readonly popover: _angular_core.Signal<KbqPopoverTrigger>;
+    protected readonly popover: Signal<KbqPopoverTrigger>;
     /** @docs-private */
-    protected readonly dropdown: _angular_core.Signal<KbqDropdownTrigger>;
+    protected readonly dropdown: Signal<KbqDropdownTrigger>;
     /** @docs-private */
-    protected readonly filterActionsDropdown: _angular_core.Signal<KbqDropdownTrigger | undefined>;
+    protected readonly filterActionsDropdown: Signal<KbqDropdownTrigger | undefined>;
     /** @docs-private */
-    protected readonly savePopover: _angular_core.Signal<KbqFilterSavePopover>;
+    protected readonly savePopover: Signal<KbqFilterSavePopover>;
     private readonly search;
     /** control for search filter */
     readonly searchControl: FormControl<string | null>;
-    /** filtered by search filters */
-    filteredOptions: Observable<KbqFilter[]>;
+    private readonly searchQuery;
+    /** Saved filters whose name matches the search query. */
+    readonly filteredOptions: Signal<KbqFilter[]>;
     /** @docs-private */
     protected readonly popoverSize = PopUpSizes.Medium;
     /** @docs-private */
@@ -655,28 +437,11 @@ declare class KbqFilters implements OnInit {
     get filter(): KbqFilter | null;
     /** Component state. True if 'filters' input contains no elements. */
     get isEmpty(): boolean;
-    /** localized data
-     * @docs-private */
-    get localeData(): {
-        defaultName: string;
-        saveNewFilterTooltip: string;
-        searchPlaceholder: string;
-        searchEmptyResult: string;
-        saveAsNewFilter: string;
-        saveChanges: string;
-        saveAsNew: string;
-        change: string;
-        resetChanges: string;
-        remove: string;
-        name: string;
-        error: string;
-        errorHint: string;
-        saveButton: string;
-        cancelButton: string;
-        actionsTooltip: string;
-    };
-    /** Current focus origin state.
-     * @docs-private */
+    /**
+     * Current focus origin state.
+     *
+     * @docs-private
+     */
     get focusOrigin(): FocusOrigin;
     private _focusOrigin;
     private focusedElementBeforeOpen;
@@ -698,8 +463,10 @@ declare class KbqFilters implements OnInit {
     onDropdownOpen(): void;
     resetFilterChanges(): void;
     removeFilter(): void;
-    /** Hide the popup and restore focus.
-     * Use this method in the onSave or onChangeFilter events after the data has been successfully saved. */
+    /**
+     * Hide the popup and restore focus.
+     * Use this method in the onSave or onChangeFilter events after the data has been successfully saved.
+     */
     filterSavedSuccessfully(): void;
     /** Shows an error. Use this method in the onSave or onChangeFilter events if saving data failed. */
     filterSavedUnsuccessfully(error?: KbqSaveFilterError): void;
@@ -719,8 +486,11 @@ declare class KbqFilters implements OnInit {
     set showFilterSavingError(value: boolean);
     /** @docs-private */
     get filterSavingErrorText(): string;
-    /** header of popover. Depends on the mode
-     * @docs-private */
+    /**
+     * header of popover. Depends on the mode
+     *
+     * @docs-private
+     */
     get popoverHeader(): string;
     /** @docs-private */
     openSaveAsNewFilterPopover(): void;
@@ -737,66 +507,14 @@ declare class KbqFilters implements OnInit {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFilters, "kbq-filters", ["kbqFilters"], { "filters": { "alias": "filters"; "required": true; "isSignal": true; }; }, { "onSelectFilter": "onSelectFilter"; "onSave": "onSave"; "onChangeFilter": "onChangeFilter"; "onRemoveFilter": "onRemoveFilter"; "onResetFilterChanges": "onResetFilterChanges"; }, never, ["*"], true, never>;
 }
 
-declare class KbqFilterBar implements KbqFilterBarHost {
-    /** @docs-private */
-    protected readonly changeDetectorRef: ChangeDetectorRef;
-    /** @docs-private */
-    protected readonly localeService: _koobiq_components_core.KbqLocaleService | null;
-    readonly externalConfiguration: {
-        reset: {
-            buttonName: string;
-        };
-        search: {
-            tooltip: string;
-            placeholder: string;
-        };
-        filters: {
-            defaultName: string;
-            saveNewFilterTooltip: string;
-            searchPlaceholder: string;
-            searchEmptyResult: string;
-            saveAsNewFilter: string;
-            saveChanges: string;
-            saveAsNew: string;
-            change: string;
-            resetChanges: string;
-            remove: string;
-            name: string;
-            error: string;
-            errorHint: string;
-            saveButton: string;
-            cancelButton: string;
-            actionsTooltip: string;
-        };
-        add: {
-            tooltip: string;
-            addedAnnouncement: string;
-        };
-        refresher: {
-            refresh: string;
-            settings: string;
-        };
-        pipe: {
-            clearButtonTooltip: string;
-            removeButtonTooltip: string;
-            applyButton: string;
-            emptySearchResult: string;
-            selectAll: string;
-        };
-        datePipe: {
-            customPeriod: string;
-            customPeriodFrom: string;
-            customPeriodTo: string;
-            customPeriodErrorHint: string;
-            customPeriodMinIntervalErrorHint: string;
-            customPeriodMaxIntervalErrorHint: string;
-            backToPeriodSelection: string;
-        };
-    } | null;
-    /** Localized strings and configuration for the filter-bar and its pipes. */
-    get configuration(): KbqFilterBarConfiguration;
-    set configuration(value: KbqFilterBarConfiguration);
-    private readonly _configuration;
+declare class KbqFilterBar implements KbqFilterBarHost, AfterContentInit {
+    /**
+     * Localized strings and configuration for the filter-bar and its pipes.
+     *
+     * Read through a signal so that a runtime `setLocale()` reaches the pipes and the projected
+     * sub-components, which render these strings from their own `OnPush` views.
+     */
+    readonly localeConfiguration: _angular_core.Signal<_koobiq_components_core.KbqFilterBarLocaleConfiguration>;
     /** @docs-private */
     readonly filters: _angular_core.Signal<KbqFilters | undefined>;
     /** @docs-private */
@@ -834,21 +552,46 @@ declare class KbqFilterBar implements KbqFilterBarHost {
     readonly isDisabled: _angular_core.Signal<boolean>;
     private savedFilter;
     /**
-     * All changes.
-     * @deprecated noop. Reactivity is driven by the `filter` signal now; this never emits and will be
-     * removed in the next major.
+     * Persistence of the selected filter and its edits, applied as a host directive. `useStateSaving` and
+     * `stateSavingKey` are its inputs, forwarded onto the filter bar.
      */
-    readonly changes: BehaviorSubject<void>;
+    private readonly stateSaving;
+    /** The payload read while initializing, held until the data it needs to be applied has arrived. */
+    private pendingState;
+    /** The filter that was selected when the payload was read, to tell a later change from that one. */
+    private filterWhenPending;
+    /** Whether the filter is being written by a restore, so the write below does not echo it back. */
+    private restoring;
+    /** Whether the persisted state has been read; reading twice would resurrect a dismissed filter. */
+    private hasRead;
     /** Event that emits whenever the filter is reset. */
     readonly onResetFilter: BehaviorSubject<boolean>;
     /** internal filter changes */
     readonly internalFilterChanges: BehaviorSubject<KbqFilter | null>;
     /** internal changes in templates */
     readonly internalTemplatesChanges: BehaviorSubject<KbqPipeTemplate[] | null>;
-    /** Requests that an already-added pipe open its pop-up. See {@link KbqFilterBarHost.openPipe}.
-     * @docs-private */
+    /**
+     * Requests that an already-added pipe open its pop-up. See {@link KbqFilterBarHost.openPipe}.
+     *
+     * @docs-private
+     */
     readonly openPipe: BehaviorSubject<string | number | null>;
     constructor();
+    ngAfterContentInit(): void;
+    /** Reads the persisted state and applies it. Runs while initializing, and again on a key change. */
+    private restoreState;
+    /**
+     * Removes the state persisted for this filter bar.
+     *
+     * Persistence itself stays on — the next change is written again. Unset `useStateSaving` to stop it.
+     * Unrelated to `restoreFilterState()`, which reverts to an in-memory snapshot within one session.
+     */
+    clearSavedState(): void;
+    /**
+     * Whether state is currently persisted for this filter bar — restored on init, or written since.
+     * Always `false` while `useStateSaving` is unset, and `false` again after `clearSavedState()`.
+     */
+    get hasSavedState(): boolean;
     /** Remove pipe from current filter and emit event */
     removePipe(pipe: KbqPipe): void;
     /**
@@ -860,25 +603,47 @@ declare class KbqFilterBar implements KbqFilterBarHost {
      */
     saveFilterState(filter?: KbqFilter): void;
     /**
-     * Restore previously saved filter state.
-     *
-     * @see `saveFilterState` — pipe `value` payloads must be structured-cloneable.
+     * Restore previously saved filter state. As with {@link saveFilterState}, pipe `value` payloads must be
+     * structured-cloneable.
      */
     restoreFilterState(filter?: KbqFilter): void;
     /** Set the filter state "changed" to false */
     resetFilterChangedState(): void;
-    private updateLocaleParams;
-    private initDefaultParams;
+    /** Whether this filter bar reads and writes its state at all. */
+    private get persists();
+    /**
+     * Persists which filter is selected and the edits made to it.
+     *
+     * A bar with nothing selected removes its entry rather than storing an empty filter: the next load
+     * should fall back to whatever default the application supplies, not to a filter with no name.
+     */
+    private persistState;
+    /**
+     * The filter a named payload is rebuilt over when no `<kbq-filters>` is projected.
+     *
+     * A name is looked up in the projected list, and not finding it there normally means the list has not
+     * arrived yet — applications load their saved filters from a server, and waiting is what lets a late
+     * one still restore. With no `<kbq-filters>` in the markup at all there is no list the name could ever
+     * appear in, so that wait would never end: the bar would write on every change and read nothing back.
+     * The filter the application already selected is the only base there will be, and it is the right one
+     * while it carries that same name.
+     */
+    private baseWithoutFilterList;
+    /**
+     * Rebuilds the persisted filter and selects it, or leaves the payload pending while what it needs is
+     * still missing.
+     */
+    private applyPendingState;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFilterBar, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFilterBar, "kbq-filter-bar, [kbq-filter-bar]", never, { "selectedAllEqualsSelectedNothing": { "alias": "selectedAllEqualsSelectedNothing"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "pipeTemplates": { "alias": "pipeTemplates"; "required": false; "isSignal": true; }; }, { "filter": "filterChange"; "onChangePipe": "onChangePipe"; "onRemovePipe": "onRemovePipe"; "onClearPipe": "onClearPipe"; "onClosePipe": "onClosePipe"; }, ["filters", "filterReset"], ["kbq-filters", "*", "kbq-pipe-add", "kbq-filter-reset", "kbq-search-expandable", "kbq-filter-refresher, [kbq-filter-refresher]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFilterBar, "kbq-filter-bar, [kbq-filter-bar]", never, { "selectedAllEqualsSelectedNothing": { "alias": "selectedAllEqualsSelectedNothing"; "required": false; "isSignal": true; }; "filter": { "alias": "filter"; "required": false; "isSignal": true; }; "pipeTemplates": { "alias": "pipeTemplates"; "required": false; "isSignal": true; }; }, { "filter": "filterChange"; "onChangePipe": "onChangePipe"; "onRemovePipe": "onRemovePipe"; "onClearPipe": "onClearPipe"; "onClosePipe": "onClosePipe"; }, ["filters", "filterReset"], ["kbq-filters", "*", "kbq-pipe-add", "kbq-filter-reset", "kbq-search-expandable", "kbq-filter-refresher, [kbq-filter-refresher]"], true, [{ directive: typeof _koobiq_components_core.KbqStateSaving; inputs: { "useStateSaving": "useStateSaving"; "stateSavingKey": "stateSavingKey"; }; outputs: {}; }, { directive: typeof _koobiq_components_core.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
 }
 
 declare class KbqFilterBarButton {
     private readonly button;
     /** KbqFilterBar host seam */
     private readonly filterBar;
-    /** KbqFilters instance */
-    protected readonly filters: KbqFilters;
+    /** KbqFilters host seam */
+    private readonly filters;
     constructor();
     /** @docs-private */
     saveFocusedElement(): void;
@@ -886,69 +651,184 @@ declare class KbqFilterBarButton {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqFilterBarButton, "[kbqFilterBarButton]", never, {}, {}, never, never, true, never>;
 }
 
+/** Injection Token for providing configuration of filter-bar */
+declare const KBQ_PIPE_DATA: InjectionToken<unknown>;
+/** function to get unique identifier of an element */
+declare function getId(item: KbqPipeTemplate): KbqPipeType | string | number;
+declare abstract class KbqBasePipe<V> implements AfterViewInit {
+    /** changes of state */
+    readonly stateChanges: Subject<void>;
+    /** pipe data. Provided from subclass */
+    readonly data: KbqPipeData<V>;
+    /**
+     * KbqFilterBar instance
+     *
+     * @docs-private
+     */
+    protected readonly filterBar: _koobiq_components_filter_bar.KbqFilterBarHost | null;
+    /** @docs-private */
+    protected readonly changeDetectorRef: ChangeDetectorRef;
+    /** @docs-private */
+    protected readonly destroyRef: DestroyRef;
+    /** @docs-private */
+    protected readonly focusMonitor: FocusMonitor;
+    /** @docs-private */
+    protected readonly elementRef: ElementRef<HTMLElement>;
+    private readonly inputModalityDetector;
+    private readonly document;
+    /**
+     * Whether this pipe has been destroyed. Guards deferred (`setTimeout`) work that could otherwise
+     * read view queries or mutate `data` after the pipe was removed or the filter switched.
+     *
+     * @docs-private
+     */
+    protected destroyed: boolean;
+    /** values to select from the pipe template */
+    protected values: any;
+    /** TemplateRef for selecting an option */
+    protected valueTemplate?: TemplateRef<any> | string;
+    /**
+     * Optional equality comparator forwarded from the pipe template to the underlying `kbq-select`.
+     * Only consumed by the select / multi-select pipe components; when unset they fall back to their
+     * own id-based `compareByValue`.
+     */
+    protected optionCompareWith?: (o1: KbqSelectValue | null | undefined, o2: KbqSelectValue | null | undefined) => boolean;
+    /**
+     * Values forwarded from the pipe template whose selection the user cannot remove. Only consumed by
+     * the multi-select pipe components; other pipe types ignore it.
+     */
+    protected lockedValues?: unknown[];
+    /**
+     * Maximum height of the dropdown panel's scrollable list, forwarded from the pipe template to the
+     * underlying `kbq-select` / `kbq-tree-select`. Only consumed by the select-family pipe components;
+     * `undefined` leaves the list at the select-family default of 256px.
+     */
+    protected panelMaxHeight?: KbqPanelMaxHeight;
+    /**
+     * Whether the dropdown's option names and captions wrap instead of being truncated, forwarded from
+     * the pipe template. Only consumed by the select / multi-select pipe components.
+     */
+    protected multilineOptions?: boolean;
+    /**
+     * Message shown in place of the options when the pipe template has none, forwarded from the pipe
+     * template. Only consumed by the select-family pipe components; `undefined` falls back to the localized
+     * `pipe.noOptions` string.
+     */
+    protected noOptionsText?: string;
+    /**
+     * Whether the current platform is a Mac.
+     *
+     * @docs-private
+     */
+    isMac: boolean;
+    /**
+     * Data for the pipe.
+     *
+     * @docs-private
+     */
+    $implicit: unknown;
+    /** Whether the current pipe is empty. Used for apply style modifier */
+    get isEmpty(): boolean;
+    /** Whether the current pipe is removable or cleanable. Used for apply style modifier */
+    get showRemoveButton(): boolean;
+    /**
+     * Whether the pipe template provides no values to choose from. The select-family pipe components then
+     * show `noOptionsMessage` instead of the list; the date pipes open straight on the custom period.
+     */
+    protected get noOptions(): boolean;
+    /** Message the select-family pipe components show when there are no options. */
+    protected get noOptionsMessage(): string;
+    /**
+     * Localized strings of the filter-bar, falling back to the defaults outside a bar.
+     *
+     * @docs-private
+     */
+    readonly localeConfiguration: _angular_core.Signal<KbqFilterBarLocaleConfiguration>;
+    constructor();
+    ngAfterViewInit(): void;
+    /** templateRef checker utility */
+    isTemplateRef(value: unknown): boolean;
+    /** updates values for selection and value template */
+    updateTemplates: (templates: KbqPipeTemplate[] | null) => void;
+    /** removes pipe from filter-bar and triggers changes */
+    onRemove(): void;
+    /** clears the pipe and triggers changes */
+    onClear(): void;
+    /**
+     * Value a cleared pipe is left with. Overridden by pipes that keep part of their value across a clear
+     * — the multi-select pipes hold on to their locked options.
+     *
+     * @docs-private
+     */
+    protected clearedValue(): V | null;
+    /**
+     * Focus origin to hand to {@link FocusMonitor} whenever this pipe moves focus programmatically, so the
+     * `.cdk-keyboard-focused` ring is painted for keyboard navigation only and never for a mouse-driven one.
+     *
+     * `InputModalityDetector.mostRecentModality` reflects what the user is doing *right now*, and is the
+     * only source that stays correct while a panel is open: panel content lives in the CDK overlay
+     * container, which is not a DOM descendant of the pipe host, so a focus origin captured on the host
+     * itself would freeze at "how the trigger was focused" and couldn't tell a click inside the panel apart
+     * from the keypress that opened it. The detector reacts only to `keydown`/`mousedown`/`touchstart`
+     * (never to hover or scroll), so merely moving the mouse cannot strip a keyboard user's ring, and it
+     * maps a screen reader's synthetic mousedown to `keyboard`. It falls back to `'program'` only before any
+     * such interaction has ever occurred on the page — at which point no ring should be shown anyway.
+     *
+     * @docs-private
+     */
+    protected get currentFocusOrigin(): NonNullable<FocusOrigin>;
+    /**
+     * Restores focus to the pipe's trigger button after a value is chosen or the panel closes.
+     * Focuses via {@link FocusMonitor} with `currentFocusOrigin` so a keyboard-driven interaction keeps
+     * its focus ring, while a mouse-driven one does not.
+     *
+     * @docs-private
+     */
+    protected restoreTriggerFocus(): void;
+    /**
+     * Focuses the pipe's trigger button with `currentFocusOrigin`, unconditionally.
+     *
+     * @docs-private
+     */
+    protected focusTrigger(): void;
+    /**
+     * Every pipe opens untracked: called from a consumer's `effect()`, the state read on the way would make the
+     * effect run again on every open and close.
+     *
+     * @docs-private
+     */
+    abstract open(): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqBasePipe<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqBasePipe<any>, never, never, {}, {}, never, never, true, never>;
+}
+
+/** list of pipes available out of the box. */
+declare const defaultFilterBarPipes: [KbqPipeType, Type<KbqBasePipe<unknown>>][];
+/**
+ * Injection Token for providing pipes in filter-bar. Defaults to {@link defaultFilterBarPipes} so the
+ * standalone `KbqFilterBar` works without `KbqFilterBarModule`; override it with
+ * {@link kbqFilterBarPipesProvider} or a provider of your own.
+ */
+declare const KBQ_FILTER_BAR_PIPES: InjectionToken<Map<KbqPipeType, Type<KbqBasePipe<unknown>>>>;
+/** Utility provider for `KBQ_FILTER_BAR_PIPES`. */
+declare const kbqFilterBarPipesProvider: () => Provider;
+
 declare class KbqFilterRefresher {
     /** KbqFilterBar host seam */
     private readonly filterBar;
-    /** localized data
-     * @docs-private */
-    protected get localeData(): {
-        reset: {
-            buttonName: string;
-        };
-        search: {
-            tooltip: string;
-            placeholder: string;
-        };
-        filters: {
-            defaultName: string;
-            saveNewFilterTooltip: string;
-            searchPlaceholder: string;
-            searchEmptyResult: string;
-            saveAsNewFilter: string;
-            saveChanges: string;
-            saveAsNew: string;
-            change: string;
-            resetChanges: string;
-            remove: string;
-            name: string;
-            error: string;
-            errorHint: string;
-            saveButton: string;
-            cancelButton: string;
-            actionsTooltip: string;
-        };
-        add: {
-            tooltip: string;
-            addedAnnouncement: string;
-        };
-        refresher: {
-            refresh: string;
-            settings: string;
-        };
-        pipe: {
-            clearButtonTooltip: string;
-            removeButtonTooltip: string;
-            applyButton: string;
-            emptySearchResult: string;
-            selectAll: string;
-        };
-        datePipe: {
-            customPeriod: string;
-            customPeriodFrom: string;
-            customPeriodTo: string;
-            customPeriodErrorHint: string;
-            customPeriodMinIntervalErrorHint: string;
-            customPeriodMaxIntervalErrorHint: string;
-            backToPeriodSelection: string;
-        };
-    };
+    /**
+     * Localized strings of the filter-bar, falling back to the defaults outside a bar.
+     *
+     * @docs-private
+     */
+    protected readonly localeConfiguration: _angular_core.Signal<_koobiq_components_core.KbqFilterBarLocaleConfiguration>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqFilterRefresher, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqFilterRefresher, "kbq-filter-refresher, [kbq-filter-refresher]", never, {}, {}, never, never, true, never>;
 }
 
 declare class KbqPipeAdd {
     /** KbqFilterBar instance */
-    protected readonly filterBar: KbqFilterBarHost;
+    protected readonly filterBar: _koobiq_components_filter_bar.KbqFilterBarHost;
     /** @docs-private */
     readonly select: _angular_core.Signal<KbqSelect>;
     /** Event that is generated after add pipe. */
@@ -962,6 +842,7 @@ declare class KbqPipeAdd {
     readonly addedPipes: _angular_core.Signal<(string | number | (string & {}))[]>;
     /**
      * Visually-hidden live-region text announcing a newly-added pipe to assistive tech (WCAG 4.1.3).
+     *
      * @docs-private
      */
     protected readonly announcement: _angular_core.WritableSignal<string>;
@@ -991,32 +872,28 @@ declare class KbqPipeButton {
     /** KbqPipe instance */
     protected readonly pipe: KbqBasePipe<any>;
     /** KbqFilterBar instance */
-    protected readonly filterBar: KbqFilterBarHost;
+    protected readonly filterBar: _koobiq_components_filter_bar.KbqFilterBarHost;
     /** @docs-private */
     protected readonly changeDetectorRef: ChangeDetectorRef;
     /** enables/disables read-only state */
     readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** localized data
-     * @docs-private */
-    get localeData(): {
-        clearButtonTooltip: string;
-        removeButtonTooltip: string;
-        applyButton: string;
-        emptySearchResult: string;
-        selectAll: string;
-    };
+    /**
+     * Localized strings of the filter-bar.
+     *
+     * @docs-private
+     */
+    protected readonly localeConfiguration: _angular_core.Signal<_koobiq_components_core.KbqFilterBarLocaleConfiguration>;
     constructor();
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqPipeButton, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqPipeButton, "kbq-pipe-button", never, { "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class KbqPipeState<T> {
-    /** @docs-private */
     private readonly button;
-    /** @docs-private */
     private readonly pipe;
-    /** KbqFilterBar instance
-     * @docs-private */
+    /**
+     * KbqFilterBar instance
+     */
     private readonly filterBar;
     /**
      * Pipe state the styled button belongs to.
@@ -1054,20 +931,34 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
     /** @docs-private */
     protected readonly colors: typeof KbqComponentColors;
     /** Whether the current state is list of periods. When false will displayed control for set custom period */
-    protected isListMode: boolean;
+    protected readonly isListMode: _angular_core.WritableSignal<boolean>;
     /** @docs-private */
     protected formGroup: FormGroup;
     /** @docs-private */
-    protected showStartCalendar: boolean;
+    protected readonly showStartCalendar: _angular_core.WritableSignal<boolean>;
     /** @docs-private */
-    protected showEndCalendar: boolean;
+    protected readonly showEndCalendar: _angular_core.WritableSignal<boolean>;
+    /**
+     * Id of the "From" label, which names the start inputs.
+     *
+     * @docs-private
+     */
+    protected readonly fromLabelId: string;
+    /**
+     * Id of the "To" label, which names the end inputs.
+     *
+     * @docs-private
+     */
+    protected readonly toLabelId: string;
     /**
      * Lower bound instant applied to the calendars, date inputs and (datetime) timepickers.
+     *
      * @docs-private
      */
     protected min: any;
     /**
      * Upper bound instant applied to the calendars, date inputs and (datetime) timepickers.
+     *
      * @docs-private
      */
     protected max: any;
@@ -1082,7 +973,8 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
     /** @docs-private */
     readonly listSelection: _angular_core.Signal<KbqListSelection<any> | undefined>;
     /** @docs-private */
-    readonly returnButton: _angular_core.Signal<KbqButton>;
+    readonly returnButton: _angular_core.Signal<KbqButton | undefined>;
+    private readonly periodStartInput;
     /** Resolves the `minDateTime` / `maxDateTime` bounds from the pipe template matching this pipe. */
     private updateDateBounds;
     /**
@@ -1098,6 +990,12 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
      * would otherwise disable the constraint without any error (e.g. a `{ days: 5 }` typo'd as `5`).
      */
     private toValidInterval;
+    /**
+     * Resolves the relative `start` of a preset (a duration-like object such as `{ days: -7 }`) against today.
+     * Anything else — a date instance, an ISO string left without its `end` — yields `undefined`, so the
+     * defaults apply instead of `plus()` throwing.
+     */
+    private toRelativeStart;
     /** Clamps `value` into the configured `[min, max]` bounds using full-instant comparison. */
     private clampToBounds;
     /**
@@ -1131,6 +1029,7 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
     private computeDefaultRange;
     /**
      * Upper bound for the START date input: the earlier of the END value and the configured `max`.
+     *
      * @docs-private
      */
     get startMax(): any;
@@ -1143,24 +1042,30 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
      * `[min, max]` (`kbqDatepickerMin`/`kbqDatepickerMax`, `kbqTimepickerLowerThenMin`/
      * `kbqTimepickerHigherThenMax`) or unparseable typed text (`kbqDatepickerParse`/`kbqTimepickerParse`)
      * — is left to the field's own error styling instead of being mislabelled as an ordering problem.
+     *
      * @docs-private
      */
     protected get isPeriodInverted(): boolean;
     /**
      * Localized "period too short" hint with the `minInterval` limit interpolated and locale-formatted.
+     *
      * @docs-private
      */
     get minIntervalErrorHint(): string;
     /**
      * Localized "period too long" hint with the `maxInterval` limit interpolated and locale-formatted.
+     *
      * @docs-private
      */
     get maxIntervalErrorHint(): string;
     /** Whether the current pipe is empty. */
     get isEmpty(): boolean;
     ngAfterViewInit(): void;
-    /** keydown handler
-     * @docs-private */
+    /**
+     * keydown handler
+     *
+     * @docs-private
+     */
     onKeydown($event: KeyboardEvent): void;
     onApplyPeriod(): void;
     onSelect(item: KbqDateTimeValue): void;
@@ -1173,6 +1078,12 @@ declare abstract class KbqPipeDateBaseComponent<D> extends KbqBasePipe<KbqDateTi
     onFocusStartInput(): void;
     onFocusEndInput(): void;
     hideCalendars(): void;
+    /**
+     * Hides the calendars before the browser moves focus on Tab or Shift+Tab out of a date input.
+     *
+     * @docs-private
+     */
+    protected onDateInputTab(): void;
     /**
      * Whether this pipe edits the time part (`datetime`) or only the date (`date`). Gates whether the
      * `minDateTime` / `maxDateTime` bounds keep their time or are pinned to day edges.
@@ -1248,12 +1159,15 @@ declare class KbqPipeInputComponent extends KbqBasePipe<string | null> implement
 declare class KbqPipeMultiSelectComponent extends KbqBasePipe<KbqSelectValue[]> implements AfterViewInit, OnInit {
     /** control for search options */
     readonly searchControl: FormControl<string | null>;
-    /** filtered by search options */
-    filteredOptions: Observable<KbqSelectValue[]>;
+    /**
+     * Options of the pipe template that match the search query. Follows the templates too, so options
+     * supplied after initialization render on first open.
+     */
+    readonly filteredOptions: Signal<KbqSelectValue[]>;
     /** @docs-private */
-    readonly select: _angular_core.Signal<KbqSelect>;
+    readonly select: Signal<KbqSelect>;
     /** @docs-private */
-    readonly options: _angular_core.Signal<readonly KbqOption[]>;
+    readonly options: Signal<readonly KbqOption[]>;
     /** selected value */
     get selected(): KbqSelectValue[] | null;
     /** Whether the current pipe is empty. */
@@ -1318,7 +1232,7 @@ declare abstract class KbqTreeSelectPipeBase<V> extends KbqBasePipe<V> implement
     treeFlattener: KbqTreeFlattener<KbqTreeSelectNode, KbqTreeSelectFlatNode>;
     dataSource: KbqTreeFlatDataSource<KbqTreeSelectNode, KbqTreeSelectFlatNode>;
     /** @docs-private */
-    readonly select: _angular_core.Signal<KbqTreeSelect>;
+    readonly select: _angular_core.Signal<KbqTreeSelect<KbqTreeSelectFlatNode>>;
     constructor();
     ngOnInit(): void;
     ngAfterViewInit(): void;
@@ -1340,7 +1254,7 @@ declare abstract class KbqTreeSelectPipeBase<V> extends KbqBasePipe<V> implement
 
 declare class KbqPipeMultiTreeSelectComponent extends KbqTreeSelectPipeBase<KbqSelectValue[]> implements OnInit {
     /** @docs-private */
-    readonly tree: _angular_core.Signal<KbqTreeSelection>;
+    readonly tree: _angular_core.Signal<KbqTreeSelection<KbqTreeSelectFlatNode>>;
     /** selected value */
     get selected(): KbqSelectValue[] | null;
     /** Whether the current pipe is empty. */
@@ -1408,19 +1322,20 @@ declare class KbqPipeReadonlyComponent extends KbqBasePipe<string | null> {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqPipeReadonlyComponent, "kbq-pipe-readonly", never, {}, {}, never, never, true, never>;
 }
 
-declare class KbqPipeSelectComponent extends KbqBasePipe<KbqSelectValue> implements AfterViewInit, OnInit {
+declare class KbqPipeSelectComponent extends KbqBasePipe<KbqSelectValue> implements AfterViewInit {
     /** control for search options */
     readonly searchControl: FormControl<string | null>;
-    /** filtered by search options */
-    filteredOptions: Observable<KbqSelectValue[]>;
+    /**
+     * Options of the pipe template that match the search query. Follows the templates too, so options
+     * supplied after initialization render on first open.
+     */
+    readonly filteredOptions: Signal<KbqSelectValue[]>;
     /** @docs-private */
-    readonly select: _angular_core.Signal<KbqSelect>;
+    readonly select: Signal<KbqSelect>;
     /** selected value */
     get selected(): KbqSelectValue | null;
     /** Whether the current pipe is empty. */
     get isEmpty(): boolean;
-    /** @docs-private */
-    ngOnInit(): void;
     ngAfterViewInit(): void;
     onSelect(item: KbqSelectValue): void;
     /** Comparator of selected options */
@@ -1470,5 +1385,5 @@ declare class KbqPipeTreeSelectComponent extends KbqTreeSelectPipeBase<KbqSelect
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqPipeTreeSelectComponent, "kbq-pipe-tree-select", never, {}, {}, never, never, true, never>;
 }
 
-export { KBQ_FILTER_BAR_CONFIGURATION, KBQ_FILTER_BAR_DEFAULT_CONFIGURATION, KBQ_FILTER_BAR_HOST, KBQ_FILTER_BAR_PIPES, KBQ_PIPE_DATA, KbqBasePipe, KbqFilterBar, KbqFilterBarButton, KbqFilterBarModule, KbqFilterRefresher as KbqFilterBarRefresher, KbqFilterRefresher, KbqFilterReset, KbqFilterSavePopover, KbqFilters, KbqPipeAdd, KbqPipeButton, KbqPipeDateBaseComponent, KbqPipeDateComponent, KbqPipeDatetimeComponent, KbqPipeDirective, KbqPipeInputComponent, KbqPipeMinWidth, KbqPipeMultiSelectComponent, KbqPipeMultiTreeSelectComponent, KbqPipeReadonlyComponent, KbqPipeSelectComponent, KbqPipeState, KbqPipeTextComponent, KbqPipeTreeSelectComponent, KbqPipeTypes, KbqSaveFilterStatuses, KbqTreeSelectFlatNode, KbqTreeSelectPipeBase, defaultFilterBarPipes, getId, kbqBuildTree, kbqFilterBarPipesProvider };
-export type { KbqDateTimeValue, KbqFilter, KbqFilterBarConfiguration, KbqFilterBarHost, KbqPipe, KbqPipeData, KbqPipeTemplate, KbqPipeType, KbqSaveFilterError, KbqSaveFilterEvent, KbqSelectValue, KbqTreeSelectNode };
+export { KBQ_FILTERS, KBQ_FILTER_BAR_CONFIGURATION, KBQ_FILTER_BAR_DEFAULT_CONFIGURATION, KBQ_FILTER_BAR_DEFAULT_LOCALE_CONFIGURATION, KBQ_FILTER_BAR_HOST, KBQ_FILTER_BAR_LOCALE_CONFIGURATION, KBQ_FILTER_BAR_PIPES, KBQ_PIPE_DATA, KbqBasePipe, KbqFilterBar, KbqFilterBarButton, KbqFilterBarModule, KbqFilterRefresher, KbqFilterReset, KbqFilterSavePopover, KbqFilters, KbqPipeAdd, KbqPipeButton, KbqPipeDateBaseComponent, KbqPipeDateComponent, KbqPipeDatetimeComponent, KbqPipeDirective, KbqPipeInputComponent, KbqPipeMultiSelectComponent, KbqPipeMultiTreeSelectComponent, KbqPipeReadonlyComponent, KbqPipeSelectComponent, KbqPipeState, KbqPipeTextComponent, KbqPipeTreeSelectComponent, KbqPipeTypes, KbqSaveFilterStatuses, KbqTreeSelectFlatNode, KbqTreeSelectPipeBase, defaultFilterBarPipes, getId, kbqBuildTree, kbqFilterBarLocaleConfigurationProvider, kbqFilterBarPipesProvider };
+export type { KbqDateTimeValue, KbqFilter, KbqFilterBarHost, KbqFilterBarPipeState, KbqFilterBarState, KbqFiltersHost, KbqPipe, KbqPipeData, KbqPipeTemplate, KbqPipeType, KbqSaveFilterError, KbqSaveFilterEvent, KbqSelectValue, KbqTreeSelectNode };