basalt-ui 1.26.0 → 1.28.0

package/dist/notifications/notify.js

@@ -1,3 +1,5 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { Button, Group, Text } from "@mantine/core";
 import { notifications } from "@mantine/notifications";
 import { add } from "./store.js";
 const INTENT_COLOR = {
@@ -31,7 +33,17 @@ function nextId() {
   return `basalt-${Date.now()}-${++seq}`;
 }
 function notify(opts) {
-  const { intent = "info", message, title, icon, autoClose, id, dedupKey, action } = opts;
+  const {
+    intent = "info",
+    message,
+    title,
+    icon,
+    autoClose,
+    id,
+    dedupKey,
+    action,
+    historyMessage
+  } = opts;
   if (dedupKey !== void 0 && isDuplicateKey(dedupKey)) return id ?? nextId();
   const resolvedId = id ?? nextId();
   const color = INTENT_COLOR[intent];
@@ -50,7 +62,7 @@ function notify(opts) {
     id: resolvedId,
     intent,
     ...title !== void 0 && { title: String(title) },
-    message: String(message),
+    message: historyMessage ?? String(message),
     createdAt: Date.now(),
     ...action !== void 0 && { action }
   });
@@ -68,6 +80,36 @@ function notifyWarning(message, opts) {
 function notifyInfo(message, opts) {
   return notify({ ...opts, intent: "info", message });
 }
+const UNDO_WINDOW_MS = 6e3;
+function notifyUndo(opts) {
+  const { message, onUndo, window: undoWindow = UNDO_WINDOW_MS, onExpire } = opts;
+  const id = nextId();
+  let settled = false;
+  let timer;
+  const settle = (undone) => {
+    if (settled) return;
+    settled = true;
+    if (timer !== void 0) clearTimeout(timer);
+    notifications.hide(id);
+    if (undone) onUndo();
+    else onExpire?.();
+  };
+  timer = setTimeout(() => settle(false), undoWindow);
+  notify({
+    intent: "info",
+    id,
+    autoClose: undoWindow,
+    historyMessage: String(message),
+    message: /* @__PURE__ */ jsxs(Group, { justify: "space-between", wrap: "nowrap", gap: "sm", children: [
+      /* @__PURE__ */ jsx(Text, { span: true, size: "sm", children: message }),
+      /* @__PURE__ */ jsx(Button, { variant: "subtle", size: "compact-xs", onClick: () => settle(true), children: "Undo" })
+    ] })
+  });
+  return { id, dismiss: () => settle(false) };
+}
+function notifyUndoable(mutate, undo, opts) {
+  return notifyUndo({ ...opts, onUndo: undo, onExpire: mutate });
+}
 function notifyPromise(promise, messages) {
   const id = nextId();
   notifications.show({
@@ -123,5 +165,7 @@ export {
   notifyInfo,
   notifyPromise,
   notifySuccess,
+  notifyUndo,
+  notifyUndoable,
   notifyWarning
 };

package/dist/notifications/overlay.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/notifications/overlay.tsx"],"names":[],"mappings":"AAgCA,MAAM,MAAM,wBAAwB,GAAG;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,EACL,UAAU,GACV,WAAW,GACX,YAAY,GACZ,aAAa,GACb,cAAc,GACd,eAAe,CAAA;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAyB,EACzB,SAAgB,EAChB,KAAS,GACV,EAAE,wBAAwB,+BAE1B"}
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../src/notifications/overlay.tsx"],"names":[],"mappings":"AAiCA,MAAM,MAAM,wBAAwB,GAAG;IACrC,+CAA+C;IAC/C,QAAQ,CAAC,EACL,UAAU,GACV,WAAW,GACX,YAAY,GACZ,aAAa,GACb,cAAc,GACd,eAAe,CAAA;IACnB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,EAClC,QAAyB,EACzB,SAAgB,EAChB,KAAS,GACV,EAAE,wBAAwB,+BAG1B"}

package/dist/notifications/overlay.js

@@ -1,10 +1,12 @@
 import { jsx } from "react/jsx-runtime";
 import { Notifications } from "@mantine/notifications";
+import { useNotificationsMountGuard } from "./mount-guard.js";
 function BasaltNotifications({
   position = "bottom-right",
   autoClose = 4e3,
   limit = 5
 }) {
+  useNotificationsMountGuard();
   return /* @__PURE__ */ jsx(Notifications, { position, autoClose, limit });
 }
 export {

package/dist/notifications/store.d.ts

@@ -1,3 +1,10 @@
+/**
+ * Mantine's own notification vocabulary — kept as its own type rather than aliased to
+ * `common/props.ts`'s `Tone` (`'good' | 'warn' | 'bad'`) because `@mantine/notifications` and
+ * `INTENT_COLOR`/`INTENT_ROLE` key off exactly these four strings. Roughly:
+ * `success` ~ `Tone.good`, `error`/`warning` ~ `Tone.bad`/`Tone.warn`, `info` has no `Tone`
+ * equivalent (`ToneWithNeutral`'s `'neutral'` is the nearest fit).
+ */
 export type NotificationIntent = 'success' | 'error' | 'warning' | 'info';
 /**
  * A serializable reference to a registered action. Resolved at render time against the

package/dist/notifications/store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notifications/store.ts"],"names":[],"mappings":"AAuBA,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,kGAAkG;AAClG,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,kBAAkB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sFAAsF;IACtF,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,EAAE,CAAA;AAEhE,MAAM,MAAM,4BAA4B,GAAG;IACzC,wDAAwD;IACxD,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,8EAA8E;IAC9E,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAErE;AA0ED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AA4BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAWrE"}
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/notifications/store.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAA;AAEzE;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,CAAA;AAED,kGAAkG;AAClG,MAAM,MAAM,uBAAuB,GAAG;IACpC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,kBAAkB,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,4FAA4F;IAC5F,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sFAAsF;IACtF,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,uBAAuB,EAAE,CAAA;AAEhE,MAAM,MAAM,4BAA4B,GAAG;IACzC,wDAAwD;IACxD,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,8EAA8E;IAC9E,KAAK,EAAE,uBAAuB,EAAE,CAAA;IAChC,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAA;IACnB,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9B,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,OAAO,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7B,UAAU,EAAE,MAAM,IAAI,CAAA;IACtB,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5B,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,uBAAuB,GAAG,OAAO,CAErE;AA0ED;;;;;;GAMG;AACH,wBAAgB,GAAG,CAAC,IAAI,EAAE,uBAAuB,GAAG,IAAI,CAGvD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAGlC;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAExC;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAOjC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEvC;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,IAAI,IAAI,CAE5B;AA4BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,IAAI,4BAA4B,CAWrE"}

package/dist/provider/index.d.ts

@@ -1,6 +1,7 @@
 import type { MantineProviderProps } from '@mantine/core';
 import { Component } from 'react';
 import type { ErrorInfo, ReactNode } from 'react';
+import type { ConnectivityProviderProps } from '../connectivity/index.js';
 import type { BuildPaletteOpts } from '../tokens/index.js';
 /**
  * Where an error surfaced — drives consumer routing (a render error vs a global rejection differ).
@@ -70,13 +71,30 @@ export type BasaltProviderProps = {
      * prop; its nonce mechanism is `getStyleNonce: () => string`, which flows through `...rest`.
      */
     nonce?: string;
-    /** Optional SSE endpoint for connectivity monitoring. When set, an EventSource is opened. */
+    /**
+     * Options threaded through to the auto-mounted `ConnectivityProvider` (everything except
+     * `children`) — `sseUrl`, `healthUrl`, `healthIntervalMs`, and `override` (previously
+     * unreachable through `BasaltProvider`: the only way to reach it was a second, shadowing
+     * `ConnectivityProvider`). Takes precedence over the deprecated flattened props below when both
+     * are set.
+     */
+    connectivity?: Omit<ConnectivityProviderProps, 'children'>;
+    /**
+     * @deprecated Use `connectivity={{ sseUrl }}` instead. Still honoured when `connectivity` is
+     * unset or omits `sseUrl`; removed in 1.29.0.
+     */
     sseUrl?: string;
-    /** Optional health-check endpoint for connectivity monitoring. When set, periodic GET pings run. */
+    /**
+     * @deprecated Use `connectivity={{ healthUrl }}` instead. Still honoured when `connectivity` is
+     * unset or omits `healthUrl`; removed in 1.29.0.
+     */
     healthUrl?: string;
-    /** Interval in ms for health pings. Default: 30_000 (30s). */
+    /**
+     * @deprecated Use `connectivity={{ healthIntervalMs }}` instead. Still honoured when
+     * `connectivity` is unset or omits `healthIntervalMs`; removed in 1.29.0.
+     */
     healthIntervalMs?: number;
-} & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme'>;
+} & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme' | 'cssVariablesResolver'>;
 type BoundaryProps = {
     children: ReactNode;
     onError: (error: unknown, ctx: BasaltErrorContext) => void;
@@ -117,6 +135,20 @@ export declare class BasaltErrorBoundary extends Component<BoundaryProps, Bounda
  * rendering a React tree.
  */
 export declare function composeInjectedCss(base: string, fontsCss: string, radiusCss: string, densityCss: string): string;
-export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, sseUrl, healthUrl, healthIntervalMs, ...rest }: BasaltProviderProps): import("react").JSX.Element;
+/**
+ * Resolves the `connectivity` object against the three deprecated flattened props: `connectivity`
+ * wins WHOLESALE when provided, not per-key — a partial `connectivity={{ sseUrl }}` no longer picks
+ * up a stray `healthUrl` left on the old prop, which was surprising for a mid-migration consumer who
+ * expected the new prop to fully replace the old ones once set. Warns once, dev builds only, when
+ * both are actually supplied. Exported as a pure function (same rationale as `composeInjectedCss`
+ * above) so `provider/index.test.ts` can assert the precedence without rendering a tree.
+ */
+export declare function resolveConnectivityProps(props: {
+    connectivity: Omit<ConnectivityProviderProps, 'children'> | undefined;
+    sseUrl: string | undefined;
+    healthUrl: string | undefined;
+    healthIntervalMs: number | undefined;
+}): Omit<ConnectivityProviderProps, 'children'>;
+export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, connectivity, sseUrl, healthUrl, healthIntervalMs, ...rest }: BasaltProviderProps): import("react").JSX.Element;
 export {};
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AACzD,OAAO,EAAE,SAAS,EAAsB,MAAM,OAAO,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAIjD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAA;AAEnD,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,EAAE,SAAS,CAAA;IACnB,oFAAoF;IACpF,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAA;IACrC;;;;;;;;;;;;;;;;;;OAkBG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,cAAc,CAAC,EAAE,gBAAgB,CAAA;IACjC,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,oBAAoB,CAAC,oBAAoB,CAAC,CAAA;IAC/D;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,oBAAoB,CAAC,CAAA;AAc3E,KAAK,aAAa,GAAG;IACnB,QAAQ,EAAE,SAAS,CAAA;IACnB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC1D,mHAAmH;IACnH,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAA;CACvD,CAAA;AAED,KAAK,aAAa,GAAG;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAA;AAE1D;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,aAAa,EAAE,aAAa,CAAC;gBAClE,KAAK,EAAE,aAAa;IAKhC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAIrD,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAIxD,MAAM,IAAI,SAAS;CAQ7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAmFD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,EACL,aAAoB,EACpB,cAAc,EACd,kBAA2B,EAC3B,OAAO,EACP,KAAK,EACL,MAAM,EACN,SAAS,EACT,gBAAgB,EAChB,GAAG,IAAI,EACR,EAAE,mBAAmB,+BAkCrB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/provider/index.tsx"],"names":[],"mappings":"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"}

package/dist/provider/index.js

@@ -8,8 +8,9 @@ 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 "../utils/is-dev.js";
 function defaultOnError(error, ctx) {
-  if (process.env["NODE_ENV"] !== "production") {
+  if (isDev()) {
     console.error("[BasaltProvider] unhandled error", ctx.kind, error);
   }
 }
@@ -81,6 +82,36 @@ function BasaltBridge({
     children
   ] });
 }
+let mountedProviderCount = 0;
+function useDuplicateProviderGuard() {
+  useEffect(() => {
+    mountedProviderCount++;
+    if (mountedProviderCount > 1 && isDev()) {
+      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."
+      );
+    }
+    return () => {
+      mountedProviderCount--;
+    };
+  }, []);
+}
+function resolveConnectivityProps(props) {
+  if (props.connectivity !== void 0) {
+    const hasDeprecated = props.sseUrl !== void 0 || props.healthUrl !== void 0 || props.healthIntervalMs !== void 0;
+    if (hasDeprecated && isDev()) {
+      console.warn(
+        "[basalt] BasaltProvider: `connectivity` and one of `sseUrl`/`healthUrl`/`healthIntervalMs` were both supplied \u2014 `connectivity` wins wholesale and the deprecated props are ignored."
+      );
+    }
+    return props.connectivity;
+  }
+  return {
+    ...props.sseUrl !== void 0 ? { sseUrl: props.sseUrl } : {},
+    ...props.healthUrl !== void 0 ? { healthUrl: props.healthUrl } : {},
+    ...props.healthIntervalMs !== void 0 ? { healthIntervalMs: props.healthIntervalMs } : {}
+  };
+}
 function BasaltProvider({
   children,
   theme,
@@ -89,43 +120,50 @@ function BasaltProvider({
   defaultColorScheme = "dark",
   onError,
   nonce,
+  connectivity,
   sseUrl,
   healthUrl,
   healthIntervalMs,
   ...rest
 }) {
+  useDuplicateProviderGuard();
   const errorHandler = onError ?? defaultOnError;
   const resolvedTheme = useLabTheme(theme);
-  return /* @__PURE__ */ jsx(
-    MantineProvider,
-    {
-      theme: resolvedTheme,
-      cssVariablesResolver,
-      defaultColorScheme,
-      ...rest,
-      children: /* @__PURE__ */ jsx(BasaltErrorBoundary, { onError: errorHandler, children: /* @__PURE__ */ jsx(
-        BasaltBridge,
-        {
-          injectPalette,
-          paletteOptions,
-          nonce,
-          onError: errorHandler,
-          children: /* @__PURE__ */ jsx(
-            ConnectivityProvider,
-            {
-              ...sseUrl !== void 0 ? { sseUrl } : {},
-              ...healthUrl !== void 0 ? { healthUrl } : {},
-              ...healthIntervalMs !== void 0 ? { healthIntervalMs } : {},
-              children
-            }
-          )
-        }
-      ) })
-    }
+  const resolvedConnectivity = resolveConnectivityProps({
+    connectivity,
+    sseUrl,
+    healthUrl,
+    healthIntervalMs
+  });
+  return (
+    // `...rest` spreads FIRST so a consumer's `MantineProviderProps` can never shadow the three
+    // values that follow it — `cssVariablesResolver` in particular is the resolver the package
+    // exists to install (F24); `theme`/`defaultColorScheme` are excluded from `rest`'s type too,
+    // this is belt-and-braces against a widened rest at the call site.
+    /* @__PURE__ */ jsx(
+      MantineProvider,
+      {
+        ...rest,
+        theme: resolvedTheme,
+        cssVariablesResolver,
+        defaultColorScheme,
+        children: /* @__PURE__ */ jsx(BasaltErrorBoundary, { onError: errorHandler, children: /* @__PURE__ */ jsx(
+          BasaltBridge,
+          {
+            injectPalette,
+            paletteOptions,
+            nonce,
+            onError: errorHandler,
+            children: /* @__PURE__ */ jsx(ConnectivityProvider, { ...resolvedConnectivity, children })
+          }
+        ) })
+      }
+    )
   );
 }
 export {
   BasaltErrorBoundary,
   BasaltProvider,
-  composeInjectedCss
+  composeInjectedCss,
+  resolveConnectivityProps
 };

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;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;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;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"}

package/dist/provider/lab-theme.js

@@ -2,6 +2,7 @@ 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 "../utils/is-dev.js";
 const isPlainObject = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
 function sameLeaf(a, b) {
   if (a === b) return true;
@@ -36,7 +37,7 @@ function applyLabOverride(overrides, override) {
   });
   return mergeThemeOverrides(theme, themeOverrideDelta(baseTheme, labTheme));
 }
-const LAB_ENABLED = process.env["NODE_ENV"] !== "production";
+const LAB_ENABLED = isDev();
 function useLabThemeDev(overrides) {
   const [state] = useDeriveControlsState();
   return useMemo(() => applyLabOverride(overrides, toDeriveOverride(state)), [overrides, state]);

package/dist/query/devtools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../../src/query/devtools.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAMxE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,kBAAkB,CAAC,sCAOnF"}
+{"version":3,"file":"devtools.d.ts","sourceRoot":"","sources":["../../src/query/devtools.tsx"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,OAAO,CAAA;AAC3C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAA;AAOxE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,kBAAkB,CAAC,sCAOnF"}

package/dist/query/devtools.js

@@ -3,6 +3,7 @@ import { lazy, Suspense } from "react";
 const LazyDevtools = lazy(
   () => import("@tanstack/react-query-devtools").then((m) => ({ default: m.ReactQueryDevtools }))
 );
+Object.assign(LazyDevtools, { displayName: "LazyDevtools" });
 function BasaltQueryDevtools(props) {
   if (process.env["NODE_ENV"] === "production") return null;
   return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(LazyDevtools, { ...props }) });

package/dist/router-tanstack/field.d.ts

@@ -10,5 +10,5 @@
  * Full field reference: the JSDoc on `field` itself, and `docs/CONTROLS-SPEC.md` §4.
  */
 export { field } from '../state.js';
-export type { AnyField, BooleanField, EnumField, FieldHandle, FieldLane, FieldOption, FieldValue, MultiField, NumberField, RangeField, RangeParams, RangePresets, RangeValue, ResolvedLane, SearchValues, StoredValues, StringField, } from '../state.js';
+export type { AnyField, BooleanField, EnumField, FieldFallback, FieldHandle, FieldLane, FieldOption, FieldSetOptions, FieldValue, MultiField, NumberField, RangeField, RangeParams, RangePresets, RangeWindow, RangeWindows, RangeValue, ResolvedLane, ResolveLane, SearchValues, StoredValues, StringField, } from '../state.js';
 //# sourceMappingURL=field.d.ts.map

package/dist/router-tanstack/field.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,UAAU,CAAA"}
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/field.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AAChC,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,UAAU,CAAA"}

package/dist/router-tanstack/index.d.ts

@@ -9,7 +9,7 @@
  */
 export { createSearchStore, type CreateSearchStoreOptions, type SearchStore } from './search-store.js';
 export { field } from './field.js';
-export type { AnyField, BooleanField, EnumField, FieldHandle, FieldLane, FieldOption, FieldValue, MultiField, NumberField, RangeField, RangeParams, RangePresets, RangeValue, ResolvedLane, SearchValues, StoredValues, StringField, } from './field.js';
+export type { AnyField, BooleanField, EnumField, FieldFallback, FieldHandle, FieldLane, FieldOption, FieldSetOptions, FieldValue, MultiField, NumberField, RangeField, RangeParams, RangePresets, RangeValue, RangeWindow, RangeWindows, ResolvedLane, SearchValues, StoredValues, StringField, } from './field.js';
 export { createSearchParamStore, type SearchParamStore, type SearchParamStoreOptions, } from './search-param-store.js';
 export { createMultiSearchParamStore, type MultiSearchParamStore, type MultiSearchParamStoreOptions, } from './multi-search-param-store.js';
 export { defineNav, navGroup, navTarget, flattenNav } from './nav.js';

package/dist/router-tanstack/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACnG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,WAAW,EACX,SAAS,EACT,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1D,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,0EAA0E;QAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,oEAAoE;QACpE,IAAI,CAAC,EAAE,SAAS,CAAA;QAChB,wDAAwD;QACxD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB;CACF;AAID,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG;IACtB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;CAChE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AAID,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CASzD"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACnG,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EACV,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,aAAa,EACb,WAAW,EACX,SAAS,EACT,WAAW,EACX,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAA;AAChB,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,GAC7B,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,4BAA4B,GAClC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAClE,YAAY,EACV,WAAW,EACX,YAAY,EACZ,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,EACR,QAAQ,GACT,MAAM,OAAO,CAAA;AACd,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAClC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC1D,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAKtC,OAAO,QAAQ,wBAAwB,CAAC;IACtC,UAAU,qBAAqB;QAC7B,0EAA0E;QAC1E,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,oEAAoE;QACpE,IAAI,CAAC,EAAE,SAAS,CAAA;QAChB,wDAAwD;QACxD,UAAU,CAAC,EAAE,MAAM,CAAA;KACpB;CACF;AAID,mFAAmF;AACnF,MAAM,MAAM,SAAS,GAAG;IACtB,gEAAgE;IAChE,WAAW,EAAE,MAAM,CAAA;IACnB;;;;;OAKG;IACH,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAA;CAChE,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAUxC;AAID,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sCAAsC;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,IAAI,gBAAgB,EAAE,CASzD"}

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

@@ -34,7 +34,10 @@ export type SearchStore<S extends Record<string, AnyField>> = {
     useValues: () => SearchValues<S>;
     /** How many fields differ from their fallback — the `n` in a `Filters (n)` pill. */
     useActiveCount: () => number;
-    /** Resets every field to its fallback: one navigate, one storage write. */
+    /**
+     * Returns every field to its fallback: one navigate, one storage write. The mirror is UNSET
+     * rather than written — see `FieldHandle.clear()` for why writing the fallback pins a thunk.
+     */
     useReset: () => () => void;
 };
 /**

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":"AAiCA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAc,YAAY,EAAE,MAAM,UAAU,CAAA;AAI7F,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,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,MAAM,IAAI,CAAA;CAC3B,CAAA;AA4DD;;;;;;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;AAQD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,mBAAmB,CAAC,CAAC,CAAC,CAoMxB;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;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;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACvE,CAAC,EAAE,wBAAwB,CAAC,CAAC,CAAC,GAAG;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7D,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"}

package/dist/router-tanstack/search-store.js

@@ -1,5 +1,5 @@
 import { useNavigate, useSearch } from "@tanstack/react-router";
-import { createStoreCore } from "../state.js";
+import { createStoreCore } from "../state/fields.js";
 function warnLinkPinsFallback(input) {
   const { key, param, urlValue, storedValue } = input;
   console.warn(
@@ -19,10 +19,29 @@ function warnWriteHasNowhereToGo(input) {
     `[basalt-ui] createSearchStore('${key}'): wrote field '${name}' from a route that does not validate \`${param}\`, and the field is \`persist: false\` \u2014 so the write was dropped. Either render this control on the route wired to \`validateSearch\`, or give the field the localStorage lane (drop \`persist: false\`) so a write from elsewhere survives until the owning route reads it. (dev only)`
   );
 }
+function patchOwnsFieldMessage(input) {
+  const { key, name, owner, param } = input;
+  return `basalt-ui: createSearchStore('${key}'): set('${name}', \u2026, { patch }) carries \`${param}\`, which this store's field '${owner}' owns \u2014 the URL would take it while the localStorage mirror kept the old value, so the next paramless visit and every \`linkSearch\` link disagree with the page the write happened on. Write it through \`field.${owner}.use()[1]\` instead; a \`patch\` is for keys the store does NOT own.`;
+}
+function warnPatchDropped(input) {
+  const { key, name, param } = input;
+  console.warn(
+    `[basalt-ui] createSearchStore('${key}'): wrote field '${name}' with a \`patch\` from a route that does not validate \`${param}\` \u2014 the field's value persisted (A1), but the patch was DROPPED: there is no navigate to merge it into. Render the control on the route wired to \`validateSearch\`, or apply that sibling param on the route that owns it. (dev only)`
+  );
+}
+function assertNoLazyUrlFallback(key, fields) {
+  for (const [name, f] of Object.entries(fields)) {
+    if (typeof f.fallback !== "function" || !f.lane.url) continue;
+    throw new Error(
+      `basalt-ui: createSearchStore('${key}'): field '${name}' has a thunk fallback on the URL lane \u2014 \`validateSearch\` would evaluate it on every navigation and pin the result into the URL. Pass a value instead, or move the field off the URL lane (\`{ url: false }\`, or \`createLocalStore\`), where a lazy fallback is resolved per read.`
+    );
+  }
+}
 function isMemoryLane(entry) {
   return !entry.codec.lane.url && !entry.codec.lane.persist;
 }
 function buildSearchStore(o) {
+  assertNoLazyUrlFallback(o.key, o.fields);
   const core = createStoreCore(o);
   let readerWired = false;
   let warned = false;
@@ -30,6 +49,27 @@ function buildSearchStore(o) {
     readerWired = true;
   };
   const nowhereWarned = /* @__PURE__ */ new Set();
+  const patchDroppedWarned = /* @__PURE__ */ new Set();
+  const patchOwnerLogged = /* @__PURE__ */ new Set();
+  const paramOwners = /* @__PURE__ */ new Map();
+  for (const entry of core.urlEntries) {
+    for (const param of entry.codec.params) paramOwners.set(param, entry.name);
+  }
+  const persistedNames = new Set(
+    core.entries.filter((entry) => entry.codec.lane.persist).map((entry) => entry.name)
+  );
+  const urlClear = /* @__PURE__ */ new Map();
+  const assertPatchNotOwned = (entry, patch) => {
+    for (const param of Object.keys(patch)) {
+      const owner = paramOwners.get(param);
+      if (owner === void 0 || entry.codec.params.includes(param)) continue;
+      const message = patchOwnsFieldMessage({ key: o.key, name: entry.name, owner, param });
+      if (process.env["NODE_ENV"] !== "production") throw new Error(message);
+      if (patchOwnerLogged.has(param)) continue;
+      patchOwnerLogged.add(param);
+      console.error(message);
+    }
+  };
   const flatten = (search, record) => {
     const out = {};
     for (const entry of core.urlEntries) {
@@ -74,13 +114,40 @@ function buildSearchStore(o) {
     markReaderWired();
     const value = core.resolve(entry, search, record);
     const validated = Object.hasOwn(search, entry.codec.primary);
+    urlClear.set(entry.name, () => {
+      if (!validated) return;
+      navigate({
+        to: ".",
+        search: (prev) => ({
+          ...prev,
+          ...entry.codec.toSearch(entry.codec.fallback)
+        }),
+        replace: true,
+        resetScroll: false
+      });
+    });
     return [
       value,
-      (next) => {
+      (next, opts) => {
+        const patch = opts?.patch;
+        if (patch !== void 0 && Object.keys(patch).length > 0) {
+          assertPatchNotOwned(entry, patch);
+          if (!validated && !patchDroppedWarned.has(entry.name) && process.env["NODE_ENV"] !== "production") {
+            patchDroppedWarned.add(entry.name);
+            warnPatchDropped({ key: o.key, name: entry.name, param: entry.codec.primary });
+          }
+        }
         if (validated) {
           navigate({
             to: ".",
-            search: (prev) => ({ ...prev, ...entry.codec.toSearch(next) }),
+            // `patch` FIRST, the field's own params last: a patch is for keys the store does not
+            // own (clearing a sibling `detailDate` with `undefined`), so it must never be able to
+            // overwrite the value this very call is setting.
+            search: (prev) => ({
+              ...prev,
+              ...opts?.patch,
+              ...entry.codec.toSearch(next)
+            }),
             replace: entry.codec.lane.history === "replace",
             // A filter lives halfway down a page as often as it lives in the bar, and the router's
             // default scroll restoration treats this same-route search write as a navigation — so
@@ -109,10 +176,21 @@ function buildSearchStore(o) {
     ];
   };
   const memoryEntries = core.entries.filter(isMemoryLane);
+  const clearFor = (entry) => () => {
+    if (entry.codec.lane.persist) core.clearField(entry.name);
+    else if (!entry.codec.lane.url) core.clearMemory(entry.name);
+    if (!entry.codec.lane.url) return;
+    const clearUrl = urlClear.get(entry.name);
+    if (clearUrl !== void 0) clearUrl();
+  };
   const field = {};
   for (const entry of core.entries) {
     const use = entry.codec.lane.url ? urlUse(entry) : entry.codec.lane.persist ? localUse(entry) : core.memoryUse(entry);
-    field[entry.name] = core.handle(entry, use);
+    field[entry.name] = core.handle(
+      entry,
+      use,
+      clearFor(entry)
+    );
   }
   const useValues = () => {
     const search = useCurrentSearch();
@@ -155,11 +233,17 @@ function buildSearchStore(o) {
       }
       if (memoryEntries.length > 0) core.resetMemory();
       if (!core.anyPersisted) return;
-      const next = { ...core.readRecord() };
-      for (const entry of core.entries) {
-        if (entry.codec.lane.persist) next[entry.name] = entry.codec.fallback;
+      const record = core.readRecord();
+      const next = {};
+      let dropped = false;
+      for (const [name, value] of Object.entries(record)) {
+        if (persistedNames.has(name)) {
+          dropped = true;
+          continue;
+        }
+        next[name] = value;
       }
-      setRecord(next);
+      if (dropped) setRecord(next);
     };
   };
   const store = {

package/dist/router-tanstack/use-nav.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-nav.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/use-nav.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,KAAK,EAAE,eAAe,EAA0B,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3F,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEpF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,IAAI;IAChE;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC1D,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAA;IACxC,gBAAgB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAC5C,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAA;AAEnF;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,EAC1C,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC1C,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAgK9D"}
+{"version":3,"file":"use-nav.d.ts","sourceRoot":"","sources":["../../src/router-tanstack/use-nav.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAe,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,KAAK,EAAE,eAAe,EAA0B,cAAc,EAAE,MAAM,cAAc,CAAA;AAE3F,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEpF,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,IAAI;IAChE;;;;OAIG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAA;IAC1D,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,UAAU,KAAK,OAAO,CAAA;IACxC,gBAAgB,CAAC,EAAE,MAAM,WAAW,GAAG,IAAI,CAAA;CAC5C,CAAA;AAED,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,CAAA;AAEnF;;;;;;GAMG;AACH,wBAAgB,MAAM,CACpB,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,WAAW,CAAC,EAC1C,KAAK,CAAC,CAAC,SAAS,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAC1C,MAAM,EAAE,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,UAAU,CAqK9D"}

package/dist/router-tanstack/use-nav.js

@@ -37,7 +37,7 @@ function useNav(config, opts) {
     const toSidebarItem = (item) => {
       const Anchor = (props) => createElement(Link, {
         ...item.link,
-        activeOptions: { exact: true },
+        activeOptions: { exact: true, includeSearch: true },
         ...props
       });
       const badge = badgeOf(item.id);

package/dist/section/index.d.ts

@@ -1,2 +1,2 @@
-export { Section, type SectionProps } from './section.js';
+export { Section, type SectionProps, type SectionSlot } from './section.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/section/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/section/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAA"}