TanStack
Hotkey Recorder API Reference

HotkeySequenceRecorderOptions

Defined in: hotkey-recorder.ts:69

Options for recording up to maxSteps chords. A one-step recording commits as a chord string; two or more steps commit as a sequence.

Extends

  • HotkeyRecorderBaseOptions

Properties

commitKeys?

ts
optional commitKeys?: HotkeyRecorderCommitKeys;

Defined in: hotkey-recorder.ts:80

Whether plain Enter commits the recorded steps. Default: 'enter'


detectConflicts?

ts
optional detectConflicts?: boolean | HotkeyConflictOptions;

Defined in: recorder-options.ts:21

Opt in to live-registry conflicts, including sequence prefixes. Default: false.

Inherited from

ts
HotkeyRecorderBaseOptions.detectConflicts

idleTimeoutMs?

ts
optional idleTimeoutMs?: number;

Defined in: hotkey-recorder.ts:82

Commit automatically after this many milliseconds without a new step. Disabled when unset or 0.


ignoreInputs?

ts
optional ignoreInputs?: boolean;

Defined in: hotkey-recorder.ts:49

Whether to ignore keyboard events from input-like elements (text inputs, textarea, select, contenteditable) while recording. When true, typing in inputs passes through normally (Escape still cancels). Defaults to true.

Inherited from

ts
HotkeyRecorderBaseOptions.ignoreInputs

maxSteps

ts
maxSteps: number;

Defined in: hotkey-recorder.ts:71

Maximum number of chords to record. Reaching it commits automatically. Use Infinity for no limit.


onCancel?

ts
optional onCancel?: () => void;

Defined in: hotkey-recorder.ts:38

Optional callback when recording is cancelled (Escape pressed)

Returns

void

Inherited from

ts
HotkeyRecorderBaseOptions.onCancel

onClear?

ts
optional onClear?: () => void;

Defined in: hotkey-recorder.ts:43

Optional callback when the recording is cleared: Backspace/Delete with no modifiers and no recorded steps

Returns

void

Inherited from

ts
HotkeyRecorderBaseOptions.onClear

onRecord

ts
onRecord: (hotkey) => void;

Defined in: hotkey-recorder.ts:78

Callback when a hotkey is successfully recorded

Parameters

hotkey

Hotkey

Returns

void


onReject?

ts
optional onReject?: (rejection) => void;

Defined in: recorder-options.ts:23

Rejected candidates leave recording active.

Parameters

rejection

RecorderRejection

Returns

void

Inherited from

ts
HotkeyRecorderBaseOptions.onReject

platform?

ts
optional platform?: "mac" | "windows" | "linux";

Defined in: recorder-options.ts:19

Platform used for Mod and AltGraph handling. Defaults to platform detection.

Inherited from

ts
HotkeyRecorderBaseOptions.platform

recordBy?

ts
optional recordBy?: RecorderKeyMode;

Defined in: recorder-options.ts:17

Physical code recording is the default. Choose key to record logical characters.

Inherited from

ts
HotkeyRecorderBaseOptions.recordBy

validate?

ts
optional validate?: (hotkey, context) => string | boolean;

Defined in: hotkey-recorder.ts:73

Return true to accept, or false/a message to reject while staying in recording mode.

Parameters

hotkey

Hotkey

context

HotkeyRecorderValidationContext

Returns

string | boolean