basalt-ui 1.27.0 → 1.29.0

package/dist/tokens/palette.d.ts

@@ -450,8 +450,6 @@ declare const SPACE_STEP_BASE: {
     readonly settingsRowGap: 16;
     /** Diagram container's inset (all sides). */
     readonly mermaidContainerInset: 16;
-    /** Brand row's top inset. */
-    readonly sidebarBrandInsetTop: 2;
     /** Brand row's horizontal inset. */
     readonly sidebarBrandInsetX: 7;
     /** Gap between nav sections. */
@@ -504,6 +502,19 @@ declare const SPACE_STEP_BASE: {
     /** AppShell navbar width, collapsed icon rail. Separate from `appShellHeaderHeight` above
      *  despite sharing 48 at level 0 (see that entry's note). */
     readonly appShellNavbarRailWidth: 48;
+    /** AppShell ASIDE width, unfolded — the right-hand panel region a route claims by rendering
+     *  `PageAside` (`docs/ASIDE-SPEC.md` §0). ONE entry for every viewport, same reasoning as
+     *  `appShellNavbarWidth`: below `sm` the aside is permanently collapsed and `PageAside` renders
+     *  its content in the page flow instead, so there is no second value to keep in step.
+     *
+     *  300, wider than the navbar rail column it mirrors, because the panel holds CONTENT (label-
+     *  above inspector rows, a facet list, a panel-width chart) rather than one row of nav labels —
+     *  it is the width the CBBI evidence page arrived at by hand (`docs/ASIDE-SPEC.md` §2, G13). */
+    readonly appShellAsideWidth: 300;
+    /** AppShell aside width, FOLDED — the rail holding the single expand button. Narrower than
+     *  `appShellNavbarRailWidth` (48) on purpose: the navbar rail hosts a full icon nav row and its
+     *  hover targets, this one hosts exactly one `ctl`-tier icon button and nothing else. */
+    readonly appShellAsideRailWidth: 36;
     /** Tab's icon-to-label gap. */
     readonly mobileNavTabGap: 3;
     /** Bar height, EXCLUDING the safe-area inset — Mantine's own `AppShell.footer` rule adds
@@ -518,8 +529,12 @@ declare const SPACE_STEP_BASE: {
     readonly mobileNavTabInsetY: 2;
     /** Active-pill inset around the slot icon, horizontal. */
     readonly mobileNavTabInsetX: 12;
-    /** Menu/sheet row height. Floored at 44px in `deriveSpacing` (Apple HIG 44pt / WCAG 2.5.5 AAA). */
-    readonly mobileNavRowHeight: 44;
+    /** Menu/sheet row height. Floored at 40px in `deriveSpacing` — a deliberate design choice, not
+     *  a WCAG floor: it's the row height shared with the desktop sidebar rows, above the WCAG 2.5.8
+     *  AA minimum (24px) and below the 2.5.5 AAA figure (44px, the size `mobileNavBarHeight`/
+     *  `sheetRowHeight` still hold to) — the shortest box that still reads as ONE row vocabulary with
+     *  the sidebar instead of a bespoke touch size. */
+    readonly mobileNavRowHeight: 40;
     /** More/group `<Menu width={…}>`. JS-consumed, no var — same rationale as
      *  `sidebarSettingsMenuWidth` directly above. */
     readonly mobileNavMenuWidth: 232;
@@ -621,6 +636,18 @@ export declare const SPACE_FIXED: {
      * `[-3, 3]` range can produce) for no compensating benefit, since the two radii it sits between
      * never move independently of each other. */
     readonly segmentedTrackInset: 2;
+    /**
+     * The WCAG 2.5.5/2.5.8 touch-target floor (44px) for a hit area that has no `ctl`-tier home to
+     * size it — a raw CSS-module rule bumping a control's hit area under `@media (pointer: coarse)`
+     * (C5 consolidation: argo carried three such rules with a hand-picked 44/46px literal apiece).
+     * Density-exempt for the same reason `touchControlHeight`'s FLOOR is: a target this small must
+     * never shrink further, whatever the density knob says elsewhere. Unlike the rest of this
+     * object, this ONE key IS emitted as a `--vx-*` var (`tokens/index.ts`'s `space-touch-target`) —
+     * the others stay JS-only because nothing outside the framework's own components reads them, but
+     * this floor's whole purpose is being read by a CONSUMER's own `.module.css`, which cannot
+     * import a JS ref at all.
+     */
+    readonly spaceTouchTarget: 44;
 };
 /**
  * The resolved shape {@link deriveSpacing} returns — the two anchor/scale base groups above (as
@@ -708,22 +735,26 @@ export declare function scaleSpace(value: number, level: number, multiplier: num
  *    value) below the accessible floor (22px at level -3) while also crowding out its fixed-size icon
  *    and `Kbd` chip.
  *  - `step.stickyHeaderClearance` is not scaled off its own base AT ALL — `SPACE_STEP_BASE` has no
- *    such key any more (see that table's doc). It is computed AFTER the rest of `step`, as
- *    `step.appShellHeaderHeight + anchors.stackMd`. An independent literal can only be tuned against
- *    ONE header height and then drifts from it: the original 84 was tuned against a 48px desktop
- *    header and under-cleared the pre-1.26.0 96px mobile one by 12px at level 0, before density
- *    entered the picture at all. Deriving it removes that whole failure mode — and since 1.26.0 the
- *    AppShell header is ONE 48px row at every viewport (law C14), so the `stickyHeaderClearanceMobile`
- *    half of the old responsive pair is deleted rather than re-derived. The `+ anchors.stackMd`
- *    breathing room (not a bare `+ 0`) keeps a scrolled-to heading off the header's bottom edge, and
- *    tracks density like the header height it is added to, so the margin never freezes at one notch.
- *    Level 0: `48 + 12 = 60` (a deliberate BREAK from the pre-derivation 84 — see
- *    `theme/spacing.test.ts` for why `stickyHeaderClearance` alone is exempt from the byte-identity
- *    gate every other spacing token is held to).
- *    **Consumer coupling (accepted, not hidden):** the value assumes `BasaltShell`'s own AppShell
- *    header height — a `./content` consumer NOT rendering inside `BasaltShell` (e.g. `Prose`/
- *    `ArticleLayout` standalone) gets a clearance number tuned for a header it may not have, and must
- *    override `--vx-space-sticky-header-clearance` itself. Documented on the `./content` surface too
+ *    such key any more (see that table's doc). It is computed AFTER the rest of `step`, and it is
+ *    now exactly `anchors.stackMd` — pure BREATHING ROOM, with no chrome height folded into it.
+ *    It used to be `step.appShellHeaderHeight + anchors.stackMd` (60 at level 0), which was correct
+ *    while the DOCUMENT scrolled under a fixed 48px app header. It no longer does: `BasaltShell`
+ *    makes `AppShell.Main` the scrollport (`shell/app-main.module.css`), and the header sits OUTSIDE
+ *    that box — so a clearance that still counted the header parked every scrolled-to heading and
+ *    every sticky rail 48px too far down, inside the content instead of above it.
+ *    What the two consumers need is the chrome INSIDE the scrollport — but `PageBar` row 2 now
+ *    portals into a shell-owned band outside the scrollport (see `shell/page-bar.tsx`), so there is
+ *    no page-bar term left to add: both `content/prose.module.css`'s `scroll-margin-top` and
+ *    `content/article-layout.module.css`'s `.tocRail` now use `--vx-space-sticky-header-clearance`
+ *    alone. Keeping the token free of any chrome assumption is what makes it honest on a page with
+ *    no page bar, which is most of them.
+ *    The value still tracks density (it IS a density anchor), so the margin never freezes at one
+ *    notch. Level 0: 12 (a second deliberate BREAK from the byte-identity gate — see
+ *    `theme/spacing.test.ts` for why `stickyHeaderClearance` alone is exempt from it).
+ *    **Consumer coupling (removed, not hidden):** the value no longer assumes ANY header height, so
+ *    a `./content` consumer outside `BasaltShell` (e.g. `Prose`/`ArticleLayout` standalone) gets a
+ *    number that is correct for it too. A consumer with its OWN fixed chrome above the scrollport
+ *    still overrides `--vx-space-sticky-header-clearance`. Documented on the `./content` surface too
  *    (`docs/CONTENT-SPEC.md` §5), not only here.
  *
  * `rowLineHeight` is the ONE exception to the multiplier entirely: `1.35 + ROW_LINE_HEIGHT_STEP *
@@ -897,7 +928,6 @@ export declare const SPACE_STEP: {
     readonly settingsRowInsetY: number;
     readonly settingsRowGap: number;
     readonly mermaidContainerInset: number;
-    readonly sidebarBrandInsetTop: number;
     readonly sidebarBrandInsetX: number;
     readonly sidebarSectionGap: number;
     readonly sidebarAccountInsetTop: number;
@@ -915,6 +945,8 @@ export declare const SPACE_STEP: {
     readonly appShellHeaderHeight: number;
     readonly appShellNavbarWidth: number;
     readonly appShellNavbarRailWidth: number;
+    readonly appShellAsideWidth: number;
+    readonly appShellAsideRailWidth: number;
     readonly mobileNavTabGap: number;
     readonly mobileNavBarHeight: number;
     readonly mobileNavIconSize: number;
@@ -994,8 +1026,8 @@ declare function buildPaletteDataUncached(config: DeriveConfig): {
         };
         readonly field: ColorPair;
         readonly divider: {
-            readonly light: "color-mix(in srgb, #e5e5e5 65%, transparent)";
-            readonly dark: "color-mix(in srgb, #ffffff 6%, transparent)";
+            readonly light: string;
+            readonly dark: "rgba(255, 255, 255, 0.08)";
         };
     };
     INK: {
@@ -1207,8 +1239,8 @@ export declare const SURFACE: {
     };
     readonly field: ColorPair;
     readonly divider: {
-        readonly light: "color-mix(in srgb, #e5e5e5 65%, transparent)";
-        readonly dark: "color-mix(in srgb, #ffffff 6%, transparent)";
+        readonly light: string;
+        readonly dark: "rgba(255, 255, 255, 0.08)";
     };
 };
 export {};

package/dist/tokens/palette.d.ts.map

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

package/dist/tokens/palette.js

@@ -352,8 +352,6 @@ const SPACE_STEP_BASE = {
   /** Diagram container's inset (all sides). */
   mermaidContainerInset: 16,
   // ── shell/app-sidebar.module.css (beyond the shared/reused anchors above) ────────────────────
-  /** Brand row's top inset. */
-  sidebarBrandInsetTop: 2,
   /** Brand row's horizontal inset. */
   sidebarBrandInsetX: 7,
   /** Gap between nav sections. */
@@ -416,6 +414,19 @@ const SPACE_STEP_BASE = {
   /** AppShell navbar width, collapsed icon rail. Separate from `appShellHeaderHeight` above
    *  despite sharing 48 at level 0 (see that entry's note). */
   appShellNavbarRailWidth: 48,
+  /** AppShell ASIDE width, unfolded — the right-hand panel region a route claims by rendering
+   *  `PageAside` (`docs/ASIDE-SPEC.md` §0). ONE entry for every viewport, same reasoning as
+   *  `appShellNavbarWidth`: below `sm` the aside is permanently collapsed and `PageAside` renders
+   *  its content in the page flow instead, so there is no second value to keep in step.
+   *
+   *  300, wider than the navbar rail column it mirrors, because the panel holds CONTENT (label-
+   *  above inspector rows, a facet list, a panel-width chart) rather than one row of nav labels —
+   *  it is the width the CBBI evidence page arrived at by hand (`docs/ASIDE-SPEC.md` §2, G13). */
+  appShellAsideWidth: 300,
+  /** AppShell aside width, FOLDED — the rail holding the single expand button. Narrower than
+   *  `appShellNavbarRailWidth` (48) on purpose: the navbar rail hosts a full icon nav row and its
+   *  hover targets, this one hosts exactly one `ctl`-tier icon button and nothing else. */
+  appShellAsideRailWidth: 36,
   // ── shell/app-mobile-nav.module.css ───────────────────────────────────────────────────────────
   /** Tab's icon-to-label gap. */
   mobileNavTabGap: 3,
@@ -431,8 +442,12 @@ const SPACE_STEP_BASE = {
   mobileNavTabInsetY: 2,
   /** Active-pill inset around the slot icon, horizontal. */
   mobileNavTabInsetX: 12,
-  /** Menu/sheet row height. Floored at 44px in `deriveSpacing` (Apple HIG 44pt / WCAG 2.5.5 AAA). */
-  mobileNavRowHeight: 44,
+  /** Menu/sheet row height. Floored at 40px in `deriveSpacing` — a deliberate design choice, not
+   *  a WCAG floor: it's the row height shared with the desktop sidebar rows, above the WCAG 2.5.8
+   *  AA minimum (24px) and below the 2.5.5 AAA figure (44px, the size `mobileNavBarHeight`/
+   *  `sheetRowHeight` still hold to) — the shortest box that still reads as ONE row vocabulary with
+   *  the sidebar instead of a bespoke touch size. */
+  mobileNavRowHeight: 40,
   /** More/group `<Menu width={…}>`. JS-consumed, no var — same rationale as
    *  `sidebarSettingsMenuWidth` directly above. */
   mobileNavMenuWidth: 232,
@@ -536,7 +551,19 @@ const SPACE_FIXED = {
    * to 1 at density's floor level -3 and 3 at its ceiling level +3 — the widest swing `deriveSpacing`'s
    * `[-3, 3]` range can produce) for no compensating benefit, since the two radii it sits between
    * never move independently of each other. */
-  segmentedTrackInset: 2
+  segmentedTrackInset: 2,
+  /**
+   * The WCAG 2.5.5/2.5.8 touch-target floor (44px) for a hit area that has no `ctl`-tier home to
+   * size it — a raw CSS-module rule bumping a control's hit area under `@media (pointer: coarse)`
+   * (C5 consolidation: argo carried three such rules with a hand-picked 44/46px literal apiece).
+   * Density-exempt for the same reason `touchControlHeight`'s FLOOR is: a target this small must
+   * never shrink further, whatever the density knob says elsewhere. Unlike the rest of this
+   * object, this ONE key IS emitted as a `--vx-*` var (`tokens/index.ts`'s `space-touch-target`) —
+   * the others stay JS-only because nothing outside the framework's own components reads them, but
+   * this floor's whole purpose is being read by a CONSUMER's own `.module.css`, which cannot
+   * import a JS ref at all.
+   */
+  spaceTouchTarget: 44
 };
 function scaleSpace(value, level, multiplier) {
   if (level === 0) return value;
@@ -571,15 +598,16 @@ function deriveSpacing(level) {
   anchors.touchControlHeight = Math.max(30, anchors.touchControlHeight);
   const mappedStep = mapSpaceGroup(SPACE_STEP_BASE, level, multiplier);
   mappedStep.sidebarSearchTriggerHeight = Math.max(24, mappedStep.sidebarSearchTriggerHeight);
-  mappedStep.mobileNavBarHeight = Math.max(48, mappedStep.mobileNavBarHeight);
-  mappedStep.mobileNavRowHeight = Math.max(44, mappedStep.mobileNavRowHeight);
+  mappedStep.mobileNavBarHeight = Math.max(49, mappedStep.mobileNavBarHeight);
+  mappedStep.mobileNavRowHeight = Math.max(40, mappedStep.mobileNavRowHeight);
   mappedStep.sheetRowHeight = Math.max(44, mappedStep.sheetRowHeight);
   const step = {
     ...mappedStep,
-    // DERIVED from the header it clears, plus density-tracking breathing room — see this function's
+    // Density-tracking breathing room and NOTHING else — the app header is outside the scrollport
+    // now, so folding its height in here would push every consumer down by it. See this function's
     // doc (third bullet) for the full rationale, and `theme/spacing.test.ts` for why
     // `stickyHeaderClearance` alone is exempt from the level-0 byte-identity gate.
-    stickyHeaderClearance: mappedStep.appShellHeaderHeight + anchors.stackMd
+    stickyHeaderClearance: anchors.stackMd
   };
   return {
     anchors,
@@ -711,12 +739,13 @@ function buildPaletteDataUncached(config) {
     },
     // Input field surface (docs/DESIGN-SPEC.md §5 field idiom) — reads slightly inset ON a panel.
     field: DERIVED.surface.field,
-    // Hand-authored: the generator has no `divider` stop — layout separators (header bottom rule,
-    // sidebar child indent) stay a fixed-opacity color-mix, distinct from the card ring.
-    divider: {
-      light: "color-mix(in srgb, #e5e5e5 65%, transparent)",
-      dark: "color-mix(in srgb, #ffffff 6%, transparent)"
-    }
+    // The SEAM token (docs/DESIGN-SPEC.md §5 "Region seams") — every `AppShell` region edge and
+    // every between-rows rule reads it. A relative alpha over the DERIVED ink, the same law as
+    // `NEUTRAL.grid` above (ink over light, white over dark), so it survives every derive knob and
+    // neutral seed: the old `#e5e5e5` hex flipped polarity at `lightLevel <= -3` and was a grey
+    // line on a slate page. Not the card ring (`hairline`), not the control/overlay line
+    // (`border`). `divider-contrast.test.ts` pins the floor.
+    divider: { light: inkRgba(inkLight, 0.09), dark: "rgba(255, 255, 255, 0.08)" }
   };
   return { ACCENT: ACCENT2, FILL: FILL2, SURFACE: SURFACE2, INK: INK2, NEUTRAL: NEUTRAL2, SEMANTIC: SEMANTIC2, STATUS: STATUS2 };
 }

package/dist/tokens.css

@@ -5,6 +5,7 @@
   --vx-radius-fine: 4px;
   --vx-radius-floating: 8px;
   --vx-radius-pill: 9999px;
+  --vx-space-touch-target: 44px;
   --vx-space-row-inset-x: 10px;
   --vx-space-row-inset-y: 6px;
   --vx-space-row-line-height: 1.35;
@@ -19,7 +20,7 @@
   --vx-space-stack-md: 12px;
   --vx-space-stack-lg: 16px;
   --vx-space-stack-xl: 24px;
-  --vx-space-sticky-header-clearance: 60px;
+  --vx-space-sticky-header-clearance: 12px;
   --vx-space-nav-icon-gap: 10px;
   --vx-space-sidebar-region-gap: 10px;
   --vx-space-prose-quote-inset-y: 2px;
@@ -83,7 +84,6 @@
   --vx-space-settings-row-inset-y: 10px;
   --vx-space-settings-row-gap: 16px;
   --vx-space-mermaid-container-inset: 16px;
-  --vx-space-sidebar-brand-inset-top: 2px;
   --vx-space-sidebar-brand-inset-x: 7px;
   --vx-space-sidebar-section-gap: 12px;
   --vx-space-sidebar-account-inset-top: 9px;
@@ -100,7 +100,7 @@
   --vx-space-mobile-nav-icon-size: 24px;
   --vx-space-mobile-nav-tab-inset-y: 2px;
   --vx-space-mobile-nav-tab-inset-x: 12px;
-  --vx-space-mobile-nav-row-height: 44px;
+  --vx-space-mobile-nav-row-height: 40px;
   --vx-space-agent-rail-inset-x: 10px;
   --vx-space-agent-part-gap-top: 6px;
   --vx-space-agent-code-inset: 8px;
@@ -217,7 +217,7 @@ html[data-mantine-color-scheme='dark'] {
   --vx-accent-fill: #4374a6;
   --vx-accent-fill-hover: #3c6895;
   --vx-on-accent: #ffffff;
-  --vx-divider: color-mix(in srgb, #ffffff 6%, transparent);
+  --vx-divider: rgba(255, 255, 255, 0.08);
   --vx-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent);
   --vx-shadow-ctrl: 0 1px 2px rgba(0, 0, 0, 0.35);
   --vx-shadow-raised: 0 1px 2px rgba(0, 0, 0, 0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent);
@@ -281,7 +281,7 @@ html[data-mantine-color-scheme='light'] {
   --vx-accent-fill: #4374a6;
   --vx-accent-fill-hover: #3c6895;
   --vx-on-accent: #ffffff;
-  --vx-divider: color-mix(in srgb, #e5e5e5 65%, transparent);
+  --vx-divider: rgba(38, 38, 41, 0.09);
   --vx-shadow-card: 0 1px 2px rgba(28, 25, 23, 0.05), 0 0 0 1px var(--vx-surface-hairline);
   --vx-shadow-ctrl: 0 1px 2px rgba(28, 25, 23, 0.12);
   --vx-shadow-raised: 0 1px 2px rgba(28, 25, 23, 0.1);

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.27.0
+# basalt-ui v1.29.0
 # Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets
 #
 # basalt-ui is an opinionated framework for Mantine-based React apps.
@@ -19,14 +19,14 @@
 # ./tokens.css subpath. Guide: docs/FRAMEWORK-FREE.md in the repo.
 
 Package: basalt-ui
-Version: 1.27.0
+Version: 1.29.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'
-Description: BasaltProvider, createBasaltTheme, BasaltShell + sidebar/mobile-nav/breadcrumbs, PageBar, NavCountBadge, ThemeToggle, ThreadWorkspace + thread-chat components, WidgetHeader, dashboard composites (DeltaBadge, StatCard with threshold tone, EmptyState, QueryState/LoadingState/ErrorState, SettingsSection/SettingsRow/DangerZone)
+Description: BasaltProvider, createBasaltTheme, BasaltShell + sidebar/mobile-nav/breadcrumbs, PageBar, PageAside, useBreakpoint, NavCountBadge, ThemeToggle, ThreadWorkspace + thread-chat components, WidgetHeader, dashboard composites (DeltaBadge, StatCard with threshold tone, EmptyState, QueryState/LoadingState/ErrorState, SettingsSection/SettingsRow/DangerZone), ConnectivityProvider/useConnectivity/ConnectivityIndicator (auto-mounted, C1: absorbed from the dropped ./connectivity), createBasaltQueryClient/unwrap/BasaltQueryDevtools (C1: absorbed from the dropped ./query), BasaltDevDock (C5: lazy Router/Query devtools + theme lab in one dock)
 Layer: mantine-coupled
 Rule: basalt-mantine
-OptionalPeers: react-markdown@^10.1.0, remark-gfm@^4.0.1, rehype-sanitize@^6.0.0, remend@1.3.0, shiki@^4.3.0, beautiful-mermaid@^1.1.0
+OptionalPeers: react-markdown@^10.1.0, remark-gfm@^4.0.1, rehype-sanitize@^6.0.0, remend@1.3.0, shiki@^4.3.0, beautiful-mermaid@^1.1.0, @tanstack/react-router-devtools@^1.166.13
 
 ## basalt-ui/charts
 Import: import { ... } from 'basalt-ui/charts'
@@ -48,7 +48,7 @@ Layer: mantine-coupled
 ## basalt-ui/vite
 Import: import { ... } from 'basalt-ui/vite'
 Description: basaltViteConfig(opts) — Vite preset for basalt-ui consumer apps; basaltAppPlugin(opts) — PWA head, manifest, and icon metadata derived from the token palette
-Layer: mantine-coupled
+Layer: build-tooling
 OptionalPeers: vite-plugin-pwa@^1.3.0
 
 ## basalt-ui/guard
@@ -56,23 +56,21 @@ Import: import { ... } from 'basalt-ui/guard'
 Description: checkSource, GUARD_RULES, Finding types — the headless theme-guard core
 Layer: headless
 
-## basalt-ui/query
-Import: import { ... } from 'basalt-ui/query'
-Description: createBasaltQueryClient, transport-agnostic unwrap, lazy BasaltQueryDevtools
+## basalt-ui/format
+Import: import { ... } from 'basalt-ui/format'
+Description: money/percent/integer/compact/deltaPct/duration/durationClock/clock/relativeTime/weekday/km/kcal — Intl-backed, Mantine-free, React-free formatting; charts/utils/format.ts re-exports fmtCompact/fmtPercent/fmtCurrency/fmtInt/fmtAxisDate/fmtTooltipDate from here (C5 consolidation, one implementation)
 Layer: headless
-Rule: basalt-batteries
-OptionalPeers: @tanstack/react-query-devtools@^5.101.0
 
 ## basalt-ui/router-tanstack
 Import: import { ... } from 'basalt-ui/router-tanstack'
-Description: TanStack Router bridge: defineNav/navGroup/navTarget (one typed nav definition) + useNav (sections + mobileNav, spread onto BasaltShell) + useBasaltNav (active route) + useRouterBreadcrumbs + createSearchStore (typed URL > localStorage > fallback store over field.enum/multi/range/number/boolean/string; deprecated createSearchParamStore/createMultiSearchParamStore wrappers until 1.29.0)
+Description: TanStack Router bridge: defineNav/navGroup/navTarget (one typed nav definition) + useNav (sections + mobileNav, spread onto BasaltShell) + useBasaltNav (active route) + useRouterBreadcrumbs + createSearchStore (typed URL > localStorage > fallback store over field.enum/multi/range/number/boolean/string; the deprecated createSearchParamStore/createMultiSearchParamStore wrappers were removed in 1.29.0, C1 consolidation)
 Layer: headless
 Rule: basalt-state
 OptionalPeers: @tanstack/react-router@^1.170.0
 
 ## basalt-ui/forms
 Import: import { ... } from 'basalt-ui/forms'
-Description: Mantine form adapter: useBasaltForm, field, FormErrorSummary, useFormDraft (Standard Schema)
+Description: Mantine form layer: useBasaltForm + inputProps/fieldKey (two calls — a spread `key` is a React 19 warning; the deprecated `field` alias for `inputProps` was removed in 1.29.0, C1 consolidation), the FormSection/FormRow/FormGroup/FormActions layout (FormRow is law C1’s form row), useFormSubmit (submit state, decoded errors, server fieldErrors, focus-first-error, validateAsync), FormStateProvider disable propagation, useFieldArray, FormErrorSummary, useFormDraft with autosave (Standard Schema)
 Layer: mantine-coupled
 Rule: basalt-batteries
 OptionalPeers: @mantine/form@^9.3.0
@@ -91,13 +89,6 @@ Layer: mantine-coupled
 Rule: basalt-batteries
 OptionalPeers: @mantine/spotlight@^9.3.0, @mantine/modals@^9.3.0, @tanstack/react-hotkeys@0.10.0
 
-## basalt-ui/data
-Import: import { ... } from 'basalt-ui/data'
-Description: Convenience barrel pulling both TanStack Table + Virtual peer groups: BasaltDataTable, BasaltVirtualList (Mantine-rendered) — prefer ./data/table or ./data/virtual for per-feature opt-in
-Layer: mantine-coupled
-Rule: basalt-batteries
-OptionalPeers: @tanstack/react-table@>=8 <9, @tanstack/react-virtual@>=3.13.26 <4
-
 ## basalt-ui/data/table
 Import: import { ... } from 'basalt-ui/data/table'
 Description: BasaltDataTable: a sortable data table over TanStack Table, rendered with Mantine (Mantine-rendered)
@@ -135,7 +126,7 @@ OptionalPeers: shiki@^4.3.0, @shikijs/langs@^4.3.1, @shikijs/themes@^4.3.1, beau
 
 ## basalt-ui/controls
 Import: import { ... } from 'basalt-ui/controls'
-Description: The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/NumberFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5; NumberFilter is the field.number lane, a radio list over `options` or a stepper without), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.
+Description: The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/NumberFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5; NumberFilter is the field.number lane, a radio list over `options` or a stepper without), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). THREE surfaces, picked by the home and never by a prop (useFilterSurface): pill in a PageBar row, sheet in the mobile Filters (n) drawer, panel in a PageAside body — where every control renders an inspector/facet ROW instead of a chip (docs/ASIDE-SPEC.md §3). PanelRow is that row primitive (label above, hint, mono readout, an `end` control on the label line) and SliderControl is the one bound control with no pill form at all; the counts/max props on MultiSelectFilter render the Foundry facet list there. Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.
 Layer: mantine-coupled
 Rule: basalt-controls
 
@@ -152,12 +143,6 @@ Description: createPersistedState (versioned localStorage) + the store field voc
 Layer: headless
 Rule: basalt-state
 
-## basalt-ui/connectivity
-Import: import { ... } from 'basalt-ui/connectivity'
-Description: ConnectivityProvider (aggregates browser online/offline, React Query onlineManager, SSE, and health-check pings into one status), useConnectivity, and ConnectivityIndicator — auto-mounted by BasaltProvider
-Layer: mantine-coupled
-Rule: basalt-mantine
-
 ## basalt-ui/styles.css
 Asset: basalt-ui/styles.css
 Description: Mandatory CSS import (after the Mantine styles.layer.css bundles) — @layer basalt base styles, iOS input safety net, font stack

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "1.27.0",
+  "version": "1.29.0",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets",
   "keywords": [
     "charts",
@@ -31,6 +31,8 @@
   "files": [
     "dist/",
     "src/",
+    "!src/**/*.test.ts",
+    "!src/**/*.test.tsx",
     "configs/",
     "agent/",
     "bin/",
@@ -47,100 +49,113 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js"
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
     },
     "./charts": {
       "types": "./dist/charts/index.d.ts",
-      "import": "./dist/charts/index.js"
+      "import": "./dist/charts/index.js",
+      "default": "./dist/charts/index.js"
     },
     "./tokens": {
       "types": "./dist/tokens/index.d.ts",
-      "import": "./dist/tokens/index.js"
+      "import": "./dist/tokens/index.js",
+      "default": "./dist/tokens/index.js"
     },
     "./theme-lab": {
       "types": "./dist/theme-lab/index.d.ts",
-      "import": "./dist/theme-lab/index.js"
+      "import": "./dist/theme-lab/index.js",
+      "default": "./dist/theme-lab/index.js"
     },
     "./vite": {
       "types": "./dist/vite.d.ts",
-      "import": "./dist/vite.js"
+      "import": "./dist/vite.js",
+      "default": "./dist/vite.js"
     },
     "./guard": {
       "types": "./dist/guard/index.d.ts",
-      "import": "./dist/guard/index.js"
+      "import": "./dist/guard/index.js",
+      "default": "./dist/guard/index.js"
+    },
+    "./format": {
+      "types": "./dist/format/index.d.ts",
+      "import": "./dist/format/index.js",
+      "default": "./dist/format/index.js"
     },
     "./forms": {
       "types": "./dist/forms/index.d.ts",
-      "import": "./dist/forms/index.js"
+      "import": "./dist/forms/index.js",
+      "default": "./dist/forms/index.js"
     },
     "./commands": {
       "types": "./dist/commands/index.d.ts",
-      "import": "./dist/commands/index.js"
+      "import": "./dist/commands/index.js",
+      "default": "./dist/commands/index.js"
     },
     "./notifications": {
       "types": "./dist/notifications/index.d.ts",
-      "import": "./dist/notifications/index.js"
-    },
-    "./query": {
-      "types": "./dist/query/index.d.ts",
-      "import": "./dist/query/index.js"
+      "import": "./dist/notifications/index.js",
+      "default": "./dist/notifications/index.js"
     },
     "./router-tanstack": {
       "types": "./dist/router-tanstack/index.d.ts",
-      "import": "./dist/router-tanstack/index.js"
-    },
-    "./data": {
-      "types": "./dist/data/index.d.ts",
-      "import": "./dist/data/index.js"
+      "import": "./dist/router-tanstack/index.js",
+      "default": "./dist/router-tanstack/index.js"
     },
     "./data/table": {
       "types": "./dist/data/table.d.ts",
-      "import": "./dist/data/table.js"
+      "import": "./dist/data/table.js",
+      "default": "./dist/data/table.js"
     },
     "./data/virtual": {
       "types": "./dist/data/virtual.d.ts",
-      "import": "./dist/data/virtual.js"
+      "import": "./dist/data/virtual.js",
+      "default": "./dist/data/virtual.js"
     },
     "./agent": {
       "types": "./dist/agent/index.d.ts",
-      "import": "./dist/agent/index.js"
+      "import": "./dist/agent/index.js",
+      "default": "./dist/agent/index.js"
     },
     "./agent-chat": {
       "types": "./dist/agent-chat/index.d.ts",
-      "import": "./dist/agent-chat/index.js"
+      "import": "./dist/agent-chat/index.js",
+      "default": "./dist/agent-chat/index.js"
     },
     "./content": {
       "types": "./dist/content/index.d.ts",
-      "import": "./dist/content/index.js"
+      "import": "./dist/content/index.js",
+      "default": "./dist/content/index.js"
     },
     "./controls": {
       "types": "./dist/controls/index.d.ts",
-      "import": "./dist/controls/index.js"
+      "import": "./dist/controls/index.js",
+      "default": "./dist/controls/index.js"
     },
     "./controls-dates": {
       "types": "./dist/controls-dates/index.d.ts",
-      "import": "./dist/controls-dates/index.js"
+      "import": "./dist/controls-dates/index.js",
+      "default": "./dist/controls-dates/index.js"
     },
     "./state": {
       "types": "./dist/state.d.ts",
-      "import": "./dist/state.js"
-    },
-    "./connectivity": {
-      "types": "./dist/connectivity/index.d.ts",
-      "import": "./dist/connectivity/index.js"
+      "import": "./dist/state.js",
+      "default": "./dist/state.js"
     },
     "./styles.css": "./dist/styles.css",
     "./tokens.css": "./dist/tokens.css",
     "./configs/*": "./configs/*",
-    "./llms.txt": "./llms.txt"
+    "./llms.txt": "./llms.txt",
+    "./package.json": "./package.json"
   },
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "scripts": {
-    "build": "tsup && tsc --emitDeclarationOnly --declarationMap && bun scripts/copy-assets.mjs && bun scripts/gen-tokens-css.mjs && bun scripts/fix-esm-extensions.mjs",
-    "typecheck": "tsc --noEmit && tsc -p tests/layout/tsconfig.json",
+    "build": "tsup && tsc -p tsconfig.build.json --emitDeclarationOnly --declarationMap && bun scripts/copy-assets.mjs && bun scripts/gen-tokens-css.mjs && bun scripts/fix-esm-extensions.mjs",
+    "typecheck": "tsc --noEmit",
+    "check-budgets": "bun scripts/check-budgets.ts",
     "test": "cd ../.. && bun test packages/basalt-ui",
     "pack-test": "bash scripts/pack-test.sh",
     "prepack": "bun run build",
@@ -155,6 +170,7 @@
     "@shikijs/langs": "^4.3.1",
     "@shikijs/themes": "^4.3.1",
     "@tanstack/react-hotkeys": "0.10.0",
+    "@tanstack/react-router-devtools": "^1.166.13",
     "@types/bun": "^1.3.14",
     "@types/hast": "^3.0.4",
     "@types/react": "^19.2.17",
@@ -200,6 +216,7 @@
     "@tanstack/react-query": "^5.101.0",
     "@tanstack/react-query-devtools": "^5.101.0",
     "@tanstack/react-router": "^1.170.0",
+    "@tanstack/react-router-devtools": "^1.166.13",
     "@tanstack/react-table": ">=8 <9",
     "@tanstack/react-virtual": ">=3.13.26 <4",
     "@visx/axis": "4.0.0",
@@ -274,6 +291,9 @@
     "@tanstack/react-router": {
       "optional": true
     },
+    "@tanstack/react-router-devtools": {
+      "optional": true
+    },
     "@tanstack/react-table": {
       "optional": true
     },