@pyreon/hotkeys 0.6.0

package/lib/index.js

@@ -0,0 +1,221 @@
+import { onUnmount } from "@pyreon/core";
+import { signal } from "@pyreon/reactivity";
+
+//#region src/parse.ts
+const KEY_ALIASES = {
+	esc: "escape",
+	return: "enter",
+	del: "delete",
+	ins: "insert",
+	space: " ",
+	spacebar: " ",
+	up: "arrowup",
+	down: "arrowdown",
+	left: "arrowleft",
+	right: "arrowright",
+	plus: "+"
+};
+/**
+* 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;
+}
+/**
+* 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;
+}
+/**
+* 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);
+}
+
+//#endregion
+//#region src/registry.ts
+const entries = [];
+const activeScopes = signal(new Set(["global"]));
+let listenerAttached = false;
+const INPUT_TAGS = new Set([
+	"INPUT",
+	"TEXTAREA",
+	"SELECT"
+]);
+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);
+		}
+	});
+}
+/**
+* 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);
+	};
+}
+/**
+* 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);
+}
+/**
+* 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);
+}
+/**
+* Get the currently active scopes as a reactive signal.
+*/
+function getActiveScopes() {
+	return activeScopes;
+}
+/**
+* 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
+/**
+* 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));
+}
+
+//#endregion
+//#region src/use-hotkey-scope.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));
+}
+
+//#endregion
+export { _resetHotkeys, disableScope, enableScope, formatCombo, getActiveScopes, getRegisteredHotkeys, matchesCombo, parseShortcut, registerHotkey, useHotkey, useHotkeyScope };
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/types/index.d.ts

@@ -0,0 +1,198 @@
+import { onUnmount } from "@pyreon/core";
+import { signal } from "@pyreon/reactivity";
+
+//#region src/parse.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;
+}
+/**
+* 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;
+}
+/**
+* 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);
+}
+
+//#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);
+    }
+  });
+}
+/**
+* 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);
+  };
+}
+/**
+* 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);
+}
+/**
+* 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);
+}
+/**
+* Get the currently active scopes as a reactive signal.
+*/
+function getActiveScopes() {
+  return activeScopes;
+}
+/**
+* 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
+/**
+* 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));
+}
+
+//#endregion
+//#region src/use-hotkey-scope.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));
+}
+
+//#endregion
+export { _resetHotkeys, disableScope, enableScope, formatCombo, getActiveScopes, getRegisteredHotkeys, matchesCombo, parseShortcut, registerHotkey, useHotkey, useHotkeyScope };
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/types/index2.d.ts

@@ -0,0 +1,130 @@
+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

@@ -0,0 +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;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

@@ -0,0 +1,52 @@
+{
+  "name": "@pyreon/hotkeys",
+  "version": "0.6.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"
+  },
+  "homepage": "https://github.com/pyreon/fundamentals/tree/main/packages/hotkeys#readme",
+  "bugs": {
+    "url": "https://github.com/pyreon/fundamentals/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "module": "./lib/index.js",
+  "types": "./lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./lib/index.js",
+      "types": "./lib/types/index.d.ts"
+    }
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "vl_rolldown_build",
+    "dev": "vl_rolldown_build-watch",
+    "test": "vitest run",
+    "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"
+  }
+}