@forgeroute/ui 0.4.72 → 0.4.73

package/types/forgeroute-ui.d.ts

@@ -1,5 +1,5 @@
 import * as i0 from "@angular/core";
-import { EnvironmentProviders, InjectionToken, OnDestroy, OnInit, Signal, TemplateRef, WritableSignal } from "@angular/core";
+import { AfterContentChecked, EnvironmentProviders, InjectionToken, OnDestroy, OnInit, Signal, TemplateRef, WritableSignal } from "@angular/core";
 import { UrlTree } from "@angular/router";
 import { Observable, Subject } from "rxjs";
 import { AbstractControl, ControlValueAccessor, FormControl, ValidationErrors, Validator, ValidatorFn } from "@angular/forms";
@@ -1133,6 +1133,13 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly label: import("@angular/core").InputSignal<string>;
   /** Accessible name for a select with no visible label (e.g. an inline row or table-cell select). */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /**
+   * Compact, label-less look for a filter above KPI cards or in a toolbar (library source 2026-11-04, not yet published). `true` renders NO visible
+   * label row (no gap above the field; the `*` marker goes with it) while `label` stays the select's accessible name through `aria-label` and still
+   * words the built-in "<label> is required." message. An explicit `ariaLabel` wins over `label`. Default `false` = unchanged. Combine with
+   * `size="sm"`. (`ariaLabel` alone, with no `label`, was already the way to name a label-less select in a table cell.)
+   */
+  readonly labelHidden: import("@angular/core").InputSignal<boolean>;
   /** Native `name` attribute placed on the inner `<select>` (e2e `[name=x]` selectors, autofill). None when empty. */
   readonly inputName: import("@angular/core").InputSignal<string>;
   readonly placeholder: import("@angular/core").InputSignal<string>;
@@ -1146,7 +1153,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   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>;
@@ -1175,6 +1182,13 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   validate(control: AbstractControl): ValidationErrors | null;
   registerOnValidatorChange(fn: () => void): void;
   protected readonly _selectId: string;
+  private readonly _hostEl;
+  /**
+   * Library source 2026-11-04, not yet published. Puts the keyboard focus on the inner native `<select>` (`ref.focus()` via `viewChild`).
+   * Same options as the DOM method (`{ preventScroll: true }`). Safe at any time: before the view exists, or on a disabled field, it does
+   * nothing and never throws.
+   */
+  focus(options?: FocusOptions): void;
   private _onChange;
   private _warned;
   /** The comparison form of a key: in number mode a numeric text ('21.0', ' 21 ') becomes the canonical number text ('21'). */
@@ -1203,6 +1217,11 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
       "required": false;
       "isSignal": true;
     };
+    "labelHidden": {
+      "alias": "labelHidden";
+      "required": false;
+      "isSignal": true;
+    };
     "inputName": {
       "alias": "inputName";
       "required": false;
@@ -1602,6 +1621,15 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
    */
   readonly bulkPanelClick: import("@angular/core").OutputEmitterRef<BulkPanelEvent<T>>;
   /** Emitted after a built-in single-row delete completes successfully. */
+  /**
+   * Emitted after every rows request that completes (a request superseded by a newer one emits nothing; first load, page, sort, search, tab, filter, `refresh()` ...): `{ ok: true, total }` when the rows
+   * arrived (`total` = all matching rows), `{ ok: false, total }` when the request failed (the rows on screen are kept, `total` is the last known).
+   * Lets a host refresh something that must follow the table (e.g. a failure banner above it).
+   */
+  readonly loaded: import("@angular/core").OutputEmitterRef<{
+    ok: boolean;
+    total: number;
+  }>;
   readonly rowDeleted: import("@angular/core").OutputEmitterRef<T>;
   /**
    * Optional drag-and-drop ordering of the rows. Off by default; when `true` (and the user has full access) every row gets a grip
@@ -2193,6 +2221,7 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
     "tabChange": "tabChange";
     "bulkAction": "bulkAction";
     "bulkPanelClick": "bulkPanelClick";
+    "loaded": "loaded";
     "rowDeleted": "rowDeleted";
     "rowReorder": "rowReorder";
   }, never, never, true, never>;
@@ -2228,7 +2257,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<"warning" | "danger" | "primary">;
+  readonly primaryVariant: import("@angular/core").InputSignal<"primary" | "danger" | "warning">;
   readonly primaryLoading: import("@angular/core").InputSignal<boolean>;
   readonly primaryDisabled: import("@angular/core").InputSignal<boolean>;
   /** `data-testid` of the Cancel button; none when empty (default). */
@@ -2243,6 +2272,15 @@ export declare class SidePanelComponent implements OnDestroy {
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly primaryClick: import("@angular/core").OutputEmitterRef<void>;
   protected readonly titleId: string;
+  /**
+   * (library source 2026-11-04, not yet published) True while the scrollable body (`.sp-body`) is taller than the space it has.
+   * Only then the body is a keyboard Tab stop (`tabindex="0"`, `role="group"`, named by the panel title via `aria-labelledby`)
+   * so keyboard users can scroll it with the arrow keys / Space / PageUp / PageDown. While the content fits, the body carries
+   * none of those attributes (unchanged markup). Kept current by a ResizeObserver + MutationObserver on the body.
+   */
+  readonly bodyScrollable: import("@angular/core").WritableSignal<boolean>;
+  private readonly _bodyRef;
+  private _bodyObservers;
   private readonly _el;
   private readonly _doc;
   private readonly _overlays;
@@ -2252,6 +2290,14 @@ export declare class SidePanelComponent implements OnDestroy {
   private _stopIframeKeys;
   private readonly _interaction;
   constructor();
+  /**
+   * Re-measures the body now (`scrollHeight` vs `clientHeight`, 1px tolerance for sub-pixel rounding) and updates
+   * `bodyScrollable`. Called by the observers; also usable by a host that changes the body content in a way no observer sees.
+   */
+  refreshScrollable(): void;
+  /** Starts observing the (new) body element, or stops observing when the body is gone (panel closed). */
+  private _watchBody;
+  private _stopWatchingBody;
   onKeydown(event: KeyboardEvent): void;
   /** A focus-guard sentinel received focus (Tab left the panel's tab order, e.g. out of an iframe): send it back inside. */
   protected onGuardFocus(which: 'start' | 'end', event?: FocusEvent): void;
@@ -2513,6 +2559,14 @@ export interface ToastOptions {
   key?: string;
   /** Called with the `id` of a button when it is used (before the toast closes). */
   onAction?: (actionId: string) => void;
+  /**
+   * (library source 2026-11-04, not yet published) Default `false` (unchanged). `true` = if a toast with the SAME message and the SAME type is on screen right
+   * now, show this one as a fresh toast of its own: the toast element is re-created (so a screen reader announces the text again and the
+   * entry animation replays), the dismiss timer restarts with this call's duration, and the title / buttons / countdown of this call replace
+   * the old ones. Nothing is queued. If the message on screen is different (or nothing is showing) `repeat` changes nothing. Without
+   * `repeat`, an identical message arriving while it is on screen only restarts the timer silently: it is not announced again.
+   */
+  repeat?: boolean;
 }
 /** What is known about the toast on screen beyond its message and type; `null` for a plain toast. */
 export interface ToastDetails {
@@ -2539,6 +2593,11 @@ export declare class ToastService implements OnDestroy {
   readonly persistentLiveRegion: import("@angular/core").WritableSignal<boolean>;
   /** The title, buttons, countdown flag, key and callback of the toast on screen; `null` for a plain toast or none. */
   readonly details: import("@angular/core").WritableSignal<ToastDetails | null>;
+  /**
+   * (library source 2026-11-04, not yet published) Counts the `repeat: true` re-presentations of an identical message. The outlet re-creates the toast
+   * element whenever it changes, which is what makes a screen reader announce the same text again. Starts at 0 and only grows.
+   */
+  readonly repeatTick: import("@angular/core").WritableSignal<number>;
   /** How many toasts are waiting behind the one on screen (queue mode). */
   readonly queuedCount: import("@angular/core").WritableSignal<number>;
   /** Default for `ToastOptions.queue`: new toasts wait for the one on screen instead of replacing it. Set with `provideForgerouteToast({ queue: true })` or `<ui-toast [queue]="true" />`. */
@@ -2630,6 +2689,8 @@ export declare class ToastComponent {
   readonly queueLabel: import("@angular/core").InputSignal<string>;
   /** A toast button was used (also after its own `onAction`). */
   readonly action: import("@angular/core").OutputEmitterRef<ToastActionEvent>;
+  /** One entry that changes with every `repeat: true` toast: the @for re-creates the toast element, so identical text is announced again. */
+  protected readonly repeatKeys: import("@angular/core").Signal<number[]>;
   protected readonly isRich: import("@angular/core").Signal<boolean>;
   protected readonly countdownPct: import("@angular/core").Signal<number>;
   protected readonly countdownText: import("@angular/core").Signal<string>;
@@ -2642,6 +2703,7 @@ export declare class ToastComponent {
    */
   private readonly _adoptedMessage;
   protected readonly adopted: import("@angular/core").Signal<boolean>;
+  private _lastRepeatTick;
   private _wasWaiting;
   private _hover;
   private _focus;
@@ -3154,7 +3216,7 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    * clicking it still toggles the box - e.g. a product name that is both the heading of its card and the label of its checkbox.
    * Default null: plain label text, exactly as before. Single mode only.
    */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 5 | 3 | 4 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3378,6 +3440,8 @@ export declare class ToggleComponent implements ControlValueAccessor {
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** Id of another element that describes the switch (e.g. a description rendered elsewhere); announced after the hint. Absent when empty. */
   readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
+  /** `data-testid` put on the inner `<input role="switch">` (the host keeps its own attributes), so e2e can target the switch directly. Absent when empty. */
+  readonly inputTestId: import("@angular/core").InputSignal<string>;
   /** Whether the switch is on. Two-way: `[(checked)]`. */
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /** Public so a host template can bind `[disabled]` (a protected input fails strict template type-checking, TS2445). */
@@ -3420,6 +3484,11 @@ export declare class ToggleComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "inputTestId": {
+      "alias": "inputTestId";
+      "required": false;
+      "isSignal": true;
+    };
     "checked": {
       "alias": "checked";
       "required": false;
@@ -3869,6 +3938,11 @@ export interface RadioOption {
   disabled?: boolean;
   /** `data-testid` of this option's native radio input (e.g. for end-to-end tests); none when omitted. */
   testId?: string;
+  /**
+   * Library source 2026-11-04, not yet published. Icon drawn in front of the option's label: a `<ui-icon>` key (`cup`, `wrench`, ...) or a raw SVG
+   * path. Decorative (`aria-hidden`); none when omitted.
+   */
+  icon?: string;
 }
 /**
  * Group of native radio buttons inside a `<fieldset>` (+ `<legend>` = `label`), a ControlValueAccessor (string value, `''`
@@ -4065,7 +4139,7 @@ export declare class PhoneNumberPickerComponent {
   protected readonly modeCtl: FormControl<string>;
   protected readonly zipCtl: FormControl<string>;
   protected readonly areaCtl: FormControl<string>;
-  protected readonly step: import("@angular/core").WritableSignal<1 | 2 | 3>;
+  protected readonly step: import("@angular/core").WritableSignal<2 | 1 | 3>;
   protected readonly mode: import("@angular/core").WritableSignal<PhoneNumberSearchMode>;
   private readonly _zip;
   private readonly _area;
@@ -4181,7 +4255,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<"link" | "icon" | "warning" | "danger" | "primary" | "secondary" | "ghost" | "ghost-start" | "tab" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"link" | "primary" | "secondary" | "danger" | "warning" | "icon" | "ghost" | "ghost-start" | "tab" | "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' }`). */
@@ -4202,7 +4276,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. */
@@ -4227,7 +4301,7 @@ export declare class ButtonComponent {
   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<"button" | "reset" | "submit">;
+  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4236,6 +4310,14 @@ export declare class ButtonComponent {
   readonly ariaPressed: import("@angular/core").InputSignal<boolean | undefined>;
   /** Id of the element that describes this button (an error or hint rendered next to it), e.g. `<ui-error errorId="x">`. Absent when empty. */
   readonly ariaDescribedBy: import("@angular/core").InputSignal<string | undefined>;
+  private readonly _hostEl;
+  /**
+   * Library source 2026-11-04, not yet published. Puts the keyboard focus on the inner native control (the `<button>`, or the `<a>` of a
+   * `routerLink` / `href` button): `buttonRef.focus()` via `viewChild(ButtonComponent)`. Same options as the DOM method (`{ preventScroll: true }`).
+   * Safe at any time: before the view exists, or while the button is `disabled` / `loading` (a disabled `<button>` cannot take focus; the
+   * disabled-link `<span>` is not focusable), it does nothing and never throws.
+   */
+  focus(options?: FocusOptions): void;
   constructor();
   _footerLeft?: string;
   _footerRight?: string;
@@ -4446,11 +4528,26 @@ export declare class PillTabsComponent {
   /** 'vertical' stacks the tabs in a column (Up/Down arrows move between them, `aria-orientation="vertical"`). Default 'horizontal' = unchanged. */
   readonly orientation: import("@angular/core").InputSignal<"vertical" | "horizontal">;
   protected readonly vertical: () => boolean;
+  /**
+   * (library source 2026-11-04, not yet published) Associate the tabs with their panels: every tab gets
+   * `aria-controls="<name>-panel-<key>"`, the id a `uiTabPanel` directive gives its element (see `PillTabPanelDirective`).
+   * Default false = no `aria-controls` at all (unchanged markup). Turn it on only when every tab has a `uiTabPanel`
+   * element in the page, otherwise `aria-controls` would point at a missing id. The tab ids themselves are unchanged
+   * and always `<name>-<key>` (see `pillTabId`).
+   *
+   * Id collision: a tab whose KEY is `panel-x` has the id `<name>-panel-x`, which is also the panel id for key `x`. Avoid keys that start with
+   * `panel-` when this is on; in development mode a `console.warn` names such a key.
+   */
+  readonly controlsPanels: import("@angular/core").InputSignal<boolean>;
   readonly tabChange: import("@angular/core").OutputEmitterRef<string>;
   /** True while pills are hidden past the start / end edge of the scroll area (drives the fade hints). */
   protected readonly canScrollStart: import("@angular/core").WritableSignal<boolean>;
   protected readonly canScrollEnd: import("@angular/core").WritableSignal<boolean>;
   constructor();
+  /** Id of the tab button for [key] (`<name>-<key>`, the exported `pillTabId`). */
+  protected tabId(key: string): string;
+  /** Id of the panel [key] controls (`<name>-panel-<key>`, the exported `pillTabPanelId`). */
+  protected panelId(key: string): string;
   protected updateOverflow(): void;
   select(key: string): void;
   /** Roving tabindex — the selected tab (or the first enabled one when none is selected) is tabbable. */
@@ -4488,10 +4585,80 @@ export declare class PillTabsComponent {
       "required": false;
       "isSignal": true;
     };
+    "controlsPanels": {
+      "alias": "controlsPanels";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "tabChange": "tabChange";
   }, never, never, true, never>;
 }
+/** Id of the tab button `ui-pill-tabs` renders for [key] when its `name` input is [name] (always `<name>-<key>`). */
+export declare function pillTabId(name: string, key: string): string;
+/** Id a `uiTabPanel` element gets, and the id every tab's `aria-controls` points at when `controlsPanels` is on: `<name>-panel-<key>`. */
+export declare function pillTabPanelId(name: string, key: string): string;
+/**
+ * (library source 2026-11-04, not yet published) The panel that belongs to one `ui-pill-tabs` tab: a correct
+ * WAI-ARIA tablist / tabpanel association with the smallest possible markup.
+ *
+ * ```html
+ * <ui-pill-tabs name="billing" [tabs]="tabs" [activeKey]="tab()" [controlsPanels]="true" (tabChange)="tab.set($event)" />
+ * <section uiTabPanel="invoices" tabsName="billing" [activeKey]="tab()"> ... </section>
+ * <section uiTabPanel="payments" tabsName="billing" [activeKey]="tab()"> ... </section>
+ * ```
+ *
+ * The host element gets `role="tabpanel"`, `id="<tabsName>-panel-<key>"` and `aria-labelledby="<tabsName>-<key>"` (the tab button).
+ * - `uiTabPanel`  the key of the tab this panel belongs to (required, the same `key` as in the tabs list).
+ * - `tabsName`    the `name` input of the `ui-pill-tabs` (required; give the tabs a fixed `name` so the ids are predictable).
+ * - `activeKey`   the tabs' active key. When given (not null), the panel gets the `hidden` attribute while another tab is active
+ *                 (the panels stay in the DOM, so their state survives a tab change). Leave it unset when the page renders only the
+ *                 active panel itself (`@if`), then no `hidden` attribute is ever set.
+ * - `tabbable`    default false. true adds `tabindex="0"` so a panel without any focusable content can be reached by keyboard
+ *                 (WAI-ARIA tabs pattern).
+ *
+ * Id collision: ids are plain strings, so a tab whose KEY is `panel-x` has the tab id `<name>-panel-x`, which is the same string as the panel id of the
+ * key `x`. Do not use keys that start with `panel-` together with `controlsPanels` (`ui-pill-tabs` logs a `console.warn` for such a key in development mode).
+ *
+ * Note: the `hidden` attribute loses against an author rule such as `display: flex` on the same element; put such layout on an
+ * inner element, or style `[hidden] { display: none }`.
+ */
+export declare class PillTabPanelDirective {
+  /** Key of the tab this panel belongs to. */
+  readonly key: import("@angular/core").InputSignal<string>;
+  /** `name` of the `ui-pill-tabs` this panel belongs to. */
+  readonly tabsName: import("@angular/core").InputSignal<string>;
+  /** Active key of the tabs; the panel is `hidden` while it is another key. null (default) = never hidden by this directive. */
+  readonly activeKey: import("@angular/core").InputSignal<string | null>;
+  /** Makes the panel itself a Tab stop (for panels with no focusable content). Default false. */
+  readonly tabbable: import("@angular/core").InputSignal<boolean>;
+  protected panelId(): string;
+  protected tabId(): string;
+  protected isHidden(): boolean;
+  static ɵfac: i0.ɵɵFactoryDeclaration<PillTabPanelDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<PillTabPanelDirective, "[uiTabPanel]", never, {
+    "key": {
+      "alias": "uiTabPanel";
+      "required": true;
+      "isSignal": true;
+    };
+    "tabsName": {
+      "alias": "tabsName";
+      "required": true;
+      "isSignal": true;
+    };
+    "activeKey": {
+      "alias": "activeKey";
+      "required": false;
+      "isSignal": true;
+    };
+    "tabbable": {
+      "alias": "tabbable";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 export interface ContactLookup {
   id: string;
   name: string;
@@ -4678,7 +4845,7 @@ export declare class BulkMessagePanelComponent {
   readonly sending: import("@angular/core").InputSignal<boolean>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly send: import("@angular/core").OutputEmitterRef<BulkMessageSendEvent>;
-  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
+  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
   private readonly _subject;
   private readonly _body;
   get subject(): string;
@@ -4733,7 +4900,7 @@ export declare class ImportSourceGridComponent {
   /** The `value` of the picked source (highlighted). `tile` only: the `card` appearance does not keep a selection. */
   readonly selected: import("@angular/core").InputSignal<string>;
   /** `tile`: the compact buttons of the import window. `card`: one `ui-detail-card` per source with its own select button (used on a page). */
-  readonly appearance: import("@angular/core").InputSignal<"card" | "tile">;
+  readonly appearance: import("@angular/core").InputSignal<"tile" | "card">;
   /** `card`: disables every card's button (for example while the page is saving). */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** `card`: the text of each card's button. */
@@ -4930,7 +5097,7 @@ export declare class BankAccountFormComponent implements UiFieldValidity {
   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.">;
+  readonly errorMessage: import("@angular/core").Signal<"" | "Routing number must be 9 digits." | "Account number must be at least 4 digits." | "Account numbers do not match." | "Account holder name is required." | "Routing number is required." | "Account number is required." | "Confirm account number is required." | "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`). */
@@ -4999,7 +5166,11 @@ export interface ActiveConfirm {
   /** Optional bullet list rendered under the message (plain text). */
   details: string[];
 }
-export declare class ConfirmService {
+export declare class ConfirmService implements OnDestroy {
+  private readonly _appRef;
+  private readonly _envInjector;
+  private readonly _doc;
+  private readonly _browser;
   private _open;
   private _active;
   private _resolve;
@@ -5013,8 +5184,24 @@ export declare class ConfirmService {
    */
   private readonly _outlets;
   readonly primaryOutlet: import("@angular/core").Signal<object>;
+  /**
+   * The outlet this service created itself because `confirm()` was called while no `<ui-confirm-outlet>` existed (a page without a
+   * `ui-data-table` and without a hand-placed outlet). Null while a template-placed outlet exists, before the first such confirm, and
+   * on the server. Library source 2026-11-04, not yet published.
+   */
+  private _auto;
+  /** True when a template-placed outlet appeared while the auto outlet's dialog was open: the auto outlet is removed once that dialog closes. */
+  private _retireAutoOnDismiss;
   registerOutlet(outlet: object): void;
   unregisterOutlet(outlet: object): void;
+  ngOnDestroy(): void;
+  /**
+   * Makes sure some outlet exists to render the dialog. Template-placed outlets (data-table, app-shell, a hand-placed
+   * `<ui-confirm-outlet />`) are used as they are; only when there is none is one outlet created and attached to `document.body`
+   * (reused for later confirms, removed when the service is destroyed or a template-placed outlet appears). Does nothing without a DOM (SSR).
+   */
+  private _ensureOutlet;
+  private _destroyAuto;
   confirm(config: {
     title: string;
     message: string;
@@ -5069,12 +5256,19 @@ export declare class EmptyStateComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class ErrorStateComponent {
+  /** Optional bold heading line above the message (e.g. "Unable to load application"). Empty = no heading. */
+  readonly title: import("@angular/core").InputSignal<string>;
   readonly message: import("@angular/core").InputSignal<string>;
   readonly retryLabel: import("@angular/core").InputSignal<string>;
   readonly retrying: import("@angular/core").InputSignal<boolean>;
   readonly retry: import("@angular/core").OutputEmitterRef<void>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ErrorStateComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ErrorStateComponent, "ui-error-state", never, {
+    "title": {
+      "alias": "title";
+      "required": false;
+      "isSignal": true;
+    };
     "message": {
       "alias": "message";
       "required": false;
@@ -5161,6 +5355,12 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * Meant for a short mark of 1-3 characters.
    */
   readonly prefix: import("@angular/core").InputSignal<string>;
+  /**
+   * Library source 2026-11-04, not yet published. An optional icon at the left inside the field: a `<ui-icon>` key, e.g. `leadingIcon="search"` for a search field.
+   * Decorative (`aria-hidden`, no pointer events, not part of the value), so give the field a `label` or `ariaLabel`. The input's left padding grows to
+   * make room (36px; with a `prefix` the mark moves right of the icon). An unknown key or empty (default) draws nothing and changes nothing.
+   */
+  readonly leadingIcon: import("@angular/core").InputSignal<string>;
   /**
    * `type="password"` only: puts an eye button inside the field, at its right end, that shows / hides the typed text (the eye with a slash
    * means "hidden again"). Per field, starts hidden; the button is a toggle (`aria-pressed`) named "Show password". Ignored for other types.
@@ -5173,7 +5373,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "email" | "text" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "password" | "tel" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -5182,7 +5382,7 @@ 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" | "email" | "search" | "text" | "numeric" | "tel" | "url" | "decimal">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "email" | "search" | "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. */
@@ -5240,15 +5440,21 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
   private readonly _reveal;
-  /** Left padding that makes room for the prefix (its width in `ch` plus the field's own 12px and a 6px gap); none without a prefix. */
+  /** Path of the leading icon, or null when `leadingIcon` is empty or not a known icon key. */
+  protected readonly _leadingD: import("@angular/core").Signal<string | null>;
+  /**
+   * Left padding that makes room for the prefix (its width in `ch` plus the field's own 12px and a 6px gap) and/or the leading icon (a 16px icon
+   * plus an 8px gap, so 36px from the edge); none without either.
+   */
   protected readonly _prefixPadding: import("@angular/core").Signal<string | null>;
+  private readonly _fieldEl;
   /** True when the control value is a number: `valueType="number"` on a `type="number"` field. */
   private readonly _numeric;
   /** The native `step` attribute: only for `type="number"` and only for a finite number above 0; otherwise none (the browser's step of 1). */
   protected readonly _stepAttr: import("@angular/core").Signal<string | null>;
   protected readonly _revealable: import("@angular/core").Signal<boolean>;
   protected readonly _shown: import("@angular/core").WritableSignal<boolean>;
-  protected readonly _inputType: import("@angular/core").Signal<"number" | "email" | "text" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "password" | "tel" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -5267,6 +5473,12 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly _activeError: import("@angular/core").Signal<string>;
   protected readonly _inputId: string;
   private static readonly _EMAIL_RE;
+  /**
+   * Library source 2026-11-04, not yet published. Puts the keyboard focus on the inner `<input>` (e.g. after a panel opens or a search is cleared):
+   * `fieldRef.focus()` via `viewChild(TextInputComponent)`. Same options as the DOM method (`{ preventScroll: true }`). Safe at any time: before the
+   * view exists, or on a disabled field, it does nothing and never throws.
+   */
+  focus(options?: FocusOptions): void;
   private _onChange;
   private _onTouched;
   private _onValidatorChange;
@@ -5327,6 +5539,11 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
       "required": false;
       "isSignal": true;
     };
+    "leadingIcon": {
+      "alias": "leadingIcon";
+      "required": false;
+      "isSignal": true;
+    };
     "revealable": {
       "alias": "revealable";
       "required": false;
@@ -5584,6 +5801,13 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   validate(control: AbstractControl): ValidationErrors | null;
   registerOnValidatorChange(fn: () => void): void;
   protected readonly _inputId: string;
+  private readonly _hostEl;
+  /**
+   * Library source 2026-11-04, not yet published. Puts the keyboard focus on the inner native `<textarea>` (`ref.focus()` via `viewChild`).
+   * Same options as the DOM method (`{ preventScroll: true }`). Safe at any time: before the view exists, or on a disabled field, it does
+   * nothing and never throws.
+   */
+  focus(options?: FocusOptions): void;
   private _onChange;
   private _onTouched;
   writeValue(val: string | null): void;
@@ -7056,7 +7280,7 @@ export declare class FormSectionComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class FormRowComponent {
-  readonly cols: import("@angular/core").InputSignal<1 | 2 | 3 | 4>;
+  readonly cols: import("@angular/core").InputSignal<2 | 1 | 3 | 4>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -7112,6 +7336,16 @@ export declare class FormColSpanDirective {
  *                 badge="Archived" badgeVariant="gray" [alwaysShowBadge]="true">
  *     <ui-button list-item-action variant="icon" ariaLabel="Remove" (click)="remove(d)">…</ui-button>
  *   </ui-list-item>
+ *
+ * Library source 2026-11-04, not yet published: `[disabled]` (aria-disabled, not focusable, never emits `select`, non-colour cue), `[busy]`
+ * (aria-busy, spinner, presses ignored) and a leading image slot, `<img list-item-image>` / `<ui-image list-item-image>`, rendered in front of
+ * the text and instead of the icon tile (clicks on it select a plain row; on a radio / checkbox row they do not, because the image sits outside
+ * the label). An interactive image (`<ui-image list-item-image [interactive]="true" (activate)=...>`) inside a plain pressable row: a click emits the
+ * image's `activate` AND selects the row (the click bubbles); Enter / Space on the image emit `activate` only (the row's key handler ignores keys
+ * whose target is not the row itself). Row-end actions stay in `list-item-action`.
+ *   <ui-list-item [title]="p.name" [details]="[p.price]" [disabled]="p.soldOut" [busy]="adding() === p.id" (select)="add(p)">
+ *     <ui-image list-item-image [src]="p.photo" [alt]="p.name" width="48px" height="48px" fit="cover" radius="md" />
+ *   </ui-list-item>
  */
 /** One secondary line under the title: plain text, or text with a small icon and a tone (`danger` red, `warning` amber). */
 export type ListItemDetail = string | {
@@ -7121,7 +7355,8 @@ export type ListItemDetail = string | {
 };
 /** Colour of the optional leading icon tile. */
 export type ListItemIconColor = 'slate' | 'amber' | 'red' | 'blue' | 'green' | 'purple' | 'teal' | 'orange';
-export declare class ListItemComponent {
+export declare class ListItemComponent implements AfterContentChecked {
+  private readonly host;
   /** Show a radio button, checkbox, or nothing on the left. */
   readonly leading: import("@angular/core").InputSignal<"none" | "radio" | "checkbox">;
   /** `name` attribute for the radio/checkbox (groups radios together). */
@@ -7148,7 +7383,24 @@ export declare class ListItemComponent {
    * Rows with `[interactive]="false"` always wrap (new in 2026-10-19, nothing to preserve).
    */
   readonly wrapText: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Library source 2026-11-04, not yet published. `true` = the row cannot be used right now: the native radio / checkbox is `disabled` (that carries
+   * the state for assistive tech), a plain pressable row (`role="button"`) gets `aria-disabled="true"` and loses its `tabindex` (not a tab stop). A row
+   * without a role (radio / checkbox row wrapper, non-interactive row) gets NO `aria-disabled` (it is not valid on a role-less div); it only
+   * gets the classes. Clicks, Enter and Space never emit `select`, and the row looks disabled without relying on colour alone (dimmed, muted
+   * surface, `not-allowed` cursor, a dashed outline on a bordered card). Projected row-end actions (`list-item-action`) are NOT disabled by this
+   * input; disable them yourself. Default `false` = unchanged.
+   */
+  readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Library source 2026-11-04, not yet published. `true` = the row is working on a request: `aria-busy="true"`, a small spinner (decorative)
+   * at the row end, and presses (click, Enter, Space, radio / checkbox change) are ignored: `select` never emits and a radio / checkbox keeps
+   * its state (the click is cancelled, so a sibling radio of the same `name` stays checked too; arrow keys on a busy radio are blocked).
+   * The row stays focusable. Default `false` = unchanged.
+   */
+  readonly busy: import("@angular/core").InputSignal<boolean>;
   get _borderedClass(): boolean;
+  get _disabledClass(): boolean;
   /** Primary label. */
   readonly title: import("@angular/core").InputSignal<string>;
   /** Badge shown next to the title — only visible when the item is checked, unless `alwaysShowBadge` is set. */
@@ -7169,6 +7421,21 @@ export declare class ListItemComponent {
   readonly select: import("@angular/core").OutputEmitterRef<void>;
   /** A plain interactive row (no radio/checkbox) is itself clickable: click, Enter or Space emit `select`. */
   protected readonly pressable: () => boolean;
+  /**
+   * True while the leading image slot (`<img list-item-image>` / any element with the `list-item-image` attribute) holds content.
+   * The slot is projected, so this is read from the DOM after every content check; the icon tile is not rendered while it is true.
+   */
+  protected readonly hasImage: import("@angular/core").WritableSignal<boolean>;
+  ngAfterContentChecked(): void;
+  /**
+   * Radio / checkbox click while busy or disabled: cancelled, so the browser restores the checkedness of the clicked input AND of the other radios of
+   * the same `name` group (clicking or arrowing onto this radio would otherwise uncheck the sibling that the model still holds as checked).
+   */
+  protected onInputClick(e: Event): void;
+  /** Arrow keys on a busy / disabled radio would move the selection to a sibling of the group: blocked. (Arriving at it from a sibling is stopped by `onInputClick`.) */
+  protected onInputKey(e: KeyboardEvent): void;
+  /** Radio / checkbox change: never while disabled (the input is disabled anyway); ignored while busy. Safety net after `onInputClick`: the input is put back to `checked`. */
+  protected onInputChange(e: Event): void;
   protected onRowClick(e: Event): void;
   protected onRowKey(e: Event): void;
   protected readonly visibleDetails: () => {
@@ -7223,6 +7490,16 @@ export declare class ListItemComponent {
       "required": false;
       "isSignal": true;
     };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "busy": {
+      "alias": "busy";
+      "required": false;
+      "isSignal": true;
+    };
     "title": {
       "alias": "title";
       "required": false;
@@ -7255,7 +7532,7 @@ export declare class ListItemComponent {
     };
   }, {
     "select": "select";
-  }, never, ["[list-item-action], [li-action]"], true, never>;
+  }, never, ["[list-item-image]", "[list-item-action], [li-action]"], true, never>;
 }
 /** Colour of the priority dot (`high` red, `medium` amber, `low` grey, `blue`, `green`); `none` = no dot. */
 export type CardListIndicator = 'high' | 'medium' | 'low' | 'blue' | 'green' | 'none';
@@ -7650,6 +7927,12 @@ export declare class ListComponent<T = unknown> {
   readonly items: import("@angular/core").InputSignal<readonly T[]>;
   /** `false` (default) renders a `<ul>`; `true` renders an `<ol>` with native numbering (no numbers in the grid layout). */
   readonly ordered: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Library source 2026-11-04, not yet published. `true` = the `<ul>` shows a visible bullet (disc) before every row, for plain text lines such as a
+   * "what will happen" list: `<ui-list [items]="lines" [bulleted]="true" ariaLabel="What will happen" />` (string items render as their text, no template needed).
+   * Still a real `<ul>` with `<li>` rows. Ignored with `[ordered]="true"` (which already has numbers) and in the grid layout. Default `false` = no markers, as before.
+   */
+  readonly bulleted: import("@angular/core").InputSignal<boolean>;
   /** 'list' = one column; 'grid' = wrapping columns of at least `gridMin` px (still a real `<ul>`). */
   readonly layout: import("@angular/core").InputSignal<"list" | "grid">;
   /** Minimum column width in px of the grid layout. */
@@ -7756,6 +8039,11 @@ export declare class ListComponent<T = unknown> {
       "required": false;
       "isSignal": true;
     };
+    "bulleted": {
+      "alias": "bulleted";
+      "required": false;
+      "isSignal": true;
+    };
     "layout": {
       "alias": "layout";
       "required": false;
@@ -8207,9 +8495,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<"8px" | "12px" | "6px">;
+  protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "12px" | "6px">;
+  protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "12px" | "6px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ChipGroupComponent, "ui-chip-group", never, {
     "gap": {
@@ -8585,10 +8873,15 @@ export declare class AlertComponent {
     "dismissed": "dismissed";
   }, never, ["*"], true, never>;
 }
+/**
+ * Every key `<ui-icon>` draws by itself (the data-table action keys such as `view` / `edit` / `call` are accepted too, see `builtInActionIcon`).
+ * Each resolves with `iconPath(key)`. Includes `search`, `cup` (food / drink) and `wrench` (rental / tools), library source 2026-11-04, not yet published.
+ */
+export declare const ICON_NAMES: readonly string[];
 /** The SVG path (24×24 stroke icon) for an icon key, or undefined when the key is unknown. */
 export declare function iconPath(name: string): string | undefined;
 /** Keys with an icon of their own (the data-table action keys are accepted too — see `builtInActionIcon`). */
-export type IconName = 'add' | 'close' | 'check' | 'upload' | 'image' | 'chevron-up' | 'chevron-down' | 'arrow-left' | 'bell' | 'print' | 'lock' | 'shield' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'document' | 'grip' | 'card' | 'bank' | 'view' | 'view-off' | 'edit' | 'delete' | 'download' | 'duplicate' | 'archive' | 'restore' | 'share' | 'email' | 'message' | 'call' | 'refund' | 'chevron-right' | 'link' | 'save' | 'chart' | 'clipboard' | 'unlink' | 'send' | 'refresh';
+export type IconName = 'add' | 'close' | 'check' | 'upload' | 'image' | 'chevron-up' | 'chevron-down' | 'arrow-left' | 'bell' | 'print' | 'lock' | 'shield' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'document' | 'grip' | 'card' | 'bank' | 'view' | 'view-off' | 'edit' | 'delete' | 'download' | 'duplicate' | 'archive' | 'restore' | 'share' | 'email' | 'message' | 'call' | 'refund' | 'chevron-right' | 'link' | 'save' | 'chart' | 'clipboard' | 'unlink' | 'send' | 'refresh' | 'search' | 'cup' | 'wrench';
 /**
  * A clickable icon. The host passes a key (`name="delete"`) and the library draws that icon; clicking it emits
  * `iconClick`, and the host does the actual work (delete the row, open a panel, …).
@@ -8615,7 +8908,7 @@ export declare class IconComponent {
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** Icon size in px. */
   readonly size: import("@angular/core").InputSignal<number>;
-  readonly variant: import("@angular/core").InputSignal<"default" | "danger">;
+  readonly variant: import("@angular/core").InputSignal<"danger" | "default">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** The host is running the request this icon started: a spinner replaces the picture and the button is disabled (no click) until it is false again. */
   readonly loading: import("@angular/core").InputSignal<boolean>;
@@ -8727,7 +9020,7 @@ export declare class TimelineComponent {
   /** Any CSS length (e.g. `600px`). When set, the list scrolls inside a keyboard-focusable region of at most this height. Empty = no wrapper. */
   readonly maxHeight: import("@angular/core").InputSignal<string>;
   /** `below` (default): the time is under the title / description. `end`: the time sits right-aligned on the title row. */
-  readonly timePosition: import("@angular/core").InputSignal<"below" | "end">;
+  readonly timePosition: import("@angular/core").InputSignal<"end" | "below">;
   /**
    * Group the items under a heading per calendar day of `dateTime` ("Today", "Yesterday", "Oct 3", "Oct 3, 2025"). Default false = no headings,
    * DOM unchanged. The given order is kept: consecutive items of one day share a heading, the same day appearing again later starts a new group.
@@ -9250,6 +9543,14 @@ export type ImageAlign = 'start' | 'center' | 'end';
  *  - `placeholder` (default true): a neutral icon in the same box when there is no `src` or it fails to load. false renders nothing then.
  *  - `priority`: above-the-fold image - loads eagerly with high fetch priority. Otherwise `loading="lazy"` and async decoding.
  *  - Outputs `loaded` and `failed`. A new `src` (or a changed `retryKey`) gets a fresh chance to load.
+ *  - Library source 2026-11-04, not yet published: `[interactive]="true"` makes the image a button (e.g. a product photo that opens a preview):
+ *    the host gets `role="button"`, `tabindex="0"`, a focus ring, and click, Enter or Space emit `(activate)`. Its accessible name is the `alt`
+ *    text (also set as `aria-label`), so an interactive image NEEDS a non-empty `alt` (a decorative `alt=""` image would be an unnamed button). Not
+ *    interactive (default) = no role, no tabindex, no key handling, no output: exactly as before.
+ *    Inside a clickable parent (e.g. a pressable `ui-list-item` row via the `list-item-image` slot) the click bubbles: `activate` fires AND the parent's
+ *    own click handling runs (the row is selected). Enter / Space fire `activate` only; the parent's key handlers that require their own element as the
+ *    target (`ui-list-item`) ignore them.
+ *      <ui-image [src]="p.photo" [alt]="'Open photo of ' + p.name" [interactive]="true" (activate)="preview(p)" />
  */
 export declare class ImageComponent {
   /** Image URL (or data URL). Blank shows the placeholder. */
@@ -9276,8 +9577,15 @@ export declare class ImageComponent {
   readonly priority: import("@angular/core").InputSignal<boolean>;
   /** Bump to retry a failed image with the same `src`. */
   readonly retryKey: import("@angular/core").InputSignal<unknown>;
+  /**
+   * Library source 2026-11-04, not yet published. `true` = the image is a button: `role="button"`, `tabindex="0"`, `aria-label` from `alt`, and click /
+   * Enter / Space emit `activate`. Needs a non-empty `alt` (it is the button's name). Default `false` = a plain image, nothing changes.
+   */
+  readonly interactive: import("@angular/core").InputSignal<boolean>;
   readonly loaded: import("@angular/core").OutputEmitterRef<void>;
   readonly failed: import("@angular/core").OutputEmitterRef<void>;
+  /** Fires (once per press) when an `interactive` image is clicked, or Enter / Space is pressed on it. Never fires when not interactive. */
+  readonly activate: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _failed: import("@angular/core").WritableSignal<boolean>;
   protected readonly _url: import("@angular/core").Signal<string | null>;
   protected readonly radiusCss: import("@angular/core").Signal<string>;
@@ -9289,6 +9597,8 @@ export declare class ImageComponent {
   protected readonly isBlock: import("@angular/core").Signal<boolean>;
   constructor();
   protected _onError(): void;
+  protected onActivate(): void;
+  protected onKey(event: Event): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<ImageComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ImageComponent, "ui-image", never, {
     "src": {
@@ -9366,9 +9676,15 @@ export declare class ImageComponent {
       "required": false;
       "isSignal": true;
     };
+    "interactive": {
+      "alias": "interactive";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "loaded": "loaded";
     "failed": "failed";
+    "activate": "activate";
   }, never, never, true, never>;
 }
 /** One picture of a `ui-image-gallery`. */
@@ -9587,6 +9903,17 @@ export declare class KpiCardComponent {
   readonly highlight: import("@angular/core").InputSignal<boolean>;
   readonly clickable: import("@angular/core").InputSignal<boolean>;
   readonly valueColor: import("@angular/core").InputSignal<KpiCardValueColor>;
+  /**
+   * (library source 2026-11-04, not yet published) While true the value (and the subtitle, when one is set) are replaced by grey
+   * placeholders and the card is `aria-busy="true"`; assistive tech reads the label followed by the `loadingLabel` text
+   * (visually hidden), never the stale value or subtitle. The card keeps its size: the value placeholder has the value line's box and the
+   * subtitle placeholder is the subtitle's own (transparent) text, so pass the subtitle you will show while loading to keep the height
+   * identical. The progress ring (when there is one) stays visible but is hidden from assistive tech (`aria-hidden="true"` on it) while loading, since its
+   * value belongs to the data that is being replaced. Default false = unchanged. Everything else (icon, ring, `kpi-footer` slot, `clickable`, colours) is unaffected.
+   */
+  readonly loading: import("@angular/core").InputSignal<boolean>;
+  /** What assistive tech hears instead of the value while `loading` (default 'Loading'). */
+  readonly loadingLabel: import("@angular/core").InputSignal<string>;
   /** Card background as any CSS colour (`#fef2f2`, `var(--surface)` …). Empty (default) = white. The text colours do not change, so use a light shade. */
   readonly background: import("@angular/core").InputSignal<string>;
   /** Completed amount shown as a `ui-progress-ring` beside the label. `null` (default) = no ring. */
@@ -9648,6 +9975,16 @@ export declare class KpiCardComponent {
       "required": false;
       "isSignal": true;
     };
+    "loading": {
+      "alias": "loading";
+      "required": false;
+      "isSignal": true;
+    };
+    "loadingLabel": {
+      "alias": "loadingLabel";
+      "required": false;
+      "isSignal": true;
+    };
     "background": {
       "alias": "background";
       "required": false;
@@ -9959,6 +10296,12 @@ export declare function humanReadableMessage(value: unknown): string | null;
 export declare class RadioComponent {
   readonly label: import("@angular/core").InputSignal<string>;
   readonly description: import("@angular/core").InputSignal<string>;
+  /**
+   * Library source 2026-11-04, not yet published. Optional icon drawn in front of the label: a `<ui-icon>` key (`cup`, `wrench`, `card`, ...) or a raw 24x24
+   * stroke SVG path (`M12 5v14 M5 12h14`). Decorative (`aria-hidden`), so the accessible name stays the label. Empty (default), an unknown key or
+   * text that is not a path = nothing is drawn and the DOM is unchanged.
+   */
+  readonly icon: import("@angular/core").InputSignal<string>;
   /** Accessible name when there is no visible `label`. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** `data-testid` of the native radio input; none when empty. */
@@ -9975,6 +10318,8 @@ export declare class RadioComponent {
   /** Public so a host template can bind `[disabled]` (a protected input fails strict template type-checking). */
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   protected readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /** Path of the icon: a known icon key, else the text itself when it looks like an SVG path (drawing commands and numbers only), else none. */
+  protected readonly _iconD: import("@angular/core").Signal<string | null>;
   /** Id of the visible label text. Optional: a host (e.g. `ui-radio-group`) can set it to point another element at the label with `aria-labelledby`; a unique id is generated when empty. */
   readonly labelId: import("@angular/core").InputSignal<string>;
   private readonly _generatedLabelId;
@@ -9999,6 +10344,11 @@ export declare class RadioComponent {
       "required": false;
       "isSignal": true;
     };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -10417,7 +10767,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<"warning" | "primary">;
+  readonly tone: import("@angular/core").InputSignal<"primary" | "warning">;
   /** 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"). */
@@ -10520,6 +10870,9 @@ export declare class PdfHotspotComponent {
  *  - `textColor`: the colour of the title, subtitle, chevron and body text (any CSS colour; default: the normal slate colours). Use it for light text on a dark `background`. Text you colour yourself inside the body keeps its own colour.
  *  - `<ng-container card-footer>` / `<div card-footer>`: a footer bar under the body (a pager, totals, a link). Hidden while empty or collapsed, 10px 18px padding,
  *    a light top line; `footerBackground` colours it (pair it with `headerBackground` to frame the card). In a `fill` card it is pinned to the bottom edge.
+ *  - `footerAlign="end"` (library source 2026-11-04, not yet published): turns the `[card-footer]` bar into a right-aligned action row (flex, `justify-content: flex-end`,
+ *    8px gap, wraps on a narrow card) for one or several buttons under the body, e.g. `<ui-button card-footer variant="secondary" size="sm">Open Resident</ui-button>`.
+ *    Default `'start'` = the footer is unchanged (block content, left-aligned). Hidden while empty or collapsed in both modes.
  *  - The body has built-in padding (16px 18px, matching the header's 18px side padding); there is no padding input.
  *  - `collapsible` (default true): a chevron toggle and a clickable header; `[(expanded)]` is two-way.
  *    Without a header, or with `collapsible` false, the body is always open.
@@ -10551,7 +10904,7 @@ export declare class DetailCardComponent {
   /** true (default) = the title is displayed in capitals (CSS only); false = shown as written. The text, aria-label and heading name are never changed. */
   readonly uppercaseTitle: import("@angular/core").InputSignal<boolean>;
   /** 1-6 makes the title a real heading for screen readers (role=heading, aria-level); null keeps it plain text. */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 1 | 5 | 3 | 4 | 6 | null>;
   /** Optional id for the title text; the card is then labelled by it. Without it the title is the card's aria-label. */
   readonly titleId: import("@angular/core").InputSignal<string>;
   /** Accessible name of the card when the header gives none (no header, or no title). A visible title wins; blank = no name. */
@@ -10564,6 +10917,8 @@ export declare class DetailCardComponent {
   readonly headerBackground: import("@angular/core").InputSignal<string>;
   /** Background colour of the footer bar (the `[card-footer]` slot) as any CSS colour. Empty = no colour of its own. */
   readonly footerBackground: import("@angular/core").InputSignal<string>;
+  /** Alignment of the `[card-footer]` content: `'start'` (default, unchanged) or `'end'` = a right-aligned action row with an 8px gap. */
+  readonly footerAlign: import("@angular/core").InputSignal<"end" | "start">;
   /** Text colour as any CSS colour (`#fff`, `var(--on-dark)` …). Empty = the default colours. Colours the title, subtitle, chevron and body text. */
   readonly textColor: import("@angular/core").InputSignal<string>;
   /** false = no header at all (no title, edit button, toggle or divider): the card is only the body, always open. */
@@ -10650,6 +11005,11 @@ export declare class DetailCardComponent {
       "required": false;
       "isSignal": true;
     };
+    "footerAlign": {
+      "alias": "footerAlign";
+      "required": false;
+      "isSignal": true;
+    };
     "textColor": {
       "alias": "textColor";
       "required": false;
@@ -13161,7 +13521,7 @@ export declare class SetupWizardComponent {
   protected customHintId(): string;
   protected readonly importBlocked: import("@angular/core").Signal<boolean>;
   /** The step's own two parts (`splitLayout`) show as two tabs, one card at a time; this is the open one (it starts on the app's part on every visit). */
-  protected readonly splitTab: import("@angular/core").WritableSignal<"main" | "extra">;
+  protected readonly splitTab: import("@angular/core").WritableSignal<"extra" | "main">;
   protected readonly splitTabs: import("@angular/core").Signal<{
     key: string;
     label: string;
@@ -15328,7 +15688,7 @@ export declare class PaymentSidePanelComponent {
   private readonly terminalAvailable;
   /** value -> label of every live method the rendered plugins contribute (the first plugin wins a duplicate value). */
   private readonly liveMethods;
-  protected readonly kind: import("@angular/core").Signal<"none" | "live" | "terminal" | "manual">;
+  protected readonly kind: import("@angular/core").Signal<"none" | "manual" | "live" | "terminal">;
   private kindOf;
   /** The method list as shown: record-only built-ins (a plugin takes over its own values), plugin extras, and only manual ones while a split is being built. */
   readonly methodList: import("@angular/core").Signal<PaymentMethodOption[]>;