Function handler

web/hooks/useKeyboardShortcuts.ts:38–93

(e: KeyboardEvent)

    };

    const handler = (e: KeyboardEvent) => {
      // Ignore bare modifier keypresses
      if (["Meta", "Control", "Shift", "Alt"].includes(e.key)) return;

      const inInput = isTypingTarget(e.target);
      const commands = commandsRef.current;

      // --- Sequence matching (e.g. "g" then "d") ---
      if (pendingSequenceRef.current) {
        const seq = `${pendingSequenceRef.current} ${e.key.toLowerCase()}`;
        const match = commands.find(
          (cmd) =>
            (!inInput || cmd.global) &&
            (!cmd.when || cmd.when()) &&
            cmd.keys.includes(seq)
        );
        clearSequence();
        if (match) {
          e.preventDefault();
          match.action();
          return;
        }
      }

      // --- Single combo matching ---
      const singleMatch = commands.find((cmd) => {
        if (inInput && !cmd.global) return false;
        if (cmd.when && !cmd.when()) return false;
        return cmd.keys.some((k) => {
          // Sequence keys contain a space; skip them in the single pass
          if (k.includes(" ")) return false;
          return matchesEvent(parseKey(k), e);
        });
      });

      if (singleMatch) {
        e.preventDefault();
        singleMatch.action();
        return;
      }

      // --- Start-of-sequence detection (single bare key that starts a sequence) ---
      // Only when not in an input and no modifier held
      if (!inInput && !e.metaKey && !e.ctrlKey && !e.altKey) {
        const keyLower = e.key.toLowerCase();
        const startsSequence = commands.some((cmd) =>
          cmd.keys.some((k) => k.includes(" ") && k.startsWith(keyLower + " "))
        );
        if (startsSequence) {
          e.preventDefault();
          clearSequence();
          pendingSequenceRef.current = keyLower;
          sequenceTimerRef.current = setTimeout(clearSequence, SEQUENCE_TIMEOUT_MS);
        }
      }
    };

    document.addEventListener("keydown", handler);