modestbench 0.3.1 → 0.5.0

package/dist/adapters/types.cjs

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * ModestBench Test Framework Adapter Types
+ *
+ * Shared types for capturing test definitions from various test frameworks
+ * (Mocha, node:test, AVA) and converting them to modestbench benchmark format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.capturedToBenchmark = void 0;
+/**
+ * Convert captured test file to modestbench benchmark definition
+ *
+ * Transforms the CapturedTestFile structure into the BenchmarkDefinition format
+ * that modestbench's engine can execute.
+ *
+ * @example
+ *
+ * ```typescript
+ * const captured = await adapter.capture('/path/to/test.js');
+ * const benchmark = capturedToBenchmark(captured);
+ * // benchmark.suites contains test suites converted to benchmark suites
+ * ```
+ *
+ * @param captured - The captured test file structure from a test framework
+ *   adapter
+ * @returns A BenchmarkDefinition with suites containing benchmarks derived from
+ *   tests
+ */
+const capturedToBenchmark = (captured) => {
+    const suites = {};
+    // Convert root-level tests to a default suite (AVA-style)
+    if (captured.rootTests.length > 0) {
+        suites['default'] = {
+            benchmarks: Object.fromEntries(captured.rootTests
+                .filter((t) => !t.skip)
+                .map((test) => [test.name, { fn: test.fn }])),
+        };
+    }
+    // Convert captured suites to benchmark suites
+    for (const suite of captured.rootSuites) {
+        const converted = convertSuite(suite);
+        if (converted) {
+            suites[suite.name] = converted;
+        }
+    }
+    return { suites };
+};
+exports.capturedToBenchmark = capturedToBenchmark;
+/**
+ * Convert a captured suite to benchmark suite format
+ */
+const convertSuite = (suite) => {
+    // Skip empty suites
+    const nonSkippedTests = suite.tests.filter((t) => !t.skip);
+    if (nonSkippedTests.length === 0 && suite.children.length === 0) {
+        return null;
+    }
+    return suiteToRecord(suite);
+};
+/**
+ * Create a wrapped test function that runs beforeEach/afterEach hooks
+ *
+ * The hooks run with each benchmark iteration, matching test framework
+ * semantics where beforeEach runs before each test execution.
+ *
+ * Hook ordering follows standard test framework conventions:
+ *
+ * - BeforeEach: runs in declaration order (FIFO)
+ * - AfterEach: runs in reverse declaration order (LIFO)
+ */
+const createWrappedTestFn = (testFn, hooks) => {
+    // If no per-test hooks, return original function
+    if (hooks.beforeEach.length === 0 && hooks.afterEach.length === 0) {
+        return testFn;
+    }
+    // Wrap with hooks
+    return async () => {
+        // Run beforeEach hooks in declaration order (FIFO)
+        for (const hook of hooks.beforeEach) {
+            await hook();
+        }
+        // Run test
+        await testFn();
+        // Run afterEach hooks in reverse order (LIFO), like most test frameworks
+        for (const hook of [...hooks.afterEach].reverse()) {
+            await hook();
+        }
+    };
+};
+/**
+ * Flatten nested suites into a list of [prefixed-name, wrapped-fn] pairs
+ */
+const flattenSuiteTests = (suite, prefix) => {
+    const results = [];
+    // Add direct tests with prefix
+    for (const test of suite.tests) {
+        if (!test.skip) {
+            const wrappedFn = createWrappedTestFn(test.fn, suite.hooks);
+            results.push([`${prefix} > ${test.name}`, wrappedFn]);
+        }
+    }
+    // Recursively add nested suite tests
+    for (const child of suite.children) {
+        const childResults = flattenSuiteTests(child, `${prefix} > ${child.name}`);
+        results.push(...childResults);
+    }
+    return results;
+};
+/**
+ * Helper to build the suite record structure
+ */
+const suiteToRecord = (suite) => {
+    const benchmarks = {};
+    // Add tests as benchmarks
+    for (const test of suite.tests) {
+        if (!test.skip) {
+            // Wrap test function with beforeEach/afterEach hooks
+            const wrappedFn = createWrappedTestFn(test.fn, suite.hooks);
+            benchmarks[test.name] = { fn: wrappedFn };
+        }
+    }
+    // Flatten nested suites into flat benchmark names
+    // e.g., "Parent > Child > test" becomes "Child > test"
+    for (const child of suite.children) {
+        const childBenchmarks = flattenSuiteTests(child, child.name);
+        for (const [name, fn] of childBenchmarks) {
+            benchmarks[name] = { fn };
+        }
+    }
+    // Combine before hooks into a single setup function
+    const setup = suite.hooks.before.length > 0
+        ? async () => {
+            for (const hook of suite.hooks.before) {
+                await hook();
+            }
+        }
+        : undefined;
+    // Combine after hooks into a single teardown function
+    const teardown = suite.hooks.after.length > 0
+        ? async () => {
+            for (const hook of suite.hooks.after) {
+                await hook();
+            }
+        }
+        : undefined;
+    return {
+        benchmarks,
+        ...(setup && { setup }),
+        ...(teardown && { teardown }),
+    };
+};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.cjs.map

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

package/dist/adapters/types.d.cts

@@ -0,0 +1,112 @@
+/**
+ * ModestBench Test Framework Adapter Types
+ *
+ * Shared types for capturing test definitions from various test frameworks
+ * (Mocha, node:test, AVA) and converting them to modestbench benchmark format.
+ */
+import type { BenchmarkDefinition, BenchmarkSuite } from "../core/benchmark-schema.cjs";
+/**
+ * A captured test suite (describe block) from a test framework
+ */
+export interface CapturedSuite {
+    /** Nested child suites */
+    readonly children: CapturedSuite[];
+    /** Lifecycle hooks for the suite */
+    readonly hooks: SuiteHooks;
+    /** Suite name */
+    readonly name: string;
+    /** Tests in this suite */
+    readonly tests: CapturedTest[];
+}
+/**
+ * A captured test function from a test framework
+ */
+export interface CapturedTest {
+    /** Test function body */
+    readonly fn: () => Promise<void> | void;
+    /** Test name */
+    readonly name: string;
+    /** Whether this test is marked .only */
+    readonly only?: boolean;
+    /** Whether this test is marked .skip */
+    readonly skip?: boolean;
+}
+/**
+ * Result of capturing tests from a single file
+ */
+export interface CapturedTestFile {
+    /** File path */
+    readonly filePath: string;
+    /** Test framework detected/used */
+    readonly framework: TestFramework;
+    /** Root-level suites (describe blocks) */
+    readonly rootSuites: CapturedSuite[];
+    /** Root-level tests (not in any describe block - e.g., AVA) */
+    readonly rootTests: CapturedTest[];
+}
+/**
+ * Converted benchmark suite structure
+ *
+ * This is what capturedToBenchmark produces for each suite.
+ */
+export type ConvertedBenchmarkSuite = Pick<BenchmarkSuite, 'benchmarks' | 'setup' | 'teardown'>;
+/**
+ * Lifecycle hooks captured from a test suite
+ */
+export interface SuiteHooks {
+    /** Hooks to run once after all tests in suite */
+    readonly after: Array<() => Promise<void> | void>;
+    /** Hooks to run after each test */
+    readonly afterEach: Array<() => Promise<void> | void>;
+    /** Hooks to run once before all tests in suite */
+    readonly before: Array<() => Promise<void> | void>;
+    /** Hooks to run before each test */
+    readonly beforeEach: Array<() => Promise<void> | void>;
+}
+/**
+ * Supported test frameworks
+ */
+export type TestFramework = 'ava' | 'mocha' | 'node-test';
+/**
+ * Interface for test framework adapters
+ *
+ * Each adapter is responsible for:
+ *
+ * 1. Capturing test definitions from a test file
+ * 2. Normalizing them to the CapturedTestFile format
+ */
+export interface TestFrameworkAdapter {
+    /**
+     * Capture test definitions from a file
+     *
+     * This method loads the test file with appropriate hooks/mocks in place to
+     * capture test function definitions without executing the tests.
+     *
+     * @param filePath - Absolute path to the test file
+     * @returns Captured test structure
+     */
+    capture(filePath: string): Promise<CapturedTestFile>;
+    /** Framework this adapter handles */
+    readonly framework: TestFramework;
+}
+/**
+ * Convert captured test file to modestbench benchmark definition
+ *
+ * Transforms the CapturedTestFile structure into the BenchmarkDefinition format
+ * that modestbench's engine can execute.
+ *
+ * @example
+ *
+ * ```typescript
+ * const captured = await adapter.capture('/path/to/test.js');
+ * const benchmark = capturedToBenchmark(captured);
+ * // benchmark.suites contains test suites converted to benchmark suites
+ * ```
+ *
+ * @param captured - The captured test file structure from a test framework
+ *   adapter
+ * @returns A BenchmarkDefinition with suites containing benchmarks derived from
+ *   tests
+ */
+export declare const capturedToBenchmark: (captured: CapturedTestFile) => BenchmarkDefinition;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,qCAAoC;AAErC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,cAAc,EACd,YAAY,GAAG,OAAO,GAAG,UAAU,CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACtD,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErD,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,gBAAgB,KACzB,mBAuBF,CAAC"}

package/dist/adapters/types.d.ts

@@ -0,0 +1,112 @@
+/**
+ * ModestBench Test Framework Adapter Types
+ *
+ * Shared types for capturing test definitions from various test frameworks
+ * (Mocha, node:test, AVA) and converting them to modestbench benchmark format.
+ */
+import type { BenchmarkDefinition, BenchmarkSuite } from "../core/benchmark-schema.js";
+/**
+ * A captured test suite (describe block) from a test framework
+ */
+export interface CapturedSuite {
+    /** Nested child suites */
+    readonly children: CapturedSuite[];
+    /** Lifecycle hooks for the suite */
+    readonly hooks: SuiteHooks;
+    /** Suite name */
+    readonly name: string;
+    /** Tests in this suite */
+    readonly tests: CapturedTest[];
+}
+/**
+ * A captured test function from a test framework
+ */
+export interface CapturedTest {
+    /** Test function body */
+    readonly fn: () => Promise<void> | void;
+    /** Test name */
+    readonly name: string;
+    /** Whether this test is marked .only */
+    readonly only?: boolean;
+    /** Whether this test is marked .skip */
+    readonly skip?: boolean;
+}
+/**
+ * Result of capturing tests from a single file
+ */
+export interface CapturedTestFile {
+    /** File path */
+    readonly filePath: string;
+    /** Test framework detected/used */
+    readonly framework: TestFramework;
+    /** Root-level suites (describe blocks) */
+    readonly rootSuites: CapturedSuite[];
+    /** Root-level tests (not in any describe block - e.g., AVA) */
+    readonly rootTests: CapturedTest[];
+}
+/**
+ * Converted benchmark suite structure
+ *
+ * This is what capturedToBenchmark produces for each suite.
+ */
+export type ConvertedBenchmarkSuite = Pick<BenchmarkSuite, 'benchmarks' | 'setup' | 'teardown'>;
+/**
+ * Lifecycle hooks captured from a test suite
+ */
+export interface SuiteHooks {
+    /** Hooks to run once after all tests in suite */
+    readonly after: Array<() => Promise<void> | void>;
+    /** Hooks to run after each test */
+    readonly afterEach: Array<() => Promise<void> | void>;
+    /** Hooks to run once before all tests in suite */
+    readonly before: Array<() => Promise<void> | void>;
+    /** Hooks to run before each test */
+    readonly beforeEach: Array<() => Promise<void> | void>;
+}
+/**
+ * Supported test frameworks
+ */
+export type TestFramework = 'ava' | 'mocha' | 'node-test';
+/**
+ * Interface for test framework adapters
+ *
+ * Each adapter is responsible for:
+ *
+ * 1. Capturing test definitions from a test file
+ * 2. Normalizing them to the CapturedTestFile format
+ */
+export interface TestFrameworkAdapter {
+    /**
+     * Capture test definitions from a file
+     *
+     * This method loads the test file with appropriate hooks/mocks in place to
+     * capture test function definitions without executing the tests.
+     *
+     * @param filePath - Absolute path to the test file
+     * @returns Captured test structure
+     */
+    capture(filePath: string): Promise<CapturedTestFile>;
+    /** Framework this adapter handles */
+    readonly framework: TestFramework;
+}
+/**
+ * Convert captured test file to modestbench benchmark definition
+ *
+ * Transforms the CapturedTestFile structure into the BenchmarkDefinition format
+ * that modestbench's engine can execute.
+ *
+ * @example
+ *
+ * ```typescript
+ * const captured = await adapter.capture('/path/to/test.js');
+ * const benchmark = capturedToBenchmark(captured);
+ * // benchmark.suites contains test suites converted to benchmark suites
+ * ```
+ *
+ * @param captured - The captured test file structure from a test framework
+ *   adapter
+ * @returns A BenchmarkDefinition with suites containing benchmarks derived from
+ *   tests
+ */
+export declare const capturedToBenchmark: (captured: CapturedTestFile) => BenchmarkDefinition;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapters/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,cAAc,EACf,oCAAoC;AAErC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,CAAC;IACnC,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,iBAAiB;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0BAA0B;IAC1B,QAAQ,CAAC,KAAK,EAAE,YAAY,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,yBAAyB;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxC,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;IAClC,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,aAAa,EAAE,CAAC;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,YAAY,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,cAAc,EACd,YAAY,GAAG,OAAO,GAAG,UAAU,CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IAClD,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACtD,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,OAAO,GAAG,WAAW,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;;;OAQG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAErD,qCAAqC;IACrC,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,gBAAgB,KACzB,mBAuBF,CAAC"}

package/dist/adapters/types.js

@@ -0,0 +1,148 @@
+/**
+ * ModestBench Test Framework Adapter Types
+ *
+ * Shared types for capturing test definitions from various test frameworks
+ * (Mocha, node:test, AVA) and converting them to modestbench benchmark format.
+ */
+/**
+ * Convert captured test file to modestbench benchmark definition
+ *
+ * Transforms the CapturedTestFile structure into the BenchmarkDefinition format
+ * that modestbench's engine can execute.
+ *
+ * @example
+ *
+ * ```typescript
+ * const captured = await adapter.capture('/path/to/test.js');
+ * const benchmark = capturedToBenchmark(captured);
+ * // benchmark.suites contains test suites converted to benchmark suites
+ * ```
+ *
+ * @param captured - The captured test file structure from a test framework
+ *   adapter
+ * @returns A BenchmarkDefinition with suites containing benchmarks derived from
+ *   tests
+ */
+export const capturedToBenchmark = (captured) => {
+    const suites = {};
+    // Convert root-level tests to a default suite (AVA-style)
+    if (captured.rootTests.length > 0) {
+        suites['default'] = {
+            benchmarks: Object.fromEntries(captured.rootTests
+                .filter((t) => !t.skip)
+                .map((test) => [test.name, { fn: test.fn }])),
+        };
+    }
+    // Convert captured suites to benchmark suites
+    for (const suite of captured.rootSuites) {
+        const converted = convertSuite(suite);
+        if (converted) {
+            suites[suite.name] = converted;
+        }
+    }
+    return { suites };
+};
+/**
+ * Convert a captured suite to benchmark suite format
+ */
+const convertSuite = (suite) => {
+    // Skip empty suites
+    const nonSkippedTests = suite.tests.filter((t) => !t.skip);
+    if (nonSkippedTests.length === 0 && suite.children.length === 0) {
+        return null;
+    }
+    return suiteToRecord(suite);
+};
+/**
+ * Create a wrapped test function that runs beforeEach/afterEach hooks
+ *
+ * The hooks run with each benchmark iteration, matching test framework
+ * semantics where beforeEach runs before each test execution.
+ *
+ * Hook ordering follows standard test framework conventions:
+ *
+ * - BeforeEach: runs in declaration order (FIFO)
+ * - AfterEach: runs in reverse declaration order (LIFO)
+ */
+const createWrappedTestFn = (testFn, hooks) => {
+    // If no per-test hooks, return original function
+    if (hooks.beforeEach.length === 0 && hooks.afterEach.length === 0) {
+        return testFn;
+    }
+    // Wrap with hooks
+    return async () => {
+        // Run beforeEach hooks in declaration order (FIFO)
+        for (const hook of hooks.beforeEach) {
+            await hook();
+        }
+        // Run test
+        await testFn();
+        // Run afterEach hooks in reverse order (LIFO), like most test frameworks
+        for (const hook of [...hooks.afterEach].reverse()) {
+            await hook();
+        }
+    };
+};
+/**
+ * Flatten nested suites into a list of [prefixed-name, wrapped-fn] pairs
+ */
+const flattenSuiteTests = (suite, prefix) => {
+    const results = [];
+    // Add direct tests with prefix
+    for (const test of suite.tests) {
+        if (!test.skip) {
+            const wrappedFn = createWrappedTestFn(test.fn, suite.hooks);
+            results.push([`${prefix} > ${test.name}`, wrappedFn]);
+        }
+    }
+    // Recursively add nested suite tests
+    for (const child of suite.children) {
+        const childResults = flattenSuiteTests(child, `${prefix} > ${child.name}`);
+        results.push(...childResults);
+    }
+    return results;
+};
+/**
+ * Helper to build the suite record structure
+ */
+const suiteToRecord = (suite) => {
+    const benchmarks = {};
+    // Add tests as benchmarks
+    for (const test of suite.tests) {
+        if (!test.skip) {
+            // Wrap test function with beforeEach/afterEach hooks
+            const wrappedFn = createWrappedTestFn(test.fn, suite.hooks);
+            benchmarks[test.name] = { fn: wrappedFn };
+        }
+    }
+    // Flatten nested suites into flat benchmark names
+    // e.g., "Parent > Child > test" becomes "Child > test"
+    for (const child of suite.children) {
+        const childBenchmarks = flattenSuiteTests(child, child.name);
+        for (const [name, fn] of childBenchmarks) {
+            benchmarks[name] = { fn };
+        }
+    }
+    // Combine before hooks into a single setup function
+    const setup = suite.hooks.before.length > 0
+        ? async () => {
+            for (const hook of suite.hooks.before) {
+                await hook();
+            }
+        }
+        : undefined;
+    // Combine after hooks into a single teardown function
+    const teardown = suite.hooks.after.length > 0
+        ? async () => {
+            for (const hook of suite.hooks.after) {
+                await hook();
+            }
+        }
+        : undefined;
+    return {
+        benchmarks,
+        ...(setup && { setup }),
+        ...(teardown && { teardown }),
+    };
+};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

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

package/dist/cli/commands/init.cjs

@@ -10,6 +10,7 @@ exports.handleInitCommand = void 0;
 const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const node_readline_1 = require("node:readline");
+const constants_js_1 = require("../../constants.cjs");
 const index_js_1 = require("../../errors/index.cjs");
 /**
  * Project templates for different initialization types
@@ -18,39 +19,44 @@ const PROJECT_TEMPLATES = {
     advanced: {
         configOptions: {
             iterations: 1000,
-            outputDir: '.modestbench',
-            pattern: 'bench/**/*.bench.{js,ts}',
+            outputDir: constants_js_1.DEFAULT_OUTPUT_DIR,
+            pattern: `${constants_js_1.DEFAULT_BENCHMARK_DIR}/**/*.bench.{js,ts}`,
             reporters: ['human', 'json'],
             time: 10000,
             warmup: 50,
         },
         description: 'Feature-rich setup with multiple reporters and configuration',
-        directories: ['bench', '.modestbench'],
+        directories: [constants_js_1.DEFAULT_BENCHMARK_DIR, constants_js_1.DEFAULT_OUTPUT_DIR],
         name: 'Advanced Project',
     },
     basic: {
         configOptions: {
             iterations: 100,
-            pattern: 'bench/**/*.bench.{js,ts}',
+            outputDir: constants_js_1.DEFAULT_OUTPUT_DIR,
+            pattern: `${constants_js_1.DEFAULT_BENCHMARK_DIR}/**/*.bench.{js,ts}`,
             reporters: ['human'],
             time: 5000,
         },
         description: 'Simple benchmark setup for small projects',
-        directories: ['bench'],
+        directories: [constants_js_1.DEFAULT_BENCHMARK_DIR, constants_js_1.DEFAULT_OUTPUT_DIR],
         name: 'Basic Project',
     },
     library: {
         configOptions: {
             bail: false,
             iterations: 5000,
-            outputDir: '.modestbench',
-            pattern: 'bench/**/*.bench.{js,ts}',
+            outputDir: constants_js_1.DEFAULT_OUTPUT_DIR,
+            pattern: `${constants_js_1.DEFAULT_BENCHMARK_DIR}/**/*.bench.{js,ts}`,
             reporters: ['human', 'json'],
             time: 15000,
             warmup: 100,
         },
         description: 'Optimized for library performance testing',
-        directories: ['bench', 'bench/suites', '.modestbench'],
+        directories: [
+            constants_js_1.DEFAULT_BENCHMARK_DIR,
+            `${constants_js_1.DEFAULT_BENCHMARK_DIR}/suites`,
+            constants_js_1.DEFAULT_OUTPUT_DIR,
+        ],
         name: 'Library Project',
     },
 };
@@ -316,7 +322,7 @@ const createAdditionalFiles = async (cwd, options) => {
     // Create README.md
     const readmeContent = `# Benchmark Project
 
-This project uses [ModestBench](https://github.com/your-org/modestbench) for performance testing.
+This project uses [ModestBench](${constants_js_1.SITE_URL}) for performance testing.
 
 ## Getting Started
 
@@ -327,7 +333,7 @@ modestbench run
 
 Run specific benchmarks:
 \`\`\`bash
-modestbench run "bench/array-*.bench.js"
+modestbench run "${constants_js_1.DEFAULT_BENCHMARK_DIR}/array-*.bench.js"
 \`\`\`
 
 View benchmark history:
@@ -341,7 +347,7 @@ See \`modestbench.config.*\` for benchmark configuration options.
 
 ## Writing Benchmarks
 
-Create new benchmark files in the \`bench/\` directory. See the examples for the expected format.
+Create new benchmark files in the \`${constants_js_1.DEFAULT_BENCHMARK_DIR}/\` directory. See the examples for the expected format.
 `;
     try {
         const readmePath = (0, node_path_1.resolve)(cwd, 'README.md');
@@ -359,7 +365,7 @@ Create new benchmark files in the \`bench/\` directory. See the examples for the
  */
 const createOrUpdateGitignore = async (cwd, options) => {
     const gitignorePath = (0, node_path_1.resolve)(cwd, '.gitignore');
-    const modestbenchEntry = '.modestbench/';
+    const modestbenchEntry = `${constants_js_1.DEFAULT_OUTPUT_DIR}/`;
     const modestbenchSection = `\n# ModestBench history\n${modestbenchEntry}\n`;
     try {
         // Check if .gitignore exists
@@ -371,12 +377,12 @@ const createOrUpdateGitignore = async (cwd, options) => {
             // File doesn't exist, will create new one
         }
         if (existingContent) {
-            // File exists, check if .modestbench/ is already present
+            // File exists, check if ${DEFAULT_OUTPUT_DIR}/ is already present
             if (existingContent.includes(modestbenchEntry)) {
                 // Already present, nothing to do
                 return;
             }
-            // Append .modestbench/ entry (--yes or --quiet means auto-accept)
+            // Append default output dir entry (--yes or --quiet means auto-accept)
             if (options?.yes || options?.quiet) {
                 // Ensure content ends with newline
                 const contentToAppend = existingContent.endsWith('\n')
@@ -399,7 +405,6 @@ build/
 coverage/
 
 # Benchmark output
-benchmark-results/
 ${modestbenchSection}`;
             await (0, promises_1.writeFile)(gitignorePath, newContent, 'utf8');
         }
@@ -463,7 +468,7 @@ const createDirectories = async (directories, cwd) => {
  * Create example benchmark files
  */
 const createExampleBenchmarks = async (cwd) => {
-    const benchmarksDir = (0, node_path_1.resolve)(cwd, 'bench');
+    const benchmarksDir = (0, node_path_1.resolve)(cwd, constants_js_1.DEFAULT_BENCHMARK_DIR);
     for (const [name, example] of Object.entries(EXAMPLE_BENCHMARKS)) {
         const filePath = (0, node_path_1.join)(benchmarksDir, example.filename);
         try {