Function routeKeyEvent

packages/core/src/keybindings/manager.ts:654–693

(
  state: KeybindingManagerState<KeyContext<S>>,
  event: ZrevEvent,
  context: KeyContext<S>,
)

 * @returns New state and consumed flag
 */
export function routeKeyEvent<S>(
  state: KeybindingManagerState<KeyContext<S>>,
  event: ZrevEvent,
  context: KeyContext<S>,
): RouteKeyResult<KeyContext<S>> {
  // Only handle key down events
  if (event.kind !== "key" || event.action !== "down") {
    return { nextState: state, consumed: false };
  }

  // Convert event to ParsedKey
  const key: ParsedKey = { key: event.key, mods: modsFromBitmask(event.mods) };

  // Match in current mode chain
  const { nextChordState, result } = matchInModeChain(state, key, event.timeMs, context);

  const nextState: KeybindingManagerState<KeyContext<S>> = Object.freeze({
    ...state,
    chordState: nextChordState,
  });

  if (result.kind === "matched") {
    // Execute handler
    try {
      result.binding.handler(context);
    } catch (e) {
      // Return error to caller instead of logging
      return { nextState, consumed: true, handlerError: e };
    }
    return { nextState, consumed: true };
  }

  if (result.kind === "pending") {
    // Chord in progress, consume the key
    return { nextState, consumed: true };
  }

  // No match
  return { nextState, consumed: false };
}

// Re-export for convenience
export { CHORD_TIMEOUT_MS };