@zxyycom/vibe-check 0.0.1 → 0.0.2

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

@@ -1,35 +1,170 @@
-import { acceptExactInputMeasurements } from "../project-files/exact-input-measurement.mjs";
-import { checkLizard } from "./lizard/availability.mjs";
-import { scanWithLizard } from "./lizard/scanner.mjs";
-export async function measureFunctionMetrics({ dependency, input, signal }) {
+import { closeSync, openSync, readSync } from "node:fs";
+import { resolve } from "node:path";
+import { analyzeAdmittedSources, createNodeFunctionMetricsWorker } from "./analyzer-worker-port.mjs";
+const MAXIMUM_FILE_BYTES = 8 * 1024 * 1024;
+const MAXIMUM_AGGREGATE_BYTES = 64 * 1024 * 1024;
+const READ_CHUNK_BYTES = 32 * 1024;
+const DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES = Object.freeze({
+    createWorker: createNodeFunctionMetricsWorker,
+    yieldAdmission: yieldAdmissionToTimer
+});
+/**
+ * The Check parent admits exactly its selected sources and bounds their bytes;
+ * one Worker only analyzes those source texts and never discovers or reads paths.
+ */
+export async function measureFunctionMetrics({ input, signal }, dependencies = {}) {
+    const createWorker = dependencies.createWorker ?? DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES.createWorker;
+    const yieldAdmission = dependencies.yieldAdmission ?? DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES.yieldAdmission;
+    const admitted = await readExactFunctionSources(input, signal, yieldAdmission);
+    if (admitted.kind !== "complete")
+        return admitted;
     if (signal.aborted)
         return Object.freeze({ kind: "cancelled" });
-    if (input.approvedExactPaths.length === 0) {
-        return Object.freeze({ kind: "complete", metrics: Object.freeze([]) });
-    }
-    const availability = await checkLizard(input.rootDir, dependency);
-    if (signal.aborted)
-        return Object.freeze({ kind: "cancelled" });
-    if (!availability.available) {
-        return Object.freeze({ kind: "unavailable" });
-    }
-    const measurement = runFunctionScanner(input, dependency);
-    return signal.aborted ? Object.freeze({ kind: "cancelled" }) : measurement;
+    return analyzeAdmittedSources(admitted.request, input.approvedExactPaths, signal, createWorker);
 }
-function runFunctionScanner(input, dependency) {
-    const result = scanWithLizard({
-        cwd: input.rootDir,
-        dependency,
-        files: input.approvedExactPaths
+async function readExactFunctionSources(input, signal, yieldAdmission) {
+    let aggregateBytes = 0;
+    const files = [];
+    for (const path of input.approvedExactPaths) {
+        if (signal.aborted)
+            return Object.freeze({ kind: "cancelled" });
+        const source = await readBoundedSource(resolve(input.rootDir, path), aggregateBytes, signal, yieldAdmission);
+        if (source.kind !== "complete")
+            return source;
+        aggregateBytes += source.byteLength;
+        files.push(Object.freeze({ path, source: source.source }));
+    }
+    return Object.freeze({
+        kind: "complete",
+        request: Object.freeze({ files: Object.freeze(files) })
     });
-    if (!result.ok) {
+}
+async function readBoundedSource(absolutePath, aggregateBytes, signal, yieldAdmission) {
+    let descriptor;
+    try {
+        descriptor = openSync(absolutePath, "r");
+    }
+    catch {
+        return Object.freeze({ kind: "source-unavailable" });
+    }
+    try {
+        const chunks = [];
+        const chunk = Buffer.allocUnsafe(READ_CHUNK_BYTES);
+        let fileBytes = 0;
+        while (true) {
+            if (signal.aborted)
+                return Object.freeze({ kind: "cancelled" });
+            const bytesRead = readSync(descriptor, chunk, 0, chunk.length, null);
+            if (bytesRead === 0)
+                break;
+            fileBytes += bytesRead;
+            if (fileBytes > MAXIMUM_FILE_BYTES || aggregateBytes + fileBytes > MAXIMUM_AGGREGATE_BYTES) {
+                return Object.freeze({ kind: "resource-limit-exceeded" });
+            }
+            chunks.push(Buffer.from(chunk.subarray(0, bytesRead)));
+            if (signal.aborted)
+                return Object.freeze({ kind: "cancelled" });
+            await yieldAdmission();
+        }
         return Object.freeze({
-            kind: result.reason === "execution" ? "execution-failed" : "invalid-result"
+            kind: "complete",
+            byteLength: fileBytes,
+            source: decodeLizardAutoRead(Buffer.concat(chunks, fileBytes))
         });
     }
-    const accepted = acceptExactInputMeasurements(result.measurements, input.approvedExactPaths);
-    return accepted.ok
-        ? Object.freeze({ kind: "complete", metrics: Object.freeze([...accepted.payloads]) })
-        : Object.freeze({ kind: "invalid-result" });
+    catch {
+        return Object.freeze({ kind: "source-unavailable" });
+    }
+    finally {
+        closeSync(descriptor);
+    }
+}
+function yieldAdmissionToTimer() {
+    return new Promise((resolveYield) => setTimeout(resolveYield, 0));
+}
+/**
+ * Product-owned replacement for Lizard 1.24 `auto_open.auto_read` at the
+ * admitted-source boundary. A valid initial UTF-8 BOM is `utf-8-sig` and text
+ * newlines are universal; a decoding failure retries the complete byte sequence
+ * with Python's `errors="ignore"`, which deliberately retains an initial BOM
+ * and raw newlines on that retry.
+ */
+export function decodeLizardAutoRead(bytes) {
+    try {
+        return new TextDecoder("utf-8", { fatal: true }).decode(bytes).replace(/\r\n?/gu, "\n");
+    }
+    catch {
+        return decodeUtf8IgnoringInvalidBytes(bytes);
+    }
+}
+function decodeUtf8IgnoringInvalidBytes(bytes) {
+    let decoded = "";
+    for (let index = 0; index < bytes.length;) {
+        const codePoint = decodeUtf8CodePoint(bytes, index);
+        if (codePoint === undefined) {
+            index += 1;
+            continue;
+        }
+        decoded += String.fromCodePoint(codePoint);
+        index += utf8SequenceByteLength(codePoint);
+    }
+    return decoded;
+}
+function decodeUtf8CodePoint(bytes, index) {
+    const first = bytes[index];
+    if (first === undefined)
+        return undefined;
+    if (first <= 0x7f)
+        return first;
+    if (first >= 0xc2 && first <= 0xdf)
+        return decodeTwoByteUtf8Sequence(first, bytes[index + 1]);
+    if (first >= 0xe0 && first <= 0xef) {
+        return decodeThreeByteUtf8Sequence(first, bytes[index + 1], bytes[index + 2]);
+    }
+    if (first >= 0xf0 && first <= 0xf4) {
+        return decodeFourByteUtf8Sequence(first, bytes[index + 1], bytes[index + 2], bytes[index + 3]);
+    }
+    return undefined;
+}
+function decodeTwoByteUtf8Sequence(first, second) {
+    if (!isUtf8Continuation(second))
+        return undefined;
+    return ((first & 0x1f) << 6) | (second & 0x3f);
+}
+function decodeThreeByteUtf8Sequence(first, second, third) {
+    if (!isUtf8SecondByteForThreeByteSequence(first, second) || !isUtf8Continuation(third)) {
+        return undefined;
+    }
+    return ((first & 0x0f) << 12) | ((second & 0x3f) << 6) | (third & 0x3f);
+}
+function decodeFourByteUtf8Sequence(first, second, third, fourth) {
+    if (!isUtf8SecondByteForFourByteSequence(first, second) ||
+        !isUtf8Continuation(third) ||
+        !isUtf8Continuation(fourth)) {
+        return undefined;
+    }
+    return ((first & 0x07) << 18) | ((second & 0x3f) << 12) | ((third & 0x3f) << 6) | (fourth & 0x3f);
+}
+function utf8SequenceByteLength(codePoint) {
+    if (codePoint <= 0x7f)
+        return 1;
+    if (codePoint <= 0x7ff)
+        return 2;
+    if (codePoint <= 0xffff)
+        return 3;
+    return 4;
+}
+function isUtf8Continuation(value) {
+    return value !== undefined && value >= 0x80 && value <= 0xbf;
+}
+function isUtf8SecondByteForThreeByteSequence(first, second) {
+    return (isUtf8Continuation(second) &&
+        !(first === 0xe0 && second < 0xa0) &&
+        !(first === 0xed && second > 0x9f));
+}
+function isUtf8SecondByteForFourByteSequence(first, second) {
+    return (isUtf8Continuation(second) &&
+        !(first === 0xf0 && second < 0x90) &&
+        !(first === 0xf4 && second > 0x8f));
 }
 //# sourceMappingURL=measurement.mjs.map

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

@@ -1 +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"]}
+{"version":3,"file":"measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/measurement.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, openSync, readSync } from \"node:fs\";\nimport { resolve } from \"node:path\";\n\nimport type { FunctionMetricsAnalysisWorkerRequest } from \"./analyzer-worker-contract.ts\";\nimport {\n  analyzeAdmittedSources,\n  createNodeFunctionMetricsWorker,\n  type FunctionMetricsWorkerPort\n} from \"./analyzer-worker-port.ts\";\nimport type { FunctionMetric, FunctionMetricsExactInputSet } from \"./measurement-model.ts\";\n\nconst MAXIMUM_FILE_BYTES = 8 * 1024 * 1024;\nconst MAXIMUM_AGGREGATE_BYTES = 64 * 1024 * 1024;\nconst READ_CHUNK_BYTES = 32 * 1024;\n\nexport type FunctionMeasurementResult = Readonly<\n  | { kind: \"analysis-failed\" }\n  | { kind: \"cancelled\" }\n  | { kind: \"complete\"; metrics: readonly FunctionMetric[] }\n  | { kind: \"resource-limit-exceeded\" }\n  | { kind: \"source-unavailable\" }\n>;\n\ninterface FunctionMeasurementInput {\n  readonly input: FunctionMetricsExactInputSet;\n  readonly signal: AbortSignal;\n}\n\nexport interface FunctionMeasurementDependencies {\n  readonly createWorker: () => FunctionMetricsWorkerPort;\n  readonly yieldAdmission: () => Promise<void>;\n}\n\nconst DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES: FunctionMeasurementDependencies = Object.freeze({\n  createWorker: createNodeFunctionMetricsWorker,\n  yieldAdmission: yieldAdmissionToTimer\n});\n\n/**\n * The Check parent admits exactly its selected sources and bounds their bytes;\n * one Worker only analyzes those source texts and never discovers or reads paths.\n */\nexport async function measureFunctionMetrics(\n  { input, signal }: FunctionMeasurementInput,\n  dependencies: Partial<FunctionMeasurementDependencies> = {}\n): Promise<FunctionMeasurementResult> {\n  const createWorker =\n    dependencies.createWorker ?? DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES.createWorker;\n  const yieldAdmission =\n    dependencies.yieldAdmission ?? DEFAULT_FUNCTION_MEASUREMENT_DEPENDENCIES.yieldAdmission;\n  const admitted = await readExactFunctionSources(input, signal, yieldAdmission);\n  if (admitted.kind !== \"complete\") return admitted;\n  if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n  return analyzeAdmittedSources(admitted.request, input.approvedExactPaths, signal, createWorker);\n}\n\nasync function readExactFunctionSources(\n  input: FunctionMetricsExactInputSet,\n  signal: AbortSignal,\n  yieldAdmission: () => Promise<void>\n): Promise<\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"complete\"; readonly request: FunctionMetricsAnalysisWorkerRequest }>\n  | Readonly<{ readonly kind: \"resource-limit-exceeded\" }>\n  | Readonly<{ readonly kind: \"source-unavailable\" }>\n> {\n  let aggregateBytes = 0;\n  const files: FunctionMetricsAnalysisWorkerRequest[\"files\"][number][] = [];\n  for (const path of input.approvedExactPaths) {\n    if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n    const source = await readBoundedSource(\n      resolve(input.rootDir, path),\n      aggregateBytes,\n      signal,\n      yieldAdmission\n    );\n    if (source.kind !== \"complete\") return source;\n    aggregateBytes += source.byteLength;\n    files.push(Object.freeze({ path, source: source.source }));\n  }\n  return Object.freeze({\n    kind: \"complete\",\n    request: Object.freeze({ files: Object.freeze(files) })\n  });\n}\n\nasync function readBoundedSource(\n  absolutePath: string,\n  aggregateBytes: number,\n  signal: AbortSignal,\n  yieldAdmission: () => Promise<void>\n): Promise<\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"complete\"; readonly byteLength: number; readonly source: string }>\n  | Readonly<{ readonly kind: \"resource-limit-exceeded\" }>\n  | Readonly<{ readonly kind: \"source-unavailable\" }>\n> {\n  let descriptor: number;\n  try {\n    descriptor = openSync(absolutePath, \"r\");\n  } catch {\n    return Object.freeze({ kind: \"source-unavailable\" });\n  }\n  try {\n    const chunks: Buffer[] = [];\n    const chunk = Buffer.allocUnsafe(READ_CHUNK_BYTES);\n    let fileBytes = 0;\n    while (true) {\n      if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n      const bytesRead = readSync(descriptor, chunk, 0, chunk.length, null);\n      if (bytesRead === 0) break;\n      fileBytes += bytesRead;\n      if (fileBytes > MAXIMUM_FILE_BYTES || aggregateBytes + fileBytes > MAXIMUM_AGGREGATE_BYTES) {\n        return Object.freeze({ kind: \"resource-limit-exceeded\" });\n      }\n      chunks.push(Buffer.from(chunk.subarray(0, bytesRead)));\n      if (signal.aborted) return Object.freeze({ kind: \"cancelled\" });\n      await yieldAdmission();\n    }\n    return Object.freeze({\n      kind: \"complete\",\n      byteLength: fileBytes,\n      source: decodeLizardAutoRead(Buffer.concat(chunks, fileBytes))\n    });\n  } catch {\n    return Object.freeze({ kind: \"source-unavailable\" });\n  } finally {\n    closeSync(descriptor);\n  }\n}\n\nfunction yieldAdmissionToTimer(): Promise<void> {\n  return new Promise<void>((resolveYield) => setTimeout(resolveYield, 0));\n}\n\n/**\n * Product-owned replacement for Lizard 1.24 `auto_open.auto_read` at the\n * admitted-source boundary. A valid initial UTF-8 BOM is `utf-8-sig` and text\n * newlines are universal; a decoding failure retries the complete byte sequence\n * with Python's `errors=\"ignore\"`, which deliberately retains an initial BOM\n * and raw newlines on that retry.\n */\nexport function decodeLizardAutoRead(bytes: Uint8Array): string {\n  try {\n    return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes).replace(/\\r\\n?/gu, \"\\n\");\n  } catch {\n    return decodeUtf8IgnoringInvalidBytes(bytes);\n  }\n}\n\nfunction decodeUtf8IgnoringInvalidBytes(bytes: Uint8Array): string {\n  let decoded = \"\";\n  for (let index = 0; index < bytes.length;) {\n    const codePoint = decodeUtf8CodePoint(bytes, index);\n    if (codePoint === undefined) {\n      index += 1;\n      continue;\n    }\n    decoded += String.fromCodePoint(codePoint);\n    index += utf8SequenceByteLength(codePoint);\n  }\n  return decoded;\n}\n\nfunction decodeUtf8CodePoint(bytes: Uint8Array, index: number): number | undefined {\n  const first = bytes[index];\n  if (first === undefined) return undefined;\n  if (first <= 0x7f) return first;\n  if (first >= 0xc2 && first <= 0xdf) return decodeTwoByteUtf8Sequence(first, bytes[index + 1]);\n  if (first >= 0xe0 && first <= 0xef) {\n    return decodeThreeByteUtf8Sequence(first, bytes[index + 1], bytes[index + 2]);\n  }\n  if (first >= 0xf0 && first <= 0xf4) {\n    return decodeFourByteUtf8Sequence(first, bytes[index + 1], bytes[index + 2], bytes[index + 3]);\n  }\n  return undefined;\n}\n\nfunction decodeTwoByteUtf8Sequence(first: number, second: number | undefined): number | undefined {\n  if (!isUtf8Continuation(second)) return undefined;\n  return ((first & 0x1f) << 6) | (second & 0x3f);\n}\n\nfunction decodeThreeByteUtf8Sequence(\n  first: number,\n  second: number | undefined,\n  third: number | undefined\n): number | undefined {\n  if (!isUtf8SecondByteForThreeByteSequence(first, second) || !isUtf8Continuation(third)) {\n    return undefined;\n  }\n  return ((first & 0x0f) << 12) | ((second & 0x3f) << 6) | (third & 0x3f);\n}\n\nfunction decodeFourByteUtf8Sequence(\n  first: number,\n  second: number | undefined,\n  third: number | undefined,\n  fourth: number | undefined\n): number | undefined {\n  if (\n    !isUtf8SecondByteForFourByteSequence(first, second) ||\n    !isUtf8Continuation(third) ||\n    !isUtf8Continuation(fourth)\n  ) {\n    return undefined;\n  }\n  return ((first & 0x07) << 18) | ((second & 0x3f) << 12) | ((third & 0x3f) << 6) | (fourth & 0x3f);\n}\n\nfunction utf8SequenceByteLength(codePoint: number): number {\n  if (codePoint <= 0x7f) return 1;\n  if (codePoint <= 0x7ff) return 2;\n  if (codePoint <= 0xffff) return 3;\n  return 4;\n}\n\nfunction isUtf8Continuation(value: number | undefined): value is number {\n  return value !== undefined && value >= 0x80 && value <= 0xbf;\n}\n\nfunction isUtf8SecondByteForThreeByteSequence(\n  first: number,\n  second: number | undefined\n): second is number {\n  return (\n    isUtf8Continuation(second) &&\n    !(first === 0xe0 && second < 0xa0) &&\n    !(first === 0xed && second > 0x9f)\n  );\n}\n\nfunction isUtf8SecondByteForFourByteSequence(\n  first: number,\n  second: number | undefined\n): second is number {\n  return (\n    isUtf8Continuation(second) &&\n    !(first === 0xf0 && second < 0x90) &&\n    !(first === 0xf4 && second > 0x8f)\n  );\n}\n"]}

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

@@ -1,24 +1,27 @@
-import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { snapshotClosedPolicyRecord } from "../../data-boundary/closed-values.mjs";
+import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
-import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { DEFAULT_FINDING_POLICY, resolveCodeAreaPolicyMap, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { resolveFindingWaiverAuthoring } from "../code-quality-findings/finding-waiver-authoring.mjs";
+import { resolveFunctionMetricsFindingIdentity } from "./finding-waiver-identity.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";
+import { FUNCTION_METRICS_SUPPORTED_FILE_GLOBS } from "./target-files.mjs";
 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_NESTING_DEPTH_MAXIMUM = 7;
 const DEFAULT_PARAMETER_MAXIMUM = 6;
 const DEFAULT_FILES = Object.freeze({
     exclude: defaultProjectFileSelection.exclude,
-    include: LIZARD_SUPPORTED_FILE_GLOBS,
+    include: FUNCTION_METRICS_SUPPORTED_FILE_GLOBS,
     source: defaultProjectFileSelection.source
 });
 /** 校验 constructor input，并物化完整、冻结的 function-metrics options。 */
 export function resolveFunctionMetricsOptions(value) {
-    const input = snapshotPolicyRecord(value, {
-        optional: ["codeAreas", "findingPolicy", "scanner"]
+    const input = snapshotClosedPolicyRecord(value, {
+        optional: ["codeAreas", "findingPolicy", "findingWaivers"]
     });
     if (input === undefined)
         return undefined;
@@ -26,29 +29,14 @@ export function resolveFunctionMetricsOptions(value) {
     if (findingPolicy === undefined)
         return undefined;
     const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);
-    const scanner = resolveScanner(input.scanner);
-    if (codeAreas === undefined || scanner === undefined)
+    const findingWaivers = resolveFindingWaiverAuthoring(input.findingWaivers, resolveFunctionMetricsFindingIdentity);
+    if (codeAreas === undefined || findingWaivers === undefined)
         return undefined;
-    const options = Object.freeze({ codeAreas, scanner });
+    const options = Object.freeze({ codeAreas, findingWaivers });
     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));
+    return resolveCodeAreaPolicyMap(value, () => defaultCodeArea(defaultFindingPolicy), (candidate) => resolveCodeArea(candidate, defaultFindingPolicy));
 }
 function defaultCodeArea(findingPolicy) {
     return Object.freeze({
@@ -58,7 +46,7 @@ function defaultCodeArea(findingPolicy) {
     });
 }
 function resolveCodeArea(value, defaultFindingPolicy) {
-    const area = snapshotPolicyRecord(value, {
+    const area = snapshotClosedPolicyRecord(value, {
         optional: ["findingPolicy", "limits"],
         required: ["files"]
     });
@@ -74,30 +62,34 @@ function resolveCodeArea(value, defaultFindingPolicy) {
 function resolveLimits(value) {
     if (value === undefined)
         return defaultLimits();
-    const limits = snapshotPolicyRecord(value, {
-        optional: ["codeLines", "cyclomaticComplexity", "parameters"]
+    const limits = snapshotClosedPolicyRecord(value, {
+        optional: ["codeLines", "cyclomaticComplexity", "nestingDepth", "parameters"]
     });
     if (limits === undefined)
         return undefined;
     const codeLines = resolveCodeLineLimits(limits.codeLines);
     const cyclomaticComplexity = resolveMaximum(limits.cyclomaticComplexity, DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM);
+    const nestingDepth = resolveMaximum(limits.nestingDepth, DEFAULT_NESTING_DEPTH_MAXIMUM);
     const parameters = resolveMaximum(limits.parameters, DEFAULT_PARAMETER_MAXIMUM);
-    if (codeLines === undefined || cyclomaticComplexity === undefined || parameters === undefined) {
+    if (codeLines === undefined ||
+        cyclomaticComplexity === undefined ||
+        nestingDepth === undefined ||
+        parameters === undefined) {
         return undefined;
     }
-    return Object.freeze({ codeLines, cyclomaticComplexity, parameters });
+    return Object.freeze({ codeLines, cyclomaticComplexity, nestingDepth, parameters });
 }
 function resolveCodeLineLimits(value) {
     if (value === undefined)
         return defaultLimits().codeLines;
-    const codeLines = snapshotPolicyRecord(value, {
+    const codeLines = snapshotClosedPolicyRecord(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) {
+    if (!isPositiveSafeInteger(maximum) || allowance === undefined || allowance.maximum < maximum) {
         return undefined;
     }
     return Object.freeze({ lowComplexityAllowance: allowance, maximum });
@@ -109,25 +101,25 @@ function resolveLowComplexityAllowance(value) {
             maximum: DEFAULT_LOW_COMPLEXITY_CODE_LINE_MAXIMUM
         });
     }
-    const allowance = snapshotPolicyRecord(value, {
+    const allowance = snapshotClosedPolicyRecord(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)
+    return isPositiveSafeInteger(cyclomaticComplexityBelow) && isPositiveSafeInteger(maximum)
         ? Object.freeze({ cyclomaticComplexityBelow, maximum })
         : undefined;
 }
 function resolveMaximum(value, fallback) {
     if (value === undefined)
         return Object.freeze({ maximum: fallback });
-    const input = snapshotPolicyRecord(value, { optional: ["maximum"] });
+    const input = snapshotClosedPolicyRecord(value, { optional: ["maximum"] });
     if (input === undefined)
         return undefined;
     const maximum = input.maximum ?? fallback;
-    return positiveSafeInteger(maximum) ? Object.freeze({ maximum }) : undefined;
+    return isPositiveSafeInteger(maximum) ? Object.freeze({ maximum }) : undefined;
 }
 function defaultLimits() {
     return Object.freeze({
@@ -139,33 +131,8 @@ function defaultLimits() {
             maximum: DEFAULT_CODE_LINE_MAXIMUM
         }),
         cyclomaticComplexity: Object.freeze({ maximum: DEFAULT_CYCLOMATIC_COMPLEXITY_MAXIMUM }),
+        nestingDepth: Object.freeze({ maximum: DEFAULT_NESTING_DEPTH_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

@@ -1 +1 @@
-{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EAErB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAIN,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mBAAmB,CAAC;AAEhE,MAAM,yBAAyB,GAAG,QAAQ,CAAC;AAC3C,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,wCAAwC,GAAG,GAAG,CAAC;AACrD,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACjD,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,2BAA2B,CAAC,OAAO;IAC5C,OAAO,EAAE,2BAA2B;IACpC,MAAM,EAAE,2BAA2B,CAAC,MAAM;CAC3C,CAAC,CAAC;AAOH,+DAA+D;AAC/D,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE;QACxC,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,SAAS,CAAC;KACpD,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACxF,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAEvE,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACtD,OAAO,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,oBAAmC;IAEnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7E,MAAM,eAAe,GAAqE,EAAE,CAAC;IAC7F,KAAK,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxD,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAC9C,MAAM,IAAI,GAAG,eAAe,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;QAC9D,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACzC,eAAe,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,eAAe,CAAC,aAA4B;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,4BAA4B,CAAC,aAAa,CAAC;QAClD,aAAa;QACb,MAAM,EAAE,aAAa,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAAc,EACd,oBAAmC;IAEnC,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,EAAE;QACvC,QAAQ,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC;QACrC,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,KAAK,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAC/E,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,EAAE;QACzC,QAAQ,EAAE,CAAC,WAAW,EAAE,sBAAsB,EAAE,YAAY,CAAC;KAC9D,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,oBAAoB,GAAG,cAAc,CACzC,MAAM,CAAC,oBAAoB,EAC3B,qCAAqC,CACtC,CAAC;IACF,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IAChF,IAAI,SAAS,KAAK,SAAS,IAAI,oBAAoB,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC9F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,UAAU,EAAE,CAAC,CAAC;AACxE,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,EAAE,CAAC,SAAS,CAAC;IAC1D,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,EAAE;QAC5C,QAAQ,EAAE,CAAC,wBAAwB,EAAE,SAAS,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,yBAAyB,CAAC;IAC/D,MAAM,SAAS,GAAG,6BAA6B,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAClF,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;QAC5F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,yBAAyB,EAAE,4BAA4B;YACvD,OAAO,EAAE,wCAAwC;SAClD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,EAAE;QAC5C,QAAQ,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC;KACnD,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,yBAAyB,GAC7B,SAAS,CAAC,yBAAyB,IAAI,4BAA4B,CAAC;IACtE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,wCAAwC,CAAC;IAC9E,OAAO,mBAAmB,CAAC,yBAAyB,CAAC,IAAI,mBAAmB,CAAC,OAAO,CAAC;QACnF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC;QACvD,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CACrB,KAAc,EACd,QAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACrE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC1C,OAAO,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC/E,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC;gBACpC,yBAAyB,EAAE,4BAA4B;gBACvD,OAAO,EAAE,wCAAwC;aAClD,CAAC;YACF,OAAO,EAAE,yBAAyB;SACnC,CAAC;QACF,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QACvF,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,yBAAyB,EAAE,CAAC,CAAC;IACzF,MAAM,OAAO,GAAG,oBAAoB,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC;IAC1E,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,yBAAyB,CAAC;IACnE,OAAO,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,SAAS,oBAAoB,CAC3B,KAAc,EACd,IAAsB;IAEtB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,CAAC,gCAAgC,CAAC,MAAM,EAAE;YACxC,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;YAC7B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;SAC9B,CAAC,EACF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC","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"]}
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,sBAAsB,EACtB,wBAAwB,EACxB,oBAAoB,EAErB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AACrG,OAAO,EAAE,qCAAqC,EAAE,MAAM,8BAA8B,CAAC;AACrF,OAAO,EAIN,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,qCAAqC,EAAE,MAAM,mBAAmB,CAAC;AAE1E,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,wCAAwC,GAAG,GAAG,CAAC;AACrD,MAAM,4BAA4B,GAAG,CAAC,CAAC;AACvC,MAAM,qCAAqC,GAAG,EAAE,CAAC;AACjD,MAAM,6BAA6B,GAAG,CAAC,CAAC;AACxC,MAAM,yBAAyB,GAAG,CAAC,CAAC;AACpC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,2BAA2B,CAAC,OAAO;IAC5C,OAAO,EAAE,qCAAqC;IAC9C,MAAM,EAAE,2BAA2B,CAAC,MAAM;CAC3C,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,UAAU,6BAA6B,CAC3C,KAAc;IAEd,MAAM,KAAK,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAC9C,QAAQ,EAAE,CAAC,WAAW,EAAE,eAAe,EAAE,gBAAgB,CAAC;KAC3D,CAAC,CAAC;IACH,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE1C,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACxF,IAAI,aAAa,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;IACnE,MAAM,cAAc,GAAG,6BAA6B,CAClD,KAAK,CAAC,cAAc,EACpB,qCAAqC,CACtC,CAAC;IACF,IAAI,SAAS,KAAK,SAAS,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE9E,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,CAAC;IAC7D,OAAO,mCAAmC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AAC5E,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAc,EACd,oBAAmC;IAEnC,OAAO,wBAAwB,CAC7B,KAAK,EACL,GAAG,EAAE,CAAC,eAAe,CAAC,oBAAoB,CAAC,EAC3C,CAAC,SAAS,EAAE,EAAE,CAAC,eAAe,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAChE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,aAA4B;IACnD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,4BAA4B,CAAC,aAAa,CAAC;QAClD,aAAa;QACb,MAAM,EAAE,aAAa,EAAE;KACxB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,KAAc,EACd,oBAAmC;IAEnC,MAAM,IAAI,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAC7C,QAAQ,EAAE,CAAC,eAAe,EAAE,QAAQ,CAAC;QACrC,QAAQ,EAAE,CAAC,OAAO,CAAC;KACpB,CAAC,CAAC;IACH,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,2BAA2B,CAAC,IAAI,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IACrE,MAAM,aAAa,GAAG,oBAAoB,CAAC,IAAI,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;IACrF,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,KAAK,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS;QAC/E,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,EAAE,CAAC;IAChD,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAC/C,QAAQ,EAAE,CAAC,WAAW,EAAE,sBAAsB,EAAE,cAAc,EAAE,YAAY,CAAC;KAC9E,CAAC,CAAC;IACH,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1D,MAAM,oBAAoB,GAAG,cAAc,CACzC,MAAM,CAAC,oBAAoB,EAC3B,qCAAqC,CACtC,CAAC;IACF,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,YAAY,EAAE,6BAA6B,CAAC,CAAC;IACxF,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,CAAC,UAAU,EAAE,yBAAyB,CAAC,CAAC;IAChF,IACE,SAAS,KAAK,SAAS;QACvB,oBAAoB,KAAK,SAAS;QAClC,YAAY,KAAK,SAAS;QAC1B,UAAU,KAAK,SAAS,EACxB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,oBAAoB,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,CAAC;AACtF,CAAC;AAED,SAAS,qBAAqB,CAC5B,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,aAAa,EAAE,CAAC,SAAS,CAAC;IAC1D,MAAM,SAAS,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAClD,QAAQ,EAAE,CAAC,wBAAwB,EAAE,SAAS,CAAC;KAChD,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,yBAAyB,CAAC;IAC/D,MAAM,SAAS,GAAG,6BAA6B,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;IAClF,IAAI,CAAC,qBAAqB,CAAC,OAAO,CAAC,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,CAAC,OAAO,GAAG,OAAO,EAAE,CAAC;QAC9F,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,sBAAsB,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,yBAAyB,EAAE,4BAA4B;YACvD,OAAO,EAAE,wCAAwC;SAClD,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,0BAA0B,CAAC,KAAK,EAAE;QAClD,QAAQ,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC;KACnD,CAAC,CAAC;IACH,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC9C,MAAM,yBAAyB,GAC7B,SAAS,CAAC,yBAAyB,IAAI,4BAA4B,CAAC;IACtE,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,IAAI,wCAAwC,CAAC;IAC9E,OAAO,qBAAqB,CAAC,yBAAyB,CAAC,IAAI,qBAAqB,CAAC,OAAO,CAAC;QACvF,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,yBAAyB,EAAE,OAAO,EAAE,CAAC;QACvD,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CACrB,KAAc,EACd,QAAgB;IAEhB,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,MAAM,KAAK,GAAG,0BAA0B,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IAC3E,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC;IAC1C,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC;YACvB,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAAC;gBACpC,yBAAyB,EAAE,4BAA4B;gBACvD,OAAO,EAAE,wCAAwC;aAClD,CAAC;YACF,OAAO,EAAE,yBAAyB;SACnC,CAAC;QACF,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;QACvF,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,6BAA6B,EAAE,CAAC;QACvE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,yBAAyB,EAAE,CAAC;KAClE,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { snapshotClosedPolicyRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport {\n  defaultProjectFileSelection,\n  resolveProjectFileSelection,\n  snapshotProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport {\n  DEFAULT_FINDING_POLICY,\n  resolveCodeAreaPolicyMap,\n  resolveFindingPolicy,\n  type FindingPolicy\n} from \"../code-quality-findings/policy.ts\";\nimport { resolveFindingWaiverAuthoring } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { resolveFunctionMetricsFindingIdentity } from \"./finding-waiver-identity.ts\";\nimport {\n  type ResolvedFunctionMetricsCodeAreaOptions,\n  type ResolvedFunctionMetricsLimits,\n  type ResolvedFunctionMetricsOptions\n} from \"./options.ts\";\nimport { validResolvedFunctionMetricsOptions } from \"./options-validation.ts\";\nimport { FUNCTION_METRICS_SUPPORTED_FILE_GLOBS } from \"./target-files.ts\";\n\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_NESTING_DEPTH_MAXIMUM = 7;\nconst DEFAULT_PARAMETER_MAXIMUM = 6;\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: FUNCTION_METRICS_SUPPORTED_FILE_GLOBS,\n  source: defaultProjectFileSelection.source\n});\n\n/** 校验 constructor input，并物化完整、冻结的 function-metrics options。 */\nexport function resolveFunctionMetricsOptions(\n  value: unknown\n): ResolvedFunctionMetricsOptions | undefined {\n  const input = snapshotClosedPolicyRecord(value, {\n    optional: [\"codeAreas\", \"findingPolicy\", \"findingWaivers\"]\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 findingWaivers = resolveFindingWaiverAuthoring(\n    input.findingWaivers,\n    resolveFunctionMetricsFindingIdentity\n  );\n  if (codeAreas === undefined || findingWaivers === undefined) return undefined;\n\n  const options = Object.freeze({ codeAreas, findingWaivers });\n  return validResolvedFunctionMetricsOptions(options) ? options : undefined;\n}\n\nfunction resolveCodeAreas(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFunctionMetricsOptions[\"codeAreas\"] | undefined {\n  return resolveCodeAreaPolicyMap(\n    value,\n    () => defaultCodeArea(defaultFindingPolicy),\n    (candidate) => resolveCodeArea(candidate, defaultFindingPolicy)\n  );\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 = snapshotClosedPolicyRecord(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 = snapshotClosedPolicyRecord(value, {\n    optional: [\"codeLines\", \"cyclomaticComplexity\", \"nestingDepth\", \"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 nestingDepth = resolveMaximum(limits.nestingDepth, DEFAULT_NESTING_DEPTH_MAXIMUM);\n  const parameters = resolveMaximum(limits.parameters, DEFAULT_PARAMETER_MAXIMUM);\n  if (\n    codeLines === undefined ||\n    cyclomaticComplexity === undefined ||\n    nestingDepth === undefined ||\n    parameters === undefined\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ codeLines, cyclomaticComplexity, nestingDepth, parameters });\n}\n\nfunction resolveCodeLineLimits(\n  value: unknown\n): ResolvedFunctionMetricsLimits[\"codeLines\"] | undefined {\n  if (value === undefined) return defaultLimits().codeLines;\n  const codeLines = snapshotClosedPolicyRecord(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 (!isPositiveSafeInteger(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 = snapshotClosedPolicyRecord(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 isPositiveSafeInteger(cyclomaticComplexityBelow) && isPositiveSafeInteger(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 = snapshotClosedPolicyRecord(value, { optional: [\"maximum\"] });\n  if (input === undefined) return undefined;\n  const maximum = input.maximum ?? fallback;\n  return isPositiveSafeInteger(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    nestingDepth: Object.freeze({ maximum: DEFAULT_NESTING_DEPTH_MAXIMUM }),\n    parameters: Object.freeze({ maximum: DEFAULT_PARAMETER_MAXIMUM })\n  });\n}\n"]}

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

@@ -1,18 +1,23 @@
-import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString, isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { validProjectFileSelection } from "../project-files/configuration.mjs";
 import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { validResolvedFindingWaivers } from "../code-quality-findings/finding-waiver-authoring.mjs";
+import { resolveFunctionMetricsFindingIdentity } from "./finding-waiver-identity.mjs";
 /** 验证 constructor 已物化的完整 function-metrics options。 */
 export function validResolvedFunctionMetricsOptions(value) {
-    const options = exactRecord(value, ["codeAreas", "scanner"]);
-    return (options !== undefined && validCodeAreas(options.codeAreas) && validScanner(options.scanner));
+    const options = snapshotExactClosedRecord(value, ["codeAreas", "findingWaivers"]);
+    return (options !== undefined &&
+        validCodeAreas(options.codeAreas) &&
+        validResolvedFindingWaivers(options.findingWaivers, resolveFunctionMetricsFindingIdentity));
 }
 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) &&
+        const area = snapshotExactClosedRecord(candidate, ["files", "findingPolicy", "limits"]);
+        return (isNonEmptyString(areaId) &&
             area !== undefined &&
             validProjectFileSelection(area.files) &&
             validFindingPolicy(area.findingPolicy) &&
@@ -20,52 +25,42 @@ function validCodeAreas(value) {
     });
 }
 function validLimits(value) {
-    const limits = exactRecord(value, ["codeLines", "cyclomaticComplexity", "parameters"]);
+    const limits = snapshotExactClosedRecord(value, [
+        "codeLines",
+        "cyclomaticComplexity",
+        "nestingDepth",
+        "parameters"
+    ]);
     if (limits === undefined)
         return false;
     const codeLineLimits = codeLineLimitsFrom(limits.codeLines);
     const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);
+    const nestingDepth = maximumLimitFrom(limits.nestingDepth);
     const parameters = maximumLimitFrom(limits.parameters);
     return (codeLineLimits !== undefined &&
         cyclomaticComplexity !== undefined &&
+        nestingDepth !== undefined &&
         parameters !== undefined &&
-        positiveSafeInteger(cyclomaticComplexity.maximum) &&
-        positiveSafeInteger(parameters.maximum));
+        isPositiveSafeInteger(cyclomaticComplexity.maximum) &&
+        isPositiveSafeInteger(nestingDepth.maximum) &&
+        isPositiveSafeInteger(parameters.maximum));
 }
 function codeLineLimitsFrom(value) {
-    const codeLines = exactRecord(value, ["lowComplexityAllowance", "maximum"]);
-    const allowance = exactRecord(codeLines?.lowComplexityAllowance, [
+    const codeLines = snapshotExactClosedRecord(value, ["lowComplexityAllowance", "maximum"]);
+    const allowance = snapshotExactClosedRecord(codeLines?.lowComplexityAllowance, [
         "cyclomaticComplexityBelow",
         "maximum"
     ]);
     return codeLines !== undefined &&
         allowance !== undefined &&
-        positiveSafeInteger(codeLines.maximum) &&
-        positiveSafeInteger(allowance.maximum) &&
+        isPositiveSafeInteger(codeLines.maximum) &&
+        isPositiveSafeInteger(allowance.maximum) &&
         allowance.maximum >= codeLines.maximum &&
-        positiveSafeInteger(allowance.cyclomaticComplexityBelow)
+        isPositiveSafeInteger(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;
+    return snapshotExactClosedRecord(value, ["maximum"]);
 }
 //# sourceMappingURL=options-validation.mjs.map

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

@@ -1 +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"]}
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  snapshotClosedRecord,\n  snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString, isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { validResolvedFindingWaivers } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { resolveFunctionMetricsFindingIdentity } from \"./finding-waiver-identity.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 = snapshotExactClosedRecord(value, [\"codeAreas\", \"findingWaivers\"]);\n  return (\n    options !== undefined &&\n    validCodeAreas(options.codeAreas) &&\n    validResolvedFindingWaivers(options.findingWaivers, resolveFunctionMetricsFindingIdentity)\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 = snapshotExactClosedRecord(candidate, [\"files\", \"findingPolicy\", \"limits\"]);\n    return (\n      isNonEmptyString(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 = snapshotExactClosedRecord(value, [\n    \"codeLines\",\n    \"cyclomaticComplexity\",\n    \"nestingDepth\",\n    \"parameters\"\n  ]);\n  if (limits === undefined) return false;\n  const codeLineLimits = codeLineLimitsFrom(limits.codeLines);\n  const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);\n  const nestingDepth = maximumLimitFrom(limits.nestingDepth);\n  const parameters = maximumLimitFrom(limits.parameters);\n  return (\n    codeLineLimits !== undefined &&\n    cyclomaticComplexity !== undefined &&\n    nestingDepth !== undefined &&\n    parameters !== undefined &&\n    isPositiveSafeInteger(cyclomaticComplexity.maximum) &&\n    isPositiveSafeInteger(nestingDepth.maximum) &&\n    isPositiveSafeInteger(parameters.maximum)\n  );\n}\n\nfunction codeLineLimitsFrom(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  const codeLines = snapshotExactClosedRecord(value, [\"lowComplexityAllowance\", \"maximum\"]);\n  const allowance = snapshotExactClosedRecord(codeLines?.lowComplexityAllowance, [\n    \"cyclomaticComplexityBelow\",\n    \"maximum\"\n  ]);\n  return codeLines !== undefined &&\n    allowance !== undefined &&\n    isPositiveSafeInteger(codeLines.maximum) &&\n    isPositiveSafeInteger(allowance.maximum) &&\n    allowance.maximum >= codeLines.maximum &&\n    isPositiveSafeInteger(allowance.cyclomaticComplexityBelow)\n    ? codeLines\n    : undefined;\n}\n\nfunction maximumLimitFrom(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  return snapshotExactClosedRecord(value, [\"maximum\"]);\n}\n"]}