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

@zxyycom/vibe-check 0.0.1 → 0.0.2

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

Files changed (950) hide show

package/dist/esm/package-checks/markdown-link-validation/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,qCAAqC,CAAC;AAG3E,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 \"../../check/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/options-resolution.mjs CHANGED Viewed

@@ -1,5 +1,5 @@
 import { canonicalizeJsonObject } from "../../data-boundary/canonical-data.mjs";
-import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { hasExactPlainRecordKeys, hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
 import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
 import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
 import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
@@ -21,14 +21,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 = resolvedCache(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 +41,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,11 +56,28 @@ function isMarkdownLinkValidationInput(input) {
                 "validateCrossDocumentAnchors",
                 "rootExternalTargetMode",
                 "requireNonEmptyDirectories",
+                "cache",
                 "limits"
             ],
             required: []
         }));
 }
+function resolvedCache(value) {
+    if (value === undefined)
+        return Object.freeze({ enabled: false });
+    const cache = snapshotClosedRecord(value);
+    if (cache === undefined)
+        return undefined;
+    if (hasExactPlainRecordKeys(cache, ["enabled"]) && cache.enabled === false) {
+        return Object.freeze({ enabled: false });
+    }
+    if (hasExactPlainRecordKeys(cache, ["enabled", "directory"]) &&
+        cache.enabled === true &&
+        typeof cache.directory === "string") {
+        return Object.freeze({ enabled: true, directory: cache.directory });
+    }
+    return undefined;
+}
 function resolvedFiles(value) {
     return value === undefined
         ? snapshotProjectFileSelection(DEFAULT_FILES)

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 hasExactPlainRecordKeys,\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 const cache = resolvedCache(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 resolvedCache(value: unknown): ResolvedMarkdownLinkValidationOptions[\"cache\"] \| undefined {\n if (value === undefined) return Object.freeze({ enabled: false as const });\n const cache = snapshotClosedRecord(value);\n if (cache === undefined) return undefined;\n if (hasExactPlainRecordKeys(cache, [\"enabled\"]) && cache.enabled === false) {\n return Object.freeze({ enabled: false as const });\n }\n if (\n hasExactPlainRecordKeys(cache, [\"enabled\", \"directory\"]) &&\n cache.enabled === true &&\n typeof cache.directory === \"string\"\n ) {\n return Object.freeze({ enabled: true as const, directory: cache.directory });\n }\n return undefined;\n}\n\nfunction resolvedFiles(value: unknown) {\n return value === undefined\n ? snapshotProjectFileSelection(DEFAULT_FILES)\n : resolveProjectFileSelection(value, DEFAULT_FILES);\n}\n\nfunction resolvedLimits(value: unknown): Readonly<Record<string, unknown>> \| undefined {\n if (value === undefined) return DEFAULT_LIMITS;\n const limits = snapshotClosedRecord(value);\n if (\n limits === undefined \|\|\n !hasRequiredAndOptionalRecordKeys(limits, {\n optional: [\"maxMarkdownBytes\", \"maxOccurrences\", \"maxTargetReads\"],\n required: []\n })\n ) {\n return undefined;\n }\n return Object.freeze({\n maxMarkdownBytes:\n limits.maxMarkdownBytes === undefined\n ? DEFAULT_LIMITS.maxMarkdownBytes\n : limits.maxMarkdownBytes,\n maxOccurrences:\n limits.maxOccurrences === undefined ? DEFAULT_LIMITS.maxOccurrences : limits.maxOccurrences,\n maxTargetReads:\n limits.maxTargetReads === undefined ? DEFAULT_LIMITS.maxTargetReads : limits.maxTargetReads\n });\n}\n"]}

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

@@ -1,18 +1,13 @@
-import { hasExactPlainRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isAbsolute } from "node:path";
+import { snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { validProjectFileSelection } from "../project-files/configuration.mjs";
 import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
-function exactRecord(value, keys) {
-    const record = snapshotClosedRecord(value);
-    return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;
-}
-function positiveSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
 function boundedPositiveSafeInteger(value, maximum) {
-    return positiveSafeInteger(value) && value <= maximum;
+    return isPositiveSafeInteger(value) && value <= maximum;
 }
 export function validMarkdownLinkValidationOptions(value) {
-    const options = exactRecord(value, [
+    const options = snapshotExactClosedRecord(value, [
         "files",
         "findingPolicy",
         "requireExistingTargets",
@@ -20,6 +15,7 @@ export function validMarkdownLinkValidationOptions(value) {
         "validateCrossDocumentAnchors",
         "rootExternalTargetMode",
         "requireNonEmptyDirectories",
+        "cache",
         "limits"
     ]);
     return options !== undefined && validOptionFields(options);
@@ -28,8 +24,21 @@ function validOptionFields(options) {
     return (validProjectFileSelection(options.files) &&
         validFindingPolicy(options.findingPolicy) &&
         validAnchorValidationOptions(options) &&
+        validMarkdownLinkCache(options.cache) &&
         validMarkdownLinkLimits(options.limits));
 }
+function validMarkdownLinkCache(value) {
+    const disabled = snapshotExactClosedRecord(value, ["enabled"]);
+    if (disabled !== undefined && disabled.enabled === false)
+        return true;
+    const enabled = snapshotExactClosedRecord(value, ["enabled", "directory"]);
+    return (enabled !== undefined &&
+        enabled.enabled === true &&
+        typeof enabled.directory === "string" &&
+        enabled.directory.length > 0 &&
+        !enabled.directory.includes("\0") &&
+        isAbsolute(enabled.directory));
+}
 function validAnchorValidationOptions(options) {
     return (typeof options.requireExistingTargets === "boolean" &&
         typeof options.validateSameDocumentAnchors === "boolean" &&
@@ -41,7 +50,11 @@ function validRootExternalTargetMode(value) {
     return value === "ignore" || value === "report" || value === "validate";
 }
 function validMarkdownLinkLimits(value) {
-    const limits = exactRecord(value, ["maxMarkdownBytes", "maxOccurrences", "maxTargetReads"]);
+    const limits = snapshotExactClosedRecord(value, [
+        "maxMarkdownBytes",
+        "maxOccurrences",
+        "maxTargetReads"
+    ]);
     return (limits !== undefined &&
         boundedPositiveSafeInteger(limits.maxMarkdownBytes, 16_777_216) &&
         boundedPositiveSafeInteger(limits.maxOccurrences, 100_000) &&

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

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

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

	@@ -1 +1 @@
1	- {"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n ProjectFileSelection,\n ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\n\nexport type MarkdownRootExternalTargetMode = \"ignore\" \| \"report\" \| \"validate\";\n\n/** 可省略的 Markdown validation work limits。 /\nexport interface MarkdownLinkValidationLimitOptions {\n readonly maxMarkdownBytes?: number;\n readonly maxOccurrences?: number;\n readonly maxTargetReads?: number;\n}\n\n/* `markdownLinkValidation(options?)` 接受的可省略 authoring policy。 /\nexport interface MarkdownLinkValidationOptions {\n /* 参与本 Check 的 Markdown source selection；省略字段使用 package defaults。 /\n readonly files?: ProjectFileSelectionOptions;\n /* local-reference finding 是否使本 Check failed；省略时为 non-blocking。 /\n readonly findingPolicy?: FindingPolicy;\n /* `false` 时缺失的本地文件或目录不构成 finding。 /\n readonly requireExistingTargets?: boolean;\n /* 是否检查 `#anchor` 对当前 Markdown 文档标题的引用。 /\n readonly validateSameDocumentAnchors?: boolean;\n /* 是否检查直接指向的 Markdown 文件中的 `#anchor`。 /\n readonly validateCrossDocumentAnchors?: boolean;\n /* root 外本机目标的授权模式；不授权网络请求。 /\n readonly rootExternalTargetMode?: MarkdownRootExternalTargetMode;\n /* 是否将空目录目标视为 finding。 /\n readonly requireNonEmptyDirectories?: boolean;\n /* 每次运行的 Markdown 内容、occurrence 和 direct target work 上限。 /\n readonly limits?: MarkdownLinkValidationLimitOptions;\n}\n\n/* `markdown-link-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedMarkdownLinkValidationOptions {\n readonly files: ProjectFileSelection;\n readonly findingPolicy: FindingPolicy;\n readonly requireExistingTargets: boolean;\n readonly validateSameDocumentAnchors: boolean;\n readonly validateCrossDocumentAnchors: boolean;\n readonly rootExternalTargetMode: MarkdownRootExternalTargetMode;\n readonly requireNonEmptyDirectories: boolean;\n readonly limits: Readonly<{\n readonly maxMarkdownBytes: number;\n readonly maxOccurrences: number;\n readonly maxTargetReads: number;\n }>;\n}\n"]}
1	+ {"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n ProjectFileSelection,\n ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\n\nexport type MarkdownRootExternalTargetMode = \"ignore\" \| \"report\" \| \"validate\";\n\n/** 调用方显式拥有的 Link-private parse-facts local cache policy。 /\ntype MarkdownLinkValidationCacheOptions =\n \| Readonly<{ readonly enabled: false }>\n \| Readonly<{\n readonly enabled: true;\n readonly directory: string;\n }>;\n\n/* 可省略的 Markdown validation work limits。 /\nexport interface MarkdownLinkValidationLimitOptions {\n readonly maxMarkdownBytes?: number;\n readonly maxOccurrences?: number;\n readonly maxTargetReads?: number;\n}\n\n/* `markdownLinkValidation(options?)` 接受的可省略 authoring policy。 /\nexport interface MarkdownLinkValidationOptions {\n /* 参与本 Check 的 Markdown source selection；省略字段使用 package defaults。 /\n readonly files?: ProjectFileSelectionOptions;\n /* local-reference finding 是否使本 Check failed；省略时为 non-blocking。 /\n readonly findingPolicy?: FindingPolicy;\n /* `false` 时缺失的本地文件或目录不构成 finding。 /\n readonly requireExistingTargets?: boolean;\n /* 是否检查 `#anchor` 对当前 Markdown 文档标题的引用。 /\n readonly validateSameDocumentAnchors?: boolean;\n /* 是否检查直接指向的 Markdown 文件中的 `#anchor`。 /\n readonly validateCrossDocumentAnchors?: boolean;\n /* root 外本机目标的授权模式；不授权网络请求。 /\n readonly rootExternalTargetMode?: MarkdownRootExternalTargetMode;\n /* 是否将空目录目标视为 finding。 /\n readonly requireNonEmptyDirectories?: boolean;\n /* 每次运行的 Markdown 内容、occurrence 和 direct target work 上限。 /\n readonly limits?: MarkdownLinkValidationLimitOptions;\n /\n 显式启用的、调用方拥有的 Link parse-facts persistent cache。省略时关闭；enabled directory 必须 absolute、可信且可删除。\n * 本 Check 只在其中使用 `markdown-link-parse-facts-v1.jsonl` 保存 source-derived facts；调用方负责容量和删除，且不提供\n * confidentiality、automatic cleanup、concurrency 或 durability guarantees。cache 不可用时 fresh-parse，Check 结果不变。\n /\n readonly cache?: MarkdownLinkValidationCacheOptions;\n}\n\n/* `markdown-link-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedMarkdownLinkValidationOptions {\n readonly files: ProjectFileSelection;\n readonly findingPolicy: FindingPolicy;\n readonly requireExistingTargets: boolean;\n readonly validateSameDocumentAnchors: boolean;\n readonly validateCrossDocumentAnchors: boolean;\n readonly rootExternalTargetMode: MarkdownRootExternalTargetMode;\n readonly requireNonEmptyDirectories: boolean;\n readonly cache: MarkdownLinkValidationCacheOptions;\n readonly limits: Readonly<{\n readonly maxMarkdownBytes: number;\n readonly maxOccurrences: number;\n readonly maxTargetReads: number;\n }>;\n}\n"]}

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

@@ -0,0 +1,185 @@
+import { createHash } from "node:crypto";
+import { snapshotClosedArray, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { canonicalJsonText } from "../../data-boundary/canonical-data.mjs";
+import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
+const CACHE_FORMAT_VERSION = "markdown-link-parse-facts-jsonl-v1";
+const CACHE_PAYLOAD_VERSION = "1";
+/** Version the resolver memo and persistent identity share when parser facts change. */
+export const MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION = "mdast-gfm-frontmatter-github-slug-v1";
+const MAX_FACTS_PER_DOCUMENT = 100_000;
+const MAX_FACT_STRING_LENGTH = 16_777_216;
+/**
+ * Serializes one complete Link-private JSONL envelope from immutable parser facts.
+ * The session owns when this line is appended; this codec owns its shape and identity.
+ */
+export function cacheEnvelopeLine(identityDigest, facts) {
+    return `${canonicalJsonText({
+        cacheFormatVersion: CACHE_FORMAT_VERSION,
+        identityDigest,
+        parserContractVersion: MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION,
+        payloadVersion: CACHE_PAYLOAD_VERSION,
+        payload: projectMarkdownLinkParseFactsPayload(facts)
+    })}\n`;
+}
+/** Restores one complete, current-version JSONL envelope or rejects it as a cache miss. */
+export function parseCacheEnvelopeLine(line) {
+    try {
+        const envelope = snapshotExactClosedRecord(JSON.parse(line), [
+            "cacheFormatVersion",
+            "identityDigest",
+            "parserContractVersion",
+            "payloadVersion",
+            "payload"
+        ]);
+        if (!isCurrentCacheEnvelope(envelope))
+            return undefined;
+        return Object.freeze({
+            identityDigest: envelope.identityDigest,
+            facts: parseMarkdownLinkParseFactsPayload(envelope.payload)
+        });
+    }
+    catch {
+        return undefined;
+    }
+}
+/** SHA-256 identity over the current, exact authorized Markdown bytes. */
+export function markdownBytesDigest(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+/** Converts parser-owned immutable facts to the closed persistent JSON payload. */
+export function projectMarkdownLinkParseFactsPayload(facts) {
+    return Object.freeze({
+        occurrences: Object.freeze(facts.occurrences.map((occurrence) => Object.freeze({
+            kind: occurrence.kind,
+            rawDestination: occurrence.rawDestination,
+            range: projectSourceRange(occurrence.range)
+        }))),
+        headings: Object.freeze(facts.headings.map((heading) => Object.freeze({ slug: heading.slug, range: projectSourceRange(heading.range) })))
+    });
+}
+/** Strictly restores the Link-private persistent JSON payload to immutable parser facts. */
+export function parseMarkdownLinkParseFactsPayload(value) {
+    const payload = snapshotExactClosedRecord(value, ["occurrences", "headings"]);
+    if (payload === undefined)
+        throw new TypeError("Markdown Link cache payload must be closed");
+    const occurrences = parseOccurrences(payload.occurrences);
+    const headings = parseHeadings(payload.headings);
+    if (occurrences === undefined || headings === undefined) {
+        throw new TypeError("Markdown Link cache payload contains invalid parse facts");
+    }
+    return Object.freeze({ occurrences, headings });
+}
+function isCurrentCacheEnvelope(envelope) {
+    return (envelope !== undefined &&
+        envelope.cacheFormatVersion === CACHE_FORMAT_VERSION &&
+        validIdentityDigest(envelope.identityDigest) &&
+        envelope.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&
+        envelope.payloadVersion === CACHE_PAYLOAD_VERSION);
+}
+function validIdentityDigest(value) {
+    return typeof value === "string" && /^[a-f0-9]{64}$/u.test(value);
+}
+function parseOccurrences(value) {
+    const values = boundedPayloadArray(value);
+    if (values === undefined)
+        return undefined;
+    const occurrences = [];
+    for (const candidate of values) {
+        const occurrence = snapshotExactClosedRecord(candidate, ["kind", "rawDestination", "range"]);
+        if (occurrence === undefined ||
+            (occurrence.kind !== "image" && occurrence.kind !== "link") ||
+            !validFactString(occurrence.rawDestination)) {
+            return undefined;
+        }
+        const range = parseSourceRange(occurrence.range);
+        if (range === undefined)
+            return undefined;
+        occurrences.push(Object.freeze({ kind: occurrence.kind, rawDestination: occurrence.rawDestination, range }));
+    }
+    return Object.freeze(occurrences);
+}
+function parseHeadings(value) {
+    const values = boundedPayloadArray(value);
+    if (values === undefined)
+        return undefined;
+    const headings = [];
+    for (const candidate of values) {
+        const heading = snapshotExactClosedRecord(candidate, ["slug", "range"]);
+        if (heading === undefined || !validFactString(heading.slug))
+            return undefined;
+        const range = parseSourceRange(heading.range);
+        if (range === undefined)
+            return undefined;
+        headings.push(Object.freeze({ slug: heading.slug, range }));
+    }
+    return Object.freeze(headings);
+}
+function boundedPayloadArray(value) {
+    const values = snapshotClosedArray(value);
+    return values !== undefined && values.length <= MAX_FACTS_PER_DOCUMENT ? values : undefined;
+}
+function validFactString(value) {
+    return (typeof value === "string" &&
+        value.length <= MAX_FACT_STRING_LENGTH &&
+        !hasUnpairedSurrogate(value));
+}
+function parseSourceRange(value) {
+    const range = snapshotExactClosedRecord(value, ["startOffset", "endOffset", "start", "end"]);
+    if (range === undefined ||
+        !boundedNonNegativeSafeInteger(range.startOffset) ||
+        !boundedNonNegativeSafeInteger(range.endOffset) ||
+        range.endOffset < range.startOffset) {
+        return undefined;
+    }
+    const start = parseSourcePosition(range.start);
+    const end = parseSourcePosition(range.end);
+    if (start === undefined || end === undefined || !sourcePositionFollows(end, start)) {
+        return undefined;
+    }
+    return Object.freeze({ startOffset: range.startOffset, endOffset: range.endOffset, start, end });
+}
+function sourcePositionFollows(end, start) {
+    return end.line > start.line || (end.line === start.line && end.column >= start.column);
+}
+function parseSourcePosition(value) {
+    const position = snapshotExactClosedRecord(value, ["line", "column"]);
+    if (position === undefined ||
+        !boundedPositiveSafeInteger(position.line) ||
+        !boundedPositiveSafeInteger(position.column)) {
+        return undefined;
+    }
+    return Object.freeze({ line: position.line, column: position.column });
+}
+function projectSourceRange(range) {
+    return Object.freeze({
+        startOffset: range.startOffset,
+        endOffset: range.endOffset,
+        start: Object.freeze({ line: range.start.line, column: range.start.column }),
+        end: Object.freeze({ line: range.end.line, column: range.end.column })
+    });
+}
+function boundedNonNegativeSafeInteger(value) {
+    return (typeof value === "number" &&
+        Number.isSafeInteger(value) &&
+        value >= 0 &&
+        value <= MAX_FACT_STRING_LENGTH);
+}
+function boundedPositiveSafeInteger(value) {
+    return isPositiveSafeInteger(value) && value <= MAX_FACT_STRING_LENGTH + 1;
+}
+function hasUnpairedSurrogate(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {
+            const nextCodeUnit = value.charCodeAt(index + 1);
+            if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff))
+                return true;
+            index += 1;
+            continue;
+        }
+        if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=parse-facts-cache-payload.mjs.map

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

@@ -0,0 +1 @@

+ {"version":3,"file":"parse-facts-cache-payload.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/parse-facts-cache-payload.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport {\n snapshotClosedArray,\n snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport type {\n MarkdownHeading,\n MarkdownLinkOccurrence,\n MarkdownSourcePosition,\n MarkdownSourceRange,\n ParsedMarkdownLinkFacts\n} from \"./markdown-parser.ts\";\n\nconst CACHE_FORMAT_VERSION = \"markdown-link-parse-facts-jsonl-v1\";\nconst CACHE_PAYLOAD_VERSION = \"1\";\n/** Version the resolver memo and persistent identity share when parser facts change. */\nexport const MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION =\n \"mdast-gfm-frontmatter-github-slug-v1\";\nconst MAX_FACTS_PER_DOCUMENT = 100_000;\nconst MAX_FACT_STRING_LENGTH = 16_777_216;\n\ntype MarkdownLinkParseFactsPayload = Readonly<{\n readonly occurrences: readonly MarkdownLinkOccurrence[];\n readonly headings: readonly MarkdownHeading[];\n}>;\n\n/**\n * Serializes one complete Link-private JSONL envelope from immutable parser facts.\n * The session owns when this line is appended; this codec owns its shape and identity.\n */\nexport function cacheEnvelopeLine(identityDigest: string, facts: ParsedMarkdownLinkFacts): string {\n return `${canonicalJsonText({\n cacheFormatVersion: CACHE_FORMAT_VERSION,\n identityDigest,\n parserContractVersion: MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION,\n payloadVersion: CACHE_PAYLOAD_VERSION,\n payload: projectMarkdownLinkParseFactsPayload(facts)\n })}\\n`;\n}\n\n/** Restores one complete, current-version JSONL envelope or rejects it as a cache miss. */\nexport function parseCacheEnvelopeLine(\n line: string\n):\n | Readonly<{ readonly identityDigest: string; readonly facts: ParsedMarkdownLinkFacts }>\n | undefined {\n try {\n const envelope = snapshotExactClosedRecord(JSON.parse(line), [\n \"cacheFormatVersion\",\n \"identityDigest\",\n \"parserContractVersion\",\n \"payloadVersion\",\n \"payload\"\n ]);\n if (!isCurrentCacheEnvelope(envelope)) return undefined;\n return Object.freeze({\n identityDigest: envelope.identityDigest,\n facts: parseMarkdownLinkParseFactsPayload(envelope.payload)\n });\n } catch {\n return undefined;\n }\n}\n\n/** SHA-256 identity over the current, exact authorized Markdown bytes. */\nexport function markdownBytesDigest(bytes: Uint8Array): string {\n return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\n/** Converts parser-owned immutable facts to the closed persistent JSON payload. */\nexport function projectMarkdownLinkParseFactsPayload(\n facts: ParsedMarkdownLinkFacts\n): MarkdownLinkParseFactsPayload {\n return Object.freeze({\n occurrences: Object.freeze(\n facts.occurrences.map((occurrence) =>\n Object.freeze({\n kind: occurrence.kind,\n rawDestination: occurrence.rawDestination,\n range: projectSourceRange(occurrence.range)\n })\n )\n ),\n headings: Object.freeze(\n facts.headings.map((heading) =>\n Object.freeze({ slug: heading.slug, range: projectSourceRange(heading.range) })\n )\n )\n });\n}\n\n/** Strictly restores the Link-private persistent JSON payload to immutable parser facts. */\nexport function parseMarkdownLinkParseFactsPayload(value: unknown): ParsedMarkdownLinkFacts {\n const payload = snapshotExactClosedRecord(value, [\"occurrences\", \"headings\"]);\n if (payload === undefined) throw new TypeError(\"Markdown Link cache payload must be closed\");\n const occurrences = parseOccurrences(payload.occurrences);\n const headings = parseHeadings(payload.headings);\n if (occurrences === undefined || headings === undefined) {\n throw new TypeError(\"Markdown Link cache payload contains invalid parse facts\");\n }\n return Object.freeze({ occurrences, headings });\n}\n\nfunction isCurrentCacheEnvelope(\n envelope: Readonly<Record<string, unknown>> | undefined\n): envelope is Readonly<{\n readonly identityDigest: string;\n readonly payload: unknown;\n}> {\n return (\n envelope !== undefined &&\n envelope.cacheFormatVersion === CACHE_FORMAT_VERSION &&\n validIdentityDigest(envelope.identityDigest) &&\n envelope.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&\n envelope.payloadVersion === CACHE_PAYLOAD_VERSION\n );\n}\n\nfunction validIdentityDigest(value: unknown): value is string {\n return typeof value === \"string\" && /^[a-f0-9]{64}$/u.test(value);\n}\n\nfunction parseOccurrences(value: unknown): readonly MarkdownLinkOccurrence[] | undefined {\n const values = boundedPayloadArray(value);\n if (values === undefined) return undefined;\n const occurrences: MarkdownLinkOccurrence[] = [];\n for (const candidate of values) {\n const occurrence = snapshotExactClosedRecord(candidate, [\"kind\", \"rawDestination\", \"range\"]);\n if (\n occurrence === undefined ||\n (occurrence.kind !== \"image\" && occurrence.kind !== \"link\") ||\n !validFactString(occurrence.rawDestination)\n ) {\n return undefined;\n }\n const range = parseSourceRange(occurrence.range);\n if (range === undefined) return undefined;\n occurrences.push(\n Object.freeze({ kind: occurrence.kind, rawDestination: occurrence.rawDestination, range })\n );\n }\n return Object.freeze(occurrences);\n}\n\nfunction parseHeadings(value: unknown): readonly MarkdownHeading[] | undefined {\n const values = boundedPayloadArray(value);\n if (values === undefined) return undefined;\n const headings: MarkdownHeading[] = [];\n for (const candidate of values) {\n const heading = snapshotExactClosedRecord(candidate, [\"slug\", \"range\"]);\n if (heading === undefined || !validFactString(heading.slug)) return undefined;\n const range = parseSourceRange(heading.range);\n if (range === undefined) return undefined;\n headings.push(Object.freeze({ slug: heading.slug, range }));\n }\n return Object.freeze(headings);\n}\n\nfunction boundedPayloadArray(value: unknown): readonly unknown[] | undefined {\n const values = snapshotClosedArray(value);\n return values !== undefined && values.length <= MAX_FACTS_PER_DOCUMENT ? values : undefined;\n}\n\nfunction validFactString(value: unknown): value is string {\n return (\n typeof value === \"string\" &&\n value.length <= MAX_FACT_STRING_LENGTH &&\n !hasUnpairedSurrogate(value)\n );\n}\n\nfunction parseSourceRange(value: unknown): MarkdownSourceRange | undefined {\n const range = snapshotExactClosedRecord(value, [\"startOffset\", \"endOffset\", \"start\", \"end\"]);\n if (\n range === undefined ||\n !boundedNonNegativeSafeInteger(range.startOffset) ||\n !boundedNonNegativeSafeInteger(range.endOffset) ||\n range.endOffset < range.startOffset\n ) {\n return undefined;\n }\n const start = parseSourcePosition(range.start);\n const end = parseSourcePosition(range.end);\n if (start === undefined || end === undefined || !sourcePositionFollows(end, start)) {\n return undefined;\n }\n return Object.freeze({ startOffset: range.startOffset, endOffset: range.endOffset, start, end });\n}\n\nfunction sourcePositionFollows(\n end: MarkdownSourcePosition,\n start: MarkdownSourcePosition\n): boolean {\n return end.line > start.line || (end.line === start.line && end.column >= start.column);\n}\n\nfunction parseSourcePosition(value: unknown): MarkdownSourcePosition | undefined {\n const position = snapshotExactClosedRecord(value, [\"line\", \"column\"]);\n if (\n position === undefined ||\n !boundedPositiveSafeInteger(position.line) ||\n !boundedPositiveSafeInteger(position.column)\n ) {\n return undefined;\n }\n return Object.freeze({ line: position.line, column: position.column });\n}\n\nfunction projectSourceRange(range: MarkdownSourceRange): MarkdownSourceRange {\n return Object.freeze({\n startOffset: range.startOffset,\n endOffset: range.endOffset,\n start: Object.freeze({ line: range.start.line, column: range.start.column }),\n end: Object.freeze({ line: range.end.line, column: range.end.column })\n });\n}\n\nfunction boundedNonNegativeSafeInteger(value: unknown): value is number {\n return (\n typeof value === \"number\" &&\n Number.isSafeInteger(value) &&\n value >= 0 &&\n value <= MAX_FACT_STRING_LENGTH\n );\n}\n\nfunction boundedPositiveSafeInteger(value: unknown): value is number {\n return isPositiveSafeInteger(value) && value <= MAX_FACT_STRING_LENGTH + 1;\n}\n\nfunction hasUnpairedSurrogate(value: string): boolean {\n for (let index = 0; index < value.length; index += 1) {\n const codeUnit = value.charCodeAt(index);\n if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n const nextCodeUnit = value.charCodeAt(index + 1);\n if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) return true;\n index += 1;\n continue;\n }\n if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) return true;\n }\n return false;\n}\n"]}