@mathscan/math-exercise-engine 1.0.14 → 1.0.15

package/dist/index.js

@@ -25,6 +25,8 @@ const AST_TYPES = {
   INLINE_INPUT: "InlineInput",
   /** Inline fraction widget (numerator/denominator with optional inputs) */
   FRACTION: "Fraction",
+  /** Inline image element */
+  IMAGE: "Image",
   // ═══════════════════════════════════════════════════════════════════════════
   // Blocks
   // ═══════════════════════════════════════════════════════════════════════════
@@ -90,6 +92,8 @@ const JSON_TYPES = {
   COLOR_TEXT: "color-text",
   /** Bold text */
   BOLD_TEXT: "bold-text",
+  /** Inline image */
+  IMAGE: "image",
   /** Reference to a widget */
   WIDGET_REF: "widget-ref",
   /** Line break element */
@@ -280,6 +284,10 @@ const ANSWERS = chevrotain.createToken({
   name: "ANSWERS",
   pattern: /ANSWERS/
 });
+const IMAGE = chevrotain.createToken({
+  name: "IMAGE",
+  pattern: /IMAGE/
+});
 const NumberLiteral = chevrotain.createToken({
   name: "NumberLiteral",
   pattern: /-?\d+(\.\d+)?/
@@ -393,6 +401,7 @@ const allTokens = [
   MATCHER,
   ITEM,
   ANSWERS,
+  IMAGE,
   // Literals
   NumberLiteral,
   StringLiteral,
@@ -851,6 +860,8 @@ class MathExerciseParser extends chevrotain.CstParser {
         { ALT: () => this.SUBRULE(this.boldText) },
         // FRACTION (inline fraction widget)
         { ALT: () => this.SUBRULE(this.fraction) },
+        // IMAGE (inline image element)
+        { ALT: () => this.SUBRULE(this.image) },
         // W_S_I (inline input widget) — excluded in display-only contexts (e.g. MATCHER ITEM)
         { GATE: () => !displayOnly, ALT: () => this.SUBRULE(this.inlineInput) }
       ]);
@@ -882,6 +893,12 @@ class MathExerciseParser extends chevrotain.CstParser {
       this.SUBRULE(this.parameterList);
       this.CONSUME(RBracket);
     });
+    this.image = this.RULE("image", () => {
+      this.CONSUME(IMAGE);
+      this.CONSUME(LBracket);
+      this.SUBRULE(this.parameterList);
+      this.CONSUME(RBracket);
+    });
     this.inlineInput = this.RULE("inlineInput", () => {
       this.OR([
         { ALT: () => this.CONSUME(W_S_I, { LABEL: "stringInput" }) },
@@ -1072,6 +1089,17 @@ const FractionInlineSchema = zod.z.object({
   answer: zod.z.string().optional(),
   simplified: zod.z.boolean().default(true)
 });
+const IMAGE_SRC_SCHEME_RE$1 = /^(https?:\/\/|data:image\/)/i;
+const ImageInlineSchema = zod.z.object({
+  type: zod.z.literal(AST_TYPES.IMAGE),
+  name: zod.z.string().min(1),
+  src: zod.z.string().url().refine((s) => IMAGE_SRC_SCHEME_RE$1.test(s), {
+    message: "src must use http(s) or data:image scheme"
+  }),
+  alt: zod.z.string(),
+  width: zod.z.number().positive().optional(),
+  height: zod.z.number().positive().optional()
+});
 const InlineNodeSchema = zod.z.union([
   FreeTextInlineSchema,
   SpaceInlineSchema,
@@ -1079,7 +1107,8 @@ const InlineNodeSchema = zod.z.union([
   ColorTextInlineSchema,
   BoldTextInlineSchema,
   InlineInputWidgetSchema,
-  FractionInlineSchema
+  FractionInlineSchema,
+  ImageInlineSchema
 ]);
 function createFreeText(value) {
   return FreeTextInlineSchema.parse({
@@ -1132,6 +1161,15 @@ function createNumericInput(name, digits, answer) {
     answer
   });
 }
+function createImage(name, src, alt, options = {}) {
+  return ImageInlineSchema.parse({
+    type: AST_TYPES.IMAGE,
+    name,
+    src,
+    alt,
+    ...options
+  });
+}
 function createFraction(name, options = {}) {
   return FractionInlineSchema.parse({
     type: AST_TYPES.FRACTION,
@@ -1151,6 +1189,9 @@ function isInlineInput(value) {
 function isFraction(value) {
   return FractionInlineSchema.safeParse(value).success;
 }
+function isImage(value) {
+  return ImageInlineSchema.safeParse(value).success;
+}
 function isInlineNode(value) {
   return InlineNodeSchema.safeParse(value).success;
 }
@@ -1355,7 +1396,8 @@ const DisplayInlineNodeSchema = zod.z.union([
   HighlightedTextInlineSchema,
   ColorTextInlineSchema,
   BoldTextInlineSchema,
-  DisplayFractionInlineSchema
+  DisplayFractionInlineSchema,
+  ImageInlineSchema
 ]);
 const MatcherItemSchema = zod.z.object({
   type: zod.z.literal(AST_TYPES.MATCHER_ITEM),
@@ -1531,6 +1573,51 @@ const ExerciseDocumentSchema = zod.z.object({
   lines: zod.z.array(ContentBlockSchema),
   tools: zod.z.array(ToolNodeSchema).optional(),
   validation: ValidationNodeSchema.optional()
+}).superRefine((doc, ctx) => {
+  const seen = /* @__PURE__ */ new Set();
+  const record = (name, path) => {
+    if (seen.has(name)) {
+      ctx.addIssue({
+        code: zod.z.ZodIssueCode.custom,
+        message: `Duplicate name "${name}" — widget/image names must be unique across the document`,
+        path
+      });
+    } else {
+      seen.add(name);
+    }
+  };
+  const visitInlines = (inlines, basePath) => {
+    inlines.forEach((inline, i) => {
+      if (inline.type === AST_TYPES.INLINE_INPUT || inline.type === AST_TYPES.FRACTION || inline.type === AST_TYPES.IMAGE) {
+        record(inline.name, [...basePath, i, "name"]);
+      }
+    });
+  };
+  doc.lines.forEach((block, bi) => {
+    if (block.type === AST_TYPES.LINE_BLOCK) {
+      visitInlines(block.inlines, ["lines", bi, "inlines"]);
+    } else if (block.type === AST_TYPES.TABLE_BLOCK) {
+      block.rows.forEach((row, ri) => {
+        row.cells.forEach((cell, ci) => {
+          visitInlines(cell.inlines, ["lines", bi, "rows", ri, "cells", ci, "inlines"]);
+        });
+      });
+    } else if (block.type === AST_TYPES.NUMBER_LINE_BLOCK) {
+      block.positions.forEach((pos, pi) => {
+        visitInlines(pos.inlines, ["lines", bi, "positions", pi, "inlines"]);
+      });
+    } else if (block.type === AST_TYPES.MATCHER_BLOCK) {
+      const m = block;
+      record(m.name, ["lines", bi, "name"]);
+      m.rows.forEach((row, ri) => {
+        row.items.forEach((item, ii) => {
+          visitInlines(item.inlines, ["lines", bi, "rows", ri, "items", ii, "inlines"]);
+        });
+      });
+    } else if (block.type === AST_TYPES.RADIO_OPTIONS) {
+      record(block.name, ["lines", bi, "name"]);
+    }
+  });
 });
 function createExerciseDocument(question, lines, validation, tools) {
   return ExerciseDocumentSchema.parse({
@@ -1773,6 +1860,9 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     if (ctx.fraction) {
       return this.visit(ctx.fraction);
     }
+    if (ctx.image) {
+      return this.visit(ctx.image);
+    }
     if (ctx.inlineInput) {
       return this.visit(ctx.inlineInput);
     }
@@ -1815,6 +1905,15 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     const simplified = params.simplified !== void 0 ? params.simplified : void 0;
     return createFraction(name, { numerator, denominator, answer, simplified });
   }
+  image(ctx) {
+    const params = this.visit(ctx.parameterList);
+    const name = params.name;
+    const src = params.src;
+    const alt = params.alt;
+    const width = params.width;
+    const height = params.height;
+    return createImage(name, src, alt, { width, height });
+  }
   inlineInput(ctx) {
     const params = this.visit(ctx.parameterList);
     const name = params.name;
@@ -1973,6 +2072,18 @@ const BoldTextSchema = zod.z.object({
   value: zod.z.string(),
   highlight: zod.z.tuple([zod.z.number(), zod.z.number()]).optional()
 });
+const IMAGE_SRC_SCHEME_RE = /^(https?:\/\/|data:image\/)/i;
+const ImageItemSchema = zod.z.object({
+  id: zod.z.string(),
+  type: zod.z.literal(JSON_TYPES.IMAGE),
+  name: zod.z.string().min(1),
+  src: zod.z.string().url().refine((s) => IMAGE_SRC_SCHEME_RE.test(s), {
+    message: "src must use http(s) or data:image scheme"
+  }),
+  alt: zod.z.string(),
+  width: zod.z.number().positive().optional(),
+  height: zod.z.number().positive().optional()
+});
 const SpaceItemSchema = zod.z.object({
   id: zod.z.string(),
   type: zod.z.literal(JSON_TYPES.SPACE)
@@ -1995,6 +2106,7 @@ const LayoutItemSchema = zod.z.lazy(
     HighlightedTextSchema,
     ColorTextSchema,
     BoldTextSchema,
+    ImageItemSchema,
     SpaceItemSchema,
     LinebreakSchema,
     GroupItemSchema,
@@ -2181,6 +2293,9 @@ function isColorText(item) {
 function isBoldText(item) {
   return item.type === JSON_TYPES.BOLD_TEXT;
 }
+function isImageItem(item) {
+  return item.type === JSON_TYPES.IMAGE;
+}
 function isSpaceItem(item) {
   return item.type === JSON_TYPES.SPACE;
 }
@@ -2533,6 +2648,16 @@ function transformInline(inline, idGenerator) {
         type: JSON_TYPES.WIDGET_REF,
         widgetId: inline.name
       };
+    case AST_TYPES.IMAGE:
+      return {
+        id: idGenerator.generate(JSON_TYPES.IMAGE),
+        type: JSON_TYPES.IMAGE,
+        name: inline.name,
+        src: inline.src,
+        alt: inline.alt,
+        ...inline.width !== void 0 && { width: inline.width },
+        ...inline.height !== void 0 && { height: inline.height }
+      };
     default:
       throw new Error(`Unknown inline type: ${inline.type}`);
   }
@@ -13756,6 +13881,18 @@ const LayoutRenderer = ({
       }
       return /* @__PURE__ */ jsxRuntime.jsx("strong", { className: "bold-text text-item", dir: dirAttr, children: item.value });
     }
+    case JSON_TYPES.IMAGE:
+      return /* @__PURE__ */ jsxRuntime.jsx(
+        "img",
+        {
+          className: "image-item text-item",
+          src: item.src,
+          alt: item.alt,
+          ...item.width !== void 0 && { width: item.width },
+          ...item.height !== void 0 && { height: item.height },
+          loading: "lazy"
+        }
+      );
     case JSON_TYPES.WIDGET_REF: {
       const widget = widgets[item.widgetId];
       if (!widget) return null;
@@ -14130,6 +14267,8 @@ exports.FreeTextInlineSchema = FreeTextInlineSchema;
 exports.GroupItemSchema = GroupItemSchema;
 exports.HighlightedTextInlineSchema = HighlightedTextInlineSchema;
 exports.HighlightedTextSchema = HighlightedTextSchema;
+exports.ImageInlineSchema = ImageInlineSchema;
+exports.ImageItemSchema = ImageItemSchema;
 exports.InlineInputJSONSchema = InlineInputJSONSchema;
 exports.InlineInputWidgetSchema = InlineInputWidgetSchema;
 exports.InlineNodeSchema = InlineNodeSchema;
@@ -14179,6 +14318,7 @@ exports.createExpressionValidation = createExpressionValidation;
 exports.createFraction = createFraction;
 exports.createFreeText = createFreeText;
 exports.createHighlightedText = createHighlightedText;
+exports.createImage = createImage;
 exports.createLineBlock = createLineBlock;
 exports.createMatcherBlock = createMatcherBlock;
 exports.createMatcherItem = createMatcherItem;
@@ -14206,6 +14346,8 @@ exports.isFractionKey = isFractionKey;
 exports.isFreeText = isFreeText;
 exports.isGroupItem = isGroupItem;
 exports.isHighlightedText = isHighlightedText;
+exports.isImage = isImage;
+exports.isImageItem = isImageItem;
 exports.isInlineInput = isInlineInput;
 exports.isInlineInputJSON = isInlineInputJSON;
 exports.isInlineNode = isInlineNode;