question-bank-framework 0.1.0 → 0.2.0

package/core/config.tsx

@@ -31,22 +31,8 @@ export type {
   BankSiteConfig,
   BaseQuestion,
   DefineBankInput,
-  QuestionKind,
-  QuestionOption,
   QuestionStatus,
   QuestionStatusMap,
-  QuizAnswer,
   QuizSession,
 } from './types.ts';
-export {
-  getCorrectIds,
-  isAnswerCorrect,
-  isAnswerProvided,
-  isChoiceQuestion,
-  questionKind,
-  questionKindLabels,
-  questionKinds,
-  scoreAnswers,
-  toSelectedIds,
-} from './types.ts';
 export { questionStatuses } from './types.ts';

package/core/index.ts

@@ -1,22 +1,7 @@
 // Re-export the stable core: types + BankContext/useBank/defineBank.
 // Framework code (ejectable) lives under framework/.
 
-export {
-  BankContext,
-  BankProvider,
-  useBank,
-  defineBank,
-  getCorrectIds,
-  isAnswerCorrect,
-  isAnswerProvided,
-  isChoiceQuestion,
-  questionKind,
-  questionKindLabels,
-  questionKinds,
-  questionStatuses,
-  scoreAnswers,
-  toSelectedIds,
-} from './config.tsx';
+export { BankContext, BankProvider, useBank, defineBank, questionStatuses } from './config.tsx';
 export type {
   Bank,
   BankFieldDef,
@@ -26,10 +11,7 @@ export type {
   BankSiteConfig,
   BaseQuestion,
   DefineBankInput,
-  QuestionKind,
-  QuestionOption,
   QuestionStatus,
   QuestionStatusMap,
-  QuizAnswer,
   QuizSession,
 } from './config.tsx';

package/core/types.ts

@@ -1,56 +1,26 @@
 // Core question + bank types. Framework-owned, never ejected.
-// A bank's question shape is config-defined: every question has the four
-// core fields, plus arbitrary subject-specific metadata (year, marks, …).
+// Every question has the core fields below; subjects extend the interface
+// with their own metadata (year, marks, …) and the bank stays generic over
+// it — no index signatures, no `unknown`, no casts in subject code.
 
 export const questionStatuses = ['unanswered', 'revisit', 'complete'] as const;
 
 export type QuestionStatus = (typeof questionStatuses)[number];
 export type QuestionStatusMap = Record<string, QuestionStatus>;
 
-// ---------------------------------------------------------------------------
-// Question kinds: written (free response) vs choice (auto-gradeable).
-// ---------------------------------------------------------------------------
-
-export type QuestionKind = 'written' | 'single' | 'multiple';
-
-export const questionKinds: readonly QuestionKind[] = ['written', 'single', 'multiple'];
-
-export const questionKindLabels: Record<QuestionKind, string> = {
-  written: 'Written',
-  single: 'Single choice',
-  multiple: 'Multiple choice',
-};
-
-export interface QuestionOption {
-  /** Stable within the question, e.g. "a", "b", "c". */
-  id: string;
-  /** Option body. Markdown supported. */
-  text: string;
-}
-
-/** Written answers are free text; choice answers are selected option ids. */
-export type QuizAnswer = string | string[];
-
 export interface BaseQuestion {
   id: string;
   title: string;
   prompt: string;
   tags: string[];
-  /** Defaults to 'written' when omitted. Choice kinds require options + correctIds. */
-  kind?: QuestionKind;
-  /** Choice options. Required for single/multiple, forbidden for written. */
-  options?: QuestionOption[];
-  /** Correct option ids. Single choice requires exactly one. */
-  correctIds?: string[];
-  // Subject-specific fields (e.g. year, semester, marks, source).
-  [key: string]: unknown;
+  // Subjects extend this interface with their own fields; see template/bank.config.ts.
 }
 
 export interface QuizSession {
   id: string;
   title: string;
   questionIds: string[];
-  answers: Record<string, QuizAnswer>;
+  answers: Record<string, string>;
   currentQuestion: number;
   completed: boolean;
   createdAt: number;
@@ -84,13 +54,19 @@ export interface BankFieldOption {
   label: string;
 }
 
-export interface BankFieldDef {
+export interface BankFieldDef<Q extends BaseQuestion = BaseQuestion> {
   /** Stable field id. Reserved: id, title, tags, status. */
   id: string;
   label: string;
   type: BankFieldType;
-  /** Extract the raw value from a question. */
-  getValue: (question: BaseQuestion) => string | number | null | readonly string[];
+  /**
+   * Extract the raw value from a question. Q is inferred from the bank's
+   * questions. Method syntax (not a function property) keeps subject field
+   * defs assignable to the stored bank with zero casts — standard
+   * bivariant-method assignability, like Map/Set methods. Sound here
+   * because fields are only ever called with their own bank's questions.
+   */
+  getValue(question: Q): string | number | null | readonly string[];
   /**
    * Fixed options for select/multiselect. When omitted, options are derived
    * from distinct values across the bank's questions (sorted).
@@ -112,13 +88,13 @@ export interface BankSiteConfig {
   description?: string;
 }
 
-export interface DefineBankInput {
+export interface DefineBankInput<Q extends BaseQuestion = BaseQuestion> {
   site: BankSiteConfig;
   /** Namespaces localStorage keys + Convex lookups. e.g. "comp20008". */
   namespace: string;
   /** Subject-specific schema. Built-ins (id/title/tags/status) are automatic. */
-  fields: BankFieldDef[];
-  questions: BaseQuestion[];
+  fields: BankFieldDef<Q>[];
+  questions: Q[];
   /** Suggested answers keyed by question id. Missing entries hide "Show answer". */
   answers?: Record<string, string>;
   /** Default sort for the grid, e.g. [{ id: "exam", desc: true }]. */
@@ -127,130 +103,20 @@ export interface DefineBankInput {
   publicPath?: string;
 }
 
-export interface Bank extends DefineBankInput {
+export interface Bank extends DefineBankInput<BaseQuestion> {
   answers: Record<string, string>;
   questionById: Map<string, BaseQuestion>;
 }
 
-export function defineBank(input: DefineBankInput): Bank {
-  for (const question of input.questions) {
-    validateQuestion(question);
-  }
+/**
+ * Build a bank. Q is inferred from `questions`, so each field's getValue is
+ * checked against the subject's question type — accessors use plain property
+ * access, no casts or coercion helpers.
+ */
+export function defineBank<Q extends BaseQuestion>(input: DefineBankInput<Q>): Bank {
   return {
     ...input,
     answers: input.answers ?? {},
     questionById: new Map(input.questions.map((q) => [q.id, q])),
   };
 }
-
-function validateQuestion(question: BaseQuestion): void {
-  const kind: QuestionKind = question.kind ?? 'written';
-  if (!questionKinds.includes(kind)) {
-    throw new Error(`Question "${question.id}" has unknown kind "${question.kind}".`);
-  }
-  if (kind === 'written') {
-    if (question.options !== undefined) {
-      throw new Error(`Question "${question.id}" is written and must not define options.`);
-    }
-    if (question.correctIds !== undefined) {
-      throw new Error(`Question "${question.id}" is written and must not define correctIds.`);
-    }
-    return;
-  }
-  const options = question.options ?? [];
-  if (options.length < 2) {
-    throw new Error(`Question "${question.id}" (${kind}) needs at least 2 options.`);
-  }
-  const seen = new Set<string>();
-  for (const option of options) {
-    if (!option.id || seen.has(option.id)) {
-      throw new Error(`Question "${question.id}" has a duplicate or empty option id "${option.id}".`);
-    }
-    seen.add(option.id);
-  }
-  const correctIds = question.correctIds ?? [];
-  if (kind === 'single' && correctIds.length !== 1) {
-    throw new Error(`Question "${question.id}" (single) needs exactly one correctId.`);
-  }
-  if (kind === 'multiple' && correctIds.length < 1) {
-    throw new Error(`Question "${question.id}" (multiple) needs at least one correctId.`);
-  }
-  for (const id of correctIds) {
-    if (!seen.has(id)) {
-      throw new Error(`Question "${question.id}" has unknown correctId "${id}".`);
-    }
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Choice helpers. All UI + scoring goes through these so option storage
-// (ids) stays decoupled from presentation (letters, markdown).
-// ---------------------------------------------------------------------------
-
-/** Effective kind: questions without `kind` are written. */
-export function questionKind(question: BaseQuestion): QuestionKind {
-  return question.kind ?? 'written';
-}
-
-export function isChoiceQuestion(question: BaseQuestion): boolean {
-  const kind = questionKind(question);
-  return kind === 'single' || kind === 'multiple';
-}
-
-/** Correct option ids. Empty for written questions. */
-export function getCorrectIds(question: BaseQuestion): string[] {
-  return isChoiceQuestion(question) ? [...(question.correctIds ?? [])] : [];
-}
-
-/** Normalize a stored answer to selected option ids — tolerates legacy strings. */
-export function toSelectedIds(question: BaseQuestion, answer: QuizAnswer | undefined): string[] {
-  if (answer === undefined) return [];
-  const ids =
-    typeof answer === 'string' ? (answer === '' ? [] : [answer]) : answer.filter((id) => typeof id === 'string');
-  if (!isChoiceQuestion(question)) return ids;
-  const valid = new Set((question.options ?? []).map((o) => o.id));
-  return ids.filter((id) => valid.has(id));
-}
-
-/** Whether the user has provided an answer (non-blank text, or ≥1 selection). */
-export function isAnswerProvided(question: BaseQuestion, answer: QuizAnswer | undefined): boolean {
-  if (answer === undefined) return false;
-  if (typeof answer === 'string') return answer.trim().length > 0;
-  if (!isChoiceQuestion(question)) return answer.some((id) => id.trim().length > 0);
-  const valid = new Set((question.options ?? []).map((o) => o.id));
-  return answer.some((id) => valid.has(id));
-}
-
-/**
- * Grade a choice answer. Returns null for written questions or when
- * unanswered. Single: exactly the correct id. Multiple: exact set match
- * (order-insensitive, no extras, no omissions).
- */
-export function isAnswerCorrect(question: BaseQuestion, answer: QuizAnswer | undefined): boolean | null {
-  if (!isChoiceQuestion(question)) return null;
-  if (!isAnswerProvided(question, answer)) return null;
-  const selected = new Set(toSelectedIds(question, answer));
-  const correct = new Set(getCorrectIds(question));
-  if (selected.size !== correct.size) return false;
-  for (const id of selected) {
-    if (!correct.has(id)) return false;
-  }
-  return true;
-}
-
-/** Score a set of questions against answers: { correct, gradeable, answered }. */
-export function scoreAnswers(
-  questions: readonly BaseQuestion[],
-  answers: Record<string, QuizAnswer>,
-): { correct: number; gradeable: number; answered: number } {
-  let correct = 0;
-  let gradeable = 0;
-  let answered = 0;
-  for (const question of questions) {
-    if (isAnswerProvided(question, answers[question.id])) answered += 1;
-    if (!isChoiceQuestion(question)) continue;
-    gradeable += 1;
-    if (isAnswerCorrect(question, answers[question.id]) === true) correct += 1;
-  }
-  return { correct, gradeable, answered };
-}

package/framework/components/question-bank.tsx

@@ -17,8 +17,7 @@ import {
 } from '@tanstack/react-table';
 import { Search } from 'lucide-react';
 import { useBank } from '../../core/config.tsx';
-import type { BaseQuestion, QuestionKind, QuestionStatus, QuestionStatusMap } from '../../core/types.ts';
-import { isChoiceQuestion, questionKind, questionKindLabels } from '../../core/types.ts';
+import type { BaseQuestion, QuestionStatus, QuestionStatusMap } from '../../core/types.ts';
 import { Badge } from './ui/badge';
 import { Button } from './ui/button';
 import { Checkbox } from './ui/checkbox';
@@ -60,14 +59,6 @@ const questionStatusStyles: Record<QuestionStatus, string> = {
   complete: 'border-green-300 bg-green-50 text-green-800',
 };
 
-const questionKindStyles: Record<QuestionKind, string> = {
-  written: 'border-gray-300 bg-gray-50 text-gray-700',
-  single: 'border-sky-300 bg-sky-50 text-sky-900',
-  multiple: 'border-violet-300 bg-violet-50 text-violet-900',
-};
-
-const optionLetter = (index: number): string => String.fromCharCode(65 + index);
-
 function QuestionPreviewPopover({ question }: { question: BaseQuestion }) {
   const [open, setOpen] = useState(false);
   const openTimeout = useRef<number | null>(null);
@@ -172,18 +163,6 @@ function QuestionPreviewPopover({ question }: { question: BaseQuestion }) {
       >
         <div className="px-4 py-3">
           <MarkdownContent content={question.prompt} />
-          {isChoiceQuestion(question) && (
-            <ol className="mt-3 space-y-1.5">
-              {(question.options ?? []).map((option, index) => (
-                <li key={option.id} className="flex items-start gap-2 text-sm text-gray-800">
-                  <span className="mt-0.5 flex size-5 shrink-0 items-center justify-center rounded-full border border-gray-300 bg-gray-50 text-[11px] font-bold text-gray-600">
-                    {optionLetter(index)}
-                  </span>
-                  <MarkdownContent content={option.text} className="min-w-0 flex-1 text-sm leading-6" />
-                </li>
-              ))}
-            </ol>
-          )}
         </div>
       </PopoverContent>
     </Popover>
@@ -358,21 +337,6 @@ export function QuestionBank() {
           </div>
         ),
       },
-      {
-        id: 'kind',
-        accessorFn: (row) => questionKind(row),
-        header: 'Type',
-        cell: ({ row }) => {
-          const kind = questionKind(row.original);
-          const count = row.original.options?.length ?? 0;
-          return (
-            <Badge variant="outline" className={questionKindStyles[kind]} title={count > 0 ? `${count} options` : undefined}>
-              {questionKindLabels[kind]}
-            </Badge>
-          );
-        },
-        size: 132,
-      },
       ...customs,
       {
         id: 'status',

package/framework/components/quiz-list.tsx

@@ -5,7 +5,6 @@ import { Link } from '@tanstack/react-router';
 import { Trash2 } from 'lucide-react';
 import { useBank } from '../../core/config.tsx';
 import type { QuizSession } from '../../core/types.ts';
-import { isAnswerProvided, scoreAnswers } from '../../core/types.ts';
 import { Button } from './ui/button';
 import { deleteQuiz, listQuizzes } from '../lib/quiz-storage.ts';
 
@@ -64,13 +63,7 @@ export function QuizList() {
           )}
           <div className="grid grid-cols-1 gap-4 sm:grid-cols-2">
             {quizzes.map((quiz) => {
-              const questions = quiz.questionIds
-                .map((id) => bank.questionById.get(id))
-                .filter((question) => question !== undefined);
-              const answeredCount = questions.filter((question) =>
-                isAnswerProvided(question, quiz.answers[question.id]),
-              ).length;
-              const score = scoreAnswers(questions, quiz.answers);
+              const answeredCount = Object.values(quiz.answers).filter((answer) => answer.trim().length > 0).length;
               return (
                 <div key={quiz.id} className="group relative">
                   <Link
@@ -84,7 +77,6 @@ export function QuizList() {
                     </p>
                     <p className="mt-1 text-sm text-gray-600">
                       {answeredCount} of {quiz.questionIds.length} answered
-                      {score.gradeable > 0 && ` • ${score.correct}/${score.gradeable} correct`}
                     </p>
                   </Link>
                   <Button

package/framework/components/quiz-page.tsx

@@ -4,26 +4,13 @@ import { useEffect, useMemo, useRef, useState } from 'react';
 import { Link, useParams } from '@tanstack/react-router';
 import { Check, Pencil, X } from 'lucide-react';
 import { useBank } from '../../core/config.tsx';
-import type { QuestionStatus, QuizAnswer, QuizSession } from '../../core/types.ts';
-import {
-  getCorrectIds,
-  isAnswerCorrect,
-  isAnswerProvided,
-  isChoiceQuestion,
-  questionKind,
-  questionKindLabels,
-  scoreAnswers,
-  toSelectedIds,
-} from '../../core/types.ts';
+import type { QuestionStatus, QuizSession } from '../../core/types.ts';
 import { Badge } from './ui/badge';
 import { Button } from './ui/button';
 import { Input } from './ui/input';
 import { MarkdownContent } from './markdown-content';
 import { setQuestionStatus } from '../lib/question-status-storage.ts';
 import { getQuiz, saveQuizLocally, saveQuizProgress } from '../lib/quiz-storage.ts';
-import { cn } from '../lib/utils.ts';
-
-const optionLetter = (index: number): string => String.fromCharCode(65 + index);
 
 export function QuizPage() {
   const bank = useBank();
@@ -32,7 +19,6 @@ export function QuizPage() {
   const [loading, setLoading] = useState(true);
   const [saving, setSaving] = useState(false);
   const [shownAnswerId, setShownAnswerId] = useState<string | null>(null);
-  const [checked, setChecked] = useState<Record<string, boolean>>({});
   const [editingTitle, setEditingTitle] = useState(false);
   const [titleDraft, setTitleDraft] = useState('');
   const titleInputRef = useRef<HTMLInputElement>(null);
@@ -47,7 +33,6 @@ export function QuizPage() {
   useEffect(() => {
     let active = true;
     setShownAnswerId(null);
-    setChecked({});
     getQuiz(bank.namespace, quizId).then((quiz) => {
       if (active) setSession(quiz);
     }).finally(() => {
@@ -87,39 +72,13 @@ export function QuizPage() {
     setSession((current) => (current ? { ...current, currentQuestion: index, completed: false } : current));
   };
 
-  const updateWrittenAnswer = (value: string) => {
+  const updateAnswer = (value: string) => {
     if (!activeQuestion) return;
     setSession((current) =>
       current ? { ...current, completed: false, answers: { ...current.answers, [activeQuestion.id]: value } } : current,
     );
   };
 
-  const setChoiceAnswer = (questionId: string, value: string[]) => {
-    setChecked((current) => (current[questionId] ? { ...current, [questionId]: false } : current));
-    setSession((current) =>
-      current ? { ...current, completed: false, answers: { ...current.answers, [questionId]: value } } : current,
-    );
-  };
-
-  const toggleOption = (questionId: string, optionId: string, single: boolean) => {
-    if (!activeQuestion) return;
-    const current = toSelectedIds(activeQuestion, session?.answers[questionId]);
-    if (single) {
-      setChoiceAnswer(questionId, current[0] === optionId ? [] : [optionId]);
-    } else {
-      setChoiceAnswer(
-        questionId,
-        current.includes(optionId) ? current.filter((id) => id !== optionId) : [...current, optionId],
-      );
-    }
-  };
-
-  const checkAnswer = () => {
-    if (!activeQuestion) return;
-    setChecked((current) => ({ ...current, [activeQuestion.id]: true }));
-    if (bank.answers[activeQuestion.id]) setShownAnswerId(activeQuestion.id);
-  };
-
   const updateQuestionStatus = (status: QuestionStatus) => {
     if (!activeQuestion) return;
     void setQuestionStatus(bank.namespace, activeQuestion.id, status);
@@ -162,17 +121,9 @@ export function QuizPage() {
     );
   }
 
-  const answer: QuizAnswer | undefined = session.answers[activeQuestion.id];
+  const answer = session.answers[activeQuestion.id] ?? '';
   const suggestedAnswer = bank.answers[activeQuestion.id];
   const isSuggestedAnswerShown = shownAnswerId === activeQuestion.id;
-  const choice = isChoiceQuestion(activeQuestion);
-  const kind = questionKind(activeQuestion);
-  const selectedIds = toSelectedIds(activeQuestion, answer);
-  const hasSelection = isAnswerProvided(activeQuestion, answer);
-  const isChecked = checked[activeQuestion.id] === true;
-  const correctness = isChecked ? isAnswerCorrect(activeQuestion, answer) : null;
-  const correctIds = getCorrectIds(activeQuestion);
-  const score = scoreAnswers(quizQuestions, session.answers);
 
   return (
     <div className="mx-auto grid max-w-3xl gap-6">
@@ -217,66 +168,12 @@ export function QuizPage() {
         <span className="text-sm text-gray-600">{saving ? 'Saving...' : 'Saved'}</span>
       </div>
 
-      <div className="flex flex-wrap items-center gap-3">
-        <p className="m-0 text-base font-semibold text-gray-900">
-          Question {activeIndex + 1} of {quizQuestions.length}
-        </p>
-        {score.gradeable > 0 && (
-          <Badge variant="secondary" aria-label={`Quiz score: ${score.correct} of ${score.gradeable} correct`}>
-            {score.correct}/{score.gradeable} correct
-          </Badge>
-        )}
-        {session.completed && (
-          <Badge variant="outline" className="border-green-300 bg-green-50 text-green-800">
-            Quiz complete
-          </Badge>
-        )}
-      </div>
-
-      {session.completed && score.gradeable > 0 && (
-        <section aria-label="Quiz results" className="rounded-xl border border-gray-200 bg-gray-50 p-5">
-          <h2 className="m-0 text-lg font-semibold text-gray-900">
-            You scored {score.correct} of {score.gradeable}
-          </h2>
-          <ol className="mt-3 grid gap-1.5">
-            {quizQuestions.map((question, index) => {
-              const result = isAnswerCorrect(question, session.answers[question.id]);
-              return (
-                <li key={question.id}>
-                  <button
-                    type="button"
-                    onClick={() => goToQuestion(index)}
-                    className="flex w-full items-center gap-2 rounded-lg px-2 py-1.5 text-left text-sm hover:bg-gray-100"
-                    aria-label={`Review question ${index + 1}: ${question.title} — ${result === null ? 'written' : result ? 'correct' : 'incorrect'}`}
-                  >
-                    <span
-                      aria-hidden="true"
-                      className={cn(
-                        'flex size-5 shrink-0 items-center justify-center rounded-full text-[11px] font-bold',
-                        result === true && 'bg-green-600 text-white',
-                        result === false && 'bg-red-600 text-white',
-                        result === null && 'bg-gray-200 text-gray-700',
-                      )}
-                    >
-                      {result === true ? <Check className="size-3" /> : result === false ? <X className="size-3" /> : index + 1}
-                    </span>
-                    <span className="min-w-0 flex-1 truncate text-gray-900">{question.title}</span>
-                    <span className="shrink-0 text-xs text-gray-500">
-                      {result === null ? 'Written' : result ? 'Correct' : 'Incorrect'}
-                    </span>
-                  </button>
-                </li>
-              );
-            })}
-          </ol>
-        </section>
-      )}
+      <p className="text-base font-semibold text-gray-900">
+        Question {activeIndex + 1} of {quizQuestions.length}
+      </p>
 
       <section className="rounded-xl border border-gray-200 bg-white p-5">
-        <div className="flex flex-wrap items-center gap-2">
-          <h2 className="m-0 flex-1 text-xl font-semibold text-gray-900">{activeQuestion.title}</h2>
-          <Badge variant="outline">{questionKindLabels[kind]}</Badge>
-        </div>
+        <h2 className="m-0 text-xl font-semibold text-gray-900">{activeQuestion.title}</h2>
         <p className="mt-1 font-mono text-xs text-gray-500">{activeQuestion.id}</p>
         {activeQuestion.tags.length > 0 && (
           <div className="mt-2 flex flex-wrap gap-1">
@@ -289,134 +186,32 @@ export function QuizPage() {
         )}
         <MarkdownContent content={activeQuestion.prompt} className="mt-4 text-base leading-relaxed text-gray-800" />
 
-        {choice ? (
-          <div className="mt-6">
-            <p id="quiz-choices-label" className="text-sm font-semibold text-gray-900">
-              {kind === 'single' ? 'Choose one answer' : 'Choose all that apply'}
-            </p>
-            <div role={kind === 'single' ? 'radiogroup' : 'group'} aria-labelledby="quiz-choices-label" className="mt-2 grid gap-2">
-              {(activeQuestion.options ?? []).map((option, index) => {
-                const selected = selectedIds.includes(option.id);
-                const isCorrectOption = correctIds.includes(option.id);
-                const showCorrectness = isChecked;
-                return (
-                  <label
-                    key={option.id}
-                    className={cn(
-                      'flex cursor-pointer items-start gap-3 rounded-lg border p-3 transition-colors',
-                      !showCorrectness && selected && 'border-gray-900 bg-gray-50',
-                      !showCorrectness && !selected && 'border-gray-300 bg-white hover:border-gray-500',
-                      showCorrectness && isCorrectOption && 'border-green-600 bg-green-50',
-                      showCorrectness && !isCorrectOption && selected && 'border-red-600 bg-red-50',
-                      showCorrectness && !isCorrectOption && !selected && 'border-gray-200 bg-white opacity-70',
-                    )}
-                  >
-                    <input
-                      type={kind === 'single' ? 'radio' : 'checkbox'}
-                      name={`quiz-choice-${activeQuestion.id}`}
-                      checked={selected}
-                      onChange={() => toggleOption(activeQuestion.id, option.id, kind === 'single')}
-                      className="mt-1 size-4 shrink-0 accent-gray-900"
-                      aria-label={`Option ${optionLetter(index)}`}
-                    />
-                    <span
-                      aria-hidden="true"
-                      className={cn(
-                        'mt-0.5 flex size-6 shrink-0 items-center justify-center rounded-full border text-xs font-bold',
-                        showCorrectness && isCorrectOption
-                          ? 'border-green-600 bg-green-600 text-white'
-                          : showCorrectness && selected
-                            ? 'border-red-600 bg-red-600 text-white'
-                            : selected
-                              ? 'border-gray-900 bg-gray-900 text-white'
-                              : 'border-gray-300 bg-white text-gray-600',
-                      )}
-                    >
-                      {optionLetter(index)}
-                    </span>
-                    <MarkdownContent content={option.text} className="min-w-0 flex-1 text-base leading-7" />
-                    {showCorrectness && isCorrectOption && (
-                      <Badge variant="outline" className="shrink-0 border-green-600 bg-white text-green-800">
-                        Correct
-                      </Badge>
-                    )}
-                    {showCorrectness && !isCorrectOption && selected && (
-                      <Badge variant="outline" className="shrink-0 border-red-600 bg-white text-red-800">
-                        Yours
-                      </Badge>
-                    )}
-                  </label>
-                );
-              })}
-            </div>
-
-            {isChecked && correctness !== null && (
-              <div
-                role="status"
-                className={cn(
-                  'mt-4 rounded-lg border p-4 text-sm font-medium',
-                  correctness ? 'border-green-300 bg-green-50 text-green-900' : 'border-red-300 bg-red-50 text-red-900',
-                )}
-              >
-                {correctness
-                  ? 'Correct — nice work.'
-                  : `Not quite. Correct answer${correctIds.length > 1 ? 's' : ''}: ${correctIds
-                      .map((id) => {
-                        const index = (activeQuestion.options ?? []).findIndex((o) => o.id === id);
-                        return index >= 0 ? optionLetter(index) : id;
-                      })
-                      .join(', ')}`}
-              </div>
-            )}
-
-            <div className="mt-4 flex flex-wrap gap-2">
-              <Button onClick={checkAnswer} disabled={!hasSelection} variant={isChecked ? 'outline' : 'default'}>
-                {isChecked ? 'Checked' : 'Check answer'}
-              </Button>
-              {suggestedAnswer && (
-                <Button
-                  variant="outline"
-                  aria-expanded={isSuggestedAnswerShown}
-                  aria-controls="suggested-answer"
-                  onClick={() => setShownAnswerId(isSuggestedAnswerShown ? null : activeQuestion.id)}
-                >
-                  {isSuggestedAnswerShown ? 'Hide explanation' : 'Show explanation'}
-                </Button>
-              )}
-            </div>
-          </div>
-        ) : (
-          <div className="mt-6">
-            <label htmlFor="quiz-answer" className="text-sm font-semibold text-gray-900">
-              Your answer
-            </label>
-            <textarea
-              id="quiz-answer"
-              value={typeof answer === 'string' ? answer : ''}
-              onChange={(event) => updateWrittenAnswer(event.target.value)}
-              placeholder="Write your working or notes here..."
-              className="mt-2 block min-h-40 w-full resize-y rounded-lg border border-gray-300 bg-white p-3 text-base leading-relaxed text-gray-900 outline-none placeholder:text-gray-400"
-            />
-          </div>
-        )}
+        <div className="mt-6">
+          <label htmlFor="quiz-answer" className="text-sm font-semibold text-gray-900">
+            Your answer
+          </label>
+          <textarea
+            id="quiz-answer"
+            value={answer}
+            onChange={(event) => updateAnswer(event.target.value)}
+            placeholder="Write your working or notes here..."
+            className="mt-2 block min-h-40 w-full resize-y rounded-lg border border-gray-300 bg-white p-3 text-base leading-relaxed text-gray-900 outline-none placeholder:text-gray-400"
+          />
+        </div>
 
-        {suggestedAnswer && (choice ? isSuggestedAnswerShown : true) && (
+        {suggestedAnswer && (
           <div className="mt-5">
-            {!choice && (
-              <Button
-                variant="outline"
-                aria-expanded={isSuggestedAnswerShown}
-                aria-controls="suggested-answer"
-                onClick={() => setShownAnswerId(isSuggestedAnswerShown ? null : activeQuestion.id)}
-              >
-                {isSuggestedAnswerShown ? 'Hide answer' : 'Show answer'}
-              </Button>
-            )}
+            <Button
+              variant="outline"
+              aria-expanded={isSuggestedAnswerShown}
+              aria-controls="suggested-answer"
+              onClick={() => setShownAnswerId(isSuggestedAnswerShown ? null : activeQuestion.id)}
+            >
+              {isSuggestedAnswerShown ? 'Hide answer' : 'Show answer'}
+            </Button>
             {isSuggestedAnswerShown && (
               <section id="suggested-answer" className="mt-4 rounded-lg border border-gray-200 bg-gray-50 p-4">
-                <h3 className="m-0 text-base font-semibold text-gray-900">
-                  {choice ? 'Explanation' : 'Suggested answer'}
-                </h3>
+                <h3 className="m-0 text-base font-semibold text-gray-900">Suggested answer</h3>
                 <MarkdownContent content={suggestedAnswer} className="mt-3 text-sm leading-relaxed text-gray-800" />
               </section>
             )}
@@ -424,18 +219,9 @@ export function QuizPage() {
         )}
 
         <div className="mt-6 flex flex-wrap items-center justify-between gap-3">
-          <div className="flex gap-2">
-            <Button variant="outline" onClick={() => goToQuestion(Math.max(activeIndex - 1, 0))} disabled={activeIndex === 0}>
-              Previous
-            </Button>
-            <Button
-              variant="outline"
-              onClick={() => goToQuestion(Math.min(activeIndex + 1, quizQuestions.length - 1))}
-              disabled={activeIndex === quizQuestions.length - 1}
-            >
-              Next
-            </Button>
-          </div>
+          <Button variant="outline" onClick={() => goToQuestion(Math.max(activeIndex - 1, 0))} disabled={activeIndex === 0}>
+            Previous
+          </Button>
           <div className="ml-auto flex flex-wrap items-center justify-end gap-2">
             <Button variant="outline" onClick={() => updateQuestionStatus('unanswered')} disabled={session.completed}>
               Skip

package/framework/convex/quizzes.ts

@@ -40,7 +40,7 @@ export const saveProgress = mutation({
   args: {
     quizId: v.id('quizzes'),
     title: v.string(),
-    answers: v.record(v.string(), v.union(v.string(), v.array(v.string()))),
+    answers: v.record(v.string(), v.string()),
     currentQuestion: v.number(),
     completed: v.boolean(),
   },

package/framework/convex/schema.ts

@@ -5,7 +5,7 @@ export default defineSchema({
   quizzes: defineTable({
     title: v.string(),
     questionIds: v.array(v.string()),
-    answers: v.record(v.string(), v.union(v.string(), v.array(v.string()))),
+    answers: v.record(v.string(), v.string()),
     currentQuestion: v.number(),
     completed: v.boolean(),
     createdAt: v.number(),

package/framework/lib/convex-api.ts

@@ -2,13 +2,13 @@
 // Framework-owned: eject with `qb reveal framework/lib/convex-api.ts`.
 
 import { makeFunctionReference } from 'convex/server';
-import type { QuestionStatus, QuizAnswer, QuizSession } from '../../core/types.ts';
+import type { QuestionStatus, QuizSession } from '../../core/types.ts';
 
 type CreateQuizArgs = { title: string; questionIds: string[] };
 type ProgressArgs = {
   quizId: string;
   title: string;
-  answers: Record<string, QuizAnswer>;
+  answers: Record<string, string>;
   currentQuestion: number;
   completed: boolean;
 };

package/framework/lib/question-filter.ts

@@ -3,7 +3,7 @@
 // by config-defined `BankFieldDef[]` plus the three built-ins.
 // Framework-owned: eject with `qb reveal framework/lib/question-filter.ts`.
 
-import { questionKind, questionKindLabels, questionKinds, questionStatuses, type BankFieldDef, type BankFilterOperatorId, type BaseQuestion, type QuestionStatus } from '../../core/types.ts';
+import { questionStatuses, type BankFieldDef, type BankFilterOperatorId, type BaseQuestion, type QuestionStatus } from '../../core/types.ts';
 
 export type FilterMatch = 'and' | 'or';
 
@@ -101,13 +101,6 @@ function builtinFields(): FilterField[] {
     { id: 'title', label: 'Question', type: 'text', operators: textOperators, placeholder: 'Type a value…' },
     { id: 'id', label: 'ID', type: 'text', operators: textOperators, placeholder: 'Type a value…' },
     { id: 'tags', label: 'Tags', type: 'multiselect', operators: multiSelectOperators },
-    {
-      id: 'kind',
-      label: 'Type',
-      type: 'select',
-      operators: selectOperators,
-      options: questionKinds.map((kind) => ({ value: kind, label: questionKindLabels[kind] })),
-    },
     {
       id: 'status',
       label: 'Status',
@@ -227,7 +220,9 @@ function resolveFieldValue(
     if (ruleField === 'title') return question.title;
     if (ruleField === 'id') return question.id;
     if (ruleField === 'tags') return question.tags;
-    return (question[ruleField] as string | number | null | readonly string[]) ?? null;
+    // status is handled by matchesRule before reaching here. Any other id
+    // is stale (no def, not a built-in) — match nothing.
+    return null;
   }
   return def.getValue(question);
 }
@@ -328,7 +323,6 @@ export function matchesRule(
 ): boolean {
   const type = filterFieldType(fields, rule.field);
   if (rule.field === 'status') return matchSelect(status, rule);
-  if (rule.field === 'kind') return matchSelect(questionKind(question), rule);
   const def = fieldDefs.find((d) => d.id === rule.field);
   const raw = resolveFieldValue(def, rule.field, question);
   if (type === 'text') return matchText(toText(raw), rule);
@@ -352,7 +346,7 @@ export function matchesFilters(
     : active.some((rule) => matchesRule(rule, fields, fieldDefs, question, status));
 }
 
-/** Free-text search across id/title/prompt/tags/options plus `searchable` custom fields. */
+/** Free-text search across id/title/prompt/tags plus `searchable` custom fields. */
 export function matchesSearch(
   question: BaseQuestion,
   query: string,
@@ -360,13 +354,7 @@ export function matchesSearch(
 ): boolean {
   const q = query.trim().toLowerCase();
   if (!q) return true;
-  const parts = [
-    question.id,
-    question.title,
-    question.prompt,
-    question.tags.join(' '),
-    (question.options ?? []).map((o) => o.text).join(' '),
-  ];
+  const parts = [question.id, question.title, question.prompt, question.tags.join(' ')];
   for (const def of fieldDefs) {
     if (!def.searchable) continue;
     const raw = def.getValue(question);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "question-bank-framework",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Framework-style question bank: TanStack Start + TanStack Table grid, quizzes, and filter DSL. Bring your own bank.config.ts + content/. Eject any framework/ file with `qb reveal` (Vike-style).",
   "type": "module",
   "license": "MIT",
@@ -25,15 +25,6 @@
     "bin",
     "README.md"
   ],
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "changeset": "changeset",
-    "version-packages": "changeset version",
-    "release": "pnpm build:bin && changeset publish",
-    "reveal": "node ./bin/qb.js reveal",
-    "template:check": "node ./bin/qb.js check-template",
-    "build:bin": "tsc bin/qb.ts --ignoreConfig --outDir bin --target es2022 --module nodenext --moduleResolution nodenext --strict --skipLibCheck --types node && chmod +x bin/qb.js"
-  },
   "peerDependencies": {
     "@tanstack/react-router": "^1.170.0",
     "react": "^19.2.0",
@@ -64,5 +55,14 @@
     "@types/react-dom": "^19.2.0",
     "typescript": "^6.0.2",
     "vite": "^8.3.5"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "pnpm build:bin && changeset publish",
+    "reveal": "node ./bin/qb.js reveal",
+    "template:check": "node ./bin/qb.js check-template",
+    "build:bin": "tsc bin/qb.ts --ignoreConfig --outDir bin --target es2022 --module nodenext --moduleResolution nodenext --strict --skipLibCheck --types node && chmod +x bin/qb.js"
   }
-}
+}

package/template/bank.config.ts

@@ -3,26 +3,20 @@
 // config-defined — the framework never hardcodes subject fields.
 
 import { defineBank } from 'question-bank-framework';
+import type { BaseQuestion } from 'question-bank-framework';
 import questionsJson from './content/questions.json' with { type: 'json' };
 import { answers } from './content/answers.ts';
-import type { BaseQuestion } from 'question-bank-framework';
-
-const questions = questionsJson as BaseQuestion[];
 
-const str = (q: BaseQuestion, key: string): string => {
-  const v = q[key];
-  return typeof v === 'string' || typeof v === 'number' ? String(v) : '';
-};
+/** Subject question shape. Declare every field your accessors touch. */
+export interface Comp20008Question extends BaseQuestion {
+  year: number;
+  semester: string;
+  number: number;
+  marks: number | null;
+  source: string;
+}
 
-const num = (q: BaseQuestion, key: string): number | null => {
-  const v = q[key];
-  if (typeof v === 'number' && Number.isFinite(v)) return v;
-  if (typeof v === 'string' && v.trim() !== '') {
-    const n = Number(v);
-    return Number.isFinite(n) ? n : null;
-  }
-  return null;
-};
+const questions = questionsJson as Comp20008Question[];
 
 export const bank = defineBank({
   site: {
@@ -36,14 +30,14 @@ export const bank = defineBank({
       id: 'year',
       label: 'Year',
       type: 'select',
-      getValue: (q) => (typeof q['year'] === 'number' ? String(q['year']) : ''),
+      getValue: (q) => String(q.year),
       searchable: true,
     },
     {
       id: 'semester',
       label: 'Semester',
       type: 'select',
-      getValue: (q) => str(q, 'semester'),
+      getValue: (q) => q.semester,
       options: [
         { value: 'S1', label: 'Semester 1' },
         { value: 'S2', label: 'Semester 2' },
@@ -53,7 +47,7 @@ export const bank = defineBank({
       id: 'exam',
       label: 'Exam',
       type: 'text',
-      getValue: (q) => `${str(q, 'year')} ${str(q, 'semester')}`.trim(),
+      getValue: (q) => `${q.year} ${q.semester}`,
       searchable: true,
       column: { header: 'Exam', width: 108, sortable: false },
     },
@@ -61,7 +55,7 @@ export const bank = defineBank({
       id: 'marks',
       label: 'Marks',
       type: 'number',
-      getValue: (q) => num(q, 'marks'),
+      getValue: (q) => q.marks,
       placeholder: 'Value',
       column: { header: 'Marks', width: 78 },
     },

package/template/content/answers.ts

@@ -3,6 +3,4 @@
 
 export const answers: Record<string, string> = {
   '2019-s1-q01': String.raw`**(a)** Not well-formed: several sibling top-level elements, so no single root.`,
-  '2019-s1-mc01': String.raw`Only **B** has a single root element with matching open and close tags. A never closes, C closes in the wrong order, and D is not an element at all.`,
-  '2019-s1-mc02': String.raw`Remove or correct physically impossible values (**A**), always investigate before discarding (**C**), and document any imputation (**D**). Deleting everything above the mean (**B**) discards roughly half of legitimate data.`,
 };

package/template/content/questions.json

@@ -1,7 +1,6 @@
 [
   {
     "id": "2019-s1-q01",
-    "kind": "written",
     "year": 2019,
     "semester": "S1",
     "number": 1,
@@ -13,7 +12,6 @@
   },
   {
     "id": "2019-s1-q02",
-    "kind": "written",
     "year": 2019,
     "semester": "S1",
     "number": 2,
@@ -25,7 +23,6 @@
   },
   {
     "id": "ioa-001",
-    "kind": "written",
     "year": 2026,
     "semester": "S2",
     "number": 1,
@@ -34,43 +31,5 @@
     "prompt": "What is your research question, and what result would count as evidence?",
     "source": "assignment-ioa",
     "tags": ["Assignment questions", "Justification"]
-  },
-  {
-    "id": "2019-s1-mc01",
-    "kind": "single",
-    "year": 2019,
-    "semester": "S1",
-    "number": 3,
-    "marks": 1,
-    "title": "Well-formed XML",
-    "prompt": "Which of the following XML documents is well-formed?",
-    "options": [
-      { "id": "a", "text": "`<subject>COMP20008<subject>`" },
-      { "id": "b", "text": "`<subject>COMP20008</subject>`" },
-      { "id": "c", "text": "`<subject><topic>COMP20008</subject></topic>`" },
-      { "id": "d", "text": "`COMP20008`" }
-    ],
-    "correctIds": ["b"],
-    "source": "2019-s1.md",
-    "tags": ["Data fundamentals", "Data, formats & databases"]
-  },
-  {
-    "id": "2019-s1-mc02",
-    "kind": "multiple",
-    "year": 2019,
-    "semester": "S1",
-    "number": 4,
-    "marks": 2,
-    "title": "Outlier handling",
-    "prompt": "A temperature sensor reports occasional extreme spikes. Which of the following are reasonable outlier-handling steps? **Select all that apply.**",
-    "options": [
-      { "id": "a", "text": "Remove spikes that are physically impossible for the sensor" },
-      { "id": "b", "text": "Delete every reading above the mean" },
-      { "id": "c", "text": "Flag spikes and investigate whether they coincide with known events" },
-      { "id": "d", "text": "Replace spikes with interpolated values and document the change" }
-    ],
-    "correctIds": ["a", "c", "d"],
-    "source": "2019-s1.md",
-    "tags": ["Data preparation", "Data quality & preparation"]
   }
 ]