v2.0.0 — full rewrite (zero deps, WAI-ARIA, React 16.14–19)

.github/workflows/ci.yml

@@ -0,0 +1,79 @@
+name: CI
+
+on:
+  push:
+    branches: [master, development, 'feat/**']
+  pull_request:
+
+jobs:
+  lint:
+    name: Lint + typecheck
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run lint
+      - run: npm run typecheck
+
+  test:
+    name: Test (React ${{ matrix.react }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        react: ['16.14.0', '17.0.2', '18.3.1', '19.0.0']
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - name: Install React ${{ matrix.react }}
+        # RTL version matrix:
+        # - React 16.14 / 17 → RTL v12 (last version with those peers).
+        #   Tests use a local renderHook shim built on render() so the
+        #   missing @testing-library/react.renderHook export is OK.
+        # - React 18 → RTL v14.
+        # - React 19 → RTL v16 (first version with React 19 in its peer
+        #   range; v14 pins to react@^18 and rejects @19.0.0 install).
+        run: |
+          if [[ "${{ matrix.react }}" == 16.* || "${{ matrix.react }}" == 17.* ]]; then
+            npm install --no-save \
+              react@${{ matrix.react }} \
+              react-dom@${{ matrix.react }} \
+              "@testing-library/react@^12"
+          elif [[ "${{ matrix.react }}" == 18.* ]]; then
+            npm install --no-save \
+              react@${{ matrix.react }} \
+              react-dom@${{ matrix.react }} \
+              "@testing-library/react@^14"
+          else
+            npm install --no-save \
+              react@${{ matrix.react }} \
+              react-dom@${{ matrix.react }} \
+              "@testing-library/react@^16"
+          fi
+      - run: npm test
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+      - run: npm ci
+      - run: npm run build
+      - name: Upload dist
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+          retention-days: 7

.github/workflows/docs.yml

@@ -0,0 +1,66 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'docs/**'
+      - 'src/**'
+      - '.github/workflows/docs.yml'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    name: Build docs site
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: docs
+    steps:
+      - uses: actions/checkout@v4
+
+      # The repo's Pages source used to be the `gh-pages` branch
+      # (legacy Storybook publish). `actions/deploy-pages` requires the
+      # source to be `workflow`, so idempotently flip it before we do
+      # anything else. The PUT is a no-op once the setting is already
+      # `workflow` — safe to run on every deploy.
+      - name: Ensure Pages is configured for Actions-based deploys
+        working-directory: .
+        run: |
+          gh api -X PUT "repos/${{ github.repository }}/pages" \
+            -F build_type=workflow
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+          cache-dependency-path: docs/package-lock.json
+      - run: npm ci
+      - run: npm run build
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: docs/dist
+
+  deploy:
+    name: Deploy to GitHub Pages
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy
+        id: deployment
+        uses: actions/deploy-pages@v4