@noego/wood 0.1.3 → 0.2.0

package/README.md

@@ -111,6 +111,41 @@ npm test
 
 Publishing runs the same checks through `prepublishOnly`.
 
+## Testing
+
+Wood publishes browser-testing helpers from `@noego/wood/testing`.
+
+```ts
+import { browser } from '@noego/wood/testing';
+
+const harness = await browser.createHarness({
+  rootDir: process.cwd(),
+  componentDir: 'ui',
+  css: ['ui/app.css'],
+  bridge: {
+    operations: {
+      'settings.get': () => ({ readSpeed: 0 }),
+    },
+  },
+});
+
+const mounted = await harness.mountComponent('ui/components/StatusPanel.svelte');
+await mounted.expect.visible('[data-testid="status-panel"]');
+
+await harness.destroy();
+```
+
+The browser harness starts Vite with the Svelte plugin, launches Playwright,
+installs a controlled Wood bridge fixture, and can mount individual Svelte
+components, layered Wood trees, or Wood routes from a views config.
+
+Use it for renderer behavior that needs real CSS, browser layout, animation
+frames, z-index, clipping, or route/controller wiring without booting Electron.
+Keep pure service and state tests in Node.
+
+See [Browser Testing](./docs/browser-testing.md) for the full API shape and
+boundary notes.
+
 ## Publishing
 
 Publishing is handled by the `Publish` GitHub Actions workflow.