@eagami/ui 5.71.0 → 5.71.2

package/package.json

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

package/types/eagami-ui.d.ts

@@ -1,6 +1,29 @@
 import * as i0 from "@angular/core";
 import { AfterContentChecked, ElementRef, EnvironmentProviders, InjectionToken, Injector, OnDestroy, OnInit, Signal, TemplateRef, Type } from "@angular/core";
 import { AbstractControl, ControlValueAccessor } from "@angular/forms";
+/**
+ * When a form component shows its validation error.
+ *
+ * - `'change'`: once the user changes the field and leaves it, or submits the
+ *   form. A field the user tabs past stays quiet, and a new error waits until
+ *   focus leaves the field.
+ * - `'blur'`: as soon as the user leaves the field, even unchanged, while a new
+ *   error still waits until focus leaves the field.
+ * - `'touch'`: as soon as the user leaves the field, even unchanged, and live
+ *   while they edit it after that.
+ */
+type EaShowErrorsOn = 'change' | 'blur' | 'touch';
+/**
+ * App-wide defaults for form components, set through
+ * `provideEagamiUi({ forms })`. A form component's own `showErrorsOn` input
+ * wins over these for that one field.
+ */
+interface EagamiFormsConfig {
+  /** When form components show their validation errors; `'change'` by default. */
+  showErrorsOn?: EaShowErrorsOn;
+}
+/** DI token carrying the consumer-supplied form defaults. */
+declare const EAGAMI_FORMS_CONFIG: InjectionToken<EagamiFormsConfig>;
 /**
  * BCP 47 locale tags supported out of the box. Consumers select one of these
  * via `provideEagamiUi({ locale })` or `EagamiI18nService.setLocale()`.
@@ -391,8 +414,8 @@ export interface ModePalette {
 }
 /**
  * Full provider configuration for `provideEagamiUi()`. Extends the i18n config
- * with an optional brand palette; omit `palette` to keep the un-themed SCSS
- * defaults.
+ * with an optional brand palette and form error timing; omit `palette` to keep
+ * the un-themed SCSS defaults.
  */
 export interface EagamiUiConfig extends EagamiI18nConfig {
   /**
@@ -401,6 +424,11 @@ export interface EagamiUiConfig extends EagamiI18nConfig {
    * pairing. A contrast violation throws at bootstrap.
    */
   palette?: EagamiPaletteConfig;
+  /**
+   * App-wide defaults for form components, such as `showErrorsOn` for when
+   * they show their validation errors. Omit it to keep the `'change'` default.
+   */
+  forms?: EagamiFormsConfig;
 }
 /**
  * Configures Eagami UI for the application.
@@ -924,6 +952,8 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   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>;
@@ -1061,6 +1091,11 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "minLength": {
       "alias": "minLength";
       "required": false;
@@ -2167,6 +2202,8 @@ export declare class CheckboxComponent implements ControlValueAccessor {
   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
@@ -2234,6 +2271,11 @@ export declare class CheckboxComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;
@@ -2550,6 +2592,8 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
   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. */
@@ -2764,6 +2808,11 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "showAlpha": {
       "alias": "showAlpha";
       "required": false;
@@ -3571,6 +3620,8 @@ export declare class CodeInputComponent implements ControlValueAccessor {
   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>;
@@ -3663,6 +3714,11 @@ export declare class CodeInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -3753,6 +3809,8 @@ export declare class DatePickerComponent implements ControlValueAccessor {
   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. */
@@ -3925,6 +3983,11 @@ export declare class DatePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "minDate": {
       "alias": "minDate";
       "required": false;
@@ -4418,6 +4481,8 @@ export declare class DropdownComponent implements ControlValueAccessor {
   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. */
@@ -4573,6 +4638,11 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "id": {
       "alias": "id";
       "required": false;
@@ -4818,6 +4888,8 @@ export declare class FormFieldComponent {
   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. */
@@ -4872,6 +4944,11 @@ export declare class FormFieldComponent {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "required": {
       "alias": "required";
       "required": false;
@@ -4904,6 +4981,8 @@ interface ControlErrorStateConfig {
   errorMsg: Signal<string | null | undefined>;
   /** Per-error-key overrides for auto-derived validation messages. */
   errorMessages: Signal<EaErrorMessages | undefined>;
+  /** Field-level `showErrorsOn`; `undefined` falls back to the app-wide `forms` config. */
+  showErrorsOn?: Signal<EaShowErrorsOn | undefined>;
 }
 interface ControlErrorState {
   /** Error text to display, or `null` when the field is valid or untouched. */
@@ -4917,14 +4996,15 @@ interface ControlErrorState {
  * default for the active `ValidationErrors` key.
  *
  * Auto-derived messages surface only once the bound control is `invalid &&
- * touched`, and a new one waits while focus is still inside the field, until
- * the user leaves it or submits the form, so nothing is flagged mid-edit. A
- * field the user only passed through, leaving it without changing it, stays
- * quiet until they change it or the form is submitted, so tabbing past an
- * empty required field never flags it. A
- * message already showing follows the value as it is typed and clears the
- * moment it is fixed. A message revealed by a pointer press moving focus away
- * waits until that press has landed its click. The control arrives as a signal
+ * touched`. Under the default `showErrorsOn: 'change'`, a new one waits while
+ * focus is still inside the field, until the user leaves it or submits the
+ * form, so nothing is flagged mid-edit, and a field the user only passed
+ * through, leaving it without changing it, stays quiet until they change it or
+ * the form is submitted, so tabbing past an empty required field never flags
+ * it. `'blur'` drops the second hold and `'touch'` drops both. A message
+ * already showing follows the value as it is typed and clears the moment it is
+ * fixed. A message revealed by a pointer press moving focus away waits until
+ * that press has landed its click, in every mode. The control arrives as a signal
  * so callers decide how it is resolved: from the host's own `NgControl` (CVA
  * components) or from projected content (`<ea-form-field>`).
  */
@@ -5000,6 +5080,8 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   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
@@ -5149,6 +5231,11 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;
@@ -5314,6 +5401,8 @@ export declare class InputComponent implements ControlValueAccessor {
   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. */
@@ -5493,6 +5582,11 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -6057,6 +6151,8 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   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. */
@@ -6301,6 +6397,11 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "searchable": {
       "alias": "searchable";
       "required": false;
@@ -6381,6 +6482,8 @@ export declare class NumberInputComponent implements ControlValueAccessor {
   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. */
@@ -6494,6 +6597,11 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -6985,6 +7093,8 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
   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>;
@@ -7073,6 +7183,11 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -7170,6 +7285,8 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
   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>;
@@ -7268,6 +7385,11 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "min": {
       "alias": "min";
       "required": false;
@@ -7384,6 +7506,8 @@ export declare class RatingComponent implements ControlValueAccessor {
   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>;
@@ -7490,6 +7614,11 @@ export declare class RatingComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;
@@ -7577,6 +7706,8 @@ export declare class SegmentedComponent implements ControlValueAccessor {
   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>;
@@ -7657,6 +7788,11 @@ export declare class SegmentedComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;
@@ -7759,6 +7895,8 @@ export declare class SliderComponent implements ControlValueAccessor {
   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. */
@@ -7859,6 +7997,11 @@ export declare class SliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "hasError": {
       "alias": "hasError";
       "required": false;
@@ -8292,6 +8435,8 @@ export declare class SwitchComponent implements ControlValueAccessor {
   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>;
   /**
    * Status tone for the track: a tinted wash with a toned border while off and
@@ -8352,6 +8497,11 @@ export declare class SwitchComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;
@@ -8850,6 +9000,8 @@ export declare class TextareaComponent implements ControlValueAccessor {
   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>;
@@ -8971,6 +9123,11 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "disabled": {
       "alias": "disabled";
       "required": false;
@@ -9086,6 +9243,8 @@ export declare class TimePickerComponent implements ControlValueAccessor {
   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>;
@@ -9297,6 +9456,11 @@ export declare class TimePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "showErrorsOn": {
+      "alias": "showErrorsOn";
+      "required": false;
+      "isSignal": true;
+    };
     "format": {
       "alias": "format";
       "required": false;
@@ -14034,4 +14198,4 @@ export declare class ZoomOutIconComponent extends IconComponentBase {
   static ɵfac: i0.ɵɵFactoryDeclaration<ZoomOutIconComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ZoomOutIconComponent, "ea-icon-zoom-out", never, {}, {}, never, never, true, never>;
 }
-export type { ChartCurve, ChartLabelOrientation, ChartPointEvent, ChartReferenceLine, ChartSeries, ChartSize, EaErrorMessages, EaValidationErrorKey };
+export type { ChartCurve, ChartLabelOrientation, ChartPointEvent, ChartReferenceLine, ChartSeries, ChartSize, EaErrorMessages, EaShowErrorsOn, EaValidationErrorKey, EagamiFormsConfig };