@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/package-checks/markdown-lint/final-data.mjs

@@ -0,0 +1,16 @@
+import { exactFinalDataRecord, invalidFinalData, nonNegativeSafeInteger } from "../final-data-parsing.mjs";
+/** 解析并验证 `markdownLint` 完成结果中的 canonical final data。 */
+export function parseMarkdownLintData(data) {
+    const value = exactFinalDataRecord(data, ["sourceFileCount", "findingCount", "rejectedInputCount"], "markdownLint");
+    const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);
+    const findingCount = nonNegativeSafeInteger(value.findingCount);
+    const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);
+    if (sourceFileCount === undefined ||
+        findingCount === undefined ||
+        rejectedInputCount === undefined ||
+        findingCount < rejectedInputCount) {
+        throw invalidFinalData("markdownLint");
+    }
+    return Object.freeze({ sourceFileCount, findingCount, rejectedInputCount });
+}
+//# sourceMappingURL=final-data.mjs.map

package/dist/esm/package-checks/markdown-lint/final-data.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AASlC,wDAAwD;AACxD,MAAM,UAAU,qBAAqB,CAAC,IAAa;IACjD,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EACzD,cAAc,CACf,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,YAAY,GAAG,kBAAkB,EACjC,CAAC;QACD,MAAM,gBAAgB,CAAC,cAAc,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,EAAE,YAAY,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAC9E,CAAC","sourcesContent":["import {\n  exactFinalDataRecord,\n  invalidFinalData,\n  nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** 已完成 `markdownLint` execution 的 canonical final data。 */\nexport interface MarkdownLintFinalData {\n  readonly sourceFileCount: number;\n  readonly findingCount: number;\n  readonly rejectedInputCount: number;\n}\n\n/** 解析并验证 `markdownLint` 完成结果中的 canonical final data。 */\nexport function parseMarkdownLintData(data: unknown): MarkdownLintFinalData {\n  const value = exactFinalDataRecord(\n    data,\n    [\"sourceFileCount\", \"findingCount\", \"rejectedInputCount\"],\n    \"markdownLint\"\n  );\n  const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n  const findingCount = nonNegativeSafeInteger(value.findingCount);\n  const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n  if (\n    sourceFileCount === undefined ||\n    findingCount === undefined ||\n    rejectedInputCount === undefined ||\n    findingCount < rejectedInputCount\n  ) {\n    throw invalidFinalData(\"markdownLint\");\n  }\n  return Object.freeze({ sourceFileCount, findingCount, rejectedInputCount });\n}\n"]}

package/dist/esm/package-checks/markdown-lint/finding-messages.mjs

@@ -0,0 +1,72 @@
+import { presentCheckFindings } from "../../package-tools/finding-presentation/finding-presentation.mjs";
+import { markdownLintWaiverIdentity } from "./records.mjs";
+const SUMMARY = {
+    "heading-increment": "heading levels may increase by only one level",
+    "no-reversed-links": "reversed link syntax is not supported",
+    "no-missing-space-atx": "ATX heading markers require a following space",
+    "fenced-code-language": "fenced code blocks require a language",
+    "no-empty-links": "links require a non-empty destination",
+    "no-alt-text": "images require alternative text",
+    "link-fragments": "same-document fragments must match a heading",
+    "reference-links-images": "reference links and images require a definition",
+    "table-column-count": "pipe table rows must have a consistent column count"
+};
+export function markdownLintFindingMessages(candidates, rejectedPaths, blocking) {
+    const findings = [
+        ...candidates.map((candidate) => Object.freeze({ kind: "lint", candidate })),
+        ...rejectedPaths.map((path) => Object.freeze({ kind: "rejected", path }))
+    ];
+    return presentCheckFindings({
+        findings,
+        limit: 10,
+        message: (finding) => {
+            if (finding.kind === "rejected") {
+                return Object.freeze({
+                    code: "finding-detail",
+                    level: "warning",
+                    message: `${finding.path}: selected input is not a supported Markdown source.`
+                });
+            }
+            const { path, range, rule } = finding.candidate.data;
+            return Object.freeze({
+                code: "finding-detail",
+                level: blocking ? "error" : "warning",
+                message: `${path}:${range.start.line}:${range.start.column} ${rule}: ${SUMMARY[rule]}.`
+            });
+        },
+        omittedMessage: ({ omittedCount }) => Object.freeze({
+            code: "findings-omitted",
+            level: blocking ? "error" : "warning",
+            message: `${omittedCount} additional Markdown lint finding(s) were not shown; inspect this Check's Records for the complete set.`
+        })
+    });
+}
+/** Explains every configured waiver without turning accepted findings into error messages. */
+export function markdownLintWaiverMessages(reconciliation) {
+    return Object.freeze(reconciliation.waiverAudits.map(markdownLintWaiverMessage));
+}
+function markdownLintWaiverMessage(audit) {
+    const { path, rule, range } = markdownLintWaiverIdentity(audit.waiver);
+    const subject = `${path}:${range.start.line}:${range.start.column}-${range.end.column} ${rule}`;
+    switch (audit.status) {
+        case "applied":
+            return Object.freeze({
+                code: "finding-waived",
+                level: "info",
+                message: `Markdown lint finding for ${subject} was waived: ${audit.waiver.reason}`
+            });
+        case "unused":
+            return Object.freeze({
+                code: "unused-finding-waiver",
+                level: "warning",
+                message: `Configured markdown-lint finding waiver for ${subject} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`
+            });
+        case "overmatched":
+            return Object.freeze({
+                code: "overmatched-finding-waiver",
+                level: "warning",
+                message: `Configured markdown-lint finding waiver for ${subject} matched ${audit.matchCount} findings and was not applied; inspect the duplicate identities. Reason: ${audit.waiver.reason}`
+            });
+    }
+}
+//# sourceMappingURL=finding-messages.mjs.map

package/dist/esm/package-checks/markdown-lint/finding-messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/finding-messages.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../package-tools/finding-presentation/finding-presentation.ts\";\nimport type {\n  FindingWaiverAudit,\n  FindingWaiverReconciliation\n} from \"../../package-tools/finding-waivers/reconciliation.ts\";\nimport { markdownLintWaiverIdentity, type MarkdownLintRecordCandidate } from \"./records.ts\";\n\nconst SUMMARY: Readonly<Record<MarkdownLintRecordCandidate[\"data\"][\"rule\"], string>> = {\n  \"heading-increment\": \"heading levels may increase by only one level\",\n  \"no-reversed-links\": \"reversed link syntax is not supported\",\n  \"no-missing-space-atx\": \"ATX heading markers require a following space\",\n  \"fenced-code-language\": \"fenced code blocks require a language\",\n  \"no-empty-links\": \"links require a non-empty destination\",\n  \"no-alt-text\": \"images require alternative text\",\n  \"link-fragments\": \"same-document fragments must match a heading\",\n  \"reference-links-images\": \"reference links and images require a definition\",\n  \"table-column-count\": \"pipe table rows must have a consistent column count\"\n};\n\nexport function markdownLintFindingMessages(\n  candidates: readonly MarkdownLintRecordCandidate[],\n  rejectedPaths: readonly string[],\n  blocking: boolean\n): readonly CheckMessage[] {\n  const findings = [\n    ...candidates.map((candidate) => Object.freeze({ kind: \"lint\" as const, candidate })),\n    ...rejectedPaths.map((path) => Object.freeze({ kind: \"rejected\" as const, path }))\n  ];\n  return presentCheckFindings({\n    findings,\n    limit: 10,\n    message: (finding) => {\n      if (finding.kind === \"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 { path, range, rule } = finding.candidate.data;\n      return Object.freeze({\n        code: \"finding-detail\",\n        level: blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `${path}:${range.start.line}:${range.start.column} ${rule}: ${SUMMARY[rule]}.`\n      });\n    },\n    omittedMessage: ({ omittedCount }) =>\n      Object.freeze({\n        code: \"findings-omitted\",\n        level: blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `${omittedCount} additional Markdown lint finding(s) were not shown; inspect this Check's Records for the complete set.`\n      })\n  });\n}\n\n/** Explains every configured waiver without turning accepted findings into error messages. */\nexport function markdownLintWaiverMessages(\n  reconciliation: FindingWaiverReconciliation<MarkdownLintRecordCandidate>\n): readonly CheckMessage[] {\n  return Object.freeze(reconciliation.waiverAudits.map(markdownLintWaiverMessage));\n}\n\nfunction markdownLintWaiverMessage(audit: FindingWaiverAudit): CheckMessage {\n  const { path, rule, range } = markdownLintWaiverIdentity(audit.waiver);\n  const subject = `${path}:${range.start.line}:${range.start.column}-${range.end.column} ${rule}`;\n  switch (audit.status) {\n    case \"applied\":\n      return Object.freeze({\n        code: \"finding-waived\",\n        level: \"info\",\n        message: `Markdown lint finding for ${subject} was waived: ${audit.waiver.reason}`\n      });\n    case \"unused\":\n      return Object.freeze({\n        code: \"unused-finding-waiver\",\n        level: \"warning\",\n        message: `Configured markdown-lint finding waiver for ${subject} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`\n      });\n    case \"overmatched\":\n      return Object.freeze({\n        code: \"overmatched-finding-waiver\",\n        level: \"warning\",\n        message: `Configured markdown-lint finding waiver for ${subject} matched ${audit.matchCount} findings and was not applied; inspect the duplicate identities. Reason: ${audit.waiver.reason}`\n      });\n  }\n}\n"]}

package/dist/esm/package-checks/markdown-lint/finding-waiver-identity.mjs

@@ -0,0 +1,41 @@
+import { snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
+import { isNormalizedProjectRelativePath } from "../host-environment/path.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+/** Validates and detaches the complete public location used for exact waiver matching. */
+export function resolveMarkdownLintFindingIdentity(value) {
+    const identity = snapshotExactClosedRecord(value, ["path", "rule", "range"]);
+    if (identity === undefined ||
+        !isNormalizedProjectRelativePath(identity.path) ||
+        !isMarkdownLintRuleName(identity.rule)) {
+        return undefined;
+    }
+    const range = snapshotExactClosedRecord(identity.range, ["start", "end"]);
+    if (range === undefined)
+        return undefined;
+    const start = resolvePosition(range.start);
+    const end = resolvePosition(range.end);
+    if (start === undefined ||
+        end === undefined ||
+        start.line !== end.line ||
+        end.column < start.column) {
+        return undefined;
+    }
+    return Object.freeze({
+        path: identity.path,
+        rule: identity.rule,
+        range: Object.freeze({ start, end })
+    });
+}
+function resolvePosition(value) {
+    const position = snapshotExactClosedRecord(value, ["line", "column"]);
+    return position !== undefined &&
+        isPositiveSafeInteger(position.line) &&
+        isPositiveSafeInteger(position.column)
+        ? Object.freeze({ line: position.line, column: position.column })
+        : undefined;
+}
+function isMarkdownLintRuleName(value) {
+    return typeof value === "string" && MARKDOWN_LINT_RULE_NAMES.some((rule) => rule === value);
+}
+//# sourceMappingURL=finding-waiver-identity.mjs.map

package/dist/esm/package-checks/markdown-lint/finding-waiver-identity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-waiver-identity.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/finding-waiver-identity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,EACL,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AAEtB,0FAA0F;AAC1F,MAAM,UAAU,kCAAkC,CAChD,KAAc;IAEd,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7E,IACE,QAAQ,KAAK,SAAS;QACtB,CAAC,+BAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/C,CAAC,sBAAsB,CAAC,QAAQ,CAAC,IAAI,CAAC,EACtC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GAAG,yBAAyB,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;IAC1E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,IACE,KAAK,KAAK,SAAS;QACnB,GAAG,KAAK,SAAS;QACjB,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,IAAI;QACvB,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,EACzB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;KACrC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAAc;IAEd,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,OAAO,QAAQ,KAAK,SAAS;QAC3B,qBAAqB,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpC,qBAAqB,CAAC,QAAQ,CAAC,MAAM,CAAC;QACtC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACjE,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;AAC9F,CAAC","sourcesContent":["import { snapshotExactClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { isNormalizedProjectRelativePath } from \"../host-environment/path.ts\";\nimport {\n  MARKDOWN_LINT_RULE_NAMES,\n  type MarkdownLintFindingIdentity,\n  type MarkdownLintRuleName\n} from \"./options.ts\";\n\n/** Validates and detaches the complete public location used for exact waiver matching. */\nexport function resolveMarkdownLintFindingIdentity(\n  value: unknown\n): MarkdownLintFindingIdentity | undefined {\n  const identity = snapshotExactClosedRecord(value, [\"path\", \"rule\", \"range\"]);\n  if (\n    identity === undefined ||\n    !isNormalizedProjectRelativePath(identity.path) ||\n    !isMarkdownLintRuleName(identity.rule)\n  ) {\n    return undefined;\n  }\n  const range = snapshotExactClosedRecord(identity.range, [\"start\", \"end\"]);\n  if (range === undefined) return undefined;\n  const start = resolvePosition(range.start);\n  const end = resolvePosition(range.end);\n  if (\n    start === undefined ||\n    end === undefined ||\n    start.line !== end.line ||\n    end.column < start.column\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    path: identity.path,\n    rule: identity.rule,\n    range: Object.freeze({ start, end })\n  });\n}\n\nfunction resolvePosition(\n  value: unknown\n): MarkdownLintFindingIdentity[\"range\"][\"start\"] | undefined {\n  const position = snapshotExactClosedRecord(value, [\"line\", \"column\"]);\n  return position !== undefined &&\n    isPositiveSafeInteger(position.line) &&\n    isPositiveSafeInteger(position.column)\n    ? Object.freeze({ line: position.line, column: position.column })\n    : undefined;\n}\n\nfunction isMarkdownLintRuleName(value: unknown): value is MarkdownLintRuleName {\n  return typeof value === \"string\" && MARKDOWN_LINT_RULE_NAMES.some((rule) => rule === value);\n}\n"]}

package/dist/esm/package-checks/markdown-lint/findings-cache.mjs

@@ -0,0 +1,110 @@
+import { createHash } from "node:crypto";
+import { createRequire } from "node:module";
+import { snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { cacheJsonByKey } from "../../package-tools/cache/cache-json-by-key.mjs";
+import { lintMarkdownString, parseMarkdownLintRange } from "./adapter.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+/** Bump when adapter configuration or finding interpretation changes without a backend version change. */
+const CACHE_FORMAT_VERSION = "markdown-lint-findings-v1";
+const backendVersion = installedMarkdownlintVersion();
+class LintComputationUnavailable extends Error {
+    reason;
+    constructor(reason) {
+        super(`Markdown lint unavailable: ${reason}`);
+        this.reason = reason;
+    }
+}
+/** Reuses only validated per-source findings; all source reads and Check settlement remain live. */
+export async function lintMarkdownWithCache(input) {
+    const { sourcePath, sourceText, rules, cache, signal } = input;
+    if (signal.aborted)
+        return "cancelled";
+    if (!cache.enabled || backendVersion === undefined)
+        return lintFresh(input);
+    try {
+        const result = await cacheJsonByKey({
+            directory: cache.directory,
+            key: JSON.stringify({
+                path: sourcePath,
+                sourceDigest: createHash("sha256").update(sourceText, "utf8").digest("hex"),
+                rules
+            }),
+            namespace: "markdown-lint-findings",
+            version: `${CACHE_FORMAT_VERSION}:${backendVersion}`,
+            compute: async () => {
+                if (signal.aborted)
+                    throw new LintComputationUnavailable("cancelled");
+                const findings = await lintMarkdownString(sourcePath, sourceText, rules);
+                if (typeof findings === "string")
+                    throw new LintComputationUnavailable(findings);
+                if (signal.aborted)
+                    throw new LintComputationUnavailable("cancelled");
+                return { findings };
+            },
+            parse: (value) => parseLintFacts(value, sourceText, rules)
+        });
+        if (signal.aborted)
+            return "cancelled";
+        return Object.freeze({ findings: result.value.findings, source: result.source });
+    }
+    catch (error) {
+        if (signal.aborted)
+            return "cancelled";
+        if (error instanceof LintComputationUnavailable)
+            return error.reason;
+        throw error;
+    }
+}
+async function lintFresh(input) {
+    const findings = await lintMarkdownString(input.sourcePath, input.sourceText, input.rules);
+    if (input.signal.aborted)
+        return "cancelled";
+    return typeof findings === "string"
+        ? findings
+        : Object.freeze({ findings, source: "uncached" });
+}
+function parseLintFacts(value, sourceText, rules) {
+    const payload = snapshotExactClosedRecord(value, ["findings"]);
+    if (payload === undefined || !Array.isArray(payload.findings))
+        throw new TypeError("Invalid Markdown lint cache payload");
+    const lines = sourceText.split(/\r\n|\r|\n/u);
+    const findings = payload.findings.map((rawFinding) => {
+        const finding = snapshotExactClosedRecord(rawFinding, ["lineNumber", "range", "rule"]);
+        if (finding === undefined ||
+            !isMarkdownLintRuleName(finding.rule) ||
+            !rules.includes(finding.rule) ||
+            typeof finding.lineNumber !== "number" ||
+            !Number.isSafeInteger(finding.lineNumber) ||
+            finding.lineNumber < 1 ||
+            finding.lineNumber > lines.length)
+            throw new TypeError("Invalid Markdown lint cached finding");
+        const line = lines[finding.lineNumber - 1];
+        if (line === undefined)
+            throw new TypeError("Invalid Markdown lint cached line");
+        const range = parseMarkdownLintRange(finding.range, line);
+        if (range === undefined)
+            throw new TypeError("Invalid Markdown lint cached range");
+        return Object.freeze({
+            lineNumber: finding.lineNumber,
+            range,
+            rule: finding.rule
+        });
+    });
+    return Object.freeze({ findings: Object.freeze(findings) });
+}
+function isMarkdownLintRuleName(value) {
+    return typeof value === "string" && MARKDOWN_LINT_RULE_NAMES.some((rule) => rule === value);
+}
+function installedMarkdownlintVersion() {
+    try {
+        const packageJson = createRequire(import.meta.url)("markdownlint/package.json");
+        const metadata = snapshotClosedRecord(packageJson);
+        return typeof metadata?.version === "string" && metadata.version.length > 0
+            ? metadata.version
+            : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=findings-cache.mjs.map

package/dist/esm/package-checks/markdown-lint/findings-cache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"findings-cache.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/findings-cache.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { createRequire } from \"node:module\";\n\nimport {\n  snapshotClosedRecord,\n  snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { cacheJsonByKey } from \"../../package-tools/cache/cache-json-by-key.ts\";\nimport {\n  lintMarkdownString,\n  parseMarkdownLintRange,\n  type MarkdownLintBackendFinding\n} from \"./adapter.ts\";\nimport {\n  MARKDOWN_LINT_RULE_NAMES,\n  type MarkdownLintCacheOptions,\n  type MarkdownLintRuleName\n} from \"./options.ts\";\nimport type { MarkdownLintUnavailableReason } from \"./unavailable-reasons.ts\";\n\ntype LintFacts = Readonly<{ readonly findings: readonly MarkdownLintBackendFinding[] }>;\ntype MarkdownLintCacheInput = Readonly<{\n  readonly sourcePath: string;\n  readonly sourceText: string;\n  readonly rules: readonly MarkdownLintRuleName[];\n  readonly cache: MarkdownLintCacheOptions;\n  readonly signal: AbortSignal;\n}>;\nexport type MarkdownLintFactsResult =\n  | Readonly<{\n      readonly findings: readonly MarkdownLintBackendFinding[];\n      readonly source: \"cache\" | \"computed\" | \"uncached\";\n    }>\n  | MarkdownLintUnavailableReason;\n\n/** Bump when adapter configuration or finding interpretation changes without a backend version change. */\nconst CACHE_FORMAT_VERSION = \"markdown-lint-findings-v1\";\nconst backendVersion = installedMarkdownlintVersion();\n\nclass LintComputationUnavailable extends Error {\n  readonly reason: MarkdownLintUnavailableReason;\n\n  constructor(reason: MarkdownLintUnavailableReason) {\n    super(`Markdown lint unavailable: ${reason}`);\n    this.reason = reason;\n  }\n}\n\n/** Reuses only validated per-source findings; all source reads and Check settlement remain live. */\nexport async function lintMarkdownWithCache(\n  input: MarkdownLintCacheInput\n): Promise<MarkdownLintFactsResult> {\n  const { sourcePath, sourceText, rules, cache, signal } = input;\n  if (signal.aborted) return \"cancelled\";\n  if (!cache.enabled || backendVersion === undefined) return lintFresh(input);\n\n  try {\n    const result = await cacheJsonByKey({\n      directory: cache.directory,\n      key: JSON.stringify({\n        path: sourcePath,\n        sourceDigest: createHash(\"sha256\").update(sourceText, \"utf8\").digest(\"hex\"),\n        rules\n      }),\n      namespace: \"markdown-lint-findings\",\n      version: `${CACHE_FORMAT_VERSION}:${backendVersion}`,\n      compute: async () => {\n        if (signal.aborted) throw new LintComputationUnavailable(\"cancelled\");\n        const findings = await lintMarkdownString(sourcePath, sourceText, rules);\n        if (typeof findings === \"string\") throw new LintComputationUnavailable(findings);\n        if (signal.aborted) throw new LintComputationUnavailable(\"cancelled\");\n        return { findings };\n      },\n      parse: (value) => parseLintFacts(value, sourceText, rules)\n    });\n    if (signal.aborted) return \"cancelled\";\n    return Object.freeze({ findings: result.value.findings, source: result.source });\n  } catch (error: unknown) {\n    if (signal.aborted) return \"cancelled\";\n    if (error instanceof LintComputationUnavailable) return error.reason;\n    throw error;\n  }\n}\n\nasync function lintFresh(input: MarkdownLintCacheInput): Promise<MarkdownLintFactsResult> {\n  const findings = await lintMarkdownString(input.sourcePath, input.sourceText, input.rules);\n  if (input.signal.aborted) return \"cancelled\";\n  return typeof findings === \"string\"\n    ? findings\n    : Object.freeze({ findings, source: \"uncached\" as const });\n}\n\nfunction parseLintFacts(\n  value: unknown,\n  sourceText: string,\n  rules: readonly MarkdownLintRuleName[]\n): LintFacts {\n  const payload = snapshotExactClosedRecord(value, [\"findings\"]);\n  if (payload === undefined || !Array.isArray(payload.findings))\n    throw new TypeError(\"Invalid Markdown lint cache payload\");\n  const lines = sourceText.split(/\\r\\n|\\r|\\n/u);\n  const findings = payload.findings.map((rawFinding: unknown) => {\n    const finding = snapshotExactClosedRecord(rawFinding, [\"lineNumber\", \"range\", \"rule\"]);\n    if (\n      finding === undefined ||\n      !isMarkdownLintRuleName(finding.rule) ||\n      !rules.includes(finding.rule) ||\n      typeof finding.lineNumber !== \"number\" ||\n      !Number.isSafeInteger(finding.lineNumber) ||\n      finding.lineNumber < 1 ||\n      finding.lineNumber > lines.length\n    )\n      throw new TypeError(\"Invalid Markdown lint cached finding\");\n    const line = lines[finding.lineNumber - 1];\n    if (line === undefined) throw new TypeError(\"Invalid Markdown lint cached line\");\n    const range = parseMarkdownLintRange(finding.range, line);\n    if (range === undefined) throw new TypeError(\"Invalid Markdown lint cached range\");\n    return Object.freeze({\n      lineNumber: finding.lineNumber,\n      range,\n      rule: finding.rule\n    });\n  });\n  return Object.freeze({ findings: Object.freeze(findings) });\n}\n\nfunction isMarkdownLintRuleName(value: unknown): value is MarkdownLintRuleName {\n  return typeof value === \"string\" && MARKDOWN_LINT_RULE_NAMES.some((rule) => rule === value);\n}\n\nfunction installedMarkdownlintVersion(): string | undefined {\n  try {\n    const packageJson: unknown = createRequire(import.meta.url)(\"markdownlint/package.json\");\n    const metadata = snapshotClosedRecord(packageJson);\n    return typeof metadata?.version === \"string\" && metadata.version.length > 0\n      ? metadata.version\n      : undefined;\n  } catch {\n    return undefined;\n  }\n}\n"]}

package/dist/esm/package-checks/markdown-lint/options-resolution.mjs

@@ -0,0 +1,74 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, 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 { resolveFindingWaiverAuthoring } from "../code-quality-findings/finding-waiver-authoring.mjs";
+import { resolveOptionalLocalCacheOptions } from "../local-cache-options.mjs";
+import { resolveMarkdownLintFindingIdentity } from "./finding-waiver-identity.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+import { validMarkdownLintOptions } from "./options-validation.mjs";
+const DEFAULT_FILES = Object.freeze({
+    exclude: defaultProjectFileSelection.exclude,
+    include: Object.freeze(["**/*.[mM][dD]", "**/*.[mM][aA][rR][kK][dD][oO][wW][nN]"]),
+    source: defaultProjectFileSelection.source
+});
+const DEFAULT_LIMITS = Object.freeze({ maxMarkdownBytes: 1_048_576, maxFindings: 10_000 });
+const DEFAULT_RULES = Object.freeze(MARKDOWN_LINT_RULE_NAMES.filter((rule) => rule !== "link-fragments"));
+const KNOWN_RULES = new Set(MARKDOWN_LINT_RULE_NAMES);
+/** Resolves closed partial authoring options into an immutable complete policy. */
+export function resolveMarkdownLintOptions(value) {
+    const input = snapshotClosedRecord(value);
+    if (input === undefined ||
+        !hasRequiredAndOptionalRecordKeys(input, {
+            optional: ["files", "findingPolicy", "findingWaivers", "rules", "limits", "cache"],
+            required: []
+        })) {
+        return undefined;
+    }
+    const files = input.files === undefined
+        ? snapshotProjectFileSelection(DEFAULT_FILES)
+        : resolveProjectFileSelection(input.files, DEFAULT_FILES);
+    const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
+    const findingWaivers = resolveFindingWaiverAuthoring(input.findingWaivers, resolveMarkdownLintFindingIdentity);
+    const rules = resolveRules(input.rules);
+    const limits = resolveLimits(input.limits);
+    const cache = resolveOptionalLocalCacheOptions(input.cache);
+    const candidate = Object.freeze({
+        files,
+        findingPolicy,
+        findingWaivers,
+        rules,
+        limits,
+        cache
+    });
+    return validMarkdownLintOptions(candidate) ? candidate : undefined;
+}
+function resolveRules(value) {
+    if (value === undefined)
+        return DEFAULT_RULES;
+    const rules = snapshotClosedArray(value);
+    if (rules === undefined ||
+        rules.length === 0 ||
+        !rules.every((rule) => typeof rule === "string" && KNOWN_RULES.has(rule)) ||
+        new Set(rules).size !== rules.length) {
+        return undefined;
+    }
+    return Object.freeze(MARKDOWN_LINT_RULE_NAMES.filter((catalogRule) => rules.includes(catalogRule)));
+}
+function resolveLimits(value) {
+    if (value === undefined)
+        return DEFAULT_LIMITS;
+    const limits = snapshotClosedRecord(value);
+    if (limits === undefined ||
+        !hasRequiredAndOptionalRecordKeys(limits, {
+            optional: ["maxMarkdownBytes", "maxFindings"],
+            required: []
+        })) {
+        return undefined;
+    }
+    const maxMarkdownBytes = limits.maxMarkdownBytes ?? DEFAULT_LIMITS.maxMarkdownBytes;
+    const maxFindings = limits.maxFindings ?? DEFAULT_LIMITS.maxFindings;
+    if (typeof maxMarkdownBytes !== "number" || typeof maxFindings !== "number")
+        return undefined;
+    return Object.freeze({ maxMarkdownBytes, maxFindings });
+}
+//# sourceMappingURL=options-resolution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedArray,\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 { resolveFindingWaiverAuthoring } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { resolveOptionalLocalCacheOptions } from \"../local-cache-options.ts\";\nimport { resolveMarkdownLintFindingIdentity } from \"./finding-waiver-identity.ts\";\nimport {\n  MARKDOWN_LINT_RULE_NAMES,\n  type MarkdownLintRuleName,\n  type ResolvedMarkdownLintOptions\n} from \"./options.ts\";\nimport { validMarkdownLintOptions } from \"./options-validation.ts\";\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});\nconst DEFAULT_LIMITS = Object.freeze({ maxMarkdownBytes: 1_048_576, maxFindings: 10_000 });\nconst DEFAULT_RULES = Object.freeze(\n  MARKDOWN_LINT_RULE_NAMES.filter((rule) => rule !== \"link-fragments\")\n);\nconst KNOWN_RULES = new Set<string>(MARKDOWN_LINT_RULE_NAMES);\n\n/** Resolves closed partial authoring options into an immutable complete policy. */\nexport function resolveMarkdownLintOptions(\n  value: unknown\n): ResolvedMarkdownLintOptions | undefined {\n  const input = snapshotClosedRecord(value);\n  if (\n    input === undefined ||\n    !hasRequiredAndOptionalRecordKeys(input, {\n      optional: [\"files\", \"findingPolicy\", \"findingWaivers\", \"rules\", \"limits\", \"cache\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  const files =\n    input.files === undefined\n      ? snapshotProjectFileSelection(DEFAULT_FILES)\n      : resolveProjectFileSelection(input.files, DEFAULT_FILES);\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  const findingWaivers = resolveFindingWaiverAuthoring(\n    input.findingWaivers,\n    resolveMarkdownLintFindingIdentity\n  );\n  const rules = resolveRules(input.rules);\n  const limits = resolveLimits(input.limits);\n  const cache = resolveOptionalLocalCacheOptions(input.cache);\n  const candidate = Object.freeze({\n    files,\n    findingPolicy,\n    findingWaivers,\n    rules,\n    limits,\n    cache\n  });\n  return validMarkdownLintOptions(candidate) ? candidate : undefined;\n}\n\nfunction resolveRules(value: unknown): readonly MarkdownLintRuleName[] | undefined {\n  if (value === undefined) return DEFAULT_RULES;\n  const rules = snapshotClosedArray(value);\n  if (\n    rules === undefined ||\n    rules.length === 0 ||\n    !rules.every((rule) => typeof rule === \"string\" && KNOWN_RULES.has(rule)) ||\n    new Set(rules).size !== rules.length\n  ) {\n    return undefined;\n  }\n  return Object.freeze(\n    MARKDOWN_LINT_RULE_NAMES.filter((catalogRule) => rules.includes(catalogRule))\n  );\n}\n\nfunction resolveLimits(value: unknown): ResolvedMarkdownLintOptions[\"limits\"] | undefined {\n  if (value === undefined) return DEFAULT_LIMITS;\n  const limits = snapshotClosedRecord(value);\n  if (\n    limits === undefined ||\n    !hasRequiredAndOptionalRecordKeys(limits, {\n      optional: [\"maxMarkdownBytes\", \"maxFindings\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  const maxMarkdownBytes = limits.maxMarkdownBytes ?? DEFAULT_LIMITS.maxMarkdownBytes;\n  const maxFindings = limits.maxFindings ?? DEFAULT_LIMITS.maxFindings;\n  if (typeof maxMarkdownBytes !== \"number\" || typeof maxFindings !== \"number\") return undefined;\n  return Object.freeze({ maxMarkdownBytes, maxFindings });\n}\n"]}

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

@@ -0,0 +1,41 @@
+import { snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
+import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { validResolvedFindingWaivers } from "../code-quality-findings/finding-waiver-authoring.mjs";
+import { validLocalCacheOptions } from "../local-cache-options.mjs";
+import { validProjectFileSelection } from "../project-files/configuration.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+import { resolveMarkdownLintFindingIdentity } from "./finding-waiver-identity.mjs";
+const KNOWN_RULES = new Set(MARKDOWN_LINT_RULE_NAMES);
+export function validMarkdownLintOptions(value) {
+    const options = snapshotExactClosedRecord(value, [
+        "files",
+        "findingPolicy",
+        "findingWaivers",
+        "rules",
+        "limits",
+        "cache"
+    ]);
+    if (options === undefined ||
+        !validProjectFileSelection(options.files) ||
+        !validFindingPolicy(options.findingPolicy) ||
+        !validResolvedFindingWaivers(options.findingWaivers, resolveMarkdownLintFindingIdentity) ||
+        !validRules(options.rules) ||
+        !validLocalCacheOptions(options.cache)) {
+        return false;
+    }
+    const limits = snapshotExactClosedRecord(options.limits, ["maxMarkdownBytes", "maxFindings"]);
+    return (limits !== undefined &&
+        isBoundedPositiveInteger(limits.maxMarkdownBytes, 16_777_216) &&
+        isBoundedPositiveInteger(limits.maxFindings, 100_000));
+}
+function validRules(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((rule) => typeof rule === "string" && KNOWN_RULES.has(rule)) &&
+        new Set(value).size === value.length);
+}
+function isBoundedPositiveInteger(value, maximum) {
+    return isPositiveSafeInteger(value) && value <= maximum;
+}
+//# sourceMappingURL=options-validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,2BAA2B,EAAE,MAAM,sDAAsD,CAAC;AACnG,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAoC,MAAM,cAAc,CAAC;AAC1F,OAAO,EAAE,kCAAkC,EAAE,MAAM,8BAA8B,CAAC;AAElF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAS,wBAAwB,CAAC,CAAC;AAE9D,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,EAAE;QAC/C,OAAO;QACP,eAAe;QACf,gBAAgB;QAChB,OAAO;QACP,QAAQ;QACR,OAAO;KACR,CAAC,CAAC;IACH,IACE,OAAO,KAAK,SAAS;QACrB,CAAC,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC;QACzC,CAAC,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC;QAC1C,CAAC,2BAA2B,CAAC,OAAO,CAAC,cAAc,EAAE,kCAAkC,CAAC;QACxF,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC;QAC1B,CAAC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC,EACtC,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC,CAAC;IAC9F,OAAO,CACL,MAAM,KAAK,SAAS;QACpB,wBAAwB,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC;QAC7D,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,OAAO,CAAC,CACtD,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,MAAM,GAAG,CAAC;QAChB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACxE,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM,CACrC,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc,EAAE,OAAe;IAC/D,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC;AAC1D,CAAC","sourcesContent":["import { snapshotExactClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { validResolvedFindingWaivers } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { validLocalCacheOptions } from \"../local-cache-options.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { MARKDOWN_LINT_RULE_NAMES, type ResolvedMarkdownLintOptions } from \"./options.ts\";\nimport { resolveMarkdownLintFindingIdentity } from \"./finding-waiver-identity.ts\";\n\nconst KNOWN_RULES = new Set<string>(MARKDOWN_LINT_RULE_NAMES);\n\nexport function validMarkdownLintOptions(value: unknown): value is ResolvedMarkdownLintOptions {\n  const options = snapshotExactClosedRecord(value, [\n    \"files\",\n    \"findingPolicy\",\n    \"findingWaivers\",\n    \"rules\",\n    \"limits\",\n    \"cache\"\n  ]);\n  if (\n    options === undefined ||\n    !validProjectFileSelection(options.files) ||\n    !validFindingPolicy(options.findingPolicy) ||\n    !validResolvedFindingWaivers(options.findingWaivers, resolveMarkdownLintFindingIdentity) ||\n    !validRules(options.rules) ||\n    !validLocalCacheOptions(options.cache)\n  ) {\n    return false;\n  }\n  const limits = snapshotExactClosedRecord(options.limits, [\"maxMarkdownBytes\", \"maxFindings\"]);\n  return (\n    limits !== undefined &&\n    isBoundedPositiveInteger(limits.maxMarkdownBytes, 16_777_216) &&\n    isBoundedPositiveInteger(limits.maxFindings, 100_000)\n  );\n}\n\nfunction validRules(value: unknown): value is readonly string[] {\n  return (\n    Array.isArray(value) &&\n    value.length > 0 &&\n    value.every((rule) => typeof rule === \"string\" && KNOWN_RULES.has(rule)) &&\n    new Set(value).size === value.length\n  );\n}\n\nfunction isBoundedPositiveInteger(value: unknown, maximum: number): value is number {\n  return isPositiveSafeInteger(value) && value <= maximum;\n}\n"]}

package/dist/esm/package-checks/markdown-lint/options.mjs

@@ -0,0 +1,13 @@
+/** 由 Product 拥有且独立于 backend 名称的闭合 Markdown lint 规则目录。 */
+export const MARKDOWN_LINT_RULE_NAMES = Object.freeze([
+    "heading-increment",
+    "no-reversed-links",
+    "no-missing-space-atx",
+    "fenced-code-language",
+    "no-empty-links",
+    "no-alt-text",
+    "link-fragments",
+    "reference-links-images",
+    "table-column-count"
+]);
+//# sourceMappingURL=options.mjs.map

package/dist/esm/package-checks/markdown-lint/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/options.ts"],"names":[],"mappings":"AASA,yDAAyD;AACzD,MAAM,CAAC,MAAM,wBAAwB,GAAG,MAAM,CAAC,MAAM,CAAC;IACpD,mBAAmB;IACnB,mBAAmB;IACnB,sBAAsB;IACtB,sBAAsB;IACtB,gBAAgB;IAChB,aAAa;IACb,gBAAgB;IAChB,wBAAwB;IACxB,oBAAoB;CACZ,CAAC,CAAC","sourcesContent":["import type { PackageCheckAuthoringOptions } from \"../check-authoring.ts\";\nimport type { LocalCacheOptions } from \"../local-cache-options.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { FindingWaiver } from \"../../package-tools/finding-waivers/reconciliation.ts\";\nimport type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\n\n/** 由 Product 拥有且独立于 backend 名称的闭合 Markdown lint 规则目录。 */\nexport const MARKDOWN_LINT_RULE_NAMES = Object.freeze([\n  \"heading-increment\",\n  \"no-reversed-links\",\n  \"no-missing-space-atx\",\n  \"fenced-code-language\",\n  \"no-empty-links\",\n  \"no-alt-text\",\n  \"link-fragments\",\n  \"reference-links-images\",\n  \"table-column-count\"\n] as const);\n\n/** `markdownLint` 支持的稳定 Product-owned 规则名称。 */\nexport type MarkdownLintRuleName = (typeof MARKDOWN_LINT_RULE_NAMES)[number];\n\n/** 可直接从 lint Record 复制的精确身份；完整 range 相同的多个 Finding 不可唯一豁免。 */\nexport interface MarkdownLintFindingIdentity {\n  /** 规范化的 project-root-relative `/` 路径。 */\n  readonly path: string;\n  /** 闭合 Product catalog 中的规则名称。 */\n  readonly rule: MarkdownLintRuleName;\n  /** 一基 UTF-16 正安全整数位置；必须同行，end-exclusive column 不小于 start column。 */\n  readonly range: Readonly<{\n    readonly start: Readonly<{ readonly line: number; readonly column: number }>;\n    readonly end: Readonly<{ readonly line: number; readonly column: number }>;\n  }>;\n}\n\n/** 完整 traversal 后唯一匹配才应用的精确豁免；reason 会公开发布，不得包含秘密。 */\nexport type MarkdownLintFindingWaiver = FindingWaiver<MarkdownLintFindingIdentity>;\n\n/** `markdownLint(options?)` 可接受的可省略 work limits。 */\nexport interface MarkdownLintLimitOptions {\n  /** 单个 accepted Markdown source 的 UTF-8 字节上限。 */\n  readonly maxMarkdownBytes?: number;\n  /** 一次完整 traversal 中可积累的 lint finding 上限。 */\n  readonly maxFindings?: number;\n}\n\n/** 调用方拥有的逐文件 lint findings 本地缓存；省略时关闭。 */\nexport type MarkdownLintCacheOptions = LocalCacheOptions;\n\n/** `markdownLint(options?)` 可接受的闭合 authoring policy。 */\nexport interface MarkdownLintOptions<\n  Id extends string = string\n> extends PackageCheckAuthoringOptions<Id> {\n  /** 参与本 Check 的 source selection；省略时使用 package defaults。 */\n  readonly files?: ProjectFileSelectionOptions;\n  /** 未豁免 lint finding 是否使本 Check failed；省略时为 non-blocking。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 闭合的精确 Finding 豁免；保留原始证据，不改变输入、limits 或缓存 facts。 */\n  readonly findingWaivers?: readonly MarkdownLintFindingWaiver[];\n  /** 非空数组完整替换 recommended rule set。 */\n  readonly rules?: readonly MarkdownLintRuleName[];\n  /** 每次 execution 的 Markdown 内容与 finding work 上限。 */\n  readonly limits?: MarkdownLintLimitOptions;\n  /** 可删除、可信 absolute directory；只缓存由当前 bytes 和规则计算的逐文件 findings。 */\n  readonly cache?: MarkdownLintCacheOptions;\n}\n\n/** `markdown-lint` execution 消费的完整冻结 policy。 */\nexport interface ResolvedMarkdownLintOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly findingWaivers: readonly MarkdownLintFindingWaiver[];\n  readonly rules: readonly MarkdownLintRuleName[];\n  readonly cache: MarkdownLintCacheOptions;\n  readonly limits: Readonly<{\n    readonly maxMarkdownBytes: number;\n    readonly maxFindings: number;\n  }>;\n}\n"]}

package/dist/esm/package-checks/markdown-lint/records.mjs

@@ -0,0 +1,65 @@
+import { buildHashedFindingWaiverAuditRecord } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { resolveMarkdownLintFindingIdentity } from "./finding-waiver-identity.mjs";
+export function markdownLintFindingIdentity(candidate) {
+    const { path, rule, range } = candidate.data;
+    return Object.freeze({ path, rule, range });
+}
+export function markdownLintWaiverIdentity(waiver) {
+    const identity = resolveMarkdownLintFindingIdentity(waiver.identity);
+    if (identity === undefined) {
+        throw new TypeError("markdownLint waiver identity must retain a valid public finding location");
+    }
+    return identity;
+}
+export function markdownLintWaiverAuditRecord(audit) {
+    return buildHashedFindingWaiverAuditRecord(markdownLintWaiverIdentity(audit.waiver), audit);
+}
+export function orderedMarkdownLintCandidates(values, catalog) {
+    const rank = new Map(catalog.map((rule, index) => [rule, index]));
+    const sorted = [...values].sort((left, right) => compareFindings(left, right, rank));
+    const occurrences = new Map();
+    return Object.freeze(sorted.map(({ path, finding }) => {
+        const range = publicRange(finding);
+        const key = `${path}\u0000${finding.rule}\u0000${range.start.line}\u0000${range.start.column}`;
+        const ordinal = (occurrences.get(key) ?? 0) + 1;
+        occurrences.set(key, ordinal);
+        const data = Object.freeze({
+            kind: "lint-finding",
+            path,
+            rule: finding.rule,
+            range
+        });
+        return Object.freeze({
+            id: `path:${encodeURIComponent(path)}:rule:${finding.rule}:line:${range.start.line}:column:${range.start.column}:ordinal:${ordinal}`,
+            data
+        });
+    }));
+}
+export function buildMarkdownLintInputRejectedRecord(path) {
+    return Object.freeze({
+        id: `/input-rejected/${path}`,
+        data: Object.freeze({
+            kind: "input-rejected",
+            blocking: false,
+            path,
+            reason: "unsupported-file-type"
+        })
+    });
+}
+function compareFindings(left, right, rank) {
+    const leftRange = publicRange(left.finding);
+    const rightRange = publicRange(right.finding);
+    return (left.path.localeCompare(right.path) ||
+        leftRange.start.line - rightRange.start.line ||
+        leftRange.start.column - rightRange.start.column ||
+        (rank.get(left.finding.rule) ?? 0) - (rank.get(right.finding.rule) ?? 0));
+}
+function publicRange(finding) {
+    const column = finding.range?.[0] ?? 1;
+    const endColumn = finding.range === null ? column : column + finding.range[1];
+    return Object.freeze({
+        start: Object.freeze({ line: finding.lineNumber, column }),
+        end: Object.freeze({ line: finding.lineNumber, column: endColumn })
+    });
+}
+//# sourceMappingURL=records.mjs.map

package/dist/esm/package-checks/markdown-lint/records.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/records.ts"],"names":[],"mappings":"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","sourcesContent":["import type { MaterializedFindingWaiver } from \"../../package-tools/finding-waivers/reconciliation.ts\";\nimport {\n  buildHashedFindingWaiverAuditRecord,\n  type FindingWaiverAuditRecordData,\n  type FindingWaiverRecordAudit\n} from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport type { MarkdownLintBackendFinding } from \"./adapter.ts\";\nimport { resolveMarkdownLintFindingIdentity } from \"./finding-waiver-identity.ts\";\nimport type { MarkdownLintFindingIdentity, MarkdownLintRuleName } from \"./options.ts\";\n\n/** 一条保留原位置的 lint Finding；唯一命中 waiver 时仅附加公开理由。 */\nexport type MarkdownLintFindingRecordData = Readonly<\n  MarkdownLintFindingIdentity & {\n    readonly kind: \"lint-finding\";\n    readonly waiver?: Readonly<{ readonly reason: string }>;\n  }\n>;\n\n/** 未使用或匹配多个 Markdown lint Findings 的精确 waiver audit Record data。 */\nexport type MarkdownLintFindingWaiverAuditRecordData =\n  FindingWaiverAuditRecordData<MarkdownLintFindingIdentity>;\n\nexport type MarkdownLintInputRejectedRecordData = Readonly<{\n  readonly kind: \"input-rejected\";\n  readonly blocking: false;\n  readonly path: string;\n  readonly reason: \"unsupported-file-type\";\n}>;\n\n/** Markdown lint 发布的 Finding、input-rejection 或 finding-waiver audit Record data。 */\nexport type MarkdownLintRecordData =\n  | MarkdownLintFindingRecordData\n  | MarkdownLintInputRejectedRecordData\n  | MarkdownLintFindingWaiverAuditRecordData;\n\nexport interface MarkdownLintRecordCandidate {\n  readonly id: string;\n  readonly data: MarkdownLintFindingRecordData;\n}\n\nexport function markdownLintFindingIdentity(\n  candidate: MarkdownLintRecordCandidate\n): MarkdownLintFindingIdentity {\n  const { path, rule, range } = candidate.data;\n  return Object.freeze({ path, rule, range });\n}\n\nexport function markdownLintWaiverIdentity(\n  waiver: MaterializedFindingWaiver\n): MarkdownLintFindingIdentity {\n  const identity = resolveMarkdownLintFindingIdentity(waiver.identity);\n  if (identity === undefined) {\n    throw new TypeError(\"markdownLint waiver identity must retain a valid public finding location\");\n  }\n  return identity;\n}\n\nexport function markdownLintWaiverAuditRecord(audit: FindingWaiverRecordAudit): Readonly<{\n  readonly id: string;\n  readonly data: MarkdownLintFindingWaiverAuditRecordData;\n}> {\n  return buildHashedFindingWaiverAuditRecord(markdownLintWaiverIdentity(audit.waiver), audit);\n}\n\nexport function orderedMarkdownLintCandidates(\n  values: readonly Readonly<{\n    readonly path: string;\n    readonly finding: MarkdownLintBackendFinding;\n  }>[],\n  catalog: readonly MarkdownLintRuleName[]\n): readonly MarkdownLintRecordCandidate[] {\n  const rank = new Map(catalog.map((rule, index) => [rule, index]));\n  const sorted = [...values].sort((left, right) => compareFindings(left, right, rank));\n  const occurrences = new Map<string, number>();\n  return Object.freeze(\n    sorted.map(({ path, finding }) => {\n      const range = publicRange(finding);\n      const key = `${path}\\u0000${finding.rule}\\u0000${range.start.line}\\u0000${range.start.column}`;\n      const ordinal = (occurrences.get(key) ?? 0) + 1;\n      occurrences.set(key, ordinal);\n      const data = Object.freeze({\n        kind: \"lint-finding\" as const,\n        path,\n        rule: finding.rule,\n        range\n      });\n      return Object.freeze({\n        id: `path:${encodeURIComponent(path)}:rule:${finding.rule}:line:${range.start.line}:column:${range.start.column}:ordinal:${ordinal}`,\n        data\n      });\n    })\n  );\n}\n\nexport function buildMarkdownLintInputRejectedRecord(path: string): Readonly<{\n  readonly id: string;\n  readonly data: MarkdownLintInputRejectedRecordData;\n}> {\n  return Object.freeze({\n    id: `/input-rejected/${path}`,\n    data: Object.freeze({\n      kind: \"input-rejected\",\n      blocking: false,\n      path,\n      reason: \"unsupported-file-type\"\n    })\n  });\n}\n\nfunction compareFindings(\n  left: Readonly<{ readonly path: string; readonly finding: MarkdownLintBackendFinding }>,\n  right: Readonly<{ readonly path: string; readonly finding: MarkdownLintBackendFinding }>,\n  rank: ReadonlyMap<MarkdownLintRuleName, number>\n): number {\n  const leftRange = publicRange(left.finding);\n  const rightRange = publicRange(right.finding);\n  return (\n    left.path.localeCompare(right.path) ||\n    leftRange.start.line - rightRange.start.line ||\n    leftRange.start.column - rightRange.start.column ||\n    (rank.get(left.finding.rule) ?? 0) - (rank.get(right.finding.rule) ?? 0)\n  );\n}\n\nfunction publicRange(finding: MarkdownLintBackendFinding): MarkdownLintFindingRecordData[\"range\"] {\n  const column = finding.range?.[0] ?? 1;\n  const endColumn = finding.range === null ? column : column + finding.range[1];\n  return Object.freeze({\n    start: Object.freeze({ line: finding.lineNumber, column }),\n    end: Object.freeze({ line: finding.lineNumber, column: endColumn })\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-lint/unavailable-reasons.mjs

@@ -0,0 +1,14 @@
+const MESSAGES = {
+    "backend-failed": "Markdown lint could not complete its private backend operation; retry after checking the installed package.",
+    "backend-protocol-invalid": "Markdown lint received an invalid private backend response and did not publish partial findings.",
+    cancelled: "Markdown lint was cancelled before it could form a complete result; retry after cancellation is resolved.",
+    "finding-limit-exceeded": "Markdown lint exceeded maxFindings; narrow the file selection or raise the bounded limit.",
+    "invalid-options": "markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options.",
+    "project-root-unavailable": "Markdown lint could not resolve the project root; check that the path exists and is accessible.",
+    "source-too-large": "A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.",
+    "source-unavailable": "A selected Markdown source could not be read, decoded, or contained safely; check the file source and permissions."
+};
+export function markdownLintUnavailableMessage(reason) {
+    return MESSAGES[reason];
+}
+//# sourceMappingURL=unavailable-reasons.mjs.map

package/dist/esm/package-checks/markdown-lint/unavailable-reasons.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unavailable-reasons.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/unavailable-reasons.ts"],"names":[],"mappings":"AAWA,MAAM,QAAQ,GAA4D;IACxE,gBAAgB,EACd,6GAA6G;IAC/G,0BAA0B,EACxB,kGAAkG;IACpG,SAAS,EACP,2GAA2G;IAC7G,wBAAwB,EACtB,2FAA2F;IAC7F,iBAAiB,EACf,2HAA2H;IAC7H,0BAA0B,EACxB,iGAAiG;IACnG,kBAAkB,EAChB,4GAA4G;IAC9G,oBAAoB,EAClB,oHAAoH;CACvH,CAAC;AAEF,MAAM,UAAU,8BAA8B,CAAC,MAAqC;IAClF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC;AAC1B,CAAC","sourcesContent":["/** Markdown lint complete Check 的稳定 unavailable 原因。 */\nexport type MarkdownLintUnavailableReason =\n  | \"backend-failed\"\n  | \"backend-protocol-invalid\"\n  | \"cancelled\"\n  | \"finding-limit-exceeded\"\n  | \"invalid-options\"\n  | \"project-root-unavailable\"\n  | \"source-too-large\"\n  | \"source-unavailable\";\n\nconst MESSAGES: Readonly<Record<MarkdownLintUnavailableReason, string>> = {\n  \"backend-failed\":\n    \"Markdown lint could not complete its private backend operation; retry after checking the installed package.\",\n  \"backend-protocol-invalid\":\n    \"Markdown lint received an invalid private backend response and did not publish partial findings.\",\n  cancelled:\n    \"Markdown lint was cancelled before it could form a complete result; retry after cancellation is resolved.\",\n  \"finding-limit-exceeded\":\n    \"Markdown lint exceeded maxFindings; narrow the file selection or raise the bounded limit.\",\n  \"invalid-options\":\n    \"markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options.\",\n  \"project-root-unavailable\":\n    \"Markdown lint could not resolve the project root; check that the path exists and is accessible.\",\n  \"source-too-large\":\n    \"A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.\",\n  \"source-unavailable\":\n    \"A selected Markdown source could not be read, decoded, or contained safely; check the file source and permissions.\"\n};\n\nexport function markdownLintUnavailableMessage(reason: MarkdownLintUnavailableReason): string {\n  return MESSAGES[reason];\n}\n"]}