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

@zxyycom/vibe-check 0.0.1 → 0.0.3

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 (1190) hide show

package/dist/esm/package-checks/markdown-link-validation/filesystem-probes.mjs CHANGED Viewed

@@ -6,71 +6,88 @@ export async function probeRootContainedPath(canonicalProjectRoot, candidatePath
     if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {
         return Object.freeze({ kind: "outside" });
     }
-    let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);
-    let currentPath = canonicalProjectRoot;
-    let symlinkHops = 0;
-    while (pendingSegments.length > 0) {
-        const segment = pendingSegments.shift();
-        if (segment === undefined) {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        const nextPath = path.join(currentPath, segment);
-        let status;
-        try {
-            status = await lstat(nextPath);
-        }
-        catch (error) {
-            if (isNotFound(error)) {
-                return Object.freeze({ kind: "missing", absolutePath: nextPath });
-            }
-            return Object.freeze({ kind: "unavailable" });
-        }
-        if (!status.isSymbolicLink()) {
-            currentPath = nextPath;
-            continue;
-        }
-        if (symlinkHops >= 40) {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        symlinkHops += 1;
-        let linkDestination;
-        try {
-            linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));
-        }
-        catch {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {
-            return Object.freeze({ kind: "outside" });
-        }
-        pendingSegments = [
-            ...relativeSegments(canonicalProjectRoot, linkDestination),
-            ...pendingSegments
-        ];
-        currentPath = canonicalProjectRoot;
+    let state = {
+        currentPath: canonicalProjectRoot,
+        pendingSegments: relativeSegments(canonicalProjectRoot, candidatePath),
+        symlinkHops: 0
+    };
+    while (state.pendingSegments.length > 0) {
+        const advance = await advanceRootContainedPathProbe(canonicalProjectRoot, state);
+        if (!isRootContainedPathProbeState(advance))
+            return advance;
+        state = advance;
     }
-    return Object.freeze({ kind: "contained", absolutePath: currentPath });
+    return Object.freeze({ kind: "contained", absolutePath: state.currentPath });
 }
-export async function probeEndpoint(targetPath) {
-    let status;
+function isRootContainedPathProbeState(value) {
+    return "currentPath" in value;
+}
+async function advanceRootContainedPathProbe(canonicalProjectRoot, state) {
+    const [segment, ...remainingSegments] = state.pendingSegments;
+    if (segment === undefined)
+        return Object.freeze({ kind: "unavailable" });
+    const nextPath = path.join(state.currentPath, segment);
+    const pathStatus = await rootContainedPathStatus(nextPath);
+    if (pathStatus.kind !== "status")
+        return pathStatus;
+    if (!pathStatus.status.isSymbolicLink()) {
+        return remainingSegments.length === 0
+            ? Object.freeze({
+                kind: "contained",
+                absolutePath: nextPath,
+                endpoint: endpointFromStatus(pathStatus.status)
+            })
+            : Object.freeze({
+                currentPath: nextPath,
+                pendingSegments: remainingSegments,
+                symlinkHops: state.symlinkHops
+            });
+    }
+    return advanceThroughContainedSymlink(canonicalProjectRoot, nextPath, remainingSegments, state.symlinkHops);
+}
+async function rootContainedPathStatus(nextPath) {
     try {
-        status = await lstat(targetPath);
+        return Object.freeze({ kind: "status", status: await lstat(nextPath) });
     }
     catch (error) {
         return isNotFound(error)
-            ? Object.freeze({ kind: "missing" })
+            ? Object.freeze({ kind: "missing", absolutePath: nextPath })
             : Object.freeze({ kind: "unavailable" });
     }
-    if (status.isSymbolicLink()) {
+}
+async function advanceThroughContainedSymlink(canonicalProjectRoot, linkPath, remainingSegments, symlinkHops) {
+    if (symlinkHops >= 40)
         return Object.freeze({ kind: "unavailable" });
+    let linkDestination;
+    try {
+        linkDestination = path.resolve(path.dirname(linkPath), await readlink(linkPath));
     }
-    if (status.isDirectory()) {
-        return Object.freeze({ kind: "directory" });
+    catch {
+        return Object.freeze({ kind: "unavailable" });
     }
-    if (status.isFile()) {
-        return Object.freeze({ kind: "file" });
+    if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {
+        return Object.freeze({ kind: "outside" });
     }
-    return Object.freeze({ kind: "unsupported" });
+    return Object.freeze({
+        currentPath: canonicalProjectRoot,
+        pendingSegments: [
+            ...relativeSegments(canonicalProjectRoot, linkDestination),
+            ...remainingSegments
+        ],
+        symlinkHops: symlinkHops + 1
+    });
+}
+export async function probeEndpoint(targetPath) {
+    let status;
+    try {
+        status = await lstat(targetPath);
+    }
+    catch (error) {
+        return isNotFound(error)
+            ? Object.freeze({ kind: "missing" })
+            : Object.freeze({ kind: "unavailable" });
+    }
+    return endpointFromStatus(status);
 }
 export async function readRegularFile(filePath, maxBytes) {
     let handle;
@@ -106,4 +123,16 @@ async function readBoundedBytes(handle, maxBytes) {
     }
     return offset > maxBytes ? null : bytes.slice(0, offset);
 }
+function endpointFromStatus(status) {
+    if (status.isSymbolicLink()) {
+        return Object.freeze({ kind: "unavailable" });
+    }
+    if (status.isDirectory()) {
+        return Object.freeze({ kind: "directory" });
+    }
+    if (status.isFile()) {
+        return Object.freeze({ kind: "file" });
+    }
+    return Object.freeze({ kind: "unsupported" });
+}
 //# sourceMappingURL=filesystem-probes.mjs.map

package/dist/esm/package-checks/markdown-link-validation/filesystem-probes.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"filesystem-probes.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/filesystem-probes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAGjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,oBAA4B,EAC5B,aAAqB;IAErB,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,aAAa,CAAC,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,eAAe,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAC5E,IAAI,WAAW,GAAG,oBAAoB,CAAC;IACvC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,MAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YAC7B,WAAW,GAAG,QAAQ,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,WAAW,IAAI,CAAC,CAAC;QACjB,IAAI,eAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,eAAe,CAAC,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,eAAe,GAAG;YAChB,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,eAAe,CAAC;YAC1D,GAAG,eAAe;SACnB,CAAC;QACF,WAAW,GAAG,oBAAoB,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,MAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,QAAgB;IAKhB,IAAI,MAAoD,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,WAAoB,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,OAAO,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,WAAoB,EAAE,CAAC;YACrE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;IAC/E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAwC,EACxC,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,SAAS,KAAK,CAAC;YAAE,MAAM;QAClC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n isNotFound,\n isWithinRoot,\n relativeSegments,\n type EndpointProbe,\n type RootProbe\n} from \"./local-resolution.ts\";\n\nexport async function probeRootContainedPath(\n canonicalProjectRoot: string,\n candidatePath: string\n): Promise<RootProbe> {\n if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);\n let currentPath = canonicalProjectRoot;\n let symlinkHops = 0;\n\n while (pendingSegments.length > 0) {\n const segment = pendingSegments.shift();\n if (segment === undefined) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n const nextPath = path.join(currentPath, segment);\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(nextPath);\n } catch (error: unknown) {\n if (isNotFound(error)) {\n return Object.freeze({ kind: \"missing\" as const, absolutePath: nextPath });\n }\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!status.isSymbolicLink()) {\n currentPath = nextPath;\n continue;\n }\n if (symlinkHops >= 40) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n symlinkHops += 1;\n let linkDestination: string;\n try {\n linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));\n } catch {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n pendingSegments = [\n ...relativeSegments(canonicalProjectRoot, linkDestination),\n ...pendingSegments\n ];\n currentPath = canonicalProjectRoot;\n }\n\n return Object.freeze({ kind: \"contained\" as const, absolutePath: currentPath });\n}\n\nexport async function probeEndpoint(targetPath: string): Promise<EndpointProbe> {\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(targetPath);\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isSymbolicLink()) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isDirectory()) {\n return Object.freeze({ kind: \"directory\" as const });\n }\n if (status.isFile()) {\n return Object.freeze({ kind: \"file\" as const });\n }\n return Object.freeze({ kind: \"unsupported\" as const });\n}\n\nexport async function readRegularFile(\n filePath: string,\n maxBytes: number\n): Promise<\n \| Readonly<{ readonly ok: true; readonly bytes: Uint8Array }>\n \| Readonly<{ readonly ok: false; readonly reason: \"too-large\" \| \"unavailable\" }>\n> {\n let handle: Awaited<ReturnType<typeof open>> \| undefined;\n try {\n handle = await open(filePath, constants.O_RDONLY \| (constants.O_NOFOLLOW ?? 0));\n const status = await handle.stat();\n if (!status.isFile()) {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n }\n if (status.size > maxBytes) {\n return Object.freeze({ ok: false as const, reason: \"too-large\" as const });\n }\n const bytes = await readBoundedBytes(handle, maxBytes);\n return bytes === null\n ? Object.freeze({ ok: false as const, reason: \"too-large\" as const })\n : Object.freeze({ ok: true as const, bytes });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n } finally {\n await handle?.close().catch(() => undefined);\n }\n}\n\nasync function readBoundedBytes(\n handle: Awaited<ReturnType<typeof open>>,\n maxBytes: number\n): Promise<Uint8Array \| null> {\n const bytes = new Uint8Array(maxBytes + 1);\n let offset = 0;\n while (offset < bytes.byteLength) {\n const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);\n if (result.bytesRead === 0) break;\n offset += result.bytesRead;\n }\n return offset > maxBytes ? null : bytes.slice(0, offset);\n}\n"]}
1	+ {"version":3,"file":"filesystem-probes.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/filesystem-probes.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n isNotFound,\n isWithinRoot,\n relativeSegments,\n type ExistingEndpointProbe,\n type EndpointProbe,\n type RootProbe\n} from \"./local-resolution.ts\";\n\ninterface RootContainedPathProbeState {\n readonly currentPath: string;\n readonly pendingSegments: readonly string[];\n readonly symlinkHops: number;\n}\n\ntype RootContainedPathProbeAdvance = RootProbe \| RootContainedPathProbeState;\ntype RootContainedPathStatus =\n \| RootProbe\n \| Readonly<{ readonly kind: \"status\"; readonly status: Awaited<ReturnType<typeof lstat>> }>;\n\nexport async function probeRootContainedPath(\n canonicalProjectRoot: string,\n candidatePath: string\n): Promise<RootProbe> {\n if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n let state: RootContainedPathProbeState = {\n currentPath: canonicalProjectRoot,\n pendingSegments: relativeSegments(canonicalProjectRoot, candidatePath),\n symlinkHops: 0\n };\n\n while (state.pendingSegments.length > 0) {\n const advance = await advanceRootContainedPathProbe(canonicalProjectRoot, state);\n if (!isRootContainedPathProbeState(advance)) return advance;\n state = advance;\n }\n\n return Object.freeze({ kind: \"contained\" as const, absolutePath: state.currentPath });\n}\n\nfunction isRootContainedPathProbeState(\n value: RootContainedPathProbeAdvance\n): value is RootContainedPathProbeState {\n return \"currentPath\" in value;\n}\n\nasync function advanceRootContainedPathProbe(\n canonicalProjectRoot: string,\n state: RootContainedPathProbeState\n): Promise<RootContainedPathProbeAdvance> {\n const [segment, ...remainingSegments] = state.pendingSegments;\n if (segment === undefined) return Object.freeze({ kind: \"unavailable\" as const });\n const nextPath = path.join(state.currentPath, segment);\n const pathStatus = await rootContainedPathStatus(nextPath);\n if (pathStatus.kind !== \"status\") return pathStatus;\n if (!pathStatus.status.isSymbolicLink()) {\n return remainingSegments.length === 0\n ? Object.freeze({\n kind: \"contained\" as const,\n absolutePath: nextPath,\n endpoint: endpointFromStatus(pathStatus.status)\n })\n : Object.freeze({\n currentPath: nextPath,\n pendingSegments: remainingSegments,\n symlinkHops: state.symlinkHops\n });\n }\n return advanceThroughContainedSymlink(\n canonicalProjectRoot,\n nextPath,\n remainingSegments,\n state.symlinkHops\n );\n}\n\nasync function rootContainedPathStatus(nextPath: string): Promise<RootContainedPathStatus> {\n try {\n return Object.freeze({ kind: \"status\" as const, status: await lstat(nextPath) });\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const, absolutePath: nextPath })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n}\n\nasync function advanceThroughContainedSymlink(\n canonicalProjectRoot: string,\n linkPath: string,\n remainingSegments: readonly string[],\n symlinkHops: number\n): Promise<RootContainedPathProbeAdvance> {\n if (symlinkHops >= 40) return Object.freeze({ kind: \"unavailable\" as const });\n let linkDestination: string;\n try {\n linkDestination = path.resolve(path.dirname(linkPath), await readlink(linkPath));\n } catch {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n return Object.freeze({\n currentPath: canonicalProjectRoot,\n pendingSegments: [\n ...relativeSegments(canonicalProjectRoot, linkDestination),\n ...remainingSegments\n ],\n symlinkHops: symlinkHops + 1\n });\n}\n\nexport async function probeEndpoint(targetPath: string): Promise<EndpointProbe> {\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(targetPath);\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n return endpointFromStatus(status);\n}\n\nexport async function readRegularFile(\n filePath: string,\n maxBytes: number\n): Promise<\n \| Readonly<{ readonly ok: true; readonly bytes: Uint8Array }>\n \| Readonly<{ readonly ok: false; readonly reason: \"too-large\" \| \"unavailable\" }>\n> {\n let handle: Awaited<ReturnType<typeof open>> \| undefined;\n try {\n handle = await open(filePath, constants.O_RDONLY \| (constants.O_NOFOLLOW ?? 0));\n const status = await handle.stat();\n if (!status.isFile()) {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n }\n if (status.size > maxBytes) {\n return Object.freeze({ ok: false as const, reason: \"too-large\" as const });\n }\n const bytes = await readBoundedBytes(handle, maxBytes);\n return bytes === null\n ? Object.freeze({ ok: false as const, reason: \"too-large\" as const })\n : Object.freeze({ ok: true as const, bytes });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n } finally {\n await handle?.close().catch(() => undefined);\n }\n}\n\nasync function readBoundedBytes(\n handle: Awaited<ReturnType<typeof open>>,\n maxBytes: number\n): Promise<Uint8Array \| null> {\n const bytes = new Uint8Array(maxBytes + 1);\n let offset = 0;\n while (offset < bytes.byteLength) {\n const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);\n if (result.bytesRead === 0) break;\n offset += result.bytesRead;\n }\n return offset > maxBytes ? null : bytes.slice(0, offset);\n}\n\nfunction endpointFromStatus(status: Awaited<ReturnType<typeof lstat>>): ExistingEndpointProbe {\n if (status.isSymbolicLink()) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isDirectory()) {\n return Object.freeze({ kind: \"directory\" as const });\n }\n if (status.isFile()) {\n return Object.freeze({ kind: \"file\" as const });\n }\n return Object.freeze({ kind: \"unsupported\" as const });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/final-data.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;~~AAWlC~~,gDAAgD;AAChD,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAC/F,wBAAwB,CACzB,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,eAAe,GAAG,eAAe;QACjC,YAAY,GAAG,kBAAkB;QACjC,YAAY,GAAG,kBAAkB,GAAG,eAAe,EACnD,CAAC;QACD,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,eAAe;QACf,eAAe;QACf,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n exactFinalDataRecord,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** `markdown-link-validation` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MarkdownLinkValidationFinalData {\n readonly sourceFileCount: number;\n readonly occurrenceCount: number;\n readonly targetReadCount: number;\n readonly findingCount: number;\n readonly rejectedInputCount: number;\n}\n\n/* 验证计数不变量并脱离一份 canonical final-data object。 */\nexport function parseMarkdownLinkValidationData(data: unknown): MarkdownLinkValidationFinalData {\n const value = exactFinalDataRecord(\n data,\n [\"sourceFileCount\", \"occurrenceCount\", \"targetReadCount\", \"findingCount\", \"rejectedInputCount\"],\n \"markdownLinkValidation\"\n );\n const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);\n const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);\n const findingCount = nonNegativeSafeInteger(value.findingCount);\n const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n if (\n sourceFileCount === undefined \|\|\n occurrenceCount === undefined \|\|\n targetReadCount === undefined \|\|\n findingCount === undefined \|\|\n rejectedInputCount === undefined \|\|\n targetReadCount > occurrenceCount \|\|\n findingCount < rejectedInputCount \|\|\n findingCount - rejectedInputCount > occurrenceCount\n ) {\n throw invalidFinalData(\"markdownLinkValidation\");\n }\n return Object.freeze({\n sourceFileCount,\n occurrenceCount,\n targetReadCount,\n findingCount,\n rejectedInputCount\n });\n}\n"]}
1	+ {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAgBlC,gDAAgD;AAChD,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAC/F,wBAAwB,CACzB,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,eAAe,GAAG,eAAe;QACjC,YAAY,GAAG,kBAAkB;QACjC,YAAY,GAAG,kBAAkB,GAAG,eAAe,EACnD,CAAC;QACD,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,eAAe;QACf,eAAe;QACf,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n exactFinalDataRecord,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** `markdown-link-validation` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MarkdownLinkValidationFinalData {\n /* 已成功读取并完成 Markdown link occurrence 提取的 source 文件数。 /\n readonly sourceFileCount: number;\n /* 从已处理 source 中提取的 semantic link occurrence 数。 /\n readonly occurrenceCount: number;\n /* 进入 direct endpoint validation 的 logical occurrence 数，包括 target memo hit。 /\n readonly targetReadCount: number;\n /* occurrence finding 与 rejected input 的合计数。 /\n readonly findingCount: number;\n /* files policy 已选中、但因不是 `.md`/`.markdown` path 而被拒绝的输入数。 /\n readonly rejectedInputCount: number;\n}\n\n/* 验证计数不变量并脱离一份 canonical final-data object。 */\nexport function parseMarkdownLinkValidationData(data: unknown): MarkdownLinkValidationFinalData {\n const value = exactFinalDataRecord(\n data,\n [\"sourceFileCount\", \"occurrenceCount\", \"targetReadCount\", \"findingCount\", \"rejectedInputCount\"],\n \"markdownLinkValidation\"\n );\n const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);\n const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);\n const findingCount = nonNegativeSafeInteger(value.findingCount);\n const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n if (\n sourceFileCount === undefined \|\|\n occurrenceCount === undefined \|\|\n targetReadCount === undefined \|\|\n findingCount === undefined \|\|\n rejectedInputCount === undefined \|\|\n targetReadCount > occurrenceCount \|\|\n findingCount < rejectedInputCount \|\|\n findingCount - rejectedInputCount > occurrenceCount\n ) {\n throw invalidFinalData(\"markdownLinkValidation\");\n }\n return Object.freeze({\n sourceFileCount,\n occurrenceCount,\n targetReadCount,\n findingCount,\n rejectedInputCount\n });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/finding-messages.mjs ADDED Viewed

@@ -0,0 +1,36 @@
+import { presentCheckFindings } from "../../package-tools/finding-presentation/finding-presentation.mjs";
+const PRESENTED_FINDING_LIMIT = 10;
+/** Projects completed Link findings without copying raw destinations into presentation. */
+export function markdownFindingMessages(candidates, rejectedPaths, blocking) {
+    const findings = [
+        ...candidates.map((candidate) => Object.freeze({ kind: "link", candidate })),
+        ...rejectedPaths.map((path) => Object.freeze({ kind: "input-rejected", path }))
+    ];
+    return presentCheckFindings({
+        findings,
+        limit: PRESENTED_FINDING_LIMIT,
+        message: (finding) => {
+            if (finding.kind === "input-rejected") {
+                return Object.freeze({
+                    code: "finding-detail",
+                    level: "warning",
+                    message: `${finding.path}: selected input is not a supported Markdown source.`
+                });
+            }
+            const { occurrenceKind, range, reason, sourcePath } = finding.candidate.data;
+            return Object.freeze({
+                code: "finding-detail",
+                level: blocking ? "error" : "warning",
+                message: `${sourcePath}:${range.start.line}:${range.start.column} ${occurrenceKind}: ${reason}.`
+            });
+        },
+        omittedMessage: ({ omittedCount, omittedFindings }) => Object.freeze({
+            code: "findings-omitted",
+            level: omittedFindings.some((finding) => finding.kind === "link" && blocking)
+                ? "error"
+                : "warning",
+            message: `${omittedCount} additional Markdown link finding(s) were not shown; inspect this Check's Records for the complete set.`
+        })
+    });
+}
+//# sourceMappingURL=finding-messages.mjs.map

package/dist/esm/package-checks/markdown-link-validation/finding-messages.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/finding-messages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AAGxG,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAMnC,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,UAAkD,EAClD,aAAgC,EAChC,QAAiB;IAEjB,MAAM,QAAQ,GAA+B;QAC3C,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QACrF,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAyB,EAAE,IAAI,EAAE,CAAC,CAAC;KACzF,CAAC;IACF,OAAO,oBAAoB,CAAC;QAC1B,QAAQ;QACR,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,SAAkB;oBACzB,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,sDAAsD;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;YAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,SAAmB;gBAC3D,OAAO,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,KAAK,MAAM,GAAG;aACjG,CAAC,CAAC;QACL,CAAC;QACD,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,CACpD,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC;gBAC3E,CAAC,CAAE,OAAiB;gBACpB,CAAC,CAAE,SAAmB;YACxB,OAAO,EAAE,GAAG,YAAY,yGAAyG;SAClI,CAAC;KACL,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../package-tools/finding-presentation/finding-presentation.ts\";\nimport type { MarkdownLinkRecordCandidate } from \"./records.ts\";\n\nconst PRESENTED_FINDING_LIMIT = 10;\n\ntype PresentedMarkdownFinding =\n | Readonly<{ readonly kind: \"link\"; readonly candidate: MarkdownLinkRecordCandidate }>\n | Readonly<{ readonly kind: \"input-rejected\"; readonly path: string }>;\n\n/** Projects completed Link findings without copying raw destinations into presentation. */\nexport function markdownFindingMessages(\n candidates: readonly MarkdownLinkRecordCandidate[],\n rejectedPaths: readonly string[],\n blocking: boolean\n): readonly CheckMessage[] {\n const findings: PresentedMarkdownFinding[] = [\n ...candidates.map((candidate) => Object.freeze({ kind: \"link\" as const, candidate })),\n ...rejectedPaths.map((path) => Object.freeze({ kind: \"input-rejected\" as const, path }))\n ];\n return presentCheckFindings({\n findings,\n limit: PRESENTED_FINDING_LIMIT,\n message: (finding) => {\n if (finding.kind === \"input-rejected\") {\n return Object.freeze({\n code: \"finding-detail\",\n level: \"warning\" as const,\n message: `${finding.path}: selected input is not a supported Markdown source.`\n });\n }\n const { occurrenceKind, range, reason, sourcePath } = finding.candidate.data;\n return Object.freeze({\n code: \"finding-detail\",\n level: blocking ? (\"error\" as const) : (\"warning\" as const),\n message: `${sourcePath}:${range.start.line}:${range.start.column} ${occurrenceKind}: ${reason}.`\n });\n },\n omittedMessage: ({ omittedCount, omittedFindings }) =>\n Object.freeze({\n code: \"findings-omitted\",\n level: omittedFindings.some((finding) => finding.kind === \"link\" && blocking)\n ? (\"error\" as const)\n : (\"warning\" as const),\n message: `${omittedCount} additional Markdown link finding(s) were not shown; inspect this Check's Records for the complete set.`\n })\n });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/local-resolution.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"local-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\n\nimport type { MarkdownHeading, ParsedMarkdownLinkFacts } from \"./markdown-parser.ts\";\n\ntype RootExternalTargetMode = \"ignore\" \| \"report\" \| \"validate\";\nconst NOT_LOCAL_FILE_URI: unique symbol = Symbol(\"not-local-file-uri\");\n\n/** Markdown local-link finding Record 的稳定 reason。 /\nexport type MarkdownLinkFindingReason =\n \| \"anchor-on-directory\"\n \| \"anchor-target-not-markdown\"\n \| \"empty-directory\"\n \| \"missing-anchor\"\n \| \"missing-target\"\n \| \"target-outside-project-root\"\n \| \"unsupported-target-type\";\n\ntype MarkdownLocalResolutionReason =\n \| \"invalid-local-destination\"\n \| \"target-read-limit-exceeded\"\n \| \"target-unavailable\";\n\ntype MarkdownSourceReadFailureReason =\n \| \"markdown-parse-failed\"\n \| \"source-unavailable\"\n \| \"source-too-large\";\n\ninterface MarkdownLinkSource {\n readonly path: string;\n readonly facts: ParsedMarkdownLinkFacts;\n}\n\ninterface MarkdownLocalResolver {\n readSource(rootRelativePath: string, maxMarkdownBytes: number): Promise<MarkdownSourceReadResult>;\n resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution>;\n readonly targetReadCount: number;\n}\n\ninterface MarkdownLocalResolutionRequest {\n readonly source: MarkdownLinkSource;\n readonly rawDestination: string;\n readonly rootExternalTargetMode: RootExternalTargetMode;\n readonly requireExistingTargets: boolean;\n readonly requireNonEmptyDirectories: boolean;\n readonly validateSameDocumentAnchors: boolean;\n readonly validateCrossDocumentAnchors: boolean;\n readonly maxMarkdownBytes: number;\n}\n\ntype MarkdownLocalResolverCreation =\n \| Readonly<{ readonly ok: true; readonly resolver: MarkdownLocalResolver }>\n \| Readonly<{ readonly ok: false; readonly reason: \"project-root-unavailable\" }>;\n\ntype MarkdownSourceReadResult =\n \| Readonly<{ readonly ok: true; readonly source: MarkdownLinkSource }>\n \| Readonly<{\n readonly ok: false;\n readonly reason: MarkdownSourceReadFailureReason;\n }>;\n\ntype MarkdownLocalResolution =\n \| Readonly<{ readonly kind: \"not-local\" \| \"ignored\" }>\n \| Readonly<{ readonly kind: \"valid\"; readonly target: MarkdownSafeTargetDescriptor }>\n \| Readonly<{\n readonly kind: \"finding\";\n readonly reason: MarkdownLinkFindingReason;\n readonly target: MarkdownSafeTargetDescriptor;\n }>\n \| Readonly<{ readonly kind: \"unavailable\"; readonly reason: MarkdownLocalResolutionReason }>;\n\ntype MarkdownSafeTargetDescriptor =\n \| Readonly<{\n readonly kind: \"same-document\" \| \"project-file\" \| \"project-directory\" \| \"project-path\";\n readonly path: string;\n readonly fragment: string \| null;\n }>\n \| Readonly<{ readonly kind: \"outside-project-root\" }>;\n\ninterface ParsedLocalDestination {\n readonly path: string;\n readonly fragment: string \| null;\n readonly isAbsolute: boolean;\n}\n\ninterface RootContainedPath {\n readonly kind: \"contained\" \| \"missing\";\n readonly absolutePath: string;\n}\n\ntype RootProbe =\n \| RootContainedPath\n \| Readonly<{ readonly kind: \"outside\" }>\n \| Readonly<{ readonly kind: \"unavailable\" }>;\n\ntype EndpointProbe =\n \| Readonly<{ readonly kind: \"missing\" }>\n \| Readonly<{ readonly kind: \"directory\" \| \"file\" \| \"unsupported\" \| \"unavailable\" }>;\n\nexport function parseLocalDestination(\n rawDestination: string\n): ParsedLocalDestination \| \"not-local\" \| null {\n if (rawDestination.startsWith(\"//\") \|\| rawDestination.startsWith(\"\\\\\\\\\")) {\n return \"not-local\";\n }\n if (isHostWindowsDriveAbsolute(rawDestination)) {\n return parsePathAndFragment(rawDestination, false);\n }\n const scheme = /^([A-Za-z][A-Za-z\\d+.-]):/u.exec(rawDestination);\n if (scheme !== null) {\n if (scheme[1]?.toLowerCase() !== \"file\") {\n return \"not-local\";\n }\n return parseFileDestination(rawDestination);\n }\n if (path.sep !== \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(rawDestination)) {\n return \"not-local\";\n }\n return parsePathAndFragment(rawDestination, false);\n}\n\nfunction parseFileDestination(rawDestination: string): ParsedLocalDestination \| \"not-local\" \| null {\n const match = /^file:\\/\\/(\\/.*)$/iu.exec(rawDestination);\n if (match === null) {\n return \"not-local\";\n }\n const uriPathAndFragment = match[1];\n if (uriPathAndFragment === undefined \|\| uriPathAndFragment.startsWith(\"//\")) {\n return \"not-local\";\n }\n if (hasUriQuery(uriPathAndFragment) \|\| containsUnsafeRawFileCharacter(uriPathAndFragment)) {\n return \"not-local\";\n }\n const parsed = parsePathAndFragment(uriPathAndFragment, true);\n if (parsed === null \|\| parsed === \"not-local\") {\n return parsed;\n }\n return Object.freeze({ ...parsed, isAbsolute: true });\n}\n\nfunction parsePathAndFragment(\n rawDestination: string,\n isFileUri: boolean\n): ParsedLocalDestination \| \"not-local\" \| null {\n const hashIndex = rawDestination.indexOf(\"#\");\n const queryIndex = rawDestination.indexOf(\"?\");\n const pathEnd = [hashIndex, queryIndex]\n .filter((index) => index >= 0)\n .reduce((smallest, index) => Math.min(smallest, index), rawDestination.length);\n const rawPath = rawDestination.slice(0, pathEnd);\n const rawFragment = hashIndex >= 0 ? rawDestination.slice(hashIndex + 1) : null;\n const decodedPath = decodeLocalComponent(rawPath);\n const decodedFragment = rawFragment === null ? null : decodeLocalComponent(rawFragment);\n if (decodedPath === null \|\| (decodedFragment === null && rawFragment !== null)) {\n return null;\n }\n const resolvedPath = isFileUri ? hostFileUriPath(decodedPath) : decodedPath;\n if (resolvedPath === null) return null;\n if (resolvedPath === NOT_LOCAL_FILE_URI) return \"not-local\";\n return Object.freeze({\n path: resolvedPath,\n fragment: decodedFragment,\n isAbsolute: isFileUri \|\| path.isAbsolute(resolvedPath)\n });\n}\n\nfunction decodeLocalComponent(rawComponent: string): string \| null {\n if (containsControlCharacter(rawComponent) \|\| /%(?:2f\|5c\|00\|0[0-9a-f]\|7f)/iu.test(rawComponent)) {\n return null;\n }\n try {\n const decoded = decodeURIComponent(rawComponent);\n return containsControlCharacter(decoded) ? null : decoded;\n } catch {\n return null;\n }\n}\n\nfunction isHostWindowsDriveAbsolute(value: string): boolean {\n return path.sep === \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(value);\n}\n\nfunction hostFileUriPath(decodedPath: string): string \| typeof NOT_LOCAL_FILE_URI \| null {\n if (decodedPath.includes(\"\\\\\")) return null;\n if (path.sep === \"\\\\\") {\n if (!/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n return path.normalize(decodedPath.slice(1));\n }\n if (/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n return path.isAbsolute(decodedPath) ? decodedPath : null;\n}\n\nfunction hasUriQuery(uriPathAndFragment: string): boolean {\n const queryIndex = uriPathAndFragment.indexOf(\"?\");\n if (queryIndex < 0) return false;\n const fragmentIndex = uriPathAndFragment.indexOf(\"#\");\n return fragmentIndex < 0 \|\| queryIndex < fragmentIndex;\n}\n\nexport function anchorResolution(\n headings: readonly MarkdownHeading[],\n fragment: string,\n target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n return headings.some((heading) => heading.slug === fragment)\n ? valid(target)\n : finding(\"missing-anchor\", target);\n}\n\nexport function isRootRelativePath(\n canonicalProjectRoot: string,\n rootRelativePath: string\n): boolean {\n return (\n !path.isAbsolute(rootRelativePath) &&\n isWithinRoot(canonicalProjectRoot, path.resolve(canonicalProjectRoot, rootRelativePath))\n );\n}\n\nexport function isWithinRoot(root: string, candidate: string): boolean {\n const relativePath = path.relative(root, candidate);\n return (\n relativePath === \"\" \|\|\n (!relativePath.startsWith(`..${path.sep}`) &&\n relativePath !== \"..\" &&\n !path.isAbsolute(relativePath))\n );\n}\n\nexport function relativeSegments(root: string, candidate: string): string[] {\n const relativePath = path.relative(root, candidate);\n return relativePath === \"\"\n ? []\n : relativePath.split(path.sep).filter((segment) => segment !== \"\");\n}\n\nexport function sameRootRelativePath(\n rootRelativePath: string,\n targetPath: string,\n canonicalProjectRoot: string\n): boolean {\n return toSlashPath(path.relative(canonicalProjectRoot, targetPath)) === rootRelativePath;\n}\n\nexport function isMarkdownPath(targetPath: string): boolean {\n const extension = path.extname(targetPath).toLowerCase();\n return extension === \".md\" \|\| extension === \".markdown\";\n}\n\nexport function toSlashPath(filePath: string): string {\n return filePath.split(path.sep).join(\"/\");\n}\n\nfunction containsUnsafeRawFileCharacter(value: string): boolean {\n return value.includes(\"\\\\\") \|\| containsControlCharacter(value) \|\| /\\s/u.test(value);\n}\n\nfunction containsControlCharacter(value: string): boolean {\n for (const character of value) {\n const codePoint = character.codePointAt(0);\n if (\n codePoint !== undefined &&\n (codePoint <= 0x1f \|\| (codePoint >= 0x7f && codePoint <= 0x9f))\n ) {\n return true;\n }\n }\n return false;\n}\n\nexport function isNotFound(error: unknown): boolean {\n return typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nexport function sourceUnavailable(): MarkdownSourceReadResult {\n return Object.freeze({ ok: false as const, reason: \"source-unavailable\" as const });\n}\n\nexport function valid(target: MarkdownSafeTargetDescriptor): MarkdownLocalResolution {\n return Object.freeze({ kind: \"valid\" as const, target });\n}\n\nexport function finding(\n reason: MarkdownLinkFindingReason,\n target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n return Object.freeze({ kind: \"finding\" as const, reason, target });\n}\n\nexport function unavailable(reason: MarkdownLocalResolutionReason): MarkdownLocalResolution {\n return Object.freeze({ kind: \"unavailable\" as const, reason });\n}\n\nexport type {\n MarkdownLinkSource,\n MarkdownLocalResolution,\n MarkdownLocalResolutionReason,\n MarkdownLocalResolver,\n MarkdownLocalResolverCreation,\n MarkdownLocalResolutionRequest,\n MarkdownSafeTargetDescriptor,\n MarkdownSourceReadResult,\n MarkdownSourceReadFailureReason,\n RootProbe,\n EndpointProbe,\n RootExternalTargetMode\n};\n"]}
1	+ {"version":3,"file":"local-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\n\nimport type { MarkdownHeading, ParsedMarkdownLinkFacts } from \"./markdown-parser.ts\";\n\ntype RootExternalTargetMode = \"ignore\" \| \"report\" \| \"validate\";\nconst NOT_LOCAL_FILE_URI: unique symbol = Symbol(\"not-local-file-uri\");\n\n/** Markdown local-link finding Record 的稳定 reason。 /\nexport type MarkdownLinkFindingReason =\n \| \"anchor-on-directory\"\n \| \"anchor-target-not-markdown\"\n \| \"empty-directory\"\n \| \"missing-anchor\"\n \| \"missing-target\"\n \| \"target-outside-project-root\"\n \| \"unsupported-target-type\";\n\ntype MarkdownLocalResolutionReason =\n \| \"invalid-local-destination\"\n \| \"target-read-limit-exceeded\"\n \| \"target-unavailable\";\n\ntype MarkdownSourceReadFailureReason =\n \| \"markdown-parse-failed\"\n \| \"source-unavailable\"\n \| \"source-too-large\";\n\ninterface MarkdownLinkSource {\n readonly path: string;\n readonly facts: ParsedMarkdownLinkFacts;\n}\n\ninterface MarkdownLocalResolver {\n readSource(rootRelativePath: string, maxMarkdownBytes: number): Promise<MarkdownSourceReadResult>;\n resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution>;\n finalize(): Promise<void>;\n readonly targetReadCount: number;\n}\n\ninterface MarkdownLocalResolutionRequest {\n readonly source: MarkdownLinkSource;\n readonly rawDestination: string;\n readonly rootExternalTargetMode: RootExternalTargetMode;\n readonly requireExistingTargets: boolean;\n readonly requireNonEmptyDirectories: boolean;\n readonly validateSameDocumentAnchors: boolean;\n readonly validateCrossDocumentAnchors: boolean;\n readonly maxMarkdownBytes: number;\n}\n\ntype MarkdownLocalResolverCreation =\n \| Readonly<{ readonly ok: true; readonly resolver: MarkdownLocalResolver }>\n \| Readonly<{ readonly ok: false; readonly reason: \"project-root-unavailable\" }>;\n\ntype MarkdownSourceReadResult =\n \| Readonly<{ readonly ok: true; readonly source: MarkdownLinkSource }>\n \| Readonly<{\n readonly ok: false;\n readonly reason: MarkdownSourceReadFailureReason;\n }>;\n\ntype MarkdownLocalResolution =\n \| Readonly<{ readonly kind: \"not-local\" \| \"ignored\" }>\n \| Readonly<{ readonly kind: \"valid\"; readonly target: MarkdownSafeTargetDescriptor }>\n \| Readonly<{\n readonly kind: \"finding\";\n readonly reason: MarkdownLinkFindingReason;\n readonly target: MarkdownSafeTargetDescriptor;\n }>\n \| Readonly<{ readonly kind: \"unavailable\"; readonly reason: MarkdownLocalResolutionReason }>;\n\ntype MarkdownSafeTargetDescriptor =\n \| Readonly<{\n readonly kind: \"same-document\" \| \"project-file\" \| \"project-directory\" \| \"project-path\";\n readonly path: string;\n readonly fragment: string \| null;\n }>\n \| Readonly<{ readonly kind: \"outside-project-root\" }>;\n\ninterface ParsedLocalDestination {\n readonly path: string;\n readonly fragment: string \| null;\n readonly isAbsolute: boolean;\n}\n\ntype RootProbe =\n \| Readonly<{\n readonly kind: \"contained\";\n readonly absolutePath: string;\n /* The final component observation is present when containment walked it. /\n readonly endpoint?: ExistingEndpointProbe;\n }>\n \| Readonly<{\n readonly kind: \"missing\";\n readonly absolutePath: string;\n }>\n \| Readonly<{ readonly kind: \"outside\" }>\n \| Readonly<{ readonly kind: \"unavailable\" }>;\n\ntype EndpointProbe = Readonly<{ readonly kind: \"missing\" }> \| ExistingEndpointProbe;\n\ntype ExistingEndpointProbe = Readonly<{\n readonly kind: \"directory\" \| \"file\" \| \"unsupported\" \| \"unavailable\";\n}>;\n\nexport function parseLocalDestination(\n rawDestination: string\n): ParsedLocalDestination \| \"not-local\" \| null {\n if (rawDestination.startsWith(\"//\") \|\| rawDestination.startsWith(\"\\\\\\\\\")) {\n return \"not-local\";\n }\n if (isHostWindowsDriveAbsolute(rawDestination)) {\n return parsePathAndFragment(rawDestination, false);\n }\n const scheme = /^([A-Za-z][A-Za-z\\d+.-]):/u.exec(rawDestination);\n if (scheme !== null) {\n if (scheme[1]?.toLowerCase() !== \"file\") {\n return \"not-local\";\n }\n return parseFileDestination(rawDestination);\n }\n if (path.sep !== \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(rawDestination)) {\n return \"not-local\";\n }\n return parsePathAndFragment(rawDestination, false);\n}\n\nfunction parseFileDestination(rawDestination: string): ParsedLocalDestination \| \"not-local\" \| null {\n const match = /^file:\\/\\/(\\/.*)$/iu.exec(rawDestination);\n if (match === null) {\n return \"not-local\";\n }\n const uriPathAndFragment = match[1];\n if (uriPathAndFragment === undefined \|\| uriPathAndFragment.startsWith(\"//\")) {\n return \"not-local\";\n }\n if (hasUriQuery(uriPathAndFragment) \|\| containsUnsafeRawFileCharacter(uriPathAndFragment)) {\n return \"not-local\";\n }\n const parsed = parsePathAndFragment(uriPathAndFragment, true);\n if (parsed === null \|\| parsed === \"not-local\") {\n return parsed;\n }\n return Object.freeze({ ...parsed, isAbsolute: true });\n}\n\nfunction parsePathAndFragment(\n rawDestination: string,\n isFileUri: boolean\n): ParsedLocalDestination \| \"not-local\" \| null {\n const hashIndex = rawDestination.indexOf(\"#\");\n const queryIndex = rawDestination.indexOf(\"?\");\n const pathEnd = [hashIndex, queryIndex]\n .filter((index) => index >= 0)\n .reduce((smallest, index) => Math.min(smallest, index), rawDestination.length);\n const rawPath = rawDestination.slice(0, pathEnd);\n const rawFragment = hashIndex >= 0 ? rawDestination.slice(hashIndex + 1) : null;\n const decodedPath = decodeLocalComponent(rawPath);\n const decodedFragment = rawFragment === null ? null : decodeLocalComponent(rawFragment);\n if (decodedPath === null \|\| (decodedFragment === null && rawFragment !== null)) {\n return null;\n }\n const resolvedPath = isFileUri ? hostFileUriPath(decodedPath) : decodedPath;\n if (resolvedPath === null) return null;\n if (resolvedPath === NOT_LOCAL_FILE_URI) return \"not-local\";\n return Object.freeze({\n path: resolvedPath,\n fragment: decodedFragment,\n isAbsolute: isFileUri \|\| path.isAbsolute(resolvedPath)\n });\n}\n\nfunction decodeLocalComponent(rawComponent: string): string \| null {\n if (containsControlCharacter(rawComponent) \|\| /%(?:2f\|5c\|00\|0[0-9a-f]\|7f)/iu.test(rawComponent)) {\n return null;\n }\n try {\n const decoded = decodeURIComponent(rawComponent);\n return containsControlCharacter(decoded) ? null : decoded;\n } catch {\n return null;\n }\n}\n\nfunction isHostWindowsDriveAbsolute(value: string): boolean {\n return path.sep === \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(value);\n}\n\nfunction hostFileUriPath(decodedPath: string): string \| typeof NOT_LOCAL_FILE_URI \| null {\n if (decodedPath.includes(\"\\\\\")) return null;\n if (path.sep === \"\\\\\") {\n if (!/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n return path.normalize(decodedPath.slice(1));\n }\n if (/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n return path.isAbsolute(decodedPath) ? decodedPath : null;\n}\n\nfunction hasUriQuery(uriPathAndFragment: string): boolean {\n const queryIndex = uriPathAndFragment.indexOf(\"?\");\n if (queryIndex < 0) return false;\n const fragmentIndex = uriPathAndFragment.indexOf(\"#\");\n return fragmentIndex < 0 \|\| queryIndex < fragmentIndex;\n}\n\nexport function anchorResolution(\n headings: readonly MarkdownHeading[],\n fragment: string,\n target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n return headings.some((heading) => heading.slug === fragment)\n ? valid(target)\n : finding(\"missing-anchor\", target);\n}\n\nexport function isRootRelativePath(\n canonicalProjectRoot: string,\n rootRelativePath: string\n): boolean {\n return (\n !path.isAbsolute(rootRelativePath) &&\n isWithinRoot(canonicalProjectRoot, path.resolve(canonicalProjectRoot, rootRelativePath))\n );\n}\n\nexport function isWithinRoot(root: string, candidate: string): boolean {\n const relativePath = path.relative(root, candidate);\n return (\n relativePath === \"\" \|\|\n (!relativePath.startsWith(`..${path.sep}`) &&\n relativePath !== \"..\" &&\n !path.isAbsolute(relativePath))\n );\n}\n\nexport function relativeSegments(root: string, candidate: string): string[] {\n const relativePath = path.relative(root, candidate);\n return relativePath === \"\"\n ? []\n : relativePath.split(path.sep).filter((segment) => segment !== \"\");\n}\n\nexport function sameRootRelativePath(\n rootRelativePath: string,\n targetPath: string,\n canonicalProjectRoot: string\n): boolean {\n return toSlashPath(path.relative(canonicalProjectRoot, targetPath)) === rootRelativePath;\n}\n\nexport function isMarkdownPath(targetPath: string): boolean {\n const extension = path.extname(targetPath).toLowerCase();\n return extension === \".md\" \|\| extension === \".markdown\";\n}\n\nexport function toSlashPath(filePath: string): string {\n return filePath.split(path.sep).join(\"/\");\n}\n\nfunction containsUnsafeRawFileCharacter(value: string): boolean {\n return value.includes(\"\\\\\") \|\| containsControlCharacter(value) \|\| /\\s/u.test(value);\n}\n\nfunction containsControlCharacter(value: string): boolean {\n for (const character of value) {\n const codePoint = character.codePointAt(0);\n if (\n codePoint !== undefined &&\n (codePoint <= 0x1f \|\| (codePoint >= 0x7f && codePoint <= 0x9f))\n ) {\n return true;\n }\n }\n return false;\n}\n\nexport function isNotFound(error: unknown): boolean {\n return typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nexport function sourceUnavailable(): MarkdownSourceReadResult {\n return Object.freeze({ ok: false as const, reason: \"source-unavailable\" as const });\n}\n\nexport function valid(target: MarkdownSafeTargetDescriptor): MarkdownLocalResolution {\n return Object.freeze({ kind: \"valid\" as const, target });\n}\n\nexport function finding(\n reason: MarkdownLinkFindingReason,\n target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n return Object.freeze({ kind: \"finding\" as const, reason, target });\n}\n\nexport function unavailable(reason: MarkdownLocalResolutionReason): MarkdownLocalResolution {\n return Object.freeze({ kind: \"unavailable\" as const, reason });\n}\n\nexport type {\n MarkdownLinkSource,\n MarkdownLocalResolution,\n MarkdownLocalResolutionReason,\n MarkdownLocalResolver,\n MarkdownLocalResolverCreation,\n MarkdownLocalResolutionRequest,\n MarkdownSafeTargetDescriptor,\n MarkdownSourceReadResult,\n MarkdownSourceReadFailureReason,\n RootProbe,\n EndpointProbe,\n ExistingEndpointProbe,\n RootExternalTargetMode\n};\n"]}

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

@@ -1,12 +1,12 @@
 import { realpath } from "node:fs/promises";
 import { LinkLocalResolver } from "./resolver-engine.mjs";
 /** Link-private, per-invocation state for source reads and direct local targets. */
-export async function createMarkdownLocalResolver(projectRoot, maxTargetReads) {
+export async function createMarkdownLocalResolver(projectRoot, maxTargetReads, cache, signal) {
     try {
         const canonicalProjectRoot = await realpath(projectRoot);
         return Object.freeze({
             ok: true,
-            resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads)
+            resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads, cache, signal)
         });
     }
     catch {

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

	@@ -1 +1 @@
1	- {"version":3,"file":"local-resolver.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;~~AAGzD~~,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,cAAsB;~~IAEtB~~,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,IAAa;YACjB,QAAQ,EAAE,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,cAAc,CAAC;~~SACtE~~,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,0BAAmC,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,KAAK,EACN,MAAM,uBAAuB,CAAC","sourcesContent":["import { realpath } from \"node:fs/promises\";\n\nimport { LinkLocalResolver } from \"./resolver-engine.ts\";\nimport type { MarkdownLocalResolverCreation } from \"./local-resolution.ts\";\n\n/** Link-private, per-invocation state for source reads and direct local targets. */\nexport async function createMarkdownLocalResolver(\n projectRoot: string,\n maxTargetReads: number\n): Promise<MarkdownLocalResolverCreation> {\n try {\n const canonicalProjectRoot = await realpath(projectRoot);\n return Object.freeze({\n ok: true as const,\n resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads)\n });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"project-root-unavailable\" as const });\n }\n}\n\nexport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isNotFound,\n isRootRelativePath,\n isWithinRoot,\n parseLocalDestination,\n relativeSegments,\n sameRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n unavailable,\n valid\n} from \"./local-resolution.ts\";\nexport type {\n EndpointProbe,\n MarkdownLinkFindingReason,\n MarkdownLinkSource,\n MarkdownLocalResolution,\n MarkdownLocalResolutionReason,\n MarkdownLocalResolutionRequest,\n MarkdownLocalResolver,\n MarkdownLocalResolverCreation,\n MarkdownSafeTargetDescriptor,\n MarkdownSourceReadFailureReason,\n MarkdownSourceReadResult,\n RootExternalTargetMode,\n RootProbe\n} from \"./local-resolution.ts\";\n"]}
1	+ {"version":3,"file":"local-resolver.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIzD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,cAAsB,EACtB,KAAqD,EACrD,MAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,IAAa;YACjB,QAAQ,EAAE,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,CAAC;SACrF,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,0BAAmC,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,KAAK,EACN,MAAM,uBAAuB,CAAC","sourcesContent":["import { realpath } from \"node:fs/promises\";\n\nimport { LinkLocalResolver } from \"./resolver-engine.ts\";\nimport type { MarkdownLocalResolverCreation } from \"./local-resolution.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\n/** Link-private, per-invocation state for source reads and direct local targets. */\nexport async function createMarkdownLocalResolver(\n projectRoot: string,\n maxTargetReads: number,\n cache: ResolvedMarkdownLinkValidationOptions[\"cache\"],\n signal: AbortSignal\n): Promise<MarkdownLocalResolverCreation> {\n try {\n const canonicalProjectRoot = await realpath(projectRoot);\n return Object.freeze({\n ok: true as const,\n resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads, cache, signal)\n });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"project-root-unavailable\" as const });\n }\n}\n\nexport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isNotFound,\n isRootRelativePath,\n isWithinRoot,\n parseLocalDestination,\n relativeSegments,\n sameRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n unavailable,\n valid\n} from \"./local-resolution.ts\";\nexport type {\n EndpointProbe,\n MarkdownLinkFindingReason,\n MarkdownLinkSource,\n MarkdownLocalResolution,\n MarkdownLocalResolutionReason,\n MarkdownLocalResolutionRequest,\n MarkdownLocalResolver,\n MarkdownLocalResolverCreation,\n MarkdownSafeTargetDescriptor,\n MarkdownSourceReadFailureReason,\n MarkdownSourceReadResult,\n RootExternalTargetMode,\n RootProbe\n} from \"./local-resolution.ts\";\n"]}

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

@@ -138,9 +138,7 @@ function isMarkdownAstNode(value) {
     return typeof value.type === "string";
 }
 function sourceRangeFromPosition(position) {
-    if (position === undefined ||
-        position.start.offset === undefined ||
-        position.end.offset === undefined) {
+    if (position?.start.offset === undefined || position?.end.offset === undefined) {
         return null;
     }
     return Object.freeze({

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

	@@ -1 +1 @@
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"]}
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 (position?.start.offset === undefined \|\| position?.end.offset === undefined) {\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 CHANGED Viewed

@@ -2,6 +2,7 @@ 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 { resolveOptionalLocalCacheOptions } from "../local-cache-options.mjs";
 import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
 const DEFAULT_LIMITS = Object.freeze({
     maxMarkdownBytes: 1_048_576,
@@ -21,14 +22,18 @@ export function resolveMarkdownLinkValidationOptions(value) {
     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)
+    const cache = resolveOptionalLocalCacheOptions(input.cache);
+    if (limits === undefined ||
+        files === undefined ||
+        findingPolicy === undefined ||
+        cache === undefined)
         return undefined;
-    const candidate = optionsCandidate(input, files, findingPolicy, limits);
+    const candidate = optionsCandidate(input, files, findingPolicy, limits, cache);
     return candidate !== undefined && validMarkdownLinkValidationOptions(candidate)
         ? candidate
         : undefined;
 }
-function optionsCandidate(input, files, findingPolicy, limits) {
+function optionsCandidate(input, files, findingPolicy, limits, cache) {
     return canonicalizeJsonObject({
         files,
         findingPolicy,
@@ -37,6 +42,7 @@ function optionsCandidate(input, files, findingPolicy, limits) {
         validateCrossDocumentAnchors: input.validateCrossDocumentAnchors === undefined ? true : input.validateCrossDocumentAnchors,
         rootExternalTargetMode: input.rootExternalTargetMode === undefined ? "report" : input.rootExternalTargetMode,
         requireNonEmptyDirectories: input.requireNonEmptyDirectories === undefined ? false : input.requireNonEmptyDirectories,
+        cache,
         limits
     });
 }
@@ -51,6 +57,7 @@ function isMarkdownLinkValidationInput(input) {
                 "validateCrossDocumentAnchors",
                 "rootExternalTargetMode",
                 "requireNonEmptyDirectories",
+                "cache",
                 "limits"
             ],
             required: []

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

	@@ -1 +1 @@
1	- {"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;~~AAElG~~,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,KAAK;CACtB,CAAC,CAAC;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,2BAA2B,CAAC,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,uCAAuC,CAAC,CAAC;IAClF,MAAM,EAAE,2BAA2B,CAAC,MAAM;CAC3C,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACxF,~~IAAI~~,MAAM,KAAK,SAAS,~~IAAI,~~KAAK,KAAK,SAAS,~~IAAI,~~aAAa,KAAK,SAAS;~~QAAE~~,OAAO,SAAS,CAAC;~~IACjG~~,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,CAAC;~~IACxE~~,OAAO,SAAS,KAAK,SAAS,IAAI,kCAAkC,CAAC,SAAS,CAAC;QAC7E,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAwC,EACxC,KAA2D,EAC3D,aAA0E,EAC1E,MAAyC;~~IAEzC~~,OAAO,sBAAsB,CAAC;QAC5B,KAAK;QACL,aAAa;QACb,sBAAsB,EACpB,KAAK,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB;QAClF,2BAA2B,EACzB,KAAK,CAAC,2BAA2B,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,2BAA2B;QAC5F,4BAA4B,EAC1B,KAAK,CAAC,4BAA4B,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,4BAA4B;QAC9F,sBAAsB,EACpB,KAAK,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB;QACtF,0BAA0B,EACxB,KAAK,CAAC,0BAA0B,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,0BAA0B;QAC3F,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAoD;IAEpD,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,gCAAgC,CAAC,KAAK,EAAE;YACtC,QAAQ,EAAE;gBACR,OAAO;gBACP,eAAe;gBACf,wBAAwB;gBACxB,6BAA6B;gBAC7B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,QAAQ;aACT;YACD,QAAQ,EAAE,EAAE;SACb,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,4BAA4B,CAAC,aAAa,CAAC;QAC7C,CAAC,CAAC,2BAA2B,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,CAAC,gCAAgC,CAAC,MAAM,EAAE;YACxC,QAAQ,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;YAClE,QAAQ,EAAE,EAAE;SACb,CAAC,EACF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,gBAAgB,EACd,MAAM,CAAC,gBAAgB,KAAK,SAAS;YACnC,CAAC,CAAC,cAAc,CAAC,gBAAgB;YACjC,CAAC,CAAC,MAAM,CAAC,gBAAgB;QAC7B,cAAc,EACZ,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;QAC7F,cAAc,EACZ,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;KAC9F,CAAC,CAAC;AACL,CAAC","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"]}
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 { resolveOptionalLocalCacheOptions } from \"../local-cache-options.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 const cache = resolveOptionalLocalCacheOptions(input.cache);\n if (\n limits === undefined \|\|\n files === undefined \|\|\n findingPolicy === undefined \|\|\n cache === undefined\n )\n return undefined;\n const candidate = optionsCandidate(input, files, findingPolicy, limits, cache);\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 cache: ResolvedMarkdownLinkValidationOptions[\"cache\"]\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 cache,\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 \"cache\",\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"]}