chore(docs): update code docs

Author: jellyrock[bot]

docs/components_home_HomeRows.bs.html

@@ -169,6 +169,23 @@
       end for
     end if
 
+  else if m.top.itemsToLoad = "activeRecordings"
+    params = {}
+    params["userId"] = globalUser.id
+    params["isInProgress"] = true
+    params["limit"] = 16 ' parity with onNow
+    params["imageTypeLimit"] = 1
+    params["enableImageTypes"] = "Primary,Thumb,Backdrop"
+    params["enableTotalRecordCount"] = false
+    params["fields"] = "ChannelInfo,PrimaryImageAspectRatio"
+
+    data = fetchJson(GetApi().BuildGetLiveTvRecordingsRequest(params), "activeRecordings")
+    if isValid(data) and isValid(data.Items)
+      for each item in data.Items
+        results.push(m.transformer.transformBaseItem(item))
+      end for
+    end if
+
     ' Extract array of persons from Views and download full metadata for each
   else if m.top.itemsToLoad = "people"
     if not isValid(m.top.peopleList)

docs/components_home_LoadItemsTask.bs.html

@@ -265,7 +265,7 @@
 '     which never reach renderItem() and would otherwise leak the observer.
 ' This function therefore only needs to install — not clear.
 sub applyPlayedPercentage(item as object)
-  if item.type = "Program"
+  if item.type = "Program" or item.type = "Recording"
     nowSeconds = CreateObject("roDateTime").AsSeconds()
     m.poster.playedPercentage = computeProgramBroadcastProgress(item.PlayStart, item.PlayDuration, nowSeconds)
     item.observeField("playedPercentage", "onProgramProgressChanged")

docs/components_ui_rowitem_JRRowItem.bs.html

@@ -184,7 +184,7 @@
     if isValid(row)
       for j = 0 to row.getChildCount() - 1
         item = row.getChild(j)
-        if isValid(item) and item.type = "Program"
+        if isValid(item) and (item.type = "Program" or item.type = "Recording")
           item.playedPercentage = computeProgramBroadcastProgress(item.PlayStart, item.PlayDuration, nowSeconds)
           ' Expiry check uses the same window math as the progress computation.
           ' PlayStart/PlayDuration default to 0 for items missing broadcast data —

docs/components_ui_rowlist_JRRowList.bs.html

@@ -669,6 +669,13 @@
     return m.validatedReq("GET", buildURL("/LiveTv/Programs/Recommended", params))
   end function
 
+  ' Build a request AA to get Live TV recordings, for use with fetchRes() or fetchJson().
+  ' @param params - Query parameters (isInProgress, limit, status, etc.)
+  ' @returns Request AA: { method, url } or invalid if server URL not set
+  function BuildGetLiveTvRecordingsRequest(params = {} as object) as dynamic
+    return m.validatedReq("GET", buildURL("/LiveTv/Recordings", params))
+  end function
+
   ' ═══════════════════════════════════════════════════════════════════════════
   ' STUDIOS ENDPOINTS
   ' ═══════════════════════════════════════════════════════════════════════════