GridPresenterBase. GridPresenterBase

Configures the LoadItemsTask2 query for data loading

The view mode the grid is currently showing, or "" when it cannot be read.

getOptions() receives the parent item but not the view, and some of its lists depend on which view is up (a Collections view sorts BoxSets, not movies), so the view is read back off the host component. BaseGridView keeps currentView in step with its own m.view (it sets it in loadInitialItems before SetUpOptions runs, and again in optionsClosed before the reload), so this is the same string the load is using.

Returns the backdrop mode for this presenter

Returns grid layout configuration for the specified view mode

Returns the options configuration for ItemGridOptions

Load dynamic filter options (Genres, Years, Ratings) from the Jellyfin API. Call from configureLoadTask() in subclasses that need dynamic filters. Delegates the fetch to the host component (BaseGridView.loadFilters) via callFunc so it runs in component-m context, where fetchAsync + auto-abandon work. A presenter is a class, not a component, so the auto-abandon plugin can't inject into it (Phase-4 collapse of GetFiltersTask; see docs/dev/promises.md). Results arrive via onFiltersLoaded(). Set by refreshFilters() when the panel opens.

Called when presenter is being destroyed Override to clean up resources, stop tasks, unobserve fields Always call super.onDestroy() at the end of overrides

Called when filters are delivered by the host component's promise (BaseGridView.loadFilters). Caches the result in m.apiFilters and shows a toast on failure.

Called after presenter is attached to BaseGridView Stores the view reference; a subclass adds its own nodes (MoviePresenter's logo task) Override in subclass but call super.onInit(view) first

Called when an item receives focus Override to update presentation info display

Called when options dialog is closed Override to handle presenter-specific option changes

refreshFilters: Revalidate the cached filter lists in the background.

Called when the options panel OPENS, which is the only moment the lists are actually looked at, so freshness is bought exactly where it is spent, and a session that never opens the panel pays for one load instead of one per query build.

Not rendered into the open panel, on purpose. BaseGridView.SetUpOptions() has already read m.apiFilters by the time this answers, and re-running it would reassign the panel's content and reset checkedItem: categories would appear and shift focus under a cursor already moving through the list. The refreshed lists show on the NEXT open, which is the stale-while-revalidate contract and the reason no TTL is needed.

It also retries a previous failure: a failed load never marks the cache populated, so the panel that needs those categories is what asks for them again.

The connected server's version string, or "" when it cannot be read.

Presenters run on the render thread, where m.global is owned locally and free to touch (2.0 µs against 93 µs from a Task, measured 2026-08-23 on a Stick 4K; see docs/architecture/threading.md). The guards are for the unit suites, which construct a presenter against a stand-in view with no global at all, and textOrEmpty() rather than toString() because toString() falls through to Str() and FAULTS on Invalid.

Returns whether to show presentation info panel for the view mode

Show a toast notification via the scene-level Toast component. Safe to call from presenter classes (routes through view's scene reference).

Returns whether the view mode is the TV Guide (EPG) instead of the item grid