@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/markdown-link-validation/markdown-parser.mjs

@@ -0,0 +1,191 @@
+import GithubSlugger from "github-slugger";
+import { fromMarkdown } from "mdast-util-from-markdown";
+import { frontmatterFromMarkdown } from "mdast-util-frontmatter";
+import { gfmFromMarkdown } from "mdast-util-gfm";
+import { frontmatter } from "micromark-extension-frontmatter";
+import { gfm } from "micromark-extension-gfm";
+/**
+ * Link-private Markdown grammar adapter. It deliberately exposes facts rather
+ * than the dependency AST, so resolver ownership starts after parsing.
+ */
+export function parseMarkdownLinkFacts(markdown) {
+    if (hasUnpairedSurrogate(markdown)) {
+        return parseFailure();
+    }
+    try {
+        const tree = fromMarkdown(markdown, {
+            extensions: [gfm(), frontmatter(["yaml"])],
+            mdastExtensions: [gfmFromMarkdown(), frontmatterFromMarkdown(["yaml"])]
+        });
+        if (!isMarkdownAstNode(tree)) {
+            return parseFailure();
+        }
+        return collectMarkdownLinkFacts(tree);
+    }
+    catch {
+        return parseFailure();
+    }
+}
+function collectMarkdownLinkFacts(tree) {
+    const definitions = definitionsByIdentifier(tree);
+    const occurrences = [];
+    const headings = [];
+    const slugger = new GithubSlugger();
+    forEachNode(tree, (node) => {
+        const occurrence = occurrenceFromNode(node, definitions);
+        if (occurrence !== null) {
+            occurrences.push(occurrence);
+        }
+        if (node.type === "heading") {
+            const heading = headingFromNode(node, slugger);
+            if (heading === null) {
+                throw new Error("Markdown heading did not include a source range.");
+            }
+            headings.push(heading);
+        }
+    });
+    return Object.freeze({
+        ok: true,
+        facts: Object.freeze({
+            occurrences: Object.freeze(occurrences),
+            headings: Object.freeze(headings)
+        })
+    });
+}
+function definitionsByIdentifier(tree) {
+    const definitions = new Map();
+    forEachNode(tree, (node) => {
+        if (node.type !== "definition") {
+            return;
+        }
+        if (node.identifier === undefined || node.url === undefined) {
+            throw new Error("Markdown definition was missing a destination.");
+        }
+        if (!definitions.has(node.identifier)) {
+            definitions.set(node.identifier, node.url);
+        }
+    });
+    return definitions;
+}
+function occurrenceFromNode(node, definitions) {
+    if (node.type === "link") {
+        return occurrenceFromResource(node, "link");
+    }
+    if (node.type === "image") {
+        return occurrenceFromResource(node, "image");
+    }
+    if (node.type === "linkReference") {
+        return occurrenceFromReference(node, "link", definitions);
+    }
+    if (node.type === "imageReference") {
+        return occurrenceFromReference(node, "image", definitions);
+    }
+    return null;
+}
+function occurrenceFromResource(node, kind) {
+    if (node.url === undefined) {
+        throw new Error("Markdown occurrence was missing a destination.");
+    }
+    return occurrenceWithDestination(node, kind, node.url);
+}
+function occurrenceWithDestination(node, kind, rawDestination) {
+    const range = sourceRangeFromPosition(node.position);
+    if (range === null) {
+        throw new Error("Markdown occurrence did not include a source range.");
+    }
+    return Object.freeze({ kind, rawDestination, range });
+}
+function occurrenceFromReference(node, kind, definitions) {
+    if (node.identifier === undefined) {
+        throw new Error("Markdown reference was missing an identifier.");
+    }
+    const rawDestination = definitions.get(node.identifier);
+    if (rawDestination === undefined) {
+        return null;
+    }
+    return occurrenceWithDestination(node, kind, rawDestination);
+}
+function headingFromNode(node, slugger) {
+    const range = sourceRangeFromPosition(node.position);
+    if (range === null) {
+        return null;
+    }
+    return Object.freeze({
+        slug: slugger.slug(markdownText(node)),
+        range
+    });
+}
+function markdownText(node) {
+    if (node.value !== undefined) {
+        return node.value;
+    }
+    if (node.children !== undefined) {
+        return node.children.map(markdownText).join("");
+    }
+    if (node.type === "image" || node.type === "imageReference") {
+        return node.alt ?? "";
+    }
+    return "";
+}
+function isMarkdownAstNode(value) {
+    if (typeof value !== "object" ||
+        value === null ||
+        !("type" in value) ||
+        !("children" in value) ||
+        !Array.isArray(value.children)) {
+        return false;
+    }
+    return typeof value.type === "string";
+}
+function sourceRangeFromPosition(position) {
+    if (position === undefined ||
+        position.start.offset === undefined ||
+        position.end.offset === undefined) {
+        return null;
+    }
+    return Object.freeze({
+        startOffset: position.start.offset,
+        endOffset: position.end.offset,
+        start: Object.freeze({ line: position.start.line, column: position.start.column }),
+        end: Object.freeze({ line: position.end.line, column: position.end.column })
+    });
+}
+function forEachNode(root, visitor) {
+    const nodes = [root];
+    while (nodes.length > 0) {
+        const node = nodes.pop();
+        if (node === undefined) {
+            return;
+        }
+        visitor(node);
+        if (node.children !== undefined) {
+            for (let index = node.children.length - 1; index >= 0; index -= 1) {
+                const child = node.children[index];
+                if (child !== undefined) {
+                    nodes.push(child);
+                }
+            }
+        }
+    }
+}
+function hasUnpairedSurrogate(markdown) {
+    for (let index = 0; index < markdown.length; index += 1) {
+        const codeUnit = markdown.charCodeAt(index);
+        if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {
+            const nextCodeUnit = markdown.charCodeAt(index + 1);
+            if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) {
+                return true;
+            }
+            index += 1;
+            continue;
+        }
+        if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {
+            return true;
+        }
+    }
+    return false;
+}
+function parseFailure() {
+    return Object.freeze({ ok: false, reason: "markdown-parse-failure" });
+}
+//# sourceMappingURL=markdown-parser.mjs.map

package/dist/esm/package-checks/markdown-link-validation/markdown-parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-parser.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/markdown-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import GithubSlugger from \"github-slugger\";\nimport { fromMarkdown } from \"mdast-util-from-markdown\";\nimport { frontmatterFromMarkdown } from \"mdast-util-frontmatter\";\nimport { gfmFromMarkdown } from \"mdast-util-gfm\";\nimport { frontmatter } from \"micromark-extension-frontmatter\";\nimport { gfm } from \"micromark-extension-gfm\";\n\ninterface MarkdownAstPoint {\n  readonly line: number;\n  readonly column: number;\n  readonly offset?: number;\n}\n\ninterface MarkdownAstPosition {\n  readonly start: MarkdownAstPoint;\n  readonly end: MarkdownAstPoint;\n}\n\ninterface MarkdownAstNode {\n  readonly type: string;\n  readonly position?: MarkdownAstPosition;\n  readonly children?: readonly MarkdownAstNode[];\n  readonly value?: string;\n  readonly url?: string;\n  readonly identifier?: string;\n  readonly alt?: string | null;\n}\n\ntype MarkdownOccurrenceKind = \"image\" | \"link\";\n\ninterface MarkdownSourcePosition {\n  readonly line: number;\n  readonly column: number;\n}\n\ninterface MarkdownSourceRange {\n  readonly startOffset: number;\n  readonly endOffset: number;\n  readonly start: MarkdownSourcePosition;\n  readonly end: MarkdownSourcePosition;\n}\n\ninterface MarkdownLinkOccurrence {\n  readonly kind: MarkdownOccurrenceKind;\n  readonly rawDestination: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface MarkdownHeading {\n  readonly slug: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface ParsedMarkdownLinkFacts {\n  readonly occurrences: readonly MarkdownLinkOccurrence[];\n  readonly headings: readonly MarkdownHeading[];\n}\n\ntype MarkdownLinkParseResult =\n  | Readonly<{\n      readonly ok: true;\n      readonly facts: ParsedMarkdownLinkFacts;\n    }>\n  | Readonly<{\n      readonly ok: false;\n      readonly reason: \"markdown-parse-failure\";\n    }>;\n\n/**\n * Link-private Markdown grammar adapter. It deliberately exposes facts rather\n * than the dependency AST, so resolver ownership starts after parsing.\n */\nexport function parseMarkdownLinkFacts(markdown: string): MarkdownLinkParseResult {\n  if (hasUnpairedSurrogate(markdown)) {\n    return parseFailure();\n  }\n\n  try {\n    const tree: unknown = fromMarkdown(markdown, {\n      extensions: [gfm(), frontmatter([\"yaml\"])],\n      mdastExtensions: [gfmFromMarkdown(), frontmatterFromMarkdown([\"yaml\"])]\n    });\n    if (!isMarkdownAstNode(tree)) {\n      return parseFailure();\n    }\n    return collectMarkdownLinkFacts(tree);\n  } catch {\n    return parseFailure();\n  }\n}\n\nfunction collectMarkdownLinkFacts(tree: MarkdownAstNode): MarkdownLinkParseResult {\n  const definitions = definitionsByIdentifier(tree);\n  const occurrences: MarkdownLinkOccurrence[] = [];\n  const headings: MarkdownHeading[] = [];\n  const slugger = new GithubSlugger();\n\n  forEachNode(tree, (node) => {\n    const occurrence = occurrenceFromNode(node, definitions);\n    if (occurrence !== null) {\n      occurrences.push(occurrence);\n    }\n\n    if (node.type === \"heading\") {\n      const heading = headingFromNode(node, slugger);\n      if (heading === null) {\n        throw new Error(\"Markdown heading did not include a source range.\");\n      }\n      headings.push(heading);\n    }\n  });\n\n  return Object.freeze({\n    ok: true as const,\n    facts: Object.freeze({\n      occurrences: Object.freeze(occurrences),\n      headings: Object.freeze(headings)\n    })\n  });\n}\n\nfunction definitionsByIdentifier(tree: MarkdownAstNode): ReadonlyMap<string, string> {\n  const definitions = new Map<string, string>();\n\n  forEachNode(tree, (node) => {\n    if (node.type !== \"definition\") {\n      return;\n    }\n    if (node.identifier === undefined || node.url === undefined) {\n      throw new Error(\"Markdown definition was missing a destination.\");\n    }\n    if (!definitions.has(node.identifier)) {\n      definitions.set(node.identifier, node.url);\n    }\n  });\n\n  return definitions;\n}\n\nfunction occurrenceFromNode(\n  node: MarkdownAstNode,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.type === \"link\") {\n    return occurrenceFromResource(node, \"link\");\n  }\n  if (node.type === \"image\") {\n    return occurrenceFromResource(node, \"image\");\n  }\n  if (node.type === \"linkReference\") {\n    return occurrenceFromReference(node, \"link\", definitions);\n  }\n  if (node.type === \"imageReference\") {\n    return occurrenceFromReference(node, \"image\", definitions);\n  }\n  return null;\n}\n\nfunction occurrenceFromResource(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind\n): MarkdownLinkOccurrence | null {\n  if (node.url === undefined) {\n    throw new Error(\"Markdown occurrence was missing a destination.\");\n  }\n  return occurrenceWithDestination(node, kind, node.url);\n}\n\nfunction occurrenceWithDestination(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  rawDestination: string\n): MarkdownLinkOccurrence | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    throw new Error(\"Markdown occurrence did not include a source range.\");\n  }\n  return Object.freeze({ kind, rawDestination, range });\n}\n\nfunction occurrenceFromReference(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.identifier === undefined) {\n    throw new Error(\"Markdown reference was missing an identifier.\");\n  }\n  const rawDestination = definitions.get(node.identifier);\n  if (rawDestination === undefined) {\n    return null;\n  }\n  return occurrenceWithDestination(node, kind, rawDestination);\n}\n\nfunction headingFromNode(node: MarkdownAstNode, slugger: GithubSlugger): MarkdownHeading | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    return null;\n  }\n  return Object.freeze({\n    slug: slugger.slug(markdownText(node)),\n    range\n  });\n}\n\nfunction markdownText(node: MarkdownAstNode): string {\n  if (node.value !== undefined) {\n    return node.value;\n  }\n  if (node.children !== undefined) {\n    return node.children.map(markdownText).join(\"\");\n  }\n  if (node.type === \"image\" || node.type === \"imageReference\") {\n    return node.alt ?? \"\";\n  }\n  return \"\";\n}\n\nfunction isMarkdownAstNode(value: unknown): value is MarkdownAstNode {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !(\"type\" in value) ||\n    !(\"children\" in value) ||\n    !Array.isArray(value.children)\n  ) {\n    return false;\n  }\n  return typeof value.type === \"string\";\n}\n\nfunction sourceRangeFromPosition(\n  position: MarkdownAstPosition | undefined\n): MarkdownSourceRange | null {\n  if (\n    position === undefined ||\n    position.start.offset === undefined ||\n    position.end.offset === undefined\n  ) {\n    return null;\n  }\n\n  return Object.freeze({\n    startOffset: position.start.offset,\n    endOffset: position.end.offset,\n    start: Object.freeze({ line: position.start.line, column: position.start.column }),\n    end: Object.freeze({ line: position.end.line, column: position.end.column })\n  });\n}\n\nfunction forEachNode(root: MarkdownAstNode, visitor: (node: MarkdownAstNode) => void): void {\n  const nodes: MarkdownAstNode[] = [root];\n\n  while (nodes.length > 0) {\n    const node = nodes.pop();\n    if (node === undefined) {\n      return;\n    }\n    visitor(node);\n    if (node.children !== undefined) {\n      for (let index = node.children.length - 1; index >= 0; index -= 1) {\n        const child = node.children[index];\n        if (child !== undefined) {\n          nodes.push(child);\n        }\n      }\n    }\n  }\n}\n\nfunction hasUnpairedSurrogate(markdown: string): boolean {\n  for (let index = 0; index < markdown.length; index += 1) {\n    const codeUnit = markdown.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const nextCodeUnit = markdown.charCodeAt(index + 1);\n      if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) {\n        return true;\n      }\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction parseFailure(): MarkdownLinkParseResult {\n  return Object.freeze({ ok: false as const, reason: \"markdown-parse-failure\" as const });\n}\n\nexport type {\n  MarkdownHeading,\n  MarkdownLinkOccurrence,\n  MarkdownLinkParseResult,\n  MarkdownOccurrenceKind,\n  MarkdownSourcePosition,\n  MarkdownSourceRange,\n  ParsedMarkdownLinkFacts\n};\n"]}

package/dist/esm/package-checks/markdown-link-validation/options-resolution.mjs

@@ -0,0 +1,83 @@
+import { canonicalizeJsonObject } from "../../data-boundary/canonical-data.mjs";
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
+import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
+const DEFAULT_LIMITS = Object.freeze({
+    maxMarkdownBytes: 1_048_576,
+    maxOccurrences: 10_000,
+    maxTargetReads: 1_000
+});
+const DEFAULT_FILES = Object.freeze({
+    exclude: defaultProjectFileSelection.exclude,
+    include: Object.freeze(["**/*.[mM][dD]", "**/*.[mM][aA][rR][kK][dD][oO][wW][nN]"]),
+    source: defaultProjectFileSelection.source
+});
+/** 将可省略 Markdown link policy 物化为完整、冻结的 execution options。 */
+export function resolveMarkdownLinkValidationOptions(value) {
+    const input = snapshotClosedRecord(value);
+    if (!isMarkdownLinkValidationInput(input))
+        return undefined;
+    const limits = resolvedLimits(input.limits);
+    const files = resolvedFiles(input.files);
+    const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
+    if (limits === undefined || files === undefined || findingPolicy === undefined)
+        return undefined;
+    const candidate = optionsCandidate(input, files, findingPolicy, limits);
+    return candidate !== undefined && validMarkdownLinkValidationOptions(candidate)
+        ? candidate
+        : undefined;
+}
+function optionsCandidate(input, files, findingPolicy, limits) {
+    return canonicalizeJsonObject({
+        files,
+        findingPolicy,
+        requireExistingTargets: input.requireExistingTargets === undefined ? true : input.requireExistingTargets,
+        validateSameDocumentAnchors: input.validateSameDocumentAnchors === undefined ? true : input.validateSameDocumentAnchors,
+        validateCrossDocumentAnchors: input.validateCrossDocumentAnchors === undefined ? true : input.validateCrossDocumentAnchors,
+        rootExternalTargetMode: input.rootExternalTargetMode === undefined ? "report" : input.rootExternalTargetMode,
+        requireNonEmptyDirectories: input.requireNonEmptyDirectories === undefined ? false : input.requireNonEmptyDirectories,
+        limits
+    });
+}
+function isMarkdownLinkValidationInput(input) {
+    return (input !== undefined &&
+        hasRequiredAndOptionalRecordKeys(input, {
+            optional: [
+                "files",
+                "findingPolicy",
+                "requireExistingTargets",
+                "validateSameDocumentAnchors",
+                "validateCrossDocumentAnchors",
+                "rootExternalTargetMode",
+                "requireNonEmptyDirectories",
+                "limits"
+            ],
+            required: []
+        }));
+}
+function resolvedFiles(value) {
+    return value === undefined
+        ? snapshotProjectFileSelection(DEFAULT_FILES)
+        : resolveProjectFileSelection(value, DEFAULT_FILES);
+}
+function resolvedLimits(value) {
+    if (value === undefined)
+        return DEFAULT_LIMITS;
+    const limits = snapshotClosedRecord(value);
+    if (limits === undefined ||
+        !hasRequiredAndOptionalRecordKeys(limits, {
+            optional: ["maxMarkdownBytes", "maxOccurrences", "maxTargetReads"],
+            required: []
+        })) {
+        return undefined;
+    }
+    return Object.freeze({
+        maxMarkdownBytes: limits.maxMarkdownBytes === undefined
+            ? DEFAULT_LIMITS.maxMarkdownBytes
+            : limits.maxMarkdownBytes,
+        maxOccurrences: limits.maxOccurrences === undefined ? DEFAULT_LIMITS.maxOccurrences : limits.maxOccurrences,
+        maxTargetReads: limits.maxTargetReads === undefined ? DEFAULT_LIMITS.maxTargetReads : limits.maxTargetReads
+    });
+}
+//# sourceMappingURL=options-resolution.mjs.map

package/dist/esm/package-checks/markdown-link-validation/options-resolution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import { canonicalizeJsonObject } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  defaultProjectFileSelection,\n  resolveProjectFileSelection,\n  snapshotProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_LIMITS = Object.freeze({\n  maxMarkdownBytes: 1_048_576,\n  maxOccurrences: 10_000,\n  maxTargetReads: 1_000\n});\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: Object.freeze([\"**/*.[mM][dD]\", \"**/*.[mM][aA][rR][kK][dD][oO][wW][nN]\"]),\n  source: defaultProjectFileSelection.source\n});\n\n/** 将可省略 Markdown link policy 物化为完整、冻结的 execution options。 */\nexport function resolveMarkdownLinkValidationOptions(\n  value: unknown\n): ResolvedMarkdownLinkValidationOptions | undefined {\n  const input = snapshotClosedRecord(value);\n  if (!isMarkdownLinkValidationInput(input)) return undefined;\n  const limits = resolvedLimits(input.limits);\n  const files = resolvedFiles(input.files);\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  if (limits === undefined || files === undefined || findingPolicy === undefined) return undefined;\n  const candidate = optionsCandidate(input, files, findingPolicy, limits);\n  return candidate !== undefined && validMarkdownLinkValidationOptions(candidate)\n    ? candidate\n    : undefined;\n}\n\nfunction optionsCandidate(\n  input: Readonly<Record<string, unknown>>,\n  files: Exclude<ReturnType<typeof resolvedFiles>, undefined>,\n  findingPolicy: Exclude<ReturnType<typeof resolveFindingPolicy>, undefined>,\n  limits: Readonly<Record<string, unknown>>\n) {\n  return canonicalizeJsonObject({\n    files,\n    findingPolicy,\n    requireExistingTargets:\n      input.requireExistingTargets === undefined ? true : input.requireExistingTargets,\n    validateSameDocumentAnchors:\n      input.validateSameDocumentAnchors === undefined ? true : input.validateSameDocumentAnchors,\n    validateCrossDocumentAnchors:\n      input.validateCrossDocumentAnchors === undefined ? true : input.validateCrossDocumentAnchors,\n    rootExternalTargetMode:\n      input.rootExternalTargetMode === undefined ? \"report\" : input.rootExternalTargetMode,\n    requireNonEmptyDirectories:\n      input.requireNonEmptyDirectories === undefined ? false : input.requireNonEmptyDirectories,\n    limits\n  });\n}\n\nfunction isMarkdownLinkValidationInput(\n  input: Readonly<Record<string, unknown>> | undefined\n): input is Readonly<Record<string, unknown>> {\n  return (\n    input !== undefined &&\n    hasRequiredAndOptionalRecordKeys(input, {\n      optional: [\n        \"files\",\n        \"findingPolicy\",\n        \"requireExistingTargets\",\n        \"validateSameDocumentAnchors\",\n        \"validateCrossDocumentAnchors\",\n        \"rootExternalTargetMode\",\n        \"requireNonEmptyDirectories\",\n        \"limits\"\n      ],\n      required: []\n    })\n  );\n}\n\nfunction resolvedFiles(value: unknown) {\n  return value === undefined\n    ? snapshotProjectFileSelection(DEFAULT_FILES)\n    : resolveProjectFileSelection(value, DEFAULT_FILES);\n}\n\nfunction resolvedLimits(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  if (value === undefined) return DEFAULT_LIMITS;\n  const limits = snapshotClosedRecord(value);\n  if (\n    limits === undefined ||\n    !hasRequiredAndOptionalRecordKeys(limits, {\n      optional: [\"maxMarkdownBytes\", \"maxOccurrences\", \"maxTargetReads\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    maxMarkdownBytes:\n      limits.maxMarkdownBytes === undefined\n        ? DEFAULT_LIMITS.maxMarkdownBytes\n        : limits.maxMarkdownBytes,\n    maxOccurrences:\n      limits.maxOccurrences === undefined ? DEFAULT_LIMITS.maxOccurrences : limits.maxOccurrences,\n    maxTargetReads:\n      limits.maxTargetReads === undefined ? DEFAULT_LIMITS.maxTargetReads : limits.maxTargetReads\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/options-validation.mjs

@@ -0,0 +1,50 @@
+import { hasExactPlainRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { validProjectFileSelection } from "../project-files/configuration.mjs";
+import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
+function exactRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function boundedPositiveSafeInteger(value, maximum) {
+    return positiveSafeInteger(value) && value <= maximum;
+}
+export function validMarkdownLinkValidationOptions(value) {
+    const options = exactRecord(value, [
+        "files",
+        "findingPolicy",
+        "requireExistingTargets",
+        "validateSameDocumentAnchors",
+        "validateCrossDocumentAnchors",
+        "rootExternalTargetMode",
+        "requireNonEmptyDirectories",
+        "limits"
+    ]);
+    return options !== undefined && validOptionFields(options);
+}
+function validOptionFields(options) {
+    return (validProjectFileSelection(options.files) &&
+        validFindingPolicy(options.findingPolicy) &&
+        validAnchorValidationOptions(options) &&
+        validMarkdownLinkLimits(options.limits));
+}
+function validAnchorValidationOptions(options) {
+    return (typeof options.requireExistingTargets === "boolean" &&
+        typeof options.validateSameDocumentAnchors === "boolean" &&
+        typeof options.validateCrossDocumentAnchors === "boolean" &&
+        validRootExternalTargetMode(options.rootExternalTargetMode) &&
+        typeof options.requireNonEmptyDirectories === "boolean");
+}
+function validRootExternalTargetMode(value) {
+    return value === "ignore" || value === "report" || value === "validate";
+}
+function validMarkdownLinkLimits(value) {
+    const limits = exactRecord(value, ["maxMarkdownBytes", "maxOccurrences", "maxTargetReads"]);
+    return (limits !== undefined &&
+        boundedPositiveSafeInteger(limits.maxMarkdownBytes, 16_777_216) &&
+        boundedPositiveSafeInteger(limits.maxOccurrences, 100_000) &&
+        boundedPositiveSafeInteger(limits.maxTargetReads, 10_000));
+}
+//# sourceMappingURL=options-validation.mjs.map

package/dist/esm/package-checks/markdown-link-validation/options-validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAGxE,SAAS,WAAW,CAClB,KAAc,EACd,IAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,MAAM,KAAK,SAAS,IAAI,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5F,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc,EAAE,OAAe;IACjE,OAAO,mBAAmB,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAc;IAEd,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE;QACjC,OAAO;QACP,eAAe;QACf,wBAAwB;QACxB,6BAA6B;QAC7B,8BAA8B;QAC9B,wBAAwB;QACxB,4BAA4B;QAC5B,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,OAAO,KAAK,SAAS,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA0C;IACnE,OAAO,CACL,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC;QACzC,4BAA4B,CAAC,OAAO,CAAC;QACrC,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,OAA0C;IAC9E,OAAO,CACL,OAAO,OAAO,CAAC,sBAAsB,KAAK,SAAS;QACnD,OAAO,OAAO,CAAC,2BAA2B,KAAK,SAAS;QACxD,OAAO,OAAO,CAAC,4BAA4B,KAAK,SAAS;QACzD,2BAA2B,CAAC,OAAO,CAAC,sBAAsB,CAAC;QAC3D,OAAO,OAAO,CAAC,0BAA0B,KAAK,SAAS,CACxD,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,CAAC;AAC1E,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC,CAAC,CAAC;IAC5F,OAAO,CACL,MAAM,KAAK,SAAS;QACpB,0BAA0B,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC;QAC/D,0BAA0B,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC;QAC1D,0BAA0B,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAC1D,CAAC;AACJ,CAAC","sourcesContent":["import {\n  hasExactPlainRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nfunction exactRecord(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction boundedPositiveSafeInteger(value: unknown, maximum: number): value is number {\n  return positiveSafeInteger(value) && value <= maximum;\n}\n\nexport function validMarkdownLinkValidationOptions(\n  value: unknown\n): value is ResolvedMarkdownLinkValidationOptions {\n  const options = exactRecord(value, [\n    \"files\",\n    \"findingPolicy\",\n    \"requireExistingTargets\",\n    \"validateSameDocumentAnchors\",\n    \"validateCrossDocumentAnchors\",\n    \"rootExternalTargetMode\",\n    \"requireNonEmptyDirectories\",\n    \"limits\"\n  ]);\n  return options !== undefined && validOptionFields(options);\n}\n\nfunction validOptionFields(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    validProjectFileSelection(options.files) &&\n    validFindingPolicy(options.findingPolicy) &&\n    validAnchorValidationOptions(options) &&\n    validMarkdownLinkLimits(options.limits)\n  );\n}\n\nfunction validAnchorValidationOptions(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    typeof options.requireExistingTargets === \"boolean\" &&\n    typeof options.validateSameDocumentAnchors === \"boolean\" &&\n    typeof options.validateCrossDocumentAnchors === \"boolean\" &&\n    validRootExternalTargetMode(options.rootExternalTargetMode) &&\n    typeof options.requireNonEmptyDirectories === \"boolean\"\n  );\n}\n\nfunction validRootExternalTargetMode(value: unknown): boolean {\n  return value === \"ignore\" || value === \"report\" || value === \"validate\";\n}\n\nfunction validMarkdownLinkLimits(value: unknown): boolean {\n  const limits = exactRecord(value, [\"maxMarkdownBytes\", \"maxOccurrences\", \"maxTargetReads\"]);\n  return (\n    limits !== undefined &&\n    boundedPositiveSafeInteger(limits.maxMarkdownBytes, 16_777_216) &&\n    boundedPositiveSafeInteger(limits.maxOccurrences, 100_000) &&\n    boundedPositiveSafeInteger(limits.maxTargetReads, 10_000)\n  );\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/options.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.mjs.map

package/dist/esm/package-checks/markdown-link-validation/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\n\nexport type MarkdownRootExternalTargetMode = \"ignore\" | \"report\" | \"validate\";\n\n/** 可省略的 Markdown validation work limits。 */\nexport interface MarkdownLinkValidationLimitOptions {\n  readonly maxMarkdownBytes?: number;\n  readonly maxOccurrences?: number;\n  readonly maxTargetReads?: number;\n}\n\n/** `markdownLinkValidation(options?)` 接受的可省略 authoring policy。 */\nexport interface MarkdownLinkValidationOptions {\n  /** 参与本 Check 的 Markdown source selection；省略字段使用 package defaults。 */\n  readonly files?: ProjectFileSelectionOptions;\n  /** local-reference finding 是否使本 Check failed；省略时为 non-blocking。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** `false` 时缺失的本地文件或目录不构成 finding。 */\n  readonly requireExistingTargets?: boolean;\n  /** 是否检查 `#anchor` 对当前 Markdown 文档标题的引用。 */\n  readonly validateSameDocumentAnchors?: boolean;\n  /** 是否检查直接指向的 Markdown 文件中的 `#anchor`。 */\n  readonly validateCrossDocumentAnchors?: boolean;\n  /** root 外本机目标的授权模式；不授权网络请求。 */\n  readonly rootExternalTargetMode?: MarkdownRootExternalTargetMode;\n  /** 是否将空目录目标视为 finding。 */\n  readonly requireNonEmptyDirectories?: boolean;\n  /** 每次运行的 Markdown 内容、occurrence 和 direct target work 上限。 */\n  readonly limits?: MarkdownLinkValidationLimitOptions;\n}\n\n/** `markdown-link-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedMarkdownLinkValidationOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly requireExistingTargets: boolean;\n  readonly validateSameDocumentAnchors: boolean;\n  readonly validateCrossDocumentAnchors: boolean;\n  readonly rootExternalTargetMode: MarkdownRootExternalTargetMode;\n  readonly requireNonEmptyDirectories: boolean;\n  readonly limits: Readonly<{\n    readonly maxMarkdownBytes: number;\n    readonly maxOccurrences: number;\n    readonly maxTargetReads: number;\n  }>;\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/records.mjs

@@ -0,0 +1,32 @@
+export function buildMarkdownLinkRecordCandidate(sourcePath, occurrenceIndex, occurrence, resolution) {
+    if (resolution.kind !== "finding")
+        return undefined;
+    return Object.freeze({
+        id: `source:${encodeURIComponent(sourcePath)}:occurrence:${occurrenceIndex + 1}:reason:${resolution.reason}`,
+        data: Object.freeze({
+            reason: resolution.reason,
+            occurrenceKind: occurrence.kind,
+            sourcePath,
+            range: publicRange(occurrence.range),
+            target: resolution.target
+        })
+    });
+}
+export function buildMarkdownInputRejectedRecord(path) {
+    return Object.freeze({
+        data: Object.freeze({
+            blocking: false,
+            kind: "input-rejected",
+            path,
+            reason: "unsupported-file-type"
+        }),
+        id: `/input-rejected/${path}`
+    });
+}
+function publicRange(range) {
+    return Object.freeze({
+        start: Object.freeze({ line: range.start.line, column: range.start.column }),
+        end: Object.freeze({ line: range.end.line, column: range.end.column })
+    });
+}
+//# sourceMappingURL=records.mjs.map

package/dist/esm/package-checks/markdown-link-validation/records.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/records.ts"],"names":[],"mappings":"AAqCA,MAAM,UAAU,gCAAgC,CAC9C,UAAkB,EAClB,eAAuB,EACvB,UAAkC,EAClC,UAAmC;IAEnC,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACpD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,UAAU,kBAAkB,CAAC,UAAU,CAAC,eAAe,eAAe,GAAG,CAAC,WAAW,UAAU,CAAC,MAAM,EAAE;QAC5G,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,cAAc,EAAE,UAAU,CAAC,IAAI;YAC/B,UAAU;YACV,KAAK,EAAE,WAAW,CAAC,UAAU,CAAC,KAAK,CAAC;YACpC,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,IAAY;IAI3D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,QAAQ,EAAE,KAAK;YACf,IAAI,EAAE,gBAAgB;YACtB,IAAI;YACJ,MAAM,EAAE,uBAAuB;SAChC,CAAC;QACF,EAAE,EAAE,mBAAmB,IAAI,EAAE;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,KAA0B;IAC7C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5E,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;KACvE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  MarkdownLinkFindingReason,\n  MarkdownLocalResolution,\n  MarkdownSafeTargetDescriptor\n} from \"./local-resolver.ts\";\nimport type { MarkdownLinkOccurrence, MarkdownSourceRange } from \"./markdown-parser.ts\";\n\n/** 一条本地 Markdown link finding supplemental Record 的 data。 */\nexport type MarkdownLinkFindingRecordData = Readonly<{\n  readonly occurrenceKind: \"link\" | \"image\";\n  readonly range: Readonly<{\n    readonly end: Readonly<{ readonly column: number; readonly line: number }>;\n    readonly start: Readonly<{ readonly column: number; readonly line: number }>;\n  }>;\n  readonly reason: MarkdownLinkFindingReason;\n  readonly sourcePath: string;\n  readonly target: MarkdownSafeTargetDescriptor;\n}>;\n\n/** 一条 files policy 已选中但不受 Markdown Link 支持的输入 Finding。 */\nexport type MarkdownLinkInputRejectedRecordData = Readonly<{\n  readonly blocking: false;\n  readonly kind: \"input-rejected\";\n  readonly path: string;\n  readonly reason: \"unsupported-file-type\";\n}>;\n\n/** Markdown Link 发布的 link 或 input-rejection Record data。 */\nexport type MarkdownLinkValidationRecordData =\n  | MarkdownLinkFindingRecordData\n  | MarkdownLinkInputRejectedRecordData;\n\nexport interface MarkdownLinkRecordCandidate {\n  readonly data: MarkdownLinkFindingRecordData;\n  readonly id: string;\n}\n\nexport function buildMarkdownLinkRecordCandidate(\n  sourcePath: string,\n  occurrenceIndex: number,\n  occurrence: MarkdownLinkOccurrence,\n  resolution: MarkdownLocalResolution\n): MarkdownLinkRecordCandidate | undefined {\n  if (resolution.kind !== \"finding\") return undefined;\n  return Object.freeze({\n    id: `source:${encodeURIComponent(sourcePath)}:occurrence:${occurrenceIndex + 1}:reason:${resolution.reason}`,\n    data: Object.freeze({\n      reason: resolution.reason,\n      occurrenceKind: occurrence.kind,\n      sourcePath,\n      range: publicRange(occurrence.range),\n      target: resolution.target\n    })\n  });\n}\n\nexport function buildMarkdownInputRejectedRecord(path: string): Readonly<{\n  readonly data: MarkdownLinkInputRejectedRecordData;\n  readonly id: string;\n}> {\n  return Object.freeze({\n    data: Object.freeze({\n      blocking: false,\n      kind: \"input-rejected\",\n      path,\n      reason: \"unsupported-file-type\"\n    }),\n    id: `/input-rejected/${path}`\n  });\n}\n\nfunction publicRange(range: MarkdownSourceRange): MarkdownLinkFindingRecordData[\"range\"] {\n  return Object.freeze({\n    start: Object.freeze({ line: range.start.line, column: range.start.column }),\n    end: Object.freeze({ line: range.end.line, column: range.end.column })\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/resolver-engine.mjs

@@ -0,0 +1,196 @@
+import { opendir } from "node:fs/promises";
+import path from "node:path";
+import { parseMarkdownLinkFacts } from "./markdown-parser.mjs";
+import { directoryTarget, fileTargetDescriptor, outsideProjectRootTarget, projectTarget } from "./target-descriptor.mjs";
+import { probeEndpoint, probeRootContainedPath, readRegularFile } from "./filesystem-probes.mjs";
+import { anchorResolution, finding, isMarkdownPath, isRootRelativePath, isWithinRoot, parseLocalDestination, sameRootRelativePath, sourceUnavailable, toSlashPath, unavailable, valid } from "./local-resolution.mjs";
+export class LinkLocalResolver {
+    #targetReadCount = 0;
+    #canonicalProjectRoot;
+    #maxTargetReads;
+    constructor(canonicalProjectRoot, maxTargetReads) {
+        this.#canonicalProjectRoot = canonicalProjectRoot;
+        this.#maxTargetReads = maxTargetReads;
+    }
+    get targetReadCount() {
+        return this.#targetReadCount;
+    }
+    async readSource(rootRelativePath, maxMarkdownBytes) {
+        if (!isRootRelativePath(this.#canonicalProjectRoot, rootRelativePath)) {
+            return sourceUnavailable();
+        }
+        const sourcePath = path.resolve(this.#canonicalProjectRoot, rootRelativePath);
+        const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, sourcePath);
+        if (rootProbe.kind === "outside" ||
+            rootProbe.kind === "unavailable" ||
+            rootProbe.kind === "missing") {
+            return sourceUnavailable();
+        }
+        const sourceBytes = await readRegularFile(rootProbe.absolutePath, maxMarkdownBytes);
+        if (!sourceBytes.ok) {
+            return sourceBytes.reason === "too-large"
+                ? Object.freeze({ ok: false, reason: "source-too-large" })
+                : sourceUnavailable();
+        }
+        let markdown;
+        try {
+            markdown = new TextDecoder("utf-8", { fatal: true }).decode(sourceBytes.bytes);
+        }
+        catch {
+            return sourceUnavailable();
+        }
+        const parsed = parseMarkdownLinkFacts(markdown);
+        if (!parsed.ok) {
+            return Object.freeze({ ok: false, reason: "markdown-parse-failed" });
+        }
+        return Object.freeze({
+            ok: true,
+            source: Object.freeze({
+                path: toSlashPath(path.relative(this.#canonicalProjectRoot, sourcePath)),
+                facts: parsed.facts
+            })
+        });
+    }
+    async resolve(request) {
+        const destination = parseLocalDestination(request.rawDestination);
+        if (destination === "not-local") {
+            return Object.freeze({ kind: "not-local" });
+        }
+        if (destination === null) {
+            return unavailable("invalid-local-destination");
+        }
+        let targetPath;
+        if (destination.path === "") {
+            targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);
+        }
+        else if (destination.isAbsolute) {
+            targetPath = path.normalize(destination.path);
+        }
+        else {
+            targetPath = path.resolve(this.#canonicalProjectRoot, path.dirname(request.source.path), destination.path);
+        }
+        const isSameDocument = !destination.isAbsolute &&
+            sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);
+        if (isSameDocument) {
+            return this.resolveSameDocument(destination.fragment, request);
+        }
+        const lexicalTargetIsExternal = destination.isAbsolute || !isWithinRoot(this.#canonicalProjectRoot, targetPath);
+        if (lexicalTargetIsExternal) {
+            return this.resolveExternalTarget(targetPath, destination.fragment, request);
+        }
+        return this.resolveRootContainedTarget(targetPath, destination.fragment, request);
+    }
+    async resolveRootContainedTarget(targetPath, fragment, request) {
+        const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);
+        if (rootProbe.kind === "outside") {
+            return this.resolveExternalTarget(targetPath, fragment, request);
+        }
+        if (rootProbe.kind === "unavailable") {
+            return unavailable("target-unavailable");
+        }
+        if (rootProbe.kind === "missing") {
+            if (!this.beginTargetValidation()) {
+                return unavailable("target-read-limit-exceeded");
+            }
+            const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);
+            return request.requireExistingTargets ? finding("missing-target", target) : valid(target);
+        }
+        if (!this.beginTargetValidation()) {
+            return unavailable("target-read-limit-exceeded");
+        }
+        return this.resolveEndpoint(rootProbe.absolutePath, fragment, request, projectTarget(this.#canonicalProjectRoot, targetPath, fragment));
+    }
+    async resolveExternalTarget(targetPath, fragment, request) {
+        if (request.rootExternalTargetMode === "ignore") {
+            return Object.freeze({ kind: "ignored" });
+        }
+        if (request.rootExternalTargetMode === "report") {
+            return finding("target-outside-project-root", outsideProjectRootTarget());
+        }
+        if (!this.beginTargetValidation()) {
+            return unavailable("target-read-limit-exceeded");
+        }
+        return this.resolveEndpoint(targetPath, fragment, request, outsideProjectRootTarget());
+    }
+    async resolveEndpoint(targetPath, fragment, request, target) {
+        const endpoint = await probeEndpoint(targetPath);
+        if (endpoint.kind === "missing") {
+            return request.requireExistingTargets ? finding("missing-target", target) : valid(target);
+        }
+        if (endpoint.kind === "unavailable") {
+            return unavailable("target-unavailable");
+        }
+        if (endpoint.kind === "directory") {
+            return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));
+        }
+        if (endpoint.kind === "unsupported") {
+            return finding("unsupported-target-type", target);
+        }
+        return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));
+    }
+    async resolveFile(targetPath, fragment, request, target) {
+        if (fragment === null || !request.validateCrossDocumentAnchors) {
+            return valid(target);
+        }
+        if (!isMarkdownPath(targetPath)) {
+            return finding("anchor-target-not-markdown", target);
+        }
+        const targetMarkdown = await readRegularFile(targetPath, request.maxMarkdownBytes);
+        if (!targetMarkdown.ok) {
+            return unavailable("target-unavailable");
+        }
+        let decodedTarget;
+        try {
+            decodedTarget = new TextDecoder("utf-8", { fatal: true }).decode(targetMarkdown.bytes);
+        }
+        catch {
+            return unavailable("target-unavailable");
+        }
+        const parsedTarget = parseMarkdownLinkFacts(decodedTarget);
+        if (!parsedTarget.ok) {
+            return unavailable("target-unavailable");
+        }
+        return anchorResolution(parsedTarget.facts.headings, fragment, target);
+    }
+    async resolveDirectory(targetPath, fragment, request, target) {
+        if (fragment !== null) {
+            return finding("anchor-on-directory", target);
+        }
+        if (!request.requireNonEmptyDirectories) {
+            return valid(target);
+        }
+        try {
+            const directory = await opendir(targetPath);
+            try {
+                return (await directory.read()) === null
+                    ? finding("empty-directory", target)
+                    : valid(target);
+            }
+            finally {
+                await directory.close();
+            }
+        }
+        catch {
+            return unavailable("target-unavailable");
+        }
+    }
+    beginTargetValidation() {
+        if (this.#targetReadCount >= this.#maxTargetReads) {
+            return false;
+        }
+        this.#targetReadCount += 1;
+        return true;
+    }
+    resolveSameDocument(fragment, request) {
+        const target = Object.freeze({
+            kind: "same-document",
+            path: request.source.path,
+            fragment
+        });
+        if (fragment === null || !request.validateSameDocumentAnchors) {
+            return valid(target);
+        }
+        return anchorResolution(request.source.facts.headings, fragment, target);
+    }
+}
+//# sourceMappingURL=resolver-engine.mjs.map