@mathscan/math-exercise-engine 1.0.7 → 1.0.8

package/dist/index.d.ts

@@ -37,6 +37,8 @@ export declare const AST_TYPES: {
     readonly TABLE_CELL: "TableCell";
     /** Drag-and-drop options tool */
     readonly DRAG_OPTIONS: "DragOptions";
+    /** Radio button options tool */
+    readonly RADIO_OPTIONS: "RadioOptions";
     /** Numeric keypad input tool */
     readonly NUMERIC_KEYPAD: "NumericKeypad";
     /** Simple answer matching validation */
@@ -266,6 +268,11 @@ export declare function compileWithAST(dsl: string): {
                     colspan?: number | undefined;
                 }[];
             }[];
+        } | {
+            type: "RadioOptions";
+            options: string[];
+            name: string;
+            answer: string;
         })[];
         question?: {
             value: string;
@@ -300,6 +307,9 @@ export declare function compileWithAST(dsl: string): {
         } | {
             type: "drag-options";
             options: string[];
+        } | {
+            type: "radio-options";
+            options: string[];
         } | {
             type: "numeric-keypad";
             includeOperators?: boolean | undefined;
@@ -801,6 +811,21 @@ export declare const ContentBlockSchema: z.ZodUnion<[z.ZodObject<{
             colspan?: number | undefined;
         }[];
     }[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"RadioOptions">;
+    name: z.ZodString;
+    options: z.ZodArray<z.ZodString, "many">;
+    answer: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "RadioOptions";
+    options: string[];
+    name: string;
+    answer: string;
+}, {
+    type: "RadioOptions";
+    options: string[];
+    name: string;
+    answer: string;
 }>]>;
 
 /**
@@ -1462,6 +1487,21 @@ export declare const ExerciseDocumentSchema: z.ZodObject<{
                 colspan?: number | undefined;
             }[];
         }[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"RadioOptions">;
+        name: z.ZodString;
+        options: z.ZodArray<z.ZodString, "many">;
+        answer: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "RadioOptions";
+        options: string[];
+        name: string;
+        answer: string;
+    }, {
+        type: "RadioOptions";
+        options: string[];
+        name: string;
+        answer: string;
     }>]>, "many">;
     tools: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
         type: z.ZodLiteral<"DragOptions">;
@@ -1583,6 +1623,11 @@ export declare const ExerciseDocumentSchema: z.ZodObject<{
                 colspan?: number | undefined;
             }[];
         }[];
+    } | {
+        type: "RadioOptions";
+        options: string[];
+        name: string;
+        answer: string;
     })[];
     question?: {
         value: string;
@@ -1678,6 +1723,11 @@ export declare const ExerciseDocumentSchema: z.ZodObject<{
                 colspan?: number | undefined;
             }[];
         }[];
+    } | {
+        type: "RadioOptions";
+        options: string[];
+        name: string;
+        answer: string;
     })[];
     question?: {
         value: string;
@@ -1732,6 +1782,15 @@ export declare const ExerciseJSONSchema: z.ZodObject<{
     }, {
         type: "drag-options";
         options: string[];
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"radio-options">;
+        options: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        type: "radio-options";
+        options: string[];
+    }, {
+        type: "radio-options";
+        options: string[];
     }>, z.ZodObject<{
         type: z.ZodLiteral<"numeric-keypad">;
         includeOperators: z.ZodOptional<z.ZodBoolean>;
@@ -1797,6 +1856,9 @@ export declare const ExerciseJSONSchema: z.ZodObject<{
     } | {
         type: "drag-options";
         options: string[];
+    } | {
+        type: "radio-options";
+        options: string[];
     } | {
         type: "numeric-keypad";
         includeOperators?: boolean | undefined;
@@ -1829,6 +1891,9 @@ export declare const ExerciseJSONSchema: z.ZodObject<{
     } | {
         type: "drag-options";
         options: string[];
+    } | {
+        type: "radio-options";
+        options: string[];
     } | {
         type: "numeric-keypad";
         includeOperators?: boolean | undefined;
@@ -2302,6 +2367,13 @@ export declare function isQuestionText(item: LayoutItem): item is Extract<Layout
     type: 'question-text';
 }>;
 
+/**
+ * Type guard for RadioOptionsJSON
+ */
+export declare function isRadioOptionsJSON(widget: WidgetJSON): widget is Extract<WidgetJSON, {
+    type: 'radio-options';
+}>;
+
 export declare function isSimpleValidation(value: unknown): value is SimpleValidation;
 
 export declare function isSpace(value: unknown): value is SpaceInline;
@@ -2398,6 +2470,8 @@ export declare const JSON_TYPES: {
     readonly INLINE_INPUT: "inline-input";
     /** Drag-and-drop options widget */
     readonly DRAG_OPTIONS: "drag-options";
+    /** Radio button options widget */
+    readonly RADIO_OPTIONS: "radio-options";
     /** Numeric keypad widget */
     readonly NUMERIC_KEYPAD: "numeric-keypad";
 };
@@ -2421,7 +2495,7 @@ export declare interface LayoutRendererProps {
     widgets: Record<string, WidgetJSON>;
     values: Record<string, string>;
     droppedInputs: Set<string>;
-    onChange: (widgetId: string, value: string, fromDrop?: boolean) => void;
+    onChange: (widgetId: string, value: string, fromDrop?: boolean, sourceOptionId?: string) => void;
     onInputFocus?: (widgetId: string) => void;
 }
 
@@ -2733,6 +2807,49 @@ export declare const QuestionTextSchema: z.ZodObject<{
     id: string;
 }>;
 
+export declare type RadioOptionsBlock = z.infer<typeof RadioOptionsBlockSchema>;
+
+/**
+ * Radio options block schema - single-choice radio buttons
+ *
+ * @example
+ * {
+ *   type: "RadioOptions",
+ *   name: "q1",
+ *   options: ["apple", "orange", "banana"],
+ *   answer: "apple"
+ * }
+ */
+declare const RadioOptionsBlockSchema: z.ZodObject<{
+    type: z.ZodLiteral<"RadioOptions">;
+    name: z.ZodString;
+    options: z.ZodArray<z.ZodString, "many">;
+    answer: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "RadioOptions";
+    options: string[];
+    name: string;
+    answer: string;
+}, {
+    type: "RadioOptions";
+    options: string[];
+    name: string;
+    answer: string;
+}>;
+
+export declare type RadioOptionsJSON = z.infer<typeof RadioOptionsJSONSchema>;
+
+export declare const RadioOptionsJSONSchema: z.ZodObject<{
+    type: z.ZodLiteral<"radio-options">;
+    options: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "radio-options";
+    options: string[];
+}, {
+    type: "radio-options";
+    options: string[];
+}>;
+
 /**
  * DOM helper for quick usage / demos.
  *
@@ -3881,6 +3998,9 @@ export declare function validateExerciseJSON(data: unknown): {
     } | {
         type: "drag-options";
         options: string[];
+    } | {
+        type: "radio-options";
+        options: string[];
     } | {
         type: "numeric-keypad";
         includeOperators?: boolean | undefined;
@@ -3931,6 +4051,9 @@ export declare function validateExerciseJSONSafe(data: unknown): z.SafeParseRetu
     } | {
         type: "drag-options";
         options: string[];
+    } | {
+        type: "radio-options";
+        options: string[];
     } | {
         type: "numeric-keypad";
         includeOperators?: boolean | undefined;
@@ -3963,6 +4086,9 @@ export declare function validateExerciseJSONSafe(data: unknown): z.SafeParseRetu
     } | {
         type: "drag-options";
         options: string[];
+    } | {
+        type: "radio-options";
+        options: string[];
     } | {
         type: "numeric-keypad";
         includeOperators?: boolean | undefined;
@@ -4023,6 +4149,9 @@ export declare function validateWidgetJSON(data: unknown): {
 } | {
     type: "drag-options";
     options: string[];
+} | {
+    type: "radio-options";
+    options: string[];
 } | {
     type: "numeric-keypad";
     includeOperators?: boolean | undefined;
@@ -4046,6 +4175,9 @@ export declare function validateWidgetJSONSafe(data: unknown): z.SafeParseReturn
 } | {
     type: "drag-options";
     options: string[];
+} | {
+    type: "radio-options";
+    options: string[];
 } | {
     type: "numeric-keypad";
     includeOperators?: boolean | undefined;
@@ -4061,6 +4193,9 @@ export declare function validateWidgetJSONSafe(data: unknown): z.SafeParseReturn
 } | {
     type: "drag-options";
     options: string[];
+} | {
+    type: "radio-options";
+    options: string[];
 } | {
     type: "numeric-keypad";
     includeOperators?: boolean | undefined;
@@ -4169,6 +4304,15 @@ export declare const WidgetJSONSchema: z.ZodUnion<[z.ZodDiscriminatedUnion<"inpu
 }, {
     type: "drag-options";
     options: string[];
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"radio-options">;
+    options: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    type: "radio-options";
+    options: string[];
+}, {
+    type: "radio-options";
+    options: string[];
 }>, z.ZodObject<{
     type: z.ZodLiteral<"numeric-keypad">;
     includeOperators: z.ZodOptional<z.ZodBoolean>;
@@ -4211,7 +4355,7 @@ export declare interface WidgetRendererProps {
     widgetId: string;
     value: string;
     isDropped?: boolean;
-    onChange: (widgetId: string, value: string, fromDrop?: boolean) => void;
+    onChange: (widgetId: string, value: string, fromDrop?: boolean, sourceOptionId?: string) => void;
     onInputFocus?: (widgetId: string) => void;
     onKeypadChange?: (value: string) => void;
 }