Struct CandidateVersion 

pub struct CandidateVersion { /* private fields */ }

What: The candidates of one listed state. Fields are private: a version is built once by build_version and never changed. Why: Immutability is what lets several policies share one listing safely.

In TS you’d write (pseudocode):

class CandidateVersion { readonly #candidates: readonly Candidate[]; readonly #byPath: ReadonlyMap<string, number> }

Implementations

impl CandidateVersion

What: impl CandidateVersion { ... } attaches read-only accessors, like class getters. Why: Callers can read a version and cannot change it.

In TS you’d write (pseudocode):

class CandidateVersion { get candidates() {} candidateAtPath(path) {} }

pub fn candidates(&self) -> &[Candidate]

What: Every candidate, in listing order. &[Candidate] borrows the list read-only. Why: A candidate’s identity.index is its position in this list.

In TS you’d write (pseudocode):

get candidates(): readonly Candidate[]

pub fn candidate_at_path(&self, path: &[u8]) -> Option<&Candidate>

What: The candidate at an exact pathname, if this version changes it. Option<&Candidate> is “a borrowed candidate or nothing”. Why: A policy that cares about specific files (a manifest, a rules file) asks by name instead of scanning the list or asking Git again.

In TS you’d write (pseudocode):

candidateAtPath(path: Buffer): Candidate | undefined

Trait Implementations

impl Debug for CandidateVersion

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.