Struct ProgramConfig 

pub struct ProgramConfig {

    pub screen_mode: ScreenMode,
    pub ui_anchor: UiAnchor,
    pub budget: FrameBudgetConfig,
    pub diff_config: RuntimeDiffConfig,
    pub evidence_sink: EvidenceSinkConfig,
    pub render_trace: RenderTraceConfig,
    pub frame_timing: Option<FrameTimingConfig>,
    pub conformal_config: Option<ConformalConfig>,
    pub locale_context: LocaleContext,
    pub poll_timeout: Duration,
    pub resize_coalescer: CoalescerConfig,
    pub resize_behavior: ResizeBehavior,
    pub forced_size: Option<(u16, u16)>,
    pub mouse_capture_policy: MouseCapturePolicy,
    pub bracketed_paste: bool,
    pub focus_reporting: bool,
    pub kitty_keyboard: bool,
    pub persistence: PersistenceConfig,
    pub inline_auto_remeasure: Option<InlineAutoRemeasureConfig>,
    pub widget_refresh: WidgetRefreshConfig,
    pub effect_queue: EffectQueueConfig,
}

Configuration for the program runtime.

Fields

screen_mode: ScreenMode

Screen mode (inline or alternate screen).

ui_anchor: UiAnchor

UI anchor for inline mode.

budget: FrameBudgetConfig

Frame budget configuration.

diff_config: RuntimeDiffConfig

Diff strategy configuration for the terminal writer.

evidence_sink: EvidenceSinkConfig

Evidence JSONL sink configuration.

render_trace: RenderTraceConfig

Render-trace recorder configuration.

frame_timing: Option<FrameTimingConfig>

Optional frame timing sink.

conformal_config: Option<ConformalConfig>

Conformal predictor configuration for frame-time risk gating.

locale_context: LocaleContext

Locale context used for rendering.

poll_timeout: Duration

Input poll timeout.

resize_coalescer: CoalescerConfig

Resize coalescer configuration.

resize_behavior: ResizeBehavior

Resize handling behavior (immediate/throttled).

forced_size: Option<(u16, u16)>

Forced terminal size override (when set, resize events are ignored).

mouse_capture_policy: MouseCapturePolicy

Mouse capture policy (Auto, On, Off).

Auto is inline-safe: off in inline modes, on in alt-screen mode.

bracketed_paste: bool

Enable bracketed paste.

focus_reporting: bool

Enable focus reporting.

kitty_keyboard: bool

Enable Kitty keyboard protocol (repeat/release events).

persistence: PersistenceConfig

State persistence configuration.

inline_auto_remeasure: Option<InlineAutoRemeasureConfig>

Inline auto UI height remeasurement policy.

widget_refresh: WidgetRefreshConfig

Widget refresh selection configuration.

effect_queue: EffectQueueConfig

Effect queue scheduling configuration.

Implementations

impl ProgramConfig

pub fn fullscreen() -> Self

Create config for fullscreen applications.

pub fn inline(height: u16) -> Self

Create config for inline mode with specified height.

pub fn inline_auto(min_height: u16, max_height: u16) -> Self

Create config for inline mode with automatic UI height.

pub fn with_mouse(self) -> Self

Enable mouse support.

pub fn with_mouse_capture_policy(self, policy: MouseCapturePolicy) -> Self

Set mouse capture policy.

pub fn with_mouse_enabled(self, enabled: bool) -> Self

Force mouse capture enabled/disabled regardless of screen mode.

pub const fn resolved_mouse_capture(&self) -> bool

Resolve mouse capture using the configured policy and screen mode.

pub fn with_budget(self, budget: FrameBudgetConfig) -> Self

Set the budget configuration.

pub fn with_diff_config(self, diff_config: RuntimeDiffConfig) -> Self

Set the diff strategy configuration for the terminal writer.

pub fn with_evidence_sink(self, config: EvidenceSinkConfig) -> Self

Set the evidence JSONL sink configuration.

pub fn with_render_trace(self, config: RenderTraceConfig) -> Self

Set the render-trace recorder configuration.

pub fn with_frame_timing(self, config: FrameTimingConfig) -> Self

Set a frame timing sink for per-frame profiling.

pub fn with_conformal_config(self, config: ConformalConfig) -> Self

Enable conformal frame-time risk gating with the given config.

pub fn without_conformal(self) -> Self

Disable conformal frame-time risk gating.

pub fn with_locale_context(self, locale_context: LocaleContext) -> Self

Set the locale context used for rendering.

pub fn with_locale(self, locale: impl Into<Locale>) -> Self

Set the base locale used for rendering.

pub fn with_widget_refresh(self, config: WidgetRefreshConfig) -> Self

Set the widget refresh selection configuration.

pub fn with_effect_queue(self, config: EffectQueueConfig) -> Self

Set the effect queue scheduling configuration.

pub fn with_resize_coalescer(self, config: CoalescerConfig) -> Self

Set the resize coalescer configuration.

pub fn with_resize_behavior(self, behavior: ResizeBehavior) -> Self

Set the resize handling behavior.

pub fn with_forced_size(self, width: u16, height: u16) -> Self

Force a fixed terminal size (cols, rows). Resize events are ignored.

pub fn without_forced_size(self) -> Self

Clear any forced terminal size override.

pub fn with_legacy_resize(self, enabled: bool) -> Self

Toggle legacy immediate-resize behavior for migration.

pub fn with_persistence(self, persistence: PersistenceConfig) -> Self

Set the persistence configuration.

pub fn with_registry(self, registry: Arc<StateRegistry>) -> Self

Enable persistence with the given registry.

pub fn with_inline_auto_remeasure( self, config: InlineAutoRemeasureConfig, ) -> Self

Enable inline auto UI height remeasurement with the given policy.

pub fn without_inline_auto_remeasure(self) -> Self

Disable inline auto UI height remeasurement.

Trait Implementations

impl Clone for ProgramConfig

fn clone(&self) -> ProgramConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ProgramConfig

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

Formats the value using the given formatter.

impl Default for ProgramConfig

fn default() -> Self

Returns the “default value” for a type.