freezmo/components/activities/shared.tsx
Martin Dvorak ef2a6a3589 Add “Make my homework”, and finish the mobile polish pass
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.
2026-10-08 18:30:33 +00:00

212 lines
7 KiB
TypeScript

"use client";
import { motion } from "framer-motion";
import { useI18n } from "@/lib/i18n";
import type { Activity } from "@/lib/schemas";
import { cn } from "@/lib/utils";
import { Button } from "@/components/ui";
export type ActivityComponentProps<A extends Activity = Activity> = {
activity: A;
/** True when this slide is the one currently filling the screen. */
active: boolean;
/** Language of the deck, so AI grading answers in the same language. */
language?: string;
/** Report the result to the feed (once per attempt). */
onAnswered: (correct: boolean, meta?: { userAnswer?: string }) => void;
/** Scroll the feed to the next slide. */
onNext: () => void;
isLast: boolean;
/** Overrides the feedback button label (the homework guide uses this). */
nextLabel?: string;
};
export const TYPE_META: Record<Activity["type"], { labelKey: string; icon: string; tint: string }> = {
flashcard: { labelKey: "type.flashcard", icon: "🃏", tint: "tint-sky" },
multiple_choice: { labelKey: "type.multipleChoice", icon: "🔘", tint: "tint-lilac" },
true_false: { labelKey: "type.trueFalse", icon: "⚖️", tint: "tint-mint" },
fill_blank: { labelKey: "type.fillBlank", icon: "✏️", tint: "tint-peach" },
matching: { labelKey: "type.matching", icon: "🧲", tint: "tint-sky" },
ordering: { labelKey: "type.ordering", icon: "🔢", tint: "tint-lilac" },
short_answer: { labelKey: "type.shortAnswer", icon: "💬", tint: "tint-rose" },
};
export function ActivityHeader({
type,
topic,
extra,
}: {
type: Activity["type"];
topic?: string;
extra?: React.ReactNode;
}) {
const { t } = useI18n();
const meta = TYPE_META[type];
return (
<div className="flex flex-wrap items-center gap-2">
<span
className={cn(
"inline-flex items-center gap-1.5 rounded-full px-3 py-1 text-xs font-semibold ring-1 ring-white/50 backdrop-blur-sm",
meta.tint,
)}
>
<span aria-hidden>{meta.icon}</span>
{t(meta.labelKey)}
</span>
{topic ? (
<span className="glass-chip rounded-full px-3 py-1 text-xs font-medium text-frost-600 dark:text-frost-300">
{topic}
</span>
) : null}
{extra}
</div>
);
}
export function PromptCard({
children,
className,
}: {
children: React.ReactNode;
className?: string;
}) {
return (
<div className={cn("glass-panel glass-solid rounded-[1.5rem] px-5 py-6 text-balance sm:px-6", className)}>{children}</div>
);
}
export function QuestionText({ children, className }: { children: React.ReactNode; className?: string }) {
return (
<p className={cn("text-xl font-bold leading-snug text-frost-950 sm:text-2xl dark:text-frost-50", className)}>
{children}
</p>
);
}
/** Standard tile used for answer options. */
export function OptionTile({
children,
state = "idle",
disabled,
onClick,
className,
shortcut,
}: {
children: React.ReactNode;
state?: "idle" | "selected" | "correct" | "wrong" | "dim";
disabled?: boolean;
onClick?: () => void;
className?: string;
shortcut?: string;
}) {
const states: Record<string, string> = {
idle: "border-white/60 bg-white/55 hover:bg-white/80 dark:border-white/12 dark:bg-white/[0.07] dark:hover:bg-white/[0.12]",
selected: "border-accent-400 bg-accent-50/80 dark:bg-accent-500/20",
correct:
"border-emerald-300 bg-emerald-50/90 text-emerald-950 dark:border-emerald-400/50 dark:bg-emerald-400/15 dark:text-emerald-50",
wrong: "border-rose-300 bg-rose-50/90 text-rose-950 dark:border-rose-400/50 dark:bg-rose-400/15 dark:text-rose-50",
dim: "border-white/40 bg-white/35 text-frost-400 dark:border-white/10 dark:bg-white/[0.04] dark:text-frost-500",
};
return (
<button
type="button"
onClick={onClick}
disabled={disabled}
className={cn(
"flex w-full items-center gap-3 rounded-2xl border px-4 py-3.5 text-left text-[15px] font-medium backdrop-blur-xl transition-all duration-200 disabled:cursor-default",
states[state],
!disabled && "active:scale-[0.99]",
className,
)}
>
{shortcut ? (
<span className="grid size-6 shrink-0 place-items-center rounded-lg bg-[var(--surface-sunken)] text-xs font-bold text-frost-600 dark:text-frost-300">
{shortcut}
</span>
) : null}
<span className="flex-1">{children}</span>
</button>
);
}
export function FeedbackPanel({
correct,
explanation,
xp,
onNext,
isLast,
nextLabel,
headline,
detail,
children,
}: {
correct: boolean;
explanation: string;
xp?: number;
onNext: () => void;
isLast?: boolean;
/** Overrides the default “Next” / “See results” label. */
nextLabel?: string;
headline?: string;
detail?: React.ReactNode;
children?: React.ReactNode;
}) {
const { t } = useI18n();
return (
<motion.div
initial={{ opacity: 0, y: 18 }}
animate={{ opacity: 1, y: 0 }}
transition={{ type: "spring", stiffness: 380, damping: 32 }}
className={cn(
"rounded-3xl border p-4 shadow-lift backdrop-blur-xl",
correct
? "border-emerald-200/80 bg-gradient-to-b from-emerald-50/95 to-emerald-100/70 dark:border-emerald-400/30 dark:from-emerald-500/15 dark:to-emerald-500/5"
: "border-rose-200/80 bg-gradient-to-b from-rose-50/95 to-rose-100/70 dark:border-rose-400/30 dark:from-rose-500/15 dark:to-rose-500/5",
)}
role="status"
aria-live="polite"
>
<div className="flex items-center justify-between gap-3">
<p
className={cn(
"flex items-center gap-2 text-base font-extrabold",
correct ? "text-emerald-900 dark:text-emerald-200" : "text-rose-900 dark:text-rose-200",
)}
>
<span aria-hidden>{correct ? "✅" : "💧"}</span>
{headline ?? (correct ? t("activity.niceOne") : t("activity.notQuite"))}
</p>
{correct && xp ? (
<motion.span
initial={{ scale: 0.6, opacity: 0 }}
animate={{ scale: 1, opacity: 1 }}
className="rounded-full bg-emerald-500 px-3 py-1 text-sm font-extrabold text-white shadow"
>
+{xp} XP
</motion.span>
) : null}
</div>
{detail ? <div className="mt-2 text-sm text-frost-700 dark:text-frost-200">{detail}</div> : null}
<p className="mt-2 text-sm leading-relaxed text-frost-700 dark:text-frost-200">
<span className="font-bold">{t("activity.why")} </span>
{explanation}
</p>
{children}
<div className="mt-4 flex items-center justify-end">
<Button onClick={onNext} size="md" className="min-w-28">
{nextLabel ?? (isLast ? t("activity.seeResults") : t("activity.next"))}
<span aria-hidden>→</span>
</Button>
</div>
</motion.div>
);
}
/** Small hint row under a question, e.g. "Tap a term, then its definition". */
export function Hint({ children }: { children: React.ReactNode }) {
return <p className="text-sm text-frost-600 dark:text-frost-300">{children}</p>;
}