@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/function-metrics/measurement.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/measurement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAkBrD,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,EAC3C,UAAU,EACV,KAAK,EACL,MAAM,EACmB;IACzB,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAChE,IAAI,KAAK,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,WAAW,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAClE,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAChE,IAAI,CAAC,YAAY,CAAC,SAAS,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,MAAM,WAAW,GAAG,kBAAkB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;AAC7E,CAAC;AAED,SAAS,kBAAkB,CACzB,KAAmC,EACnC,UAAiD;IAEjD,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,GAAG,EAAE,KAAK,CAAC,OAAO;QAClB,UAAU;QACV,KAAK,EAAE,KAAK,CAAC,kBAAkB;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB;SAC5E,CAAC,CAAC;IACL,CAAC;IACD,MAAM,QAAQ,GAAG,4BAA4B,CAAC,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC7F,OAAO,QAAQ,CAAC,EAAE;QAChB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import { acceptExactInputMeasurements } from \"../project-files/exact-input-measurement.ts\";\nimport { checkLizard } from \"./lizard/availability.ts\";\nimport { scanWithLizard } from \"./lizard/scanner.ts\";\nimport type { FunctionMetric, FunctionMetricsExactInputSet } from \"./measurement-model.ts\";\nimport type { ResolvedFunctionMetricsScannerOptions } from \"./options.ts\";\n\nexport type FunctionMeasurementResult = Readonly<\n  | { kind: \"cancelled\" }\n  | { kind: \"complete\"; metrics: readonly FunctionMetric[] }\n  | { kind: \"execution-failed\" }\n  | { kind: \"invalid-result\" }\n  | { kind: \"unavailable\" }\n>;\n\ninterface FunctionMeasurementInput {\n  readonly dependency: ResolvedFunctionMetricsScannerOptions;\n  readonly input: FunctionMetricsExactInputSet;\n  readonly signal: AbortSignal;\n}\n\nexport async function measureFunctionMetrics({\n  dependency,\n  input,\n  signal\n}: FunctionMeasurementInput): Promise<FunctionMeasurementResult> {\n  if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n  if (input.approvedExactPaths.length === 0) {\n    return Object.freeze({ kind: \"complete\", metrics: Object.freeze([]) });\n  }\n  const availability = await checkLizard(input.rootDir, dependency);\n  if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n  if (!availability.available) {\n    return Object.freeze({ kind: \"unavailable\" });\n  }\n  const measurement = runFunctionScanner(input, dependency);\n  return signal.aborted ? Object.freeze({ kind: \"cancelled\" }) : measurement;\n}\n\nfunction runFunctionScanner(\n  input: FunctionMetricsExactInputSet,\n  dependency: ResolvedFunctionMetricsScannerOptions\n): FunctionMeasurementResult {\n  const result = scanWithLizard({\n    cwd: input.rootDir,\n    dependency,\n    files: input.approvedExactPaths\n  });\n  if (!result.ok) {\n    return Object.freeze({\n      kind: result.reason === \"execution\" ? \"execution-failed\" : \"invalid-result\"\n    });\n  }\n  const accepted = acceptExactInputMeasurements(result.measurements, input.approvedExactPaths);\n  return accepted.ok\n    ? Object.freeze({ kind: \"complete\", metrics: Object.freeze([...accepted.payloads]) })\n    : Object.freeze({ kind: \"invalid-result\" });\n}\n"]}

package/dist/esm/package-checks/function-metrics/options-resolution.mjs

@@ -0,0 +1,171 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
+import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import {} from "./options.mjs";
+import { validResolvedFunctionMetricsOptions } from "./options-validation.mjs";
+import { LIZARD_SUPPORTED_FILE_GLOBS } from "./target-files.mjs";
+const DEFAULT_LIZARD_EXECUTABLE = "lizard";
+const DEFAULT_CODE_LINE_MAXIMUM = 60;
+const DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM = 180;
+const DEFAULT_LOW_COMPLEXITY_BELOW = 6;
+const DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM = 12;
+const DEFAULT_PARAMETER_MAXIMUM = 6;
+const DEFAULT_FILES = Object.freeze({
+    exclude: defaultProjectFileSelection.exclude,
+    include: LIZARD_SUPPORTED_FILE_GLOBS,
+    source: defaultProjectFileSelection.source
+});
+/** 校验 constructor input，并物化完整、冻结的 function-metrics options。 */
+export function resolveFunctionMetricsOptions(value) {
+    const input = snapshotPolicyRecord(value, {
+        optional: ["codeAreas", "findingPolicy", "scanner"]
+    });
+    if (input === undefined)
+        return undefined;
+    const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
+    if (findingPolicy === undefined)
+        return undefined;
+    const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);
+    const scanner = resolveScanner(input.scanner);
+    if (codeAreas === undefined || scanner === undefined)
+        return undefined;
+    const options = Object.freeze({ codeAreas, scanner });
+    return validResolvedFunctionMetricsOptions(options) ? options : undefined;
+}
+function resolveCodeAreas(value, defaultFindingPolicy) {
+    if (value === undefined) {
+        return Object.freeze({ project: defaultCodeArea(defaultFindingPolicy) });
+    }
+    const areas = snapshotClosedRecord(value);
+    if (areas === undefined || Object.keys(areas).length === 0)
+        return undefined;
+    const resolvedEntries = [];
+    for (const [areaId, candidate] of Object.entries(areas)) {
+        if (!nonEmptyString(areaId))
+            return undefined;
+        const area = resolveCodeArea(candidate, defaultFindingPolicy);
+        if (area === undefined)
+            return undefined;
+        resolvedEntries.push([areaId, area]);
+    }
+    return Object.freeze(Object.fromEntries(resolvedEntries));
+}
+function defaultCodeArea(findingPolicy) {
+    return Object.freeze({
+        files: snapshotProjectFileSelection(DEFAULT_FILES),
+        findingPolicy,
+        limits: defaultLimits()
+    });
+}
+function resolveCodeArea(value, defaultFindingPolicy) {
+    const area = snapshotPolicyRecord(value, {
+        optional: ["findingPolicy", "limits"],
+        required: ["files"]
+    });
+    if (area === undefined)
+        return undefined;
+    const files = resolveProjectFileSelection(area.files, DEFAULT_FILES);
+    const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);
+    const limits = resolveLimits(area.limits);
+    return files === undefined || findingPolicy === undefined || limits === undefined
+        ? undefined
+        : Object.freeze({ files, findingPolicy, limits });
+}
+function resolveLimits(value) {
+    if (value === undefined)
+        return defaultLimits();
+    const limits = snapshotPolicyRecord(value, {
+        optional: ["codeLines", "cyclomaticComplexity", "parameters"]
+    });
+    if (limits === undefined)
+        return undefined;
+    const codeLines = resolveCodeLineLimits(limits.codeLines);
+    const cyclomaticComplexity = resolveMaximum(limits.cyclomaticComplexity, DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM);
+    const parameters = resolveMaximum(limits.parameters, DEFAULT_PARAMETER_MAXIMUM);
+    if (codeLines === undefined || cyclomaticComplexity === undefined || parameters === undefined) {
+        return undefined;
+    }
+    return Object.freeze({ codeLines, cyclomaticComplexity, parameters });
+}
+function resolveCodeLineLimits(value) {
+    if (value === undefined)
+        return defaultLimits().codeLines;
+    const codeLines = snapshotPolicyRecord(value, {
+        optional: ["lowComplexityAllowance", "maximum"]
+    });
+    if (codeLines === undefined)
+        return undefined;
+    const maximum = codeLines.maximum ?? DEFAULT_CODE_LINE_MAXIMUM;
+    const allowance = resolveLowComplexityAllowance(codeLines.lowComplexityAllowance);
+    if (!positiveSafeInteger(maximum) || allowance === undefined || allowance.maximum < maximum) {
+        return undefined;
+    }
+    return Object.freeze({ lowComplexityAllowance: allowance, maximum });
+}
+function resolveLowComplexityAllowance(value) {
+    if (value === undefined) {
+        return Object.freeze({
+            cyclomaticComplexityBelow: DEFAULT_LOW_COMPLEXITY_BELOW,
+            maximum: DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM
+        });
+    }
+    const allowance = snapshotPolicyRecord(value, {
+        optional: ["cyclomaticComplexityBelow", "maximum"]
+    });
+    if (allowance === undefined)
+        return undefined;
+    const cyclomaticComplexityBelow = allowance.cyclomaticComplexityBelow ?? DEFAULT_LOW_COMPLEXITY_BELOW;
+    const maximum = allowance.maximum ?? DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM;
+    return positiveSafeInteger(cyclomaticComplexityBelow) && positiveSafeInteger(maximum)
+        ? Object.freeze({ cyclomaticComplexityBelow, maximum })
+        : undefined;
+}
+function resolveMaximum(value, fallback) {
+    if (value === undefined)
+        return Object.freeze({ maximum: fallback });
+    const input = snapshotPolicyRecord(value, { optional: ["maximum"] });
+    if (input === undefined)
+        return undefined;
+    const maximum = input.maximum ?? fallback;
+    return positiveSafeInteger(maximum) ? Object.freeze({ maximum }) : undefined;
+}
+function defaultLimits() {
+    return Object.freeze({
+        codeLines: Object.freeze({
+            lowComplexityAllowance: Object.freeze({
+                cyclomaticComplexityBelow: DEFAULT_LOW_COMPLEXITY_BELOW,
+                maximum: DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM
+            }),
+            maximum: DEFAULT_CODE_LINE_MAXIMUM
+        }),
+        cyclomaticComplexity: Object.freeze({ maximum: DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM }),
+        parameters: Object.freeze({ maximum: DEFAULT_PARAMETER_MAXIMUM })
+    });
+}
+function resolveScanner(value) {
+    if (value === undefined)
+        return Object.freeze({ executable: DEFAULT_LIZARD_EXECUTABLE });
+    const scanner = snapshotPolicyRecord(value, { optional: ["executable"] });
+    if (scanner === undefined)
+        return undefined;
+    const executable = scanner.executable ?? DEFAULT_LIZARD_EXECUTABLE;
+    return nonEmptyString(executable) ? Object.freeze({ executable }) : undefined;
+}
+function snapshotPolicyRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    if (record === undefined ||
+        !hasRequiredAndOptionalRecordKeys(record, {
+            optional: keys.optional ?? [],
+            required: keys.required ?? []
+        })) {
+        return undefined;
+    }
+    return record;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=options-resolution.mjs.map

package/dist/esm/package-checks/function-metrics/options-resolution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\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 {\n  DEFAULT_FINDING_POLICY,\n  resolveFindingPolicy,\n  type FindingPolicy\n} from \"../code-quality-findings/policy.ts\";\nimport {\n  type ResolvedFunctionMetricsCodeAreaOptions,\n  type ResolvedFunctionMetricsLimits,\n  type ResolvedFunctionMetricsOptions\n} from \"./options.ts\";\nimport { validResolvedFunctionMetricsOptions } from \"./options-validation.ts\";\nimport { LIZARD_SUPPORTED_FILE_GLOBS } from \"./target-files.ts\";\n\nconst DEFAULT_LIZARD_EXECUTABLE = \"lizard\";\nconst DEFAULT_CODE_LINE_MAXIMUM = 60;\nconst DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM = 180;\nconst DEFAULT_LOW_COMPLEXITY_BELOW = 6;\nconst DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM = 12;\nconst DEFAULT_PARAMETER_MAXIMUM = 6;\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: LIZARD_SUPPORTED_FILE_GLOBS,\n  source: defaultProjectFileSelection.source\n});\n\ninterface PolicyRecordKeys {\n  readonly optional?: readonly string[];\n  readonly required?: readonly string[];\n}\n\n/** 校验 constructor input，并物化完整、冻结的 function-metrics options。 */\nexport function resolveFunctionMetricsOptions(\n  value: unknown\n): ResolvedFunctionMetricsOptions | undefined {\n  const input = snapshotPolicyRecord(value, {\n    optional: [\"codeAreas\", \"findingPolicy\", \"scanner\"]\n  });\n  if (input === undefined) return undefined;\n\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  if (findingPolicy === undefined) return undefined;\n  const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);\n  const scanner = resolveScanner(input.scanner);\n  if (codeAreas === undefined || scanner === undefined) return undefined;\n\n  const options = Object.freeze({ codeAreas, scanner });\n  return validResolvedFunctionMetricsOptions(options) ? options : undefined;\n}\n\nfunction resolveCodeAreas(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFunctionMetricsOptions[\"codeAreas\"] | undefined {\n  if (value === undefined) {\n    return Object.freeze({ project: defaultCodeArea(defaultFindingPolicy) });\n  }\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return undefined;\n\n  const resolvedEntries: Array<readonly [string, ResolvedFunctionMetricsCodeAreaOptions]> = [];\n  for (const [areaId, candidate] of Object.entries(areas)) {\n    if (!nonEmptyString(areaId)) return undefined;\n    const area = resolveCodeArea(candidate, defaultFindingPolicy);\n    if (area === undefined) return undefined;\n    resolvedEntries.push([areaId, area]);\n  }\n  return Object.freeze(Object.fromEntries(resolvedEntries));\n}\n\nfunction defaultCodeArea(findingPolicy: FindingPolicy): ResolvedFunctionMetricsCodeAreaOptions {\n  return Object.freeze({\n    files: snapshotProjectFileSelection(DEFAULT_FILES),\n    findingPolicy,\n    limits: defaultLimits()\n  });\n}\n\nfunction resolveCodeArea(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFunctionMetricsCodeAreaOptions | undefined {\n  const area = snapshotPolicyRecord(value, {\n    optional: [\"findingPolicy\", \"limits\"],\n    required: [\"files\"]\n  });\n  if (area === undefined) return undefined;\n  const files = resolveProjectFileSelection(area.files, DEFAULT_FILES);\n  const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);\n  const limits = resolveLimits(area.limits);\n  return files === undefined || findingPolicy === undefined || limits === undefined\n    ? undefined\n    : Object.freeze({ files, findingPolicy, limits });\n}\n\nfunction resolveLimits(value: unknown): ResolvedFunctionMetricsLimits | undefined {\n  if (value === undefined) return defaultLimits();\n  const limits = snapshotPolicyRecord(value, {\n    optional: [\"codeLines\", \"cyclomaticComplexity\", \"parameters\"]\n  });\n  if (limits === undefined) return undefined;\n  const codeLines = resolveCodeLineLimits(limits.codeLines);\n  const cyclomaticComplexity = resolveMaximum(\n    limits.cyclomaticComplexity,\n    DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM\n  );\n  const parameters = resolveMaximum(limits.parameters, DEFAULT_PARAMETER_MAXIMUM);\n  if (codeLines === undefined || cyclomaticComplexity === undefined || parameters === undefined) {\n    return undefined;\n  }\n  return Object.freeze({ codeLines, cyclomaticComplexity, parameters });\n}\n\nfunction resolveCodeLineLimits(\n  value: unknown\n): ResolvedFunctionMetricsLimits[\"codeLines\"] | undefined {\n  if (value === undefined) return defaultLimits().codeLines;\n  const codeLines = snapshotPolicyRecord(value, {\n    optional: [\"lowComplexityAllowance\", \"maximum\"]\n  });\n  if (codeLines === undefined) return undefined;\n  const maximum = codeLines.maximum ?? DEFAULT_CODE_LINE_MAXIMUM;\n  const allowance = resolveLowComplexityAllowance(codeLines.lowComplexityAllowance);\n  if (!positiveSafeInteger(maximum) || allowance === undefined || allowance.maximum < maximum) {\n    return undefined;\n  }\n  return Object.freeze({ lowComplexityAllowance: allowance, maximum });\n}\n\nfunction resolveLowComplexityAllowance(\n  value: unknown\n): ResolvedFunctionMetricsLimits[\"codeLines\"][\"lowComplexityAllowance\"] | undefined {\n  if (value === undefined) {\n    return Object.freeze({\n      cyclomaticComplexityBelow: DEFAULT_LOW_COMPLEXITY_BELOW,\n      maximum: DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM\n    });\n  }\n  const allowance = snapshotPolicyRecord(value, {\n    optional: [\"cyclomaticComplexityBelow\", \"maximum\"]\n  });\n  if (allowance === undefined) return undefined;\n  const cyclomaticComplexityBelow =\n    allowance.cyclomaticComplexityBelow ?? DEFAULT_LOW_COMPLEXITY_BELOW;\n  const maximum = allowance.maximum ?? DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM;\n  return positiveSafeInteger(cyclomaticComplexityBelow) && positiveSafeInteger(maximum)\n    ? Object.freeze({ cyclomaticComplexityBelow, maximum })\n    : undefined;\n}\n\nfunction resolveMaximum(\n  value: unknown,\n  fallback: number\n): Readonly<{ readonly maximum: number }> | undefined {\n  if (value === undefined) return Object.freeze({ maximum: fallback });\n  const input = snapshotPolicyRecord(value, { optional: [\"maximum\"] });\n  if (input === undefined) return undefined;\n  const maximum = input.maximum ?? fallback;\n  return positiveSafeInteger(maximum) ? Object.freeze({ maximum }) : undefined;\n}\n\nfunction defaultLimits(): ResolvedFunctionMetricsLimits {\n  return Object.freeze({\n    codeLines: Object.freeze({\n      lowComplexityAllowance: Object.freeze({\n        cyclomaticComplexityBelow: DEFAULT_LOW_COMPLEXITY_BELOW,\n        maximum: DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM\n      }),\n      maximum: DEFAULT_CODE_LINE_MAXIMUM\n    }),\n    cyclomaticComplexity: Object.freeze({ maximum: DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM }),\n    parameters: Object.freeze({ maximum: DEFAULT_PARAMETER_MAXIMUM })\n  });\n}\n\nfunction resolveScanner(value: unknown): ResolvedFunctionMetricsOptions[\"scanner\"] | undefined {\n  if (value === undefined) return Object.freeze({ executable: DEFAULT_LIZARD_EXECUTABLE });\n  const scanner = snapshotPolicyRecord(value, { optional: [\"executable\"] });\n  if (scanner === undefined) return undefined;\n  const executable = scanner.executable ?? DEFAULT_LIZARD_EXECUTABLE;\n  return nonEmptyString(executable) ? Object.freeze({ executable }) : undefined;\n}\n\nfunction snapshotPolicyRecord(\n  value: unknown,\n  keys: PolicyRecordKeys\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  if (\n    record === undefined ||\n    !hasRequiredAndOptionalRecordKeys(record, {\n      optional: keys.optional ?? [],\n      required: keys.required ?? []\n    })\n  ) {\n    return undefined;\n  }\n  return record;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n"]}

package/dist/esm/package-checks/function-metrics/options-validation.mjs

@@ -0,0 +1,71 @@
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { validProjectFileSelection } from "../project-files/configuration.mjs";
+import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
+/** 验证 constructor 已物化的完整 function-metrics options。 */
+export function validResolvedFunctionMetricsOptions(value) {
+    const options = exactRecord(value, ["codeAreas", "scanner"]);
+    return (options !== undefined && validCodeAreas(options.codeAreas) && validScanner(options.scanner));
+}
+function validCodeAreas(value) {
+    const areas = snapshotClosedRecord(value);
+    if (areas === undefined || Object.keys(areas).length === 0)
+        return false;
+    return Object.entries(areas).every(([areaId, candidate]) => {
+        const area = exactRecord(candidate, ["files", "findingPolicy", "limits"]);
+        return (nonEmptyString(areaId) &&
+            area !== undefined &&
+            validProjectFileSelection(area.files) &&
+            validFindingPolicy(area.findingPolicy) &&
+            validLimits(area.limits));
+    });
+}
+function validLimits(value) {
+    const limits = exactRecord(value, ["codeLines", "cyclomaticComplexity", "parameters"]);
+    if (limits === undefined)
+        return false;
+    const codeLineLimits = codeLineLimitsFrom(limits.codeLines);
+    const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);
+    const parameters = maximumLimitFrom(limits.parameters);
+    return (codeLineLimits !== undefined &&
+        cyclomaticComplexity !== undefined &&
+        parameters !== undefined &&
+        positiveSafeInteger(cyclomaticComplexity.maximum) &&
+        positiveSafeInteger(parameters.maximum));
+}
+function codeLineLimitsFrom(value) {
+    const codeLines = exactRecord(value, ["lowComplexityAllowance", "maximum"]);
+    const allowance = exactRecord(codeLines?.lowComplexityAllowance, [
+        "cyclomaticComplexityBelow",
+        "maximum"
+    ]);
+    return codeLines !== undefined &&
+        allowance !== undefined &&
+        positiveSafeInteger(codeLines.maximum) &&
+        positiveSafeInteger(allowance.maximum) &&
+        allowance.maximum >= codeLines.maximum &&
+        positiveSafeInteger(allowance.cyclomaticComplexityBelow)
+        ? codeLines
+        : undefined;
+}
+function maximumLimitFrom(value) {
+    return exactRecord(value, ["maximum"]);
+}
+function validScanner(value) {
+    const scanner = exactRecord(value, ["executable"]);
+    return scanner !== undefined && nonEmptyString(scanner.executable);
+}
+function exactRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined &&
+        Object.keys(record).length === keys.length &&
+        keys.every((key) => Object.hasOwn(record, key))
+        ? record
+        : undefined;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=options-validation.mjs.map

package/dist/esm/package-checks/function-metrics/options-validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedFunctionMetricsOptions } from \"./options.ts\";\n\n/** 验证 constructor 已物化的完整 function-metrics options。 */\nexport function validResolvedFunctionMetricsOptions(\n  value: unknown\n): value is ResolvedFunctionMetricsOptions {\n  const options = exactRecord(value, [\"codeAreas\", \"scanner\"]);\n  return (\n    options !== undefined && validCodeAreas(options.codeAreas) && validScanner(options.scanner)\n  );\n}\n\nfunction validCodeAreas(value: unknown): boolean {\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return false;\n  return Object.entries(areas).every(([areaId, candidate]) => {\n    const area = exactRecord(candidate, [\"files\", \"findingPolicy\", \"limits\"]);\n    return (\n      nonEmptyString(areaId) &&\n      area !== undefined &&\n      validProjectFileSelection(area.files) &&\n      validFindingPolicy(area.findingPolicy) &&\n      validLimits(area.limits)\n    );\n  });\n}\n\nfunction validLimits(value: unknown): boolean {\n  const limits = exactRecord(value, [\"codeLines\", \"cyclomaticComplexity\", \"parameters\"]);\n  if (limits === undefined) return false;\n  const codeLineLimits = codeLineLimitsFrom(limits.codeLines);\n  const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);\n  const parameters = maximumLimitFrom(limits.parameters);\n  return (\n    codeLineLimits !== undefined &&\n    cyclomaticComplexity !== undefined &&\n    parameters !== undefined &&\n    positiveSafeInteger(cyclomaticComplexity.maximum) &&\n    positiveSafeInteger(parameters.maximum)\n  );\n}\n\nfunction codeLineLimitsFrom(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  const codeLines = exactRecord(value, [\"lowComplexityAllowance\", \"maximum\"]);\n  const allowance = exactRecord(codeLines?.lowComplexityAllowance, [\n    \"cyclomaticComplexityBelow\",\n    \"maximum\"\n  ]);\n  return codeLines !== undefined &&\n    allowance !== undefined &&\n    positiveSafeInteger(codeLines.maximum) &&\n    positiveSafeInteger(allowance.maximum) &&\n    allowance.maximum >= codeLines.maximum &&\n    positiveSafeInteger(allowance.cyclomaticComplexityBelow)\n    ? codeLines\n    : undefined;\n}\n\nfunction maximumLimitFrom(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  return exactRecord(value, [\"maximum\"]);\n}\n\nfunction validScanner(value: unknown): boolean {\n  const scanner = exactRecord(value, [\"executable\"]);\n  return scanner !== undefined && nonEmptyString(scanner.executable);\n}\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 &&\n    Object.keys(record).length === keys.length &&\n    keys.every((key) => Object.hasOwn(record, key))\n    ? record\n    : undefined;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n"]}

package/dist/esm/package-checks/function-metrics/options.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.mjs.map

package/dist/esm/package-checks/function-metrics/options.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/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\n/** `functionMetrics` 构造函数可省略的文件选择策略。 */\nexport type FunctionMetricsFileOptions = ProjectFileSelectionOptions;\n\n/** `functionMetrics` 构造函数可省略的函数指标上限。 */\nexport interface FunctionMetricsLimitOptions {\n  readonly codeLines?: Readonly<{\n    /** 省略时为 `60`；函数 NLOC 超过此值时产生 finding。 */\n    readonly maximum?: number;\n    readonly lowComplexityAllowance?: Readonly<{\n      /** 省略时为 `6`；复杂度小于此值时可使用较高 NLOC 上限。 */\n      readonly cyclomaticComplexityBelow?: number;\n      /** 省略时为 `180`；不得小于普通代码行上限。 */\n      readonly maximum?: number;\n    }>;\n  }>;\n  readonly cyclomaticComplexity?: Readonly<{\n    /** 省略时为 `12`。 */\n    readonly maximum?: number;\n  }>;\n  readonly parameters?: Readonly<{\n    /** 省略时为 `6`。 */\n    readonly maximum?: number;\n  }>;\n}\n\n/** 可独立选择文件、指标上限和 finding policy 的 function-metrics 区域。 */\nexport interface FunctionMetricsCodeAreaOptions {\n  /** 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 */\n  readonly files: FunctionMetricsFileOptions;\n  /** 省略时继承顶层 `findingPolicy`。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略的嵌套上限使用 package 默认值。 */\n  readonly limits?: FunctionMetricsLimitOptions;\n}\n\n/** `functionMetrics` 构造函数可省略的 Lizard 可执行文件策略。 */\nexport interface FunctionMetricsScannerOptions {\n  /** 省略时为 `lizard`；显式命令必须直接接受 adapter 拥有的 Lizard 参数。 */\n  readonly executable?: string;\n}\n\n/** `functionMetrics(options?)` 接受并补齐默认值的公开策略。 */\nexport interface FunctionMetricsOptions {\n  /** 省略时建立默认 `project` 区域；显式映射必须非空，且每个区域必须声明 `files`。 */\n  readonly codeAreas?: Readonly<Record<string, FunctionMetricsCodeAreaOptions>>;\n  /** 省略时为 `non-blocking`；区域可局部覆盖。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时使用 PATH 中的 `lizard`。 */\n  readonly scanner?: FunctionMetricsScannerOptions;\n}\n\n/** 构造函数生成并由 Check preflight/execution 消费的完整 options。 */\nexport interface ResolvedFunctionMetricsOptions {\n  readonly codeAreas: Readonly<Record<string, ResolvedFunctionMetricsCodeAreaOptions>>;\n  readonly scanner: ResolvedFunctionMetricsScannerOptions;\n}\n\nexport interface ResolvedFunctionMetricsCodeAreaOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly limits: ResolvedFunctionMetricsLimits;\n}\n\nexport interface ResolvedFunctionMetricsLimits {\n  readonly codeLines: Readonly<{\n    readonly maximum: number;\n    readonly lowComplexityAllowance: Readonly<{\n      readonly cyclomaticComplexityBelow: number;\n      readonly maximum: number;\n    }>;\n  }>;\n  readonly cyclomaticComplexity: Readonly<{ readonly maximum: number }>;\n  readonly parameters: Readonly<{ readonly maximum: number }>;\n}\n\nexport interface ResolvedFunctionMetricsScannerOptions {\n  readonly executable: string;\n}\n"]}

package/dist/esm/package-checks/function-metrics/records.mjs

@@ -0,0 +1,133 @@
+import { isStableFunctionName } from "./analysis.mjs";
+import { isBlockingFinding } from "../code-quality-findings/policy.mjs";
+const INPUT_REJECTED_RECORD_ID_PREFIX = "/input-rejected/";
+/** 为每个 rejected path 构造一条 area-aware、固定 non-blocking 的 Finding。 */
+export function buildFunctionInputRejectedCandidates(codeAreasByPath) {
+    return Object.freeze([...codeAreasByPath]
+        .sort(([left], [right]) => compareText(left, right))
+        .map(([path, codeAreas]) => Object.freeze({
+        data: Object.freeze({
+            blocking: false,
+            codeAreas: Object.freeze(uniqueSorted(codeAreas)),
+            kind: "input-rejected",
+            path,
+            reason: "unsupported-file-type"
+        }),
+        id: `${INPUT_REJECTED_RECORD_ID_PREFIX}${path}`
+    })));
+}
+/** 为每个超过 matching-area 最严格阈值的 metric 构造 supplemental fact。 */
+export function buildFunctionRecordCandidates(analysis, areas) {
+    const areasByPath = indexAreasByPath(areas);
+    const candidates = [];
+    for (const instance of analysis.instances) {
+        const [firstArea, ...remainingAreas] = areasByPath.get(instance.metric.file) ?? [];
+        if (firstArea === undefined)
+            return undefined;
+        const matchingAreas = [firstArea, ...remainingAreas];
+        const policyContext = resolveFunctionPolicyContext(instance, matchingAreas);
+        for (const evaluation of metricEvaluations(instance, policyContext, matchingAreas)) {
+            appendFindingCandidate(candidates, evaluation);
+        }
+    }
+    candidates.sort((left, right) => compareText(left.id, right.id));
+    return Object.freeze(candidates);
+}
+function indexAreasByPath(areas) {
+    const mutableAreas = new Map();
+    for (const area of areas) {
+        for (const path of area.approvedExactPaths) {
+            const matchingAreas = mutableAreas.get(path) ?? [];
+            matchingAreas.push(area);
+            mutableAreas.set(path, matchingAreas);
+        }
+    }
+    return new Map(Array.from(mutableAreas, ([path, matchingAreas]) => [path, Object.freeze(matchingAreas)]));
+}
+function resolveFunctionPolicyContext(instance, matchingAreas) {
+    return Object.freeze({
+        blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),
+        codeAreas: Object.freeze(uniqueSorted(matchingAreas.map((area) => area.codeArea))),
+        functionName: isStableFunctionName(instance.metric.name) ? instance.metric.name : "<anonymous>"
+    });
+}
+function metricEvaluations(instance, policyContext, matchingAreas) {
+    const evaluations = [];
+    const complexityEvaluation = complexityMetricEvaluation(instance, policyContext, matchingAreas);
+    if (complexityEvaluation !== null)
+        evaluations.push(complexityEvaluation);
+    evaluations.push(codeLinesMetricEvaluation(instance, policyContext, matchingAreas), parameterMetricEvaluation(instance, policyContext, matchingAreas));
+    return evaluations;
+}
+function sharedMetricEvaluation(instance, policyContext) {
+    return {
+        blocking: policyContext.blocking,
+        codeAreas: policyContext.codeAreas,
+        functionName: policyContext.functionName,
+        path: instance.metric.file,
+        startLine: instance.metric.startLine,
+        subject: instance.semanticSubject
+    };
+}
+function complexityMetricEvaluation(instance, policyContext, matchingAreas) {
+    const value = instance.metric.cyclomaticComplexity.value;
+    if (value === null)
+        return null;
+    return {
+        ...sharedMetricEvaluation(instance, policyContext),
+        limit: Math.min(...matchingAreas.map((area) => area.limits.cyclomaticComplexity.maximum)),
+        metric: "cyclomatic-complexity",
+        value
+    };
+}
+function codeLinesMetricEvaluation(instance, policyContext, matchingAreas) {
+    return {
+        ...sharedMetricEvaluation(instance, policyContext),
+        limit: Math.min(...matchingAreas.map((area) => functionCodeLineMaximum(instance.metric, area.limits))),
+        metric: "function-code-density",
+        value: instance.metric.lines
+    };
+}
+function parameterMetricEvaluation(instance, policyContext, matchingAreas) {
+    return {
+        ...sharedMetricEvaluation(instance, policyContext),
+        limit: Math.min(...matchingAreas.map((area) => area.limits.parameters.maximum)),
+        metric: "parameter-count",
+        value: instance.metric.parameterCount
+    };
+}
+function appendFindingCandidate(candidates, evaluation) {
+    if (evaluation.value <= evaluation.limit)
+        return;
+    candidates.push(Object.freeze({
+        id: `${evaluation.subject}:${evaluation.metric}`,
+        data: Object.freeze({
+            blocking: evaluation.blocking,
+            codeAreas: evaluation.codeAreas,
+            functionName: evaluation.functionName,
+            limit: evaluation.limit,
+            metric: evaluation.metric,
+            path: evaluation.path,
+            startLine: evaluation.startLine,
+            value: evaluation.value
+        })
+    }));
+}
+function functionCodeLineMaximum(metric, limits) {
+    const allowance = limits.codeLines.lowComplexityAllowance;
+    const complexity = metric.cyclomaticComplexity.value;
+    return complexity !== null && complexity < allowance.cyclomaticComplexityBelow
+        ? allowance.maximum
+        : limits.codeLines.maximum;
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort(compareText);
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=records.mjs.map

package/dist/esm/package-checks/function-metrics/records.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/records.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isStableFunctionName,\n  type FunctionMetricAnalysis,\n  type FunctionMetricInstance\n} from \"./analysis.ts\";\nimport { isBlockingFinding } from \"../code-quality-findings/policy.ts\";\nimport type { FunctionMetric, FunctionMetricsAreaInput } from \"./measurement-model.ts\";\nimport type { ResolvedFunctionMetricsLimits } from \"./options.ts\";\n\ntype FunctionMetricName = \"cyclomatic-complexity\" | \"function-code-density\" | \"parameter-count\";\nconst INPUT_REJECTED_RECORD_ID_PREFIX = \"/input-rejected/\";\n\n/** 一条超出函数 metric 上限的 supplemental Record data。 */\nexport type FunctionMetricsFindingRecordData = Readonly<{\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly functionName: string;\n  readonly limit: number;\n  readonly metric: FunctionMetricName;\n  readonly path: string;\n  readonly startLine: number;\n  readonly value: number;\n}>;\n\n/** 一条已被 files policy 选中、但不受 functionMetrics 支持的输入 Finding。 */\nexport type FunctionMetricsInputRejectedRecordData = Readonly<{\n  readonly blocking: false;\n  readonly codeAreas: readonly string[];\n  readonly kind: \"input-rejected\";\n  readonly path: string;\n  readonly reason: \"unsupported-file-type\";\n}>;\n\n/** functionMetrics 发布的 metric 或 input-rejection Record data。 */\nexport type FunctionMetricsRecordData =\n  | FunctionMetricsFindingRecordData\n  | FunctionMetricsInputRejectedRecordData;\n\nexport interface FunctionRecordCandidate {\n  readonly data: FunctionMetricsFindingRecordData;\n  readonly id: string;\n}\n\nexport interface FunctionInputRejectedCandidate {\n  readonly data: FunctionMetricsInputRejectedRecordData;\n  readonly id: string;\n}\n\n/** 为每个 rejected path 构造一条 area-aware、固定 non-blocking 的 Finding。 */\nexport function buildFunctionInputRejectedCandidates(\n  codeAreasByPath: ReadonlyMap<string, readonly string[]>\n): readonly FunctionInputRejectedCandidate[] {\n  return Object.freeze(\n    [...codeAreasByPath]\n      .sort(([left], [right]) => compareText(left, right))\n      .map(([path, codeAreas]) =>\n        Object.freeze({\n          data: Object.freeze({\n            blocking: false as const,\n            codeAreas: Object.freeze(uniqueSorted(codeAreas)),\n            kind: \"input-rejected\" as const,\n            path,\n            reason: \"unsupported-file-type\" as const\n          }),\n          id: `${INPUT_REJECTED_RECORD_ID_PREFIX}${path}`\n        })\n      )\n  );\n}\n\ntype MatchingFunctionMetricAreas = readonly [\n  FunctionMetricsAreaInput,\n  ...FunctionMetricsAreaInput[]\n];\n\ninterface FunctionPolicyContext {\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly functionName: string;\n}\n\ninterface FunctionMetricEvaluation {\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly functionName: string;\n  readonly limit: number;\n  readonly metric: FunctionMetricName;\n  readonly path: string;\n  readonly startLine: number;\n  readonly subject: string;\n  readonly value: number;\n}\n\n/** 为每个超过 matching-area 最严格阈值的 metric 构造 supplemental fact。 */\nexport function buildFunctionRecordCandidates(\n  analysis: FunctionMetricAnalysis,\n  areas: readonly FunctionMetricsAreaInput[]\n): readonly FunctionRecordCandidate[] | undefined {\n  const areasByPath = indexAreasByPath(areas);\n  const candidates: FunctionRecordCandidate[] = [];\n  for (const instance of analysis.instances) {\n    const [firstArea, ...remainingAreas] = areasByPath.get(instance.metric.file) ?? [];\n    if (firstArea === undefined) return undefined;\n    const matchingAreas = [firstArea, ...remainingAreas] as const;\n    const policyContext = resolveFunctionPolicyContext(instance, matchingAreas);\n    for (const evaluation of metricEvaluations(instance, policyContext, matchingAreas)) {\n      appendFindingCandidate(candidates, evaluation);\n    }\n  }\n  candidates.sort((left, right) => compareText(left.id, right.id));\n  return Object.freeze(candidates);\n}\n\nfunction indexAreasByPath(\n  areas: readonly FunctionMetricsAreaInput[]\n): ReadonlyMap<string, readonly FunctionMetricsAreaInput[]> {\n  const mutableAreas = new Map<string, FunctionMetricsAreaInput[]>();\n  for (const area of areas) {\n    for (const path of area.approvedExactPaths) {\n      const matchingAreas = mutableAreas.get(path) ?? [];\n      matchingAreas.push(area);\n      mutableAreas.set(path, matchingAreas);\n    }\n  }\n  return new Map(\n    Array.from(mutableAreas, ([path, matchingAreas]) => [path, Object.freeze(matchingAreas)])\n  );\n}\n\nfunction resolveFunctionPolicyContext(\n  instance: FunctionMetricInstance,\n  matchingAreas: MatchingFunctionMetricAreas\n): Readonly<FunctionPolicyContext> {\n  return Object.freeze({\n    blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),\n    codeAreas: Object.freeze(uniqueSorted(matchingAreas.map((area) => area.codeArea))),\n    functionName: isStableFunctionName(instance.metric.name) ? instance.metric.name : \"<anonymous>\"\n  });\n}\n\nfunction metricEvaluations(\n  instance: FunctionMetricInstance,\n  policyContext: FunctionPolicyContext,\n  matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation[] {\n  const evaluations: FunctionMetricEvaluation[] = [];\n  const complexityEvaluation = complexityMetricEvaluation(instance, policyContext, matchingAreas);\n  if (complexityEvaluation !== null) evaluations.push(complexityEvaluation);\n  evaluations.push(\n    codeLinesMetricEvaluation(instance, policyContext, matchingAreas),\n    parameterMetricEvaluation(instance, policyContext, matchingAreas)\n  );\n  return evaluations;\n}\n\nfunction sharedMetricEvaluation(\n  instance: FunctionMetricInstance,\n  policyContext: FunctionPolicyContext\n) {\n  return {\n    blocking: policyContext.blocking,\n    codeAreas: policyContext.codeAreas,\n    functionName: policyContext.functionName,\n    path: instance.metric.file,\n    startLine: instance.metric.startLine,\n    subject: instance.semanticSubject\n  } as const;\n}\n\nfunction complexityMetricEvaluation(\n  instance: FunctionMetricInstance,\n  policyContext: FunctionPolicyContext,\n  matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation | null {\n  const value = instance.metric.cyclomaticComplexity.value;\n  if (value === null) return null;\n  return {\n    ...sharedMetricEvaluation(instance, policyContext),\n    limit: Math.min(...matchingAreas.map((area) => area.limits.cyclomaticComplexity.maximum)),\n    metric: \"cyclomatic-complexity\",\n    value\n  };\n}\n\nfunction codeLinesMetricEvaluation(\n  instance: FunctionMetricInstance,\n  policyContext: FunctionPolicyContext,\n  matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n  return {\n    ...sharedMetricEvaluation(instance, policyContext),\n    limit: Math.min(\n      ...matchingAreas.map((area) => functionCodeLineMaximum(instance.metric, area.limits))\n    ),\n    metric: \"function-code-density\",\n    value: instance.metric.lines\n  };\n}\n\nfunction parameterMetricEvaluation(\n  instance: FunctionMetricInstance,\n  policyContext: FunctionPolicyContext,\n  matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n  return {\n    ...sharedMetricEvaluation(instance, policyContext),\n    limit: Math.min(...matchingAreas.map((area) => area.limits.parameters.maximum)),\n    metric: \"parameter-count\",\n    value: instance.metric.parameterCount\n  };\n}\n\nfunction appendFindingCandidate(\n  candidates: FunctionRecordCandidate[],\n  evaluation: FunctionMetricEvaluation\n): void {\n  if (evaluation.value <= evaluation.limit) return;\n  candidates.push(\n    Object.freeze({\n      id: `${evaluation.subject}:${evaluation.metric}`,\n      data: Object.freeze({\n        blocking: evaluation.blocking,\n        codeAreas: evaluation.codeAreas,\n        functionName: evaluation.functionName,\n        limit: evaluation.limit,\n        metric: evaluation.metric,\n        path: evaluation.path,\n        startLine: evaluation.startLine,\n        value: evaluation.value\n      })\n    })\n  );\n}\n\nfunction functionCodeLineMaximum(\n  metric: FunctionMetric,\n  limits: ResolvedFunctionMetricsLimits\n): number {\n  const allowance = limits.codeLines.lowComplexityAllowance;\n  const complexity = metric.cyclomaticComplexity.value;\n  return complexity !== null && complexity < allowance.cyclomaticComplexityBelow\n    ? allowance.maximum\n    : limits.codeLines.maximum;\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return [...new Set(values)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

package/dist/esm/package-checks/function-metrics/target-files.mjs

@@ -0,0 +1,75 @@
+/** Lizard 1.23.0 官方 language readers 支持的 exact input 扩展名。 */
+const LIZARD_SUPPORTED_FILE_EXTENSIONS = Object.freeze([
+    "c",
+    "cc",
+    "cjs",
+    "cpp",
+    "cs",
+    "cxx",
+    "erl",
+    "es",
+    "escript",
+    "f",
+    "f03",
+    "f08",
+    "f70",
+    "f90",
+    "f95",
+    "for",
+    "fpp",
+    "ftn",
+    "gd",
+    "go",
+    "h",
+    "hpp",
+    "hrl",
+    "java",
+    "js",
+    "jsx",
+    "kt",
+    "kts",
+    "lua",
+    "m",
+    "mjs",
+    "mm",
+    "pck",
+    "php",
+    "pkb",
+    "pks",
+    "pl",
+    "plb",
+    "pls",
+    "pm",
+    "py",
+    "r",
+    "rb",
+    "rs",
+    "scala",
+    "sol",
+    "sql",
+    "st",
+    "swift",
+    "ts",
+    "ttcn",
+    "ttcnpp",
+    "tsx",
+    "vue",
+    "zig"
+]);
+const LIZARD_SUPPORTED_FILE_EXTENSION_SET = new Set(LIZARD_SUPPORTED_FILE_EXTENSIONS);
+/** functionMetrics 默认 files.include 使用的 case-insensitive extension globs。 */
+export const LIZARD_SUPPORTED_FILE_GLOBS = Object.freeze(LIZARD_SUPPORTED_FILE_EXTENSIONS.map((extension) => `**/*.${caseInsensitiveExtensionPattern(extension)}`));
+export function isLizardTarget(filePath) {
+    const extensionSeparator = filePath.lastIndexOf(".");
+    if (extensionSeparator < 0)
+        return false;
+    const extension = filePath.slice(extensionSeparator + 1).toLowerCase();
+    return LIZARD_SUPPORTED_FILE_EXTENSION_SET.has(extension);
+}
+function caseInsensitiveExtensionPattern(extension) {
+    return extension
+        .split("")
+        .map((character) => /[a-z]/u.test(character) ? `[${character}${character.toUpperCase()}]` : character)
+        .join("");
+}
+//# sourceMappingURL=target-files.mjs.map

package/dist/esm/package-checks/function-metrics/target-files.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-files.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/target-files.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,SAAS;IACT,GAAG;IACH,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,GAAG;IACH,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,OAAO;IACP,KAAK;IACL,KAAK;IACL,IAAI;IACJ,OAAO;IACP,IAAI;IACJ,MAAM;IACN,QAAQ;IACR,KAAK;IACL,KAAK;IACL,KAAK;CACG,CAAC,CAAC;AAEZ,MAAM,mCAAmC,GAAwB,IAAI,GAAG,CACtE,gCAAgC,CACjC,CAAC;AAEF,6EAA6E;AAC7E,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAM,CAAC,MAAM,CACtD,gCAAgC,CAAC,GAAG,CAClC,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,+BAA+B,CAAC,SAAS,CAAC,EAAE,CACpE,CACF,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,kBAAkB,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,kBAAkB,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,kBAAkB,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACvE,OAAO,mCAAmC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,+BAA+B,CAAC,SAAiB;IACxD,OAAO,SAAS;SACb,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAClF;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC","sourcesContent":["/** Lizard 1.23.0 官方 language readers 支持的 exact input 扩展名。 */\nconst LIZARD_SUPPORTED_FILE_EXTENSIONS = Object.freeze([\n  \"c\",\n  \"cc\",\n  \"cjs\",\n  \"cpp\",\n  \"cs\",\n  \"cxx\",\n  \"erl\",\n  \"es\",\n  \"escript\",\n  \"f\",\n  \"f03\",\n  \"f08\",\n  \"f70\",\n  \"f90\",\n  \"f95\",\n  \"for\",\n  \"fpp\",\n  \"ftn\",\n  \"gd\",\n  \"go\",\n  \"h\",\n  \"hpp\",\n  \"hrl\",\n  \"java\",\n  \"js\",\n  \"jsx\",\n  \"kt\",\n  \"kts\",\n  \"lua\",\n  \"m\",\n  \"mjs\",\n  \"mm\",\n  \"pck\",\n  \"php\",\n  \"pkb\",\n  \"pks\",\n  \"pl\",\n  \"plb\",\n  \"pls\",\n  \"pm\",\n  \"py\",\n  \"r\",\n  \"rb\",\n  \"rs\",\n  \"scala\",\n  \"sol\",\n  \"sql\",\n  \"st\",\n  \"swift\",\n  \"ts\",\n  \"ttcn\",\n  \"ttcnpp\",\n  \"tsx\",\n  \"vue\",\n  \"zig\"\n] as const);\n\nconst LIZARD_SUPPORTED_FILE_EXTENSION_SET: ReadonlySet<string> = new Set(\n  LIZARD_SUPPORTED_FILE_EXTENSIONS\n);\n\n/** functionMetrics 默认 files.include 使用的 case-insensitive extension globs。 */\nexport const LIZARD_SUPPORTED_FILE_GLOBS = Object.freeze(\n  LIZARD_SUPPORTED_FILE_EXTENSIONS.map(\n    (extension) => `**/*.${caseInsensitiveExtensionPattern(extension)}`\n  )\n);\n\nexport function isLizardTarget(filePath: string): boolean {\n  const extensionSeparator = filePath.lastIndexOf(\".\");\n  if (extensionSeparator < 0) return false;\n  const extension = filePath.slice(extensionSeparator + 1).toLowerCase();\n  return LIZARD_SUPPORTED_FILE_EXTENSION_SET.has(extension);\n}\n\nfunction caseInsensitiveExtensionPattern(extension: string): string {\n  return extension\n    .split(\"\")\n    .map((character) =>\n      /[a-z]/u.test(character) ? `[${character}${character.toUpperCase()}]` : character\n    )\n    .join(\"\");\n}\n"]}

package/dist/esm/package-checks/host-environment/error-message.mjs

@@ -0,0 +1,4 @@
+export function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=error-message.mjs.map

package/dist/esm/package-checks/host-environment/error-message.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-message.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/error-message.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC","sourcesContent":["export function errorMessage(error: unknown): string {\n  return error instanceof Error ? error.message : String(error);\n}\n"]}