chore(repo): Migrate to Vitest 5 by wobsoriano · Pull Request #9664 · clerk/javascript

wobsoriano · 2026-09-04T20:34:56Z

Description

Migrates the monorepo to Vitest 5 https://vitest.dev/blog/vitest-5.html

Checklist

pnpm test runs as expected.
pnpm build runs as expected.
(If applicable) JSDoc comments have been added or updated for any package exports
(If applicable) Documentation has been updated

Type of change

changeset-bot · 2026-09-04T20:35:00Z

🦋 Changeset detected

Latest commit: 05b47aa

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 0 packages

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

vercel · 2026-09-04T20:35:02Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
clerk-js-sandbox	Ready	Preview	Sep 6, 2026 5:13pm UTC
swingset	Ready	Preview	Sep 6, 2026 5:13pm UTC

coderabbitai · 2026-09-04T20:35:04Z

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: ASSERTIVE

Plan: Team

Run ID: fa9a8ab2-996d-492b-b4de-df85e70def08

📥 Commits

Reviewing files that changed from the base of the PR and between bc3c89e and 05b47aa.

⛔ Files ignored due to path filters (1)

pnpm-lock.yaml is excluded by !**/pnpm-lock.yaml

📒 Files selected for processing (10)

.changeset/vitest-five.md
package.json
packages/backend/src/tokens/__tests__/request.test.ts
packages/eslint-plugin/package.json
packages/expo-passkeys/package.json
packages/headless/package.json
packages/headless/src/test-utils/jest-dom.d.ts
packages/headless/src/test-utils/vitest-axe.d.ts
packages/ui/src/utils/colors/__tests__/legacy.test.ts
vitest.workspace.mjs

🔗 Linked repositories identified

CodeRabbit considers these linked repositories for cross-repo context during reviews:

clerk/clerk_go (manual)
clerk/dashboard (manual)
clerk/accounts (manual)
clerk/backoffice (manual)
clerk/clerk (manual)

💤 Files with no reviewable changes (1)

vitest.workspace.mjs

Included review availability: 9 reviews are currently available. Your included PR review attempts over the past 7 days set your current allowance at 10 reviews per hour.

📝 Walkthrough

Walkthrough

Vitest and @vitest/coverage-v8 are upgraded to 5.0.0 in the root and package dependencies. Vitest Assertion augmentations now use two generic parameters. CSS-variable tests use vi.stubGlobal and vi.unstubAllGlobals(). Expo Passkeys adds TypeScript as a development dependency. The Vitest workspace configuration is removed. A Vitest patch changeset is added.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to 05b47

This updates the repository’s Vitest tooling and related test typings and global stubs for Vitest 5 compatibility. No concrete merge-blocking behavior or production risk remains identified.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and concisely identifies the main change: migrating the monorepo to Vitest 5.
Description check	✅ Passed	The description directly states that the pull request migrates the monorepo to Vitest 5, which matches the changeset and objectives.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 4…
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

Warning

Linked repositories: Your configuration references 7 linked repositories, but your current plan allows 5. Analyzed clerk/clerk_go, clerk/dashboard, clerk/accounts, clerk/backoffice, clerk/clerk, skipped clerk/clerk-docs, clerk/cloudflare-workers.

_{Comment @coderabbitai help to get the list of available commands.}

pkg-pr-new · 2026-09-04T20:38:27Z

Open in StackBlitz

@clerk/astro

npm i https://pkg.pr.new/@clerk/astro@9664

@clerk/backend

npm i https://pkg.pr.new/@clerk/backend@9664

@clerk/chrome-extension

npm i https://pkg.pr.new/@clerk/chrome-extension@9664

@clerk/clerk-js

npm i https://pkg.pr.new/@clerk/clerk-js@9664

@clerk/electron

npm i https://pkg.pr.new/@clerk/electron@9664

@clerk/electron-passkeys

npm i https://pkg.pr.new/@clerk/electron-passkeys@9664

@clerk/eslint-plugin

npm i https://pkg.pr.new/@clerk/eslint-plugin@9664

@clerk/expo

npm i https://pkg.pr.new/@clerk/expo@9664

@clerk/expo-google-signin

npm i https://pkg.pr.new/@clerk/expo-google-signin@9664

@clerk/expo-passkeys

npm i https://pkg.pr.new/@clerk/expo-passkeys@9664

@clerk/express

npm i https://pkg.pr.new/@clerk/express@9664

@clerk/fastify

npm i https://pkg.pr.new/@clerk/fastify@9664

@clerk/hono

npm i https://pkg.pr.new/@clerk/hono@9664

@clerk/localizations

npm i https://pkg.pr.new/@clerk/localizations@9664

@clerk/nextjs

npm i https://pkg.pr.new/@clerk/nextjs@9664

@clerk/nuxt

npm i https://pkg.pr.new/@clerk/nuxt@9664

@clerk/react

npm i https://pkg.pr.new/@clerk/react@9664

@clerk/react-router

npm i https://pkg.pr.new/@clerk/react-router@9664

@clerk/shared

npm i https://pkg.pr.new/@clerk/shared@9664

@clerk/tanstack-react-start

npm i https://pkg.pr.new/@clerk/tanstack-react-start@9664

@clerk/testing

npm i https://pkg.pr.new/@clerk/testing@9664

@clerk/ui

npm i https://pkg.pr.new/@clerk/ui@9664

@clerk/upgrade

npm i https://pkg.pr.new/@clerk/upgrade@9664

@clerk/vue

npm i https://pkg.pr.new/@clerk/vue@9664

commit: 05b47aa

wobsoriano · 2026-09-05T19:29:07Z

 declare module 'vitest' {
  // eslint-disable-next-line @typescript-eslint/no-empty-object-type
-  interface Assertion<T = any> extends CustomMatchers<T> {}
+  interface Assertion<R, T> extends CustomMatchers<R> {}


Updated to the new two-parameter Assertion interface for custom matcher augmentations https://vitest.dev/guide/migration/#assertion-types-expose-return-and-received-types

wobsoriano · 2026-09-05T19:32:27Z

+        vi.stubGlobal('window', mockWindow);
+        vi.stubGlobal('getComputedStyle', mockGetComputedStyle);
+        vi.stubGlobal('document', {


global assignments in DOM environments now propagate to the window https://vitest.dev/guide/migration/#dom-environment-global-assignments-now-update-the-underlying-window

this is the documented way to override globals

wobsoriano · 2026-09-05T19:33:57Z

@@ -1,3 +0,0 @@
-import { defineWorkspace } from 'vitest/config';
-
-export default defineWorkspace(['./packages/*/vitest.config.{mts,mjs,js,ts}', './scripts/vitest.config.mjs']);


🪓 defineWorkspace no longer exists in Vitest 5 and nothingr eferenced this file, turbo runs vitest per package

If we ever need a root runner, the equivalent is test.projects

github-actions · 2026-09-06T17:16:19Z

API Changes Report

Generated by Break Check on 2026-09-06T17:16:17.373Z

Summary

Metric	Count
Packages analyzed	19
Packages with changes	0
🔴 Breaking changes	0
🟡 Non-breaking changes	0
🟢 Additions	0

No API Changes Detected

All packages have stable APIs with no detected changes.

Report generated by Break Check

_{Last ran on 05b47aa.}

chore(repo): Migrate to Vitest 5

25a4d2a

github-actions Bot added backend ui eslint-plugin labels Sep 4, 2026

vercel Bot deployed to Preview – clerk-js-sandbox September 4, 2026 20:35 View deployment

vercel Bot deployed to Preview – swingset September 4, 2026 20:37 View deployment

Merge branch 'main' into rob/vitest-5

1eb490f

vercel Bot deployed to Preview – clerk-js-sandbox September 5, 2026 19:24 View deployment

vercel Bot deployed to Preview – swingset September 5, 2026 19:26 View deployment

wobsoriano commented Sep 5, 2026

View reviewed changes

chore(repo): Fix lint and dedupe checks for Vitest 5

a86baa3

vercel Bot deployed to Preview – clerk-js-sandbox September 5, 2026 19:35 View deployment

vercel Bot deployed to Preview – swingset September 5, 2026 19:37 View deployment

wobsoriano added 2 commits September 6, 2026 10:10

chore(repo): Drop aged-out Vitest 5 release-age excludes

84677a1

chore(repo): Restore headless exports field ordering

05b47aa

vercel Bot deployed to Preview – clerk-js-sandbox September 6, 2026 17:12 View deployment

wobsoriano marked this pull request as ready for review September 6, 2026 17:13

vercel Bot deployed to Preview – swingset September 6, 2026 17:13 View deployment

Navigation Menu

Uh oh!

chore(repo): Migrate to Vitest 5 - #9664

chore(repo): Migrate to Vitest 5#9664
wobsoriano wants to merge 5 commits into
mainfrom
rob/vitest-5

wobsoriano commented Sep 4, 2026 •

edited

Loading

Uh oh!

changeset-bot Bot commented Sep 4, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Sep 4, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Sep 4, 2026 •

edited

Loading

Walkthrough

Uh oh!

pkg-pr-new Bot commented Sep 4, 2026 •

edited

Loading

Uh oh!

wobsoriano Sep 5, 2026 •

edited

Loading

Uh oh!

wobsoriano Sep 5, 2026

Uh oh!

wobsoriano Sep 5, 2026

Uh oh!

github-actions Bot commented Sep 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

		@@ -1,3 +0,0 @@
		import { defineWorkspace } from 'vitest/config';

		export default defineWorkspace(['./packages/*/vitest.config.{mts,mjs,js,ts}', './scripts/vitest.config.mjs']);

Uh oh!

Conversation

wobsoriano commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Checklist

Type of change

Uh oh!

changeset-bot Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🦋 Changeset detected

Uh oh!

vercel Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

coderabbitai Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Walkthrough

Uh oh!

pkg-pr-new Bot commented Sep 4, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

wobsoriano Sep 5, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

wobsoriano Sep 5, 2026

Choose a reason for hiding this comment

Uh oh!

wobsoriano Sep 5, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions Bot commented Sep 6, 2026

API Changes Report

Summary

No API Changes Detected

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

wobsoriano commented Sep 4, 2026 •

edited

Loading

changeset-bot Bot commented Sep 4, 2026 •

edited

Loading

vercel Bot commented Sep 4, 2026 •

edited

Loading

coderabbitai Bot commented Sep 4, 2026 •

edited

Loading

pkg-pr-new Bot commented Sep 4, 2026 •

edited

Loading

wobsoriano Sep 5, 2026 •

edited

Loading