Merge branch 'vincent-and-the-doctor' into cursor/implement-waitlist-hook-with-signal-primitives-3ad1

Author: brkalow

.changeset/deprecate-clerk-types.md

@@ -0,0 +1,44 @@
+---
+'@clerk/types': minor
+'@clerk/shared': minor
+'@clerk/astro': patch
+'@clerk/backend': patch
+'@clerk/chrome-extension': patch
+'@clerk/clerk-js': patch
+'@clerk/elements': patch
+'@clerk/themes': patch
+'@clerk/vue': patch
+---
+
+Deprecate `@clerk/types` in favor of `@clerk/shared/types`
+
+The `@clerk/types` package is now deprecated. All type definitions have been consolidated and moved to `@clerk/shared/types` to improve consistency across the Clerk ecosystem.
+
+**Backward Compatibility:**
+
+The `@clerk/types` package will remain available and will continue to re-export all types from `@clerk/shared/types` to ensure backward compatibility. Existing applications will continue to work without any immediate breaking changes. However, we strongly recommend migrating to `@clerk/shared/types` as new type definitions and updates will only be added to `@clerk/shared/types` starting with the next major release.
+
+**Migration Steps:**
+
+Please update your imports from `@clerk/types` to `@clerk/shared/types`:
+
+```typescript
+// Before
+import type { ClerkResource, UserResource } from '@clerk/types';
+
+// After
+import type { ClerkResource, UserResource } from '@clerk/shared/types';
+```
+
+**What Changed:**
+
+All type definitions including:
+- Resource types (User, Organization, Session, etc.)
+- API response types
+- Configuration types  
+- Authentication types
+- Error types
+- And all other shared types
+
+Have been moved from `packages/types/src` to `packages/shared/src/types` and are now exported via `@clerk/shared/types`.
+

.changeset/breezy-flowers-float.md renamed to .changeset/fine-symbols-occur.md

@@ -0,0 +1,37 @@
+---
+'@clerk/expo': major
+'@clerk/expo-passkeys': major
+'@clerk/shared': major
+'@clerk/react': major
+'@clerk/localizations': major
+---
+
+Drop support for Expo 50, 51 and 52. This release includes two breaking changes:
+
+## 1. Updated Expo peer dependency requirements
+
+**@clerk/clerk-expo**
+- **Added** new peer dependency: `expo: >=53 <55`
+  - The core `expo` package is now explicitly required as a peer dependency
+  - This ensures compatibility with the Expo SDK version range that supports the features used by Clerk
+
+**@clerk/expo-passkeys**
+- **Updated** peer dependency: `expo: >=53 <55` (previously `>=50 <55`)
+  - Minimum Expo version increased from 50 to 53
+  - This aligns with the main `@clerk/clerk-expo` package requirements
+
+## 2. Removed legacy subpath exports
+
+The following packages have removed their legacy subpath export mappings:
+- `@clerk/clerk-expo`
+- `@clerk/shared`
+- `@clerk/clerk-react`
+- `@clerk/localizations`
+
+**What changed:**
+Previously, these packages used a workaround to support subpath imports (e.g., `@clerk/shared/react`, `@clerk/clerk-expo/web`). These legacy exports have been removed in favor of modern package.json `exports` field configuration.
+
+All public APIs remain available through the main package entry points.
+
+
+

.changeset/thin-turtles-search.md renamed to .changeset/gold-planes-wear.md

@@ -18,7 +18,7 @@ concurrency:
 jobs:
   # Check triggering actor permissions to prevent PRs from forks accessing secrets by default, preventing them from exfiltrating secrets for malicious purposes
   check-permissions:
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash
@@ -48,7 +48,7 @@ jobs:
     needs: [check-permissions]
     if: ${{ github.event_name != 'pull_request' || github.event.pull_request.draft == false }}
     name: Formatting | Dedupe | Changeset
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash
@@ -89,7 +89,7 @@ jobs:
     needs: [check-permissions]
     if: ${{ github.event_name != 'pull_request' || github.event.pull_request.draft == false }}
     name: Build Packages
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     permissions:
       contents: read
     defaults:
@@ -117,7 +117,7 @@ jobs:
           turbo-token: ${{ secrets.TURBO_TOKEN }}
 
       - name: Turbo Build
-        run: pnpm turbo build $TURBO_ARGS --only
+        run: pnpm turbo build $TURBO_ARGS --only --filter=!@clerk/elements
 
       - name: Upload Turbo Summary
         uses: actions/upload-artifact@v4
@@ -135,7 +135,7 @@ jobs:
     permissions:
       contents: read
       actions: write # needed for actions/upload-artifact
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash
@@ -195,7 +195,7 @@ jobs:
     permissions:
       contents: read
       actions: write # needed for actions/upload-artifact
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash
@@ -208,10 +208,8 @@ jobs:
       fail-fast: true
       matrix:
         include:
-          - node-version: 20
-            test-filter: '--filter=@clerk/astro --filter=@clerk/backend --filter=@clerk/express --filter=@clerk/nextjs --filter=@clerk/react --filter=@clerk/shared --filter=@clerk/tanstack-react-start --filter=@clerk/elements --filter=@clerk/vue --filter=@clerk/nuxt --filter=@clerk/expo'
           - node-version: 22
-            test-filter: '**'
+            test-filter: "**"
 
     steps:
       - name: Checkout Repo
@@ -247,7 +245,7 @@ jobs:
         run: |
           # Only run Typedoc tests for one matrix version
           if [ "${{ matrix.node-version }}" == "22" ]; then
-            pnpm test:typedoc
+            pnpm turbo run //#test:typedoc
           fi
         env:
           NODE_VERSION: ${{ matrix.node-version }}
@@ -268,7 +266,7 @@ jobs:
     permissions:
       contents: read
       actions: write # needed for actions/upload-artifact
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash
@@ -279,35 +277,40 @@ jobs:
       matrix:
         test-name:
           [
-            'generic',
-            'express',
-            'quickstart',
-            'ap-flows',
-            'elements',
-            'localhost',
-            'sessions',
-            'sessions:staging',
-            'handshake',
-            'handshake:staging',
-            'astro',
-            'expo-web',
-            'tanstack-react-start',
-            # 'tanstack-react-router',
-            'vue',
-            'nuxt',
-            'react-router',
-            'billing',
-            'machine',
-            'custom',
+            "generic",
+            "express",
+            "ap-flows",
+            "localhost",
+            "sessions",
+            "sessions:staging",
+            "handshake",
+            "handshake:staging",
+            "astro",
+            "tanstack-react-start",
+            "vue",
+            "nuxt",
+            "react-router",
+            "billing",
+            "machine",
+            "custom",
           ]
-        test-project: ['chrome']
+        test-project: ["chrome"]
         include:
-          - test-name: 'nextjs'
-            test-project: 'chrome'
-            next-version: '14'
-          - test-name: 'nextjs'
-            test-project: 'chrome'
-            next-version: '15'
+          - test-name: "nextjs"
+            test-project: "chrome"
+            next-version: "14"
+          - test-name: "nextjs"
+            test-project: "chrome"
+            next-version: "15"
+          - test-name: "nextjs"
+            test-project: "chrome"
+            next-version: "16"
+          - test-name: "quickstart"
+            test-project: "chrome"
+            next-version: "15"
+          - test-name: "quickstart"
+            test-project: "chrome"
+            next-version: "16"
 
     steps:
       - name: Checkout Repo
@@ -325,17 +328,34 @@ jobs:
           turbo-token: ${{ secrets.TURBO_TOKEN }}
           playwright-enabled: true
 
+      - name: Verify jq is installed
+        shell: bash
+        run: |
+          if ! command -v jq &> /dev/null; then
+            echo "jq not found, installing..."
+            sudo apt-get update && sudo apt-get install -y jq
+          fi
+          jq --version
+
       - name: Task Status
         id: task-status
         env:
           E2E_APP_CLERK_JS_DIR: ${{runner.temp}}
-          E2E_CLERK_VERSION: 'latest'
+          E2E_CLERK_VERSION: "latest"
           E2E_NEXTJS_VERSION: ${{ matrix.next-version }}
           E2E_PROJECT: ${{ matrix.test-project }}
           INTEGRATION_INSTANCE_KEYS: ${{ secrets.INTEGRATION_INSTANCE_KEYS }}
         run: |
-          AFFECTED=0
-          (pnpm turbo-ignore --task=test:integration:${{ matrix.test-name }} --fallback=${{ github.base_ref || 'refs/heads/main' }}) || AFFECTED=1
+          # Use turbo's built-in --affected flag to detect changes
+          # This automatically uses GITHUB_BASE_REF in GitHub Actions
+          TASK_COUNT=$(pnpm turbo run test:integration:${{ matrix.test-name }} --affected --dry=json 2>/dev/null | jq '.tasks | length' 2>/dev/null || echo "0")
+
+          if [ "$TASK_COUNT" -gt 0 ]; then
+            AFFECTED=1
+          else
+            AFFECTED=0
+          fi
+
           echo "affected=${AFFECTED}"
           echo "affected=${AFFECTED}" >> $GITHUB_OUTPUT
 
@@ -374,8 +394,8 @@ jobs:
         if: ${{ steps.task-status.outputs.affected == '1' }}
         uses: actions/github-script@v7
         env:
-          INTEGRATION_CERTS: '${{secrets.INTEGRATION_CERTS}}'
-          INTEGRATION_ROOT_CA: '${{secrets.INTEGRATION_ROOT_CA}}'
+          INTEGRATION_CERTS: "${{secrets.INTEGRATION_CERTS}}"
+          INTEGRATION_ROOT_CA: "${{secrets.INTEGRATION_ROOT_CA}}"
         with:
           script: |
             const fs = require('fs');
@@ -400,7 +420,7 @@ jobs:
         run: pnpm turbo test:integration:${{ matrix.test-name }} $TURBO_ARGS
         env:
           E2E_APP_CLERK_JS_DIR: ${{runner.temp}}
-          E2E_CLERK_VERSION: 'latest'
+          E2E_CLERK_VERSION: "latest"
           E2E_NEXTJS_VERSION: ${{ matrix.next-version }}
           E2E_PROJECT: ${{ matrix.test-project }}
           E2E_CLERK_ENCRYPTION_KEY: ${{ matrix.clerk-encryption-key }}
@@ -420,7 +440,7 @@ jobs:
     name: Publish with pkg-pr-new
     if: ${{ github.event_name != 'pull_request' || github.event.pull_request.draft == false }}
     needs: [check-permissions, build-packages]
-    runs-on: 'blacksmith-8vcpu-ubuntu-2204'
+    runs-on: "blacksmith-8vcpu-ubuntu-2204"
     defaults:
       run:
         shell: bash

.changeset/large-doors-repeat.md

@@ -36,7 +36,6 @@ describe('Typedoc output', () => {
         "nextjs",
         "react",
         "shared",
-        "types",
       ]
     `);
   });

.changeset/set-minimum-expo-53.md

@@ -79,12 +79,22 @@ class ClerkMarkdownThemeContext extends MarkdownThemeContext {
           if (paramExtensionTag) {
             const stuff = this.helpers.getCommentParts(paramExtensionTag.content);
 
-            // Find the index of the item that contains '## Returns'
-            const index = splitOutput.findIndex(item => item.includes('## Returns'));
-
-            // If the index is found, insert the stuff before it
-            if (index !== -1) {
-              splitOutput.splice(index, 0, stuff);
+            // Find the index of the item that contains '## Parameters'
+            const parametersIndex = splitOutput.findIndex(item => item.includes('## Parameters'));
+
+            if (parametersIndex !== -1) {
+              // Find the immediate next heading after '## Parameters'
+              const nextHeadingIndex = splitOutput.findIndex((item, index) => {
+                // Skip the items before the parameters
+                if (index <= parametersIndex) return false;
+                // Find the next heading
+                return item.startsWith('##') || item.startsWith('\n##');
+              });
+
+              // Insert the stuff before the next heading
+              // (or at the end of the entire page if no heading found)
+              const insertIndex = nextHeadingIndex !== -1 ? nextHeadingIndex : splitOutput.length;
+              splitOutput.splice(insertIndex, 0, stuff);
             }
           }
 

.changeset/tame-tips-own.md

@@ -120,6 +120,7 @@ export default tseslint.config([
       'packages/backend/src/runtime/**/*',
       'packages/clerk-js/rspack.config.js',
       'packages/shared/src/compiled/path-to-regexp/index.js',
+      'packages/shared/tsdown.config.mjs',
     ],
   },
   {