Add organizationSyncOptions prop to clerkMiddleware() options

docs/references/nextjs/clerk-middleware.mdx

@@ -338,6 +338,13 @@ 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`
 
@@ -430,3 +437,75 @@ export default clerkMiddleware(
   },
 )
 ```
+
+### `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 used to set that org as active.
+
+  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 [`<OrganizationSwitcher />`](/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 matches 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` | ❌ |