hotkey-router 0.0.1

package/dist/hotkey-router.js

@@ -0,0 +1,352 @@
+// hotkey-router v0.0.1 | SEE LICENSE IN LICENSE
+
+function on(target, type, fn, options) {
+  target.addEventListener(type, fn, options);
+  return () => target.removeEventListener(type, fn, options);
+}
+const isMac = typeof navigator !== "undefined" && /Mac|iPhone|iPad|iPod/.test(navigator.platform);
+const modifierTokens = /* @__PURE__ */ new Set(["ctrl", "shift", "alt", "meta"]);
+const ahkPrefixMap = /* @__PURE__ */ new Map([
+  ["^", "ctrl"],
+  // Ctrl
+  ["!", "alt"],
+  // Alt
+  ["+", "shift"],
+  // Shift
+  ["#", "meta"]
+  // Win / Command
+]);
+const 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: "+"
+});
+let ignoreEditable = true;
+let defaultTarget = typeof window !== "undefined" ? window : null;
+const registry = /* @__PURE__ */ new Map();
+const plugins = /* @__PURE__ */ new Map();
+const bindingIndex = /* @__PURE__ */ new Map();
+let paused = false;
+let 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 }) {
+  let s = "";
+  if (ctrl) s += "ctrl+";
+  if (shift) s += "shift+";
+  if (alt) s += "alt+";
+  if (meta) s += "meta+";
+  return s ? s + key : key;
+}
+function comboKeyFromEvent(e) {
+  return comboKeyFromParts({
+    ctrl: e.ctrlKey,
+    shift: e.shiftKey,
+    alt: e.altKey,
+    meta: e.metaKey,
+    key: normalizeKey(e.key)
+  });
+}
+function isModifierToken(token) {
+  const t = normalizeKey(token);
+  return modifierTokens.has(t);
+}
+function parseHotkey(hotkeyStr) {
+  const raw = String(hotkeyStr || "").trim();
+  const lower = raw.toLowerCase();
+  const isUp = lower.endsWith(" up");
+  let cleanStr = (isUp ? raw.slice(0, -3) : raw).trim().toLowerCase();
+  const combo = { ctrl: false, shift: false, alt: false, meta: false, key: null };
+  while (cleanStr.length) {
+    const mod = ahkPrefixMap.get(cleanStr[0]) ?? null;
+    if (!mod) break;
+    combo[mod] = true;
+    cleanStr = cleanStr.slice(1).trimStart();
+  }
+  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) {
+    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 && impliedPlusKey) combo.key = "+";
+  if (!combo.key) 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 });
+  const off = () => removeById(binding.id);
+  off.id = binding.id;
+  off.hotkey = raw;
+  return off;
+}
+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 bindings = registry.get(comboStr)?.get(type);
+    if (!bindings?.length) return;
+    const candidates = [];
+    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);
+  };
+}
+let stopDown = null;
+let 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();
+}
+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 e = {
+    type: actualType,
+    key: combo.key,
+    ctrlKey: !!combo.ctrl,
+    shiftKey: !!combo.shift,
+    altKey: !!combo.alt,
+    metaKey: !!combo.meta,
+    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,
+  // control
+  pause,
+  resume,
+  ignoreInput,
+  // testing / automation
+  trigger
+};
+export {
+  hotkey_router_default as default
+};
+//# sourceMappingURL=hotkey-router.js.map

package/dist/hotkey-router.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../hotkey-router.js"],
+  "sourcesContent": ["// hotkey-router.js\r\n// Hotkey Router \u2014 plugin-first keyboard shortcut router (tiny + predictable)\r\n//\r\n// Goals:\r\n// - O(1) dispatch by combo string lookup\r\n// - Deterministic routing: highest priority wins; ties -> most recently bound wins\r\n// - Safe plugin cleanup (never deletes other plugins\u2019 bindings)\r\n// - Modern browser target (KeyboardEvent.key + addEventListener)\r\n\r\n// --- tiny event helper ---\r\nfunction on(target, type, fn, options) {\r\n  target.addEventListener(type, fn, options)\r\n  return () => target.removeEventListener(type, fn, options)\r\n}\r\n\r\n// --- key alias map ---\r\nconst isMac =\r\n  typeof navigator !== 'undefined' && /Mac|iPhone|iPad|iPod/.test(navigator.platform)\r\n\r\n\r\nconst modifierTokens = new Set(['ctrl', 'shift', 'alt', 'meta'])\r\n\r\nconst ahkPrefixMap = new Map([\r\n  ['^', 'ctrl'],  // Ctrl\r\n  ['!', 'alt'],   // Alt\r\n  ['+', 'shift'], // Shift\r\n  ['#', 'meta'],  // Win / Command\r\n])\r\n\r\n\r\nconst keyAliases = Object.freeze({\r\n  // common\r\n  esc: 'escape',\r\n  escape: 'escape',\r\n  space: ' ',\r\n  spacebar: ' ',\r\n  enter: 'enter',\r\n  return: 'enter',\r\n  del: 'delete',\r\n  delete: 'delete',\r\n  backspace: 'backspace',\r\n  tab: 'tab',\r\n\r\n  // arrows\r\n  up: 'arrowup',\r\n  down: 'arrowdown',\r\n  left: 'arrowleft',\r\n  right: 'arrowright',\r\n\r\n  // navigation\r\n  home: 'home',\r\n  end: 'end',\r\n  pageup: 'pageup',\r\n  pagedown: 'pagedown',\r\n  pgup: 'pageup',\r\n  pgdn: 'pagedown',\r\n\r\n  // modifiers (words)\r\n  cmd: 'meta',\r\n  command: 'meta',\r\n  win: 'meta',\r\n  meta: 'meta',\r\n  control: 'ctrl',\r\n  ctrl: 'ctrl',\r\n  option: 'alt',\r\n  alt: 'alt',\r\n  shift: 'shift',\r\n\r\n  // modifiers (symbols)\r\n  '\u2318': 'meta',\r\n  '\u2303': 'ctrl',\r\n  '\u2325': 'alt',\r\n  '\u21E7': 'shift',\r\n\r\n  // cross-platform \"mod\"\r\n  mod: isMac ? 'meta' : 'ctrl',\r\n\r\n  // plus key ergonomics\r\n  plus: '+',\r\n})\r\n\r\n// --- config ---\r\nlet ignoreEditable = true\r\nlet defaultTarget = typeof window !== 'undefined' ? window : null\r\n\r\n// --- state ---\r\n// comboStr -> Map<type, Array<Binding>>\r\nconst registry = new Map()\r\n// pluginName -> Array<bindingId>\r\nconst plugins = new Map()\r\n// bindingId -> { comboStr, type }\r\nconst bindingIndex = new Map()\r\n\r\nlet paused = false\r\nlet nextId = 1\r\n\r\n// --- helpers ---\r\nfunction normalizeKey(key) {\r\n  const raw = String(key ?? '').trim()\r\n  const k = raw.toLowerCase()\r\n  return keyAliases[k] ?? (raw === ' ' ? ' ' : k)\r\n}\r\n\r\nfunction comboKeyFromParts({ ctrl, shift, alt, meta, key }) {\r\n  let s = ''\r\n  if (ctrl) s += 'ctrl+'\r\n  if (shift) s += 'shift+'\r\n  if (alt) s += 'alt+'\r\n  if (meta) s += 'meta+'\r\n  return s ? s + key : key\r\n}\r\n\r\nfunction comboKeyFromEvent(e) {\r\n  return comboKeyFromParts({\r\n    ctrl: e.ctrlKey,\r\n    shift: e.shiftKey,\r\n    alt: e.altKey,\r\n    meta: e.metaKey,\r\n    key: normalizeKey(e.key),\r\n  })\r\n}\r\n\r\n\r\nfunction isModifierToken(token) {\r\n  const t = normalizeKey(token)\r\n  return modifierTokens.has(t)\r\n}\r\n\r\n\r\nfunction parseHotkey(hotkeyStr) {\r\n  const raw = String(hotkeyStr || '').trim()\r\n  const lower = raw.toLowerCase()\r\n\r\n  const isUp = lower.endsWith(' up')\r\n  let cleanStr = (isUp ? raw.slice(0, -3) : raw).trim().toLowerCase()\r\n\r\n  // --- AHK-style prefix modifiers ---\r\n  // Examples:\r\n  //  ^k   => ctrl+k\r\n  //  !k   => alt+k\r\n  //  +k   => shift+k\r\n  //  #k   => meta+k\r\n  //  ^!k  => ctrl+alt+k\r\n  //\r\n  // This runs BEFORE normal \"+\" token parsing so it composes cleanly.\r\n  const combo = { ctrl: false, shift: false, alt: false, meta: false, key: null }\r\n\r\n  while (cleanStr.length) {\r\n    const mod = ahkPrefixMap.get(cleanStr[0]) ?? null\r\n    if (!mod) break\r\n    combo[mod] = true\r\n    cleanStr = cleanStr.slice(1).trimStart()\r\n  }\r\n\r\n  // Allow plus key:\r\n  //  - \"ctrl++\" => ctrl + \"+\"\r\n  //  - \"++\"     => shift + \"+\" (AHK '+' prefix sets shift, remaining '+' becomes the base key)\r\n  // `split('+')` produces empties; we keep that signal.\r\n  const rawParts = cleanStr.split('+').map((p) => p.trim())\r\n  const parts = rawParts.filter(Boolean)\r\n  const impliedPlusKey = rawParts.some((p) => p === '') && cleanStr.includes('++')\r\n\r\n  // Enforce: modifiers must come before the base key.\r\n  // Example: \"ctrl+k\" \u2705  |  \"k+ctrl\" \u274C\r\n  // We ignore the special \"+ key\" case (ctrl++) since it has no explicit base token.\r\n  if (!impliedPlusKey) {\r\n    let seenBase = false\r\n    for (const part of parts) {\r\n      if (isModifierToken(part)) {\r\n        if (seenBase) {\r\n          throw new Error(\r\n            `Invalid hotkey \"${hotkeyStr}\": modifiers must come before the base key (e.g. \"ctrl+k\", not \"k+ctrl\")`\r\n          )\r\n        }\r\n      } else {\r\n        if (!seenBase) seenBase = true\r\n      }\r\n    }\r\n  }\r\n\r\n  // Continue parsing the remaining tokens (words/symbols/aliases)\r\n  for (const part of parts) {\r\n    const actual = keyAliases[part] ?? part\r\n    if (actual === 'ctrl') combo.ctrl = true\r\n    else if (actual === 'shift') combo.shift = true\r\n    else if (actual === 'alt') combo.alt = true\r\n    else if (actual === 'meta') combo.meta = true\r\n    else combo.key = normalizeKey(actual)\r\n  }\r\n\r\n  if (!combo.key && impliedPlusKey) combo.key = '+'\r\n  if (!combo.key) throw new Error(`Invalid hotkey \"${hotkeyStr}\" (missing base key)`)\r\n\r\n  return { combo, type: isUp ? 'keyup' : 'keydown', raw: hotkeyStr }\r\n}\r\n\r\n\r\nfunction isFromInputTarget(e) {\r\n  const t = e?.target\r\n  if (!t) return false\r\n  const tag = String(t.tagName || '').toUpperCase()\r\n  return (\r\n    t.isContentEditable ||\r\n    tag === 'INPUT' ||\r\n    tag === 'TEXTAREA' ||\r\n    tag === 'SELECT' ||\r\n    t.getAttribute?.('role') === 'textbox'\r\n  )\r\n}\r\n\r\n\r\n// --- binding model ---\r\n// options:\r\n//  preventDefault, stopPropagation, stopImmediatePropagation\r\n//  repeat (default false on keydown), once\r\n//  when(e) -> boolean (gate)\r\n//  allowIn(e) -> boolean (override ignoreInput)\r\n//  priority (higher wins)\r\nfunction normalizeOptions(type, options) {\r\n  const o = options ? { ...options } : {}\r\n  if (type === 'keydown' && o.repeat == null) o.repeat = false\r\n  if (o.priority == null) o.priority = 0\r\n  return o\r\n}\r\n\r\n\r\nfunction ensureSlot(comboStr, type) {\r\n  let typeMap = registry.get(comboStr)\r\n  if (!typeMap) {\r\n    typeMap = new Map()\r\n    registry.set(comboStr, typeMap)\r\n  }\r\n  let arr = typeMap.get(type)\r\n  if (!arr) {\r\n    arr = []\r\n    typeMap.set(type, arr)\r\n  }\r\n  return arr\r\n}\r\n\r\n\r\nfunction removeById(id) {\r\n  const idx = bindingIndex.get(id)\r\n  if (!idx) return false\r\n\r\n  const { comboStr, type } = idx\r\n  const typeMap = registry.get(comboStr)\r\n  const arr = typeMap?.get(type)\r\n  if (!arr?.length) {\r\n    bindingIndex.delete(id)\r\n    return false\r\n  }\r\n\r\n  const next = arr.filter((b) => b.id !== id)\r\n  if (next.length) typeMap.set(type, next)\r\n  else typeMap.delete(type)\r\n\r\n  if (!typeMap.size) registry.delete(comboStr)\r\n  bindingIndex.delete(id)\r\n  return true\r\n}\r\n\r\n\r\n// --- public API: bind / unbind ---\r\n// bind returns an off() function; off.id is exposed for plugin bookkeeping.\r\nfunction bind(hotkeyStr, handler, plugin = null, options = {}) {\r\n  const { combo, type, raw } = parseHotkey(hotkeyStr)\r\n  const comboStr = comboKeyFromParts(combo)\r\n  const opts = normalizeOptions(type, options)\r\n\r\n  const binding = {\r\n    id: nextId++,\r\n    comboStr,\r\n    type,\r\n    combo,\r\n    handler,\r\n    plugin,\r\n    raw,\r\n    options: opts,\r\n  }\r\n\r\n  ensureSlot(comboStr, type).push(binding)\r\n  bindingIndex.set(binding.id, { comboStr, type })\r\n\r\n  const off = () => removeById(binding.id)\r\n  off.id = binding.id\r\n  off.hotkey = raw\r\n  return off\r\n}\r\n\r\n\r\n// unbind('ctrl+k') -> remove all for that combo/type\r\n// unbind('ctrl+k', fn) -> remove only that handler\r\nfunction unbind(hotkeyStr, handler) {\r\n  const { combo, type } = parseHotkey(hotkeyStr)\r\n  const comboStr = comboKeyFromParts(combo)\r\n  const typeMap = registry.get(comboStr)\r\n  if (!typeMap) return\r\n\r\n  const arr = typeMap.get(type)\r\n  if (!arr?.length) return\r\n\r\n  if (!handler) {\r\n    for (const b of arr) bindingIndex.delete(b.id)\r\n    typeMap.delete(type)\r\n  } else {\r\n    const keep = []\r\n    for (const b of arr) {\r\n      if (b.handler === handler) bindingIndex.delete(b.id)\r\n      else keep.push(b)\r\n    }\r\n    if (keep.length) typeMap.set(type, keep)\r\n    else typeMap.delete(type)\r\n  }\r\n\r\n  if (!typeMap.size) registry.delete(comboStr)\r\n}\r\n\r\n\r\n// --- plugin system ---\r\n// registerPlugin returns unregister function.\r\nfunction registerPlugin(name, hotkeyMap) {\r\n  if (plugins.has(name)) throw new Error(`Plugin \"${name}\" already registered`)\r\n  const ids = []\r\n\r\n  for (const [hotkeyStr, fnOrTuple] of Object.entries(hotkeyMap)) {\r\n    const [fn, options] = Array.isArray(fnOrTuple) ? fnOrTuple : [fnOrTuple, {}]\r\n    const off = bind(hotkeyStr, fn, name, options)\r\n    ids.push(off.id)\r\n  }\r\n\r\n  plugins.set(name, ids)\r\n  return () => unregisterPlugin(name)\r\n}\r\n\r\nfunction unregisterPlugin(name) {\r\n  const ids = plugins.get(name)\r\n  if (!ids) return\r\n  for (const id of ids) removeById(id)\r\n  plugins.delete(name)\r\n}\r\n\r\n// --- control ---\r\nfunction pause() {\r\n  paused = true\r\n}\r\n\r\nfunction resume() {\r\n  paused = false\r\n}\r\n\r\nfunction ignoreInput(value = true) {\r\n  ignoreEditable = !!value\r\n}\r\n\r\n// allow changing the default target (iframes/tests).\r\n// we intentionally do not auto-rebind to keep the core tiny.\r\nfunction setTarget(target) {\r\n  defaultTarget = target\r\n}\r\n\r\n\r\n// --- dispatch (O(1) lookup) ---\r\nfunction pickWinner(bindings) {\r\n  // Highest priority wins; ties -> newest wins (largest id).\r\n  let best = null\r\n  for (const b of bindings) {\r\n    if (!best) best = b\r\n    else if (b.options.priority > best.options.priority) best = b\r\n    else if (b.options.priority === best.options.priority && b.id > best.id) best = b\r\n  }\r\n  return best\r\n}\r\n\r\n\r\nfunction handleEvent(type) {\r\n  return (e) => {\r\n    if (paused) return\r\n\r\n    const fromInput = ignoreEditable && isFromInputTarget(e)\r\n    const comboStr = comboKeyFromEvent(e)\r\n\r\n    const bindings = registry.get(comboStr)?.get(type)\r\n    if (!bindings?.length) return\r\n\r\n    const candidates = []\r\n    for (const b of bindings) {\r\n      const o = b.options\r\n      if (fromInput && !o.allowIn?.(e)) continue\r\n      if (type === 'keydown' && o.repeat === false && e.repeat) continue\r\n      if (o.when && o.when(e) === false) continue\r\n      candidates.push(b)\r\n    }\r\n    if (!candidates.length) return\r\n\r\n    const winner = pickWinner(candidates)\r\n    const o = winner.options\r\n\r\n    if (o.preventDefault) e.preventDefault()\r\n    if (o.stopImmediatePropagation) e.stopImmediatePropagation()\r\n    else if (o.stopPropagation) e.stopPropagation()\r\n\r\n    winner.handler(e)\r\n\r\n    if (o.once) removeById(winner.id)\r\n  }\r\n}\r\n\r\n\r\n// --- listeners ---\r\nlet stopDown = null\r\nlet stopUp = null\r\n\r\nfunction init({ target = defaultTarget, capture = false } = {}) {\r\n  if (!target) throw new Error('hotkeys.init() requires a target (e.g. window)')\r\n  if (stopDown || stopUp) destroy()\r\n\r\n  stopDown = on(target, 'keydown', handleEvent('keydown'), { capture })\r\n  stopUp = on(target, 'keyup', handleEvent('keyup'), { capture })\r\n}\r\n\r\n\r\nfunction destroy() {\r\n  stopDown?.()\r\n  stopUp?.()\r\n  stopDown = null\r\n  stopUp = null\r\n  registry.clear()\r\n  plugins.clear()\r\n  bindingIndex.clear()\r\n}\r\n\r\n\r\n// --- programmatic trigger (tests / automation) ---\r\nfunction trigger(hotkeyStr, { type: forcedType } = {}) {\r\n  const { combo, type } = parseHotkey(hotkeyStr)\r\n  const comboStr = comboKeyFromParts(combo)\r\n  const actualType = forcedType || type\r\n\r\n  const bindings = registry.get(comboStr)?.get(actualType)\r\n  if (!bindings?.length) return false\r\n\r\n  const e = {\r\n    type: actualType,\r\n    key: combo.key,\r\n    ctrlKey: !!combo.ctrl,\r\n    shiftKey: !!combo.shift,\r\n    altKey: !!combo.alt,\r\n    metaKey: !!combo.meta,\r\n    repeat: false,\r\n    preventDefault() { },\r\n    stopPropagation() { },\r\n    stopImmediatePropagation() { },\r\n    target: null,\r\n  }\r\n\r\n  const winner = pickWinner(\r\n    bindings.filter((b) => (b.options.when ? b.options.when(e) !== false : true))\r\n  )\r\n  if (!winner) return false\r\n\r\n  winner.handler(e)\r\n  if (winner.options.once) removeById(winner.id)\r\n  return true\r\n}\r\n\r\n\r\n// Auto-init on window by default (browser only)\r\nif (defaultTarget) init()\r\n\r\nexport default {\r\n  // lifecycle\r\n  init,\r\n  destroy,\r\n  setTarget,\r\n\r\n  // bindings\r\n  bind,\r\n  unbind,\r\n  registerPlugin,\r\n  unregisterPlugin,\r\n\r\n  // control\r\n  pause,\r\n  resume,\r\n  ignoreInput,\r\n\r\n  // testing / automation\r\n  trigger,\r\n}"],
+  "mappings": "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",
+  "names": ["o"]
+}

package/dist/hotkey-router.min.js

@@ -0,0 +1,3 @@
+// hotkey-router v0.0.1 | SEE LICENSE IN LICENSE
+
+function E(t,e,n,r){return t.addEventListener(e,n,r),()=>t.removeEventListener(e,n,r)}const C=typeof navigator<"u"&&/Mac|iPhone|iPad|iPod/.test(navigator.platform),L=new Set(["ctrl","shift","alt","meta"]),z=new Map([["^","ctrl"],["!","alt"],["+","shift"],["#","meta"]]),v=Object.freeze({esc:"escape",escape:"escape",space:" ",spacebar:" ",enter:"enter",return:"enter",del:"delete",delete:"delete",backspace:"backspace",tab:"tab",up:"arrowup",down:"arrowdown",left:"arrowleft",right:"arrowright",home:"home",end:"end",pageup:"pageup",pagedown:"pagedown",pgup:"pageup",pgdn:"pagedown",cmd:"meta",command:"meta",win:"meta",meta:"meta",control:"ctrl",ctrl:"ctrl",option:"alt",alt:"alt",shift:"shift","\u2318":"meta","\u2303":"ctrl","\u2325":"alt","\u21E7":"shift",mod:C?"meta":"ctrl",plus:"+"});let I=!0,h=typeof window<"u"?window:null;const u=new Map,d=new Map,p=new Map;let b=!1,D=1;function k(t){const e=String(t??"").trim(),n=e.toLowerCase();return v[n]??(e===" "?" ":n)}function g({ctrl:t,shift:e,alt:n,meta:r,key:i}){let o="";return t&&(o+="ctrl+"),e&&(o+="shift+"),n&&(o+="alt+"),r&&(o+="meta+"),o?o+i:i}function O(t){return g({ctrl:t.ctrlKey,shift:t.shiftKey,alt:t.altKey,meta:t.metaKey,key:k(t.key)})}function U(t){const e=k(t);return L.has(e)}function P(t){const e=String(t||"").trim(),r=e.toLowerCase().endsWith(" up");let i=(r?e.slice(0,-3):e).trim().toLowerCase();const o={ctrl:!1,shift:!1,alt:!1,meta:!1,key:null};for(;i.length;){const s=z.get(i[0])??null;if(!s)break;o[s]=!0,i=i.slice(1).trimStart()}const l=i.split("+").map(s=>s.trim()),a=l.filter(Boolean),f=l.some(s=>s==="")&&i.includes("++");if(!f){let s=!1;for(const c of a)if(U(c)){if(s)throw new Error(`Invalid hotkey "${t}": modifiers must come before the base key (e.g. "ctrl+k", not "k+ctrl")`)}else s||(s=!0)}for(const s of a){const c=v[s]??s;c==="ctrl"?o.ctrl=!0:c==="shift"?o.shift=!0:c==="alt"?o.alt=!0:c==="meta"?o.meta=!0:o.key=k(c)}if(!o.key&&f&&(o.key="+"),!o.key)throw new Error(`Invalid hotkey "${t}" (missing base key)`);return{combo:o,type:r?"keyup":"keydown",raw:t}}function B(t){const e=t?.target;if(!e)return!1;const n=String(e.tagName||"").toUpperCase();return e.isContentEditable||n==="INPUT"||n==="TEXTAREA"||n==="SELECT"||e.getAttribute?.("role")==="textbox"}function F(t,e){const n=e?{...e}:{};return t==="keydown"&&n.repeat==null&&(n.repeat=!1),n.priority==null&&(n.priority=0),n}function $(t,e){let n=u.get(t);n||(n=new Map,u.set(t,n));let r=n.get(e);return r||(r=[],n.set(e,r)),r}function m(t){const e=p.get(t);if(!e)return!1;const{comboStr:n,type:r}=e,i=u.get(n),o=i?.get(r);if(!o?.length)return p.delete(t),!1;const l=o.filter(a=>a.id!==t);return l.length?i.set(r,l):i.delete(r),i.size||u.delete(n),p.delete(t),!0}function K(t,e,n=null,r={}){const{combo:i,type:o,raw:l}=P(t),a=g(i),f=F(o,r),s={id:D++,comboStr:a,type:o,combo:i,handler:e,plugin:n,raw:l,options:f};$(a,o).push(s),p.set(s.id,{comboStr:a,type:o});const c=()=>m(s.id);return c.id=s.id,c.hotkey=l,c}function j(t,e){const{combo:n,type:r}=P(t),i=g(n),o=u.get(i);if(!o)return;const l=o.get(r);if(l?.length){if(e){const a=[];for(const f of l)f.handler===e?p.delete(f.id):a.push(f);a.length?o.set(r,a):o.delete(r)}else{for(const a of l)p.delete(a.id);o.delete(r)}o.size||u.delete(i)}}function N(t,e){if(d.has(t))throw new Error(`Plugin "${t}" already registered`);const n=[];for(const[r,i]of Object.entries(e)){const[o,l]=Array.isArray(i)?i:[i,{}],a=K(r,o,t,l);n.push(a.id)}return d.set(t,n),()=>M(t)}function M(t){const e=d.get(t);if(e){for(const n of e)m(n);d.delete(t)}}function W(){b=!0}function q(){b=!1}function H(t=!0){I=!!t}function R(t){h=t}function T(t){let e=null;for(const n of t)e?(n.options.priority>e.options.priority||n.options.priority===e.options.priority&&n.id>e.id)&&(e=n):e=n;return e}function S(t){return e=>{if(b)return;const n=I&&B(e),r=O(e),i=u.get(r)?.get(t);if(!i?.length)return;const o=[];for(const f of i){const s=f.options;n&&!s.allowIn?.(e)||t==="keydown"&&s.repeat===!1&&e.repeat||s.when&&s.when(e)===!1||o.push(f)}if(!o.length)return;const l=T(o),a=l.options;a.preventDefault&&e.preventDefault(),a.stopImmediatePropagation?e.stopImmediatePropagation():a.stopPropagation&&e.stopPropagation(),l.handler(e),a.once&&m(l.id)}}let y=null,w=null;function x({target:t=h,capture:e=!1}={}){if(!t)throw new Error("hotkeys.init() requires a target (e.g. window)");(y||w)&&A(),y=E(t,"keydown",S("keydown"),{capture:e}),w=E(t,"keyup",S("keyup"),{capture:e})}function A(){y?.(),w?.(),y=null,w=null,u.clear(),d.clear(),p.clear()}function X(t,{type:e}={}){const{combo:n,type:r}=P(t),i=g(n),o=e||r,l=u.get(i)?.get(o);if(!l?.length)return!1;const a={type:o,key:n.key,ctrlKey:!!n.ctrl,shiftKey:!!n.shift,altKey:!!n.alt,metaKey:!!n.meta,repeat:!1,preventDefault(){},stopPropagation(){},stopImmediatePropagation(){},target:null},f=T(l.filter(s=>s.options.when?s.options.when(a)!==!1:!0));return f?(f.handler(a),f.options.once&&m(f.id),!0):!1}h&&x();var G={init:x,destroy:A,setTarget:R,bind:K,unbind:j,registerPlugin:N,unregisterPlugin:M,pause:W,resume:q,ignoreInput:H,trigger:X};export{G as default};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "hotkey-router",
+  "version": "0.0.1",
+  "description": "A tiny, deterministic keyboard routing engine for modern web apps.",
+  "type": "module",
+  "author": "DR.WATT",
+  "license": "SEE LICENSE IN LICENSE",
+  "keywords": [
+    "hotkeys",
+    "keyboard",
+    "shortcuts",
+    "router",
+    "javascript"
+  ],
+
+  "main": "./dist/hotkey-router.cjs",
+  "module": "./dist/hotkey-router.js",
+
+  "exports": {
+    ".": {
+      "import": "./dist/hotkey-router.js",
+      "require": "./dist/hotkey-router.cjs"
+    }
+  },
+
+  "sideEffects": false,
+
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+
+  "scripts": {
+    "build": "node build.js",
+    "prepublishOnly": "npm run build",
+    "test": "vitest run --environment jsdom",
+    "test:watch": "vitest --environment jsdom"
+  },
+
+  "devDependencies": {
+    "esbuild": "^0.21.0",
+    "jsdom": "^24.0.0",
+    "vitest": "^3.1.2"
+  },
+
+  "engines": {
+    "node": ">=18"
+  }
+}