@mathscan/math-exercise-engine 1.1.11 → 1.1.12

package/dist/index.d.ts

@@ -15765,6 +15765,8 @@ export declare interface ExerciseRendererRef {
     getCompletion: () => InputCompletion;
     reset: () => void;
     focusFirstInput: () => void;
+    /** Fill every widget with its correct answer. No-op for display-only exercises. */
+    revealAnswers: () => void;
 }
 
 export declare type ExpressionValidation = z.infer<typeof ExpressionValidationSchema>;

package/dist/index.js

@@ -17676,26 +17676,42 @@ const NumberLineRenderer = ({
     positions,
     cursors
   } = item;
-  const [counterCount, setCounterCount] = React.useState(
-    counter !== void 0 ? counter.default ?? counter.min : 0
-  );
+  const [counterCount, setCounterCount] = React.useState(() => {
+    if (counter === void 0) return 0;
+    const raw = values[counter.id];
+    const n = typeof raw === "string" && raw !== "" ? Number(raw) : NaN;
+    return Number.isFinite(n) ? Math.min(counter.max, Math.max(counter.min, n)) : counter.default ?? counter.min;
+  });
   const defaultCounterCount = counter !== void 0 ? counter.default ?? counter.min : 0;
+  const prevCounterKey = React.useRef(null);
   React.useEffect(() => {
-    setCounterCount(defaultCounterCount);
-  }, [counter]);
+    const key2 = counter ? `${counter.id}:${defaultCounterCount}` : "";
+    const changed = prevCounterKey.current !== null && prevCounterKey.current !== key2;
+    prevCounterKey.current = key2;
+    if (changed) setCounterCount(defaultCounterCount);
+  }, [counter, defaultCounterCount]);
   const onChangeRef = React.useRef(onChange);
   onChangeRef.current = onChange;
+  const valuesRef = React.useRef(values);
+  valuesRef.current = values;
   React.useEffect(() => {
-    if (counter !== void 0) {
-      onChangeRef.current(counter.id, String(counterCount));
+    if (counter === void 0) return;
+    const next = String(counterCount);
+    if (valuesRef.current[counter.id] !== next) {
+      onChangeRef.current(counter.id, next);
     }
   }, [counterCount, counter?.id]);
   const cursorKeys = React.useMemo(
     () => (cursors ?? []).map((c) => `${c.id}:${c.value}`).join(","),
     [cursors]
   );
+  const prevCursorKeys = React.useRef(null);
   React.useEffect(() => {
+    const isDefinitionChange = prevCursorKeys.current !== null && prevCursorKeys.current !== cursorKeys;
+    prevCursorKeys.current = cursorKeys;
     for (const cursor of cursors ?? []) {
+      const existing = valuesRef.current[cursor.id];
+      if (!isDefinitionChange && existing !== void 0 && existing !== "") continue;
       onChangeRef.current(cursor.id, String(cursor.value));
     }
   }, [cursorKeys]);
@@ -18447,6 +18463,44 @@ function buildInitialValues(json) {
   }
   return initial;
 }
+function buildRevealedValues(json) {
+  const revealed = {};
+  const validation = json.validation;
+  if (!validation) return revealed;
+  const answers = validation.answers ?? {};
+  for (const [widgetId, expected] of Object.entries(answers)) {
+    const widget = json.widgets[widgetId];
+    if (widget?.type === JSON_TYPES.FRACTION && typeof expected === "string") {
+      const [num, den] = expected.split("/", 2);
+      if (widget.numerator === null && num !== void 0) revealed[getFractionKey(widgetId, "num")] = num;
+      if (widget.denominator === null && den !== void 0) revealed[getFractionKey(widgetId, "den")] = den;
+      continue;
+    }
+    revealed[widgetId] = typeof expected === "number" ? String(expected) : expected;
+  }
+  if ((validation.mode === VALIDATION_MODES.EXPRESSION || validation.mode === VALIDATION_MODES.MIXED) && validation.expression) {
+    const vars = validation.variables ?? [];
+    const freeVars = vars.filter((v) => !(v in answers));
+    if (freeVars.length > 0) {
+      const ranges = {};
+      for (const v of vars) {
+        if (v in answers) {
+          const pinned = Number(answers[v]);
+          if (Number.isFinite(pinned)) ranges[v] = { min: pinned, max: pinned, step: 1 };
+        } else {
+          ranges[v] = { min: 1, max: 100, step: 1 };
+        }
+      }
+      const combo = findValidCombination(validation.expression, ranges);
+      if (combo) {
+        for (const v of freeVars) {
+          if (combo[v] !== void 0) revealed[v] = String(combo[v]);
+        }
+      }
+    }
+  }
+  return revealed;
+}
 const ExerciseRenderer = React.forwardRef(({
   json,
   onSubmit,
@@ -18457,10 +18511,13 @@ const ExerciseRenderer = React.forwardRef(({
   sounds
 }, ref) => {
   const [values, setValues] = React.useState(() => buildInitialValues(json));
+  const valuesRef = React.useRef(values);
+  valuesRef.current = values;
   const [droppedSources, setDroppedSources] = React.useState(/* @__PURE__ */ new Map());
   const [focusedInputId, setFocusedInputId] = React.useState(null);
   const [validationDetails, setValidationDetails] = React.useState(null);
   const [resetKey, setResetKey] = React.useState(0);
+  const [revealed, setRevealed] = React.useState(false);
   const playSound = useSoundPlayer(soundEnabled, sounds);
   React.useImperativeHandle(ref, () => ({
     submit: () => {
@@ -18494,7 +18551,7 @@ const ExerciseRenderer = React.forwardRef(({
     getValues: () => values,
     getCompletion: () => {
       const answerable = getAnswerableInputs(json);
-      const missing = getMissingInputs(json, values);
+      const missing = getMissingInputs(json, valuesRef.current);
       const missingSet = new Set(missing);
       const filledIds = answerable.filter((id) => !missingSet.has(id));
       return {
@@ -18507,11 +18564,28 @@ const ExerciseRenderer = React.forwardRef(({
       };
     },
     reset: () => {
-      setValues(buildInitialValues(json));
+      const initial = buildInitialValues(json);
+      valuesRef.current = initial;
+      setValues(initial);
       setDroppedSources(/* @__PURE__ */ new Map());
       setFocusedInputId(null);
       setValidationDetails(null);
       setResetKey((k) => k + 1);
+      setRevealed(false);
+    },
+    revealAnswers: () => {
+      const revealedValues = buildRevealedValues(json);
+      const details = {};
+      for (const [widgetId, userValue] of Object.entries(revealedValues)) {
+        details[widgetId] = { widgetId, userValue, isCorrect: true };
+      }
+      const next = { ...valuesRef.current, ...revealedValues };
+      valuesRef.current = next;
+      setValues(next);
+      setDroppedSources(/* @__PURE__ */ new Map());
+      setValidationDetails(details);
+      setRevealed(true);
+      setResetKey((k) => k + 1);
     },
     focusFirstInput: () => {
       const container = document.querySelector(".math-exercise-renderer");
@@ -18522,17 +18596,20 @@ const ExerciseRenderer = React.forwardRef(({
     }
   }), [json, values, onSubmit, playSound]);
   const handleChange = (widgetId, value, fromDrop = false, sourceOptionId) => {
-    setValues((prev) => ({ ...prev, [widgetId]: value }));
+    setRevealed(false);
+    const next = { ...valuesRef.current, [widgetId]: value };
+    valuesRef.current = next;
+    setValues(next);
     setDroppedSources((prev) => {
-      const next = new Map(prev);
+      const next2 = new Map(prev);
       if (fromDrop && typeof value === "string" && value !== "" && sourceOptionId) {
-        next.set(widgetId, sourceOptionId);
+        next2.set(widgetId, sourceOptionId);
       } else {
-        next.delete(widgetId);
+        next2.delete(widgetId);
       }
-      return next;
+      return next2;
     });
-    onChange?.({ ...values, [widgetId]: value });
+    onChange?.(next);
   };
   const handleSubmit = () => {
     onSubmit?.(values);
@@ -18650,7 +18727,7 @@ const ExerciseRenderer = React.forwardRef(({
     if (setSquareWidget) add2("set-square-1", "set-square", Math.round(getSize(setSquareWidget) * 160));
     return { tools: list, toolsMinHeight: maxH };
   }, [rulerWidget, protractorWidget, setSquareWidget]);
-  return /* @__PURE__ */ jsxRuntime.jsx(SoundPlayerProvider, { play: playSound, children: /* @__PURE__ */ jsxRuntime.jsx(ExerciseDndProvider, { droppedSources, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `math-exercise-renderer ${className}`, children: [
+  return /* @__PURE__ */ jsxRuntime.jsx(SoundPlayerProvider, { play: playSound, children: /* @__PURE__ */ jsxRuntime.jsx(ExerciseDndProvider, { droppedSources, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: `math-exercise-renderer ${revealed ? "revealed" : ""} ${className}`, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {