basalt-ui 1.40.3 → 2.0.0

package/MIGRATING.md

@@ -66,26 +66,958 @@ There is one row per SURFACE, not per export, and a surface earns a row once any
 shipped lefthook preset both changed in 1.30.0 with no row that owned them — which is how a
 consumer read this index, found nothing, and diffed a KPI row that had silently gone 4-up → 2-up.
 
-| Surface                       | 1.27.0                                                       | 1.28.0                                                                                 | 1.29.0                                                                                         | 1.30.0                                                                             | 1.30.1                                                                | 1.30.2 | 1.31.0                                                                                                | 1.32.0                                                                    | 1.32.1                                                                                                          | 1.33.0                                                                        | 1.34.0                             | 1.34.1 | 1.35.0 | 1.36.0                                                                                       | 1.36.1 | 1.37.0 | 1.37.1 | 1.38.0 | 1.38.1 | 1.39.0                                          | 1.40.0 | 1.40.1 | 1.40.2 | 1.40.3 | Unreleased |
-| ----------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------- | ------ | ------ | -------------------------------------------------------------------------------------------- | ------ | ------ | ------ | ------ | ------ | ----------------------------------------------- | ------ | ------ | ------ | ------ | ---------- | --- |
-| **tokens** (`./tokens`)       | —                                                            | `--vx-divider` → `rgba()` on both schemes (§ Shell)                                    | `--vx-space-touch-target` added (§ Additions)                                                  | eight spacing numbers (§ Chrome)                                                   | —                                                                     | —      | `--vx-hit` replaces the touch vars; `SIZE_CLASSES` (§ 1.31.0)                                         | —                                                                         | `SIZE_CLASSES`/`CONTAINER_CLASSES` actually exported (§ Fixes)                                                  | `CONTAINER_GRID_BREAKPOINTS`; `raw-breakpoint` trusts it (§ 1.33.0)           | `CONTAINER_KEYS` (§ 1.34.0)        | —      | —      | —                                                                                            | —      | —      | —      | —      |        | `appShellInset` 20 → 16 (§ 1.38.1)              | —      | —      | —      | —      | —          | —   |
-| **charts** (`./charts`)       | —                                                            | phone tier, `curve`, formatters, `state`, log axis (§ preamble)                        | `ChartState.empty: string`, `AxisBottomNumeric` (§ Additions)                                  | responsive `height`, `legend.maxRows` (§ Charts)                                   | `height` reaches the kinds; `maxRows` beats the `fill` fit (§ Charts) | —      | container-class tier + `height` keys (§ 1.31.0)                                                       | —                                                                         | `ResponsiveChartHeight` `sm` → key (§ Container recipes)                                                        | —                                                                             | —                                  | —      | —      | —                                                                                            | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **shell** (`.`)               | —                                                            | scrollport, region seams, **the brand left the sidebar** (§§ scrollport, brand, Shell) | `PageTitle`, `BasaltDevDock`, `useBreakpoint` (§ Additions)                                    | More popover, aside pill, the responsive gutter, `useBasaltSpacing` (§ Chrome)     | —                                                                     | —      | `theme.breakpoints` derived, `useSizeClass`, `data-basalt-host`, `useBreakpoint` on notice (§ 1.31.0) | `useBreakpoint` removal → 1.33.0; `useSizeClass` is shell-only (§ 1.32.0) | shell-less `shell/` gutter, `AppShell` breakpoints, `useSizeClass` for overlays (§§ Shell-less, `useSizeClass`) | —                                                                             | `useBreakpoint` removed (§ 1.34.0) | —      | —      | `useCoarsePointer()` (§ `useCoarsePointer()`)                                                | —      | —      | —      | —      |        | content gutter 16, block 8 from `sm` (§ 1.38.1) | —      | —      | —      | —      | —          | —   |
-| **controls** (`./controls`)   | `NumberFilter`, `field.number` (§ Controls)                  | sheet renders panel rows; `PanelRow`, `SliderControl` (§ `basalt-ui/controls`)         | —                                                                                              | —                                                                                  | —                                                                     | —      | —                                                                                                     | —                                                                         | —                                                                                                               | `NumberFilter clearable`; `createSearchStore` `resets` (§ State and controls) | —                                  | —      | —      | `FormSection`/`FormRow`/`FormGroup`/`FormActions` move here (§ The form layout moves)        | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **forms** (`./forms`)         | —                                                            | `field` → `inputProps`, **`inputProps` drops `key`**, the layout tier (§ `inputProps`) | `field` DELETED — and the `--fix` recipe no longer works (§ Consolidation)                     | —                                                                                  | —                                                                     | —      | —                                                                                                     | —                                                                         | `FormGroup` row no longer stretches (§ Fixes)                                                                   | —                                                                             | —                                  | —      | —      | the layout + `useForm`/`schemaResolver` deprecated, removed 1.37.0 (§ The form layout moves) | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **data** (`./data/table`)     | —                                                            | root is a `<div>`, row selection, `getItemKey` required (§ `basalt-ui/data`)           | `./data` + `./query` + `./connectivity` dropped (§ Consolidation)                              | —                                                                                  | —                                                                     | —      | —                                                                                                     | —                                                                         | `renderCard` documented (§ `renderCard`)                                                                        | —                                                                             | —                                  | —      | —      | —                                                                                            | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **dashboard** (`.`)           | `StatCard`: `unit`, `breakdown`, delta format (§ `StatCard`) | `StatGroup`, `WidgetGrid`, query-aware `StatCard` — additive                           | —                                                                                              | **the column law keys on the CONTAINER; `cols={4}` is 2-up at `sm`** (§ Dashboard) | —                                                                     | —      | —                                                                                                     | —                                                                         | —                                                                                                               | —                                                                             | —                                  | —      | —      | —                                                                                            | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **toolchain** (`./configs/*`) | —                                                            | —                                                                                      | the shipped lefthook preset's `check-theme` BROKE — the CLI resolver stopped ascending (§ CLI) | the preset's default bin, and the `root:` recipe (§ Toolchain)                     | —                                                                     | —      | —                                                                                                     | —                                                                         | —                                                                                                               | —                                                                             | —                                  | —      | —      | —                                                                                            | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **CLI** (`basalt-ui`)         | —                                                            | —                                                                                      | **resolver stops relocating; `doctor` loses 6 of 10 checks** (§ CLI)                           | —                                                                                  | —                                                                     | —      | —                                                                                                     | —                                                                         | —                                                                                                               | —                                                                             | —                                  | —      | —      | —                                                                                            | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
-| **guards**                    | five rules → `error` (§ Guards)                              | six new ids at `warn` (§ preamble)                                                     | `query-dual-import` retired in 1.29.1 (§ Guards)                                               | four rules → `error` (§ Guards)                                                    | —                                                                     | —      | —                                                                                                     | `raw-breakpoint`: the container-grid answer, `error` at 1.33.0 (§ 1.32.0) | `FormRow`/`FormGroup` homes in both lanes; `basalt-main` dropped (§ Fixes)                                      | C1 + breakpoint pairs → `error`; `unknown-vx-token` `warn` (§ Guards)         | —                                  | —      | —      | `unknown-vx-token` → `error`; the token factories throw (§ Guards)                           | —      | —      | —      | —      | —      | —                                               | —      | —      | —      | —      | —          |
+| Surface | 1.27.0 | 1.28.0 | 1.29.0 | 1.30.0 | 1.30.1 | 1.30.2 | 1.31.0 | 1.32.0 | 1.32.1 | 1.33.0 | 1.34.0 | 1.34.1 | 1.35.0 | 1.36.0 | 1.36.1 | 1.37.0 | 1.37.1 | 1.38.0 | 1.38.1 | 1.39.0 | 1.40.0 | 1.40.1 | 1.40.2 | 1.40.3 | 1.41.0 | 2.0.0 | Unreleased |
+| ----------------------------- | ------------------------------------------------------------ | -------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | --------------------------------------------------------------------- | ------ | ----------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------- | ---------------------------------- | ------ | ------ | -------------------------------------------------------------------------------------------- | ------ | ------ | ------ | ------ | ------ | ----------------------------------------------- | ------ | ------ | ------ | ------ | ------------------------------------------------------------ | ---------- | --- | --- |
+| **tokens** (`./tokens`) | — | `--vx-divider` → `rgba()` on both schemes (§ Shell) | `--vx-space-touch-target` added (§ Additions) | eight spacing numbers (§ Chrome) | — | — | `--vx-hit` replaces the touch vars; `SIZE_CLASSES` (§ 1.31.0) | — | `SIZE_CLASSES`/`CONTAINER_CLASSES` actually exported (§ Fixes) | `CONTAINER_GRID_BREAKPOINTS`; `raw-breakpoint` trusts it (§ 1.33.0) | `CONTAINER_KEYS` (§ 1.34.0) | — | — | — | — | — | — | — | | `appShellInset` 20 → 16 (§ 1.38.1) | — | — | — | — | — | — | — | — |
+| **charts** (`./charts`) | — | phone tier, `curve`, formatters, `state`, log axis (§ preamble) | `ChartState.empty: string`, `AxisBottomNumeric` (§ Additions) | responsive `height`, `legend.maxRows` (§ Charts) | `height` reaches the kinds; `maxRows` beats the `fill` fit (§ Charts) | — | container-class tier + `height` keys (§ 1.31.0) | — | `ResponsiveChartHeight` `sm` → key (§ Container recipes) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **shell** (`.`) | — | scrollport, region seams, **the brand left the sidebar** (§§ scrollport, brand, Shell) | `PageTitle`, `BasaltDevDock`, `useBreakpoint` (§ Additions) | More popover, aside pill, the responsive gutter, `useBasaltSpacing` (§ Chrome) | — | — | `theme.breakpoints` derived, `useSizeClass`, `data-basalt-host`, `useBreakpoint` on notice (§ 1.31.0) | `useBreakpoint` removal → 1.33.0; `useSizeClass` is shell-only (§ 1.32.0) | shell-less `shell/` gutter, `AppShell` breakpoints, `useSizeClass` for overlays (§§ Shell-less, `useSizeClass`) | — | `useBreakpoint` removed (§ 1.34.0) | — | — | `useCoarsePointer()` (§ `useCoarsePointer()`) | — | — | — | — | | content gutter 16, block 8 from `sm` (§ 1.38.1) | — | — | — | — | — | — | — | — |
+| **controls** (`./controls`) | `NumberFilter`, `field.number` (§ Controls) | sheet renders panel rows; `PanelRow`, `SliderControl` (§ `basalt-ui/controls`) | — | — | — | — | — | — | — | `NumberFilter clearable`; `createSearchStore` `resets` (§ State and controls) | — | — | — | `FormSection`/`FormRow`/`FormGroup`/`FormActions` move here (§ The form layout moves) | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **forms** (`./forms`) | — | `field` → `inputProps`, **`inputProps` drops `key`**, the layout tier (§ `inputProps`) | `field` DELETED — and the `--fix` recipe no longer works (§ Consolidation) | — | — | — | — | — | `FormGroup` row no longer stretches (§ Fixes) | — | — | — | — | the layout + `useForm`/`schemaResolver` deprecated, removed 1.37.0 (§ The form layout moves) | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **data** (`./data/table`) | — | root is a `<div>`, row selection, `getItemKey` required (§ `basalt-ui/data`) | `./data` + `./query` + `./connectivity` dropped (§ Consolidation) | — | — | — | — | — | `renderCard` documented (§ `renderCard`) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **dashboard** (`.`) | `StatCard`: `unit`, `breakdown`, delta format (§ `StatCard`) | `StatGroup`, `WidgetGrid`, query-aware `StatCard` — additive | — | **the column law keys on the CONTAINER; `cols={4}` is 2-up at `sm`** (§ Dashboard) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **toolchain** (`./configs/*`) | — | — | the shipped lefthook preset's `check-theme` BROKE — the CLI resolver stopped ascending (§ CLI) | the preset's default bin, and the `root:` recipe (§ Toolchain) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| **CLI** (`basalt-ui`) | — | — | **resolver stops relocating; `doctor` loses 6 of 10 checks** (§ CLI) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | the managed block moves `CLAUDE.md` → `AGENTS.md` (§ 1.41.0) | — | — |
+| **guards** | five rules → `error` (§ Guards) | six new ids at `warn` (§ preamble) | `query-dual-import` retired in 1.29.1 (§ Guards) | four rules → `error` (§ Guards) | — | — | — | `raw-breakpoint`: the container-grid answer, `error` at 1.33.0 (§ 1.32.0) | `FormRow`/`FormGroup` homes in both lanes; `basalt-main` dropped (§ Fixes) | C1 + breakpoint pairs → `error`; `unknown-vx-token` `warn` (§ Guards) | — | — | — | `unknown-vx-token` → `error`; the token factories throw (§ Guards) | — | — | — | — | — | — | — | — | — | — | — | — | — |
 
 ---
 
+## 2.0.0
+
+Contract: `docs/V2-SPEC.md`. Every removal and move is one row, grouped by area. 1.x is frozen at v1.41.0; 2.0.0 is the only major.
+
+### Upgrading from 1.x
+
+1. Go to `1.41.0` first and clear its deprecations: 2.0 retires the lifecycle, so nothing deprecated survives.
+2. Install `basalt-ui@2` and the now-required peers (§ Subpaths, peers and gates); delete your
+   `@mantine/*/styles.layer.css` imports, because `basalt-ui/styles.css` carries them.
+3. Replace the hand-built root (providers, `QueryClient`, router) with `BasaltProvider` +
+   `createBasaltRouter` (§ Provider and wiring).
+4. Rewrite imports by area, using the tables below. A `move` changes only the specifier.
+5. Run `bunx basalt-ui sync`, then `bunx basalt-ui doctor`, and take the lint findings one at a time.
+
+### AI, content, commands, state and table (`w3/delete-agent-data`)
+
+Subpath folds: `basalt-ui/agent-chat` → `basalt-ui/agent`, `basalt-ui/notifications` → `basalt-ui/commands`, `basalt-ui/data/table` → `basalt-ui/table`. `basalt-ui/data/virtual` is removed. A `move` changes only the import specifier; the name is unchanged.
+
+| Old import                                                | New                  | Why                                                                                                                                                       |
+| --------------------------------------------------------- | -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `basalt-ui/commands`: `defineCommand`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `runCommand`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `CommandMap`                        | deleted              | type removed (`'idle' \| 'submitted' \| 'streaming' \| 'done' \| 'error'`); derive with `NonNullable<ComponentProps<typeof ThreadFeedRow>['liveStatus']>` |
+| `basalt-ui/commands`: `CommandId`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `CommandRunContext`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `defineOverlay`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `registerModalsProvider`            | deleted              | provider-internal (§ 2)                                                                                                                                   |
+| `basalt-ui/commands`: `Overlay`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `OverlayMap`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `OverlayKey`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ConfirmOptions`                    | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ConfirmDeleteOptions`              | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `toSpotlightActions`                | deleted              | provider-internal                                                                                                                                         |
+| `basalt-ui/commands`: `toRouteActions`                    | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `toShortcutList`                    | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `toHotkeyBindings`                  | deleted              | provider-internal (§ 2); § 8 replaces the mirrored hotkey types                                                                                           |
+| `basalt-ui/commands`: `RouteActionItem`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `RouteActionSection`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ToRouteActionsOptions`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ShortcutEntry`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `HotkeyBinding`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ColorScheme`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `ColorSchemeSetter`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `SidebarToggle`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `parseShortcut`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `detectMac`                         | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `formatShortcutDisplay`             | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `useCommandHotkeys`                 | deleted              | provider binds the `defineCommands` registry, Hotkeys 0.13 loaded lazily (§ 2, § 8)                                                                       |
+| `basalt-ui/commands`: `ShortcutsHelpProps`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `BasaltOverlays`                    | deleted              | `BasaltProvider` mounts modals, spotlight, hotkeys, notifications (§ 2)                                                                                   |
+| `basalt-ui/commands`: `BasaltOverlaysProps`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/commands`: `basaltSpotlight`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `openSpotlight`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/commands`: `closeSpotlight`                    | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notify`                       | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifySuccess`                | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyError`                  | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyWarning`                | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyInfo`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyPromise`                | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyUndo`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `notifyUndoable`               | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `NotifyOptions`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotifyPromiseMessages`        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotifyUndoOptions`            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotifyUndoHandle`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `defineNotification`           | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `defineNotifications`          | `basalt-ui/commands` | ./notifications folds into ./commands                                                                                                                     |
+| `basalt-ui/notifications`: `emit`                         | `basalt-ui/commands` | ./notifications folds into ./commands                                                                                                                     |
+| `basalt-ui/notifications`: `resolveAction`                | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `NotificationAction`           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationKind`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationSpec`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationSpecMap`          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationIntent`           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `add`                          | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `markRead`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `markAllRead`                  | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `dismiss`                      | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `dismissAll`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `remove`                       | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `clear`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `needsAttention`               | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `useNotificationHistory`       | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `NotificationActionRef`        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationHistoryItem`      | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationHistoryState`     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `UseNotificationHistoryReturn` | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationBell`             | `basalt-ui/commands` | ./notifications folds into ./commands                                                                                                                     |
+| `basalt-ui/notifications`: `NotificationBellProps`        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/notifications`: `NotificationCenter`           | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/notifications`: `NotificationCenterProps`      | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `BasaltDataTable`                 | `basalt-ui/table`    | ./data/table folds into ./table                                                                                                                           |
+| `basalt-ui/data/table`: `BasaltDataTableProps`            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `BasaltDataTableSlot`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `DataTableAlign`                  | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `DataTableColumnId`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `DataTableColumnPinning`          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `DataTableFacet`                  | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `DataTableFacetOption`            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/data/table`: `createColumnHelper`              | `basalt-ui/table`    | becomes basalt-owned: `createColumnHelper<Row>()` over Table v9 (§ 8)                                                                                     |
+| `basalt-ui/data/virtual`: `BasaltVirtualList`             | deleted              | no consumer; Virtual stays an internal dep of the transcript/table                                                                                        |
+| `basalt-ui/data/virtual`: `BasaltVirtualListHandle`       | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/data/virtual`: `BasaltVirtualListProps`        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/data/virtual`: `BasaltVirtualListSlot`         | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `AgentPartDraft`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `Drafted`                              | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `StartPart`                            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `TextPart`                             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ReasoningPart`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ToolCallState`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `SourcePart`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ErrorPart`                            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `isStartPart`                          | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `isToolCallSettled`                    | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `TERMINAL_TOOL_STATES`                 | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `mergePart`                            | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `withPartIds`                          | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `coalesceParts`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `definePartRenderers`                  | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `narrowAgentPart`                      | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `ConsumerPart`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `PartRenderContext`                    | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `AgentTransport`                       | kept                 | still exported from `basalt-ui/agent` (W9: the DX trial needed it to type a mock or custom transport)                                                     |
+| `basalt-ui/agent`: `ResumableAgentTransport`              | kept                 | still exported from `basalt-ui/agent` (W9: the DX trial needed it to type a mock or custom transport)                                                     |
+| `basalt-ui/agent`: `edenTransport`                        | deleted              | no consumer; `aiSdkTransport` is the one transport (§ 6)                                                                                                  |
+| `basalt-ui/agent`: `isResumable`                          | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `AiSdkTransport`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `AiSdkTransportOptions`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `useAgentStream`                       | deleted              | no consumer; `useAgentThreadRuns` is the one runner                                                                                                       |
+| `basalt-ui/agent`: `StreamStatus`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `UseAgentStreamReturn`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `UseAgentThreadRunsArgs`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `UseAgentThreadRunsReturn`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `PartList`                             | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `PartListProps`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `AgentPartRenderers`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `TextPartRenderer`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ReasoningPartRenderer`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ToolCallPartRenderer`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `SourcePartRenderer`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ErrorPartRenderer`                    | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `BasaltStickToBottom`                  | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `BasaltStickToBottomProps`             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `createChatHistoryStore`               | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `ChatHistoryStore`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ChatHistoryStoreOptions`              | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `createThreadsStore`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `ThreadsStoreOptions`                  | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `heuristicOutcome`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `createAdapterThreadsStore`            | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `threadsStoreAdapterContract`          | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent`: `AdapterThreadsStoreOptions`           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ThreadsStoreAdapter`                  | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent`: `ThreadsStoreAdapterContractCase`      | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadWorkspace`                 | deleted              | no consumer                                                                                                                                               |
+| `basalt-ui/agent-chat`: `ThreadWorkspaceProps`            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadFeed`                      | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `ThreadFeedProps`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadFeedRow`                   | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `ThreadFeedRowProps`              | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `MessageAffordances`              | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `RowHeightProps`                  | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `VirtualizeOptions`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `VirtualizeProps`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadOutcomeCard`               | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent-chat`: `ThreadOutcomeCardProps`          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadDetailPanel`               | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent-chat`: `ThreadDetailPanelProps`          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `Composer`                        | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `ComposerAttachment`              | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ComposerHandle`                  | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `ComposerProps`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ComposerSubmit`                  | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `threadPartRenderers`             | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/agent-chat`: `ThreadTranscript`                | deleted              | no consumer; argo renders turns through `ThreadFeedRow`                                                                                                   |
+| `basalt-ui/agent-chat`: `ThreadTranscriptProps`           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/agent-chat`: `ToolChip`                        | `basalt-ui/agent`    | ./agent-chat folds into ./agent                                                                                                                           |
+| `basalt-ui/agent-chat`: `ToolChipProps`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ProseDensity`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ProseProps`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `CodeBlock`                          | deleted              | rendered by `Markdown` fences; no direct consumer                                                                                                         |
+| `basalt-ui/content`: `CodeBlockProps`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `CalloutProps`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `TableOfContentsProps`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ReadingProgress`                    | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `ReadingProgressProps`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `headingSlug`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `readingTime`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `SlugTracker`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `ReadingTime`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `HeadingAnchor`                      | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `HeadingAnchorProps`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `FenceRenderContext`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `MarkdownContentTrust`               | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `BASALT_SANITIZE_SCHEMA`             | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `SanitizePropertyDefinition`         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `SanitizeSchema`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `MermaidDiagram`                     | deleted              | rendered by `Markdown` fences; no direct consumer                                                                                                         |
+| `basalt-ui/content`: `MermaidDiagramProps`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `blockSplit`                         | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `createMdxComponents`                | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `mdxComponents`                      | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `CreateMdxComponentsOptions`         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleLayoutProps`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleNavTarget`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleCard`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `ArticleGrid`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `ArticleCardProps`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleGridProps`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `filterArticles`                     | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `formatArticleDate`                  | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `sortArticles`                       | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `Article`                            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleFilterQuery`                 | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `ArticleOrder`                       | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `toArticleActions`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `ToArticleActionsOptions`            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `FilterSet`                          | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `MultiSelectFilter`                  | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `ViewTabs`                           | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `FilterSetProps`                     | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `MultiSelectFilterProps`             | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `ViewTabsOption`                     | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `ViewTabsProps`                      | deleted              | duplicate of `./controls`; one import path per symbol                                                                                                     |
+| `basalt-ui/content`: `GuideDrawer`                        | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/content`: `GuideDrawerProps`                   | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/content`: `GuideLinkProps`                     | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `PersistedStateOptions`                | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `readPersistedValue`                   | deleted              | no consumer outside the playground                                                                                                                        |
+| `basalt-ui/state`: `LocalStore`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `FieldLane`                            | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `ResolvedLane`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `ResolveLane`                          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `RangeValue`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `RangeParams`                          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `RangePresets`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `RangeWindows`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `FieldFallback`                        | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `FieldSetOptions`                      | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `MultiField`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `RangeField`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `NumberField`                          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `BooleanField`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `StringField`                          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `AnyField`                             | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `FieldValue`                           | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `FieldOption`                          | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `SearchValues`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+| `basalt-ui/state`: `StoredValues`                         | deleted              | type removed; derive with `ComponentProps`/`Parameters`                                                                                                   |
+
+### Lint (`w9/lint`)
+
+Every `basalt/*` rule is `error` in 2.0.0 (the major is the channel). Edit your `.oxlintrc.json`
+accordingly; an unknown `basalt/<id>` is a hard oxlint config error.
+
+| Rule                                   | Change                                                                                                                                                                                                                           | Consumer action                                                                                                                                                                                                                  |
+| -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `basalt/provider-above-router`         | removed                                                                                                                                                                                                                          | delete it from `.oxlintrc.json`; `BasaltProvider` mounts `RouterProvider`, so the inverted tree cannot be written                                                                                                                |
+| `basalt/page-bar-budget`               | removed                                                                                                                                                                                                                          | delete it; `PageBar.actions` and `Section.actions` are tuple types, so a sixth/second-primary/fourth action is a tsc error. A second `PageBar` in one tree and two filled buttons in one slot are no longer linted               |
+| `basalt/agent-resume-guard`            | removed                                                                                                                                                                                                                          | delete it; `resumeStream` exists only on `useChat`/`Chat`, both banned by `agent-no-raw-usechat`                                                                                                                                 |
+| `basalt/deprecated-export`             | removed                                                                                                                                                                                                                          | delete it; 2.0.0 ships no deprecations, every removal is a row in this file. Returns with the first 2.x deprecation                                                                                                              |
+| `basalt/shadow-basalt-export`          | `warn` → `error`                                                                                                                                                                                                                 | rename the fork to compose the basalt export, or `theme-allow shadow-basalt-export — <why>`                                                                                                                                      |
+| `basalt/agent-no-raw-usechat`          | widened to the `Chat` class                                                                                                                                                                                                      | import `Chat` from neither `@ai-sdk/react` nor `ai/react`; use `useAgentStream` / `useAgentThreadRuns`                                                                                                                           |
+| `basalt/no-dev-helper`                 | new, repo-local only (not in the preset)                                                                                                                                                                                         | none                                                                                                                                                                                                                             |
+| `basalt/no-import-meta-env`            | repo-local only, now enabled                                                                                                                                                                                                     | none                                                                                                                                                                                                                             |
+| `configs/oxlint.json` (generic preset) | the six `react/*` compiler rules (`globals`, `immutability`, `incompatible-library`, `preserve-manual-memoization`, `refs`, `set-state-in-effect`), `no-constant-binary-expression` and `typescript/no-explicit-any` are `error` | fix the findings; to turn one down for a path add `{ "overrides": [{ "files": ["src/legacy/**"], "rules": { "react/refs": "off" } }] }` to your own `.oxlintrc.json`, or write `// oxlint-disable-next-line react/refs -- <why>` |
+
+### Table v9 (`w6/table-v9`)
+
+`BasaltDataTable` runs on `@tanstack/react-table` **9.2.8, exact** (peer and dev pin; 9.3.x waits on the `table-parity` / `table-v9.test` gate).
+
+- Move your own `@tanstack/react-table` to `9.2.8` exact. Raw v8 helpers and `ColumnDef` no longer type-check against `columns`.
+- `createColumnHelper` stays `import { createColumnHelper } from 'basalt-ui/table'` with the same one-generic call, `createColumnHelper<Row>()`. Do not import the helper from `@tanstack/react-table`: its v9 form needs `<TFeatures, TData>`.
+- The table's registry is closed: sort functions `alphanumeric`, `text`, `datetime`, `basic`; filter function `includesString` (global search and facets). A column naming another built-in `sortFn` / `filterFn` falls back to the default with a dev-only warning.
+- The `@tanstack/react-virtual` peer floor moves to `>=3.14.0 <4`.
+- `initialColumnPinning` is logical: `{ left, right }` → `{ start, end }`.
+- `meta.align` / `numeral` / `priority` are typed by the table's own `columnMeta` slot; the global `declare module '@tanstack/react-table'` augmentation is gone, so it no longer leaks into your own TanStack types.
+- The global search now filters 250 ms after the last keystroke; `onGlobalFilterChange` fires at the same moment.
+
+### Transitions (`w7/transitions`)
+
+Contract: `docs/V2-SPEC.md` § 5. React 19.3 is required (`ViewTransition`, `Activity`).
+
+- Route changes animate through the router: `createBasaltRouter` sets `defaultViewTransition` with a direction from your `defineNav` order, only where `:active-view-transition-type()` is supported (Chrome 125 / Safari 18.2 / Firefox 147); elsewhere navigation does not animate. A `<ViewTransition>` around `<Outlet>` never fired (the router commits through `useSyncExternalStore`) and is now an error, `basalt/route-view-transition`: delete it. `<ViewTransition>` stays for in-page changes (`docs/waves/evidence/w10/transitions.md`).
+- `PageAside` folds inside `startTransition` with a `<ViewTransition>` on the region, and the folded body is hidden under `<Activity>` instead of unmounted. Scroll, input values and `useState` survive a fold. A hidden `Activity` runs the body's effect cleanups and re-runs the effects on expand, so a subscribing or streaming child resumes from its own state; whatever an effect set up (timer, socket) is torn down while folded.
+- `ThemeToggle` animates with a CSS transition, not `motion`. `motion` is no longer reached from the package root; it is required only by `basalt-ui/agent`.
+- `styles.css` sets `animation: none` on `::view-transition-group(*)`, `-old(*)` and `-new(*)` under `prefers-reduced-motion: reduce`, and the base theme sets Mantine `respectReducedMotion: true`. A consumer theme that sets `respectReducedMotion: false` opts Mantine's own transitions back out.
+
+### Content streaming (`w8/content-streaming`)
+
+`Markdown` no longer drops a blocked or unfinished image silently: when the `src` is refused (an off-origin image under `contentTrust="untrusted"`, or remend's `streamdown:incomplete-image` placeholder mid-stream) it renders the `alt` text as a plain `<span>` instead of an empty `<span aria-label>`. No `<img>` and no URL reaches the DOM either way. No action needed; a test that asserted the empty span must assert the alt text.
+
+### Agent runtime (`w8/agent-runtime`)
+
+Behavior changes to symbols that stay; no import changes. Contract: V2-SPEC § 6, § 7.
+
+| Symbol                                           | Change                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
+| ------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `ThreadRunState.status`                          | `'submitted' \| 'streaming' \| 'error'`. A fresh turn is `'submitted'` until its first text, reasoning or tool part, so `status === 'streaming'` no longer holds from the send. `NonNullable<ComponentProps<typeof ThreadFeedRow>['liveStatus']>` gains `'submitted'`, and the chat rows treat `'submitted'` and `'streaming'` as live, so `liveStatus={runs.get(id)?.status}` stays correct. For your own liveness check use `run?.status === 'submitted' \|\| run?.status === 'streaming'`. |
+| `ThreadRunState.error` (new), `AgentError` (new) | A failed turn KEEPS its `runs` entry (`status: 'error'`, the parts so far, `error`) until the next `start()`/`retry()` replaces it or `stop()`/`stopAll()` dismisses it. `runs.has(id)` no longer means live: test `run.status`. `onError` still receives the raw thrown value, and now also fires for an abort that `stop()`/supersede/unmount did not issue.                                                                                                                                |
+| `aiSdkTransport` failures                        | A non-2xx response, an `error` chunk and a malformed chunk now reject the stream. They used to end it as if the turn had completed. The run's `error` carries `kind: 'http'` / `'server'` / `'stream'`.                                                                                                                                                                                                                                                                                       |
+| `aiSdkTransport({ transport })` (new form)       | Any AI SDK `ChatTransport<UIMessage>` is used as-is, e.g. a `WebSocketChatTransport`. `{ api, headers?, credentials?, fetch? }` is unchanged.                                                                                                                                                                                                                                                                                                                                                 |
+| `useAgentThreadRuns({ throttle, telemetry })`    | `throttle` (ms, default `100`; pass `0` to commit every part) batches part commits like `useChat`. A completed or failed turn emits one `chat.turn` event (a `stop()`ped turn emits none) to `telemetry`, which defaults to the enclosing `BasaltProvider`'s sink.                                                                                                                                                                                                                            |
+| Optional props of `basalt-ui/agent`              | Every optional prop and field in the public types is `?: T \| undefined`, so a maybe-undefined value (`summary={maybe}`, `Partial<AgentThread>` with `resumeToken: undefined`) compiles under `exactOptionalPropertyTypes`. `undefined` means absent. Drop any omit-destructure or `''` workaround. Exceptions: the `?: never` discriminant markers and optional function parameters, which the option does not govern.                                                                       |
+
+### Root, shell, controls, dashboard, format, forms, tokens, theme (W3 delete-core)
+
+Source of the rows: `docs/waves/v2-surface.md`. A deleted export has no replacement unless the
+row names one; a deleted type is derived with `ComponentProps<typeof X>` / `Parameters<typeof f>[0]`.
+
+Behaviour and type changes (`docs/V2-SPEC.md` §§ 3–4):
+
+| Was                                                               | Now                                                                                                                                                                  |
+| ----------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `<PageBar actions={{ primary, secondary: [...] }} />`             | `actions` is a tuple: the first entry carries `primary: true`, then up to four more (`PageBarActions`); a missing or second primary and a sixth entry are tsc errors |
+| `<Section actions={...} />` taking a `ReactNode` or `BarAction[]` | `actions` is a tuple of at most three `BarAction`s (`SectionActions`); wrap a custom node as `{ key, kind: 'custom', node }`                                         |
+| a filter or tab given `value`, `onChange` or `size`               | still an error, now named: the slots are typed `never` on every filter and `ViewTabs`                                                                                |
+| `createBasaltTheme(_, { radius: number, density: number })`       | `radius` is `-5 … 5`, `density` is `-3 … 3` (literal unions)                                                                                                         |
+| `createBasaltTheme(_, { inputs: 'desktop' })`                     | deleted — four dimensions: `derive`, `fonts`, `radius`, `density`                                                                                                    |
+| `paletteOptions.groups` as a string-keyed record                  | `SeriesGroup[]`: pass what `groupTokens` returned, so the `name-` key is written once                                                                                |
+| `Section` dev warning for a fourth action                         | gone — the tuple type rejects it                                                                                                                                     |
+
+Removed or moved exports (old import → new):
+
+| Was                                                   | Now                                                                                                |
+| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
+| `BasaltProps` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SlotClassNames` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SlotStylesProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `Tone` — `basalt-ui`                                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ToneWithNeutral` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `Tier` — `basalt-ui`                                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `cx` — `basalt-ui`                                    | deleted — no consumer outside the playground                                                       |
+| `SCROLLPORT_ATTRIBUTE` — `basalt-ui`                  | deleted — no consumer outside the playground                                                       |
+| `baseTheme` — `basalt-ui`                             | deleted — provider-internal                                                                        |
+| `cssVariablesResolver` — `basalt-ui`                  | deleted — provider-internal; a second resolver is the misuse it invites                            |
+| `BasaltFontsConfig` — `basalt-ui`                     | deleted — duplicate of ./tokens; one import path per symbol                                        |
+| `CreateBasaltThemeOptions` — `basalt-ui`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `CTL_THEME` — `basalt-ui`                             | deleted — no consumer outside the playground                                                       |
+| `CtlSlot` — `basalt-ui`                               | deleted — no consumer outside the playground                                                       |
+| `CtlSlotProps` — `basalt-ui`                          | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `useBasaltSpacing` — `basalt-ui`                      | deleted — no consumer outside the playground                                                       |
+| `ThemeToggleProps` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ActionGroup` — `basalt-ui`                           | deleted — duplicate of ./controls; one import path per symbol                                      |
+| `BarAction` — `basalt-ui`                             | import from `basalt-ui/controls` instead — duplicate of ./controls; one import path per symbol     |
+| `ActionGroupProps` — `basalt-ui`                      | deleted — duplicate of ./controls; one import path per symbol                                      |
+| `GlobalAction` — `basalt-ui`                          | import from `basalt-ui/controls` instead — duplicate of ./controls; one import path per symbol     |
+| `MOTION_DURATION` — `basalt-ui`                       | deleted — no consumer outside the playground                                                       |
+| `MOTION_SPRING` — `basalt-ui`                         | deleted — no consumer outside the playground                                                       |
+| `MOTION_EASE_STANDARD` — `basalt-ui`                  | deleted — no consumer outside the playground                                                       |
+| `NavCountBadge` — `basalt-ui`                         | deleted — no consumer outside the playground                                                       |
+| `NavCountBadgeProps` — `basalt-ui`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `AppSidebar` — `basalt-ui`                            | deleted — BasaltShell is the one mount (§ 3)                                                       |
+| `SidebarSearch` — `basalt-ui`                         | deleted — BasaltShell search prop                                                                  |
+| `SidebarSearchProps` — `basalt-ui`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarSearchConfig` — `basalt-ui`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarSearchActions` — `basalt-ui`                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarAccount` — `basalt-ui`                        | deleted — BasaltShell account prop                                                                 |
+| `MobileNav` — `basalt-ui`                             | deleted — BasaltShell is the one mount (§ 3)                                                       |
+| `MobileNavProps` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `projectMobileNav` — `basalt-ui`                      | deleted — shell-internal                                                                           |
+| `ProjectMobileNavOptions` — `basalt-ui`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MOBILE_MAX_TABS_DEFAULT` — `basalt-ui`               | deleted — no consumer outside the playground                                                       |
+| `MOBILE_MENU_MAX_DEFAULT` — `basalt-ui`               | deleted — no consumer outside the playground                                                       |
+| `MOBILE_MORE_KEY` — `basalt-ui`                       | deleted — no consumer outside the playground                                                       |
+| `AppBreadcrumbs` — `basalt-ui`                        | deleted — BasaltShell is the one mount (§ 3)                                                       |
+| `AppBreadcrumbsProps` — `basalt-ui`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageBarProps` — `basalt-ui`                          | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageBarSlot` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageAsideProps` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageAsideSlot` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SizeClass` — `basalt-ui`                             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageTitleProps` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PageTitleSlot` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarSection` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarItem` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarBlockItem` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarBlockTone` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarListBlock` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarProgressBlock` — `basalt-ui`                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SidebarCustomBlock` — `basalt-ui`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `NavAnchor` — `basalt-ui`                             | deleted — duplicate of ./router-tanstack; one import path per symbol                               |
+| `NavAnchorProps` — `basalt-ui`                        | deleted — duplicate of ./router-tanstack; one import path per symbol                               |
+| `NavMobilePlacement` — `basalt-ui`                    | deleted — duplicate of ./router-tanstack; one import path per symbol                               |
+| `NavSectionMobile` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MobileNavConfig` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MobileNavGroup` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MobileNavModel` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MobileNavSlot` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MobileNavSurface` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltShellProps` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BrandConfig` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `AppSidebarProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `AccountBadgeTone` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltIdentity` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltRole` — `basalt-ui`                            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltPlan` — `basalt-ui`                            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `AccountMenuItem` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltAccountState` — `basalt-ui`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltAccountActions` — `basalt-ui`                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltAccountProps` — `basalt-ui`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `Slot` — `basalt-ui`                                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `Series` — `basalt-ui`                                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SeriesKey` — `basalt-ui`                             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `AsyncState` — `basalt-ui`                            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `assertNever` — `basalt-ui`                           | deleted — no consumer; x satisfies never needs no import                                           |
+| `StandardSchemaV1` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `createPersistedState` — `basalt-ui`                  | import from `basalt-ui/state` instead — duplicate of ./state; one import path per symbol           |
+| `PersistedStateOptions` — `basalt-ui`                 | deleted — duplicate of ./state; one import path per symbol                                         |
+| `readPersistedValue` — `basalt-ui`                    | deleted — duplicate of ./state; one import path per symbol                                         |
+| `createLocalStore` — `basalt-ui`                      | import from `basalt-ui/state` instead — duplicate of ./state; one import path per symbol           |
+| `LocalStore` — `basalt-ui`                            | deleted — duplicate of ./state; one import path per symbol                                         |
+| `AnyField` — `basalt-ui`                              | deleted — duplicate of ./state; one import path per symbol                                         |
+| `BooleanField` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `EnumField` — `basalt-ui`                             | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldFallback` — `basalt-ui`                         | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldHandle` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldLane` — `basalt-ui`                             | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldOption` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldSetOptions` — `basalt-ui`                       | deleted — duplicate of ./state; one import path per symbol                                         |
+| `FieldValue` — `basalt-ui`                            | deleted — duplicate of ./state; one import path per symbol                                         |
+| `MultiField` — `basalt-ui`                            | deleted — duplicate of ./state; one import path per symbol                                         |
+| `NumberField` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangeField` — `basalt-ui`                            | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangeParams` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangePresets` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangeValue` — `basalt-ui`                            | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangeWindow` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `RangeWindows` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `ResolvedLane` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `ResolveLane` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `SearchValues` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `StoredValues` — `basalt-ui`                          | deleted — duplicate of ./state; one import path per symbol                                         |
+| `StringField` — `basalt-ui`                           | deleted — duplicate of ./state; one import path per symbol                                         |
+| `WidgetHeaderDeltaProps` — `basalt-ui`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetHeaderMetricProps` — `basalt-ui`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetHeaderProps` — `basalt-ui`                     | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetHeaderSlot` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetHeaderTier` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetHeaderTitleProps` — `basalt-ui`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `DeltaBadgeProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `DeltaPolarity` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SectionProps` — `basalt-ui`                          | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SectionSlot` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `StatCardProps` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `StatCardSlot` — `basalt-ui`                          | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetGrid` — `basalt-ui`                            | deleted — no consumer outside the playground                                                       |
+| `WidgetGridCols` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetGridItemProps` — `basalt-ui`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WidgetGridProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `StatGroupCols` — `basalt-ui`                         | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `StatGroupProps` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `EmptyStateProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `EmptyStateSlot` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SettingsSectionProps` — `basalt-ui`                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SettingsSectionSlot` — `basalt-ui`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SettingsRowProps` — `basalt-ui`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SettingsRowSlot` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `DangerZoneProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `QueryState` — `basalt-ui`                            | deleted — router defaultPendingComponent/defaultErrorComponent + suspense queries replace it (§ 2) |
+| `QueryStateProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `QueryStateLike` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `QueryStateSlot` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `QueryStateTier` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `QueryEmptyCopy` — `basalt-ui`                        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `LoadingState` — `basalt-ui`                          | deleted — router defaultPendingComponent (§ 2)                                                     |
+| `LoadingStateProps` — `basalt-ui`                     | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ErrorState` — `basalt-ui`                            | deleted — router defaultErrorComponent (§ 2)                                                       |
+| `ErrorStateProps` — `basalt-ui`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SurfaceSpec` — `basalt-ui`                           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `RuleName` — `basalt-ui`                              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SkillName` — `basalt-ui`                             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `GuardKind` — `basalt-ui`                             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ThreadWorkspace` — `basalt-ui`                       | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadFeed` — `basalt-ui`                            | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadFeedRow` — `basalt-ui`                         | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadOutcomeCard` — `basalt-ui`                     | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadDetailPanel` — `basalt-ui`                     | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `Composer` — `basalt-ui`                              | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `threadPartRenderers` — `basalt-ui`                   | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadTranscript` — `basalt-ui`                      | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ToolChip` — `basalt-ui`                              | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadWorkspaceProps` — `basalt-ui`                  | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadFeedProps` — `basalt-ui`                       | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadFeedRowProps` — `basalt-ui`                    | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadOutcomeCardProps` — `basalt-ui`                | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadDetailPanelProps` — `basalt-ui`                | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ComposerProps` — `basalt-ui`                         | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ComposerSubmit` — `basalt-ui`                        | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ComposerAttachment` — `basalt-ui`                    | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ComposerHandle` — `basalt-ui`                        | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ThreadTranscriptProps` — `basalt-ui`                 | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `MessageAffordances` — `basalt-ui`                    | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `VirtualizeOptions` — `basalt-ui`                     | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `VirtualizeProps` — `basalt-ui`                       | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `RowHeightProps` — `basalt-ui`                        | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `ToolChipProps` — `basalt-ui`                         | deleted — duplicate of ./agent-chat; one import path per symbol                                    |
+| `createAdapterThreadsStore` — `basalt-ui`             | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `createThreadsStore` — `basalt-ui`                    | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `heuristicOutcome` — `basalt-ui`                      | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `threadsStoreAdapterContract` — `basalt-ui`           | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `useAgentThreadRuns` — `basalt-ui`                    | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `AdapterThreadsStoreOptions` — `basalt-ui`            | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `AgentThread` — `basalt-ui`                           | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `AgentOutcome` — `basalt-ui`                          | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ThreadStatus` — `basalt-ui`                          | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ThreadsStore` — `basalt-ui`                          | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ThreadsStoreAdapter` — `basalt-ui`                   | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ThreadsStoreAdapterContractCase` — `basalt-ui`       | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ThreadsStoreOptions` — `basalt-ui`                   | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `OutcomeResolver` — `basalt-ui`                       | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `ChatMessage` — `basalt-ui`                           | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `AgentPart` — `basalt-ui`                             | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `AgentTransport` — `basalt-ui`                        | deleted — duplicate of ./agent; one import path per symbol                                         |
+| `pxRem` — `basalt-ui/tokens`                          | deleted — no consumer outside the playground                                                       |
+| `buildFontsCss` — `basalt-ui/tokens`                  | deleted — provider/CLI-internal                                                                    |
+| `buildRadiusCss` — `basalt-ui/tokens`                 | deleted — provider/CLI-internal                                                                    |
+| `buildDensityCss` — `basalt-ui/tokens`                | deleted — provider/CLI-internal                                                                    |
+| `DEFAULT_DERIVE_CONFIG` — `basalt-ui/tokens`          | deleted — no consumer outside the playground                                                       |
+| `deriveTokens` — `basalt-ui/tokens`                   | deleted — no consumer outside the playground                                                       |
+| `resolveDeriveConfig` — `basalt-ui/tokens`            | deleted — no consumer outside the playground                                                       |
+| `DeriveConfig` — `basalt-ui/tokens`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `DerivedPalette` — `basalt-ui/tokens`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `deriveRadius` — `basalt-ui/tokens`                   | deleted — no consumer outside the playground                                                       |
+| `RadiusValues` — `basalt-ui/tokens`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `deriveSpacing` — `basalt-ui/tokens`                  | deleted — no consumer outside the playground                                                       |
+| `SpaceValues` — `basalt-ui/tokens`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `resolveContainerClass` — `basalt-ui/tokens`          | deleted — no consumer outside the playground                                                       |
+| `SIZE_CLASSES` — `basalt-ui/tokens`                   | deleted — no consumer outside the playground                                                       |
+| `ContainerClass` — `basalt-ui/tokens`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BREAKPOINTS` — `basalt-ui/tokens`                    | deleted — no consumer outside the playground                                                       |
+| `ColorSchemeSelector` — `basalt-ui/tokens`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BuildPaletteOpts` — `basalt-ui/tokens`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltFontsConfig` — `basalt-ui/tokens`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ThemeLabControls` — `basalt-ui/theme-lab`            | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `DeriveControls` — `basalt-ui/theme-lab`              | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `DeriveControlsProps` — `basalt-ui/theme-lab`         | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `applyOverrides` — `basalt-ui/theme-lab`              | deleted — provider applies persisted lab overrides in dev (§ 2) (no longer a subpath)              |
+| `AREA_BOTTOM_VAR` — `basalt-ui/theme-lab`             | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `AREA_TOP_VAR` — `basalt-ui/theme-lab`                | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `COLOR_GROUPS` — `basalt-ui/theme-lab`                | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `loadOverrides` — `basalt-ui/theme-lab`               | deleted — provider applies persisted lab overrides in dev (§ 2) (no longer a subpath)              |
+| `readVar` — `basalt-ui/theme-lab`                     | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `saveOverrides` — `basalt-ui/theme-lab`               | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `ColorGroup` — `basalt-ui/theme-lab`                  | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `ColorTunable` — `basalt-ui/theme-lab`                | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `Overrides` — `basalt-ui/theme-lab`                   | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `ThemeLabControlsProps` — `basalt-ui/theme-lab`       | deleted — dev-only; provider-internal (§ 2) (no longer a subpath)                                  |
+| `BasaltViteOptions` — `basalt-ui/vite`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltAppIcon` — `basalt-ui/vite`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BasaltAppOptions` — `basalt-ui/vite`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `unmatchedExemptPatterns` — `basalt-ui/guard`         | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `guardKindRemedy` — `basalt-ui/guard`                 | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `guardWaiverHint` — `basalt-ui/guard`                 | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `checkSource` — `basalt-ui/guard`                     | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `findAllowAnnotations` — `basalt-ui/guard`            | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `neutralizeAllowAnnotation` — `basalt-ui/guard`       | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `Finding` — `basalt-ui/guard`                         | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GuardConfig` — `basalt-ui/guard`                     | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GuardKind` — `basalt-ui/guard`                       | deleted — duplicate of .; one import path per symbol (no longer a subpath)                         |
+| `GuardSeverity` — `basalt-ui/guard`                   | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `DEFAULT_GUARD_CONFIG` — `basalt-ui/guard`            | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GraceEntry` — `basalt-ui/guard`                      | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GRACE_PERIOD_KINDS` — `basalt-ui/guard`              | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `UnmatchedExemptPattern` — `basalt-ui/guard`          | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `PLUGIN_RULE_IDS` — `basalt-ui/guard`                 | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `WAIVER_ID_ALIASES` — `basalt-ui/guard`               | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GENERATED_HEADER_LINE` — `basalt-ui/guard`           | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `TOKENS_ONLY_DISABLED_KINDS` — `basalt-ui/guard`      | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `GUARD_RULES` — `basalt-ui/guard`                     | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `AllowAnnotationSite` — `basalt-ui/guard`             | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `NEUTRALIZED_ALLOW_TOKEN` — `basalt-ui/guard`         | deleted — CLI-internal; no import consumer (no longer a subpath)                                   |
+| `compact` — `basalt-ui/format`                        | deleted — no consumer outside the playground                                                       |
+| `deltaPct` — `basalt-ui/format`                       | deleted — no consumer outside the playground                                                       |
+| `DeltaPctOptions` — `basalt-ui/format`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `fmtCompact` — `basalt-ui/format`                     | deleted — alias of compact — one name per formatter                                                |
+| `FmtCompactOptions` — `basalt-ui/format`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `fmtCurrency` — `basalt-ui/format`                    | deleted — alias of money                                                                           |
+| `FmtCurrencyOptions` — `basalt-ui/format`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `fmtInt` — `basalt-ui/format`                         | deleted — alias of integer                                                                         |
+| `fmtPercent` — `basalt-ui/format`                     | deleted — alias of percent                                                                         |
+| `FmtPercentOptions` — `basalt-ui/format`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `LocaleOption` — `basalt-ui/format`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `NON_FINITE` — `basalt-ui/format`                     | deleted — no consumer outside the playground                                                       |
+| `clock` — `basalt-ui/format`                          | deleted — no consumer outside the playground                                                       |
+| `ClockOptions` — `basalt-ui/format`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `duration` — `basalt-ui/format`                       | deleted — no consumer outside the playground                                                       |
+| `DurationOptions` — `basalt-ui/format`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `DurationUnit` — `basalt-ui/format`                   | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `RelativeTimeOptions` — `basalt-ui/format`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `WeekdayOptions` — `basalt-ui/format`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `KcalOptions` — `basalt-ui/format`                    | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `KmOptions` — `basalt-ui/format`                      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `UseBasaltFormOptions` — `basalt-ui/forms`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `useFormSubmit` — `basalt-ui/forms`                   | deleted — no consumer outside the playground                                                       |
+| `isFieldErrorEnvelope` — `basalt-ui/forms`            | deleted — no consumer outside the playground                                                       |
+| `FormFieldErrors` — `basalt-ui/forms`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `UseFormSubmitOptions` — `basalt-ui/forms`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `UseFormSubmitReturn` — `basalt-ui/forms`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormStateProvider` — `basalt-ui/forms`               | deleted — no consumer outside the playground                                                       |
+| `useFormState` — `basalt-ui/forms`                    | deleted — no consumer outside the playground                                                       |
+| `FormState` — `basalt-ui/forms`                       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormStateProviderProps` — `basalt-ui/forms`          | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `useFieldArray` — `basalt-ui/forms`                   | deleted — no consumer outside the playground                                                       |
+| `UseFieldArrayReturn` — `basalt-ui/forms`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormErrorSummary` — `basalt-ui/forms`                | deleted — no consumer outside the playground                                                       |
+| `FormErrorSummaryProps` — `basalt-ui/forms`           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `useFormDraft` — `basalt-ui/forms`                    | deleted — no consumer outside the playground                                                       |
+| `DEFAULT_AUTOSAVE_DEBOUNCE_MS` — `basalt-ui/forms`    | deleted — no consumer outside the playground                                                       |
+| `UseFormDraftOptions` — `basalt-ui/forms`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `UseFormDraftReturn` — `basalt-ui/forms`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ActionGroup` — `basalt-ui/controls`                  | deleted — no consumer outside the playground                                                       |
+| `OverflowMenu` — `basalt-ui/controls`                 | deleted — no consumer outside the playground                                                       |
+| `MOBILE_GLOBAL_BAR_MAX` — `basalt-ui/controls`        | deleted — no consumer outside the playground                                                       |
+| `barActionMobile` — `basalt-ui/controls`              | deleted — no consumer outside the playground                                                       |
+| `globalActionMobile` — `basalt-ui/controls`           | deleted — no consumer outside the playground                                                       |
+| `BarActionItem` — `basalt-ui/controls`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BarActionMenu` — `basalt-ui/controls`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `BarActionCustom` — `basalt-ui/controls`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ActionGroupProps` — `basalt-ui/controls`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `OverflowMenuProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `formatAge` — `basalt-ui/controls`                    | deleted — no consumer outside the playground                                                       |
+| `AGE_REFRESH_MS` — `basalt-ui/controls`               | deleted — no consumer outside the playground                                                       |
+| `SyncButtonProps` — `basalt-ui/controls`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ControlGroup` — `basalt-ui/controls`                 | deleted — no consumer outside the playground                                                       |
+| `ControlGroupProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FilterSetProps` — `basalt-ui/controls`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `RangeCustomPickerProps` — `basalt-ui/controls`       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `RangeFilterProps` — `basalt-ui/controls`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `CompareFilter` — `basalt-ui/controls`                | deleted — no consumer outside the playground                                                       |
+| `COMPARE_VALUES` — `basalt-ui/controls`               | deleted — no consumer outside the playground                                                       |
+| `CompareFilterProps` — `basalt-ui/controls`           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `CompareValue` — `basalt-ui/controls`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FilterOption` — `basalt-ui/controls`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SelectFilterEnumProps` — `basalt-ui/controls`        | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SelectFilterProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SelectFilterStringProps` — `basalt-ui/controls`      | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `MultiSelectFilterProps` — `basalt-ui/controls`       | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `NumberFilterOption` — `basalt-ui/controls`           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `NumberFilterProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SearchFilterProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ToggleFilterProps` — `basalt-ui/controls`            | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ViewTabsOption` — `basalt-ui/controls`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `ViewTabsProps` — `basalt-ui/controls`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `PanelRow` — `basalt-ui/controls`                     | deleted — no consumer outside the playground                                                       |
+| `PanelRowProps` — `basalt-ui/controls`                | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `SliderControl` — `basalt-ui/controls`                | deleted — no consumer outside the playground                                                       |
+| `SliderControlProps` — `basalt-ui/controls`           | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormSection` — `basalt-ui/controls`                  | deleted — no consumer outside the playground                                                       |
+| `FormActions` — `basalt-ui/controls`                  | deleted — no consumer outside the playground                                                       |
+| `FormSectionProps` — `basalt-ui/controls`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormSectionSlot` — `basalt-ui/controls`              | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormRowProps` — `basalt-ui/controls`                 | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormRowSlot` — `basalt-ui/controls`                  | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormGroupProps` — `basalt-ui/controls`               | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `FormActionsProps` — `basalt-ui/controls`             | deleted — type only; derive it with `ComponentProps`/`Parameters`                                  |
+| `RangeCustomPickerProps` — `basalt-ui/controls-dates` | deleted — duplicate of ./controls; one import path per symbol                                      |
+
+Still exported from `basalt-ui` in this wave, because the provider, query and dev-dock lanes replace them (V2-SPEC §§ 2, 7): `BasaltProviderProps`, `BasaltErrorBoundary`(`Props`), `BasaltErrorContext`, the `Connectivity*` family, `createBasaltQueryClient`, `BasaltQueryDevtools`, `toErrorMessage`, `errorStatus`, `BasaltDevDock`(`Props`/`Tool`). `BasaltRegister` is also kept: `declare module` augmentation only merges when the entry exports it.
+
+### CLI (`w9/cli`)
+
+`basalt-ui sync` carries a 1.x install forward: untouched rules, skills and the `AGENTS.md` block are rewritten, a locally edited file is reported and left alone (`--force` overwrites it), and the manifest's `basaltVersion` moves. `sync --check` goes green once nothing is stale.
+
+`basalt-ui doctor` gains three hard checks, each failure printing a `Fix:` line:
+
+- `tsconfig-base`: `tsconfig.json` (or a config it references) must extend `basalt-ui/configs/tsconfig.react-app.json` or `tsconfig.base.json`; the 2.0 types assume `strict`, `exactOptionalPropertyTypes` and `noUncheckedIndexedAccess`.
+- `retired-lint-rules`: `.oxlintrc.json` (and local `extends`) sets a `basalt/<id>` the installed plugin no longer registers; delete the entry.
+- `dropped-subpaths`: a source file under `basalt.roots` imports a `basalt-ui/<subpath>` the install's `exports` lacks; reported as `file:line`.
+
+A check that cannot run (an unloadable plugin, an unresolvable `extends`) prints `SKIPPED` and exits non-zero. `doctor` loads the ESM lint plugin with `require`: the bin runs under Bun, and under Node that needs ≥ 20.19 / 22.12. `init` seeds `src/main.tsx` (when absent, with both TanStack peers: `defineNav` rejects every call until its `Register` augmentation exists) and inserts `extends` into the tsconfig that covers `src`. Removed: the pre-1.41 `CLAUDE.md` → `AGENTS.md` block migration; `doctor` still warns about a leftover `CLAUDE.md`, delete its block by hand.
+
+- `init` always seeds `src/main.tsx`, `src/routes/__root.tsx` and `src/lib/nav.tsx`: `@tanstack/react-router` and `@tanstack/react-query` are required peers of `.`, so `--with-router` and `--with-query` are deleted (passing either exits 1).
+- `init` splices the shipped preset into an existing `.oxlintrc.json` by default (a stock create-vite one); `--merge-lint` is deleted and `--no-merge-lint` opts out. A child `plugins` list unions with the preset's, so `jsx-a11y` stays on. A config with comments is left as is and the line names the `extends` to add.
+- `doctor` gains the hard check `app-wiring`: the entry `index.html` loads (default `src/main.tsx`) must mount `BasaltProvider` on a `createBasaltRouter` router, and the TanStack router plugin must be in the vite config (or `src/routeTree.gen.*` exist). A stock create-vite `main.tsx` is kept by `init`, so this is the check that turns red until it matches `agent/templates/main.tpl`.
+- `init` rewrites create-vite's stock `"build": "tsc -b && vite build"` to `vite build && tsc -b` (vite's router plugin generates `routeTree.gen.ts`, which `tsc` needs); any other build script that runs `tsc` is left as is with a one-line advice.
+- The shipped preset sets `react/only-export-components` to `["warn", { "allowExportNames": ["Route"] }]` so TanStack route files stop warning, and `init`'s lint merge adds `"Route"` to your own setting of that rule (its level and other options are kept).
+
+### Charts
+
+Contract: `docs/V2-SPEC.md` § 9. `basalt-ui/charts` moved from visx to TanStack Charts. `@tanstack/charts` `1.1.0` and `d3-scale` `4.0.2` are exact, optional peers of `./charts`; visx is no dependency, peer or re-export. The public surface is `CartesianChart`, `ChartCard`, `chartCursor` and nine kinds (`Lines`, `Bars`, `StackedArea`, `Sparkline`, `BandStrip`, `Donut`, `Heatmap`, `DualPanel`, `MirroredBars`), plus their prop types. `ariaLabel` is required on every chart. The x scale follows the value `x` returns (`Date` → proportional time, which closes 1.x issue #52; `number` → linear; `string` → point or band). Engine marks for `marks` come from the allowed `@tanstack/charts/*` subpaths (`basalt/chart-engine-boundary`); basalt re-exports none.
+
+Lint: `basalt/visx-boundary`, `basalt/visx-tooltip`, `basalt/hand-rolled-plot`, `basalt/chart-legend-literal` and the guard kinds `raw-visx-axis` and `chart-missing-aria-label` are deleted. `basalt/chart-engine-boundary` replaces the first two; the rest have no replacement (the rung and the required prop make them unreachable). A `theme-allow` naming a deleted id waives nothing (an unrecognised id is unknown); delete it. The guard has 26 kinds (was 28), and `profile: 'tokens-only'` disables 16 of them (was 18, the two deleted kinds having been Mantine-coupled). `basalt/chart-in-raw-surface` now names `Lines` and `Sparkline` (was `MultiLine`, `ZonedLine`, `LineSparkline`, `BarSparkline`). New: `basalt/chart-host-single` (repo-local) keeps `@tanstack/charts/react` inside `src/charts/host.tsx`.
+
+| Old import                                              | New                                                                                                                                                                                                                                                                                                       | Why                                                                                                                                            |
+| ------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
+| `basalt-ui/charts`: `LinePath`                          | `lineY` (`@tanstack/charts/line`) in `CartesianChart`'s `marks`, or a `Lines` series                                                                                                                                                                                                                      | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `AreaClosed`                        | `areaY` (`@tanstack/charts/area`) in `marks`, or `ChartSeries.area`                                                                                                                                                                                                                                       | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `AreaStack`                         | `StackedArea`, or `areaY` + `stack` (`@tanstack/charts/stack`) in `marks`                                                                                                                                                                                                                                 | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `Threshold` (the visx component)    | `Lines` `thresholds`, or `differenceY` (`@tanstack/charts/difference`) in `marks`; `Threshold` is now basalt's type for a `thresholds` entry                                                                                                                                                              | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `Bar`                               | `Bars`, or `barY` (`@tanstack/charts/bar`, plus `stack`) in `marks`                                                                                                                                                                                                                                       | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `BarStack`                          | `Bars`, or `barY` (`@tanstack/charts/bar`, plus `stack`) in `marks`                                                                                                                                                                                                                                       | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `BarGroup`                          | `Bars`, or `barY` (`@tanstack/charts/bar`, plus `stack`) in `marks`                                                                                                                                                                                                                                       | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `Line`                              | `ruleX`/`ruleY` (`@tanstack/charts/rule`), `link` (`@tanstack/charts/link`) or `refLines`                                                                                                                                                                                                                 | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `Pie`                               | `Donut`                                                                                                                                                                                                                                                                                                   | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `Group`                             | deleted; marks carry their own position                                                                                                                                                                                                                                                                   | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `GridRows`                          | deleted; `AxisConfig.grid`                                                                                                                                                                                                                                                                                | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `GridColumns`                       | deleted; `AxisConfig.grid`                                                                                                                                                                                                                                                                                | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `scaleLinear`                       | deleted; the x scale follows `x`'s value type; `@tanstack/charts/scales/*` or `d3-scale` (a peer) inside `marks`                                                                                                                                                                                          | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `scaleBand`                         | deleted; the x scale follows `x`'s value type; `@tanstack/charts/scales/*` or `d3-scale` (a peer) inside `marks`                                                                                                                                                                                          | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `scalePoint`                        | deleted; the x scale follows `x`'s value type; `@tanstack/charts/scales/*` or `d3-scale` (a peer) inside `marks`                                                                                                                                                                                          | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `scaleTime`                         | deleted; the x scale follows `x`'s value type; `@tanstack/charts/scales/*` or `d3-scale` (a peer) inside `marks`                                                                                                                                                                                          | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveMonotoneX`                    | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveLinear`                       | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveCatmullRom`                   | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveStep`                         | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveStepAfter`                    | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveStepBefore`                   | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `curveBasis`                        | `ChartSeries.curve`; `d3Curve` from `@tanstack/charts/d3/shape` inside `marks`                                                                                                                                                                                                                            | visx is gone: no dependency, peer or re-export                                                                                                 |
+| `basalt-ui/charts`: `ZonedLine`                         | `Lines`; `getX` + `chartId` → `x`, `isPending` → `state`, `areaFill` → `ChartSeries.area`                                                                                                                                                                                                                 | `ZonedLine` and `MultiLine` merged: zones, x-zones, ref lines and `y2` moved to the rung                                                       |
+| `basalt-ui/charts`: `ZonedLineProps`                    | `LinesProps`                                                                                                                                                                                                                                                                                              | merged with `MultiLine`                                                                                                                        |
+| `basalt-ui/charts`: `ZonedLineThreshold`                | `Threshold`                                                                                                                                                                                                                                                                                               | renamed                                                                                                                                        |
+| `basalt-ui/charts`: `ZonedLineRefLine`                  | `RefLine`                                                                                                                                                                                                                                                                                                 | one reference-line type for every kind                                                                                                         |
+| `basalt-ui/charts`: `BarsRefLine`                       | `RefLine`                                                                                                                                                                                                                                                                                                 | one reference-line type for every kind                                                                                                         |
+| `basalt-ui/charts`: `MultiLine`                         | `Lines`                                                                                                                                                                                                                                                                                                   | merged with `ZonedLine`                                                                                                                        |
+| `basalt-ui/charts`: `MultiLineProps`                    | `LinesProps`                                                                                                                                                                                                                                                                                              | merged with `ZonedLineProps`                                                                                                                   |
+| `basalt-ui/charts`: `Bars`                              | `Bars`, same name, new props: `positiveBars`/`negativeBars`/`getValue(d, key)` → `bars: BarsBar<T>[]` (each with its own `getValue`), `barLayout` → `layout: 'stacked' \| 'grouped'                                                                                \| 'normalized'`, `getX`+`chartId`→`x` | contract change (V2-SPEC § 9.3)                                                                                                                |
+| `basalt-ui/charts`: `BarsProps`                         | kept, reshaped with `Bars`                                                                                                                                                                                                                                                                                | contract change (V2-SPEC § 9.3)                                                                                                                |
+| `basalt-ui/charts`: `BarsBar`                           | kept, reshaped with `Bars`                                                                                                                                                                                                                                                                                | contract change (V2-SPEC § 9.3)                                                                                                                |
+| `basalt-ui/charts`: `BarsLine`                          | kept, reshaped with `Bars`                                                                                                                                                                                                                                                                                | contract change (V2-SPEC § 9.3)                                                                                                                |
+| `basalt-ui/charts`: `StackedArea`                       | `StackedArea`, rebuilt on this engine                                                                                                                                                                                                                                                                     | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `StackedAreaProps`                  | `StackedArea`, rebuilt on this engine                                                                                                                                                                                                                                                                     | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `DualPanel`                         | `DualPanel`, rebuilt on this engine (compiled through `composeViews`)                                                                                                                                                                                                                                     | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `DualPanelProps`                    | `DualPanel`, rebuilt on this engine (compiled through `composeViews`)                                                                                                                                                                                                                                     | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `MirroredBars`                      | `MirroredBars`, rebuilt on this engine                                                                                                                                                                                                                                                                    | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `MirroredBarsProps`                 | `MirroredBars`, rebuilt on this engine                                                                                                                                                                                                                                                                    | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `MirroredBarPane`                   | `MirroredBars`, rebuilt on this engine                                                                                                                                                                                                                                                                    | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `BandStrip`                         | `BandStrip`, rebuilt on this engine                                                                                                                                                                                                                                                                       | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `BandStripProps`                    | `BandStrip`, rebuilt on this engine                                                                                                                                                                                                                                                                       | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `BandStripSeries`                   | `BandStrip`, rebuilt on this engine                                                                                                                                                                                                                                                                       | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `BandSpan`                          | `BandStrip`, rebuilt on this engine                                                                                                                                                                                                                                                                       | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `BandFold`                          | `BandStrip`, rebuilt on this engine                                                                                                                                                                                                                                                                       | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `Donut`                             | `Donut`, rebuilt on this engine                                                                                                                                                                                                                                                                           | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `DonutProps`                        | `Donut`, rebuilt on this engine                                                                                                                                                                                                                                                                           | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `DonutDatum`                        | `Donut`, rebuilt on this engine                                                                                                                                                                                                                                                                           | rebuilt in W5 (props in § 9.3)                                                                                                                 |
+| `basalt-ui/charts`: `Heatmap`                           | `Heatmap`, rebuilt on this engine, unless the 3 bespoke grids are cheaper                                                                                                                                                                                                                                 | no TanStack Charts port in W4; the 1.x kind had no consumer                                                                                    |
+| `basalt-ui/charts`: `HeatmapProps`                      | `Heatmap`, rebuilt on this engine, unless the 3 bespoke grids are cheaper                                                                                                                                                                                                                                 | no TanStack Charts port in W4; the 1.x kind had no consumer                                                                                    |
+| `basalt-ui/charts`: `LineSparkline`                     | `Sparkline`, rebuilt on this engine (`mark: 'line'                                                                                  \| 'bar'`)                                                                                                                                                            | the two sparklines merge; rebuilt in W5 (props in § 9.3)                                                                                       |
+| `basalt-ui/charts`: `BarSparkline`                      | `Sparkline`, rebuilt on this engine (`mark: 'line'                                                                                  \| 'bar'`)                                                                                                                                                            | the two sparklines merge; rebuilt in W5 (props in § 9.3)                                                                                       |
+| `basalt-ui/charts`: `LineSparklineProps`                | `SparklineProps`, rebuilt on this engine                                                                                                                                                                                                                                                                  | the two sparklines merge; rebuilt in W5 (props in § 9.3)                                                                                       |
+| `basalt-ui/charts`: `BarSparklineProps`                 | `SparklineProps`, rebuilt on this engine                                                                                                                                                                                                                                                                  | the two sparklines merge; rebuilt in W5 (props in § 9.3)                                                                                       |
+| `basalt-ui/charts`: `CartesianChart`                    | kept, new contract: `children(ctx)` → `marks(plot)`, `getX` + `chartId` → `x`, `isPending` → `state`, `ariaLabel` is required                                                                                                                                                                             | a definition compiler plus one host (V2-SPEC § 9.2)                                                                                            |
+| `basalt-ui/charts`: `CartesianChartProps`               | kept names, new contract                                                                                                                                                                                                                                                                                  | V2-SPEC § 9.2                                                                                                                                  |
+| `basalt-ui/charts`: `AxisConfig`                        | kept names, new contract                                                                                                                                                                                                                                                                                  | V2-SPEC § 9.2                                                                                                                                  |
+| `basalt-ui/charts`: `PlotContext`                       | kept names, new contract                                                                                                                                                                                                                                                                                  | V2-SPEC § 9.2                                                                                                                                  |
+| `basalt-ui/charts`: `resolveAxisDomain`                 | internal                                                                                                                                                                                                                                                                                                  | the rung owns the y domains                                                                                                                    |
+| `basalt-ui/charts`: `ChartFrame`                        | deleted; the host is private. A bespoke body moves to `CartesianChart` `marks`, a matrix to W5 `Heatmap`                                                                                                                                                                                                  | the engine owns the frame                                                                                                                      |
+| `basalt-ui/charts`: `ChartFrameProps`                   | deleted; the host is private. A bespoke body moves to `CartesianChart` `marks`, a matrix to W5 `Heatmap`                                                                                                                                                                                                  | the engine owns the frame                                                                                                                      |
+| `basalt-ui/charts`: `ChartFrameLegend`                  | deleted; the host is private. A bespoke body moves to `CartesianChart` `marks`, a matrix to W5 `Heatmap`                                                                                                                                                                                                  | the engine owns the frame                                                                                                                      |
+| `basalt-ui/charts`: `PlotRect`                          | deleted; the host is private. A bespoke body moves to `CartesianChart` `marks`, a matrix to W5 `Heatmap`                                                                                                                                                                                                  | the engine owns the frame                                                                                                                      |
+| `basalt-ui/charts`: `resolveLegend`                     | deleted; the host is private. A bespoke body moves to `CartesianChart` `marks`, a matrix to W5 `Heatmap`                                                                                                                                                                                                  | the engine owns the frame                                                                                                                      |
+| `basalt-ui/charts`: `ResponsiveChartHeight`             | kept                                                                                                                                                                                                                                                                                                      | unchanged                                                                                                                                      |
+| `basalt-ui/charts`: `ChartState`                        | kept; the `isPending` alias is deleted (use `state={{ pending }}`)                                                                                                                                                                                                                                        | one state type                                                                                                                                 |
+| `basalt-ui/charts`: `ChartCenter`                       | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartPending`                      | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartEmpty`                        | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartError`                        | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartCenterProps`                  | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartPendingProps`                 | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartEmptyProps`                   | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartErrorProps`                   | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ResolvedChartState`                | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `resolveChartState`                 | internal to the host and `ChartCard`; render a state with the `state` prop                                                                                                                                                                                                                                | the host owns the placeholders                                                                                                                 |
+| `basalt-ui/charts`: `ChartCard`                         | kept                                                                                                                                                                                                                                                                                                      | unchanged                                                                                                                                      |
+| `basalt-ui/charts`: `ChartCardProps`                    | kept                                                                                                                                                                                                                                                                                                      | unchanged                                                                                                                                      |
+| `basalt-ui/charts`: `ChartCardSlot`                     | kept                                                                                                                                                                                                                                                                                                      | unchanged                                                                                                                                      |
+| `basalt-ui/charts`: `ChartCard` `placeholderHeight`     | default is the chart height law (the box an unsized chart takes), no longer `240`; it is a `number                                                                                                                                                                                                        | ResponsiveChartHeight`. Pass the chart's own `height`when it states one, so a`<Suspense>` fallback reserves the final size                     | a pending card is a streamed section's fallback and must take the final box |
+| `basalt-ui/charts`: `Donut` side legend                 | the legend sits beside the ring in a 480px-or-wider container (CSS), no longer when the frame is wider than 1.5 × its height; a stated `height` above 320px now gets the side layout too                                                                                                                  | the layout is a container query, so the server HTML is the hydrated layout                                                                     |
+| `basalt-ui/charts`: `ChartCard` short fold              | a chart that states `height` ≤ 180px marks the card short in the server HTML (subtitle folds, KPI numeral `lg`, header top inset trims); no longer decided from a rendered height under 280px. A body that is not a chart is still measured                                                               | the fold is in the markup, so hydration does not re-fold the header                                                                            |
+| `basalt-ui/charts`: `legend.placement: 'header'` markup | the legend is drawn at the top of the chart body, spaced as the header's legend row; `[data-basalt-legend-slot]` and the legend inside the card's header element are gone, so a selector or test on the slot reads the chart body instead                                                                 | the legend is in the chart's own markup, so it is in the server HTML and the header never grows on hydration                                   |
+| `basalt-ui/charts`: `[data-basalt-chart-legend]` value  | reads `auto` (both swatches render, the container picks none / dots / chips); it was `dots` or `chips`                                                                                                                                                                                                    | the mode is a container query, so the server HTML carries the right legend; read the computed `display` of the swatches for the effective mode |
+| `basalt-ui/charts`: `ChartCursorScope`                  | the `cursorGroup` prop                                                                                                                                                                                                                                                                                    | no provider: one controller per group in a module map                                                                                          |
+| `basalt-ui/charts`: `ChartCursorScopeProps`             | the `cursorGroup` prop                                                                                                                                                                                                                                                                                    | no provider: one controller per group in a module map                                                                                          |
+| `basalt-ui/charts`: `globalCursorStore`                 | `chartCursor(group?)`; read it with `useSyncExternalStore(controller.subscribe, controller.getState, () => null)`                                                                                                                                                                                         | the 1.x store is replaced by TanStack's cursor controller                                                                                      |
+| `basalt-ui/charts`: `createCursorStore`                 | `chartCursor(group?)`; read it with `useSyncExternalStore(controller.subscribe, controller.getState, () => null)`                                                                                                                                                                                         | the 1.x store is replaced by TanStack's cursor controller                                                                                      |
+| `basalt-ui/charts`: `CursorStore`                       | `chartCursor(group?)`; read it with `useSyncExternalStore(controller.subscribe, controller.getState, () => null)`                                                                                                                                                                                         | the 1.x store is replaced by TanStack's cursor controller                                                                                      |
+| `basalt-ui/charts`: `CursorState`                       | `chartCursor(group?)`; read it with `useSyncExternalStore(controller.subscribe, controller.getState, () => null)`                                                                                                                                                                                         | the 1.x store is replaced by TanStack's cursor controller                                                                                      |
+| `basalt-ui/charts`: `useCursorState`                    | `chartCursor(group?)`; read it with `useSyncExternalStore(controller.subscribe, controller.getState, () => null)`                                                                                                                                                                                         | the 1.x store is replaced by TanStack's cursor controller                                                                                      |
+| `basalt-ui/charts`: `useChartCursor`                    | deleted; TanStack focus plus basalt's cursor resolution                                                                                                                                                                                                                                                   | the engine owns the pointer and keyboard model                                                                                                 |
+| `basalt-ui/charts`: `ChartCursor`                       | deleted; TanStack focus plus basalt's cursor resolution                                                                                                                                                                                                                                                   | the engine owns the pointer and keyboard model                                                                                                 |
+| `basalt-ui/charts`: `CursorAnchor`                      | deleted; TanStack focus plus basalt's cursor resolution                                                                                                                                                                                                                                                   | the engine owns the pointer and keyboard model                                                                                                 |
+| `basalt-ui/charts`: `DomainKind`                        | deleted; TanStack focus plus basalt's cursor resolution                                                                                                                                                                                                                                                   | the engine owns the pointer and keyboard model                                                                                                 |
+| `basalt-ui/charts`: `CursorResolution`                  | kept (`'exact'                                                                                                                                                         \| 'nearest'                                                                                \| 'leading'`)                         | unchanged                                                                                                                                      |
+| `basalt-ui/charts`: `Crosshair`                         | deleted; the engine's crosshair, focus ring and keyboard focus                                                                                                                                                                                                                                            | the engine owns the overlay                                                                                                                    |
+| `basalt-ui/charts`: `SeriesDot`                         | deleted; the engine's crosshair, focus ring and keyboard focus                                                                                                                                                                                                                                            | the engine owns the overlay                                                                                                                    |
+| `basalt-ui/charts`: `HoverOverlay`                      | deleted; the engine's crosshair, focus ring and keyboard focus                                                                                                                                                                                                                                            | the engine owns the overlay                                                                                                                    |
+| `basalt-ui/charts`: `AxisBottomDate`                    | deleted; `AxisConfig` (`y`, `y2`), `xTicks`, `formatX`                                                                                                                                                                                                                                                    | the engine draws the guides                                                                                                                    |
+| `basalt-ui/charts`: `AxisBottomNumeric`                 | deleted; `AxisConfig` (`y`, `y2`), `xTicks`, `formatX`                                                                                                                                                                                                                                                    | the engine draws the guides                                                                                                                    |
+| `basalt-ui/charts`: `AxisLeftNumeric`                   | deleted; `AxisConfig` (`y`, `y2`), `xTicks`, `formatX`                                                                                                                                                                                                                                                    | the engine draws the guides                                                                                                                    |
+| `basalt-ui/charts`: `AxisRightNumeric`                  | deleted; `AxisConfig` (`y`, `y2`), `xTicks`, `formatX`                                                                                                                                                                                                                                                    | the engine draws the guides                                                                                                                    |
+| `basalt-ui/charts`: `ZoneRects`                         | deleted; `zones` / `xZones` props take `ZoneSpec` / `XZoneSpec`, which are kept                                                                                                                                                                                                                           | the rung compiles zones                                                                                                                        |
+| `basalt-ui/charts`: `XZoneRects`                        | deleted; `zones` / `xZones` props take `ZoneSpec` / `XZoneSpec`, which are kept                                                                                                                                                                                                                           | the rung compiles zones                                                                                                                        |
+| `basalt-ui/charts`: `AreaGradient`                      | `ChartSeries.area`                                                                                                                                                                                                                                                                                        | the engine owns SVG resources                                                                                                                  |
+| `basalt-ui/charts`: `areaFillUrl`                       | `ChartSeries.area`                                                                                                                                                                                                                                                                                        | the engine owns SVG resources                                                                                                                  |
+| `basalt-ui/charts`: `HatchPattern`                      | deleted; absent-state paint is a flat fill (V2-SPEC § 9 Open item: hatch)                                                                                                                                                                                                                                 | TanStack's SVG resources are gradients and clips only                                                                                          |
+| `basalt-ui/charts`: `hatchFill`                         | deleted; absent-state paint is a flat fill (V2-SPEC § 9 Open item: hatch)                                                                                                                                                                                                                                 | TanStack's SVG resources are gradients and clips only                                                                                          |
+| `basalt-ui/charts`: `hatchSizeFor`                      | deleted; absent-state paint is a flat fill (V2-SPEC § 9 Open item: hatch)                                                                                                                                                                                                                                 | TanStack's SVG resources are gradients and clips only                                                                                          |
+| `basalt-ui/charts`: `ChartTooltipFloat`                 | deleted; rows are `ChartTooltipRow` data from `tooltip.rows(d, { visible, hidden })`, the title is `tooltip.formatHeader(x, d)`                                                                                                                                                                           | the tooltip surface is TanStack's                                                                                                              |
+| `basalt-ui/charts`: `TooltipHeader`                     | deleted; rows are `ChartTooltipRow` data from `tooltip.rows(d, { visible, hidden })`, the title is `tooltip.formatHeader(x, d)`                                                                                                                                                                           | the tooltip surface is TanStack's                                                                                                              |
+| `basalt-ui/charts`: `TooltipRow`                        | deleted; rows are `ChartTooltipRow` data from `tooltip.rows(d, { visible, hidden })`, the title is `tooltip.formatHeader(x, d)`                                                                                                                                                                           | the tooltip surface is TanStack's                                                                                                              |
+| `basalt-ui/charts`: `TooltipBody`                       | deleted; rows are `ChartTooltipRow` data from `tooltip.rows(d, { visible, hidden })`, the title is `tooltip.formatHeader(x, d)`                                                                                                                                                                           | the tooltip surface is TanStack's                                                                                                              |
+| `basalt-ui/charts`: `CartesianTooltipConfig`            | `ChartTooltipConfig` (one type for every kind)                                                                                                                                                                                                                                                            | `label` / `prependRows` / `extraRows` / `TooltipRow` collapse into `tooltip.rows`                                                              |
+| `basalt-ui/charts`: `CartesianTooltipRowContext`        | `ChartTooltipConfig` (one type for every kind)                                                                                                                                                                                                                                                            | `label` / `prependRows` / `extraRows` / `TooltipRow` collapse into `tooltip.rows`                                                              |
+| `basalt-ui/charts`: `BandTooltipConfig`                 | `ChartTooltipConfig` (one type for every kind)                                                                                                                                                                                                                                                            | `label` / `prependRows` / `extraRows` / `TooltipRow` collapse into `tooltip.rows`                                                              |
+| `basalt-ui/charts`: `BandTooltipRowContext`             | `ChartTooltipConfig` (one type for every kind)                                                                                                                                                                                                                                                            | `label` / `prependRows` / `extraRows` / `TooltipRow` collapse into `tooltip.rows`                                                              |
+| `basalt-ui/charts`: `ChartLegend`                       | internal; an external legend is `legend.placement: 'header'`                                                                                                                                                                                                                                              | legend and tooltip rows derive from `series` inside the host                                                                                   |
+| `basalt-ui/charts`: `LegendEntry`                       | internal; an external legend is `legend.placement: 'header'`                                                                                                                                                                                                                                              | legend and tooltip rows derive from `series` inside the host                                                                                   |
+| `basalt-ui/charts`: `deriveLegend`                      | internal; an external legend is `legend.placement: 'header'`                                                                                                                                                                                                                                              | legend and tooltip rows derive from `series` inside the host                                                                                   |
+| `basalt-ui/charts`: `deriveTooltipRows`                 | internal; an external legend is `legend.placement: 'header'`                                                                                                                                                                                                                                              | legend and tooltip rows derive from `series` inside the host                                                                                   |
+| `basalt-ui/charts`: `ChartLegendConfig`                 | kept; `LegendPlacement` is inlined                                                                                                                                                                                                                                                                        | unchanged shape                                                                                                                                |
+| `basalt-ui/charts`: `LegendPlacement`                   | inlined in `ChartLegendConfig` (`'top'                                                                                                                                 \| 'bottom'                                                                                 \| 'header'`)                          | one legend type                                                                                                                                |
+| `basalt-ui/charts`: `ChartSeries`                       | kept; absorbs `SeriesStyle`, plus `area`                                                                                                                                                                                                                                                                  | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `SeriesStyle`                       | folded into `ChartSeries` (`ChartSeries['curve']`, …)                                                                                                                                                                                                                                                     | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `SeriesMark`                        | folded into `ChartSeries` (`ChartSeries['curve']`, …)                                                                                                                                                                                                                                                     | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `SeriesDash`                        | folded into `ChartSeries` (`ChartSeries['curve']`, …)                                                                                                                                                                                                                                                     | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `SeriesCurve`                       | folded into `ChartSeries` (`ChartSeries['curve']`, …)                                                                                                                                                                                                                                                     | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `SeriesRole`                        | folded into `ChartSeries` (`ChartSeries['curve']`, …)                                                                                                                                                                                                                                                     | one series descriptor                                                                                                                          |
+| `basalt-ui/charts`: `curveFor`                          | internal                                                                                                                                                                                                                                                                                                  | `ChartSeries.curve` is the public seam                                                                                                         |
+| `basalt-ui/charts`: `foldBands`                         | internal                                                                                                                                                                                                                                                                                                  | returns with W5 `BandStrip`                                                                                                                    |
+| `basalt-ui/charts`: `useChartSize`                      | deleted; the host measures the width                                                                                                                                                                                                                                                                      | the host owns sizing                                                                                                                           |
+| `basalt-ui/charts`: `UseChartSizeResult`                | deleted; the host measures the width                                                                                                                                                                                                                                                                      | the host owns sizing                                                                                                                           |
+| `basalt-ui/charts`: `ChartSize`                         | deleted; the host measures the width                                                                                                                                                                                                                                                                      | the host owns sizing                                                                                                                           |
+| `basalt-ui/charts`: `autoMargin`                        | deleted                                                                                                                                                                                                                                                                                                   | TanStack's measured guides own the margins                                                                                                     |
+| `basalt-ui/charts`: `probeAxisLabels`                   | deleted                                                                                                                                                                                                                                                                                                   | TanStack's measured guides own the margins                                                                                                     |
+| `basalt-ui/charts`: `AutoMarginInput`                   | deleted                                                                                                                                                                                                                                                                                                   | TanStack's measured guides own the margins                                                                                                     |
+| `basalt-ui/charts`: `measureText`                       | deleted                                                                                                                                                                                                                                                                                                   | TanStack's measured guides own the margins                                                                                                     |
+| `basalt-ui/charts`: `maxTextWidth`                      | deleted                                                                                                                                                                                                                                                                                                   | TanStack's measured guides own the margins                                                                                                     |
+| `basalt-ui/charts`: `smartTicks`                        | deleted; `xTicks` (a count or the values) plus `tickLabels.thin`; labels never rotate                                                                                                                                                                                                                     | the engine thins colliding labels                                                                                                              |
+| `basalt-ui/charts`: `smartTicksEvery`                   | deleted; `xTicks` (a count or the values) plus `tickLabels.thin`; labels never rotate                                                                                                                                                                                                                     | the engine thins colliding labels                                                                                                              |
+| `basalt-ui/charts`: `xLabelPxFor`                       | deleted; `xTicks` (a count or the values) plus `tickLabels.thin`; labels never rotate                                                                                                                                                                                                                     | the engine thins colliding labels                                                                                                              |
+| `basalt-ui/charts`: `autoXLabelRotate`                  | deleted; `xTicks` (a count or the values) plus `tickLabels.thin`; labels never rotate                                                                                                                                                                                                                     | the engine thins colliding labels                                                                                                              |
+| `basalt-ui/charts`: `chartMargin`                       | deleted; margins are measured, band kinds own their top inset                                                                                                                                                                                                                                             | the engine owns the margins                                                                                                                    |
+| `basalt-ui/charts`: `ChartMargin`                       | deleted; margins are measured, band kinds own their top inset                                                                                                                                                                                                                                             | the engine owns the margins                                                                                                                    |
+| `basalt-ui/charts`: `fmtAxisDate`                       | deleted (also from `basalt-ui/format`); `formatX` and `tooltip.formatHeader` default to the date formats                                                                                                                                                                                                  | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `fmtTooltipDate`                    | deleted (also from `basalt-ui/format`); `formatX` and `tooltip.formatHeader` default to the date formats                                                                                                                                                                                                  | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `fmtCompact`                        | deleted; `AxisConfig.format` defaults to compact numbers                                                                                                                                                                                                                                                  | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `FmtCompactOptions`                 | deleted; `AxisConfig.format` defaults to compact numbers                                                                                                                                                                                                                                                  | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `fmtPercent`                        | `percent` from `basalt-ui/format`                                                                                                                                                                                                                                                                         | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `FmtPercentOptions`                 | `percent` from `basalt-ui/format`                                                                                                                                                                                                                                                                         | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `fmtCurrency`                       | `money` from `basalt-ui/format`                                                                                                                                                                                                                                                                           | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `FmtCurrencyOptions`                | `money` from `basalt-ui/format`                                                                                                                                                                                                                                                                           | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `fmtInt`                            | `integer` from `basalt-ui/format`                                                                                                                                                                                                                                                                         | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `formatters`                        | deleted; `basalt-ui/format`                                                                                                                                                                                                                                                                               | one home for formatters                                                                                                                        |
+| `basalt-ui/charts`: `VX`                                | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `alpha`                             | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `buildPaletteCss`                   | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `seriesTokens`                      | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `defineSeries`                      | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `groupTokens`                       | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `ColorPair`                         | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `SeriesMap`                         | `basalt-ui/tokens` (a move: the name is unchanged)                                                                                                                                                                                                                                                        | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `SeriesKey`                         | `basalt-ui/tokens` or `basalt-ui` (a move: the name is unchanged)                                                                                                                                                                                                                                         | `basalt-ui/charts` re-exports no tokens                                                                                                        |
+| `basalt-ui/charts`: `VxThemeProvider`                   | deleted; every chart paint is a `var(--vx-*)` reference                                                                                                                                                                                                                                                   | no theme context                                                                                                                               |
+| `basalt-ui/charts`: `useVxTheme`                        | deleted; every chart paint is a `var(--vx-*)` reference                                                                                                                                                                                                                                                   | no theme context                                                                                                                               |
+| `basalt-ui/charts`: `VxTheme`                           | deleted; every chart paint is a `var(--vx-*)` reference                                                                                                                                                                                                                                                   | no theme context                                                                                                                               |
+
+### Subpaths, peers and gates (W3 gates)
+
+| 1.41 import                                    | 2.0                          | Reason                                                                              |
+| ---------------------------------------------- | ---------------------------- | ----------------------------------------------------------------------------------- |
+| `basalt-ui/agent-chat`                         | `basalt-ui/agent`            | the chat UI folds into `./agent`; `motion` is subpath-required there                |
+| `basalt-ui/notifications`                      | `basalt-ui/commands`         | no new peer: `BasaltProvider` mounts `Notifications`, `ModalsProvider`, `Spotlight` |
+| `basalt-ui/router-tanstack` (nav half)         | `basalt-ui`                  | nav lives in the root barrel                                                        |
+| `basalt-ui/router-tanstack` (store half)       | `basalt-ui/state`            | stores live with `field` and the search store                                       |
+| `basalt-ui/data/table`                         | `basalt-ui/table`            | renamed; `@tanstack/react-table` is subpath-required                                |
+| `basalt-ui/data/virtual`                       | deleted                      | 0 imports across the fleet                                                          |
+| `basalt-ui/guard`                              | deleted                      | CLI-internal                                                                        |
+| `basalt-ui/theme-lab`                          | deleted                      | provider-mounted in dev                                                             |
+| `basalt-ui/tokens.css`                         | `basalt-ui tokens:css` (CLI) | weatherorb 1.30 and rollhook 1.36 only                                              |
+| `basalt-ui/llms.txt`, `basalt-ui/package.json` | deleted from `exports`       | 0 imports; both files stay in the tarball                                           |
+
+Peers: `react`, `react-dom`, `@mantine/{core,hooks,modals,notifications,spotlight}`,
+`@tanstack/{react-router,react-query}` and the three `@fontsource-variable/*` are now **required**
+(no longer `optional`). `@ai-sdk/provider` (`./agent`) and `dayjs` (`./controls-dates`) are new
+optional, subpath-required peers.
+
+### Provider and wiring
+
+| Old import                                                                         | New / deleted                                                                                                                                                                                                 | Why                                                                               |
+| ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------- |
+| `BasaltProvider` `children`, `onError`, `connectivity` props                       | `router` (required), `telemetry?`, `fallback?`; `theme` defaults to `createBasaltTheme()`                                                                                                                     | the provider mounts the router and every overlay (V2-SPEC § 2)                    |
+| `createBasaltQueryClient` (`basalt-ui`)                                            | `createBasaltRouter({ routeTree, context?, query? })`                                                                                                                                                         | one QueryClient per router, 1.x defaults kept, `query` merges over them           |
+| `BasaltErrorBoundary`, `BasaltErrorBoundaryProps`                                  | deleted: `BasaltProvider fallback` + telemetry `render.error`; routes get `defaultErrorComponent`                                                                                                             | the provider mounts the root boundary                                             |
+| `BasaltErrorContext`                                                               | `BasaltEvent` (type)                                                                                                                                                                                          | `onError` is replaced by the `telemetry` seam (V2-SPEC § 7)                       |
+| `BasaltOverlays`, `useCommandHotkeys` glue (`basalt-ui/commands`)                  | deleted: the provider mounts `ModalsProvider` (wrapping the router), `Notifications`, `Spotlight`, and binds registry hotkeys                                                                                 | no second mount, no `modals={false}` escape                                       |
+| `BasaltQueryDevtools`, `BasaltDevDock`, `BasaltDevDockProps`, `BasaltDevDockTool`  | deleted: the provider mounts one dev dock in dev (router + query devtools, theme lab) behind a literal `NODE_ENV` gate; Spotlight commands `dev.router` / `dev.query` / `dev.theme` open it                   | one dock, never in production                                                     |
+| `ConnectivityProvider`, `ConnectivityIndicator`, `useConnectivity` and their types | deleted                                                                                                                                                                                                       | no consumer; the auto-mount is gone                                               |
+| `toErrorMessage`, `errorStatus` (`basalt-ui`)                                      | deleted                                                                                                                                                                                                       | no consumer outside the playground                                                |
+| `queryClient` seed `agent/templates/query-client.ts.tpl`                           | deleted; `__root.tpl` seeds `createRootRouteWithContext<BasaltRouterContext>()`                                                                                                                               | the router owns the client                                                        |
+| `@mantine/{core,notifications,spotlight}/styles.layer.css` imports in the app      | delete them: `basalt-ui/styles.css` now `@import`s all three, so keeping yours emits the bundle twice. With `basalt-ui/controls-dates`, import `@mantine/dates/styles.layer.css` AFTER `basalt-ui/styles.css` | the provider mounts `Notifications` and `Spotlight`, so their layers ship with it |
+
+### Router bridge (`basalt-ui/router-tanstack`)
+
+| Old import                                                                                                                                                                                                                     | New / deleted                                                                                                                                                                                                                                                                                                                                                                                                                                              | Why                                                                 |
+| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------- |
+| `defineNav`, `navGroup`, `navTarget`, `flattenNav`, `useBasaltNav`, `NavItemId`                                                                                                                                                | move to `basalt-ui`                                                                                                                                                                                                                                                                                                                                                                                                                                        | `./router-tanstack` folds into `.`                                  |
+| `createSearchStore`                                                                                                                                                                                                            | `basalt-ui/state`                                                                                                                                                                                                                                                                                                                                                                                                                                          | the store half folds into `./state`                                 |
+| `field` and the 20 `Field`/`Range*`/`Search*` types re-exported here                                                                                                                                                           | `basalt-ui/state` (same names)                                                                                                                                                                                                                                                                                                                                                                                                                             | one import path per symbol                                          |
+| `defineNav(config)` without the `Register` augmentation                                                                                                                                                                        | compile error: the parameter becomes `'basalt: declare Register { router }'`                                                                                                                                                                                                                                                                                                                                                                               | the definition validated nothing (V2-SPEC § 3)                      |
+| `useRouterBreadcrumbs`, `BasaltBreadcrumb`, `BasaltNav`                                                                                                                                                                        | deleted                                                                                                                                                                                                                                                                                                                                                                                                                                                    | shell-internal / unnamed                                            |
+| `NavItemMeta`, `NavGroupMeta`, `AnyNavItem`, `AnyNavGroup`, `AnyNavLink`, `FlatNavItem`, `NavConfig`, `NavGroupId`, `NavTabId`, `NavIndex`, `UseNavOptions`, `NavBinding`, `NavAnchor`, `NavAnchorProps`, `NavMobilePlacement` | deleted                                                                                                                                                                                                                                                                                                                                                                                                                                                    | no consumer names them; derive with `ComponentProps` / `Parameters` |
+| `useNav`, and `BasaltShell`'s `sections` / `mobileNav` props                                                                                                                                                                   | deleted: pass `nav={NAV}` (plus `badges`, `isActive`, `getScrollElement` — the old `useNav` options) to `BasaltShell`; it resolves the sidebar, the mobile bar and the breadcrumb itself. `mobileNav` tuning moves to `defineNav`'s `mobile`. argo `apps/dashboard/src/routes/__root.tsx`: replace `const nav = useNav(NAV, { badges })` + `{...nav}` with `nav={NAV} badges={…}` (migrates in W12; 1.x consumers stay on their pinned version until then) |
+
 ## Unreleased
 
 _Nothing yet. Author the next section under this heading as `## Unreleased — <title>`; the
 release renames it and opens a new one here._
 
+## 2.0.0
+
+_Nothing to migrate in this release._
+
+## 1.41.0 — the managed block moves to AGENTS.md
+
+**Changed: `init` and `sync` splice the `<!-- basalt:begin … -->` block into `AGENTS.md`, not
+`CLAUDE.md`.** Claude Code loads a repo-root `AGENTS.md` directly, but any `CLAUDE.md` in or above
+the working directory suppresses it — so the block can no longer be the reason a `CLAUDE.md` exists.
+The shipped template is renamed `agent/templates/AGENTS-block.md.tpl`, and the manifest key moves
+from `CLAUDE.md` to `AGENTS.md`.
+
+**Migration is automatic — run `basalt-ui sync` once.** If `CLAUDE.md` carries a basalt block:
+
+- the block is cut out of `CLAUDE.md` and spliced into `AGENTS.md` (created if missing);
+- a `CLAUDE.md` left empty, or holding only `@AGENTS.md`, is deleted; anything else in it is
+  yours and stays — move it into `AGENTS.md` and delete the file, or Claude Code keeps loading
+  `CLAUDE.md` instead of `AGENTS.md`;
+- a hand-edited block is carried over as it is and treated as drift (skipped, reported;
+  `sync --force` restores the shipped text) — the same rule every other managed unit follows;
+- `sync --check` exits 1 until the move has happened, then 0;
+- nothing is discarded silently: if `AGENTS.md` already has a block that differs from the one in
+  `CLAUDE.md`, or either file has duplicate or unterminated markers, `sync` and `sync --check` exit 1
+  naming the file, and both files stay untouched until you resolve it by hand.
+
+`doctor` now warns (never fails) when a project-root `CLAUDE.md` does not import `@AGENTS.md` — it
+suppresses `AGENTS.md` — or still carries a basalt block.
+
 ## 1.40.3
 
 _Nothing to migrate in this release._
@@ -877,7 +1809,7 @@ claim to have already done this was false. **Consumer-visible consequence:** the
 an installed tarball carries its own version number. If it says `Unreleased`, file it.
 
 **§ 1.30.0 § Guards carries a corrected number**, restated here because a published measurement
-moved: meteo is 5 `control-outside-home` incumbents, not 0, and the fleet total is 34, not 29 — the
+moved: weatherorb is 5 `control-outside-home` incumbents, not 0, and the fleet total is 34, not 29 — the
 zero was a failed `npx --no-install oxlint` invocation read as "no findings". The four promotions to
 `error` are unaffected and stand as shipped; only the extended C1 pair's count changed.
 
@@ -1073,23 +2005,23 @@ That measurement was taken 2026-09-09, with all seven consumers freshly migrated
 basalt built from `master`, by running `npx oxlint .` in each repo and counting by rule id — a
 method that failed open in one of them, see the correction under the table:
 
-| Rule                                                              | argo | image-gen | image-share | rb  | linewatch | meteo | obsidian | playground | Verdict      |
-| ----------------------------------------------------------------- | ---- | --------- | ----------- | --- | --------- | ----- | -------- | ---------- | ------------ |
-| `basalt/provider-above-router`                                    | 0    | 0         | 0           | 0   | 0         | 0     | 0        | 0          | → `error`    |
-| `basalt/forms-field-key`                                          | 0    | 0         | 0           | 0   | 0         | 0     | 0        | 0          | → `error`    |
-| `basalt/query-fn-unwrap`                                          | 0    | 0         | 0           | 0   | 0         | 0     | 0        | 0          | → `error`    |
-| `basalt/bound-control-outside-home`                               | 0    | 0         | 0           | 0   | 0         | 0     | 0        | 0          | → `error`    |
-| `basalt/control-outside-home` + `raw-selection-control` (one law) | 2    | 10        | 6           | 8   | 0         | 5     | 0        | 3          | stays `warn` |
+| Rule                                                              | argo | image-gen | image-share | rb  | linewatch | weatherorb | obsidian | playground | Verdict      |
+| ----------------------------------------------------------------- | ---- | --------- | ----------- | --- | --------- | ---------- | -------- | ---------- | ------------ |
+| `basalt/provider-above-router`                                    | 0    | 0         | 0           | 0   | 0         | 0          | 0        | 0          | → `error`    |
+| `basalt/forms-field-key`                                          | 0    | 0         | 0           | 0   | 0         | 0          | 0        | 0          | → `error`    |
+| `basalt/query-fn-unwrap`                                          | 0    | 0         | 0           | 0   | 0         | 0          | 0        | 0          | → `error`    |
+| `basalt/bound-control-outside-home`                               | 0    | 0         | 0           | 0   | 0         | 0          | 0        | 0          | → `error`    |
+| `basalt/control-outside-home` + `raw-selection-control` (one law) | 2    | 10        | 6           | 8   | 0         | 5          | 0        | 3          | stays `warn` |
 
-**Corrected at 1.30.1: meteo is 5, not 0 — the fleet total is 34, not 29.** The zero published at
-1.30.0 was an artifact: meteo has no local oxlint binary, so `npx --no-install oxlint` failed there
+**Corrected at 1.30.1: weatherorb is 5, not 0 — the fleet total is 34, not 29.** The zero published at
+1.30.0 was an artifact: weatherorb has no local oxlint binary, so `npx --no-install oxlint` failed there
 with a package error and the counting pipeline read that failure as "no findings" — the same
 silent-zero shape this file already warns about for `check-theme`'s fabricated roots, arrived at from the other side. The
 five are real (`display-controls.tsx:258`, `stack-editor.tsx:301/323/337`, `forecast-tab.tsx:151`),
 and re-measuring with a guaranteed-present binary is what found them. **The DECISION is unchanged**:
-all four promoted rules re-measured at zero in every repo including meteo, so those four promotions
+all four promoted rules re-measured at zero in every repo including weatherorb, so those four promotions
 stand exactly as shipped — only the extended pair's count moved. A count taken through a repo's own
-`lint` script rather than a bare oxlint invocation is not a measurement; meteo's `lint` is
+`lint` script rather than a bare oxlint invocation is not a measurement; weatherorb's `lint` is
 `basalt-ui check-theme` alone and never runs oxlint at all.
 
 **The four promotions cost nothing to take.** They were measured at zero, in every consumer, before
@@ -1146,7 +2078,7 @@ A patch, one export's TYPE only. Nothing renamed, nothing removed.
 - **`unwrap` strips `null`/`undefined` from a union-typed Eden response again** — the single
   conditional signature 1.29.1 landed still inferred `TData` off `Envelope<infer TData>`, and an Eden
   Treaty response is a UNION of envelopes (`{ data: T; error: null } | { data: null; error:
-EdenFetchError }`), not one envelope with a nullable `data`; inferring through the wrapper type
+  EdenFetchError }`), not one envelope with a nullable `data`; inferring through the wrapper type
   read `T | null` at every Eden call site. `UnwrapResult` now infers the raw `data` field and wraps
   it in `NonNullable`, which distributes over a union `R` — `unwrap(await api.x.get())` resolves to
   `T` again, with no `| null`. Runtime unchanged.
@@ -1220,7 +2152,7 @@ annotation and rationale):
 - `QueryStateVariant` and the `variant` prop on `QueryState`/`LoadingState`/`ErrorState`/`EmptyState`
   — use `QueryStateTier` and `tier`. **Identical values, identical branch behaviour**, verified by
   diffing `src/dashboard/query-state.tsx` at `v1.25.0` against 1.29.2: the union is `'page' |
-'section'` in both, and `'section'` takes the same bare/compact branch in both. A pure rename, so a
+  'section'` in both, and `'section'` takes the same bare/compact branch in both. A pure rename, so a
   `variant="section"` becomes `tier="section"` with nothing to eyeball afterwards.
   `QueryStateTier`'s own JSDoc says "`'section'` meant two different things across the two
   spellings" — that is the NAMING rationale for picking `tier` (audit B #19), not a behaviour
@@ -1262,7 +2194,7 @@ annotation and rationale):
 
 **On notice for 1.30.0** — a public export with exactly one consumer (the playground) as of this
 audit. Adopt-or-delete: gains a real consumer by 1.30.0 or is removed. Not a promise either way;
-record your adoption in `docs/ARGO-MIGRATION-LEARNINGS.md` if you pick one up.
+say so in an issue if you pick one up.
 
 - **Threads/agent-chat composite tier**: `ThreadWorkspace`, `ThreadFeed`, `ThreadFeedRow`,
   `ThreadDetailPanel`, `ThreadOutcomeCard`, `ThreadsStoreAdapter`, `createThreadsStore`,
@@ -1471,7 +2403,7 @@ What is new, one line each — nothing here renames or removes anything:
   FLOORS to 0.75×, shrinks the crosshair dot, narrows the tooltip 140 → 110, and caps the legend at
   two entries with a `+N more` rollup. **This moves rendering, but only below 480px of measured
   width** — nothing at desktop width changes. Opt back out per chart with an explicit
-  `legend.maxRows` / `margin` override. `docs/CHARTS-SPEC.md` §8.
+  `legend.maxRows` / `margin` override. `docs/archive/CHARTS-SPEC.md` §8.
 - **`xLabelRotate` accepts `0`**, and left UNSET now auto-rotates to 45 at the phone tier when the
   measured labels cannot fit three ticks side by side. `0` is the documented opt-out. Also on every
   rotated axis, at every width: the LEFT margin now clears the rotated label's leftward projection
@@ -1480,7 +2412,7 @@ What is new, one line each — nothing here renames or removes anything:
   §1's measured-gutter law, so a rotated or a densely-labelled axis will lay out slightly
   differently; an explicit `margin` / `xTicks` / `xTickValues` still wins.
 - **`SeriesStyle.curve`** (`basalt-ui/charts`) — `'monotone' | 'linear' | 'step' | 'stepAfter' |
-'stepBefore'`, plus the `curveFor` mapper and the newly re-exported `curveStep`/`curveStepBefore`.
+  'stepBefore'`, plus the `curveFor` mapper and the newly re-exported `curveStep`/`curveStepBefore`.
   Default `'monotone'`, which is what every kind hard-coded, so an omitted `curve` moves nothing.
   Honoured by `MultiLine`, `DualPanel`, `ZonedLine`, `StackedArea` and `BarsLine.curve`. Two of
   those read ONE curve for a whole shape rather than one per series: `ZonedLine` takes the PRIMARY
@@ -1580,7 +2512,7 @@ What is new, one line each — nothing here renames or removes anything:
   `QueryStateTier` is the new type name; `QueryStateVariant` stayed exported as an alias through
   1.28.x and is **removed in 1.29.0** together with the `variant` prop (see § Consolidation).
 - **`WidgetHeader` and `QueryState` gained slot classes** — `classNames={{ root, title, metric,
-icon }}` on the first, `classNames={{ root }}` on the second (the branch that is live). Additive.
+  icon }}` on the first, `classNames={{ root }}` on the second (the branch that is live). Additive.
   `Section` now OMITS `classNames` from the `WidgetHeaderProps` it re-publishes, so its slot union
   stays exactly `root | header | body` — a `<Section classNames={{ metric: … }}>` that used to
   type-check (and do nothing) is now a compile error. Reach the header's own slots on a
@@ -1637,10 +2569,10 @@ icon }}` on the first, `classNames={{ root }}` on the second (the branch that is
 - **`overlays.confirm` / `overlays.confirmDelete`** (`basalt-ui/commands`) — the two-button dialog
   every consumer was registering as a `defineOverlays` entry with its own button pair, now
   registry-free: `confirm({ title, body?, confirmLabel?, cancelLabel?, danger?, onConfirm,
-onCancel? })` resolves `true`/`false` and fires exactly one callback, whichever exit the user takes
+  onCancel? })` resolves `true`/`false` and fires exactly one callback, whichever exit the user takes
   (cancel, escape, click-outside and the close button all count as `false`). `danger` paints the
   confirm button in the theme's derived destructive family. `confirmDelete({ subject, count?,
-onConfirm })` is the counted one-liner over it ("Delete 3 items?"). Both REJECT with a named
+  onConfirm })` is the counted one-liner over it ("Delete 3 items?"). Both REJECT with a named
   `[basalt] overlays.confirm: …` error when the `@mantine/modals` peer is absent, or when no
   `ModalsProvider` is live — previously either returned a promise nothing would ever settle, because
   the imperative API is a window event bus with nothing subscribed. `@mantine/modals` stays lazily
@@ -1711,7 +2643,7 @@ onConfirm })` is the counted one-liner over it ("Delete 3 items?"). Both REJECT
   - **Still subpath-only.** The root barrel re-exports none of this, so a consumer without
     `@mantine/form` is unaffected by importing `basalt-ui`.
 - **Mobile "More" sheet rows now 40px with the sidebar's own insets** — `--vx-space-mobile-nav-row-
-height` 44 → 40 (WCAG 2.5.5 AA touch floor, not the AAA figure the bar's own `mobileNavBarHeight`
+  height` 44 → 40 (WCAG 2.5.5 AA touch floor, not the AAA figure the bar's own `mobileNavBarHeight`
   still holds to). The rows themselves no longer force a bespoke touch padding over the theme's
   `NavLink` styling; they now render with the SAME `--vx-space-row-inset-y`/`-x` padding and
   `VX.text.md` the desktop sidebar row does. A nested (child) row gains the sidebar's own child
@@ -2703,7 +3635,7 @@ homes rather than shipped repo-wide. `basalt/shadow-basalt-export` gains a renam
 → `StatCard`), so a fork that RENAMED the export is visible too. It stays a permanent advisory
 `warn`.
 
-**`profile: 'tokens-only'` now disables 18 kinds** — Mantine-coupled kinds, count as of this write (drifts release to release; `TOKENS_ONLY_DISABLED_KINDS.size` in `src/guard/index.ts` is ground truth, this table isn't).
+**`profile: 'tokens-only'` now disables 16 kinds** — Mantine-coupled kinds, count as of this write (drifts release to release; `TOKENS_ONLY_DISABLED_KINDS.size` in `src/guard/index.ts` is ground truth, this table isn't).
 
 **`SURFACES` gains `pluginRules`** (`src/surfaces.ts`, internal — not a published subpath): every
 doctrine surface names the oxlint rules that enforce it, every registered rule maps to exactly one
@@ -2796,7 +3728,7 @@ exact route is never visited still lights on a descendant route.
   `$1294.9k ▲18.9%` rendered as `$129… ▲18.9%`, and truncating the number to protect the delta about
   that number is the wrong way round. A short value still keeps its badge on the line.
 - **`StatCard`'s `actions` slot is the 24px tier now, not 30px.** `CtlSlot` gained `tier?: 'ctl' |
-'widget'` (default `'ctl'`, so no existing call site changes), and `StatCard` mounts its header slot
+  'widget'` (default `'ctl'`, so no existing call site changes), and `StatCard` mounts its header slot
   at `'widget'` — the `size="icon"` step `--vx-space-control-height-widget` has always named as
   "`WidgetHeader tier="widget"` actions". A raw `ActionIcon` there rendered at the 30px `ctl` tier
   inside a 28px header row and grew it to 30, so a KPI card WITH a kebab sat 2px below the card
@@ -3078,7 +4010,7 @@ The shared choreography lives in an internal `useBandPlot` — **not exported**,
 the kinds' contract with each other, not a public seam.
 
 **`MirroredBars` reverses a recorded decision, and the recorded reason for it was wrong.** The old
-entry in `docs/CHARTS-SPEC.md` read _"no two-bar-pane kind with independent per-pane scales"_, with
+entry in `docs/archive/CHARTS-SPEC.md` read _"no two-bar-pane kind with independent per-pane scales"_, with
 _"a second consumer asks"_ as its trigger. That trigger never fired. Round 4 framed the blocker as
 independent SCALES; `DualPanel` already had `topYDomain`/`bottomYDomain`, so that was never it. The
 real blockers are that `DualPanel`'s top pane is a LINE pane and its bottom takes one SIGNED
@@ -3388,7 +4320,7 @@ with the whole lint half off).
 
 | Surface                                                          | Note                                                                                                                                                                                                                                                                                                                                                                                                                                         |
 | ---------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `basalt.profile: 'tokens-only'` / `--tokens-only`                | disables the 18 kinds whose remedy is a Mantine component, prop or the React theme factory. `check-theme` requires it DECLARED; `doctor` infers it, because its profile only changes advice, never enforcement                                                                                                                                                                                                                               |
+| `basalt.profile: 'tokens-only'` / `--tokens-only`                | disables the 16 kinds whose remedy is a Mantine component, prop or the React theme factory. `check-theme` requires it DECLARED; `doctor` infers it, because its profile only changes advice, never enforcement                                                                                                                                                                                                                               |
 | `basalt.include: [...]`                                          | scan a named file outside `roots` — and the only route to a `.json`, which is never blanket-scanned                                                                                                                                                                                                                                                                                                                                          |
 | `basalt.roots` + a `lint:basalt` script                          | written by `init` from the real layout; `init` on an existing app is a lint-debt event, not a no-op                                                                                                                                                                                                                                                                                                                                          |
 | `tokens:css --check`, `--selector-class <c>` (+ `--light-class`) | drift gate; the Tailwind `<html class="dark">` convention. There is no `scheme: { class }` API — the class form is CLI-only                                                                                                                                                                                                                                                                                                                  |