feat: expose TestContext for hook usage (#9)

Author: AriPerkkio

.github/workflows/ci.yml

@@ -54,7 +54,6 @@ jobs:
 
   publish-preview:
     runs-on: ubuntu-latest
-    if: ${{ false }} # TODO: Set up preview deployments
 
     steps:
       - uses: actions/checkout@v4
@@ -70,4 +69,4 @@ jobs:
         run: |
           pnpm install
           pnpm build
-          npx pkg-pr-new publish
+          npx pkg-pr-new publish --compact

README.md

@@ -63,6 +63,18 @@ test("run development server inside webcontainer", async ({
 });
 ```
 
+To use test hooks, you can import fixture typings:
+
+```ts
+import { test, type TestContext } from "@webcontainer/test";
+import { beforeEach } from "vitest";
+
+// Mount project before each test
+beforeEach<TextContext>(({ webcontainer }) => {
+  await webcontainer.mount("projects/example");
+});
+```
+
 #### `preview`
 
 ##### `getByRole`

src/fixtures/index.ts

@@ -3,6 +3,11 @@ import { test as base } from "vitest";
 import { Preview } from "./preview";
 import { WebContainer } from "./webcontainer";
 
+export interface TestContext {
+  preview: Preview;
+  webcontainer: WebContainer;
+}
+
 /**
  * Pre-defined [`test()` function](https://vitest.dev/guide/test-context.html#extend-test-context) with WebContainer fixtures.
  *
@@ -24,10 +29,7 @@ import { WebContainer } from "./webcontainer";
  * });
  * ```
  */
-export const test = base.extend<{
-  preview: Preview;
-  webcontainer: WebContainer;
-}>({
+export const test = base.extend<TestContext>({
   preview: async ({ webcontainer }, use) => {
     await webcontainer.wait();
 

src/index.ts

@@ -1 +1 @@
-export { test } from "./fixtures";
+export { test, type TestContext } from "./fixtures";

test/hooks.test.ts

@@ -0,0 +1,16 @@
+import { afterEach, beforeEach, expect } from "vitest";
+import { test, type TestContext } from "../src";
+
+beforeEach<TestContext>(({ preview, webcontainer }) => {
+  expect(preview.getByRole).toBeTypeOf("function");
+  expect(webcontainer.mount).toBeTypeOf("function");
+});
+
+afterEach<TestContext>(({ preview, webcontainer }) => {
+  expect(preview.getByRole).toBeTypeOf("function");
+  expect(webcontainer.mount).toBeTypeOf("function");
+});
+
+test("fixtures are available in hooks", () => {
+  // no-op
+});