@forgeroute/ui 0.4.65 → 0.4.67

package/package.json

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

package/types/forgeroute-ui.d.ts

@@ -1095,7 +1095,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>;
@@ -2682,7 +2682,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" | "metadata" | "auto">;
   /** 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>;
@@ -2936,7 +2936,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<6 | 1 | 2 | 3 | 4 | 5 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 5 | 3 | 6 | 4 | null>;
   readonly indeterminate: import("@angular/core").InputSignal<boolean>;
   readonly checked: import("@angular/core").ModelSignal<boolean>;
   /**
@@ -4948,7 +4948,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" | "text" | "tel" | "email" | "password" | "url">;
   readonly maxlength: import("@angular/core").InputSignal<number | undefined>;
   readonly required: import("@angular/core").InputSignal<boolean>;
   readonly autocomplete: import("@angular/core").InputSignal<string>;
@@ -4957,7 +4957,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" | "numeric" | "none" | "email" | "tel" | "url" | "decimal">;
+  readonly inputmode: import("@angular/core").InputSignal<"" | "none" | "text" | "search" | "tel" | "email" | "url" | "decimal" | "numeric">;
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   readonly hint: import("@angular/core").InputSignal<string>;
   /** Id(s) of an external element that also describes this control (e.g. one shared error text for a group of fields). Space separated; MERGED after the control's own hint / error id in `aria-describedby`, never replacing it. Empty = unchanged. */
@@ -5023,7 +5023,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" | "text" | "tel" | "email" | "password" | "url">;
   protected readonly _eyePath: string;
   protected readonly _eyeOffPath: string;
   protected readonly _showRequirements: import("@angular/core").Signal<boolean>;
@@ -5231,6 +5231,8 @@ export declare class KeypadComponent implements ControlValueAccessor {
   /** Host error message, shown under the dots. */
   readonly error: import("@angular/core").InputSignal<string>;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
+  /** Enter was pressed while the pad had focus: nothing is appended (Enter on a focused key would otherwise press it); the host submits its form. */
+  readonly submitted: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _labelId: string;
   protected readonly _keys: readonly ["1", "2", "3", "4", "5", "6", "7", "8", "9", "", "0", "del"];
   protected readonly _dots: import("@angular/core").Signal<unknown[]>;
@@ -5278,6 +5280,7 @@ export declare class KeypadComponent implements ControlValueAccessor {
     };
   }, {
     "value": "valueChange";
+    "submitted": "submitted";
   }, never, never, true, never>;
 }
 export declare class TextareaInputComponent implements ControlValueAccessor, Validator, UiFieldValidity {
@@ -6490,7 +6493,9 @@ 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">;
+  /** Trigger size for `variant="button"`: `sm` (default, the compact toolbar look) or `md` (same padding and type as a medium `ui-button`). */
+  readonly size: import("@angular/core").InputSignal<"sm" | "md">;
   readonly menuWidth: import("@angular/core").InputSignal<string>;
   /**
    * Fixed width of the trigger as a CSS length (e.g. `'280px'`). Empty (default) = the trigger is as wide as its label. When set, the trigger keeps that
@@ -6521,6 +6526,8 @@ export declare class DropdownComponent {
   private _typeahead;
   private _typeaheadTimer;
   private _destroyed;
+  /** Identifies the current loader request, so a late or stale answer (menu closed / reopened meanwhile) is ignored. */
+  private _loadToken;
   protected readonly triggerId: string;
   protected readonly menuId: string;
   protected readonly _ariaLabel: import("@angular/core").Signal<string | null>;
@@ -6590,6 +6597,11 @@ export declare class DropdownComponent {
       "required": false;
       "isSignal": true;
     };
+    "size": {
+      "alias": "size";
+      "required": false;
+      "isSignal": true;
+    };
     "menuWidth": {
       "alias": "menuWidth";
       "required": false;
@@ -6811,7 +6823,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, {
@@ -7813,6 +7825,10 @@ export declare class PanelInfoListComponent {
   isWeb(href: string): boolean;
   /** Link text: the value, else the email / phone as written. */
   textOf(item: PanelInfoItem): string;
+  /** Plain value, or the dash for an empty / blank one. */
+  valueOf(item: PanelInfoItem): string;
+  /** A disabled header action never runs, even when the click reaches the host element. */
+  runHeaderAction(ha: NonNullable<PanelInfoSection['headerAction']>): void;
   visibleItems(section: PanelInfoSection): PanelInfoItem[];
   static ɵfac: i0.ɵɵFactoryDeclaration<PanelInfoListComponent, never>;
   static ɵcmp: i0.ɵɵComponentDeclaration<PanelInfoListComponent, "ui-panel-info-list", never, {
@@ -8088,6 +8104,8 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
   readonly logoutClick: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _sidebarOpen: import("@angular/core").WritableSignal<boolean>;
   protected readonly _collapsed: import("@angular/core").WritableSignal<boolean>;
+  /** The rail (icons-only sidebar) only exists on the desktop layout; on the drawer layout (≤1024px) a saved rail choice is ignored. */
+  protected readonly _drawerLayout: import("@angular/core").WritableSignal<boolean>;
   protected readonly _isRail: import("@angular/core").Signal<boolean>;
   private readonly _collapsedGroups;
   protected readonly _visibleGroups: import("@angular/core").Signal<NavGroup[]>;
@@ -8096,6 +8114,8 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
   private readonly _iconCache;
   _safeIcon(svg: string): SafeHtml;
   _visibleLinks(group: NavGroup): NavLink[];
+  /** Groups can only be collapsed when there is more than one: a lone group stays open so the navigation can never be hidden. */
+  protected _canCollapseGroups(): boolean;
   _isCollapsed(key: string): boolean;
   toggleGroup(key: string): void;
   private _readSavedGroups;
@@ -8104,9 +8124,26 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
   toggleCollapsed(): void;
   private static readonly _COLLAPSE_KEY;
   private static _loadCollapsed;
+  private readonly _host;
+  private readonly _injector;
+  private readonly _document;
+  /** The drawer layout is exactly the complement of the desktop layout the CSS rail rules use (min-width: 1025px): no viewport width falls in between. */
+  private static readonly _DRAWER_MQ;
+  private static readonly _FOCUSABLE;
+  private _sidebarFocusables;
+  private _hamburger;
   toggleSidebar(): void;
-  closeSidebar(): void;
+  /** Opens the drawer (drawer layout only; a no-op on desktop) and moves keyboard focus into it, so the links behind the backdrop are not reachable until it closes. */
+  openSidebar(): void;
+  /** Closes the drawer; `returnFocus` puts focus back on the hamburger that opened it (keyboard users keep their place). */
+  closeSidebar(returnFocus?: boolean): void;
+  /** Escape closes an open drawer; Tab stays inside it while it is open. */
+  onShellKeydown(e: KeyboardEvent): void;
+  /** Skip link: focuses the main content (`tabindex="-1"`) without changing the URL (the app uses the router). */
+  skipToContent(e: Event): void;
   ngOnInit(): void;
+  private _drawerMq?;
+  private readonly _onDrawerMqChange;
   ngOnDestroy(): void;
   private _expandActiveGroup;
   static ɵfac: i0.ɵɵFactoryDeclaration<AppShellComponent, never>;
@@ -9876,7 +9913,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<6 | 1 | 2 | 3 | 4 | 5 | null>;
+  readonly headingLevel: import("@angular/core").InputSignal<1 | 2 | 5 | 3 | 6 | 4 | 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. */