Homework (/homework — entry points in the drawer and on the create screen) - Assignment intake reuses the study pipeline: pasted text, photos (camera/picker, compressed in the browser) and documents (PDF/DOCX/PPTX/ ODT/text) through lib/image + lib/documents, the same vision step and the same language guard. Raw files never leave the device — only text and JPEG data URLs reach the server. - Two large choice cards: “Just make it” returns the finished homework (answer only, plain text, copy + make it again); “Explain how to make this homework” builds an interactive guide. - The guide is one step per screen in the study-feed snap layout: explanation, three progressive hints (nudge -> hint -> the answer) and an optional checkpoint rendered by the existing activity components (graded through /api/grade). The last screen assembles the solution from the step answers, with a copy button. Checkpoints carry xp 0 so the guide stays free of XP/streak chrome. - Results live in freezmo.homework.v1 with a small history (open/delete); “Make it again” re-runs from the stored assignment text (the vision transcription when photos were used) — no original files are stored. - The answer and the guide are written in the assignment's language, never translated into the UI language. Server - POST /api/homework: NDJSON stage events like /api/generate, the same http-guard, auth checked before parsing, and its own RATE_LIMIT_HOMEWORK (documented in .env.example + the README table). - New prompts in lib/prompts.ts and zod schemas in lib/schemas.ts with the same single repair retry; TEXT_MODEL for content, VISION_MODEL only for photos. New shared client pieces: useNotesIntake, lib/homework store, lib/clipboard, and a shared NDJSON reader in lib/client-api. Also finishing the mobile polish pass from the previous request - Phone ice scene: the top-left orb moved behind the glass header (it sat behind the page heading/subtitle). The settings sheet's scroll cue is now a bare chevron inside a content fade (mask) instead of a chip over the status banner, and the API key card's note/disclosure/actions are tightened. - theme-color now follows the in-app theme (SSR metas still fall back to the OS preference); apple-mobile-web-app-status-bar-style stays “default” because iOS fixes the status-bar text colour at launch. Verified: 78/78 homework checks (text/photo/PDF, both modes, EN+CS, dark+light, 360/390px, copy, history persistence, storage privacy, API language, axe), plus the existing suites re-run (mobile 47/47, pixel contrast 0 below AA, i18n 27/27, desktop regression 72/72). Lint + build clean; service worker freezmo-v6.
152 lines
5.6 KiB
TypeScript
152 lines
5.6 KiB
TypeScript
"use client";
|
|
|
|
import { useMemo, useState } from "react";
|
|
|
|
import { useI18n } from "@/lib/i18n";
|
|
import type { Activity } from "@/lib/schemas";
|
|
import { cn, shuffle } from "@/lib/utils";
|
|
|
|
import {
|
|
ActivityHeader,
|
|
FeedbackPanel,
|
|
Hint,
|
|
PromptCard,
|
|
type ActivityComponentProps,
|
|
} from "./shared";
|
|
|
|
type MatchingActivity = Extract<Activity, { type: "matching" }>;
|
|
|
|
export function Matching({ activity, onAnswered, onNext, isLast, nextLabel }: ActivityComponentProps<MatchingActivity>) {
|
|
const { t, plural } = useI18n();
|
|
const terms = useMemo(
|
|
() => shuffle(activity.pairs.map((pair, index) => ({ index, text: pair.term }))),
|
|
[activity],
|
|
);
|
|
const definitions = useMemo(
|
|
() => shuffle(activity.pairs.map((pair, index) => ({ index, text: pair.definition }))),
|
|
[activity],
|
|
);
|
|
|
|
const [selectedTerm, setSelectedTerm] = useState<number | null>(null);
|
|
const [matched, setMatched] = useState<number[]>([]);
|
|
const [misses, setMisses] = useState(0);
|
|
const [flash, setFlash] = useState<{ term: number; definition: number } | null>(null);
|
|
const [done, setDone] = useState(false);
|
|
|
|
const total = activity.pairs.length;
|
|
const complete = matched.length === total;
|
|
|
|
const onDefinitionTap = (definitionIndex: number) => {
|
|
if (done || selectedTerm === null || matched.includes(definitionIndex)) return;
|
|
if (selectedTerm === definitionIndex) {
|
|
const next = [...matched, definitionIndex];
|
|
setMatched(next);
|
|
setSelectedTerm(null);
|
|
if (next.length === total) {
|
|
const correct = misses === 0;
|
|
setDone(true);
|
|
onAnswered(correct);
|
|
}
|
|
} else {
|
|
setMisses((value) => value + 1);
|
|
setFlash({ term: selectedTerm, definition: definitionIndex });
|
|
window.setTimeout(() => setFlash(null), 500);
|
|
setSelectedTerm(null);
|
|
}
|
|
};
|
|
|
|
return (
|
|
<>
|
|
<ActivityHeader
|
|
type="matching"
|
|
topic={activity.topic}
|
|
extra={
|
|
<span className="rounded-full bg-[var(--surface-strong)] px-3 py-1 text-xs font-bold text-frost-600 dark:text-frost-200">
|
|
{t("matching.matched", { n: matched.length, total })}
|
|
</span>
|
|
}
|
|
/>
|
|
<PromptCard className="py-4">
|
|
<p className="text-lg font-bold text-frost-950 dark:text-frost-50">{activity.instruction}</p>
|
|
<Hint>
|
|
{done
|
|
? t("matching.allMatched")
|
|
: selectedTerm === null
|
|
? t("matching.tapTerm")
|
|
: t("matching.tapDef")}
|
|
</Hint>
|
|
</PromptCard>
|
|
|
|
<div className="grid grid-cols-2 gap-2.5">
|
|
<div className="flex flex-col gap-2.5">
|
|
{terms.map((term) => {
|
|
const isMatched = matched.includes(term.index);
|
|
const isSelected = selectedTerm === term.index;
|
|
const isFlashing = flash?.term === term.index;
|
|
return (
|
|
<button
|
|
key={`term-${term.index}`}
|
|
type="button"
|
|
disabled={isMatched || done}
|
|
onClick={() => setSelectedTerm(isSelected ? null : term.index)}
|
|
className={cn(
|
|
"min-h-16 rounded-2xl border px-3 py-2 text-left text-sm font-semibold backdrop-blur-xl transition-all",
|
|
isMatched
|
|
? "border-emerald-200/80 bg-emerald-50/85 text-emerald-800 dark:border-emerald-400/40 dark:bg-emerald-400/15 dark:text-emerald-100"
|
|
: isSelected
|
|
? "border-accent-400 bg-accent-50/80 text-frost-900 dark:bg-accent-500/20 dark:text-white"
|
|
: "border-white/60 bg-white/55 text-frost-950 hover:bg-white/80 dark:border-white/12 dark:bg-white/[0.07] dark:text-frost-50",
|
|
isFlashing && "animate-wiggle border-rose-400 bg-rose-50 dark:bg-rose-400/15",
|
|
)}
|
|
>
|
|
<span className="mr-1">{isMatched ? "✓" : "•"}</span>
|
|
{term.text}
|
|
</button>
|
|
);
|
|
})}
|
|
</div>
|
|
|
|
<div className="flex flex-col gap-2.5">
|
|
{definitions.map((definition) => {
|
|
const isMatched = matched.includes(definition.index);
|
|
const isFlashing = flash?.definition === definition.index;
|
|
return (
|
|
<button
|
|
key={`def-${definition.index}`}
|
|
type="button"
|
|
disabled={isMatched || done || selectedTerm === null}
|
|
onClick={() => onDefinitionTap(definition.index)}
|
|
className={cn(
|
|
"min-h-16 rounded-2xl border-2 px-3 py-2 text-left text-sm transition-all",
|
|
isMatched
|
|
? "border-emerald-200/80 bg-emerald-50/85 text-emerald-800 dark:border-emerald-400/40 dark:bg-emerald-400/15 dark:text-emerald-100"
|
|
: "border-white/60 bg-white/55 text-frost-700 hover:bg-white/80 disabled:opacity-60 dark:border-white/12 dark:bg-white/[0.07] dark:text-frost-200",
|
|
isFlashing && "animate-wiggle border-rose-400 bg-rose-50 dark:bg-rose-400/15",
|
|
)}
|
|
>
|
|
{definition.text}
|
|
</button>
|
|
);
|
|
})}
|
|
</div>
|
|
</div>
|
|
|
|
{complete ? (
|
|
<FeedbackPanel
|
|
correct={misses === 0}
|
|
explanation={activity.explanation}
|
|
xp={activity.xp}
|
|
isLast={isLast}
|
|
nextLabel={nextLabel}
|
|
onNext={onNext}
|
|
headline={misses === 0 ? t("matching.perfect") : t("matching.slips")}
|
|
detail={
|
|
<span>
|
|
{misses === 0 ? t("matching.firstTry") : plural(misses, "matching.wrongAttempts")}
|
|
</span>
|
|
}
|
|
/>
|
|
) : null}
|
|
</>
|
|
);
|
|
}
|