@clerk/upgrade 2.0.0-snapshot.v20251211120550 → 2.0.0-snapshot.v20251215203425

package/dist/__tests__/fixtures/nextjs-v6-scan-issues/package.json

@@ -0,0 +1,9 @@
+{
+  "name": "test-nextjs-v6-scan-issues",
+  "version": "1.0.0",
+  "dependencies": {
+    "@clerk/nextjs": "^6.0.0",
+    "next": "^14.0.0",
+    "react": "^18.0.0"
+  }
+}

package/dist/__tests__/fixtures/nextjs-v6-scan-issues/pnpm-lock.yaml

@@ -0,0 +1,2 @@
+lockfileVersion: '6.0'
+

package/dist/__tests__/fixtures/nextjs-v6-scan-issues/src/app.tsx

@@ -0,0 +1,30 @@
+import { ClerkProvider, SignIn, useAuth } from '@clerk/nextjs';
+
+export default function App({ children }) {
+  return (
+    <ClerkProvider
+      appearance={{
+        layout: {
+          socialButtonsPlacement: 'bottom',
+        },
+      }}
+    >
+      {children}
+    </ClerkProvider>
+  );
+}
+
+export function SignInPage() {
+  return (
+    <SignIn
+      afterSignInUrl='/dashboard'
+      afterSignUpUrl='/onboarding'
+    />
+  );
+}
+
+export function SamlCallback() {
+  const { isSignedIn } = useAuth();
+  // Handle saml callback
+  return <div>SAML SSO Callback</div>;
+}

package/dist/cli.js

@@ -30,13 +30,14 @@ const cli = meow(`
 `, {
   importMeta: import.meta,
   flags: {
-    sdk: {
-      type: 'string'
-    },
     dir: {
       type: 'string',
       default: process.cwd()
     },
+    dryRun: {
+      type: 'boolean',
+      default: false
+    },
     glob: {
       type: 'string',
       default: '**/*.(js|jsx|ts|tsx|mjs|cjs)'
@@ -45,18 +46,17 @@ const cli = meow(`
       type: 'string',
       isMultiple: true
     },
-    skipUpgrade: {
-      type: 'boolean',
-      default: false
-    },
     release: {
       type: 'string'
     },
-    dryRun: {
+    sdk: {
+      type: 'string'
+    },
+    skipCodemods: {
       type: 'boolean',
       default: false
     },
-    skipCodemods: {
+    skipUpgrade: {
       type: 'boolean',
       default: false
     }
@@ -66,12 +66,12 @@ async function main() {
   renderHeader();
   const options = {
     dir: cli.flags.dir,
+    dryRun: cli.flags.dryRun,
     glob: cli.flags.glob,
     ignore: cli.flags.ignore,
-    skipUpgrade: cli.flags.skipUpgrade,
     release: cli.flags.release,
-    dryRun: cli.flags.dryRun,
-    skipCodemods: cli.flags.skipCodemods
+    skipCodemods: cli.flags.skipCodemods,
+    skipUpgrade: cli.flags.skipUpgrade
   };
   if (options.dryRun) {
     renderWarning(' Upgrade running in dry run mode - no changes will be made');

package/dist/codemods/index.js

@@ -1,8 +1,8 @@
 import { dirname, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import chalk from 'chalk';
-import { globby } from 'globby';
 import { run } from 'jscodeshift/src/Runner.js';
+import { glob } from 'tinyglobby';
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const CODEMOD_CONFIG = {
   'transform-remove-deprecated-props': {
@@ -10,12 +10,12 @@ const CODEMOD_CONFIG = {
   }
 };
 const GLOBBY_IGNORE = ['**/*.md', 'node_modules/**', '**/node_modules/**', '.git/**', '**/*.json', 'package.json', '**/package.json', 'package-lock.json', '**/package-lock.json', 'yarn.lock', '**/yarn.lock', 'pnpm-lock.yaml', '**/pnpm-lock.yaml', 'yalc.lock', '**/*.{ico,png,webp,svg,gif,jpg,jpeg}', '**/*.{mp4,mkv,wmv,m4v,mov,avi,flv,webm,flac,mka,m4a,aac,ogg}', '**/*.{css,scss,sass,less,styl}'];
-export async function runCodemod(transform = 'transform-async-request', glob, options = {}) {
+export async function runCodemod(transform = 'transform-async-request', patterns, options = {}) {
   if (!transform) {
     throw new Error('No transform provided');
   }
   const resolvedPath = resolve(__dirname, `${transform}.cjs`);
-  const paths = await globby(glob, {
+  const paths = await glob(patterns, {
     ignore: GLOBBY_IGNORE
   });
   if (options.skipCodemods) {

package/dist/codemods/transform-align-experimental-unstable-prefixes.cjs

@@ -20,18 +20,6 @@ const UI_LEGACY_SOURCES = new Set(['@clerk/ui', '@clerk/ui/themes', UI_THEME_SOU
 const CHROME_CLIENT_NAMES = new Set(['__unstable__createClerkClient', 'createClerkClient']);
 const CHROME_BACKGROUND_SOURCE = '@clerk/chrome-extension/background';
 const CHROME_LEGACY_SOURCE = '@clerk/chrome-extension';
-
-/**
- * Transforms experimental and unstable prefixed identifiers to their stable or internal equivalents.
- * Also moves theme-related imports to @clerk/ui/themes/experimental and Chrome extension imports
- * to @clerk/chrome-extension/background. Removes deprecated billing-related props.
- *
- * @param {Object} file - The file object containing the source code
- * @param {string} file.source - The source code to transform
- * @param {Object} api - The jscodeshift API
- * @param {Function} api.jscodeshift - The jscodeshift function
- * @returns {string|undefined} The transformed source code, or undefined if no changes were made
- */
 module.exports = function transformAlignExperimentalUnstablePrefixes({
   source
 }, {

package/dist/render.js

@@ -1,8 +1,38 @@
 import * as readline from 'node:readline';
 import chalk from 'chalk';
+const gradientColors = ['#5ee7df', '#b490ca'];
+const hexToRgb = hex => {
+  const value = hex.replace('#', '');
+  const chunk = value.length === 3 ? value.split('').map(char => char + char) : value.match(/.{2}/g);
+  return chunk.map(part => parseInt(part, 16));
+};
+const interpolate = (start, end, t) => Math.round(start + (end - start) * t);
+const applyGradient = text => {
+  if (!text) {
+    return '';
+  }
+  const rgb = gradientColors.map(hexToRgb);
+  const maxIndex = text.length - 1 || 1;
+  const segmentCount = rgb.length - 1;
+  return text.split('').map((char, index) => {
+    const progress = index / maxIndex;
+    const segment = Math.min(Math.floor(progress * segmentCount), segmentCount - 1);
+    const localT = segmentCount === 0 ? 0 : progress * segmentCount - segment;
+    const [r1, g1, b1] = rgb[segment];
+    const [r2, g2, b2] = rgb[segment + 1] || rgb[segment];
+    const r = interpolate(r1, r2, localT);
+    const g = interpolate(g1, g2, localT);
+    const b = interpolate(b1, b2, localT);
+    return chalk.rgb(r, g, b)(char);
+  }).join('');
+};
 export function renderHeader() {
   console.log('');
-  console.log(chalk.magenta.bold('>> Clerk Upgrade CLI <<'));
+  const heading = [' █▀▀ █   █▀▀ █▀█ █▄▀   █ █ █▀█ █▀▀ █▀█ ▄▀█ █▀▄ █▀▀', ' █▄▄ █▄▄ ██▄ █▀▄ █ █   █▄█ █▀▀ █▄█ █▀▄ █▀█ █▄▀ ██▄'];
+  heading.forEach(line => console.log(applyGradient(line)));
+  console.log('');
+  console.log("Hello friend! We're excited to help you upgrade Clerk modules. Before we get started, a couple");
+  console.log('questions...');
   console.log('');
 }
 export function renderText(message, color) {

package/dist/runner.js

@@ -1,8 +1,8 @@
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import chalk from 'chalk';
-import { convertPathToPattern, globby } from 'globby';
 import indexToPosition from 'index-to-position';
+import { glob } from 'tinyglobby';
 import { getCodemodConfig, runCodemod } from './codemods/index.js';
 import { createSpinner, renderCodemodResults } from './render.js';
 const GLOBBY_IGNORE = ['node_modules/**', '**/node_modules/**', '.git/**', 'dist/**', '**/dist/**', 'build/**', '**/build/**', '.next/**', '**/.next/**', 'package.json', '**/package.json', 'package-lock.json', '**/package-lock.json', 'yarn.lock', '**/yarn.lock', 'pnpm-lock.yaml', '**/pnpm-lock.yaml', '**/*.{png,webp,svg,gif,jpg,jpeg}', '**/*.{mp4,mkv,wmv,m4v,mov,avi,flv,webm,flac,mka,m4a,aac,ogg}'];
@@ -11,11 +11,11 @@ export async function runCodemods(config, sdk, options) {
   if (codemods.length === 0) {
     return;
   }
-  const glob = typeof options.glob === 'string' ? options.glob.split(/[ ,]/).filter(Boolean) : options.glob;
+  const patterns = typeof options.glob === 'string' ? options.glob.split(/[ ,]/).filter(Boolean) : options.glob;
   for (const transform of codemods) {
     const spinner = createSpinner(`Running codemod: ${transform}`);
     try {
-      const result = await runCodemod(transform, glob, options);
+      const result = await runCodemod(transform, patterns, options);
       spinner.success(`Codemod applied: ${chalk.dim(transform)}`);
       renderCodemodResults(transform, result);
       const codemodConfig = getCodemodConfig(transform);
@@ -35,8 +35,10 @@ export async function runScans(config, sdk, options) {
   }
   const spinner = createSpinner('Scanning files for breaking changes...');
   try {
-    const pattern = convertPathToPattern(path.resolve(options.dir));
-    const files = await globby(pattern, {
+    const cwd = path.resolve(options.dir);
+    const files = await glob('**/*', {
+      cwd,
+      absolute: true,
       ignore: [...GLOBBY_IGNORE, ...(options.ignore || [])]
     });
     const results = {};

package/dist/versions/core-3/changes/after-switch-organization-url-removed.md

@@ -0,0 +1,14 @@
+---
+title: '`afterSwitchOrganizationUrl` removed from `OrganizationSwitcher`'
+matcher: 'afterSwitchOrganizationUrl'
+category: 'deprecation-removal'
+---
+
+The `afterSwitchOrganizationUrl` prop has been removed from `OrganizationSwitcher`. Use `afterSelectOrganizationUrl` instead:
+
+```diff
+<OrganizationSwitcher
+- afterSwitchOrganizationUrl="/org-dashboard"
++ afterSelectOrganizationUrl="/org-dashboard"
+/>
+```

package/dist/versions/core-3/changes/appearance-layout-to-options.md

@@ -0,0 +1,20 @@
+---
+title: '`appearance.layout` renamed to `appearance.options`'
+matcher: 'appearance[\\s\\S]*?\\.layout'
+matcherFlags: 'm'
+category: 'breaking'
+---
+
+The `appearance.layout` property has been renamed to `appearance.options`. Update all instances in your codebase:
+
+```diff
+<ClerkProvider
+  appearance={{
+-   layout: {
++   options: {
+      socialButtonsPlacement: 'bottom',
+      socialButtonsVariant: 'iconButton',
+    }
+  }}
+>
+```

package/dist/versions/core-3/changes/billing-props-removed.md

@@ -0,0 +1,14 @@
+---
+title: 'Unstable billing props removed'
+matcher:
+  - '__unstable_manageBillingUrl'
+  - '__unstable_manageBillingLabel'
+  - '__unstable_manageBillingMembersLimit'
+category: 'deprecation-removal'
+---
+
+The following unstable properties have been removed. If you were relying on these, please reach out to support.
+
+- `__unstable_manageBillingUrl`
+- `__unstable_manageBillingLabel`
+- `__unstable_manageBillingMembersLimit`

package/dist/versions/core-3/changes/checkout-api-changed.md

@@ -0,0 +1,35 @@
+---
+title: '`useCheckout` and `Clerk.checkout()` return value changed'
+matcher:
+  - 'useCheckout'
+  - 'Clerk\\.checkout'
+  - '\.checkout\('
+category: 'breaking'
+---
+
+The return values of `useCheckout` hook and `Clerk.checkout()` have been updated.
+
+### React Hook
+
+```diff
+- const { id, plan, status, start, confirm, paymentSource } = useCheckout({ planId: "xxx", planPeriod: "annual" });
++ const { checkout, errors, fetchStatus } = useCheckout({ planId: "xxx", planPeriod: "annual" });
++ // Access properties via checkout object
++ checkout.plan
++ checkout.status
++ checkout.start()
++ checkout.confirm()
+```
+
+### Vanilla JS
+
+```diff
+- const { getState, subscribe, confirm, start, clear, finalize } = Clerk.checkout({ planId: "xxx", planPeriod: "annual" });
+- getState().isStarting
+- getState().checkout
++ const { checkout, errors, fetchStatus } = Clerk.checkout({ planId: "xxx", planPeriod: "annual" });
++ checkout.plan
++ checkout.status
++ checkout.start()
++ checkout.confirm()
+```

package/dist/versions/core-3/changes/clerk-types-deprecation.md

@@ -0,0 +1,17 @@
+---
+title: '`@clerk/types` deprecated in favor of `@clerk/shared/types`'
+matcher: "from\\s+['\"]@clerk/types['\"]"
+category: 'deprecation'
+warning: true
+---
+
+The `@clerk/types` package is deprecated. All type definitions have been consolidated into `@clerk/shared/types`.
+
+Update your imports:
+
+```diff
+- import type { ClerkResource, UserResource } from '@clerk/types';
++ import type { ClerkResource, UserResource } from '@clerk/shared/types';
+```
+
+The `@clerk/types` package will continue to re-export types from `@clerk/shared/types` for backward compatibility, but new types will only be added to `@clerk/shared/types`.

package/dist/versions/core-3/changes/client-active-sessions-removed.md

@@ -0,0 +1,12 @@
+---
+title: '`Client.activeSessions` removed'
+matcher: '\\.activeSessions'
+category: 'deprecation-removal'
+---
+
+The `activeSessions` property has been removed from the `Client` object. Use `sessions` instead:
+
+```diff
+- const sessions = client.activeSessions;
++ const sessions = client.sessions;
+```

package/dist/versions/core-3/changes/color-ring-backdrop-opacity.md

@@ -0,0 +1,21 @@
+---
+title: '`colorRing` and `colorModalBackdrop` now render at full opacity'
+matcher:
+  - 'colorRing'
+  - 'colorModalBackdrop'
+category: 'breaking'
+warning: true
+---
+
+The `colorRing` and `colorModalBackdrop` CSS variables now render at full opacity when modified via the appearance prop or CSS variables. Previously, provided colors were rendered at 15% opacity.
+
+If you were relying on the previous behavior, you may need to adjust your color values to include the desired opacity:
+
+```diff
+appearance={{
+  variables: {
+-   colorRing: '#6366f1',
++   colorRing: 'rgba(99, 102, 241, 0.15)',
+  }
+}}
+```

package/dist/versions/core-3/changes/deprecated-redirect-props-removed.md

@@ -0,0 +1,29 @@
+---
+title: 'Legacy redirect props removed'
+matcher:
+  - 'afterSignInUrl'
+  - 'afterSignUpUrl'
+  - 'afterSignOutUrl'
+  - 'redirectUrl'
+category: 'deprecation-removal'
+---
+
+The legacy redirect props `afterSignInUrl`, `afterSignUpUrl`, and `redirectUrl` have been removed from components. Use the newer redirect options:
+
+```diff
+<SignIn
+- afterSignInUrl="/dashboard"
+- afterSignUpUrl="/onboarding"
++ fallbackRedirectUrl="/dashboard"
++ signUpFallbackRedirectUrl="/onboarding"
+/>
+```
+
+For forced redirects that ignore the `redirect_url` query parameter:
+
+```diff
+<SignIn
++ forceRedirectUrl="/dashboard"
++ signUpForceRedirectUrl="/onboarding"
+/>
+```

package/dist/versions/core-3/changes/experimental-prefix-aligned.md

@@ -0,0 +1,17 @@
+---
+title: 'Experimental method prefix standardized to `__experimental_`'
+matcher:
+  - 'experimental__'
+  - 'experimental_'
+category: 'breaking'
+---
+
+All experimental methods now use the `__experimental_` prefix consistently. Update any references:
+
+```diff
+- experimental__someMethod
++ __experimental_someMethod
+
+- experimental_someMethod
++ __experimental_someMethod
+```

package/dist/versions/core-3/changes/expo-min-version.md

@@ -0,0 +1,24 @@
+---
+title: 'Minimum Expo version increased to 53'
+packages: ['expo']
+matcher: "expo\":\\s*\"(?:^|~|>|=|\\s)*(?:50|51|52)\\..*?"
+matcherFlags: 'm'
+category: 'version'
+---
+
+Support for Expo 50, 51, and 52 has been dropped. Update your project to Expo 53 or later:
+
+```diff
+{
+  "dependencies": {
+-   "expo": "~52.0.0",
++   "expo": "~53.0.0",
+  }
+}
+```
+
+Run the Expo upgrade command:
+
+```bash
+npx expo install expo@latest
+```

package/dist/versions/core-3/changes/hide-slug-removed.md

@@ -0,0 +1,15 @@
+---
+title: '`hideSlug` prop removed'
+matcher: 'hideSlug'
+category: 'deprecation-removal'
+---
+
+The `hideSlug` prop has been removed. Organization slugs are now managed through the Clerk Dashboard under Organization Settings.
+
+```diff
+<OrganizationProfile
+- hideSlug={true}
+/>
+```
+
+To hide organization slugs, update your settings in the Clerk Dashboard → Organization Settings → Slug.

package/dist/versions/core-3/changes/min-node-version.md

@@ -0,0 +1,17 @@
+---
+title: 'Upgrade Node.js to v20.9.0 or higher'
+category: 'version'
+matcher: "engines\":\\s*{[\\s\\S]*?\"node\":\\s*\"(?:^|~|>|=|\\s)*(?:14|16|18)\\..*?"
+matcherFlags: 'm'
+---
+
+All Clerk packages now require Node.js 20.9.0 or later. Update your Node.js version and ensure your `package.json` engines field reflects this requirement.
+
+```diff
+{
+  "engines": {
+-   "node": ">=18.0.0"
++   "node": ">=20.9.0"
+  }
+}
+```

package/dist/versions/core-3/changes/nextjs-encryption-key-required.md

@@ -0,0 +1,17 @@
+---
+title: 'Encryption key required when passing `secretKey` at runtime'
+packages: ['nextjs']
+matcher: 'clerkMiddleware\([\\s\\S]*?secretKey'
+matcherFlags: 'm'
+category: 'breaking'
+---
+
+When passing `secretKey` as a runtime option to `clerkMiddleware()`, you must now also provide a `CLERK_ENCRYPTION_KEY` environment variable.
+
+Add the encryption key to your environment:
+
+```env
+CLERK_ENCRYPTION_KEY=your-encryption-key
+```
+
+More information: https://clerk.com/docs/reference/nextjs/clerk-middleware#dynamic-keys

package/dist/versions/core-3/changes/nuxt-getauth-removed.md

@@ -0,0 +1,21 @@
+---
+title: '`getAuth()` helper removed'
+packages: ['nuxt']
+matcher: 'getAuth\\('
+category: 'deprecation-removal'
+---
+
+The deprecated `getAuth()` helper has been removed. Use `event.context.auth()` in your server routes instead:
+
+```diff
+- import { getAuth } from '@clerk/nuxt/server';
+
+export default defineEventHandler((event) => {
+- const { userId } = getAuth(event);
++ const { userId } = event.context.auth();
+
+  return {
+    userId,
+  };
+});
+```

package/dist/versions/core-3/changes/nuxt-routing-strategy-default-path.md

@@ -0,0 +1,28 @@
+---
+title: 'Routing strategy now defaults to `path`'
+packages: ['nuxt']
+matcher:
+  - '<SignIn'
+  - '<SignUp'
+  - '<UserProfile'
+  - '<OrganizationProfile'
+  - '<CreateOrganization'
+  - '<OrganizationList'
+category: 'behavior-change'
+warning: true
+---
+
+The following components now default to `path` routing strategy instead of `hash`:
+
+- `<SignIn />`
+- `<SignUp />`
+- `<UserProfile />`
+- `<OrganizationProfile />`
+- `<CreateOrganization />`
+- `<OrganizationList />`
+
+If you were relying on the previous `hash` routing behavior, explicitly set the routing prop:
+
+```vue
+<SignIn routing="hash" />
+```

package/dist/versions/core-3/changes/saml-account-renamed.md

@@ -0,0 +1,15 @@
+---
+title: '`samlAccount` renamed to `enterpriseAccount`'
+matcher: 'samlAccount'
+category: 'deprecation-removal'
+---
+
+The `samlAccount` property has been renamed to `enterpriseAccount`. Update your code:
+
+```diff
+- user.samlAccounts
++ user.enterpriseAccounts
+
+- verification.samlAccount
++ verification.enterpriseAccount
+```

package/dist/versions/core-3/changes/saml-to-enterprise-sso.md

@@ -0,0 +1,12 @@
+---
+title: '`saml` strategy renamed to `enterprise_sso`'
+matcher: 'saml'
+category: 'deprecation-removal'
+---
+
+The `saml` authentication strategy has been renamed to `enterprise_sso`. Update any references in your code:
+
+```diff
+- strategy: 'saml'
++ strategy: 'enterprise_sso'
+```

package/dist/versions/core-3/changes/set-active-before-emit-removed.md

@@ -0,0 +1,22 @@
+---
+title: '`setActive({ beforeEmit })` changed to `setActive({ navigate })`'
+matcher: 'beforeEmit'
+category: 'deprecation-removal'
+---
+
+The `beforeEmit` callback in `setActive()` has been replaced with `navigate`. The callback signature has also changed:
+
+```diff
+await setActive({
+  session: sessionId,
+- beforeEmit: () => {
+-   // Called before session is set
+- }
++ navigate: ({ session }) => {
++   // Called with the session object
++   return '/dashboard';
++ }
+});
+```
+
+The `navigate` callback receives an object with the `session` property and should return the URL to navigate to.

package/dist/versions/core-3/changes/show-optional-fields-default.md

@@ -0,0 +1,20 @@
+---
+title: '`showOptionalFields` now defaults to `false`'
+matcher: 'showOptionalFields'
+category: 'behavior-change'
+warning: true
+---
+
+The default value of `appearance.layout.showOptionalFields` (now `appearance.options.showOptionalFields`) has changed from `true` to `false`. Optional fields are now hidden by default during sign up.
+
+To restore the previous behavior, explicitly set the option:
+
+```jsx
+<ClerkProvider
+  appearance={{
+    options: {
+      showOptionalFields: true,
+    }
+  }}
+>
+```

package/dist/versions/core-3/changes/ui-themes-export-path.md

@@ -0,0 +1,16 @@
+---
+title: 'UI themes moved to `@clerk/ui/themes/experimental`'
+matcher:
+  - '__experimental_createTheme'
+  - 'experimental_createTheme'
+category: 'breaking'
+---
+
+The `createTheme` theme utility has been moved to a new export path. Update your imports:
+
+```diff
+- import { __experimental_createTheme } from '@clerk/ui';
++ import { createTheme } from '@clerk/ui/themes/experimental';
+```
+
+Note: The `__experimental_` prefix has been removed from the method since they're now in the `/themes/experimental` subpath.

package/dist/versions/core-3/changes/unstable-to-internal.md

@@ -0,0 +1,25 @@
+---
+title: '`__unstable_*` methods renamed to `__internal_*`'
+matcher: '__unstable_'
+category: 'breaking'
+---
+
+All `__unstable_*` methods have been renamed to `__internal_*`. These are internal APIs not intended for public use.
+
+### @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`
+- `__unstable__onAfterSetActive` → `__internal_onAfterSetActive`
+
+### @clerk/nextjs
+
+- `__unstable_invokeMiddlewareOnAuthStateChange` → `__internal_invokeMiddlewareOnAuthStateChange`
+
+### @clerk/chrome-extension
+
+- `__unstable__createClerkClient` → `createClerkClient` (exported from `@clerk/chrome-extension/background`)

package/dist/versions/core-3/changes/user-settings-saml-renamed.md

@@ -0,0 +1,13 @@
+---
+title: '`UserSettings.saml` renamed to `enterpriseSSO`'
+matcher: 'UserSettings[\\s\\S]*?saml'
+matcherFlags: 'm'
+category: 'deprecation-removal'
+---
+
+The `saml` property on `UserSettings` has been renamed to `enterpriseSSO`:
+
+```diff
+- userSettings.saml
++ userSettings.enterpriseSSO
+```

package/dist/versions/core-3/changes/userbutton-signout-props-removed.md

@@ -0,0 +1,26 @@
+---
+title: '`UserButton` sign-out redirect props removed'
+matcher: '<UserButton[\\s\\S]*?(afterSignOutUrl|signOutUrl)[\\s\\S]*?>'
+matcherFlags: 'm'
+category: 'deprecation-removal'
+---
+
+The `UserButton` component no longer accepts sign-out redirect override props. Configure sign-out redirects using one of these methods:
+
+**Global configuration:**
+
+```jsx
+<ClerkProvider afterSignOutUrl="/signed-out">
+```
+
+**Per-button with SignOutButton:**
+
+```jsx
+<SignOutButton redirectUrl='/goodbye'>Sign Out</SignOutButton>
+```
+
+**Programmatic:**
+
+```js
+clerk.signOut({ redirectUrl: '/signed-out' });
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clerk/upgrade",
-  "version": "2.0.0-snapshot.v20251211120550",
+  "version": "2.0.0-snapshot.v20251215203425",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/clerk/javascript.git",
@@ -24,7 +24,6 @@
     "chalk": "^5.3.0",
     "ejs": "3.1.10",
     "execa": "9.4.1",
-    "globby": "^14.0.1",
     "gray-matter": "^4.0.3",
     "index-to-position": "^0.1.2",
     "jscodeshift": "^17.0.0",
@@ -32,7 +31,8 @@
     "meow": "^11.0.0",
     "read-pkg": "^9.0.1",
     "semver-regex": "^4.0.5",
-    "temp-dir": "^3.0.0"
+    "temp-dir": "^3.0.0",
+    "tinyglobby": "^0.2.15"
   },
   "devDependencies": {
     "@babel/cli": "^7.24.7",
@@ -51,6 +51,7 @@
     "dev": "babel --keep-file-extension --out-dir=dist --watch src --copy-files",
     "format": "node ../../scripts/format-package.mjs",
     "format:check": "node ../../scripts/format-package.mjs --check",
+    "generate-guide": "node scripts/generate-guide.js",
     "lint": "eslint src/",
     "lint:publint": "publint",
     "test": "vitest run",