assertloom 0.0.0-stage → 0.2.0

package/dist/runner/jestRunner.js.map

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

package/dist/runner/networkGuard.d.ts

@@ -0,0 +1,4 @@
+export declare const NETWORK_BLOCKED_CODE = "ASSERTLOOM_NETWORK_BLOCKED";
+export declare const NETWORK_BLOCKED_MESSAGE = "Assertloom blocked a network connection";
+/** Writes the guard into `dir` and returns the NODE_OPTIONS fragment that preloads it. */
+export declare function writeNetworkGuard(dir: string): Promise<string>;

package/dist/runner/networkGuard.js

@@ -0,0 +1,55 @@
+import { writeFile } from "node:fs/promises";
+import path from "node:path";
+export const NETWORK_BLOCKED_CODE = "ASSERTLOOM_NETWORK_BLOCKED";
+export const NETWORK_BLOCKED_MESSAGE = "Assertloom blocked a network connection";
+/**
+ * Preloaded into Jest (and any Node subprocess it starts) with `--require`. It fails TCP connections
+ * and DNS lookups, which covers `net`, `http`, `https`, `tls`, and `fetch`. Local pipes stay usable.
+ */
+const GUARD_SOURCE = `"use strict";
+const net = require("node:net");
+const dns = require("node:dns");
+
+const blocked = (target) =>
+  Object.assign(
+    new Error(${JSON.stringify(NETWORK_BLOCKED_MESSAGE)} + " to " + target + ". Generated tests run offline: mock the dependency, or rerun with --allow-network."),
+    { code: ${JSON.stringify(NETWORK_BLOCKED_CODE)} },
+  );
+
+const connect = net.Socket.prototype.connect;
+net.Socket.prototype.connect = function (...args) {
+  let options = Array.isArray(args[0]) ? args[0][0] : args[0];
+  if (options === null || typeof options !== "object") options = { port: args[0], host: typeof args[1] === "string" ? args[1] : undefined };
+  if (options.path) return connect.apply(this, args);
+  const error = blocked((options.host || "localhost") + ":" + options.port);
+  process.nextTick(() => this.destroy(error));
+  return this;
+};
+
+// Local servers look up their own host before listening, which needs no DNS server; connections are still blocked above.
+const local = (host) => typeof host === "string" && (net.isIP(host) !== 0 || host === "localhost");
+const guard = (original, allowLocal) =>
+  function (...args) {
+    if (allowLocal && local(args[0])) return original.apply(this, args);
+    const error = blocked(String(args[0]));
+    const callback = args[args.length - 1];
+    if (typeof callback === "function") return void process.nextTick(callback, error);
+    return Promise.reject(error);
+  };
+const QUERIES = ["lookupService", "resolve", "resolve4", "resolve6", "resolveAny", "resolveCaa", "resolveCname", "resolveMx", "resolveNaptr", "resolveNs", "resolvePtr", "resolveSoa", "resolveSrv", "resolveTlsa", "resolveTxt", "reverse"];
+for (const target of [dns, dns.promises]) {
+  target.lookup = guard(target.lookup, true);
+  for (const owner of [target, target.Resolver && target.Resolver.prototype]) {
+    if (!owner) continue;
+    for (const name of QUERIES) if (typeof owner[name] === "function") owner[name] = guard(owner[name], false);
+  }
+}
+`;
+/** Writes the guard into `dir` and returns the NODE_OPTIONS fragment that preloads it. */
+export async function writeNetworkGuard(dir) {
+    const file = path.join(dir, "network-guard.cjs");
+    await writeFile(file, GUARD_SOURCE);
+    // NODE_OPTIONS drops backslashes inside quotes on Windows; Node accepts forward slashes everywhere.
+    return `--require "${file.replaceAll("\\", "/")}"`;
+}
+//# sourceMappingURL=networkGuard.js.map

package/dist/runner/networkGuard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"networkGuard.js","sourceRoot":"","sources":["../../src/runner/networkGuard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,CAAC,MAAM,oBAAoB,GAAG,4BAA4B,CAAC;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAEjF;;;GAGG;AACH,MAAM,YAAY,GAAG;;;;;;gBAML,IAAI,CAAC,SAAS,CAAC,uBAAuB,CAAC;cACzC,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BjD,CAAC;AAEF,0FAA0F;AAC1F,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACjD,MAAM,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACpC,oGAAoG;IACpG,OAAO,cAAc,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC;AACrD,CAAC"}

package/dist/runner/project.d.ts

@@ -0,0 +1,30 @@
+export type JestConfigSource = {
+    kind: "default";
+} | {
+    kind: "file";
+    path: string;
+} | {
+    kind: "package-json";
+    config: Record<string, unknown>;
+};
+export interface JestSetup {
+    root: string;
+    jestBin: string;
+    jestSource: "project" | "bundled";
+    config: JestConfigSource;
+    /** Things the user should know, such as falling back to the bundled Jest. */
+    notes: string[];
+}
+/**
+ * Nearest directory with a package.json. The search stops at a git repository root, and stray
+ * package.json files in the home directory or at the filesystem root are ignored.
+ */
+export declare function findProjectRoot(fromFile: string): string;
+/**
+ * Jest 30 also resolves a config from its working directory when `--config` is given, and exits
+ * with "Could not find a config file" if no Jest config or package.json exists there or above.
+ */
+export declare function jestCanStartIn(dir: string): boolean;
+/** Whether this Node.js can import TypeScript files directly (type stripping), as Jest config wrappers do. */
+export declare function nodeStripsTypes(): boolean;
+export declare function detectJestSetup(sourcePath: string): JestSetup;

package/dist/runner/project.js

@@ -0,0 +1,86 @@
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import os from "node:os";
+import path from "node:path";
+const CONFIG_FILES = ["jest.config.js", "jest.config.cjs", "jest.config.mjs", "jest.config.json", "jest.config.ts", "jest.config.mts", "jest.config.cts"];
+/**
+ * Nearest directory with a package.json. The search stops at a git repository root, and stray
+ * package.json files in the home directory or at the filesystem root are ignored.
+ */
+export function findProjectRoot(fromFile) {
+    const fileDir = path.dirname(path.resolve(fromFile));
+    const home = path.resolve(os.homedir());
+    for (let dir = fileDir;; dir = path.dirname(dir)) {
+        const parent = path.dirname(dir);
+        if (parent === dir || dir === home)
+            return fileDir;
+        if (existsSync(path.join(dir, "package.json")))
+            return dir;
+        if (existsSync(path.join(dir, ".git")))
+            return fileDir;
+    }
+}
+/**
+ * Jest 30 also resolves a config from its working directory when `--config` is given, and exits
+ * with "Could not find a config file" if no Jest config or package.json exists there or above.
+ */
+export function jestCanStartIn(dir) {
+    for (let current = path.resolve(dir);; current = path.dirname(current)) {
+        if ([...CONFIG_FILES, "package.json"].some((name) => existsSync(path.join(current, name))))
+            return true;
+        if (path.dirname(current) === current)
+            return false;
+    }
+}
+function resolveJestBin(require) {
+    try {
+        return path.join(path.dirname(require.resolve("jest/package.json")), "bin", "jest.js");
+    }
+    catch {
+        return undefined;
+    }
+}
+function bundledJestBin() {
+    const bin = resolveJestBin(createRequire(import.meta.url));
+    if (!bin)
+        throw new Error("Assertloom's bundled Jest is missing; reinstall Assertloom.");
+    return bin;
+}
+/** Whether this Node.js can import TypeScript files directly (type stripping), as Jest config wrappers do. */
+export function nodeStripsTypes() {
+    return !!process.features.typescript;
+}
+export function detectJestSetup(sourcePath) {
+    const root = findProjectRoot(sourcePath);
+    const notes = [];
+    let config = { kind: "default" };
+    const configFile = CONFIG_FILES.map((name) => path.join(root, name)).find((file) => existsSync(file));
+    if (configFile && /\.[cm]?ts$/.test(configFile) && !nodeStripsTypes()) {
+        notes.push(`${path.basename(configFile)} needs Node.js 22.18 or newer to load; using Assertloom's default Jest config.`);
+    }
+    else if (configFile) {
+        config = { kind: "file", path: configFile };
+    }
+    else {
+        try {
+            const pkg = JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
+            if (pkg.jest && typeof pkg.jest === "object")
+                config = { kind: "package-json", config: pkg.jest };
+        }
+        catch {
+            // No readable package.json: use the default config.
+        }
+    }
+    if (config.kind !== "default" && (config.kind === "package-json" ? "projects" in config.config : false)) {
+        notes.push("Jest `projects` configurations are not supported yet; using Assertloom's default Jest config.");
+        config = { kind: "default" };
+    }
+    const projectJest = config.kind === "default" ? undefined : resolveJestBin(createRequire(path.join(root, "package.json")));
+    if (config.kind !== "default" && !projectJest) {
+        notes.push("The project has a Jest config but Jest is not installed; using Assertloom's bundled Jest.");
+    }
+    return projectJest
+        ? { root, jestBin: projectJest, jestSource: "project", config, notes }
+        : { root, jestBin: bundledJestBin(), jestSource: "bundled", config, notes };
+}
+//# sourceMappingURL=project.js.map

package/dist/runner/project.js.map

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

package/dist/runner/results.d.ts

@@ -0,0 +1,32 @@
+import type { InfraFailure, TestFailureKind, TestOutcome } from "./types.js";
+interface JestAssertionResult {
+    ancestorTitles: string[];
+    title: string;
+    status: string;
+    duration?: number | null;
+    failureMessages?: string[];
+}
+interface JestTestFileResult {
+    status: string;
+    message?: string;
+    assertionResults: JestAssertionResult[];
+    testExecError?: {
+        message?: string;
+    } | null;
+}
+export interface JestJsonReport {
+    testResults: JestTestFileResult[];
+    runExecError?: {
+        message?: string;
+    } | null;
+}
+export declare function stripAnsi(text: string): string;
+/** Removes colors, keeps the first few stack frames, and caps the length. */
+export declare function cleanMessage(text: string): string;
+export declare function classifyTestFailure(message: string): TestFailureKind;
+export declare function classifySuiteFailure(message: string): InfraFailure;
+export declare function parseJestReport(report: JestJsonReport): {
+    tests: TestOutcome[];
+    infra?: InfraFailure;
+};
+export {};

package/dist/runner/results.js

@@ -0,0 +1,58 @@
+const MAX_MESSAGE_LENGTH = 2000;
+const MAX_STACK_FRAMES = 3;
+export function stripAnsi(text) {
+    return text.replace(/\u001b\[[0-9;]*m/g, "");
+}
+/** Removes colors, keeps the first few stack frames, and caps the length. */
+export function cleanMessage(text) {
+    let frames = 0;
+    const lines = stripAnsi(text)
+        .split(/\r?\n/)
+        .filter((line) => !line.includes("node_modules"))
+        .filter((line) => !/^\s+at /.test(line) || ++frames <= MAX_STACK_FRAMES);
+    const cleaned = lines.join("\n").trim();
+    return cleaned.length > MAX_MESSAGE_LENGTH ? `${cleaned.slice(0, MAX_MESSAGE_LENGTH)}\n…(truncated)` : cleaned;
+}
+export function classifyTestFailure(message) {
+    const text = stripAnsi(message);
+    if (/Exceeded timeout of \d+ ?ms|Test timed out in \d+ ?ms/.test(text))
+        return "timeout";
+    if (/expect\(.*?\)\.|Expected:|Received:|Expected value|Received value|^AssertionError:/m.test(text))
+        return "assertion";
+    return "error";
+}
+export function classifySuiteFailure(message) {
+    const text = cleanMessage(message);
+    if (/Cannot find module|Failed to (?:resolve|load) (?:import|url)|Cannot find package/.test(text))
+        return { kind: "module-not-found", message: text };
+    if (/Jest encountered an unexpected token|SyntaxError|Must use import to load ES Module|Cannot use import statement/.test(text)) {
+        return { kind: "transform", message: text };
+    }
+    return { kind: "suite-error", message: text };
+}
+export function parseJestReport(report) {
+    if (report.runExecError?.message)
+        return { tests: [], infra: classifySuiteFailure(report.runExecError.message) };
+    const tests = [];
+    for (const file of report.testResults) {
+        const suiteError = file.testExecError?.message ?? (file.assertionResults.length === 0 && file.status === "failed" ? file.message : undefined);
+        if (suiteError)
+            return { tests, infra: classifySuiteFailure(suiteError) };
+        for (const result of file.assertionResults) {
+            const status = result.status === "passed" ? "passed" : result.status === "failed" ? "failed" : "skipped";
+            const outcome = {
+                suite: result.ancestorTitles.join(" › "),
+                name: result.title,
+                status,
+                durationMs: result.duration ?? undefined,
+            };
+            if (status === "failed") {
+                const message = (result.failureMessages ?? []).join("\n");
+                outcome.failure = { kind: classifyTestFailure(message), message: cleanMessage(message) };
+            }
+            tests.push(outcome);
+        }
+    }
+    return { tests };
+}
+//# sourceMappingURL=results.js.map

package/dist/runner/results.js.map

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

package/dist/runner/types.d.ts

@@ -0,0 +1,39 @@
+export type TestFailureKind = "assertion" | "error" | "timeout";
+export interface TestOutcome {
+    /** describe() titles joined with " › ". */
+    suite: string;
+    name: string;
+    status: "passed" | "failed" | "skipped";
+    durationMs?: number;
+    failure?: {
+        kind: TestFailureKind;
+        message: string;
+    };
+}
+/** The run itself failed, as opposed to individual tests failing. */
+export interface InfraFailure {
+    kind: "timeout" | "crash" | "module-not-found" | "transform" | "suite-error";
+    message: string;
+}
+/** Percentages (0–100), or null when the file has nothing of that kind to cover. */
+export interface CoverageMetrics {
+    lines: number | null;
+    statements: number | null;
+    functions: number | null;
+    branches: number | null;
+}
+export interface RunResult {
+    status: "passed" | "failed" | "error";
+    tests: TestOutcome[];
+    passed: number;
+    failed: number;
+    skipped: number;
+    total: number;
+    infra?: InfraFailure;
+    coverage?: CoverageMetrics;
+    durationMs: number;
+    /** Where the Jest binary and configuration came from. */
+    setup: string;
+    /** The run changed the source file under test; it has been restored. */
+    sourceRestored?: boolean;
+}

package/dist/runner/types.js

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

package/dist/runner/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/runner/types.ts"],"names":[],"mappings":""}

package/dist/runner/vitest.d.ts

@@ -0,0 +1,24 @@
+import type { TestFramework } from "../types/index.js";
+import type { RunFiles } from "./jestConfig.js";
+export interface VitestSetup {
+    root: string;
+    vitestBin: string;
+    /** `vite` as resolved from the project's Vitest, for loading the project's config. */
+    viteEntry: string;
+    configFile?: string;
+    /** Whether @vitest/coverage-v8 is installed. */
+    coverage: boolean;
+}
+/** Vitest when the project uses it and not Jest; Jest otherwise. */
+export declare function detectFramework(sourcePath: string): TestFramework;
+export declare function detectVitestSetup(sourcePath: string): VitestSetup;
+/**
+ * Writes a Vitest config that loads the project's own config (if any) and overrides only test selection,
+ * reporting, and coverage, so exactly this test file runs.
+ */
+export declare function writeVitestRunConfig(setup: VitestSetup, files: RunFiles & {
+    resultsPath: string;
+    testTimeoutMs: number;
+}, runDir: string): Promise<string>;
+export declare function vitestArgs(setup: VitestSetup, configPath: string): string[];
+export declare function describeVitestSetup(setup: VitestSetup): string;

package/dist/runner/vitest.js

@@ -0,0 +1,105 @@
+import { existsSync, readFileSync } from "node:fs";
+import { writeFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { UserError } from "../errors.js";
+import { findProjectRoot } from "./project.js";
+const VITEST_CONFIG_FILES = ["vitest.config", "vite.config"].flatMap((name) => ["ts", "mts", "cts", "js", "mjs", "cjs"].map((ext) => `${name}.${ext}`));
+function readPackageJson(root) {
+    try {
+        return JSON.parse(readFileSync(path.join(root, "package.json"), "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+/** Vitest when the project uses it and not Jest; Jest otherwise. */
+export function detectFramework(sourcePath) {
+    const root = findProjectRoot(sourcePath);
+    const pkg = readPackageJson(root);
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const usesVitest = "vitest" in deps || VITEST_CONFIG_FILES.some((name) => name.startsWith("vitest.") && existsSync(path.join(root, name)));
+    const usesJest = "jest" in deps || existsSync(path.join(root, "jest.config.js")) || "jest" in pkg;
+    return usesVitest && !usesJest ? "vitest" : "jest";
+}
+export function detectVitestSetup(sourcePath) {
+    const root = findProjectRoot(sourcePath);
+    const require = createRequire(path.join(root, "package.json"));
+    let vitestDir;
+    try {
+        vitestDir = path.dirname(require.resolve("vitest/package.json"));
+    }
+    catch {
+        throw new UserError(`Vitest is not installed in ${root}. Install it (npm install --save-dev vitest) or use --framework jest.`);
+    }
+    const fromVitest = createRequire(path.join(vitestDir, "package.json"));
+    let coverage = true;
+    try {
+        require.resolve("@vitest/coverage-v8/package.json");
+    }
+    catch {
+        coverage = false;
+    }
+    return {
+        root,
+        vitestBin: path.join(vitestDir, "vitest.mjs"),
+        viteEntry: fromVitest.resolve("vite"),
+        configFile: VITEST_CONFIG_FILES.map((name) => path.join(root, name)).find((file) => existsSync(file)),
+        coverage,
+    };
+}
+const escapeGlob = (text) => text.replace(/[[\]{}()*?!+@]/g, "\\$&");
+const relativePosix = (from, to) => path.relative(from, to).split(path.sep).join("/");
+/**
+ * Writes a Vitest config that loads the project's own config (if any) and overrides only test selection,
+ * reporting, and coverage, so exactly this test file runs.
+ */
+export async function writeVitestRunConfig(setup, files, runDir) {
+    const coverage = setup.coverage
+        ? {
+            enabled: true,
+            provider: "v8",
+            reporter: ["json-summary"],
+            reportsDirectory: files.coverageDir,
+            reportOnFailure: true,
+            include: [escapeGlob(relativePosix(setup.root, files.sourcePath))],
+            exclude: [],
+        }
+        : { enabled: false };
+    const overrides = {
+        dir: setup.root,
+        include: [escapeGlob(relativePosix(setup.root, files.testPath))],
+        exclude: [],
+        watch: false,
+        passWithNoTests: false,
+        reporters: ["json"],
+        outputFile: { json: files.resultsPath },
+        testTimeout: files.testTimeoutMs,
+        coverage,
+    };
+    const file = path.join(runDir, "vitest.config.mjs");
+    await writeFile(file, `const root = ${JSON.stringify(setup.root)};
+const configFile = ${JSON.stringify(setup.configFile ?? null)};
+
+export default async (env) => {
+  let config = {};
+  if (configFile) {
+    const { loadConfigFromFile } = await import(${JSON.stringify(pathToFileURL(setup.viteEntry).href)});
+    config = (await loadConfigFromFile(env, configFile, root))?.config ?? {};
+  }
+  const test = { ...config.test };
+  if (test.projects || test.workspace) throw new Error("Assertloom: Vitest projects/workspaces are not supported yet.");
+  return { ...config, root, test: { ...test, ...${JSON.stringify(overrides)} } };
+};
+`);
+    return file;
+}
+export function vitestArgs(setup, configPath) {
+    return [setup.vitestBin, "run", "--config", configPath, "--root", setup.root];
+}
+export function describeVitestSetup(setup) {
+    const config = setup.configFile ? path.basename(setup.configFile) : "no Vitest config";
+    return `project Vitest, ${config}${setup.coverage ? "" : ", no coverage (install @vitest/coverage-v8)"}`;
+}
+//# sourceMappingURL=vitest.js.map

package/dist/runner/vitest.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,96 @@
+export declare const SUPPORTED_EXTENSIONS: readonly [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+export type SupportedExtension = (typeof SUPPORTED_EXTENSIONS)[number];
+export type SourceLanguage = "typescript" | "javascript";
+export type TestFramework = "jest" | "vitest";
+export interface SourceFile {
+    /** Path as the user typed it, normalized for display. */
+    inputPath: string;
+    absolutePath: string;
+    extension: SupportedExtension;
+    language: SourceLanguage;
+    sizeBytes: number;
+}
+export interface ParameterInfo {
+    /** Identifier name, or the source text of a destructuring pattern such as `{ id, name }`. */
+    name: string;
+    type?: string;
+    optional: boolean;
+    rest: boolean;
+    defaultValue?: string;
+}
+export interface FunctionInfo {
+    /** Local name, or `"default"` for an anonymous default export. */
+    name: string;
+    exported: boolean;
+    /** Names this function is exported under; `"default"` for a default export. */
+    exportedAs: string[];
+    kind: "declaration" | "arrow" | "expression";
+    async: boolean;
+    generator: boolean;
+    parameters: ParameterInfo[];
+    returnType?: string;
+    typeParameters?: string;
+    throws: boolean;
+    /** Import sources referenced inside the function body. */
+    dependencies: string[];
+    /** Mockable globals referenced inside the function body, such as `fetch`. */
+    globals: string[];
+    line: number;
+}
+/** How the source uses an imported value. Assertloom builds mocks from this. */
+export interface UsageShape {
+    called: boolean;
+    constructed: boolean;
+    /** Used on the right-hand side of `instanceof`. */
+    instanceOf: boolean;
+    /** Properties read from the value. */
+    members: Record<string, UsageShape>;
+    /** How the value returned by a call or `new` is used, when it is kept. */
+    result?: UsageShape;
+    /** Variables the result is stored in, e.g. `pool` for `const pool = new Pool()`. */
+    resultNames: string[];
+    /** The result is stored in a top-level variable, so it is created when the module loads. */
+    createdAtLoad: boolean;
+}
+export interface ImportUsage {
+    source: string;
+    local: string;
+    /** `"default"`, `"*"` (namespace or whole CommonJS module), or an export name. */
+    imported: string;
+    style: "esm" | "commonjs";
+    shape: UsageShape;
+}
+export type ImportCategory = "local" | "external" | "builtin";
+export interface ImportSpecifierInfo {
+    kind: "default" | "named" | "namespace";
+    /** Exported name in the source module; `"default"` or `"*"` for default/namespace imports. */
+    imported: string;
+    local: string;
+}
+export interface ImportInfo {
+    source: string;
+    kind: "import" | "require" | "dynamic-import" | "re-export";
+    category: ImportCategory;
+    /** Package name for external imports, e.g. `@prisma/client` for `@prisma/client/runtime`. */
+    packageName?: string;
+    typeOnly: boolean;
+    specifiers: ImportSpecifierInfo[];
+    line: number;
+}
+export interface DependencySummary {
+    local: string[];
+    external: string[];
+    builtin: string[];
+}
+export interface FileAnalysis {
+    file: string;
+    language: SourceLanguage;
+    moduleSystem: "esm" | "commonjs" | "mixed" | "none";
+    functions: FunctionInfo[];
+    imports: ImportInfo[];
+    /** One entry per imported binding, with how the source uses it. */
+    importUsage: ImportUsage[];
+    /** Mockable globals the file references, such as `fetch`. */
+    globals: string[];
+    dependencies: DependencySummary;
+}

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export const SUPPORTED_EXTENSIONS = [".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"];
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC"}