@mathscan/math-exercise-engine 1.0.16 → 1.0.17

package/dist/index.mjs

@@ -158,6 +158,7 @@ const SIDE_PAD = 7;
 const CSS_VAR_SIDE_PAD = "--nl-side-pad";
 const NUMBER_LINE_LABELS = ["all", "extremes", "min-only", "max-only", "none"];
 const NUMBER_LINE_HIGHLIGHT_COLORS = ["blue", "red", "green", "orange", "purple", "yellow"];
+const NUMBER_LINE_DRAG_MODES = ["axis", "inputs"];
 function getFractionKey(widgetId, part) {
   return `${widgetId}__${part}`;
 }
@@ -1154,7 +1155,8 @@ const FractionInlineSchema = z.object({
   numerator: z.number().optional(),
   denominator: z.number().optional(),
   answer: z.string().optional(),
-  simplified: z.boolean().default(true)
+  simplified: z.boolean().default(true),
+  placeholder: z.string().max(32).optional()
 });
 const IMAGE_SRC_SCHEME_RE$1 = /^(https?:\/\/|data:image\/)/i;
 const ImageInlineSchema = z.object({
@@ -1436,6 +1438,11 @@ const NumberLineBlockSchema = z.object({
   }).optional(),
   counter: NumberLineCounterSchema.optional(),
   highlights: z.array(NumberLineHighlightSchema).optional(),
+  dragMode: z.enum(NUMBER_LINE_DRAG_MODES, {
+    errorMap: () => ({
+      message: `NUMBER_LINE: dragMode must be one of ${NUMBER_LINE_DRAG_MODES.join(", ")}`
+    })
+  }).optional(),
   positions: z.array(NumberLinePositionSchema)
 }).refine((data) => data.min < data.max, {
   message: "NUMBER_LINE: min must be less than max"
@@ -1473,7 +1480,7 @@ const NumberLineBlockSchema = z.object({
     }
   }
 });
-function createNumberLineBlock(min, max, positions, step, minorTicks, style, labelVisibility, counter, highlights) {
+function createNumberLineBlock(min, max, positions, step, minorTicks, style, labelVisibility, counter, highlights, dragMode) {
   return NumberLineBlockSchema.parse({
     type: AST_TYPES.NUMBER_LINE_BLOCK,
     min,
@@ -1484,6 +1491,7 @@ function createNumberLineBlock(min, max, positions, step, minorTicks, style, lab
     labelVisibility,
     counter,
     highlights,
+    dragMode,
     positions
   });
 }
@@ -1848,6 +1856,7 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     const minorTicks = params.minorTicks !== void 0 ? Number(params.minorTicks) : void 0;
     const style = params.style;
     const labelVisibility = params.labelVisibility;
+    const dragMode = params.dragMode;
     const positions = ctx.position ? ctx.position.map((p) => this.visit(p)) : [];
     const rawCounters = ctx.counter;
     if (rawCounters && rawCounters.length > 1) {
@@ -1855,7 +1864,7 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     }
     const counter = rawCounters ? this.visit(rawCounters) : void 0;
     const highlights = ctx.highlight ? ctx.highlight.map((h) => this.visit(h)) : [];
-    return createNumberLineBlock(min, max, positions, step, minorTicks, style, labelVisibility, counter, highlights);
+    return createNumberLineBlock(min, max, positions, step, minorTicks, style, labelVisibility, counter, highlights, dragMode);
   }
   position(ctx) {
     const params = this.visit(ctx.parameterList);
@@ -2048,7 +2057,8 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     const denominator = params.denominator;
     const answer = params.answer;
     const simplified = params.simplified !== void 0 ? params.simplified : void 0;
-    return createFraction(name, { numerator, denominator, answer, simplified });
+    const placeholder = params.placeholder;
+    return createFraction(name, { numerator, denominator, answer, simplified, placeholder });
   }
   image(ctx) {
     const params = this.visit(ctx.parameterList);
@@ -2332,6 +2342,7 @@ const NumberLineItemSchema = z.object({
   labelVisibility: z.enum(NUMBER_LINE_LABELS).optional(),
   counter: NumberLineCounterItemSchema.optional(),
   highlights: z.array(NumberLineHighlightItemSchema).optional(),
+  dragMode: z.enum(NUMBER_LINE_DRAG_MODES).optional(),
   positions: z.array(NumberLinePositionItemSchema)
 });
 const MatcherItemContentSchema = z.object({
@@ -2381,7 +2392,8 @@ const FractionJSONSchema = z.object({
   type: z.literal(JSON_TYPES.FRACTION),
   numerator: z.number().nullable(),
   denominator: z.number().nullable(),
-  simplified: z.boolean()
+  simplified: z.boolean(),
+  placeholder: z.string().max(32).optional()
 });
 const MatcherWidgetJSONSchema = z.object({
   type: z.literal(JSON_TYPES.MATCHER),
@@ -2599,7 +2611,8 @@ function toJSON(ast) {
         type: JSON_TYPES.FRACTION,
         numerator: inline.numerator ?? null,
         denominator: inline.denominator ?? null,
-        simplified: inline.simplified ?? true
+        simplified: inline.simplified ?? true,
+        placeholder: inline.placeholder
       };
       if (inline.answer !== void 0) {
         answers[inline.name] = inline.answer;
@@ -2730,6 +2743,7 @@ function transformNumberLine(numberLine, idGenerator) {
     ...numberLine.labelVisibility !== void 0 && { labelVisibility: numberLine.labelVisibility },
     ...counterItem !== void 0 && { counter: counterItem },
     ...highlights !== void 0 && { highlights },
+    ...numberLine.dragMode !== void 0 && { dragMode: numberLine.dragMode },
     positions
   };
   return item;
@@ -13090,8 +13104,11 @@ const FractionInput = ({
   values,
   droppedInputs,
   validationStatus = null,
+  numValidationStatus = null,
+  denValidationStatus = null,
   onChange,
-  onFocus
+  onFocus,
+  placeholder
 }) => {
   const numKey = getFractionKey(widgetId, "num");
   const denKey = getFractionKey(widgetId, "den");
@@ -13104,11 +13121,12 @@ const FractionInput = ({
       onChange(subKey, data.value, true, String(item.id));
     }
   }, [onChange]);
-  const renderSlot = (subKey, fixedValue, currentValue, label) => {
+  const renderSlot = (subKey, fixedValue, currentValue, label, slotStatus) => {
     if (fixedValue !== null) {
       return /* @__PURE__ */ jsx("span", { className: "fraction-fixed", children: fixedValue });
     }
     const isDroppedHere = droppedInputs.has(subKey);
+    const slotClass = slotStatus ? ` widget--${slotStatus}` : statusClass;
     return /* @__PURE__ */ jsx(
       Droppable,
       {
@@ -13119,7 +13137,7 @@ const FractionInput = ({
         children: isDroppedHere && currentValue !== "" ? /* @__PURE__ */ jsx(
           "button",
           {
-            className: `inline-input-chip fraction-chip${statusClass}`,
+            className: `inline-input-chip fraction-chip${slotClass}`,
             onClick: () => onChange(subKey, "", false),
             title: "Click to remove",
             children: currentValue
@@ -13129,21 +13147,23 @@ const FractionInput = ({
           {
             id: `${subKey}-input`,
             type: "text",
-            className: `inline-input fraction-input${statusClass}`,
+            className: `inline-input fraction-input${slotClass}`,
             value: currentValue,
             onChange: (e) => onChange(subKey, e.target.value, false),
             onFocus: () => onFocus?.(subKey),
-            maxLength: 4,
-            "aria-label": label
+            maxLength: placeholder ? Math.max(20, placeholder.length) : 4,
+            size: placeholder ? placeholder.length : void 0,
+            "aria-label": label,
+            placeholder
           }
         )
       }
     );
   };
   return /* @__PURE__ */ jsxs("span", { className: "fraction", role: "math", "aria-label": `fraction ${widgetId}`, children: [
-    /* @__PURE__ */ jsx("span", { className: "fraction-numerator", children: renderSlot(numKey, numerator, numValue, "numerator") }),
+    /* @__PURE__ */ jsx("span", { className: "fraction-numerator", children: renderSlot(numKey, numerator, numValue, "numerator", numValidationStatus) }),
     /* @__PURE__ */ jsx("span", { className: "fraction-bar", "aria-hidden": "true" }),
-    /* @__PURE__ */ jsx("span", { className: "fraction-denominator", children: renderSlot(denKey, denominator, denValue, "denominator") })
+    /* @__PURE__ */ jsx("span", { className: "fraction-denominator", children: renderSlot(denKey, denominator, denValue, "denominator", denValidationStatus) })
   ] });
 };
 function isLightColor(hex) {
@@ -13415,7 +13435,9 @@ const GridShape = ({
     className: "visual-fraction-widget__parts visual-fraction-widget__parts--horizontal",
     style: {
       "--visual-fraction-divisions": divisions,
-      "--visual-fraction-grid-cols": getGridColumnCount(divisions)
+      "--visual-fraction-grid-cols": getGridColumnCount(divisions),
+      // Safe integer division: zod schema enforces divisions = perfect square.
+      "--visual-fraction-grid-rows": divisions / getGridColumnCount(divisions)
     },
     children: parts.map((part) => /* @__PURE__ */ jsx(
       "div",
@@ -13565,7 +13587,7 @@ const VisualFraction = ({
     [divisions, filledCount, filledPartGroups, partAssignments, answer, filledPalette, answerPalette]
   );
   const statusClass = validationStatus ? ` visual-fraction-widget--${validationStatus} widget--${validationStatus}` : "";
-  const rootStyle = useMemo(() => getSizeStyle(widget.size, shape), [widget.size, shape]);
+  const rootStyle = useMemo(() => getSizeStyle(widget.size), [widget.size, shape]);
   const ShapeComponent = SHAPE_COMPONENTS[shape];
   return /* @__PURE__ */ jsxs(
     "div",
@@ -13590,15 +13612,10 @@ const VisualFraction = ({
   );
 };
 VisualFraction.displayName = "VisualFraction";
-function getSizeStyle(size, shape) {
+function getSizeStyle(size, _shape) {
   if (size === void 0) return void 0;
-  if (shape === "circle" || shape === "triangle") {
-    return {
-      "--visual-fraction-size": `${size * VISUAL_FRACTION_SVG_SIZE_SCALE}rem`
-    };
-  }
   return {
-    "--visual-fraction-part-size": `${size}rem`
+    "--visual-fraction-size": `${size * VISUAL_FRACTION_SVG_SIZE_SCALE}rem`
   };
 }
 const RadioOptions = ({
@@ -13800,6 +13817,8 @@ const WidgetRenderer = ({
   values = {},
   isDropped = false,
   validationStatus = null,
+  numValidationStatus = null,
+  denValidationStatus = null,
   droppedInputs = /* @__PURE__ */ new Set(),
   widgets,
   onChange,
@@ -13878,8 +13897,11 @@ const WidgetRenderer = ({
         values,
         droppedInputs,
         validationStatus,
+        numValidationStatus,
+        denValidationStatus,
         onChange,
-        onFocus: onInputFocus
+        onFocus: onInputFocus,
+        placeholder: widget.placeholder
       }
     );
   }
@@ -13929,7 +13951,7 @@ const getMajorTicks = (min, max, step) => {
   const count = Math.floor((max - min) / step);
   const ticks = Array.from({ length: count + 1 }, (_, i) => cleanFloat(min + i * step));
   const lastTick = ticks[ticks.length - 1];
-  if (!almostEqual(lastTick, max)) {
+  if (roundTick(lastTick) !== roundTick(max)) {
     ticks.push(max);
   } else {
     ticks[ticks.length - 1] = max;
@@ -14540,7 +14562,7 @@ const NumberLineRenderer = ({
     return step;
   }, [counter, counterCount, min, max, step]);
   const majorTicks = useMemo(
-    () => getMajorTicks(min, max, effectiveStep).map(roundTick),
+    () => [...new Set(getMajorTicks(min, max, effectiveStep).map(roundTick))],
     [min, max, effectiveStep]
   );
   const minorValues = useMemo(
@@ -14549,16 +14571,17 @@ const NumberLineRenderer = ({
   );
   const showArrowRight = lineStyle === "arrow-right" || lineStyle === "arrow-both";
   const showArrowLeft = lineStyle === "arrow-left" || lineStyle === "arrow-both";
-  const isDragMode = Boolean(widgets[DRAG_OPTIONS_WIDGET_ID]);
+  const hasDragOptions = Boolean(widgets[DRAG_OPTIONS_WIDGET_ID]);
+  const isAxisDragMode = hasDragOptions && item.dragMode === "axis";
   const inputTickSet = useMemo(() => {
-    if (isDragMode) return /* @__PURE__ */ new Set();
+    if (isAxisDragMode) return /* @__PURE__ */ new Set();
     return new Set(
       positions.filter((pos) => getPositionWidgetId(pos.content) !== null).map((pos) => roundTick(pos.value))
     );
-  }, [isDragMode, positions]);
+  }, [isAxisDragMode, positions]);
   const visiblePositions = useMemo(
-    () => positions.filter((pos) => !isDragMode || getPositionWidgetId(pos.content) === null),
-    [isDragMode, positions]
+    () => positions.filter((pos) => !isAxisDragMode || getPositionWidgetId(pos.content) === null),
+    [isAxisDragMode, positions]
   );
   const visiblePositionIds = useMemo(
     () => visiblePositions.map((pos) => pos.id),
@@ -14568,7 +14591,7 @@ const NumberLineRenderer = ({
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      className: `number-line${isDragMode ? " number-line--drag-mode" : ""}${lineStyle === "line" ? " number-line--style-line" : ""}`,
+      className: `number-line${isAxisDragMode ? " number-line--drag-mode" : ""}${lineStyle === "line" ? " number-line--style-line" : ""}`,
       style: {
         [CSS_VAR_SIDE_PAD]: `${SIDE_PAD}%`,
         ...positionContentHeight && { "--nl-position-content-height": positionContentHeight }
@@ -14598,7 +14621,7 @@ const NumberLineRenderer = ({
           },
           pos.id
         )) }),
-        isDragMode ? /* @__PURE__ */ jsx(
+        isAxisDragMode ? /* @__PURE__ */ jsx(
           FreeDragAxis,
           {
             axisDropId: `${item.id}--nl-axis`,
@@ -14709,6 +14732,7 @@ function groupLineItems(items) {
   }
   return groups;
 }
+const toValidationStatus = (v) => v === true ? "correct" : v === false ? "incorrect" : null;
 const LayoutRenderer = ({
   item,
   widgets,
@@ -14724,8 +14748,10 @@ const LayoutRenderer = ({
       const hasArabic = isArabic(item.value);
       return /* @__PURE__ */ jsx("span", { className: `question-text ${hasArabic ? "question-text-arabic" : ""}`, children: item.value });
     }
-    case JSON_TYPES.TEXT:
-      return /* @__PURE__ */ jsx("span", { className: `text-item ${isArabic(item.value) ? "text-item-arabic" : "text-item-not-arabic"}`, children: item.value });
+    case JSON_TYPES.TEXT: {
+      const isNum = /^[\d.,\s]+$/.test(item.value);
+      return /* @__PURE__ */ jsx("span", { className: `text-item ${isNum ? "text-item-number" : ""} ${isArabic(item.value) ? "text-item-arabic" : "text-item-not-arabic"}`, children: item.value });
+    }
     case JSON_TYPES.HIGHLIGHTED_TEXT: {
       const hasArabic = isArabic(item.value);
       const dirAttr = !hasArabic ? "ltr" : void 0;
@@ -14792,6 +14818,8 @@ const LayoutRenderer = ({
           values,
           isDropped: droppedInputs.has(item.widgetId),
           validationStatus,
+          numValidationStatus: toValidationStatus(validationDetails?.[`${item.widgetId}__num`]),
+          denValidationStatus: toValidationStatus(validationDetails?.[`${item.widgetId}__den`]),
           droppedInputs,
           widgets,
           onChange,
@@ -14897,6 +14925,27 @@ const ExerciseRenderer = forwardRef(({
       for (const [id, v] of Object.entries(result.details)) {
         details[id] = v.isCorrect;
       }
+      for (const [widgetId, widget] of Object.entries(json.widgets)) {
+        if (widget.type !== JSON_TYPES.FRACTION) continue;
+        if (!(widgetId in details)) continue;
+        const answer = json.validation?.answers?.[widgetId];
+        if (!answer) continue;
+        const [expectedNum, expectedDen] = answer.split("/", 2);
+        if (!expectedNum || !expectedDen) continue;
+        if (details[widgetId]) {
+          if (widget.numerator === null) details[`${widgetId}__num`] = true;
+          if (widget.denominator === null) details[`${widgetId}__den`] = true;
+        } else {
+          if (widget.numerator === null) {
+            const u = values[`${widgetId}__num`];
+            details[`${widgetId}__num`] = typeof u === "string" && u !== "" && normalize(u) === normalize(expectedNum);
+          }
+          if (widget.denominator === null) {
+            const u = values[`${widgetId}__den`];
+            details[`${widgetId}__den`] = typeof u === "string" && u !== "" && normalize(u) === normalize(expectedDen);
+          }
+        }
+      }
       setValidationDetails(details);
       onSubmit?.(values);
       return result;