basalt-ui 1.26.0 → 1.27.0

package/dist/state/fields.js

@@ -1,5 +1,19 @@
 import { useSyncExternalStore } from "react";
-import { createPersistedState, readPersistedValue } from "./persisted.js";
+import { createPersistedState, readPersistedValue, writePersistedValue } from "./persisted.js";
+function rangeField(o, lane) {
+  const { fallback } = o;
+  return {
+    kind: "range",
+    presets: o.presets,
+    // A thunk fallback stays a thunk — wrapped so the lazy value is read at the same moment every
+    // other lane reads one, not once here at definition.
+    fallback: typeof fallback === "function" ? () => ({ preset: fallback() }) : { preset: fallback },
+    custom: o.custom ?? false,
+    params: o.params ?? {},
+    window: o.window ?? {},
+    lane: resolveLane(lane)
+  };
+}
 const field = {
   /** A closed string enum — a tab, a compare mode, a single-select filter. */
   enum(values, fallback, lane) {
@@ -9,29 +23,7 @@ const field = {
   multi(values, fallback = [], lane) {
     return { kind: "multi", values, fallback, lane: resolveLane(lane) };
   },
-  /**
-   * A time window: THREE URL params (preset + `from` + `to`, each renamable through `params`), so a
-   * consumer's existing deep links and loaders keep their shape. `custom: true` additionally
-   * allows the preset `'custom'` with two ISO dates.
-   *
-   * A second `field.range` in the same store — or a second range store composed into the same
-   * route's `validateSearch` — MUST rename `from`/`to` via `params`: every range defaults to the
-   * literal param names `'from'`/`'to'`, and two fields silently sharing them makes the later one's
-   * `toSearch` overwrite the earlier one's dates. `createStoreCore` throws at definition for the
-   * in-store case; the cross-store case is not detectable by either store alone.
-   */
-  range(o, lane) {
-    return {
-      kind: "range",
-      presets: o.presets,
-      fallback: { preset: o.fallback },
-      // The only cast left, and it is narrow: `C` is inferred from this very literal, so the
-      // runtime boolean IS `C` — `?? false` is what the compiler cannot see through.
-      custom: o.custom ?? false,
-      params: o.params ?? {},
-      lane: resolveLane(lane)
-    };
-  },
+  range: rangeField,
   /** A number — pagination, a threshold. Out-of-range input clamps to `min`/`max`. */
   number(o, lane) {
     return {
@@ -64,6 +56,9 @@ function resolveLane(lane) {
     history: lane?.history === "push" ? "push" : "replace"
   };
 }
+function resolveFallback(raw) {
+  return typeof raw === "function" ? raw() : raw;
+}
 const ISO_DATE_RE = /^\d{4}-\d{2}-\d{2}(?:T[\d:.]+(?:Z|[+-]\d{2}:\d{2})?)?$/;
 function isIsoDate(raw) {
   return typeof raw === "string" && ISO_DATE_RE.test(raw) && !Number.isNaN(Date.parse(raw));
@@ -126,7 +121,10 @@ function resolveFieldCodec(name, f, opts) {
         lane: f.lane,
         params: [presetParam, fromParam, toParam],
         primary: presetParam,
-        fallback: f.fallback,
+        get fallback() {
+          return resolveFallback(f.fallback);
+        },
+        windows: f.window,
         decode,
         fromSearch: (search) => decode({
           preset: search[presetParam],
@@ -160,7 +158,7 @@ function resolveFieldCodec(name, f, opts) {
         if (f.max !== void 0 && value > f.max) value = f.max;
         return value;
       };
-      return single(name, f, decode);
+      return single(name, f, decode, { bounds: { min: f.min, max: f.max, int: f.int } });
     }
     case "boolean": {
       return single(name, f, decodeBoolean);
@@ -184,7 +182,10 @@ function single(name, f, decode, extra) {
     lane: f.lane,
     params: [name],
     primary: name,
-    fallback: f.fallback,
+    get fallback() {
+      return resolveFallback(f.fallback);
+    },
+    ...extra?.bounds !== void 0 && { bounds: extra.bounds },
     decode,
     fromSearch: (search) => decodeUrl(search[name]),
     toSearch: (value) => ({ [name]: value }),
@@ -235,6 +236,10 @@ function createMemoryLane() {
       values.set(name, value);
       bump();
     },
+    remove: (name) => {
+      if (!values.delete(name)) return;
+      bump();
+    },
     clear: () => {
       if (values.size === 0) return;
       values.clear();
@@ -279,24 +284,51 @@ function createStoreCore(o) {
     const map = labels.get(entry.name);
     return entry.codec.optionValues.map((value) => ({ value, label: map?.[value] ?? value }));
   };
+  const clearField = (name) => {
+    const record = readRecord();
+    if (!Object.hasOwn(record, name)) return;
+    const next = { ...record };
+    delete next[name];
+    writePersistedValue(o.key, version, fromRecord(next));
+  };
   const writeField = (setRecord, name, value) => {
     setRecord({ ...readRecord(), [name]: value });
   };
-  const handle = (entry, use) => {
+  const handle = (entry, use, clear) => {
     const { codec } = entry;
     const built = {
       kind: codec.kind,
-      fallback: codec.fallback,
       use,
+      clear,
       isDefault: (v) => codec.equals(v, codec.fallback)
     };
     if (codec.kind === "range") {
-      built["toWindow"] = (v) => v.preset === "custom" && v.from !== void 0 && v.to !== void 0 ? { from: v.from, to: v.to } : { window: v.preset };
+      built["toWindow"] = (v) => {
+        if (v.preset === "custom" && v.from !== void 0 && v.to !== void 0) {
+          return { from: v.from, to: v.to };
+        }
+        const windows = codec.windows;
+        if (windows !== void 0 && Object.hasOwn(windows, v.preset)) {
+          const resolver = windows[v.preset];
+          if (resolver !== void 0) return resolver(/* @__PURE__ */ new Date());
+        }
+        return { window: v.preset };
+      };
+    }
+    if (codec.kind === "number") {
+      const bounds = codec.bounds;
+      built["min"] = bounds?.min;
+      built["max"] = bounds?.max;
+      built["int"] = bounds?.int ?? false;
     }
     Object.defineProperty(built, "options", {
       enumerable: true,
       get: () => optionsFor(entry)
     });
+    Object.defineProperty(built, "fallback", {
+      enumerable: true,
+      get: () => codec.fallback
+    });
     return built;
   };
   return {
@@ -317,6 +349,8 @@ function createStoreCore(o) {
     readMemoryValue: (entry) => memory.resolve(entry),
     useMemoryVersion: () => useSyncExternalStore(memory.subscribe, memory.getVersion, memory.getVersion),
     resetMemory: () => memory.clear(),
+    clearField,
+    clearMemory: (name) => memory.remove(name),
     setLabels(map) {
       for (const [name, entry] of Object.entries(map)) {
         if (entry !== void 0) labels.set(name, entry);
@@ -348,8 +382,10 @@ function createLocalStore(o) {
   };
   const field2 = {};
   for (const entry of core.entries) {
-    const use = entry.codec.lane.persist ? persistedUse(entry) : core.memoryUse(entry);
-    field2[entry.name] = core.handle(entry, use);
+    const persisted = entry.codec.lane.persist;
+    const use = persisted ? persistedUse(entry) : core.memoryUse(entry);
+    const clear = persisted ? () => core.clearField(entry.name) : () => core.clearMemory(entry.name);
+    field2[entry.name] = core.handle(entry, use, clear);
   }
   const store = {
     field: field2,

package/dist/state/persisted.d.ts

@@ -45,4 +45,16 @@ export declare function createPersistedState<T>(opts: PersistedStateOptions<T>):
  * // stored is '1d' | '7d' | '30d' | null
  */
 export declare function readPersistedValue(key: string, version?: number): unknown | null;
+/**
+ * Write a value under the namespaced key `basalt:<key>` in the same versioned envelope
+ * `createPersistedState` writes, and wake every hook on that key — the write half of
+ * `readPersistedValue`, and plain in the same way: no React required.
+ *
+ * The one call site is a store field's `clear()`, which has to DELETE its key from the store's
+ * record from an event handler, where the hook's setter is not in reach. Not exported from the
+ * `basalt-ui/state` barrel: the two store factories are the API, this is their seam.
+ *
+ * @internal
+ */
+export declare function writePersistedValue(key: string, version: number, value: unknown): void;
 //# sourceMappingURL=persisted.d.ts.map

package/dist/state/persisted.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/state/persisted.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAOnD,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC,CAAA;IACjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;CAC/C,CAAA;AAqDD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CA8EvC;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAYhF"}
+{"version":3,"file":"persisted.d.ts","sourceRoot":"","sources":["../../src/state/persisted.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAOnD,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAA;IACnB,+EAA+E;IAC/E,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,KAAK,CAAC,CAAA;IACjE;;;OAGG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;CAC/C,CAAA;AA4FD;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EACpC,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAC7B,MAAM,SAAS,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC,CAwEvC;AAID;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAYhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAItF"}

package/dist/state/persisted.js

@@ -1,6 +1,19 @@
 import { useSyncExternalStore } from "react";
 const noopSubscribe = (_cb) => () => {
 };
+const channels = /* @__PURE__ */ new Map();
+function notify(storageKey) {
+  const channel = channels.get(storageKey);
+  if (channel === void 0) return;
+  for (const listener of channel.listeners) listener();
+}
+function channelFor(storageKey) {
+  const existing = channels.get(storageKey);
+  if (existing !== void 0) return existing;
+  const created = { listeners: /* @__PURE__ */ new Set(), handler: null };
+  channels.set(storageKey, created);
+  return created;
+}
 function isEnvelope(raw) {
   return typeof raw === "object" && raw !== null && "v" in raw && typeof raw["v"] === "number" && "value" in raw;
 }
@@ -24,33 +37,32 @@ function parseStorage(raw, opts) {
     return opts.initial;
   }
 }
-function writeStorage(opts, next) {
-  const storageKey = `basalt:${opts.key}`;
+function writeEnvelope(storageKey, version, value) {
   try {
-    const envelope = { v: opts.version, value: next };
+    const envelope = { v: version, value };
     window.localStorage.setItem(storageKey, JSON.stringify(envelope));
   } catch {
   }
 }
+function writeStorage(opts, next) {
+  writeEnvelope(`basalt:${opts.key}`, opts.version, next);
+}
 function createPersistedState(opts) {
   const storageKey = `basalt:${opts.key}`;
-  const listeners = /* @__PURE__ */ new Set();
-  let storageHandler = null;
   const subscribe = (cb) => {
-    listeners.add(cb);
-    if (storageHandler === null) {
-      storageHandler = (e) => {
-        if (e.key === storageKey) {
-          for (const listener of listeners) listener();
-        }
+    const channel = channelFor(storageKey);
+    channel.listeners.add(cb);
+    if (channel.handler === null) {
+      channel.handler = (e) => {
+        if (e.key === storageKey) notify(storageKey);
       };
-      window.addEventListener("storage", storageHandler);
+      window.addEventListener("storage", channel.handler);
     }
     return () => {
-      listeners.delete(cb);
-      if (listeners.size === 0 && storageHandler !== null) {
-        window.removeEventListener("storage", storageHandler);
-        storageHandler = null;
+      channel.listeners.delete(cb);
+      if (channel.listeners.size === 0 && channel.handler !== null) {
+        window.removeEventListener("storage", channel.handler);
+        channel.handler = null;
       }
     };
   };
@@ -73,7 +85,7 @@ function createPersistedState(opts) {
   const getServerSnapshot = () => opts.initial;
   const setState = (next) => {
     writeStorage(opts, next);
-    for (const cb of listeners) cb();
+    notify(storageKey);
   };
   const isServer = typeof window === "undefined";
   return function usePersistedState() {
@@ -99,7 +111,13 @@ function readPersistedValue(key, version) {
     return null;
   }
 }
+function writePersistedValue(key, version, value) {
+  const storageKey = `basalt:${key}`;
+  writeEnvelope(storageKey, version, value);
+  notify(storageKey);
+}
 export {
   createPersistedState,
-  readPersistedValue
+  readPersistedValue,
+  writePersistedValue
 };

package/dist/state/persisted.test.d.ts

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

package/dist/state/persisted.test.d.ts.map

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

package/dist/state.d.ts

@@ -13,5 +13,5 @@
  * `./state` export resolves to, and its named exports are pinned by `scripts/export-surface.json`.
  */
 export { createPersistedState, type PersistedStateOptions, readPersistedValue, } from './state/persisted.js';
-export { field, createLocalStore, type LocalStore, type FieldLane, type ResolvedLane, type ResolveLane, type RangeValue, type RangeParams, type RangePresets, type EnumField, type MultiField, type RangeField, type NumberField, type BooleanField, type StringField, type AnyField, type FieldValue, type FieldOption, type FieldHandle, type SearchValues, type StoredValues, type FieldCodec, type StoreEntry, type StoreCoreOptions, type StoreCore, resolveFieldCodec, createStoreCore, } from './state/fields.js';
+export { field, createLocalStore, type LocalStore, type FieldLane, type ResolvedLane, type ResolveLane, type RangeValue, type RangeParams, type RangePresets, type RangeWindow, type RangeWindows, type FieldFallback, type FieldSetOptions, type EnumField, type MultiField, type RangeField, type NumberField, type BooleanField, type StringField, type AnyField, type FieldValue, type FieldOption, type FieldHandle, type SearchValues, type StoredValues, type FieldCodec, type StoreEntry, type StoreCoreOptions, type StoreCore, type FieldUse, type FieldWrite, resolveFieldCodec, createStoreCore, } from './state/fields.js';
 //# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,KAAK,UAAU,EAEf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,oBAAoB,EACpB,KAAK,qBAAqB,EAC1B,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EACL,KAAK,EACL,gBAAgB,EAChB,KAAK,UAAU,EAEf,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,YAAY,EAEjB,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,gBAAgB,EACrB,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,iBAAiB,EACjB,eAAe,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/surfaces.d.ts

@@ -375,7 +375,7 @@ export declare const SURFACES: {
         readonly guardKinds: readonly ["raw-selection-control"];
         readonly pluginRules: readonly ["hand-rolled-filter", "control-outside-home", "control-size-literal", "responsive-twin"];
         readonly advisoryLaws: readonly ["C1 as a cross-file law (a control placed in one file, its home declared in another)", "hand-rolled section headings (argo writes `<Text fw={600} size=\"sm\">` + children, which no AST heuristic matches without false positives)", "C11 — a table/list stating its count when it is not a BasaltDataTable", "C12 — one shape for refresh/sync (SyncButton); only the alias table sees a renamed copy"];
-        readonly description: "The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size=\"ctl\" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.";
+        readonly description: "The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/NumberFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5; NumberFilter is the field.number lane, a radio list over `options` or a stepper without), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size=\"ctl\" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.";
         readonly optionalPeers: readonly [];
         readonly forbiddenImports: readonly [];
     };

package/dist/surfaces.d.ts.map

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

package/dist/surfaces.js

@@ -346,8 +346,9 @@ const SURFACES = {
     // The text lane of law C1 — the plugin's `control-outside-home` seen through a 12-line host-tag
     // window, since a regex scan has no ancestry. Same law, same wave, same promotion.
     guardKinds: ["raw-selection-control"],
-    // The control tier itself (laws C1/C3/C5/C9). `hand-rolled-filter` ships `error` — "inside a
-    // slot" is structural; the other three are grace entries in `PLUGIN_RULE_GRACE` until 1.27.0.
+    // The control tier itself (laws C1/C3/C5/C9). `hand-rolled-filter`, `control-size-literal` and
+    // `responsive-twin` all ship `error`; `control-outside-home` is the one grace entry left in
+    // `PLUGIN_RULE_GRACE`, re-dated to 1.28.0 against the wave-7 measurement (see its `why`).
     // The budget rules live on `.` with `PageBar` itself.
     pluginRules: [
       "hand-rolled-filter",
@@ -363,7 +364,7 @@ const SURFACES = {
       "C11 \u2014 a table/list stating its count when it is not a BasaltDataTable",
       "C12 \u2014 one shape for refresh/sync (SyncButton); only the alias table sees a renamed copy"
     ],
-    description: 'The control tier (docs/CONTROLS-SPEC.md \xA73): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle \u2014 no value/onChange/size, law C2/C5), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed \u2014 the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.',
+    description: 'The control tier (docs/CONTROLS-SPEC.md \xA73): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/NumberFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle \u2014 no value/onChange/size, law C2/C5; NumberFilter is the field.number lane, a radio list over `options` or a stepper without), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed \u2014 the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.',
     optionalPeers: [],
     forbiddenImports: []
   },

package/dist/widget-header/widget-header.d.ts

@@ -20,10 +20,40 @@ export type WidgetHeaderProps = {
     /** Pre-formatted metric value (mono, hero size). Renders on its own row with `delta`, directly
      * under the title row — never inline with the title. */
     value?: string;
+    /**
+     * The value's unit, rendered immediately after it on the hero row: muted, mono, `--vx-text-sm`.
+     *
+     * It exists because `value` is a pre-formatted `string` and a KPI's unit is not part of the
+     * number: `412` and `TSS` are two facts at two weights, and jamming them into one string paints
+     * the unit at the hero's 24px — which reads as a second numeral. `subtitle` was the only place a
+     * unit could go before this, and a unit on its own line under the value is a different claim (the
+     * BASIS: `7-day rolling`), so cards using both had to pick one.
+     *
+     * Never a substitute for the number's own formatting: a thousands separator, a currency symbol or
+     * a `%` belong in `value`, where they are part of how the numeral reads.
+     */
+    unit?: string;
     /** Signed delta rendered via `DeltaBadge`, on the same hero-metric row as `value`. */
     delta?: number;
     /** Comparison timeframe forwarded to `DeltaBadge` (e.g. `MoM`). */
     deltaPeriod?: string;
+    /**
+     * Formats `delta` into the chip's label — forwarded to `DeltaBadge`'s `format`. Defaults to
+     * `${Math.abs(delta).toFixed(1)}%`.
+     *
+     * It exists because not every delta is a percentage: a pace card's trend is `0:12 /km` and a
+     * throughput card's is `0.3 km/h`, and the default printed both as a percent — a wrong unit on a
+     * KPI, which is worse than no chip. A FUNCTION rather than a label string, so the number stays the
+     * number: `delta` still drives the tone and the glyph, and there is exactly one place the sign is
+     * decided.
+     *
+     * The value arrives SIGNED, so a formatter that wants to print the sign itself (`−0:12 /km`) can —
+     * pair it with `deltaGlyph={false}` so the ▼ does not say the same thing twice.
+     */
+    deltaFormat?: (delta: number) => string;
+    /** Render `DeltaBadge`'s ▲/▼ glyph. Defaults to `true`; a zero delta never shows one. Pass
+     * `false` when `deltaFormat` prints the sign itself. */
+    deltaGlyph?: boolean;
     /** Trend visual slot, rendered below the metric row. Carries `data-placement="right"` so a
      * wave-3 composer's `bleed` layout can select it. */
     sparkline?: ReactNode;
@@ -33,5 +63,5 @@ export type WidgetHeaderProps = {
     /** Right-aligned slot (`margin-inline-start: auto`) — the C1/C5 home for header actions. */
     actions?: ReactNode;
 };
-export declare function WidgetHeader({ tier, title, icon, subtitle, info, value, delta, deltaPeriod, sparkline, count, actions, }: WidgetHeaderProps): import("react").JSX.Element;
+export declare function WidgetHeader({ tier, title, icon, subtitle, info, value, unit, delta, deltaPeriod, deltaFormat, deltaGlyph, sparkline, count, actions, }: WidgetHeaderProps): import("react").JSX.Element;
 //# sourceMappingURL=widget-header.d.ts.map

package/dist/widget-header/widget-header.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"widget-header.d.ts","sourceRoot":"","sources":["../../src/widget-header/widget-header.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,MAAM,iBAAiB,GAAG;IAC9B;iDAC6C;IAC7C,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;4DACwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;yDACqD;IACrD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB,CAAA;AAyDD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,KAAK,EACL,WAAW,EACX,SAAS,EACT,KAAK,EACL,OAAO,GACR,EAAE,iBAAiB,+BAiCnB"}
+{"version":3,"file":"widget-header.d.ts","sourceRoot":"","sources":["../../src/widget-header/widget-header.tsx"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,MAAM,MAAM,iBAAiB,GAAG;IAC9B;iDAC6C;IAC7C,IAAI,EAAE,SAAS,GAAG,QAAQ,CAAA;IAC1B,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,iGAAiG;IACjG,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;4DACwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sFAAsF;IACtF,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,mEAAmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAA;IACvC;4DACwD;IACxD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;yDACqD;IACrD,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB;2EACuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,4FAA4F;IAC5F,OAAO,CAAC,EAAE,SAAS,CAAA;CACpB,CAAA;AAyDD,wBAAgB,YAAY,CAAC,EAC3B,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,IAAI,EACJ,KAAK,EACL,IAAI,EACJ,KAAK,EACL,WAAW,EACX,WAAW,EACX,UAAU,EACV,SAAS,EACT,KAAK,EACL,OAAO,GACR,EAAE,iBAAiB,+BA6CnB"}

package/dist/widget-header/widget-header.js

@@ -47,8 +47,11 @@ function WidgetHeader({
   subtitle,
   info,
   value,
+  unit,
   delta,
   deltaPeriod,
+  deltaFormat,
+  deltaGlyph,
   sparkline,
   count,
   actions
@@ -66,7 +69,16 @@ function WidgetHeader({
     ] }),
     (value !== void 0 || delta !== void 0) && /* @__PURE__ */ jsxs("div", { className: classes.metrics, children: [
       value !== void 0 && /* @__PURE__ */ jsx("span", { className: classes.value, children: value }),
-      delta !== void 0 && /* @__PURE__ */ jsx(DeltaBadge, { value: delta, period: deltaPeriod })
+      value !== void 0 && unit !== void 0 && /* @__PURE__ */ jsx("span", { className: classes.unit, children: unit }),
+      delta !== void 0 && /* @__PURE__ */ jsx(
+        DeltaBadge,
+        {
+          value: delta,
+          period: deltaPeriod,
+          ...deltaFormat !== void 0 && { format: deltaFormat },
+          ...deltaGlyph !== void 0 && { withGlyph: deltaGlyph }
+        }
+      )
     ] }),
     subtitle !== void 0 && /* @__PURE__ */ jsx("span", { className: classes.subtitle, children: subtitle }),
     sparkline !== void 0 && /* @__PURE__ */ jsx("div", { className: classes.sparkline, "data-placement": "right", children: sparkline })

package/dist/widget-header/widget-header.module.css

@@ -199,6 +199,21 @@
   color: var(--vx-ink);
 }
 
+/*
+ * The unit beside the hero value. Mono like the number it qualifies (so `412 TSS` sits on one
+ * baseline grid), `--vx-text-sm` and `--vx-muted` so it never competes with the numeral — the whole
+ * point is that a unit is the SMALL half of the pair. `flex-shrink: 0`: the value is the row's
+ * shrinkable half (see `.value`), and a unit that ellipsized to `TS…` would state nothing.
+ */
+.unit {
+  flex-shrink: 0;
+  align-self: baseline;
+  font-family: var(--basalt-font-mono);
+  font-size: var(--vx-text-sm);
+  font-weight: 500;
+  color: var(--vx-muted);
+}
+
 /* The C1/C5 home for header actions — always pinned right, regardless of what else is present. */
 .actions {
   display: inline-flex;

package/dist/widget-header/widget-header.module.css.d.ts

@@ -11,6 +11,7 @@ declare const classes: {
   readonly count: string
   readonly metrics: string
   readonly value: string
+  readonly unit: string
   readonly actions: string
   readonly subtitle: string
   readonly sparkline: string

package/llms.txt

@@ -1,4 +1,4 @@
-# basalt-ui v1.26.0
+# basalt-ui v1.27.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.26.0
+Version: 1.27.0
 
 ## basalt-ui
 Import: import { ... } from 'basalt-ui'
@@ -135,7 +135,7 @@ OptionalPeers: shiki@^4.3.0, @shikijs/langs@^4.3.1, @shikijs/themes@^4.3.1, beau
 
 ## basalt-ui/controls
 Import: import { ... } from 'basalt-ui/controls'
-Description: The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.
+Description: The control tier (docs/CONTROLS-SPEC.md §3): FilterSet (nowrap row + measured +N fold + the mobile Filters (n) sheet), RangeFilter/CompareFilter/SelectFilter/MultiSelectFilter/NumberFilter/SearchFilter/ToggleFilter (each bound to a FieldHandle — no value/onChange/size, law C2/C5; NumberFilter is the field.number lane, a radio list over `options` or a stepper without), ViewTabs, and the action/sync family (ActionGroup, OverflowMenu, SyncButton, BarAction/GlobalAction). Every control owns its own desktop/mobile swap in CSS (C9) and renders size="ctl" internally. Resolves and renders with NO @mantine/dates installed — the custom date picker is injected through RangeFilter.customPicker from ./controls-dates.
 Layer: mantine-coupled
 Rule: basalt-controls
 

package/package.json

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