Add organizationSyncOptions prop to clerkMiddleware() options

docs/references/nextjs/clerk-middleware.mdx

@@ -338,38 +338,45 @@ The `clerkMiddleware()` function accepts an optional object. The following optio
 
   ---
 
+  - `organizationSyncOptions?`
+  - <code>[OrganizationSyncOptions](#organization-sync-options) | undefined</code>
+
+  Used to activate a specific [organization](docs/organizations/overview) or [personal account](/docs/organizations/organization-workspaces#organization-workspaces-in-the-clerk-dashboard:~:text=Personal%20account) based on URL path parameters. If there's a mismatch between the active organization in the session (e.g., as reported by [`auth()`](/docs/references/nextjs/auth)) and the organization indicated by the URL, the middleware will attempt to activate the organization specified in the URL.
+
+  ---
+
   - `proxyUrl?`
   - `string`
 
   Specify the URL of the proxy, if using a proxy.
 
   ---
 
-  - `signInUrl?`
+  - `publishableKey`
   - `string`
 
-  An alternative sign in URL.
+  The Clerk publishable key for your instance. This can be found in your Clerk Dashboard on the [**API Keys**](https://dashboard.clerk.com/last-active?path=api-keys) page.
 
   ---
 
-  - `signUpUrl?`
+  - `secretKey?`
   - `string`
 
-  An alternative sign up URL.
+  The Clerk secret key for your instance. This can be found in your Clerk Dashboard on the **[API Keys](https://dashboard.clerk.com/last-active?path=api-keys)** page. The `CLERK_ENCRYPTION_KEY` environment variable must be set when providing `secretKey` as an option. For more information, refer to [Dynamic keys](#dynamic-keys) section.
 
   ---
 
-  - `publishableKey`
+  - `signInUrl?`
   - `string`
 
-  The Clerk publishable key for your instance. This can be found in your Clerk Dashboard on the **[API Keys](https://dashboard.clerk.com/last-active?path=api-keys)** page.
+  An alternative sign-in URL.
 
   ---
 
-  - `secretKey?`
+  - `signUpUrl?`
   - `string`
 
-  The Clerk secret key for your instance. This can be found in your Clerk Dashboard on the **[API Keys](https://dashboard.clerk.com/last-active?path=api-keys)** page. The `CLERK_ENCRYPTION_KEY` environment variable must be set when providing `secretKey` as an option, refer to [Dynamic keys](#dynamic-keys).
+  An alternative sign-up URL.
 </Properties>
 
 It's also possible to dynamically set options based on the incoming request:
@@ -430,3 +437,75 @@ export default clerkMiddleware(
 
 > [!NOTE]
 > Dynamic keys are not accessible on the client-side.
+
+### `OrganizationSyncOptions`
+
+The `organizationSyncOptions` property on the [`clerkMiddleware()`](#clerk-middleware-options) options
+object has the type `OrganizationSyncOptions`, which has the following properties:
+
+<Properties>
+  - `organizationPatterns`
+  - <code>[Pattern](#pattern)\[]</code>
+
+  Specifies URL patterns that are organization-specific, containing an organization ID or slug as a path parameter. If a request
+  matches this path, the organization identifier will be extracted and activated before rendering.
+
+  If the route also matches the `personalAccountPatterns` prop, this prop takes precedence.
+
+  Patterns must have a path parameter named either `:id` (to match a Clerk organization ID) or `:slug` (to match a Clerk organization slug).
+
+  > [!WARNING]
+  > If the organization can't be activated—either because it doesn't exist or the user lacks access—the previously active organization will remain unchanged. Components must detect this case and provide an appropriate error and/or resolution pathway, such as calling `notFound()` or displaying an [organization switcher](/docs/components/organization/organization-switcher).
+
+  Common examples:
+
+  - `["/orgs/:slug", "/orgs/:slug/(.*)"]`
+  - `["/orgs/:id", "/orgs/:id/(.*)"]`
+  - `["/app/:any/orgs/:slug", "/app/:any/orgs/:slug/(.*)"]`
+
+  ---
+
+  - `personalAccountPatterns`
+  - <code>[Pattern](#pattern)\[]</code>
+
+  URL patterns for resources that exist within the context of a [Clerk Personal Account](/docs/organizations/organization-workspaces#organization-workspaces-in-the-clerk-dashboard:~:text=Personal%20account) (user-specific, outside any
+  organization).
+
+  If the route also matches the `organizationPattern` prop, the `organizationPattern` prop takes precedence.
+
+  Common examples:
+
+  - `["/me", "/me/(.*)"]`
+  - `["/user/:any", "/user/:any/(.*)"]`
+</Properties>
+
+### Pattern
+
+A `Pattern` is a `string` that represents the structure of a URL path. In addition to any valid URL, it may include:
+
+- Named path parameters prefixed with a colon (e. g., `:id`, `:slug`, `:any`).
+- Wildcard token, `(.*)`, which will match the remainder of the path.
+
+#### Examples
+
+- `/orgs/:slug`
+
+| URL | Matches | `:slug` value |
+| - | - | - |
+| `/orgs/acmecorp` | ✅ | `acmecorp` |
+| `/orgs` | ❌ | n/a |
+| `/orgs/acmecorp/settings` | ❌ | n/a |
+
+- `/app/:any/orgs/:id`
+
+| URL | Matches | `:id` value |
+| - | - | - |
+| `/app/petstore/orgs/org_123` | ✅ | `org_123` |
+| `/app/dogstore/v2/orgs/org_123` | ❌ | n/a |
+
+- `/personal-account/(.*)`
+
+| URL | Matches |
+| - | - |
+| `/personal-account/settings` | ✅ |
+| `/personal-account` | ❌ |