Struct GraphView 

pub struct GraphView {
    pub scene: Scene,
    pub empty_hint: String,
    pub title: String,
    /* private fields */
}

A simple graph-view widget: a Scene + a Layout. Implements Facet, so it drops into a FacetDeck and exposes state_json for free.

Fields

scene: Scene

The graph data being drawn — input (like facett-grid’s Arrow data): held on the struct, outside the observable GraphState Model.

empty_hint: String

Shown centred when the scene has no nodes.

title: String

The deck keys facets off this.

Implementations

impl GraphView

pub fn new(scene: Scene) -> Self

pub fn empty_hint(self, hint: impl Into<String>) -> Self

pub fn with_title(self, title: impl Into<String>) -> Self

pub fn with_layout(self, layout: Layout) -> Self

Set the layout strategy at build time.

pub fn state(&self) -> &GraphState

FC-3 — read the complete observable interaction state.

pub fn layout(&self) -> Layout

The active node-placement strategy (as the core Layout).

pub fn set_layout(&mut self, layout: Layout)

Switch the layout — a thin wrapper over the FC-2 update mutation path (the sole way the Model changes).

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.

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

Paint the scene (pure draw helper; no mutation).

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

FC-9 render — a pure function of &self: it paints the scene and returns the Msgs the interactions produced (none — the 2D skin is a static viewer; its layout is driven through the Msg surface by the host). It MUST NOT mutate the Model or do I/O.

pub fn label_counts(&self) -> BTreeMap<String, usize>

Per-label node counts (for the introspection).

impl GraphView

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

The copyable text: every node label, one per line (the graph carries no per-node selection, so this is the whole scene’s label list).

Trait Implementations

impl CopySource for GraphView

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 GraphView

type Model = GraphState

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) -> &GraphState

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 GraphView

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

Painted via draw, which reads the active Theme (edges/labels/empty hint) from the context; its canvas takes the host’s available_size.

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 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 selection_json(&self) -> Value

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

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 as_any_mut(&mut self) -> Option<&mut (dyn Any + 'static)>

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 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).