fix prerelease

Author: fi3ework

packages/browser-react/AGENTS.md

@@ -2,11 +2,20 @@
 
 React component testing support for Rstest browser mode. Provides `render`, `renderHook`, `cleanup`, and `act` utilities for testing React components in a real browser environment.
 
-## Module structure
+## Do
 
-- `src/index.ts` — Default entry with auto-cleanup via `beforeEach`
-- `src/pure.tsx` — Pure exports without auto-cleanup (for manual control)
-- `src/act.ts` — React `act()` wrapper with `IS_REACT_ACT_ENVIRONMENT` management
+- Support React 17, 18, and 19 — ensure code works across all versions
+- Use `act()` for all render/unmount/state update operations
+- Keep this package focused on React rendering lifecycle only
+- Use JSDoc comments for public API functions
+- Default to small, focused diffs
+
+## Don't
+
+- Don't add DOM query utilities (users should use `@testing-library/dom`)
+- Don't add dependencies beyond React peer deps
+- Don't break compatibility with older React versions without discussion
+- Don't use React version-specific APIs without fallbacks
 
 ## Commands
 
@@ -15,19 +24,58 @@ React component testing support for Rstest browser mode. Provides `render`, `ren
 pnpm --filter @rstest/browser-react build
 pnpm --filter @rstest/browser-react dev     # Watch mode
 
-# Typecheck
-pnpm --filter @rstest/browser-react typecheck
+# Type check single file
+pnpm tsc --noEmit src/pure.tsx
+
+# Format single file
+pnpm prettier --write src/pure.tsx
 
 # Run tests
 pnpm --filter @rstest/browser-react test
 ```
 
+Note: Prefer file-scoped commands for faster feedback during development.
+
+## Project structure
+
+- `src/index.ts` — Default entry with auto-cleanup via `beforeEach`
+- `src/pure.tsx` — Core implementation (render, renderHook, cleanup, configure)
+- `src/act.ts` — React `act()` wrapper with `IS_REACT_ACT_ENVIRONMENT` management
+
+## Good and bad examples
+
+### Handling React version differences
+
+Good — use feature detection with fallback:
+
+```typescript
+// src/act.ts
+const _act = (React as Record<string, unknown>).act as
+  | ((callback: () => unknown) => Promise<void>)
+  | undefined;
+
+export const act: ActFunction =
+  typeof _act !== 'function'
+    ? async (callback) => {
+        await callback();
+      } // React 17 fallback
+    : async (callback) => {
+        await _act(callback);
+      }; // React 18+
+```
+
+Bad — assume specific React version:
+
+```typescript
+import { act } from 'react'; // Breaks React 17
+```
+
 ## Exports
 
 ### Default entry (`@rstest/browser-react`)
 
-- `render` — Render a React component
-- `renderHook` — Test React hooks
+- `render` — Render a React component, returns `RenderResult`
+- `renderHook` — Test React hooks, returns `RenderHookResult`
 - `cleanup` — Cleanup mounted components
 - `act` — Wrap state updates
 
@@ -39,36 +87,28 @@ Same exports plus:
 
 - `configure` — Configure render behavior (e.g., `reactStrictMode`)
 
-No auto-cleanup, user must call `cleanup()` manually.
+No auto-cleanup — user must call `cleanup()` manually.
 
-## Usage with @testing-library/dom
-
-This package provides React rendering utilities. For DOM queries (`getByRole`, `getByText`, etc.), users can optionally install `@testing-library/dom`:
+## Key types
 
 ```typescript
-import { render } from '@rstest/browser-react'
-import { screen } from '@testing-library/dom'
-
-test('example', async () => {
-  await render(<Button>Click me</Button>)
-  expect(screen.getByRole('button')).toBeTruthy()
-})
+interface RenderResult {
+  container: HTMLElement;
+  baseElement: HTMLElement;
+  unmount: () => Promise<void>;
+  rerender: (ui: ReactNode) => Promise<void>;
+  asFragment: () => DocumentFragment;
+}
+
+interface RenderOptions {
+  container?: HTMLElement;
+  baseElement?: HTMLElement;
+  wrapper?: JSXElementConstructor<{ children: ReactNode }>;
+}
 ```
 
-## Do
-
-- Keep this package focused on React rendering lifecycle
-- Use `act()` for all render/unmount operations
-- Support React 17, 18, and 19
-
-## Don't
-
-- Don't add DOM query utilities (users can use @testing-library/dom)
-- Don't add dependencies beyond React peer deps
-- Don't break compatibility with older React versions without discussion
-
-## Key files
+## When stuck
 
-- `src/pure.tsx` — Core implementation
-- `src/act.ts` — React act wrapper
-- `src/index.ts` — Auto-cleanup entry
+- Ask clarifying questions or propose a plan
+- Check React version compatibility before making changes
+- Reference `@testing-library/react` for API design inspiration

packages/browser-react/README.md

@@ -0,0 +1,166 @@
+# @rstest/browser-react
+
+React component testing support for [Rstest](https://rstest.dev) browser mode.
+
+## Installation
+
+```bash
+npm install @rstest/browser-react
+# or
+pnpm add @rstest/browser-react
+```
+
+## Usage
+
+### Basic component testing
+
+```tsx
+import { render, cleanup } from '@rstest/browser-react';
+import { screen } from '@testing-library/dom';
+import { expect, test } from '@rstest/core';
+
+test('renders button', async () => {
+  await render(<button>Click me</button>);
+  expect(screen.getByRole('button')).toBeTruthy();
+});
+```
+
+### Testing with wrapper (providers/context)
+
+```tsx
+import { render } from '@rstest/browser-react';
+
+const Wrapper = ({ children }) => (
+  <ThemeProvider theme="dark">{children}</ThemeProvider>
+);
+
+test('renders with theme', async () => {
+  await render(<MyComponent />, { wrapper: Wrapper });
+});
+```
+
+### Testing hooks
+
+```tsx
+import { renderHook } from '@rstest/browser-react';
+import { useState } from 'react';
+
+test('useState hook', async () => {
+  const { result, rerender } = await renderHook(() => useState(0));
+
+  expect(result.current[0]).toBe(0);
+
+  await result.current[1](1);
+  await rerender();
+
+  expect(result.current[0]).toBe(1);
+});
+```
+
+### Manual cleanup with pure entry
+
+```tsx
+import { render, cleanup } from '@rstest/browser-react/pure';
+import { afterEach } from '@rstest/core';
+
+// No auto-cleanup, manage it yourself
+afterEach(async () => {
+  await cleanup();
+});
+```
+
+### Enabling React strict mode
+
+```tsx
+import { configure } from '@rstest/browser-react/pure';
+
+configure({ reactStrictMode: true });
+```
+
+## API
+
+### `render(ui, options?)`
+
+Renders a React element into the DOM.
+
+**Returns:** `Promise<RenderResult>`
+
+```typescript
+interface RenderResult {
+  container: HTMLElement;
+  baseElement: HTMLElement;
+  unmount: () => Promise<void>;
+  rerender: (ui: ReactNode) => Promise<void>;
+  asFragment: () => DocumentFragment;
+}
+
+interface RenderOptions {
+  container?: HTMLElement;
+  baseElement?: HTMLElement;
+  wrapper?: JSXElementConstructor<{ children: ReactNode }>;
+}
+```
+
+### `renderHook(callback, options?)`
+
+Renders a custom React hook for testing.
+
+**Returns:** `Promise<RenderHookResult>`
+
+```typescript
+interface RenderHookResult<Result, Props> {
+  result: { current: Result };
+  rerender: (props?: Props) => Promise<void>;
+  unmount: () => Promise<void>;
+  act: (callback: () => unknown) => Promise<void>;
+}
+```
+
+### `cleanup()`
+
+Unmounts all mounted components. Called automatically before each test when using the default entry.
+
+### `act(callback)`
+
+Wraps a callback in React's `act()` for proper state updates.
+
+### `configure(options)` (pure entry only)
+
+Configure render behavior.
+
+```typescript
+interface RenderConfiguration {
+  reactStrictMode: boolean;
+}
+```
+
+## Using with @testing-library/dom
+
+This package provides React rendering utilities. For DOM queries (`getByRole`, `getByText`, etc.), install `@testing-library/dom`:
+
+```bash
+npm install @testing-library/dom
+```
+
+```tsx
+import { render } from '@rstest/browser-react';
+import { screen, fireEvent } from '@testing-library/dom';
+
+test('button click', async () => {
+  await render(<Counter />);
+
+  const button = screen.getByRole('button');
+  fireEvent.click(button);
+
+  expect(screen.getByText('1')).toBeTruthy();
+});
+```
+
+## Compatibility
+
+- React 17, 18, and 19
+- Node.js >= 18.12.0
+
+## License
+
+MIT

packages/browser/package.json

@@ -40,13 +40,14 @@
     "dev": "rslib build --watch"
   },
   "dependencies": {
-    "@rsbuild/core": "1.7.1",
+    "@jridgewell/trace-mapping": "0.3.31",
+    "convert-source-map": "^2.0.0",
     "open-editor": "^4.0.0",
+    "pathe": "^2.0.3",
     "sirv": "^2.0.4",
     "ws": "^8.18.3"
   },
   "devDependencies": {
-    "@jridgewell/trace-mapping": "0.3.31",
     "@rslib/core": "^0.19.0",
     "@rstest/browser-ui": "workspace:*",
     "@rstest/core": "workspace:*",
@@ -56,8 +57,6 @@
     "@types/ws": "^8.18.1",
     "@vitest/snapshot": "^3.2.4",
     "birpc": "2.9.0",
-    "convert-source-map": "^2.0.0",
-    "pathe": "^2.0.3",
     "picocolors": "^1.1.1",
     "picomatch": "^4.0.3",
     "playwright": "^1.49.1"