@forgeroute/ui 0.4.76 → 0.4.77

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeroute/ui",
-  "version": "0.4.76",
+  "version": "0.4.77",
   "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. */
@@ -2352,7 +2376,7 @@ export declare class SidePanelComponent implements OnDestroy {
   readonly cancelLabel: import("@angular/core").InputSignal<string>;
   /** Right-aligned primary action button label. Empty string = hidden. */
   readonly primaryLabel: import("@angular/core").InputSignal<string>;
-  readonly primaryVariant: import("@angular/core").InputSignal<"primary" | "danger" | "warning">;
+  readonly primaryVariant: import("@angular/core").InputSignal<"warning" | "danger" | "primary">;
   readonly primaryLoading: import("@angular/core").InputSignal<boolean>;
   readonly primaryDisabled: import("@angular/core").InputSignal<boolean>;
   /** `data-testid` of the Cancel button; none when empty (default). */
@@ -2483,7 +2507,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" | "auto" | "visible">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "visible" | "auto">;
   /** `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. */
@@ -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
@@ -3397,7 +3568,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>;
   /**
@@ -3802,7 +3973,7 @@ export declare class StepperComponent {
    * 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<"beside" | "below">;
+  readonly labelPosition: import("@angular/core").InputSignal<"below" | "beside">;
   /** 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. */
@@ -4124,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, `''`
@@ -4436,7 +4616,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<"link" | "icon" | "warning" | "danger" | "primary" | "secondary" | "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' }`). */
@@ -5065,7 +5245,7 @@ export declare class BulkMessagePanelComponent {
   readonly sending: import("@angular/core").InputSignal<boolean>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly send: import("@angular/core").OutputEmitterRef<BulkMessageSendEvent>;
-  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
+  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
   private readonly _subject;
   private readonly _body;
   get subject(): string;
@@ -5593,7 +5773,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "email" | "text" | "tel" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -5602,7 +5782,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" | "email" | "search" | "text" | "numeric" | "tel" | "url" | "decimal">;
   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. */
@@ -5674,7 +5854,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly _stepAttr: import("@angular/core").Signal<string | null>;
   protected readonly _revealable: import("@angular/core").Signal<boolean>;
   protected readonly _shown: import("@angular/core").WritableSignal<boolean>;
-  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "email" | "text" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -6033,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();
@@ -6076,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>;
@@ -6152,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';
@@ -7745,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
@@ -7778,7 +7972,7 @@ export type ListItemIconColor = 'slate' | 'amber' | 'red' | 'blue' | 'green' | '
 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" | "checkbox" | "radio">;
+  readonly leading: import("@angular/core").InputSignal<"none" | "radio" | "checkbox">;
   /** `name` attribute for the radio/checkbox (groups radios together). */
   readonly inputName: import("@angular/core").InputSignal<string>;
   /** `id` attribute for the radio/checkbox (links the label). */
@@ -7957,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';
@@ -8920,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>;
@@ -9300,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, …).
@@ -9333,7 +9527,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<"danger" | "default">;
+  readonly variant: import("@angular/core").InputSignal<"default" | "danger">;
   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>;
@@ -9445,7 +9639,7 @@ export declare class TimelineComponent {
   /** Any CSS length (e.g. `600px`). When set, the list scrolls inside a keyboard-focusable region of at most this height. Empty = no wrapper. */
   readonly maxHeight: import("@angular/core").InputSignal<string>;
   /** `below` (default): the time is under the title / description. `end`: the time sits right-aligned on the title row. */
-  readonly timePosition: import("@angular/core").InputSignal<"end" | "below">;
+  readonly timePosition: import("@angular/core").InputSignal<"below" | "end">;
   /**
    * Group the items under a heading per calendar day of `dateTime` ("Today", "Yesterday", "Oct 3", "Oct 3, 2025"). Default false = no headings,
    * DOM unchanged. The given order is kept: consecutive items of one day share a heading, the same day appearing again later starts a new group.
@@ -10721,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
@@ -10745,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). */
@@ -10769,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;
@@ -11426,7 +11648,7 @@ export declare class PdfHotspotComponent {
   /** `ready`: clickable; `blocked`: disabled (a prerequisite is missing); `signed`: shows `image`. */
   readonly state: import("@angular/core").InputSignal<"ready" | "blocked" | "signed">;
   /** `warning` gives the ready state an amber look (e.g. for initials), default is blue. */
-  readonly tone: import("@angular/core").InputSignal<"primary" | "warning">;
+  readonly tone: import("@angular/core").InputSignal<"warning" | "primary">;
   /** Text of the ready button (e.g. "Sign Here"). */
   readonly label: import("@angular/core").InputSignal<string>;
   /** Text of the blocked button (e.g. "Add signature above"). */
@@ -11563,7 +11785,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. */
@@ -11577,7 +11799,7 @@ export declare class DetailCardComponent {
   /** 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">;
+  readonly footerAlign: import("@angular/core").InputSignal<"end" | "start">;
   /** Text colour as any CSS colour (`#fff`, `var(--on-dark)` …). Empty = the default colours. Colours the title, subtitle, chevron and body text. */
   readonly textColor: import("@angular/core").InputSignal<string>;
   /** false = no header at all (no title, edit button, toggle or divider): the card is only the body, always open. */