Function createHotkeys

packages/solid-hotkeys/src/createHotkeys.ts:66–187

(
  hotkeys:
    | Array<CreateHotkeyDefinition>
    | (() => Array<CreateHotkeyDefinition>),
  commonOptions: CreateHotkeyOptions | (() => CreateHotkeyOptions) = {},
)

 * ```
 */
export function createHotkeys(
  hotkeys:
    | Array<CreateHotkeyDefinition>
    | (() => Array<CreateHotkeyDefinition>),
  commonOptions: CreateHotkeyOptions | (() => CreateHotkeyOptions) = {},
): void {
  type RegistrationRecord = {
    handle: HotkeyRegistrationHandle
    target: Document | HTMLElement | Window
  }

  const defaultOptions = useDefaultHotkeysOptions()
  const manager = getHotkeyManager()

  const registrations = new Map<string, RegistrationRecord>()

  // Clean up only when this component/scope disposes — not before every effect
  // re-run. An inner `onCleanup` inside `createEffect` runs whenever reactive
  // deps change (e.g. dynamic hotkey list), which unregistered every hotkey and
  // re-registered them, flooding the manager store and could freeze the tab.
  onCleanup(() => {
    for (const { handle } of registrations.values()) {
      if (handle.isActive) {
        handle.unregister()
      }
    }
    registrations.clear()
  })

  createEffect(() => {
    const resolvedHotkeys = typeof hotkeys === 'function' ? hotkeys() : hotkeys
    const resolvedCommonOptions =
      typeof commonOptions === 'function' ? commonOptions() : commonOptions

    const nextKeys = new Set<string>()
    const prepared: Array<{
      registrationKey: string
      def: CreateHotkeyDefinition
      mergedOptions: CreateHotkeyOptions
      hotkeyString: Hotkey
      resolvedTarget: Document | HTMLElement | Window
    }> = []

    for (let i = 0; i < resolvedHotkeys.length; i++) {
      const def = resolvedHotkeys[i]!
      const resolvedDefOptions = def.options ?? {}

      const mergedOptions = {
        ...defaultOptions.hotkey,
        ...resolvedCommonOptions,
        ...resolvedDefOptions,
      } as CreateHotkeyOptions

      const platform = mergedOptions.platform ?? detectPlatform()
      const hotkeyString = normalizeRegisterableHotkey(def.hotkey, platform)

      const resolvedTarget =
        'target' in mergedOptions