Close the gap between the flashcards study screen and the mockup

Add real session-history navigation (Previous/Next/Shuffle), compact side panels, and a segmented progress row to match the mockup layout. Flashcards now opens straight into Study, with library management moved into the Options menu ("Manage Flashcards") and Export hidden from the UI (Import stays). Shuffle is backed by a real, due-before-new randomized pick on the backend, not a decorative toggle.
2026-07-22 00:43:52 -05:00
parent 70aa425fde
commit 09b670d5d4
21 changed files with 555 additions and 70 deletions
@@ -32,4 +32,23 @@ public static class FlashcardScheduling
        }
        return streak;
    }
+
+    // Picks which candidate in an already-sorted pool becomes the next card. Non-shuffle: the
+    // first not already excluded this session (today's deterministic oldest-first behavior).
+    // Shuffle: a random pick among the non-excluded candidates - `randomIndex(n)` must return a
+    // value in [0, n); production passes Random.Shared.Next, tests pass a fixed stub so the
+    // excluded-id-to-original-index mapping is verifiable without relying on real randomness.
+    public static int? PickIndex(IReadOnlyList<string> poolIds, ISet<string> exclude, bool shuffle, Func<int, int> randomIndex)
+    {
+        if (!shuffle)
+        {
+            for (var i = 0; i < poolIds.Count; i++)
+                if (!exclude.Contains(poolIds[i])) return i;
+            return null;
+        }
+        var candidates = new List<int>();
+        for (var i = 0; i < poolIds.Count; i++)
+            if (!exclude.Contains(poolIds[i])) candidates.Add(i);
+        return candidates.Count == 0 ? null : candidates[randomIndex(candidates.Count)];
+    }
 }