@forgeroute/ui 0.4.7 → 0.4.9

package/types/forgeroute-ui.d.ts

@@ -961,7 +961,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly error: import("@angular/core").InputSignal<string>;
   /** Reveal the built-in error messages now (e.g. after a failed Save click), without waiting for blur. */
   readonly showErrors: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "default">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -980,6 +980,8 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
   readonly errorMessage: import("@angular/core").Signal<string>;
   /** Emits whenever the field becomes invalid / valid. */
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  /** Emits the chosen value when the USER picks an option (the same value the form control receives; null for the blank option in number mode). Not emitted for values the host writes. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string | number | null>;
   protected readonly _activeError: import("@angular/core").Signal<string>;
   private _onValidatorChange;
   constructor();
@@ -1063,6 +1065,7 @@ export declare class SelectComponent implements ControlValueAccessor, Validator,
     };
   }, {
     "invalidChange": "invalidChange";
+    "valueChange": "valueChange";
   }, never, never, true, never>;
 }
 export interface ImportFieldDef {
@@ -1812,7 +1815,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). */
@@ -1906,7 +1909,7 @@ export declare class ModalComponent implements OnInit, OnDestroy {
   readonly title: import("@angular/core").InputSignal<string>;
   readonly description: import("@angular/core").InputSignal<string>;
   readonly maxWidth: import("@angular/core").InputSignal<string>;
-  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "auto" | "visible">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"auto" | "hidden" | "visible">;
   /** `data-testid` of the dialog element itself (the host `<ui-modal>` is always in the page, the dialog only while open). None when empty. */
   readonly dialogTestId: import("@angular/core").InputSignal<string>;
   /** Hides the header X button (e.g. while a request is running). Escape and a backdrop click still close unless `closable` is false. */
@@ -1988,6 +1991,12 @@ export declare class ToastService implements OnDestroy {
    * (the input wins). Escape, pause on hover / focus and `dismiss()` work either way.
    */
   readonly dismissible: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * Opt-in: every `<ui-toast>` keeps always-present live regions and renders the message inside them (reliable screen-reader
+   * announcements, VoiceOver / Safari included). Default `false`: toasts keep their own `role` exactly as before.
+   * Set once per app with `provideForgerouteToast({ persistentLiveRegion: true })`, or per outlet with `<ui-toast [persistentLiveRegion]="true" />`.
+   */
+  readonly persistentLiveRegion: import("@angular/core").WritableSignal<boolean>;
   private _timer;
   private _deadline;
   private _remaining;
@@ -2023,6 +2032,15 @@ export declare class ToastComponent {
    */
   readonly dismissible: import("@angular/core").InputSignal<boolean | null>;
   protected readonly showClose: import("@angular/core").Signal<boolean>;
+  /**
+   * Opt-in: keep two always-present live regions (polite for success / info, assertive for errors) and put the toast inside the
+   * matching one, instead of giving the toast its own role when it appears. A live region that already exists when its text
+   * changes is announced reliably by VoiceOver / Safari; one inserted together with its text often is not. `null` (default) =
+   * follow `ToastService.persistentLiveRegion` (`false` unless the app sets it with `provideForgerouteToast({ persistentLiveRegion: true })`);
+   * `true` / `false` forces it for this outlet. Off = the markup and roles are exactly as they always were.
+   */
+  readonly persistentLiveRegion: import("@angular/core").InputSignal<boolean | null>;
+  protected readonly persistent: import("@angular/core").Signal<boolean>;
   /**
    * Message that was already on screen when this instance took over from a destroyed host. While it is
    * unchanged the toast renders without the entry animation and without live-region roles, so the
@@ -2048,6 +2066,11 @@ export declare class ToastComponent {
       "required": false;
       "isSignal": true;
     };
+    "persistentLiveRegion": {
+      "alias": "persistentLiveRegion";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 export type ProgressBarVariant = 'blue' | 'green' | 'amber' | 'red' | 'slate';
@@ -2072,6 +2095,8 @@ export declare class ProgressBarComponent {
   readonly label: import("@angular/core").InputSignal<string>;
   /** Optional fixed color override. Leave it out and the color follows completion (red / amber / blue / green). */
   readonly variant: import("@angular/core").InputSignal<ProgressBarVariant | null | undefined>;
+  /** Any CSS colour for the fill (e.g. the brand colour). Wins over `variant` and the completion bands; empty = the built-in colours. (Or set `--ui-progress-fill` / `--ui-accent` once in the app to recolour the blue band.) */
+  readonly color: import("@angular/core").InputSignal<string>;
   /** Hover / focus tooltip (library `uiTooltip`); `\n` starts a new line. */
   readonly tooltip: import("@angular/core").InputSignal<string>;
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
@@ -2108,6 +2133,11 @@ export declare class ProgressBarComponent {
       "required": false;
       "isSignal": true;
     };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
     "tooltip": {
       "alias": "tooltip";
       "required": false;
@@ -2465,11 +2495,23 @@ export interface CheckboxOption {
   disabled?: boolean;
   /** `data-testid` of this option's native checkbox (e.g. for end-to-end tests); none when omitted. */
   testId?: string;
+  /** `data-testid` of this option's label text; none when omitted. */
+  labelTestId?: 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). */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** `data-testid` of the native checkbox (single mode), for end-to-end tests; none when empty. (Group options have their own `testId`.) */
+  readonly testId: import("@angular/core").InputSignal<string>;
+  /** `data-testid` of the label text (single mode), e.g. to find a product name that is also its checkbox label; none when empty. */
+  readonly labelTestId: import("@angular/core").InputSignal<string>;
+  /**
+   * 1-6 makes the label text a real heading for screen readers (`role="heading"` + `aria-level`) while it stays the checkbox's label and
+   * clicking it still toggles the box - e.g. a product name that is both the heading of its card and the label of its checkbox.
+   * Default null: plain label text, exactly as before. Single mode only.
+   */
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 5 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -2567,6 +2609,21 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
       "required": false;
       "isSignal": true;
     };
+    "testId": {
+      "alias": "testId";
+      "required": false;
+      "isSignal": true;
+    };
+    "labelTestId": {
+      "alias": "labelTestId";
+      "required": false;
+      "isSignal": true;
+    };
+    "headingLevel": {
+      "alias": "headingLevel";
+      "required": false;
+      "isSignal": true;
+    };
     "indeterminate": {
       "alias": "indeterminate";
       "required": false;
@@ -2737,6 +2794,19 @@ export interface StepperStep {
   disabled?: boolean;
   /** `true` or a message marks the step as failed ("!" indicator, red). A message string is shown under the label and announced. */
   error?: boolean | string;
+  /**
+   * Overrides the state derived from the step's position. `true` = complete (check mark, selectable with `linear`) even
+   * when the step comes after `current`; `false` = upcoming even when it comes before `current`. Omit to derive it from
+   * the order. The current step always stays current. Use it when the user can jump back and keep the progress made:
+   * mark every step the user has already completed `complete: true`.
+   */
+  complete?: boolean;
+  /**
+   * `false` = never a button, even when the step is complete and the stepper is `clickable`: it is plain text and keeps its normal look
+   * (no dimming, not announced "disabled"). Use it for a step the user has finished but may not jump back or forward to. Omitted / `true`
+   * = the normal rule (a complete step is a button when `clickable`). It cannot make an upcoming step selectable; use `linear`.
+   */
+  selectable?: boolean;
 }
 export type StepperOrientation = 'horizontal' | 'vertical';
 /**
@@ -2756,19 +2826,31 @@ export type StepperOrientation = 'horizontal' | 'vertical';
  *   steps = [{ key: 'info', label: 'Info' }, { key: 'pay', label: 'Payment', error: 'Card was declined' }, ...]
  *
  * `current` is two-way (`[(current)]`). An empty or unknown key means there is no current step: every step is upcoming
- * (and with `linear`, none is selectable). `error` changes the indicator, not the state or `aria-current`.
+ * unless it sets `complete: true`. `error` changes the indicator, not the state or `aria-current`.
+ *
+ * Per-step state: a step's `complete` flag overrides the position-derived state (see `StepperStep.complete`), so a wizard
+ * that lets the user go back can keep the steps already done marked complete:
+ *
+ *   steps = all.map((s, i) => ({ ...s, complete: i <= furthestReached }))
+ *
+ * A step with `selectable: false` is never a button (finished, but not a place to go back to) and looks normal; `disabled` is for a step
+ * that is switched off (dimmed, announced "disabled").
  *
  * Interaction (`clickable`): a selectable step is a native `<button>` (Tab / Enter / Space, visible focus ring). With
- * `linear` (default) only complete steps and the current step are selectable, so the user can go back but not skip
- * ahead; with `[linear]="false"` every non-disabled step is. Activating a selectable step other than the current one
- * sets `current` (so `[(current)]` follows) and emits `stepClick` with its key; activating the current step, or an
- * unselectable one, does nothing. Without `clickable` there are no buttons or tab stops at all.
+ * `linear` (default) only complete steps are selectable, so the user can go back but not skip ahead; with
+ * `[linear]="false"` every non-disabled step is. The current step is never a button (you are already there): it is
+ * plain text with `aria-current="step"`. Activating a selectable step sets `current` (so `[(current)]` follows) and
+ * emits `stepClick` with its key; an unselectable step does nothing. Without `clickable` there are no buttons or tab
+ * stops at all.
  *
  * Accessibility: an ordered list named by `ariaLabel`; the current step has `aria-current="step"`. Each step's name is
  * "<label>, step N of M, completed | current step | not started" (+ ", optional", ", error: <message>", ", disabled"),
  * built from visually hidden text so it is announced in the list even when the step is not a button. Indicators and
  * connectors are decorative. A description is referenced with `aria-describedby`.
  *
+ * Theming: `accentColor` / `completeColor` (any CSS colour) recolour the current step, the complete steps and the filled
+ * connectors; leave them out for the library blue. Or set `--ui-accent` (and `--ui-accent-soft`) once in the app.
+ *
  * Layout: `orientation` horizontal (row with connector lines that fill as steps complete) or vertical (column, connector
  * on the left). Long labels wrap. At <= 480px a horizontal stepper with `labelsOnSmallScreens="current"` (default) shows
  * only the current step's label (the others stay in the accessible name); `"all"` keeps them. Touch devices and phones
@@ -2785,6 +2867,12 @@ export declare class StepperComponent {
   /** With `clickable`: `true` (default) = only complete steps and the current step are selectable; `false` = any enabled step. */
   readonly linear: import("@angular/core").InputSignal<boolean>;
   readonly size: import("@angular/core").InputSignal<"sm" | "md">;
+  /** Accent colour (any CSS colour) of the current step and, unless `completeColor` is set, of complete steps and the filled connectors. Empty = the library blue (or `--ui-accent`). */
+  readonly accentColor: import("@angular/core").InputSignal<string>;
+  /** Colour (any CSS colour) of complete steps and the filled connectors, when it should differ from the current step's accent (e.g. green checks, orange current step). */
+  readonly completeColor: import("@angular/core").InputSignal<string>;
+  /** true = the current step's label is drawn in the accent colour as well as its indicator. Default false: the label keeps the dark text colour. */
+  readonly accentLabels: import("@angular/core").InputSignal<boolean>;
   /** Accessible name of the list. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** Horizontal, <= 480px: show only the current step's label (`'current'`, default) or every label (`'all'`). */
@@ -2840,6 +2928,21 @@ export declare class StepperComponent {
       "required": false;
       "isSignal": true;
     };
+    "accentColor": {
+      "alias": "accentColor";
+      "required": false;
+      "isSignal": true;
+    };
+    "completeColor": {
+      "alias": "completeColor";
+      "required": false;
+      "isSignal": true;
+    };
+    "accentLabels": {
+      "alias": "accentLabels";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -3033,6 +3136,8 @@ export interface RadioOption {
   label: string;
   description?: string;
   disabled?: boolean;
+  /** `data-testid` of this option's native radio input (e.g. for end-to-end tests); none when omitted. */
+  testId?: string;
 }
 /**
  * Group of native radio buttons inside a `<fieldset>` (+ `<legend>` = `label`), a ControlValueAccessor (string value, `''`
@@ -3343,7 +3448,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<"warning" | "danger" | "primary" | "secondary" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "ghost" | "ghost-start" | "danger" | "link" | "warning" | "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' }`). */
@@ -3358,7 +3463,7 @@ export declare class ButtonComponent {
    */
   readonly href: import("@angular/core").InputSignal<string | null>;
   /** Where to open the `href` (`_blank` = a new tab). */
-  readonly target: import("@angular/core").InputSignal<"_self" | "_blank" | "_parent" | "_top" | null>;
+  readonly target: import("@angular/core").InputSignal<"_blank" | "_self" | "_parent" | "_top" | null>;
   /** `rel` of the `href` link. A `_blank` target always gets `noopener noreferrer` added. */
   readonly rel: import("@angular/core").InputSignal<string | null>;
   /** The href when it is allowed (http, https, mailto, tel, sms or a relative URL), else null. */
@@ -3366,8 +3471,8 @@ export declare class ButtonComponent {
   protected readonly _rel: import("@angular/core").Signal<string | null>;
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
-  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "xs" | "lg">;
-  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
+  readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | "lg">;
+  readonly type: import("@angular/core").InputSignal<"button" | "submit" | "reset">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -3746,7 +3851,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;
@@ -3895,7 +4000,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
    * Meant for a short mark of 1-3 characters.
    */
   readonly prefix: import("@angular/core").InputSignal<string>;
-  readonly type: import("@angular/core").InputSignal<"number" | "tel" | "email" | "text" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "text" | "tel" | "email" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -3904,7 +4009,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<"" | "tel" | "email" | "none" | "text" | "search" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "tel" | "search" | "email" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
@@ -3936,6 +4041,8 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly formatter: import("@angular/core").InputSignal<((raw: string) => string) | undefined>;
   /** 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>;
+  /** Emits the new value when the USER changes it (typing, paste, autofill) - the same value the form control receives. Not emitted for values the host writes. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string | number | null>;
   readonly focused: import("@angular/core").OutputEmitterRef<void>;
   readonly blurred: import("@angular/core").OutputEmitterRef<void>;
   /** Emits whenever the field becomes invalid / valid. */
@@ -4096,6 +4203,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
       "isSignal": true;
     };
   }, {
+    "valueChange": "valueChange";
     "focused": "focused";
     "blurred": "blurred";
     "invalidChange": "invalidChange";
@@ -4230,7 +4338,8 @@ export declare class TextareaInputComponent implements ControlValueAccessor, Val
   }, never, never, true, never>;
 }
 export type TextSize = 'sm' | 'md' | 'lg';
-export type TextTone = 'default' | 'muted';
+export type TextTone = 'default' | 'muted' | 'accent';
+export type TextWeight = 'normal' | 'medium' | 'semibold' | 'bold';
 /**
  * Plain text that keeps its line breaks: a note, a message, an address, a pasted block. It is page content, not a form control —
  * no tab stop, no resize handle, selectable and copyable, and read normally by screen readers (including browse mode).
@@ -4242,13 +4351,32 @@ export type TextTone = 'default' | 'muted';
  * stretching the layout. The text is never interpreted as HTML. Pass the text through `[text]` (not as projected content),
  * so the template's own indentation can never leak into it. An empty or missing text renders nothing.
  *
- * Inputs: `text`, `size` (sm 0.8125rem | md 0.875rem | lg 1rem, default md), `tone` (default slate | muted grey).
+ * Inline emphasis without HTML: `strong` (a string or a list of strings) makes every occurrence of those exact snippets bold
+ * (case-sensitive, longest first, never overlapping), e.g. `<ui-text text="Delivered to 12 Oak St, Peoria" strong="12 Oak St, Peoria" />`.
+ * The text is still never parsed as HTML; `textContent` is unchanged (the snippets are wrapped in `<strong>`). Without `strong` the
+ * markup is exactly what it always was.
+ *
+ * Inputs: `text`, `size` (sm 0.8125rem | md 0.875rem | lg 1rem, default md), `tone` (default slate | muted grey),
+ * `weight` (normal | medium 500 | semibold 600 | bold 700, default normal - no font-weight is set, so the text is exactly as before;
+ * use bold for a total such as "Balance Due").
  */
 export declare class TextComponent {
   /** The text to show. Line breaks are kept; it is never parsed as HTML. */
   readonly text: import("@angular/core").InputSignal<string | null | undefined>;
   readonly size: import("@angular/core").InputSignal<TextSize>;
   readonly tone: import("@angular/core").InputSignal<TextTone>;
+  /** Any CSS colour for the text (e.g. the brand colour). Wins over `tone`; empty = the tone's colour. `tone="accent"` uses `--ui-accent` (default blue). */
+  readonly color: import("@angular/core").InputSignal<string>;
+  /** Snippet(s) of `text` to show in bold. Empty / not found = no change. */
+  readonly strong: import("@angular/core").InputSignal<string | string[] | null | undefined>;
+  /** The text cut into plain and bold pieces; empty when nothing is to be bold (then the text renders as a single text node). */
+  protected readonly segments: import("@angular/core").Signal<{
+    text: string;
+    strong: boolean;
+  }[]>;
+  /** normal (default) | medium | semibold | bold. Normal sets nothing, so existing text is unchanged. */
+  readonly weight: import("@angular/core").InputSignal<TextWeight>;
+  protected readonly fontWeight: import("@angular/core").Signal<string | null>;
   protected readonly fontSize: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<TextComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<TextComponent, "ui-text", never, {
@@ -4267,6 +4395,21 @@ export declare class TextComponent {
       "required": false;
       "isSignal": true;
     };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
+    "strong": {
+      "alias": "strong";
+      "required": false;
+      "isSignal": true;
+    };
+    "weight": {
+      "alias": "weight";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, never, true, never>;
 }
 /** Why a chosen file was refused. */
@@ -4584,6 +4727,8 @@ export declare class DateInputComponent implements ControlValueAccessor, Validat
   readonly errorMessage: import("@angular/core").Signal<string>;
   /** Emits whenever the field becomes invalid / valid. */
   readonly invalidChange: import("@angular/core").OutputEmitterRef<boolean>;
+  /** Emits the new value ('YYYY-MM-DD', or '' when cleared) when the USER changes it - the same value the form control receives. Not emitted for values the host writes. */
+  readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
   protected readonly _activeError: import("@angular/core").Signal<string>;
   private _onValidatorChange;
   constructor();
@@ -4645,6 +4790,7 @@ export declare class DateInputComponent implements ControlValueAccessor, Validat
     };
   }, {
     "invalidChange": "invalidChange";
+    "valueChange": "valueChange";
   }, never, never, true, never>;
 }
 export declare class DatetimeInputComponent implements ControlValueAccessor, Validator, UiFieldValidity {
@@ -5231,7 +5377,7 @@ export declare class DropdownComponent {
   readonly loader: import("@angular/core").InputSignal<(() => Promise<DropdownItem[]>) | null>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly activeValue: import("@angular/core").InputSignal<string>;
-  readonly variant: import("@angular/core").InputSignal<"badge" | "button">;
+  readonly variant: import("@angular/core").InputSignal<"button" | "badge">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
   /**
    * Accessible name. Set it when the trigger has no meaningful visible text. Applied as `aria-label` on the
@@ -5327,6 +5473,55 @@ export declare class DropdownComponent {
     "itemClick": "itemClick";
   }, never, never, true, never>;
 }
+/**
+ * A real `<form>` for a group of library fields, so the browser (and assistive tech) treats it as one: it is announced as a
+ * "form" landmark when it has a name, and pressing Enter in a field submits it through a `ui-button type="submit"`. Apps do not write
+ * a native `<form>`; they use this.
+ *
+ *   <ui-form ariaLabel="Informant contact details" (submitted)="save()">
+ *     <ui-text-input label="Name" [(ngModel)]="name" />
+ *     <ui-button type="submit">Save</ui-button>
+ *   </ui-form>
+ *
+ * Works with Reactive Forms: `<ui-form [formGroup]="form" ariaLabel="..." (ngSubmit)="save()">` (the `submit` event of the inner
+ * form bubbles to the host, which is what `FormGroupDirective` listens to; it also stops the page from reloading).
+ *
+ *  - `ariaLabel` (or `ariaLabelledby`): the form's name. A named form is a landmark, so give it one only for a main form of the page.
+ *  - The browser's own validation bubbles are off (`novalidate`): library inputs show their own messages.
+ *  - `submitted` emits the submit event after the default action (a page reload) was prevented.
+ *  - Layout: the host is a block and the form inside is a plain block - it adds no spacing; put a `ui-stack` / `ui-form-section` inside.
+ */
+export declare class FormComponent {
+  /** The form's accessible name. Empty = unnamed (no landmark). */
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** Id of an element that names the form (wins over `ariaLabel`). */
+  readonly ariaLabelledby: import("@angular/core").InputSignal<string>;
+  /** Browser autofill for the whole form: 'on' | 'off'. Empty = the browser default. */
+  readonly autocomplete: import("@angular/core").InputSignal<"" | "off" | "on">;
+  /** Emits the submit event (Enter in a field, or a submit button). The page is never reloaded. */
+  readonly submitted: import("@angular/core").OutputEmitterRef<Event>;
+  protected onSubmit(event: Event): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<FormComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<FormComponent, "ui-form", never, {
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabelledby": {
+      "alias": "ariaLabelledby";
+      "required": false;
+      "isSignal": true;
+    };
+    "autocomplete": {
+      "alias": "autocomplete";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "submitted": "submitted";
+  }, never, ["*"], true, never>;
+}
 export declare class FormSectionComponent {
   readonly label: import("@angular/core").InputSignal<string>;
   readonly divider: import("@angular/core").InputSignal<boolean>;
@@ -5362,7 +5557,7 @@ export declare class FormRowComponent {
  * child simply takes the full width. Keep a numeric span within the row's `cols` (use `all` for the whole row).
  */
 export declare class FormColSpanDirective {
-  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | 3 | "2" | "3" | "all">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | 3 | "all" | "2" | "3">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -5521,12 +5716,14 @@ export declare class ListItemComponent {
  *
  *   providers: [provideForgerouteToast()]
  *   providers: [provideForgerouteToast({ dismissible: true })]   // every toast also gets a close button (default: none)
+ *   providers: [provideForgerouteToast({ persistentLiveRegion: true })]   // always-present live regions: reliable announcements in VoiceOver / Safari
  *
  * It is created first, so it is the registry's host and any other `<ui-toast>` (a table's own, a shell's) stays silent: each
  * message renders and is announced once. Nothing happens on the server. The outlet is destroyed with the app.
  */
 export declare function provideForgerouteToast(options?: {
   dismissible?: boolean;
+  persistentLiveRegion?: boolean;
 }): EnvironmentProviders;
 /** Payload of `(reorder)`. Apply it with `reorderItems(items, order)` or take the ready-made `items`. */
 export interface ListReorderEvent<T = unknown> {
@@ -5941,6 +6138,10 @@ export interface PanelInfoItem {
   muted?: boolean;
   danger?: boolean;
   hidden?: boolean;
+  /** Keep the line breaks of `value` (an address, a note); long lines still wrap. Plain values only. */
+  multiline?: boolean;
+  /** Bold row: the label and the value in the strong text colour and weight (a total, a balance due). */
+  emphasis?: boolean;
 }
 export interface PanelInfoSection {
   title?: string;
@@ -6091,12 +6292,12 @@ export declare class ChipGroupComponent {
   /** Space between each chip. */
   readonly gap: import("@angular/core").InputSignal<"sm" | "md" | "lg">;
   /** Space above the chip group. */
-  readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
+  readonly spaceAbove: import("@angular/core").InputSignal<"sm" | "md" | "none">;
   /** 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 _spaceAbove: import("@angular/core").Signal<"0" | "6px" | "12px">;
-  protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "6px" | "12px">;
+  readonly spaceBelow: import("@angular/core").InputSignal<"sm" | "md" | "none">;
+  protected readonly _gap: import("@angular/core").Signal<"12px" | "6px" | "8px">;
+  protected readonly _spaceAbove: import("@angular/core").Signal<"0" | "12px" | "6px">;
+  protected readonly _spaceBelow: import("@angular/core").Signal<"0" | "12px" | "6px">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<ChipGroupComponent, "ui-chip-group", never, {
     "gap": {
@@ -6342,6 +6543,12 @@ export declare class AlertComponent {
   readonly quiet: import("@angular/core").InputSignal<boolean>;
   /** Tighter padding and a slightly smaller font, for an alert that is one row of a list. */
   readonly compact: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Inline body: the projected content flows as ONE line of text (wrapping normally) instead of a row of separate items, so inline
+   * emphasis (`<strong>`), links and a small `ui-icon` stay inside the sentence: `<ui-alert [inline]="true">Delivered to <strong>12 Oak St</strong>.</ui-alert>`.
+   * Default false: the body is a flex row with a gap, exactly as before (use it for text plus a button).
+   */
+  readonly inline: import("@angular/core").InputSignal<boolean>;
   readonly dismissed: import("@angular/core").OutputEmitterRef<void>;
   static ɵfac: i0.ɵɵFactoryDeclaration<AlertComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<AlertComponent, "ui-alert", never, {
@@ -6370,6 +6577,11 @@ export declare class AlertComponent {
       "required": false;
       "isSignal": true;
     };
+    "inline": {
+      "alias": "inline";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "dismissed": "dismissed";
   }, never, ["*"], true, never>;
@@ -6377,7 +6589,7 @@ export declare class AlertComponent {
 /** 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' | 'arrow-up' | 'arrow-down' | 'arrow-right' | 'document' | 'grip' | 'card' | 'bank' | 'view' | 'edit' | 'delete' | 'download' | 'duplicate' | 'archive' | 'restore' | 'share' | 'email' | 'message' | 'call';
+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' | 'edit' | 'delete' | 'download' | 'duplicate' | 'archive' | 'restore' | 'share' | 'email' | 'message' | 'call';
 /**
  * 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, …).
@@ -6404,7 +6616,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>;
@@ -6514,7 +6726,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">;
   /** Solid dot colour of an item's `dotVariant`, or null (then `tone` colours it). */
   dotColor(item: TimelineItem): string | null;
   static ɵfac: i0.ɵɵFactoryDeclaration<TimelineComponent, never>;
@@ -6642,6 +6854,304 @@ export declare class ImagePreviewComponent {
     };
   }, {}, never, never, true, never>;
 }
+export type ImageFit = 'contain' | 'cover' | 'fill' | 'scale-down';
+export type ImageRadius = 'none' | 'sm' | 'md' | 'lg' | 'full';
+export type ImageAlign = 'start' | 'center' | 'end';
+/**
+ * A content image of any size (a logo, a product photo, a banner) - the bigger sibling of `ui-image-preview`, which is a
+ * small fixed-size thumbnail. The whole image is shown (`fit="contain"`) unless you ask for `cover`.
+ *
+ *   <ui-image src="/logo.png" alt="Peaceful Pines Crematory" maxHeight="48px" />             <!-- natural size, capped -->
+ *   <ui-image [src]="p.imageUrl" [alt]="p.name" width="100%" aspectRatio="4 / 3" radius="md" [bordered]="true" />
+ *   <ui-image [src]="hero" alt="" fit="cover" width="100%" height="200px" [priority]="true" />
+ *
+ *  - `alt`: required for meaningful images; '' (default) marks it decorative. The placeholder is `role="img"` named by `alt`
+ *    (or hidden when decorative).
+ *  - Size: `width` / `height` (CSS lengths, e.g. "200px", "100%") fix the box and the image fills it per `fit`; without them
+ *    the image keeps its natural size, capped by `maxWidth` (default 100%) and `maxHeight`. `aspectRatio` ("4 / 3", "1")
+ *    reserves the space before the image loads so the page does not jump.
+ *  - `radius` none | sm | md | lg | full, `bordered`, `align` (start | center | end, for an image narrower than its row).
+ *  - `placeholder` (default true): a neutral icon in the same box when there is no `src` or it fails to load. false renders nothing then.
+ *  - `priority`: above-the-fold image - loads eagerly with high fetch priority. Otherwise `loading="lazy"` and async decoding.
+ *  - Outputs `loaded` and `failed`. A new `src` (or a changed `retryKey`) gets a fresh chance to load.
+ */
+export declare class ImageComponent {
+  /** Image URL (or data URL). Blank shows the placeholder. */
+  readonly src: import("@angular/core").InputSignal<string | null | undefined>;
+  /** Alt text; '' (default) marks the image decorative. */
+  readonly alt: import("@angular/core").InputSignal<string>;
+  readonly fit: import("@angular/core").InputSignal<ImageFit>;
+  /** CSS width of the box (e.g. "200px", "100%"). Empty = natural width. */
+  readonly width: import("@angular/core").InputSignal<string>;
+  /** CSS height of the box. Empty = natural height. */
+  readonly height: import("@angular/core").InputSignal<string>;
+  readonly maxWidth: import("@angular/core").InputSignal<string>;
+  readonly maxHeight: import("@angular/core").InputSignal<string>;
+  /** Minimum height of the image box (any CSS length). Empty = none. */
+  readonly minHeight: import("@angular/core").InputSignal<string>;
+  /** CSS aspect-ratio, e.g. "4 / 3". Reserves the space while the image loads. */
+  readonly aspectRatio: import("@angular/core").InputSignal<string>;
+  readonly radius: import("@angular/core").InputSignal<ImageRadius>;
+  readonly bordered: import("@angular/core").InputSignal<boolean>;
+  readonly align: import("@angular/core").InputSignal<ImageAlign>;
+  /** Show a neutral placeholder when there is no usable image. false = render nothing. */
+  readonly placeholder: import("@angular/core").InputSignal<boolean>;
+  /** Above-the-fold image: eager loading with high fetch priority. */
+  readonly priority: import("@angular/core").InputSignal<boolean>;
+  /** Bump to retry a failed image with the same `src`. */
+  readonly retryKey: import("@angular/core").InputSignal<unknown>;
+  readonly loaded: import("@angular/core").OutputEmitterRef<void>;
+  readonly failed: import("@angular/core").OutputEmitterRef<void>;
+  protected readonly _failed: import("@angular/core").WritableSignal<boolean>;
+  protected readonly _url: import("@angular/core").Signal<string | null>;
+  protected readonly radiusCss: import("@angular/core").Signal<string>;
+  protected readonly imgWidth: import("@angular/core").Signal<string | null>;
+  protected readonly imgHeight: import("@angular/core").Signal<string | null>;
+  /** The placeholder needs a real box when the caller gave none. */
+  protected readonly boxWidth: import("@angular/core").Signal<string | null>;
+  protected readonly boxHeight: import("@angular/core").Signal<string | null>;
+  protected readonly isBlock: import("@angular/core").Signal<boolean>;
+  constructor();
+  protected _onError(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ImageComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ImageComponent, "ui-image", never, {
+    "src": {
+      "alias": "src";
+      "required": false;
+      "isSignal": true;
+    };
+    "alt": {
+      "alias": "alt";
+      "required": false;
+      "isSignal": true;
+    };
+    "fit": {
+      "alias": "fit";
+      "required": false;
+      "isSignal": true;
+    };
+    "width": {
+      "alias": "width";
+      "required": false;
+      "isSignal": true;
+    };
+    "height": {
+      "alias": "height";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxWidth": {
+      "alias": "maxWidth";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxHeight": {
+      "alias": "maxHeight";
+      "required": false;
+      "isSignal": true;
+    };
+    "minHeight": {
+      "alias": "minHeight";
+      "required": false;
+      "isSignal": true;
+    };
+    "aspectRatio": {
+      "alias": "aspectRatio";
+      "required": false;
+      "isSignal": true;
+    };
+    "radius": {
+      "alias": "radius";
+      "required": false;
+      "isSignal": true;
+    };
+    "bordered": {
+      "alias": "bordered";
+      "required": false;
+      "isSignal": true;
+    };
+    "align": {
+      "alias": "align";
+      "required": false;
+      "isSignal": true;
+    };
+    "placeholder": {
+      "alias": "placeholder";
+      "required": false;
+      "isSignal": true;
+    };
+    "priority": {
+      "alias": "priority";
+      "required": false;
+      "isSignal": true;
+    };
+    "retryKey": {
+      "alias": "retryKey";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "loaded": "loaded";
+    "failed": "failed";
+  }, never, never, true, never>;
+}
+/** One picture of a `ui-image-gallery`. */
+export interface GalleryImage {
+  src: string;
+  /** Alt text of this picture. Defaults to "Image N of M". */
+  alt?: string;
+}
+/**
+ * Image gallery (a "slideshow"): one large picture with previous / next buttons, a counter and dots. Put it inside a
+ * `ui-modal` for a lightbox, or inline on a page.
+ *
+ *   <ui-image-gallery [images]="[{ src: a, alt: 'Front' }, { src: b, alt: 'Side' }]" [(index)]="i" ariaLabel="Photos of the urn" />
+ *
+ *  - `images`: the pictures. With a single picture there are no buttons, counter or dots.
+ *  - `index` (two-way, default 0): the shown picture; values outside the list are clamped.
+ *  - `loop` (default true): Next after the last goes to the first, Previous before the first to the last. false disables
+ *    the button at either end.
+ *  - `showDots` / `showCounter` (default true), `aspectRatio` (default "4 / 3"), `maxHeight` (default "70vh"), `fit` (default contain).
+ *  - Keyboard: with focus inside the gallery, ArrowLeft / ArrowRight (and Home / End) change the picture. The picture
+ *    change is announced ("Image 2 of 5: <alt>") through an always-present live region.
+ *  - Accessibility: a labelled group (`ariaLabel`, default "Image gallery") described as a carousel; the buttons are named
+ *    "Previous image" / "Next image"; each dot is a button "Show image N of M" with `aria-current` on the shown one.
+ */
+export declare class ImageGalleryComponent {
+  readonly images: import("@angular/core").InputSignal<GalleryImage[]>;
+  /** Shown picture (0-based). Two-way. */
+  readonly index: import("@angular/core").ModelSignal<number>;
+  readonly loop: import("@angular/core").InputSignal<boolean>;
+  readonly showDots: import("@angular/core").InputSignal<boolean>;
+  readonly showCounter: import("@angular/core").InputSignal<boolean>;
+  readonly aspectRatio: import("@angular/core").InputSignal<string>;
+  readonly maxHeight: import("@angular/core").InputSignal<string>;
+  readonly fit: import("@angular/core").InputSignal<"contain" | "cover">;
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /**
+   * true = when the gallery sits in a `ui-modal`, the dialog opens with focus on the gallery's "Next image" button (or "Previous image" when
+   * Next is disabled at the last picture of a non-looping gallery), so the arrow keys work at once without a Tab. With a single picture there are
+   * no buttons, so the dialog keeps its normal initial focus. Default false: unchanged.
+   */
+  readonly autofocus: import("@angular/core").InputSignal<boolean>;
+  protected readonly count: import("@angular/core").Signal<number>;
+  /** `index` clamped into the list. */
+  protected readonly position: import("@angular/core").Signal<number>;
+  protected readonly current: import("@angular/core").Signal<GalleryImage>;
+  protected readonly currentAlt: import("@angular/core").Signal<string>;
+  protected readonly autofocusNext: import("@angular/core").Signal<boolean>;
+  protected readonly autofocusPrev: import("@angular/core").Signal<boolean>;
+  protected readonly canPrev: import("@angular/core").Signal<boolean>;
+  protected readonly canNext: import("@angular/core").Signal<boolean>;
+  protected readonly announcement: import("@angular/core").Signal<string>;
+  prev(): void;
+  next(): void;
+  go(i: number): void;
+  protected onKey(e: KeyboardEvent): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<ImageGalleryComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<ImageGalleryComponent, "ui-image-gallery", never, {
+    "images": {
+      "alias": "images";
+      "required": false;
+      "isSignal": true;
+    };
+    "index": {
+      "alias": "index";
+      "required": false;
+      "isSignal": true;
+    };
+    "loop": {
+      "alias": "loop";
+      "required": false;
+      "isSignal": true;
+    };
+    "showDots": {
+      "alias": "showDots";
+      "required": false;
+      "isSignal": true;
+    };
+    "showCounter": {
+      "alias": "showCounter";
+      "required": false;
+      "isSignal": true;
+    };
+    "aspectRatio": {
+      "alias": "aspectRatio";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxHeight": {
+      "alias": "maxHeight";
+      "required": false;
+      "isSignal": true;
+    };
+    "fit": {
+      "alias": "fit";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "autofocus": {
+      "alias": "autofocus";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "index": "indexChange";
+  }, never, never, true, never>;
+}
+export type LiveRegionPoliteness = 'polite' | 'assertive';
+/**
+ * A screen-reader announcement area. The element is always in the DOM and only its text changes, which is what makes
+ * assistive tech (VoiceOver / Safari included) announce reliably - a live region that is inserted together with its text
+ * often is not announced.
+ *
+ *   <ui-live-region [message]="announcement()" />                          <!-- "Step 3 of 5: Deceased" -->
+ *   <ui-live-region [message]="error()" politeness="assertive" />          <!-- role="alert" -->
+ *   <ui-live-region [message]="status()" [visible]="true" />               <!-- also shown on screen -->
+ *
+ * By default it is visually hidden (still read aloud). `politeness` "polite" (default, `role="status"`) waits for the
+ * user to be idle; "assertive" (`role="alert"`) interrupts. `atomic` (default true) reads the whole message again when it
+ * changes. Set the message to '' to clear it. Announcing the same text twice in a row needs a different message in
+ * between (for example clear it first); screen readers ignore an unchanged region.
+ */
+export declare class LiveRegionComponent {
+  /** The text to announce. */
+  readonly message: import("@angular/core").InputSignal<string>;
+  readonly politeness: import("@angular/core").InputSignal<LiveRegionPoliteness>;
+  /** Read the whole message (not just the changed part) when it changes. */
+  readonly atomic: import("@angular/core").InputSignal<boolean>;
+  /** Show the text on screen too. Default false: visually hidden, still announced. */
+  readonly visible: import("@angular/core").InputSignal<boolean>;
+  protected readonly role: import("@angular/core").Signal<"status" | "alert">;
+  static ɵfac: i0.ɵɵFactoryDeclaration<LiveRegionComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<LiveRegionComponent, "ui-live-region", never, {
+    "message": {
+      "alias": "message";
+      "required": false;
+      "isSignal": true;
+    };
+    "politeness": {
+      "alias": "politeness";
+      "required": false;
+      "isSignal": true;
+    };
+    "atomic": {
+      "alias": "atomic";
+      "required": false;
+      "isSignal": true;
+    };
+    "visible": {
+      "alias": "visible";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
 /**
  * Inline field error for controls that have no `error` input of their own — e.g. an app-specific
  * picker. Renders exactly like the library inputs' own field error (small red text under the field,
@@ -7038,6 +7548,8 @@ export declare class RadioComponent {
   readonly description: import("@angular/core").InputSignal<string>;
   /** Accessible name when there is no visible `label`. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** `data-testid` of the native radio input; none when empty. */
+  readonly testId: import("@angular/core").InputSignal<string>;
   readonly value: import("@angular/core").InputSignal<string>;
   /** Radios with the same `name` form one keyboard (arrow key) group. */
   readonly name: import("@angular/core").InputSignal<string>;
@@ -7079,6 +7591,11 @@ export declare class RadioComponent {
       "required": false;
       "isSignal": true;
     };
+    "testId": {
+      "alias": "testId";
+      "required": false;
+      "isSignal": true;
+    };
     "value": {
       "alias": "value";
       "required": false;
@@ -7487,7 +8004,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"). */
@@ -7580,7 +8097,11 @@ export declare class PdfHotspotComponent {
  *  - `<div card-header-leading>`: something before the title block, such as a logo or an icon.
  *  - `<ng-container card-header>`: your own header content, shown under the title (or instead of it when no title is set).
  *  - `<ng-container card-header-action>`: buttons or links on the right side of the header.
- *  - `showEdit` + `editLabel` + `(editClick)`: the built-in Edit button.
+ *  - `showEdit` + `editLabel` + `(editClick)`: the built-in Edit button. `editAriaLabel` gives it a longer accessible name
+ *    ("Edit informant information") when the visible label alone is ambiguous; it should contain the visible label.
+ *  - `fill`: the card stretches to the height of its container (a grid cell or flex item) and its body grows, so cards in
+ *    one row end at the same height; the default card is only as tall as its content.
+ *    Use it in grid / flex cells: the spacing between cells comes from the gap, so a filled card's margin-bottom is 0 (the default card keeps 16px).
  *  - `background`: the card's background colour (any CSS colour; default white).
  *  - `textColor`: the colour of the title, subtitle, chevron and body text (any CSS colour; default: the normal slate colours). Use it for light text on a dark `background`. Text you colour yourself inside the body keeps its own colour.
  *  - The body has built-in padding (16px 18px, matching the header's 18px side padding); there is no padding input.
@@ -7605,7 +8126,7 @@ export declare class DetailCardComponent {
   /** true (default) = the title is displayed in capitals (CSS only); false = shown as written. The text, aria-label and heading name are never changed. */
   readonly uppercaseTitle: import("@angular/core").InputSignal<boolean>;
   /** 1-6 makes the title a real heading for screen readers (role=heading, aria-level); null keeps it plain text. */
-  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 3 | 4 | 6 | 5 | 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. */
@@ -7626,6 +8147,14 @@ export declare class DetailCardComponent {
   readonly showEdit: import("@angular/core").InputSignal<boolean>;
   readonly editLabel: import("@angular/core").InputSignal<string>;
   readonly editClick: import("@angular/core").OutputEmitterRef<void>;
+  /** `data-testid` of the built-in Edit button (on the `ui-button` host); none when empty. */
+  readonly editTestId: import("@angular/core").InputSignal<string>;
+  /** false = no pencil icon in the Edit button (text only). Default true: unchanged. */
+  readonly editIcon: import("@angular/core").InputSignal<boolean>;
+  /** Accessible name of the Edit button, e.g. "Edit informant information". Empty = the visible `editLabel`. */
+  readonly editAriaLabel: import("@angular/core").InputSignal<string>;
+  /** true = the card fills the height of its container (a grid cell / flex item) so sibling cards line up; the body grows. Spacing between cells comes from the gap: the filled card's margin-bottom is 0. Default false: unchanged. */
+  readonly fill: import("@angular/core").InputSignal<boolean>;
   /** The group's aria-label: the visible title (unless `titleId` names the card instead), else `ariaLabel`, else none. */
   groupLabel(): string | null;
   /** The body is open unless the card has a header that is collapsible and was collapsed. */
@@ -7700,6 +8229,26 @@ export declare class DetailCardComponent {
       "required": false;
       "isSignal": true;
     };
+    "editTestId": {
+      "alias": "editTestId";
+      "required": false;
+      "isSignal": true;
+    };
+    "editIcon": {
+      "alias": "editIcon";
+      "required": false;
+      "isSignal": true;
+    };
+    "editAriaLabel": {
+      "alias": "editAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "fill": {
+      "alias": "fill";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "expanded": "expandedChange";
     "editClick": "editClick";
@@ -8119,6 +8668,12 @@ export type ColumnsAlign = 'start' | 'center' | 'stretch';
  *  - `collapseAt`: sm (480px) | md (768px) | lg (1024px) | never. Below that viewport width the columns become one.
  *    Plain media queries are used (not container queries) because they behave the same in every supported browser.
  *  - `align`: start | center | stretch (default start) - how cells of different heights line up.
+ *  - Responsive tiers (optional): `countBelowLg` (viewport <= 1024px), `countBelowMd` (<= 768px) and `countBelowSm` (<= 480px)
+ *    give a different column count (1-4) at narrower widths. Each tier falls back to the next wider one, then to `count`, so
+ *    a grid that sets none of them is unchanged. `collapseAt` is applied last: a width at or below it is one column.
+ *    A product grid of 1 column on phones, 2 on tablets and 3 on desktop:
+ *      <ui-columns [count]="3" [countBelowLg]="2" collapseAt="md" gap="md"> ... </ui-columns>
+ *    The same grid with 2 columns from phone width up (no stacking): `[count]="3" [countBelowLg]="2" collapseAt="never"`.
  *
  *   <ui-columns>
  *     <ui-form-section label="Email"> ... </ui-form-section>
@@ -8131,7 +8686,32 @@ export declare class ColumnsComponent {
   readonly gap: import("@angular/core").InputSignal<string>;
   readonly collapseAt: import("@angular/core").InputSignal<ColumnsCollapse>;
   readonly align: import("@angular/core").InputSignal<ColumnsAlign>;
+  /** Column count at viewport widths <= 1024px (falls back to `count`). */
+  readonly countBelowLg: import("@angular/core").InputSignal<ColumnsCount | null>;
+  /** Column count at <= 768px (falls back to `countBelowLg`, then `count`). */
+  readonly countBelowMd: import("@angular/core").InputSignal<ColumnsCount | null>;
+  /** Column count at <= 480px (falls back to `countBelowMd`, then `countBelowLg`, then `count`). */
+  readonly countBelowSm: import("@angular/core").InputSignal<ColumnsCount | null>;
+  /**
+   * Mobile-first alternative to `count` + `countBelow*`: `countBase` columns on the narrowest screens (default 1), then `countFromSm` from 480px,
+   * `countFromMd` from 768px, `countFromLg` from 1024px (min-width, inclusive; each tier falls back to the next narrower one). Setting any `countFrom*`
+   * switches the grid to this mode: `count`, `countBelow*` and `collapseAt` are then ignored. Unset = unchanged.
+   *   <ui-columns [countFromMd]="2" [countFromLg]="3"> ... </ui-columns>     <!-- 1 column, 2 from 768px, 3 from 1024px -->
+   */
+  readonly countBase: import("@angular/core").InputSignal<ColumnsCount>;
+  readonly countFromSm: import("@angular/core").InputSignal<ColumnsCount | null>;
+  readonly countFromMd: import("@angular/core").InputSignal<ColumnsCount | null>;
+  readonly countFromLg: import("@angular/core").InputSignal<ColumnsCount | null>;
   protected readonly cols: import("@angular/core").Signal<ColumnsCount>;
+  private static clampTier;
+  protected readonly colsLg: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly colsMd: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly colsSm: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly fromMode: import("@angular/core").Signal<boolean>;
+  protected readonly base: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly fromSm: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly fromMd: import("@angular/core").Signal<ColumnsCount | null>;
+  protected readonly fromLg: import("@angular/core").Signal<ColumnsCount | null>;
   protected readonly gapCss: import("@angular/core").Signal<string>;
   protected readonly collapseClass: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<ColumnsComponent, never>;
@@ -8156,6 +8736,41 @@ export declare class ColumnsComponent {
       "required": false;
       "isSignal": true;
     };
+    "countBelowLg": {
+      "alias": "countBelowLg";
+      "required": false;
+      "isSignal": true;
+    };
+    "countBelowMd": {
+      "alias": "countBelowMd";
+      "required": false;
+      "isSignal": true;
+    };
+    "countBelowSm": {
+      "alias": "countBelowSm";
+      "required": false;
+      "isSignal": true;
+    };
+    "countBase": {
+      "alias": "countBase";
+      "required": false;
+      "isSignal": true;
+    };
+    "countFromSm": {
+      "alias": "countFromSm";
+      "required": false;
+      "isSignal": true;
+    };
+    "countFromMd": {
+      "alias": "countFromMd";
+      "required": false;
+      "isSignal": true;
+    };
+    "countFromLg": {
+      "alias": "countFromLg";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, ["*"], true, never>;
 }
 export type StackDirection = 'vertical' | 'horizontal';
@@ -8188,6 +8803,10 @@ export declare class StackComponent {
   readonly align: import("@angular/core").InputSignal<StackAlign>;
   readonly justify: import("@angular/core").InputSignal<StackJustify>;
   readonly wrap: import("@angular/core").InputSignal<boolean>;
+  /** Minimum height of the stack (any CSS length, e.g. "12rem"); with `justify="center"` it centres the content vertically. Empty = none. */
+  readonly minHeight: import("@angular/core").InputSignal<string>;
+  /** Width of the stack (any CSS length or "100%"). Empty = the normal block width. */
+  readonly width: import("@angular/core").InputSignal<string>;
   protected readonly gapCss: import("@angular/core").Signal<string>;
   protected readonly alignCss: import("@angular/core").Signal<string>;
   protected readonly justifyCss: import("@angular/core").Signal<string>;
@@ -8218,6 +8837,16 @@ export declare class StackComponent {
       "required": false;
       "isSignal": true;
     };
+    "minHeight": {
+      "alias": "minHeight";
+      "required": false;
+      "isSignal": true;
+    };
+    "width": {
+      "alias": "width";
+      "required": false;
+      "isSignal": true;
+    };
   }, {}, never, ["*"], true, never>;
 }
 export type ActionBarAlign = 'start' | 'center' | 'end' | 'between';
@@ -8292,4 +8921,370 @@ export declare class ActionBarComponent {
       "isSignal": true;
     };
   }, {}, never, ["*"], true, never>;
-}
+}
+/** Pure date helpers for `ui-calendar`. Dates are plain `YYYY-MM-DD` strings and times `HH:mm`; nothing here parses a non-ISO string. */
+type CalendarViewMode = 'month' | 'week' | 'agenda';
+interface CalendarDay {
+  dateStr: string;
+  dayNum: number;
+  isToday: boolean;
+  isCurrentMonth: boolean;
+  isWeekend: boolean;
+}
+interface CalendarRange {
+  view: CalendarViewMode;
+  /** First visible date, `YYYY-MM-DD`. */
+  start: string;
+  /** Last visible date (inclusive), `YYYY-MM-DD`. */
+  end: string;
+  /** The date the view is anchored on. */
+  anchor: Date;
+}
+declare const WEEK_DAY_LABELS: string[];
+declare function toDateStr(d: Date): string;
+/** `YYYY-MM-DD` → local Date at midnight (ISO local form, parsed the same way in every browser). */
+declare function fromDateStr(dateStr: string): Date;
+/** The 42 cells (6 weeks, Sunday first) of the month grid containing `anchor`. */
+declare function buildMonthCells(anchor: Date, todayStr: string): CalendarDay[];
+/** The 7 days (Sunday first) of the week containing `anchor`. */
+declare function buildWeekDays(anchor: Date, todayStr: string): CalendarDay[];
+/** Month view: the whole 6-week grid. Week view: the 7 days. Agenda view: the anchor month and the next one. */
+declare function rangeFor(view: CalendarViewMode, anchor: Date, todayStr: string): CalendarRange;
+/**
+ * Anchor after pressing Previous (`-1`) / Next (`1`): a week, two months (agenda, on the 1st) or one month. A month step keeps the
+ * day of the month (clamped to the target month's length), so switching to the week view afterwards shows a sensible week.
+ */
+declare function shiftAnchor(view: CalendarViewMode, anchor: Date, direction: -1 | 1): Date;
+/** `Wednesday, October 21, 2026` — one cached formatter, used for every cell's screen-reader name. */
+declare function formatDayLabel(dateStr: string): string;
+declare function periodLabelFor(view: CalendarViewMode, anchor: Date, todayStr: string): string;
+/** `14:30` → `2:30 PM`. */
+declare function formatTime$1(time: string): string;
+declare function formatHour(h: number): string;
+/** Pixel height of one hour row in the week view. */
+declare const HOUR_HEIGHT = 60;
+/**
+ * Top offset and height (px) of a timed event in a week grid whose first row is `startHour` and last row `endHour`.
+ * The box is clamped to the visible rows (an event that starts before `startHour` or ends after the last row is cut, never drawn outside).
+ */
+declare function timedBox(startTime: string | undefined, endTime: string | undefined, startHour: number, endHour?: number): {
+  top: number;
+  height: number;
+};
+interface CalendarLane {
+  lane: number;
+  lanes: number;
+}
+/**
+ * Side-by-side lanes for events that overlap in time. Events are grouped into clusters of transitively overlapping events; inside a
+ * cluster each event takes the first free lane and every event of the cluster shares the cluster's lane count.
+ */
+declare function layoutLanes(boxes: {
+  id: string;
+  top: number;
+  height: number;
+}[]): Record<string, CalendarLane>;
+/** One thing on the calendar. The host maps its own records to this shape. */
+export interface CalendarItem {
+  /** Unique across ALL items passed in (prefix ids by source when merging lists, e.g. `task-…`, `event-…`). */
+  id: string;
+  title: string;
+  /** Local calendar day, `YYYY-MM-DD`. */
+  date: string;
+  /** `HH:mm` (24 hour). Without it (or with `allDay`) the item is an all-day item in the week view. */
+  startTime?: string;
+  endTime?: string;
+  allDay?: boolean;
+  /** Filter key; matched against `CalendarFilter.value`. */
+  type?: string;
+  /** Accent colour (left border / bar) and soft background of the chip, any CSS colour. */
+  color: string;
+  bgColor: string;
+  /** Replaces the formatted `startTime` on chips and agenda rows (e.g. a time already converted to another time zone, or "All day"). */
+  timeLabel?: string;
+  /** Small marker at the end of a month chip (e.g. `T`). */
+  tag?: string;
+  /** Extra badges on the agenda row. */
+  badges?: {
+    label: string;
+    variant: BadgeVariant;
+  }[];
+  /** Extra grey lines under the title on the agenda row (location, contact…). */
+  meta?: string[];
+  /** SVG path `d` (24x24 stroke icon) drawn before the time on month chips. */
+  iconPath?: string;
+  /** Strike the title through (e.g. a completed reminder). */
+  strike?: boolean;
+  /** Screen-reader name of the item's button; defaults to "<time> <title>". */
+  ariaLabel?: string;
+}
+export interface CalendarFilter {
+  value: string;
+  label: string;
+  color: string;
+  bgColor?: string;
+}
+export interface CalendarMoreClick {
+  /** `YYYY-MM-DD` */
+  date: string;
+  /** Every item of that day that passes the active filters, in display order. */
+  items: CalendarItem[];
+}
+export interface CalendarSlotClick {
+  /** `YYYY-MM-DD` */
+  date: string;
+  /** `HH:00` of the clicked hour row. */
+  time: string;
+}
+/**
+ * Month / week / agenda calendar. The host owns the data: it listens to `(rangeChange)`, loads that range and passes
+ * the result as `items`. The calendar owns navigation, the view switcher, type filters, layout and keyboard access.
+ *
+ *   <ui-calendar [items]="items()" [filters]="filters" [loading]="loading()" [canCreate]="canCreate()"
+ *                [(view)]="view" (rangeChange)="load($event)" (itemClick)="open($event)" (dateClick)="create($event)">
+ *     <ui-kpi-card calendar-summary ... />
+ *     <ui-button calendar-actions (click)="create()">New Event</ui-button>
+ *   </ui-calendar>
+ *
+ * Keep the state you bind (`loading`, `items`, `view` …) in signals: `rangeChange` fires during change detection on the first render,
+ * so a handler that writes a plain property would raise ExpressionChangedAfterItHasBeenChecked in dev mode.
+ *
+ * The library toast outlet (`ui-toast`) is rendered here, like in `ui-data-table`, so a page with a calendar and no table still shows
+ * `ToastService` messages.
+ *
+ * Keyboard: the month grid is a real ARIA grid whose DAY CELLS have one tab stop (roving tabindex): arrows move by day/week, Home/End jump
+ * to the start/end of the week, Enter/Space on a day creates (when `canCreate`); the item buttons inside the cells stay in the Tab order.
+ * In the week view each all-day cell and each day column has a visually hidden "+ Add" button that appears when focused; Enter/Space on it
+ * creates (all-day, or the first visible hour). The initial `view` must be one of `views`.
+ *
+ * Content slots: `[calendar-actions]` (right of the view switcher), `[calendar-summary]` (centre of the toolbar on
+ * desktop) and `[calendar-summary-mobile]` (shown instead of it on phones).
+ */
+export declare class CalendarComponent {
+  /** Everything to show in the visible range. Ids must be unique across the whole list. */
+  readonly items: import("@angular/core").InputSignal<CalendarItem[]>;
+  readonly loading: import("@angular/core").InputSignal<boolean>;
+  /** Active view; two-way bindable. A value that is not in `views` is replaced by the first allowed view. */
+  readonly view: import("@angular/core").ModelSignal<CalendarViewMode>;
+  /** Views the switcher offers. One entry hides the switcher. */
+  readonly views: import("@angular/core").InputSignal<CalendarViewMode[]>;
+  /** Date the visible period is anchored on; two-way bindable. */
+  readonly anchorDate: import("@angular/core").ModelSignal<Date>;
+  /** Filter chips (with an "All" chip first). Empty = no filter bar. */
+  readonly filters: import("@angular/core").InputSignal<CalendarFilter[]>;
+  readonly filterLabel: import("@angular/core").InputSignal<string>;
+  /** `multi` toggles any number of types; `single` keeps at most one active (clicking the active chip clears it). */
+  readonly filterMode: import("@angular/core").InputSignal<"multi" | "single">;
+  /** Active filter values; empty = everything. Two-way bindable. */
+  readonly activeFilters: import("@angular/core").ModelSignal<string[]>;
+  readonly showFilterCounts: import("@angular/core").InputSignal<boolean>;
+  /** Whether empty days / time slots can start a new item (`dateClick` / `slotClick`). Read-only users: false. */
+  readonly canCreate: import("@angular/core").InputSignal<boolean>;
+  /** Days before today cannot start a new item. */
+  readonly disablePast: import("@angular/core").InputSignal<boolean>;
+  /** Items shown per month cell before "+N more". */
+  readonly maxVisible: import("@angular/core").InputSignal<number>;
+  /** `inline`: time and title on one line. `stacked`: time on the first line, title below it (title hidden on phones). */
+  readonly chipLayout: import("@angular/core").InputSignal<"inline" | "stacked">;
+  /** Order each day's items by start time (default). Off = keep the order the host passed them in. */
+  readonly sortByTime: import("@angular/core").InputSignal<boolean>;
+  /** First and last hour row of the week view. */
+  readonly startHour: import("@angular/core").InputSignal<number>;
+  readonly endHour: import("@angular/core").InputSignal<number>;
+  readonly emptyMessage: import("@angular/core").InputSignal<string>;
+  /** Builds the screen-reader name of a month cell; default "<weekday, date>, N events". */
+  readonly dayLabelFn: import("@angular/core").InputSignal<((dateStr: string, items: CalendarItem[]) => string) | null>;
+  /** Fires on first render and whenever the view or the visible range changes: load this range, then pass `items`. */
+  readonly rangeChange: import("@angular/core").OutputEmitterRef<CalendarRange>;
+  readonly itemClick: import("@angular/core").OutputEmitterRef<CalendarItem>;
+  /** Empty day clicked (month view / all-day row) — only when `canCreate` and the day is allowed. */
+  readonly dateClick: import("@angular/core").OutputEmitterRef<string>;
+  /** Empty hour row clicked in the week view (or Enter on a day column: the first visible hour). */
+  readonly slotClick: import("@angular/core").OutputEmitterRef<CalendarSlotClick>;
+  /** "+N more" clicked in a month cell. */
+  readonly moreClick: import("@angular/core").OutputEmitterRef<CalendarMoreClick>;
+  private readonly host;
+  protected readonly weekDayLabels: string[];
+  protected readonly weekDayNames: string[];
+  protected readonly skeletonCells: number[];
+  protected readonly formatHour: typeof formatHour;
+  /** Today as `YYYY-MM-DD`; refreshed at local midnight, when the tab becomes visible again and when the user presses Today. */
+  protected readonly todayStr: import("@angular/core").WritableSignal<string>;
+  /** The month-grid day that holds the roving tab stop. */
+  protected readonly focusedDate: import("@angular/core").WritableSignal<string | null>;
+  private lastRangeKey;
+  protected readonly hours: import("@angular/core").Signal<number[]>;
+  protected readonly monthCells: import("@angular/core").Signal<CalendarDay[]>;
+  protected readonly weekDays: import("@angular/core").Signal<CalendarDay[]>;
+  protected readonly periodLabel: import("@angular/core").Signal<string>;
+  protected readonly viewTabs: import("@angular/core").Signal<PillTab[]>;
+  protected readonly typeCounts: import("@angular/core").Signal<Record<string, number>>;
+  private readonly byDate;
+  protected readonly agendaGroups: import("@angular/core").Signal<{
+    dateStr: string;
+    items: CalendarItem[];
+  }[]>;
+  /** Whether the day at `dateStr` may start a new item. */
+  private clickable;
+  /** The 6 rows of the month grid with everything a cell draws, computed once per input change. */
+  protected readonly monthRows: import("@angular/core").Signal<{
+    key: string;
+    cells: {
+      day: CalendarDay;
+      items: CalendarItem[];
+      visible: CalendarItem[];
+      overflow: number;
+      clickable: boolean;
+      label: string;
+    }[];
+  }[]>;
+  /** The 7 week columns with all-day items and the timed items laid out side by side when they overlap. */
+  protected readonly weekColumns: import("@angular/core").Signal<{
+    day: CalendarDay;
+    label: string;
+    clickable: boolean;
+    allDay: CalendarItem[];
+    timed: {
+      lane: CalendarLane;
+      top: number;
+      height: number;
+      item: CalendarItem;
+    }[];
+  }[]>;
+  /** The month-grid day holding the tab stop: the last focused one if it is on screen, else today, else the 1st of the anchor month. */
+  protected readonly focusDate: import("@angular/core").Signal<string>;
+  constructor();
+  protected isFilterActive(value: string): boolean;
+  protected toggleFilter(value: string): void;
+  protected clearFilters(): void;
+  protected setView(v: CalendarViewMode): void;
+  protected navigate(direction: -1 | 1): void;
+  protected goToday(): void;
+  protected dowLabel(dateStr: string): string;
+  protected agendaDow(dateStr: string): string;
+  protected agendaDate(dateStr: string): string;
+  protected chipTime(e: CalendarItem): string;
+  protected timeRange(e: CalendarItem): string;
+  /** The button's name includes the visible time (WCAG 2.5.3 label in name) unless the host set `ariaLabel`. */
+  protected itemLabel(e: CalendarItem): string;
+  protected agendaMeta(e: CalendarItem): string[];
+  private dayAriaLabel;
+  protected onDateClick(dateStr: string): void;
+  /** Grid keys on a day cell: arrows / Home / End move the tab stop, Enter / Space create. Keys on the chips inside never reach here. */
+  protected onCellKey(event: KeyboardEvent, dateStr: string): void;
+  /** The hidden "+ Add" button of an all-day cell (keyboard / screen-reader path to the same action as clicking the cell). */
+  protected onAddAllDay(dateStr: string, event: Event): void;
+  /** The hidden "+ Add" button of a day column: creates at the first visible hour. */
+  protected onAddTimed(dateStr: string, event: Event): void;
+  protected onSlotClick(dateStr: string, event: MouseEvent): void;
+  protected onItemClick(item: CalendarItem, event: Event): void;
+  protected onMoreClick(dateStr: string, items: CalendarItem[], event: Event): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<CalendarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<CalendarComponent, "ui-calendar", never, {
+    "items": {
+      "alias": "items";
+      "required": false;
+      "isSignal": true;
+    };
+    "loading": {
+      "alias": "loading";
+      "required": false;
+      "isSignal": true;
+    };
+    "view": {
+      "alias": "view";
+      "required": false;
+      "isSignal": true;
+    };
+    "views": {
+      "alias": "views";
+      "required": false;
+      "isSignal": true;
+    };
+    "anchorDate": {
+      "alias": "anchorDate";
+      "required": false;
+      "isSignal": true;
+    };
+    "filters": {
+      "alias": "filters";
+      "required": false;
+      "isSignal": true;
+    };
+    "filterLabel": {
+      "alias": "filterLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "filterMode": {
+      "alias": "filterMode";
+      "required": false;
+      "isSignal": true;
+    };
+    "activeFilters": {
+      "alias": "activeFilters";
+      "required": false;
+      "isSignal": true;
+    };
+    "showFilterCounts": {
+      "alias": "showFilterCounts";
+      "required": false;
+      "isSignal": true;
+    };
+    "canCreate": {
+      "alias": "canCreate";
+      "required": false;
+      "isSignal": true;
+    };
+    "disablePast": {
+      "alias": "disablePast";
+      "required": false;
+      "isSignal": true;
+    };
+    "maxVisible": {
+      "alias": "maxVisible";
+      "required": false;
+      "isSignal": true;
+    };
+    "chipLayout": {
+      "alias": "chipLayout";
+      "required": false;
+      "isSignal": true;
+    };
+    "sortByTime": {
+      "alias": "sortByTime";
+      "required": false;
+      "isSignal": true;
+    };
+    "startHour": {
+      "alias": "startHour";
+      "required": false;
+      "isSignal": true;
+    };
+    "endHour": {
+      "alias": "endHour";
+      "required": false;
+      "isSignal": true;
+    };
+    "emptyMessage": {
+      "alias": "emptyMessage";
+      "required": false;
+      "isSignal": true;
+    };
+    "dayLabelFn": {
+      "alias": "dayLabelFn";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "view": "viewChange";
+    "anchorDate": "anchorDateChange";
+    "activeFilters": "activeFiltersChange";
+    "rangeChange": "rangeChange";
+    "itemClick": "itemClick";
+    "dateClick": "dateClick";
+    "slotClick": "slotClick";
+    "moreClick": "moreClick";
+  }, never, ["[calendar-summary]", "[calendar-actions]", "[calendar-summary-mobile]"], true, never>;
+}
+export type { CalendarDay, CalendarRange, CalendarViewMode };