basalt-ui 1.27.0 → 1.29.0

package/dist/notifications/mount-guard.js

@@ -0,0 +1,19 @@
+import { useEffect } from "react";
+import { isDev } from "../common/is-dev.js";
+let mountedNotificationsCount = 0;
+function useNotificationsMountGuard() {
+  useEffect(() => {
+    mountedNotificationsCount++;
+    if (mountedNotificationsCount > 1 && isDev()) {
+      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)."
+      );
+    }
+    return () => {
+      mountedNotificationsCount--;
+    };
+  }, []);
+}
+export {
+  useNotificationsMountGuard
+};

package/dist/notifications/notify.d.ts

@@ -7,7 +7,8 @@
  *   2. dedupKey window — module-level Map prevents duplicate keys within 1500ms
  *
  * For loading→success/error transitions use notifyPromise — it calls notifications.update
- * (never show()) so the loading state is replaced correctly.
+ * (never show()) so the loading state is replaced correctly. For an optimistic mutation with a
+ * grace period use notifyUndo — one number is both the Undo affordance and the commit delay.
  *
  * @example
  * notify({ intent: 'success', message: 'Saved' })
@@ -31,6 +32,12 @@ export type NotifyOptions = {
      * only when calling `notify()` for an action registered in the notifications registry.
      */
     action?: NotificationActionRef;
+    /**
+     * What the persisted history records instead of `String(message)`. Only needed when `message` is
+     * a composed ReactNode the store cannot stringify — `String(<Group/>)` is `[object Object]`.
+     * `notifyUndo` passes its plain text here because its toast body carries the Undo button.
+     */
+    historyMessage?: string;
 };
 /**
  * Show a toast and record it to the notification history.
@@ -70,6 +77,56 @@ export declare function notifyWarning(message: ReactNode, opts?: Omit<NotifyOpti
  * notifyInfo('New version available')
  */
 export declare function notifyInfo(message: ReactNode, opts?: Omit<NotifyOptions, 'intent' | 'message'>): string;
+export type NotifyUndoOptions = {
+    /** The toast text, left of the Undo button. Also what the history records. */
+    message: ReactNode;
+    /** Revert the optimistic change. Runs once, on click; `onExpire` then never runs. */
+    onUndo: () => void;
+    /** How long the Undo button stays offered, in ms. Also the toast's autoClose. Default: 6000. */
+    window?: number;
+    /**
+     * The window elapsed with no undo — the place to COMMIT the optimistic mutation. Runs at most
+     * once, and never after `onUndo`.
+     */
+    onExpire?: () => void;
+};
+export type NotifyUndoHandle = {
+    /** The toast id — the same id in Mantine and in the notification history. */
+    id: string;
+    /**
+     * Close the toast early and settle the window NOW: `onExpire` runs (unless undo already did), so
+     * a dismissed toast can never strand an uncommitted mutation. Idempotent.
+     */
+    dismiss: () => void;
+};
+/**
+ * Show a toast offering an Undo for `window` ms, then commit.
+ *
+ * The affordance and the grace period are ONE number: `autoClose === window`, so the button is on
+ * screen for exactly as long as undoing still does something. Exactly one of `onUndo` / `onExpire`
+ * runs, exactly once — clicking Undo cancels the timer, and letting it elapse (or calling
+ * `dismiss()`) commits.
+ *
+ * Built on `notify`, so the toast is recorded to the notification history like any other.
+ *
+ * @example
+ * // Optimistic delete: the row is already gone from the UI; commit when the window closes.
+ * setRows((rows) => rows.filter((r) => r.id !== id))
+ * notifyUndo({
+ *   message: 'Item deleted',
+ *   onUndo: () => setRows(before),
+ *   onExpire: () => api.delete(id),
+ * })
+ */
+export declare function notifyUndo(opts: NotifyUndoOptions): NotifyUndoHandle;
+/**
+ * `notifyUndo` for the common optimistic shape: the UI already changed, `undo` puts it back, and
+ * `mutate` is what actually commits when the window closes.
+ *
+ * @example
+ * notifyUndoable(() => api.delete(id), () => setRows(before), { message: 'Item deleted' })
+ */
+export declare function notifyUndoable(mutate: () => void, undo: () => void, opts: Omit<NotifyUndoOptions, 'onUndo' | 'onExpire'>): NotifyUndoHandle;
 export type NotifyPromiseMessages = {
     loading: ReactNode;
     success: ReactNode;

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

@@ -1 +1 @@
-{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/notifications/notify.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAExE,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAoDlC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,EAAE,SAAS,CAAA;IAClB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAA;CAC/B,CAAA;AAID;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAgClD;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkDjG"}
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../src/notifications/notify.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAItC,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAExE,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAoDlC,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,OAAO,EAAE,SAAS,CAAA;IAClB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,GAAG,KAAK,CAAA;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;;OAIG;IACH,MAAM,CAAC,EAAE,qBAAqB,CAAA;IAC9B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,CAAA;AAID;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA0ClD;AAID;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,SAAS,EAClB,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,GAC/C,MAAM,CAER;AAOD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,8EAA8E;IAC9E,OAAO,EAAE,SAAS,CAAA;IAClB,qFAAqF;IACrF,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,gGAAgG;IAChG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAA;IACV;;;OAGG;IACH,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,gBAAgB,CAoCpE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,IAAI,EAClB,IAAI,EAAE,MAAM,IAAI,EAChB,IAAI,EAAE,IAAI,CAAC,iBAAiB,EAAE,QAAQ,GAAG,UAAU,CAAC,GACnD,gBAAgB,CAElB;AAID,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,SAAS,CAAA;IAClB,OAAO,EAAE,SAAS,CAAA;IAClB,KAAK,EAAE,SAAS,CAAA;CACjB,CAAA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,qBAAqB,GAAG,OAAO,CAAC,CAAC,CAAC,CAkDjG"}

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/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/connectivity-indicator.d.ts

@@ -0,0 +1,13 @@
+import type { BasaltProps } from '../common/props.js';
+export type ConnectivityIndicatorProps = BasaltProps;
+/**
+ * ConnectivityIndicator — clickable wifi icon that opens a per-signal detail popover.
+ *
+ * @example
+ * <BasaltShell
+ *   globalActions={[{ key: 'connectivity', node: <ConnectivityIndicator />, mobile: 'bar' }]}
+ *   {...rest}
+ * />
+ */
+export declare function ConnectivityIndicator({ className, style }?: ConnectivityIndicatorProps): import("react").JSX.Element;
+//# sourceMappingURL=connectivity-indicator.d.ts.map

package/dist/provider/connectivity-indicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-indicator.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-indicator.tsx"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAKlD,MAAM,MAAM,0BAA0B,GAAG,WAAW,CAAA;AAyJpD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,GAAE,0BAA+B,+BAiF1F"}

package/dist/{connectivity → provider}/connectivity-indicator.js

@@ -130,7 +130,7 @@ const ICON_COLOR = {
   degraded: VX.status.warn,
   offline: VX.status.bad
 };
-function ConnectivityIndicator() {
+function ConnectivityIndicator({ className, style } = {}) {
   const [opened, { open, toggle, close }] = useDisclosure(false);
   const { status, details } = useConnectivity();
   const statusCfg = STATUS_CONFIG[status];
@@ -156,6 +156,8 @@ function ConnectivityIndicator() {
         "aria-label": statusCfg.label,
         "aria-expanded": opened,
         "aria-haspopup": "dialog",
+        ...className !== void 0 && { className },
+        ...style !== void 0 && { style },
         children: /* @__PURE__ */ jsx(WifiIcon, {})
       }
     ) }),

package/dist/{connectivity → provider}/connectivity-provider.d.ts

@@ -1,5 +1,5 @@
 import type { ReactNode } from 'react';
-import type { ConnectivitySnapshot, ConnectivityProviderProps } from './types.js';
+import type { ConnectivitySnapshot, ConnectivityProviderProps } from './connectivity-types.js';
 export declare const ConnectivityContext: import("react").Context<ConnectivitySnapshot | null>;
 export declare function ConnectivityProvider({ children, sseUrl, healthUrl, healthIntervalMs, override, }: ConnectivityProviderProps & {
     children: ReactNode;

package/dist/provider/connectivity-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-provider.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-provider.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAmB3F,eAAO,MAAM,mBAAmB,sDAAmD,CAAA;AAyBnF,wBAAgB,oBAAoB,CAAC,EACnC,QAAQ,EACR,MAAM,EACN,SAAS,EACT,gBAAyB,EACzB,QAAQ,GACT,EAAE,yBAAyB,GAAG;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,+BAgIrD"}

package/dist/{connectivity → provider}/connectivity-provider.js

@@ -5,7 +5,10 @@ const SSR_SNAPSHOT = {
   status: "online",
   details: {
     browserOnline: true,
-    queryOnline: null,
+    // Optimistic `true`, matching `browserOnline` — `onlineManager` is a module singleton so it is
+    // always readable, this is the same pre-hydration default as every other signal, never the
+    // "not mounted" case (see `ConnectivitySnapshot['details']['queryOnline']`'s JSDoc).
+    queryOnline: true,
     sseOpen: null,
     healthPassing: null
   }

package/dist/{connectivity/types.d.ts → provider/connectivity-types.d.ts}

@@ -11,14 +11,14 @@ export type ConnectivitySnapshot = {
     /** Per-signal breakdown for debugging / detailed indicators */
     details: {
         browserOnline: boolean;
-        queryOnline: boolean | null;
+        queryOnline: boolean;
         sseOpen: boolean | null;
         healthPassing: boolean | null;
     };
 };
 export type ConnectivityOverride = {
     browserOnline?: boolean;
-    queryOnline?: boolean | null;
+    queryOnline?: boolean;
     sseOpen?: boolean | null;
     healthPassing?: boolean | null;
 };
@@ -33,4 +33,4 @@ export type ConnectivityProviderProps = {
     /** Override individual signal values for testing / simulation. Non-overridden keys use real signals. */
     override?: ConnectivityOverride;
 };
-//# sourceMappingURL=types.d.ts.map
+//# sourceMappingURL=connectivity-types.d.ts.map

package/dist/provider/connectivity-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connectivity-types.d.ts","sourceRoot":"","sources":["../../src/provider/connectivity-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAElE,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,kBAAkB,CAAA;IAC1B,+DAA+D;IAC/D,OAAO,EAAE;QACP,aAAa,EAAE,OAAO,CAAA;QAItB,WAAW,EAAE,OAAO,CAAA;QACpB,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;QACvB,aAAa,EAAE,OAAO,GAAG,IAAI,CAAA;KAC9B,CAAA;CACF,CAAA;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,OAAO,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;IACxB,aAAa,CAAC,EAAE,OAAO,GAAG,IAAI,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,iGAAiG;IACjG,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oGAAoG;IACpG,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,8DAA8D;IAC9D,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,wGAAwG;IACxG,QAAQ,CAAC,EAAE,oBAAoB,CAAA;CAChC,CAAA"}

package/dist/provider/error-fallback.module.css

@@ -0,0 +1,21 @@
+/* The boundary renders ABOVE MantineProvider, so its fallback is plain HTML styled here — no
+   Mantine primitive, no inline style object (hidden-inline-style). Tokens only. */
+.root {
+  max-width: 32rem;
+  margin: 0 auto;
+  padding: var(--vx-space-stack-xl);
+  display: flex;
+  flex-direction: column;
+  gap: var(--vx-space-stack-md);
+}
+
+.reload {
+  align-self: flex-start;
+  font: inherit;
+  cursor: pointer;
+  padding: var(--vx-space-stack-xs) var(--vx-space-stack-md);
+  border: 1px solid var(--vx-divider);
+  border-radius: var(--vx-radius-ctrl);
+  background: transparent;
+  color: inherit;
+}

package/dist/provider/error-fallback.module.css.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Typed CSS-module declaration (the S4 CSS-modules path). Named string props — not an index
+ * signature — so dot access stays verbatim under the package's strict flags.
+ */
+declare const classes: {
+  readonly root: string
+  readonly reload: string
+}
+export default classes

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-types.js';
 import type { BuildPaletteOpts } from '../tokens/index.js';
 /**
  * Where an error surfaced — drives consumer routing (a render error vs a global rejection differ).
@@ -70,17 +71,32 @@ 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. */
-    sseUrl?: string;
-    /** Optional health-check endpoint for connectivity monitoring. When set, periodic GET pings run. */
-    healthUrl?: string;
-    /** Interval in ms for health pings. Default: 30_000 (30s). */
-    healthIntervalMs?: number;
-} & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme'>;
-type BoundaryProps = {
+    /**
+     * 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`).
+     */
+    connectivity?: Omit<ConnectivityProviderProps, 'children'>;
+} & Omit<MantineProviderProps, 'children' | 'theme' | 'defaultColorScheme' | 'cssVariablesResolver'>;
+/**
+ * `BasaltErrorBoundary`'s props — exported (C5 consolidation) so a consumer mounting a nested
+ * boundary can name the type, e.g. for a wrapper component's own prop forwarding.
+ */
+export type BasaltErrorBoundaryProps = {
     children: ReactNode;
-    onError: (error: unknown, ctx: BasaltErrorContext) => void;
-    /** Optional UI to render when a render error is caught. If a function, called with the error. Defaults to null. */
+    /**
+     * Report the caught render error. Unset → `defaultOnError` (console.error in dev, no-op in
+     * prod — the same fallback `BasaltProvider`'s own top-level `onError` uses), so a NESTED
+     * boundary mounted with no `onError` still surfaces something in dev instead of silently
+     * swallowing it.
+     */
+    onError?: (error: unknown, ctx: BasaltErrorContext) => void;
+    /**
+     * UI to render when a render error is caught. If a function, called with the error. Unset →
+     * {@link DefaultErrorFallback} — a minimal `PageTitle` + reload button, never a silent `null`;
+     * pass `fallback={null}` explicitly for the old swallow-it behaviour.
+     */
     fallback?: ReactNode | ((error: unknown) => ReactNode);
 };
 type BoundaryState = {
@@ -97,8 +113,8 @@ type BoundaryState = {
  *   <MyFeature />
  * </BasaltErrorBoundary>
  */
-export declare class BasaltErrorBoundary extends Component<BoundaryProps, BoundaryState> {
-    constructor(props: BoundaryProps);
+export declare class BasaltErrorBoundary extends Component<BasaltErrorBoundaryProps, BoundaryState> {
+    constructor(props: BasaltErrorBoundaryProps);
     static getDerivedStateFromError(error: unknown): BoundaryState;
     componentDidCatch(error: unknown, info: ErrorInfo): void;
     render(): ReactNode;
@@ -117,6 +133,6 @@ 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;
+export declare function BasaltProvider({ children, theme, injectPalette, paletteOptions, defaultColorScheme, onError, nonce, connectivity, ...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":"AAuBA,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;AAIjD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA;AAIrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAA;AAOjD;;;;;;;;;;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;;;;;OAKG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,yBAAyB,EAAE,UAAU,CAAC,CAAA;CAC3D,GAAG,IAAI,CAAC,oBAAoB,EAAE,UAAU,GAAG,OAAO,GAAG,oBAAoB,GAAG,sBAAsB,CAAC,CAAA;AAcpG;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,EAAE,SAAS,CAAA;IACnB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,kBAAkB,KAAK,IAAI,CAAA;IAC3D;;;;OAIG;IACH,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;AA2B1D;;;;;;;;;GASG;AACH,qBAAa,mBAAoB,SAAQ,SAAS,CAAC,wBAAwB,EAAE,aAAa,CAAC;gBAC7E,KAAK,EAAE,wBAAwB;IAK3C,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;IAIrD,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,IAAI;IAKxD,MAAM,IAAI,SAAS;CAS7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAwHD,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,KAAK,EACL,aAAoB,EACpB,cAAc,EACd,kBAA2B,EAC3B,OAAO,EACP,KAAK,EACL,YAAY,EACZ,GAAG,IAAI,EACR,EAAE,mBAAmB,+BAmCrB"}

package/dist/provider/index.js

@@ -1,18 +1,47 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { MantineProvider, useComputedColorScheme, useMantineTheme } from "@mantine/core";
+import {
+  MantineProvider,
+  useComputedColorScheme,
+  useMantineColorScheme,
+  useMantineTheme
+} from "@mantine/core";
 import { Component, useEffect, useMemo } from "react";
 import { VxThemeProvider } from "../charts/theme.js";
-import { ConnectivityProvider } from "../connectivity/index.js";
+import fallbackClasses from "./error-fallback.module.css";
+import { ConnectivityProvider } from "./connectivity-provider.js";
 import { cssVariablesResolver } from "../theme/index.js";
 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 { registerColorSchemeSetter } from "../commands/shell-bridge.js";
+import { PageTitle } from "../shell/page-title.js";
 function defaultOnError(error, ctx) {
-  if (process.env["NODE_ENV"] !== "production") {
+  if (isDev()) {
     console.error("[BasaltProvider] unhandled error", ctx.kind, error);
   }
 }
+function DefaultErrorFallback() {
+  return /* @__PURE__ */ jsxs("div", { className: fallbackClasses.root, children: [
+    /* @__PURE__ */ jsx(
+      PageTitle,
+      {
+        title: "Something went wrong",
+        subtitle: "The page hit an unexpected error and was unloaded to keep the app stable."
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        className: fallbackClasses.reload,
+        onClick: () => window.location.reload(),
+        children: "Reload page"
+      }
+    )
+  ] });
+}
 class BasaltErrorBoundary extends Component {
   constructor(props) {
     super(props);
@@ -22,12 +51,14 @@ class BasaltErrorBoundary extends Component {
     return { hasError: true, error };
   }
   componentDidCatch(error, info) {
-    this.props.onError(error, { kind: "render", info });
+    const onError = this.props.onError ?? defaultOnError;
+    onError(error, { kind: "render", info });
   }
   render() {
     if (this.state.hasError) {
       const { fallback } = this.props;
-      if (fallback === void 0) return null;
+      if (fallback === void 0) return /* @__PURE__ */ jsx(DefaultErrorFallback, {});
+      if (fallback === null) return null;
       return typeof fallback === "function" ? fallback(this.state.error) : fallback;
     }
     return this.props.children;
@@ -44,6 +75,11 @@ function BasaltBridge({
   onError
 }) {
   const resolved = useComputedColorScheme("dark");
+  const { setColorScheme: setMantineColorScheme } = useMantineColorScheme();
+  useEffect(() => {
+    registerColorSchemeSetter(setMantineColorScheme);
+    return () => registerColorSchemeSetter(null);
+  }, [setMantineColorScheme]);
   const theme = useMantineTheme();
   const deriveConfig = theme.other?.basaltDerive;
   const fontsConfig = theme.other?.basaltFonts;
@@ -81,6 +117,20 @@ 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 BasaltProvider({
   children,
   theme,
@@ -89,39 +139,37 @@ function BasaltProvider({
   defaultColorScheme = "dark",
   onError,
   nonce,
-  sseUrl,
-  healthUrl,
-  healthIntervalMs,
+  connectivity,
   ...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 = connectivity ?? {};
+  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 {

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 "../common/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/provider/use-connectivity.d.ts

@@ -0,0 +1,3 @@
+import type { ConnectivitySnapshot } from './connectivity-types.js';
+export declare function useConnectivity(): ConnectivitySnapshot;
+//# sourceMappingURL=use-connectivity.d.ts.map

package/dist/provider/use-connectivity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-connectivity.d.ts","sourceRoot":"","sources":["../../src/provider/use-connectivity.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAEhE,wBAAgB,eAAe,IAAI,oBAAoB,CAUtD"}