basalt-ui 1.27.0 → 1.29.0

package/dist/commands/ShortcutsHelp.js

@@ -1,6 +1,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useState } from "react";
 import { Box, Group, Kbd, Stack, Text, Title } from "@mantine/core";
+import { cx } from "../common/props.js";
 import { toShortcutList } from "./projectors.js";
 import { detectMac, parseShortcut } from "./shortcut-format.js";
 import { VX } from "../tokens/index.js";
@@ -15,7 +16,12 @@ function ShortcutRow({
     /* @__PURE__ */ jsx(Group, { gap: 4, children: keys.map((key, i) => /* @__PURE__ */ jsx(Kbd, { size: "xs", children: key }, i)) })
   ] });
 }
-function ShortcutsHelp({ title = "Keyboard shortcuts", maw }) {
+function ShortcutsHelp({
+  title = "Keyboard shortcuts",
+  maw,
+  className,
+  style
+}) {
   const [isMac, setIsMac] = useState(false);
   useEffect(() => {
     setIsMac(detectMac());
@@ -32,7 +38,7 @@ function ShortcutsHelp({ title = "Keyboard shortcuts", maw }) {
       grouped.set(key, [entry]);
     }
   }
-  return /* @__PURE__ */ jsxs(Box, { maw, children: [
+  return /* @__PURE__ */ jsxs(Box, { maw, className: cx(className), ...style !== void 0 && { style }, children: [
     /* @__PURE__ */ jsx(Title, { order: 5, mb: "sm", children: title }),
     /* @__PURE__ */ jsx(Stack, { gap: "md", children: [...grouped.entries()].map(([group, entries]) => /* @__PURE__ */ jsxs(Stack, { gap: 2, children: [
       group !== "" && /* @__PURE__ */ jsx(

package/dist/commands/define-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-commands.d.ts","sourceRoot":"","sources":["../../src/commands/define-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAIvC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;IACpB,yCAAyC;IACzC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIhD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAcvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAQvF;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAExD"}
+{"version":3,"file":"define-commands.d.ts","sourceRoot":"","sources":["../../src/commands/define-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAKvC;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,wFAAwF;IACxF,KAAK,CAAC,EAAE,MAAM,IAAI,CAAA;CACnB,CAAA;AAID;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,+EAA+E;IAC/E,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;IACpB,yCAAyC;IACzC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,iBAAiB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACvD,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAIhD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAcvD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAEnD;AAID;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvF;AAED,mGAAmG;AACnG,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAExD"}

package/dist/commands/define-commands.js

@@ -1,3 +1,4 @@
+import { isDev } from "../common/is-dev.js";
 let activeCommands = {};
 function defineCommands(spec) {
   activeCommands = spec;
@@ -9,8 +10,7 @@ function defineCommand(cmd) {
 function runCommand(id, ctx) {
   const cmd = activeCommands[id];
   if (cmd === void 0) {
-    if (process.env["NODE_ENV"] !== "production")
-      console.warn(`[basalt] runCommand: no command registered for "${id}"`);
+    if (isDev()) console.warn(`[basalt] runCommand: no command registered for "${id}"`);
     return;
   }
   return cmd.run(ctx);

package/dist/commands/define-overlays.d.ts

@@ -27,6 +27,27 @@
  */
 import type { ReactNode } from 'react';
 import type { Slot } from '../register.js';
+/**
+ * Declare that a `@mantine/modals` `<ModalsProvider>` is mounted and serving, and get back the
+ * function that retracts it. `BasaltOverlays` calls this for its own provider; a consumer mounting
+ * the provider THEMSELVES (with `<BasaltOverlays modals={false} />`, or with no `BasaltOverlays` at
+ * all) calls it too, or `overlays.confirm` cannot tell their provider from no provider and rejects.
+ *
+ * There is no way to detect the provider from outside React — its context is only readable through
+ * `useModals()`, and `confirm` is an imperative call with no component to read it from. So the
+ * registration is explicit.
+ *
+ * @example
+ * useEffect(() => registerModalsProvider(), [])
+ * // …beside your own <ModalsProvider> mount.
+ */
+export declare function registerModalsProvider(): () => void;
+/**
+ * Internal — `BasaltOverlays` registers its OWN lazy `ModalsProvider` here, and only when it
+ * actually renders one. Deliberately NOT on the `./commands` barrel (internal wiring only, same as
+ * `notifications/mount-guard`); the consumer-facing half is {@link registerModalsProvider}.
+ */
+export declare function useModalsLayer(enabled: boolean): void;
 /**
  * A single registered overlay. The per-overlay props type P is the consumer's own payload.
  *
@@ -92,6 +113,68 @@ export declare function defineOverlays<const T extends OverlayMap>(spec: T): T;
  * // Then include it in a defineOverlays({ 'confirm:delete': deleteOverlay }) call to register it.
  */
 export declare function defineOverlay<P = Record<string, unknown>>(overlay: Overlay<P>): Overlay<P>;
+/** Options for {@link overlays.confirm} — a two-button dialog that resolves to the answer. */
+export type ConfirmOptions = {
+    /** Dialog title — the question itself ("Delete photo.jpg?"), not a category. */
+    title: ReactNode;
+    /** Optional body under the title. A plain string is fine; a ReactNode renders as-is. */
+    body?: ReactNode;
+    /** Confirm button label. Default: 'Confirm'. */
+    confirmLabel?: string;
+    /** Cancel button label. Default: 'Cancel'. */
+    cancelLabel?: string;
+    /** Paint the confirm button in the destructive tone (the theme's derived `red` family). */
+    danger?: boolean;
+    /** Runs once, before the promise resolves `true`. */
+    onConfirm: () => void;
+    /** Runs once on cancel, escape, click-outside or the close button — every non-confirm exit. */
+    onCancel?: () => void;
+};
+/** Options for {@link overlays.confirmDelete} — the delete idiom over {@link ConfirmOptions}. */
+export type ConfirmDeleteOptions = {
+    /**
+     * The singular noun for what is being deleted — `'item'`, `'photo'`, `'API key'`. Pluralised by
+     * appending `s` when `count` is not 1; a noun that does not pluralise that way calls
+     * {@link overlays.confirm} directly with its own title.
+     */
+    subject: string;
+    /** How many. Default: 1. */
+    count?: number;
+    /** Runs once, before the promise resolves `true`. */
+    onConfirm: () => void;
+};
+/**
+ * Open a confirm dialog and resolve to the user's answer — `true` on confirm, `false` on every
+ * other exit (cancel, escape, click-outside, the close button). `onConfirm`/`onCancel` fire exactly
+ * once each at most, before the promise settles.
+ *
+ * Rejects with a named `[basalt]` error when the modals layer cannot serve the dialog — the
+ * `@mantine/modals` peer is absent, or no `ModalsProvider` is registered as live (see
+ * {@link registerModalsProvider}). Both would otherwise leave the promise pending forever: the
+ * imperative API is a window event bus with nothing subscribed.
+ *
+ * @example
+ * if (await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })) navigate('/')
+ *
+ * @example
+ * await overlays.confirm({
+ *   title: 'Revoke access?',
+ *   body: 'The key stops working immediately.',
+ *   confirmLabel: 'Revoke',
+ *   danger: true,
+ *   onConfirm: () => revoke(),
+ * })
+ */
+declare function confirm(options: ConfirmOptions): Promise<boolean>;
+/**
+ * The delete confirmation every app writes — `confirm` with the destructive tone, the `Delete`
+ * label and a counted title already filled in.
+ *
+ * @example
+ * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+ * // → "Delete 3 items?"
+ */
+declare function confirmDelete(options: ConfirmDeleteOptions): Promise<boolean>;
 /**
  * Extract the props type for a registered overlay key.
  * When Overlays is un-augmented ({}) this resolves to `never` so open() is uncallable.
@@ -106,8 +189,13 @@ type OverlayProps<K extends OverlayKey> = Overlays extends {
  * quick-edit panels). For shareable/back-button/refreshable overlays use route masks via
  * ./router-tanstack.
  *
+ * `open` needs a REGISTERED overlay; `confirm`/`confirmDelete` need none — they are the two-button
+ * dialog every app was hand-writing as a registry entry.
+ *
  * @example
  * overlays.open('confirm:delete', { name: 'photo.jpg' })
+ * await overlays.confirm({ title: 'Discard draft?', danger: true, onConfirm: () => reset() })
+ * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
  * overlays.close()
  */
 export declare const overlays: {
@@ -122,6 +210,20 @@ export declare const overlays: {
      * overlays.open('user:edit', { id: '42' })
      */
     open<K extends OverlayKey>(key: K, props: OverlayProps<K>): void;
+    /**
+     * Open a confirm dialog and resolve to the answer — see {@link confirm}.
+     *
+     * @example
+     * const ok = await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })
+     */
+    confirm: typeof confirm;
+    /**
+     * The one-line delete idiom over {@link confirm} — see {@link confirmDelete}.
+     *
+     * @example
+     * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+     */
+    confirmDelete: typeof confirmDelete;
     /**
      * Close all open overlays (delegates to modals.closeAll()).
      *

package/dist/commands/define-overlays.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-overlays.d.ts","sourceRoot":"","sources":["../../src/commands/define-overlays.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAmBvC;;;;;;;;GAQG;AAEH,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IACjD,yDAAyD;IACzD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,iDAAiD;IACjD,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,SAAS,CAAA;CAChC,CAAA;AAED;;;;;;;GAOG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAA;AAIrD,wEAAwE;AACxE,KAAK,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,CAAA;AAE5C;;;;;;;;GAQG;AACH,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,QAAQ,EAAE,MAAM,CAAC,CAAA;AAaxD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGrE;AAID;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAE1F;AAID;;;;GAIG;AACH,KAAK,YAAY,CAAC,CAAC,SAAS,UAAU,IAAI,QAAQ,SAAS;KAAG,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAAE,GACtF,CAAC,GACD,KAAK,CAAA;AAET;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;;;;;;OASG;SACE,CAAC,SAAS,UAAU,OAAO,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAehE;;;;;OAKG;aACM,IAAI;CAGd,CAAA"}
+{"version":3,"file":"define-overlays.d.ts","sourceRoot":"","sources":["../../src/commands/define-overlays.ts"],"names":[],"mappings":"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"}

package/dist/commands/define-overlays.js

@@ -1,8 +1,27 @@
+import { useEffect } from "react";
+import { missingLayer } from "../common/errors.js";
+import { isDev } from "../common/is-dev.js";
 let modalsPromise;
 function loadModals() {
   modalsPromise ??= import("@mantine/modals").then((m) => m.modals).catch(() => void 0);
   return modalsPromise;
 }
+let mountedModalsProviders = 0;
+function registerModalsProvider() {
+  mountedModalsProviders++;
+  let released = false;
+  return () => {
+    if (released) return;
+    released = true;
+    mountedModalsProviders--;
+  };
+}
+function useModalsLayer(enabled) {
+  useEffect(() => {
+    if (!enabled) return;
+    return registerModalsProvider();
+  }, [enabled]);
+}
 let activeOverlays = {};
 function defineOverlays(spec) {
   activeOverlays = spec;
@@ -11,6 +30,71 @@ function defineOverlays(spec) {
 function defineOverlay(overlay) {
   return overlay;
 }
+async function confirm(options) {
+  const {
+    title,
+    body,
+    confirmLabel = "Confirm",
+    cancelLabel = "Cancel",
+    danger = false,
+    onConfirm,
+    onCancel
+  } = options;
+  const modals = await loadModals();
+  if (modals === void 0) {
+    throw new Error(
+      missingLayer(
+        "overlays.confirm",
+        "@mantine/modals",
+        "install the @mantine/modals peer and mount <BasaltOverlays>"
+      )
+    );
+  }
+  if (mountedModalsProviders === 0) {
+    throw new Error(
+      missingLayer(
+        "overlays.confirm",
+        "a mounted <ModalsProvider>",
+        "drop `modals={false}` from <BasaltOverlays>, or mount <ModalsProvider> yourself and call registerModalsProvider() from an effect for as long as it is up"
+      )
+    );
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const settle = (confirmed) => {
+      if (settled) return;
+      settled = true;
+      try {
+        if (confirmed) onConfirm();
+        else onCancel?.();
+      } finally {
+        resolve(confirmed);
+      }
+    };
+    modals.openConfirmModal({
+      title,
+      ...body !== void 0 && { children: body },
+      labels: { confirm: confirmLabel, cancel: cancelLabel },
+      // The destructive tone is the theme's `red` family (derived from the palette, bound to the
+      // --vx-* status tokens by cssVariablesResolver) — never a raw color.
+      ...danger && { confirmProps: { color: "red" } },
+      onConfirm: () => settle(true),
+      onCancel: () => settle(false),
+      onClose: () => settle(false)
+    });
+  });
+}
+function confirmDelete(options) {
+  const { subject, count = 1, onConfirm } = options;
+  const what = count === 1 ? subject : `${count} ${subject}s`;
+  return confirm({
+    title: `Delete ${what}?`,
+    body: "This cannot be undone.",
+    confirmLabel: "Delete",
+    danger: true,
+    onConfirm
+  });
+}
 const overlays = {
   /**
    * Open a registered overlay by key. Resolves the Overlay spec from the runtime stash and calls
@@ -25,7 +109,7 @@ const overlays = {
   open(key, props) {
     const spec = activeOverlays[key];
     if (spec === void 0) {
-      if (process.env["NODE_ENV"] !== "production")
+      if (isDev())
         console.warn(`[basalt] overlays.open: no overlay registered for "${String(key)}"`);
       return;
     }
@@ -36,6 +120,20 @@ const overlays = {
       })
     );
   },
+  /**
+   * Open a confirm dialog and resolve to the answer — see {@link confirm}.
+   *
+   * @example
+   * const ok = await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })
+   */
+  confirm,
+  /**
+   * The one-line delete idiom over {@link confirm} — see {@link confirmDelete}.
+   *
+   * @example
+   * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+   */
+  confirmDelete,
   /**
    * Close all open overlays (delegates to modals.closeAll()).
    *
@@ -49,5 +147,7 @@ const overlays = {
 export {
   defineOverlay,
   defineOverlays,
-  overlays
+  overlays,
+  registerModalsProvider,
+  useModalsLayer
 };

package/dist/commands/index.d.ts

@@ -19,7 +19,7 @@
  *   interface BasaltRegister { commands: typeof COMMANDS }
  * }
  *
- * // main.tsx — mount composable overlays (replaces <BasaltNotifications />):
+ * // main.tsx — mount composable overlays:
  * import { BasaltOverlays } from 'basalt-ui/commands'
  * import '@mantine/spotlight/styles.layer.css'
  * <BasaltProvider><BasaltOverlays><App /></BasaltOverlays></BasaltProvider>
@@ -28,13 +28,23 @@
  * import { runCommand } from 'basalt-ui/commands'
  * runCommand('file:save')
  *
+ * // usage.ts — the registry-free confirm dialog:
+ * import { overlays } from 'basalt-ui/commands'
+ * const ok = await overlays.confirm({ title: 'Discard draft?', onConfirm: () => reset() })
+ * overlays.confirmDelete({ subject: 'item', count: 3, onConfirm: () => removeSelected() })
+ *
+ * // Mounting ModalsProvider yourself instead of letting <BasaltOverlays> do it:
+ * import { registerModalsProvider } from 'basalt-ui/commands'
+ * useEffect(() => registerModalsProvider(), [])
+ *
  * // Open/close Spotlight programmatically:
  * import { openSpotlight, closeSpotlight } from 'basalt-ui/commands'
  * openSpotlight()
  */
 export { defineCommands, defineCommand, runCommand, type Command, type CommandMap, type CommandId, type CommandRunContext, } from './define-commands.js';
-export { defineOverlays, defineOverlay, overlays, type Overlay, type OverlayMap, type OverlayKey, } from './define-overlays.js';
+export { defineOverlays, defineOverlay, overlays, registerModalsProvider, type Overlay, type OverlayMap, type OverlayKey, type ConfirmOptions, type ConfirmDeleteOptions, } from './define-overlays.js';
 export { toSpotlightActions, toRouteActions, toShortcutList, toHotkeyBindings, type RouteActionItem, type RouteActionSection, type ToRouteActionsOptions, type ShortcutEntry, type HotkeyBinding, } from './projectors.js';
+export { setColorScheme, toggleSidebar, type ColorScheme, type ColorSchemeSetter, type SidebarToggle, } from './shell-bridge.js';
 export { parseShortcut, detectMac, formatShortcutDisplay } from './shortcut-format.js';
 export { useCommandHotkeys } from './useCommandHotkeys.js';
 export { ShortcutsHelp, type ShortcutsHelpProps } from './ShortcutsHelp.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAGH,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,QAAQ,EACR,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,GAChB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAGrB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGxE,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,EACL,cAAc,EACd,aAAa,EACb,UAAU,EACV,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,iBAAiB,GACvB,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,cAAc,EACd,aAAa,EACb,QAAQ,EACR,sBAAsB,EACtB,KAAK,OAAO,EACZ,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,oBAAoB,GAC1B,MAAM,mBAAmB,CAAA;AAG1B,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,gBAAgB,EAChB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAA;AAGrB,OAAO,EACL,cAAc,EACd,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGvD,OAAO,EAAE,aAAa,EAAE,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGxE,OAAO,EACL,cAAc,EACd,KAAK,mBAAmB,EACxB,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,kBAAkB,CAAA"}

package/dist/commands/index.js

@@ -6,7 +6,8 @@ import {
 import {
   defineOverlays,
   defineOverlay,
-  overlays
+  overlays,
+  registerModalsProvider
 } from "./define-overlays.js";
 import {
   toSpotlightActions,
@@ -14,6 +15,10 @@ import {
   toShortcutList,
   toHotkeyBindings
 } from "./projectors.js";
+import {
+  setColorScheme,
+  toggleSidebar
+} from "./shell-bridge.js";
 import { parseShortcut, detectMac, formatShortcutDisplay } from "./shortcut-format.js";
 import { useCommandHotkeys } from "./useCommandHotkeys.js";
 import { ShortcutsHelp } from "./ShortcutsHelp.js";
@@ -37,10 +42,13 @@ export {
   openSpotlight,
   overlays,
   parseShortcut,
+  registerModalsProvider,
   runCommand,
+  setColorScheme,
   toHotkeyBindings,
   toRouteActions,
   toShortcutList,
   toSpotlightActions,
+  toggleSidebar,
   useCommandHotkeys
 };

package/dist/commands/overlays-mount.d.ts

@@ -2,9 +2,16 @@
  * overlays-mount — composable overlay mount for basalt-ui apps.
  *
  * `BasaltOverlays` bundles ModalsProvider, Spotlight, and Notifications into a single mount point.
- * Put it inside BasaltProvider, before the router. It replaces the standalone `<BasaltNotifications />`
- * from `basalt-ui/notifications` — do NOT mount both `<BasaltOverlays notifications />` and
- * `<BasaltNotifications />` in the same tree (double-mount of `<Notifications />`).
+ * Put it inside BasaltProvider, before the router. It is the ONLY notifications mount — the
+ * standalone `basalt-ui/notifications` overlay it superseded is gone (C1 consolidation); mounting
+ * a second, hand-rolled `<Notifications />` alongside `<BasaltOverlays notifications />` still
+ * double-mounts the overlay and is still wrong for the same reason.
+ *
+ * Every layer — ModalsProvider included — mounts as a SIBLING of `children`, never as a wrapper:
+ * see the comment in the component body (R1). `@mantine/modals`' imperative API (`modals.open*`,
+ * and so basalt's own `overlays.open`) is a window CustomEvent bus that ModalsProvider subscribes
+ * to, so nothing needs to be inside it; the one thing a sibling cannot serve is Mantine's
+ * `useModals()` context hook.
  *
  * Each overlay system is opt-in via props (all default to true). Use flags to disable layers the
  * app does not need — e.g. a charts-only app that has no commands can set `spotlight={false}`.
@@ -26,8 +33,8 @@
  * code. The re-exported `openSpotlight` / `closeSpotlight` helpers delegate to this store.
  *
  * @example
- * // main.tsx — replace <BasaltNotifications /> with <BasaltOverlays>. Use the layered bundle —
- * // the unlayered one outranks basalt's `@layer basalt` styles regardless of specificity:
+ * // main.tsx — mount <BasaltOverlays>. Use the layered bundle — the unlayered one outranks
+ * // basalt's `@layer basalt` styles regardless of specificity:
  * import { BasaltOverlays } from 'basalt-ui/commands'
  * import '@mantine/spotlight/styles.layer.css'
  *
@@ -98,13 +105,11 @@ export type BasaltOverlaysProps = {
     children: ReactNode;
 };
 /**
- * Composable overlay mount — wraps children in ModalsProvider and renders Spotlight +
- * Notifications siblings. All three layers are enabled by default; pass `false` to disable.
- * A disabled layer's optional peer is never imported.
+ * Composable overlay mount — renders ModalsProvider, Spotlight and Notifications as siblings of
+ * `children`. All three layers are enabled by default; pass `false` to disable. A disabled layer's
+ * optional peer is never imported.
  *
- * Mount exactly ONE BasaltOverlays per app. Do NOT combine with a standalone
- * `<BasaltNotifications />` from `basalt-ui/notifications` — that would double-mount
- * `<Notifications />`.
+ * Mount exactly ONE BasaltOverlays per app — a second instance double-mounts `<Notifications />`.
  *
  * @example
  * <BasaltProvider>

package/dist/commands/overlays-mount.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"overlays-mount.d.ts","sourceRoot":"","sources":["../../src/commands/overlays-mount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAiC7D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;gBAChB,IAAI;iBAGH,IAAI;kBAGH,IAAI;CAGjB,CAAA;AAID,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iJAAiJ;IACjJ,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAA;IACzD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AA2FD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAmB,EAC3B,SAAS,EAAE,eAAsB,EACjC,aAAa,EAAE,mBAA0B,EACzC,OAAO,EAAE,aAAoB,EAC7B,kBAAkB,EAClB,gBAAgB,EAChB,eAAsB,EACtB,QAAQ,GACT,EAAE,mBAAmB,+BAmCrB"}
+{"version":3,"file":"overlays-mount.d.ts","sourceRoot":"","sources":["../../src/commands/overlays-mount.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,OAAO,KAAK,EAAiB,SAAS,EAAE,MAAM,OAAO,CAAA;AAGrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAmC7D;;;;;;;GAOG;AACH,eAAO,MAAM,eAAe;gBAChB,IAAI;iBAGH,IAAI;kBAGH,IAAI;CAGjB,CAAA;AAID,0DAA0D;AAC1D,wBAAgB,aAAa,IAAI,IAAI,CAEpC;AAED,2DAA2D;AAC3D,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAID,MAAM,MAAM,mBAAmB,GAAG;IAChC,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,yEAAyE;IACzE,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iJAAiJ;IACjJ,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAA;IACzD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAA;IACxC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,8BAA8B;IAC9B,QAAQ,EAAE,SAAS,CAAA;CACpB,CAAA;AAqHD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,YAAmB,EAC3B,SAAS,EAAE,eAAsB,EACjC,aAAa,EAAE,mBAA0B,EACzC,OAAO,EAAE,aAAoB,EAC7B,kBAAkB,EAClB,gBAAgB,EAChB,eAAsB,EACtB,QAAQ,GACT,EAAE,mBAAmB,+BAkCrB"}

package/dist/commands/overlays-mount.js

@@ -1,8 +1,10 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { lazy, Suspense } from "react";
 import { runCommand } from "./define-commands.js";
+import { useModalsLayer } from "./define-overlays.js";
 import { toSpotlightActions } from "./projectors.js";
 import { useCommandHotkeys } from "./useCommandHotkeys.js";
+import { useNotificationsMountGuard } from "../notifications/mount-guard.js";
 let spotlightHandlePromise;
 function loadSpotlightHandle() {
   spotlightHandlePromise ??= import("@mantine/spotlight").then(({ createSpotlight }) => {
@@ -34,6 +36,7 @@ function PassthroughFragment({ children }) {
 const LazyModalsProvider = lazy(
   () => import("@mantine/modals").then((m) => ({ default: m.ModalsProvider })).catch(() => ({ default: PassthroughFragment }))
 );
+Object.assign(LazyModalsProvider, { displayName: "LazyModalsProvider" });
 function NullFallback() {
   return null;
 }
@@ -63,12 +66,28 @@ const LazySpotlightMount = lazy(
     return { default: SpotlightMountInner };
   }).catch(() => ({ default: NullFallback }))
 );
+Object.assign(LazySpotlightMount, { displayName: "LazySpotlightMount" });
 function NotificationsFallback(_props) {
   return null;
 }
 const LazyNotifications = lazy(
   () => import("@mantine/notifications").then((m) => ({ default: m.Notifications })).catch(() => ({ default: NotificationsFallback }))
 );
+Object.assign(LazyNotifications, { displayName: "LazyNotifications" });
+function NotificationsLayer({
+  notificationsProps
+}) {
+  useNotificationsMountGuard();
+  return /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
+    LazyNotifications,
+    {
+      position: "bottom-right",
+      autoClose: 4e3,
+      limit: 5,
+      ...notificationsProps
+    }
+  ) });
+}
 function HotkeysMount() {
   useCommandHotkeys();
   return null;
@@ -83,7 +102,8 @@ function BasaltOverlays({
   projectCommands = true,
   children
 }) {
-  const content = /* @__PURE__ */ jsxs(Fragment, { children: [
+  useModalsLayer(enableModals);
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
     enableSpotlight && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
       LazySpotlightMount,
       {
@@ -91,22 +111,11 @@ function BasaltOverlays({
         ...spotlightActions !== void 0 && { extraActions: spotlightActions }
       }
     ) }),
-    enableNotifications && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(
-      LazyNotifications,
-      {
-        position: "bottom-right",
-        autoClose: 4e3,
-        limit: 5,
-        ...notificationsProps
-      }
-    ) }),
+    enableNotifications && /* @__PURE__ */ jsx(NotificationsLayer, { notificationsProps }),
     enableHotkeys && /* @__PURE__ */ jsx(HotkeysMount, {}),
+    enableModals && /* @__PURE__ */ jsx(Suspense, { fallback: null, children: /* @__PURE__ */ jsx(LazyModalsProvider, {}) }),
     children
   ] });
-  if (enableModals) {
-    return /* @__PURE__ */ jsx(Suspense, { fallback: /* @__PURE__ */ jsx(Fragment, { children: content }), children: /* @__PURE__ */ jsx(LazyModalsProvider, { children: content }) });
-  }
-  return /* @__PURE__ */ jsx(Fragment, { children: content });
 }
 export {
   BasaltOverlays,

package/dist/commands/shell-bridge.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `setColorScheme`/`toggleSidebar` — imperative shell handles, wired automatically.
+ *
+ * Command bodies run OUTSIDE the React tree (a Spotlight action, a hotkey), so a `run: () =>
+ * ...`  has no hook access to `useMantineColorScheme()` or `BasaltShell`'s collapse state. Every
+ * consumer of `defineCommands` therefore hand-rolled the SAME "register a live setter ref, read
+ * it later" bridge per action — argo's own `lib/color-scheme-bridge.ts` / `lib/sidebar-bridge.ts`
+ * are the seed for this file, right down to the reason each is its OWN leaf module: `commands.tsx`
+ * imports the router, which imports the generated route tree, which imports every route file
+ * including the one that owns the shell — so a command file importing anything back out of the
+ * shell closes a real circular module dependency (surfaces as TS's "implicitly has type any…
+ * referenced in its own initializer"). A leaf with ZERO local imports is what both sides can
+ * depend on without re-closing that cycle (`register.ts`'s `Slot` doc has the type-level half of
+ * the same story for `commands`↔`overlays`).
+ *
+ * basalt registers BOTH setters itself — `BasaltProvider` calls {@link registerColorSchemeSetter}
+ * from inside `MantineProvider` (`provider/index.tsx`'s `BasaltBridge`), `BasaltShell` calls
+ * {@link registerSidebarToggle} (`shell/index.tsx`'s `ShellFrame`) — so a consumer's own
+ * `commands.tsx` needs no `__root.tsx` wiring at all, unlike argo's hand-rolled version: mount
+ * `BasaltProvider`/`BasaltShell` once, and `setColorScheme`/`toggleSidebar` just work.
+ *
+ * Last-registered wins, same "last call wins" rule `defineCommands`/`defineOverlays`'s own runtime
+ * stash documents — two overlapping mounts (a route swap) are normal, not a race to guard against.
+ *
+ * @example
+ * // commands.ts
+ * import { defineCommands, setColorScheme, toggleSidebar } from 'basalt-ui/commands'
+ * export const COMMANDS = defineCommands({
+ *   'theme:dark': { label: 'Dark theme', run: () => setColorScheme('dark') },
+ *   'ui:toggle-sidebar': { label: 'Toggle sidebar', shortcut: 'Mod+B', run: () => toggleSidebar() },
+ * })
+ */
+export type ColorScheme = 'light' | 'dark' | 'auto';
+export type ColorSchemeSetter = (scheme: ColorScheme) => void;
+export type SidebarToggle = () => void;
+/** @internal called by `BasaltProvider`. Not part of the public API surface. */
+export declare function registerColorSchemeSetter(setter: ColorSchemeSetter | null): void;
+/** @internal called by `BasaltShell`. Not part of the public API surface. */
+export declare function registerSidebarToggle(toggle: SidebarToggle | null): void;
+/**
+ * Set the color scheme from outside the React tree. A no-op (with a dev-only console warning)
+ * when no `BasaltProvider` is mounted yet — the same "not wired" shape `runCommand`/
+ * `overlays.open` already use for an unregistered id.
+ *
+ * @example
+ * setColorScheme('dark')
+ */
+export declare function setColorScheme(scheme: ColorScheme): void;
+/**
+ * Toggle `BasaltShell`'s desktop sidebar collapse from outside the React tree. A no-op (with a
+ * dev-only console warning) when no `BasaltShell` is mounted yet.
+ *
+ * @example
+ * toggleSidebar()
+ */
+export declare function toggleSidebar(): void;
+//# sourceMappingURL=shell-bridge.d.ts.map

package/dist/commands/shell-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-bridge.d.ts","sourceRoot":"","sources":["../../src/commands/shell-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AACnD,MAAM,MAAM,iBAAiB,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAA;AAC7D,MAAM,MAAM,aAAa,GAAG,MAAM,IAAI,CAAA;AAKtC,gFAAgF;AAChF,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,GAAG,IAAI,CAEhF;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAExE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CASxD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,IAAI,CASpC"}

package/dist/commands/shell-bridge.js

@@ -0,0 +1,32 @@
+let colorSchemeSetterRef = null;
+let sidebarToggleRef = null;
+function registerColorSchemeSetter(setter) {
+  colorSchemeSetterRef = setter;
+}
+function registerSidebarToggle(toggle) {
+  sidebarToggleRef = toggle;
+}
+function setColorScheme(scheme) {
+  if (colorSchemeSetterRef === null) {
+    if (process.env["NODE_ENV"] !== "production") {
+      console.warn("[basalt] setColorScheme: no BasaltProvider is mounted yet");
+    }
+    return;
+  }
+  colorSchemeSetterRef(scheme);
+}
+function toggleSidebar() {
+  if (sidebarToggleRef === null) {
+    if (process.env["NODE_ENV"] !== "production") {
+      console.warn("[basalt] toggleSidebar: no BasaltShell is mounted yet");
+    }
+    return;
+  }
+  sidebarToggleRef();
+}
+export {
+  registerColorSchemeSetter,
+  registerSidebarToggle,
+  setColorScheme,
+  toggleSidebar
+};