Struct DecoratedGraphView 

pub struct DecoratedGraphView { /* private fields */ }

An interactive, decorated pan/zoom graph pane Facet.

Implementations

impl DecoratedGraphView

pub fn new(title: impl Into<String>) -> Self

An empty pane titled title.

pub fn with_model(self, model: GraphModel) -> Self

Set the graph model (nodes already laid out in world space + edges).

pub fn with_decorations(self, decorations: Decorations) -> Self

Set the decorations overlay (rings/badges + emphasis edges).

pub fn set_title(&mut self, title: impl Into<String>)

Re-title (the deck keys facets off [Facet::title]).

pub fn state(&self) -> &GraphViewState

FC-3 — read the complete observable state at any frame boundary.

pub fn update(&mut self, msg: Msg) -> Vec<Effect>

FC-2 / FC-8 — the single mutation path. Apply one Msg; returns the (always empty) Effects the host should run. The canvas click/drag/scroll and the fit button all route their Msg here too, so live == headless.

pub fn fit(&mut self)

Reset pan + zoom (the ⊙ fit affordance). A thin wrapper over the FC-2 update mutation path.

pub fn select(&mut self, id: Option<String>)

Select a node by id (lights its downstream subtree), or None to clear. A thin wrapper over the FC-2 update mutation path.

pub fn lit_set(&self) -> BTreeSet<String>

The downstream-lit set for the current selection (empty when none).

pub fn local() -> Self

Discovery-contract local() — a realistic 4-node DAG (a → b, a → c, b → d, c → d) decorated with a green coverage ring on a, an amber badge on b, and an emphasis “cut” edge d → a (dashed, labelled), so the pane paints real chips, rings, a badge, and an overlay edge with no host.

pub fn remote() -> Self

Discovery-contract remote() — same surface, re-titled; the variant a host builds from a server-streamed model. Kept so the matrix sees both ctors.

impl DecoratedGraphView

pub fn copy_text(&self) -> Option<String>

The copyable text: the selected node’s label when one is selected, else every node label, one per line.

impl DecoratedGraphView

pub fn view(&self, ui: &mut Ui) -> Vec<Msg>

FC-9 render — a pure function of &self: it paints the header, the edges + decorated chips, and returns the Msgs the interactions produced (fit / pan / zoom / node-select). It MUST NOT mutate the GraphViewState; the impl_facet_via_elm! bridge applies the returned messages through update. One-frame latency on the camera + selection is the standard immediate-mode Elm trade (a repaint follows).

Trait Implementations

impl CopySource for DecoratedGraphView

fn copy_kinds(&self) -> &[ClipKind]

The kinds this source can offer, richest first.

fn copy_payload(&self) -> Option<ClipPayload>

Produce the payload for the current selection (richest representation).

impl Elm for DecoratedGraphView

type Model = GraphViewState

All observable state, in one serializable struct (FC-1 / FC-3).

type Msg = Msg

Every input the component accepts (FC-2). The only legal way to mutate the Model.

type Effect = Effect

Side work as data (FC-8). Use enum Effect {} when the component does no I/O.

fn title(&self) -> &str

The deck keys facets off this (mirrors Facet::title).

fn state(&self) -> &GraphViewState

FC-3 — read the complete observable state at any frame boundary.

fn update(&mut self, msg: Msg) -> Vec<Effect>

FC-2 / FC-8 — the single mutation path. Apply one Msg; return the Effects the host should run (empty = nothing to do).

fn view(&self, ui: &mut Ui) -> Vec<Msg>

FC-9 / FC-4 — a pure function of &self: it paints and returns the Msgs it produced. It MUST NOT mutate the model or do I/O; the Facet::ui bridge applies the returned messages through update.

impl Facet for DecoratedGraphView

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

FC-9: the view is pure (paints + emits Msgs); FC-2: mutation only via update. The immediate-mode trait just bridges the two.

fn caps(&self) -> FacetCaps

Themed (chips/rings follow the palette) + resizable + selectable (a node drill-in) + navigable (pan/drag + scroll-zoom + fit).

fn title(&self) -> &str

fn state_json(&self) -> Value

fn copy(&mut self) -> Option<String>

Clipboard hooks — see clipboard.rs. Defaults: nothing to give/take. Returns the text to place on the clipboard (None = nothing copyable now).

fn selection_json(&self) -> Value

The current selection as JSON (also folded into state_json by convention). Null when nothing/none selectable.

fn as_any_mut(&mut self) -> Option<&mut dyn Any>

Optional downcast handle for hosts that need typed access to a specific facet living inside a FacetDeck (e.g. a robot-UI driver clicking an app-level control that must forward to a concrete component’s own API). Defaulted to None so no existing facet has to change; a component opts in by returning Some(self).

fn scale(&self) -> f32

Current uniform scale (1.0 = native). Override if caps().scalable.

fn set_scale(&mut self, _scale: f32)

Set the uniform scale; clamp internally. Default no-op (not scalable).

fn cut(&mut self) -> Option<String>

Like copy, but also removes the selection. Default delegates to copy.

fn paste(&mut self, _text: &str) -> bool

Accept pasted text. Returns true if consumed.

fn kind(&self) -> &'static str

Stable component-type id (e.g. "jobview", "graphpan", "table"). Two instances with the same kind can exchange portable state; the empty default "" means opted out of cross-instance clone.

fn portable_state(&self) -> Option<Value>

The portable subset of this facet’s state — the fields a same-kind sibling can adopt. None = not cloneable. Kept SEPARATE from state_json (the introspection dump, which may carry derived / render-only data) so this stays round-trippable through load_state.

fn load_state(&mut self, _state: &Value) -> bool

Adopt a portable state produced by portable_state on a same-kind sibling. Returns true if accepted. Default false (opt-in per component).