freezmo/lib/share.ts
Martin Dvorak 4513364019 Phase 3: Check my work, follow-ups and turn-into-deck
Check my work (third homework mode)
- One model call with its own system prompt marks the student's own
  attempt: verdict, what's right, each issue with why + fix, and the
  corrected version that keeps everything the student got right.
  Unasked-for extras are never errors. The attempt is typed/pasted
  (photos of handwriting are documented as unsupported) and stored in
  the record so Redo re-checks the same work.
- Server: mode "check" + solution on POST /api/homework (zod, 400
  server.needSolution without one) and the same NDJSON stream; new
  checkHomework() pipeline with repair-once validation.

Follow-ups
- New POST /api/homework/refine (plain JSON, RATE_LIMIT_REFINE, zod,
  auth before body): shorter / more detail / explain, plain text back,
  language preserved.
- Shorter + More detail + Original rewrite the finished answer and the
  corrected version in place (FollowUpBar); every guide step has
  Explain step N differently; failed calls say so without losing text.

Turn into a study deck
- Any result hands its content (answer, corrected version or assembled
  guide) to New deck through a one-shot sessionStorage seed with the
  options step pre-filled.

UI
- Phone step 2 gains the third card: tapping it reveals the solution
  field + submit; desktop has three cards and the solution field shows
  with the mode. Homework history labels and share/card previews cover
  the new mode.

Verified: new phase-3 suite 20/20 against a stub Ollama (check payload,
missing-solution 400, refine validation, phone + desktop check flows,
shorter follow-up with restore, guide explain, deck hand-off) plus
regression 74/74, mobile 52/52, declutter 116/116, wizard 80/80,
animation 8/8, native 35/35, phase1 38/38, phase2 43/43, i18n 25/25.
Key parity 734/734. Lint + build clean. SW freezmo-v27.
2026-10-10 14:36:04 +00:00

74 lines
2.3 KiB
TypeScript

"use client";
import { exportDeck } from "./storage";
import { showToast } from "./toast";
import type { Deck, HomeworkRecord } from "./schemas";
import { t } from "./i18n";
/**
* Web Share with graceful fallbacks: file share (deck JSON) where the browser
* supports it, text share otherwise, clipboard copy as the last resort.
*/
type ShareNavigator = Navigator & {
canShare?: (data: { files?: File[]; text?: string; title?: string }) => boolean;
share?: (data: { files?: File[]; text?: string; title?: string }) => Promise<void>;
};
function deckFile(deck: Deck): File {
return new File([exportDeck(deck)], `${deck.title.replace(/[^\p{L}\p{N} _-]/gu, "").trim() || "deck"}.json`, {
type: "application/json",
});
}
async function copyText(text: string): Promise<boolean> {
try {
if (navigator.clipboard?.writeText) {
await navigator.clipboard.writeText(text);
return true;
}
} catch {
/* fall through */
}
return false;
}
export async function shareDeck(deck: Deck): Promise<void> {
const nav = navigator as ShareNavigator;
const file = deckFile(deck);
try {
if (nav.share && nav.canShare?.({ files: [file] })) {
await nav.share({ files: [file], title: deck.title });
return;
}
if (nav.share) {
await nav.share({ title: deck.title, text: deck.title });
return;
}
} catch (error) {
// The user cancelling the share sheet is not an error.
if (error instanceof DOMException && error.name === "AbortError") return;
}
if (await copyText(exportDeck(deck))) showToast({ message: t("share.copied") });
else showToast({ message: t("share.failed") });
}
export async function shareHomework(record: HomeworkRecord): Promise<void> {
const nav = navigator as ShareNavigator;
const text =
record.mode === "make"
? record.answer
: record.mode === "check"
? record.corrected
: record.steps.map((step, index) => `${index + 1}. ${step.title}`).join("\n");
try {
if (nav.share) {
await nav.share({ title: record.title, text });
return;
}
} catch (error) {
if (error instanceof DOMException && error.name === "AbortError") return;
}
if (await copyText(text)) showToast({ message: t("share.copied") });
else showToast({ message: t("share.failed") });
}