Anchor m.liveTvEpochAtPosition0 on first play tick. Idempotent.

Same contract ItemDetails runs; see the comment there. The reachable trigger on this surface is a live-TV program boundary: setButtonStates() re-derives the row from the refreshed program's metadata, and populateData() repaints the title, subtitle and logo in the same turn, so the menu closing reads as the OSD moving to the new program rather than as a dialog dismissing itself.

Run the action for a button ID. Reached two ways (a press on a visible button, and a row picked out of the "More" menu), so the overflow menu adds no second copy of this mapping. VideoPlayerView.onOSDAction routes action from here.

1s timer: auto-hide on inactivity AND drive the behind-live countdown while paused

onDestroy: Full teardown releasing all resources before component removal Called by VideoPlayerView.onDestroy() since OSD is a child component, not a SceneManager scene

onItemDataChanged: Reads typed fields from JellyfinBaseItem node and populates OSD display.

Replaces the old JSON-parsing setFields(). The item node is immutable - all metadata is read directly from typed fields (item.type, item.name, item.communityRating, etc.)

Content Type Detection (isMovie/isSeries): These flags determine which user settings control ratings display:

• isMovie=true: Uses uiMoviesShowRatings setting
• isSeries=true: Uses uiTvShowsDisableCommunityRating setting

Detection Priority (applied in order):

1. API flags: Uses isMovie/isSeries from JellyfinBaseItem if provided
2. Flag validation: Ensures mutual exclusivity (both cannot be true)
3. Type-based: Recording types always classified as series content
4. Metadata heuristic: Presence of seriesName/parentIndexNumber indicates series
5. Default fallback: Assumes movie content if no other indicators

Snapshot the current behindLive into accumulated and start the wall-clock pause counter. Wall-clock math takes over from here because Roku's m.top.position keeps advancing during pause for live HLS DVR streams (it tracks the live edge, not the user's playhead), which would silently zero out position-math.

Re-anchor epochAtPosition0 so play-math continues from the same offset where wall-clock math left off, then clear pause state.

Open the overflow menu. Rows carry the label and glyph their buttons were wearing and resolve back to a button ID, so a selection runs through dispatchOsdAction rather than a second copy of the mapping.

The cap for the left row: it may not reach the right group's leftmost edge.

The left row's geometry, in ONE place so the cap and the overflow menu's anchor cannot be derived from different numbers.

The right group is right-ALIGNED, so its origin is its right edge and it grows leftward. Its width is derived from its live child count so pinning a second button there correctly costs the left row a slot.

translation is taken as a SCREEN coordinate: the OSD is mounted at the origin of a full-screen view, which is the same assumption the right group's own 1830 origin already encodes.

setButtonStates: Disable previous/next buttons if needed and remove any other unneeded buttons

setEndsAtText: "Ends at ", refreshed on every clock minute tick.

The time goes through formatDisambiguatedTime(), the same rule ItemDetails' "Ends at" chip uses, so it picks up an am/pm suffix exactly when the bare <Clock /> beside it can't disambiguate (across noon/midnight, or beyond a 12-hour horizon). The suffix changes the label's width, which is safe here: endsAtGroup is a horiz LayoutGroup with horizAlignment="right", so its origin is the right edge of the last child and it grows leftward from the action-safe x=1824 rather than toward the screen edge.

The per-moment half: greys the button at the live edge, restores it once the user is behind. A no-op for non-live items, where the button is not a member at all.

Called from onProgressPercentageChanged() (position updates) and inactiveCheck() (1s timer). The timer ensures behind-live derived state ticks while paused.