@tanstack/hotkeys 0.9.0 → 0.10.0

package/dist/hotkey-manager.d.cts

@@ -1,234 +0,0 @@
-import { ConflictBehavior, Hotkey, HotkeyCallback, HotkeyMeta, ParsedHotkey, RegisterableHotkey } from "./hotkey.types.cjs";
-import { Store } from "@tanstack/store";
-
-//#region src/hotkey-manager.d.ts
-/**
- * Options for registering a hotkey.
- */
-interface HotkeyOptions {
-  /** Behavior when this hotkey conflicts with an existing registration on the same target. Defaults to 'warn' */
-  conflictBehavior?: ConflictBehavior;
-  /**
-   * Soft-disable: when `false`, the callback does not run but the registration
-   * stays in `HotkeyManager` (and in devtools). Toggling this should update the
-   * existing handle via `setOptions` rather than unregistering. Defaults to `true`.
-   */
-  enabled?: boolean;
-  /** The event type to listen for. Defaults to 'keydown' */
-  eventType?: 'keydown' | 'keyup';
-  /** Whether to ignore hotkeys when keyboard events originate from input-like elements (text inputs, textarea, select, contenteditable — button-type inputs like type=button/submit/reset are not ignored). Defaults based on hotkey: true for single keys and Shift/Alt combos; false for Ctrl/Meta shortcuts and Escape */
-  ignoreInputs?: boolean;
-  /** The target platform for resolving 'Mod' */
-  platform?: 'mac' | 'windows' | 'linux';
-  /** Prevent the default browser action when the hotkey matches. Defaults to true */
-  preventDefault?: boolean;
-  /** If true, only trigger once until all keys are released. Default: false */
-  requireReset?: boolean;
-  /** Stop event propagation when the hotkey matches. Defaults to true */
-  stopPropagation?: boolean;
-  /** The DOM element to attach the event listener to. Defaults to document. */
-  target?: HTMLElement | Document | Window | null;
-  /** Optional metadata (name, description, custom fields via declaration merging) */
-  meta?: HotkeyMeta;
-}
-/**
- * A registered hotkey handler in the HotkeyManager.
- */
-interface HotkeyRegistration {
-  /** The callback to invoke */
-  callback: HotkeyCallback;
-  /** Whether this registration has fired and needs reset (for requireReset) */
-  hasFired: boolean;
-  /** The concrete key/code that activated a requireReset registration. */
-  activeMatch?: {
-    key: string;
-    code: string;
-  };
-  /** The original hotkey string */
-  hotkey: Hotkey;
-  /** Unique identifier for this registration */
-  id: string;
-  /** Options for this registration */
-  options: HotkeyOptions;
-  /** The parsed hotkey */
-  parsedHotkey: ParsedHotkey;
-  /** The resolved target element for this registration */
-  target: HTMLElement | Document | Window;
-  /** How many times this registration's callback has been triggered */
-  triggerCount: number;
-}
-/**
- * Public view of a hotkey registration for display and introspection.
- * Omits the callback function which is an internal implementation detail.
- */
-interface HotkeyRegistrationView {
-  /** The original hotkey string */
-  hotkey: Hotkey;
-  /** Unique identifier for this registration */
-  id: string;
-  /** Options for this registration */
-  options: HotkeyOptions;
-  /** The parsed hotkey */
-  parsedHotkey: ParsedHotkey;
-  /** The resolved target element for this registration */
-  target: HTMLElement | Document | Window;
-  /** How many times this registration's callback has been triggered */
-  triggerCount: number;
-  /** Whether this registration has fired and needs reset (for requireReset) */
-  hasFired: boolean;
-}
-/**
- * Creates a public view from an internal registration,
- * stripping the callback function.
- */
-declare function toHotkeyRegistrationView(reg: HotkeyRegistration): HotkeyRegistrationView;
-/**
- * A handle returned from HotkeyManager.register() that allows updating
- * the callback and options without re-registering the hotkey.
- *
- * @example
- * ```ts
- * const handle = manager.register('Mod+S', callback, options)
- *
- * // Update callback without re-registering (avoids stale closures)
- * handle.callback = newCallback
- *
- * // Update options without re-registering
- * handle.setOptions({ enabled: false })
- *
- * // Check if still active
- * if (handle.isActive) {
- *   // ...
- * }
- *
- * // Unregister when done
- * handle.unregister()
- * ```
- */
-interface HotkeyRegistrationHandle {
-  /**
-   * The callback function. Can be set directly to update without re-registering.
-   * This avoids stale closures when the callback references React state.
-   */
-  callback: HotkeyCallback;
-  /** Unique identifier for this registration */
-  readonly id: string;
-  /** Check if this registration is still active (not unregistered) */
-  readonly isActive: boolean;
-  /**
-   * Update options (merged with existing options).
-   * Useful for updating `enabled`, `preventDefault`, etc. without re-registering.
-   */
-  setOptions: (options: Partial<HotkeyOptions>) => void;
-  /** Unregister this hotkey */
-  unregister: () => void;
-}
-/**
- * Singleton manager for hotkey registrations.
- *
- * This class provides a centralized way to register and manage keyboard hotkeys.
- * It uses a single event listener for efficiency, regardless of how many hotkeys
- * are registered.
- *
- * @example
- * ```ts
- * const manager = HotkeyManager.getInstance()
- *
- * const unregister = manager.register('Mod+S', (event, context) => {
- *   console.log('Save triggered!')
- * })
- *
- * // Later, to unregister:
- * unregister()
- * ```
- */
-declare class HotkeyManager {
-  #private;
-  /**
-   * The TanStack Store containing all hotkey registrations.
-   * Use this to subscribe to registration changes or access current registrations.
-   *
-   * @example
-   * ```ts
-   * const manager = HotkeyManager.getInstance()
-   *
-   * // Subscribe to registration changes
-   * const unsubscribe = manager.registrations.subscribe(() => {
-   *   console.log('Registrations changed:', manager.registrations.state.size)
-   * })
-   *
-   * // Access current registrations
-   * for (const [id, reg] of manager.registrations.state) {
-   *   console.log(reg.hotkey, reg.options.enabled)
-   * }
-   * ```
-   */
-  readonly registrations: Store<Map<string, HotkeyRegistration>>;
-  private constructor();
-  /**
-   * Gets the singleton instance of HotkeyManager.
-   */
-  static getInstance(): HotkeyManager;
-  /**
-   * Resets the singleton instance. Useful for testing.
-   */
-  static resetInstance(): void;
-  /**
-   * Registers a hotkey handler and returns a handle for updating the registration.
-   *
-   * The returned handle allows updating the callback and options without
-   * re-registering, which is useful for avoiding stale closures in React.
-   *
-   * @param hotkey - The hotkey string (e.g., 'Mod+S') or RawHotkey object
-   * @param callback - The function to call when the hotkey is pressed
-   * @param options - Options for the hotkey behavior
-   * @returns A handle for managing the registration
-   *
-   * @example
-   * ```ts
-   * const handle = manager.register('Mod+S', callback)
-   *
-   * // Update callback without re-registering (avoids stale closures)
-   * handle.callback = newCallback
-   *
-   * // Update options
-   * handle.setOptions({ enabled: false })
-   *
-   * // Unregister when done
-   * handle.unregister()
-   * ```
-   */
-  register(hotkey: RegisterableHotkey, callback: HotkeyCallback, options?: HotkeyOptions): HotkeyRegistrationHandle;
-  /**
-   * Triggers a registration's callback programmatically from devtools.
-   * Creates a synthetic KeyboardEvent and invokes the callback.
-   *
-   * @param id - The registration ID to trigger
-   * @returns True if the registration was found and triggered
-   */
-  triggerRegistration(id: string): boolean;
-  /**
-   * Gets the number of registered hotkeys.
-   */
-  getRegistrationCount(): number;
-  /**
-   * Checks if a specific hotkey is registered.
-   *
-   * @param hotkey - The hotkey string to check
-   * @param target - Optional target element to match (if provided, both hotkey and target must match)
-   * @returns True if a matching registration exists
-   */
-  isRegistered(hotkey: Hotkey, target?: HTMLElement | Document | Window): boolean;
-  /**
-   * Destroys the manager and removes all listeners.
-   */
-  destroy(): void;
-}
-/**
- * Gets the singleton HotkeyManager instance.
- * Convenience function for accessing the manager.
- */
-declare function getHotkeyManager(): HotkeyManager;
-//#endregion
-export { HotkeyManager, HotkeyOptions, HotkeyRegistration, HotkeyRegistrationHandle, HotkeyRegistrationView, getHotkeyManager, toHotkeyRegistrationView };
-//# sourceMappingURL=hotkey-manager.d.cts.map

package/dist/hotkey-manager.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hotkey-manager.js","names":["#instance","#platform","#findConflictingRegistration","#unregister","#targetRegistrations","#ensureListenersForTarget","#removeListenersForTarget","#targetListeners","#createTargetKeyDownHandler","#createTargetKeyUpHandler","#shouldResetRegistration","#executeHotkeyCallback","#processTargetEvent"],"sources":["../src/hotkey-manager.ts"],"sourcesContent":["import { Store } from '@tanstack/store'\nimport { isRecordingEvent } from './_recording-guard'\nimport { areHotkeysEqual } from './match'\nimport { detectPlatform } from './platform'\nimport { normalizeKeyName } from './constants'\nimport { formatHotkey } from './format'\nimport { parseHotkey, rawHotkeyToParsedHotkey } from './parse'\nimport { matchKeyboardEvent } from './_match'\nimport {\n  defaultHotkeyOptions,\n  getDefaultIgnoreInputs,\n  handleConflict,\n  optionsEqual,\n} from './_registration'\nimport { isEventForTarget, shouldIgnoreInputEvent } from './_event-target'\nimport type {\n  ConflictBehavior,\n  Hotkey,\n  HotkeyCallback,\n  HotkeyCallbackContext,\n  HotkeyMeta,\n  ParsedHotkey,\n  RegisterableHotkey,\n} from './hotkey.types'\n\nexport type { ConflictBehavior }\n\n/**\n * Options for registering a hotkey.\n */\nexport interface HotkeyOptions {\n  /** Behavior when this hotkey conflicts with an existing registration on the same target. Defaults to 'warn' */\n  conflictBehavior?: ConflictBehavior\n  /**\n   * Soft-disable: when `false`, the callback does not run but the registration\n   * stays in `HotkeyManager` (and in devtools). Toggling this should update the\n   * existing handle via `setOptions` rather than unregistering. Defaults to `true`.\n   */\n  enabled?: boolean\n  /** The event type to listen for. Defaults to 'keydown' */\n  eventType?: 'keydown' | 'keyup'\n  /** Whether to ignore hotkeys when keyboard events originate from input-like elements (text inputs, textarea, select, contenteditable — button-type inputs like type=button/submit/reset are not ignored). Defaults based on hotkey: true for single keys and Shift/Alt combos; false for Ctrl/Meta shortcuts and Escape */\n  ignoreInputs?: boolean\n  /** The target platform for resolving 'Mod' */\n  platform?: 'mac' | 'windows' | 'linux'\n  /** Prevent the default browser action when the hotkey matches. Defaults to true */\n  preventDefault?: boolean\n  /** If true, only trigger once until all keys are released. Default: false */\n  requireReset?: boolean\n  /** Stop event propagation when the hotkey matches. Defaults to true */\n  stopPropagation?: boolean\n  /** The DOM element to attach the event listener to. Defaults to document. */\n  target?: HTMLElement | Document | Window | null\n  /** Optional metadata (name, description, custom fields via declaration merging) */\n  meta?: HotkeyMeta\n}\n\n/**\n * A registered hotkey handler in the HotkeyManager.\n */\nexport interface HotkeyRegistration {\n  /** The callback to invoke */\n  callback: HotkeyCallback\n  /** Whether this registration has fired and needs reset (for requireReset) */\n  hasFired: boolean\n  /** The concrete key/code that activated a requireReset registration. */\n  activeMatch?: { key: string; code: string }\n  /** The original hotkey string */\n  hotkey: Hotkey\n  /** Unique identifier for this registration */\n  id: string\n  /** Options for this registration */\n  options: HotkeyOptions\n  /** The parsed hotkey */\n  parsedHotkey: ParsedHotkey\n  /** The resolved target element for this registration */\n  target: HTMLElement | Document | Window\n  /** How many times this registration's callback has been triggered */\n  triggerCount: number\n}\n\n/**\n * Public view of a hotkey registration for display and introspection.\n * Omits the callback function which is an internal implementation detail.\n */\nexport interface HotkeyRegistrationView {\n  /** The original hotkey string */\n  hotkey: Hotkey\n  /** Unique identifier for this registration */\n  id: string\n  /** Options for this registration */\n  options: HotkeyOptions\n  /** The parsed hotkey */\n  parsedHotkey: ParsedHotkey\n  /** The resolved target element for this registration */\n  target: HTMLElement | Document | Window\n  /** How many times this registration's callback has been triggered */\n  triggerCount: number\n  /** Whether this registration has fired and needs reset (for requireReset) */\n  hasFired: boolean\n}\n\n/**\n * Creates a public view from an internal registration,\n * stripping the callback function.\n */\nexport function toHotkeyRegistrationView(\n  reg: HotkeyRegistration,\n): HotkeyRegistrationView {\n  return {\n    hotkey: reg.hotkey,\n    id: reg.id,\n    options: reg.options,\n    parsedHotkey: reg.parsedHotkey,\n    target: reg.target,\n    triggerCount: reg.triggerCount,\n    hasFired: reg.hasFired,\n  }\n}\n\n/**\n * A handle returned from HotkeyManager.register() that allows updating\n * the callback and options without re-registering the hotkey.\n *\n * @example\n * ```ts\n * const handle = manager.register('Mod+S', callback, options)\n *\n * // Update callback without re-registering (avoids stale closures)\n * handle.callback = newCallback\n *\n * // Update options without re-registering\n * handle.setOptions({ enabled: false })\n *\n * // Check if still active\n * if (handle.isActive) {\n *   // ...\n * }\n *\n * // Unregister when done\n * handle.unregister()\n * ```\n */\nexport interface HotkeyRegistrationHandle {\n  /**\n   * The callback function. Can be set directly to update without re-registering.\n   * This avoids stale closures when the callback references React state.\n   */\n  callback: HotkeyCallback\n  /** Unique identifier for this registration */\n  readonly id: string\n  /** Check if this registration is still active (not unregistered) */\n  readonly isActive: boolean\n  /**\n   * Update options (merged with existing options).\n   * Useful for updating `enabled`, `preventDefault`, etc. without re-registering.\n   */\n  setOptions: (options: Partial<HotkeyOptions>) => void\n  /** Unregister this hotkey */\n  unregister: () => void\n}\n\nlet registrationIdCounter = 0\n\n/**\n * Generates a unique ID for hotkey registrations.\n */\nfunction generateId(): string {\n  return `hotkey_${++registrationIdCounter}`\n}\n\n/**\n * Singleton manager for hotkey registrations.\n *\n * This class provides a centralized way to register and manage keyboard hotkeys.\n * It uses a single event listener for efficiency, regardless of how many hotkeys\n * are registered.\n *\n * @example\n * ```ts\n * const manager = HotkeyManager.getInstance()\n *\n * const unregister = manager.register('Mod+S', (event, context) => {\n *   console.log('Save triggered!')\n * })\n *\n * // Later, to unregister:\n * unregister()\n * ```\n */\nexport class HotkeyManager {\n  static #instance: HotkeyManager | null = null\n\n  /**\n   * The TanStack Store containing all hotkey registrations.\n   * Use this to subscribe to registration changes or access current registrations.\n   *\n   * @example\n   * ```ts\n   * const manager = HotkeyManager.getInstance()\n   *\n   * // Subscribe to registration changes\n   * const unsubscribe = manager.registrations.subscribe(() => {\n   *   console.log('Registrations changed:', manager.registrations.state.size)\n   * })\n   *\n   * // Access current registrations\n   * for (const [id, reg] of manager.registrations.state) {\n   *   console.log(reg.hotkey, reg.options.enabled)\n   * }\n   * ```\n   */\n  readonly registrations: Store<Map<string, HotkeyRegistration>> = new Store(\n    new Map(),\n  )\n  #platform: 'mac' | 'windows' | 'linux'\n  #targetListeners: Map<\n    HTMLElement | Document | Window,\n    {\n      keydown: (event: KeyboardEvent) => void\n      keyup: (event: KeyboardEvent) => void\n    }\n  > = new Map()\n  #targetRegistrations: Map<HTMLElement | Document | Window, Set<string>> =\n    new Map()\n\n  private constructor() {\n    this.#platform = detectPlatform()\n  }\n\n  /**\n   * Gets the singleton instance of HotkeyManager.\n   */\n  static getInstance(): HotkeyManager {\n    if (!HotkeyManager.#instance) {\n      HotkeyManager.#instance = new HotkeyManager()\n    }\n    return HotkeyManager.#instance\n  }\n\n  /**\n   * Resets the singleton instance. Useful for testing.\n   */\n  static resetInstance(): void {\n    if (HotkeyManager.#instance) {\n      HotkeyManager.#instance.destroy()\n      HotkeyManager.#instance = null\n    }\n  }\n\n  /**\n   * Registers a hotkey handler and returns a handle for updating the registration.\n   *\n   * The returned handle allows updating the callback and options without\n   * re-registering, which is useful for avoiding stale closures in React.\n   *\n   * @param hotkey - The hotkey string (e.g., 'Mod+S') or RawHotkey object\n   * @param callback - The function to call when the hotkey is pressed\n   * @param options - Options for the hotkey behavior\n   * @returns A handle for managing the registration\n   *\n   * @example\n   * ```ts\n   * const handle = manager.register('Mod+S', callback)\n   *\n   * // Update callback without re-registering (avoids stale closures)\n   * handle.callback = newCallback\n   *\n   * // Update options\n   * handle.setOptions({ enabled: false })\n   *\n   * // Unregister when done\n   * handle.unregister()\n   * ```\n   */\n  register(\n    hotkey: RegisterableHotkey,\n    callback: HotkeyCallback,\n    options: HotkeyOptions = {},\n  ): HotkeyRegistrationHandle {\n    // In SSR environments, return a no-op handle since there's no DOM to attach listeners to\n    if (typeof document === 'undefined' && !options.target) {\n      let currentCallback = callback\n      return {\n        id: generateId(),\n        unregister: () => {},\n        get callback() {\n          return currentCallback\n        },\n        set callback(newCallback: HotkeyCallback) {\n          currentCallback = newCallback\n        },\n        setOptions: () => {},\n        get isActive() {\n          return false\n        },\n      }\n    }\n\n    const id = generateId()\n    const platform = options.platform ?? this.#platform\n    const parsedHotkey =\n      typeof hotkey === 'string'\n        ? parseHotkey(hotkey, platform)\n        : rawHotkeyToParsedHotkey(hotkey, platform)\n    const hotkeyStr = (\n      typeof hotkey === 'string' ? hotkey : formatHotkey(parsedHotkey)\n    ) as Hotkey\n\n    // Resolve target: default to document if not provided\n    // Note: SSR case without explicit target is handled above\n    const target = options.target ?? document\n\n    // Resolve conflict behavior\n    const conflictBehavior = options.conflictBehavior ?? 'warn'\n\n    // Check for existing registrations with the same hotkey and target\n    const conflictingRegistration = this.#findConflictingRegistration(\n      hotkeyStr,\n      target,\n    )\n\n    if (conflictingRegistration) {\n      handleConflict(\n        conflictingRegistration.id,\n        hotkeyStr,\n        conflictBehavior,\n        (id) => this.#unregister(id),\n      )\n    }\n\n    const resolvedIgnoreInputs =\n      options.ignoreInputs ?? getDefaultIgnoreInputs(parsedHotkey)\n\n    const baseOptions = {\n      ...defaultHotkeyOptions,\n      requireReset: false,\n      ...options,\n      platform,\n    }\n\n    const registration: HotkeyRegistration = {\n      id,\n      hotkey: hotkeyStr,\n      parsedHotkey,\n      callback,\n      options: { ...baseOptions, ignoreInputs: resolvedIgnoreInputs },\n      hasFired: false,\n      triggerCount: 0,\n      target,\n    }\n\n    this.registrations.setState((prev) => new Map(prev).set(id, registration))\n\n    // Track registration for this target\n    if (!this.#targetRegistrations.has(target)) {\n      this.#targetRegistrations.set(target, new Set())\n    }\n    this.#targetRegistrations.get(target)!.add(id)\n\n    // Ensure listeners are attached for this target\n    this.#ensureListenersForTarget(target)\n\n    // Create and return the handle\n    const manager = this\n    const handle: HotkeyRegistrationHandle = {\n      get id() {\n        return id\n      },\n      unregister: () => {\n        manager.#unregister(id)\n      },\n      get callback() {\n        const reg = manager.registrations.state.get(id)\n        return reg?.callback ?? callback\n      },\n      set callback(newCallback: HotkeyCallback) {\n        const reg = manager.registrations.state.get(id)\n        if (reg) {\n          reg.callback = newCallback\n        }\n      },\n      setOptions: (newOptions: Partial<HotkeyOptions>) => {\n        manager.registrations.setState((prev) => {\n          const reg = prev.get(id)\n          if (\n            reg &&\n            !optionsEqual(reg.options, { ...reg.options, ...newOptions })\n          ) {\n            const next = new Map(prev)\n            next.set(id, { ...reg, options: { ...reg.options, ...newOptions } })\n            return next\n          }\n          return prev\n        })\n      },\n      get isActive() {\n        return manager.registrations.state.has(id)\n      },\n    }\n\n    return handle\n  }\n\n  /**\n   * Unregisters a hotkey by its registration ID.\n   */\n  #unregister(id: string): void {\n    const registration = this.registrations.state.get(id)\n    if (!registration) {\n      return\n    }\n\n    const target = registration.target\n\n    // Remove registration\n    this.registrations.setState((prev) => {\n      const next = new Map(prev)\n      next.delete(id)\n      return next\n    })\n\n    // Remove from target registrations tracking\n    const targetRegs = this.#targetRegistrations.get(target)\n    if (targetRegs) {\n      targetRegs.delete(id)\n      // If no more registrations for this target, remove listeners\n      if (targetRegs.size === 0) {\n        this.#removeListenersForTarget(target)\n      }\n    }\n  }\n\n  /**\n   * Ensures event listeners are attached for a specific target.\n   */\n  #ensureListenersForTarget(target: HTMLElement | Document | Window): void {\n    if (typeof document === 'undefined') {\n      return // SSR safety\n    }\n\n    // Skip if listeners already exist for this target\n    if (this.#targetListeners.has(target)) {\n      return\n    }\n\n    const keydownHandler = this.#createTargetKeyDownHandler(target)\n    const keyupHandler = this.#createTargetKeyUpHandler(target)\n\n    target.addEventListener('keydown', keydownHandler as EventListener)\n    target.addEventListener('keyup', keyupHandler as EventListener)\n\n    this.#targetListeners.set(target, {\n      keydown: keydownHandler,\n      keyup: keyupHandler,\n    })\n  }\n\n  /**\n   * Removes event listeners for a specific target.\n   */\n  #removeListenersForTarget(target: HTMLElement | Document | Window): void {\n    if (typeof document === 'undefined') {\n      return\n    }\n\n    const listeners = this.#targetListeners.get(target)\n    if (!listeners) {\n      return\n    }\n\n    target.removeEventListener('keydown', listeners.keydown as EventListener)\n    target.removeEventListener('keyup', listeners.keyup as EventListener)\n\n    this.#targetListeners.delete(target)\n    this.#targetRegistrations.delete(target)\n  }\n\n  /**\n   * Processes keyboard events for a specific target and event type.\n   */\n  #processTargetEvent(\n    event: KeyboardEvent,\n    target: HTMLElement | Document | Window,\n    eventType: 'keydown' | 'keyup',\n  ): void {\n    // Releases clear latches even when focus or enabled state now prevents callbacks.\n    if (eventType === 'keyup') {\n      for (const id of this.#targetRegistrations.get(target) ?? []) {\n        const registration = this.registrations.state.get(id)\n        if (\n          registration?.hasFired &&\n          this.#shouldResetRegistration(registration, event)\n        ) {\n          registration.hasFired = false\n          registration.activeMatch = undefined\n        }\n      }\n    }\n    if (isRecordingEvent(event)) return\n    const targetRegs = this.#targetRegistrations.get(target)\n    if (!targetRegs) {\n      return\n    }\n\n    const matches = new Map<string, ReturnType<typeof matchKeyboardEvent>>()\n    let bestScore = 0\n\n    // Exact logical/explicit-code matches outrank compatibility fallbacks.\n    for (const id of targetRegs) {\n      const registration = this.registrations.state.get(id)\n      if (\n        !registration ||\n        !registration.options.enabled ||\n        registration.options.eventType !== eventType ||\n        !isEventForTarget(event, target) ||\n        (registration.options.ignoreInputs !== false &&\n          shouldIgnoreInputEvent(event, target, registration.target))\n      ) {\n        continue\n      }\n      const result = matchKeyboardEvent(\n        event,\n        registration.parsedHotkey,\n        registration.options.platform,\n      )\n      if (result.matched) {\n        matches.set(id, result)\n        bestScore = Math.max(bestScore, result.score)\n      }\n    }\n\n    for (const id of targetRegs) {\n      const registration = this.registrations.state.get(id)\n      if (!registration) {\n        continue\n      }\n\n      // Check if event originated from or bubbled to this target\n      if (!isEventForTarget(event, target)) {\n        continue\n      }\n\n      if (!registration.options.enabled) {\n        continue\n      }\n\n      // Check if we should ignore input elements (defaults to true)\n      if (registration.options.ignoreInputs !== false) {\n        if (shouldIgnoreInputEvent(event, target, registration.target)) {\n          continue\n        }\n      }\n\n      // Handle keydown events\n      if (eventType === 'keydown') {\n        if (registration.options.eventType !== 'keydown') {\n          continue\n        }\n\n        const match = matches.get(id)\n\n        if (match?.matched && match.score === bestScore) {\n          // Always apply preventDefault/stopPropagation if the hotkey matches,\n          // even when requireReset is active and has already fired\n          if (registration.options.preventDefault) {\n            event.preventDefault()\n          }\n          if (registration.options.stopPropagation) {\n            event.stopPropagation()\n          }\n\n          // Only execute callback if requireReset is not active or hasn't fired yet\n          if (!registration.options.requireReset || !registration.hasFired) {\n            this.#executeHotkeyCallback(registration, event)\n\n            // Mark as fired if requireReset is enabled\n            if (registration.options.requireReset) {\n              registration.hasFired = true\n              registration.activeMatch = match.identity\n            }\n          }\n        }\n      }\n      // Handle keyup events\n      else {\n        if (registration.options.eventType === 'keyup') {\n          const match = matches.get(id)\n          if (match?.matched && match.score === bestScore) {\n            this.#executeHotkeyCallback(registration, event)\n          }\n        }\n      }\n    }\n  }\n\n  /**\n   * Executes a hotkey callback with proper event handling.\n   */\n  #executeHotkeyCallback(\n    registration: HotkeyRegistration,\n    event: KeyboardEvent,\n  ): void {\n    if (registration.options.preventDefault) {\n      event.preventDefault()\n    }\n    if (registration.options.stopPropagation) {\n      event.stopPropagation()\n    }\n\n    registration.triggerCount++\n\n    // Notify the store so subscribers (e.g. devtools) see the updated count.\n    // We create a new Map but keep the same registration reference to preserve\n    // identity for mutation-based fields like hasFired.\n    this.registrations.setState((prev) => new Map(prev))\n\n    const context: HotkeyCallbackContext = {\n      hotkey: registration.hotkey,\n      parsedHotkey: registration.parsedHotkey,\n    }\n\n    registration.callback(event, context)\n  }\n\n  /**\n   * Creates a keydown handler for a specific target.\n   */\n  #createTargetKeyDownHandler(\n    target: HTMLElement | Document | Window,\n  ): (event: KeyboardEvent) => void {\n    return (event: KeyboardEvent) => {\n      this.#processTargetEvent(event, target, 'keydown')\n    }\n  }\n\n  /**\n   * Creates a keyup handler for a specific target.\n   */\n  #createTargetKeyUpHandler(\n    target: HTMLElement | Document | Window,\n  ): (event: KeyboardEvent) => void {\n    return (event: KeyboardEvent) => {\n      this.#processTargetEvent(event, target, 'keyup')\n    }\n  }\n\n  /**\n   * Finds an existing registration with the same hotkey and target.\n   */\n  #findConflictingRegistration(\n    hotkey: Hotkey,\n    target: HTMLElement | Document | Window,\n  ): HotkeyRegistration | null {\n    for (const registration of this.registrations.state.values()) {\n      if (\n        areHotkeysEqual(\n          registration.hotkey,\n          hotkey,\n          registration.options.platform,\n        ) &&\n        registration.target === target\n      ) {\n        return registration\n      }\n    }\n    return null\n  }\n\n  /**\n   * Determines if a registration should be reset based on the keyup event.\n   */\n  #shouldResetRegistration(\n    registration: HotkeyRegistration,\n    event: KeyboardEvent,\n  ): boolean {\n    const parsed = registration.parsedHotkey\n    const releasedKey = normalizeKeyName(event.key)\n\n    if (\n      registration.activeMatch?.code &&\n      event.code === registration.activeMatch.code\n    ) {\n      return true\n    }\n\n    // Compare the release against the identity this binding actually stores.\n    if (parsed.code !== undefined) {\n      if (event.code === parsed.code) return true\n    } else {\n      const parsedKeyNormalized =\n        parsed.key.length === 1 ? parsed.key.toUpperCase() : parsed.key\n      const releasedKeyNormalized =\n        releasedKey.length === 1 ? releasedKey.toUpperCase() : releasedKey\n      if (releasedKeyNormalized === parsedKeyNormalized) return true\n    }\n\n    // Reset if any required modifier is released\n    // Use normalized key names and check against canonical modifier names\n    if (parsed.ctrl && releasedKey === 'Control') {\n      return true\n    }\n    if (parsed.shift && releasedKey === 'Shift') {\n      return true\n    }\n    if (parsed.alt && releasedKey === 'Alt') {\n      return true\n    }\n    if (parsed.meta && releasedKey === 'Meta') {\n      return true\n    }\n\n    return false\n  }\n\n  /**\n   * Triggers a registration's callback programmatically from devtools.\n   * Creates a synthetic KeyboardEvent and invokes the callback.\n   *\n   * @param id - The registration ID to trigger\n   * @returns True if the registration was found and triggered\n   */\n  triggerRegistration(id: string): boolean {\n    const registration = this.registrations.state.get(id)\n    if (!registration) {\n      return false\n    }\n\n    const parsed = registration.parsedHotkey\n    const syntheticEvent = new KeyboardEvent(\n      registration.options.eventType ?? 'keydown',\n      {\n        ...(parsed.code !== undefined\n          ? { code: parsed.code }\n          : { key: parsed.key }),\n        ctrlKey: parsed.ctrl,\n        shiftKey: parsed.shift,\n        altKey: parsed.alt,\n        metaKey: parsed.meta,\n        bubbles: true,\n        cancelable: true,\n      },\n    )\n\n    registration.triggerCount++\n\n    // Notify the store so subscribers (e.g. devtools) see the updated count\n    this.registrations.setState((prev) => new Map(prev))\n\n    registration.callback(syntheticEvent, {\n      hotkey: registration.hotkey,\n      parsedHotkey: registration.parsedHotkey,\n    })\n\n    return true\n  }\n\n  /**\n   * Gets the number of registered hotkeys.\n   */\n  getRegistrationCount(): number {\n    return this.registrations.state.size\n  }\n\n  /**\n   * Checks if a specific hotkey is registered.\n   *\n   * @param hotkey - The hotkey string to check\n   * @param target - Optional target element to match (if provided, both hotkey and target must match)\n   * @returns True if a matching registration exists\n   */\n  isRegistered(\n    hotkey: Hotkey,\n    target?: HTMLElement | Document | Window,\n  ): boolean {\n    for (const registration of this.registrations.state.values()) {\n      if (\n        areHotkeysEqual(\n          registration.hotkey,\n          hotkey,\n          registration.options.platform,\n        )\n      ) {\n        // If target is specified, both must match\n        if (target === undefined || registration.target === target) {\n          return true\n        }\n      }\n    }\n    return false\n  }\n\n  /**\n   * Destroys the manager and removes all listeners.\n   */\n  destroy(): void {\n    // Remove all target listeners\n    for (const target of this.#targetListeners.keys()) {\n      this.#removeListenersForTarget(target)\n    }\n\n    this.registrations.setState(() => new Map())\n    this.#targetListeners.clear()\n    this.#targetRegistrations.clear()\n  }\n}\n\n/**\n * Gets the singleton HotkeyManager instance.\n * Convenience function for accessing the manager.\n */\nexport function getHotkeyManager(): HotkeyManager {\n  return HotkeyManager.getInstance()\n}\n"],"mappings":"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"}

package/dist/hotkey-recorder.cjs

@@ -1,235 +0,0 @@
-const require_platform = require('./platform.cjs');
-const require__keyboard_event = require('./_keyboard-event.cjs');
-const require_parse = require('./parse.cjs');
-const require_validate = require('./validate.cjs');
-const require__recording_guard = require('./_recording-guard.cjs');
-const require__event_target = require('./_event-target.cjs');
-const require_conflicts = require('./conflicts.cjs');
-const require__recorder_chord = require('./_recorder-chord.cjs');
-let _tanstack_store = require("@tanstack/store");
-
-//#region src/hotkey-recorder.ts
-/**
-* Framework-agnostic class for recording keyboard shortcuts.
-*
-* This class handles all the complexity of capturing keyboard events,
-* converting them to hotkey strings, and handling edge cases like
-* Escape to cancel or Backspace/Delete to clear.
-*
-* State Management:
-* - Uses TanStack Store for reactive state management
-* - State can be accessed via `recorder.store.state` when using the class directly
-* - When using framework adapters (React), use `useSelector` hooks for reactive state
-*
-* @example
-* ```ts
-* const recorder = new HotkeyRecorder({
-*   onRecord: (hotkey) => {
-*     console.log('Recorded:', hotkey)
-*   },
-*   onCancel: () => {
-*     console.log('Recording cancelled')
-*   },
-* })
-*
-* // Start recording
-* recorder.start()
-*
-* // Access state directly
-* console.log(recorder.store.state.isRecording) // true
-*
-* // Subscribe to changes with TanStack Store
-* const unsubscribe = recorder.store.subscribe(() => {
-*   console.log('Recording:', recorder.store.state.isRecording)
-* })
-*
-* // Cleanup
-* recorder.destroy()
-* unsubscribe()
-* ```
-*/
-var HotkeyRecorder = class {
-	#keydownHandler = null;
-	#options;
-	#platform;
-	constructor(options) {
-		this.store = new _tanstack_store.Store({
-			isRecording: false,
-			recordedHotkey: null
-		});
-		this.#options = options;
-		this.#platform = require_platform.detectPlatform();
-	}
-	/**
-	* Updates the recorder options, including callbacks.
-	* This allows framework adapters to sync callback changes without recreating the recorder.
-	*/
-	setOptions(options) {
-		this.#options = {
-			...this.#options,
-			...options
-		};
-	}
-	/**
-	* Start recording a new hotkey.
-	*
-	* Sets up a keydown event listener that captures keyboard events
-	* and converts them to hotkey strings. Recording continues until
-	* a valid hotkey is recorded, Escape is pressed, or stop/cancel is called.
-	*/
-	start() {
-		if (this.#keydownHandler) return;
-		require__recording_guard.beginRecording(this);
-		this.store.setState(() => ({
-			isRecording: true,
-			recordedHotkey: null
-		}));
-		const handler = (event) => {
-			if (!this.#keydownHandler) return;
-			if (this.#options.ignoreInputs !== false && event.key !== "Escape" && require__event_target.shouldIgnoreInputEvent(event, document, document)) return;
-			const platform = this.#options.platform ?? this.#platform;
-			if (require__keyboard_event.normalizeKeyboardEvent(event, platform).isComposing) return;
-			require__recording_guard.captureRecordingEvent(event);
-			event.preventDefault();
-			event.stopPropagation();
-			if (event.repeat) return;
-			if (event.key === "Escape") {
-				this.cancel();
-				return;
-			}
-			if (event.key === "Backspace" || event.key === "Delete") {
-				if (!event.ctrlKey && !event.shiftKey && !event.altKey && !event.metaKey) {
-					this.stop();
-					this.#options.onClear?.();
-					return;
-				}
-			}
-			if (require_parse.isModifierKey(event.key) || event.key === "AltGraph") return;
-			const rejection = require__recorder_chord.chordRejection(event, {
-				...this.#options,
-				platform
-			});
-			if (rejection) {
-				this.#options.onReject?.(rejection);
-				return;
-			}
-			const finalHotkey = require__recorder_chord.hotkeyChordFromKeydown(event, platform, this.#options.recordBy);
-			if (finalHotkey === null) return;
-			const validation = require_validate.validateHotkey(finalHotkey);
-			if (!validation.valid) {
-				this.#options.onReject?.({
-					reason: "invalid",
-					message: validation.errors.join("; "),
-					hotkey: finalHotkey
-				});
-				return;
-			}
-			const accepted = this.#options.validate?.(finalHotkey, {
-				event,
-				parsedHotkey: require_parse.parseHotkey(finalHotkey, platform)
-			});
-			if (accepted !== void 0 && accepted !== true) {
-				this.#options.onReject?.({
-					reason: "validation",
-					message: typeof accepted === "string" ? accepted : "This shortcut is not allowed.",
-					hotkey: finalHotkey
-				});
-				return;
-			}
-			if (this.#options.detectConflicts) {
-				const conflicts = require_conflicts.findHotkeyConflicts(finalHotkey, {
-					...typeof this.#options.detectConflicts === "object" ? this.#options.detectConflicts : {},
-					platform,
-					events: [event]
-				});
-				if (conflicts.length) {
-					this.#options.onReject?.({
-						reason: "conflict",
-						message: "This shortcut conflicts with a registered binding.",
-						hotkey: finalHotkey,
-						conflicts
-					});
-					return;
-				}
-			}
-			require__recording_guard.endRecording(this);
-			const handlerToRemove = this.#keydownHandler;
-			if (handlerToRemove) {
-				this.#removeListener(handlerToRemove);
-				this.#keydownHandler = null;
-			}
-			this.store.setState(() => ({
-				isRecording: false,
-				recordedHotkey: finalHotkey
-			}));
-			this.#options.onRecord(finalHotkey);
-		};
-		this.#keydownHandler = handler;
-		this.#addListener(handler);
-	}
-	/**
-	* Stop recording (same as cancel, but doesn't call onCancel).
-	*
-	* Removes the event listener and resets the recording state.
-	*/
-	stop() {
-		require__recording_guard.endRecording(this);
-		if (this.#keydownHandler) {
-			this.#removeListener(this.#keydownHandler);
-			this.#keydownHandler = null;
-		}
-		this.store.setState(() => ({
-			isRecording: false,
-			recordedHotkey: null
-		}));
-	}
-	/**
-	* Cancel recording without saving.
-	*
-	* Removes the event listener, resets the recording state, and calls
-	* the onCancel callback if provided.
-	*/
-	cancel() {
-		require__recording_guard.endRecording(this);
-		if (this.#keydownHandler) {
-			this.#removeListener(this.#keydownHandler);
-			this.#keydownHandler = null;
-		}
-		this.store.setState(() => ({
-			isRecording: false,
-			recordedHotkey: null
-		}));
-		this.#options.onCancel?.();
-	}
-	/**
-	* Adds the keydown event listener to the document.
-	*/
-	#addListener(handler) {
-		if (typeof document === "undefined") return;
-		document.addEventListener("keydown", handler, true);
-	}
-	/**
-	* Removes the keydown event listener from the document.
-	*/
-	#removeListener(handler) {
-		if (typeof document === "undefined") return;
-		document.removeEventListener("keydown", handler, true);
-	}
-	/**
-	* Clean up event listeners and reset state.
-	*
-	* Call this when you're done with the recorder to ensure
-	* all event listeners are properly removed.
-	*/
-	destroy() {
-		this.stop();
-		this.store.setState(() => ({
-			isRecording: false,
-			recordedHotkey: null
-		}));
-	}
-};
-
-//#endregion
-exports.HotkeyRecorder = HotkeyRecorder;
-//# sourceMappingURL=hotkey-recorder.cjs.map

package/dist/hotkey-recorder.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"hotkey-recorder.cjs","names":["Store","#options","#platform","detectPlatform","#keydownHandler","shouldIgnoreInputEvent","normalizeKeyboardEvent","isModifierKey","chordRejection","hotkeyChordFromKeydown","validateHotkey","parseHotkey","findHotkeyConflicts","#removeListener","#addListener"],"sources":["../src/hotkey-recorder.ts"],"sourcesContent":["import { Store } from '@tanstack/store'\nimport { findHotkeyConflicts } from './conflicts'\nimport {\n  beginRecording,\n  captureRecordingEvent,\n  endRecording,\n} from './_recording-guard'\nimport { chordRejection, hotkeyChordFromKeydown } from './_recorder-chord'\nimport { normalizeKeyboardEvent } from './_keyboard-event'\nimport { isModifierKey, parseHotkey } from './parse'\nimport { validateHotkey } from './validate'\nimport { detectPlatform } from './platform'\nimport { shouldIgnoreInputEvent } from './_event-target'\nimport type {\n  HotkeyRecorderValidationContext,\n  RecorderOptions,\n} from './recorder-options'\nimport type { Hotkey } from './hotkey.types'\n\n/**\n * State interface for the HotkeyRecorder.\n */\nexport interface HotkeyRecorderState {\n  /** Whether recording is currently active */\n  isRecording: boolean\n  /** The currently recorded hotkey (for live preview) */\n  recordedHotkey: Hotkey | null\n}\n\n/**\n * Options for configuring a HotkeyRecorder instance.\n */\nexport interface HotkeyRecorderOptions extends RecorderOptions {\n  /** Return true to accept, or false/a message to reject while staying in recording mode. */\n  validate?: (\n    hotkey: Hotkey,\n    context: HotkeyRecorderValidationContext,\n  ) => boolean | string\n  /** Callback when a hotkey is successfully recorded */\n  onRecord: (hotkey: Hotkey) => void\n  /** Optional callback when recording is cancelled (Escape pressed) */\n  onCancel?: () => void\n  /** Optional callback when shortcut is cleared (Backspace/Delete pressed) */\n  onClear?: () => void\n  /**\n   * Whether to ignore keyboard events from input-like elements (text inputs,\n   * textarea, select, contenteditable). When true, typing in inputs passes\n   * through normally instead of being captured as a hotkey recording.\n   * Escape always works regardless of this setting.\n   * @default true\n   */\n  ignoreInputs?: boolean\n}\n\n/**\n * Framework-agnostic class for recording keyboard shortcuts.\n *\n * This class handles all the complexity of capturing keyboard events,\n * converting them to hotkey strings, and handling edge cases like\n * Escape to cancel or Backspace/Delete to clear.\n *\n * State Management:\n * - Uses TanStack Store for reactive state management\n * - State can be accessed via `recorder.store.state` when using the class directly\n * - When using framework adapters (React), use `useSelector` hooks for reactive state\n *\n * @example\n * ```ts\n * const recorder = new HotkeyRecorder({\n *   onRecord: (hotkey) => {\n *     console.log('Recorded:', hotkey)\n *   },\n *   onCancel: () => {\n *     console.log('Recording cancelled')\n *   },\n * })\n *\n * // Start recording\n * recorder.start()\n *\n * // Access state directly\n * console.log(recorder.store.state.isRecording) // true\n *\n * // Subscribe to changes with TanStack Store\n * const unsubscribe = recorder.store.subscribe(() => {\n *   console.log('Recording:', recorder.store.state.isRecording)\n * })\n *\n * // Cleanup\n * recorder.destroy()\n * unsubscribe()\n * ```\n */\nexport class HotkeyRecorder {\n  /**\n   * The TanStack Store instance containing the recorder state.\n   * Use this to subscribe to state changes or access current state.\n   */\n  readonly store: Store<HotkeyRecorderState> = new Store<HotkeyRecorderState>({\n    isRecording: false,\n    recordedHotkey: null,\n  })\n\n  #keydownHandler: ((event: KeyboardEvent) => void) | null = null\n  #options: HotkeyRecorderOptions\n  #platform: 'mac' | 'windows' | 'linux'\n\n  constructor(options: HotkeyRecorderOptions) {\n    this.#options = options\n    this.#platform = detectPlatform()\n  }\n\n  /**\n   * Updates the recorder options, including callbacks.\n   * This allows framework adapters to sync callback changes without recreating the recorder.\n   */\n  setOptions(options: Partial<HotkeyRecorderOptions>): void {\n    this.#options = {\n      ...this.#options,\n      ...options,\n    }\n  }\n\n  /**\n   * Start recording a new hotkey.\n   *\n   * Sets up a keydown event listener that captures keyboard events\n   * and converts them to hotkey strings. Recording continues until\n   * a valid hotkey is recorded, Escape is pressed, or stop/cancel is called.\n   */\n  start(): void {\n    // Prevent starting recording if already recording\n    if (this.#keydownHandler) {\n      return\n    }\n\n    beginRecording(this)\n    // Update store state\n    this.store.setState(() => ({\n      isRecording: true,\n      recordedHotkey: null,\n    }))\n\n    // Create keydown handler\n    const handler = (event: KeyboardEvent) => {\n      // Check if we're still recording (handler might be called after stop/cancel)\n      if (!this.#keydownHandler) {\n        return\n      }\n\n      // If ignoreInputs is enabled (default) and focus is in an input element,\n      // let the event pass through so the user can type normally.\n      // Escape is the exception — it should always cancel recording.\n      if (\n        this.#options.ignoreInputs !== false &&\n        event.key !== 'Escape' &&\n        shouldIgnoreInputEvent(event, document, document)\n      )\n        return\n\n      const platform = this.#options.platform ?? this.#platform\n      if (normalizeKeyboardEvent(event, platform).isComposing) return\n      captureRecordingEvent(event)\n      event.preventDefault()\n      event.stopPropagation()\n      if (event.repeat) return\n\n      // Handle Escape to cancel\n      if (event.key === 'Escape') {\n        this.cancel()\n        return\n      }\n\n      // Handle Backspace/Delete to clear shortcut\n      if (event.key === 'Backspace' || event.key === 'Delete') {\n        if (\n          !event.ctrlKey &&\n          !event.shiftKey &&\n          !event.altKey &&\n          !event.metaKey\n        ) {\n          this.stop()\n          this.#options.onClear?.()\n          return\n        }\n      }\n\n      if (isModifierKey(event.key) || event.key === 'AltGraph') return\n      const rejection = chordRejection(event, { ...this.#options, platform })\n      if (rejection) {\n        this.#options.onReject?.(rejection)\n        return\n      }\n      const finalHotkey = hotkeyChordFromKeydown(\n        event,\n        platform,\n        this.#options.recordBy,\n      )\n      if (finalHotkey === null) {\n        return\n      }\n\n      const validation = validateHotkey(finalHotkey)\n      if (!validation.valid) {\n        this.#options.onReject?.({\n          reason: 'invalid',\n          message: validation.errors.join('; '),\n          hotkey: finalHotkey,\n        })\n        return\n      }\n      const accepted = this.#options.validate?.(finalHotkey, {\n        event,\n        parsedHotkey: parseHotkey(finalHotkey, platform),\n      })\n      if (accepted !== undefined && accepted !== true) {\n        this.#options.onReject?.({\n          reason: 'validation',\n          message:\n            typeof accepted === 'string'\n              ? accepted\n              : 'This shortcut is not allowed.',\n          hotkey: finalHotkey,\n        })\n        return\n      }\n      if (this.#options.detectConflicts) {\n        const conflicts = findHotkeyConflicts(finalHotkey, {\n          ...(typeof this.#options.detectConflicts === 'object'\n            ? this.#options.detectConflicts\n            : {}),\n          platform,\n          events: [event],\n        })\n        if (conflicts.length) {\n          this.#options.onReject?.({\n            reason: 'conflict',\n            message: 'This shortcut conflicts with a registered binding.',\n            hotkey: finalHotkey,\n            conflicts,\n          })\n          return\n        }\n      }\n      endRecording(this)\n      // Remove listener FIRST to prevent any additional events\n      const handlerToRemove = this.#keydownHandler as\n        | ((event: KeyboardEvent) => void)\n        | null\n      if (handlerToRemove) {\n        this.#removeListener(handlerToRemove)\n        this.#keydownHandler = null\n      }\n\n      // Update store state immediately\n      this.store.setState(() => ({\n        isRecording: false,\n        recordedHotkey: finalHotkey,\n      }))\n\n      // Call callback AFTER listener is removed and state is set\n      this.#options.onRecord(finalHotkey)\n    }\n\n    this.#keydownHandler = handler\n    this.#addListener(handler)\n  }\n\n  /**\n   * Stop recording (same as cancel, but doesn't call onCancel).\n   *\n   * Removes the event listener and resets the recording state.\n   */\n  stop(): void {\n    endRecording(this)\n    // Remove event listener immediately\n    if (this.#keydownHandler) {\n      this.#removeListener(this.#keydownHandler)\n      this.#keydownHandler = null\n    }\n\n    // Update store state\n    this.store.setState(() => ({\n      isRecording: false,\n      recordedHotkey: null,\n    }))\n  }\n\n  /**\n   * Cancel recording without saving.\n   *\n   * Removes the event listener, resets the recording state, and calls\n   * the onCancel callback if provided.\n   */\n  cancel(): void {\n    endRecording(this)\n    // Remove event listener immediately\n    if (this.#keydownHandler) {\n      this.#removeListener(this.#keydownHandler)\n      this.#keydownHandler = null\n    }\n\n    // Update store state\n    this.store.setState(() => ({\n      isRecording: false,\n      recordedHotkey: null,\n    }))\n\n    // Call cancel callback\n    this.#options.onCancel?.()\n  }\n\n  /**\n   * Adds the keydown event listener to the document.\n   */\n  #addListener(handler: (event: KeyboardEvent) => void): void {\n    if (typeof document === 'undefined') {\n      return // SSR safety\n    }\n\n    document.addEventListener('keydown', handler, true)\n  }\n\n  /**\n   * Removes the keydown event listener from the document.\n   */\n  #removeListener(handler: (event: KeyboardEvent) => void): void {\n    if (typeof document === 'undefined') {\n      return\n    }\n\n    document.removeEventListener('keydown', handler, true)\n  }\n\n  /**\n   * Clean up event listeners and reset state.\n   *\n   * Call this when you're done with the recorder to ensure\n   * all event listeners are properly removed.\n   */\n  destroy(): void {\n    this.stop()\n    this.store.setState(() => ({\n      isRecording: false,\n      recordedHotkey: null,\n    }))\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6FA,IAAa,iBAAb,MAA4B;CAU1B,kBAA2D;CAC3D;CACA;CAEA,YAAY,SAAgC;eATC,IAAIA,sBAA2B;GAC1E,aAAa;GACb,gBAAgB;GACjB,CAAC;AAOA,QAAKC,UAAW;AAChB,QAAKC,WAAYC,iCAAgB;;;;;;CAOnC,WAAW,SAA+C;AACxD,QAAKF,UAAW;GACd,GAAG,MAAKA;GACR,GAAG;GACJ;;;;;;;;;CAUH,QAAc;AAEZ,MAAI,MAAKG,eACP;AAGF,0CAAe,KAAK;AAEpB,OAAK,MAAM,gBAAgB;GACzB,aAAa;GACb,gBAAgB;GACjB,EAAE;EAGH,MAAM,WAAW,UAAyB;AAExC,OAAI,CAAC,MAAKA,eACR;AAMF,OACE,MAAKH,QAAS,iBAAiB,SAC/B,MAAM,QAAQ,YACdI,6CAAuB,OAAO,UAAU,SAAS,CAEjD;GAEF,MAAM,WAAW,MAAKJ,QAAS,YAAY,MAAKC;AAChD,OAAII,+CAAuB,OAAO,SAAS,CAAC,YAAa;AACzD,kDAAsB,MAAM;AAC5B,SAAM,gBAAgB;AACtB,SAAM,iBAAiB;AACvB,OAAI,MAAM,OAAQ;AAGlB,OAAI,MAAM,QAAQ,UAAU;AAC1B,SAAK,QAAQ;AACb;;AAIF,OAAI,MAAM,QAAQ,eAAe,MAAM,QAAQ,UAC7C;QACE,CAAC,MAAM,WACP,CAAC,MAAM,YACP,CAAC,MAAM,UACP,CAAC,MAAM,SACP;AACA,UAAK,MAAM;AACX,WAAKL,QAAS,WAAW;AACzB;;;AAIJ,OAAIM,4BAAc,MAAM,IAAI,IAAI,MAAM,QAAQ,WAAY;GAC1D,MAAM,YAAYC,uCAAe,OAAO;IAAE,GAAG,MAAKP;IAAU;IAAU,CAAC;AACvE,OAAI,WAAW;AACb,UAAKA,QAAS,WAAW,UAAU;AACnC;;GAEF,MAAM,cAAcQ,+CAClB,OACA,UACA,MAAKR,QAAS,SACf;AACD,OAAI,gBAAgB,KAClB;GAGF,MAAM,aAAaS,gCAAe,YAAY;AAC9C,OAAI,CAAC,WAAW,OAAO;AACrB,UAAKT,QAAS,WAAW;KACvB,QAAQ;KACR,SAAS,WAAW,OAAO,KAAK,KAAK;KACrC,QAAQ;KACT,CAAC;AACF;;GAEF,MAAM,WAAW,MAAKA,QAAS,WAAW,aAAa;IACrD;IACA,cAAcU,0BAAY,aAAa,SAAS;IACjD,CAAC;AACF,OAAI,aAAa,UAAa,aAAa,MAAM;AAC/C,UAAKV,QAAS,WAAW;KACvB,QAAQ;KACR,SACE,OAAO,aAAa,WAChB,WACA;KACN,QAAQ;KACT,CAAC;AACF;;AAEF,OAAI,MAAKA,QAAS,iBAAiB;IACjC,MAAM,YAAYW,sCAAoB,aAAa;KACjD,GAAI,OAAO,MAAKX,QAAS,oBAAoB,WACzC,MAAKA,QAAS,kBACd,EAAE;KACN;KACA,QAAQ,CAAC,MAAM;KAChB,CAAC;AACF,QAAI,UAAU,QAAQ;AACpB,WAAKA,QAAS,WAAW;MACvB,QAAQ;MACR,SAAS;MACT,QAAQ;MACR;MACD,CAAC;AACF;;;AAGJ,yCAAa,KAAK;GAElB,MAAM,kBAAkB,MAAKG;AAG7B,OAAI,iBAAiB;AACnB,UAAKS,eAAgB,gBAAgB;AACrC,UAAKT,iBAAkB;;AAIzB,QAAK,MAAM,gBAAgB;IACzB,aAAa;IACb,gBAAgB;IACjB,EAAE;AAGH,SAAKH,QAAS,SAAS,YAAY;;AAGrC,QAAKG,iBAAkB;AACvB,QAAKU,YAAa,QAAQ;;;;;;;CAQ5B,OAAa;AACX,wCAAa,KAAK;AAElB,MAAI,MAAKV,gBAAiB;AACxB,SAAKS,eAAgB,MAAKT,eAAgB;AAC1C,SAAKA,iBAAkB;;AAIzB,OAAK,MAAM,gBAAgB;GACzB,aAAa;GACb,gBAAgB;GACjB,EAAE;;;;;;;;CASL,SAAe;AACb,wCAAa,KAAK;AAElB,MAAI,MAAKA,gBAAiB;AACxB,SAAKS,eAAgB,MAAKT,eAAgB;AAC1C,SAAKA,iBAAkB;;AAIzB,OAAK,MAAM,gBAAgB;GACzB,aAAa;GACb,gBAAgB;GACjB,EAAE;AAGH,QAAKH,QAAS,YAAY;;;;;CAM5B,aAAa,SAA+C;AAC1D,MAAI,OAAO,aAAa,YACtB;AAGF,WAAS,iBAAiB,WAAW,SAAS,KAAK;;;;;CAMrD,gBAAgB,SAA+C;AAC7D,MAAI,OAAO,aAAa,YACtB;AAGF,WAAS,oBAAoB,WAAW,SAAS,KAAK;;;;;;;;CASxD,UAAgB;AACd,OAAK,MAAM;AACX,OAAK,MAAM,gBAAgB;GACzB,aAAa;GACb,gBAAgB;GACjB,EAAE"}