···3535- **Core directory test**: `CI=true pnpm test <test-file>` (for `test/core`)
3636- **Browser tests**: `CI=true pnpm test:browser:playwright` or `CI=true pnpm test:browser:webdriverio`
37373838+**IMPORTANT: Do NOT use `--` when passing test filters to pnpm.**
3939+Using `--` causes pnpm to drop the filter, resulting in a full test run instead of a filtered one.
4040+4141+```bash
4242+# WRONG - runs ALL tests (filter is ignored):
4343+pnpm test -- basic.test.ts -t 'expect'
4444+4545+# CORRECT - runs only matching tests:
4646+pnpm test basic.test.ts -t 'expect'
4747+```
4848+3849When writing tests, AVOID using `toContain` for validation. Prefer using `toMatchInlineSnapshot` to include the test error and its stack. If snapshot is failing, update the snapshot instead of reverting it to `toContain`.
39504051If you need to typecheck tests, run `pnpm typecheck` from the root of the workspace.