cursedbelt 0.0.0 → 2.3.0

package/dist/react/components/ActionBar.js

@@ -1,7 +1,40 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Children, Fragment, isValidElement } from 'react';
 import { useMediaQuery } from '../hooks/useMediaQuery';
 import { cn } from '../lib/cn';
 const MOBILE_QUERY = '(max-width: 639px)';
+const MOBILE_CHROME = 'sticky bottom-0 z-40 flex flex-col gap-2 border-t border-border bg-background/95 px-4 pt-3 backdrop-blur';
+// Home-indicator clearance (fixed CSS expression, needs the env() literal).
+const MOBILE_SAFE_AREA = 'pb-[max(env(safe-area-inset-bottom,0px),0.75rem)]';
+const DESKTOP_CHROME = 'sticky bottom-0 z-40 flex flex-wrap items-center justify-between gap-2 border-t border-border bg-background px-5 py-3';
+/**
+ * The footer CHROME — padding, top border, opaque background, sticky docking, and the
+ * mobile keyboard/safe-area lift. Split out of {@link ActionBar} so a `Modal`/`Drawer`
+ * footer that is *not* an `ActionBar` can be given the same chrome automatically instead
+ * of rendering flush against the dialog's rounded corner.
+ *
+ * 🔴 **Why this is a component rather than a documented convention.** `Modal`'s `footer`
+ * slot is unpadded by design — `ActionBar` owns the chrome — and `no-raw-modal-footer`
+ * enforces that inside cursedbelt. It does not run over the consumer repos, so
+ * `apps/vault`'s entry editor passed a bare `<div className="flex w-full …">` and its
+ * **Save button rendered half off the bottom-right corner of the modal** (owner
+ * screenshot, 2026-08-16). A convention that only one repo's linter can see is a
+ * convention every other repo will break, so the chrome is now applied by the container:
+ * pass an `ActionBar` and it owns its own, pass anything else and it gets this.
+ *
+ * `flex-wrap` on the desktop row is the second half of the same bug: a footer wider than
+ * the dialog now wraps to a second line instead of overflowing the rounded corner.
+ */
+export function FooterChrome({ children, className }) {
+    const isMobile = useMediaQuery(MOBILE_QUERY);
+    if (isMobile) {
+        return (_jsx("div", { className: cn(MOBILE_CHROME, MOBILE_SAFE_AREA, className), 
+            // Rides above the soft keyboard. Inline because it's a live custom-property value
+            // (a class can't read --keyboard-inset into margin); the pb- above stays a class.
+            style: { marginBottom: 'var(--keyboard-inset, 0px)' }, children: children }));
+    }
+    return _jsx("div", { className: cn(DESKTOP_CHROME, className), children: children });
+}
 /**
  * The one action bar that retires every per-page `border-t … justify-end` footer.
  * Two genuinely different trees per breakpoint (not a squeezed row):
@@ -17,13 +50,39 @@ const MOBILE_QUERY = '(max-width: 639px)';
 export function ActionBar({ primary, secondary, destructive, children, className, }) {
     const isMobile = useMediaQuery(MOBILE_QUERY);
     if (isMobile) {
-        return (_jsxs("div", { "data-cb-action-bar": 'mobile', className: cn('sticky bottom-0 z-40 flex flex-col gap-2 border-t border-border bg-background/95 px-4 pt-3 backdrop-blur', 
-            // Home-indicator clearance (fixed CSS expression, needs the env() literal).
-            'pb-[max(env(safe-area-inset-bottom,0px),0.75rem)]', className), 
+        return (_jsxs("div", { "data-cb-action-bar": 'mobile', className: cn(MOBILE_CHROME, MOBILE_SAFE_AREA, className), 
             // Rides above the soft keyboard. Inline because it's a live custom-property value
             // (a class can't read --keyboard-inset into margin); the pb- above stays a class.
             style: { marginBottom: 'var(--keyboard-inset, 0px)' }, children: [(destructive || children) && (_jsxs("div", { className: 'flex items-center justify-between gap-2', children: [destructive, _jsx("div", { className: 'flex items-center gap-2', children: children })] })), primary && _jsx("div", { className: '[&>button]:w-full', children: primary }), secondary && _jsx("div", { className: '[&>button]:w-full', children: secondary })] }));
     }
-    return (_jsxs("div", { "data-cb-action-bar": 'desktop', className: cn('sticky bottom-0 z-40 flex items-center justify-between gap-2 border-t border-border bg-background px-5 py-3', className), children: [_jsxs("div", { className: 'flex items-center gap-2', children: [destructive, children] }), _jsxs("div", { className: 'flex items-center gap-2', children: [secondary, primary] })] }));
+    return (_jsxs("div", { "data-cb-action-bar": 'desktop', className: cn(DESKTOP_CHROME, className), children: [_jsxs("div", { className: 'flex min-w-0 items-center gap-2', children: [destructive, children] }), _jsxs("div", { className: 'flex min-w-0 items-center gap-2', children: [secondary, primary] })] }));
+}
+/**
+ * True when `node` already renders its own footer chrome — an {@link ActionBar}, either
+ * directly or as the single child of a fragment (the shape a conditional footer usually
+ * takes: `<>{cond && <ActionBar …/>}</>`).
+ */
+function ownsFooterChrome(node) {
+    if (!isValidElement(node))
+        return false;
+    if (node.type === ActionBar)
+        return true;
+    if (node.type === Fragment) {
+        const kids = Children.toArray(node.props.children).filter(Boolean);
+        return kids.length === 1 && ownsFooterChrome(kids[0]);
+    }
+    return false;
+}
+/**
+ * The footer slot a `Modal` / `Drawer` renders. An {@link ActionBar} is passed straight
+ * through (it owns its chrome); **anything else is wrapped in {@link FooterChrome}**, so a
+ * bare `<div>` of buttons can never render flush against the dialog's rounded corner.
+ *
+ * See {@link FooterChrome} for the measured bug this closes (apps/vault, 2026-08-16).
+ */
+export function FooterSlot({ footer }) {
+    if (footer === null || footer === undefined || footer === false)
+        return null;
+    return (_jsx("div", { className: 'flex-none', "data-cb-footer-slot": ownsFooterChrome(footer) ? 'action-bar' : 'wrapped', children: ownsFooterChrome(footer) ? footer : _jsx(FooterChrome, { children: footer }) }));
 }
 //# sourceMappingURL=ActionBar.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"ActionBar.js","sourceRoot":"","sources":["../../../src/react/components/ActionBar.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAe/B,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAE1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,SAAS,CAAC,EACxB,OAAO,EACP,SAAS,EACT,WAAW,EACX,QAAQ,EACR,SAAS,GACM;IACf,MAAM,QAAQ,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;IAE7C,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CACL,qCACqB,QAAQ,EAC3B,SAAS,EAAE,EAAE,CACX,0GAA0G;YAC1G,4EAA4E;YAC5E,mDAAmD,EACnD,SAAS,CACV;YACD,kFAAkF;YAClF,kFAAkF;YAClF,KAAK,EAAE,EAAE,YAAY,EAAE,4BAA4B,EAAE,aAEpD,CAAC,WAAW,IAAI,QAAQ,CAAC,IAAI,CAC5B,eAAK,SAAS,EAAC,yCAAyC,aACrD,WAAW,EACZ,cAAK,SAAS,EAAC,yBAAyB,YAAE,QAAQ,GAAO,IACrD,CACP,EACA,OAAO,IAAI,cAAK,SAAS,EAAC,mBAAmB,YAAE,OAAO,GAAO,EAC7D,SAAS,IAAI,cAAK,SAAS,EAAC,mBAAmB,YAAE,SAAS,GAAO,IAC9D,CACP,CAAC;IACJ,CAAC;IAED,OAAO,CACL,qCACqB,SAAS,EAC5B,SAAS,EAAE,EAAE,CACX,6GAA6G,EAC7G,SAAS,CACV,aAED,eAAK,SAAS,EAAC,yBAAyB,aACrC,WAAW,EACX,QAAQ,IACL,EACN,eAAK,SAAS,EAAC,yBAAyB,aACrC,SAAS,EACT,OAAO,IACJ,IACF,CACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ActionBar.js","sourceRoot":"","sources":["../../../src/react/components/ActionBar.tsx"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,42 @@
+import type { MouseEvent, ReactNode } from 'react';
+import type { ControlSize } from '../lib/field';
+export interface ActionGroupItem {
+    /** Stable identity (React key). */
+    key: string;
+    /** The action's name — the accessible label + tooltip, and the visible text
+     *  when `showLabel` is set (or when there is no `icon`). */
+    label: string;
+    icon?: ReactNode;
+    /** Render the text label beside the icon (default: icon-only when `icon` is set). */
+    showLabel?: boolean;
+    onClick?: (e: MouseEvent<HTMLButtonElement>) => void;
+    /** Async action — inherits {@link Button}'s spinner/success/error handling. */
+    onAsyncClick?: (e: MouseEvent<HTMLButtonElement>) => Promise<unknown>;
+    disabled?: boolean;
+    /** Quiet destructive weight — red text, solid red only on hover/focus. For a
+     *  persisted-item DELETE use {@link DeleteButton} beside the group instead:
+     *  this strip never confirms. */
+    destructive?: boolean;
+}
+export interface ActionGroupProps {
+    items: ActionGroupItem[];
+    /** Control height on the shared scale (default `sm` — these are row utilities). */
+    size?: Exclude<ControlSize, 'lg'>;
+    /** Accessible name for the group (default `'Actions'`). */
+    'aria-label'?: string;
+    className?: string;
+}
+/**
+ * A joined utility-action strip (task cbux-42): one bordered capsule of
+ * tertiary-weight buttons — Up/Down/Delete on a list row, Start/Regen/Logs on an
+ * app row — built ON {@link ButtonGroup} (which owns the segment geometry) with
+ * the single outer border + hairline dividers this pattern wants. Compared to a
+ * raw ButtonGroup of outline buttons, the strip reads as ONE control, so a row
+ * of utilities stops competing with the view's real actions.
+ *
+ * Items render as {@link IconButton}s (icon-only, labeled, tooltipped) or text
+ * {@link Button}s; `destructive` items take the taxonomy's quiet red weight.
+ * Keyboard: each action is a real button — Tab/Shift-Tab move through the strip.
+ */
+export declare function ActionGroup({ items, size, 'aria-label': ariaLabel, className, }: ActionGroupProps): import("react").JSX.Element;
+//# sourceMappingURL=ActionGroup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionGroup.d.ts","sourceRoot":"","sources":["../../../src/react/components/ActionGroup.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAKhD,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ;gEAC4D;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,qFAAqF;IACrF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,IAAI,CAAC;IACrD,+EAA+E;IAC/E,YAAY,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,iBAAiB,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;qCAEiC;IACjC,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,mFAAmF;IACnF,IAAI,CAAC,EAAE,OAAO,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAClC,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,IAAW,EACX,YAAY,EAAE,SAAqB,EACnC,SAAS,GACV,EAAE,gBAAgB,+BAsClB"}

package/dist/react/components/ActionGroup.js

@@ -0,0 +1,33 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { cn } from '../lib/cn';
+import { Button } from './Button';
+import { ButtonGroup } from './ButtonGroup';
+import { IconButton } from './IconButton';
+/**
+ * A joined utility-action strip (task cbux-42): one bordered capsule of
+ * tertiary-weight buttons — Up/Down/Delete on a list row, Start/Regen/Logs on an
+ * app row — built ON {@link ButtonGroup} (which owns the segment geometry) with
+ * the single outer border + hairline dividers this pattern wants. Compared to a
+ * raw ButtonGroup of outline buttons, the strip reads as ONE control, so a row
+ * of utilities stops competing with the view's real actions.
+ *
+ * Items render as {@link IconButton}s (icon-only, labeled, tooltipped) or text
+ * {@link Button}s; `destructive` items take the taxonomy's quiet red weight.
+ * Keyboard: each action is a real button — Tab/Shift-Tab move through the strip.
+ */
+export function ActionGroup({ items, size = 'sm', 'aria-label': ariaLabel = 'Actions', className, }) {
+    return (_jsx(ButtonGroup, { "aria-label": ariaLabel, className: cn('rounded-md border border-border bg-surface', 
+        // Hairline divider between segments (the buttons themselves are ghost-weight,
+        // so ButtonGroup's shared-border overlap has no borders to merge).
+        '[&>button:not(:first-child)]:border-l [&>button:not(:first-child)]:border-border', className), children: items.map((item) => {
+            const variant = item.destructive ? 'destructive' : 'ghost';
+            const common = {
+                variant,
+                disabled: item.disabled,
+                onClick: item.onClick,
+                onAsyncClick: item.onAsyncClick,
+            };
+            return item.icon && !item.showLabel ? (_jsx(IconButton, { label: item.label, size: size, ...common, children: item.icon }, item.key)) : (_jsx(Button, { size: size, tooltip: item.label, leftIcon: item.icon, ...common, children: item.label }, item.key));
+        }) }));
+}
+//# sourceMappingURL=ActionGroup.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ActionGroup.js","sourceRoot":"","sources":["../../../src/react/components/ActionGroup.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAE/B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AA8B1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,WAAW,CAAC,EAC1B,KAAK,EACL,IAAI,GAAG,IAAI,EACX,YAAY,EAAE,SAAS,GAAG,SAAS,EACnC,SAAS,GACQ;IACjB,OAAO,CACL,KAAC,WAAW,kBACE,SAAS,EACrB,SAAS,EAAE,EAAE,CACX,4CAA4C;QAC5C,8EAA8E;QAC9E,mEAAmE;QACnE,kFAAkF,EAClF,SAAS,CACV,YAEA,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAClB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC;YAC3D,MAAM,MAAM,GAAG;gBACb,OAAO;gBACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;aACvB,CAAC;YACX,OAAO,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CACpC,KAAC,UAAU,IAAgB,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,KAAM,MAAM,YACjE,IAAI,CAAC,IAAI,IADK,IAAI,CAAC,GAAG,CAEZ,CACd,CAAC,CAAC,CAAC,CACF,KAAC,MAAM,IAEL,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,IAAI,CAAC,KAAK,EACnB,QAAQ,EAAE,IAAI,CAAC,IAAI,KACf,MAAM,YAET,IAAI,CAAC,KAAK,IANN,IAAI,CAAC,GAAG,CAON,CACV,CAAC;QACJ,CAAC,CAAC,GACU,CACf,CAAC;AACJ,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"AddItemsMenu.d.ts","sourceRoot":"","sources":["../../../src/react/components/AddItemsMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAGvE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,8DAA8D;IAC9D,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IACzC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAC9B,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,KAAa,EACb,SAAiB,EACjB,IAAU,EACV,aAA2B,EAC3B,UAAiB,EACjB,KAAe,EACf,SAAS,EACT,UAA6B,EAC7B,QAAQ,EACR,SAAS,GACV,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BAkEtB"}
+{"version":3,"file":"AddItemsMenu.d.ts","sourceRoot":"","sources":["../../../src/react/components/AddItemsMenu.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAEjD,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,UAAU,CAAC;AAGvE,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,EAAE,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oEAAoE;IACpE,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;IACZ,8DAA8D;IAC9D,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC;IAC7B,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IAClC,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,SAAS,CAAC;IACzC,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,mEAAmE;IACnE,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,EAC9B,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,SAAS,EACT,eAAe,EACf,KAAa,EACb,SAAiB,EACjB,IAAU,EACV,aAA2B,EAC3B,UAAiB,EACjB,KAAe,EACf,SAAS,EACT,UAA6B,EAC7B,QAAQ,EACR,SAAS,GACV,EAAE,iBAAiB,CAAC,CAAC,CAAC,+BAsEtB"}

package/dist/react/components/AddItemsMenu.js

@@ -18,7 +18,13 @@ export function AddItemsMenu({ items, groups, onAdd, itemKey, itemLabel, itemDes
         // Inside a floating panel, a raw overflow-y-auto is the correct mechanism (the
         // panel is outside the page's ScrollArea and has no keyboard-inset concern); the
         // height cap comes from Radix's reported available height.
-        className: cn('max-h-[var(--radix-popover-content-available-height)] w-64 max-w-[90vw] overflow-y-auto p-0'), trigger: _jsx(Button, { variant: buttonVariant, size: buttonSize, leftIcon: icon, disabled: disabled, className: cn('inline-flex', className), children: showCount ? `${label} (${count})` : label }), children: _jsx("div", { className: 'py-1 text-sm', children: count === 0 ? (_jsx("p", { className: 'px-3 py-2 text-muted-foreground', children: emptyLabel })) : (resolvedGroups.map((group, gi) => (_jsxs("div", { children: [group.label ? (_jsx("p", { className: 'px-3 pt-2 pb-1 text-xs font-semibold uppercase tracking-wide text-muted-foreground', children: group.label })) : null, group.items.map((item) => (_jsxs("button", { type: 'button', onClick: () => {
+        // guardrails-ignore no-raw-overflow: floating popover panel outside the page's ScrollArea, height-capped by Radix — no keyboard-inset concern.
+        className: cn('max-h-[var(--radix-popover-content-available-height)] w-64 max-w-[90vw] overflow-y-auto p-0'), trigger: _jsx(Button, { variant: buttonVariant, size: buttonSize, leftIcon: icon, disabled: disabled, tooltip: label, className: cn('inline-flex', className), children: showCount ? `${label} (${count})` : label }), children: _jsx("div", { className: 'py-1 text-sm', children: count === 0 ? (_jsx("p", { className: 'px-3 py-2 text-muted-foreground', children: emptyLabel })) : (resolvedGroups.map((group, gi) => (_jsxs("div", { children: [group.label ? (_jsx("p", { className: 'cb-meta-label px-3 pt-2 pb-1', children: group.label })) : null, group.items.map((item) => (_jsxs("button", { 
+                        // guardrails-ignore no-raw-action-button: selects an item to add — a
+                        // menu-row list item (mirrors the "selects X — navigation" idiom), not
+                        // a destructive/mutating action; Button's centered/rounded chrome
+                        // doesn't fit this left-aligned two-line row.
+                        type: 'button', onClick: () => {
                             onAdd(item);
                             setOpen(false);
                         }, className: 'block w-full px-3 py-2 text-left hover:bg-muted', children: [_jsx("span", { className: 'block truncate text-popover-foreground', children: itemLabel(item) }), itemDescription ? (_jsx("span", { className: 'block truncate text-xs text-muted-foreground', children: itemDescription(item) })) : null] }, itemKey(item))))] }, group.label ?? `group-${gi}`)))) }) }));

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

@@ -1 +1 @@
-{"version":3,"file":"AddItemsMenu.js","sourceRoot":"","sources":["../../../src/react/components/AddItemsMenu.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"AddItemsMenu.js","sourceRoot":"","sources":["../../../src/react/components/AddItemsMenu.tsx"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AASvC,QAAA,MAAM,IAAI;;;;;;CAMA,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,IAAI,CAAC;AAU1C,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAa,EACb,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,YAAwB,EACxB,SAAS,EACT,QAAQ,GACT,EAAE,UAAU,+BA6BZ"}
+{"version":3,"file":"Alert.d.ts","sourceRoot":"","sources":["../../../src/react/components/Alert.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUvC,QAAA,MAAM,IAAI;;;;;;CAMA,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,IAAI,CAAC;AAU1C,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,2EAA2E;IAC3E,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;IACzB,sEAAsE;IACtE,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,wBAAgB,KAAK,CAAC,EACpB,IAAa,EACb,KAAK,EACL,IAAI,EACJ,OAAO,EACP,SAAS,EACT,YAAwB,EACxB,SAAS,EACT,QAAQ,GACT,EAAE,UAAU,+BA4BZ"}

package/dist/react/components/Alert.js

@@ -1,6 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { AlertTriangle, CheckCircle, Info, X, XCircle } from 'lucide-react';
 import { cn } from '../lib/cn';
+import { IconButton } from './IconButton';
 /*
  * Alert — a tonal status banner / callout. Color + an icon + text (never color
  * alone). Every tone reads a semantic token, so `info` follows the app's accent
@@ -24,6 +25,6 @@ const DEFAULT_ICON = {
 export function Alert({ tone = 'info', title, icon, actions, onDismiss, dismissLabel = 'Dismiss', className, children, }) {
     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: 'text-sm font-medium text-foreground', children: title }), children && _jsx("div", { className: 'text-sm text-muted-foreground', children: children }), actions && _jsx("div", { className: 'mt-2 flex flex-wrap gap-2', children: actions })] }), onDismiss && (_jsx("button", { type: 'button', onClick: onDismiss, "aria-label": dismissLabel, className: 'alert-icon shrink-0 rounded transition-opacity hover:opacity-70 focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring', children: _jsx(X, { className: 'size-4' }) }))] }));
+        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: 'text-sm font-medium text-foreground', children: title }), children && _jsx("div", { className: '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, {}) }))] }));
 }
 //# 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,WAAW,CAAC;AAE/B;;;;;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,qCAAqC,YAAE,KAAK,GAAK,EACvE,QAAQ,IAAI,cAAK,SAAS,EAAC,+BAA+B,YAAE,QAAQ,GAAO,EAC3E,OAAO,IAAI,cAAK,SAAS,EAAC,2BAA2B,YAAE,OAAO,GAAO,IAClE,EACL,SAAS,IAAI,CACZ,iBACE,IAAI,EAAC,QAAQ,EACb,OAAO,EAAE,SAAS,gBACN,YAAY,EACxB,SAAS,EAAC,yIAAyI,YAEnJ,KAAC,CAAC,IAAC,SAAS,EAAC,QAAQ,GAAG,GACjB,CACV,IACG,CACP,CAAC;AACJ,CAAC"}
+{"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,WAAW,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C;;;;;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,qCAAqC,YAAE,KAAK,GAAK,EACvE,QAAQ,IAAI,cAAK,SAAS,EAAC,+BAA+B,YAAE,QAAQ,GAAO,EAC3E,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"}

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

@@ -0,0 +1,49 @@
+/** How much light the field throws. Writes `--ambient-strength`, which every blob's
+ *  alpha is derived from — so the whole atmosphere tunes on one number and the three
+ *  hues keep their relative balance. `theme` (the default) leaves the token alone and
+ *  takes whatever the active theme declared. */
+export type AmbientIntensity = 'theme' | 'subtle' | 'normal' | 'vivid';
+export interface AmbientBackdropProps {
+    /**
+     * `fixed` (default) pins the field to the viewport so it stays put while the app
+     * scrolls — the page then reads as sitting IN a space rather than on a repeating
+     * texture. `absolute` scopes it to the nearest positioned ancestor, for a single
+     * panel or a hero band.
+     */
+    position?: 'fixed' | 'absolute';
+    intensity?: AmbientIntensity;
+    /**
+     * Override the theme's hue triad for this field only — any CSS color. Use it for
+     * a per-view accent (a "danger" screen, a per-workspace color), NOT to re-brand an
+     * app: that is `--ambient-1..3` in the app's stylesheet, which every ambient field
+     * and every gradient then follows together.
+     */
+    hues?: readonly [string, string, string];
+    /** Fine dither over the field. Large soft gradients band on 8-bit displays; this is
+     *  the standard fix. Default true. */
+    grain?: boolean;
+    className?: string;
+}
+/**
+ * The lit field a page floats on — a soft wash from above plus three big, slowly
+ * drifting, screen-blended color blobs. It is the "ambient light" half of the
+ * design language the glass surfaces are the other half of: glass has nothing to be
+ * translucent ABOUT until something is glowing behind it.
+ *
+ * Purely decorative and `aria-hidden`, pointer-transparent, and it sits at a negative
+ * z-index — so it can never intercept a click or a screen reader. Drift is suppressed
+ * under `prefers-reduced-motion`; the field itself stays, because the color is the
+ * design and only the movement is the accessibility concern.
+ *
+ * The host element needs `isolation: isolate` for `mix-blend-mode: screen` to blend
+ * against the app's own stack instead of punching through to the page behind it; the
+ * `cb-ambient-host` class (styles.css) is that, and {@link AppFrame} applies it. A
+ * hand-rolled host must too.
+ *
+ *   <div className='cb-ambient-host min-h-dvh'>
+ *     <AmbientBackdrop />
+ *     …
+ *   </div>
+ */
+export declare function AmbientBackdrop({ position, intensity, hues, grain, className, }: AmbientBackdropProps): import("react").JSX.Element;
+//# sourceMappingURL=AmbientBackdrop.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AmbientBackdrop.d.ts","sourceRoot":"","sources":["../../../src/react/components/AmbientBackdrop.tsx"],"names":[],"mappings":"AAGA;;;gDAGgD;AAChD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC;AAQvE,MAAM,WAAW,oBAAoB;IACnC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAChC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzC;0CACsC;IACtC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAkB,EAClB,SAAmB,EACnB,IAAI,EACJ,KAAY,EACZ,SAAS,GACV,EAAE,oBAAoB,+BAuBtB"}

package/dist/react/components/AmbientBackdrop.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../lib/cn';
+const STRENGTH = {
+    subtle: '0.08',
+    normal: '0.16',
+    vivid: '0.26',
+};
+/**
+ * The lit field a page floats on — a soft wash from above plus three big, slowly
+ * drifting, screen-blended color blobs. It is the "ambient light" half of the
+ * design language the glass surfaces are the other half of: glass has nothing to be
+ * translucent ABOUT until something is glowing behind it.
+ *
+ * Purely decorative and `aria-hidden`, pointer-transparent, and it sits at a negative
+ * z-index — so it can never intercept a click or a screen reader. Drift is suppressed
+ * under `prefers-reduced-motion`; the field itself stays, because the color is the
+ * design and only the movement is the accessibility concern.
+ *
+ * The host element needs `isolation: isolate` for `mix-blend-mode: screen` to blend
+ * against the app's own stack instead of punching through to the page behind it; the
+ * `cb-ambient-host` class (styles.css) is that, and {@link AppFrame} applies it. A
+ * hand-rolled host must too.
+ *
+ *   <div className='cb-ambient-host min-h-dvh'>
+ *     <AmbientBackdrop />
+ *     …
+ *   </div>
+ */
+export function AmbientBackdrop({ position = 'fixed', intensity = 'theme', hues, grain = true, className, }) {
+    const style = {};
+    if (intensity !== 'theme') {
+        style['--ambient-strength'] = STRENGTH[intensity];
+    }
+    if (hues) {
+        style['--ambient-1'] = hues[0];
+        style['--ambient-2'] = hues[1];
+        style['--ambient-3'] = hues[2];
+    }
+    return (_jsxs("div", { "aria-hidden": 'true', style: style, className: cn('cb-ambient', position === 'fixed' && 'cb-ambient--fixed', className), children: [_jsx("span", { className: 'cb-ambient__blob cb-ambient__blob--a' }), _jsx("span", { className: 'cb-ambient__blob cb-ambient__blob--b' }), _jsx("span", { className: 'cb-ambient__blob cb-ambient__blob--c' }), grain ? _jsx("span", { className: 'cb-ambient__grain' }) : null] }));
+}
+//# sourceMappingURL=AmbientBackdrop.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AmbientBackdrop.js","sourceRoot":"","sources":["../../../src/react/components/AmbientBackdrop.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAQ/B,MAAM,QAAQ,GAAuD;IACnE,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,MAAM;IACd,KAAK,EAAE,MAAM;CACd,CAAC;AAwBF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,eAAe,CAAC,EAC9B,QAAQ,GAAG,OAAO,EAClB,SAAS,GAAG,OAAO,EACnB,IAAI,EACJ,KAAK,GAAG,IAAI,EACZ,SAAS,GACY;IACrB,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,IAAI,SAAS,KAAK,OAAO,EAAE,CAAC;QACzB,KAAgC,CAAC,oBAAoB,CAAC,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACR,KAAgC,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAgC,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,KAAgC,CAAC,aAAa,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CACL,8BACc,MAAM,EAClB,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,EAAE,CAAC,YAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,mBAAmB,EAAE,SAAS,CAAC,aAEnF,eAAM,SAAS,EAAC,sCAAsC,GAAG,EACzD,eAAM,SAAS,EAAC,sCAAsC,GAAG,EACzD,eAAM,SAAS,EAAC,sCAAsC,GAAG,EACxD,KAAK,CAAC,CAAC,CAAC,eAAM,SAAS,EAAC,mBAAmB,GAAG,CAAC,CAAC,CAAC,IAAI,IAClD,CACP,CAAC;AACJ,CAAC"}

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

@@ -1,6 +1,7 @@
 import type { ElementType, ReactNode, Ref } from 'react';
 import type { GateFn, NavigationModel, NavPreferences } from '../../core/navigation';
-import type { IconResolver } from '../nav/navShared';
+import type { IconResolver, NavBadgeTone } from '../nav/navShared';
+import { type AmbientBackdropProps } from './AmbientBackdrop';
 import { type ScrollAreaSpace } from './ScrollArea';
 export interface AppShellProps {
     /** Routed page content. Scrolls inside the single keyboard-safe `ScrollArea`. */
@@ -28,13 +29,16 @@ export interface AppShellProps {
     onNavPrefsChange?: (next: NavPreferences) => void;
     /** Dynamic per-place badge (unread counts), keyed by domain id. */
     navBadges?: Record<string, number | string>;
+    /** How those counts READ — `alert` (default, red) for "this needs you", `neutral` or
+     *  `accent` for a plain fact like "how many notes are filed here". */
+    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). */
     navFooter?: ReactNode;
     /**
      * Universal capture (UX north-star §8.2) — wired to the command spine's capture
-     * hero (desktop) and the `PlaceBar`'s raised centre FAB (mobile). Capture is a
+     * hero (desktop) and the `PlaceBar`'s raised center FAB (mobile). Capture is a
      * first-class verb, present on every surface; omit only for chromeless shells.
      */
     onCapture?: () => void;
@@ -70,10 +74,29 @@ export interface AppShellProps {
     palette?: ReactNode;
     /** Max places in the mobile `PlaceBar` thumb zone (rest reachable via command). 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
+     *  read as duplicates — owner v3 mobile teardown §4). Default `'active'`. */
+    placeBarLabels?: 'active' | 'all';
     /** ScrollArea comfort-space preset for the main content region. Default: `default`. */
     scrollSpace?: ScrollAreaSpace;
     /** Expose the main scroll container's ref for programmatic scroll. */
     scrollRef?: Ref<HTMLDivElement>;
+    /**
+     * Light the shell: paint an {@link AmbientBackdrop} behind everything and turn the
+     * spine + place rails to glass, so the field reads THROUGH the chrome instead of
+     * being boxed in by it. Pass `true` for the theme's own field, or an
+     * {@link AmbientBackdropProps} object to tune intensity / hues per app.
+     *
+     * It is one prop rather than an app-side recipe on purpose: the ambient field, the
+     * `isolation` its `screen` blending needs, the negative-z stacking, and which
+     * chrome goes translucent are four coupled decisions, and every app that got one
+     * of them wrong would get a subtly broken version of the same look. Pair it with
+     * the `.cb-aurora` theme scope (theme.css) for the full treatment — but it is
+     * legal without one: the `--glass-*`/`--ambient-*` tokens are declared by every
+     * theme.
+     */
+    ambient?: boolean | AmbientBackdropProps;
     className?: string;
 }
 /**
@@ -85,7 +108,7 @@ export interface AppShellProps {
  * - 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 centre capture FAB (mobile is
+ *   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
@@ -114,5 +137,5 @@ export interface AppShellProps {
  * 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, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax, scrollSpace, scrollRef, className, }: AppShellProps): import("react").JSX.Element;
+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;
 //# 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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAIrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGrD,OAAO,EAAc,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,QAAQ,EAAE,SAAS,CAAC;IAEpB;;;;;;OAMG;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;IAE5C,oEAAoE;IACpE,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB,oFAAoF;IACpF,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;;;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,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,uFAAuF;IACvF,WAAW,CAAC,EAAE,eAAe,CAAC;IAE9B,sEAAsE;IACtE,SAAS,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC;IAEhC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,QAAQ,CAAC,EACvB,QAAQ,EACR,GAAG,EACH,OAAO,EACP,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,QAAQ,EACR,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,eAAe,EACf,OAAO,EACP,UAAU,EACV,OAAO,EACP,WAAe,EACf,WAAuB,EACvB,SAAS,EACT,SAAS,GACV,EAAE,aAAa,+BAiGf"}
+{"version":3,"file":"AppShell.d.ts","sourceRoot":"","sources":["../../../src/react/components/AppShell.tsx"],"names":[],"mappings":"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"}

package/dist/react/components/AppShell.js

@@ -1,9 +1,10 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useKeyboardInset } from '../hooks/useKeyboardInset';
 import { cn } from '../lib/cn';
 import { CommandBar } from '../nav/CommandBar';
 import { PlaceBar } from '../nav/PlaceBar';
 import { SideNav } from '../nav/SideNav';
+import { AmbientBackdrop } from './AmbientBackdrop';
 import { ScrollArea } from './ScrollArea';
 // 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.
@@ -17,7 +18,7 @@ const RAIL_WIDTH = 'w-60'; // 240px
  * - 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 centre capture FAB (mobile is
+ *   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
@@ -46,12 +47,20 @@ const RAIL_WIDTH = 'w-60'; // 240px
  * 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, navHeader, navFooter, onCapture, captureLabel, onOpenCommand, commandLabel, commandHint, commandBarExtra, account, bottomDock, palette, placeBarMax = 5, scrollSpace = 'default', scrollRef, className, }) {
+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, }) {
     useKeyboardInset();
     const showSpine = Boolean(navHeader || account || onOpenCommand || onCapture || commandBarExtra);
     const showBottom = Boolean(bottomDock || nav);
-    return (_jsxs("div", { "data-cb-appshell": '', className: cn('flex h-dvh flex-col overflow-hidden bg-background text-foreground', className), children: [showSpine && (_jsxs("header", { "data-cb-appheader": '', className: 'relative z-30 flex shrink-0 items-center gap-3 border-b border-border px-3 py-2', children: [navHeader && _jsx("div", { className: 'shrink-0', children: navHeader }), _jsx(CommandBar, { className: 'min-w-0 flex-1', onCapture: onCapture, captureLabel: captureLabel, 
+    // 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', 
+        // `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 && (_jsx("aside", { "data-cb-nav-rail": '', className: cn('hidden border-r border-border bg-background md:flex md:shrink-0 md:flex-col', RAIL_WIDTH), children: _jsx(SideNav, { model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, prefs: navPrefs, onPrefsChange: onNavPrefsChange, badges: navBadges, footer: navFooter }) })), _jsx("main", { className: 'flex min-h-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: 'border-t border-border md:hidden', model: nav, gate: navGate, activeHref: activeHref, onNavigate: onNavigate, linkComponent: navLinkComponent, resolveIcon: resolveIcon, badges: navBadges, onCapture: onCapture, captureLabel: captureLabel, max: placeBarMax }))] })), palette] }));
+                        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] }));
 }
 //# 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,2BAA2B,CAAC;AAC7D,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAgGhE,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,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,WAAW,GAAG,SAAS,EACvB,SAAS,EACT,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;IAE9C,OAAO,CACL,mCACmB,EAAE,EACnB,SAAS,EAAE,EAAE,CAAC,mEAAmE,EAAE,SAAS,CAAC,aAG5F,SAAS,IAAI,CACZ,uCACoB,EAAE,EACpB,SAAS,EAAC,iFAAiF,aAE1F,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,aAExD,GAAG,IAAI,CACN,oCACmB,EAAE,EACnB,SAAS,EAAE,EAAE,CACX,6EAA6E,EAC7E,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,EACjB,MAAM,EAAE,SAAS,GACjB,GACI,CACT,EAGD,eAAM,SAAS,EAAC,4BAA4B,YAC1C,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,EAAC,kCAAkC,EAC5C,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,SAAS,EACpB,YAAY,EAAE,YAAY,EAC1B,GAAG,EAAE,WAAW,GAChB,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

@@ -0,0 +1,39 @@
+import type { ReactNode } from 'react';
+export interface AsyncPanelProps {
+    loading?: boolean;
+    /** Anything truthy renders the degraded state; an Error's message is used. */
+    error?: unknown;
+    /** Render the empty state instead of children. */
+    empty?: boolean;
+    /** Copy for the empty state. */
+    emptyTitle?: ReactNode;
+    emptyDescription?: ReactNode;
+    /** Rows of skeleton to show while loading. Default 3. */
+    skeletonRows?: 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
+     * panels and no way to tell which.
+     */
+    label?: string;
+    /** Offered alongside the error — typically a retry Button. */
+    onRetryAction?: ReactNode;
+    children: ReactNode;
+}
+/**
+ * The per-section error envelope: one panel's failure degrades that panel, never
+ * the page.
+ *
+ * This is the single most valuable pattern carried over from the old admin's AWS
+ * dashboard, where one missing IAM permission would otherwise blank a page of a
+ * dozen healthy panels. A fleet dashboard reads from many independent sources
+ * (each satellite, the EC2, an object store, a billing API) and it is normal for
+ * one to be asleep, unreachable, or unauthorized — so "partially degraded" has to
+ * be a first-class rendering, not an exception path.
+ *
+ * Deliberately NOT an error boundary: it renders a REPORTED failure (a rejected
+ * 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;
+//# sourceMappingURL=AsyncPanel.d.ts.map

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

@@ -0,0 +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"}