npm / @scalar/api-reference-react
@scalar/api-reference-react
What changed in @scalar/api-reference-react 0.8 to 0.9, from its official release notes, upgrade guides and advisories. Sources checked 2026-11-13.
4 breaking14 new APIs and options2 performance12 behavior and defaults44 fixes and other
See which of these apply to your code, ranked, in your agent:
npx @unstale/cli init@scalar/api-reference-react 0.920 changes
Breaking changes 1
The required Node.js version is now >=22 (LTS).
New APIs and options 5
Adds x-order support.
A lazy bus queue helper is now exported.
MCP config support was added.
Support was added for operation level authentication.
Support was added for operation level servers.
Performance 2
Added lazy rendering.
Compositions are lazy loaded.
Behavior and default changes 2
Improved the Ask AI button's consistency and accessibility.
When documentDownloadType is direct, the rendered download link uses an <a> HTML tag.
Fixes and other changes 10
Fixes a production crash in the React wrapper by defining Vue bundler flags before importing api-reference.
Fixed routing for hash-prefixed basePath values.
Fixed object schema descriptions in parameter rendering.
Fixes a build break caused by direct CSS imports in React, VitePress, and other environments.
Fixes document being undefined in SSR environments.
Fixes the default OAuth scope fallback.
The height of example response descriptions is limited.
The authentication panel is hidden when test requests are disabled.
The dev tools z index was increased for themes.
Schema composition components now have a consistent border.
@scalar/api-reference-react 0.856 changes
Breaking changes 3
The default for createAnySecurityScheme is now false.
The agent tooltip was removed from the API reference.
The agent flag changes from enabled to disabled, allowing the agent to be enabled or disabled.
New APIs and options 9
Adds configuration to hide the search API.
Added an option to open the first tag by default.
Added slugs for headings with nested content.
Adds inline agent chat to the API reference.
Adds agent Scalar to localhost.
The Auth component is now exported for use by developers.
Adds API client v2 integration through the updated @scalar/api-reference dependency.
Supports rendering custom components for paths.
Adds code samples to client v2.
Behavior and default changes 10
The API reference shows explicit no-content response tabs for defined response keys.
Description headings are nested in the sidebar.
The schema type is now always shown.
The sidebar stays scrolled near the top.
The ScalarCodeBlock copy UI was improved.
Uses getExample in reference responses.
Responses without content are hidden in the API reference.
Markdown now has a default line height.
Shows an empty schema message for an object with no properties.
The Scalar registry URL now uses “current” instead of “latest.”
Fixes and other changes 34
The ref name is used only as a fallback.
An index clamp issue was fixed.
Fixes failure to find an ID when the browser is busy, improving lazy scrolling.
Corrected how the header is displayed in classic layout.
Fixed the local storage migration script.
The document is no longer mutated after ingress.
The caret position changes to the right.
The client opens to the correct example name.
Inconsistent styles throughout api-reference were fixed.
The toolbar stacking context was reverted.
Uses flex-start instead of start for better browser support.
Fixes hideModels not applying correctly.
References are now correctly resolved and validated.
Fixed clickout close events.
Prevents already-ready items from being reprocessed, avoiding severe slowdowns for large API specs during scrolling or interaction.
Sets a fallback for the mobile header sticky offset.
Resolves OAuth2 relative URLs against relative server URLs.
Applies the sidebar width variable.
The agent UI was made responsive.
Uploading a document no longer causes a UI jump.
Fixes handling of a custom header and sidebar.
Schema enum labels no longer flex, correcting their layout in the API reference.
Fixed the import and export of redirect to proxy.
Additional properties no longer generate an invalid example.
Auth is correctly restored from persistence.
Authentication is no longer persisted when the option is off.
Fixes search in the classic layout.
Fixes auth persistence.
Paths with trailing slashes are now allowed.
References now support nested arrays.
Path params now work on the client.
Reactive auth config is now passed to the client.
The button no longer appears when tags have no children.
Adds padding to the card intro in callbacks.