add change file

Author: jacekradko

.changeset/show-the-guards.md

@@ -3,8 +3,11 @@
 '@clerk/chrome-extension': major
 '@clerk/expo': major
 '@clerk/nextjs': major
+'@clerk/nuxt': major
 '@clerk/react': major
+'@clerk/react-router': major
 '@clerk/shared': minor
+'@clerk/tanstack-react-start': major
 '@clerk/vue': major
 ---
 

packages/upgrade/src/versions/core-3/changes/protect-signedin-signedout-replaced-by-show.md

@@ -0,0 +1,62 @@
+---
+title: '`Protect`, `SignedIn`, and `SignedOut` replaced by `Show`'
+matcher: '<(Protect|SignedIn|SignedOut)(\\s|>)'
+matcherFlags: 'm'
+category: 'breaking'
+---
+
+The authorization control components `Protect`, `SignedIn`, and `SignedOut` have been removed in favor of a single component: `Show`.
+
+### Signed in / signed out
+
+```diff
+-import { SignedIn, SignedOut } from '@clerk/react';
++import { Show } from '@clerk/react';
+
+-<SignedIn>
++<Show when="signedIn">
+ <Dashboard />
+-</SignedIn>
++</Show>
+
+-<SignedOut>
++<Show when="signedOut">
+ <SignIn />
+-</SignedOut>
++</Show>
+```
+
+### Authorization checks (roles/permissions/features/plans)
+
+```diff
+-import { Protect } from '@clerk/react';
++import { Show } from '@clerk/react';
+
+-<Protect role="admin" fallback={<p>Unauthorized</p>}>
++<Show when={{ role: 'admin' }} fallback={<p>Unauthorized</p>}>
+ <AdminPanel />
+-</Protect>
++</Show>
+
+-<Protect permission="org:billing:manage">
++<Show when={{ permission: 'org:billing:manage' }}>
+ <BillingSettings />
+-</Protect>
++</Show>
+```
+
+If you were using `condition={(has) => ...}` on `Protect`, pass that callback to `when`:
+
+```diff
+-<Protect condition={(has) => has({ role: 'admin' }) && isAllowed}>
++<Show when={(has) => has({ role: 'admin' }) && isAllowed}>
+ <AdminPanel />
+-</Protect>
++</Show>
+```
+
+To auto-migrate common patterns, run the upgrade CLI (includes a `transform-protect-to-show` codemod):
+
+```bash
+npx @clerk/upgrade --release core-3
+```

packages/upgrade/src/versions/core-3/index.js

@@ -19,5 +19,6 @@ export default {
  'transform-appearance-layout-to-options',
  'transform-themes-to-ui-themes',
  'transform-align-experimental-unstable-prefixes',
+ 'transform-protect-to-show',
  ],
 };