npm - @zxyycom/vibe-check - Versions diffs - 0.0.1 → 0.0.2 - Mend

@zxyycom/vibe-check 0.0.1 → 0.0.2

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

Files changed (950) hide show

package/dist/esm/package-checks/markdown-link-validation/parse-facts-cache.mjs ADDED Viewed

@@ -0,0 +1,131 @@
+import { isUtf8 } from "node:buffer";
+import { appendFile, mkdir, readFile } from "node:fs/promises";
+import path from "node:path";
+import { cacheEnvelopeLine, markdownBytesDigest, parseCacheEnvelopeLine } from "./parse-facts-cache-payload.mjs";
+import { parseMarkdownLinkFacts } from "./markdown-parser.mjs";
+const CACHE_FILE_NAME = "markdown-link-parse-facts-v1.jsonl";
+/**
+ * Link-private state for one resolver invocation's parse-facts cache lifecycle.
+ * It restores at most once, collects successful fresh facts by identity, and
+ * publishes at the execution terminal boundary.
+ */
+export class MarkdownLinkParseFactsSession {
+    #cache;
+    #restored = new Map();
+    #dirty = new Map();
+    #initialRead;
+    #canPublish = true;
+    #needsPartialTailIsolation = false;
+    #finalization;
+    constructor(cache) {
+        this.#cache = cache;
+    }
+    async parse(bytes, signal) {
+        if (signal.aborted || !isUtf8(bytes))
+            return undefined;
+        if (!this.#cache.enabled)
+            return parseCurrentMarkdownBytes(bytes, signal);
+        await this.#restoreOnce();
+        if (signal.aborted)
+            return undefined;
+        const identityDigest = markdownBytesDigest(bytes);
+        const cachedFacts = this.#cachedFacts(identityDigest);
+        if (cachedFacts !== undefined)
+            return parsedFacts(cachedFacts);
+        return this.#parseFreshFacts(bytes, identityDigest, signal);
+    }
+    finalize(signal) {
+        this.#finalization ??= this.#publish(signal);
+        return this.#finalization;
+    }
+    #cachedFacts(identityDigest) {
+        return this.#restored.get(identityDigest) ?? this.#dirty.get(identityDigest);
+    }
+    async #parseFreshFacts(bytes, identityDigest, signal) {
+        const parsed = parseCurrentMarkdownBytes(bytes, signal);
+        if (parsed === undefined || !parsed.ok)
+            return parsed;
+        if (signal.aborted)
+            return undefined;
+        this.#dirty.set(identityDigest, parsed.facts);
+        return parsed;
+    }
+    async #restoreOnce() {
+        this.#initialRead ??= this.#restore();
+        await this.#initialRead;
+    }
+    async #restore() {
+        if (!this.#cache.enabled)
+            return;
+        let contents;
+        try {
+            contents = await readFile(cacheFilePath(this.#cache.directory));
+        }
+        catch (error) {
+            if (isMissingFile(error))
+                return;
+            this.#canPublish = false;
+            return;
+        }
+        this.#needsPartialTailIsolation =
+            contents.length > 0 && contents[contents.length - 1] !== "\n".charCodeAt(0);
+        let text;
+        try {
+            text = new TextDecoder("utf-8", { fatal: true }).decode(contents);
+        }
+        catch {
+            this.#canPublish = false;
+            return;
+        }
+        const lastNewline = text.lastIndexOf("\n");
+        if (lastNewline < 0)
+            return;
+        for (const line of text.slice(0, lastNewline).split("\n")) {
+            const restored = parseCacheEnvelopeLine(line);
+            if (restored !== undefined)
+                this.#restored.set(restored.identityDigest, restored.facts);
+        }
+    }
+    async #publish(signal) {
+        if (signal.aborted || !this.#cache.enabled || !this.#canPublish || this.#dirty.size === 0)
+            return;
+        try {
+            await mkdir(this.#cache.directory, { recursive: true });
+            if (signal.aborted)
+                return;
+            const block = `${this.#needsPartialTailIsolation ? "\n" : ""}${[...this.#dirty.entries()]
+                .map(([identityDigest, facts]) => cacheEnvelopeLine(identityDigest, facts))
+                .join("")}`;
+            // appendFile both creates a missing file and appends the invocation's one complete block.
+            await appendFile(cacheFilePath(this.#cache.directory), block);
+        }
+        catch {
+            // Cache publication is best effort and never changes Check settlement.
+        }
+    }
+}
+function parseCurrentMarkdownBytes(bytes, signal) {
+    const markdown = decodeMarkdownBytes(bytes);
+    return markdown === undefined || signal.aborted ? undefined : parseMarkdownLinkFacts(markdown);
+}
+function parsedFacts(facts) {
+    return Object.freeze({ ok: true, facts });
+}
+function decodeMarkdownBytes(bytes) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    }
+    catch {
+        return undefined;
+    }
+}
+function cacheFilePath(directory) {
+    return path.join(directory, CACHE_FILE_NAME);
+}
+function isMissingFile(error) {
+    return (typeof error === "object" &&
+        error !== null &&
+        "code" in error &&
+        error.code === "ENOENT");
+}
+//# sourceMappingURL=parse-facts-cache.mjs.map

package/dist/esm/package-checks/markdown-link-validation/parse-facts-cache.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"parse-facts-cache.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/parse-facts-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { isUtf8 } from \"node:buffer\";\nimport { appendFile, mkdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n cacheEnvelopeLine,\n markdownBytesDigest,\n parseCacheEnvelopeLine\n} from \"./parse-facts-cache-payload.ts\";\nimport {\n parseMarkdownLinkFacts,\n type MarkdownLinkParseResult,\n type ParsedMarkdownLinkFacts\n} from \"./markdown-parser.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nconst CACHE_FILE_NAME = \"markdown-link-parse-facts-v1.jsonl\";\n\n/**\n * Link-private state for one resolver invocation's parse-facts cache lifecycle.\n * It restores at most once, collects successful fresh facts by identity, and\n * publishes at the execution terminal boundary.\n */\nexport class MarkdownLinkParseFactsSession {\n readonly #cache: ResolvedMarkdownLinkValidationOptions[\"cache\"];\n readonly #restored = new Map<string, ParsedMarkdownLinkFacts>();\n readonly #dirty = new Map<string, ParsedMarkdownLinkFacts>();\n #initialRead: Promise<void> | undefined;\n #canPublish = true;\n #needsPartialTailIsolation = false;\n #finalization: Promise<void> | undefined;\n\n constructor(cache: ResolvedMarkdownLinkValidationOptions[\"cache\"]) {\n this.#cache = cache;\n }\n\n async parse(\n bytes: Uint8Array,\n signal: AbortSignal\n ): Promise<MarkdownLinkParseResult | undefined> {\n if (signal.aborted || !isUtf8(bytes)) return undefined;\n if (!this.#cache.enabled) return parseCurrentMarkdownBytes(bytes, signal);\n\n await this.#restoreOnce();\n if (signal.aborted) return undefined;\n const identityDigest = markdownBytesDigest(bytes);\n const cachedFacts = this.#cachedFacts(identityDigest);\n if (cachedFacts !== undefined) return parsedFacts(cachedFacts);\n return this.#parseFreshFacts(bytes, identityDigest, signal);\n }\n\n finalize(signal: AbortSignal): Promise<void> {\n this.#finalization ??= this.#publish(signal);\n return this.#finalization;\n }\n\n #cachedFacts(identityDigest: string): ParsedMarkdownLinkFacts | undefined {\n return this.#restored.get(identityDigest) ?? this.#dirty.get(identityDigest);\n }\n\n async #parseFreshFacts(\n bytes: Uint8Array,\n identityDigest: string,\n signal: AbortSignal\n ): Promise<MarkdownLinkParseResult | undefined> {\n const parsed = parseCurrentMarkdownBytes(bytes, signal);\n if (parsed === undefined || !parsed.ok) return parsed;\n if (signal.aborted) return undefined;\n this.#dirty.set(identityDigest, parsed.facts);\n return parsed;\n }\n\n async #restoreOnce(): Promise<void> {\n this.#initialRead ??= this.#restore();\n await this.#initialRead;\n }\n\n async #restore(): Promise<void> {\n if (!this.#cache.enabled) return;\n let contents: Uint8Array;\n try {\n contents = await readFile(cacheFilePath(this.#cache.directory));\n } catch (error) {\n if (isMissingFile(error)) return;\n this.#canPublish = false;\n return;\n }\n\n this.#needsPartialTailIsolation =\n contents.length > 0 && contents[contents.length - 1] !== \"\\n\".charCodeAt(0);\n let text: string;\n try {\n text = new TextDecoder(\"utf-8\", { fatal: true }).decode(contents);\n } catch {\n this.#canPublish = false;\n return;\n }\n const lastNewline = text.lastIndexOf(\"\\n\");\n if (lastNewline < 0) return;\n for (const line of text.slice(0, lastNewline).split(\"\\n\")) {\n const restored = parseCacheEnvelopeLine(line);\n if (restored !== undefined) this.#restored.set(restored.identityDigest, restored.facts);\n }\n }\n\n async #publish(signal: AbortSignal): Promise<void> {\n if (signal.aborted || !this.#cache.enabled || !this.#canPublish || this.#dirty.size === 0)\n return;\n try {\n await mkdir(this.#cache.directory, { recursive: true });\n if (signal.aborted) return;\n const block = `${this.#needsPartialTailIsolation ? \"\\n\" : \"\"}${[...this.#dirty.entries()]\n .map(([identityDigest, facts]) => cacheEnvelopeLine(identityDigest, facts))\n .join(\"\")}`;\n // appendFile both creates a missing file and appends the invocation's one complete block.\n await appendFile(cacheFilePath(this.#cache.directory), block);\n } catch {\n // Cache publication is best effort and never changes Check settlement.\n }\n }\n}\n\nfunction parseCurrentMarkdownBytes(\n bytes: Uint8Array,\n signal: AbortSignal\n): MarkdownLinkParseResult | undefined {\n const markdown = decodeMarkdownBytes(bytes);\n return markdown === undefined || signal.aborted ? undefined : parseMarkdownLinkFacts(markdown);\n}\n\nfunction parsedFacts(facts: ParsedMarkdownLinkFacts): MarkdownLinkParseResult {\n return Object.freeze({ ok: true as const, facts });\n}\n\nfunction decodeMarkdownBytes(bytes: Uint8Array): string | undefined {\n try {\n return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } catch {\n return undefined;\n }\n}\n\nfunction cacheFilePath(directory: string): string {\n return path.join(directory, CACHE_FILE_NAME);\n}\n\nfunction isMissingFile(error: unknown): boolean {\n return (\n typeof error === \"object\" &&\n error !== null &&\n \"code\" in error &&\n (error as Readonly<{ readonly code?: unknown }>).code === \"ENOENT\"\n );\n}\n"]}

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

@@ -1,57 +1,41 @@
 import { opendir } from "node:fs/promises";
 import path from "node:path";
-import { parseMarkdownLinkFacts } from "./markdown-parser.mjs";
+import { MarkdownLinkParseFactsSession } from "./parse-facts-cache.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";
+import { readRootContainedMarkdownSource } from "./source-reader.mjs";
+import { anchorResolution, finding, isMarkdownPath, isWithinRoot, parseLocalDestination, sameRootRelativePath, unavailable, valid } from "./local-resolution.mjs";
 export class LinkLocalResolver {
     #targetReadCount = 0;
     #canonicalProjectRoot;
+    #parseFactsCache;
     #maxTargetReads;
-    constructor(canonicalProjectRoot, maxTargetReads) {
+    #signal;
+    #targetFactMemo = new Map();
+    constructor(canonicalProjectRoot, maxTargetReads, cache, signal) {
         this.#canonicalProjectRoot = canonicalProjectRoot;
         this.#maxTargetReads = maxTargetReads;
+        this.#parseFactsCache = new MarkdownLinkParseFactsSession(cache);
+        this.#signal = signal;
     }
     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
-            })
+    finalize() {
+        return this.#parseFactsCache.finalize(this.#signal);
+    }
+    readSource(rootRelativePath, maxMarkdownBytes) {
+        return readRootContainedMarkdownSource({
+            canonicalProjectRoot: this.#canonicalProjectRoot,
+            maxMarkdownBytes,
+            parseMarkdownBytes: (bytes) => this.#parseMarkdownBytes(bytes),
+            rootRelativePath,
+            signal: this.#signal
         });
     }
     async resolve(request) {
+        if (this.#signal.aborted)
+            return unavailable("target-unavailable");
         const destination = parseLocalDestination(request.rawDestination);
         if (destination === "not-local") {
             return Object.freeze({ kind: "not-local" });
@@ -98,7 +82,7 @@ export class LinkLocalResolver {
         if (!this.beginTargetValidation()) {
             return unavailable("target-read-limit-exceeded");
         }
-        return this.resolveEndpoint(rootProbe.absolutePath, fragment, request, projectTarget(this.#canonicalProjectRoot, targetPath, fragment));
+        return this.resolveEndpoint(rootProbe.endpoint ?? (await probeEndpoint(rootProbe.absolutePath)), rootProbe.absolutePath, fragment, request, projectTarget(this.#canonicalProjectRoot, targetPath, fragment));
     }
     async resolveExternalTarget(targetPath, fragment, request) {
         if (request.rootExternalTargetMode === "ignore") {
@@ -110,10 +94,9 @@ export class LinkLocalResolver {
         if (!this.beginTargetValidation()) {
             return unavailable("target-read-limit-exceeded");
         }
-        return this.resolveEndpoint(targetPath, fragment, request, outsideProjectRootTarget());
+        return this.resolveEndpoint(await probeEndpoint(targetPath), targetPath, fragment, request, outsideProjectRootTarget());
     }
-    async resolveEndpoint(targetPath, fragment, request, target) {
-        const endpoint = await probeEndpoint(targetPath);
+    async resolveEndpoint(endpoint, targetPath, fragment, request, target) {
         if (endpoint.kind === "missing") {
             return request.requireExistingTargets ? finding("missing-target", target) : valid(target);
         }
@@ -135,24 +118,14 @@ export class LinkLocalResolver {
         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);
+        const facts = await this.#targetFacts(targetPath, request.maxMarkdownBytes);
+        return facts === undefined
+            ? unavailable("target-unavailable")
+            : anchorResolution(facts.headings, fragment, target);
     }
     async resolveDirectory(targetPath, fragment, request, target) {
+        if (this.#signal.aborted)
+            return unavailable("target-unavailable");
         if (fragment !== null) {
             return finding("anchor-on-directory", target);
         }
@@ -181,6 +154,34 @@ export class LinkLocalResolver {
         this.#targetReadCount += 1;
         return true;
     }
+    async #targetFacts(targetPath, maxMarkdownBytes) {
+        if (this.#signal.aborted)
+            return undefined;
+        const key = JSON.stringify([targetPath, maxMarkdownBytes]);
+        const existing = this.#targetFactMemo.get(key);
+        if (existing !== undefined)
+            return existing;
+        const pending = this.#readTargetFacts(targetPath, maxMarkdownBytes);
+        this.#targetFactMemo.set(key, pending);
+        const facts = await pending;
+        if (facts === undefined && this.#targetFactMemo.get(key) === pending) {
+            this.#targetFactMemo.delete(key);
+        }
+        return facts;
+    }
+    async #readTargetFacts(targetPath, maxMarkdownBytes) {
+        const targetMarkdown = await readRegularFile(targetPath, maxMarkdownBytes);
+        if (!targetMarkdown.ok || this.#signal.aborted)
+            return undefined;
+        const parsed = await this.#parseMarkdownBytes(targetMarkdown.bytes);
+        return this.#signal.aborted || parsed === undefined || !parsed.ok ? undefined : parsed.facts;
+    }
+    async #parseMarkdownBytes(bytes) {
+        if (this.#signal.aborted)
+            return undefined;
+        const parsed = await this.#parseFactsCache.parse(bytes, this.#signal);
+        return this.#signal.aborted ? undefined : parsed;
+    }
     resolveSameDocument(fragment, request) {
         const target = Object.freeze({
             kind: "same-document",

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

	@@ -1 +1 @@
1	- {"version":3,"file":"resolver-engine.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/resolver-engine.ts"],"names":[],"mappings":"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","sourcesContent":["import { opendir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport { parseMarkdownLinkFacts } from \"./markdown-parser.ts\";\nimport {\n directoryTarget,\n fileTargetDescriptor,\n outsideProjectRootTarget,\n projectTarget\n} from \"./target-descriptor.ts\";\nimport { probeEndpoint, probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isRootRelativePath,\n isWithinRoot,\n parseLocalDestination,\n sameRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n unavailable,\n valid,\n type MarkdownLocalResolution,\n type MarkdownLocalResolutionRequest,\n type MarkdownLocalResolver,\n type MarkdownSafeTargetDescriptor,\n type MarkdownSourceReadResult\n} from \"./local-resolution.ts\";\n\nexport class LinkLocalResolver implements MarkdownLocalResolver {\n #targetReadCount = 0;\n readonly #canonicalProjectRoot: string;\n readonly #maxTargetReads: number;\n\n constructor(canonicalProjectRoot: string, maxTargetReads: number) {\n this.#canonicalProjectRoot = canonicalProjectRoot;\n this.#maxTargetReads = maxTargetReads;\n }\n\n get targetReadCount(): number {\n return this.#targetReadCount;\n }\n\n async readSource(\n rootRelativePath: string,\n maxMarkdownBytes: number\n ): Promise<MarkdownSourceReadResult> {\n if (!isRootRelativePath(this.#canonicalProjectRoot, rootRelativePath)) {\n return sourceUnavailable();\n }\n\n const sourcePath = path.resolve(this.#canonicalProjectRoot, rootRelativePath);\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, sourcePath);\n if (\n rootProbe.kind === \"outside\" \|\|\n rootProbe.kind === \"unavailable\" \|\|\n rootProbe.kind === \"missing\"\n ) {\n return sourceUnavailable();\n }\n\n const sourceBytes = await readRegularFile(rootProbe.absolutePath, maxMarkdownBytes);\n if (!sourceBytes.ok) {\n return sourceBytes.reason === \"too-large\"\n ? Object.freeze({ ok: false as const, reason: \"source-too-large\" as const })\n : sourceUnavailable();\n }\n\n let markdown: string;\n try {\n markdown = new TextDecoder(\"utf-8\", { fatal: true }).decode(sourceBytes.bytes);\n } catch {\n return sourceUnavailable();\n }\n\n const parsed = parseMarkdownLinkFacts(markdown);\n if (!parsed.ok) {\n return Object.freeze({ ok: false as const, reason: \"markdown-parse-failed\" as const });\n }\n\n return Object.freeze({\n ok: true as const,\n source: Object.freeze({\n path: toSlashPath(path.relative(this.#canonicalProjectRoot, sourcePath)),\n facts: parsed.facts\n })\n });\n }\n\n async resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution> {\n const destination = parseLocalDestination(request.rawDestination);\n if (destination === \"not-local\") {\n return Object.freeze({ kind: \"not-local\" as const });\n }\n if (destination === null) {\n return unavailable(\"invalid-local-destination\");\n }\n\n let targetPath: string;\n if (destination.path === \"\") {\n targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);\n } else if (destination.isAbsolute) {\n targetPath = path.normalize(destination.path);\n } else {\n targetPath = path.resolve(\n this.#canonicalProjectRoot,\n path.dirname(request.source.path),\n destination.path\n );\n }\n const isSameDocument =\n !destination.isAbsolute &&\n sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);\n if (isSameDocument) {\n return this.resolveSameDocument(destination.fragment, request);\n }\n const lexicalTargetIsExternal =\n destination.isAbsolute \|\| !isWithinRoot(this.#canonicalProjectRoot, targetPath);\n\n if (lexicalTargetIsExternal) {\n return this.resolveExternalTarget(targetPath, destination.fragment, request);\n }\n\n return this.resolveRootContainedTarget(targetPath, destination.fragment, request);\n }\n\n async resolveRootContainedTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);\n if (rootProbe.kind === \"outside\") {\n return this.resolveExternalTarget(targetPath, fragment, request);\n }\n if (rootProbe.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (rootProbe.kind === \"missing\") {\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n rootProbe.absolutePath,\n fragment,\n request,\n projectTarget(this.#canonicalProjectRoot, targetPath, fragment)\n );\n }\n\n async resolveExternalTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n if (request.rootExternalTargetMode === \"ignore\") {\n return Object.freeze({ kind: \"ignored\" as const });\n }\n if (request.rootExternalTargetMode === \"report\") {\n return finding(\"target-outside-project-root\", outsideProjectRootTarget());\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(targetPath, fragment, request, outsideProjectRootTarget());\n }\n\n async resolveEndpoint(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n const endpoint = await probeEndpoint(targetPath);\n if (endpoint.kind === \"missing\") {\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (endpoint.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (endpoint.kind === \"directory\") {\n return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));\n }\n if (endpoint.kind === \"unsupported\") {\n return finding(\"unsupported-target-type\", target);\n }\n\n return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));\n }\n\n async resolveFile(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment === null \|\| !request.validateCrossDocumentAnchors) {\n return valid(target);\n }\n if (!isMarkdownPath(targetPath)) {\n return finding(\"anchor-target-not-markdown\", target);\n }\n\n const targetMarkdown = await readRegularFile(targetPath, request.maxMarkdownBytes);\n if (!targetMarkdown.ok) {\n return unavailable(\"target-unavailable\");\n }\n let decodedTarget: string;\n try {\n decodedTarget = new TextDecoder(\"utf-8\", { fatal: true }).decode(targetMarkdown.bytes);\n } catch {\n return unavailable(\"target-unavailable\");\n }\n const parsedTarget = parseMarkdownLinkFacts(decodedTarget);\n if (!parsedTarget.ok) {\n return unavailable(\"target-unavailable\");\n }\n return anchorResolution(parsedTarget.facts.headings, fragment, target);\n }\n\n async resolveDirectory(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment !== null) {\n return finding(\"anchor-on-directory\", target);\n }\n if (!request.requireNonEmptyDirectories) {\n return valid(target);\n }\n try {\n const directory = await opendir(targetPath);\n try {\n return (await directory.read()) === null\n ? finding(\"empty-directory\", target)\n : valid(target);\n } finally {\n await directory.close();\n }\n } catch {\n return unavailable(\"target-unavailable\");\n }\n }\n\n beginTargetValidation(): boolean {\n if (this.#targetReadCount >= this.#maxTargetReads) {\n return false;\n }\n this.#targetReadCount += 1;\n return true;\n }\n\n resolveSameDocument(\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): MarkdownLocalResolution {\n const target = Object.freeze({\n kind: \"same-document\" as const,\n path: request.source.path,\n fragment\n });\n if (fragment === null \|\| !request.validateSameDocumentAnchors) {\n return valid(target);\n }\n return anchorResolution(request.source.facts.headings, fragment, target);\n }\n}\n"]}
1	+ {"version":3,"file":"resolver-engine.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/resolver-engine.ts"],"names":[],"mappings":"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","sourcesContent":["import { opendir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport type { MarkdownLinkParseResult, ParsedMarkdownLinkFacts } from \"./markdown-parser.ts\";\nimport { MarkdownLinkParseFactsSession } from \"./parse-facts-cache.ts\";\nimport {\n directoryTarget,\n fileTargetDescriptor,\n outsideProjectRootTarget,\n projectTarget\n} from \"./target-descriptor.ts\";\nimport { probeEndpoint, probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport { readRootContainedMarkdownSource } from \"./source-reader.ts\";\nimport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isWithinRoot,\n parseLocalDestination,\n sameRootRelativePath,\n unavailable,\n valid,\n type MarkdownLocalResolution,\n type MarkdownLocalResolutionRequest,\n type MarkdownLocalResolver,\n type MarkdownSafeTargetDescriptor,\n type EndpointProbe\n} from \"./local-resolution.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nexport class LinkLocalResolver implements MarkdownLocalResolver {\n #targetReadCount = 0;\n readonly #canonicalProjectRoot: string;\n readonly #parseFactsCache: MarkdownLinkParseFactsSession;\n readonly #maxTargetReads: number;\n readonly #signal: AbortSignal;\n readonly #targetFactMemo = new Map<string, Promise<ParsedMarkdownLinkFacts \| undefined>>();\n\n constructor(\n canonicalProjectRoot: string,\n maxTargetReads: number,\n cache: ResolvedMarkdownLinkValidationOptions[\"cache\"],\n signal: AbortSignal\n ) {\n this.#canonicalProjectRoot = canonicalProjectRoot;\n this.#maxTargetReads = maxTargetReads;\n this.#parseFactsCache = new MarkdownLinkParseFactsSession(cache);\n this.#signal = signal;\n }\n\n get targetReadCount(): number {\n return this.#targetReadCount;\n }\n\n finalize(): Promise<void> {\n return this.#parseFactsCache.finalize(this.#signal);\n }\n\n readSource(rootRelativePath: string, maxMarkdownBytes: number) {\n return readRootContainedMarkdownSource({\n canonicalProjectRoot: this.#canonicalProjectRoot,\n maxMarkdownBytes,\n parseMarkdownBytes: (bytes) => this.#parseMarkdownBytes(bytes),\n rootRelativePath,\n signal: this.#signal\n });\n }\n\n async resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution> {\n if (this.#signal.aborted) return unavailable(\"target-unavailable\");\n const destination = parseLocalDestination(request.rawDestination);\n if (destination === \"not-local\") {\n return Object.freeze({ kind: \"not-local\" as const });\n }\n if (destination === null) {\n return unavailable(\"invalid-local-destination\");\n }\n\n let targetPath: string;\n if (destination.path === \"\") {\n targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);\n } else if (destination.isAbsolute) {\n targetPath = path.normalize(destination.path);\n } else {\n targetPath = path.resolve(\n this.#canonicalProjectRoot,\n path.dirname(request.source.path),\n destination.path\n );\n }\n const isSameDocument =\n !destination.isAbsolute &&\n sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);\n if (isSameDocument) {\n return this.resolveSameDocument(destination.fragment, request);\n }\n const lexicalTargetIsExternal =\n destination.isAbsolute \|\| !isWithinRoot(this.#canonicalProjectRoot, targetPath);\n\n if (lexicalTargetIsExternal) {\n return this.resolveExternalTarget(targetPath, destination.fragment, request);\n }\n\n return this.resolveRootContainedTarget(targetPath, destination.fragment, request);\n }\n\n async resolveRootContainedTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);\n if (rootProbe.kind === \"outside\") {\n return this.resolveExternalTarget(targetPath, fragment, request);\n }\n if (rootProbe.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (rootProbe.kind === \"missing\") {\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n rootProbe.endpoint ?? (await probeEndpoint(rootProbe.absolutePath)),\n rootProbe.absolutePath,\n fragment,\n request,\n projectTarget(this.#canonicalProjectRoot, targetPath, fragment)\n );\n }\n\n async resolveExternalTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n if (request.rootExternalTargetMode === \"ignore\") {\n return Object.freeze({ kind: \"ignored\" as const });\n }\n if (request.rootExternalTargetMode === \"report\") {\n return finding(\"target-outside-project-root\", outsideProjectRootTarget());\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n await probeEndpoint(targetPath),\n targetPath,\n fragment,\n request,\n outsideProjectRootTarget()\n );\n }\n\n async resolveEndpoint(\n endpoint: EndpointProbe,\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (endpoint.kind === \"missing\") {\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (endpoint.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (endpoint.kind === \"directory\") {\n return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));\n }\n if (endpoint.kind === \"unsupported\") {\n return finding(\"unsupported-target-type\", target);\n }\n\n return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));\n }\n\n async resolveFile(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment === null \|\| !request.validateCrossDocumentAnchors) {\n return valid(target);\n }\n if (!isMarkdownPath(targetPath)) {\n return finding(\"anchor-target-not-markdown\", target);\n }\n\n const facts = await this.#targetFacts(targetPath, request.maxMarkdownBytes);\n return facts === undefined\n ? unavailable(\"target-unavailable\")\n : anchorResolution(facts.headings, fragment, target);\n }\n\n async resolveDirectory(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (this.#signal.aborted) return unavailable(\"target-unavailable\");\n if (fragment !== null) {\n return finding(\"anchor-on-directory\", target);\n }\n if (!request.requireNonEmptyDirectories) {\n return valid(target);\n }\n try {\n const directory = await opendir(targetPath);\n try {\n return (await directory.read()) === null\n ? finding(\"empty-directory\", target)\n : valid(target);\n } finally {\n await directory.close();\n }\n } catch {\n return unavailable(\"target-unavailable\");\n }\n }\n\n beginTargetValidation(): boolean {\n if (this.#targetReadCount >= this.#maxTargetReads) {\n return false;\n }\n this.#targetReadCount += 1;\n return true;\n }\n\n async #targetFacts(\n targetPath: string,\n maxMarkdownBytes: number\n ): Promise<ParsedMarkdownLinkFacts \| undefined> {\n if (this.#signal.aborted) return undefined;\n const key = JSON.stringify([targetPath, maxMarkdownBytes]);\n const existing = this.#targetFactMemo.get(key);\n if (existing !== undefined) return existing;\n\n const pending = this.#readTargetFacts(targetPath, maxMarkdownBytes);\n this.#targetFactMemo.set(key, pending);\n const facts = await pending;\n if (facts === undefined && this.#targetFactMemo.get(key) === pending) {\n this.#targetFactMemo.delete(key);\n }\n return facts;\n }\n\n async #readTargetFacts(\n targetPath: string,\n maxMarkdownBytes: number\n ): Promise<ParsedMarkdownLinkFacts \| undefined> {\n const targetMarkdown = await readRegularFile(targetPath, maxMarkdownBytes);\n if (!targetMarkdown.ok \|\| this.#signal.aborted) return undefined;\n const parsed = await this.#parseMarkdownBytes(targetMarkdown.bytes);\n return this.#signal.aborted \|\| parsed === undefined \|\| !parsed.ok ? undefined : parsed.facts;\n }\n\n async #parseMarkdownBytes(bytes: Uint8Array): Promise<MarkdownLinkParseResult \| undefined> {\n if (this.#signal.aborted) return undefined;\n const parsed = await this.#parseFactsCache.parse(bytes, this.#signal);\n return this.#signal.aborted ? undefined : parsed;\n }\n\n resolveSameDocument(\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): MarkdownLocalResolution {\n const target = Object.freeze({\n kind: \"same-document\" as const,\n path: request.source.path,\n fragment\n });\n if (fragment === null \|\| !request.validateSameDocumentAnchors) {\n return valid(target);\n }\n return anchorResolution(request.source.facts.headings, fragment, target);\n }\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/source-reader.mjs ADDED Viewed

@@ -0,0 +1,54 @@
+import path from "node:path";
+import { probeRootContainedPath, readRegularFile } from "./filesystem-probes.mjs";
+import { isRootRelativePath, sourceUnavailable, toSlashPath } from "./local-resolution.mjs";
+/** Reads one authorized Markdown source without granting target-resolution behavior. */
+export async function readRootContainedMarkdownSource(request) {
+    const sourcePath = authorizedRootRelativeSourcePath(request);
+    if (sourcePath === undefined)
+        return sourceUnavailable();
+    const sourceRead = await readRootContainedSourceBytes(request, sourcePath);
+    if (sourceRead.kind === "result")
+        return sourceRead.result;
+    return parseRootContainedSourceBytes(request, sourcePath, sourceRead.bytes);
+}
+function authorizedRootRelativeSourcePath(request) {
+    if (request.signal.aborted)
+        return undefined;
+    return isRootRelativePath(request.canonicalProjectRoot, request.rootRelativePath)
+        ? path.resolve(request.canonicalProjectRoot, request.rootRelativePath)
+        : undefined;
+}
+async function readRootContainedSourceBytes(request, sourcePath) {
+    const rootProbe = await probeRootContainedPath(request.canonicalProjectRoot, sourcePath);
+    if (rootProbe.kind === "outside" ||
+        rootProbe.kind === "unavailable" ||
+        rootProbe.kind === "missing") {
+        return Object.freeze({ kind: "result", result: sourceUnavailable() });
+    }
+    const sourceBytes = await readRegularFile(rootProbe.absolutePath, request.maxMarkdownBytes);
+    if (!sourceBytes.ok) {
+        return Object.freeze({
+            kind: "result",
+            result: sourceBytes.reason === "too-large"
+                ? Object.freeze({ ok: false, reason: "source-too-large" })
+                : sourceUnavailable()
+        });
+    }
+    return Object.freeze({ kind: "bytes", bytes: sourceBytes.bytes });
+}
+async function parseRootContainedSourceBytes(request, sourcePath, sourceBytes) {
+    const parsed = await request.parseMarkdownBytes(sourceBytes);
+    if (request.signal.aborted || parsed === undefined)
+        return sourceUnavailable();
+    if (!parsed.ok) {
+        return Object.freeze({ ok: false, reason: "markdown-parse-failed" });
+    }
+    return Object.freeze({
+        ok: true,
+        source: Object.freeze({
+            path: toSlashPath(path.relative(request.canonicalProjectRoot, sourcePath)),
+            facts: parsed.facts
+        })
+    });
+}
+//# sourceMappingURL=source-reader.mjs.map

package/dist/esm/package-checks/markdown-link-validation/source-reader.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"source-reader.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/source-reader.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\n\nimport type { MarkdownLinkParseResult } from \"./markdown-parser.ts\";\nimport { probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport {\n isRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n type MarkdownSourceReadResult\n} from \"./local-resolution.ts\";\n\nexport interface RootContainedMarkdownSourceReadRequest {\n readonly canonicalProjectRoot: string;\n readonly maxMarkdownBytes: number;\n readonly parseMarkdownBytes: (bytes: Uint8Array) => Promise<MarkdownLinkParseResult | undefined>;\n readonly rootRelativePath: string;\n readonly signal: AbortSignal;\n}\n\ntype RootContainedSourceBytesRead =\n | Readonly<{ readonly kind: \"bytes\"; readonly bytes: Uint8Array }>\n | Readonly<{ readonly kind: \"result\"; readonly result: MarkdownSourceReadResult }>;\n\n/** Reads one authorized Markdown source without granting target-resolution behavior. */\nexport async function readRootContainedMarkdownSource(\n request: RootContainedMarkdownSourceReadRequest\n): Promise<MarkdownSourceReadResult> {\n const sourcePath = authorizedRootRelativeSourcePath(request);\n if (sourcePath === undefined) return sourceUnavailable();\n const sourceRead = await readRootContainedSourceBytes(request, sourcePath);\n if (sourceRead.kind === \"result\") return sourceRead.result;\n return parseRootContainedSourceBytes(request, sourcePath, sourceRead.bytes);\n}\n\nfunction authorizedRootRelativeSourcePath(\n request: RootContainedMarkdownSourceReadRequest\n): string | undefined {\n if (request.signal.aborted) return undefined;\n return isRootRelativePath(request.canonicalProjectRoot, request.rootRelativePath)\n ? path.resolve(request.canonicalProjectRoot, request.rootRelativePath)\n : undefined;\n}\n\nasync function readRootContainedSourceBytes(\n request: RootContainedMarkdownSourceReadRequest,\n sourcePath: string\n): Promise<RootContainedSourceBytesRead> {\n const rootProbe = await probeRootContainedPath(request.canonicalProjectRoot, sourcePath);\n if (\n rootProbe.kind === \"outside\" ||\n rootProbe.kind === \"unavailable\" ||\n rootProbe.kind === \"missing\"\n ) {\n return Object.freeze({ kind: \"result\" as const, result: sourceUnavailable() });\n }\n const sourceBytes = await readRegularFile(rootProbe.absolutePath, request.maxMarkdownBytes);\n if (!sourceBytes.ok) {\n return Object.freeze({\n kind: \"result\" as const,\n result:\n sourceBytes.reason === \"too-large\"\n ? Object.freeze({ ok: false as const, reason: \"source-too-large\" as const })\n : sourceUnavailable()\n });\n }\n return Object.freeze({ kind: \"bytes\" as const, bytes: sourceBytes.bytes });\n}\n\nasync function parseRootContainedSourceBytes(\n request: RootContainedMarkdownSourceReadRequest,\n sourcePath: string,\n sourceBytes: Uint8Array\n): Promise<MarkdownSourceReadResult> {\n const parsed = await request.parseMarkdownBytes(sourceBytes);\n if (request.signal.aborted || parsed === undefined) return sourceUnavailable();\n if (!parsed.ok) {\n return Object.freeze({ ok: false as const, reason: \"markdown-parse-failed\" as const });\n }\n return Object.freeze({\n ok: true as const,\n source: Object.freeze({\n path: toSlashPath(path.relative(request.canonicalProjectRoot, sourcePath)),\n facts: parsed.facts\n })\n });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/unavailable-reasons.mjs ADDED Viewed

@@ -0,0 +1,16 @@
+const UNAVAILABLE_MESSAGES = {
+    "invalid-options": "markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.",
+    "project-root-unavailable": "Markdown link validation could not resolve the project root; check that the path exists and is accessible.",
+    "source-unavailable": "A selected Markdown source could not be collected, read, decoded, or contained safely; check the file source and permissions.",
+    "source-too-large": "A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.",
+    "markdown-parse-failed": "A selected Markdown source could not be parsed completely; inspect that document's Markdown syntax and encoding.",
+    "invalid-local-destination": "A local Markdown destination could not be parsed safely; inspect the affected link destination syntax.",
+    "target-unavailable": "A local Markdown target could not be probed or read safely; check the target path, permissions, size, and encoding.",
+    "occurrence-limit-exceeded": "Markdown link validation exceeded maxOccurrences; narrow the source selection or raise the bounded limit.",
+    "target-read-limit-exceeded": "Markdown link validation exceeded maxTargetReads; narrow the source selection or raise the bounded limit.",
+    cancelled: "Markdown link validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate."
+};
+export function markdownLinkUnavailableMessage(reason) {
+    return UNAVAILABLE_MESSAGES[reason];
+}
+//# sourceMappingURL=unavailable-reasons.mjs.map

package/dist/esm/package-checks/markdown-link-validation/unavailable-reasons.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"unavailable-reasons.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/unavailable-reasons.ts"],"names":[],"mappings":"AAcA,MAAM,oBAAoB,GAAsE;IAC9F,iBAAiB,EACf,+IAA+I;IACjJ,0BAA0B,EACxB,4GAA4G;IAC9G,oBAAoB,EAClB,+HAA+H;IACjI,kBAAkB,EAChB,4GAA4G;IAC9G,uBAAuB,EACrB,kHAAkH;IACpH,2BAA2B,EACzB,wGAAwG;IAC1G,oBAAoB,EAClB,qHAAqH;IACvH,2BAA2B,EACzB,2GAA2G;IAC7G,4BAA4B,EAC1B,2GAA2G;IAC7G,SAAS,EACP,mJAAmJ;CACtJ,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAC5C,MAA+C;IAE/C,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC","sourcesContent":["import type {\n MarkdownLocalResolutionReason,\n MarkdownSourceReadFailureReason\n} from \"./local-resolver.ts\";\n\n/** `markdown-link-validation` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type MarkdownLinkValidationUnavailableReason =\n | \"invalid-options\"\n | \"cancelled\"\n | \"occurrence-limit-exceeded\"\n | \"project-root-unavailable\"\n | MarkdownLocalResolutionReason\n | MarkdownSourceReadFailureReason;\n\nconst UNAVAILABLE_MESSAGES: Readonly<Record<MarkdownLinkValidationUnavailableReason, string>> = {\n \"invalid-options\":\n \"markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.\",\n \"project-root-unavailable\":\n \"Markdown link validation could not resolve the project root; check that the path exists and is accessible.\",\n \"source-unavailable\":\n \"A selected Markdown source could not be collected, read, decoded, or contained safely; check the file source and permissions.\",\n \"source-too-large\":\n \"A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.\",\n \"markdown-parse-failed\":\n \"A selected Markdown source could not be parsed completely; inspect that document's Markdown syntax and encoding.\",\n \"invalid-local-destination\":\n \"A local Markdown destination could not be parsed safely; inspect the affected link destination syntax.\",\n \"target-unavailable\":\n \"A local Markdown target could not be probed or read safely; check the target path, permissions, size, and encoding.\",\n \"occurrence-limit-exceeded\":\n \"Markdown link validation exceeded maxOccurrences; narrow the source selection or raise the bounded limit.\",\n \"target-read-limit-exceeded\":\n \"Markdown link validation exceeded maxTargetReads; narrow the source selection or raise the bounded limit.\",\n cancelled:\n \"Markdown link validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.\"\n};\n\nexport function markdownLinkUnavailableMessage(\n reason: MarkdownLinkValidationUnavailableReason\n): string {\n return UNAVAILABLE_MESSAGES[reason];\n}\n"]}

package/dist/esm/package-checks/project-files/collection.mjs CHANGED Viewed

@@ -4,7 +4,7 @@ import { resolve } from "node:path";
 import { matchesAnyConfigGlob } from "./config-glob.mjs";
 import { collectSubmoduleWorktreeFiles } from "./revision-worktree-files.mjs";
 import { errorMessage } from "../host-environment/error-message.mjs";
-import { processFailed } from "../host-environment/process/command.mjs";
+import { processFailed } from "../host-environment/process.mjs";
 import { runGit, splitNulDelimitedGitFileList } from "../host-environment/git.mjs";
 import { toSlashPath } from "../host-environment/path.mjs";
 import { walkFiles } from "../host-environment/filesystem.mjs";

package/dist/esm/package-checks/project-files/collection.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"collection.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/collection.ts"],"names":[],"mappings":"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","sourcesContent":["/** Project-root file discovery and selection helpers. /\n\nimport { lstatSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport { matchesAnyConfigGlob } from \"./config-glob.ts\";\nimport { collectSubmoduleWorktreeFiles } from \"./revision-worktree-files.ts\";\nimport { errorMessage } from \"../host-environment/error-message.ts\";\nimport { processFailed } from \"../host-environment/process/command.ts\";\nimport { runGit, splitNulDelimitedGitFileList } from \"../host-environment/git.ts\";\nimport { toSlashPath } from \"../host-environment/path.ts\";\nimport { walkFiles } from \"../host-environment/filesystem.ts\";\nimport type { ProjectFileSelection, ProjectFileSource } from \"./configuration.ts\";\n\ntype NamedProjectFileSelection = Readonly<{\n readonly id: string;\n readonly selection: ProjectFileSelection;\n}>;\n\nconst CONFIG_GLOB_MAGIC = /[\\\\?[\\]{}()!+@]/u;\n\n/*\n Resolves multiple named file sets while enumerating each distinct candidate source once.\n /\nexport function collectProjectFileSets(\n rootDir: string,\n selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<string, readonly string[]> {\n const bySource = groupSelectionsBySource(selections);\n const selectedFiles = new Map<string, readonly string[]>();\n\n for (const [source, sourceSelections] of bySource) {\n const candidates = collectSourceCandidates(rootDir, source, sourceSelections);\n for (const { id, selection } of sourceSelections) {\n selectedFiles.set(id, Object.freeze(filterProjectFiles(candidates, selection)));\n }\n }\n\n return selectedFiles;\n}\n\nexport function collectProjectFiles(rootDir: string, selection: ProjectFileSelection): string[] {\n return [...requireProjectFileSet(collectProjectFileSets(rootDir, { selection }), \"selection\")];\n}\n\n/* 返回已收集的命名文件集合；缺失表示收集完整性失效，不能解释为空集合。 /\nexport function requireProjectFileSet(\n fileSets: ReadonlyMap<string, readonly string[]>,\n selectionId: string\n): readonly string[] {\n const selectedFiles = fileSets.get(selectionId);\n if (selectedFiles === undefined) {\n throw new Error(`project file collection did not produce selection ${selectionId}`);\n }\n return selectedFiles;\n}\n\nfunction groupSelectionsBySource(\n selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<ProjectFileSource, readonly NamedProjectFileSelection[]> {\n const mutableGroups = new Map<ProjectFileSource, NamedProjectFileSelection[]>();\n const entries = Object.entries(selections).sort(([left], [right]) => compareText(left, right));\n\n for (const [id, selection] of entries) {\n const group = mutableGroups.get(selection.source) ?? [];\n group.push({ id, selection });\n mutableGroups.set(selection.source, group);\n }\n\n return new Map(\n [...mutableGroups].map(([source, group]) => [source, Object.freeze(group)] as const)\n );\n}\n\nfunction collectSourceCandidates(\n rootDir: string,\n source: ProjectFileSource,\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n switch (source) {\n case \"filesystem\":\n return uniqueSorted(\n walkFiles({\n ignoredDirs: commonExcludedDirectoryNames(selections),\n rootDir\n }).map(toSlashPath)\n );\n case \"git-worktree\":\n return collectGitWorktreeCandidates(rootDir, selections);\n default: {\n const unsupportedSource: never = source;\n throw new TypeError(`unsupported project file source: ${String(unsupportedSource)}`);\n }\n }\n}\n\nfunction collectGitWorktreeCandidates(\n rootDir: string,\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n const result = runGit({\n args: [\"ls-files\", \"-z\", \"--cached\", \"--others\", \"--exclude-standard\", \"--\"],\n cwd: rootDir\n });\n if (processFailed(result)) {\n const detail =\n result.stderr.trim() \|\|\n result.error?.message \|\|\n (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);\n throw new Error(`could not enumerate git-worktree files in ${rootDir}: ${detail}`);\n }\n\n const include = uniqueSorted(selections.flatMap(({ selection }) => [...selection.include]));\n return uniqueSorted(\n [\n ...splitNulDelimitedGitFileList(result.stdout),\n ...collectSubmoduleWorktreeFiles({ repository: rootDir, scanInputPaths: include })\n ]\n .map(toSlashPath)\n .filter((filePath) => isGitWorktreeFile({ filePath, rootDir }))\n );\n}\n\nfunction isGitWorktreeFile({\n filePath,\n rootDir\n}: Readonly<{ readonly filePath: string; readonly rootDir: string }>): boolean {\n try {\n const stats = lstatSync(resolve(rootDir, filePath));\n return stats.isFile() \|\| stats.isSymbolicLink();\n } catch (error: unknown) {\n if (missingPath(error)) return false;\n throw new Error(\n `could not inspect git-worktree candidate ${filePath} in ${rootDir}: ${errorMessage(error)}`,\n { cause: error }\n );\n }\n}\n\nfunction missingPath(error: unknown): boolean {\n const code = error instanceof Error && \"code\" in error ? error.code : undefined;\n return code === \"ENOENT\" \|\| code === \"ENOTDIR\";\n}\n\nfunction filterProjectFiles(\n candidates: readonly string[],\n selection: ProjectFileSelection\n): string[] {\n return uniqueSorted(candidates.filter((filePath) => isProjectFile(filePath, selection)));\n}\n\nfunction isProjectFile(filePath: string, selection: ProjectFileSelection): boolean {\n const normalized = toSlashPath(filePath);\n return (\n matchesAnyConfigGlob(normalized, selection.include) &&\n !matchesAnyConfigGlob(normalized, selection.exclude)\n );\n}\n\n/\n Recognizes only whole-directory exclusions with one literal directory segment. The\n * intersection is a traversal optimization; public semantics remain in `isProjectFile`.\n /\nfunction commonExcludedDirectoryNames(\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n let common: Set<string> \| undefined;\n for (const { selection } of selections) {\n const names = new Set(selection.exclude.map(literalExcludedDirectoryName).filter(isString));\n common =\n common === undefined\n ? names\n : new Set([...common].filter((directoryName) => names.has(directoryName)));\n }\n return common === undefined ? [] : [...common].sort();\n}\n\nfunction literalExcludedDirectoryName(configGlob: string): string \| undefined {\n const prefix = \"/\";\n const suffix = \"/*\";\n if (!configGlob.startsWith(prefix) \|\| !configGlob.endsWith(suffix)) return undefined;\n const directoryName = configGlob.slice(prefix.length, -suffix.length);\n if (directoryName.length === 0 \|\| directoryName.includes(\"/\")) return undefined;\n return CONFIG_GLOB_MAGIC.test(directoryName) ? undefined : directoryName;\n}\n\nfunction isString(value: string \| undefined): value is string {\n return value !== undefined;\n}\n\nfunction uniqueSorted(files: readonly string[]): string[] {\n return [...new Set(files)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n if (left > right) return 1;\n return 0;\n}\n"]}
1	+ {"version":3,"file":"collection.mjs","sourceRoot":"","sources":["../../../../src/package-checks/project-files/collection.ts"],"names":[],"mappings":"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","sourcesContent":["/** Project-root file discovery and selection helpers. /\n\nimport { lstatSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport { matchesAnyConfigGlob } from \"./config-glob.ts\";\nimport { collectSubmoduleWorktreeFiles } from \"./revision-worktree-files.ts\";\nimport { errorMessage } from \"../host-environment/error-message.ts\";\nimport { processFailed } from \"../host-environment/process.ts\";\nimport { runGit, splitNulDelimitedGitFileList } from \"../host-environment/git.ts\";\nimport { toSlashPath } from \"../host-environment/path.ts\";\nimport { walkFiles } from \"../host-environment/filesystem.ts\";\nimport type { ProjectFileSelection, ProjectFileSource } from \"./configuration.ts\";\n\ntype NamedProjectFileSelection = Readonly<{\n readonly id: string;\n readonly selection: ProjectFileSelection;\n}>;\n\nconst CONFIG_GLOB_MAGIC = /[\\\\?[\\]{}()!+@]/u;\n\n/*\n Resolves multiple named file sets while enumerating each distinct candidate source once.\n /\nexport function collectProjectFileSets(\n rootDir: string,\n selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<string, readonly string[]> {\n const bySource = groupSelectionsBySource(selections);\n const selectedFiles = new Map<string, readonly string[]>();\n\n for (const [source, sourceSelections] of bySource) {\n const candidates = collectSourceCandidates(rootDir, source, sourceSelections);\n for (const { id, selection } of sourceSelections) {\n selectedFiles.set(id, Object.freeze(filterProjectFiles(candidates, selection)));\n }\n }\n\n return selectedFiles;\n}\n\nexport function collectProjectFiles(rootDir: string, selection: ProjectFileSelection): string[] {\n return [...requireProjectFileSet(collectProjectFileSets(rootDir, { selection }), \"selection\")];\n}\n\n/* 返回已收集的命名文件集合；缺失表示收集完整性失效，不能解释为空集合。 /\nexport function requireProjectFileSet(\n fileSets: ReadonlyMap<string, readonly string[]>,\n selectionId: string\n): readonly string[] {\n const selectedFiles = fileSets.get(selectionId);\n if (selectedFiles === undefined) {\n throw new Error(`project file collection did not produce selection ${selectionId}`);\n }\n return selectedFiles;\n}\n\nfunction groupSelectionsBySource(\n selections: Readonly<Record<string, ProjectFileSelection>>\n): ReadonlyMap<ProjectFileSource, readonly NamedProjectFileSelection[]> {\n const mutableGroups = new Map<ProjectFileSource, NamedProjectFileSelection[]>();\n const entries = Object.entries(selections).sort(([left], [right]) => compareText(left, right));\n\n for (const [id, selection] of entries) {\n const group = mutableGroups.get(selection.source) ?? [];\n group.push({ id, selection });\n mutableGroups.set(selection.source, group);\n }\n\n return new Map(\n [...mutableGroups].map(([source, group]) => [source, Object.freeze(group)] as const)\n );\n}\n\nfunction collectSourceCandidates(\n rootDir: string,\n source: ProjectFileSource,\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n switch (source) {\n case \"filesystem\":\n return uniqueSorted(\n walkFiles({\n ignoredDirs: commonExcludedDirectoryNames(selections),\n rootDir\n }).map(toSlashPath)\n );\n case \"git-worktree\":\n return collectGitWorktreeCandidates(rootDir, selections);\n default: {\n const unsupportedSource: never = source;\n throw new TypeError(`unsupported project file source: ${String(unsupportedSource)}`);\n }\n }\n}\n\nfunction collectGitWorktreeCandidates(\n rootDir: string,\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n const result = runGit({\n args: [\"ls-files\", \"-z\", \"--cached\", \"--others\", \"--exclude-standard\", \"--\"],\n cwd: rootDir\n });\n if (processFailed(result)) {\n const detail =\n result.stderr.trim() \|\|\n result.error?.message \|\|\n (result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`);\n throw new Error(`could not enumerate git-worktree files in ${rootDir}: ${detail}`);\n }\n\n const include = uniqueSorted(selections.flatMap(({ selection }) => [...selection.include]));\n return uniqueSorted(\n [\n ...splitNulDelimitedGitFileList(result.stdout),\n ...collectSubmoduleWorktreeFiles({ repository: rootDir, scanInputPaths: include })\n ]\n .map(toSlashPath)\n .filter((filePath) => isGitWorktreeFile({ filePath, rootDir }))\n );\n}\n\nfunction isGitWorktreeFile({\n filePath,\n rootDir\n}: Readonly<{ readonly filePath: string; readonly rootDir: string }>): boolean {\n try {\n const stats = lstatSync(resolve(rootDir, filePath));\n return stats.isFile() \|\| stats.isSymbolicLink();\n } catch (error: unknown) {\n if (missingPath(error)) return false;\n throw new Error(\n `could not inspect git-worktree candidate ${filePath} in ${rootDir}: ${errorMessage(error)}`,\n { cause: error }\n );\n }\n}\n\nfunction missingPath(error: unknown): boolean {\n const code = error instanceof Error && \"code\" in error ? error.code : undefined;\n return code === \"ENOENT\" \|\| code === \"ENOTDIR\";\n}\n\nfunction filterProjectFiles(\n candidates: readonly string[],\n selection: ProjectFileSelection\n): string[] {\n return uniqueSorted(candidates.filter((filePath) => isProjectFile(filePath, selection)));\n}\n\nfunction isProjectFile(filePath: string, selection: ProjectFileSelection): boolean {\n const normalized = toSlashPath(filePath);\n return (\n matchesAnyConfigGlob(normalized, selection.include) &&\n !matchesAnyConfigGlob(normalized, selection.exclude)\n );\n}\n\n/\n Recognizes only whole-directory exclusions with one literal directory segment. The\n * intersection is a traversal optimization; public semantics remain in `isProjectFile`.\n /\nfunction commonExcludedDirectoryNames(\n selections: readonly NamedProjectFileSelection[]\n): readonly string[] {\n let common: Set<string> \| undefined;\n for (const { selection } of selections) {\n const names = new Set(selection.exclude.map(literalExcludedDirectoryName).filter(isString));\n common =\n common === undefined\n ? names\n : new Set([...common].filter((directoryName) => names.has(directoryName)));\n }\n return common === undefined ? [] : [...common].sort();\n}\n\nfunction literalExcludedDirectoryName(configGlob: string): string \| undefined {\n const prefix = \"/\";\n const suffix = \"/*\";\n if (!configGlob.startsWith(prefix) \|\| !configGlob.endsWith(suffix)) return undefined;\n const directoryName = configGlob.slice(prefix.length, -suffix.length);\n if (directoryName.length === 0 \|\| directoryName.includes(\"/\")) return undefined;\n return CONFIG_GLOB_MAGIC.test(directoryName) ? undefined : directoryName;\n}\n\nfunction isString(value: string \| undefined): value is string {\n return value !== undefined;\n}\n\nfunction uniqueSorted(files: readonly string[]): string[] {\n return [...new Set(files)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n if (left > right) return 1;\n return 0;\n}\n"]}

package/dist/esm/package-checks/project-files/configuration.mjs CHANGED Viewed

@@ -1,4 +1,4 @@
-import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
 export const PROJECT_FILE_SOURCES = Object.freeze(["filesystem", "git-worktree"]);
 /**
  * Package-provided Checks 共用的通用文件选择基线。
@@ -62,7 +62,7 @@ export function snapshotProjectFileSelection(selection) {
     });
 }
 export function validProjectFileSelection(value) {
-    const selection = exactRecord(value, ["exclude", "include", "source"]);
+    const selection = snapshotExactClosedRecord(value, ["exclude", "include", "source"]);
     return (selection !== undefined &&
         validStringArray(selection.exclude) &&
         validStringArray(selection.include) &&
@@ -86,14 +86,6 @@ function validStringArray(value) {
 function isString(value) {
     return typeof value === "string";
 }
-function exactRecord(value, keys) {
-    const record = snapshotClosedRecord(value);
-    return record !== undefined &&
-        Object.keys(record).length === keys.length &&
-        keys.every((key) => Object.hasOwn(record, key))
-        ? record
-        : undefined;
-}
 function deepFreeze(value) {
     if (typeof value !== "object" || value === null || Object.isFrozen(value))
         return value;