@mathscan/math-exercise-engine 1.2.13 → 1.2.14

package/README.md

@@ -119,9 +119,10 @@ exerciseRef.current?.focusFirstInput();  // Focus first editable input field
 
 - **`submit()`**: Performs validation, returns `ValidationResult`, triggers `onSubmit`, and **locks the exercise** (see below). Calling it again while locked is a no-op that replays the same `ValidationResult` — no sound, no `onSubmit`
 - **`getValues()`**: Returns `Record<string, UserAnswerValue>` of all current input values
-- **`getCompletion()`**: Returns `{ total, filled, missing, filledIds, isComplete, isAnyFilled }` — use it to decide when to enable your submit button
-  - A typed input (or fraction slot) counts as filled once it has a value **and** the student finished it: the box is full (`digits` / `length`), the student moved to another input, or 1 s (`INPUT_FINISH_IDLE_MS`) passed without a keystroke. It never depends on the answer, so a wrong answer of any length can be submitted and the button can't hint at the answer's length. `isAnyFilled` only needs a value.
-  - When an input finishes without a value change (pause or moving on), `onChange` fires again with the same values so a host reading `getCompletion()` there sees the update.
+- **`getCompletion()`**: Returns `{ total, filled, missing, filledIds, isComplete, isAnyFilled, isAnswerLengthMatched, answerLengthMatchedIds }` — use it to decide when to enable your submit button
+  - `isAnswerLengthMatched` is true when every answerable text/number input and editable fraction slot has exactly as many characters as its stored expected answer. This checks length only: `456` matches the length of `123`. It uses the answer, not the box's `digits`/`length`, and updates immediately without affecting `isComplete`.
+  - `answerLengthMatchedIds` lists matching input IDs; fractions use slot IDs such as `f__num` and `f__den`. Disabled inputs and fixed fraction slots are excluded. Untouched defaults do not match. Other widget types retain their existing completion rules: combine `isComplete && isAnswerLengthMatched` when both are needed.
+  - The flag is false when there are no eligible fields or any eligible field has no stored scalar answer (for example, an expression-only variable). The schema currently supports one stored answer per input, not alternative answer lists. Length counts the stored/entered characters literally, including signs, decimal points, spaces, and leading zeros; it does not normalize the values.
 - **`revealAnswers()`**: Fills every widget with its correct answer and **locks the exercise**. No-op for display-only exercises
 - **`reset()`**: Clears all input fields and **unlocks** the exercise
 - **`focusFirstInput()`**: Focuses the first editable input of *this* renderer. Skips read-only/disabled fields, so it does nothing while the exercise is locked

package/dist/{GeometryWidget-h2yNZsas.mjs → GeometryWidget-B-EQ53jz.mjs}

@@ -2,7 +2,7 @@ import { jsx } from "react/jsx-runtime";
 import { useMemo, useEffect } from "react";
 import { StudentGeometryExercise } from "@mathscan/geometry-engine/react";
 import { serializeGeometryState } from "@mathscan/geometry-engine/validation";
-import { u as useExerciseLocked, r as readGeometryAttempt, l as logRejectedGeometryAttempt } from "./index-CAvdtiDQ.mjs";
+import { u as useExerciseLocked, r as readGeometryAttempt, l as logRejectedGeometryAttempt } from "./index-Daj5xH0X.mjs";
 const GeometryWidget = ({
   widgetId,
   widget,
@@ -47,4 +47,4 @@ const GeometryWidget = ({
 export {
   GeometryWidget
 };
-//# sourceMappingURL=GeometryWidget-h2yNZsas.mjs.map
+//# sourceMappingURL=GeometryWidget-B-EQ53jz.mjs.map

package/dist/{GeometryWidget-h2yNZsas.mjs.map → GeometryWidget-B-EQ53jz.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"GeometryWidget-h2yNZsas.mjs","sources":["../src/renderer/widgets/geometry/GeometryWidget.tsx"],"sourcesContent":["import React, { useEffect, useMemo } from 'react';\nimport { StudentGeometryExercise } from '@mathscan/geometry-engine/react';\nimport { serializeGeometryState } from '@mathscan/geometry-engine/validation';\nimport type { GeometryJSON } from '../../../transformers/zod-schemas';\nimport type { WidgetValidation } from '../../../validators';\nimport { logRejectedGeometryAttempt, readGeometryAttempt } from '../../../validators';\nimport { useExerciseLocked } from '../../lock';\n\nexport interface GeometryWidgetProps {\n  widgetId: string;\n  widget: GeometryJSON;\n  /** Serialized `GeometryState` — the value this package stores and validates. */\n  value?: string;\n  validationDetail?: WidgetValidation;\n  onChange: (widgetId: string, value: string) => void;\n}\n\n/**\n * Adapter between this package's widget contract and the geometry engine's\n * student component. It owns no geometry logic: the attempt is passed through as\n * data, the engine's verdict is passed back untouched, and the canvas itself\n * decides what to draw and when a result has gone stale.\n */\nexport const GeometryWidget: React.FC<GeometryWidgetProps> = ({\n  widgetId,\n  widget,\n  value,\n  validationDetail,\n  onChange,\n}) => {\n  const exerciseLocked = useExerciseLocked();\n  // Parsed per value change: the component is controlled, and handing it the\n  // same attempt as a fresh object on every render would look like a new value.\n  const { attempt, issues } = useMemo(() => readGeometryAttempt(value), [value]);\n\n  // A stored value the engine refuses is shown as an empty canvas, so the\n  // student's saved work silently vanishes unless this says so — once per value.\n  useEffect(() => {\n    if (issues) logRejectedGeometryAttempt(widgetId, issues);\n  }, [issues, widgetId]);\n\n  return (\n    <div className=\"geometry-widget\" data-widget-id={widgetId}>\n      <StudentGeometryExercise\n        showCompanion={false}\n        exercise={widget.json}\n        value={attempt}\n        readOnly={exerciseLocked}\n        validationFeedback={validationDetail?.geometryFeedback ?? null}\n        // Reset belongs to the exercise, which clears every widget at once.\n        controls={{\n          toolbar: false,\n          history: false,\n          delete: false,\n          reset: false,\n          instruments: false,\n        }}\n        onChange={(next) => onChange(widgetId, serializeGeometryState(next))}\n        // The engine renders its own error box for a rejected exercise or\n        // value; this is the only place the reasons surface for an author.\n        onError={(issues) => {\n          console.error(\n            `Geometry exercise rejected (widget \"${widgetId}\"):`,\n            issues.map(({ source, path, message }) => ({\n              source,\n              path: path.join('.'),\n              message,\n            }))\n          );\n        }}\n      />\n    </div>\n  );\n};\n"],"names":["issues"],"mappings":";;;;;AAuBO,MAAM,iBAAgD,CAAC;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,iBAAiB,kBAAA;AAGvB,QAAM,EAAE,SAAS,OAAA,IAAW,QAAQ,MAAM,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC;AAI7E,YAAU,MAAM;AACd,QAAI,OAAQ,4BAA2B,UAAU,MAAM;AAAA,EACzD,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,SACE,oBAAC,OAAA,EAAI,WAAU,mBAAkB,kBAAgB,UAC/C,UAAA;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,eAAe;AAAA,MACf,UAAU,OAAO;AAAA,MACjB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,oBAAoB,kBAAkB,oBAAoB;AAAA,MAE1D,UAAU;AAAA,QACR,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,aAAa;AAAA,MAAA;AAAA,MAEf,UAAU,CAAC,SAAS,SAAS,UAAU,uBAAuB,IAAI,CAAC;AAAA,MAGnE,SAAS,CAACA,YAAW;AACnB,gBAAQ;AAAA,UACN,uCAAuC,QAAQ;AAAA,UAC/CA,QAAO,IAAI,CAAC,EAAE,QAAQ,MAAM,eAAe;AAAA,YACzC;AAAA,YACA,MAAM,KAAK,KAAK,GAAG;AAAA,YACnB;AAAA,UAAA,EACA;AAAA,QAAA;AAAA,MAEN;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}
+{"version":3,"file":"GeometryWidget-B-EQ53jz.mjs","sources":["../src/renderer/widgets/geometry/GeometryWidget.tsx"],"sourcesContent":["import React, { useEffect, useMemo } from 'react';\nimport { StudentGeometryExercise } from '@mathscan/geometry-engine/react';\nimport { serializeGeometryState } from '@mathscan/geometry-engine/validation';\nimport type { GeometryJSON } from '../../../transformers/zod-schemas';\nimport type { WidgetValidation } from '../../../validators';\nimport { logRejectedGeometryAttempt, readGeometryAttempt } from '../../../validators';\nimport { useExerciseLocked } from '../../lock';\n\nexport interface GeometryWidgetProps {\n  widgetId: string;\n  widget: GeometryJSON;\n  /** Serialized `GeometryState` — the value this package stores and validates. */\n  value?: string;\n  validationDetail?: WidgetValidation;\n  onChange: (widgetId: string, value: string) => void;\n}\n\n/**\n * Adapter between this package's widget contract and the geometry engine's\n * student component. It owns no geometry logic: the attempt is passed through as\n * data, the engine's verdict is passed back untouched, and the canvas itself\n * decides what to draw and when a result has gone stale.\n */\nexport const GeometryWidget: React.FC<GeometryWidgetProps> = ({\n  widgetId,\n  widget,\n  value,\n  validationDetail,\n  onChange,\n}) => {\n  const exerciseLocked = useExerciseLocked();\n  // Parsed per value change: the component is controlled, and handing it the\n  // same attempt as a fresh object on every render would look like a new value.\n  const { attempt, issues } = useMemo(() => readGeometryAttempt(value), [value]);\n\n  // A stored value the engine refuses is shown as an empty canvas, so the\n  // student's saved work silently vanishes unless this says so — once per value.\n  useEffect(() => {\n    if (issues) logRejectedGeometryAttempt(widgetId, issues);\n  }, [issues, widgetId]);\n\n  return (\n    <div className=\"geometry-widget\" data-widget-id={widgetId}>\n      <StudentGeometryExercise\n        showCompanion={false}\n        exercise={widget.json}\n        value={attempt}\n        readOnly={exerciseLocked}\n        validationFeedback={validationDetail?.geometryFeedback ?? null}\n        // Reset belongs to the exercise, which clears every widget at once.\n        controls={{\n          toolbar: false,\n          history: false,\n          delete: false,\n          reset: false,\n          instruments: false,\n        }}\n        onChange={(next) => onChange(widgetId, serializeGeometryState(next))}\n        // The engine renders its own error box for a rejected exercise or\n        // value; this is the only place the reasons surface for an author.\n        onError={(issues) => {\n          console.error(\n            `Geometry exercise rejected (widget \"${widgetId}\"):`,\n            issues.map(({ source, path, message }) => ({\n              source,\n              path: path.join('.'),\n              message,\n            }))\n          );\n        }}\n      />\n    </div>\n  );\n};\n"],"names":["issues"],"mappings":";;;;;AAuBO,MAAM,iBAAgD,CAAC;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,iBAAiB,kBAAA;AAGvB,QAAM,EAAE,SAAS,OAAA,IAAW,QAAQ,MAAM,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC;AAI7E,YAAU,MAAM;AACd,QAAI,OAAQ,4BAA2B,UAAU,MAAM;AAAA,EACzD,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,SACE,oBAAC,OAAA,EAAI,WAAU,mBAAkB,kBAAgB,UAC/C,UAAA;AAAA,IAAC;AAAA,IAAA;AAAA,MACC,eAAe;AAAA,MACf,UAAU,OAAO;AAAA,MACjB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,oBAAoB,kBAAkB,oBAAoB;AAAA,MAE1D,UAAU;AAAA,QACR,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,aAAa;AAAA,MAAA;AAAA,MAEf,UAAU,CAAC,SAAS,SAAS,UAAU,uBAAuB,IAAI,CAAC;AAAA,MAGnE,SAAS,CAACA,YAAW;AACnB,gBAAQ;AAAA,UACN,uCAAuC,QAAQ;AAAA,UAC/CA,QAAO,IAAI,CAAC,EAAE,QAAQ,MAAM,eAAe;AAAA,YACzC;AAAA,YACA,MAAM,KAAK,KAAK,GAAG;AAAA,YACnB;AAAA,UAAA,EACA;AAAA,QAAA;AAAA,MAEN;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;"}

package/dist/{GeometryWidget-CMJTNSAG.js → GeometryWidget-D6_DlxhZ.js}

@@ -4,7 +4,7 @@ const jsxRuntime = require("react/jsx-runtime");
 const React = require("react");
 const react = require("@mathscan/geometry-engine/react");
 const validation = require("@mathscan/geometry-engine/validation");
-const index = require("./index-CbKXPRsS.js");
+const index = require("./index-gCvC2wRR.js");
 const GeometryWidget = ({
   widgetId,
   widget,
@@ -47,4 +47,4 @@ const GeometryWidget = ({
   ) });
 };
 exports.GeometryWidget = GeometryWidget;
-//# sourceMappingURL=GeometryWidget-CMJTNSAG.js.map
+//# sourceMappingURL=GeometryWidget-D6_DlxhZ.js.map

package/dist/{GeometryWidget-CMJTNSAG.js.map → GeometryWidget-D6_DlxhZ.js.map}

@@ -1 +1 @@
-{"version":3,"file":"GeometryWidget-CMJTNSAG.js","sources":["../src/renderer/widgets/geometry/GeometryWidget.tsx"],"sourcesContent":["import React, { useEffect, useMemo } from 'react';\nimport { StudentGeometryExercise } from '@mathscan/geometry-engine/react';\nimport { serializeGeometryState } from '@mathscan/geometry-engine/validation';\nimport type { GeometryJSON } from '../../../transformers/zod-schemas';\nimport type { WidgetValidation } from '../../../validators';\nimport { logRejectedGeometryAttempt, readGeometryAttempt } from '../../../validators';\nimport { useExerciseLocked } from '../../lock';\n\nexport interface GeometryWidgetProps {\n  widgetId: string;\n  widget: GeometryJSON;\n  /** Serialized `GeometryState` — the value this package stores and validates. */\n  value?: string;\n  validationDetail?: WidgetValidation;\n  onChange: (widgetId: string, value: string) => void;\n}\n\n/**\n * Adapter between this package's widget contract and the geometry engine's\n * student component. It owns no geometry logic: the attempt is passed through as\n * data, the engine's verdict is passed back untouched, and the canvas itself\n * decides what to draw and when a result has gone stale.\n */\nexport const GeometryWidget: React.FC<GeometryWidgetProps> = ({\n  widgetId,\n  widget,\n  value,\n  validationDetail,\n  onChange,\n}) => {\n  const exerciseLocked = useExerciseLocked();\n  // Parsed per value change: the component is controlled, and handing it the\n  // same attempt as a fresh object on every render would look like a new value.\n  const { attempt, issues } = useMemo(() => readGeometryAttempt(value), [value]);\n\n  // A stored value the engine refuses is shown as an empty canvas, so the\n  // student's saved work silently vanishes unless this says so — once per value.\n  useEffect(() => {\n    if (issues) logRejectedGeometryAttempt(widgetId, issues);\n  }, [issues, widgetId]);\n\n  return (\n    <div className=\"geometry-widget\" data-widget-id={widgetId}>\n      <StudentGeometryExercise\n        showCompanion={false}\n        exercise={widget.json}\n        value={attempt}\n        readOnly={exerciseLocked}\n        validationFeedback={validationDetail?.geometryFeedback ?? null}\n        // Reset belongs to the exercise, which clears every widget at once.\n        controls={{\n          toolbar: false,\n          history: false,\n          delete: false,\n          reset: false,\n          instruments: false,\n        }}\n        onChange={(next) => onChange(widgetId, serializeGeometryState(next))}\n        // The engine renders its own error box for a rejected exercise or\n        // value; this is the only place the reasons surface for an author.\n        onError={(issues) => {\n          console.error(\n            `Geometry exercise rejected (widget \"${widgetId}\"):`,\n            issues.map(({ source, path, message }) => ({\n              source,\n              path: path.join('.'),\n              message,\n            }))\n          );\n        }}\n      />\n    </div>\n  );\n};\n"],"names":["useExerciseLocked","useMemo","readGeometryAttempt","useEffect","logRejectedGeometryAttempt","jsx","StudentGeometryExercise","serializeGeometryState","issues"],"mappings":";;;;;;;AAuBO,MAAM,iBAAgD,CAAC;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,iBAAiBA,MAAAA,kBAAA;AAGvB,QAAM,EAAE,SAAS,OAAA,IAAWC,MAAAA,QAAQ,MAAMC,MAAAA,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC;AAI7EC,QAAAA,UAAU,MAAM;AACd,QAAI,OAAQC,OAAAA,2BAA2B,UAAU,MAAM;AAAA,EACzD,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,SACEC,2BAAAA,IAAC,OAAA,EAAI,WAAU,mBAAkB,kBAAgB,UAC/C,UAAAA,2BAAAA;AAAAA,IAACC,MAAAA;AAAAA,IAAA;AAAA,MACC,eAAe;AAAA,MACf,UAAU,OAAO;AAAA,MACjB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,oBAAoB,kBAAkB,oBAAoB;AAAA,MAE1D,UAAU;AAAA,QACR,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,aAAa;AAAA,MAAA;AAAA,MAEf,UAAU,CAAC,SAAS,SAAS,UAAUC,WAAAA,uBAAuB,IAAI,CAAC;AAAA,MAGnE,SAAS,CAACC,YAAW;AACnB,gBAAQ;AAAA,UACN,uCAAuC,QAAQ;AAAA,UAC/CA,QAAO,IAAI,CAAC,EAAE,QAAQ,MAAM,eAAe;AAAA,YACzC;AAAA,YACA,MAAM,KAAK,KAAK,GAAG;AAAA,YACnB;AAAA,UAAA,EACA;AAAA,QAAA;AAAA,MAEN;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;;"}
+{"version":3,"file":"GeometryWidget-D6_DlxhZ.js","sources":["../src/renderer/widgets/geometry/GeometryWidget.tsx"],"sourcesContent":["import React, { useEffect, useMemo } from 'react';\nimport { StudentGeometryExercise } from '@mathscan/geometry-engine/react';\nimport { serializeGeometryState } from '@mathscan/geometry-engine/validation';\nimport type { GeometryJSON } from '../../../transformers/zod-schemas';\nimport type { WidgetValidation } from '../../../validators';\nimport { logRejectedGeometryAttempt, readGeometryAttempt } from '../../../validators';\nimport { useExerciseLocked } from '../../lock';\n\nexport interface GeometryWidgetProps {\n  widgetId: string;\n  widget: GeometryJSON;\n  /** Serialized `GeometryState` — the value this package stores and validates. */\n  value?: string;\n  validationDetail?: WidgetValidation;\n  onChange: (widgetId: string, value: string) => void;\n}\n\n/**\n * Adapter between this package's widget contract and the geometry engine's\n * student component. It owns no geometry logic: the attempt is passed through as\n * data, the engine's verdict is passed back untouched, and the canvas itself\n * decides what to draw and when a result has gone stale.\n */\nexport const GeometryWidget: React.FC<GeometryWidgetProps> = ({\n  widgetId,\n  widget,\n  value,\n  validationDetail,\n  onChange,\n}) => {\n  const exerciseLocked = useExerciseLocked();\n  // Parsed per value change: the component is controlled, and handing it the\n  // same attempt as a fresh object on every render would look like a new value.\n  const { attempt, issues } = useMemo(() => readGeometryAttempt(value), [value]);\n\n  // A stored value the engine refuses is shown as an empty canvas, so the\n  // student's saved work silently vanishes unless this says so — once per value.\n  useEffect(() => {\n    if (issues) logRejectedGeometryAttempt(widgetId, issues);\n  }, [issues, widgetId]);\n\n  return (\n    <div className=\"geometry-widget\" data-widget-id={widgetId}>\n      <StudentGeometryExercise\n        showCompanion={false}\n        exercise={widget.json}\n        value={attempt}\n        readOnly={exerciseLocked}\n        validationFeedback={validationDetail?.geometryFeedback ?? null}\n        // Reset belongs to the exercise, which clears every widget at once.\n        controls={{\n          toolbar: false,\n          history: false,\n          delete: false,\n          reset: false,\n          instruments: false,\n        }}\n        onChange={(next) => onChange(widgetId, serializeGeometryState(next))}\n        // The engine renders its own error box for a rejected exercise or\n        // value; this is the only place the reasons surface for an author.\n        onError={(issues) => {\n          console.error(\n            `Geometry exercise rejected (widget \"${widgetId}\"):`,\n            issues.map(({ source, path, message }) => ({\n              source,\n              path: path.join('.'),\n              message,\n            }))\n          );\n        }}\n      />\n    </div>\n  );\n};\n"],"names":["useExerciseLocked","useMemo","readGeometryAttempt","useEffect","logRejectedGeometryAttempt","jsx","StudentGeometryExercise","serializeGeometryState","issues"],"mappings":";;;;;;;AAuBO,MAAM,iBAAgD,CAAC;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAM;AACJ,QAAM,iBAAiBA,MAAAA,kBAAA;AAGvB,QAAM,EAAE,SAAS,OAAA,IAAWC,MAAAA,QAAQ,MAAMC,MAAAA,oBAAoB,KAAK,GAAG,CAAC,KAAK,CAAC;AAI7EC,QAAAA,UAAU,MAAM;AACd,QAAI,OAAQC,OAAAA,2BAA2B,UAAU,MAAM;AAAA,EACzD,GAAG,CAAC,QAAQ,QAAQ,CAAC;AAErB,SACEC,2BAAAA,IAAC,OAAA,EAAI,WAAU,mBAAkB,kBAAgB,UAC/C,UAAAA,2BAAAA;AAAAA,IAACC,MAAAA;AAAAA,IAAA;AAAA,MACC,eAAe;AAAA,MACf,UAAU,OAAO;AAAA,MACjB,OAAO;AAAA,MACP,UAAU;AAAA,MACV,oBAAoB,kBAAkB,oBAAoB;AAAA,MAE1D,UAAU;AAAA,QACR,SAAS;AAAA,QACT,SAAS;AAAA,QACT,QAAQ;AAAA,QACR,OAAO;AAAA,QACP,aAAa;AAAA,MAAA;AAAA,MAEf,UAAU,CAAC,SAAS,SAAS,UAAUC,WAAAA,uBAAuB,IAAI,CAAC;AAAA,MAGnE,SAAS,CAACC,YAAW;AACnB,gBAAQ;AAAA,UACN,uCAAuC,QAAQ;AAAA,UAC/CA,QAAO,IAAI,CAAC,EAAE,QAAQ,MAAM,eAAe;AAAA,YACzC;AAAA,YACA,MAAM,KAAK,KAAK,GAAG;AAAA,YACnB;AAAA,UAAA,EACA;AAAA,QAAA;AAAA,MAEN;AAAA,IAAA;AAAA,EAAA,GAEJ;AAEJ;;"}