Release/v2.1.0

[jEnbuska]

A collection of build pipeline, type distribution, integration testing, and release tooling improvements.

Bundle size −57% (55 KB → 23 KB)

• minify: true in tsup.config.ts
• Replaced using keyword with try/finally in resolver classes — eliminates the __knownSymbol/__using/__callDispose polyfill block tsup was injecting for ES2022 targets

Consumer TypeScript types fixed

tsc --emitDeclarationOnly + verbatimModuleSyntax: true preserved raw .ts extensions in emitted .d.ts import paths, breaking any consumer without allowImportingTsExtensions. Switched to tsup dts: true — all declarations bundled into a single dist/index.d.ts. tsconfig.build.json deleted.

Node.js minimum lowered to 20.4.0

Removing using eliminates the 20.5.0 requirement. Only hard runtime dependency is Symbol.dispose/Symbol.asyncDispose (Node 20.4.0+). Added "engines": { "node": ">=20.4.0" }.

Example projects & cross-browser tests

• examples/node-ts — bare Node.js TypeScript consumer; builds with tsc against the local package
• examples/react-vite — Vite 7 + React 19 app with a Playwright test suite covering Chromium, Firefox, WebKit (Safari ✅), and Edge
• npm test in examples/react-vite auto-installs Playwright browser binaries so it works out of the box after npm ci

CI

• test-example-node: matrix over Node 20 × 22 × 24, fail-fast: false
• test-example-react: Playwright suite; uploads report artifact on failure
• Root tsconfig.json excludes examples/ — prevents tsc --noEmit walking sub-projects whose deps aren't installed at root
• Root vitest.config.ts scopes test discovery to tests/**/*.test.ts — prevents Vitest picking up Playwright spec files
• prettier and check-all extended to cover ./examples

Release tooling & docs

• publish:beta script (npm publish --tag beta --access public) + abstract "Beta / Pre-release Process" section in CONTRIBUTING.md
• DOM.Iterable is not required by this library — documented with a minimal lib config table
• README: Safari ✅, Node LTS table (20/22/24), zero-dependencies badge
• CHANGELOG entry for 2.1.0

---

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.