@mathscan/math-exercise-engine 1.0.5 → 1.0.7

package/dist/index.mjs

@@ -27,6 +27,12 @@ const AST_TYPES = {
   TEXT_BLOCK: "TextBlock",
   /** Line containing inline elements */
   LINE_BLOCK: "LineBlock",
+  /** Table layout block */
+  TABLE_BLOCK: "TableBlock",
+  /** Row within a table */
+  TABLE_ROW: "TableRow",
+  /** Cell within a table row */
+  TABLE_CELL: "TableCell",
   // ═══════════════════════════════════════════════════════════════════════════
   // Tools
   // ═══════════════════════════════════════════════════════════════════════════
@@ -71,6 +77,12 @@ const JSON_TYPES = {
   GROUP: "group",
   /** Operator symbol */
   OPERATOR: "operator",
+  /** Table layout block */
+  TABLE: "table",
+  /** Row within a table */
+  TABLE_ROW: "table-row",
+  /** Cell within a table */
+  TABLE_CELL: "table-cell",
   // ═══════════════════════════════════════════════════════════════════════════
   // Widget Types
   // ═══════════════════════════════════════════════════════════════════════════
@@ -162,6 +174,18 @@ const NUMERIC_INPUT = createToken({
   name: "NUMERIC_INPUT",
   pattern: /NUMERIC_INPUT/
 });
+const TABLE = createToken({
+  name: "TABLE",
+  pattern: /TABLE/
+});
+const ROW = createToken({
+  name: "ROW",
+  pattern: /ROW/
+});
+const CELL = createToken({
+  name: "CELL",
+  pattern: /CELL/
+});
 const NumberLiteral = createToken({
   name: "NumberLiteral",
   pattern: /-?\d+(\.\d+)?/
@@ -229,9 +253,17 @@ const Comma = createToken({
   name: "Comma",
   pattern: /,/
 });
+const LBrace = createToken({
+  name: "LBrace",
+  pattern: /\{/
+});
+const RBrace = createToken({
+  name: "RBrace",
+  pattern: /\}/
+});
 const FreeText = createToken({
   name: "FreeText",
-  pattern: /(?:[^A-Z\n\r \t+\-−×*÷/=<>?()\[\],]|(?![A-Z_]+\[)[A-Z])+/,
+  pattern: /(?:[^A-Z\n\r \t+\-−×*÷/=<>?()\[\],{}]|(?![A-Z_]+[\[{])[A-Z])+/,
   line_breaks: false
 });
 const allTokens = [
@@ -255,6 +287,9 @@ const allTokens = [
   WIDGET_ANSWER,
   W_N_I,
   NUMERIC_INPUT,
+  TABLE,
+  ROW,
+  CELL,
   // Literals
   NumberLiteral,
   StringLiteral,
@@ -275,6 +310,8 @@ const allTokens = [
   LBracket,
   RBracket,
   Comma,
+  LBrace,
+  RBrace,
   // FreeText - LAST (fallback for natural text)
   FreeText
 ];
@@ -369,7 +406,7 @@ class MathExerciseParser extends CstParser {
         this.SUBRULE(this.question);
       });
       this.MANY2(() => {
-        this.SUBRULE(this.line);
+        this.SUBRULE(this.contentBlock);
       });
       this.MANY3(() => {
         this.SUBRULE(this.tool);
@@ -394,6 +431,116 @@ class MathExerciseParser extends CstParser {
         ]);
       });
     });
+    this.contentBlock = this.RULE("contentBlock", () => {
+      this.OR([
+        {
+          GATE: this.BACKTRACK(this.table),
+          ALT: () => this.SUBRULE(this.table)
+        },
+        { ALT: () => this.SUBRULE(this.line) }
+      ]);
+    });
+    this.table = this.RULE("table", () => {
+      this.MANY(() => {
+        this.OR2([
+          { ALT: () => this.CONSUME(Space) },
+          { ALT: () => this.CONSUME(Newline) }
+        ]);
+      });
+      this.CONSUME(TABLE);
+      this.CONSUME(LBracket);
+      this.SUBRULE(this.parameterList);
+      this.CONSUME(RBracket);
+      this.MANY2(() => {
+        this.OR3([
+          { ALT: () => this.CONSUME2(Space) },
+          { ALT: () => this.CONSUME2(Newline) }
+        ]);
+      });
+      this.CONSUME(LBrace);
+      this.MANY3(() => {
+        this.OR4([
+          { ALT: () => this.CONSUME3(Space) },
+          { ALT: () => this.CONSUME3(Newline) }
+        ]);
+      });
+      this.AT_LEAST_ONE(() => {
+        this.SUBRULE(this.row);
+      });
+      this.CONSUME(RBrace);
+      this.MANY4(() => {
+        this.OR5([
+          { ALT: () => this.CONSUME4(Newline) },
+          { ALT: () => this.CONSUME4(Space) }
+        ]);
+      });
+    });
+    this.row = this.RULE("row", () => {
+      this.MANY(() => {
+        this.OR([
+          { ALT: () => this.CONSUME(Space) },
+          { ALT: () => this.CONSUME(Newline) }
+        ]);
+      });
+      this.CONSUME(ROW);
+      this.MANY2(() => {
+        this.OR2([
+          { ALT: () => this.CONSUME2(Space) },
+          { ALT: () => this.CONSUME2(Newline) }
+        ]);
+      });
+      this.CONSUME(LBrace);
+      this.MANY3(() => {
+        this.OR3([
+          { ALT: () => this.CONSUME3(Space) },
+          { ALT: () => this.CONSUME3(Newline) }
+        ]);
+      });
+      this.AT_LEAST_ONE(() => {
+        this.SUBRULE(this.cell);
+      });
+      this.CONSUME(RBrace);
+      this.MANY4(() => {
+        this.OR4([
+          { ALT: () => this.CONSUME4(Space) },
+          { ALT: () => this.CONSUME4(Newline) }
+        ]);
+      });
+    });
+    this.cell = this.RULE("cell", () => {
+      this.MANY(() => {
+        this.OR([
+          { ALT: () => this.CONSUME(Space) },
+          { ALT: () => this.CONSUME(Newline) }
+        ]);
+      });
+      this.CONSUME(CELL);
+      this.OPTION(() => {
+        this.CONSUME(LBracket);
+        this.SUBRULE(this.parameterList);
+        this.CONSUME(RBracket);
+      });
+      this.MANY2(() => {
+        this.OR2([
+          { ALT: () => this.CONSUME2(Space) },
+          { ALT: () => this.CONSUME2(Newline) }
+        ]);
+      });
+      this.CONSUME(LBrace);
+      this.MANY3(() => {
+        this.OR3([
+          { ALT: () => this.SUBRULE(this.inlineElement) },
+          { ALT: () => this.CONSUME3(Newline) }
+        ]);
+      });
+      this.CONSUME(RBrace);
+      this.MANY4(() => {
+        this.OR4([
+          { ALT: () => this.CONSUME4(Space) },
+          { ALT: () => this.CONSUME4(Newline) }
+        ]);
+      });
+    });
     this.line = this.RULE("line", () => {
       this.MANY(() => {
         this.CONSUME(Space);
@@ -731,6 +878,40 @@ function isTextBlock(value) {
 function isLineBlock(value) {
   return LineBlockSchema.safeParse(value).success;
 }
+const TableCellSchema = z.object({
+  type: z.literal(AST_TYPES.TABLE_CELL),
+  colspan: z.number().int().positive().optional(),
+  inlines: z.array(InlineNodeSchema)
+});
+function createTableCell(inlines, colspan) {
+  return TableCellSchema.parse({
+    type: AST_TYPES.TABLE_CELL,
+    colspan,
+    inlines
+  });
+}
+const TableRowSchema = z.object({
+  type: z.literal(AST_TYPES.TABLE_ROW),
+  cells: z.array(TableCellSchema).min(1)
+});
+function createTableRow(cells) {
+  return TableRowSchema.parse({
+    type: AST_TYPES.TABLE_ROW,
+    cells
+  });
+}
+const TableBlockSchema = z.object({
+  type: z.literal(AST_TYPES.TABLE_BLOCK),
+  cols: z.number().int().positive(),
+  rows: z.array(TableRowSchema).min(1)
+});
+function createTableBlock(cols, rows) {
+  return TableBlockSchema.parse({
+    type: AST_TYPES.TABLE_BLOCK,
+    cols,
+    rows
+  });
+}
 const DragOptionsToolSchema = z.object({
   type: z.literal(AST_TYPES.DRAG_OPTIONS),
   options: z.array(z.string()).min(1)
@@ -797,10 +978,11 @@ function isExpressionValidation(value) {
 function isValidationNode(value) {
   return ValidationNodeSchema.safeParse(value).success;
 }
+const ContentBlockSchema = z.union([LineBlockSchema, TableBlockSchema]);
 const ExerciseDocumentSchema = z.object({
   type: z.literal(AST_TYPES.EXERCISE_DOCUMENT),
   question: TextBlockSchema.optional(),
-  lines: z.array(LineBlockSchema),
+  lines: z.array(ContentBlockSchema),
   tools: z.array(ToolNodeSchema).optional(),
   validation: ValidationNodeSchema
 });
@@ -827,10 +1009,10 @@ class NaturalDSLVisitor extends BaseCstVisitor {
   // ═══════════════════════════════════════════════════════════════════════════
   exerciseDocument(ctx) {
     const question = ctx.question ? this.visit(ctx.question) : void 0;
-    const lines = ctx.line ? ctx.line.map((l) => this.visit(l)) : [];
+    const contentBlocks = ctx.contentBlock ? ctx.contentBlock.map((cb) => this.visit(cb)) : [];
     const tools = ctx.tool ? ctx.tool.map((t) => this.visit(t)) : [];
     const validation = this.visit(ctx.validation);
-    return createExerciseDocument(question, lines, validation, tools);
+    return createExerciseDocument(question, contentBlocks, validation, tools);
   }
   // ═══════════════════════════════════════════════════════════════════════════
   // Question Block
@@ -841,6 +1023,33 @@ class NaturalDSLVisitor extends BaseCstVisitor {
     return createTextBlock(value);
   }
   // ═══════════════════════════════════════════════════════════════════════════
+  // Content Block
+  // ═══════════════════════════════════════════════════════════════════════════
+  contentBlock(ctx) {
+    if (ctx.table) return this.visit(ctx.table);
+    if (ctx.line) return this.visit(ctx.line);
+    throw new Error("Unknown content block");
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
+  // Table Block
+  // ═══════════════════════════════════════════════════════════════════════════
+  table(ctx) {
+    const params = this.visit(ctx.parameterList);
+    const cols = params.cols;
+    const rows = ctx.row.map((r) => this.visit(r));
+    return createTableBlock(cols, rows);
+  }
+  row(ctx) {
+    const cells = ctx.cell.map((c) => this.visit(c));
+    return createTableRow(cells);
+  }
+  cell(ctx) {
+    const params = ctx.parameterList ? this.visit(ctx.parameterList) : {};
+    const colspan = params.colspan;
+    const inlines = ctx.inlineElement ? ctx.inlineElement.map((elem) => this.visit(elem)) : [];
+    return createTableCell(inlines, colspan);
+  }
+  // ═══════════════════════════════════════════════════════════════════════════
   // Line Block
   // ═══════════════════════════════════════════════════════════════════════════
   line(ctx) {
@@ -1112,6 +1321,10 @@ const BoldTextSchema = z.object({
   value: z.string(),
   highlight: z.tuple([z.number(), z.number()]).optional()
 });
+const SpaceItemSchema = z.object({
+  id: z.string(),
+  type: z.literal(JSON_TYPES.SPACE)
+});
 const LinebreakSchema = z.object({
   id: z.string(),
   type: z.literal(JSON_TYPES.LINEBREAK)
@@ -1130,9 +1343,11 @@ const LayoutItemSchema = z.lazy(
     HighlightedTextSchema,
     ColorTextSchema,
     BoldTextSchema,
+    SpaceItemSchema,
     LinebreakSchema,
     GroupItemSchema,
-    OperatorItemSchema
+    OperatorItemSchema,
+    TableItemSchema
   ])
 );
 const GroupItemSchema = z.object({
@@ -1140,6 +1355,23 @@ const GroupItemSchema = z.object({
   type: z.literal(JSON_TYPES.GROUP),
   items: z.array(LayoutItemSchema)
 });
+const TableCellItemSchema = z.object({
+  id: z.string(),
+  type: z.literal(JSON_TYPES.TABLE_CELL),
+  colspan: z.number().int().positive().optional(),
+  items: z.array(LayoutItemSchema)
+});
+const TableRowItemSchema = z.object({
+  id: z.string(),
+  type: z.literal(JSON_TYPES.TABLE_ROW),
+  cells: z.array(TableCellItemSchema)
+});
+const TableItemSchema = z.object({
+  id: z.string(),
+  type: z.literal(JSON_TYPES.TABLE),
+  cols: z.number().int().positive(),
+  rows: z.array(TableRowItemSchema)
+});
 const StringInputJSONSchema = z.object({
   type: z.literal(JSON_TYPES.INLINE_INPUT),
   inputType: z.literal(INPUT_TYPES.STRING),
@@ -1218,6 +1450,9 @@ function isColorText(item) {
 function isBoldText(item) {
   return item.type === JSON_TYPES.BOLD_TEXT;
 }
+function isSpaceItem(item) {
+  return item.type === JSON_TYPES.SPACE;
+}
 function isLinebreak(item) {
   return item.type === JSON_TYPES.LINEBREAK;
 }
@@ -1227,6 +1462,15 @@ function isGroupItem(item) {
 function isOperatorItem(item) {
   return item.type === JSON_TYPES.OPERATOR;
 }
+function isTableItem(item) {
+  return item.type === JSON_TYPES.TABLE;
+}
+function isTableRowItem(item) {
+  return item.type === JSON_TYPES.TABLE_ROW;
+}
+function isTableCellItem(item) {
+  return item.type === JSON_TYPES.TABLE_CELL;
+}
 function isInlineInputJSON(widget) {
   return widget.type === JSON_TYPES.INLINE_INPUT;
 }
@@ -1257,31 +1501,34 @@ function toJSON(ast) {
       value: ast.question.value
     });
   }
-  for (const line of ast.lines) {
-    const lineItems = transformLine(line, idGenerator);
-    layout.push(...lineItems);
+  for (const block of ast.lines) {
+    if (block.type === AST_TYPES.TABLE_BLOCK) {
+      layout.push(transformTable(block, idGenerator));
+    } else {
+      const lineItems = transformLine(block, idGenerator);
+      layout.push(...lineItems);
+    }
   }
   const widgets = {};
   const answers = {};
-  for (const line of ast.lines) {
-    for (const inline of line.inlines) {
-      if (inline.type === AST_TYPES.INLINE_INPUT) {
-        if (inline.inputType === INPUT_TYPES.STRING) {
-          widgets[inline.name] = {
-            type: JSON_TYPES.INLINE_INPUT,
-            inputType: INPUT_TYPES.STRING,
-            length: inline.length
-          };
-        } else {
-          widgets[inline.name] = {
-            type: JSON_TYPES.INLINE_INPUT,
-            inputType: INPUT_TYPES.NUMERIC,
-            digits: inline.digits
-          };
-        }
-        if (inline.answer !== void 0) {
-          answers[inline.name] = inline.answer;
-        }
+  const allInlines = collectAllInlines(ast.lines);
+  for (const inline of allInlines) {
+    if (inline.type === AST_TYPES.INLINE_INPUT) {
+      if (inline.inputType === INPUT_TYPES.STRING) {
+        widgets[inline.name] = {
+          type: JSON_TYPES.INLINE_INPUT,
+          inputType: INPUT_TYPES.STRING,
+          length: inline.length
+        };
+      } else {
+        widgets[inline.name] = {
+          type: JSON_TYPES.INLINE_INPUT,
+          inputType: INPUT_TYPES.NUMERIC,
+          digits: inline.digits
+        };
+      }
+      if (inline.answer !== void 0) {
+        answers[inline.name] = inline.answer;
       }
     }
   }
@@ -1310,6 +1557,48 @@ function toJSON(ast) {
     validation
   };
 }
+function collectAllInlines(blocks) {
+  const result = [];
+  for (const block of blocks) {
+    if (block.type === AST_TYPES.LINE_BLOCK) {
+      result.push(...block.inlines);
+    } else if (block.type === AST_TYPES.TABLE_BLOCK) {
+      for (const row of block.rows) {
+        for (const cell of row.cells) {
+          result.push(...cell.inlines);
+        }
+      }
+    }
+  }
+  return result;
+}
+function transformTable(table, idGenerator) {
+  const rows = table.rows.map((row) => {
+    const cells = row.cells.map((cell) => {
+      const items = cell.inlines.map((inline) => transformInline(inline, idGenerator));
+      const cellItem = {
+        id: idGenerator.generate(JSON_TYPES.TABLE_CELL),
+        type: JSON_TYPES.TABLE_CELL,
+        items
+      };
+      if (cell.colspan !== void 0) {
+        cellItem.colspan = cell.colspan;
+      }
+      return cellItem;
+    });
+    return {
+      id: idGenerator.generate(JSON_TYPES.TABLE_ROW),
+      type: JSON_TYPES.TABLE_ROW,
+      cells
+    };
+  });
+  return {
+    id: idGenerator.generate(JSON_TYPES.TABLE),
+    type: JSON_TYPES.TABLE,
+    cols: table.cols,
+    rows
+  };
+}
 function transformLine(line, idGenerator) {
   const items = [];
   for (const inline of line.inlines) {
@@ -5981,7 +6270,7 @@ function itemContainsLatin(item) {
   return false;
 }
 function isTextItem(item) {
-  return item.type === JSON_TYPES.TEXT || item.type === JSON_TYPES.HIGHLIGHTED_TEXT || item.type === JSON_TYPES.OPERATOR || item.type === JSON_TYPES.SPACE || item.type === JSON_TYPES.GROUP;
+  return item.type === JSON_TYPES.TEXT || item.type === JSON_TYPES.HIGHLIGHTED_TEXT || item.type === JSON_TYPES.BOLD_TEXT || item.type === JSON_TYPES.COLOR_TEXT || item.type === JSON_TYPES.OPERATOR || item.type === JSON_TYPES.SPACE || item.type === JSON_TYPES.GROUP;
 }
 function groupLineItems(items) {
   const groups = [];
@@ -6096,6 +6385,27 @@ const LayoutRenderer = ({
         },
         subItem.id
       )) });
+    case JSON_TYPES.TABLE:
+      return /* @__PURE__ */ jsx("div", { className: "exercise-table-container", children: /* @__PURE__ */ jsx("table", { className: "exercise-table", children: /* @__PURE__ */ jsx("tbody", { children: item.rows.map((row) => /* @__PURE__ */ jsx("tr", { className: "exercise-table-row", children: row.cells.map((cell) => /* @__PURE__ */ jsx(
+        "td",
+        {
+          className: "exercise-table-cell",
+          colSpan: cell.colspan || 1,
+          children: cell.items.map((subItem) => /* @__PURE__ */ jsx(
+            LayoutRenderer,
+            {
+              item: subItem,
+              widgets,
+              values,
+              droppedInputs,
+              onChange,
+              onInputFocus
+            },
+            subItem.id
+          ))
+        },
+        cell.id
+      )) }, row.id)) }) }) });
     default:
       return null;
   }
@@ -6169,6 +6479,20 @@ const ExerciseRenderer = forwardRef(({
         });
         continue;
       }
+      if (item.type === JSON_TYPES.TABLE) {
+        if (currentGroup.length > 0) {
+          const hasArabic = currentGroup.some((item2) => itemContainsArabic(item2));
+          const subGroups = groupLineItems(currentGroup);
+          groups.push({ items: currentGroup, hasArabic, subGroups });
+          currentGroup = [];
+        }
+        groups.push({
+          items: [item],
+          hasArabic: false,
+          subGroups: []
+        });
+        continue;
+      }
       if (item.type === JSON_TYPES.LINEBREAK) {
         if (currentGroup.length > 0) {
           const hasArabic = currentGroup.some((item2) => itemContainsArabic(item2));
@@ -38292,6 +38616,7 @@ export {
   BoldTextSchema,
   ColorTextInlineSchema,
   ColorTextSchema,
+  ContentBlockSchema,
   DragOptionsJSONSchema,
   DragOptionsToolSchema,
   EngineError,
@@ -38321,6 +38646,10 @@ export {
   QuestionTextSchema,
   SimpleValidationSchema,
   SpaceInlineSchema,
+  SpaceItemSchema,
+  TableCellItemSchema,
+  TableItemSchema,
+  TableRowItemSchema,
   TextBlockSchema,
   TextItemSchema,
   ToolNodeSchema,
@@ -38371,6 +38700,10 @@ export {
   isQuestionText,
   isSimpleValidation,
   isSpace,
+  isSpaceItem,
+  isTableCellItem,
+  isTableItem,
+  isTableRowItem,
   isTextBlock,
   isTextItem$1 as isTextItem,
   isToolNode,