@forgeroute/ui 0.4.48 → 0.4.50

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -1088,7 +1088,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<"sm" | "default">;
+  readonly size: import("@angular/core").InputSignal<"default" | "sm">;
   readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
@@ -1577,6 +1577,13 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
    */
   private _columnBadgeLabel;
   protected readonly _error: import("@angular/core").WritableSignal<string | null>;
+  private readonly _loadFailed;
+  /**
+   * True from a failed load (the table shows its error state) until a later load SUCCEEDS. Unlike the error state itself it stays true while
+   * Retry / a reload is in flight, so a host can keep its own controls (a date range card, say) out of the page for the whole time the
+   * table is not showing real data. Read it through the table reference: `tableRef()?.loadFailed()`.
+   */
+  readonly loadFailed: Signal<boolean>;
   protected readonly _search: import("@angular/core").WritableSignal<string>;
   /** The search text as sent to the API: lower-cased, so every search is case-insensitive whatever the backend does. The input still shows what the user typed. */
   protected readonly _searchParam: Signal<string>;
@@ -2226,7 +2233,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" | "visible" | "auto">;
+  readonly bodyOverflow: import("@angular/core").InputSignal<"hidden" | "auto" | "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. */
@@ -2610,7 +2617,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<"none" | "metadata" | "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>;
@@ -2864,7 +2871,7 @@ export declare class CheckboxComponent implements ControlValueAccessor, Validato
    * 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 | 5 | 6 | 4 | null>;
+  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>;
   /**
@@ -3889,7 +3896,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' }`). */
@@ -3934,7 +3941,7 @@ export declare class ButtonComponent {
   private readonly _narrow;
   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 size: import("@angular/core").InputSignal<"sm" | "md" | "lg" | "xs">;
   readonly type: import("@angular/core").InputSignal<"reset" | "submit" | "button">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
@@ -4751,7 +4758,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<"" | "text" | "search" | "none" | "email" | "numeric" | "tel" | "url" | "decimal">;
+  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>;
@@ -5680,7 +5687,8 @@ export declare class TimeInputComponent implements ControlValueAccessor, Validat
   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>;
-  protected readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
+  /** Public (like the other inputs) so `[disabled]` can be bound in a host template. */
+  readonly _disabledInput: import("@angular/core").InputSignal<boolean>;
   private readonly _cvaDisabled;
   protected readonly disabled: import("@angular/core").Signal<boolean>;
   protected readonly _value: import("@angular/core").WritableSignal<string>;
@@ -6399,7 +6407,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, {
@@ -7426,7 +7434,7 @@ export declare class ChipGroupComponent {
   readonly spaceAbove: import("@angular/core").InputSignal<"none" | "sm" | "md">;
   /** Space below the chip group. */
   readonly spaceBelow: import("@angular/core").InputSignal<"none" | "sm" | "md">;
-  protected readonly _gap: import("@angular/core").Signal<"8px" | "6px" | "12px">;
+  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">;
   static ɵfac: i0.ɵɵFactoryDeclaration<ChipGroupComponent, never>;
@@ -8517,7 +8525,7 @@ export interface DateRange {
  * Date range picker: preset pills (Today … Year to Date, optional All Time, Custom Range) plus
  * From / To date inputs with an Apply button for the custom range. With the presets shown, the custom range opens in a
  * popover card under the pills (right-aligned, closes on Apply / Escape / outside click; picking Custom Range again
- * reopens it); with `showPresets` false the From / To row is rendered inline. Emits `rangeChange` with the
+ * reopens it; a picker CREATED on `activePreset="custom"` starts with the popover closed and the Custom Range tab highlighted); with `showPresets` false the From / To row is rendered inline. Emits `rangeChange` with the
  * resolved ISO dates whenever a preset is picked or a custom range is applied.
  *
  *   <ui-date-range-picker [activePreset]="preset()" [includeAllTime]="true" (rangeChange)="onRange($event)" />
@@ -8531,9 +8539,16 @@ export declare class DateRangePickerComponent {
   /** Accessible name of the preset tab list (screen readers announce it when the tabs get focus). */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
   readonly rangeChange: import("@angular/core").OutputEmitterRef<DateRange>;
-  /** Follows `activePreset` from the host, and the user's own picks in between. */
+  /**
+   * Follows `activePreset` from the host, and the user's own picks in between. A pick of Custom Range that is closed without Apply
+   * (Escape / outside click) is discarded: the selection goes back to `activePreset`, the range the host actually applied.
+   */
   protected readonly selectedPreset: import("@angular/core").WritableSignal<DatePreset>;
-  /** The popover was closed (Apply / Escape / outside click); any preset change reopens it. */
+  /**
+   * The popover was closed (Apply / Escape / outside click); any preset change reopens it. It starts CLOSED: a picker created with
+   * `activePreset="custom"` (a host that re-creates it while a custom range is applied: a tab switched back to, a retry after an error)
+   * shows that applied range as the highlighted tab, it does not open an empty From / To card. Clicking the tab reopens it.
+   */
   private readonly popoverDismissed;
   protected readonly popoverVisible: import("@angular/core").Signal<boolean>;
   protected readonly popTop: import("@angular/core").WritableSignal<number>;
@@ -8546,6 +8561,13 @@ export declare class DateRangePickerComponent {
   private place;
   protected onDocumentClick(e: Event): void;
   protected onEscape(e: Event): void;
+  /** Closes the custom popover without applying: nothing was applied, so the highlighted preset returns to the host's applied one. */
+  private dismissWithoutApply;
+  /**
+   * The tab list only reports a CHANGE of tab, so a click on the Custom Range tab that is already selected (an applied custom range whose
+   * popover was closed) reopens the popover here.
+   */
+  protected onPillsClick(e: Event): void;
   selectPreset(key: DatePreset): void;
   applyCustom(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerComponent, never>;
@@ -9340,7 +9362,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 | 5 | 6 | 4 | 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. */
@@ -10944,6 +10966,12 @@ export declare class CalendarComponent {
   }[]>;
   /** 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>;
+  /**
+   * PageUp / PageDown target day waiting for the host's load: hosts show `loading` (the grid is replaced by the skeleton, which drops
+   * focus), so the day is focused again once that loading cycle ends. Cleared by any other key or a pointer press.
+   */
+  private pendingFocus;
+  private pendingSawLoading;
   constructor();
   protected isFilterActive(value: string): boolean;
   protected toggleFilter(value: string): void;