lens-content-processor 0.43.0 → 0.44.0

package/dist/validator/article-imports.js

@@ -0,0 +1,265 @@
+import { parseTimestamp } from "../bundler/video.js";
+import { isValidHeight } from "../parser/widget.js";
+// ::video{attr}[[path|alias]] or ::video[[path|alias]]{attr}, anchored to a
+// full (trimmed) line. Alias is accepted for wikilink-tooling compatibility
+// but unused — the display title comes from the transcript frontmatter.
+const VIDEO_IMPORT_LINE_RE = /^::video(?:\{([^}]*)\})?\[\[([^\]|]+)(?:\|[^\]]+)?\]\](?:\{([^}]*)\})?$/;
+// Anything that looks like an attempted ::video import (used to flag
+// malformed/misplaced usages without false-positives on prose that merely
+// mentions "::video").
+const VIDEO_IMPORT_CANDIDATE_RE = /::video[[{]/;
+// ![[path]] or ![[path|modifier]], anchored to a full (trimmed) line.
+const WIDGET_EMBED_LINE_RE = /^!\[\[([^\]|]+)(?:\|([^\]]*))?\]\]$/;
+// Every ![[...]] on a line; the target decides whether it is a widget embed.
+const WIDGET_EMBED_CANDIDATE_RE = /!\[\[([^\]|]+)(?:\|[^\]]*)?\]\]/g;
+// A file directly under a widgets/ folder, written relative to the article
+// (`../widgets/name`) or to the vault root (`widgets/name`), no fragment.
+const WIDGET_TARGET_RE = /^(?:\.\.?\/)*widgets\/[^/#|]+$/;
+// Inline code is not prose: an import mentioned in backticks is neither an
+// import nor a mistake.
+const INLINE_CODE_RE = /`[^`]*`/g;
+// CommonMark permits up to three leading spaces before a fenced code block.
+const CODE_FENCE = /^ {0,3}(?:```|~~~)/;
+const CONTAINER_OPEN = /^(:{3,})([\w-]+)/;
+const CONTAINER_CLOSE = /^(:{3,})\s*(?:\{[^}]*\})?\s*$/;
+/** Parse `from="..." to="..."` attribute text. */
+function parseAttrs(attr) {
+    if (attr === undefined || attr.trim() === "")
+        return {};
+    const tokens = [...attr.matchAll(/([\w-]+)\s*=\s*"([^"]*)"/g)];
+    const consumed = tokens.map((m) => m[0]).join(" ");
+    if (consumed.replace(/\s+/g, " ").trim() !== attr.replace(/\s+/g, " ").trim()) {
+        return {
+            reason: `invalid attributes '{${attr}}'`,
+            suggestion: 'Use key="value" attributes: from and/or to',
+        };
+    }
+    const result = {};
+    for (const token of tokens) {
+        const key = token[1];
+        const value = token[2];
+        if (key !== "from" && key !== "to") {
+            return {
+                reason: `unrecognized attribute '${key}'`,
+                suggestion: "Only from and to attributes are supported",
+            };
+        }
+        if (result[key] !== undefined) {
+            return {
+                reason: `duplicate attribute '${key}'`,
+                suggestion: `Keep only one ${key} attribute`,
+            };
+        }
+        if (parseTimestamp(value) === null) {
+            return {
+                reason: `invalid timestamp in '${key}="${value}"'`,
+                suggestion: "Use M:SS (e.g. 1:30) or H:MM:SS (e.g. 1:30:00)",
+            };
+        }
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Classify a single line of article body text as a ::video import.
+ * - "import": a valid own-line ::video import
+ * - "invalid": an attempted import with broken syntax
+ * - "none": not a video import at all
+ */
+export function parseVideoImportLine(line) {
+    const trimmed = line.trim();
+    if (!VIDEO_IMPORT_CANDIDATE_RE.test(trimmed.replace(INLINE_CODE_RE, ""))) {
+        return { kind: "none" };
+    }
+    const invalid = (reason, suggestion) => ({
+        kind: "invalid",
+        kindName: "video",
+        reason,
+        suggestion,
+    });
+    const match = trimmed.match(VIDEO_IMPORT_LINE_RE);
+    if (!match) {
+        if (trimmed.startsWith("::video")) {
+            return invalid("malformed ::video import", 'Use ::video[[../video_transcripts/name]] with optional {from="1:30" to="4:10"}, alone on its own line');
+        }
+        // ::video appears mid-line — an import buried in prose.
+        return invalid("::video import must be alone on its own line", "Move the ::video[[...]] import to its own line");
+    }
+    const preAttr = match[1];
+    const target = match[2].trim();
+    const postAttr = match[3];
+    if (preAttr !== undefined && postAttr !== undefined) {
+        return invalid("attributes given both before and after the wikilink", "Use a single {from=... to=...} block after the ]]");
+    }
+    const attrs = parseAttrs(preAttr ?? postAttr);
+    if ("reason" in attrs)
+        return invalid(attrs.reason, attrs.suggestion);
+    if (target === "") {
+        return invalid("empty wikilink target", "Reference a transcript: ::video[[../video_transcripts/name]]");
+    }
+    return { kind: "import", import: { kind: "video", target, ...attrs } };
+}
+/** True when a wikilink target names a file directly under a widgets/ folder. */
+export function isWidgetEmbedTarget(target) {
+    return WIDGET_TARGET_RE.test(target.trim());
+}
+/** True when a line mentions a widget embed anywhere outside inline code. */
+function hasWidgetEmbedCandidate(line) {
+    return [
+        ...line.replace(INLINE_CODE_RE, "").matchAll(WIDGET_EMBED_CANDIDATE_RE),
+    ].some((m) => isWidgetEmbedTarget(m[1]));
+}
+/**
+ * Classify a single line of article body text as a widget embed.
+ * - "import": a valid own-line ![[../widgets/name]] embed
+ * - "invalid": a widget embed with broken syntax or buried in prose
+ * - "none": not a widget embed (other ![[...]] embeds included)
+ */
+export function parseWidgetEmbedLine(line) {
+    const trimmed = line.trim();
+    if (!hasWidgetEmbedCandidate(trimmed))
+        return { kind: "none" };
+    const invalid = (reason, suggestion) => ({
+        kind: "invalid",
+        kindName: "widget",
+        reason,
+        suggestion,
+    });
+    const match = trimmed.match(WIDGET_EMBED_LINE_RE);
+    if (!match || !isWidgetEmbedTarget(match[1])) {
+        return invalid("widget embed must be alone on its own line", "Move the ![[../widgets/name]] embed to its own line");
+    }
+    const target = match[1].trim();
+    const modifier = match[2]?.trim();
+    if (modifier === undefined || modifier === "") {
+        return { kind: "import", import: { kind: "widget", target } };
+    }
+    const heightMatch = modifier.match(/^height\s*=\s*(\S+)$/);
+    if (!heightMatch || !isValidHeight(heightMatch[1])) {
+        return invalid(`invalid modifier '|${modifier}'`, 'The only modifier is height, e.g. ![[../widgets/name|height=480px]] ("auto" or a CSS length)');
+    }
+    return {
+        kind: "import",
+        import: { kind: "widget", target, height: heightMatch[1] },
+    };
+}
+/** Classify a line as any of the inline article imports. */
+export function parseArticleImportLine(line) {
+    const video = parseVideoImportLine(line);
+    return video.kind === "none" ? parseWidgetEmbedLine(line) : video;
+}
+/**
+ * Walk an article body line by line, tracking fenced code and container
+ * directives, so every consumer of import lines skips the same regions.
+ */
+export function scanArticleLines(body) {
+    const out = [];
+    let inCodeBlock = false;
+    // Names of open container directives, innermost last.
+    const containerStack = [];
+    for (const line of body.split("\n")) {
+        if (CODE_FENCE.test(line)) {
+            inCodeBlock = !inCodeBlock;
+            out.push({ line, prose: false });
+            continue;
+        }
+        if (inCodeBlock) {
+            out.push({ line, prose: false });
+            continue;
+        }
+        const openMatch = line.match(CONTAINER_OPEN);
+        if (openMatch) {
+            containerStack.push(openMatch[2]);
+            out.push({ line, prose: false });
+            continue;
+        }
+        if (CONTAINER_CLOSE.test(line)) {
+            containerStack.pop();
+            out.push({ line, prose: false });
+            continue;
+        }
+        const hiddenIn = containerStack.find((name) => name === "hide" || name === "collapse");
+        out.push(hiddenIn ? { line, prose: true, hiddenIn } : { line, prose: true });
+    }
+    return out;
+}
+const IMPORT_LABEL = {
+    video: { code: "video-import", label: "::video import" },
+    widget: { code: "widget-embed", label: "widget embed" },
+};
+/**
+ * Parse-time validation of inline imports in an article body.
+ * Resolution errors (missing file, bad range) are reported later by the
+ * flattener, which has the file map.
+ */
+export function validateArticleImports(body, file, bodyStartLine) {
+    const errors = [];
+    const scanned = scanArticleLines(body);
+    for (let i = 0; i < scanned.length; i++) {
+        const { line, prose, hiddenIn } = scanned[i];
+        if (!prose)
+            continue;
+        const absLine = bodyStartLine + i;
+        const parsed = parseArticleImportLine(line);
+        if (parsed.kind === "none")
+            continue;
+        if (parsed.kind === "invalid") {
+            const { code, label } = IMPORT_LABEL[parsed.kindName];
+            const notOwnLine = parsed.reason.includes("own line");
+            errors.push({
+                file,
+                line: absLine,
+                code: `article.${code}-${notOwnLine ? "not-own-line" : "invalid"}`,
+                message: `Invalid ${label}: ${parsed.reason}`,
+                suggestion: parsed.suggestion,
+                severity: "error",
+            });
+            continue;
+        }
+        // Imports inside hide/collapse would silently vanish from rendered output
+        // (the collapsed string strips them), so they are rejected outright.
+        if (hiddenIn) {
+            const { code, label } = IMPORT_LABEL[parsed.import.kind];
+            errors.push({
+                file,
+                line: absLine,
+                code: `article.${code}-in-hide`,
+                message: `${label} inside a ':::${hiddenIn}' container`,
+                suggestion: `Move the import outside the hidden block — hidden text is collapsed and the ${parsed.import.kind} would never render`,
+                severity: "error",
+            });
+        }
+    }
+    return errors;
+}
+/**
+ * Lens text segments do not resolve inline article imports — catch attempts
+ * there with a pointer to the supported mechanisms.
+ */
+export function validateNoArticleImportsInLensText(content, file, line) {
+    const errors = [];
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const prose = lines[i].replace(INLINE_CODE_RE, "");
+        if (VIDEO_IMPORT_CANDIDATE_RE.test(prose)) {
+            errors.push({
+                file,
+                line: line + i,
+                message: "::video imports are only supported in article bodies",
+                suggestion: "Use a '#### Video' segment in the lens, or move the import into the article file",
+                severity: "error",
+            });
+        }
+        else if (hasWidgetEmbedCandidate(prose)) {
+            errors.push({
+                file,
+                line: line + i,
+                message: "Widget embeds (![[../widgets/...]]) are only supported in article bodies",
+                suggestion: "Use a '#### Widget' segment in the lens, or move the embed into the article file",
+                severity: "error",
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=article-imports.js.map

package/dist/validator/article-imports.js.map

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

package/dist/validator/article-structure.js

@@ -5,9 +5,14 @@ import { stripAuthoringMarkupForValidation } from "../authoring-markup.js";
 import { parseFrontmatter } from "../parser/frontmatter.js";
 import { applyNextLineValidatorSuppressions, formatValidatorSuppression, VALIDATOR_SUPPRESSIONS, validatorSuppressionsForCode, } from "./suppressions.js";
 import { validateArticleSamePageLinks } from "./same-lens-links.js";
+import { isWidgetEmbedTarget } from "./article-imports.js";
 const lowResolutionSuppression = VALIDATOR_SUPPRESSIONS.imageLowResolutionAiSearchExhausted;
-const lowResolutionSuppressionGuidance = validatorSuppressionsForCode(lowResolutionSuppression.code).map((definition) => `${definition.explanation} Use: ${formatValidatorSuppression(definition)}`).join(" ");
-const repeatedBlockSuppressionGuidance = validatorSuppressionsForCode("article.block-repeated-nearby").map((definition) => `${definition.explanation} Use: ${formatValidatorSuppression(definition)}`).join(" ");
+const lowResolutionSuppressionGuidance = validatorSuppressionsForCode(lowResolutionSuppression.code)
+    .map((definition) => `${definition.explanation} Use: ${formatValidatorSuppression(definition)}`)
+    .join(" ");
+const repeatedBlockSuppressionGuidance = validatorSuppressionsForCode("article.block-repeated-nearby")
+    .map((definition) => `${definition.explanation} Use: ${formatValidatorSuppression(definition)}`)
+    .join(" ");
 const externalSelfFragmentSuppression = VALIDATOR_SUPPRESSIONS.externalSelfFragmentTargetsSourceOnlyContent;
 function issue(file, bodyStartLine, code, severity, message, line, suggestion) {
     return {
@@ -104,7 +109,7 @@ function sameSourceFragment(targetUrl, sourceUrl) {
 // source-site-relative import failures this rule exists to catch.
 const PLATFORM_LOCAL_ROUTE = /^\/(?:about|admin|ai-doc|availability|coach|coefficient-giving-proposal|content|courses?|enroll|facilitator|funnel-prototype|if-anyone-builds-it-everyone-dies|lenses?|meetings|modules?|navigate|navigators|onboarding|ops|overview|privacy|progress|promptlab|referrals|reschedule|settings|skill-tree|subscribe|terms|theory-of-change|tts-test|validate)(?:\/|$)/i;
 function isUnsupportedRootRelativeLink(url) {
-    return /^\/(?!\/)/.test(url) && url !== "/" && !PLATFORM_LOCAL_ROUTE.test(url);
+    return (/^\/(?!\/)/.test(url) && url !== "/" && !PLATFORM_LOCAL_ROUTE.test(url));
 }
 const FLATTENED_MATH_TOKEN = /(?<!\\)\b(?:pi|mu|theta|phi|lambda|gamma|tilde|times|infinity|RR|sum|dot)(?=_|\b)|->/g;
 const TYPED_FOOTNOTE_ID = /^(?:cite|note)-[a-z0-9]+(?:-[a-z0-9]+)*$/;
@@ -136,21 +141,33 @@ export function collectArticleImages(body, bodyStartLine) {
     const tree = parseMarkdown(body, "gfm");
     const definitions = new Map();
     const images = [];
-    visit(tree, "definition", (node) => { definitions.set(node.identifier.toLowerCase(), node.url); });
+    visit(tree, "definition", (node) => {
+        definitions.set(node.identifier.toLowerCase(), node.url);
+    });
     visit(tree, (node) => {
         if (node.type === "image")
-            images.push({ url: node.url, line: bodyStartLine + (node.position?.start.line ?? 1) - 1 });
+            images.push({
+                url: node.url,
+                line: bodyStartLine + (node.position?.start.line ?? 1) - 1,
+            });
         if (node.type === "imageReference") {
             const url = definitions.get(node.identifier.toLowerCase());
             if (url)
-                images.push({ url, line: bodyStartLine + (node.position?.start.line ?? 1) - 1 });
+                images.push({
+                    url,
+                    line: bodyStartLine + (node.position?.start.line ?? 1) - 1,
+                });
         }
     });
     return images;
 }
 export function validateWikilinkImages(body, file, bodyStartLine) {
     const source = proseMask(body);
-    return [...source.matchAll(/!\[\[([^\n\]]+)\]\]/g)].map((match) => issue(file, bodyStartLine, "article.wikilink-image-unsupported", "error", `Wiki-link image not supported: ![[${match[1]}]]`, lineAt(source, match.index ?? 0), "Use standard markdown image syntax: ![alt](url)"));
+    // Widget embeds (![[../widgets/name]]) are inline imports, checked by
+    // validator/article-imports.ts.
+    return [...source.matchAll(/!\[\[([^\n\]]+)\]\]/g)]
+        .filter((match) => !isWidgetEmbedTarget(match[1].split("|")[0]))
+        .map((match) => issue(file, bodyStartLine, "article.wikilink-image-unsupported", "error", `Wiki-link image not supported: ![[${match[1]}]]`, lineAt(source, match.index ?? 0), "Use standard markdown image syntax: ![alt](url)"));
 }
 function scanFences(body, file, bodyStartLine) {
     const errors = [];
@@ -163,7 +180,9 @@ function scanFences(body, file, bodyStartLine) {
         if (!open) {
             open = { char, length: match[1].length, line: index + 1 };
         }
-        else if (open.char === char && match[1].length >= open.length && match[2].trim() === "") {
+        else if (open.char === char &&
+            match[1].length >= open.length &&
+            match[2].trim() === "") {
             open = undefined;
         }
     });
@@ -228,7 +247,9 @@ function normalizedBlock(node, body) {
     // TeX identifiers are case-sensitive: N_1 and n_1 can denote different
     // variables in otherwise parallel propositions. Preserve case for math so
     // the duplicate check still catches exact copies without conflating them.
-    return /^\$\$[\s\S]*\$\$$/.test(normalized) ? normalized : normalized.toLowerCase();
+    return /^\$\$[\s\S]*\$\$$/.test(normalized)
+        ? normalized
+        : normalized.toLowerCase();
 }
 function isSectionBoilerplate(value) {
     return /^applicability to different subgoals in our verification framework:$/i.test(value);
@@ -238,11 +259,13 @@ function isEmojiJoiner(source, index) {
         return false;
     const before = Array.from(source.slice(0, index));
     // Emoji modifiers and variation selectors extend the preceding pictograph.
-    while (before.length && /^(?:\p{Emoji_Modifier}|[\uFE00-\uFE0F\u{E0100}-\u{E01EF}])$/u.test(before.at(-1) ?? ""))
+    while (before.length &&
+        /^(?:\p{Emoji_Modifier}|[\uFE00-\uFE0F\u{E0100}-\u{E01EF}])$/u.test(before.at(-1) ?? ""))
         before.pop();
     const previous = before.at(-1) ?? "";
     const next = Array.from(source.slice(index + 1))[0] ?? "";
-    return /^\p{Extended_Pictographic}$/u.test(previous) && /^\p{Extended_Pictographic}$/u.test(next);
+    return (/^\p{Extended_Pictographic}$/u.test(previous) &&
+        /^\p{Extended_Pictographic}$/u.test(next));
 }
 function isAttributionParagraph(node) {
     if (node.type !== "paragraph")
@@ -298,7 +321,10 @@ export function validateArticleStructure(content, file) {
     });
     visit(tree, "footnoteDefinition", (node) => {
         const id = node.identifier.toLowerCase();
-        definedFootnotes.set(id, [...(definedFootnotes.get(id) ?? []), node.position?.start.line ?? 1]);
+        definedFootnotes.set(id, [
+            ...(definedFootnotes.get(id) ?? []),
+            node.position?.start.line ?? 1,
+        ]);
         if (id.startsWith("cite-") &&
             /^https?:\/\/\S+$/i.test(toString(node).trim())) {
             errors.push(issue(file, bodyStartLine, "article.citation-definition-url-only", "warning", `Citation '${id}' contains only a URL`, node.position?.start.line ?? 1, "Include the available author, title, year, or publication details while preserving the source link."));
@@ -313,7 +339,9 @@ export function validateArticleStructure(content, file) {
             const target = node;
             const isImage = node.type === "image";
             if (!target.url.trim()) {
-                errors.push(issue(file, bodyStartLine, isImage ? "article.image-destination-empty" : "article.link-destination-empty", "error", `${isImage ? "Image" : "Link"} destination is empty`, line));
+                errors.push(issue(file, bodyStartLine, isImage
+                    ? "article.image-destination-empty"
+                    : "article.link-destination-empty", "error", `${isImage ? "Image" : "Link"} destination is empty`, line));
             }
             if (!isImage && isUnsupportedRootRelativeLink(target.url.trim())) {
                 errors.push(issue(file, bodyStartLine, "article.root-relative-source-link", "error", `Root-relative link '${target.url}' resolves against Lens instead of the source website`, line, "Resolve the destination against source_url and use the resulting absolute URL."));
@@ -344,8 +372,7 @@ export function validateArticleStructure(content, file) {
             }
             if (!isImage) {
                 const sourceFragment = sameSourceFragment(target.url, sourceUrl);
-                if (sourceFragment &&
-                    !externalSelfFragments.has(sourceFragment)) {
+                if (sourceFragment && !externalSelfFragments.has(sourceFragment)) {
                     externalSelfFragments.add(sourceFragment);
                     errors.push(issue(file, bodyStartLine, "article.external-self-fragment", "warning", `Link '#${sourceFragment}' points back to this article's source page`, line, `Use a native Markdown footnote for a note, or add a ^block-id to imported content and link to [[#^block-id|label]]. If this deliberately targets source-only content that was not imported, place this exemption immediately above the link: ${formatValidatorSuppression(externalSelfFragmentSuppression)}`));
                 }
@@ -357,8 +384,12 @@ export function validateArticleStructure(content, file) {
                 const after = body[end] ?? "";
                 const label = toString(node);
                 const siblings = parent && "children" in parent ? parent.children : [];
-                const previous = index === undefined || index === null ? undefined : siblings[index - 1];
-                const next = index === undefined || index === null ? undefined : siblings[index + 1];
+                const previous = index === undefined || index === null
+                    ? undefined
+                    : siblings[index - 1];
+                const next = index === undefined || index === null
+                    ? undefined
+                    : siblings[index + 1];
                 const adjacentTypes = new Set([
                     "link",
                     "linkReference",
@@ -378,9 +409,7 @@ export function validateArticleStructure(content, file) {
                     ((/\[|\]/.test(before) &&
                         !structuredBefore &&
                         !escapedAt(body, start - 1)) ||
-                        (/\[|\]/.test(after) &&
-                            !structuredAfter &&
-                            !escapedAt(body, end)));
+                        (/\[|\]/.test(after) && !structuredAfter && !escapedAt(body, end)));
                 if (touchesUnescapedBracket) {
                     errors.push(issue(file, bodyStartLine, "article.inline-boundary-malformed", "error", "Markdown link touches a stray bracket", line, "Remove the unmatched bracket or complete the intended bracketed citation."));
                 }
@@ -421,7 +450,9 @@ export function validateArticleStructure(content, file) {
         if (node.type === "linkReference" || node.type === "imageReference") {
             const id = node.identifier.toLowerCase();
             if (!definitions.has(id))
-                errors.push(issue(file, bodyStartLine, node.type === "imageReference" ? "article.image-destination-empty" : "article.reference-target-undefined", "error", `Reference target '${id}' is not defined`, line));
+                errors.push(issue(file, bodyStartLine, node.type === "imageReference"
+                    ? "article.image-destination-empty"
+                    : "article.reference-target-undefined", "error", `Reference target '${id}' is not defined`, line));
             const referencedUrl = definitions.get(id);
             if (node.type === "linkReference" &&
                 referencedUrl !== undefined &&
@@ -462,14 +493,17 @@ export function validateArticleStructure(content, file) {
                     errors.push(issue(file, bodyStartLine, "article.image-destination-empty", "error", `Image reference target '${id}' is not defined`, baseLine + lineAt(node.value, match.index ?? 0) - 1));
             }
         }
-        if (["paragraph", "table", "image"].includes(node.type) && parent?.type === "root") {
+        if (["paragraph", "table", "image"].includes(node.type) &&
+            parent?.type === "root") {
             const value = normalizedBlock(positioned, body);
             if (!/^>/.test(value))
                 blocks.push({
                     node: positioned,
                     value,
                     line,
-                    substantial: value.length >= 80 || node.type === "table" || node.type === "image",
+                    substantial: value.length >= 80 ||
+                        node.type === "table" ||
+                        node.type === "image",
                     attribution: isAttributionParagraph(positioned),
                 });
         }
@@ -493,7 +527,10 @@ export function validateArticleStructure(content, file) {
     const rawFootnoteDefinitions = new Map();
     for (const match of prose.matchAll(/^\[\^([^\]]+)\]:/gm)) {
         const id = match[1].toLowerCase();
-        rawFootnoteDefinitions.set(id, [...(rawFootnoteDefinitions.get(id) ?? []), lineAt(prose, match.index ?? 0)]);
+        rawFootnoteDefinitions.set(id, [
+            ...(rawFootnoteDefinitions.get(id) ?? []),
+            lineAt(prose, match.index ?? 0),
+        ]);
     }
     for (const [id, lines] of rawFootnoteDefinitions)
         if (lines.length > 1 && (definedFootnotes.get(id)?.length ?? 0) < 2)
@@ -558,13 +595,20 @@ export function validateArticleStructure(content, file) {
     }
     for (const match of prose.matchAll(/!\[[^\]]*\]\(\s*\)|\[[^\]]+\]\(\s*\)/g)) {
         const raw = match[0];
-        const code = raw.startsWith("![") ? "article.image-destination-empty" : "article.link-destination-empty";
+        const code = raw.startsWith("![")
+            ? "article.image-destination-empty"
+            : "article.link-destination-empty";
         errors.push(issue(file, bodyStartLine, code, "error", "Incomplete Markdown link or image", lineAt(prose, match.index ?? 0)));
     }
     for (const match of prose.matchAll(/^#{1,6}\s+(Image|Figure|Photo)\s*$/gim)) {
         const line = lineAt(prose, match.index ?? 0);
-        const nearby = body.split("\n").slice(line, line + 4).join("\n");
-        errors.push(issue(file, bodyStartLine, /!\[/.test(nearby) ? "article.placeholder-image-heading" : "article.placeholder-heading", /!\[/.test(nearby) ? "error" : "warning", `Placeholder heading '${match[1]}' lacks descriptive context`, line));
+        const nearby = body
+            .split("\n")
+            .slice(line, line + 4)
+            .join("\n");
+        errors.push(issue(file, bodyStartLine, /!\[/.test(nearby)
+            ? "article.placeholder-image-heading"
+            : "article.placeholder-heading", /!\[/.test(nearby) ? "error" : "warning", `Placeholder heading '${match[1]}' lacks descriptive context`, line));
     }
     for (const match of prose.matchAll(/(?:Posted in:\s*(?:,\s*)+|Export citation|Download citation|Share\s+Save\s+Follow)/gi))
         errors.push(issue(file, bodyStartLine, "article.page-chrome-residue", "warning", "Source-page interface residue remains in article text", lineAt(prose, match.index ?? 0)));