assertloom 0.0.0-stage → 0.2.0

package/dist/cli/program.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.js","sourceRoot":"","sources":["../../src/cli/program.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,oBAAoB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAElG,CAAC;AAEF,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,gFAAgF,CAAC;SAC7F,OAAO,CAAC,OAAO,CAAC;SAChB,kBAAkB,EAAE,CAAC;IAExB,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChC,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACjC,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5B,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAE3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/report.d.ts

@@ -0,0 +1,3 @@
+import type { CoverageMetrics, RunResult } from "../runner/index.js";
+export declare function formatCoverage(coverage: CoverageMetrics): string;
+export declare function printRunResult(result: RunResult): void;

package/dist/cli/report.js

@@ -0,0 +1,36 @@
+function pct(value) {
+    return value === null ? "n/a" : `${Math.round(value * 10) / 10}%`;
+}
+export function formatCoverage(coverage) {
+    return `${pct(coverage.lines)} lines, ${pct(coverage.branches)} branches, ${pct(coverage.functions)} functions`;
+}
+function firstLines(text, count) {
+    return text
+        .split("\n")
+        .filter((line) => line.trim())
+        .slice(0, count)
+        .map((line) => `      ${line.trim()}`)
+        .join("\n");
+}
+export function printRunResult(result) {
+    const seconds = (result.durationMs / 1000).toFixed(1);
+    if (result.sourceRestored)
+        console.log("! The tests modified the source file under test; Assertloom restored the original.");
+    if (result.infra) {
+        console.log(`✗ Jest could not run the tests (${result.infra.kind}, ${result.setup}, ${seconds}s)`);
+        console.log(firstLines(result.infra.message, 8));
+        return;
+    }
+    const skipped = result.skipped ? `, ${result.skipped} skipped` : "";
+    const mark = result.failed ? "!" : "✓";
+    console.log(`${mark} Ran Jest: ${result.passed} passed, ${result.failed} failed${skipped} (${result.setup}, ${seconds}s)`);
+    for (const test of result.tests) {
+        if (test.status !== "failed" || !test.failure)
+            continue;
+        console.log(`  ✗ ${test.suite ? `${test.suite} › ` : ""}${test.name}  [${test.failure.kind}]`);
+        console.log(firstLines(test.failure.message, 4));
+    }
+    if (result.coverage)
+        console.log(`✓ Coverage: ${formatCoverage(result.coverage)}`);
+}
+//# sourceMappingURL=report.js.map

package/dist/cli/report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"report.js","sourceRoot":"","sources":["../../src/cli/report.ts"],"names":[],"mappings":"AAEA,SAAS,GAAG,CAAC,KAAoB;IAC/B,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,cAAc,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,YAAY,CAAC;AAClH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,KAAa;IAC7C,OAAO,IAAI;SACR,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC7B,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;SACrC,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,MAAiB;IAC9C,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACtD,IAAI,MAAM,CAAC,cAAc;QAAE,OAAO,CAAC,GAAG,CAAC,oFAAoF,CAAC,CAAC;IAE7H,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,OAAO,CAAC,GAAG,CAAC,mCAAmC,MAAM,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC;QACnG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;QACjD,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;IACpE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACvC,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,cAAc,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,UAAU,OAAO,KAAK,MAAM,CAAC,KAAK,KAAK,OAAO,IAAI,CAAC,CAAC;IAE3H,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,SAAS;QACxD,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,CAAC,CAAC;QAC/F,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC"}

package/dist/cli/validateFile.d.ts

@@ -0,0 +1,5 @@
+import { UserError } from "../errors.js";
+import { type SourceFile } from "../types/index.js";
+export declare class FileValidationError extends UserError {
+}
+export declare function validateSourceFile(inputPath: string, cwd?: string): Promise<SourceFile>;

package/dist/cli/validateFile.js

@@ -0,0 +1,43 @@
+import { stat } from "node:fs/promises";
+import path from "node:path";
+import { UserError } from "../errors.js";
+import { SUPPORTED_EXTENSIONS } from "../types/index.js";
+export class FileValidationError extends UserError {
+}
+const MAX_FILE_SIZE_BYTES = 1024 * 1024;
+function isSupportedExtension(ext) {
+    return SUPPORTED_EXTENSIONS.includes(ext);
+}
+export async function validateSourceFile(inputPath, cwd = process.cwd()) {
+    const absolutePath = path.resolve(cwd, inputPath);
+    const displayPath = path.relative(cwd, absolutePath) || inputPath;
+    const extension = path.extname(absolutePath).toLowerCase();
+    if (!isSupportedExtension(extension)) {
+        throw new FileValidationError(`Unsupported file type "${extension || "(none)"}" for ${displayPath}. ` +
+            `Supported extensions: ${SUPPORTED_EXTENSIONS.join(", ")}`);
+    }
+    if (/\.(test|spec)\.[cm]?[jt]sx?$/i.test(absolutePath)) {
+        throw new FileValidationError(`${displayPath} looks like a test file. Point Assertloom at source code instead.`);
+    }
+    let stats;
+    try {
+        stats = await stat(absolutePath);
+    }
+    catch {
+        throw new FileValidationError(`File not found: ${displayPath}`);
+    }
+    if (!stats.isFile()) {
+        throw new FileValidationError(`Not a file: ${displayPath}`);
+    }
+    if (stats.size > MAX_FILE_SIZE_BYTES) {
+        throw new FileValidationError(`${displayPath} is ${(stats.size / 1024).toFixed(0)} KB; files larger than 1 MB are not supported.`);
+    }
+    return {
+        inputPath: displayPath,
+        absolutePath,
+        extension,
+        language: /^\.[cm]?tsx?$/.test(extension) ? "typescript" : "javascript",
+        sizeBytes: stats.size,
+    };
+}
+//# sourceMappingURL=validateFile.js.map

package/dist/cli/validateFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateFile.js","sourceRoot":"","sources":["../../src/cli/validateFile.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAA4C,MAAM,mBAAmB,CAAC;AAEnG,MAAM,OAAO,mBAAoB,SAAQ,SAAS;CAAG;AAErD,MAAM,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAAC;AAExC,SAAS,oBAAoB,CAAC,GAAW;IACvC,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAC,IAAI,SAAS,CAAC;IAElE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC3D,IAAI,CAAC,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAC3B,0BAA0B,SAAS,IAAI,QAAQ,SAAS,WAAW,IAAI;YACrE,yBAAyB,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,+BAA+B,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,mBAAmB,CAAC,GAAG,WAAW,mEAAmE,CAAC,CAAC;IACnH,CAAC;IAED,IAAI,KAAK,CAAC;IACV,IAAI,CAAC;QACH,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,mBAAmB,CAAC,mBAAmB,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,MAAM,IAAI,mBAAmB,CAAC,eAAe,WAAW,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,GAAG,mBAAmB,EAAE,CAAC;QACrC,MAAM,IAAI,mBAAmB,CAC3B,GAAG,WAAW,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,gDAAgD,CACpG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,SAAS,EAAE,WAAW;QACtB,YAAY;QACZ,SAAS;QACT,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,YAAY;QACvE,SAAS,EAAE,KAAK,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,4 @@
+/** An expected failure with a message fit to show the user as-is (no stack trace). */
+export declare class UserError extends Error {
+    constructor(message: string);
+}

package/dist/errors.js

@@ -0,0 +1,8 @@
+/** An expected failure with a message fit to show the user as-is (no stack trace). */
+export class UserError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = new.target.name;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,MAAM,OAAO,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC;IAC9B,CAAC;CACF"}

package/dist/generator/diff.d.ts

@@ -0,0 +1,5 @@
+/** A unified line diff (`-` removed, `+` added) with `context` unchanged lines around each change. */
+export declare function unifiedDiff(before: string, after: string, { context, maxLines }?: {
+    context?: number | undefined;
+    maxLines?: number | undefined;
+}): string[];

package/dist/generator/diff.js

@@ -0,0 +1,56 @@
+/** Larger inputs get a one-line summary instead of a line diff, to bound memory. */
+const MAX_DIFF_CELLS = 4_000_000;
+/** A unified line diff (`-` removed, `+` added) with `context` unchanged lines around each change. */
+export function unifiedDiff(before, after, { context = 3, maxLines = 120 } = {}) {
+    const a = before.split("\n");
+    const b = after.split("\n");
+    if (before === after)
+        return [];
+    if (a.length * b.length > MAX_DIFF_CELLS)
+        return [`(${a.length} lines → ${b.length} lines; too large to diff)`];
+    // lcs[i][j] = length of the longest common subsequence of a[i..] and b[j..].
+    const width = b.length + 1;
+    const lcs = new Uint32Array((a.length + 1) * width);
+    for (let i = a.length - 1; i >= 0; i--) {
+        for (let j = b.length - 1; j >= 0; j--) {
+            lcs[i * width + j] = a[i] === b[j] ? lcs[(i + 1) * width + j + 1] + 1 : Math.max(lcs[(i + 1) * width + j], lcs[i * width + j + 1]);
+        }
+    }
+    const ops = [];
+    let i = 0;
+    let j = 0;
+    while (i < a.length || j < b.length) {
+        if (i < a.length && j < b.length && a[i] === b[j])
+            ops.push({ kind: " ", text: a[i], oldLine: i++, newLine: j++ });
+        else if (i < a.length && (j === b.length || lcs[(i + 1) * width + j] >= lcs[i * width + j + 1]))
+            ops.push({ kind: "-", text: a[i], oldLine: i++, newLine: j });
+        else
+            ops.push({ kind: "+", text: b[j], oldLine: i, newLine: j++ });
+    }
+    const keep = ops.map(() => false);
+    ops.forEach((op, index) => {
+        if (op.kind === " ")
+            return;
+        for (let k = Math.max(0, index - context); k <= Math.min(ops.length - 1, index + context); k++)
+            keep[k] = true;
+    });
+    const lines = [];
+    for (let start = 0; start < ops.length; start++) {
+        if (!keep[start])
+            continue;
+        let end = start;
+        while (end + 1 < ops.length && keep[end + 1])
+            end++;
+        const hunk = ops.slice(start, end + 1);
+        const oldCount = hunk.filter((op) => op.kind !== "+").length;
+        const newCount = hunk.filter((op) => op.kind !== "-").length;
+        lines.push(`@@ -${hunk[0].oldLine + 1},${oldCount} +${hunk[0].newLine + 1},${newCount} @@`);
+        for (const op of hunk)
+            lines.push(`${op.kind}${op.text}`);
+        start = end;
+    }
+    if (lines.length > maxLines)
+        return [...lines.slice(0, maxLines), `… ${lines.length - maxLines} more diff lines`];
+    return lines;
+}
+//# sourceMappingURL=diff.js.map

package/dist/generator/diff.js.map

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

package/dist/generator/importPlan.d.ts

@@ -0,0 +1,15 @@
+import type { FileAnalysis, FunctionInfo } from "../types/index.js";
+export interface Binding {
+    /** Name the test code uses to call the function. */
+    binding: string;
+    /** Exported name in the source module, or `"default"`. */
+    exportName: string;
+    fn: FunctionInfo;
+}
+export interface ImportPlan {
+    statements: string[];
+    bindings: Binding[];
+}
+/** Module specifier for importing `sourcePath` from a test file at `testPath`. */
+export declare function importSpecifier(testPath: string, sourcePath: string): string;
+export declare function planImports(analysis: FileAnalysis, functions: FunctionInfo[], sourcePath: string, testPath: string): ImportPlan;

package/dist/generator/importPlan.js

@@ -0,0 +1,62 @@
+import path from "node:path";
+const RESERVED = new Set(("break case catch class const continue debugger default delete do else enum export extends false finally for function if import in " +
+    "instanceof new null return super switch this throw true try typeof var void while with yield let static implements interface " +
+    "package private protected public await arguments eval undefined NaN Infinity").split(" "));
+const isIdentifierName = (name) => /^[A-Za-z_$][\w$]*$/.test(name);
+function camelCase(text) {
+    const words = text.split(/[^A-Za-z0-9]+/).filter(Boolean);
+    const joined = words.map((w, i) => (i === 0 ? w[0].toLowerCase() : w[0].toUpperCase()) + w.slice(1)).join("");
+    return /^[A-Za-z_$]/.test(joined) ? joined : `_${joined}`;
+}
+/** A local binding name for `name` that is a valid, unused, non-reserved identifier. */
+function localName(name, used) {
+    let base = isIdentifierName(name) ? name : camelCase(name);
+    if (RESERVED.has(base))
+        base = `_${base}`;
+    let binding = base;
+    for (let n = 2; used.has(binding); n++)
+        binding = `${base}${n}`;
+    used.add(binding);
+    return binding;
+}
+const exportKey = (name) => (isIdentifierName(name) ? name : JSON.stringify(name));
+/** Module specifier for importing `sourcePath` from a test file at `testPath`. */
+export function importSpecifier(testPath, sourcePath) {
+    let relative = path.relative(path.dirname(testPath), sourcePath).replaceAll("\\", "/");
+    relative = relative.replace(/\.(ts|tsx|js|jsx)$/, "");
+    return relative.startsWith(".") ? relative : `./${relative}`;
+}
+export function planImports(analysis, functions, sourcePath, testPath) {
+    const bindings = [];
+    const used = new Set();
+    for (const fn of functions) {
+        const named = fn.exportedAs.find((name) => name !== "default");
+        if (named)
+            bindings.push({ binding: localName(named, used), exportName: named, fn });
+    }
+    for (const fn of functions) {
+        if (fn.exportedAs.some((name) => name !== "default") || !fn.exportedAs.includes("default"))
+            continue;
+        const base = fn.name !== "default" ? fn.name : camelCase(path.basename(sourcePath).replace(/\.[^.]+$/, ""));
+        bindings.push({ binding: localName(used.has(base) ? `${base}Default` : base, used), exportName: "default", fn });
+    }
+    const specifier = JSON.stringify(importSpecifier(testPath, sourcePath));
+    const defaultBinding = bindings.find((b) => b.exportName === "default")?.binding;
+    const named = bindings.filter((b) => b.exportName !== "default");
+    const statements = [];
+    if (analysis.moduleSystem === "commonjs") {
+        const properties = named.map((b) => (b.binding === b.exportName ? b.binding : `${exportKey(b.exportName)}: ${b.binding}`));
+        if (defaultBinding)
+            statements.push(`const ${defaultBinding} = require(${specifier});`);
+        if (properties.length)
+            statements.push(`const { ${properties.join(", ")} } = require(${specifier});`);
+    }
+    else {
+        const specifiers = named.map((b) => (b.binding === b.exportName ? b.binding : `${exportKey(b.exportName)} as ${b.binding}`));
+        const clauses = [defaultBinding, specifiers.length ? `{ ${specifiers.join(", ")} }` : undefined].filter(Boolean);
+        if (clauses.length)
+            statements.push(`import ${clauses.join(", ")} from ${specifier};`);
+    }
+    return { statements, bindings };
+}
+//# sourceMappingURL=importPlan.js.map

package/dist/generator/importPlan.js.map

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

package/dist/generator/index.d.ts

@@ -0,0 +1,5 @@
+export { BudgetExceededError, generateTests, GenerationError, type GenerationResult } from "./testGenerator.js";
+export { planMocks, PURE_BUILTINS, PURE_PACKAGES, type MockedModule, type MockPlan, type RealModule } from "./mocks.js";
+export { previewPathFor, renderTestFile, testPathFor, writeTestFile, TestFileExistsError } from "./testWriter.js";
+export { unifiedDiff } from "./diff.js";
+export { checkBody, type AcceptedCase, type ValidatedSuite } from "./validate.js";

package/dist/generator/index.js

@@ -0,0 +1,6 @@
+export { BudgetExceededError, generateTests, GenerationError } from "./testGenerator.js";
+export { planMocks, PURE_BUILTINS, PURE_PACKAGES } from "./mocks.js";
+export { previewPathFor, renderTestFile, testPathFor, writeTestFile, TestFileExistsError } from "./testWriter.js";
+export { unifiedDiff } from "./diff.js";
+export { checkBody } from "./validate.js";
+//# sourceMappingURL=index.js.map

package/dist/generator/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/generator/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAyB,MAAM,oBAAoB,CAAC;AAChH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAqD,MAAM,YAAY,CAAC;AACxH,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,WAAW,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,SAAS,EAA0C,MAAM,eAAe,CAAC"}

package/dist/generator/mocks.d.ts

@@ -0,0 +1,48 @@
+import { type FileAnalysis, type ImportCategory, type SupportedExtension } from "../types/index.js";
+/** Built-ins that are deterministic and side-effect free, so they stay real. */
+export declare const PURE_BUILTINS: Set<string>;
+/** Utility packages without I/O. Mocking them would break the code under test, so they stay real. */
+export declare const PURE_PACKAGES: Set<string>;
+export interface MockedModule {
+    /** Specifier as written in the source. */
+    source: string;
+    /** Specifier used in the test file. */
+    specifier: string;
+    category: ImportCategory;
+    /** The module is not installed or not found, so Jest must not try to resolve it. */
+    virtual: boolean;
+    reason: string;
+}
+export interface RealModule {
+    source: string;
+    reason: string;
+}
+export interface MockPlan {
+    mocked: MockedModule[];
+    real: RealModule[];
+    globals: string[];
+    /** jest.mock() calls and imports of the mocked modules; they go before the source import. */
+    imports: string[];
+    /** Shared mock objects, global mocks, and reset hooks; they go after all imports. */
+    setup: string[];
+    /** Description of the mocks for the model. */
+    summary: string;
+}
+export interface MockOptions {
+    analysis: FileAnalysis;
+    sourcePath: string;
+    testPath: string;
+    extension: SupportedExtension;
+    /** Names already used in the test file (the source function bindings). */
+    reserved: Iterable<string>;
+    /** Modules to mock even if Assertloom would keep them real. Matched by specifier or package name. */
+    mock?: string[];
+    /** Modules to keep real even if Assertloom would mock them. */
+    keepReal?: string[];
+}
+export declare function resolveLocal(fromFile: string, specifier: string): Promise<string | undefined>;
+/**
+ * Decides which imports to mock and writes the mocks. Assertloom writes every jest.mock() factory
+ * itself from how the source uses each import; the model only configures return values in tests.
+ */
+export declare function planMocks(options: MockOptions): Promise<MockPlan>;