@forgeroute/ui 0.4.8 → 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>;
@@ -1909,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. */
@@ -2495,6 +2495,8 @@ 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>;
@@ -2502,6 +2504,8 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
   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.
@@ -2610,6 +2614,11 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
       "required": false;
       "isSignal": true;
     };
+    "labelTestId": {
+      "alias": "labelTestId";
+      "required": false;
+      "isSignal": true;
+    };
     "headingLevel": {
       "alias": "headingLevel";
       "required": false;
@@ -2792,6 +2801,12 @@ export interface StepperStep {
    * 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';
 /**
@@ -2818,6 +2833,9 @@ export type StepperOrientation = 'horizontal' | 'vertical';
  *
  *   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 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
@@ -2853,6 +2871,8 @@ export declare class StepperComponent {
   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'`). */
@@ -2918,6 +2938,11 @@ export declare class StepperComponent {
       "required": false;
       "isSignal": true;
     };
+    "accentLabels": {
+      "alias": "accentLabels";
+      "required": false;
+      "isSignal": true;
+    };
     "ariaLabel": {
       "alias": "ariaLabel";
       "required": false;
@@ -3423,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<"primary" | "secondary" | "danger" | "warning" | "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' }`). */
@@ -3438,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. */
@@ -3446,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>;
@@ -3975,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" | "text" | "email" | "tel" | "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>;
@@ -3984,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<"" | "none" | "text" | "search" | "email" | "tel" | "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>;
@@ -4313,7 +4338,7 @@ 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 —
@@ -4340,6 +4365,8 @@ export declare class TextComponent {
   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). */
@@ -4368,6 +4395,11 @@ export declare class TextComponent {
       "required": false;
       "isSignal": true;
     };
+    "color": {
+      "alias": "color";
+      "required": false;
+      "isSignal": true;
+    };
     "strong": {
       "alias": "strong";
       "required": false;
@@ -5345,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
@@ -5525,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, {
@@ -6260,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": {
@@ -6855,6 +6887,8 @@ export declare class ImageComponent {
   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>;
@@ -6916,6 +6950,11 @@ export declare class ImageComponent {
       "required": false;
       "isSignal": true;
     };
+    "minHeight": {
+      "alias": "minHeight";
+      "required": false;
+      "isSignal": true;
+    };
     "aspectRatio": {
       "alias": "aspectRatio";
       "required": false;
@@ -6989,11 +7028,19 @@ export declare class ImageGalleryComponent {
   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>;
@@ -7048,6 +7095,11 @@ export declare class ImageGalleryComponent {
       "required": false;
       "isSignal": true;
     };
+    "autofocus": {
+      "alias": "autofocus";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "index": "indexChange";
   }, never, never, true, never>;
@@ -8049,6 +8101,7 @@ export declare class PdfHotspotComponent {
  *    ("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.
@@ -8094,9 +8147,13 @@ 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 so sibling cards line up; the body grows. Default false: unchanged. */
+  /** 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;
@@ -8172,6 +8229,16 @@ 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;
@@ -8625,11 +8692,26 @@ export declare class ColumnsComponent {
   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>;
@@ -8669,6 +8751,26 @@ export declare class ColumnsComponent {
       "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';
@@ -8701,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>;
@@ -8731,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';
@@ -8805,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 };