Struct RuntimeDiffConfig 

pub struct RuntimeDiffConfig {
    pub bayesian_enabled: bool,
    pub dirty_rows_enabled: bool,
    pub dirty_span_config: DirtySpanConfig,
    pub tile_diff_config: TileDiffConfig,
    pub reset_on_resize: bool,
    pub reset_on_invalidation: bool,
    pub strategy_config: DiffStrategyConfig,
}

Runtime-level configuration for diff strategy selection.

This wraps DiffStrategyConfig and adds runtime-specific toggles for enabling/disabling features and controlling reset policies.

Example

use ftui_runtime::{RuntimeDiffConfig, DiffStrategyConfig};

// Use defaults (Bayesian selection enabled, dirty-rows enabled)
let config = RuntimeDiffConfig::default();

// Disable Bayesian selection (always use dirty-rows if available)
let config = RuntimeDiffConfig::default()
    .with_bayesian_enabled(false);

// Custom cost model
let config = RuntimeDiffConfig::default()
    .with_strategy_config(DiffStrategyConfig {
        c_emit: 10.0,  // Higher I/O cost
        ..Default::default()
    });

Fields

bayesian_enabled: bool

Enable Bayesian strategy selection.

When enabled, the selector uses a Beta posterior over the change rate to choose between Full, DirtyRows, and FullRedraw strategies.

When disabled, always uses DirtyRows if dirty tracking is available, otherwise Full.

Default: true

dirty_rows_enabled: bool

Enable dirty-row optimization.

When enabled, the DirtyRows strategy is available for selection. When disabled, the selector chooses between Full and FullRedraw only.

Default: true

dirty_span_config: DirtySpanConfig

Dirty-span tracking configuration (thresholds + feature flags).

Controls span merging, guard bands, and enable/disable behavior.

tile_diff_config: TileDiffConfig

Tile-based diff skipping configuration (thresholds + feature flags).

Controls SAT tile size, thresholds, and enable/disable behavior.

reset_on_resize: bool

Reset posterior on dimension change.

When true, the Bayesian posterior resets to priors when the buffer dimensions change (e.g., terminal resize).

Default: true

reset_on_invalidation: bool

Reset posterior on buffer invalidation.

When true, resets to priors when the previous buffer becomes invalid (e.g., mode switch, scroll region change).

Default: true

strategy_config: DiffStrategyConfig

Underlying strategy configuration.

Contains cost model constants, prior parameters, and decay settings.

Implementations

impl RuntimeDiffConfig

pub fn new() -> RuntimeDiffConfig

Create a new config with all defaults.

pub fn with_bayesian_enabled(self, enabled: bool) -> RuntimeDiffConfig

Set whether Bayesian strategy selection is enabled.

pub fn with_dirty_rows_enabled(self, enabled: bool) -> RuntimeDiffConfig

Set whether dirty-row optimization is enabled.

pub fn with_dirty_spans_enabled(self, enabled: bool) -> RuntimeDiffConfig

Set whether dirty-span tracking is enabled.

pub fn with_dirty_span_config( self, config: DirtySpanConfig, ) -> RuntimeDiffConfig

Set the dirty-span tracking configuration.

pub fn with_tile_skip_enabled(self, enabled: bool) -> RuntimeDiffConfig

Toggle tile-based skipping.

pub fn with_tile_diff_config(self, config: TileDiffConfig) -> RuntimeDiffConfig

Set the tile-based diff configuration.

pub fn with_reset_on_resize(self, enabled: bool) -> RuntimeDiffConfig

Set whether to reset posterior on resize.

pub fn with_reset_on_invalidation(self, enabled: bool) -> RuntimeDiffConfig

Set whether to reset posterior on invalidation.

pub fn with_strategy_config( self, config: DiffStrategyConfig, ) -> RuntimeDiffConfig

Set the underlying strategy configuration.

Trait Implementations

impl Clone for RuntimeDiffConfig

fn clone(&self) -> RuntimeDiffConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RuntimeDiffConfig

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

Formats the value using the given formatter.

impl Default for RuntimeDiffConfig

fn default() -> RuntimeDiffConfig

Returns the “default value” for a type.