@mathscan/math-exercise-engine 1.2.10 → 1.2.12

package/dist/{index-DBteHZkS.mjs → index-BtJRsuwL.mjs}

@@ -240,6 +240,7 @@ const JSON_TYPES = {
   GEOMETRY: "geometry"
 };
 const DRAG_OPTIONS_WIDGET_ID = "_drag_options";
+const NUMERIC_KEYPAD_WIDGET_ID = "_numeric_keypad";
 const RULER_WIDGET_ID = "_ruler";
 const PROTRACTOR_WIDGET_ID = "_protractor";
 const SET_SQUARE_WIDGET_ID = "_set_square";
@@ -272,7 +273,8 @@ const INPUT_TYPES = {
   /** Numeric input (digits only) */
   NUMERIC: "numeric"
 };
-const NUMBER_LINE_STYLES = ["arrow-right", "arrow-left", "arrow-both", "line"];
+const NUMBER_LINE_STYLES = ["arrow-right", "arrow-left", "arrow-both", "line", "line-left"];
+const DEFAULT_NUMBER_LINE_STYLE = "line-left";
 const INTERNAL_PRECISION = 9;
 const DISPLAY_PRECISION = 2;
 const SIDE_PAD = 7;
@@ -2055,6 +2057,8 @@ const VISUAL_FRACTION_SHAPE = {
 };
 const VISUAL_FRACTION_DEFAULT_SIZE = 1.35;
 const VISUAL_FRACTION_MAX_DIVISIONS = 100;
+const INLINE_INPUT_MAX_WIDTH = 20;
+const InlineInputWidthSchema = z.number().int().positive().max(INLINE_INPUT_MAX_WIDTH, { message: `width cannot exceed ${INLINE_INPUT_MAX_WIDTH}` }).optional();
 const FreeTextInlineSchema = z.object({
   type: z.literal(AST_TYPES.FREE_TEXT),
   value: z.string()
@@ -2084,6 +2088,7 @@ const InlineInputWidgetSchema = z.discriminatedUnion("inputType", [
     name: z.string(),
     inputType: z.literal(INPUT_TYPES.STRING),
     length: z.number().int().positive(),
+    width: InlineInputWidthSchema,
     placeholder: z.string().max(32).optional(),
     disabled: z.boolean().optional(),
     answer: z.union([z.string(), z.number()]).optional()
@@ -2093,6 +2098,7 @@ const InlineInputWidgetSchema = z.discriminatedUnion("inputType", [
     name: z.string(),
     inputType: z.literal(INPUT_TYPES.NUMERIC),
     digits: z.number().int().positive(),
+    width: InlineInputWidthSchema,
     placeholder: z.string().max(32).optional(),
     disabled: z.boolean().optional(),
     answer: z.union([z.string(), z.number()]).optional()
@@ -2250,7 +2256,7 @@ function createBoldText(value, highlight) {
     highlight
   });
 }
-function createStringInput(name, length, answer, placeholder, disabled) {
+function createStringInput(name, length, answer, placeholder, disabled, width) {
   return parseOrThrow(
     InlineInputWidgetSchema,
     {
@@ -2258,6 +2264,7 @@ function createStringInput(name, length, answer, placeholder, disabled) {
       name,
       inputType: INPUT_TYPES.STRING,
       length,
+      width,
       placeholder,
       disabled,
       // A disabled input is never graded, so its answer is dropped.
@@ -2266,7 +2273,7 @@ function createStringInput(name, length, answer, placeholder, disabled) {
     "STRING_INPUT"
   );
 }
-function createNumericInput(name, digits, answer, placeholder, disabled) {
+function createNumericInput(name, digits, answer, placeholder, disabled, width) {
   return parseOrThrow(
     InlineInputWidgetSchema,
     {
@@ -2274,6 +2281,7 @@ function createNumericInput(name, digits, answer, placeholder, disabled) {
       name,
       inputType: INPUT_TYPES.NUMERIC,
       digits,
+      width,
       placeholder,
       disabled,
       // A disabled input is never graded, so its answer is dropped.
@@ -2490,7 +2498,7 @@ const NumberLineBlockSchema = z.object({
     errorMap: () => ({
       message: `NUMBER_LINE: style must be one of ${NUMBER_LINE_STYLES.join(", ")}`
     })
-  }).optional(),
+  }).default(DEFAULT_NUMBER_LINE_STYLE),
   labelVisibility: z.enum(NUMBER_LINE_LABELS, {
     errorMap: () => ({
       message: `NUMBER_LINE: labelVisibility must be one of ${NUMBER_LINE_LABELS.join(", ")}`
@@ -4323,12 +4331,19 @@ class NaturalDSLVisitor extends BaseCstVisitor {
         `${ctx.stringInput ? "STRING_INPUT" : "NUMERIC_INPUT"} "${name}": disabled must be true or false, got ${JSON.stringify(params.disabled)}`
       );
     }
+    const width = params.width;
+    const maxChars = ctx.stringInput ? params.length : params.digits;
+    if (width !== void 0 && width < maxChars) {
+      throw new Error(
+        `${ctx.stringInput ? "STRING_INPUT" : "NUMERIC_INPUT"} "${name}": width (${width}) cannot be smaller than ${ctx.stringInput ? "length" : "digits"} (${maxChars})`
+      );
+    }
     if (ctx.stringInput) {
       const length = params.length;
-      return createStringInput(name, length, answer, placeholder, disabled);
+      return createStringInput(name, length, answer, placeholder, disabled, width);
     }
     const digits = params.digits;
-    return createNumericInput(name, digits, answer, placeholder, disabled);
+    return createNumericInput(name, digits, answer, placeholder, disabled, width);
   }
   inlineDragOption(ctx) {
     const valueToken = ctx.StringLiteral[0];
@@ -5068,6 +5083,8 @@ const StringInputJSONSchema = z.object({
   type: z.literal(JSON_TYPES.INLINE_INPUT),
   inputType: z.literal(INPUT_TYPES.STRING),
   length: z.number().int().positive(),
+  /** Box width in characters; defaults to `length`. */
+  width: InlineInputWidthSchema,
   placeholder: z.string().max(32).optional(),
   /** Gray, non-interactive, never graded (any answer for it is ignored). */
   disabled: z.boolean().optional()
@@ -5076,6 +5093,8 @@ const NumericInputJSONSchema = z.object({
   type: z.literal(JSON_TYPES.INLINE_INPUT),
   inputType: z.literal(INPUT_TYPES.NUMERIC),
   digits: z.number().int().positive(),
+  /** Box width in characters; defaults to `digits`. */
+  width: InlineInputWidthSchema,
   placeholder: z.string().max(32).optional(),
   /** Gray, non-interactive, never graded (any answer for it is ignored). */
   disabled: z.boolean().optional()
@@ -6066,7 +6085,7 @@ lodash.exports;
       var reIsNative = RegExp2(
         "^" + funcToString.call(hasOwnProperty).replace(reRegExpChar, "\\$&").replace(/hasOwnProperty|(function).*?(?=\\\()| for .+?(?=\\\])/g, "$1.*?") + "$"
       );
-      var Buffer = moduleExports ? context.Buffer : undefined$1, Symbol = context.Symbol, Uint8Array = context.Uint8Array, allocUnsafe = Buffer ? Buffer.allocUnsafe : undefined$1, getPrototype = overArg(Object2.getPrototypeOf, Object2), objectCreate = Object2.create, propertyIsEnumerable = objectProto.propertyIsEnumerable, splice = arrayProto.splice, spreadableSymbol = Symbol ? Symbol.isConcatSpreadable : undefined$1, symIterator = Symbol ? Symbol.iterator : undefined$1, symToStringTag = Symbol ? Symbol.toStringTag : undefined$1;
+      var Buffer = moduleExports ? context.Buffer : undefined$1, Symbol2 = context.Symbol, Uint8Array = context.Uint8Array, allocUnsafe = Buffer ? Buffer.allocUnsafe : undefined$1, getPrototype = overArg(Object2.getPrototypeOf, Object2), objectCreate = Object2.create, propertyIsEnumerable = objectProto.propertyIsEnumerable, splice = arrayProto.splice, spreadableSymbol = Symbol2 ? Symbol2.isConcatSpreadable : undefined$1, symIterator = Symbol2 ? Symbol2.iterator : undefined$1, symToStringTag = Symbol2 ? Symbol2.toStringTag : undefined$1;
       var defineProperty = function() {
         try {
           var func = getNative(Object2, "defineProperty");
@@ -6081,7 +6100,7 @@ lodash.exports;
       var metaMap = WeakMap && new WeakMap();
       var realNames = {};
       var dataViewCtorString = toSource(DataView), mapCtorString = toSource(Map2), promiseCtorString = toSource(Promise2), setCtorString = toSource(Set2), weakMapCtorString = toSource(WeakMap);
-      var symbolProto = Symbol ? Symbol.prototype : undefined$1, symbolValueOf = symbolProto ? symbolProto.valueOf : undefined$1, symbolToString = symbolProto ? symbolProto.toString : undefined$1;
+      var symbolProto = Symbol2 ? Symbol2.prototype : undefined$1, symbolValueOf = symbolProto ? symbolProto.valueOf : undefined$1, symbolToString = symbolProto ? symbolProto.toString : undefined$1;
       function lodash2(value) {
         if (isObjectLike(value) && !isArray(value) && !(value instanceof LazyWrapper)) {
           if (value instanceof LodashWrapper) {
@@ -10980,6 +10999,7 @@ function toJSON(ast) {
           type: JSON_TYPES.INLINE_INPUT,
           inputType: INPUT_TYPES.STRING,
           length: inline.length,
+          ...inline.width !== void 0 && { width: inline.width },
           placeholder: inline.placeholder,
           ...inline.disabled && { disabled: true }
         };
@@ -10988,6 +11008,7 @@ function toJSON(ast) {
           type: JSON_TYPES.INLINE_INPUT,
           inputType: INPUT_TYPES.NUMERIC,
           digits: inline.digits,
+          ...inline.width !== void 0 && { width: inline.width },
           placeholder: inline.placeholder,
           ...inline.disabled && { disabled: true }
         };
@@ -11083,7 +11104,7 @@ function toJSON(ast) {
           options: lodashExports.shuffle(tool.options)
         };
       } else if (tool.type === AST_TYPES.NUMERIC_KEYPAD) {
-        widgets["_numeric_keypad"] = {
+        widgets[NUMERIC_KEYPAD_WIDGET_ID] = {
           type: JSON_TYPES.NUMERIC_KEYPAD,
           includeOperators: tool.includeOperators,
           includeDecimal: tool.includeDecimal,
@@ -11346,7 +11367,7 @@ function transformNumberLine(numberLine, idGenerator, inlineDragIds) {
     max: numberLine.max,
     step: numberLine.step,
     ...numberLine.minorTicks !== void 0 && { minorTicks: numberLine.minorTicks },
-    ...numberLine.style !== void 0 && { style: numberLine.style },
+    style: numberLine.style,
     ...numberLine.labelVisibility !== void 0 && { labelVisibility: numberLine.labelVisibility },
     ...counterItem !== void 0 && { counter: counterItem },
     ...highlights !== void 0 && { highlights },
@@ -16003,22 +16024,22 @@ function createDefaultDropAnimation(options) {
       easing,
       fill: "forwards"
     });
-    return new Promise((resolve) => {
+    return new Promise((resolve2) => {
       animation.onfinish = () => {
         cleanup == null ? void 0 : cleanup();
-        resolve();
+        resolve2();
       };
     });
   };
 }
-let key = 0;
+let key$1 = 0;
 function useKey(id) {
   return useMemo(() => {
     if (id == null) {
       return;
     }
-    key++;
-    return key;
+    key$1++;
+    return key$1;
   }, [id]);
 }
 const DragOverlay = /* @__PURE__ */ React.memo((_ref) => {
@@ -16100,6 +16121,7 @@ const DEFAULT_SOUNDS = {
   "drag-start": dragStart,
   "drag-drop": dragDrop,
   "drag-cancel": dragDrop,
+  "drag-hint": buttonClick,
   "radio-select": buttonClick,
   "pair-select": buttonClick,
   "pair-link": buttonClick,
@@ -16203,14 +16225,24 @@ function useExerciseDnd() {
   }
   return ctx;
 }
+const NO_EXERCISE = Symbol("no-exercise");
 const ExerciseDndProvider = ({
   children,
   droppedSources,
-  onDragEnd
+  onDragEnd,
+  exerciseKey
 }) => {
   const [activeItem, setActiveItem] = useState(null);
+  const [draggedExerciseKey, setDraggedExerciseKey] = useState(NO_EXERCISE);
+  const hasDraggedOption = draggedExerciseKey === exerciseKey;
   const [dropHandlers] = useState(() => /* @__PURE__ */ new Map());
   const playSound = useSound();
+  const hintSoundExerciseRef = useRef(NO_EXERCISE);
+  const playHintSound = useCallback(() => {
+    if (hintSoundExerciseRef.current === exerciseKey) return;
+    hintSoundExerciseRef.current = exerciseKey;
+    playSound("drag-hint");
+  }, [playSound, exerciseKey]);
   const usedOptionIds = useMemo(() => {
     return new Set(droppedSources.values());
   }, [droppedSources]);
@@ -16234,6 +16266,7 @@ const ExerciseDndProvider = ({
     const raw = active.data.current;
     const item = raw?.type === "placed-chip" ? { type: "placed-chip", widgetId: raw.widgetId, label: raw.label, sourceOptionId: raw.sourceOptionId } : raw;
     setActiveItem(item);
+    if (item.type === "drag-option") setDraggedExerciseKey(exerciseKey);
     playSound("drag-start");
   };
   const handleDragEnd = (event) => {
@@ -16259,6 +16292,9 @@ const ExerciseDndProvider = ({
       value: {
         activeItem,
         isDragging: activeItem !== null,
+        exerciseKey,
+        hasDraggedOption,
+        playHintSound,
         usedOptionIds,
         droppedSources,
         registerDropHandler,
@@ -17039,7 +17075,38 @@ function isUndoDrop(event, dragId) {
 const LockContext = createContext(false);
 const ExerciseLockProvider = ({ locked, children }) => /* @__PURE__ */ jsx(LockContext.Provider, { value: locked, children });
 const useExerciseLocked = () => useContext(LockContext);
-const PlacedInputChip = ({ widgetId, value, className = "", onRemove }) => {
+const OVERLAY_STYLE = {
+  position: "absolute",
+  top: 0,
+  left: 0,
+  width: "100%",
+  height: "100%",
+  minWidth: 0,
+  maxWidth: "none",
+  margin: 0,
+  boxSizing: "border-box"
+};
+const SlotSizer = ({
+  style,
+  ...props
+}) => /* @__PURE__ */ jsx(
+  "input",
+  {
+    ...props,
+    type: "text",
+    value: "",
+    readOnly: true,
+    tabIndex: -1,
+    "aria-hidden": "true",
+    style: { ...style, visibility: "hidden" }
+  }
+);
+const PlacedInputChip = ({
+  widgetId,
+  value,
+  className = "",
+  onRemove
+}) => {
   const { droppedSources } = useExerciseDnd();
   const locked = useExerciseLocked();
   const sourceOptionId = droppedSources.get(widgetId);
@@ -17063,13 +17130,41 @@ const PlacedInputChip = ({ widgetId, value, className = "", onRemove }) => {
         if (!locked && e.detail !== 0) onRemove();
       },
       title: locked ? void 0 : "Drag to move, or click to remove",
-      style: { touchAction: "none", cursor: locked ? "default" : "grab" },
+      style: {
+        ...OVERLAY_STYLE,
+        touchAction: "none",
+        cursor: locked ? "default" : "grab"
+      },
       ...listeners,
       ...attributes,
       children: value
     }
   );
 };
+function getMaxInputLength(exercise, inputKey) {
+  const widget = exercise.widgets[inputKey];
+  if (widget?.type !== JSON_TYPES.INLINE_INPUT) return void 0;
+  return widget.inputType === INPUT_TYPES.NUMERIC ? widget.digits : widget.length;
+}
+function getInputElementId(key2) {
+  return `${key2}-input`;
+}
+function getTextInputs(container) {
+  return Array.from(
+    container.querySelectorAll(
+      'input[type="text"], input[type="number"], textarea, select'
+    )
+  );
+}
+function canTakeInput(el) {
+  return !el.readOnly && !el.disabled;
+}
+function findNextInput(container, currentKey) {
+  const inputs = getTextInputs(container);
+  const currentIndex = inputs.findIndex((el) => el.id === getInputElementId(currentKey));
+  if (currentIndex === -1) return null;
+  return inputs.slice(currentIndex + 1).find(canTakeInput) ?? null;
+}
 const InlineInput = ({
   widgetId,
   value,
@@ -17078,6 +17173,7 @@ const InlineInput = ({
   inputType,
   length,
   digits,
+  width,
   placeholder,
   disabled = false,
   onChange,
@@ -17091,8 +17187,8 @@ const InlineInput = ({
   const handleDrop = useCallback((item) => {
     return applyDropToInput(widgetId, item, onChange);
   }, [onChange, widgetId]);
-  const expectedLength = inputType === "numeric" ? digits : length;
-  const dynamicWidth = `${(expectedLength || 5) * 0.8 + 1}em`;
+  const expectedLength = inputType === INPUT_TYPES.NUMERIC ? digits : length;
+  const dynamicWidth = `${(width ?? expectedLength ?? 5) * 0.8 + 1}em`;
   const statusClass = validationStatus ? ` widget--${validationStatus}` : "";
   const disabledClass = disabled ? " inline-input--disabled" : "";
   return /* @__PURE__ */ jsx(
@@ -17105,21 +17201,31 @@ const InlineInput = ({
       className: "inline-widget inline-input-droppable",
       children: isDropped && value !== "" ? (
         // Show as chip only when value came from drag-drop
-        /* @__PURE__ */ jsx(
-          PlacedInputChip,
-          {
-            widgetId,
-            value,
-            className: statusClass.trim(),
-            onRemove: () => handleChange("", false)
-          }
-        )
+        /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            SlotSizer,
+            {
+              className: `inline-input${disabledClass}`,
+              style: { width: dynamicWidth },
+              placeholder
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            PlacedInputChip,
+            {
+              widgetId,
+              value,
+              className: statusClass.trim(),
+              onRemove: () => handleChange("", false)
+            }
+          )
+        ] })
       ) : (
         // Regular input for typing
         /* @__PURE__ */ jsx(
           "input",
           {
-            id: widgetId + "-input",
+            id: getInputElementId(widgetId),
             type: "text",
             className: `inline-input${statusClass}${disabledClass}`,
             value,
@@ -17139,15 +17245,20 @@ const InlineInput = ({
     }
   );
 };
-const SingleDragOption = ({
+const SingleDragOption = (props) => {
+  const { exerciseKey } = useExerciseDnd();
+  return /* @__PURE__ */ jsx(DragOptionChip, { ...props }, exerciseKey ?? "");
+};
+const DragOptionChip = ({
   optionId,
   value,
   onOptionClick,
   className = ""
 }) => {
-  const { usedOptionIds } = useExerciseDnd();
+  const { usedOptionIds, hasDraggedOption, playHintSound } = useExerciseDnd();
   const locked = useExerciseLocked();
   const isUsed = usedOptionIds.has(optionId);
+  const { jiggling: hinting, onAnimationEnd: onHintEnd } = useJiggle(hasDraggedOption);
   return /* @__PURE__ */ jsx("div", { className: `drag-option-slot ${className}`.trim(), children: isUsed ? /* @__PURE__ */ jsx("div", { className: "drag-option-empty", "aria-hidden": "true" }) : /* @__PURE__ */ jsx(
     Draggable,
     {
@@ -17159,7 +17270,11 @@ const SingleDragOption = ({
       children: /* @__PURE__ */ jsx(
         "button",
         {
-          className: "drag-option",
+          className: hinting && !locked ? "drag-option drag-option--hint" : "drag-option",
+          onAnimationStart: () => {
+            if (hinting) playHintSound();
+          },
+          onAnimationEnd: onHintEnd,
           onClick: () => {
             if (!locked) onOptionClick?.(value);
           },
@@ -17288,23 +17403,23 @@ const NumericKeypad = ({
     playSound("keypad-press");
     onChange(value.slice(0, -1));
   };
-  return /* @__PURE__ */ jsxs("div", { className: `numeric-keypad ${includeOperators ? "numeric-keypad-with-operators" : ""}`, children: [
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("1"), children: "1" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("2"), children: "2" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("3"), children: "3" }),
-    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", onClick: () => handleDigit("+"), children: "+" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("4"), children: "4" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("5"), children: "5" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("6"), children: "6" }),
-    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", onClick: () => handleDigit("-"), children: "-" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("7"), children: "7" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("8"), children: "8" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("9"), children: "9" }),
-    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", onClick: () => handleDigit("×"), children: "×" }),
-    includeDecimal ? /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-decimal", onClick: () => handleDigit(","), children: "," }) : /* @__PURE__ */ jsx("div", {}),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", onClick: () => handleDigit("0"), children: "0" }),
-    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-backspace", onClick: handleBackspace, children: "⌫" }),
-    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", onClick: () => handleDigit("÷"), children: "÷" })
+  return /* @__PURE__ */ jsxs("div", { className: `numeric-keypad ${includeOperators ? "numeric-keypad-with-operators" : ""}`, "data-tutorial": "keypad", children: [
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "1", onClick: () => handleDigit("1"), children: "1" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "2", onClick: () => handleDigit("2"), children: "2" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "3", onClick: () => handleDigit("3"), children: "3" }),
+    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", "data-key": "+", onClick: () => handleDigit("+"), children: "+" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "4", onClick: () => handleDigit("4"), children: "4" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "5", onClick: () => handleDigit("5"), children: "5" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "6", onClick: () => handleDigit("6"), children: "6" }),
+    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", "data-key": "-", onClick: () => handleDigit("-"), children: "-" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "7", onClick: () => handleDigit("7"), children: "7" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "8", onClick: () => handleDigit("8"), children: "8" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "9", onClick: () => handleDigit("9"), children: "9" }),
+    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", "data-key": "×", onClick: () => handleDigit("×"), children: "×" }),
+    includeDecimal ? /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-decimal", "data-key": ",", onClick: () => handleDigit(","), children: "," }) : /* @__PURE__ */ jsx("div", {}),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-digit", "data-key": "0", onClick: () => handleDigit("0"), children: "0" }),
+    /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-backspace", "data-key": "backspace", onClick: handleBackspace, children: "⌫" }),
+    includeOperators && /* @__PURE__ */ jsx("button", { disabled: locked, className: "keypad-btn keypad-btn-operator", "data-key": "÷", onClick: () => handleDigit("÷"), children: "÷" })
   ] });
 };
 const FractionInput = ({
@@ -17344,18 +17459,28 @@ const FractionInput = ({
         onDrop: handleDrop(subKey),
         disabled: locked,
         className: "fraction-slot-droppable",
-        children: isDroppedHere && currentValue !== "" ? /* @__PURE__ */ jsx(
-          PlacedInputChip,
-          {
-            widgetId: subKey,
-            value: currentValue,
-            className: `fraction-chip${slotClass}`,
-            onRemove: () => onChange(subKey, "", false)
-          }
-        ) : /* @__PURE__ */ jsx(
+        children: isDroppedHere && currentValue !== "" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          /* @__PURE__ */ jsx(
+            SlotSizer,
+            {
+              className: "inline-input fraction-input",
+              size: placeholder ? placeholder.length : void 0,
+              placeholder
+            }
+          ),
+          /* @__PURE__ */ jsx(
+            PlacedInputChip,
+            {
+              widgetId: subKey,
+              value: currentValue,
+              className: `fraction-chip${slotClass}`,
+              onRemove: () => onChange(subKey, "", false)
+            }
+          )
+        ] }) : /* @__PURE__ */ jsx(
           "input",
           {
-            id: `${subKey}-input`,
+            id: getInputElementId(subKey),
             type: "text",
             className: `inline-input fraction-input${slotClass}`,
             value: currentValue,
@@ -18933,11 +19058,12 @@ const RadioOptions = ({
 };
 const Btn = ({
   label,
+  dataKey = label,
   extraClass = "keypad-btn-digit",
   onClick
 }) => {
   const locked = useExerciseLocked();
-  return /* @__PURE__ */ jsx("button", { className: `keypad-btn ${extraClass}`, disabled: locked, onClick, children: /* @__PURE__ */ jsx("span", { children: label }) });
+  return /* @__PURE__ */ jsx("button", { className: `keypad-btn ${extraClass}`, "data-key": dataKey, disabled: locked, onClick, children: /* @__PURE__ */ jsx("span", { children: label }) });
 };
 const DiamondKeypad = ({ value, onChange }) => {
   const playSound = useSound();
@@ -18949,7 +19075,7 @@ const DiamondKeypad = ({ value, onChange }) => {
     playSound("keypad-press");
     onChange(value.slice(0, -1));
   };
-  return /* @__PURE__ */ jsxs("div", { className: "diamond-keypad", children: [
+  return /* @__PURE__ */ jsxs("div", { className: "diamond-keypad", "data-tutorial": "keypad", children: [
     /* @__PURE__ */ jsxs("div", { className: "diamond-keypad-row", children: [
       /* @__PURE__ */ jsx(Btn, { label: "1", onClick: () => append("1") }),
       /* @__PURE__ */ jsx(Btn, { label: "2", onClick: () => append("2") }),
@@ -18968,7 +19094,7 @@ const DiamondKeypad = ({ value, onChange }) => {
     ] }),
     /* @__PURE__ */ jsxs("div", { className: "diamond-keypad-row", children: [
       /* @__PURE__ */ jsx(Btn, { label: ".", extraClass: "keypad-btn-decimal", onClick: () => append(".") }),
-      /* @__PURE__ */ jsx(Btn, { label: "⌫", extraClass: "keypad-btn-backspace", onClick: backspace })
+      /* @__PURE__ */ jsx(Btn, { label: "⌫", dataKey: "backspace", extraClass: "keypad-btn-backspace", onClick: backspace })
     ] })
   ] });
 };
@@ -19574,7 +19700,7 @@ function isGeometryWidget(widget) {
   return widget.type === JSON_TYPES.GEOMETRY;
 }
 const GeometryWidget = React.lazy(async () => ({
-  default: (await import("./GeometryWidget-gtAP_-_S.mjs")).GeometryWidget
+  default: (await import("./GeometryWidget-Qi5s7Lql.mjs")).GeometryWidget
 }));
 const WidgetRenderer = ({
   widget,
@@ -19602,8 +19728,9 @@ const WidgetRenderer = ({
         isDropped,
         validationStatus,
         inputType: widget.inputType,
-        length: widget.inputType === "string" ? widget.length : void 0,
-        digits: widget.inputType === "numeric" ? widget.digits : void 0,
+        length: widget.inputType === INPUT_TYPES.STRING ? widget.length : void 0,
+        digits: widget.inputType === INPUT_TYPES.NUMERIC ? widget.digits : void 0,
+        width: widget.width,
         placeholder: widget.placeholder,
         disabled: widget.disabled,
         onChange,
@@ -19974,6 +20101,13 @@ const EPSILON = 10 ** -INTERNAL_PRECISION;
 const cleanFloat = (n) => parseFloat(n.toFixed(INTERNAL_PRECISION));
 const roundTick = (n) => parseFloat(n.toFixed(DISPLAY_PRECISION));
 const almostEqual = (a, b) => Math.abs(a - b) <= EPSILON;
+const NUMBER_LINE_AXIS_ENDS = {
+  "arrow-right": { left: "tick", right: "arrow" },
+  "arrow-left": { left: "arrow", right: "tick" },
+  "arrow-both": { left: "arrow", right: "arrow" },
+  "line": { left: "line", right: "line" },
+  "line-left": { left: "line", right: "arrow" }
+};
 const toPercent = (value, min, max) => {
   const raw = SIDE_PAD + (value - min) / (max - min) * (100 - 2 * SIDE_PAD);
   return Math.max(SIDE_PAD, Math.min(100 - SIDE_PAD, raw));
@@ -21021,7 +21155,7 @@ const NumberLineRenderer = ({
     max,
     step,
     minorTicks = 0,
-    style: lineStyle = "arrow-right",
+    style: lineStyle = DEFAULT_NUMBER_LINE_STYLE,
     labelVisibility,
     highlights,
     arrows,
@@ -21085,8 +21219,9 @@ const NumberLineRenderer = ({
     () => getMinorTickValues(majorTicks, minorTicks),
     [majorTicks, minorTicks]
   );
-  const showArrowRight = lineStyle === "arrow-right" || lineStyle === "arrow-both";
-  const showArrowLeft = lineStyle === "arrow-left" || lineStyle === "arrow-both";
+  const axisEnds = NUMBER_LINE_AXIS_ENDS[lineStyle] ?? NUMBER_LINE_AXIS_ENDS[DEFAULT_NUMBER_LINE_STYLE];
+  const showArrowLeft = axisEnds.left === "arrow";
+  const showArrowRight = axisEnds.right === "arrow";
   const hasDragOptions = Boolean(widgets[DRAG_OPTIONS_WIDGET_ID]);
   const isAxisDragMode = hasDragOptions && item.dragMode === "axis";
   const inputTickSet = useMemo(() => {
@@ -21134,7 +21269,7 @@ const NumberLineRenderer = ({
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      className: `number-line${isAxisDragMode ? " number-line--drag-mode" : ""}${lineStyle === "line" ? " number-line--style-line" : ""}${nlValidationStatus ? ` number-line--${nlValidationStatus}` : ""}`,
+      className: `number-line${isAxisDragMode ? " number-line--drag-mode" : ""}${axisEnds.left === "line" ? " number-line--extend-left" : ""}${axisEnds.right === "line" ? " number-line--extend-right" : ""}${nlValidationStatus ? ` number-line--${nlValidationStatus}` : ""}`,
       style: {
         [CSS_VAR_SIDE_PAD]: `${SIDE_PAD}%`,
         ...positionContentHeight && { "--nl-position-content-height": positionContentHeight }
@@ -21507,6 +21642,35 @@ function groupLineItems(items) {
   }
   return groups;
 }
+function placeTableCells(rows, cols) {
+  const placements = /* @__PURE__ */ new Map();
+  const occupied = rows.map(() => []);
+  const totalRows = rows.length;
+  rows.forEach((row, rowIndex) => {
+    const taken = occupied[rowIndex] ?? [];
+    let col = 0;
+    for (const cell of row.cells) {
+      while (taken[col]) col++;
+      const colspan = cell.colspan || 1;
+      const rowspan = Math.min(cell.rowspan || 1, totalRows - rowIndex);
+      for (let r = rowIndex; r < rowIndex + rowspan; r++) {
+        const line = occupied[r];
+        if (!line) continue;
+        for (let c = col; c < col + colspan; c++) line[c] = true;
+      }
+      placements.set(cell.id, {
+        column: col + 1,
+        row: rowIndex + 1,
+        colspan,
+        rowspan,
+        isLastColumn: col + colspan >= cols,
+        isLastRow: rowIndex + rowspan >= totalRows
+      });
+      col += colspan;
+    }
+  });
+  return placements;
+}
 const toValidationStatus = (v) => v === true ? "correct" : v === false ? "incorrect" : null;
 const isNumericText = (value) => /^[\d.,\s]+$/.test(value);
 const numberClass = (value) => isNumericText(value) ? "text-item-number" : "";
@@ -21630,21 +21794,28 @@ const LayoutRenderer = ({
         subItem.id
       )) });
     case JSON_TYPES.TABLE: {
-      const totalRows = item.rows.length;
+      const placements = placeTableCells(item.rows, item.cols);
       const tableStyle = {
-        "--exercise-table-border-color": item.borderColor ?? DEFAULT_TABLE_BORDER_COLOR
+        "--exercise-table-border-color": item.borderColor ?? DEFAULT_TABLE_BORDER_COLOR,
+        "--exercise-table-cols": item.cols
       };
-      return /* @__PURE__ */ jsx("div", { className: "exercise-table-container", style: tableStyle, children: /* @__PURE__ */ jsx("table", { className: "exercise-table", children: /* @__PURE__ */ jsx("tbody", { children: item.rows.map((row, rowIndex) => /* @__PURE__ */ jsx("tr", { className: "exercise-table-row", style: { backgroundColor: row.backgroundColor }, children: row.cells.map((cell) => {
-        const rowspan = cell.rowspan || 1;
-        const isLastRow = rowIndex + rowspan - 1 >= totalRows - 1;
+      return /* @__PURE__ */ jsx("div", { className: "exercise-table-container", style: tableStyle, children: /* @__PURE__ */ jsx("div", { className: "exercise-table", role: "table", children: item.rows.map((row) => /* @__PURE__ */ jsx("div", { className: "exercise-table-row", role: "row", children: row.cells.map((cell) => {
+        const placement = placements.get(cell.id);
+        const modifiers = [
+          placement?.isLastRow ? " exercise-table-cell--last-row" : "",
+          placement?.isLastColumn ? " exercise-table-cell--last-col" : ""
+        ].join("");
         return /* @__PURE__ */ jsx(
-          "td",
+          "div",
           {
-            className: `exercise-table-cell${isLastRow ? " exercise-table-cell--last-row" : ""}`,
-            colSpan: cell.colspan || 1,
-            rowSpan: rowspan,
-            style: { backgroundColor: cell.backgroundColor },
-            children: cell.items.map((subItem) => /* @__PURE__ */ jsx(
+            className: `exercise-table-cell${modifiers}`,
+            role: "cell",
+            style: {
+              backgroundColor: cell.backgroundColor ?? row.backgroundColor,
+              gridColumn: placement && `${placement.column} / span ${placement.colspan}`,
+              gridRow: placement && `${placement.row} / span ${placement.rowspan}`
+            },
+            children: /* @__PURE__ */ jsx("div", { className: "exercise-table-cell-content", children: cell.items.map((subItem) => /* @__PURE__ */ jsx(
               LayoutRenderer,
               {
                 item: subItem,
@@ -21657,11 +21828,11 @@ const LayoutRenderer = ({
                 resetKey
               },
               subItem.id
-            ))
+            )) })
           },
           cell.id
         );
-      }) }, row.id)) }) }) });
+      }) }, row.id)) }) });
     }
     case JSON_TYPES.NUMBER_LINE:
       return /* @__PURE__ */ jsx(
@@ -21831,6 +22002,394 @@ const LayoutRenderer = ({
       return null;
   }
 };
+function LionHand({ className }) {
+  const id = useId();
+  const shadowId = `${id}-shadow`;
+  const maskId = `${id}-mask`;
+  return /* @__PURE__ */ jsxs(
+    "svg",
+    {
+      "aria-hidden": "true",
+      focusable: "false",
+      width: "75",
+      height: "78",
+      viewBox: "0 0 75 78",
+      fill: "none",
+      xmlns: "http://www.w3.org/2000/svg",
+      className,
+      children: [
+        /* @__PURE__ */ jsxs("g", { filter: `url(#${shadowId})`, children: [
+          /* @__PURE__ */ jsx(
+            "mask",
+            {
+              id: maskId,
+              style: { maskType: "alpha" },
+              maskUnits: "userSpaceOnUse",
+              x: "9",
+              y: "19",
+              width: "49",
+              height: "42",
+              children: /* @__PURE__ */ jsx("path", { d: "M49.7484 33.9668C58.158 45.6281 37.9572 61.4399 28.1745 60.1051C17.1397 58.5995 5.03802 42.2474 10.4349 38.3224C15.8318 34.3974 18.9715 32.4031 23.1181 30.1278C24.1486 29.5624 25.1742 29.0263 26.1947 28.5358C33.7314 24.764 52.8138 16.0308 57.0969 21.97C59.9201 25.8848 54.8651 28.9522 48.1097 31.8806C48.658 32.518 49.2042 33.2123 49.7484 33.9668Z", fill: "#FCD592" })
+            }
+          ),
+          /* @__PURE__ */ jsxs("g", { mask: `url(#${maskId})`, children: [
+            /* @__PURE__ */ jsx("path", { d: "M49.7484 33.9672C58.158 45.6285 38.3118 60.3151 32.1037 64.7332C22.6672 71.4486 2.68204 43.9969 12.2424 37.1926C15.1884 35.0959 18.9716 32.4035 23.1182 30.1282C24.7308 29.2433 26.3314 28.4303 27.9195 27.7514C36.611 23.6398 54.4269 16.1501 58.4471 21.7248C61.34 25.7362 55.5686 28.9294 48.2024 31.9893C48.7196 32.5968 49.2349 33.2552 49.7484 33.9672Z", fill: "#FCD592" }),
+            /* @__PURE__ */ jsx("path", { d: "M12.2426 37.1924C2.68223 43.9967 22.6674 71.4485 32.1039 64.733C31.3434 63.6785 26.4317 61.1668 25.3134 59.6161C24.1951 58.0654 22.794 50.5211 22.123 49.5907C21.4521 48.6603 16.3219 45.7409 15.5637 44.4032C14.8055 43.0655 13.8979 39.4877 14.7258 35.4253L12.2426 37.1924Z", fill: "#6B291E" }),
+            /* @__PURE__ */ jsx("path", { d: "M50.4102 36.1737C50.6823 37.524 52.0035 38.4016 53.3614 38.1339C54.7192 37.8662 55.5994 36.5546 55.3274 35.2043L52.8688 35.689L50.4102 36.1737ZM38.8014 26.9523C37.4241 27.0934 36.425 28.3178 36.5697 29.6872C36.7144 31.0565 37.9482 32.0522 39.3255 31.9111L39.0634 29.4317L38.8014 26.9523ZM52.8688 35.689C55.3274 35.2043 55.327 35.2023 55.3266 35.2004C55.3265 35.1997 55.326 35.1977 55.3258 35.1963C55.3252 35.1935 55.3246 35.1906 55.324 35.1875C55.3227 35.1815 55.3213 35.1749 55.3198 35.1679C55.3168 35.1539 55.3133 35.1379 55.3092 35.1201C55.3011 35.0845 55.2907 35.0415 55.2779 34.9916C55.2522 34.8918 55.2163 34.764 55.1676 34.6127C55.0703 34.3106 54.9205 33.911 54.6961 33.4507C54.247 32.5296 53.4925 31.3535 52.2552 30.241C49.7078 27.9508 45.5021 26.2658 38.8014 26.9523L39.0634 29.4317L39.3255 31.9111C44.9159 31.3384 47.6128 32.782 48.8954 33.9352C49.5731 34.5445 49.9653 35.1687 50.1842 35.6177C50.2938 35.8424 50.3584 36.0201 50.3919 36.1242C50.4086 36.1759 50.4172 36.2084 50.4197 36.2181C50.4209 36.223 50.4206 36.222 50.419 36.2148C50.4181 36.2111 50.417 36.2059 50.4155 36.1991C50.4148 36.1957 50.414 36.1919 50.4131 36.1876C50.4127 36.1855 50.4122 36.1833 50.4117 36.181C50.4115 36.1798 50.4111 36.178 50.411 36.1774C50.4106 36.1755 50.4102 36.1737 52.8688 35.689Z", fill: "#A2634A" }),
+            /* @__PURE__ */ jsx("path", { d: "M54.7526 47.3947C55.5602 48.5146 57.1269 48.7734 58.2518 47.9729C59.3767 47.1723 59.634 45.6155 58.8264 44.4956L56.7895 45.9452L54.7526 47.3947ZM38.1539 36.5617C36.7805 36.7357 35.8113 37.9837 35.9891 39.3493C36.1669 40.7148 37.4244 41.6808 38.7978 41.5068L38.4758 39.0342L38.1539 36.5617ZM56.7895 45.9452L58.8264 44.4956C57.4277 42.5562 55.3182 40.1317 51.9378 38.4204C48.5385 36.6995 44.0772 35.8112 38.1539 36.5617L38.4758 39.0342L38.7978 41.5068C43.8796 40.863 47.3003 41.6624 49.6691 42.8616C52.0569 44.0704 53.6015 45.7985 54.7526 47.3947L56.7895 45.9452Z", fill: "#A2634A" })
+          ] })
+        ] }),
+        /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("filter", { id: shadowId, x: "-1.99995", y: "0", width: "78.3658", height: "81.8518", filterUnits: "userSpaceOnUse", colorInterpolationFilters: "sRGB", children: [
+          /* @__PURE__ */ jsx("feFlood", { floodOpacity: "0", result: "BackgroundImageFix" }),
+          /* @__PURE__ */ jsx("feColorMatrix", { in: "SourceAlpha", type: "matrix", values: "0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0", result: "hardAlpha" }),
+          /* @__PURE__ */ jsx("feOffset", { dy: "2" }),
+          /* @__PURE__ */ jsx("feGaussianBlur", { stdDeviation: "1" }),
+          /* @__PURE__ */ jsx("feComposite", { in2: "hardAlpha", operator: "out" }),
+          /* @__PURE__ */ jsx("feColorMatrix", { type: "matrix", values: "0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0" }),
+          /* @__PURE__ */ jsx("feBlend", { mode: "normal", in2: "BackgroundImageFix", result: "effect1_dropShadow" }),
+          /* @__PURE__ */ jsx("feBlend", { mode: "normal", in: "SourceGraphic", in2: "effect1_dropShadow", result: "shape" })
+        ] }) })
+      ]
+    }
+  );
+}
+const TUTORIAL_HAND_TIP = { x: 56 / 75, y: 22 / 78 };
+const CYCLE_MS = 1400;
+const PRESS_AT_MS = 650;
+const PRESS_HOLD_MS = 220;
+const HOLE_PAD = 10;
+const HOLE_RADIUS = 18;
+const HAND_W = 72;
+const HAND_H = 75;
+const BUBBLE_W = 240;
+const BUBBLE_GAP = 14;
+const EDGE = 8;
+const DEFAULT_NEXT_LABEL = "فهمت";
+function resolve(t) {
+  return (typeof t === "function" ? t() : t) ?? null;
+}
+function toRect(t) {
+  if (!t) return null;
+  const r = t instanceof Element ? t.getBoundingClientRect() : t;
+  if (r.width <= 0 || r.height <= 0) return null;
+  return { x: Math.round(r.x), y: Math.round(r.y), width: Math.round(r.width), height: Math.round(r.height) };
+}
+const centerOf = (r) => ({ x: r.x + r.width / 2, y: r.y + r.height / 2 });
+const TutorialOverlay = ({ tutorial, root, json, options, onClose }) => {
+  const { steps } = tutorial;
+  const [stepIndex, setStepIndex] = useState(
+    () => Math.min(Math.max(0, Math.floor(options.startStep ?? 0)), steps.length - 1)
+  );
+  const step = steps[stepIndex];
+  const optionsRef = useRef(options);
+  optionsRef.current = options;
+  const ctx = { root, json, submitTarget: resolve(options.submitTarget) };
+  const ctxRef = useRef(ctx);
+  ctxRef.current = ctx;
+  const [layout, setLayout] = useState(null);
+  useEffect(() => {
+    let raf = 0;
+    let last = "";
+    const tick = () => {
+      const c = ctxRef.current;
+      const next2 = {
+        spotlight: step.spotlight(c).map(toRect),
+        taps: step.taps(c).map(toRect),
+        anchor: toRect(resolve(optionsRef.current.bubbleAnchor)),
+        root: toRect(c.root),
+        vw: window.innerWidth,
+        vh: window.innerHeight
+      };
+      const key2 = JSON.stringify(next2);
+      if (key2 !== last) {
+        last = key2;
+        setLayout(next2);
+      }
+      raf = requestAnimationFrame(tick);
+    };
+    tick();
+    return () => cancelAnimationFrame(raf);
+  }, [step]);
+  const [tapIndex, setTapIndex] = useState(0);
+  const [tapCount, setTapCount] = useState(0);
+  const [shownStep, setShownStep] = useState(stepIndex);
+  if (shownStep !== stepIndex) {
+    setShownStep(stepIndex);
+    setTapIndex(0);
+    setTapCount(0);
+  }
+  useEffect(() => {
+    let release;
+    const press = setTimeout(() => {
+      setTapCount((n) => n + 1);
+      const targets = step.taps(ctxRef.current);
+      const el = targets[tapIndex % Math.max(1, targets.length)];
+      if (el instanceof Element) {
+        el.classList.add("met-tutorial-pressed");
+        release = setTimeout(() => el.classList.remove("met-tutorial-pressed"), PRESS_HOLD_MS);
+      }
+    }, PRESS_AT_MS);
+    const advance = setTimeout(() => setTapIndex((i) => i + 1), CYCLE_MS);
+    return () => {
+      clearTimeout(press);
+      clearTimeout(advance);
+      if (release) clearTimeout(release);
+      root.querySelectorAll(".met-tutorial-pressed").forEach((el) => el.classList.remove("met-tutorial-pressed"));
+    };
+  }, [step, tapIndex, root]);
+  const text = options.texts?.[step.id] ?? step.text;
+  const textRef = useRef(text);
+  textRef.current = text;
+  useEffect(() => {
+    optionsRef.current.onStep?.(stepIndex, step.id);
+    optionsRef.current.onSpeak?.(step.id, textRef.current);
+  }, [stepIndex, step]);
+  const isLast = stepIndex === steps.length - 1;
+  const next = () => {
+    if (isLast) onClose(true);
+    else setStepIndex((i) => i + 1);
+  };
+  const overlayRef = useRef(null);
+  const nextRef = useRef(null);
+  const onCloseRef = useRef(onClose);
+  onCloseRef.current = onClose;
+  useEffect(() => {
+    const previous = document.activeElement instanceof HTMLElement ? document.activeElement : null;
+    previous?.blur();
+    const onKeyDown = (e) => {
+      const overlay = overlayRef.current;
+      if (e.key === "Escape") {
+        e.preventDefault();
+        e.stopPropagation();
+        onCloseRef.current(false);
+        return;
+      }
+      if (e.key === "Tab" && overlay) {
+        e.preventDefault();
+        const buttons = Array.from(overlay.querySelectorAll("button"));
+        if (buttons.length === 0) return;
+        const at = buttons.indexOf(document.activeElement);
+        const to = (at + (e.shiftKey ? -1 : 1) + buttons.length) % buttons.length;
+        buttons[to]?.focus();
+        return;
+      }
+      if (overlay && e.target instanceof Node && overlay.contains(e.target)) return;
+      e.preventDefault();
+      e.stopPropagation();
+    };
+    document.addEventListener("keydown", onKeyDown, true);
+    return () => {
+      document.removeEventListener("keydown", onKeyDown, true);
+      if (previous?.isConnected) previous.focus();
+    };
+  }, []);
+  const bubbleShown = layout !== null;
+  useEffect(() => {
+    nextRef.current?.focus({ focusVisible: false });
+  }, [stepIndex, bubbleShown]);
+  const maskId = `met-tutorial-mask-${useId()}`;
+  if (typeof document === "undefined") return null;
+  const holes = (layout?.spotlight ?? []).filter((r) => r !== null);
+  const tapTarget = layout?.taps.length ? layout.taps[tapIndex % layout.taps.length] ?? null : null;
+  const Scene = step.Scene;
+  return createPortal(
+    /* @__PURE__ */ jsxs("div", { ref: overlayRef, className: "met-tutorial", role: "dialog", "aria-modal": "true", "aria-label": text, children: [
+      /* @__PURE__ */ jsxs("svg", { className: "met-tutorial-dim", "aria-hidden": "true", children: [
+        /* @__PURE__ */ jsx("defs", { children: /* @__PURE__ */ jsxs("mask", { id: maskId, children: [
+          /* @__PURE__ */ jsx("rect", { width: "100%", height: "100%", fill: "white" }),
+          holes.map((r, i) => /* @__PURE__ */ jsx(
+            "rect",
+            {
+              x: r.x - HOLE_PAD,
+              y: r.y - HOLE_PAD,
+              width: r.width + HOLE_PAD * 2,
+              height: r.height + HOLE_PAD * 2,
+              rx: HOLE_RADIUS,
+              fill: "black"
+            },
+            i
+          ))
+        ] }) }),
+        /* @__PURE__ */ jsx("rect", { width: "100%", height: "100%", mask: `url(#${maskId})` })
+      ] }),
+      holes.map((r, i) => /* @__PURE__ */ jsx(
+        "div",
+        {
+          className: "met-tutorial-glow",
+          style: {
+            left: r.x - HOLE_PAD,
+            top: r.y - HOLE_PAD,
+            width: r.width + HOLE_PAD * 2,
+            height: r.height + HOLE_PAD * 2,
+            borderRadius: HOLE_RADIUS
+          }
+        },
+        i
+      )),
+      Scene && layout && /* @__PURE__ */ jsx(Scene, { ctx, spotlight: layout.spotlight, taps: layout.taps, tapCount }),
+      tapTarget && /* @__PURE__ */ jsx(Hand, { target: tapTarget, tapKey: `${stepIndex}-${tapIndex}` }),
+      layout && /* @__PURE__ */ jsx(
+        Bubble,
+        {
+          layout,
+          text,
+          stepIndex,
+          stepCount: steps.length,
+          nextLabel: options.nextLabel ?? DEFAULT_NEXT_LABEL,
+          onSpeak: options.onSpeak && (options.canSpeak?.(step.id) ?? true) ? () => optionsRef.current.onSpeak?.(step.id, textRef.current) : void 0,
+          onNext: next,
+          nextRef
+        }
+      )
+    ] }),
+    document.body
+  );
+};
+const Hand = ({ target, tapKey }) => {
+  const c = centerOf(target);
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      className: "met-tutorial-hand",
+      style: {
+        width: HAND_W,
+        height: HAND_H,
+        transform: `translate(${c.x - TUTORIAL_HAND_TIP.x * HAND_W}px, ${c.y - TUTORIAL_HAND_TIP.y * HAND_H}px)`
+      },
+      children: /* @__PURE__ */ jsxs("div", { className: "met-tutorial-hand-press", children: [
+        /* @__PURE__ */ jsx(
+          "span",
+          {
+            className: "met-tutorial-ripple",
+            style: { left: TUTORIAL_HAND_TIP.x * HAND_W, top: TUTORIAL_HAND_TIP.y * HAND_H }
+          }
+        ),
+        /* @__PURE__ */ jsx(LionHand, {})
+      ] }, tapKey)
+    }
+  );
+};
+const Bubble = ({ layout, text, stepIndex, stepCount, nextLabel, onSpeak, onNext, nextRef }) => {
+  const { anchor, root, vw, vh } = layout;
+  const clampLeft = (x) => Math.min(Math.max(EDGE, x), Math.max(EDGE, vw - BUBBLE_W - EDGE));
+  const style = anchor ? { left: clampLeft(anchor.x), bottom: Math.max(EDGE, vh - anchor.y + BUBBLE_GAP), width: BUBBLE_W } : { left: clampLeft((root?.x ?? 0) + EDGE * 2), top: (root?.y ?? 0) + EDGE * 2, width: BUBBLE_W };
+  return /* @__PURE__ */ jsxs("div", { className: `met-tutorial-bubble${anchor ? " met-tutorial-bubble--anchored" : ""}`, style, children: [
+    /* @__PURE__ */ jsx("p", { className: "met-tutorial-text", dir: "auto", children: text }),
+    /* @__PURE__ */ jsxs("div", { className: "met-tutorial-actions", children: [
+      onSpeak && /* @__PURE__ */ jsx("button", { type: "button", className: "met-tutorial-speak", "aria-label": "🔊", onClick: onSpeak, children: /* @__PURE__ */ jsxs("svg", { viewBox: "0 0 24 24", width: "24", height: "24", "aria-hidden": "true", children: [
+        /* @__PURE__ */ jsx("path", { d: "M4 9v6h4l5 4V5L8 9H4z", fill: "currentColor" }),
+        /* @__PURE__ */ jsx("path", { d: "M16 8.5a5 5 0 0 1 0 7M18.5 6a8.5 8.5 0 0 1 0 12", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "round" })
+      ] }) }),
+      /* @__PURE__ */ jsx("button", { ref: nextRef, type: "button", className: "met-tutorial-next", onClick: onNext, children: nextLabel })
+    ] }),
+    stepCount > 1 && /* @__PURE__ */ jsx("div", { className: "met-tutorial-dots", "aria-hidden": "true", children: Array.from({ length: stepCount }, (_, i) => /* @__PURE__ */ jsx("span", { className: i === stepIndex ? "is-current" : i < stepIndex ? "is-done" : "" }, i)) })
+  ] });
+};
+const DEMO_KEYS = ["2", "5", "8"];
+const DEFAULT_SLOTS = 3;
+const MAX_SLOTS = 6;
+const STAND_IN_CHECK_SIZE = 52;
+const STAND_IN_CHECK_GAP = 20;
+function keypad(ctx) {
+  return ctx.root.querySelector('[data-tutorial="keypad"]');
+}
+function key(ctx, k) {
+  return ctx.root.querySelector(`[data-tutorial="keypad"] [data-key="${k}"]`);
+}
+function answerBox(ctx) {
+  const inputs = getTextInputs(ctx.root);
+  return inputs.find(canTakeInput) ?? inputs[0] ?? null;
+}
+function answerSlots(ctx) {
+  const id = answerBox(ctx)?.id.replace(/-input$/, "");
+  const max = id ? getMaxInputLength(ctx.json, id) : void 0;
+  return Math.min(MAX_SLOTS, Math.max(1, max ?? DEFAULT_SLOTS));
+}
+function checkTarget(ctx) {
+  if (ctx.submitTarget) return ctx.submitTarget;
+  const box = answerBox(ctx)?.getBoundingClientRect();
+  if (!box) return null;
+  return new DOMRect(
+    box.right + STAND_IN_CHECK_GAP,
+    box.top + box.height / 2 - STAND_IN_CHECK_SIZE / 2,
+    STAND_IN_CHECK_SIZE,
+    STAND_IN_CHECK_SIZE
+  );
+}
+const demoKeys = (ctx) => DEMO_KEYS.map((k) => key(ctx, k));
+const StandInFill = ({ box, slots, filled }) => /* @__PURE__ */ jsx(
+  "div",
+  {
+    className: "met-tutorial-fill",
+    style: { left: box.x, top: box.y, width: box.width, height: box.height },
+    children: Array.from({ length: slots }, (_, i) => /* @__PURE__ */ jsx("span", { className: i < filled ? "met-tutorial-fill-dot" : "met-tutorial-fill-slot", children: i < filled ? "●" : "_" }, i))
+  }
+);
+const center = (r) => ({ x: r.x + r.width / 2, y: r.y + r.height / 2 });
+const HopScene = ({ ctx, spotlight, taps, tapCount }) => {
+  const box = spotlight[1];
+  if (!box) return null;
+  const slots = answerSlots(ctx);
+  const filled = tapCount === 0 ? 0 : (tapCount - 1) % slots + 1;
+  const from = tapCount > 0 ? taps[(tapCount - 1) % taps.length] : null;
+  let arc = null;
+  if (from) {
+    const a = center(from);
+    const b = center(box);
+    const lift = Math.max(40, Math.hypot(b.x - a.x, b.y - a.y) * 0.35);
+    arc = `M ${a.x} ${a.y} Q ${(a.x + b.x) / 2} ${Math.min(a.y, b.y) - lift} ${b.x} ${b.y}`;
+  }
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    arc && /* @__PURE__ */ jsx("svg", { className: "met-tutorial-arc", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { d: arc }) }),
+    arc && /* @__PURE__ */ jsx("div", { className: "met-tutorial-hop", style: { offsetPath: `path('${arc}')` } }, tapCount),
+    /* @__PURE__ */ jsx(StandInFill, { box, slots, filled })
+  ] });
+};
+const CheckScene = ({ ctx, spotlight }) => {
+  const box = spotlight[0];
+  const check = spotlight[1];
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    box && /* @__PURE__ */ jsx(StandInFill, { box, slots: answerSlots(ctx), filled: answerSlots(ctx) }),
+    check && !ctx.submitTarget && /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "met-tutorial-stand-in-check",
+        style: { left: check.x, top: check.y, width: check.width, height: check.height },
+        children: /* @__PURE__ */ jsx("span", { children: "✓" })
+      }
+    )
+  ] });
+};
+const keypadTutorial = {
+  id: "keypad",
+  appliesTo: (json) => json.widgets[NUMERIC_KEYPAD_WIDGET_ID]?.type === JSON_TYPES.NUMERIC_KEYPAD,
+  steps: [
+    {
+      id: "keypad.tap-number",
+      text: "اضغط على رقم",
+      spotlight: (ctx) => [keypad(ctx), answerBox(ctx)],
+      taps: demoKeys
+    },
+    {
+      id: "keypad.hop",
+      text: "يظهر الرقم في الخانة",
+      spotlight: (ctx) => [keypad(ctx), answerBox(ctx)],
+      taps: demoKeys,
+      Scene: HopScene
+    },
+    {
+      id: "keypad.tap-check",
+      text: "اضغط على زر التحقق",
+      spotlight: (ctx) => [answerBox(ctx), checkTarget(ctx)],
+      taps: (ctx) => [checkTarget(ctx)],
+      Scene: CheckScene
+    }
+  ]
+};
+const WIDGET_TUTORIALS = [keypadTutorial];
+function findWidgetTutorial(json) {
+  return WIDGET_TUTORIALS.find((t) => t.appliesTo(json)) ?? null;
+}
 const TOOL_ASPECT_RATIO = {
   ruler: RULER_ASPECT_RATIO,
   protractor: PROTRACTOR_ASPECT_RATIO,
@@ -21869,6 +22428,11 @@ function buildInitialValues(json) {
 function toBaseId(widgetId) {
   return parseFractionKey(widgetId)?.widgetId ?? widgetId;
 }
+function hasJustFilledBox(json, key2, previous, value) {
+  const maxLength = getMaxInputLength(json, key2);
+  if (maxLength === void 0) return false;
+  return String(previous ?? "").length < maxLength && String(value).length >= maxLength;
+}
 function buildInitialValuesSignature(json) {
   return JSON.stringify({
     widgets: json.widgets,
@@ -21918,6 +22482,27 @@ function buildRevealedValues(json) {
   }
   return revealed;
 }
+function buildRevealedDropSources(json, revealedValues) {
+  const pool = [];
+  const bank = json.widgets[DRAG_OPTIONS_WIDGET_ID];
+  if (bank?.type === JSON_TYPES.DRAG_OPTIONS) {
+    bank.options.forEach((value, idx) => pool.push({ optionId: `drag-option-${idx}`, value: String(value) }));
+  }
+  for (const [widgetId, widget] of Object.entries(json.widgets)) {
+    if (widget.type === JSON_TYPES.INLINE_DRAG_OPTION) pool.push({ optionId: widgetId, value: widget.value });
+  }
+  const sources = /* @__PURE__ */ new Map();
+  if (pool.length === 0) return sources;
+  const used = /* @__PURE__ */ new Set();
+  for (const [inputId, value] of Object.entries(revealedValues)) {
+    if (typeof value !== "string" || value === "") continue;
+    const match = pool.find((o) => !used.has(o.optionId) && normalize(o.value) === normalize(value));
+    if (!match) continue;
+    used.add(match.optionId);
+    sources.set(inputId, match.optionId);
+  }
+  return sources;
+}
 const ExerciseRenderer = forwardRef(({
   json,
   onSubmit,
@@ -21940,6 +22525,8 @@ const ExerciseRenderer = forwardRef(({
   const rootRef = useRef(null);
   const [resetKey, setResetKey] = useState(0);
   const [revealed, setRevealed] = useState(false);
+  const tutorial = useMemo(() => findWidgetTutorial(json), [json]);
+  const [tutorialRun, setTutorialRun] = useState(null);
   const themeStyle = useMemo(() => {
     const style = {};
     if (theme?.correct) style["--exercise-correct"] = theme.correct;
@@ -21960,6 +22547,7 @@ const ExerciseRenderer = forwardRef(({
     setResetKey((k) => k + 1);
     setLoadedValuesSignature(initialValuesSignature);
     touchedRef.current = /* @__PURE__ */ new Set();
+    setTutorialRun(null);
   }, [json, initialValuesSignature, loadedValuesSignature]);
   const locked = validationDetails !== null || externallyLocked;
   const lastResultRef = useRef(null);
@@ -22043,7 +22631,7 @@ const ExerciseRenderer = forwardRef(({
       const next = { ...valuesRef.current, ...revealedValues };
       valuesRef.current = next;
       setValues(next);
-      setDroppedSources(/* @__PURE__ */ new Map());
+      setDroppedSources(buildRevealedDropSources(json, revealedValues));
       setValidationDetails(details);
       setRevealed(true);
       setResetKey((k) => k + 1);
@@ -22051,20 +22639,30 @@ const ExerciseRenderer = forwardRef(({
     focusFirstInput: () => {
       const container = rootRef.current ?? document.querySelector(".math-exercise-renderer");
       if (!container) return;
-      const candidates = Array.from(
-        container.querySelectorAll('input[type="text"], input[type="number"], textarea, select')
-      );
-      const canTakeInput = (el) => !el.readOnly && !el.disabled;
+      const candidates = getTextInputs(container);
       const target = candidates.find(canTakeInput) ?? (locked ? void 0 : candidates[0]);
       target?.focus();
-    }
-  }), [json, values, onSubmit, playSound, locked, initialValuesSignature]);
+    },
+    hasTutorial: () => tutorial !== null,
+    tutorialId: () => tutorial?.id ?? null,
+    startTutorial: (options = {}) => {
+      if (!tutorial || !rootRef.current) return false;
+      setTutorialRun((prev) => ({ options, run: (prev?.run ?? 0) + 1 }));
+      return true;
+    },
+    stopTutorial: () => setTutorialRun(null)
+  }), [json, values, onSubmit, playSound, locked, initialValuesSignature, tutorial]);
+  const focusNextInput = (currentKey) => {
+    if (!rootRef.current) return;
+    findNextInput(rootRef.current, currentKey)?.focus();
+  };
   const handleChange = (widgetId, value, fromDrop = false, sourceOptionId, silent = false) => {
     if (locked) return;
     if (!silent) {
       setRevealed(false);
       touchedRef.current.add(toBaseId(widgetId));
     }
+    const previous = valuesRef.current[widgetId];
     const next = { ...valuesRef.current, [widgetId]: value };
     valuesRef.current = next;
     setValues(next);
@@ -22078,6 +22676,9 @@ const ExerciseRenderer = forwardRef(({
       return next2;
     });
     onChange?.(next);
+    if (!fromDrop && !silent && hasJustFilledBox(json, widgetId, previous, value)) {
+      focusNextInput(widgetId);
+    }
   };
   const handleSubmit = () => {
     runSubmit();
@@ -22192,7 +22793,7 @@ const ExerciseRenderer = forwardRef(({
   const rulerWidget = json.widgets[RULER_WIDGET_ID];
   const protractorWidget = json.widgets[PROTRACTOR_WIDGET_ID];
   const setSquareWidget = json.widgets[SET_SQUARE_WIDGET_ID];
-  const numericKeypadWidget = json.widgets["_numeric_keypad"];
+  const numericKeypadWidget = json.widgets[NUMERIC_KEYPAD_WIDGET_ID];
   const { tools, toolsMinHeight } = useMemo(() => {
     const list = [];
     const PAD = 12;
@@ -22211,7 +22812,7 @@ const ExerciseRenderer = forwardRef(({
     if (setSquareWidget) add2("set-square-1", "set-square", Math.round(getSize(setSquareWidget) * 160));
     return { tools: list, toolsMinHeight: maxH };
   }, [rulerWidget, protractorWidget, setSquareWidget]);
-  return /* @__PURE__ */ jsx(SoundPlayerProvider, { play: playSound, children: /* @__PURE__ */ jsx(ExerciseLockProvider, { locked, children: /* @__PURE__ */ jsx(ExerciseDndProvider, { droppedSources, children: /* @__PURE__ */ jsxs("div", { ref: rootRef, className: `math-exercise-renderer ${revealed ? "revealed" : ""} ${locked ? "locked" : ""} ${className}`, style: themeStyle, children: [
+  return /* @__PURE__ */ jsx(SoundPlayerProvider, { play: playSound, children: /* @__PURE__ */ jsx(ExerciseLockProvider, { locked, children: /* @__PURE__ */ jsx(ExerciseDndProvider, { droppedSources, exerciseKey: loadedValuesSignature, children: /* @__PURE__ */ jsxs("div", { ref: rootRef, className: `math-exercise-renderer ${revealed ? "revealed" : ""} ${locked ? "locked" : ""} ${className}`, style: themeStyle, children: [
     /* @__PURE__ */ jsxs(
       "div",
       {
@@ -22307,7 +22908,21 @@ const ExerciseRenderer = forwardRef(({
         }
       }
     ) }),
-    showSubmitButton && /* @__PURE__ */ jsx("button", { className: "exercise-submit-btn", disabled: locked, onClick: handleSubmit, children: "Check Answer" })
+    showSubmitButton && /* @__PURE__ */ jsx("button", { className: "exercise-submit-btn", disabled: locked, onClick: handleSubmit, children: "Check Answer" }),
+    tutorial && tutorialRun && rootRef.current && /* @__PURE__ */ jsx(
+      TutorialOverlay,
+      {
+        tutorial,
+        root: rootRef.current,
+        json,
+        options: tutorialRun.options,
+        onClose: (finished) => {
+          setTutorialRun(null);
+          if (finished) tutorialRun.options.onDone?.();
+        }
+      },
+      tutorialRun.run
+    )
   ] }) }) }) });
 });
 ExerciseRenderer.displayName = "ExerciseRenderer";
@@ -22441,7 +23056,7 @@ export {
   VopSeparatorItemSchema as ay,
   VopCellItemSchema as az,
   tokenizeSafe as b,
-  isTextBlock as b$,
+  TextBlockSchema as b$,
   validateWidgetJSON as b0,
   validateWidgetJSONSafe as b1,
   EngineError as b2,
@@ -22452,181 +23067,185 @@ export {
   ExerciseRenderer as b7,
   LayoutRenderer as b8,
   WidgetRenderer as b9,
-  InlineNodeSchema as bA,
-  createFreeText as bB,
-  createSpace as bC,
-  createHighlightedText as bD,
-  createColorText as bE,
-  createBoldText as bF,
-  createStringInput as bG,
-  createNumericInput as bH,
-  createImage as bI,
-  createFraction as bJ,
-  createVisualFraction as bK,
-  createInlineDragOption as bL,
-  createDisplayClock as bM,
-  createInteractiveClock as bN,
-  isFreeText as bO,
-  isSpace as bP,
-  isInlineInput as bQ,
-  isFraction as bR,
-  isImage as bS,
-  isClock as bT,
-  isInlineNode as bU,
-  isVisualFractionInline as bV,
-  isInlineDragOption as bW,
-  TextBlockSchema as bX,
-  LineBlockSchema as bY,
-  createTextBlock as bZ,
-  createLineBlock as b_,
+  CLOCK_MODES as bA,
+  CLOCK_FORMATS as bB,
+  CLOCK_TIME_REGEX as bC,
+  ClockInlineSchema as bD,
+  InlineNodeSchema as bE,
+  createFreeText as bF,
+  createSpace as bG,
+  createHighlightedText as bH,
+  createColorText as bI,
+  createBoldText as bJ,
+  createStringInput as bK,
+  createNumericInput as bL,
+  createImage as bM,
+  createFraction as bN,
+  createVisualFraction as bO,
+  createInlineDragOption as bP,
+  createDisplayClock as bQ,
+  createInteractiveClock as bR,
+  isFreeText as bS,
+  isSpace as bT,
+  isInlineInput as bU,
+  isFraction as bV,
+  isImage as bW,
+  isClock as bX,
+  isInlineNode as bY,
+  isVisualFractionInline as bZ,
+  isInlineDragOption as b_,
   renderExercise as ba,
   SoundProvider as bb,
   useSound as bc,
   ExerciseLockProvider as bd,
-  isPairMatcherWidget as be,
-  isMatcherWidget as bf,
-  VISUAL_FRACTION_SHAPES as bg,
-  VISUAL_FRACTION_SHAPE as bh,
-  VISUAL_FRACTION_DEFAULT_SIZE as bi,
-  VISUAL_FRACTION_MAX_DIVISIONS as bj,
-  FreeTextInlineSchema as bk,
-  SpaceInlineSchema as bl,
-  HighlightedTextInlineSchema as bm,
-  ColorTextInlineSchema as bn,
-  BoldTextInlineSchema as bo,
-  InlineInputWidgetSchema as bp,
-  FractionInlineSchema as bq,
-  ImageInlineSchema as br,
-  VisualFractionInlineSchema as bs,
-  validateVisualFractionCapacity as bt,
-  InlineDragOptionSchema as bu,
-  CLOCK_TYPES as bv,
-  CLOCK_MODES as bw,
-  CLOCK_FORMATS as bx,
-  CLOCK_TIME_REGEX as by,
-  ClockInlineSchema as bz,
+  WIDGET_TUTORIALS as be,
+  findWidgetTutorial as bf,
+  isPairMatcherWidget as bg,
+  isMatcherWidget as bh,
+  VISUAL_FRACTION_SHAPES as bi,
+  VISUAL_FRACTION_SHAPE as bj,
+  VISUAL_FRACTION_DEFAULT_SIZE as bk,
+  VISUAL_FRACTION_MAX_DIVISIONS as bl,
+  INLINE_INPUT_MAX_WIDTH as bm,
+  InlineInputWidthSchema as bn,
+  FreeTextInlineSchema as bo,
+  SpaceInlineSchema as bp,
+  HighlightedTextInlineSchema as bq,
+  ColorTextInlineSchema as br,
+  BoldTextInlineSchema as bs,
+  InlineInputWidgetSchema as bt,
+  FractionInlineSchema as bu,
+  ImageInlineSchema as bv,
+  VisualFractionInlineSchema as bw,
+  validateVisualFractionCapacity as bx,
+  InlineDragOptionSchema as by,
+  CLOCK_TYPES as bz,
   compile as c,
-  VopRowSchema as c$,
-  isLineBlock as c0,
-  DisplayInlineNodeSchema as c1,
-  MatcherItemSchema as c2,
-  createMatcherItem as c3,
-  isMatcherItem as c4,
-  MatcherRowSchema as c5,
-  createMatcherRow as c6,
-  isMatcherRow as c7,
-  MatcherBlockSchema as c8,
-  createMatcherBlock as c9,
-  createExpressionValidation as cA,
-  createMixedValidation as cB,
-  isSimpleValidation as cC,
-  isExpressionValidation as cD,
-  isMixedValidation as cE,
-  isValidationNode as cF,
-  ContentBlockSchema as cG,
-  ExerciseDocumentSchema as cH,
-  createExerciseDocument as cI,
-  isExerciseDocument as cJ,
-  VOP_OPERATORS as cK,
-  normalizeVopOperator as cL,
-  VopDigitCellSchema as cM,
-  VopLabelCellSchema as cN,
-  VopInputCellSchema as cO,
-  VopEmptyCellSchema as cP,
-  VopColorCellSchema as cQ,
-  VopBoldCellSchema as cR,
-  VopHighlightCellSchema as cS,
-  VopCellSchema as cT,
-  createVopDigitCell as cU,
-  createVopInputCell as cV,
-  createVopLabelCell as cW,
-  createVopEmptyCell as cX,
-  createVopColorCell as cY,
-  createVopBoldCell as cZ,
-  createVopHighlightCell as c_,
-  isMatcherBlock as ca,
-  PairMatcherBlockSchema as cb,
-  createPairMatcherBlock as cc,
-  isPairMatcherBlock as cd,
-  DragOptionsToolSchema as ce,
-  NumericKeypadToolSchema as cf,
-  RulerToolSchema as cg,
-  ProtractorToolSchema as ch,
-  SetSquareToolSchema as ci,
-  ToolNodeSchema as cj,
-  createDragOptions as ck,
-  createNumericKeypad as cl,
-  createRulerTool as cm,
-  createProtractorTool as cn,
-  createSetSquareTool as co,
-  isDragOptions as cp,
-  isNumericKeypad as cq,
-  isRulerTool as cr,
-  isProtractorTool as cs,
-  isSetSquareTool as ct,
-  isToolNode as cu,
-  SimpleValidationSchema as cv,
-  ExpressionValidationSchema as cw,
-  MixedValidationSchema as cx,
-  ValidationNodeSchema as cy,
-  createSimpleValidation as cz,
+  createVopEmptyCell as c$,
+  LineBlockSchema as c0,
+  createTextBlock as c1,
+  createLineBlock as c2,
+  isTextBlock as c3,
+  isLineBlock as c4,
+  DisplayInlineNodeSchema as c5,
+  MatcherItemSchema as c6,
+  createMatcherItem as c7,
+  isMatcherItem as c8,
+  MatcherRowSchema as c9,
+  ExpressionValidationSchema as cA,
+  MixedValidationSchema as cB,
+  ValidationNodeSchema as cC,
+  createSimpleValidation as cD,
+  createExpressionValidation as cE,
+  createMixedValidation as cF,
+  isSimpleValidation as cG,
+  isExpressionValidation as cH,
+  isMixedValidation as cI,
+  isValidationNode as cJ,
+  ContentBlockSchema as cK,
+  ExerciseDocumentSchema as cL,
+  createExerciseDocument as cM,
+  isExerciseDocument as cN,
+  VOP_OPERATORS as cO,
+  normalizeVopOperator as cP,
+  VopDigitCellSchema as cQ,
+  VopLabelCellSchema as cR,
+  VopInputCellSchema as cS,
+  VopEmptyCellSchema as cT,
+  VopColorCellSchema as cU,
+  VopBoldCellSchema as cV,
+  VopHighlightCellSchema as cW,
+  VopCellSchema as cX,
+  createVopDigitCell as cY,
+  createVopInputCell as cZ,
+  createVopLabelCell as c_,
+  createMatcherRow as ca,
+  isMatcherRow as cb,
+  MatcherBlockSchema as cc,
+  createMatcherBlock as cd,
+  isMatcherBlock as ce,
+  PairMatcherBlockSchema as cf,
+  createPairMatcherBlock as cg,
+  isPairMatcherBlock as ch,
+  DragOptionsToolSchema as ci,
+  NumericKeypadToolSchema as cj,
+  RulerToolSchema as ck,
+  ProtractorToolSchema as cl,
+  SetSquareToolSchema as cm,
+  ToolNodeSchema as cn,
+  createDragOptions as co,
+  createNumericKeypad as cp,
+  createRulerTool as cq,
+  createProtractorTool as cr,
+  createSetSquareTool as cs,
+  isDragOptions as ct,
+  isNumericKeypad as cu,
+  isRulerTool as cv,
+  isProtractorTool as cw,
+  isSetSquareTool as cx,
+  isToolNode as cy,
+  SimpleValidationSchema as cz,
   parse as d,
-  createVopRow as d0,
-  VopCarryRowSchema as d1,
-  createVopCarryRow as d2,
-  VopSeparatorSchema as d3,
-  createVopSeparator as d4,
-  VerticalOperationBlockSchema as d5,
-  createVerticalOperationBlock as d6,
-  isVopCell as d7,
-  isVopRow as d8,
-  isVopCarryRow as d9,
-  ChartBarSchema as dA,
-  createChartBar as dB,
-  isChartBar as dC,
-  ChartSeriesSchema as dD,
-  createChartSeries as dE,
-  isChartSeries as dF,
-  ChartSeriesBarSchema as dG,
-  createChartSeriesBar as dH,
-  isChartSeriesBar as dI,
-  ChartGroupSchema as dJ,
-  createChartGroup as dK,
-  isChartGroup as dL,
-  alignGroupBarsToSeries as dM,
-  ChartBlockSchema as dN,
-  resolveChartAxes as dO,
-  validateUniqueIds as dP,
-  createChartBlock as dQ,
-  isChartBlock as dR,
-  GeometryBlockSchema as dS,
-  createGeometryBlock as dT,
-  isGeometryBlock as dU,
-  isVopSeparator as da,
-  isVerticalOperationBlock as db,
-  GRID_SYMMETRY_AXES as dc,
-  GRID_SYMMETRY_INTERACTIVE_AREAS as dd,
-  GRID_SYMMETRY_MAX_ROWS as de,
-  GRID_SYMMETRY_MAX_COLS as df,
-  GRID_SYMMETRY_MIN_CELL_SIZE as dg,
-  GRID_SYMMETRY_MAX_CELL_SIZE as dh,
-  isCellInInteractiveArea as di,
-  reflectGridSymmetryCell as dj,
-  computeGridSymmetryExpectedCells as dk,
-  computeGridSymmetryCellsToFill as dl,
-  GridSymmetryBlockSchema as dm,
-  createGridSymmetryBlock as dn,
-  isGridSymmetryBlock as dp,
-  CHART_TYPES as dq,
-  CHART_AXIS_DEFAULTS as dr,
-  CHART_MAX_AXIS_TICKS as ds,
-  CHART_MAX_PICTO_SLOTS as dt,
-  ChartAxisSchema as du,
-  createChartAxis as dv,
-  isChartAxis as dw,
-  ChartPictoSchema as dx,
-  createChartPicto as dy,
-  isChartPicto as dz,
+  createVopColorCell as d0,
+  createVopBoldCell as d1,
+  createVopHighlightCell as d2,
+  VopRowSchema as d3,
+  createVopRow as d4,
+  VopCarryRowSchema as d5,
+  createVopCarryRow as d6,
+  VopSeparatorSchema as d7,
+  createVopSeparator as d8,
+  VerticalOperationBlockSchema as d9,
+  isChartAxis as dA,
+  ChartPictoSchema as dB,
+  createChartPicto as dC,
+  isChartPicto as dD,
+  ChartBarSchema as dE,
+  createChartBar as dF,
+  isChartBar as dG,
+  ChartSeriesSchema as dH,
+  createChartSeries as dI,
+  isChartSeries as dJ,
+  ChartSeriesBarSchema as dK,
+  createChartSeriesBar as dL,
+  isChartSeriesBar as dM,
+  ChartGroupSchema as dN,
+  createChartGroup as dO,
+  isChartGroup as dP,
+  alignGroupBarsToSeries as dQ,
+  ChartBlockSchema as dR,
+  resolveChartAxes as dS,
+  validateUniqueIds as dT,
+  createChartBlock as dU,
+  isChartBlock as dV,
+  GeometryBlockSchema as dW,
+  createGeometryBlock as dX,
+  isGeometryBlock as dY,
+  createVerticalOperationBlock as da,
+  isVopCell as db,
+  isVopRow as dc,
+  isVopCarryRow as dd,
+  isVopSeparator as de,
+  isVerticalOperationBlock as df,
+  GRID_SYMMETRY_AXES as dg,
+  GRID_SYMMETRY_INTERACTIVE_AREAS as dh,
+  GRID_SYMMETRY_MAX_ROWS as di,
+  GRID_SYMMETRY_MAX_COLS as dj,
+  GRID_SYMMETRY_MIN_CELL_SIZE as dk,
+  GRID_SYMMETRY_MAX_CELL_SIZE as dl,
+  isCellInInteractiveArea as dm,
+  reflectGridSymmetryCell as dn,
+  computeGridSymmetryExpectedCells as dp,
+  computeGridSymmetryCellsToFill as dq,
+  GridSymmetryBlockSchema as dr,
+  createGridSymmetryBlock as ds,
+  isGridSymmetryBlock as dt,
+  CHART_TYPES as du,
+  CHART_AXIS_DEFAULTS as dv,
+  CHART_MAX_AXIS_TICKS as dw,
+  CHART_MAX_PICTO_SLOTS as dx,
+  ChartAxisSchema as dy,
+  createChartAxis as dz,
   parseSafe as e,
   toAST as f,
   getFractionKey as g,
@@ -22650,4 +23269,4 @@ export {
   extractVariables as y,
   validateBooleanExpression as z
 };
-//# sourceMappingURL=index-DBteHZkS.mjs.map
+//# sourceMappingURL=index-BtJRsuwL.mjs.map