npm - lens-content-processor - Versions diffs - 0.40.0 → 0.42.0 - Mend

lens-content-processor 0.40.0 → 0.42.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (29) hide show

package/dist/content-schema.js +6 -0
package/dist/content-schema.js.map +1 -1
package/dist/flattener/index.js +94 -10
package/dist/flattener/index.js.map +1 -1
package/dist/flattener/resolve-text-links.d.ts +2 -1
package/dist/flattener/resolve-text-links.js +7 -26
package/dist/flattener/resolve-text-links.js.map +1 -1
package/dist/index.d.ts +19 -1
package/dist/index.js +26 -1
package/dist/index.js.map +1 -1
package/dist/parser/lens.d.ts +6 -1
package/dist/parser/lens.js +56 -1
package/dist/parser/lens.js.map +1 -1
package/dist/parser/sections.js +1 -0
package/dist/parser/sections.js.map +1 -1
package/dist/parser/widget.d.ts +25 -0
package/dist/parser/widget.js +367 -0
package/dist/parser/widget.js.map +1 -0
package/dist/same-page-links.d.ts +11 -0
package/dist/same-page-links.js +109 -0
package/dist/same-page-links.js.map +1 -0
package/dist/validator/article-structure.js +6 -51
package/dist/validator/article-structure.js.map +1 -1
package/dist/validator/criticmarkup.js +1 -0
package/dist/validator/criticmarkup.js.map +1 -1
package/dist/validator/same-lens-links.d.ts +2 -0
package/dist/validator/same-lens-links.js +129 -72
package/dist/validator/same-lens-links.js.map +1 -1
package/package.json +2 -1

package/dist/parser/widget.js ADDED Viewed

@@ -0,0 +1,367 @@
+// src/parser/widget.ts
+//
+// A widget is a self-contained interactive HTML page authored in the
+// `widgets/` folder. The file is Markdown only by extension: YAML frontmatter
+// carries the metadata, the body is the full HTML document that the platform
+// renders for learners inside a sandboxed iframe. Keeping the `.md` extension
+// means widgets flow through the editor, relay-git-sync, promotion and CI
+// exactly like every other content file; only this parser treats the body
+// as HTML.
+import { parse as parseHtml, defaultTreeAdapter, Tokenizer, TokenizerMode, } from "parse5";
+import { parseFrontmatter } from "./frontmatter.js";
+import { validateFrontmatter } from "../validator/validate-frontmatter.js";
+import { stripAuthoringMarkup } from "../authoring-markup.js";
+/** Widgets are inlined into module JSON; above this the page payload suffers. */
+export const MAX_WIDGET_HTML_BYTES = 400 * 1024;
+// parse5 reports every HTML5 parse error, including ones browsers recover from
+// identically to the author's intent. These never change what renders.
+const BENIGN_PARSE_ERRORS = new Set([
+    "missing-doctype",
+    "open-elements-left-after-eof",
+    "duplicate-attribute",
+]);
+// Elements whose text is not learner-visible prose.
+const SKIPPED_TEXT_ELEMENTS = new Set([
+    "script",
+    "style",
+    "svg",
+    "noscript",
+    "template",
+    "head",
+]);
+const BLOCK_ELEMENTS = new Set([
+    "p",
+    "div",
+    "section",
+    "article",
+    "header",
+    "footer",
+    "main",
+    "aside",
+    "nav",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "li",
+    "ul",
+    "ol",
+    "tr",
+    "td",
+    "th",
+    "table",
+    "blockquote",
+    "pre",
+    "figure",
+    "figcaption",
+    "button",
+    "label",
+    "br",
+    "hr",
+    "summary",
+    "details",
+    "dt",
+    "dd",
+]);
+export function isWidgetPath(path) {
+    return path.startsWith("widgets/") || path.includes("/widgets/");
+}
+export function parseWidget(content, file) {
+    const errors = [];
+    const fm = parseFrontmatter(stripAuthoringMarkup(content), file);
+    if (fm.error) {
+        errors.push(fm.error);
+        return { widget: null, errors };
+    }
+    errors.push(...validateFrontmatter(fm.frontmatter, "widget", file));
+    const html = fm.body.trim();
+    if (!html) {
+        errors.push({
+            file,
+            line: fm.bodyStartLine,
+            message: "Widget body is empty",
+            suggestion: "Write the widget's HTML document below the frontmatter (a complete <!doctype html> page with its own CSS and JS)",
+            severity: "error",
+        });
+        return { widget: null, errors };
+    }
+    if (Buffer.byteLength(html, "utf8") > MAX_WIDGET_HTML_BYTES) {
+        errors.push({
+            file,
+            line: fm.bodyStartLine,
+            message: `Widget HTML is larger than ${MAX_WIDGET_HTML_BYTES / 1024}KB`,
+            suggestion: "Widgets are inlined into every module that uses them; move large data or media to an external URL",
+            severity: "error",
+        });
+    }
+    const { document, parseErrors } = parseHtmlDocument(html);
+    // Tag-balance findings first: they name the tag and line an author can act
+    // on, where a tokenizer error code often only says where parsing went wrong.
+    const htmlErrors = [...checkTagBalance(html), ...parseErrors];
+    for (const err of htmlErrors.slice(0, MAX_REPORTED_HTML_ERRORS)) {
+        errors.push({
+            file,
+            line: fm.bodyStartLine + err.line - 1,
+            message: `Invalid HTML: ${err.code}`,
+            suggestion: "Fix the markup so the page parses cleanly; a broken widget shows learners a 'could not be loaded' notice",
+            severity: "error",
+        });
+    }
+    if (htmlErrors.length > MAX_REPORTED_HTML_ERRORS) {
+        errors.push({
+            file,
+            line: fm.bodyStartLine,
+            message: `Invalid HTML: ${htmlErrors.length - MAX_REPORTED_HTML_ERRORS} more problem(s) not shown`,
+            suggestion: "Fix the ones above and re-validate",
+            severity: "error",
+        });
+    }
+    const height = frontmatterString(fm.frontmatter.height);
+    if (height !== undefined && !isValidHeight(height)) {
+        errors.push({
+            file,
+            line: 2,
+            message: `Invalid widget height: ${height}`,
+            suggestion: 'Use "auto" (default) or a CSS length such as 480px',
+            severity: "error",
+        });
+    }
+    const widget = {
+        html,
+        text: extractVisibleText(document),
+    };
+    const title = frontmatterString(fm.frontmatter.title);
+    if (title)
+        widget.title = title;
+    const summary = frontmatterString(fm.frontmatter.summary_for_tutor);
+    if (summary)
+        widget.summaryForTutor = summary;
+    if (!widget.text && !summary) {
+        // A widget that builds its UI in JavaScript has no static text to give
+        // the tutor; the summary is then the tutor's only view of it.
+        errors.push({
+            file,
+            line: 2,
+            message: "Widget has no visible text in its HTML and no summary_for_tutor; the tutor cannot see what the learner does here",
+            suggestion: "Add summary_for_tutor to the frontmatter describing what the widget shows and what the learner does with it",
+            severity: "warning",
+        });
+    }
+    if (height && isValidHeight(height))
+        widget.height = height;
+    return { widget, errors };
+}
+function frontmatterString(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    const str = String(value).trim();
+    return str === "" ? undefined : str;
+}
+function isValidHeight(height) {
+    return height === "auto" || /^\d+(\.\d+)?(px|rem|em|vh)$/.test(height);
+}
+const MAX_REPORTED_HTML_ERRORS = 5;
+// Browsers (and parse5) silently recover from stray or mis-nested end tags,
+// so the HTML5 parser reports nothing for the mistakes authors actually make.
+// This pass walks the token stream with an open-element stack for the tags
+// that have no implicit-close rules and reports what the recovery hides.
+const STRICT_TAGS = new Set([
+    "div",
+    "section",
+    "article",
+    "main",
+    "header",
+    "footer",
+    "aside",
+    "nav",
+    "span",
+    "a",
+    "button",
+    "label",
+    "table",
+    "ul",
+    "ol",
+    "form",
+    "select",
+    "textarea",
+    "details",
+    "summary",
+    "figure",
+    "figcaption",
+    "blockquote",
+    "pre",
+    "code",
+    "em",
+    "strong",
+    "b",
+    "i",
+    "small",
+    "sup",
+    "sub",
+    "svg",
+    "h1",
+    "h2",
+    "h3",
+    "h4",
+    "h5",
+    "h6",
+    "script",
+    "style",
+    "template",
+    "iframe",
+    "canvas",
+    "video",
+    "audio",
+]);
+const VOID_TAGS = new Set([
+    "area",
+    "base",
+    "br",
+    "col",
+    "embed",
+    "hr",
+    "img",
+    "input",
+    "link",
+    "meta",
+    "source",
+    "track",
+    "wbr",
+]);
+// Unclosed at EOF, these swallow the rest of the document.
+const MUST_CLOSE_TAGS = new Set(["script", "style", "template", "textarea"]);
+const RAWTEXT_TAGS = new Set(["style", "xmp", "iframe", "noembed", "noframes"]);
+const RCDATA_TAGS = new Set(["textarea", "title"]);
+function checkTagBalance(html) {
+    const errors = [];
+    // Open strict elements (and every element inside <svg>, where nesting is XML-strict).
+    const stack = [];
+    let svgDepth = 0;
+    const line = (token) => token.location?.startLine ?? 1;
+    const tokenizer = new Tokenizer({ sourceCodeLocationInfo: true }, {
+        onStartTag(token) {
+            const tag = token.tagName;
+            if (tag === "script")
+                tokenizer.state = TokenizerMode.SCRIPT_DATA;
+            else if (RAWTEXT_TAGS.has(tag))
+                tokenizer.state = TokenizerMode.RAWTEXT;
+            else if (RCDATA_TAGS.has(tag))
+                tokenizer.state = TokenizerMode.RCDATA;
+            if (svgDepth > 0 || tag === "svg") {
+                if (tag === "svg")
+                    svgDepth += 1;
+                if (token.selfClosing) {
+                    if (tag === "svg")
+                        svgDepth -= 1;
+                }
+                else {
+                    stack.push({ tag, line: line(token) });
+                }
+                return;
+            }
+            if (VOID_TAGS.has(tag))
+                return;
+            if (token.selfClosing) {
+                errors.push({
+                    code: `self-closing <${tag}/> is not allowed in HTML (the element stays open)`,
+                    line: line(token),
+                });
+            }
+            if (STRICT_TAGS.has(tag))
+                stack.push({ tag, line: line(token) });
+        },
+        onEndTag(token) {
+            const tag = token.tagName;
+            if (svgDepth === 0 && !STRICT_TAGS.has(tag))
+                return;
+            const index = stack.map((e) => e.tag).lastIndexOf(tag);
+            if (index === -1) {
+                errors.push({
+                    code: `stray end tag </${tag}> (no open <${tag}>)`,
+                    line: line(token),
+                });
+                return;
+            }
+            for (let i = stack.length - 1; i > index; i--) {
+                errors.push({
+                    code: `</${tag}> closes while <${stack[i].tag}> (line ${stack[i].line}) is still open`,
+                    line: line(token),
+                });
+            }
+            const closed = stack.splice(index);
+            svgDepth -= closed.filter((e) => e.tag === "svg").length;
+        },
+        onEof() {
+            for (const open of stack) {
+                if (MUST_CLOSE_TAGS.has(open.tag)) {
+                    errors.push({
+                        code: `<${open.tag}> is never closed; everything after it is swallowed`,
+                        line: open.line,
+                    });
+                }
+            }
+        },
+        onComment() { },
+        onDoctype() { },
+        onCharacter() { },
+        onWhitespaceCharacter() { },
+        onNullCharacter() { },
+        onParseError() { },
+    });
+    tokenizer.write(html, true);
+    return errors;
+}
+function parseHtmlDocument(html) {
+    const parseErrors = [];
+    const document = parseHtml(html, {
+        sourceCodeLocationInfo: true,
+        onParseError: (err) => {
+            if (BENIGN_PARSE_ERRORS.has(err.code))
+                return;
+            parseErrors.push({ code: err.code, line: err.startLine });
+        },
+    });
+    return { document, parseErrors };
+}
+/**
+ * Learner-visible text of the document, block elements separated by blank
+ * lines, whitespace collapsed. Scripts, styles and SVG geometry are left out.
+ */
+export function extractVisibleText(document) {
+    const parts = [];
+    const visit = (node) => {
+        if (defaultTreeAdapter.isTextNode(node)) {
+            parts.push(node.value);
+            return;
+        }
+        if (defaultTreeAdapter.isCommentNode(node))
+            return;
+        if (defaultTreeAdapter.isElementNode(node)) {
+            const tag = node.tagName.toLowerCase();
+            if (SKIPPED_TEXT_ELEMENTS.has(tag))
+                return;
+            const block = BLOCK_ELEMENTS.has(tag);
+            if (block)
+                parts.push("\n\n");
+            for (const child of node.childNodes)
+                visit(child);
+            if (block)
+                parts.push("\n\n");
+            return;
+        }
+        if ("childNodes" in node) {
+            for (const child of node.childNodes)
+                visit(child);
+        }
+    };
+    visit(document);
+    return parts
+        .join("")
+        .split(/\n\s*\n/)
+        .map((para) => para.replace(/\s+/g, " ").trim())
+        .filter((para) => para.length > 0)
+        .join("\n\n");
+}
+//# sourceMappingURL=widget.js.map

package/dist/parser/widget.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"widget.js","sourceRoot":"","sources":["../../src/parser/widget.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,EAAE;AACF,qEAAqE;AACrE,8EAA8E;AAC9E,6EAA6E;AAC7E,8EAA8E;AAC9E,0EAA0E;AAC1E,0EAA0E;AAC1E,WAAW;AACX,OAAO,EACL,KAAK,IAAI,SAAS,EAClB,kBAAkB,EAClB,SAAS,EACT,aAAa,GAGd,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAkB9D,iFAAiF;AACjF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,CAAC;AAEhD,+EAA+E;AAC/E,uEAAuE;AACvE,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,iBAAiB;IACjB,8BAA8B;IAC9B,qBAAqB;CACtB,CAAC,CAAC;AAEH,oDAAoD;AACpD,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,QAAQ;IACR,OAAO;IACP,KAAK;IACL,UAAU;IACV,UAAU;IACV,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC;IAC7B,GAAG;IACH,KAAK;IACL,SAAS;IACT,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,YAAY;IACZ,KAAK;IACL,QAAQ;IACR,YAAY;IACZ,QAAQ;IACR,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,SAAS;IACT,SAAS;IACT,IAAI;IACJ,IAAI;CACL,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe,EAAE,IAAY;IACvD,MAAM,MAAM,GAAmB,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,gBAAgB,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;IACjE,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACtB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IAEpE,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,EAAE,CAAC,aAAa;YACtB,OAAO,EAAE,sBAAsB;YAC/B,UAAU,EACR,kHAAkH;YACpH,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,GAAG,qBAAqB,EAAE,CAAC;QAC5D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,EAAE,CAAC,aAAa;YACtB,OAAO,EAAE,8BAA8B,qBAAqB,GAAG,IAAI,IAAI;YACvE,UAAU,EACR,mGAAmG;YACrG,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC1D,2EAA2E;IAC3E,6EAA6E;IAC7E,MAAM,UAAU,GAAG,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,EAAE,GAAG,WAAW,CAAC,CAAC;IAC9D,KAAK,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,wBAAwB,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,EAAE,CAAC,aAAa,GAAG,GAAG,CAAC,IAAI,GAAG,CAAC;YACrC,OAAO,EAAE,iBAAiB,GAAG,CAAC,IAAI,EAAE;YACpC,UAAU,EACR,0GAA0G;YAC5G,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,CAAC,MAAM,GAAG,wBAAwB,EAAE,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,EAAE,CAAC,aAAa;YACtB,OAAO,EAAE,iBAAiB,UAAU,CAAC,MAAM,GAAG,wBAAwB,4BAA4B;YAClG,UAAU,EAAE,oCAAoC;YAChD,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,0BAA0B,MAAM,EAAE;YAC3C,UAAU,EAAE,oDAAoD;YAChE,QAAQ,EAAE,OAAO;SAClB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAiB;QAC3B,IAAI;QACJ,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC;KACnC,CAAC;IACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,IAAI,KAAK;QAAE,MAAM,CAAC,KAAK,GAAG,KAAK,CAAC;IAChC,MAAM,OAAO,GAAG,iBAAiB,CAAC,EAAE,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;IACpE,IAAI,OAAO;QAAE,MAAM,CAAC,eAAe,GAAG,OAAO,CAAC;IAC9C,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,uEAAuE;QACvE,8DAA8D;QAC9D,MAAM,CAAC,IAAI,CAAC;YACV,IAAI;YACJ,IAAI,EAAE,CAAC;YACP,OAAO,EACL,kHAAkH;YACpH,UAAU,EACR,6GAA6G;YAC/G,QAAQ,EAAE,SAAS;SACpB,CAAC,CAAC;IACL,CAAC;IACD,IAAI,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;IAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAC5B,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjC,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,MAAM,KAAK,MAAM,IAAI,6BAA6B,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACzE,CAAC;AAOD,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC,4EAA4E;AAC5E,8EAA8E;AAC9E,2EAA2E;AAC3E,yEAAyE;AACzE,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,KAAK;IACL,SAAS;IACT,SAAS;IACT,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,KAAK;IACL,MAAM;IACN,GAAG;IACH,QAAQ;IACR,OAAO;IACP,OAAO;IACP,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,UAAU;IACV,SAAS;IACT,SAAS;IACT,QAAQ;IACR,YAAY;IACZ,YAAY;IACZ,KAAK;IACL,MAAM;IACN,IAAI;IACJ,QAAQ;IACR,GAAG;IACH,GAAG;IACH,OAAO;IACP,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,QAAQ;IACR,OAAO;IACP,UAAU;IACV,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,OAAO;CACR,CAAC,CAAC;AACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC;IACxB,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,OAAO;IACP,IAAI;IACJ,KAAK;IACL,OAAO;IACP,MAAM;IACN,MAAM;IACN,QAAQ;IACR,OAAO;IACP,KAAK;CACN,CAAC,CAAC;AACH,2DAA2D;AAC3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC7E,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAChF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;AAEnD,SAAS,eAAe,CAAC,IAAY;IACnC,MAAM,MAAM,GAAqB,EAAE,CAAC;IACpC,sFAAsF;IACtF,MAAM,KAAK,GAAyC,EAAE,CAAC;IACvD,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,MAAM,IAAI,GAAG,CAAC,KAAqB,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,CAAC;IAEvE,MAAM,SAAS,GAAG,IAAI,SAAS,CAC7B,EAAE,sBAAsB,EAAE,IAAI,EAAE,EAChC;QACE,UAAU,CAAC,KAAK;YACd,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,IAAI,GAAG,KAAK,QAAQ;gBAAE,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC;iBAC7D,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC;iBACnE,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS,CAAC,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC;YAEtE,IAAI,QAAQ,GAAG,CAAC,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;gBAClC,IAAI,GAAG,KAAK,KAAK;oBAAE,QAAQ,IAAI,CAAC,CAAC;gBACjC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;oBACtB,IAAI,GAAG,KAAK,KAAK;wBAAE,QAAQ,IAAI,CAAC,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACN,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzC,CAAC;gBACD,OAAO;YACT,CAAC;YACD,IAAI,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC/B,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;gBACtB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,iBAAiB,GAAG,oDAAoD;oBAC9E,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,IAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,QAAQ,CAAC,KAAK;YACZ,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;YAC1B,IAAI,QAAQ,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YACpD,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACvD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,mBAAmB,GAAG,eAAe,GAAG,IAAI;oBAClD,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;iBAClB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC9C,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,KAAK,GAAG,mBAAmB,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,iBAAiB;oBACtF,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC;iBAClB,CAAC,CAAC;YACL,CAAC;YACD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnC,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;QAC3D,CAAC;QACD,KAAK;YACH,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;oBAClC,MAAM,CAAC,IAAI,CAAC;wBACV,IAAI,EAAE,IAAI,IAAI,CAAC,GAAG,qDAAqD;wBACvE,IAAI,EAAE,IAAI,CAAC,IAAI;qBAChB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;QACD,SAAS,KAAI,CAAC;QACd,SAAS,KAAI,CAAC;QACd,WAAW,KAAI,CAAC;QAChB,qBAAqB,KAAI,CAAC;QAC1B,eAAe,KAAI,CAAC;QACpB,YAAY,KAAI,CAAC;KAClB,CACF,CAAC;IACF,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,iBAAiB,CAAC,IAAY;IAIrC,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,SAAS,CAAC,IAAI,EAAE;QAC/B,sBAAsB,EAAE,IAAI;QAC5B,YAAY,EAAE,CAAC,GAAG,EAAE,EAAE;YACpB,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,OAAO;YAC9C,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;QAC5D,CAAC;KACF,CAAC,CAAC;IACH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAA0C;IAE1C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,CAAC,IAAkC,EAAQ,EAAE;QACzD,IAAI,kBAAkB,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QACD,IAAI,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC;YAAE,OAAO;QACnD,IAAI,kBAAkB,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACvC,IAAI,qBAAqB,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,OAAO;YAC3C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;YAClD,IAAI,KAAK;gBAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC9B,OAAO;QACT,CAAC;QACD,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;YACzB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,UAAU;gBAAE,KAAK,CAAC,KAAK,CAAC,CAAC;QACpD,CAAC;IACH,CAAC,CAAC;IACF,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChB,OAAO,KAAK;SACT,IAAI,CAAC,EAAE,CAAC;SACR,KAAK,CAAC,SAAS,CAAC;SAChB,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SAC/C,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC"}

package/dist/same-page-links.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+export interface BlockTarget {
+    kind: "heading" | "block";
+    heading?: string;
+}
+/** Find every valid block marker and the Markdown block it labels. */
+export declare function collectBlockTargets(source: string): Map<string, BlockTarget>;
+export declare function collectBlockTargetsFrom(sources: Iterable<string>): Map<string, BlockTarget>;
+/** Mask code and math examples without changing source offsets. */
+export declare function maskCode(value: string): string;
+/** Convert canonical same-page wikilinks to the renderer-private block scheme. */
+export declare function resolveSamePageLinks(content: string, targets: ReadonlyMap<string, BlockTarget>): string;

package/dist/same-page-links.js ADDED Viewed

@@ -0,0 +1,109 @@
+import { toString } from "mdast-util-to-string";
+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";
+const BLOCK_MARKER_RE = /(?:^|\s)\^([A-Za-z0-9-]+)\s*$/;
+function parseMarkdown(source) {
+    return unified()
+        .use(remarkParse)
+        .use(remarkGfm)
+        .use(remarkDirective)
+        // Single dollars are currency in Lens content; the renderer parses them
+        // the same way (LensMarkdown.tsx). With the default, "$5 ... $10" would
+        // become inline math and mask any [[#^id]] link between the amounts.
+        .use(remarkMath, { singleDollarTextMath: false })
+        .parse(source);
+}
+function targetFor(node, id) {
+    if (node.type !== "heading")
+        return { kind: "block" };
+    return {
+        kind: "heading",
+        heading: toString(node)
+            .replace(new RegExp(`(?:^|\\s+)\\^${id}\\s*$`), "")
+            .trim(),
+    };
+}
+/** Find every valid block marker and the Markdown block it labels. */
+export function collectBlockTargets(source) {
+    const tree = parseMarkdown(source);
+    const targets = 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.type === "heading") {
+                const last = node.children.at(-1);
+                const match = last?.type === "text" && last.value.match(BLOCK_MARKER_RE);
+                if (match) {
+                    const markerOnly = node.type === "paragraph" &&
+                        node.children.length === 1 &&
+                        last.value.trim() === `^${match[1]}`;
+                    const target = markerOnly && index > 0 ? parent.children[index - 1] : node;
+                    if ("children" in target) {
+                        targets.set(match[1], targetFor(target, match[1]));
+                    }
+                }
+            }
+            if ("children" in node && Array.isArray(node.children))
+                walk(node);
+        }
+    };
+    walk(tree);
+    return targets;
+}
+export function collectBlockTargetsFrom(sources) {
+    const targets = new Map();
+    for (const source of sources) {
+        for (const [id, target] of collectBlockTargets(source))
+            targets.set(id, target);
+    }
+    return targets;
+}
+function markdownLabel(value) {
+    return value.replace(/([\\[\]])/g, "\\$1");
+}
+/** Mask code and math examples without changing source offsets. */
+export function maskCode(value) {
+    const chars = value.split("");
+    visit(parseMarkdown(value), (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] = " ";
+        }
+    });
+    return chars.join("");
+}
+/** Convert canonical same-page wikilinks to the renderer-private block scheme. */
+export function resolveSamePageLinks(content, targets) {
+    const matches = Array.from(maskCode(content).matchAll(/(?<!\\)(?<!!)\[\[#\^([A-Za-z0-9-]+)(?:\|([^\]]+))?\]\]/g));
+    let resolved = content;
+    for (const match of matches.reverse()) {
+        const [fullMatch, id, authoredLabel] = match;
+        if (match.index === undefined)
+            continue;
+        // maskCode blanks inline code, so take the label from the unmasked text;
+        // masking keeps offsets, and the label always ends just before "]]".
+        const labelEnd = match.index + fullMatch.length - 2;
+        const label = (authoredLabel === undefined
+            ? ""
+            : content.slice(labelEnd - authoredLabel.length, labelEnd)).trim() || targets.get(id)?.heading;
+        if (!label)
+            continue;
+        const replacement = `[${markdownLabel(label)}](anchor:block:${encodeURIComponent(id)})`;
+        resolved =
+            resolved.slice(0, match.index) +
+                replacement +
+                resolved.slice(match.index + fullMatch.length);
+    }
+    return resolved;
+}
+//# sourceMappingURL=same-page-links.js.map

package/dist/same-page-links.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"same-page-links.js","sourceRoot":"","sources":["../src/same-page-links.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,eAAe,MAAM,kBAAkB,CAAC;AAC/C,OAAO,SAAS,MAAM,YAAY,CAAC;AACnC,OAAO,UAAU,MAAM,aAAa,CAAC;AACrC,OAAO,WAAW,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAOzC,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAExD,SAAS,aAAa,CAAC,MAAc;IACnC,OACE,OAAO,EAAE;SACN,GAAG,CAAC,WAAW,CAAC;SAChB,GAAG,CAAC,SAAS,CAAC;SACd,GAAG,CAAC,eAAe,CAAC;QACrB,wEAAwE;QACxE,wEAAwE;QACxE,qEAAqE;SACpE,GAAG,CAAC,UAAU,EAAE,EAAE,oBAAoB,EAAE,KAAK,EAAE,CAAC;SAChD,KAAK,CAAC,MAAM,CAChB,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,EAAU;IACzC,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACtD,OAAO;QACL,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC;aACpB,OAAO,CAAC,IAAI,MAAM,CAAC,gBAAgB,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC;aAClD,IAAI,EAAE;KACV,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAE/C,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,EAAE;QAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACpC,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACzD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;gBAClC,MAAM,KAAK,GACT,IAAI,EAAE,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;gBAC7D,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,UAAU,GACd,IAAI,CAAC,IAAI,KAAK,WAAW;wBACzB,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;wBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvC,MAAM,MAAM,GACV,UAAU,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBAC9D,IAAI,UAAU,IAAI,MAAM,EAAE,CAAC;wBACzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,MAAgB,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;oBAC/D,CAAC;gBACH,CAAC;YACH,CAAC;YACD,IAAI,UAAU,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACpD,IAAI,CAAC,IAAc,CAAC,CAAC;QACzB,CAAC;IACH,CAAC,CAAC;IACF,IAAI,CAAC,IAAI,CAAC,CAAC;IACX,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,OAAyB;IAEzB,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,KAAK,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,OAAO,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,QAAQ,CAAC,KAAa;IACpC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9B,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE;QACnC,IAAI,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YACnE,OAAO;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC;QACtC,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO;QACrD,KAAK,IAAI,KAAK,GAAG,KAAK,EAAE,KAAK,GAAG,GAAG,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI;gBAAE,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC;QAChD,CAAC;IACH,CAAC,CAAC,CAAC;IACH,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAClC,OAAe,EACf,OAAyC;IAEzC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,QAAQ,CAAC,OAAO,CAAC,CAAC,QAAQ,CACxB,yDAAyD,CAC1D,CACF,CAAC;IACF,IAAI,QAAQ,GAAG,OAAO,CAAC;IACvB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACtC,MAAM,CAAC,SAAS,EAAE,EAAE,EAAE,aAAa,CAAC,GAAG,KAAK,CAAC;QAC7C,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACxC,yEAAyE;QACzE,qEAAqE;QACrE,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;QACpD,MAAM,KAAK,GACT,CAAC,aAAa,KAAK,SAAS;YAC1B,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,QAAQ,CAAC,CAC3D,CAAC,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC;QACvC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,MAAM,WAAW,GAAG,IAAI,aAAa,CAAC,KAAK,CAAC,kBAAkB,kBAAkB,CAAC,EAAE,CAAC,GAAG,CAAC;QACxF,QAAQ;YACN,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC;gBAC9B,WAAW;gBACX,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/validator/article-structure.js CHANGED Viewed

@@ -4,6 +4,7 @@ import { parseMarkdown } from "./markdown-parse.js";
 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";
 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(" ");
@@ -18,14 +19,6 @@ function issue(file, bodyStartLine, code, severity, message, line, suggestion) {
         ...(suggestion ? { suggestion } : {}),
     };
 }
-function renderedHeadingId(value) {
-    return value
-        .toLowerCase()
-        .replace(/[^a-z0-9\s-]/g, "")
-        .replace(/\s+/g, "-")
-        .replace(/-+/g, "-")
-        .slice(0, 50);
-}
 function lineAt(source, offset) {
     return source.slice(0, offset).split("\n").length;
 }
@@ -273,14 +266,16 @@ export function validateArticleStructure(content, file) {
     const body = stripAuthoringMarkupForValidation(fm.body);
     const bodyStartLine = fm.bodyStartLine;
     const sourceUrl = fm.frontmatter.source_url;
-    const errors = [...scanFences(body, file, bodyStartLine)];
+    const errors = [
+        ...scanFences(body, file, bodyStartLine),
+        ...validateArticleSamePageLinks(body, file, bodyStartLine - 1),
+    ];
     const tree = parseMarkdown(body, "gfm-directive-math");
     const prose = proseMask(body);
     const inlineMathScanSource = maskNodes(body, tree, new Set(["code", "inlineCode", "math", "image", "imageReference"]));
     const definitions = new Map();
     const referencedFootnotes = new Map();
     const definedFootnotes = new Map();
-    const headingIds = new Set();
     const imageOccurrences = new Map();
     const externalSelfFragments = new Set();
     const blocks = [];
@@ -298,35 +293,6 @@ export function validateArticleStructure(content, file) {
     visit(tree, "definition", (node) => {
         definitions.set(node.identifier.toLowerCase(), node.url);
     });
-    // ArticleSectionWrapper pre-registers H1-H3 IDs for the table of contents.
-    // Duplicate lower-level headings fall back to their unsuffixed slug unless
-    // their exact text is also registered. Mirror that behavior here rather
-    // than applying GitHub-style suffixes to every heading.
-    const registeredHeadingIds = new Map();
-    const registeredBaseCounts = new Map();
-    visit(tree, "heading", (node) => {
-        if (node.depth > 3)
-            return;
-        const text = toString(node);
-        const base = renderedHeadingId(text);
-        const count = registeredBaseCounts.get(base) ?? 0;
-        const ids = registeredHeadingIds.get(text) ?? [];
-        ids.push(count === 0 ? base : `${base}-${count}`);
-        registeredHeadingIds.set(text, ids);
-        registeredBaseCounts.set(base, count + 1);
-    });
-    const renderedTextCounts = new Map();
-    visit(tree, "heading", (node) => {
-        const text = toString(node);
-        const registered = registeredHeadingIds.get(text);
-        if (!registered?.length) {
-            headingIds.add(renderedHeadingId(text));
-            return;
-        }
-        const count = renderedTextCounts.get(text) ?? 0;
-        headingIds.add(registered[count] ?? registered[registered.length - 1]);
-        renderedTextCounts.set(text, count + 1);
-    });
     visit(tree, "footnoteReference", (node) => {
         referencedFootnotes.set(node.identifier.toLowerCase(), node.position?.start.line ?? 1);
     });
@@ -381,7 +347,7 @@ export function validateArticleStructure(content, file) {
                 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 a local #fragment link for content imported into this article. If this deliberately targets source-only content that was not imported, place this exemption immediately above the link: ${formatValidatorSuppression(externalSelfFragmentSuppression)}`));
+                    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)}`));
                 }
             }
             const start = positioned.position?.start.offset;
@@ -595,17 +561,6 @@ export function validateArticleStructure(content, file) {
         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(/\]\(#([^\s)]+)\)/g)) {
-        let fragment;
-        try {
-            fragment = decodeURIComponent(match[1]).toLowerCase();
-        }
-        catch {
-            fragment = match[1].toLowerCase();
-        }
-        if (!headingIds.has(fragment))
-            errors.push(issue(file, bodyStartLine, "article.fragment-target-missing", "error", `Fragment target '#${match[1]}' does not resolve to a rendered heading`, 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");