feat(runtime): add test context hooks (#125)

## Summary
- add a minimal runtime test context with `task` metadata for tests and
per-test hooks
- support Vitest-style `ctx.skip()`, `ctx.onTestFinished()`, and
`ctx.onTestFailed()` with behavior covered by runner tests
- stabilize the runtime test environment by removing a redundant URL
polyfill import in `getWSServer` and simplifying the symbolicate mock
used by runner-context tests

## Testing
- pnpm nx lint runtime
- pnpm nx typecheck runtime
- pnpm nx test runtime

Author: V3RON

.nx/version-plans/version-plan-1779259133000.md

@@ -0,0 +1,5 @@
+---
+__default__: patch
+---
+
+Harness test callbacks now consistently receive a `HarnessTestContext` in `test`, `it`, `beforeEach`, and `afterEach`, exposing task metadata, dynamic skipping with `context.skip(...)`, and per-test `onTestFinished` / `onTestFailed` lifecycle hooks.

apps/playground/rn-harness.config.mjs

@@ -79,7 +79,7 @@ export default {
     }),
     applePlatform({
       name: 'ios',
-      device: appleSimulator('iPhone 17 Pro', '26.2'),
+      device: appleSimulator('iPhone 17 Pro', '26.4'),
       bundleId: 'com.harnessplayground',
     }),
     applePlatform({

apps/playground/src/__tests__/smoke.harness.ts

@@ -4,4 +4,17 @@ describe('Smoke test', () => {
   test('should run a simple test', () => {
     expect(1 + 1).toBe(2);
   });
+
+  test('should expose task context to tests', (context) => {
+    expect(context).toBeDefined();
+    expect(context.task.type).toBe('test');
+    expect(context.task.mode).toBe('run');
+    expect(context.task.file.name).toBe('src/__tests__/smoke.harness.ts');
+    expect(context.task.suite.name).toBe('Smoke test');
+    expect(context.task.name).toBe('should expose task context to tests');
+  });
+
+  test('should report dynamic skips as skipped', (context) => {
+    context.skip('skip from test context');
+  });
 });

packages/bridge/src/shared.ts

@@ -81,7 +81,13 @@ export type {
   TestSuite,
   TestCase,
   CollectionResult,
+  TestFn,
+  SuiteHookFn,
 } from './shared/test-collector.js';
+export type {
+  HarnessTaskContext,
+  HarnessTestContext,
+} from './shared/test-context.js';
 export type {
   TestRunnerEvents,
   TestRunnerFileStartedEvent,

packages/bridge/src/shared/test-collector.ts

@@ -1,6 +1,10 @@
+import type { HarnessTestContext } from './test-context.js';
+
 export type TestStatus = 'active' | 'skipped' | 'todo';
 
-export type TestFn = () => void | Promise<void>;
+export type TestFn = (context: HarnessTestContext) => void | Promise<void>;
+
+export type SuiteHookFn = () => void | Promise<void>;
 
 export type TestCase = {
   name: string;
@@ -13,8 +17,8 @@ export type TestSuite = {
   tests: TestCase[];
   suites: TestSuite[];
   parent?: TestSuite;
-  beforeAll: TestFn[];
-  afterAll: TestFn[];
+  beforeAll: SuiteHookFn[];
+  afterAll: SuiteHookFn[];
   beforeEach: TestFn[];
   afterEach: TestFn[];
   status?: TestStatus;

packages/bridge/src/shared/test-context.ts

@@ -0,0 +1,21 @@
+export type HarnessTaskContext = {
+  name: string;
+  type: 'test';
+  mode: 'run' | 'skip' | 'todo';
+  file: {
+    name: string;
+  };
+  suite: {
+    name: string;
+  };
+};
+
+export type HarnessTestContext = {
+  task: HarnessTaskContext;
+  onTestFailed: (fn: () => void | Promise<void>) => void;
+  onTestFinished: (fn: () => void | Promise<void>) => void;
+  skip: {
+    (note?: string): never;
+    (condition: boolean, note?: string): void;
+  };
+};

packages/coverage-ios/tsconfig.json

@@ -3,6 +3,9 @@
   "files": [],
   "include": [],
   "references": [
+    {
+      "path": "../config"
+    },
     {
       "path": "./tsconfig.lib.json"
     }

packages/coverage-ios/tsconfig.lib.json

@@ -10,5 +10,10 @@
     "types": ["node"],
     "lib": ["DOM", "ES2022"]
   },
-  "include": ["src/**/*.ts"]
+  "include": ["src/**/*.ts"],
+  "references": [
+    {
+      "path": "../config/tsconfig.lib.json"
+    }
+  ]
 }