@forgeroute/ui 0.4.11 → 0.4.12

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -2279,7 +2279,7 @@ export declare class AudioPlayerComponent {
   /** Accessible name of the player. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   /** How much to load before play: 'metadata' (default), 'auto' or 'none'. */
-  readonly preload: import("@angular/core").InputSignal<"metadata" | "none" | "auto">;
+  readonly preload: import("@angular/core").InputSignal<"none" | "auto" | "metadata">;
   /** Fires when the browser can't load or decode the source. */
   readonly playbackError: import("@angular/core").OutputEmitterRef<void>;
   protected readonly failed: import("@angular/core").WritableSignal<boolean>;
@@ -3506,7 +3506,7 @@ export declare class ButtonComponent {
    * `ghost-start`: a ghost button for list / section toggles - a full-width row with its content aligned to the start, transparent
    * background, hover tint and the normal focus ring. Pair it with `ariaExpanded` / `ariaPressed`; the label may contain a heading element.
    */
-  readonly variant: import("@angular/core").InputSignal<"link" | "primary" | "secondary" | "danger" | "warning" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
+  readonly variant: import("@angular/core").InputSignal<"primary" | "secondary" | "danger" | "warning" | "link" | "ghost" | "ghost-start" | "tab" | "icon" | "icon-danger">;
   /** Renders an anchor to this route instead of a button (use with `variant="link"` for an inline text link). `['/settings']` or `'/settings'`. While `disabled` or `loading` it renders a non-clickable `<span role="link" aria-disabled>` with no href (like `href`). */
   readonly routerLink: import("@angular/core").InputSignal<string | readonly unknown[] | null>;
   /** Query params of the `routerLink` (e.g. `{ section: 'deal-defaults' }`). */
@@ -3552,7 +3552,7 @@ export declare class ButtonComponent {
   readonly color: import("@angular/core").InputSignal<string | undefined>;
   readonly active: import("@angular/core").InputSignal<boolean>;
   readonly size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
-  readonly type: import("@angular/core").InputSignal<"button" | "reset" | "submit">;
+  readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4105,7 +4105,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<"" | "search" | "text" | "none" | "email" | "tel" | "url" | "decimal" | "numeric">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "search" | "email" | "tel" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   readonly error: import("@angular/core").InputSignal<string>;
@@ -5486,7 +5486,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<"button" | "badge">;
+  readonly variant: import("@angular/core").InputSignal<"badge" | "button">;
   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
@@ -5684,7 +5684,7 @@ export declare class FormRowComponent {
  * child simply takes the full width. Keep a numeric span within the row's `cols` (use `all` for the whole row).
  */
 export declare class FormColSpanDirective {
-  readonly uiColSpan: import("@angular/core").InputSignal<"" | 2 | 3 | "2" | "3" | "all">;
+  readonly uiColSpan: import("@angular/core").InputSignal<"" | "2" | "3" | 2 | 3 | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -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;