cursedbelt 0.0.0

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

@@ -0,0 +1,36 @@
+import { type GateFn, type NavigationModel } from '../../core/navigation';
+import { type NavNavigationProps } from './navShared';
+export interface PlaceBarProps extends NavNavigationProps {
+    /** The navigation model — the small fixed *place-set* is `model.domains`. */
+    model: NavigationModel;
+    /** Visibility gate (auth/role/ctgr). Default: everything visible. */
+    gate?: GateFn;
+    /** Current route — the active place lights up. */
+    activeHref?: string;
+    /** Dynamic per-place badge (unread dot), keyed by domain id. */
+    badges?: Record<string, number | string>;
+    /**
+     * Universal capture — the raised centre FAB. Capture-forward is the whole point of
+     * the mobile shell (§7): speaking/typing a capture beats hunting a hamburger. Omit
+     * to render the place-set without a FAB.
+     */
+    onCapture?: () => void;
+    /** Accessible label for the capture FAB. Default `'Capture'`. */
+    captureLabel?: string;
+    /**
+     * Max places shown in the thumb zone (the rest stay reachable via the command
+     * spine). The spatial floor is deliberately small (§6). Default `5`.
+     */
+    max?: number;
+    className?: string;
+}
+/**
+ * The mobile **capture-forward bottom bar** — the reimagined phone home (UX north-star
+ * §7), replacing the old hamburger → `translate-x` drawer. The small fixed place-set
+ * rides the thumb zone, split around a **raised centre capture FAB**, so the two most
+ * frequent phone actions (go to a place / capture a thought) are both one thumb-tap —
+ * never hidden behind a menu. Renders from the one `navigationModel` registry, so it
+ * can never drift from the desktop rail or the search catalogue.
+ */
+export declare function PlaceBar({ model, gate, activeHref, badges, onCapture, captureLabel, max, linkComponent, onNavigate, onAfterNavigate, resolveIcon, className, }: PlaceBarProps): import("react").JSX.Element;
+//# sourceMappingURL=PlaceBar.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PlaceBar.d.ts","sourceRoot":"","sources":["../../../src/react/nav/PlaceBar.tsx"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,MAAM,EAEX,KAAK,eAAe,EACrB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAyB,KAAK,kBAAkB,EAAyB,MAAM,aAAa,CAAC;AAEpG,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,6EAA6E;IAC7E,KAAK,EAAE,eAAe,CAAC;IACvB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EACvB,KAAK,EACL,IAAmB,EACnB,UAAU,EACV,MAAM,EACN,SAAS,EACT,YAAwB,EACxB,GAAO,EACP,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,GACV,EAAE,aAAa,+BA0Cf"}

package/dist/react/nav/PlaceBar.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Plus } from 'lucide-react';
+import { allowAllGate, deriveSideNavDomains, } from '../../core/navigation';
+import { cn } from '../lib/cn';
+import { isPathWithin, NavLink, navAccent, renderIcon } from './navShared';
+/**
+ * The mobile **capture-forward bottom bar** — the reimagined phone home (UX north-star
+ * §7), replacing the old hamburger → `translate-x` drawer. The small fixed place-set
+ * rides the thumb zone, split around a **raised centre capture FAB**, so the two most
+ * frequent phone actions (go to a place / capture a thought) are both one thumb-tap —
+ * never hidden behind a menu. Renders from the one `navigationModel` registry, so it
+ * can never drift from the desktop rail or the search catalogue.
+ */
+export function PlaceBar({ model, gate = allowAllGate, activeHref, badges, onCapture, captureLabel = 'Capture', max = 5, linkComponent, onNavigate, onAfterNavigate, resolveIcon, className, }) {
+    const places = deriveSideNavDomains(model, gate).slice(0, Math.max(0, max));
+    const navProps = { linkComponent, onNavigate, onAfterNavigate, resolveIcon };
+    // Split the place-set so the capture FAB sits dead-centre in the thumb arc.
+    const mid = Math.ceil(places.length / 2);
+    const left = places.slice(0, mid);
+    const right = places.slice(mid);
+    const renderPlace = (place) => (_jsx(PlaceTab, { place: place, active: isDomainActive(place, activeHref), badge: badges?.[place.id], ...navProps }, place.id));
+    return (_jsxs("nav", { "data-cb-placebar": '', "aria-label": 'Places', className: cn('flex items-stretch justify-around gap-1 px-2 py-1', className), children: [left.map(renderPlace), onCapture && (_jsx("div", { className: 'flex shrink-0 items-center justify-center', children: _jsx("button", { type: 'button', "data-cb-capture": '', "aria-label": captureLabel, onClick: onCapture, className: '-mt-5 grid size-14 place-items-center rounded-full bg-accent-solid text-white shadow-lg transition-colors hover:bg-accent-solid-hover focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-accent-solid focus-visible:ring-offset-2 focus-visible:ring-offset-background', children: _jsx(Plus, { className: 'size-6', "aria-hidden": 'true' }) }) })), right.map(renderPlace)] }));
+}
+/** A place is active when the route is its landing or lives within it (rail-consistent). */
+function isDomainActive(domain, activeHref) {
+    if (isPathWithin(domain.path, activeHref))
+        return true;
+    return domain.groups.some((g) => g.items.some((it) => isPathWithin(it.path, activeHref)));
+}
+function PlaceTab({ place, active, badge, linkComponent, onNavigate, onAfterNavigate, resolveIcon, }) {
+    const accent = navAccent(undefined);
+    const icon = renderIcon(resolveIcon, place.icon);
+    const showBadge = badge != null && badge !== 0;
+    return (_jsxs(NavLink, { path: place.path, linkComponent: linkComponent, onNavigate: onNavigate, onAfterNavigate: onAfterNavigate, ariaCurrent: active ? 'page' : undefined, className: cn('relative flex min-w-0 flex-1 flex-col items-center justify-center gap-0.5 rounded-md px-1 py-1.5 text-xs font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring', active ? '' : 'text-muted-foreground hover:bg-muted hover:text-foreground'), style: active ? { color: accent } : undefined, children: [_jsxs("span", { className: 'relative grid size-6 place-items-center [&_svg]:size-5', "aria-hidden": 'true', children: [icon, showBadge && (_jsx("span", { className: 'absolute -right-1.5 -top-1 min-w-3.5 rounded-full bg-destructive px-1 text-[0.625rem] font-bold leading-4 text-destructive-foreground', children: typeof badge === 'number' && badge > 99 ? '99+' : badge }))] }), _jsx("span", { className: 'max-w-full truncate', children: place.label })] }));
+}
+//# sourceMappingURL=PlaceBar.js.map

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

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

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

@@ -0,0 +1,43 @@
+import type { ReactNode } from 'react';
+import { type NavNavigationProps } from './navShared';
+/** One result hit — a page (from the catalogue) or a content record (from server). */
+export interface SearchResultRow {
+    id: string;
+    path: string;
+    label: string;
+    /** Secondary line (e.g. owning domain/group, or a snippet). */
+    sub?: string;
+    /** Model icon *name* (resolved via `resolveIcon`). */
+    icon?: string;
+    /** Pre-resolved icon node (server rows that supply their own glyph). */
+    iconNode?: ReactNode;
+    /** Trailing node (e.g. a type chip / count). */
+    badge?: ReactNode;
+}
+/** A labeled bucket of rows (a domain's pages, or a server content type). */
+export interface SearchResultGroup {
+    key: string;
+    label: string;
+    icon?: ReactNode;
+    items: SearchResultRow[];
+}
+export interface SearchResultsProps extends NavNavigationProps {
+    groups: SearchResultGroup[];
+    /** Id of the keyboard-highlighted row (drives `aria-selected` + the active style). */
+    activeId?: string;
+    /** Prefix for each option's DOM id (so a combobox input can set aria-activedescendant). */
+    optionIdPrefix?: string;
+    /** Shown when there are no groups/rows. */
+    emptyContent?: ReactNode;
+    className?: string;
+}
+/** Build the stable DOM id for a row option (shared with the combobox input). */
+export declare const searchOptionId: (prefix: string, rowId: string) => string;
+/**
+ * The grouped, keyboard-navigable results panel for {@link HeaderSearch} — sections
+ * for instant "Pages" (from the nav catalogue) and any server "Content" groups. Each
+ * row navigates via the shared {@link NavLink}; the `activeId` row is visually
+ * highlighted + `aria-selected` for arrow-key navigation driven by the search input.
+ */
+export declare function SearchResults({ groups, activeId, optionIdPrefix, emptyContent, linkComponent, onNavigate, onAfterNavigate, resolveIcon, className, }: SearchResultsProps): import("react").JSX.Element | null;
+//# sourceMappingURL=SearchResults.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SearchResults.d.ts","sourceRoot":"","sources":["../../../src/react/nav/SearchResults.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,EAAW,KAAK,kBAAkB,EAAc,MAAM,aAAa,CAAC;AAE3E,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,eAAe,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,kBAAkB;IAC5D,MAAM,EAAE,iBAAiB,EAAE,CAAC;IAC5B,sFAAsF;IACtF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2FAA2F;IAC3F,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2CAA2C;IAC3C,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iFAAiF;AACjF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,EAAE,OAAO,MAAM,WAA6B,CAAC;AAE1F;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,cAAyB,EACzB,YAAY,EACZ,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,SAAS,GACV,EAAE,kBAAkB,sCAwEpB"}

package/dist/react/nav/SearchResults.js

@@ -0,0 +1,26 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../lib/cn';
+import { NavLink, renderIcon } from './navShared';
+/** Build the stable DOM id for a row option (shared with the combobox input). */
+export const searchOptionId = (prefix, rowId) => `${prefix}-opt-${rowId}`;
+/**
+ * The grouped, keyboard-navigable results panel for {@link HeaderSearch} — sections
+ * for instant "Pages" (from the nav catalogue) and any server "Content" groups. Each
+ * row navigates via the shared {@link NavLink}; the `activeId` row is visually
+ * highlighted + `aria-selected` for arrow-key navigation driven by the search input.
+ */
+export function SearchResults({ groups, activeId, optionIdPrefix = 'search', emptyContent, linkComponent, onNavigate, onAfterNavigate, resolveIcon, className, }) {
+    const hasResults = groups.some((g) => g.items.length > 0);
+    if (!hasResults) {
+        return emptyContent ? (_jsx("div", { className: cn('p-6 text-center', className), children: emptyContent })) : null;
+    }
+    return (_jsx("div", { className: cn('flex flex-col', className), role: 'listbox', "aria-label": 'Search results', children: groups.map((group) => group.items.length === 0 ? null : (_jsxs("div", { className: 'py-1', children: [_jsxs("p", { className: 'flex items-center gap-1.5 px-3 py-1 text-xs font-semibold uppercase tracking-wide text-muted-foreground', children: [group.icon && _jsx("span", { className: '[&_svg]:size-3.5', children: group.icon }), group.label] }), _jsx("div", { children: group.items.map((row) => {
+                        const active = row.id === activeId;
+                        const icon = row.iconNode ?? renderIcon(resolveIcon, row.icon);
+                        return (_jsx("div", { id: searchOptionId(optionIdPrefix, row.id), role: 'option', "aria-selected": active, 
+                            // Focus stays on the combobox input (aria-activedescendant points
+                            // here); the option is programmatically focusable, never a Tab stop.
+                            tabIndex: -1, children: _jsxs(NavLink, { path: row.path, linkComponent: linkComponent, onNavigate: onNavigate, onAfterNavigate: onAfterNavigate, className: cn('flex w-full items-center gap-3 px-3 py-2 text-left text-sm transition-colors', active ? 'bg-muted text-foreground' : 'text-foreground hover:bg-muted'), children: [icon && (_jsx("span", { className: 'grid size-5 shrink-0 place-items-center text-muted-foreground [&_svg]:size-4', "aria-hidden": 'true', children: icon })), _jsxs("span", { className: 'min-w-0 flex-1', children: [_jsx("span", { className: 'block truncate font-medium', children: row.label }), row.sub && (_jsx("span", { className: 'block truncate text-xs text-muted-foreground', children: row.sub }))] }), row.badge != null && (_jsx("span", { className: 'shrink-0 text-xs text-muted-foreground', children: row.badge }))] }) }, row.id));
+                    }) })] }, group.key))) }));
+}
+//# sourceMappingURL=SearchResults.js.map

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

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

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

@@ -0,0 +1,37 @@
+import { type ReactNode } from 'react';
+import { type GateFn, type NavigationModel, type NavPreferences } from '../../core/navigation';
+import { type NavNavigationProps } from './navShared';
+export interface SideNavProps extends NavNavigationProps {
+    /** The single navigation model — the side-nav rail is `model.domains`. */
+    model: NavigationModel;
+    /** Current route — a domain lights up when active or an ancestor of the route. */
+    activeHref?: string;
+    /** Visibility gate (auth/role/ctgr). Default: everything visible. */
+    gate?: GateFn;
+    /** Per-user customization (order/hide/color). When `onPrefsChange` is set, rows
+     *  gain a drag handle + a `⋮` menu (hide/recolor) + a restore-hidden control. */
+    prefs?: NavPreferences;
+    onPrefsChange?: (next: NavPreferences) => void;
+    /** Icon-rail mode (icon + tooltip only) — used on narrow desktop. */
+    collapsed?: boolean;
+    /** Dynamic per-domain badge (unread count, etc.), keyed by domain id. */
+    badges?: Record<string, number | string>;
+    /** App slot above the list (logo / brand). */
+    header?: ReactNode;
+    /** App slot below the list (theme toggle / avatar). */
+    footer?: ReactNode;
+    className?: string;
+}
+/**
+ * The side-navigation rail — the browsable backbone, rendered entirely from the
+ * {@link NavigationModel}'s domains (never a hand-maintained list). Each row is a
+ * navigable domain hub with an active highlight; in `collapsed` mode it's an
+ * icon-rail with a tooltip label. When an app wires `onPrefsChange`, rows become
+ * drag-reorderable (keyboard + touch via the shared dnd-kit hook) and gain a `⋮`
+ * menu to hide or recolor them, with hidden domains restorable from a footer control.
+ *
+ * Consumed by `AppShell` (which renders it inside the desktop sidebar AND the mobile
+ * drawer); also usable standalone.
+ */
+export declare function SideNav({ model, activeHref, gate, linkComponent, onNavigate, onAfterNavigate, resolveIcon, prefs, onPrefsChange, collapsed, badges, header, footer, className, }: SideNavProps): import("react").JSX.Element;
+//# sourceMappingURL=SideNav.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SideNav.d.ts","sourceRoot":"","sources":["../../../src/react/nav/SideNav.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AACjD,OAAO,EAIL,KAAK,MAAM,EAEX,KAAK,eAAe,EACpB,KAAK,cAAc,EACpB,MAAM,uBAAuB,CAAC;AAO/B,OAAO,EAIL,KAAK,kBAAkB,EAIxB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,YAAa,SAAQ,kBAAkB;IACtD,0EAA0E;IAC1E,KAAK,EAAE,eAAe,CAAC;IACvB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;qFACiF;IACjF,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAC/C,qEAAqE;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;IACzC,8CAA8C;IAC9C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,uDAAuD;IACvD,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,UAAU,EACV,IAAmB,EACnB,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,EACX,KAAK,EACL,aAAa,EACb,SAAiB,EACjB,MAAM,EACN,MAAM,EACN,MAAM,EACN,SAAS,GACV,EAAE,YAAY,+BA4Fd"}

package/dist/react/nav/SideNav.js

@@ -0,0 +1,76 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { GripVertical, Plus } from 'lucide-react';
+import { useState } from 'react';
+import { allowAllGate, CURRENT_NAV_PREFS_VERSION, deriveSideNavDomains, } from '../../core/navigation';
+import { Popover } from '../components/Popover';
+import { Tooltip } from '../components/Tooltip';
+import { useDragReorder } from '../hooks/useDragReorder';
+import { cn } from '../lib/cn';
+import { NavItemMenu } from './NavItemMenu';
+import { isPathWithin, NavLink, navAccent, rankBySavedOrder, renderIcon, } from './navShared';
+/**
+ * The side-navigation rail — the browsable backbone, rendered entirely from the
+ * {@link NavigationModel}'s domains (never a hand-maintained list). Each row is a
+ * navigable domain hub with an active highlight; in `collapsed` mode it's an
+ * icon-rail with a tooltip label. When an app wires `onPrefsChange`, rows become
+ * drag-reorderable (keyboard + touch via the shared dnd-kit hook) and gain a `⋮`
+ * menu to hide or recolor them, with hidden domains restorable from a footer control.
+ *
+ * Consumed by `AppShell` (which renders it inside the desktop sidebar AND the mobile
+ * drawer); also usable standalone.
+ */
+export function SideNav({ model, activeHref, gate = allowAllGate, linkComponent, onNavigate, onAfterNavigate, resolveIcon, prefs, onPrefsChange, collapsed = false, badges, header, footer, className, }) {
+    const domains = deriveSideNavDomains(model, gate);
+    const hiddenIds = prefs?.hidden ?? [];
+    const visible = rankBySavedOrder(domains.filter((d) => !hiddenIds.includes(d.id)), (d) => d.id, prefs?.order);
+    const hiddenDomains = domains.filter((d) => hiddenIds.includes(d.id));
+    const canCustomize = Boolean(onPrefsChange) && !collapsed;
+    const setPref = (patch) => onPrefsChange?.({ version: CURRENT_NAV_PREFS_VERSION, ...prefs, ...patch });
+    const reorder = useDragReorder({
+        items: visible,
+        getKey: (d) => d.id,
+        onReorder: (next) => setPref({ order: next.map((d) => d.id) }),
+        axis: 'y',
+        handle: true,
+        disabled: !canCustomize,
+    });
+    const navProps = { linkComponent, onNavigate, onAfterNavigate, resolveIcon };
+    const renderRow = (domain, drag) => (_jsx(DomainRow, { domain: domain, active: isDomainActive(domain, activeHref), color: prefs?.colors?.[domain.id], badge: badges?.[domain.id], collapsed: collapsed, canCustomize: canCustomize, drag: drag, onHide: () => setPref({ hidden: [...hiddenIds, domain.id] }), onColor: (color) => {
+            const colors = { ...(prefs?.colors ?? {}) };
+            if (color)
+                colors[domain.id] = color;
+            else
+                delete colors[domain.id];
+            setPref({ colors });
+        }, ...navProps }, domain.id));
+    return (_jsxs("nav", { "data-cb-sidenav": '', "aria-label": 'Primary', className: cn('flex h-full flex-col', collapsed ? 'w-16' : 'w-full', className), children: [header && _jsx("div", { className: 'shrink-0 border-b border-border px-3 py-4', children: header }), _jsx("div", { className: 'min-h-0 flex-1 overflow-y-auto p-2', children: canCustomize ? (_jsx(reorder.DragContext, { children: _jsx("ul", { className: 'space-y-0.5', children: visible.map((domain) => (_jsx(reorder.Sortable, { itemKey: domain.id, children: (api) => (_jsx("li", { ref: api.setNodeRef, style: api.style, children: renderRow(domain, api) })) }, domain.id))) }) })) : (_jsx("ul", { className: 'space-y-0.5', children: visible.map((domain) => (_jsx("li", { children: renderRow(domain) }, domain.id))) })) }), (footer || (canCustomize && hiddenDomains.length > 0)) && (_jsxs("div", { className: 'shrink-0 space-y-2 border-t border-border px-3 py-3', children: [canCustomize && hiddenDomains.length > 0 && (_jsx(RestoreHiddenMenu, { domains: hiddenDomains, resolveIcon: resolveIcon, onRestore: (id) => setPref({ hidden: hiddenIds.filter((x) => x !== id) }) })), footer] }))] }));
+}
+/** A domain is active when the route is its landing or lives within it. */
+function isDomainActive(domain, activeHref) {
+    if (isPathWithin(domain.path, activeHref))
+        return true;
+    return domain.groups.some((g) => g.items.some((it) => isPathWithin(it.path, activeHref)));
+}
+function DomainRow({ domain, active, color, badge, collapsed, canCustomize, drag, onHide, onColor, linkComponent, onNavigate, onAfterNavigate, resolveIcon, }) {
+    const accent = navAccent(color);
+    const icon = renderIcon(resolveIcon, domain.icon);
+    const link = (_jsxs(NavLink, { path: domain.path, linkComponent: linkComponent, onNavigate: onNavigate, onAfterNavigate: onAfterNavigate, ariaCurrent: active ? 'page' : undefined, title: collapsed ? domain.label : undefined, className: cn('group/navrow relative flex items-center rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring', collapsed ? 'size-10 justify-center' : 'w-full gap-3 px-3 py-2', active ? 'bg-muted' : 'text-foreground hover:bg-muted'), style: active ? { color: accent } : undefined, children: [active && !collapsed && (_jsx("span", { "aria-hidden": 'true', className: 'absolute inset-y-1.5 left-0 w-0.5 rounded-full', style: { backgroundColor: accent } })), icon && (_jsx("span", { className: 'grid size-5 shrink-0 place-items-center [&_svg]:size-5', "aria-hidden": 'true', children: icon })), !collapsed && _jsx("span", { className: 'flex-1 truncate text-left', children: domain.label }), !collapsed && badge != null && badge !== 0 && (_jsx("span", { className: 'rounded-full bg-destructive px-1.5 py-0.5 text-xs font-bold text-destructive-foreground', children: typeof badge === 'number' && badge > 99 ? '99+' : badge }))] }));
+    // Icon-rail: just the icon link with a portal tooltip carrying the label.
+    if (collapsed) {
+        return (_jsx(Tooltip, { content: domain.label, side: 'right', mobile: 'off', children: link }));
+    }
+    // Expanded: the link + (when customizing) a reveal-on-hover drag handle + kebab.
+    return (_jsxs("div", { className: 'group/navitem relative flex items-center', children: [_jsx("div", { className: 'min-w-0 flex-1', children: link }), canCustomize && (_jsxs("div", { className: 'absolute right-1 flex items-center gap-0.5 opacity-0 transition-opacity focus-within:opacity-100 group-hover/navitem:opacity-100', children: [_jsx("button", { type: 'button', "aria-label": `Reorder ${domain.label}`, ref: drag?.setActivatorNodeRef, ...drag?.handleProps, 
+                        // tabIndex AFTER the spread so it overrides dnd-kit's tabIndex=0: the grip
+                        // is a pointer affordance only and must NOT be a Tab stop, so keyboard
+                        // users tab cleanly through the nav links (a11y gotcha #NavItemMenu).
+                        tabIndex: -1, className: 'inline-flex size-6 cursor-grab items-center justify-center rounded text-muted-foreground hover:text-foreground', children: _jsx(GripVertical, { className: 'size-4' }) }), _jsx(NavItemMenu, { label: domain.label, color: color, onColor: onColor, onHide: onHide })] }))] }));
+}
+function RestoreHiddenMenu({ domains, resolveIcon, onRestore, }) {
+    const [open, setOpen] = useState(false);
+    return (_jsx(Popover, { open: open, onOpenChange: setOpen, align: 'start', arrow: false, className: 'w-52', trigger: _jsxs("button", { type: 'button', className: 'flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-xs font-medium text-muted-foreground transition-colors hover:bg-muted hover:text-foreground', children: [_jsx(Plus, { className: 'size-3.5' }), `Show hidden (${domains.length})`] }), children: _jsx("ul", { className: 'flex flex-col gap-0.5', children: domains.map((d) => (_jsx("li", { children: _jsxs("button", { type: 'button', onClick: () => {
+                        onRestore(d.id);
+                        setOpen(false);
+                    }, className: 'flex w-full items-center gap-2 rounded-md px-2 py-1.5 text-sm text-foreground transition-colors hover:bg-muted', children: [renderIcon(resolveIcon, d.icon) && (_jsx("span", { className: 'grid size-4 place-items-center [&_svg]:size-4', "aria-hidden": 'true', children: renderIcon(resolveIcon, d.icon) })), _jsx("span", { className: 'truncate', children: d.label })] }) }, d.id))) }) }));
+}
+//# sourceMappingURL=SideNav.js.map

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

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

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

@@ -0,0 +1,28 @@
+import { type ElementType, type ReactNode } from 'react';
+import { type StyleableProps } from '../styling';
+import type { NavEntry } from './types';
+export type SideNavItemSlot = 'root' | 'link' | 'active' | 'inactive' | 'menuActive' | 'icon' | 'label' | 'trailing' | 'menu';
+export interface SideNavItemProps extends StyleableProps<SideNavItemSlot> {
+    entry: NavEntry;
+    collapsed?: boolean;
+    /** Element/component for the link (default `<a>`; pass a router `Link`). */
+    linkComponent?: ElementType;
+    /** Fired on activation (e.g. close the mobile drawer). */
+    onNavigate?: () => void;
+    /** Recolor/hide callbacks — omit both to render the row without a kebab menu. */
+    onColor?: (entry: NavEntry, color: string | undefined) => void;
+    onHide?: (entry: NavEntry, hidden: boolean) => void;
+    /** App-specific actions appended inside the kebab menu. */
+    menuExtras?: (entry: NavEntry) => ReactNode;
+}
+/**
+ * One side-nav row: a link (`icon + label`) with an active highlight and an
+ * optional accent (a left inset bar + icon tint from `entry.color`). Collapses to
+ * an icon rail on desktop. A hover-revealed kebab (sibling of the link, so it
+ * never navigates) recolors/hides the row + hosts `menuExtras`. The active-state
+ * look is its own slot so each app themes it (emerald, accent, …). While that kebab
+ * menu is open the row rings itself and pins the kebab visible, and the popover
+ * names the row — so the detached popover is never mistaken for another item's.
+ */
+export declare const SideNavItem: ({ entry, collapsed, linkComponent: Link, onNavigate, onColor, onHide, menuExtras, classNames, styles, unstyled, }: SideNavItemProps) => import("react").JSX.Element;
+//# sourceMappingURL=SideNavItem.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SideNavItem.d.ts","sourceRoot":"","sources":["../../../src/react/nav/SideNavItem.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,WAAW,EAAE,KAAK,SAAS,EAAY,MAAM,OAAO,CAAC;AAEvF,OAAO,EAAkC,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,MAAM,GACN,QAAQ,GACR,UAAU,GACV,YAAY,GACZ,MAAM,GACN,OAAO,GACP,UAAU,GACV,MAAM,CAAC;AAEX,MAAM,WAAW,gBAAiB,SAAQ,cAAc,CAAC,eAAe,CAAC;IACvE,KAAK,EAAE,QAAQ,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,iFAAiF;IACjF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAC;IAC/D,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;IACpD,2DAA2D;IAC3D,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,SAAS,CAAC;CAC7C;AAWD;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAI,mHAWzB,gBAAgB,gCA6FlB,CAAC"}

package/dist/react/nav/SideNavItem.js

@@ -0,0 +1,38 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from 'react';
+import { REVEAL_ON_HOVER } from '../components/revealOnHover';
+import { cx, resolveClass, resolveStyle } from '../styling';
+import { NavItemMenu } from './NavItemMenu';
+const LINK_BASE = 'flex h-10 items-center gap-3 rounded-lg pl-3 pr-2 text-sm font-medium transition';
+const ACTIVE_DEFAULT = 'bg-gray-100 text-gray-900 dark:bg-gray-800 dark:text-gray-100';
+const INACTIVE_DEFAULT = 'text-gray-600 hover:bg-gray-100 dark:text-gray-300 dark:hover:bg-gray-800';
+// While this row's kebab menu is open, ring the row so it's unmistakable which item
+// the (portal-rendered, detached) popover belongs to.
+const MENU_ACTIVE_DEFAULT = 'ring-2 ring-inset ring-gray-300 dark:ring-gray-600';
+/**
+ * One side-nav row: a link (`icon + label`) with an active highlight and an
+ * optional accent (a left inset bar + icon tint from `entry.color`). Collapses to
+ * an icon rail on desktop. A hover-revealed kebab (sibling of the link, so it
+ * never navigates) recolors/hides the row + hosts `menuExtras`. The active-state
+ * look is its own slot so each app themes it (emerald, accent, …). While that kebab
+ * menu is open the row rings itself and pins the kebab visible, and the popover
+ * names the row — so the detached popover is never mistaken for another item's.
+ */
+export const SideNavItem = ({ entry, collapsed, linkComponent: Link = 'a', onNavigate, onColor, onHide, menuExtras, classNames, styles, unstyled, }) => {
+    const { href, label, icon, active, color, trailing, title } = entry;
+    const hasMenu = Boolean(onColor && onHide) && !collapsed;
+    const [menuOpen, setMenuOpen] = useState(false);
+    const activeClass = resolveClass(ACTIVE_DEFAULT, classNames?.active, unstyled);
+    const inactiveClass = resolveClass(INACTIVE_DEFAULT, classNames?.inactive, unstyled);
+    const menuActiveClass = resolveClass(MENU_ACTIVE_DEFAULT, classNames?.menuActive, unstyled);
+    const linkClass = resolveClass(cx(LINK_BASE, collapsed && 'md:justify-center', hasMenu && 'pr-9', active ? activeClass : inactiveClass, menuOpen && menuActiveClass), classNames?.link, unstyled);
+    // Accent bar is structural (inline box-shadow) so it doesn't shift the row.
+    const linkStyle = resolveStyle(color && !active ? { boxShadow: `inset 3px 0 0 0 ${color}` } : {}, styles?.link, unstyled);
+    const targetProps = Link === 'a' ? { href } : { to: href };
+    const iconStyle = color && !active ? { color } : undefined;
+    return (_jsxs("div", { className: resolveClass('group relative', classNames?.root, unstyled), children: [_jsxs(Link, { ...targetProps, onClick: onNavigate, title: collapsed ? (title ?? label) : undefined, className: linkClass, style: linkStyle, children: [_jsx("span", { className: resolveClass('shrink-0 text-lg', classNames?.icon, unstyled), style: iconStyle, children: icon }), _jsx("span", { className: resolveClass(cx('grow truncate', collapsed && 'md:hidden'), classNames?.label, unstyled), children: label }), trailing && (_jsx("span", { className: resolveClass(cx('shrink-0', collapsed && 'md:hidden'), classNames?.trailing, unstyled), children: trailing }))] }), hasMenu && (_jsx("span", { className: resolveClass(cx('absolute right-1 top-1/2 -translate-y-1/2', REVEAL_ON_HOVER, 'focus-within:opacity-100', 
+                // Keep the kebab on-screen while its menu is open (else the hover-reveal
+                // fades the very button the popover points back to).
+                menuOpen && 'opacity-100'), classNames?.menu, unstyled), children: _jsx(NavItemMenu, { label: label, headerIcon: icon, color: color, onColor: (c) => onColor?.(entry, c), onHide: () => onHide?.(entry, true), onOpenChange: setMenuOpen, children: menuExtras?.(entry) }) }))] }));
+};
+//# sourceMappingURL=SideNavItem.js.map

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

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

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

@@ -0,0 +1,8 @@
+/** A curated palette of saturated, light/dark-friendly accent colors. */
+export declare const NAV_COLORS: readonly ["#f43f5e", "#f97316", "#f59e0b", "#10b981", "#14b8a6", "#3b82f6", "#8b5cf6", "#ec4899"];
+/**
+ * Relative-luminance contrast pick: returns a near-black or near-white that reads
+ * against `hex`, so a solid swatch of ANY chosen color keeps a legible glyph.
+ */
+export declare const readableTextOn: (hex: string) => string;
+//# sourceMappingURL=colors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/react/nav/colors.ts"],"names":[],"mappings":"AAIA,yEAAyE;AACzE,eAAO,MAAM,UAAU,mGASb,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,MAU5C,CAAC"}

package/dist/react/nav/colors.js

@@ -0,0 +1,31 @@
+// Accent-color palette + contrast helper shared by the nav toolkit (sidebar
+// rows, the kebab menu, and hub tiles). Moved here from the apps' hand-copied
+// `ColorPicker`/`HubTileColorPicker` so there's one palette/one luminance pick.
+/** A curated palette of saturated, light/dark-friendly accent colors. */
+export const NAV_COLORS = [
+    '#f43f5e', // rose
+    '#f97316', // orange
+    '#f59e0b', // amber
+    '#10b981', // emerald
+    '#14b8a6', // teal
+    '#3b82f6', // blue
+    '#8b5cf6', // violet
+    '#ec4899', // pink
+];
+/**
+ * Relative-luminance contrast pick: returns a near-black or near-white that reads
+ * against `hex`, so a solid swatch of ANY chosen color keeps a legible glyph.
+ */
+export const readableTextOn = (hex) => {
+    const m = /^#?([0-9a-f]{6})$/i.exec(hex.trim());
+    if (!m)
+        return '#ffffff';
+    const n = Number.parseInt(m[1], 16);
+    const [r, g, b] = [(n >> 16) & 255, (n >> 8) & 255, n & 255].map((c) => {
+        const s = c / 255;
+        return s <= 0.03928 ? s / 12.92 : ((s + 0.055) / 1.055) ** 2.4;
+    });
+    const luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b;
+    return luminance > 0.5 ? '#111827' : '#ffffff';
+};
+//# sourceMappingURL=colors.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../../../src/react/nav/colors.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8EAA8E;AAC9E,gFAAgF;AAEhF,yEAAyE;AACzE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,UAAU;IACrB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,OAAO;IAClB,SAAS,EAAE,SAAS;IACpB,SAAS,EAAE,OAAO;CACV,CAAC;AAEX;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,GAAW,EAAU,EAAE;IACpD,MAAM,CAAC,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IACzB,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACpC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACrE,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;QAClB,OAAO,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,GAAG,KAAK,CAAC,IAAI,GAAG,CAAC;IACjE,CAAC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IACvD,OAAO,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACjD,CAAC,CAAC"}

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

@@ -0,0 +1,15 @@
+import type { NavSearchItem } from './types';
+/** A group of search results — `groupLabel` is the owning hub (omit = top-level). */
+export interface NavSearchGroup {
+    groupLabel?: string;
+    items: NavSearchItem[];
+}
+/**
+ * Filter + rank + group a search catalogue by `query`. Case-insensitive; matches
+ * the label, the owning-hub label, and keywords. Items are ordered by match
+ * quality (then catalogue order); groups are ordered top-level first, then hubs in
+ * the order they first appear in the catalogue. An empty query returns `[]`.
+ * Pure + testable — the one genuinely new bit of logic in the nav toolkit.
+ */
+export declare const filterNavSearch: (items: NavSearchItem[], query: string) => NavSearchGroup[];
+//# sourceMappingURL=filterNavSearch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filterNavSearch.d.ts","sourceRoot":"","sources":["../../../src/react/nav/filterNavSearch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,qFAAqF;AACrF,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAqBD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,aAAa,EAAE,EAAE,OAAO,MAAM,KAAG,cAAc,EAkCrF,CAAC"}

package/dist/react/nav/filterNavSearch.js

@@ -0,0 +1,65 @@
+const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+/**
+ * Match quality (lower is better), or `null` for no match:
+ * 0 label starts with the query · 1 query at a word boundary in the label ·
+ * 2 substring in the label · 3 only matches the hub label or a keyword.
+ */
+const scoreMatch = (item, q) => {
+    const label = item.label.toLowerCase();
+    if (label.startsWith(q))
+        return 0;
+    if (new RegExp(`\\b${escapeRegExp(q)}`).test(label))
+        return 1;
+    if (label.includes(q))
+        return 2;
+    const extra = [item.groupLabel, ...(item.keywords ?? [])]
+        .filter((s) => Boolean(s))
+        .map((s) => s.toLowerCase());
+    if (extra.some((h) => h.includes(q)))
+        return 3;
+    return null;
+};
+/**
+ * Filter + rank + group a search catalogue by `query`. Case-insensitive; matches
+ * the label, the owning-hub label, and keywords. Items are ordered by match
+ * quality (then catalogue order); groups are ordered top-level first, then hubs in
+ * the order they first appear in the catalogue. An empty query returns `[]`.
+ * Pure + testable — the one genuinely new bit of logic in the nav toolkit.
+ */
+export const filterNavSearch = (items, query) => {
+    const q = query.trim().toLowerCase();
+    if (!q)
+        return [];
+    const matched = [];
+    items.forEach((item, i) => {
+        const score = scoreMatch(item, q);
+        if (score !== null)
+            matched.push({ item, i, score });
+    });
+    // Remember each group's first catalogue appearance for stable group ordering.
+    const firstSeen = new Map();
+    for (const { item, i } of matched) {
+        if (!firstSeen.has(item.groupLabel))
+            firstSeen.set(item.groupLabel, i);
+    }
+    // Bucket items (already in best-match order) by group.
+    const buckets = new Map();
+    for (const { item } of [...matched].sort((a, b) => a.score - b.score || a.i - b.i)) {
+        const bucket = buckets.get(item.groupLabel);
+        if (bucket)
+            bucket.push(item);
+        else
+            buckets.set(item.groupLabel, [item]);
+    }
+    // Order hubs by first appearance; the top-level (undefined) group always leads.
+    // (Don't sort `undefined` as an array element — Array.sort hoists it to the end
+    // without consulting the comparator.)
+    const hubKeys = [...buckets.keys()]
+        .filter((k) => k !== undefined)
+        .sort((a, b) => (firstSeen.get(a) ?? 0) - (firstSeen.get(b) ?? 0));
+    const orderedKeys = buckets.has(undefined)
+        ? [undefined, ...hubKeys]
+        : hubKeys;
+    return orderedKeys.map((groupLabel) => ({ groupLabel, items: buckets.get(groupLabel) ?? [] }));
+};
+//# sourceMappingURL=filterNavSearch.js.map

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

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

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

@@ -0,0 +1,15 @@
+export * from '../../core/navigation';
+export { Breadcrumbs, type BreadcrumbsProps, ItemBreadcrumbs, type ItemBreadcrumbsProps, } from './Breadcrumbs';
+export { ColorSwatchGrid, type ColorSwatchGridProps } from './ColorSwatchGrid';
+export { CommandBar, type CommandBarProps } from './CommandBar';
+export { NAV_COLORS, readableTextOn } from './colors';
+export { HeaderSearch, type HeaderSearchProps } from './HeaderSearch';
+export { HubTileGrid, type HubTileGridProps } from './HubTileGrid';
+export { NavColorPicker, type NavColorPickerProps } from './NavColorPicker';
+export { NavItemMenu, type NavItemMenuProps } from './NavItemMenu';
+export { filterNavSearch, type NavSearchItem, type NavSearchItemGroup, } from './navSearch';
+export { type IconResolver, isPathWithin, NavLink, type NavLinkProps, type NavNavigationProps, } from './navShared';
+export { PlaceBar, type PlaceBarProps } from './PlaceBar';
+export { type SearchResultGroup, type SearchResultRow, SearchResults, type SearchResultsProps, searchOptionId, } from './SearchResults';
+export { SideNav, type SideNavProps } from './SideNav';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/react/nav/index.ts"],"names":[],"mappings":"AAQA,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,WAAW,EACX,KAAK,gBAAgB,EACrB,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAAE,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,KAAK,eAAe,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,YAAY,EACjB,YAAY,EACZ,OAAO,EACP,KAAK,YAAY,EACjB,KAAK,kBAAkB,GACxB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,aAAa,EACb,KAAK,kBAAkB,EACvB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC"}

package/dist/react/nav/index.js

@@ -0,0 +1,22 @@
+// cursedbelt/react nav toolkit — the from-scratch navigation components that all
+// derive from the single `cursedbelt/nav` registry (the IA tree): the side-nav rail,
+// hub-tile grid, breadcrumbs, color picker, and universal search. Authoring a feature
+// into the model is the only way to surface it (the coverage test enforces it), so
+// the historical four-list drift is designed out. For convenience this barrel also
+// re-exports the React-free contract + selectors so an app can import the whole nav
+// surface from `cursedbelt/react`; the contract alone lives at `cursedbelt/nav`.
+export * from '../../core/navigation';
+export { Breadcrumbs, ItemBreadcrumbs, } from './Breadcrumbs';
+export { ColorSwatchGrid } from './ColorSwatchGrid';
+export { CommandBar } from './CommandBar';
+export { NAV_COLORS, readableTextOn } from './colors';
+export { HeaderSearch } from './HeaderSearch';
+export { HubTileGrid } from './HubTileGrid';
+export { NavColorPicker } from './NavColorPicker';
+export { NavItemMenu } from './NavItemMenu';
+export { filterNavSearch, } from './navSearch';
+export { isPathWithin, NavLink, } from './navShared';
+export { PlaceBar } from './PlaceBar';
+export { SearchResults, searchOptionId, } from './SearchResults';
+export { SideNav } from './SideNav';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/react/nav/index.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qFAAqF;AACrF,sFAAsF;AACtF,mFAAmF;AACnF,mFAAmF;AACnF,oFAAoF;AACpF,iFAAiF;AAEjF,cAAc,uBAAuB,CAAC;AACtC,OAAO,EACL,WAAW,EAEX,eAAe,GAEhB,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,eAAe,EAA6B,MAAM,mBAAmB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAwB,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,EAAE,YAAY,EAA0B,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,cAAc,EAA4B,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AACnE,OAAO,EACL,eAAe,GAGhB,MAAM,aAAa,CAAC;AACrB,OAAO,EAEL,YAAY,EACZ,OAAO,GAGR,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAsB,MAAM,YAAY,CAAC;AAC1D,OAAO,EAGL,aAAa,EAEb,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,OAAO,EAAqB,MAAM,WAAW,CAAC"}