@kensai/quiz-core 0.1.0

package/dist/settings.js

@@ -0,0 +1,32 @@
+/** Defaults applied when `settings` (or a given field) is omitted. */
+export const DEFAULT_SETTINGS = {
+    navigation: "all",
+    order: "fixed",
+    feedback: "on_finish",
+    time_limit: null,
+    shuffle_options: false,
+    passing_score: null,
+};
+/**
+ * Merge authored settings and optional per-attempt overrides over the documented
+ * defaults. `undefined` fields are ignored (so partial overrides are safe);
+ * explicit `null` is kept (e.g. to clear a time limit).
+ */
+export function resolveSettings(authored, overrides) {
+    return {
+        ...DEFAULT_SETTINGS,
+        ...omitUndefined(authored),
+        ...omitUndefined(overrides),
+    };
+}
+function omitUndefined(obj) {
+    if (!obj)
+        return {};
+    const out = {};
+    for (const key of Object.keys(obj)) {
+        if (obj[key] !== undefined)
+            out[key] = obj[key];
+    }
+    return out;
+}
+//# sourceMappingURL=settings.js.map

package/dist/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAiBA,sEAAsE;AACtE,MAAM,CAAC,MAAM,gBAAgB,GAAqB;IAChD,UAAU,EAAE,KAAK;IACjB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,WAAW;IACrB,UAAU,EAAE,IAAI;IAChB,eAAe,EAAE,KAAK;IACtB,aAAa,EAAE,IAAI;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAuB,EACvB,SAAqC;IAErC,OAAO;QACL,GAAG,gBAAgB;QACnB,GAAG,aAAa,CAAC,QAAQ,CAAC;QAC1B,GAAG,aAAa,CAAC,SAAS,CAAC;KAC5B,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAmB,GAAO;IAC9C,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,GAAG,GAAe,EAAE,CAAC;IAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAgB,EAAE,CAAC;QAClD,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/stats.d.ts

@@ -0,0 +1,33 @@
+import type { Quiz } from "./types.js";
+import type { QuestionResult } from "./evaluate.js";
+export interface CategoryStat {
+    /** Declared/free-form category id, or `null` for the uncategorized bucket. */
+    categoryId: string | null;
+    /** Human label from the categories registry, when available. */
+    label?: string;
+    total: number;
+    answered: number;
+    correct: number;
+    incorrect: number;
+    score: number;
+    maxScore: number;
+    /** correct / total (0 when the bucket is empty). */
+    accuracy: number;
+}
+export interface OverallStat {
+    total: number;
+    answered: number;
+    correct: number;
+    incorrect: number;
+    score: number;
+    maxScore: number;
+    accuracy: number;
+}
+export interface QuizStats {
+    overall: OverallStat;
+    /** Declared categories first (in declaration order), then any free-form, uncategorized last. */
+    byCategory: CategoryStat[];
+}
+/** Aggregate per-question results into overall and per-category statistics. */
+export declare function computeStats(quiz: Quiz, results: QuestionResult[]): QuizStats;
+//# sourceMappingURL=stats.d.ts.map

package/dist/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gEAAgE;IAChE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,gGAAgG;IAChG,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,+EAA+E;AAC/E,wBAAgB,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,SAAS,CA8E7E"}

package/dist/stats.js

@@ -0,0 +1,79 @@
+/** Aggregate per-question results into overall and per-category statistics. */
+export function computeStats(quiz, results) {
+    const labels = new Map();
+    for (const category of quiz.categories ?? [])
+        labels.set(category.id, category.label);
+    const buckets = new Map();
+    const bucketFor = (key) => {
+        let bucket = buckets.get(key);
+        if (!bucket) {
+            bucket = {
+                categoryId: key,
+                label: key !== null ? labels.get(key) : undefined,
+                total: 0,
+                answered: 0,
+                correct: 0,
+                incorrect: 0,
+                score: 0,
+                maxScore: 0,
+                accuracy: 0,
+            };
+            buckets.set(key, bucket);
+        }
+        return bucket;
+    };
+    const overall = {
+        total: 0,
+        answered: 0,
+        correct: 0,
+        incorrect: 0,
+        score: 0,
+        maxScore: 0,
+        accuracy: 0,
+    };
+    for (const result of results) {
+        const bucket = bucketFor(result.category ?? null);
+        bucket.total++;
+        overall.total++;
+        if (result.answered) {
+            bucket.answered++;
+            overall.answered++;
+        }
+        if (result.correct) {
+            bucket.correct++;
+            overall.correct++;
+        }
+        else {
+            bucket.incorrect++;
+            overall.incorrect++;
+        }
+        bucket.score += result.score;
+        overall.score += result.score;
+        bucket.maxScore += result.maxScore;
+        overall.maxScore += result.maxScore;
+    }
+    for (const bucket of buckets.values()) {
+        bucket.accuracy = bucket.total > 0 ? bucket.correct / bucket.total : 0;
+    }
+    overall.accuracy = overall.total > 0 ? overall.correct / overall.total : 0;
+    const byCategory = [];
+    // Declared categories first, in declaration order.
+    for (const category of quiz.categories ?? []) {
+        const bucket = buckets.get(category.id);
+        if (bucket) {
+            byCategory.push(bucket);
+            buckets.delete(category.id);
+        }
+    }
+    // Any remaining free-form (non-null) categories.
+    for (const [key, bucket] of buckets) {
+        if (key !== null)
+            byCategory.push(bucket);
+    }
+    // Uncategorized bucket last.
+    const uncategorized = buckets.get(null);
+    if (uncategorized)
+        byCategory.push(uncategorized);
+    return { overall, byCategory };
+}
+//# sourceMappingURL=stats.js.map

package/dist/stats.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.js","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"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"}

package/dist/text.d.ts

@@ -0,0 +1,5 @@
+/** Normalize free-text for comparison: trim, collapse whitespace, optional lowercase. */
+export declare function normalizeText(value: string, caseSensitive?: boolean): string;
+/** True if `given` matches any accepted answer under the same normalization. */
+export declare function textMatches(given: string, accept: readonly string[], caseSensitive?: boolean): boolean;
+//# sourceMappingURL=text.d.ts.map

package/dist/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM,CAG1E;AAED,gFAAgF;AAChF,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,SAAS,MAAM,EAAE,EACzB,aAAa,UAAQ,GACpB,OAAO,CAGT"}

package/dist/text.js

@@ -0,0 +1,11 @@
+/** Normalize free-text for comparison: trim, collapse whitespace, optional lowercase. */
+export function normalizeText(value, caseSensitive = false) {
+    const trimmed = value.trim().replace(/\s+/g, " ");
+    return caseSensitive ? trimmed : trimmed.toLowerCase();
+}
+/** True if `given` matches any accepted answer under the same normalization. */
+export function textMatches(given, accept, caseSensitive = false) {
+    const normalized = normalizeText(given, caseSensitive);
+    return accept.some((a) => normalizeText(a, caseSensitive) === normalized);
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,aAAa,GAAG,KAAK;IAChE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAClD,OAAO,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;AACzD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,WAAW,CACzB,KAAa,EACb,MAAyB,EACzB,aAAa,GAAG,KAAK;IAErB,MAAM,UAAU,GAAG,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACvD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,aAAa,CAAC,KAAK,UAAU,CAAC,CAAC;AAC5E,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,136 @@
+/**
+ * Type definitions for the Kensai Quiz format (schema version 0.1).
+ *
+ * These types mirror `spec/quiz.schema.json`, which remains the authoritative
+ * definition used for runtime validation. When the schema changes, keep these
+ * types in sync (and re-run `pnpm sync:schema`).
+ */
+export type SchemaVersion = "0.1";
+export type QuestionType = "choice" | "true_false" | "fill_blank" | "classify" | "matching" | "ordering" | "short_answer";
+export interface QuizMetadata {
+    id?: string;
+    title: string;
+    path?: string;
+    description?: string;
+    language?: string;
+    author?: string;
+    tags?: string[];
+}
+export type NavigationMode = "all" | "sequential";
+export type OrderMode = "fixed" | "random";
+export type FeedbackMode = "immediate" | "on_finish";
+export interface QuizSettings {
+    navigation?: NavigationMode;
+    order?: OrderMode;
+    feedback?: FeedbackMode;
+    /** Seconds allowed for the whole attempt. `null`/omitted = unlimited. */
+    time_limit?: number | null;
+    shuffle_options?: boolean;
+    /** Pass threshold as a fraction 0..1. */
+    passing_score?: number;
+}
+export interface Category {
+    id: string;
+    label: string;
+}
+export interface Option {
+    id: string;
+    text: string;
+}
+export interface Group {
+    id: string;
+    label: string;
+}
+export interface BaseQuestion {
+    id?: string;
+    category?: string;
+    points?: number;
+    prompt: string;
+    explanation?: string;
+}
+export interface ChoiceQuestion extends BaseQuestion {
+    type: "choice";
+    select?: "single" | "multiple";
+    options?: Option[];
+    /** Name of an entry in `option_groups`. Mutually exclusive with `options`. */
+    options_from?: string;
+    answer: string | string[];
+    /**
+     * Whether these options may be reordered when the quiz enables option shuffling.
+     * Default `true`; set `false` to lock the order (e.g. an "All of the above" option
+     * or options that reference position like "Both A and B").
+     */
+    shuffle_options?: boolean;
+}
+export interface TrueFalseQuestion extends BaseQuestion {
+    type: "true_false";
+    answer: boolean;
+}
+/** A blank is either free-text (`accept`) or a per-blank choice (`options` + `answer`). */
+export interface Blank {
+    accept?: string[];
+    case_sensitive?: boolean;
+    options?: Option[];
+    answer?: string;
+}
+export interface FillBlankQuestion extends BaseQuestion {
+    type: "fill_blank";
+    /** Map of placeholder id ({{id}} in prompt) to a blank definition. */
+    blanks: Record<string, Blank>;
+}
+export interface ClassifyItem {
+    id: string;
+    text: string;
+    /** Target group id. */
+    answer: string;
+}
+export interface ClassifyQuestion extends BaseQuestion {
+    type: "classify";
+    groups?: Group[];
+    /** Name of an entry in `option_groups` used as buckets. Mutually exclusive with `groups`. */
+    groups_from?: string;
+    items: ClassifyItem[];
+}
+export interface MatchingQuestion extends BaseQuestion {
+    type: "matching";
+    left: Option[];
+    right: Option[];
+    /** Map of left id -> right id. */
+    answer: Record<string, string>;
+}
+export interface OrderingQuestion extends BaseQuestion {
+    type: "ordering";
+    items: Option[];
+    /** Item ids in the correct order. */
+    answer: string[];
+}
+export interface ShortAnswerQuestion extends BaseQuestion {
+    type: "short_answer";
+    accept: string[];
+    case_sensitive?: boolean;
+}
+export type Question = ChoiceQuestion | TrueFalseQuestion | FillBlankQuestion | ClassifyQuestion | MatchingQuestion | OrderingQuestion | ShortAnswerQuestion;
+export interface Quiz {
+    schema_version: SchemaVersion;
+    metadata: QuizMetadata;
+    settings?: QuizSettings;
+    /** Registry of categories used for end-of-quiz statistics. */
+    categories?: Category[];
+    /** Reusable named option sets, referenced via `options_from` / `groups_from`. */
+    option_groups?: Record<string, Option[]>;
+    questions: Question[];
+}
+/** One option id (single-select) or a list of ids (multiple-select). */
+export type ChoiceAnswer = string | string[];
+export type TrueFalseAnswer = boolean;
+/** Map of blank id -> submitted text (free-text) or selected option id. */
+export type FillBlankAnswer = Record<string, string>;
+/** Map of item id -> chosen group id. */
+export type ClassifyAnswer = Record<string, string>;
+/** Map of left id -> chosen right id. */
+export type MatchingAnswer = Record<string, string>;
+/** Item ids in the taker's chosen order. */
+export type OrderingAnswer = string[];
+export type ShortTextAnswer = string;
+export type AnswerInput = ChoiceAnswer | TrueFalseAnswer | FillBlankAnswer | ClassifyAnswer | MatchingAnswer | OrderingAnswer | ShortTextAnswer;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * Type definitions for the Kensai Quiz format (schema version 0.1).
+ *
+ * These types mirror `spec/quiz.schema.json`, which remains the authoritative
+ * definition used for runtime validation. When the schema changes, keep these
+ * types in sync (and re-run `pnpm sync:schema`).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/validate.d.ts

@@ -0,0 +1,28 @@
+import type { Quiz } from "./types.js";
+export type IssueSeverity = "error" | "warning";
+export type IssueKind = "schema" | "reference";
+export interface ValidationIssue {
+    severity: IssueSeverity;
+    kind: IssueKind;
+    /** JSON-pointer-ish path to the offending node (e.g. `/questions/2/answer`). */
+    path: string;
+    message: string;
+}
+export interface ValidationResult {
+    /** True when there are no error-severity issues (warnings are allowed). */
+    valid: boolean;
+    issues: ValidationIssue[];
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+/** Structural validation against the authoritative JSON Schema. */
+export declare function validateSchema(data: unknown): ValidationIssue[];
+/**
+ * Referential-integrity checks that a JSON Schema cannot express: answers point at
+ * existing ids, `*_from` names resolve, placeholders match blanks, ids are unique,
+ * etc. Assumes `quiz` already passed schema validation.
+ */
+export declare function validateReferences(quiz: Quiz): ValidationIssue[];
+/** Full validation: schema first, then referential integrity (only if the shape is valid). */
+export declare function validateQuiz(data: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAWvC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAChD,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,SAAS,CAAC;IAChB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,2EAA2E;IAC3E,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAWD,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,eAAe,EAAE,CAI/D;AAgBD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,eAAe,EAAE,CAiJhE;AAED,8FAA8F;AAC9F,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAQ5D"}

package/dist/validate.js

@@ -0,0 +1,170 @@
+import AjvModule from "ajv/dist/2020.js";
+import { quizSchema } from "./schema.generated.js";
+import { resolveChoiceOptions, resolveGroups } from "./resolve.js";
+// ajv is published as CommonJS; under NodeNext the interop default can be the
+// module namespace, so unwrap a possible nested `default` and construct via a
+// typed alias exposing just the `compile` we use.
+const Ajv2020 = (AjvModule.default ??
+    AjvModule);
+// Ajv accepts unknown vocabulary keywords (`description`, `default`) with strict off.
+const ajv = new Ajv2020({ allErrors: true, strict: false });
+let compiled = null;
+function getValidator() {
+    if (!compiled)
+        compiled = ajv.compile(quizSchema);
+    return compiled;
+}
+/** Structural validation against the authoritative JSON Schema. */
+export function validateSchema(data) {
+    const validate = getValidator();
+    if (validate(data))
+        return [];
+    return (validate.errors ?? []).map(fromAjvError);
+}
+function fromAjvError(error) {
+    const path = error.instancePath || "/";
+    const params = error.params && Object.keys(error.params).length
+        ? " " + JSON.stringify(error.params)
+        : "";
+    return {
+        severity: "error",
+        kind: "schema",
+        path,
+        message: `${error.message ?? "invalid"}${params}`,
+    };
+}
+/**
+ * Referential-integrity checks that a JSON Schema cannot express: answers point at
+ * existing ids, `*_from` names resolve, placeholders match blanks, ids are unique,
+ * etc. Assumes `quiz` already passed schema validation.
+ */
+export function validateReferences(quiz) {
+    const issues = [];
+    const add = (severity, path, message) => issues.push({ severity, kind: "reference", path, message });
+    const declaredCategories = new Set((quiz.categories ?? []).map((c) => c.id));
+    const seenQuestionIds = new Set();
+    quiz.questions.forEach((question, i) => {
+        const base = `/questions/${i}`;
+        if (question.id) {
+            if (seenQuestionIds.has(question.id)) {
+                add("error", `${base}/id`, `Duplicate question id "${question.id}".`);
+            }
+            seenQuestionIds.add(question.id);
+        }
+        if (question.category && quiz.categories && !declaredCategories.has(question.category)) {
+            add("warning", `${base}/category`, `Category "${question.category}" is not declared in categories[].`);
+        }
+        switch (question.type) {
+            case "choice": {
+                if (question.options_from &&
+                    !(quiz.option_groups && question.options_from in quiz.option_groups)) {
+                    add("error", `${base}/options_from`, `option_groups has no entry "${question.options_from}".`);
+                }
+                const options = resolveChoiceOptions(quiz, question);
+                reportDuplicateIds(options.map((o) => o.id), `${base}/options`, add);
+                const optionIds = new Set(options.map((o) => o.id));
+                const answers = Array.isArray(question.answer) ? question.answer : [question.answer];
+                for (const answerId of answers) {
+                    if (!optionIds.has(answerId)) {
+                        add("error", `${base}/answer`, `Answer id "${answerId}" is not among the options.`);
+                    }
+                }
+                if ((question.select ?? "single") === "single" && answers.length !== 1) {
+                    add("error", `${base}/answer`, `A single-select choice must have exactly one answer.`);
+                }
+                break;
+            }
+            case "fill_blank": {
+                const placeholders = extractPlaceholders(question.prompt);
+                for (const [key, blank] of Object.entries(question.blanks)) {
+                    if (!placeholders.has(key)) {
+                        add("warning", `${base}/blanks/${key}`, `Blank "${key}" has no {{${key}}} placeholder in the prompt.`);
+                    }
+                    if (blank.options && blank.answer !== undefined) {
+                        if (!blank.options.some((o) => o.id === blank.answer)) {
+                            add("error", `${base}/blanks/${key}/answer`, `Answer "${blank.answer}" is not among the blank options.`);
+                        }
+                    }
+                }
+                for (const placeholder of placeholders) {
+                    if (!(placeholder in question.blanks)) {
+                        add("warning", `${base}/prompt`, `Placeholder {{${placeholder}}} has no matching blank definition.`);
+                    }
+                }
+                break;
+            }
+            case "classify": {
+                if (question.groups_from &&
+                    !(quiz.option_groups && question.groups_from in quiz.option_groups)) {
+                    add("error", `${base}/groups_from`, `option_groups has no entry "${question.groups_from}".`);
+                }
+                const groupIds = new Set(resolveGroups(quiz, question).map((g) => g.id));
+                reportDuplicateIds(question.items.map((it) => it.id), `${base}/items`, add);
+                question.items.forEach((item, j) => {
+                    if (!groupIds.has(item.answer)) {
+                        add("error", `${base}/items/${j}/answer`, `Item answer "${item.answer}" is not a declared group.`);
+                    }
+                });
+                break;
+            }
+            case "matching": {
+                const leftIds = new Set(question.left.map((o) => o.id));
+                const rightIds = new Set(question.right.map((o) => o.id));
+                for (const [leftId, rightId] of Object.entries(question.answer)) {
+                    if (!leftIds.has(leftId)) {
+                        add("error", `${base}/answer`, `Answer key "${leftId}" is not a left id.`);
+                    }
+                    if (!rightIds.has(rightId)) {
+                        add("error", `${base}/answer`, `Answer value "${rightId}" is not a right id.`);
+                    }
+                }
+                break;
+            }
+            case "ordering": {
+                const itemIds = question.items.map((o) => o.id);
+                reportDuplicateIds(itemIds, `${base}/items`, add);
+                const itemIdSet = new Set(itemIds);
+                const answerSet = new Set(question.answer);
+                const isPermutation = question.answer.length === itemIds.length &&
+                    itemIds.every((id) => answerSet.has(id)) &&
+                    question.answer.every((id) => itemIdSet.has(id));
+                if (!isPermutation) {
+                    add("error", `${base}/answer`, "Ordering answer must be a permutation of all item ids.");
+                }
+                break;
+            }
+            default:
+                break;
+        }
+    });
+    return issues;
+}
+/** Full validation: schema first, then referential integrity (only if the shape is valid). */
+export function validateQuiz(data) {
+    let issues = validateSchema(data);
+    if (issues.length === 0) {
+        issues = issues.concat(validateReferences(data));
+    }
+    const errors = issues.filter((i) => i.severity === "error");
+    const warnings = issues.filter((i) => i.severity === "warning");
+    return { valid: errors.length === 0, issues, errors, warnings };
+}
+const PLACEHOLDER_RE = /\{\{\s*([^}\s]+)\s*\}\}/g;
+function extractPlaceholders(prompt) {
+    const found = new Set();
+    let match;
+    PLACEHOLDER_RE.lastIndex = 0;
+    while ((match = PLACEHOLDER_RE.exec(prompt)) !== null) {
+        found.add(match[1]);
+    }
+    return found;
+}
+function reportDuplicateIds(ids, path, add) {
+    const seen = new Set();
+    for (const id of ids) {
+        if (seen.has(id))
+            add("error", path, `Duplicate id "${id}".`);
+        seen.add(id);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@kensai/quiz-core",
+  "version": "0.1.0",
+  "description": "Headless, UI-agnostic engine for the Kensai Quiz format: load, validate, evaluate answers, run an attempt, and compute per-category statistics.",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "quiz",
+    "assessment",
+    "education",
+    "yaml",
+    "json-schema",
+    "headless"
+  ],
+  "homepage": "https://github.com/EFRA-GM/kensai-quiz#readme",
+  "bugs": {
+    "url": "https://github.com/EFRA-GM/kensai-quiz/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/EFRA-GM/kensai-quiz.git",
+    "directory": "packages/core"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "ajv": "^8.17.1",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "sync:schema": "node scripts/sync-schema.mjs",
+    "prebuild": "node scripts/sync-schema.mjs",
+    "build": "tsc -p tsconfig.json",
+    "pretest": "node scripts/sync-schema.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "pretypecheck": "node scripts/sync-schema.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
+}