Fix OpenAPI alternatives not showing

[nolannbiron]

This pull request addresses an issue where OpenAPI alternatives were not displaying correctly. The main change involves reordering the rendering logic for OpenAPI schema properties to prioritize showing alternatives over properties, ensuring that alternatives are visible when present.

[linear]

RND-8296 OpenAPI not displaying oneOf subtypes

[changeset-bot]

🦋 Changeset detected

Latest commit: 23e26ac

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 2 packages

Name	Type
@gitbook/react-openapi	Patch
gitbook	Patch

Not sure what this means? Click here to learn what changesets are.

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

[Copilot]

Pull Request Overview

This pull request fixes an issue where OpenAPI alternatives were not being displayed due to incorrect rendering priority. The main change reorders the conditional logic in the OpenAPISchema component to ensure alternatives are checked and rendered before properties.

• Reordered rendering logic to prioritize alternatives over properties
• Added a minor CSS adjustment for the disclosure trigger label positioning

Reviewed Changes

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

File	Description
packages/react-openapi/src/OpenAPISchema.tsx	Moved the properties rendering logic after alternatives to fix display priority
packages/gitbook/src/components/DocumentView/OpenAPI/style.css	Adjusted right positioning for the disclosure trigger label
.changeset/unlucky-pumpkins-yawn.md	Added changeset documentation for the fix

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[github-actions]

Summary of the deployments:

Version	URL	Status
Vercel	https://gitbook-v2-pxn4d1yl5-gitbook.vercel.app	✅
Cloudflare	https://8318ad21-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	2v	2c
GitBook	https://gitbook-v2-pxn4d1yl5-gitbook.vercel.app/url/gitbook.com/docs	https://8318ad21-gitbook-open-v2-preview.gitbook.workers.dev/url/gitbook.com/docs
E2E	https://gitbook-v2-pxn4d1yl5-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://8318ad21-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 (Inspect)	👍 Changes approved	21 changed	Oct 3, 2025, 11:01 AM
v2-cloudflare (Inspect)	👍 Changes approved	21 changed	Oct 3, 2025, 11:05 AM
v2-vercel (Inspect)	👍 Changes approved	6 changed	Oct 3, 2025, 11:02 AM