@pyreon/hotkeys 0.10.0 → 0.11.0

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/parse.ts","../src/registry.ts","../src/use-hotkey.ts","../src/use-hotkey-scope.ts"],"sourcesContent":["import type { KeyCombo } from './types'\n\n// ─── Key aliases ─────────────────────────────────────────────────────────────\n\nconst KEY_ALIASES: Record<string, string> = {\n  esc: 'escape',\n  return: 'enter',\n  del: 'delete',\n  ins: 'insert',\n  space: ' ',\n  spacebar: ' ',\n  up: 'arrowup',\n  down: 'arrowdown',\n  left: 'arrowleft',\n  right: 'arrowright',\n  plus: '+',\n}\n\n/**\n * Parse a shortcut string like 'ctrl+shift+s' into a KeyCombo.\n * Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).\n */\nexport function parseShortcut(shortcut: string): KeyCombo {\n  const parts = shortcut.toLowerCase().trim().split('+')\n  const combo: KeyCombo = {\n    ctrl: false,\n    shift: false,\n    alt: false,\n    meta: false,\n    key: '',\n  }\n\n  for (const part of parts) {\n    const p = part.trim()\n    if (p === 'ctrl' || p === 'control') {\n      combo.ctrl = true\n    } else if (p === 'shift') {\n      combo.shift = true\n    } else if (p === 'alt') {\n      combo.alt = true\n    } else if (p === 'meta' || p === 'cmd' || p === 'command') {\n      combo.meta = true\n    } else if (p === 'mod') {\n      // mod = meta on Mac, ctrl elsewhere\n      if (isMac()) {\n        combo.meta = true\n      } else {\n        combo.ctrl = true\n      }\n    } else {\n      combo.key = KEY_ALIASES[p] ?? p\n    }\n  }\n\n  return combo\n}\n\n/**\n * Check if a KeyboardEvent matches a KeyCombo.\n */\nexport function matchesCombo(event: KeyboardEvent, combo: KeyCombo): boolean {\n  if (event.ctrlKey !== combo.ctrl) return false\n  if (event.shiftKey !== combo.shift) return false\n  if (event.altKey !== combo.alt) return false\n  if (event.metaKey !== combo.meta) return false\n\n  const eventKey = event.key.toLowerCase()\n  return eventKey === combo.key\n}\n\n/**\n * Format a KeyCombo back to a human-readable string.\n */\nexport function formatCombo(combo: KeyCombo): string {\n  const parts: string[] = []\n  if (combo.ctrl) parts.push('Ctrl')\n  if (combo.shift) parts.push('Shift')\n  if (combo.alt) parts.push('Alt')\n  if (combo.meta) parts.push(isMac() ? '⌘' : 'Meta')\n  parts.push(\n    combo.key.length === 1 ? combo.key.toUpperCase() : capitalize(combo.key),\n  )\n  return parts.join('+')\n}\n\nfunction capitalize(s: string): string {\n  return s.charAt(0).toUpperCase() + s.slice(1)\n}\n\nfunction isMac(): boolean {\n  if (typeof navigator === 'undefined') return false\n  return /mac|iphone|ipad|ipod/i.test(navigator.userAgent)\n}\n","import type { Signal } from '@pyreon/reactivity'\nimport { signal } from '@pyreon/reactivity'\nimport { matchesCombo, parseShortcut } from './parse'\nimport type { HotkeyEntry, HotkeyOptions } from './types'\n\n// ─── State ───────────────────────────────────────────────────────────────────\n\nconst entries: HotkeyEntry[] = []\nconst activeScopes = signal<Set<string>>(new Set(['global']))\nlet listenerAttached = false\n\n// ─── Input detection ─────────────────────────────────────────────────────────\n\nconst INPUT_TAGS = new Set(['INPUT', 'TEXTAREA', 'SELECT'])\n\nfunction isInputFocused(event: KeyboardEvent): boolean {\n  const target = event.target as HTMLElement | null\n  if (!target) return false\n  if (INPUT_TAGS.has(target.tagName)) return true\n  if (target.isContentEditable) return true\n  return false\n}\n\n// ─── Global listener ─────────────────────────────────────────────────────────\n\nfunction attachListener(): void {\n  if (listenerAttached) return\n  if (typeof window === 'undefined') return\n  listenerAttached = true\n\n  window.addEventListener('keydown', (event) => {\n    const scopes = activeScopes.peek()\n\n    for (const entry of entries) {\n      // Check scope\n      if (!scopes.has(entry.options.scope)) continue\n\n      // Check enabled\n      const enabled =\n        typeof entry.options.enabled === 'function'\n          ? entry.options.enabled()\n          : entry.options.enabled\n      if (!enabled) continue\n\n      // Check input focus\n      if (!entry.options.enableOnInputs && isInputFocused(event)) continue\n\n      // Check key match\n      if (!matchesCombo(event, entry.combo)) continue\n\n      // Match found\n      if (entry.options.preventDefault) event.preventDefault()\n      if (entry.options.stopPropagation) event.stopPropagation()\n      entry.handler(event)\n    }\n  })\n}\n\n// ─── Registration ────────────────────────────────────────────────────────────\n\n/**\n * Register a keyboard shortcut. Returns an unregister function.\n *\n * @example\n * ```ts\n * const unregister = registerHotkey('ctrl+s', (e) => save(), { description: 'Save' })\n * // later: unregister()\n * ```\n */\nexport function registerHotkey(\n  shortcut: string,\n  handler: (event: KeyboardEvent) => void,\n  options?: HotkeyOptions,\n): () => void {\n  attachListener()\n\n  const entry: HotkeyEntry = {\n    shortcut,\n    combo: parseShortcut(shortcut),\n    handler,\n    options: {\n      scope: options?.scope ?? 'global',\n      preventDefault: options?.preventDefault !== false,\n      stopPropagation: options?.stopPropagation === true,\n      enableOnInputs: options?.enableOnInputs === true,\n      enabled: options?.enabled ?? true,\n      ...(options?.description != null\n        ? { description: options.description }\n        : {}),\n    },\n  }\n\n  entries.push(entry)\n\n  return () => {\n    const idx = entries.indexOf(entry)\n    if (idx !== -1) entries.splice(idx, 1)\n  }\n}\n\n// ─── Scope management ────────────────────────────────────────────────────────\n\n/**\n * Activate a hotkey scope. 'global' is always active.\n */\nexport function enableScope(scope: string): void {\n  const current = activeScopes.peek()\n  if (current.has(scope)) return\n  const next = new Set(current)\n  next.add(scope)\n  activeScopes.set(next)\n}\n\n/**\n * Deactivate a hotkey scope. Cannot deactivate 'global'.\n */\nexport function disableScope(scope: string): void {\n  if (scope === 'global') return\n  const current = activeScopes.peek()\n  if (!current.has(scope)) return\n  const next = new Set(current)\n  next.delete(scope)\n  activeScopes.set(next)\n}\n\n/**\n * Get the currently active scopes as a reactive signal.\n */\nexport function getActiveScopes(): Signal<Set<string>> {\n  return activeScopes\n}\n\n/**\n * Get all registered hotkeys (for building help dialogs).\n */\nexport function getRegisteredHotkeys(): ReadonlyArray<{\n  shortcut: string\n  scope: string\n  description?: string\n}> {\n  return entries.map((e) => ({\n    shortcut: e.shortcut,\n    scope: e.options.scope,\n    ...(e.options.description != null\n      ? { description: e.options.description }\n      : {}),\n  }))\n}\n\n// ─── Reset (for testing) ────────────────────────────────────────────────────\n\nexport function _resetHotkeys(): void {\n  entries.length = 0\n  activeScopes.set(new Set(['global']))\n}\n","import { onUnmount } from '@pyreon/core'\nimport { registerHotkey } from './registry'\nimport type { HotkeyOptions } from './types'\n\n/**\n * Register a keyboard shortcut scoped to a component's lifecycle.\n * Automatically unregisters when the component unmounts.\n *\n * @example\n * ```ts\n * function Editor() {\n *   useHotkey('ctrl+s', () => save(), { description: 'Save document' })\n *   useHotkey('ctrl+z', () => undo())\n *   useHotkey('ctrl+shift+z', () => redo())\n *   // ...\n * }\n * ```\n */\nexport function useHotkey(\n  shortcut: string,\n  handler: (event: KeyboardEvent) => void,\n  options?: HotkeyOptions,\n): void {\n  const unregister = registerHotkey(shortcut, handler, options)\n  onUnmount(unregister)\n}\n","import { onUnmount } from '@pyreon/core'\nimport { disableScope, enableScope } from './registry'\n\n/**\n * Activate a hotkey scope for the lifetime of a component.\n * When the component unmounts, the scope is deactivated.\n *\n * @example\n * ```tsx\n * function Modal() {\n *   useHotkeyScope('modal')\n *   useHotkey('escape', () => closeModal(), { scope: 'modal' })\n *   // ...\n * }\n * ```\n */\nexport function useHotkeyScope(scope: string): void {\n  enableScope(scope)\n  onUnmount(() => disableScope(scope))\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/parse.ts","../src/registry.ts","../src/use-hotkey.ts","../src/use-hotkey-scope.ts"],"sourcesContent":["import type { KeyCombo } from \"./types\"\n\n// ─── Key aliases ─────────────────────────────────────────────────────────────\n\nconst KEY_ALIASES: Record<string, string> = {\n  esc: \"escape\",\n  return: \"enter\",\n  del: \"delete\",\n  ins: \"insert\",\n  space: \" \",\n  spacebar: \" \",\n  up: \"arrowup\",\n  down: \"arrowdown\",\n  left: \"arrowleft\",\n  right: \"arrowright\",\n  plus: \"+\",\n}\n\n/**\n * Parse a shortcut string like 'ctrl+shift+s' into a KeyCombo.\n * Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).\n */\nexport function parseShortcut(shortcut: string): KeyCombo {\n  const parts = shortcut.toLowerCase().trim().split(\"+\")\n  const combo: KeyCombo = {\n    ctrl: false,\n    shift: false,\n    alt: false,\n    meta: false,\n    key: \"\",\n  }\n\n  for (const part of parts) {\n    const p = part.trim()\n    if (p === \"ctrl\" || p === \"control\") {\n      combo.ctrl = true\n    } else if (p === \"shift\") {\n      combo.shift = true\n    } else if (p === \"alt\") {\n      combo.alt = true\n    } else if (p === \"meta\" || p === \"cmd\" || p === \"command\") {\n      combo.meta = true\n    } else if (p === \"mod\") {\n      // mod = meta on Mac, ctrl elsewhere\n      if (isMac()) {\n        combo.meta = true\n      } else {\n        combo.ctrl = true\n      }\n    } else {\n      combo.key = KEY_ALIASES[p] ?? p\n    }\n  }\n\n  return combo\n}\n\n/**\n * Check if a KeyboardEvent matches a KeyCombo.\n */\nexport function matchesCombo(event: KeyboardEvent, combo: KeyCombo): boolean {\n  if (event.ctrlKey !== combo.ctrl) return false\n  if (event.shiftKey !== combo.shift) return false\n  if (event.altKey !== combo.alt) return false\n  if (event.metaKey !== combo.meta) return false\n\n  const eventKey = event.key.toLowerCase()\n  return eventKey === combo.key\n}\n\n/**\n * Format a KeyCombo back to a human-readable string.\n */\nexport function formatCombo(combo: KeyCombo): string {\n  const parts: string[] = []\n  if (combo.ctrl) parts.push(\"Ctrl\")\n  if (combo.shift) parts.push(\"Shift\")\n  if (combo.alt) parts.push(\"Alt\")\n  if (combo.meta) parts.push(isMac() ? \"⌘\" : \"Meta\")\n  parts.push(combo.key.length === 1 ? combo.key.toUpperCase() : capitalize(combo.key))\n  return parts.join(\"+\")\n}\n\nfunction capitalize(s: string): string {\n  return s.charAt(0).toUpperCase() + s.slice(1)\n}\n\nfunction isMac(): boolean {\n  if (typeof navigator === \"undefined\") return false\n  return /mac|iphone|ipad|ipod/i.test(navigator.userAgent)\n}\n","import type { Signal } from \"@pyreon/reactivity\"\nimport { signal } from \"@pyreon/reactivity\"\nimport { matchesCombo, parseShortcut } from \"./parse\"\nimport type { HotkeyEntry, HotkeyOptions } from \"./types\"\n\n// ─── State ───────────────────────────────────────────────────────────────────\n\nconst entries: HotkeyEntry[] = []\nconst activeScopes = signal<Set<string>>(new Set([\"global\"]))\nlet listenerAttached = false\n\n// ─── Input detection ─────────────────────────────────────────────────────────\n\nconst INPUT_TAGS = new Set([\"INPUT\", \"TEXTAREA\", \"SELECT\"])\n\nfunction isInputFocused(event: KeyboardEvent): boolean {\n  const target = event.target as HTMLElement | null\n  if (!target) return false\n  if (INPUT_TAGS.has(target.tagName)) return true\n  if (target.isContentEditable) return true\n  return false\n}\n\n// ─── Global listener ─────────────────────────────────────────────────────────\n\nfunction attachListener(): void {\n  if (listenerAttached) return\n  if (typeof window === \"undefined\") return\n  listenerAttached = true\n\n  window.addEventListener(\"keydown\", (event) => {\n    const scopes = activeScopes.peek()\n\n    for (const entry of entries) {\n      // Check scope\n      if (!scopes.has(entry.options.scope)) continue\n\n      // Check enabled\n      const enabled =\n        typeof entry.options.enabled === \"function\"\n          ? entry.options.enabled()\n          : entry.options.enabled\n      if (!enabled) continue\n\n      // Check input focus\n      if (!entry.options.enableOnInputs && isInputFocused(event)) continue\n\n      // Check key match\n      if (!matchesCombo(event, entry.combo)) continue\n\n      // Match found\n      if (entry.options.preventDefault) event.preventDefault()\n      if (entry.options.stopPropagation) event.stopPropagation()\n      entry.handler(event)\n    }\n  })\n}\n\n// ─── Registration ────────────────────────────────────────────────────────────\n\n/**\n * Register a keyboard shortcut. Returns an unregister function.\n *\n * @example\n * ```ts\n * const unregister = registerHotkey('ctrl+s', (e) => save(), { description: 'Save' })\n * // later: unregister()\n * ```\n */\nexport function registerHotkey(\n  shortcut: string,\n  handler: (event: KeyboardEvent) => void,\n  options?: HotkeyOptions,\n): () => void {\n  attachListener()\n\n  const entry: HotkeyEntry = {\n    shortcut,\n    combo: parseShortcut(shortcut),\n    handler,\n    options: {\n      scope: options?.scope ?? \"global\",\n      preventDefault: options?.preventDefault !== false,\n      stopPropagation: options?.stopPropagation === true,\n      enableOnInputs: options?.enableOnInputs === true,\n      enabled: options?.enabled ?? true,\n      ...(options?.description != null ? { description: options.description } : {}),\n    },\n  }\n\n  entries.push(entry)\n\n  return () => {\n    const idx = entries.indexOf(entry)\n    if (idx !== -1) entries.splice(idx, 1)\n  }\n}\n\n// ─── Scope management ────────────────────────────────────────────────────────\n\n/**\n * Activate a hotkey scope. 'global' is always active.\n */\nexport function enableScope(scope: string): void {\n  const current = activeScopes.peek()\n  if (current.has(scope)) return\n  const next = new Set(current)\n  next.add(scope)\n  activeScopes.set(next)\n}\n\n/**\n * Deactivate a hotkey scope. Cannot deactivate 'global'.\n */\nexport function disableScope(scope: string): void {\n  if (scope === \"global\") return\n  const current = activeScopes.peek()\n  if (!current.has(scope)) return\n  const next = new Set(current)\n  next.delete(scope)\n  activeScopes.set(next)\n}\n\n/**\n * Get the currently active scopes as a reactive signal.\n */\nexport function getActiveScopes(): Signal<Set<string>> {\n  return activeScopes\n}\n\n/**\n * Get all registered hotkeys (for building help dialogs).\n */\nexport function getRegisteredHotkeys(): ReadonlyArray<{\n  shortcut: string\n  scope: string\n  description?: string\n}> {\n  return entries.map((e) => ({\n    shortcut: e.shortcut,\n    scope: e.options.scope,\n    ...(e.options.description != null ? { description: e.options.description } : {}),\n  }))\n}\n\n// ─── Reset (for testing) ────────────────────────────────────────────────────\n\nexport function _resetHotkeys(): void {\n  entries.length = 0\n  activeScopes.set(new Set([\"global\"]))\n}\n","import { onUnmount } from \"@pyreon/core\"\nimport { registerHotkey } from \"./registry\"\nimport type { HotkeyOptions } from \"./types\"\n\n/**\n * Register a keyboard shortcut scoped to a component's lifecycle.\n * Automatically unregisters when the component unmounts.\n *\n * @example\n * ```ts\n * function Editor() {\n *   useHotkey('ctrl+s', () => save(), { description: 'Save document' })\n *   useHotkey('ctrl+z', () => undo())\n *   useHotkey('ctrl+shift+z', () => redo())\n *   // ...\n * }\n * ```\n */\nexport function useHotkey(\n  shortcut: string,\n  handler: (event: KeyboardEvent) => void,\n  options?: HotkeyOptions,\n): void {\n  const unregister = registerHotkey(shortcut, handler, options)\n  onUnmount(unregister)\n}\n","import { onUnmount } from \"@pyreon/core\"\nimport { disableScope, enableScope } from \"./registry\"\n\n/**\n * Activate a hotkey scope for the lifetime of a component.\n * When the component unmounts, the scope is deactivated.\n *\n * @example\n * ```tsx\n * function Modal() {\n *   useHotkeyScope('modal')\n *   useHotkey('escape', () => closeModal(), { scope: 'modal' })\n *   // ...\n * }\n * ```\n */\nexport function useHotkeyScope(scope: string): void {\n  enableScope(scope)\n  onUnmount(() => disableScope(scope))\n}\n"],"mappings":"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"}

package/lib/types/index.d.ts

@@ -40,7 +40,7 @@ interface HotkeyEntry {
   /** The callback to invoke */
   handler: (event: KeyboardEvent) => void;
   /** Options */
-  options: Required<Pick<HotkeyOptions, 'scope' | 'preventDefault' | 'stopPropagation' | 'enableOnInputs' | 'enabled'>> & {
+  options: Required<Pick<HotkeyOptions, "scope" | "preventDefault" | "stopPropagation" | "enableOnInputs" | "enabled">> & {
     description?: string;
   };
 }

package/lib/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/use-hotkey.ts","../../../src/use-hotkey-scope.ts","../../../src/registry.ts","../../../src/parse.ts"],"mappings":";;;;;;AAMA;UAAiB,QAAA;EACf,IAAA;EACA,KAAA;EACA,GAAA;EACA,IAAA;EACA,GAAA;AAAA;;;;UAMe,aAAA;EAAa;EAE5B,KAAA;EAF4B;EAI5B,cAAA;EAAA;EAEA,eAAA;EAEA;EAAA,cAAA;EAIA;EAFA,WAAA;EAEO;EAAP,OAAA;AAAA;;;;UAMe,WAAA;EASb;EAPF,QAAA;EAMiB;EAJjB,KAAA,EAAO,QAAA;EAFP;EAIA,OAAA,GAAU,KAAA,EAAO,aAAA;EAFV;EAIP,OAAA,EAAS,QAAA,CACP,IAAA,CACE,aAAA;IAOE,WAAA;EAAA;AAAA;;;;;AA9CR;;;;;;;;;;;AAWA;iBCCgB,SAAA,CACd,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,aAAA,WACjB,OAAA,GAAU,aAAA;;;;;;ADfZ;;;;;;;;;;iBEUgB,cAAA,CAAe,KAAA;;;;AFV/B;;;;;;;;iBG+DgB,cAAA,CACd,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,aAAA,WACjB,OAAA,GAAU,aAAA;;;AHvDZ;iBGwFgB,WAAA,CAAY,KAAA;;;;iBAWZ,YAAA,CAAa,KAAA;;;;iBAYb,eAAA,CAAA,GAAmB,MAAA,CAAO,GAAA;;;AH7F1C;iBGoGgB,oBAAA,CAAA,GAAwB,aAAA;EACtC,QAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,iBAac,aAAA,CAAA;;;;;AHjJhB;;iBIgBgB,aAAA,CAAc,QAAA,WAAmB,QAAA;;;;iBAsCjC,YAAA,CAAa,KAAA,EAAO,aAAA,EAAe,KAAA,EAAO,QAAA;;;;iBAa1C,WAAA,CAAY,KAAA,EAAO,QAAA"}
+{"version":3,"file":"index2.d.ts","names":[],"sources":["../../../src/types.ts","../../../src/use-hotkey.ts","../../../src/use-hotkey-scope.ts","../../../src/registry.ts","../../../src/parse.ts"],"mappings":";;;;;;AAMA;UAAiB,QAAA;EACf,IAAA;EACA,KAAA;EACA,GAAA;EACA,IAAA;EACA,GAAA;AAAA;;;;UAMe,aAAA;EAAa;EAE5B,KAAA;EAF4B;EAI5B,cAAA;EAAA;EAEA,eAAA;EAEA;EAAA,cAAA;EAIA;EAFA,WAAA;EAEO;EAAP,OAAA;AAAA;;;;UAMe,WAAA;EASb;EAPF,QAAA;EAMiB;EAJjB,KAAA,EAAO,QAAA;EAFP;EAIA,OAAA,GAAU,KAAA,EAAO,aAAA;EAFV;EAIP,OAAA,EAAS,QAAA,CACP,IAAA,CACE,aAAA;IAGE,WAAA;EAAA;AAAA;;;;;AA1CR;;;;;;;;;;;AAWA;iBCCgB,SAAA,CACd,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,aAAA,WACjB,OAAA,GAAU,aAAA;;;;;;ADfZ;;;;;;;;;;iBEUgB,cAAA,CAAe,KAAA;;;;AFV/B;;;;;;;;iBG+DgB,cAAA,CACd,QAAA,UACA,OAAA,GAAU,KAAA,EAAO,aAAA,WACjB,OAAA,GAAU,aAAA;;;AHvDZ;iBGsFgB,WAAA,CAAY,KAAA;;;;iBAWZ,YAAA,CAAa,KAAA;;;;iBAYb,eAAA,CAAA,GAAmB,MAAA,CAAO,GAAA;;;AH3F1C;iBGkGgB,oBAAA,CAAA,GAAwB,aAAA;EACtC,QAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,iBAWc,aAAA,CAAA;;;;;AH7IhB;;iBIgBgB,aAAA,CAAc,QAAA,WAAmB,QAAA;;;;iBAsCjC,YAAA,CAAa,KAAA,EAAO,aAAA,EAAe,KAAA,EAAO,QAAA;;;;iBAa1C,WAAA,CAAY,KAAA,EAAO,QAAA"}

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@pyreon/hotkeys",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Reactive keyboard shortcut management for Pyreon — scope-aware, conflict detection",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pyreon/fundamentals.git",
-    "directory": "packages/hotkeys"
+    "url": "https://github.com/pyreon/pyreon.git",
+    "directory": "packages/fundamentals/hotkeys"
   },
   "homepage": "https://github.com/pyreon/fundamentals/tree/main/packages/hotkeys#readme",
   "bugs": {
-    "url": "https://github.com/pyreon/fundamentals/issues"
+    "url": "https://github.com/pyreon/pyreon/issues"
   },
   "publishConfig": {
     "access": "public"
@@ -37,10 +37,17 @@
     "build": "vl_rolldown_build",
     "dev": "vl_rolldown_build-watch",
     "test": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check ."
   },
   "peerDependencies": {
-    "@pyreon/core": ">=0.7.0 <0.8.0",
-    "@pyreon/reactivity": ">=0.7.0 <0.8.0"
+    "@pyreon/core": "^0.11.0",
+    "@pyreon/reactivity": "^0.11.0"
+  },
+  "devDependencies": {
+    "@happy-dom/global-registrator": "^20.8.3",
+    "@pyreon/core": "^0.11.0",
+    "@pyreon/reactivity": "^0.11.0",
+    "@vitus-labs/tools-lint": "^1.11.0"
   }
 }

package/src/index.ts

@@ -23,8 +23,8 @@
 
 // ─── Hooks ───────────────────────────────────────────────────────────────────
 
-export { useHotkey } from './use-hotkey'
-export { useHotkeyScope } from './use-hotkey-scope'
+export { useHotkey } from "./use-hotkey"
+export { useHotkeyScope } from "./use-hotkey-scope"
 
 // ─── Imperative API ──────────────────────────────────────────────────────────
 
@@ -34,16 +34,16 @@ export {
   getActiveScopes,
   getRegisteredHotkeys,
   registerHotkey,
-} from './registry'
+} from "./registry"
 
 // ─── Utilities ───────────────────────────────────────────────────────────────
 
-export { formatCombo, matchesCombo, parseShortcut } from './parse'
+export { formatCombo, matchesCombo, parseShortcut } from "./parse"
 
 // ─── Types ───────────────────────────────────────────────────────────────────
 
-export type { HotkeyEntry, HotkeyOptions, KeyCombo } from './types'
+export type { HotkeyEntry, HotkeyOptions, KeyCombo } from "./types"
 
 // ─── Testing ─────────────────────────────────────────────────────────────────
 
-export { _resetHotkeys } from './registry'
+export { _resetHotkeys } from "./registry"

package/src/parse.ts

@@ -1,19 +1,19 @@
-import type { KeyCombo } from './types'
+import type { KeyCombo } from "./types"
 
 // ─── Key aliases ─────────────────────────────────────────────────────────────
 
 const KEY_ALIASES: Record<string, string> = {
-  esc: 'escape',
-  return: 'enter',
-  del: 'delete',
-  ins: 'insert',
-  space: ' ',
-  spacebar: ' ',
-  up: 'arrowup',
-  down: 'arrowdown',
-  left: 'arrowleft',
-  right: 'arrowright',
-  plus: '+',
+  esc: "escape",
+  return: "enter",
+  del: "delete",
+  ins: "insert",
+  space: " ",
+  spacebar: " ",
+  up: "arrowup",
+  down: "arrowdown",
+  left: "arrowleft",
+  right: "arrowright",
+  plus: "+",
 }
 
 /**
@@ -21,26 +21,26 @@ const KEY_ALIASES: Record<string, string> = {
  * Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).
  */
 export function parseShortcut(shortcut: string): KeyCombo {
-  const parts = shortcut.toLowerCase().trim().split('+')
+  const parts = shortcut.toLowerCase().trim().split("+")
   const combo: KeyCombo = {
     ctrl: false,
     shift: false,
     alt: false,
     meta: false,
-    key: '',
+    key: "",
   }
 
   for (const part of parts) {
     const p = part.trim()
-    if (p === 'ctrl' || p === 'control') {
+    if (p === "ctrl" || p === "control") {
       combo.ctrl = true
-    } else if (p === 'shift') {
+    } else if (p === "shift") {
       combo.shift = true
-    } else if (p === 'alt') {
+    } else if (p === "alt") {
       combo.alt = true
-    } else if (p === 'meta' || p === 'cmd' || p === 'command') {
+    } else if (p === "meta" || p === "cmd" || p === "command") {
       combo.meta = true
-    } else if (p === 'mod') {
+    } else if (p === "mod") {
       // mod = meta on Mac, ctrl elsewhere
       if (isMac()) {
         combo.meta = true
@@ -73,14 +73,12 @@ export function matchesCombo(event: KeyboardEvent, combo: KeyCombo): boolean {
  */
 export function formatCombo(combo: KeyCombo): string {
   const parts: string[] = []
-  if (combo.ctrl) parts.push('Ctrl')
-  if (combo.shift) parts.push('Shift')
-  if (combo.alt) parts.push('Alt')
-  if (combo.meta) parts.push(isMac() ? '⌘' : 'Meta')
-  parts.push(
-    combo.key.length === 1 ? combo.key.toUpperCase() : capitalize(combo.key),
-  )
-  return parts.join('+')
+  if (combo.ctrl) parts.push("Ctrl")
+  if (combo.shift) parts.push("Shift")
+  if (combo.alt) parts.push("Alt")
+  if (combo.meta) parts.push(isMac() ? "⌘" : "Meta")
+  parts.push(combo.key.length === 1 ? combo.key.toUpperCase() : capitalize(combo.key))
+  return parts.join("+")
 }
 
 function capitalize(s: string): string {
@@ -88,6 +86,6 @@ function capitalize(s: string): string {
 }
 
 function isMac(): boolean {
-  if (typeof navigator === 'undefined') return false
+  if (typeof navigator === "undefined") return false
   return /mac|iphone|ipad|ipod/i.test(navigator.userAgent)
 }

package/src/registry.ts

@@ -1,17 +1,17 @@
-import type { Signal } from '@pyreon/reactivity'
-import { signal } from '@pyreon/reactivity'
-import { matchesCombo, parseShortcut } from './parse'
-import type { HotkeyEntry, HotkeyOptions } from './types'
+import type { Signal } from "@pyreon/reactivity"
+import { signal } from "@pyreon/reactivity"
+import { matchesCombo, parseShortcut } from "./parse"
+import type { HotkeyEntry, HotkeyOptions } from "./types"
 
 // ─── State ───────────────────────────────────────────────────────────────────
 
 const entries: HotkeyEntry[] = []
-const activeScopes = signal<Set<string>>(new Set(['global']))
+const activeScopes = signal<Set<string>>(new Set(["global"]))
 let listenerAttached = false
 
 // ─── Input detection ─────────────────────────────────────────────────────────
 
-const INPUT_TAGS = new Set(['INPUT', 'TEXTAREA', 'SELECT'])
+const INPUT_TAGS = new Set(["INPUT", "TEXTAREA", "SELECT"])
 
 function isInputFocused(event: KeyboardEvent): boolean {
   const target = event.target as HTMLElement | null
@@ -25,10 +25,10 @@ function isInputFocused(event: KeyboardEvent): boolean {
 
 function attachListener(): void {
   if (listenerAttached) return
-  if (typeof window === 'undefined') return
+  if (typeof window === "undefined") return
   listenerAttached = true
 
-  window.addEventListener('keydown', (event) => {
+  window.addEventListener("keydown", (event) => {
     const scopes = activeScopes.peek()
 
     for (const entry of entries) {
@@ -37,7 +37,7 @@ function attachListener(): void {
 
       // Check enabled
       const enabled =
-        typeof entry.options.enabled === 'function'
+        typeof entry.options.enabled === "function"
           ? entry.options.enabled()
           : entry.options.enabled
       if (!enabled) continue
@@ -79,14 +79,12 @@ export function registerHotkey(
     combo: parseShortcut(shortcut),
     handler,
     options: {
-      scope: options?.scope ?? 'global',
+      scope: options?.scope ?? "global",
       preventDefault: options?.preventDefault !== false,
       stopPropagation: options?.stopPropagation === true,
       enableOnInputs: options?.enableOnInputs === true,
       enabled: options?.enabled ?? true,
-      ...(options?.description != null
-        ? { description: options.description }
-        : {}),
+      ...(options?.description != null ? { description: options.description } : {}),
     },
   }
 
@@ -115,7 +113,7 @@ export function enableScope(scope: string): void {
  * Deactivate a hotkey scope. Cannot deactivate 'global'.
  */
 export function disableScope(scope: string): void {
-  if (scope === 'global') return
+  if (scope === "global") return
   const current = activeScopes.peek()
   if (!current.has(scope)) return
   const next = new Set(current)
@@ -141,9 +139,7 @@ export function getRegisteredHotkeys(): ReadonlyArray<{
   return entries.map((e) => ({
     shortcut: e.shortcut,
     scope: e.options.scope,
-    ...(e.options.description != null
-      ? { description: e.options.description }
-      : {}),
+    ...(e.options.description != null ? { description: e.options.description } : {}),
   }))
 }
 
@@ -151,5 +147,5 @@ export function getRegisteredHotkeys(): ReadonlyArray<{
 
 export function _resetHotkeys(): void {
   entries.length = 0
-  activeScopes.set(new Set(['global']))
+  activeScopes.set(new Set(["global"]))
 }

package/src/tests/hotkeys.test.ts

@@ -1,4 +1,4 @@
-import { afterEach, beforeEach, describe, expect, it } from 'vitest'
+import { afterEach, beforeEach, describe, expect, it } from "vitest"
 import {
   _resetHotkeys,
   disableScope,
@@ -9,7 +9,7 @@ import {
   matchesCombo,
   parseShortcut,
   registerHotkey,
-} from '../index'
+} from "../index"
 
 // ─── Helpers ─────────────────────────────────────────────────────────────────
 
@@ -23,7 +23,7 @@ function fireKey(
   }> = {},
   target?: HTMLElement,
 ): KeyboardEvent {
-  const event = new KeyboardEvent('keydown', {
+  const event = new KeyboardEvent("keydown", {
     key,
     ctrlKey: modifiers.ctrlKey ?? false,
     shiftKey: modifiers.shiftKey ?? false,
@@ -38,117 +38,117 @@ function fireKey(
 
 // ─── Tests ───────────────────────────────────────────────────────────────────
 
-describe('parseShortcut', () => {
-  it('parses simple key', () => {
-    const combo = parseShortcut('a')
+describe("parseShortcut", () => {
+  it("parses simple key", () => {
+    const combo = parseShortcut("a")
     expect(combo).toEqual({
       ctrl: false,
       shift: false,
       alt: false,
       meta: false,
-      key: 'a',
+      key: "a",
     })
   })
 
-  it('parses ctrl+key', () => {
-    const combo = parseShortcut('ctrl+s')
+  it("parses ctrl+key", () => {
+    const combo = parseShortcut("ctrl+s")
     expect(combo.ctrl).toBe(true)
-    expect(combo.key).toBe('s')
+    expect(combo.key).toBe("s")
   })
 
-  it('parses multiple modifiers', () => {
-    const combo = parseShortcut('ctrl+shift+alt+k')
+  it("parses multiple modifiers", () => {
+    const combo = parseShortcut("ctrl+shift+alt+k")
     expect(combo.ctrl).toBe(true)
     expect(combo.shift).toBe(true)
     expect(combo.alt).toBe(true)
-    expect(combo.key).toBe('k')
+    expect(combo.key).toBe("k")
   })
 
-  it('parses meta/cmd/command as meta', () => {
-    expect(parseShortcut('meta+k').meta).toBe(true)
-    expect(parseShortcut('cmd+k').meta).toBe(true)
-    expect(parseShortcut('command+k').meta).toBe(true)
+  it("parses meta/cmd/command as meta", () => {
+    expect(parseShortcut("meta+k").meta).toBe(true)
+    expect(parseShortcut("cmd+k").meta).toBe(true)
+    expect(parseShortcut("command+k").meta).toBe(true)
   })
 
-  it('handles aliases', () => {
-    expect(parseShortcut('esc').key).toBe('escape')
-    expect(parseShortcut('return').key).toBe('enter')
-    expect(parseShortcut('del').key).toBe('delete')
-    expect(parseShortcut('space').key).toBe(' ')
+  it("handles aliases", () => {
+    expect(parseShortcut("esc").key).toBe("escape")
+    expect(parseShortcut("return").key).toBe("enter")
+    expect(parseShortcut("del").key).toBe("delete")
+    expect(parseShortcut("space").key).toBe(" ")
   })
 
-  it('parses mod as ctrl on non-Mac', () => {
+  it("parses mod as ctrl on non-Mac", () => {
     // happy-dom doesn't simulate Mac, so mod should resolve to ctrl
-    const combo = parseShortcut('mod+k')
+    const combo = parseShortcut("mod+k")
     expect(combo.ctrl || combo.meta).toBe(true)
-    expect(combo.key).toBe('k')
+    expect(combo.key).toBe("k")
   })
 
-  it('parses control as ctrl', () => {
-    expect(parseShortcut('control+s').ctrl).toBe(true)
+  it("parses control as ctrl", () => {
+    expect(parseShortcut("control+s").ctrl).toBe(true)
   })
 
-  it('is case-insensitive', () => {
-    const combo = parseShortcut('Ctrl+Shift+S')
+  it("is case-insensitive", () => {
+    const combo = parseShortcut("Ctrl+Shift+S")
     expect(combo.ctrl).toBe(true)
     expect(combo.shift).toBe(true)
-    expect(combo.key).toBe('s')
+    expect(combo.key).toBe("s")
   })
 })
 
-describe('matchesCombo', () => {
-  it('matches simple key', () => {
-    const combo = parseShortcut('a')
-    const event = new KeyboardEvent('keydown', { key: 'a' })
+describe("matchesCombo", () => {
+  it("matches simple key", () => {
+    const combo = parseShortcut("a")
+    const event = new KeyboardEvent("keydown", { key: "a" })
     expect(matchesCombo(event, combo)).toBe(true)
   })
 
-  it('matches with modifiers', () => {
-    const combo = parseShortcut('ctrl+s')
-    const event = new KeyboardEvent('keydown', { key: 's', ctrlKey: true })
+  it("matches with modifiers", () => {
+    const combo = parseShortcut("ctrl+s")
+    const event = new KeyboardEvent("keydown", { key: "s", ctrlKey: true })
     expect(matchesCombo(event, combo)).toBe(true)
   })
 
-  it('does not match when modifier is missing', () => {
-    const combo = parseShortcut('ctrl+s')
-    const event = new KeyboardEvent('keydown', { key: 's' })
+  it("does not match when modifier is missing", () => {
+    const combo = parseShortcut("ctrl+s")
+    const event = new KeyboardEvent("keydown", { key: "s" })
     expect(matchesCombo(event, combo)).toBe(false)
   })
 
-  it('does not match when extra modifier is present', () => {
-    const combo = parseShortcut('ctrl+s')
-    const event = new KeyboardEvent('keydown', {
-      key: 's',
+  it("does not match when extra modifier is present", () => {
+    const combo = parseShortcut("ctrl+s")
+    const event = new KeyboardEvent("keydown", {
+      key: "s",
       ctrlKey: true,
       shiftKey: true,
     })
     expect(matchesCombo(event, combo)).toBe(false)
   })
 
-  it('does not match wrong key', () => {
-    const combo = parseShortcut('ctrl+s')
-    const event = new KeyboardEvent('keydown', { key: 'a', ctrlKey: true })
+  it("does not match wrong key", () => {
+    const combo = parseShortcut("ctrl+s")
+    const event = new KeyboardEvent("keydown", { key: "a", ctrlKey: true })
     expect(matchesCombo(event, combo)).toBe(false)
   })
 })
 
-describe('formatCombo', () => {
-  it('formats simple key', () => {
-    expect(formatCombo(parseShortcut('a'))).toBe('A')
+describe("formatCombo", () => {
+  it("formats simple key", () => {
+    expect(formatCombo(parseShortcut("a"))).toBe("A")
   })
 
-  it('formats with modifiers', () => {
-    const result = formatCombo(parseShortcut('ctrl+shift+s'))
-    expect(result).toBe('Ctrl+Shift+S')
+  it("formats with modifiers", () => {
+    const result = formatCombo(parseShortcut("ctrl+shift+s"))
+    expect(result).toBe("Ctrl+Shift+S")
   })
 
-  it('capitalizes special keys', () => {
-    expect(formatCombo(parseShortcut('escape'))).toBe('Escape')
-    expect(formatCombo(parseShortcut('enter'))).toBe('Enter')
+  it("capitalizes special keys", () => {
+    expect(formatCombo(parseShortcut("escape"))).toBe("Escape")
+    expect(formatCombo(parseShortcut("enter"))).toBe("Enter")
   })
 })
 
-describe('registerHotkey', () => {
+describe("registerHotkey", () => {
   beforeEach(() => {
     _resetHotkeys()
   })
@@ -157,184 +157,184 @@ describe('registerHotkey', () => {
     _resetHotkeys()
   })
 
-  it('fires handler on matching keydown', () => {
+  it("fires handler on matching keydown", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(fired).toBe(true)
   })
 
-  it('does not fire on non-matching key', () => {
+  it("does not fire on non-matching key", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
-    fireKey('a', { ctrlKey: true })
+    fireKey("a", { ctrlKey: true })
     expect(fired).toBe(false)
   })
 
-  it('does not fire without required modifier', () => {
+  it("does not fire without required modifier", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
-    fireKey('s')
+    fireKey("s")
     expect(fired).toBe(false)
   })
 
-  it('passes the event to the handler', () => {
+  it("passes the event to the handler", () => {
     let receivedEvent: KeyboardEvent | null = null
-    registerHotkey('ctrl+s', (e) => {
+    registerHotkey("ctrl+s", (e) => {
       receivedEvent = e
     })
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(receivedEvent).not.toBeNull()
-    expect(receivedEvent!.key).toBe('s')
+    expect(receivedEvent!.key).toBe("s")
   })
 
-  it('preventDefault is true by default', () => {
-    registerHotkey('ctrl+s', () => {
+  it("preventDefault is true by default", () => {
+    registerHotkey("ctrl+s", () => {
       // handler
     })
-    const event = fireKey('s', { ctrlKey: true })
+    const event = fireKey("s", { ctrlKey: true })
     expect(event.defaultPrevented).toBe(true)
   })
 
-  it('preventDefault can be disabled', () => {
+  it("preventDefault can be disabled", () => {
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         // handler
       },
       { preventDefault: false },
     )
-    const event = fireKey('s', { ctrlKey: true })
+    const event = fireKey("s", { ctrlKey: true })
     expect(event.defaultPrevented).toBe(false)
   })
 
-  it('unregister function removes the hotkey', () => {
+  it("unregister function removes the hotkey", () => {
     let count = 0
-    const unregister = registerHotkey('ctrl+s', () => {
+    const unregister = registerHotkey("ctrl+s", () => {
       count++
     })
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
 
     unregister()
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
   })
 
-  it('does not fire in input elements by default', () => {
+  it("does not fire in input elements by default", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
 
-    const input = document.createElement('input')
+    const input = document.createElement("input")
     document.body.appendChild(input)
-    fireKey('s', { ctrlKey: true }, input)
+    fireKey("s", { ctrlKey: true }, input)
     input.remove()
 
     expect(fired).toBe(false)
   })
 
-  it('fires in input elements when enableOnInputs is true', () => {
+  it("fires in input elements when enableOnInputs is true", () => {
     let fired = false
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         fired = true
       },
       { enableOnInputs: true },
     )
 
-    const input = document.createElement('input')
+    const input = document.createElement("input")
     document.body.appendChild(input)
-    fireKey('s', { ctrlKey: true }, input)
+    fireKey("s", { ctrlKey: true }, input)
     input.remove()
 
     expect(fired).toBe(true)
   })
 
-  it('does not fire in textarea by default', () => {
+  it("does not fire in textarea by default", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
 
-    const textarea = document.createElement('textarea')
+    const textarea = document.createElement("textarea")
     document.body.appendChild(textarea)
-    fireKey('s', { ctrlKey: true }, textarea)
+    fireKey("s", { ctrlKey: true }, textarea)
     textarea.remove()
 
     expect(fired).toBe(false)
   })
 
-  it('does not fire in contenteditable by default', () => {
+  it("does not fire in contenteditable by default", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
 
-    const div = document.createElement('div')
-    div.contentEditable = 'true'
+    const div = document.createElement("div")
+    div.contentEditable = "true"
     document.body.appendChild(div)
-    fireKey('s', { ctrlKey: true }, div)
+    fireKey("s", { ctrlKey: true }, div)
     div.remove()
 
     expect(fired).toBe(false)
   })
 
-  it('enabled: false prevents firing', () => {
+  it("enabled: false prevents firing", () => {
     let fired = false
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         fired = true
       },
       { enabled: false },
     )
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(fired).toBe(false)
   })
 
-  it('enabled as function controls firing dynamically', () => {
+  it("enabled as function controls firing dynamically", () => {
     let enabled = true
     let count = 0
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         count++
       },
       { enabled: () => enabled },
     )
 
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
 
     enabled = false
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
   })
 
-  it('multiple hotkeys can be registered', () => {
+  it("multiple hotkeys can be registered", () => {
     let saveCount = 0
     let undoCount = 0
-    registerHotkey('ctrl+s', () => saveCount++)
-    registerHotkey('ctrl+z', () => undoCount++)
+    registerHotkey("ctrl+s", () => saveCount++)
+    registerHotkey("ctrl+z", () => undoCount++)
 
-    fireKey('s', { ctrlKey: true })
-    fireKey('z', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
+    fireKey("z", { ctrlKey: true })
 
     expect(saveCount).toBe(1)
     expect(undoCount).toBe(1)
   })
 })
 
-describe('scopes', () => {
+describe("scopes", () => {
   beforeEach(() => {
     _resetHotkeys()
   })
@@ -343,85 +343,85 @@ describe('scopes', () => {
     _resetHotkeys()
   })
 
-  it('global scope is active by default', () => {
+  it("global scope is active by default", () => {
     const scopes = getActiveScopes()
-    expect(scopes.peek().has('global')).toBe(true)
+    expect(scopes.peek().has("global")).toBe(true)
   })
 
-  it('global scope hotkeys fire by default', () => {
+  it("global scope hotkeys fire by default", () => {
     let fired = false
-    registerHotkey('ctrl+s', () => {
+    registerHotkey("ctrl+s", () => {
       fired = true
     })
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(fired).toBe(true)
   })
 
-  it('non-global scope hotkeys do not fire by default', () => {
+  it("non-global scope hotkeys do not fire by default", () => {
     let fired = false
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         fired = true
       },
-      { scope: 'editor' },
+      { scope: "editor" },
     )
-    fireKey('s', { ctrlKey: true })
+    fireKey("s", { ctrlKey: true })
     expect(fired).toBe(false)
   })
 
-  it('enableScope activates a scope', () => {
+  it("enableScope activates a scope", () => {
     let fired = false
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         fired = true
       },
-      { scope: 'editor' },
+      { scope: "editor" },
     )
 
-    enableScope('editor')
-    fireKey('s', { ctrlKey: true })
+    enableScope("editor")
+    fireKey("s", { ctrlKey: true })
     expect(fired).toBe(true)
   })
 
-  it('disableScope deactivates a scope', () => {
+  it("disableScope deactivates a scope", () => {
     let count = 0
     registerHotkey(
-      'ctrl+s',
+      "ctrl+s",
       () => {
         count++
       },
-      { scope: 'editor' },
+      { scope: "editor" },
     )
 
-    enableScope('editor')
-    fireKey('s', { ctrlKey: true })
+    enableScope("editor")
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
 
-    disableScope('editor')
-    fireKey('s', { ctrlKey: true })
+    disableScope("editor")
+    fireKey("s", { ctrlKey: true })
     expect(count).toBe(1)
   })
 
-  it('cannot disable global scope', () => {
-    disableScope('global')
-    expect(getActiveScopes().peek().has('global')).toBe(true)
+  it("cannot disable global scope", () => {
+    disableScope("global")
+    expect(getActiveScopes().peek().has("global")).toBe(true)
   })
 
-  it('enableScope is idempotent', () => {
-    enableScope('editor')
-    enableScope('editor')
+  it("enableScope is idempotent", () => {
+    enableScope("editor")
+    enableScope("editor")
     expect(getActiveScopes().peek().size).toBe(2) // global + editor
   })
 
-  it('disableScope for non-active scope is no-op', () => {
-    disableScope('nonexistent')
+  it("disableScope for non-active scope is no-op", () => {
+    disableScope("nonexistent")
     expect(getActiveScopes().peek().size).toBe(1)
   })
 })
 
-describe('getRegisteredHotkeys', () => {
+describe("getRegisteredHotkeys", () => {
   beforeEach(() => {
     _resetHotkeys()
   })
@@ -430,30 +430,30 @@ describe('getRegisteredHotkeys', () => {
     _resetHotkeys()
   })
 
-  it('returns all registered hotkeys', () => {
+  it("returns all registered hotkeys", () => {
     // biome-ignore lint/suspicious/noEmptyBlockStatements: intentional no-op handlers for registry test
     const noop = () => {}
-    registerHotkey('ctrl+s', noop, { description: 'Save' })
-    registerHotkey('ctrl+z', noop, { scope: 'editor', description: 'Undo' })
+    registerHotkey("ctrl+s", noop, { description: "Save" })
+    registerHotkey("ctrl+z", noop, { scope: "editor", description: "Undo" })
 
     const hotkeys = getRegisteredHotkeys()
     expect(hotkeys).toHaveLength(2)
     expect(hotkeys[0]).toEqual({
-      shortcut: 'ctrl+s',
-      scope: 'global',
-      description: 'Save',
+      shortcut: "ctrl+s",
+      scope: "global",
+      description: "Save",
     })
     expect(hotkeys[1]).toEqual({
-      shortcut: 'ctrl+z',
-      scope: 'editor',
-      description: 'Undo',
+      shortcut: "ctrl+z",
+      scope: "editor",
+      description: "Undo",
     })
   })
 
-  it('reflects unregistered hotkeys', () => {
+  it("reflects unregistered hotkeys", () => {
     // biome-ignore lint/suspicious/noEmptyBlockStatements: intentional no-op handler
     const noop = () => {}
-    const unsub = registerHotkey('ctrl+s', noop)
+    const unsub = registerHotkey("ctrl+s", noop)
     expect(getRegisteredHotkeys()).toHaveLength(1)
     unsub()
     expect(getRegisteredHotkeys()).toHaveLength(0)

package/src/types.ts

@@ -44,11 +44,7 @@ export interface HotkeyEntry {
   options: Required<
     Pick<
       HotkeyOptions,
-      | 'scope'
-      | 'preventDefault'
-      | 'stopPropagation'
-      | 'enableOnInputs'
-      | 'enabled'
+      "scope" | "preventDefault" | "stopPropagation" | "enableOnInputs" | "enabled"
     >
   > & { description?: string }
 }

package/src/use-hotkey-scope.ts

@@ -1,5 +1,5 @@
-import { onUnmount } from '@pyreon/core'
-import { disableScope, enableScope } from './registry'
+import { onUnmount } from "@pyreon/core"
+import { disableScope, enableScope } from "./registry"
 
 /**
  * Activate a hotkey scope for the lifetime of a component.

package/src/use-hotkey.ts

@@ -1,6 +1,6 @@
-import { onUnmount } from '@pyreon/core'
-import { registerHotkey } from './registry'
-import type { HotkeyOptions } from './types'
+import { onUnmount } from "@pyreon/core"
+import { registerHotkey } from "./registry"
+import type { HotkeyOptions } from "./types"
 
 /**
  * Register a keyboard shortcut scoped to a component's lifecycle.