Method triggerSequence

packages/hotkeys/src/sequence-manager.ts:588–626

* Triggers a sequence's callback programmatically from devtools. * Creates a synthetic KeyboardEvent from the last key in the sequence. * * @param id - The registration ID to trigger * @returns True if the registration was found and triggered

(id: string)

   * @returns True if the registration was found and triggered
   */
  triggerSequence(id: string): boolean {
    const registration = this.#registrations.get(id)
    if (!registration) {
      return false
    }

    const lastParsed =
      registration.parsedSequence[registration.parsedSequence.length - 1]
    if (!lastParsed) {
      return false
    }

    const syntheticEvent = new KeyboardEvent(
      registration.options.eventType ?? 'keydown',
      {
        key: lastParsed.key,
        ctrlKey: lastParsed.ctrl,
        shiftKey: lastParsed.shift,
        altKey: lastParsed.alt,
        metaKey: lastParsed.meta,
        bubbles: true,
        cancelable: true,
      },
    )

    registration.triggerCount++
    registration.hasFired = true

    this.#syncRegistrationView(registration)

    const context: HotkeyCallbackContext = {
      hotkey: registration.sequence.join(' ') as Hotkey,
      parsedHotkey: lastParsed,
    }

    registration.callback(syntheticEvent, context)

    return true
  }

  /**
   * Gets the number of registered sequences.