test(e2e): add Mosaic UserButton integration suite (#9846)

Author: alexcarpenter

.changeset/mosaic-e2e-user-button.md

@@ -0,0 +1,2 @@
+---
+---

.changeset/mosaic-trim-user-button-tests.md

@@ -0,0 +1,2 @@
+---
+---

.github/workflows/ci.yml

@@ -382,6 +382,9 @@ jobs:
           - test-name: 'cache-components'
             test-project: 'chrome'
             next-version: '16'
+          - test-name: 'mosaic'
+            test-project: 'chrome'
+            next-version: '16'
 
     steps:
       - name: Checkout Repo

integration/presets/longRunningApps.ts

@@ -43,6 +43,11 @@ export const createLongRunningApps = () => {
      */
     { id: 'next.appRouterBundledUI.withEmailCodes', config: next.appRouterBundledUI, env: envs.withEmailCodes },
 
+    /**
+     * NextJS apps - Mosaic
+     */
+    { id: 'next.appRouterMosaic.withEmailCodes', config: next.appRouterMosaic, env: envs.withEmailCodes },
+
     /**
      * NextJS apps - cache components
      */

integration/presets/next.ts

@@ -56,6 +56,21 @@ const appRouterBundledUI = applicationConfig()
   .addDependency('@clerk/shared', PKGLAB)
   .addDependency('@clerk/ui', PKGLAB);
 
+const appRouterMosaic = applicationConfig()
+  .setName('next-app-router-mosaic')
+  .useTemplate(templates['next-app-router-mosaic'])
+  .setEnvFormatter('public', key => `NEXT_PUBLIC_${key}`)
+  .addScript('setup', constants.E2E_NPM_FORCE ? 'pnpm install --force' : 'pnpm install')
+  .addScript('dev', 'pnpm dev')
+  .addScript('build', 'pnpm build')
+  .addScript('serve', 'pnpm start')
+  .addDependency('next', constants.E2E_NEXTJS_VERSION)
+  .addDependency('react', constants.E2E_REACT_VERSION)
+  .addDependency('react-dom', constants.E2E_REACT_DOM_VERSION)
+  .addDependency('@clerk/nextjs', PKGLAB)
+  .addDependency('@clerk/shared', PKGLAB)
+  .addDependency('@clerk/mosaic', PKGLAB);
+
 const cacheComponents = applicationConfig()
   .setName('next-cache-components')
   .useTemplate(templates['next-cache-components'])
@@ -76,5 +91,6 @@ export const next = {
   appRouterAPWithClerkNextV6,
   appRouterQuickstartV6,
   appRouterBundledUI,
+  appRouterMosaic,
   cacheComponents,
 } as const;

integration/templates/index.ts

@@ -5,6 +5,7 @@ export const templates = {
   'next-cache-components': resolve(import.meta.dirname, './next-cache-components'),
   'next-app-router-quickstart': resolve(import.meta.dirname, './next-app-router-quickstart'),
   'next-app-router-bundled-ui': resolve(import.meta.dirname, './next-app-router-bundled-ui'),
+  'next-app-router-mosaic': resolve(import.meta.dirname, './next-app-router-mosaic'),
   'next-app-router-quickstart-v6': resolve(import.meta.dirname, './next-app-router-quickstart-v6'),
   'react-vite': resolve(import.meta.dirname, './react-vite'),
   'express-vite': resolve(import.meta.dirname, './express-vite'),

integration/templates/next-app-router-mosaic/.gitignore

@@ -0,0 +1,35 @@
+# See https://help.github.com/articles/ignoring-files/ for more about ignoring files.
+
+# dependencies
+/node_modules
+/.pnp
+.pnp.js
+
+# testing
+/coverage
+
+# next.js
+/.next/
+/out/
+
+# production
+/build
+
+# misc
+.DS_Store
+*.pem
+
+# debug
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# local env files
+.env*.local
+
+# vercel
+.vercel
+
+# typescript
+*.tsbuildinfo
+next-env.d.ts

integration/templates/next-app-router-mosaic/next.config.js

@@ -0,0 +1,4 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {};
+
+module.exports = nextConfig;

integration/templates/next-app-router-mosaic/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "next-app-router-mosaic",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "build": "next build",
+    "dev": "next dev",
+    "lint": "next lint",
+    "start": "next start"
+  },
+  "dependencies": {
+    "@types/node": "^20.12.12",
+    "@types/react": "19.2.14",
+    "@types/react-dom": "19.2.3",
+    "next": "^15.5.18",
+    "react": "19.2.4",
+    "react-dom": "19.2.4",
+    "typescript": "^5.7.3"
+  },
+  "engines": {
+    "node": ">=22.11.0"
+  }
+}

integration/templates/next-app-router-mosaic/src/app/custom/link-target/page.tsx

@@ -0,0 +1,3 @@
+export default function Page() {
+  return <p>custom-link-target</p>;
+}