Struct GitView 

pub struct GitView { /* private fields */ }

The git repository facet.

Implementations

impl GitView

pub fn new(snap: RepoSnapshot) -> Self

A facet over an in-memory RepoSnapshot (host-supplied data path).

pub fn demo() -> Self

A demo facet (no git needed) — handy for examples/snapshot tests.

pub fn state(&self) -> &GitState

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. Every canvas click routes its Msg here too, so live == headless.

pub fn set_blob(&mut self, blob: Blob)

Replace the open source blob (the source pane content). A thin wrapper over the FC-2 update mutation path.

pub fn snapshot(&self) -> &RepoSnapshot

The current snapshot (read-only).

pub fn selected_branch(&self) -> Option<&str>

The currently selected branch name.

pub fn highlight_job(src: &str, theme: &Theme, font: FontId) -> LayoutJob

Build a syntax-coloured LayoutJob for Rust src under theme. Public so a host can render code with the same colours outside the facet.

impl GitView

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

The copyable text: the selected file path if one is open, else the selected branch name + tip, else the commit log as a TSV rectangle (id \t summary \t author \t time).

impl GitView

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

FC-9 render — a pure function of &self: it paints the three columns (branches / tree-or-log / source) and returns the Msgs the interactions produced. It MUST NOT mutate the GitState or do I/O; the impl_facet_via_elm! bridge applies the returned messages through update.

Trait Implementations

impl CopySource for GitView

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 GitView

type Model = GitState

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

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 GitView

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 title(&self) -> &str

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

fn caps(&self) -> FacetCaps

What this facet can do. Override to opt into capabilities.

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