ci: add release quality gates to prevent issue #419 class of misses

[iamdarshshah]

Summary

Adds CI/release infrastructure to catch the class of issues reported in #419 (overly-narrow peerDependencies blocking React 18/19) and other gaps identified by auditing Zustand, react-hook-form, TanStack Query, and Radix UI.

• Peer dep assertion in test suite: package.test.ts asserts peerDependencies.react uses >= not ^. Runs on every yarn test. Would have caught Support React 19 #419 before release.
• React version matrix: test-react-versions.yml runs tests against React 17 and 18 on every push/PR. React 19 is excluded until the pull-to-refresh setState/act() compatibility issue is resolved.
• Publish gate: publish.yml has a validate job (React 17 and 18) that must fully pass before publish runs. needs: validate blocks npm publish on any failure.
• Build artifact smoke tests: test-build-artifacts.yml verifies CJS require(), ESM exports, and dist/index.d.ts after every build.
• Bundle size tracking: size.yml posts brotli diff on every PR; 6 kB budget per artifact (current: ~2.1 kB).
• TypeScript version matrix: test-ts-versions.yml type-checks the library source against TS 4.9, 5.0, 5.4, and latest. Uses tsconfig.lib.json (excludes test files) to avoid jest globals resolution issues in newer TS versions.
• Drop Node 18: Node 18 reached EOL April 2025. Removed from CI matrix; engines updated to >=20.0.0.

Notes

React 19 exclusion is intentional and tracked, re-add to both test-react-versions.yml and publish.yml once the pull-to-refresh setState outside act() issue is fixed.

Test plan

• All CI / test jobs pass on Node 20.x and 22.x
• Test React Versions / React 17 and React 18 pass
• Test TypeScript Versions / 4.9, 5.0, 5.4, latest pass
• Build Artifacts smoke test passes
• Bundle size PR comment appears

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 79.33%. Comparing base (459674f) to head (124ac9c).
⚠️ Report is 1 commits behind head on master.

Additional details and impacted files

@@           Coverage Diff           @@
##           master     #421   +/-   ##
=======================================
  Coverage   79.33%   79.33%           
=======================================
  Files           2        2           
  Lines         150      150           
  Branches       56       56           
=======================================
  Hits          119      119           
  Misses         24       24           
  Partials        7        7           

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[github-actions]

Size Change: 0 B

Total Size: 8.61 kB

ℹ️ View Unchanged

Filename	Size
dist/index.es.js	4.3 kB
dist/index.js	4.31 kB

_{compressed-size-action}