assertloom 0.0.0-stage → 0.1.0

package/dist/analyzer/functions.js

@@ -0,0 +1,274 @@
+import traverse from "@babel/traverse";
+import { isMockableGlobal } from "./usage.js";
+function slice(code, node) {
+    if (!node || node.start == null || node.end == null)
+        return undefined;
+    return code.slice(node.start, node.end);
+}
+function typeText(code, annotation) {
+    if (annotation?.type === "TSTypeAnnotation")
+        return slice(code, annotation.typeAnnotation);
+    return undefined;
+}
+function patternText(code, node) {
+    const end = node.typeAnnotation?.start ?? node.end ?? 0;
+    return code.slice(node.start ?? 0, end).replace(/\?$/, "").trim();
+}
+function parameterInfo(code, param) {
+    switch (param.type) {
+        case "Identifier":
+            return { name: param.name, type: typeText(code, param.typeAnnotation), optional: !!param.optional, rest: false };
+        case "AssignmentPattern": {
+            const left = parameterInfo(code, param.left);
+            return { ...left, optional: true, defaultValue: slice(code, param.right) };
+        }
+        case "RestElement": {
+            const type = typeText(code, param.typeAnnotation) ?? typeText(code, param.argument.typeAnnotation);
+            const name = param.argument.type === "Identifier" ? param.argument.name : patternText(code, param.argument);
+            return { name, type, optional: true, rest: true };
+        }
+        default:
+            return {
+                name: patternText(code, param),
+                type: typeText(code, param.typeAnnotation),
+                optional: !!param.optional,
+                rest: false,
+            };
+    }
+}
+function unwrap(node) {
+    while (node &&
+        (node.type === "TSAsExpression" || node.type === "TSSatisfiesExpression" || node.type === "ParenthesizedExpression")) {
+        node = node.expression;
+    }
+    return node;
+}
+function asFunction(node) {
+    const inner = unwrap(node);
+    return inner?.type === "FunctionExpression" || inner?.type === "ArrowFunctionExpression" ? inner : undefined;
+}
+function propertyName(node) {
+    if (node.type === "Identifier")
+        return node.name;
+    if (node.type === "StringLiteral")
+        return node.value;
+    return undefined;
+}
+function collectCandidates(body) {
+    const candidates = [];
+    const byLocalName = new Map();
+    const addCandidate = (name, node, exportedAs = []) => {
+        const existing = candidates.find((c) => c.node === node);
+        if (existing) {
+            for (const e of exportedAs)
+                if (!existing.exportedAs.includes(e))
+                    existing.exportedAs.push(e);
+            return existing;
+        }
+        const candidate = { name, node, exportedAs };
+        candidates.push(candidate);
+        if (name !== "default")
+            byLocalName.set(name, candidate);
+        return candidate;
+    };
+    const addDeclaration = (stmt, exported) => {
+        if (stmt?.type === "FunctionDeclaration" && stmt.id) {
+            addCandidate(stmt.id.name, stmt, exported ? [stmt.id.name] : []);
+        }
+        else if (stmt?.type === "VariableDeclaration") {
+            for (const decl of stmt.declarations) {
+                const fn = asFunction(decl.init);
+                if (fn && decl.id.type === "Identifier")
+                    addCandidate(decl.id.name, fn, exported ? [decl.id.name] : []);
+            }
+        }
+    };
+    const pendingExports = [];
+    /** Top-level `const name = { ... }` objects, for `module.exports = name` and `exports.x = name.x`. */
+    const objects = new Map();
+    const pendingObjects = [];
+    const pendingMembers = [];
+    const addCommonJsObject = (node) => {
+        if (node.type !== "ObjectExpression")
+            return;
+        for (const prop of node.properties) {
+            if (prop.type === "ObjectMethod" && prop.kind === "method") {
+                const key = propertyName(prop.key);
+                if (key)
+                    addCandidate(key, prop, [key]);
+            }
+            else if (prop.type === "ObjectProperty") {
+                const key = propertyName(prop.key);
+                if (!key)
+                    continue;
+                const fn = asFunction(prop.value);
+                if (fn)
+                    addCandidate(key, fn, [key]);
+                else if (prop.value.type === "Identifier")
+                    pendingExports.push({ local: prop.value.name, exported: key });
+            }
+        }
+    };
+    for (const stmt of body) {
+        switch (stmt.type) {
+            case "FunctionDeclaration":
+                addDeclaration(stmt, false);
+                break;
+            case "VariableDeclaration":
+                addDeclaration(stmt, false);
+                for (const decl of stmt.declarations) {
+                    if (decl.id.type === "Identifier" && decl.init?.type === "ObjectExpression")
+                        objects.set(decl.id.name, decl.init);
+                }
+                break;
+            case "ExportNamedDeclaration":
+                if (stmt.declaration) {
+                    addDeclaration(stmt.declaration, stmt.exportKind !== "type");
+                }
+                else if (!stmt.source && stmt.exportKind !== "type") {
+                    for (const spec of stmt.specifiers) {
+                        if (spec.type !== "ExportSpecifier" || spec.exportKind === "type")
+                            continue;
+                        const local = propertyName(spec.local);
+                        const exported = propertyName(spec.exported);
+                        if (local && exported)
+                            pendingExports.push({ local, exported });
+                    }
+                }
+                break;
+            case "ExportDefaultDeclaration": {
+                const decl = stmt.declaration;
+                if (decl.type === "FunctionDeclaration") {
+                    addCandidate(decl.id?.name ?? "default", decl, ["default"]);
+                }
+                else if (decl.type === "Identifier") {
+                    pendingExports.push({ local: decl.name, exported: "default" });
+                }
+                else {
+                    const fn = asFunction(decl);
+                    if (fn)
+                        addCandidate(fn.type === "FunctionExpression" && fn.id ? fn.id.name : "default", fn, ["default"]);
+                }
+                break;
+            }
+            case "ExpressionStatement": {
+                const expr = stmt.expression;
+                if (expr.type !== "AssignmentExpression" || expr.operator !== "=" || expr.left.type !== "MemberExpression")
+                    break;
+                const { object, property } = expr.left;
+                const isModuleExports = object.type === "Identifier" && object.name === "module" && propertyName(property) === "exports";
+                if (isModuleExports) {
+                    const fn = asFunction(expr.right);
+                    if (fn)
+                        addCandidate(fn.type === "FunctionExpression" && fn.id ? fn.id.name : "default", fn, ["default"]);
+                    else if (expr.right.type === "Identifier") {
+                        pendingExports.push({ local: expr.right.name, exported: "default" });
+                        pendingObjects.push(expr.right.name);
+                    }
+                    else
+                        addCommonJsObject(expr.right);
+                    break;
+                }
+                const isExportsObject = (object.type === "Identifier" && object.name === "exports") ||
+                    (object.type === "MemberExpression" &&
+                        object.object.type === "Identifier" &&
+                        object.object.name === "module" &&
+                        propertyName(object.property) === "exports");
+                const key = !expr.left.computed ? propertyName(property) : undefined;
+                if (!isExportsObject || !key)
+                    break;
+                const fn = asFunction(expr.right);
+                if (fn)
+                    addCandidate(key, fn, [key]);
+                else if (expr.right.type === "Identifier")
+                    pendingExports.push({ local: expr.right.name, exported: key });
+                else if (expr.right.type === "MemberExpression" && expr.right.object.type === "Identifier" && !expr.right.computed) {
+                    const member = propertyName(expr.right.property);
+                    if (member)
+                        pendingMembers.push({ object: expr.right.object.name, property: member, exported: key });
+                }
+                break;
+            }
+        }
+    }
+    for (const name of pendingObjects) {
+        const object = objects.get(name);
+        if (object)
+            addCommonJsObject(object);
+    }
+    for (const { object, property, exported } of pendingMembers) {
+        const node = objects.get(object);
+        if (node?.type !== "ObjectExpression")
+            continue;
+        for (const prop of node.properties) {
+            if (prop.type !== "ObjectProperty" || propertyName(prop.key) !== property)
+                continue;
+            const fn = asFunction(prop.value);
+            if (fn)
+                addCandidate(exported, fn, [exported]);
+            else if (prop.value.type === "Identifier")
+                pendingExports.push({ local: prop.value.name, exported });
+        }
+    }
+    for (const { local, exported } of pendingExports) {
+        const candidate = byLocalName.get(local);
+        if (candidate && !candidate.exportedAs.includes(exported))
+            candidate.exportedAs.push(exported);
+    }
+    return candidates;
+}
+export function extractFunctions(ast, code, scan) {
+    const candidates = collectCandidates(ast.program.body);
+    const byNode = new Map(candidates.map((c) => [c.node, c]));
+    const results = [];
+    traverse(ast, {
+        Function(path) {
+            const candidate = byNode.get(path.node);
+            if (!candidate)
+                return;
+            const node = candidate.node;
+            const programScope = path.scope.getProgramParent();
+            const dependencies = new Set();
+            const globals = new Set();
+            let throws = false;
+            path.traverse({
+                "Identifier|JSXIdentifier"(idPath) {
+                    if (isMockableGlobal(idPath))
+                        globals.add(idPath.node.name);
+                    if (!idPath.isReferencedIdentifier())
+                        return;
+                    const name = idPath.node.name;
+                    const source = scan.bindings.get(name);
+                    if (source && idPath.scope.getBinding(name) === programScope.getBinding(name))
+                        dependencies.add(source);
+                },
+                "CallExpression|ImportExpression"(callPath) {
+                    const source = scan.callSites.get(callPath.node);
+                    if (source)
+                        dependencies.add(source);
+                },
+                ThrowStatement(throwPath) {
+                    if (throwPath.getFunctionParent()?.node === node)
+                        throws = true;
+                },
+            });
+            results.push({
+                name: candidate.name,
+                exported: candidate.exportedAs.length > 0,
+                exportedAs: candidate.exportedAs,
+                kind: node.type === "ArrowFunctionExpression" ? "arrow" : node.type === "FunctionDeclaration" ? "declaration" : "expression",
+                async: node.async,
+                generator: !!node.generator,
+                parameters: node.params.filter((p) => !(p.type === "Identifier" && p.name === "this")).map((p) => parameterInfo(code, p)),
+                returnType: typeText(code, node.returnType),
+                typeParameters: slice(code, node.typeParameters),
+                throws,
+                dependencies: [...dependencies].sort(),
+                globals: [...globals].sort(),
+                line: node.loc?.start.line ?? 0,
+            });
+        },
+    });
+    return results.sort((a, b) => a.line - b.line);
+}
+//# sourceMappingURL=functions.js.map

package/dist/analyzer/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../src/analyzer/functions.ts"],"names":[],"mappings":"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"}

package/dist/analyzer/index.d.ts

@@ -0,0 +1,5 @@
+import type { FileAnalysis, SourceFile } from "../types/index.js";
+export { ParseError, parseSource } from "./parser.js";
+/** Statically analyzes source code. Target code is parsed, never executed. */
+export declare function analyzeSource(code: string, source: Pick<SourceFile, "inputPath" | "extension" | "language">): FileAnalysis;
+export declare function analyzeFile(source: SourceFile): Promise<FileAnalysis>;

package/dist/analyzer/index.js

@@ -0,0 +1,29 @@
+import { readFile } from "node:fs/promises";
+import { scanImports, summarizeDependencies } from "./dependencies.js";
+import { extractFunctions } from "./functions.js";
+import { parseSource } from "./parser.js";
+import { collectImportUsage } from "./usage.js";
+export { ParseError, parseSource } from "./parser.js";
+/** Statically analyzes source code. Target code is parsed, never executed. */
+export function analyzeSource(code, source) {
+    const ast = parseSource(code, source.extension);
+    const scan = scanImports(ast);
+    const usesEsm = scan.imports.some((i) => i.kind === "import" || i.kind === "re-export") ||
+        ast.program.body.some((s) => s.type === "ExportNamedDeclaration" || s.type === "ExportDefaultDeclaration");
+    const usesCommonJs = scan.usesCommonJsExports || scan.imports.some((i) => i.kind === "require");
+    const { importUsage, globals } = collectImportUsage(ast);
+    return {
+        file: source.inputPath.replaceAll("\\", "/"),
+        language: source.language,
+        moduleSystem: usesEsm && usesCommonJs ? "mixed" : usesEsm ? "esm" : usesCommonJs ? "commonjs" : "none",
+        functions: extractFunctions(ast, code, scan),
+        imports: scan.imports,
+        importUsage,
+        globals,
+        dependencies: summarizeDependencies(scan.imports),
+    };
+}
+export async function analyzeFile(source) {
+    return analyzeSource(await readFile(source.absolutePath, "utf8"), source);
+}
+//# sourceMappingURL=index.js.map

package/dist/analyzer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analyzer/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEtD,8EAA8E;AAC9E,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,MAAgE;IAC1G,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAE9B,MAAM,OAAO,GACX,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC;QACvE,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,IAAI,CAAC,CAAC,IAAI,KAAK,0BAA0B,CAAC,CAAC;IAC7G,MAAM,YAAY,GAAG,IAAI,CAAC,mBAAmB,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IAChG,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAEzD,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC;QAC5C,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,YAAY,EAAE,OAAO,IAAI,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM;QACtG,SAAS,EAAE,gBAAgB,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC;QAC5C,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,WAAW;QACX,OAAO;QACP,YAAY,EAAE,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;KAClD,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAkB;IAClD,OAAO,aAAa,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC5E,CAAC"}

package/dist/analyzer/parser.d.ts

@@ -0,0 +1,11 @@
+import { type ParserPlugin } from "@babel/parser";
+import type { File } from "@babel/types";
+import { UserError } from "../errors.js";
+import type { SupportedExtension } from "../types/index.js";
+export declare class ParseError extends UserError {
+    readonly line?: number | undefined;
+    readonly column?: number | undefined;
+    constructor(message: string, line?: number | undefined, column?: number | undefined);
+}
+export declare function pluginsFor(extension: SupportedExtension): ParserPlugin[];
+export declare function parseSource(code: string, extension: SupportedExtension): File;

package/dist/analyzer/parser.js

@@ -0,0 +1,38 @@
+import { parse } from "@babel/parser";
+import { UserError } from "../errors.js";
+export class ParseError extends UserError {
+    line;
+    column;
+    constructor(message, line, column) {
+        super(message);
+        this.line = line;
+        this.column = column;
+    }
+}
+export function pluginsFor(extension) {
+    switch (extension) {
+        case ".ts":
+        case ".mts":
+        case ".cts":
+            return ["typescript"];
+        case ".tsx":
+            return ["typescript", "jsx"];
+        default:
+            return ["jsx"];
+    }
+}
+export function parseSource(code, extension) {
+    try {
+        return parse(code, {
+            sourceType: extension === ".js" || extension === ".jsx" || extension === ".cjs" ? "unambiguous" : "module",
+            plugins: pluginsFor(extension),
+            errorRecovery: false,
+        });
+    }
+    catch (error) {
+        const loc = error.loc;
+        const reason = error.message.replace(/\s*\(\d+:\d+\)$/, "");
+        throw new ParseError(loc ? `Syntax error at line ${loc.line}, column ${loc.column + 1}: ${reason}` : `Syntax error: ${reason}`, loc?.line, loc?.column);
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/analyzer/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../src/analyzer/parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,MAAM,OAAO,UAAW,SAAQ,SAAS;IAG5B,IAAI;IACJ,MAAM;IAHjB,YACE,OAAe,EACN,IAAa,EACb,MAAe;QAExB,KAAK,CAAC,OAAO,CAAC,CAAC;oBAHN,IAAI;sBACJ,MAAM;IAGjB,CAAC;CACF;AAED,MAAM,UAAU,UAAU,CAAC,SAA6B;IACtD,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,KAAK,CAAC;QACX,KAAK,MAAM,CAAC;QACZ,KAAK,MAAM;YACT,OAAO,CAAC,YAAY,CAAC,CAAC;QACxB,KAAK,MAAM;YACT,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;QAC/B;YACE,OAAO,CAAC,KAAK,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,SAA6B;IACrE,IAAI,CAAC;QACH,OAAO,KAAK,CAAC,IAAI,EAAE;YACjB,UAAU,EAAE,SAAS,KAAK,KAAK,IAAI,SAAS,KAAK,MAAM,IAAI,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ;YAC1G,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC;YAC9B,aAAa,EAAE,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAI,KAAoD,CAAC,GAAG,CAAC;QACtE,MAAM,MAAM,GAAI,KAAe,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,IAAI,UAAU,CAClB,GAAG,CAAC,CAAC,CAAC,wBAAwB,GAAG,CAAC,IAAI,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,KAAK,MAAM,EAAE,CAAC,CAAC,CAAC,iBAAiB,MAAM,EAAE,EACzG,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,MAAM,CACZ,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/analyzer/usage.d.ts

@@ -0,0 +1,16 @@
+import { type NodePath } from "@babel/traverse";
+import type { File } from "@babel/types";
+import type { ImportUsage, UsageShape } from "../types/index.js";
+/** Globals Assertloom replaces with mocks when the source uses them. */
+export declare const MOCKABLE_GLOBALS: readonly ["fetch"];
+export declare function emptyShape(): UsageShape;
+/** True for a reference to a mockable global that the code does not declare itself. */
+export declare function isMockableGlobal(path: NodePath): boolean;
+/**
+ * Finds every runtime binding created by `import` or `require()` and records how the code uses it
+ * (calls, `new`, member access, stored results), plus references to mockable globals.
+ */
+export declare function collectImportUsage(ast: File): {
+    importUsage: ImportUsage[];
+    globals: string[];
+};

package/dist/analyzer/usage.js

@@ -0,0 +1,159 @@
+import traverse from "@babel/traverse";
+/** Globals Assertloom replaces with mocks when the source uses them. */
+export const MOCKABLE_GLOBALS = ["fetch"];
+const MAX_DEPTH = 6;
+export function emptyShape() {
+    return { called: false, constructed: false, instanceOf: false, members: {}, resultNames: [], createdAtLoad: false };
+}
+/** True for a reference to a mockable global that the code does not declare itself. */
+export function isMockableGlobal(path) {
+    if (!path.isReferencedIdentifier() || path.node.type !== "Identifier")
+        return false;
+    const name = path.node.name;
+    return MOCKABLE_GLOBALS.includes(name) && !path.scope.hasBinding(name, { noGlobals: true });
+}
+function memberName(node) {
+    if (node.type !== "MemberExpression" && node.type !== "OptionalMemberExpression")
+        return undefined;
+    if (!node.computed && node.property.type === "Identifier")
+        return node.property.name;
+    if (node.property.type === "StringLiteral")
+        return node.property.value;
+    return undefined;
+}
+const TRANSPARENT = new Set(["TSNonNullExpression", "TSAsExpression", "TSSatisfiesExpression", "ParenthesizedExpression"]);
+/** Records how the expression at `path`, whose value is described by `shape`, is used. */
+function follow(path, shape, depth) {
+    if (depth > MAX_DEPTH)
+        return;
+    let current = path;
+    let cur = shape;
+    for (;;) {
+        const parent = current.parentPath;
+        if (!parent)
+            return;
+        const node = parent.node;
+        if (TRANSPARENT.has(node.type)) {
+            current = parent;
+            continue;
+        }
+        if ((node.type === "MemberExpression" || node.type === "OptionalMemberExpression") && node.object === current.node) {
+            const name = memberName(node);
+            if (!name)
+                return;
+            cur = cur.members[name] ??= emptyShape();
+            current = parent;
+            continue;
+        }
+        const isCall = (node.type === "CallExpression" || node.type === "OptionalCallExpression") && node.callee === current.node;
+        const isNew = node.type === "NewExpression" && node.callee === current.node;
+        if (isCall || isNew) {
+            if (isCall)
+                cur.called = true;
+            else
+                cur.constructed = true;
+            let resultPath = parent;
+            if (resultPath.parentPath?.isAwaitExpression())
+                resultPath = resultPath.parentPath;
+            const declarator = resultPath.parentPath;
+            if (declarator?.isVariableDeclarator() && declarator.node.init === resultPath.node && declarator.node.id.type === "Identifier") {
+                const name = declarator.node.id.name;
+                const result = (cur.result ??= emptyShape());
+                if (!cur.resultNames.includes(name))
+                    cur.resultNames.push(name);
+                if (declarator.scope.block.type === "Program")
+                    cur.createdAtLoad = true;
+                for (const ref of declarator.scope.getBinding(name)?.referencePaths ?? [])
+                    follow(ref, result, depth + 1);
+                return;
+            }
+            const next = resultPath.parentPath?.node;
+            if (next && (next.type === "MemberExpression" || next.type === "OptionalMemberExpression") && next.object === resultPath.node) {
+                cur = cur.result ??= emptyShape();
+                current = resultPath;
+                continue;
+            }
+            return;
+        }
+        if (node.type === "BinaryExpression" && node.operator === "instanceof" && node.right === current.node) {
+            cur.instanceOf = true;
+        }
+        return;
+    }
+}
+function stringValue(node) {
+    if (node?.type === "StringLiteral")
+        return node.value;
+    if (node?.type === "TemplateLiteral" && node.expressions.length === 0)
+        return node.quasis[0].value.cooked ?? undefined;
+    return undefined;
+}
+function propertyKey(node) {
+    if (node.type === "Identifier")
+        return node.name;
+    if (node.type === "StringLiteral")
+        return node.value;
+    return undefined;
+}
+/**
+ * Finds every runtime binding created by `import` or `require()` and records how the code uses it
+ * (calls, `new`, member access, stored results), plus references to mockable globals.
+ */
+export function collectImportUsage(ast) {
+    const importUsage = [];
+    const globals = new Set();
+    const track = (entry, binding) => {
+        const shape = emptyShape();
+        for (const ref of binding?.referencePaths ?? [])
+            follow(ref, shape, 0);
+        importUsage.push({ ...entry, shape });
+    };
+    traverse(ast, {
+        ImportDeclaration(path) {
+            if (path.node.importKind === "type" || path.node.importKind === "typeof")
+                return;
+            const source = path.node.source.value;
+            for (const s of path.node.specifiers) {
+                if (s.type === "ImportSpecifier" && (s.importKind === "type" || s.importKind === "typeof"))
+                    continue;
+                const imported = s.type === "ImportDefaultSpecifier" ? "default" : s.type === "ImportNamespaceSpecifier" ? "*" : propertyKey(s.imported) ?? "";
+                track({ source, local: s.local.name, imported, style: "esm" }, path.scope.getBinding(s.local.name));
+            }
+        },
+        CallExpression(path) {
+            const callee = path.node.callee;
+            if (callee.type !== "Identifier" || callee.name !== "require" || path.scope.hasBinding("require"))
+                return;
+            const source = stringValue(path.node.arguments[0]);
+            if (!source)
+                return;
+            const declarator = path.parentPath;
+            if (declarator.isVariableDeclarator() && declarator.node.init === path.node) {
+                const id = declarator.node.id;
+                if (id.type === "Identifier") {
+                    track({ source, local: id.name, imported: "*", style: "commonjs" }, declarator.scope.getBinding(id.name));
+                }
+                else if (id.type === "ObjectPattern") {
+                    for (const prop of id.properties) {
+                        if (prop.type !== "ObjectProperty" || prop.value.type !== "Identifier")
+                            continue;
+                        const imported = propertyKey(prop.key);
+                        if (imported)
+                            track({ source, local: prop.value.name, imported, style: "commonjs" }, declarator.scope.getBinding(prop.value.name));
+                    }
+                }
+                return;
+            }
+            // `require("x").get(...)`: follow the call itself.
+            const shape = emptyShape();
+            follow(path, shape, 0);
+            importUsage.push({ source, local: "", imported: "*", style: "commonjs", shape });
+        },
+        Identifier(path) {
+            if (isMockableGlobal(path))
+                globals.add(path.node.name);
+        },
+    });
+    return { importUsage, globals: [...globals].sort() };
+}
+//# sourceMappingURL=usage.js.map

package/dist/analyzer/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/analyzer/usage.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/analyze.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAnalyzeCommand(program: Command): void;

package/dist/cli/commands/analyze.js

@@ -0,0 +1,49 @@
+import { formatSignature } from "../../analyzer/format.js";
+import { analyzeFile } from "../../analyzer/index.js";
+import { validateSourceFile } from "../validateFile.js";
+function plural(count, word, pluralWord = `${word}s`) {
+    return `${count} ${count === 1 ? word : pluralWord}`;
+}
+function signature(fn) {
+    const alias = fn.exportedAs.filter((name) => name !== fn.name);
+    const notes = [
+        alias.length ? `exported as ${alias.join(", ")}` : "",
+        fn.throws ? "throws" : "",
+        fn.dependencies.length || fn.globals.length ? `uses ${[...fn.dependencies, ...fn.globals.map((g) => `global ${g}`)].join(", ")}` : "",
+    ].filter(Boolean);
+    return `${formatSignature(fn)}${notes.length ? `  [${notes.join("; ")}]` : ""}`;
+}
+function printSummary(analysis) {
+    const exported = analysis.functions.filter((f) => f.exported);
+    const internal = analysis.functions.length - exported.length;
+    const { local, external, builtin } = analysis.dependencies;
+    const language = analysis.language === "typescript" ? "TypeScript" : "JavaScript";
+    console.log(`✓ Parsed ${analysis.file} (${language}, ${analysis.moduleSystem === "none" ? "no imports/exports" : analysis.moduleSystem.toUpperCase()})`);
+    console.log(`✓ Found ${plural(exported.length, "exported function")}${internal ? ` (+${internal} internal)` : ""}`);
+    console.log(`✓ Found ${plural(local.length + external.length + builtin.length, "dependency", "dependencies")} ` +
+        `(${external.length} external, ${local.length} local, ${builtin.length} built-in)`);
+    if (exported.length) {
+        console.log("");
+        for (const fn of exported)
+            console.log(`  ${signature(fn)}`);
+    }
+    if (external.length)
+        console.log(`\nExternal packages: ${external.join(", ")}`);
+}
+export function registerAnalyzeCommand(program) {
+    program
+        .command("analyze")
+        .description("Statically analyze a JS/TS file: exported functions, parameters, imports, and dependencies")
+        .argument("<file>", "path to a JavaScript or TypeScript source file")
+        .option("--json", "print the full analysis as JSON")
+        .action(async (file, options) => {
+        const analysis = await analyzeFile(await validateSourceFile(file));
+        if (options.json) {
+            console.log(JSON.stringify(analysis, null, 2));
+        }
+        else {
+            printSummary(analysis);
+        }
+    });
+}
+//# sourceMappingURL=analyze.js.map