Struct ThemeCursor 

pub struct ThemeCursor<T> { /* private fields */ }

A cycling cursor over a list of themes of type T.

peek() returns the current theme without moving. next() and prev() advance or retreat the cursor and return the new current theme. Both wrap around at the ends.

To iterate over all themes without cycling, use ThemeCursor::themes.

Type parameters

• ThemeCursor<tca_types::Theme> — raw themes; see ThemeCursor::with_builtins etc.
• [tca_ratatui::TcaThemeCursor] — resolved Ratatui themes; convenience constructors are available via tca_ratatui.

Implementations

impl<T> ThemeCursor<T>

pub fn new(themes: impl IntoIterator<Item = T>) -> Self

Create a cursor from any iterable of themes. The cursor starts at the first theme.

pub fn peek(&self) -> Option<&T>

Returns the current theme without moving the cursor.

pub fn next(&mut self) -> Option<&T>

Advances the cursor to the next theme (wrapping) and returns it.

Returns None if the cursor is empty.

pub fn prev(&mut self) -> Option<&T>

Retreats the cursor to the previous theme (wrapping) and returns it.

Returns None if the cursor is empty.

pub fn themes(&self) -> &[T]

Returns a slice of all themes in the cursor.

pub fn len(&self) -> usize

Returns the number of themes.

pub fn is_empty(&self) -> bool

Returns true if the cursor contains no themes.

pub fn set_index(&mut self, index: usize) -> Option<&T>

Moves the cursor to index and returns the theme at that position.

Returns None if index is out of bounds.

impl ThemeCursor<Theme>

Convenience constructors for ThemeCursor<Theme>.

pub fn with_builtins() -> Self

All built-in themes.

pub fn with_user_themes() -> Self

User-installed themes only.

pub fn with_all_themes() -> Self

Built-ins + user themes. User themes with matching names override builtins.

pub fn set_current(&mut self, name: &str) -> Option<&Theme>

Moves the cursor to the theme matching name (slug-insensitive) and returns it.

Accepts fuzzy names: “Nord Dark”, “nord-dark”, and “nordDark” all match the same theme. Returns None if no matching theme is found.

Trait Implementations

impl<T: Clone> Clone for ThemeCursor<T>

fn clone(&self) -> ThemeCursor<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for ThemeCursor<T>

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

Formats the value using the given formatter.

impl<T: PartialEq> PartialEq for ThemeCursor<T>

fn eq(&self, other: &ThemeCursor<T>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<T: Eq> Eq for ThemeCursor<T>

impl<T> StructuralPartialEq for ThemeCursor<T>