Skip to content

DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.

11.0 KB
Raw Blame
"use client";

import { useCallback, useEffect, useRef, useState, type ReactNode } from "react";
import { useRouter, useSearchParams } from "next/navigation";
import { useTranslation } from "react-i18next";
import { ArrowRight, CalendarCheck, Check, ClipboardList, FileUp, Loader2 } from "lucide-react";
import { QuestionBankSection } from "@/components/space/question-bank";
import SpaceSectionHeader from "@/components/space/SpaceSectionHeader";
import { practiceRoute, questionBankRoute } from "@/lib/learning-routes";
import { getPracticeQueue, getPracticeSummary, type PracticeSummary } from "@/lib/practice-api";
import { LearningErrorState, LearningShell } from "../LearningShell";
import { ReviewHome } from "./ReviewHome";
import { PracticeImport } from "./PracticeImport";
import { PracticeSession } from "./PracticeSession";
import { PracticeInsights } from "./PracticeInsights";

/** Shared collections and imports; both surfaces can start a manual practice session. */
export function PracticePage({ mode = "practice" }: { mode?: "practice" | "library" }) {
  const search = useSearchParams();
  if (mode === "practice" && !search.has("question")) return <ReviewHome />;
  return <PracticeCollectionPage mode={mode} initialImport={search.get("create") === "1"} />;
}

function PracticeCollectionPage({ mode, initialImport }: { mode: "practice" | "library"; initialImport: boolean }) {
  const { t } = useTranslation();
  const libraryOnly = mode === "library";
  const pageRoute = libraryOnly ? questionBankRoute : practiceRoute;
  const router = useRouter();
  const search = useSearchParams();
  const tab = search.get("view") === "mistakes" ? "mistakes" : "bank";
  const [summary, setSummary] = useState<PracticeSummary | null>(null);
  const [error, setError] = useState("");
  const [importOpen, setImportOpen] = useState(initialImport);
  const [notice, setNotice] = useState("");
  const [revision, setRevision] = useState(0);
  const [session, setSession] = useState<number[] | null>(() => {
    const id = Number(search.get('question'));
    return Number.isSafeInteger(id) && id > 0 ? [id] : null;
  });
  const [starting, setStarting] = useState(false);
  const pending = useRef(false);
  const summarySequence = useRef(0);
  const refresh = useCallback(async () => {
    const sequence = ++summarySequence.current;
    try {
      const result = await getPracticeSummary();
      if (sequence === summarySequence.current) {
        setSummary(result);
        setError("");
      }
    } catch (err) {
      if (sequence === summarySequence.current)
        setError(err instanceof Error ? err.message : String(err));
    }
  }, []);
  useEffect(() => {
    void refresh();
    const onFocus = () => {
      void refresh();
    };
    window.addEventListener("focus", onFocus);
    const timer = window.setInterval(onFocus, 60000);
    return () => {
      // Invalidate pending requests after this scope is replaced.
      // eslint-disable-next-line react-hooks/exhaustive-deps
      summarySequence.current++;
      window.removeEventListener("focus", onFocus);
      window.clearInterval(timer);
    };
  }, [refresh]);
  function closeSession() {
    setSession(null);
    setRevision(value => value + 1);
    void refresh();
  }
  async function startReview() {
    if (pending.current) return;
    pending.current = true;
    setStarting(true);
    setNotice("");
    try {
      const queue = await getPracticeQueue();
      if (queue.length) setSession(queue.map(item => item.entry.id));
      else {
        setNotice(t("You are caught up. Come back when your next reviews are due."));
        void refresh();
      }
    } catch (err) {
      setError(err instanceof Error ? err.message : String(err));
    } finally {
      pending.current = false;
      setStarting(false);
    }
  }
  function switchTab(view: "bank" | "mistakes") {
    const next = new URLSearchParams(search.toString());
    next.set("view", view);
    router.replace(pageRoute(next), { scroll: false });
  }
  return (
    <PracticePageShell
      libraryOnly={libraryOnly}
      action={
        !session && (
          <button
            type="button"
            onClick={() => setImportOpen(open => !open)}
            aria-expanded={importOpen}
            className="inline-flex items-center gap-2 rounded-xl border border-border bg-card px-4 py-2.5 text-sm font-medium hover:bg-muted"
          >
            <FileUp size={16} />
            {t("Import questions")}
          </button>
        )
      }
    >
      {session ? (
        <PracticeSession ids={session} onClose={closeSession} backLabel={libraryOnly ? t("Back to library") : undefined} />
      ) : (
        <>
          {notice && (
            <div
              role="status"
              className="mb-4 flex items-start gap-2 rounded-xl bg-emerald-500/10 p-3 text-sm"
            >
              <Check size={16} className="mt-0.5 shrink-0 text-emerald-600" />
              {notice}
            </div>
          )}
          {importOpen && (
            <PracticeImport
              key={tab}
              initialTarget={tab}
              onClose={() => setImportOpen(false)}
              onImported={message => {
                setNotice(message);
                setImportOpen(false);
                setRevision(value => value + 1);
                void refresh();
              }}
            />
          )}
          {error && <LearningErrorState message={error} onRetry={() => void refresh()} />}
          {!libraryOnly && <PracticeInsights revision={revision} />}
          {!libraryOnly && (
            <section
              aria-labelledby="practice-today"
              className="mb-7 rounded-2xl border border-border bg-card p-5 sm:p-6"
            >
              <div className="flex flex-col justify-between gap-5 sm:flex-row sm:items-center">
                <div className="flex items-start gap-4">
                  <div className="rounded-xl bg-emerald-500/10 p-3 text-emerald-600 dark:text-emerald-400">
                    <CalendarCheck size={22} />
                  </div>
                  <div>
                    <h2 id="practice-today" className="text-base font-semibold">
                      {t("Today's review")}
                    </h2>
                    <p className="mt-1 text-sm text-muted-foreground">
                      {summary
                        ? summary.due > 0
                          ? t("{{count}} questions are ready to revisit.", { count: summary.due })
                          : t("You are caught up. Come back when your next reviews are due.")
                        : t("Loading…")}
                    </p>
                    {summary && (
                      <p className="mt-2 text-xs text-muted-foreground">
                        {t("{{done}} reviewed today · {{overdue}} overdue", {
                          done: summary.reviewed_today,
                          overdue: summary.overdue,
                        })}
                        {summary.due === 0 && summary.next_due_at && (
                          <>
                            {" "}
                            ·{" "}
                            {t("Next review: {{date}}", {
                              date: new Date(summary.next_due_at * 1000).toLocaleDateString(),
                            })}
                          </>
                        )}
                      </p>
                    )}
                  </div>
                </div>
                <button
                  type="button"
                  onClick={() => void startReview()}
                  disabled={starting || !summary?.due || !!error}
                  className="inline-flex shrink-0 items-center justify-center gap-2 rounded-xl bg-primary px-5 py-3 text-sm font-medium text-primary-foreground disabled:opacity-40"
                >
                  {starting ? (
                    <Loader2 size={16} className="animate-spin" />
                  ) : (
                    <ArrowRight size={16} />
                  )}
                  {t("Start today's review")}
                </button>
              </div>
              <p className="mt-4 border-t border-border pt-3 text-xs leading-relaxed text-muted-foreground">
                {t(
                  "New mistakes return the next day. Reviews adapt to your recall; overdue questions come first. Work in sets of up to 20."
                )}
              </p>
            </section>
          )}
          <div
            role="tablist"
            aria-label={t("Practice collections")}
            className="mb-5 flex gap-5 border-b border-border"
          >
            {(["bank", "mistakes"] as const).map(view => (
              <button
                key={view}
                id={`practice-tab-${view}`}
                type="button"
                role="tab"
                aria-selected={tab === view}
                tabIndex={tab === view ? 0 : -1}
                onKeyDown={event => {
                  if (event.key === "ArrowLeft" || event.key === "ArrowRight") {
                    event.preventDefault();
                    const next = view === "bank" ? "mistakes" : "bank";
                    switchTab(next);
                    document.getElementById(`practice-tab-${next}`)?.focus();
                  }
                }}
                aria-controls="practice-collection"
                onClick={() => switchTab(view)}
                className={`border-b-2 px-1 pb-3 text-sm ${tab === view ? "border-primary font-semibold text-foreground" : "border-transparent text-muted-foreground hover:text-foreground"}`}
              >
                {view === "bank" ? t("Question Bank") : t("Mistakes")}
                <span className="ml-2 text-xs tabular-nums text-muted-foreground">
                  {summary ? (view === "bank" ? summary.total : summary.mistakes) : "—"}
                </span>
              </button>
            ))}
          </div>
          <div id="practice-collection" role="tabpanel" aria-labelledby={`practice-tab-${tab}`}>
            <QuestionBankSection
              key={`${tab}:${revision}`}
              embedded
              onChanged={refresh}
              mistakesOnly={tab === "mistakes"}
              onPractice={ids => {
                setSession(ids);
                setNotice("");
              }}
            />
          </div>
        </>
      )}
    </PracticePageShell>
  );
}

function PracticePageShell({
  libraryOnly,
  action,
  children,
}: {
  libraryOnly: boolean;
  action: ReactNode;
  children: ReactNode;
}) {
  const { t } = useTranslation();
  if (libraryOnly) {
    // SpaceMain supplies the Learning Space breadcrumb and page scroll container.
    return (
      <>
        <SpaceSectionHeader
          title={t("Question Bank")}
          description={t("Questions from every source, together with your own imports.")}
          action={action}
        />
        {children}
      </>
    );
  }
  return (
    <LearningShell
      title={t("Practice")}
      subtitle={t("Collect what you learn. Practice what matters. Remember it for longer.")}
      action={action}
    >
      {children}
    </LearningShell>
  );
}