@eagami/ui 5.73.0 → 5.75.0

package/types/eagami-ui.d.ts

@@ -676,6 +676,12 @@ export type EaSize = '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
  * runs one step wider before the jump to full.
  */
 export type EaWidth = EaSize | '2xl' | 'full';
+/**
+ * Semantic colour scheme shared by every status-carrying component. A
+ * component's own variant type (e.g. `BadgeVariant`) aliases this so the set
+ * is defined once.
+ */
+export type EaStatusVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
 /**
  * Single expandable section within an `ea-accordion`. Each item exposes a
  * header button with the supplied `label`, or with an element projected as
@@ -796,7 +802,7 @@ export declare class AccordionComponent {
   }, never, ["*"], true, never>;
 }
 /** Semantic colour scheme of an alert. Drives icon and palette. */
-export type AlertVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type AlertVariant = EaStatusVariant;
 /** Scales the alert's text, icon, and gap together. */
 export type AlertSize = EaSize;
 /** How assistive technology announces an alert. */
@@ -808,7 +814,7 @@ export type AlertLive = 'auto' | 'assertive' | 'polite' | 'off';
  */
 export declare class AlertComponent {
   protected readonly i18n: EagamiI18nService;
-  readonly variant: import("@angular/core").InputSignal<AlertVariant>;
+  readonly variant: import("@angular/core").InputSignal<EaStatusVariant>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly dismissible: import("@angular/core").InputSignal<boolean>;
   readonly visible: import("@angular/core").ModelSignal<boolean>;
@@ -921,6 +927,86 @@ declare function flattenGroups(groups: readonly SelectOptionGroup[]): SelectOpti
  * left out, so neither a heading nor a rule can render over nothing.
  */
 declare function toRenderedGroups(groups: readonly SelectOptionGroup[]): RenderedGroup[];
+/**
+ * Label, hint and validation inputs shared by every form control that renders
+ * `<ea-field-messages>`. Controls with an inline label (checkbox, switch)
+ * extend this directly; controls with a field label above them extend
+ * `LabelledFieldControlBase`.
+ */
+export declare abstract class FieldControlBase {
+  /** Text label for the control. */
+  readonly label: import("@angular/core").InputSignal<string | 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 control invalid. */
+  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 | null>> | undefined>;
+  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
+  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
+  /** Marks the control as required. */
+  readonly required: import("@angular/core").InputSignal<boolean>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FieldControlBase, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<FieldControlBase, never, 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;
+    };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/** Field label inputs on top of `FieldControlBase`, for controls that render `<ea-field-label>`. */
+export declare abstract class LabelledFieldControlBase extends FieldControlBase {
+  /** 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>;
+  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
+  readonly optional: import("@angular/core").InputSignal<boolean>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LabelledFieldControlBase, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<LabelledFieldControlBase, never, never, {
+    "labelIcon": {
+      "alias": "labelIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelHelp": {
+      "alias": "labelHelp";
+      "required": false;
+      "isSignal": true;
+    };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 /** Visual size of the autocomplete input. */
 export type AutocompleteSize = EaSize;
 /**
@@ -929,16 +1015,9 @@ export type AutocompleteSize = EaSize;
  * implements `ControlValueAccessor` for use with reactive and template-driven
  * forms.
  */
-export declare class AutocompleteComponent implements ControlValueAccessor {
+export declare class AutocompleteComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   private readonly inputEl;
   private readonly i18n;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** 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>;
@@ -947,13 +1026,6 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | 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>;
@@ -1021,26 +1093,6 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   private moveFocus;
   static ɵfac: i0.ɵɵFactoryDeclaration<AutocompleteComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<AutocompleteComponent, "ea-autocomplete", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -1071,31 +1123,6 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "minLength": {
       "alias": "minLength";
       "required": false;
@@ -1384,7 +1411,7 @@ export declare class AvatarComponent {
   }, {}, never, never, true, never>;
 }
 /** Semantic colour scheme of a badge. */
-export type BadgeVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type BadgeVariant = EaStatusVariant;
 /** Visual size of a badge. */
 /**
  * The badge ladder sits one step below the shared scale (its `xs` is already
@@ -1403,7 +1430,7 @@ export type BadgeShape = 'pill' | 'pin';
  * surrounding content.
  */
 export declare class BadgeComponent {
-  readonly variant: import("@angular/core").InputSignal<BadgeVariant>;
+  readonly variant: import("@angular/core").InputSignal<EaStatusVariant>;
   readonly size: import("@angular/core").InputSignal<BadgeSize>;
   readonly shape: import("@angular/core").InputSignal<BadgeShape>;
   readonly uppercase: import("@angular/core").InputSignal<boolean>;
@@ -2188,8 +2215,7 @@ export type CheckboxSize = EaSize;
  * a visually hidden native input with a custom checkmark and integrates with
  * Angular forms via `ControlValueAccessor`.
  */
-export declare class CheckboxComponent implements ControlValueAccessor {
-  readonly label: import("@angular/core").InputSignal<string | undefined>;
+export declare class CheckboxComponent extends FieldControlBase implements ControlValueAccessor {
   /**
    * Optional supplementary value shown immediately after the label, dimmed
    * to the tertiary text token. Renders inside the same `<span>` as the
@@ -2198,12 +2224,6 @@ export declare class CheckboxComponent implements ControlValueAccessor {
    * fighting flex / inline-flow centring at the consumer's call site.
    */
   readonly count: import("@angular/core").InputSignal<string | number | 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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   /**
    * Ellipsize a label too long for the space the checkbox is given, revealing
@@ -2212,9 +2232,10 @@ export declare class CheckboxComponent implements ControlValueAccessor {
    */
   readonly truncate: import("@angular/core").InputSignal<boolean>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements whose text names the checkbox, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /** Fires with the new checked state whenever the user toggles the checkbox. */
@@ -2246,36 +2267,11 @@ export declare class CheckboxComponent implements ControlValueAccessor {
   handleChange(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<CheckboxComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<CheckboxComponent, "ea-checkbox", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
     "count": {
       "alias": "count";
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "size": {
       "alias": "size";
       "required": false;
@@ -2291,11 +2287,6 @@ export declare class CheckboxComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "indeterminate": {
       "alias": "indeterminate";
       "required": false;
@@ -2306,6 +2297,11 @@ export declare class CheckboxComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
+      "required": false;
+      "isSignal": true;
+    };
     "id": {
       "alias": "id";
       "required": false;
@@ -2569,31 +2565,17 @@ interface Rgb {
  * and an eyedropper (Chromium browsers). Integrates with Angular forms via
  * `ControlValueAccessor`. Accepts any CSS color string in `writeValue`.
  */
-export declare class ColorPickerComponent implements ControlValueAccessor {
+export declare class ColorPickerComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   protected readonly triggerEl: import("@angular/core").Signal<ElementRef<HTMLButtonElement> | undefined>;
   private readonly svAreaEl;
   private readonly hueTrackEl;
   private readonly alphaTrackEl;
   private readonly injector;
   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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   /** Whether to show the alpha slider. When `false` the emitted value always has alpha = 1. */
   readonly showAlpha: import("@angular/core").InputSignal<boolean>;
   /** Whether to show the clear button when a value is set. */
@@ -2748,26 +2730,6 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
   private refreshHexInput;
   static ɵfac: i0.ɵɵFactoryDeclaration<ColorPickerComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ColorPickerComponent, "ea-color-picker", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -2788,31 +2750,6 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "showAlpha": {
       "alias": "showAlpha";
       "required": false;
@@ -3074,8 +3011,8 @@ export type PopoverRole = 'menu' | 'listbox' | 'dialog' | 'tooltip' | 'grid';
  *   guaranteed not to move (e.g. inside a non-scrolling region).
  */
 export type PopoverScrollBehavior = 'reposition' | 'close' | 'ignore';
-/** Width cap for a popover surface: px, or the anchor's own width. */
-export type PopoverMaxWidth = number | 'anchor';
+/** Width cap for a popover surface: a CSS length, or `'anchor'` for the anchor's own width. */
+export type PopoverMaxWidth = string;
 /**
  * Floating-element primitive. Renders projected content as `position: fixed`
  * anchored to an external element, with flip-on-overflow, viewport clamping,
@@ -3134,10 +3071,10 @@ export declare class PopoverComponent {
   /** Set the popover's `min-width` to match the anchor's width (dropdown pattern). */
   readonly matchAnchorWidth: import("@angular/core").InputSignal<boolean>;
   /**
-   * Widest the surface may grow: a px value, or `anchor` to cap it at the
+   * Widest the surface may grow: a CSS length, or `anchor` to cap it at the
    * anchor's own width so long content truncates instead of widening the panel.
    */
-  readonly maxWidth: import("@angular/core").InputSignal<PopoverMaxWidth | undefined>;
+  readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
   /** Close on click outside the popover and the anchor. */
   readonly closeOnOutsideClick: import("@angular/core").InputSignal<boolean>;
   /** Close on Escape. */
@@ -3635,35 +3572,23 @@ export type CodeInputSize = EaSize;
  * input, supports paste of the full code at once, and integrates with Angular
  * forms via `ControlValueAccessor`.
  */
-export declare class CodeInputComponent implements ControlValueAccessor {
+export declare class CodeInputComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly digitEls: import("@angular/core").Signal<readonly ElementRef<HTMLInputElement>[]>;
   protected readonly i18n: EagamiI18nService;
-  readonly label: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the group of digit fields, such as a label outside the component. */
   readonly ariaLabelledby: 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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** 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>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
-  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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Allow any non-whitespace character; when false (default) only digits are accepted. */
   readonly allowAllChars: import("@angular/core").InputSignal<boolean>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly value: import("@angular/core").ModelSignal<string>;
+  /** Fires with the new value whenever the user edits the code. */
+  readonly changed: import("@angular/core").OutputEmitterRef<string>;
   readonly focusedIndex: import("@angular/core").WritableSignal<number>;
   private readonly _formDisabled;
   /** Fires with the full code once every digit has been entered. */
@@ -3694,33 +3619,13 @@ export declare class CodeInputComponent implements ControlValueAccessor {
   private focusDigit;
   static ɵfac: i0.ɵɵFactoryDeclaration<CodeInputComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<CodeInputComponent, "ea-code-input", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
     "ariaLabelledby": {
       "alias": "aria-labelledby";
       "required": false;
       "isSignal": true;
     };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
-    "placeholder": {
-      "alias": "placeholder";
+    "placeholder": {
+      "alias": "placeholder";
       "required": false;
       "isSignal": true;
     };
@@ -3734,26 +3639,6 @@ export declare class CodeInputComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -3764,11 +3649,6 @@ export declare class CodeInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "allowAllChars": {
       "alias": "allowAllChars";
       "required": false;
@@ -3786,6 +3666,7 @@ export declare class CodeInputComponent implements ControlValueAccessor {
     };
   }, {
     "value": "valueChange";
+    "changed": "changed";
     "completed": "completed";
   }, never, never, true, never>;
 }
@@ -3820,18 +3701,11 @@ interface CalendarDay {
  * navigation (arrows, PageUp/PageDown, Home/End, Enter, Escape). Integrates
  * with Angular forms via `ControlValueAccessor`.
  */
-export declare class DatePickerComponent implements ControlValueAccessor {
+export declare class DatePickerComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   protected readonly fieldEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
   protected readonly inputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
   private readonly injector;
   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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** Placeholder shown in the field when no date is selected. */
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the field, such as a label outside the component. */
@@ -3839,13 +3713,6 @@ export declare class DatePickerComponent implements ControlValueAccessor {
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly minDate: import("@angular/core").InputSignal<Date | null>;
   readonly maxDate: import("@angular/core").InputSignal<Date | null>;
   /** Weekdays that cannot be picked, numbered as `Date.getDay()` does: 0 for Sunday through 6 for Saturday. */
@@ -3953,26 +3820,6 @@ export declare class DatePickerComponent implements ControlValueAccessor {
   private addMonths;
   static ɵfac: i0.ɵɵFactoryDeclaration<DatePickerComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<DatePickerComponent, "ea-date-picker", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -3998,31 +3845,6 @@ export declare class DatePickerComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "minDate": {
       "alias": "minDate";
       "required": false;
@@ -4488,36 +4310,22 @@ export type DropdownSize = EaSize;
  * trigger and a search field above the options. Positioning, dismissal, and
  * SSR-safe scroll handling are provided by `<ea-popover>`.
  */
-export declare class DropdownComponent implements ControlValueAccessor {
+export declare class DropdownComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   private readonly elRef;
   private readonly popover;
   private readonly searchEl;
   protected readonly i18n: EagamiI18nService;
   private readonly injector;
-  readonly label: import("@angular/core").InputSignal<string | undefined>;
-  /** Optional icon component rendered before the label text. */
-  readonly labelIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
-  /** 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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   /** Selectable options, either flat or split into groups. */
   readonly options: import("@angular/core").InputSignal<SelectOptions>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Shows a clear button on the trigger while an option is selected. */
   readonly clearable: import("@angular/core").InputSignal<boolean>;
   /** Adds a search field above the options that filters them as the user types. */
   readonly searchable: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly value: import("@angular/core").ModelSignal<string>;
   /** Fires with the new value when the user selects an option or clears the selection. */
@@ -4598,26 +4406,6 @@ export declare class DropdownComponent implements ControlValueAccessor {
   private moveFocus;
   static ɵfac: i0.ɵɵFactoryDeclaration<DropdownComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<DropdownComponent, "ea-dropdown", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -4643,11 +4431,6 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "clearable": {
       "alias": "clearable";
       "required": false;
@@ -4658,26 +4441,6 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "id": {
       "alias": "id";
       "required": false;
@@ -4907,26 +4670,8 @@ export type FormFieldSize = EaSize;
  * projected control can't be reached before it exists; the server ships the
  * plain markup and the associations complete on hydration.
  */
-export declare class FormFieldComponent {
+export declare class FormFieldComponent extends LabelledFieldControlBase {
   private readonly host;
-  /** Text label rendered above the control. */
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  /** 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. */
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for the projected form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
-  /** Marks the field as required. */
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Visual size of the field; the label, control text, spacing, and messages scale with it. */
   readonly size: import("@angular/core").InputSignal<EaSize>;
   /** id seed for the label and message wiring; auto-generated when omitted. */
@@ -4944,51 +4689,6 @@ export declare class FormFieldComponent {
   constructor();
   static ɵfac: i0.ɵɵFactoryDeclaration<FormFieldComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormFieldComponent, "ea-form-field", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "size": {
       "alias": "size";
       "required": false;
@@ -5099,24 +4799,11 @@ export interface FileUploaderRejection {
  *   [multiple]="false" />
  * ```
  */
-export declare class FileUploaderComponent implements ControlValueAccessor {
+export declare class FileUploaderComponent extends LabelledFieldControlBase 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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   /**
    * `dropzone` renders the drag-and-drop area; `button` renders a compact
@@ -5136,7 +4823,6 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
    */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@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
@@ -5231,78 +4917,33 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   protected trackFile(_index: number, file: File): string;
   static ɵfac: i0.ɵɵFactoryDeclaration<FileUploaderComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FileUploaderComponent, "ea-file-uploader", never, {
-    "label": {
-      "alias": "label";
+    "size": {
+      "alias": "size";
       "required": false;
       "isSignal": true;
     };
-    "labelIcon": {
-      "alias": "labelIcon";
+    "variant": {
+      "alias": "variant";
       "required": false;
       "isSignal": true;
     };
-    "labelHelp": {
-      "alias": "labelHelp";
+    "buttonLabel": {
+      "alias": "buttonLabel";
       "required": false;
       "isSignal": true;
     };
-    "optional": {
-      "alias": "optional";
+    "buttonIcon": {
+      "alias": "buttonIcon";
       "required": false;
       "isSignal": true;
     };
-    "hint": {
-      "alias": "hint";
+    "ariaLabel": {
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
-    "errorMsg": {
-      "alias": "errorMsg";
-      "required": false;
-      "isSignal": true;
-    };
-    "errorMessages": {
-      "alias": "errorMessages";
-      "required": false;
-      "isSignal": true;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
-    "size": {
-      "alias": "size";
-      "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;
-      "isSignal": true;
-    };
-    "required": {
-      "alias": "required";
+    "disabled": {
+      "alias": "disabled";
       "required": false;
       "isSignal": true;
     };
@@ -5381,27 +5022,21 @@ declare function injectTypedPlaceholder(hints: Signal<readonly string[]>): Typed
 /** Visual size of the input. */
 export type InputSize = EaSize;
 /** HTML `type` attribute applied to the underlying `<input>`. */
-export type InputType = 'text' | 'email' | 'password' | 'number' | 'search' | 'tel' | 'url';
+export type InputType = 'text' | 'email' | 'password' | 'search' | 'tel' | 'url';
 /**
  * Single-line text field with label, hint, and error message support.
  * Includes a built-in show/hide toggle for `password` inputs and integrates
  * with Angular forms via `ControlValueAccessor`. Prefix and suffix content
  * can be projected via the `prefix` and `suffix` slots.
  */
-export declare class InputComponent implements ControlValueAccessor {
+export declare class InputComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly inputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
   private readonly injector;
   protected readonly i18n: EagamiI18nService;
-  /** Text label rendered above the field. */
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** Accessible name for the control when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements whose text names the field, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   /** ARIA role applied to the native input, e.g. `combobox` for a typeahead host. */
   readonly role: import("@angular/core").InputSignal<string | undefined>;
   /** Expanded state of a controlled popup, forwarded as `aria-expanded`. */
@@ -5430,33 +5065,17 @@ export declare class InputComponent implements ControlValueAccessor {
   readonly keepIcon: import("@angular/core").InputSignal<boolean>;
   /** Visual size of the field. */
   readonly size: import("@angular/core").InputSignal<EaSize>;
-  /** Helper text shown below the field; hidden while an error is showing. */
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  /** Error message shown below the field; replaces the hint and flags the field invalid. */
-  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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   /** Disables the field. */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** Renders the field read-only. */
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  /** Marks the field as required. */
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Value for the native `autocomplete` attribute. */
   readonly autocomplete: import("@angular/core").InputSignal<string | undefined>;
   /** Value for the native `spellcheck` attribute; left to the browser default when unset. */
   readonly spellcheck: import("@angular/core").InputSignal<boolean | undefined>;
   /** `id` of a `<datalist>` to associate for native suggestions. */
   readonly list: import("@angular/core").InputSignal<string | undefined>;
-  /** Minimum value for `type="number"`; the value is clamped to it on blur. */
-  readonly min: import("@angular/core").InputSignal<number | undefined>;
-  /** Maximum value for `type="number"`; the value is clamped to it on blur. */
-  readonly max: import("@angular/core").InputSignal<number | undefined>;
-  /** Step increment for `type="number"`. */
-  readonly step: import("@angular/core").InputSignal<number | undefined>;
-  /** Maximum number of characters; enforced for `type="number"`, where native `maxlength` is ignored. */
+  /** Maximum number of characters (native `maxlength`). */
   readonly maxLength: import("@angular/core").InputSignal<number | undefined>;
   /** Minimum number of characters (native `minlength`). */
   readonly minLength: import("@angular/core").InputSignal<number | undefined>;
@@ -5470,6 +5089,8 @@ export declare class InputComponent implements ControlValueAccessor {
   readonly id: import("@angular/core").InputSignal<string>;
   /** Current field value; two-way bindable via `[(value)]`. */
   readonly value: import("@angular/core").ModelSignal<string>;
+  /** Fires with the new value whenever the user edits the field. */
+  readonly changed: import("@angular/core").OutputEmitterRef<string>;
   readonly isFocused: import("@angular/core").WritableSignal<boolean>;
   readonly passwordVisible: import("@angular/core").WritableSignal<boolean>;
   private readonly _formDisabled;
@@ -5497,22 +5118,14 @@ export declare class InputComponent implements ControlValueAccessor {
     'ea-input-wrapper--disabled': boolean;
     'ea-input-wrapper--readonly': boolean;
   }>;
-  /** Characters a bounded number field can hold, from `maxLength` or its bounds' digits. */
-  private readonly numberCharCapacity;
-  /** Caps a bounded number field to the widest value it can hold. */
-  readonly numberWidth: import("@angular/core").Signal<string | null>;
   constructor();
   writeValue(val: string): void;
   registerOnChange(fn: (value: string) => void): void;
   registerOnTouched(fn: () => void): void;
   setDisabledState(isDisabled: boolean): void;
   handleInput(event: Event): void;
-  handleKeydown(event: KeyboardEvent): void;
-  handleWheel(event: WheelEvent): void;
   handleFocus(event: FocusEvent): void;
   handleBlur(event: FocusEvent): void;
-  /** Clamps a number value into `[min, max]` once editing finishes. */
-  private clampToBounds;
   /** Toggles the password reveal state for `type="password"` inputs. */
   togglePasswordVisibility(): void;
   protected onClearMousedown(event: MouseEvent): void;
@@ -5522,28 +5135,13 @@ export declare class InputComponent implements ControlValueAccessor {
   focus(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<InputComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<InputComponent, "ea-input", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
+    "ariaLabel": {
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
-    "ariaLabel": {
-      "alias": "aria-label";
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
       "required": false;
       "isSignal": true;
     };
@@ -5602,26 +5200,6 @@ export declare class InputComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -5632,11 +5210,6 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "autocomplete": {
       "alias": "autocomplete";
       "required": false;
@@ -5652,21 +5225,6 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "min": {
-      "alias": "min";
-      "required": false;
-      "isSignal": true;
-    };
-    "max": {
-      "alias": "max";
-      "required": false;
-      "isSignal": true;
-    };
-    "step": {
-      "alias": "step";
-      "required": false;
-      "isSignal": true;
-    };
     "maxLength": {
       "alias": "maxLength";
       "required": false;
@@ -5704,6 +5262,7 @@ export declare class InputComponent implements ControlValueAccessor {
     };
   }, {
     "value": "valueChange";
+    "changed": "changed";
     "focused": "focused";
     "blurred": "blurred";
   }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
@@ -6153,7 +5712,7 @@ export type MultiSelectSize = EaSize;
  * to match the input `options` array. Closes on outside click / scroll, and
  * integrates with Angular forms via `ControlValueAccessor`.
  */
-export declare class MultiSelectComponent implements ControlValueAccessor {
+export declare class MultiSelectComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   protected readonly wrapperEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
   private readonly popover;
   protected readonly triggerEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
@@ -6163,13 +5722,6 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   protected readonly i18n: EagamiI18nService;
   private readonly injector;
   private readonly destroyRef;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** Accessible name for the combobox when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the combobox, such as a label outside the component. */
@@ -6181,13 +5733,6 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   /** Toggle the search input at the top of the popover. */
   readonly searchable: import("@angular/core").InputSignal<boolean>;
   /** Toggle the "Select all" row at the top of the option list. */
@@ -6202,20 +5747,20 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   /** 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: import("@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.
+   * Widest a selected-value chip may grow, as a CSS length; a longer label
+   * ellipsizes and reveals its full text in a tooltip.
    */
-  readonly maxChipWidth: import("@angular/core").InputSignal<number | undefined>;
+  readonly maxChipWidth: import("@angular/core").InputSignal<string | undefined>;
   /**
-   * Tallest the option popover may grow, in px, before the option list
-   * scrolls; left unset, the popover keeps its built-in 20rem cap.
+   * Tallest the option popover may grow, as a CSS length, before the option
+   * list scrolls; left unset, the popover keeps its built-in 20rem cap.
    */
-  readonly popoverMaxHeight: import("@angular/core").InputSignal<number | undefined>;
+  readonly popoverMaxHeight: import("@angular/core").InputSignal<string | undefined>;
   /**
-   * Widest the option popover may grow: a px value, or `anchor` to hold it to
+   * Widest the option popover may grow: a CSS length, or `anchor` to hold it to
    * the field's own width so a long option truncates instead of widening it.
    */
-  readonly popoverMaxWidth: import("@angular/core").InputSignal<PopoverMaxWidth>;
+  readonly popoverMaxWidth: import("@angular/core").InputSignal<string>;
   readonly id: import("@angular/core").InputSignal<string>;
   /** Selected option values, in the original options order. */
   readonly value: import("@angular/core").ModelSignal<readonly string[]>;
@@ -6352,26 +5897,6 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   private watchListWidth;
   static ɵfac: i0.ɵɵFactoryDeclaration<MultiSelectComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<MultiSelectComponent, "ea-multi-select", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -6412,31 +5937,6 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "searchable": {
       "alias": "searchable";
       "required": false;
@@ -6496,35 +5996,17 @@ export type NumberInputSize = EaSize;
  * `spinbutton` role, so arrow keys step it; the steppers are pointer
  * affordances. Integrates with Angular forms via `ControlValueAccessor`.
  */
-export declare class NumberInputComponent implements ControlValueAccessor {
+export declare class NumberInputComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly inputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
   protected readonly i18n: EagamiI18nService;
-  /** Text label rendered above the field. */
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** Placeholder shown while the field is empty. */
   readonly placeholder: import("@angular/core").InputSignal<string>;
   /** Visual size of the field. */
   readonly size: import("@angular/core").InputSignal<EaSize>;
-  /** Helper text shown below the field; hidden while an error is showing. */
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  /** Error message shown below the field; replaces the hint and flags the field invalid. */
-  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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   /** Disables the field. */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** Renders the field read-only. */
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  /** Marks the field as required. */
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Minimum value; typed values are clamped to it on blur and the steppers respect it. */
   readonly min: import("@angular/core").InputSignal<number | undefined>;
   /** Maximum value; typed values are clamped to it on blur. */
@@ -6541,6 +6023,8 @@ export declare class NumberInputComponent implements ControlValueAccessor {
   readonly allowNegative: import("@angular/core").InputSignal<boolean>;
   /** Accessible name for the field when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements whose text names the field, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   /** `id` applied to the native input and label `for`; auto-generated when omitted. */
   readonly id: import("@angular/core").InputSignal<string>;
   /** Current field value; `null` when empty. Two-way bindable via `[(value)]`. */
@@ -6587,26 +6071,6 @@ export declare class NumberInputComponent implements ControlValueAccessor {
   private clampToBounds;
   static ɵfac: i0.ɵɵFactoryDeclaration<NumberInputComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<NumberInputComponent, "ea-number-input", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -6617,26 +6081,6 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -6647,11 +6091,6 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "min": {
       "alias": "min";
       "required": false;
@@ -6682,6 +6121,11 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
+      "required": false;
+      "isSignal": true;
+    };
     "id": {
       "alias": "id";
       "required": false;
@@ -7024,7 +6468,7 @@ export declare class PieChartComponent {
   }, never, never, true, never>;
 }
 /** Semantic colour scheme of the progress bar. */
-export type ProgressBarVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type ProgressBarVariant = EaStatusVariant;
 /** Visual height of the progress bar. */
 export type ProgressBarSize = EaSize;
 /**
@@ -7036,7 +6480,7 @@ export declare class ProgressBarComponent {
   protected readonly i18n: EagamiI18nService;
   readonly value: import("@angular/core").InputSignal<number>;
   readonly max: import("@angular/core").InputSignal<number>;
-  readonly variant: import("@angular/core").InputSignal<ProgressBarVariant>;
+  readonly variant: import("@angular/core").InputSignal<EaStatusVariant>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly label: import("@angular/core").InputSignal<string | undefined>;
   /** Shows the rounded percentage alongside the label. */
@@ -7110,26 +6554,12 @@ export type RadioOrientation = 'vertical' | 'horizontal';
  * shared state (name, size, disabled) for its options and integrates with
  * Angular forms via `ControlValueAccessor`.
  */
-export declare class RadioGroupComponent implements ControlValueAccessor {
+export declare class RadioGroupComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly id: import("@angular/core").InputSignal<string>;
   readonly name: import("@angular/core").InputSignal<string>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly orientation: import("@angular/core").InputSignal<RadioOrientation>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the group, such as a label outside the component. */
   readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
@@ -7178,51 +6608,6 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -7306,28 +6691,14 @@ type Thumb = 'low' | 'high';
  * overlap (where the user yanks the low thumb past the high) is resolved by
  * keeping the moving thumb on its side and the other thumb pinned.
  */
-export declare class RangeSliderComponent implements ControlValueAccessor {
+export declare class RangeSliderComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   private readonly i18n;
   readonly trackEl: import("@angular/core").Signal<ElementRef<HTMLDivElement> | undefined>;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly min: import("@angular/core").InputSignal<number>;
   readonly max: import("@angular/core").InputSignal<number>;
   readonly step: import("@angular/core").InputSignal<number>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   readonly showValue: import("@angular/core").InputSignal<boolean>;
   readonly showMinMaxLabels: import("@angular/core").InputSignal<boolean>;
   readonly formatValue: import("@angular/core").InputSignal<(value: number) => string>;
@@ -7385,46 +6756,6 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
   private commitThumb;
   static ɵfac: i0.ɵɵFactoryDeclaration<RangeSliderComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<RangeSliderComponent, "ea-range-slider", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "min": {
       "alias": "min";
       "required": false;
@@ -7450,11 +6781,6 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "showValue": {
       "alias": "showValue";
       "required": false;
@@ -7524,32 +6850,18 @@ export type RatingSize = EaSize;
  * Integrates with Angular forms via `ControlValueAccessor`. Emits the new
  * value through the `value` model (numeric 0..max in 1 or 0.5 increments).
  */
-export declare class RatingComponent implements ControlValueAccessor {
+export declare class RatingComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   constructor();
   private readonly starsEl;
   protected readonly i18n: EagamiI18nService;
-  readonly label: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the rating, such as a label outside the component. */
   readonly ariaLabelledby: 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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly min: import("@angular/core").InputSignal<number>;
   readonly max: import("@angular/core").InputSignal<number>;
   readonly allowHalf: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   /** Clicking the current value clears the rating back to 0. */
   readonly clearable: import("@angular/core").InputSignal<boolean>;
   /** Standalone component class rendered for empty / full positions. */
@@ -7559,6 +6871,8 @@ export declare class RatingComponent implements ControlValueAccessor {
   readonly id: import("@angular/core").InputSignal<string>;
   /** Current rating value, 0..max in 1 (or 0.5 when `allowHalf`) increments. */
   readonly value: import("@angular/core").ModelSignal<number>;
+  /** Fires with the new value whenever the user picks a rating. */
+  readonly changed: import("@angular/core").OutputEmitterRef<number>;
   /** Fires when the user pre-selects a value via hover; `null` when the cursor leaves. */
   readonly hoverChanged: import("@angular/core").OutputEmitterRef<number | null>;
   protected readonly hoverValue: import("@angular/core").WritableSignal<number | null>;
@@ -7609,51 +6923,11 @@ export declare class RatingComponent implements ControlValueAccessor {
   private computePointerValue;
   static ɵfac: i0.ɵɵFactoryDeclaration<RatingComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<RatingComponent, "ea-rating", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
     "ariaLabelledby": {
       "alias": "aria-labelledby";
       "required": false;
       "isSignal": true;
     };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "size": {
       "alias": "size";
       "required": false;
@@ -7684,11 +6958,6 @@ export declare class RatingComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "clearable": {
       "alias": "clearable";
       "required": false;
@@ -7716,6 +6985,7 @@ export declare class RatingComponent implements ControlValueAccessor {
     };
   }, {
     "value": "valueChange";
+    "changed": "changed";
     "hoverChanged": "hoverChanged";
   }, never, never, true, never>;
 }
@@ -7727,25 +6997,11 @@ export type SegmentedSize = EaSize;
  * and `ControlValueAccessor`, with full keyboard support
  * (arrow keys, Home/End, Enter/Space).
  */
-export declare class SegmentedComponent implements ControlValueAccessor {
+export declare class SegmentedComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly buttonEls: import("@angular/core").Signal<readonly ElementRef<HTMLButtonElement>[]>;
   readonly options: import("@angular/core").InputSignal<SelectOption[]>;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements whose text names the group, such as a label outside the component. */
@@ -7788,46 +7044,6 @@ export declare class SegmentedComponent implements ControlValueAccessor {
       "required": true;
       "isSignal": true;
     };
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "size": {
       "alias": "size";
       "required": false;
@@ -7838,11 +7054,6 @@ export declare class SegmentedComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "fullWidth": {
       "alias": "fullWidth";
       "required": false;
@@ -7916,32 +7127,14 @@ export declare class SkeletonComponent {
 }
 /** Visual size of the slider track and thumb. */
 export type SliderSize = EaSize;
-export declare class SliderComponent implements ControlValueAccessor {
+export declare class SliderComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   private readonly i18n;
   readonly trackEl: import("@angular/core").Signal<ElementRef<HTMLDivElement> | undefined>;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
-  /** Force the error-state styling without binding `errorMsg`. Lets consumers
-   *  render the error text themselves (e.g. above the slider in a form layout)
-   *  while still getting the built-in recolour of the fill and thumb. */
-  readonly hasError: import("@angular/core").InputSignal<boolean>;
   readonly min: import("@angular/core").InputSignal<number>;
   readonly max: import("@angular/core").InputSignal<number>;
   readonly step: import("@angular/core").InputSignal<number>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   readonly showValue: import("@angular/core").InputSignal<boolean>;
   readonly showMinMaxLabels: import("@angular/core").InputSignal<boolean>;
   readonly formatValue: import("@angular/core").InputSignal<(value: number) => string>;
@@ -7954,94 +7147,48 @@ export declare class SliderComponent implements ControlValueAccessor {
   /** Group thousands with commas in displayed values (ignored when a custom `formatValue` is set). */
   readonly groupThousands: import("@angular/core").InputSignal<boolean>;
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
-  /** Space-separated ids of the elements whose text names the slider, such as a label outside the component. */
-  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
-  readonly id: import("@angular/core").InputSignal<string>;
-  readonly value: import("@angular/core").ModelSignal<number>;
-  /** Fires with the new (snapped, clamped) numeric value whenever the slider moves. */
-  readonly changed: import("@angular/core").OutputEmitterRef<number>;
-  private readonly _formDisabled;
-  readonly dragging: import("@angular/core").WritableSignal<boolean>;
-  private onChange;
-  private onTouched;
-  readonly isDisabled: import("@angular/core").Signal<boolean>;
-  readonly clampedValue: import("@angular/core").Signal<number>;
-  readonly percent: import("@angular/core").Signal<number>;
-  /** Where each snap value's tick sits along the track. */
-  readonly tickPercents: import("@angular/core").Signal<number[]>;
-  /** Formats a value for display, grouping thousands with commas unless a custom `formatValue` is set. */
-  protected formatDisplay(value: number): string;
-  private readonly errorState;
-  readonly errorText: import("@angular/core").Signal<string | null>;
-  readonly errored: import("@angular/core").Signal<boolean>;
-  readonly showError: import("@angular/core").Signal<boolean>;
-  readonly showHint: import("@angular/core").Signal<boolean>;
-  readonly hostClasses: import("@angular/core").Signal<{
-    [x: string]: boolean;
-    'ea-slider--error': boolean;
-    'ea-slider--disabled': boolean;
-    'ea-slider--dragging': boolean;
-  }>;
-  writeValue(val: number): void;
-  registerOnChange(fn: (value: number) => void): void;
-  registerOnTouched(fn: () => void): void;
-  setDisabledState(isDisabled: boolean): void;
-  handleKeydown(event: KeyboardEvent): void;
-  handlePointerDown(event: PointerEvent): void;
-  handlePointerMove(event: PointerEvent): void;
-  handlePointerUp(event: PointerEvent): void;
-  handleBlur(): void;
-  private updateFromPointer;
-  /** The snap value within the magnet's reach of the pointer, if any. */
-  private magnetTarget;
-  private commitValue;
-  static ɵfac: i0.ɵɵFactoryDeclaration<SliderComponent, never>;
-  static ɵcmp: i0.ɵɵComponentDeclaration<SliderComponent, "ea-slider", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
-    "hasError": {
-      "alias": "hasError";
-      "required": false;
-      "isSignal": true;
-    };
+  /** Space-separated ids of the elements whose text names the slider, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
+  readonly id: import("@angular/core").InputSignal<string>;
+  readonly value: import("@angular/core").ModelSignal<number>;
+  /** Fires with the new (snapped, clamped) numeric value whenever the slider moves. */
+  readonly changed: import("@angular/core").OutputEmitterRef<number>;
+  private readonly _formDisabled;
+  readonly dragging: import("@angular/core").WritableSignal<boolean>;
+  private onChange;
+  private onTouched;
+  readonly isDisabled: import("@angular/core").Signal<boolean>;
+  readonly clampedValue: import("@angular/core").Signal<number>;
+  readonly percent: import("@angular/core").Signal<number>;
+  /** Where each snap value's tick sits along the track. */
+  readonly tickPercents: import("@angular/core").Signal<number[]>;
+  /** Formats a value for display, grouping thousands with commas unless a custom `formatValue` is set. */
+  protected formatDisplay(value: number): string;
+  private readonly errorState;
+  readonly errorText: import("@angular/core").Signal<string | null>;
+  readonly showError: import("@angular/core").Signal<boolean>;
+  readonly showHint: import("@angular/core").Signal<boolean>;
+  readonly hostClasses: import("@angular/core").Signal<{
+    [x: string]: boolean;
+    'ea-slider--error': boolean;
+    'ea-slider--disabled': boolean;
+    'ea-slider--dragging': boolean;
+  }>;
+  writeValue(val: number): void;
+  registerOnChange(fn: (value: number) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(isDisabled: boolean): void;
+  handleKeydown(event: KeyboardEvent): void;
+  handlePointerDown(event: PointerEvent): void;
+  handlePointerMove(event: PointerEvent): void;
+  handlePointerUp(event: PointerEvent): void;
+  handleBlur(): void;
+  private updateFromPointer;
+  /** The snap value within the magnet's reach of the pointer, if any. */
+  private magnetTarget;
+  private commitValue;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SliderComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SliderComponent, "ea-slider", never, {
     "min": {
       "alias": "min";
       "required": false;
@@ -8067,11 +7214,6 @@ export declare class SliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "showValue": {
       "alias": "showValue";
       "required": false;
@@ -8458,33 +7600,27 @@ 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';
+export type SwitchVariant = EaStatusVariant;
 /**
  * On/off toggle styled as a sliding switch. Backed by a visually hidden
  * native checkbox and integrates with Angular forms via
  * `ControlValueAccessor`.
  */
-export declare class SwitchComponent implements ControlValueAccessor {
-  readonly label: import("@angular/core").InputSignal<string | 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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
+export declare class SwitchComponent extends FieldControlBase implements ControlValueAccessor {
   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>;
+  readonly variant: import("@angular/core").InputSignal<EaStatusVariant>;
   /** 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>;
+  /** Space-separated ids of the elements whose text names the switch, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /** Fires with the new checked state whenever the user toggles the switch. */
@@ -8512,31 +7648,6 @@ export declare class SwitchComponent implements ControlValueAccessor {
   handleChange(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<SwitchComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SwitchComponent, "ea-switch", 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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "size": {
       "alias": "size";
       "required": false;
@@ -8562,13 +7673,13 @@ export declare class SwitchComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
+    "ariaLabel": {
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
-    "ariaLabel": {
-      "alias": "aria-label";
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
       "required": false;
       "isSignal": true;
     };
@@ -8731,10 +7842,10 @@ export declare class TooltipDirective implements OnDestroy {
    */
   readonly whenClipped: import("@angular/core").InputSignal<boolean>;
   /**
-   * Max width in px; the text wraps at this width. Clamped to a 50px floor, and
-   * to the viewport, which no value can push the bubble past.
+   * Max width, as a CSS length; the text wraps at this width. Clamped to a 50px
+   * floor, and to the viewport, which no value can push the bubble past.
    */
-  readonly maxWidth: import("@angular/core").InputSignal<number | undefined>;
+  readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
   /**
    * Wait in ms before the bubble appears on hover or keyboard focus, so a
    * pointer passing over the trigger does not flash it. Leaving the trigger
@@ -8843,7 +7954,7 @@ export declare class TooltipDirective implements OnDestroy {
   }, {}, never, never, true, never>;
 }
 /** Semantic colour scheme of a tag. */
-export type TagVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type TagVariant = EaStatusVariant;
 /** Visual size of a tag. */
 export type TagSize = EaSize;
 /** Where a clipped label reveals its full text, or `none` to suppress it. */
@@ -8862,7 +7973,7 @@ export declare class TagComponent {
   private readonly i18n;
   private readonly destroyRef;
   private readonly labelEl;
-  readonly variant: import("@angular/core").InputSignal<TagVariant>;
+  readonly variant: import("@angular/core").InputSignal<EaStatusVariant>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   /** Optional icon component rendered before the label. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
@@ -8870,11 +7981,11 @@ export declare class TagComponent {
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly removeLabel: import("@angular/core").InputSignal<string | undefined>;
   /**
-   * Widest the chip may grow: a number of px, or any CSS length for a chip that
-   * has to give way to its container (`'100%'` in a responsive grid cell).
+   * Widest the chip may grow, as a CSS length; `'100%'` lets the chip give way
+   * to its container in a responsive grid cell.
    * Also settable in CSS as `--ea-tag-max-width`, which this input overrides.
    */
-  readonly maxWidth: import("@angular/core").InputSignal<string | number | undefined>;
+  readonly maxWidth: import("@angular/core").InputSignal<string | undefined>;
   /**
    * 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
@@ -8916,8 +8027,6 @@ export declare class TagComponent {
     'ea-tag--disabled': boolean;
     'ea-tag--uppercase': boolean;
   }>;
-  /** `maxWidth` as a CSS length; a bare number is px, as the input documents. */
-  protected readonly resolvedMaxWidth: import("@angular/core").Signal<string | null>;
   /** 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>;
@@ -9010,17 +8119,12 @@ export interface TextareaSelection {
  * through `getSelection()` and `insertText()`, and integrates with Angular
  * forms via `ControlValueAccessor`.
  */
-export declare class TextareaComponent implements ControlValueAccessor {
+export declare class TextareaComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   readonly textareaEl: import("@angular/core").Signal<ElementRef<HTMLTextAreaElement> | undefined>;
-  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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   /** Accessible name for the control when no visible `label` is set. */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /** Space-separated ids of the elements whose text names the field, such as a label outside the component. */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
   /**
    * Hints typed into the empty field one character at a time, trailed by a
@@ -9031,27 +8135,22 @@ export declare class TextareaComponent implements ControlValueAccessor {
    */
   readonly typedPlaceholder: import("@angular/core").InputSignal<readonly string[]>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
-  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 | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
   readonly resize: import("@angular/core").InputSignal<TextareaResize>;
   readonly maxLength: import("@angular/core").InputSignal<number | undefined>;
   /** Shows the number of characters typed below the field, against `maxLength` when one is set. */
   readonly showCount: import("@angular/core").InputSignal<boolean>;
-  /** Optional pixel ceiling for the textarea's height. Beyond it, the inner
-   * field scrolls vertically instead of growing. */
-  readonly maxHeight: import("@angular/core").InputSignal<number | undefined>;
-  /** Optional pixel floor for the textarea's height. Clamped so it never drops
-   * below the default height. */
-  readonly minHeight: import("@angular/core").InputSignal<number | undefined>;
+  /** Optional ceiling for the textarea's height, as a CSS length. Beyond it,
+   * the inner field scrolls vertically instead of growing. */
+  readonly maxHeight: import("@angular/core").InputSignal<string | undefined>;
+  /** Optional floor for the textarea's height, as a CSS length. Clamped so it
+   * never drops below the default height. */
+  readonly minHeight: import("@angular/core").InputSignal<string | undefined>;
   readonly id: import("@angular/core").InputSignal<string>;
   readonly value: import("@angular/core").ModelSignal<string>;
+  /** Fires with the new value whenever the user edits the textarea. */
+  readonly changed: import("@angular/core").OutputEmitterRef<string>;
   readonly isFocused: import("@angular/core").WritableSignal<boolean>;
   private readonly _formDisabled;
   /** Fires when the textarea receives focus. */
@@ -9103,28 +8202,13 @@ export declare class TextareaComponent implements ControlValueAccessor {
   insertText(text: string): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<TextareaComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<TextareaComponent, "ea-textarea", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
+    "ariaLabel": {
+      "alias": "aria-label";
       "required": false;
       "isSignal": true;
     };
-    "ariaLabel": {
-      "alias": "aria-label";
+    "ariaLabelledby": {
+      "alias": "aria-labelledby";
       "required": false;
       "isSignal": true;
     };
@@ -9143,26 +8227,6 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -9173,11 +8237,6 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
-    "required": {
-      "alias": "required";
-      "required": false;
-      "isSignal": true;
-    };
     "resize": {
       "alias": "resize";
       "required": false;
@@ -9215,6 +8274,7 @@ export declare class TextareaComponent implements ControlValueAccessor {
     };
   }, {
     "value": "valueChange";
+    "changed": "changed";
     "focused": "focused";
     "blurred": "blurred";
   }, never, never, true, never>;
@@ -9253,7 +8313,7 @@ interface ParsedTime {
  * unit), focus auto-advances to the next column. Backspace clears the typed
  * buffer; Escape closes the popover.
  */
-export declare class TimePickerComponent implements ControlValueAccessor {
+export declare class TimePickerComponent extends LabelledFieldControlBase implements ControlValueAccessor {
   protected readonly triggerEl: import("@angular/core").Signal<ElementRef<HTMLElement> | undefined>;
   protected readonly inputEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
   protected readonly hoursEl: import("@angular/core").Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -9262,24 +8322,10 @@ export declare class TimePickerComponent implements ControlValueAccessor {
   protected readonly i18n: EagamiI18nService;
   private readonly destroyRef;
   private readonly injector;
-  readonly label: import("@angular/core").InputSignal<string | undefined>;
-  /** Optional icon component rendered before the label text. */
-  readonly labelIcon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
-  /** 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>;
-  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
-  readonly optional: import("@angular/core").InputSignal<boolean>;
   readonly placeholder: import("@angular/core").InputSignal<string | undefined>;
   readonly size: import("@angular/core").InputSignal<EaSize>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
-  readonly required: import("@angular/core").InputSignal<boolean>;
-  readonly hint: import("@angular/core").InputSignal<string | undefined>;
-  readonly errorMsg: import("@angular/core").InputSignal<string | undefined>;
-  /** Per-validator-key message overrides for a bound form control (e.g. `{ required: '...' }`). */
-  readonly errorMessages: import("@angular/core").InputSignal<Partial<Record<string, string | null>> | undefined>;
-  /** When the error shows: `'change'` once the user changes the field and leaves it, `'blur'` once they leave it, even unchanged, `'touch'` the same but live while they edit; unset follows the app-wide `forms` option of `provideEagamiUi`. */
-  readonly showErrorsOn: import("@angular/core").InputSignal<EaShowErrorsOn | undefined>;
   /** Display format for the trigger label. Wire value is always 24h. */
   readonly format: import("@angular/core").InputSignal<TimePickerFormat>;
   readonly includeSeconds: import("@angular/core").InputSignal<boolean>;
@@ -9431,26 +8477,6 @@ export declare class TimePickerComponent implements ControlValueAccessor {
   private commit;
   static ɵfac: i0.ɵɵFactoryDeclaration<TimePickerComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<TimePickerComponent, "ea-time-picker", never, {
-    "label": {
-      "alias": "label";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelIcon": {
-      "alias": "labelIcon";
-      "required": false;
-      "isSignal": true;
-    };
-    "labelHelp": {
-      "alias": "labelHelp";
-      "required": false;
-      "isSignal": true;
-    };
-    "optional": {
-      "alias": "optional";
-      "required": false;
-      "isSignal": true;
-    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -9471,31 +8497,6 @@ export declare class TimePickerComponent implements ControlValueAccessor {
       "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;
-    };
-    "showErrorsOn": {
-      "alias": "showErrorsOn";
-      "required": false;
-      "isSignal": true;
-    };
     "format": {
       "alias": "format";
       "required": false;
@@ -9599,7 +8600,7 @@ export declare class TimelineComponent {
   }, {}, never, never, true, never>;
 }
 /** Semantic colour scheme of a toast. */
-export type ToastVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+export type ToastVariant = EaStatusVariant;
 /** One run of a toast's title or message. */
 export interface ToastSegment {
   text: string;
@@ -10137,8 +9138,8 @@ export declare function iconDisplayName(iconOrSlug: IconComponentType | string):
  * sorted by `slug` so that consumers iterating it (the `/ui/icons` reference
  * page, the sandbox gallery, downstream pickers) get a stable alphabetical
  * order where a base icon always precedes its `-2` variant (e.g. `facebook`
- * before `facebook-2`). The literal below is kept in class-name order so a new
- * icon has one obvious insertion point; the `.sort()` at the bottom is the
+ * before `facebook-2`). The imports and the class-name-ordered literal below
+ * are generated by `pnpm regen-docs`; the `.sort()` at the bottom is the
  * source of truth for consumers.
  *
  * Bundle-size note: importing this constant brings every icon component into
@@ -10434,6 +9435,13 @@ export declare class BanIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<BanIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<BanIconComponent, "ea-icon-ban", never, {}, {}, never, never, true, never>;
 }
+export declare class BanknoteIconComponent extends IconComponentBase {
+  static readonly slug = "banknote";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BanknoteIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BanknoteIconComponent, "ea-icon-banknote", never, {}, {}, never, never, true, never>;
+}
 export declare class BarChartIconComponent extends IconComponentBase {
   static readonly slug = "bar-chart";
   static readonly category: IconCategory;
@@ -10638,6 +9646,13 @@ export declare class BuildingIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<BuildingIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<BuildingIconComponent, "ea-icon-building", never, {}, {}, never, never, true, never>;
 }
+export declare class BusIconComponent extends IconComponentBase {
+  static readonly slug = "bus";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BusIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BusIconComponent, "ea-icon-bus", never, {}, {}, never, never, true, never>;
+}
 export declare class CakeIconComponent extends IconComponentBase {
   static readonly slug = "cake";
   static readonly category: IconCategory;
@@ -11479,6 +10494,13 @@ export declare class FileIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<FileIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FileIconComponent, "ea-icon-file", never, {}, {}, never, never, true, never>;
 }
+export declare class FileArchiveIconComponent extends IconComponentBase {
+  static readonly slug = "file-archive";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FileArchiveIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<FileArchiveIconComponent, "ea-icon-file-archive", never, {}, {}, never, never, true, never>;
+}
 export declare class FileAudioIconComponent extends IconComponentBase {
   static readonly slug = "file-audio";
   static readonly category: IconCategory;
@@ -11990,6 +11012,13 @@ export declare class InboxIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<InboxIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<InboxIconComponent, "ea-icon-inbox", never, {}, {}, never, never, true, never>;
 }
+export declare class IndentIconComponent extends IconComponentBase {
+  static readonly slug = "indent";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<IndentIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<IndentIconComponent, "ea-icon-indent", never, {}, {}, never, never, true, never>;
+}
 export declare class InfoIconComponent extends IconComponentBase {
   static readonly slug = "info";
   static readonly category: IconCategory;
@@ -12596,6 +11625,13 @@ export declare class OctagonIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<OctagonIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<OctagonIconComponent, "ea-icon-octagon", never, {}, {}, never, never, true, never>;
 }
+export declare class OutdentIconComponent extends IconComponentBase {
+  static readonly slug = "outdent";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<OutdentIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<OutdentIconComponent, "ea-icon-outdent", never, {}, {}, never, never, true, never>;
+}
 export declare class PackageIconComponent extends IconComponentBase {
   static readonly slug = "package";
   static readonly category: IconCategory;
@@ -12751,6 +11787,13 @@ export declare class PiggyBankIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<PiggyBankIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<PiggyBankIconComponent, "ea-icon-piggy-bank", never, {}, {}, never, never, true, never>;
 }
+export declare class PillIconComponent extends IconComponentBase {
+  static readonly slug = "pill";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PillIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<PillIconComponent, "ea-icon-pill", never, {}, {}, never, never, true, never>;
+}
 export declare class PinIconComponent extends IconComponentBase {
   static readonly slug = "pin";
   static readonly category: IconCategory;
@@ -13133,6 +12176,13 @@ export declare class SaveIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SaveIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SaveIconComponent, "ea-icon-save", never, {}, {}, never, never, true, never>;
 }
+export declare class ScaleIconComponent extends IconComponentBase {
+  static readonly slug = "scale";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ScaleIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ScaleIconComponent, "ea-icon-scale", never, {}, {}, never, never, true, never>;
+}
 export declare class ScanIconComponent extends IconComponentBase {
   static readonly slug = "scan";
   static readonly category: IconCategory;
@@ -13288,6 +12338,41 @@ export declare class SidebarIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SidebarIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SidebarIconComponent, "ea-icon-sidebar", never, {}, {}, never, never, true, never>;
 }
+export declare class SignalFullIconComponent extends IconComponentBase {
+  static readonly slug = "signal-full";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalFullIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalFullIconComponent, "ea-icon-signal-full", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalHighIconComponent extends IconComponentBase {
+  static readonly slug = "signal-high";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalHighIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalHighIconComponent, "ea-icon-signal-high", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalLowIconComponent extends IconComponentBase {
+  static readonly slug = "signal-low";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalLowIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalLowIconComponent, "ea-icon-signal-low", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalMediumIconComponent extends IconComponentBase {
+  static readonly slug = "signal-medium";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalMediumIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalMediumIconComponent, "ea-icon-signal-medium", never, {}, {}, never, never, true, never>;
+}
+export declare class SignalNoneIconComponent extends IconComponentBase {
+  static readonly slug = "signal-none";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SignalNoneIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SignalNoneIconComponent, "ea-icon-signal-none", never, {}, {}, never, never, true, never>;
+}
 export declare class SineWaveIconComponent extends IconComponentBase {
   static readonly slug = "sine-wave";
   static readonly category: IconCategory;
@@ -13381,6 +12466,20 @@ export declare class SoccerBallIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<SoccerBallIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<SoccerBallIconComponent, "ea-icon-soccer-ball", never, {}, {}, never, never, true, never>;
 }
+export declare class SortAscendingIconComponent extends IconComponentBase {
+  static readonly slug = "sort-ascending";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SortAscendingIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SortAscendingIconComponent, "ea-icon-sort-ascending", never, {}, {}, never, never, true, never>;
+}
+export declare class SortDescendingIconComponent extends IconComponentBase {
+  static readonly slug = "sort-descending";
+  static readonly category: IconCategory;
+  static readonly tags: ReadonlyArray<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SortDescendingIconComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SortDescendingIconComponent, "ea-icon-sort-descending", never, {}, {}, never, never, true, never>;
+}
 export declare class SparklesIconComponent extends IconComponentBase {
   static readonly slug = "sparkles";
   static readonly category: IconCategory;