cursedbelt 0.0.0

package/dist/core/navigation/migrateNavPreferences.js

@@ -0,0 +1,64 @@
+// One-time, idempotent preference migration. The IA overhaul re-groups the old
+// 8-hub layout into 6 domains; this remaps the user's saved nav/hub customizations
+// (order, hidden, per-row colors) onto the new ids so nothing resets. The *mapping*
+// (old key → new domain id) is app-supplied data (only the app knows its old hubs);
+// the runner is the framework's. Idempotent via a version stamp — it runs on every
+// cold load but no-ops once `version` is current, so colors/hidden the user set
+// AFTER migrating are never clobbered.
+/** Bump when the migration logic or the prefs shape changes. */
+export const CURRENT_NAV_PREFS_VERSION = 1;
+const uniq = (xs) => [...new Set(xs)];
+/** Merge two tile-pref blocks (union hidden, concat+dedupe order, later colors win). */
+function mergeTilePrefs(a, b) {
+    return {
+        order: uniq([...(a?.order ?? []), ...(b.order ?? [])]),
+        hidden: uniq([...(a?.hidden ?? []), ...(b.hidden ?? [])]),
+        colors: { ...(a?.colors ?? {}), ...(b.colors ?? {}) },
+    };
+}
+/**
+ * Migrate legacy nav prefs onto the new model. Idempotent: returns `old` untouched
+ * when it's already at {@link CURRENT_NAV_PREFS_VERSION}. Otherwise remaps via
+ * `options.keyMap`, drops domain-level keys whose target isn't a real domain in
+ * `model`, merges consolidated hubs, and stamps the version.
+ */
+export function migrateNavPreferences(old, model, options = {}) {
+    // Already migrated → no-op (don't reset user choices made post-migration).
+    if (old && typeof old.version === 'number' && old.version >= CURRENT_NAV_PREFS_VERSION) {
+        return old;
+    }
+    const keyMap = options.keyMap ?? {};
+    const remap = (k) => keyMap[k] ?? k;
+    const domainIds = new Set((model?.domains ?? []).map((d) => d.id));
+    const legacy = (old ?? {});
+    // Domain order: remap each old route id → domain id, dedupe, keep only real domains.
+    const order = uniq((legacy.nav?.order ?? []).map(remap)).filter((id) => domainIds.has(id));
+    // Hidden domains: remap, dedupe, keep only real domains.
+    const hidden = uniq((legacy.hiddenNavRoutes ?? []).map(remap)).filter((id) => domainIds.has(id));
+    // Domain colors: remap keys, keep only real domains (last write wins on collision).
+    const colors = {};
+    for (const [k, v] of Object.entries(legacy.nav?.colors ?? {})) {
+        const id = remap(k);
+        if (domainIds.has(id))
+            colors[id] = v;
+    }
+    // Hub tile prefs: remap hub key → domain id, merging when two hubs consolidate.
+    const hubs = {};
+    for (const [oldHub, prefs] of Object.entries(legacy.hubs ?? {})) {
+        const id = remap(oldHub);
+        if (!domainIds.has(id))
+            continue; // a hub with no surviving domain home is dropped
+        hubs[id] = mergeTilePrefs(hubs[id], prefs);
+    }
+    const result = { version: CURRENT_NAV_PREFS_VERSION };
+    if (order.length)
+        result.order = order;
+    if (hidden.length)
+        result.hidden = hidden;
+    if (Object.keys(colors).length)
+        result.colors = colors;
+    if (Object.keys(hubs).length)
+        result.hubs = hubs;
+    return result;
+}
+//# sourceMappingURL=migrateNavPreferences.js.map

package/dist/core/navigation/migrateNavPreferences.js.map

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

package/dist/core/navigation/navigationModel.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Visibility / eligibility gate carried by a domain or item. The model only stores
+ * the *flags*; the consuming app injects a {@link GateFn} that decides what they
+ * mean (is the user authed, do they hold the role, is the GET-only "ctgr" mode on).
+ * Gates are inherited: an item inside a gated-out domain never surfaces.
+ */
+export interface NavGate {
+    /** Only visible when signed in. */
+    requiresAuth?: boolean;
+    /** Only visible when signed out (public/marketing routes). */
+    requiresNoAuth?: boolean;
+    /** Visible only to users holding ONE of these roles (e.g. `['admin','owner']`). */
+    requiredRoles?: string[];
+    /** Hidden while the GET-only ("ctgr") session mode is active (write-heavy tools). */
+    hiddenInCtgr?: boolean;
+}
+/**
+ * A navigable leaf. `path` references a route (a `routeMeta` path in ca); use a
+ * `#tab=…` suffix for an in-page tab target (`/tools#tab=curl`) — the selectors
+ * strip the hash for route matching but keep it for navigation.
+ */
+export interface NavItem {
+    /** Stable unique key — the React key AND the key prefs (order/hide/color) store by. */
+    id: string;
+    /** Route destination. `#tab=…` addresses an in-page tab. */
+    path: string;
+    /** Display label (side nav row, hub tile title, breadcrumb leaf, search hit). */
+    label: string;
+    /** Icon *name* from the app's icon set (resolved to a node by the React layer). */
+    icon?: string;
+    /** Short description — hub-tile subtitle + search snippet. */
+    description?: string;
+    /** Auth / role / ctgr gate (see {@link NavGate}). */
+    gate?: NavGate;
+    /**
+     * Registered for coverage + deep-link reachability, but **never surfaced** in the
+     * side nav, hub tiles, search, or palette. For routes reachable only by a shared
+     * link, a notification, or a WS invite (Shared Space, `/watch/:type/:id`, auth
+     * routes, `/set-initial-password`, admin deep-links). Use deliberately — it is not
+     * a way to dodge the coverage test for a real, discoverable feature.
+     */
+    deepLinkOnly?: true;
+    /** Extra match terms for search / palette (synonyms, old names, abbreviations). */
+    keywords?: string[];
+}
+/** A labeled cluster of items inside a domain (a sub-section of a hub landing). */
+export interface NavGroup {
+    /** Stable unique key (within the model). */
+    id: string;
+    /** Section heading shown on the hub landing; omit-able visually when there's one. */
+    label: string;
+    items: NavItem[];
+}
+/**
+ * A top-level **place** — the browsable backbone (the UX north-star's small fixed
+ * place-set: Today / Library / People / Calendar / Play + a role-gated Operate; see
+ * `react/components/SHELL.md`). It is itself navigable (its `path` is the place
+ * landing) and owns the groups of items shown there. The shell renders these as the
+ * slim desktop place rail (`SideNav`) and the mobile capture-forward `PlaceBar`.
+ */
+export interface NavDomain {
+    /** Stable unique key — prefs (order/hide/color) for the side-nav rail store by it. */
+    id: string;
+    /** Display label (side-nav row + hub landing title + breadcrumb root). */
+    label: string;
+    /** Icon *name* (required — domains always show an icon in the rail). */
+    icon: string;
+    /** The hub landing page path. */
+    path: string;
+    /** Domain-wide gate — inherited by every group/item under it. */
+    gate?: NavGate;
+    groups: NavGroup[];
+}
+/**
+ * The complete IA tree. `domains` are the browsable backbone; `ungrouped` items are
+ * registered + searchable (and reachable by palette) but live under no domain hub —
+ * use it for cross-cutting destinations (Settings, Profile) or for `deepLinkOnly`
+ * routes that need coverage without a hub home.
+ */
+export interface NavigationModel {
+    domains: NavDomain[];
+    ungrouped?: NavItem[];
+}
+/**
+ * Injected by the app: decides whether a gated node is visible *right now* (auth
+ * state, the user's roles, the ctgr GET-only mode). Pure — the selectors call it for
+ * every domain/item, so it must be cheap and side-effect-free. An undefined gate
+ * (no restrictions) is always visible.
+ */
+export type GateFn = (gate?: NavGate) => boolean;
+/** The trivial gate — everything is visible. Default for selectors + unguarded apps. */
+export declare const allowAllGate: GateFn;
+//# sourceMappingURL=navigationModel.d.ts.map

package/dist/core/navigation/navigationModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationModel.d.ts","sourceRoot":"","sources":["../../../src/core/navigation/navigationModel.ts"],"names":[],"mappings":"AAaA;;;;;GAKG;AACH,MAAM,WAAW,OAAO;IACtB,mCAAmC;IACnC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,mFAAmF;IACnF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,qFAAqF;IACrF,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,OAAO;IACtB,uFAAuF;IACvF,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;;;;;OAMG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,mFAAmF;AACnF,MAAM,WAAW,QAAQ;IACvB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX,qFAAqF;IACrF,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB,sFAAsF;IACtF,EAAE,EAAE,MAAM,CAAC;IACX,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC;AAEjD,wFAAwF;AACxF,eAAO,MAAM,YAAY,EAAE,MAAmB,CAAC"}

package/dist/core/navigation/navigationModel.js

@@ -0,0 +1,15 @@
+// The single navigation source of truth — a declarative Information-Architecture
+// tree (Domain → Group → Item) every nav surface derives from: the side nav, hub
+// landing tiles, breadcrumbs, the universal-search catalogue, and the command
+// palette. Authoring a feature into the model is the *only* way to surface it, so
+// the historical "four hand-maintained lists drift out of sync → features get
+// buried" bug is structurally impossible (the coverage test enforces it in CI).
+//
+// This module is **React-free and routing-free** (it ships from `cursedbelt/nav`):
+// items carry icon *names* (strings) and *paths* (strings), never components or
+// `<Link>`s, so the same model is consumed by client components, server tests, and
+// the coverage test alike. The React layer (`cursedbelt/react`) resolves icon names
+// to nodes and paths to navigation.
+/** The trivial gate — everything is visible. Default for selectors + unguarded apps. */
+export const allowAllGate = () => true;
+//# sourceMappingURL=navigationModel.js.map

package/dist/core/navigation/navigationModel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationModel.js","sourceRoot":"","sources":["../../../src/core/navigation/navigationModel.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,iFAAiF;AACjF,8EAA8E;AAC9E,kFAAkF;AAClF,8EAA8E;AAC9E,gFAAgF;AAChF,EAAE;AACF,mFAAmF;AACnF,gFAAgF;AAChF,mFAAmF;AACnF,oFAAoF;AACpF,oCAAoC;AAkGpC,wFAAwF;AACxF,MAAM,CAAC,MAAM,YAAY,GAAW,GAAG,EAAE,CAAC,IAAI,CAAC"}

package/dist/core/navigation/navigationSelectors.d.ts

@@ -0,0 +1,64 @@
+import { type GateFn, type NavDomain, type NavGroup, type NavItem, type NavigationModel } from './navigationModel';
+/**
+ * Normalize a path for route *matching* — drop the query string, the hash (the
+ * `#tab=…` in-page target), and a trailing slash. `'/'` stays `'/'`. Used so a tab
+ * variant (`/tools#tab=curl`) matches the base route (`/tools`) and `/lists/`
+ * matches `/lists`.
+ */
+export declare function normalizeNavPath(path: string): string;
+/** A flattened, gated catalogue entry — a leaf plus where it lives (for grouping). */
+export interface SearchCatalogueEntry extends NavItem {
+    /** Owning domain id (absent for ungrouped items). */
+    domainId?: string;
+    /** Owning domain label — groups search results + is itself matched. */
+    domainLabel?: string;
+    /** Owning group id (absent for domain landings + ungrouped items). */
+    groupId?: string;
+    /** Owning group label. */
+    groupLabel?: string;
+}
+/** One link in a breadcrumb trail — a coerced domain or item (always navigable). */
+export interface NavCrumb {
+    id: string;
+    label: string;
+    path: string;
+    icon?: string;
+}
+/** The ordered domains visible under `gate` — the side-nav rail backbone. */
+export declare function deriveSideNavDomains(model: NavigationModel, gate?: GateFn): NavDomain[];
+/**
+ * Every visible (gated, non-`deepLinkOnly`) item of `domain`, flattened across its
+ * groups — for a simple HubTileGrid. Returns `[]` if the domain itself is gated out.
+ */
+export declare function deriveDomainItems(domain: NavDomain, gate?: GateFn): NavItem[];
+/**
+ * The visible groups of `domain` (each with its visible items; empty groups
+ * dropped) — for a *grouped* hub landing that shows section headings. Returns `[]`
+ * if the domain is gated out.
+ */
+export declare function deriveDomainGroups(domain: NavDomain, gate?: GateFn): NavGroup[];
+/** Look up a domain by id (gated). */
+export declare function deriveDomain(model: NavigationModel, domainId: string, gate?: GateFn): NavDomain | undefined;
+/**
+ * The ancestor chain for `path` — for Breadcrumbs. A domain landing yields
+ * `[domain]`; an item yields `[domain, item]`; an ungrouped item yields `[item]`.
+ * Matches the raw path first (so a `#tab=…` variant resolves to its own leaf), then
+ * falls back to the normalized base path. Returns `[]` when nothing matches.
+ */
+export declare function deriveBreadcrumbTrail(model: NavigationModel, path: string, gate?: GateFn): NavCrumb[];
+/**
+ * The flat list of searchable destinations — every visible (gated,
+ * non-`deepLinkOnly`) domain landing + item, each tagged with its domain/group so
+ * results can be grouped. Drives HeaderSearch's instant pages layer *and* the
+ * command palette; replaces every hand-listed search catalogue (so a feature is
+ * findable the moment it's registered).
+ */
+export declare function deriveSearchCatalogue(model: NavigationModel, gate?: GateFn): SearchCatalogueEntry[];
+/**
+ * Every path registered in the model (domain landings + all items + ungrouped),
+ * INCLUDING `deepLinkOnly` items — that's the point: a `deepLinkOnly` route is still
+ * "registered", so it satisfies coverage. De-duplicated. Consumed by the coverage
+ * test ({@link createCoverageTest}).
+ */
+export declare function deriveAllPaths(model: NavigationModel): string[];
+//# sourceMappingURL=navigationSelectors.d.ts.map

package/dist/core/navigation/navigationSelectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationSelectors.d.ts","sourceRoot":"","sources":["../../../src/core/navigation/navigationSelectors.ts"],"names":[],"mappings":"AAMA,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,OAAO,EACZ,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOrD;AAED,sFAAsF;AACtF,MAAM,WAAW,oBAAqB,SAAQ,OAAO;IACnD,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uEAAuE;IACvE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,oFAAoF;AACpF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAeD,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,MAAqB,GAC1B,SAAS,EAAE,CAEb;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqB,GAAG,OAAO,EAAE,CAG3F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,GAAE,MAAqB,GAAG,QAAQ,EAAE,CAK7F;AAED,sCAAsC;AACtC,wBAAgB,YAAY,CAC1B,KAAK,EAAE,eAAe,EACtB,QAAQ,EAAE,MAAM,EAChB,IAAI,GAAE,MAAqB,GAC1B,SAAS,GAAG,SAAS,CAGvB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAqB,GAC1B,QAAQ,EAAE,CA8BZ;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,IAAI,GAAE,MAAqB,GAC1B,oBAAoB,EAAE,CA8BxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,EAAE,CAQ/D"}

package/dist/core/navigation/navigationSelectors.js

@@ -0,0 +1,163 @@
+// Pure derivations off the {@link NavigationModel}. Every nav surface (side nav,
+// hub tiles, breadcrumbs, search catalogue, palette, the coverage test) reads the
+// model exclusively through these — there is no second list to keep in sync. They
+// import nothing from React, so they run identically in the client, in a server
+// test, and in the CI coverage check.
+import { allowAllGate, } from './navigationModel';
+/**
+ * Normalize a path for route *matching* — drop the query string, the hash (the
+ * `#tab=…` in-page target), and a trailing slash. `'/'` stays `'/'`. Used so a tab
+ * variant (`/tools#tab=curl`) matches the base route (`/tools`) and `/lists/`
+ * matches `/lists`.
+ */
+export function normalizeNavPath(path) {
+    // Null-safe: a nav selector must never throw (a breadcrumb derivation crashing
+    // white-screens the whole page). Coerce a missing/non-string path to ''.
+    const s = typeof path === 'string' ? path : '';
+    let p = (s.split('#')[0] ?? '').split('?')[0]?.trim() ?? '';
+    if (p.length > 1 && p.endsWith('/'))
+        p = p.slice(0, -1);
+    return p || '/';
+}
+const domainCrumb = (d) => ({
+    id: d.id,
+    label: d.label,
+    path: d.path,
+    icon: d.icon,
+});
+const itemCrumb = (it) => ({
+    id: it.id,
+    label: it.label,
+    path: it.path,
+    icon: it.icon,
+});
+/** The ordered domains visible under `gate` — the side-nav rail backbone. */
+export function deriveSideNavDomains(model, gate = allowAllGate) {
+    return (model?.domains ?? []).filter((d) => gate(d.gate));
+}
+/**
+ * Every visible (gated, non-`deepLinkOnly`) item of `domain`, flattened across its
+ * groups — for a simple HubTileGrid. Returns `[]` if the domain itself is gated out.
+ */
+export function deriveDomainItems(domain, gate = allowAllGate) {
+    if (!gate(domain.gate))
+        return [];
+    return domain.groups.flatMap((g) => g.items).filter((it) => !it.deepLinkOnly && gate(it.gate));
+}
+/**
+ * The visible groups of `domain` (each with its visible items; empty groups
+ * dropped) — for a *grouped* hub landing that shows section headings. Returns `[]`
+ * if the domain is gated out.
+ */
+export function deriveDomainGroups(domain, gate = allowAllGate) {
+    if (!gate(domain.gate))
+        return [];
+    return domain.groups
+        .map((g) => ({ ...g, items: g.items.filter((it) => !it.deepLinkOnly && gate(it.gate)) }))
+        .filter((g) => g.items.length > 0);
+}
+/** Look up a domain by id (gated). */
+export function deriveDomain(model, domainId, gate = allowAllGate) {
+    const d = (model?.domains ?? []).find((x) => x.id === domainId);
+    return d && gate(d.gate) ? d : undefined;
+}
+/**
+ * The ancestor chain for `path` — for Breadcrumbs. A domain landing yields
+ * `[domain]`; an item yields `[domain, item]`; an ungrouped item yields `[item]`.
+ * Matches the raw path first (so a `#tab=…` variant resolves to its own leaf), then
+ * falls back to the normalized base path. Returns `[]` when nothing matches.
+ */
+export function deriveBreadcrumbTrail(model, path, gate = allowAllGate) {
+    // Null-safe (see normalizeNavPath): a consumer that hasn't wired the model/path yet
+    // must get an empty trail, never a crash — a breadcrumb derivation throwing
+    // white-screens the whole page. Degrade gracefully on a missing model or path.
+    if (!model || !Array.isArray(model?.domains ?? []))
+        return [];
+    const safe = typeof path === 'string' ? path : '';
+    const raw = safe.trim();
+    const target = normalizeNavPath(safe);
+    // Two passes so an EXACT path wins over a merely-normalized one: `/tools#tab=curl`
+    // must resolve to the Curl tab leaf, not be shadowed by the `/tools` domain landing
+    // (which also normalizes to `/tools`). Within a pass, the domain landing is checked
+    // before its items so the bare `/tools` route yields `[Tools]`, not a tab leaf.
+    const find = (match) => {
+        for (const domain of model?.domains ?? []) {
+            if (!gate(domain.gate))
+                continue;
+            if (match(domain.path))
+                return [domainCrumb(domain)];
+            for (const group of domain.groups) {
+                for (const item of group.items) {
+                    if (gate(item.gate) && match(item.path))
+                        return [domainCrumb(domain), itemCrumb(item)];
+                }
+            }
+        }
+        for (const item of model.ungrouped ?? []) {
+            if (gate(item.gate) && match(item.path))
+                return [itemCrumb(item)];
+        }
+        return null;
+    };
+    return find((p) => p === raw) ?? find((p) => normalizeNavPath(p) === target) ?? [];
+}
+/**
+ * The flat list of searchable destinations — every visible (gated,
+ * non-`deepLinkOnly`) domain landing + item, each tagged with its domain/group so
+ * results can be grouped. Drives HeaderSearch's instant pages layer *and* the
+ * command palette; replaces every hand-listed search catalogue (so a feature is
+ * findable the moment it's registered).
+ */
+export function deriveSearchCatalogue(model, gate = allowAllGate) {
+    const out = [];
+    for (const domain of model?.domains ?? []) {
+        if (!gate(domain.gate))
+            continue;
+        out.push({
+            id: domain.id,
+            path: domain.path,
+            label: domain.label,
+            icon: domain.icon,
+            domainId: domain.id,
+            domainLabel: domain.label,
+        });
+        for (const group of domain.groups) {
+            for (const item of group.items) {
+                if (item.deepLinkOnly || !gate(item.gate))
+                    continue;
+                out.push({
+                    ...item,
+                    domainId: domain.id,
+                    domainLabel: domain.label,
+                    groupId: group.id,
+                    groupLabel: group.label,
+                });
+            }
+        }
+    }
+    for (const item of model.ungrouped ?? []) {
+        if (item.deepLinkOnly || !gate(item.gate))
+            continue;
+        out.push({ ...item });
+    }
+    return out;
+}
+/**
+ * Every path registered in the model (domain landings + all items + ungrouped),
+ * INCLUDING `deepLinkOnly` items — that's the point: a `deepLinkOnly` route is still
+ * "registered", so it satisfies coverage. De-duplicated. Consumed by the coverage
+ * test ({@link createCoverageTest}).
+ */
+export function deriveAllPaths(model) {
+    const paths = new Set();
+    for (const domain of model?.domains ?? []) {
+        paths.add(domain.path);
+        for (const group of domain.groups)
+            for (const item of group.items)
+                paths.add(item.path);
+    }
+    for (const item of model.ungrouped ?? [])
+        paths.add(item.path);
+    return [...paths];
+}
+//# sourceMappingURL=navigationSelectors.js.map

package/dist/core/navigation/navigationSelectors.js.map

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

package/dist/core/navigation/searchCatalogue.d.ts

@@ -0,0 +1,24 @@
+import type { SearchCatalogueEntry } from './navigationSelectors';
+/** A query hit with its computed relevance score (higher = better). */
+export interface CatalogueHit extends SearchCatalogueEntry {
+    score: number;
+}
+/** Hits bucketed under a domain (or under "" for ungrouped), preserving rank order. */
+export interface CatalogueResultGroup {
+    /** Domain id, or `''` for ungrouped destinations. */
+    key: string;
+    /** Domain label, or `'Pages'` for ungrouped. */
+    label: string;
+    items: CatalogueHit[];
+}
+/**
+ * Filter + rank a catalogue by `query`. Empty/blank query → `[]` (the instant layer
+ * shows nothing until the user types). Stable: equal scores keep catalogue order.
+ */
+export declare function rankCatalogue(catalogue: SearchCatalogueEntry[], query: string): CatalogueHit[];
+/**
+ * Rank + bucket hits by owning domain (ungrouped under a "Pages" group), capping the
+ * total to `limit`. Groups appear in first-hit order; within a group, by rank.
+ */
+export declare function groupCatalogueHits(catalogue: SearchCatalogueEntry[], query: string, limit?: number): CatalogueResultGroup[];
+//# sourceMappingURL=searchCatalogue.d.ts.map

package/dist/core/navigation/searchCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchCatalogue.d.ts","sourceRoot":"","sources":["../../../src/core/navigation/searchCatalogue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElE,uEAAuE;AACvE,MAAM,WAAW,YAAa,SAAQ,oBAAoB;IACxD,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uFAAuF;AACvF,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AA8BD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,oBAAoB,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE,CAW9F;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,oBAAoB,EAAE,EACjC,KAAK,EAAE,MAAM,EACb,KAAK,SAAK,GACT,oBAAoB,EAAE,CAaxB"}

package/dist/core/navigation/searchCatalogue.js

@@ -0,0 +1,77 @@
+// Pure matcher + grouper for the instant client-side "pages" search layer. Ranks a
+// derived catalogue ({@link deriveSearchCatalogue}) against a query and buckets the
+// hits by their owning domain. Kept pure + framework-free so it's unit-testable and
+// shared by HeaderSearch and (task 14) the command palette. The palette upgrades the
+// *ranking* to uFuzzy; this is the dependency-free baseline both can fall back to.
+const norm = (s) => s.toLowerCase().trim();
+/**
+ * Score one entry against a normalized query. Returns `0` for no match. Ranking
+ * favours, in order: exact label, label prefix, label word-boundary, label
+ * substring, then keyword / group / domain / path / description hits — so "env"
+ * surfaces "Env Sets" above a page that merely mentions environments.
+ */
+function scoreEntry(entry, q) {
+    const label = norm(entry.label);
+    if (label === q)
+        return 100;
+    if (label.startsWith(q))
+        return 80;
+    // word-boundary: a query that starts any word in the label ("col" → "Format **Col**…")
+    if (label.split(/[\s/&·-]+/).some((w) => w.startsWith(q)))
+        return 65;
+    if (label.includes(q))
+        return 50;
+    for (const kw of entry.keywords ?? []) {
+        const k = norm(kw);
+        if (k === q || k.startsWith(q))
+            return 45;
+        if (k.includes(q))
+            return 35;
+    }
+    if (entry.groupLabel && norm(entry.groupLabel).includes(q))
+        return 25;
+    if (entry.domainLabel && norm(entry.domainLabel).includes(q))
+        return 20;
+    if (norm(entry.path).includes(q))
+        return 15;
+    if (entry.description && norm(entry.description).includes(q))
+        return 10;
+    return 0;
+}
+/**
+ * Filter + rank a catalogue by `query`. Empty/blank query → `[]` (the instant layer
+ * shows nothing until the user types). Stable: equal scores keep catalogue order.
+ */
+export function rankCatalogue(catalogue, query) {
+    const q = norm(query);
+    if (!q)
+        return [];
+    const scored = [];
+    for (const entry of catalogue) {
+        const score = scoreEntry(entry, q);
+        if (score > 0)
+            scored.push({ ...entry, score });
+    }
+    // Stable sort by score desc — Array.prototype.sort is stable in modern engines, so
+    // equal scores retain catalogue (authoring) order.
+    return scored.sort((a, b) => b.score - a.score);
+}
+/**
+ * Rank + bucket hits by owning domain (ungrouped under a "Pages" group), capping the
+ * total to `limit`. Groups appear in first-hit order; within a group, by rank.
+ */
+export function groupCatalogueHits(catalogue, query, limit = 20) {
+    const hits = rankCatalogue(catalogue, query).slice(0, limit);
+    const groups = new Map();
+    for (const hit of hits) {
+        const key = hit.domainId ?? '';
+        let bucket = groups.get(key);
+        if (!bucket) {
+            bucket = { key, label: hit.domainLabel ?? 'Pages', items: [] };
+            groups.set(key, bucket);
+        }
+        bucket.items.push(hit);
+    }
+    return [...groups.values()];
+}
+//# sourceMappingURL=searchCatalogue.js.map

package/dist/core/navigation/searchCatalogue.js.map

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

package/dist/core/palette/ShortcutRegistry.d.ts

@@ -0,0 +1,34 @@
+/** A registered keyboard shortcut — its binding plus how it reads in the palette. */
+export interface ShortcutEntry {
+    /** Short name of the thing it acts on (e.g. `'Board'`). */
+    label: string;
+    /** Binding in tinykeys format (`'$mod+k'`, `'alt+b'`) — also the registry key. */
+    keys: string;
+    /** What the shortcut does, shown as the palette row's description (e.g. `'Open the board'`). */
+    action: string;
+}
+type Listener = () => void;
+/**
+ * Keyed by `keys`, so registering the same binding twice replaces it (last write wins
+ * — no duplicate rows) and a feature can re-register on every mount idempotently.
+ */
+export declare class ShortcutRegistry {
+    private entries;
+    private listeners;
+    private snapshot;
+    /** Add or replace the shortcut for `entry.keys`. */
+    register(entry: ShortcutEntry): void;
+    /** Remove the shortcut bound to `keys` (no-op if absent). */
+    unregister(keys: string): void;
+    /** Every registered shortcut, in insertion order. Stable until the next mutation. */
+    getAll(): ShortcutEntry[];
+    /** Subscribe to registry changes (returns an unsubscribe). Powers the live palette list. */
+    subscribe(listener: Listener): () => void;
+    /** Drop every shortcut (mainly for tests / teardown). */
+    clear(): void;
+    private commit;
+}
+/** The app-wide shortcut registry singleton. */
+export declare const shortcutRegistry: ShortcutRegistry;
+export {};
+//# sourceMappingURL=ShortcutRegistry.d.ts.map

package/dist/core/palette/ShortcutRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutRegistry.d.ts","sourceRoot":"","sources":["../../../src/core/palette/ShortcutRegistry.ts"],"names":[],"mappings":"AASA,qFAAqF;AACrF,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,IAAI,EAAE,MAAM,CAAC;IACb,gGAAgG;IAChG,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAoC;IACnD,OAAO,CAAC,SAAS,CAAuB;IAGxC,OAAO,CAAC,QAAQ,CAAuB;IAEvC,oDAAoD;IACpD,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI;IAKpC,6DAA6D;IAC7D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,qFAAqF;IACrF,MAAM,IAAI,aAAa,EAAE;IAIzB,4FAA4F;IAC5F,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAKzC,yDAAyD;IACzD,KAAK,IAAI,IAAI;IAMb,OAAO,CAAC,MAAM;CAIf;AAED,gDAAgD;AAChD,eAAO,MAAM,gBAAgB,kBAAyB,CAAC"}

package/dist/core/palette/ShortcutRegistry.js

@@ -0,0 +1,53 @@
+// A tiny global registry of the app's keyboard shortcuts — the single source of truth
+// that BOTH the keybinding layer (`useHotkeys`) and the command palette read from. An
+// app registers a shortcut once; the palette can then list "Board → ⌥B" in its
+// cold-state reference without the binding and its documentation drifting apart.
+//
+// Register in a mount effect (never at module load) so the palette's list reflects the
+// shortcuts actually wired up for the current screen; the registry notifies subscribers
+// on every change so a mounted palette stays live as shortcuts come and go.
+/**
+ * Keyed by `keys`, so registering the same binding twice replaces it (last write wins
+ * — no duplicate rows) and a feature can re-register on every mount idempotently.
+ */
+export class ShortcutRegistry {
+    entries = new Map();
+    listeners = new Set();
+    // A frozen snapshot, rebuilt only on mutation, so `getAll()` is referentially stable
+    // between changes — required for `useSyncExternalStore` to not loop.
+    snapshot = [];
+    /** Add or replace the shortcut for `entry.keys`. */
+    register(entry) {
+        this.entries.set(entry.keys, entry);
+        this.commit();
+    }
+    /** Remove the shortcut bound to `keys` (no-op if absent). */
+    unregister(keys) {
+        if (this.entries.delete(keys))
+            this.commit();
+    }
+    /** Every registered shortcut, in insertion order. Stable until the next mutation. */
+    getAll() {
+        return this.snapshot;
+    }
+    /** Subscribe to registry changes (returns an unsubscribe). Powers the live palette list. */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /** Drop every shortcut (mainly for tests / teardown). */
+    clear() {
+        if (this.entries.size === 0)
+            return;
+        this.entries.clear();
+        this.commit();
+    }
+    commit() {
+        this.snapshot = [...this.entries.values()];
+        for (const listener of this.listeners)
+            listener();
+    }
+}
+/** The app-wide shortcut registry singleton. */
+export const shortcutRegistry = new ShortcutRegistry();
+//# sourceMappingURL=ShortcutRegistry.js.map