[test] Add Guidepup screen reader tests

.github/workflows/ci.yml

@@ -68,6 +68,24 @@ jobs:
           # https://docs.github.com/en/actions/security-guides/automatic-token-authentication#about-the-github_token-secret
           token: ${{secrets.GITHUB_TOKEN}}
 
+  screen-reader-windows:
+    name: Screen Reader (Windows / NVDA)
+    runs-on: windows-2025
+    timeout-minutes: 15
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+      - name: Set up pnpm
+        uses: pnpm/action-setup@8912a9102ac27614460f54aedde9e1e7f9aec20d # v6.0.5
+      - name: Use Node.js 22.x
+        uses: actions/setup-node@48b55a011bda9f5d6aeb4c2d9c7362e8dae4041e # v6.4.0
+        with:
+          node-version: '22.23.2'
+          cache: 'pnpm'
+      - run: pnpm install
+      - run: pnpm test:screen-reader
+
   # Mirrors the real publish workflow environment (`publish.yml`) so an env
   # mismatch — e.g. the Node version pinned by `publish-prepare` violating our
   # engineStrict `engines` range — is caught here instead of during publishing.

package.json

@@ -45,6 +45,9 @@
     "test:regressions:dev": "vite --config test/regressions/vite.config.mjs --port 5173",
     "test:regressions:run": "cross-env VITEST_ENV=chromium vitest run --project regressions",
     "test:regressions:server": "serve test/regressions -p 5173",
+    "pretest:screen-reader": "guidepup install",
+    "test:screen-reader": "playwright test --config test/screen-reader/playwright.config.ts",
+    "test:screen-reader:setup": "guidepup setup",
     "test:_unit": "cross-env TZ=UTC vitest --project @base-ui/react --project @base-ui/utils --project docs",
     "test:jsdom": "cross-env VITEST_ENV=jsdom pnpm test:_unit",
     "test:jsdom:coverage": "pnpm test:jsdom --coverage",
@@ -66,6 +69,9 @@
     "@arethetypeswrong/cli": "0.18.5",
     "@babel/plugin-transform-react-constant-elements": "7.29.7",
     "@base-ui/monorepo-tests": "workspace:*",
+    "@guidepup/guidepup": "0.33.1",
+    "@guidepup/playwright": "0.19.1",
+    "@guidepup/setup": "0.24.6",
     "@microsoft/api-extractor": "7.58.12",
     "@mui/internal-code-infra": "0.0.4-canary.101",
     "@mui/internal-netlify-cache": "0.0.3-canary.5",