HotkeyChordRecorderOptions

Defined in: hotkey-recorder.ts:53

Options for recording a single chord. This is the default (maxSteps: 1).

Extends#

• HotkeyRecorderBaseOptions

Properties#

detectConflicts?#

optional detectConflicts?: boolean | HotkeyConflictOptions;

Defined in: recorder-options.ts:21

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

Inherited from#

HotkeyRecorderBaseOptions.detectConflicts

ignoreInputs?#

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#

HotkeyRecorderBaseOptions.ignoreInputs

maxSteps?#

optional maxSteps?: 1;

Defined in: hotkey-recorder.ts:55

Maximum number of chords to record. Default: 1

onCancel?#

optional onCancel?: () => void;

Defined in: hotkey-recorder.ts:38

Optional callback when recording is cancelled (Escape pressed)

Returns#

void

Inherited from#

HotkeyRecorderBaseOptions.onCancel

onClear?#

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#

HotkeyRecorderBaseOptions.onClear

onRecord#

onRecord: (hotkey) => void;

Defined in: hotkey-recorder.ts:62

Callback when a chord is successfully recorded

Parameters#

hotkey#

HotkeyChord

Returns#

void

onReject?#

optional onReject?: (rejection) => void;

Defined in: recorder-options.ts:23

Rejected candidates leave recording active.

Parameters#

rejection#

RecorderRejection

Returns#

void

Inherited from#

HotkeyRecorderBaseOptions.onReject

platform?#

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

Defined in: recorder-options.ts:19

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

Inherited from#

HotkeyRecorderBaseOptions.platform

recordBy?#

optional recordBy?: RecorderKeyMode;

Defined in: recorder-options.ts:17

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

Inherited from#

HotkeyRecorderBaseOptions.recordBy

validate?#

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

Defined in: hotkey-recorder.ts:57

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

Parameters#

hotkey#

HotkeyChord

context#

HotkeyRecorderValidationContext

Returns#

string | boolean