@mathscan/math-exercise-engine 1.2.4 → 1.2.5

package/dist/index.d.ts

@@ -30416,6 +30416,8 @@ export declare interface ExerciseRendererProps {
     soundEnabled?: boolean;
     /** Maps sound events → URL or callback. Omitted events stay silent. */
     sounds?: SoundConfig;
+    /** Overrides for validation state colors. */
+    theme?: ExerciseTheme;
 }
 
 export declare interface ExerciseRendererRef {
@@ -30429,6 +30431,22 @@ export declare interface ExerciseRendererRef {
     revealAnswers: () => void;
 }
 
+/**
+ * Validation state colors, applied as inline CSS variables on the renderer root.
+ * Inline beats any stylesheet, so this is the reliable way for a host to recolor
+ * per attempt (e.g. orange on the 1st wrong answer, red on the 2nd) — a
+ * `--exercise-incorrect` set on a wrapper is shadowed by variables.css.
+ * Background tints derive from these via color-mix. Omitted keys keep the defaults.
+ * Values must be valid CSS colors: an invalid one does NOT fall back to the
+ * default, it leaves the affected styles uncolored (dev builds log a warning).
+ * Change the color when a retry starts, not in onSubmit — otherwise the result
+ * still on screen recolors immediately.
+ */
+export declare interface ExerciseTheme {
+    correct?: string;
+    incorrect?: string;
+}
+
 export declare type ExpressionValidation = z.infer<typeof ExpressionValidationSchema>;
 
 /**

package/dist/index.js

@@ -11918,7 +11918,7 @@ function getEventCoordinates(event) {
   }
   return null;
 }
-const CSS = /* @__PURE__ */ Object.freeze({
+const CSS$1 = /* @__PURE__ */ Object.freeze({
   Translate: {
     toString(transform) {
       if (!transform) {
@@ -11948,7 +11948,7 @@ const CSS = /* @__PURE__ */ Object.freeze({
       if (!transform) {
         return;
       }
-      return [CSS.Translate.toString(transform), CSS.Scale.toString(transform)].join(" ");
+      return [CSS$1.Translate.toString(transform), CSS$1.Scale.toString(transform)].join(" ");
     }
   },
   Transition: {
@@ -15067,7 +15067,7 @@ const PositionedOverlay = /* @__PURE__ */ React.forwardRef((_ref, ref) => {
     height: rect.height,
     top: rect.top,
     left: rect.left,
-    transform: CSS.Transform.toString(scaleAdjustedTransform),
+    transform: CSS$1.Transform.toString(scaleAdjustedTransform),
     transformOrigin: adjustScale2 && activatorEvent ? getRelativeTransformOrigin(activatorEvent, rect) : void 0,
     transition: typeof transition === "function" ? transition(activatorEvent) : transition,
     ...style
@@ -15128,9 +15128,9 @@ const defaultKeyframeResolver = (_ref2) => {
     }
   } = _ref2;
   return [{
-    transform: CSS.Transform.toString(initial)
+    transform: CSS$1.Transform.toString(initial)
   }, {
-    transform: CSS.Transform.toString(final)
+    transform: CSS$1.Transform.toString(final)
   }];
 };
 const defaultDropAnimationConfiguration = {
@@ -15563,7 +15563,7 @@ const Draggable = ({
     disabled
   });
   const style = {
-    transform: CSS.Translate.toString(transform),
+    transform: CSS$1.Translate.toString(transform),
     cursor: disabled ? "default" : "grab",
     touchAction: "none"
   };
@@ -17923,7 +17923,7 @@ const CHART_TYPE_COMPONENTS = {
 const Chart = (props) => {
   const ChartComponent = CHART_TYPE_COMPONENTS[props.item.chartType];
   if (!ChartComponent) {
-    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "chart chart--unsupported", children: /* @__PURE__ */ jsxRuntime.jsx("span", { style: { color: "var(--exercise-incorrect, #ef4444)", fontSize: "0.85rem" }, children: `Chart type "${props.item.chartType}" is not yet supported.` }) });
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className: "chart chart--unsupported", children: /* @__PURE__ */ jsxRuntime.jsx("span", { style: { color: "var(--exercise-error, #ef4444)", fontSize: "0.85rem" }, children: `Chart type "${props.item.chartType}" is not yet supported.` }) });
   }
   return /* @__PURE__ */ jsxRuntime.jsx(ChartComponent, { ...props });
 };
@@ -20843,6 +20843,15 @@ const TOOL_ASPECT_RATIO = {
   "set-square": SET_SQUARE_ASPECT_RATIO
 };
 const FLIP_BTN_EXTRA = 44;
+function warnOnInvalidThemeColors(theme) {
+  if (process.env.NODE_ENV === "production" || !theme) return;
+  if (typeof CSS === "undefined" || typeof CSS.supports !== "function") return;
+  for (const [key2, value] of Object.entries(theme)) {
+    if (value && !CSS.supports("color", value)) {
+      console.warn(`[ExerciseRenderer] theme.${key2} is not a valid CSS color: "${value}"`);
+    }
+  }
+}
 function buildInitialValues(json) {
   const initial = {};
   for (const [id, widget] of Object.entries(json.widgets)) {
@@ -20915,7 +20924,8 @@ const ExerciseRenderer = React.forwardRef(({
   showSubmitButton = false,
   className = "",
   soundEnabled = true,
-  sounds
+  sounds,
+  theme
 }, ref) => {
   const initialValuesSignature = React.useMemo(() => buildInitialValuesSignature(json), [json]);
   const [values, setValues] = React.useState(() => buildInitialValues(json));
@@ -20929,6 +20939,15 @@ const ExerciseRenderer = React.forwardRef(({
   const rootRef = React.useRef(null);
   const [resetKey, setResetKey] = React.useState(0);
   const [revealed, setRevealed] = React.useState(false);
+  const themeStyle = React.useMemo(() => {
+    const style = {};
+    if (theme?.correct) style["--exercise-correct"] = theme.correct;
+    if (theme?.incorrect) style["--exercise-incorrect"] = theme.incorrect;
+    return Object.keys(style).length > 0 ? style : void 0;
+  }, [theme?.correct, theme?.incorrect]);
+  React.useEffect(() => {
+    warnOnInvalidThemeColors({ correct: theme?.correct, incorrect: theme?.incorrect });
+  }, [theme?.correct, theme?.incorrect]);
   const playSound = useSoundPlayer(soundEnabled, sounds);
   const externallyLocked = useExerciseLocked();
   React.useLayoutEffect(() => {
@@ -21185,7 +21204,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(ExerciseLockProvider, { locked, children: /* @__PURE__ */ jsxRuntime.jsx(ExerciseDndProvider, { droppedSources, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { ref: rootRef, className: `math-exercise-renderer ${revealed ? "revealed" : ""} ${locked ? "locked" : ""} ${className}`, children: [
+  return /* @__PURE__ */ jsxRuntime.jsx(SoundPlayerProvider, { play: playSound, children: /* @__PURE__ */ jsxRuntime.jsx(ExerciseLockProvider, { locked, children: /* @__PURE__ */ jsxRuntime.jsx(ExerciseDndProvider, { droppedSources, children: /* @__PURE__ */ jsxRuntime.jsxs("div", { ref: rootRef, className: `math-exercise-renderer ${revealed ? "revealed" : ""} ${locked ? "locked" : ""} ${className}`, style: themeStyle, children: [
     /* @__PURE__ */ jsxRuntime.jsxs(
       "div",
       {