Function advanceSequence

packages/app-core/src/lib/keymaps.ts:1496–1545

(
  event: KeyboardEvent,
  binding: string,
  pendingRef: { current: number },
  timerRef: { current?: ReturnType<typeof setTimeout> },
  onMatch: () => void,
  consume: () => void,
  timeoutMs = 500,
)

}

export function advanceSequence(
  event: KeyboardEvent,
  binding: string,
  pendingRef: { current: number },
  timerRef: { current?: ReturnType<typeof setTimeout> },
  onMatch: () => void,
  consume: () => void,
  timeoutMs = 500,
): boolean {
  const tokens = binding
    .split(/\s+/)
    .map((token) => token.trim())
    .filter(Boolean);
  if (tokens.length === 0) return false;
  const token = sequenceTokenFromEvent(event);
  if (!token) return false;

  const reset = (): void => {
    pendingRef.current = 0;
    if (timerRef.current) clearTimeout(timerRef.current);
    timerRef.current = undefined;
  };

  if (pendingRef.current > 0) {
    if (token === tokens[pendingRef.current]) {
      consume();
      pendingRef.current += 1;
      if (pendingRef.current >= tokens.length) {
        reset();
        onMatch();
      } else {
        if (timerRef.current) clearTimeout(timerRef.current);
        timerRef.current = setTimeout(reset, timeoutMs);
      }
      return true;
    }
    reset();
  }

  if (token !== tokens[0]) return false;
  consume();
  if (tokens.length === 1) {
    onMatch();
    return true;
  }
  pendingRef.current = 1;
  if (timerRef.current) clearTimeout(timerRef.current);
  timerRef.current = setTimeout(reset, timeoutMs);
  return true;
}