@eagami/ui 5.69.0 → 5.70.0

package/package.json

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

package/types/eagami-ui.d.ts

@@ -152,6 +152,8 @@ export interface EagamiMessages {
   fieldLabel: {
     /** Accessible name of the button that reveals a field label's help. */
     help: (label: string) => string;
+    /** Note after the label of a field that may be left empty, parentheses included. */
+    optional: string;
   };
   fileUploader: {
     prompt: string;
@@ -907,6 +909,8 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
   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>;
@@ -1002,6 +1006,11 @@ export declare class AutocompleteComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -2512,6 +2521,8 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
   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>;
@@ -2690,6 +2701,11 @@ export declare class ColorPickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -3527,6 +3543,8 @@ export declare class CodeInputComponent implements ControlValueAccessor {
   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>;
@@ -3592,6 +3610,11 @@ export declare class CodeInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -3698,6 +3721,8 @@ export declare class DatePickerComponent implements ControlValueAccessor {
   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. */
@@ -3832,6 +3857,11 @@ export declare class DatePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -4353,6 +4383,8 @@ export declare class DropdownComponent implements ControlValueAccessor {
   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>;
@@ -4463,6 +4495,11 @@ export declare class DropdownComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -4653,11 +4690,15 @@ export declare class FieldLabelComponent {
   readonly help: import("@angular/core").InputSignal<string | TemplateRef<unknown> | undefined>;
   readonly forId: import("@angular/core").InputSignal<string | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
+  /** Adds a muted "(optional)" note after the label, unless `required` is also set. */
+  readonly optional: import("@angular/core").InputSignal<boolean>;
   readonly labelId: import("@angular/core").InputSignal<string | undefined>;
   protected readonly helpOpen: import("@angular/core").WritableSignal<boolean>;
   protected readonly helpId: string;
   protected readonly helpTemplate: import("@angular/core").Signal<TemplateRef<unknown> | null>;
   protected readonly helpTriggerLabel: import("@angular/core").Signal<string>;
+  protected readonly showOptional: import("@angular/core").Signal<boolean>;
+  protected readonly optionalText: import("@angular/core").Signal<string>;
   private readonly helpEl;
   private readonly helpTrigger;
   private readonly helpBubble;
@@ -4693,6 +4734,11 @@ export declare class FieldLabelComponent {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "labelId": {
       "alias": "labelId";
       "required": false;
@@ -4746,6 +4792,8 @@ export declare class FormFieldComponent {
   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. */
@@ -4786,6 +4834,11 @@ export declare class FormFieldComponent {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -4923,6 +4976,8 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -5056,6 +5111,11 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -5178,6 +5238,8 @@ export declare class InputComponent implements ControlValueAccessor {
   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>;
   /** ARIA role applied to the native input, e.g. `combobox` for a typeahead host. */
@@ -5302,6 +5364,11 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -5918,6 +5985,8 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
   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. */
@@ -6113,6 +6182,11 @@ export declare class MultiSelectComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -6241,6 +6315,8 @@ export declare class NumberInputComponent implements ControlValueAccessor {
   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. */
@@ -6334,6 +6410,11 @@ export declare class NumberInputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;
@@ -6844,6 +6925,8 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -6916,6 +6999,11 @@ export declare class RadioGroupComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7022,6 +7110,8 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -7104,6 +7194,11 @@ export declare class RangeSliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7229,6 +7324,8 @@ export declare class RatingComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -7319,6 +7416,11 @@ export declare class RatingComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7415,6 +7517,8 @@ export declare class SegmentedComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -7479,6 +7583,11 @@ export declare class SegmentedComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -7590,6 +7699,8 @@ export declare class SliderComponent implements ControlValueAccessor {
   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: '...' }`). */
@@ -7674,6 +7785,11 @@ export declare class SliderComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "hint": {
       "alias": "hint";
       "required": false;
@@ -8662,6 +8778,8 @@ export declare class TextareaComponent implements ControlValueAccessor {
   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>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
@@ -8748,6 +8866,11 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "aria-label";
       "required": false;
@@ -8882,6 +9005,8 @@ export declare class TimePickerComponent implements ControlValueAccessor {
   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>;
@@ -9057,6 +9182,11 @@ export declare class TimePickerComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "optional": {
+      "alias": "optional";
+      "required": false;
+      "isSignal": true;
+    };
     "placeholder": {
       "alias": "placeholder";
       "required": false;