@eagami/ui 5.53.0 → 5.54.0

package/types/eagami-ui.d.ts

@@ -136,6 +136,10 @@ export interface EagamiMessages {
   dropdown: {
     placeholder: string;
   };
+  fieldLabel: {
+    /** Accessible name of the button that reveals a field label's help. */
+    help: (label: string) => string;
+  };
   fileUploader: {
     prompt: string;
     promptSingle: string;
@@ -613,13 +617,19 @@ export type EaSize = '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 export type EaWidth = EaSize | '2xl' | 'full';
 /**
  * Single expandable section within an `ea-accordion`. Each item exposes a
- * header button with the supplied `label` and reveals its projected content
+ * header button with the supplied `label`, or with an element projected as
+ * `slot="label"` for richer content, and reveals its other projected content
  * when expanded. Inherits its size from the parent accordion. Must be
  * rendered inside an `ea-accordion`.
  */
 export declare class AccordionItemComponent implements OnInit, OnDestroy {
   private readonly accordion;
   readonly value: import("@angular/core").InputSignal<string>;
+  /**
+   * Plain-text label shown in the header button. For richer content, project
+   * an element with `slot="label"` instead: its text then names the button, so
+   * mark purely decorative parts of it `aria-hidden`.
+   */
   readonly label: import("@angular/core").InputSignal<string>;
   /** Optional icon component rendered before the label in the header button. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
@@ -641,7 +651,7 @@ export declare class AccordionItemComponent implements OnInit, OnDestroy {
     };
     "label": {
       "alias": "label";
-      "required": true;
+      "required": false;
       "isSignal": true;
     };
     "icon": {
@@ -659,7 +669,7 @@ export declare class AccordionItemComponent implements OnInit, OnDestroy {
       "required": false;
       "isSignal": true;
     };
-  }, {}, never, ["*"], true, never>;
+  }, {}, never, ["[slot=label]", "*"], true, never>;
 }
 /** Heading level exposed by each item's header for assistive technology. */
 export type AccordionHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
@@ -668,7 +678,9 @@ export type AccordionSize = EaSize;
 /**
  * Container for expandable content sections. By default only one item can be
  * open at a time; set `multi` to allow several to stay expanded together.
- * Provides a built-in chevron animation and supports per-item disabling.
+ * Which items are open is the `expandedValues` model, so items can start
+ * expanded or be controlled from outside. Provides a built-in chevron
+ * animation and supports per-item disabling.
  */
 export declare class AccordionComponent {
   readonly multi: import("@angular/core").InputSignal<boolean>;
@@ -678,6 +690,12 @@ export declare class AccordionComponent {
   readonly headingLevel: import("@angular/core").InputSignal<AccordionHeadingLevel>;
   /** Tints an open item's header and sets its label, icon, and chevron in the brand color. */
   readonly highlightExpanded: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Values of the expanded items. Set it to open items from the start, or bind
+   * `[(expandedValues)]` to control expansion from outside. Without `multi`,
+   * only the first of them in document order stays open.
+   */
+  readonly expandedValues: import("@angular/core").ModelSignal<readonly string[]>;
   readonly expandedItems: import("@angular/core").WritableSignal<Set<string>>;
   readonly registeredItems: import("@angular/core").WritableSignal<AccordionItemComponent[]>;
   constructor();
@@ -707,16 +725,25 @@ export declare class AccordionComponent {
       "required": false;
       "isSignal": true;
     };
-  }, {}, never, ["*"], true, never>;
+    "expandedValues": {
+      "alias": "expandedValues";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "expandedValues": "expandedValuesChange";
+  }, never, ["*"], true, never>;
 }
 /** Semantic colour scheme of an alert. Drives icon and palette. */
 export type AlertVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /** Scales the alert's text, icon, and gap together. */
 export type AlertSize = EaSize;
+/** How assistive technology announces an alert. */
+export type AlertLive = 'auto' | 'assertive' | 'polite' | 'off';
 /**
  * Inline banner for surfacing semantic messages such as success confirmations,
  * warnings, or errors. Optionally dismissible, with a two-way `visible`
- * binding and an automatically chosen ARIA role based on severity.
+ * binding and an ARIA role chosen by severity unless `live` sets one.
  */
 export declare class AlertComponent {
   protected readonly i18n: EagamiI18nService;
@@ -726,12 +753,20 @@ export declare class AlertComponent {
   readonly visible: import("@angular/core").ModelSignal<boolean>;
   /** Overrides the variant's default status icon with any icon component. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
+  /**
+   * How assistive technology announces the alert. `auto` interrupts for
+   * `error` and `warning` (`role="alert"`) and waits its turn for the rest
+   * (`role="status"`); `assertive` and `polite` pick one of those whatever the
+   * variant, and `off` announces nothing, for static text that is part of the
+   * page rather than news about it.
+   */
+  readonly live: import("@angular/core").InputSignal<AlertLive>;
   /** Fires when the user dismisses the alert via its close button. */
   readonly dismissed: import("@angular/core").OutputEmitterRef<void>;
   readonly alertClasses: import("@angular/core").Signal<{
     [x: string]: boolean;
   }>;
-  readonly role: import("@angular/core").Signal<"alert" | "status">;
+  readonly role: import("@angular/core").Signal<"alert" | "status" | null>;
   /** Hides the alert and emits `dismissed`. */
   dismiss(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<AlertComponent, never>;
@@ -761,6 +796,11 @@ export declare class AlertComponent {
       "required": false;
       "isSignal": true;
     };
+    "live": {
+      "alias": "live";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "visible": "visibleChange";
     "dismissed": "dismissed";
@@ -834,6 +874,8 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Accessible name for the input and suggestion list when no visible label is provided. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
@@ -848,6 +890,8 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   /** 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 minLength: import("@angular/core").InputSignal<number>;
+  /** Maximum number of characters the input accepts (native `maxlength`). */
+  readonly maxLength: import("@angular/core").InputSignal<number | undefined>;
   readonly maxResults: import("@angular/core").InputSignal<number>;
   readonly emptyMessage: import("@angular/core").InputSignal<string | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
@@ -922,6 +966,11 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -977,6 +1026,11 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "maxLength": {
+      "alias": "maxLength";
+      "required": false;
+      "isSignal": true;
+    };
     "maxResults": {
       "alias": "maxResults";
       "required": false;
@@ -1681,19 +1735,29 @@ export declare class BreadcrumbsComponent {
     "clicked": "clicked";
   }, never, never, true, never>;
 }
-/** Visual style of a button; drives colour and emphasis. */
-export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
+/**
+ * Visual style of a button; drives colour and emphasis. `link` drops the box
+ * for an inline text link in the link colour, underlined on hover and focus.
+ */
+export type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger' | 'link';
 /** Visual size of a button. */
 export type ButtonSize = EaSize;
 /** HTML `type` attribute applied to the underlying `<button>` element. */
 export type ButtonType = 'button' | 'submit' | 'reset';
 /**
- * Standard action button supporting primary, secondary, ghost, and danger
- * variants. Includes a loading state that swaps the label for a spinner while
- * preserving the rendered width. Chrome is tunable per instance via
+ * Placement of a button's content along its inline axis when the button is
+ * wider than its content. `start` and `end` follow the text direction.
+ */
+export type ButtonAlign = 'start' | 'center' | 'end';
+/**
+ * Standard action button supporting primary, secondary, ghost, danger, and
+ * link variants. Includes a loading state that swaps the label for a spinner
+ * while preserving the rendered width. Chrome is tunable per instance via
  * `--ea-button-padding`, `--ea-button-min-height` and `--ea-button-radius`,
  * which is how an icon-only button comes down to little more than its glyph
- * and how a call-to-action becomes a pill.
+ * and how a call-to-action becomes a pill. For navigation, put
+ * `ButtonLinkComponent` on an anchor instead (`<a eaButtonLink href="...">`):
+ * it takes the same styling inputs and keeps real link behaviour.
  */
 export declare class ButtonComponent {
   readonly variant: import("@angular/core").InputSignal<ButtonVariant>;
@@ -1702,22 +1766,28 @@ export declare class ButtonComponent {
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Places the content along the inline axis of a button wider than it, as a
+   * full-width one is; `start` lets a stack of buttons read as list rows.
+   */
+  readonly align: import("@angular/core").InputSignal<ButtonAlign>;
   readonly uppercase: import("@angular/core").InputSignal<boolean>;
   /** Optional icon component rendered to the left of the label. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly ariaCurrent: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements whose text names the button. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements that describe the button, e.g. a hint. */
+  readonly ariaDescribedby: import("@angular/core").InputSignal<string | undefined>;
+  private readonly buttonEl;
   /** Fires when the button is activated; suppressed while disabled or loading. */
   readonly clicked: import("@angular/core").OutputEmitterRef<MouseEvent>;
   readonly isDisabled: import("@angular/core").Signal<boolean>;
-  readonly hostClasses: import("@angular/core").Signal<{
-    [x: string]: boolean;
-    'ea-button--full-width': boolean;
-    'ea-button--uppercase': boolean;
-    'ea-button--loading': boolean;
-    'ea-button--disabled': boolean;
-  }>;
+  readonly hostClasses: import("@angular/core").Signal<Record<string, boolean>>;
   handleClick(event: MouseEvent): void;
+  /** Moves keyboard focus to the underlying native button. */
+  focus(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "ea-button", never, {
     "variant": {
@@ -1750,6 +1820,11 @@ export declare class ButtonComponent {
       "required": false;
       "isSignal": true;
     };
+    "align": {
+      "alias": "align";
+      "required": false;
+      "isSignal": true;
+    };
     "uppercase": {
       "alias": "uppercase";
       "required": false;
@@ -1770,10 +1845,88 @@ export declare class ButtonComponent {
       "required": false;
       "isSignal": true;
     };
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaDescribedby": {
+      "alias": "aria-describedby";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "clicked": "clicked";
   }, never, ["[slot=prefix]", "*", "[slot=suffix]"], true, never>;
 }
+/**
+ * Button styling for an anchor, for navigation that should look like a button
+ * while staying a real link: middle-click and open in a new tab work, and
+ * assistive technology announces it as a link. Put it on an `<a>` with an
+ * `href`, or with Angular's `routerLink`, which binds the `href` itself
+ * (`<a eaButtonLink routerLink="/pricing">`). Takes the same styling inputs as
+ * `ea-button` and is painted by the same stylesheet.
+ *
+ * `disabled` sets `aria-disabled`, takes the link out of the tab order, and
+ * blocks activation before `routerLink` or any `(click)` handler sees it, so
+ * nothing navigates. There is no loading state: a link hands off to the
+ * browser or router, so there is no in-flight action for a spinner to cover.
+ */
+export declare class ButtonLinkComponent {
+  protected readonly authoredTabindex: string | null;
+  readonly variant: import("@angular/core").InputSignal<ButtonVariant>;
+  readonly size: import("@angular/core").InputSignal<import("@eagami/ui").EaSize>;
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  readonly fullWidth: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Places the content along the inline axis of a link wider than it, as a
+   * full-width one is; `start` lets a stack of links read as list rows.
+   */
+  readonly align: import("@angular/core").InputSignal<ButtonAlign>;
+  readonly uppercase: import("@angular/core").InputSignal<boolean>;
+  /** Optional icon component rendered before the label. */
+  readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
+  protected readonly boxClasses: import("@angular/core").Signal<Record<string, boolean>>;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<ButtonLinkComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ButtonLinkComponent, "a[eaButtonLink]", never, {
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "fullWidth": {
+      "alias": "fullWidth";
+      "required": false;
+      "isSignal": true;
+    };
+    "align": {
+      "alias": "align";
+      "required": false;
+      "isSignal": true;
+    };
+    "uppercase": {
+      "alias": "uppercase";
+      "required": false;
+      "isSignal": true;
+    };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["[slot=prefix]", "*", "[slot=suffix]"], true, never>;
+}
 /** Visual style of a card surface. */
 export type CardVariant = 'elevated' | 'outlined' | 'filled';
 /** Padding preset applied to the card's content area. */
@@ -2216,6 +2369,8 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
@@ -2389,6 +2544,11 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -2686,6 +2846,8 @@ export declare class CodeInputComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Placeholder text spread one character per cell (cell i shows character i). */
   readonly placeholder: import("@angular/core").InputSignal<string>;
   readonly length: import("@angular/core").InputSignal<number>;
@@ -2741,6 +2903,11 @@ export declare class CodeInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -2840,6 +3007,8 @@ export declare class DatePickerComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Placeholder shown in the field when no date is selected. */
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
@@ -2962,6 +3131,11 @@ export declare class DatePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -3398,6 +3572,8 @@ export declare class DropdownComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   /** Selectable options, either flat or split into groups. */
   readonly options: import("@angular/core").InputSignal<SelectOptions>;
@@ -3482,6 +3658,11 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -3646,12 +3827,33 @@ export declare class EmptyStateComponent {
   }, {}, never, ["[slot=media]", "[slot=actions]"], true, never>;
 }
 export declare class FieldLabelComponent {
+  private readonly i18n;
+  private readonly press;
+  private readonly renderer;
   readonly text: import("@angular/core").InputSignal<string>;
   /** Optional icon component rendered before the label text. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
+  /**
+   * Help revealed by an info button beside the label, as plain text or a
+   * template. Click, tap, Enter or Space toggles it, and it is announced when
+   * shown; Escape, a click outside, or moving focus away closes it.
+   */
+  readonly help: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   readonly forId: import("@angular/core").InputSignal<string | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly labelId: import("@angular/core").InputSignal<string | undefined>;
+  protected readonly helpOpen: import("@angular/core").WritableSignal<boolean>;
+  protected readonly helpId: string;
+  protected readonly helpTemplate: import("@angular/core").Signal<TemplateRef<unknown> | null>;
+  protected readonly helpTriggerLabel: import("@angular/core").Signal<string>;
+  private readonly helpEl;
+  private readonly helpTrigger;
+  private readonly helpBubble;
+  constructor();
+  protected toggleHelp(): void;
+  protected onHelpFocusout(event: FocusEvent): void;
+  /** Raises and places an open bubble and wires its dismissal; returns the teardown. */
+  private attachHelpBubble;
   static ɵfac: i0.ɵɵFactoryDeclaration<FieldLabelComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FieldLabelComponent, "ea-field-label", never, {
     "text": {
@@ -3664,6 +3866,11 @@ export declare class FieldLabelComponent {
       "required": false;
       "isSignal": true;
     };
+    "help": {
+      "alias": "help";
+      "required": false;
+      "isSignal": true;
+    };
     "forId": {
       "alias": "forId";
       "required": false;
@@ -3725,6 +3932,8 @@ export declare class FormFieldComponent {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Helper text shown below the control; hidden while an error is showing. */
   readonly hint: import("@angular/core").InputSignal<string | undefined>;
   /** Error message shown below the control; replaces the hint and flags the field invalid. */
@@ -3760,6 +3969,11 @@ export declare class FormFieldComponent {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -3842,6 +4056,8 @@ declare function controlErrorStateFrom(control: Signal<AbstractControl | null>,
 declare function injectControlErrorState(config: ControlErrorStateConfig): ControlErrorState;
 /** Visual size of the file uploader. */
 export type FileUploaderSize = EaSize;
+/** Presentation of the uploader: a drag-and-drop zone, or a compact picker button. */
+export type FileUploaderVariant = 'dropzone' | 'button';
 /** Reason a file was rejected during selection. */
 export type FileUploaderRejectionReason = 'type' | 'size' | 'count';
 /** Detail object emitted on the `rejected` output when one or more files fail validation. */
@@ -3859,25 +4075,56 @@ export interface FileUploaderRejection {
  * slot via the `icon` attribute: project any element to override it, and the
  * dropzone's size-aware wrapper handles sizing automatically.
  *
+ * Where a dropzone is too large, `variant="button"` swaps it for a compact
+ * `ea-button` that opens the file picker, keeping the same validation, file
+ * list and outputs.
+ *
  * @example
  * ```html
  * <ea-file-uploader label="Attach files">
  *   <ea-icon-paperclip icon />
  * </ea-file-uploader>
+ *
+ * <ea-file-uploader
+ *   variant="button"
+ *   accept=".csv"
+ *   buttonLabel="Import CSV"
+ *   [buttonIcon]="uploadIcon"
+ *   [multiple]="false" />
  * ```
  */
 export declare class FileUploaderComponent implements ControlValueAccessor {
   private readonly fileInputEl;
   private readonly dropzoneEl;
+  private readonly pickerButton;
   protected readonly i18n: EagamiI18nService;
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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 size: import("@angular/core").InputSignal<EaSize>;
+  /**
+   * `dropzone` renders the drag-and-drop area; `button` renders a compact
+   * secondary `ea-button` that opens the file picker instead, without drop support.
+   */
+  readonly variant: import("@angular/core").InputSignal<FileUploaderVariant>;
+  /**
+   * Visible text of the `button` variant, falling back to the localized "Browse
+   * files". An empty string together with a `buttonIcon` leaves an icon-only button.
+   */
+  readonly buttonLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Optional icon component rendered before the `button` variant's text. */
+  readonly buttonIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
+  /**
+   * Accessible name when nothing visible names the control: no `label`, and in
+   * the `button` variant no button text either.
+   */
+  readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   /**
@@ -3894,6 +4141,11 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   readonly maxFiles: import("@angular/core").InputSignal<number | undefined>;
   /** Toggle the file list under the dropzone. */
   readonly showFileList: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Toggle the line listing the accepted types, size and file count limits, for a
+   * compact placement (an icon button in a toolbar) where it would crowd the control.
+   */
+  readonly showConstraints: import("@angular/core").InputSignal<boolean>;
   /**
    * Optional per-file progress (0-100). Keyed by `File` object identity, so
    * consumers must keep the same `File` references between change-detection
@@ -3926,6 +4178,7 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   protected readonly showHint: import("@angular/core").Signal<boolean>;
   protected readonly hostClasses: import("@angular/core").Signal<{
     [x: string]: boolean;
+    'ea-file-uploader-field--button': boolean;
     'ea-file-uploader-field--error': boolean;
     'ea-file-uploader-field--disabled': boolean;
     'ea-file-uploader-field--drag-over': boolean;
@@ -3938,6 +4191,12 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   /** Joined human-readable description of accept / maxSize / maxFiles limits. */
   protected readonly constraintsText: import("@angular/core").Signal<string>;
   protected readonly promptText: import("@angular/core").Signal<string>;
+  protected readonly dropzoneLabel: import("@angular/core").Signal<string>;
+  protected readonly labelId: import("@angular/core").Signal<string>;
+  protected readonly buttonTextId: import("@angular/core").Signal<string>;
+  protected readonly buttonText: import("@angular/core").Signal<string>;
+  protected readonly buttonLabelledBy: import("@angular/core").Signal<string | undefined>;
+  protected readonly buttonAriaLabel: import("@angular/core").Signal<string | undefined>;
   writeValue(value: readonly File[] | null | undefined): void;
   registerOnChange(fn: (value: readonly File[]) => void): void;
   registerOnTouched(fn: () => void): void;
@@ -3946,6 +4205,7 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   protected onDropzoneKeydown(event: KeyboardEvent): void;
   protected onDropzoneFocus(): void;
   protected onDropzoneBlur(): void;
+  protected onPickerButtonFocusOut(): void;
   protected onFileSelected(event: Event): void;
   protected onDragEnter(event: DragEvent): void;
   protected onDragOver(event: DragEvent): void;
@@ -3971,6 +4231,11 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -3991,6 +4256,26 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "buttonLabel": {
+      "alias": "buttonLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "buttonIcon": {
+      "alias": "buttonIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "aria-label";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -4026,6 +4311,11 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showConstraints": {
+      "alias": "showConstraints";
+      "required": false;
+      "isSignal": true;
+    };
     "progress": {
       "alias": "progress";
       "required": false;
@@ -4066,6 +4356,8 @@ export declare class InputComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Accessible name for the control when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /** ARIA role applied to the native input, e.g. `combobox` for a typeahead host. */
@@ -4185,6 +4477,11 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -4398,9 +4695,9 @@ interface XDomain {
  * Plots one or more series of values as lines, with optional points and area
  * fills. Points are spaced evenly by default, or placed along a numeric scale
  * by `xValues`, with the x-axis labelled per point or by `xTicks`. A
- * `visibleXSpan` window makes a long run of data pannable. Hovering or
- * arrowing through the chart reveals each point's values in a tooltip, and a
- * visually hidden table carries the full data for screen readers.
+ * `visibleXSpan` window makes a long run of data pannable. Hovering, tapping,
+ * or arrowing through the chart reveals each point's values in a tooltip, and
+ * a visually hidden table carries the full data for screen readers.
  */
 export declare class LineChartComponent {
   protected readonly i18n: EagamiI18nService;
@@ -4469,6 +4766,7 @@ export declare class LineChartComponent {
   readonly visibleRangeChange: import("@angular/core").OutputEmitterRef<LineChartVisibleRange>;
   private readonly viewport;
   private readonly format;
+  private readonly plotEl;
   protected readonly active: import("@angular/core").WritableSignal<ActivePoint | null>;
   protected readonly clipId: string;
   protected readonly breakMaskId: string;
@@ -4478,6 +4776,7 @@ export declare class LineChartComponent {
   protected readonly panning: import("@angular/core").WritableSignal<boolean>;
   private drag;
   private suppressClick;
+  private releaseTap;
   protected readonly label: import("@angular/core").Signal<string>;
   protected readonly count: import("@angular/core").Signal<number>;
   protected readonly hasData: import("@angular/core").Signal<boolean>;
@@ -4544,6 +4843,7 @@ export declare class LineChartComponent {
   }[]>;
   protected readonly announcement: import("@angular/core").Signal<string>;
   protected readonly showsLegend: import("@angular/core").Signal<boolean>;
+  constructor();
   protected seriesColor(index: number): string;
   protected isDimmed(index: number): boolean;
   protected isActivePoint(seriesIndex: number, index: number): boolean;
@@ -4551,6 +4851,7 @@ export declare class LineChartComponent {
   protected onPointerDown(event: PointerEvent): void;
   protected onPointerMove(event: PointerEvent): void;
   protected onPointerUp(event: PointerEvent): void;
+  protected onPointerCancel(event: PointerEvent): void;
   protected onPointerLeave(): void;
   protected onWheel(event: WheelEvent): void;
   protected onClick(): void;
@@ -4572,6 +4873,8 @@ export declare class LineChartComponent {
   private unitsPerPx;
   private panTo;
   private endDrag;
+  private holdTap;
+  private endTapHold;
   private reveal;
   private indexAt;
   private valueAt;
@@ -5114,6 +5417,8 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Accessible name for the combobox when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
@@ -5302,6 +5607,11 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -5423,6 +5733,8 @@ export declare class NumberInputComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Placeholder shown while the field is empty. */
   readonly placeholder: import("@angular/core").InputSignal<string>;
   /** Visual size of the field. */
@@ -5511,6 +5823,11 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -5998,6 +6315,8 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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: '...' }`). */
@@ -6063,6 +6382,11 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -6162,6 +6486,8 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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: '...' }`). */
@@ -6237,6 +6563,11 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -6353,6 +6684,8 @@ export declare class RatingComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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: '...' }`). */
@@ -6433,6 +6766,11 @@ export declare class RatingComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -6527,6 +6865,8 @@ export declare class SegmentedComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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: '...' }`). */
@@ -6584,6 +6924,11 @@ export declare class SegmentedComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -6688,6 +7033,8 @@ export declare class SliderComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   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: '...' }`). */
@@ -6765,6 +7112,11 @@ export declare class SliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7018,6 +7370,8 @@ export declare class StepperComponent {
 }
 /** Visual size of the switch. */
 export type SwitchSize = EaSize;
+/** Status tone applied to the switch track in both states. */
+export type SwitchVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /**
  * On/off toggle styled as a sliding switch. Backed by a visually hidden
  * native checkbox and integrates with Angular forms via
@@ -7030,6 +7384,15 @@ export declare class SwitchComponent implements ControlValueAccessor {
   /** 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 size: import("@angular/core").InputSignal<EaSize>;
+  /**
+   * Status tone for the track: a tinted wash with a toned border while off and
+   * the solid tone while on. `default` keeps the neutral off track and brand on track.
+   */
+  readonly variant: import("@angular/core").InputSignal<SwitchVariant>;
+  /** Optional icon component drawn in the thumb while the switch is on. */
+  readonly onIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
+  /** Optional icon component drawn in the thumb while the switch is off. */
+  readonly offIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
@@ -7052,6 +7415,7 @@ export declare class SwitchComponent implements ControlValueAccessor {
     'ea-switch--disabled': boolean;
     'ea-switch--error': boolean;
   }>;
+  protected readonly thumbIcon: import("@angular/core").Signal<Type<unknown> | undefined>;
   writeValue(val: boolean): void;
   registerOnChange(fn: (value: boolean) => void): void;
   registerOnTouched(fn: () => void): void;
@@ -7084,6 +7448,21 @@ export declare class SwitchComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "variant": {
+      "alias": "variant";
+      "required": false;
+      "isSignal": true;
+    };
+    "onIcon": {
+      "alias": "onIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "offIcon": {
+      "alias": "offIcon";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -7375,11 +7754,19 @@ export declare class TagComponent {
    */
   readonly maxWidth: import("@angular/core").InputSignal<string | number | undefined>;
   /**
-   * Fill colour as a hex value, for a tag carrying a colour of its own (a
-   * user-chosen label). Paints the chip and its border, and picks whichever ink
-   * reads better on it. Takes precedence over `variant`.
+   * Fill colour, for a tag carrying a colour of its own (a user-chosen label).
+   * Paints the chip and its border, and takes precedence over `variant`. On
+   * its own it must be a hex value, from which the tag picks whichever ink
+   * reads better; alongside `ink` it takes any CSS colour, such as a
+   * theme-aware `var(--my-token)`.
    */
   readonly color: import("@angular/core").InputSignal<string | undefined>;
+  /**
+   * Text colour, as any CSS colour, overriding the ink the tag would pick for
+   * `color`. Supplying it lets `color` be a value the tag cannot measure, so
+   * the contrast between the two rests with the caller.
+   */
+  readonly ink: import("@angular/core").InputSignal<string | 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
@@ -7409,7 +7796,7 @@ export declare class TagComponent {
   }>;
   /** `maxWidth` as a CSS length; a bare number is px, as the input documents. */
   protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | null>;
-  /** Ink that reads on `color`, or `null` when it is not a hex the library can measure. */
+  /** The caller's `ink`, else one that reads on a hex `color`, else `null`. */
   protected readonly resolvedInk: import("@angular/core").Signal<string | null>;
   protected readonly resolvedColor: import("@angular/core").Signal<string | null>;
   constructor();
@@ -7457,6 +7844,11 @@ export declare class TagComponent {
       "required": false;
       "isSignal": true;
     };
+    "ink": {
+      "alias": "ink";
+      "required": false;
+      "isSignal": true;
+    };
     "tooltip": {
       "alias": "tooltip";
       "required": false;
@@ -7480,9 +7872,15 @@ export declare class TagComponent {
 export type TextareaSize = EaSize;
 /** Axis along which the user is allowed to resize the textarea. */
 export type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
+/** Selected character range in the textarea; `start` equals `end` for a bare caret. */
+export interface TextareaSelection {
+  readonly start: number;
+  readonly end: number;
+}
 /**
  * Multiline text field that mirrors the `ea-input` API. Supports configurable
- * `resize` direction and `maxlength`, and integrates with Angular
+ * `resize` direction and `maxlength`, exposes the caret through
+ * `getSelection()` and `insertText()`, and integrates with Angular
  * forms via `ControlValueAccessor`.
  */
 export declare class TextareaComponent implements ControlValueAccessor {
@@ -7490,6 +7888,8 @@ export declare class TextareaComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   /** Accessible name for the control when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
@@ -7542,6 +7942,19 @@ export declare class TextareaComponent implements ControlValueAccessor {
   handleBlur(event: FocusEvent): void;
   /** Moves keyboard focus to the underlying native textarea element. */
   focus(): void;
+  /**
+   * Returns the selected range as character offsets into the value. The browser
+   * keeps it after the field loses focus, so it still reflects where the caret
+   * was left once the user has moved on to a button or a dialog.
+   */
+  getSelection(): TextareaSelection;
+  /**
+   * Replaces the current selection with `text` and places the caret after it,
+   * notifying the value model, a bound form control and native `input`
+   * listeners exactly as typing does. Does nothing while disabled or read-only,
+   * and leaves focus where it is.
+   */
+  insertText(text: string): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<TextareaComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<TextareaComponent, "ea-textarea", never, {
     "label": {
@@ -7554,6 +7967,11 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -7681,6 +8099,8 @@ export declare class TimePickerComponent implements ControlValueAccessor {
   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>;
+  /** Help revealed by an info button beside the label, as plain text or a template. */
+  readonly labelHelp: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
@@ -7851,6 +8271,11 @@ export declare class TimePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;