Function createHotkeySequence

packages/solid-hotkeys/src/createHotkeySequence.ts:64–155

(
  sequence: HotkeySequence | (() => HotkeySequence),
  callback: HotkeyCallback,
  options:
    | CreateHotkeySequenceOptions
    | (() => CreateHotkeySequenceOptions) = {},
)

 * ```
 */
export function createHotkeySequence(
  sequence: HotkeySequence | (() => HotkeySequence),
  callback: HotkeyCallback,
  options:
    | CreateHotkeySequenceOptions
    | (() => CreateHotkeySequenceOptions) = {},
): void {
  const defaultOptions = useDefaultHotkeysOptions()
  const manager = getSequenceManager()

  let registration: SequenceRegistrationHandle | null = null
  let lastSequenceKey: string | null = null
  let lastTarget: HTMLElement | Document | Window | null = null

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

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

    const mergedOptions = {
      ...defaultOptions.hotkeySequence,
      ...resolvedOptions,
    } as CreateHotkeySequenceOptions

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

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

    if (resolvedSequence.length === 0 || !resolvedTarget) {
      if (registration?.isActive) {
        registration.unregister()
        registration = null
      }
      lastSequenceKey = null
      lastTarget = null
      return
    }

    const sequenceKey = formatHotkeySequence(resolvedSequence)