import { useQuery } from '@tanstack/react-query'; import { CircleCheck, EyeOff, MoreHorizontal, Pencil, Undo2 } from 'lucide-react'; import { useCallback, useEffect, useRef, useState } from 'react'; import { useNavigate, useSearchParams } from 'react-router'; import { toast } from 'sonner'; import { CardEditor } from '@/features/editors'; import { Explain } from '@/features/Explain'; import { FlipCard, StreakChip, StudyFooter, StudyTopBar, useStreak } from '@/features/flashcards'; import { api, errorMessage } from '@/lib/api'; import { useAiStatus, useRefresh } from '@/lib/queries'; import type { DueCounts, QueueCard } from '@/lib/types'; import { cx, formatMinutes, plural, useDocumentTitle, useHotkeys } from '@/lib/util'; import { Badge, Button, ClassDot, Dialog, ErrorState, IconButton, Menu, MenuItem, PageLoading } from '@/ui'; interface QueueResponse { cards: QueueCard[]; counts: DueCounts; } const LEARN_AHEAD_MS = 20 * 60_000; const RATING_STYLE: Record = { 1: 'border-bad/40 text-bad hover:bg-bad-soft', 2: 'border-warn/40 text-warn hover:bg-warn-soft', 3: 'border-good/40 text-good hover:bg-good-soft', 4: 'border-accent/40 text-accent hover:bg-accent-soft', }; /** Spaced-repetition review: due cards first, graded Again / Hard / Good / Easy and rescheduled by FSRS. */ export default function ReviewPage() { const [params] = useSearchParams(); const deckId = params.get('deckId') ?? ''; const classId = params.get('classId') ?? ''; const navigate = useNavigate(); const refresh = useRefresh(); const ai = useAiStatus(); useDocumentTitle('Review'); const scope = deckId ? `deckId=${deckId}` : classId ? `classId=${classId}` : ''; const query = useQuery({ queryKey: ['review', scope], queryFn: () => api.get(`/api/review/queue?${scope}`), staleTime: Infinity, gcTime: 0, refetchOnWindowFocus: false, }); const [queue, setQueue] = useState(null); const [flipped, setFlipped] = useState(false); const [seenAnswer, setSeenAnswer] = useState(false); const [leaving, setLeaving] = useState<'left' | 'right' | null>(null); const { streak, burst, record, reset: resetStreak, hot } = useStreak(); const [busy, setBusy] = useState(false); const [done, setDone] = useState({ reviewed: 0, again: 0 }); const [last, setLast] = useState<{ cardId: string; snapshot: QueueCard[]; wasAgain: boolean; streakBefore: number } | null>(null); const [editing, setEditing] = useState(null); const [draft, setDraft] = useState({ front: '', back: '', hint: '', tags: [] as string[] }); const startedAt = useRef(Date.now()); const scopeTitle = useRef(''); useEffect(() => { if (query.data && queue === null) { setQueue(query.data.cards); const first = query.data.cards[0]; scopeTitle.current = deckId ? (first?.deckTitle ?? 'Deck') : classId ? (first?.className ?? 'Class') : 'All classes'; } }, [query.data, queue, deckId, classId]); const current = queue?.[0]; useEffect(() => { setFlipped(false); setSeenAnswer(false); setLeaving(null); }, [current?.card.id, current?.card.reps]); const flip = useCallback(() => { if (!current || busy) return; setFlipped((f) => !f); setSeenAnswer(true); }, [current, busy]); const rate = useCallback( async (rating: 1 | 2 | 3 | 4) => { if (!current || !queue || busy || !seenAnswer) return; setBusy(true); const snapshot = queue; const streakBefore = streak; // The card swipes away while the new schedule is being saved. setLeaving(rating === 1 ? 'left' : 'right'); try { const [res] = await Promise.all([api.post<{ result: QueueCard }>('/api/review/answer', { cardId: current.card.id, rating }), new Promise((r) => setTimeout(r, 230))]); record(rating > 1); const updated = res.result; const rest = queue.slice(1); const dueSoon = (updated.card.state === 1 || updated.card.state === 3) && (updated.card.due ?? 0) - Date.now() < LEARN_AHEAD_MS; if (dueSoon) { // Bring a learning card back after a few others, so it is not seen twice in a row. const at = Math.min(rest.length, rating === 1 ? 3 : 6); rest.splice(at, 0, updated); } setQueue(rest); setDone((d) => ({ reviewed: d.reviewed + 1, again: d.again + (rating === 1 ? 1 : 0) })); setLast({ cardId: current.card.id, snapshot, wasAgain: rating === 1, streakBefore }); if (rest.length === 0) { // The first load is capped; fetch anything that is still due. const more = await api.get(`/api/review/queue?${scope}`).catch(() => null); if (more && more.cards.length > 0) setQueue(more.cards); } } catch (e) { setLeaving(null); toast.error(errorMessage(e)); } finally { setBusy(false); } }, [current, queue, busy, scope, seenAnswer, streak, record], ); const undo = useCallback(async () => { if (!last || busy) return; setBusy(true); try { const res = await api.post<{ result: QueueCard }>('/api/review/undo', { cardId: last.cardId }); setQueue(last.snapshot.map((c) => (c.card.id === last.cardId ? res.result : c))); setDone((d) => ({ reviewed: Math.max(0, d.reviewed - 1), again: Math.max(0, d.again - (last.wasAgain ? 1 : 0)) })); resetStreak(last.streakBefore); setLast(null); } catch (e) { toast.error(errorMessage(e)); } finally { setBusy(false); } }, [last, busy, resetStreak]); const suspend = async () => { if (!current || !queue) return; await api.patch(`/api/cards/${current.card.id}`, { suspended: true }).catch((e) => toast.error(errorMessage(e))); setQueue(queue.slice(1)); toast('Card suspended. Unsuspend it from the deck page.'); }; const saveEdit = async () => { if (!editing || !queue) return; try { await api.patch(`/api/cards/${editing.card.id}`, draft); setQueue(queue.map((c) => (c.card.id === editing.card.id ? { ...c, card: { ...c.card, ...draft } } : c))); setEditing(null); } catch (e) { toast.error(errorMessage(e)); } }; const exit = () => { void refresh(); navigate(deckId ? `/decks/${deckId}` : classId ? `/classes/${classId}` : '/'); }; useHotkeys({ space: (e) => (e.preventDefault(), flip()), Enter: flip, ArrowUp: (e) => (e.preventDefault(), flip()), ArrowDown: (e) => (e.preventDefault(), flip()), // Left = missed it, right = got it. The number keys give the finer four-way rating. ArrowLeft: () => void rate(1), ArrowRight: () => void rate(3), '1': () => void rate(1), '2': () => void rate(2), '3': () => void rate(3), '4': () => void rate(4), u: () => void undo(), 'mod+z': (e) => { e.preventDefault(); void undo(); }, e: () => { if (current) { setDraft({ front: current.card.front, back: current.card.back, hint: current.card.hint, tags: current.card.tags }); setEditing(current); } }, }); if (query.isError) return query.refetch()} className="pt-24" />; if (!queue) return ; const remaining = queue.length; const counts = { learning: queue.filter((c) => c.card.state === 1 || c.card.state === 3).length, review: queue.filter((c) => c.card.state === 2).length, fresh: queue.filter((c) => c.card.state === 0).length, }; const totalPlanned = done.reviewed + remaining; return (
{counts.fresh} new {counts.learning} learning {counts.review} due
{remaining} left {current && ( } > } onSelect={() => { setDraft({ front: current.card.front, back: current.card.back, hint: current.card.hint, tags: current.card.tags }); setEditing(current); }} > Edit card } onSelect={suspend}> Suspend card )} } />
{!current ? (

{done.reviewed > 0 ? 'Review complete' : 'Nothing due right now'}

{done.reviewed > 0 ? `You reviewed ${plural(done.reviewed, 'card')} in ${formatMinutes((Date.now() - startedAt.current) / 1000)}${done.again > 0 ? `, with ${done.again} to see again soon` : ''}.` : 'Cards come back when you are about to forget them. Check in again later today or tomorrow.'}

{deckId && ( )}
) : ( <>
{current.className} ยท {current.deckTitle} {current.card.state === 0 ? New : current.card.state === 2 ? Review : Learning}
void rate(known ? 3 : 1) : undefined} leaving={leaving} burst={burst} footer={ai.data?.ready ? : undefined} /> )}
{current && ( {seenAnswer ? (
{current.previews.map((p) => ( ))}
) : ( )}
)} !o && setEditing(null)} title="Edit card" size="lg" footer={ <> } > setDraft({ front: c.front, back: c.back, hint: c.hint ?? '', tags: c.tags })} onSubmit={saveEdit} showHint />
); }