@forgeroute/ui 0.4.76 → 0.4.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeroute/ui",
-  "version": "0.4.76",
+  "version": "0.4.78",
   "peerDependencies": {
     "@angular/common": ">=22.0.0",
     "@angular/core": ">=22.0.0",

package/types/forgeroute-ui.d.ts

@@ -196,6 +196,20 @@ 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.
@@ -1195,7 +1209,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<"sm" | "default">;
+  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -2114,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. */
@@ -3143,7 +3167,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<"none" | "auto" | "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>;
@@ -3300,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
@@ -3384,6 +3555,22 @@ export interface CheckboxOption {
   /** `data-testid` of this option's label text; none when omitted. */
   labelTestId?: string;
 }
+/** A link a single `ui-checkbox` label can hold: the label text names it with `{key}`, `labelLinks` says what `{key}` shows and where it goes. */
+export interface CheckboxLabelLink {
+  /** The link's text (plain text, never HTML). A link with no text is not drawn. */
+  label: string;
+  /** Where it goes: `http:`, `https:`, `mailto:`, `tel:` or an in-app path (`/terms`, `#top`). Anything else (`javascript:`, `data:`, `//host`, empty) draws the text without a link. */
+  url: string;
+  /** `data-testid` of the link; none when omitted. */
+  testId?: string;
+}
+/** One piece of a label that holds links: plain text, or a link when `href` is set. */
+interface CheckboxLabelSegment {
+  text: string;
+  href?: string;
+  newTab?: boolean;
+  testId?: string;
+}
 export declare class CheckboxComponent implements ControlValueAccessor, Validator, UiFieldValidity {
   readonly label: import("@angular/core").InputSignal<string>;
   /** Accessible name for the native checkbox when there is no visible `label` (e.g. a table row's selector). */
@@ -3397,7 +3584,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 | 5 | 3 | 6 | 4 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -3421,6 +3608,23 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    * group is driven by ngModel / FormControl only. Values that are not an option are dropped and the order follows `options`.
    */
   readonly values: import("@angular/core").ModelSignal<string[] | undefined>;
+  /**
+   * Single mode: links inside the label. The label text names where each link goes with `{key}` and this object says what it is, so a sentence can hold links
+   * without HTML and without the host assembling markup:
+   *
+   *   <ui-checkbox label="I agree to the {terms} and the {privacy}" [labelLinks]="{ terms: { label: 'Terms of Service', url: '/terms' }, privacy: { label: 'Privacy Policy', url: '/privacy' } }" />
+   *
+   * Only `http:`, `https:`, `mailto:`, `tel:` addresses and in-app paths are linked (see `CheckboxLabelLink`); a link whose address is unsafe or empty still shows its text,
+   * just not as a link, and a link without text is left out. An absolute http(s) address opens in a new tab (`noopener noreferrer`, with "(opens in a new tab)" for
+   * screen readers). A `{key}` that is not in `labelLinks` stays as typed. Clicking a link follows it and does not toggle the box; clicking the rest of the label does.
+   * The checkbox's name is the whole sentence; the "required" message uses the sentence with the link texts in place of the `{key}`s. Without `labelLinks` (default) the
+   * label is plain text exactly as before.
+   */
+  readonly labelLinks: import("@angular/core").InputSignal<Record<string, CheckboxLabelLink>>;
+  /** The label as text and links, or null when the label has no `{key}` that `labelLinks` knows (then it is drawn as plain text, as before). */
+  protected readonly _labelSegments: import("@angular/core").Signal<CheckboxLabelSegment[] | null>;
+  /** The label as plain text: the link texts in place of their `{key}`s (used for the "required" message). */
+  protected readonly _plainLabel: import("@angular/core").Signal<string>;
   /** Single mode: small helper text under the label, linked to the native checkbox with `aria-describedby`. None when empty (default). */
   readonly description: import("@angular/core").InputSignal<string>;
   /** Set when the host projects a `[checkbox-trailing]` element (see `CheckboxTrailingDirective`). */
@@ -3540,6 +3744,11 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
       "required": false;
       "isSignal": true;
     };
+    "labelLinks": {
+      "alias": "labelLinks";
+      "required": false;
+      "isSignal": true;
+    };
     "description": {
       "alias": "description";
       "required": false;
@@ -4124,6 +4333,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, `''`
@@ -4436,7 +4654,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" | "primary" | "secondary" | "danger" | "warning" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "danger" | "warning" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
   /** Renders an anchor to this route instead of a button (use with `variant="link"` for an inline text link). `['/settings']` or `'/settings'`. While `disabled` or `loading` it renders a non-clickable `<span role="link" aria-disabled>` with no href (like `href`). */
   readonly routerLink: import("@angular/core").InputSignal<string | readonly unknown[] | null>;
   /** Query params of the `routerLink` (e.g. `{ section: 'deal-defaults' }`). */
@@ -4482,7 +4700,7 @@ export declare class ButtonComponent {
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
-  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
+  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -5602,7 +5820,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" | "text" | "search" | "decimal" | "email" | "tel" | "url" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
@@ -6033,6 +6251,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();
@@ -6076,6 +6298,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>;
@@ -6152,6 +6375,8 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
     };
   }, {
     "invalidChange": "invalidChange";
+    "focused": "focused";
+    "blurred": "blurred";
   }, never, ["[uiLabelEnd]"], true, never>;
 }
 export type TextSize = 'sm' | 'md' | 'lg';
@@ -6589,7 +6814,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" | "failed" | "copied">;
+  protected readonly _state: import("@angular/core").WritableSignal<"idle" | "copied" | "failed">;
   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>;
@@ -7705,7 +7930,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" | 2 | 3 | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7745,6 +7970,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
@@ -7957,7 +8189,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';
@@ -9300,13 +9532,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, …).
@@ -10721,6 +10953,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
@@ -10745,11 +10987,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: see [safeLinkHref]). */
+  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). */
@@ -10769,6 +11014,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;
@@ -11563,7 +11823,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 | 5 | 3 | 6 | 4 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 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. */
@@ -16347,7 +16607,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" | "manual" | "live" | "terminal">;
+  protected readonly kind: import("@angular/core").Signal<"none" | "live" | "terminal" | "manual">;
   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[]>;