@koobiq/components 20.4.2 → 21.0.0

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

@@ -1,9 +1,9 @@
 import * as _angular_core 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 { Signal, OnChanges, OnDestroy, AfterViewInit, ChangeDetectorRef, ElementRef, SimpleChanges, AfterContentChecked, AfterContentInit, DoCheck, QueryList, InjectionToken, Provider } from '@angular/core';
 import { KbqAutocompleteTrigger } from '@koobiq/components/autocomplete';
 import * as i2 from '@angular/cdk/drag-drop';
 import { CdkDragDrop } from '@angular/cdk/drag-drop';
+import { ControlValueAccessor, NgForm, FormGroupDirective, NgControl } from '@angular/forms';
 import * as i1 from '@koobiq/components/core';
 import { KbqColorDirective, IFocusableOption, KbqTitleTextRef, CanUpdateErrorState, ErrorStateMatcher, FocusKeyManager } from '@koobiq/components/core';
 import { KbqFormFieldControl, KbqCleaner } from '@koobiq/components/form-field';
@@ -18,18 +18,18 @@ import * as i1$1 from '@angular/cdk/platform';
  * @docs-private
  */
 interface KbqTagTextControl {
-    id: string;
-    placeholder: string;
-    focused: boolean;
-    empty: boolean;
+    readonly id: Signal<string>;
+    readonly placeholder: Signal<string>;
+    readonly focused: Signal<boolean>;
+    readonly empty: Signal<boolean>;
     /** Whether the control's value was filled in by the browser. */
     autofilled?: Signal<boolean>;
+    focus(): void;
     /**
-     * @deprecated Unused by the library: validation lives on the `<kbq-tag-list>` control.
-     * Will be removed in a future major release.
+     * Keeps an attached autocomplete from opening the next time this control is focused. Implemented by
+     * controls that carry one, so a tag list can restore focus after clearing without opening the panel.
      */
-    ngControl?: NgControl | null;
-    focus(): void;
+    suppressAutocompleteOnNextFocus?(): void;
 }
 
 /**
@@ -68,6 +68,7 @@ type KbqTagFocusEvent = KbqTagEvent & {
 type KbqTagDragData = KbqTagEvent;
 /**
  * Dummy directive to add CSS class to tag avatar.
+ *
  * @docs-private
  */
 declare class KbqTagAvatar {
@@ -76,12 +77,23 @@ declare class KbqTagAvatar {
 }
 /**
  * Dummy directive to add CSS class to tag trailing icon.
+ *
  * @docs-private
  */
 declare class KbqTagTrailingIcon {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagTrailingIcon, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagTrailingIcon, "kbq-tag-trailing-icon, [kbqTagTrailingIcon]", never, {}, {}, never, never, true, never>;
 }
+/** Marks content to be projected into the prefix (leading) slot of a tag. */
+declare class KbqTagPrefix {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagPrefix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagPrefix, "[kbqTagPrefix]", never, {}, {}, never, never, true, never>;
+}
+/** Marks content to be projected into the suffix (trailing) slot of a tag. */
+declare class KbqTagSuffix {
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagSuffix, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagSuffix, "[kbqTagSuffix]", never, {}, {}, never, never, true, never>;
+}
 /**
  * Directive to add submit behavior for the editable tag.
  */
@@ -89,7 +101,7 @@ declare class KbqTagEditSubmit {
     /** @docs-private */
     protected readonly tag: KbqTag;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagEditSubmit, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagEditSubmit, "[kbqTagEditSubmit]", ["kbqTagEditSubmit"], {}, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagEditSubmit, "[kbqTagEditSubmit]", ["kbqTagEditSubmit"], {}, {}, never, never, true, [{ directive: typeof KbqTagSuffix; inputs: {}; outputs: {}; }]>;
 }
 /**
  * Directive to add input behavior for the editable tag.
@@ -103,12 +115,13 @@ declare class KbqTagEditInput {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagEditInput, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagEditInput, "[kbqTagEditInput]", ["kbqTagEditInput"], {}, {}, never, never, true, [{ directive: typeof i1.KbqFieldSizingContent; inputs: {}; outputs: {}; }]>;
 }
-declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDestroy, KbqTitleTextRef, AfterContentInit, AfterViewInit {
+declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnChanges, OnDestroy, KbqTitleTextRef, AfterViewInit {
     changeDetectorRef: ChangeDetectorRef;
     private readonly focusMonitor;
     private readonly tagList;
     private readonly drag;
     private readonly destroyRef;
+    private readonly injector;
     /** @docs-private */
     readonly elementRef: ElementRef<HTMLElement>;
     /**
@@ -130,11 +143,20 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDe
      *
      * @docs-private
      */
-    hasFocus: boolean;
+    get hasFocus(): boolean;
+    /** @docs-private */
+    set hasFocus(value: boolean);
+    private readonly _hasFocus;
+    /**
+     * Backing input of `editable`. Bind through the `editable` attribute; read `editable`, which falls
+     * back to the tag list's `editable` while this is unbound.
+     * `undefined` only as the default: the transform never runs on it, so a bound value is always a boolean.
+     *
+     * @docs-private
+     */
+    readonly editableInput: _angular_core.InputSignalWithTransform<boolean | undefined, unknown>;
     /** Whether the tag is editable. */
-    get editable(): boolean;
-    set editable(value: boolean);
-    private _editable;
+    readonly editable: _angular_core.Signal<boolean>;
     /** Whether the tag edits can't be submitted. */
     readonly preventEditSubmit: _angular_core.InputSignalWithTransform<boolean, unknown>;
     private readonly editInputElementRef;
@@ -146,10 +168,11 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDe
      * @docs-private
      */
     protected readonly editing: _angular_core.WritableSignal<boolean>;
+    private readonly textElementQuery;
     /**
      * @docs-private
      */
-    readonly textElement: ElementRef<HTMLSpanElement>;
+    get textElement(): ElementRef<HTMLSpanElement>;
     readonly contentChildren: _angular_core.Signal<readonly KbqIcon[]>;
     /** The tag avatar */
     readonly avatar: _angular_core.Signal<KbqTagAvatar | undefined>;
@@ -166,46 +189,89 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDe
      * Fires on programmatic and UI removal (click or keyboard).
      */
     readonly removed: _angular_core.OutputEmitterRef<KbqTagEvent>;
+    /**
+     * Backing input of `selected`. Bind through the `selected` attribute; read `selected`, which also
+     * reflects `select()`, `deselect()` and user interaction.
+     * A change of the binding is applied in `ngOnChanges` through `setSelectedState()`, so it emits
+     * `selectionChange` the way the old setter did - the tag list listens to it.
+     *
+     * @docs-private
+     */
+    readonly selectedInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly _selected;
     /** Whether the tag is selected. */
-    get selected(): boolean;
-    set selected(value: boolean);
-    private _selected;
+    readonly selected: _angular_core.Signal<boolean>;
     /** The value of the tag. Defaults to the content inside `<kbq-tag>` tags. */
     get value(): any;
     set value(value: any);
     private _value;
     /**
-     * Whether the tag is selectable.
+     * Backing input of `selectable`. Bind through the `selectable` attribute; read `selectable`, which is
+     * also true while the tag list is selectable.
+     *
+     * @docs-private
      */
-    get selectable(): boolean;
-    set selectable(value: boolean);
-    private _selectable;
+    readonly selectableInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Whether the tag is selectable. */
+    readonly selectable: _angular_core.Signal<boolean>;
     /**
-     * Determines whether the tag is removable.
+     * Backing input of `removable`. Bind through the `removable` attribute; read `removable`, which also
+     * requires the tag list to be removable.
+     *
+     * @docs-private
      */
-    get removable(): boolean;
-    set removable(value: boolean);
-    private _removable;
-    get tabindex(): any;
-    set tabindex(value: any);
-    private _tabindex;
+    readonly removableInput: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Determines whether the tag is removable. */
+    readonly removable: _angular_core.Signal<boolean>;
     /**
-     * Whether the tag is disabled.
+     * Whether the user may remove this tag through the controls the tag itself offers — the remove
+     * control and the `Delete` key. A disabled tag offers neither.
+     *
+     * This is the affordance, not the channel: `remove()` stays open so the list can still clear a
+     * disabled tag when `clearPredicate` asks for it.
      */
+    get canRemove(): boolean;
+    /** Tab order of the tag. */
+    get tabindex(): any;
+    set tabindex(value: any);
+    private readonly _tabindex;
+    private readonly tabindexState;
+    /** Whether the tag is disabled. */
     get disabled(): boolean;
     set disabled(value: boolean);
-    private _disabled;
+    private readonly _disabled;
+    private readonly disabledState;
     /**
      * Whether the tag is draggable.
      *
      * @docs-private
      */
     protected get draggable(): boolean;
+    private readonly draggableState;
+    /**
+     * Whether the tag moves into place without motion while the list is reordered.
+     *
+     * @docs-private
+     */
+    protected readonly animationsDisabled: boolean;
+    /** @docs-private */
+    readonly valueInput: _angular_core.InputSignal<{} | null | undefined>;
+    /** @docs-private */
+    readonly tabindexInput: _angular_core.InputSignal<number | null | undefined>;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
     constructor();
-    ngAfterContentInit(): void;
+    ngOnChanges(changes: SimpleChanges): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
-    /** @docs-private */
+    /**
+     * Adds the legacy positional classes inferred from projected icons.
+     *
+     * @deprecated Use `KbqTagPrefix` and `KbqTagSuffix` to declare the position explicitly.
+     * Will be removed in 22.0.0.
+     *
+     * @docs-private
+     */
     addClassModificatorForIcons(): void;
     /** @docs-private */
     addHostClassName(): void;
@@ -259,15 +325,9 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDe
         emitEvent: boolean;
     }>): void;
     private setupDragInitialProperties;
-    private syncDragDisabledState;
     private setupFocusMonitor;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTag, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTag, "kbq-tag, [kbq-tag], kbq-basic-tag, [kbq-basic-tag]", ["kbqTag"], { "editable": { "alias": "editable"; "required": false; }; "preventEditSubmit": { "alias": "preventEditSubmit"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; }; "value": { "alias": "value"; "required": false; }; "selectable": { "alias": "selectable"; "required": false; }; "removable": { "alias": "removable"; "required": false; }; "tabindex": { "alias": "tabindex"; "required": false; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "editChange": "editChange"; "selectionChange": "selectionChange"; "destroyed": "destroyed"; "removed": "removed"; }, ["editInputElementRef", "contentChildren", "avatar", "trailingIcon", "removeIcon"], ["[kbq-icon]:not([kbqTagRemove]):not([kbqTagEditSubmit])", "[kbqTagEditInput]", "*", "[kbqTagEditSubmit]", "[kbqTagRemove]"], true, [{ directive: typeof i2.CdkDrag; inputs: {}; outputs: {}; }]>;
-    static ngAcceptInputType_editable: unknown;
-    static ngAcceptInputType_selected: unknown;
-    static ngAcceptInputType_selectable: unknown;
-    static ngAcceptInputType_removable: unknown;
-    static ngAcceptInputType_disabled: unknown;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTag, "kbq-tag, [kbq-tag], kbq-basic-tag, [kbq-basic-tag]", ["kbqTag"], { "editableInput": { "alias": "editable"; "required": false; "isSignal": true; }; "preventEditSubmit": { "alias": "preventEditSubmit"; "required": false; "isSignal": true; }; "selectedInput": { "alias": "selected"; "required": false; "isSignal": true; }; "selectableInput": { "alias": "selectable"; "required": false; "isSignal": true; }; "removableInput": { "alias": "removable"; "required": false; "isSignal": true; }; "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "tabindexInput": { "alias": "tabindex"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "editChange": "editChange"; "selectionChange": "selectionChange"; "destroyed": "destroyed"; "removed": "removed"; }, ["editInputElementRef", "contentChildren", "avatar", "trailingIcon", "removeIcon"], ["[kbqTagPrefix]", "[kbqTagEditInput]", "*", "[kbqTagEditSubmit]", "[kbqTagRemove]", "[kbqTagSuffix]"], true, [{ directive: typeof i2.CdkDrag; inputs: {}; outputs: {}; }, { directive: typeof i1.KbqLocaleOverridesDirective; inputs: { "kbqLocaleOverrides": "localeOverrides"; }; outputs: {}; }]>;
 }
 /**
  *
@@ -282,6 +342,20 @@ declare class KbqTag extends KbqColorDirective implements IFocusableOption, OnDe
  */
 declare class KbqTagRemove {
     protected parentTag: KbqTag;
+    private readonly elementRef;
+    private readonly a11yLocaleConfiguration;
+    /** Accessible name of the button. Defaults to the localized "Remove". */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** @docs-private */
+    protected readonly accessibleName: _angular_core.Signal<string>;
+    /**
+     * Position of the control in the tab order.
+     *
+     * Defaults to `-1`, because in a tag list the tag itself is the tab stop and removal is reached from
+     * there. A tag rendered outside such a list — inside a select's trigger, for one — has to opt into a
+     * tab stop of its own, or the control is left mouse-only.
+     */
+    readonly tabIndex: _angular_core.InputSignalWithTransform<number, unknown>;
     /** @docs-private */
     focus(event: FocusEvent): void;
     /**
@@ -290,8 +364,14 @@ declare class KbqTagRemove {
      * @docs-private
      */
     handleClick(event: Event): void;
+    /**
+     * Activates the button from the keyboard by synthesizing a click, so that a `(click)` listener the
+     * host template put on this very element — the way `KbqSelect` and `KbqTreeSelect` deselect the
+     * option behind the tag — runs as well, and not only `handleClick` below.
+     */
+    protected handleKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<KbqTagRemove, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagRemove, "[kbqTagRemove]", never, {}, {}, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagRemove, "[kbqTagRemove]", never, { "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "tabIndex": { "alias": "tabIndex"; "required": false; "isSignal": true; }; }, {}, never, never, true, [{ directive: typeof KbqTagSuffix; inputs: {}; outputs: {}; }]>;
 }
 
 /** Change event object that is emitted when the tag list value has changed. */
@@ -303,7 +383,7 @@ declare class KbqTagListChange {
 type KbqTagListDroppedEvent = Pick<CdkDragDrop<unknown>, 'event' | 'previousIndex' | 'currentIndex'> & {
     tag: KbqTag;
 };
-declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccessor, AfterContentInit, DoCheck, OnDestroy, CanUpdateErrorState, AfterViewInit {
+declare class KbqTagList implements AfterContentChecked, OnChanges, KbqFormFieldControl<any>, ControlValueAccessor, AfterContentInit, DoCheck, OnDestroy, CanUpdateErrorState, AfterViewInit {
     protected elementRef: ElementRef<HTMLElement>;
     private changeDetectorRef;
     defaultErrorStateMatcher: ErrorStateMatcher;
@@ -320,18 +400,7 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * @docs-private
      */
     readonly controlType: string;
-    /**
-     * Emits whenever the component state changes and should cause the parent
-     * form-field to update. Implemented as part of `KbqFormFieldControl`.
-     * @docs-private
-     */
-    readonly stateChanges: Subject<void>;
-    /**
-     * Combined stream of all of the child tags' selection change events.
-     *
-     * @docs-private
-     */
-    get tagSelectionChanges(): Observable<KbqTagSelectionChange>;
+    private readonly errorStateTracker;
     /**
      * Combined stream of all of the child tags' focus change events.
      *
@@ -371,33 +440,56 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     /** @docs-private */
     get canShowCleaner(): boolean;
     /**
-     * Implemented as part of KbqFormFieldControl.
+     * Marks the list for a change-detection check.
+     *
+     * Kept for back-compatibility. The cleaner's visibility is derived from signals of the list and its
+     * tags, so the list re-renders on its own and nothing in the library calls this any more.
+     * Kept at the DS-2196 review, like `KbqButtonToggle.markForCheck()`, which the migration guide promises stays.
+     *
      * @docs-private
      */
-    get value(): any;
-    set value(value: any);
-    private _value;
+    markForCheck(): void;
     /**
-     * Implemented as part of KbqFormFieldControl.
+     * Whether the cleaner still has a tag to remove, and so is worth showing at all.
+     *
+     * @docs-private
+     */
+    get canClear(): boolean;
+    /** Tags the cleaner removes, in render order. */
+    private get clearTargets();
+    /** Whether the cleaner removes this tag: the list must allow removal and the predicate must accept it. */
+    private isClearTarget;
+    /** @docs-private */
+    readonly valueInput: _angular_core.InputSignal<any>;
+    /**
+     * Implemented as part of KbqFormFieldControl. Set with `[value]`, by the form control and by the rendered
+     * tags.
+     *
      * @docs-private
      */
-    get id(): string;
+    readonly value: _angular_core.WritableSignal<any>;
     /**
      * Implemented as part of KbqFormFieldControl.
+     *
      * @docs-private
      */
-    get required(): boolean;
-    set required(value: boolean);
-    private _required;
+    readonly id: _angular_core.Signal<string>;
     /**
      * Implemented as part of KbqFormFieldControl.
+     *
+     * @docs-private
+     */
+    readonly required: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
+    /** @docs-private */
+    readonly placeholderInput: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Implemented as part of KbqFormFieldControl. Taken from the `kbqTagInput` when there is one.
+     *
      * @docs-private
      */
-    get placeholder(): string;
-    set placeholder(value: string);
-    private _placeholder;
+    readonly placeholder: _angular_core.Signal<string | undefined>;
     /** Whether any tags or the kbqTagInput inside of this tag-list has focus. */
-    get focused(): boolean;
+    readonly focused: _angular_core.Signal<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.
@@ -407,24 +499,24 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     readonly autofilled: _angular_core.Signal<boolean>;
     /**
      * Implemented as part of KbqFormFieldControl.
+     *
      * @docs-private
      */
-    get empty(): boolean;
-    /**
-     * Implemented as part of KbqFormFieldControl.
-     * @docs-private
-     */
-    get shouldLabelFloat(): boolean;
+    readonly empty: _angular_core.Signal<boolean>;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean, string | boolean | null | undefined>;
     /**
-     * Implemented as part of KbqFormFieldControl.
+     * Implemented as part of KbqFormFieldControl. Also set by the bound form control.
+     *
      * @docs-private
      */
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private _disabled;
+    readonly disabled: _angular_core.WritableSignal<boolean>;
+    /** Whether the tags in the list can be reordered by dragging. */
     get draggable(): boolean;
     set draggable(value: boolean);
-    private _draggable;
+    private readonly _draggable;
+    private readonly draggableState;
+    private readonly resolvedTabIndex;
     /**
      * Emits when the user drops tag inside tag list container.
      */
@@ -436,10 +528,16 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the tags in the list are editable. */
     readonly editable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Decides which tags the projected `KbqCleaner` removes: return `true` to clear the tag, `false` to
+     * keep it. Disabled tags are kept by default. Bind a stable reference — a new function on every change
+     * detection re-runs the predicate over every tag.
+     *
+     * A tag the list does not allow to be removed is never offered, whatever the predicate answers.
+     */
+    readonly clearPredicate: _angular_core.InputSignalWithTransform<(tag: KbqTag) => boolean, (tag: KbqTag) => boolean>;
     /** Whether the tags in the list are removable. */
-    get removable(): boolean;
-    set removable(value: boolean);
-    private _removable;
+    readonly removable: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
      * Tab index of the tag list. This property is ignored when the tag list contains a tag input or is disabled.
      *
@@ -447,15 +545,16 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      */
     get tabIndex(): number | null;
     set tabIndex(value: number);
-    private _tabIndex;
+    private readonly _tabIndex;
     /**
      * Event that emits whenever the raw value of the tag-list changes. This is here primarily
      * to facilitate the two-way binding for the `value` input.
+     *
      * @docs-private
      */
     readonly valueChange: _angular_core.OutputEmitterRef<any>;
     /** @docs-private */
-    uid: string;
+    readonly uid: string;
     /**
      * User defined tab index.
      * When it is not null, use user defined tab index. Otherwise use tabIndex
@@ -466,23 +565,25 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     /** @docs-private */
     keyManager: FocusKeyManager<KbqTag>;
     /** An object used to control when error messages are shown. */
-    errorStateMatcher: ErrorStateMatcher;
+    readonly errorStateMatcher: _angular_core.InputSignal<ErrorStateMatcher | undefined>;
     /** Event emitted when the selected tag list value has been changed by the user. */
     readonly change: _angular_core.OutputEmitterRef<KbqTagListChange>;
     /** @docs-private */
     readonly cleaner: _angular_core.Signal<KbqCleaner | undefined>;
+    private readonly tagsQuery;
+    private readonly tagsList;
     /**
      * The tag components contained within this tag list.
      *
      * @docs-private
      */
-    tags: QueryList<KbqTag>;
+    get tags(): QueryList<KbqTag>;
     /**
      * Whether the component is in an error state.
      *
      * @docs-private
      */
-    errorState: boolean;
+    readonly errorState: _angular_core.Signal<boolean>;
     /** The tag input to add more tags */
     private tagInput;
     /**
@@ -500,11 +601,22 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * appropriate tag that should receive focus until the array of tags updated completely.
      */
     private lastDestroyedTagIndex;
+    /**
+     * Tags the list has asked the consumer to drop. They stay rendered, and stay in `tags`, until the
+     * consumer's own view is re-checked, so until then they cannot be given focus.
+     */
+    private readonly pendingRemoval;
     /** Triggers unsubscription from all per-tags streams when tags are reset. */
     private readonly tagsSubscriptions$;
+    /** @docs-private */
+    readonly draggableInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
+    /** @docs-private */
+    readonly tabIndexInput: _angular_core.InputSignal<number | undefined>;
+    ngOnChanges(changes: SimpleChanges): void;
     constructor();
     ngDoCheck(): void;
     ngAfterContentInit(): void;
+    ngAfterContentChecked(): void;
     ngAfterViewInit(): void;
     ngOnDestroy(): void;
     /** @docs-private */
@@ -547,6 +659,7 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * Focuses the tag list. If there is a tag input, focuses that instead.
      */
     focus(): void;
+    private focusFirstTag;
     /**
      * Focuses the tag input inside the tag list.
      *
@@ -605,6 +718,16 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
      * @docs-private
      */
     removeSelected(): void;
+    /**
+     * Removes the tags `clearPredicate` accepts, which by default leaves the disabled ones in place.
+     *
+     * The tags belong to the consumer, so each one is asked to go through its `removed` output, the same
+     * output the remove control reports to. Unlike that control it will ask for a disabled tag too, when
+     * the predicate accepts one.
+     *
+     * @docs-private
+     */
+    clear(): void;
     /** Whether the rendered tags no longer match the value this control last reported. */
     private hasTagsValueChanged;
     private propagateTagsChanges;
@@ -615,17 +738,13 @@ declare class KbqTagList implements KbqFormFieldControl<any>, ControlValueAccess
     private listenToTagsEdit;
     /** Checks whether any of the tags is focused. */
     private hasFocusedTag;
-    private syncTagsRemovableState;
     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;
-    static ngAcceptInputType_draggable: unknown;
-    static ngAcceptInputType_removable: unknown;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<KbqTagList, "kbq-tag-list", ["kbqTagList"], { "valueInput": { "alias": "value"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "placeholderInput": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "editable": { "alias": "editable"; "required": false; "isSignal": true; }; "clearPredicate": { "alias": "clearPredicate"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "errorStateMatcher": { "alias": "errorStateMatcher"; "required": false; "isSignal": true; }; "draggableInput": { "alias": "draggable"; "required": false; "isSignal": true; }; "tabIndexInput": { "alias": "tabIndex"; "required": false; "isSignal": true; }; }, { "dropped": "dropped"; "valueChange": "valueChange"; "change": "change"; }, ["cleaner", "tagsQuery"], ["*", "kbq-cleaner"], true, [{ directive: typeof i2.CdkDropList; inputs: {}; outputs: {}; }]>;
 }
 
 /** Represents an input event on a `kbqTagInput`. */
@@ -653,8 +772,7 @@ interface KbqTagSeparator {
      */
     keyCode?: number;
     /**
-     * Contexts this separator applies to.
-     * @default ['input', 'paste']
+     * Contexts this separator applies to. Defaults to `['input', 'paste']`.
      */
     appliesTo?: KbqTagSeparatorContext[];
 }
@@ -675,30 +793,23 @@ declare const kbqTagsDefaultOptionsProvider: (options: Partial<KbqTagsDefaultOpt
  * 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>`.
  */
-declare class KbqTagInput implements KbqTagTextControl, OnChanges {
+declare class KbqTagInput implements KbqTagTextControl, OnChanges, DoCheck {
     private elementRef;
     private defaultOptions;
     private trimDirective;
-    /**
-     * 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;
+    private readonly focusedValue;
     /**
      * Whether the control is focused.
+     *
      * @docs-private
      */
-    focused: boolean;
+    readonly focused: _angular_core.Signal<boolean>;
     /** Whether the control's value was filled in by the browser. */
     readonly autofilled: _angular_core.Signal<boolean>;
     /**
@@ -706,68 +817,67 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
      *
      * Defaults to `[ENTER]`.
      */
-    set separatorKeyCodes(value: number[]);
-    private _separatorKeyCodes;
+    readonly separatorKeyCodes: _angular_core.InputSignalWithTransform<number[], number[] | null | undefined>;
+    private readonly allSeparators;
     /**
      * 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;
+    readonly separators: _angular_core.Signal<KbqTagSeparator[]>;
     /** Emitted when a tag is to be added. */
     readonly tagEnd: _angular_core.OutputEmitterRef<KbqTagInputEvent>;
     /** A value indicating whether allow/prevent tags duplication  */
-    readonly distinct: _angular_core.InputSignal<boolean>;
+    readonly distinct: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** The input's placeholder text. */
-    placeholder: string;
+    readonly placeholder: _angular_core.InputSignal<string>;
     /** Unique id for the input. */
-    id: string;
-    /** Register input for tag list */
-    set tagList(value: KbqTagList);
+    readonly id: _angular_core.InputSignal<string>;
+    /** Register input for tag list. */
+    readonly tagList: _angular_core.InputSignal<KbqTagList | undefined>;
     private _tagList;
     /**
      * Whether or not the tagEnd event will be emitted when the input is blurred.
      */
-    get addOnBlur(): boolean;
-    set addOnBlur(value: boolean);
-    private _addOnBlur;
+    readonly addOnBlur: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /**
-     * Whether the tagEnd event will be emitted when the text pasted.
-     * @default true
+     * Whether the tagEnd event will be emitted when the text pasted. Defaults to `addOnPaste` of
+     * `KBQ_TAGS_DEFAULT_OPTIONS`, or `true`.
      */
     readonly addOnPaste: _angular_core.InputSignalWithTransform<boolean, unknown>;
     /** Whether the input is disabled. */
     get disabled(): boolean;
     set disabled(value: boolean);
-    private _disabled;
+    private readonly _disabled;
+    private readonly emptyValue;
     /** Whether the input is empty. */
-    get empty(): boolean;
+    readonly empty: _angular_core.Signal<boolean>;
     /** The native input element to which this directive is attached. */
     private inputElement;
+    /** @docs-private */
+    readonly disabledInput: _angular_core.InputSignalWithTransform<boolean | undefined, string | boolean | null | undefined>;
     constructor();
-    ngOnChanges(): void;
+    ngOnChanges(changes: SimpleChanges): void;
+    ngDoCheck(): void;
     /** @docs-private */
     onKeydown(event: KeyboardEvent): void;
     /**
      * 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.
+     *
      * @docs-private
      */
     emitTagEnd(): void;
     /**
      * Whether the current input value duplicates an existing tag.
+     *
      * @docs-private
      */
     get hasDuplicates(): boolean;
@@ -779,6 +889,12 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
     onFocus(): void;
     /** Focuses the input. */
     focus(): void;
+    /**
+     * Implemented as part of KbqTagTextControl.
+     *
+     * @docs-private
+     */
+    suppressAutocompleteOnNextFocus(): void;
     private getPasteSeparatorPatterns;
     /**
      * Single path for adding a tag, shared by typed input, blur and paste.
@@ -792,14 +908,14 @@ declare class KbqTagInput implements KbqTagTextControl, OnChanges {
     /** 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: {}; }]>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<KbqTagInput, "input[kbqTagInputFor]", ["kbqTagInput", "kbqTagInputFor"], { "separatorKeyCodes": { "alias": "kbqTagInputSeparatorKeyCodes"; "required": false; "isSignal": true; }; "distinct": { "alias": "distinct"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "tagList": { "alias": "kbqTagInputFor"; "required": false; "isSignal": true; }; "addOnBlur": { "alias": "kbqTagInputAddOnBlur"; "required": false; "isSignal": true; }; "addOnPaste": { "alias": "kbqTagInputAddOnPaste"; "required": false; "isSignal": true; }; "disabledInput": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "tagEnd": "kbqTagInputTokenEnd"; }, never, never, true, [{ directive: typeof i1.KbqFieldSizingContent; inputs: {}; outputs: {}; }]>;
 }
 
 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 ɵmod: _angular_core.ɵɵNgModuleDeclaration<KbqTagsModule, never, [typeof i1$1.PlatformModule, typeof KbqTagEditSubmit, typeof KbqTagEditInput, typeof KbqTagPrefix, typeof KbqTagSuffix, 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, typeof KbqTagPrefix, typeof KbqTagSuffix]>;
     static ɵinj: _angular_core.ɵɵInjectorDeclaration<KbqTagsModule>;
 }
 
-export { KBQ_TAGS_DEFAULT_OPTIONS, KbqTag, KbqTagAvatar, KbqTagEditChange, KbqTagEditInput, KbqTagEditSubmit, KbqTagInput, KbqTagList, KbqTagListChange, KbqTagRemove, KbqTagSelectionChange, KbqTagTrailingIcon, KbqTagsModule, kbqTagsDefaultOptionsProvider };
+export { KBQ_TAGS_DEFAULT_OPTIONS, KbqTag, KbqTagAvatar, KbqTagEditChange, KbqTagEditInput, KbqTagEditSubmit, KbqTagInput, KbqTagList, KbqTagListChange, KbqTagPrefix, KbqTagRemove, KbqTagSelectionChange, KbqTagSuffix, KbqTagTrailingIcon, KbqTagsModule, kbqTagsDefaultOptionsProvider };
 export type { KbqTagDragData, KbqTagEvent, KbqTagFocusEvent, KbqTagInputEvent, KbqTagListDroppedEvent, KbqTagSeparator, KbqTagSeparatorContext, KbqTagsDefaultOptions };