@forgeroute/ui 0.4.66 → 0.4.68

package/package.json

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

package/src/_detail-columns.scss

@@ -0,0 +1,32 @@
+// Independent column scrolling for detail pages (`<ui-sidebar-layout uiFillViewport>`): the viewport does not scroll; the two columns are capped
+// to the room under the page's top block (`--cols-h`, set by the `uiFillViewport` directive) and each scrolls inside its own box.
+//
+//   @use 'detail-columns' as dc;          // @forgeroute/ui/src is on the stylePreprocessorOptions includePaths
+//   @include dc.independent-columns;      // or (1200px) for collapseAt="lg"
+//
+// Markup: `.detail-page` wraps the page, `.col-main` is the `layout-main` element, `.col-side` is the `layout-side` element.
+// Only applies while the layout has two columns: `$collapse` = the sidebar-layout `collapseAt` width in px (900 = md, 1200 = lg); collapsed it is
+// one column and the page scrolls as usual. `$bleed` is the room inside the main column's scroll box so a focus ring or shadow at its edge is not clipped.
+@mixin independent-columns($collapse: 900px, $bleed: 4px) {
+  @media (min-width: #{$collapse + 1}) {
+    .detail-page { padding-bottom: 0; }   // the columns end at the bottom of the content area
+    .col-main {
+      position: relative;   // visually hidden / absolutely positioned content (sr-only text, menus) stays inside this scroll box; otherwise it is positioned against the page and stretches the document, which then scrolls
+      box-sizing: border-box;
+      padding: $bleed;
+      margin: -$bleed;
+      max-height: calc(var(--cols-h) + #{2 * $bleed});
+      overflow-y: auto;
+      overscroll-behavior: contain;
+      -webkit-overflow-scrolling: touch;
+    }
+    .col-side {
+      display: block;
+      position: relative;   // absolutely positioned content (visually hidden text, menus) stays inside this scroll box; otherwise it would stretch the library's outer side wrapper and give the column a second scrollbar
+      max-height: var(--cols-h);
+      overflow-y: auto;
+      overscroll-behavior: contain;
+      -webkit-overflow-scrolling: touch;
+    }
+  }
+}

package/types/forgeroute-ui.d.ts

@@ -1591,6 +1591,8 @@ export declare class DataTableComponent<T extends Record<string, any>> implement
    */
   private _columnBadgeLabel;
   protected readonly _error: import("@angular/core").WritableSignal<string | null>;
+  /** Phone card list is only a role=list while it contains listitems: skeleton cards or real rows (not error / empty / no-match). */
+  protected readonly _cardListHasItems: Signal<boolean>;
   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
@@ -3963,7 +3965,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<"link" | "primary" | "secondary" | "danger" | "warning" | "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' }`). */
@@ -4009,7 +4011,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" | "reset" | "submit">;
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   readonly loading: import("@angular/core").InputSignal<boolean>;
   readonly fullWidth: import("@angular/core").InputSignal<boolean>;
@@ -4957,7 +4959,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<"" | "search" | "none" | "text" | "email" | "tel" | "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. */
@@ -6493,7 +6495,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<"badge" | "button">;
+  readonly variant: import("@angular/core").InputSignal<"button" | "badge">;
   /** 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>;
@@ -6526,6 +6528,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>;
@@ -7823,6 +7827,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, {
@@ -8080,6 +8088,11 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
    * when the title is not set.
    */
   readonly pageTitle: import("@angular/core").InputSignal<string>;
+  /**
+   * Show the app's toasts (renders one `<ui-toast />` for the whole shell). Default false so an app that already renders its own `<ui-toast />`
+   * is unchanged; an app that sets this removes its own.
+   */
+  readonly showToast: import("@angular/core").InputSignal<boolean>;
   readonly appName: import("@angular/core").InputSignal<string>;
   readonly user: import("@angular/core").InputSignal<ShellUser | null>;
   readonly readOnly: import("@angular/core").InputSignal<boolean>;
@@ -8097,7 +8110,13 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
   readonly persistKey: import("@angular/core").InputSignal<string>;
   readonly logoutClick: import("@angular/core").OutputEmitterRef<void>;
   protected readonly _sidebarOpen: import("@angular/core").WritableSignal<boolean>;
+  /** `data.pageTitle` of the deepest activated route that sets one ('' when none does). Updated on every NavigationEnd. */
+  protected readonly _routeTitle: import("@angular/core").WritableSignal<string>;
+  /** The title shown in the top bar: the `pageTitle` input when the app sets one (it wins), else the route's `data.pageTitle`. */
+  protected readonly _title: import("@angular/core").Signal<string>;
   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[]>;
@@ -8106,6 +8125,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;
@@ -8114,9 +8135,28 @@ 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;
+  /** The `data.pageTitle` of the deepest activated route that has a non-empty string one (a child route's title wins over its parent's). */
+  private _titleOfRoute;
   ngOnDestroy(): void;
   private _expandActiveGroup;
   static ɵfac: i0.ɵɵFactoryDeclaration<AppShellComponent, never>;
@@ -8131,6 +8171,11 @@ export declare class AppShellComponent implements OnInit, OnDestroy {
       "required": false;
       "isSignal": true;
     };
+    "showToast": {
+      "alias": "showToast";
+      "required": false;
+      "isSignal": true;
+    };
     "appName": {
       "alias": "appName";
       "required": false;
@@ -11170,6 +11215,28 @@ export declare class SidebarLayoutComponent {
     };
   }, {}, never, ["[layout-main]", "[layout-side]"], true, never>;
 }
+/**
+ * Independent column scrolling for a detail page's `<ui-sidebar-layout uiFillViewport>`.
+ *
+ * Sets `--cols-h` on the host: the room left between the top of the layout and the bottom of the shell's content area (the nearest
+ * `<main>`). Pair it with the `independent-columns` mixin (`@use 'detail-columns' as dc;` from `@forgeroute/ui/src/_detail-columns.scss`),
+ * which caps both columns to `--cols-h` so each scrolls on its own while the viewport does not scroll.
+ *
+ *   <ui-sidebar-layout uiFillViewport sideWidth="320px" collapseAt="md">
+ *     <div layout-main class="col-main"> ... </div>
+ *     <aside layout-side class="col-side"> ... </aside>
+ *   </ui-sidebar-layout>
+ *
+ * Re-measured when the content area or the element's parent changes size (window resize, tabs wrapping, a card loading). Pure layout maths
+ * on the element's position inside the scroller's content, so it does not depend on how far the page happens to be scrolled. The height is
+ * never below 240px. With no `<main>` ancestor nothing is set. Not related to `ui-page`'s `fillViewport` input (a page at least one viewport high).
+ */
+export declare class FillViewportDirective {
+  private readonly el;
+  constructor();
+  static ɵfac: i0.ɵɵFactoryDeclaration<FillViewportDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<FillViewportDirective, "[uiFillViewport]", never, {}, {}, never, never, true, never>;
+}
 export type ActionBarAlign = 'start' | 'center' | 'end' | 'between';
 /**
  * Bar for page-level actions (Save / Cancel) that stays at the bottom of the scrolling area.