@area8975/ui 0.2.2-dev.48 → 0.2.2-dev.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@area8975/ui",
-  "version": "0.2.2-dev.48",
+  "version": "0.2.2-dev.50",
   "peerDependencies": {
     "@angular/common": "^22.0.0",
     "@angular/core": "^22.0.0",
@@ -32,6 +32,242 @@
     ".": {
       "types": "./types/area8975-ui.d.ts",
       "default": "./fesm2022/area8975-ui.mjs"
+    },
+    "./alert": {
+      "types": "./types/area8975-ui-alert.d.ts",
+      "default": "./fesm2022/area8975-ui-alert.mjs"
+    },
+    "./avatar": {
+      "types": "./types/area8975-ui-avatar.d.ts",
+      "default": "./fesm2022/area8975-ui-avatar.mjs"
+    },
+    "./badge": {
+      "types": "./types/area8975-ui-badge.d.ts",
+      "default": "./fesm2022/area8975-ui-badge.mjs"
+    },
+    "./button": {
+      "types": "./types/area8975-ui-button.d.ts",
+      "default": "./fesm2022/area8975-ui-button.mjs"
+    },
+    "./calendar": {
+      "types": "./types/area8975-ui-calendar.d.ts",
+      "default": "./fesm2022/area8975-ui-calendar.mjs"
+    },
+    "./card": {
+      "types": "./types/area8975-ui-card.d.ts",
+      "default": "./fesm2022/area8975-ui-card.mjs"
+    },
+    "./card-header": {
+      "types": "./types/area8975-ui-card-header.d.ts",
+      "default": "./fesm2022/area8975-ui-card-header.mjs"
+    },
+    "./chart-palette": {
+      "types": "./types/area8975-ui-chart-palette.d.ts",
+      "default": "./fesm2022/area8975-ui-chart-palette.mjs"
+    },
+    "./charts": {
+      "types": "./types/area8975-ui-charts.d.ts",
+      "default": "./fesm2022/area8975-ui-charts.mjs"
+    },
+    "./checkbox": {
+      "types": "./types/area8975-ui-checkbox.d.ts",
+      "default": "./fesm2022/area8975-ui-checkbox.mjs"
+    },
+    "./colour": {
+      "types": "./types/area8975-ui-colour.d.ts",
+      "default": "./fesm2022/area8975-ui-colour.mjs"
+    },
+    "./container": {
+      "types": "./types/area8975-ui-container.d.ts",
+      "default": "./fesm2022/area8975-ui-container.mjs"
+    },
+    "./counter": {
+      "types": "./types/area8975-ui-counter.d.ts",
+      "default": "./fesm2022/area8975-ui-counter.mjs"
+    },
+    "./date-range-picker": {
+      "types": "./types/area8975-ui-date-range-picker.d.ts",
+      "default": "./fesm2022/area8975-ui-date-range-picker.mjs"
+    },
+    "./datepicker": {
+      "types": "./types/area8975-ui-datepicker.d.ts",
+      "default": "./fesm2022/area8975-ui-datepicker.mjs"
+    },
+    "./disclosure": {
+      "types": "./types/area8975-ui-disclosure.d.ts",
+      "default": "./fesm2022/area8975-ui-disclosure.mjs"
+    },
+    "./drawer": {
+      "types": "./types/area8975-ui-drawer.d.ts",
+      "default": "./fesm2022/area8975-ui-drawer.mjs"
+    },
+    "./dropdown": {
+      "types": "./types/area8975-ui-dropdown.d.ts",
+      "default": "./fesm2022/area8975-ui-dropdown.mjs"
+    },
+    "./dropdown-button": {
+      "types": "./types/area8975-ui-dropdown-button.d.ts",
+      "default": "./fesm2022/area8975-ui-dropdown-button.mjs"
+    },
+    "./dropdown-menu": {
+      "types": "./types/area8975-ui-dropdown-menu.d.ts",
+      "default": "./fesm2022/area8975-ui-dropdown-menu.mjs"
+    },
+    "./dropzone": {
+      "types": "./types/area8975-ui-dropzone.d.ts",
+      "default": "./fesm2022/area8975-ui-dropzone.mjs"
+    },
+    "./field": {
+      "types": "./types/area8975-ui-field.d.ts",
+      "default": "./fesm2022/area8975-ui-field.mjs"
+    },
+    "./file": {
+      "types": "./types/area8975-ui-file.d.ts",
+      "default": "./fesm2022/area8975-ui-file.mjs"
+    },
+    "./file-input": {
+      "types": "./types/area8975-ui-file-input.d.ts",
+      "default": "./fesm2022/area8975-ui-file-input.mjs"
+    },
+    "./format": {
+      "types": "./types/area8975-ui-format.d.ts",
+      "default": "./fesm2022/area8975-ui-format.mjs"
+    },
+    "./input": {
+      "types": "./types/area8975-ui-input.d.ts",
+      "default": "./fesm2022/area8975-ui-input.mjs"
+    },
+    "./input-addon": {
+      "types": "./types/area8975-ui-input-addon.d.ts",
+      "default": "./fesm2022/area8975-ui-input-addon.mjs"
+    },
+    "./input-group": {
+      "types": "./types/area8975-ui-input-group.d.ts",
+      "default": "./fesm2022/area8975-ui-input-group.mjs"
+    },
+    "./kpi": {
+      "types": "./types/area8975-ui-kpi.d.ts",
+      "default": "./fesm2022/area8975-ui-kpi.mjs"
+    },
+    "./layout": {
+      "types": "./types/area8975-ui-layout.d.ts",
+      "default": "./fesm2022/area8975-ui-layout.mjs"
+    },
+    "./loading": {
+      "types": "./types/area8975-ui-loading.d.ts",
+      "default": "./fesm2022/area8975-ui-loading.mjs"
+    },
+    "./modal": {
+      "types": "./types/area8975-ui-modal.d.ts",
+      "default": "./fesm2022/area8975-ui-modal.mjs"
+    },
+    "./modal-close-btn": {
+      "types": "./types/area8975-ui-modal-close-btn.d.ts",
+      "default": "./fesm2022/area8975-ui-modal-close-btn.mjs"
+    },
+    "./money": {
+      "types": "./types/area8975-ui-money.d.ts",
+      "default": "./fesm2022/area8975-ui-money.mjs"
+    },
+    "./overlay": {
+      "types": "./types/area8975-ui-overlay.d.ts",
+      "default": "./fesm2022/area8975-ui-overlay.mjs"
+    },
+    "./pagination": {
+      "types": "./types/area8975-ui-pagination.d.ts",
+      "default": "./fesm2022/area8975-ui-pagination.mjs"
+    },
+    "./private": {
+      "types": "./types/area8975-ui-private.d.ts",
+      "default": "./fesm2022/area8975-ui-private.mjs"
+    },
+    "./progress": {
+      "types": "./types/area8975-ui-progress.d.ts",
+      "default": "./fesm2022/area8975-ui-progress.mjs"
+    },
+    "./radio": {
+      "types": "./types/area8975-ui-radio.d.ts",
+      "default": "./fesm2022/area8975-ui-radio.mjs"
+    },
+    "./rich-text-editor": {
+      "types": "./types/area8975-ui-rich-text-editor.d.ts",
+      "default": "./fesm2022/area8975-ui-rich-text-editor.mjs"
+    },
+    "./search": {
+      "types": "./types/area8975-ui-search.d.ts",
+      "default": "./fesm2022/area8975-ui-search.mjs"
+    },
+    "./segmented": {
+      "types": "./types/area8975-ui-segmented.d.ts",
+      "default": "./fesm2022/area8975-ui-segmented.mjs"
+    },
+    "./select": {
+      "types": "./types/area8975-ui-select.d.ts",
+      "default": "./fesm2022/area8975-ui-select.mjs"
+    },
+    "./sidebar": {
+      "types": "./types/area8975-ui-sidebar.d.ts",
+      "default": "./fesm2022/area8975-ui-sidebar.mjs"
+    },
+    "./sidebar-group": {
+      "types": "./types/area8975-ui-sidebar-group.d.ts",
+      "default": "./fesm2022/area8975-ui-sidebar-group.mjs"
+    },
+    "./sidebar-item": {
+      "types": "./types/area8975-ui-sidebar-item.d.ts",
+      "default": "./fesm2022/area8975-ui-sidebar-item.mjs"
+    },
+    "./skeleton": {
+      "types": "./types/area8975-ui-skeleton.d.ts",
+      "default": "./fesm2022/area8975-ui-skeleton.mjs"
+    },
+    "./stat": {
+      "types": "./types/area8975-ui-stat.d.ts",
+      "default": "./fesm2022/area8975-ui-stat.mjs"
+    },
+    "./switch": {
+      "types": "./types/area8975-ui-switch.d.ts",
+      "default": "./fesm2022/area8975-ui-switch.mjs"
+    },
+    "./tab": {
+      "types": "./types/area8975-ui-tab.d.ts",
+      "default": "./fesm2022/area8975-ui-tab.mjs"
+    },
+    "./table": {
+      "types": "./types/area8975-ui-table.d.ts",
+      "default": "./fesm2022/area8975-ui-table.mjs"
+    },
+    "./table-filters": {
+      "types": "./types/area8975-ui-table-filters.d.ts",
+      "default": "./fesm2022/area8975-ui-table-filters.mjs"
+    },
+    "./textarea": {
+      "types": "./types/area8975-ui-textarea.d.ts",
+      "default": "./fesm2022/area8975-ui-textarea.mjs"
+    },
+    "./theme": {
+      "types": "./types/area8975-ui-theme.d.ts",
+      "default": "./fesm2022/area8975-ui-theme.mjs"
+    },
+    "./time-select": {
+      "types": "./types/area8975-ui-time-select.d.ts",
+      "default": "./fesm2022/area8975-ui-time-select.mjs"
+    },
+    "./toast": {
+      "types": "./types/area8975-ui-toast.d.ts",
+      "default": "./fesm2022/area8975-ui-toast.mjs"
+    },
+    "./toaster": {
+      "types": "./types/area8975-ui-toaster.d.ts",
+      "default": "./fesm2022/area8975-ui-toaster.mjs"
+    },
+    "./tooltip": {
+      "types": "./types/area8975-ui-tooltip.d.ts",
+      "default": "./fesm2022/area8975-ui-tooltip.mjs"
+    },
+    "./user-menu": {
+      "types": "./types/area8975-ui-user-menu.d.ts",
+      "default": "./fesm2022/area8975-ui-user-menu.mjs"
     }
   },
   "module": "fesm2022/area8975-ui.mjs",

package/types/area8975-ui-alert.d.ts

@@ -0,0 +1,25 @@
+import * as i0 from "@angular/core";
+import { TemplateRef } from "@angular/core";
+export declare class UiAlertComponent {
+  readonly appearance: import("@angular/core").InputSignal<"soft" | "bordered">;
+  readonly intent: import("@angular/core").InputSignal<string>;
+  readonly icon: import("@angular/core").Signal<TemplateRef<unknown> | undefined>;
+  readonly generatedClasses: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiAlertComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiAlertComponent, "ui-alert", never, {
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "intent": {
+      "alias": "intent";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["icon"], ["*"], true, never>;
+}
+export declare const AlertIntents: string[];
+export declare const AlertAppearances: readonly ["soft", "bordered"];
+export type AlertIntent = typeof AlertIntents[number];
+export type AlertAppearance = typeof AlertAppearances[number];

package/types/area8975-ui-avatar.d.ts

@@ -0,0 +1,40 @@
+import * as i0 from "@angular/core";
+export declare class UiAvatarComponent {
+  readonly name: import("@angular/core").InputSignal<string>;
+  readonly src: import("@angular/core").InputSignal<string | null>;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xl">;
+  /** Fill behind the initials, any CSS colour. The initials' ink is picked to read on six digit hex, anything else gets dark ink. */
+  readonly colour: import("@angular/core").InputSignal<string | null>;
+  private readonly failedSrc;
+  protected readonly showImage: import("@angular/core").Signal<boolean>;
+  protected readonly initials: import("@angular/core").Signal<string>;
+  protected readonly ink: import("@angular/core").Signal<string | null>;
+  readonly generatedClasses: import("@angular/core").Signal<string>;
+  protected imageFailed(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiAvatarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiAvatarComponent, "ui-avatar", never, {
+    "name": {
+      "alias": "name";
+      "required": true;
+      "isSignal": true;
+    };
+    "src": {
+      "alias": "src";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "colour": {
+      "alias": "colour";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, never, true, never>;
+}
+export declare const AvatarSizes: readonly ["sm", "md", "lg", "xl"];
+/** @see {@link AvatarSizes} */
+export type AvatarSize = typeof AvatarSizes[number];

package/types/area8975-ui-badge.d.ts

@@ -0,0 +1,31 @@
+import * as i0 from "@angular/core";
+export declare class UiBadgeComponent {
+  readonly appearance: import("@angular/core").InputSignal<"solid" | "outline" | "soft">;
+  readonly intent: import("@angular/core").InputSignal<"primary" | "secondary" | "success" | "warning" | "danger">;
+  readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | "lg">;
+  readonly generatedClasses: import("@angular/core").Signal<string>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiBadgeComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiBadgeComponent, "ui-badge", never, {
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "intent": {
+      "alias": "intent";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+export declare const BadgeIntents: readonly ["primary", "secondary", "success", "warning", "danger"];
+export declare const BadgeAppearances: readonly ["solid", "outline", "soft"];
+export declare const BadgeSizes: readonly ["xs", "sm", "md", "lg"];
+export type BadgeIntent = typeof BadgeIntents[number];
+export type BadgeAppearance = typeof BadgeAppearances[number];
+export type BadgeSize = typeof BadgeSizes[number];

package/types/area8975-ui-button.d.ts

@@ -0,0 +1,129 @@
+import * as i0 from "@angular/core";
+import { InjectionToken, Signal } from "@angular/core";
+/**
+ * A general-purpose button.
+ */
+export declare class UiButtonComponent {
+  readonly appearance: import("@angular/core").InputSignal<"none" | "solid" | "outline" | "ghost" | "white" | "link">;
+  readonly intent: import("@angular/core").InputSignal<"primary" | "secondary" | "success" | "warning" | "danger" | "none">;
+  readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg">;
+  readonly classes: import("@angular/core").InputSignal<string>;
+  readonly type: import("@angular/core").InputSignal<"button" | "submit" | "reset">;
+  readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  readonly disabled: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  readonly loading: import("@angular/core").InputSignalWithTransform<boolean, unknown>;
+  /**
+   * Whether the underlying `<button>` element should be disabled - true when
+   * `disabled` is set explicitly, or implicitly while `loading` is true.
+   */
+  readonly isDisabled: import("@angular/core").Signal<boolean>;
+  private readonly group;
+  /** In a segmented group the button matches a `ui-segmented` option instead of its own variant. */
+  private readonly segmented;
+  readonly generatedClasses: import("@angular/core").Signal<string>;
+  private readonly intentAndAppearanceClasses;
+  private readonly sizeClasses;
+  private readonly textClasses;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiButtonComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiButtonComponent, "ui-button", never, {
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+    "intent": {
+      "alias": "intent";
+      "required": false;
+      "isSignal": true;
+    };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
+    "classes": {
+      "alias": "classes";
+      "required": false;
+      "isSignal": true;
+    };
+    "type": {
+      "alias": "type";
+      "required": false;
+      "isSignal": true;
+    };
+    "ariaLabel": {
+      "alias": "ariaLabel";
+      "required": false;
+      "isSignal": true;
+    };
+    "disabled": {
+      "alias": "disabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "loading": {
+      "alias": "loading";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, never, ["*"], true, never>;
+}
+/**
+ * The semantic colour of a button. `"none"` opts out of intent/appearance
+ * styling entirely - see `UiButtonComponent.intent`.
+ */
+export declare const ButtonIntents: readonly ["primary", "secondary", "success", "warning", "danger", "none"];
+/**
+ * The visual treatment of a button (fill, outline, etc.), combined with its
+ * `intent` to select a variant class. `"none"` opts out of intent/appearance
+ * styling entirely - see `UiButtonComponent.appearance`.
+ */
+export declare const ButtonAppearances: readonly ["solid", "outline", "ghost", "white", "link", "none"];
+/** The size of a button, controlling its padding and typography scale. */
+export declare const ButtonSizes: readonly ["sm", "md", "lg"];
+/** The native `type` attribute a button can render with. */
+export declare const ButtonTypes: readonly ["button", "submit", "reset"];
+/** @see {@link ButtonIntents} */
+export type ButtonIntent = typeof ButtonIntents[number];
+/** @see {@link ButtonAppearances} */
+export type ButtonAppearance = typeof ButtonAppearances[number];
+/** @see {@link ButtonSizes} */
+export type ButtonSize = typeof ButtonSizes[number];
+/** @see {@link ButtonTypes} */
+export type ButtonType = typeof ButtonTypes[number];
+/**
+ * Buttons that belong together, joined edge to edge or in a segmented track.
+ *
+ * @example
+ * ```html
+ * <ui-button-group>
+ *   <ui-button intent="secondary" appearance="white">First</ui-button>
+ *   <ui-button intent="secondary" appearance="white">Second</ui-button>
+ *   <ui-button intent="secondary" appearance="white">Last</ui-button>
+ * </ui-button-group>
+ * ```
+ */
+export declare class UiButtonGroupComponent {
+  /** `segmented` matches `ui-segmented`, so the two can sit side by side. Buttons inside ignore their own appearance, intent and size. */
+  readonly appearance: import("@angular/core").InputSignal<"attached" | "segmented">;
+  readonly buttons: import("@angular/core").Signal<readonly UiButtonComponent[]>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiButtonGroupComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiButtonGroupComponent, "ui-button-group", never, {
+    "appearance": {
+      "alias": "appearance";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {}, ["buttons"], ["*"], true, never>;
+}
+/**
+ * How the buttons in a group are drawn. `"attached"` joins them edge to edge,
+ * `"segmented"` sits them in a track that matches `ui-segmented`.
+ */
+export declare const ButtonGroupAppearances: readonly ["attached", "segmented"];
+/** @see {@link ButtonGroupAppearances} */
+export type ButtonGroupAppearance = typeof ButtonGroupAppearances[number];
+/** Lets a button take its look from the group it's in. */
+export declare const UI_BUTTON_GROUP: InjectionToken<{
+  appearance: Signal<ButtonGroupAppearance>;
+}>;

package/types/area8975-ui-calendar.d.ts

@@ -0,0 +1,177 @@
+import { SelectLocalDataSource } from "@area8975/ui/select";
+import * as i0 from "@angular/core";
+import { TemplateRef } from "@angular/core";
+/** Which day each calendar row starts on. 0 is Sunday, 1 is Monday. */
+export declare const WeekStarts: readonly [0, 1];
+/** @see {@link WeekStarts} */
+export type WeekStart = typeof WeekStarts[number];
+/** A date-only ISO string, e.g. "2026-09-29". */
+export type IsoDate = string;
+export interface CalendarDay {
+  iso: IsoDate;
+  day: number;
+  label: string;
+  isOutside: boolean;
+  isToday: boolean;
+  isSelected: boolean;
+  isDisabled: boolean;
+  isInRange: boolean;
+  isRangeStart: boolean;
+  isRangeEnd: boolean;
+  /** Extra classes from the calendar's `dayClass`. */
+  className: string;
+}
+/** The month a calendar shows, for loading what its days need. */
+export interface CalendarView {
+  /** First of the month, e.g. "2026-11-01". */
+  month: IsoDate;
+  /** First and last day in the grid, including days from the months either side. */
+  start: IsoDate;
+  end: IsoDate;
+}
+export interface CalendarDayContext {
+  $implicit: IsoDate;
+  day: CalendarDay;
+}
+/** A local date and time ISO string, e.g. "2026-09-29T14:30". */
+export type IsoDateTime = string;
+/** Whether a calendar picks one date or a start and end. */
+export declare const CalendarModes: readonly ["single", "range"];
+/** @see {@link CalendarModes} */
+export type CalendarMode = typeof CalendarModes[number];
+export interface DateRange {
+  start: IsoDate | null;
+  end: IsoDate | null;
+}
+/**
+ * Draws each day's content in place of its number:
+ * `<ng-template uiCalendarDay let-date let-day="day">`.
+ */
+export declare class UiCalendarDayDirective {
+  readonly template: TemplateRef<CalendarDayContext>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiCalendarDayDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<UiCalendarDayDirective, "ng-template[uiCalendarDay]", never, {}, {}, never, never, true, never>;
+}
+export declare class UiCalendarComponent {
+  private readonly host;
+  private readonly injector;
+  readonly mode: import("@angular/core").InputSignal<"single" | "range">;
+  /** The picked date in single mode. */
+  readonly value: import("@angular/core").ModelSignal<string | null>;
+  /** The picked start and end in range mode. */
+  readonly range: import("@angular/core").ModelSignal<DateRange>;
+  readonly min: import("@angular/core").InputSignal<string | null>;
+  readonly max: import("@angular/core").InputSignal<string | null>;
+  readonly isDateDisabled: import("@angular/core").InputSignal<(date: IsoDate) => boolean>;
+  readonly weekStart: import("@angular/core").InputSignal<0 | 1>;
+  readonly locale: import("@angular/core").InputSignal<string>;
+  /** Classes for a day, e.g. a tint. Signals it reads update the grid. */
+  readonly dayClass: import("@angular/core").InputSignal<(date: IsoDate) => string>;
+  /** Leaves picked days unmarked, for when a click does something other than pick. */
+  readonly hideSelection: import("@angular/core").InputSignal<boolean>;
+  /** Every click on an available day, even one that's already picked. */
+  readonly dayClick: import("@angular/core").OutputEmitterRef<string>;
+  /** The month in view, on first render and whenever it changes. */
+  readonly monthChange: import("@angular/core").OutputEmitterRef<CalendarView>;
+  protected readonly dayTemplate: import("@angular/core").Signal<UiCalendarDayDirective | undefined>;
+  protected readonly today: string;
+  private readonly anchorDate;
+  private readonly activeDate;
+  private readonly hoveredDate;
+  protected readonly viewMonth: import("@angular/core").WritableSignal<number>;
+  protected readonly viewYear: import("@angular/core").WritableSignal<number>;
+  protected readonly monthNames: import("@angular/core").Signal<string[]>;
+  protected readonly weekdays: import("@angular/core").Signal<string[]>;
+  protected readonly monthSource: import("@angular/core").Signal<SelectLocalDataSource<number>>;
+  protected readonly yearSource: import("@angular/core").Signal<SelectLocalDataSource<number>>;
+  protected readonly displayMonth: (month: number) => string;
+  protected readonly days: import("@angular/core").Signal<CalendarDay[]>;
+  private readonly view;
+  private readonly rangeBounds;
+  /** Only one day is tabbable, arrow keys move between the rest. */
+  protected readonly tabbableDate: import("@angular/core").Signal<string>;
+  protected readonly canGoBack: import("@angular/core").Signal<boolean>;
+  protected readonly canGoForward: import("@angular/core").Signal<boolean>;
+  constructor();
+  /** Moves focus onto the active day, e.g. when a datepicker opens. */
+  focusActiveDate(): void;
+  protected showMonth(offset: number): void;
+  protected select(day: CalendarDay): void;
+  protected preview(date: IsoDate | null): void;
+  protected handleKeydown(event: KeyboardEvent): void;
+  private keyTarget;
+  private isUnavailable;
+  static ɵfac: i0.ɵɵFactoryDeclaration<UiCalendarComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<UiCalendarComponent, "ui-calendar", never, {
+    "mode": {
+      "alias": "mode";
+      "required": false;
+      "isSignal": true;
+    };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
+    "range": {
+      "alias": "range";
+      "required": false;
+      "isSignal": true;
+    };
+    "min": {
+      "alias": "min";
+      "required": false;
+      "isSignal": true;
+    };
+    "max": {
+      "alias": "max";
+      "required": false;
+      "isSignal": true;
+    };
+    "isDateDisabled": {
+      "alias": "isDateDisabled";
+      "required": false;
+      "isSignal": true;
+    };
+    "weekStart": {
+      "alias": "weekStart";
+      "required": false;
+      "isSignal": true;
+    };
+    "locale": {
+      "alias": "locale";
+      "required": false;
+      "isSignal": true;
+    };
+    "dayClass": {
+      "alias": "dayClass";
+      "required": false;
+      "isSignal": true;
+    };
+    "hideSelection": {
+      "alias": "hideSelection";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "value": "valueChange";
+    "range": "rangeChange";
+    "dayClick": "dayClick";
+    "monthChange": "monthChange";
+  }, ["dayTemplate"], never, true, never>;
+}
+export declare function toIsoDate(date: Date): IsoDate;
+/** Local midnight for an ISO date, or null when it isn't a real date. */
+export declare function parseIsoDate(value: IsoDate | null | undefined): Date | null;
+export declare function addDays(date: Date, days: number): Date;
+/** Moves by whole months, keeping the day where it can (31 Jan + 1 -> 28 Feb). */
+export declare function addMonths(date: Date, months: number): Date;
+export declare function daysInMonth(year: number, month: number): number;
+/** Local date and time for "2026-09-29T14:30", a date-only string gives midnight. */
+export declare function parseIsoDateTime(value: IsoDateTime | null | undefined): Date | null;
+/** "14:30" -> { hours: 14, minutes: 30 }, or null when it isn't a real time. */
+export declare function parseTime(value: string | null | undefined): {
+  hours: number;
+  minutes: number;
+} | null;
+export declare function toTime(hours: number, minutes: number): string;