@cudoment/cudoc 0.2.0 → 0.4.0

package/dist/node/check.js

@@ -0,0 +1,465 @@
+/**
+ * Whole-library reference checking.
+ *
+ * The build deliberately stops at the first unresolvable reference, because a
+ * site with a broken link should not ship. That makes it a poor way to find out
+ * what is wrong: an author fixes one link, rebuilds, and learns about the next.
+ * This walks every document instead and returns everything at once.
+ *
+ * It resolves through the same code the build uses, so a reference this reports
+ * as fine is one the build can resolve.
+ */
+import { parseEmbedSpec } from "./resolve-embed.js";
+import { collectSections } from "../sections.js";
+import { resolveLocalTarget } from "./local-target.js";
+/** A heading id that a slugger disambiguated, such as `overview-1`. */
+const SUFFIXED = /-\d+$/;
+const walkNodes = (node, visit) => {
+    visit(node);
+    node.children?.forEach((child) => walkNodes(child, visit));
+};
+/**
+ * Every anchor a document offers, and whether the author wrote it.
+ *
+ * Both halves matter. The ids answer whether a link resolves; the origin
+ * answers whether it will keep resolving, because a generated id depends on how
+ * many same-named headings precede it.
+ */
+export function collectAnchors(tree) {
+    const anchors = [];
+    walkNodes(tree, (node) => {
+        if (node.type !== "heading")
+            return;
+        const id = node.data?.hProperties?.id;
+        if (typeof id === "string" && id)
+            anchors.push({ id, explicit: node.data?.cudoc?.explicitId === true });
+    });
+    return anchors;
+}
+/**
+ * Where a reference sits in the original Markdown.
+ *
+ * Collection strips positions from the stored tree on purpose: a persisted AST
+ * should not carry coordinates that go stale the moment the file is edited. The
+ * source snapshot is still here, so the first occurrence of the reference text
+ * gives an author somewhere real to jump to. A reference repeated in one
+ * document reports the first one; fixing it means fixing both anyway.
+ */
+/**
+ * The forms a reference might take in the original Markdown.
+ *
+ * The tree holds what the host compiler produced, and hosts rewrite link
+ * destinations: Nextra drops the extension, VitePress rewrites it to `.html`
+ * and prefixes `./`. The author wrote `reference.md#limit`, so searching the
+ * source for the compiled form finds nothing. These are tried in turn.
+ */
+const sourceForms = (reference) => {
+    const [pathname, anchor] = reference.split("#");
+    if (!pathname)
+        return [reference];
+    const bare = pathname.replace(/^\.\//, "").replace(/\.(?:mdx?|html?)$/i, "");
+    const suffix = anchor === undefined ? "" : `#${anchor}`;
+    return [
+        ...new Set([
+            reference,
+            `${bare}.md${suffix}`,
+            `${bare}.mdx${suffix}`,
+            `${bare}${suffix}`,
+        ]),
+    ];
+};
+const locate = (text, reference, skip = 0) => {
+    // A reference is often a prefix of a longer one on an earlier line, as
+    // `guide.md#limit` is of `guide.md#limits`. Prefer an occurrence that ends
+    // where a Markdown destination ends, and fall back to a plain search.
+    const ends = new Set([")", "]", '"', "'", " ", "\t", "\n", ""]);
+    let at = -1;
+    let remaining = skip;
+    for (let i = text.indexOf(reference); i >= 0; i = text.indexOf(reference, i + 1))
+        if (ends.has(text[i + reference.length] ?? "")) {
+            if (remaining-- > 0)
+                continue;
+            at = i;
+            break;
+        }
+    if (at < 0)
+        at = text.indexOf(reference);
+    if (at < 0)
+        return undefined;
+    const before = text.slice(0, at);
+    const line = before.split("\n").length;
+    const column = at - (before.lastIndexOf("\n") + 1) + 1;
+    const offset = at;
+    return {
+        start: { line, column, offset },
+        end: {
+            line,
+            column: column + reference.length,
+            offset: offset + reference.length,
+        },
+    };
+};
+/**
+ * Components in a tree that no portable renderer can turn into HTML.
+ *
+ * `documentToHast` renders an unknown `mdx*` or directive node only when the
+ * caller supplies an explicit HTML callback for it, and throws otherwise. A
+ * component sitting in a document is the author's business, because the host
+ * that owns it renders it. A component sitting in a section that an embed
+ * copies is different: the copy lands in another document, and standalone HTML
+ * export then has to render a name it was never given.
+ *
+ * `mdxjsEsm` and `yaml` are excluded because the renderer drops them rather
+ * than failing.
+ */
+const unportableComponents = (tree) => {
+    const names = new Set();
+    walkNodes(tree, (node) => {
+        if (node.type === "mdxjsEsm" || node.type === "yaml")
+            return;
+        if (!node.type.startsWith("mdx") && !node.type.endsWith("Directive"))
+            return;
+        names.add(node.name ? `<${node.name}>` : node.type);
+    });
+    return [...names];
+};
+/** The visible text of a heading, used to spot an anchor that failed to parse. */
+const headingText = (node) => {
+    let text = "";
+    walkNodes(node, (child) => {
+        if (child.type === "text" && typeof child.value === "string")
+            text += child.value;
+    });
+    return text;
+};
+/** The line each `cudoc-embed` fence opens on, in source order. */
+const embedFenceLines = (text) => {
+    const lines = [];
+    text.split("\n").forEach((line, index) => {
+        if (/^\s*(?:`{3,}|~{3,})cudoc-embed\s*$/.test(line))
+            lines.push(index + 1);
+    });
+    return lines;
+};
+/**
+ * Whether a rule finds anything, asked the way the resolver asks it.
+ *
+ * Rules run in order and each sees the previous one's output, so a later rule
+ * can legitimately depend on an earlier substitution. Testing them against the
+ * untouched slice would report those as unmatched.
+ */
+const matchedRules = (slice, rules) => {
+    const matched = [];
+    let value = slice;
+    rules.forEach((rule, index) => {
+        try {
+            if (rule.regex) {
+                const pattern = new RegExp(rule.find, rule.flags ?? "g");
+                matched[index] = pattern.test(value);
+                value = value.replace(new RegExp(rule.find, rule.flags ?? "g"), rule.replace);
+            }
+            else {
+                matched[index] = value.includes(rule.find);
+                value = value.split(rule.find).join(rule.replace);
+            }
+        }
+        catch {
+            // An unusable pattern is the resolver's error to raise, not a miss.
+            matched[index] = true;
+        }
+    });
+    return matched;
+};
+export function checkReferences(library, options = {}) {
+    const sourceRoot = options.sourceRoot ?? library.sourceRoot;
+    const ignore = new Set(options.ignore ?? []);
+    const issues = [];
+    let checkedReferences = 0;
+    const anchorsById = new Map(library.documents.map((doc) => [doc.id, collectAnchors(doc.tree)]));
+    const byId = new Map(library.documents.map((doc) => [doc.id, doc]));
+    const report = (doc, 
+    /** A `position` given here wins; otherwise it is recovered from the source. */
+    issue, 
+    /** Which occurrence of the reference to point at. A duplicate wants the later one. */
+    skip = 0) => {
+        if (ignore.has(issue.code))
+            return;
+        issues.push({
+            ...issue,
+            documentId: doc.id,
+            sourcePath: doc.sourcePath,
+            position: issue.position ??
+                sourceForms(issue.reference).reduce((found, form) => found ?? locate(doc.source?.text ?? "", form, skip), undefined),
+        });
+    };
+    /** Resolves `other.md#anchor` or a bare `#anchor` against the library. */
+    const checkDocumentLink = (doc, url) => {
+        const [pathname, anchor] = url.split("#");
+        let target = doc;
+        if (pathname) {
+            const id = resolveDocumentId(doc, pathname);
+            const found = id === undefined ? undefined : byId.get(id);
+            if (!found)
+                return false; // not a document link; the asset pass handles it
+            target = found;
+        }
+        if (!anchor)
+            return true;
+        const anchors = anchorsById.get(target.id) ?? [];
+        const match = anchors.find((entry) => entry.id === anchor);
+        if (!match) {
+            report(doc, {
+                code: "missing-anchor",
+                severity: "error",
+                message: `${target.id} has no anchor #${anchor}`,
+                reference: url,
+                available: anchors.map((entry) => entry.id),
+            });
+            return true;
+        }
+        if (!match.explicit && SUFFIXED.test(match.id))
+            report(doc, {
+                code: "unstable-anchor-link",
+                severity: "warning",
+                message: `#${anchor} in ${target.id} is generated from a repeated heading; inserting another one above it moves this link to a different section. Give the target heading an explicit anchor.`,
+                reference: url,
+            });
+        return true;
+    };
+    /**
+     * A link's document id, if it names a document in this library.
+     *
+     * Hosts do not agree on how a link looks once compiled. Docusaurus and
+     * Next.js leave `reference.md`, Nextra drops the extension, and VitePress
+     * rewrites it to the deployed `./reference.html`. All three mean the same
+     * document, so any of those endings resolves to the same id.
+     */
+    const resolveDocumentId = (doc, pathname) => {
+        if (/^(?:[a-z][\w+.-]*:|\/\/)/i.test(pathname))
+            return undefined;
+        const decoded = decodeURIComponent(pathname);
+        const joined = decoded.startsWith("/")
+            ? decoded.slice(1)
+            : posixJoin(dirname(doc.sourcePath), decoded);
+        return normalize(joined).replace(/\.(?:mdx?|html?)$/i, "");
+    };
+    for (const doc of library.documents) {
+        // Anchors the document declares, before anything references them.
+        const seen = new Set();
+        const counts = new Map();
+        walkNodes(doc.tree, (node) => {
+            if (node.type !== "heading")
+                return;
+            const id = node.data?.hProperties?.id;
+            if (typeof id === "string" && id) {
+                const before = counts.get(id) ?? 0;
+                if (before)
+                    report(doc, {
+                        code: "duplicate-anchor",
+                        severity: "error",
+                        message: `duplicate heading anchor #${id}`,
+                        reference: `#${id}`,
+                    }, before);
+                counts.set(id, before + 1);
+                seen.add(id);
+            }
+            // An anchor marker with no id never becomes an anchor. It stays in the
+            // heading text instead, and silently joins the generated slug.
+            const text = headingText(node);
+            const empty = text.match(/\((#)\)|\{(#)\}/);
+            if (empty)
+                report(doc, {
+                    code: "empty-anchor",
+                    severity: "error",
+                    message: `empty anchor marker left in the heading text: "${text.trim()}"`,
+                    reference: empty[0],
+                });
+        });
+        walkNodes(doc.tree, (node) => {
+            const url = node.type === "link" || node.type === "image" ? node.url : undefined;
+            if (typeof url !== "string" || !url)
+                return;
+            // A heading permalink is machinery the host inserted, not something an
+            // author wrote. VitePress and Eleventy add one per heading, and counting
+            // them would report every generated anchor as an unstable link.
+            if (node.data?.cudoc?.kind === "permalink")
+                return;
+            checkedReferences++;
+            if (/^(?:[a-z][\w+.-]*:|\/\/)/i.test(url))
+                return; // external
+            if (node.type === "link" && checkDocumentLink(doc, url))
+                return;
+            if (url.startsWith("#"))
+                return; // handled above as a same-document anchor
+            if (!sourceRoot)
+                return;
+            const target = resolveLocalTarget(url, doc.sourcePath, {
+                ...options,
+                sourceRoot,
+            });
+            if (target.kind === "missing")
+                report(doc, {
+                    code: node.type === "image" ? "missing-asset" : "missing-document",
+                    severity: "error",
+                    message: node.type === "image"
+                        ? `no file for image ${url}; check sourceRoot and assetDirs`
+                        : `no document or file for ${url}`,
+                    reference: url,
+                });
+        });
+        // Fence lines are read from the source because collection strips positions,
+        // and they are what turns a YAML error's own coordinate into a file one.
+        const fences = embedFenceLines(doc.source?.text ?? "");
+        let blockNumber = 0;
+        walkNodes(doc.tree, (node) => {
+            if (node.type !== "code" || node.lang !== "cudoc-embed")
+                return;
+            const fence = fences[blockNumber++];
+            let spec;
+            try {
+                spec = parseEmbedSpec(node.value ?? "");
+            }
+            catch (error) {
+                // The YAML parser counts from the start of the block; an author counts
+                // from the start of the file. Add the fence so both agree.
+                const at = error.linePos?.[0];
+                const line = fence === undefined ? undefined : fence + (at?.line ?? 0);
+                report(doc, {
+                    code: "invalid-embed-spec",
+                    severity: "error",
+                    // The parser's own "at line 3, column 24" is dropped: it counts from
+                    // the block, and the position below already says the same thing in
+                    // the file's own coordinates.
+                    message: error.message
+                        .replace(/^cudoc: /, "")
+                        .split("\n")[0]
+                        .replace(/\s*at line \d+, column \d+:?\s*$/, "")
+                        .trim(),
+                    reference: `embed block ${blockNumber}`,
+                    position: line === undefined
+                        ? undefined
+                        : {
+                            start: { line, column: at?.col ?? 1 },
+                            end: { line, column: at?.col ?? 1 },
+                        },
+                });
+                return;
+            }
+            for (const reference of spec.sources ?? []) {
+                checkedReferences++;
+                const [pathname, anchor] = String(reference).split("#");
+                const id = resolveDocumentId(doc, pathname);
+                const target = id === undefined ? undefined : byId.get(id);
+                if (!target) {
+                    report(doc, {
+                        code: "missing-embed-source",
+                        severity: "error",
+                        message: `embed source ${reference} does not name a collected document`,
+                        reference: String(reference),
+                    });
+                    continue;
+                }
+                const anchors = anchorsById.get(target.id) ?? [];
+                if (anchor && !anchors.some((entry) => entry.id === anchor)) {
+                    report(doc, {
+                        code: "missing-embed-anchor",
+                        severity: "error",
+                        message: `${target.id} has no section #${anchor} to embed`,
+                        reference: String(reference),
+                        available: anchors.map((entry) => entry.id),
+                    });
+                    continue;
+                }
+                // The same selection the resolver will apply, so what is inspected is
+                // what would actually be copied. `select.anchors` can name a section
+                // that does not exist, which `collectSections` rejects; the build hits
+                // the same error, so it is reported rather than swallowed.
+                const selection = anchor ? { anchors: [anchor] } : spec.select;
+                let copied;
+                try {
+                    copied = selection
+                        ? collectSections(target.tree, selection)
+                        : [{ anchorId: undefined, tree: target.tree }];
+                }
+                catch (error) {
+                    report(doc, {
+                        code: "missing-embed-anchor",
+                        severity: "error",
+                        message: `${target.id}: ${error.message.replace(/^cudoc: /, "")}`,
+                        reference: String(reference),
+                        available: anchors.map((entry) => entry.id),
+                    });
+                    continue;
+                }
+                // Replacement runs on the original Markdown, not the tree, so the
+                // slices are recomputed the way `transformedSection` cuts them. A rule
+                // that matches no slice changed nothing, and the embed silently shows
+                // the source's own wording in a place written to expect otherwise.
+                const rules = spec.replace ?? [];
+                if (rules.length && target.source) {
+                    const matched = rules.map(() => false);
+                    for (const section of copied) {
+                        const range = section.anchorId
+                            ? target.source.sections[section.anchorId]
+                            : undefined;
+                        const slice = range
+                            ? target.source.text.slice(range.start, spec.select?.includeChildren === false
+                                ? (range.ownEnd ?? range.end)
+                                : range.end)
+                            : target.source.text;
+                        matchedRules(slice, rules).forEach((hit, index) => {
+                            if (hit)
+                                matched[index] = true;
+                        });
+                    }
+                    rules.forEach((rule, index) => {
+                        if (matched[index])
+                            return;
+                        report(doc, {
+                            code: "unmatched-embed-replacement",
+                            severity: "warning",
+                            message: `replacement ${index + 1} found no "${rule.find}" in what this embed copies from ${target.id}, so nothing was changed. The source may have been reworded${rule.regex ? "" : "; literal rules are case-sensitive"}.`,
+                            reference: rule.find,
+                        });
+                    });
+                }
+                // A summary table carries heading text and nothing else, so whatever
+                // else the body holds never travels. Replacement above still applies,
+                // because it reaches the title and summary columns.
+                if (typeof spec.render === "object" && spec.render?.type === "table")
+                    continue;
+                const names = [
+                    ...new Set(copied.flatMap((section) => unportableComponents(section.tree))),
+                ];
+                if (names.length)
+                    report(doc, {
+                        code: "unportable-embed-component",
+                        severity: "warning",
+                        message: `this embed copies ${names.join(", ")} out of ${target.id}. A host that owns those components renders them, but standalone HTML export has no renderer for them and fails. Keep embedded sections to Markdown, or pass a renderer for each name.`,
+                        reference: String(reference),
+                    });
+            }
+        });
+    }
+    return { issues, documentCount: library.documents.length, checkedReferences };
+}
+// Posix path helpers, kept local so this module stays usable without importing
+// the whole node path surface into a browser-safe boundary by accident.
+const dirname = (value) => {
+    const at = value.lastIndexOf("/");
+    return at <= 0 ? "." : value.slice(0, at);
+};
+const posixJoin = (base, value) => base === "." ? value : `${base}/${value}`;
+const normalize = (value) => {
+    const out = [];
+    for (const part of value.split("/")) {
+        if (!part || part === ".")
+            continue;
+        if (part === "..")
+            out.pop();
+        else
+            out.push(part);
+    }
+    return out.join("/");
+};
+//# sourceMappingURL=check.js.map

package/dist/node/check.js.map

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

package/dist/node/cli.js

@@ -5,24 +5,45 @@ import { pathToFileURL } from "node:url";
 import { buildDocuments, buildDocumentsAsync } from "./library.js";
 import { prepareEmbeds } from "./prepare-embeds.js";
 import { generateDataset } from "./dataset.js";
+import { checkReferences } from "./check.js";
+import { formatCheckResult } from "./report.js";
+const USAGE = "Usage: cudoc <collect|check|dataset> --config config.mjs [--format text|json] [--strict]";
 try {
-    const [command, ...args] = process.argv.slice(2);
-    if (!["collect", "dataset"].includes(command) ||
-        args.length !== 2 ||
-        args[0] !== "--config")
-        throw new Error("Usage: cudoc <collect|dataset> --config config.mjs");
-    const config = args[1].endsWith(".json")
-        ? JSON.parse(fs.readFileSync(args[1], "utf8"))
-        : (await import(pathToFileURL(path.resolve(args[1])).href)).default;
-    if (command === "dataset")
-        console.log(JSON.stringify(generateDataset(config)));
-    else {
+    const argv = process.argv.slice(2);
+    const [command] = argv;
+    const flags = new Set(argv.filter((value) => value.startsWith("--")));
+    const configIndex = argv.indexOf("--config");
+    if (!["collect", "check", "dataset"].includes(command) ||
+        configIndex === -1 ||
+        !argv[configIndex + 1])
+        throw new Error(USAGE);
+    const configPath = argv[configIndex + 1];
+    const config = configPath.endsWith(".json")
+        ? JSON.parse(fs.readFileSync(configPath, "utf8"))
+        : (await import(pathToFileURL(path.resolve(configPath)).href)).default;
+    const collect = async () => {
         const library = config.compiler
             ? await buildDocumentsAsync({
                 ...config,
                 compiler: async (...parameters) => config.compiler(...parameters),
             })
             : buildDocuments(config);
+        return library;
+    };
+    if (command === "dataset")
+        console.log(JSON.stringify(generateDataset(config)));
+    else if (command === "check") {
+        // Checking reads the same collection the build does, so it sees exactly
+        // what the site will render. It writes nothing.
+        const result = checkReferences(await collect(), config.check ?? {});
+        const json = argv[argv.indexOf("--format") + 1] === "json";
+        console.log(json ? JSON.stringify(result, null, 2) : formatCheckResult(result));
+        const blocking = result.issues.filter((issue) => issue.severity === "error" || flags.has("--strict"));
+        if (blocking.length)
+            process.exitCode = 1;
+    }
+    else {
+        const library = await collect();
         await prepareEmbeds(library, config.outDir);
         console.log(JSON.stringify({
             documentCount: library.documents.length,

package/dist/node/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/node/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,SAAS,CAAA;AACxB,OAAO,IAAI,MAAM,WAAW,CAAA;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,IAAI,CAAC;IACH,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAChD,IACE,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACzC,IAAI,CAAC,MAAM,KAAK,CAAC;QACjB,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU;QAEtB,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAA;IACvE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC;QACtC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9C,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAA;IACrE,IAAI,OAAO,KAAK,SAAS;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;SACjD,CAAC;QACJ,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ;YAC7B,CAAC,CAAC,MAAM,mBAAmB,CAAC;gBACxB,GAAG,MAAM;gBACT,QAAQ,EAAE,KAAK,EACb,GAAG,UAA2D,EAC9D,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,UAAU,CAAC;aACpC,CAAC;YACJ,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAA;QAC1B,MAAM,aAAa,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAA;QAC3C,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CAAC;YACb,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,MAAM;YACvC,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,kBAAkB;SAC5C,CAAC,CACH,CAAA;IACH,CAAC;AACH,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/node/cli.ts"],"names":[],"mappings":"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"}

package/dist/node/local-target.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Where a local link or image in a document actually points on disk.
+ *
+ * The HTML exporter copies what this finds; the reference checker reports what
+ * it does not. Both go through here so a document cannot pass one and fail the
+ * other: a link the checker calls resolvable is a link the exporter can copy.
+ */
+export type LocalTargetRoots = {
+    /** The document source root. A document-relative path resolves here first. */
+    sourceRoot: string;
+    /** Extra roots holding host assets, such as `public` or `static`. */
+    assetDirs?: string[];
+    /**
+     * Strips a deployment base path from a root-relative URL, matching the host's
+     * routing. Defaults to identity for a site served from the domain root.
+     */
+    withoutBase?: (pathname: string) => string;
+};
+export type LocalTarget = {
+    kind: "external";
+    url: string;
+} | {
+    kind: "resolved";
+    relative: string;
+    source: string;
+    suffix: string;
+} | {
+    kind: "missing";
+    relative: string;
+    suffix: string;
+};
+/**
+ * Resolves one URL against the document that carries it.
+ *
+ * A fragment, scheme or protocol-relative URL is external and left alone. A
+ * document-relative path resolves against `sourceRoot`; a root-relative one is
+ * also tried against each asset directory, after the deployment base is
+ * removed. A path that escapes every root is reported as missing rather than
+ * resolved, so the caller names the link and its document instead of a
+ * traversal that means nothing to an author.
+ */
+export declare function resolveLocalTarget(url: string, documentSourcePath: string, roots: LocalTargetRoots): LocalTarget;
+//# sourceMappingURL=local-target.d.ts.map

package/dist/node/local-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-target.d.ts","sourceRoot":"","sources":["../../src/node/local-target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,8EAA8E;IAC9E,UAAU,EAAE,MAAM,CAAA;IAClB,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB;;;OAGG;IACH,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAA;CAC3C,CAAA;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACtE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAWzD;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,MAAM,EAC1B,KAAK,EAAE,gBAAgB,GACtB,WAAW,CAwBb"}