lens-content-processor 0.26.0 → 0.28.0

package/dist/validator/math.js

@@ -0,0 +1,86 @@
+import katex from "katex";
+import { stripAuthoringMarkup } from "../authoring-markup.js";
+const INLINE_MATH_RE = /(?<!\$)\$(?!\$)([^\s$](?:[^$\n]*?[^\s$])?)\$(?![\d$])/g;
+function maskNonMathMarkdown(content) {
+    const authored = stripAuthoringMarkup(content);
+    const lines = authored.split("\n");
+    let inFrontmatter = lines[0]?.trim() === "---";
+    let inFence = null;
+    return lines
+        .map((line, index) => {
+        if (inFrontmatter) {
+            if (index > 0 && line.trim() === "---")
+                inFrontmatter = false;
+            return "";
+        }
+        const fence = line.match(/^\s*(`{3,}|~{3,})/);
+        if (fence) {
+            const marker = fence[1][0];
+            if (inFence === marker)
+                inFence = null;
+            else if (inFence === null)
+                inFence = marker;
+            return "";
+        }
+        if (inFence)
+            return "";
+        // Inline code is opaque to the markdown math plugins too.
+        return line.replace(/(`+)(.*?)\1/g, (match) => " ".repeat(match.length));
+    })
+        .join("\n");
+}
+function lineAt(content, offset) {
+    return content.slice(0, offset).split("\n").length;
+}
+function parseError(tex, file, line) {
+    try {
+        katex.renderToString(tex, { throwOnError: true, strict: "ignore" });
+        return null;
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        return {
+            file,
+            line,
+            severity: "error",
+            message: `Invalid LaTeX math: ${detail}`,
+            suggestion: "Fix the KaTeX syntax or replace/define the unsupported command in this math expression.",
+        };
+    }
+}
+/** Validate math exactly as isolated KaTeX expressions, matching Lens rendering. */
+export function validateMath(content, file) {
+    const source = maskNonMathMarkdown(content);
+    const errors = [];
+    const withoutDisplay = source.split("");
+    const displayRe = /\$\$([\s\S]*?)\$\$/g;
+    for (const match of source.matchAll(displayRe)) {
+        const offset = match.index ?? 0;
+        const error = parseError(match[1], file, lineAt(source, offset));
+        if (error)
+            errors.push(error);
+        for (let index = offset; index < offset + match[0].length; index += 1) {
+            if (withoutDisplay[index] !== "\n")
+                withoutDisplay[index] = " ";
+        }
+    }
+    const inlineSource = withoutDisplay.join("");
+    const unclosedDisplay = inlineSource.indexOf("$$");
+    if (unclosedDisplay !== -1) {
+        errors.push({
+            file,
+            line: lineAt(inlineSource, unclosedDisplay),
+            severity: "error",
+            message: "Invalid LaTeX math: unclosed $$ display-math delimiter.",
+            suggestion: "Add the closing $$ delimiter.",
+        });
+    }
+    for (const match of inlineSource.matchAll(INLINE_MATH_RE)) {
+        const offset = match.index ?? 0;
+        const error = parseError(match[1], file, lineAt(inlineSource, offset));
+        if (error)
+            errors.push(error);
+    }
+    return errors;
+}
+//# sourceMappingURL=math.js.map

package/dist/validator/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../src/validator/math.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lens-content-processor",
-  "version": "0.26.0",
+  "version": "0.28.0",
   "description": "Parser and validator for Lens educational content (Markdown modules, lenses, learning outcomes)",
   "type": "module",
   "main": "dist/index.js",
@@ -40,6 +40,7 @@
     "vitest": "^3.0.0"
   },
   "dependencies": {
+    "katex": "^0.16.47",
     "yaml": "^2.8.2"
   }
 }