@eagami/ui 0.12.0 → 1.0.1

package/types/eagami-ui.d.ts

@@ -3,6 +3,11 @@ import { OnDestroy, ElementRef, TemplateRef, AfterViewInit, OnInit } from '@angu
 import { ControlValueAccessor } from '@angular/forms';
 import * as _eagami_ui from '@eagami/ui';
 
+/**
+ * Container for expandable content sections. By default only one item can be
+ * open at a time; set `multi` to allow several to stay expanded together.
+ * Provides a built-in chevron animation and supports per-item disabling.
+ */
 declare class AccordionComponent {
     readonly multi: _angular_core.InputSignal<boolean>;
     readonly expandedItems: _angular_core.WritableSignal<Set<string>>;
@@ -12,6 +17,11 @@ declare class AccordionComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionComponent, "ea-accordion", never, { "multi": { "alias": "multi"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/**
+ * Single expandable section within an `ea-accordion`. Each item exposes a
+ * header button with the supplied `label` and reveals its projected content
+ * when expanded. Must be rendered inside an `ea-accordion`.
+ */
 declare class AccordionItemComponent {
     private readonly accordion;
     readonly value: _angular_core.InputSignal<string>;
@@ -24,32 +34,53 @@ declare class AccordionItemComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AccordionItemComponent, "ea-accordion-item", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Semantic colour scheme of an alert. Drives icon and palette. */
 type AlertVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+/**
+ * Inline banner for surfacing semantic messages such as success confirmations,
+ * warnings, or errors. Optionally dismissible, with a two-way `visible`
+ * binding and an automatically chosen ARIA role based on severity.
+ */
 declare class AlertComponent {
     readonly variant: _angular_core.InputSignal<AlertVariant>;
     readonly dismissible: _angular_core.InputSignal<boolean>;
     readonly visible: _angular_core.ModelSignal<boolean>;
+    /** Fires when the user dismisses the alert via its close button. */
     readonly dismissed: _angular_core.OutputEmitterRef<void>;
     readonly alertClasses: _angular_core.Signal<{
         [x: string]: boolean;
     }>;
+    readonly role: _angular_core.Signal<"alert" | "status">;
+    /** Hides the alert and emits `dismissed`. */
     dismiss(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AlertComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AlertComponent, "ea-alert", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "dismissible": { "alias": "dismissible"; "required": false; "isSignal": true; }; "visible": { "alias": "visible"; "required": false; "isSignal": true; }; }, { "visible": "visibleChange"; "dismissed": "dismissed"; }, never, ["*"], true, never>;
 }
 
-type AutocompleteSize = 'sm' | 'md' | 'lg';
-interface AutocompleteOption {
+/**
+ * Common option shape used by single-select form controls
+ * (autocomplete, dropdown, segmented).
+ */
+interface SelectOption {
     value: string;
     label: string;
     disabled?: boolean;
 }
+
+/** Visual size of the autocomplete input. */
+type AutocompleteSize = 'sm' | 'md' | 'lg';
+/**
+ * Text input paired with a filtered suggestion list. Filters options by
+ * case-insensitive substring match, supports arrow-key navigation, and
+ * implements `ControlValueAccessor` for use with reactive and template-driven
+ * forms.
+ */
 declare class AutocompleteComponent implements ControlValueAccessor {
     private readonly inputEl;
     private readonly hostEl;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly placeholder: _angular_core.InputSignal<string>;
-    readonly options: _angular_core.InputSignal<AutocompleteOption[]>;
+    readonly options: _angular_core.InputSignal<SelectOption[]>;
     readonly size: _angular_core.InputSignal<AutocompleteSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly readonly: _angular_core.InputSignal<boolean>;
@@ -61,24 +92,31 @@ declare class AutocompleteComponent implements ControlValueAccessor {
     readonly emptyMessage: _angular_core.InputSignal<string>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
-    readonly optionSelected: _angular_core.OutputEmitterRef<AutocompleteOption>;
-    readonly valueChanged: _angular_core.OutputEmitterRef<string>;
+    /** Fires when the user picks an option from the suggestion list. */
+    readonly selected: _angular_core.OutputEmitterRef<SelectOption>;
+    /** Fires whenever the input text changes, including on free-text edits. */
+    readonly changed: _angular_core.OutputEmitterRef<string>;
+    /** Fires when the input receives focus. */
+    readonly focused: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Fires when the input loses focus. */
+    readonly blurred: _angular_core.OutputEmitterRef<FocusEvent>;
     readonly isOpen: _angular_core.WritableSignal<boolean>;
-    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
     readonly focusedIndex: _angular_core.WritableSignal<number>;
     private readonly _formDisabled;
     private justSelected;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly resolvedStatus: _angular_core.Signal<"default" | "error">;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
-    readonly filteredOptions: _angular_core.Signal<AutocompleteOption[]>;
+    readonly filteredOptions: _angular_core.Signal<SelectOption[]>;
     readonly showList: _angular_core.Signal<boolean>;
     readonly showEmpty: _angular_core.Signal<boolean>;
     readonly wrapperClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-autocomplete__wrapper--error': boolean;
         'ea-autocomplete__wrapper--focused': boolean;
         'ea-autocomplete__wrapper--disabled': boolean;
     }>;
@@ -87,27 +125,39 @@ declare class AutocompleteComponent implements ControlValueAccessor {
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
     handleInput(event: Event): void;
-    handleFocus(): void;
-    handleBlur(): void;
+    handleFocus(event: FocusEvent): void;
+    handleBlur(event: FocusEvent): void;
     handleKeydown(event: KeyboardEvent): void;
-    selectOption(option: AutocompleteOption): void;
+    /** Programmatically selects the given option, updating the value and closing the list. */
+    selectOption(option: SelectOption): void;
+    /** Closes the suggestion list without changing the current value. */
     close(): void;
+    /** Moves keyboard focus to the underlying text input. */
+    focus(): void;
     private moveFocus;
     onDocumentClick(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AutocompleteComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent, "ea-autocomplete", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxResults": { "alias": "maxResults"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "optionSelected": "optionSelected"; "valueChanged": "valueChanged"; }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AutocompleteComponent, "ea-autocomplete", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "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; }; "minLength": { "alias": "minLength"; "required": false; "isSignal": true; }; "maxResults": { "alias": "maxResults"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "selected": "selected"; "changed": "changed"; "focused": "focused"; "blurred": "blurred"; }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
 }
 
+/** Crop mask shape applied to the exported image. */
 type AvatarEditorShape = 'circle' | 'square';
+/** Result of a successful crop, providing both a `Blob` and a data URL. */
 interface AvatarEditorCropEvent {
     blob: Blob;
     dataUrl: string;
 }
+/** Persisted pan/zoom state, suitable for restoring an in-progress edit. */
 interface AvatarEditorCropState {
     zoom: number;
     offsetX: number;
     offsetY: number;
 }
+/**
+ * Canvas-based image editor for cropping avatars. Supports drag-and-drop
+ * upload, mouse/touch panning, zoom via slider or scroll wheel, and exports
+ * the cropped image as either a `Blob` or a data URL.
+ */
 declare class AvatarEditorComponent implements OnDestroy {
     readonly canvasEl: _angular_core.Signal<ElementRef<HTMLCanvasElement> | undefined>;
     readonly fileInputEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
@@ -122,17 +172,24 @@ declare class AvatarEditorComponent implements OnDestroy {
     readonly exportQuality: _angular_core.InputSignal<number>;
     readonly exportType: _angular_core.InputSignal<string>;
     readonly cropState: _angular_core.InputSignal<AvatarEditorCropState | null | undefined>;
+    /** Fires when the user finalises a crop via {@link exportCrop}; payload contains both `Blob` and data URL. */
     readonly cropped: _angular_core.OutputEmitterRef<AvatarEditorCropEvent>;
+    /** Fires when a file is chosen from disk or dropped onto the editor. */
     readonly fileSelected: _angular_core.OutputEmitterRef<File>;
+    /** Fires when the current image is cleared via the remove control. */
     readonly removed: _angular_core.OutputEmitterRef<void>;
-    readonly fileError: _angular_core.OutputEmitterRef<string>;
-    readonly cropStateChange: _angular_core.OutputEmitterRef<AvatarEditorCropState>;
+    /** Fires with a human-readable message when validation fails (wrong type, oversized file, etc.). */
+    readonly errored: _angular_core.OutputEmitterRef<string>;
+    /** Fires whenever the user pans or zooms the image; useful for persisting in-progress crops. */
+    readonly cropStateChanged: _angular_core.OutputEmitterRef<AvatarEditorCropState>;
     readonly hasImage: _angular_core.WritableSignal<boolean>;
     readonly isDragOver: _angular_core.WritableSignal<boolean>;
     readonly isAtOriginal: _angular_core.WritableSignal<boolean>;
     readonly isLoading: _angular_core.Signal<boolean>;
     readonly zoom: _angular_core.WritableSignal<number>;
     readonly canRevert: _angular_core.Signal<boolean>;
+    /** True when the visible crop is darker than mid-grey; drives the `--on-light` class on the overlay so the "Change photo" affordance stays readable. */
+    readonly isImageDark: _angular_core.WritableSignal<boolean>;
     private image;
     private offsetX;
     private offsetY;
@@ -160,6 +217,7 @@ declare class AvatarEditorComponent implements OnDestroy {
     onDragLeave(event: DragEvent): void;
     onDrop(event: DragEvent): void;
     onFileSelected(event: Event): void;
+    /** Opens the native file picker dialog. */
     openFilePicker(): void;
     onMouseDown(event: MouseEvent): void;
     onTouchStart(event: TouchEvent): void;
@@ -172,11 +230,17 @@ declare class AvatarEditorComponent implements OnDestroy {
     private onTouchMove;
     private onTouchEnd;
     private onWheel;
+    onCanvasKeydown(event: KeyboardEvent): void;
+    /** Sets the zoom level, clamped to the configured `minZoom`/`maxZoom` range. */
     setZoom(value: number): void;
     onZoomInput(event: Event): void;
+    /** Clears the loaded image and resets pan/zoom to defaults. */
     removeImage(): void;
+    /** Marks the current image and crop state as the baseline for {@link revertImage}. */
     captureOriginal(): void;
+    /** Restores the image and crop state captured by the most recent {@link captureOriginal}. */
     revertImage(): void;
+    /** Renders the current crop to an offscreen canvas, emits `cropped`, and resolves with the resulting `Blob`. */
     exportCrop(): Promise<Blob>;
     private loadFromUrl;
     private loadFile;
@@ -186,14 +250,32 @@ declare class AvatarEditorComponent implements OnDestroy {
     private getDrawParams;
     private clampOffset;
     private draw;
+    /**
+     * Samples the visible crop region and stores whether it's darker than
+     * mid-grey, so the hover overlay can flip its label and icon between
+     * white (on dark photos) and black (on light photos).
+     *
+     * Restricts sampling to the inscribed circle for circle crops to ignore
+     * the soon-to-be-masked corners. Uses Rec. 601 perceptual luminance
+     * weights; transparent pixels and CORS-tainted canvases default to a
+     * "dark" assumption (white ink).
+     */
+    private updateImageDarkness;
     private emitCropStateChange;
     private clearCanvas;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AvatarEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarEditorComponent, "ea-avatar-editor", never, { "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": false; "isSignal": true; }; "currentSrc": { "alias": "currentSrc"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "minZoom": { "alias": "minZoom"; "required": false; "isSignal": true; }; "maxZoom": { "alias": "maxZoom"; "required": false; "isSignal": true; }; "exportQuality": { "alias": "exportQuality"; "required": false; "isSignal": true; }; "exportType": { "alias": "exportType"; "required": false; "isSignal": true; }; "cropState": { "alias": "cropState"; "required": false; "isSignal": true; }; }, { "cropped": "cropped"; "fileSelected": "fileSelected"; "removed": "removed"; "fileError": "fileError"; "cropStateChange": "cropStateChange"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarEditorComponent, "ea-avatar-editor", never, { "shape": { "alias": "shape"; "required": false; "isSignal": true; }; "canvasSize": { "alias": "canvasSize"; "required": false; "isSignal": true; }; "currentSrc": { "alias": "currentSrc"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFileSize": { "alias": "maxFileSize"; "required": false; "isSignal": true; }; "minZoom": { "alias": "minZoom"; "required": false; "isSignal": true; }; "maxZoom": { "alias": "maxZoom"; "required": false; "isSignal": true; }; "exportQuality": { "alias": "exportQuality"; "required": false; "isSignal": true; }; "exportType": { "alias": "exportType"; "required": false; "isSignal": true; }; "cropState": { "alias": "cropState"; "required": false; "isSignal": true; }; }, { "cropped": "cropped"; "fileSelected": "fileSelected"; "removed": "removed"; "errored": "errored"; "cropStateChanged": "cropStateChanged"; }, never, never, true, never>;
 }
 
+/** Diameter (or side length) preset for an avatar. */
 type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+/** Outline of the avatar — round or rounded-square. */
 type AvatarShape = 'circle' | 'square';
+/**
+ * Compact image used to represent a user or entity. Falls back to initials
+ * when no `src` is provided, then to a generic user icon when neither image
+ * nor initials are available.
+ */
 declare class AvatarComponent {
     readonly src: _angular_core.InputSignal<string | undefined>;
     readonly alt: _angular_core.InputSignal<string>;
@@ -211,8 +293,14 @@ declare class AvatarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<AvatarComponent, "ea-avatar", never, { "src": { "alias": "src"; "required": false; "isSignal": true; }; "alt": { "alias": "alt"; "required": false; "isSignal": true; }; "initials": { "alias": "initials"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "shape": { "alias": "shape"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Semantic colour scheme of a badge. */
 type BadgeVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+/** Visual size of a badge. */
 type BadgeSize = 'sm' | 'md' | 'lg';
+/**
+ * Compact pill-shaped indicator used to communicate status, counts, or labels
+ * inline with surrounding content.
+ */
 declare class BadgeComponent {
     readonly variant: _angular_core.InputSignal<BadgeVariant>;
     readonly size: _angular_core.InputSignal<BadgeSize>;
@@ -223,31 +311,48 @@ declare class BadgeComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<BadgeComponent, "ea-badge", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Visual style of the separator rendered between breadcrumb items. */
 type BreadcrumbsSeparator = 'chevron' | 'slash';
+/** Single entry in a breadcrumb trail. */
 interface BreadcrumbItem {
     label: string;
     href?: string;
     disabled?: boolean;
 }
+/** Payload emitted when a breadcrumb is activated. */
 interface BreadcrumbClickEvent {
     item: BreadcrumbItem;
     index: number;
     event: MouseEvent;
 }
+/**
+ * Navigation trail that shows the user's location within a hierarchy. Items
+ * with an `href` render as links, others render as buttons; the final item is
+ * always treated as the current page and is non-interactive.
+ */
 declare class BreadcrumbsComponent {
     readonly items: _angular_core.InputSignal<BreadcrumbItem[]>;
     readonly separator: _angular_core.InputSignal<BreadcrumbsSeparator>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
-    readonly itemClicked: _angular_core.OutputEmitterRef<BreadcrumbClickEvent>;
+    /** Fires when a non-disabled, non-final breadcrumb is activated. */
+    readonly clicked: _angular_core.OutputEmitterRef<BreadcrumbClickEvent>;
     isLast(index: number): boolean;
     handleClick(item: BreadcrumbItem, index: number, event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<BreadcrumbsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ea-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "itemClicked": "itemClicked"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<BreadcrumbsComponent, "ea-breadcrumbs", never, { "items": { "alias": "items"; "required": false; "isSignal": true; }; "separator": { "alias": "separator"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, never, true, never>;
 }
 
+/** Visual style of a button — drives colour and emphasis. */
 type ButtonVariant = 'primary' | 'secondary' | 'ghost' | 'danger';
+/** Visual size of a button. */
 type ButtonSize = 'sm' | 'md' | 'lg';
+/** HTML `type` attribute applied to the underlying `<button>` element. */
 type ButtonType = 'button' | 'submit' | 'reset';
+/**
+ * Standard action button supporting primary, secondary, ghost, and danger
+ * variants. Includes a loading state that swaps the label for a spinner while
+ * preserving the rendered width.
+ */
 declare class ButtonComponent {
     readonly variant: _angular_core.InputSignal<ButtonVariant>;
     readonly size: _angular_core.InputSignal<ButtonSize>;
@@ -257,6 +362,7 @@ declare class ButtonComponent {
     readonly fullWidth: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly ariaCurrent: _angular_core.InputSignal<string | undefined>;
+    /** Fires when the button is activated; suppressed while disabled or loading. */
     readonly clicked: _angular_core.OutputEmitterRef<MouseEvent>;
     readonly isDisabled: _angular_core.Signal<boolean>;
     readonly hostClasses: _angular_core.Signal<{
@@ -270,9 +376,18 @@ declare class ButtonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ButtonComponent, "ea-button", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "loading": { "alias": "loading"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "ariaCurrent": { "alias": "aria-current"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, ["[slot=prefix]", "*", "[slot=suffix]"], true, never>;
 }
 
+/** Visual style of a card surface. */
 type CardVariant = 'elevated' | 'outlined' | 'filled';
+/** Padding preset applied to the card's content area. */
 type CardPadding = 'none' | 'sm' | 'md' | 'lg' | 'xl';
+/** Horizontal alignment of card header content. */
 type CardHeaderAlign = 'start' | 'center' | 'end';
+/**
+ * Surface for grouping related content. Provides optional `header` and
+ * `footer` content slots and supports elevated, outlined, and filled
+ * variants. The card shadow can be customised per instance via the
+ * `--ea-card-shadow` CSS custom property.
+ */
 declare class CardComponent {
     readonly variant: _angular_core.InputSignal<CardVariant>;
     readonly padding: _angular_core.InputSignal<CardPadding>;
@@ -284,26 +399,40 @@ declare class CardComponent {
         'ea-card--full-width': boolean;
     }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CardComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "ea-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "headerAlign": { "alias": "headerAlign"; "required": false; "isSignal": true; }; "headerDivider": { "alias": "headerDivider"; "required": false; "isSignal": true; }; }, {}, never, ["[eaCardHeader]", "*", "[eaCardFooter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CardComponent, "ea-card", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "padding": { "alias": "padding"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "headerAlign": { "alias": "headerAlign"; "required": false; "isSignal": true; }; "headerDivider": { "alias": "headerDivider"; "required": false; "isSignal": true; }; }, {}, never, ["[slot=header]", "*", "[slot=footer]"], true, never>;
 }
 
+/** Visual size of a checkbox. */
 type CheckboxSize = 'sm' | 'md' | 'lg';
+/**
+ * Boolean form control with support for an indeterminate visual state. Pairs
+ * a visually hidden native input with a custom checkmark and integrates with
+ * Angular forms via `ControlValueAccessor`.
+ */
 declare class CheckboxComponent implements ControlValueAccessor {
     readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly hint: _angular_core.InputSignal<string | undefined>;
+    readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<CheckboxSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly required: _angular_core.InputSignal<boolean>;
     readonly indeterminate: _angular_core.InputSignal<boolean>;
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly checked: _angular_core.ModelSignal<boolean>;
+    /** Fires with the new checked state whenever the user toggles the checkbox. */
     readonly changed: _angular_core.OutputEmitterRef<boolean>;
     private readonly _formDisabled;
     readonly isDisabled: _angular_core.Signal<boolean>;
+    readonly hasError: _angular_core.Signal<boolean>;
+    readonly showError: _angular_core.Signal<boolean>;
+    readonly showHint: _angular_core.Signal<boolean>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
         'ea-checkbox--disabled': boolean;
         'ea-checkbox--checked': boolean;
         'ea-checkbox--indeterminate': boolean;
+        'ea-checkbox--error': boolean;
     }>;
     private onChange;
     private onTouched;
@@ -313,11 +442,14 @@ declare class CheckboxComponent implements ControlValueAccessor {
     setDisabledState(isDisabled: boolean): void;
     handleChange(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CheckboxComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ea-checkbox", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CheckboxComponent, "ea-checkbox", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Vertical density preset for table rows and header cells. */
 type DataTableDensity = 'compact' | 'comfortable' | 'spacious';
-type SortDirection = 'asc' | 'desc' | null;
+/** Sort direction; `null` means no sort is applied. */
+type DataTableSortDirection = 'asc' | 'desc' | null;
+/** Column definition for the data table, including optional cell/header templates. */
 interface DataTableColumn<T = Record<string, unknown>> {
     key: string;
     label: string;
@@ -333,10 +465,17 @@ interface DataTableColumn<T = Record<string, unknown>> {
         $implicit: DataTableColumn<T>;
     }>;
 }
+/** Current sort state — which column is sorted and in which direction. */
 interface DataTableSortState {
     column: string;
-    direction: SortDirection;
-}
+    direction: DataTableSortDirection;
+}
+/**
+ * Table for tabular data with sortable columns, sticky headers, and density
+ * presets. Supports striping, borders, hoverable rows, and custom cell or
+ * header templates via `ng-template`. Sort state is exposed as a two-way
+ * `model()` binding.
+ */
 declare class DataTableComponent<T = Record<string, unknown>> {
     readonly columns: _angular_core.InputSignal<DataTableColumn<T>[]>;
     readonly data: _angular_core.InputSignal<T[]>;
@@ -348,7 +487,8 @@ declare class DataTableComponent<T = Record<string, unknown>> {
     readonly bordered: _angular_core.InputSignal<boolean>;
     readonly noDataText: _angular_core.InputSignal<string>;
     readonly sort: _angular_core.ModelSignal<DataTableSortState>;
-    readonly sortChange: _angular_core.OutputEmitterRef<DataTableSortState>;
+    /** Fires whenever the sort column or direction changes via header click. */
+    readonly sorted: _angular_core.OutputEmitterRef<DataTableSortState>;
     readonly noDataTemplate: _angular_core.Signal<TemplateRef<unknown> | undefined>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -362,30 +502,37 @@ declare class DataTableComponent<T = Record<string, unknown>> {
     onHeaderClick(col: DataTableColumn<T>): void;
     trackByFn(_index: number, item: T): unknown;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DataTableComponent<any>, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataTableComponent<any>, "ea-data-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "hoverable": { "alias": "hoverable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "noDataText": { "alias": "noDataText"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; }, { "sort": "sortChange"; "sortChange": "sortChange"; }, ["noDataTemplate"], ["ea-paginator"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DataTableComponent<any>, "ea-data-table", never, { "columns": { "alias": "columns"; "required": true; "isSignal": true; }; "data": { "alias": "data"; "required": true; "isSignal": true; }; "trackBy": { "alias": "trackBy"; "required": false; "isSignal": true; }; "density": { "alias": "density"; "required": false; "isSignal": true; }; "stickyHeader": { "alias": "stickyHeader"; "required": false; "isSignal": true; }; "striped": { "alias": "striped"; "required": false; "isSignal": true; }; "hoverable": { "alias": "hoverable"; "required": false; "isSignal": true; }; "bordered": { "alias": "bordered"; "required": false; "isSignal": true; }; "noDataText": { "alias": "noDataText"; "required": false; "isSignal": true; }; "sort": { "alias": "sort"; "required": false; "isSignal": true; }; }, { "sort": "sortChange"; "sorted": "sorted"; }, ["noDataTemplate"], ["ea-paginator"], true, never>;
 }
 
+/** Visual size of each digit cell. */
 type CodeInputSize = 'sm' | 'md' | 'lg';
-type CodeInputStatus = 'default' | 'error' | 'success';
+/**
+ * Verification code entry made up of one input per digit. Auto-advances on
+ * input, supports paste of the full code at once, and integrates with Angular
+ * forms via `ControlValueAccessor`.
+ */
 declare class CodeInputComponent implements ControlValueAccessor {
     readonly digitEls: _angular_core.Signal<readonly ElementRef<HTMLInputElement>[]>;
     readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly placeholder: _angular_core.InputSignal<string>;
     readonly length: _angular_core.InputSignal<number>;
     readonly size: _angular_core.InputSignal<CodeInputSize>;
-    readonly status: _angular_core.InputSignal<CodeInputStatus>;
     readonly hint: _angular_core.InputSignal<string | undefined>;
     readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
     readonly required: _angular_core.InputSignal<boolean>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
     readonly focusedIndex: _angular_core.WritableSignal<number>;
     private readonly _formDisabled;
+    /** Fires with the full code once every digit has been entered. */
     readonly completed: _angular_core.OutputEmitterRef<string>;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly resolvedStatus: _angular_core.Signal<CodeInputStatus>;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly digits: _angular_core.Signal<string[]>;
@@ -399,15 +546,20 @@ declare class CodeInputComponent implements ControlValueAccessor {
     handlePaste(event: ClipboardEvent): void;
     handleFocus(index: number): void;
     handleBlur(): void;
+    /** Moves keyboard focus to the next empty digit (or the last one when full). */
     focus(): void;
     private focusDigit;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<CodeInputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CodeInputComponent, "ea-code-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<CodeInputComponent, "ea-code-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "length": { "alias": "length"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "completed": "completed"; }, never, never, true, never>;
 }
 
+/** Visual size of the date picker trigger. */
 type DatePickerSize = 'sm' | 'md' | 'lg';
+/** Locale-aware date format used for the displayed value. */
 type DatePickerFormat = 'short' | 'medium' | 'long';
+/** First day of the week in the calendar grid (0 = Sunday, 1 = Monday). */
 type DatePickerWeekStart = 0 | 1;
+/** Value accepted via `writeValue` — a `Date`, ISO/parseable string, or `null`. */
 type DatePickerValue = Date | string | null;
 interface CalendarDay {
     date: Date;
@@ -418,13 +570,21 @@ interface CalendarDay {
     isDisabled: boolean;
     isFocused: boolean;
 }
+/**
+ * Calendar popover for selecting a single date. Supports `min`/`max` bounds,
+ * configurable week start, locale-aware formatting via `Intl.DateTimeFormat`,
+ * and full keyboard navigation (arrows, PageUp/PageDown, Home/End, Enter,
+ * Escape). Integrates with Angular forms via `ControlValueAccessor`.
+ */
 declare class DatePickerComponent implements ControlValueAccessor {
     private readonly hostEl;
     private readonly triggerEl;
+    private readonly injector;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<DatePickerSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
     readonly required: _angular_core.InputSignal<boolean>;
     readonly hint: _angular_core.InputSignal<string | undefined>;
     readonly errorMsg: _angular_core.InputSignal<string | undefined>;
@@ -435,6 +595,7 @@ declare class DatePickerComponent implements ControlValueAccessor {
     readonly locale: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<Date | null>;
+    /** Fires when the selected date changes, including when cleared. */
     readonly changed: _angular_core.OutputEmitterRef<Date | null>;
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     readonly viewYear: _angular_core.WritableSignal<number>;
@@ -444,11 +605,12 @@ declare class DatePickerComponent implements ControlValueAccessor {
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly resolvedStatus: _angular_core.Signal<"default" | "error">;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly triggerClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-date-picker__trigger--error': boolean;
         'ea-date-picker__trigger--open': boolean;
         'ea-date-picker__trigger--disabled': boolean;
     }>;
@@ -460,10 +622,17 @@ declare class DatePickerComponent implements ControlValueAccessor {
     registerOnChange(fn: (value: Date | null) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
+    /** Toggles the calendar popover between open and closed. */
     toggle(): void;
+    /** Opens the calendar popover and moves focus to the focused day cell. */
     open(): void;
+    /** Closes the calendar popover. */
     close(): void;
+    private focusFocusedDayCell;
+    /** Moves keyboard focus to the trigger button. */
+    focus(): void;
     selectDay(day: CalendarDay): void;
+    /** Clears the selected date and emits `changed` with `null`. */
     clear(event: Event): void;
     goToPrevMonth(): void;
     goToNextMonth(): void;
@@ -480,10 +649,17 @@ declare class DatePickerComponent implements ControlValueAccessor {
     private addDays;
     private addMonths;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DatePickerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ea-date-picker", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "weekStartsOn": { "alias": "weekStartsOn"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DatePickerComponent, "ea-date-picker", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "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; }; "minDate": { "alias": "minDate"; "required": false; "isSignal": true; }; "maxDate": { "alias": "maxDate"; "required": false; "isSignal": true; }; "format": { "alias": "format"; "required": false; "isSignal": true; }; "weekStartsOn": { "alias": "weekStartsOn"; "required": false; "isSignal": true; }; "locale": { "alias": "locale"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Width preset of the dialog panel. */
 type DialogSize = 'sm' | 'md' | 'lg' | 'full';
+/**
+ * Modal dialog backed by the native `<dialog>` element. Uses `showModal()`
+ * for browser-managed focus trapping, supports backdrop and Escape dismissal,
+ * and exposes `header`, default, and `footer` content slots. The `open` state
+ * is a two-way `model()` binding.
+ */
 declare class DialogComponent {
     private readonly dialogEl;
     private previouslyFocused;
@@ -492,8 +668,11 @@ declare class DialogComponent {
     readonly closeOnEscape: _angular_core.InputSignal<boolean>;
     readonly showClose: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly id: _angular_core.InputSignal<string>;
     readonly open: _angular_core.ModelSignal<boolean>;
+    /** Fires once the dialog has been shown via `showModal()`. */
     readonly opened: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the dialog closes (via close button, backdrop, or Escape). */
     readonly closed: _angular_core.OutputEmitterRef<void>;
     readonly panelClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -503,10 +682,15 @@ declare class DialogComponent {
     handleBackdropClick(event: MouseEvent): void;
     handleCancel(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DialogComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DialogComponent, "ea-dialog", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["[slot=header]", "*", "[slot=footer]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DialogComponent, "ea-dialog", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["[slot=header]", "*", "[slot=footer]"], true, never>;
 }
 
+/** Orientation of the divider rule. */
 type DividerOrientation = 'horizontal' | 'vertical';
+/**
+ * Thin separator used to visually divide content. Renders horizontally by
+ * default and may include an optional centred label (e.g. "or").
+ */
 declare class DividerComponent {
     readonly orientation: _angular_core.InputSignal<DividerOrientation>;
     readonly label: _angular_core.InputSignal<string | undefined>;
@@ -518,8 +702,16 @@ declare class DividerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<DividerComponent, "ea-divider", never, { "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Edge of the viewport from which the drawer slides in. */
 type DrawerPosition = 'left' | 'right' | 'top' | 'bottom';
+/** Size of the drawer panel along its primary axis. */
 type DrawerSize = 'sm' | 'md' | 'lg' | 'full';
+/**
+ * Side panel backed by the native `<dialog>` element for browser-managed
+ * focus trapping. Slides in from a configurable edge, supports backdrop and
+ * Escape dismissal, and exposes `header`, default, and `footer` content
+ * slots. The `open` state is a two-way `model()` binding.
+ */
 declare class DrawerComponent {
     private readonly drawerEl;
     private previouslyFocused;
@@ -529,8 +721,11 @@ declare class DrawerComponent {
     readonly closeOnEscape: _angular_core.InputSignal<boolean>;
     readonly showClose: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly id: _angular_core.InputSignal<string>;
     readonly open: _angular_core.ModelSignal<boolean>;
+    /** Fires once the drawer has been shown via `showModal()`. */
     readonly opened: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the drawer closes (via close button, backdrop, or Escape). */
     readonly closed: _angular_core.OutputEmitterRef<void>;
     readonly panelClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -540,29 +735,33 @@ declare class DrawerComponent {
     handleBackdropClick(event: MouseEvent): void;
     handleCancel(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DrawerComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "ea-drawer", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["[slot=header]", "*", "[slot=footer]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DrawerComponent, "ea-drawer", never, { "position": { "alias": "position"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "closeOnBackdrop": { "alias": "closeOnBackdrop"; "required": false; "isSignal": true; }; "closeOnEscape": { "alias": "closeOnEscape"; "required": false; "isSignal": true; }; "showClose": { "alias": "showClose"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["[slot=header]", "*", "[slot=footer]"], true, never>;
 }
 
+/** Visual size of the dropdown trigger. */
 type DropdownSize = 'sm' | 'md' | 'lg';
-interface DropdownOption {
-    value: string;
-    label: string;
-    disabled?: boolean;
-}
+/**
+ * Single-select dropdown with a custom popup list. Supports keyboard
+ * navigation (arrow keys, Enter/Space to select, Escape to close), closes
+ * on outside click or viewport scroll/resize, and integrates with Angular
+ * forms via `ControlValueAccessor`.
+ */
 declare class DropdownComponent implements ControlValueAccessor {
     private readonly elRef;
     private readonly menuEl;
     private readonly destroyRef;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly placeholder: _angular_core.InputSignal<string>;
-    readonly options: _angular_core.InputSignal<DropdownOption[]>;
+    readonly options: _angular_core.InputSignal<SelectOption[]>;
     readonly size: _angular_core.InputSignal<DropdownSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly readonly: _angular_core.InputSignal<boolean>;
     readonly required: _angular_core.InputSignal<boolean>;
     readonly hint: _angular_core.InputSignal<string | undefined>;
     readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
+    /** Fires with the new value when the user selects an option. */
     readonly changed: _angular_core.OutputEmitterRef<string>;
     readonly isOpen: _angular_core.WritableSignal<boolean>;
     readonly focusedIndex: _angular_core.WritableSignal<number>;
@@ -570,12 +769,13 @@ declare class DropdownComponent implements ControlValueAccessor {
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly resolvedStatus: _angular_core.Signal<"default" | "error">;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly selectedLabel: _angular_core.Signal<string>;
     readonly triggerClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-dropdown__trigger--error': boolean;
         'ea-dropdown__trigger--open': boolean;
         'ea-dropdown__trigger--disabled': boolean;
     }>;
@@ -584,18 +784,30 @@ declare class DropdownComponent implements ControlValueAccessor {
     registerOnChange(fn: (value: string) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
+    /** Toggles the dropdown list between open and closed. */
     toggle(): void;
-    select(option: DropdownOption): void;
+    /** Programmatically selects the given option, closing the list. */
+    select(option: SelectOption): void;
+    /** Closes the dropdown list without changing the current value. */
     close(): void;
+    /** Moves keyboard focus to the dropdown trigger. */
+    focus(): void;
     handleKeydown(event: KeyboardEvent): void;
     private moveFocus;
     onDocumentClick(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<DropdownComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownComponent, "ea-dropdown", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<DropdownComponent, "ea-dropdown", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "options": { "alias": "options"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "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; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Variant of the wordmark — 1: "eagami", 2: "handcrafted by eagami", 3: "eagami design system", 4: with tagline. */
 type EagamiWordmarkVariant = 1 | 2 | 3 | 4;
+/** Layout of the wordmark — `stacked` for multi-line, `inline` for a single line with em-dash separators. */
 type EagamiWordmarkLayout = 'stacked' | 'inline';
+/**
+ * Branded eagami wordmark logo. Scales continuously from a single `size`
+ * pixel value and supports four content variants paired with stacked or
+ * inline layouts.
+ */
 declare class EagamiWordmarkComponent {
     readonly variant: _angular_core.InputSignal<EagamiWordmarkVariant>;
     readonly layout: _angular_core.InputSignal<EagamiWordmarkLayout>;
@@ -608,16 +820,25 @@ declare class EagamiWordmarkComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<EagamiWordmarkComponent, "ea-eagami-wordmark", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "layout": { "alias": "layout"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual size of the empty-state block. */
 type EmptyStateSize = 'sm' | 'md' | 'lg';
+/** Heading level used for the title so it fits the surrounding document outline. */
+type EmptyStateHeadingLevel = 'h2' | 'h3' | 'h4' | 'h5' | 'h6';
+/**
+ * Pattern for "no results" or "nothing here yet" screens. Combines an
+ * optional title and description with `[slot=media]` (icon or illustration)
+ * and `[slot=actions]` (follow-up buttons) content slots.
+ */
 declare class EmptyStateComponent {
     readonly title: _angular_core.InputSignal<string | undefined>;
     readonly description: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<EmptyStateSize>;
+    readonly headingLevel: _angular_core.InputSignal<EmptyStateHeadingLevel>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
     }>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<EmptyStateComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "ea-empty-state", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; }, {}, never, ["[slot=media]", "[slot=actions]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<EmptyStateComponent, "ea-empty-state", never, { "title": { "alias": "title"; "required": false; "isSignal": true; }; "description": { "alias": "description"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "headingLevel": { "alias": "headingLevel"; "required": false; "isSignal": true; }; }, {}, never, ["[slot=media]", "[slot=actions]"], true, never>;
 }
 
 declare class AlertCircleIconComponent {
@@ -631,8 +852,9 @@ declare class AlertTriangleIconComponent {
 }
 
 declare class AppleIconComponent {
+    readonly brand: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AppleIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppleIconComponent, "ea-icon-apple", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<AppleIconComponent, "ea-icon-apple", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class ArrowDownIconComponent {
@@ -741,8 +963,9 @@ declare class EyeIconComponent {
 }
 
 declare class FacebookIconComponent {
+    readonly brand: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<FacebookIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FacebookIconComponent, "ea-icon-facebook", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FacebookIconComponent, "ea-icon-facebook", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class FileIconComponent {
@@ -756,8 +979,9 @@ declare class FilterIconComponent {
 }
 
 declare class GithubIconComponent {
+    readonly brand: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<GithubIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GithubIconComponent, "ea-icon-github", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<GithubIconComponent, "ea-icon-github", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class GoogleIconComponent {
@@ -871,8 +1095,9 @@ declare class XCircleIconComponent {
 }
 
 declare class XTwitterIconComponent {
+    readonly brand: _angular_core.InputSignal<boolean>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<XTwitterIconComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<XTwitterIconComponent, "ea-icon-x-twitter", never, {}, {}, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<XTwitterIconComponent, "ea-icon-x-twitter", never, { "brand": { "alias": "brand"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 declare class XIconComponent {
@@ -880,16 +1105,22 @@ declare class XIconComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<XIconComponent, "ea-icon-x", never, {}, {}, never, never, true, never>;
 }
 
+/** Visual size of the input. */
 type InputSize = 'sm' | 'md' | 'lg';
-type InputStatus = 'default' | 'error' | 'success';
+/** HTML `type` attribute applied to the underlying `<input>`. */
 type InputType = 'text' | 'email' | 'password' | 'number' | '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.
+ */
 declare class InputComponent implements ControlValueAccessor, AfterViewInit {
     readonly inputEl: _angular_core.Signal<ElementRef<HTMLInputElement> | undefined>;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly type: _angular_core.InputSignal<InputType>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<InputSize>;
-    readonly status: _angular_core.InputSignal<InputStatus>;
     readonly hint: _angular_core.InputSignal<string | undefined>;
     readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -900,20 +1131,23 @@ declare class InputComponent implements ControlValueAccessor, AfterViewInit {
     readonly showPasswordToggle: _angular_core.InputSignal<boolean>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
-    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
     readonly passwordVisible: _angular_core.WritableSignal<boolean>;
     private readonly _formDisabled;
-    readonly inputFocused: _angular_core.OutputEmitterRef<FocusEvent>;
-    readonly inputBlurred: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Fires when the input receives focus. */
+    readonly focused: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Fires when the input loses focus. */
+    readonly blurred: _angular_core.OutputEmitterRef<FocusEvent>;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
     readonly effectiveType: _angular_core.Signal<InputType>;
-    readonly resolvedStatus: _angular_core.Signal<InputStatus>;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly wrapperClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-input-wrapper--error': boolean;
         'ea-input-wrapper--focused': boolean;
         'ea-input-wrapper--disabled': boolean;
         'ea-input-wrapper--readonly': boolean;
@@ -926,50 +1160,83 @@ declare class InputComponent implements ControlValueAccessor, AfterViewInit {
     handleInput(event: Event): void;
     handleFocus(event: FocusEvent): void;
     handleBlur(event: FocusEvent): void;
+    /** Toggles the password reveal state for `type="password"` inputs. */
     togglePasswordVisibility(): void;
+    /** Moves keyboard focus to the underlying native input element. */
     focus(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<InputComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ea-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "showPasswordToggle": { "alias": "showPasswordToggle"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "inputFocused": "inputFocused"; "inputBlurred": "inputBlurred"; }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<InputComponent, "ea-input", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "type": { "alias": "type"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "autocomplete": { "alias": "autocomplete"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "showPasswordToggle": { "alias": "showPasswordToggle"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "focused": "focused"; "blurred": "blurred"; }, never, ["[slot=prefix]", "[slot=suffix]"], true, never>;
 }
 
+/** Placement of the menu list relative to its trigger. */
 type MenuPlacement = 'bottom-start' | 'bottom-end' | 'top-start' | 'top-end';
+/**
+ * Popup action menu attached to any focusable element via the
+ * `[eaMenuTrigger]` directive. Supports keyboard navigation
+ * (arrow keys, Home/End), closes on outside click or Escape, and restores
+ * focus to the trigger on close.
+ */
 declare class MenuComponent {
-    private readonly elRef;
+    private readonly injector;
     private readonly listEl;
     readonly placement: _angular_core.InputSignal<MenuPlacement>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string>;
+    readonly id: _angular_core.InputSignal<string>;
     readonly open: _angular_core.ModelSignal<boolean>;
+    /** Fires when the menu opens. */
     readonly opened: _angular_core.OutputEmitterRef<void>;
+    /** Fires when the menu closes. */
     readonly closed: _angular_core.OutputEmitterRef<void>;
-    readonly menuId: _angular_core.WritableSignal<string>;
     private triggerEl;
     private readonly triggerRect;
     readonly listClasses: _angular_core.Signal<{
         [x: string]: boolean;
     }>;
     readonly listStyle: _angular_core.Signal<Record<string, string>>;
+    /** Toggles the menu open state, anchoring it to the given trigger element. */
     toggleAt(triggerEl: HTMLElement): void;
+    /** Opens the menu anchored to the given trigger element and focuses the first item. */
     openAt(triggerEl: HTMLElement): void;
-    close(): void;
+    /**
+     * Closes the menu if it is open. Pass `restoreFocus: true` to return focus
+     * to the trigger element (used when closing via Escape or item activation;
+     * not used on outside click, where the user has chosen a new focus target).
+     */
+    close(restoreFocus?: boolean): void;
+    private getEnabledItems;
+    private focusFirstItem;
+    onKeydown(event: KeyboardEvent): void;
     onDocumentClick(event: Event): void;
     onEscape(): void;
     onViewportChange(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuComponent, "ea-menu", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuComponent, "ea-menu", never, { "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "open": { "alias": "open"; "required": false; "isSignal": true; }; }, { "open": "openChange"; "opened": "opened"; "closed": "closed"; }, never, ["*"], true, never>;
 }
 
+/** Visual style of a menu item — `danger` for destructive actions. */
 type MenuItemVariant = 'default' | 'danger';
+/**
+ * Selectable row inside an `ea-menu`. Supports leading icons via the `icon`
+ * content slot, a disabled state, and a `danger` variant for destructive
+ * actions. Activating an item closes its parent menu.
+ */
 declare class MenuItemComponent {
     private readonly menu;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly variant: _angular_core.InputSignal<MenuItemVariant>;
-    readonly itemClicked: _angular_core.OutputEmitterRef<MouseEvent>;
+    /** Fires when the item is activated; the parent menu closes immediately afterwards. */
+    readonly clicked: _angular_core.OutputEmitterRef<MouseEvent>;
     handleClick(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MenuItemComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ea-menu-item", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "itemClicked": "itemClicked"; }, never, ["[slot=icon]", "*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MenuItemComponent, "ea-menu-item", never, { "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; }, { "clicked": "clicked"; }, never, ["[slot=icon]", "*"], true, never>;
 }
 
+/**
+ * Wires a focusable host element (typically a button) to an `ea-menu`,
+ * handling click and keyboard activation (ArrowDown/Enter/Space to open,
+ * Escape to close) and applying the appropriate ARIA attributes.
+ */
 declare class MenuTriggerDirective {
     private readonly el;
     readonly menu: _angular_core.InputSignal<MenuComponent>;
@@ -979,20 +1246,29 @@ declare class MenuTriggerDirective {
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MenuTriggerDirective, "[eaMenuTrigger]", never, { "menu": { "alias": "eaMenuTrigger"; "required": true; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
-type PaginatorPlacement = 'left' | 'center' | 'right';
+/** Horizontal alignment of paginator controls within their container. */
+type PaginatorAlign = 'left' | 'center' | 'right';
+/** Snapshot of the paginator's page and page size. */
 interface PaginatorState {
     page: number;
     pageSize: number;
 }
+/**
+ * Page navigation control with previous/next buttons, numbered page jumps,
+ * an optional page-size selector, and a range label. Exposes `page` and
+ * `pageSize` as two-way `model()` bindings and emits a single `changed`
+ * event whenever either changes.
+ */
 declare class PaginatorComponent {
     readonly totalItems: _angular_core.InputSignal<number>;
     readonly pageSizeOptions: _angular_core.InputSignal<number[]>;
     readonly showPageSizeSelector: _angular_core.InputSignal<boolean>;
     readonly showRangeLabel: _angular_core.InputSignal<boolean>;
-    readonly placement: _angular_core.InputSignal<PaginatorPlacement>;
+    readonly align: _angular_core.InputSignal<PaginatorAlign>;
     readonly disabled: _angular_core.InputSignal<boolean>;
     readonly page: _angular_core.ModelSignal<number>;
     readonly pageSize: _angular_core.ModelSignal<number>;
+    /** Fires when the user changes either the current page or the page size. */
     readonly changed: _angular_core.OutputEmitterRef<PaginatorState>;
     readonly totalPages: _angular_core.Signal<number>;
     readonly rangeStart: _angular_core.Signal<number>;
@@ -1000,22 +1276,32 @@ declare class PaginatorComponent {
     readonly canGoPrev: _angular_core.Signal<boolean>;
     readonly canGoNext: _angular_core.Signal<boolean>;
     readonly visiblePages: _angular_core.Signal<(number | "ellipsis")[]>;
+    /** Navigates to the given page, clamped into the valid range. */
     goToPage(page: number): void;
+    /** Navigates to the previous page if one exists. */
     prevPage(): void;
+    /** Navigates to the next page if one exists. */
     nextPage(): void;
     onPageSizeChange(event: Event): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<PaginatorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginatorComponent, "ea-paginator", never, { "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSizeSelector": { "alias": "showPageSizeSelector"; "required": false; "isSignal": true; }; "showRangeLabel": { "alias": "showRangeLabel"; "required": false; "isSignal": true; }; "placement": { "alias": "placement"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "pageSize": "pageSizeChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<PaginatorComponent, "ea-paginator", never, { "totalItems": { "alias": "totalItems"; "required": true; "isSignal": true; }; "pageSizeOptions": { "alias": "pageSizeOptions"; "required": false; "isSignal": true; }; "showPageSizeSelector": { "alias": "showPageSizeSelector"; "required": false; "isSignal": true; }; "showRangeLabel": { "alias": "showRangeLabel"; "required": false; "isSignal": true; }; "align": { "alias": "align"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "page": { "alias": "page"; "required": false; "isSignal": true; }; "pageSize": { "alias": "pageSize"; "required": false; "isSignal": true; }; }, { "page": "pageChange"; "pageSize": "pageSizeChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Semantic colour scheme of the progress bar. */
 type ProgressBarVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+/** Visual height of the progress bar. */
 type ProgressBarSize = 'sm' | 'md' | 'lg';
+/**
+ * Linear progress indicator supporting both determinate (driven by `value`
+ * and `max`) and indeterminate modes. Optionally renders an inline label
+ * and/or the current percentage.
+ */
 declare class ProgressBarComponent {
     readonly value: _angular_core.InputSignal<number>;
     readonly max: _angular_core.InputSignal<number>;
     readonly variant: _angular_core.InputSignal<ProgressBarVariant>;
     readonly size: _angular_core.InputSignal<ProgressBarSize>;
-    readonly label: _angular_core.InputSignal<string>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
     readonly showValue: _angular_core.InputSignal<boolean>;
     readonly indeterminate: _angular_core.InputSignal<boolean>;
     readonly percentage: _angular_core.Signal<number>;
@@ -1028,29 +1314,51 @@ declare class ProgressBarComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ProgressBarComponent, "ea-progress-bar", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "max": { "alias": "max"; "required": false; "isSignal": true; }; "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "indeterminate": { "alias": "indeterminate"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual size shared by all radios in the group. */
 type RadioSize = 'sm' | 'md' | 'lg';
+/** Layout direction for radios within the group. */
 type RadioOrientation = 'vertical' | 'horizontal';
+/**
+ * Composite single-select control made up of `ea-radio` children. Manages
+ * shared state (name, size, disabled) for its options and integrates with
+ * Angular forms via `ControlValueAccessor`.
+ */
 declare class RadioGroupComponent implements ControlValueAccessor {
+    readonly id: _angular_core.InputSignal<string>;
     readonly name: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<RadioSize>;
     readonly orientation: _angular_core.InputSignal<RadioOrientation>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly hint: _angular_core.InputSignal<string | undefined>;
+    readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly value: _angular_core.ModelSignal<string>;
+    /** Fires with the new value when an option is selected. */
     readonly changed: _angular_core.OutputEmitterRef<string>;
     private readonly _formDisabled;
     readonly isDisabled: _angular_core.Signal<boolean>;
+    readonly hasError: _angular_core.Signal<boolean>;
+    readonly showError: _angular_core.Signal<boolean>;
+    readonly showHint: _angular_core.Signal<boolean>;
     private onChange;
     private onTouched;
     writeValue(val: string): void;
     registerOnChange(fn: (value: string) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
+    /** Programmatically selects the option with the given value. */
     select(val: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<RadioGroupComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ea-radio-group", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioGroupComponent, "ea-radio-group", never, { "id": { "alias": "id"; "required": false; "isSignal": true; }; "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, ["*"], true, never>;
 }
 
+/**
+ * Single radio option used inside an `ea-radio-group`. Inherits its size and
+ * disabled state from the parent group and selecting it updates the group's
+ * value.
+ */
 declare class RadioComponent {
     private readonly group;
     readonly value: _angular_core.InputSignal<string>;
@@ -1071,45 +1379,63 @@ declare class RadioComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<RadioComponent, "ea-radio", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual size of the segmented control. */
 type SegmentedSize = 'sm' | 'md' | 'lg';
-interface SegmentedOption {
-    value: string;
-    label: string;
-    disabled?: boolean;
-}
+/**
+ * Compact toggle button group for picking one of a small set of options
+ * (e.g. List/Grid/Kanban or Light/Dark). Implements `radiogroup` semantics
+ * and `ControlValueAccessor`, with full keyboard support
+ * (arrow keys, Home/End, Enter/Space).
+ */
 declare class SegmentedComponent implements ControlValueAccessor {
     readonly buttonEls: _angular_core.Signal<readonly ElementRef<HTMLButtonElement>[]>;
-    readonly options: _angular_core.InputSignal<SegmentedOption[]>;
+    readonly options: _angular_core.InputSignal<SelectOption[]>;
+    readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly hint: _angular_core.InputSignal<string | undefined>;
+    readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<SegmentedSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
     readonly fullWidth: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
+    /** Fires with the new value when the user selects a different option. */
     readonly changed: _angular_core.OutputEmitterRef<string>;
     private readonly _formDisabled;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly enabledOptions: _angular_core.Signal<SegmentedOption[]>;
+    readonly hasError: _angular_core.Signal<boolean>;
+    readonly showError: _angular_core.Signal<boolean>;
+    readonly showHint: _angular_core.Signal<boolean>;
+    readonly enabledOptions: _angular_core.Signal<SelectOption[]>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
         'ea-segmented--full-width': boolean;
         'ea-segmented--disabled': boolean;
+        'ea-segmented--error': boolean;
     }>;
     writeValue(val: string): void;
     registerOnChange(fn: (value: string) => void): void;
     registerOnTouched(fn: () => void): void;
     setDisabledState(isDisabled: boolean): void;
-    isSelected(option: SegmentedOption): boolean;
-    isOptionDisabled(option: SegmentedOption): boolean;
-    select(option: SegmentedOption): void;
+    isSelected(option: SelectOption): boolean;
+    isOptionDisabled(option: SelectOption): boolean;
+    /** Programmatically selects the given option. */
+    select(option: SelectOption): void;
     handleKeydown(event: KeyboardEvent, index: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SegmentedComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ea-segmented", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SegmentedComponent, "ea-segmented", never, { "options": { "alias": "options"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "fullWidth": { "alias": "fullWidth"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Shape preset of a skeleton placeholder. */
 type SkeletonVariant = 'text' | 'circle' | 'rect';
+/**
+ * Loading placeholder rendered as a pulsing block in one of three shapes.
+ * Honours `prefers-reduced-motion` by suppressing the pulse animation when
+ * the user has expressed that preference.
+ */
 declare class SkeletonComponent {
     readonly variant: _angular_core.InputSignal<SkeletonVariant>;
     readonly width: _angular_core.InputSignal<string | undefined>;
@@ -1124,7 +1450,14 @@ declare class SkeletonComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SkeletonComponent, "ea-skeleton", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; "height": { "alias": "height"; "required": false; "isSignal": true; }; "animated": { "alias": "animated"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual size of the slider track and thumb. */
 type SliderSize = 'sm' | 'md' | 'lg';
+/**
+ * Single-value range input controlled with pointer drag or full keyboard
+ * navigation (arrows, PageUp/PageDown, Home/End). Supports configurable
+ * `min`, `max`, and `step`, optional value display, and integrates with
+ * Angular forms via `ControlValueAccessor`.
+ */
 declare class SliderComponent implements ControlValueAccessor {
     readonly trackEl: _angular_core.Signal<ElementRef<HTMLDivElement> | undefined>;
     readonly label: _angular_core.InputSignal<string | undefined>;
@@ -1142,6 +1475,7 @@ declare class SliderComponent implements ControlValueAccessor {
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<number>;
+    /** Fires with the new (snapped, clamped) numeric value whenever the slider moves. */
     readonly changed: _angular_core.OutputEmitterRef<number>;
     private readonly _formDisabled;
     readonly dragging: _angular_core.WritableSignal<boolean>;
@@ -1150,11 +1484,12 @@ declare class SliderComponent implements ControlValueAccessor {
     readonly isDisabled: _angular_core.Signal<boolean>;
     readonly clampedValue: _angular_core.Signal<number>;
     readonly percent: _angular_core.Signal<number>;
-    readonly resolvedStatus: _angular_core.Signal<"default" | "error">;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-slider--error': boolean;
         'ea-slider--disabled': boolean;
         'ea-slider--dragging': boolean;
     }>;
@@ -1170,10 +1505,15 @@ declare class SliderComponent implements ControlValueAccessor {
     private updateFromPointer;
     private commitValue;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SliderComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ea-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "showMinMaxLabels": { "alias": "showMinMaxLabels"; "required": false; "isSignal": true; }; "formatValue": { "alias": "formatValue"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SliderComponent, "ea-slider", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "showValue": { "alias": "showValue"; "required": false; "isSignal": true; }; "showMinMaxLabels": { "alias": "showMinMaxLabels"; "required": false; "isSignal": true; }; "formatValue": { "alias": "formatValue"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/** Visual size of the spinner. */
 type SpinnerSize = 'sm' | 'md' | 'lg';
+/**
+ * SVG loading indicator with an accessible `role="status"`. Uses the `label`
+ * input as the accessible name announced to assistive technology.
+ */
 declare class SpinnerComponent {
     readonly size: _angular_core.InputSignal<SpinnerSize>;
     readonly label: _angular_core.InputSignal<string>;
@@ -1184,23 +1524,37 @@ declare class SpinnerComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<SpinnerComponent, "ea-spinner", never, { "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
+/** Visual size of the switch. */
 type SwitchSize = 'sm' | 'md' | 'lg';
+/**
+ * On/off toggle styled as a sliding switch. Backed by a visually hidden
+ * native checkbox and integrates with Angular forms via
+ * `ControlValueAccessor`.
+ */
 declare class SwitchComponent implements ControlValueAccessor {
     readonly label: _angular_core.InputSignal<string | undefined>;
+    readonly hint: _angular_core.InputSignal<string | undefined>;
+    readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly size: _angular_core.InputSignal<SwitchSize>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly required: _angular_core.InputSignal<boolean>;
     readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly checked: _angular_core.ModelSignal<boolean>;
+    /** Fires with the new checked state whenever the user toggles the switch. */
     readonly changed: _angular_core.OutputEmitterRef<boolean>;
     private readonly _formDisabled;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
+    readonly hasError: _angular_core.Signal<boolean>;
+    readonly showError: _angular_core.Signal<boolean>;
+    readonly showHint: _angular_core.Signal<boolean>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
         'ea-switch--checked': boolean;
         'ea-switch--disabled': boolean;
+        'ea-switch--error': boolean;
     }>;
     writeValue(val: boolean): void;
     registerOnChange(fn: (value: boolean) => void): void;
@@ -1208,9 +1562,14 @@ declare class SwitchComponent implements ControlValueAccessor {
     setDisabledState(isDisabled: boolean): void;
     handleChange(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<SwitchComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<SwitchComponent, "ea-switch", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵ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; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "checked": { "alias": "checked"; "required": false; "isSignal": true; }; }, { "checked": "checkedChange"; "changed": "changed"; }, never, never, true, never>;
 }
 
+/**
+ * Single tab within an `ea-tabs` group. Registers itself with the parent on
+ * init, exposes its `value` and `label`, and shows its projected content
+ * when active.
+ */
 declare class TabComponent implements OnInit, OnDestroy {
     private readonly tabs;
     readonly value: _angular_core.InputSignal<string>;
@@ -1224,29 +1583,50 @@ declare class TabComponent implements OnInit, OnDestroy {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabComponent, "ea-tab", never, { "value": { "alias": "value"; "required": true; "isSignal": true; }; "label": { "alias": "label"; "required": true; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** Visual style of the tab bar. */
 type TabsVariant = 'underline' | 'filled';
+/** Visual size of the tabs. */
 type TabsSize = 'sm' | 'md' | 'lg';
+/**
+ * Tab bar paired with content panels. Child `ea-tab` components register
+ * themselves automatically and the active panel is shown based on the
+ * `activeTab` two-way binding. Supports keyboard navigation
+ * (arrow keys, Home/End).
+ */
 declare class TabsComponent {
     readonly registeredTabs: _angular_core.WritableSignal<TabComponent[]>;
     readonly variant: _angular_core.InputSignal<TabsVariant>;
     readonly size: _angular_core.InputSignal<TabsSize>;
     readonly activeTab: _angular_core.ModelSignal<string>;
-    readonly tabChange: _angular_core.OutputEmitterRef<string>;
+    /** Fires with the value of the newly active tab. */
+    readonly changed: _angular_core.OutputEmitterRef<string>;
+    /** Registers a child tab so it appears in the tab bar; called automatically by `ea-tab`. */
     registerTab(tab: TabComponent): void;
+    /** Removes a previously registered child tab; called automatically by `ea-tab`. */
     unregisterTab(tab: TabComponent): void;
+    /** Programmatically activates the tab with the given value. */
     selectTab(value: string): void;
     handleKeydown(event: KeyboardEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TabsComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ea-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; "tabChange": "tabChange"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TabsComponent, "ea-tabs", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "activeTab": { "alias": "activeTab"; "required": false; "isSignal": true; }; }, { "activeTab": "activeTabChange"; "changed": "changed"; }, never, ["*"], true, never>;
 }
 
-type TagVariant = 'default' | 'primary' | 'success' | 'warning' | 'error' | 'info';
+/** Semantic colour scheme of a tag. */
+type TagVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+/** Visual size of a tag. */
 type TagSize = 'sm' | 'md' | 'lg';
+/**
+ * Inline label commonly used to represent filters, categories, or selected
+ * items. When `removable`, renders a close button that emits `removed`; the
+ * accessible name of that button is configurable via `removeLabel`.
+ */
 declare class TagComponent {
     readonly variant: _angular_core.InputSignal<TagVariant>;
     readonly size: _angular_core.InputSignal<TagSize>;
     readonly removable: _angular_core.InputSignal<boolean>;
     readonly disabled: _angular_core.InputSignal<boolean>;
+    readonly removeLabel: _angular_core.InputSignal<string>;
+    /** Fires when the user activates the remove button on a `removable` tag. */
     readonly removed: _angular_core.OutputEmitterRef<void>;
     readonly hostClasses: _angular_core.Signal<{
         [x: string]: boolean;
@@ -1254,18 +1634,23 @@ declare class TagComponent {
     }>;
     onRemove(event: MouseEvent): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TagComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "ea-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TagComponent, "ea-tag", never, { "variant": { "alias": "variant"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "removable": { "alias": "removable"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "removeLabel": { "alias": "removeLabel"; "required": false; "isSignal": true; }; }, { "removed": "removed"; }, never, ["*"], true, never>;
 }
 
+/** Visual size of the textarea. */
 type TextareaSize = 'sm' | 'md' | 'lg';
-type TextareaStatus = 'default' | 'error' | 'success';
+/** Axis along which the user is allowed to resize the textarea. */
 type TextareaResize = 'none' | 'vertical' | 'horizontal' | 'both';
+/**
+ * Multiline text field that mirrors the `ea-input` API. Supports configurable
+ * `rows`, `resize` direction, and `maxlength`, and integrates with Angular
+ * forms via `ControlValueAccessor`.
+ */
 declare class TextareaComponent implements ControlValueAccessor {
     readonly textareaEl: _angular_core.Signal<ElementRef<HTMLTextAreaElement> | undefined>;
     readonly label: _angular_core.InputSignal<string | undefined>;
     readonly placeholder: _angular_core.InputSignal<string>;
     readonly size: _angular_core.InputSignal<TextareaSize>;
-    readonly status: _angular_core.InputSignal<TextareaStatus>;
     readonly hint: _angular_core.InputSignal<string | undefined>;
     readonly errorMsg: _angular_core.InputSignal<string | undefined>;
     readonly disabled: _angular_core.InputSignal<boolean>;
@@ -1276,18 +1661,21 @@ declare class TextareaComponent implements ControlValueAccessor {
     readonly maxlength: _angular_core.InputSignal<number | undefined>;
     readonly id: _angular_core.InputSignal<string>;
     readonly value: _angular_core.ModelSignal<string>;
-    readonly focused: _angular_core.WritableSignal<boolean>;
+    readonly isFocused: _angular_core.WritableSignal<boolean>;
     private readonly _formDisabled;
-    readonly textareaFocused: _angular_core.OutputEmitterRef<FocusEvent>;
-    readonly textareaBlurred: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Fires when the textarea receives focus. */
+    readonly focused: _angular_core.OutputEmitterRef<FocusEvent>;
+    /** Fires when the textarea loses focus. */
+    readonly blurred: _angular_core.OutputEmitterRef<FocusEvent>;
     private onChange;
     private onTouched;
     readonly isDisabled: _angular_core.Signal<boolean>;
-    readonly resolvedStatus: _angular_core.Signal<TextareaStatus>;
+    readonly hasError: _angular_core.Signal<boolean>;
     readonly showError: _angular_core.Signal<boolean>;
     readonly showHint: _angular_core.Signal<boolean>;
     readonly wrapperClasses: _angular_core.Signal<{
         [x: string]: boolean;
+        'ea-textarea-wrapper--error': boolean;
         'ea-textarea-wrapper--focused': boolean;
         'ea-textarea-wrapper--disabled': boolean;
         'ea-textarea-wrapper--readonly': boolean;
@@ -1299,43 +1687,72 @@ declare class TextareaComponent implements ControlValueAccessor {
     handleInput(event: Event): void;
     handleFocus(event: FocusEvent): void;
     handleBlur(event: FocusEvent): void;
+    /** Moves keyboard focus to the underlying native textarea element. */
     focus(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TextareaComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ea-textarea", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "status": { "alias": "status"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "error"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "textareaFocused": "textareaFocused"; "textareaBlurred": "textareaBlurred"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TextareaComponent, "ea-textarea", never, { "label": { "alias": "label"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "hint": { "alias": "hint"; "required": false; "isSignal": true; }; "errorMsg": { "alias": "errorMsg"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "required": { "alias": "required"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "resize": { "alias": "resize"; "required": false; "isSignal": true; }; "maxlength": { "alias": "maxlength"; "required": false; "isSignal": true; }; "id": { "alias": "id"; "required": false; "isSignal": true; }; "value": { "alias": "value"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "focused": "focused"; "blurred": "blurred"; }, never, never, true, never>;
 }
 
+/** Semantic colour scheme of a toast. */
 type ToastVariant = 'default' | 'success' | 'warning' | 'error' | 'info';
+/** A single live toast notification rendered by `ea-toast`. */
 interface Toast {
     id: number;
     message: string;
     variant: ToastVariant;
     duration: number;
 }
+/** Optional configuration for a toast — defaults to `default` variant and 4s duration. */
 interface ToastOptions {
     variant?: ToastVariant;
     duration?: number;
 }
+/**
+ * Application-wide notification service. Use the convenience methods
+ * (`success`, `error`, `warning`, `info`) to push a toast, or call
+ * {@link show} for full control. A single `<ea-toast />` outlet must be
+ * present in the app for toasts to appear.
+ */
 declare class ToastService {
     private nextId;
     readonly toasts: _angular_core.WritableSignal<Toast[]>;
+    /** Shows a toast and returns its id; pass `duration: 0` to disable auto-dismiss. */
     show(message: string, options?: ToastOptions): number;
+    /** Shows a `success` toast and returns its id. */
     success(message: string, duration?: number): number;
+    /** Shows an `error` toast and returns its id. */
     error(message: string, duration?: number): number;
+    /** Shows a `warning` toast and returns its id. */
     warning(message: string, duration?: number): number;
+    /** Shows an `info` toast and returns its id. */
     info(message: string, duration?: number): number;
+    /** Removes the toast with the given id, if it is still active. */
     dismiss(id: number): void;
+    /** Removes all currently visible toasts. */
     clear(): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<ToastService>;
 }
 
+/**
+ * Outlet that renders the stack of active toasts produced by
+ * {@link ToastService}. Place a single `<ea-toast />` once in the root
+ * template so toasts created from anywhere in the app are surfaced.
+ */
 declare class ToastComponent {
     protected readonly toastService: ToastService;
+    protected getRole(toast: Toast): 'alert' | 'status';
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ToastComponent, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ToastComponent, "ea-toast", never, {}, {}, never, never, true, never>;
 }
 
+/** Placement of the tooltip relative to its host element. */
 type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Attaches a positioned tooltip to its host element. Shows on hover and
+ * focus, hides on leave/blur or Escape, and wires up `aria-describedby` so
+ * the tooltip text is announced to assistive technology.
+ */
 declare class TooltipDirective implements OnDestroy {
     private readonly el;
     private readonly renderer;
@@ -1350,10 +1767,12 @@ declare class TooltipDirective implements OnDestroy {
     ngOnDestroy(): void;
     private show;
     private hide;
+    private appendDescribedBy;
+    private removeDescribedBy;
     private positionTooltip;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<TooltipDirective, never>;
     static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TooltipDirective, "[eaTooltip]", never, { "eaTooltip": { "alias": "eaTooltip"; "required": true; "isSignal": true; }; "tooltipPosition": { "alias": "tooltipPosition"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 export { AccordionComponent, AccordionItemComponent, AlertCircleIconComponent, AlertComponent, AlertTriangleIconComponent, AppleIconComponent, ArrowDownIconComponent, ArrowLeftIconComponent, ArrowRightIconComponent, ArrowUpIconComponent, AutocompleteComponent, AvatarComponent, AvatarEditorComponent, BadgeComponent, BellIconComponent, BreadcrumbsComponent, ButtonComponent, CalendarIconComponent, CameraIconComponent, CardComponent, CheckCircleIconComponent, CheckIconComponent, CheckboxComponent, ChevronDownIconComponent, ChevronLeftIconComponent, ChevronRightIconComponent, ChevronUpIconComponent, ChevronsUpDownIconComponent, ClockIconComponent, CodeInputComponent, CopyIconComponent, DataTableComponent, DatePickerComponent, DialogComponent, DividerComponent, DownloadIconComponent, DrawerComponent, DropdownComponent, EagamiIconComponent, EagamiWordmarkComponent, EmptyStateComponent, ExternalLinkIconComponent, EyeIconComponent, EyeOffIconComponent, FacebookIconComponent, FileIconComponent, FilterIconComponent, GithubIconComponent, GoogleIconComponent, HeartIconComponent, ImageIconComponent, InfoIconComponent, InputComponent, LinkIconComponent, LoaderIconComponent, LogOutIconComponent, MailIconComponent, MenuComponent, MenuIconComponent, MenuItemComponent, MenuTriggerDirective, MicrosoftIconComponent, MinusIconComponent, MoreHorizontalIconComponent, PaginatorComponent, PencilIconComponent, PlusIconComponent, ProgressBarComponent, RadioComponent, RadioGroupComponent, RotateCcwIconComponent, SearchIconComponent, SegmentedComponent, SettingsIconComponent, SkeletonComponent, SliderComponent, SpinnerComponent, StarIconComponent, SwitchComponent, TabComponent, TabsComponent, TagComponent, TextareaComponent, ToastComponent, ToastService, TooltipDirective, TrashIconComponent, UploadIconComponent, UserIconComponent, XCircleIconComponent, XIconComponent, XTwitterIconComponent };
-export type { AlertVariant, AutocompleteOption, AutocompleteSize, AvatarEditorCropEvent, AvatarEditorCropState, AvatarEditorShape, AvatarShape, AvatarSize, BadgeSize, BadgeVariant, BreadcrumbClickEvent, BreadcrumbItem, BreadcrumbsSeparator, ButtonSize, ButtonType, ButtonVariant, CardHeaderAlign, CardPadding, CardVariant, CheckboxSize, CodeInputSize, CodeInputStatus, DataTableColumn, DataTableDensity, DataTableSortState, DatePickerFormat, DatePickerSize, DatePickerValue, DatePickerWeekStart, DialogSize, DividerOrientation, DrawerPosition, DrawerSize, DropdownOption, DropdownSize, EagamiWordmarkLayout, EagamiWordmarkVariant, EmptyStateSize, InputSize, InputStatus, InputType, MenuItemVariant, MenuPlacement, PaginatorPlacement, PaginatorState, ProgressBarSize, ProgressBarVariant, RadioOrientation, RadioSize, SegmentedOption, SegmentedSize, SkeletonVariant, SliderSize, SortDirection, SpinnerSize, SwitchSize, TabsSize, TabsVariant, TagSize, TagVariant, TextareaResize, TextareaSize, TextareaStatus, Toast, ToastOptions, ToastVariant, TooltipPosition };
+export type { AlertVariant, AutocompleteSize, AvatarEditorCropEvent, AvatarEditorCropState, AvatarEditorShape, AvatarShape, AvatarSize, BadgeSize, BadgeVariant, BreadcrumbClickEvent, BreadcrumbItem, BreadcrumbsSeparator, ButtonSize, ButtonType, ButtonVariant, CardHeaderAlign, CardPadding, CardVariant, CheckboxSize, CodeInputSize, DataTableColumn, DataTableDensity, DataTableSortDirection, DataTableSortState, DatePickerFormat, DatePickerSize, DatePickerValue, DatePickerWeekStart, DialogSize, DividerOrientation, DrawerPosition, DrawerSize, DropdownSize, EagamiWordmarkLayout, EagamiWordmarkVariant, EmptyStateHeadingLevel, EmptyStateSize, InputSize, InputType, MenuItemVariant, MenuPlacement, PaginatorAlign, PaginatorState, ProgressBarSize, ProgressBarVariant, RadioOrientation, RadioSize, SegmentedSize, SelectOption, SkeletonVariant, SliderSize, SpinnerSize, SwitchSize, TabsSize, TabsVariant, TagSize, TagVariant, TextareaResize, TextareaSize, Toast, ToastOptions, ToastVariant, TooltipPosition };