Struct FacetDeck 

pub struct FacetDeck { /* private fields */ }

A tabbed set of Facets — the reusable multi-component shell. Draws a tab bar + the active facet, and composes every facet’s state_json under its title, so the whole-app introspection contract is free. korp/nornir can build their window from a FacetDeck instead of hand-rolling tabs + the state dump.

Implementations

impl FacetDeck

pub fn new(facets: Vec<Box<dyn Facet>>) -> Self

pub fn active(&self) -> usize

pub fn facet_mut<T: Any>(&mut self, title: &str) -> Option<&mut T>

Typed mutable access to the facet with title, downcast to T — None if no such facet, or it doesn’t opt into Facet::as_any_mut, or the type mismatches. Lets a host drive a concrete component’s own API (e.g. a robot-UI control forwarding a node selection to a SystemChart).

pub fn with_fx(self, fx: DeckFx) -> Self

Enable deck effects up front (builder form of fx_mut).

pub fn fx(&self) -> &DeckFx

The current deck-effects config (read-only).

pub fn fx_mut(&mut self) -> &mut DeckFx

Mutate the deck-effects config (toggle glow, pin a palette, …).

pub fn set_palette(&mut self, i: usize)

Override the deck theme with palette index i (wraps); enables the override. Convenience over fx_mut().set_palette(i).

pub fn cycle_palette(&mut self) -> usize

Advance to the next palette in Theme::ALL (wrapping); returns the new index. Convenience over fx_mut().cycle_palette().

pub fn send_raven(&mut self, target: Rect)

Summon the raven to perch on target — any rect a facet/host hands us (a table row, a node, a header). Replaces any raven already in flight. The body is tinted from the deck’s current palette (or the host theme). Logs an activity trail entry. Drive/paint happens automatically inside ui.

pub fn has_raven(&self) -> bool

True while a raven is present (flying or perched).

pub fn raven_perched(&self) -> bool

True once the summoned raven has landed (false if none).

pub fn clear_raven(&mut self)

Dismiss any raven.

pub fn palette_picker(&mut self, ui: &mut Ui) -> Option<usize>

Draw a one-line palette picker — a switcher over Theme::ALL the host can place anywhere (toolbar, menu). Selecting a palette pins the fx override; ui() then applies it each frame. Returns the chosen index if it changed this frame.

pub fn active_caps(&self) -> FacetCaps

The capabilities of the currently-active facet (or NONE if empty).

pub fn ui(&mut self, ui: &mut Ui)

Draw the tab bar + capability toolbar + the active facet, and route capability-gated shortcuts (Ctrl-+/-/0 for scale; Ctrl-C/X/V for clipboard).

pub fn state_json(&self) -> Value

The whole-app observable state: the active facet + each facet’s state_json, plus an additive sibling caps map (title → caps JSON) so the existing flat facets[title] shape is unchanged for consumers.