@gnapi/cotester 1.2.4 → 1.2.6

package/dist/frameworkAdapter.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Abstracts test-framework-specific syntax so the generator can emit
+ * either Jest or Vitest output without conditional logic scattered everywhere.
+ */
+export interface TestFrameworkAdapter {
+    /** Top-level import line(s) required by the framework (empty for Jest). */
+    frameworkImport(): string;
+    /** Produce `jest.mock(...)` / `vi.mock(...)` call for a module. */
+    mockModule(importPath: string, importedNames: string[]): string;
+    /** Check string used to detect an existing mock in a file. */
+    mockModuleCheck(importPath: string): string;
+    /** `jest.fn()` / `vi.fn()` */
+    mockFn(): string;
+    /** `jest.clearAllMocks()` / `vi.clearAllMocks()` */
+    clearAllMocks(): string;
+    /**
+     * Cast expression prefix for setting up a mock return value on a named import.
+     * Jest: `(name as jest.Mock)`
+     * Vitest: `vi.mocked(name)`
+     */
+    mockCast(name: string): string;
+    /** `<cast>.mockResolvedValue(val)` */
+    mockResolvedValue(name: string, val: string): string;
+    /** `<cast>.mockReturnValue(val)` */
+    mockReturnValue(name: string, val: string): string;
+    /** `jest.fn().mockReturnValue(val)` / `vi.fn().mockReturnValue(val)` — for inline chained stubs */
+    mockFnReturnValue(val: string): string;
+}
+export declare class JestAdapter implements TestFrameworkAdapter {
+    frameworkImport(): string;
+    mockModule(importPath: string, importedNames: string[]): string;
+    mockModuleCheck(importPath: string): string;
+    mockFn(): string;
+    clearAllMocks(): string;
+    mockCast(name: string): string;
+    mockResolvedValue(name: string, val: string): string;
+    mockReturnValue(name: string, val: string): string;
+    mockFnReturnValue(val: string): string;
+}
+export declare class VitestAdapter implements TestFrameworkAdapter {
+    frameworkImport(): string;
+    mockModule(importPath: string, importedNames: string[]): string;
+    mockModuleCheck(importPath: string): string;
+    mockFn(): string;
+    clearAllMocks(): string;
+    mockCast(name: string): string;
+    mockResolvedValue(name: string, val: string): string;
+    mockReturnValue(name: string, val: string): string;
+    mockFnReturnValue(val: string): string;
+}
+export declare function createAdapter(framework?: "jest" | "vitest"): TestFrameworkAdapter;

package/dist/frameworkAdapter.js

@@ -0,0 +1,77 @@
+"use strict";
+/**
+ * Abstracts test-framework-specific syntax so the generator can emit
+ * either Jest or Vitest output without conditional logic scattered everywhere.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VitestAdapter = exports.JestAdapter = void 0;
+exports.createAdapter = createAdapter;
+// ── Jest adapter ──────────────────────────────────────────────────────────────
+class JestAdapter {
+    frameworkImport() {
+        return "";
+    }
+    mockModule(importPath, importedNames) {
+        const fns = importedNames.map((n) => `  ${n}: jest.fn(),`).join("\n");
+        return `jest.mock('${importPath}', () => ({\n${fns}\n}));`;
+    }
+    mockModuleCheck(importPath) {
+        return `jest.mock('${importPath}'`;
+    }
+    mockFn() {
+        return "jest.fn()";
+    }
+    clearAllMocks() {
+        return "jest.clearAllMocks();";
+    }
+    mockCast(name) {
+        return `(${name} as jest.Mock)`;
+    }
+    mockResolvedValue(name, val) {
+        return `${this.mockCast(name)}.mockResolvedValue(${val});`;
+    }
+    mockReturnValue(name, val) {
+        return `${this.mockCast(name)}.mockReturnValue(${val});`;
+    }
+    mockFnReturnValue(val) {
+        return `jest.fn().mockReturnValue(${val})`;
+    }
+}
+exports.JestAdapter = JestAdapter;
+// ── Vitest adapter ────────────────────────────────────────────────────────────
+class VitestAdapter {
+    frameworkImport() {
+        return "import { describe, test, expect, vi, beforeEach } from 'vitest';";
+    }
+    mockModule(importPath, importedNames) {
+        const fns = importedNames.map((n) => `  ${n}: vi.fn(),`).join("\n");
+        return `vi.mock('${importPath}', () => ({\n${fns}\n}));`;
+    }
+    mockModuleCheck(importPath) {
+        return `vi.mock('${importPath}'`;
+    }
+    mockFn() {
+        return "vi.fn()";
+    }
+    clearAllMocks() {
+        return "vi.clearAllMocks();";
+    }
+    mockCast(name) {
+        return `vi.mocked(${name})`;
+    }
+    mockResolvedValue(name, val) {
+        return `${this.mockCast(name)}.mockResolvedValue(${val});`;
+    }
+    mockReturnValue(name, val) {
+        return `${this.mockCast(name)}.mockReturnValue(${val});`;
+    }
+    mockFnReturnValue(val) {
+        return `vi.fn().mockReturnValue(${val})`;
+    }
+}
+exports.VitestAdapter = VitestAdapter;
+// ── Factory ───────────────────────────────────────────────────────────────────
+function createAdapter(framework = "jest") {
+    return framework === "vitest" ? new VitestAdapter() : new JestAdapter();
+}
+//# sourceMappingURL=frameworkAdapter.js.map

package/dist/frameworkAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkAdapter.js","sourceRoot":"","sources":["../src/frameworkAdapter.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAuHH,sCAEC;AAtFD,iFAAiF;AAEjF,MAAa,WAAW;IACpB,eAAe;QACX,OAAO,EAAE,CAAC;IACd,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,aAAuB;QAClD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtE,OAAO,cAAc,UAAU,gBAAgB,GAAG,QAAQ,CAAC;IAC/D,CAAC;IAED,eAAe,CAAC,UAAkB;QAC9B,OAAO,cAAc,UAAU,GAAG,CAAC;IACvC,CAAC;IAED,MAAM;QACF,OAAO,WAAW,CAAC;IACvB,CAAC;IAED,aAAa;QACT,OAAO,uBAAuB,CAAC;IACnC,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,OAAO,IAAI,IAAI,gBAAgB,CAAC;IACpC,CAAC;IAED,iBAAiB,CAAC,IAAY,EAAE,GAAW;QACvC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAC/D,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,GAAW;QACrC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,iBAAiB,CAAC,GAAW;QACzB,OAAO,6BAA6B,GAAG,GAAG,CAAC;IAC/C,CAAC;CACJ;AArCD,kCAqCC;AAED,iFAAiF;AAEjF,MAAa,aAAa;IACtB,eAAe;QACX,OAAO,kEAAkE,CAAC;IAC9E,CAAC;IAED,UAAU,CAAC,UAAkB,EAAE,aAAuB;QAClD,MAAM,GAAG,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpE,OAAO,YAAY,UAAU,gBAAgB,GAAG,QAAQ,CAAC;IAC7D,CAAC;IAED,eAAe,CAAC,UAAkB;QAC9B,OAAO,YAAY,UAAU,GAAG,CAAC;IACrC,CAAC;IAED,MAAM;QACF,OAAO,SAAS,CAAC;IACrB,CAAC;IAED,aAAa;QACT,OAAO,qBAAqB,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,IAAY;QACjB,OAAO,aAAa,IAAI,GAAG,CAAC;IAChC,CAAC;IAED,iBAAiB,CAAC,IAAY,EAAE,GAAW;QACvC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAC/D,CAAC;IAED,eAAe,CAAC,IAAY,EAAE,GAAW;QACrC,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC;IAC7D,CAAC;IAED,iBAAiB,CAAC,GAAW;QACzB,OAAO,2BAA2B,GAAG,GAAG,CAAC;IAC7C,CAAC;CACJ;AArCD,sCAqCC;AAED,iFAAiF;AAEjF,SAAgB,aAAa,CAAC,YAA+B,MAAM;IAC/D,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC;AAC5E,CAAC"}

package/dist/generator.d.ts

@@ -1,5 +1,28 @@
 import { TestScenario } from "./scenarioEngine";
 import { MockFileResult } from "./mockGenerator";
+/**
+ * Marker placed as the very first line of every generated test file.
+ * Its presence lets cotester know the file was scaffolded (not hand-written),
+ * but function-level merging works regardless of whether the marker is present.
+ */
+export declare const TESTGEN_MARKER = "// @cotester-generated";
+/**
+ * Format version written into the second line of every generated test file.
+ * Used by `cotester migrate` to detect files produced by older versions and
+ * upgrade them in-place.  Increment this when the generated format changes.
+ */
+export declare const CURRENT_FILE_VERSION = 2;
+export declare const VERSION_MARKER = "// @cotester-version: 2";
+/** Returned by generateTestFile — carries the test file path and audit data. */
+export interface GenerateResult {
+    testFilePath: string;
+    /** Function names for which a new describe block was written */
+    added: string[];
+    /** Function names whose signature changed (describe existed, warning injected) */
+    merged: string[];
+    /** Function names already covered and left untouched */
+    skipped: string[];
+}
 /**
  * Generate (or merge into) a test file for the given source file.
  *
@@ -13,4 +36,4 @@ import { MockFileResult } from "./mockGenerator";
  * Individual functions/methods that already have a describe block are never
  * touched, preserving any hand-written assertions inside them.
  */
-export declare function generateTestFile(srcFilePath: string, scenarios: TestScenario[], projectRoot: string, srcDir: string, testDir: string, mockResult: MockFileResult | null, tableThreshold?: number, dryRun?: boolean): Promise<string | null>;
+export declare function generateTestFile(srcFilePath: string, scenarios: TestScenario[], projectRoot: string, srcDir: string, testDir: string, mockResult: MockFileResult | null, tableThreshold?: number, dryRun?: boolean, framework?: "jest" | "vitest", snapshotForComplexTypes?: boolean): Promise<GenerateResult | null>;