lens-content-processor 0.34.0 → 0.35.0

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

package/dist/validator/suppressions.js.map

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

package/dist/validator/video-imports.d.ts

@@ -0,0 +1,35 @@
+import type { ContentError } from "../index.js";
+export interface VideoImportSyntax {
+    /** Wikilink target, e.g. "../video_transcripts/name" */
+    target: string;
+    from?: string;
+    to?: string;
+}
+export type VideoImportParse = {
+    kind: "import";
+    import: VideoImportSyntax;
+} | {
+    kind: "invalid";
+    reason: string;
+    suggestion: string;
+} | {
+    kind: "none";
+};
+/**
+ * Classify a single line of article body text.
+ * - "import": a valid own-line ::video import
+ * - "invalid": an attempted import with broken syntax
+ * - "none": not a video import at all
+ */
+export declare function parseVideoImportLine(line: string): VideoImportParse;
+/**
+ * Parse-time validation of ::video imports in an article body.
+ * Resolution errors (missing transcript file, bad range) are reported later
+ * by the flattener, which has the file map.
+ */
+export declare function validateVideoImports(body: string, file: string, bodyStartLine: number): ContentError[];
+/**
+ * Lens text segments do not resolve ::video imports — catch attempts there
+ * with a pointer to the supported mechanisms.
+ */
+export declare function validateNoVideoImportsInLensText(content: string, file: string, line: number): ContentError[];