cursedbelt 0.0.0

package/dist/react/nav/navMenuPlacement.d.ts

@@ -0,0 +1,58 @@
+/** Preferred horizontal direction the nav row's kebab menu opens. */
+export type NavMenuAlign = 'left' | 'right';
+/** The resolved viewport coordinates of an open nav kebab menu. */
+export interface NavMenuPlacement {
+    /** `position: fixed` top (px, viewport-based). */
+    top: number;
+    /** `position: fixed` left (px, viewport-based). */
+    left: number;
+    /** Max height (px) so a tall menu scrolls in place instead of running off-screen
+     *  — apply as inline `maxHeight` paired with `overflow-y: auto`. */
+    maxHeight: number;
+}
+export interface NavMenuPlacementInput {
+    /** Trigger's viewport rect (from `getBoundingClientRect()`). */
+    triggerRect: {
+        top: number;
+        bottom: number;
+        left: number;
+        right: number;
+    };
+    /** Measured menu size (the popover's own `getBoundingClientRect()`). */
+    menuSize: {
+        width: number;
+        height: number;
+    };
+    /** Visible viewport (`window.innerWidth`/`innerHeight`). */
+    viewport: {
+        width: number;
+        height: number;
+    };
+    /** Preferred horizontal open direction. `'left'` (default) opens rightward —
+     *  toward the content — from the trigger's left edge; `'right'` anchors the
+     *  menu's right edge to the trigger (opens leftward). Either way the result is
+     *  clamped, so the side is only a preference. */
+    align?: NavMenuAlign;
+    /** Gap between trigger and menu, in px (default 6). */
+    gap?: number;
+    /** Minimum margin kept from every viewport edge, in px (default 8). */
+    margin?: number;
+}
+/**
+ * Place a side-nav row's kebab menu against the viewport so it is **always fully
+ * on-screen**, regardless of how narrow the sidebar is. The old menu was an
+ * `absolute right-0 w-56` popover that opened leftward and spilled off the left
+ * edge of a narrow sidebar; this computes viewport coordinates for a
+ * `position: fixed` menu (rendered in a portal, so no `overflow`/`opacity`/
+ * `transform` ancestor in the draggable, hover-revealed row can clip, fade, or
+ * mis-anchor it).
+ *
+ * The menu opens below the trigger, flipping above only when there isn't room
+ * below but there is above; horizontally it opens toward the content side (or
+ * leftward for `align='right'`). Both axes are then clamped into the viewport
+ * (the upper bound floors at `margin`, so a menu larger than the viewport still
+ * starts on-screen rather than at a negative offset). Pure + testable so the DOM
+ * wiring in {@link NavItemMenu} stays trivial.
+ */
+export declare function computeNavMenuPlacement({ triggerRect, menuSize, viewport, align, gap, margin, }: NavMenuPlacementInput): NavMenuPlacement;
+//# sourceMappingURL=navMenuPlacement.d.ts.map

package/dist/react/nav/navMenuPlacement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navMenuPlacement.d.ts","sourceRoot":"","sources":["../../../src/react/nav/navMenuPlacement.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,OAAO,CAAC;AAE5C,mEAAmE;AACnE,MAAM,WAAW,gBAAgB;IAC/B,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb;wEACoE;IACpE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,gEAAgE;IAChE,WAAW,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1E,wEAAwE;IACxE,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,4DAA4D;IAC5D,QAAQ,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C;;;qDAGiD;IACjD,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,KAAc,EACd,GAAO,EACP,MAAU,GACX,EAAE,qBAAqB,GAAG,gBAAgB,CAsB1C"}

package/dist/react/nav/navMenuPlacement.js

@@ -0,0 +1,36 @@
+/**
+ * Place a side-nav row's kebab menu against the viewport so it is **always fully
+ * on-screen**, regardless of how narrow the sidebar is. The old menu was an
+ * `absolute right-0 w-56` popover that opened leftward and spilled off the left
+ * edge of a narrow sidebar; this computes viewport coordinates for a
+ * `position: fixed` menu (rendered in a portal, so no `overflow`/`opacity`/
+ * `transform` ancestor in the draggable, hover-revealed row can clip, fade, or
+ * mis-anchor it).
+ *
+ * The menu opens below the trigger, flipping above only when there isn't room
+ * below but there is above; horizontally it opens toward the content side (or
+ * leftward for `align='right'`). Both axes are then clamped into the viewport
+ * (the upper bound floors at `margin`, so a menu larger than the viewport still
+ * starts on-screen rather than at a negative offset). Pure + testable so the DOM
+ * wiring in {@link NavItemMenu} stays trivial.
+ */
+export function computeNavMenuPlacement({ triggerRect, menuSize, viewport, align = 'left', gap = 6, margin = 8, }) {
+    const { width: vw, height: vh } = viewport;
+    // Open below the trigger; flip above when there's no room below but room above.
+    let top = triggerRect.bottom + gap;
+    const overflowsBelow = top + menuSize.height + margin > vh;
+    const roomAbove = triggerRect.top - menuSize.height - gap >= margin;
+    if (overflowsBelow && roomAbove)
+        top = triggerRect.top - menuSize.height - gap;
+    // Open rightward (toward the content) by default; leftward for `align='right'`.
+    let left = align === 'right' ? triggerRect.right - menuSize.width : triggerRect.left;
+    // Clamp both axes; the upper bound floors at `margin` so an oversized menu still
+    // starts on-screen rather than at a negative coordinate.
+    left = Math.min(Math.max(left, margin), Math.max(margin, vw - menuSize.width - margin));
+    top = Math.min(Math.max(top, margin), Math.max(margin, vh - menuSize.height - margin));
+    // Cap height to the viewport (less the top/bottom margins) so a tall menu
+    // scrolls in place rather than overflowing.
+    const maxHeight = Math.max(120, vh - 2 * margin);
+    return { top, left, maxHeight };
+}
+//# sourceMappingURL=navMenuPlacement.js.map

package/dist/react/nav/navMenuPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navMenuPlacement.js","sourceRoot":"","sources":["../../../src/react/nav/navMenuPlacement.ts"],"names":[],"mappings":"AAgCA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,KAAK,GAAG,MAAM,EACd,GAAG,GAAG,CAAC,EACP,MAAM,GAAG,CAAC,GACY;IACtB,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,QAAQ,CAAC;IAE3C,gFAAgF;IAChF,IAAI,GAAG,GAAG,WAAW,CAAC,MAAM,GAAG,GAAG,CAAC;IACnC,MAAM,cAAc,GAAG,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,GAAG,EAAE,CAAC;IAC3D,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,MAAM,CAAC;IACpE,IAAI,cAAc,IAAI,SAAS;QAAE,GAAG,GAAG,WAAW,CAAC,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,GAAG,CAAC;IAE/E,gFAAgF;IAChF,IAAI,IAAI,GAAG,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC;IAErF,iFAAiF;IACjF,yDAAyD;IACzD,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC;IACxF,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC;IAEvF,0EAA0E;IAC1E,4CAA4C;IAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC;IAEjD,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAClC,CAAC"}

package/dist/react/nav/navSearch.d.ts

@@ -0,0 +1,31 @@
+import type { ReactNode } from 'react';
+/** A single entry in the instant nav-search catalogue. */
+export interface NavSearchItem {
+    /** Stable identifier (usually the href path). */
+    id: string;
+    /** Display label — the primary match target. */
+    label: string;
+    /** Target path / URL. */
+    href: string;
+    /** Visual icon (React node — optional). */
+    icon?: ReactNode;
+    /** When true, the item is hidden in the primary sidebar but still searchable. */
+    hidden?: boolean;
+    /** Group/hub label this item belongs to (used for grouping results). */
+    groupLabel?: string;
+    /** Extra keywords to match against (synonyms, abbreviations, etc.). */
+    keywords?: string[];
+}
+/** A bucket of NavSearchItem hits under a common label. */
+export interface NavSearchItemGroup {
+    key: string;
+    label: string;
+    items: NavSearchItem[];
+}
+/**
+ * Filter `items` against `query` and group hits by `groupLabel`. Returns `[]`
+ * for an empty/blank query (the instant layer shows nothing until the user types).
+ * Match priority: label › keywords › groupLabel.
+ */
+export declare function filterNavSearch(items: NavSearchItem[], query: string): NavSearchItemGroup[];
+//# sourceMappingURL=navSearch.d.ts.map

package/dist/react/nav/navSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navSearch.d.ts","sourceRoot":"","sources":["../../../src/react/nav/navSearch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,0DAA0D;AAC1D,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,iFAAiF;IACjF,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAID;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,aAAa,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAwB3F"}

package/dist/react/nav/navSearch.js

@@ -0,0 +1,37 @@
+// Instant client-side nav search: filter a flat NavSearchItem list by query and
+// group hits by their groupLabel. Framework-free so it's unit-testable and usable
+// outside of React (e.g. in the command palette's uFuzzy-ranked variant).
+const norm = (s) => s.toLowerCase().trim();
+/**
+ * Filter `items` against `query` and group hits by `groupLabel`. Returns `[]`
+ * for an empty/blank query (the instant layer shows nothing until the user types).
+ * Match priority: label › keywords › groupLabel.
+ */
+export function filterNavSearch(items, query) {
+    const q = norm(query);
+    if (!q)
+        return [];
+    const matched = items.filter((item) => {
+        if (norm(item.label).includes(q))
+            return true;
+        for (const kw of item.keywords ?? []) {
+            if (norm(kw).includes(q))
+                return true;
+        }
+        if (item.groupLabel && norm(item.groupLabel).includes(q))
+            return true;
+        return false;
+    });
+    const groups = new Map();
+    for (const item of matched) {
+        const key = item.groupLabel ?? '';
+        let bucket = groups.get(key);
+        if (!bucket) {
+            bucket = { key, label: item.groupLabel ?? 'Pages', items: [] };
+            groups.set(key, bucket);
+        }
+        bucket.items.push(item);
+    }
+    return [...groups.values()];
+}
+//# sourceMappingURL=navSearch.js.map

package/dist/react/nav/navSearch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navSearch.js","sourceRoot":"","sources":["../../../src/react/nav/navSearch.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,kFAAkF;AAClF,0EAA0E;AA6B1E,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;AAEnD;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAsB,EAAE,KAAa;IACnE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IACtB,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE;QACpC,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC9C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;YACrC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,GAAG,EAA8B,CAAC;IACrD,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC;QAClC,IAAI,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,UAAU,IAAI,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YAC/D,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAC1B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;AAC9B,CAAC"}

package/dist/react/nav/navShared.d.ts

@@ -0,0 +1,43 @@
+import type { CSSProperties, ElementType, ReactNode } from 'react';
+/** Maps a model icon *name* to a node. Apps wire their icon set (e.g. lucide). */
+export type IconResolver = (name: string | undefined) => ReactNode;
+/** Props every nav surface accepts to control how a destination is rendered/navigated. */
+export interface NavNavigationProps {
+    /** SPA link component (e.g. react-router `Link`); receives `to`. */
+    linkComponent?: ElementType;
+    /** Called with the destination path on click (router-less hosts, analytics). */
+    onNavigate?: (path: string) => void;
+    /** Fired after a navigation (e.g. AppShell closes the mobile drawer). */
+    onAfterNavigate?: () => void;
+    /** Resolve a model icon name to a node. */
+    resolveIcon?: IconResolver;
+}
+export interface NavLinkProps extends Pick<NavNavigationProps, 'linkComponent' | 'onNavigate' | 'onAfterNavigate'> {
+    path: string;
+    className?: string;
+    style?: CSSProperties;
+    title?: string;
+    /** `'page'` on the current destination (aria-current). */
+    ariaCurrent?: 'page';
+    tabIndex?: number;
+    children: ReactNode;
+}
+/**
+ * The one navigation primitive. Precedence: a `linkComponent` (real `<a>`/SPA link,
+ * best for a11y + middle-click) → an `onNavigate` callback (`<button>`) → a plain
+ * `<a href>`. Always fires `onAfterNavigate` so the shell can close its drawer.
+ */
+export declare function NavLink({ path, linkComponent, onNavigate, onAfterNavigate, className, style, title, ariaCurrent, tabIndex, children, }: NavLinkProps): import("react").JSX.Element;
+/**
+ * Is `path` the active route, or an ancestor of it? Exact normalized match, or a
+ * path-segment prefix (`/games` is active on `/games/fractal`). The root `'/'`
+ * matches only itself, so "Today" doesn't light up everywhere.
+ */
+export declare function isPathWithin(path: string, activeHref: string | undefined): boolean;
+/** Resolve a model icon name to a node via the app's resolver (or nothing). */
+export declare function renderIcon(resolveIcon: IconResolver | undefined, name: string | undefined): ReactNode;
+/** Order `ids` by a saved order list, appending unlisted ids in their natural order. */
+export declare function rankBySavedOrder<T>(items: T[], getId: (t: T) => string, order?: string[]): T[];
+/** The accent for a nav row: the user's per-row override, else the theme accent. */
+export declare const navAccent: (color: string | undefined) => string;
+//# sourceMappingURL=navShared.d.ts.map

package/dist/react/nav/navShared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navShared.d.ts","sourceRoot":"","sources":["../../../src/react/nav/navShared.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGnE,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,KAAK,SAAS,CAAC;AAEnE,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,gFAAgF;IAChF,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,2CAA2C;IAC3C,WAAW,CAAC,EAAE,YAAY,CAAC;CAC5B;AAED,MAAM,WAAW,YACf,SAAQ,IAAI,CAAC,kBAAkB,EAAE,eAAe,GAAG,YAAY,GAAG,iBAAiB,CAAC;IACpF,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,aAAa,EACb,UAAU,EACV,eAAe,EACf,SAAS,EACT,KAAK,EACL,KAAK,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,GACT,EAAE,YAAY,+BAqDd;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAMlF;AAED,+EAA+E;AAC/E,wBAAgB,UAAU,CACxB,WAAW,EAAE,YAAY,GAAG,SAAS,EACrC,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,SAAS,CAEX;AAED,wFAAwF;AACxF,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,MAAM,EACvB,KAAK,GAAE,MAAM,EAAO,GACnB,CAAC,EAAE,CAOL;AAED,oFAAoF;AACpF,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,GAAG,SAAS,KAAG,MAAwC,CAAC"}

package/dist/react/nav/navShared.js

@@ -0,0 +1,51 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { normalizeNavPath } from '../../core/navigation';
+/**
+ * The one navigation primitive. Precedence: a `linkComponent` (real `<a>`/SPA link,
+ * best for a11y + middle-click) → an `onNavigate` callback (`<button>`) → a plain
+ * `<a href>`. Always fires `onAfterNavigate` so the shell can close its drawer.
+ */
+export function NavLink({ path, linkComponent, onNavigate, onAfterNavigate, className, style, title, ariaCurrent, tabIndex, children, }) {
+    const handleClick = () => {
+        onNavigate?.(path);
+        onAfterNavigate?.();
+    };
+    if (linkComponent) {
+        const Link = linkComponent;
+        return (_jsx(Link, { to: path, href: path, className: className, style: style, title: title, "aria-current": ariaCurrent, tabIndex: tabIndex, onClick: handleClick, children: children }));
+    }
+    if (onNavigate) {
+        return (_jsx("button", { type: 'button', className: className, style: style, title: title, "aria-current": ariaCurrent, tabIndex: tabIndex, onClick: handleClick, children: children }));
+    }
+    return (_jsx("a", { href: path, className: className, style: style, title: title, "aria-current": ariaCurrent, tabIndex: tabIndex, onClick: handleClick, children: children }));
+}
+/**
+ * Is `path` the active route, or an ancestor of it? Exact normalized match, or a
+ * path-segment prefix (`/games` is active on `/games/fractal`). The root `'/'`
+ * matches only itself, so "Today" doesn't light up everywhere.
+ */
+export function isPathWithin(path, activeHref) {
+    if (!activeHref)
+        return false;
+    const p = normalizeNavPath(path);
+    const a = normalizeNavPath(activeHref);
+    if (p === '/')
+        return a === '/';
+    return a === p || a.startsWith(`${p}/`);
+}
+/** Resolve a model icon name to a node via the app's resolver (or nothing). */
+export function renderIcon(resolveIcon, name) {
+    return resolveIcon ? resolveIcon(name) : null;
+}
+/** Order `ids` by a saved order list, appending unlisted ids in their natural order. */
+export function rankBySavedOrder(items, getId, order = []) {
+    const rank = (id) => {
+        const i = order.indexOf(id);
+        return i === -1 ? Number.POSITIVE_INFINITY : i;
+    };
+    // Array.prototype.sort is stable, so equal-rank (unlisted) items keep input order.
+    return [...items].sort((a, b) => rank(getId(a)) - rank(getId(b)));
+}
+/** The accent for a nav row: the user's per-row override, else the theme accent. */
+export const navAccent = (color) => color ?? 'var(--accent-solid)';
+//# sourceMappingURL=navShared.js.map

package/dist/react/nav/navShared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navShared.js","sourceRoot":"","sources":["../../../src/react/nav/navShared.tsx"],"names":[],"mappings":";AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA6BzD;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,EACtB,IAAI,EACJ,aAAa,EACb,UAAU,EACV,eAAe,EACf,SAAS,EACT,KAAK,EACL,KAAK,EACL,WAAW,EACX,QAAQ,EACR,QAAQ,GACK;IACb,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;QACnB,eAAe,EAAE,EAAE,CAAC;IACtB,CAAC,CAAC;IAEF,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,aAAa,CAAC;QAC3B,OAAO,CACL,KAAC,IAAI,IACH,EAAE,EAAE,IAAI,EACR,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,kBACE,WAAW,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,YAEnB,QAAQ,GACJ,CACR,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CACL,iBACE,IAAI,EAAC,QAAQ,EACb,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,kBACE,WAAW,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,YAEnB,QAAQ,GACF,CACV,CAAC;IACJ,CAAC;IAED,OAAO,CACL,YACE,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,KAAK,kBACE,WAAW,EACzB,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,YAEnB,QAAQ,GACP,CACL,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,UAA8B;IACvE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,CAAC,KAAK,GAAG,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,UAAU,CACxB,WAAqC,EACrC,IAAwB;IAExB,OAAO,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAChD,CAAC;AAED,wFAAwF;AACxF,MAAM,UAAU,gBAAgB,CAC9B,KAAU,EACV,KAAuB,EACvB,QAAkB,EAAE;IAEpB,MAAM,IAAI,GAAG,CAAC,EAAU,EAAE,EAAE;QAC1B,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC5B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC;IACF,mFAAmF;IACnF,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAyB,EAAU,EAAE,CAAC,KAAK,IAAI,qBAAqB,CAAC"}

package/dist/react/nav/partitionAndOrder.d.ts

@@ -0,0 +1,19 @@
+import type { NavEntry } from './types';
+/**
+ * A stable rank for `id` within `order`: its index, or +∞ when unlisted so it
+ * sorts to the end. Pair with a stable sort to keep the natural order of any items
+ * the saved order doesn't mention. This is the `indexOf`/`MAX_SAFE_INTEGER` rank
+ * that was hand-copied across NavList, SideNav, HubGrid, and SettingsPage.
+ */
+export declare const orderRank: (order: string[], id: string) => number;
+/**
+ * Split eligible entries into the visible list (sorted by the user's saved
+ * `order`, keyed by `entry.id`) and the hidden list (kept in natural order, to
+ * feed a "restore hidden" menu). Pure + testable. `entry.hidden` is resolved
+ * app-side, so this works regardless of how the app keys its hidden set.
+ */
+export declare const partitionAndOrder: (entries: NavEntry[], order: string[]) => {
+    visible: NavEntry[];
+    hidden: NavEntry[];
+};
+//# sourceMappingURL=partitionAndOrder.d.ts.map

package/dist/react/nav/partitionAndOrder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionAndOrder.d.ts","sourceRoot":"","sources":["../../../src/react/nav/partitionAndOrder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,EAAE,IAAI,MAAM,KAAG,MAGvD,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,QAAQ,EAAE,EACnB,OAAO,MAAM,EAAE,KACd;IAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,QAAQ,EAAE,CAAA;CAM3C,CAAC"}

package/dist/react/nav/partitionAndOrder.js

@@ -0,0 +1,25 @@
+/**
+ * A stable rank for `id` within `order`: its index, or +∞ when unlisted so it
+ * sorts to the end. Pair with a stable sort to keep the natural order of any items
+ * the saved order doesn't mention. This is the `indexOf`/`MAX_SAFE_INTEGER` rank
+ * that was hand-copied across NavList, SideNav, HubGrid, and SettingsPage.
+ */
+export const orderRank = (order, id) => {
+    const i = order.indexOf(id);
+    return i === -1 ? Number.MAX_SAFE_INTEGER : i;
+};
+/**
+ * Split eligible entries into the visible list (sorted by the user's saved
+ * `order`, keyed by `entry.id`) and the hidden list (kept in natural order, to
+ * feed a "restore hidden" menu). Pure + testable. `entry.hidden` is resolved
+ * app-side, so this works regardless of how the app keys its hidden set.
+ */
+export const partitionAndOrder = (entries, order) => {
+    const visible = [];
+    const hidden = [];
+    for (const e of entries)
+        (e.hidden ? hidden : visible).push(e);
+    visible.sort((a, b) => orderRank(order, a.id) - orderRank(order, b.id));
+    return { visible, hidden };
+};
+//# sourceMappingURL=partitionAndOrder.js.map

package/dist/react/nav/partitionAndOrder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"partitionAndOrder.js","sourceRoot":"","sources":["../../../src/react/nav/partitionAndOrder.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,KAAe,EAAE,EAAU,EAAU,EAAE;IAC/D,MAAM,CAAC,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC5B,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,OAAmB,EACnB,KAAe,EAC8B,EAAE;IAC/C,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AAC7B,CAAC,CAAC"}

package/dist/react/nav/types.d.ts

@@ -0,0 +1,65 @@
+import type { ReactNode } from 'react';
+/**
+ * One sidebar row. The consuming app does its own eligibility filtering
+ * (auth/role/enabled/…) and **resolves** `color`/`hidden`/`active` before passing
+ * the entry, so the library stays agnostic to each app's prefs store and routing.
+ * `id` is the stable key for ordering, drag, and React keys — use a unique route
+ * path (an app whose route *titles* aren't unique must key by path here).
+ */
+export interface NavEntry {
+    id: string;
+    label: string;
+    /** Link destination — passed to `linkComponent` as `to`, or `href` for `<a>`. */
+    href: string;
+    icon?: ReactNode;
+    /** App-computed active state (exact match, "on a hub child", …). */
+    active?: boolean;
+    /** Resolved accent hex (the app looks it up from its own prefs keying). */
+    color?: string;
+    /** Resolved hidden flag (the app looks it up from its own prefs keying). */
+    hidden?: boolean;
+    /** Always-visible trailing node, e.g. an unread badge. */
+    trailing?: ReactNode;
+    /** Tooltip (when collapsed) + the key carrier some apps mutate prefs by
+     *  (e.g. a route title, when color/hidden are stored by title not path). */
+    title?: string;
+}
+/**
+ * Discrete mutation callbacks. Each app wires these to its own store. They're kept
+ * separate (not one `onChange(prefs)`) because an app may route `setHidden` to a
+ * different store/thunk than `setOrder`/`setColor`; the mutated **entry** is passed
+ * back so an app can key color/hidden by `entry.title` while ordering by `entry.id`.
+ */
+export interface NavPrefsActions {
+    setOrder: (ids: string[]) => void;
+    setHidden: (entry: NavEntry, hidden: boolean) => void;
+    setColor: (entry: NavEntry, color: string | undefined) => void;
+}
+/** A searchable destination: a top-level nav item OR a page nested inside a hub. */
+export interface NavSearchItem {
+    id: string;
+    label: string;
+    href: string;
+    /** Owning hub label — groups results and is also matched. Omit for top-level. */
+    groupLabel?: string;
+    icon?: ReactNode;
+    /** Extra match terms (e.g. a description or synonyms). */
+    keywords?: string[];
+    /** Marks a destination currently hidden from the sidebar (shown dimmed). */
+    hidden?: boolean;
+}
+/** One tile in a hub landing-page grid (HubTileGrid). */
+export interface HubTile {
+    /** Stable id for ordering/hiding/colors + React key (typically the route path). */
+    id: string;
+    /** Link destination (passed to `linkComponent` as `to`, or `href` for `<a>`). */
+    href: string;
+    title: string;
+    description?: string;
+    icon?: ReactNode;
+    /** Optional status/extra node under the description. */
+    badge?: ReactNode;
+    /** Default accent hex, before a per-tile color override. */
+    color?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/react/nav/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/react/nav/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oEAAoE;IACpE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;gFAC4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAClC,SAAS,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;CAChE;AAED,oFAAoF;AACpF,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,yDAAyD;AACzD,MAAM,WAAW,OAAO;IACtB,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,wDAAwD;IACxD,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/react/nav/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/react/nav/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/react/nav/types.ts"],"names":[],"mappings":""}

package/dist/react/palette/Command.d.ts

@@ -0,0 +1,25 @@
+import { CommandEmpty as CmdkEmpty, CommandGroup as CmdkGroup, CommandInput as CmdkInput, CommandItem as CmdkItem, CommandList as CmdkList, CommandSeparator as CmdkSeparator, Command as CommandPrimitive } from 'cmdk';
+import type { ComponentPropsWithoutRef, ReactNode } from 'react';
+/** The Command root — a flex column that owns the input + list. */
+export declare function Command({ className, ...props }: ComponentPropsWithoutRef<typeof CommandPrimitive>): import("react").JSX.Element;
+export interface CommandInputProps extends Omit<ComponentPropsWithoutRef<typeof CmdkInput>, 'value' | 'onChange'> {
+    value: string;
+    onValueChange: (value: string) => void;
+    /** Right-aligned adornment — the `⌘K` badge and/or a search spinner. */
+    trailing?: ReactNode;
+}
+/** The search field: a leading magnifier, the cmdk input, and an optional trailing slot. */
+export declare function CommandInput({ className, trailing, ...props }: CommandInputProps): import("react").JSX.Element;
+/** The scrolling results region (keyboard-safe via `ScrollArea`), capped at 60dvh. */
+export declare function CommandList({ className, maxHeightClassName, ...props }: ComponentPropsWithoutRef<typeof CmdkList> & {
+    maxHeightClassName?: string;
+}): import("react").JSX.Element;
+/** Shown (by cmdk) when the query matches nothing. */
+export declare function CommandEmpty({ className, ...props }: ComponentPropsWithoutRef<typeof CmdkEmpty>): import("react").JSX.Element;
+/** A labeled section (the heading is hidden when `heading` is omitted). */
+export declare function CommandGroup({ className, ...props }: ComponentPropsWithoutRef<typeof CmdkGroup>): import("react").JSX.Element;
+/** A selectable row. cmdk highlights it via `data-selected` as the user arrows through. */
+export declare function CommandItem({ className, ...props }: ComponentPropsWithoutRef<typeof CmdkItem>): import("react").JSX.Element;
+/** A thin divider between groups. */
+export declare function CommandSeparator({ className, ...props }: ComponentPropsWithoutRef<typeof CmdkSeparator>): import("react").JSX.Element;
+//# sourceMappingURL=Command.d.ts.map

package/dist/react/palette/Command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.d.ts","sourceRoot":"","sources":["../../../src/react/palette/Command.tsx"],"names":[],"mappings":"AAQA,OAAO,EACL,YAAY,IAAI,SAAS,EACzB,YAAY,IAAI,SAAS,EACzB,YAAY,IAAI,SAAS,EACzB,WAAW,IAAI,QAAQ,EACvB,WAAW,IAAI,QAAQ,EACvB,gBAAgB,IAAI,aAAa,EACjC,OAAO,IAAI,gBAAgB,EAC5B,MAAM,MAAM,CAAC;AAEd,OAAO,KAAK,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAIjE,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,EACtB,SAAS,EACT,GAAG,KAAK,EACT,EAAE,wBAAwB,CAAC,OAAO,gBAAgB,CAAC,+BAUnD;AAED,MAAM,WAAW,iBACf,SAAQ,IAAI,CAAC,wBAAwB,CAAC,OAAO,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,iBAAiB,+BAiBhF;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,EAC1B,SAAS,EACT,kBAAoC,EACpC,GAAG,KAAK,EACT,EAAE,wBAAwB,CAAC,OAAO,QAAQ,CAAC,GAAG;IAAE,kBAAkB,CAAC,EAAE,MAAM,CAAA;CAAE,+BAS7E;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,CAAC,OAAO,SAAS,CAAC,+BAO/F;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,CAAC,OAAO,SAAS,CAAC,+BAW/F;AAED,2FAA2F;AAC3F,wBAAgB,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,EAAE,wBAAwB,CAAC,OAAO,QAAQ,CAAC,+BAY7F;AAED,qCAAqC;AACrC,wBAAgB,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,KAAK,EACT,EAAE,wBAAwB,CAAC,OAAO,aAAa,CAAC,+BAEhD"}

package/dist/react/palette/Command.js

@@ -0,0 +1,41 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+// The themed cmdk wrapper — cursedbelt's `Command.*` set, styled off the design
+// tokens so it matches the rest of the kit instead of cmdk's unstyled defaults
+// (the shadcn approach: adopt the wrapper, don't re-theme cmdk from scratch each
+// time). cmdk stays in charge of keyboard navigation (arrow/Enter/Home/End),
+// `aria-activedescendant` selection, and scrolling the active item into view; we
+// only supply the look. The scroll container is the cursedbelt `ScrollArea`, so the
+// list is keyboard-/safe-area-aware on mobile like every other scroll region.
+import { CommandEmpty as CmdkEmpty, CommandGroup as CmdkGroup, CommandInput as CmdkInput, CommandItem as CmdkItem, CommandList as CmdkList, CommandSeparator as CmdkSeparator, Command as CommandPrimitive, } from 'cmdk';
+import { Search } from 'lucide-react';
+import { ScrollArea } from '../components/ScrollArea';
+import { cn } from '../lib/cn';
+/** The Command root — a flex column that owns the input + list. */
+export function Command({ className, ...props }) {
+    return (_jsx(CommandPrimitive, { className: cn('flex min-h-0 w-full flex-col overflow-hidden bg-popover text-popover-foreground', className), ...props }));
+}
+/** The search field: a leading magnifier, the cmdk input, and an optional trailing slot. */
+export function CommandInput({ className, trailing, ...props }) {
+    return (_jsxs("div", { className: 'flex shrink-0 items-center gap-2 border-b border-border px-3', "data-cb-cmd-input": '', children: [_jsx(Search, { className: 'size-4 shrink-0 text-muted-foreground', "aria-hidden": 'true' }), _jsx(CmdkInput, { className: cn('flex h-12 w-full bg-transparent py-3 text-sm outline-none placeholder:text-muted-foreground disabled:cursor-not-allowed disabled:opacity-50', className), ...props }), trailing != null && _jsx("div", { className: 'flex shrink-0 items-center gap-2', children: trailing })] }));
+}
+/** The scrolling results region (keyboard-safe via `ScrollArea`), capped at 60dvh. */
+export function CommandList({ className, maxHeightClassName = 'max-h-[60dvh]', ...props }) {
+    return (_jsx(ScrollArea, { space: 'none', safeArea: false, className: cn(maxHeightClassName), children: _jsx(CmdkList, { className: cn('p-1', className), ...props }) }));
+}
+/** Shown (by cmdk) when the query matches nothing. */
+export function CommandEmpty({ className, ...props }) {
+    return (_jsx(CmdkEmpty, { className: cn('px-3 py-8 text-center text-sm text-muted-foreground', className), ...props }));
+}
+/** A labeled section (the heading is hidden when `heading` is omitted). */
+export function CommandGroup({ className, ...props }) {
+    return (_jsx(CmdkGroup, { className: cn('overflow-hidden py-1 text-foreground', '[&_[cmdk-group-heading]]:px-3 [&_[cmdk-group-heading]]:py-1 [&_[cmdk-group-heading]]:text-xs [&_[cmdk-group-heading]]:font-semibold [&_[cmdk-group-heading]]:uppercase [&_[cmdk-group-heading]]:tracking-wide [&_[cmdk-group-heading]]:text-muted-foreground', className), ...props }));
+}
+/** A selectable row. cmdk highlights it via `data-selected` as the user arrows through. */
+export function CommandItem({ className, ...props }) {
+    return (_jsx(CmdkItem, { className: cn('flex cursor-pointer select-none items-center gap-3 rounded-md px-3 py-2 text-sm text-foreground outline-none transition-colors', 'data-[selected=true]:bg-muted data-[selected=true]:text-foreground', 'data-[disabled=true]:pointer-events-none data-[disabled=true]:opacity-50', className), ...props }));
+}
+/** A thin divider between groups. */
+export function CommandSeparator({ className, ...props }) {
+    return _jsx(CmdkSeparator, { className: cn('mx-1 my-1 h-px bg-border', className), ...props });
+}
+//# sourceMappingURL=Command.js.map

package/dist/react/palette/Command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Command.js","sourceRoot":"","sources":["../../../src/react/palette/Command.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,+EAA+E;AAC/E,iFAAiF;AACjF,6EAA6E;AAC7E,iFAAiF;AACjF,oFAAoF;AACpF,8EAA8E;AAE9E,OAAO,EACL,YAAY,IAAI,SAAS,EACzB,YAAY,IAAI,SAAS,EACzB,YAAY,IAAI,SAAS,EACzB,WAAW,IAAI,QAAQ,EACvB,WAAW,IAAI,QAAQ,EACvB,gBAAgB,IAAI,aAAa,EACjC,OAAO,IAAI,gBAAgB,GAC5B,MAAM,MAAM,CAAC;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAE/B,mEAAmE;AACnE,MAAM,UAAU,OAAO,CAAC,EACtB,SAAS,EACT,GAAG,KAAK,EAC0C;IAClD,OAAO,CACL,KAAC,gBAAgB,IACf,SAAS,EAAE,EAAE,CACX,iFAAiF,EACjF,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAUD,4FAA4F;AAC5F,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAqB;IAC/E,OAAO,CACL,eACE,SAAS,EAAC,8DAA8D,uBACtD,EAAE,aAEpB,KAAC,MAAM,IAAC,SAAS,EAAC,uCAAuC,iBAAa,MAAM,GAAG,EAC/E,KAAC,SAAS,IACR,SAAS,EAAE,EAAE,CACX,6IAA6I,EAC7I,SAAS,CACV,KACG,KAAK,GACT,EACD,QAAQ,IAAI,IAAI,IAAI,cAAK,SAAS,EAAC,kCAAkC,YAAE,QAAQ,GAAO,IACnF,CACP,CAAC;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,WAAW,CAAC,EAC1B,SAAS,EACT,kBAAkB,GAAG,eAAe,EACpC,GAAG,KAAK,EACoE;IAC5E,OAAO,CAIL,KAAC,UAAU,IAAC,KAAK,EAAC,MAAM,EAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,CAAC,kBAAkB,CAAC,YACzE,KAAC,QAAQ,IAAC,SAAS,EAAE,EAAE,CAAC,KAAK,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,GAC7C,CACd,CAAC;AACJ,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAA8C;IAC9F,OAAO,CACL,KAAC,SAAS,IACR,SAAS,EAAE,EAAE,CAAC,qDAAqD,EAAE,SAAS,CAAC,KAC3E,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,YAAY,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAA8C;IAC9F,OAAO,CACL,KAAC,SAAS,IACR,SAAS,EAAE,EAAE,CACX,sCAAsC,EACtC,8PAA8P,EAC9P,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAED,2FAA2F;AAC3F,MAAM,UAAU,WAAW,CAAC,EAAE,SAAS,EAAE,GAAG,KAAK,EAA6C;IAC5F,OAAO,CACL,KAAC,QAAQ,IACP,SAAS,EAAE,EAAE,CACX,gIAAgI,EAChI,oEAAoE,EACpE,0EAA0E,EAC1E,SAAS,CACV,KACG,KAAK,GACT,CACH,CAAC;AACJ,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,gBAAgB,CAAC,EAC/B,SAAS,EACT,GAAG,KAAK,EACuC;IAC/C,OAAO,KAAC,aAAa,IAAC,SAAS,EAAE,EAAE,CAAC,0BAA0B,EAAE,SAAS,CAAC,KAAM,KAAK,GAAI,CAAC;AAC5F,CAAC"}

package/dist/react/palette/CommandPalette.d.ts

@@ -0,0 +1,64 @@
+import { type ReactNode } from 'react';
+import { type GateFn, type NavigationModel } from '../../core/navigation';
+import type { ShortcutEntry } from '../../core/palette/ShortcutRegistry';
+import type { IconResolver } from '../nav/navShared';
+import type { SearchResultGroup } from '../nav/SearchResults';
+export interface CommandPaletteProps {
+    /** The single navigation registry (task 13) — the palette's page source of truth. */
+    model: NavigationModel;
+    /** Visibility gate (auth / role / ctgr). Items it rejects never reach uFuzzy. Default: allow all. */
+    gate?: GateFn;
+    /** Navigate to a path and close the palette (a router push — never a fetch). */
+    onNavigate: (path: string) => void;
+    /** Open state — owned by `useCommandPalette` (or the app). */
+    open: boolean;
+    onOpenChange: (open: boolean) => void;
+    /** Pinned paths (from `preferences.shortcuts`) — rendered as the cold-state quick-bar. */
+    pins?: string[];
+    /** Toggle a pin (right-click / long-press / Delete on a chip → unpin; the `+` → pin current). */
+    onPinToggle?: (path: string, pinned: boolean) => void;
+    /** Current route — enables the "Pin this page" `+` affordance at the end of the quick-bar. */
+    currentPath?: string;
+    /** Max pins shown in the quick-bar. Default 8. */
+    pinsLimit?: number;
+    /** Recently-visited paths (newest first) — shown in the cold state below pins. App-tracked. */
+    recentPaths?: string[];
+    /** Max recent pages shown. Default 6. */
+    recentLimit?: number;
+    /**
+     * Registered keyboard shortcuts to surface (cold state + matched while typing). Omit
+     * to read the live {@link shortcutRegistry} singleton instead.
+     */
+    shortcuts?: ShortcutEntry[];
+    /** Invoked when a shortcut row is chosen (the palette closes either way). */
+    onShortcut?: (shortcut: ShortcutEntry) => void;
+    /**
+     * Debounced server content results (Notes / Lists / Contacts / Events / Messages /
+     * Prompts). The app owns the fetch: subscribe to `onQueryChange`, hit `/search`, feed
+     * groups back here. Rendered below the fuzzy page results.
+     */
+    serverGroups?: SearchResultGroup[];
+    /** Fired with the debounced query so the app can run the server `/search`. */
+    onQueryChange?: (query: string) => void;
+    /** App-controlled: a server search is in flight (drives the input spinner). */
+    searching?: boolean;
+    /** Server-search debounce in ms. Default 300. */
+    searchDebounceMs?: number;
+    /** Resolve model icon *names* to nodes (the app wires its icon set, e.g. lucide). */
+    resolveIcon?: IconResolver;
+    /** Max fuzzy page results. Default 30. */
+    pagesLimit?: number;
+    placeholder?: string;
+    /** Shown when a query matches nothing. */
+    emptyContent?: ReactNode;
+    className?: string;
+}
+/**
+ * The Cmd/Ctrl-K command palette overlay. Cold state (empty input): pins quick-bar +
+ * recent pages + registered shortcuts. Active state: uFuzzy-ranked pages grouped by
+ * domain, then server content groups, then matched shortcuts. Keyboard navigation,
+ * `aria-activedescendant` selection, and active-item scrolling come from cmdk; the
+ * Radix `Dialog` traps focus and renders the backdrop.
+ */
+export declare function CommandPalette({ model, gate, onNavigate, open, onOpenChange, pins, onPinToggle, currentPath, pinsLimit, recentPaths, recentLimit, shortcuts, onShortcut, serverGroups, onQueryChange, searching, searchDebounceMs, resolveIcon, pagesLimit, placeholder, emptyContent, className, }: CommandPaletteProps): import("react").JSX.Element;
+//# sourceMappingURL=CommandPalette.d.ts.map

package/dist/react/palette/CommandPalette.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandPalette.d.ts","sourceRoot":"","sources":["../../../src/react/palette/CommandPalette.tsx"],"names":[],"mappings":"AAeA,OAAO,EAAE,KAAK,SAAS,EAAwC,MAAM,OAAO,CAAC;AAC7E,OAAO,EAGL,KAAK,MAAM,EACX,KAAK,eAAe,EAGrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAIzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAW9D,MAAM,WAAW,mBAAmB;IAClC,qFAAqF;IACrF,KAAK,EAAE,eAAe,CAAC;IACvB,qGAAqG;IACrG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAEnC,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAEtC,0FAA0F;IAC1F,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,iGAAiG;IACjG,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACtD,8FAA8F;IAC9F,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+FAA+F;IAC/F,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,aAAa,EAAE,CAAC;IAC5B,6EAA6E;IAC7E,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;IAE/C;;;;OAIG;IACH,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACnC,8EAA8E;IAC9E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,+EAA+E;IAC/E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,qFAAqF;IACrF,WAAW,CAAC,EAAE,YAAY,CAAC;IAC3B,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAmB,EACnB,UAAU,EACV,IAAI,EACJ,YAAY,EACZ,IAAI,EACJ,WAAW,EACX,WAAW,EACX,SAAa,EACb,WAAW,EACX,WAAe,EACf,SAAS,EACT,UAAU,EACV,YAAY,EACZ,aAAa,EACb,SAAiB,EACjB,gBAAsB,EACtB,WAAW,EACX,UAAe,EACf,WAA4C,EAC5C,YAA4B,EAC5B,SAAS,GACV,EAAE,mBAAmB,+BAwPrB"}