# What changed in @scalar/api-reference-react

> 76 changes in @scalar/api-reference-react 0.8 to 0.9 from its official release notes, upgrade guides and advisories: 4 breaking, 14 new APIs and options. Each one cited. Sources checked 2026-11-13. HTML: https://unstale.sh/npm/@scalar/api-reference-react/

To see which of these apply to a repository, run `npx @unstale/cli init` in it.

## @scalar/api-reference-react 0.9

### Breaking changes

- The required Node.js version is now >=22 (LTS). (0.9.0) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#090)

### New APIs and options

- Adds x-order support. (0.9.6) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#096)
- A lazy bus queue helper is now exported. (0.9.3) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#093)
- MCP config support was added. (0.9.3) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#093)
- Support was added for operation level authentication. (0.9.1) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#091)
- Support was added for operation level servers. (0.9.1) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#091)

### Performance

- Added lazy rendering. (0.9.10) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0910)
- Compositions are lazy loaded. (0.9.6) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#096)

### Behavior and default changes

- Improved the Ask AI button's consistency and accessibility. (0.9.10) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0910)
- When documentDownloadType is direct, the rendered download link uses an <a> HTML tag. (0.9.6) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#096)

### Fixes and other changes

- Fixes a production crash in the React wrapper by defining Vue bundler flags before importing api-reference. (0.9.19) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0919)
- Fixed routing for hash-prefixed basePath values. (0.9.10) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0910)
- Fixed object schema descriptions in parameter rendering. (0.9.10) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0910)
- Fixes a build break caused by direct CSS imports in React, VitePress, and other environments. (0.9.9) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#099)
- Fixes document being undefined in SSR environments. (0.9.9) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#099)
- Fixes the default OAuth scope fallback. (0.9.9) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#099)
- The height of example response descriptions is limited. (0.9.7) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#097)
- The authentication panel is hidden when test requests are disabled. (0.9.3) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#093)
- The dev tools z index was increased for themes. (0.9.2) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#092)
- Schema composition components now have a consistent border. (0.9.2) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#092)

## @scalar/api-reference-react 0.8

### Breaking changes

- The default for createAnySecurityScheme is now false. (0.8.67) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0867)
- The agent tooltip was removed from the API reference. (0.8.44) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0844)
- The agent flag changes from enabled to disabled, allowing the agent to be enabled or disabled. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)

### New APIs and options

- Adds configuration to hide the search API. (0.8.64) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0864)
- Added an option to open the first tag by default. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- Added slugs for headings with nested content. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- Adds inline agent chat to the API reference. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)
- Adds agent Scalar to localhost. (0.8.37) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0837)
- The Auth component is now exported for use by developers. (0.8.24) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0824)
- Adds API client v2 integration through the updated @scalar/api-reference dependency. (0.8.18) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0819), [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0818)
- Supports rendering custom components for paths. (0.8.16) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0816)
- Adds code samples to client v2. (0.8.14) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0814)

### Behavior and default changes

- The API reference shows explicit no-content response tabs for defined response keys. (0.8.69) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0869)
- Description headings are nested in the sidebar. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- The schema type is now always shown. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- The sidebar stays scrolled near the top. (0.8.55) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0855)
- The ScalarCodeBlock copy UI was improved. (0.8.53) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0853)
- Uses getExample in reference responses. (0.8.37) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0837)
- Responses without content are hidden in the API reference. (0.8.31) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0831)
- Markdown now has a default line height. (0.8.23) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0823)
- Shows an empty schema message for an object with no properties. (0.8.16) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0816)
- The Scalar registry URL now uses “current” instead of “latest.” (0.8.4) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#084)

### Fixes and other changes

- The ref name is used only as a fallback. (0.8.70) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0870)
- An index clamp issue was fixed. (0.8.67) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0867)
- Fixes failure to find an ID when the browser is busy, improving lazy scrolling. (0.8.66) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0866)
- Corrected how the header is displayed in classic layout. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- Fixed the local storage migration script. (0.8.63) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0863)
- The document is no longer mutated after ingress. (0.8.57) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0857)
- The caret position changes to the right. (0.8.55) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0855)
- The client opens to the correct example name. (0.8.54) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0854)
- Inconsistent styles throughout api-reference were fixed. (0.8.53) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0853)
- The toolbar stacking context was reverted. (0.8.53) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0853)
- Uses flex-start instead of start for better browser support. (0.8.51) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0851)
- Fixes hideModels not applying correctly. (0.8.51) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0851)
- References are now correctly resolved and validated. (0.8.49) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0849)
- Fixed clickout close events. (0.8.45) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0845)
- Prevents already-ready items from being reprocessed, avoiding severe slowdowns for large API specs during scrolling or interaction. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)
- Sets a fallback for the mobile header sticky offset. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)
- Resolves OAuth2 relative URLs against relative server URLs. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)
- Applies the sidebar width variable. (0.8.41) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0841)
- The agent UI was made responsive. (0.8.38) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0838)
- Uploading a document no longer causes a UI jump. (0.8.38) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0838)
- Fixes handling of a custom header and sidebar. (0.8.37) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0837)
- Schema enum labels no longer flex, correcting their layout in the API reference. (0.8.35) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0835)
- Fixed the import and export of redirect to proxy. (0.8.34) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0834)
- Additional properties no longer generate an invalid example. (0.8.29) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0829)
- Auth is correctly restored from persistence. (0.8.29) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0829)
- Authentication is no longer persisted when the option is off. (0.8.28) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0828)
- Fixes search in the classic layout. (0.8.28) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0828)
- Fixes auth persistence. (0.8.26) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0826)
- Paths with trailing slashes are now allowed. (0.8.24) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0824)
- References now support nested arrays. (0.8.24) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0824)
- Path params now work on the client. (0.8.23) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0823)
- Reactive auth config is now passed to the client. (0.8.20) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0820)
- The button no longer appears when tags have no children. (0.8.16) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0816)
- Adds padding to the card intro in callbacks. (0.8.14) — [release notes](https://github.com/scalar/scalar/blob/a4c64675ab824e88810ecf1eb931e13b61c351e4/packages/api-reference-react/CHANGELOG.md#0814)