Struct LibraryState 

pub struct LibraryState {

    pub source: LibrarySource,
    pub previous_non_search_source: LibrarySource,
    pub nav_history: VecDeque<LibrarySource>,
    pub sort_mode: LibrarySortMode,
    pub load_state: LibraryLoadState,
    pub selected_asset_id: Option<String>,
    pub albums: Vec<LibraryAlbum>,
    pub assets: Vec<LibraryAsset>,
    pub next_page: u32,
    pub has_more: bool,
    pub page_in_flight: bool,
    pub generation: u64,
    pub status: LibraryStatus,
}

Fields

source: LibrarySource

previous_non_search_source: LibrarySource

nav_history: VecDeque<LibrarySource>

Stack of past sources for back-navigation. Pushed by navigate_to, popped by navigate_back. Searches are not pushed (they are ephemeral). VecDeque for O(1) front pops when the 50-entry cap is hit.

sort_mode: LibrarySortMode

load_state: LibraryLoadState

selected_asset_id: Option<String>

albums: Vec<LibraryAlbum>

assets: Vec<LibraryAsset>

next_page: u32

has_more: bool

page_in_flight: bool

generation: u64

status: LibraryStatus

Implementations

impl LibraryState

pub fn new() -> Self

pub fn load_albums(&mut self, albums: Vec<LibraryAlbum>)

pub fn load_initial_source(&mut self) -> (u64, LibrarySource, u32)

pub fn switch_source( &mut self, source: LibrarySource, ) -> (u64, LibrarySource, u32)

pub fn navigate_to( &mut self, source: LibrarySource, ) -> (u64, LibrarySource, u32)

Switch to source, recording the current source in nav_history first so back-navigation can return to it. Searches are not pushed (they’re ephemeral). No-ops when navigating to the source we’re already on.

pub fn navigate_back(&mut self) -> Option<(u64, LibrarySource, u32)>

Pop one entry from nav_history and switch to it. Does not push to history. Returns None when there’s nowhere to go back to.

pub fn can_go_back(&self) -> bool

pub fn load_next_page_if_needed(&mut self) -> Option<(u64, LibrarySource, u32)>

pub fn replace_assets( &mut self, generation: u64, items: Vec<LibraryAsset>, ) -> bool

pub fn append_assets( &mut self, generation: u64, items: Vec<LibraryAsset>, ) -> bool

pub fn replace_assets_with_more( &mut self, generation: u64, items: Vec<LibraryAsset>, has_more: bool, ) -> bool

replace_assets with an explicit has_more signal — used by search endpoints that return Immich’s nextPage field, since the page-size heuristic is wrong when the server returns short pages due to post-filtering (visibility, archive, etc.).

pub fn append_assets_with_more( &mut self, generation: u64, items: Vec<LibraryAsset>, has_more: bool, ) -> bool

pub fn apply_sort(&mut self, mode: LibrarySortMode)

Records the user’s preferred sort mode. LibraryState.assets is always stored in insertion (server) order so that the sliding-window FIFO eviction is well-defined; the listmodel layer applies client-side sort visually for Filename/FileType.

pub fn clear_search_restore_previous_source( &mut self, ) -> Option<(u64, LibrarySource, u32)>

pub fn mark_error(&mut self, generation: u64, message: impl Into<String>)

pub fn set_status( &mut self, stats: Option<ServerStats>, about: Option<ServerAbout>, )

Trait Implementations

impl Clone for LibraryState

fn clone(&self) -> LibraryState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for LibraryState

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

Formats the value using the given formatter.

impl Default for LibraryState

fn default() -> Self

Returns the “default value” for a type.