@remcostoeten/use-shortcut 2.0.1 → 2.2.0

package/dist/index.mjs

@@ -1,928 +1 @@
-import { useRef, useMemo, useEffect } from 'react';
-
-// src/constants.ts
-var OS = {
-  MAC: "mac",
-  WINDOWS: "windows",
-  LINUX: "linux"
-};
-var Platform = OS;
-var _cachedPlatform = null;
-function detectPlatform() {
-  if (_cachedPlatform) return _cachedPlatform;
-  if (typeof navigator === "undefined") {
-    _cachedPlatform = OS.WINDOWS;
-    return _cachedPlatform;
-  }
-  const uaPlatform = navigator.userAgentData?.platform?.toLowerCase();
-  const platform = (uaPlatform ?? navigator.platform ?? navigator.userAgent ?? "").toLowerCase();
-  if (platform.includes("mac") || platform.includes("iphone") || platform.includes("ipad") || platform.includes("ipod")) {
-    _cachedPlatform = OS.MAC;
-    return _cachedPlatform;
-  }
-  if (platform.includes("linux") || platform.includes("android")) {
-    _cachedPlatform = OS.LINUX;
-    return _cachedPlatform;
-  }
-  if (platform.includes("win")) {
-    _cachedPlatform = OS.WINDOWS;
-    return _cachedPlatform;
-  }
-  _cachedPlatform = OS.WINDOWS;
-  return _cachedPlatform;
-}
-var ModifierKey = {
-  META: "meta",
-  CTRL: "ctrl",
-  ALT: "alt",
-  SHIFT: "shift"
-};
-var ModifierAliases = {
-  command: ModifierKey.META,
-  cmd: ModifierKey.META,
-  "\u2318": ModifierKey.META,
-  meta: ModifierKey.META,
-  win: ModifierKey.META,
-  windows: ModifierKey.META,
-  super: ModifierKey.META,
-  mod: ModifierKey.META,
-  control: ModifierKey.CTRL,
-  ctrl: ModifierKey.CTRL,
-  "\u2303": ModifierKey.CTRL,
-  ctl: ModifierKey.CTRL,
-  alt: ModifierKey.ALT,
-  option: ModifierKey.ALT,
-  opt: ModifierKey.ALT,
-  "\u2325": ModifierKey.ALT,
-  shift: ModifierKey.SHIFT,
-  "\u21E7": ModifierKey.SHIFT,
-  shft: ModifierKey.SHIFT
-};
-var SpecialKeyMap = {
-  up: "ArrowUp",
-  down: "ArrowDown",
-  left: "ArrowLeft",
-  right: "ArrowRight",
-  home: "Home",
-  end: "End",
-  pageup: "PageUp",
-  pagedown: "PageDown",
-  enter: "Enter",
-  return: "Enter",
-  space: " ",
-  spacebar: " ",
-  tab: "Tab",
-  backspace: "Backspace",
-  delete: "Delete",
-  del: "Delete",
-  escape: "Escape",
-  esc: "Escape",
-  f1: "F1",
-  f2: "F2",
-  f3: "F3",
-  f4: "F4",
-  f5: "F5",
-  f6: "F6",
-  f7: "F7",
-  f8: "F8",
-  f9: "F9",
-  f10: "F10",
-  f11: "F11",
-  f12: "F12",
-  plus: "+",
-  minus: "-",
-  comma: ",",
-  period: ".",
-  slash: "/",
-  backslash: "\\",
-  bracket: "[",
-  closebracket: "]"
-};
-var ModifierDisplaySymbols = {
-  [OS.MAC]: {
-    [ModifierKey.META]: "\u2318",
-    [ModifierKey.CTRL]: "\u2303",
-    [ModifierKey.ALT]: "\u2325",
-    [ModifierKey.SHIFT]: "\u21E7"
-  },
-  [OS.WINDOWS]: {
-    [ModifierKey.META]: "Ctrl",
-    [ModifierKey.CTRL]: "Ctrl",
-    [ModifierKey.ALT]: "Alt",
-    [ModifierKey.SHIFT]: "Shift"
-  },
-  [OS.LINUX]: {
-    [ModifierKey.META]: "Super",
-    [ModifierKey.CTRL]: "Ctrl",
-    [ModifierKey.ALT]: "Alt",
-    [ModifierKey.SHIFT]: "Shift"
-  }
-};
-var ModifierDisplayOrder = {
-  [OS.MAC]: [ModifierKey.CTRL, ModifierKey.ALT, ModifierKey.SHIFT, ModifierKey.META],
-  [OS.WINDOWS]: [ModifierKey.META, ModifierKey.ALT, ModifierKey.SHIFT, ModifierKey.CTRL],
-  [OS.LINUX]: [ModifierKey.META, ModifierKey.ALT, ModifierKey.SHIFT, ModifierKey.CTRL]
-};
-
-// src/parser.ts
-function _normalizeKeyToken(key) {
-  return key === " " ? "space" : key.toLowerCase();
-}
-function parseShortcut(shortcut) {
-  const platform = detectPlatform();
-  const normalized = shortcut.toLowerCase().trim();
-  const parts = normalized.split(/[\s+-]+/).filter(Boolean);
-  if (parts.length === 0) {
-    throw new Error(`Invalid shortcut: "${shortcut}"`);
-  }
-  const modifiers = {
-    meta: false,
-    ctrl: false,
-    alt: false,
-    shift: false
-  };
-  let key = parts.pop();
-  for (const part of parts) {
-    const modifierKey = ModifierAliases[part];
-    if (modifierKey) {
-      if (part === "mod") {
-        if (platform === Platform.MAC) {
-          modifiers.meta = true;
-        } else {
-          modifiers.ctrl = true;
-        }
-      } else {
-        modifiers[modifierKey] = true;
-      }
-    } else {
-      key = part + key;
-    }
-  }
-  const normalizedKey = SpecialKeyMap[key] || key;
-  return {
-    modifiers,
-    key: normalizedKey.length === 1 ? normalizedKey.toLowerCase() : normalizedKey,
-    original: shortcut
-  };
-}
-function parseShortcuts(shortcuts) {
-  const shortcutArray = Array.isArray(shortcuts) ? shortcuts : [shortcuts];
-  return shortcutArray.map(parseShortcut);
-}
-function getModifiersFromEvent(event) {
-  return {
-    meta: event.metaKey,
-    ctrl: event.ctrlKey,
-    alt: event.altKey,
-    shift: event.shiftKey
-  };
-}
-function matchesShortcut(event, parsed) {
-  const eventModifiers = getModifiersFromEvent(event);
-  const eventKey = _normalizeKeyToken(event.key);
-  const modifiersMatch = eventModifiers.meta === parsed.modifiers.meta && eventModifiers.ctrl === parsed.modifiers.ctrl && eventModifiers.alt === parsed.modifiers.alt && eventModifiers.shift === parsed.modifiers.shift;
-  const keyMatches = eventKey === _normalizeKeyToken(parsed.key);
-  return modifiersMatch && keyMatches;
-}
-function matchesAnyShortcut(event, parsedShortcuts) {
-  return parsedShortcuts.some((parsed) => matchesShortcut(event, parsed));
-}
-
-// src/formatter.ts
-var _BASE_DISPLAY_NAMES = {
-  ArrowUp: "\u2191",
-  ArrowDown: "\u2193",
-  ArrowLeft: "\u2190",
-  ArrowRight: "\u2192",
-  Home: "Home",
-  End: "End",
-  PageUp: "PgUp",
-  PageDown: "PgDn"
-};
-var _MAC_DISPLAY_NAMES = {
-  ..._BASE_DISPLAY_NAMES,
-  Enter: "\u21A9",
-  Tab: "\u21E5",
-  Escape: "\u238B",
-  Backspace: "\u232B",
-  Delete: "\u2326",
-  " ": "\u2423"
-};
-var _NON_MAC_DISPLAY_NAMES = {
-  ..._BASE_DISPLAY_NAMES,
-  Enter: "Enter",
-  Tab: "Tab",
-  Escape: "Esc",
-  Backspace: "Backspace",
-  Delete: "Del",
-  " ": "Space"
-};
-function formatShortcut(shortcut, platform) {
-  const targetPlatform = platform ?? detectPlatform();
-  const parsed = parseShortcut(shortcut);
-  const symbols = ModifierDisplaySymbols[targetPlatform];
-  const order = ModifierDisplayOrder[targetPlatform];
-  const parts = [];
-  for (const modifier of order) {
-    if (parsed.modifiers[modifier]) {
-      parts.push(symbols[modifier]);
-    }
-  }
-  const displayKey = _formatKey(parsed.key, targetPlatform);
-  parts.push(displayKey);
-  const separator = targetPlatform === OS.MAC ? "" : "+";
-  return parts.join(separator);
-}
-function _formatKey(key, platform) {
-  const displayNames = platform === OS.MAC ? _MAC_DISPLAY_NAMES : _NON_MAC_DISPLAY_NAMES;
-  return displayNames[key] || key.toUpperCase();
-}
-
-// src/runtime/debug.ts
-function _debugLog(debug, ...args) {
-  if (debug) {
-    console.log("[useShortcut]", ...args);
-  }
-}
-
-// src/runtime/keys.ts
-function _getActiveModifierTokens(modifiers) {
-  const platform = detectPlatform();
-  const order = ModifierDisplayOrder[platform];
-  const tokens = [];
-  for (const key of order) {
-    if (key === ModifierKey.CTRL && modifiers.ctrl) tokens.push("ctrl");
-    if (key === ModifierKey.ALT && modifiers.alt) tokens.push("alt");
-    if (key === ModifierKey.SHIFT && modifiers.shift) tokens.push("shift");
-    if (key === ModifierKey.META && modifiers.cmd) tokens.push("cmd");
-  }
-  return tokens;
-}
-function _buildComboString(modifiers, key) {
-  const tokens = _getActiveModifierTokens(modifiers);
-  return [...tokens, key].join("+");
-}
-function _formatSequenceDisplay(steps) {
-  return steps.map((step) => formatShortcut(step)).join(" then ");
-}
-function _canonicalizeParsed(parsed) {
-  const modifiers = [];
-  if (parsed.modifiers.ctrl) modifiers.push("ctrl");
-  if (parsed.modifiers.alt) modifiers.push("alt");
-  if (parsed.modifiers.shift) modifiers.push("shift");
-  if (parsed.modifiers.meta) modifiers.push("cmd");
-  const key = parsed.key === " " || parsed.key === "Spacebar" ? "space" : parsed.key.toLowerCase();
-  return [...modifiers, key].join("+");
-}
-function _eventToCombo(event) {
-  const modifiers = [];
-  if (event.ctrlKey) modifiers.push("ctrl");
-  if (event.altKey) modifiers.push("alt");
-  if (event.shiftKey) modifiers.push("shift");
-  if (event.metaKey) modifiers.push("cmd");
-  const key = event.key === " " || event.key === "Spacebar" ? "space" : event.key.toLowerCase();
-  return [...modifiers, key].join("+");
-}
-function _eventToMatchStep(event) {
-  return _eventToCombo(event);
-}
-
-// src/runtime/conflicts.ts
-function _isPrefix(a, b) {
-  if (a.length > b.length) return false;
-  for (let i = 0; i < a.length; i += 1) {
-    if (a[i] !== b[i]) {
-      return false;
-    }
-  }
-  return true;
-}
-function _detectConflict(newSteps, existingSteps) {
-  const newCanonicalSteps = newSteps.map(_canonicalizeParsed);
-  const existingCanonicalSteps = existingSteps.map(_canonicalizeParsed);
-  const newCombo = newCanonicalSteps.join(" ");
-  const existingCombo = existingCanonicalSteps.join(" ");
-  if (newCombo === existingCombo) return "exact";
-  if (_isPrefix(newCanonicalSteps, existingCanonicalSteps) || _isPrefix(existingCanonicalSteps, newCanonicalSteps)) {
-    return "sequence-prefix";
-  }
-  return null;
-}
-function _emitConflict(registry, conflict) {
-  const conflictWarnings = registry.options.conflictWarnings ?? true;
-  if (registry.options.onConflict) {
-    registry.options.onConflict(conflict);
-    return;
-  }
-  if (!conflictWarnings) return;
-  console.warn(
-    `[useShortcut] Conflict detected (${conflict.reason}) between "${conflict.combo}" and "${conflict.existingCombo}"`
-  );
-}
-
-// src/runtime/guards.ts
-var _IGNORED_TAGS = /* @__PURE__ */ new Set(["INPUT", "TEXTAREA", "SELECT"]);
-var _EXCEPT_PREDICATES = {
-  input: (e) => {
-    if (!(e.target instanceof HTMLElement)) return false;
-    const target = e.target;
-    return _IGNORED_TAGS.has(target.tagName);
-  },
-  editable: (e) => {
-    if (!(e.target instanceof HTMLElement)) return false;
-    const target = e.target;
-    return target.isContentEditable;
-  },
-  typing: (e) => {
-    if (!(e.target instanceof HTMLElement)) return false;
-    const target = e.target;
-    return _IGNORED_TAGS.has(target.tagName) || target.isContentEditable;
-  },
-  modal: () => {
-    if (typeof document === "undefined" || typeof document.querySelector !== "function")
-      return false;
-    return document.querySelector('[data-modal="true"], [role="dialog"]') !== null;
-  },
-  disabled: (e) => {
-    if (!(e.target instanceof HTMLElement)) return false;
-    const target = e.target;
-    return target.hasAttribute("disabled") || target.getAttribute("aria-disabled") === "true";
-  }
-};
-function _shouldExcept(event, except) {
-  if (!except) return false;
-  if (typeof except === "function") {
-    return except(event);
-  }
-  if (Array.isArray(except)) {
-    return except.some((preset) => _EXCEPT_PREDICATES[preset]?.(event));
-  }
-  return _EXCEPT_PREDICATES[except]?.(event) ?? false;
-}
-function _normalizeScopes(scopes) {
-  if (!scopes) return [];
-  return (Array.isArray(scopes) ? scopes : [scopes]).map((scope) => scope.trim()).filter(Boolean);
-}
-function _scopeMatch(requiredScopes, activeScopes) {
-  if (requiredScopes.size === 0) return true;
-  for (const required of requiredScopes) {
-    if (activeScopes.has(required)) return true;
-  }
-  return false;
-}
-function _isPureModifier(event) {
-  const key = event.key.toLowerCase();
-  return key === "shift" || key === "control" || key === "alt" || key === "meta";
-}
-
-// src/runtime/listener.ts
-function _sortEntries(entries) {
-  if (entries.length <= 1) return entries;
-  return [...entries].sort((a, b) => {
-    if (b.priority !== a.priority) return b.priority - a.priority;
-    return a.id - b.id;
-  });
-}
-function _dispatchRegistryEvent(registry, event) {
-  const runtimeOptions = registry.options;
-  if (runtimeOptions.disabled) return;
-  if (runtimeOptions.eventFilter && !runtimeOptions.eventFilter(event)) return;
-  const candidateCombos = /* @__PURE__ */ new Set();
-  const firstStepCombos = registry.firstStepIndex.get(_eventToMatchStep(event));
-  if (firstStepCombos) {
-    for (const combo of firstStepCombos) candidateCombos.add(combo);
-  }
-  for (const combo of registry.activeSequenceCombos) {
-    candidateCombos.add(combo);
-  }
-  for (const combo of candidateCombos) {
-    const comboEntries = registry.listeners.get(combo);
-    if (!comboEntries) continue;
-    const orderedEntries = _sortEntries(comboEntries);
-    for (const item of orderedEntries) {
-      if (!item.isEnabled) continue;
-      if (!_scopeMatch(item.scopes, registry.activeScopes)) {
-        continue;
-      }
-      if (runtimeOptions.ignoreInputs !== false && !item.except) {
-        const targetEl = event.target;
-        if (targetEl && (_IGNORED_TAGS.has(targetEl.tagName) || targetEl.isContentEditable)) {
-          continue;
-        }
-      }
-      if (_shouldExcept(event, item.except)) {
-        _debugLog(runtimeOptions.debug, "Skipped due to except condition:", combo);
-        continue;
-      }
-      const expected = item.parsedSteps[item.progress];
-      const now = Date.now();
-      if (item.progress > 0 && now - item.lastMatchedAt > item.sequenceTimeout) {
-        item.progress = 0;
-      }
-      let matched = false;
-      if (matchesShortcut(event, expected)) {
-        item.progress += 1;
-        item.lastMatchedAt = now;
-        if (item.progress === item.parsedSteps.length) {
-          matched = true;
-          item.progress = 0;
-        }
-      } else if (item.progress > 0 && matchesShortcut(event, item.parsedSteps[0])) {
-        item.progress = 1;
-        item.lastMatchedAt = now;
-      } else {
-        item.progress = 0;
-      }
-      for (const cb of item.attemptCallbacks) {
-        cb(matched, event);
-      }
-      if (!matched) continue;
-      _debugLog(runtimeOptions.debug, "MATCHED:", combo);
-      if (item.preventDefault) {
-        event.preventDefault();
-      }
-      if (item.stopPropagation) {
-        event.stopPropagation();
-      }
-      const executeHandler = () => item.userHandler(event);
-      if (item.delay > 0) {
-        _debugLog(runtimeOptions.debug, "Delaying execution by", item.delay, "ms");
-        setTimeout(executeHandler, item.delay);
-      } else {
-        executeHandler();
-      }
-      if (item.stopOnMatch) {
-        break;
-      }
-    }
-    if (comboEntries.some((entry) => entry.progress > 0)) {
-      registry.activeSequenceCombos.add(combo);
-    } else {
-      registry.activeSequenceCombos.delete(combo);
-    }
-  }
-}
-function _attachRegistryListener(registry) {
-  if (registry.listener) return;
-  const target = registry.options.target ?? (typeof window !== "undefined" ? window : null);
-  if (!target) return;
-  const eventType = registry.options.eventType ?? "keydown";
-  const listener = (event) => _dispatchRegistryEvent(registry, event);
-  target.addEventListener(eventType, listener);
-  registry.listener = listener;
-  registry.listenerTarget = target;
-  registry.listenerEventType = eventType;
-  _debugLog(registry.options.debug, "Listener attached");
-}
-function _detachRegistryListener(registry) {
-  if (!registry.listener || !registry.listenerTarget) return;
-  registry.listenerTarget.removeEventListener(registry.listenerEventType, registry.listener);
-  registry.listener = null;
-  registry.listenerTarget = null;
-  _debugLog(registry.options.debug, "Listener detached");
-}
-
-// src/runtime/binding.ts
-function _createBinding(state, handler, handlerOptions = {}, registry) {
-  const { options, except: stateExcept } = state;
-  const rawSteps = state.steps;
-  if (rawSteps.length === 0) {
-    throw new Error("[useShortcut] No key specified. Use .key() to set the action key.");
-  }
-  const parsedSteps = rawSteps.map((step) => parseShortcut(step));
-  const combo = parsedSteps.map(_canonicalizeParsed).join(" ");
-  const display = _formatSequenceDisplay(rawSteps);
-  const debug = options.debug ?? false;
-  const except = stateExcept ?? handlerOptions.except;
-  for (const [existingCombo, entries] of registry.listeners.entries()) {
-    for (const existing of entries) {
-      if (existingCombo === combo) continue;
-      const reason = _detectConflict(parsedSteps, existing.parsedSteps);
-      if (!reason) continue;
-      _emitConflict(registry, { combo, existingCombo, reason });
-    }
-  }
-  const isEnabled = !handlerOptions.disabled && !options.disabled;
-  const delay = handlerOptions.delay ?? options.delay ?? 0;
-  const sequenceTimeout = handlerOptions.sequenceTimeout ?? options.sequenceTimeout ?? 800;
-  const requiredScopes = new Set(_normalizeScopes(state.scopes ?? handlerOptions.scopes));
-  const attemptCallbacks = /* @__PURE__ */ new Set();
-  _debugLog(debug, "Registering:", combo, "\u2192", display, {
-    parsedSteps,
-    except: !!except,
-    scopes: [...requiredScopes]
-  });
-  const entry = {
-    id: registry.nextId++,
-    userHandler: handler,
-    isEnabled,
-    attemptCallbacks,
-    parsedSteps,
-    scopes: requiredScopes,
-    progress: 0,
-    lastMatchedAt: 0,
-    except,
-    delay,
-    sequenceTimeout,
-    preventDefault: handlerOptions.preventDefault !== false,
-    stopPropagation: handlerOptions.stopPropagation ?? false,
-    stopOnMatch: handlerOptions.stopOnMatch ?? false,
-    priority: handlerOptions.priority ?? 0
-  };
-  const comboEntries = registry.listeners.get(combo);
-  if (comboEntries) {
-    comboEntries.push(entry);
-  } else {
-    registry.listeners.set(combo, [entry]);
-    const firstStep = _canonicalizeParsed(parsedSteps[0]);
-    const indexedCombos = registry.firstStepIndex.get(firstStep);
-    if (indexedCombos) {
-      indexedCombos.add(combo);
-    } else {
-      registry.firstStepIndex.set(firstStep, /* @__PURE__ */ new Set([combo]));
-    }
-  }
-  _attachRegistryListener(registry);
-  const unbindEntry = () => {
-    const currentEntries = registry.listeners.get(combo);
-    if (!currentEntries) return;
-    const nextEntries = currentEntries.filter((item) => item.id !== entry.id);
-    if (nextEntries.length === 0) {
-      registry.listeners.delete(combo);
-      registry.activeSequenceCombos.delete(combo);
-      const firstStep = _canonicalizeParsed(parsedSteps[0]);
-      const indexedCombos = registry.firstStepIndex.get(firstStep);
-      if (indexedCombos) {
-        indexedCombos.delete(combo);
-        if (indexedCombos.size === 0) {
-          registry.firstStepIndex.delete(firstStep);
-        }
-      }
-      _debugLog(debug, "Unregistered:", combo);
-    } else {
-      registry.listeners.set(combo, nextEntries);
-    }
-    if (registry.listeners.size === 0) {
-      _detachRegistryListener(registry);
-    }
-  };
-  return {
-    unbind: unbindEntry,
-    display,
-    combo,
-    trigger: () => handler(new KeyboardEvent(registry.options.eventType ?? "keydown")),
-    get isEnabled() {
-      return entry.isEnabled;
-    },
-    enable: () => {
-      entry.isEnabled = true;
-    },
-    disable: () => {
-      entry.isEnabled = false;
-    },
-    onAttempt: (callback) => {
-      entry.attemptCallbacks.add(callback);
-      return () => entry.attemptCallbacks.delete(callback);
-    }
-  };
-}
-
-// src/runtime/recording.ts
-function _createRecorder(options) {
-  return (recordingOptions = {}) => {
-    return new Promise((resolve, reject) => {
-      const target = recordingOptions.target ?? options.target ?? (typeof window !== "undefined" ? window : null);
-      const eventType = recordingOptions.eventType ?? options.eventType ?? "keydown";
-      if (!target) {
-        reject(new Error("[useShortcut] Cannot record shortcut without a target."));
-        return;
-      }
-      let timeout;
-      const listener = (event) => {
-        const keyboardEvent = event;
-        if (_isPureModifier(keyboardEvent)) return;
-        keyboardEvent.preventDefault();
-        target.removeEventListener(eventType, listener);
-        if (timeout) clearTimeout(timeout);
-        resolve(_eventToCombo(keyboardEvent));
-      };
-      target.addEventListener(eventType, listener);
-      const timeoutMs = recordingOptions.timeoutMs;
-      if (timeoutMs && timeoutMs > 0) {
-        timeout = setTimeout(() => {
-          target.removeEventListener(eventType, listener);
-          reject(new Error(`[useShortcut] Recording timed out after ${timeoutMs}ms.`));
-        }, timeoutMs);
-      }
-    });
-  };
-}
-
-// src/builder.ts
-var _MODIFIER_KEYS = /* @__PURE__ */ new Set(["ctrl", "shift", "alt", "cmd", "mod"]);
-function _createShortcutBuilder(options = {}) {
-  const registry = {
-    listeners: /* @__PURE__ */ new Map(),
-    firstStepIndex: /* @__PURE__ */ new Map(),
-    activeSequenceCombos: /* @__PURE__ */ new Set(),
-    options,
-    activeScopes: new Set(_normalizeScopes(options.activeScopes)),
-    nextId: 1,
-    listener: null,
-    listenerTarget: null,
-    listenerEventType: options.eventType ?? "keydown"
-  };
-  _debugLog(options.debug, "Builder created with options:", options);
-  function _createProxy(currentState) {
-    return new Proxy({}, {
-      get(_, prop) {
-        if (prop === "__debug") {
-          return currentState.options.debug;
-        }
-        if (_MODIFIER_KEYS.has(prop)) {
-          const platform = detectPlatform();
-          const modKey = prop === "mod" ? platform === Platform.MAC ? "cmd" : "ctrl" : prop;
-          const newState = {
-            ...currentState,
-            modifiers: { ...currentState.modifiers, [modKey]: true }
-          };
-          _debugLog(currentState.options.debug, `Chain: +${prop} \u2192`, newState.modifiers);
-          return _createProxy(newState);
-        }
-        if (prop === "in") {
-          return (scopes) => {
-            const nextScopes = [..._normalizeScopes(currentState.scopes), ..._normalizeScopes(scopes)];
-            const newState = {
-              ...currentState,
-              scopes: nextScopes
-            };
-            return _createProxy(newState);
-          };
-        }
-        if (prop === "setScopes") {
-          return (scopes) => {
-            registry.activeScopes = new Set(_normalizeScopes(scopes));
-          };
-        }
-        if (prop === "enableScope") {
-          return (scope) => {
-            if (!scope?.trim()) return;
-            registry.activeScopes.add(scope.trim());
-          };
-        }
-        if (prop === "disableScope") {
-          return (scope) => {
-            if (!scope?.trim()) return;
-            registry.activeScopes.delete(scope.trim());
-          };
-        }
-        if (prop === "getScopes") {
-          return () => [...registry.activeScopes];
-        }
-        if (prop === "isScopeActive") {
-          return (scope) => registry.activeScopes.has(scope);
-        }
-        if (prop === "record") {
-          return _createRecorder(registry.options);
-        }
-        if (prop === "key") {
-          return (key) => {
-            const nextStep = _buildComboString(currentState.modifiers, key);
-            const newState = {
-              ...currentState,
-              modifiers: {},
-              steps: [...currentState.steps, nextStep]
-            };
-            _debugLog(currentState.options.debug, `Chain: .key("${key}")`);
-            return _createProxy(newState);
-          };
-        }
-        if (prop === "then") {
-          return (key) => {
-            const nextStep = String(key).trim().toLowerCase();
-            if (!nextStep) {
-              throw new Error("[useShortcut] .then() requires a non-empty key or shortcut step.");
-            }
-            const newState = {
-              ...currentState,
-              steps: [...currentState.steps, nextStep]
-            };
-            _debugLog(currentState.options.debug, `Chain: .then("${nextStep}")`);
-            return _createProxy(newState);
-          };
-        }
-        if (prop === "except") {
-          return (condition) => {
-            const newState = {
-              ...currentState,
-              except: condition
-            };
-            _debugLog(currentState.options.debug, "Chain: .except()", condition);
-            return _createProxy(newState);
-          };
-        }
-        if (prop === "on") {
-          return (handler, handlerOptions) => {
-            return _createBinding(currentState, handler, handlerOptions, registry);
-          };
-        }
-        if (prop === "handle") {
-          return (opts) => {
-            const { handler, ...rest } = opts;
-            return _createBinding(currentState, handler, rest, registry);
-          };
-        }
-        return void 0;
-      }
-    });
-  }
-  const initialState = {
-    modifiers: {},
-    steps: [],
-    options
-  };
-  return {
-    builder: _createProxy(initialState),
-    registry
-  };
-}
-
-// src/hook.ts
-function _areShortcutMapKeysEqual(a, b) {
-  if (Array.isArray(a) && Array.isArray(b)) {
-    if (a.length !== b.length) return false;
-    for (let i = 0; i < a.length; i += 1) {
-      if (a[i] !== b[i]) return false;
-    }
-    return true;
-  }
-  if (!Array.isArray(a) && !Array.isArray(b)) {
-    return a === b;
-  }
-  return false;
-}
-function _areShortcutMapsEquivalent(a, b) {
-  const aKeys = Object.keys(a);
-  const bKeys = Object.keys(b);
-  if (aKeys.length !== bKeys.length) return false;
-  for (const key of aKeys) {
-    const aEntry = a[key];
-    const bEntry = b[key];
-    if (!bEntry) return false;
-    if (!_areShortcutMapKeysEqual(aEntry.keys, bEntry.keys)) return false;
-    if (aEntry.handler !== bEntry.handler) return false;
-    if (aEntry.options !== bEntry.options) return false;
-  }
-  return true;
-}
-function _normalizeShortcutMapKeys(keys) {
-  if (Array.isArray(keys)) {
-    return keys.map((key) => key.trim()).filter(Boolean);
-  }
-  const trimmed = keys.trim();
-  if (!trimmed) return [];
-  if (trimmed.includes(" then ")) {
-    return trimmed.split(/\s+then\s+/i).map((key) => key.trim()).filter(Boolean);
-  }
-  if (trimmed.includes(" ") && !trimmed.includes("+")) {
-    return trimmed.split(/\s+/).map((key) => key.trim()).filter(Boolean);
-  }
-  return [trimmed];
-}
-function _applyStep(builder, step) {
-  const tokens = step.toLowerCase().split("+").map((token) => token.trim()).filter(Boolean);
-  if (tokens.length === 0) {
-    throw new Error("[useShortcutMap] Invalid step: empty shortcut step");
-  }
-  const key = tokens.pop();
-  let chain = builder;
-  for (const token of tokens) {
-    if (token === "ctrl" || token === "control") {
-      chain = chain.ctrl;
-      continue;
-    }
-    if (token === "shift") {
-      chain = chain.shift;
-      continue;
-    }
-    if (token === "alt" || token === "option") {
-      chain = chain.alt;
-      continue;
-    }
-    if (token === "cmd" || token === "command" || token === "meta") {
-      chain = chain.cmd;
-      continue;
-    }
-    if (token === "mod") {
-      chain = chain.mod;
-      continue;
-    }
-    throw new Error(`[useShortcutMap] Unsupported modifier token "${token}" in step "${step}"`);
-  }
-  return chain.key(key);
-}
-function registerShortcutMap(builder, shortcutMap) {
-  const results = {};
-  for (const id of Object.keys(shortcutMap)) {
-    const entry = shortcutMap[id];
-    const steps = _normalizeShortcutMapKeys(entry.keys);
-    if (steps.length === 0) {
-      throw new Error(`[useShortcutMap] Shortcut "${String(id)}" has no key steps`);
-    }
-    let chain = _applyStep(builder, steps[0]);
-    for (const step of steps.slice(1)) {
-      chain = chain.then(step);
-    }
-    results[id] = chain.on(entry.handler, entry.options);
-  }
-  return results;
-}
-function useShortcut(options = {}) {
-  const optionsRef = useRef(options);
-  optionsRef.current = options;
-  const { builder, registry } = useMemo(() => {
-    return _createShortcutBuilder(optionsRef.current);
-  }, []);
-  useEffect(() => {
-    registry.options = optionsRef.current;
-    if (optionsRef.current.activeScopes !== void 0) {
-      const scopes = Array.isArray(optionsRef.current.activeScopes) ? optionsRef.current.activeScopes : [optionsRef.current.activeScopes];
-      registry.activeScopes = new Set(scopes.map((scope) => scope.trim()).filter(Boolean));
-    }
-  }, [registry, options]);
-  useEffect(() => {
-    return () => {
-      registry.listeners.clear();
-      registry.firstStepIndex.clear();
-      registry.activeSequenceCombos.clear();
-      if (registry.listener && registry.listenerTarget) {
-        registry.listenerTarget.removeEventListener(registry.listenerEventType, registry.listener);
-        registry.listener = null;
-        registry.listenerTarget = null;
-      }
-    };
-  }, [registry]);
-  return builder;
-}
-function useShortcutMap(shortcutMap, options = {}) {
-  const $ = useShortcut(options);
-  const stableShortcutMapRef = useRef(shortcutMap);
-  if (!_areShortcutMapsEquivalent(stableShortcutMapRef.current, shortcutMap)) {
-    stableShortcutMapRef.current = shortcutMap;
-  }
-  const stableShortcutMap = stableShortcutMapRef.current;
-  const resultsRef = useRef({});
-  useEffect(() => {
-    const registrations = registerShortcutMap($, stableShortcutMap);
-    const results = resultsRef.current;
-    for (const key of Object.keys(results)) {
-      delete results[key];
-    }
-    Object.assign(results, registrations);
-    return () => {
-      for (const result of Object.values(registrations)) {
-        result.unbind();
-      }
-      for (const key of Object.keys(results)) {
-        delete results[key];
-      }
-    };
-  }, [$, stableShortcutMap]);
-  return resultsRef.current;
-}
-function createShortcutGroup() {
-  const results = [];
-  return {
-    add: (...entries) => {
-      results.push(...entries);
-    },
-    addMany: (entries) => {
-      if (Array.isArray(entries)) {
-        results.push(...entries);
-        return;
-      }
-      results.push(...Object.values(entries));
-    },
-    unbindAll: () => {
-      for (const entry of results) {
-        entry.unbind();
-      }
-      results.length = 0;
-    },
-    clear: () => {
-      results.length = 0;
-    },
-    getResults: () => [...results]
-  };
-}
-function useShortcutGroup() {
-  const groupRef = useRef(null);
-  if (!groupRef.current) {
-    groupRef.current = createShortcutGroup();
-  }
-  return groupRef.current;
-}
-
-export { ModifierAliases, ModifierDisplayOrder, ModifierDisplaySymbols, ModifierKey, Platform, SpecialKeyMap, createShortcutGroup, detectPlatform, formatShortcut, matchesAnyShortcut, matchesShortcut, parseShortcut, parseShortcuts, registerShortcutMap, useShortcut, useShortcutGroup, useShortcutMap };
-//# sourceMappingURL=index.mjs.map
-//# sourceMappingURL=index.mjs.map
+import {useRef,useMemo,useEffect}from'react';var m={MAC:"mac",WINDOWS:"windows",LINUX:"linux"},R=m,y=null;function E(){if(y)return y;if(typeof navigator>"u")return y=m.WINDOWS,y;let e=(navigator.userAgentData?.platform?.toLowerCase()??navigator.platform??navigator.userAgent??"").toLowerCase();return e.includes("mac")||e.includes("iphone")||e.includes("ipad")||e.includes("ipod")?(y=m.MAC,y):e.includes("linux")||e.includes("android")?(y=m.LINUX,y):(e.includes("win"),y=m.WINDOWS,y)}var p={META:"meta",CTRL:"ctrl",ALT:"alt",SHIFT:"shift"},F={command:p.META,cmd:p.META,"\u2318":p.META,meta:p.META,win:p.META,windows:p.META,super:p.META,mod:p.META,control:p.CTRL,ctrl:p.CTRL,"\u2303":p.CTRL,ctl:p.CTRL,alt:p.ALT,option:p.ALT,opt:p.ALT,"\u2325":p.ALT,shift:p.SHIFT,"\u21E7":p.SHIFT,shft:p.SHIFT},N={up:"ArrowUp",down:"ArrowDown",left:"ArrowLeft",right:"ArrowRight",home:"Home",end:"End",pageup:"PageUp",pagedown:"PageDown",enter:"Enter",return:"Enter",space:" ",spacebar:" ",tab:"Tab",backspace:"Backspace",delete:"Delete",del:"Delete",escape:"Escape",esc:"Escape",f1:"F1",f2:"F2",f3:"F3",f4:"F4",f5:"F5",f6:"F6",f7:"F7",f8:"F8",f9:"F9",f10:"F10",f11:"F11",f12:"F12",plus:"+",minus:"-",comma:",",period:".",slash:"/",backslash:"\\",bracket:"[",closebracket:"]"},U={[m.MAC]:{[p.META]:"\u2318",[p.CTRL]:"\u2303",[p.ALT]:"\u2325",[p.SHIFT]:"\u21E7"},[m.WINDOWS]:{[p.META]:"Ctrl",[p.CTRL]:"Ctrl",[p.ALT]:"Alt",[p.SHIFT]:"Shift"},[m.LINUX]:{[p.META]:"Super",[p.CTRL]:"Ctrl",[p.ALT]:"Alt",[p.SHIFT]:"Shift"}},L={[m.MAC]:[p.CTRL,p.ALT,p.SHIFT,p.META],[m.WINDOWS]:[p.META,p.ALT,p.SHIFT,p.CTRL],[m.LINUX]:[p.META,p.ALT,p.SHIFT,p.CTRL]};function G(t){return t===" "?"space":t.toLowerCase()}function k(t){let e=E(),o=t.toLowerCase().trim().split(/[\s+-]+/).filter(Boolean);if(o.length===0)throw new Error(`Invalid shortcut: "${t}"`);let n={meta:false,ctrl:false,alt:false,shift:false},s=o.pop();for(let i of o){let u=F[i];u?i==="mod"?e===R.MAC?n.meta=true:n.ctrl=true:n[u]=true:s=i+s;}let c=N[s]||s;return {modifiers:n,key:c.length===1?c.toLowerCase():c,original:t}}function gt(t){return (Array.isArray(t)?t:[t]).map(k)}function yt(t){return {meta:t.metaKey,ctrl:t.ctrlKey,alt:t.altKey,shift:t.shiftKey}}function P(t,e){let r=yt(t),o=G(t.key),n=r.meta===e.modifiers.meta&&r.ctrl===e.modifiers.ctrl&&r.alt===e.modifiers.alt&&r.shift===e.modifiers.shift,s=o===G(e.key);return n&&s}function bt(t,e){return e.some(r=>P(t,r))}var X={ArrowUp:"\u2191",ArrowDown:"\u2193",ArrowLeft:"\u2190",ArrowRight:"\u2192",Home:"Home",End:"End",PageUp:"PgUp",PageDown:"PgDn"},Et={...X,Enter:"\u21A9",Tab:"\u21E5",Escape:"\u238B",Backspace:"\u232B",Delete:"\u2326"," ":"\u2423"},Tt={...X,Enter:"Enter",Tab:"Tab",Escape:"Esc",Backspace:"Backspace",Delete:"Del"," ":"Space"};function q(t,e){let r=e??E(),o=k(t),n=U[r],s=L[r],c=[];for(let f of s)o.modifiers[f]&&c.push(n[f]);let i=Mt(o.key,r);c.push(i);let u=r===m.MAC?"":"+";return c.join(u)}function Mt(t,e){return (e===m.MAC?Et:Tt)[t]||t.toUpperCase()}function At(t){return t==="ctrl"||t==="alt"||t==="shift"||t==="cmd"}function z(t){return t.split("+").map(e=>e.trim()).filter(Boolean)}function Y(t){if(t)return t===true?{console:true}:t}function v(t){let e=Y(t);return e?e.console!==false:false}function h(t,...e){v(t)&&console.log("[useShortcut]",...e);}function J(t,e){return {key:t.key,code:t.code,location:t.location,repeat:t.repeat,keyCode:"keyCode"in t?t.keyCode:void 0,which:"which"in t?t.which:void 0,combo:e,modifiers:{meta:t.metaKey,ctrl:t.ctrlKey,alt:t.altKey,shift:t.shiftKey}}}function Ct(t,e,r){return e.has(t)?"match":r.has(t)?"wrong-order":"mismatch"}function Q(t,e,r){return t.map((o,n)=>{let s=e[n];if(!s)return {index:n,expected:o,status:"pending",tokens:[]};let c=new Set(z(o)),i=new Set(t.slice(n+1).flatMap(z)),u=z(s).map((l,b,_)=>({token:l,kind:At(l)||b<_.length-1?"modifier":"key",status:Ct(l,c,i)}));if(s===o)return {index:n,expected:o,actual:s,status:r||n<e.length-1?"match":"partial",tokens:u};let f=t.slice(n+1).includes(s)?"wrong-order":"mismatch";return {index:n,expected:o,actual:s,status:f,tokens:u}})}function V(t,e,r,o){if(o)return "matched";let n=t.slice(0,r);return n.length>0&&n.every(s=>s.status==="match"||s.status==="partial")?r<e?"partial":"mismatch":n.some(s=>s.status==="wrong-order")?"wrong-order":"mismatch"}function Z(t,e){if(!v(t))return;let r=Y(t),o=[];if(r?.includeCode&&e.input.code&&o.push(`code=${e.input.code}`),r?.includeLocation&&o.push(`location=${String(e.input.location)}`),r?.includeKeyCode&&(typeof e.input.keyCode=="number"&&o.push(`keyCode=${String(e.input.keyCode)}`),typeof e.input.which=="number"&&o.push(`which=${String(e.input.which)}`)),e.attempts.length===0){console.log("[useShortcut]","key",e.input.combo,...o);return}for(let n of e.attempts)console.log("[useShortcut]",n.status.toUpperCase(),`${e.input.combo} -> ${n.combo}`,...o);}function xt(t){let e=E(),r=L[e],o=[];for(let n of r)n===p.CTRL&&t.ctrl&&o.push("ctrl"),n===p.ALT&&t.alt&&o.push("alt"),n===p.SHIFT&&t.shift&&o.push("shift"),n===p.META&&t.cmd&&o.push("cmd");return o}function tt(t,e){return [...xt(t),e].join("+")}function et(t){return t.map(e=>q(e)).join(" then ")}function A(t){let e=[];t.modifiers.ctrl&&e.push("ctrl"),t.modifiers.alt&&e.push("alt"),t.modifiers.shift&&e.push("shift"),t.modifiers.meta&&e.push("cmd");let r=t.key===" "||t.key==="Spacebar"?"space":t.key.toLowerCase();return [...e,r].join("+")}function $(t){let e=[];t.ctrlKey&&e.push("ctrl"),t.altKey&&e.push("alt"),t.shiftKey&&e.push("shift"),t.metaKey&&e.push("cmd");let r=t.key===" "||t.key==="Spacebar"?"space":t.key.toLowerCase();return [...e,r].join("+")}function rt(t){return $(t)}function ot(t,e){if(t.length>e.length)return  false;for(let r=0;r<t.length;r+=1)if(t[r]!==e[r])return  false;return  true}function nt(t,e){let r=t.map(A),o=e.map(A),n=r.join(" "),s=o.join(" ");return n===s?"exact":ot(r,o)||ot(o,r)?"sequence-prefix":null}function st(t,e){let r=t.options.conflictWarnings??true;if(t.options.onConflict){t.options.onConflict(e);return}r&&console.warn(`[useShortcut] Conflict detected (${e.reason}) between "${e.combo}" and "${e.existingCombo}"`);}var K=new Set(["INPUT","TEXTAREA","SELECT"]),it={input:t=>{if(!(t.target instanceof HTMLElement))return  false;let e=t.target;return K.has(e.tagName)},editable:t=>t.target instanceof HTMLElement?t.target.isContentEditable:false,typing:t=>{if(!(t.target instanceof HTMLElement))return  false;let e=t.target;return K.has(e.tagName)||e.isContentEditable},modal:()=>typeof document>"u"||typeof document.querySelector!="function"?false:document.querySelector('[data-modal="true"], [role="dialog"]')!==null,disabled:t=>{if(!(t.target instanceof HTMLElement))return  false;let e=t.target;return e.hasAttribute("disabled")||e.getAttribute("aria-disabled")==="true"}};function ct(t,e){return e?typeof e=="function"?e(t):Array.isArray(e)?e.some(r=>it[r]?.(t)):it[e]?.(t)??false:false}function C(t){return t?(Array.isArray(t)?t:[t]).map(e=>e.trim()).filter(Boolean):[]}function ut(t,e){if(t.size===0)return  true;for(let r of t)if(e.has(r))return  true;return  false}function at(t){let e=t.key.toLowerCase();return e==="shift"||e==="control"||e==="alt"||e==="meta"}function wt(t){return t.length<=1?t:[...t].sort((e,r)=>r.priority!==e.priority?r.priority-e.priority:e.id-r.id)}function kt(t,e){let r=t.options;if(r.disabled||r.eventFilter&&!r.eventFilter(e))return;let o=rt(e),n=J(e,o),s=[],c=new Set,i=t.debugListeners.size>0||v(r.debug)||[...t.listeners.values()].some(l=>l.some(b=>b.attemptCallbacks.size>0)),u=t.firstStepIndex.get(o);if(u)for(let l of u)c.add(l);for(let l of t.activeSequenceCombos)c.add(l);if(i)for(let l of t.listeners.keys())c.add(l);for(let l of c){let b=t.listeners.get(l);if(!b)continue;let _=wt(b);for(let a of _){if(!a.isEnabled||!ut(a.scopes,t.activeScopes))continue;if(r.ignoreInputs!==false&&!a.except){let S=e.target;if(S&&(K.has(S.tagName)||S.isContentEditable))continue}if(ct(e,a.except)){h(r.debug,"Skipped due to except condition:",l);continue}let O=a.parsedSteps[a.progress],T=Date.now();a.progress>0&&T-a.lastMatchedAt>a.sequenceTimeout&&(a.progress=0),a.debugHistory.length>0&&T-a.lastDebugAt>a.sequenceTimeout&&(a.debugHistory=[]);let H=a.progress,M=false;P(e,O)?(a.progress+=1,a.lastMatchedAt=T,a.progress===a.parsedSteps.length&&(M=true,a.progress=0)):a.progress>0&&P(e,a.parsedSteps[0])?(a.progress=1,a.lastMatchedAt=T):a.progress=0,a.lastDebugAt=T,a.debugHistory.push(o),a.debugHistory.length>a.expectedSteps.length&&a.debugHistory.shift();let g=a.debugHistory.slice(-a.expectedSteps.length),D=Q(a.expectedSteps,g,M),B={combo:a.combo,display:a.display,description:a.description,status:V(D,a.expectedSteps.length,g.length,M),matched:M,progress:a.progress,expectedSteps:a.expectedSteps,actualSteps:g,stepIndex:H,input:n,steps:D};s.push(B);for(let S of a.attemptCallbacks)S(M,e,B);if(!M)continue;h(r.debug,"MATCHED:",l),a.preventDefault&&e.preventDefault(),a.stopPropagation&&e.stopPropagation();let d=()=>a.userHandler(e);if(a.delay>0?(h(r.debug,"Delaying execution by",a.delay,"ms"),setTimeout(d,a.delay)):d(),a.stopOnMatch)break}b.some(a=>a.progress>0)?t.activeSequenceCombos.add(l):t.activeSequenceCombos.delete(l);}let f={input:n,attempts:s};if(t.debugListeners.size>0)for(let l of t.debugListeners)l(f);Z(r.debug,f);}function pt(t){if(t.listener)return;let e=t.options.target??(typeof window<"u"?window:null);if(!e)return;let r=t.options.eventType??"keydown",o=n=>kt(t,n);e.addEventListener(r,o),t.listener=o,t.listenerTarget=e,t.listenerEventType=r,h(t.options.debug,"Listener attached");}function lt(t){!t.listener||!t.listenerTarget||(t.listenerTarget.removeEventListener(t.listenerEventType,t.listener),t.listener=null,t.listenerTarget=null,h(t.options.debug,"Listener detached"));}function j(t,e,r={},o){let{options:n,except:s}=t,c=t.steps;if(c.length===0)throw new Error("[useShortcut] No key specified. Use .key() to set the action key.");let i=c.map(d=>k(d)),u=i.map(A).join(" "),f=et(c),l=n.debug??false,b=s??r.except;for(let[d,S]of o.listeners.entries())for(let x of S){if(d===u)continue;let w=nt(i,x.parsedSteps);w&&st(o,{combo:u,existingCombo:d,reason:w});}let _=!r.disabled&&!n.disabled,a=r.delay??n.delay??0,O=r.sequenceTimeout??n.sequenceTimeout??800,T=new Set(C(t.scopes??r.scopes)),H=i.map(A),M=new Set;h(l,"Registering:",u,"\u2192",f,{parsedSteps:i,except:!!b,scopes:[...T]});let g={id:o.nextId++,userHandler:e,isEnabled:_,combo:u,display:f,description:r.description,attemptCallbacks:M,parsedSteps:i,expectedSteps:H,scopes:T,progress:0,lastMatchedAt:0,debugHistory:[],lastDebugAt:0,except:b,delay:a,sequenceTimeout:O,preventDefault:r.preventDefault!==false,stopPropagation:r.stopPropagation??false,stopOnMatch:r.stopOnMatch??false,priority:r.priority??0},D=o.listeners.get(u);if(D)D.push(g);else {o.listeners.set(u,[g]);let d=A(i[0]),S=o.firstStepIndex.get(d);S?S.add(u):o.firstStepIndex.set(d,new Set([u]));}return pt(o),{unbind:()=>{let d=o.listeners.get(u);if(!d)return;let S=d.filter(x=>x.id!==g.id);if(S.length===0){o.listeners.delete(u),o.activeSequenceCombos.delete(u);let x=A(i[0]),w=o.firstStepIndex.get(x);w&&(w.delete(u),w.size===0&&o.firstStepIndex.delete(x)),h(l,"Unregistered:",u);}else o.listeners.set(u,S);o.listeners.size===0&&lt(o);},display:f,combo:u,trigger:()=>e(new KeyboardEvent(o.options.eventType??"keydown")),get isEnabled(){return g.isEnabled},enable:()=>{g.isEnabled=true;},disable:()=>{g.isEnabled=false;},onAttempt:d=>(g.attemptCallbacks.add(d),()=>g.attemptCallbacks.delete(d))}}function ft(t){return (e={})=>new Promise((r,o)=>{let n=e.target??t.target??(typeof window<"u"?window:null),s=e.eventType??t.eventType??"keydown";if(!n){o(new Error("[useShortcut] Cannot record shortcut without a target."));return}let c,i=f=>{let l=f;at(l)||(l.preventDefault(),n.removeEventListener(s,i),c&&clearTimeout(c),r($(l)));};n.addEventListener(s,i);let u=e.timeoutMs;u&&u>0&&(c=setTimeout(()=>{n.removeEventListener(s,i),o(new Error(`[useShortcut] Recording timed out after ${u}ms.`));},u));})}var _t=new Set(["ctrl","shift","alt","cmd","mod"]);function dt(t={}){let e={listeners:new Map,firstStepIndex:new Map,activeSequenceCombos:new Set,options:t,activeScopes:new Set(C(t.activeScopes)),nextId:1,debugListeners:new Set,listener:null,listenerTarget:null,listenerEventType:t.eventType??"keydown"};h(t.debug,"Builder created with options:",t);function r(n){return new Proxy({},{get(s,c){if(c==="__debug")return n.options.debug;if(_t.has(c)){let i=E(),u=c==="mod"?i===R.MAC?"cmd":"ctrl":c,f={...n,modifiers:{...n.modifiers,[u]:true}};return h(n.options.debug,`Chain: +${c} \u2192`,f.modifiers),r(f)}if(c==="in")return i=>{let u=[...C(n.scopes),...C(i)],f={...n,scopes:u};return r(f)};if(c==="setScopes")return i=>{e.activeScopes=new Set(C(i));};if(c==="enableScope")return i=>{i?.trim()&&e.activeScopes.add(i.trim());};if(c==="disableScope")return i=>{i?.trim()&&e.activeScopes.delete(i.trim());};if(c==="getScopes")return ()=>[...e.activeScopes];if(c==="isScopeActive")return i=>e.activeScopes.has(i);if(c==="onDebug")return i=>(e.debugListeners.add(i),()=>e.debugListeners.delete(i));if(c==="record")return ft(e.options);if(c==="key")return i=>{let u=tt(n.modifiers,i),f={...n,modifiers:{},steps:[...n.steps,u]};return h(n.options.debug,`Chain: .key("${i}")`),r(f)};if(c==="then")return i=>{let u=String(i).trim().toLowerCase();if(!u)throw new Error("[useShortcut] .then() requires a non-empty key or shortcut step.");let f={...n,steps:[...n.steps,u]};return h(n.options.debug,`Chain: .then("${u}")`),r(f)};if(c==="except")return i=>{let u={...n,except:i};return h(n.options.debug,"Chain: .except()",i),r(u)};if(c==="on")return (i,u)=>j(n,i,u,e);if(c==="handle")return i=>{let{handler:u,...f}=i;return j(n,u,f,e)}}})}return {builder:r({modifiers:{},steps:[],options:t}),registry:e}}function Rt(t,e){if(Array.isArray(t)&&Array.isArray(e)){if(t.length!==e.length)return  false;for(let r=0;r<t.length;r+=1)if(t[r]!==e[r])return  false;return  true}return !Array.isArray(t)&&!Array.isArray(e)?t===e:false}function Lt(t,e){let r=Object.keys(t),o=Object.keys(e);if(r.length!==o.length)return  false;for(let n of r){let s=t[n],c=e[n];if(!c||!Rt(s.keys,c.keys)||s.handler!==c.handler||s.options!==c.options)return  false}return  true}function Pt(t){if(Array.isArray(t))return t.map(r=>r.trim()).filter(Boolean);let e=t.trim();return e?e.includes(" then ")?e.split(/\s+then\s+/i).map(r=>r.trim()).filter(Boolean):e.includes(" ")&&!e.includes("+")?e.split(/\s+/).map(r=>r.trim()).filter(Boolean):[e]:[]}function vt(t,e){let r=e.toLowerCase().split("+").map(s=>s.trim()).filter(Boolean);if(r.length===0)throw new Error("[useShortcutMap] Invalid step: empty shortcut step");let o=r.pop(),n=t;for(let s of r){if(s==="ctrl"||s==="control"){n=n.ctrl;continue}if(s==="shift"){n=n.shift;continue}if(s==="alt"||s==="option"){n=n.alt;continue}if(s==="cmd"||s==="command"||s==="meta"){n=n.cmd;continue}if(s==="mod"){n=n.mod;continue}throw new Error(`[useShortcutMap] Unsupported modifier token "${s}" in step "${e}"`)}return n.key(o)}function mt(t,e){let r={};for(let o of Object.keys(e)){let n=e[o],s=Pt(n.keys);if(s.length===0)throw new Error(`[useShortcutMap] Shortcut "${String(o)}" has no key steps`);let c=vt(t,s[0]);for(let i of s.slice(1))c=c.then(i);r[o]=c.on(n.handler,n.options);}return r}function ht(t={}){let e=useRef(t);e.current=t;let{builder:r,registry:o}=useMemo(()=>dt(e.current),[]);return useEffect(()=>{if(o.options=e.current,e.current.activeScopes!==void 0){let n=Array.isArray(e.current.activeScopes)?e.current.activeScopes:[e.current.activeScopes];o.activeScopes=new Set(n.map(s=>s.trim()).filter(Boolean));}},[o,t]),useEffect(()=>()=>{o.listeners.clear(),o.firstStepIndex.clear(),o.activeSequenceCombos.clear(),o.listener&&o.listenerTarget&&(o.listenerTarget.removeEventListener(o.listenerEventType,o.listener),o.listener=null,o.listenerTarget=null);},[o]),r}function Kt(t,e={}){let r=ht(e),o=useRef(t);Lt(o.current,t)||(o.current=t);let n=o.current,s=useRef({});return useEffect(()=>{let c=mt(r,n),i=s.current;for(let u of Object.keys(i))delete i[u];return Object.assign(i,c),()=>{for(let u of Object.values(c))u.unbind();for(let u of Object.keys(i))delete i[u];}},[r,n]),s.current}function St(){let t=[];return {add:(...e)=>{t.push(...e);},addMany:e=>{if(Array.isArray(e)){t.push(...e);return}t.push(...Object.values(e));},unbindAll:()=>{for(let e of t)e.unbind();t.length=0;},clear:()=>{t.length=0;},getResults:()=>[...t]}}function It(){let t=useRef(null);return t.current||(t.current=St()),t.current}export{F as ModifierAliases,L as ModifierDisplayOrder,U as ModifierDisplaySymbols,p as ModifierKey,R as Platform,N as SpecialKeyMap,St as createShortcutGroup,E as detectPlatform,q as formatShortcut,bt as matchesAnyShortcut,P as matchesShortcut,k as parseShortcut,gt as parseShortcuts,mt as registerShortcutMap,ht as useShortcut,It as useShortcutGroup,Kt as useShortcutMap};