@forgeroute/ui 0.4.75 → 0.4.77

package/types/forgeroute-ui.d.ts

@@ -68,6 +68,23 @@ export interface ToolbarAction {
    * the on / off state. Leave unset for ordinary buttons (no attribute).
    */
   pressed?: boolean;
+  /**
+   * Optional confirmation before the click is reported (library source 2026-11-05, not yet published). Set it ONLY on an action that needs a
+   * confirm dialog (pause / run now / send to all): the table shows its confirm modal first, emits `(tableButtonClick)` only when the user
+   * confirms, and emits nothing on Cancel / Escape / backdrop. An action without `confirm` behaves exactly as before. Not used for the
+   * table's own Import and Export. Same copy fields as a row action's `modal` (`message` may be a function read at click time, for text that
+   * depends on the host's current state); say what happens before -> after and what is NOT affected.
+   */
+  confirm?: ToolbarConfirm;
+}
+/** Confirm dialog copy of a toolbar action (see `ToolbarAction.confirm`). */
+export interface ToolbarConfirm {
+  title: string;
+  message: string | (() => string);
+  confirmLabel?: string;
+  cancelLabel?: string;
+  variant?: 'danger' | 'primary' | 'warning';
+  details?: string[];
 }
 export interface ConfirmConfig {
   title: string;
@@ -179,6 +196,28 @@ export interface ColumnDef {
    * Example: `{ key: 'name', label: 'Name', starFn: (doc) => doc.isAuthForm ? 'Authorization Form' : null }`
    */
   starFn?: (item: any) => string | null | undefined;
+  /**
+   * Library source 2026-11-05, not yet published. Draws a small decorative icon (16px, `aria-hidden`, currentColor, on the first text line, never shrinks)
+   * to the LEFT of the cell text, in desktop cells and in the phone card (title, badge pills, detail rows). Returns a `<ui-icon>` key (see `iconPath()`) or a
+   * raw 24x24 stroke SVG path (drawing commands and numbers only, same rule as ui-radio's `icon`); null / undefined / '' / anything else draws nothing.
+   * Applies to text, badge, date, phone and number cells; never to avatar-name, link, tags, progress, image, days-ago or actions. The cell's text and the row's
+   * accessible name are unchanged (see `iconLabelFn` for meaningful icons). Placed before a `starFn` star.
+   * Example: `{ key: 'name', label: 'Name', iconFn: (r) => r.kind === 'rental' ? 'wrench' : 'cup' }`
+   */
+  iconFn?: (item: any) => string | null | undefined;
+  /**
+   * Library source 2026-11-05, not yet published. Accessible text for a MEANINGFUL `iconFn` icon: rendered as visually hidden text right after the icon
+   * (the icon stays `aria-hidden`). Default (absent / null / '') = the icon is decorative. Ignored when no icon is drawn for the row.
+   */
+  iconLabelFn?: (item: any) => string | null | undefined;
+  /**
+   * Footer text for this column, from the table's `totalsEndpoint` response (shown only while the table has rows and the totals loaded).
+   * Return null / undefined / '' for an empty footer cell. `cellType: 'number'` columns are right-aligned like their body cells.
+   * The table's `totalsLabel` goes in the footer cell of the first visible column; when that column has a `footerFn` too, the label is
+   * kept as visually hidden text before the value ("Total: $1,200") so it is still announced once.
+   * Example: `{ key: 'amount', label: 'Amount', cellType: 'number', footerFn: t => t['amount'] == null ? null : '$' + t['amount'] }`
+   */
+  footerFn?: (totals: Record<string, string | number | null>) => string | null | undefined;
   /** Date format string. Default: 'MMM d, y' */
   dateFormat?: string;
   /** Returns the display name for the row. Default: item[col.key] */
@@ -1555,6 +1594,16 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   protected readonly _showHeader: Signal<boolean>;
   /** Optional endpoint that returns Record<string,number> counts per quick-filter value. */
   readonly countsEndpoint: import("@angular/core").InputSignal<string>;
+  /**
+   * Optional footer totals row. Path relative to `baseUrl` (like `endpoint`). When set, the table GETs it with the same query params as the
+   * rows request except paging and sorting (host `params`, lower-cased `search` + `searchFields`, active tab as `filter`, column filters) and
+   * shows a footer built from each column's `footerFn`. The response is `Record<string, string | number | null>`. Totals follow the FILTERED
+   * set, not the page; they are refetched on search / tab / filter / params / refresh() / resetToFirstPage() / import (not on paging or
+   * sorting) and never cached. Hidden while loading, on error, with zero rows, or when the totals request fails (silently).
+   */
+  readonly totalsEndpoint: import("@angular/core").InputSignal<string>;
+  /** Text of the footer's label cell (first visible column) and the phone summary card's accessible name. */
+  readonly totalsLabel: import("@angular/core").InputSignal<string>;
   /**
    * Optional extra query params owned by the host page (e.g. a period picker or a parent-record id),
    * sent with every row, /counts, /filter-counts and export request. When the value changes the table
@@ -1803,6 +1852,23 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   /** Current active filter/search/sort params — passed to the export so it exports the filtered view. */
   /** Visible searchable column keys (comma-joined) — the table and Export only search what's on screen. */
   protected readonly _searchFields: Signal<string>;
+  /** Latest footer totals response (null = none / failed / not requested). */
+  protected readonly _totals: import("@angular/core").WritableSignal<Record<string, string | number | null> | null>;
+  private _totalsSub?;
+  /** Set by paging and sorting: they reload rows but never change the totals. */
+  private _totalsSkipNext;
+  protected readonly _footerVisible: Signal<boolean>;
+  /** Footer text per visible column key (only columns whose footerFn returns text). */
+  protected readonly _footerCells: Signal<Record<string, string>>;
+  protected readonly _footerPhoneLines: Signal<{
+    key: string;
+    label: string;
+    value: string;
+  }[]>;
+  /** Totals request params: the export params without sorting (the rows request without paging and sorting). */
+  private _totalsParams;
+  /** `keepShown`: a silent (background) refresh keeps the current footer on screen until the new totals arrive. */
+  private _fetchTotals;
   protected readonly _exportParams: Signal<Record<string, string>>;
   /**
    * Toolbar buttons with auto-injected Export (always) and Import (only when
@@ -1868,6 +1934,13 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   protected rowActionsLabel(item: T): string;
   protected toggleSelectAll(): void;
   protected toggleRow(item: T): void;
+  /**
+   * The table's current query as the parameters it sends with Export: the host `params`, the lower-cased `search` (+ `searchFields`),
+   * the active quick tab as `filter`, `sort` + `direction`, and every active column filter (multi-values comma-joined). A new copy
+   * on every call; reading it changes nothing. A host uses it to act on exactly what the table shows (print the same rows, call a
+   * report endpoint with the same search / filters) without keeping its own copy of that state. Paging is not included.
+   */
+  currentQuery(): Record<string, string>;
   /** Clears the selection — call from the host component after a bulk action completes. */
   clearSelection(): void;
   resetColumns(): void;
@@ -2023,7 +2096,7 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   protected onRowClick(item: T): void;
   /** Enter / Space on a focused clickable row or card activates it — ignored when focus is on a control inside it. */
   protected onRowKeydown(e: KeyboardEvent, item: T): void;
-  protected onInternalButtonClick(type: string): void;
+  protected onInternalButtonClick(type: string): Promise<void>;
   protected onImported(): void;
   /** Row actions visible for the current permission: everything for 'full'; otherwise only View (`type: 'view'`) and actions marked
    *  `allowReadOnly` (never the built-in delete). The Actions column itself is shown only while some row has a visible action. */
@@ -2055,6 +2128,16 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   protected onLinkClick(e: MouseEvent, link: ResolvedLink, col: ColumnDef, item: T): void;
   protected getInitials(name: string): string;
   protected isCardOverdue(col: ColumnDef, item: T): boolean;
+  /** Cell types that never get a leading icon: they draw their own leading visual or are not text-like. */
+  private static readonly _NO_ICON_TYPES;
+  /**
+   * Path of the leading icon for a cell (library source 2026-11-05, not yet published): `iconFn` returns a `<ui-icon>` key (known key wins) or a raw
+   * 24x24 stroke path (drawing commands and numbers only, same rule as ui-radio's `icon`); anything else, an empty value, a throwing `iconFn` or a
+   * non-text-like cell type gives null (nothing is drawn).
+   */
+  protected cellIconPath(col: ColumnDef, item: T): string | null;
+  /** Screen-reader text for a meaningful icon (`iconLabelFn`); '' (decorative) when absent, empty, throwing or when no icon is drawn. */
+  protected cellIconLabel(col: ColumnDef, item: T): string;
   /** Renders any non-badge column value as a plain string for the mobile card view. */
   protected cardCellText(col: ColumnDef, item: T): string;
   /** Refresh data rows only — used internally for sort, filter, search, pagination. */
@@ -2169,6 +2252,16 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
       "required": false;
       "isSignal": true;
     };
+    "totalsEndpoint": {
+      "alias": "totalsEndpoint";
+      "required": false;
+      "isSignal": true;
+    };
+    "totalsLabel": {
+      "alias": "totalsLabel";
+      "required": false;
+      "isSignal": true;
+    };
     "params": {
       "alias": "params";
       "required": false;
@@ -2545,7 +2638,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
     "close": "close";
   }, never, ["[modal-header-end]", "*", "[modal-footer-left]", "[modal-footer-center]", "[modal-footer-right]"], true, never>;
 }
-export type ToastType = 'success' | 'error' | 'info';
+export type ToastType = 'success' | 'error' | 'info' | 'warning';
 /** A button on a toast (e.g. "View Contact", "Call Back"). */
 export interface ToastAction {
   /** Identifies the button in `onAction` and in the `(action)` output; also the test id suffix (`toast-action-<id>`). */
@@ -2565,11 +2658,11 @@ export interface ToastActionEvent {
   key?: string;
 }
 /**
- * Per-message options for `show()` / `success()` / `info()` / `error()` / `notify()`. Every field is optional; a call without any of them is a plain
+ * Per-message options for `show()` / `success()` / `info()` / `warning()` / `error()` / `notify()`. Every field is optional; a call without any of them is a plain
  * toast exactly as before.
  */
 export interface ToastOptions {
-  /** Only `notify()` reads this (`show` / `success` / `info` / `error` fix their own type). Default `success`. */
+  /** Only `notify()` reads this (`show` / `success` / `info` / `warning` / `error` fix their own type). Default `success`. */
   type?: ToastType;
   /** How long it stays, in ms. Default: 3000 (4000 for errors). */
   duration?: number;
@@ -2651,6 +2744,12 @@ export declare class ToastService implements OnDestroy {
   success(msg: string, durationOrOptions?: number | ToastOptions): void;
   /** Neutral (blue) toast for a result that is neither a success nor a failure, e.g. "No changes to save.". */
   info(msg: string, durationOrOptions?: number | ToastOptions): void;
+  /**
+   * Amber toast for a result that worked but needs attention, e.g. "Saved, but 2 screenshots could not be attached." Announced politely (not as an
+   * alert: nothing failed). Default 4000ms, a little longer than info because the user has something to read and maybe act on.
+   * (library source 2026-11-04, not yet published)
+   */
+  warning(msg: string, durationOrOptions?: number | ToastOptions): void;
   error(msg: string, durationOrOptions?: number | ToastOptions): void;
   /** A toast whose type comes from `options.type` (default `success`); the same as the named methods otherwise. */
   notify(msg: string, options?: ToastOptions): void;
@@ -2869,6 +2968,86 @@ export declare class ProgressBarComponent {
     };
   }, {}, never, never, true, never>;
 }
+/** Library source 2026-11-05, not yet published. One segment of a `ui-stacked-bar`. */
+export interface StackedBarSegment {
+  /** Name shown in the legend and read out for the segment. */
+  label: string;
+  /** Amount of this segment (negative / NaN count as 0). */
+  value: number;
+  /** Built-in colour (same set as `ui-progress-bar`). Default: a fixed rotation by position. */
+  variant?: ProgressBarVariant;
+  /** Any CSS colour; wins over `variant`. */
+  color?: string;
+}
+/**
+ * A single horizontal bar split into coloured segments by their share of the total (e.g. an aging snapshot: current / 1-30 / 31-60 / 61-90 / 91+).
+ * Pure CSS (no chart library): each segment's width is its rounded share, a value above 0 is never drawn narrower than 2%, segments of 0 are left
+ * out of the bar (but stay in the legend). A total of 0 draws an empty track.
+ *
+ * Accessible without sight: the coloured strip is decorative (`aria-hidden`); the legend is a real list ("<label>: <value> (<share>%)") that is always
+ * in the page, and `showLegend="false"` only hides it visually. The group is named by `ariaLabel`. Each segment also has a hover `title`.
+ * Colours never carry the meaning alone (the legend repeats label, value and share); forced-colors mode draws the segments with a border.
+ *
+ * Inputs: `segments`, `ariaLabel`, `height` (px, default 14), `showLegend` (default true), `formatValue` (default: en-US grouped number; pass e.g. a
+ * currency formatter). Output: none.
+ */
+export declare class StackedBarComponent {
+  readonly segments: import("@angular/core").InputSignal<StackedBarSegment[]>;
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  readonly height: import("@angular/core").InputSignal<number>;
+  readonly showLegend: import("@angular/core").InputSignal<boolean>;
+  readonly formatValue: import("@angular/core").InputSignal<(value: number) => string>;
+  /** Segments with their cleaned value, colour and share (legend order = input order). */
+  protected readonly rows: import("@angular/core").Signal<{
+    percent: number;
+    text: string;
+    title: string;
+    key: string;
+    label: string;
+    color: string;
+    variant: ProgressBarVariant;
+    value: number;
+  }[]>;
+  /** Only the segments that have something to draw. */
+  protected readonly drawn: import("@angular/core").Signal<{
+    percent: number;
+    text: string;
+    title: string;
+    key: string;
+    label: string;
+    color: string;
+    variant: ProgressBarVariant;
+    value: number;
+  }[]>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StackedBarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StackedBarComponent, "ui-stacked-bar", never, {
+    "segments": {
+      "alias": "segments";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "height": {
+      "alias": "height";
+      "required": false;
+      "isSignal": true;
+    };
+    "showLegend": {
+      "alias": "showLegend";
+      "required": false;
+      "isSignal": true;
+    };
+    "formatValue": {
+      "alias": "formatValue";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 export type ProgressRingVariant = 'blue' | 'green' | 'amber' | 'red' | 'slate' | 'sky';
 /**
  * Circular progress ring with the rounded percentage (or a custom `label`) in the middle.
@@ -3145,6 +3324,153 @@ export declare class StarComponent {
     "starClick": "starClick";
   }, never, never, true, never>;
 }
+/**
+ * Library source 2026-11-05, not yet published.
+ *
+ * Accessible star rating, 1..`max` (default 5). A ControlValueAccessor with a number value (`0` = no rating).
+ *
+ * - Input mode (default): a `<fieldset role="radiogroup">` (+ `<legend>` = `label`) of native radio inputs that share one `name`, so the browser
+ *   gives the roving tab stop and ArrowLeft / ArrowRight / ArrowUp / ArrowDown (move + select) for free; Space selects the focused star natively,
+ *   Enter selects it too and Home / End select the first / last star (handled here). Each radio is named "1 star", "2 stars", ...
+ * - `readonly`: all `max` stars are drawn (filled up to the value, the rest outlined) as one `role="img"` named "4 stars out of 5" ("No rating" for 0; with a `label`: "Quality: 4 stars out of 5"). No inputs.
+ * - Validation follows `ui-radio-group` (`UiFieldValidity`, `Validator`, `invalidChange`): `required` -> "<label> is required." when the value is 0;
+ *   a value that is not a whole number from 0 to `max` -> "Select a valid option."; messages show after the group lost focus or while `[showErrors]="true"`;
+ *   a host `[error]` wins. Disabled and readonly are never invalid.
+ * - Stars are gold (same look as `ui-star`, with a darker amber outline so the shape reaches 3:1 against white); empty stars are outlined, so the value never relies on colour alone. 44px touch targets on touch / phones.
+ *
+ *   <ui-star-rating label="Quality" [required]="true" [showErrors]="touched()" [(ngModel)]="form.rating" />
+ *   <ui-star-rating [readonly]="true" [value]="4" />
+ */
+export declare class StarRatingComponent implements ControlValueAccessor, Validator, UiFieldValidity {
+  /** Largest rating (number of stars). Default 5; values below 1 or non-integers are clamped to a whole number of at least 1. */
+  readonly max: import("@angular/core").InputSignal<number>;
+  /** Current rating for standalone / readonly use (`[value]="4"`); `0` = none. With forms, the control value wins after it is written. */
+  readonly value: import("@angular/core").InputSignal<number>;
+  readonly label: import("@angular/core").InputSignal<string>;
+  /** Accessible name when there is no visible `label` (default "Rating"). */
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  readonly hint: import("@angular/core").InputSignal<string>;
+  readonly error: import("@angular/core").InputSignal<string>;
+  readonly required: 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>;
+  /** Star size in px (default 24). */
+  readonly size: import("@angular/core").InputSignal<number>;
+  /** Display only: filled stars as one image named "4 stars out of 5"; no inputs, never invalid. */
+  readonly readonly: import("@angular/core").InputSignal<boolean>;
+  /** 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>;
+  /** Emits the new rating when the USER picks a star (not for values the host writes). */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<number>;
+  /** Emits whenever the field becomes invalid / valid. */
+  readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  protected readonly _value: import("@angular/core").WritableSignal<number>;
+  protected readonly _max: import("@angular/core").Signal<number>;
+  protected readonly _stars: import("@angular/core").Signal<number[]>;
+  /** Stars drawn filled: the value, kept inside 0..max (an invalid value never overflows the row). */
+  protected readonly _shown: import("@angular/core").Signal<number>;
+  protected readonly _readonlyText: import("@angular/core").Signal<string>;
+  protected readonly _path = "M10 1.5l2.6 5.3 5.9.9-4.25 4.15 1 5.85L10 14.9l-5.25 2.8 1-5.85L1.5 7.7l5.9-.9L10 1.5z";
+  private readonly _generatedName;
+  protected get _name(): string;
+  protected readonly _descId: string;
+  private readonly _host;
+  private readonly _reveal;
+  private readonly _issue;
+  /** True while the value breaks a built-in rule or the host passed an `[error]`. */
+  readonly invalid: import("@angular/core").Signal<boolean>;
+  /** Message of the first broken built-in rule ('' when valid), shown or not. */
+  readonly errorMessage: import("@angular/core").Signal<string>;
+  protected readonly _activeError: import("@angular/core").Signal<string>;
+  private _onValidatorChange;
+  constructor();
+  /** Re-run the form control's validation when a rule input (required, max) changes. */
+  ngOnChanges(): void;
+  validate(control: AbstractControl): ValidationErrors | null;
+  registerOnValidatorChange(fn: () => void): void;
+  private _onChange;
+  private _onTouched;
+  writeValue(val: number | null): void;
+  registerOnChange(fn: (v: number) => void): void;
+  registerOnTouched(fn: () => void): void;
+  setDisabledState(d: boolean): void;
+  private static _norm;
+  protected onSelect(n: number): void;
+  /** Enter selects the focused star (Space and the arrow keys are native radio behaviour); Home / End select the first / last star. */
+  protected onKeydown(event: KeyboardEvent, n: number): void;
+  /** Touched once focus leaves the whole group (moving between its stars does not count). */
+  protected onFocusOut(event: FocusEvent): void;
+  private _check;
+  static ɵfac: i0.ɵɵFactoryDeclaration<StarRatingComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<StarRatingComponent, "ui-star-rating", never, {
+    "max": {
+      "alias": "max";
+      "required": false;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "label": {
+      "alias": "label";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "hint": {
+      "alias": "hint";
+      "required": false;
+      "isSignal": true;
+    };
+    "error": {
+      "alias": "error";
+      "required": false;
+      "isSignal": true;
+    };
+    "required": {
+      "alias": "required";
+      "required": false;
+      "isSignal": true;
+    };
+    "showErrors": {
+      "alias": "showErrors";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "readonly": {
+      "alias": "readonly";
+      "required": false;
+      "isSignal": true;
+    };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
+    "_disabledInput": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "valueChange": "valueChange";
+    "invalidChange": "invalidChange";
+  }, never, never, true, never>;
+}
 export type ImageRepositionShape = 'circle' | 'rounded';
 /**
  * Drag-to-center photo frame. The image fills the frame (`object-fit: cover`) and the user drags it, or uses the arrow
@@ -3969,6 +4295,15 @@ export interface RadioOption {
    * path. Decorative (`aria-hidden`); none when omitted.
    */
   icon?: string;
+  /**
+   * Library source 2026-11-05, not yet published. Link shown after the option's description (e.g. "Read the terms"): only http(s), mailto, tel and
+   * in-app paths are linked, an absolute http(s) address opens in a new tab. `testId` is the link's `data-testid`. None when omitted.
+   */
+  descriptionLink?: {
+    label: string;
+    url: string;
+    testId?: string;
+  };
 }
 /**
  * Group of native radio buttons inside a `<fieldset>` (+ `<legend>` = `label`), a ControlValueAccessor (string value, `''`
@@ -5544,6 +5879,26 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * view exists, or on a disabled field, it does nothing and never throws.
    */
   focus(options?: FocusOptions): void;
+  /**
+   * Library source 2026-11-05, not yet published. Caret access for hosts (e.g. an "insert variable at the cursor" chip row), so a host never
+   * queries the inner element. Reach it with `viewChild(TextInputComponent)`. All three methods are safe at any time: before the view exists, on a
+   * disabled / read-only field, or for a type that has no selection API (email, number) they do nothing / return null and never throw.
+   *
+   * `getSelection()` -> `{ start, end }` of the selected text (equal when only a caret) or `null` when it cannot be read.
+   */
+  getSelection(): {
+    start: number;
+    end: number;
+  } | null;
+  /** Selects `start`..`end` (a caret when `end` is left out); values are clamped to the text. Does nothing where the selection API is unavailable. */
+  setSelection(start: number, end?: number): void;
+  /**
+   * Inserts `text` at the caret, replacing any selected text, and puts the caret right after it. The change goes through the normal typing path
+   * (formatting, `ngModel` / form control, `valueChange`), exactly as if the user had typed it, and `maxlength` caps it like typing does (the
+   * part that does not fit is not inserted). With no caret known (a type without a selection API) the text is appended. Does nothing on a
+   * disabled or read-only field or for an empty `text`.
+   */
+  insertAtCaret(text: string): void;
   private _onChange;
   private _onTouched;
   private _onValidatorChange;
@@ -5858,6 +6213,10 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   readonly errorMessage: import("@angular/core").Signal<string>;
   /** Emits whenever the field becomes invalid / valid. */
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  /** Library source 2026-11-05, not yet published. Emits when the inner `<textarea>` gains focus (same as `ui-text-input`). */
+  readonly focused: import("@angular/core").OutputEmitterRef<void>;
+  /** Library source 2026-11-05, not yet published. Emits when the inner `<textarea>` loses focus (same as `ui-text-input`); the form control is marked touched and the built-in error reveal still happens. */
+  readonly blurred: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _activeError: import("@angular/core").Signal<string>;
   private _onValidatorChange;
   constructor();
@@ -5873,6 +6232,27 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
    * nothing and never throws.
    */
   focus(options?: FocusOptions): void;
+  /**
+   * Library source 2026-11-05, not yet published. Caret access for hosts (e.g. an "insert variable at the cursor" chip row), so a host never
+   * queries the inner element. Reach it with `viewChild(TextareaInputComponent)`. All three methods are safe at any time: before the view exists, on a
+   * disabled / read-only field they do nothing / return null and never throw.
+   *
+   * `getSelection()` -> `{ start, end }` of the selected text (equal when only a caret) or `null` when it cannot be read.
+   */
+  getSelection(): {
+    start: number;
+    end: number;
+  } | null;
+  /** Selects `start`..`end` (a caret when `end` is left out); values are clamped to the text. Does nothing where the selection API is unavailable. */
+  setSelection(start: number, end?: number): void;
+  /**
+   * Inserts `text` at the caret, replacing any selected text, and puts the caret right after it. The change goes through the normal typing path
+   * (`ngModel` / form control), exactly as if the user had typed it, and `maxlength` caps it like typing does (the
+   * part that does not fit is not inserted). With no caret known the text is appended. Does nothing on a
+   * disabled or read-only field or for an empty `text`.
+   */
+  insertAtCaret(text: string): void;
+  private _textarea;
   private _onChange;
   private _onTouched;
   writeValue(val: string | null): void;
@@ -5880,6 +6260,7 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   registerOnTouched(fn: () => void): void;
   setDisabledState(d: boolean): void;
   protected onInput(event: Event): void;
+  protected onFocus(): void;
   protected onBlur(): void;
   private _check;
   static ɵfac: i0.ɵɵFactoryDeclaration<TextareaInputComponent, never>;
@@ -5956,6 +6337,8 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
     };
   }, {
     "invalidChange": "invalidChange";
+    "focused": "focused";
+    "blurred": "blurred";
   }, never, ["[uiLabelEnd]"], true, never>;
 }
 export type TextSize = 'sm' | 'md' | 'lg';
@@ -6393,7 +6776,7 @@ export declare class CopyFieldComponent implements OnDestroy {
   /** Neither the Clipboard API nor the fallback could copy. */
   readonly copyFailed: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _id: string;
-  protected readonly _state: import("@angular/core").WritableSignal<"idle" | "copied" | "failed">;
+  protected readonly _state: import("@angular/core").WritableSignal<"idle" | "failed" | "copied">;
   protected readonly _announcement: import("@angular/core").Signal<string>;
   protected readonly _buttonName: import("@angular/core").Signal<string>;
   protected readonly _describedBy: import("@angular/core").Signal<string | null>;
@@ -7549,6 +7932,13 @@ export declare class FormColSpanDirective {
  *     <ui-button list-item-action variant="icon" ariaLabel="Remove" (click)="remove(d)">…</ui-button>
  *   </ui-list-item>
  *
+ * Library source 2026-11-05, not yet published: row-end content slot. An element with the `list-item-end` attribute (a `<ui-star-rating>`, a badge, a price...) is
+ * projected at the END of the row, after the text and before the busy spinner and the `list-item-action` buttons, vertically centred, at its own size. Like the action
+ * slot it sits outside the row's label: clicks inside it never emit `select` (also on a plain pressable row), and Enter / Space inside it are not treated as a row
+ * press. Absent = no extra DOM, nothing changes. Accessibility note: a plain pressable row (`leading="none"`, interactive) is `role="button"`, whose children are presentational, so
+ * INTERACTIVE content in this slot (a `<ui-star-rating>`, a button) should go on a row with `[interactive]="false"` (no role, nothing pressable); a badge or other static text is fine on any row.
+ *   <ui-list-item [title]="r.name" [details]="[r.date]"><ui-star-rating list-item-end [readonly]="true" [value]="r.rating" [size]="16" /></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
@@ -7561,10 +7951,22 @@ export declare class FormColSpanDirective {
  */
 /** 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 | {
-  text: string;
+  text?: string;
+  segments?: ListItemSegment[];
   icon?: string;
   tone?: 'default' | 'warning' | 'danger';
 };
+/**
+ * One piece of a rich detail line (library source 2026-11-04, not yet published): plain text, or text shown in bold and/or as inline code. Rich text
+ * is structured data, never HTML, so nothing is injected. `{ segments: ['Click ', { text: 'Connect', bold: true }, ' and copy ', { text: 'client_id', code: true }] }`
+ * renders `Click <strong>Connect</strong> and copy <code>client_id</code>`. A detail with `segments` ignores `text` for display (when `text` is empty
+ * the segments' plain text is used, e.g. for the visible-line check).
+ */
+export type ListItemSegment = string | {
+  text: string;
+  bold?: boolean;
+  code?: boolean;
+};
 /** Colour of the optional leading icon tile. */
 export type ListItemIconColor = 'slate' | 'amber' | 'red' | 'blue' | 'green' | 'purple' | 'teal' | 'orange';
 export declare class ListItemComponent implements AfterContentChecked {
@@ -7652,6 +8054,11 @@ export declare class ListItemComponent implements AfterContentChecked {
   protected onRowKey(e: Event): void;
   protected readonly visibleDetails: () => {
     text: string;
+    segs: {
+      text: string;
+      bold: boolean;
+      code: boolean;
+    }[] | null;
     d: string | null;
     tone: "default" | "warning" | "danger";
   }[];
@@ -7744,7 +8151,7 @@ export declare class ListItemComponent implements AfterContentChecked {
     };
   }, {
     "select": "select";
-  }, never, ["[list-item-image]", "[list-item-action], [li-action]"], true, never>;
+  }, never, ["[list-item-image]", "[list-item-end]", "[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';
@@ -8707,7 +9114,7 @@ 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 _gap: import("@angular/core").Signal<"8px" | "6px" | "12px">;
   protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
   protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
@@ -9087,13 +9494,13 @@ export declare class AlertComponent {
 }
 /**
  * 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, and `cash` (banknote) and `dollar` (payment methods / amounts), library source 2026-11-05, not yet published.
+ * Each resolves with `iconPath(key)`. Includes `search`, `cup` (food / drink) and `wrench` (rental / tools), library source 2026-11-04, and `cash` (banknote) and `dollar` (payment methods / amounts), library source 2026-11-05, not yet published. Also `star`, `gift`, `award` and `calendar-check` (library source 2026-11-05, 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' | 'search' | 'cup' | 'wrench' | 'cash' | 'dollar' | 'history' | 'move-up' | 'move-down';
+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' | 'cash' | 'dollar' | 'star' | 'gift' | 'award' | 'calendar-check' | '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, …).
@@ -10508,6 +10915,16 @@ 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-05, not yet published. Optional link shown after the description: `linkLabel` is its text, `linkUrl` its address. Only `http:`, `https:`,
+   * `mailto:` and `tel:` addresses and in-app paths (`/...`, `#...`) are linked; anything else (`javascript:`, `data:`, empty) draws nothing. An absolute http(s)
+   * address opens in a new tab (`noopener noreferrer`, with "(opens in a new tab)" for screen readers); the others follow in the same tab. The radio's
+   * accessible name stays the label only.
+   */
+  readonly linkLabel: import("@angular/core").InputSignal<string>;
+  readonly linkUrl: import("@angular/core").InputSignal<string>;
+  /** `data-testid` of the link; none when empty. */
+  readonly linkTestId: 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
@@ -10532,11 +10949,14 @@ export declare class RadioComponent {
   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>;
+  /** The address to link, or null when the link is not drawn (no label, empty or unsafe address). */
+  protected readonly _linkHref: import("@angular/core").Signal<string | null>;
+  protected readonly _linkNewTab: import("@angular/core").Signal<boolean>;
   /** 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;
   protected readonly _labelId: import("@angular/core").Signal<string>;
-  /** With a description inside the <label>, the accessible name would read "Email We send a message": name the input by the label text only. */
+  /** With a description or link inside the <label>, the accessible name would read "Email We send a message": name the input by the label text only. */
   protected readonly _labelledBy: import("@angular/core").Signal<string | null>;
   protected readonly _descriptionId: string;
   /** Group hint/error id plus the option's own description (kept out of the label so the accessible name is label-only). */
@@ -10556,6 +10976,21 @@ export declare class RadioComponent {
       "required": false;
       "isSignal": true;
     };
+    "linkLabel": {
+      "alias": "linkLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "linkUrl": {
+      "alias": "linkUrl";
+      "required": false;
+      "isSignal": true;
+    };
+    "linkTestId": {
+      "alias": "linkTestId";
+      "required": false;
+      "isSignal": true;
+    };
     "icon": {
       "alias": "icon";
       "required": false;
@@ -16134,7 +16569,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[]>;