"use client"; import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { ArrowDownIcon, ChevronRightIcon, PlayIcon } from "lucide-react"; import { Button } from "@/components/ui/button"; import { joinDictation, useDictationTarget } from "@/components/dictation"; import { MessageResponse } from "@/components/ai-elements/message"; import { cn } from "@/lib/utils"; import { buildAnswer, coerceCorrectAnswer, emptyDockSelection, normalizeOptions, resolveCorrect, seededRandom, shuffleOptions, parseAskInput, parseQuizInput, toggleOption, toggleOther, type AnswerRequest, type AskToolInput, type DockSelection, type QuestionAnswerData, type QuestionData, type QuestionMode, type QuizToolInput, type SelectMode, type Phase3, } from "@/src/core"; /** * The question dock — a pending quiz/ask REPLACES the chat composer: the * persistent bottom blob morphs into the question. Two voices meet here: * the teacher's (question, options, explanation) and the learner's — * "Your thinking", a labeled composer-twin field for dumping reasoning, * with Submit docked inside it exactly like the chat composer's send. * * The thinking field is the transfer channel of the whole product (wave-2): * never called "optional", Enter makes a NEWLINE (it is for dumping — soon * dictated, not typed), submission is the button only, and its size scales * with the phase (probing stays quick; teaching invites depth). The * "Other…" option is an editable option ROW — circle + inline input, * styled like its siblings — so picking Other never displaces thinking. * * Collapse behavior (scroll-up → slim bar) is owned by the DockOverlay in the * chat view, which also owns the persistent shell and its height morph. This * component is content only. The expanded form stays MOUNTED while collapsed * (hidden, not unmounted) so a half-made selection survives scrolling. */ export interface QuestionDockProps { toolName: "quiz" | "ask_user_question"; toolCallId: string; input: QuizToolInput | AskToolInput; /** Collapse state, owned by the DockOverlay (it drives the shell's height morph). */ expanded: boolean; /** * Teach-phase check awaiting its reveal (vision §2, W5): while collapsed, * the bar is the "Check your understanding" invitation instead of the * scroll-collapse strip. Owned by the DockOverlay; false once the learner * has revealed (afterwards the normal collapse machine rules apply). */ reveal?: boolean; onExpand: () => void; onSubmit: (output: QuestionAnswerData) => void; /** Escape in a question field stops dictation (STT wave) — threaded * from the page that owns the dictation hook. */ onEscape?: () => void; /** The keyboard machine (wave B) is armed only while the dock is * expanded — the collapsed bar keeps its native Enter-to-expand. */ active?: boolean; /** Session phase at the question — scales the thinking field: probing * stays quick (one row), teaching invites dumping (three rows). */ phase?: Phase3; } export function QuestionDock({ toolName, toolCallId, input, expanded, reveal = false, onExpand, onSubmit, onEscape, phase = "probe", }: QuestionDockProps) { // Parse, don't cast (src/core/tool-parts.ts): the model authored this // input, and only the schema the tool declared vouches for its shape. // The dock mounts on input-available parts (already validated at the // bridge), so this is pure defense in depth — but it is STRUCTURAL now: // anything that slips through renders the quiet fallback, never a // crash on `.map` over model-authored bytes. const parsed = toolName === "quiz" ? parseQuizInput(input) : parseAskInput(input); if (!parsed) { return (
This question arrived malformed — the transcript keeps the retry.
); } return ( <> {!expanded && ( )}
); } /** A plain-text teaser of a question for the collapsed bar: unwrap math, flatten common LaTeX. */ function teaserText(q: string): string { return q .replace(/\\\(([\s\S]*?)\\\)/g, "$1") // \(...\) inline math .replace(/\\\[([\s\S]*?)\\\]/g, "$1") // \[...\] display math .replace(/\$\$?([^$]*)\$\$?/g, "$1") // legacy $...$ (pre-switch sessions) .replace(/\\frac\{([^{}]*)\}\{([^{}]*)\}/g, "$1/$2") .replace(/\\([a-zA-Z]+)/g, "$1") .replace(/[{}]/g, "") .replace(/\s+/g, " ") .trim(); } /** The collapsed strip. Two species (W5): "collapsed" is the scroll minimization * (kind chip + one-liner + Answer ↓); "reveal" is the teach-check invitation — * a distinct, more inviting affordance, because it asks the learner to start * something, not to resume something. */ export function QuestionDockBar({ toolName, question, onExpand, variant = "collapsed", }: { toolName: "quiz" | "ask_user_question"; question: string; onExpand: () => void; variant?: "collapsed" | "reveal"; }) { if (variant === "reveal") { return ( ); } return ( ); } /** The expanded question: label, question, options, and the unified bottom row. */ function QuestionDockForm({ toolName, toolCallId, input, phase = "probe", active, onSubmit, onEscape, }: Omit) { const kind = toolName === "quiz" ? ("quiz" as const) : ("ask" as const); // Canonical QuestionData, built once per question. Quiz options are // deterministically shuffled (seeded by toolCallId) so position never leaks // correctness AND server/client render the same order (hydration-safe); // the display order is snapshotted into the answer record at submit time. const qd = useMemo(() => { const quizInput = kind === "quiz" ? (input as QuizToolInput) : null; const askInput = kind === "ask" ? (input as AskToolInput) : null; const multi = input.multiSelect === true; const mode: QuestionMode = kind === "quiz" ? multi ? "multi-select" : "single-select" : askInput?.options?.length ? multi ? "multi-select" : "single-select" : "text"; const options = normalizeOptions( (quizInput?.options ?? askInput?.options ?? []) as { label: string; value?: string }[], ); const ordered = kind === "quiz" && options.length > 0 ? shuffleOptions(options, seededRandom(toolCallId)) : options; const q: QuestionData = { id: toolCallId, kind, question: input.question, context: input.details, mode, options: ordered, createdAt: new Date().toISOString(), }; if (quizInput) { const resolved = resolveCorrect(coerceCorrectAnswer(quizInput.correctAnswer), ordered); if (resolved.error) console.error("[quiz] correctAnswer did not resolve:", resolved.error); q.correctIndices = resolved.indices; q.explanation = quizInput.explanation; } return q; }, [toolCallId, kind, input]); // The selection state machine lives in question-core (pure, tested): // single-select displaces, multi-select coexists — picking the ask // "Other…" row in a multi-select must never clear already-picked // options, and picking an option must never clear a typed custom answer. const [sel, setSel] = useState(emptyDockSelection()); // The learner's transfer channel — thinking, never "a note". const [thinking, setThinking] = useState(""); const [other, setOther] = useState(""); const [text, setText] = useState(""); const selectMode: SelectMode = qd.mode === "multi-select" ? "multi-select" : "single-select"; // The PRIMARY dictation input (owner, STT round 1): while a question // waits, dictated finals land HERE, never in the hidden composer — text // mode owns "Your answer", select modes own "Your thinking". The claim // is effect-scoped, so the question unmounting releases it and // dictation falls back to the composer automatically. useDictationTarget( useCallback( (t: string) => { if (qd.mode === "text") setText((v) => joinDictation(v, t)); else setThinking((v) => joinDictation(v, t)); }, [qd.mode], ), true, ); const toggle = (idx: number) => setSel(toggleOption(selectMode, sel, idx)); const canSubmit = qd.mode === "text" ? text.trim().length > 0 : sel.dontKnow || (sel.otherSelected && other.trim().length > 0) || sel.selected.size > 0; const submit = () => { if (!canSubmit) return; const req: AnswerRequest = { dontKnow: sel.dontKnow, values: [...sel.selected].map((i) => qd.options[i]!.value), other: sel.otherSelected ? other : undefined, text: qd.mode === "text" ? text : undefined, note: qd.mode !== "text" ? thinking.trim() || undefined : undefined, }; onSubmit(buildAnswer(qd, req)); }; // Selecting Other never clears the thinking field — two channels, the // answer and the reasoning behind it, side by side. const selectOther = () => setSel(toggleOther(selectMode, sel)); /* ── The keyboard machine (shortcut wave B, 2026-09-17) ── ↑/↓ walk EVERY answerable row in order — options first, then the quiz's "I don't know" or the ask's "Other…" (whichever exists). Space acts on the walked row exactly like a click (multi toggles, single displaces; Other also focuses its input for typing), Enter submits once an answer exists. Two guards keep native behavior intact: keys from a TYPING SURFACE keep their meaning (arrows move the caret, space types), and keys from INSIDE the dock keep the DOM's semantics (Enter on a focused row/button clicks it). The listener is document-level and lives only while the dock is expanded — collapsed, the bar's native Enter expands it. */ const [kbdIdx, setKbdIdx] = useState(null); const rootRef = useRef(null); const otherInputRef = useRef(null); // One row past the options is the trailing row: quiz → don't-know, // ask → Other (a question never has both). const optionCount = qd.mode === "text" ? 0 : qd.options.length; const rowCount = qd.mode === "text" ? 0 : optionCount + 1; const kbdAct = (idx: number) => { if (idx < optionCount) toggle(idx); else if (kind === "quiz") setSel((prev) => ({ ...prev, selected: new Set(), otherSelected: false, dontKnow: !prev.dontKnow })); else { selectOther(); otherInputRef.current?.focus(); } }; useEffect(() => { if (!active || rowCount === 0) return; const onKeyDown = (e: KeyboardEvent) => { const t = e.target as HTMLElement | null; if (t && (t.tagName === "INPUT" || t.tagName === "TEXTAREA" || t.isContentEditable)) return; // Keys from inside the dock keep DOM semantics (Enter clicks a // focused row; Space presses a focused button). if (t && rootRef.current?.contains(t)) return; if (e.key === "ArrowDown") { e.preventDefault(); setKbdIdx((i) => (i === null ? 0 : (i + 1) % rowCount)); } else if (e.key === "ArrowUp") { e.preventDefault(); setKbdIdx((i) => (i === null ? rowCount - 1 : (i - 1 + rowCount) % rowCount)); } else if (e.key === " ") { if (kbdIdx === null) return; // plain Space keeps scrolling the page e.preventDefault(); kbdAct(kbdIdx); } else if (e.key === "Enter") { if (kbdIdx === null || !canSubmit) return; e.preventDefault(); submit(); } }; document.addEventListener("keydown", onKeyDown); return () => document.removeEventListener("keydown", onKeyDown); }); // Keep the walked row visible (the question area scrolls internally). useEffect(() => { if (kbdIdx === null) return; rootRef.current ?.querySelector(`[data-kbdrow="${kbdIdx}"]`) ?.scrollIntoView({ block: "nearest" }); }, [kbdIdx]); return (
{/* Question area — scrolls internally if very tall; the bottom row stays put. */}
{kind === "quiz" ? "Quiz" : "Question"} {qd.mode === "multi-select" && " · select all that apply"}
{qd.question}
{qd.context && (
{qd.context}
)} {qd.mode !== "text" && (
{qd.options.map((opt, i) => { const isSel = sel.selected.has(i); return ( ); })} {kind === "quiz" && ( )} {kind === "ask" && (
{sel.otherSelected && ( {qd.mode === "multi-select" ? "✓" : ""} )} { setOther(e.target.value); // Typing selects the row — displacing in // single-select, alongside the siblings in multi. setSel((prev) => (prev.otherSelected ? prev : toggleOther(selectMode, prev))); }} placeholder="Type your own answer…" className="lh-input w-full min-w-0 flex-1 bg-transparent outline-none placeholder:text-muted-foreground" onClick={(e) => e.stopPropagation()} />
)}
)}
{/* The learner's half of the dock — a composer TWIN: a labeled, bordered field with Submit docked inside, exactly like the chat composer's send. Select modes get "Your thinking" (Enter makes a newline — it is for dumping, soon dictated; the button submits); text mode keeps "Your answer" with Enter-to-submit. */}
{ e.preventDefault(); submit(); }} >
{qd.mode === "text" ? "Your answer" : "Your thinking"}
{qd.mode === "text" ? (