cursedbelt 5.40.0 → 5.45.0

package/dist/react/components/Alert.js

@@ -1,5 +1,6 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { AlertTriangle, CheckCircle, Info, X, XCircle } from 'lucide-react';
+import { useState } from 'react';
 import { cn } from '../lib/cn.js';
 import { IconButton } from './IconButton.js';
 /*
@@ -22,9 +23,41 @@ const DEFAULT_ICON = {
     error: _jsx(XCircle, {}),
     muted: _jsx(Info, {}),
 };
-export function Alert({ tone = 'info', title, icon, actions, onDismiss, dismissLabel = 'Dismiss', className, children, }) {
+/** The localStorage namespace for a dismissed `Alert`'s `dismissKey`. */
+export const ALERT_DISMISS_STORAGE_PREFIX = 'cb:alert-dismissed:';
+function readDismissed(key) {
+    if (!key)
+        return false;
+    try {
+        return globalThis.localStorage?.getItem(ALERT_DISMISS_STORAGE_PREFIX + key) !== null;
+    }
+    catch {
+        return false; // storage refused (a private window): the caveat shows, which is the safe side
+    }
+}
+function writeDismissed(key) {
+    if (!key)
+        return;
+    try {
+        globalThis.localStorage?.setItem(ALERT_DISMISS_STORAGE_PREFIX + key, new Date().toISOString());
+    }
+    catch {
+        // Not persisted; it is still gone for this mount.
+    }
+}
+export function Alert({ tone = 'info', title, icon, actions, onDismiss, dismissLabel = 'Dismiss', dismissible = false, dismissKey, className, children, }) {
+    const [dismissed, setDismissed] = useState(() => dismissible && readDismissed(dismissKey));
+    if (dismissed)
+        return null;
+    const dismiss = dismissible
+        ? () => {
+            writeDismissed(dismissKey);
+            setDismissed(true);
+            onDismiss?.();
+        }
+        : onDismiss;
     return (_jsxs("div", { 
         // Errors are assertive (`alert`); the rest are polite live regions (`status`).
-        role: tone === 'error' ? 'alert' : 'status', className: cn('flex gap-3 rounded-lg border p-4', TONE[tone], className), children: [icon !== false && (_jsx("span", { className: 'alert-icon mt-0.5 shrink-0 [&_svg]:size-4', children: icon ?? DEFAULT_ICON[tone] })), _jsxs("div", { className: 'flex min-w-0 flex-1 flex-col gap-1', children: [title && _jsx("p", { className: 'wrap-anywhere text-sm font-medium text-foreground', children: title }), children && _jsx("div", { className: 'wrap-anywhere text-sm text-muted-foreground', children: children }), actions && _jsx("div", { className: 'mt-2 flex flex-wrap gap-2', children: actions })] }), onDismiss && (_jsx(IconButton, { label: dismissLabel, onClick: onDismiss, className: 'alert-icon h-auto min-h-0 w-auto shrink-0 rounded p-0.5 text-current hover:opacity-70 hover:bg-transparent [&_svg]:size-4', children: _jsx(X, {}) }))] }));
+        role: tone === 'error' ? 'alert' : 'status', className: cn('flex gap-3 rounded-lg border p-4', TONE[tone], className), children: [icon !== false && (_jsx("span", { className: 'alert-icon mt-0.5 shrink-0 [&_svg]:size-4', children: icon ?? DEFAULT_ICON[tone] })), _jsxs("div", { className: 'flex min-w-0 flex-1 flex-col gap-1', children: [title && _jsx("p", { className: 'wrap-anywhere text-sm font-medium text-foreground', children: title }), children && _jsx("div", { className: 'wrap-anywhere text-sm text-muted-foreground', children: children }), actions && _jsx("div", { className: 'mt-2 flex flex-wrap gap-2', children: actions })] }), dismiss && (_jsx(IconButton, { label: dismissLabel, onClick: dismiss, className: 'alert-icon h-auto min-h-0 w-auto shrink-0 rounded p-0.5 text-current hover:opacity-70 hover:bg-transparent [&_svg]:size-4', children: _jsx(X, {}) }))] }));
 }
 //# sourceMappingURL=Alert.js.map

package/dist/react/components/Alert.js.map

@@ -1 +1 @@
-{"version":3,"file":"Alert.js","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;GAKG;AACH,MAAM,IAAI,GAAG;IACX,IAAI,EAAE,0DAA0D;IAChE,OAAO,EAAE,6DAA6D;IACtE,OAAO,EAAE,6DAA6D;IACtE,KAAK,EAAE,yEAAyE;IAChF,KAAK,EAAE,8DAA8D;CAC7D,CAAC;AAIX,MAAM,YAAY,GAAiC;IACjD,IAAI,EAAE,KAAC,IAAI,KAAG;IACd,OAAO,EAAE,KAAC,WAAW,KAAG;IACxB,OAAO,EAAE,KAAC,aAAa,KAAG;IAC1B,KAAK,EAAE,KAAC,OAAO,KAAG;IAClB,KAAK,EAAE,KAAC,IAAI,KAAG;CAChB,CAAC;AAmBF,MAAM,UAAU,KAAK,CAAC,EACpB,IAAI,GAAG,MAAM,EACb,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,YAAY,GAAG,SAAS,EACxB,SAAS,EACT,QAAQ,GACG;IACX,OAAO,CACL;QACE,+EAA+E;QAC/E,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,EAC3C,SAAS,EAAE,EAAE,CAAC,kCAAkC,EAAE,IAAI,CAAC,IAAI,CAAC,EAAE,SAAS,CAAC,aAEvE,IAAI,KAAK,KAAK,IAAI,CACjB,eAAM,SAAS,EAAC,2CAA2C,YACxD,IAAI,IAAI,YAAY,CAAC,IAAI,CAAC,GACtB,CACR,EACD,eAAK,SAAS,EAAC,oCAAoC,aAChD,KAAK,IAAI,YAAG,SAAS,EAAC,mDAAmD,YAAE,KAAK,GAAK,EACrF,QAAQ,IAAI,cAAK,SAAS,EAAC,6CAA6C,YAAE,QAAQ,GAAO,EACzF,OAAO,IAAI,cAAK,SAAS,EAAC,2BAA2B,YAAE,OAAO,GAAO,IAClE,EACL,SAAS,IAAI,CACZ,KAAC,UAAU,IACT,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,SAAS,EAClB,SAAS,EAAC,2HAA2H,YAErI,KAAC,CAAC,KAAG,GACM,CACd,IACG,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"Alert.js","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":"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"}

package/dist/react/components/AppShell.d.ts

@@ -1,17 +1,22 @@
-import type { ElementType, ReactNode, Ref } from 'react';
-import type { GateFn, NavigationModel, NavPreferences } from 'cursedbelt-core/navigation';
-import type { IconResolver, NavBadgeTone } from '../nav/navShared.js';
+import { type ElementType, type ReactNode, type Ref } from 'react';
+import { type GateFn, type NavigationModel, type NavPreferences } from 'cursedbelt-core/navigation';
+import { type IconResolver, type NavBadgeTone } from '../nav/navShared.js';
 import { type AmbientBackdropProps } from './AmbientBackdrop.js';
+import { type ShellBanner } from './BannerLane.js';
 import { type ScrollAreaSpace } from './ScrollArea.js';
 export interface AppShellProps {
     /** Routed page content. Scrolls inside the single keyboard-safe `ScrollArea`. */
     children: ReactNode;
     /**
-     * The navigation model — the single `navigationModel` registry generalized to the
-     * UX north-star's **small fixed place-set** (Today/Library/People/Calendar/Play +
-     * a role-gated Operate). The shell renders it as the slim desktop **place rail**
-     * (`SideNav`, md+) and the mobile capture-forward **`PlaceBar`** (below md) — never
-     * a 256px hub list and never a hamburger drawer. Omit for chromeless pages.
+     * The navigation model — the one registry every nav surface reads. The app passes it and
+     * the SHELL picks the pattern from the number of places (NAV-3):
+     *
+     * | places | ≥1024px | 768–1023px | <768px |
+     * |---|---|---|---|
+     * | 2–5 | labeled `TopBar` places in the header's center | same | `PlaceBar`, every place |
+     * | 6+  | `SideNav` with labeled sections, 240px | the 64px icon rail | `PlaceBar`, top 4 + More |
+     *
+     * Six or more places mount the ⌘K `CommandPalette` too (NAV-9). Omit for chromeless pages.
      */
     nav?: NavigationModel;
     /** Visibility gate (auth/role/ctgr) applied to the nav model. Default: allow all. */
@@ -34,8 +39,30 @@ export interface AppShellProps {
     navBadgeTone?: NavBadgeTone;
     /** Brand slot — top-left of the command spine (logo / app name). */
     navHeader?: ReactNode;
-    /** Slot at the bottom of the desktop place rail (theme toggle, secondary links). */
+    /**
+     * The sidebar's footer (NAV-13): the version, `BuildFreshness` and a Settings link, set in
+     * 12px muted type. Only a 6+-place shell has a sidebar; a 2–5-place app keeps these in
+     * Settings → About.
+     */
     navFooter?: ReactNode;
+    /**
+     * App-wide conditions — a sign-in broke, the Mac is asleep, the app is offline — as the ONE
+     * banner lane between the header and the page (NAV-10). One line each; two or more collapse
+     * into "N problems · View". Never a card inside the page.
+     */
+    banners?: readonly ShellBanner[];
+    /**
+     * The header's height (NAV-1): `dense` 48px for a tool (station, desk, binary-server),
+     * `roomy` 64px for media and consumer apps. Unset, it reads `--header-h` (64px; 48px
+     * inside `.cb-dense`).
+     */
+    density?: 'roomy' | 'dense';
+    /**
+     * Mount the shell's own ⌘K `CommandPalette` — every place preloaded, plus whatever pages
+     * contribute through `useCommandSource`. `'auto'` (default) mounts it for 6+ places
+     * (NAV-9). Ignored when the app renders its own through `palette`.
+     */
+    commandPalette?: boolean | 'auto';
     /**
      * Universal capture (UX north-star §8.2) — wired to the command spine's capture
      * hero (desktop) and the `PlaceBar`'s raised center FAB (mobile). Capture is a
@@ -72,7 +99,7 @@ export interface AppShellProps {
      * in the tree is immaterial.
      */
     palette?: ReactNode;
-    /** Max places in the mobile `PlaceBar` thumb zone (rest reachable via command). Default 5. */
+    /** Max places in the mobile `PlaceBar` thumb zone; past it, `max - 1` places + More. Default 5. */
     placeBarMax?: number;
     /** PlaceBar caption policy (`'active'` | `'all'`). Pass `'all'` when place names
      *  are short or icons alone are ambiguous (two grid-glyph plugins side by side
@@ -100,42 +127,37 @@ export interface AppShellProps {
     className?: string;
 }
 /**
- * THE single application shell. One per app — reconciled to the UX north-star
- * (`cursedalchemy/UX_NORTH_STAR.md`, §§6–7, 10; reconciliation #311 + `SHELL.md`).
+ * THE single application shell. One per app — the frame every page sits in
+ * (`docs/design/shell-and-navigation.md`, NAV-1…NAV-14). The app passes ONE navigation
+ * model and the shell decides how to draw it, so no app can pick the wrong pattern:
  *
- * **What changed, and why** (the old form was kept by inertia and failed the §12
- * anti-anchoring gate, not preserved as optimal):
- * - The fixed **256px hub-list sidebar** → a slim, quiet **place rail** (the small
- *   fixed place-set is a defended spatial anchor; the *hub-list form* is not).
- * - The **hamburger → `translate-x` drawer** → the capture-forward **`PlaceBar`**: the
- *   place-set in the thumb zone around a raised center capture FAB (mobile is
- *   capture-forward, not tab-forward — §7).
- * - The buried, invisible ⌘K palette + no capture → the first-class **`CommandBar`
- *   spine**: a visible command/search field (the co-equal second way to move) + a
- *   capture hero (universal capture, §8.2).
- * - The avatar-in-nav → **account chrome** behind the avatar in the spine (not a door).
+ * - **2–5 places** → their labels in the header's center zone (NAV-2: destinations have
+ *   words from 768px up), every place in the `PlaceBar` on a phone.
+ * - **6+ places** → a 240px `SideNav` in labeled sections at ≥1024px, the 64px icon rail
+ *   at 768–1023px, the `PlaceBar` with the top 4 + More on a phone, and a ⌘K
+ *   `CommandPalette` preloaded with every place (NAV-9).
  *
- * What is *kept* (proven optimal, §11): the single `navigationModel` registry + its
- * coverage test (anti-drift substrate), per-user place prefs, badges, and the
- * keyboard-safe single `ScrollArea`. Capabilities preserved; form reimagined.
+ * Kept from the shell before it (owner teardowns 2026-07-15, the UX north-star): the single
+ * `navigationModel` registry and its coverage test, per-user place prefs, badges, universal
+ * capture (the spine's hero on desktop, the `PlaceBar` FAB on a phone), and the
+ * keyboard-safe single `ScrollArea`. No hamburger drawer, ever.
  *
  * Layout model:
  * ```
  *   <div h-dvh flex flex-col overflow-hidden>     ← dvh excludes the mobile URL bar
- *     <header />                                    ← brand + CommandBar spine + account
- *     <div flex min-h-0 grow>                       ← rail + content row
- *       <aside hidden md:flex w-60>                 ← slim place rail (SideNav, md+ only)
+ *     <header h-[--header-h]>                       ← left: brand · center: places or ⌘K field · right: account
+ *     <BannerLane />                                ← NAV-10, only when there is a banner
+ *     <div flex min-h-0 grow>                       ← sidebar + content row
+ *       <aside md:flex lg:hidden w-16 />            ← 6+ places: the icon rail
+ *       <aside lg:flex w-60 />                      ← 6+ places: the sectioned SideNav
  *       <main><ScrollArea>{children}</ScrollArea></main>  ← THE ONLY page scroll container
  *     </div>
  *     <div pb-[safe-area]>                          ← bottomDock + mobile PlaceBar
- *       {bottomDock}
- *       <PlaceBar md:hidden />                       ← capture-forward bottom bar
- *     </div>
  *   </div>
  * ```
  *
  * Keyboard model: `useKeyboardInset` (installed exactly once, here) writes
  * `--keyboard-inset` onto `<html>`; `ScrollArea` reads it via CSS `calc()`.
  */
-export declare function AppShell({ children, nav, navGate, activeHref, onNavigate, navLinkComponent, resolveIcon, navPrefs, onNavPrefsChange, navBadges, navBadgeTone, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax, placeBarLabels, scrollSpace, scrollRef, ambient, className, }: AppShellProps): import("react").JSX.Element;
+export declare function AppShell(props: AppShellProps): import("react").JSX.Element;
 //# sourceMappingURL=AppShell.d.ts.map

package/dist/react/components/AppShell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,GAAG,EAA2B,MAAM,OAAO,CAAC;AAC5F,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,4BAA4B,CAAC;AAKpC,OAAO,EAAE,KAAK,YAAY,EAAkB,KAAK,YAAY,EAA0B,MAAM,qBAAqB,CAAC;AAOnH,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEnE,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;;;;;OAUG;IACH,GAAG,CAAC,EAAE,eAAe,CAAC;IAEtB,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAE/B,iEAAiE;IACjE,WAAW,CAAC,EAAE,YAAY,CAAC;IAE3B,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAElD,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IAC5C;0EACsE;IACtE,YAAY,CAAC,EAAE,YAAY,CAAC;IAE5B,oEAAoE;IACpE,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,WAAW,EAAE,CAAC;IAEjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAE5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAElC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,qDAAqD;IACrD,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,IAAI,CAAC;IAC3B,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,+EAA+E;IAC/E,eAAe,CAAC,EAAE,SAAS,CAAC;IAE5B;gEAC4D;IAC5D,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,CAAC;IAEvB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IAEpB,mGAAmG;IACnG,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;iFAE6E;IAC7E,cAAc,CAAC,EAAE,QAAQ,GAAG,KAAK,CAAC;IAElC,uFAAuF;IACvF,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAEzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAOD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,+BAQ5C"}

package/dist/react/components/AppShell.js

@@ -1,66 +1,156 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useLayoutEffect, useRef } from 'react';
+import { allowAllGate, deriveSideNavDomains, } from 'cursedbelt-core/navigation';
 import { useKeyboardInset } from '../hooks/useKeyboardInset.js';
 import { cn } from '../lib/cn.js';
+import { devWarnOnce } from '../lib/devWarn.js';
 import { CommandBar } from '../nav/CommandBar.js';
+import { isDomainActive, renderIcon, routeClick } from '../nav/navShared.js';
 import { PlaceBar } from '../nav/PlaceBar.js';
 import { SideNav } from '../nav/SideNav.js';
+import { TopBarPlaces } from '../nav/TopBar.js';
+import { CommandPalette } from '../palette/CommandPalette.js';
+import { CommandSourceProvider, useCommandSources } from '../palette/commandSources.js';
+import { useCommandPalette } from '../palette/useCommandPalette.js';
 import { AmbientBackdrop } from './AmbientBackdrop.js';
+import { BannerLane } from './BannerLane.js';
 import { ScrollArea } from './ScrollArea.js';
-// The desktop place rail is a *small spatial floor* (a handful of places), not the old
-// 256px hub list — slimmer + quiet, with the command spine carrying the second way to move.
-const RAIL_WIDTH = 'w-60'; // 240px
+/** NAV-3's line: up to this many places ride a labeled top bar; past it, a sectioned sidebar. */
+const TOP_BAR_MAX_PLACES = 5;
+/** Past this many places, a sidebar with no sections is a wall (NAV-3: ≤7 items a section). */
+const UNSECTIONED_MAX_PLACES = 7;
 /**
- * THE single application shell. One per app — reconciled to the UX north-star
- * (`cursedalchemy/UX_NORTH_STAR.md`, §§6–7, 10; reconciliation #311 + `SHELL.md`).
+ * THE single application shell. One per app — the frame every page sits in
+ * (`docs/design/shell-and-navigation.md`, NAV-1…NAV-14). The app passes ONE navigation
+ * model and the shell decides how to draw it, so no app can pick the wrong pattern:
  *
- * **What changed, and why** (the old form was kept by inertia and failed the §12
- * anti-anchoring gate, not preserved as optimal):
- * - The fixed **256px hub-list sidebar** → a slim, quiet **place rail** (the small
- *   fixed place-set is a defended spatial anchor; the *hub-list form* is not).
- * - The **hamburger → `translate-x` drawer** → the capture-forward **`PlaceBar`**: the
- *   place-set in the thumb zone around a raised center capture FAB (mobile is
- *   capture-forward, not tab-forward — §7).
- * - The buried, invisible ⌘K palette + no capture → the first-class **`CommandBar`
- *   spine**: a visible command/search field (the co-equal second way to move) + a
- *   capture hero (universal capture, §8.2).
- * - The avatar-in-nav → **account chrome** behind the avatar in the spine (not a door).
+ * - **2–5 places** → their labels in the header's center zone (NAV-2: destinations have
+ *   words from 768px up), every place in the `PlaceBar` on a phone.
+ * - **6+ places** → a 240px `SideNav` in labeled sections at ≥1024px, the 64px icon rail
+ *   at 768–1023px, the `PlaceBar` with the top 4 + More on a phone, and a ⌘K
+ *   `CommandPalette` preloaded with every place (NAV-9).
  *
- * What is *kept* (proven optimal, §11): the single `navigationModel` registry + its
- * coverage test (anti-drift substrate), per-user place prefs, badges, and the
- * keyboard-safe single `ScrollArea`. Capabilities preserved; form reimagined.
+ * Kept from the shell before it (owner teardowns 2026-07-15, the UX north-star): the single
+ * `navigationModel` registry and its coverage test, per-user place prefs, badges, universal
+ * capture (the spine's hero on desktop, the `PlaceBar` FAB on a phone), and the
+ * keyboard-safe single `ScrollArea`. No hamburger drawer, ever.
  *
  * Layout model:
  * ```
  *   <div h-dvh flex flex-col overflow-hidden>     ← dvh excludes the mobile URL bar
- *     <header />                                    ← brand + CommandBar spine + account
- *     <div flex min-h-0 grow>                       ← rail + content row
- *       <aside hidden md:flex w-60>                 ← slim place rail (SideNav, md+ only)
+ *     <header h-[--header-h]>                       ← left: brand · center: places or ⌘K field · right: account
+ *     <BannerLane />                                ← NAV-10, only when there is a banner
+ *     <div flex min-h-0 grow>                       ← sidebar + content row
+ *       <aside md:flex lg:hidden w-16 />            ← 6+ places: the icon rail
+ *       <aside lg:flex w-60 />                      ← 6+ places: the sectioned SideNav
  *       <main><ScrollArea>{children}</ScrollArea></main>  ← THE ONLY page scroll container
  *     </div>
  *     <div pb-[safe-area]>                          ← bottomDock + mobile PlaceBar
- *       {bottomDock}
- *       <PlaceBar md:hidden />                       ← capture-forward bottom bar
- *     </div>
  *   </div>
  * ```
  *
  * Keyboard model: `useKeyboardInset` (installed exactly once, here) writes
  * `--keyboard-inset` onto `<html>`; `ScrollArea` reads it via CSS `calc()`.
  */
-export function AppShell({ children, nav, navGate, activeHref, onNavigate, navLinkComponent, resolveIcon, navPrefs, onNavPrefsChange, navBadges, navBadgeTone, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax = 5, placeBarLabels = 'active', scrollSpace = 'default', scrollRef, ambient, className, }) {
+export function AppShell(props) {
+    // The provider sits ABOVE the shell, so a page anywhere in `children` can contribute to the
+    // palette the shell mounts, and the shell can read what they contributed.
+    return (_jsx(CommandSourceProvider, { children: _jsx(Shell, { ...props }) }));
+}
+function Shell({ children, nav, navGate = allowAllGate, activeHref, onNavigate, navLinkComponent, resolveIcon, navPrefs, onNavPrefsChange, navBadges, navBadgeTone, navHeader, navFooter, banners, density, commandPalette = 'auto', onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax = 5, placeBarLabels = 'active', scrollSpace = 'default', scrollRef, ambient, className, }) {
     useKeyboardInset();
-    const showSpine = Boolean(navHeader || account || onOpenCommand || onCapture || commandBarExtra);
+    const places = nav ? deriveSideNavDomains(nav, navGate) : [];
+    const pattern = !nav ? 'none' : places.length <= TOP_BAR_MAX_PLACES ? 'top' : 'side';
+    if (pattern === 'side' && places.length > UNSECTIONED_MAX_PLACES && !places.some((d) => d.section)) {
+        devWarnOnce('AppShell:unsectioned', `cursedbelt: <AppShell> was given ${places.length} places and no sections. NAV-3 wants 2–5 labeled sections ` +
+            'of ≤7 places each — give each NavDomain a `section` ("Operate", "Insight", "Limits", "Records").');
+    }
+    // NAV-9: the shell's own palette, unless the app renders one.
+    const ownPalette = !palette && Boolean(nav) && (commandPalette === 'auto' ? pattern === 'side' : commandPalette);
+    const paletteControls = useCommandPalette({ enabled: ownPalette });
+    const sources = useCommandSources();
+    const openCommand = onOpenCommand ?? (ownPalette ? paletteControls.toggle : undefined);
+    const navigate = (path) => {
+        if (onNavigate)
+            onNavigate(path);
+        else
+            window.location.assign(path);
+    };
+    const showSpine = Boolean(nav || navHeader || account || openCommand || onCapture || commandBarExtra);
     const showBottom = Boolean(bottomDock || nav);
+    const bottomChromeRef = usePublishedBottomChrome(showBottom);
     // Chrome that lets the field through. The rails/spine keep their own directional
     // border either way — only the FILL changes, so the layout is byte-identical and
     // an app can flip `ambient` on and off without anything reflowing.
     const chrome = ambient ? 'cb-glass-chrome' : 'bg-background';
-    return (_jsxs("div", { "data-cb-appshell": '', className: cn('flex h-dvh flex-col overflow-hidden bg-background text-foreground', 
+    const commandBar = (_jsx(CommandBar
+    // The search field is capped and centered: a 2000px-wide input reads as a form, not a
+    // header (Linear and GitHub cap theirs the same way).
+    , { 
+        // The search field is capped and centered: a 2000px-wide input reads as a form, not a
+        // header (Linear and GitHub cap theirs the same way).
+        className: pattern === 'top' ? 'shrink-0' : 'min-w-0 max-w-2xl flex-1', compact: pattern === 'top', onCapture: onCapture, captureLabel: captureLabel, 
+        // On mobile the PlaceBar FAB owns capture — don't duplicate it in the spine.
+        captureDesktopOnly: Boolean(nav), onOpenCommand: openCommand, commandPlaceholder: commandLabel, commandHint: commandHint, extra: commandBarExtra }));
+    const sideNavProps = {
+        model: nav,
+        gate: navGate,
+        activeHref,
+        onNavigate,
+        linkComponent: navLinkComponent,
+        resolveIcon,
+        prefs: navPrefs,
+        badges: navBadges,
+        badgeTone: navBadgeTone,
+        footer: navFooter,
+    };
+    return (_jsxs("div", { "data-cb-appshell": '', "data-cb-nav-pattern": pattern, className: cn('flex h-dvh flex-col overflow-hidden bg-background text-foreground', 
         // `isolation: isolate` is load-bearing, not decoration: the blobs blend with
         // `mix-blend-mode: screen`, and without a stacking context here they would
         // blend against whatever is painted behind the app instead of against it.
-        ambient && 'cb-ambient-host', className), children: [ambient ? (_jsx(AmbientBackdrop, { position: 'absolute', ...(ambient === true ? {} : ambient) })) : null, showSpine && (_jsxs("header", { "data-cb-appheader": '', className: cn('relative z-30 flex shrink-0 items-center gap-3 border-b border-border px-3 py-2', ambient && chrome), children: [navHeader && _jsx("div", { className: 'shrink-0', children: navHeader }), _jsx(CommandBar, { className: 'min-w-0 flex-1', onCapture: onCapture, captureLabel: captureLabel, 
-                        // On mobile the PlaceBar FAB owns capture — don't duplicate it in the spine.
-                        captureDesktopOnly: Boolean(nav), onOpenCommand: onOpenCommand, commandPlaceholder: commandLabel, commandHint: commandHint, extra: commandBarExtra }), account && (_jsx("div", { "data-cb-account": '', className: 'shrink-0', children: account }))] })), _jsxs("div", { className: 'relative flex min-h-0 grow overflow-hidden', children: [nav && (_jsxs(_Fragment, { children: [_jsx("aside", { "data-cb-nav-rail": '', className: cn('hidden w-16 border-r border-border md:flex md:shrink-0 md:flex-col lg:hidden', chrome), children: _jsx(SideNav, { model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, prefs: navPrefs, collapsed: true, badges: navBadges, badgeTone: navBadgeTone, footer: navFooter }) }), _jsx("aside", { "data-cb-nav-rail": '', className: cn('hidden border-r border-border lg:flex lg:shrink-0 lg:flex-col', chrome, RAIL_WIDTH), children: _jsx(SideNav, { model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, prefs: navPrefs, onPrefsChange: onNavPrefsChange, badges: navBadges, badgeTone: navBadgeTone, footer: navFooter }) })] })), _jsx("main", { className: 'flex min-h-0 min-w-0 grow flex-col', children: _jsx(ScrollArea, { space: scrollSpace, scrollRef: scrollRef, children: children }) })] }), showBottom && (_jsxs("div", { className: 'shrink-0 pb-[env(safe-area-inset-bottom,0px)]', children: [bottomDock && _jsx("div", { className: 'border-t border-border', children: bottomDock }), nav && (_jsx(PlaceBar, { className: cn('border-t border-border md:hidden', ambient && chrome), model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, badges: navBadges, badgeTone: navBadgeTone, onCapture: onCapture, captureLabel: captureLabel, max: placeBarMax, labels: placeBarLabels }))] })), palette] }));
+        ambient && 'cb-ambient-host', className), children: [ambient ? (_jsx(AmbientBackdrop, { position: 'absolute', ...(ambient === true ? {} : ambient) })) : null, showSpine && (_jsxs("header", { "data-cb-appheader": '', "data-cb-density": density, className: cn('relative z-30 flex shrink-0 items-center gap-3 border-b border-border px-3 md:px-6', density === 'dense'
+                    ? 'h-[var(--header-h-dense)]'
+                    : density === 'roomy'
+                        ? 'h-[var(--header-h-roomy)]'
+                        : 'h-[var(--header-h)]', ambient && chrome), children: [_jsx("div", { "data-cb-header-zone": 'left', className: 'flex shrink-0 items-center', children: navHeader }), _jsx("div", { "data-cb-header-zone": 'center', className: 'flex h-full min-w-0 flex-1 items-center justify-center', children: pattern === 'top' ? (_jsx(TopBarPlaces
+                        // Below 768px the PlaceBar carries every place (NAV-14), so the header doesn't.
+                        , { 
+                            // Below 768px the PlaceBar carries every place (NAV-14), so the header doesn't.
+                            phonePlaces: 'none', linkComponent: navLinkComponent, items: places.map((d) => ({
+                                id: d.id,
+                                label: d.label,
+                                icon: renderIcon(resolveIcon, d.icon),
+                                href: d.path,
+                                active: isDomainActive(d, activeHref),
+                                badge: navBadges?.[d.id],
+                                badgeTone: navBadgeTone,
+                                unavailable: d.hostLimit && d.hostLimit.navigable !== true ? d.hostLimit.reason : undefined,
+                                linkProps: navLinkComponent ? undefined : { onClick: routeClick(d.path, onNavigate) },
+                            })) })) : (commandBar) }), (pattern === 'top' || account) && (_jsxs("div", { "data-cb-header-zone": 'right', className: 'flex shrink-0 items-center gap-2', children: [pattern === 'top' ? commandBar : null, account && (_jsx("div", { "data-cb-account": '', className: 'shrink-0', children: account }))] }))] })), banners && banners.length > 0 ? _jsx(BannerLane, { banners: banners, className: cn(ambient && chrome) }) : null, _jsxs("div", { className: 'relative flex min-h-0 grow overflow-hidden', children: [pattern === 'side' && (_jsxs(_Fragment, { children: [_jsx("aside", { "data-cb-nav-rail": '', "data-cb-nav-collapsed": '', className: cn('hidden w-[var(--rail-w-collapsed)] border-r border-border md:flex md:shrink-0 md:flex-col lg:hidden', chrome), children: _jsx(SideNav, { ...sideNavProps, collapsed: true }) }), _jsx("aside", { "data-cb-nav-rail": '', className: cn('hidden w-[var(--rail-w)] border-r border-border lg:flex lg:shrink-0 lg:flex-col', chrome), children: _jsx(SideNav, { ...sideNavProps, onPrefsChange: onNavPrefsChange }) })] })), _jsx("main", { className: 'flex min-h-0 min-w-0 grow flex-col', children: _jsx(ScrollArea, { space: scrollSpace, scrollRef: scrollRef, children: children }) })] }), showBottom && (_jsxs("div", { ref: bottomChromeRef, className: 'shrink-0 pb-[env(safe-area-inset-bottom,0px)]', children: [bottomDock && _jsx("div", { className: 'border-t border-border', children: bottomDock }), nav && (_jsx(PlaceBar, { className: cn('border-t border-border md:hidden', ambient && chrome), model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, badges: navBadges, badgeTone: navBadgeTone, onCapture: onCapture, captureLabel: captureLabel, max: placeBarMax, labels: placeBarLabels }))] })), palette, ownPalette && nav ? (_jsx(CommandPalette, { model: nav, gate: navGate, open: paletteControls.open, onOpenChange: paletteControls.setOpen, onNavigate: navigate, resolveIcon: resolveIcon, currentPath: activeHref, places: true, sources: sources })) : null] }));
+}
+/**
+ * Publishes the bottom chrome's height (dock + `PlaceBar` + safe area) as
+ * `--cb-bottom-chrome-h` on the root, so what floats over the page — the `Toaster`'s stack
+ * (OVL-9) — rises above the navigation instead of covering it. A `PlaceBar` hidden at `md` up
+ * measures 0, so the desktop stack drops back to the corner by itself.
+ */
+function usePublishedBottomChrome(shown) {
+    const ref = useRef(null);
+    // biome-ignore lint/correctness/useExhaustiveDependencies: `shown` mounts or drops the element the ref points at.
+    useLayoutEffect(() => {
+        const el = ref.current;
+        const root = document.documentElement;
+        if (!el)
+            return;
+        const publish = () => root.style.setProperty('--cb-bottom-chrome-h', `${el.offsetHeight}px`);
+        publish();
+        const observer = typeof ResizeObserver === 'undefined' ? null : new ResizeObserver(publish);
+        observer?.observe(el);
+        return () => {
+            observer?.disconnect();
+            root.style.removeProperty('--cb-bottom-chrome-h');
+        };
+    }, [shown]);
+    return ref;
 }
 //# sourceMappingURL=AppShell.js.map

package/dist/react/components/AppShell.js.map

@@ -1 +1 @@
-{"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":";AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,EAAE,EAAE,MAAM,cAAc,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAA6B,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAE,UAAU,EAAwB,MAAM,iBAAiB,CAAC;AAwHnE,uFAAuF;AACvF,4FAA4F;AAC5F,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,QAAQ;AAEnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,UAAU,QAAQ,CAAC,EACvB,QAAQ,EACR,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,OAAO,EACP,UAAU,EACV,OAAO,EACP,WAAW,GAAG,CAAC,EACf,cAAc,GAAG,QAAQ,EACzB,WAAW,GAAG,SAAS,EACvB,SAAS,EACT,OAAO,EACP,SAAS,GACK;IACd,gBAAgB,EAAE,CAAC;IAEnB,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,IAAI,aAAa,IAAI,SAAS,IAAI,eAAe,CAAC,CAAC;IACjG,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC;IAC9C,iFAAiF;IACjF,iFAAiF;IACjF,mEAAmE;IACnE,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,eAAe,CAAC;IAE7D,OAAO,CACL,mCACmB,EAAE,EACnB,SAAS,EAAE,EAAE,CACX,mEAAmE;QACnE,6EAA6E;QAC7E,2EAA2E;QAC3E,0EAA0E;QAC1E,OAAO,IAAI,iBAAiB,EAC5B,SAAS,CACV,aAMA,OAAO,CAAC,CAAC,CAAC,CACT,KAAC,eAAe,IAAC,QAAQ,EAAC,UAAU,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,GAAI,CAC/E,CAAC,CAAC,CAAC,IAAI,EAGP,SAAS,IAAI,CACZ,uCACoB,EAAE,EACpB,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,OAAO,IAAI,MAAM,CAClB,aAEA,SAAS,IAAI,cAAK,SAAS,EAAC,UAAU,YAAE,SAAS,GAAO,EACzD,KAAC,UAAU,IACT,SAAS,EAAC,gBAAgB,EAC1B,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY;wBAC1B,6EAA6E;wBAC7E,kBAAkB,EAAE,OAAO,CAAC,GAAG,CAAC,EAChC,aAAa,EAAE,aAAa,EAC5B,kBAAkB,EAAE,YAAY,EAChC,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,eAAe,GACtB,EACD,OAAO,IAAI,CACV,iCAAqB,EAAE,EAAC,SAAS,EAAC,UAAU,YACzC,OAAO,GACJ,CACP,IACM,CACV,EAGD,eAAK,SAAS,EAAC,4CAA4C,aAMxD,GAAG,IAAI,CACN,8BACE,oCACmB,EAAE,EACnB,SAAS,EAAE,EAAE,CACX,8EAA8E,EAC9E,MAAM,CACP,YAED,KAAC,OAAO,IACN,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,QAAQ,EACf,SAAS,QACT,MAAM,EAAE,SAAS,EACnB,SAAS,EAAE,YAAY,EACrB,MAAM,EAAE,SAAS,GACjB,GACI,EACR,oCACmB,EAAE,EACnB,SAAS,EAAE,EAAE,CACX,+DAA+D,EAC/D,MAAM,EACN,UAAU,CACX,YAED,KAAC,OAAO,IACN,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,WAAW,EACxB,KAAK,EAAE,QAAQ,EACf,aAAa,EAAE,gBAAgB,EAC/B,MAAM,EAAE,SAAS,EACnB,SAAS,EAAE,YAAY,EACrB,MAAM,EAAE,SAAS,GACjB,GACI,IACP,CACJ,EAMD,eAAM,SAAS,EAAC,oCAAoC,YAClD,KAAC,UAAU,IAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,YACjD,QAAQ,GACE,GACR,IACH,EAGL,UAAU,IAAI,CACb,eAAK,SAAS,EAAC,+CAA+C,aAC3D,UAAU,IAAI,cAAK,SAAS,EAAC,wBAAwB,YAAE,UAAU,GAAO,EACxE,GAAG,IAAI,CACN,KAAC,QAAQ,IACP,SAAS,EAAE,EAAE,CAAC,kCAAkC,EAAE,OAAO,IAAI,MAAM,CAAC,EACpE,KAAK,EAAE,GAAG,EACV,IAAI,EAAE,OAAO,EACb,UAAU,EAAE,UAAU,EACtB,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,gBAAgB,EAC/B,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,YAAY,EACvB,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,WAAW,EAChB,MAAM,EAAE,cAAc,GACtB,CACH,IACG,CACP,EAGA,OAAO,IACJ,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"AppShell.js","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":"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"}

package/dist/react/components/AsyncPanel.d.ts

@@ -1,4 +1,5 @@
-import type { ReactNode } from 'react';
+import { type ReactNode } from 'react';
+import { type SkeletonVariant } from './Skeleton.js';
 export interface AsyncPanelProps {
     loading?: boolean;
     /** Anything truthy renders the degraded state; an Error's message is used. */
@@ -8,8 +9,23 @@ export interface AsyncPanelProps {
     /** Copy for the empty state. */
     emptyTitle?: ReactNode;
     emptyDescription?: ReactNode;
-    /** Rows of skeleton to show while loading. Default 3. */
+    /** Rows (or tiles) of skeleton to show while loading. Default 3. */
     skeletonRows?: number;
+    /**
+     * The SHAPE of the first-load skeleton (STA-1): `rows` for a list or table, `tiles` for a
+     * stat strip, `chart` for a chart frame at the chart's own height. Default `rows`.
+     */
+    skeleton?: SkeletonVariant;
+    /**
+     * A refetch is in flight while the panel already shows data (STA-2). The data stays and a
+     * quiet "Updating…" replaces the freshness stamp — the panel never blanks to a skeleton on
+     * every poll. `loading` after the first content behaves the same way on its own.
+     */
+    refreshing?: boolean;
+    /** When the shown data was fetched — rendered as "Updated 12s ago" (STA-2, STA-8). */
+    updatedAt?: number | Date | null;
+    /** Past this age the stamp turns amber and says so ("No update for 5m", STA-8). */
+    staleAfterMs?: number;
     /**
      * Names the failing section in its error message ("AWS cost is unavailable").
      * Without it the reader gets "Something went wrong" on a page of twelve
@@ -20,6 +36,8 @@ export interface AsyncPanelProps {
     onRetryAction?: ReactNode;
     children: ReactNode;
 }
+/** "just now", "12s ago", "3m ago", "2h ago", "4d ago" — the freshness stamp's wording. */
+export declare function ageLabel(ms: number): string;
 /**
  * The per-section error envelope: one panel's failure degrades that panel, never
  * the page.
@@ -35,5 +53,5 @@ export interface AsyncPanelProps {
  * query, a `{ok:false}` section), which is the common case. Wrap it in an
  * `ErrorBoundary` as well if the child can also throw during render.
  */
-export declare function AsyncPanel({ loading, error, empty, emptyTitle, emptyDescription, skeletonRows, label, onRetryAction, children, }: AsyncPanelProps): import("react").JSX.Element;
+export declare function AsyncPanel({ loading, error, empty, emptyTitle, emptyDescription, skeletonRows, skeleton, refreshing, updatedAt, staleAfterMs, label, onRetryAction, children, }: AsyncPanelProps): import("react").JSX.Element;
 //# sourceMappingURL=AsyncPanel.d.ts.map

package/dist/react/components/AsyncPanel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncPanel.d.ts","sourceRoot":"","sources":["../../../src/react/components/AsyncPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAKvC,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AASD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,KAAK,EACL,KAAK,EACL,UAA8B,EAC9B,gBAAgB,EAChB,YAAgB,EAChB,KAAK,EACL,aAAa,EACb,QAAQ,GACT,EAAE,eAAe,+BAoBjB"}
+{"version":3,"file":"AsyncPanel.d.ts","sourceRoot":"","sources":["../../../src/react/components/AsyncPanel.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,OAAO,CAAC;AAGpE,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,8EAA8E;IAC9E,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kDAAkD;IAClD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,gBAAgB,CAAC,EAAE,SAAS,CAAC;IAC7B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sFAAsF;IACtF,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC;IACjC,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8DAA8D;IAC9D,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,2FAA2F;AAC3F,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAS3C;AA6CD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,KAAK,EACL,KAAK,EACL,UAA8B,EAC9B,gBAAgB,EAChB,YAAgB,EAChB,QAAiB,EACjB,UAAkB,EAClB,SAAS,EACT,YAAY,EACZ,KAAK,EACL,aAAa,EACb,QAAQ,GACT,EAAE,eAAe,+BAiCjB"}

package/dist/react/components/AsyncPanel.js

@@ -1,7 +1,43 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { useEffect, useRef, useState } from 'react';
 import { Alert } from './Alert.js';
 import { EmptyState } from './EmptyState.js';
-import { SkeletonList } from './Skeleton.js';
+import { ContentSkeleton } from './Skeleton.js';
+/** "just now", "12s ago", "3m ago", "2h ago", "4d ago" — the freshness stamp's wording. */
+export function ageLabel(ms) {
+    if (!Number.isFinite(ms) || ms < 5_000)
+        return 'just now';
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 48)
+        return `${h}h ago`;
+    return `${Math.floor(h / 24)}d ago`;
+}
+/** Re-render on a slow tick so an age keeps reading true without a refetch. */
+function useNow(active, everyMs = 10_000) {
+    const [now, setNow] = useState(() => Date.now());
+    useEffect(() => {
+        if (!active)
+            return;
+        const id = setInterval(() => setNow(Date.now()), everyMs);
+        return () => clearInterval(id);
+    }, [active, everyMs]);
+    return now;
+}
+function Freshness({ refreshing, updatedAt, staleAfterMs, }) {
+    const at = updatedAt == null ? null : typeof updatedAt === 'number' ? updatedAt : updatedAt.getTime();
+    const now = useNow(at != null);
+    if (!refreshing && at == null)
+        return null;
+    const age = at == null ? 0 : Math.max(0, now - at);
+    const stale = !refreshing && staleAfterMs != null && at != null && age > staleAfterMs;
+    return (_jsx("p", { "data-cb-freshness": refreshing ? 'updating' : stale ? 'stale' : 'fresh', "aria-live": 'polite', className: stale ? 'text-right text-xs tabular-nums text-warning' : 'text-right text-xs tabular-nums text-muted-foreground', children: refreshing ? 'Updating…' : stale ? `No update for ${ageLabel(age).replace(' ago', '')}` : `Updated ${ageLabel(age)}` }));
+}
 const messageOf = (error) => {
     if (error instanceof Error)
         return error.message;
@@ -26,15 +62,23 @@ const messageOf = (error) => {
  * query, a `{ok:false}` section), which is the common case. Wrap it in an
  * `ErrorBoundary` as well if the child can also throw during render.
  */
-export function AsyncPanel({ loading, error, empty, emptyTitle = 'Nothing to show', emptyDescription, skeletonRows = 3, label, onRetryAction, children, }) {
-    if (loading)
-        return _jsx(SkeletonList, { rows: skeletonRows });
+export function AsyncPanel({ loading, error, empty, emptyTitle = 'Nothing to show', emptyDescription, skeletonRows = 3, skeleton = 'rows', refreshing = false, updatedAt, staleAfterMs, label, onRetryAction, children, }) {
+    // STA-2: once the panel has shown its content, a later `loading` is a REFRESH — the content
+    // stays on screen. Only the first load draws the skeleton.
+    const shownContent = useRef(false);
+    if (loading && !shownContent.current) {
+        return _jsx(ContentSkeleton, { variant: skeleton, count: skeletonRows });
+    }
     if (error) {
         return (_jsxs(Alert, { tone: 'warning', ...(onRetryAction ? { action: onRetryAction } : {}), children: [label ? `${label} is unavailable — ` : '', messageOf(error)] }));
     }
     if (empty) {
         return (_jsx(EmptyState, { title: emptyTitle, ...(emptyDescription ? { description: emptyDescription } : {}), compact: true }));
     }
-    return _jsx(_Fragment, { children: children });
+    shownContent.current = true;
+    const busy = refreshing || loading === true;
+    if (!busy && updatedAt == null)
+        return _jsx(_Fragment, { children: children });
+    return (_jsxs("div", { className: 'flex min-w-0 flex-col gap-2', "aria-busy": busy || undefined, children: [_jsx(Freshness, { refreshing: busy, updatedAt: updatedAt, staleAfterMs: staleAfterMs }), children] }));
 }
 //# sourceMappingURL=AsyncPanel.js.map

package/dist/react/components/AsyncPanel.js.map

@@ -1 +1 @@
-{"version":3,"file":"AsyncPanel.js","sourceRoot":"","sources":["../../../src/react/components/AsyncPanel.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAwB7C,MAAM,SAAS,GAAG,CAAC,KAAc,EAAU,EAAE;IAC3C,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK;QAAE,OAAO,MAAM,CAAE,KAA8B,CAAC,OAAO,CAAC,CAAC;IACrH,OAAO,eAAe,CAAC;AACzB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,OAAO,EACP,KAAK,EACL,KAAK,EACL,UAAU,GAAG,iBAAiB,EAC9B,gBAAgB,EAChB,YAAY,GAAG,CAAC,EAChB,KAAK,EACL,aAAa,EACb,QAAQ,GACQ;IAChB,IAAI,OAAO;QAAE,OAAO,KAAC,YAAY,IAAC,IAAI,EAAE,YAAY,GAAI,CAAC;IACzD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,MAAC,KAAK,IAAC,IAAI,EAAC,SAAS,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aACvE,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC,CAAC,EAAE,EACzC,SAAS,CAAC,KAAK,CAAC,IACX,CACT,CAAC;IACJ,CAAC;IACD,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,KAAC,UAAU,IACT,KAAK,EAAE,UAAU,KACb,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAC/D,OAAO,SACP,CACH,CAAC;IACJ,CAAC;IACD,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}
+{"version":3,"file":"AsyncPanel.js","sourceRoot":"","sources":["../../../src/react/components/AsyncPanel.tsx"],"names":[],"mappings":"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"}