Struct UpdateComponents 

pub struct UpdateComponents { /* private fields */ }

The shell-owned outdated-parts checker + batch refresher. One instance on the app; the constraints panel reads the count (and runs the refresh), the structure tree reads per-part flags.

Implementations

impl UpdateComponents

pub fn new() -> Self

pub fn ensure_current( &mut self, state: &mut EngineState, model_store: &dyn ModelStore, save_generation: u64, synced: &HashMap<String, String>, )

Recompute the outdated/missing sets when the staleness key moved (or after Self::invalidate); otherwise a cheap compare. The shell calls this once per frame BEFORE the assembly panels draw.

synced: each top-level entry’s sourceSignature as of the tab’s last Open/Save (crate::document::Documents::synced_signatures); empty when unknown, and then the entry’s own signature stands alone.

pub fn asking(&self) -> Option<&[String]>

The parts an Update is waiting to ask about (automation readback).

pub fn answer( &mut self, state: &mut EngineState, model_store: &dyn ModelStore, take_files: bool, ) -> Result<usize, String>

Answer the question Self::run asked and run the update: true takes the files’ versions, false keeps this document’s edits (the other outdated parts are updated either way).

pub fn show_conflict( &mut self, ctx: &Context, state: &mut EngineState, model_store: &dyn ModelStore, )

The question, while one is pending: one dialog, never a block. The default (Enter) takes the files’ versions.

pub fn invalidate(&mut self)

Drop the cache so the next Self::ensure_current recomputes even on an unmoved key (after a run, or an external store change).

pub fn outdated_count(&self) -> usize

The outdated-entry count — the constraints-header badge number.

pub fn outdated(&self) -> &[String]

The outdated entry names — what the Diagram and PCB workbenches mark on the components placed from them.

pub fn is_outdated(&self, part_name: &str) -> bool

Whether part_name’s library entry is outdated — the structure tree’s per-node badge (every instance of the part lights).

pub fn missing(&self) -> &[String]

Entry names noted as source-less (header hover text).

pub fn run( &mut self, state: &mut EngineState, model_store: &dyn ModelStore, ) -> Result<usize, String>

RUN the update (the header button): recompute against the LIVE document (never a stale cache), rewrite every outdated entry from its store content through refresh_library_entry, then reload ONCE — the kernel self-heals every instance + re-solves, and the main-side sync captures healed snapshots back. Per-entry failures (missing store key, unreadable content) toast and SKIP — the batch never aborts. Returns the number of entries refreshed.

Trait Implementations

impl Default for UpdateComponents

fn default() -> Self

Returns the “default value” for a type.