Struct VisibleHighlightsKey 

pub struct VisibleHighlightsKey {
    pub buffer_id: BufferId,
    pub snapshot_ptr: usize,
    pub syntax_text_version: u64,
    pub scroll: u32,
    pub viewport_height: u32,
    pub fold_hash: u64,
    pub inlay_version: u64,
    pub static_overlay_version: u64,
}

Cache key identifying the inputs that produced a particular StaticOverlayQuads. The overlay worker compares the current inputs against StaticOverlayQuads::computed_for_key to short-circuit re-bucketing on a no-op tick (cursor blink, unchanged scroll/viewport/folds).

snapshot_ptr is the Arc::as_ptr of the snapshot the bucket was computed against — distinct snapshots produce distinct keys even if text_version happens to match.

Migrated from crates/lattice-host/src/highlights.rs in X2; the renderer’s read contract is now the canonical owner.

Perf plan A.2 slice A.2b.2: inlay_version axis — a content hash of the gated SyntaxRenderState.inlay_hints payload. When inlays arrive, change, or the mode-gate flips, the hash bumps and the worker recomposes rows so the inlay splice stays current. Stable across pure-scroll / cursor-blink ticks (the hash is recomputed from the same payload).

Fields

buffer_id: BufferId

Which buffer these quads were bucketed for.

Without it the key describes a viewport rather than a DOCUMENT, and the two are not the same thing the moment the active buffer changes. The stale-snapshot hold below re-publishes the previous quads under a new key, which is right mid-edit in one buffer and wrong across a switch — it painted the buffer you left onto the buffer you opened, at the exact offsets it had there. Nothing else in this key could tell the two cases apart.

snapshot_ptr: usize

syntax_text_version: u64

scroll: u32

viewport_height: u32

fold_hash: u64

inlay_version: u64

static_overlay_version: u64

Perf plan B.2: content hash of the static-overlay payload (doc_highlights + all_matches + substitute_matches). Bumps independently from inlay_version so a search-query change invalidates the overlay bucket without forcing a row recompose, and an inlay arrival doesn’t invalidate the overlay bucket. Built from static_overlay_state_version at publish time so the hash and the payload stay aligned by construction.

Trait Implementations

impl Clone for VisibleHighlightsKey

fn clone(&self) -> VisibleHighlightsKey

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for VisibleHighlightsKey

impl Debug for VisibleHighlightsKey

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

Formats the value using the given formatter.

impl Default for VisibleHighlightsKey

fn default() -> VisibleHighlightsKey

Returns the “default value” for a type.

impl Eq for VisibleHighlightsKey

impl PartialEq for VisibleHighlightsKey

fn eq(&self, other: &VisibleHighlightsKey) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for VisibleHighlightsKey