@forgeroute/ui 0.4.77 → 0.4.78

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -2376,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<"warning" | "danger" | "primary">;
+  readonly primaryVariant: import("@angular/core").InputSignal<"primary" | "danger" | "warning">;
   readonly primaryLoading: import("@angular/core").InputSignal<boolean>;
   readonly primaryDisabled: import("@angular/core").InputSignal<boolean>;
   /** `data-testid` of the Cancel button; none when empty (default). */
@@ -2507,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" | "visible" | "auto">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "auto" | "visible">;
   /** `data-testid` of the dialog element itself (the host `<ui-modal>` is always in the page, the dialog only while open). None when empty. */
   readonly dialogTestId: import("@angular/core").InputSignal<string>;
   /** Hides the header X button (e.g. while a request is running). Escape and a backdrop click still close unless `closable` is false. */
@@ -3167,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>;
@@ -3555,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). */
@@ -3592,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`). */
@@ -3711,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;
@@ -3973,7 +4011,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<"below" | "beside">;
+  readonly labelPosition: import("@angular/core").InputSignal<"beside" | "below">;
   /** Viewport width in px below which a horizontal stepper is drawn vertical (labels beside the circles), e.g. `640`. null (default) = never. */
   readonly stackBelow: import("@angular/core").InputSignal<number | null>;
   /** CSS length (e.g. `10.5rem`): horizontal only - the list gets `min-width: calc(<step count> * <value>)`. Empty (default) = no minimum. */
@@ -4616,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" | "icon" | "warning" | "danger" | "primary" | "secondary" | "ghost" | "ghost-start" | "tab" | "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' }`). */
@@ -4662,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>;
@@ -5245,7 +5283,7 @@ export declare class BulkMessagePanelComponent {
   readonly sending: import("@angular/core").InputSignal<boolean>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly send: import("@angular/core").OutputEmitterRef<BulkMessageSendEvent>;
-  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
+  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
   private readonly _subject;
   private readonly _body;
   get subject(): string;
@@ -5773,7 +5811,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "email" | "text" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "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>;
@@ -5782,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" | "email" | "search" | "text" | "numeric" | "tel" | "url" | "decimal">;
+  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. */
@@ -5854,7 +5892,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" | "email" | "text" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -6776,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>;
@@ -7892,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, {
@@ -7972,7 +8010,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" | "radio" | "checkbox">;
+  readonly leading: import("@angular/core").InputSignal<"none" | "checkbox" | "radio">;
   /** `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). */
@@ -9114,7 +9152,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<"8px" | "6px" | "12px">;
+  protected readonly _gap: import("@angular/core").Signal<"6px" | "12px" | "8px">;
   protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
   protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
@@ -9527,7 +9565,7 @@ export declare class IconComponent {
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** Icon size in px. */
   readonly size: import("@angular/core").InputSignal<number>;
-  readonly variant: import("@angular/core").InputSignal<"default" | "danger">;
+  readonly variant: import("@angular/core").InputSignal<"danger" | "default">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /** The host is running the request this icon started: a spinner replaces the picture and the button is disabled (no click) until it is false again. */
   readonly loading: import("@angular/core").InputSignal<boolean>;
@@ -9639,7 +9677,7 @@ export declare class TimelineComponent {
   /** Any CSS length (e.g. `600px`). When set, the list scrolls inside a keyboard-focusable region of at most this height. Empty = no wrapper. */
   readonly maxHeight: import("@angular/core").InputSignal<string>;
   /** `below` (default): the time is under the title / description. `end`: the time sits right-aligned on the title row. */
-  readonly timePosition: import("@angular/core").InputSignal<"below" | "end">;
+  readonly timePosition: import("@angular/core").InputSignal<"end" | "below">;
   /**
    * Group the items under a heading per calendar day of `dateTime` ("Today", "Yesterday", "Oct 3", "Oct 3, 2025"). Default false = no headings,
    * DOM unchanged. The given order is kept: consecutive items of one day share a heading, the same day appearing again later starts a new group.
@@ -10949,7 +10987,7 @@ 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). */
+  /** 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. */
@@ -11648,7 +11686,7 @@ export declare class PdfHotspotComponent {
   /** `ready`: clickable; `blocked`: disabled (a prerequisite is missing); `signed`: shows `image`. */
   readonly state: import("@angular/core").InputSignal<"ready" | "blocked" | "signed">;
   /** `warning` gives the ready state an amber look (e.g. for initials), default is blue. */
-  readonly tone: import("@angular/core").InputSignal<"warning" | "primary">;
+  readonly tone: import("@angular/core").InputSignal<"primary" | "warning">;
   /** Text of the ready button (e.g. "Sign Here"). */
   readonly label: import("@angular/core").InputSignal<string>;
   /** Text of the blocked button (e.g. "Add signature above"). */
@@ -11799,7 +11837,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<"end" | "start">;
+  readonly footerAlign: import("@angular/core").InputSignal<"start" | "end">;
   /** Text colour as any CSS colour (`#fff`, `var(--on-dark)` …). Empty = the default colours. Colours the title, subtitle, chevron and body text. */
   readonly textColor: import("@angular/core").InputSignal<string>;
   /** false = no header at all (no title, edit button, toggle or divider): the card is only the body, always open. */
@@ -16569,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[]>;