@matinfo/vitepress-plugin-quiz 1.0.4 → 1.1.0

package/README.md

@@ -81,8 +81,24 @@ question: What CSS property controls text color?
 answer-input: color
 explanation: The `color` property sets the foreground text colour.
 :::
+
+:::quiz
+question: Match each language to its category
+pair: TypeScript => Compiled
+pair: Python => Interpreted
+pair: HTML => Markup
+distractor: Query language
+:::
 ```
 
+### Syntax notes
+
+- Association: two or more `pair: Item => Match` (or `pair: Item --> Match`) lines render one drop-down per item; options are derived from the right-hand values (plus optional `distractor:` lines). All rows must match for a correct answer.
+- Keys are case-insensitive (`Question:`, `ANSWER-CORRECT:`).
+- Values can span several lines: any line that is not a known key continues the previous `question`, `answer`/`answer-correct` or `explanation`.
+- Fill-in-the-blank answers are lenient: capitals, accents, surrounding and repeated spaces are ignored (`reseau` matches `Réseau`). Repeat `answer-input:` to accept several variants.
+- Invalid blocks (no question, no answers) and choice quizzes without `answer-correct` log a build-time warning with the line number.
+
 ---
 
 ## Documentation

package/dist/src/types/quiz.d.ts

@@ -3,11 +3,17 @@ export interface QuizAnswer {
     correct: boolean;
     originalIndex?: number;
 }
+export interface QuizPair {
+    left: string;
+    right: string;
+}
 export interface QuizData {
     question: string;
-    type: "choice" | "input";
+    type: "choice" | "input" | "association";
     answers: QuizAnswer[];
     expected: string[];
+    pairs: QuizPair[];
+    options: string[];
     explanation: string;
     shuffle: boolean;
 }
@@ -21,6 +27,8 @@ export interface QuizLocale {
     inputHint: string;
     inputPlaceholder: string;
     expectedAnswer: string;
+    associationHint: string;
+    associationPlaceholder: string;
 }
 export interface QuizState {
     answered: boolean;
@@ -34,4 +42,8 @@ export interface SavedInputAnswer {
     type: "input";
     input: string;
 }
-export type SavedAnswer = SavedChoiceAnswer | SavedInputAnswer;
+export interface SavedAssociationAnswer {
+    type: "association";
+    chosen: (number | null)[];
+}
+export type SavedAnswer = SavedChoiceAnswer | SavedInputAnswer | SavedAssociationAnswer;

package/dist/src/utils.d.ts

@@ -10,3 +10,8 @@ export type RichPart = {
  * Used for question titles, answer text, and explanations.
  */
 export declare function parseRichText(text: string): RichPart[];
+/**
+ * Normalise a typed answer for lenient comparison: case-insensitive,
+ * accent-insensitive ("Réseau" == "reseau"), trimmed, whitespace collapsed.
+ */
+export declare function normalizeInput(text: string): string;