Support alternative security scope groups

[nolannbiron]

Demo:

[linear]

RND-9168 Render OpenAPI OAuth scopes

[changeset-bot]

⚠️ No Changeset found

Latest commit: 8d31267

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-aub9h8ng3-gitbook.vercel.app	✅
Cloudflare	https://e4af0b14-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-aub9h8ng3-gitbook.vercel.app/url/gitbook.com/docs	https://e4af0b14-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-aub9h8ng3-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://e4af0b14-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.gitbook.io/test-gitbook-open

[argos-ci]

The latest updates on your projects. Learn more about Argos notifications ↗︎

Build	Status	Details	Updated (UTC)
customers-v2-cloudflare (Inspect)	✅ No changes detected	-	Mar 2, 2026, 11:10 AM
customers-v2-vercel (Inspect)	✅ No changes detected	-	Mar 2, 2026, 3:17 PM
v2-cloudflare (Inspect)	✅ No changes detected	-	Mar 2, 2026, 11:14 AM
v2-vercel (Inspect)	✅ No changes detected	-	Mar 2, 2026, 3:21 PM

[Copilot]

Pull request overview

Adds support for displaying multiple alternative required-scope sets for a single security scheme group (i.e., OR’d scope requirements), improving how OpenAPI security requirements are represented in the React OpenAPI UI.

Changes:

• Extend OperationSecurityInfo to carry scopeAlternatives and compute alternatives from securityRequirement entries.
• Deduplicate/merge scopes per security scheme key when resolving an operation’s securities.
• Update required-scopes UI (and CSS) to render multiple scope alternatives with an “or” separator.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 3 comments.

File	Description
packages/react-openapi/src/utils.ts	Groups security requirements and collects required-scope alternatives per security scheme group.
packages/react-openapi/src/resolveOpenAPIOperation.ts	Resolves securities into a map to dedupe entries and merges scopes across occurrences.
packages/react-openapi/src/OpenAPIRequiredScopes.tsx	Renders required scopes as a list of alternatives when multiple sets exist.
packages/gitbook/src/components/DocumentView/OpenAPI/style.css	Adds styling for the new scope-alternatives layout.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[gregberge]

Would be good to update GBX also.