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/resolver-engine.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resolver-engine.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/resolver-engine.ts"],"names":[],"mappings":"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","sourcesContent":["import { opendir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport { parseMarkdownLinkFacts } from \"./markdown-parser.ts\";\nimport {\n directoryTarget,\n fileTargetDescriptor,\n outsideProjectRootTarget,\n projectTarget\n} from \"./target-descriptor.ts\";\nimport { probeEndpoint, probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isRootRelativePath,\n isWithinRoot,\n parseLocalDestination,\n sameRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n unavailable,\n valid,\n type MarkdownLocalResolution,\n type MarkdownLocalResolutionRequest,\n type MarkdownLocalResolver,\n type MarkdownSafeTargetDescriptor,\n type MarkdownSourceReadResult\n} from \"./local-resolution.ts\";\n\nexport class LinkLocalResolver implements MarkdownLocalResolver {\n #targetReadCount = 0;\n readonly #canonicalProjectRoot: string;\n readonly #maxTargetReads: number;\n\n constructor(canonicalProjectRoot: string, maxTargetReads: number) {\n this.#canonicalProjectRoot = canonicalProjectRoot;\n this.#maxTargetReads = maxTargetReads;\n }\n\n get targetReadCount(): number {\n return this.#targetReadCount;\n }\n\n async readSource(\n rootRelativePath: string,\n maxMarkdownBytes: number\n ): Promise<MarkdownSourceReadResult> {\n if (!isRootRelativePath(this.#canonicalProjectRoot, rootRelativePath)) {\n return sourceUnavailable();\n }\n\n const sourcePath = path.resolve(this.#canonicalProjectRoot, rootRelativePath);\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, sourcePath);\n if (\n rootProbe.kind === \"outside\" \|\|\n rootProbe.kind === \"unavailable\" \|\|\n rootProbe.kind === \"missing\"\n ) {\n return sourceUnavailable();\n }\n\n const sourceBytes = await readRegularFile(rootProbe.absolutePath, maxMarkdownBytes);\n if (!sourceBytes.ok) {\n return sourceBytes.reason === \"too-large\"\n ? Object.freeze({ ok: false as const, reason: \"source-too-large\" as const })\n : sourceUnavailable();\n }\n\n let markdown: string;\n try {\n markdown = new TextDecoder(\"utf-8\", { fatal: true }).decode(sourceBytes.bytes);\n } catch {\n return sourceUnavailable();\n }\n\n const parsed = parseMarkdownLinkFacts(markdown);\n if (!parsed.ok) {\n return Object.freeze({ ok: false as const, reason: \"markdown-parse-failed\" as const });\n }\n\n return Object.freeze({\n ok: true as const,\n source: Object.freeze({\n path: toSlashPath(path.relative(this.#canonicalProjectRoot, sourcePath)),\n facts: parsed.facts\n })\n });\n }\n\n async resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution> {\n const destination = parseLocalDestination(request.rawDestination);\n if (destination === \"not-local\") {\n return Object.freeze({ kind: \"not-local\" as const });\n }\n if (destination === null) {\n return unavailable(\"invalid-local-destination\");\n }\n\n let targetPath: string;\n if (destination.path === \"\") {\n targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);\n } else if (destination.isAbsolute) {\n targetPath = path.normalize(destination.path);\n } else {\n targetPath = path.resolve(\n this.#canonicalProjectRoot,\n path.dirname(request.source.path),\n destination.path\n );\n }\n const isSameDocument =\n !destination.isAbsolute &&\n sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);\n if (isSameDocument) {\n return this.resolveSameDocument(destination.fragment, request);\n }\n const lexicalTargetIsExternal =\n destination.isAbsolute \|\| !isWithinRoot(this.#canonicalProjectRoot, targetPath);\n\n if (lexicalTargetIsExternal) {\n return this.resolveExternalTarget(targetPath, destination.fragment, request);\n }\n\n return this.resolveRootContainedTarget(targetPath, destination.fragment, request);\n }\n\n async resolveRootContainedTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);\n if (rootProbe.kind === \"outside\") {\n return this.resolveExternalTarget(targetPath, fragment, request);\n }\n if (rootProbe.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (rootProbe.kind === \"missing\") {\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n rootProbe.absolutePath,\n fragment,\n request,\n projectTarget(this.#canonicalProjectRoot, targetPath, fragment)\n );\n }\n\n async resolveExternalTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n if (request.rootExternalTargetMode === \"ignore\") {\n return Object.freeze({ kind: \"ignored\" as const });\n }\n if (request.rootExternalTargetMode === \"report\") {\n return finding(\"target-outside-project-root\", outsideProjectRootTarget());\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(targetPath, fragment, request, outsideProjectRootTarget());\n }\n\n async resolveEndpoint(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n const endpoint = await probeEndpoint(targetPath);\n if (endpoint.kind === \"missing\") {\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (endpoint.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (endpoint.kind === \"directory\") {\n return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));\n }\n if (endpoint.kind === \"unsupported\") {\n return finding(\"unsupported-target-type\", target);\n }\n\n return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));\n }\n\n async resolveFile(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment === null \|\| !request.validateCrossDocumentAnchors) {\n return valid(target);\n }\n if (!isMarkdownPath(targetPath)) {\n return finding(\"anchor-target-not-markdown\", target);\n }\n\n const targetMarkdown = await readRegularFile(targetPath, request.maxMarkdownBytes);\n if (!targetMarkdown.ok) {\n return unavailable(\"target-unavailable\");\n }\n let decodedTarget: string;\n try {\n decodedTarget = new TextDecoder(\"utf-8\", { fatal: true }).decode(targetMarkdown.bytes);\n } catch {\n return unavailable(\"target-unavailable\");\n }\n const parsedTarget = parseMarkdownLinkFacts(decodedTarget);\n if (!parsedTarget.ok) {\n return unavailable(\"target-unavailable\");\n }\n return anchorResolution(parsedTarget.facts.headings, fragment, target);\n }\n\n async resolveDirectory(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment !== null) {\n return finding(\"anchor-on-directory\", target);\n }\n if (!request.requireNonEmptyDirectories) {\n return valid(target);\n }\n try {\n const directory = await opendir(targetPath);\n try {\n return (await directory.read()) === null\n ? finding(\"empty-directory\", target)\n : valid(target);\n } finally {\n await directory.close();\n }\n } catch {\n return unavailable(\"target-unavailable\");\n }\n }\n\n beginTargetValidation(): boolean {\n if (this.#targetReadCount >= this.#maxTargetReads) {\n return false;\n }\n this.#targetReadCount += 1;\n return true;\n }\n\n resolveSameDocument(\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): MarkdownLocalResolution {\n const target = Object.freeze({\n kind: \"same-document\" as const,\n path: request.source.path,\n fragment\n });\n if (fragment === null \|\| !request.validateSameDocumentAnchors) {\n return valid(target);\n }\n return anchorResolution(request.source.facts.headings, fragment, target);\n }\n}\n"]}
1	+ {"version":3,"file":"resolver-engine.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/resolver-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,6BAA6B,EAAE,MAAM,wBAAwB,CAAC;AACvE,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,EACd,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,+BAA+B,EAAE,MAAM,oBAAoB,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,WAAW,EACX,KAAK,EAMN,MAAM,uBAAuB,CAAC;AAG/B,MAAM,OAAO,iBAAiB;IAC5B,gBAAgB,GAAG,CAAC,CAAC;IACZ,qBAAqB,CAAS;IAC9B,gBAAgB,CAAgC;IAChD,eAAe,CAAS;IACxB,OAAO,CAAc;IACrB,eAAe,GAAG,IAAI,GAAG,EAAwD,CAAC;IAE3F,YACE,oBAA4B,EAC5B,cAAsB,EACtB,KAAqD,EACrD,MAAmB;QAEnB,IAAI,CAAC,qBAAqB,GAAG,oBAAoB,CAAC;QAClD,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QACtC,IAAI,CAAC,gBAAgB,GAAG,IAAI,6BAA6B,CAAC,KAAK,CAAC,CAAC;QACjE,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC/B,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,gBAAwB,EAAE,gBAAwB;QAC3D,OAAO,+BAA+B,CAAC;YACrC,oBAAoB,EAAE,IAAI,CAAC,qBAAqB;YAChD,gBAAgB;YAChB,kBAAkB,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;YAC9D,gBAAgB;YAChB,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,OAAuC;QACnD,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QACnE,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAClE,IAAI,WAAW,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC,CAAC;QACvD,CAAC;QACD,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;YACzB,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,UAAkB,CAAC;QACvB,IAAI,WAAW,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;YAC5B,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;aAAM,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YAClC,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,UAAU,GAAG,IAAI,CAAC,OAAO,CACvB,IAAI,CAAC,qBAAqB,EAC1B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,EACjC,WAAW,CAAC,IAAI,CACjB,CAAC;QACJ,CAAC;QACD,MAAM,cAAc,GAClB,CAAC,WAAW,CAAC,UAAU;YACvB,oBAAoB,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,qBAAqB,CAAC,CAAC;QACpF,IAAI,cAAc,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,mBAAmB,CAAC,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,uBAAuB,GAC3B,WAAW,CAAC,UAAU,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;QAElF,IAAI,uBAAuB,EAAE,CAAC;YAC5B,OAAO,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC/E,CAAC;QAED,OAAO,IAAI,CAAC,0BAA0B,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,0BAA0B,CAC9B,UAAkB,EAClB,QAAuB,EACvB,OAAuC;QAEvC,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;QACvF,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,qBAAqB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACrC,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,SAAS,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;gBAClC,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;YAC/E,OAAO,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAClC,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CACzB,SAAS,CAAC,QAAQ,IAAI,CAAC,MAAM,aAAa,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC,EACnE,SAAS,CAAC,YAAY,EACtB,QAAQ,EACR,OAAO,EACP,aAAa,CAAC,IAAI,CAAC,qBAAqB,EAAE,UAAU,EAAE,QAAQ,CAAC,CAChE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,UAAkB,EAClB,QAAuB,EACvB,OAAuC;QAEvC,IAAI,OAAO,CAAC,sBAAsB,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,OAAO,CAAC,sBAAsB,KAAK,QAAQ,EAAE,CAAC;YAChD,OAAO,OAAO,CAAC,6BAA6B,EAAE,wBAAwB,EAAE,CAAC,CAAC;QAC5E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,qBAAqB,EAAE,EAAE,CAAC;YAClC,OAAO,WAAW,CAAC,4BAA4B,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,IAAI,CAAC,eAAe,CACzB,MAAM,aAAa,CAAC,UAAU,CAAC,EAC/B,UAAU,EACV,QAAQ,EACR,OAAO,EACP,wBAAwB,EAAE,CAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,QAAuB,EACvB,UAAkB,EAClB,QAAuB,EACvB,OAAuC,EACvC,MAAoC;QAEpC,IAAI,QAAQ,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,sBAAsB,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAC5F,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,QAAQ,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC,yBAAyB,EAAE,MAAM,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;IACvF,CAAC;IAED,KAAK,CAAC,WAAW,CACf,UAAkB,EAClB,QAAuB,EACvB,OAAuC,EACvC,MAAoC;QAEpC,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,4BAA4B,EAAE,CAAC;YAC/D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;YAChC,OAAO,OAAO,CAAC,4BAA4B,EAAE,MAAM,CAAC,CAAC;QACvD,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5E,OAAO,KAAK,KAAK,SAAS;YACxB,CAAC,CAAC,WAAW,CAAC,oBAAoB,CAAC;YACnC,CAAC,CAAC,gBAAgB,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAAkB,EAClB,QAAuB,EACvB,OAAuC,EACvC,MAAoC;QAEpC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QACnE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,0BAA0B,EAAE,CAAC;YACxC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;YAC5C,IAAI,CAAC;gBACH,OAAO,CAAC,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI;oBACtC,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,MAAM,CAAC;oBACpC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC;YAC1B,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IAED,qBAAqB;QACnB,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,YAAY,CAChB,UAAkB,EAClB,gBAAwB;QAExB,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,QAAQ,CAAC;QAE5C,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QACpE,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;YACrE,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,UAAkB,EAClB,gBAAwB;QAExB,MAAM,cAAc,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;QAC3E,IAAI,CAAC,cAAc,CAAC,EAAE,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QACjE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;IAC/F,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,KAAiB;QACzC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QACtE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,mBAAmB,CACjB,QAAuB,EACvB,OAAuC;QAEvC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;YAC3B,IAAI,EAAE,eAAwB;YAC9B,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;YACzB,QAAQ;SACT,CAAC,CAAC;QACH,IAAI,QAAQ,KAAK,IAAI,IAAI,CAAC,OAAO,CAAC,2BAA2B,EAAE,CAAC;YAC9D,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,gBAAgB,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC3E,CAAC;CACF","sourcesContent":["import { opendir } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport type { MarkdownLinkParseResult, ParsedMarkdownLinkFacts } from \"./markdown-parser.ts\";\nimport { MarkdownLinkParseFactsSession } from \"./parse-facts-cache.ts\";\nimport {\n directoryTarget,\n fileTargetDescriptor,\n outsideProjectRootTarget,\n projectTarget\n} from \"./target-descriptor.ts\";\nimport { probeEndpoint, probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport { readRootContainedMarkdownSource } from \"./source-reader.ts\";\nimport {\n anchorResolution,\n finding,\n isMarkdownPath,\n isWithinRoot,\n parseLocalDestination,\n sameRootRelativePath,\n unavailable,\n valid,\n type MarkdownLocalResolution,\n type MarkdownLocalResolutionRequest,\n type MarkdownLocalResolver,\n type MarkdownSafeTargetDescriptor,\n type EndpointProbe\n} from \"./local-resolution.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nexport class LinkLocalResolver implements MarkdownLocalResolver {\n #targetReadCount = 0;\n readonly #canonicalProjectRoot: string;\n readonly #parseFactsCache: MarkdownLinkParseFactsSession;\n readonly #maxTargetReads: number;\n readonly #signal: AbortSignal;\n readonly #targetFactMemo = new Map<string, Promise<ParsedMarkdownLinkFacts \| undefined>>();\n\n constructor(\n canonicalProjectRoot: string,\n maxTargetReads: number,\n cache: ResolvedMarkdownLinkValidationOptions[\"cache\"],\n signal: AbortSignal\n ) {\n this.#canonicalProjectRoot = canonicalProjectRoot;\n this.#maxTargetReads = maxTargetReads;\n this.#parseFactsCache = new MarkdownLinkParseFactsSession(cache);\n this.#signal = signal;\n }\n\n get targetReadCount(): number {\n return this.#targetReadCount;\n }\n\n finalize(): Promise<void> {\n return this.#parseFactsCache.finalize(this.#signal);\n }\n\n readSource(rootRelativePath: string, maxMarkdownBytes: number) {\n return readRootContainedMarkdownSource({\n canonicalProjectRoot: this.#canonicalProjectRoot,\n maxMarkdownBytes,\n parseMarkdownBytes: (bytes) => this.#parseMarkdownBytes(bytes),\n rootRelativePath,\n signal: this.#signal\n });\n }\n\n async resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution> {\n if (this.#signal.aborted) return unavailable(\"target-unavailable\");\n const destination = parseLocalDestination(request.rawDestination);\n if (destination === \"not-local\") {\n return Object.freeze({ kind: \"not-local\" as const });\n }\n if (destination === null) {\n return unavailable(\"invalid-local-destination\");\n }\n\n let targetPath: string;\n if (destination.path === \"\") {\n targetPath = path.resolve(this.#canonicalProjectRoot, request.source.path);\n } else if (destination.isAbsolute) {\n targetPath = path.normalize(destination.path);\n } else {\n targetPath = path.resolve(\n this.#canonicalProjectRoot,\n path.dirname(request.source.path),\n destination.path\n );\n }\n const isSameDocument =\n !destination.isAbsolute &&\n sameRootRelativePath(request.source.path, targetPath, this.#canonicalProjectRoot);\n if (isSameDocument) {\n return this.resolveSameDocument(destination.fragment, request);\n }\n const lexicalTargetIsExternal =\n destination.isAbsolute \|\| !isWithinRoot(this.#canonicalProjectRoot, targetPath);\n\n if (lexicalTargetIsExternal) {\n return this.resolveExternalTarget(targetPath, destination.fragment, request);\n }\n\n return this.resolveRootContainedTarget(targetPath, destination.fragment, request);\n }\n\n async resolveRootContainedTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n const rootProbe = await probeRootContainedPath(this.#canonicalProjectRoot, targetPath);\n if (rootProbe.kind === \"outside\") {\n return this.resolveExternalTarget(targetPath, fragment, request);\n }\n if (rootProbe.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (rootProbe.kind === \"missing\") {\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n const target = projectTarget(this.#canonicalProjectRoot, targetPath, fragment);\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n rootProbe.endpoint ?? (await probeEndpoint(rootProbe.absolutePath)),\n rootProbe.absolutePath,\n fragment,\n request,\n projectTarget(this.#canonicalProjectRoot, targetPath, fragment)\n );\n }\n\n async resolveExternalTarget(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): Promise<MarkdownLocalResolution> {\n if (request.rootExternalTargetMode === \"ignore\") {\n return Object.freeze({ kind: \"ignored\" as const });\n }\n if (request.rootExternalTargetMode === \"report\") {\n return finding(\"target-outside-project-root\", outsideProjectRootTarget());\n }\n if (!this.beginTargetValidation()) {\n return unavailable(\"target-read-limit-exceeded\");\n }\n return this.resolveEndpoint(\n await probeEndpoint(targetPath),\n targetPath,\n fragment,\n request,\n outsideProjectRootTarget()\n );\n }\n\n async resolveEndpoint(\n endpoint: EndpointProbe,\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (endpoint.kind === \"missing\") {\n return request.requireExistingTargets ? finding(\"missing-target\", target) : valid(target);\n }\n if (endpoint.kind === \"unavailable\") {\n return unavailable(\"target-unavailable\");\n }\n if (endpoint.kind === \"directory\") {\n return this.resolveDirectory(targetPath, fragment, request, directoryTarget(target));\n }\n if (endpoint.kind === \"unsupported\") {\n return finding(\"unsupported-target-type\", target);\n }\n\n return this.resolveFile(targetPath, fragment, request, fileTargetDescriptor(target));\n }\n\n async resolveFile(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (fragment === null \|\| !request.validateCrossDocumentAnchors) {\n return valid(target);\n }\n if (!isMarkdownPath(targetPath)) {\n return finding(\"anchor-target-not-markdown\", target);\n }\n\n const facts = await this.#targetFacts(targetPath, request.maxMarkdownBytes);\n return facts === undefined\n ? unavailable(\"target-unavailable\")\n : anchorResolution(facts.headings, fragment, target);\n }\n\n async resolveDirectory(\n targetPath: string,\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest,\n target: MarkdownSafeTargetDescriptor\n ): Promise<MarkdownLocalResolution> {\n if (this.#signal.aborted) return unavailable(\"target-unavailable\");\n if (fragment !== null) {\n return finding(\"anchor-on-directory\", target);\n }\n if (!request.requireNonEmptyDirectories) {\n return valid(target);\n }\n try {\n const directory = await opendir(targetPath);\n try {\n return (await directory.read()) === null\n ? finding(\"empty-directory\", target)\n : valid(target);\n } finally {\n await directory.close();\n }\n } catch {\n return unavailable(\"target-unavailable\");\n }\n }\n\n beginTargetValidation(): boolean {\n if (this.#targetReadCount >= this.#maxTargetReads) {\n return false;\n }\n this.#targetReadCount += 1;\n return true;\n }\n\n async #targetFacts(\n targetPath: string,\n maxMarkdownBytes: number\n ): Promise<ParsedMarkdownLinkFacts \| undefined> {\n if (this.#signal.aborted) return undefined;\n const key = JSON.stringify([targetPath, maxMarkdownBytes]);\n const existing = this.#targetFactMemo.get(key);\n if (existing !== undefined) return existing;\n\n const pending = this.#readTargetFacts(targetPath, maxMarkdownBytes);\n this.#targetFactMemo.set(key, pending);\n const facts = await pending;\n if (facts === undefined && this.#targetFactMemo.get(key) === pending) {\n this.#targetFactMemo.delete(key);\n }\n return facts;\n }\n\n async #readTargetFacts(\n targetPath: string,\n maxMarkdownBytes: number\n ): Promise<ParsedMarkdownLinkFacts \| undefined> {\n const targetMarkdown = await readRegularFile(targetPath, maxMarkdownBytes);\n if (!targetMarkdown.ok \|\| this.#signal.aborted) return undefined;\n const parsed = await this.#parseMarkdownBytes(targetMarkdown.bytes);\n return this.#signal.aborted \|\| parsed === undefined \|\| !parsed.ok ? undefined : parsed.facts;\n }\n\n async #parseMarkdownBytes(bytes: Uint8Array): Promise<MarkdownLinkParseResult \| undefined> {\n if (this.#signal.aborted) return undefined;\n const parsed = await this.#parseFactsCache.parse(bytes, this.#signal);\n return this.#signal.aborted ? undefined : parsed;\n }\n\n resolveSameDocument(\n fragment: string \| null,\n request: MarkdownLocalResolutionRequest\n ): MarkdownLocalResolution {\n const target = Object.freeze({\n kind: \"same-document\" as const,\n path: request.source.path,\n fragment\n });\n if (fragment === null \|\| !request.validateSameDocumentAnchors) {\n return valid(target);\n }\n return anchorResolution(request.source.facts.headings, fragment, target);\n }\n}\n"]}

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

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

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

@@ -0,0 +1 @@

+ {"version":3,"file":"source-reader.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/source-reader.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,WAAW,EAEZ,MAAM,uBAAuB,CAAC;AAc/B,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,OAA+C;IAE/C,MAAM,UAAU,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAC7D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,iBAAiB,EAAE,CAAC;IACzD,MAAM,UAAU,GAAG,MAAM,4BAA4B,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC3E,IAAI,UAAU,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,MAAM,CAAC;IAC3D,OAAO,6BAA6B,CAAC,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,gCAAgC,CACvC,OAA+C;IAE/C,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,kBAAkB,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,gBAAgB,CAAC;QAC/E,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACtE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,4BAA4B,CACzC,OAA+C,EAC/C,UAAkB;IAElB,MAAM,SAAS,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;IACzF,IACE,SAAS,CAAC,IAAI,KAAK,SAAS;QAC5B,SAAS,CAAC,IAAI,KAAK,aAAa;QAChC,SAAS,CAAC,IAAI,KAAK,SAAS,EAC5B,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAiB,EAAE,MAAM,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAC5F,IAAI,CAAC,WAAW,CAAC,EAAE,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,QAAiB;YACvB,MAAM,EACJ,WAAW,CAAC,MAAM,KAAK,WAAW;gBAChC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,kBAA2B,EAAE,CAAC;gBAC5E,CAAC,CAAC,iBAAiB,EAAE;SAC1B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAgB,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,6BAA6B,CAC1C,OAA+C,EAC/C,UAAkB,EAClB,WAAuB;IAEvB,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;IAC7D,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,iBAAiB,EAAE,CAAC;IAC/E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,uBAAgC,EAAE,CAAC,CAAC;IACzF,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,IAAa;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC;YACpB,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,oBAAoB,EAAE,UAAU,CAAC,CAAC;YAC1E,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import path from \"node:path\";\n\nimport type { MarkdownLinkParseResult } from \"./markdown-parser.ts\";\nimport { probeRootContainedPath, readRegularFile } from \"./filesystem-probes.ts\";\nimport {\n isRootRelativePath,\n sourceUnavailable,\n toSlashPath,\n type MarkdownSourceReadResult\n} from \"./local-resolution.ts\";\n\nexport interface RootContainedMarkdownSourceReadRequest {\n readonly canonicalProjectRoot: string;\n readonly maxMarkdownBytes: number;\n readonly parseMarkdownBytes: (bytes: Uint8Array) => Promise<MarkdownLinkParseResult | undefined>;\n readonly rootRelativePath: string;\n readonly signal: AbortSignal;\n}\n\ntype RootContainedSourceBytesRead =\n | Readonly<{ readonly kind: \"bytes\"; readonly bytes: Uint8Array }>\n | Readonly<{ readonly kind: \"result\"; readonly result: MarkdownSourceReadResult }>;\n\n/** Reads one authorized Markdown source without granting target-resolution behavior. */\nexport async function readRootContainedMarkdownSource(\n request: RootContainedMarkdownSourceReadRequest\n): Promise<MarkdownSourceReadResult> {\n const sourcePath = authorizedRootRelativeSourcePath(request);\n if (sourcePath === undefined) return sourceUnavailable();\n const sourceRead = await readRootContainedSourceBytes(request, sourcePath);\n if (sourceRead.kind === \"result\") return sourceRead.result;\n return parseRootContainedSourceBytes(request, sourcePath, sourceRead.bytes);\n}\n\nfunction authorizedRootRelativeSourcePath(\n request: RootContainedMarkdownSourceReadRequest\n): string | undefined {\n if (request.signal.aborted) return undefined;\n return isRootRelativePath(request.canonicalProjectRoot, request.rootRelativePath)\n ? path.resolve(request.canonicalProjectRoot, request.rootRelativePath)\n : undefined;\n}\n\nasync function readRootContainedSourceBytes(\n request: RootContainedMarkdownSourceReadRequest,\n sourcePath: string\n): Promise<RootContainedSourceBytesRead> {\n const rootProbe = await probeRootContainedPath(request.canonicalProjectRoot, sourcePath);\n if (\n rootProbe.kind === \"outside\" ||\n rootProbe.kind === \"unavailable\" ||\n rootProbe.kind === \"missing\"\n ) {\n return Object.freeze({ kind: \"result\" as const, result: sourceUnavailable() });\n }\n const sourceBytes = await readRegularFile(rootProbe.absolutePath, request.maxMarkdownBytes);\n if (!sourceBytes.ok) {\n return Object.freeze({\n kind: \"result\" as const,\n result:\n sourceBytes.reason === \"too-large\"\n ? Object.freeze({ ok: false as const, reason: \"source-too-large\" as const })\n : sourceUnavailable()\n });\n }\n return Object.freeze({ kind: \"bytes\" as const, bytes: sourceBytes.bytes });\n}\n\nasync function parseRootContainedSourceBytes(\n request: RootContainedMarkdownSourceReadRequest,\n sourcePath: string,\n sourceBytes: Uint8Array\n): Promise<MarkdownSourceReadResult> {\n const parsed = await request.parseMarkdownBytes(sourceBytes);\n if (request.signal.aborted || parsed === undefined) return sourceUnavailable();\n if (!parsed.ok) {\n return Object.freeze({ ok: false as const, reason: \"markdown-parse-failed\" as const });\n }\n return Object.freeze({\n ok: true as const,\n source: Object.freeze({\n path: toSlashPath(path.relative(request.canonicalProjectRoot, sourcePath)),\n facts: parsed.facts\n })\n });\n}\n"]}

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

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

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

@@ -0,0 +1 @@

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

package/dist/esm/package-checks/markdown-lint/adapter.mjs ADDED Viewed

@@ -0,0 +1,125 @@
+import { lint } from "markdownlint/promise";
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+const FRONT_MATTER = /((^---[^\S\r\n\u2028\u2029]*$[\s\S]+?^---\s*)|(^\+\+\+[^\S\r\n\u2028\u2029]*$[\s\S]+?^(\+\+\+|\.\.\.)\s*)|(^\{[^\S\r\n\u2028\u2029]*$[\s\S]+?^\}\s*))(\r\n|\r|\n|$)/m;
+const BACKEND_BY_RULE = {
+    "heading-increment": "MD001",
+    "no-reversed-links": "MD011",
+    "no-missing-space-atx": "MD018",
+    "fenced-code-language": "MD040",
+    "no-empty-links": "MD042",
+    "no-alt-text": "MD045",
+    "link-fragments": "MD051",
+    "reference-links-images": "MD052",
+    "table-column-count": "MD056"
+};
+/** Runs the fixed markdownlint Promise strings API and validates its raw protocol. */
+export async function lintMarkdownString(sourcePath, sourceText, rules) {
+    let raw;
+    try {
+        raw = await lint({
+            config: backendConfiguration(rules),
+            frontMatter: FRONT_MATTER,
+            noInlineConfig: true,
+            strings: { [sourcePath]: sourceText }
+        });
+    }
+    catch {
+        return "backend-failed";
+    }
+    return parseBackendFindings(raw, sourcePath, sourceText, rules);
+}
+function backendConfiguration(rules) {
+    const configuration = { default: false };
+    for (const rule of rules)
+        configuration[BACKEND_BY_RULE[rule]] = configurationFor(rule);
+    if (rules.includes("reference-links-images") && !rules.includes("heading-increment")) {
+        configuration.MD001 = configurationFor("heading-increment");
+    }
+    return configuration;
+}
+function configurationFor(rule) {
+    switch (rule) {
+        case "heading-increment":
+            return { front_matter_title: "^\\s*title\\s*[:=]" };
+        case "fenced-code-language":
+            return { allowed_languages: [], language_only: false };
+        case "link-fragments":
+            return { ignore_case: false, ignored_pattern: "" };
+        case "reference-links-images":
+            return { ignored_labels: ["x"], shortcut_syntax: false };
+        case "no-reversed-links":
+        case "no-missing-space-atx":
+        case "no-empty-links":
+        case "no-alt-text":
+        case "table-column-count":
+            return true;
+    }
+}
+function parseBackendFindings(value, sourcePath, sourceText, selectedRules) {
+    const result = snapshotClosedRecord(value);
+    if (result === undefined ||
+        Object.keys(result).length !== 1 ||
+        !Object.hasOwn(result, sourcePath) ||
+        !Array.isArray(result[sourcePath]))
+        return "backend-protocol-invalid";
+    const lines = sourceText.split(/\r\n|\r|\n/u);
+    const findings = [];
+    for (const rawFinding of result[sourcePath]) {
+        const finding = parseBackendFinding(rawFinding, lines);
+        if (finding === undefined)
+            return "backend-protocol-invalid";
+        if (selectedRules.includes(finding.rule))
+            findings.push(finding);
+    }
+    return Object.freeze(findings);
+}
+function parseBackendFinding(value, lines) {
+    const fields = validatedBackendFindingFields(value, lines);
+    if (fields === undefined)
+        return undefined;
+    const range = parseMarkdownLintRange(fields.errorRange, fields.line);
+    return range === undefined
+        ? undefined
+        : Object.freeze({ lineNumber: fields.lineNumber, range, rule: fields.rule });
+}
+function validatedBackendFindingFields(value, lines) {
+    const finding = snapshotClosedRecord(value);
+    if (finding === undefined)
+        return undefined;
+    const ruleNames = finding.ruleNames;
+    const lineNumber = finding.lineNumber;
+    if (!Array.isArray(ruleNames) ||
+        typeof ruleNames[0] !== "string" ||
+        typeof lineNumber !== "number")
+        return undefined;
+    if (!Number.isSafeInteger(lineNumber) || lineNumber < 1 || lineNumber > lines.length)
+        return undefined;
+    const rule = ruleForBackend(ruleNames[0]);
+    const line = lines[lineNumber - 1];
+    return rule === undefined || line === undefined
+        ? undefined
+        : Object.freeze({ errorRange: finding.errorRange, line, lineNumber, rule });
+}
+function ruleForBackend(backendRule) {
+    return MARKDOWN_LINT_RULE_NAMES.find((rule) => BACKEND_BY_RULE[rule] === backendRule);
+}
+/** Validates one backend or restored-cache range against the current source line. */
+export function parseMarkdownLintRange(value, line) {
+    if (value === null)
+        return null;
+    const range = snapshotClosedArray(value);
+    if (range?.length !== 2)
+        return undefined;
+    const [column, length] = range;
+    if (typeof column !== "number" ||
+        typeof length !== "number" ||
+        !Number.isSafeInteger(column) ||
+        !Number.isSafeInteger(length) ||
+        column < 1 ||
+        length < 1 ||
+        column - 1 + length > line.length)
+        return undefined;
+    return Object.freeze([column, length]);
+}
+//# sourceMappingURL=adapter.mjs.map

package/dist/esm/package-checks/markdown-lint/adapter.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"adapter.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import { lint } from \"markdownlint/promise\";\n\nimport { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { MARKDOWN_LINT_RULE_NAMES, type MarkdownLintRuleName } from \"./options.ts\";\n\nconst FRONT_MATTER =\n /((^---[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^---\\s*)|(^\\+\\+\\+[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^(\\+\\+\\+|\\.\\.\\.)\\s*)|(^\\{[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^\\}\\s*))(\\r\\n|\\r|\\n|$)/m;\n\nconst BACKEND_BY_RULE: Readonly<Record<MarkdownLintRuleName, string>> = {\n \"heading-increment\": \"MD001\",\n \"no-reversed-links\": \"MD011\",\n \"no-missing-space-atx\": \"MD018\",\n \"fenced-code-language\": \"MD040\",\n \"no-empty-links\": \"MD042\",\n \"no-alt-text\": \"MD045\",\n \"link-fragments\": \"MD051\",\n \"reference-links-images\": \"MD052\",\n \"table-column-count\": \"MD056\"\n};\n\nexport interface MarkdownLintBackendFinding {\n readonly lineNumber: number;\n readonly range: readonly [number, number] | null;\n readonly rule: MarkdownLintRuleName;\n}\n\n/** Runs the fixed markdownlint Promise strings API and validates its raw protocol. */\nexport async function lintMarkdownString(\n sourcePath: string,\n sourceText: string,\n rules: readonly MarkdownLintRuleName[]\n): Promise<readonly MarkdownLintBackendFinding[] | \"backend-failed\" | \"backend-protocol-invalid\"> {\n let raw: unknown;\n try {\n raw = await lint({\n config: backendConfiguration(rules),\n frontMatter: FRONT_MATTER,\n noInlineConfig: true,\n strings: { [sourcePath]: sourceText }\n });\n } catch {\n return \"backend-failed\";\n }\n return parseBackendFindings(raw, sourcePath, sourceText, rules);\n}\n\nfunction backendConfiguration(\n rules: readonly MarkdownLintRuleName[]\n): Readonly<Record<string, unknown>> {\n const configuration: Record<string, unknown> = { default: false };\n for (const rule of rules) configuration[BACKEND_BY_RULE[rule]] = configurationFor(rule);\n if (rules.includes(\"reference-links-images\") && !rules.includes(\"heading-increment\")) {\n configuration.MD001 = configurationFor(\"heading-increment\");\n }\n return configuration;\n}\n\nfunction configurationFor(rule: MarkdownLintRuleName): unknown {\n switch (rule) {\n case \"heading-increment\":\n return { front_matter_title: \"^\\\\s*title\\\\s*[:=]\" };\n case \"fenced-code-language\":\n return { allowed_languages: [], language_only: false };\n case \"link-fragments\":\n return { ignore_case: false, ignored_pattern: \"\" };\n case \"reference-links-images\":\n return { ignored_labels: [\"x\"], shortcut_syntax: false };\n case \"no-reversed-links\":\n case \"no-missing-space-atx\":\n case \"no-empty-links\":\n case \"no-alt-text\":\n case \"table-column-count\":\n return true;\n }\n}\n\nfunction parseBackendFindings(\n value: unknown,\n sourcePath: string,\n sourceText: string,\n selectedRules: readonly MarkdownLintRuleName[]\n): readonly MarkdownLintBackendFinding[] | \"backend-protocol-invalid\" {\n const result = snapshotClosedRecord(value);\n if (\n result === undefined ||\n Object.keys(result).length !== 1 ||\n !Object.hasOwn(result, sourcePath) ||\n !Array.isArray(result[sourcePath])\n )\n return \"backend-protocol-invalid\";\n const lines = sourceText.split(/\\r\\n|\\r|\\n/u);\n const findings: MarkdownLintBackendFinding[] = [];\n for (const rawFinding of result[sourcePath]) {\n const finding = parseBackendFinding(rawFinding, lines);\n if (finding === undefined) return \"backend-protocol-invalid\";\n if (selectedRules.includes(finding.rule)) findings.push(finding);\n }\n return Object.freeze(findings);\n}\n\nfunction parseBackendFinding(\n value: unknown,\n lines: readonly string[]\n): MarkdownLintBackendFinding | undefined {\n const fields = validatedBackendFindingFields(value, lines);\n if (fields === undefined) return undefined;\n const range = parseMarkdownLintRange(fields.errorRange, fields.line);\n return range === undefined\n ? undefined\n : Object.freeze({ lineNumber: fields.lineNumber, range, rule: fields.rule });\n}\n\nfunction validatedBackendFindingFields(\n value: unknown,\n lines: readonly string[]\n):\n | Readonly<{\n readonly errorRange: unknown;\n readonly line: string;\n readonly lineNumber: number;\n readonly rule: MarkdownLintRuleName;\n }>\n | undefined {\n const finding = snapshotClosedRecord(value);\n if (finding === undefined) return undefined;\n const ruleNames = finding.ruleNames;\n const lineNumber = finding.lineNumber;\n if (\n !Array.isArray(ruleNames) ||\n typeof ruleNames[0] !== \"string\" ||\n typeof lineNumber !== \"number\"\n )\n return undefined;\n if (!Number.isSafeInteger(lineNumber) || lineNumber < 1 || lineNumber > lines.length)\n return undefined;\n const rule = ruleForBackend(ruleNames[0]);\n const line = lines[lineNumber - 1];\n return rule === undefined || line === undefined\n ? undefined\n : Object.freeze({ errorRange: finding.errorRange, line, lineNumber, rule });\n}\n\nfunction ruleForBackend(backendRule: string): MarkdownLintRuleName | undefined {\n return MARKDOWN_LINT_RULE_NAMES.find((rule) => BACKEND_BY_RULE[rule] === backendRule);\n}\n\n/** Validates one backend or restored-cache range against the current source line. */\nexport function parseMarkdownLintRange(\n value: unknown,\n line: string\n): readonly [number, number] | null | undefined {\n if (value === null) return null;\n const range = snapshotClosedArray(value);\n if (range?.length !== 2) return undefined;\n const [column, length] = range;\n if (\n typeof column !== \"number\" ||\n typeof length !== \"number\" ||\n !Number.isSafeInteger(column) ||\n !Number.isSafeInteger(length) ||\n column < 1 ||\n length < 1 ||\n column - 1 + length > line.length\n )\n return undefined;\n return Object.freeze([column, length] as const);\n}\n"]}

package/dist/esm/package-checks/markdown-lint/default-check.mjs ADDED Viewed

@@ -0,0 +1,37 @@
+import { defineCheck } from "../../check/check.mjs";
+import { resolvePackageCheckAuthoringInput } from "../check-authoring.mjs";
+import { MARKDOWN_LINT_CHECK_DEFINITION, executeMarkdownLint } from "./execution.mjs";
+import { parseMarkdownLintData } from "./final-data.mjs";
+import { resolveMarkdownLintOptions } from "./options-resolution.mjs";
+import { validMarkdownLintOptions } from "./options-validation.mjs";
+export function markdownLint(options = {}) {
+    const input = resolvePackageCheckAuthoringInput(options, ["files", "findingPolicy", "findingWaivers", "rules", "limits", "cache"], MARKDOWN_LINT_CHECK_DEFINITION);
+    if (input === undefined) {
+        throw new TypeError("markdownLint options must match the documented closed policy");
+    }
+    const resolvedOptions = resolveMarkdownLintOptions(input.domainOptions);
+    if (resolvedOptions === undefined) {
+        throw new TypeError("markdownLint options must match the documented closed policy");
+    }
+    return defineCheck({
+        ...input.definition,
+        execute: executeMarkdownLint,
+        parseData: parseMarkdownLintData,
+        prepare: (preparedOptions) => validMarkdownLintOptions(preparedOptions)
+            ? { status: "success", preparedOptions }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: resolvedOptions
+    });
+}
+//# sourceMappingURL=default-check.mjs.map

package/dist/esm/package-checks/markdown-lint/default-check.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"default-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/default-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,iCAAiC,EAElC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AA6CnE,MAAM,UAAU,YAAY,CAC1B,OAAO,GAAwB,EAAE;IAEjC,MAAM,KAAK,GAAG,iCAAiC,CAC7C,OAAO,EACP,CAAC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EACxE,8BAA8B,CAC/B,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,eAAe,GAAG,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,KAAK,CAAC,UAAU;QACnB,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,eAAe,EAAE,EAAE,CAC3B,wBAAwB,CAAC,eAAe,CAAC;YACvC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE;YACxC,CAAC,CAAC;gBACE,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBACnC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,KAAK,EAAE,OAAO;wBACd,OAAO,EACL,2HAA2H;qBAC9H;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport {\n resolvePackageCheckAuthoringInput,\n type PackageCheckIdentityInput\n} from \"../check-authoring.ts\";\nimport { MARKDOWN_LINT_CHECK_DEFINITION, executeMarkdownLint } from \"./execution.ts\";\nimport { parseMarkdownLintData } from \"./final-data.ts\";\nimport type { MarkdownLintOptions, ResolvedMarkdownLintOptions } from \"./options.ts\";\nimport { resolveMarkdownLintOptions } from \"./options-resolution.ts\";\nimport { validMarkdownLintOptions } from \"./options-validation.ts\";\n\n/**\n * 构造使用稳定闭合规则与受限输入的 Markdown 结构检查。\n * 精确 findingWaivers 只在完整 traversal 后应用；原 Finding、计数与缓存 facts 保留。\n *\n * @param options - 省略时采用八项 recommended 规则；非空 rules 数组完整替换该集合。\n * @returns 使用默认或指定 checkId 的 typed Check，携带完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} options 含未知字段、未知/重复规则、非法 limits 或 findingWaivers 时抛出。\n * @example 最小用法\n * ```ts\n * import { defineConfig, markdownLint, run } from \"@zxyycom/vibe-check\";\n *\n * const check = markdownLint({ findingPolicy: \"blocking\" });\n * const definition = defineConfig({\n * checks: [check],\n * outputs: {\n * diagnosticLogging: { enabled: false },\n * machinePublication: { enabled: false },\n * progressRendering: { enabled: false }\n * }\n * });\n *\n * const result = await run(definition);\n * if (result.kind !== \"completed\") throw new Error(`Run did not complete: ${result.kind}`);\n * const outcome = result.snapshot.checks.find(({ checkId }) => checkId === check.checkId)?.outcome;\n * if (outcome?.status !== \"passed\" && outcome?.status !== \"not-applicable\") {\n * throw new Error(`Markdown lint did not pass: ${outcome?.status ?? \"no outcome\"}`);\n * }\n * if (outcome.status === \"not-applicable\") console.warn(\"No Markdown input selected; no lint evidence.\");\n * ```\n */\nexport function markdownLint(\n options?: MarkdownLintOptions<\"markdown-lint\">\n): TypedCheckWithOptions<\n \"markdown-lint\",\n ResolvedMarkdownLintOptions,\n typeof parseMarkdownLintData\n>;\nexport function markdownLint<const Id extends string>(\n options: MarkdownLintOptions<Id> & PackageCheckIdentityInput<Id>\n): TypedCheckWithOptions<Id, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData>;\nexport function markdownLint(\n options: MarkdownLintOptions\n): TypedCheckWithOptions<string, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData>;\nexport function markdownLint(\n options: MarkdownLintOptions = {}\n): TypedCheckWithOptions<string, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData> {\n const input = resolvePackageCheckAuthoringInput(\n options,\n [\"files\", \"findingPolicy\", \"findingWaivers\", \"rules\", \"limits\", \"cache\"],\n MARKDOWN_LINT_CHECK_DEFINITION\n );\n if (input === undefined) {\n throw new TypeError(\"markdownLint options must match the documented closed policy\");\n }\n const resolvedOptions = resolveMarkdownLintOptions(input.domainOptions);\n if (resolvedOptions === undefined) {\n throw new TypeError(\"markdownLint options must match the documented closed policy\");\n }\n return defineCheck({\n ...input.definition,\n execute: executeMarkdownLint,\n parseData: parseMarkdownLintData,\n prepare: (preparedOptions) =>\n validMarkdownLintOptions(preparedOptions)\n ? { status: \"success\", preparedOptions }\n : {\n status: \"failure\",\n action: \"block\",\n reason: { code: \"invalid-options\" },\n messages: [\n {\n code: \"invalid-options\",\n level: \"error\",\n message:\n \"markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options.\"\n }\n ]\n },\n options: resolvedOptions\n });\n}\n"]}

package/dist/esm/package-checks/markdown-lint/execution.mjs ADDED Viewed

@@ -0,0 +1,202 @@
+import path from "node:path";
+import { realpath } from "node:fs/promises";
+import { appendCheckMessages } from "../../package-tools/finding-presentation/finding-presentation.mjs";
+import { reconcileFindingWaivers } from "../../package-tools/finding-waivers/reconciliation.mjs";
+import { reportFindingWaiverAudits } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { collectProjectFiles } from "../project-files/collection.mjs";
+import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
+import { probeRootContainedPath, readRegularFile } from "../markdown-link-validation/filesystem-probes.mjs";
+import { isRootRelativePath } from "../markdown-link-validation/local-resolution.mjs";
+import { lintMarkdownWithCache } from "./findings-cache.mjs";
+import { markdownLintFindingMessages, markdownLintWaiverMessages } from "./finding-messages.mjs";
+import { validMarkdownLintOptions } from "./options-validation.mjs";
+import { buildMarkdownLintInputRejectedRecord, markdownLintFindingIdentity, markdownLintWaiverAuditRecord, orderedMarkdownLintCandidates } from "./records.mjs";
+import { markdownLintUnavailableMessage } from "./unavailable-reasons.mjs";
+export const MARKDOWN_LINT_CHECK_DEFINITION = {
+    checkId: "markdown-lint",
+    displayName: "Markdown lint"
+};
+/** Executes one bounded, ordered lint pass over the exact selected Markdown source paths. */
+export async function executeMarkdownLint(context) {
+    return validMarkdownLintOptions(context.options)
+        ? executeResolvedMarkdownLint(context)
+        : unavailable("invalid-options");
+}
+async function executeResolvedMarkdownLint(context) {
+    if (context.signal.aborted)
+        return unavailable("cancelled");
+    const discovered = discoverSources(context);
+    if (discovered.kind === "unavailable")
+        return unavailable(discovered.reason);
+    if (discovered.selectedPathCount === 0) {
+        return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+    }
+    for (const rejectedPath of discovered.rejectedPaths) {
+        const record = buildMarkdownLintInputRejectedRecord(rejectedPath);
+        context.records.report({ id: record.id }, record.data);
+    }
+    const root = await canonicalProjectRoot(context.project.root);
+    if (root === undefined)
+        return unavailable("project-root-unavailable");
+    const traversal = await traverseSources(discovered.sourcePaths, root, context.options, context.signal);
+    if (traversal.kind === "unavailable")
+        return appendRejected(unavailable(traversal.reason), discovered.rejectedPaths.length);
+    if (context.signal.aborted)
+        return appendRejected(unavailable("cancelled"), discovered.rejectedPaths.length);
+    return publishMarkdownLintTraversal(context, traversal, discovered.rejectedPaths);
+}
+/** Reconciles only a complete traversal, then publishes all evidence and the live policy outcome. */
+export function publishMarkdownLintTraversal(context, traversal, rejectedPaths) {
+    const reconciliation = reconcileFindingWaivers({
+        findings: traversal.candidates,
+        identify: markdownLintFindingIdentity,
+        waivers: context.options.findingWaivers
+    });
+    const actionable = [];
+    for (const finding of reconciliation.findings) {
+        const data = finding.disposition === "waived"
+            ? Object.freeze({
+                ...finding.finding.data,
+                waiver: Object.freeze({ reason: finding.waiver.reason })
+            })
+            : finding.finding.data;
+        context.records.report({ id: finding.finding.id }, data);
+        if (finding.disposition !== "waived")
+            actionable.push(finding.finding);
+    }
+    reportFindingWaiverAudits(context, reconciliation, markdownLintWaiverAuditRecord);
+    const findingCount = traversal.candidates.length + rejectedPaths.length;
+    const blocking = context.options.findingPolicy === "blocking";
+    const result = Object.freeze({
+        status: actionable.length > 0 && blocking ? "failed" : "passed",
+        data: Object.freeze({
+            sourceFileCount: traversal.sourceFileCount,
+            findingCount,
+            rejectedInputCount: rejectedPaths.length
+        })
+    });
+    return appendCheckMessages(result, [
+        ...markdownLintFindingMessages(actionable, rejectedPaths,
+        // Preserve legacy summaries without waivers; fully waived lint must not make rejected-input summaries errors.
+        blocking && (reconciliation.waiverAudits.length === 0 || actionable.length > 0)),
+        ...markdownLintWaiverMessages(reconciliation)
+    ]);
+}
+function discoverSources(context) {
+    try {
+        const selectedPaths = collectProjectFiles(context.project.root, context.options.files);
+        const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownPath);
+        return Object.freeze({
+            kind: "complete",
+            sourcePaths: partition.acceptedPaths,
+            rejectedPaths: partition.rejectedPaths,
+            selectedPathCount: selectedPaths.length
+        });
+    }
+    catch {
+        return Object.freeze({ kind: "unavailable", reason: "source-unavailable" });
+    }
+}
+async function canonicalProjectRoot(projectRoot) {
+    try {
+        return await realpath(projectRoot);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function traverseSources(sourcePaths, rootPath, options, signal) {
+    const rawFindings = [];
+    let sourceFileCount = 0;
+    for (const sourcePath of sourcePaths) {
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        const source = await readMarkdownSource(rootPath, sourcePath, options.limits.maxMarkdownBytes);
+        if (!source.ok)
+            return unavailableTraversal(source.reason);
+        const text = source.text;
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        const linted = await lintMarkdownWithCache({
+            sourcePath,
+            sourceText: text,
+            rules: options.rules,
+            cache: options.cache,
+            signal
+        });
+        const findings = typeof linted === "string" ? linted : linted.findings;
+        if (typeof findings === "string")
+            return unavailableTraversal(findings);
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        sourceFileCount += 1;
+        for (const finding of findings)
+            rawFindings.push(Object.freeze({ path: sourcePath, finding }));
+        if (rawFindings.length > options.limits.maxFindings)
+            return unavailableTraversal("finding-limit-exceeded");
+    }
+    return Object.freeze({
+        kind: "complete",
+        candidates: orderedMarkdownLintCandidates(rawFindings, options.rules),
+        sourceFileCount
+    });
+}
+async function readMarkdownSource(rootPath, rootRelativePath, maxBytes) {
+    if (!isRootRelativePath(rootPath, rootRelativePath))
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    const candidatePath = path.resolve(rootPath, rootRelativePath);
+    const probe = await probeRootContainedPath(rootPath, candidatePath);
+    if (probe.kind !== "contained")
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    const source = await readRegularFile(probe.absolutePath, maxBytes);
+    if (!source.ok)
+        return Object.freeze({
+            ok: false,
+            reason: source.reason === "too-large" ? "source-too-large" : "source-unavailable"
+        });
+    try {
+        return Object.freeze({
+            ok: true,
+            text: new TextDecoder("utf-8", { fatal: true }).decode(source.bytes)
+        });
+    }
+    catch {
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    }
+}
+function isMarkdownPath(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    return extension === ".md" || extension === ".markdown";
+}
+function unavailableTraversal(reason) {
+    return Object.freeze({ kind: "unavailable", reason });
+}
+function unavailable(reason) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code: reason },
+        messages: Object.freeze([
+            Object.freeze({
+                code: reason,
+                level: "error",
+                message: markdownLintUnavailableMessage(reason)
+            })
+        ])
+    });
+}
+function appendRejected(result, rejectedInputCount) {
+    if (rejectedInputCount === 0)
+        return result;
+    return Object.freeze({
+        ...result,
+        messages: Object.freeze([
+            ...(result.messages ?? []),
+            Object.freeze({
+                code: "input-rejected",
+                level: "warning",
+                message: `${rejectedInputCount} selected markdownLint input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`
+            })
+        ])
+    });
+}
+//# sourceMappingURL=execution.mjs.map

package/dist/esm/package-checks/markdown-lint/execution.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\nimport { realpath } from \"node:fs/promises\";\n\nimport type { CheckExecutionContext, CheckResult } from \"../../check/check.ts\";\nimport { appendCheckMessages } from \"../../package-tools/finding-presentation/finding-presentation.ts\";\nimport { reconcileFindingWaivers } from \"../../package-tools/finding-waivers/reconciliation.ts\";\nimport { reportFindingWaiverAudits } from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport { collectProjectFiles } from \"../project-files/collection.ts\";\nimport { partitionProjectFilesByEligibility } from \"../project-files/input-eligibility.ts\";\nimport {\n probeRootContainedPath,\n readRegularFile\n} from \"../markdown-link-validation/filesystem-probes.ts\";\nimport { isRootRelativePath } from \"../markdown-link-validation/local-resolution.ts\";\nimport type { MarkdownLintBackendFinding } from \"./adapter.ts\";\nimport type { MarkdownLintFinalData } from \"./final-data.ts\";\nimport { lintMarkdownWithCache } from \"./findings-cache.ts\";\nimport { markdownLintFindingMessages, markdownLintWaiverMessages } from \"./finding-messages.ts\";\nimport type { ResolvedMarkdownLintOptions } from \"./options.ts\";\nimport { validMarkdownLintOptions } from \"./options-validation.ts\";\nimport {\n buildMarkdownLintInputRejectedRecord,\n markdownLintFindingIdentity,\n markdownLintWaiverAuditRecord,\n orderedMarkdownLintCandidates,\n type MarkdownLintRecordCandidate\n} from \"./records.ts\";\nimport {\n markdownLintUnavailableMessage,\n type MarkdownLintUnavailableReason\n} from \"./unavailable-reasons.ts\";\n\nexport type { MarkdownLintUnavailableReason } from \"./unavailable-reasons.ts\";\n\nexport const MARKDOWN_LINT_CHECK_DEFINITION = {\n checkId: \"markdown-lint\",\n displayName: \"Markdown lint\"\n} as const;\n\ntype Traversal =\n | Readonly<{\n readonly kind: \"complete\";\n readonly candidates: readonly MarkdownLintRecordCandidate[];\n readonly sourceFileCount: number;\n }>\n | Readonly<{ readonly kind: \"unavailable\"; readonly reason: MarkdownLintUnavailableReason }>;\n\n/** Executes one bounded, ordered lint pass over the exact selected Markdown source paths. */\nexport async function executeMarkdownLint(\n context: CheckExecutionContext<ResolvedMarkdownLintOptions>\n): Promise<CheckResult<MarkdownLintFinalData>> {\n return validMarkdownLintOptions(context.options)\n ? executeResolvedMarkdownLint(context)\n : unavailable(\"invalid-options\");\n}\n\nasync function executeResolvedMarkdownLint(\n context: CheckExecutionContext<ResolvedMarkdownLintOptions>\n): Promise<CheckResult<MarkdownLintFinalData>> {\n if (context.signal.aborted) return unavailable(\"cancelled\");\n const discovered = discoverSources(context);\n if (discovered.kind === \"unavailable\") return unavailable(discovered.reason);\n if (discovered.selectedPathCount === 0) {\n return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n }\n for (const rejectedPath of discovered.rejectedPaths) {\n const record = buildMarkdownLintInputRejectedRecord(rejectedPath);\n context.records.report({ id: record.id }, record.data);\n }\n const root = await canonicalProjectRoot(context.project.root);\n if (root === undefined) return unavailable(\"project-root-unavailable\");\n const traversal = await traverseSources(\n discovered.sourcePaths,\n root,\n context.options,\n context.signal\n );\n if (traversal.kind === \"unavailable\")\n return appendRejected(unavailable(traversal.reason), discovered.rejectedPaths.length);\n if (context.signal.aborted)\n return appendRejected(unavailable(\"cancelled\"), discovered.rejectedPaths.length);\n return publishMarkdownLintTraversal(context, traversal, discovered.rejectedPaths);\n}\n\n/** Reconciles only a complete traversal, then publishes all evidence and the live policy outcome. */\nexport function publishMarkdownLintTraversal(\n context: CheckExecutionContext<ResolvedMarkdownLintOptions>,\n traversal: Extract<Traversal, { readonly kind: \"complete\" }>,\n rejectedPaths: readonly string[]\n): CheckResult<MarkdownLintFinalData> {\n const reconciliation = reconcileFindingWaivers({\n findings: traversal.candidates,\n identify: markdownLintFindingIdentity,\n waivers: context.options.findingWaivers\n });\n const actionable: MarkdownLintRecordCandidate[] = [];\n for (const finding of reconciliation.findings) {\n const data =\n finding.disposition === \"waived\"\n ? Object.freeze({\n ...finding.finding.data,\n waiver: Object.freeze({ reason: finding.waiver.reason })\n })\n : finding.finding.data;\n context.records.report({ id: finding.finding.id }, data);\n if (finding.disposition !== \"waived\") actionable.push(finding.finding);\n }\n reportFindingWaiverAudits(context, reconciliation, markdownLintWaiverAuditRecord);\n const findingCount = traversal.candidates.length + rejectedPaths.length;\n const blocking = context.options.findingPolicy === \"blocking\";\n const result: CheckResult<MarkdownLintFinalData> = Object.freeze({\n status: actionable.length > 0 && blocking ? \"failed\" : \"passed\",\n data: Object.freeze({\n sourceFileCount: traversal.sourceFileCount,\n findingCount,\n rejectedInputCount: rejectedPaths.length\n })\n });\n return appendCheckMessages(result, [\n ...markdownLintFindingMessages(\n actionable,\n rejectedPaths,\n // Preserve legacy summaries without waivers; fully waived lint must not make rejected-input summaries errors.\n blocking && (reconciliation.waiverAudits.length === 0 || actionable.length > 0)\n ),\n ...markdownLintWaiverMessages(reconciliation)\n ]);\n}\n\nfunction discoverSources(context: CheckExecutionContext<ResolvedMarkdownLintOptions>):\n | Readonly<{\n readonly kind: \"complete\";\n readonly sourcePaths: readonly string[];\n readonly rejectedPaths: readonly string[];\n readonly selectedPathCount: number;\n }>\n | Readonly<{ readonly kind: \"unavailable\"; readonly reason: \"source-unavailable\" }> {\n try {\n const selectedPaths = collectProjectFiles(context.project.root, context.options.files);\n const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownPath);\n return Object.freeze({\n kind: \"complete\" as const,\n sourcePaths: partition.acceptedPaths,\n rejectedPaths: partition.rejectedPaths,\n selectedPathCount: selectedPaths.length\n });\n } catch {\n return Object.freeze({ kind: \"unavailable\" as const, reason: \"source-unavailable\" as const });\n }\n}\n\nasync function canonicalProjectRoot(projectRoot: string): Promise<string | undefined> {\n try {\n return await realpath(projectRoot);\n } catch {\n return undefined;\n }\n}\n\nasync function traverseSources(\n sourcePaths: readonly string[],\n rootPath: string,\n options: ResolvedMarkdownLintOptions,\n signal: AbortSignal\n): Promise<Traversal> {\n const rawFindings: Array<\n Readonly<{ readonly path: string; readonly finding: MarkdownLintBackendFinding }>\n > = [];\n let sourceFileCount = 0;\n for (const sourcePath of sourcePaths) {\n if (signal.aborted) return unavailableTraversal(\"cancelled\");\n const source = await readMarkdownSource(rootPath, sourcePath, options.limits.maxMarkdownBytes);\n if (!source.ok) return unavailableTraversal(source.reason);\n const text = source.text;\n if (signal.aborted) return unavailableTraversal(\"cancelled\");\n const linted = await lintMarkdownWithCache({\n sourcePath,\n sourceText: text,\n rules: options.rules,\n cache: options.cache,\n signal\n });\n const findings = typeof linted === \"string\" ? linted : linted.findings;\n if (typeof findings === \"string\") return unavailableTraversal(findings);\n if (signal.aborted) return unavailableTraversal(\"cancelled\");\n sourceFileCount += 1;\n for (const finding of findings) rawFindings.push(Object.freeze({ path: sourcePath, finding }));\n if (rawFindings.length > options.limits.maxFindings)\n return unavailableTraversal(\"finding-limit-exceeded\");\n }\n return Object.freeze({\n kind: \"complete\" as const,\n candidates: orderedMarkdownLintCandidates(rawFindings, options.rules),\n sourceFileCount\n });\n}\n\nasync function readMarkdownSource(\n rootPath: string,\n rootRelativePath: string,\n maxBytes: number\n): Promise<\n | Readonly<{ readonly ok: true; readonly text: string }>\n | Readonly<{ readonly ok: false; readonly reason: \"source-too-large\" | \"source-unavailable\" }>\n> {\n if (!isRootRelativePath(rootPath, rootRelativePath))\n return Object.freeze({ ok: false, reason: \"source-unavailable\" });\n const candidatePath = path.resolve(rootPath, rootRelativePath);\n const probe = await probeRootContainedPath(rootPath, candidatePath);\n if (probe.kind !== \"contained\") return Object.freeze({ ok: false, reason: \"source-unavailable\" });\n const source = await readRegularFile(probe.absolutePath, maxBytes);\n if (!source.ok)\n return Object.freeze({\n ok: false,\n reason: source.reason === \"too-large\" ? \"source-too-large\" : \"source-unavailable\"\n });\n try {\n return Object.freeze({\n ok: true as const,\n text: new TextDecoder(\"utf-8\", { fatal: true }).decode(source.bytes)\n });\n } catch {\n return Object.freeze({ ok: false, reason: \"source-unavailable\" });\n }\n}\n\nfunction isMarkdownPath(filePath: string): boolean {\n const extension = path.extname(filePath).toLowerCase();\n return extension === \".md\" || extension === \".markdown\";\n}\n\nfunction unavailableTraversal(reason: MarkdownLintUnavailableReason): Traversal {\n return Object.freeze({ kind: \"unavailable\" as const, reason });\n}\n\nfunction unavailable(reason: MarkdownLintUnavailableReason): CheckResult<MarkdownLintFinalData> {\n return Object.freeze({\n status: \"unavailable\",\n reason: { code: reason },\n messages: Object.freeze([\n Object.freeze({\n code: reason,\n level: \"error\" as const,\n message: markdownLintUnavailableMessage(reason)\n })\n ])\n });\n}\n\nfunction appendRejected(\n result: CheckResult<MarkdownLintFinalData>,\n rejectedInputCount: number\n): CheckResult<MarkdownLintFinalData> {\n if (rejectedInputCount === 0) return result;\n return Object.freeze({\n ...result,\n messages: Object.freeze([\n ...(result.messages ?? []),\n Object.freeze({\n code: \"input-rejected\",\n level: \"warning\" as const,\n message: `${rejectedInputCount} selected markdownLint input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`\n })\n ])\n });\n}\n"]}