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 particular [organization](docs/organizations/overview) or the [personal account](https://clerk.com/glossary#personal-account) based on path parameters in the URL. If a mismatch between the active organization on the session (e.g. as reported by [`auth()`](/docs/references/nextjs/auth)) and the organization as indicated by the URL is detected, an attempt to activate the given organization will be made.
+
+  ---
+
   - `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, refer to [Dynamic keys](#dynamic-keys).
 
   ---
 
-  - `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,79 @@ 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>
+
+  URL patterns that are organization-specific and contain 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` (matches a Clerk organization ID) or `:slug` (matches a Clerk
+  organization slug).
+
+  > [!WARNING]
+  > If the organization cannot be activated, either because it does not exist or the user lacks access,
+  > no change will be made to the previously active organization. Components must detect this case and respond with an
+  > appropriate error and/or resolution pathway (e.g., `notFound()` and an
+  > [organization switcher](/docs/components/organization/organization-switcher), etc.).
+
+  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](https://clerk.com/glossary#personal-account) (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` | ❌ |