Struct ExtensionDispatcher 

pub struct ExtensionDispatcher { /* private fields */ }

Owns registered extensions and routes messages to them.

Maintains a type-name index for O(1) dispatch, a node-to-extension map for event/command routing, and per-extension poison state for panic isolation. Created via ToddyAppBuilder::build_dispatcher.

Implementations

impl ExtensionDispatcher

pub fn new(extensions: Vec<Box<dyn WidgetExtension>>) -> Self

pub fn clone_for_session(&self) -> Self

Create a new dispatcher for a multiplexed session.

Calls WidgetExtension::new_instance() on each registered extension to produce independent instances with isolated mutable state. The type-name index is rebuilt from the new instances.

Panics if any extension has not implemented new_instance().

pub fn handles_type(&self, type_name: &str) -> bool

Check if a node type is handled by an extension.

pub fn prepare_all( &mut self, root: &TreeNode, caches: &mut ExtensionCaches, theme: &Theme, )

Called after Core::apply() on tree changes.

pub fn handle_event( &mut self, id: &str, family: &str, data: &Value, caches: &mut ExtensionCaches, ) -> EventResult

Handle a Message::Event.

pub fn handle_command( &mut self, node_id: &str, op: &str, payload: &Value, caches: &mut ExtensionCaches, ) -> Vec<OutgoingEvent>

Handle an ExtensionCommand.

pub fn init_all(&mut self, config: &Value)

Route configuration to extensions. config is the value of the extension_config key from Settings – a JSON object keyed by each extension’s config_key().

pub fn render<'a>( &'a self, node: &'a TreeNode, env: &WidgetEnv<'a>, ) -> Option<Element<'a, Message>>

Render an extension node. Returns None if no extension handles this type.

The caller must construct the WidgetEnv and pass it in. This avoids a borrow-checker issue where a locally-constructed env would be dropped before the returned Element (which borrows from the env).

Note: catch_unwind happens in the caller (widgets::render) because the returned Element borrows from env and can’t be wrapped in a closure. When a render panic is caught, the caller should call record_render_panic to track consecutive failures.

pub fn record_render_panic(&self, type_name: &str) -> bool

Record a render panic for the extension that handles type_name. Called by the catch_unwind wrapper in widgets::render (which has only &self). Uses AtomicU32 so no &mut self is required. Returns true if the extension has reached the poison threshold.

pub fn clear_poisoned(&mut self)

Reset all poisoned flags and render panic counters. Called on Snapshot.

pub fn cleanup_all(&mut self, caches: &mut ExtensionCaches)

Call cleanup() for every node currently tracked by the dispatcher.

Used before a full state reset (e.g. Reset message) so extensions get a chance to release per-node resources before their cache entries are wiped.

pub fn reset(&mut self, caches: &mut ExtensionCaches)

Full reset: call cleanup for all tracked nodes, clear the node map, clear extension caches, and reset poisoned state.

Extensions themselves (the registered trait objects) are preserved – only per-node runtime state is wiped.

pub fn is_empty(&self) -> bool

Check if any extensions are registered.

pub fn len(&self) -> usize

Number of registered extensions.

Trait Implementations

impl Default for ExtensionDispatcher

fn default() -> Self

Returns the “default value” for a type.