@forgeroute/ui 0.4.56 → 0.4.58

package/types/forgeroute-ui.d.ts

@@ -1049,6 +1049,11 @@ export declare function isoKey(p: {
 export declare function parseTime(value: string | null | undefined): number | null;
 /** "9:00 AM" / "12:30 PM" from an `HH:mm` value (returned unchanged when it cannot be parsed; '' for null/undefined/non-strings). */
 export declare function formatTime(value: string | null | undefined): string;
+/**
+ * Joins a control's own `aria-describedby` ids with the ids a host passes through `[ariaDescribedBy]` (space separated, own ids first,
+ * duplicates dropped). Returns null when there is nothing to point at, so the attribute is absent.
+ */
+export declare function mergeDescribedBy(own: string | null | undefined, external: string | null | undefined): string | null;
 /**
  * One choice. `V` defaults to `string`, so existing `SelectOption[]` code is unchanged; `ui-select` itself accepts
  * `SelectOption<string | number>[]` (numeric values for `valueType="number"`).
@@ -1085,10 +1090,12 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly valueType: import("@angular/core").InputSignal<"string" | "number">;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "default">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -1098,7 +1105,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   /** The selected option's `description` ('' when none is selected or it has none); hidden while an error shows. */
   protected readonly _selectedDescription: import("@angular/core").Signal<string>;
   /** ids of the texts that describe the select: the error / hint, then the selected option's description. */
-  protected readonly _describedBy: import("@angular/core").Signal<string>;
+  protected readonly _describedBy: import("@angular/core").Signal<string | null>;
   private readonly _reveal;
   private readonly _issue;
   /** True while the value breaks a built-in rule or the host passed an `[error]`. */
@@ -1170,6 +1177,11 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "error": {
       "alias": "error";
       "required": false;
@@ -2140,7 +2152,7 @@ export declare class SidePanelComponent implements OnDestroy {
   readonly cancelLabel: import("@angular/core").InputSignal<string>;
   /** Right-aligned primary action button label. Empty string = hidden. */
   readonly primaryLabel: import("@angular/core").InputSignal<string>;
-  readonly primaryVariant: import("@angular/core").InputSignal<"primary" | "danger" | "warning">;
+  readonly primaryVariant: import("@angular/core").InputSignal<"danger" | "warning" | "primary">;
   readonly primaryLoading: import("@angular/core").InputSignal<boolean>;
   readonly primaryDisabled: import("@angular/core").InputSignal<boolean>;
   /** `data-testid` of the Cancel button; none when empty (default). */
@@ -2248,7 +2260,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
   readonly title: import("@angular/core").InputSignal<string>;
   readonly description: import("@angular/core").InputSignal<string>;
   readonly maxWidth: import("@angular/core").InputSignal<string>;
-  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "auto" | "visible">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"auto" | "hidden" | "visible">;
   /** `data-testid` of the dialog element itself (the host `<ui-modal>` is always in the page, the dialog only while open). None when empty. */
   readonly dialogTestId: import("@angular/core").InputSignal<string>;
   /** Hides the header X button (e.g. while a request is running). Escape and a backdrop click still close unless `closable` is false. */
@@ -2258,12 +2270,28 @@ export declare class ModalComponent implements OnInit, OnDestroy {
    * (e.g. while a save is running; the host closes it itself). Default `true` = today's behaviour.
    */
   readonly closable: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Look of the dialog. `'default'` (today's dialog; a bottom sheet on a phone) or `'kiosk'`: a darker backdrop and a centred card on every screen
+   * size that never grows past the visible viewport (header and footer stay, the body scrolls, 100dvh with a 100vh fallback). Meant for full-attention
+   * dialogs such as a payment or bank-account entry; combine with `[closeOnBackdrop]="false"` and `[busy]`. See docs/modal-kiosk-and-bank-account-form.md.
+   */
+  readonly layout: import("@angular/core").InputSignal<"default" | "kiosk">;
+  /** `false` = a click on the backdrop does not close (a mis-click must not lose a half-filled payment form). Default `true`. */
+  readonly closeOnBackdrop: import("@angular/core").InputSignal<boolean>;
+  /** `false` = Escape does not close. Default `true`. */
+  readonly closeOnEscape: import("@angular/core").InputSignal<boolean>;
+  /**
+   * `true` while a request is running (e.g. a payment is processing): sets `aria-busy` on the dialog, disables the X button and blocks Escape and
+   * backdrop dismissal, whatever `closable` / `closeOnEscape` / `closeOnBackdrop` say. Default `false`.
+   */
+  readonly busy: import("@angular/core").InputSignal<boolean>;
   readonly close: import("@angular/core").OutputEmitterRef<void>;
   /**
    * Element that gets focus back when the dialog closes. Takes precedence over the element that was focused (or last
    * clicked / activated) when it opened; used only if it is still in the page and visible. Default null = the opener.
    */
   readonly returnFocusTo: import("@angular/core").InputSignal<HTMLElement | null>;
+  protected readonly kiosk: import("@angular/core").Signal<boolean>;
   protected readonly titleId: string;
   private readonly el;
   private readonly ren;
@@ -2276,6 +2304,8 @@ export declare class ModalComponent implements OnInit, OnDestroy {
   private readonly _interaction;
   constructor();
   onKeydown(event: KeyboardEvent): void;
+  /** Emits `close` when the dialog may be dismissed this way (not closable / busy / backdrop or Escape switched off = nothing). */
+  protected dismiss(via: 'backdrop' | 'escape' | 'close'): void;
   /** A focus-guard sentinel received focus (Tab left the dialog's tab order, e.g. out of an iframe): send it back inside. */
   protected onGuardFocus(which: 'start' | 'end', event?: FocusEvent): void;
   /** Initial focus — see `focusInitial` (autofocus target → first usable field → dialog container). */
@@ -2325,6 +2355,26 @@ export declare class ModalComponent implements OnInit, OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "layout": {
+      "alias": "layout";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeOnBackdrop": {
+      "alias": "closeOnBackdrop";
+      "required": false;
+      "isSignal": true;
+    };
+    "closeOnEscape": {
+      "alias": "closeOnEscape";
+      "required": false;
+      "isSignal": true;
+    };
+    "busy": {
+      "alias": "busy";
+      "required": false;
+      "isSignal": true;
+    };
     "returnFocusTo": {
       "alias": "returnFocusTo";
       "required": false;
@@ -2332,7 +2382,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
     };
   }, {
     "close": "close";
-  }, never, ["*", "[modal-footer-left]", "[modal-footer-center]", "[modal-footer-right]"], true, never>;
+  }, never, ["[modal-header-end]", "*", "[modal-footer-left]", "[modal-footer-center]", "[modal-footer-right]"], true, never>;
 }
 export type ToastType = 'success' | 'error' | 'info';
 export declare class ToastService implements OnDestroy {
@@ -3913,7 +3963,7 @@ export declare class ButtonComponent {
    * `ghost-start`: a ghost button for list / section toggles - a full-width row with its content aligned to the start, transparent
    * background, hover tint and the normal focus ring. Pair it with `ariaExpanded` / `ariaPressed`; the label may contain a heading element.
    */
-  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "danger" | "warning" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"link" | "danger" | "warning" | "primary" | "secondary" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
   /** Renders an anchor to this route instead of a button (use with `variant="link"` for an inline text link). `['/settings']` or `'/settings'`. While `disabled` or `loading` it renders a non-clickable `<span role="link" aria-disabled>` with no href (like `href`). */
   readonly routerLink: import("@angular/core").InputSignal<string | readonly unknown[] | null>;
   /** Query params of the `routerLink` (e.g. `{ section: 'deal-defaults' }`). */
@@ -3934,7 +3984,7 @@ export declare class ButtonComponent {
    */
   readonly href: import("@angular/core").InputSignal<string | null>;
   /** Where to open the `href` (`_blank` = a new tab). */
-  readonly target: import("@angular/core").InputSignal<"_self" | "_blank" | "_parent" | "_top" | null>;
+  readonly target: import("@angular/core").InputSignal<"_blank" | "_self" | "_parent" | "_top" | null>;
   /** `rel` of the `href` link. A `_blank` target always gets `noopener noreferrer` added. */
   readonly rel: import("@angular/core").InputSignal<string | null>;
   /** The href when it is allowed (http, https, mailto, tel, sms or a relative URL), else null. */
@@ -3958,8 +4008,8 @@ export declare class ButtonComponent {
   private readonly _narrow;
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
-  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
+  readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | "lg">;
+  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4598,6 +4648,130 @@ export declare class OptionCardComponent {
     "action": "action";
   }, never, ["*"], true, never>;
 }
+/** Default ACH debit authorization text (same wording the contractor bank-account kiosk used). */
+export declare const DEFAULT_BANK_MANDATE_TEXT: string;
+export type BankAccountType = 'checking' | 'savings';
+export type BankHolderType = 'individual' | 'company';
+/** What `(submitted)` emits: every text value trimmed, `mandateAccepted` always `true`. */
+export interface BankAccountFormValue {
+  routingNumber: string;
+  accountNumber: string;
+  accountType: BankAccountType;
+  accountHolderName: string;
+  holderType: BankHolderType;
+  mandateAccepted: true;
+}
+export declare const DEFAULT_BANK_ACCOUNT_TYPE_OPTIONS: SelectOption[];
+export declare const DEFAULT_BANK_HOLDER_TYPE_OPTIONS: SelectOption[];
+/**
+ * `ui-bank-account-form` - the US bank-account entry form (routing number, account number + confirmation, account type, holder name + type,
+ * ACH debit authorization). Built only from library inputs; it holds NO HTTP and no provider logic: the host listens to `(submitted)` and talks to
+ * its payment provider (Stripe `confirmUsBankAccountSetup`, Square, ...). See docs/modal-kiosk-and-bank-account-form.md.
+ *
+ * - Validation is inline through the inputs' own `[error]` / built-in rules. The routing number is only checked for 9 digits (no ABA checksum: the
+ *   provider validates the real number, and a client checksum would reject test numbers). Account numbers are 4-17 digits.
+ * - Messages show after blur, while a field holds something invalid, or while `[showErrors]` is true; a failed `submit()` reveals them all.
+ * - The form provides `UiFieldValidity` (`invalid` = not submittable), so a host can gate its own button with `viewChildren(UiFieldValidity)`,
+ *   or use `(validChange)`.
+ * - The host's footer button calls `form.submit()` (via `viewChild`); Enter in a text field submits too.
+ */
+export declare class BankAccountFormComponent implements UiFieldValidity {
+  /** Reveal every built-in error now (e.g. bind to a panel's `touched()`); `submit()` on an invalid form also reveals them. */
+  readonly showErrors: import("@angular/core").InputSignal<boolean>;
+  /** Disables every field and blocks `submit()`. */
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /** Like `disabled`, plus `aria-busy` on the host: a provider call is running. */
+  readonly busy: import("@angular/core").InputSignal<boolean>;
+  /** The authorization text next to the checkbox (it is the checkbox label). The unticked default is never changed by the form. */
+  readonly mandateText: import("@angular/core").InputSignal<string>;
+  /** Account type choices; values must stay `checking` / `savings`. */
+  readonly accountTypeOptions: import("@angular/core").InputSignal<SelectOption<string>[]>;
+  /** Holder type choices; values must stay `individual` / `company`. */
+  readonly holderTypeOptions: import("@angular/core").InputSignal<SelectOption<string>[]>;
+  /** Pre-fills the account holder name (e.g. the customer's name) whenever it changes; the user can edit it. */
+  readonly accountHolderNameDefault: import("@angular/core").InputSignal<string>;
+  /** Prefix of the inner test ids: `<prefix>-routing`, `-account`, `-confirm`, `-holder-name`, `-account-type`, `-holder-type`, `-mandate`. */
+  readonly testIdPrefix: import("@angular/core").InputSignal<string>;
+  /** Emits the typed payload when `submit()` runs on a valid form. */
+  readonly submitted: import("@angular/core").OutputEmitterRef<BankAccountFormValue>;
+  /** Emits `true` / `false` whenever the form becomes submittable / not (also once on init). */
+  readonly validChange: import("@angular/core").OutputEmitterRef<boolean>;
+  protected readonly routingNumber: import("@angular/core").WritableSignal<string>;
+  protected readonly accountNumber: import("@angular/core").WritableSignal<string>;
+  protected readonly confirmAccount: import("@angular/core").WritableSignal<string>;
+  protected readonly accountHolderName: import("@angular/core").WritableSignal<string>;
+  protected readonly accountType: import("@angular/core").WritableSignal<string>;
+  protected readonly holderType: import("@angular/core").WritableSignal<string>;
+  protected readonly mandateAccepted: import("@angular/core").WritableSignal<boolean>;
+  private readonly _touched;
+  protected readonly routingFormatter: (raw: string) => string;
+  protected readonly accountFormatter: (raw: string) => string;
+  protected readonly locked: import("@angular/core").Signal<boolean>;
+  protected readonly reveal: import("@angular/core").Signal<boolean>;
+  protected readonly routingError: import("@angular/core").Signal<"" | "Routing number must be 9 digits.">;
+  protected readonly accountError: import("@angular/core").Signal<"" | "Account number must be at least 4 digits.">;
+  protected readonly confirmError: import("@angular/core").Signal<"" | "Account numbers do not match.">;
+  /** First reason the form cannot be submitted ('' when it can). */
+  readonly errorMessage: import("@angular/core").Signal<"" | "Account holder name is required." | "Routing number is required." | "Routing number must be 9 digits." | "Account number is required." | "Account number must be at least 4 digits." | "Confirm account number is required." | "Account numbers do not match." | "Select a valid account type." | "Select a valid holder type." | "You must authorize ACH debits to continue.">;
+  /** True while the form cannot be submitted (`UiFieldValidity`). */
+  readonly invalid: import("@angular/core").Signal<boolean>;
+  /** True when the form can be submitted (ignores `disabled` / `busy`). */
+  readonly valid: import("@angular/core").Signal<boolean>;
+  private readonly _fields;
+  constructor();
+  protected id(name: string): string;
+  protected onEnter(event: Event): void;
+  /** Validates and, when valid, emits `submitted`. An invalid form reveals all messages and emits nothing. Ignored while `disabled` / `busy`. */
+  submit(): void;
+  /** Clears every field back to the defaults (checking, individual, authorization unticked, holder name = `accountHolderNameDefault`). */
+  reset(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<BankAccountFormComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<BankAccountFormComponent, "ui-bank-account-form", never, {
+    "showErrors": {
+      "alias": "showErrors";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "busy": {
+      "alias": "busy";
+      "required": false;
+      "isSignal": true;
+    };
+    "mandateText": {
+      "alias": "mandateText";
+      "required": false;
+      "isSignal": true;
+    };
+    "accountTypeOptions": {
+      "alias": "accountTypeOptions";
+      "required": false;
+      "isSignal": true;
+    };
+    "holderTypeOptions": {
+      "alias": "holderTypeOptions";
+      "required": false;
+      "isSignal": true;
+    };
+    "accountHolderNameDefault": {
+      "alias": "accountHolderNameDefault";
+      "required": false;
+      "isSignal": true;
+    };
+    "testIdPrefix": {
+      "alias": "testIdPrefix";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "submitted": "submitted";
+    "validChange": "validChange";
+  }, never, never, true, never>;
+}
 export interface ActiveConfirm {
   title: string;
   message: string;
@@ -4783,9 +4957,11 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * `search`, `text`, `none`). Empty (default) = the browser's default for the field, except `type="tel"`, which keeps `tel`.
    * It only picks the keyboard; it does not restrict what can be typed or pasted.
    */
-  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "search" | "text" | "email" | "tel" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
   /** When true, automatically formats the value as a US phone number as the user types. */
   readonly phoneFormat: import("@angular/core").InputSignal<boolean>;
@@ -4971,6 +5147,11 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "error": {
       "alias": "error";
       "required": false;
@@ -5043,6 +5224,8 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   /**
    * Opt-in. `false` (default) = unchanged: a labelled field's hint renders INSIDE the `<label>` ("Label (hint)" is the accessible name,
    * no aria-describedby for it). `true` = the hint is a sibling of the label (`.ta-head` row, id `<textarea id>-hint`), the accessible
@@ -5065,6 +5248,7 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
    * hint is replaced by the error) followed by the error. The label is the accessible NAME; the hint is the DESCRIPTION.
    */
   protected readonly _describedBy: import("@angular/core").Signal<string | null>;
+  private readonly _ownDescribedBy;
   private readonly _reveal;
   private readonly _issue;
   /** True while the value breaks a built-in rule or the host passed an `[error]`. */
@@ -5132,6 +5316,11 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "hintAsDescription": {
       "alias": "hintAsDescription";
       "required": false;
@@ -5535,6 +5724,8 @@ export declare class DateInputComponent implements ControlValueAccessor, Validat
   readonly min: import("@angular/core").InputSignal<string>;
   readonly max: import("@angular/core").InputSignal<string>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
@@ -5543,6 +5734,8 @@ export declare class DateInputComponent implements ControlValueAccessor, Validat
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
+  /** `aria-describedby`: the error / hint text, then the host's `ariaDescribedBy` id(s). */
+  protected readonly _describedBy: import("@angular/core").Signal<string | null>;
   private readonly _reveal;
   private readonly _issue;
   /** True while the value breaks a built-in rule or the host passed an `[error]`. */
@@ -5597,6 +5790,11 @@ export declare class DateInputComponent implements ControlValueAccessor, Validat
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "error": {
       "alias": "error";
       "required": false;
@@ -5623,6 +5821,8 @@ export declare class DatetimeInputComponent implements ControlValueAccessor, Val
   readonly min: import("@angular/core").InputSignal<string>;
   readonly max: import("@angular/core").InputSignal<string>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
@@ -5630,6 +5830,8 @@ export declare class DatetimeInputComponent implements ControlValueAccessor, Val
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
+  /** `aria-describedby`: the error / hint text, then the host's `ariaDescribedBy` id(s). */
+  protected readonly _describedBy: import("@angular/core").Signal<string | null>;
   private readonly _reveal;
   private readonly _issue;
   /** True while the value breaks a built-in rule or the host passed an `[error]`. */
@@ -5682,6 +5884,11 @@ export declare class DatetimeInputComponent implements ControlValueAccessor, Val
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "error": {
       "alias": "error";
       "required": false;
@@ -5709,6 +5916,8 @@ export declare class TimeInputComponent implements ControlValueAccessor, Validat
   readonly min: import("@angular/core").InputSignal<string>;
   readonly max: import("@angular/core").InputSignal<string>;
   readonly hint: import("@angular/core").InputSignal<string>;
+  /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
@@ -5718,6 +5927,8 @@ export declare class TimeInputComponent implements ControlValueAccessor, Validat
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
   protected readonly _inputId: string;
+  /** `aria-describedby`: the error / hint text, then the host's `ariaDescribedBy` id(s). */
+  protected readonly _describedBy: import("@angular/core").Signal<string | null>;
   private readonly _reveal;
   private readonly _issue;
   /** True while the value breaks a built-in rule or the host passed an `[error]`. */
@@ -5774,6 +5985,11 @@ export declare class TimeInputComponent implements ControlValueAccessor, Validat
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "error": {
       "alias": "error";
       "required": false;
@@ -6208,7 +6424,7 @@ export declare class DropdownComponent {
   readonly loader: import("@angular/core").InputSignal<(() => Promise<DropdownItem[]>) | null>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly activeValue: import("@angular/core").InputSignal<string>;
-  readonly variant: import("@angular/core").InputSignal<"badge" | "button">;
+  readonly variant: import("@angular/core").InputSignal<"button" | "badge">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
   /**
    * Fixed width of the trigger as a CSS length (e.g. `'280px'`). Empty (default) = the trigger is as wide as its label. When set, the trigger keeps that
@@ -6529,7 +6745,7 @@ export declare class FormRowComponent {
  * child simply takes the full width. Keep a numeric span within the row's `cols` (use `all` for the whole row).
  */
 export declare class FormColSpanDirective {
-  readonly uiColSpan: import("@angular/core").InputSignal<"" | "2" | "3" | 2 | 3 | "all">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | "all" | "2" | 2 | "3" | 3>;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -6779,6 +6995,8 @@ export declare class CardListItemComponent {
   readonly actionLabel: import("@angular/core").InputSignal<string>;
   readonly actionTestId: import("@angular/core").InputSignal<string>;
   readonly actionAriaLabel: import("@angular/core").InputSignal<string>;
+  /** A built-in Edit / View / action / delete button shows (the row then keeps a minimum height so a badge and a chip never overlap). */
+  protected readonly hasBuiltInChip: import("@angular/core").Signal<boolean>;
   readonly editClick: import("@angular/core").OutputEmitterRef<void>;
   readonly viewClick: import("@angular/core").OutputEmitterRef<void>;
   readonly delete: import("@angular/core").OutputEmitterRef<void>;
@@ -7644,9 +7862,9 @@ export declare class ChipGroupComponent {
   readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
   /** Space below the chip group. */
   readonly spaceBelow: import("@angular/core").InputSignal<"none" | "sm" | "md">;
-  protected readonly _gap: import("@angular/core").Signal<"6px" | "12px" | "8px">;
-  protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
-  protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
+  protected readonly _gap: import("@angular/core").Signal<"12px" | "6px" | "8px">;
+  protected readonly _spaceAbove: import("@angular/core").Signal<"12px" | "0" | "6px">;
+  protected readonly _spaceBelow: import("@angular/core").Signal<"12px" | "0" | "6px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ChipGroupComponent, "ui-chip-group", never, {
     "gap": {
@@ -9439,7 +9657,7 @@ export declare class PdfHotspotComponent {
   /** `ready`: clickable; `blocked`: disabled (a prerequisite is missing); `signed`: shows `image`. */
   readonly state: import("@angular/core").InputSignal<"ready" | "blocked" | "signed">;
   /** `warning` gives the ready state an amber look (e.g. for initials), default is blue. */
-  readonly tone: import("@angular/core").InputSignal<"primary" | "warning">;
+  readonly tone: import("@angular/core").InputSignal<"warning" | "primary">;
   /** Text of the ready button (e.g. "Sign Here"). */
   readonly label: import("@angular/core").InputSignal<string>;
   /** Text of the blocked button (e.g. "Add signature above"). */
@@ -12701,4 +12919,251 @@ export declare const DEFAULT_EMAIL_TEMPLATE_VARIABLE_GROUPS: {
  * Content-Security-Policy meta blocks scripts and anything but images / inline styles, and links open nowhere (sandbox, no popups).
  */
 export declare function buildPreviewDocument(bodyHtml: string): string;
+export type ShareOption = 'native' | 'facebook' | 'x' | 'linkedin' | 'email' | 'gmail' | 'outlook' | 'copy';
+interface ShareTile {
+  value: ShareOption;
+  label: string;
+  background: string;
+}
+/**
+ * "Share" control for a public page (an obituary, a blog post, any shareable item). The button opens a floating panel (over the page, so nothing moves)
+ * with one round icon per option and its name underneath, in a row like a phone's share sheet. Phones and tablets get Facebook, X,
+ * LinkedIn, Email (their mail app), Copy link and "More" (the device's own share sheet). Desktops get Gmail and Outlook instead of Email:
+ * a `mailto:` link does nothing on a computer without a mail app, while the webmail compose windows always open. "Link copied" is the library toast. The link is the public page
+ * of the item (never an `?embed=true` widget URL). Theming: `--ui-share-accent` (focus ring and the Copy link tile; default the library `--primary`).
+ *
+ *   <ui-share-menu [url]="pageUrl" [title]="post.title" label="blog post" />
+ */
+export declare class ShareMenuComponent {
+  /** The public page link to share. */
+  readonly url: import("@angular/core").InputSignal<string>;
+  /** The headline: the item's name or title (the X text, the email subject and the share-sheet title). */
+  readonly title: import("@angular/core").InputSignal<string>;
+  /** Used in the accessible name, e.g. "obituary" or "blog post" (→ "Share obituary"). */
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** Unique id of the floating panel (several menus can be on one page). */
+  protected readonly panelId: string;
+  private readonly doc;
+  private readonly toast;
+  private readonly injector;
+  private readonly host;
+  private readonly trigger;
+  private readonly panel;
+  readonly open: import("@angular/core").WritableSignal<boolean>;
+  /** Pixels the panel is moved sideways so it never runs off either edge of the screen (or of the embedding frame). */
+  readonly shiftX: import("@angular/core").WritableSignal<number>;
+  /**
+   * "More" opens the device's own share sheet (Messages, AirDrop, Mail, WhatsApp…). It is offered on touch devices only: a desktop
+   * browser has the other options already, and its share sheet is limited (or absent), so "More" there would look broken.
+   */
+  private readonly isTouchDevice;
+  private readonly canNativeShare;
+  readonly tiles: import("@angular/core").Signal<ShareTile[]>;
+  /** The link each option opens (social sites in a new tab; the mail app in this window). */
+  readonly links: import("@angular/core").Signal<{
+    facebook: string;
+    x: string;
+    linkedin: string;
+    email: string;
+    gmail: string;
+    outlook: string;
+  }>;
+  toggle(event: Event): void;
+  private show;
+  close(returnFocus?: boolean): void;
+  onEscape(): void;
+  onDocumentClick(event: Event): void;
+  onFocusOut(event: FocusEvent): void;
+  /** Left / Right / Home / End move between the options. */
+  onPanelKeydown(event: KeyboardEvent): void;
+  choose(option: ShareOption): void;
+  private nativeShare;
+  /** Phones and tablets: opens the device's mail app with the subject and body filled in. */
+  private email;
+  private copy;
+  private legacyCopy;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ShareMenuComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ShareMenuComponent, "ui-share-menu", never, {
+    "url": {
+      "alias": "url";
+      "required": true;
+      "isSignal": true;
+    };
+    "title": {
+      "alias": "title";
+      "required": true;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+/**
+ * The links the public Share control builds. Pure functions so the component and its spec produce the exact same text.
+ * Every value is URL-encoded, so a title holding `&`, `#`, quotes or non-ASCII text can never break out of its query parameter.
+ */
+export declare const facebookShareUrl: (url: string) => string;
+export declare const xShareUrl: (url: string, text: string) => string;
+export declare const linkedInShareUrl: (url: string) => string;
+/** Gmail's compose window (a new tab) with the subject and body filled in: for desktop visitors, who often have no mail app for `mailto:`. */
+export declare const gmailShareUrl: (url: string, title: string) => string;
+/** Outlook.com's compose window (a new tab) with the subject and body filled in. */
+export declare const outlookShareUrl: (url: string, title: string) => string;
+/** `mailto:` with the title as the subject and the title plus the link as the body (encodeURIComponent, never `+` for spaces). */
+export declare const emailShareUrl: (url: string, title: string) => string;
+export type SnackbarType = 'success' | 'error' | 'info';
+/** An optional button inside a snackbar (e.g. "View"): clicking it runs `callback` and closes the snackbar. */
+export interface SnackbarAction {
+  label: string;
+  callback: () => void;
+}
+export interface SnackbarMessage {
+  id: number;
+  message: string;
+  type: SnackbarType;
+  action?: SnackbarAction;
+}
+/**
+ * Stacked, top-right notifications: several can be on screen at once, each closes itself after `duration` ms (0 = stays until closed)
+ * and can carry one action button. Render them once, near the root of the app, with `<ui-snackbar />`.
+ * (`ToastService` / `<ui-toast>` is the single bottom-centre message; this is the stack with actions.)
+ */
+export declare class SnackbarService {
+  private readonly _messages;
+  private nextId;
+  private readonly timers;
+  /** The messages on screen, oldest first (a copy). */
+  messages$(): SnackbarMessage[];
+  showSuccess(message: string, duration?: number): void;
+  showError(message: string, duration?: number): void;
+  showInfo(message: string, duration?: number, action?: SnackbarAction): void;
+  private show;
+  dismiss(id: number): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
+}
+/**
+ * The on-screen stack of `SnackbarService` messages (top-right, above the page). Put one `<ui-snackbar />` near the root of the app.
+ * Each message is a library `ui-alert` (green success, red error, blue info) with a close button and, when the message has one, an
+ * action button. Test ids: `success-message` / `error-message` / `info-message` on each message, `snackbar-action` on the action button.
+ */
+export declare class SnackbarComponent {
+  private readonly service;
+  /** The messages on screen. */
+  protected readonly messages: import("@angular/core").Signal<SnackbarMessage[]>;
+  protected variant(m: SnackbarMessage): 'success' | 'danger' | 'info';
+  protected dismiss(id: number): void;
+  /** Runs the action, then closes the message. */
+  protected runAction(m: SnackbarMessage, callback: () => void): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SnackbarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SnackbarComponent, "ui-snackbar", never, {}, {}, never, never, true, never>;
+}
+/**
+ * A banner across the top of the page while the browser is offline (`navigator.onLine`, kept current by the window's `online` /
+ * `offline` events). The user can dismiss it; it comes back the next time the connection drops. Put one near the root of the app:
+ *
+ *   <ui-offline-banner />
+ *
+ * `offline` overrides the browser's own state (for an app that does its own connectivity check). Texts can be changed with `title`
+ * and `message`. Test ids: `offline-banner`, `offline-banner-dismiss`.
+ */
+export declare class OfflineBannerComponent {
+  readonly title: import("@angular/core").InputSignal<string>;
+  readonly message: import("@angular/core").InputSignal<string>;
+  /** Forces the state (true = offline); `null` (default) follows the browser. */
+  readonly offline: import("@angular/core").InputSignal<boolean | null>;
+  private readonly browserOffline;
+  private readonly dismissed;
+  protected readonly isOffline: import("@angular/core").Signal<boolean>;
+  protected readonly visible: import("@angular/core").Signal<boolean>;
+  constructor();
+  protected dismiss(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<OfflineBannerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<OfflineBannerComponent, "ui-offline-banner", never, {
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
+    "message": {
+      "alias": "message";
+      "required": false;
+      "isSignal": true;
+    };
+    "offline": {
+      "alias": "offline";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export type ReminderAlertTone = 'danger' | 'warning' | 'info' | 'neutral';
+export interface ReminderAlertAction {
+  /** Reported by `(action)`; also part of the button's test id (`alert-<id>`). */
+  id: string;
+  label: string;
+  variant?: 'primary' | 'secondary' | 'ghost';
+}
+/** One in-app alert: a due reminder, an event starting soon, anything the user should notice now. The HOST decides what is due and what the buttons do. */
+export interface ReminderAlertItem {
+  id: string;
+  tone: ReminderAlertTone;
+  /** Small uppercase line above the title, e.g. "Overdue Reminder". */
+  label: string;
+  title: string;
+  /** Plain lines under the title (case name, description, due date…). */
+  lines?: string[];
+  /** A small purple pill under the title, e.g. the organization that created the item. */
+  badge?: {
+    label: string;
+    ariaLabel?: string;
+    testId?: string;
+  };
+  actions?: ReminderAlertAction[];
+  /** Accessible name of the hide (X) button; default "Hide alert". */
+  hideLabel?: string;
+  /** Test id of the hide button; default `alert-hide`. */
+  hideTestId?: string;
+}
+/**
+ * The stack of in-app alerts in the top-right corner (above the page, newest app state wins: the host passes the list). Each alert is a
+ * library `ui-alert` with a coloured tone, its label / title / lines, an optional badge, action buttons and a hide (X) button:
+ *
+ *   <ui-reminder-alerts [items]="alerts()" (action)="onAction($event)" (hidden)="hide($event)" />
+ *
+ * `(action)` gives `{ item, actionId }`; `(hidden)` gives the item. The component keeps no state: the host removes an item from `items`
+ * to make it go away (hiding, completing, snoozing are the host's rules). Nothing is drawn for an empty list.
+ */
+export declare class ReminderAlertsComponent {
+  readonly items: import("@angular/core").InputSignal<ReminderAlertItem[]>;
+  /** Accessible name of the region. */
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** An action button was clicked. */
+  readonly action: import("@angular/core").OutputEmitterRef<{
+    item: ReminderAlertItem;
+    actionId: string;
+  }>;
+  /** The hide (X) button was clicked. */
+  readonly hidden: import("@angular/core").OutputEmitterRef<ReminderAlertItem>;
+  protected variant(item: ReminderAlertItem): AlertVariant;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ReminderAlertsComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ReminderAlertsComponent, "ui-reminder-alerts", never, {
+    "items": {
+      "alias": "items";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "action": "action";
+    "hidden": "hidden";
+  }, never, never, true, never>;
+}
 export type { CalendarDay, CalendarRange, CalendarViewMode };