Function createHotkey

packages/solid-hotkeys/src/createHotkey.ts:82–172

(
  hotkey: RegisterableHotkey | (() => RegisterableHotkey),
  callback: HotkeyCallback,
  options: CreateHotkeyOptions | (() => CreateHotkeyOptions) = {},
)

 * ```
 */
export function createHotkey(
  hotkey: RegisterableHotkey | (() => RegisterableHotkey),
  callback: HotkeyCallback,
  options: CreateHotkeyOptions | (() => CreateHotkeyOptions) = {},
): void {
  const defaultOptions = useDefaultHotkeysOptions()
  const manager = getHotkeyManager()

  let registration: HotkeyRegistrationHandle | null = null
  let lastHotkeyString: Hotkey | null = null
  let lastTarget: HTMLElement | Document | Window | null = null

  onCleanup(() => {
    if (registration?.isActive) {
      registration.unregister()
      registration = null
    }
    lastHotkeyString = null
    lastTarget = null
  })

  createEffect(() => {
    // Resolve reactive values
    const resolvedHotkey = typeof hotkey === 'function' ? hotkey() : hotkey
    const resolvedOptions = typeof options === 'function' ? options() : options

    const mergedOptions = {
      ...defaultOptions.hotkey,
      ...resolvedOptions,
    }

    // Normalize to hotkey string
    const platform = mergedOptions.platform ?? detectPlatform()
    const hotkeyString = normalizeRegisterableHotkey(resolvedHotkey, platform)

    // Resolve target: when explicitly provided (even as null), use it and skip if null.
    // When not provided, default to document. Matches React's ref handling.
    const resolvedTarget =
      'target' in mergedOptions
        ? (mergedOptions.target ?? null)
        : typeof document !== 'undefined'
          ? document
          : null

    if (!resolvedTarget) {
      if (registration?.isActive) {
        registration.unregister()
        registration = null
      }
      lastHotkeyString = null
      lastTarget = null
      return
    }

    // Extract options without target (target is handled separately)
    const { target: _target, ...optionsWithoutTarget } = mergedOptions

    // Untrack store mutations so that registering/updating the hotkey doesn't