@zudojs/docs 1.0.6 → 1.1.0

package/dist/navigation/index.js

@@ -3,5 +3,5 @@
  *
  * Navigation tree utilities — breadcrumbs, flattening, sibling resolution.
  */
-export { getBreadcrumbs, flattenNavigation, findNavigationItem, getSiblings, getAdjacent, } from "./navigation.core.js";
-//# sourceMappingURL=index.js.map
+export { getBreadcrumbs, flattenNavigation, findNavigationItem, } from "./navigation.core.js";
+export { getSiblings, getAdjacent } from "./navigation.adjacent.js";

package/dist/navigation/navigation.adjacent.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Sibling and previous/next resolution over a navigation tree.
+ *
+ * @module navigation/navigation.adjacent
+ */
+import type { DocumentationNavigationItem } from "../docsTypes/index.js";
+type Nodes = readonly DocumentationNavigationItem[];
+/**
+ * Gets sibling document IDs for a given document (the other documents
+ * at the same navigation level, excluding the document itself).
+ */
+export declare function getSiblings(documentId: string, items: Nodes): readonly string[];
+/** Options for `getAdjacent`. */
+export interface GetAdjacentOptions {
+    /**
+     * `"level"` (default) looks only at the documents that share the
+     * target's navigation level, so the first item of a section has no
+     * `previous`. `"tree"` walks the whole tree in reading order (the
+     * order of `flattenNavigation`), crossing section boundaries.
+     */
+    readonly scope?: "level" | "tree";
+}
+/**
+ * Gets the previous and next document IDs around `documentId`: within its
+ * navigation level by default, or across the whole tree in reading order
+ * with `{ scope: "tree" }`.
+ */
+export declare function getAdjacent(documentId: string, items: Nodes, options?: GetAdjacentOptions): {
+    readonly previous?: string;
+    readonly next?: string;
+};
+export {};

package/dist/navigation/navigation.adjacent.js

@@ -0,0 +1,60 @@
+/**
+ * Sibling and previous/next resolution over a navigation tree.
+ *
+ * @module navigation/navigation.adjacent
+ */
+import { MAX_NAVIGATION_DEPTH, flattenNavigation } from "./navigation.core.js";
+/**
+ * Returns the list of document IDs at the same level as `documentId`,
+ * including the document itself, in navigation order.
+ */
+function getLevel(documentId, items) {
+    const seen = new WeakSet();
+    function walk(nodes, depth) {
+        if (depth > MAX_NAVIGATION_DEPTH)
+            return undefined;
+        for (const node of nodes) {
+            if (seen.has(node))
+                continue;
+            seen.add(node);
+            if (node.documentId === documentId) {
+                return nodes
+                    .map((n) => n.documentId)
+                    .filter((id) => typeof id === "string");
+            }
+            if (node.children) {
+                const result = walk(node.children, depth + 1);
+                if (result)
+                    return result;
+            }
+        }
+        return undefined;
+    }
+    return walk(items, 0) ?? [];
+}
+/**
+ * Gets sibling document IDs for a given document (the other documents
+ * at the same navigation level, excluding the document itself).
+ */
+export function getSiblings(documentId, items) {
+    return Object.freeze(getLevel(documentId, items).filter((id) => id !== documentId));
+}
+/**
+ * Gets the previous and next document IDs around `documentId`: within its
+ * navigation level by default, or across the whole tree in reading order
+ * with `{ scope: "tree" }`.
+ */
+export function getAdjacent(documentId, items, options = {}) {
+    const level = options.scope === "tree"
+        ? flattenNavigation(items)
+        : getLevel(documentId, items);
+    const index = level.indexOf(documentId);
+    if (index === -1)
+        return Object.freeze({});
+    const previous = level[index - 1];
+    const next = level[index + 1];
+    return Object.freeze({
+        ...(previous !== undefined ? { previous } : {}),
+        ...(next !== undefined ? { next } : {}),
+    });
+}

package/dist/navigation/navigation.core.d.ts

@@ -28,17 +28,4 @@ export declare function flattenNavigation(items: Nodes): readonly string[];
  * Finds a navigation item by document ID.
  */
 export declare function findNavigationItem(documentId: string, items: Nodes): DocumentationNavigationItem | undefined;
-/**
- * Gets sibling document IDs for a given document (the other documents
- * at the same navigation level, excluding the document itself).
- */
-export declare function getSiblings(documentId: string, items: Nodes): readonly string[];
-/**
- * Gets the previous and next document IDs at the same navigation level.
- */
-export declare function getAdjacent(documentId: string, items: Nodes): {
-    readonly previous?: string;
-    readonly next?: string;
-};
 export {};
-//# sourceMappingURL=navigation.core.d.ts.map

package/dist/navigation/navigation.core.js

@@ -100,54 +100,3 @@ export function findNavigationItem(documentId, items) {
     }
     return walk(items, 0);
 }
-/**
- * Returns the list of document IDs at the same level as `documentId`,
- * including the document itself, in navigation order.
- */
-function getLevel(documentId, items) {
-    const seen = new WeakSet();
-    function walk(nodes, depth) {
-        if (depth > MAX_NAVIGATION_DEPTH)
-            return undefined;
-        for (const node of nodes) {
-            if (seen.has(node))
-                continue;
-            seen.add(node);
-            if (node.documentId === documentId) {
-                return nodes
-                    .map((n) => n.documentId)
-                    .filter((id) => typeof id === "string");
-            }
-            if (node.children) {
-                const result = walk(node.children, depth + 1);
-                if (result)
-                    return result;
-            }
-        }
-        return undefined;
-    }
-    return walk(items, 0) ?? [];
-}
-/**
- * Gets sibling document IDs for a given document (the other documents
- * at the same navigation level, excluding the document itself).
- */
-export function getSiblings(documentId, items) {
-    return Object.freeze(getLevel(documentId, items).filter((id) => id !== documentId));
-}
-/**
- * Gets the previous and next document IDs at the same navigation level.
- */
-export function getAdjacent(documentId, items) {
-    const level = getLevel(documentId, items);
-    const index = level.indexOf(documentId);
-    if (index === -1)
-        return Object.freeze({});
-    const previous = level[index - 1];
-    const next = level[index + 1];
-    return Object.freeze({
-        ...(previous !== undefined ? { previous } : {}),
-        ...(next !== undefined ? { next } : {}),
-    });
-}
-//# sourceMappingURL=navigation.core.js.map

package/dist/registry/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { DocumentRegistry, createDocumentRegistry, matchesVisibility, } from "./registry.core.js";
 export type { DocumentVisibilityFilter, GetAllOptions, } from "./registry.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/registry/index.js

@@ -4,4 +4,3 @@
  * Document registry for storing, retrieving, and filtering documentation.
  */
 export { DocumentRegistry, createDocumentRegistry, matchesVisibility, } from "./registry.core.js";
-//# sourceMappingURL=index.js.map

package/dist/registry/registry.core.d.ts

@@ -90,4 +90,3 @@ export declare class DocumentRegistry implements DocumentationProvider {
  * Creates a new document registry.
  */
 export declare function createDocumentRegistry(): DocumentRegistry;
-//# sourceMappingURL=registry.core.d.ts.map

package/dist/registry/registry.core.js

@@ -117,4 +117,3 @@ export class DocumentRegistry {
 export function createDocumentRegistry() {
     return new DocumentRegistry();
 }
-//# sourceMappingURL=registry.core.js.map

package/dist/utils/index.d.ts

@@ -6,4 +6,3 @@
 export { isValidDocumentId, normalizeDocumentId, documentIdFromPath, resolveDocumentLink, stripLinkDecorations, stripFencedCodeBlocks, extractTitleFromMarkdown, extractHeadings, } from "./utils.helper.js";
 export { stripMarkdown } from "./utils.markdownText.js";
 export { deepFreeze, deepFreezeClone } from "./utils.freeze.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.js

@@ -6,4 +6,3 @@
 export { isValidDocumentId, normalizeDocumentId, documentIdFromPath, resolveDocumentLink, stripLinkDecorations, stripFencedCodeBlocks, extractTitleFromMarkdown, extractHeadings, } from "./utils.helper.js";
 export { stripMarkdown } from "./utils.markdownText.js";
 export { deepFreeze, deepFreezeClone } from "./utils.freeze.js";
-//# sourceMappingURL=index.js.map

package/dist/utils/utils.freeze.d.ts

@@ -14,4 +14,3 @@ export declare function deepFreeze<T>(value: T, seen?: WeakSet<object>): T;
  * functions); those are kept by reference.
  */
 export declare function deepFreezeClone<T>(value: T): T;
-//# sourceMappingURL=utils.freeze.d.ts.map

package/dist/utils/utils.freeze.js

@@ -74,4 +74,3 @@ function isPlainObject(value) {
     const proto = Object.getPrototypeOf(value);
     return proto === Object.prototype || proto === null;
 }
-//# sourceMappingURL=utils.freeze.js.map

package/dist/utils/utils.helper.d.ts

@@ -50,4 +50,3 @@ export declare function extractHeadings(markdown: string): readonly {
     level: number;
     text: string;
 }[];
-//# sourceMappingURL=utils.helper.d.ts.map

package/dist/utils/utils.helper.js

@@ -121,4 +121,3 @@ function cleanHeadingText(text) {
         ? withoutHashes.trim()
         : trimmed;
 }
-//# sourceMappingURL=utils.helper.js.map

package/dist/utils/utils.href.d.ts

@@ -23,4 +23,3 @@ export declare function isSafeLinkHref(href: string): boolean;
  * as a character reference.
  */
 export declare function escapeHtmlText(value: string): string;
-//# sourceMappingURL=utils.href.d.ts.map

package/dist/utils/utils.href.js

@@ -42,4 +42,3 @@ export function escapeHtmlText(value) {
         .replace(/</g, "&lt;")
         .replace(/>/g, "&gt;");
 }
-//# sourceMappingURL=utils.href.js.map

package/dist/utils/utils.markdownText.d.ts

@@ -19,4 +19,3 @@ export declare function stripHtmlTags(text: string): string;
  * Strips markdown formatting to plain text.
  */
 export declare function stripMarkdown(markdown: string): string;
-//# sourceMappingURL=utils.markdownText.d.ts.map

package/dist/utils/utils.markdownText.js

@@ -85,4 +85,3 @@ export function stripMarkdown(markdown) {
         .replace(/\n{3,}/g, "\n\n")
         .trim();
 }
-//# sourceMappingURL=utils.markdownText.js.map

package/dist/validator/index.d.ts

@@ -11,4 +11,3 @@ export { toValidationResult } from "./validator.types.js";
 export type { ValidationIssue, ValidationResult } from "./validator.types.js";
 export type { ValidateLinksOptions } from "./validatorLinks.core.js";
 export type { ValidateAllOptions } from "./validatorAll/validatorAll.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/validator/index.js

@@ -8,4 +8,3 @@ export { validateNoDuplicateIds } from "./validatorDuplicates.core.js";
 export { validateLinks, DEFAULT_MAX_LINK_SCAN_LENGTH, } from "./validatorLinks.core.js";
 export { validateAll, validateNavigation } from "./validatorAll/index.js";
 export { toValidationResult } from "./validator.types.js";
-//# sourceMappingURL=index.js.map

package/dist/validator/validator.types.d.ts

@@ -25,4 +25,3 @@ export interface ValidationResult {
  * rule shared by every validator in this package.
  */
 export declare function toValidationResult(issues: readonly ValidationIssue[]): ValidationResult;
-//# sourceMappingURL=validator.types.d.ts.map

package/dist/validator/validator.types.js

@@ -11,4 +11,3 @@ export function toValidationResult(issues) {
         issues,
     };
 }
-//# sourceMappingURL=validator.types.js.map

package/dist/validator/validatorAll/index.d.ts

@@ -5,4 +5,3 @@
  */
 export { validateAll } from "./validatorAll.core.js";
 export { validateNavigation } from "./validatorNavigation.core.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/validator/validatorAll/index.js

@@ -5,4 +5,3 @@
  */
 export { validateAll } from "./validatorAll.core.js";
 export { validateNavigation } from "./validatorNavigation.core.js";
-//# sourceMappingURL=index.js.map

package/dist/validator/validatorAll/validatorAll.core.d.ts

@@ -11,9 +11,19 @@ export interface ValidateAllOptions extends ValidateLinksOptions {
      * appear in it as `NAVIGATION_ORPHAN_DOCUMENT` warnings. Default true.
      */
     readonly reportOrphans?: boolean;
+    /**
+     * Severity of a `NAVIGATION_ORPHAN_DOCUMENT` issue. Defaults to
+     * `"warning"`; pass `"error"` to fail validation when a document is
+     * unreachable from the navigation.
+     */
+    readonly orphanSeverity?: "error" | "warning";
 }
 /**
  * Validates all documents and optionally a navigation tree.
+ *
+ * `valid` is false only when an issue has severity `"error"`. Broken
+ * links and orphan documents are warnings by default, so a set with dead
+ * links still validates; set `brokenLinkSeverity` / `orphanSeverity` to
+ * `"error"` to fail on them.
  */
 export declare function validateAll(documents: readonly DocumentationDocument[], navigation?: readonly DocumentationNavigationItem[], options?: ValidateAllOptions): ValidationResult;
-//# sourceMappingURL=validatorAll.core.d.ts.map

package/dist/validator/validatorAll/validatorAll.core.js

@@ -9,6 +9,11 @@ import { validateLinks, } from "../validatorLinks.core.js";
 import { validateNavigation } from "./validatorNavigation.core.js";
 /**
  * Validates all documents and optionally a navigation tree.
+ *
+ * `valid` is false only when an issue has severity `"error"`. Broken
+ * links and orphan documents are warnings by default, so a set with dead
+ * links still validates; set `brokenLinkSeverity` / `orphanSeverity` to
+ * `"error"` to fail on them.
  */
 export function validateAll(documents, navigation, options = {}) {
     const allIssues = [];
@@ -29,7 +34,7 @@ export function validateAll(documents, navigation, options = {}) {
             for (const id of registeredIds) {
                 if (!inNavigation.has(id)) {
                     allIssues.push({
-                        severity: "warning",
+                        severity: options.orphanSeverity ?? "warning",
                         code: "NAVIGATION_ORPHAN_DOCUMENT",
                         message: `Document "${id}" is not reachable from the navigation.`,
                         documentId: id,
@@ -40,4 +45,3 @@ export function validateAll(documents, navigation, options = {}) {
     }
     return toValidationResult(allIssues);
 }
-//# sourceMappingURL=validatorAll.core.js.map

package/dist/validator/validatorAll/validatorNavigation.core.d.ts

@@ -14,4 +14,3 @@ import { type ValidationResult } from "../validator.types.js";
  * for items with neither `documentId` nor `children`.
  */
 export declare function validateNavigation(items: readonly DocumentationNavigationItem[], registeredIds: ReadonlySet<string>): ValidationResult;
-//# sourceMappingURL=validatorNavigation.core.d.ts.map

package/dist/validator/validatorAll/validatorNavigation.core.js

@@ -83,4 +83,3 @@ export function validateNavigation(items, registeredIds) {
     walk(items, []);
     return toValidationResult(issues);
 }
-//# sourceMappingURL=validatorNavigation.core.js.map

package/dist/validator/validatorDocument.core.d.ts

@@ -8,4 +8,3 @@ import { type ValidationResult } from "./validator.types.js";
  * shape (including structured nodes), and the metadata enums.
  */
 export declare function validateDocument(document: DocumentationDocument): ValidationResult;
-//# sourceMappingURL=validatorDocument.core.d.ts.map

package/dist/validator/validatorDocument.core.js

@@ -224,4 +224,3 @@ function describeNodeProblem(node) {
             return undefined;
     }
 }
-//# sourceMappingURL=validatorDocument.core.js.map

package/dist/validator/validatorDuplicates.core.d.ts

@@ -7,4 +7,3 @@ import { type ValidationResult } from "./validator.types.js";
  * Validates no duplicate IDs exist in a collection of documents.
  */
 export declare function validateNoDuplicateIds(documents: readonly DocumentationDocument[]): ValidationResult;
-//# sourceMappingURL=validatorDuplicates.core.d.ts.map

package/dist/validator/validatorDuplicates.core.js

@@ -23,4 +23,3 @@ export function validateNoDuplicateIds(documents) {
     }
     return toValidationResult(issues);
 }
-//# sourceMappingURL=validatorDuplicates.core.js.map

package/dist/validator/validatorLinks.core.d.ts

@@ -13,18 +13,28 @@ export interface ValidateLinksOptions {
      * Defaults to {@link DEFAULT_MAX_LINK_SCAN_LENGTH}.
      */
     readonly maxContentLength?: number;
+    /**
+     * Severity of a `BROKEN_LINK` issue (a relative link to an unregistered
+     * document). Defaults to `"warning"`, which never makes a result invalid;
+     * pass `"error"` to fail validation on dead links.
+     */
+    readonly brokenLinkSeverity?: "error" | "warning";
 }
 /**
  * Validates internal links in a document's markdown content and in
  * structured `link` nodes.
  *
- * A target whose scheme is not allowed (http, https, mailto, tel, ftp, ftps).(`javascript:`,
- * `data:`, `vbscript:` …) is reported as an `UNSAFE_LINK` error.
- * Skipped (never reported): images, anchors (`#…`), other targets with a
- * URL scheme or `//` prefix, links inside fenced or inline code.
+ * Every markdown link form is scanned: inline `[text](target)` (with
+ * balanced parentheses, `<…>` targets and titles), reference definitions
+ * `[label]: target`, raw HTML `href="…"` attributes and `<scheme:…>`
+ * autolinks. A target whose scheme is not on the allow-list (http, https,
+ * mailto, tel, ftp, ftps) — `javascript:`, `data:`, `vbscript:` … — is
+ * reported as an `UNSAFE_LINK` error.
+ * Skipped (never reported): images, anchors (`#…`), other targets with an
+ * allowed URL scheme or `//` prefix, links inside fenced or inline code.
  * Relative targets (`./x`, `../x`, `/x`) are resolved against the
  * document ID with `resolveDocumentLink`; bare targets are looked up
- * both as-is and resolved.
+ * both as-is and resolved. An unregistered target is a `BROKEN_LINK`
+ * whose severity is `options.brokenLinkSeverity` (default `"warning"`).
  */
 export declare function validateLinks(document: DocumentationDocument, registeredIds: ReadonlySet<string>, options?: ValidateLinksOptions): ValidationResult;
-//# sourceMappingURL=validatorLinks.core.d.ts.map

package/dist/validator/validatorLinks.core.js

@@ -3,42 +3,37 @@
  */
 import { resolveDocumentLink, stripFencedCodeBlocks, stripLinkDecorations, } from "../utils/utils.helper.js";
 import { isSafeLinkHref } from "../utils/utils.href.js";
+import { extractLinkTargets, stripInlineCode, } from "./validatorLinks.extract.js";
 import { toValidationResult, } from "./validator.types.js";
 /** Default maximum markdown length that is scanned for links. */
 export const DEFAULT_MAX_LINK_SCAN_LENGTH = 100_000;
-/**
- * Matches `[text](target)` and `![alt](target)` links. Group 1 is the
- * optional image bang, group 2 the target (optionally `<…>` wrapped
- * and followed by a `"title"`).
- *
- * Linear by construction: link text cannot contain `[`/`]` and a target
- * cannot contain `(`/`)`, so each start scans only to the next opener; the
- * target is non-empty, so leading whitespace is never split between two
- * quantifiers; and whitespace is `[ \t]` (the old `\s` ran across lines).
- * The old pattern took ~30 s on a 99 KB run of `[`.
- */
-const LINK_PATTERN = /(!?)\[[^[\]\n]*\]\((?:[ \t]*(<[^<>\n]*>|[^()\s<>]+)(?:[ \t]+(?:"[^"\n]*"|'[^'\n]*'))?)?[ \t]*\)/g;
 /** `scheme:` (mailto:, ftp:, http:) or protocol-relative `//`. */
 const EXTERNAL_PATTERN = /^([a-zA-Z][a-zA-Z0-9+.-]*:|\/\/)/;
 /**
  * Validates internal links in a document's markdown content and in
  * structured `link` nodes.
  *
- * A target whose scheme is not allowed (http, https, mailto, tel, ftp, ftps).(`javascript:`,
- * `data:`, `vbscript:` …) is reported as an `UNSAFE_LINK` error.
- * Skipped (never reported): images, anchors (`#…`), other targets with a
- * URL scheme or `//` prefix, links inside fenced or inline code.
+ * Every markdown link form is scanned: inline `[text](target)` (with
+ * balanced parentheses, `<…>` targets and titles), reference definitions
+ * `[label]: target`, raw HTML `href="…"` attributes and `<scheme:…>`
+ * autolinks. A target whose scheme is not on the allow-list (http, https,
+ * mailto, tel, ftp, ftps) — `javascript:`, `data:`, `vbscript:` … — is
+ * reported as an `UNSAFE_LINK` error.
+ * Skipped (never reported): images, anchors (`#…`), other targets with an
+ * allowed URL scheme or `//` prefix, links inside fenced or inline code.
  * Relative targets (`./x`, `../x`, `/x`) are resolved against the
  * document ID with `resolveDocumentLink`; bare targets are looked up
- * both as-is and resolved.
+ * both as-is and resolved. An unregistered target is a `BROKEN_LINK`
+ * whose severity is `options.brokenLinkSeverity` (default `"warning"`).
  */
 export function validateLinks(document, registeredIds, options = {}) {
     const issues = [];
     const content = document.content;
+    const brokenSeverity = options.brokenLinkSeverity ?? "warning";
     if (content.type === "structured") {
         for (const node of content.nodes) {
             if (node.type === "link") {
-                checkTarget(node.href, document, registeredIds, issues);
+                checkTarget(node.href, document, registeredIds, issues, brokenSeverity);
             }
         }
         return toValidationResult(issues);
@@ -57,19 +52,14 @@ export function validateLinks(document, registeredIds, options = {}) {
         return toValidationResult(issues);
     }
     const source = stripInlineCode(stripFencedCodeBlocks(content.value));
-    for (const match of source.matchAll(LINK_PATTERN)) {
-        const isImage = match[1] === "!";
-        let target = match[2] ?? "";
-        if (isImage)
+    for (const link of extractLinkTargets(source)) {
+        if (link.isImage)
             continue;
-        if (target.startsWith("<") && target.endsWith(">")) {
-            target = target.slice(1, -1);
-        }
-        checkTarget(target, document, registeredIds, issues);
+        checkTarget(link.target, document, registeredIds, issues, brokenSeverity);
     }
     return toValidationResult(issues);
 }
-function checkTarget(rawTarget, document, registeredIds, issues) {
+function checkTarget(rawTarget, document, registeredIds, issues, brokenSeverity) {
     const target = rawTarget.trim();
     if (target === "" || target.startsWith("#"))
         return;
@@ -97,18 +87,9 @@ function checkTarget(rawTarget, document, registeredIds, issues) {
             return;
     }
     issues.push({
-        severity: "warning",
+        severity: brokenSeverity,
         code: "BROKEN_LINK",
         message: `Document "${document.id}" links to "${rawTarget}" which is not registered.`,
         documentId: document.id,
     });
 }
-/**
- * Blanks out inline code spans so links inside them are ignored. The
- * lookarounds anchor each attempt at a whole backtick run, so a long run is
- * not re-scanned from every position inside it.
- */
-function stripInlineCode(markdown) {
-    return markdown.replace(/(?<!`)(`+)(?![`\n])[\s\S]*?(?<!`)\1(?!`)/g, (m) => " ".repeat(m.length));
-}
-//# sourceMappingURL=validatorLinks.core.js.map

package/dist/validator/validatorLinks.extract.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Extracts link targets from markdown in every form a renderer turns into
+ * a live link: inline `[text](target)`, reference definitions
+ * `[label]: target`, raw HTML `href` attributes and `<scheme:…>` autolinks.
+ *
+ * Every scanner is linear in the input length, so hostile documents
+ * (a 99 KB run of `[`, `(` or `<`) are scanned in milliseconds.
+ *
+ * @module validator/validatorLinks.extract
+ */
+/** A link target found in markdown. */
+export interface ExtractedLink {
+    /** The raw target, without `<…>` wrapping. */
+    readonly target: string;
+    /** True for `![alt](target)` images, which are never validated. */
+    readonly isImage: boolean;
+}
+/**
+ * Returns every distinct link target in `source`, in order of first
+ * appearance. `source` must already have fenced code blocks and inline
+ * code spans removed. A target found by two scanners (`[x](<t>)` is both
+ * an inline link and an autolink) is returned once.
+ */
+export declare function extractLinkTargets(source: string): readonly ExtractedLink[];
+/**
+ * Blanks out inline code spans so links inside them are ignored. The
+ * lookarounds anchor each attempt at a whole backtick run, so a long run is
+ * not re-scanned from every position inside it.
+ */
+export declare function stripInlineCode(markdown: string): string;