lens-content-processor 0.28.0 → 0.33.0

package/dist/validator/math.js

@@ -1,8 +1,8 @@
 import katex from "katex";
-import { stripAuthoringMarkup } from "../authoring-markup.js";
+import { stripAuthoringMarkupForValidation } from "../authoring-markup.js";
 const INLINE_MATH_RE = /(?<!\$)\$(?!\$)([^\s$](?:[^$\n]*?[^\s$])?)\$(?![\d$])/g;
 function maskNonMathMarkdown(content) {
-    const authored = stripAuthoringMarkup(content);
+    const authored = stripAuthoringMarkupForValidation(content);
     const lines = authored.split("\n");
     let inFrontmatter = lines[0]?.trim() === "---";
     let inFence = null;
@@ -32,9 +32,26 @@ function maskNonMathMarkdown(content) {
 function lineAt(content, offset) {
     return content.slice(0, offset).split("\n").length;
 }
-function parseError(tex, file, line) {
+/** Remove Markdown container prefixes while preserving every offset/line. */
+function normalizeMathContainers(content) {
+    return content
+        .split("\n")
+        .map((line) => {
+        let normalized = line.replace(/^([ \t]*(?:>[ \t]*)+)/, (prefix) => " ".repeat(prefix.length));
+        // A display opener may be the content of a list item or footnote.
+        // Continuation and closing lines are already represented by indentation.
+        normalized = normalized.replace(/^([ \t]*(?:(?:[-+*]|\d+[.)])[ \t]+|\[\^[^\]\n]+\]:[ \t]+))(?=\$\$)/, (prefix) => " ".repeat(prefix.length));
+        return normalized;
+    })
+        .join("\n");
+}
+function parseError(tex, file, line, displayMode) {
     try {
-        katex.renderToString(tex, { throwOnError: true, strict: "ignore" });
+        katex.renderToString(tex, {
+            throwOnError: true,
+            strict: "ignore",
+            displayMode,
+        });
         return null;
     }
     catch (error) {
@@ -48,17 +65,57 @@ function parseError(tex, file, line) {
         };
     }
 }
+function emptyMathError(file, line) {
+    return {
+        file,
+        line,
+        code: "article.math-empty",
+        severity: "error",
+        message: "Empty math delimiters render no equation.",
+        suggestion: "Remove the empty delimiters or put the intended equation inside them.",
+    };
+}
 /** Validate math exactly as isolated KaTeX expressions, matching Lens rendering. */
 export function validateMath(content, file) {
-    const source = maskNonMathMarkdown(content);
+    const source = normalizeMathContainers(maskNonMathMarkdown(content));
     const errors = [];
     const withoutDisplay = source.split("");
     const displayRe = /\$\$([\s\S]*?)\$\$/g;
+    const isArticle = file.startsWith("articles/") || file.includes("/articles/");
+    // Some converters preserve TeX-style delimiters even though Markdown math
+    // normally uses dollars. Detect their empty form explicitly; non-empty
+    // forms remain visible converter residue and are handled by prose checks.
+    for (const match of source.matchAll(/\\(?:\(\s*\\\)|\[\s*\\\])/g)) {
+        errors.push(emptyMathError(file, lineAt(source, match.index ?? 0)));
+    }
+    // Standalone display fences are an article-import quality convention, not a
+    // Markdown/KaTeX validity requirement. Other authored content may use valid
+    // single-line display math without failing vault-wide CI.
+    if (isArticle) {
+        for (const [index, line] of source.split("\n").entries()) {
+            const delimiters = line.match(/\$\$/g)?.length ?? 0;
+            if (delimiters > 0 && line.trim() !== "$$") {
+                errors.push({
+                    file,
+                    line: index + 1,
+                    code: "article.math-display-delimiter-placement",
+                    severity: "error",
+                    message: "Invalid LaTeX math: $$ delimiters must be on their own lines.",
+                    suggestion: "Put the opening and closing $$ delimiters on separate lines without equation text beside them.",
+                });
+            }
+        }
+    }
     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);
+        if (!match[1].trim()) {
+            errors.push(emptyMathError(file, lineAt(source, offset)));
+        }
+        else {
+            const error = parseError(match[1], file, lineAt(source, offset), true);
+            if (error)
+                errors.push(error);
+        }
         for (let index = offset; index < offset + match[0].length; index += 1) {
             if (withoutDisplay[index] !== "\n")
                 withoutDisplay[index] = " ";
@@ -77,7 +134,7 @@ export function validateMath(content, file) {
     }
     for (const match of inlineSource.matchAll(INLINE_MATH_RE)) {
         const offset = match.index ?? 0;
-        const error = parseError(match[1], file, lineAt(inlineSource, offset));
+        const error = parseError(match[1], file, lineAt(inlineSource, offset), false);
         if (error)
             errors.push(error);
     }

package/dist/validator/math.js.map

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

package/dist/validator/output-integrity.js

@@ -1,3 +1,4 @@
+import { getSourceLine } from '../source-location.js';
 /**
  * Broad safety-net validation on the flattened output.
  * Catches empty sections (no segments) and empty segments (no content)
@@ -6,12 +7,14 @@
 export function validateOutputIntegrity(modules, slugToPath) {
     const errors = [];
     for (const module of modules) {
-        const file = slugToPath?.get(module.slug) ?? module.slug;
+        const moduleFile = slugToPath?.get(module.slug) ?? module.slug;
         for (const section of module.sections) {
+            const file = section.sourcePath ?? moduleFile;
             const sectionLabel = section.meta.title ?? section.type;
             if (section.segments.length === 0) {
                 errors.push({
                     file,
+                    line: getSourceLine(section),
                     message: `Section "${sectionLabel}" has no segments`,
                     severity: 'error',
                 });
@@ -24,6 +27,7 @@ export function validateOutputIntegrity(modules, slugToPath) {
                         if (!segment.content?.trim()) {
                             errors.push({
                                 file,
+                                line: getSourceLine(segment) ?? getSourceLine(section),
                                 message: `Empty text segment in "${sectionLabel}" (segment ${i + 1})`,
                                 severity: 'error',
                             });
@@ -33,6 +37,7 @@ export function validateOutputIntegrity(modules, slugToPath) {
                         if (!segment.content?.trim()) {
                             errors.push({
                                 file,
+                                line: getSourceLine(segment) ?? getSourceLine(section),
                                 message: `Empty article segment in "${sectionLabel}" (segment ${i + 1})`,
                                 severity: 'error',
                             });
@@ -42,6 +47,7 @@ export function validateOutputIntegrity(modules, slugToPath) {
                         if (!segment.transcript?.length) {
                             errors.push({
                                 file,
+                                line: getSourceLine(segment) ?? getSourceLine(section),
                                 message: `Empty video transcript in "${sectionLabel}" (segment ${i + 1})`,
                                 severity: 'error',
                             });

package/dist/validator/output-integrity.js.map

@@ -1 +1 @@
-{"version":3,"file":"output-integrity.js","sourceRoot":"","sources":["../../src/validator/output-integrity.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA0B,EAC1B,UAAgC;IAEhC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QAEzD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAExD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,OAAO,EAAE,YAAY,YAAY,mBAAmB;oBACpD,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAEpC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,MAAM;wBACT,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,0BAA0B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACrE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,SAAS;wBACZ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,6BAA6B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACxE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,OAAO;wBACV,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;4BAChC,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,OAAO,EAAE,8BAA8B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACzE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,8CAA8C;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"output-integrity.js","sourceRoot":"","sources":["../../src/validator/output-integrity.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA0B,EAC1B,UAAgC;IAEhC,MAAM,MAAM,GAAmB,EAAE,CAAC;IAElC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,UAAU,GAAG,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC;QAE/D,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,IAAI,UAAU,CAAC;YAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YAExD,IAAI,OAAO,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI;oBACJ,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC;oBAC5B,OAAO,EAAE,YAAY,YAAY,mBAAmB;oBACpD,QAAQ,EAAE,OAAO;iBAClB,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;gBAEpC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,KAAK,MAAM;wBACT,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;gCACtD,OAAO,EAAE,0BAA0B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACrE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,SAAS;wBACZ,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;4BAC7B,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;gCACtD,OAAO,EAAE,6BAA6B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACxE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,KAAK,OAAO;wBACV,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;4BAChC,MAAM,CAAC,IAAI,CAAC;gCACV,IAAI;gCACJ,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,OAAO,CAAC;gCACtD,OAAO,EAAE,8BAA8B,YAAY,cAAc,CAAC,GAAG,CAAC,GAAG;gCACzE,QAAQ,EAAE,OAAO;6BAClB,CAAC,CAAC;wBACL,CAAC;wBACD,MAAM;oBACR,8CAA8C;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/validator/same-lens-links.d.ts

@@ -0,0 +1,4 @@
+import type { ContentError } from "../index.js";
+import type { ParsedLens } from "../parser/lens.js";
+/** Validate canonical same-Lens links against every authored text segment. */
+export declare function validateSameLensLinks(lens: ParsedLens, file: string, source: string, lineOffset?: number): ContentError[];

package/dist/validator/same-lens-links.js

@@ -0,0 +1,297 @@
+import remarkDirective from "remark-directive";
+import remarkGfm from "remark-gfm";
+import remarkMath from "remark-math";
+import remarkParse from "remark-parse";
+import { unified } from "unified";
+import { visit } from "unist-util-visit";
+import { stripAuthoringMarkupForValidation } from "../authoring-markup.js";
+function authoredText(segment) {
+    const values = [];
+    if ("content" in segment && typeof segment.content === "string")
+        values.push(segment.content);
+    if (segment.type === "roleplay") {
+        values.push(segment.aiInstructions);
+        if (segment.openingMessage)
+            values.push(segment.openingMessage);
+        if (segment.assessmentInstructions)
+            values.push(segment.assessmentInstructions);
+    }
+    if (segment.type === "question" && segment.assessmentInstructions)
+        values.push(segment.assessmentInstructions);
+    return values;
+}
+function lineAt(source, offset) {
+    return source.slice(0, offset).split("\n").length;
+}
+function sourceLocator(source) {
+    const cursors = new Map();
+    return (needle) => {
+        const from = cursors.get(needle) ?? 0;
+        let offset = source.indexOf(needle, from);
+        if (offset < 0)
+            offset = source.indexOf(needle);
+        if (offset < 0)
+            return 1;
+        cursors.set(needle, offset + needle.length);
+        return lineAt(source, offset);
+    };
+}
+function headingAnchor(value) {
+    return value.trim().toLocaleLowerCase().replace(/\s+/g, " ");
+}
+function maskCode(value) {
+    const chars = value.split("");
+    let fence;
+    let offset = 0;
+    for (const line of value.split("\n")) {
+        const marker = line.match(/^ {0,3}(`{3,}|~{3,})/);
+        const wasInFence = fence !== undefined;
+        const closesFence = Boolean(marker &&
+            fence &&
+            marker[1][0] === fence.char &&
+            marker[1].length >= fence.length &&
+            line.slice(marker[1].length).trim() === "");
+        for (let index = 0; index < line.length; index += 1) {
+            if (wasInFence || marker)
+                chars[offset + index] = " ";
+        }
+        if (closesFence)
+            fence = undefined;
+        else if (marker && !wasInFence)
+            fence = { char: marker[1][0], length: marker[1].length };
+        offset += line.length + 1;
+    }
+    return chars
+        .join("")
+        .replace(/(`+)(.*?)\1/g, (match) => " ".repeat(match.length));
+}
+function markerSource(source) {
+    const validationSource = stripAuthoringMarkupForValidation(source);
+    const chars = validationSource.split("");
+    const tree = unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkDirective)
+        .use(remarkMath)
+        .parse(validationSource);
+    visit(tree, (node) => {
+        if (!["code", "inlineCode", "math", "inlineMath"].includes(node.type))
+            return;
+        const start = node.position?.start.offset;
+        const end = node.position?.end.offset;
+        if (start === undefined || end === undefined)
+            return;
+        for (let index = start; index < end; index += 1) {
+            if (chars[index] !== "\n")
+                chars[index] = " ";
+        }
+    });
+    const standaloneAttachment = new Map();
+    const walk = (parent) => {
+        for (let index = 0; index < parent.children.length; index += 1) {
+            const node = parent.children[index];
+            if (node.type === "paragraph" &&
+                node.children.length === 1 &&
+                node.children[0].type === "text" &&
+                /^\^[^\s]+\s*$/.test(node.children[0].value)) {
+                standaloneAttachment.set(node.position?.start.line ?? 1, index > 0);
+            }
+            if ("children" in node && Array.isArray(node.children)) {
+                walk(node);
+            }
+        }
+    };
+    walk(tree);
+    return { masked: chars.join(""), standaloneAttachment };
+}
+function blockMarkerErrors(file, source) {
+    const errors = [];
+    const blockIds = new Map();
+    const { masked, standaloneAttachment } = markerSource(source);
+    const lines = masked.split("\n");
+    for (let index = 0; index < lines.length; index += 1) {
+        const match = lines[index].match(/(?:^|[ \t])\^([^\s]+)\s*$/);
+        if (!match)
+            continue;
+        const id = match[1];
+        const line = index + 1;
+        if (!/^[A-Za-z0-9-]+$/.test(id)) {
+            errors.push({
+                file,
+                line,
+                code: "lens.block-id-invalid",
+                severity: "error",
+                message: `Invalid same-Lens block ID '^${id}'`,
+                suggestion: "Use only letters, numbers, and dashes.",
+            });
+            continue;
+        }
+        blockIds.set(id, [...(blockIds.get(id) ?? []), line]);
+        const standalone = lines[index].trim() === `^${id}`;
+        if (standalone) {
+            const hasPriorContent = lines
+                .slice(0, index)
+                .some((candidate) => candidate.trim() !== "");
+            const blankBefore = index > 0 && lines[index - 1].trim() === "";
+            const blankAfter = index === lines.length - 1 || lines[index + 1].trim() === "";
+            if (!hasPriorContent) {
+                errors.push({
+                    file,
+                    line,
+                    code: "lens.block-id-orphan",
+                    severity: "error",
+                    message: `Block marker '^${id}' is not attached to a content block`,
+                    suggestion: "Place it after the block it labels.",
+                });
+            }
+            else if (!blankBefore || !blankAfter) {
+                errors.push({
+                    file,
+                    line,
+                    code: "lens.block-id-position",
+                    severity: "error",
+                    message: `Structured block marker '^${id}' must have a blank line before and after it`,
+                    suggestion: `Use a blank line, ^${id}, then another blank line.`,
+                });
+            }
+            else if (!standaloneAttachment.get(line)) {
+                errors.push({
+                    file,
+                    line,
+                    code: "lens.block-id-orphan",
+                    severity: "error",
+                    message: `Block marker '^${id}' is not attached to a content block`,
+                    suggestion: "Place it after the block it labels.",
+                });
+            }
+        }
+        else if (/^:{3,}\s+\^/.test(lines[index].trim())) {
+            errors.push({
+                file,
+                line,
+                code: "lens.block-id-position",
+                severity: "error",
+                message: `Block marker '^${id}' cannot share a directive closing fence`,
+                suggestion: `Close with :::, then put ^${id} on its own line with blank lines around it.`,
+            });
+        }
+    }
+    for (const [id, markerLines] of blockIds) {
+        if (markerLines.length > 1) {
+            errors.push({
+                file,
+                line: markerLines[1],
+                code: "lens.block-id-duplicate",
+                severity: "error",
+                message: `Duplicate same-Lens block ID '^${id}'`,
+            });
+        }
+    }
+    return { errors, blockIds };
+}
+/** Validate canonical same-Lens links against every authored text segment. */
+export function validateSameLensLinks(lens, file, source, lineOffset = 0) {
+    const markerResult = blockMarkerErrors(file, source);
+    const errors = [...markerResult.errors];
+    const texts = lens.segments.flatMap(authoredText).map(maskCode);
+    const headings = new Map();
+    const locate = sourceLocator(source);
+    for (const text of texts) {
+        for (const match of text.matchAll(/^#{1,6}\s+(.+?)\s*#*\s*$/gm)) {
+            const name = headingAnchor(match[1].replace(/\s+\^[A-Za-z0-9-]+\s*$/, ""));
+            headings.set(name, [...(headings.get(name) ?? []), locate(match[0])]);
+        }
+    }
+    for (const text of texts) {
+        const malformedOffsets = new Set();
+        for (const match of text.matchAll(/\[\[#[^\]\n]*(?:$|\](?!\]))/gm)) {
+            malformedOffsets.add(match.index ?? 0);
+            errors.push({
+                file,
+                line: locate(match[0]),
+                code: "lens.wikilink-malformed",
+                severity: "error",
+                message: `Malformed same-Lens wikilink '${match[0].trim()}'`,
+                suggestion: "Close the link with ]] and use at most one |label.",
+            });
+        }
+        for (const match of text.matchAll(/\[\[#([^\]\n]*)\]\]/g)) {
+            if (malformedOffsets.has(match.index ?? 0))
+                continue;
+            const raw = match[1];
+            const [target, label, ...extra] = raw.split("|");
+            const line = locate(match[0]);
+            if (!target.trim() || extra.length || (label !== undefined && !label.trim())) {
+                errors.push({
+                    file,
+                    line,
+                    code: "lens.wikilink-malformed",
+                    severity: "error",
+                    message: `Malformed same-Lens wikilink '${match[0]}'`,
+                    suggestion: "Use [[#Heading text|label]] or [[#^block-id|label]].",
+                });
+                continue;
+            }
+            if (target.startsWith("^")) {
+                const id = target.slice(1).trim();
+                if (!/^[A-Za-z0-9-]+$/.test(id)) {
+                    errors.push({
+                        file,
+                        line,
+                        code: "lens.wikilink-malformed",
+                        severity: "error",
+                        message: `Invalid same-Lens block link '#^${id}'`,
+                        suggestion: "Use letters, numbers, and dashes in block IDs.",
+                    });
+                }
+                else if (!markerResult.blockIds.has(id)) {
+                    errors.push({
+                        file,
+                        line,
+                        code: "lens.target-missing",
+                        severity: "error",
+                        message: `Same-Lens block target '^${id}' does not exist`,
+                    });
+                }
+            }
+            else {
+                const count = headings.get(headingAnchor(target))?.length ?? 0;
+                if (count === 0) {
+                    errors.push({
+                        file,
+                        line,
+                        code: "lens.target-missing",
+                        severity: "error",
+                        message: `Same-Lens heading target '${target}' does not exist`,
+                    });
+                }
+                else if (count > 1) {
+                    errors.push({
+                        file,
+                        line,
+                        code: "lens.heading-ambiguous",
+                        severity: "error",
+                        message: `Same-Lens heading target '${target}' is ambiguous because the heading is duplicated`,
+                    });
+                }
+            }
+        }
+        for (const match of text.matchAll(/\]\(anchor:(?:block|heading):[^)]+\)/g)) {
+            errors.push({
+                file,
+                line: locate(match[0]),
+                code: "lens.anchor-private",
+                severity: "error",
+                message: "The renderer-private anchor: scheme cannot be authored directly",
+                suggestion: "Use [[#^block-id|label]] or [[#Heading text|label]].",
+            });
+        }
+    }
+    return lineOffset === 0
+        ? errors
+        : errors.map((error) => ({
+            ...error,
+            line: error.line === undefined ? undefined : error.line + lineOffset,
+        }));
+}
+//# sourceMappingURL=same-lens-links.js.map

package/dist/validator/same-lens-links.js.map

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

package/dist/validator/suppressions.d.ts

@@ -0,0 +1,42 @@
+import type { ContentError } from "../index.js";
+export interface ValidatorSuppressionDefinition {
+    code: string;
+    reason: string;
+    explanation: string;
+}
+export declare const VALIDATOR_SUPPRESSIONS: {
+    readonly imageLowResolutionAiSearchExhausted: {
+        readonly code: "article.image-low-resolution";
+        readonly reason: "AI-couldn't-find-higher-resolution-image";
+        readonly explanation: "An AI search could not find a higher-resolution image.";
+    };
+    readonly imageLowResolutionAiAndHumanSearchExhausted: {
+        readonly code: "article.image-low-resolution";
+        readonly reason: "AI-and-human-couldn't-find-higher-resolution-image";
+        readonly explanation: "Both AI and human searches could not find a higher-resolution image.";
+    };
+    readonly blockRepeatedDistinctStructuredEntries: {
+        readonly code: "article.block-repeated-nearby";
+        readonly reason: "intentional-repeat-in-distinct-structured-entries";
+        readonly explanation: "The same text intentionally applies to separate structured entries.";
+    };
+    readonly blockRepeatedAlternativeCitationFormats: {
+        readonly code: "article.block-repeated-nearby";
+        readonly reason: "source-provides-alternative-citation-formats";
+        readonly explanation: "The source intentionally repeats citation text in alternative formats.";
+    };
+    readonly externalSelfFragmentTargetsSourceOnlyContent: {
+        readonly code: "article.external-self-fragment";
+        readonly reason: "intentionally-targets-source-only-content";
+        readonly explanation: "The link intentionally targets source-page content that was not imported.";
+    };
+};
+export declare function formatValidatorSuppression(definition: ValidatorSuppressionDefinition): string;
+export declare function validatorSuppressionsForCode(code: string): readonly ValidatorSuppressionDefinition[];
+/**
+ * Apply allow-listed, next-line suppressions found in Obsidian comments.
+ *
+ * `source` must preserve the article body's line positions. Callers may mask
+ * code/math first so documentation examples are not interpreted as directives.
+ */
+export declare function applyNextLineValidatorSuppressions(source: string, bodyStartLine: number, errors: ContentError[], file: string): ContentError[];

package/dist/validator/suppressions.js

@@ -0,0 +1,97 @@
+export const VALIDATOR_SUPPRESSIONS = {
+    imageLowResolutionAiSearchExhausted: {
+        code: "article.image-low-resolution",
+        reason: "AI-couldn't-find-higher-resolution-image",
+        explanation: "An AI search could not find a higher-resolution image.",
+    },
+    imageLowResolutionAiAndHumanSearchExhausted: {
+        code: "article.image-low-resolution",
+        reason: "AI-and-human-couldn't-find-higher-resolution-image",
+        explanation: "Both AI and human searches could not find a higher-resolution image.",
+    },
+    blockRepeatedDistinctStructuredEntries: {
+        code: "article.block-repeated-nearby",
+        reason: "intentional-repeat-in-distinct-structured-entries",
+        explanation: "The same text intentionally applies to separate structured entries.",
+    },
+    blockRepeatedAlternativeCitationFormats: {
+        code: "article.block-repeated-nearby",
+        reason: "source-provides-alternative-citation-formats",
+        explanation: "The source intentionally repeats citation text in alternative formats.",
+    },
+    externalSelfFragmentTargetsSourceOnlyContent: {
+        code: "article.external-self-fragment",
+        reason: "intentionally-targets-source-only-content",
+        explanation: "The link intentionally targets source-page content that was not imported.",
+    },
+};
+const suppressionDefinitions = Object.values(VALIDATOR_SUPPRESSIONS);
+const suppressionsByCode = new Map();
+for (const definition of suppressionDefinitions) {
+    const reasons = suppressionsByCode.get(definition.code) ?? new Map();
+    if (reasons.has(definition.reason)) {
+        throw new Error(`Duplicate validator suppression: ${definition.code}/${definition.reason}`);
+    }
+    reasons.set(definition.reason, definition);
+    suppressionsByCode.set(definition.code, reasons);
+}
+export function formatValidatorSuppression(definition) {
+    return `%% validator-ignore-next-line --code ${definition.code} --reason ${definition.reason} %%`;
+}
+export function validatorSuppressionsForCode(code) {
+    return [...(suppressionsByCode.get(code)?.values() ?? [])];
+}
+function suppressionIssue(file, bodyStartLine, relativeLine, code, message, suggestion) {
+    return {
+        file,
+        line: bodyStartLine + relativeLine - 1,
+        code,
+        severity: "error",
+        message,
+        suggestion,
+    };
+}
+/**
+ * Apply allow-listed, next-line suppressions found in Obsidian comments.
+ *
+ * `source` must preserve the article body's line positions. Callers may mask
+ * code/math first so documentation examples are not interpreted as directives.
+ */
+export function applyNextLineValidatorSuppressions(source, bodyStartLine, errors, file) {
+    const remaining = [...errors];
+    const suppressionErrors = [];
+    const example = formatValidatorSuppression(suppressionDefinitions[0]);
+    source.split("\n").forEach((line, index) => {
+        if (!/^\s*%%\s*validator-ignore-next-line\b/.test(line))
+            return;
+        const markerLine = index + 1;
+        const match = line.match(/^\s*%%\s*validator-ignore-next-line\s+--code\s+([a-z0-9.-]+)\s+--reason\s+([A-Za-z0-9'-]+)\s*%%\s*$/);
+        if (!match) {
+            suppressionErrors.push(suppressionIssue(file, bodyStartLine, markerLine, "article.suppression-invalid", "Validator suppression is malformed", `Use the exact CLI-style form, for example: ${example}`));
+            return;
+        }
+        const [, code, reason] = match;
+        const allowedReasons = suppressionsByCode.get(code);
+        if (!allowedReasons) {
+            suppressionErrors.push(suppressionIssue(file, bodyStartLine, markerLine, "article.suppression-invalid", `Validation rule '${code}' cannot be suppressed`, "Only explicitly registered validation codes can be suppressed."));
+            return;
+        }
+        const definition = allowedReasons.get(reason);
+        if (!definition) {
+            const choices = [...allowedReasons.values()]
+                .map((entry) => `'${entry.reason}' (${entry.explanation})`)
+                .join(", ");
+            suppressionErrors.push(suppressionIssue(file, bodyStartLine, markerLine, "article.suppression-invalid", `Reason '${reason}' is not allowed for '${code}'`, `Allowed reason${allowedReasons.size === 1 ? "" : "s"}: ${choices}`));
+            return;
+        }
+        const targetLine = bodyStartLine + markerLine;
+        const errorIndex = remaining.findIndex((entry) => entry.code === code && entry.line === targetLine);
+        if (errorIndex === -1) {
+            suppressionErrors.push(suppressionIssue(file, bodyStartLine, markerLine, "article.suppression-unused", `Suppression for '${code}' does not match an error on the next line`, "Remove the stale suppression, or place it immediately before the affected content."));
+            return;
+        }
+        remaining.splice(errorIndex, 1);
+    });
+    return [...remaining, ...suppressionErrors];
+}
+//# sourceMappingURL=suppressions.js.map