Channels per page of the channel list.

Rows the guide shows at once, for when TimeGrid does not report numRows. Roku's TimeGrid reference does not list that field; both test devices report 6 (Roku OS 15.3.4, 2026-09-21).

Gives each channel row of fetch.block its programs, one write per row: REPLACE swaps what the row holds for them, LATER appends them and EARLIER inserts them ahead. The server's bounds are inclusive, so an extension repeats the programs the block already holds at its edge; those are dropped by id.

Applies one of guidePrograms.trims: drops the block, or cuts it back to what airs in [trim.from, trim.until].

Voice Search set

Drops the programs of blocks, one write per row.

Move the TV Guide Grid down or up depending whether details are selected

The focused channel row, clamped to the grid. TimeGrid keeps reporting the old index for a moment after the content is replaced.

Fetch full program details for a focused grid cell and swap the lightweight schedule item for the fully-loaded node. Render-thread promise: replaces the former LoadProgramDetailsTask, a pure-fetch Task consumed via createObject + observeField (Phase-3a collapse; canonical in docs/dev/promises.md). The transform here is a SINGLE item (transformBaseItem, not array processing), so it's render-thread-acceptable.

A failed channel page is not the end of the list: keep the rows already here and fetch the same page again after a backoff delay (scheduleRetry).

Channels loaded callback: handles both first and subsequent pages. First page: creates grid content, shows channels immediately. Subsequent pages: appends channels to existing grid. Programs are not part of a page: reconcilePrograms loads them for the rows near the focus.

onDestroy: Full teardown releasing all resources before component removal. The guide is a child of BaseGridView, not a routed view, so BaseGridView calls this (hideTVGuide and its own onDestroy); the router never will.

The left edge sets the time window (guidePrograms.timeWindow): the blocks near the focus fetch what they miss of it, and what falls far outside it is trimmed. Blocks farther away catch up when the focus reaches them.

Handle user selecting "Record Channel" from Program Details

Handle user selecting "Record Series" from Program Details

Off screen (something plays on top of the library): retries wait until the guide is back.

BaseGridView forwards onScreenShown / onScreenHidden: the guide is its child, not a routed view.

Handle user selecting "Watch Channel" from Program Details

Brings the rows near the focus to the programs they should hold: drops blocks beyond the cap, updates the text shown in rows without programs, starts the next fetch if none is in flight, and arms the retry timer for a failed block whose delay is not up yet.

Rebuilds the guide for the current m.channelQuery: forgets every channel and program, and loads the list from its first page.

Forgets every program and the channel rows' ids: the channel list is being rebuilt.

Runs m.channelQuery from startIndex on a NEW LoadChannelsTask node, releasing the run in flight. Never a relaunch of the previous node: see replaceTask.

Arms the retry timer for the earliest failure whose delay is not up yet (a channel page with none in flight, or a wanted program block with no fetch in flight), or stops it when nothing waits or the guide is off screen.

Called by BaseGridView after setting filter/searchTerm to avoid double-fire. Loads the channel list in pages of CHANNEL_PAGE_SIZE for fast initial display.

Fetches the programs of one block on a new LoadScheduleTask node.

Records (or, if it already records, cancels) the program in the details pane, on a new RecordProgramTask node, so a second press while one is in flight starts a run of its own.

A row without programs reads "Loading…" while a block around the focus is still loading, "Schedule unavailable" while one is waiting to retry, and "No schedule information" once they have all loaded. TimeGrid has one text for every such row, so it follows the rows the user can see.

programs without those channel already holds at the edge an extension overlaps: the held programs from index, stepping by stepBy (-1 from the end, 1 from the start), while they start at or after (-1) / at or before (1) boundary.