hotkey-engine 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,380 @@
+// src/react/context.tsx
+import { createContext, useCallback, useContext, useEffect as useEffect2, useMemo, useRef as useRef2, useState as useState2 } from "react";
+
+// src/core/storage.ts
+var KEY = "hotkey-engine:v1";
+function loadSettings() {
+  if (typeof window === "undefined") return { version: 1, shortcuts: {} };
+  try {
+    const value = window.localStorage.getItem(KEY);
+    return value ? JSON.parse(value) : { version: 1, shortcuts: {} };
+  } catch {
+    return { version: 1, shortcuts: {} };
+  }
+}
+function saveSettings(settings) {
+  try {
+    window.localStorage.setItem(KEY, JSON.stringify(settings));
+  } catch {
+  }
+}
+
+// src/core/shortcut.ts
+var MODIFIERS = /* @__PURE__ */ new Set(["ctrl", "control", "alt", "shift", "meta", "cmd", "command", "mod"]);
+var NAMED_CODES = {
+  enter: "Enter",
+  escape: "Escape",
+  esc: "Escape",
+  space: "Space",
+  tab: "Tab",
+  backspace: "Backspace",
+  delete: "Delete",
+  arrowup: "ArrowUp",
+  arrowdown: "ArrowDown",
+  arrowleft: "ArrowLeft",
+  arrowright: "ArrowRight",
+  slash: "Slash"
+};
+var RESERVED = /* @__PURE__ */ new Set(["ctrl+r", "ctrl+w", "ctrl+t", "ctrl+n", "ctrl+l", "ctrl+k", "ctrl+p", "ctrl+shift+t", "meta+r", "meta+w", "meta+t", "meta+n", "meta+l", "meta+k", "meta+p", "meta+q", "alt+f4"]);
+function codeFor(key) {
+  const normalized = key.toLowerCase();
+  if (NAMED_CODES[normalized]) return NAMED_CODES[normalized];
+  if (/^[a-z]$/.test(normalized)) return `Key${normalized.toUpperCase()}`;
+  if (/^[0-9]$/.test(normalized)) return `Digit${normalized}`;
+  if (/^f([1-9]|1[0-2])$/.test(normalized)) return normalized.toUpperCase();
+  throw new Error(`Unsupported shortcut key: ${key}`);
+}
+function parseShortcut(shortcut) {
+  const parts = shortcut.toLowerCase().replace(/\s/g, "").split("+").filter(Boolean);
+  if (!parts.length) throw new Error("A shortcut is required");
+  const key = parts.pop();
+  if (MODIFIERS.has(key)) throw new Error("A shortcut needs a non-modifier key");
+  const modifiers = { ctrl: false, alt: false, shift: false, meta: false, mod: false };
+  for (const part of parts) {
+    if (!MODIFIERS.has(part)) throw new Error(`Unknown modifier: ${part}`);
+    if (part === "ctrl" || part === "control") modifiers.ctrl = true;
+    else if (part === "alt") modifiers.alt = true;
+    else if (part === "shift") modifiers.shift = true;
+    else if (part === "meta" || part === "cmd" || part === "command") modifiers.meta = true;
+    else modifiers.mod = true;
+  }
+  return { modifiers, code: codeFor(key) };
+}
+function isMacPlatform(platform = typeof navigator === "undefined" ? "" : navigator.platform) {
+  return /mac|iphone|ipad/i.test(platform);
+}
+function shortcutMatches(event, shortcut) {
+  const parsed = parseShortcut(shortcut);
+  const mac = isMacPlatform();
+  const expectedCtrl = parsed.modifiers.ctrl || parsed.modifiers.mod && !mac;
+  const expectedMeta = parsed.modifiers.meta || parsed.modifiers.mod && mac;
+  return event.code === parsed.code && event.ctrlKey === expectedCtrl && event.altKey === parsed.modifiers.alt && event.shiftKey === parsed.modifiers.shift && event.metaKey === expectedMeta;
+}
+function normalizeShortcut(shortcut) {
+  const parsed = parseShortcut(shortcut);
+  const names = [parsed.modifiers.ctrl && "ctrl", parsed.modifiers.alt && "alt", parsed.modifiers.shift && "shift", parsed.modifiers.meta && "meta", parsed.modifiers.mod && "mod"].filter(Boolean);
+  const key = parsed.code.startsWith("Key") ? parsed.code.slice(3).toLowerCase() : parsed.code.startsWith("Digit") ? parsed.code.slice(5) : parsed.code.toLowerCase();
+  return [...names, key].join("+");
+}
+function reservedReason(shortcut) {
+  const normalized = normalizeShortcut(shortcut).replace("mod", isMacPlatform() ? "meta" : "ctrl");
+  return RESERVED.has(normalized) ? "This shortcut is commonly reserved by the browser or operating system." : void 0;
+}
+function displayShortcut(shortcut, mac = isMacPlatform()) {
+  const parsed = parseShortcut(shortcut);
+  const labels = [
+    parsed.modifiers.ctrl && (mac ? "\u2303" : "Ctrl"),
+    parsed.modifiers.alt && (mac ? "\u2325" : "Alt"),
+    parsed.modifiers.shift && (mac ? "\u21E7" : "Shift"),
+    parsed.modifiers.meta && (mac ? "\u2318" : "Meta"),
+    parsed.modifiers.mod && (mac ? "\u2318" : "Ctrl")
+  ].filter(Boolean);
+  const key = parsed.code.startsWith("Key") ? parsed.code.slice(3) : parsed.code.startsWith("Digit") ? parsed.code.slice(5) : parsed.code.replace(/^Arrow/, "Arrow ");
+  return [...labels, key].join(mac ? "" : " + ");
+}
+
+// src/locales/messages.ts
+var messages = {
+  en: { settings: "Shortcut settings", search: "Search shortcuts", edit: "Edit", disable: "Disable", reset: "Reset", resetAll: "Reset all", save: "Save", cancel: "Cancel", close: "Close", recording: "Press a shortcut", disabled: "Disabled", conflict: "This shortcut is already used by", reserved: "This shortcut is reserved by your browser or operating system. Please choose another shortcut.", unavailable: "Shortcut unavailable", resetConfirm: "Reset all shortcuts to their defaults?", confirm: "Confirm", floatingLabel: "Keyboard shortcut settings" },
+  fa: { settings: "\u062A\u0646\u0638\u06CC\u0645\u0627\u062A \u0645\u06CC\u0627\u0646\u0628\u0631\u0647\u0627", search: "\u062C\u0633\u062A\u062C\u0648\u06CC \u0645\u06CC\u0627\u0646\u0628\u0631\u0647\u0627", edit: "\u0648\u06CC\u0631\u0627\u06CC\u0634", disable: "\u063A\u06CC\u0631\u0641\u0639\u0627\u0644\u200C\u0633\u0627\u0632\u06CC", reset: "\u0628\u0627\u0632\u0646\u0634\u0627\u0646\u06CC", resetAll: "\u0628\u0627\u0632\u0646\u0634\u0627\u0646\u06CC \u0647\u0645\u0647", save: "\u0630\u062E\u06CC\u0631\u0647", cancel: "\u0644\u063A\u0648", close: "\u0628\u0633\u062A\u0646", recording: "\u06CC\u06A9 \u0645\u06CC\u0627\u0646\u0628\u0631 \u0631\u0627 \u0641\u0634\u0627\u0631 \u062F\u0647\u06CC\u062F", disabled: "\u063A\u06CC\u0631\u0641\u0639\u0627\u0644", conflict: "\u0627\u06CC\u0646 \u0645\u06CC\u0627\u0646\u0628\u0631 \u0647\u0645\u200C\u0627\u06A9\u0646\u0648\u0646 \u0627\u0633\u062A\u0641\u0627\u062F\u0647 \u0645\u06CC\u200C\u0634\u0648\u062F \u062A\u0648\u0633\u0637", reserved: "\u0627\u06CC\u0646 \u0645\u06CC\u0627\u0646\u0628\u0631 \u062A\u0648\u0633\u0637 \u0645\u0631\u0648\u0631\u06AF\u0631 \u06CC\u0627 \u0633\u06CC\u0633\u062A\u0645\u200C\u0639\u0627\u0645\u0644 \u0631\u0632\u0631\u0648 \u0634\u062F\u0647 \u0627\u0633\u062A\u061B \u0644\u0637\u0641\u0627\u064B \u0645\u06CC\u0627\u0646\u0628\u0631 \u062F\u06CC\u06AF\u0631\u06CC \u0627\u0646\u062A\u062E\u0627\u0628 \u06A9\u0646\u06CC\u062F.", unavailable: "\u0627\u06CC\u0646 \u0645\u06CC\u0627\u0646\u0628\u0631 \u062F\u0631 \u062F\u0633\u062A\u0631\u0633 \u0646\u06CC\u0633\u062A", resetConfirm: "\u0647\u0645\u0647\u0654 \u0645\u06CC\u0627\u0646\u0628\u0631\u0647\u0627 \u0628\u0647 \u062D\u0627\u0644\u062A \u067E\u06CC\u0634\u200C\u0641\u0631\u0636 \u0628\u0631\u06AF\u0631\u062F\u0646\u062F\u061F", confirm: "\u062A\u0623\u06CC\u06CC\u062F", floatingLabel: "\u062A\u0646\u0638\u06CC\u0645\u0627\u062A \u0645\u06CC\u0627\u0646\u0628\u0631\u0647\u0627\u06CC \u06A9\u06CC\u0628\u0648\u0631\u062F" }
+};
+function defaultDir(locale) {
+  return locale === "fa" ? "rtl" : "ltr";
+}
+
+// src/ui/SettingsModal.tsx
+import { useEffect, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+function Recorder({ onSave, onCancel }) {
+  const { locale } = useHotkey();
+  useEffect(() => {
+    const handle = (event) => {
+      event.preventDefault();
+      event.stopPropagation();
+      if (event.key === "Escape") {
+        onCancel();
+        return;
+      }
+      if (["Control", "Alt", "Shift", "Meta"].includes(event.key) || event.repeat) return;
+      const parts = [event.ctrlKey && "ctrl", event.altKey && "alt", event.shiftKey && "shift", event.metaKey && "meta", event.code.startsWith("Key") ? event.code.slice(3).toLowerCase() : event.code.startsWith("Digit") ? event.code.slice(5) : event.code.toLowerCase()].filter(Boolean);
+      onSave(parts.join("+"));
+    };
+    window.addEventListener("keydown", handle, true);
+    return () => window.removeEventListener("keydown", handle, true);
+  }, [onSave, onCancel]);
+  return /* @__PURE__ */ jsxs("div", { className: "hotkey-recorder", role: "status", "aria-live": "polite", children: [
+    /* @__PURE__ */ jsxs("span", { className: "hotkey-recording-label", children: [
+      messages[locale].recording,
+      /* @__PURE__ */ jsxs("span", { "aria-hidden": "true", className: "hotkey-recording-dots", children: [
+        /* @__PURE__ */ jsx("i", {}),
+        /* @__PURE__ */ jsx("i", {}),
+        /* @__PURE__ */ jsx("i", {})
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("button", { type: "button", onClick: onCancel, children: messages[locale].cancel })
+  ] });
+}
+function HotkeySettingsModal() {
+  const { open, closeSettings, actions, updateShortcut, resetShortcut, resetAll, locale, dir, theme } = useHotkey();
+  const t = messages[locale];
+  const dialog = useRef(null);
+  const previous = useRef(null);
+  const [query, setQuery] = useState("");
+  const [recording, setRecording] = useState();
+  const [validationError, setValidationError] = useState();
+  useEffect(() => {
+    if (!open) return;
+    previous.current = document.activeElement;
+    dialog.current?.focus();
+    const keyboard = (event) => {
+      if (event.key === "Escape" && !recording) {
+        closeSettings();
+        return;
+      }
+      if (event.key !== "Tab" || !dialog.current) return;
+      const focusable = Array.from(dialog.current.querySelectorAll('button:not([disabled]), input:not([disabled]), [tabindex]:not([tabindex="-1"])'));
+      if (!focusable.length) {
+        event.preventDefault();
+        return;
+      }
+      const first = focusable[0], last = focusable[focusable.length - 1];
+      if (event.shiftKey && document.activeElement === first) {
+        event.preventDefault();
+        last.focus();
+      } else if (!event.shiftKey && document.activeElement === last) {
+        event.preventDefault();
+        first.focus();
+      }
+    };
+    window.addEventListener("keydown", keyboard);
+    return () => {
+      window.removeEventListener("keydown", keyboard);
+      previous.current?.focus();
+    };
+  }, [open, recording, closeSettings]);
+  if (!open || typeof document === "undefined") return null;
+  const visible = actions.filter((action) => action.label.toLowerCase().includes(query.toLowerCase()));
+  const save = (shortcut) => {
+    if (!recording) return;
+    const result = updateShortcut(recording, shortcut);
+    if (result.ok) {
+      setValidationError(void 0);
+      setRecording(void 0);
+      return;
+    }
+    const message = result.reason === "conflict" ? `${t.conflict}: ${result.action?.label}` : locale === "fa" ? `${displayShortcut(shortcut)} \u0631\u0632\u0631\u0648 \u0627\u0633\u062A\u061B \u0645\u06CC\u0627\u0646\u0628\u0631 \u062F\u06CC\u06AF\u0631\u06CC \u0627\u0646\u062A\u062E\u0627\u0628 \u06A9\u0646\u06CC\u062F.` : `${displayShortcut(shortcut)} is reserved. Choose another shortcut.`;
+    setValidationError({ actionId: recording, message });
+  };
+  const content = /* @__PURE__ */ jsx(Fragment, { children: /* @__PURE__ */ jsx("div", { className: "hotkey-overlay", "data-hotkey-theme": theme, onMouseDown: (event) => {
+    if (event.target === event.currentTarget && !recording) closeSettings();
+  }, children: /* @__PURE__ */ jsx("div", { ref: dialog, className: "hotkey-dialog", "data-hotkey-theme": theme, role: "dialog", "aria-modal": "true", "aria-labelledby": "hotkey-title", tabIndex: -1, dir, children: /* @__PURE__ */ jsxs("div", { className: "hotkey-glass-layout", children: [
+    /* @__PURE__ */ jsxs("header", { className: "hotkey-glass-header", children: [
+      /* @__PURE__ */ jsxs("div", { className: "hotkey-glass-title", children: [
+        /* @__PURE__ */ jsx("span", { className: "hotkey-glass-icon", "aria-hidden": "true", children: /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", children: [
+          /* @__PURE__ */ jsx("rect", { x: "3", y: "5", width: "18", height: "14", rx: "3", stroke: "currentColor", strokeWidth: "1.8" }),
+          /* @__PURE__ */ jsx("path", { d: "M7 10h1M11 10h1M15 10h2M7 14h6M16 14h1", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round" })
+        ] }) }),
+        /* @__PURE__ */ jsxs("div", { children: [
+          /* @__PURE__ */ jsx("h2", { id: "hotkey-title", children: locale === "fa" ? t.settings : "Shortcut Settings" }),
+          /* @__PURE__ */ jsx("p", { children: locale === "fa" ? "\u0645\u06CC\u0627\u0646\u0628\u0631\u0647\u0627\u06CC \u0633\u0627\u06CC\u062A \u062E\u0648\u062F \u0631\u0627 \u0634\u062E\u0635\u06CC\u200C\u0633\u0627\u0632\u06CC \u06A9\u0646\u06CC\u062F" : "Personalize shortcuts for this site" })
+        ] })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "hotkey-header-actions", children: [
+        /* @__PURE__ */ jsx("button", { type: "button", className: "hotkey-dialog-close", "aria-label": t.close, onClick: closeSettings, children: "\xD7" }),
+        /* @__PURE__ */ jsx("button", { type: "button", className: "hotkey-reset-all-icon", "aria-label": t.resetAll, onClick: resetAll, children: /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", fill: "none", "aria-hidden": "true", children: [
+          /* @__PURE__ */ jsx("path", { d: "M4 11a8 8 0 1 1 2.3 5.7", stroke: "currentColor", strokeWidth: "1.9", strokeLinecap: "round" }),
+          /* @__PURE__ */ jsx("path", { d: "M4 5v6h6", stroke: "currentColor", strokeWidth: "1.9", strokeLinecap: "round", strokeLinejoin: "round" })
+        ] }) })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("section", { className: "hotkey-glass-body", children: [
+      /* @__PURE__ */ jsxs("div", { className: "hotkey-glass-toolbar", children: [
+        /* @__PURE__ */ jsxs("div", { className: "hotkey-search-wrap", children: [
+          /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "\u2315" }),
+          /* @__PURE__ */ jsx("input", { className: "hotkey-search", value: query, onChange: (event) => setQuery(event.target.value), placeholder: t.search, "aria-label": t.search })
+        ] }),
+        /* @__PURE__ */ jsx("span", { className: "hotkey-action-count", children: actions.length })
+      ] }),
+      /* @__PURE__ */ jsx("ul", { className: "hotkey-action-list", children: visible.map((action) => /* @__PURE__ */ jsxs("li", { className: "hotkey-action-item", children: [
+        /* @__PURE__ */ jsxs("div", { className: "hotkey-action-row", children: [
+          /* @__PURE__ */ jsxs("div", { className: "hotkey-action-info", children: [
+            /* @__PURE__ */ jsx("strong", { children: action.label }),
+            /* @__PURE__ */ jsx("span", { children: action.shortcut ? displayShortcut(action.shortcut) : t.disabled })
+          ] }),
+          recording === action.id ? /* @__PURE__ */ jsx(Recorder, { onSave: save, onCancel: () => {
+            setValidationError(void 0);
+            setRecording(void 0);
+          } }) : /* @__PURE__ */ jsxs("div", { className: "hotkey-row-actions", children: [
+            action.editable !== false && /* @__PURE__ */ jsx("button", { type: "button", className: "hotkey-action-edit", onClick: () => {
+              setValidationError(void 0);
+              setRecording(action.id);
+            }, children: t.edit }),
+            action.editable !== false && /* @__PURE__ */ jsx("button", { type: "button", className: "hotkey-action-disable", onClick: () => updateShortcut(action.id, null), children: t.disable }),
+            /* @__PURE__ */ jsx("button", { type: "button", className: "hotkey-action-reset", onClick: () => resetShortcut(action.id), children: t.reset })
+          ] })
+        ] }),
+        validationError?.actionId === action.id && /* @__PURE__ */ jsxs("div", { className: "hotkey-inline-feedback", role: "alert", "aria-live": "assertive", children: [
+          /* @__PURE__ */ jsx("span", { "aria-hidden": "true", children: "!" }),
+          /* @__PURE__ */ jsx("p", { children: validationError.message })
+        ] })
+      ] }, action.id)) })
+    ] })
+  ] }) }) }) });
+  return createPortal(content, document.body);
+}
+
+// src/ui/FloatingTrigger.tsx
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function HotkeySettingsTrigger({ children, className }) {
+  const { openSettings } = useHotkeySettings();
+  return /* @__PURE__ */ jsx2("button", { type: "button", className, onClick: openSettings, children: children ?? "Keyboard shortcuts" });
+}
+function FloatingTrigger({ position, offset, zIndex }) {
+  const { openSettings } = useHotkeySettings();
+  const { locale } = useHotkey();
+  const value = typeof offset === "number" ? { x: offset, y: offset } : offset;
+  const [vertical, horizontal] = position.split("-");
+  const style = { position: "fixed", [vertical]: value.y, [horizontal]: value.x, zIndex };
+  return /* @__PURE__ */ jsx2("button", { type: "button", className: "hotkey-floating-trigger", style, "aria-label": messages[locale].floatingLabel, title: messages[locale].floatingLabel, onClick: openSettings, children: /* @__PURE__ */ jsxs2("svg", { className: "hotkey-trigger-icon", "aria-hidden": "true", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "1.8", strokeLinecap: "round", strokeLinejoin: "round", children: [
+    /* @__PURE__ */ jsx2("rect", { x: "3", y: "4", width: "18", height: "16", rx: "3" }),
+    /* @__PURE__ */ jsx2("path", { d: "M7 9h.01M10 9h.01M13 9h.01M16 9h1M7 13h1M10 13h1M13 13h4M7 16h10" })
+  ] }) });
+}
+
+// src/react/context.tsx
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
+var Context = createContext(null);
+function isEditable(target) {
+  const el = target;
+  return !!el && (el.tagName === "INPUT" || el.tagName === "TEXTAREA" || el.isContentEditable);
+}
+function scopesOverlap(a, b) {
+  return !a || !b || a === b;
+}
+function HotkeyProvider({ actions, children, showFloatingButton = true, position = "bottom-left", offset = { x: 24, y: 24 }, zIndex = 1e3, theme = "system", locale = "en", dir, className, allowReservedShortcuts = false }) {
+  const [open, setOpen] = useState2(false);
+  const [activeLocale, setActiveLocale] = useState2(locale);
+  const [settings, setSettings] = useState2({});
+  const [hydrated, setHydrated] = useState2(false);
+  const [activeScopes, setActiveScopes] = useState2([]);
+  const actionsRef = useRef2(actions);
+  actionsRef.current = actions;
+  useEffect2(() => setActiveLocale(locale), [locale]);
+  useEffect2(() => {
+    const loaded = loadSettings();
+    setSettings(loaded.shortcuts);
+    setHydrated(true);
+  }, []);
+  useEffect2(() => {
+    if (hydrated) saveSettings({ version: 1, shortcuts: settings });
+  }, [hydrated, settings]);
+  const resolved = useMemo(() => actions.map((action) => ({ ...action, shortcut: Object.prototype.hasOwnProperty.call(settings, action.id) ? settings[action.id] : action.defaultShortcut })), [actions, settings]);
+  const resolvedRef = useRef2(resolved);
+  resolvedRef.current = resolved;
+  const scopesRef = useRef2(activeScopes);
+  scopesRef.current = activeScopes;
+  useEffect2(() => {
+    const onKeyDown = (event) => {
+      if (event.repeat || open) return;
+      const rankedScopes = [...scopesRef.current].reverse().concat("global");
+      for (const scope of rankedScopes) {
+        const action = resolvedRef.current.find((item) => (item.scope ?? "global") === scope && item.shortcut && (!isEditable(event.target) || item.allowInEditable) && shortcutMatches(event, item.shortcut));
+        if (action) {
+          if (action.preventDefault || allowReservedShortcuts && reservedReason(action.shortcut)) event.preventDefault();
+          action.onTrigger(event);
+          return;
+        }
+      }
+    };
+    window.addEventListener("keydown", onKeyDown);
+    return () => window.removeEventListener("keydown", onKeyDown);
+  }, [open, allowReservedShortcuts]);
+  const updateShortcut = useCallback((id, shortcut) => {
+    const changed = resolvedRef.current.find((item) => item.id === id);
+    if (!changed) throw new Error(`Unknown Hotkey action: ${id}`);
+    if (shortcut) {
+      let normalized;
+      try {
+        normalized = normalizeShortcut(shortcut);
+      } catch {
+        return { ok: false, reason: "reserved" };
+      }
+      if (reservedReason(normalized) && !allowReservedShortcuts) return { ok: false, reason: "reserved" };
+      const conflict = resolvedRef.current.find((item) => item.id !== id && item.shortcut && normalizeShortcut(item.shortcut) === normalized && scopesOverlap(item.scope, changed.scope));
+      if (conflict) return { ok: false, reason: "conflict", action: conflict };
+      shortcut = normalized;
+    }
+    setSettings((current) => ({ ...current, [id]: shortcut }));
+    return { ok: true };
+  }, []);
+  const resetShortcut = useCallback((id) => setSettings((current) => {
+    const next = { ...current };
+    delete next[id];
+    return next;
+  }), []);
+  const resetAll = useCallback(() => setSettings({}), []);
+  const activateScope = useCallback((scope) => {
+    setActiveScopes((current) => [...current.filter((item) => item !== scope), scope]);
+    return () => setActiveScopes((current) => current.filter((item) => item !== scope));
+  }, []);
+  const activeDir = dir ?? defaultDir(activeLocale);
+  const value = useMemo(() => ({ actions: resolved, open, openSettings: () => setOpen(true), closeSettings: () => setOpen(false), updateShortcut, resetShortcut, resetAll, activeScopes, activateScope, locale: activeLocale, setLocale: setActiveLocale, dir: activeDir, theme, allowReservedShortcuts }), [resolved, open, updateShortcut, resetShortcut, resetAll, activeScopes, activateScope, activeLocale, activeDir, theme, allowReservedShortcuts]);
+  return /* @__PURE__ */ jsx3(Context.Provider, { value, children: /* @__PURE__ */ jsxs3("div", { className, "data-hotkey-theme": theme, dir: activeDir, children: [
+    children,
+    showFloatingButton && /* @__PURE__ */ jsx3(FloatingTrigger, { position, offset, zIndex }),
+    /* @__PURE__ */ jsx3(HotkeySettingsModal, {})
+  ] }) });
+}
+function useHotkeySettings() {
+  const value = useContext(Context);
+  if (!value) throw new Error("useHotkeySettings must be used within HotkeyProvider");
+  return value;
+}
+function useHotkeyLocale() {
+  const value = useContext(Context);
+  if (!value) throw new Error("useHotkeyLocale must be used within HotkeyProvider");
+  return value;
+}
+function useHotkeyScope(scope, active = true) {
+  const value = useContext(Context);
+  if (!value) throw new Error("useHotkeyScope must be used within HotkeyProvider");
+  const { activateScope } = value;
+  useEffect2(() => active ? activateScope(scope) : void 0, [active, scope, activateScope]);
+}
+function useHotkey() {
+  const value = useContext(Context);
+  if (!value) throw new Error("useHotkey must be used within HotkeyProvider");
+  return value;
+}
+export {
+  HotkeyProvider,
+  HotkeySettingsTrigger,
+  displayShortcut,
+  normalizeShortcut,
+  parseShortcut,
+  shortcutMatches,
+  useHotkeyLocale,
+  useHotkeyScope,
+  useHotkeySettings
+};