repterm 0.1.0

package/dist/api/describe.d.ts

@@ -0,0 +1,18 @@
+/**
+ * test.describe suite grouping
+ * Provides nested test organization
+ */
+import type { DescribeOptions } from '../runner/models.js';
+/**
+ * Create a test suite with grouped tests
+ *
+ * @example
+ * // 普通测试套件
+ * describe('suite name', () => { ... });
+ *
+ * // 录制测试套件
+ * describe('suite name', { record: true }, () => { ... });
+ */
+export declare function describe(name: string, fn: () => void): void;
+export declare function describe(name: string, options: DescribeOptions, fn: () => void): void;
+//# sourceMappingURL=describe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"describe.d.ts","sourceRoot":"","sources":["../../src/api/describe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAa,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItE;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;AAC7D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC"}

package/dist/api/describe.js

@@ -0,0 +1,33 @@
+/**
+ * test.describe suite grouping
+ * Provides nested test organization
+ */
+import { registry } from './test.js';
+import { randomBytes } from 'crypto';
+export function describe(name, optionsOrFn, maybeFn) {
+    const options = typeof optionsOrFn === 'function' ? undefined : optionsOrFn;
+    const fn = typeof optionsOrFn === 'function' ? optionsOrFn : maybeFn;
+    // Create a new suite
+    const suite = {
+        id: generateId(),
+        name,
+        tests: [],
+        suites: [],
+        config: {},
+        options,
+    };
+    // Set this as the current suite
+    registry.setCurrentSuite(suite);
+    // Execute the suite definition function
+    // This will register tests to this suite
+    fn();
+    // Reset to default suite
+    registry.resetCurrentSuite();
+}
+/**
+ * Generate a unique ID
+ */
+function generateId() {
+    return randomBytes(8).toString('hex');
+}
+//# sourceMappingURL=describe.js.map

package/dist/api/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/api/describe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAcrC,MAAM,UAAU,QAAQ,CACtB,IAAY,EACZ,WAA2C,EAC3C,OAAoB;IAEpB,MAAM,OAAO,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IAC5E,MAAM,EAAE,GAAG,OAAO,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAQ,CAAC;IAEtE,qBAAqB;IACrB,MAAM,KAAK,GAAc;QACvB,EAAE,EAAE,UAAU,EAAE;QAChB,IAAI;QACJ,KAAK,EAAE,EAAE;QACT,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,OAAO;KACR,CAAC;IAEF,gCAAgC;IAChC,QAAQ,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAEhC,wCAAwC;IACxC,yCAAyC;IACzC,EAAE,EAAE,CAAC;IAEL,yBAAyB;IACzB,QAAQ,CAAC,iBAAiB,EAAE,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAS,UAAU;IACjB,OAAO,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACxC,CAAC"}

package/dist/api/expect.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Expect API based on bun:test
+ *
+ * Extends bun:test's expect with domain-specific matchers for
+ * terminal output and command results. Plugins can register
+ * additional matchers via expect.extend().
+ */
+import { expect } from 'bun:test';
+export type { MatcherResult } from '@repterm/plugin-api';
+/**
+ * Assertion error with expected/actual values
+ */
+export declare class AssertionError extends Error {
+    expected: unknown;
+    actual: unknown;
+    constructor(message: string, expected: unknown, actual: unknown);
+}
+declare module 'bun:test' {
+    interface Matchers<T> {
+        /** Assert that terminal contains text */
+        toContainText(expected: string): Promise<void>;
+        /** Assert that terminal output matches regex */
+        toMatchPattern(pattern: RegExp): Promise<void>;
+        /** Assert command succeeded (exit code === 0) */
+        toSucceed(): Matchers<T>;
+        /** Assert command failed (exit code !== 0) */
+        toFail(): Matchers<T>;
+        /** Assert exit code equals expected value */
+        toHaveExitCode(expected: number): Matchers<T>;
+        /** Assert stdout contains expected text */
+        toHaveStdout(expected: string): Matchers<T>;
+        /** Assert stderr contains expected text */
+        toHaveStderr(expected: string): Matchers<T>;
+        /** Assert stdout matches regex pattern */
+        toMatchStdout(pattern: RegExp): Matchers<T>;
+        /** Assert stderr matches regex pattern */
+        toMatchStderr(pattern: RegExp): Matchers<T>;
+        /** Assert combined output contains text */
+        toContainInOutput(expected: string): Matchers<T>;
+    }
+}
+export { expect };
+//# sourceMappingURL=expect.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/api/expect.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAIlC,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,OAAO;CAOlB;AAqKD,OAAO,QAAQ,UAAU,CAAC;IACxB,UAAU,QAAQ,CAAC,CAAC;QAClB,yCAAyC;QACzC,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,gDAAgD;QAChD,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/C,iDAAiD;QACjD,SAAS,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;QACzB,8CAA8C;QAC9C,MAAM,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;QACtB,6CAA6C;QAC7C,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC9C,2CAA2C;QAC3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5C,2CAA2C;QAC3C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5C,0CAA0C;QAC1C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5C,0CAA0C;QAC1C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC5C,2CAA2C;QAC3C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;KAClD;CACF;AAID,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/api/expect.js

@@ -0,0 +1,167 @@
+/**
+ * Expect API based on bun:test
+ *
+ * Extends bun:test's expect with domain-specific matchers for
+ * terminal output and command results. Plugins can register
+ * additional matchers via expect.extend().
+ */
+import { expect } from 'bun:test';
+/**
+ * Assertion error with expected/actual values
+ */
+export class AssertionError extends Error {
+    expected;
+    actual;
+    constructor(message, expected, actual) {
+        super(message);
+        this.name = 'AssertionError';
+        this.expected = expected;
+        this.actual = actual;
+    }
+}
+// ===== Type Guards =====
+function isTerminalAPI(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'run' in value &&
+        'snapshot' in value &&
+        typeof value.run === 'function');
+}
+function isCommandResult(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'code' in value &&
+        'stdout' in value &&
+        'stderr' in value &&
+        'output' in value);
+}
+// ===== Register repterm matchers =====
+expect.extend({
+    // Terminal matchers
+    async toContainText(received, expected) {
+        if (!isTerminalAPI(received)) {
+            return { pass: false, message: () => 'Expected a TerminalAPI instance' };
+        }
+        const snapshot = await received.snapshot();
+        const pass = snapshot.includes(expected);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected terminal NOT to contain "${expected}"`
+                : `Expected terminal to contain "${expected}"`,
+        };
+    },
+    async toMatchPattern(received, pattern) {
+        if (!isTerminalAPI(received)) {
+            return { pass: false, message: () => 'Expected a TerminalAPI instance' };
+        }
+        const snapshot = await received.snapshot();
+        const pass = pattern.test(snapshot);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected terminal NOT to match ${pattern}`
+                : `Expected terminal to match ${pattern}`,
+        };
+    },
+    // CommandResult matchers
+    toSucceed(received) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.code === 0;
+        return {
+            pass,
+            message: () => pass
+                ? 'Expected command NOT to succeed'
+                : `Expected command to succeed, got exit code ${received.code}`,
+        };
+    },
+    toFail(received) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.code !== 0;
+        return {
+            pass,
+            message: () => pass
+                ? 'Expected command NOT to fail'
+                : 'Expected command to fail, but it succeeded',
+        };
+    },
+    toHaveExitCode(received, expected) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.code === expected;
+        return {
+            pass,
+            message: () => pass
+                ? `Expected exit code NOT to be ${expected}`
+                : `Expected exit code ${expected}, got ${received.code}`,
+        };
+    },
+    toHaveStdout(received, expected) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.stdout.includes(expected);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected stdout NOT to contain "${expected}"`
+                : `Expected stdout to contain "${expected}"`,
+        };
+    },
+    toHaveStderr(received, expected) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.stderr.includes(expected);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected stderr NOT to contain "${expected}"`
+                : `Expected stderr to contain "${expected}"`,
+        };
+    },
+    toMatchStdout(received, pattern) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = pattern.test(received.stdout);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected stdout NOT to match ${pattern}`
+                : `Expected stdout to match ${pattern}`,
+        };
+    },
+    toMatchStderr(received, pattern) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = pattern.test(received.stderr);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected stderr NOT to match ${pattern}`
+                : `Expected stderr to match ${pattern}`,
+        };
+    },
+    toContainInOutput(received, expected) {
+        if (!isCommandResult(received)) {
+            return { pass: false, message: () => 'Expected a CommandResult' };
+        }
+        const pass = received.output.includes(expected);
+        return {
+            pass,
+            message: () => pass
+                ? `Expected output NOT to contain "${expected}"`
+                : `Expected output to contain "${expected}"`,
+        };
+    },
+});
+// ===== Re-export =====
+export { expect };
+//# sourceMappingURL=expect.js.map

package/dist/api/expect.js.map

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

package/dist/api/hooks.d.ts

@@ -0,0 +1,178 @@
+/**
+ * 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 type { TestContext, TestSuite } from '../runner/models.js';
+/**
+ * 基础 Hook 函数类型
+ */
+export type HookFunction = (context: TestContext) => Promise<void> | void;
+/**
+ * 增强的 Hook 函数类型，支持返回值注入
+ * 返回的对象会被合并到后续的 context 中
+ */
+export type EnhancedHookFunction = (context: TestContext) => Promise<Record<string, unknown> | void> | Record<string, unknown> | void;
+/**
+ * Global hooks storage with named fixture support
+ */
+declare class HooksRegistry {
+    private namedBeforeEachHooks;
+    private namedAfterEachHooks;
+    private suiteBeforeAllHooks;
+    private suiteAfterAllHooks;
+    /**
+     * 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: string, fn: EnhancedHookFunction, suiteId?: string): void;
+    /**
+     * 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: string, fn: HookFunction, suiteId?: string): void;
+    /**
+     * 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: string | undefined, fn: EnhancedHookFunction, suiteId: string): void;
+    /**
+     * 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: string | undefined, fn: HookFunction, suiteId: string): void;
+    /**
+     * Get the chain of suite IDs from root to the given suite
+     */
+    private getSuiteChain;
+    /**
+     * Check if a hook should run for a given suite
+     */
+    private shouldRunHookForSuite;
+    /**
+     * 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
+     */
+    runBeforeEachFor(context: TestContext, suite: TestSuite | undefined, requiredFixtures: Set<string>): Promise<{
+        context: TestContext;
+        executedFixtures: Set<string>;
+    }>;
+    /**
+     * 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
+     */
+    runAfterEachFor(context: TestContext, suite: TestSuite | undefined, executedFixtures: Set<string>): Promise<void>;
+    /**
+     * 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
+     */
+    runBeforeAllFor(suite: TestSuite, inheritedContext?: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Run afterAll hooks for a suite
+     * @param suite The suite to run hooks for
+     * @param context Context to pass to hooks
+     */
+    runAfterAllFor(suite: TestSuite, context?: Record<string, unknown>): Promise<void>;
+    /**
+     * Clear all hooks (for testing)
+     */
+    clear(): void;
+}
+export declare const hooksRegistry: 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 declare function beforeEach(name: string, fn: EnhancedHookFunction): void;
+/**
+ * Register a named afterEach hook
+ *
+ * 只有对应的 beforeEach 被执行了，此 Hook 才会执行。
+ *
+ * @param name Fixture 名称（与 beforeEach 注册的名称一致）
+ * @param fn Hook 函数
+ */
+export declare function afterEach(name: string, fn: HookFunction): void;
+/**
+ * Register a beforeAll hook for the current suite
+ *
+ * 在 Suite 中所有测试执行前只运行一次。
+ * 返回的对象会被合并到 Context，传递给所有测试。
+ *
+ * @param fn Hook 函数，返回对象会被注入到 context
+ *
+ * @example
+ * describe('admin tests', () => {
+ *   beforeAll(async () => {
+ *     const adminUser = await createAdminUser();
+ *     return { adminUser };
+ *   });
+ *
+ *   afterAll(async ({ adminUser }) => {
+ *     await deleteUser(adminUser);
+ *   });
+ *
+ *   test('admin can see dashboard', async ({ terminal, adminUser }) => {
+ *     // adminUser is available from beforeAll
+ *   });
+ * });
+ */
+export declare function beforeAll(fn: EnhancedHookFunction): void;
+export declare function beforeAll(name: string, fn: EnhancedHookFunction): void;
+/**
+ * Register an afterAll hook for the current suite
+ *
+ * 在 Suite 中所有测试执行后只运行一次。
+ *
+ * @param fn Hook 函数
+ */
+export declare function afterAll(fn: HookFunction): void;
+export declare function afterAll(name: string, fn: HookFunction): void;
+/**
+ * Export hooks registry for runner
+ */
+export { hooksRegistry as hooks };
+//# sourceMappingURL=hooks.d.ts.map

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

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