NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm
modern OpenAPI parser written in TypeScript
Last release 2 days ago
12 Oct 2026
Ships on a steady schedule
a new release about every 2 weeks
Most releases are documented
notes for 37 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
3 years old
141 releases · first in 2024
### Patch Changes - #10559: Clean up Biome warnings in package code and tests. Handle rejected debounced callbacks and await streaming writes. - #1050
### Patch Changes - #10489: Report invalid non-exploded structured cookies in OpenAPI 3.2 documents and prevent invalid request and code sample genera
style: cookie with explode: true.One column per month.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #10274: Add a standard-agnostic join utility with configurable merge strategies and conflict reporting to @scalar/json-magic/join.
join utility with configurable merge strategies and conflict reporting to @scalar/json-magic/join. Use it in the OpenAPI parser while retaining OpenAPI upgrades, component prefixes, and OpenAPI conflict reports in the parser.Nothing published for this version
### Patch Changes - #10216: Allow more time for parser comparison tests on slower CI runners.
Narrow DOM elements and caught errors before accessing their properties. Correct header lookup to include missing values and handle them during PowerS
#10202: Explain invalid URI references and OpenAPI component names, and return parser errors for malformed reference escapes.
#10113: Ignore unsafe component keys and check own properties when joining API descriptions.
#10141: Report the actual document version after upgrading, including preserved OpenAPI 3.2 documents. Return no version for empty or unsupported input.
#10136: Restore modal and single-file reference tests, update layout selectors, and remove stale comments. Named-resource resolution remains unsupported and is tested explicitly.
#10140: Replace redundant type assertions with compiler-checked annotations, typed accumulators, and existing guards across helpers, API conversion, request handling, and schema rendering.
Narrow DOM elements and caught errors before accessing their properties. Correct header lookup to include missing values and handle them during PowerShell snippet generation.
Validate release-note provider responses, represent unresolved references and absent groups in helper return types, and require narrowing merged object values. Preserve AsyncAPI broker credentials separately from HTTP authentication schemes.
The generic AnyObject and UnknownObject types are no longer re-exported from @scalar/openapi-parser. Import them from @scalar/types/utils instead.
#10078: Guard mergeObjects (used by join) against prototype pollution, so a __proto__, constructor, or prototype key in an input document can no longer reach Object.prototype
#9990: Fix @scalar/types leaking into the published type declarations. @scalar/openapi-parser referenced @scalar/types from its .d.ts files while only depending on it as a devDependency, so consumers hit TS2307 (cannot find module). @scalar/types is now a regular dependency, and the package uses the shared UnknownObject and AnyObject utility types from @scalar/types/utils directly instead of defining its own local copies (AnyObject was added to @scalar/types/utils alongside the existing UnknownObject).
The generic AnyObject and UnknownObject types are no longer re-exported from @scalar/openapi-parser. Import them from @scalar/types/utils instead.
Two type-level changes in @scalar/openapi-parser are worth noting:
#9967: Add a new @scalar/openapi-validator package that validates OpenAPI documents on its own. @scalar/openapi-parser now uses it under the hood.
Two type-level changes in @scalar/openapi-parser are worth noting:
ErrorObject.path is now string | string[] instead of string[]. Schema errors carry a JSON Pointer string, semantic errors carry path segments — both shapes were already produced at runtime, the type just says so now. Narrow with Array.isArray before treating it as a list.ValidationOutcome type and the internal OpenApiDocument alias are no longer exported.### Patch Changes - #9941: Republish every package through npm trusted publishing. No functional changes.
Nothing published for this version
### Patch Changes - #9838: Show a clearer error when a response is missing its description. Before, the validator reported the confusing must have req
description. Before, the
validator reported the confusing must have required property '$ref' (or
oneOf must match exactly one schema in oneOf) instead of pointing at the
actual problem.Nothing published for this version
Nothing published for this version
### Patch Changes - #9719: docs: update the Scalar platform overview block in the README
### Patch Changes - #9710: Republish so the updated README (with the Scalar platform overview) reaches npm. Also renames the README generator metadata
readme to scalarReadme: npm treats a readme field as the readme text itself, so affected packages were published with a literal [object Object] readme on the registry instead of README.md.Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Minor Changes - #9045: refactor: adopt strict versioned @scalar/openapi-types imports in parser types
### Minor Changes - #8965: refactor: adopt strict versioned @scalar/openapi-types imports in parser types
Nothing published for this version
### Minor Changes - #8935: feat: pass resolved object to onDereference callback
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
### Patch Changes - #8579: feat(openapi-parser): improve format validation error messages for $ref with non-ASCII characters
Nothing published for this version
### Patch Changes - #8520: Normalize trailing + in path template parameter names during path-parameter validation so {name+} matches a declared name p
+ in path template parameter names during path-parameter validation so {name+} matches a declared name path parameter.### Patch Changes - #8466: chore: new build pipeline
### Patch Changes - #8448: fix parser validation for unused path parameters
### Patch Changes #### Updated Dependencies - @scalar/helpers@0.4.1 - #8420: fix TypeScript access to navigator.userAgentData in isMacOS without ts-ex
@scalar/helpers@0.4.1
@scalar/json-magic@0.12.3
@scalar/openapi-upgrader@0.2.0
### Patch Changes - #8359: fix(openapi-parser): replace $dynamicRef with $ref in v3.2 schema for AJV compatibility #### Updated Dependencies - @scalar
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.12.1 - #8357: chore: improve performance and memory usage of bundler
### Minor Changes - #8322: chore: bump required node version to >=22 (LTS) ### Patch Changes #### Updated Dependencies - @scalar/openapi-upgrader@0.2.
@scalar/openapi-upgrader@0.2.0
@scalar/openapi-types@0.6.0
@scalar/json-magic@0.12.0
@scalar/helpers@0.3.0
@scalar/openapi-upgrader@0.1.11
@scalar/openapi-types@0.5.4
$ref property in the ReferenceObject type required@scalar/openapi-upgrader@0.1.11
@scalar/json-magic@0.11.7
@scalar/helpers@0.2.18
@scalar/openapi-upgrader@0.1.10
### Patch Changes #### Updated Dependencies - @scalar/openapi-upgrader@0.1.9 - #8251: feat: migrate swagger 2.0 defaults for parameter
### Patch Changes #### Updated Dependencies - @scalar/helpers@0.2.16 - #8248: fix: local storage migration script - @scalar/json-magic@0.11.5 - @scala
@scalar/helpers@0.2.16
@scalar/json-magic@0.11.5
@scalar/openapi-upgrader@0.1.8
### Patch Changes #### Updated Dependencies - @scalar/helpers@0.2.15 - #8212: chore: version bump - @scalar/json-magic@0.11.4 - #8212: chore: version
### Patch Changes #### Updated Dependencies - @scalar/helpers@0.2.12 - #8178: chore: package bump due to ci failure - @scalar/json-magic@0.11.1 - @sca
@scalar/helpers@0.2.12
@scalar/json-magic@0.11.1
@scalar/openapi-upgrader@0.1.8
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.11.0 - #8095: feat: support loading files into the store - #8096: feat: store relat
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.10.0 - #8052: feat: allow custom LoaderPlugin plugins in dereference
### Patch Changes #### Updated Dependencies - @scalar/helpers@0.2.11 - #8016: feat: move history and auth into their own store - @scalar/json-magic@0.
@scalar/helpers@0.2.11
@scalar/json-magic@0.9.6
@scalar/openapi-upgrader@0.1.8
### Patch Changes - #7963: feat: unify is-object helpers #### Updated Dependencies - @scalar/json-magic@0.9.5 - #7963: feat: unify is-object helpers -
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.9.4 - #7922: fix: resolve $ref entries inside arrays (e.g. oneOf, allOf) in prefixI
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.9.3 - @scalar/openapi-upgrader@0.1.8
@scalar/json-magic@0.9.3
@scalar/openapi-upgrader@0.1.8
### Patch Changes #### Updated Dependencies - @scalar/openapi-upgrader@0.1.8 - #7842: feat: migrate swagger 2.0 responses
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.9.2 - #7763: fix: correctly execute onAfterNodeProcess for ref nodes
### Patch Changes #### Updated Dependencies - @scalar/json-magic@0.9.1 - @scalar/openapi-upgrader@0.1.7
@scalar/json-magic@0.9.1
@scalar/openapi-upgrader@0.1.7
Your coding agent can read these notes before it upgrades. Set up the MCP server →