@eagami/ui 5.56.0 → 5.57.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eagami/ui",
-  "version": "5.56.0",
+  "version": "5.57.0",
   "description": "Lightweight, accessible, themeable Angular UI component library and icon set built on CSS custom properties",
   "author": "Michal Wiraszka <michal@eagami.com>",
   "license": "MIT",

package/types/eagami-ui.d.ts

@@ -135,6 +135,10 @@ export interface EagamiMessages {
   };
   dropdown: {
     placeholder: string;
+    clear: string;
+    dialogLabel: string;
+    searchPlaceholder: string;
+    searchEmpty: string;
   };
   fieldLabel: {
     /** Accessible name of the button that reveals a field label's help. */
@@ -4146,12 +4150,16 @@ export type DropdownSize = EaSize;
  * Single-select dropdown with a custom popup list. Supports keyboard
  * navigation (arrow keys, Enter/Space to select, Escape to close), closes
  * on outside click or viewport scroll/resize, and integrates with Angular
- * forms via `ControlValueAccessor`. Positioning, dismissal, and SSR-safe
- * scroll handling are provided by `<ea-popover>`.
+ * forms via `ControlValueAccessor`. Optionally offers a clear button on the
+ * trigger and a search field above the options. Positioning, dismissal, and
+ * SSR-safe scroll handling are provided by `<ea-popover>`.
  */
 export declare class DropdownComponent implements ControlValueAccessor {
   private readonly elRef;
-  private readonly i18n;
+  private readonly popover;
+  private readonly searchEl;
+  protected readonly i18n: EagamiI18nService;
+  private readonly injector;
   readonly label: import("@angular/core").InputSignal<string | undefined>;
   /** Optional icon component rendered before the label text. */
   readonly labelIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
@@ -4164,16 +4172,21 @@ export declare class DropdownComponent implements ControlValueAccessor {
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
+  /** Shows a clear button on the trigger while an option is selected. */
+  readonly clearable: import("@angular/core").InputSignal<boolean>;
+  /** Adds a search field above the options that filters them as the user types. */
+  readonly searchable: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string | undefined>;
   readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
   /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
   readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string>> | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly value: import("@angular/core").ModelSignal<string>;
-  /** Fires with the new value when the user selects an option. */
+  /** Fires with the new value when the user selects an option or clears the selection. */
   readonly changed: import("@angular/core").OutputEmitterRef<string>;
   readonly isOpen: import("@angular/core").WritableSignal<boolean>;
   readonly focusedIndex: import("@angular/core").WritableSignal<number>;
+  protected readonly searchTerm: import("@angular/core").WritableSignal<string>;
   private readonly _formDisabled;
   private typeaheadQuery;
   private typeaheadTimer;
@@ -4189,21 +4202,29 @@ export declare class DropdownComponent implements ControlValueAccessor {
   private readonly optionGroups;
   /** Whether the consumer supplied groups, which the list exposes as ARIA groups. */
   protected readonly grouped: import("@angular/core").Signal<boolean>;
-  /** Every option in the order given, flattened across groups; drives all index maths. */
+  /** Every option in the order given, flattened across groups. */
   private readonly flatOptions;
-  /** Groups to render, each option carrying its index into the flattened list. */
+  private readonly filteredGroups;
+  /** Options matching the search text, flattened across groups; drives all index maths. */
+  protected readonly filteredOptions: import("@angular/core").Signal<SelectOption[]>;
+  /** Groups to render, each option carrying its index into the filtered list. */
   protected readonly renderedGroups: import("@angular/core").Signal<RenderedGroup[]>;
   protected readonly selectedIndex: import("@angular/core").Signal<number>;
   readonly selectedLabel: import("@angular/core").Signal<string>;
   /** Placeholder text, falling back to the active locale's translation. */
   readonly resolvedPlaceholder: import("@angular/core").Signal<string>;
   readonly triggerLabelledBy: import("@angular/core").Signal<string | null>;
+  protected readonly showClear: import("@angular/core").Signal<boolean>;
+  protected readonly listboxId: import("@angular/core").Signal<string>;
+  /** Id of the keyboard-focused option, for `aria-activedescendant`. */
+  protected readonly activeOptionId: import("@angular/core").Signal<string | null>;
   readonly triggerClasses: import("@angular/core").Signal<{
     [x: string]: boolean;
     'ea-dropdown__trigger--error': boolean;
     'ea-dropdown__trigger--open': boolean;
     'ea-dropdown__trigger--disabled': boolean;
     'ea-dropdown__trigger--readonly': boolean;
+    'ea-dropdown__trigger--clearable': boolean;
   }>;
   readonly menuClasses: import("@angular/core").Signal<{
     [x: string]: boolean;
@@ -4218,15 +4239,23 @@ export declare class DropdownComponent implements ControlValueAccessor {
   select(option: SelectOption): void;
   /** Closes the dropdown list without changing the current value. */
   close(): void;
+  protected clear(): void;
   /** Moves keyboard focus to the dropdown trigger. */
   focus(): void;
   /** Called by `<ea-popover>` when the user clicks outside the dropdown. */
   onPopoverCloseRequested(): void;
   handleKeydown(event: KeyboardEvent): void;
+  protected onSearchInput(term: string): void;
+  protected handleSearchKeydown(event: KeyboardEvent): void;
+  protected onMenuMousedown(event: MouseEvent): void;
+  private commit;
+  private startSearch;
+  private focusFirstMatch;
   private selectFocusedOrOpen;
   private focusEdge;
   /** Keeps the keyboard-focused option visible inside the scrolling listbox. */
   private setFocusedIndex;
+  private scrollOptionIntoView;
   private handleTypeahead;
   private moveFocus;
   static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
@@ -4276,6 +4305,16 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "clearable": {
+      "alias": "clearable";
+      "required": false;
+      "isSignal": true;
+    };
+    "searchable": {
+      "alias": "searchable";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7864,6 +7903,12 @@ export declare class TooltipDirective implements OnDestroy {
    * to the viewport, which no value can push the bubble past.
    */
   readonly maxWidth: import("@angular/core").InputSignal<number | undefined>;
+  /**
+   * Wait in ms before the bubble appears on hover or keyboard focus, so a
+   * pointer passing over the trigger does not flash it. Leaving the trigger
+   * within the wait cancels the bubble.
+   */
+  readonly showDelay: import("@angular/core").InputSignal<number>;
   /**
    * Grace period in ms before a bubble the viewport clamp made scrollable hides
    * after the pointer leaves, long enough to cross the gap onto the bubble and
@@ -7881,6 +7926,7 @@ export declare class TooltipDirective implements OnDestroy {
   private placedPosition;
   private templateView;
   private scrollable;
+  private showTimer;
   private hideTimer;
   private pointerInside;
   private readonly tooltipId;
@@ -7903,6 +7949,8 @@ export declare class TooltipDirective implements OnDestroy {
   private controlled;
   ngOnDestroy(): void;
   private syncPointerListeners;
+  private requestShow;
+  private cancelPendingShow;
   private show;
   private shrinkToContent;
   private requestHide;
@@ -7943,6 +7991,11 @@ export declare class TooltipDirective implements OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "showDelay": {
+      "alias": "showDelay";
+      "required": false;
+      "isSignal": true;
+    };
     "dismissDelay": {
       "alias": "dismissDelay";
       "required": false;