basalt-ui 1.41.0 → 2.0.0

package/dist/commands/ShortcutsHelp.js

@@ -1,10 +1,12 @@
 import { jsx, jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
+import { useSyncExternalStore } 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";
+const subscribeNever = () => () => {
+};
 function ShortcutRow({
   label,
   shortcut,
@@ -22,10 +24,7 @@ function ShortcutsHelp({
   className,
   style
 }) {
-  const [isMac, setIsMac] = useState(false);
-  useEffect(() => {
-    setIsMac(detectMac());
-  }, []);
+  const isMac = useSyncExternalStore(subscribeNever, detectMac, () => false);
   const shortcuts = toShortcutList();
   if (shortcuts.length === 0) return null;
   const grouped = /* @__PURE__ */ new Map();

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

@@ -1,9 +1,9 @@
 /**
  * define-commands — const-generic factory for typed command registries.
  *
- * Consumer defines their commands with defineCommands, augments BasaltRegister.commands, then uses
- * runCommand — unknown ids are tsc errors. The type slot gives the compile-time id union; the
- * module-level stash gives the runtime values (type augmentation is erased at runtime).
+ * Consumer defines their commands with defineCommands and augments BasaltRegister.commands.
+ * `BasaltProvider` reads the module-level stash for its Spotlight actions and hotkeys (type
+ * augmentation is erased at runtime; the stash is the live source).
  *
  * @example
  * // commands.ts (app-side)
@@ -16,12 +16,8 @@
  * declare module 'basalt-ui' {
  *   interface BasaltRegister { commands: typeof COMMANDS }
  * }
- *
- * // usage.ts
- * import { runCommand } from 'basalt-ui/commands'
- * runCommand('file:save')    // ✓ typed
- * runCommand('nonexistent')  // ✗ tsc error
  */
+import type { Hotkey } from '@tanstack/react-hotkeys';
 import type { ReactNode } from 'react';
 import type { Slot } from '../register.js';
 /**
@@ -33,7 +29,7 @@ import type { Slot } from '../register.js';
  * })
  */
 export type CommandRunContext = {
-    /** Close the command palette (if open) before executing. Injected by BasaltOverlays. */
+    /** Close the command palette (if open) before executing. Injected by the palette. */
     close?: () => void;
 };
 /**
@@ -56,11 +52,12 @@ export type Command = {
     /** Optional icon (ReactNode — no @tabler/icons dependency per house rules). */
     icon?: ReactNode;
     /**
-     * Optional keyboard shortcut string. Drives BOTH the ShortcutsHelp display AND live key
-     * binding via useCommandHotkeys() (which registers with @tanstack/react-hotkeys optional peer).
-     * Convention: 'Mod+S' (Mod = Cmd on mac, Ctrl elsewhere), 'Shift+Mod+P', etc.
+     * Optional keyboard shortcut, typed as the peer's `Hotkey` so a typo (`'Cmd+B'`) is a compile
+     * error. Drives BOTH the ShortcutsHelp display AND live key
+     * binding by `BasaltProvider` (through the @tanstack/react-hotkeys optional peer).
+     * Convention: 'Mod+S' (Mod = Cmd on mac, Ctrl elsewhere), 'Mod+Shift+P', etc.
      */
-    shortcut?: string;
+    shortcut?: Hotkey;
     /**
      * Optional predicate — when() returning false hides the command from the palette.
      * Useful for context-sensitive commands (e.g. "save" only when a form is dirty).
@@ -94,10 +91,10 @@ type Commands = Slot<'commands', CommandMap>;
 export type CommandId = Extract<keyof Commands, string>;
 /**
  * Define a typed command map. Const-generic identity passthrough — preserves the exact literal
- * keys so `runCommand('nonexistent')` is a tsc error after augmenting BasaltRegister.
+ * keys so the id union is exact after augmenting BasaltRegister.
  *
- * Stashes the runtime map so `runCommand` and `toSpotlightActions` resolve correctly at runtime
- * (type augmentation is erased; the stash is the live source).
+ * Stashes the runtime map so the provider resolves commands at runtime (type augmentation is
+ * erased; the stash is the live source).
  *
  * @example
  * export const COMMANDS = defineCommands({
@@ -114,27 +111,14 @@ export declare function defineCommands<const T extends CommandMap>(spec: T): T;
  *
  * WARNING: defineCommand only TYPES a command — it does NOT register it into the runtime stash.
  * Only defineCommands(map) registers commands. Calling defineCommand alone means the command will
- * never appear in the palette or be reachable via runCommand.
+ * never appear in the palette or bind its shortcut.
  *
  * @example
  * const saveCmd = defineCommand({ label: 'Save', shortcut: 'Mod+S', run: () => save() })
  * // Then include saveCmd in a defineCommands({ 'file:save': saveCmd }) call to register it.
  */
 export declare function defineCommand(cmd: Command): Command;
-/**
- * Run a registered command by id. The id must be a key of the consumer's registered
- * `BasaltRegister.commands` map — any other string is a tsc error.
- *
- * Resolves the command's run function from the runtime stash (NOT from the type slot — that is
- * erased). Un-augmented (Commands = {}): CommandId = never → `runCommand` is effectively
- * uncallable. Augmented: only the registered keys are accepted.
- *
- * @example
- * runCommand('file:save')
- * await runCommand('data:sync', { close: () => closeModal() })
- */
-export declare function runCommand(id: CommandId, ctx?: CommandRunContext): void | Promise<void>;
-/** @internal — exposed for projectors.ts to iterate the runtime stash. Returns a readonly view. */
+/** @internal — exposed to the provider and projectors.ts to iterate the runtime stash. Returns a readonly view. */
 export declare function getActiveCommands(): Readonly<CommandMap>;
 export {};
 //# sourceMappingURL=define-commands.d.ts.map

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;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,yBAAyB,CAAA;AACrD,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,qFAAqF;IACrF,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;;;;;OAKG;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;AAED,mHAAmH;AACnH,wBAAgB,iBAAiB,IAAI,QAAQ,CAAC,UAAU,CAAC,CAExD"}

package/dist/commands/define-commands.js

@@ -6,21 +6,11 @@ function defineCommands(spec) {
 function defineCommand(cmd) {
   return 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}"`);
-    return;
-  }
-  return cmd.run(ctx);
-}
 function getActiveCommands() {
   return activeCommands;
 }
 export {
   defineCommand,
   defineCommands,
-  getActiveCommands,
-  runCommand
+  getActiveCommands
 };

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

@@ -5,7 +5,7 @@
  * `overlays` imperative controller — unknown keys are tsc errors. The type slot gives the
  * compile-time key union; the module-level stash gives the runtime values.
  *
- * Uses @mantine/modals under the hood. ModalsProvider must be mounted (BasaltOverlays does this).
+ * Uses @mantine/modals under the hood. ModalsProvider must be mounted (BasaltProvider does this).
  *
  * @example
  * // overlays.ts (app-side)
@@ -28,26 +28,12 @@
 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.
+ * Internal — `BasaltProvider` declares its `ModalsProvider` as live for as long as it is mounted,
+ * and gets back the function that retracts it. There is no way to detect the provider from outside
+ * React (its context is only readable through `useModals()`, and `confirm` is an imperative call),
+ * so the registration is explicit. Not on the `./commands` barrel.
  */
 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.
  *

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":"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"}
+{"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;AAEtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AA+BvC;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,IAAI,CAUnD;AAID;;;;;;;;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,8FAA8F;AAC9F,MAAM,MAAM,cAAc,GAAG;IAC3B,gFAAgF;IAChF,KAAK,EAAE,SAAS,CAAA;IAChB,wFAAwF;IACxF,IAAI,CAAC,EAAE,SAAS,CAAA;IAChB,gDAAgD;IAChD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,2FAA2F;IAC3F,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,oBAAoB,GAAG;IACjC;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;IACf,4BAA4B;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,SAAS,EAAE,MAAM,IAAI,CAAA;CACtB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,iBAAe,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA0DhE;AAED;;;;;;;GAOG;AACH,iBAAS,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;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;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ;IACnB;;;;;;;;;OASG;SACE,CAAC,SAAS,UAAU,OAAO,CAAC,SAAS,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAehE;;;;;OAKG;;IAGH;;;;;OAKG;;IAGH;;;;;OAKG;aACM,IAAI;CAGd,CAAA"}

package/dist/commands/define-overlays.js

@@ -1,4 +1,3 @@
-import { useEffect } from "react";
 import { missingLayer } from "../common/errors.js";
 let modalsPromise;
 function loadModals() {
@@ -15,12 +14,6 @@ function registerModalsProvider() {
     mountedModalsProviders--;
   };
 }
-function useModalsLayer(enabled) {
-  useEffect(() => {
-    if (!enabled) return;
-    return registerModalsProvider();
-  }, [enabled]);
-}
 let activeOverlays = {};
 function defineOverlays(spec) {
   activeOverlays = spec;
@@ -45,7 +38,7 @@ async function confirm(options) {
       missingLayer(
         "overlays.confirm",
         "@mantine/modals",
-        "install the @mantine/modals peer and mount <BasaltOverlays>"
+        "install the @mantine/modals peer and mount <BasaltProvider>"
       )
     );
   }
@@ -54,7 +47,7 @@ async function confirm(options) {
       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"
+        "mount <BasaltProvider> at the app root before calling it"
       )
     );
   }
@@ -147,6 +140,5 @@ export {
   defineOverlay,
   defineOverlays,
   overlays,
-  registerModalsProvider,
-  useModalsLayer
+  registerModalsProvider
 };

package/dist/commands/index.d.ts

@@ -1,52 +1,22 @@
 /**
- * ./commands — command bus, overlay controller, Spotlight projection, shortcuts display,
- * live keybindings, and composable overlay mount for basalt-ui apps.
+ * ./commands — the command bus, overlay controller, shortcuts help and the notification registry.
  *
- * Optional peers: @mantine/modals ^9.3.0, @mantine/spotlight ^9.3.0,
- *   @mantine/notifications ^9.3.0, @tanstack/react-hotkeys 0.10.0.
- *
- * Install with: bun add @mantine/modals @mantine/spotlight @mantine/notifications @tanstack/react-hotkeys
- * Also import the Spotlight styles in main.tsx (the layered bundle — the unlayered one outranks
- * basalt's `@layer basalt` styles regardless of specificity): import '@mantine/spotlight/styles.layer.css'
+ * `BasaltProvider` mounts modals, Spotlight, hotkeys and notifications; this barrel is only what
+ * an app declares and calls.
  *
  * @example
- * // commands.ts (app-side) — define + augment:
- * import { defineCommands } from 'basalt-ui/commands'
+ * import { defineCommands, defineNotifications, emit } from 'basalt-ui/commands'
  * export const COMMANDS = defineCommands({
  *   'file:save': { label: 'Save', group: 'File', shortcut: 'Mod+S', run: () => save() },
  * })
  * declare module 'basalt-ui' {
  *   interface BasaltRegister { commands: typeof COMMANDS }
  * }
- *
- * // main.tsx — mount composable overlays:
- * import { BasaltOverlays } from 'basalt-ui/commands'
- * import '@mantine/spotlight/styles.layer.css'
- * <BasaltProvider><BasaltOverlays><App /></BasaltOverlays></BasaltProvider>
- *
- * // usage.ts — run a command:
- * 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, 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';
-export { BasaltOverlays, type BasaltOverlaysProps, basaltSpotlight, openSpotlight, closeSpotlight, } from './overlays-mount.js';
+export { defineCommands, type Command } from './define-commands.js';
+export { defineOverlays, overlays } from './define-overlays.js';
+export { setColorScheme, toggleSidebar } from './shell-bridge.js';
+export { ShortcutsHelp } from './ShortcutsHelp.js';
+export { defineNotifications, emit } from './notifications/define-notifications.js';
+export { NotificationBell } from './notifications/bell.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAC5D,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAG/C,OAAO,EAAE,mBAAmB,EAAE,IAAI,EAAE,MAAM,sCAAsC,CAAA;AAChF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/commands/index.js

@@ -1,54 +1,17 @@
-import {
-  defineCommands,
-  defineCommand,
-  runCommand
-} from "./define-commands.js";
-import {
-  defineOverlays,
-  defineOverlay,
-  overlays,
-  registerModalsProvider
-} from "./define-overlays.js";
-import {
-  toSpotlightActions,
-  toRouteActions,
-  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 { defineCommands } from "./define-commands.js";
+import { defineOverlays, overlays } from "./define-overlays.js";
+import { setColorScheme, toggleSidebar } from "./shell-bridge.js";
 import { ShortcutsHelp } from "./ShortcutsHelp.js";
-import {
-  BasaltOverlays,
-  basaltSpotlight,
-  openSpotlight,
-  closeSpotlight
-} from "./overlays-mount.js";
+import { defineNotifications, emit } from "./notifications/define-notifications.js";
+import { NotificationBell } from "./notifications/bell.js";
 export {
-  BasaltOverlays,
+  NotificationBell,
   ShortcutsHelp,
-  basaltSpotlight,
-  closeSpotlight,
-  defineCommand,
   defineCommands,
-  defineOverlay,
+  defineNotifications,
   defineOverlays,
-  detectMac,
-  formatShortcutDisplay,
-  openSpotlight,
+  emit,
   overlays,
-  parseShortcut,
-  registerModalsProvider,
-  runCommand,
   setColorScheme,
-  toHotkeyBindings,
-  toRouteActions,
-  toShortcutList,
-  toSpotlightActions,
-  toggleSidebar,
-  useCommandHotkeys
+  toggleSidebar
 };

package/dist/{notifications → commands/notifications}/bell.d.ts

@@ -1,4 +1,4 @@
-import type { BasaltProps } from '../common/props.js';
+import type { BasaltProps } from '../../common/props.js';
 export type NotificationBellProps = BasaltProps & {
     /** Tooltip label. Default: 'Notifications'. */
     label?: string;

package/dist/commands/notifications/bell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bell.d.ts","sourceRoot":"","sources":["../../../src/commands/notifications/bell.tsx"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAOrD,MAAM,MAAM,qBAAqB,GAAG,WAAW,GAAG;IAChD,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,KAAuB,EACvB,SAAS,EACT,KAAK,GACN,EAAE,qBAAqB,+BA+EvB"}

package/dist/{notifications → commands/notifications}/center.d.ts

@@ -1,4 +1,4 @@
-import type { BasaltProps } from '../common/props.js';
+import type { BasaltProps } from '../../common/props.js';
 /** The popover width `NotificationBell` fixes at the `Popover` level (see `NotificationCenter`'s
  *  own doc for why WIDTH lives there and not on this component). Shared so the two call sites and
  *  this doc's example never drift apart. */
@@ -19,7 +19,7 @@ export type NotificationCenterProps = BasaltProps & {
  * its own container.
  *
  * @example
- * import { NOTIFICATION_POPOVER_WIDTH, NotificationCenter } from 'basalt-ui/notifications'
+ * import { NOTIFICATION_POPOVER_WIDTH, NotificationCenter } from './center.js'
  *
  * <Popover width={NOTIFICATION_POPOVER_WIDTH}>
  *   <Popover.Dropdown>

package/dist/commands/notifications/center.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"center.d.ts","sourceRoot":"","sources":["../../../src/commands/notifications/center.tsx"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAyCrD;;4CAE4C;AAC5C,eAAO,MAAM,0BAA0B,MAAM,CAAA;AAwF7C,MAAM,MAAM,uBAAuB,GAAG,WAAW,GAAG;IAClD,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5B,CAAA;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,SAAe,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,uBAAuB,+BA4EhG"}

package/dist/{notifications → commands/notifications}/center.js

@@ -10,8 +10,8 @@ import {
   Stack,
   Text
 } from "@mantine/core";
-import { cx } from "../common/props.js";
-import { VX } from "../tokens/index.js";
+import { cx } from "../../common/props.js";
+import { VX } from "../../tokens/index.js";
 import { resolveAction } from "./define-notifications.js";
 import { useNotificationHistory } from "./store.js";
 function relativeTime(createdAt) {

package/dist/{notifications → commands/notifications}/define-notifications.d.ts

@@ -12,7 +12,7 @@
  *
  * @example
  * // notifications.ts (app-side)
- * import { defineNotifications } from 'basalt-ui/notifications'
+ * import { defineNotifications } from 'basalt-ui/commands'
  * export const NOTIFICATIONS = defineNotifications({
  *   'upload:success': { intent: 'success', toMessage: (p: { name: string }) => `Uploaded ${p.name}` },
  *   'upload:error':   { intent: 'error',   toMessage: (_: unknown) => 'Upload failed' },
@@ -22,13 +22,13 @@
  * }
  *
  * // usage.ts
- * import { emit } from 'basalt-ui/notifications'
+ * import { emit } from 'basalt-ui/commands'
  * emit('upload:success', { name: 'photo.jpg' })  // ✓ typed, and the payload shape is checked
  * emit('upload:success', 'nope')                  // ✗ tsc error — wrong payload shape
  * emit('nonexistent', {})                         // ✗ tsc error — unregistered kind
  */
 import type { ReactNode } from 'react';
-import type { Slot } from '../register.js';
+import type { Slot } from '../../register.js';
 import type { NotifyOptions, NotificationIntent } from './notify.js';
 import type { NotificationActionRef } from './store.js';
 export type { NotificationIntent };

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-notifications.d.ts","sourceRoot":"","sources":["../../../src/commands/notifications/define-notifications.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACtC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAA;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAA;AACjE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAEpD,YAAY,EAAE,kBAAkB,EAAE,CAAA;AAIlC;;;;;;;;GAQG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAA;CAC1B,CAAA;AAID;;;;;;GAMG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,GAAG,OAAO,IAAI;IAC1C,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,SAAS,CAAA;IACrC,MAAM,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAA;CAC/B,CAAA;AAED,wDAAwD;AAExD,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;AAIvE,kFAAkF;AAClF,KAAK,aAAa,GAAG,IAAI,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAA;AAE/D;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,aAAa,EAAE,MAAM,CAAC,CAAA;AAEnE;;;;;;GAMG;AACH,KAAK,mBAAmB,CAAC,CAAC,SAAS,gBAAgB,IAAI,aAAa,SAAS;KAC1E,EAAE,IAAI,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,CAAC;CACrC,GACG,CAAC,GACD,OAAO,CAAA;AAIX;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAE9F;AAsBD,wBAAgB,mBAAmB,CAAC,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CAGnF;AAID;;;;;GAKG;AACH,KAAK,QAAQ,CAAC,CAAC,SAAS,gBAAgB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,GAClF,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,GACrE,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAA;AAEvF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,gBAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,MAAM,CAYtF;AAID;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,qBAAqB,GACzB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,SAAS,CAIhD"}

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

@@ -0,0 +1,44 @@
+/**
+ * notify — core toast helper wrapping @mantine/notifications.
+ *
+ * Maps intent → Mantine color name, sets per-intent aria role and autoClose defaults,
+ * records every toast into the module-level history store, and applies two-layer dedup:
+ *   1. Mantine id-dedup (passing the same id to notifications.show is a no-op on screen)
+ *   2. dedupKey window — module-level Map prevents duplicate keys within 1500ms
+ *
+ * Internal: consumers reach it through `emit` (`defineNotifications`).
+ *
+ * @example
+ * notify({ intent: 'success', message: 'Saved' })
+ * notify({ intent: 'error', message: 'Failed', title: 'Upload error', autoClose: false })
+ */
+import type { ReactNode } from 'react';
+import type { NotificationIntent, NotificationActionRef } from './store.js';
+export type { NotificationIntent };
+export type NotifyOptions = {
+    intent?: NotificationIntent;
+    message: ReactNode;
+    title?: ReactNode;
+    icon?: ReactNode;
+    autoClose?: number | false;
+    id?: string;
+    dedupKey?: string;
+    /**
+     * A serializable action ref — gives the recorded item an action button in the notification
+     * center. Usually attached automatically by `emit()` from the kind's spec; pass it directly
+     * only when calling `notify()` for an action registered in the notifications registry.
+     */
+    action?: NotificationActionRef;
+};
+/**
+ * Show a toast and record it to the notification history. Only string / number `message` and
+ * `title` are recorded; any other node shows in the toast but the history keeps `''` (message) or
+ * no title.
+ * Returns the notification id (string).
+ *
+ * @example
+ * const id = notify({ intent: 'success', message: 'Profile saved', title: 'Success' })
+ * const id = notify({ intent: 'error', message: <b>Failed</b>, autoClose: false })
+ */
+export declare function notify(opts: NotifyOptions): string;
+//# sourceMappingURL=notify.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../../src/commands/notifications/notify.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;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;AAmElC,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;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CA2ClD"}

package/dist/commands/notifications/notify.js

@@ -0,0 +1,79 @@
+import { notifications } from "@mantine/notifications";
+import { add, has } from "./store.js";
+const INTENT_COLOR = {
+  success: "green",
+  error: "red",
+  warning: "yellow",
+  info: "blue"
+};
+const INTENT_ROLE = {
+  error: "alert",
+  warning: "alert",
+  success: "status",
+  info: "status"
+};
+const INTENT_AUTO_CLOSE = {
+  success: 2e3,
+  info: 3e3,
+  warning: 5e3,
+  error: false
+};
+const DEDUP_WINDOW_MS = 1500;
+const dedupKeyTimestamps = /* @__PURE__ */ new Map();
+function pruneDedupKeys(now) {
+  for (const [key, { at }] of dedupKeyTimestamps) {
+    if (now - at >= DEDUP_WINDOW_MS) dedupKeyTimestamps.delete(key);
+  }
+}
+function recentIdForKey(dedupKey) {
+  const last = dedupKeyTimestamps.get(dedupKey);
+  if (last === void 0 || Date.now() - last.at >= DEDUP_WINDOW_MS) return void 0;
+  return last.id;
+}
+let seq = 0;
+function nextId() {
+  return `basalt-${Date.now()}-${++seq}`;
+}
+function historyText(node) {
+  if (typeof node === "string") return node;
+  if (typeof node === "number") return String(node);
+  return void 0;
+}
+function notify(opts) {
+  const { intent = "info", message, title, icon, autoClose, id, dedupKey, action } = opts;
+  if (dedupKey !== void 0) {
+    const recorded = recentIdForKey(dedupKey);
+    if (recorded !== void 0) return recorded;
+  }
+  const resolvedId = id ?? nextId();
+  if (dedupKey !== void 0) {
+    pruneDedupKeys(Date.now());
+    dedupKeyTimestamps.set(dedupKey, { at: Date.now(), id: resolvedId });
+  }
+  const color = INTENT_COLOR[intent];
+  const role = INTENT_ROLE[intent];
+  const resolvedAutoClose = autoClose !== void 0 ? autoClose : INTENT_AUTO_CLOSE[intent];
+  notifications.show({
+    id: resolvedId,
+    message,
+    title: title ?? void 0,
+    color,
+    icon: icon ?? void 0,
+    autoClose: resolvedAutoClose,
+    role
+  });
+  if (id !== void 0 && has(id)) return resolvedId;
+  const titleText = historyText(title);
+  add({
+    id: resolvedId,
+    intent,
+    ...titleText !== void 0 && { title: titleText },
+    message: historyText(message) ?? "",
+    createdAt: Date.now(),
+    ...action !== void 0 && { action }
+  });
+  return resolvedId;
+}
+export {
+  notify
+};

package/dist/{notifications → commands/notifications}/store.d.ts

@@ -50,6 +50,8 @@ export type UseNotificationHistoryReturn = {
  * success/info confirmations are disposable — they live only in the full history, never the Inbox.
  */
 export declare function needsAttention(item: NotificationHistoryItem): boolean;
+/** Whether the history already holds an item with this id. */
+export declare function has(id: string): boolean;
 /**
  * Add a notification to the history store (ring-buffer capped at 50).
  * Called by notify() — safe to call outside React.

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/commands/notifications/store.ts"],"names":[],"mappings":"AA0BA;;;;;;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,8DAA8D;AAC9D,wBAAgB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEvC;AAED;;;;;;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/{notifications → commands/notifications}/store.js

@@ -46,6 +46,9 @@ if (typeof window !== "undefined") {
     }
   });
 }
+function has(id) {
+  return state.some((item) => item.id === id);
+}
 function add(item) {
   const next = [item, ...state].slice(0, RING_CAP);
   setState(next);
@@ -105,6 +108,7 @@ export {
   clear,
   dismiss,
   dismissAll,
+  has,
   markAllRead,
   markRead,
   needsAttention,