Struct SequenceConfig 

pub struct SequenceConfig {
    pub esc_seq_timeout: Duration,
    pub esc_debounce: Duration,
    pub disable_sequences: bool,
}

Configuration for the sequence detector.

Timing Defaults

Setting	Default	Range	Description
esc_seq_timeout	250ms	150-400ms	Window for detecting Esc Esc
esc_debounce	50ms	0-100ms	Minimum wait before single Esc

Environment Variables

Variable	Type	Default	Description
FTUI_ESC_SEQ_TIMEOUT_MS	u64	250	Esc Esc detection window
FTUI_ESC_DEBOUNCE_MS	u64	50	Minimum Esc wait
FTUI_DISABLE_ESC_SEQ	bool	false	Disable multi-key sequences

Example

# Faster double-tap detection (200ms window)
export FTUI_ESC_SEQ_TIMEOUT_MS=200

# Disable Esc Esc entirely (for strict terminals)
export FTUI_DISABLE_ESC_SEQ=1

Fields

esc_seq_timeout: Duration

Maximum gap between Esc presses to detect Esc Esc sequence. Default: 250ms.

esc_debounce: Duration

Minimum debounce before emitting single Esc. Default: 50ms.

disable_sequences: bool

Whether to disable multi-key sequences entirely. When true, all Esc keys are immediately emitted as single Esc. Default: false.

Implementations

impl SequenceConfig

pub fn with_timeout(self, timeout: Duration) -> Self

Create a new config with custom timeout.

pub fn with_debounce(self, debounce: Duration) -> Self

Create a new config with custom debounce.

pub fn disable_sequences(self) -> Self

Disable sequence detection (treat all Esc as single).

pub fn from_env() -> Self

Load config from environment variables.

Reads:

• FTUI_ESC_SEQ_TIMEOUT_MS: Esc Esc detection window in milliseconds
• FTUI_ESC_DEBOUNCE_MS: Minimum Esc wait in milliseconds
• FTUI_DISABLE_ESC_SEQ: Set to “1” or “true” to disable sequences

Values are automatically clamped to valid ranges.

pub fn validated(self) -> Self

Validate and clamp values to safe ranges.

Returns a new config with:

• esc_seq_timeout clamped to 150-400ms
• esc_debounce clamped to 0-100ms
• esc_debounce <= esc_seq_timeout (debounce is capped at timeout)

Example

use ftui_core::keybinding::SequenceConfig;
use std::time::Duration;

let config = SequenceConfig::default()
    .with_timeout(Duration::from_millis(1000))  // Too high
    .validated();

// Clamped to max 400ms
assert_eq!(config.esc_seq_timeout.as_millis(), 400);

pub fn is_valid(&self) -> bool

Check if values are within valid ranges.

Trait Implementations

impl Clone for SequenceConfig

fn clone(&self) -> SequenceConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for SequenceConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for SequenceConfig

fn default() -> Self

Returns the “default value” for a type.