mdrefine 0.2.0-rc.2 → 0.2.0

package/dist/rules/content.js

@@ -0,0 +1,85 @@
+import { walk } from "../syntax/walk.js";
+import { range } from "../syntax/parse.js";
+import { optionsSchema } from "./style.js";
+/** `|100` or `|100x50` at the end of an Obsidian image's text sets its size, not its text. */
+const obsidianSize = /\|\d+(?:x\d+)?$/;
+export const contentRules = {
+    "content/image-alt": {
+        description: "Report images without alternative text.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            const findings = [];
+            // Obsidian's `![[image.png]]` embeds are wikilinks, which have no place for the text.
+            walk(document.tree, (node) => {
+                if (node.type !== "image" && node.type !== "imageReference")
+                    return;
+                let alt = node.alt ?? "";
+                if (document.dialect === "obsidian")
+                    alt = alt.replace(obsidianSize, "");
+                if (alt.trim())
+                    return;
+                const [start, end] = range(node);
+                findings.push({
+                    start,
+                    end,
+                    message: "Add alternative text to the image, for readers who cannot see it.",
+                });
+            });
+            return findings;
+        },
+    },
+    "content/table-columns": {
+        description: "Report table rows with more or fewer cells than the header row.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            const findings = [];
+            walk(document.tree, "table", (node) => {
+                const [header, ...rows] = node.children;
+                const columns = header?.children.length ?? 0;
+                for (const row of rows) {
+                    const cells = row.children.length;
+                    if (cells === columns)
+                        continue;
+                    const [start, end] = range(row);
+                    const counted = `Row has ${cells} ${cells === 1 ? "cell" : "cells"} and the header ${columns}`;
+                    findings.push({
+                        start,
+                        end,
+                        message: cells > columns
+                            ? `${counted}; ${cells - columns === 1 ? "the extra cell is" : "the extra cells are"} not shown.`
+                            : `${counted}; the row is shown with ${columns - cells === 1 ? "an empty cell" : "empty cells"} added.`,
+                    });
+                }
+            });
+            return findings;
+        },
+    },
+    "content/code-language": {
+        description: "Report fenced code blocks that do not name a language.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            const findings = [];
+            walk(document.tree, "code", (node) => {
+                const [start] = range(node);
+                // An indented code block starts with its indentation, and has no place for a language.
+                const fence = document.source[start];
+                if (node.lang || (fence !== "`" && fence !== "~"))
+                    return;
+                let end = start;
+                while (document.source[end] === fence)
+                    end++;
+                const marker = document.source.slice(start, end);
+                findings.push({
+                    start,
+                    end,
+                    message: `Name the code block's language after its opening fence, such as ${marker}sh, or ${marker}text for plain text.`,
+                });
+            });
+            return findings;
+        },
+    },
+};
+//# sourceMappingURL=content.js.map

package/dist/rules/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/rules/content.ts"],"names":[],"mappings":"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","sourcesContent":["import { walk } from \"../syntax/walk.js\";\nimport type { Finding, Rule } from \"../core/types.js\";\nimport { range } from \"../syntax/parse.js\";\nimport { optionsSchema } from \"./style.js\";\n\n/** `|100` or `|100x50` at the end of an Obsidian image's text sets its size, not its text. */\nconst obsidianSize = /\\|\\d+(?:x\\d+)?$/;\n\nexport const contentRules: Record<string, Rule> = {\n  \"content/image-alt\": {\n    description: \"Report images without alternative text.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      const findings: Finding[] = [];\n      // Obsidian's `![[image.png]]` embeds are wikilinks, which have no place for the text.\n      walk(document.tree, (node) => {\n        if (node.type !== \"image\" && node.type !== \"imageReference\") return;\n        let alt = node.alt ?? \"\";\n        if (document.dialect === \"obsidian\") alt = alt.replace(obsidianSize, \"\");\n        if (alt.trim()) return;\n        const [start, end] = range(node);\n        findings.push({\n          start,\n          end,\n          message: \"Add alternative text to the image, for readers who cannot see it.\",\n        });\n      });\n      return findings;\n    },\n  },\n  \"content/table-columns\": {\n    description: \"Report table rows with more or fewer cells than the header row.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      const findings: Finding[] = [];\n      walk(document.tree, \"table\", (node) => {\n        const [header, ...rows] = node.children;\n        const columns = header?.children.length ?? 0;\n        for (const row of rows) {\n          const cells = row.children.length;\n          if (cells === columns) continue;\n          const [start, end] = range(row);\n          const counted = `Row has ${cells} ${cells === 1 ? \"cell\" : \"cells\"} and the header ${columns}`;\n          findings.push({\n            start,\n            end,\n            message:\n              cells > columns\n                ? `${counted}; ${cells - columns === 1 ? \"the extra cell is\" : \"the extra cells are\"} not shown.`\n                : `${counted}; the row is shown with ${columns - cells === 1 ? \"an empty cell\" : \"empty cells\"} added.`,\n          });\n        }\n      });\n      return findings;\n    },\n  },\n  \"content/code-language\": {\n    description: \"Report fenced code blocks that do not name a language.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      const findings: Finding[] = [];\n      walk(document.tree, \"code\", (node) => {\n        const [start] = range(node);\n        // An indented code block starts with its indentation, and has no place for a language.\n        const fence = document.source[start];\n        if (node.lang || (fence !== \"`\" && fence !== \"~\")) return;\n        let end = start;\n        while (document.source[end] === fence) end++;\n        const marker = document.source.slice(start, end);\n        findings.push({\n          start,\n          end,\n          message: `Name the code block's language after its opening fence, such as ${marker}sh, or ${marker}text for plain text.`,\n        });\n      });\n      return findings;\n    },\n  },\n};\n"]}

package/dist/rules/dialects.js

@@ -1,4 +1,5 @@
 import { walk } from "../syntax/walk.js";
+import { blockIdentifier } from "../syntax/block-identifier.js";
 import { range } from "../syntax/parse.js";
 import { headingAttributeBlock } from "../workspace/heading-attributes.js";
 import { optionsSchema } from "./style.js";
@@ -77,13 +78,16 @@ export const dialectRules = {
                 return [];
             const seen = new Set();
             const findings = [];
-            walk(document.tree, "text", (node) => {
-                const match = /(?:^|\s)\^([A-Za-z0-9-]+)\s*$/.exec(node.value);
-                if (!match)
+            walk(document.tree, (node) => {
+                const found = blockIdentifier(document.source, node);
+                if (!found)
                     return;
-                const id = match[1];
+                const { id } = found;
                 if (seen.has(id))
-                    findings.push({ start: range(node)[0], message: `Duplicate block identifier ^${id}.` });
+                    findings.push({
+                        start: range(found.node)[0],
+                        message: `Duplicate block identifier ^${id}.`,
+                    });
                 seen.add(id);
             });
             return findings;
@@ -141,7 +145,7 @@ export const dialectRules = {
                 ? [
                     {
                         start: 0,
-                        message: "Obsidian strictLineBreaks is not verified true; paragraph reflow is disabled. Set it in Obsidian or supply workspace.strictLineBreaks to the library.",
+                        message: "Obsidian's \"Strict line breaks\" setting is not known to be on, so paragraphs are not reflowed. Turn it on in the vault's settings, which keep it in .obsidian/app.json; a program that calls the library passes strictLineBreaks to createWorkspace.",
                     },
                 ]
                 : [];

package/dist/rules/dialects.js.map

@@ -1 +1 @@
-{"version":3,"file":"dialects.js","sourceRoot":"","sources":["../../src/rules/dialects.ts"],"names":[],"mappings":"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","sourcesContent":["import { walk } from \"../syntax/walk.js\";\nimport type { Dialect, Finding, Rule } from \"../core/types.js\";\nimport { range } from \"../syntax/parse.js\";\nimport { headingAttributeBlock } from \"../workspace/heading-attributes.js\";\nimport { optionsSchema } from \"./style.js\";\n\nconst githubAlerts = new Set<Dialect>([\"github\", \"forgejo\", \"gitea\"]);\nfunction calloutRule(obsidian: boolean): Rule {\n  return {\n    description: obsidian\n      ? \"Use lowercase Obsidian callout types.\"\n      : \"Use uppercase GitHub alert types.\",\n    kind: \"style\",\n    phase: \"inline\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      // Forgejo and Gitea render the same five GitHub alert types, case-insensitively.\n      if (obsidian ? document.dialect !== \"obsidian\" : !githubAlerts.has(document.dialect))\n        return [];\n      const findings: Finding[] = [];\n      walk(document.tree, \"blockquote\", (node) => {\n        const child = node.children[0];\n        if (child?.type !== \"paragraph\") return;\n        const start = range(child)[0];\n        const match = /^\\[!([\\w-]+)\\]/.exec(document.source.slice(start));\n        if (!match) return;\n        const original = match[1]!;\n        if (\n          !obsidian &&\n          ![\"NOTE\", \"TIP\", \"IMPORTANT\", \"WARNING\", \"CAUTION\"].includes(original.toUpperCase())\n        )\n          return;\n        const replacement = obsidian ? original.toLowerCase() : original.toUpperCase();\n        if (original !== replacement)\n          findings.push({\n            start: start + 2,\n            end: start + 2 + original.length,\n            message: `Use ${replacement} for the callout type.`,\n            edit: { start: start + 2, end: start + 2 + original.length, text: replacement },\n          });\n      });\n      return findings;\n    },\n  };\n}\nexport const dialectRules: Record<string, Rule> = {\n  \"github/alert-marker\": calloutRule(false),\n  \"obsidian/callout-marker\": calloutRule(true),\n  \"github/task-marker\": {\n    description: \"Use lowercase x in completed task markers.\",\n    kind: \"style\",\n    phase: \"inline\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      const findings: Finding[] = [];\n      walk(document.tree, \"listItem\", (node) => {\n        if (node.checked !== true) return;\n        const start = range(node)[0];\n        const match = /^(?:[-+*]|\\d+[.)])\\s+\\[X\\]/.exec(document.source.slice(start));\n        if (!match) return;\n        const offset = start + match[0].length - 2;\n        findings.push({\n          start: offset,\n          message: \"Use lowercase x in task markers.\",\n          edit: { start: offset, end: offset + 1, text: \"x\" },\n        });\n      });\n      return findings;\n    },\n  },\n  \"obsidian/block-reference\": {\n    description: \"Report duplicate block identifiers.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      if (document.dialect !== \"obsidian\") return [];\n      const seen = new Set<string>();\n      const findings: Finding[] = [];\n      walk(document.tree, \"text\", (node) => {\n        const match = /(?:^|\\s)\\^([A-Za-z0-9-]+)\\s*$/.exec(node.value);\n        if (!match) return;\n        const id = match[1]!;\n        if (seen.has(id))\n          findings.push({ start: range(node)[0], message: `Duplicate block identifier ^${id}.` });\n        seen.add(id);\n      });\n      return findings;\n    },\n  },\n  \"forgejo/heading-id\": {\n    description:\n      \"Report heading attribute ids that are not text, which Forgejo and Gitea before 1.26 cannot render.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      if (document.dialect !== \"forgejo\" && document.dialect !== \"gitea\") return [];\n      const findings: Finding[] = [];\n      const { source } = document;\n      walk(document.tree, \"heading\", (node) => {\n        const [start, end] = range(node);\n        // The block ends an ATX heading's line or the last text line of a\n        // Setext heading, whose last line is its underline.\n        const breaks = [...source.slice(start, end).matchAll(/\\r\\n?|\\n/g)];\n        const underline = breaks.at(-1);\n        const previous = breaks.at(-2);\n        const lineStart = previous ? start + previous.index + previous[0].length : start;\n        let lineEnd = underline ? start + underline.index : end;\n        while (source[lineEnd - 1] === \" \" || source[lineEnd - 1] === \"\\t\") lineEnd--;\n        let line = source.slice(lineStart, lineEnd);\n        let block = headingAttributeBlock(line);\n        // Gitea before 1.26 also reads a block followed by a closing `#` sequence.\n        if (!block && !underline) {\n          const closed = /[ \\t]+#+$/.exec(line);\n          if (closed) {\n            line = line.slice(0, closed.index);\n            block = headingAttributeBlock(line);\n          }\n        }\n        // goldmark hands a number, boolean, null, or list to the renderers,\n        // which expect text: Gitea 1.26 and later give the heading an empty\n        // id, Forgejo and earlier Gitea versions fail on the whole document.\n        if (block?.id === null)\n          findings.push({\n            start: lineStart + block.start,\n            end: lineStart + line.length,\n            message:\n              'Heading id is not text: Forgejo, and Gitea before 1.26, cannot render a document containing it. Quote it: {id=\"5\"}.',\n          });\n      });\n      return findings;\n    },\n  },\n  \"obsidian/strict-line-breaks\": {\n    description: \"Require verified soft-line-break behavior before reflowing an Obsidian document.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document, workspace }) {\n      return document.dialect === \"obsidian\" && workspace?.strictLineBreaks !== true\n        ? [\n            {\n              start: 0,\n              message:\n                \"Obsidian strictLineBreaks is not verified true; paragraph reflow is disabled. Set it in Obsidian or supply workspace.strictLineBreaks to the library.\",\n            },\n          ]\n        : [];\n    },\n  },\n};\n"]}
+{"version":3,"file":"dialects.js","sourceRoot":"","sources":["../../src/rules/dialects.ts"],"names":[],"mappings":"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","sourcesContent":["import { walk } from \"../syntax/walk.js\";\nimport type { Dialect, Finding, Rule } from \"../core/types.js\";\nimport { blockIdentifier } from \"../syntax/block-identifier.js\";\nimport { range } from \"../syntax/parse.js\";\nimport { headingAttributeBlock } from \"../workspace/heading-attributes.js\";\nimport { optionsSchema } from \"./style.js\";\n\nconst githubAlerts = new Set<Dialect>([\"github\", \"forgejo\", \"gitea\"]);\nfunction calloutRule(obsidian: boolean): Rule {\n  return {\n    description: obsidian\n      ? \"Use lowercase Obsidian callout types.\"\n      : \"Use uppercase GitHub alert types.\",\n    kind: \"style\",\n    phase: \"inline\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      // Forgejo and Gitea render the same five GitHub alert types, case-insensitively.\n      if (obsidian ? document.dialect !== \"obsidian\" : !githubAlerts.has(document.dialect))\n        return [];\n      const findings: Finding[] = [];\n      walk(document.tree, \"blockquote\", (node) => {\n        const child = node.children[0];\n        if (child?.type !== \"paragraph\") return;\n        const start = range(child)[0];\n        const match = /^\\[!([\\w-]+)\\]/.exec(document.source.slice(start));\n        if (!match) return;\n        const original = match[1]!;\n        if (\n          !obsidian &&\n          ![\"NOTE\", \"TIP\", \"IMPORTANT\", \"WARNING\", \"CAUTION\"].includes(original.toUpperCase())\n        )\n          return;\n        const replacement = obsidian ? original.toLowerCase() : original.toUpperCase();\n        if (original !== replacement)\n          findings.push({\n            start: start + 2,\n            end: start + 2 + original.length,\n            message: `Use ${replacement} for the callout type.`,\n            edit: { start: start + 2, end: start + 2 + original.length, text: replacement },\n          });\n      });\n      return findings;\n    },\n  };\n}\nexport const dialectRules: Record<string, Rule> = {\n  \"github/alert-marker\": calloutRule(false),\n  \"obsidian/callout-marker\": calloutRule(true),\n  \"github/task-marker\": {\n    description: \"Use lowercase x in completed task markers.\",\n    kind: \"style\",\n    phase: \"inline\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      const findings: Finding[] = [];\n      walk(document.tree, \"listItem\", (node) => {\n        if (node.checked !== true) return;\n        const start = range(node)[0];\n        const match = /^(?:[-+*]|\\d+[.)])\\s+\\[X\\]/.exec(document.source.slice(start));\n        if (!match) return;\n        const offset = start + match[0].length - 2;\n        findings.push({\n          start: offset,\n          message: \"Use lowercase x in task markers.\",\n          edit: { start: offset, end: offset + 1, text: \"x\" },\n        });\n      });\n      return findings;\n    },\n  },\n  \"obsidian/block-reference\": {\n    description: \"Report duplicate block identifiers.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      if (document.dialect !== \"obsidian\") return [];\n      const seen = new Set<string>();\n      const findings: Finding[] = [];\n      walk(document.tree, (node) => {\n        const found = blockIdentifier(document.source, node);\n        if (!found) return;\n        const { id } = found;\n        if (seen.has(id))\n          findings.push({\n            start: range(found.node)[0],\n            message: `Duplicate block identifier ^${id}.`,\n          });\n        seen.add(id);\n      });\n      return findings;\n    },\n  },\n  \"forgejo/heading-id\": {\n    description:\n      \"Report heading attribute ids that are not text, which Forgejo and Gitea before 1.26 cannot render.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document }) {\n      if (document.dialect !== \"forgejo\" && document.dialect !== \"gitea\") return [];\n      const findings: Finding[] = [];\n      const { source } = document;\n      walk(document.tree, \"heading\", (node) => {\n        const [start, end] = range(node);\n        // The block ends an ATX heading's line or the last text line of a\n        // Setext heading, whose last line is its underline.\n        const breaks = [...source.slice(start, end).matchAll(/\\r\\n?|\\n/g)];\n        const underline = breaks.at(-1);\n        const previous = breaks.at(-2);\n        const lineStart = previous ? start + previous.index + previous[0].length : start;\n        let lineEnd = underline ? start + underline.index : end;\n        while (source[lineEnd - 1] === \" \" || source[lineEnd - 1] === \"\\t\") lineEnd--;\n        let line = source.slice(lineStart, lineEnd);\n        let block = headingAttributeBlock(line);\n        // Gitea before 1.26 also reads a block followed by a closing `#` sequence.\n        if (!block && !underline) {\n          const closed = /[ \\t]+#+$/.exec(line);\n          if (closed) {\n            line = line.slice(0, closed.index);\n            block = headingAttributeBlock(line);\n          }\n        }\n        // goldmark hands a number, boolean, null, or list to the renderers,\n        // which expect text: Gitea 1.26 and later give the heading an empty\n        // id, Forgejo and earlier Gitea versions fail on the whole document.\n        if (block?.id === null)\n          findings.push({\n            start: lineStart + block.start,\n            end: lineStart + line.length,\n            message:\n              'Heading id is not text: Forgejo, and Gitea before 1.26, cannot render a document containing it. Quote it: {id=\"5\"}.',\n          });\n      });\n      return findings;\n    },\n  },\n  \"obsidian/strict-line-breaks\": {\n    description: \"Require verified soft-line-break behavior before reflowing an Obsidian document.\",\n    kind: \"problem\",\n    schema: optionsSchema({}),\n    check({ document, workspace }) {\n      return document.dialect === \"obsidian\" && workspace?.strictLineBreaks !== true\n        ? [\n            {\n              start: 0,\n              message:\n                \"Obsidian's \\\"Strict line breaks\\\" setting is not known to be on, so paragraphs are not reflowed. Turn it on in the vault's settings, which keep it in .obsidian/app.json; a program that calls the library passes strictLineBreaks to createWorkspace.\",\n            },\n          ]\n        : [];\n    },\n  },\n};\n"]}

package/dist/rules/links.js

@@ -64,6 +64,205 @@ function destinationRange(raw) {
     }
     return undefined;
 }
+/**
+ * A Markdown link's destination as a wikilink's target, or undefined when a
+ * wikilink cannot hold it. Obsidian takes a wikilink's text as the note's
+ * name, so percent escapes are decoded: `My%20Note.md` is the note `My
+ * Note.md`, which is right whether or not Obsidian decodes escapes in
+ * wikilinks. A destination that does not decode, or whose decoded name holds
+ * a character that a wikilink cannot contain, or that would change its meaning
+ * there, stays a Markdown link.
+ */
+function wikiTarget(url) {
+    const hash = url.indexOf("#");
+    const [name, fragment] = hash < 0 ? [url, undefined] : [url.slice(0, hash), url.slice(hash + 1)];
+    let decodedName;
+    let decodedFragment;
+    try {
+        decodedName = decodeURIComponent(name);
+        decodedFragment = fragment === undefined ? undefined : decodeURIComponent(fragment);
+    }
+    catch {
+        return undefined;
+    }
+    if (/[[\]|#^\r\n]/.test(decodedName) || decodedName.trim() !== decodedName)
+        return undefined;
+    if (decodedFragment !== undefined) {
+        if (/[[\]|\r\n]/.test(decodedFragment))
+            return undefined;
+        // An escaped `#` or `^` would become a separator or a block reference.
+        const marks = (text) => text.replace(/[^#^]/g, "");
+        if (marks(decodedFragment) !== marks(fragment))
+            return undefined;
+    }
+    return decodedFragment === undefined ? decodedName : `${decodedName}#${decodedFragment}`;
+}
+/**
+ * A label as CommonMark matches it: case folded, with its blank space
+ * collapsed and trimmed. This is how the parser computes the `identifier` of
+ * definitions and references, so the two compare equal.
+ */
+function normalizeLabel(label) {
+    return label
+        .replace(/[\t\n\r ]+/g, " ")
+        .replace(/^ | $/g, "")
+        .toLowerCase()
+        .toUpperCase()
+        .toLowerCase();
+}
+/**
+ * A label's text as the parser reads it, from its source: without the block
+ * quote markers and indentation that continue its lines inside a container.
+ */
+function labelText(source) {
+    return source.replace(/(\r\n|\r|\n)[ \t>]*/g, "$1");
+}
+/**
+ * The end, after its `]`, of the link label that starts with the `[` at `at`
+ * and ends before `limit`: the first unescaped `]`, with no unescaped `[`
+ * before it, at most 999 characters, and something besides blank space.
+ */
+function labelEnd(source, at, limit) {
+    let blank = true;
+    for (let i = at + 1; i < limit && i - at <= 1000; i++) {
+        const char = source[i];
+        if (char === "\\" && /[[\]\\]/.test(source[i + 1] ?? "")) {
+            blank = false;
+            i++;
+        }
+        else if (char === "[")
+            return undefined;
+        else if (char === "]")
+            return blank ? undefined : i + 1;
+        else if (!/[ \t\r\n]/.test(char))
+            blank = false;
+    }
+    return undefined;
+}
+/** A GFM footnote label after `^`: no blank space, and brackets only escaped. */
+const footnoteLabel = /^\^((?:\\[[\]\\]|\\(?![[\]\\])|[^\s[\]\\]){1,999})$/;
+/** Inline nodes whose text is read for brackets; any other node is syntax or a link of its own. */
+const transparent = new Set(["emphasis", "strong", "delete"]);
+/**
+ * What before a reference's text makes it no reference to report: an ASCII
+ * letter, digit, `_`, or `)`, as in the indexes `matrix[i][j]` and `f(x)[0][1]`
+ * in prose, or a `]`, which continues a run like `[a][b][c]` that is reported
+ * once, at its start.
+ */
+const notAfter = /[\w\])]/;
+/** Characters that a backslash escapes. */
+const asciiPunctuation = /[!-/:-@[-`{-~]/;
+/**
+ * The full (`[text][label]`) and collapsed (`[label][]`) references, and with
+ * `footnotes` the footnote references (`[^label]`), whose label has no
+ * definition. The parser leaves these as plain text, so they are found in the
+ * text of each paragraph, heading, and table cell, as CommonMark pairs its
+ * brackets. Brackets in code, math, HTML, links, images, and other syntax, and
+ * escaped ones, are not read.
+ */
+function undefinedReferences(document, definitions, footnotes) {
+    const { source } = document;
+    if (!source.includes("["))
+        return [];
+    const references = [];
+    const forge = document.dialect === "forgejo" || document.dialect === "gitea";
+    // 1 where a character is text that the parser reads brackets in.
+    const readable = new Uint8Array(source.length);
+    const collect = (node) => {
+        if (!("children" in node))
+            return;
+        for (const child of node.children)
+            if (child.type === "text") {
+                const [from, to] = range(child);
+                for (let i = from; i < to; i++) {
+                    if (source[i] === "\\" && i + 1 < to && asciiPunctuation.test(source[i + 1]))
+                        i++;
+                    else
+                        readable[i] = 1;
+                }
+            }
+            else if (transparent.has(child.type))
+                collect(child);
+    };
+    walk(document.tree, (node) => {
+        if (node.type !== "paragraph" && node.type !== "heading" && node.type !== "tableCell")
+            return;
+        const [start, end] = range(node);
+        // Searched in the block's own text, so that blocks without brackets cost no more than that.
+        const text = source.slice(start, end);
+        if (!text.includes("["))
+            return;
+        collect(node);
+        // Forgejo and Gitea render `\(...\)` and `\[...\]` as math, which GFM reads as text.
+        if (forge)
+            for (const [open, close] of [
+                ["\\(", "\\)"],
+                ["\\[", "\\]"],
+            ])
+                for (let from = 0;;) {
+                    const opening = text.indexOf(open, from);
+                    const closing = opening < 0 ? -1 : text.indexOf(close, opening + 2);
+                    if (closing < 0)
+                        break;
+                    readable.fill(0, start + opening, start + closing + 2);
+                    from = closing + 2;
+                }
+        const openers = [];
+        // The opening bracket of the last full reference's label, which is not read again.
+        let label = -1;
+        for (let i = start; i < end; i++) {
+            if (!readable[i])
+                continue;
+            if (source[i] === "[") {
+                openers.push(i);
+                continue;
+            }
+            if (source[i] !== "]")
+                continue;
+            const opener = openers.pop();
+            if (opener === undefined || opener === label)
+                continue;
+            let reference;
+            if (source[i + 1] === "[" && readable[i + 1]) {
+                if (source[i + 2] === "]" && readable[i + 2]) {
+                    // Collapsed: the text is the label.
+                    if (labelEnd(source, opener, i + 1) === i + 1)
+                        reference = {
+                            start: opener,
+                            end: i + 3,
+                            label: source.slice(opener + 1, i),
+                            footnote: false,
+                        };
+                }
+                else {
+                    const after = labelEnd(source, i + 1, end);
+                    if (after !== undefined && readable[after - 1]) {
+                        reference = {
+                            start: opener,
+                            end: after,
+                            label: source.slice(i + 2, after - 1),
+                            footnote: false,
+                        };
+                        label = i + 1;
+                    }
+                }
+                if (reference) {
+                    if (!definitions.has(normalizeLabel(labelText(reference.label))) &&
+                        !(opener > 0 && readable[opener - 1] && notAfter.test(source[opener - 1])))
+                        references.push(reference);
+                    continue;
+                }
+            }
+            // A footnote label has at most 999 characters after its `^`.
+            if (!footnotes || source[opener + 1] !== "^" || i - opener > 1001)
+                continue;
+            const footnote = footnoteLabel.exec(source.slice(opener + 1, i));
+            if (footnote && !footnotes.has(normalizeLabel(footnote[1])))
+                references.push({ start: opener, end: i + 1, label: footnote[1], footnote: true });
+        }
+    });
+    return references;
+}
 /** Names the first few of the paths that could not be read, and counts the rest. */
 function named(paths) {
     return paths.length > 3
@@ -109,9 +308,11 @@ export const linkRules = {
                     ];
                     findings.push({
                         start: range(node)[0],
-                        message: result.target === undefined
-                            ? `Local target could not be checked: ${url} (no readable match; ${reasons.join("; ")}).`
-                            : `Fragment could not be checked: ${url} (cannot read ${result.target}).`,
+                        message: result.leavesRoot !== undefined
+                            ? `Local target could not be checked: ${url} (${result.leavesRoot} leads outside the workspace root, which the tool does not read).`
+                            : result.target === undefined
+                                ? `Local target could not be checked: ${url} (no readable match; ${reasons.join("; ")}).`
+                                : `Fragment could not be checked: ${url} (cannot read ${result.target}).`,
                     });
                 }
                 else if (result.status === "resolved" && !result.fragmentExists)
@@ -242,7 +443,7 @@ export const linkRules = {
                         .replaceAll("<", "%3C")
                         .replaceAll(">", "%3E");
                 if (document.dialect === "gitea" &&
-                    (giteaPyLine(document.source, start, end) || replacement.includes("_.py")) &&
+                    (giteaPyLine(document, start, end) || replacement.includes("_.py")) &&
                     giteaUnderscores(original) !== giteaUnderscores(replacement))
                     return;
                 // On Forgejo, and Gitea before 1.26, the destination is part of the
@@ -286,9 +487,10 @@ export const linkRules = {
                     node.children.length === 1 &&
                     node.children[0]?.type === "text") {
                     const label = node.children[0].value;
-                    if (/[[\]|\r\n]/.test(node.url + label))
+                    const target = wikiTarget(node.url);
+                    if (target === undefined || /[[\]|\r\n]/.test(label))
                         return;
-                    replacement = `[[${node.url}|${label}]]`;
+                    replacement = `[[${target}|${label}]]`;
                 }
                 const url = destination(node);
                 if (!replacement || url === undefined)
@@ -307,5 +509,99 @@ export const linkRules = {
             return findings;
         },
     },
+    "links/undefined-reference": {
+        description: "Report full, collapsed, and footnote references whose label has no definition, which show as plain text.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            const definitions = new Set();
+            const footnotes = new Set();
+            walk(document.tree, (node) => {
+                if (node.type === "definition")
+                    definitions.add(node.identifier);
+                if (node.type === "footnoteDefinition")
+                    footnotes.add(node.identifier);
+            });
+            // CommonMark has no footnotes: there `[^label]` is an ordinary shortcut reference.
+            return undefinedReferences(document, definitions, document.dialect === "commonmark" ? undefined : footnotes).map(({ start, end, label, footnote }) => {
+                const name = (footnote ? `^${label}` : labelText(label)).replace(/\s+/g, " ").trim();
+                return {
+                    start,
+                    end,
+                    message: `${footnote ? "Footnote" : "Reference"} [${name}] has no definition and shows as plain text.`,
+                };
+            });
+        },
+    },
+    "links/unused-definition": {
+        description: "Report link and footnote definitions that no reference uses.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            // Link and footnote labels are kept apart, as `link:` and `footnote:` keys.
+            const used = new Set();
+            const definitions = [];
+            walk(document.tree, (node) => {
+                // A shortcut reference `[label]` that has a definition is a reference node too.
+                if (node.type === "linkReference" || node.type === "imageReference")
+                    used.add(`link:${node.identifier}`);
+                else if (node.type === "footnoteReference")
+                    used.add(`footnote:${node.identifier}`);
+                else if (node.type === "definition" || node.type === "footnoteDefinition")
+                    definitions.push(node);
+            });
+            const findings = [];
+            const seen = new Set();
+            for (const node of definitions) {
+                const footnote = node.type === "footnoteDefinition";
+                const key = `${footnote ? "footnote" : "link"}:${node.identifier}`;
+                const label = (node.label ?? node.identifier).replace(/\s+/g, " ").trim();
+                const name = `[${footnote ? "^" : ""}${label}]`;
+                const [start] = range(node);
+                // CommonMark uses the first definition of a label; a later one is never used.
+                if (seen.has(key))
+                    findings.push({
+                        start,
+                        message: `${footnote ? "Footnote" : "Definition"} ${name} repeats an earlier one, which references use instead.`,
+                    });
+                else if (!used.has(key))
+                    findings.push({
+                        start,
+                        message: footnote
+                            ? `Footnote ${name} is not referenced${document.dialect === "github" ? ", and GitHub does not show it" : ""}.`
+                            : `Definition ${name} is not used by any reference.`,
+                    });
+                seen.add(key);
+            }
+            return findings;
+        },
+    },
+    "links/empty": {
+        description: "Report links and images whose destination is empty or only #.",
+        kind: "problem",
+        schema: optionsSchema({}),
+        check({ document }) {
+            const findings = [];
+            // A reference has its definition's destination, which is reported once, at the definition.
+            walk(document.tree, (node) => {
+                if (node.type !== "link" && node.type !== "image" && node.type !== "definition")
+                    return;
+                if (node.url !== "" && node.url !== "#")
+                    return;
+                const what = node.type === "image"
+                    ? "Image source"
+                    : node.type === "definition"
+                        ? `Destination of definition [${(node.label ?? node.identifier).replace(/\s+/g, " ").trim()}]`
+                        : "Link destination";
+                findings.push({
+                    start: range(node)[0],
+                    message: node.url === ""
+                        ? `${what} is empty.`
+                        : `${what} is only #${node.type === "link" ? ", which only leads to the top of the page" : ""}.`,
+                });
+            });
+            return findings;
+        },
+    },
 };
 //# sourceMappingURL=links.js.map