repterm 0.1.0

package/dist/api/hooks.js

@@ -0,0 +1,231 @@
+/**
+ * Hooks (beforeEach, afterEach) with Named Fixture Support
+ * Provides setup and teardown functionality with lazy execution
+ *
+ * Fixtures are only executed when tests explicitly request them via parameters.
+ */
+import { registry } from './test.js';
+/**
+ * Global hooks storage with named fixture support
+ */
+class HooksRegistry {
+    namedBeforeEachHooks = [];
+    namedAfterEachHooks = [];
+    suiteBeforeAllHooks = new Map();
+    suiteAfterAllHooks = new Map();
+    /**
+     * Register a named beforeEach hook (lazy execution)
+     * @param name Fixture name - only executed if test requests this fixture
+     * @param fn Hook function
+     * @param suiteId Optional suite ID to scope the hook
+     */
+    registerBeforeEach(name, fn, suiteId) {
+        this.namedBeforeEachHooks.push({ name, fn, suiteId });
+    }
+    /**
+     * Register a named afterEach hook (lazy cleanup)
+     * @param name Fixture name - only executed if the corresponding beforeEach was run
+     * @param fn Hook function
+     * @param suiteId Optional suite ID to scope the hook
+     */
+    registerAfterEach(name, fn, suiteId) {
+        this.namedAfterEachHooks.push({ name, fn, suiteId });
+    }
+    /**
+     * Register a beforeAll hook for a suite
+     * @param name Optional fixture name
+     * @param fn Hook function
+     * @param suiteId Suite ID to scope the hook
+     */
+    registerBeforeAll(name, fn, suiteId) {
+        if (!this.suiteBeforeAllHooks.has(suiteId)) {
+            this.suiteBeforeAllHooks.set(suiteId, []);
+        }
+        this.suiteBeforeAllHooks.get(suiteId).push({ name, fn, suiteId });
+    }
+    /**
+     * Register an afterAll hook for a suite
+     * @param name Optional fixture name
+     * @param fn Hook function
+     * @param suiteId Suite ID to scope the hook
+     */
+    registerAfterAll(name, fn, suiteId) {
+        if (!this.suiteAfterAllHooks.has(suiteId)) {
+            this.suiteAfterAllHooks.set(suiteId, []);
+        }
+        this.suiteAfterAllHooks.get(suiteId).push({ name, fn, suiteId });
+    }
+    /**
+     * Get the chain of suite IDs from root to the given suite
+     */
+    getSuiteChain(suite) {
+        const chain = [];
+        let current = suite;
+        while (current) {
+            chain.unshift(current.id);
+            current = current.parent;
+        }
+        return chain;
+    }
+    /**
+     * Check if a hook should run for a given suite
+     */
+    shouldRunHookForSuite(hookSuiteId, suiteChain) {
+        if (hookSuiteId === undefined) {
+            return suiteChain.length === 0;
+        }
+        return suiteChain.includes(hookSuiteId);
+    }
+    /**
+     * Run beforeEach hooks for requested fixtures only (lazy execution)
+     * @param context Test context
+     * @param suite Optional suite to filter hooks
+     * @param requiredFixtures Set of fixture names requested by the test
+     * @returns Augmented context with fixture values and set of executed fixture names
+     */
+    async runBeforeEachFor(context, suite, requiredFixtures) {
+        let augmentedContext = { ...context };
+        const suiteChain = suite ? this.getSuiteChain(suite) : [];
+        const executedFixtures = new Set();
+        for (const entry of this.namedBeforeEachHooks) {
+            // Only run if fixture is requested AND belongs to correct suite
+            if (requiredFixtures.has(entry.name) &&
+                this.shouldRunHookForSuite(entry.suiteId, suiteChain)) {
+                const result = await entry.fn(augmentedContext);
+                if (result && typeof result === 'object') {
+                    augmentedContext = { ...augmentedContext, ...result };
+                }
+                executedFixtures.add(entry.name);
+            }
+        }
+        return { context: augmentedContext, executedFixtures };
+    }
+    /**
+     * Run afterEach hooks for executed fixtures only
+     * @param context Test context
+     * @param suite Optional suite to filter hooks
+     * @param executedFixtures Set of fixture names that were actually executed
+     */
+    async runAfterEachFor(context, suite, executedFixtures) {
+        const suiteChain = suite ? this.getSuiteChain(suite) : [];
+        // Run in reverse order for proper cleanup
+        for (let i = this.namedAfterEachHooks.length - 1; i >= 0; i--) {
+            const entry = this.namedAfterEachHooks[i];
+            if (executedFixtures.has(entry.name) &&
+                this.shouldRunHookForSuite(entry.suiteId, suiteChain)) {
+                await entry.fn(context);
+            }
+        }
+    }
+    /**
+     * Run beforeAll hooks for a suite
+     * @param suite The suite to run hooks for
+     * @param inheritedContext Context inherited from parent suites
+     * @returns Augmented context with values from beforeAll hooks
+     */
+    async runBeforeAllFor(suite, inheritedContext = {}) {
+        const hooks = this.suiteBeforeAllHooks.get(suite.id) ?? [];
+        let context = { ...inheritedContext };
+        for (const entry of hooks) {
+            const result = await entry.fn(context);
+            if (result && typeof result === 'object') {
+                context = { ...context, ...result };
+            }
+        }
+        return context;
+    }
+    /**
+     * Run afterAll hooks for a suite
+     * @param suite The suite to run hooks for
+     * @param context Context to pass to hooks
+     */
+    async runAfterAllFor(suite, context = {}) {
+        const hooks = this.suiteAfterAllHooks.get(suite.id) ?? [];
+        // Run in reverse order for proper cleanup
+        for (let i = hooks.length - 1; i >= 0; i--) {
+            const entry = hooks[i];
+            await entry.fn(context);
+        }
+    }
+    /**
+     * Clear all hooks (for testing)
+     */
+    clear() {
+        this.namedBeforeEachHooks = [];
+        this.namedAfterEachHooks = [];
+        this.suiteBeforeAllHooks.clear();
+        this.suiteAfterAllHooks.clear();
+    }
+}
+// Global hooks registry
+export const hooksRegistry = new HooksRegistry();
+/**
+ * Register a named beforeEach hook with lazy execution
+ *
+ * 只有测试函数参数中请求了该 Fixture，才会执行此 Hook。
+ *
+ * @param name Fixture 名称（必须与返回对象的 key 一致）
+ * @param fn Hook 函数，返回对象会被注入到 context
+ *
+ * @example
+ * describe('my tests', () => {
+ *   // 注册名为 'tmpDir' 的 fixture
+ *   beforeEach('tmpDir', async () => {
+ *     const tmpDir = await fs.mkdtemp('/tmp/test-');
+ *     return { tmpDir };
+ *   });
+ *
+ *   afterEach('tmpDir', async ({ tmpDir }) => {
+ *     if (tmpDir) await fs.rm(tmpDir, { recursive: true });
+ *   });
+ *
+ *   // 这个测试会触发 tmpDir fixture
+ *   test('uses tmpDir', async ({ terminal, tmpDir }) => {
+ *     await terminal.run(`ls ${tmpDir}`);
+ *   });
+ *
+ *   // 这个测试不会触发 tmpDir fixture
+ *   test('no fixture needed', async ({ terminal }) => {
+ *     await terminal.run('echo hello');
+ *   });
+ * });
+ */
+export function beforeEach(name, fn) {
+    const suiteId = registry.getCurrentSuiteId();
+    hooksRegistry.registerBeforeEach(name, fn, suiteId);
+}
+/**
+ * Register a named afterEach hook
+ *
+ * 只有对应的 beforeEach 被执行了，此 Hook 才会执行。
+ *
+ * @param name Fixture 名称（与 beforeEach 注册的名称一致）
+ * @param fn Hook 函数
+ */
+export function afterEach(name, fn) {
+    const suiteId = registry.getCurrentSuiteId();
+    hooksRegistry.registerAfterEach(name, fn, suiteId);
+}
+export function beforeAll(nameOrFn, maybeFn) {
+    const suiteId = registry.getCurrentSuiteId();
+    if (!suiteId) {
+        throw new Error('beforeAll must be called inside a describe() block');
+    }
+    const name = typeof nameOrFn === 'string' ? nameOrFn : undefined;
+    const fn = typeof nameOrFn === 'function' ? nameOrFn : maybeFn;
+    hooksRegistry.registerBeforeAll(name, fn, suiteId);
+}
+export function afterAll(nameOrFn, maybeFn) {
+    const suiteId = registry.getCurrentSuiteId();
+    if (!suiteId) {
+        throw new Error('afterAll must be called inside a describe() block');
+    }
+    const name = typeof nameOrFn === 'string' ? nameOrFn : undefined;
+    const fn = typeof nameOrFn === 'function' ? nameOrFn : maybeFn;
+    hooksRegistry.registerAfterAll(name, fn, suiteId);
+}
+/**
+ * Export hooks registry for runner
+ */
+export { hooksRegistry as hooks };
+//# sourceMappingURL=hooks.js.map

package/dist/api/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/api/hooks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAmDrC;;GAEG;AACH,MAAM,aAAa;IACT,oBAAoB,GAA2B,EAAE,CAAC;IAClD,mBAAmB,GAA0B,EAAE,CAAC;IAChD,mBAAmB,GAAuC,IAAI,GAAG,EAAE,CAAC;IACpE,kBAAkB,GAAsC,IAAI,GAAG,EAAE,CAAC;IAE1E;;;;;OAKG;IACH,kBAAkB,CAAC,IAAY,EAAE,EAAwB,EAAE,OAAgB;QACzE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAY,EAAE,EAAgB,EAAE,OAAgB;QAChE,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAwB,EAAE,EAAwB,EAAE,OAAe;QACnF,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACrE,CAAC;IAED;;;;;OAKG;IACH,gBAAgB,CAAC,IAAwB,EAAE,EAAgB,EAAE,OAAe;QAC1E,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAE,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACK,aAAa,CAAC,KAAiB;QACrC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,OAAO,OAAO,EAAE,CAAC;YACf,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;QAC3B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,qBAAqB,CAAC,WAA+B,EAAE,UAAoB;QACjF,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,UAAU,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CACpB,OAAoB,EACpB,KAA4B,EAC5B,gBAA6B;QAE7B,IAAI,gBAAgB,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE3C,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC9C,gEAAgE;YAChE,IACE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,EACrD,CAAC;gBACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC;gBAChD,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;oBACzC,gBAAgB,GAAG,EAAE,GAAG,gBAAgB,EAAE,GAAG,MAAM,EAAE,CAAC;gBACxD,CAAC;gBACD,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAC;IACzD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,OAAoB,EACpB,KAA4B,EAC5B,gBAA6B;QAE7B,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1D,0CAA0C;QAC1C,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC;YAC1C,IACE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;gBAChC,IAAI,CAAC,qBAAqB,CAAC,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,EACrD,CAAC;gBACD,MAAM,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CACnB,KAAgB,EAChB,mBAA4C,EAAE;QAE9C,MAAM,KAAK,GAAG,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAC3D,IAAI,OAAO,GAAG,EAAE,GAAG,gBAAgB,EAAiB,CAAC;QAErD,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;gBACzC,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,MAAM,EAAE,CAAC;YACtC,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAClB,KAAgB,EAChB,UAAmC,EAAE;QAErC,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC;QAE1D,0CAA0C;QAC1C,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACvB,MAAM,KAAK,CAAC,EAAE,CAAC,OAAsB,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,oBAAoB,GAAG,EAAE,CAAC;QAC/B,IAAI,CAAC,mBAAmB,GAAG,EAAE,CAAC;QAC9B,IAAI,CAAC,mBAAmB,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,kBAAkB,CAAC,KAAK,EAAE,CAAC;IAClC,CAAC;CACF;AAED,wBAAwB;AACxB,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,EAAwB;IAC/D,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC7C,aAAa,CAAC,kBAAkB,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,EAAgB;IACtD,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC7C,aAAa,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AA4BD,MAAM,UAAU,SAAS,CACvB,QAAuC,EACvC,OAA8B;IAE9B,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,EAAE,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAQ,CAAC;IAEhE,aAAa,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAWD,MAAM,UAAU,QAAQ,CACtB,QAA+B,EAC/B,OAAsB;IAEtB,MAAM,OAAO,GAAG,QAAQ,CAAC,iBAAiB,EAAE,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACjE,MAAM,EAAE,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAQ,CAAC;IAEhE,aAAa,CAAC,gBAAgB,CAAC,IAAI,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,OAAO,EAAE,aAAa,IAAI,KAAK,EAAE,CAAC"}

package/dist/api/steps.d.ts

@@ -0,0 +1,45 @@
+/**
+ * test.step with step reporting
+ * Provides named steps within tests for better organization
+ */
+/**
+ * Step 录制选项
+ */
+export interface StepRecordingOptions {
+    /** 步骤内命令的打字速度 (ms/字符) */
+    typingSpeed?: number;
+    /** 步骤结束后暂停时间 (ms) */
+    pauseAfter?: number;
+    /** 步骤开始前暂停时间 (ms) */
+    pauseBefore?: number;
+    /** 在录制中显示步骤标题作为注释 */
+    showStepTitle?: boolean;
+}
+/**
+ * 获取当前 step 的录制选项
+ */
+export declare function getCurrentStepOptions(): StepRecordingOptions | null;
+/**
+ * 获取当前 step 的名称
+ */
+export declare function getCurrentStepName(): string | null;
+/**
+ * 检查是否应该显示步骤标题（只显示一次）
+ */
+export declare function shouldShowStepTitle(): boolean;
+/**
+ * 标记步骤标题已显示
+ */
+export declare function markStepTitleShown(): void;
+/**
+ * Execute a named step within a test
+ * 支持两种调用方式：
+ * - step(name, fn)
+ * - step(name, options, fn)
+ */
+export declare function step<T>(name: string, optionsOrFn: StepRecordingOptions | (() => Promise<T>), maybeFn?: () => Promise<T>): Promise<T>;
+/**
+ * Clear steps (called after each test)
+ */
+export declare function clearSteps(): void;
+//# sourceMappingURL=steps.d.ts.map

package/dist/api/steps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.d.ts","sourceRoot":"","sources":["../../src/api/steps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yBAAyB;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,qBAAqB;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,qBAAqB;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAsBD;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,oBAAoB,GAAG,IAAI,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,GAAG,IAAI,CAElD;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAG7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC;AAED;;;;;GAKG;AACH,wBAAsB,IAAI,CAAC,CAAC,EAC1B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,oBAAoB,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EACtD,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACzB,OAAO,CAAC,CAAC,CAAC,CAuCZ;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAKjC"}

package/dist/api/steps.js

@@ -0,0 +1,106 @@
+/**
+ * test.step with step reporting
+ * Provides named steps within tests for better organization
+ */
+import { randomBytes } from 'crypto';
+/**
+ * Current step context (for tracking nested steps)
+ */
+let currentSteps = [];
+/**
+ * 当前 step 配置上下文
+ */
+let currentStepOptions = null;
+/**
+ * 当前 step 名称
+ */
+let currentStepName = null;
+/**
+ * 当前 step 标题是否已显示
+ */
+let stepTitleShown = false;
+/**
+ * 获取当前 step 的录制选项
+ */
+export function getCurrentStepOptions() {
+    return currentStepOptions;
+}
+/**
+ * 获取当前 step 的名称
+ */
+export function getCurrentStepName() {
+    return currentStepName;
+}
+/**
+ * 检查是否应该显示步骤标题（只显示一次）
+ */
+export function shouldShowStepTitle() {
+    if (stepTitleShown)
+        return false;
+    return currentStepOptions?.showStepTitle ?? false;
+}
+/**
+ * 标记步骤标题已显示
+ */
+export function markStepTitleShown() {
+    stepTitleShown = true;
+}
+/**
+ * Execute a named step within a test
+ * 支持两种调用方式：
+ * - step(name, fn)
+ * - step(name, options, fn)
+ */
+export async function step(name, optionsOrFn, maybeFn) {
+    const options = typeof optionsOrFn === 'function' ? {} : optionsOrFn;
+    const fn = typeof optionsOrFn === 'function' ? optionsOrFn : maybeFn;
+    const stepObj = {
+        id: generateId(),
+        type: 'step',
+        name,
+        payload: null,
+    };
+    // Add to current steps
+    currentSteps.push(stepObj);
+    // 保存之前的配置
+    const previousOptions = currentStepOptions;
+    const previousName = currentStepName;
+    // 设置当前 step 配置
+    currentStepOptions = options;
+    currentStepName = name;
+    stepTitleShown = false; // 重置标题显示状态
+    try {
+        // Execute the step function
+        const result = await fn();
+        return result;
+    }
+    catch (error) {
+        // Attach error info to step
+        stepObj.payload = {
+            error: error.message,
+            stack: error.stack,
+        };
+        throw error;
+    }
+    finally {
+        // 恢复之前的配置
+        currentStepOptions = previousOptions;
+        currentStepName = previousName;
+    }
+}
+/**
+ * Clear steps (called after each test)
+ */
+export function clearSteps() {
+    currentSteps = [];
+    currentStepOptions = null;
+    currentStepName = null;
+    stepTitleShown = false;
+}
+/**
+ * Generate a unique step ID
+ */
+function generateId() {
+    return randomBytes(8).toString('hex');
+}
+//# sourceMappingURL=steps.js.map

package/dist/api/steps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"steps.js","sourceRoot":"","sources":["../../src/api/steps.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAmBrC;;GAEG;AACH,IAAI,YAAY,GAAW,EAAE,CAAC;AAE9B;;GAEG;AACH,IAAI,kBAAkB,GAAgC,IAAI,CAAC;AAE3D;;GAEG;AACH,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C;;GAEG;AACH,IAAI,cAAc,GAAY,KAAK,CAAC;AAEpC;;GAEG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO,kBAAkB,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,IAAI,cAAc;QAAE,OAAO,KAAK,CAAC;IACjC,OAAO,kBAAkB,EAAE,aAAa,IAAI,KAAK,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB;IAChC,cAAc,GAAG,IAAI,CAAC;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,IAAY,EACZ,WAAsD,EACtD,OAA0B;IAE1B,MAAM,OAAO,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC;IACrE,MAAM,EAAE,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAQ,CAAC;IAEtE,MAAM,OAAO,GAAS;QACpB,EAAE,EAAE,UAAU,EAAE;QAChB,IAAI,EAAE,MAAM;QACZ,IAAI;QACJ,OAAO,EAAE,IAAI;KACd,CAAC;IAEF,uBAAuB;IACvB,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAE3B,UAAU;IACV,MAAM,eAAe,GAAG,kBAAkB,CAAC;IAC3C,MAAM,YAAY,GAAG,eAAe,CAAC;IAErC,eAAe;IACf,kBAAkB,GAAG,OAAO,CAAC;IAC7B,eAAe,GAAG,IAAI,CAAC;IACvB,cAAc,GAAG,KAAK,CAAC,CAAE,WAAW;IAEpC,IAAI,CAAC;QACH,4BAA4B;QAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,4BAA4B;QAC5B,OAAO,CAAC,OAAO,GAAG;YAChB,KAAK,EAAG,KAAe,CAAC,OAAO;YAC/B,KAAK,EAAG,KAAe,CAAC,KAAK;SAC9B,CAAC;QACF,MAAM,KAAK,CAAC;IACd,CAAC;YAAS,CAAC;QACT,UAAU;QACV,kBAAkB,GAAG,eAAe,CAAC;QACrC,eAAe,GAAG,YAAY,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,YAAY,GAAG,EAAE,CAAC;IAClB,kBAAkB,GAAG,IAAI,CAAC;IAC1B,eAAe,GAAG,IAAI,CAAC;IACvB,cAAc,GAAG,KAAK,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/api/test.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Playwright-style test() registration and suite registry
+ */
+import type { TestCase, TestFunction, TestSuite, TestOptions } from '../runner/models.js';
+/**
+ * Global registry of test suites and cases
+ */
+declare class TestRegistry {
+    private suites;
+    private fileSuites;
+    private suiteStack;
+    private defaultSuite;
+    constructor();
+    /**
+     * Get the current suite (top of stack)
+     */
+    private getCurrentSuite;
+    /**
+     * Get the current suite ID (for hooks registration)
+     */
+    getCurrentSuiteId(): string | undefined;
+    /** Set by loader when loading a file so dynamically imported test code uses this suite (same registry instance). */
+    __pendingFileSuite?: TestSuite;
+    /**
+     * Register a test case
+     */
+    registerTest(name: string, fn: TestFunction, options?: TestOptions): void;
+    /**
+     * Get all registered test suites
+     */
+    getSuites(): TestSuite[];
+    /**
+     * Get only root-level suites for execution
+     * This returns file-level suites if present, otherwise suites without parents
+     */
+    getRootSuites(): TestSuite[];
+    /**
+     * Get a specific suite by ID
+     */
+    getSuite(id: string): TestSuite | undefined;
+    /**
+     * Push a new suite onto the stack (for describe() blocks)
+     */
+    pushSuite(suite: TestSuite): void;
+    /**
+     * Pop the current suite from the stack (end of describe() block)
+     */
+    popSuite(): void;
+    /**
+     * Set the current suite (for describe() blocks) - legacy compatibility
+     */
+    setCurrentSuite(suite: TestSuite): void;
+    /**
+     * Set the current file and create/reuse a file-level suite.
+     * Uses full path as key so different files (e.g. same basename in different dirs) get separate suites.
+     * @returns the file suite (for loader to set pending global when loading dynamic files)
+     */
+    setCurrentFile(filePath: string): TestSuite;
+    /**
+     * Reset to default suite
+     */
+    resetCurrentSuite(): void;
+    /**
+     * Remove and return tests that were registered to the default suite.
+     * Used by the loader to reassign tests that landed on the default suite (e.g. due to
+     * async module evaluation) to the correct file-level suite.
+     */
+    takeTestsFromDefaultSuite(): TestCase[];
+    /**
+     * Clear all registered tests (for testing)
+     */
+    clear(): void;
+    /**
+     * Generate a unique test ID
+     */
+    private generateId;
+}
+export declare const registry: TestRegistry;
+/**
+ * Playwright-style test() function
+ * Registers a test case with the current suite
+ *
+ * @example
+ * // 普通测试
+ * test('name', async ({ terminal }) => { ... });
+ *
+ * // 录制测试
+ * test('name', { record: true }, async ({ terminal }) => { ... });
+ */
+export declare function test(name: string, fn: TestFunction): void;
+export declare function test(name: string, options: TestOptions, fn: TestFunction): void;
+/**
+ * Get all registered tests
+ */
+export declare function getTests(): TestSuite[];
+/**
+ * Clear all registered tests
+ */
+export declare function clearTests(): void;
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/api/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/api/test.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG1F;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAqC;IACnD,OAAO,CAAC,UAAU,CAAqC;IACvD,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,YAAY,CAAY;;IAehC;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;IACH,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAMvC,oHAAoH;IACpH,kBAAkB,CAAC,EAAE,SAAS,CAAC;IAE/B;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,IAAI;IAczE;;OAEG;IACH,SAAS,IAAI,SAAS,EAAE;IASxB;;;OAGG;IACH,aAAa,IAAI,SAAS,EAAE;IAe5B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAmBjC;;OAEG;IACH,QAAQ,IAAI,IAAI;IAMhB;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAIvC;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS;IAuB3C;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;;;OAIG;IACH,yBAAyB,IAAI,QAAQ,EAAE;IAMvC;;OAEG;IACH,KAAK,IAAI,IAAI;IAcb;;OAEG;IACH,OAAO,CAAC,UAAU;CAGnB;AAUD,eAAO,MAAM,QAAQ,EAAE,YAAoD,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;AAC3D,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,YAAY,GAAG,IAAI,CAAC;AAYjF;;GAEG;AACH,wBAAgB,QAAQ,IAAI,SAAS,EAAE,CAEtC;AAED;;GAEG;AACH,wBAAgB,UAAU,IAAI,IAAI,CAEjC"}