Update code docs

Author: jellyrock-bot

docs/components_ItemDetails.bs.html

@@ -73,6 +73,10 @@
   m.loadFirstEpisodeTask = CreateObject("roSGNode", "LoadItemsTask")
   m.loadFirstEpisodeTask.itemsToLoad = "seriesFirstEpisode"
 
+  ' Series: fetch the resume/next-up episode in the background for the Resume button
+  m.loadSeriesResumeTask = CreateObject("roSGNode", "LoadItemsTask")
+  m.loadSeriesResumeTask.itemsToLoad = "seriesResume"
+
   ' Season: fetch parent series metadata in the background for ratings/runtime/genres/logo
   m.loadSeasonSeriesTask = CreateObject("roSGNode", "LoadItemsTask")
   m.loadSeasonSeriesTask.itemsToLoad = "metaDataDetails"
@@ -175,7 +179,11 @@
       else
         m.buttonGrp.buttonFocused = 0
       end if
-      focusButtonGroupChild()
+      ' Only move actual focus when the button group already owns it — avoid stealing
+      ' focus from the extras row or description when the button arrives asynchronously.
+      if m.buttonGrp.isInFocusChain()
+        focusButtonGroupChild()
+      end if
     else
       ' Resume button already present — update text and tick values
       resumeButton.text = resumeText
@@ -829,7 +837,18 @@
     manageGoToSeriesButton(item.type)
     manageDeleteButton()
 
-    ' Season: kick off background fetch of parent series data for ratings/runtime/genres/logo
+    ' Series: kick off background fetch of resume/next-up episode for the Resume button
+    if item.type = "Series"
+      ' Unobserve before re-observing to prevent callbacks stacking on repeated content changes.
+      m.loadSeriesResumeTask.unobserveField("content")
+      m.loadSeriesResumeTask.control = "STOP"
+      m.top.nextUpEpisode = invalid
+      m.loadSeriesResumeTask.itemId = item.id
+      m.loadSeriesResumeTask.observeField("content", "onSeriesResumeLoaded")
+      m.loadSeriesResumeTask.control = "RUN"
+    end if
+
+    ' Season: kick off background fetch of parent series metadata for ratings/runtime/genres/logo
     if item.type = "Season" and isValidAndNotEmpty(item.seriesId)
       ' Unobserve before re-observing to prevent callbacks stacking on repeated content changes.
       m.loadSeasonSeriesTask.unobserveField("content")
@@ -1481,6 +1500,19 @@
   end if
 end sub
 
+' onSeriesResumeLoaded: Set nextUpEpisode from seriesResume task result to show/hide the Resume button
+sub onSeriesResumeLoaded()
+  m.loadSeriesResumeTask.unobserveField("content")
+  content = m.loadSeriesResumeTask.content
+  m.loadSeriesResumeTask.content = []
+
+  if isValid(content) and content.count() > 0
+    m.top.nextUpEpisode = content[0]
+  else
+    m.top.nextUpEpisode = invalid
+  end if
+end sub
+
 ' onShuffleEpisodeDataLoaded: Play shuffled episodes for Series
 sub onShuffleEpisodeDataLoaded()
   m.getShuffleEpisodesTask.unobserveField("data")

docs/components_home_LoadItemsTask.bs.html

@@ -242,6 +242,31 @@
       node = m.transformer.transformBaseItem(data.Items[0])
       if isValid(node) then results.push(node)
     end if
+  else if m.top.itemsToLoad = "seriesResume"
+    ' For the series Resume button, prefer an in-progress (resumable) episode and fall back to the next unstarted episode.
+    ' Uses the same endpoint as the Continue Watching home row so the Resume button is consistent with it.
+    resumeData = api.users.GetResumeItemsByQuery(globalUser.id, {
+      ParentId: m.top.itemId,
+      Filters: "IsResumable",
+      SortBy: "DatePlayed",
+      SortOrder: "Descending",
+      Limit: 1,
+      recursive: true,
+      Fields: "PrimaryImageAspectRatio",
+      EnableTotalRecordCount: false
+    })
+    if isValid(resumeData) and isValid(resumeData.Items) and resumeData.Items.Count() > 0
+      node = m.transformer.transformBaseItem(resumeData.Items[0])
+      if isValid(node) then results.push(node)
+    else
+      ' No resumable episode — fall back to next unstarted episode.
+      ' DisableFirstEpisode: true so a Resume button never appears for a completely unwatched series.
+      nextUpData = api.shows.GetNextUp({ UserId: globalUser.id, SeriesId: m.top.itemId, Limit: 1, DisableFirstEpisode: true, Fields: "PrimaryImageAspectRatio" })
+      if isValid(nextUpData) and isValid(nextUpData.Items) and nextUpData.Items.Count() > 0
+        node = m.transformer.transformBaseItem(nextUpData.Items[0])
+        if isValid(node) then results.push(node)
+      end if
+    end if
   else if m.top.itemsToLoad = "metaData"
     results.push(ItemMetaData(m.top.itemId))
   else if m.top.itemsToLoad = "metaDataDetails"

docs/data/search.json

@@ -676,13 +676,6 @@
     if isValid(trailerData)
       group.trailerAvailable = trailerData.Count() > 0
     end if
-  else if item.type = "Series"
-    ' Load NextUp episode to decide whether to show the Resume button
-    nextUpData = api.shows.GetNextUp({ UserId: m.global.user.id, SeriesId: item.id, Limit: 1, Fields: "PrimaryImageAspectRatio" })
-    if isValid(nextUpData) and isValid(nextUpData.Items) and nextUpData.Items.Count() > 0
-      transformer = JellyfinDataTransformer()
-      group.nextUpEpisode = transformer.transformBaseItem(nextUpData.Items[0])
-    end if
   end if
 
   ' Watch for button presses