@forgeroute/ui 0.4.10 → 0.4.12

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -9141,6 +9141,8 @@ 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;
+/** True for a real calendar day written as `YYYY-MM-DD` (rejects `2026-02-30`, `2026-1-5`, non-ISO text). */
+declare function isValidDateStr(dateStr: string): boolean;
 /** 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`. */
@@ -9214,6 +9216,8 @@ export interface CalendarItem {
   strike?: boolean;
   /** Screen-reader name of the item's button; defaults to "<time> <title>". */
   ariaLabel?: string;
+  /** Hover text (native `title`) of the item's button. Month chips default to the title; week / agenda items show none unless set. */
+  tooltip?: string;
 }
 export interface CalendarFilter {
   value: string;
@@ -9250,7 +9254,8 @@ export interface CalendarSlotClick {
  * `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.
+ * to the start/end of the week, PageUp/PageDown move by one month (Shift+PageUp/PageDown by one year; the day of the month is kept, clamped to
+ * the target month), 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`.
  *
@@ -9279,6 +9284,9 @@ export declare class CalendarComponent {
   readonly canCreate: import("@angular/core").InputSignal<boolean>;
   /** Days before today cannot start a new item. */
   readonly disablePast: import("@angular/core").InputSignal<boolean>;
+  /** Overrides "today" (`YYYY-MM-DD`): the highlighted day, `disablePast`, the agenda "Today" badge and what the Today button jumps to.
+   *  Use it when the server's date, not the browser's, decides what today is. Null / invalid = the browser clock. */
+  readonly today: import("@angular/core").InputSignal<string | null>;
   /** 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). */
@@ -9305,11 +9313,14 @@ export declare class CalendarComponent {
   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 browser clock's today as `YYYY-MM-DD`; refreshed at local midnight, when the tab becomes visible again and when the user presses Today. */
+  private readonly clockToday;
+  /** Today as `YYYY-MM-DD`: the `today` input when it is a valid date, else the browser clock. */
+  protected readonly todayStr: import("@angular/core").Signal<string>;
   /** The month-grid day that holds the roving tab stop. */
   protected readonly focusedDate: import("@angular/core").WritableSignal<string | null>;
   private lastRangeKey;
+  private readonly injector;
   protected readonly hours: import("@angular/core").Signal<number[]>;
   protected readonly monthCells: import("@angular/core").Signal<CalendarDay[]>;
   protected readonly weekDays: import("@angular/core").Signal<CalendarDay[]>;
@@ -9369,6 +9380,8 @@ export declare class CalendarComponent {
   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;
+  /** PageUp / PageDown: the same day `months` away (clamped to the target month's length) becomes the anchor, the tab stop and the focus. */
+  private jumpMonths;
   /** 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. */
@@ -9438,6 +9451,11 @@ export declare class CalendarComponent {
       "required": false;
       "isSignal": true;
     };
+    "today": {
+      "alias": "today";
+      "required": false;
+      "isSignal": true;
+    };
     "maxVisible": {
       "alias": "maxVisible";
       "required": false;