@kensai/quiz-core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Efraín García
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,99 @@
+# @kensai/quiz-core
+
+Headless, UI-agnostic engine for the [Kensai Quiz format](../../spec). It loads and
+validates a quiz file, evaluates answers, runs an **attempt** (a framework-agnostic
+state machine), and computes **per-category statistics**. No DOM, no timers, no UI
+dependency — any web project brings its own UI and consumes this package.
+
+```text
+quiz file (YAML/JSON)  ──loadQuiz──▶  Quiz  ──Attempt──▶  events + QuizResult + QuizStats
+                          │
+                          └─ validated against spec/quiz.schema.json (authoritative)
+```
+
+## Install
+
+```bash
+pnpm add @kensai/quiz-core
+```
+
+## Quick start
+
+```ts
+import { loadQuiz, Attempt } from "@kensai/quiz-core";
+
+const quiz = loadQuiz(yamlString);                 // parse + validate (throws on error)
+
+const attempt = new Attempt(quiz, {
+  settings: { feedback: "immediate" },             // per-attempt overrides (optional)
+});
+
+attempt.on("answered", ({ result }) => {           // `result` only under immediate feedback
+  if (result) console.log(result.correct ? "✓" : "✗");
+});
+attempt.on("finished", ({ result }) => {
+  console.log(`${result.score}/${result.maxScore}`, result.passed);
+  for (const c of result.stats.byCategory) {
+    console.log(c.label ?? c.categoryId, `${c.correct}/${c.total}`);
+  }
+});
+
+attempt.start();
+attempt.answer(["verb"]);   // answer current question (shape depends on type — see below)
+attempt.next();
+// ...
+attempt.finish();
+```
+
+Prefer stateless calls? Skip the attempt and evaluate directly:
+
+```ts
+import { evaluateQuiz } from "@kensai/quiz-core";
+const result = evaluateQuiz(quiz, { q1: ["verb"], q7: "mice" }); // keyed by question id
+```
+
+## Answer shapes (per question type)
+
+| Type | Answer value |
+|------|--------------|
+| `choice` | option id (`"a"`) or list of ids (`["a","b"]`) |
+| `true_false` | `boolean` |
+| `fill_blank` | `{ [blankId]: text-or-optionId }` |
+| `classify` | `{ [itemId]: groupId }` |
+| `matching` | `{ [leftId]: rightId }` |
+| `ordering` | ordered id list (`["b","a","c"]`) |
+| `short_answer` | `string` |
+
+Answers are keyed by the question's `id`, falling back to its index (as a string)
+when it has none.
+
+## API surface
+
+- **Load / validate** — `loadQuiz`, `parseQuizSource`, `validateQuiz`,
+  `validateSchema`, `validateReferences`, `QuizValidationError`. Validation combines
+  the JSON Schema (structure) with referential checks (answer ids exist, `*_from`
+  names resolve, placeholders match blanks, ordering answers are permutations, …).
+- **Evaluate** — `evaluateQuiz`, `evaluateQuestion`, `gradeQuestion`. Partial credit
+  is awarded where meaningful (`fill_blank`, `classify`, `matching`, `ordering`);
+  `choice` / `true_false` / `short_answer` are all-or-nothing.
+- **Statistics** — `computeStats` → overall + per-category counts, scores, accuracy.
+- **Runtime** — `Attempt` (navigation, answers, feedback timing, optional time limit,
+  events `started` / `answered` / `navigated` / `time_up` / `finished`, plus
+  `toJSON()` / `Attempt.resume()` for persistence). The clock and RNG are injectable
+  (`now`, `rng`) for testing and SSR; the attempt never starts real timers.
+- **Settings** — `resolveSettings`, `DEFAULT_SETTINGS`. Defaults: `navigation: all`,
+  `order: fixed`, `feedback: on_finish`, unlimited time, `shuffle_options: false`.
+
+## Development
+
+```bash
+pnpm sync:schema   # regenerate src/schema.generated.ts from spec/quiz.schema.json
+pnpm build         # tsc → dist (ESM + .d.ts)
+pnpm test          # vitest (unit + validates every spec/examples/*.yaml)
+pnpm typecheck     # tsc --noEmit
+```
+
+The JSON Schema in `spec/` is the single source of truth for validation; it is inlined
+into `src/schema.generated.ts` (a generated file) so the package needs no runtime file
+read and bundles cleanly for the browser. Regenerate with `pnpm sync:schema` after any
+schema change.

package/dist/evaluate.d.ts

@@ -0,0 +1,47 @@
+import type { AnswerInput, Question, Quiz } from "./types.js";
+import { type ResolvedSettings } from "./settings.js";
+import { type QuizStats } from "./stats.js";
+export interface QuestionResult {
+    /** Index into `quiz.questions`. */
+    index: number;
+    id?: string;
+    type: Question["type"];
+    category?: string;
+    answered: boolean;
+    /** Whole-question correctness (`fraction === 1`). */
+    correct: boolean;
+    /** Correctness in 0..1 — partial where meaningful (fill_blank, classify, matching, ordering). */
+    fraction: number;
+    /** Earned points: `fraction * maxScore`. */
+    score: number;
+    /** `points` (default 1). */
+    maxScore: number;
+}
+export interface QuizResult {
+    results: QuestionResult[];
+    score: number;
+    maxScore: number;
+    /** `score / maxScore` (0 when `maxScore` is 0). */
+    ratio: number;
+    /** Pass/fail vs the resolved `passing_score`; `null` when it is unset. */
+    passed: boolean | null;
+    stats: QuizStats;
+}
+export interface EvaluateOptions {
+    /** Per-attempt settings overrides (e.g. a player-provided `passing_score`). */
+    settingsOverride?: Partial<ResolvedSettings>;
+}
+/**
+ * Grade a single question, returning correctness in 0..1. Types with independent
+ * sub-parts (fill_blank, classify, matching, ordering) return partial credit;
+ * choice/true_false/short_answer are all-or-nothing.
+ */
+export declare function gradeQuestion(quiz: Quiz, question: Question, answer: AnswerInput | undefined): number;
+/** Evaluate one question against a submitted answer (or `undefined` if unanswered). */
+export declare function evaluateQuestion(quiz: Quiz, question: Question, index: number, answer: AnswerInput | undefined): QuestionResult;
+/**
+ * Evaluate a whole quiz. `answers` is keyed by question id, falling back to the
+ * stringified question index for questions without an id.
+ */
+export declare function evaluateQuiz(quiz: Quiz, answers: Record<string, AnswerInput>, options?: EvaluateOptions): QuizResult;
+//# sourceMappingURL=evaluate.d.ts.map

package/dist/evaluate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.d.ts","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAG9D,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1D,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,OAAO,EAAE,OAAO,CAAC;IACjB,iGAAiG;IACjG,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,SAAS,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAYD;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,MAAM,CA8ER;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,cAAc,CAchB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EACpC,OAAO,GAAE,eAAoB,GAC5B,UAAU,CAcZ"}

package/dist/evaluate.js

@@ -0,0 +1,149 @@
+import { resolveChoiceOptions } from "./resolve.js";
+import { normalizeText } from "./text.js";
+import { resolveSettings } from "./settings.js";
+import { computeStats } from "./stats.js";
+const pointsOf = (question) => question.points ?? 1;
+function isBlankAnswer(answer) {
+    if (answer === undefined || answer === null)
+        return true;
+    if (typeof answer === "string")
+        return answer.trim() === "";
+    if (Array.isArray(answer))
+        return answer.length === 0;
+    if (typeof answer === "object")
+        return Object.keys(answer).length === 0;
+    return false; // boolean (true_false) is always a real answer
+}
+/**
+ * Grade a single question, returning correctness in 0..1. Types with independent
+ * sub-parts (fill_blank, classify, matching, ordering) return partial credit;
+ * choice/true_false/short_answer are all-or-nothing.
+ */
+export function gradeQuestion(quiz, question, answer) {
+    if (answer === undefined || answer === null)
+        return 0;
+    switch (question.type) {
+        case "choice": {
+            const optionIds = new Set(resolveChoiceOptions(quiz, question).map((o) => o.id));
+            const expectedList = (Array.isArray(question.answer) ? question.answer : [question.answer])
+                .filter((id) => optionIds.has(id));
+            const expected = new Set(expectedList);
+            if (expected.size === 0)
+                return 0;
+            const givenList = (Array.isArray(answer) ? answer : [answer]).filter((a) => typeof a === "string");
+            const given = new Set(givenList);
+            if (given.size !== expected.size)
+                return 0;
+            for (const id of given)
+                if (!expected.has(id))
+                    return 0;
+            return 1;
+        }
+        case "true_false":
+            return answer === question.answer ? 1 : 0;
+        case "short_answer": {
+            if (typeof answer !== "string")
+                return 0;
+            const caseSensitive = question.case_sensitive ?? false;
+            const given = normalizeText(answer, caseSensitive);
+            return question.accept.some((a) => normalizeText(a, caseSensitive) === given) ? 1 : 0;
+        }
+        case "fill_blank": {
+            const given = asRecord(answer);
+            const keys = Object.keys(question.blanks);
+            if (keys.length === 0)
+                return 0;
+            let correct = 0;
+            for (const key of keys) {
+                const blank = question.blanks[key];
+                const value = given[key];
+                if (value === undefined)
+                    continue;
+                if (blank.options && blank.answer !== undefined) {
+                    if (value === blank.answer)
+                        correct++;
+                }
+                else if (blank.accept) {
+                    const caseSensitive = blank.case_sensitive ?? false;
+                    const normalized = normalizeText(value, caseSensitive);
+                    if (blank.accept.some((a) => normalizeText(a, caseSensitive) === normalized))
+                        correct++;
+                }
+            }
+            return correct / keys.length;
+        }
+        case "classify": {
+            const given = asRecord(answer);
+            if (question.items.length === 0)
+                return 0;
+            let correct = 0;
+            for (const item of question.items)
+                if (given[item.id] === item.answer)
+                    correct++;
+            return correct / question.items.length;
+        }
+        case "matching": {
+            const given = asRecord(answer);
+            const keys = Object.keys(question.answer);
+            if (keys.length === 0)
+                return 0;
+            let correct = 0;
+            for (const key of keys)
+                if (given[key] === question.answer[key])
+                    correct++;
+            return correct / keys.length;
+        }
+        case "ordering": {
+            const given = Array.isArray(answer) ? answer : [];
+            const expected = question.answer;
+            if (expected.length === 0)
+                return 0;
+            let correct = 0;
+            for (let i = 0; i < expected.length; i++)
+                if (given[i] === expected[i])
+                    correct++;
+            return correct / expected.length;
+        }
+        default:
+            return 0;
+    }
+}
+/** Evaluate one question against a submitted answer (or `undefined` if unanswered). */
+export function evaluateQuestion(quiz, question, index, answer) {
+    const fraction = gradeQuestion(quiz, question, answer);
+    const maxScore = pointsOf(question);
+    return {
+        index,
+        id: question.id,
+        type: question.type,
+        category: question.category,
+        answered: !isBlankAnswer(answer),
+        correct: fraction >= 1,
+        fraction,
+        score: fraction * maxScore,
+        maxScore,
+    };
+}
+/**
+ * Evaluate a whole quiz. `answers` is keyed by question id, falling back to the
+ * stringified question index for questions without an id.
+ */
+export function evaluateQuiz(quiz, answers, options = {}) {
+    const settings = resolveSettings(quiz.settings, options.settingsOverride);
+    const results = quiz.questions.map((question, index) => {
+        const key = question.id ?? String(index);
+        return evaluateQuestion(quiz, question, index, answers[key]);
+    });
+    const score = results.reduce((sum, r) => sum + r.score, 0);
+    const maxScore = results.reduce((sum, r) => sum + r.maxScore, 0);
+    const ratio = maxScore > 0 ? score / maxScore : 0;
+    const passed = settings.passing_score == null ? null : ratio >= settings.passing_score;
+    const stats = computeStats(quiz, results);
+    return { results, score, maxScore, ratio, passed, stats };
+}
+function asRecord(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : {};
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../src/evaluate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAyB,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,YAAY,EAAkB,MAAM,YAAY,CAAC;AAmC1D,MAAM,QAAQ,GAAG,CAAC,QAAkB,EAAU,EAAE,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;AAEtE,SAAS,aAAa,CAAC,MAA+B;IACpD,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACzD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5D,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;IACtD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC,CAAC,+CAA+C;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,IAAU,EACV,QAAkB,EAClB,MAA+B;IAE/B,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,CAAC,CAAC;IAEtD,QAAQ,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACjF,MAAM,YAAY,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACxF,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;YACrC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;YACvC,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAClE,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAC1C,CAAC;YACF,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,SAAS,CAAC,CAAC;YACjC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,CAAC,IAAI;gBAAE,OAAO,CAAC,CAAC;YAC3C,KAAK,MAAM,EAAE,IAAI,KAAK;gBAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,KAAK,YAAY;YACf,OAAO,MAAM,KAAK,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE5C,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,CAAC,CAAC;YACzC,MAAM,aAAa,GAAG,QAAQ,CAAC,cAAc,IAAI,KAAK,CAAC;YACvD,MAAM,KAAK,GAAG,aAAa,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;YACnD,OAAO,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACxF,CAAC;QAED,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAChC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAE,CAAC;gBACpC,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;gBACzB,IAAI,KAAK,KAAK,SAAS;oBAAE,SAAS;gBAClC,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;oBAChD,IAAI,KAAK,KAAK,KAAK,CAAC,MAAM;wBAAE,OAAO,EAAE,CAAC;gBACxC,CAAC;qBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;oBACxB,MAAM,aAAa,GAAG,KAAK,CAAC,cAAc,IAAI,KAAK,CAAC;oBACpD,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;oBACvD,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,UAAU,CAAC;wBAAE,OAAO,EAAE,CAAC;gBAC1F,CAAC;YACH,CAAC;YACD,OAAO,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,IAAI,QAAQ,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAC1C,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,KAAK;gBAAE,IAAI,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC,MAAM;oBAAE,OAAO,EAAE,CAAC;YACjF,OAAO,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QACzC,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC1C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YAChC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,MAAM,GAAG,IAAI,IAAI;gBAAE,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC;oBAAE,OAAO,EAAE,CAAC;YAC3E,OAAO,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/B,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAE,MAAmB,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,MAAM,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;YACjC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAC;YACpC,IAAI,OAAO,GAAG,CAAC,CAAC;YAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE;gBAAE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC;oBAAE,OAAO,EAAE,CAAC;YAClF,OAAO,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;QACnC,CAAC;QAED;YACE,OAAO,CAAC,CAAC;IACb,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,gBAAgB,CAC9B,IAAU,EACV,QAAkB,EAClB,KAAa,EACb,MAA+B;IAE/B,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACpC,OAAO;QACL,KAAK;QACL,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,QAAQ,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC;QAChC,OAAO,EAAE,QAAQ,IAAI,CAAC;QACtB,QAAQ;QACR,KAAK,EAAE,QAAQ,GAAG,QAAQ;QAC1B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAU,EACV,OAAoC,EACpC,UAA2B,EAAE;IAE7B,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC1E,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QACrD,MAAM,GAAG,GAAG,QAAQ,CAAC,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,OAAO,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,QAAQ,CAAC,aAAa,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,QAAQ,CAAC,aAAa,CAAC;IACvF,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE1C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;AAC5D,CAAC;AAED,SAAS,QAAQ,CAAC,KAAkB;IAClC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAChE,CAAC,CAAE,KAAgC;QACnC,CAAC,CAAC,EAAE,CAAC;AACT,CAAC"}

package/dist/events.d.ts

@@ -0,0 +1,10 @@
+export type Listener<T> = (payload: T) => void;
+/** Minimal, dependency-free typed event emitter. */
+export declare class Emitter<Events extends Record<string, unknown>> {
+    private readonly listeners;
+    /** Subscribe. Returns an unsubscribe function. */
+    on<K extends keyof Events>(event: K, listener: Listener<Events[K]>): () => void;
+    off<K extends keyof Events>(event: K, listener: Listener<Events[K]>): void;
+    emit<K extends keyof Events>(event: K, payload: Events[K]): void;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,IAAI,CAAC;AAE/C,oDAAoD;AACpD,qBAAa,OAAO,CAAC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmD;IAE7E,kDAAkD;IAClD,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAU/E,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI1E,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;CAMjE"}

package/dist/events.js

@@ -0,0 +1,26 @@
+/** Minimal, dependency-free typed event emitter. */
+export class Emitter {
+    listeners = new Map();
+    /** Subscribe. Returns an unsubscribe function. */
+    on(event, listener) {
+        let set = this.listeners.get(event);
+        if (!set) {
+            set = new Set();
+            this.listeners.set(event, set);
+        }
+        set.add(listener);
+        return () => this.off(event, listener);
+    }
+    off(event, listener) {
+        this.listeners.get(event)?.delete(listener);
+    }
+    emit(event, payload) {
+        const set = this.listeners.get(event);
+        if (!set)
+            return;
+        // Copy so listeners may unsubscribe during dispatch.
+        for (const listener of [...set])
+            listener(payload);
+    }
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAEA,oDAAoD;AACpD,MAAM,OAAO,OAAO;IACD,SAAS,GAAG,IAAI,GAAG,EAAwC,CAAC;IAE7E,kDAAkD;IAClD,EAAE,CAAyB,KAAQ,EAAE,QAA6B;QAChE,IAAI,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACjC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,QAA6B,CAAC,CAAC;QACvC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAyB,KAAQ,EAAE,QAA6B;QACjE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAA6B,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,CAAyB,KAAQ,EAAE,OAAkB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,qDAAqD;QACrD,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC;YAAG,QAAgC,CAAC,OAAO,CAAC,CAAC;IAC9E,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @kensai/quiz-core — headless engine for the Kensai Quiz format.
+ *
+ * Load and validate a quiz, evaluate answers, run an attempt (a UI-agnostic
+ * state machine), and compute per-category statistics. No UI or DOM dependency;
+ * any player consumes this package.
+ */
+export * from "./types.js";
+export { DEFAULT_SETTINGS, resolveSettings } from "./settings.js";
+export type { ResolvedSettings } from "./settings.js";
+export { quizSchema } from "./schema.generated.js";
+export { loadQuiz, parseQuizSource, QuizValidationError } from "./load.js";
+export type { LoadOptions, SourceFormat } from "./load.js";
+export { validateQuiz, validateSchema, validateReferences } from "./validate.js";
+export type { ValidationResult, ValidationIssue, IssueSeverity, IssueKind, } from "./validate.js";
+export { evaluateQuiz, evaluateQuestion, gradeQuestion } from "./evaluate.js";
+export type { QuizResult, QuestionResult, EvaluateOptions } from "./evaluate.js";
+export { computeStats } from "./stats.js";
+export type { QuizStats, CategoryStat, OverallStat } from "./stats.js";
+export { resolveChoiceOptions, resolveGroups } from "./resolve.js";
+export { normalizeText, textMatches } from "./text.js";
+export { Attempt } from "./runtime.js";
+export type { AttemptOptions, AttemptEvents, AttemptStatus, AttemptSnapshot, CurrentQuestion, } from "./runtime.js";
+export { Emitter } from "./events.js";
+export type { Listener } from "./events.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAClE,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAE3D,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACjF,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,aAAa,EACb,SAAS,GACV,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9E,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEjF,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,cAAc,EACd,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @kensai/quiz-core — headless engine for the Kensai Quiz format.
+ *
+ * Load and validate a quiz, evaluate answers, run an attempt (a UI-agnostic
+ * state machine), and compute per-category statistics. No UI or DOM dependency;
+ * any player consumes this package.
+ */
+export * from "./types.js";
+export { DEFAULT_SETTINGS, resolveSettings } from "./settings.js";
+export { quizSchema } from "./schema.generated.js";
+export { loadQuiz, parseQuizSource, QuizValidationError } from "./load.js";
+export { validateQuiz, validateSchema, validateReferences } from "./validate.js";
+export { evaluateQuiz, evaluateQuestion, gradeQuestion } from "./evaluate.js";
+export { computeStats } from "./stats.js";
+export { resolveChoiceOptions, resolveGroups } from "./resolve.js";
+export { normalizeText, textMatches } from "./text.js";
+export { Attempt } from "./runtime.js";
+export { Emitter } from "./events.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAG3E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAQjF,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AASvC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/load.d.ts

@@ -0,0 +1,22 @@
+import type { Quiz } from "./types.js";
+import { type ValidationIssue } from "./validate.js";
+/** Thrown by `loadQuiz` when validation fails. Carries the error-severity issues. */
+export declare class QuizValidationError extends Error {
+    readonly issues: ValidationIssue[];
+    constructor(issues: ValidationIssue[]);
+}
+export type SourceFormat = "yaml" | "json";
+/** Parse a quiz source string into a plain object. Does not validate. */
+export declare function parseQuizSource(source: string, format?: SourceFormat): unknown;
+export interface LoadOptions {
+    /** Source format when `source` is a string. Default: `"yaml"`. */
+    format?: SourceFormat;
+    /** Validate against the schema + references before returning. Default: `true`. */
+    validate?: boolean;
+}
+/**
+ * Load a quiz from a YAML/JSON string or an already-parsed object. Validates by
+ * default and throws `QuizValidationError` on any error-severity issue.
+ */
+export declare function loadQuiz(source: string | object, options?: LoadOptions): Quiz;
+//# sourceMappingURL=load.d.ts.map

package/dist/load.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAgB,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AAEnE,qFAAqF;AACrF,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,MAAM,EAAE,eAAe,EAAE;CAMtC;AAED,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,CAAC;AAE3C,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,GAAE,YAAqB,GAAG,OAAO,CAEtF;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI,CAQjF"}

package/dist/load.js

@@ -0,0 +1,31 @@
+import yaml from "js-yaml";
+import { validateQuiz } from "./validate.js";
+/** Thrown by `loadQuiz` when validation fails. Carries the error-severity issues. */
+export class QuizValidationError extends Error {
+    issues;
+    constructor(issues) {
+        const detail = issues.map((i) => `  [${i.path}] ${i.message}`).join("\n");
+        super(`Quiz validation failed with ${issues.length} error(s):\n${detail}`);
+        this.name = "QuizValidationError";
+        this.issues = issues;
+    }
+}
+/** Parse a quiz source string into a plain object. Does not validate. */
+export function parseQuizSource(source, format = "yaml") {
+    return format === "json" ? JSON.parse(source) : yaml.load(source);
+}
+/**
+ * Load a quiz from a YAML/JSON string or an already-parsed object. Validates by
+ * default and throws `QuizValidationError` on any error-severity issue.
+ */
+export function loadQuiz(source, options = {}) {
+    const { format = "yaml", validate = true } = options;
+    const data = typeof source === "string" ? parseQuizSource(source, format) : source;
+    if (validate) {
+        const result = validateQuiz(data);
+        if (!result.valid)
+            throw new QuizValidationError(result.errors);
+    }
+    return data;
+}
+//# sourceMappingURL=load.js.map

package/dist/load.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../src/load.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,SAAS,CAAC;AAE3B,OAAO,EAAE,YAAY,EAAwB,MAAM,eAAe,CAAC;AAEnE,qFAAqF;AACrF,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,MAAM,CAAoB;IAEnC,YAAY,MAAyB;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1E,KAAK,CAAC,+BAA+B,MAAM,CAAC,MAAM,eAAe,MAAM,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAID,yEAAyE;AACzE,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAAuB,MAAM;IAC3E,OAAO,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACpE,CAAC;AASD;;;GAGG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAuB,EAAE,UAAuB,EAAE;IACzE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IACnF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,IAAY,CAAC;AACtB,CAAC"}

package/dist/resolve.d.ts

@@ -0,0 +1,9 @@
+import type { ChoiceQuestion, ClassifyQuestion, Group, Option, Quiz } from "./types.js";
+/** Resolve a choice question's options, whether inline or from an option_group. */
+export declare function resolveChoiceOptions(quiz: Quiz, question: ChoiceQuestion): Option[];
+/**
+ * Resolve a classify question's buckets. Inline `groups` are used as-is; a
+ * `groups_from` option group is adapted (its `text` becomes the bucket `label`).
+ */
+export declare function resolveGroups(quiz: Quiz, question: ClassifyQuestion): Group[];
+//# sourceMappingURL=resolve.d.ts.map

package/dist/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAExF,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,EAAE,CAInF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,gBAAgB,GAAG,KAAK,EAAE,CAO7E"}

package/dist/resolve.js

@@ -0,0 +1,22 @@
+/** Resolve a choice question's options, whether inline or from an option_group. */
+export function resolveChoiceOptions(quiz, question) {
+    if (question.options)
+        return question.options;
+    if (question.options_from)
+        return quiz.option_groups?.[question.options_from] ?? [];
+    return [];
+}
+/**
+ * Resolve a classify question's buckets. Inline `groups` are used as-is; a
+ * `groups_from` option group is adapted (its `text` becomes the bucket `label`).
+ */
+export function resolveGroups(quiz, question) {
+    if (question.groups)
+        return question.groups;
+    if (question.groups_from) {
+        const group = quiz.option_groups?.[question.groups_from] ?? [];
+        return group.map((option) => ({ id: option.id, label: option.text }));
+    }
+    return [];
+}
+//# sourceMappingURL=resolve.js.map

package/dist/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../src/resolve.ts"],"names":[],"mappings":"AAEA,mFAAmF;AACnF,MAAM,UAAU,oBAAoB,CAAC,IAAU,EAAE,QAAwB;IACvE,IAAI,QAAQ,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC9C,IAAI,QAAQ,CAAC,YAAY;QAAE,OAAO,IAAI,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACpF,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAU,EAAE,QAA0B;IAClE,IAAI,QAAQ,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC,MAAM,CAAC;IAC5C,IAAI,QAAQ,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC"}