basalt-ui 1.18.0 → 1.19.0

package/AGENTS.md

@@ -15,7 +15,7 @@ Toolchain: Bun runtime, oxlint + oxfmt, conventional commits (empty scope), `mas
 | `basalt-ui/vite`            | mantine-coupled | basaltViteConfig(opts) — Vite preset for basalt-ui consumer apps; basaltAppPlugin(opts) — PWA head, manifest, and icon metadata derived from the token palette                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `basalt-ui/guard`           | headless        | checkSource, GUARD_RULES, Finding types — the headless theme-guard core                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
 | `basalt-ui/query`           | headless        | createBasaltQueryClient, transport-agnostic unwrap, lazy BasaltQueryDevtools                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
-| `basalt-ui/router-tanstack` | headless        | TanStack Router bridge: useBasaltNav (active route) + useRouterBreadcrumbs + createSearchParamStore (single-select URL-state store) + createMultiSearchParamStore (multi-select URL-state store)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+| `basalt-ui/router-tanstack` | headless        | TanStack Router bridge: defineNav/navGroup/navTarget (one typed nav definition) + useNav (sections + mobileNav, spread onto BasaltShell) + useBasaltNav (active route) + useRouterBreadcrumbs + createSearchParamStore (single-select URL-state store) + createMultiSearchParamStore (multi-select URL-state store)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
 | `basalt-ui/forms`           | mantine-coupled | Mantine form adapter: useBasaltForm, field, FormErrorSummary, useFormDraft (Standard Schema)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
 | `basalt-ui/notifications`   | mantine-coupled | Mantine notifications: notify helpers, typed registry, persisted history, NotificationBell, NotificationCenter                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
 | `basalt-ui/commands`        | mantine-coupled | typed command bus + overlay controller, toSpotlightActions, ShortcutsHelp, BasaltOverlays                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.19.0](https://github.com/jkrumm/basalt-ui/compare/v1.18.0...v1.19.0) (2026-08-20)
+
+
+### Features
+
+* make the mobile bar navigate, driven by one typed nav definition ([1ebba92](https://github.com/jkrumm/basalt-ui/commit/1ebba9267267ff26e988c876f17839b05d61689d))
+
 # [1.18.0](https://github.com/jkrumm/basalt-ui/compare/v1.17.0...v1.18.0) (2026-08-19)
 
 

package/agent/rules/basalt-mantine.md

@@ -60,8 +60,9 @@ Restraint is the #1 lever — neutrals carry the surface, the accent only points
   reads as a button sitting in the nav rather than as the current location. Inactive = muted text,
   faint icon, hover ink-6%; an active row hovers one step further to ink-13%. This is baked into
   the theme's NavLink defaults (`--nl-*` vars) and holds for _every_ render path, including a
-  consumer's router `<Link>` passed via `renderNavLink`. Child items indent with a 1px `divider`
-  left border; active child = accent text, weight 600.
+  consumer's router `<Link>` hosted through `SidebarItem.Anchor`. Child items indent with a 1px
+  `divider` left border; active child = accent text, weight 600. The MOBILE bar is the one
+  deliberate exception to the accent-icon half of this rule — see "Mobile bar" below.
 - **Buttons**: the primary action = filled accent (`variant="filled"`), **exactly one per view**.
   Every other/secondary action = `variant="default"` (neutral). Do **not** use a colored
   `variant="light"` for routine actions.
@@ -280,8 +281,8 @@ shadow-surfaces.test.ts` mechanically enumerates every site that applies either
 `BasaltShell` is the canonical single-mount. When a fully custom layout is needed, the shell
 sub-components are available individually from `basalt-ui`:
 
-- `AppSidebar` — desktop sidebar (sections, collapse, brand, footer/settings extras)
-- `MobileNav` — bottom-tab mobile nav
+- `AppSidebar` — desktop sidebar (sections, collapse, brand, settings/account extras)
+- `MobileNav` — the bottom tab bar (takes a `MobileNavModel` from `projectMobileNav`)
 - `AppBreadcrumbs` — breadcrumb bar (reads from `useRouterBreadcrumbs` or a manual trail)
 - `PageHeaderProvider` + `PageActions` + `PageActionsOutlet` — portal-based page action slots
 - `NavCountBadge` — count badge for sidebar nav items
@@ -294,13 +295,14 @@ import {
   PageHeaderProvider,
   PageActionsOutlet,
   NavCountBadge,
+  projectMobileNav,
 } from 'basalt-ui'
 
 function CustomShell({ children }: { children: React.ReactNode }) {
   return (
     <PageHeaderProvider>
-      <AppSidebar sections={sections} brand={brand} renderNavLink={renderNavLink} />
-      <MobileNav sections={mobileSections} renderNavLink={renderNavLink} />
+      <AppSidebar sections={sections} brand={brand} />
+      <MobileNav model={projectMobileNav(sections)} />
       <main>
         <AppBreadcrumbs />
         <PageActionsOutlet />
@@ -314,6 +316,69 @@ function CustomShell({ children }: { children: React.ReactNode }) {
 Prefer `BasaltShell` unless the layout genuinely diverges — it already composes all of the above
 with the correct wiring (collapse persistence, mobile breakpoint, breadcrumb integration).
 
+## Mobile bar
+
+The bottom bar is a **tab bar, not a menu**: a slot is a DESTINATION, so a tap navigates instantly
+with nothing to dismiss. There is no full-height mobile sidebar drawer — everything it used to hold
+(nav, account, settings, theme switcher) is reachable from the trailing More slot instead.
+
+`BasaltShell` builds the whole thing from the same `SidebarSection[]` the desktop sidebar renders:
+**`projectMobileNav`** projects those sections onto the bar and **`MobileNav`** paints the result.
+There is no second nav model to maintain, and in the common case no configuration at all.
+
+**Surface inference — the part you do not configure.** For any slot holding `n` rows:
+
+| `n`                     | surface                                                                   |
+| ----------------------- | ------------------------------------------------------------------------- |
+| 0                       | the slot is dropped                                                       |
+| 1                       | a plain navigation link — a group of one IS a destination                 |
+| ≤ `menuMax` (default 6) | a Mantine `Menu` that pops upward out of the tab, content-sized, no scrim |
+| > `menuMax`             | a bottom `Drawer` sheet with a grabber and an internal `ScrollArea`       |
+
+Six is arithmetic, not taste: 6 × 44px + 8px padding = 272px against 415px of headroom on the
+smallest supported viewport, which is why the menu is configured `flip: false` and can never render
+below the fold. Move a destination in or out of the More slot and the surface changes itself.
+
+**Placement** is one field per destination — `SidebarItem`'s `mobile`: `'tab'` gives it a slot of
+its own, `'more'` (the default) makes it an overflow row, `'hidden'` drops it from mobile entirely.
+A whole section claims one slot with `mobile: { tab: true }` (its destinations then open per the
+table above) or leaves mobile with `mobile: false`. Configure nothing and the first four non-disabled
+top-level destinations take slots — a nav that works before anyone has thought about mobile.
+
+**`MobileNavConfig`** (the `mobileNav` prop) is the escape hatch, not the interface: `tabs` for an
+explicit slot order by key when the bar order must differ from the sidebar's, `maxTabs` (5),
+`menuMax` (6), `moreLabel`, `moreExtra`, and `getScrollElement` for re-tap-to-top when the page
+scrolls inside a container rather than the document.
+
+Design rules specific to the bar, each one load-bearing:
+
+- **The active indicator is a neutral pill behind the ICON only** — `--vx-ink` at 10% plus
+  `--vx-radius-ctrl`, the Material-3 idiom. Never the identity blue, and never a full-tab fill: a
+  filled tab reads as chrome instead of as a tab bar. This is the exception to "active nav = accent
+  icon" in the palette rules above; the desktop sidebar keeps that rule unchanged.
+- **A count renders as an 8px accent dot** on the slot icon, not a number — a count glyph is
+  unreadable at 56px. `SidebarItem.count` drives it; `SidebarItem.badge` (a rich node) stays
+  desktop-only.
+- **Press feedback is the icon, not the hit box**: `.tab:active` scales the icon to 0.9 over 140ms.
+  `touch-action: manipulation` + `-webkit-tap-highlight-color: transparent` kill the 300ms
+  double-tap delay and the blue flash.
+- **Every `:hover` rule sits behind `@media (hover: hover)`.** Ungated, a tapped row stays lit until
+  something else is tapped.
+- **Re-tapping the ACTIVE slot scrolls to top** instead of pushing a redundant history entry.
+- **Never add `padding-bottom: env(safe-area-inset-bottom)` to the bar.** Mantine's own
+  `AppShell.Footer` rule already grows the footer box by the inset and pads its content; adding it
+  again double-counts. The one real gap is `AppShell.Main`, whose padding is computed from an offset
+  var that excludes the inset — the shell closes that itself.
+- **Reduced motion** is read explicitly via `useReducedMotion` (Mantine's
+  `respectReducedMotion` defaults to `false` and basalt does not change it) and zeroes both the menu
+  and sheet transitions.
+
+Accessibility, all handled by the shell: the bar is `<nav aria-label="Primary">`, the active slot
+carries `aria-current="page"`, every slot carries `aria-label` (the visible text is the short
+label), menus get `menuItemTabIndex={0}` for the WAI-ARIA disclosure pattern, and the row height
+floors at 44px with the bar at 48px regardless of the `density` level. **Do not hand-set
+`aria-haspopup` / `aria-expanded`** on a `Menu.Target` child — Mantine clones them on.
+
 ## Icons
 
 basalt-ui takes icons as `ReactNode` (no icon dependency shipped). Use a single icon library across the

package/agent/rules/basalt-router.md

@@ -1,6 +1,6 @@
 ---
 source: basalt-ui
-description: TanStack Router conventions for basalt-ui apps — file-based routes, typed search params, and loader/query coupling. Advisory (ships an optional ./router-tanstack adapter for active-state and breadcrumb wiring).
+description: TanStack Router conventions for basalt-ui apps — file-based routes, typed search params, loader/query coupling, and the one typed nav definition that drives both the desktop sidebar and the mobile bar. Advisory (ships an optional ./router-tanstack adapter).
 paths:
   - 'src/routes/**'
   - 'apps/**/src/routes/**'
@@ -8,13 +8,14 @@ paths:
 
 # Basalt Router — TanStack Router Conventions
 
-basalt-ui is **router-agnostic** — `BasaltShell` takes a `NavLinkRenderer` for nav rendering and
-receives active state from the consumer. Nav active-state can now be resolved via
-`useBasaltNav().isActive(item.href)` from `basalt-ui/router-tanstack`, and breadcrumbs via
-`useRouterBreadcrumbs()`; navigation itself stays with TanStack's typed `<Link>` / `useNavigate`.
-Badge counts and navigation wiring remain consumer-side. This rule is the recommended opinion layer
-when you use TanStack Router (the basalt-ui default). It is **advisory** — adopt it for
-consistency; nothing in the framework enforces it.
+basalt-ui is **router-agnostic** — the shell renders every pixel of nav chrome and hosts the
+consumer's router component through one seam, `SidebarItem.Anchor` (a **`NavAnchor`**). With
+TanStack Router you never write that seam by hand: **`defineNav`** declares the whole navigation
+once and **`useNav`** resolves it against the live router, returning the two props `BasaltShell`
+needs. Breadcrumbs come from **`useRouterBreadcrumbs`**, ad-hoc active checks from
+**`useBasaltNav`**. This rule is the recommended opinion layer when you use TanStack Router (the
+basalt-ui default). It is **advisory** — adopt it for consistency; nothing in the framework
+enforces it.
 
 ## Adding a page
 
@@ -23,7 +24,7 @@ consistency; nothing in the framework enforces it.
 3. Add `validateSearch` with a Zod schema parsed via a function — not the schema passed directly.
 4. Define `loaderDeps` to forward search params to the loader (required for search-param-driven queries).
 5. Add a `loader` that calls `ensureQueryData` for each query the page needs.
-6. Register the page in your `BasaltShell` sidebar sections (`SidebarSection[]`).
+6. Register the page in your `defineNav` definition (see "One typed nav definition" below).
 
 ## Route structure
 
@@ -146,28 +147,126 @@ function AppBreadcrumbs() {
 }
 ```
 
-**renderNavLink pattern** — wire the shell's `NavLinkRenderer` with typed TanStack routes.
-basalt does NOT ship this renderer; typed-route `to` is the consumer's typed concern:
+**One typed nav definition** — `defineNav` / `navGroup` / `navTarget` / `useNav`.
+
+The whole navigation — desktop sidebar and mobile bar — is declared once in a **leaf** module
+(`src/lib/nav.tsx`), which imports `@tanstack/react-router` and `basalt-ui/router-tanstack` and
+**never** `routeTree.gen` or `__root.tsx`, so command palettes and redirects can import it without
+closing a cycle.
+
+```tsx
+import { linkOptions } from '@tanstack/react-router'
+import { defineNav, navGroup } from 'basalt-ui/router-tanstack'
+
+const ICON = 18
+
+export const NAV = defineNav({
+  groups: [
+    navGroup({ id: 'health', label: 'Health', icon: <IconHeartbeat size={ICON} /> }, [
+      {
+        id: 'garmin',
+        label: 'Garmin Health',
+        short: 'Garmin', // bar/menu label — keep it ≤ 10 chars
+        mobile: 'tab', // give this destination its own slot on the mobile bar
+        icon: <IconHeartbeat size={ICON} />,
+        link: linkOptions({ to: '/garmin-health', search: { window: '30d' } }),
+      },
+      {
+        id: 'reading',
+        label: 'Reading',
+        icon: <IconBook size={ICON} />,
+        link: linkOptions({ to: '/reading' }),
+        children: [
+          {
+            id: 'reading-stats',
+            label: 'Stats',
+            icon: <IconChartBar size={ICON} />,
+            link: linkOptions({ to: '/reading/stats' }),
+          },
+        ],
+      },
+    ]),
+  ],
+})
+```
 
-```ts
-import { Link } from '@tanstack/react-router'
-import { NavLink as MantineNavLink } from '@mantine/core'
-import { useBasaltNav } from 'basalt-ui/router-tanstack'
-import type { NavLinkRenderer } from 'basalt-ui'
-
-const { isActive } = useBasaltNav()
-
-const renderNavLink: NavLinkRenderer = (item, _flags) => (
-  <MantineNavLink
-    component={Link}
-    to={item.href ?? '/'}
-    label={item.label}
-    leftSection={item.icon}
-    rightSection={item.badge}
-    active={isActive(item.href ?? '/')}
-  />
+Rules that are not stylistic:
+
+- **Route options live under `link:`, wrapped in TanStack's own `linkOptions`** — never spread flat
+  onto the item. `to` / `search` / `params` get the router's full validation there, while `id`,
+  `label`, `short`, `icon`, `mobile`, `disabled` and `exact` ride outside it. A flat shape
+  (`{ id, label, to }`) validates `to` by ASSIGNABILITY, which does no excess-property checking, so
+  a typo'd metadata key would compile silently. A top-level `to:` is a compile error by design.
+- **`search` may be a thunk** — `search: () => ({ date: format(new Date(), 'yyyy-MM-dd') })`
+  compiles without `as const` and re-evaluates at click time, so "today" never goes stale in a
+  long-lived tab.
+- **Nesting is `children`**, and nested destinations are indexed by id just like top-level ones.
+- **`NavItemMeta`**'s `mobile` field places the destination on the bar: `'tab'` (own slot),
+  `'more'` (the default — reachable through the More overlay) or `'hidden'`. A group claims a slot
+  of its own with `mobile: { tab: true }`, and leaves mobile entirely with `mobile: false`.
+
+```tsx
+// __root.tsx — four lines replace a hand-written sections array, two render callbacks,
+// a NAV_TARGETS table and one useMatchRoute call per destination.
+import { useNav } from 'basalt-ui/router-tanstack'
+import { NAV } from '../lib/nav'
+
+const nav = useNav(NAV, { badges: { calendar: unread } }) // keys autocomplete; a typo is an error
+return (
+  <BasaltShell brand={brand} {...nav}>
+    {children}
+  </BasaltShell>
 )
 ```
 
-Navigation (`.navigate()`, `<Link to={…}>`) is always the consumer's typed concern — the adapter
-exposes no `navigate()` helper so that TanStack's route-tree types remain authoritative.
+**`useNav`** returns `{ sections, mobileNav }` — both are `BasaltShell` props, so spread it. It
+resolves `active` per destination through `useMatchRoute` (prefix match by default, exact when the
+item sets `exact: true`, and always exact for `'/'`), and builds each destination's **`NavAnchor`**
+so `preload="intent"`, middle-click and back/forward keep working. `badges` values that are
+`number` become `SidebarItem.count` (a desktop **`NavCountBadge`** plus an accent dot on the mobile
+slot); anything else becomes `SidebarItem.badge`, which is desktop-only because a count glyph is
+unreadable in a 56px tab.
+
+**`navTarget`** returns one destination's link options, typed per id — spread it into `<Link>`,
+`router.navigate()` or `redirect()` instead of restating the route and its default search:
+
+```ts
+throw redirect(navTarget(NAV, 'garmin')) // exactly { to: '/garmin-health', search: { window: '30d' } }
+```
+
+**`flattenNav`** walks the definition depth-first (parent, then children), tagging each destination
+with `groupId` / `groupLabel` — the leaf every other surface reads, e.g. projecting the whole nav
+into Spotlight commands in one `.map()`.
+
+### The prerequisite that makes all of this real
+
+**Without the `Register` module augmentation, `defineNav` validates NOTHING and reports zero
+errors.** `RegisteredRouter` falls back to `AnyRouter` when the consumer has not written:
+
+```ts
+declare module '@tanstack/react-router' {
+  interface Register {
+    router: typeof router
+  }
+}
+```
+
+With that missing, every `to` widens to `string`, a nonexistent route path compiles, a missing
+required `search` compiles, and the API looks like it is working while catching nothing. This is
+the single highest-value thing to verify when adopting the config: change one `to` to a garbage
+path and confirm you get a compile error listing the real route paths. If you don't, the
+augmentation is missing or `tsr generate` has not run.
+
+Second thing to know before you migrate: TypeScript cannot catch a destination that FORGETS a
+default `search` when the route validates with `validateSearch: (raw: Record<string, unknown>) => T`
+— that gives TanStack an input type where no key is required. Diff an old hand-written target table
+against the new definition by hand, key by key.
+
+Error messages here are the router's own and they are large: one wrong `to` prints the whole
+route-path union plus a `RouterCore<…>` blob, because TanStack's `Constrain` falls back to the
+whole constraint. That is not misuse — read the union for the intended path and fix the string.
+**Do not reach for `as never` to make it quiet**; the checking is the entire point of the config.
+
+Navigation itself (`.navigate()`, `<Link to={…}>`) stays the consumer's typed concern — the adapter
+still exposes no `navigate()` helper, so TanStack's route-tree types remain authoritative. What
+`navTarget` hands back is the ARGUMENT to those calls, never the call.

package/agent/rules/basalt-tokens.md

@@ -67,7 +67,8 @@ Retuning a fill OUTSIDE the band breaks its label. `theme/contrast.test.ts` fail
   or genuine multi-series separation. A count badge is a signal → it may carry blue; a nav active-state
   is UI chrome → it stays neutral (`NavCountBadge` already encodes this). Active nav renders a
   **neutral surface fill** + plain text + a weight bump, never the accent — baked into the theme's
-  NavLink `--nl-*` defaults across every render path (including a router `<Link>` via `renderNavLink`).
+  NavLink `--nl-*` defaults across every render path (including a router `<Link>` hosted through
+  `SidebarItem.Anchor`).
 - **Accent restraint, mechanically.** The accent lands on exactly the single primary CTA per view
   (`variant="filled"`), focus rings, links, and small status pops — nowhere else. Routine/secondary
   buttons use `variant="default"` (neutral); don't reach for a colored `variant="light"` (it reads

package/dist/index.d.ts

@@ -10,7 +10,7 @@ export { createBasaltTheme, baseTheme, cssVariablesResolver } from './theme/inde
 export type { BasaltFontsConfig, CreateBasaltThemeOptions } from './theme/index.js';
 export { ThemeToggle, type ThemeToggleProps } from './theme-toggle/index.js';
 export { MOTION_DURATION, MOTION_SPRING, MOTION_EASE_STANDARD } from './motion/index.js';
-export { BasaltShell, NavCountBadge, AppSidebar, SidebarSearch, type SidebarSearchConfig, SidebarAccount, MobileNav, AppBreadcrumbs, type BreadcrumbLinkRenderer, PageHeaderProvider, PageActions, PageActionsOutlet, type SidebarSection, type SidebarItem, type BasaltShellProps, type BrandConfig, type SettingsMenuItem, type AppSidebarProps, type MobileNavItem, type MobileNavSection, type NavLinkRenderer, type MobileNavLinkRenderer, type AccountBadgeTone, type BasaltIdentity, type BasaltRole, type BasaltPlan, type AccountMenuItem, type BasaltAccountState, type BasaltAccountActions, type BasaltAccountProps, } from './shell/index.js';
+export { BasaltShell, NavCountBadge, AppSidebar, SidebarSearch, type SidebarSearchConfig, SidebarAccount, MobileNav, type MobileNavProps, projectMobileNav, type ProjectMobileNavOptions, MOBILE_MAX_TABS_DEFAULT, MOBILE_MENU_MAX_DEFAULT, MOBILE_MORE_KEY, AppBreadcrumbs, PageHeaderProvider, PageActions, PageActionsOutlet, type SidebarSection, type SidebarItem, type NavAnchor, type NavAnchorProps, type NavMobilePlacement, type NavSectionMobile, type MobileNavConfig, type MobileNavGroup, type MobileNavModel, type MobileNavSlot, type MobileNavSurface, type BasaltShellProps, type BrandConfig, type SettingsMenuItem, type AppSidebarProps, type AccountBadgeTone, type BasaltIdentity, type BasaltRole, type BasaltPlan, type AccountMenuItem, type BasaltAccountState, type BasaltAccountActions, type BasaltAccountProps, } from './shell/index.js';
 export { type BasaltRegister, type Slot, type Series, type SeriesKey, type AsyncState, assertNever, type StandardSchemaV1, } from './register.js';
 export { createPersistedState, type PersistedStateOptions, useOnlineStatus, readPersistedValue, } from './state.js';
 export { DeltaBadge, type DeltaBadgeProps, StatCard, type StatCardProps, type StatCardTone, EmptyState, type EmptyStateProps, SettingsSection, type SettingsSectionProps, SettingsRow, type SettingsRowProps, DangerZone, type DangerZoneProps, } from './dashboard/index.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -12,6 +12,10 @@ import {
   SidebarSearch,
   SidebarAccount,
   MobileNav,
+  projectMobileNav,
+  MOBILE_MAX_TABS_DEFAULT,
+  MOBILE_MENU_MAX_DEFAULT,
+  MOBILE_MORE_KEY,
   AppBreadcrumbs,
   PageHeaderProvider,
   PageActions,
@@ -64,6 +68,9 @@ export {
   DangerZone,
   DeltaBadge,
   EmptyState,
+  MOBILE_MAX_TABS_DEFAULT,
+  MOBILE_MENU_MAX_DEFAULT,
+  MOBILE_MORE_KEY,
   MOTION_DURATION,
   MOTION_EASE_STANDARD,
   MOTION_SPRING,
@@ -93,6 +100,7 @@ export {
   createThreadsStore,
   cssVariablesResolver,
   heuristicOutcome,
+  projectMobileNav,
   readPersistedValue,
   threadPartRenderers,
   threadsStoreAdapterContract,

package/dist/nav/types.d.ts

@@ -0,0 +1,110 @@
+/**
+ * The shared nav vocabulary. TYPE-ONLY BY CONTRACT — never add a value export here.
+ * `src/shell/**` (Mantine) and `src/router-tanstack/**` (headless) both `import type` from it,
+ * which is erased by tsup, so `dist/router-tanstack/index.js` gains no edge into `shell/` and
+ * `scripts/check-dist-layering.mjs` stays green with no config change.
+ */
+import type { MouseEvent, ReactNode } from 'react';
+/** Where a destination appears on the mobile bar. `true` ≡ `'tab'`, `false` ≡ `'hidden'`. */
+export type NavMobilePlacement = 'tab' | 'more' | 'hidden';
+/**
+ * Props basalt hands a nav anchor. Deliberately a PLAIN FUNCTION TYPE, not `ComponentType`
+ * or `ElementType`: both are unions, and a union defeats Mantine's polymorphic `component`
+ * inference (`<NavLink component={…}>` then rejects `label`). VERIFIED both ways.
+ */
+export type NavAnchorProps = {
+    className?: string;
+    children?: ReactNode;
+    onClick?: (e: MouseEvent<HTMLElement>) => void;
+    'aria-current'?: 'page' | undefined;
+    'aria-label'?: string;
+};
+export type NavAnchor = (props: NavAnchorProps) => ReactNode;
+/** A single nav destination. */
+export type SidebarItem = {
+    key: string;
+    label: string;
+    /** Bar/menu label. Falls back to `label`. Keep ≤ 10 chars — a 5-slot bar is ~72px wide. */
+    short?: string;
+    /** Mobile placement. `true` ≡ `'tab'`, `false` ≡ `'hidden'`. @default 'more' */
+    mobile?: boolean | NavMobilePlacement;
+    icon: ReactNode;
+    /**
+     * The router seam. basalt renders every pixel of chrome (desktop row, 56px slot, 44px sheet
+     * row) and only hosts this component. When absent the row falls back to `<a href>` + `onClick`.
+     */
+    Anchor?: NavAnchor;
+    /** Plain href — the no-router fallback, and the breadcrumb parent target. */
+    href?: string;
+    active?: boolean;
+    disabled?: boolean;
+    onClick?: (e: MouseEvent) => void;
+    /** Rich desktop badge (e.g. `NavCountBadge`). Desktop only. */
+    badge?: ReactNode;
+    /** Unread count. Renders `NavCountBadge` on desktop when `badge` is absent, and an accent
+     *  dot on the mobile slot icon. `0` renders nothing. */
+    count?: number;
+    children?: SidebarItem[];
+};
+/** Per-section mobile configuration. `false` hides the whole section from mobile. */
+export type NavSectionMobile = {
+    /** Give this SECTION a bar slot; its destinations open per §2.2 cardinality inference. */
+    tab?: true;
+    /** Slot label override; falls back to `SidebarSection.label`. */
+    label?: string;
+    /** Slot icon override; falls back to `SidebarSection.icon`. */
+    icon?: ReactNode;
+};
+export type SidebarSection = {
+    label: string;
+    items: SidebarItem[];
+    icon?: ReactNode;
+    collapsible?: boolean;
+    defaultCollapsed?: boolean;
+    /** Mobile behaviour for this section. Omit for the default (items place themselves). */
+    mobile?: false | NavSectionMobile;
+};
+export type MobileNavSurface = 'link' | 'menu' | 'sheet';
+/** One row inside a `menu`/`sheet` slot, grouped under its source section. */
+export type MobileNavGroup = {
+    key: string;
+    label?: string;
+    items: SidebarItem[];
+};
+export type MobileNavSlot = {
+    kind: 'link';
+    key: string;
+    label: string;
+    short: string;
+    icon: ReactNode;
+    active: boolean;
+    item: SidebarItem;
+} | {
+    kind: 'menu' | 'sheet';
+    key: string;
+    label: string;
+    short: string;
+    icon: ReactNode;
+    active: boolean;
+    groups: MobileNavGroup[];
+    isMore: boolean;
+};
+/** Pure projection of `sections` onto the bar. Unit-testable with no DOM. */
+export type MobileNavModel = {
+    slots: MobileNavSlot[];
+};
+export type MobileNavConfig = {
+    /** Explicit slot order by item/section key. Overrides every `item.mobile` placement. */
+    tabs?: readonly string[];
+    /** Hard cap on bar slots, INCLUDING More. @default 5 */
+    maxTabs?: number;
+    /** Rows a slot may hold before it becomes a sheet instead of a menu. @default 6 */
+    menuMax?: number;
+    /** @default 'More' */
+    moreLabel?: string;
+    /** Extra content pinned to the bottom of the More surface. */
+    moreExtra?: ReactNode;
+    /** Scroll container for active-slot re-tap. @default document.scrollingElement */
+    getScrollElement?: () => HTMLElement | null;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/nav/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAElD,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE1D;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAA;IAC9C,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACnC,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AACD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,SAAS,CAAA;AAE5D,gCAAgC;AAChC,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,2FAA2F;IAC3F,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,gFAAgF;IAChF,MAAM,CAAC,EAAE,OAAO,GAAG,kBAAkB,CAAA;IACrC,IAAI,EAAE,SAAS,CAAA;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;IACjC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB;4DACwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAA;CACzB,CAAA;AAED,qFAAqF;AACrF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,0FAA0F;IAC1F,GAAG,CAAC,EAAE,IAAI,CAAA;IACV,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+DAA+D;IAC/D,IAAI,CAAC,EAAE,SAAS,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,wFAAwF;IACxF,MAAM,CAAC,EAAE,KAAK,GAAG,gBAAgB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;AAExD,8EAA8E;AAC9E,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAA;AAElF,MAAM,MAAM,aAAa,GACrB;IACE,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,IAAI,EAAE,WAAW,CAAA;CAClB,GACD;IACE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IACtB,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,cAAc,EAAE,CAAA;IACxB,MAAM,EAAE,OAAO,CAAA;CAChB,CAAA;AAEL,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG;IAAE,KAAK,EAAE,aAAa,EAAE,CAAA;CAAE,CAAA;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,wFAAwF;IACxF,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sBAAsB;IACtB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAC5C,CAAA"}

package/dist/router-tanstack/index.d.ts

@@ -1,11 +1,18 @@
 /**
  * ./router-tanstack — headless TanStack Router bridge for the app shell.
  * Optional peer: @tanstack/react-router.
- * Augments StaticDataRouteOption with title/icon/navSection for breadcrumb
- * and nav-active wiring — no Mantine, no JSX, no navigate() helper.
+ * Carries the typed navigation definition (`defineNav`/`navGroup`/`navTarget`/`flattenNav`) and
+ * `useNav`, which resolves it into `BasaltShell`'s `sections` + `mobileNav` props; plus the
+ * StaticDataRouteOption augmentation (title/icon/navSection) for router-derived breadcrumbs and
+ * the search-param stores — no Mantine, no JSX.
  */
 export { createSearchParamStore, type SearchParamStore, type SearchParamStoreOptions, } from './search-param-store.js';
 export { createMultiSearchParamStore, type MultiSearchParamStore, type MultiSearchParamStoreOptions, } from './multi-search-param-store.js';
+export { defineNav, navGroup, navTarget, flattenNav } from './nav.js';
+export type { NavItemMeta, NavGroupMeta, AnyNavItem, AnyNavGroup, AnyNavLink, FlatNavItem, NavConfig, NavItemId, NavGroupId, NavTabId, NavIndex, } from './nav.js';
+export { useNav } from './use-nav.js';
+export type { UseNavOptions, NavBinding } from './use-nav.js';
+export type { NavAnchor, NavAnchorProps, NavMobilePlacement } from '../nav/types.js';
 import type { ReactNode } from 'react';
 declare module '@tanstack/react-router' {
     interface StaticDataRouteOption {

package/dist/router-tanstack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,0EAA0E;QAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,oEAAoE;QACpE,IAAI,CAAC,EAAE,SAAS,CAAA;QAChB,wDAAwD;QACxD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB;CACF;AAID,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG;IACtB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;CAChE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AAID,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CASzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1D,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,0EAA0E;QAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,oEAAoE;QACpE,IAAI,CAAC,EAAE,SAAS,CAAA;QAChB,wDAAwD;QACxD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB;CACF;AAID,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG;IACtB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;CAChE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AAID,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CASzD"}

package/dist/router-tanstack/index.js

@@ -4,6 +4,8 @@ import {
 import {
   createMultiSearchParamStore
 } from "./multi-search-param-store.js";
+import { defineNav, navGroup, navTarget, flattenNav } from "./nav.js";
+import { useNav } from "./use-nav.js";
 import { useLocation, useMatches } from "@tanstack/react-router";
 function useBasaltNav() {
   const currentPath = useLocation({ select: (l) => l.pathname });
@@ -24,6 +26,11 @@ function useRouterBreadcrumbs() {
 export {
   createMultiSearchParamStore,
   createSearchParamStore,
+  defineNav,
+  flattenNav,
+  navGroup,
+  navTarget,
   useBasaltNav,
+  useNav,
   useRouterBreadcrumbs
 };