basalt-ui 2.0.4 → 2.0.5

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [2.0.5](https://github.com/jkrumm/basalt-ui/compare/v2.0.4...v2.0.5) (2026-10-14)
+
+
+### Bug Fixes
+
+* fail loudly on a missing subpath peer ([74593b1](https://github.com/jkrumm/basalt-ui/commit/74593b10672e9f294032126598765029600ad937))
+
 ## [2.0.4](https://github.com/jkrumm/basalt-ui/compare/v2.0.3...v2.0.4) (2026-10-14)
 
 

package/MIGRATING.md

@@ -66,18 +66,18 @@ 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 | 1.41.0 | 2.0.0 | 2.0.1 | 2.0.2 | 2.0.3 | 2.0.4 | 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) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
+| 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 | 2.0.1 | 2.0.2 | 2.0.3 | 2.0.4 | 2.0.5 | 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) | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — | — |
 
 ---
 
@@ -992,6 +992,13 @@ optional, subpath-required peers.
 _Nothing yet. Author the next section under this heading as `## Unreleased — <title>`; the
 release renames it and opens a new one here._
 
+## 2.0.5 — subpath peers
+
+- `doctor` gains `subpath-peers`: when your source imports a basalt-ui subpath whose required peers
+  are not installed (e.g. `shiki`, `@shikijs/langs`, `@shikijs/themes` for `basalt-ui/content`) it
+  fails with the `bun add` line to run. Without them the build succeeded and the chunk threw
+  "Could not resolve" at load. `CodeBlock` also warns once in dev when the highlighter cannot load.
+
 ## 2.0.4 — argo table and peer friction
 
 - `BasaltDataTable` `stickyHeader` inside `BasaltShell` now pins flush under the app chrome. The
@@ -1003,10 +1010,6 @@ release renames it and opens a new one here._
   smaller than its label — that is a column width, not a table default.
 - The column-fold toggle column's header cell carries a visually hidden `Details` label instead of
   an empty `aria-hidden` cell.
-- `doctor` gains `subpath-peers`: when your source imports a basalt-ui subpath whose required peers
-  are not installed (e.g. `shiki`, `@shikijs/langs`, `@shikijs/themes` for `basalt-ui/content`) it
-  fails with the `bun add` line to run. Without them the build succeeded and the chunk threw
-  "Could not resolve" at load. `CodeBlock` also warns once in dev when the highlighter cannot load.
 
 ## 2.0.3 — argo shell and CI friction
 

package/dist/cli/doctor-upgrade.d.ts

@@ -40,4 +40,15 @@ export declare function unknownConfigKeysCheck(cwd: string): Check;
  * that is not installed is not this check's business (optional peers are legitimately absent).
  */
 export declare function exactPeersCheck(cwd: string, install: BasaltInstall): Check;
+/**
+ * The peers a subpath needs installed: V2-SPEC § 1's subpath-required class plus `./content`'s
+ * shiki trio, which a bundler cannot resolve without them (argo friction row 15). The test pins it
+ * to `package.json` and `surfaces.ts`.
+ */
+export declare const SUBPATH_REQUIRED_PEERS: Readonly<Record<string, readonly string[]>>;
+/**
+ * `subpath-peers`: every `basalt-ui/<subpath>` the app imports has its required peers installed. A
+ * missing one still builds, then throws "Could not resolve" when the chunk loads.
+ */
+export declare function subpathPeersCheck(cwd: string, cfg: BasaltConfig, install: BasaltInstall): Check;
 //# sourceMappingURL=doctor-upgrade.d.ts.map

package/dist/cli/doctor-upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor-upgrade.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-upgrade.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AAgB9D,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,MACc,CAAA;AA+CvD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAqBpD;AA+CD,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAyBhF;AA4CD,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,aAAa,GACrB,KAAK,CA8BP;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC9D;AAgGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAkCjD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAezD;AAaD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAwB1E"}
+{"version":3,"file":"doctor-upgrade.d.ts","sourceRoot":"","sources":["../../src/cli/doctor-upgrade.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAE5C,MAAM,MAAM,KAAK,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAA;AA6B9D,wEAAwE;AACxE,eAAO,MAAM,YAAY,GAAI,GAAG,MAAM,KAAG,MACc,CAAA;AA+CvD,uFAAuF;AACvF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAqBpD;AA+CD,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAsBhF;AAsDD,mGAAmG;AACnG,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,aAAa,GACrB,KAAK,CAsBP;AAUD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkC9D;AAgGD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAkCjD;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAczD;AAkBD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAgB1E;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,CAQ9E,CAAA;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,aAAa,GAAG,KAAK,CAsB/F"}

package/dist/cli/doctor-upgrade.js

@@ -1,8 +1,8 @@
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { existsSync, writeFileSync } from "node:fs";
 import { createRequire } from "node:module";
 import { dirname, relative, resolve } from "node:path";
 import { BASALT_CONFIG_KEYS, RETIRED_CONFIG_KEYS } from "./config.js";
-import { parseJsonc, readIfExists, scannableFiles } from "./index.js";
+import { parseJsonc, readIfExists, readPackageJson, scannableFiles } from "./index.js";
 const guarded = (id, run) => {
   try {
     return run();
@@ -10,6 +10,10 @@ const guarded = (id, run) => {
     return { skip: `${id}: cannot run (${error.message}).` };
   }
 };
+const withInstall = (id, install, reads, run) => {
+  const { dir } = install;
+  return dir === null ? { skip: `${id}: basalt-ui does not resolve, so its ${reads} cannot be read.` } : guarded(id, () => run(dir));
+};
 const TSCONFIG_PRESET = /(?:^|\/)basalt-ui\/configs\/tsconfig\.(?:base|react-app)\.json$/;
 const TSCONFIG_PRESET_ID = "basalt-ui/configs/tsconfig.react-app.json";
 const TSCONFIG_FIX = `"extends": "${TSCONFIG_PRESET_ID}" (tsconfig.base.json for a package without a DOM)`;
@@ -104,10 +108,7 @@ function basaltRuleIds(file, seen = /* @__PURE__ */ new Set()) {
 }
 function retiredLintRulesCheck(cwd, install) {
   const id = "retired-lint-rules";
-  const dir = install.dir;
-  if (dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its plugin cannot be read.` };
-  return guarded(id, () => {
+  return withInstall(id, install, "plugin", (dir) => {
     const ids = [...new Set(basaltRuleIds(resolve(cwd, ".oxlintrc.json")))];
     if (ids.length === 0) return null;
     const pluginPath = resolve(dir, "configs/oxlint-plugin.js");
@@ -146,26 +147,23 @@ function basaltImports(src) {
   const { code, inLiteral } = tokenize(src);
   return [...code.matchAll(SUBPATH_IMPORT)].filter((m) => !inLiteral(m.index)).map((m) => [m[2], code.slice(0, m.index + m[0].length).split("\n").length]);
 }
+const appImports = (cwd, cfg) => scannableFiles(cwd, cfg).filter((f) => /\.(?:[cm]?[jt]sx?|vue|astro)$/.test(f)).flatMap(
+  (rel) => basaltImports(readIfExists(resolve(cwd, rel)) ?? "").map(
+    ([sub, line]) => [sub, rel, line]
+  )
+);
 function droppedSubpathsCheck(cwd, cfg, install) {
   const id = "dropped-subpaths";
-  const dir = install.dir;
-  if (dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its exports cannot be read.` };
-  return guarded(id, () => {
-    const pkg = JSON.parse(readFileSync(resolve(dir, "package.json"), "utf8"));
-    if (pkg.exports === void 0) return null;
-    const keys = Object.keys(pkg.exports);
+  return withInstall(id, install, "exports", (dir) => {
+    const pkg = readPackageJson(dir);
+    if (pkg === null) throw new Error(`${dir}/package.json is unreadable`);
+    const exportsMap = pkg.exports;
+    if (exportsMap === void 0) return null;
+    const keys = Object.keys(exportsMap);
     const has = (sub) => keys.some(
       (k) => k === `./${sub}` || k.endsWith("*") && `./${sub}`.startsWith(k.slice(0, -1))
     );
-    const hits = [];
-    for (const rel of scannableFiles(cwd, cfg).filter(
-      (f) => /\.(?:[cm]?[jt]sx?|vue|astro)$/.test(f)
-    )) {
-      for (const [sub, line] of basaltImports(readIfExists(resolve(cwd, rel)) ?? "")) {
-        if (!has(sub)) hits.push(`${rel}:${line} imports basalt-ui/${sub}`);
-      }
-    }
+    const hits = appImports(cwd, cfg).filter(([sub]) => !has(sub)).map(([sub, rel, line]) => `${rel}:${line} imports basalt-ui/${sub}`);
     if (hits.length === 0) return null;
     const more = hits.length > 10 ? ` (+${hits.length - 10} more)` : "";
     return {
@@ -297,8 +295,7 @@ function appWiringCheck(cwd) {
 }
 function unknownConfigKeysCheck(cwd) {
   return guarded("config-keys", () => {
-    const raw = readIfExists(resolve(cwd, "package.json"));
-    const block = raw === null ? null : JSON.parse(raw).basalt;
+    const block = readPackageJson(cwd)?.basalt;
     if (typeof block !== "object" || block === null || Array.isArray(block)) return null;
     const known = new Set(BASALT_CONFIG_KEYS);
     const unknown = Object.keys(block).filter((k) => !known.has(k));
@@ -311,23 +308,21 @@ function unknownConfigKeysCheck(cwd) {
     };
   });
 }
+function peerRanges(dir) {
+  return readPackageJson(dir)?.peerDependencies ?? {};
+}
 const EXACT_VERSION = /^\d+\.\d+\.\d+$/;
 function installedVersion(cwd, pkg) {
   for (let dir = cwd; ; dir = dirname(dir)) {
-    const raw = readIfExists(resolve(dir, "node_modules", pkg, "package.json"));
-    if (raw !== null) return JSON.parse(raw).version ?? null;
+    const manifest = readPackageJson(resolve(dir, "node_modules", pkg));
+    if (manifest !== null) return manifest.version ?? null;
     if (dirname(dir) === dir) return null;
   }
 }
 function exactPeersCheck(cwd, install) {
   const id = "exact-peers";
-  if (install.dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its peers cannot be read.` };
-  const dir = install.dir;
-  return guarded(id, () => {
-    const raw = readIfExists(resolve(dir, "package.json"));
-    const peers = (raw === null ? {} : JSON.parse(raw).peerDependencies) ?? {};
-    const off = Object.entries(peers).filter(([, range]) => EXACT_VERSION.test(range)).flatMap(([pkg, pin]) => {
+  return withInstall(id, install, "peers", (dir) => {
+    const off = Object.entries(peerRanges(dir)).filter(([, range]) => EXACT_VERSION.test(range)).flatMap(([pkg, pin]) => {
       const have = installedVersion(cwd, pkg);
       return have === null || have === pin ? [] : [`${pkg}@${have} (basalt-ui pins ${pin}): \`bun add ${pkg}@${pin}\``];
     });
@@ -337,12 +332,44 @@ function exactPeersCheck(cwd, install) {
     };
   });
 }
+const SUBPATH_REQUIRED_PEERS = {
+  agent: ["ai", "@ai-sdk/provider", "motion"],
+  charts: ["@tanstack/charts", "d3-scale"],
+  commands: ["@tanstack/react-hotkeys"],
+  content: ["react-markdown", "shiki", "@shikijs/langs", "@shikijs/themes"],
+  "controls-dates": ["@mantine/dates", "dayjs"],
+  forms: ["@mantine/form"],
+  table: ["@tanstack/react-table"]
+};
+function subpathPeersCheck(cwd, cfg, install) {
+  const id = "subpath-peers";
+  return withInstall(id, install, "peers", (dir) => {
+    const missing = /* @__PURE__ */ new Map();
+    for (const [sub, file] of new Map(
+      appImports(cwd, cfg).toReversed().map(([s, f]) => [s, f])
+    )) {
+      for (const peer of SUBPATH_REQUIRED_PEERS[sub] ?? []) {
+        if (installedVersion(cwd, peer) !== null) continue;
+        missing.set(peer, [...missing.get(peer) ?? [], `basalt-ui/${sub} (${file})`]);
+      }
+    }
+    if (missing.size === 0) return null;
+    const ranges = peerRanges(dir);
+    const named = [...missing].map(([peer, by]) => `${peer} for ${by.join(", ")}`);
+    const add = [...missing.keys()].map((peer) => ranges[peer] ? `${peer}@${ranges[peer]}` : peer);
+    return {
+      fail: `${id}: peers a used basalt-ui subpath requires are not installed: ${named.join("; ")}. Fix: \`bun add ${add.join(" ")}\`.`
+    };
+  });
+}
 export {
+  SUBPATH_REQUIRED_PEERS,
   appWiringCheck,
   droppedSubpathsCheck,
   exactPeersCheck,
   retiredLintRulesCheck,
   seedTsconfigExtends,
+  subpathPeersCheck,
   tsconfigBaseCheck,
   tsconfigFile,
   unknownConfigKeysCheck

package/dist/cli/doctor.d.ts

@@ -22,8 +22,8 @@ export type DoctorResult = {
  *   4. `oxlint-preset`: `.oxlintrc.json` extends the shipped preset AND that path resolves.
  *   7. `ai-major-parity`: the `ai` major agrees across this package.json's dependency fields
  *      (exempt via `basalt.aiMajorSkewReason`; a stale reason warns).
- *   8-13. `tsconfig-base`, `retired-lint-rules`, `dropped-subpaths`, `app-wiring`, `exact-peers`,
- *      `config-keys` (./doctor-upgrade);
+ *   8-14. `tsconfig-base`, `retired-lint-rules`, `dropped-subpaths`, `app-wiring`, `exact-peers`,
+ *      `subpath-peers`, `config-keys` (./doctor-upgrade);
  *      a check that cannot run is SKIPPED and exits non-zero.
  *
  * Warning (non-fatal):

package/dist/cli/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AAyDA,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AA8CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,aAAa,GAAE,MAAsB,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,CAsU1F"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/cli/doctor.ts"],"names":[],"mappings":"AA0DA,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAA;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,OAAO,EAAE,MAAM,CAAA;CAChB,CAAA;AA2BD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,MAAM,CAAC,aAAa,GAAE,MAAsB,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,CAkU1F"}

package/dist/cli/doctor.js

@@ -19,6 +19,7 @@ import {
   readBasaltConfig,
   readIfExists,
   readManifest,
+  readPackageJson,
   resolveAppDir,
   resolveProjectDir,
   ROUTER_SEED_DESTS,
@@ -33,6 +34,7 @@ import {
   droppedSubpathsCheck,
   exactPeersCheck,
   retiredLintRulesCheck,
+  subpathPeersCheck,
   tsconfigBaseCheck,
   unknownConfigKeysCheck
 } from "./doctor-upgrade.js";
@@ -51,27 +53,13 @@ function majorOf(range) {
 }
 const AI_MAJOR_FIELDS = ["dependencies", "devDependencies", "peerDependencies"];
 function aiMajorsAt(dir) {
-  const raw = readIfExists(resolve(dir, "package.json"));
-  if (raw === null) return {};
-  try {
-    const pkg = JSON.parse(raw);
-    const out = {};
-    for (const field of AI_MAJOR_FIELDS) {
-      const major = majorOf(pkg[field]?.["ai"]);
-      if (major !== null) out[field] = major;
-    }
-    return out;
-  } catch {
-    return {};
+  const pkg = readPackageJson(dir) ?? {};
+  const out = {};
+  for (const field of AI_MAJOR_FIELDS) {
+    const major = majorOf(pkg[field]?.["ai"]);
+    if (major !== null) out[field] = major;
   }
-}
-function resolveAiMajorSkewReason(cfg) {
-  const raw = cfg.aiMajorSkewReason;
-  if (raw === void 0) return { reason: null, presentButInvalid: false };
-  if (typeof raw === "string" && raw.trim().length > 0) {
-    return { reason: raw, presentButInvalid: false };
-  }
-  return { reason: null, presentButInvalid: true };
+  return out;
 }
 function doctor(invocationCwd = process.cwd(), flags = []) {
   if (conflictingProfileFlags("doctor", flags)) return 1;
@@ -87,21 +75,10 @@ function doctor(invocationCwd = process.cwd(), flags = []) {
   const lines = [`
 basalt-ui doctor \u2014 ${cwd}
 `];
-  function pass(msg) {
-    lines.push(`  \u2713 ${msg}`);
-  }
-  function warn(msg) {
-    lines.push(`  \u26A0 ${msg}`);
-    result.warnings++;
-  }
-  function fail(msg) {
-    lines.push(`  \u2716 ${msg}`);
-    result.hardFailures++;
-  }
-  function skip(msg) {
-    lines.push(`  ? SKIPPED ${msg}`);
-    result.skipped++;
-  }
+  const pass = (msg) => lines.push(`  \u2713 ${msg}`);
+  const warn = (msg) => lines.push(`  \u26A0 ${msg}`) && result.warnings++;
+  const fail = (msg) => lines.push(`  \u2716 ${msg}`) && result.hardFailures++;
+  const skip = (msg) => lines.push(`  ? SKIPPED ${msg}`) && result.skipped++;
   if (project.relocatedFrom !== null) {
     lines.push(`  \u2192 BASALT_CWD relocated from ${project.relocatedFrom} to ${cwd}.
 `);
@@ -243,7 +220,9 @@ basalt-ui doctor \u2014 ${cwd}
   const aiEntries = AI_MAJOR_FIELDS.filter((field) => aiMajors[field] !== void 0).map(
     (field) => ({ field, major: aiMajors[field] })
   );
-  const { reason: aiMajorSkewReason, presentButInvalid: aiMajorSkewReasonInvalid } = resolveAiMajorSkewReason(cfg);
+  const rawSkewReason = cfg.aiMajorSkewReason;
+  const aiMajorSkewReason = typeof rawSkewReason === "string" && rawSkewReason.trim().length > 0 ? rawSkewReason : null;
+  const aiMajorSkewReasonInvalid = aiMajorSkewReason === null && rawSkewReason !== void 0;
   if (aiEntries.length > 0) {
     const distinctMajors = new Set(aiEntries.map((entry) => entry.major));
     if (distinctMajors.size > 1) {
@@ -294,6 +273,10 @@ basalt-ui doctor \u2014 ${cwd}
         appWiringCheck(appDir)
       ],
       ["exact-peers: installed exact-pinned peers match basalt-ui", exactPeersCheck(cwd, install)],
+      [
+        "subpath-peers: every imported basalt-ui subpath has its required peers installed",
+        subpathPeersCheck(cwd, cfg, install)
+      ],
       [
         "config-keys: the basalt config block sets only keys basalt-ui reads",
         unknownConfigKeysCheck(cwd)

package/dist/cli/index.d.ts

@@ -162,6 +162,8 @@ export declare const AGENTS_MD = "AGENTS.md";
 export declare const LEGACY_BLOCK_HOST = "CLAUDE.md";
 export declare function sha256(text: string): string;
 export declare function readIfExists(abs: string): string | null;
+/** `<dir>/package.json` parsed as `T`; null when absent or not JSON. */
+export declare function readPackageJson<T>(dir: string): T | null;
 /** Read a shipped source asset from the package root; null if the sibling hasn't authored it yet. */
 export declare function readSource(pkgRoot: string, source: string): string | null;
 /** The framework's own published version, read from the package root package.json. */

package/dist/cli/index.d.ts.map

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

package/dist/cli/index.js

@@ -91,20 +91,10 @@ function sanitizeSeverity(cfg) {
   return { ...cfg, severity: kept };
 }
 function hasBasaltKey(cwd) {
-  const raw = readIfExists(resolve(cwd, "package.json"));
-  try {
-    return raw !== null && JSON.parse(raw).basalt !== void 0;
-  } catch {
-    return false;
-  }
+  return readPackageJson(cwd)?.basalt !== void 0;
 }
 function readBasaltConfig(cwd) {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf8"));
-    return sanitizeSeverity(pkg.basalt ?? {});
-  } catch {
-    return {};
-  }
+  return sanitizeSeverity(readPackageJson(cwd)?.basalt ?? {});
 }
 const SCANNABLE_EXT = /\.(?:tsx?|jsx|[cm][jt]s|astro|vue|css|html?|webmanifest)$/;
 function walkSourceFiles(dir, out = []) {
@@ -136,14 +126,11 @@ function relativePosix(fromDir, toPath) {
 const UNRESOLVED_INSTALL = { dir: null, version: null, how: null };
 function basaltInstallAt(dir) {
   const installDir = resolve(dir, "node_modules", "basalt-ui");
-  const raw = readIfExists(resolve(installDir, "package.json"));
-  if (raw === null) return null;
-  try {
-    const pkg = JSON.parse(raw);
-    return { dir: installDir, version: pkg.version ?? null };
-  } catch {
-    return { dir: installDir, version: null };
-  }
+  if (readIfExists(resolve(installDir, "package.json")) === null) return null;
+  return {
+    dir: installDir,
+    version: readPackageJson(installDir)?.version ?? null
+  };
 }
 function findBasaltInstall(cwd) {
   const own = basaltInstallAt(cwd);
@@ -244,24 +231,24 @@ function readIfExists(abs) {
     return null;
   }
 }
+function readPackageJson(dir) {
+  const raw = readIfExists(resolve(dir, "package.json"));
+  try {
+    return raw === null ? null : JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
 function readSource(pkgRoot, source) {
   return readIfExists(resolve(pkgRoot, source));
 }
 function readPackageName(cwd) {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf8"));
-    if (pkg.name && pkg.name.length > 0) return pkg.name;
-  } catch {
-  }
+  const name = readPackageJson(cwd)?.name;
+  if (name && name.length > 0) return name;
   return cwd.split("/").filter(Boolean).pop() ?? "app";
 }
 function readFrameworkVersion(pkgRoot) {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(pkgRoot, "package.json"), "utf8"));
-    return pkg.version ?? "0.0.0";
-  } catch {
-    return "0.0.0";
-  }
+  return readPackageJson(pkgRoot)?.version ?? "0.0.0";
 }
 function basaltBinCommand(install, cwd) {
   if (install.dir === null) return "bunx basalt-ui";
@@ -397,14 +384,10 @@ function resolveAppDir(root) {
   };
 }
 function hasDependency(cwd, pkgName) {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, "package.json"), "utf8"));
-    return Boolean(
-      pkg.dependencies?.[pkgName] ?? pkg.devDependencies?.[pkgName] ?? pkg.peerDependencies?.[pkgName]
-    );
-  } catch {
-    return false;
-  }
+  const pkg = readPackageJson(cwd);
+  return Boolean(
+    pkg?.dependencies?.[pkgName] ?? pkg?.devDependencies?.[pkgName] ?? pkg?.peerDependencies?.[pkgName]
+  );
 }
 const ROOT_PLACEMENT = {
   isPackageRepoRoot: true,
@@ -694,14 +677,8 @@ function renderContext(cwd) {
 function patchPackageJson(cwd, mutate) {
   const abs = resolve(cwd, "package.json");
   const raw = readIfExists(abs);
-  if (raw === null) return false;
-  let pkg;
-  try {
-    pkg = JSON.parse(raw);
-  } catch {
-    return false;
-  }
-  if (!mutate(pkg)) return false;
+  const pkg = readPackageJson(cwd);
+  if (raw === null || pkg === null || !mutate(pkg)) return false;
   const indent = /\n([ \t]+)"/.exec(raw)?.[1] ?? "  ";
   writeFileSync(abs, JSON.stringify(pkg, null, indent) + (raw.endsWith("\n") ? "\n" : ""));
   return true;
@@ -926,14 +903,8 @@ function expandWorkspaceGlobs(cwd, patterns) {
   return dirs;
 }
 function collectWorkspacePackages(cwd) {
-  const raw = readIfExists(resolve(cwd, "package.json"));
-  if (raw === null) return { packages: [], hasWorkspacesField: false };
-  let parsed;
-  try {
-    parsed = JSON.parse(raw);
-  } catch {
-    return { packages: [], hasWorkspacesField: false };
-  }
+  const parsed = readPackageJson(cwd);
+  if (parsed === null) return { packages: [], hasWorkspacesField: false };
   const patterns = isStringArray(parsed.workspaces) ? parsed.workspaces : parsed.workspaces !== null && typeof parsed.workspaces === "object" && isStringArray(parsed.workspaces.packages) ? parsed.workspaces.packages : null;
   if (patterns === null) return { packages: [], hasWorkspacesField: false };
   const rootName = parsed.name && parsed.name.length > 0 ? `${parsed.name} (root)` : "(root)";
@@ -1048,6 +1019,7 @@ export {
   readFrameworkVersion,
   readIfExists,
   readManifest,
+  readPackageJson,
   readSource,
   reconcileRoots,
   relativePosix,

package/dist/content/highlighter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"highlighter.d.ts","sourceRoot":"","sources":["../../src/content/highlighter.ts"],"names":[],"mappings":"AAkGA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBtF"}
+{"version":3,"file":"highlighter.d.ts","sourceRoot":"","sources":["../../src/content/highlighter.ts"],"names":[],"mappings":"AAkHA;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAkBtF"}

package/dist/content/highlighter.js

@@ -37,6 +37,14 @@ const LANG_ALIASES = {
   docker: "dockerfile"
 };
 let highlighterPromise = null;
+let warnedMissingPeer = false;
+function warnMissingPeer(error) {
+  if (warnedMissingPeer || process.env["NODE_ENV"] === "production") return;
+  warnedMissingPeer = true;
+  console.warn(
+    `[basalt] CodeBlock: syntax highlighting is off \u2014 a peer of basalt-ui/content did not load (${error instanceof Error ? error.message : String(error)}). Code renders unhighlighted. Install them with: bun add shiki @shikijs/langs @shikijs/themes`
+  );
+}
 async function loadHighlighter() {
   const [{ createHighlighterCore }, { createJavaScriptRegexEngine }] = await Promise.all([
     import("shiki/core"),
@@ -49,7 +57,10 @@ async function loadHighlighter() {
   });
 }
 function getHighlighter() {
-  highlighterPromise ??= loadHighlighter().catch(() => null);
+  highlighterPromise ??= loadHighlighter().catch((error) => {
+    warnMissingPeer(error);
+    return null;
+  });
   return highlighterPromise;
 }
 async function ensureLanguage(highlighter, lang) {
@@ -59,7 +70,8 @@ async function ensureLanguage(highlighter, lang) {
   try {
     await highlighter.loadLanguage(loadLang());
     return true;
-  } catch {
+  } catch (error) {
+    warnMissingPeer(error);
     return false;
   }
 }

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v2.0.4
+# basalt-ui v2.0.5
 # Opinionated framework for Mantine-based React apps — theme, app shell, TanStack Charts, toolchain presets
 #
 # Entry points: use the exact import specifier below; do not guess.
@@ -13,7 +13,7 @@
 # A subpath's `Install:` line is its required peers; `OptionalPeers:` are import()-only, install on use.
 
 Package: basalt-ui
-Version: 2.0.4
+Version: 2.0.5
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "2.0.4",
+  "version": "2.0.5",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, TanStack Charts, toolchain presets",
   "keywords": [
     "charts",

package/src/cli/doctor-upgrade.ts

@@ -2,13 +2,13 @@
  * `doctor`'s 2.0 strictness and upgrade checks. Each returns null (pass), `{ fail }` (the problem
  * plus its fix) or `{ skip }` (the check could not run: a check that cannot run is not a pass).
  */
-import { existsSync, readFileSync, writeFileSync } from 'node:fs'
+import { existsSync, writeFileSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import { dirname, relative, resolve } from 'node:path'
 
 import { BASALT_CONFIG_KEYS, RETIRED_CONFIG_KEYS } from './config'
 import type { BasaltConfig } from './config'
-import { parseJsonc, readIfExists, scannableFiles } from './index'
+import { parseJsonc, readIfExists, readPackageJson, scannableFiles } from './index'
 import type { BasaltInstall } from './index'
 
 export type Check = { fail: string } | { skip: string } | null
@@ -22,6 +22,19 @@ const guarded = (id: string, run: () => Check): Check => {
   }
 }
 
+/** A check that reads the resolved install: skips when basalt-ui does not resolve. */
+const withInstall = (
+  id: string,
+  install: BasaltInstall,
+  reads: string,
+  run: (dir: string) => Check,
+): Check => {
+  const { dir } = install
+  return dir === null
+    ? { skip: `${id}: basalt-ui does not resolve, so its ${reads} cannot be read.` }
+    : guarded(id, () => run(dir))
+}
+
 const TSCONFIG_PRESET = /(?:^|\/)basalt-ui\/configs\/tsconfig\.(?:base|react-app)\.json$/
 const TSCONFIG_PRESET_ID = 'basalt-ui/configs/tsconfig.react-app.json'
 const TSCONFIG_FIX = `"extends": "${TSCONFIG_PRESET_ID}" (tsconfig.base.json for a package without a DOM)`
@@ -148,10 +161,7 @@ function basaltRuleIds(file: string, seen = new Set<string>()): string[] {
 /** `retired-lint-rules`: `basalt/<id>` entries the installed plugin no longer registers. */
 export function retiredLintRulesCheck(cwd: string, install: BasaltInstall): Check {
   const id = 'retired-lint-rules'
-  const dir = install.dir
-  if (dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its plugin cannot be read.` }
-  return guarded(id, () => {
+  return withInstall(id, install, 'plugin', (dir) => {
     const ids = [...new Set(basaltRuleIds(resolve(cwd, '.oxlintrc.json')))]
     if (ids.length === 0) return null
     const pluginPath = resolve(dir, 'configs/oxlint-plugin.js')
@@ -215,6 +225,16 @@ function basaltImports(src: string): [string, number][] {
     .map((m) => [m[2] as string, code.slice(0, m.index + m[0].length).split('\n').length])
 }
 
+/** `[subpath, file, line]` per `basalt-ui/<subpath>` import in the app's source files. */
+const appImports = (cwd: string, cfg: BasaltConfig): [string, string, number][] =>
+  scannableFiles(cwd, cfg)
+    .filter((f) => /\.(?:[cm]?[jt]sx?|vue|astro)$/.test(f))
+    .flatMap((rel) =>
+      basaltImports(readIfExists(resolve(cwd, rel)) ?? '').map(
+        ([sub, line]): [string, string, number] => [sub, rel, line],
+      ),
+    )
+
 /** `dropped-subpaths`: `basalt-ui/<subpath>` imports the installed `exports` map does not have. */
 export function droppedSubpathsCheck(
   cwd: string,
@@ -222,28 +242,20 @@ export function droppedSubpathsCheck(
   install: BasaltInstall,
 ): Check {
   const id = 'dropped-subpaths'
-  const dir = install.dir
-  if (dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its exports cannot be read.` }
-  return guarded(id, () => {
-    const pkg = JSON.parse(readFileSync(resolve(dir, 'package.json'), 'utf8')) as {
-      exports?: Record<string, unknown>
-    }
+  return withInstall(id, install, 'exports', (dir) => {
+    const pkg = readPackageJson<{ exports?: Record<string, unknown> }>(dir)
+    if (pkg === null) throw new Error(`${dir}/package.json is unreadable`)
+    const exportsMap = pkg.exports
     // No `exports` field means nothing restricts the deep imports.
-    if (pkg.exports === undefined) return null
-    const keys = Object.keys(pkg.exports)
+    if (exportsMap === undefined) return null
+    const keys = Object.keys(exportsMap)
     const has = (sub: string): boolean =>
       keys.some(
         (k) => k === `./${sub}` || (k.endsWith('*') && `./${sub}`.startsWith(k.slice(0, -1))),
       )
-    const hits: string[] = []
-    for (const rel of scannableFiles(cwd, cfg).filter((f) =>
-      /\.(?:[cm]?[jt]sx?|vue|astro)$/.test(f),
-    )) {
-      for (const [sub, line] of basaltImports(readIfExists(resolve(cwd, rel)) ?? '')) {
-        if (!has(sub)) hits.push(`${rel}:${line} imports basalt-ui/${sub}`)
-      }
-    }
+    const hits = appImports(cwd, cfg)
+      .filter(([sub]) => !has(sub))
+      .map(([sub, rel, line]) => `${rel}:${line} imports basalt-ui/${sub}`)
     if (hits.length === 0) return null
     const more = hits.length > 10 ? ` (+${hits.length - 10} more)` : ''
     return {
@@ -446,8 +458,7 @@ export function appWiringCheck(cwd: string): Check {
  */
 export function unknownConfigKeysCheck(cwd: string): Check {
   return guarded('config-keys', () => {
-    const raw = readIfExists(resolve(cwd, 'package.json'))
-    const block = raw === null ? null : (JSON.parse(raw) as { basalt?: unknown }).basalt
+    const block = readPackageJson<{ basalt?: unknown }>(cwd)?.basalt
     if (typeof block !== 'object' || block === null || Array.isArray(block)) return null
     const known = new Set<string>(BASALT_CONFIG_KEYS)
     const unknown = Object.keys(block).filter((k) => !known.has(k))
@@ -461,13 +472,18 @@ export function unknownConfigKeysCheck(cwd: string): Check {
   })
 }
 
+/** The `peerDependencies` ranges declared by the package installed at `dir`. */
+function peerRanges(dir: string): Record<string, string> {
+  return readPackageJson<{ peerDependencies?: Record<string, string> }>(dir)?.peerDependencies ?? {}
+}
+
 const EXACT_VERSION = /^\d+\.\d+\.\d+$/
 
 /** `node_modules/<pkg>/package.json`'s version, searching `cwd` then every ancestor. */
 function installedVersion(cwd: string, pkg: string): string | null {
   for (let dir = cwd; ; dir = dirname(dir)) {
-    const raw = readIfExists(resolve(dir, 'node_modules', pkg, 'package.json'))
-    if (raw !== null) return (JSON.parse(raw) as { version?: string }).version ?? null
+    const manifest = readPackageJson<{ version?: string }>(resolve(dir, 'node_modules', pkg))
+    if (manifest !== null) return manifest.version ?? null
     if (dirname(dir) === dir) return null
   }
 }
@@ -479,16 +495,8 @@ function installedVersion(cwd: string, pkg: string): string | null {
  */
 export function exactPeersCheck(cwd: string, install: BasaltInstall): Check {
   const id = 'exact-peers'
-  if (install.dir === null)
-    return { skip: `${id}: basalt-ui does not resolve, so its peers cannot be read.` }
-  const dir = install.dir
-  return guarded(id, () => {
-    const raw = readIfExists(resolve(dir, 'package.json'))
-    const peers =
-      (raw === null
-        ? {}
-        : (JSON.parse(raw) as { peerDependencies?: Record<string, string> }).peerDependencies) ?? {}
-    const off = Object.entries(peers)
+  return withInstall(id, install, 'peers', (dir) => {
+    const off = Object.entries(peerRanges(dir))
       .filter(([, range]) => EXACT_VERSION.test(range))
       .flatMap(([pkg, pin]) => {
         const have = installedVersion(cwd, pkg)
@@ -502,3 +510,46 @@ export function exactPeersCheck(cwd: string, install: BasaltInstall): Check {
     }
   })
 }
+
+/**
+ * The peers a subpath needs installed: V2-SPEC § 1's subpath-required class plus `./content`'s
+ * shiki trio, which a bundler cannot resolve without them (argo friction row 15). The test pins it
+ * to `package.json` and `surfaces.ts`.
+ */
+export const SUBPATH_REQUIRED_PEERS: Readonly<Record<string, readonly string[]>> = {
+  agent: ['ai', '@ai-sdk/provider', 'motion'],
+  charts: ['@tanstack/charts', 'd3-scale'],
+  commands: ['@tanstack/react-hotkeys'],
+  content: ['react-markdown', 'shiki', '@shikijs/langs', '@shikijs/themes'],
+  'controls-dates': ['@mantine/dates', 'dayjs'],
+  forms: ['@mantine/form'],
+  table: ['@tanstack/react-table'],
+}
+
+/**
+ * `subpath-peers`: every `basalt-ui/<subpath>` the app imports has its required peers installed. A
+ * missing one still builds, then throws "Could not resolve" when the chunk loads.
+ */
+export function subpathPeersCheck(cwd: string, cfg: BasaltConfig, install: BasaltInstall): Check {
+  const id = 'subpath-peers'
+  return withInstall(id, install, 'peers', (dir) => {
+    const missing = new Map<string, string[]>()
+    for (const [sub, file] of new Map(
+      appImports(cwd, cfg)
+        .toReversed()
+        .map(([s, f]) => [s, f]),
+    )) {
+      for (const peer of SUBPATH_REQUIRED_PEERS[sub] ?? []) {
+        if (installedVersion(cwd, peer) !== null) continue
+        missing.set(peer, [...(missing.get(peer) ?? []), `basalt-ui/${sub} (${file})`])
+      }
+    }
+    if (missing.size === 0) return null
+    const ranges = peerRanges(dir)
+    const named = [...missing].map(([peer, by]) => `${peer} for ${by.join(', ')}`)
+    const add = [...missing.keys()].map((peer) => (ranges[peer] ? `${peer}@${ranges[peer]}` : peer))
+    return {
+      fail: `${id}: peers a used basalt-ui subpath requires are not installed: ${named.join('; ')}. Fix: \`bun add ${add.join(' ')}\`.`,
+    }
+  })
+}

package/src/cli/doctor.ts

@@ -6,7 +6,6 @@
 import { existsSync } from 'node:fs'
 import { relative, resolve } from 'node:path'
 
-import type { BasaltConfig } from './config'
 import {
   AGENTS_MD,
   LEGACY_BLOCK_HOST,
@@ -26,6 +25,7 @@ import {
   readBasaltConfig,
   readIfExists,
   readManifest,
+  readPackageJson,
   resolveAppDir,
   resolveProjectDir,
   ROUTER_SEED_DESTS,
@@ -40,6 +40,7 @@ import {
   droppedSubpathsCheck,
   exactPeersCheck,
   retiredLintRulesCheck,
+  subpathPeersCheck,
   tsconfigBaseCheck,
   unknownConfigKeysCheck,
 } from './doctor-upgrade'
@@ -85,32 +86,13 @@ type AiMajorField = (typeof AI_MAJOR_FIELDS)[number]
 
 /** The `ai` major per dependency field of THIS package.json (not walked across workspaces). */
 function aiMajorsAt(dir: string): Partial<Record<AiMajorField, number>> {
-  const raw = readIfExists(resolve(dir, 'package.json'))
-  if (raw === null) return {}
-  try {
-    const pkg = JSON.parse(raw) as Partial<Record<AiMajorField, Record<string, string>>>
-    const out: Partial<Record<AiMajorField, number>> = {}
-    for (const field of AI_MAJOR_FIELDS) {
-      const major = majorOf(pkg[field]?.['ai'])
-      if (major !== null) out[field] = major
-    }
-    return out
-  } catch {
-    return {}
-  }
-}
-
-/** `basalt.aiMajorSkewReason` as a validated reason, plus whether the key was present but invalid. */
-function resolveAiMajorSkewReason(cfg: BasaltConfig): {
-  reason: string | null
-  presentButInvalid: boolean
-} {
-  const raw = cfg.aiMajorSkewReason
-  if (raw === undefined) return { reason: null, presentButInvalid: false }
-  if (typeof raw === 'string' && raw.trim().length > 0) {
-    return { reason: raw, presentButInvalid: false }
+  const pkg = readPackageJson<Partial<Record<AiMajorField, Record<string, string>>>>(dir) ?? {}
+  const out: Partial<Record<AiMajorField, number>> = {}
+  for (const field of AI_MAJOR_FIELDS) {
+    const major = majorOf(pkg[field]?.['ai'])
+    if (major !== null) out[field] = major
   }
-  return { reason: null, presentButInvalid: true }
+  return out
 }
 
 /**
@@ -124,8 +106,8 @@ function resolveAiMajorSkewReason(cfg: BasaltConfig): {
  *   4. `oxlint-preset`: `.oxlintrc.json` extends the shipped preset AND that path resolves.
  *   7. `ai-major-parity`: the `ai` major agrees across this package.json's dependency fields
  *      (exempt via `basalt.aiMajorSkewReason`; a stale reason warns).
- *   8-13. `tsconfig-base`, `retired-lint-rules`, `dropped-subpaths`, `app-wiring`, `exact-peers`,
- *      `config-keys` (./doctor-upgrade);
+ *   8-14. `tsconfig-base`, `retired-lint-rules`, `dropped-subpaths`, `app-wiring`, `exact-peers`,
+ *      `subpath-peers`, `config-keys` (./doctor-upgrade);
  *      a check that cannot run is SKIPPED and exits non-zero.
  *
  * Warning (non-fatal):
@@ -153,21 +135,10 @@ export function doctor(invocationCwd: string = process.cwd(), flags: string[] =
   const result: DoctorResult = { hardFailures: 0, warnings: 0, skipped: 0 }
   const lines: string[] = [`\nbasalt-ui doctor — ${cwd}\n`]
 
-  function pass(msg: string): void {
-    lines.push(`  ✓ ${msg}`)
-  }
-  function warn(msg: string): void {
-    lines.push(`  ⚠ ${msg}`)
-    result.warnings++
-  }
-  function fail(msg: string): void {
-    lines.push(`  ✖ ${msg}`)
-    result.hardFailures++
-  }
-  function skip(msg: string): void {
-    lines.push(`  ? SKIPPED ${msg}`)
-    result.skipped++
-  }
+  const pass = (msg: string): number => lines.push(`  ✓ ${msg}`)
+  const warn = (msg: string): number => lines.push(`  ⚠ ${msg}`) && result.warnings++
+  const fail = (msg: string): number => lines.push(`  ✖ ${msg}`) && result.hardFailures++
+  const skip = (msg: string): number => lines.push(`  ? SKIPPED ${msg}`) && result.skipped++
 
   if (project.relocatedFrom !== null) {
     lines.push(`  → BASALT_CWD relocated from ${project.relocatedFrom} to ${cwd}.\n`)
@@ -368,8 +339,11 @@ export function doctor(invocationCwd: string = process.cwd(), flags: string[] =
   const aiEntries = AI_MAJOR_FIELDS.filter((field) => aiMajors[field] !== undefined).map(
     (field) => ({ field, major: aiMajors[field] as number }),
   )
-  const { reason: aiMajorSkewReason, presentButInvalid: aiMajorSkewReasonInvalid } =
-    resolveAiMajorSkewReason(cfg)
+  // `basalt.aiMajorSkewReason`: a non-blank string exempts a skew; any other present value is invalid.
+  const rawSkewReason = cfg.aiMajorSkewReason
+  const aiMajorSkewReason =
+    typeof rawSkewReason === 'string' && rawSkewReason.trim().length > 0 ? rawSkewReason : null
+  const aiMajorSkewReasonInvalid = aiMajorSkewReason === null && rawSkewReason !== undefined
   if (aiEntries.length > 0) {
     const distinctMajors = new Set(aiEntries.map((entry) => entry.major))
     if (distinctMajors.size > 1) {
@@ -428,6 +402,10 @@ export function doctor(invocationCwd: string = process.cwd(), flags: string[] =
         appWiringCheck(appDir),
       ],
       ['exact-peers: installed exact-pinned peers match basalt-ui', exactPeersCheck(cwd, install)],
+      [
+        'subpath-peers: every imported basalt-ui subpath has its required peers installed',
+        subpathPeersCheck(cwd, cfg, install),
+      ],
       [
         'config-keys: the basalt config block sets only keys basalt-ui reads',
         unknownConfigKeysCheck(cwd),

package/src/cli/index.ts

@@ -148,23 +148,11 @@ function sanitizeSeverity(cfg: BasaltConfig): BasaltConfig {
 /** Does `cwd`'s own `package.json` carry a `basalt` key? — "misconfigured roots" vs "wrong
  *  directory", the failure a root-invoked hook hits since 1.29.0's single resolver. Never a walk. */
 export function hasBasaltKey(cwd: string): boolean {
-  const raw = readIfExists(resolve(cwd, 'package.json'))
-  try {
-    return raw !== null && (JSON.parse(raw) as { basalt?: unknown }).basalt !== undefined
-  } catch {
-    return false
-  }
+  return readPackageJson<{ basalt?: unknown }>(cwd)?.basalt !== undefined
 }
 
 export function readBasaltConfig(cwd: string): BasaltConfig {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, 'package.json'), 'utf8')) as {
-      basalt?: BasaltConfig
-    }
-    return sanitizeSeverity(pkg.basalt ?? {})
-  } catch {
-    return {}
-  }
+  return sanitizeSeverity(readPackageJson<{ basalt?: BasaltConfig }>(cwd)?.basalt ?? {})
 }
 
 /**
@@ -237,13 +225,10 @@ const UNRESOLVED_INSTALL: BasaltInstall = { dir: null, version: null, how: null
 /** `<dir>/node_modules/basalt-ui` when it holds a readable package.json, else null. */
 function basaltInstallAt(dir: string): { dir: string; version: string | null } | null {
   const installDir = resolve(dir, 'node_modules', 'basalt-ui')
-  const raw = readIfExists(resolve(installDir, 'package.json'))
-  if (raw === null) return null
-  try {
-    const pkg = JSON.parse(raw) as { version?: string }
-    return { dir: installDir, version: pkg.version ?? null }
-  } catch {
-    return { dir: installDir, version: null }
+  if (readIfExists(resolve(installDir, 'package.json')) === null) return null
+  return {
+    dir: installDir,
+    version: readPackageJson<{ version?: string }>(installDir)?.version ?? null,
   }
 }
 
@@ -500,31 +485,30 @@ export function readIfExists(abs: string): string | null {
   }
 }
 
+/** `<dir>/package.json` parsed as `T`; null when absent or not JSON. */
+export function readPackageJson<T>(dir: string): T | null {
+  const raw = readIfExists(resolve(dir, 'package.json'))
+  try {
+    return raw === null ? null : (JSON.parse(raw) as T)
+  } catch {
+    return null
+  }
+}
+
 /** Read a shipped source asset from the package root; null if the sibling hasn't authored it yet. */
 export function readSource(pkgRoot: string, source: string): string | null {
   return readIfExists(resolve(pkgRoot, source))
 }
 
 function readPackageName(cwd: string): string {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, 'package.json'), 'utf8')) as { name?: string }
-    if (pkg.name && pkg.name.length > 0) return pkg.name
-  } catch {
-    // fall through to dir name
-  }
+  const name = readPackageJson<{ name?: string }>(cwd)?.name
+  if (name && name.length > 0) return name
   return cwd.split('/').filter(Boolean).pop() ?? 'app'
 }
 
 /** The framework's own published version, read from the package root package.json. */
 export function readFrameworkVersion(pkgRoot: string): string {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(pkgRoot, 'package.json'), 'utf8')) as {
-      version?: string
-    }
-    return pkg.version ?? '0.0.0'
-  } catch {
-    return '0.0.0'
-  }
+  return readPackageJson<{ version?: string }>(pkgRoot)?.version ?? '0.0.0'
 }
 
 /**
@@ -733,20 +717,18 @@ export function resolveAppDir(root: string): AppResolution {
 
 /** True when `pkgName` appears in the consumer's dependencies, devDependencies, or peerDependencies. */
 function hasDependency(cwd: string, pkgName: string): boolean {
-  try {
-    const pkg = JSON.parse(readFileSync(resolve(cwd, 'package.json'), 'utf8')) as {
-      dependencies?: Record<string, string>
-      devDependencies?: Record<string, string>
-      peerDependencies?: Record<string, string>
-    }
-    return Boolean(
-      pkg.dependencies?.[pkgName] ??
-      pkg.devDependencies?.[pkgName] ??
-      pkg.peerDependencies?.[pkgName],
-    )
-  } catch {
-    return false
-  }
+  const pkg =
+    readPackageJson<
+      Record<
+        'dependencies' | 'devDependencies' | 'peerDependencies',
+        Record<string, string> | undefined
+      >
+    >(cwd)
+  return Boolean(
+    pkg?.dependencies?.[pkgName] ??
+    pkg?.devDependencies?.[pkgName] ??
+    pkg?.peerDependencies?.[pkgName],
+  )
 }
 
 /**
@@ -1275,14 +1257,8 @@ export function patchPackageJson(
 ): boolean {
   const abs = resolve(cwd, 'package.json')
   const raw = readIfExists(abs)
-  if (raw === null) return false
-  let pkg: Record<string, unknown>
-  try {
-    pkg = JSON.parse(raw) as Record<string, unknown>
-  } catch {
-    return false
-  }
-  if (!mutate(pkg)) return false
+  const pkg = readPackageJson<Record<string, unknown>>(cwd)
+  if (raw === null || pkg === null || !mutate(pkg)) return false
   const indent = /\n([ \t]+)"/.exec(raw)?.[1] ?? '  '
   writeFileSync(abs, JSON.stringify(pkg, null, indent) + (raw.endsWith('\n') ? '\n' : ''))
   return true
@@ -1689,15 +1665,8 @@ function expandWorkspaceGlobs(cwd: string, patterns: readonly string[]): string[
  * an unrecognized `workspaces` shape.
  */
 function collectWorkspacePackages(cwd: string): WorkspaceWalk {
-  const raw = readIfExists(resolve(cwd, 'package.json'))
-  if (raw === null) return { packages: [], hasWorkspacesField: false }
-
-  let parsed: { workspaces?: unknown; name?: string }
-  try {
-    parsed = JSON.parse(raw) as { workspaces?: unknown; name?: string }
-  } catch {
-    return { packages: [], hasWorkspacesField: false }
-  }
+  const parsed = readPackageJson<{ workspaces?: unknown; name?: string }>(cwd)
+  if (parsed === null) return { packages: [], hasWorkspacesField: false }
 
   const patterns = isStringArray(parsed.workspaces)
     ? parsed.workspaces

package/src/content/highlighter.ts

@@ -64,6 +64,18 @@ const LANG_ALIASES: Record<string, string> = {
 }
 
 let highlighterPromise: Promise<HighlighterCore | null> | null = null
+let warnedMissingPeer = false
+
+/** Dev-only, once per process: the highlighter peers did not resolve, so code stays unhighlighted. */
+function warnMissingPeer(error: unknown): void {
+  if (warnedMissingPeer || process.env['NODE_ENV'] === 'production') return
+  warnedMissingPeer = true
+  console.warn(
+    '[basalt] CodeBlock: syntax highlighting is off — a peer of basalt-ui/content did not load ' +
+      `(${error instanceof Error ? error.message : String(error)}). Code renders unhighlighted. ` +
+      'Install them with: bun add shiki @shikijs/langs @shikijs/themes',
+  )
+}
 
 async function loadHighlighter(): Promise<HighlighterCore | null> {
   const [{ createHighlighterCore }, { createJavaScriptRegexEngine }] = await Promise.all([
@@ -79,7 +91,10 @@ async function loadHighlighter(): Promise<HighlighterCore | null> {
 
 /** Module-level singleton — resolves once; every caller shares the same highlighter instance. */
 function getHighlighter(): Promise<HighlighterCore | null> {
-  highlighterPromise ??= loadHighlighter().catch(() => null)
+  highlighterPromise ??= loadHighlighter().catch((error: unknown) => {
+    warnMissingPeer(error)
+    return null
+  })
   return highlighterPromise
 }
 
@@ -91,7 +106,8 @@ async function ensureLanguage(highlighter: HighlighterCore, lang: string): Promi
   try {
     await highlighter.loadLanguage(loadLang() as LanguageInput)
     return true
-  } catch {
+  } catch (error) {
+    warnMissingPeer(error)
     return false
   }
 }