@eagami/ui 5.70.0 → 5.71.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eagami/ui",
-  "version": "5.70.0",
+  "version": "5.71.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/src/styles/_rtl.scss

@@ -31,8 +31,10 @@
 
 // Native fields use dir="auto" so typed LTR text stays LTR, but that resolves
 // an empty field to LTR and parks its placeholder on the left. Pin them to the
-// inline-end edge so every RTL field reads from the right like the others.
+// inline-end edge so every RTL field reads from the right like the others. The
+// typed placeholder drawn over an empty field follows its placeholder.
 [dir='rtl'] input[dir='auto'],
-[dir='rtl'] textarea[dir='auto'] {
+[dir='rtl'] textarea[dir='auto'],
+[dir='rtl'] ea-typed-placeholder[dir='auto'] {
   text-align: right;
 }

package/types/eagami-ui.d.ts

@@ -1930,14 +1930,22 @@ export declare class ButtonComponent {
   readonly ariaLabelledby: import("@angular/core").InputSignal<string | undefined>;
   /** Space-separated ids of the elements that describe the button, e.g. a hint. */
   readonly ariaDescribedby: import("@angular/core").InputSignal<string | undefined>;
+  /** Whether the content this button shows and hides is open, for a disclosure toggle. */
+  readonly ariaExpanded: import("@angular/core").InputSignal<boolean | undefined>;
+  /** Id of the element this button shows, hides or otherwise controls. */
+  readonly ariaControls: import("@angular/core").InputSignal<string | undefined>;
+  private readonly renderer;
   private readonly buttonEl;
+  private readonly ownedAria;
   /** Fires when the button is activated; suppressed while disabled or loading. */
   readonly clicked: import("@angular/core").OutputEmitterRef<MouseEvent>;
   readonly isDisabled: import("@angular/core").Signal<boolean>;
   readonly hostClasses: import("@angular/core").Signal<Record<string, boolean>>;
+  constructor();
   handleClick(event: MouseEvent): void;
   /** Moves keyboard focus to the underlying native button. */
   focus(): void;
+  private reflectAria;
   static ɵfac: i0.ɵɵFactoryDeclaration<ButtonComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ButtonComponent, "ea-button", never, {
     "variant": {
@@ -2005,6 +2013,16 @@ export declare class ButtonComponent {
       "required": false;
       "isSignal": true;
     };
+    "ariaExpanded": {
+      "alias": "aria-expanded";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaControls": {
+      "alias": "aria-controls";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "clicked": "clicked";
   }, never, ["[slot=prefix]", "*", "[slot=suffix]"], true, never>;
@@ -5218,6 +5236,26 @@ export declare class FileUploaderComponent implements ControlValueAccessor {
     "dragOverChanged": "dragOverChanged";
   }, never, ["[icon]"], true, never>;
 }
+/** Live state of a field's typewriter placeholder. */
+interface TypedPlaceholder {
+  /** Whether the typed layer stands in for the native placeholder. */
+  readonly animating: Signal<boolean>;
+  /** The whole hint in play, for the native `placeholder` attribute. */
+  readonly hint: Signal<string>;
+  /** The part of the hint typed so far. */
+  readonly text: Signal<string>;
+  /** Whether characters are still arriving; the cursor blinks only once they stop. */
+  readonly typing: Signal<boolean>;
+}
+/**
+ * Types `hints` into a field's placeholder one character at a time, holds each
+ * whole hint, then clears it and types the next, looping. Under
+ * `prefers-reduced-motion: reduce` it swaps whole hints instead and never
+ * animates. It starts in the browser after the first render, restarts when the
+ * hints change, and clears its timer on destroy. The timers run outside the
+ * zone so the endless loop never holds the app unstable.
+ */
+declare function injectTypedPlaceholder(hints: Signal<readonly string[]>): TypedPlaceholder;
 /** Visual size of the input. */
 export type InputSize = EaSize;
 /** HTML `type` attribute applied to the underlying `<input>`. */
@@ -5256,6 +5294,14 @@ export declare class InputComponent implements ControlValueAccessor {
   readonly type: import("@angular/core").InputSignal<InputType>;
   /** Placeholder shown while the field is empty. */
   readonly placeholder: import("@angular/core").InputSignal<string>;
+  /**
+   * Hints typed into the empty field one character at a time, trailed by a
+   * blinking cursor, each held and then replaced by the next, in a loop. The
+   * native placeholder carries the whole current hint for assistive
+   * technology, and under `prefers-reduced-motion` the hints swap whole without
+   * a cursor. Takes the place of `placeholder` while it holds any hints.
+   */
+  readonly typedPlaceholder: import("@angular/core").InputSignal<readonly string[]>;
   /** Leading icon component rendered before the text, e.g. a search or filter glyph. */
   readonly icon: import("@angular/core").InputSignal<Type<unknown> | undefined>;
   /** Keeps the leading icon while the field has a value; when false it shows only alongside the placeholder. */
@@ -5310,6 +5356,9 @@ export declare class InputComponent implements ControlValueAccessor {
   private onChange;
   private onTouched;
   readonly isDisabled: import("@angular/core").Signal<boolean>;
+  protected readonly typed: TypedPlaceholder;
+  protected readonly typedPlaceholderShown: import("@angular/core").Signal<boolean>;
+  protected readonly nativePlaceholder: import("@angular/core").Signal<string>;
   readonly effectiveType: import("@angular/core").Signal<InputType>;
   private readonly errorState;
   readonly errorText: import("@angular/core").Signal<string | null>;
@@ -5409,6 +5458,11 @@ export declare class InputComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "typedPlaceholder": {
+      "alias": "typedPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
     "icon": {
       "alias": "icon";
       "required": false;
@@ -8783,6 +8837,14 @@ export declare class TextareaComponent implements ControlValueAccessor {
   /** 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>;
+  /**
+   * Hints typed into the empty field one character at a time, trailed by a
+   * blinking cursor, each held and then replaced by the next, in a loop. The
+   * native placeholder carries the whole current hint for assistive
+   * technology, and under `prefers-reduced-motion` the hints swap whole without
+   * a cursor. Takes the place of `placeholder` while it holds any hints.
+   */
+  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>;
@@ -8812,6 +8874,9 @@ export declare class TextareaComponent implements ControlValueAccessor {
   private onChange;
   private onTouched;
   readonly isDisabled: import("@angular/core").Signal<boolean>;
+  protected readonly typed: TypedPlaceholder;
+  protected readonly typedPlaceholderShown: import("@angular/core").Signal<boolean>;
+  protected readonly nativePlaceholder: import("@angular/core").Signal<string>;
   private readonly errorState;
   readonly errorText: import("@angular/core").Signal<string | null>;
   readonly hasError: import("@angular/core").Signal<boolean>;
@@ -8881,6 +8946,11 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "typedPlaceholder": {
+      "alias": "typedPlaceholder";
+      "required": false;
+      "isSignal": true;
+    };
     "size": {
       "alias": "size";
       "required": false;