@koobiq/components 20.2.0 → 20.3.0

package/tags/index.d.ts

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { OnDestroy, AfterContentInit, AfterViewInit, ChangeDetectorRef, ElementRef, DoCheck, QueryList, OnChanges, InjectionToken } from '@angular/core';
+import { Signal, OnDestroy, AfterContentInit, AfterViewInit, ChangeDetectorRef, ElementRef, DoCheck, QueryList, InjectionToken, OnChanges, Provider } from '@angular/core';
 import { NgControl, ControlValueAccessor, NgForm, FormGroupDirective } from '@angular/forms';
 import { KbqAutocompleteTrigger } from '@koobiq/components/autocomplete';
 import * as i2 from '@angular/cdk/drag-drop';
@@ -12,14 +12,23 @@ import { FocusOrigin } from '@angular/cdk/a11y';
 import { KbqIcon } from '@koobiq/components/icon';
 import * as i1$1 from '@angular/cdk/platform';
 
-/** Interface for a text control that is used to drive interaction with a kbq-tag-list. */
-
+/**
+ * Interface for a text control that is used to drive interaction with a kbq-tag-list.
+ *
+ * @docs-private
+ */
 interface KbqTagTextControl {
     id: string;
     placeholder: string;
     focused: boolean;
     empty: boolean;
-    ngControl?: NgControl;
+    /** Whether the control's value was filled in by the browser. */
+    autofilled?: Signal<boolean>;
+    /**
+     * @deprecated Unused by the library: validation lives on the `<kbq-tag-list>` control.
+     * Will be removed in a future major release.
+     */
+    ngControl?: NgControl | null;
     focus(): void;
 }
 
@@ -389,6 +398,13 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     private _placeholder;
     /** Whether any tags or the kbqTagInput inside of this tag-list has focus. */
     get focused(): boolean;
+    /**
+     * Implemented as part of KbqFormFieldControl. Forwarded from the registered `kbqTagInput`, which
+     * is the element the browser actually autofills — the tag list itself is not an input.
+     *
+     * @docs-private
+     */
+    readonly autofilled: _angular_core.Signal<boolean>;
     /**
      * Implemented as part of KbqFormFieldControl.
      * @docs-private
@@ -469,8 +485,15 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     errorState: boolean;
     /** The tag input to add more tags */
     private tagInput;
+    /**
+     * The same control as `tagInput`, kept in a signal so `autofilled` can track it reactively —
+     * `registerInput()` runs after the first read.
+     */
+    private readonly registeredInput;
     /** True when the next `tags.changes` emission is triggered by a UI action, not programmatic update. */
     private pendingUIChange;
+    /** Shared range selection state used by pointer and keyboard interactions. */
+    private rangeSelection;
     /**
      * When a tag is destroyed, we store the index of the destroyed tag until the tags
      * query list notifies about the update. This is necessary because we cannot determine an
@@ -530,6 +553,12 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * @docs-private
      */
     focusInput(): void;
+    /**
+     * Establishes a range origin or extends the current range to the specified tag.
+     *
+     * @docs-private
+     */
+    handleSelectionInteraction(tag: KbqTag, extendRange: boolean): void;
     /**
      * Pass events to the keyboard manager. Available here for tests.
      *
@@ -576,6 +605,8 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * @docs-private
      */
     removeSelected(): void;
+    /** Whether the rendered tags no longer match the value this control last reported. */
+    private hasTagsValueChanged;
     private propagateTagsChanges;
     private resetTags;
     /** Listens to user-generated selection events on each tag. */
@@ -588,6 +619,8 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     private setupDropListInitialProperties;
     private syncDropListDisabledState;
     private setupFocusMonitor;
+    private extendSelectionTo;
+    private setRangeOrigin;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagList, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTagList, "kbq-tag-list", ["kbqTagList"], { "value": { "alias": "value"; "required": false; }; "required": { "alias": "required"; "required": false; }; "placeholder": { "alias": "placeholder"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; "draggable": { "alias": "draggable"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; }; }, { "dropped": "dropped"; "valueChange": "valueChange"; "change": "change"; }, ["cleaner", "tags"], ["*", "kbq-cleaner"], true, [{ directive: typeof i2.CdkDropList; inputs: {}; outputs: {}; }]>;
     static ngAcceptInputType_disabled: unknown;
@@ -602,10 +635,42 @@ interface KbqTagInputEvent {
     /** The value of the input. */
     value: string;
 }
+/** Contexts a `KbqTagSeparator` can be active in. */
+type KbqTagSeparatorContext = 'input' | 'paste';
+/** Defines a character or pattern that ends a tag, and the contexts in which it applies. */
 interface KbqTagSeparator {
+    /** Regular expression used to match/split this separator in text. */
     symbol: RegExp;
-    key: string;
+    /**
+     * `KeyboardEvent.key` that triggers this separator while typing.
+     * Omit for separators with no single-keystroke equivalent (e.g. a run of whitespace) —
+     * those are implicitly paste-only, since they can never match a `keydown`.
+     */
+    key?: string;
+    /**
+     * Numeric key code gating whether this separator is enabled, set via `kbqTagInputSeparatorKeyCodes`.
+     * Omit together with `key` for separators that should always be active regardless of that input.
+     */
+    keyCode?: number;
+    /**
+     * Contexts this separator applies to.
+     * @default ['input', 'paste']
+     */
+    appliesTo?: KbqTagSeparatorContext[];
+}
+/** Default options for the tags module that can be overridden. */
+interface KbqTagsDefaultOptions {
+    /** The list of key codes that will trigger a tagEnd event. */
+    separatorKeyCodes: number[];
+    /** Custom separator definitions to use instead of the built-in defaults. */
+    separators?: KbqTagSeparator[];
+    /** Whether the tagEnd event will be emitted when text is pasted. */
+    addOnPaste?: boolean;
 }
+/** Injection token to be used to override the default options. */
+declare const KBQ_TAGS_DEFAULT_OPTIONS: InjectionToken<KbqTagsDefaultOptions>;
+/** Utility provider for `KBQ_TAGS_DEFAULT_OPTIONS`. */
+declare const kbqTagsDefaultOptionsProvider: (options: Partial<KbqTagsDefaultOptions>) => Provider;
 /**
  * Directive that adds tag-specific behaviors to an input element inside `<kbq-form-field>`.
  * May be placed inside or outside of an `<kbq-tag-list>`.
@@ -614,10 +679,28 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
     private elementRef;
     private defaultOptions;
     private trimDirective;
-    ngControl: NgControl;
+    /**
+     * The form control instance bound to the input, if any.
+     *
+     * @deprecated Read only, and unused by the library: validation lives on the `<kbq-tag-list>`
+     * control. Binding `[formControl]`/`[ngModel]` to the input itself stays supported — it is what
+     * `kbqAutocomplete` drives the input through — only its validators are not consulted.
+     * Will be removed in a future major release.
+     * @docs-private
+     */
+    ngControl: NgControl | null;
+    /**
+     * The autocomplete trigger attached to the input, if any.
+     * @docs-private
+     */
     autocompleteTrigger?: KbqAutocompleteTrigger | null | undefined;
-    /** Whether the control is focused. */
+    /**
+     * Whether the control is focused.
+     * @docs-private
+     */
     focused: boolean;
+    /** Whether the control's value was filled in by the browser. */
+    readonly autofilled: _angular_core.Signal<boolean>;
     /**
      * The list of key codes that will trigger a tagEnd event.
      *
@@ -625,7 +708,12 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
      */
     set separatorKeyCodes(value: number[]);
     private _separatorKeyCodes;
-    /** @docs-private */
+    /**
+     * The effective set of separators: entries gated by `keyCode` are included only when that
+     * code is present in `separatorKeyCodes`; entries without a `keyCode` (no single-keystroke
+     * equivalent, e.g. a run of whitespace) are always included.
+     * @docs-private
+     */
     get separators(): KbqTagSeparator[];
     private _separators;
     /** Emitted when a tag is to be added. */
@@ -662,45 +750,56 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
     ngOnChanges(): void;
     /** @docs-private */
     onKeydown(event: KeyboardEvent): void;
-    /** Checks to see if the blur should emit the (tagEnd) event. */
+    /**
+     * Checks to see if the blur should emit the (tagEnd) event.
+     * @docs-private
+     */
     blur(event: FocusEvent): void;
+    /**
+     * @deprecated No-op. Validation belongs to the `<kbq-tag-list>` form control, which
+     * revalidates itself whenever its value changes. Will be removed in a future major release.
+     * @docs-private
+     */
     triggerValidation(): void;
-    /** Checks to see if the (tagEnd) event needs to be emitted. */
+    /**
+     * Checks to see if the (tagEnd) event needs to be emitted.
+     * @docs-private
+     */
     emitTagEnd(): void;
+    /**
+     * Whether the current input value duplicates an existing tag.
+     * @docs-private
+     */
     get hasDuplicates(): boolean;
+    /** @docs-private */
     onInput(): void;
+    /** @docs-private */
     onPaste($event: ClipboardEvent): void;
     /** @docs-private */
     onFocus(): void;
     /** Focuses the input. */
     focus(): void;
-    private getSeparatorsForString;
+    private getPasteSeparatorPatterns;
+    /**
+     * Single path for adding a tag, shared by typed input, blur and paste.
+     * `existingValues` is `null` unless `distinct` is on, and is mutated as values are accepted.
+     */
+    private addTag;
+    /** Values to dedupe against, or `null` when duplicates are allowed. */
+    private existingTagValues;
+    private tagValues;
     private trimValue;
-    private getSeparatorByKeyCode;
-    private hasControl;
-    /** Checks whether a keycode is one of the configured separators. */
-    private isSeparatorKey;
+    /** Checks whether a keydown event matches a separator that applies to typed input. */
+    private matchesInputSeparator;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagInput, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagInput, "input[kbqTagInputFor]", ["kbqTagInput", "kbqTagInputFor"], { "separatorKeyCodes": { "alias": "kbqTagInputSeparatorKeyCodes"; "required": false; }; "distinct": { "alias": "distinct"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; }; "id": { "alias": "id"; "required": false; }; "tagList": { "alias": "kbqTagInputFor"; "required": false; }; "addOnBlur": { "alias": "kbqTagInputAddOnBlur"; "required": false; }; "addOnPaste": { "alias": "kbqTagInputAddOnPaste"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "tagEnd": "kbqTagInputTokenEnd"; }, never, never, true, [{ directive: typeof i1.KbqFieldSizingContent; inputs: {}; outputs: {}; }]>;
 }
 
-/** Default options, for the chips module, that can be overridden. */
-interface KbqTagsDefaultOptions {
-    /** The list of key codes that will trigger a chipEnd event. */
-    separatorKeyCodes: number[];
-    separators?: {
-        [key: number]: KbqTagSeparator;
-    };
-    addOnPaste?: boolean;
-}
-/** Injection token to be used to override the default options for the chips module. */
-declare const KBQ_TAGS_DEFAULT_OPTIONS: InjectionToken<KbqTagsDefaultOptions>;
-
 declare class KbqTagsModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagsModule, never>;
     static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqTagsModule, never, [typeof i1$1.PlatformModule, typeof KbqTagEditSubmit, typeof KbqTagEditInput, typeof KbqTagList, typeof KbqTag, typeof KbqTagInput, typeof KbqTagTrailingIcon, typeof KbqTagAvatar, typeof KbqTagRemove], [typeof KbqTagList, typeof KbqTag, typeof KbqTagInput, typeof KbqTagTrailingIcon, typeof KbqTagAvatar, typeof KbqTagRemove, typeof KbqTagEditSubmit, typeof KbqTagEditInput]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqTagsModule>;
 }
 
-export { KBQ_TAGS_DEFAULT_OPTIONS, KbqTag, KbqTagAvatar, KbqTagEditChange, KbqTagEditInput, KbqTagEditSubmit, KbqTagInput, KbqTagList, KbqTagListChange, KbqTagRemove, KbqTagSelectionChange, KbqTagTrailingIcon, KbqTagsModule };
-export type { KbqTagDragData, KbqTagEvent, KbqTagFocusEvent, KbqTagInputEvent, KbqTagListDroppedEvent, KbqTagSeparator, KbqTagsDefaultOptions };
+export { KBQ_TAGS_DEFAULT_OPTIONS, KbqTag, KbqTagAvatar, KbqTagEditChange, KbqTagEditInput, KbqTagEditSubmit, KbqTagInput, KbqTagList, KbqTagListChange, KbqTagRemove, KbqTagSelectionChange, KbqTagTrailingIcon, KbqTagsModule, kbqTagsDefaultOptionsProvider };
+export type { KbqTagDragData, KbqTagEvent, KbqTagFocusEvent, KbqTagInputEvent, KbqTagListDroppedEvent, KbqTagSeparator, KbqTagSeparatorContext, KbqTagsDefaultOptions };

package/textarea/index.d.ts

@@ -38,6 +38,11 @@ declare class KbqTextarea implements KbqFormFieldControl<any>, OnInit, OnChanges
      * @docs-private
      */
     focused: boolean;
+    /**
+     * Implemented as part of KbqFormFieldControl.
+     * @docs-private
+     */
+    readonly autofilled: i0.Signal<boolean>;
     /**
      * Implemented as part of KbqFormFieldControl.
      * @docs-private

package/time-range/index.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_core from '@angular/core';
 import { InjectionToken, OnInit, TemplateRef, WritableSignal, Provider, Injector } from '@angular/core';
 import { ValidatorFn, ControlValueAccessor, NgControl, FormControl, Validator, FormGroup, AbstractControl, FormGroupDirective, NgForm, ValidationErrors } from '@angular/forms';
-import { DateAdapter, DateFormatter, PopUpSizes, PopUpPlacements, KbqTimeRangeLocaleConfig, ErrorStateMatcher } from '@koobiq/components/core';
+import { DateAdapter, DateFormatter, KbqTimeRangeLocaleConfig, PopUpSizes, PopUpPlacements, ErrorStateMatcher } from '@koobiq/components/core';
 import { KbqPopoverTrigger } from '@koobiq/components/popover';
 import { DurationObjectUnits, DurationUnit } from '@koobiq/date-adapter';
 import { KbqTimepicker, TimeFormats } from '@koobiq/components/timepicker';

package/timepicker/index.d.ts

@@ -42,6 +42,7 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     private renderer;
     private dateAdapter;
     private localeService;
+    private readonly timezoneService;
     /**
      * Implemented as part of KbqFormFieldControl.
      * @docs-private
@@ -149,6 +150,8 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     private formatUserInput;
     private replaceSymbols;
     private replaceNumbers;
+    /** Clamps a time part to the allowed maximum and trims it to two digits */
+    private normalizeTimePart;
     /** Checks whether the input is invalid based on the native validation. */
     private isBadInput;
     private spaceKeyHandler;
@@ -174,6 +177,7 @@ declare class KbqTimepicker<D> implements KbqFormFieldControl<D>, ControlValueAc
     private maxValidator;
     private getValidDateOrNull;
     private setViewValue;
+    private setSelection;
     private updateView;
     /** @docs-private */
     updateErrorState(): void;

package/timezone/index.d.ts

@@ -33,13 +33,15 @@ interface KbqTimezonesByCountry {
 declare class KbqTimezoneOption extends KbqOption {
     readonly tooltipContentWrapper: i0.Signal<ElementRef<HTMLElement>>;
     readonly tooltipContent: i0.Signal<ElementRef<HTMLElement>>;
-    readonly highlightText: i0.InputSignal<string>;
+    readonly highlightText: i0.InputSignal<string | readonly string[]>;
+    /** Whether `highlightText` was matched with diacritic folding (e.g. via `createSearchPredicate`) — see `kbqHighlightBackground`. */
+    readonly foldDiacritics: i0.InputSignal<boolean>;
     get timezone(): KbqTimezoneZone;
     set timezone(zone: KbqTimezoneZone);
     private _timezone;
     get viewValue(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTimezoneOption, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<KbqTimezoneOption, "kbq-timezone-option", ["kbqTimezoneOption"], { "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; "timezone": { "alias": "timezone"; "required": false; }; }, {}, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<KbqTimezoneOption, "kbq-timezone-option", ["kbqTimezoneOption"], { "highlightText": { "alias": "highlightText"; "required": false; "isSignal": true; }; "foldDiacritics": { "alias": "foldDiacritics"; "required": false; "isSignal": true; }; "timezone": { "alias": "timezone"; "required": false; }; }, {}, never, never, true, never>;
 }
 
 declare const TOOLTIP_VISIBLE_ROWS_COUNT = 3;
@@ -84,7 +86,7 @@ declare class UtcOffsetPipe implements PipeTransform {
 }
 
 declare class CitiesByFilterPipe implements PipeTransform {
-    transform(value: string, searchPattern?: string): string;
+    transform(value: string, searchPattern?: string | readonly string[]): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<CitiesByFilterPipe, never>;
     static ɵpipe: i0.ɵɵPipeDeclaration<CitiesByFilterPipe, "citiesByFilter", true>;
 }
@@ -113,9 +115,11 @@ declare function offsetFormatterAsObject(value: string): {
  */
 declare function timezonesSortComparator(first: KbqTimezoneZone, second: KbqTimezoneZone): number;
 /**
- * Filtering timezone cities by search string
+ * Filtering timezone cities by search string. Accepts a single pattern or several (matching a
+ * city if it satisfies any one of them) — patterns that look like a bare UTC offset (e.g. `+3`)
+ * are ignored here, since they describe the zone rather than a city name.
  */
-declare function filterCitiesBySearchString(cities: string, searchPattern?: string): string;
+declare function filterCitiesBySearchString(cities: string, searchPattern?: string | readonly string[]): string;
 
 export { KbqTimezoneModule, KbqTimezoneOption, KbqTimezoneOptionTooltip, KbqTimezoneSelect, KbqTimezoneSelectTrigger, TOOLTIP_VISIBLE_ROWS_COUNT, filterCitiesBySearchString, getZonesGroupedByCountry, offset, offsetFormatter, offsetFormatterAsObject, parseOffset, timezonesSortComparator };
 export type { KbqTimezoneGroup, KbqTimezoneZone, KbqTimezonesByCountry };

package/toast/index.d.ts

@@ -1,8 +1,8 @@
 import * as i0 from '@angular/core';
-import { TemplateRef, InjectionToken, Provider, OnDestroy, ElementRef, ComponentRef, EmbeddedViewRef, ViewContainerRef, ViewRef, Injector } from '@angular/core';
+import { InjectionToken, TemplateRef, Provider, OnDestroy, ElementRef, ComponentRef, EmbeddedViewRef, ViewContainerRef, ViewRef, Injector } from '@angular/core';
 import { CdkScrollable } from '@angular/cdk/overlay';
 import * as rxjs from 'rxjs';
-import { BehaviorSubject } from 'rxjs';
+import { BehaviorSubject, Observable } from 'rxjs';
 import { AnimationEvent } from '@angular/animations';
 import * as i1 from '@koobiq/components/core';
 import { KbqReadStateDirective, ThemePalette } from '@koobiq/components/core';
@@ -144,11 +144,34 @@ declare class KbqToastContainerComponent extends CdkScrollable {
     private changeDetectorRef;
     readonly service: KbqToastService<any>;
     readonly viewContainer: i0.Signal<ViewContainerRef>;
-    constructor();
+    /**
+     * Emits while the stack re-lays-out. Toasts are ordinary flow children, so removing one slides the
+     * rest for as long as its height animates — and an overlay opened from inside a toast is anchored to
+     * a trigger that is moving. CDK only re-measures the origin on a scroll or a viewport resize, so the
+     * stack has to say when it moved.
+     *
+     * The container's own box tracks the reflow exactly: continuously while a leaving toast animates its
+     * height away, and once for a removal that is not animated at all, such as a template toast.
+     */
+    private readonly reflowed;
+    /**
+     * `ScrollDispatcher` subscribes to this method when the container registers itself, so merging the
+     * reflow signal in re-broadcasts it to every overlay that repositions on scroll — which is what
+     * `kbq-select` and the dropdown trigger do by default.
+     */
+    elementScrolled(): Observable<Event>;
     createToast<C>(data: KbqToastData, componentType: any, onTop: boolean): ComponentRef<C>;
     createTemplate<C>(data: KbqToastData, template: TemplateRef<any>, onTop: boolean): EmbeddedViewRef<C>;
     remove(viewRef: ViewRef): void;
     getInjector(data: KbqToastData): Injector;
+    /**
+     * Fakes a scroll on the container so that overlays anchored inside a toast are repositioned by their
+     * `RepositionScrollStrategy` when the stack shifts.
+     *
+     * @deprecated The container reports its own reflow through `elementScrolled()`, so nothing calls this.
+     * It is kept only for callers that already hold a container reference — the instance created by
+     * `KbqToastService` is not exposed.
+     */
     dispatchScrollEvent: () => void;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqToastContainerComponent, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<KbqToastContainerComponent, "kbq-toast-container", never, {}, {}, never, never, true, never>;

package/toggle/index.d.ts

@@ -1,18 +1,23 @@
 import * as _angular_core from '@angular/core';
 import { AfterViewInit, OnDestroy, ElementRef } from '@angular/core';
 import { ControlValueAccessor } from '@angular/forms';
-import { TransitionCheckState, KbqCheckboxClickAction } from '@koobiq/components/checkbox';
-import { KbqColorDirective, KbqCheckedState } from '@koobiq/components/core';
-import * as i1 from '@angular/cdk/a11y';
+import * as i1 from '@koobiq/components/core';
+import { KbqColorDirective, TransitionCheckState, KbqCheckableClickAction, KbqCheckedState } from '@koobiq/components/core';
+import * as i1$1 from '@angular/cdk/a11y';
 
 type ToggleLabelPositionType = 'left' | 'right';
 declare class KbqToggleChange {
     source: KbqToggleComponent;
     checked: boolean;
 }
+/**
+ * Toggle click action when user click on input element. Alias of `KbqCheckableClickAction`.
+ */
+type KbqToggleClickAction = KbqCheckableClickAction;
 declare class KbqToggleComponent extends KbqColorDirective implements AfterViewInit, ControlValueAccessor, OnDestroy {
-    private focusMonitor;
-    private changeDetectorRef;
+    private readonly changeDetectorRef;
+    private readonly focusMonitor;
+    private readonly checkable;
     readonly big: _angular_core.InputSignal<boolean>;
     readonly inputElement: _angular_core.Signal<ElementRef<HTMLInputElement>>;
     readonly labelPosition: _angular_core.InputSignal<ToggleLabelPositionType>;
@@ -24,13 +29,10 @@ declare class KbqToggleComponent extends KbqColorDirective implements AfterViewI
     readonly value: _angular_core.InputSignal<string>;
     get disabled(): any;
     set disabled(value: any);
-    private _disabled;
     get tabIndex(): number;
     set tabIndex(value: number);
-    private _tabIndex;
     get checked(): boolean;
     set checked(value: boolean);
-    private _checked;
     /**
      * Whether the toggle is indeterminate. This is also known as "mixed" mode and can be used to
      * represent a checkbox with three states, e.g. a checkbox that represents a nested list of
@@ -39,7 +41,6 @@ declare class KbqToggleComponent extends KbqColorDirective implements AfterViewI
      */
     get indeterminate(): boolean;
     set indeterminate(value: boolean);
-    private _indeterminate;
     /**
      * Property for manually set loading state.
      */
@@ -50,7 +51,7 @@ declare class KbqToggleComponent extends KbqColorDirective implements AfterViewI
     /** @docs-private */
     protected currentCheckState: TransitionCheckState;
     /** Defines the behavior when a user clicks on the toggle. */
-    clickAction: KbqCheckboxClickAction;
+    clickAction: KbqToggleClickAction;
     private uniqueId;
     constructor();
     ngAfterViewInit(): void;
@@ -60,25 +61,44 @@ declare class KbqToggleComponent extends KbqColorDirective implements AfterViewI
     onChangeEvent(event: Event): void;
     onLabelTextChange(): void;
     onInputClick(event: MouseEvent): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @deprecated Unused - `ControlValueAccessor` is now implemented by the `KbqCheckable` host directive,
+     * so this is never called by Angular forms. Will be removed in the next major version.
+     */
     writeValue(value: any): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @deprecated Unused - `ControlValueAccessor` is now implemented by the `KbqCheckable` host directive,
+     * so this is never called by Angular forms. Will be removed in the next major version.
+     */
     registerOnChange(fn: any): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @deprecated Unused - `ControlValueAccessor` is now implemented by the `KbqCheckable` host directive,
+     * so this is never called by Angular forms. Will be removed in the next major version.
+     */
     registerOnTouched(fn: any): void;
+    /**
+     * Implemented as part of ControlValueAccessor.
+     * @deprecated Unused - `ControlValueAccessor` is now implemented by the `KbqCheckable` host directive,
+     * so this is never called by Angular forms. Will be removed in the next major version.
+     */
     setDisabledState(isDisabled: boolean): void;
     private setTransitionCheckState;
-    private onTouchedCallback;
-    private onChangeCallback;
     private transitionCheckState;
     private emitChangeEvent;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqToggleComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqToggleComponent, "kbq-toggle", ["kbqToggle"], { "big": { "alias": "big"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "clickAction": { "alias": "clickAction"; "required": false; }; }, { "change": "change"; "indeterminateChange": "indeterminateChange"; }, never, ["*", "kbq-hint"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqToggleComponent, "kbq-toggle", ["kbqToggle"], { "big": { "alias": "big"; "required": false; "isSignal": true; }; "labelPosition": { "alias": "labelPosition"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; "tabIndex": { "alias": "tabIndex"; "required": false; }; "checked": { "alias": "checked"; "required": false; }; "indeterminate": { "alias": "indeterminate"; "required": false; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "clickAction": { "alias": "clickAction"; "required": false; }; }, { "change": "change"; "indeterminateChange": "indeterminateChange"; }, never, ["*", "kbq-hint"], true, [{ directive: typeof i1.KbqCheckable; inputs: {}; outputs: {}; }]>;
     static ngAcceptInputType_tabIndex: unknown;
     static ngAcceptInputType_indeterminate: unknown;
 }
 
 declare class KbqToggleModule {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqToggleModule, never>;
-    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqToggleModule, never, [typeof i1.A11yModule, typeof KbqToggleComponent], [typeof KbqToggleComponent]>;
+    static ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqToggleModule, never, [typeof i1$1.A11yModule, typeof KbqToggleComponent], [typeof KbqToggleComponent]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqToggleModule>;
 }
 
 export { KbqToggleChange, KbqToggleComponent, KbqToggleModule };
+export type { KbqToggleClickAction };

package/tooltip/index.d.ts

@@ -15,7 +15,7 @@ declare const KBQ_TOOLTIP_SINGLE_INSTANCE_DEFAULT: InjectionToken<boolean>;
  * @docs-private
  */
 interface KbqExclusiveTooltip {
-    /** Hides the tooltip because another one has taken its place. */
+    /** Hides the tooltip because another tooltip — or a pop-up on the same element — has taken its place. */
     hideAsInactive(): void;
 }
 /**
@@ -83,10 +83,25 @@ declare const KBQ_TOOLTIP_SCROLL_STRATEGY_FACTORY_PROVIDER: {
 declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> implements AfterViewInit, OnChanges, OnDestroy, KbqExclusiveTooltip {
     /** Registry holding the single tooltip that is currently visible. */
     private readonly tooltipRegistry;
+    private readonly injectedScrollStrategy;
+    /**
+     * Per-instance override for the scroll strategy, taking precedence over `KBQ_TOOLTIP_SCROLL_STRATEGY`
+     * when set. An `@Input` rather than a DI override so it applies to this tooltip instance only, without
+     * leaking into other `kbqTooltip`s nested inside the same host (DI overrides are visible to every
+     * descendant in the element-injector tree, not just the element they're declared on).
+     * @docs-private
+     */
+    readonly scrollStrategyOverride: i0.InputSignal<(() => ScrollStrategy) | undefined>;
     /** @docs-private */
-    protected scrollStrategy: () => ScrollStrategy;
+    protected get scrollStrategy(): () => ScrollStrategy;
     /** @docs-private */
     protected parentPopup: KbqParentPopup | null;
+    /**
+     * Pop-ups anchored to the very same element — a popover, a dropdown, a select and so on. Resolved with
+     * `self` so a pop-up further up the tree (which the tooltip merely lives inside) is not picked up; that
+     * case is covered by `parentPopup`.
+     */
+    private readonly siblingPopups;
     /** @docs-private */
     protected focusMonitor: FocusMonitor;
     /** @docs-private */
@@ -208,15 +223,31 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
      * assign `trigger = 'manual'` and therefore stay out of the group.
      */
     private get participatesInSingleInstance();
+    /**
+     * Whether `kbqTrigger` contains at least one user-driven event, i.e. the tooltip is not driven purely
+     * imperatively. `manual`/`none` tooltips (the validation hints of datepicker, timepicker and inline-edit)
+     * bind no listeners and are expected to stay pinned while the user keeps interacting elsewhere.
+     */
+    private get hasInteractiveTrigger();
+    /**
+     * Whether the tooltip is muted because a pop-up on the same element has taken over the anchor.
+     *
+     * Set when that pop-up opens and released only once the pointer or the focus genuinely leaves the host,
+     * never on the pop-up closing. Both matter: a pop-up restores focus to its trigger when it closes (see
+     * `KbqPopoverComponent.onEscape`), and removing its backdrop replays `mouseenter` on the trigger without
+     * the pointer having moved — either would otherwise pop the tooltip up out of nowhere.
+     */
+    private mutedBySiblingPopup;
     /**
      * Sets up an effect that mirrors a `forDisabledComponent`'s disabled signal: when that component is disabled it
      * makes the host focusable (so the tooltip can still be triggered) and enables the tooltip, otherwise disables it.
      *
-     * Also joins the "only one tooltip is visible at a time" group. Both the subscription and the teardown live
-     * here rather than in `ngAfterViewInit`/`ngOnDestroy` because several subclasses override those hooks:
-     * `KbqTitleDirective` and `KbqEllipsisCenterDirective` skip `super.ngAfterViewInit()`, and `KbqPasswordToggle`
-     * skips `super` in both hooks entirely. `destroyRef` additionally covers a trigger destroyed while its
-     * tooltip is still visible — that path disposes the overlay without emitting `visibleChange(false)`.
+     * Also joins the "only one tooltip is visible at a time" group and mutes the tooltip while a pop-up on the
+     * same element is open. All of this wiring lives here rather than in `ngAfterViewInit`/`ngOnDestroy` because
+     * several subclasses override those hooks: `KbqTitleDirective` and `KbqEllipsisCenterDirective` skip
+     * `super.ngAfterViewInit()`, and `KbqPasswordToggle` skips `super` in both hooks entirely. `destroyRef`
+     * additionally covers a trigger destroyed while its tooltip is still visible — that path disposes the
+     * overlay without emitting `visibleChange(false)`.
      */
     constructor();
     /**
@@ -227,12 +258,24 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** Stops focus monitoring on the host element and runs the base-class teardown. */
     ngOnDestroy(): void;
     /**
-     * Shows the tooltip after `delay` ms. Suppresses showing on a focus trigger that did not originate from
-     * the keyboard, and applies cursor-relative positioning when `relativeToPointer` is enabled.
+     * Shows the tooltip after `delay` ms. Suppresses showing while a pop-up on the same element holds the
+     * anchor or on a focus trigger that did not originate from the keyboard, and applies cursor-relative
+     * positioning when `relativeToPointer` is enabled.
      */
     show(delay?: number): void;
     /**
-     * Hides the tooltip because another tooltip became visible.
+     * Hides the tooltip after `delay` ms and, when the user has genuinely left the host, un-mutes a tooltip
+     * that a pop-up on the same element had muted.
+     *
+     * `mouseleave` and `blur` are the release signals because the base class binds `hide` to both regardless
+     * of whether the tooltip is currently visible. A pop-up that is still attached does not count: its
+     * backdrop steals the hover from the trigger while the pointer stands still, and that `mouseleave` must
+     * not be mistaken for the user leaving.
+     */
+    hide(delay?: number): void;
+    /**
+     * Hides the tooltip because something else took its place — another tooltip became visible, or a pop-up
+     * anchored to the same element opened.
      *
      * Goes straight to the pop-up instead of `hide()`: `hide()` silently no-ops when the last recorded
      * `triggerName` is `mouseleave` and the pop-up itself is hovered. Hiding through the instance keeps
@@ -263,7 +306,7 @@ declare class KbqTooltipTrigger extends KbqPopUpTrigger<KbqTooltipComponent> imp
     /** @docs-private */
     protected applyRelativeToPointer(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<KbqTooltipTrigger, never>;
-    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTooltipTrigger, "[kbqTooltip]", ["kbqTooltip"], { "forDisabledComponent": { "alias": "forDisabledComponent"; "required": false; "isSignal": true; }; "ignoreTooltipPointerEvents": { "alias": "ignoreTooltipPointerEvents"; "required": false; "isSignal": true; }; "singleInstance": { "alias": "kbqTooltipSingleInstance"; "required": false; "isSignal": true; }; "hideWithTimeout": { "alias": "hideWithTimeout"; "required": false; }; "tooltipVisible": { "alias": "kbqVisible"; "required": false; }; "tooltipPlacement": { "alias": "kbqPlacement"; "required": false; }; "relativeToPointer": { "alias": "kbqRelativeToPointer"; "required": false; }; "tooltipPlacementPriority": { "alias": "kbqPlacementPriority"; "required": false; }; "content": { "alias": "kbqTooltip"; "required": false; }; "disabled": { "alias": "kbqTooltipDisabled"; "required": false; }; "enterDelay": { "alias": "kbqEnterDelay"; "required": false; }; "leaveDelay": { "alias": "kbqLeaveDelay"; "required": false; }; "trigger": { "alias": "kbqTrigger"; "required": false; }; "customClass": { "alias": "kbqTooltipClass"; "required": false; }; "context": { "alias": "kbqTooltipContext"; "required": false; }; "color": { "alias": "kbqTooltipColor"; "required": false; }; "arrow": { "alias": "kbqTooltipArrow"; "required": false; }; "offset": { "alias": "kbqTooltipOffset"; "required": false; }; "modifier": { "alias": "kbqTooltipModifier"; "required": false; }; "header": { "alias": "kbqTooltipHeader"; "required": false; }; }, { "placementChange": "kbqPlacementChange"; "visibleChange": "kbqVisibleChange"; }, never, never, true, never>;
+    static ɵdir: i0.ɵɵDirectiveDeclaration<KbqTooltipTrigger, "[kbqTooltip]", ["kbqTooltip"], { "scrollStrategyOverride": { "alias": "kbqTooltipScrollStrategy"; "required": false; "isSignal": true; }; "forDisabledComponent": { "alias": "forDisabledComponent"; "required": false; "isSignal": true; }; "ignoreTooltipPointerEvents": { "alias": "ignoreTooltipPointerEvents"; "required": false; "isSignal": true; }; "singleInstance": { "alias": "kbqTooltipSingleInstance"; "required": false; "isSignal": true; }; "hideWithTimeout": { "alias": "hideWithTimeout"; "required": false; }; "tooltipVisible": { "alias": "kbqVisible"; "required": false; }; "tooltipPlacement": { "alias": "kbqPlacement"; "required": false; }; "relativeToPointer": { "alias": "kbqRelativeToPointer"; "required": false; }; "tooltipPlacementPriority": { "alias": "kbqPlacementPriority"; "required": false; }; "content": { "alias": "kbqTooltip"; "required": false; }; "disabled": { "alias": "kbqTooltipDisabled"; "required": false; }; "enterDelay": { "alias": "kbqEnterDelay"; "required": false; }; "leaveDelay": { "alias": "kbqLeaveDelay"; "required": false; }; "trigger": { "alias": "kbqTrigger"; "required": false; }; "customClass": { "alias": "kbqTooltipClass"; "required": false; }; "context": { "alias": "kbqTooltipContext"; "required": false; }; "color": { "alias": "kbqTooltipColor"; "required": false; }; "arrow": { "alias": "kbqTooltipArrow"; "required": false; }; "offset": { "alias": "kbqTooltipOffset"; "required": false; }; "modifier": { "alias": "kbqTooltipModifier"; "required": false; }; "header": { "alias": "kbqTooltipHeader"; "required": false; }; }, { "placementChange": "kbqPlacementChange"; "visibleChange": "kbqVisibleChange"; }, never, never, true, never>;
     static ngAcceptInputType_hideWithTimeout: unknown;
     static ngAcceptInputType_relativeToPointer: unknown;
     static ngAcceptInputType_arrow: unknown;