repterm 0.1.0

package/dist/plugin/withPlugins.js

@@ -0,0 +1,101 @@
+/**
+ * Plugin Integration Helpers
+ *
+ * Provides utilities to seamlessly integrate plugins with the test framework,
+ * eliminating the need for manual initialization in every test case.
+ */
+import { test as baseTest } from '../api/test.js';
+import { describe as describeFromDescribe } from '../api/describe.js';
+/**
+ * Creates a test function that automatically initializes plugins
+ *
+ * @param config - The plugin runtime configuration
+ * @returns A wrapped test function with automatic plugin initialization
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { createTestWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * const test = createTestWithPlugins(config);
+ *
+ * test('my test', async (ctx) => {
+ *   // ctx automatically includes all plugins!
+ *   ctx.logger.info('Hello!');
+ *   ctx.plugins.logger.log('info', 'World!');
+ * });
+ * ```
+ */
+export function createTestWithPlugins(config) {
+    /**
+     * Wrapped test function with automatic plugin initialization
+     */
+    function testWithPlugins(name, fn) {
+        baseTest(name, async ({ terminal }) => {
+            // Create plugin factory for new terminals
+            const pluginFactory = (newTerminal) => {
+                // Initialize plugins with new terminal context
+                const newCtx = config.initialize({ terminal: newTerminal });
+                return newCtx.plugins;
+            };
+            // Inject plugin factory into terminal
+            terminal.setPluginFactory?.(pluginFactory);
+            // Initialize plugins with test context
+            const augmentedCtx = config.initialize({ terminal });
+            // Run beforeTest hooks
+            await config.runBeforeTestHooks({ terminal });
+            try {
+                // Execute the test with augmented context
+                await fn(augmentedCtx);
+                // Run afterTest hooks (success)
+                await config.runAfterTestHooks({ terminal });
+            }
+            catch (error) {
+                // Run afterTest hooks (failure)
+                await config.runAfterTestHooks({ terminal }, error);
+                throw error;
+            }
+        });
+    }
+    return testWithPlugins;
+}
+/**
+ * Creates a describe block where all tests automatically have plugin access
+ *
+ * @param config - The plugin runtime configuration
+ * @param name - The describe block name
+ * @param fn - The describe block callback
+ *
+ * @example
+ * ```ts
+ * import { defineConfig } from 'repterm';
+ * import { describeWithPlugins } from 'repterm/plugin/withPlugins';
+ * import { loggerPlugin } from './plugins/logger';
+ *
+ * const config = defineConfig({
+ *   plugins: [loggerPlugin()] as const,
+ * });
+ *
+ * describeWithPlugins(config, 'My Suite', ({ test }) => {
+ *   test('test 1', async (ctx) => {
+ *     ctx.logger.info('Auto-initialized!');
+ *   });
+ *
+ *   test('test 2', async (ctx) => {
+ *     ctx.logger.debug('Same here!');
+ *   });
+ * });
+ * ```
+ */
+export function describeWithPlugins(config, name, fn) {
+    describeFromDescribe(name, () => {
+        const test = createTestWithPlugins(config);
+        fn({ test, describe: describeFromDescribe });
+    });
+}
+//# sourceMappingURL=withPlugins.js.map

package/dist/plugin/withPlugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withPlugins.js","sourceRoot":"","sources":["../../src/plugin/withPlugins.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,IAAI,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,QAAQ,IAAI,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAUtE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,qBAAqB,CACjC,MAA+B;IAE/B;;OAEG;IACH,SAAS,eAAe,CACpB,IAAY,EACZ,EAAgC;QAEhC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE;YAClC,0CAA0C;YAC1C,MAAM,aAAa,GAAG,CAAC,WAA4B,EAAE,EAAE;gBACnD,+CAA+C;gBAC/C,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC5D,OAAO,MAAM,CAAC,OAAO,CAAC;YAC1B,CAAC,CAAC;YAEF,sCAAsC;YACtC,QAAQ,CAAC,gBAAgB,EAAE,CAAC,aAAa,CAAC,CAAC;YAE3C,uCAAuC;YACvC,MAAM,YAAY,GAAG,MAAM,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAErD,uBAAuB;YACvB,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE9C,IAAI,CAAC;gBACD,0CAA0C;gBAC1C,MAAM,EAAE,CAAC,YAAY,CAAC,CAAC;gBAEvB,gCAAgC;gBAChC,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,gCAAgC;gBAChC,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,EAAE,KAAc,CAAC,CAAC;gBAC7D,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC,CAAC,CAAC;IACP,CAAC;IAED,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,mBAAmB,CAC/B,MAA+B,EAC/B,IAAY,EACZ,EAGU;IAEV,oBAAoB,CAAC,IAAI,EAAE,GAAG,EAAE;QAC5B,MAAM,IAAI,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAC3C,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,oBAAoB,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/recording/recorder.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Asciinema recording mode implementation
+ * Manages asciinema session control and artifacts
+ */
+import { EventEmitter } from 'events';
+export interface RecorderConfig {
+    castFile: string;
+    cols?: number;
+    rows?: number;
+    command?: string;
+}
+/**
+ * Asciinema recorder wrapper
+ */
+export declare class Recorder extends EventEmitter {
+    private process;
+    private config;
+    private recording;
+    constructor(config: RecorderConfig);
+    /**
+     * Start recording
+     */
+    start(): void;
+    /**
+     * Stop recording
+     */
+    stop(): void;
+    /**
+     * Check if currently recording
+     */
+    isRecording(): boolean;
+    /**
+     * Get the cast file path
+     */
+    getCastFile(): string;
+}
+/**
+ * Create a recorder instance
+ */
+export declare function createRecorder(config: RecorderConfig): Recorder;
+/**
+ * Check if asciinema is available
+ */
+export declare function checkAsciinemaAvailable(): Promise<boolean>;
+//# sourceMappingURL=recorder.d.ts.map

package/dist/recording/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/recording/recorder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,YAAY;IACxC,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,cAAc;IAKlC;;OAEG;IACH,KAAK,IAAI,IAAI;IA2Cb;;OAEG;IACH,IAAI,IAAI,IAAI;IAUZ;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,WAAW,IAAI,MAAM;CAGtB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,QAAQ,CAE/D;AAED;;GAEG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,OAAO,CAAC,CAQhE"}

package/dist/recording/recorder.js

@@ -0,0 +1,97 @@
+/**
+ * Asciinema recording mode implementation
+ * Manages asciinema session control and artifacts
+ */
+import { EventEmitter } from 'events';
+/**
+ * Asciinema recorder wrapper
+ */
+export class Recorder extends EventEmitter {
+    process = null;
+    config;
+    recording = false;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    /**
+     * Start recording
+     */
+    start() {
+        if (this.recording) {
+            throw new Error('Recording already started');
+        }
+        const args = ['rec', this.config.castFile];
+        // Add dimensions if specified
+        if (this.config.cols && this.config.rows) {
+            args.push('--cols', this.config.cols.toString());
+            args.push('--rows', this.config.rows.toString());
+        }
+        // Add command if specified
+        if (this.config.command) {
+            args.push('--command', this.config.command);
+        }
+        try {
+            // Start asciinema using Bun.spawn
+            this.process = Bun.spawn(['asciinema', ...args], {
+                stdin: 'inherit',
+                stdout: 'inherit',
+                stderr: 'inherit',
+            });
+            this.recording = true;
+            // Handle exit
+            // Bun.spawn doesn't have .on('exit'), use .exited promise
+            this.process.exited.then((code) => {
+                this.recording = false;
+                this.emit('exit', code);
+            }).catch((err) => {
+                console.error("Error waiting for process exit:", err);
+            });
+        }
+        catch (error) {
+            this.recording = false;
+            this.emit('error', error);
+        }
+    }
+    /**
+     * Stop recording
+     */
+    stop() {
+        if (!this.recording || !this.process) {
+            return;
+        }
+        this.process.kill('SIGTERM');
+        this.recording = false;
+        // Note: The 'exit' event will be emitted by the .exited handler in start()
+    }
+    /**
+     * Check if currently recording
+     */
+    isRecording() {
+        return this.recording;
+    }
+    /**
+     * Get the cast file path
+     */
+    getCastFile() {
+        return this.config.castFile;
+    }
+}
+/**
+ * Create a recorder instance
+ */
+export function createRecorder(config) {
+    return new Recorder(config);
+}
+/**
+ * Check if asciinema is available
+ */
+export async function checkAsciinemaAvailable() {
+    const proc = Bun.spawn(['which', 'asciinema'], {
+        stdout: 'ignore',
+        stderr: 'ignore',
+    });
+    await proc.exited;
+    return proc.exitCode === 0;
+}
+//# sourceMappingURL=recorder.js.map

package/dist/recording/recorder.js.map

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

package/dist/runner/artifacts.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Artifact directory manager and path helpers
+ * Manages test artifacts (recordings)
+ */
+export interface ArtifactConfig {
+    baseDir: string;
+    runId: string;
+}
+export declare class ArtifactManager {
+    private baseDir;
+    private runId;
+    private runDir;
+    constructor(config: ArtifactConfig);
+    /**
+     * Initialize artifact directory structure
+     */
+    init(): void;
+    /**
+     * Get path for a cast recording artifact
+     */
+    getCastPath(testId: string): string;
+    /**
+     * Get the base artifacts directory
+     */
+    getBaseDir(): string;
+    /**
+     * Get the run ID
+     */
+    getRunId(): string;
+}
+/**
+ * Generate a unique run ID
+ */
+export declare function generateRunId(): string;
+/**
+ * Create artifact manager for a new run
+ */
+export declare function createArtifactManager(baseDir?: string): ArtifactManager;
+//# sourceMappingURL=artifacts.d.ts.map

package/dist/runner/artifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.d.ts","sourceRoot":"","sources":["../../src/runner/artifacts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,cAAc;IAMlC;;OAEG;IACH,IAAI,IAAI,IAAI;IAMZ;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAInC;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM;CAGnB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAItC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,MAAuB,GAAG,eAAe,CAGvF"}

package/dist/runner/artifacts.js

@@ -0,0 +1,59 @@
+/**
+ * Artifact directory manager and path helpers
+ * Manages test artifacts (recordings)
+ */
+import { mkdirSync, existsSync } from 'fs';
+import { join } from 'path';
+import { randomBytes } from 'crypto';
+export class ArtifactManager {
+    baseDir;
+    runId;
+    runDir;
+    constructor(config) {
+        this.baseDir = config.baseDir;
+        this.runId = config.runId;
+        this.runDir = join(this.baseDir, this.runId);
+    }
+    /**
+     * Initialize artifact directory structure
+     */
+    init() {
+        if (!existsSync(this.runDir)) {
+            mkdirSync(this.runDir, { recursive: true });
+        }
+    }
+    /**
+     * Get path for a cast recording artifact
+     */
+    getCastPath(testId) {
+        return join(this.runDir, `${testId}.cast`);
+    }
+    /**
+     * Get the base artifacts directory
+     */
+    getBaseDir() {
+        return this.baseDir;
+    }
+    /**
+     * Get the run ID
+     */
+    getRunId() {
+        return this.runId;
+    }
+}
+/**
+ * Generate a unique run ID
+ */
+export function generateRunId() {
+    const timestamp = Date.now().toString(36);
+    const random = randomBytes(4).toString('hex');
+    return `${timestamp}-${random}`;
+}
+/**
+ * Create artifact manager for a new run
+ */
+export function createArtifactManager(baseDir = '/tmp/repterm') {
+    const runId = generateRunId();
+    return new ArtifactManager({ baseDir, runId });
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/runner/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/runner/artifacts.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAOrC,MAAM,OAAO,eAAe;IAClB,OAAO,CAAS;IAChB,KAAK,CAAS;IACd,MAAM,CAAS;IAEvB,YAAY,MAAsB;QAChC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,IAAI;QACF,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,MAAc;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9C,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,UAAkB,cAAc;IACpE,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,OAAO,IAAI,eAAe,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC"}

package/dist/runner/config.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Run configuration loader
+ * Handles timeouts, recording mode, and parallel execution settings
+ */
+export interface RunConfig {
+    timeouts: {
+        suiteMs: number;
+        testMs: number;
+    };
+    record: {
+        enabled: boolean;
+        castFile?: string;
+    };
+    parallel: {
+        workers: number;
+    };
+    terminal: {
+        promptLineCount?: number;
+    };
+}
+export interface ConfigOptions {
+    timeouts?: {
+        suiteMs?: number;
+        testMs?: number;
+    };
+    record?: {
+        enabled?: boolean;
+        castFile?: string;
+    };
+    parallel?: {
+        workers?: number;
+    };
+    terminal?: {
+        promptLineCount?: number;
+    };
+}
+/**
+ * Load and validate run configuration
+ * Merges user options with defaults
+ */
+export declare function loadConfig(options?: ConfigOptions): RunConfig;
+/**
+ * Get default configuration
+ */
+export declare function getDefaultConfig(): RunConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/runner/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/runner/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,MAAM,EAAE;QACN,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE;QACR,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,QAAQ,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAkBD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,aAAkB,GAAG,SAAS,CAsBjE;AAoBD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,SAAS,CAE5C"}

package/dist/runner/config.js

@@ -0,0 +1,65 @@
+/**
+ * Run configuration loader
+ * Handles timeouts, recording mode, and parallel execution settings
+ */
+const DEFAULT_CONFIG = {
+    timeouts: {
+        suiteMs: 1500000, // 15 minutes
+        testMs: 300000, // 5 minutes
+    },
+    record: {
+        enabled: false,
+    },
+    parallel: {
+        workers: 1,
+    },
+    terminal: {
+        promptLineCount: undefined, // 自动检测
+    },
+};
+/**
+ * Load and validate run configuration
+ * Merges user options with defaults
+ */
+export function loadConfig(options = {}) {
+    const config = {
+        timeouts: {
+            suiteMs: options.timeouts?.suiteMs ?? DEFAULT_CONFIG.timeouts.suiteMs,
+            testMs: options.timeouts?.testMs ?? DEFAULT_CONFIG.timeouts.testMs,
+        },
+        record: {
+            enabled: options.record?.enabled ?? DEFAULT_CONFIG.record.enabled,
+            castFile: options.record?.castFile,
+        },
+        parallel: {
+            workers: options.parallel?.workers ?? DEFAULT_CONFIG.parallel.workers,
+        },
+        terminal: {
+            promptLineCount: options.terminal?.promptLineCount,
+        },
+    };
+    // Validate configuration
+    validateConfig(config);
+    return config;
+}
+function validateConfig(config) {
+    if (config.timeouts.suiteMs <= 0) {
+        throw new Error('Suite timeout must be a positive integer');
+    }
+    if (config.timeouts.testMs <= 0) {
+        throw new Error('Test timeout must be a positive integer');
+    }
+    if (config.parallel.workers < 1) {
+        throw new Error('Worker count must be at least 1');
+    }
+    if (config.timeouts.testMs > config.timeouts.suiteMs) {
+        throw new Error('Test timeout cannot exceed suite timeout');
+    }
+}
+/**
+ * Get default configuration
+ */
+export function getDefaultConfig() {
+    return { ...DEFAULT_CONFIG };
+}
+//# sourceMappingURL=config.js.map

package/dist/runner/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/runner/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAoCH,MAAM,cAAc,GAAc;IAChC,QAAQ,EAAE;QACR,OAAO,EAAE,OAAO,EAAE,aAAa;QAC/B,MAAM,EAAE,MAAM,EAAE,YAAY;KAC7B;IACD,MAAM,EAAE;QACN,OAAO,EAAE,KAAK;KACf;IACD,QAAQ,EAAE;QACR,OAAO,EAAE,CAAC;KACX;IACD,QAAQ,EAAE;QACR,eAAe,EAAE,SAAS,EAAG,OAAO;KACrC;CACF,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,UAAyB,EAAE;IACpD,MAAM,MAAM,GAAc;QACxB,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC,OAAO;YACrE,MAAM,EAAE,OAAO,CAAC,QAAQ,EAAE,MAAM,IAAI,cAAc,CAAC,QAAQ,CAAC,MAAM;SACnE;QACD,MAAM,EAAE;YACN,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,OAAO;YACjE,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ;SACnC;QACD,QAAQ,EAAE;YACR,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,IAAI,cAAc,CAAC,QAAQ,CAAC,OAAO;SACtE;QACD,QAAQ,EAAE;YACR,eAAe,EAAE,OAAO,CAAC,QAAQ,EAAE,eAAe;SACnD;KACF,CAAC;IAEF,yBAAyB;IACzB,cAAc,CAAC,MAAM,CAAC,CAAC;IAEvB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,MAAiB;IACvC,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;AAC/B,CAAC"}

package/dist/runner/filter.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Test filtering logic
+ * Filters tests based on --record flag and record configuration
+ */
+import type { TestCase, TestSuite } from './models.js';
+/**
+ * 判断测试是否应该在当前模式下运行
+ *
+ * 运行策略：
+ * - recordMode = false（普通模式）：运行所有测试（包括 record: true 的测试）
+ * - recordMode = true（录制模式）：只运行标注了 record: true 的测试
+ *
+ * @param testCase 测试用例
+ * @param suite 测试套件
+ * @param recordMode 是否为录制模式（--record）
+ */
+export declare function shouldRunTest(testCase: TestCase, suite: TestSuite, recordMode: boolean): boolean;
+/**
+ * 过滤测试套件，移除不应运行的测试
+ */
+export declare function filterSuites(suites: TestSuite[], recordMode: boolean): TestSuite[];
+/**
+ * 统计测试数量（包括嵌套套件）
+ */
+export declare function countTests(suites: TestSuite[]): number;
+//# sourceMappingURL=filter.d.ts.map

package/dist/runner/filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../../src/runner/filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,OAAO,GAClB,OAAO,CAWT;AAoBD;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EAAE,EACnB,UAAU,EAAE,OAAO,GAClB,SAAS,EAAE,CAIb;AAiCD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,CAWtD"}

package/dist/runner/filter.js

@@ -0,0 +1,88 @@
+/**
+ * Test filtering logic
+ * Filters tests based on --record flag and record configuration
+ */
+/**
+ * 判断测试是否应该在当前模式下运行
+ *
+ * 运行策略：
+ * - recordMode = false（普通模式）：运行所有测试（包括 record: true 的测试）
+ * - recordMode = true（录制模式）：只运行标注了 record: true 的测试
+ *
+ * @param testCase 测试用例
+ * @param suite 测试套件
+ * @param recordMode 是否为录制模式（--record）
+ */
+export function shouldRunTest(testCase, suite, recordMode) {
+    // 确定测试的 record 配置：test > suite > undefined
+    const testRecordConfig = testCase.options?.record ?? getInheritedRecordConfig(suite);
+    // 普通模式下运行所有测试
+    if (!recordMode) {
+        return true;
+    }
+    // 录制模式下只运行标注了 record: true 的测试
+    return testRecordConfig === true;
+}
+/**
+ * 获取从 suite 继承的 record 配置
+ * 递归向上查找父 suite 的配置
+ */
+function getInheritedRecordConfig(suite) {
+    // 先检查当前 suite 的配置
+    if (suite.options?.record !== undefined) {
+        return suite.options.record;
+    }
+    // 向上查找父 suite
+    if (suite.parent) {
+        return getInheritedRecordConfig(suite.parent);
+    }
+    return undefined;
+}
+/**
+ * 过滤测试套件，移除不应运行的测试
+ */
+export function filterSuites(suites, recordMode) {
+    return suites
+        .map(suite => filterSuite(suite, recordMode))
+        .filter(suite => hasTests(suite));
+}
+/**
+ * 过滤单个测试套件
+ */
+function filterSuite(suite, recordMode) {
+    const filteredTests = suite.tests.filter(test => shouldRunTest(test, suite, recordMode));
+    const filteredSubSuites = suite.suites
+        ?.map(s => filterSuite(s, recordMode))
+        .filter(s => hasTests(s));
+    return {
+        ...suite,
+        tests: filteredTests,
+        suites: filteredSubSuites,
+    };
+}
+/**
+ * 检查套件是否有测试（包括嵌套套件）
+ */
+function hasTests(suite) {
+    if (suite.tests.length > 0) {
+        return true;
+    }
+    if (suite.suites && suite.suites.length > 0) {
+        return suite.suites.some(s => hasTests(s));
+    }
+    return false;
+}
+/**
+ * 统计测试数量（包括嵌套套件）
+ */
+export function countTests(suites) {
+    let count = 0;
+    for (const suite of suites) {
+        count += suite.tests.length;
+        if (suite.suites) {
+            count += countTests(suite.suites);
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=filter.js.map

package/dist/runner/filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../../src/runner/filter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkB,EAClB,KAAgB,EAChB,UAAmB;IAEnB,2CAA2C;IAC3C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAC;IAErF,cAAc;IACd,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+BAA+B;IAC/B,OAAO,gBAAgB,KAAK,IAAI,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,SAAS,wBAAwB,CAAC,KAAgB;IAChD,kBAAkB;IAClB,IAAI,KAAK,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED,cAAc;IACd,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACjB,OAAO,wBAAwB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAmB,EACnB,UAAmB;IAEnB,OAAO,MAAM;SACV,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,WAAW,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;SAC5C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,KAAgB,EAAE,UAAmB;IACxD,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IACzF,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM;QACpC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;SACrC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5B,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,aAAa;QACpB,MAAM,EAAE,iBAAiB;KAC1B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,KAAgB;IAChC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5C,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAmB;IAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5B,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/runner/loader.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Test file discovery and loading
+ * Handles finding and importing test files with directory-level setup support
+ */
+import type { TestSuite } from './models.js';
+export interface LoaderOptions {
+    pattern?: RegExp;
+    recursive?: boolean;
+}
+/**
+ * Discover test files in a directory or direct file paths
+ */
+export declare function discoverTests(paths: string[], options?: LoaderOptions): Promise<string[]>;
+/**
+ * Load a test file and execute it to register tests
+ */
+export declare function loadTestFile(filePath: string): Promise<void>;
+/**
+ * Load multiple test files
+ */
+export declare function loadTestFiles(filePaths: string[]): Promise<void>;
+/**
+ * Load a directory with setup.ts support
+ * Creates directory-level suites and executes setup files
+ */
+export declare function loadDirectory(dirPath: string, parentSuite?: TestSuite | null, pattern?: RegExp): Promise<TestSuite>;
+/**
+ * Load test files with directory-level setup support
+ * This is the enhanced version that supports setup.ts files
+ */
+export declare function loadTestsWithSetup(paths: string[], options?: LoaderOptions): Promise<TestSuite[]>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/runner/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/runner/loader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAgBD;;GAEG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,MAAM,EAAE,CAAC,CA6BnB;AAoCD;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BlE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAItE;AA6DD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,GAAE,SAAS,GAAG,IAAW,EACpC,OAAO,GAAE,MAAwB,GAChC,OAAO,CAAC,SAAS,CAAC,CA+CpB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,SAAS,EAAE,CAAC,CA+BtB"}