@pyreon/hotkeys 0.6.0 → 0.7.0

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;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,6 +1,6 @@
 {
   "name": "@pyreon/hotkeys",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Reactive keyboard shortcut management for Pyreon — scope-aware, conflict detection",
   "license": "MIT",
   "repository": {
@@ -42,11 +42,5 @@
   "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"
   }
 }

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