@forgeroute/ui 0.4.72 → 0.4.74

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";
@@ -202,7 +202,9 @@ export interface ColumnDef {
     ariaLabel?: string;
   } | null;
   /** Key in item holding the tags array. Defaults to col.key.
-   *  Expected shape: { name: string; variant?: BadgeVariant }[] */
+   *  Expected shape: { name: string; variant?: BadgeVariant; color?: string }[]. `color` is a custom hex colour (`#rgb` / `#rrggbb`,
+   *  e.g. the colour a user picked for the tag): it becomes the chip background with dark or white text for contrast and wins over `variant`;
+   *  an invalid value is ignored. */
   tagsKey?: string;
   /**
    * `cellType: 'link'` — returns where the cell points for a row (`value` is `item[key]`), or null / undefined /
@@ -736,7 +738,17 @@ export declare class BadgeComponent {
    *  2. Fall back to auto-color based on the label string
    */
   readonly variant: import("@angular/core").InputSignal<BadgeVariant | null>;
+  /**
+   * A custom hex colour (`#rgb` or `#rrggbb`), e.g. the colour a user picked for a tag. It becomes the background and the text is
+   * dark or white, whichever reads better (WCAG contrast). It wins over `variant`; anything that is not a valid hex colour is
+   * ignored (the variant / automatic colour applies). Omit it and nothing changes.
+   */
+  readonly color: import("@angular/core").InputSignal<string | null>;
   protected readonly resolvedVariant: import("@angular/core").Signal<BadgeVariant>;
+  protected readonly customStyles: import("@angular/core").Signal<{
+    bg: string;
+    color: string;
+  } | null>;
   protected readonly styles: import("@angular/core").Signal<{
     bg: string;
     color: string;
@@ -753,6 +765,11 @@ export declare class BadgeComponent {
       "required": false;
       "isSignal": true;
     };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 /**
@@ -1133,6 +1150,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 +1170,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 +1199,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 +1234,11 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
       "required": false;
       "isSignal": true;
     };
+    "labelHidden": {
+      "alias": "labelHidden";
+      "required": false;
+      "isSignal": true;
+    };
     "inputName": {
       "alias": "inputName";
       "required": false;
@@ -1267,6 +1303,11 @@ export interface ImportFieldDef {
   key: string;
   label: string;
   required?: boolean;
+  /**
+   * An example of what the column should contain (e.g. `VACANT, OCCUPIED`, `500.00`, `YYYY-MM-DD`). It is shown under the field's
+   * label in the column-mapping step as "e.g. <example>" and linked to the column dropdown for screen readers. Omit it and nothing changes.
+   */
+  example?: string;
 }
 export interface ImportSource {
   value: string;
@@ -1387,6 +1428,10 @@ export declare class ImportExportComponent {
   private csvFile;
   private readCsvFile;
   private autoMap;
+  private static nextId;
+  private readonly idPrefix;
+  /** Id of a field's example hint (the column dropdown points at it with aria-describedby). */
+  protected exampleId(field: ImportFieldDef): string;
   get canSubmit(): boolean;
   get unmappedRequiredFields(): string[];
   get unmatchedCsvHeaders(): string[];
@@ -1601,6 +1646,15 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
    * own panel for `rows` and, when it has finished, calls `clearSelection()` and `refresh()` on the table.
    */
   readonly bulkPanelClick: import("@angular/core").OutputEmitterRef<BulkPanelEvent<T>>;
+  /**
+   * 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;
+  }>;
   /** Emitted after a built-in single-row delete completes successfully. */
   readonly rowDeleted: import("@angular/core").OutputEmitterRef<T>;
   /**
@@ -2193,6 +2247,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 +2283,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 +2298,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 +2316,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;
@@ -2342,7 +2414,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
    */
   readonly describedBy: import("@angular/core").InputSignal<string | null>;
   readonly maxWidth: import("@angular/core").InputSignal<string>;
-  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "visible" | "auto">;
+  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. */
@@ -2513,6 +2585,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 +2619,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 +2715,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 +2729,7 @@ export declare class ToastComponent {
    */
   private readonly _adoptedMessage;
   protected readonly adopted: import("@angular/core").Signal<boolean>;
+  private _lastRepeatTick;
   private _wasWaiting;
   private _hover;
   private _focus;
@@ -2694,7 +2782,7 @@ export declare class ToastComponent {
     "action": "action";
   }, never, never, true, never>;
 }
-export type ProgressBarVariant = 'blue' | 'green' | 'amber' | 'red' | 'slate';
+export type ProgressBarVariant = 'blue' | 'green' | 'amber' | 'orange' | 'red' | 'slate';
 /**
  * Horizontal progress bar with an optional trailing label (e.g. "3/5").
  * Pass `value` and `max`; the fill width is clamped to 0–100%, rounded to whole percents, and a value above 0 is never drawn narrower
@@ -2900,7 +2988,7 @@ export declare class AudioPlayerComponent {
   /** Accessible name of the player. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** How much to load before play: 'metadata' (default), 'auto' or 'none'. */
-  readonly preload: import("@angular/core").InputSignal<"none" | "metadata" | "auto">;
+  readonly preload: import("@angular/core").InputSignal<"auto" | "none" | "metadata">;
   /** Fires when the browser can't load or decode the source. */
   readonly playbackError: import("@angular/core").OutputEmitterRef<void>;
   protected readonly failed: import("@angular/core").WritableSignal<boolean>;
@@ -3154,7 +3242,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<1 | 4 | 2 | 3 | 5 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3172,7 +3260,7 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    */
   protected readonly _legend: import("@angular/core").Signal<string>;
   /** Group mode: lay the options out in a column (default) or in a wrapping row. */
-  readonly orientation: import("@angular/core").InputSignal<"vertical" | "horizontal">;
+  readonly orientation: import("@angular/core").InputSignal<"horizontal" | "vertical">;
   /**
    * Group mode: the ticked option values as a two-way model (`[(values)]`), an alternative to ngModel / forms. Unset (default) = the
    * group is driven by ngModel / FormControl only. Values that are not an option are dropped and the order follows `options`.
@@ -3378,6 +3466,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 +3510,11 @@ export declare class ToggleComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "inputTestId": {
+      "alias": "inputTestId";
+      "required": false;
+      "isSignal": true;
+    };
     "checked": {
       "alias": "checked";
       "required": false;
@@ -3546,13 +3641,13 @@ export declare class StepperComponent {
   /** Accessible name of the list. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** Horizontal, <= 480px: show only the current step's label (`'current'`, default) or every label (`'all'`). */
-  readonly labelsOnSmallScreens: import("@angular/core").InputSignal<"all" | "current">;
+  readonly labelsOnSmallScreens: import("@angular/core").InputSignal<"current" | "all">;
   /**
    * Horizontal only. `'beside'` (default): the label sits to the right of its circle. `'below'`: equal-width columns, the label centred under
    * its circle, one continuous line behind the circles that fills as steps complete; a complete step shows a check, the current step an
    * accent ring with a dot, an upcoming step an empty circle (no numbers). Circles are 40px (32px with `size="sm"`).
    */
-  readonly labelPosition: import("@angular/core").InputSignal<"below" | "beside">;
+  readonly labelPosition: import("@angular/core").InputSignal<"beside" | "below">;
   /** Viewport width in px below which a horizontal stepper is drawn vertical (labels beside the circles), e.g. `640`. null (default) = never. */
   readonly stackBelow: import("@angular/core").InputSignal<number | null>;
   /** CSS length (e.g. `10.5rem`): horizontal only - the list gets `min-width: calc(<step count> * <value>)`. Empty (default) = no minimum. */
@@ -3584,7 +3679,7 @@ export declare class StepperComponent {
   protected readonly rows: import("@angular/core").Signal<{
     step: StepperStep;
     index: number;
-    state: "complete" | "current" | "upcoming";
+    state: "current" | "complete" | "upcoming";
     error: boolean;
     errorMessage: string;
     selectable: boolean;
@@ -3869,6 +3964,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, `''`
@@ -3892,13 +3992,13 @@ export declare class RadioGroupComponent implements ControlValueAccessor, Valida
   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 orientation: import("@angular/core").InputSignal<"vertical" | "horizontal">;
+  readonly orientation: import("@angular/core").InputSignal<"horizontal" | "vertical">;
   /** Native `name` shared by the radios; a unique one is generated when omitted. */
   readonly name: import("@angular/core").InputSignal<string>;
   /** `<ng-template uiRadioOptionContent="value">` children: content shown under that option while it is selected. */
   private readonly _optionContent;
   protected readonly _nestedContent: import("@angular/core").Signal<Map<string, TemplateRef<unknown>>>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   private readonly _generatedName;
@@ -4181,7 +4281,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 +4302,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. */
@@ -4236,6 +4336,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;
@@ -4428,6 +4536,10 @@ export interface PillTab {
    * its name. The tooltip is not shown in the horizontally scrolling mobile layout (it would be clipped).
    */
   info?: string;
+  /** (library source 2026-11-05) Heading shown under the tab list while this tab is active, when the tabs' `showDescription` input is on. */
+  title?: string;
+  /** (library source 2026-11-05) Explanatory paragraph shown under the heading while this tab is active (`showDescription`). */
+  description?: string;
 }
 /**
  * Pill-style tabs following the WAI-ARIA tabs pattern: each tab is a real <button role="tab">,
@@ -4444,13 +4556,39 @@ export declare class PillTabsComponent {
   /** Keep every pill at its own width on one line (default false: pills may shrink and wrap their text). On a phone the row scrolls sideways, as it always does. */
   readonly noWrap: import("@angular/core").InputSignal<boolean>;
   /** '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">;
+  readonly orientation: import("@angular/core").InputSignal<"horizontal" | "vertical">;
   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>;
+  /**
+   * (library source 2026-11-05) Show the ACTIVE tab's `title` (heading) and `description` (paragraph) under the tab list. Default false = no extra DOM.
+   * A tab with only one of them renders only that one; a tab with neither renders nothing. The ids are `<name>--title` / `<name>--description`
+   * (`pillTabTitleId` / `pillTabDescriptionId`); `[uiTabPanel] [describedByHeader]="true"` points the panel's `aria-describedby` at the description.
+   */
+  readonly showDescription: import("@angular/core").InputSignal<boolean>;
+  /** Heading level of the active tab's title when `showDescription` is on: 2 (default) or 3. */
+  readonly headingLevel: import("@angular/core").InputSignal<2 | 3>;
   readonly tabChange: import("@angular/core").OutputEmitterRef<string>;
+  protected readonly activeTab: import("@angular/core").Signal<PillTab | null>;
+  protected titleId(): string;
+  protected descriptionId(): 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 +4626,104 @@ export declare class PillTabsComponent {
       "required": false;
       "isSignal": true;
     };
+    "controlsPanels": {
+      "alias": "controlsPanels";
+      "required": false;
+      "isSignal": true;
+    };
+    "showDescription": {
+      "alias": "showDescription";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingLevel": {
+      "alias": "headingLevel";
+      "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;
+/** Id of the heading `ui-pill-tabs` renders for the active tab when `showDescription` is on: `<name>--title`. */
+export declare function pillTabTitleId(name: string): string;
+/** Id of the description paragraph `ui-pill-tabs` renders for the active tab when `showDescription` is on: `<name>--description`. */
+export declare function pillTabDescriptionId(name: 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.
+ * - `describedByHeader`  default false. true adds `aria-describedby="<tabsName>--description"` (the description `ui-pill-tabs` shows under the
+ *                 tab list with `showDescription`) while the panel is not hidden. Turn it on only when the active tab has a `description`.
+ * - `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>;
+  /** Adds `aria-describedby` pointing at the description `ui-pill-tabs` renders under the tab list (`showDescription`). Default false. */
+  readonly describedByHeader: import("@angular/core").InputSignal<boolean>;
+  protected describedId(): string | null;
+  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;
+    };
+    "describedByHeader": {
+      "alias": "describedByHeader";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 export interface ContactLookup {
   id: string;
   name: string;
@@ -4999,7 +5231,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 +5249,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 +5321,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 +5420,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.
@@ -5182,7 +5447,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<"" | "email" | "search" | "none" | "text" | "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,8 +5505,14 @@ 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). */
@@ -5267,6 +5538,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 +5604,11 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
       "required": false;
       "isSignal": true;
     };
+    "leadingIcon": {
+      "alias": "leadingIcon";
+      "required": false;
+      "isSignal": true;
+    };
     "revealable": {
       "alias": "revealable";
       "required": false;
@@ -5556,7 +5838,7 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   readonly monospace: import("@angular/core").InputSignal<boolean>;
   /** 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>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
@@ -5584,6 +5866,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;
@@ -5839,7 +6128,7 @@ export declare class FileInputComponent implements ControlValueAccessor, Validat
   readonly fileRemoved: import("@angular/core").OutputEmitterRef<void>;
   /** Emits whenever the field becomes invalid / valid. */
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _files: import("@angular/core").WritableSignal<File[]>;
@@ -6145,7 +6434,7 @@ export declare class DatetimeInputComponent implements ControlValueAccessor, Val
   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>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
@@ -6421,7 +6710,8 @@ export declare class ComboboxComponent<T = unknown> implements ControlValueAcces
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
   readonly focused: import("@angular/core").OutputEmitterRef<void>;
   readonly blurred: import("@angular/core").OutputEmitterRef<void>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  /** Disables the field (`[disabled]="x()"`). Public so templates compile; ngModel / FormControl `disable()` still works (effective disabled = this OR the forms API). */
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   private readonly _field;
@@ -6743,7 +7033,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">;
   /** Trigger size for `variant="button"`: `sm` (default, the compact toolbar look) or `md` (same padding and type as a medium `ui-button`). */
   readonly size: import("@angular/core").InputSignal<"sm" | "md">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
@@ -7056,7 +7346,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<1 | 4 | 2 | 3>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -7073,7 +7363,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<"" | 2 | 3 | "all" | "2" | "3">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7112,6 +7402,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 +7421,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 +7449,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 +7487,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 +7556,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 +7598,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 +7993,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 +8105,11 @@ export declare class ListComponent<T = unknown> {
       "required": false;
       "isSignal": true;
     };
+    "bulleted": {
+      "alias": "bulleted";
+      "required": false;
+      "isSignal": true;
+    };
     "layout": {
       "alias": "layout";
       "required": false;
@@ -8585,10 +8939,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' | 'history' | 'move-up' | 'move-down';
 /**
  * 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 +8974,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>;
@@ -8926,7 +9285,7 @@ export declare class AddressInputComponent implements ControlValueAccessor, Vali
    * the object. `valueChange` always emits the object. A written string is read with `parseAddressValue` for display only: the control keeps
    * the original text until the user edits a field (so a text the parser cannot split is not rewritten on load).
    */
-  readonly valueFormat: import("@angular/core").InputSignal<"object" | "text" | "auto">;
+  readonly valueFormat: import("@angular/core").InputSignal<"object" | "auto" | "text">;
   /** ZIP rule; the default is the US 5 digits / 5+4 rule. `null` accepts any non-empty ZIP. The ZIP is validated and stored trimmed. */
   readonly zipPattern: import("@angular/core").InputSignal<RegExp | null>;
   /** Message shown when the ZIP breaks `zipPattern`. */
@@ -9250,6 +9609,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 +9643,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 +9663,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 +9742,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 +9969,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 +10041,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;
@@ -9805,7 +10208,7 @@ export declare class RichTextEditorComponent implements ControlValueAccessor {
   readonly maxHeight: import("@angular/core").InputSignal<number>;
   /** Toolbar controls to remove. Everything is shown by default. */
   readonly hide: import("@angular/core").InputSignal<RichTextOption[]>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   /** Disabled or read-only: the editor is not editable and every toolbar control is disabled. */
@@ -9959,6 +10362,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 +10384,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 +10410,11 @@ export declare class RadioComponent {
       "required": false;
       "isSignal": true;
     };
+    "icon": {
+      "alias": "icon";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -10053,6 +10469,240 @@ export declare class RadioComponent {
     "selected": "selected";
   }, never, ["*"], true, never>;
 }
+export interface SwatchOption {
+  value: string;
+  /** Accessible name and tooltip of the swatch (e.g. "Ocean blue"). */
+  label: string;
+  /** Any CSS colour (`#2563eb`, `rgb(...)`, `var(--x)`). */
+  color: string;
+  disabled?: boolean;
+  /** `data-testid` of this option's native radio input; none when omitted. */
+  testId?: string;
+}
+/**
+ * (library source 2026-11-05, not yet published) Colour swatch picker: a `<fieldset role="radiogroup">` of native radio inputs
+ * (arrow keys move + select natively, Home / End jump to the first / last enabled swatch), ControlValueAccessor with a string value
+ * (`''` = nothing selected). The selected swatch shows a check mark and a ring (never colour alone); every swatch is named by its `label`
+ * (accessible name + `title` tooltip). Built-in validation like `ui-radio-group`: `required` -> "<label> is required."; a value that is not one
+ * of the `options` -> "Select a valid option." (not checked while `options` is empty); a disabled picker is never invalid.
+ * `disabled` combines with the forms API (`setDisabledState`). 44px touch targets on touch devices and phones; the swatches wrap.
+ */
+export declare class SwatchPickerComponent implements ControlValueAccessor, Validator, UiFieldValidity {
+  private readonly _el;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly options: import("@angular/core").InputSignal<SwatchOption[]>;
+  readonly required: import("@angular/core").InputSignal<boolean>;
+  readonly hint: 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>;
+  /** Fixed number of swatches per row (0 = wrap freely, the default). On a phone the row wraps by width instead. */
+  readonly columns: import("@angular/core").InputSignal<number>;
+  /** Native `name` shared by the radios; a unique one is generated when omitted. */
+  readonly name: import("@angular/core").InputSignal<string>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  private readonly _cvaDisabled;
+  protected readonly disabled: import("@angular/core").Signal<boolean>;
+  private readonly _generatedName;
+  protected get _name(): string;
+  protected readonly _descId: string;
+  protected readonly _value: import("@angular/core").WritableSignal<string>;
+  private readonly _reveal;
+  private readonly _issue;
+  readonly invalid: import("@angular/core").Signal<boolean>;
+  readonly errorMessage: import("@angular/core").Signal<string>;
+  readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  /** Emits the chosen value on a user pick. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
+  protected readonly _activeError: import("@angular/core").Signal<string>;
+  private _onValidatorChange;
+  constructor();
+  ngOnChanges(): void;
+  validate(control: AbstractControl): ValidationErrors | null;
+  registerOnValidatorChange(fn: () => void): void;
+  private _onChange;
+  private _onTouched;
+  writeValue(val: string): void;
+  registerOnChange(fn: (v: string) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(d: boolean): void;
+  protected onSelect(value: string): void;
+  /** Home / End select the first / last enabled swatch (arrow keys are native radio behaviour). */
+  protected onKeydown(e: KeyboardEvent): void;
+  /** Touched once focus leaves the whole group. */
+  protected onFocusOut(event: FocusEvent): void;
+  private _check;
+  static ɵfac: i0.ɵɵFactoryDeclaration<SwatchPickerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<SwatchPickerComponent, "ui-swatch-picker", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "options": {
+      "alias": "options";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+    "hint": {
+      "alias": "hint";
+      "required": false;
+      "isSignal": true;
+    };
+    "error": {
+      "alias": "error";
+      "required": false;
+      "isSignal": true;
+    };
+    "showErrors": {
+      "alias": "showErrors";
+      "required": false;
+      "isSignal": true;
+    };
+    "columns": {
+      "alias": "columns";
+      "required": false;
+      "isSignal": true;
+    };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+    "_disabledInput": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "invalidChange": "invalidChange";
+    "valueChange": "valueChange";
+  }, never, never, true, never>;
+}
+export interface IconPickerOption {
+  value: string;
+  /** Accessible name and tooltip of the icon (e.g. "Wrench"). */
+  label: string;
+  /** Key of a library icon (`<ui-icon>` / action key such as `wrench`, `history`). Defaults to `value` when neither `iconKey` nor `path` is given. */
+  iconKey?: string;
+  /** Raw SVG path (`d` value, 24x24 stroke icon); wins over `iconKey`. */
+  path?: string;
+  disabled?: boolean;
+  /** `data-testid` of this option's native radio input; none when omitted. */
+  testId?: string;
+}
+/**
+ * (library source 2026-11-05, not yet published) Icon picker: a `<fieldset role="radiogroup">` of native radio inputs
+ * (arrow keys move + select natively, Home / End jump to the first / last enabled icon), ControlValueAccessor with a string value
+ * (`''` = nothing selected). The selected icon is inverted and shows a check mark (never colour alone); every icon is named by its `label`
+ * (accessible name + `title` tooltip). Built-in validation like `ui-radio-group`: `required` -> "<label> is required."; a value that is not one
+ * of the `options` -> "Select a valid option." (not checked while `options` is empty); a disabled picker is never invalid.
+ * `disabled` combines with the forms API (`setDisabledState`). 44px touch targets on touch devices and phones; the icons wrap.
+ */
+export declare class IconPickerComponent implements ControlValueAccessor, Validator, UiFieldValidity {
+  private readonly _el;
+  readonly label: import("@angular/core").InputSignal<string>;
+  readonly options: import("@angular/core").InputSignal<IconPickerOption[]>;
+  readonly required: import("@angular/core").InputSignal<boolean>;
+  readonly hint: 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>;
+  /** SVG path drawn for an option: its `path`, else the library icon `iconKey` (default: the option's `value`); '' when unknown. */
+  protected _path(o: IconPickerOption): string;
+  /** Fixed number of icons per row (0 = wrap freely, the default). On a phone the row wraps by width instead. */
+  readonly columns: import("@angular/core").InputSignal<number>;
+  /** Native `name` shared by the radios; a unique one is generated when omitted. */
+  readonly name: import("@angular/core").InputSignal<string>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  private readonly _cvaDisabled;
+  protected readonly disabled: import("@angular/core").Signal<boolean>;
+  private readonly _generatedName;
+  protected get _name(): string;
+  protected readonly _descId: string;
+  protected readonly _value: import("@angular/core").WritableSignal<string>;
+  private readonly _reveal;
+  private readonly _issue;
+  readonly invalid: import("@angular/core").Signal<boolean>;
+  readonly errorMessage: import("@angular/core").Signal<string>;
+  readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  /** Emits the chosen value on a user pick. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
+  protected readonly _activeError: import("@angular/core").Signal<string>;
+  private _onValidatorChange;
+  constructor();
+  ngOnChanges(): void;
+  validate(control: AbstractControl): ValidationErrors | null;
+  registerOnValidatorChange(fn: () => void): void;
+  private _onChange;
+  private _onTouched;
+  writeValue(val: string): void;
+  registerOnChange(fn: (v: string) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(d: boolean): void;
+  protected onSelect(value: string): void;
+  /** Home / End select the first / last enabled icon (arrow keys are native radio behaviour). */
+  protected onKeydown(e: KeyboardEvent): void;
+  /** Touched once focus leaves the whole group. */
+  protected onFocusOut(event: FocusEvent): void;
+  private _check;
+  static ɵfac: i0.ɵɵFactoryDeclaration<IconPickerComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<IconPickerComponent, "ui-icon-picker", never, {
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "options": {
+      "alias": "options";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+    "hint": {
+      "alias": "hint";
+      "required": false;
+      "isSignal": true;
+    };
+    "error": {
+      "alias": "error";
+      "required": false;
+      "isSignal": true;
+    };
+    "showErrors": {
+      "alias": "showErrors";
+      "required": false;
+      "isSignal": true;
+    };
+    "columns": {
+      "alias": "columns";
+      "required": false;
+      "isSignal": true;
+    };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+    "_disabledInput": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "invalidChange": "invalidChange";
+    "valueChange": "valueChange";
+  }, never, never, true, never>;
+}
 /**
  * Content shown directly under ONE option of a `ui-radio-group`, only while that option is selected (e.g. an address form under
  * "Ship to an alternate address"). Put an `<ng-template>` inside the group and name the option's value:
@@ -10115,7 +10765,7 @@ export declare class RadioMatrixComponent implements ControlValueAccessor, Valid
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
   /** Prefix of the native radio `name`s (one name per row); a unique one is generated when omitted. */
   readonly name: import("@angular/core").InputSignal<string>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   private readonly _generatedName;
@@ -10417,7 +11067,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 +11170,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 +11204,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<1 | 4 | 2 | 3 | 5 | 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 +11217,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<"start" | "end">;
   /** 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 +11305,11 @@ export declare class DetailCardComponent {
       "required": false;
       "isSignal": true;
     };
+    "footerAlign": {
+      "alias": "footerAlign";
+      "required": false;
+      "isSignal": true;
+    };
     "textColor": {
       "alias": "textColor";
       "required": false;
@@ -11187,7 +11847,7 @@ export declare class ColorInputComponent implements ControlValueAccessor, Valida
   readonly presets: import("@angular/core").InputSignal<ColorPreset[]>;
   /** Emits whenever the field becomes invalid / valid. */
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   /** Current model value (what the form control holds). */