From bacb9ca0bb09abcb155d562fde9a81eff1d8e044 Mon Sep 17 00:00:00 2001
From: Duncan Tourolle <duncan@tourolle.paris>
Date: Thu, 23 Jul 2026 20:03:16 +0200
Subject: [PATCH] docs(traces): tag episode focus view and library detail with
 TRACES

Add TRACES comments linking the episode focus view and library detail
page to their existing requirements.

TRACES: UR-035, UR-038, UR-048 | DR-043, DR-061, DR-062
---
 .../library/EpisodeFocusView.svelte           |  1 +
 src/routes/library/[id]/+page.svelte          | 47 ++++++++++++++-----
 2 files changed, 35 insertions(+), 13 deletions(-)

diff --git a/src/lib/components/library/EpisodeFocusView.svelte b/src/lib/components/library/EpisodeFocusView.svelte
index ea87ad38..86fb965b 100644
--- a/src/lib/components/library/EpisodeFocusView.svelte
+++ b/src/lib/components/library/EpisodeFocusView.svelte
@@ -1,3 +1,4 @@
+<!-- TRACES: UR-048 | DR-061, DR-062 -->
 <script lang="ts">
   import { goto } from "$app/navigation";
   import { truncateMiddle } from "$lib/utils/truncateMiddle";
diff --git a/src/routes/library/[id]/+page.svelte b/src/routes/library/[id]/+page.svelte
index a1398361..890e549e 100644
--- a/src/routes/library/[id]/+page.svelte
+++ b/src/routes/library/[id]/+page.svelte
@@ -1,3 +1,4 @@
+<!-- TRACES: UR-035, UR-038, UR-048 | DR-043, DR-062 -->
 <script lang="ts">
   import { onMount, untrack } from "svelte";
   import { page } from "$app/stores";
@@ -515,20 +516,25 @@
         </div>
       {/if}
 
-      <!-- Cast Section - for Movies, Series, and Episodes -->
-      {#if (item.type === "Movie" || item.type === "Series" || item.type === "Episode") && item.people?.length}
-        <CastSection people={item.people ?? undefined} />
-      {/if}
+      <!-- Cast / Related — for Movies and Episodes these sit above the content
+           block; for Series they render *below* the seasons instead, so
+           continuation content precedes discovery content (UX §5B.4). -->
+      {#if item.type !== "Series"}
+        <!-- Cast Section - for Movies and Episodes -->
+        {#if (item.type === "Movie" || item.type === "Episode") && item.people?.length}
+          <CastSection people={item.people ?? undefined} />
+        {/if}
 
-      <!-- Related Items Section - for Movies and Series -->
-      {#if (item.type === "Movie" || item.type === "Series") && (item.genres?.length || item.people?.length)}
-        <RelatedItemsSection
-          currentItemId={item.id}
-          itemType={item.type}
-          genres={item.genres ?? undefined}
-          people={item.people ?? undefined}
-          limit={12}
-        />
+        <!-- Related Items Section - for Movies -->
+        {#if item.type === "Movie" && (item.genres?.length || item.people?.length)}
+          <RelatedItemsSection
+            currentItemId={item.id}
+            itemType={item.type}
+            genres={item.genres ?? undefined}
+            people={item.people ?? undefined}
+            limit={12}
+          />
+        {/if}
       {/if}
 
       <!-- Content items -->
@@ -580,6 +586,21 @@
                 />
               {/each}
             {/if}
+
+            <!-- Discovery content sits below the episodes (UX §5B.4) -->
+            {#if item.people?.length}
+              <CastSection people={item.people ?? undefined} />
+            {/if}
+
+            {#if item.genres?.length || item.people?.length}
+              <RelatedItemsSection
+                currentItemId={item.id}
+                itemType={item.type}
+                genres={item.genres ?? undefined}
+                people={item.people ?? undefined}
+                limit={12}
+              />
+            {/if}
           </div>
         {:else if item.type === "MusicArtist"}
           <!-- Enhanced artist detail view with discography -->