@kensai/quiz-core 0.1.0

package/dist/schema.generated.js

@@ -0,0 +1,626 @@
+// AUTO-GENERATED FILE — do not edit by hand.
+// Source: spec/quiz.schema.json  (run `pnpm sync:schema` to regenerate).
+export const quizSchema = {
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://github.com/kensai/quiz-core/spec/quiz.schema.json",
+    "title": "Kensai Quiz",
+    "description": "Specification for a single, portable, AI-authorable quiz (schema version 0.1).",
+    "type": "object",
+    "required": [
+        "schema_version",
+        "metadata",
+        "questions"
+    ],
+    "additionalProperties": false,
+    "properties": {
+        "schema_version": {
+            "type": "string",
+            "const": "0.1",
+            "description": "Spec version this file targets. Enables backward compatibility."
+        },
+        "metadata": {
+            "$ref": "#/$defs/metadata"
+        },
+        "settings": {
+            "$ref": "#/$defs/settings"
+        },
+        "categories": {
+            "type": "array",
+            "description": "Optional registry of categories used for end-of-quiz statistics.",
+            "items": {
+                "$ref": "#/$defs/category"
+            }
+        },
+        "option_groups": {
+            "type": "object",
+            "description": "Reusable named option sets. Reference them from questions via `options_from` / `groups_from`.",
+            "additionalProperties": {
+                "type": "array",
+                "minItems": 1,
+                "items": {
+                    "$ref": "#/$defs/option"
+                }
+            }
+        },
+        "questions": {
+            "type": "array",
+            "minItems": 1,
+            "items": {
+                "$ref": "#/$defs/question"
+            }
+        }
+    },
+    "$defs": {
+        "metadata": {
+            "type": "object",
+            "required": [
+                "title"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Optional stable slug."
+                },
+                "title": {
+                    "type": "string",
+                    "description": "Human title (Markdown)."
+                },
+                "path": {
+                    "type": "string",
+                    "description": "Study-path breadcrumb, e.g. 'English / Verb system / Present tenses'."
+                },
+                "description": {
+                    "type": "string",
+                    "description": "Optional overview (Markdown)."
+                },
+                "language": {
+                    "type": "string",
+                    "description": "BCP-47 content language tag, e.g. 'en', 'es'. Default: 'und'."
+                },
+                "author": {
+                    "type": "string"
+                },
+                "tags": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            }
+        },
+        "settings": {
+            "type": "object",
+            "description": "All fields optional. Author defaults; a player may override per attempt.",
+            "additionalProperties": false,
+            "properties": {
+                "navigation": {
+                    "enum": [
+                        "all",
+                        "sequential"
+                    ],
+                    "default": "all",
+                    "description": "'all' shows every question at once; 'sequential' advances one by one."
+                },
+                "order": {
+                    "enum": [
+                        "fixed",
+                        "random"
+                    ],
+                    "default": "fixed",
+                    "description": "Order in which questions are presented ('random' shuffles them)."
+                },
+                "feedback": {
+                    "enum": [
+                        "immediate",
+                        "on_finish"
+                    ],
+                    "default": "on_finish",
+                    "description": "Reveal correctness/explanation per question or only at the end."
+                },
+                "time_limit": {
+                    "type": [
+                        "number",
+                        "null"
+                    ],
+                    "minimum": 1,
+                    "default": null,
+                    "description": "Seconds allowed. null or omitted = unlimited."
+                },
+                "shuffle_options": {
+                    "type": "boolean",
+                    "default": false,
+                    "description": "Shuffle the answer-option order of choice questions, except those that set `shuffle_options: false`."
+                },
+                "passing_score": {
+                    "type": "number",
+                    "minimum": 0,
+                    "maximum": 1,
+                    "description": "Pass threshold as a fraction 0..1."
+                }
+            }
+        },
+        "category": {
+            "type": "object",
+            "required": [
+                "id",
+                "label"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Display label (Markdown)."
+                }
+            }
+        },
+        "option": {
+            "type": "object",
+            "required": [
+                "id",
+                "text"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Unique within its option list."
+                },
+                "text": {
+                    "type": "string",
+                    "description": "Option text (Markdown)."
+                }
+            }
+        },
+        "group": {
+            "type": "object",
+            "required": [
+                "id",
+                "label"
+            ],
+            "additionalProperties": false,
+            "properties": {
+                "id": {
+                    "type": "string"
+                },
+                "label": {
+                    "type": "string",
+                    "description": "Bucket label (Markdown)."
+                }
+            }
+        },
+        "id_or_id_list": {
+            "description": "A single id or a list of ids.",
+            "oneOf": [
+                {
+                    "type": "string"
+                },
+                {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "string"
+                    }
+                }
+            ]
+        },
+        "question": {
+            "type": "object",
+            "required": [
+                "type",
+                "prompt"
+            ],
+            "properties": {
+                "id": {
+                    "type": "string",
+                    "description": "Recommended: stable id for stats/resume."
+                },
+                "type": {
+                    "enum": [
+                        "choice",
+                        "true_false",
+                        "fill_blank",
+                        "classify",
+                        "matching",
+                        "ordering",
+                        "short_answer"
+                    ]
+                },
+                "category": {
+                    "type": "string",
+                    "description": "References a categories[].id, or a free-form string."
+                },
+                "points": {
+                    "type": "number",
+                    "minimum": 0,
+                    "default": 1
+                },
+                "prompt": {
+                    "type": "string",
+                    "description": "Question text (Markdown)."
+                },
+                "explanation": {
+                    "type": "string",
+                    "description": "Optional rationale (Markdown)."
+                }
+            },
+            "oneOf": [
+                {
+                    "$ref": "#/$defs/q_choice"
+                },
+                {
+                    "$ref": "#/$defs/q_true_false"
+                },
+                {
+                    "$ref": "#/$defs/q_fill_blank"
+                },
+                {
+                    "$ref": "#/$defs/q_classify"
+                },
+                {
+                    "$ref": "#/$defs/q_matching"
+                },
+                {
+                    "$ref": "#/$defs/q_ordering"
+                },
+                {
+                    "$ref": "#/$defs/q_short_answer"
+                }
+            ]
+        },
+        "q_choice": {
+            "properties": {
+                "type": {
+                    "const": "choice"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "select": {
+                    "enum": [
+                        "single",
+                        "multiple"
+                    ],
+                    "default": "single"
+                },
+                "options": {
+                    "type": "array",
+                    "minItems": 2,
+                    "items": {
+                        "$ref": "#/$defs/option"
+                    }
+                },
+                "options_from": {
+                    "type": "string",
+                    "description": "Name of an entry in option_groups."
+                },
+                "answer": {
+                    "$ref": "#/$defs/id_or_id_list"
+                },
+                "shuffle_options": {
+                    "type": "boolean",
+                    "default": true,
+                    "description": "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 like 'Both A and B')."
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "answer"
+            ],
+            "oneOf": [
+                {
+                    "required": [
+                        "options"
+                    ],
+                    "not": {
+                        "required": [
+                            "options_from"
+                        ]
+                    }
+                },
+                {
+                    "required": [
+                        "options_from"
+                    ],
+                    "not": {
+                        "required": [
+                            "options"
+                        ]
+                    }
+                }
+            ],
+            "additionalProperties": false
+        },
+        "q_true_false": {
+            "properties": {
+                "type": {
+                    "const": "true_false"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "answer": {
+                    "type": "boolean"
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "answer"
+            ],
+            "additionalProperties": false
+        },
+        "q_fill_blank": {
+            "properties": {
+                "type": {
+                    "const": "fill_blank"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "blanks": {
+                    "type": "object",
+                    "minProperties": 1,
+                    "description": "Map of placeholder id ({{id}} in prompt) to a blank definition.",
+                    "additionalProperties": {
+                        "$ref": "#/$defs/blank"
+                    }
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "blanks"
+            ],
+            "additionalProperties": false
+        },
+        "blank": {
+            "type": "object",
+            "description": "A blank is either free-text (accept) or a per-blank choice (options + answer).",
+            "additionalProperties": false,
+            "properties": {
+                "accept": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Accepted free-text answers (synonyms)."
+                },
+                "case_sensitive": {
+                    "type": "boolean",
+                    "default": false
+                },
+                "options": {
+                    "type": "array",
+                    "minItems": 2,
+                    "items": {
+                        "$ref": "#/$defs/option"
+                    }
+                },
+                "answer": {
+                    "type": "string",
+                    "description": "Correct option id (choice-per-blank variant)."
+                }
+            },
+            "oneOf": [
+                {
+                    "required": [
+                        "accept"
+                    ],
+                    "not": {
+                        "required": [
+                            "options"
+                        ]
+                    }
+                },
+                {
+                    "required": [
+                        "options",
+                        "answer"
+                    ],
+                    "not": {
+                        "required": [
+                            "accept"
+                        ]
+                    }
+                }
+            ]
+        },
+        "q_classify": {
+            "properties": {
+                "type": {
+                    "const": "classify"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "groups": {
+                    "type": "array",
+                    "minItems": 2,
+                    "items": {
+                        "$ref": "#/$defs/group"
+                    }
+                },
+                "groups_from": {
+                    "type": "string",
+                    "description": "Name of an entry in option_groups (its options act as buckets: id + text)."
+                },
+                "items": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "object",
+                        "required": [
+                            "id",
+                            "text",
+                            "answer"
+                        ],
+                        "additionalProperties": false,
+                        "properties": {
+                            "id": {
+                                "type": "string"
+                            },
+                            "text": {
+                                "type": "string",
+                                "description": "Item text (Markdown)."
+                            },
+                            "answer": {
+                                "type": "string",
+                                "description": "Target group id."
+                            }
+                        }
+                    }
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "items"
+            ],
+            "oneOf": [
+                {
+                    "required": [
+                        "groups"
+                    ],
+                    "not": {
+                        "required": [
+                            "groups_from"
+                        ]
+                    }
+                },
+                {
+                    "required": [
+                        "groups_from"
+                    ],
+                    "not": {
+                        "required": [
+                            "groups"
+                        ]
+                    }
+                }
+            ],
+            "additionalProperties": false
+        },
+        "q_matching": {
+            "properties": {
+                "type": {
+                    "const": "matching"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "left": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "$ref": "#/$defs/option"
+                    }
+                },
+                "right": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "$ref": "#/$defs/option"
+                    }
+                },
+                "answer": {
+                    "type": "object",
+                    "minProperties": 1,
+                    "description": "Map of left id -> right id.",
+                    "additionalProperties": {
+                        "type": "string"
+                    }
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "left",
+                "right",
+                "answer"
+            ],
+            "additionalProperties": false
+        },
+        "q_ordering": {
+            "properties": {
+                "type": {
+                    "const": "ordering"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "items": {
+                    "type": "array",
+                    "minItems": 2,
+                    "items": {
+                        "$ref": "#/$defs/option"
+                    }
+                },
+                "answer": {
+                    "type": "array",
+                    "minItems": 2,
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Item ids in the correct order."
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "items",
+                "answer"
+            ],
+            "additionalProperties": false
+        },
+        "q_short_answer": {
+            "properties": {
+                "type": {
+                    "const": "short_answer"
+                },
+                "id": true,
+                "category": true,
+                "points": true,
+                "prompt": true,
+                "explanation": true,
+                "accept": {
+                    "type": "array",
+                    "minItems": 1,
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "Accepted answers (synonyms)."
+                },
+                "case_sensitive": {
+                    "type": "boolean",
+                    "default": false
+                }
+            },
+            "required": [
+                "type",
+                "prompt",
+                "accept"
+            ],
+            "additionalProperties": false
+        }
+    }
+};
+export default quizSchema;
+//# sourceMappingURL=schema.generated.js.map

package/dist/schema.generated.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.generated.js","sourceRoot":"","sources":["../src/schema.generated.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,yEAAyE;AAEzE,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,SAAS,EAAE,8CAA8C;IACzD,KAAK,EAAE,2DAA2D;IAClE,OAAO,EAAE,aAAa;IACtB,aAAa,EAAE,gFAAgF;IAC/F,MAAM,EAAE,QAAQ;IAChB,UAAU,EAAE;QACV,gBAAgB;QAChB,UAAU;QACV,WAAW;KACZ;IACD,sBAAsB,EAAE,KAAK;IAC7B,YAAY,EAAE;QACZ,gBAAgB,EAAE;YAChB,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,iEAAiE;SACjF;QACD,UAAU,EAAE;YACV,MAAM,EAAE,kBAAkB;SAC3B;QACD,UAAU,EAAE;YACV,MAAM,EAAE,kBAAkB;SAC3B;QACD,YAAY,EAAE;YACZ,MAAM,EAAE,OAAO;YACf,aAAa,EAAE,kEAAkE;YACjF,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;aAC3B;SACF;QACD,eAAe,EAAE;YACf,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,+FAA+F;YAC9G,sBAAsB,EAAE;gBACtB,MAAM,EAAE,OAAO;gBACf,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE;oBACP,MAAM,EAAE,gBAAgB;iBACzB;aACF;SACF;QACD,WAAW,EAAE;YACX,MAAM,EAAE,OAAO;YACf,UAAU,EAAE,CAAC;YACb,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;aAC3B;SACF;KACF;IACD,OAAO,EAAE;QACP,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE;gBACV,OAAO;aACR;YACD,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,uBAAuB;iBACvC;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,yBAAyB;iBACzC;gBACD,MAAM,EAAE;oBACN,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,uEAAuE;iBACvF;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,+BAA+B;iBAC/C;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,+DAA+D;iBAC/E;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;iBACjB;gBACD,MAAM,EAAE;oBACN,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;iBACF;aACF;SACF;QACD,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,0EAA0E;YACzF,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,YAAY,EAAE;oBACZ,MAAM,EAAE;wBACN,KAAK;wBACL,YAAY;qBACb;oBACD,SAAS,EAAE,KAAK;oBAChB,aAAa,EAAE,uEAAuE;iBACvF;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE;wBACN,OAAO;wBACP,QAAQ;qBACT;oBACD,SAAS,EAAE,OAAO;oBAClB,aAAa,EAAE,kEAAkE;iBAClF;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE;wBACN,WAAW;wBACX,WAAW;qBACZ;oBACD,SAAS,EAAE,WAAW;oBACtB,aAAa,EAAE,iEAAiE;iBACjF;gBACD,YAAY,EAAE;oBACZ,MAAM,EAAE;wBACN,QAAQ;wBACR,MAAM;qBACP;oBACD,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,+CAA+C;iBAC/D;gBACD,iBAAiB,EAAE;oBACjB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,KAAK;oBAChB,aAAa,EAAE,sGAAsG;iBACtH;gBACD,eAAe,EAAE;oBACf,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,CAAC;oBACZ,aAAa,EAAE,oCAAoC;iBACpD;aACF;SACF;QACD,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE;gBACV,IAAI;gBACJ,OAAO;aACR;YACD,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;iBACjB;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,2BAA2B;iBAC3C;aACF;SACF;QACD,QAAQ,EAAE;YACR,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE;gBACV,IAAI;gBACJ,MAAM;aACP;YACD,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,gCAAgC;iBAChD;gBACD,MAAM,EAAE;oBACN,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,yBAAyB;iBACzC;aACF;SACF;QACD,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE;gBACV,IAAI;gBACJ,OAAO;aACR;YACD,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;iBACjB;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,0BAA0B;iBAC1C;aACF;SACF;QACD,eAAe,EAAE;YACf,aAAa,EAAE,+BAA+B;YAC9C,OAAO,EAAE;gBACP;oBACE,MAAM,EAAE,QAAQ;iBACjB;gBACD;oBACE,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;iBACF;aACF;SACF;QACD,UAAU,EAAE;YACV,MAAM,EAAE,QAAQ;YAChB,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;aACT;YACD,YAAY,EAAE;gBACZ,IAAI,EAAE;oBACJ,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,0CAA0C;iBAC1D;gBACD,MAAM,EAAE;oBACN,MAAM,EAAE;wBACN,QAAQ;wBACR,YAAY;wBACZ,YAAY;wBACZ,UAAU;wBACV,UAAU;wBACV,UAAU;wBACV,cAAc;qBACf;iBACF;gBACD,UAAU,EAAE;oBACV,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,sDAAsD;iBACtE;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;oBAChB,SAAS,EAAE,CAAC;oBACZ,SAAS,EAAE,CAAC;iBACb;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,2BAA2B;iBAC3C;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,gCAAgC;iBAChD;aACF;YACD,OAAO,EAAE;gBACP;oBACE,MAAM,EAAE,kBAAkB;iBAC3B;gBACD;oBACE,MAAM,EAAE,sBAAsB;iBAC/B;gBACD;oBACE,MAAM,EAAE,sBAAsB;iBAC/B;gBACD;oBACE,MAAM,EAAE,oBAAoB;iBAC7B;gBACD;oBACE,MAAM,EAAE,oBAAoB;iBAC7B;gBACD;oBACE,MAAM,EAAE,oBAAoB;iBAC7B;gBACD;oBACE,MAAM,EAAE,wBAAwB;iBACjC;aACF;SACF;QACD,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,QAAQ;iBAClB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE;oBACR,MAAM,EAAE;wBACN,QAAQ;wBACR,UAAU;qBACX;oBACD,SAAS,EAAE,QAAQ;iBACpB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,gBAAgB;qBACzB;iBACF;gBACD,cAAc,EAAE;oBACd,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,oCAAoC;iBACpD;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,uBAAuB;iBAChC;gBACD,iBAAiB,EAAE;oBACjB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,IAAI;oBACf,aAAa,EAAE,+LAA+L;iBAC/M;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT;YACD,OAAO,EAAE;gBACP;oBACE,UAAU,EAAE;wBACV,SAAS;qBACV;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,cAAc;yBACf;qBACF;iBACF;gBACD;oBACE,UAAU,EAAE;wBACV,cAAc;qBACf;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,SAAS;yBACV;qBACF;iBACF;aACF;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,cAAc,EAAE;YACd,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,YAAY;iBACtB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE;oBACR,MAAM,EAAE,SAAS;iBAClB;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,cAAc,EAAE;YACd,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,YAAY;iBACtB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;oBAChB,eAAe,EAAE,CAAC;oBAClB,aAAa,EAAE,iEAAiE;oBAChF,sBAAsB,EAAE;wBACtB,MAAM,EAAE,eAAe;qBACxB;iBACF;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,OAAO,EAAE;YACP,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,gFAAgF;YAC/F,sBAAsB,EAAE,KAAK;YAC7B,YAAY,EAAE;gBACZ,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;oBACD,aAAa,EAAE,wCAAwC;iBACxD;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,KAAK;iBACjB;gBACD,SAAS,EAAE;oBACT,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,gBAAgB;qBACzB;iBACF;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,+CAA+C;iBAC/D;aACF;YACD,OAAO,EAAE;gBACP;oBACE,UAAU,EAAE;wBACV,QAAQ;qBACT;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,SAAS;yBACV;qBACF;iBACF;gBACD;oBACE,UAAU,EAAE;wBACV,SAAS;wBACT,QAAQ;qBACT;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,QAAQ;yBACT;qBACF;iBACF;aACF;SACF;QACD,YAAY,EAAE;YACZ,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,UAAU;iBACpB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,eAAe;qBACxB;iBACF;gBACD,aAAa,EAAE;oBACb,MAAM,EAAE,QAAQ;oBAChB,aAAa,EAAE,4EAA4E;iBAC5F;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;wBAChB,UAAU,EAAE;4BACV,IAAI;4BACJ,MAAM;4BACN,QAAQ;yBACT;wBACD,sBAAsB,EAAE,KAAK;wBAC7B,YAAY,EAAE;4BACZ,IAAI,EAAE;gCACJ,MAAM,EAAE,QAAQ;6BACjB;4BACD,MAAM,EAAE;gCACN,MAAM,EAAE,QAAQ;gCAChB,aAAa,EAAE,uBAAuB;6BACvC;4BACD,QAAQ,EAAE;gCACR,MAAM,EAAE,QAAQ;gCAChB,aAAa,EAAE,kBAAkB;6BAClC;yBACF;qBACF;iBACF;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,OAAO;aACR;YACD,OAAO,EAAE;gBACP;oBACE,UAAU,EAAE;wBACV,QAAQ;qBACT;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,aAAa;yBACd;qBACF;iBACF;gBACD;oBACE,UAAU,EAAE;wBACV,aAAa;qBACd;oBACD,KAAK,EAAE;wBACL,UAAU,EAAE;4BACV,QAAQ;yBACT;qBACF;iBACF;aACF;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,YAAY,EAAE;YACZ,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,UAAU;iBACpB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,MAAM,EAAE;oBACN,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,gBAAgB;qBACzB;iBACF;gBACD,OAAO,EAAE;oBACP,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,gBAAgB;qBACzB;iBACF;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,QAAQ;oBAChB,eAAe,EAAE,CAAC;oBAClB,aAAa,EAAE,6BAA6B;oBAC5C,sBAAsB,EAAE;wBACtB,MAAM,EAAE,QAAQ;qBACjB;iBACF;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,MAAM;gBACN,OAAO;gBACP,QAAQ;aACT;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,YAAY,EAAE;YACZ,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,UAAU;iBACpB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,OAAO,EAAE;oBACP,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,gBAAgB;qBACzB;iBACF;gBACD,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;oBACD,aAAa,EAAE,gCAAgC;iBAChD;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,OAAO;gBACP,QAAQ;aACT;YACD,sBAAsB,EAAE,KAAK;SAC9B;QACD,gBAAgB,EAAE;YAChB,YAAY,EAAE;gBACZ,MAAM,EAAE;oBACN,OAAO,EAAE,cAAc;iBACxB;gBACD,IAAI,EAAE,IAAI;gBACV,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE,IAAI;gBACd,aAAa,EAAE,IAAI;gBACnB,QAAQ,EAAE;oBACR,MAAM,EAAE,OAAO;oBACf,UAAU,EAAE,CAAC;oBACb,OAAO,EAAE;wBACP,MAAM,EAAE,QAAQ;qBACjB;oBACD,aAAa,EAAE,8BAA8B;iBAC9C;gBACD,gBAAgB,EAAE;oBAChB,MAAM,EAAE,SAAS;oBACjB,SAAS,EAAE,KAAK;iBACjB;aACF;YACD,UAAU,EAAE;gBACV,MAAM;gBACN,QAAQ;gBACR,QAAQ;aACT;YACD,sBAAsB,EAAE,KAAK;SAC9B;KACF;CACO,CAAC;AAEX,eAAe,UAAU,CAAC"}

package/dist/settings.d.ts

@@ -0,0 +1,19 @@
+import type { FeedbackMode, NavigationMode, OrderMode, QuizSettings } from "./types.js";
+/** A fully-resolved settings object, with every field present. */
+export interface ResolvedSettings {
+    navigation: NavigationMode;
+    order: OrderMode;
+    feedback: FeedbackMode;
+    time_limit: number | null;
+    shuffle_options: boolean;
+    passing_score: number | null;
+}
+/** Defaults applied when `settings` (or a given field) is omitted. */
+export declare const DEFAULT_SETTINGS: ResolvedSettings;
+/**
+ * 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 declare function resolveSettings(authored?: QuizSettings, overrides?: Partial<ResolvedSettings>): ResolvedSettings;
+//# sourceMappingURL=settings.d.ts.map

package/dist/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,kEAAkE;AAClE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,cAAc,CAAC;IAC3B,KAAK,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,YAAY,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,sEAAsE;AACtE,eAAO,MAAM,gBAAgB,EAAE,gBAO9B,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,CAAC,EAAE,YAAY,EACvB,SAAS,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACpC,gBAAgB,CAMlB"}