Struct RenderCache 

pub struct RenderCache { /* private fields */ }

Per-message render cache keyed by message index.

The cache stores one optional entry per chat message, addressed by the message’s position in crate::App’s message buffer. On each frame the chat widget calls get with the current RenderCacheKey; on a hit it reuses the cached lines, skipping expensive markdown parsing and word-wrapping.

When messages are evicted from the front of the buffer, call shift to keep indices aligned.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
let key = RenderCacheKey { content_hash: 42, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
cache.put(0, key, vec![], vec![]);
assert!(cache.get(0, &key).is_some());

Implementations

impl RenderCache

pub fn get( &self, idx: usize, key: &RenderCacheKey, ) -> Option<(&[Line<'static>], &[MdLink])>

Look up cached lines for message at idx with the given key.

Returns Some((lines, md_links)) on a cache hit, None on a miss or key mismatch.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
let key = RenderCacheKey { content_hash: 1, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
assert!(cache.get(0, &key).is_none()); // cold cache

pub fn put( &mut self, idx: usize, key: RenderCacheKey, lines: Vec<Line<'static>>, md_links: Vec<MdLink>, )

Store a rendered entry for message at idx.

Grows the internal storage as needed. An existing entry at idx is unconditionally replaced.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
let key = RenderCacheKey { content_hash: 7, terminal_width: 100, tool_expanded: true, compact_tools: false, show_labels: false };
cache.put(0, key, vec![], vec![]);
assert!(cache.get(0, &key).is_some());

pub fn invalidate(&mut self, idx: usize)

Invalidate the entry at idx, forcing a re-render on the next frame.

A no-op if idx is out of range.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
let key = RenderCacheKey { content_hash: 1, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
cache.put(0, key, vec![], vec![]);
cache.invalidate(0);
assert!(cache.get(0, &key).is_none());

pub fn clear(&mut self)

Remove all cached entries.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
let key = RenderCacheKey { content_hash: 1, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
cache.put(0, key, vec![], vec![]);
cache.clear();
assert!(cache.get(0, &key).is_none());

pub fn shift(&mut self, count: usize)

Shift all entries left by count positions.

Called when count messages are evicted from the front of the message buffer, so that cache index N continues to map to message index N. If count >= the current number of entries, the cache is emptied.

Examples

use zeph_tui::render_cache::{RenderCache, RenderCacheKey};

let mut cache = RenderCache::default();
for i in 0..3u64 {
    let key = RenderCacheKey { content_hash: i, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
    cache.put(i as usize, key, vec![], vec![]);
}
cache.shift(1);
// Old index 1 is now at index 0.
let key1 = RenderCacheKey { content_hash: 1, terminal_width: 80, tool_expanded: false, compact_tools: false, show_labels: false };
assert!(cache.get(0, &key1).is_some());

Trait Implementations

impl Default for RenderCache

fn default() -> RenderCache

Returns the “default value” for a type.