@pyreon/hotkeys 0.6.0 → 0.8.0

package/lib/analysis/index.js.html

@@ -5386,7 +5386,7 @@ var drawChart = (function (exports) {
   </script>
   <script>
     /*<!--*/
-    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"1e5277a7-1","name":"parse.ts"},{"uid":"1e5277a7-3","name":"registry.ts"},{"uid":"1e5277a7-5","name":"use-hotkey.ts"},{"uid":"1e5277a7-7","name":"use-hotkey-scope.ts"},{"uid":"1e5277a7-9","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"1e5277a7-1":{"renderedLength":1941,"gzipLength":838,"brotliLength":0,"metaUid":"1e5277a7-0"},"1e5277a7-3":{"renderedLength":2832,"gzipLength":1057,"brotliLength":0,"metaUid":"1e5277a7-2"},"1e5277a7-5":{"renderedLength":496,"gzipLength":295,"brotliLength":0,"metaUid":"1e5277a7-4"},"1e5277a7-7":{"renderedLength":421,"gzipLength":264,"brotliLength":0,"metaUid":"1e5277a7-6"},"1e5277a7-9":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"1e5277a7-8"}},"nodeMetas":{"1e5277a7-0":{"id":"/src/parse.ts","moduleParts":{"index.js":"1e5277a7-1"},"imported":[],"importedBy":[{"uid":"1e5277a7-8"},{"uid":"1e5277a7-2"}]},"1e5277a7-2":{"id":"/src/registry.ts","moduleParts":{"index.js":"1e5277a7-3"},"imported":[{"uid":"1e5277a7-11"},{"uid":"1e5277a7-0"}],"importedBy":[{"uid":"1e5277a7-8"},{"uid":"1e5277a7-4"},{"uid":"1e5277a7-6"}]},"1e5277a7-4":{"id":"/src/use-hotkey.ts","moduleParts":{"index.js":"1e5277a7-5"},"imported":[{"uid":"1e5277a7-10"},{"uid":"1e5277a7-2"}],"importedBy":[{"uid":"1e5277a7-8"}]},"1e5277a7-6":{"id":"/src/use-hotkey-scope.ts","moduleParts":{"index.js":"1e5277a7-7"},"imported":[{"uid":"1e5277a7-10"},{"uid":"1e5277a7-2"}],"importedBy":[{"uid":"1e5277a7-8"}]},"1e5277a7-8":{"id":"/src/index.ts","moduleParts":{"index.js":"1e5277a7-9"},"imported":[{"uid":"1e5277a7-4"},{"uid":"1e5277a7-6"},{"uid":"1e5277a7-2"},{"uid":"1e5277a7-0"}],"importedBy":[],"isEntry":true},"1e5277a7-10":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"1e5277a7-4"},{"uid":"1e5277a7-6"}]},"1e5277a7-11":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"1e5277a7-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
+    const data = {"version":2,"tree":{"name":"root","children":[{"name":"index.js","children":[{"name":"src","children":[{"uid":"b111ad13-1","name":"parse.ts"},{"uid":"b111ad13-3","name":"registry.ts"},{"uid":"b111ad13-5","name":"use-hotkey.ts"},{"uid":"b111ad13-7","name":"use-hotkey-scope.ts"},{"uid":"b111ad13-9","name":"index.ts"}]}]}],"isRoot":true},"nodeParts":{"b111ad13-1":{"renderedLength":1941,"gzipLength":838,"brotliLength":0,"metaUid":"b111ad13-0"},"b111ad13-3":{"renderedLength":2918,"gzipLength":1080,"brotliLength":0,"metaUid":"b111ad13-2"},"b111ad13-5":{"renderedLength":496,"gzipLength":295,"brotliLength":0,"metaUid":"b111ad13-4"},"b111ad13-7":{"renderedLength":421,"gzipLength":264,"brotliLength":0,"metaUid":"b111ad13-6"},"b111ad13-9":{"renderedLength":0,"gzipLength":0,"brotliLength":0,"metaUid":"b111ad13-8"}},"nodeMetas":{"b111ad13-0":{"id":"/src/parse.ts","moduleParts":{"index.js":"b111ad13-1"},"imported":[],"importedBy":[{"uid":"b111ad13-8"},{"uid":"b111ad13-2"}]},"b111ad13-2":{"id":"/src/registry.ts","moduleParts":{"index.js":"b111ad13-3"},"imported":[{"uid":"b111ad13-11"},{"uid":"b111ad13-0"}],"importedBy":[{"uid":"b111ad13-8"},{"uid":"b111ad13-4"},{"uid":"b111ad13-6"}]},"b111ad13-4":{"id":"/src/use-hotkey.ts","moduleParts":{"index.js":"b111ad13-5"},"imported":[{"uid":"b111ad13-10"},{"uid":"b111ad13-2"}],"importedBy":[{"uid":"b111ad13-8"}]},"b111ad13-6":{"id":"/src/use-hotkey-scope.ts","moduleParts":{"index.js":"b111ad13-7"},"imported":[{"uid":"b111ad13-10"},{"uid":"b111ad13-2"}],"importedBy":[{"uid":"b111ad13-8"}]},"b111ad13-8":{"id":"/src/index.ts","moduleParts":{"index.js":"b111ad13-9"},"imported":[{"uid":"b111ad13-4"},{"uid":"b111ad13-6"},{"uid":"b111ad13-2"},{"uid":"b111ad13-0"}],"importedBy":[],"isEntry":true},"b111ad13-10":{"id":"@pyreon/core","moduleParts":{},"imported":[],"importedBy":[{"uid":"b111ad13-4"},{"uid":"b111ad13-6"}]},"b111ad13-11":{"id":"@pyreon/reactivity","moduleParts":{},"imported":[],"importedBy":[{"uid":"b111ad13-2"}]}},"env":{"rollup":"4.23.0"},"options":{"gzip":true,"brotli":false,"sourcemap":false}};
 
     const run = () => {
       const width = window.innerWidth;

package/lib/index.js

@@ -125,7 +125,7 @@ function registerHotkey(shortcut, handler, options) {
 			stopPropagation: options?.stopPropagation === true,
 			enableOnInputs: options?.enableOnInputs === true,
 			enabled: options?.enabled ?? true,
-			description: options?.description
+			...options?.description != null ? { description: options.description } : {}
 		}
 	};
 	entries.push(entry);
@@ -168,7 +168,7 @@ function getRegisteredHotkeys() {
 	return entries.map((e) => ({
 		shortcut: e.shortcut,
 		scope: e.options.scope,
-		description: e.options.description
+		...e.options.description != null ? { description: e.options.description } : {}
 	}));
 }
 function _resetHotkeys() {

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      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    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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"}
+{"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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"}

package/lib/types/index.d.ts

@@ -1,198 +1,130 @@
-import { onUnmount } from "@pyreon/core";
-import { signal } from "@pyreon/reactivity";
-
-//#region src/parse.ts
+import { Signal } from "@pyreon/reactivity";
 
+//#region src/types.d.ts
 /**
-* Parse a shortcut string like 'ctrl+shift+s' into a KeyCombo.
-* Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).
-*/
-function parseShortcut(shortcut) {
-  const parts = shortcut.toLowerCase().trim().split("+");
-  const combo = {
-    ctrl: false,
-    shift: false,
-    alt: false,
-    meta: false,
-    key: ""
-  };
-  for (const part of parts) {
-    const p = part.trim();
-    if (p === "ctrl" || p === "control") combo.ctrl = true;else if (p === "shift") combo.shift = true;else if (p === "alt") combo.alt = true;else if (p === "meta" || p === "cmd" || p === "command") combo.meta = true;else if (p === "mod") {
-      if (isMac()) combo.meta = true;else combo.ctrl = true;
-    } else combo.key = KEY_ALIASES[p] ?? p;
-  }
-  return combo;
+ * A parsed key combination.
+ * Example: 'ctrl+shift+s' → { ctrl: true, shift: true, alt: false, meta: false, key: 's' }
+ */
+interface KeyCombo {
+  ctrl: boolean;
+  shift: boolean;
+  alt: boolean;
+  meta: boolean;
+  key: string;
 }
 /**
-* Check if a KeyboardEvent matches a KeyCombo.
-*/
-function matchesCombo(event, combo) {
-  if (event.ctrlKey !== combo.ctrl) return false;
-  if (event.shiftKey !== combo.shift) return false;
-  if (event.altKey !== combo.alt) return false;
-  if (event.metaKey !== combo.meta) return false;
-  return event.key.toLowerCase() === combo.key;
+ * Options for registering a hotkey.
+ */
+interface HotkeyOptions {
+  /** Scope for the hotkey — only active when this scope is active. Default: 'global' */
+  scope?: string;
+  /** Whether to prevent default browser behavior — default: true */
+  preventDefault?: boolean;
+  /** Whether to stop event propagation — default: false */
+  stopPropagation?: boolean;
+  /** Whether the hotkey fires when an input/textarea/contenteditable is focused — default: false */
+  enableOnInputs?: boolean;
+  /** Description of what this hotkey does — useful for help dialogs */
+  description?: string;
+  /** Whether the hotkey is enabled — default: true */
+  enabled?: boolean | (() => boolean);
 }
 /**
-* Format a KeyCombo back to a human-readable string.
-*/
-function formatCombo(combo) {
-  const parts = [];
-  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) {
-  return s.charAt(0).toUpperCase() + s.slice(1);
-}
-function isMac() {
-  if (typeof navigator === "undefined") return false;
-  return /mac|iphone|ipad|ipod/i.test(navigator.userAgent);
+ * A registered hotkey entry.
+ */
+interface HotkeyEntry {
+  /** The original shortcut string (e.g. 'ctrl+s') */
+  shortcut: string;
+  /** Parsed key combination */
+  combo: KeyCombo;
+  /** The callback to invoke */
+  handler: (event: KeyboardEvent) => void;
+  /** Options */
+  options: Required<Pick<HotkeyOptions, 'scope' | 'preventDefault' | 'stopPropagation' | 'enableOnInputs' | 'enabled'>> & {
+    description?: string;
+  };
 }
-
 //#endregion
-//#region src/registry.ts
-
-function isInputFocused(event) {
-  const target = event.target;
-  if (!target) return false;
-  if (INPUT_TAGS.has(target.tagName)) return true;
-  if (target.isContentEditable) return true;
-  return false;
-}
-function attachListener() {
-  if (listenerAttached) return;
-  if (typeof window === "undefined") return;
-  listenerAttached = true;
-  window.addEventListener("keydown", event => {
-    const scopes = activeScopes.peek();
-    for (const entry of entries) {
-      if (!scopes.has(entry.options.scope)) continue;
-      if (!(typeof entry.options.enabled === "function" ? entry.options.enabled() : entry.options.enabled)) continue;
-      if (!entry.options.enableOnInputs && isInputFocused(event)) continue;
-      if (!matchesCombo(event, entry.combo)) continue;
-      if (entry.options.preventDefault) event.preventDefault();
-      if (entry.options.stopPropagation) event.stopPropagation();
-      entry.handler(event);
-    }
-  });
-}
+//#region src/use-hotkey.d.ts
 /**
-* Register a keyboard shortcut. Returns an unregister function.
-*
-* @example
-* ```ts
-* const unregister = registerHotkey('ctrl+s', (e) => save(), { description: 'Save' })
-* // later: unregister()
-* ```
-*/
-function registerHotkey(shortcut, handler, options) {
-  attachListener();
-  const entry = {
-    shortcut,
-    combo: parseShortcut(shortcut),
-    handler,
-    options: {
-      scope: options?.scope ?? "global",
-      preventDefault: options?.preventDefault !== false,
-      stopPropagation: options?.stopPropagation === true,
-      enableOnInputs: options?.enableOnInputs === true,
-      enabled: options?.enabled ?? true,
-      description: options?.description
-    }
-  };
-  entries.push(entry);
-  return () => {
-    const idx = entries.indexOf(entry);
-    if (idx !== -1) entries.splice(idx, 1);
-  };
-}
+ * Register a keyboard shortcut scoped to a component's lifecycle.
+ * Automatically unregisters when the component unmounts.
+ *
+ * @example
+ * ```ts
+ * function Editor() {
+ *   useHotkey('ctrl+s', () => save(), { description: 'Save document' })
+ *   useHotkey('ctrl+z', () => undo())
+ *   useHotkey('ctrl+shift+z', () => redo())
+ *   // ...
+ * }
+ * ```
+ */
+declare function useHotkey(shortcut: string, handler: (event: KeyboardEvent) => void, options?: HotkeyOptions): void;
+//#endregion
+//#region src/use-hotkey-scope.d.ts
 /**
-* Activate a hotkey scope. 'global' is always active.
-*/
-function enableScope(scope) {
-  const current = activeScopes.peek();
-  if (current.has(scope)) return;
-  const next = new Set(current);
-  next.add(scope);
-  activeScopes.set(next);
-}
+ * Activate a hotkey scope for the lifetime of a component.
+ * When the component unmounts, the scope is deactivated.
+ *
+ * @example
+ * ```tsx
+ * function Modal() {
+ *   useHotkeyScope('modal')
+ *   useHotkey('escape', () => closeModal(), { scope: 'modal' })
+ *   // ...
+ * }
+ * ```
+ */
+declare function useHotkeyScope(scope: string): void;
+//#endregion
+//#region src/registry.d.ts
 /**
-* Deactivate a hotkey scope. Cannot deactivate 'global'.
-*/
-function disableScope(scope) {
-  if (scope === "global") return;
-  const current = activeScopes.peek();
-  if (!current.has(scope)) return;
-  const next = new Set(current);
-  next.delete(scope);
-  activeScopes.set(next);
-}
+ * Register a keyboard shortcut. Returns an unregister function.
+ *
+ * @example
+ * ```ts
+ * const unregister = registerHotkey('ctrl+s', (e) => save(), { description: 'Save' })
+ * // later: unregister()
+ * ```
+ */
+declare function registerHotkey(shortcut: string, handler: (event: KeyboardEvent) => void, options?: HotkeyOptions): () => void;
 /**
-* Get the currently active scopes as a reactive signal.
-*/
-function getActiveScopes() {
-  return activeScopes;
-}
+ * Activate a hotkey scope. 'global' is always active.
+ */
+declare function enableScope(scope: string): void;
 /**
-* Get all registered hotkeys (for building help dialogs).
-*/
-function getRegisteredHotkeys() {
-  return entries.map(e => ({
-    shortcut: e.shortcut,
-    scope: e.options.scope,
-    description: e.options.description
-  }));
-}
-function _resetHotkeys() {
-  entries.length = 0;
-  activeScopes.set(new Set(["global"]));
-}
-
-//#endregion
-//#region src/use-hotkey.ts
+ * Deactivate a hotkey scope. Cannot deactivate 'global'.
+ */
+declare function disableScope(scope: string): void;
 /**
-* Register a keyboard shortcut scoped to a component's lifecycle.
-* Automatically unregisters when the component unmounts.
-*
-* @example
-* ```ts
-* function Editor() {
-*   useHotkey('ctrl+s', () => save(), { description: 'Save document' })
-*   useHotkey('ctrl+z', () => undo())
-*   useHotkey('ctrl+shift+z', () => redo())
-*   // ...
-* }
-* ```
-*/
-function useHotkey(shortcut, handler, options) {
-  onUnmount(registerHotkey(shortcut, handler, options));
-}
-
+ * Get the currently active scopes as a reactive signal.
+ */
+declare function getActiveScopes(): Signal<Set<string>>;
+/**
+ * Get all registered hotkeys (for building help dialogs).
+ */
+declare function getRegisteredHotkeys(): ReadonlyArray<{
+  shortcut: string;
+  scope: string;
+  description?: string;
+}>;
+declare function _resetHotkeys(): void;
 //#endregion
-//#region src/use-hotkey-scope.ts
+//#region src/parse.d.ts
 /**
-* Activate a hotkey scope for the lifetime of a component.
-* When the component unmounts, the scope is deactivated.
-*
-* @example
-* ```tsx
-* function Modal() {
-*   useHotkeyScope('modal')
-*   useHotkey('escape', () => closeModal(), { scope: 'modal' })
-*   // ...
-* }
-* ```
-*/
-function useHotkeyScope(scope) {
-  enableScope(scope);
-  onUnmount(() => disableScope(scope));
-}
-
+ * Parse a shortcut string like 'ctrl+shift+s' into a KeyCombo.
+ * Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).
+ */
+declare function parseShortcut(shortcut: string): KeyCombo;
+/**
+ * Check if a KeyboardEvent matches a KeyCombo.
+ */
+declare function matchesCombo(event: KeyboardEvent, combo: KeyCombo): boolean;
+/**
+ * Format a KeyCombo back to a human-readable string.
+ */
+declare function formatCombo(combo: KeyCombo): string;
 //#endregion
-export { _resetHotkeys, disableScope, enableScope, formatCombo, getActiveScopes, getRegisteredHotkeys, matchesCombo, parseShortcut, registerHotkey, useHotkey, useHotkeyScope };
-//# sourceMappingURL=index.d.ts.map
+export { type HotkeyEntry, type HotkeyOptions, type KeyCombo, _resetHotkeys, disableScope, enableScope, formatCombo, getActiveScopes, getRegisteredHotkeys, matchesCombo, parseShortcut, registerHotkey, useHotkey, useHotkeyScope };
+//# sourceMappingURL=index2.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/parse.ts","../../src/registry.ts","../../src/use-hotkey.ts","../../src/use-hotkey-scope.ts"],"mappings":"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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyreon/hotkeys",
-  "version": "0.6.0",
+  "version": "0.8.0",
   "description": "Reactive keyboard shortcut management for Pyreon — scope-aware, conflict detection",
   "license": "MIT",
   "repository": {
@@ -40,13 +40,7 @@
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@pyreon/core": ">=0.5.0 <1.0.0",
-    "@pyreon/reactivity": ">=0.5.0 <1.0.0"
-  },
-  "devDependencies": {
-    "@happy-dom/global-registrator": "^20.8.3",
-    "@pyreon/core": ">=0.5.0 <1.0.0",
-    "@pyreon/reactivity": ">=0.5.0 <1.0.0",
-    "@vitus-labs/tools-lint": "^1.11.0"
+    "@pyreon/core": ">=0.7.0 <0.8.0",
+    "@pyreon/reactivity": ">=0.7.0 <0.8.0"
   }
 }

package/src/registry.ts

@@ -84,7 +84,9 @@ export function registerHotkey(
       stopPropagation: options?.stopPropagation === true,
       enableOnInputs: options?.enableOnInputs === true,
       enabled: options?.enabled ?? true,
-      description: options?.description,
+      ...(options?.description != null
+        ? { description: options.description }
+        : {}),
     },
   }
 
@@ -139,7 +141,9 @@ export function getRegisteredHotkeys(): ReadonlyArray<{
   return entries.map((e) => ({
     shortcut: e.shortcut,
     scope: e.options.scope,
-    description: e.options.description,
+    ...(e.options.description != null
+      ? { description: e.options.description }
+      : {}),
   }))
 }
 

package/lib/types/index2.d.ts

@@ -1,130 +0,0 @@
-import { Signal } from "@pyreon/reactivity";
-
-//#region src/types.d.ts
-/**
- * A parsed key combination.
- * Example: 'ctrl+shift+s' → { ctrl: true, shift: true, alt: false, meta: false, key: 's' }
- */
-interface KeyCombo {
-  ctrl: boolean;
-  shift: boolean;
-  alt: boolean;
-  meta: boolean;
-  key: string;
-}
-/**
- * Options for registering a hotkey.
- */
-interface HotkeyOptions {
-  /** Scope for the hotkey — only active when this scope is active. Default: 'global' */
-  scope?: string;
-  /** Whether to prevent default browser behavior — default: true */
-  preventDefault?: boolean;
-  /** Whether to stop event propagation — default: false */
-  stopPropagation?: boolean;
-  /** Whether the hotkey fires when an input/textarea/contenteditable is focused — default: false */
-  enableOnInputs?: boolean;
-  /** Description of what this hotkey does — useful for help dialogs */
-  description?: string;
-  /** Whether the hotkey is enabled — default: true */
-  enabled?: boolean | (() => boolean);
-}
-/**
- * A registered hotkey entry.
- */
-interface HotkeyEntry {
-  /** The original shortcut string (e.g. 'ctrl+s') */
-  shortcut: string;
-  /** Parsed key combination */
-  combo: KeyCombo;
-  /** The callback to invoke */
-  handler: (event: KeyboardEvent) => void;
-  /** Options */
-  options: Required<Pick<HotkeyOptions, 'scope' | 'preventDefault' | 'stopPropagation' | 'enableOnInputs' | 'enabled'>> & {
-    description?: string;
-  };
-}
-//#endregion
-//#region src/use-hotkey.d.ts
-/**
- * Register a keyboard shortcut scoped to a component's lifecycle.
- * Automatically unregisters when the component unmounts.
- *
- * @example
- * ```ts
- * function Editor() {
- *   useHotkey('ctrl+s', () => save(), { description: 'Save document' })
- *   useHotkey('ctrl+z', () => undo())
- *   useHotkey('ctrl+shift+z', () => redo())
- *   // ...
- * }
- * ```
- */
-declare function useHotkey(shortcut: string, handler: (event: KeyboardEvent) => void, options?: HotkeyOptions): void;
-//#endregion
-//#region src/use-hotkey-scope.d.ts
-/**
- * Activate a hotkey scope for the lifetime of a component.
- * When the component unmounts, the scope is deactivated.
- *
- * @example
- * ```tsx
- * function Modal() {
- *   useHotkeyScope('modal')
- *   useHotkey('escape', () => closeModal(), { scope: 'modal' })
- *   // ...
- * }
- * ```
- */
-declare function useHotkeyScope(scope: string): void;
-//#endregion
-//#region src/registry.d.ts
-/**
- * Register a keyboard shortcut. Returns an unregister function.
- *
- * @example
- * ```ts
- * const unregister = registerHotkey('ctrl+s', (e) => save(), { description: 'Save' })
- * // later: unregister()
- * ```
- */
-declare function registerHotkey(shortcut: string, handler: (event: KeyboardEvent) => void, options?: HotkeyOptions): () => void;
-/**
- * Activate a hotkey scope. 'global' is always active.
- */
-declare function enableScope(scope: string): void;
-/**
- * Deactivate a hotkey scope. Cannot deactivate 'global'.
- */
-declare function disableScope(scope: string): void;
-/**
- * Get the currently active scopes as a reactive signal.
- */
-declare function getActiveScopes(): Signal<Set<string>>;
-/**
- * Get all registered hotkeys (for building help dialogs).
- */
-declare function getRegisteredHotkeys(): ReadonlyArray<{
-  shortcut: string;
-  scope: string;
-  description?: string;
-}>;
-declare function _resetHotkeys(): void;
-//#endregion
-//#region src/parse.d.ts
-/**
- * Parse a shortcut string like 'ctrl+shift+s' into a KeyCombo.
- * Supports aliases (esc, del, space, etc.) and mod (ctrl on Windows/Linux, meta on Mac).
- */
-declare function parseShortcut(shortcut: string): KeyCombo;
-/**
- * Check if a KeyboardEvent matches a KeyCombo.
- */
-declare function matchesCombo(event: KeyboardEvent, combo: KeyCombo): boolean;
-/**
- * Format a KeyCombo back to a human-readable string.
- */
-declare function formatCombo(combo: KeyCombo): string;
-//#endregion
-export { type HotkeyEntry, type HotkeyOptions, type KeyCombo, _resetHotkeys, disableScope, enableScope, formatCombo, getActiveScopes, getRegisteredHotkeys, matchesCombo, parseShortcut, registerHotkey, useHotkey, useHotkeyScope };
-//# sourceMappingURL=index2.d.ts.map

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

@@ -1 +0,0 @@
-{"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;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"}