@forgeroute/ui 0.4.16 → 0.4.17

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -973,7 +973,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>;
@@ -1225,6 +1225,12 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   readonly page: import("@angular/core").InputSignal<string>;
   /** Show column config + saved views toolbar. Defaults true. Set false to hide both. */
   readonly showToolbar: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Show the More Actions menu in the toolbar (Import, Columns, Save/Saved Views and page-defined menu items). Defaults true.
+   * Set false for a page that has nothing to offer there; Export, page-defined primary/secondary buttons and the search box
+   * are unaffected. The table still hides the menu by itself when it is empty and unfiltered.
+   */
+  readonly showMoreActions: import("@angular/core").InputSignal<boolean>;
   /**
    * Show the search box above the table. Defaults true. Set false for small fixed tables where searching is meaningless
    * (a handful of summary rows). Quick-filter tabs and the toolbar are unaffected; when the search box, the tabs and the
@@ -1426,7 +1432,8 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
   protected readonly _reorderOn: Signal<boolean>;
   /** Moves are allowed: the list is in its stored order (no sort / search / tab / filter), loaded, and has more than one row. */
   protected readonly _reorderActive: Signal<boolean>;
-  protected readonly _reorderHint: Signal<"There is nothing to reorder" | "Clear the sort, search and filters to change the order">;
+  /** Why the grips are off: an active sort / search / tab / filter is the reason to name even when it left one row ("nothing to reorder" would hide it). */
+  protected readonly _reorderHint: Signal<"Clear the sort, search and filters to change the order" | "There is nothing to reorder" | "Reordering is not available right now">;
   /** One id per table, so each grip can point to the instructions (aria-describedby) even with several tables on a page. */
   protected readonly _reorderHelpId: string;
   protected readonly _dragFrom: import("@angular/core").WritableSignal<number | null>;
@@ -1748,6 +1755,11 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
       "required": false;
       "isSignal": true;
     };
+    "showMoreActions": {
+      "alias": "showMoreActions";
+      "required": false;
+      "isSignal": true;
+    };
     "showSearch": {
       "alias": "showSearch";
       "required": false;
@@ -1877,6 +1889,11 @@ export declare class SidePanelComponent implements OnDestroy {
   readonly cancelTestId: import("@angular/core").InputSignal<string>;
   /** `data-testid` of the primary footer button; none when empty (default). */
   readonly primaryTestId: import("@angular/core").InputSignal<string>;
+  /**
+   * Element that gets focus back when the panel closes. Takes precedence over the element that was focused (or last
+   * clicked / activated) when it opened; used only if it is still in the page and visible. Default null = the opener.
+   */
+  readonly returnFocusTo: import("@angular/core").InputSignal<HTMLElement | null>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly primaryClick: import("@angular/core").OutputEmitterRef<void>;
   protected readonly titleId: string;
@@ -1886,8 +1903,12 @@ export declare class SidePanelComponent implements OnDestroy {
   private _prevFocus;
   private _scrollLocked;
   private _stopViewport;
+  private _stopIframeKeys;
+  private readonly _interaction;
   constructor();
   onKeydown(event: KeyboardEvent): void;
+  /** A focus-guard sentinel received focus (Tab left the panel's tab order, e.g. out of an iframe): send it back inside. */
+  protected onGuardFocus(which: 'start' | 'end', event?: FocusEvent): void;
   /** Initial focus — see `focusInitial` (autofocus target → first usable field → dialog container). */
   private _focusFirst;
   private _focusable;
@@ -1954,6 +1975,11 @@ export declare class SidePanelComponent implements OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "returnFocusTo": {
+      "alias": "returnFocusTo";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "closed": "closed";
     "primaryClick": "primaryClick";
@@ -1964,7 +1990,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" | "visible" | "hidden">;
   /** `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. */
@@ -1975,6 +2001,11 @@ export declare class ModalComponent implements OnInit, OnDestroy {
    */
   readonly closable: import("@angular/core").InputSignal<boolean>;
   readonly close: import("@angular/core").OutputEmitterRef<void>;
+  /**
+   * Element that gets focus back when the dialog closes. Takes precedence over the element that was focused (or last
+   * clicked / activated) when it opened; used only if it is still in the page and visible. Default null = the opener.
+   */
+  readonly returnFocusTo: import("@angular/core").InputSignal<HTMLElement | null>;
   protected readonly titleId: string;
   private readonly el;
   private readonly ren;
@@ -1983,8 +2014,12 @@ export declare class ModalComponent implements OnInit, OnDestroy {
   private _prevFocus;
   private _scrollLocked;
   private _stopViewport;
+  private _stopIframeKeys;
+  private readonly _interaction;
   constructor();
   onKeydown(event: KeyboardEvent): void;
+  /** A focus-guard sentinel received focus (Tab left the dialog's tab order, e.g. out of an iframe): send it back inside. */
+  protected onGuardFocus(which: 'start' | 'end', event?: FocusEvent): void;
   /** Initial focus — see `focusInitial` (autofocus target → first usable field → dialog container). */
   private _focusFirst;
   private _focusable;
@@ -2032,6 +2067,11 @@ export declare class ModalComponent implements OnInit, OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "returnFocusTo": {
+      "alias": "returnFocusTo";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
     "close": "close";
   }, never, ["*", "[modal-footer-left]", "[modal-footer-center]", "[modal-footer-right]"], true, never>;
@@ -2334,7 +2374,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" | "auto" | "metadata">;
+  readonly preload: import("@angular/core").InputSignal<"auto" | "none" | "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>;
@@ -2584,7 +2624,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 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<5 | 3 | 1 | 2 | 4 | 6 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -2797,7 +2837,7 @@ export declare class CheckboxTrailingDirective {
  *
  * Built on a native `<input type="checkbox" role="switch">`, so Space toggles it, it is focusable, and a screen reader
  * announces it as a switch (on / off). The label and hint name and describe it. `disabled` (input or form control) dims it
- * and blocks changes. On touch devices and phones the switch has a >= 44px hit area.
+ * and blocks changes. `ariaDescribedBy` adds the id of a description rendered elsewhere. On touch devices and phones the switch has a >= 44px hit area.
  */
 export declare class ToggleComponent implements ControlValueAccessor {
   /** Bold line on the left. */
@@ -2806,6 +2846,8 @@ export declare class ToggleComponent implements ControlValueAccessor {
   readonly hint: import("@angular/core").InputSignal<string>;
   /** Accessible name when there is no visible `label`. */
   readonly ariaLabel: import("@angular/core").InputSignal<string>;
+  /** Id of another element that describes the switch (e.g. a description rendered elsewhere); announced after the hint. Absent when empty. */
+  readonly ariaDescribedBy: import("@angular/core").InputSignal<string>;
   /** Whether the switch is on. Two-way: `[(checked)]`. */
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /** Public so a host template can bind `[disabled]` (a protected input fails strict template type-checking, TS2445). */
@@ -2816,6 +2858,8 @@ export declare class ToggleComponent implements ControlValueAccessor {
   protected readonly _inputId: string;
   protected readonly _labelId: string;
   protected readonly _hintId: string;
+  /** The hint's id (when there is a hint) followed by the host's `ariaDescribedBy`; null when neither exists. */
+  protected readonly _describedBy: import("@angular/core").Signal<string | null>;
   private _onChange;
   private _onTouched;
   writeValue(val: boolean): void;
@@ -2841,6 +2885,11 @@ export declare class ToggleComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "ariaDescribedBy": {
+      "alias": "ariaDescribedBy";
+      "required": false;
+      "isSignal": true;
+    };
     "checked": {
       "alias": "checked";
       "required": false;
@@ -3465,7 +3514,7 @@ export declare class PhoneNumberPickerComponent {
   protected readonly modeCtl: FormControl<string>;
   protected readonly zipCtl: FormControl<string>;
   protected readonly areaCtl: FormControl<string>;
-  protected readonly step: import("@angular/core").WritableSignal<1 | 2 | 3>;
+  protected readonly step: import("@angular/core").WritableSignal<3 | 1 | 2>;
   protected readonly mode: import("@angular/core").WritableSignal<PhoneNumberSearchMode>;
   private readonly _zip;
   private readonly _area;
@@ -3579,7 +3628,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" | "danger" | "warning" | "link" | "secondary" | "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' }`). */
@@ -3625,7 +3674,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<"reset" | "submit" | "button">;
+  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>;
@@ -4020,7 +4069,7 @@ export declare class BulkMessagePanelComponent {
   readonly sending: import("@angular/core").InputSignal<boolean>;
   readonly closed: import("@angular/core").OutputEmitterRef<void>;
   readonly send: import("@angular/core").OutputEmitterRef<BulkMessageSendEvent>;
-  readonly channel: import("@angular/core").WritableSignal<"text" | "email">;
+  readonly channel: import("@angular/core").WritableSignal<"email" | "text">;
   private readonly _subject;
   private readonly _body;
   get subject(): string;
@@ -4229,7 +4278,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   readonly passwordRequirements: import("@angular/core").InputSignal<boolean>;
   /** Rules for `passwordRequirements`; default = the library's five rules (8+ characters, upper, lower, digit, special). */
   readonly passwordRules: import("@angular/core").InputSignal<readonly PasswordRule[] | undefined>;
-  readonly type: import("@angular/core").InputSignal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  readonly type: import("@angular/core").InputSignal<"number" | "email" | "text" | "tel" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -4238,7 +4287,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<"" | "email" | "text" | "none" | "search" | "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>;
@@ -4302,7 +4351,7 @@ export declare class TextInputComponent implements ControlValueAccessor, Validat
   protected readonly _stepAttr: import("@angular/core").Signal<string | null>;
   protected readonly _revealable: import("@angular/core").Signal<boolean>;
   protected readonly _shown: import("@angular/core").WritableSignal<boolean>;
-  protected readonly _inputType: import("@angular/core").Signal<"number" | "text" | "email" | "tel" | "password" | "url">;
+  protected readonly _inputType: import("@angular/core").Signal<"number" | "email" | "text" | "tel" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -5826,7 +5875,7 @@ export declare class FormSectionComponent {
   }, {}, never, ["*"], true, never>;
 }
 export declare class FormRowComponent {
-  readonly cols: import("@angular/core").InputSignal<1 | 2 | 3 | 4>;
+  readonly cols: import("@angular/core").InputSignal<3 | 1 | 2 | 4>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormRowComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<FormRowComponent, "ui-form-row", never, {
     "cols": {
@@ -5843,7 +5892,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<"" | 3 | 2 | "2" | "3" | "all">;
   protected readonly _class: import("@angular/core").Signal<string>;
   static ɵfac: i0.ɵɵFactoryDeclaration<FormColSpanDirective, never>;
   static ɵdir: i0.ɵɵDirectiveDeclaration<FormColSpanDirective, "[uiColSpan]", never, {
@@ -7611,7 +7660,9 @@ 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. Emits `rangeChange` with the
+ * 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
  * 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)" />
@@ -7627,9 +7678,19 @@ export declare class DateRangePickerComponent {
   readonly rangeChange: import("@angular/core").OutputEmitterRef<DateRange>;
   /** Follows `activePreset` from the host, and the user's own picks in between. */
   protected readonly selectedPreset: import("@angular/core").WritableSignal<DatePreset>;
+  /** The popover was closed (Apply / Escape / outside click); any preset change reopens it. */
+  private readonly popoverDismissed;
+  protected readonly popoverVisible: import("@angular/core").Signal<boolean>;
+  protected readonly popTop: import("@angular/core").WritableSignal<number>;
+  protected readonly popRight: import("@angular/core").WritableSignal<number>;
+  private readonly host;
   protected readonly customStart: import("@angular/core").WritableSignal<string>;
   protected readonly customEnd: import("@angular/core").WritableSignal<string>;
   protected readonly presetTabs: import("@angular/core").Signal<PillTab[]>;
+  constructor();
+  private place;
+  protected onDocumentClick(e: Event): void;
+  protected onEscape(e: Event): void;
   selectPreset(key: DatePreset): void;
   applyCustom(): void;
   static ɵfac: i0.ɵɵFactoryDeclaration<DateRangePickerComponent, never>;
@@ -8422,7 +8483,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 | 4 | 5 | 6 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<5 | 3 | 1 | 2 | 4 | 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. */