@eagami/ui 5.20.0 → 5.22.0

package/types/eagami-ui.d.ts

@@ -733,6 +733,7 @@ declare class AutocompleteComponent implements ControlValueAccessor {
         [x: string]: boolean;
         'ea-autocomplete__wrapper--error': boolean;
         'ea-autocomplete__wrapper--focused': boolean;
+        'ea-autocomplete__wrapper--readonly': boolean;
         'ea-autocomplete__wrapper--disabled': boolean;
     }>;
     readonly listboxClasses: _angular_core.Signal<{
@@ -1333,6 +1334,7 @@ declare class ColorPickerComponent implements ControlValueAccessor {
         'ea-color-picker__trigger--error': boolean;
         'ea-color-picker__trigger--open': boolean;
         'ea-color-picker__trigger--disabled': boolean;
+        'ea-color-picker__trigger--readonly': boolean;
     }>;
     readonly wrapperClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -1557,7 +1559,7 @@ declare class CodeInputComponent implements ControlValueAccessor {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<CodeInputComponent, "ea-code-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "allowAllChars": { "alias": "allowAllChars"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
 }
 
-/** Visual size of the date picker trigger. */
+/** Visual size of the date picker field. */
 type DatePickerSize = EaSize;
 /** Locale-aware date format used for the displayed value. */
 type DatePickerFormat = 'short' | 'medium' | 'long';
@@ -1575,17 +1577,21 @@ interface CalendarDay {
     isFocused: boolean;
 }
 /**
- * Calendar popover for selecting a single date. Supports `min`/`max` bounds,
- * configurable week start, locale-aware formatting via `Intl.DateTimeFormat`,
- * and full keyboard navigation (arrows, PageUp/PageDown, Home/End, Enter,
- * Escape). Integrates with Angular forms via `ControlValueAccessor`.
+ * Date field with a calendar popover. The date can be typed straight into the
+ * field in any reasonable shape (ISO, all-numeric in the locale's field order,
+ * or with a month name) and is rewritten in the configured `format` on commit.
+ * Supports `min`/`max` bounds, configurable week start, locale-aware formatting
+ * via `Intl.DateTimeFormat`, and full keyboard navigation (arrows,
+ * PageUp/PageDown, Home/End, Enter, Escape). Integrates with Angular forms via
+ * `ControlValueAccessor`.
  */
 declare class DatePickerComponent implements ControlValueAccessor {
-    protected readonly triggerEl: _angular_core.Signal<ElementRef<HTMLButtonElement> | undefined>;
+    protected readonly fieldEl: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
+    protected readonly inputEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     private readonly injector;
     protected readonly i18n: EagamiI18nService;
     readonly label: _angular_core.InputSignal<string | undefined>;
-    /** Placeholder shown when no date is selected. Defaults to the active locale's text. */
+    /** Placeholder shown in the field when no date is selected. */
     readonly placeholder: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<EaSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -1609,6 +1615,9 @@ declare class DatePickerComponent implements ControlValueAccessor {
     readonly viewMonth: _angular_core.WritableSignal<number>;
     readonly focusedDate: _angular_core.WritableSignal<Date | null>;
     private readonly _formDisabled;
+    private readonly isFocused;
+    /** Entry in progress, held verbatim until it is committed or abandoned. */
+    private readonly draft;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
@@ -1628,23 +1637,23 @@ declare class DatePickerComponent implements ControlValueAccessor {
      *  Some browsers ship a reduced ICU that silently falls back to English for
      *  less common locales, so a matching request is not a given. */
     private readonly intlLocalizesEffectiveLocale;
-    /** Placeholder text: explicit `placeholder` input, else the active locale's default. */
+    /** Placeholder text, empty unless a `placeholder` is given. */
     readonly resolvedPlaceholder: _angular_core.Signal<string>;
+    /** Accessible name when no `label` is given. */
+    protected readonly fallbackLabel: _angular_core.Signal<string>;
     readonly dialogId: _angular_core.Signal<string>;
-    readonly triggerLabelledBy: _angular_core.Signal<string | null>;
-    readonly triggerClasses: _angular_core.Signal<{
-        [x: string]: boolean;
-        'ea-date-picker__trigger--error': boolean;
-        'ea-date-picker__trigger--open': boolean;
-        'ea-date-picker__trigger--disabled': boolean;
-    }>;
-    readonly wrapperClasses: _angular_core.Signal<{
-        [x: string]: boolean;
+    readonly fieldClasses: _angular_core.Signal<{
+        'ea-date-picker__field--focused': boolean;
+        'ea-date-picker__field--error': boolean;
+        'ea-date-picker__field--disabled': boolean;
+        'ea-date-picker__field--readonly': boolean;
     }>;
     readonly popoverClasses: _angular_core.Signal<{
         [x: string]: boolean;
     }>;
     readonly displayValue: _angular_core.Signal<string>;
+    /** Field text: the entry in progress while typing, else the formatted value. */
+    readonly inputText: _angular_core.Signal<string>;
     readonly monthYearLabel: _angular_core.Signal<string>;
     readonly weekdayLabels: _angular_core.Signal<string[]>;
     readonly weeks: _angular_core.Signal<CalendarDay[][]>;
@@ -1659,7 +1668,7 @@ declare class DatePickerComponent implements ControlValueAccessor {
     /** Closes the calendar popover. */
     close(): void;
     private focusFocusedDayCell;
-    /** Moves keyboard focus to the trigger button. */
+    /** Moves keyboard focus to the date field. */
     focus(): void;
     selectDay(day: CalendarDay): void;
     /** Clears the selected date and emits `changed` with `null`. */
@@ -1676,7 +1685,13 @@ declare class DatePickerComponent implements ControlValueAccessor {
      */
     private pullFocusIntoView;
     goToToday(): void;
-    handleTriggerKeydown(event: KeyboardEvent): void;
+    protected onInput(event: Event): void;
+    protected onInputFocus(): void;
+    protected onInputBlur(): void;
+    protected handleInputKeydown(event: KeyboardEvent): void;
+    private commitDraft;
+    private applyValue;
+    private isOutOfRange;
     handleGridKeydown(event: KeyboardEvent): void;
     /** Called by `<ea-popover>` when the user clicks outside the picker. */
     onPopoverCloseRequested(): void;
@@ -1901,6 +1916,7 @@ declare class DropdownComponent implements ControlValueAccessor {
         'ea-dropdown__trigger--error': boolean;
         'ea-dropdown__trigger--open': boolean;
         'ea-dropdown__trigger--disabled': boolean;
+        'ea-dropdown__trigger--readonly': boolean;
     }>;
     readonly menuClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -2094,6 +2110,11 @@ declare class FileUploaderComponent implements ControlValueAccessor {
     readonly size: _angular_core.InputSignal<EaSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly required: _angular_core.InputSignal<boolean>;
+    /**
+     * Whether a selection adds to the current files or replaces them. Defaults
+     * to `true`: picking a second file appends it rather than swapping it in, so
+     * a single-file field has to set this to `false` explicitly.
+     */
     readonly multiple: _angular_core.InputSignal<boolean>;
     /** Comma-separated MIME types and / or file extensions, e.g. `'image/*,.pdf'`. */
     readonly accept: _angular_core.InputSignal<string | undefined>;
@@ -2116,6 +2137,12 @@ declare class FileUploaderComponent implements ControlValueAccessor {
     readonly rejected: _angular_core.OutputEmitterRef<readonly FileUploaderRejection[]>;
     /** Fires whenever a file is removed via its row's X button. */
     readonly fileRemoved: _angular_core.OutputEmitterRef<File>;
+    /**
+     * Fires when a drag enters or leaves the dropzone. The component consumes
+     * the drag events it handles, so a wrapper tracking its own drag styling
+     * reads the state from here rather than from the DOM.
+     */
+    readonly dragOverChanged: _angular_core.OutputEmitterRef<boolean>;
     protected readonly isDragOver: _angular_core.WritableSignal<boolean>;
     protected readonly isFocused: _angular_core.WritableSignal<boolean>;
     private readonly _formDisabled;
@@ -2150,9 +2177,11 @@ declare class FileUploaderComponent implements ControlValueAccessor {
     protected onDropzoneFocus(): void;
     protected onDropzoneBlur(): void;
     protected onFileSelected(event: Event): void;
+    protected onDragEnter(event: DragEvent): void;
     protected onDragOver(event: DragEvent): void;
     protected onDragLeave(event: DragEvent): void;
     protected onDrop(event: DragEvent): void;
+    private setDragOver;
     protected removeFile(file: File): void;
     private acceptFiles;
     protected formatBytes(bytes: number): string;
@@ -2161,7 +2190,7 @@ declare class FileUploaderComponent implements ControlValueAccessor {
     /** Stable track key for the `@for` over `value()`. */
     protected trackFile(_index: number, file: File): string;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FileUploaderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploaderComponent, "ea-file-uploader", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "showFileList": { "alias": "showFileList"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "rejected": "rejected"; "fileRemoved": "fileRemoved"; }, never, ["[icon]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FileUploaderComponent, "ea-file-uploader", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "multiple": { "alias": "multiple"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxSize": { "alias": "maxSize"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "showFileList": { "alias": "showFileList"; "required": false; "isSignal": true; }; "progress": { "alias": "progress"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "rejected": "rejected"; "fileRemoved": "fileRemoved"; "dragOverChanged": "dragOverChanged"; }, never, ["[icon]"], true, never>;
 }
 
 /** Visual size of the input. */
@@ -2379,6 +2408,169 @@ declare class MenuTriggerDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuTriggerDirective, "[eaMenuTrigger]", never, { "menu": { "alias": "eaMenuTrigger"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/**
+ * Placement of the popover relative to its anchor. Each placement names the
+ * side of the anchor the popover attaches to, optionally followed by a corner
+ * suffix (`-start` or `-end`) that decides the alignment along the perpendicular
+ * axis. The plain side names (`top`, `bottom`, `left`, `right`) centre the
+ * popover on that axis.
+ */
+type PopoverPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';
+interface PopoverPositionResult {
+    /** Top coordinate in viewport (px); pairs with `position: fixed`. */
+    readonly top: number;
+    /** Left coordinate in viewport (px). */
+    readonly left: number;
+    /** Width hint when the popover should match the anchor's width. */
+    readonly width?: number;
+    /** The anchor's measured width, for a caller capping the popover against it. */
+    readonly anchorWidth: number;
+    /** Effective placement after any flip logic ran. */
+    readonly placement: PopoverPlacement;
+}
+interface PopoverPositionOptions {
+    readonly placement: PopoverPlacement;
+    /** Gap in px between the anchor and the popover. Default 4. */
+    readonly offset?: number;
+    /** Flip to the opposite side when the requested side overflows the viewport. Default true. */
+    readonly flip?: boolean;
+    /** Clamp inside the viewport when the popover still overflows after any flip. Default true. */
+    readonly clamp?: boolean;
+    /** Margin from the viewport edge in px when clamping. Default 8. */
+    readonly margin?: number;
+    /** Set the popover's width to match the anchor's. Useful for dropdown-style menus. */
+    readonly matchAnchorWidth?: boolean;
+    /** Right-to-left context. Swaps `-start`/`-end` alignment so they track the reading direction. */
+    readonly rtl?: boolean;
+}
+interface Rect {
+    readonly width: number;
+    readonly height: number;
+}
+interface AnchorRect extends Rect {
+    readonly top: number;
+    readonly bottom: number;
+    readonly left: number;
+    readonly right: number;
+}
+interface Viewport {
+    readonly width: number;
+    readonly height: number;
+}
+/**
+ * Computes the viewport-space top/left for a popover anchored to `anchorRect`,
+ * applying optional flip-on-overflow and edge-clamp logic. Pure function, no
+ * DOM access. Both `<ea-popover>` and `[eaTooltip]` consume this.
+ *
+ * @param anchorRect  The anchor element's `getBoundingClientRect()`.
+ * @param popoverRect Width and height of the popover (post-render measurement).
+ * @param viewport    Viewport dimensions (`window.innerWidth/Height`).
+ * @param options     Placement and behavior flags.
+ */
+declare function computePopoverPosition(anchorRect: AnchorRect, popoverRect: Rect, viewport: Viewport, options: PopoverPositionOptions): PopoverPositionResult;
+
+/** ARIA role to apply to the popover surface. */
+type PopoverRole = 'menu' | 'listbox' | 'dialog' | 'tooltip' | 'grid';
+/**
+ * How the popover should respond to scroll / resize events while open.
+ *
+ * - `reposition` (default): re-measure the anchor and update the popover's
+ *   coordinates so it stays attached. Suitable for menus and tooltips.
+ * - `close`: request close. Suitable for dropdown lists and the colour-picker
+ *   popover, where re-tracking a tall popover during a scroll feels intrusive.
+ * - `ignore`: do nothing. The popover stays at its initial coordinates and
+ *   may visually detach from a scrolling anchor; useful when the anchor is
+ *   guaranteed not to move (e.g. inside a non-scrolling region).
+ */
+type PopoverScrollBehavior = 'reposition' | 'close' | 'ignore';
+/** Width cap for a popover surface: px, or the anchor's own width. */
+type PopoverMaxWidth = number | 'anchor';
+/**
+ * Floating-element primitive. Renders projected content as `position: fixed`
+ * anchored to an external element, with flip-on-overflow, viewport clamping,
+ * outside-click and Escape dismissal, and SSR-safe scroll / resize handling.
+ *
+ * The primitive is intentionally low-level: a parent component drives the
+ * `[open]` state and listens for `(closeRequested)` to mirror it back. Internal
+ * library components (`<ea-menu>`, `<ea-dropdown>`, `<ea-color-picker>`,
+ * `<ea-date-picker>`, `[eaTooltip]`) compose on top of it; downstream apps can
+ * use it directly to build their own popover-based UI.
+ *
+ * @example
+ * ```html
+ * <button #trigger (click)="open.set(!open())">Open</button>
+ * <ea-popover [anchor]="trigger" [open]="open()" (closeRequested)="open.set(false)">
+ *   <div>Popover content</div>
+ * </ea-popover>
+ * ```
+ */
+declare class PopoverComponent {
+    private readonly destroyRef;
+    private readonly surfaceEl;
+    /** Anchor element the popover positions itself against. */
+    readonly anchor: _angular_core.InputSignal<HTMLElement | ElementRef<HTMLElement> | undefined>;
+    /** Whether the popover is currently open. */
+    readonly open: _angular_core.InputSignal<boolean>;
+    /** Where the popover attaches relative to the anchor. */
+    readonly placement: _angular_core.InputSignal<PopoverPlacement>;
+    /** ARIA role applied to the popover surface. */
+    readonly role: _angular_core.InputSignal<PopoverRole>;
+    /** Accessible label. Falls back to nothing; consumers should provide one when no visible heading is in the popover. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    /** Id of the element that labels the popover surface, forwarded as `aria-labelledby`. */
+    readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
+    /** Keep Tab and Shift+Tab cycling within the surface while open (dialog pattern). */
+    readonly trapFocus: _angular_core.InputSignal<boolean>;
+    /** DOM id for the surface so trigger elements can reference it via aria-controls. */
+    readonly surfaceId: _angular_core.InputSignal<string>;
+    /**
+     * Gap in px between the anchor and the popover. Defaults to 2 so an open panel
+     * clears the anchor's active focus ring instead of sitting flush over it.
+     */
+    readonly offset: _angular_core.InputSignal<number>;
+    /** Flip to the opposite side when the requested side overflows the viewport. */
+    readonly flip: _angular_core.InputSignal<boolean>;
+    /** Clamp the popover inside the viewport when it would otherwise overflow. */
+    readonly clamp: _angular_core.InputSignal<boolean>;
+    /** Set the popover's `min-width` to match the anchor's width (dropdown pattern). */
+    readonly matchAnchorWidth: _angular_core.InputSignal<boolean>;
+    /**
+     * Widest the surface may grow: a px value, or `anchor` to cap it at the
+     * anchor's own width so long content truncates instead of widening the panel.
+     */
+    readonly maxWidth: _angular_core.InputSignal<PopoverMaxWidth | undefined>;
+    /** Close on click outside the popover and the anchor. */
+    readonly closeOnOutsideClick: _angular_core.InputSignal<boolean>;
+    /** Close on Escape. */
+    readonly closeOnEscape: _angular_core.InputSignal<boolean>;
+    /** What to do on scroll / resize while open. */
+    readonly scrollBehavior: _angular_core.InputSignal<PopoverScrollBehavior>;
+    /** Requested close. The parent should mirror this into `[open]`. */
+    readonly closeRequested: _angular_core.OutputEmitterRef<void>;
+    private readonly position;
+    /** True placement after flip, for class-based styling (e.g. arrow direction). */
+    readonly effectivePlacement: _angular_core.Signal<PopoverPlacement>;
+    /** Latches true once the post-rAF reposition has run, so the surface is
+     * only revealed after its dimensions are guaranteed stable. Reset on close. */
+    private readonly stable;
+    /** True once the first `reposition()` has resolved a placement on a
+     * laid-out surface. Drives the `--positioned` class. */
+    readonly isPositioned: _angular_core.Signal<boolean>;
+    /** Class list for the surface. Computed in TS so the placement key (with
+     * its interpolated suffix) and the positioned modifier compose cleanly. */
+    readonly surfaceClass: _angular_core.Signal<string>;
+    /** Inline style applied to the surface element. */
+    readonly surfaceStyle: _angular_core.Signal<Record<string, string>>;
+    constructor();
+    private resolveAnchor;
+    private reposition;
+    onDocumentClick(event: MouseEvent): void;
+    onSurfaceKeydown(event: KeyboardEvent): void;
+    onEscape(event: Event): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "ea-popover", never, { "anchor": { "alias": "anchor"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "trapFocus": { "alias": "trapFocus"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; "flip": { "alias": "flip"; "required": false; "isSignal": true; }; "clamp": { "alias": "clamp"; "required": false; "isSignal": true; }; "matchAnchorWidth": { "alias": "matchAnchorWidth"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "closeOnOutsideClick": { "alias": "closeOnOutsideClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "scrollBehavior": { "alias": "scrollBehavior"; "required": false; "isSignal": true; }; }, { "closeRequested": "closeRequested"; }, never, ["*"], true, never>;
+}
+
 /** Visual size of the multi-select trigger. */
 type MultiSelectSize = EaSize;
 /**
@@ -2390,10 +2582,14 @@ type MultiSelectSize = EaSize;
  * integrates with Angular forms via `ControlValueAccessor`.
  */
 declare class MultiSelectComponent implements ControlValueAccessor {
+    protected readonly wrapperEl: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
     protected readonly triggerEl: _angular_core.Signal<ElementRef<HTMLElement> | undefined>;
     protected readonly searchEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
+    private readonly listEl;
+    private readonly optionLabelEls;
     protected readonly i18n: EagamiI18nService;
     private readonly injector;
+    private readonly destroyRef;
     readonly label: _angular_core.InputSignal<string | undefined>;
     /** Accessible name for the combobox when no visible `label` is set. */
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
@@ -2414,6 +2610,16 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     readonly selectAll: _angular_core.InputSignal<boolean>;
     /** Max number of chips shown inside the trigger; the rest collapse into a "+N more" pill. `0` removes the cap so every chip shows and the row scrolls horizontally. */
     readonly maxVisibleChips: _angular_core.InputSignal<number>;
+    /**
+     * Widest a selected-value chip may grow, in px; a longer label ellipsizes
+     * and reveals its full text in a tooltip.
+     */
+    readonly maxChipWidth: _angular_core.InputSignal<number | undefined>;
+    /**
+     * Widest the option popover may grow: a px value, or `anchor` to hold it to
+     * the field's own width so a long option truncates instead of widening it.
+     */
+    readonly popoverMaxWidth: _angular_core.InputSignal<PopoverMaxWidth>;
     readonly id: _angular_core.InputSignal<string>;
     /** Selected option values, in the original options order. */
     readonly value: _angular_core.ModelSignal<readonly string[]>;
@@ -2461,6 +2667,7 @@ declare class MultiSelectComponent implements ControlValueAccessor {
         'ea-multi-select__trigger--error': boolean;
         'ea-multi-select__trigger--open': boolean;
         'ea-multi-select__trigger--disabled': boolean;
+        'ea-multi-select__trigger--readonly': boolean;
         'ea-multi-select__trigger--placeholder': boolean;
     }>;
     readonly menuClasses: _angular_core.Signal<{
@@ -2469,6 +2676,9 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     readonly wrapperClasses: _angular_core.Signal<{
         [x: string]: boolean;
     }>;
+    /** Values whose rendered option label is currently clipped by the panel. */
+    protected readonly clippedOptions: _angular_core.WritableSignal<ReadonlySet<string>>;
+    constructor();
     writeValue(val: readonly string[] | null | undefined): void;
     registerOnChange(fn: (value: readonly string[]) => void): void;
     registerOnTouched(fn: () => void): void;
@@ -2519,8 +2729,15 @@ declare class MultiSelectComponent implements ControlValueAccessor {
     private orderedValues;
     private resetEditState;
     private commit;
+    /**
+     * Re-reads which option labels are clipped. The result is written back only
+     * when the set actually differs, since an unconditional write would render,
+     * re-measure, and write again forever.
+     */
+    private measureClippedOptions;
+    private watchListWidth;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ea-multi-select", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MultiSelectComponent, "ea-multi-select", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "searchPlaceholder": { "alias": "searchPlaceholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "errorMessages": { "alias": "errorMessages"; "required": false; "isSignal": true; }; "searchable": { "alias": "searchable"; "required": false; "isSignal": true; }; "selectAll": { "alias": "selectAll"; "required": false; "isSignal": true; }; "maxVisibleChips": { "alias": "maxVisibleChips"; "required": false; "isSignal": true; }; "maxChipWidth": { "alias": "maxChipWidth"; "required": false; "isSignal": true; }; "popoverMaxWidth": { "alias": "popoverMaxWidth"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
 /** Visual size of the number input. */
@@ -2666,160 +2883,6 @@ declare class PaginatorComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginatorComponent, "ea-paginator", never, { "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSizeSelector": { "alias": "showPageSizeSelector"; "required": false; "isSignal": true; }; "showRangeLabel": { "alias": "showRangeLabel"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "groupThousands": { "alias": "groupThousands"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "pageSize": "pageSizeChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
-/**
- * Placement of the popover relative to its anchor. Each placement names the
- * side of the anchor the popover attaches to, optionally followed by a corner
- * suffix (`-start` or `-end`) that decides the alignment along the perpendicular
- * axis. The plain side names (`top`, `bottom`, `left`, `right`) centre the
- * popover on that axis.
- */
-type PopoverPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'right';
-interface PopoverPositionResult {
-    /** Top coordinate in viewport (px); pairs with `position: fixed`. */
-    readonly top: number;
-    /** Left coordinate in viewport (px). */
-    readonly left: number;
-    /** Width hint when the popover should match the anchor's width. */
-    readonly width?: number;
-    /** Effective placement after any flip logic ran. */
-    readonly placement: PopoverPlacement;
-}
-interface PopoverPositionOptions {
-    readonly placement: PopoverPlacement;
-    /** Gap in px between the anchor and the popover. Default 4. */
-    readonly offset?: number;
-    /** Flip to the opposite side when the requested side overflows the viewport. Default true. */
-    readonly flip?: boolean;
-    /** Clamp inside the viewport when the popover still overflows after any flip. Default true. */
-    readonly clamp?: boolean;
-    /** Margin from the viewport edge in px when clamping. Default 8. */
-    readonly margin?: number;
-    /** Set the popover's width to match the anchor's. Useful for dropdown-style menus. */
-    readonly matchAnchorWidth?: boolean;
-    /** Right-to-left context. Swaps `-start`/`-end` alignment so they track the reading direction. */
-    readonly rtl?: boolean;
-}
-interface Rect {
-    readonly width: number;
-    readonly height: number;
-}
-interface AnchorRect extends Rect {
-    readonly top: number;
-    readonly bottom: number;
-    readonly left: number;
-    readonly right: number;
-}
-interface Viewport {
-    readonly width: number;
-    readonly height: number;
-}
-/**
- * Computes the viewport-space top/left for a popover anchored to `anchorRect`,
- * applying optional flip-on-overflow and edge-clamp logic. Pure function, no
- * DOM access. Both `<ea-popover>` and `[eaTooltip]` consume this.
- *
- * @param anchorRect  The anchor element's `getBoundingClientRect()`.
- * @param popoverRect Width and height of the popover (post-render measurement).
- * @param viewport    Viewport dimensions (`window.innerWidth/Height`).
- * @param options     Placement and behavior flags.
- */
-declare function computePopoverPosition(anchorRect: AnchorRect, popoverRect: Rect, viewport: Viewport, options: PopoverPositionOptions): PopoverPositionResult;
-
-/** ARIA role to apply to the popover surface. */
-type PopoverRole = 'menu' | 'listbox' | 'dialog' | 'tooltip' | 'grid';
-/**
- * How the popover should respond to scroll / resize events while open.
- *
- * - `reposition` (default): re-measure the anchor and update the popover's
- *   coordinates so it stays attached. Suitable for menus and tooltips.
- * - `close`: request close. Suitable for dropdown lists and the colour-picker
- *   popover, where re-tracking a tall popover during a scroll feels intrusive.
- * - `ignore`: do nothing. The popover stays at its initial coordinates and
- *   may visually detach from a scrolling anchor; useful when the anchor is
- *   guaranteed not to move (e.g. inside a non-scrolling region).
- */
-type PopoverScrollBehavior = 'reposition' | 'close' | 'ignore';
-/**
- * Floating-element primitive. Renders projected content as `position: fixed`
- * anchored to an external element, with flip-on-overflow, viewport clamping,
- * outside-click and Escape dismissal, and SSR-safe scroll / resize handling.
- *
- * The primitive is intentionally low-level: a parent component drives the
- * `[open]` state and listens for `(closeRequested)` to mirror it back. Internal
- * library components (`<ea-menu>`, `<ea-dropdown>`, `<ea-color-picker>`,
- * `<ea-date-picker>`, `[eaTooltip]`) compose on top of it; downstream apps can
- * use it directly to build their own popover-based UI.
- *
- * @example
- * ```html
- * <button #trigger (click)="open.set(!open())">Open</button>
- * <ea-popover [anchor]="trigger" [open]="open()" (closeRequested)="open.set(false)">
- *   <div>Popover content</div>
- * </ea-popover>
- * ```
- */
-declare class PopoverComponent {
-    private readonly destroyRef;
-    private readonly surfaceEl;
-    /** Anchor element the popover positions itself against. */
-    readonly anchor: _angular_core.InputSignal<HTMLElement | ElementRef<HTMLElement> | undefined>;
-    /** Whether the popover is currently open. */
-    readonly open: _angular_core.InputSignal<boolean>;
-    /** Where the popover attaches relative to the anchor. */
-    readonly placement: _angular_core.InputSignal<PopoverPlacement>;
-    /** ARIA role applied to the popover surface. */
-    readonly role: _angular_core.InputSignal<PopoverRole>;
-    /** Accessible label. Falls back to nothing; consumers should provide one when no visible heading is in the popover. */
-    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
-    /** Id of the element that labels the popover surface, forwarded as `aria-labelledby`. */
-    readonly ariaLabelledby: _angular_core.InputSignal<string | undefined>;
-    /** Keep Tab and Shift+Tab cycling within the surface while open (dialog pattern). */
-    readonly trapFocus: _angular_core.InputSignal<boolean>;
-    /** DOM id for the surface so trigger elements can reference it via aria-controls. */
-    readonly surfaceId: _angular_core.InputSignal<string>;
-    /**
-     * Gap in px between the anchor and the popover. Defaults to 2 so an open panel
-     * clears the anchor's active focus ring instead of sitting flush over it.
-     */
-    readonly offset: _angular_core.InputSignal<number>;
-    /** Flip to the opposite side when the requested side overflows the viewport. */
-    readonly flip: _angular_core.InputSignal<boolean>;
-    /** Clamp the popover inside the viewport when it would otherwise overflow. */
-    readonly clamp: _angular_core.InputSignal<boolean>;
-    /** Set the popover's `min-width` to match the anchor's width (dropdown pattern). */
-    readonly matchAnchorWidth: _angular_core.InputSignal<boolean>;
-    /** Close on click outside the popover and the anchor. */
-    readonly closeOnOutsideClick: _angular_core.InputSignal<boolean>;
-    /** Close on Escape. */
-    readonly closeOnEscape: _angular_core.InputSignal<boolean>;
-    /** What to do on scroll / resize while open. */
-    readonly scrollBehavior: _angular_core.InputSignal<PopoverScrollBehavior>;
-    /** Requested close. The parent should mirror this into `[open]`. */
-    readonly closeRequested: _angular_core.OutputEmitterRef<void>;
-    private readonly position;
-    /** True placement after flip, for class-based styling (e.g. arrow direction). */
-    readonly effectivePlacement: _angular_core.Signal<PopoverPlacement>;
-    /** Latches true once the post-rAF reposition has run, so the surface is
-     * only revealed after its dimensions are guaranteed stable. Reset on close. */
-    private readonly stable;
-    /** True once the first `reposition()` has resolved a placement on a
-     * laid-out surface. Drives the `--positioned` class. */
-    readonly isPositioned: _angular_core.Signal<boolean>;
-    /** Class list for the surface. Computed in TS so the placement key (with
-     * its interpolated suffix) and the positioned modifier compose cleanly. */
-    readonly surfaceClass: _angular_core.Signal<string>;
-    /** Inline style applied to the surface element. */
-    readonly surfaceStyle: _angular_core.Signal<Record<string, string>>;
-    constructor();
-    private resolveAnchor;
-    private reposition;
-    onDocumentClick(event: MouseEvent): void;
-    onSurfaceKeydown(event: KeyboardEvent): void;
-    onEscape(event: Event): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<PopoverComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PopoverComponent, "ea-popover", never, { "anchor": { "alias": "anchor"; "required": true; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "role": { "alias": "role"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaLabelledby": { "alias": "aria-labelledby"; "required": false; "isSignal": true; }; "trapFocus": { "alias": "trapFocus"; "required": false; "isSignal": true; }; "surfaceId": { "alias": "surfaceId"; "required": false; "isSignal": true; }; "offset": { "alias": "offset"; "required": false; "isSignal": true; }; "flip": { "alias": "flip"; "required": false; "isSignal": true; }; "clamp": { "alias": "clamp"; "required": false; "isSignal": true; }; "matchAnchorWidth": { "alias": "matchAnchorWidth"; "required": false; "isSignal": true; }; "closeOnOutsideClick": { "alias": "closeOnOutsideClick"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "scrollBehavior": { "alias": "scrollBehavior"; "required": false; "isSignal": true; }; }, { "closeRequested": "closeRequested"; }, never, ["*"], true, never>;
-}
-
 /** Semantic colour scheme of the progress bar. */
 type ProgressBarVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /** Visual height of the progress bar. */
@@ -3441,23 +3504,94 @@ declare class TabsComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ea-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; "changed": "changed"; }, never, ["*"], true, never>;
 }
 
+/** Placement of the tooltip relative to its host element. */
+type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Attaches a positioned tooltip to its host element. Shows on hover and
+ * focus, hides on leave/blur or Escape, and wires up `aria-describedby` so
+ * the tooltip text is announced to assistive technology. Accepts either a
+ * plain string or a `TemplateRef` for styled multi-part content. Binding an
+ * empty string suppresses the bubble, which is how a host shows one only in
+ * some states (a label that is currently truncated, say).
+ *
+ * The directive listens on `focusin`, not `focus`, so it fires for a focusable
+ * descendant of the host as well as the host itself. A host listener paired
+ * with `eaTooltip` has to use `focusin` for the same reason: `focus` does not
+ * bubble, so it never fires when the focus lands on a child.
+ */
+declare class TooltipDirective implements OnDestroy {
+    private readonly el;
+    private readonly renderer;
+    private readonly viewContainer;
+    readonly eaTooltip: _angular_core.InputSignal<string | TemplateRef<unknown>>;
+    readonly tooltipPosition: _angular_core.InputSignal<TooltipPosition>;
+    /** Max width in px; the text wraps at this width. Clamped to a 50px floor. */
+    readonly maxWidth: _angular_core.InputSignal<number | undefined>;
+    private tooltipEl;
+    private templateView;
+    private readonly tooltipId;
+    private readonly hoverMql;
+    private readonly showHandler;
+    private readonly hideHandler;
+    private readonly supportsFocusVisible;
+    private readonly focusHandler;
+    private readonly keydownHandler;
+    private readonly hoverChangeHandler;
+    private rafId;
+    private readonly repositionHandler;
+    private readonly scrollListenerOptions;
+    private resizeObserver;
+    constructor();
+    ngOnDestroy(): void;
+    private syncPointerListeners;
+    private show;
+    private shrinkToContent;
+    private hide;
+    private attachRepositionListeners;
+    private detachRepositionListeners;
+    private appendDescribedBy;
+    private removeDescribedBy;
+    private positionTooltip;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[eaTooltip]", never, { "eaTooltip": { "alias": "eaTooltip"; "required": true; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+
 /** Semantic colour scheme of a tag. */
 type TagVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /** Visual size of a tag. */
 type TagSize = EaSize;
+/** Where a clipped label reveals its full text, or `none` to suppress it. */
+type TagTooltip = 'above' | 'below' | 'none';
 /**
  * Inline label commonly used to represent filters, categories, or selected
  * items. When `removable`, renders a close button that emits `removed`; the
  * accessible name of that button is configurable via `removeLabel` and
  * otherwise falls back to the active locale's translation.
+ *
+ * The projected label is capped by `maxWidth` (or the `--ea-tag-max-width`
+ * custom property) and ellipsizes rather than widening the chip, revealing its
+ * full text in a tooltip while it is clipped.
  */
 declare class TagComponent {
     private readonly i18n;
+    private readonly destroyRef;
+    private readonly labelEl;
     readonly variant: _angular_core.InputSignal<TagVariant>;
     readonly size: _angular_core.InputSignal<EaSize>;
     readonly removable: _angular_core.InputSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly removeLabel: _angular_core.InputSignal<string | undefined>;
+    /**
+     * Widest the chip may grow, in px; a longer label ellipsizes instead. Also
+     * settable in CSS as `--ea-tag-max-width`, which this input overrides.
+     */
+    readonly maxWidth: _angular_core.InputSignal<number | undefined>;
+    /**
+     * Where a label clipped by `maxWidth` reveals its full text. Set `none` for
+     * a tag rendered inside a tooltip, which would otherwise stack a second
+     * bubble over the first.
+     */
+    readonly tooltip: _angular_core.InputSignal<TagTooltip>;
     /**
      * Whether the remove button is a tab stop. Set `false` inside a composite
      * widget (a combobox trigger, a grid cell) whose own keyboard model owns
@@ -3466,15 +3600,27 @@ declare class TagComponent {
     readonly removeTabbable: _angular_core.InputSignal<boolean>;
     /** Fires when the user activates the remove button on a `removable` tag. */
     readonly removed: _angular_core.OutputEmitterRef<void>;
+    /** Full label text, held only while the rendered label is clipped. */
+    private readonly clippedText;
     /** Accessible label for the remove button, falling back to the active locale. */
     readonly resolvedRemoveLabel: _angular_core.Signal<string>;
+    /** Tooltip text for the label; empty suppresses the bubble entirely. */
+    protected readonly labelTooltip: _angular_core.Signal<string>;
+    protected readonly tooltipPosition: _angular_core.Signal<TooltipPosition>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
         'ea-tag--disabled': boolean;
     }>;
+    constructor();
     onRemove(event: MouseEvent): void;
+    /**
+     * Keeps `clippedText` in step with the rendered label. Size and text are
+     * watched separately because a capped chip holds its width when the text
+     * behind the ellipsis changes, so a resize alone would leave stale text.
+     */
+    private watchLabel;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "ea-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "removeTabbable": { "alias": "removeTabbable"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "ea-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; "tooltip": { "alias": "tooltip"; "required": false; "isSignal": true; }; "removeTabbable": { "alias": "removeTabbable"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
 
 /** Visual size of the textarea. */
@@ -3643,6 +3789,7 @@ declare class TimePickerComponent implements ControlValueAccessor {
         'ea-time-picker__trigger--error': boolean;
         'ea-time-picker__trigger--open': boolean;
         'ea-time-picker__trigger--disabled': boolean;
+        'ea-time-picker__trigger--readonly': boolean;
         'ea-time-picker__trigger--placeholder': boolean;
     }>;
     readonly wrapperClasses: _angular_core.Signal<{
@@ -3777,6 +3924,8 @@ type ToastVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 interface Toast {
     id: number;
     message: string;
+    /** Heading shown above the message; the message steps back when set. */
+    title?: string;
     variant: ToastVariant;
     duration: number;
     /** Icon component rendered in place of the variant's own; `null` renders none. */
@@ -3784,6 +3933,8 @@ interface Toast {
 }
 /** Optional configuration for a toast; defaults to `default` variant and 4s duration. */
 interface ToastOptions {
+    /** Heading shown above the message; the message steps back when set. */
+    title?: string;
     variant?: ToastVariant;
     duration?: number;
     /** Any icon component to render in place of the variant's own; `null` for no icon. */
@@ -3860,51 +4011,6 @@ declare class ToastComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ea-toast", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "clearable": { "alias": "clearable"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-/** Placement of the tooltip relative to its host element. */
-type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
-/**
- * Attaches a positioned tooltip to its host element. Shows on hover and
- * focus, hides on leave/blur or Escape, and wires up `aria-describedby` so
- * the tooltip text is announced to assistive technology. Accepts either a
- * plain string or a `TemplateRef` for styled multi-part content.
- */
-declare class TooltipDirective implements OnDestroy {
-    private readonly el;
-    private readonly renderer;
-    private readonly viewContainer;
-    readonly eaTooltip: _angular_core.InputSignal<string | TemplateRef<unknown>>;
-    readonly tooltipPosition: _angular_core.InputSignal<TooltipPosition>;
-    /** Max width in px; the text wraps at this width. Clamped to a 50px floor. */
-    readonly maxWidth: _angular_core.InputSignal<number | undefined>;
-    private tooltipEl;
-    private templateView;
-    private readonly tooltipId;
-    private readonly hoverMql;
-    private readonly showHandler;
-    private readonly hideHandler;
-    private readonly supportsFocusVisible;
-    private readonly focusHandler;
-    private readonly keydownHandler;
-    private readonly hoverChangeHandler;
-    private rafId;
-    private readonly repositionHandler;
-    private readonly scrollListenerOptions;
-    private resizeObserver;
-    constructor();
-    ngOnDestroy(): void;
-    private syncPointerListeners;
-    private show;
-    private shrinkToContent;
-    private hide;
-    private attachRepositionListeners;
-    private detachRepositionListeners;
-    private appendDescribedBy;
-    private removeDescribedBy;
-    private positionTooltip;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[eaTooltip]", never, { "eaTooltip": { "alias": "eaTooltip"; "required": true; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; "maxWidth": { "alias": "maxWidth"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
 /**
  * A single transferable item in an `<ea-transfer-list>`.
  *
@@ -7677,4 +7783,4 @@ declare class ZoomOutIconComponent extends IconComponentBase {
 }
 
 export { AccordionComponent, AccordionItemComponent, ActivityIconComponent, AirplayIconComponent, AlertCircleIconComponent, AlertComponent, AlertOctagonIconComponent, AlertTriangleIconComponent, AlignCenterIconComponent, AlignJustifyIconComponent, AlignLeftIconComponent, AlignRightIconComponent, AnchorIconComponent, AndroidIconComponent, AngularIconComponent, AnthropicIconComponent, ApertureIconComponent, ArchiveIconComponent, ArrowDownCircleIconComponent, ArrowDownIconComponent, ArrowDownLeftIconComponent, ArrowDownRightIconComponent, ArrowLeftCircleIconComponent, ArrowLeftIconComponent, ArrowRightCircleIconComponent, ArrowRightIconComponent, ArrowUpCircleIconComponent, ArrowUpIconComponent, ArrowUpLeftIconComponent, ArrowUpRightIconComponent, AspectRatioIconComponent, AtSignIconComponent, AutocompleteComponent, AvatarComponent, AvatarEditorComponent, AwardIconComponent, BadgeCheckIconComponent, BadgeComponent, BarChart2IconComponent, BarChartIconComponent, BatteryChargingIconComponent, BatteryIconComponent, BellIconComponent, BellOffIconComponent, BellRingIconComponent, BitcoinIconComponent, BlueskyIconComponent, BluetoothIconComponent, BoldIconComponent, BookIconComponent, BookOpenIconComponent, BookmarkCheckIconComponent, BookmarkIconComponent, BookmarkPlusIconComponent, BotIconComponent, BottleIconComponent, BoxIconComponent, BrainIconComponent, BreadcrumbsComponent, BriefcaseIconComponent, BugIconComponent, BuildingIconComponent, ButtonComponent, CalculatorIconComponent, CalendarCheckIconComponent, CalendarDaysIconComponent, CalendarIconComponent, CameraIconComponent, CameraOffIconComponent, CandleIconComponent, CardComponent, CastIconComponent, CheckCircleIconComponent, CheckIconComponent, CheckSquareIconComponent, CheckboxComponent, ChevronDownIconComponent, ChevronLeftIconComponent, ChevronRightIconComponent, ChevronUpIconComponent, ChevronsDownIconComponent, ChevronsLeftIconComponent, ChevronsRightIconComponent, ChevronsUpDownIconComponent, ChevronsUpIconComponent, ChromeIconComponent, CircleIconComponent, ClapperboardIconComponent, ClipboardCheckIconComponent, ClipboardIconComponent, ClipboardListIconComponent, ClockIconComponent, CloudDrizzleIconComponent, CloudIconComponent, CloudLightningIconComponent, CloudOffIconComponent, CloudRainIconComponent, CloudSnowIconComponent, CloudflareIconComponent, CodeIconComponent, CodeInputComponent, CodepenIconComponent, CodesandboxIconComponent, CoffeeIconComponent, CoinsIconComponent, ColorPickerComponent, ColumnsIconComponent, CommandIconComponent, CommandPaletteComponent, CompassIconComponent, CopyIconComponent, CornerDownLeftIconComponent, CornerDownRightIconComponent, CornerLeftDownIconComponent, CornerLeftUpIconComponent, CornerRightDownIconComponent, CornerRightUpIconComponent, CornerUpLeftIconComponent, CornerUpRightIconComponent, CpuIconComponent, CreditCardIconComponent, CropIconComponent, CrosshairIconComponent, DEFAULT_PALETTE_ROLES, DataTableComponent, DatabaseIconComponent, DatePickerComponent, DeleteIconComponent, DialogComponent, DiscIconComponent, DiscordIconComponent, DivideCircleIconComponent, DivideIconComponent, DivideSquareIconComponent, DividerComponent, DockerIconComponent, DollarSignIconComponent, DownloadCloudIconComponent, DownloadIconComponent, DrawerComponent, DribbbleIconComponent, DropboxIconComponent, DropdownComponent, DropletIconComponent, EAGAMI_ALL_LOCALES, EAGAMI_I18N_CONFIG, EAGAMI_LOCALES, EAGAMI_LOCALE_META, EagamiI18nService, EagamiIconComponent, EagamiWordmarkComponent, Edit2IconComponent, Edit3IconComponent, EditIconComponent, EmptyStateComponent, ExternalLinkIconComponent, EyeIconComponent, EyeOffIconComponent, Facebook2IconComponent, FacebookIconComponent, FastForwardIconComponent, FeatherIconComponent, FieldLabelComponent, FieldMessagesComponent, Figma2IconComponent, FigmaIconComponent, FileAudioIconComponent, FileCheckIconComponent, FileIconComponent, FileImageIconComponent, FileMinusIconComponent, FilePdfIconComponent, FilePlusIconComponent, FileTextIconComponent, FileUploaderComponent, FileVideoIconComponent, FilmIconComponent, FilterIconComponent, FilterXIconComponent, FingerprintIconComponent, FlagIconComponent, FlameIconComponent, FolderIconComponent, FolderMinusIconComponent, FolderOpenIconComponent, FolderPlusIconComponent, FormFieldComponent, FramerIconComponent, FrownIconComponent, GaugeIconComponent, GeminiIconComponent, GiftIconComponent, GitBranchIconComponent, GitCommitIconComponent, GitCompareIconComponent, GitMergeIconComponent, GitPullRequestIconComponent, Github2IconComponent, GithubIconComponent, GitlabIconComponent, GlobeIconComponent, GoogleIconComponent, GridIconComponent, HalfCircleIconComponent, HalfHeartIconComponent, HardDriveIconComponent, HashIconComponent, HeadphonesIconComponent, HeartIconComponent, HelpCircleIconComponent, HeptagonIconComponent, HexagonIconComponent, HistoryIconComponent, HomeIconComponent, ICONS, IconComponentBase, ImageIconComponent, ImagesIconComponent, InboxIconComponent, InfoIconComponent, InputComponent, InstagramIconComponent, ItalicIconComponent, KeyIconComponent, KeyboardIconComponent, KeyframeIconComponent, KubernetesIconComponent, LampIconComponent, LanguagesIconComponent, LayersIconComponent, LayoutIconComponent, LeafIconComponent, LeftHalfStarIconComponent, LifeBuoyIconComponent, LightbulbIconComponent, Link2IconComponent, LinkIconComponent, Linkedin2IconComponent, LinkedinIconComponent, ListChecksIconComponent, ListIconComponent, LoaderIconComponent, LockIconComponent, LogInIconComponent, LogOutIconComponent, MailCheckIconComponent, MailIconComponent, MapIconComponent, MapPinIconComponent, MastercardIconComponent, Maximize2IconComponent, MaximizeIconComponent, MegaphoneIconComponent, MehIconComponent, MenuComponent, MenuIconComponent, MenuItemComponent, MenuTriggerDirective, MessageCircleIconComponent, MessageSquareIconComponent, MicIconComponent, MicOffIconComponent, MicrosoftIconComponent, Minimize2IconComponent, MinimizeIconComponent, MinusCircleIconComponent, MinusIconComponent, MinusSquareIconComponent, MongodbIconComponent, MonitorIconComponent, MoonIconComponent, MoreHorizontalIconComponent, MoreVerticalIconComponent, MousePointerIconComponent, MoveIconComponent, MultiSelectComponent, MusicIconComponent, Navigation2IconComponent, NavigationIconComponent, NetlifyIconComponent, NodejsIconComponent, NotionIconComponent, NpmIconComponent, NumberInputComponent, OctagonIconComponent, PackageIconComponent, PaginatorComponent, PaletteIconComponent, PaperclipIconComponent, PauseCircleIconComponent, PauseIconComponent, PaypalIconComponent, PenToolIconComponent, PentagonIconComponent, PercentIconComponent, PhoneCallIconComponent, PhoneForwardedIconComponent, PhoneIconComponent, PhoneIncomingIconComponent, PhoneMissedIconComponent, PhoneOffIconComponent, PhoneOutgoingIconComponent, PictureInPictureIconComponent, PieChartIconComponent, PinIconComponent, PinterestIconComponent, PlayCircleIconComponent, PlayIconComponent, PlaylistIconComponent, PlugIconComponent, PlusCircleIconComponent, PlusIconComponent, PlusSquareIconComponent, PocketIconComponent, PopoverComponent, PowerIconComponent, PrinterIconComponent, ProgressBarComponent, PythonIconComponent, QrCodeIconComponent, RadioComponent, RadioGroupComponent, RadioIconComponent, RangeSliderComponent, RatingComponent, ReactIconComponent, ReceiptIconComponent, RecordIconComponent, RectangleHorizontalIconComponent, RectangleVerticalIconComponent, RedditIconComponent, RedoIconComponent, RefreshCcwIconComponent, RefreshCwIconComponent, RepeatIconComponent, RewindIconComponent, RightHalfStarIconComponent, RocketIconComponent, RotateCcwIconComponent, RotateCwIconComponent, RssIconComponent, SaveIconComponent, ScanIconComponent, ScissorsIconComponent, SearchIconComponent, SegmentedComponent, SendIconComponent, ServerIconComponent, SettingsIconComponent, ShareIconComponent, ShieldCheckIconComponent, ShieldIconComponent, ShieldOffIconComponent, ShopifyIconComponent, ShoppingBagIconComponent, ShoppingCartIconComponent, ShuffleIconComponent, SidebarIconComponent, SkeletonComponent, SkipBackIconComponent, SkipForwardIconComponent, Slack2IconComponent, SlackIconComponent, SlashIconComponent, SliderComponent, SlidersIconComponent, SmartphoneIconComponent, SmileIconComponent, SnowflakeIconComponent, SoccerBallIconComponent, SparklesIconComponent, SpeakerIconComponent, SpinnerComponent, SpotifyIconComponent, SquareIconComponent, StarIconComponent, StepComponent, StepperComponent, StopCircleIconComponent, StripeIconComponent, SubtitlesIconComponent, SunIconComponent, SunriseIconComponent, SunsetIconComponent, SvelteIconComponent, SwitchComponent, TabComponent, TableIconComponent, TabletIconComponent, TabsComponent, TagComponent, TagIconComponent, TailwindIconComponent, TargetIconComponent, TelegramIconComponent, TerminalIconComponent, TextareaComponent, ThermometerIconComponent, ThreadsIconComponent, ThumbsDownIconComponent, ThumbsUpIconComponent, TiktokIconComponent, TimePickerComponent, TimecodeIconComponent, TimelineComponent, TimerIconComponent, ToastComponent, ToastService, ToggleLeftIconComponent, ToggleRightIconComponent, ToolIconComponent, TooltipDirective, TranscodeIconComponent, TransferListComponent, Trash2IconComponent, TrashIconComponent, TreeComponent, TrelloIconComponent, TrendingDownIconComponent, TrendingUpIconComponent, TriangleIconComponent, TrimIconComponent, TrophyIconComponent, TruckIconComponent, TvIconComponent, Twitch2IconComponent, TwitchIconComponent, TwitterIconComponent, TypeIconComponent, UmbrellaIconComponent, UnderlineIconComponent, UndoIconComponent, UnlockIconComponent, UploadCloudIconComponent, UploadIconComponent, UserCheckIconComponent, UserIconComponent, UserMinusIconComponent, UserPlusIconComponent, UserXIconComponent, UsersIconComponent, VercelIconComponent, VideoIconComponent, VideoOffIconComponent, VirtualListComponent, VoicemailIconComponent, Volume1IconComponent, Volume2IconComponent, VolumeIconComponent, VolumeXIconComponent, VueIconComponent, WCAG_AA, WalletIconComponent, WandIconComponent, WatchIconComponent, WaveformIconComponent, WhatsappIconComponent, WifiIconComponent, WifiOffIconComponent, WindIconComponent, WordpressIconComponent, XCircleIconComponent, XIconComponent, XOctagonIconComponent, XSquareIconComponent, XTwitterIconComponent, Youtube2IconComponent, YoutubeIconComponent, ZapIconComponent, ZapOffIconComponent, ZoomInIconComponent, ZoomOutIconComponent, applyPalette, ar, computePopoverPosition, contrastRatio, de, derivePalette, el, en, esES, formatViolations, frFR, frenchSpacing, he, hexToOklch, hi, iconDisplayName, is, nl, oklchToHex, pl, provideEagamiUi, ptBR, relativeLuminance, ru, uk, validatePalette, visibleNodeIds, walkTree, zhCN };
-export type { AccordionHeadingLevel, AccordionSize, AlertSize, AlertVariant, AutocompleteSize, AvatarEditorCropEvent, AvatarEditorCropState, AvatarEditorShape, AvatarShape, AvatarSize, BadgeShape, BadgeSize, BadgeVariant, BreadcrumbClickEvent, BreadcrumbItem, BreadcrumbsSeparator, BreadcrumbsSize, ButtonSize, ButtonType, ButtonVariant, CardHeaderAlign, CardPadding, CardVariant, CheckboxSize, CodeInputSize, ColorPickerFormat, ColorPickerInputMode, ColorPickerSize, ColorPickerValue, CommandPaletteItem, ContrastSurfaces, ContrastViolation, DataTableColumn, DataTableDensity, DataTableSize, DataTableSortDirection, DataTableSortState, DatePickerFormat, DatePickerSize, DatePickerValue, DatePickerWeekStart, DerivedPalette, DialogWidth, DividerOrientation, DrawerAnimation, DrawerMode, DrawerPosition, DrawerSize, DropdownSize, EaErrorMessages, EaSize, EaValidationErrorKey, EaWidth, EagamiI18nConfig, EagamiLocale, EagamiLocaleBundle, EagamiLocaleLoader, EagamiLocaleMeta, EagamiMessages, EagamiMessagesOverride, EagamiPaletteConfig, EagamiUiConfig, EagamiWordmarkLayout, EagamiWordmarkVariant, EmptyStateHeadingLevel, EmptyStateSize, FileUploaderRejection, FileUploaderRejectionReason, FileUploaderSize, FormFieldSize, IconCategory, IconComponentType, IconMeta, InputSize, InputType, MenuItemVariant, MenuPlacement, MenuSize, ModePalette, ModeSurfaces, MultiSelectSize, NumberInputSize, PaginatorAlign, PaginatorSize, PaginatorState, PaletteConfig, PaletteRoles, PaletteShade, PopoverPlacement, PopoverPositionOptions, PopoverPositionResult, PopoverRole, PopoverScrollBehavior, ProgressBarSize, ProgressBarVariant, RadioOrientation, RadioSize, RangeSliderSize, RangeSliderValue, RatingSize, RatingStarState, SegmentedSize, SelectOption, SkeletonVariant, SliderSize, SpinnerSize, StepperOrientation, StepperSize, SwitchSize, TabsSize, TabsVariant, TagSize, TagVariant, TextareaResize, TextareaSize, TimePickerFormat, TimePickerSize, TimelineAlign, TimelineItem, TimelineItemColor, TimelineOrientation, TimelineSize, Toast, ToastOptions, ToastPosition, ToastSize, ToastVariant, TooltipPosition, TransferListItem, TransferListSize, TreeNode, TreeSize, VirtualListItemContext };
+export type { AccordionHeadingLevel, AccordionSize, AlertSize, AlertVariant, AutocompleteSize, AvatarEditorCropEvent, AvatarEditorCropState, AvatarEditorShape, AvatarShape, AvatarSize, BadgeShape, BadgeSize, BadgeVariant, BreadcrumbClickEvent, BreadcrumbItem, BreadcrumbsSeparator, BreadcrumbsSize, ButtonSize, ButtonType, ButtonVariant, CardHeaderAlign, CardPadding, CardVariant, CheckboxSize, CodeInputSize, ColorPickerFormat, ColorPickerInputMode, ColorPickerSize, ColorPickerValue, CommandPaletteItem, ContrastSurfaces, ContrastViolation, DataTableColumn, DataTableDensity, DataTableSize, DataTableSortDirection, DataTableSortState, DatePickerFormat, DatePickerSize, DatePickerValue, DatePickerWeekStart, DerivedPalette, DialogWidth, DividerOrientation, DrawerAnimation, DrawerMode, DrawerPosition, DrawerSize, DropdownSize, EaErrorMessages, EaSize, EaValidationErrorKey, EaWidth, EagamiI18nConfig, EagamiLocale, EagamiLocaleBundle, EagamiLocaleLoader, EagamiLocaleMeta, EagamiMessages, EagamiMessagesOverride, EagamiPaletteConfig, EagamiUiConfig, EagamiWordmarkLayout, EagamiWordmarkVariant, EmptyStateHeadingLevel, EmptyStateSize, FileUploaderRejection, FileUploaderRejectionReason, FileUploaderSize, FormFieldSize, IconCategory, IconComponentType, IconMeta, InputSize, InputType, MenuItemVariant, MenuPlacement, MenuSize, ModePalette, ModeSurfaces, MultiSelectSize, NumberInputSize, PaginatorAlign, PaginatorSize, PaginatorState, PaletteConfig, PaletteRoles, PaletteShade, PopoverMaxWidth, PopoverPlacement, PopoverPositionOptions, PopoverPositionResult, PopoverRole, PopoverScrollBehavior, ProgressBarSize, ProgressBarVariant, RadioOrientation, RadioSize, RangeSliderSize, RangeSliderValue, RatingSize, RatingStarState, SegmentedSize, SelectOption, SkeletonVariant, SliderSize, SpinnerSize, StepperOrientation, StepperSize, SwitchSize, TabsSize, TabsVariant, TagSize, TagTooltip, TagVariant, TextareaResize, TextareaSize, TimePickerFormat, TimePickerSize, TimelineAlign, TimelineItem, TimelineItemColor, TimelineOrientation, TimelineSize, Toast, ToastOptions, ToastPosition, ToastSize, ToastVariant, TooltipPosition, TransferListItem, TransferListSize, TreeNode, TreeSize, VirtualListItemContext };