DO NOT MERGE

.changeset/align-experimental-unstable-prefixes.md

@@ -0,0 +1,45 @@
+---
+"@clerk/clerk-js": major
+"@clerk/react": major
+"@clerk/nextjs": major
+"@clerk/vue": major
+"@clerk/astro": major
+"@clerk/expo": major
+"@clerk/chrome-extension": major
+"@clerk/shared": major
+"@clerk/ui": major
+---
+
+Align experimental/unstable prefixes to use consistent naming:
+
+- Renamed all `__unstable_*` methods to `__internal_*` (for internal APIs)
+- Renamed all `experimental__*` and `experimental_*` methods to `__experimental_*` (for beta features)
+- Removed deprecated billing-related props and `experimental__forceOauthFirst`
+- Moved `createTheme` and `simple` to `@clerk/ui/themes/experimental` export path (removed `__experimental_` prefix since they're now in the experimental export)
+
+**Breaking Changes:**
+
+### @clerk/clerk-js
+- `__unstable__environment` → `__internal_environment`
+- `__unstable__updateProps` → `__internal_updateProps`
+- `__unstable__setEnvironment` → `__internal_setEnvironment`
+- `__unstable__onBeforeRequest` → `__internal_onBeforeRequest`
+- `__unstable__onAfterResponse` → `__internal_onAfterResponse`
+- `__unstable__onBeforeSetActive` → `__internal_onBeforeSetActive` (window global)
+- `__unstable__onAfterSetActive` → `__internal_onAfterSetActive` (window global)
+
+### @clerk/nextjs
+- `__unstable_invokeMiddlewareOnAuthStateChange` → `__internal_invokeMiddlewareOnAuthStateChange`
+
+### @clerk/ui
+- `experimental_createTheme` / `__experimental_createTheme` → `createTheme` (now exported from `@clerk/ui/themes/experimental`)
+- `experimental__simple` / `__experimental_simple` → `simple` (now exported from `@clerk/ui/themes/experimental`)
+
+### @clerk/chrome-extension
+- `__unstable__createClerkClient` → `createClerkClient` (exported from `@clerk/chrome-extension/background`)
+
+### Removed (multiple packages)
+- `__unstable_manageBillingUrl` (removed)
+- `__unstable_manageBillingLabel` (removed)
+- `__unstable_manageBillingMembersLimit` (removed)
+- `experimental__forceOauthFirst` (removed)

.changeset/bright-zebras-arrive.md

@@ -0,0 +1,5 @@
+---
+'@clerk/ui': major
+---
+
+Updates both `colorRing` and `colorModalBackdrop` to render at full opacity when modified via the appearance prop or CSS variables. Previously we'd render the provided color at 15% opacity, which made it difficult to dial in a specific ring or backdrop color.

.changeset/cuddly-shrimps-refuse.md

@@ -0,0 +1,5 @@
+---
+'@clerk/backend': major
+---
+
+Update engines config to require node@20 or higher

.changeset/cyan-dancers-chew.md

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

.changeset/eight-groups-poke.md

@@ -0,0 +1,12 @@
+---
+'@clerk/upgrade': minor
+---
+
+Add support for the latest versions of the following packages:
+- `@clerk/react` (replacement for `@clerk/react`)
+- `@clerk/expo` (replacement for `@clerk/expo`)
+- `@clerk/nextjs`
+- `@clerk/react-router`
+- `@clerk/tanstack-start-react`
+
+During the upgrade, imports of the `useSignIn()` and `useSignUp()` hooks will be updated to import from the `/legacy` subpath.

.changeset/fine-symbols-occur.md

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

.changeset/fix-ui-cicd.md

@@ -0,0 +1,6 @@
+---
+"@clerk/ui": patch
+---
+
+Fix UI package serving in CI/CD integration tests
+

.changeset/fruity-apes-deny.md

@@ -0,0 +1,39 @@
+---
+'@clerk/clerk-js': major
+'@clerk/shared': major
+'@clerk/react': major
+---
+
+Updated returned values of `Clerk.checkout()` and `useCheckout`.
+
+### Vanilla JS
+```ts
+// Before
+const { getState, subscribe, confirm, start, clear, finalize  } = Clerk.checkout({ planId: "xxx", planPeriod: "annual" })
+getState().isStarting
+getState().isConfirming
+getState().error
+getState().checkout
+getState().fetchStatus
+getState().status
+
+// After
+const { checkout, errors, fetchStatus } = Clerk.checkout({ planId: "xxx", planPeriod: "annual" })
+checkout.plan // null or defined based on `checkout.status`
+checkout.status
+checkout.start
+checkout.confirm
+```
+
+### React
+```ts
+// Before
+const { id, plan, status, start, confirm, paymentSource } = useCheckout({ planId: "xxx", planPeriod: "annual" })
+
+// After
+const { checkout, errors, fetchStatus } = usecCheckout({ planId: "xxx", planPeriod: "annual" })
+checkout.plan // null or defined based on `checkout.status`
+checkout.status
+checkout.start
+checkout.confirm
+```

.changeset/fuzzy-chefs-stand.md

@@ -0,0 +1,7 @@
+---
+'@clerk/nextjs': major
+'@clerk/shared': major
+'@clerk/react': major
+---
+
+Updating minimum version of Node to v20.9.0

.changeset/happy-apes-care.md

@@ -0,0 +1,6 @@
+---
+'@clerk/clerk-js': major
+'@clerk/shared': major
+---
+
+Remove deprecated `saml` property from `UserSettings` in favor of `enterpriseSSO`

.changeset/happy-breads-begin.md

@@ -0,0 +1,8 @@
+---
+'@clerk/clerk-js': major
+'@clerk/backend': major
+'@clerk/shared': major
+'@clerk/ui': major
+---
+
+Remove deprecated `samlAccount` in favor of `enterpriseAccount`

.changeset/hide-optional-fields-by-default.md

@@ -0,0 +1,6 @@
+---
+'@clerk/ui': minor
+---
+
+Changed the default value of `appearance.layout.showOptionalFields` from `true` to `false`. Optional fields are now hidden by default during sign up. Users can still explicitly set `showOptionalFields: true` to show optional fields.
+

.changeset/hungry-beers-slide.md

@@ -0,0 +1,5 @@
+---
+'@clerk/ui': major
+---
+
+Hide "Create organization" action when user reaches organization membership limit

.changeset/mean-owls-brake.md

@@ -0,0 +1,17 @@
+---
+"@clerk/astro": major
+"@clerk/chrome-extension": major
+"@clerk/clerk-js": major
+"@clerk/dev-cli": major
+"@clerk/expo": major
+"@clerk/express": major
+"@clerk/localizations": major
+"@clerk/nuxt": major
+"@clerk/tanstack-react-start": major
+"@clerk/testing": major
+"@clerk/upgrade": major
+"@clerk/vue": major
+---
+
+Require Node.js 20.9.0 in all packages
+

.changeset/moody-peaches-stare.md

@@ -0,0 +1,5 @@
+---
+'@clerk/nextjs': major
+---
+
+Throw an error when an encryption key is missing when passing a secret key at runtime `clerkMiddleware()`. To migrate, ensure your application specifies a `CLERK_ENCRYPTION_KEY` environment variable when passing `secretKey` as a runtime option.

.changeset/ninety-days-dream.md

@@ -0,0 +1,8 @@
+---
+'@clerk/shared': major
+'@clerk/ui': major
+---
+
+Remove deprecated `hideSlug` in favor of `organizationSettings.slug.disabled` setting
+
+Slugs can now be enabled directly from the Organization Settings page in the Clerk Dashboard

.changeset/odd-rice-swim.md

@@ -0,0 +1,9 @@
+---
+'@clerk/ui': major
+---
+
+Removes `simple` theme export from UI package in favor of using the `simple` theme via the appearance prop:
+
+```tsx
+<ClerkProvider appearance={{ theme: 'simple' }} />
+```

.changeset/orange-hotels-join.md

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

.changeset/remove-deprecated-props.md

@@ -0,0 +1,11 @@
+---
+"@clerk/nextjs": major
+"@clerk/react": major
+"@clerk/clerk-js": major
+"@clerk/shared": major
+"@clerk/ui": major
+"@clerk/react-router": major
+"@clerk/tanstack-react-start": minor
+---
+
+Remove all previously deprecated UI props across the Next.js, React and clerk-js SDKs. The legacy `afterSign(In|Up)Url`/`redirectUrl` props, `UserButton` sign-out overrides, organization `hideSlug` flags, `OrganizationSwitcher`'s `afterSwitchOrganizationUrl`, `Client.activeSessions`, `setActive({ beforeEmit })`, and the `ClerkMiddlewareAuthObject` type alias are no longer exported. Components now rely solely on the new redirect options and server-side configuration.

.changeset/rename-appearance-layout-to-options.md

@@ -0,0 +1,6 @@
+---
+'@clerk/ui': major
+---
+
+Renamed `appearance.layout` to `appearance.options` across all appearance configurations. This is a breaking change - update all instances of `appearance.layout` to `appearance.options` in your codebase.
+

.changeset/salty-maps-fry.md

@@ -0,0 +1,7 @@
+---
+'@clerk/clerk-js': major
+'@clerk/shared': major
+'@clerk/ui': major
+---
+
+Remove deprecated `saml` strategy in favor of `enterprise_sso`

.changeset/set-minimum-expo-53.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/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/expo` package requirements
+
+## 2. Removed legacy subpath exports
+
+The following packages have removed their legacy subpath export mappings:
+- `@clerk/expo`
+- `@clerk/shared`
+- `@clerk/react`
+- `@clerk/localizations`
+
+**What changed:**
+Previously, these packages used a workaround to support subpath imports (e.g., `@clerk/shared/react`, `@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/shaky-books-occur.md

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

.changeset/slimy-sheep-kick.md

@@ -0,0 +1,15 @@
+---
+"@clerk/nuxt": major
+---
+
+Removed deprecated `getAuth()` helper. Use `event.context.auth()` in your server routes instead.
+
+```ts
+export default defineEventHandler((event) => {
+  const { userId } = event.context.auth()
+
+  return {
+    userId,
+  }
+})
+```

.changeset/strict-hornets-kneel.md

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

.changeset/strong-bars-learn.md

@@ -0,0 +1,9 @@
+---
+'@clerk/chrome-extension': patch
+'@clerk/expo': patch
+'@clerk/nextjs': patch
+'@clerk/react-router': patch
+'@clerk/tanstack-react-start': patch
+---
+
+Use new `@clerk/react` package.

.changeset/tall-snails-dance.md

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

.changeset/tame-suits-try.md

@@ -0,0 +1,5 @@
+---
+'@clerk/react': major
+---
+
+Change package name to `@clerk/react`.

.changeset/ten-wolves-attack.md

@@ -0,0 +1,5 @@
+---
+'@clerk/nextjs': major
+---
+
+Drop support for `next@13` and `next@14` since they have reached [EOL](https://nextjs.org/support-policy#unsupported-versions). Now `>= next@15.2.3` is required.

.changeset/thirty-cherries-pull.md

@@ -0,0 +1,12 @@
+---
+"@clerk/nuxt": major
+---
+
+Routing strategy for the ff. components now default to `path`:
+
+-  `<SignIn />`
+-  `<SignUp />`
+-  `<UserProfile />`
+-  `<OrganizationProfile />`
+-  `<CreateOrganization />`
+-  `<OrganizationList />`

.changeset/tricky-humans-stand.md

@@ -0,0 +1,5 @@
+---
+'@clerk/expo': major
+---
+
+Rename package to `@clerk/expo`.

.changeset/twenty-rockets-stop.md

@@ -0,0 +1,5 @@
+---
+'@clerk/shared': major
+---
+
+Removing deprecated top-level exports from @clerk/shared

.changeset/wild-bees-explode.md

@@ -0,0 +1,5 @@
+---
+"@clerk/vue": minor
+---
+
+Introduced internal composable for handling routing configuration for UI components

.cursor/rules/monorepo.mdc

@@ -22,7 +22,6 @@ Core Package Categories
 - **Backend**: `@clerk/backend` - Server-side utilities and JWT verification
 - **Shared Utilities**: `@clerk/shared`, `@clerk/types` - Common utilities and TypeScript types
 - **Developer Tools**: `@clerk/testing`, `@clerk/dev-cli`, `@clerk/upgrade`
-- **UI Libraries**: `@clerk/elements` - Unstyled UI primitives, `@clerk/themes` - Pre-built themes
 - **Specialized**: `@clerk/agent-toolkit` - AI agent integration tools
 
 Directory Structure
@@ -46,11 +45,10 @@ Development Workflow
 Framework-Specific Packages
 
 - `@clerk/nextjs` - Next.js App Router and Pages Router support
-- `@clerk/clerk-react` - React hooks and components
+- `@clerk/react` - React hooks and components
 - `@clerk/vue` - Vue.js composables and components
 - `@clerk/astro` - Astro integration with SSR support
 - `@clerk/nuxt` - Nuxt.js module
-- `@clerk/remix` - Remix loader and action utilities
 - `@clerk/express` - Express.js middleware
 - `@clerk/fastify` - Fastify plugin
 - `@clerk/expo` - React Native/Expo SDK
@@ -105,3 +103,11 @@ Release Management
 - Canary and snapshot releases for testing
 - Git tags and GitHub releases for version tracking
 - Coordinated releases to maintain compatibility between packages
+
+Commit Messages
+
+- Commit messages must follow the conventional commit format using lowercase
+- Commit messages must be in English
+- Commit messages must be concise and to the point
+- Commit messages must be prefixed with the type of change
+- Commit messages must be prefixed with the scope of the change (package name or `js` for `clekr-js`, repo, release, e2e, \*)