basalt-ui 1.19.1 → 1.21.0

package/dist/tokens/palette.d.ts

@@ -77,12 +77,12 @@ export declare const p: (fam: readonly string[], light?: number, dark?: number)
  */
 export declare const SHADOW: {
     readonly card: {
-        readonly light: "0 1px 2px rgba(28,25,23,0.05), 0 0 0 1px var(--vx-surface-hairline)";
-        readonly dark: "0 1px 3px rgba(0,0,0,0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent)";
+        readonly light: "0 1px 2px rgba(28, 25, 23, 0.05), 0 0 0 1px var(--vx-surface-hairline)";
+        readonly dark: "0 1px 3px rgba(0, 0, 0, 0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent)";
     };
     readonly ctrl: {
-        readonly light: "0 1px 2px rgba(28,25,23,0.12)";
-        readonly dark: "0 1px 2px rgba(0,0,0,0.35)";
+        readonly light: "0 1px 2px rgba(28, 25, 23, 0.12)";
+        readonly dark: "0 1px 2px rgba(0, 0, 0, 0.35)";
     };
     /**
      * Interactive-control depth — the ONE value every raised Button/ActionIcon/Input variant shares
@@ -112,12 +112,12 @@ export declare const SHADOW: {
      * ever needs more, raise the DROP. Do not reintroduce an edge; both shapes have been tried.
      */
     readonly raised: {
-        readonly light: "0 1px 2px rgba(28,25,23,0.10)";
-        readonly dark: "0 1px 2px rgba(0,0,0,0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent)";
+        readonly light: "0 1px 2px rgba(28, 25, 23, 0.1)";
+        readonly dark: "0 1px 2px rgba(0, 0, 0, 0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent)";
     };
     readonly overlay: {
-        readonly light: "0 8px 24px rgba(28,25,23,0.10)";
-        readonly dark: "0 8px 24px rgba(0,0,0,0.5)";
+        readonly light: "0 8px 24px rgba(28, 25, 23, 0.1)";
+        readonly dark: "0 8px 24px rgba(0, 0, 0, 0.5)";
     };
 };
 /**
@@ -499,8 +499,14 @@ declare const SPACE_STEP_BASE: {
      *  `env(safe-area-inset-bottom)` to it. JS-consumed (AppShell `footer.height`), no `--vx-*` var,
      *  same shape as `appShellHeaderHeight`. Floored at 48px in `deriveSpacing`. */
     readonly mobileNavBarHeight: 56;
-    /** Slot icon box. */
+    /** Slot icon box. Also the MIN box of the icon slot itself, so the active pill keeps its shape
+     *  when a destination ships no icon (an icon-less consumer is a supported configuration). */
     readonly mobileNavIconSize: 24;
+    /** Active-pill inset around the slot icon, vertical. Sub-scale on its own, but it is one half of
+     *  a pair with `mobileNavTabInsetX` — a step keeps the pill's shape tracking density. */
+    readonly mobileNavTabInsetY: 2;
+    /** Active-pill inset around the slot icon, horizontal. */
+    readonly mobileNavTabInsetX: 12;
     /** Menu/sheet row height. Floored at 44px in `deriveSpacing` (Apple HIG 44pt / WCAG 2.5.5 AAA). */
     readonly mobileNavRowHeight: 44;
     /** More/group `<Menu width={…}>`. JS-consumed, no var — same rationale as
@@ -883,6 +889,8 @@ export declare const SPACE_STEP: {
     readonly mobileNavTabGap: number;
     readonly mobileNavBarHeight: number;
     readonly mobileNavIconSize: number;
+    readonly mobileNavTabInsetY: number;
+    readonly mobileNavTabInsetX: number;
     readonly mobileNavRowHeight: number;
     readonly mobileNavMenuWidth: number;
     readonly chartLegendGap: number;
@@ -971,19 +979,19 @@ declare function buildPaletteDataUncached(config: DeriveConfig): {
         };
         readonly axis: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.6)";
+            readonly dark: "rgba(255, 255, 255, 0.6)";
         };
         readonly axisStroke: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.12)";
+            readonly dark: "rgba(255, 255, 255, 0.12)";
         };
         readonly grid: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.06)";
+            readonly dark: "rgba(255, 255, 255, 0.06)";
         };
         readonly crosshair: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.42)";
+            readonly dark: "rgba(255, 255, 255, 0.42)";
         };
         readonly dotStroke: {
             readonly light: "#ffffff";
@@ -991,15 +999,15 @@ declare function buildPaletteDataUncached(config: DeriveConfig): {
         };
         readonly tooltipBg: {
             readonly light: "#ffffff";
-            readonly dark: "rgba(39,39,42,0.96)";
+            readonly dark: "rgba(39, 39, 42, 0.96)";
         };
         readonly tooltipText: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.88)";
+            readonly dark: "rgba(255, 255, 255, 0.88)";
         };
         readonly tooltipMuted: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.5)";
+            readonly dark: "rgba(255, 255, 255, 0.5)";
         };
         readonly tooltipBorder: {
             readonly light: "1px solid #e4e4e7";
@@ -1007,11 +1015,11 @@ declare function buildPaletteDataUncached(config: DeriveConfig): {
         };
         readonly tooltipShadow: {
             readonly light: `0 2px 8px ${string}`;
-            readonly dark: "0 2px 8px rgba(0,0,0,0.35)";
+            readonly dark: "0 2px 8px rgba(0, 0, 0, 0.35)";
         };
         readonly legendText: {
             readonly light: string;
-            readonly dark: "rgba(255,255,255,0.92)";
+            readonly dark: "rgba(255, 255, 255, 0.92)";
         };
         readonly neutral: ColorPair;
     };
@@ -1072,19 +1080,19 @@ export declare const NEUTRAL: {
     };
     readonly axis: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.6)";
+        readonly dark: "rgba(255, 255, 255, 0.6)";
     };
     readonly axisStroke: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.12)";
+        readonly dark: "rgba(255, 255, 255, 0.12)";
     };
     readonly grid: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.06)";
+        readonly dark: "rgba(255, 255, 255, 0.06)";
     };
     readonly crosshair: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.42)";
+        readonly dark: "rgba(255, 255, 255, 0.42)";
     };
     readonly dotStroke: {
         readonly light: "#ffffff";
@@ -1092,15 +1100,15 @@ export declare const NEUTRAL: {
     };
     readonly tooltipBg: {
         readonly light: "#ffffff";
-        readonly dark: "rgba(39,39,42,0.96)";
+        readonly dark: "rgba(39, 39, 42, 0.96)";
     };
     readonly tooltipText: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.88)";
+        readonly dark: "rgba(255, 255, 255, 0.88)";
     };
     readonly tooltipMuted: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.5)";
+        readonly dark: "rgba(255, 255, 255, 0.5)";
     };
     readonly tooltipBorder: {
         readonly light: "1px solid #e4e4e7";
@@ -1108,11 +1116,11 @@ export declare const NEUTRAL: {
     };
     readonly tooltipShadow: {
         readonly light: `0 2px 8px ${string}`;
-        readonly dark: "0 2px 8px rgba(0,0,0,0.35)";
+        readonly dark: "0 2px 8px rgba(0, 0, 0, 0.35)";
     };
     readonly legendText: {
         readonly light: string;
-        readonly dark: "rgba(255,255,255,0.92)";
+        readonly dark: "rgba(255, 255, 255, 0.92)";
     };
     readonly neutral: ColorPair;
 };

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

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

package/dist/tokens/palette.js

@@ -37,12 +37,12 @@ const p = (fam, light = 2, dark = 3) => ({
 });
 const SHADOW = {
   card: {
-    light: "0 1px 2px rgba(28,25,23,0.05), 0 0 0 1px var(--vx-surface-hairline)",
-    dark: "0 1px 3px rgba(0,0,0,0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent)"
+    light: "0 1px 2px rgba(28, 25, 23, 0.05), 0 0 0 1px var(--vx-surface-hairline)",
+    dark: "0 1px 3px rgba(0, 0, 0, 0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent)"
   },
   ctrl: {
-    light: "0 1px 2px rgba(28,25,23,0.12)",
-    dark: "0 1px 2px rgba(0,0,0,0.35)"
+    light: "0 1px 2px rgba(28, 25, 23, 0.12)",
+    dark: "0 1px 2px rgba(0, 0, 0, 0.35)"
   },
   /**
    * Interactive-control depth — the ONE value every raised Button/ActionIcon/Input variant shares
@@ -72,16 +72,16 @@ const SHADOW = {
    * ever needs more, raise the DROP. Do not reintroduce an edge; both shapes have been tried.
    */
   raised: {
-    light: "0 1px 2px rgba(28,25,23,0.10)",
-    dark: "0 1px 2px rgba(0,0,0,0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent)"
+    light: "0 1px 2px rgba(28, 25, 23, 0.1)",
+    dark: "0 1px 2px rgba(0, 0, 0, 0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent)"
   },
   // Floating-layer elevation (menus, popovers, tooltips, modals, drawers) — a REAL drop shadow, a
   // step above `card`, so detached surfaces read as lifted off the page (`docs/DESIGN-SPEC.md` §5).
   // Unlike `card`, no embedded ring: floating surfaces carry a real 1px `--vx-surface-border` so
   // Mantine's rotated-square arrow inherits a proper edge.
   overlay: {
-    light: "0 8px 24px rgba(28,25,23,0.10)",
-    dark: "0 8px 24px rgba(0,0,0,0.5)"
+    light: "0 8px 24px rgba(28, 25, 23, 0.1)",
+    dark: "0 8px 24px rgba(0, 0, 0, 0.5)"
   }
 };
 function clampRadius(n) {
@@ -414,8 +414,14 @@ const SPACE_STEP_BASE = {
    *  `env(safe-area-inset-bottom)` to it. JS-consumed (AppShell `footer.height`), no `--vx-*` var,
    *  same shape as `appShellHeaderHeight`. Floored at 48px in `deriveSpacing`. */
   mobileNavBarHeight: 56,
-  /** Slot icon box. */
+  /** Slot icon box. Also the MIN box of the icon slot itself, so the active pill keeps its shape
+   *  when a destination ships no icon (an icon-less consumer is a supported configuration). */
   mobileNavIconSize: 24,
+  /** Active-pill inset around the slot icon, vertical. Sub-scale on its own, but it is one half of
+   *  a pair with `mobileNavTabInsetX` — a step keeps the pill's shape tracking density. */
+  mobileNavTabInsetY: 2,
+  /** Active-pill inset around the slot icon, horizontal. */
+  mobileNavTabInsetX: 12,
   /** Menu/sheet row height. Floored at 44px in `deriveSpacing` (Apple HIG 44pt / WCAG 2.5.5 AAA). */
   mobileNavRowHeight: 44,
   /** More/group `<Menu width={…}>`. JS-consumed, no var — same rationale as
@@ -582,23 +588,23 @@ function buildPaletteDataUncached(config) {
     // primary line
     line2: { light: BP.gray[1], dark: BP.gray[2] },
     // secondary line
-    axis: { light: inkRgba(inkLight, 0.6), dark: "rgba(255,255,255,0.6)" },
-    axisStroke: { light: inkRgba(inkLight, 0.12), dark: "rgba(255,255,255,0.12)" },
-    grid: { light: inkRgba(inkLight, 0.07), dark: "rgba(255,255,255,0.06)" },
-    crosshair: { light: inkRgba(inkLight, 0.32), dark: "rgba(255,255,255,0.42)" },
+    axis: { light: inkRgba(inkLight, 0.6), dark: "rgba(255, 255, 255, 0.6)" },
+    axisStroke: { light: inkRgba(inkLight, 0.12), dark: "rgba(255, 255, 255, 0.12)" },
+    grid: { light: inkRgba(inkLight, 0.07), dark: "rgba(255, 255, 255, 0.06)" },
+    crosshair: { light: inkRgba(inkLight, 0.32), dark: "rgba(255, 255, 255, 0.42)" },
     dotStroke: { light: BP.white, dark: BP.darkGray[1] },
     // matches chart-area bg
-    tooltipBg: { light: BP.white, dark: "rgba(39,39,42,0.96)" },
-    tooltipText: { light: inkRgba(inkLight, 0.88), dark: "rgba(255,255,255,0.88)" },
-    tooltipMuted: { light: inkRgba(inkLight, 0.5), dark: "rgba(255,255,255,0.5)" },
+    tooltipBg: { light: BP.white, dark: "rgba(39, 39, 42, 0.96)" },
+    tooltipText: { light: inkRgba(inkLight, 0.88), dark: "rgba(255, 255, 255, 0.88)" },
+    tooltipMuted: { light: inkRgba(inkLight, 0.5), dark: "rgba(255, 255, 255, 0.5)" },
     tooltipBorder: { light: `1px solid ${BP.lightGray[1]}`, dark: "none" },
     tooltipShadow: {
       light: `0 2px 8px ${inkRgba(inkLight, 0.1)}`,
-      dark: "0 2px 8px rgba(0,0,0,0.35)"
+      dark: "0 2px 8px rgba(0, 0, 0, 0.35)"
     },
     // Chart legend text — same DERIVED-ink treatment as axis/grid/tooltip* above (light keys off
     // `inkLight`; dark stays flat white like every other neutral chart-chrome pair here).
-    legendText: { light: inkRgba(inkLight, 0.82), dark: "rgba(255,255,255,0.92)" },
+    legendText: { light: inkRgba(inkLight, 0.82), dark: "rgba(255, 255, 255, 0.92)" },
     // Base neutral for hairlines / muted / DIMMED text / overlays — apply opacity via alpha().
     // Binds to --mantine-color-dimmed, so it is THE dimmed-text lever. Equal to `INK.muted` (the
     // spec's "muted (secondary text)" row) — kept as its own pair for the pre-existing `--vx-neutral`

package/dist/tokens/text-scale.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=text-scale.test.d.ts.map

package/dist/tokens/text-scale.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-scale.test.d.ts","sourceRoot":"","sources":["../../src/tokens/text-scale.test.ts"],"names":[],"mappings":""}

package/dist/tokens.css

@@ -96,6 +96,8 @@
   --vx-space-app-header-mobile-actions-height: 52px;
   --vx-space-mobile-nav-tab-gap: 3px;
   --vx-space-mobile-nav-icon-size: 24px;
+  --vx-space-mobile-nav-tab-inset-y: 2px;
+  --vx-space-mobile-nav-tab-inset-x: 12px;
   --vx-space-mobile-nav-row-height: 44px;
   --vx-space-agent-rail-inset-x: 10px;
   --vx-space-agent-part-gap-top: 6px;
@@ -136,6 +138,7 @@
   --vx-fill-hover-lime: color-mix(in srgb, var(--vx-fill-lime) 88%, #000);
   --vx-fill-hover-yellow: color-mix(in srgb, var(--vx-fill-yellow) 88%, #000);
   --vx-fill-hover-orange: color-mix(in srgb, var(--vx-fill-orange) 88%, #000);
+  --vx-text-nano: 10px;
   --vx-text-micro: 11px;
   --vx-text-xs: 12.5px;
   --vx-text-sm: 13.5px;
@@ -145,6 +148,7 @@
   --vx-text-h2: 21px;
   --vx-text-kpi: 24px;
   --vx-text-h1: 26px;
+  --vx-text-display: 30px;
   --vx-area-top: 22%;
   --vx-area-bottom: 1%;
   --vx-good: color-mix(in srgb, var(--vx-good-solid) 18%, transparent);
@@ -185,17 +189,17 @@ html[data-mantine-color-scheme='dark'] {
   --vx-neutral: #d4d4d8;
   --vx-line: #e4e4e7;
   --vx-line2: #a1a1aa;
-  --vx-axis: rgba(255,255,255,0.6);
-  --vx-axis-stroke: rgba(255,255,255,0.12);
-  --vx-grid: rgba(255,255,255,0.06);
-  --vx-crosshair: rgba(255,255,255,0.42);
+  --vx-axis: rgba(255, 255, 255, 0.6);
+  --vx-axis-stroke: rgba(255, 255, 255, 0.12);
+  --vx-grid: rgba(255, 255, 255, 0.06);
+  --vx-crosshair: rgba(255, 255, 255, 0.42);
   --vx-dot-stroke: #27272a;
-  --vx-tooltip-bg: rgba(39,39,42,0.96);
-  --vx-tooltip-text: rgba(255,255,255,0.88);
-  --vx-tooltip-muted: rgba(255,255,255,0.5);
+  --vx-tooltip-bg: rgba(39, 39, 42, 0.96);
+  --vx-tooltip-text: rgba(255, 255, 255, 0.88);
+  --vx-tooltip-muted: rgba(255, 255, 255, 0.5);
   --vx-tooltip-border: none;
-  --vx-tooltip-shadow: 0 2px 8px rgba(0,0,0,0.35);
-  --vx-legend-text: rgba(255,255,255,0.92);
+  --vx-tooltip-shadow: 0 2px 8px rgba(0, 0, 0, 0.35);
+  --vx-legend-text: rgba(255, 255, 255, 0.92);
   --vx-ink: #e5e5e9;
   --vx-ink2: #dddde1;
   --vx-muted: #d4d4d8;
@@ -206,10 +210,10 @@ html[data-mantine-color-scheme='dark'] {
   --vx-accent-fill-hover: #3c6895;
   --vx-on-accent: #ffffff;
   --vx-divider: color-mix(in srgb, #ffffff 6%, transparent);
-  --vx-shadow-card: 0 1px 3px rgba(0,0,0,0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent);
-  --vx-shadow-ctrl: 0 1px 2px rgba(0,0,0,0.35);
-  --vx-shadow-raised: 0 1px 2px rgba(0,0,0,0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent);
-  --vx-shadow-overlay: 0 8px 24px rgba(0,0,0,0.5);
+  --vx-shadow-card: 0 1px 3px rgba(0, 0, 0, 0.4), inset 0 0 0 1px color-mix(in srgb, #ffffff 4%, transparent);
+  --vx-shadow-ctrl: 0 1px 2px rgba(0, 0, 0, 0.35);
+  --vx-shadow-raised: 0 1px 2px rgba(0, 0, 0, 0.35), inset 0 0 0 1px color-mix(in srgb, #ffffff 8%, transparent);
+  --vx-shadow-overlay: 0 8px 24px rgba(0, 0, 0, 0.5);
   --vx-surface-bg: #27272a;
   --vx-surface-panel: #2b2b2e;
   --vx-surface-panel-hover: #38383b;
@@ -270,10 +274,10 @@ html[data-mantine-color-scheme='light'] {
   --vx-accent-fill-hover: #3c6895;
   --vx-on-accent: #ffffff;
   --vx-divider: color-mix(in srgb, #e5e5e5 65%, transparent);
-  --vx-shadow-card: 0 1px 2px rgba(28,25,23,0.05), 0 0 0 1px var(--vx-surface-hairline);
-  --vx-shadow-ctrl: 0 1px 2px rgba(28,25,23,0.12);
-  --vx-shadow-raised: 0 1px 2px rgba(28,25,23,0.10);
-  --vx-shadow-overlay: 0 8px 24px rgba(28,25,23,0.10);
+  --vx-shadow-card: 0 1px 2px rgba(28, 25, 23, 0.05), 0 0 0 1px var(--vx-surface-hairline);
+  --vx-shadow-ctrl: 0 1px 2px rgba(28, 25, 23, 0.12);
+  --vx-shadow-raised: 0 1px 2px rgba(28, 25, 23, 0.1);
+  --vx-shadow-overlay: 0 8px 24px rgba(28, 25, 23, 0.1);
   --vx-surface-bg: #f2f2f5;
   --vx-surface-panel: #fafafd;
   --vx-surface-panel-hover: #ffffff;

package/dist/vite-color-mix.js

@@ -1,8 +1,8 @@
 const NAMED_COLORS = {
   white: "#ffffff",
-  // theme-allow — CSS keyword definition, not a design color
+  // theme-allow raw-hex — the CSS keyword's definition, not a design color
   black: "#000000"
-  // theme-allow — CSS keyword definition, not a design color
+  // theme-allow raw-hex — the CSS keyword's definition, not a design color
 };
 function normalizeHex(hex) {
   const body = hex.slice(1);

package/dist/vite.d.ts

@@ -49,7 +49,21 @@ export type BasaltAppOptions = {
         light: string;
         dark: string;
     };
-    /** Manifest `background_color` + anti-FOUC paint color. Default: the resolved dark theme color. */
+    /**
+     * Which scheme the anti-FOUC `<style>` paints before the app boots. Default `'dark'` —
+     * `BasaltProvider`'s own default. `'light'` paints the light surface, `'auto'` declares
+     * `color-scheme: light dark` and picks the background off `prefers-color-scheme`, and `false`
+     * paints the background but declares no `color-scheme` at all (leave native controls to Mantine).
+     *
+     * Set this to whatever the app passes as `defaultColorScheme` — a mismatch is a visible flash of
+     * the wrong surface, not a correctness bug: the boot rule stops applying the moment Mantine
+     * writes `data-mantine-color-scheme` on `<html>` (see `BOOT_SCOPE`).
+     */
+    colorScheme?: 'dark' | 'light' | 'auto' | false;
+    /**
+     * Manifest `background_color` + anti-FOUC paint color. Default: the theme color matching
+     * `colorScheme` (the dark one for `'dark'` / `'auto'` / `false`, the light one for `'light'`).
+     */
     backgroundColor?: string;
     /** Manifest `display` mode. Default: `'standalone'`. */
     display?: 'standalone' | 'minimal-ui' | 'fullscreen' | 'browser';
@@ -104,13 +118,21 @@ export type BasaltAppOptions = {
  * manifest `theme_color` both need a FLAT color, so the flattening step is the contract this
  * plugin owes its output regardless of which shape the palette hands it.
  *
+ * Two behaviours worth knowing before adopting it, both of which the plugin owns because the
+ * consumer cannot reach them:
+ *  • It HOISTS the shell's `<meta charset>` ahead of everything it injects, so the encoding
+ *    declaration stays inside the spec's first 1024 bytes (see `hoistCharset`).
+ *  • The anti-FOUC `<style>` expires the moment Mantine resolves the real scheme, and `colorScheme`
+ *    selects which surface it paints until then (see `BOOT_SCOPE` / `buildBootStyle`).
+ *
  * @example
  * // vite.config.ts
  * import { basaltAppPlugin, basaltViteConfig } from 'basalt-ui/vite'
  *
  * export default {
  *   ...basaltViteConfig({ port: 5173 }),
- *   plugins: [react(), ...basaltAppPlugin({ name: 'Argo' })],
+ *   // colorScheme mirrors <BasaltProvider defaultColorScheme> — omit it for the dark default.
+ *   plugins: [react(), ...basaltAppPlugin({ name: 'Argo', colorScheme: 'auto' })],
  * }
  */
 export declare function basaltAppPlugin(options: BasaltAppOptions): PluginOption[];

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAA6B,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAI/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA6CD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAgFpE;AAgBD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD,mGAAmG;IACnG,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mGAAmG;IACnG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,wFAAwF;IACxF,KAAK,CAAC,EAAE,KAAK,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,oFAAoF;IACpF,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAA;KAAE,CAAA;IACvF,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClD,CAAA;AAuZD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAMzE"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAA6B,YAAY,EAAE,UAAU,EAAE,MAAM,MAAM,CAAA;AAI/E,MAAM,MAAM,iBAAiB,GAAG;IAC9B,4FAA4F;IAC5F,IAAI,EAAE,MAAM,CAAA;IACZ,6EAA6E;IAC7E,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;IACvB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B,CAAA;AA6CD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,iBAAiB,GAAG,UAAU,CAgFpE;AAgBD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,gGAAgG;IAChG,IAAI,EAAE,MAAM,CAAA;IACZ,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,gGAAgG;IAChG,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;IACrD;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAA;IAC/C;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,GAAG,YAAY,GAAG,YAAY,GAAG,SAAS,CAAA;IAChE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mGAAmG;IACnG,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,wFAAwF;IACxF,KAAK,CAAC,EAAE,KAAK,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;IAChC,8FAA8F;IAC9F,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC3B,oFAAoF;IACpF,GAAG,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,SAAS,GAAG,qBAAqB,CAAA;KAAE,CAAA;IACvF,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,KAAK,CAAA;IAChB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClD,CAAA;AAigBD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAMzE"}

package/dist/vite.js

@@ -140,6 +140,29 @@ const VIEWPORT_TAG = {
   tag: "meta",
   attrs: { name: "viewport", content: "width=device-width, initial-scale=1.0, viewport-fit=cover" }
 };
+const BOOT_SCOPE = "html:not([data-mantine-color-scheme])";
+const BOOT_COLOR_SCHEME = { dark: "dark", light: "light", auto: "light dark" };
+function buildBootStyle(input) {
+  const { colorScheme, themeColor, backgroundColor, explicitBackground } = input;
+  if (colorScheme === false) return `${BOOT_SCOPE}{background-color:${backgroundColor}}`;
+  const scheme = BOOT_COLOR_SCHEME[colorScheme];
+  if (colorScheme !== "auto" || explicitBackground) {
+    return `${BOOT_SCOPE}{background-color:${backgroundColor};color-scheme:${scheme}}`;
+  }
+  return `${BOOT_SCOPE}{background-color:${themeColor.light};color-scheme:${scheme}}@media(prefers-color-scheme:dark){${BOOT_SCOPE}{background-color:${themeColor.dark}}}`;
+}
+const CHARSET_META_RE = /[ \t]*<meta\s+charset\s*=\s*(?:"([^"]*)"|'([^']*)'|([^\s"'>=]+))\s*\/?>[ \t]*\r?\n?/i;
+const HTTP_EQUIV_CHARSET_RE = /<meta\s[^>]*http-equiv\s*=\s*["']?content-type["']?[^>]*>/i;
+const DEFAULT_CHARSET = "UTF-8";
+function hoistCharset(html) {
+  if (HTTP_EQUIV_CHARSET_RE.test(html)) return { html, tag: void 0 };
+  const match = CHARSET_META_RE.exec(html);
+  const charset = match?.[1] ?? match?.[2] ?? match?.[3] ?? DEFAULT_CHARSET;
+  return {
+    html: match ? html.replace(CHARSET_META_RE, "") : html,
+    tag: { tag: "meta", attrs: { charset } }
+  };
+}
 function buildSeoTags(input) {
   const { name, description, seo } = input;
   const tags = [];
@@ -183,7 +206,7 @@ function buildStaticTags(input) {
     options,
     shortName,
     themeColor,
-    backgroundColor,
+    bootStyle,
     iconsEnabled,
     iconsDir,
     darkreader,
@@ -210,10 +233,7 @@ function buildStaticTags(input) {
       }
     }
   );
-  tags.push({
-    tag: "style",
-    children: `html{background-color:${backgroundColor};color-scheme:dark}`
-  });
+  tags.push({ tag: "style", children: bootStyle });
   if (iconsEnabled) {
     tags.push(
       {
@@ -274,7 +294,7 @@ function buildManifestJson(input) {
     scope,
     id,
     display,
-    themeColor,
+    schemeColor,
     backgroundColor,
     iconsDir,
     base
@@ -287,7 +307,9 @@ function buildManifestJson(input) {
     start_url: startUrl,
     scope,
     display,
-    theme_color: themeColor.dark,
+    // A manifest carries ONE theme color, so it follows the boot scheme rather than the dual
+    // `<meta name="theme-color">` pair. Unchanged for the default (`'dark'`) and for `'auto'`.
+    theme_color: schemeColor,
     background_color: backgroundColor,
     icons: [
       {
@@ -313,7 +335,15 @@ function createMainPlugin(options) {
   const iconsDir = options.icons === false ? void 0 : options.icons?.dir;
   const manifestEnabled = options.manifest !== false;
   const themeColor = resolveThemeColors(options.themeColor);
-  const backgroundColor = options.backgroundColor ?? themeColor.dark;
+  const colorScheme = options.colorScheme ?? "dark";
+  const schemeColor = colorScheme === "light" ? themeColor.light : themeColor.dark;
+  const backgroundColor = options.backgroundColor ?? schemeColor;
+  const bootStyle = buildBootStyle({
+    colorScheme,
+    themeColor,
+    backgroundColor,
+    explicitBackground: options.backgroundColor !== void 0
+  });
   let manifestJson = "";
   let manifestHref = "/site.webmanifest";
   let staticTags = [];
@@ -332,7 +362,7 @@ function createMainPlugin(options) {
         scope,
         id,
         display,
-        themeColor,
+        schemeColor,
         backgroundColor,
         iconsDir,
         base
@@ -341,7 +371,7 @@ function createMainPlugin(options) {
         options,
         shortName,
         themeColor,
-        backgroundColor,
+        bootStyle,
         iconsEnabled,
         iconsDir,
         darkreader,
@@ -350,9 +380,20 @@ function createMainPlugin(options) {
         manifestHref
       });
     },
-    transformIndexHtml(html) {
-      const tags = hasViewportMeta(html) ? staticTags : [VIEWPORT_TAG, ...staticTags];
-      return { html, tags };
+    transformIndexHtml: {
+      // `pre` so this plugin's tags are the FIRST head-prepend contributions Vite collects — that
+      // ordering is what puts the hoisted <meta charset> at the very top of <head> rather than
+      // behind another plugin's tags. Vite injects all collected tags after every hook has run.
+      order: "pre",
+      handler(html) {
+        const hoisted = hoistCharset(html);
+        const tags = [
+          ...hoisted.tag ? [hoisted.tag] : [],
+          ...hasViewportMeta(html) ? [] : [VIEWPORT_TAG],
+          ...staticTags
+        ];
+        return { html: hoisted.html, tags };
+      }
     },
     generateBundle() {
       if (!manifestEnabled) return;

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.19.1
+# basalt-ui v1.21.0
 # Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets
 #
 # basalt-ui is an opinionated framework for Mantine-based React apps.
@@ -19,7 +19,7 @@
 # ./tokens.css subpath. Guide: docs/FRAMEWORK-FREE.md in the repo.
 
 Package: basalt-ui
-Version: 1.19.1
+Version: 1.21.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'
@@ -152,7 +152,7 @@ Layer: non-js-asset
 
 ## basalt-ui/tokens.css
 Asset: basalt-ui/tokens.css
-Description: Prebuilt --vx-* token stylesheet — the default buildPaletteCss() output as a plain file, for a consumer with no bundler, no React and no Mantine; retune the selector or trim the spacing set with `basalt-ui tokens:css`
+Description: Prebuilt --vx-* token stylesheet — the default buildPaletteCss() output as a plain file, for a consumer that has a bundler to resolve the subpath but no React and no Mantine; with no bundler, emit a file you own via `basalt-ui tokens:css`
 Layer: non-js-asset
 
 ## basalt-ui/configs/*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "basalt-ui",
-  "version": "1.19.1",
+  "version": "1.21.0",
   "description": "Opinionated framework for Mantine-based React apps — theme, app shell, visx charts, toolchain presets",
   "keywords": [
     "charts",
@@ -37,7 +37,8 @@
     "llms.txt",
     "AGENTS.md",
     "README.md",
-    "CHANGELOG.md"
+    "CHANGELOG.md",
+    "MIGRATING.md"
   ],
   "type": "module",
   "sideEffects": [
@@ -131,7 +132,7 @@
   },
   "scripts": {
     "build": "tsup && tsc --emitDeclarationOnly --declarationMap && bun scripts/copy-assets.mjs && bun scripts/gen-tokens-css.mjs && bun scripts/fix-esm-extensions.mjs",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc --noEmit && tsc -p tests/layout/tsconfig.json",
     "test": "cd ../.. && bun test packages/basalt-ui",
     "pack-test": "bash scripts/pack-test.sh",
     "prepack": "bun run build",

package/src/agent/stick-to-bottom.tsx

@@ -39,7 +39,7 @@ type WrapperProps = {
 /** Plain scrollable container rendered when use-stick-to-bottom peer is absent. */
 function PlainContainerFallback({ children, className, style }: WrapperProps): JSX.Element {
   const props: { className?: string; style?: CSSProperties } = {
-    // theme-allow — scroll anchoring needs a real scrollable node it owns, not a ScrollArea.
+    // theme-allow raw-scroll-container — scroll anchoring needs a real scrollable node it owns, not a ScrollArea.
     style: { overflowY: 'auto', ...style },
   }
   if (className !== undefined) props.className = className

package/src/agent-chat/thread-detail-panel.tsx

@@ -135,7 +135,7 @@ export function ThreadDetailPanel({
         <BasaltStickToBottom
           style={{
             height: '100%',
-            // theme-allow — BasaltStickToBottom owns this scroll node (see stick-to-bottom.tsx).
+            // theme-allow raw-scroll-container — BasaltStickToBottom owns this scroll node (see stick-to-bottom.tsx).
             overflowY: 'auto',
             padding: 'var(--vx-space-agent-transcript-inset)',
           }}