@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/package-checks/function-metrics/analyzer/extensions/protocol.mjs

@@ -0,0 +1,180 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Sources: lizard_ext/extension_base.py and lizard_ext/lizard*.py extension
+ * contracts.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: MIT
+ * Modified: translated to the analyzer-internal extension protocol; this is
+ * not exported through the product API as a plugin surface.
+ */
+/** Resolve metadata with the same descriptor precedence used by extension hooks. */
+export function extensionMetadata(extension) {
+    return {
+        get ordering_index() {
+            const attribute = resolveExtensionAttribute(extension, "ordering_index");
+            return attribute === undefined ? undefined : readOrderingIndex(attribute.value);
+        },
+        get FUNCTION_INFO() {
+            const attribute = resolveExtensionAttribute(extension, "FUNCTION_INFO");
+            return attribute === undefined ? undefined : readFunctionInfoDefinitions(attribute.value);
+        },
+        get silent_all_others() {
+            const attribute = resolveExtensionAttribute(extension, "silent_all_others");
+            // Upstream tests presence with hasattr; the stored value is not interpreted.
+            return attribute === undefined ? undefined : true;
+        }
+    };
+}
+export function resolveExtensionHook(extension, hookName) {
+    const hook = resolveExtensionAttribute(extension, hookName);
+    if (hook === undefined)
+        return undefined;
+    if (!isUnknownFunction(hook.value)) {
+        throw new TypeError(`Lizard extension ${hookName} hook is not callable.`);
+    }
+    return hook.value.bind(hook.receiver);
+}
+/** Resolve Python's special __call__ lookup from the extension type, ignoring its own dictionary. */
+export function resolveExtensionCall(extension) {
+    const call = resolveExtensionSpecialMethod(extension, "__call__");
+    if (call === undefined)
+        return undefined;
+    if (!isExtensionCall(call.value)) {
+        throw new TypeError("Lizard extension __call__ hook is not callable.");
+    }
+    return call.value.bind(call.receiver);
+}
+/** Invoke a token hook and reject an extension that supplies neither source hook form. */
+export function invokeExtensionCall(extension, tokens, reader) {
+    const call = resolveExtensionCall(extension);
+    if (call === undefined)
+        throw new TypeError("Lizard extension is missing a callable __call__ hook.");
+    return call(tokens, reader);
+}
+/** Invoke an optional cross-file hook with source instance/static resolution. */
+export function invokeExtensionCrossFileProcess(extension, fileInfos) {
+    const outcome = invokeExtensionCrossFileProcessOutcome(extension, fileInfos);
+    return outcome.hookPresent ? outcome.result : undefined;
+}
+/** Invoke a cross-file hook without collapsing a present undefined result into absence. */
+export function invokeExtensionCrossFileProcessOutcome(extension, fileInfos) {
+    const crossFileProcess = resolveExtensionHook(extension, "cross_file_process");
+    if (crossFileProcess === undefined)
+        return { hookPresent: false };
+    return { hookPresent: true, result: crossFileProcess(fileInfos) };
+}
+/** Invoke an optional result hook with source instance/static resolution. */
+export function invokeExtensionPrintResult(extension) {
+    resolveExtensionHook(extension, "print_result")?.();
+}
+/** Invoke an optional argument hook with source instance/static resolution. */
+export function invokeExtensionSetArgs(extension, parser) {
+    resolveExtensionHook(extension, "set_args")?.(parser);
+}
+/**
+ * Model Python's per-class MRO precedence across TypeScript's split prototype
+ * and static namespaces. An own instance member wins at its class level, while
+ * a subclass static member still shadows an inherited instance member.
+ */
+function resolveExtensionAttribute(extension, attributeName) {
+    if (typeof extension === "function") {
+        return resolveClassAttribute(extension, attributeName);
+    }
+    const ownAttribute = readOwnAttribute(extension, extension, attributeName);
+    if (ownAttribute !== undefined)
+        return ownAttribute;
+    return resolveInstanceTypeAttribute(extension, attributeName);
+}
+function resolveExtensionSpecialMethod(extension, methodName) {
+    if (typeof extension === "function") {
+        return resolveClassAttribute(extension, methodName);
+    }
+    return resolveInstanceTypeAttribute(extension, methodName);
+}
+function resolveInstanceTypeAttribute(extension, attributeName) {
+    let prototype = readPrototype(extension);
+    while (prototype !== null && prototype !== Object.prototype) {
+        const instanceAttribute = readOwnAttribute(prototype, extension, attributeName);
+        if (instanceAttribute !== undefined)
+            return instanceAttribute;
+        const constructorDescriptor = Object.getOwnPropertyDescriptor(prototype, "constructor");
+        const extensionClass = constructorDescriptor?.value;
+        if (isRecord(extensionClass)) {
+            const staticAttribute = readOwnAttribute(extensionClass, extensionClass, attributeName);
+            if (staticAttribute !== undefined)
+                return staticAttribute;
+        }
+        prototype = readPrototype(prototype);
+    }
+    return undefined;
+}
+function resolveClassAttribute(extensionClass, attributeName) {
+    let currentClass = extensionClass;
+    while (currentClass !== null && currentClass !== Function.prototype) {
+        const attribute = readOwnAttribute(currentClass, currentClass, attributeName);
+        if (attribute !== undefined)
+            return attribute;
+        currentClass = readPrototype(currentClass);
+    }
+    return undefined;
+}
+function readOwnAttribute(owner, receiver, attributeName) {
+    if (Object.getOwnPropertyDescriptor(owner, attributeName) === undefined)
+        return undefined;
+    const value = Reflect.get(owner, attributeName, receiver);
+    return {
+        receiver,
+        value
+    };
+}
+function readPrototype(value) {
+    const prototype = Object.getPrototypeOf(value);
+    if (prototype === null || isRecord(prototype))
+        return prototype;
+    throw new TypeError("Lizard extension prototype must be an object or null.");
+}
+function readOrderingIndex(value) {
+    if (typeof value !== "number") {
+        throw new TypeError("Lizard extension ordering_index metadata must be a number.");
+    }
+    return value;
+}
+function readFunctionInfoDefinitions(value) {
+    if (!isObjectRecord(value)) {
+        throw new TypeError("Lizard extension FUNCTION_INFO metadata must be a record.");
+    }
+    const definitions = {};
+    for (const [name, definition] of Object.entries(value)) {
+        if (!isObjectRecord(definition)) {
+            throw new TypeError(`Lizard extension FUNCTION_INFO['${name}'] must be a record.`);
+        }
+        const caption = readOptionalCaption(definition.caption, name, "caption");
+        const averageCaption = readOptionalCaption(definition.average_caption, name, "average_caption");
+        definitions[name] = {
+            ...(caption === undefined ? {} : { caption }),
+            ...(averageCaption === undefined ? {} : { average_caption: averageCaption })
+        };
+    }
+    return definitions;
+}
+function readOptionalCaption(value, definitionName, captionName) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== "string") {
+        throw new TypeError(`Lizard extension FUNCTION_INFO['${definitionName}'].${captionName} must be a string.`);
+    }
+    return value;
+}
+function isRecord(value) {
+    return (typeof value === "object" && value !== null) || typeof value === "function";
+}
+function isObjectRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isUnknownFunction(value) {
+    return typeof value === "function";
+}
+function isExtensionCall(value) {
+    return typeof value === "function";
+}
+//# sourceMappingURL=protocol.mjs.map

package/dist/esm/package-checks/function-metrics/analyzer/extensions/protocol.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.mjs","sourceRoot":"","sources":["../../../../../../src/package-checks/function-metrics/analyzer/extensions/protocol.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Derived from terryyin/lizard 1.24.0.\n * Sources: lizard_ext/extension_base.py and lizard_ext/lizard*.py extension\n * contracts.\n * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.\n * SPDX-License-Identifier: MIT\n * Modified: translated to the analyzer-internal extension protocol; this is\n * not exported through the product API as a plugin surface.\n */\n\nimport type { AnalyzerReader, TokenStream } from \"../contracts.ts\";\nimport type { FileInformation } from \"../analysis-model.ts\";\n\n/** Metadata an extension contributes to FunctionInfo/report schemas. */\nexport interface FunctionInfoDefinition {\n  readonly caption?: string;\n  readonly average_caption?: string;\n}\n\n/** The source-aligned FUNCTION_INFO mapping owned by one extension. */\nexport type FunctionInfoDefinitions = Readonly<Record<string, FunctionInfoDefinition>>;\n\n/** Python `argparse.add_argument` keyword options used by translated bodies. */\nexport interface ExtensionArgumentKeywordOptions {\n  readonly default?: number;\n  readonly dest?: string;\n  readonly help?: string;\n  /** The source `type=int` conversion contract. */\n  readonly type?: \"int\";\n}\n\n/** The minimal internal parser seam consumed by source set_args hooks. */\nexport interface ExtensionArgumentRegistrar {\n  add_argument(...arguments_: readonly (string | ExtensionArgumentKeywordOptions)[]): void;\n}\n\n/** A source-aligned extension token processor. */\nexport type ExtensionCall = (tokens: TokenStream, reader: AnalyzerReader) => TokenStream;\n\n/** A source-aligned extension cross-file processor. */\nexport type ExtensionCrossFileProcess = {\n  bivarianceHack(\n    fileInfos: Iterable<FileInformation> | undefined\n  ): Iterable<FileInformation> | undefined;\n}[\"bivarianceHack\"];\n\n/** Preserve the distinction between an absent hook and a present hook returning undefined. */\nexport type ExtensionCrossFileProcessOutcome =\n  | { readonly hookPresent: false }\n  | {\n      readonly hookPresent: true;\n      readonly result: Iterable<FileInformation> | undefined;\n    };\n\n/** A source-aligned extension result printer. */\nexport type ExtensionPrintResult = () => void;\n\n/** A source-aligned extension argument registrar. */\nexport type ExtensionSetArgs = (parser: ExtensionArgumentRegistrar) => void;\n\n/**\n * The internal protocol shared by translated Lizard extension bodies.  Hooks\n * are optional here because Python permits class-level static hooks that are\n * resolved from an instantiated extension.\n */\nexport interface LizardExtension {\n  __call__?: ExtensionCall;\n  readonly ordering_index?: number;\n  readonly FUNCTION_INFO?: FunctionInfoDefinitions;\n  readonly silent_all_others?: boolean;\n  cross_file_process?: ExtensionCrossFileProcess;\n  print_result?: ExtensionPrintResult;\n  set_args?: ExtensionSetArgs;\n}\n\n/** Python resolves extension class attributes and static methods through instances. */\nexport interface LizardExtensionClassMetadata {\n  readonly ordering_index?: number | undefined;\n  readonly FUNCTION_INFO?: FunctionInfoDefinitions | undefined;\n  readonly silent_all_others?: boolean | undefined;\n}\n\n/** A directly registered class is an opaque descriptor, not a constructor to invoke at load time. */\nexport type LizardExtensionConstructor = LizardExtensionClassMetadata & {\n  readonly prototype: LizardExtension;\n};\n\n/** One non-string value retained verbatim by source-aligned registration. */\nexport type RegisteredLizardExtension = LizardExtension | LizardExtensionConstructor;\n\n/** Any processor object on which upstream performs hasattr-style lifecycle lookup. */\nexport type LizardExtensionDescriptor = object;\n\n/** Accepted internal extension registration inputs. */\nexport type ExtensionInput = string | RegisteredLizardExtension;\n\n/** Ordinary hook names resolved through Python's instance attribute lookup. */\nexport type ExtensionHookName = \"cross_file_process\" | \"print_result\" | \"set_args\";\n\n/** Resolve metadata with the same descriptor precedence used by extension hooks. */\nexport function extensionMetadata(\n  extension: LizardExtensionDescriptor\n): LizardExtensionClassMetadata {\n  return {\n    get ordering_index(): number | undefined {\n      const attribute = resolveExtensionAttribute(extension, \"ordering_index\");\n      return attribute === undefined ? undefined : readOrderingIndex(attribute.value);\n    },\n    get FUNCTION_INFO(): FunctionInfoDefinitions | undefined {\n      const attribute = resolveExtensionAttribute(extension, \"FUNCTION_INFO\");\n      return attribute === undefined ? undefined : readFunctionInfoDefinitions(attribute.value);\n    },\n    get silent_all_others(): boolean | undefined {\n      const attribute = resolveExtensionAttribute(extension, \"silent_all_others\");\n      // Upstream tests presence with hasattr; the stored value is not interpreted.\n      return attribute === undefined ? undefined : true;\n    }\n  };\n}\n\n/** Resolve a cross-file hook through ordinary Python instance attribute lookup. */\nexport function resolveExtensionHook(\n  extension: LizardExtensionDescriptor,\n  hookName: \"cross_file_process\"\n): ExtensionCrossFileProcess | undefined;\n/** Resolve a result hook through ordinary Python instance attribute lookup. */\nexport function resolveExtensionHook(\n  extension: LizardExtensionDescriptor,\n  hookName: \"print_result\"\n): ExtensionPrintResult | undefined;\n/** Resolve an argument hook through ordinary Python instance attribute lookup. */\nexport function resolveExtensionHook(\n  extension: LizardExtensionDescriptor,\n  hookName: \"set_args\"\n): ExtensionSetArgs | undefined;\nexport function resolveExtensionHook(\n  extension: LizardExtensionDescriptor,\n  hookName: ExtensionHookName\n): ((...arguments_: never[]) => unknown) | undefined {\n  const hook = resolveExtensionAttribute(extension, hookName);\n  if (hook === undefined) return undefined;\n  if (!isUnknownFunction(hook.value)) {\n    throw new TypeError(`Lizard extension ${hookName} hook is not callable.`);\n  }\n  return hook.value.bind(hook.receiver);\n}\n\n/** Resolve Python's special __call__ lookup from the extension type, ignoring its own dictionary. */\nexport function resolveExtensionCall(\n  extension: LizardExtensionDescriptor\n): ExtensionCall | undefined {\n  const call = resolveExtensionSpecialMethod(extension, \"__call__\");\n  if (call === undefined) return undefined;\n  if (!isExtensionCall(call.value)) {\n    throw new TypeError(\"Lizard extension __call__ hook is not callable.\");\n  }\n  return call.value.bind(call.receiver);\n}\n\n/** Invoke a token hook and reject an extension that supplies neither source hook form. */\nexport function invokeExtensionCall(\n  extension: LizardExtensionDescriptor,\n  tokens: TokenStream,\n  reader: AnalyzerReader\n): TokenStream {\n  const call = resolveExtensionCall(extension);\n  if (call === undefined)\n    throw new TypeError(\"Lizard extension is missing a callable __call__ hook.\");\n  return call(tokens, reader);\n}\n\n/** Invoke an optional cross-file hook with source instance/static resolution. */\nexport function invokeExtensionCrossFileProcess(\n  extension: LizardExtensionDescriptor,\n  fileInfos: Iterable<FileInformation> | undefined\n): Iterable<FileInformation> | undefined {\n  const outcome = invokeExtensionCrossFileProcessOutcome(extension, fileInfos);\n  return outcome.hookPresent ? outcome.result : undefined;\n}\n\n/** Invoke a cross-file hook without collapsing a present undefined result into absence. */\nexport function invokeExtensionCrossFileProcessOutcome(\n  extension: LizardExtensionDescriptor,\n  fileInfos: Iterable<FileInformation> | undefined\n): ExtensionCrossFileProcessOutcome {\n  const crossFileProcess = resolveExtensionHook(extension, \"cross_file_process\");\n  if (crossFileProcess === undefined) return { hookPresent: false };\n  return { hookPresent: true, result: crossFileProcess(fileInfos) };\n}\n\n/** Invoke an optional result hook with source instance/static resolution. */\nexport function invokeExtensionPrintResult(extension: LizardExtensionDescriptor): void {\n  resolveExtensionHook(extension, \"print_result\")?.();\n}\n\n/** Invoke an optional argument hook with source instance/static resolution. */\nexport function invokeExtensionSetArgs(\n  extension: LizardExtensionDescriptor,\n  parser: ExtensionArgumentRegistrar\n): void {\n  resolveExtensionHook(extension, \"set_args\")?.(parser);\n}\n\ninterface ResolvedExtensionAttribute {\n  readonly receiver: object;\n  readonly value: unknown;\n}\n\n/**\n * Model Python's per-class MRO precedence across TypeScript's split prototype\n * and static namespaces. An own instance member wins at its class level, while\n * a subclass static member still shadows an inherited instance member.\n */\nfunction resolveExtensionAttribute(\n  extension: LizardExtensionDescriptor,\n  attributeName: string\n): ResolvedExtensionAttribute | undefined {\n  if (typeof extension === \"function\") {\n    return resolveClassAttribute(extension, attributeName);\n  }\n\n  const ownAttribute = readOwnAttribute(extension, extension, attributeName);\n  if (ownAttribute !== undefined) return ownAttribute;\n\n  return resolveInstanceTypeAttribute(extension, attributeName);\n}\n\nfunction resolveExtensionSpecialMethod(\n  extension: LizardExtensionDescriptor,\n  methodName: \"__call__\"\n): ResolvedExtensionAttribute | undefined {\n  if (typeof extension === \"function\") {\n    return resolveClassAttribute(extension, methodName);\n  }\n  return resolveInstanceTypeAttribute(extension, methodName);\n}\n\nfunction resolveInstanceTypeAttribute(\n  extension: object,\n  attributeName: string\n): ResolvedExtensionAttribute | undefined {\n  let prototype = readPrototype(extension);\n  while (prototype !== null && prototype !== Object.prototype) {\n    const instanceAttribute = readOwnAttribute(prototype, extension, attributeName);\n    if (instanceAttribute !== undefined) return instanceAttribute;\n\n    const constructorDescriptor = Object.getOwnPropertyDescriptor(prototype, \"constructor\");\n    const extensionClass: unknown = constructorDescriptor?.value;\n    if (isRecord(extensionClass)) {\n      const staticAttribute = readOwnAttribute(extensionClass, extensionClass, attributeName);\n      if (staticAttribute !== undefined) return staticAttribute;\n    }\n\n    prototype = readPrototype(prototype);\n  }\n  return undefined;\n}\n\nfunction resolveClassAttribute(\n  extensionClass: object,\n  attributeName: string\n): ResolvedExtensionAttribute | undefined {\n  let currentClass: object | null = extensionClass;\n  while (currentClass !== null && currentClass !== Function.prototype) {\n    const attribute = readOwnAttribute(currentClass, currentClass, attributeName);\n    if (attribute !== undefined) return attribute;\n    currentClass = readPrototype(currentClass);\n  }\n  return undefined;\n}\n\nfunction readOwnAttribute(\n  owner: object,\n  receiver: object,\n  attributeName: string\n): ResolvedExtensionAttribute | undefined {\n  if (Object.getOwnPropertyDescriptor(owner, attributeName) === undefined) return undefined;\n  const value: unknown = Reflect.get(owner, attributeName, receiver);\n  return {\n    receiver,\n    value\n  };\n}\n\nfunction readPrototype(value: object): object | null {\n  const prototype: unknown = Object.getPrototypeOf(value);\n  if (prototype === null || isRecord(prototype)) return prototype;\n  throw new TypeError(\"Lizard extension prototype must be an object or null.\");\n}\n\nfunction readOrderingIndex(value: unknown): number {\n  if (typeof value !== \"number\") {\n    throw new TypeError(\"Lizard extension ordering_index metadata must be a number.\");\n  }\n  return value;\n}\n\nfunction readFunctionInfoDefinitions(value: unknown): FunctionInfoDefinitions {\n  if (!isObjectRecord(value)) {\n    throw new TypeError(\"Lizard extension FUNCTION_INFO metadata must be a record.\");\n  }\n  const definitions: Record<string, FunctionInfoDefinition> = {};\n  for (const [name, definition] of Object.entries(value)) {\n    if (!isObjectRecord(definition)) {\n      throw new TypeError(`Lizard extension FUNCTION_INFO['${name}'] must be a record.`);\n    }\n    const caption = readOptionalCaption(definition.caption, name, \"caption\");\n    const averageCaption = readOptionalCaption(definition.average_caption, name, \"average_caption\");\n    definitions[name] = {\n      ...(caption === undefined ? {} : { caption }),\n      ...(averageCaption === undefined ? {} : { average_caption: averageCaption })\n    };\n  }\n  return definitions;\n}\n\nfunction readOptionalCaption(\n  value: unknown,\n  definitionName: string,\n  captionName: \"average_caption\" | \"caption\"\n): string | undefined {\n  if (value === undefined) return undefined;\n  if (typeof value !== \"string\") {\n    throw new TypeError(\n      `Lizard extension FUNCTION_INFO['${definitionName}'].${captionName} must be a string.`\n    );\n  }\n  return value;\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n  return (typeof value === \"object\" && value !== null) || typeof value === \"function\";\n}\n\nfunction isObjectRecord(value: unknown): value is Record<string, unknown> {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isUnknownFunction(value: unknown): value is (...arguments_: unknown[]) => unknown {\n  return typeof value === \"function\";\n}\n\nfunction isExtensionCall(value: unknown): value is ExtensionCall {\n  return typeof value === \"function\";\n}\n"]}

package/dist/esm/package-checks/function-metrics/analyzer/extensions/registry.mjs

@@ -0,0 +1,121 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Sources: lizard.py:get_extensions and lizard_ext/lizard*.py module names.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: Apache-2.0 AND MIT
+ * Modified: translated to an analyzer-internal registration table. Deferred
+ * bodies fail explicitly rather than pretending to process source.
+ */
+import { DEFAULT_TOKEN_PROCESSORS } from "../pipeline.mjs";
+import { LizardExtension as ComplexTagsExtension } from "./lizardcomplextags.mjs";
+import { LizardExtension as NestingDepthExtension } from "./lizardnd.mjs";
+import { extensionMetadata } from "./protocol.mjs";
+/** Explicitly fail named loads until their source body is translated. */
+export class DeferredExtensionBodyError extends Error {
+    extensionName;
+    sourcePath;
+    constructor(registration) {
+        super(`Lizard extension body '${registration.name}' is deferred and cannot be loaded: ${registration.sourcePath}`);
+        this.name = "DeferredExtensionBodyError";
+        this.extensionName = registration.name;
+        this.sourcePath = registration.sourcePath;
+    }
+}
+/** All 19 upstream Lizard extension bodies in the current translation scope. */
+export const EXTENSION_REGISTRATIONS = Object.freeze([
+    deferred("boolcount"),
+    translated("complextags"),
+    deferred("cpre"),
+    deferred("dependencycount"),
+    deferred("dumpcomments"),
+    deferred("duplicate"),
+    deferred("duplicated_param_list"),
+    deferred("exitcount"),
+    deferred("gotocount"),
+    deferred("ignoreassert"),
+    deferred("io"),
+    deferred("mccabe"),
+    deferred("modified"),
+    translated("nd"),
+    deferred("nonstrict"),
+    deferred("ns"),
+    deferred("outside"),
+    deferred("statementcount"),
+    deferred("wordcount")
+]);
+/**
+ * Source-aligned get_extensions semantics: start with the five default
+ * processors, then resolve and insert each supplied extension by ordering_index.
+ */
+export function getExtensions(extensionInputs = []) {
+    const processors = [...DEFAULT_TOKEN_PROCESSORS];
+    for (const extensionInput of extensionInputs) {
+        const extension = resolveExtension(extensionInput);
+        insertAtOrderingIndex(processors, extension);
+    }
+    return processors;
+}
+/** Source `get_extensions` spelling for translated analyzer-internal callers. */
+export function get_extensions(extensionNames = []) {
+    return getExtensions(extensionNames);
+}
+/** Resolve an object/class directly, or report a known named body as deferred. */
+export function loadExtension(extensionInput) {
+    return resolveExtension(extensionInput);
+}
+function deferred(name) {
+    return {
+        name,
+        sourcePath: `lizard_ext/lizard${name}.py`,
+        status: "deferred-extension-body"
+    };
+}
+function translated(name) {
+    return {
+        name,
+        sourcePath: `lizard_ext/lizard${name}.py`,
+        status: "translated"
+    };
+}
+function resolveExtension(extensionInput) {
+    if (typeof extensionInput === "string")
+        return loadNamedExtension(extensionInput);
+    return extensionInput;
+}
+function loadNamedExtension(name) {
+    const registration = EXTENSION_REGISTRATIONS.find((candidate) => candidate.name === name.toLowerCase());
+    if (registration === undefined) {
+        throw new Error(`Unknown Lizard extension '${name}'.`);
+    }
+    if (registration.status === "translated")
+        return translatedExtension(registration.name);
+    throw new DeferredExtensionBodyError(registration);
+}
+function translatedExtension(name) {
+    switch (name) {
+        case "complextags":
+            return new ComplexTagsExtension();
+        case "nd":
+            return new NestingDepthExtension();
+        default:
+            throw new Error(`Translated Lizard extension '${name}' has no body.`);
+    }
+}
+function insertAtOrderingIndex(processors, extension) {
+    const orderingIndex = extensionMetadata(extension).ordering_index;
+    if (orderingIndex === undefined) {
+        processors.push(extension);
+        return;
+    }
+    if (!Number.isInteger(orderingIndex)) {
+        throw new RangeError(`Invalid Lizard extension ordering_index '${String(orderingIndex)}'; expected a finite integer.`);
+    }
+    const index = normalizePythonInsertIndex(orderingIndex, processors.length);
+    processors.splice(index, 0, extension);
+}
+function normalizePythonInsertIndex(index, length) {
+    if (index < 0)
+        return Math.max(length + index, 0);
+    return Math.min(index, length);
+}
+//# sourceMappingURL=registry.mjs.map

package/dist/esm/package-checks/function-metrics/analyzer/extensions/registry.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.mjs","sourceRoot":"","sources":["../../../../../../src/package-checks/function-metrics/analyzer/extensions/registry.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Derived from terryyin/lizard 1.24.0.\n * Sources: lizard.py:get_extensions and lizard_ext/lizard*.py module names.\n * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.\n * SPDX-License-Identifier: Apache-2.0 AND MIT\n * Modified: translated to an analyzer-internal registration table. Deferred\n * bodies fail explicitly rather than pretending to process source.\n */\n\nimport { DEFAULT_TOKEN_PROCESSORS } from \"../pipeline.ts\";\nimport type { AnalyzerProcessor } from \"../contracts.ts\";\nimport { LizardExtension as ComplexTagsExtension } from \"./lizardcomplextags.ts\";\nimport { LizardExtension as NestingDepthExtension } from \"./lizardnd.ts\";\nimport type { ExtensionInput, RegisteredLizardExtension } from \"./protocol.ts\";\nimport { extensionMetadata } from \"./protocol.ts\";\n\nexport type ExtensionBodyStatus = \"deferred-extension-body\" | \"translated\";\n\n/** One known upstream extension module whose body has not yet been translated. */\nexport interface ExtensionRegistration {\n  readonly name: string;\n  readonly sourcePath: string;\n  readonly status: ExtensionBodyStatus;\n}\n\n/** Explicitly fail named loads until their source body is translated. */\nexport class DeferredExtensionBodyError extends Error {\n  public readonly extensionName: string;\n  public readonly sourcePath: string;\n\n  public constructor(registration: ExtensionRegistration) {\n    super(\n      `Lizard extension body '${registration.name}' is deferred and cannot be loaded: ${registration.sourcePath}`\n    );\n    this.name = \"DeferredExtensionBodyError\";\n    this.extensionName = registration.name;\n    this.sourcePath = registration.sourcePath;\n  }\n}\n\n/** All 19 upstream Lizard extension bodies in the current translation scope. */\nexport const EXTENSION_REGISTRATIONS: readonly ExtensionRegistration[] = Object.freeze([\n  deferred(\"boolcount\"),\n  translated(\"complextags\"),\n  deferred(\"cpre\"),\n  deferred(\"dependencycount\"),\n  deferred(\"dumpcomments\"),\n  deferred(\"duplicate\"),\n  deferred(\"duplicated_param_list\"),\n  deferred(\"exitcount\"),\n  deferred(\"gotocount\"),\n  deferred(\"ignoreassert\"),\n  deferred(\"io\"),\n  deferred(\"mccabe\"),\n  deferred(\"modified\"),\n  translated(\"nd\"),\n  deferred(\"nonstrict\"),\n  deferred(\"ns\"),\n  deferred(\"outside\"),\n  deferred(\"statementcount\"),\n  deferred(\"wordcount\")\n]);\n\n/**\n * Source-aligned get_extensions semantics: start with the five default\n * processors, then resolve and insert each supplied extension by ordering_index.\n */\nexport function getExtensions(\n  extensionInputs: readonly ExtensionInput[] = []\n): AnalyzerProcessor[] {\n  const processors: AnalyzerProcessor[] = [...DEFAULT_TOKEN_PROCESSORS];\n  for (const extensionInput of extensionInputs) {\n    const extension = resolveExtension(extensionInput);\n    insertAtOrderingIndex(processors, extension);\n  }\n  return processors;\n}\n\n/** Source `get_extensions` spelling for translated analyzer-internal callers. */\nexport function get_extensions(\n  extensionNames: readonly ExtensionInput[] = []\n): AnalyzerProcessor[] {\n  return getExtensions(extensionNames);\n}\n\n/** Resolve an object/class directly, or report a known named body as deferred. */\nexport function loadExtension(extensionInput: ExtensionInput): RegisteredLizardExtension {\n  return resolveExtension(extensionInput);\n}\n\nfunction deferred(name: string): ExtensionRegistration {\n  return {\n    name,\n    sourcePath: `lizard_ext/lizard${name}.py`,\n    status: \"deferred-extension-body\"\n  };\n}\n\nfunction translated(name: \"complextags\" | \"nd\"): ExtensionRegistration {\n  return {\n    name,\n    sourcePath: `lizard_ext/lizard${name}.py`,\n    status: \"translated\"\n  };\n}\n\nfunction resolveExtension(extensionInput: ExtensionInput): RegisteredLizardExtension {\n  if (typeof extensionInput === \"string\") return loadNamedExtension(extensionInput);\n  return extensionInput;\n}\n\nfunction loadNamedExtension(name: string): RegisteredLizardExtension {\n  const registration = EXTENSION_REGISTRATIONS.find(\n    (candidate) => candidate.name === name.toLowerCase()\n  );\n  if (registration === undefined) {\n    throw new Error(`Unknown Lizard extension '${name}'.`);\n  }\n  if (registration.status === \"translated\") return translatedExtension(registration.name);\n  throw new DeferredExtensionBodyError(registration);\n}\n\nfunction translatedExtension(name: string): RegisteredLizardExtension {\n  switch (name) {\n    case \"complextags\":\n      return new ComplexTagsExtension();\n    case \"nd\":\n      return new NestingDepthExtension();\n    default:\n      throw new Error(`Translated Lizard extension '${name}' has no body.`);\n  }\n}\n\nfunction insertAtOrderingIndex(\n  processors: AnalyzerProcessor[],\n  extension: RegisteredLizardExtension\n): void {\n  const orderingIndex = extensionMetadata(extension).ordering_index;\n  if (orderingIndex === undefined) {\n    processors.push(extension as AnalyzerProcessor);\n    return;\n  }\n\n  if (!Number.isInteger(orderingIndex)) {\n    throw new RangeError(\n      `Invalid Lizard extension ordering_index '${String(orderingIndex)}'; expected a finite integer.`\n    );\n  }\n\n  const index = normalizePythonInsertIndex(orderingIndex, processors.length);\n  processors.splice(index, 0, extension as AnalyzerProcessor);\n}\n\nfunction normalizePythonInsertIndex(index: number, length: number): number {\n  if (index < 0) return Math.max(length + index, 0);\n  return Math.min(index, length);\n}\n"]}

package/dist/esm/package-checks/function-metrics/analyzer/pipeline.mjs

@@ -0,0 +1,218 @@
+/**
+ * Derived from terryyin/lizard 1.24.0.
+ * Sources: lizard.py processor order, FileAnalyzer, map_files_to_analyzer,
+ * analyze_files, and extension lifecycle hooks.
+ * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.
+ * SPDX-License-Identifier: Apache-2.0
+ * Modified: in-memory execution pipeline isolated from state and reporting.
+ */
+import { invokeExtensionCall, invokeExtensionCrossFileProcessOutcome, invokeExtensionSetArgs } from "./extensions/protocol.mjs";
+import { FileInfoBuilder } from "./analysis-context.mjs";
+import { isPythonWhitespace, splitPythonLines } from "./shared/code-reader.mjs";
+/** Python str.strip(), as used by the source comment-directive processor. */
+function stripPythonWhitespace(value) {
+    const characters = Array.from(value);
+    let firstCharacter = 0;
+    while (firstCharacter < characters.length &&
+        isPythonWhitespace(characters[firstCharacter] ?? "")) {
+        firstCharacter += 1;
+    }
+    let lastCharacter = characters.length;
+    while (lastCharacter > firstCharacter &&
+        isPythonWhitespace(characters[lastCharacter - 1] ?? "")) {
+        lastCharacter -= 1;
+    }
+    return characters.slice(firstCharacter, lastCharacter).join("");
+}
+export function preprocessing(tokens, reader) {
+    return reader.preprocess?.(tokens) ?? withoutWhitespace(tokens);
+}
+/** Upstream comment directive and generated-code handling. */
+export function* commentCounter(tokens, reader) {
+    for (const token of tokens) {
+        const comment = reader.getCommentFromToken(token);
+        if (comment === undefined) {
+            yield token;
+            continue;
+        }
+        for (const _line of splitPythonLines(comment).slice(1)) {
+            yield "\n";
+        }
+        const strippedComment = stripPythonWhitespace(comment);
+        if (strippedComment.startsWith("#lizard forgive global")) {
+            reader.context.forgiveGlobal = true;
+        }
+        else if (strippedComment.startsWith("#lizard forgives(")) {
+            const metricMatch = /#lizard forgives?\(([^)]*)\)/u.exec(strippedComment);
+            if (metricMatch?.[1] !== undefined) {
+                for (const metric of metricMatch[1].split(",")) {
+                    const trimmedMetric = stripPythonWhitespace(metric);
+                    if (trimmedMetric.length > 0) {
+                        reader.context.currentFunction.forgivenMetrics.add(trimmedMetric);
+                    }
+                }
+            }
+        }
+        else if (strippedComment.startsWith("#lizard forgive")) {
+            reader.context.forgive = true;
+        }
+        if (comment.includes("GENERATED CODE"))
+            return;
+    }
+}
+/** Upstream non-comment source-line counting. */
+export function* lineCounter(tokens, reader) {
+    const { context } = reader;
+    context.currentLine = 1;
+    let newline = 1;
+    for (const token of tokens) {
+        if (token === "\n") {
+            context.currentLine += 1;
+            newline = 1;
+            continue;
+        }
+        const embeddedNewlineCount = token.split("\n").length - 1;
+        context.currentLine += embeddedNewlineCount;
+        context.addNloc(embeddedNewlineCount + newline);
+        newline = 0;
+        yield token;
+    }
+}
+/** Upstream file and current-function token counting. */
+export function* tokenCounter(tokens, reader) {
+    const { context } = reader;
+    for (const token of tokens) {
+        context.fileinfo.tokenCount += 1;
+        context.currentFunction.tokenCount += 1;
+        yield token;
+    }
+}
+/** Upstream cyclomatic-condition counting. */
+export function* conditionCounter(tokens, reader) {
+    for (const token of tokens) {
+        if (reader.conditions.has(token))
+            reader.context.addCondition();
+        yield token;
+    }
+}
+/** The ordered default processor list from lizard.py:get_extensions. */
+export const DEFAULT_TOKEN_PROCESSORS = Object.freeze([
+    preprocessing,
+    commentCounter,
+    lineCounter,
+    tokenCounter,
+    conditionCounter
+]);
+/**
+ * Drives the in-memory half of upstream FileAnalyzer.  Reader registry and
+ * filesystem decoding stay at the product integration boundary, so callers
+ * supply the concrete reader explicitly.
+ */
+export class FileAnalyzer {
+    processors;
+    constructor(processors = DEFAULT_TOKEN_PROCESSORS) {
+        this.processors = processors;
+    }
+    analyzeSourceCode(filename, sourceCode, Reader) {
+        const context = new FileInfoBuilder(filename);
+        const reader = new Reader(context);
+        let tokens = Reader.generateTokens(sourceCode);
+        try {
+            for (const processor of this.processors)
+                tokens = applyProcessor(processor, tokens, reader);
+            for (const _token of reader.__call__(tokens, reader)) {
+                // The reader drives its state machine while the in-memory pipeline drains.
+            }
+        }
+        catch (error) {
+            if (!isRecursionLimit(error))
+                throw error;
+        }
+        return context.fileinfo;
+    }
+    /** Source `analyze_source_code` spelling retained for translated extension/core callers. */
+    analyze_source_code(filename, sourceCode, Reader) {
+        return this.analyzeSourceCode(filename, sourceCode, Reader);
+    }
+}
+/** The source-aligned default analyzer has only the five core processors. */
+export const DEFAULT_FILE_ANALYZER = new FileAnalyzer(DEFAULT_TOKEN_PROCESSORS);
+/**
+ * Source-aligned `map_files_to_analyzer` after the explicitly excluded file
+ * opening/multiprocessing entry surface has supplied in-memory source units.
+ */
+export function mapFilesToAnalyzer(files, analyzer, workingThreads) {
+    // The Product owns Worker scheduling. Retain the source argument/lifecycle
+    // without creating a second analyzer-level concurrency framework.
+    void workingThreads;
+    return mapInMemoryFiles(files, analyzer);
+}
+/** Source `map_files_to_analyzer` spelling for the retained in-memory lifecycle. */
+export function map_files_to_analyzer(files, analyzer, workingThreads) {
+    return mapFilesToAnalyzer(files, analyzer, workingThreads);
+}
+/**
+ * Source-aligned `analyze_files` lifecycle. `exts` intentionally uses Python
+ * truthiness: an omitted or empty list receives the five default processors.
+ */
+export function analyzeFiles(files, threads = 1, exts) {
+    const extensions = exts !== undefined && exts.length > 0 ? exts : [...DEFAULT_TOKEN_PROCESSORS];
+    const fileAnalyzer = new FileAnalyzer(extensions);
+    let result = mapFilesToAnalyzer(files, fileAnalyzer, threads);
+    for (const extension of extensions) {
+        const outcome = invokeExtensionCrossFileProcessOutcome(extension, result);
+        if (outcome.hookPresent)
+            result = outcome.result;
+    }
+    return result;
+}
+/** Source `analyze_files` spelling for translated internal callers. */
+export function analyze_files(files, threads = 1, exts) {
+    return analyzeFiles(files, threads, exts);
+}
+/**
+ * Apply source registration-order cross-file passes. A present hook replaces
+ * the stream even when it returns undefined; only an absent hook is skipped.
+ */
+export function applyCrossFileProcessors(fileInfos, processors) {
+    let processedFileInfos = fileInfos;
+    for (const processor of processors) {
+        const outcome = invokeExtensionCrossFileProcessOutcome(processor, processedFileInfos);
+        if (outcome.hookPresent)
+            processedFileInfos = outcome.result;
+    }
+    return processedFileInfos;
+}
+/** Forward the internal parser seam to extensions in source registration order. */
+export function registerExtensionArguments(processors, parser) {
+    for (const processor of processors) {
+        invokeExtensionSetArgs(processor, parser);
+    }
+}
+export function analyzeSourceCode(filename, sourceCode, Reader, processors = DEFAULT_TOKEN_PROCESSORS) {
+    if (processors === DEFAULT_TOKEN_PROCESSORS) {
+        return DEFAULT_FILE_ANALYZER.analyzeSourceCode(filename, sourceCode, Reader);
+    }
+    return new FileAnalyzer(processors).analyzeSourceCode(filename, sourceCode, Reader);
+}
+function* mapInMemoryFiles(files, analyzer) {
+    for (const file of files) {
+        yield analyzer.analyze_source_code(file.filename, file.sourceCode, file.reader);
+    }
+}
+function applyProcessor(processor, tokens, reader) {
+    return typeof processor === "function"
+        ? processor(tokens, reader)
+        : invokeExtensionCall(processor, tokens, reader);
+}
+function isRecursionLimit(error) {
+    return (error instanceof RangeError &&
+        (error.message.includes("call stack") || error.message.toLowerCase().includes("recursion")));
+}
+function* withoutWhitespace(tokens) {
+    for (const token of tokens) {
+        if (!isPythonWhitespace(token) || token === "\n")
+            yield token;
+    }
+}
+//# sourceMappingURL=pipeline.mjs.map

package/dist/esm/package-checks/function-metrics/analyzer/pipeline.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/function-metrics/analyzer/pipeline.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Derived from terryyin/lizard 1.24.0.\n * Sources: lizard.py processor order, FileAnalyzer, map_files_to_analyzer,\n * analyze_files, and extension lifecycle hooks.\n * Upstream revision: 308b1c3efd8c1c69bcc3eb82deeaec64fd3662ec.\n * SPDX-License-Identifier: Apache-2.0\n * Modified: in-memory execution pipeline isolated from state and reporting.\n */\n\nimport {\n  invokeExtensionCall,\n  invokeExtensionCrossFileProcessOutcome,\n  invokeExtensionSetArgs\n} from \"./extensions/protocol.ts\";\nimport type { ExtensionArgumentRegistrar } from \"./extensions/protocol.ts\";\nimport type {\n  AnalyzerProcessor,\n  AnalyzerReader,\n  ReaderConstructor,\n  TokenProcessor,\n  TokenStream\n} from \"./contracts.ts\";\nimport { FileInfoBuilder } from \"./analysis-context.ts\";\nimport type { FileInformation } from \"./analysis-model.ts\";\nimport { isPythonWhitespace, splitPythonLines } from \"./shared/code-reader.ts\";\n\n/** Python str.strip(), as used by the source comment-directive processor. */\nfunction stripPythonWhitespace(value: string): string {\n  const characters = Array.from(value);\n  let firstCharacter = 0;\n  while (\n    firstCharacter < characters.length &&\n    isPythonWhitespace(characters[firstCharacter] ?? \"\")\n  ) {\n    firstCharacter += 1;\n  }\n\n  let lastCharacter = characters.length;\n  while (\n    lastCharacter > firstCharacter &&\n    isPythonWhitespace(characters[lastCharacter - 1] ?? \"\")\n  ) {\n    lastCharacter -= 1;\n  }\n  return characters.slice(firstCharacter, lastCharacter).join(\"\");\n}\n\nexport function preprocessing(tokens: TokenStream, reader: AnalyzerReader): TokenStream {\n  return reader.preprocess?.(tokens) ?? withoutWhitespace(tokens);\n}\n\n/** Upstream comment directive and generated-code handling. */\nexport function* commentCounter(tokens: TokenStream, reader: AnalyzerReader): Generator<string> {\n  for (const token of tokens) {\n    const comment = reader.getCommentFromToken(token);\n    if (comment === undefined) {\n      yield token;\n      continue;\n    }\n\n    for (const _line of splitPythonLines(comment).slice(1)) {\n      yield \"\\n\";\n    }\n\n    const strippedComment = stripPythonWhitespace(comment);\n    if (strippedComment.startsWith(\"#lizard forgive global\")) {\n      reader.context.forgiveGlobal = true;\n    } else if (strippedComment.startsWith(\"#lizard forgives(\")) {\n      const metricMatch = /#lizard forgives?\\(([^)]*)\\)/u.exec(strippedComment);\n      if (metricMatch?.[1] !== undefined) {\n        for (const metric of metricMatch[1].split(\",\")) {\n          const trimmedMetric = stripPythonWhitespace(metric);\n          if (trimmedMetric.length > 0) {\n            reader.context.currentFunction.forgivenMetrics.add(trimmedMetric);\n          }\n        }\n      }\n    } else if (strippedComment.startsWith(\"#lizard forgive\")) {\n      reader.context.forgive = true;\n    }\n\n    if (comment.includes(\"GENERATED CODE\")) return;\n  }\n}\n\n/** Upstream non-comment source-line counting. */\nexport function* lineCounter(tokens: TokenStream, reader: AnalyzerReader): Generator<string> {\n  const { context } = reader;\n  context.currentLine = 1;\n  let newline = 1;\n\n  for (const token of tokens) {\n    if (token === \"\\n\") {\n      context.currentLine += 1;\n      newline = 1;\n      continue;\n    }\n\n    const embeddedNewlineCount = token.split(\"\\n\").length - 1;\n    context.currentLine += embeddedNewlineCount;\n    context.addNloc(embeddedNewlineCount + newline);\n    newline = 0;\n    yield token;\n  }\n}\n\n/** Upstream file and current-function token counting. */\nexport function* tokenCounter(tokens: TokenStream, reader: AnalyzerReader): Generator<string> {\n  const { context } = reader;\n  for (const token of tokens) {\n    context.fileinfo.tokenCount += 1;\n    context.currentFunction.tokenCount += 1;\n    yield token;\n  }\n}\n\n/** Upstream cyclomatic-condition counting. */\nexport function* conditionCounter(tokens: TokenStream, reader: AnalyzerReader): Generator<string> {\n  for (const token of tokens) {\n    if (reader.conditions.has(token)) reader.context.addCondition();\n    yield token;\n  }\n}\n\n/** The ordered default processor list from lizard.py:get_extensions. */\nexport const DEFAULT_TOKEN_PROCESSORS: readonly TokenProcessor[] = Object.freeze([\n  preprocessing,\n  commentCounter,\n  lineCounter,\n  tokenCounter,\n  conditionCounter\n]);\n\n/**\n * Drives the in-memory half of upstream FileAnalyzer.  Reader registry and\n * filesystem decoding stay at the product integration boundary, so callers\n * supply the concrete reader explicitly.\n */\nexport class FileAnalyzer {\n  public readonly processors: readonly AnalyzerProcessor[];\n\n  public constructor(processors: readonly AnalyzerProcessor[] = DEFAULT_TOKEN_PROCESSORS) {\n    this.processors = processors;\n  }\n\n  public analyzeSourceCode<Reader extends AnalyzerReader>(\n    filename: string,\n    sourceCode: string,\n    Reader: ReaderConstructor<Reader>\n  ): FileInformation {\n    const context = new FileInfoBuilder(filename);\n    const reader = new Reader(context);\n    let tokens = Reader.generateTokens(sourceCode);\n\n    try {\n      for (const processor of this.processors) tokens = applyProcessor(processor, tokens, reader);\n      for (const _token of reader.__call__(tokens, reader)) {\n        // The reader drives its state machine while the in-memory pipeline drains.\n      }\n    } catch (error: unknown) {\n      if (!isRecursionLimit(error)) throw error;\n    }\n\n    return context.fileinfo;\n  }\n\n  /** Source `analyze_source_code` spelling retained for translated extension/core callers. */\n  public analyze_source_code<Reader extends AnalyzerReader>(\n    filename: string,\n    sourceCode: string,\n    Reader: ReaderConstructor<Reader>\n  ): FileInformation {\n    return this.analyzeSourceCode(filename, sourceCode, Reader);\n  }\n}\n\n/** The source-aligned default analyzer has only the five core processors. */\nexport const DEFAULT_FILE_ANALYZER = new FileAnalyzer(DEFAULT_TOKEN_PROCESSORS);\n\n/**\n * One already-admitted source unit at the in-memory boundary. File discovery,\n * decoding and reader selection stay outside this source-aligned core.\n */\nexport interface InMemoryAnalyzerFile {\n  readonly filename: string;\n  readonly sourceCode: string;\n  readonly reader: ReaderConstructor;\n}\n\n/**\n * Source-aligned `map_files_to_analyzer` after the explicitly excluded file\n * opening/multiprocessing entry surface has supplied in-memory source units.\n */\nexport function mapFilesToAnalyzer(\n  files: Iterable<InMemoryAnalyzerFile>,\n  analyzer: FileAnalyzer,\n  workingThreads: number\n): Iterable<FileInformation> {\n  // The Product owns Worker scheduling. Retain the source argument/lifecycle\n  // without creating a second analyzer-level concurrency framework.\n  void workingThreads;\n  return mapInMemoryFiles(files, analyzer);\n}\n\n/** Source `map_files_to_analyzer` spelling for the retained in-memory lifecycle. */\nexport function map_files_to_analyzer(\n  files: Iterable<InMemoryAnalyzerFile>,\n  analyzer: FileAnalyzer,\n  workingThreads: number\n): Iterable<FileInformation> {\n  return mapFilesToAnalyzer(files, analyzer, workingThreads);\n}\n\n/**\n * Source-aligned `analyze_files` lifecycle. `exts` intentionally uses Python\n * truthiness: an omitted or empty list receives the five default processors.\n */\nexport function analyzeFiles(\n  files: Iterable<InMemoryAnalyzerFile>,\n  threads = 1,\n  exts?: readonly AnalyzerProcessor[]\n): Iterable<FileInformation> | undefined {\n  const extensions = exts !== undefined && exts.length > 0 ? exts : [...DEFAULT_TOKEN_PROCESSORS];\n  const fileAnalyzer = new FileAnalyzer(extensions);\n  let result: Iterable<FileInformation> | undefined = mapFilesToAnalyzer(\n    files,\n    fileAnalyzer,\n    threads\n  );\n  for (const extension of extensions) {\n    const outcome = invokeExtensionCrossFileProcessOutcome(extension, result);\n    if (outcome.hookPresent) result = outcome.result;\n  }\n  return result;\n}\n\n/** Source `analyze_files` spelling for translated internal callers. */\nexport function analyze_files(\n  files: Iterable<InMemoryAnalyzerFile>,\n  threads = 1,\n  exts?: readonly AnalyzerProcessor[]\n): Iterable<FileInformation> | undefined {\n  return analyzeFiles(files, threads, exts);\n}\n\n/**\n * Apply source registration-order cross-file passes. A present hook replaces\n * the stream even when it returns undefined; only an absent hook is skipped.\n */\nexport function applyCrossFileProcessors(\n  fileInfos: Iterable<FileInformation>,\n  processors: readonly AnalyzerProcessor[]\n): Iterable<FileInformation> | undefined {\n  let processedFileInfos: Iterable<FileInformation> | undefined = fileInfos;\n  for (const processor of processors) {\n    const outcome = invokeExtensionCrossFileProcessOutcome(processor, processedFileInfos);\n    if (outcome.hookPresent) processedFileInfos = outcome.result;\n  }\n  return processedFileInfos;\n}\n\n/** Forward the internal parser seam to extensions in source registration order. */\nexport function registerExtensionArguments(\n  processors: readonly AnalyzerProcessor[],\n  parser: ExtensionArgumentRegistrar\n): void {\n  for (const processor of processors) {\n    invokeExtensionSetArgs(processor, parser);\n  }\n}\n\nexport function analyzeSourceCode<Reader extends AnalyzerReader>(\n  filename: string,\n  sourceCode: string,\n  Reader: ReaderConstructor<Reader>,\n  processors: readonly AnalyzerProcessor[] = DEFAULT_TOKEN_PROCESSORS\n): FileInformation {\n  if (processors === DEFAULT_TOKEN_PROCESSORS) {\n    return DEFAULT_FILE_ANALYZER.analyzeSourceCode(filename, sourceCode, Reader);\n  }\n  return new FileAnalyzer(processors).analyzeSourceCode(filename, sourceCode, Reader);\n}\n\nfunction* mapInMemoryFiles(\n  files: Iterable<InMemoryAnalyzerFile>,\n  analyzer: FileAnalyzer\n): Generator<FileInformation> {\n  for (const file of files) {\n    yield analyzer.analyze_source_code(file.filename, file.sourceCode, file.reader);\n  }\n}\nfunction applyProcessor(\n  processor: AnalyzerProcessor,\n  tokens: TokenStream,\n  reader: AnalyzerReader\n): TokenStream {\n  return typeof processor === \"function\"\n    ? processor(tokens, reader)\n    : invokeExtensionCall(processor, tokens, reader);\n}\n\nfunction isRecursionLimit(error: unknown): boolean {\n  return (\n    error instanceof RangeError &&\n    (error.message.includes(\"call stack\") || error.message.toLowerCase().includes(\"recursion\"))\n  );\n}\n\nfunction* withoutWhitespace(tokens: TokenStream): Generator<string> {\n  for (const token of tokens) {\n    if (!isPythonWhitespace(token) || token === \"\\n\") yield token;\n  }\n}\n"]}