@mathscan/math-exercise-engine 1.2.10 → 1.2.11

package/README.md

@@ -124,6 +124,8 @@ exerciseRef.current?.focusFirstInput();  // Focus first editable input field
 - **`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
 
+**Auto-advance:** when a typed input's box is full (`digits` / `length` characters), the caret moves to the next editable input of the exercise, in on-screen order. It never depends on the answer, so it can't hint at the answer's length. It moves only on the keystroke that fills the box, so replacing a full value doesn't move it again. It doesn't move on a dropped value, from a fraction slot (no box length), or on the last input.
+
 ## 🔒 Locking After a Check
 
 Once the answer is checked, the exercise becomes read-only until it is reset. This is the default and cannot be turned off.

package/dist/{GeometryWidget-gtAP_-_S.mjs → GeometryWidget-2TCLbTEv.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-DBteHZkS.mjs";
+import { u as useExerciseLocked, r as readGeometryAttempt, l as logRejectedGeometryAttempt } from "./index-6z_8j1tM.mjs";
 const GeometryWidget = ({
   widgetId,
   widget,
@@ -47,4 +47,4 @@ const GeometryWidget = ({
 export {
   GeometryWidget
 };
-//# sourceMappingURL=GeometryWidget-gtAP_-_S.mjs.map
+//# sourceMappingURL=GeometryWidget-2TCLbTEv.mjs.map

package/dist/{GeometryWidget-gtAP_-_S.mjs.map → GeometryWidget-2TCLbTEv.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"GeometryWidget-gtAP_-_S.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-2TCLbTEv.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-DgPfqyQv.js → GeometryWidget-BTPjXJz-.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-tEgJE6m2.js");
+const index = require("./index-C3qDr71I.js");
 const GeometryWidget = ({
   widgetId,
   widget,
@@ -47,4 +47,4 @@ const GeometryWidget = ({
   ) });
 };
 exports.GeometryWidget = GeometryWidget;
-//# sourceMappingURL=GeometryWidget-DgPfqyQv.js.map
+//# sourceMappingURL=GeometryWidget-BTPjXJz-.js.map

package/dist/{GeometryWidget-DgPfqyQv.js.map → GeometryWidget-BTPjXJz-.js.map}

@@ -1 +1 @@
-{"version":3,"file":"GeometryWidget-DgPfqyQv.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-BTPjXJz-.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;;"}