basalt-ui 1.32.0 → 1.33.0

package/dist/guard/index.js

@@ -1,3 +1,4 @@
+import { BASALT_VX_NAMES } from "./vx-names.js";
 const HEX = /#(?!(?<=&#)\d+;)[0-9a-fA-F]{3,8}\b/g;
 const FUNC = /\b(?:rgba?|hsla?)\((?!\s*\$\{)/g;
 const LOCALSTORAGE_THEME = /localStorage\s*\.\s*getItem\s*\(\s*['"]theme['"]\s*\)/g;
@@ -22,12 +23,7 @@ const CSS_WIDTH_MEDIA_QUERY = new RegExp(
 const CSS_CONTAINER_QUERY = /@container(?:\s+([\w-]+))?\s*((?:\([^)]*\)\s*(?:and\s*)?)+)/g;
 const CSS_CONTAINER_LITERAL = /(?:min-width|max-width|width)\s*(?:[<>]=?|:)\s*([\d.]+)(px|em)?/g;
 const CSS_NON_COARSE_POINTER_QUERY = /\(\s*(?:any-)?pointer\s*:\s*(?!(?:coarse|fine)\b)[a-z-]+\s*\)/g;
-const DECLARED_CONTAINER_NAMES = /* @__PURE__ */ new Set([
-  "basalt-card",
-  "basalt-form",
-  "basalt-main",
-  "basalt-grid"
-]);
+const DECLARED_CONTAINER_NAMES = /* @__PURE__ */ new Set(["basalt-card", "basalt-form", "basalt-grid"]);
 const CONTAINER_CLASS_LITERALS_PX = /* @__PURE__ */ new Set([0, 240, 239.9, 480, 479.9, 800, 799.9]);
 const SIZE_CLASS_LITERALS = /* @__PURE__ */ new Set(["52.5em", "75em", "52.49375em", "74.99375em"]);
 const SHELL_CSS_PATH = /(?:^|\/)shell\//;
@@ -53,6 +49,21 @@ function isAllowedCssRadius(value) {
 const INLINE_FONT_SIZE = /(?<![\w-;])font-?[Ss]ize\s*:\s*['"]?(\d+(?:\.\d+)?)(?:px)?['"]?(?=[,;\s}]|$)/g;
 const CARD_SURFACE_TAG = /<(?:Card|Paper)(?![\w.])(?:=>|[^>])*?>/g;
 const WITH_BORDER_PROP = /\bwithBorder\b(?!\s*=\s*\{\s*false\s*\})/;
+const VX_VAR_REF = /var\(\s*(--vx-[A-Za-z0-9-]*[A-Za-z0-9])(?![A-Za-z0-9-]|\$\{)/g;
+const VX_LOCAL_DECLARATION = /(?:^|[{;])\s*(--vx-[A-Za-z0-9-]*[A-Za-z0-9])\s*:|[{,]\s*(['"])(--vx-[A-Za-z0-9-]*[A-Za-z0-9])\2\s*:(?!\s*(?:string|number)\b)|\bsetProperty\(\s*['"](--vx-[A-Za-z0-9-]*[A-Za-z0-9])['"]/gm;
+const REMOVED_VX_NAMES = {
+  "--vx-space-touch-target": "--vx-hit",
+  "--vx-space-touch-control-height": "--vx-hit",
+  "--vx-space-app-header-mobile-actions-height": "--vx-space-sticky-header-clearance",
+  "--vx-space-sticky-header-clearance-mobile": "--vx-space-sticky-header-clearance",
+  "--vx-space-sidebar-brand-inset-top": null
+};
+const KNOWN_VX_NAMES = new Set(BASALT_VX_NAMES);
+const BASALT_VX_FAMILY_ROOTS = new Set(
+  BASALT_VX_NAMES.map((n) => /^(--vx-[A-Za-z0-9]+)-/.exec(n)?.[1]).filter(
+    (root) => root !== void 0 && !KNOWN_VX_NAMES.has(root)
+  )
+);
 const OFF_SYSTEM_SURFACE_VAR = /var\(--mantine-color-(gray|dark)-\d/g;
 const MANTINE_SHADE_INDEX = /\b(?:color|c|bg|backgroundColor|borderColor)\s*=\s*\{?\s*['"][a-z]+\.\d\b|var\(--mantine-color-(?!gray-|dark-)[a-z]+-\d/g;
 const RAW_HTML_TAG_NAME = "<(?:div|span|section|header|nav|footer|aside|main|article|ul|ol)\\b";
@@ -193,7 +204,7 @@ function titleBodyNamesThePage(body) {
 }
 const RAW_SELECTION_CONTROL_TAG = /<(SegmentedControl|Select|MultiSelect|NativeSelect|DatePickerInput|DateInput|TagsInput|Chip\.Group)(?![\w])(?:=>|[^>])*?>/g;
 const PROSE_CONTEXT_TAG = /<(?:Prose|ArticleLayout|Modal|Drawer)(?![\w])/;
-const CONTROL_HOST_TAG = /<(?:SettingsRow|Modal|Drawer|Popover\.Dropdown|Menu\.Dropdown|Composer|FilterSet|PageAside|PanelRow)(?![\w])/;
+const CONTROL_HOST_TAG = /<(?:SettingsRow|FormRow|FormGroup|Modal|Drawer|Popover\.Dropdown|Menu\.Dropdown|Composer|FilterSet|PageAside|PanelRow)(?![\w])/;
 const CONTROL_HOST_WINDOW_LINES = 12;
 const OVERLAY_CONVENTION_KEBAB = /^[^/]*-(?:modal|drawer|popover|panel|form)\.[jt]sx$/;
 const OVERLAY_CONVENTION_PASCAL = /^[A-Z]\w*(?:Modal|Drawer|Popover|Panel|Form)\.[jt]sx$/;
@@ -229,15 +240,10 @@ const DEFAULT_GUARD_CONFIG = {
   severity: {}
 };
 const GRACE_PERIOD_KINDS = {
-  "raw-selection-control": {
-    since: "1.26.0",
-    promote: "1.33.0",
-    why: "Extended 1.32.0 -> 1.33.0 at the 1.32.0 release, the last extension: basalt's own tree is at 0 (consumer-loop r1 dogfood) and argo is at 2, but RE-MEASURED 2026-09-30 the fleet carries ~33 (image-gen 11, rb 7, image-share 6, weatherorb 5, email-gateway 4, argo 2). The 1.32.0 fleet upgrade clears them while they warn, together with raw-breakpoint, so 1.33.0 promotes all four ids against a measured-clean fleet. Extended 1.31.0 -> 1.32.0 at the 1.31.0 release: the basalt tree still carries incumbents (data-table, notifications center, theme-lab) and the argo sweep has not run. new in the wave-6 control guards (docs/CONTROLS-SPEC.md \xA76, law C1). The text lane cannot see ancestry, so \"no home\" is approximated by a 12-line host-tag window \u2014 the loosest reading in the guard, and the reason this one lands warn rather than error even though its law is settled. ONE LAW, TWO LANES, ONE PROMOTION: it moves with its AST twin, `basalt/control-outside-home`, whose PLUGIN_RULE_GRACE entry carries the full argument and the measurement, and it must never be promoted or extended alone \u2014 a consumer waiving one spelling and failing the other is the exact confusion `WAIVER_ID_ALIASES` exists to close. RE-MEASURED 2026-09-09 across the whole fleet on 1.29.2: 29 AST-lane incumbents in five repos, plus three of basalt's own (data-table, notifications/center, theme-lab). Extended to 1.31.0 because 1.30.0 is the FIRST release in which either lane names a home a provider-only consumer can reach \u2014 every home both messages listed was a shell slot, and the shell-less `PageBar` sentence ships in this minor. Promoting in the same minor that makes a rule satisfiable gives nobody a window to act. 1.31.0 is when the 29 are re-measured against that number."
-  },
-  "raw-media-query": {
-    since: "1.31.0",
-    promote: "1.33.0",
-    why: "The CSS-text twin of the oxlint plugin's `basalt/raw-breakpoint` \u2014 ONE LAW, TWO LANES, ONE PROMOTION, so it moves with that rule and never alone (`configs/oxlint-plugin.test.ts` \u203A twin lanes share one promotion pins the pair). New in the wave-11 responsive/touch guards; reaching CSS is a NEW file type for this check, same reasoning as `css-raw-surface`, with incumbents in basalt's own tree at ship time, so it shipped warn. Extended 1.32.0 -> 1.33.0 with its twin: 1.31.0 named no reachable container primitive, and 1.32.0 is the first minor that documents one (`CONTAINER_CLASSES` + the declared `@container` names, MIGRATING \xA7 `basalt/raw-breakpoint`)."
+  "unknown-vx-token": {
+    since: "1.33.0",
+    promote: "1.34.0",
+    why: "New kind (consumer-loop r2 B3): obsidian lost its 44px touch floor to a removed `var(--vx-space-touch-target)` that nothing reported. A new kind rejects code every previous release accepted, so it lands warn for one minor. Measured at ship time: argo, linewatch, rb, rollhook, obsidian, weatherorb, image-share, email-gateway, image-gen 0."
   }
 };
 function severityOf(kind, cfg) {
@@ -367,6 +373,7 @@ const WAIVER_ID_ALIASES = {
   "control-outside-home": ["raw-selection-control"],
   "raw-selection-control": ["control-outside-home"]
 };
+const DUAL_LANE_IDS = /* @__PURE__ */ new Set(["in-body-page-title"]);
 const MIN_ALLOW_REASON_LENGTH = 4;
 function parseAllowAnnotation(rest, scope) {
   const rules = [];
@@ -923,7 +930,7 @@ const GUARD_RULES = {
     // handled inline (full-text tag-scoped scan + host window)
     // JSX-tag-shaped (`<Select …>`) — never appears in CSS text.
     appliesTo: (relPath) => !relPath.endsWith(".css"),
-    message: "Raw selection control with no home \u2014 a filter or tab belongs in a PageBar / Section / WidgetHeader slot and takes a `field` (a FieldHandle), so it owns the URL write and the localStorage mirror instead of carrying value/onChange (docs/CONTROLS-SPEC.md laws C1\u2013C3). Use the bound control from basalt-ui/controls. A settings row, an overlay and an @mantine/form file are the declared non-homes and never report. No shell? PageBar needs no BasaltShell: outside one it renders in flow, sticky, with its own title \u2014 so its slots are a reachable home for a provider-only app. This is the TEXT lane of basalt/control-outside-home, which answers the same question against the real AST \u2014 where the two disagree, the plugin is right."
+    message: "Raw selection control with no home \u2014 a filter or tab belongs in a PageBar / Section / WidgetHeader slot and takes a `field` (a FieldHandle), so it owns the URL write and the localStorage mirror instead of carrying value/onChange (docs/CONTROLS-SPEC.md laws C1\u2013C3). Use the bound control from basalt-ui/controls. A settings row, a FormRow / FormGroup, an overlay and an @mantine/form file are the declared non-homes and never report. No shell? PageBar needs no BasaltShell: outside one it renders in flow, sticky, with its own title \u2014 so its slots are a reachable home for a provider-only app. This is the TEXT lane of basalt/control-outside-home, which answers the same question against the real AST \u2014 where the two disagree, the plugin is right."
   },
   "inline-font-size": {
     kind: "inline-font-size",
@@ -937,7 +944,17 @@ const GUARD_RULES = {
     // CSS-only: a width @media, an @container name/literal or a non-coarse pointer query has no JSX
     // spelling — the AST-side twin of this law is the oxlint plugin's basalt/raw-breakpoint.
     appliesTo: (relPath) => relPath.endsWith(".css"),
-    message: `Raw viewport/container breakpoint in CSS \u2014 a width @media belongs to shell/** against SIZE_CLASSES (useSizeClass() is the JS seam); an @container name must be one of ${[...DECLARED_CONTAINER_NAMES].join(" / ")} at a boundary in ${[...CONTAINER_CLASS_LITERALS_PX].map((px) => `${px}px`).join(" / ")}; and a pointer query other than (pointer: coarse) or (pointer: fine) has no framework meaning. Same law the oxlint plugin enforces as basalt/raw-breakpoint over JSX; this is the CSS half.`
+    message: `Raw viewport/container breakpoint in CSS \u2014 a width @media belongs to shell/** against SIZE_CLASSES (useSizeClass() is the JS seam); an @container name must be one of ${[...DECLARED_CONTAINER_NAMES].join(" / ")}, and a basalt-card or unnamed @container query must sit at a boundary in ${[...CONTAINER_CLASS_LITERALS_PX].map((px) => `${px}px`).join(" / ")} (the other declared names have no numeric table yet, so their literals are not judged); and a pointer query other than (pointer: coarse) or (pointer: fine) has no framework meaning. Same law the oxlint plugin enforces as basalt/raw-breakpoint over JSX; this is the CSS half.`
+  },
+  "unknown-vx-token": {
+    kind: "unknown-vx-token",
+    pattern: VX_VAR_REF,
+    // handled inline (removed map + family roots); entry keeps the registry complete
+    message: `var() names a --vx-* token basalt does not emit, so it resolves to its fallback (or to nothing) with no error anywhere. Two shapes are judged, the only two basalt can judge without seeing your palette: a REMOVED name \u2014 ${Object.entries(
+      REMOVED_VX_NAMES
+    ).map(([from, to]) => `${from} \u2192 ${to ?? "(deleted, no replacement)"}`).join(
+      "; "
+    )} \u2014 and a bare family root nothing emits (${[...BASALT_VX_FAMILY_ROOTS].join(", ")}): name the token under it from basalt-ui/tokens.css. Any other unknown name is never judged, because defineSeries/groupTokens may declare it in a file this scan cannot see.`
   }
 };
 function guardKindRemedy(kind) {
@@ -1015,6 +1032,16 @@ function checkSource(text, relPath, cfg) {
   const styleIdentifiers = new Set(
     [...codeText.matchAll(STYLE_BOUND_IDENTIFIER)].map((m) => m[1] ?? "")
   );
+  const locallyDeclaredVx = new Set(
+    [...codeText.matchAll(VX_LOCAL_DECLARATION)].map((m) => m[1] ?? m[3] ?? m[4] ?? "")
+  );
+  for (const m of codeText.matchAll(VX_VAR_REF)) {
+    const name = m[1] ?? "";
+    if (locallyDeclaredVx.has(name)) continue;
+    if (!Object.hasOwn(REMOVED_VX_NAMES, name) && !BASALT_VX_FAMILY_ROOTS.has(name)) continue;
+    const at = (m.index ?? 0) + m[0].length - name.length;
+    push("unknown-vx-token", lineStarts.findLastIndex((start) => start <= at) + 1, name);
+  }
   for (let i = 0; i < lines.length; i++) {
     const line = codeLines[i] ?? "";
     for (const m of line.matchAll(GUARD_RULES["raw-hex"].pattern)) {
@@ -1270,19 +1297,28 @@ function findAllowAnnotations(text, relPath, cfg) {
     cfg.allowComment,
     syntax
   );
-  return declared.map(({ line, annotation }) => ({
-    line,
-    scope: annotation.scope,
-    rules: [...annotation.rules],
-    guardKinds: annotation.rules.filter((id) => Object.hasOwn(GUARD_RULES, id)),
-    pluginRules: annotation.rules.filter(
-      (id) => !Object.hasOwn(GUARD_RULES, id) && PLUGIN_RULE_IDS.has(id)
-    ),
-    unknownRules: [...annotation.unknownRules],
-    hasReason: annotation.hasReason,
-    bare: annotation.rules.length === 0 && annotation.unknownRules.length === 0,
-    text: lines[line - 1] ?? ""
-  }));
+  const everyOxlintRule = [...PLUGIN_RULE_IDS, ...DUAL_LANE_IDS];
+  return declared.map(({ line, annotation }) => {
+    const bare = annotation.rules.length === 0 && annotation.unknownRules.length === 0;
+    return {
+      line,
+      scope: annotation.scope,
+      rules: [...annotation.rules],
+      guardKinds: annotation.rules.filter((id) => Object.hasOwn(GUARD_RULES, id)),
+      pluginRules: annotation.rules.filter(
+        (id) => !Object.hasOwn(GUARD_RULES, id) && PLUGIN_RULE_IDS.has(id)
+      ),
+      oxlintRules: bare && annotation.scope === "line" ? everyOxlintRule : [
+        ...new Set(
+          annotation.rules.flatMap((id) => [id, ...WAIVER_ID_ALIASES[id] ?? []]).filter((id) => PLUGIN_RULE_IDS.has(id) || DUAL_LANE_IDS.has(id))
+        )
+      ],
+      unknownRules: [...annotation.unknownRules],
+      hasReason: annotation.hasReason,
+      bare,
+      text: lines[line - 1] ?? ""
+    };
+  });
 }
 const NEUTRALIZED_ALLOW_TOKEN = "basalt-audit-neutralized";
 function neutralizeAllowAnnotation(text, line, cfg) {

package/dist/guard/types.d.ts

@@ -1,7 +1,7 @@
 /**
  * Guard types — Mantine-free, dependency-free (zero imports beyond TS types).
  *
- * GuardKind is the closed set of 27 violation kinds the theme guard can emit — `unframed-chart`
+ * GuardKind is the closed set of 28 violation kinds the theme guard can emit — `unframed-chart`
  * retired at the C2 consolidation wave: its only case (a hand-authored `<ChartLegend items={[...]}>`
  * array literal) is fully subsumed by the oxlint plugin's `basalt/chart-legend-literal`, which also
  * catches the `.map()`-over-a-non-series form the regex never could. `'unframed-chart'` stays a
@@ -10,8 +10,8 @@
  * Finding is the structured result per violation, replacing the old `Violation` shape.
  * GuardConfig is the per-run configuration that drives checkSource.
  */
-/** The 27 theme-guard violation kinds. */
-export type GuardKind = 'raw-hex' | 'raw-color-fn' | 'localstorage-theme' | 'off-identity-accent' | 'mantine-shade-index' | 'raw-spacing' | 'raw-radius' | 'raw-surface' | 'card-with-border' | 'off-system-surface-var' | 'raw-html-layout' | 'inline-spacing' | 'inline-display' | 'raw-visx-axis' | 'raw-motion-value' | 'chart-missing-aria-label' | 'raw-form-control' | 'sub-16-input-font' | 'raw-font-family' | 'theme-allow-unscoped' | 'surface-shadow-override' | 'css-raw-surface' | 'inline-font-size' | 'hidden-inline-style' | 'in-body-page-title' | 'raw-selection-control' | 'raw-media-query';
+/** The 28 theme-guard violation kinds. */
+export type GuardKind = 'raw-hex' | 'raw-color-fn' | 'localstorage-theme' | 'off-identity-accent' | 'mantine-shade-index' | 'raw-spacing' | 'raw-radius' | 'raw-surface' | 'card-with-border' | 'off-system-surface-var' | 'raw-html-layout' | 'inline-spacing' | 'inline-display' | 'raw-visx-axis' | 'raw-motion-value' | 'chart-missing-aria-label' | 'raw-form-control' | 'sub-16-input-font' | 'raw-font-family' | 'theme-allow-unscoped' | 'surface-shadow-override' | 'css-raw-surface' | 'inline-font-size' | 'hidden-inline-style' | 'in-body-page-title' | 'raw-selection-control' | 'raw-media-query' | 'unknown-vx-token';
 /**
  * How hard a finding lands. `error` fails the build; `warn` reports and passes.
  *

package/dist/guard/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,0BAA0B,GAC1B,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,CAAA;AAErB;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IAC5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;CAC7D,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/guard/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,cAAc,GACd,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,kBAAkB,GAClB,wBAAwB,GACxB,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,eAAe,GACf,kBAAkB,GAClB,0BAA0B,GAC1B,kBAAkB,GAClB,mBAAmB,GACnB,iBAAiB,GACjB,sBAAsB,GACtB,yBAAyB,GACzB,iBAAiB,GACjB,kBAAkB,GAClB,qBAAqB,GACrB,oBAAoB,GACpB,uBAAuB,GACvB,iBAAiB,GACjB,kBAAkB,CAAA;AAEtB;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAA;AAE5C;;;;;;;GAOG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAA;CACjC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG;IACxB,wGAAwG;IACxG,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,uEAAuE;IACvE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,wEAAwE;IACxE,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC5C;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAA;IACnC,iGAAiG;IACjG,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAC5B;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,2GAA2G;IAC3G,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAA;IACrC,sGAAsG;IACtG,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,4FAA4F;IAC5F,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;IAC/B,yFAAyF;IACzF,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAA;IAC7B,kGAAkG;IAClG,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,qBAAqB,EAAE,OAAO,CAAA;IACvC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IAC7B;;;;;;;;;;;OAWG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,GAAG,aAAa,CAAA;IAC5C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAA;IAC1D;;;;;;;;;;;;;;;OAeG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC,CAAA;CAC7D,CAAA"}

package/dist/guard/vx-names.d.ts

@@ -0,0 +1,3 @@
+/** Every `--vx-*` name basalt emits: `dist/tokens.css` plus its component-scoped names. */
+export declare const BASALT_VX_NAMES: readonly string[];
+//# sourceMappingURL=vx-names.d.ts.map

package/dist/guard/vx-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vx-names.d.ts","sourceRoot":"","sources":["../../src/guard/vx-names.ts"],"names":[],"mappings":"AAEA,2FAA2F;AAC3F,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EA6P5C,CAAA"}

package/dist/guard/vx-names.js

@@ -0,0 +1,257 @@
+const BASALT_VX_NAMES = [
+  "--vx-accent",
+  "--vx-accent-fill",
+  "--vx-accent-fill-hover",
+  "--vx-accent-hover",
+  "--vx-accentFill",
+  "--vx-accentFillHover",
+  "--vx-accentHover",
+  "--vx-area-bottom",
+  "--vx-area-top",
+  "--vx-axis",
+  "--vx-axis-stroke",
+  "--vx-axisStroke",
+  "--vx-bad",
+  "--vx-bad-ref",
+  "--vx-bad-solid",
+  "--vx-badRef",
+  "--vx-badSolid",
+  "--vx-crosshair",
+  "--vx-divider",
+  "--vx-dot-stroke",
+  "--vx-dotStroke",
+  "--vx-faint",
+  "--vx-fill-cyan",
+  "--vx-fill-grape",
+  "--vx-fill-gray",
+  "--vx-fill-green",
+  "--vx-fill-hover-cyan",
+  "--vx-fill-hover-grape",
+  "--vx-fill-hover-gray",
+  "--vx-fill-hover-green",
+  "--vx-fill-hover-indigo",
+  "--vx-fill-hover-lime",
+  "--vx-fill-hover-orange",
+  "--vx-fill-hover-pink",
+  "--vx-fill-hover-red",
+  "--vx-fill-hover-teal",
+  "--vx-fill-hover-violet",
+  "--vx-fill-hover-yellow",
+  "--vx-fill-indigo",
+  "--vx-fill-lime",
+  "--vx-fill-orange",
+  "--vx-fill-pink",
+  "--vx-fill-red",
+  "--vx-fill-teal",
+  "--vx-fill-violet",
+  "--vx-fill-yellow",
+  "--vx-fillHover-cyan",
+  "--vx-fillHover-grape",
+  "--vx-fillHover-gray",
+  "--vx-fillHover-green",
+  "--vx-fillHover-indigo",
+  "--vx-fillHover-lime",
+  "--vx-fillHover-orange",
+  "--vx-fillHover-pink",
+  "--vx-fillHover-red",
+  "--vx-fillHover-teal",
+  "--vx-fillHover-violet",
+  "--vx-fillHover-yellow",
+  "--vx-good",
+  "--vx-good-ref",
+  "--vx-good-soft",
+  "--vx-good-solid",
+  "--vx-goodRef",
+  "--vx-goodSoft",
+  "--vx-goodSolid",
+  "--vx-grid",
+  "--vx-hit",
+  "--vx-hit-gap",
+  "--vx-ink",
+  "--vx-ink2",
+  "--vx-keyboard-inset",
+  "--vx-legend-text",
+  "--vx-legendText",
+  "--vx-line",
+  "--vx-line2",
+  "--vx-muted",
+  "--vx-neutral",
+  "--vx-on-accent",
+  "--vx-onAccent",
+  "--vx-prose-measure",
+  "--vx-radius-card",
+  "--vx-radius-ctrl",
+  "--vx-radius-fine",
+  "--vx-radius-floating",
+  "--vx-radius-pill",
+  "--vx-radius-tight",
+  "--vx-shadow-card",
+  "--vx-shadow-ctrl",
+  "--vx-shadow-overlay",
+  "--vx-shadow-raised",
+  "--vx-space-agent-code-inset",
+  "--vx-space-agent-error-inset-x",
+  "--vx-space-agent-error-inset-y",
+  "--vx-space-agent-message-inset-x",
+  "--vx-space-agent-message-inset-y",
+  "--vx-space-agent-part-gap-top",
+  "--vx-space-agent-rail-inset-x",
+  "--vx-space-agent-scroll-button-gap-top",
+  "--vx-space-agent-transcript-inset",
+  "--vx-space-app-shell-header-lead-min",
+  "--vx-space-app-shell-inset",
+  "--vx-space-app-shell-inset-mobile",
+  "--vx-space-article-card-meta-gap-top",
+  "--vx-space-article-card-tag-inset-x",
+  "--vx-space-article-card-tag-inset-y",
+  "--vx-space-article-card-tags-gap",
+  "--vx-space-article-column-gap",
+  "--vx-space-article-footer-gap",
+  "--vx-space-article-footer-margin-top",
+  "--vx-space-article-footer-padding-top",
+  "--vx-space-article-header-gap",
+  "--vx-space-article-header-margin-bottom",
+  "--vx-space-article-header-padding-bottom",
+  "--vx-space-article-meta-row-gap",
+  "--vx-space-article-nav-target-gap",
+  "--vx-space-article-toc-rail-width",
+  "--vx-space-badge-inset-x",
+  "--vx-space-badge-inset-y",
+  "--vx-space-callout-inset-x",
+  "--vx-space-callout-inset-y",
+  "--vx-space-callout-title-row-gap",
+  "--vx-space-card-inset-x",
+  "--vx-space-card-inset-y",
+  "--vx-space-code-block-body-inset-y",
+  "--vx-space-code-block-content-inset-x",
+  "--vx-space-code-block-floating-copy-offset",
+  "--vx-space-code-block-header-gap",
+  "--vx-space-code-block-header-inset-right",
+  "--vx-space-code-block-header-inset-y",
+  "--vx-space-code-block-header-right-gap",
+  "--vx-space-control-gap",
+  "--vx-space-control-height",
+  "--vx-space-control-height-ctl",
+  "--vx-space-control-height-tag",
+  "--vx-space-control-height-widget",
+  "--vx-space-guide-body-gap-bottom",
+  "--vx-space-guide-footer-gap-top",
+  "--vx-space-guide-footer-inset-top",
+  "--vx-space-icon-size",
+  "--vx-space-input-height",
+  "--vx-space-mermaid-container-inset",
+  "--vx-space-mobile-nav-icon-size",
+  "--vx-space-mobile-nav-row-height",
+  "--vx-space-mobile-nav-tab-gap",
+  "--vx-space-mobile-nav-tab-inset-x",
+  "--vx-space-mobile-nav-tab-inset-y",
+  "--vx-space-nav-icon-gap",
+  "--vx-space-page-bar-row-height",
+  "--vx-space-prose-article-block-gap",
+  "--vx-space-prose-article-h1-gap-bottom",
+  "--vx-space-prose-article-h1-gap-top",
+  "--vx-space-prose-article-h2-rule-gap",
+  "--vx-space-prose-article-heading-gap-bottom",
+  "--vx-space-prose-article-heading-gap-top",
+  "--vx-space-prose-article-list-gap-bottom",
+  "--vx-space-prose-article-list-gap-top",
+  "--vx-space-prose-article-list-indent",
+  "--vx-space-prose-article-paragraph-gap",
+  "--vx-space-prose-chat-heading-gap-bottom",
+  "--vx-space-prose-chat-heading-gap-top",
+  "--vx-space-prose-chat-list-gap-bottom",
+  "--vx-space-prose-chat-list-indent",
+  "--vx-space-prose-chat-list-item-gap",
+  "--vx-space-prose-chat-nested-list-gap",
+  "--vx-space-prose-code-block-inset-x",
+  "--vx-space-prose-code-block-inset-y",
+  "--vx-space-prose-heading-anchor-gap",
+  "--vx-space-prose-inline-code-inset-x",
+  "--vx-space-prose-inline-code-inset-y",
+  "--vx-space-prose-quote-indent",
+  "--vx-space-prose-quote-inset-y",
+  "--vx-space-prose-table-cell-inset-x",
+  "--vx-space-prose-table-cell-inset-y",
+  "--vx-space-row-inset-x",
+  "--vx-space-row-inset-y",
+  "--vx-space-row-line-height",
+  "--vx-space-section-gap",
+  "--vx-space-section-header-height",
+  "--vx-space-settings-row-gap",
+  "--vx-space-settings-row-inset-y",
+  "--vx-space-sheet-row-height",
+  "--vx-space-sidebar-account-inset-bottom",
+  "--vx-space-sidebar-account-inset-top",
+  "--vx-space-sidebar-account-inset-x",
+  "--vx-space-sidebar-avatar-size",
+  "--vx-space-sidebar-block-row-height",
+  "--vx-space-sidebar-brand-inset-x",
+  "--vx-space-sidebar-child-list-gap-bottom",
+  "--vx-space-sidebar-child-list-gap-top",
+  "--vx-space-sidebar-child-list-indent",
+  "--vx-space-sidebar-child-row-indent",
+  "--vx-space-sidebar-child-row-inset-y",
+  "--vx-space-sidebar-region-gap",
+  "--vx-space-sidebar-search-gap",
+  "--vx-space-sidebar-search-trigger-height",
+  "--vx-space-sidebar-section-gap",
+  "--vx-space-sidebar-section-label-gap",
+  "--vx-space-stack-lg",
+  "--vx-space-stack-md",
+  "--vx-space-stack-sm",
+  "--vx-space-stack-xl",
+  "--vx-space-stack-xs",
+  "--vx-space-stat-card-gap",
+  "--vx-space-sticky-header-clearance",
+  "--vx-space-toc-link-indent",
+  "--vx-space-toc-link-inset-y",
+  "--vx-space-toc-root-gap",
+  "--vx-space-toc-sub-indent",
+  "--vx-space-virtual-row-inset-x",
+  "--vx-space-virtual-row-inset-y",
+  "--vx-space-widget-header-height",
+  "--vx-status-bad",
+  "--vx-status-excellent",
+  "--vx-status-good",
+  "--vx-status-neutral",
+  "--vx-status-warn",
+  "--vx-surface-bg",
+  "--vx-surface-border",
+  "--vx-surface-elevated",
+  "--vx-surface-field",
+  "--vx-surface-hairline",
+  "--vx-surface-overlay",
+  "--vx-surface-panel",
+  "--vx-surface-panel-hover",
+  "--vx-surface-panelHover",
+  "--vx-surface-subtle",
+  "--vx-text-display",
+  "--vx-text-h1",
+  "--vx-text-h2",
+  "--vx-text-kpi",
+  "--vx-text-lg",
+  "--vx-text-md",
+  "--vx-text-micro",
+  "--vx-text-nano",
+  "--vx-text-sm",
+  "--vx-text-xl",
+  "--vx-text-xs",
+  "--vx-tooltip-bg",
+  "--vx-tooltip-border",
+  "--vx-tooltip-muted",
+  "--vx-tooltip-shadow",
+  "--vx-tooltip-text",
+  "--vx-tooltipBg",
+  "--vx-tooltipBorder",
+  "--vx-tooltipMuted",
+  "--vx-tooltipShadow",
+  "--vx-tooltipText",
+  "--vx-warn",
+  "--vx-warn-ref",
+  "--vx-warn-solid",
+  "--vx-warnRef",
+  "--vx-warnSolid"
+];
+export {
+  BASALT_VX_NAMES
+};

package/dist/notifications/mount-guard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mount-guard.d.ts","sourceRoot":"","sources":["../../src/notifications/mount-guard.ts"],"names":[],"mappings":"AAkBA;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD"}
+{"version":3,"file":"mount-guard.d.ts","sourceRoot":"","sources":["../../src/notifications/mount-guard.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,wBAAgB,0BAA0B,IAAI,IAAI,CAcjD"}

package/dist/notifications/mount-guard.js

@@ -1,10 +1,9 @@
 import { useEffect } from "react";
-import { isDev } from "../common/is-dev.js";
 let mountedNotificationsCount = 0;
 function useNotificationsMountGuard() {
   useEffect(() => {
     mountedNotificationsCount++;
-    if (mountedNotificationsCount > 1 && isDev()) {
+    if (mountedNotificationsCount > 1 && process.env.NODE_ENV !== "production") {
       console.warn(
         "[basalt] more than one Notifications overlay is mounted at once \u2014 mount exactly ONE <BasaltOverlays notifications /> (they all render Mantine's <Notifications />, so toasts would double-fire)."
       );

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

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

package/dist/provider/index.js

@@ -14,14 +14,13 @@ import { useLabTheme } from "./lab-theme.js";
 import { buildDensityCss, buildFontsCss, buildPaletteCss, buildRadiusCss } from "../tokens/index.js";
 import { isDefaultDeriveConfig } from "../tokens/derive.js";
 import { buildPaletteData } from "../tokens/palette.js";
-import { isDev } from "../common/is-dev.js";
 import { useMediaQuery } from "../common/use-media-query.js";
 import { registerColorSchemeSetter } from "../commands/shell-bridge.js";
 import { useIsomorphicLayoutEffect } from "../common/isomorphic-layout-effect.js";
 import { PageTitle } from "../shell/page-title.js";
 import { SizeClassHintContext } from "../shell/use-size-class.js";
 function defaultOnError(error, ctx) {
-  if (isDev()) {
+  if (process.env.NODE_ENV !== "production") {
     console.error("[BasaltProvider] unhandled error", ctx.kind, error);
   }
 }
@@ -142,7 +141,7 @@ function BasaltBridge({
 const providerMounts = createMountCounter();
 function useDuplicateProviderGuard() {
   useEffect(() => {
-    if (providerMounts.mount() > 1 && isDev()) {
+    if (providerMounts.mount() > 1 && process.env.NODE_ENV !== "production") {
       console.warn(
         "[basalt] BasaltProvider: more than one instance is mounted at once \u2014 nested/duplicate BasaltProviders double-mount MantineProvider, the palette <style> and ConnectivityProvider. Mount exactly one, at the app root."
       );

package/dist/provider/lab-theme.d.ts

@@ -29,10 +29,11 @@ export declare function applyLabOverride(overrides: MantineThemeOverride | undef
  */
 declare function useLabThemeDev(overrides: MantineThemeOverride | undefined): MantineThemeOverride;
 /**
- * `BasaltProvider`'s theme resolution. Picked at module scope, not per render — both implementations
- * call their hooks unconditionally at their own top level, and which one is bound never changes for
- * the app's lifetime, so the hook order is as stable as a plain function's (a `LAB_ENABLED ? use…()`
- * inline in one function body would be a conditional hook call and a `react/rules-of-hooks` error).
+ * `BasaltProvider`'s theme resolution. Picked at module scope, not per render — both
+ * implementations call their hooks unconditionally at their own top level, and which one is bound
+ * never changes for the app's lifetime, so the hook order is as stable as a plain function's (a
+ * `dev ? use…()` inline in one function body would be a conditional hook call and a
+ * `react/rules-of-hooks` error).
  */
 export declare const useLabTheme: typeof useLabThemeDev;
 export {};

package/dist/provider/lab-theme.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lab-theme.d.ts","sourceRoot":"","sources":["../../src/provider/lab-theme.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA4C/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,oBAAoB,CAWtB;AAgBD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,oBAAoB,CAGzF;AAOD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,uBAAiD,CAAA"}
+{"version":3,"file":"lab-theme.d.ts","sourceRoot":"","sources":["../../src/provider/lab-theme.ts"],"names":[],"mappings":"AAyCA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AA2C/D;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,oBAAoB,EAC1B,IAAI,EAAE,oBAAoB,GACzB,oBAAoB,CAEtB;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,oBAAoB,GAAG,SAAS,EAC3C,QAAQ,EAAE,cAAc,GAAG,IAAI,GAC9B,oBAAoB,CAWtB;AAuBD;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,SAAS,EAAE,oBAAoB,GAAG,SAAS,GAAG,oBAAoB,CAGzF;AAOD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,uBAA2E,CAAA"}

package/dist/provider/lab-theme.js

@@ -2,7 +2,6 @@ import { mergeThemeOverrides } from "@mantine/core";
 import { useMemo } from "react";
 import { useDeriveControlsState, toDeriveOverride } from "../theme-lab/derive-state.js";
 import { baseTheme, createBasaltTheme } from "../theme/index.js";
-import { isDev } from "../common/is-dev.js";
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function sameLeaf(a, b) {
   if (a === b) return true;
@@ -37,7 +36,6 @@ function applyLabOverride(overrides, override) {
   });
   return mergeThemeOverrides(theme, themeOverrideDelta(baseTheme, labTheme));
 }
-const LAB_ENABLED = isDev();
 function useLabThemeDev(overrides) {
   const [state] = useDeriveControlsState();
   return useMemo(() => applyLabOverride(overrides, toDeriveOverride(state)), [overrides, state]);
@@ -45,7 +43,7 @@ function useLabThemeDev(overrides) {
 function useLabThemeProd(overrides) {
   return useMemo(() => createBasaltTheme(overrides), [overrides]);
 }
-const useLabTheme = LAB_ENABLED ? useLabThemeDev : useLabThemeProd;
+const useLabTheme = process.env.NODE_ENV !== "production" ? useLabThemeDev : useLabThemeProd;
 export {
   applyLabOverride,
   themeOverrideDelta,

package/dist/router-tanstack/search-store.d.ts

@@ -6,6 +6,24 @@ export type CreateSearchStoreOptions<S extends Record<string, AnyField>> = {
     fields: S;
     /** Envelope version — bump when the field set changes to discard stale localStorage. */
     version?: number;
+    /**
+     * Search params this store does NOT own that a URL-lane write drops, in the SAME navigate —
+     * `['page']` on a paginated list, so narrowing the set on page 5 lands on page 1 and Back restores
+     * both together. Dropped, not written: the route's own `validateSearch` resolves the default
+     * (`page` → 1), so the store never has to know it. Applies to a URL-lane field's setter and
+     * `clear()` when the value moves, and to `useReset()` when any field moves; an explicit `patch`
+     * naming the same key wins.
+     *
+     * **URL-lane writes only.** A `url: false` field (mirror-only or memory) makes no navigate, so it
+     * has none to ride — and a `useReset()` on a store with no URL-lane field keeps the page too.
+     *
+     * Store-wide by design: every filter of a list narrows the same list. A param the store owns is
+     * refused at definition — reset a field with `useReset()` or its own `clear()`.
+     *
+     * @example
+     * createSearchStore({ key: 'shares', fields: { q: field.string({}), sort: … }, resets: ['page'] })
+     */
+    resets?: readonly string[];
 };
 export type SearchStore<S extends Record<string, AnyField>> = {
     /**

package/dist/router-tanstack/search-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-store.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/search-store.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAmB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAIlG,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI;IACzE,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAA;IACX,uFAAuF;IACvF,MAAM,EAAE,CAAC,CAAA;IACT,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI;IAC5D;;;;OAIG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;IACjE;;;;OAIG;IACH,UAAU,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,CAAA;IACjC,iFAAiF;IACjF,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1C,2FAA2F;IAC3F,KAAK,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAA;IAC5C,8FAA8F;IAC9F,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAA;IACpF,6EAA6E;IAC7E,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,oFAAoF;IACpF,cAAc,EAAE,MAAM,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,EAAE,MAAM,MAAM,IAAI,CAAA;CAC3B,CAAA;AAsGD;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACrF,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B,CAAA;AA2BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAC7B,mBAAmB,CAAC,CAAC,CAAC,CAkSxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACxE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAEhB"}
+{"version":3,"file":"search-store.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/search-store.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAmB,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAIlG,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI;IACzE,uFAAuF;IACvF,GAAG,EAAE,MAAM,CAAA;IACX,uFAAuF;IACvF,MAAM,EAAE,CAAC,CAAA;IACT,wFAAwF;IACxF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;;;;;;;;;;;;OAgBG;IACH,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI;IAC5D;;;;OAIG;IACH,cAAc,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,YAAY,CAAC,CAAC,CAAC,CAAA;IACjE;;;;OAIG;IACH,UAAU,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,CAAA;IACjC,iFAAiF;IACjF,UAAU,EAAE,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAA;IAC1C,2FAA2F;IAC3F,KAAK,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAA;IAC5C,8FAA8F;IAC9F,MAAM,EAAE,CAAC,GAAG,EAAE,OAAO,CAAC;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;KAAE,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAA;IACpF,6EAA6E;IAC7E,SAAS,EAAE,MAAM,YAAY,CAAC,CAAC,CAAC,CAAA;IAChC,oFAAoF;IACpF,cAAc,EAAE,MAAM,MAAM,CAAA;IAC5B;;;OAGG;IACH,QAAQ,EAAE,MAAM,MAAM,IAAI,CAAA;CAC3B,CAAA;AAsGD;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IACrF,eAAe,EAAE,MAAM,IAAI,CAAA;CAC5B,CAAA;AAiDD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAC7B,mBAAmB,CAAC,CAAC,CAAC,CAkUxB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACxE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAC7B,WAAW,CAAC,CAAC,CAAC,CAEhB"}