hotkey-router 0.1.0 → 0.2.0

package/dist/auto.js

@@ -0,0 +1,967 @@
+// hotkey-router v0.2.0 | SEE LICENSE IN LICENSE
+
+
+// hotkey-router.js
+function on(target, type, fn, options) {
+  target.addEventListener(type, fn, options);
+  return () => target.removeEventListener(type, fn, options);
+}
+var isMac = typeof navigator !== "undefined" && /Mac|iPhone|iPad|iPod/.test(navigator.platform);
+var modifierTokens = /* @__PURE__ */ new Set(["ctrl", "shift", "alt", "meta"]);
+var MODIFIER_KEY_TOKEN = Object.freeze({
+  Alt: "alt",
+  AltGraph: "alt",
+  Control: "ctrl",
+  Shift: "shift",
+  Meta: "meta",
+  OS: "meta"
+});
+var ahkPrefixMap = /* @__PURE__ */ new Map([
+  ["^", "ctrl"],
+  // Ctrl
+  ["!", "alt"],
+  // Alt
+  ["+", "shift"],
+  // Shift
+  ["#", "meta"]
+  // Win / Command
+]);
+var keyAliases = Object.freeze({
+  // common
+  esc: "escape",
+  escape: "escape",
+  space: " ",
+  spacebar: " ",
+  enter: "enter",
+  return: "enter",
+  del: "delete",
+  delete: "delete",
+  backspace: "backspace",
+  tab: "tab",
+  // arrows
+  up: "arrowup",
+  down: "arrowdown",
+  left: "arrowleft",
+  right: "arrowright",
+  // navigation
+  home: "home",
+  end: "end",
+  pageup: "pageup",
+  pagedown: "pagedown",
+  pgup: "pageup",
+  pgdn: "pagedown",
+  // modifiers (words)
+  cmd: "meta",
+  command: "meta",
+  win: "meta",
+  meta: "meta",
+  control: "ctrl",
+  ctrl: "ctrl",
+  option: "alt",
+  alt: "alt",
+  shift: "shift",
+  // modifiers (symbols)
+  "\u2318": "meta",
+  "\u2303": "ctrl",
+  "\u2325": "alt",
+  "\u21E7": "shift",
+  // cross-platform "mod"
+  mod: isMac ? "meta" : "ctrl",
+  // plus key ergonomics
+  plus: "+"
+});
+var ignoreEditable = true;
+var defaultTarget = typeof window !== "undefined" ? window : null;
+var bindHooks = [];
+var registry = /* @__PURE__ */ new Map();
+var plugins = /* @__PURE__ */ new Map();
+var bindingIndex = /* @__PURE__ */ new Map();
+var paused = false;
+var nextId = 1;
+function normalizeKey(key) {
+  const raw = String(key ?? "").trim();
+  const k = raw.toLowerCase();
+  return keyAliases[k] ?? (raw === " " ? " " : k);
+}
+function comboKeyFromParts({ ctrl, shift, alt, meta, key, code, bareModifier }) {
+  if (bareModifier) return `__bare__:${bareModifier}`;
+  let s = "";
+  if (ctrl) s += "ctrl+";
+  if (shift) s += "shift+";
+  if (alt) s += "alt+";
+  if (meta) s += "meta+";
+  if (code) return s + "code:" + code;
+  return s ? s + key : key;
+}
+function comboKeyFromEvent(e) {
+  const bareMod = MODIFIER_KEY_TOKEN[e.key];
+  if (bareMod) return `__bare__:${bareMod}`;
+  return comboKeyFromParts({
+    ctrl: e.ctrlKey,
+    shift: e.shiftKey,
+    alt: e.altKey,
+    meta: e.metaKey,
+    key: normalizeKey(e.key)
+  });
+}
+function codeKeyFromEvent(e) {
+  if (!e.code) return null;
+  let s = "";
+  if (e.ctrlKey) s += "ctrl+";
+  if (e.shiftKey) s += "shift+";
+  if (e.altKey) s += "alt+";
+  if (e.metaKey) s += "meta+";
+  return s + "code:" + e.code;
+}
+function isModifierToken(token) {
+  const t = normalizeKey(token);
+  return modifierTokens.has(t);
+}
+var CODE_TOKEN_RE = /(^|\+)code:([A-Za-z][A-Za-z0-9_]*)/;
+function parseHotkey(hotkeyStr) {
+  const raw = String(hotkeyStr || "").trim();
+  const isUp = /\s+up$/i.test(raw);
+  const baseRaw = isUp ? raw.replace(/\s+up$/i, "").trim() : raw;
+  const combo = {
+    ctrl: false,
+    shift: false,
+    alt: false,
+    meta: false,
+    key: null,
+    code: null,
+    bareModifier: null
+  };
+  let stripped = baseRaw;
+  while (stripped.length) {
+    const mod = ahkPrefixMap.get(stripped[0]) ?? null;
+    if (!mod) break;
+    combo[mod] = true;
+    stripped = stripped.slice(1).trimStart();
+  }
+  const codeMatches = stripped.match(/code:[A-Za-z][A-Za-z0-9_]*/g);
+  if (codeMatches && codeMatches.length > 1) {
+    throw new Error(
+      `Invalid hotkey "${hotkeyStr}": multiple code: tokens not supported (got ${codeMatches.length}).`
+    );
+  }
+  let codeValue = null;
+  const scrubbed = stripped.replace(CODE_TOKEN_RE, (_, sep, val) => {
+    codeValue = val;
+    return sep + "__code__";
+  });
+  let cleanStr = scrubbed.toLowerCase();
+  const rawParts = cleanStr.split("+").map((p) => p.trim());
+  const parts = rawParts.filter(Boolean);
+  const impliedPlusKey = rawParts.some((p) => p === "") && cleanStr.includes("++");
+  if (!impliedPlusKey) {
+    let seenBase = false;
+    for (const part of parts) {
+      if (isModifierToken(part)) {
+        if (seenBase) {
+          throw new Error(
+            `Invalid hotkey "${hotkeyStr}": modifiers must come before the base key (e.g. "ctrl+k", not "k+ctrl")`
+          );
+        }
+      } else {
+        if (!seenBase) seenBase = true;
+      }
+    }
+  }
+  for (const part of parts) {
+    if (part === "__code__") {
+      combo.code = codeValue;
+      continue;
+    }
+    const actual = keyAliases[part] ?? part;
+    if (actual === "ctrl") combo.ctrl = true;
+    else if (actual === "shift") combo.shift = true;
+    else if (actual === "alt") combo.alt = true;
+    else if (actual === "meta") combo.meta = true;
+    else combo.key = normalizeKey(actual);
+  }
+  if (!combo.key && !combo.code && impliedPlusKey) combo.key = "+";
+  if (!combo.key && !combo.code) {
+    const modCount = (combo.ctrl ? 1 : 0) + (combo.shift ? 1 : 0) + (combo.alt ? 1 : 0) + (combo.meta ? 1 : 0);
+    if (modCount === 1) {
+      combo.bareModifier = combo.ctrl ? "ctrl" : combo.shift ? "shift" : combo.alt ? "alt" : "meta";
+    } else if (modCount > 1) {
+      throw new Error(
+        `Invalid hotkey "${hotkeyStr}": multi-modifier bare bindings not supported. Add a base key (e.g. "ctrl+alt+x").`
+      );
+    } else {
+      throw new Error(`Invalid hotkey "${hotkeyStr}" (missing base key)`);
+    }
+  }
+  return { combo, type: isUp ? "keyup" : "keydown", raw: hotkeyStr };
+}
+function isFromInputTarget(e) {
+  const t = e?.target;
+  if (!t) return false;
+  const tag = String(t.tagName || "").toUpperCase();
+  return t.isContentEditable || tag === "INPUT" || tag === "TEXTAREA" || tag === "SELECT" || t.getAttribute?.("role") === "textbox";
+}
+function normalizeOptions(type, options) {
+  const o = options ? { ...options } : {};
+  if (type === "keydown" && o.repeat == null) o.repeat = false;
+  if (o.priority == null) o.priority = 0;
+  return o;
+}
+function ensureSlot(comboStr, type) {
+  let typeMap = registry.get(comboStr);
+  if (!typeMap) {
+    typeMap = /* @__PURE__ */ new Map();
+    registry.set(comboStr, typeMap);
+  }
+  let arr = typeMap.get(type);
+  if (!arr) {
+    arr = [];
+    typeMap.set(type, arr);
+  }
+  return arr;
+}
+function removeById(id) {
+  const idx = bindingIndex.get(id);
+  if (!idx) return false;
+  const { comboStr, type } = idx;
+  const typeMap = registry.get(comboStr);
+  const arr = typeMap?.get(type);
+  if (!arr?.length) {
+    bindingIndex.delete(id);
+    return false;
+  }
+  const next = arr.filter((b) => b.id !== id);
+  if (next.length) typeMap.set(type, next);
+  else typeMap.delete(type);
+  if (!typeMap.size) registry.delete(comboStr);
+  bindingIndex.delete(id);
+  return true;
+}
+function bind(hotkeyStr, handler, plugin = null, options = {}) {
+  const { combo, type, raw } = parseHotkey(hotkeyStr);
+  const comboStr = comboKeyFromParts(combo);
+  const opts = normalizeOptions(type, options);
+  const binding = {
+    id: nextId++,
+    comboStr,
+    type,
+    combo,
+    handler,
+    plugin,
+    raw,
+    options: opts
+  };
+  ensureSlot(comboStr, type).push(binding);
+  bindingIndex.set(binding.id, { comboStr, type });
+  if (bindHooks.length) {
+    for (const hook of bindHooks) {
+      try {
+        hook({ combo, raw, options: opts, plugin, id: binding.id });
+      } catch (err) {
+        console.error("[hotkey-router] onBind hook threw:", err);
+      }
+    }
+  }
+  const off = () => removeById(binding.id);
+  off.id = binding.id;
+  off.hotkey = raw;
+  return off;
+}
+function onBind(hook) {
+  if (typeof hook !== "function") {
+    throw new TypeError("hotkeys.onBind(hook) expects a function");
+  }
+  bindHooks.push(hook);
+  return () => {
+    bindHooks = bindHooks.filter((h) => h !== hook);
+  };
+}
+function unbind(hotkeyStr, handler) {
+  const { combo, type } = parseHotkey(hotkeyStr);
+  const comboStr = comboKeyFromParts(combo);
+  const typeMap = registry.get(comboStr);
+  if (!typeMap) return;
+  const arr = typeMap.get(type);
+  if (!arr?.length) return;
+  if (!handler) {
+    for (const b of arr) bindingIndex.delete(b.id);
+    typeMap.delete(type);
+  } else {
+    const keep = [];
+    for (const b of arr) {
+      if (b.handler === handler) bindingIndex.delete(b.id);
+      else keep.push(b);
+    }
+    if (keep.length) typeMap.set(type, keep);
+    else typeMap.delete(type);
+  }
+  if (!typeMap.size) registry.delete(comboStr);
+}
+function registerPlugin(name, hotkeyMap) {
+  if (plugins.has(name)) throw new Error(`Plugin "${name}" already registered`);
+  const ids = [];
+  for (const [hotkeyStr, fnOrTuple] of Object.entries(hotkeyMap)) {
+    const [fn, options] = Array.isArray(fnOrTuple) ? fnOrTuple : [fnOrTuple, {}];
+    const off = bind(hotkeyStr, fn, name, options);
+    ids.push(off.id);
+  }
+  plugins.set(name, ids);
+  return () => unregisterPlugin(name);
+}
+function unregisterPlugin(name) {
+  const ids = plugins.get(name);
+  if (!ids) return;
+  for (const id of ids) removeById(id);
+  plugins.delete(name);
+}
+function pause() {
+  paused = true;
+}
+function resume() {
+  paused = false;
+}
+function ignoreInput(value = true) {
+  ignoreEditable = !!value;
+}
+function setTarget(target) {
+  defaultTarget = target;
+}
+function pickWinner(bindings) {
+  let best = null;
+  for (const b of bindings) {
+    if (!best) best = b;
+    else if (b.options.priority > best.options.priority) best = b;
+    else if (b.options.priority === best.options.priority && b.id > best.id) best = b;
+  }
+  return best;
+}
+function handleEvent(type) {
+  return (e) => {
+    if (paused) return;
+    const fromInput = ignoreEditable && isFromInputTarget(e);
+    const comboStr = comboKeyFromEvent(e);
+    const codeStr = codeKeyFromEvent(e);
+    const seen = /* @__PURE__ */ new Set();
+    const candidates = [];
+    for (const lookupKey of [comboStr, codeStr]) {
+      if (!lookupKey || seen.has(lookupKey)) continue;
+      seen.add(lookupKey);
+      const bindings = registry.get(lookupKey)?.get(type);
+      if (!bindings?.length) continue;
+      for (const b of bindings) {
+        const o2 = b.options;
+        if (fromInput && !o2.allowIn?.(e)) continue;
+        if (type === "keydown" && o2.repeat === false && e.repeat) continue;
+        if (o2.when && o2.when(e) === false) continue;
+        candidates.push(b);
+      }
+    }
+    if (!candidates.length) return;
+    const winner = pickWinner(candidates);
+    const o = winner.options;
+    if (o.preventDefault) e.preventDefault();
+    if (o.stopImmediatePropagation) e.stopImmediatePropagation();
+    else if (o.stopPropagation) e.stopPropagation();
+    winner.handler(e);
+    if (o.once) removeById(winner.id);
+  };
+}
+var stopDown = null;
+var stopUp = null;
+function init({ target = defaultTarget, capture = false } = {}) {
+  if (!target) throw new Error("hotkeys.init() requires a target (e.g. window)");
+  if (stopDown || stopUp) destroy();
+  stopDown = on(target, "keydown", handleEvent("keydown"), { capture });
+  stopUp = on(target, "keyup", handleEvent("keyup"), { capture });
+}
+function destroy() {
+  stopDown?.();
+  stopUp?.();
+  stopDown = null;
+  stopUp = null;
+  registry.clear();
+  plugins.clear();
+  bindingIndex.clear();
+}
+var BARE_MOD_TO_KEY = {
+  ctrl: "Control",
+  shift: "Shift",
+  alt: "Alt",
+  meta: "Meta"
+};
+function trigger(hotkeyStr, { type: forcedType } = {}) {
+  const { combo, type } = parseHotkey(hotkeyStr);
+  const comboStr = comboKeyFromParts(combo);
+  const actualType = forcedType || type;
+  const bindings = registry.get(comboStr)?.get(actualType);
+  if (!bindings?.length) return false;
+  const eventKey = combo.bareModifier ? BARE_MOD_TO_KEY[combo.bareModifier] : combo.key;
+  let altKey = !!combo.alt;
+  let ctrlKey = !!combo.ctrl;
+  let shiftKey = !!combo.shift;
+  let metaKey = !!combo.meta;
+  if (combo.bareModifier && actualType === "keyup") {
+    if (combo.bareModifier === "alt") altKey = false;
+    else if (combo.bareModifier === "ctrl") ctrlKey = false;
+    else if (combo.bareModifier === "shift") shiftKey = false;
+    else if (combo.bareModifier === "meta") metaKey = false;
+  }
+  const e = {
+    type: actualType,
+    key: eventKey,
+    code: combo.code || null,
+    ctrlKey,
+    shiftKey,
+    altKey,
+    metaKey,
+    repeat: false,
+    preventDefault() {
+    },
+    stopPropagation() {
+    },
+    stopImmediatePropagation() {
+    },
+    target: null
+  };
+  const winner = pickWinner(
+    bindings.filter((b) => b.options.when ? b.options.when(e) !== false : true)
+  );
+  if (!winner) return false;
+  winner.handler(e);
+  if (winner.options.once) removeById(winner.id);
+  return true;
+}
+if (defaultTarget) init();
+var hotkey_router_default = {
+  // lifecycle
+  init,
+  destroy,
+  setTarget,
+  // bindings
+  bind,
+  unbind,
+  registerPlugin,
+  unregisterPlugin,
+  // extension hooks
+  onBind,
+  // control
+  pause,
+  resume,
+  ignoreInput,
+  // testing / automation
+  trigger
+};
+
+// data/browser-hotkeys.json
+var browser_hotkeys_default = {
+  $comment: "Machine-readable companion to docs/browser-hotkeys.md. Each combo entry describes who claims the binding and how strongly. Intended for runtime conflict warnings in keyboard-routing libraries (e.g. hotkey-router) and dev-time validation in apps like WebRadar. Update both this file and the markdown together \u2014 the markdown is the human source of truth, this file is the machine projection.",
+  version: {
+    generated: "2026-05-17",
+    schema: "1.0",
+    sources: [
+      "https://support.mozilla.org/en-US/kb/keyboard-shortcuts-perform-firefox-tasks-quickly",
+      "https://firefox-source-docs.mozilla.org/devtools-user/keyboard_shortcuts/index.html",
+      "https://support.google.com/chrome/answer/157179",
+      "https://developer.chrome.com/docs/devtools/shortcuts",
+      "https://support.apple.com/guide/safari/keyboard-shortcuts-and-gestures-cpsh003/mac",
+      "https://developer.apple.com/documentation/safari-developer-tools/web-inspector",
+      "https://support.microsoft.com/en-us/microsoft-edge/keyboard-shortcuts-in-microsoft-edge-50d3edab-30d9-c7e4-21ce-37fe2713cfad",
+      "https://support.apple.com/en-us/102650",
+      "https://support.microsoft.com/en-us/windows/keyboard-shortcuts-in-windows-dcc61a57-8ff0-cffe-9796-cb9706c75eec",
+      "https://help.gnome.org/gnome-help/shell-keyboard-shortcuts.html"
+    ]
+  },
+  severityLevels: {
+    hard: "Browser or OS intercepts before page-world keydown fires. preventDefault() can't recover it.",
+    "find-bar-only": "Reserved only when the browser's find bar has focus. Fires in page world during normal browsing.",
+    "menu-activation": "Win/Linux Alt+letter activates the browser menu bar. Hard to suppress reliably.",
+    "system-text": "Only reserved while a text input has focus (terminal-style cursor controls on macOS).",
+    compose: "macOS Option+letter types a special character in text inputs. Outside inputs, free for page world.",
+    os: "Operating system intercepts globally, before any application sees it.",
+    "devtools-open": "Only relevant when DevTools is already open; outside DevTools it fires normally."
+  },
+  $keyFormat: "Each combo key uses hotkey-router-compatible syntax: modifiers in canonical order (ctrl|meta|alt|shift) joined by '+', then the key (lowercased letter, or symbolic name). Per-platform tables use the platform's native modifier name \u2014 `meta` on macOS = Cmd, `meta` on Windows = Win, `ctrl` on Linux/Windows = the primary modifier.",
+  platforms: {
+    mac: {
+      browsers: {
+        firefox: {
+          "meta+a": { action: "Select all", severity: "hard" },
+          "meta+b": { action: "Bookmarks sidebar", severity: "hard" },
+          "meta+c": { action: "Copy", severity: "hard" },
+          "meta+d": { action: "Bookmark this page", severity: "hard" },
+          "meta+e": { action: "Search from page", severity: "hard" },
+          "meta+f": { action: "Find in page", severity: "hard" },
+          "meta+g": { action: "Find next", severity: "hard" },
+          "meta+j": { action: "Downloads", severity: "hard" },
+          "meta+l": { action: "Focus address bar", severity: "hard" },
+          "meta+n": { action: "New window", severity: "hard" },
+          "meta+o": { action: "Open file", severity: "hard" },
+          "meta+p": { action: "Print", severity: "hard" },
+          "meta+r": { action: "Reload", severity: "hard" },
+          "meta+s": { action: "Save page", severity: "hard" },
+          "meta+t": { action: "New tab", severity: "hard" },
+          "meta+u": { action: "View source", severity: "hard" },
+          "meta+v": { action: "Paste", severity: "hard" },
+          "meta+w": { action: "Close tab", severity: "hard" },
+          "meta+x": { action: "Cut", severity: "hard" },
+          "meta+y": { action: "Redo", severity: "hard" },
+          "meta+z": { action: "Undo", severity: "hard" },
+          "meta+shift+a": { action: "Add-ons manager", severity: "hard" },
+          "meta+shift+b": { action: "Bookmarks toolbar", severity: "hard" },
+          "meta+shift+c": { action: "Inspector (element picker)", severity: "hard" },
+          "meta+shift+d": { action: "Bookmark all tabs", severity: "hard" },
+          "meta+shift+e": { action: "Network Monitor", severity: "hard" },
+          "meta+shift+f": { action: "Toggle fullscreen", severity: "hard" },
+          "meta+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "meta+shift+j": { action: "Browser Console", severity: "hard" },
+          "meta+shift+n": { action: "New private window", severity: "hard" },
+          "meta+shift+o": { action: "Bookmarks library", severity: "hard" },
+          "meta+shift+p": { action: "New private window (alt)", severity: "hard" },
+          "meta+shift+q": { action: "Quit (with confirm)", severity: "hard" },
+          "meta+shift+s": { action: "Firefox Screenshot", severity: "hard" },
+          "meta+shift+t": { action: "Reopen closed tab", severity: "hard" },
+          "meta+shift+v": { action: "Paste as plain text", severity: "hard" },
+          "meta+shift+w": { action: "Close window", severity: "hard" },
+          "meta+shift+z": { action: "Redo", severity: "hard" },
+          "meta+alt+c": { action: "Inspector", severity: "hard" },
+          "meta+alt+e": { action: "Network Monitor", severity: "hard" },
+          "meta+alt+i": { action: "DevTools Toolbox", severity: "hard" },
+          "meta+alt+j": { action: "Browser Console", severity: "hard" },
+          "meta+alt+k": { action: "Web Console", severity: "hard" },
+          "meta+alt+m": { action: "Responsive Design Mode", severity: "hard" },
+          "meta+alt+z": { action: "Debugger", severity: "hard" }
+        },
+        chrome: {
+          "meta+a": { action: "Select all", severity: "hard" },
+          "meta+c": { action: "Copy", severity: "hard" },
+          "meta+d": { action: "Bookmark this page", severity: "hard" },
+          "meta+e": { action: "Search selected text", severity: "find-bar-only" },
+          "meta+f": { action: "Find in page", severity: "hard" },
+          "meta+g": { action: "Find next", severity: "hard" },
+          "meta+l": { action: "Focus address bar", severity: "hard" },
+          "meta+n": { action: "New window", severity: "hard" },
+          "meta+o": { action: "Open file", severity: "hard" },
+          "meta+p": { action: "Print", severity: "hard" },
+          "meta+r": { action: "Reload", severity: "hard" },
+          "meta+s": { action: "Save page", severity: "hard" },
+          "meta+t": { action: "New tab", severity: "hard" },
+          "meta+v": { action: "Paste", severity: "hard" },
+          "meta+w": { action: "Close tab", severity: "hard" },
+          "meta+x": { action: "Cut", severity: "hard" },
+          "meta+y": { action: "History page", severity: "hard" },
+          "meta+z": { action: "Undo", severity: "hard" },
+          "meta+shift+b": { action: "Bookmarks bar toggle", severity: "hard" },
+          "meta+shift+c": { action: "DevTools Inspector", severity: "hard" },
+          "meta+shift+d": { action: "Bookmark all tabs", severity: "hard" },
+          "meta+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "meta+shift+j": { action: "Downloads page", severity: "hard" },
+          "meta+shift+m": { action: "Switch user / guest", severity: "hard" },
+          "meta+shift+n": { action: "New incognito window", severity: "hard" },
+          "meta+shift+r": { action: "Hard reload", severity: "hard" },
+          "meta+shift+t": { action: "Reopen closed tab", severity: "hard" },
+          "meta+shift+v": { action: "Paste as plain text", severity: "hard" },
+          "meta+shift+w": { action: "Close window", severity: "hard" },
+          "meta+shift+z": { action: "Redo", severity: "hard" },
+          "meta+alt+i": { action: "DevTools", severity: "hard" },
+          "meta+alt+j": { action: "DevTools (console)", severity: "hard" },
+          "meta+alt+u": { action: "View source", severity: "hard" }
+        },
+        safari: {
+          "meta+a": { action: "Select all", severity: "hard" },
+          "meta+c": { action: "Copy", severity: "hard" },
+          "meta+d": { action: "Add to Reading List", severity: "hard" },
+          "meta+f": { action: "Find in page", severity: "hard" },
+          "meta+g": { action: "Find next", severity: "hard" },
+          "meta+j": { action: "Downloads", severity: "hard" },
+          "meta+l": { action: "Focus Smart Search", severity: "hard" },
+          "meta+n": { action: "New window", severity: "hard" },
+          "meta+p": { action: "Print", severity: "hard" },
+          "meta+r": { action: "Reload", severity: "hard" },
+          "meta+s": { action: "Save page", severity: "hard" },
+          "meta+t": { action: "New tab", severity: "hard" },
+          "meta+v": { action: "Paste", severity: "hard" },
+          "meta+w": { action: "Close tab", severity: "hard" },
+          "meta+x": { action: "Cut", severity: "hard" },
+          "meta+z": { action: "Undo", severity: "hard" },
+          "meta+shift+c": { action: "Inspector pick element", severity: "hard" },
+          "meta+shift+d": { action: "Add Reading List item", severity: "hard" },
+          "meta+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "meta+shift+h": { action: "Go to homepage", severity: "hard" },
+          "meta+shift+n": { action: "New private window", severity: "hard" },
+          "meta+shift+r": { action: "Reader mode", severity: "hard" },
+          "meta+shift+t": { action: "Reopen last closed tab", severity: "hard" },
+          "meta+shift+v": { action: "Paste as plain text", severity: "hard" },
+          "meta+shift+w": { action: "Close window", severity: "hard" },
+          "meta+shift+z": { action: "Redo", severity: "hard" },
+          "meta+alt+c": { action: "Web Inspector pick", severity: "hard" },
+          "meta+alt+i": { action: "Web Inspector", severity: "hard" }
+        }
+      },
+      system: {
+        "meta+space": { action: "Spotlight", severity: "os" },
+        "meta+tab": { action: "App switcher", severity: "os" },
+        "meta+h": { action: "Hide app", severity: "os" },
+        "meta+m": { action: "Minimize window", severity: "os" },
+        "meta+q": { action: "Quit app", severity: "os" },
+        "meta+shift+3": { action: "Screenshot full screen", severity: "os" },
+        "meta+shift+4": { action: "Screenshot selection", severity: "os" },
+        "meta+shift+5": { action: "Screen recording tool", severity: "os" },
+        "meta+shift+q": { action: "Log out", severity: "os" },
+        "meta+ctrl+q": { action: "Lock screen", severity: "os" },
+        "meta+ctrl+space": { action: "Character Viewer", severity: "os" },
+        "meta+alt+esc": { action: "Force-quit dialog", severity: "os" }
+      },
+      noteForLetterCombos: {
+        "alt+a..z": { behavior: "compose", note: "Option+letter types special characters in text inputs (Option+E\u2192\xB4, Option+A\u2192\xE5, Option+F\u2192\u0192). Outside inputs, free for page world." },
+        "ctrl+a..z": { behavior: "system-text", note: "Mac uses Ctrl+letter as terminal-style cursor controls inside text inputs (Ctrl+A=line start, Ctrl+E=line end, Ctrl+K=delete-to-end, etc.). Outside inputs, free for page world." }
+      }
+    },
+    windows: {
+      browsers: {
+        firefox: {
+          "ctrl+a": { action: "Select all", severity: "hard" },
+          "ctrl+b": { action: "Bookmarks sidebar", severity: "hard" },
+          "ctrl+c": { action: "Copy", severity: "hard" },
+          "ctrl+d": { action: "Bookmark this page", severity: "hard" },
+          "ctrl+f": { action: "Find in page", severity: "hard" },
+          "ctrl+g": { action: "Find next", severity: "hard" },
+          "ctrl+h": { action: "History sidebar", severity: "hard" },
+          "ctrl+j": { action: "Downloads", severity: "hard" },
+          "ctrl+l": { action: "Focus address bar", severity: "hard" },
+          "ctrl+n": { action: "New window", severity: "hard" },
+          "ctrl+o": { action: "Open file", severity: "hard" },
+          "ctrl+p": { action: "Print", severity: "hard" },
+          "ctrl+r": { action: "Reload", severity: "hard" },
+          "ctrl+s": { action: "Save page", severity: "hard" },
+          "ctrl+t": { action: "New tab", severity: "hard" },
+          "ctrl+u": { action: "View source", severity: "hard" },
+          "ctrl+v": { action: "Paste", severity: "hard" },
+          "ctrl+w": { action: "Close tab", severity: "hard" },
+          "ctrl+x": { action: "Cut", severity: "hard" },
+          "ctrl+y": { action: "Redo", severity: "hard" },
+          "ctrl+z": { action: "Undo", severity: "hard" },
+          "ctrl+shift+a": { action: "Add-ons manager", severity: "hard" },
+          "ctrl+shift+b": { action: "Bookmarks toolbar", severity: "hard" },
+          "ctrl+shift+c": { action: "Inspector (element picker)", severity: "hard" },
+          "ctrl+shift+d": { action: "Bookmark all tabs", severity: "hard" },
+          "ctrl+shift+e": { action: "Network Monitor", severity: "hard" },
+          "ctrl+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "ctrl+shift+i": { action: "Developer Tools", severity: "hard" },
+          "ctrl+shift+j": { action: "Browser Console", severity: "hard" },
+          "ctrl+shift+k": { action: "Web Console", severity: "hard" },
+          "ctrl+shift+m": { action: "Responsive Design Mode", severity: "hard" },
+          "ctrl+shift+n": { action: "New private window", severity: "hard" },
+          "ctrl+shift+o": { action: "Bookmarks library", severity: "hard" },
+          "ctrl+shift+p": { action: "New private window (alt)", severity: "hard" },
+          "ctrl+shift+s": { action: "Firefox Screenshot", severity: "hard" },
+          "ctrl+shift+t": { action: "Reopen closed tab", severity: "hard" },
+          "ctrl+shift+v": { action: "Paste as plain text", severity: "hard" },
+          "ctrl+shift+w": { action: "Close window", severity: "hard" },
+          "ctrl+shift+y": { action: "Downloads (alt)", severity: "hard" },
+          "ctrl+shift+z": { action: "Debugger", severity: "hard" },
+          "alt+f": { action: "File menu", severity: "menu-activation" },
+          "alt+e": { action: "Edit menu", severity: "menu-activation" },
+          "alt+v": { action: "View menu", severity: "menu-activation" },
+          "alt+b": { action: "Bookmarks menu", severity: "menu-activation" },
+          "alt+t": { action: "Tools menu", severity: "menu-activation" },
+          "alt+h": { action: "Help menu", severity: "menu-activation" },
+          "alt+d": { action: "Focus address bar", severity: "hard" }
+        },
+        chrome: {
+          "ctrl+a": { action: "Select all", severity: "hard" },
+          "ctrl+c": { action: "Copy", severity: "hard" },
+          "ctrl+d": { action: "Bookmark this page", severity: "hard" },
+          "ctrl+e": { action: "Search from page", severity: "hard" },
+          "ctrl+f": { action: "Find in page", severity: "hard" },
+          "ctrl+g": { action: "Find next", severity: "hard" },
+          "ctrl+h": { action: "History page", severity: "hard" },
+          "ctrl+j": { action: "Downloads", severity: "hard" },
+          "ctrl+k": { action: "Search from page", severity: "hard" },
+          "ctrl+l": { action: "Focus address bar", severity: "hard" },
+          "ctrl+n": { action: "New window", severity: "hard" },
+          "ctrl+o": { action: "Open file", severity: "hard" },
+          "ctrl+p": { action: "Print", severity: "hard" },
+          "ctrl+r": { action: "Reload", severity: "hard" },
+          "ctrl+s": { action: "Save page", severity: "hard" },
+          "ctrl+t": { action: "New tab", severity: "hard" },
+          "ctrl+u": { action: "View source", severity: "hard" },
+          "ctrl+v": { action: "Paste", severity: "hard" },
+          "ctrl+w": { action: "Close tab", severity: "hard" },
+          "ctrl+x": { action: "Cut", severity: "hard" },
+          "ctrl+z": { action: "Undo", severity: "hard" },
+          "ctrl+shift+b": { action: "Bookmarks bar toggle", severity: "hard" },
+          "ctrl+shift+d": { action: "Bookmark all tabs", severity: "hard" },
+          "ctrl+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "ctrl+shift+i": { action: "DevTools", severity: "hard" },
+          "ctrl+shift+j": { action: "DevTools (console)", severity: "hard" },
+          "ctrl+shift+m": { action: "Switch user / guest", severity: "hard" },
+          "ctrl+shift+n": { action: "Incognito window", severity: "hard" },
+          "ctrl+shift+r": { action: "Hard reload", severity: "hard" },
+          "ctrl+shift+t": { action: "Reopen closed tab", severity: "hard" },
+          "ctrl+shift+v": { action: "Paste as plain text", severity: "hard" },
+          "ctrl+shift+w": { action: "Close window", severity: "hard" },
+          "alt+d": { action: "Focus address bar", severity: "hard" },
+          "alt+e": { action: "Customize menu", severity: "menu-activation" },
+          "alt+f": { action: "Customize menu (alt)", severity: "menu-activation" }
+        },
+        edge: {
+          "ctrl+a": { action: "Select all", severity: "hard" },
+          "ctrl+c": { action: "Copy", severity: "hard" },
+          "ctrl+d": { action: "Favorite this page", severity: "hard" },
+          "ctrl+e": { action: "Search from page", severity: "hard" },
+          "ctrl+f": { action: "Find in page", severity: "hard" },
+          "ctrl+g": { action: "Find next", severity: "hard" },
+          "ctrl+h": { action: "History", severity: "hard" },
+          "ctrl+j": { action: "Downloads", severity: "hard" },
+          "ctrl+k": { action: "Search from page", severity: "hard" },
+          "ctrl+l": { action: "Focus address bar", severity: "hard" },
+          "ctrl+m": { action: "Mute current tab", severity: "hard" },
+          "ctrl+n": { action: "New window", severity: "hard" },
+          "ctrl+o": { action: "Open file", severity: "hard" },
+          "ctrl+p": { action: "Print", severity: "hard" },
+          "ctrl+r": { action: "Reload", severity: "hard" },
+          "ctrl+s": { action: "Save page", severity: "hard" },
+          "ctrl+t": { action: "New tab", severity: "hard" },
+          "ctrl+u": { action: "View source", severity: "hard" },
+          "ctrl+v": { action: "Paste", severity: "hard" },
+          "ctrl+w": { action: "Close tab", severity: "hard" },
+          "ctrl+x": { action: "Cut", severity: "hard" },
+          "ctrl+z": { action: "Undo", severity: "hard" },
+          "ctrl+shift+b": { action: "Favorites bar toggle", severity: "hard" },
+          "ctrl+shift+d": { action: "Bookmark all tabs in folder", severity: "hard" },
+          "ctrl+shift+e": { action: "Search in sidebar", severity: "hard" },
+          "ctrl+shift+g": { action: "Find previous", severity: "find-bar-only" },
+          "ctrl+shift+i": { action: "DevTools", severity: "hard" },
+          "ctrl+shift+j": { action: "DevTools (console)", severity: "hard" },
+          "ctrl+shift+k": { action: "Duplicate tab", severity: "hard" },
+          "ctrl+shift+l": { action: "Paste and search", severity: "hard" },
+          "ctrl+shift+m": { action: "Switch user / guest", severity: "hard" },
+          "ctrl+shift+n": { action: "InPrivate window", severity: "hard" },
+          "ctrl+shift+o": { action: "Open favorites", severity: "hard" },
+          "ctrl+shift+p": { action: "Print (system dialog)", severity: "hard" },
+          "ctrl+shift+r": { action: "Hard reload", severity: "hard" },
+          "ctrl+shift+t": { action: "Reopen closed tab", severity: "hard" },
+          "ctrl+shift+u": { action: "Read Aloud toggle", severity: "hard" },
+          "ctrl+shift+v": { action: "Paste without formatting", severity: "hard" },
+          "ctrl+shift+w": { action: "Close window", severity: "hard" },
+          "ctrl+shift+y": { action: "Collections", severity: "hard" },
+          "alt+d": { action: "Focus address bar", severity: "hard" },
+          "alt+e": { action: "Settings menu", severity: "menu-activation" },
+          "alt+f": { action: "Settings menu (alt)", severity: "menu-activation" },
+          "alt+shift+b": { action: "Focus favorites bar", severity: "hard" },
+          "alt+shift+i": { action: "Send feedback dialog", severity: "hard" },
+          "alt+shift+t": { action: "Focus app bar toolbar", severity: "hard" }
+        }
+      },
+      system: {
+        "meta+a": { action: "Action Center", severity: "os" },
+        "meta+c": { action: "Windows search", severity: "os" },
+        "meta+d": { action: "Show desktop", severity: "os" },
+        "meta+e": { action: "File Explorer", severity: "os" },
+        "meta+g": { action: "Game bar", severity: "os" },
+        "meta+h": { action: "Voice dictation", severity: "os" },
+        "meta+i": { action: "Settings", severity: "os" },
+        "meta+l": { action: "Lock", severity: "os" },
+        "meta+n": { action: "Notification center", severity: "os" },
+        "meta+p": { action: "Project / display mode", severity: "os" },
+        "meta+r": { action: "Run dialog", severity: "os" },
+        "meta+s": { action: "Search", severity: "os" },
+        "meta+v": { action: "Clipboard history", severity: "os" },
+        "meta+w": { action: "Widgets", severity: "os" },
+        "meta+x": { action: "Quick Link menu", severity: "os" },
+        "meta+z": { action: "Snap layouts", severity: "os" },
+        "meta+tab": { action: "Task View", severity: "os" },
+        "meta+shift+s": { action: "Screenshot region", severity: "os" },
+        "ctrl+shift+esc": { action: "Task Manager", severity: "os" },
+        "ctrl+alt+del": { action: "Security screen", severity: "os" },
+        "alt+tab": { action: "Switch windows", severity: "os" },
+        "alt+f4": { action: "Close active window", severity: "os" }
+      }
+    },
+    linux: {
+      browsers: {
+        firefox: "$ref:platforms.windows.browsers.firefox",
+        chrome: "$ref:platforms.windows.browsers.chrome",
+        edge: "$ref:platforms.windows.browsers.edge"
+      },
+      system: {
+        $comment: "GNOME defaults. KDE and other DEs have similar-shaped reservations but vary; this is a conservative baseline.",
+        "meta+tab": { action: "Switch windows", severity: "os" },
+        "meta+a": { action: "Show applications", severity: "os" },
+        "meta+l": { action: "Lock screen", severity: "os" },
+        "meta+v": { action: "Notification list", severity: "os" },
+        "alt+tab": { action: "Switch applications", severity: "os" },
+        "alt+esc": { action: "Cycle windows", severity: "os" },
+        "alt+f2": { action: "Run command", severity: "os" },
+        "alt+f4": { action: "Close window", severity: "os" },
+        "ctrl+alt+tab": { action: "Top-bar accessibility switcher", severity: "os" },
+        "ctrl+alt+del": { action: "Power-off dialog", severity: "os" },
+        "ctrl+shift+alt+r": { action: "Toggle screencast recording", severity: "os" }
+      },
+      noteForCtrlAlt: "Some Linux setups map right-Alt (AltGr) to 'compose' for typing accented characters, in which case AltGr+letter is reported as ctrl+alt+letter and types a special character. Avoid the ctrl+alt+letter namespace on Linux."
+    }
+  }
+};
+
+// reservations.js
+var SUPPORTED_SCHEMA = "1.0";
+var HARD_SEVERITIES = /* @__PURE__ */ new Set(["hard", "os", "menu-activation"]);
+function detectPlatform(nav = typeof navigator !== "undefined" ? navigator : null) {
+  if (!nav) return null;
+  const platform = nav.platform || "";
+  if (/Mac|iPhone|iPad|iPod/.test(platform)) return "mac";
+  if (/Win/i.test(platform)) return "windows";
+  if (/Linux|X11/i.test(platform)) return "linux";
+  const ua = nav.userAgent || "";
+  if (/Mac OS X/i.test(ua)) return "mac";
+  if (/Windows/i.test(ua)) return "windows";
+  if (/Linux|X11/i.test(ua)) return "linux";
+  return null;
+}
+function detectBrowser(nav = typeof navigator !== "undefined" ? navigator : null) {
+  if (!nav) return null;
+  const ua = nav.userAgent || "";
+  if (/Edg\//.test(ua)) return "edge";
+  if (/Firefox/.test(ua)) return "firefox";
+  if (/Chrome/.test(ua)) return "chrome";
+  if (/Safari/.test(ua)) return "safari";
+  return null;
+}
+function canonicalize(rawKey) {
+  const parts = String(rawKey).toLowerCase().split("+").map((p) => p.trim()).filter(Boolean);
+  if (!parts.length) return "";
+  const base = parts[parts.length - 1];
+  const mods = new Set(parts.slice(0, -1));
+  const out = [];
+  if (mods.has("ctrl")) out.push("ctrl");
+  if (mods.has("meta")) out.push("meta");
+  if (mods.has("alt")) out.push("alt");
+  if (mods.has("shift")) out.push("shift");
+  out.push(base);
+  return out.join("+");
+}
+function resolveRef(value, root) {
+  if (typeof value !== "string" || !value.startsWith("$ref:")) return value;
+  const path = value.slice("$ref:".length).split(".");
+  let node = root;
+  for (const step of path) node = node?.[step];
+  return node;
+}
+function normalizeTable(table) {
+  if (!table || typeof table !== "object") return null;
+  const out = /* @__PURE__ */ Object.create(null);
+  for (const [k, v] of Object.entries(table)) {
+    if (!v || typeof v !== "object" || !("severity" in v)) continue;
+    out[canonicalize(k)] = v;
+  }
+  return out;
+}
+function buildIndex(data) {
+  const idx = { platforms: {} };
+  const platforms = data?.platforms || {};
+  for (const [platform, pdata] of Object.entries(platforms)) {
+    const browsers = {};
+    for (const [name, btable] of Object.entries(pdata.browsers || {})) {
+      browsers[name] = normalizeTable(resolveRef(btable, data));
+    }
+    idx.platforms[platform] = {
+      browsers,
+      system: normalizeTable(pdata.system)
+    };
+  }
+  return idx;
+}
+var SCHEMA_OK = browser_hotkeys_default?.version?.schema === SUPPORTED_SCHEMA;
+var INDEX = SCHEMA_OK ? buildIndex(browser_hotkeys_default) : { platforms: {} };
+function codeToKey(code) {
+  if (!code) return null;
+  const letter = /^Key([A-Za-z])$/.exec(code);
+  if (letter) return letter[1].toLowerCase();
+  const digit = /^Digit(\d)$/.exec(code);
+  if (digit) return digit[1];
+  return code.toLowerCase();
+}
+function lookupKeyFromCombo(combo) {
+  if (!combo) return null;
+  if (combo.bareModifier) return null;
+  const base = combo.code ? codeToKey(combo.code) : combo.key;
+  if (!base) return null;
+  const parts = [];
+  if (combo.ctrl) parts.push("ctrl");
+  if (combo.meta) parts.push("meta");
+  if (combo.alt) parts.push("alt");
+  if (combo.shift) parts.push("shift");
+  parts.push(base);
+  return parts.join("+");
+}
+function lookupReservation(combo, { platform, browser } = {}) {
+  if (!SCHEMA_OK) return null;
+  const lookupKey = lookupKeyFromCombo(combo);
+  if (!lookupKey) return null;
+  const pdata = platform && INDEX.platforms[platform];
+  if (!pdata) return null;
+  const btable = browser ? pdata.browsers?.[browser] : null;
+  const bclaim = btable?.[lookupKey];
+  if (bclaim) {
+    return {
+      source: "browser",
+      platform,
+      browser,
+      lookupKey,
+      action: bclaim.action,
+      severity: bclaim.severity
+    };
+  }
+  const sclaim = pdata.system?.[lookupKey];
+  if (sclaim) {
+    return {
+      source: "system",
+      platform,
+      browser,
+      lookupKey,
+      action: sclaim.action,
+      severity: sclaim.severity
+    };
+  }
+  return null;
+}
+var PLATFORM_LABEL = { mac: "macOS", windows: "Windows", linux: "Linux" };
+function severityIsHard(severity) {
+  return HARD_SEVERITIES.has(severity);
+}
+function formatReservationWarning(reservation, rawHotkey) {
+  const platformLabel = PLATFORM_LABEL[reservation.platform] || reservation.platform;
+  const sourceLabel = reservation.source === "browser" ? `${reservation.browser} on ${platformLabel}` : `${platformLabel}`;
+  const tag = severityIsHard(reservation.severity) ? "will not fire" : "fires in normal browsing";
+  return `[hotkey-router] "${rawHotkey}" (${reservation.lookupKey}) reserved by ${sourceLabel}: "${reservation.action}" [${reservation.severity}] \u2014 ${tag}.`;
+}
+function emitReservationWarning(reservation, rawHotkey, console_ = console) {
+  const msg = formatReservationWarning(reservation, rawHotkey);
+  const fn = severityIsHard(reservation.severity) ? console_.warn : console_.info;
+  fn.call(console_, msg);
+}
+function installReservationWarnings(hotkeys, opts = {}) {
+  if (!hotkeys || typeof hotkeys.onBind !== "function") {
+    throw new TypeError(
+      "installReservationWarnings(hotkeys) requires a hotkey-router instance with onBind() (>= v0.2.0)"
+    );
+  }
+  const platform = opts.platform !== void 0 ? opts.platform : detectPlatform();
+  const browser = opts.browser !== void 0 ? opts.browser : detectBrowser();
+  const console_ = opts.console || console;
+  return hotkeys.onBind(({ combo, raw, options }) => {
+    if (options?.warnOnReserved === false) return;
+    if (!platform || !browser) return;
+    const reservation = lookupReservation(combo, { platform, browser });
+    if (reservation) emitReservationWarning(reservation, raw, console_);
+  });
+}
+var SCHEMA_VERSION = browser_hotkeys_default?.version?.schema;
+var DATA_GENERATED = browser_hotkeys_default?.version?.generated;
+
+// auto.js
+installReservationWarnings(hotkey_router_default);
+var auto_default = hotkey_router_default;
+export {
+  auto_default as default
+};
+//# sourceMappingURL=auto.js.map