@arsedizioni/ars-utils 22.6.86 → 22.6.88

package/types/arsedizioni-ars-utils-ui.controls.d.ts

@@ -1,281 +1,443 @@
-import * as _angular_core from '@angular/core';
-import { OnDestroy } from '@angular/core';
-import { ControlValueAccessor, NgControl } from '@angular/forms';
-import { NameValueItem } from '@arsedizioni/ars-utils/core';
-import * as _angular_forms_signals from '@angular/forms/signals';
-
-declare class ButtonSelectorComponent implements OnDestroy, ControlValueAccessor {
-    ngControl: NgControl;
-    /** Emitted whenever the selected value changes (including programmatic resets). */
-    readonly changed: _angular_core.OutputEmitterRef<NameValueItem<any>>;
-    /** Emitted when the user explicitly picks an item from the menu. */
-    readonly selected: _angular_core.OutputEmitterRef<NameValueItem<any>>;
-    private readonly stateChanges;
-    private focused;
-    private _value;
-    set value(value: NameValueItem<any> | undefined);
-    /**
-     * Updates the internal state. Form propagation is skipped for model->view
-     * writes (writeValue) to avoid the CVA echo loop, and performed for
-     * user/programmatic changes via the `value` setter.
-     * @param value     - The new value to store and display.
-     * @param propagate - When `true`, notifies the registered onChange callback.
-     */
-    private setValue;
-    /** The current value as the selected item. */
-    get value(): NameValueItem<any> | undefined;
-    private _disabled;
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    private propagateChange;
-    private propagateTouched;
-    id: string;
-    describedBy: string;
-    private readonly renderer;
-    /** Currently selected item, kept in sync with the form control value. */
-    protected readonly current: _angular_core.WritableSignal<NameValueItem<any>>;
-    /** Width of the trigger button in pixels. Use `-1` for 100 %, `0` for `auto`. */
-    readonly width: _angular_core.InputSignal<number>;
-    /** Border thickness override. Use `-1` to inherit. */
-    readonly border: _angular_core.InputSignal<number>;
-    /** CSS border-radius of the trigger button. Defaults to a pill shape. */
-    readonly borderRadius: _angular_core.InputSignal<string>;
-    /** Placeholder label shown when nothing is selected. */
-    readonly label: _angular_core.InputSignal<string>;
-    /** Label shown above the selected value (replaces `label` when an item is selected). */
-    readonly labelSelected: _angular_core.InputSignal<string>;
-    /** List of selectable options. */
-    readonly options: _angular_core.InputSignal<NameValueItem<any>[]>;
-    /** When `true`, the first available option is pre-selected on init. */
-    readonly autoSelect: _angular_core.InputSignal<boolean>;
-    constructor(ngControl: NgControl);
-    ngOnDestroy(): void;
-    /**
-     * Writes a new value to the component (called by the form layer).
-     * @param value - The new value to display.
-     */
-    writeValue(value: any): void;
-    /**
-     * Registers the on-change callback (called by the form layer).
-     * @param fn - Callback to invoke whenever the value changes.
-     */
-    registerOnChange(fn: (_: any) => void): void;
-    /**
-     * Registers the on-touched callback (called by the form layer).
-     * @param fn - Callback to invoke when the control is touched.
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Sets the ARIA described-by IDs for accessibility.
-     * @param ids - The list of element IDs to associate with this control.
-     */
-    setDescribedByIds(ids: string[]): void;
-    /**
-     * Updates the disabled state when the Angular form layer changes it.
-     * @param isDisabled - Whether the control should be disabled.
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /**
-     * Handles a click on the container element, focusing it and marking it as touched.
-     */
-    onContainerClick(): void;
-    /**
-     * Selects an option and optionally emits the `selected` output event.
-     * @param item   - The item to select.
-     * @param notify - When `true` (default), emits the `selected` event.
-     */
-    select(item: NameValueItem<any>, notify?: boolean): void;
-    /** Clears the current selection and resets the control to an empty state. */
-    reset(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonSelectorComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonSelectorComponent, "button-selector", never, { "disabled": { "alias": "disabled"; "required": false; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "border": { "alias": "border"; "required": false; "isSignal": true; }; "borderRadius": { "alias": "borderRadius"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "labelSelected": { "alias": "labelSelected"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "autoSelect": { "alias": "autoSelect"; "required": false; "isSignal": true; }; }, { "changed": "changed"; "selected": "selected"; }, never, never, true, never>;
+import * as i0 from "@angular/core";
+import { OnDestroy } from "@angular/core";
+import { ControlValueAccessor, NgControl } from "@angular/forms";
+import { NameValueItem } from "@arsedizioni/ars-utils/core";
+export declare class ButtonSelectorComponent implements OnDestroy, ControlValueAccessor {
+  ngControl: NgControl;
+  /** Emitted whenever the selected value changes (including programmatic resets). */
+  readonly changed: import("@angular/core").OutputEmitterRef<NameValueItem<any>>;
+  /** Emitted when the user explicitly picks an item from the menu. */
+  readonly selected: import("@angular/core").OutputEmitterRef<NameValueItem<any>>;
+  private readonly stateChanges;
+  private focused;
+  private _value;
+  set value(value: NameValueItem<any> | undefined);
+  /**
+   * Updates the internal state. Form propagation is skipped for model->view
+   * writes (writeValue) to avoid the CVA echo loop, and performed for
+   * user/programmatic changes via the `value` setter.
+   * @param value     - The new value to store and display.
+   * @param propagate - When `true`, notifies the registered onChange callback.
+   */
+  private setValue;
+  /** The current value as the selected item. */
+  get value(): NameValueItem<any> | undefined;
+  private _disabled;
+  get disabled(): boolean;
+  set disabled(value: boolean);
+  private propagateChange;
+  private propagateTouched;
+  id: string;
+  describedBy: string;
+  private readonly renderer;
+  /** Currently selected item, kept in sync with the form control value. */
+  protected readonly current: import("@angular/core").WritableSignal<NameValueItem<any>>;
+  /** Width of the trigger button in pixels. Use `-1` for 100 %, `0` for `auto`. */
+  readonly width: import("@angular/core").InputSignal<number>;
+  /** Border thickness override. Use `-1` to inherit. */
+  readonly border: import("@angular/core").InputSignal<number>;
+  /** CSS border-radius of the trigger button. Defaults to a pill shape. */
+  readonly borderRadius: import("@angular/core").InputSignal<string>;
+  /** Placeholder label shown when nothing is selected. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** Label shown above the selected value (replaces `label` when an item is selected). */
+  readonly labelSelected: import("@angular/core").InputSignal<string>;
+  /** List of selectable options. */
+  readonly options: import("@angular/core").InputSignal<NameValueItem<any>[]>;
+  /** When `true`, the first available option is pre-selected on init. */
+  readonly autoSelect: import("@angular/core").InputSignal<boolean>;
+  constructor(ngControl: NgControl);
+  ngOnDestroy(): void;
+  /**
+   * Writes a new value to the component (called by the form layer).
+   * @param value - The new value to display.
+   */
+  writeValue(value: any): void;
+  /**
+   * Registers the on-change callback (called by the form layer).
+   * @param fn - Callback to invoke whenever the value changes.
+   */
+  registerOnChange(fn: (_: any) => void): void;
+  /**
+   * Registers the on-touched callback (called by the form layer).
+   * @param fn - Callback to invoke when the control is touched.
+   */
+  registerOnTouched(fn: () => void): void;
+  /**
+   * Sets the ARIA described-by IDs for accessibility.
+   * @param ids - The list of element IDs to associate with this control.
+   */
+  setDescribedByIds(ids: string[]): void;
+  /**
+   * Updates the disabled state when the Angular form layer changes it.
+   * @param isDisabled - Whether the control should be disabled.
+   */
+  setDisabledState(isDisabled: boolean): void;
+  /**
+   * Handles a click on the container element, focusing it and marking it as touched.
+   */
+  onContainerClick(): void;
+  /**
+   * Selects an option and optionally emits the `selected` output event.
+   * @param item   - The item to select.
+   * @param notify - When `true` (default), emits the `selected` event.
+   */
+  select(item: NameValueItem<any>, notify?: boolean): void;
+  /** Clears the current selection and resets the control to an empty state. */
+  reset(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ButtonSelectorComponent, [{
+    optional: true;
+    self: true;
+  }]>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ButtonSelectorComponent, "button-selector", never, {
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+    };
+    "width": {
+      "alias": "width";
+      "required": false;
+      "isSignal": true;
+    };
+    "border": {
+      "alias": "border";
+      "required": false;
+      "isSignal": true;
+    };
+    "borderRadius": {
+      "alias": "borderRadius";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelSelected": {
+      "alias": "labelSelected";
+      "required": false;
+      "isSignal": true;
+    };
+    "options": {
+      "alias": "options";
+      "required": false;
+      "isSignal": true;
+    };
+    "autoSelect": {
+      "alias": "autoSelect";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "changed": "changed";
+    "selected": "selected";
+  }, never, never, true, never>;
 }
-
-interface ButtonToggleInfo {
-    value: boolean;
-    toggled: boolean;
+export interface ButtonToggleInfo {
+  value: boolean;
+  toggled: boolean;
 }
-declare class ButtonToggleComponent {
-    /** Emitted each time the button is clicked. Carries the current `value` and the new `toggled` state. */
-    readonly changed: _angular_core.OutputEmitterRef<ButtonToggleInfo>;
-    /** Current value bound from the parent. Drives label and icon selection. */
-    readonly value: _angular_core.InputSignal<boolean>;
-    /** Width of the button in pixels. Use `-1` for automatic sizing. */
-    readonly width: _angular_core.InputSignal<number>;
-    /** Border thickness override in pixels. Use `-1` to inherit. */
-    readonly border: _angular_core.InputSignal<number>;
-    /** Label shown when `value` is `true`. */
-    readonly labelOn: _angular_core.InputSignal<string>;
-    /** Label shown when `value` is `false`. */
-    readonly labelOff: _angular_core.InputSignal<string>;
-    /** Material icon name shown when `value` is `true`. */
-    readonly iconOn: _angular_core.InputSignal<string>;
-    /** Material icon name shown when `value` is `false`. */
-    readonly iconOff: _angular_core.InputSignal<string>;
-    /** CSS class applied to the button at all breakpoints. */
-    readonly cssClass: _angular_core.InputSignal<string>;
-    /** CSS class applied to the button on `xs` screens. */
-    readonly cssClassSmall: _angular_core.InputSignal<string>;
-    /** Resolves the appropriate label for the current value state. */
-    protected readonly label: _angular_core.Signal<string>;
-    /** Resolves the appropriate icon name for the current value state. */
-    protected readonly icon: _angular_core.Signal<string>;
-    /**
-     * Toggles the button state and emits the `changed` event.
-     * The emitted `toggled` value is the logical inverse of the current `value`.
-     */
-    toggle(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ButtonToggleComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonToggleComponent, "button-toggle", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "border": { "alias": "border"; "required": false; "isSignal": true; }; "labelOn": { "alias": "labelOn"; "required": false; "isSignal": true; }; "labelOff": { "alias": "labelOff"; "required": false; "isSignal": true; }; "iconOn": { "alias": "iconOn"; "required": false; "isSignal": true; }; "iconOff": { "alias": "iconOff"; "required": false; "isSignal": true; }; "cssClass": { "alias": "cssClass"; "required": false; "isSignal": true; }; "cssClassSmall": { "alias": "cssClassSmall"; "required": false; "isSignal": true; }; }, { "changed": "changed"; }, never, never, true, never>;
+export declare class ButtonToggleComponent {
+  /** Emitted each time the button is clicked. Carries the current `value` and the new `toggled` state. */
+  readonly changed: import("@angular/core").OutputEmitterRef<ButtonToggleInfo>;
+  /** Current value bound from the parent. Drives label and icon selection. */
+  readonly value: import("@angular/core").InputSignal<boolean>;
+  /** Width of the button in pixels. Use `-1` for automatic sizing. */
+  readonly width: import("@angular/core").InputSignal<number>;
+  /** Border thickness override in pixels. Use `-1` to inherit. */
+  readonly border: import("@angular/core").InputSignal<number>;
+  /** Label shown when `value` is `true`. */
+  readonly labelOn: import("@angular/core").InputSignal<string>;
+  /** Label shown when `value` is `false`. */
+  readonly labelOff: import("@angular/core").InputSignal<string>;
+  /** Material icon name shown when `value` is `true`. */
+  readonly iconOn: import("@angular/core").InputSignal<string>;
+  /** Material icon name shown when `value` is `false`. */
+  readonly iconOff: import("@angular/core").InputSignal<string>;
+  /** CSS class applied to the button at all breakpoints. */
+  readonly cssClass: import("@angular/core").InputSignal<string>;
+  /** CSS class applied to the button on `xs` screens. */
+  readonly cssClassSmall: import("@angular/core").InputSignal<string>;
+  /** Resolves the appropriate label for the current value state. */
+  protected readonly label: import("@angular/core").Signal<string>;
+  /** Resolves the appropriate icon name for the current value state. */
+  protected readonly icon: import("@angular/core").Signal<string>;
+  /**
+   * Toggles the button state and emits the `changed` event.
+   * The emitted `toggled` value is the logical inverse of the current `value`.
+   */
+  toggle(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ButtonToggleComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ButtonToggleComponent, "button-toggle", never, {
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "width": {
+      "alias": "width";
+      "required": false;
+      "isSignal": true;
+    };
+    "border": {
+      "alias": "border";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelOn": {
+      "alias": "labelOn";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelOff": {
+      "alias": "labelOff";
+      "required": false;
+      "isSignal": true;
+    };
+    "iconOn": {
+      "alias": "iconOn";
+      "required": false;
+      "isSignal": true;
+    };
+    "iconOff": {
+      "alias": "iconOff";
+      "required": false;
+      "isSignal": true;
+    };
+    "cssClass": {
+      "alias": "cssClass";
+      "required": false;
+      "isSignal": true;
+    };
+    "cssClassSmall": {
+      "alias": "cssClassSmall";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "changed": "changed";
+  }, never, never, true, never>;
 }
-
-declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor {
-    ngControl: NgControl;
-    /** Emitted when the selection changes. Carries the new array of selected items, or `undefined` when cleared. */
-    readonly changed: _angular_core.OutputEmitterRef<NameValueItem<any>[]>;
-    protected readonly containerId: string;
-    protected readonly containerWidth: _angular_core.WritableSignal<number>;
-    private focused;
-    private readonly stateChanges;
-    private readonly destroyRef;
-    private changesEnabled;
-    private destroyed;
-    private widthRetries;
-    /** Observer that tracks size changes of the container element. */
-    private resizeObserver?;
-    /** Debounce bridge for `ResizeObserver` notifications. */
-    private readonly resize$;
-    /** List of available options to display as chips. */
-    readonly options: _angular_core.InputSignal<NameValueItem<any>[]>;
-    /** Minimum width in pixels when collapsed. Use `-1` for automatic. */
-    readonly collapsedWidth: _angular_core.InputSignal<number>;
-    /** Display mode used when the selector is in collapsed state. */
-    readonly collapsedDisplayMode: _angular_core.InputSignal<"dropdown" | "button">;
-    /** Pixel threshold below which the selector collapses. Use `-1` to disable. */
-    readonly collapseAt: _angular_core.InputSignal<number>;
-    /** When `true`, `collapseAt` is compared against the container width rather than the window width. */
-    readonly collapseAtContainer: _angular_core.InputSignal<boolean>;
-    protected readonly collapsed: _angular_core.Signal<boolean>;
-    /** Label shown in the dropdown / above the chip list. */
-    readonly label: _angular_core.InputSignal<string>;
-    /** When `true`, multiple chips can be selected simultaneously. */
-    readonly multiple: _angular_core.InputSignal<boolean>;
-    /** When `true`, at least one item must remain selected. */
-    readonly mustSelect: _angular_core.InputSignal<boolean>;
-    /** Layout mode: `'collapsed'` forces dropdown mode, `'dynamic'` collapses based on `collapseAt`. */
-    readonly mode: _angular_core.InputSignal<"collapsed" | "dynamic">;
-    /** When `true`, chips are stacked vertically instead of wrapping horizontally. */
-    readonly stacked: _angular_core.InputSignal<boolean>;
-    /** Chips below this index receive extra padding to align with other UI elements. */
-    readonly padAt: _angular_core.InputSignal<number>;
-    /** When `true`, the control is required. */
-    readonly required: _angular_core.InputSignalWithTransform<boolean, unknown>;
-    /** Placeholder text shown when no value is selected. */
-    readonly placeholder: _angular_core.InputSignal<string>;
-    private _disabled;
-    get disabled(): boolean;
-    set disabled(value: boolean);
-    id: string;
-    describedBy: string;
-    /** True when the label should float above the field (focused or has a value). */
-    get shouldLabelFloat(): boolean;
-    private _value?;
-    set value(value: NameValueItem<any>[] | undefined);
-    /**
-     * Updates the internal state and selection mirrors.
-     * @param value     - The new selection array.
-     * @param propagate - When `true`, notifies the registered onChange callback.
-     */
-    private setValue;
-    /** The current value as an array of selected items. */
-    get value(): NameValueItem<any>[] | undefined;
-    /** True when no item is selected. */
-    get empty(): boolean;
-    /** True when the control has validation errors and has been touched. */
-    get errorState(): boolean;
-    private propagateChange;
-    private propagateTouched;
-    private readonly renderer;
-    private readonly cdr;
-    /**
-     * Currently selected items. Kept loosely typed on purpose: in multi-select mode the
-     * bound controls write an array, while in single-select mode mat-select / the chip
-     * listbox write a single item; `getSelection()` normalizes both shapes.
-     */
-    protected readonly selection: _angular_core.WritableSignal<any>;
-    /** The single selected item — used in `button` collapsed-display mode. */
-    protected readonly singleSelection: _angular_core.WritableSignal<NameValueItem<any>>;
-    /** Root signal form bound to the internal mat-select / chip listbox. */
-    protected readonly selectionForm: _angular_forms_signals.FieldTree<any, string | number, "writable">;
-    /** Root signal form bound to the internal button-selector in `button` collapsed mode. */
-    protected readonly singleForm: _angular_forms_signals.FieldTree<NameValueItem<any>, string | number, "writable">;
-    constructor(ngControl: NgControl);
-    ngOnDestroy(): void;
-    /**
-     * Measures the container (or window) width and updates the `containerWidth` signal,
-     * retrying after 100 ms if the element is not yet laid out.
-     */
-    private updateContainerWidth;
-    /**
-     * Resolves the effective selection array for the current display mode.
-     * In single-select collapsed button mode the `singleSelection` item is wrapped in an array.
-     * @returns The array of currently selected items.
-     */
-    private getSelection;
-    /**
-     * Schedules a value update after a short delay, coalescing rapid selection changes
-     * before the value is propagated to the outer form.
-     */
-    updateValue(): void;
-    /**
-     * Returns `true` when the given item can be selected in the current mode.
-     * In single-select mode an already-selected item is not re-selectable.
-     * @param item - The item to check.
-     * @returns True when the item is selectable.
-     */
-    isSelectable(item: NameValueItem<any>): boolean;
-    /**
-     * Writes a new value to the component (called by the form layer).
-     * @param value - The new selection to display.
-     */
-    writeValue(value: any): void;
-    /**
-     * Registers the on-change callback (called by the form layer).
-     * @param fn - Callback to invoke whenever the value changes.
-     */
-    registerOnChange(fn: (_: any) => void): void;
-    /**
-     * Registers the on-touched callback (called by the form layer).
-     * @param fn - Callback to invoke when the control is touched.
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Sets the ARIA described-by IDs for accessibility.
-     * @param ids - The list of element IDs to associate with this control.
-     */
-    setDescribedByIds(ids: string[]): void;
-    /**
-     * Updates the disabled state when the Angular form layer changes it.
-     * @param isDisabled - Whether the control should be disabled.
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /**
-     * Handles a click on the container element, focusing it and marking it as touched.
-     */
-    onContainerClick(): void;
-    /**
-     * Clears the current selection and stops the event from bubbling.
-     * @param e - The originating click event.
-     */
-    clear(e: Event): void;
-    /**
-     * Selects a single item, replacing any existing selection.
-     * @param item - The item to select. Does nothing when `undefined`.
-     */
-    select(item?: NameValueItem<any>): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ChipsSelectorComponent, [{ optional: true; self: true; }]>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ChipsSelectorComponent, "chips-selector", never, { "options": { "alias": "options"; "required": false; "isSignal": true; }; "collapsedWidth": { "alias": "collapsedWidth"; "required": false; "isSignal": true; }; "collapsedDisplayMode": { "alias": "collapsedDisplayMode"; "required": false; "isSignal": true; }; "collapseAt": { "alias": "collapseAt"; "required": false; "isSignal": true; }; "collapseAtContainer": { "alias": "collapseAtContainer"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "mustSelect": { "alias": "mustSelect"; "required": false; "isSignal": true; }; "mode": { "alias": "mode"; "required": false; "isSignal": true; }; "stacked": { "alias": "stacked"; "required": false; "isSignal": true; }; "padAt": { "alias": "padAt"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; }; }, { "changed": "changed"; }, never, never, true, never>;
-}
-
-export { ButtonSelectorComponent, ButtonToggleComponent, ChipsSelectorComponent };
-export type { ButtonToggleInfo };
+export declare class ChipsSelectorComponent implements OnDestroy, ControlValueAccessor {
+  ngControl: NgControl;
+  /** Emitted when the selection changes. Carries the new array of selected items, or `undefined` when cleared. */
+  readonly changed: import("@angular/core").OutputEmitterRef<NameValueItem<any>[]>;
+  protected readonly containerId: string;
+  protected readonly containerWidth: import("@angular/core").WritableSignal<number>;
+  private focused;
+  private readonly stateChanges;
+  private readonly destroyRef;
+  private changesEnabled;
+  private destroyed;
+  private widthRetries;
+  /** Observer that tracks size changes of the container element. */
+  private resizeObserver?;
+  /** Debounce bridge for `ResizeObserver` notifications. */
+  private readonly resize$;
+  /** List of available options to display as chips. */
+  readonly options: import("@angular/core").InputSignal<NameValueItem<any>[]>;
+  /** Minimum width in pixels when collapsed. Use `-1` for automatic. */
+  readonly collapsedWidth: import("@angular/core").InputSignal<number>;
+  /** Display mode used when the selector is in collapsed state. */
+  readonly collapsedDisplayMode: import("@angular/core").InputSignal<"dropdown" | "button">;
+  /** Pixel threshold below which the selector collapses. Use `-1` to disable. */
+  readonly collapseAt: import("@angular/core").InputSignal<number>;
+  /** When `true`, `collapseAt` is compared against the container width rather than the window width. */
+  readonly collapseAtContainer: import("@angular/core").InputSignal<boolean>;
+  protected readonly collapsed: import("@angular/core").Signal<boolean>;
+  /** Label shown in the dropdown / above the chip list. */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** When `true`, multiple chips can be selected simultaneously. */
+  readonly multiple: import("@angular/core").InputSignal<boolean>;
+  /** When `true`, at least one item must remain selected. */
+  readonly mustSelect: import("@angular/core").InputSignal<boolean>;
+  /** Layout mode: `'collapsed'` forces dropdown mode, `'dynamic'` collapses based on `collapseAt`. */
+  readonly mode: import("@angular/core").InputSignal<"dynamic" | "collapsed">;
+  /** When `true`, chips are stacked vertically instead of wrapping horizontally. */
+  readonly stacked: import("@angular/core").InputSignal<boolean>;
+  /** Chips below this index receive extra padding to align with other UI elements. */
+  readonly padAt: import("@angular/core").InputSignal<number>;
+  /** When `true`, the control is required. */
+  readonly required: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /** Placeholder text shown when no value is selected. */
+  readonly placeholder: import("@angular/core").InputSignal<string>;
+  private _disabled;
+  get disabled(): boolean;
+  set disabled(value: boolean);
+  id: string;
+  describedBy: string;
+  /** True when the label should float above the field (focused or has a value). */
+  get shouldLabelFloat(): boolean;
+  private _value?;
+  set value(value: NameValueItem<any>[] | undefined);
+  /**
+   * Updates the internal state and selection mirrors.
+   * @param value     - The new selection array.
+   * @param propagate - When `true`, notifies the registered onChange callback.
+   */
+  private setValue;
+  /** The current value as an array of selected items. */
+  get value(): NameValueItem<any>[] | undefined;
+  /** True when no item is selected. */
+  get empty(): boolean;
+  /** True when the control has validation errors and has been touched. */
+  get errorState(): boolean;
+  private propagateChange;
+  private propagateTouched;
+  private readonly renderer;
+  private readonly cdr;
+  /**
+   * Currently selected items. Kept loosely typed on purpose: in multi-select mode the
+   * bound controls write an array, while in single-select mode mat-select / the chip
+   * listbox write a single item; `getSelection()` normalizes both shapes.
+   */
+  protected readonly selection: import("@angular/core").WritableSignal<any>;
+  /** The single selected item — used in `button` collapsed-display mode. */
+  protected readonly singleSelection: import("@angular/core").WritableSignal<NameValueItem<any>>;
+  /** Root signal form bound to the internal mat-select / chip listbox. */
+  protected readonly selectionForm: import("@angular/forms/signals").FieldTree<any, string | number, "writable">;
+  /** Root signal form bound to the internal button-selector in `button` collapsed mode. */
+  protected readonly singleForm: import("@angular/forms/signals").FieldTree<NameValueItem<any>, string | number, "writable">;
+  constructor(ngControl: NgControl);
+  ngOnDestroy(): void;
+  /**
+   * Measures the container (or window) width and updates the `containerWidth` signal,
+   * retrying after 100 ms if the element is not yet laid out.
+   */
+  private updateContainerWidth;
+  /**
+   * Resolves the effective selection array for the current display mode.
+   * In single-select collapsed button mode the `singleSelection` item is wrapped in an array.
+   * @returns The array of currently selected items.
+   */
+  private getSelection;
+  /**
+   * Schedules a value update after a short delay, coalescing rapid selection changes
+   * before the value is propagated to the outer form.
+   */
+  updateValue(): void;
+  /**
+   * Returns `true` when the given item can be selected in the current mode.
+   * In single-select mode an already-selected item is not re-selectable.
+   * @param item - The item to check.
+   * @returns True when the item is selectable.
+   */
+  isSelectable(item: NameValueItem<any>): boolean;
+  /**
+   * Writes a new value to the component (called by the form layer).
+   * @param value - The new selection to display.
+   */
+  writeValue(value: any): void;
+  /**
+   * Registers the on-change callback (called by the form layer).
+   * @param fn - Callback to invoke whenever the value changes.
+   */
+  registerOnChange(fn: (_: any) => void): void;
+  /**
+   * Registers the on-touched callback (called by the form layer).
+   * @param fn - Callback to invoke when the control is touched.
+   */
+  registerOnTouched(fn: () => void): void;
+  /**
+   * Sets the ARIA described-by IDs for accessibility.
+   * @param ids - The list of element IDs to associate with this control.
+   */
+  setDescribedByIds(ids: string[]): void;
+  /**
+   * Updates the disabled state when the Angular form layer changes it.
+   * @param isDisabled - Whether the control should be disabled.
+   */
+  setDisabledState(isDisabled: boolean): void;
+  /**
+   * Handles a click on the container element, focusing it and marking it as touched.
+   */
+  onContainerClick(): void;
+  /**
+   * Clears the current selection and stops the event from bubbling.
+   * @param e - The originating click event.
+   */
+  clear(e: Event): void;
+  /**
+   * Selects a single item, replacing any existing selection.
+   * @param item - The item to select. Does nothing when `undefined`.
+   */
+  select(item?: NameValueItem<any>): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ChipsSelectorComponent, [{
+    optional: true;
+    self: true;
+  }]>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ChipsSelectorComponent, "chips-selector", never, {
+    "options": {
+      "alias": "options";
+      "required": false;
+      "isSignal": true;
+    };
+    "collapsedWidth": {
+      "alias": "collapsedWidth";
+      "required": false;
+      "isSignal": true;
+    };
+    "collapsedDisplayMode": {
+      "alias": "collapsedDisplayMode";
+      "required": false;
+      "isSignal": true;
+    };
+    "collapseAt": {
+      "alias": "collapseAt";
+      "required": false;
+      "isSignal": true;
+    };
+    "collapseAtContainer": {
+      "alias": "collapseAtContainer";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "multiple": {
+      "alias": "multiple";
+      "required": false;
+      "isSignal": true;
+    };
+    "mustSelect": {
+      "alias": "mustSelect";
+      "required": false;
+      "isSignal": true;
+    };
+    "mode": {
+      "alias": "mode";
+      "required": false;
+      "isSignal": true;
+    };
+    "stacked": {
+      "alias": "stacked";
+      "required": false;
+      "isSignal": true;
+    };
+    "padAt": {
+      "alias": "padAt";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+    };
+  }, {
+    "changed": "changed";
+  }, never, never, true, never>;
+}