Restyle openapi blocks

[zenoachtig]

This PR makes a bunch of design tweaks and adds quality of life improvements to OpenAPI blocks and code blocks.

Cleaner layout for OpenAPI blocks (before, after)

• Less separators, bolder property names
• More consistent property titles (like in the response block)

Improved OpenAPI object accordions

• The entire property is clickable to reveal its child schema(s)
• Hovering over a property shows a button
• On mobile/non-hover devices the button is always shown

CleanShot.2025-04-23.at.12.49.40.mp4

New alternative separators

• Shown between alternative schemas (anyOf, allOf, oneOf)
• Use string translations for different languages

New color palette for code blocks (before, after)

• Uses site colors (primary, tint, and semantic colors) to style the code blocks
• Applies to both code blocks and OpenAPI panels

[changeset-bot]

🦋 Changeset detected

Latest commit: 7a6bb68

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	Minor
gitbook	Minor

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

[github-actions]

Summary of the deployments:

Version 1

Version	URL	Status
Latest commit	https://e008ef79.gitbook-open.pages.dev	✅
PR	https://pr3169.gitbook-open.pages.dev	✅

Version 2

Version	URL	Status
Vercel	https://gitbook-v2-2ptdkelv3-gitbook.vercel.app	✅
Cloudflare	https://8fcfa9b7-gitbook-open-v2-preview.gitbook.workers.dev	✅

Test content

Site	v1	2v	2c
GitBook	https://e008ef79.gitbook-open.pages.dev/docs.gitbook.com	https://gitbook-v2-2ptdkelv3-gitbook.vercel.app/url/docs.gitbook.com	https://8fcfa9b7-gitbook-open-v2-preview.gitbook.workers.dev/url/docs.gitbook.com
E2E	https://e008ef79.gitbook-open.pages.dev/gitbook.gitbook.io/test-gitbook-open	https://gitbook-v2-2ptdkelv3-gitbook.vercel.app/url/gitbook.gitbook.io/test-gitbook-open	https://8fcfa9b7-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-v1 (Inspect)	👍 Changes approved	4 changed	Apr 24, 2025, 1:47 PM
customers-v2 (Inspect)	👍 Changes approved	85 changed	Apr 24, 2025, 1:51 PM
default (Inspect)	👍 Changes approved	25 changed	Apr 24, 2025, 1:50 PM
v2-vercel (Inspect)	👍 Changes approved	26 changed	Apr 24, 2025, 1:52 PM