Parse, resolve, and dereference JSON Schema `$ref` pointers in Node.js and web browsers. Useful for loading schemas that reference other local files, URLs, or mixed JSON and YAML, and for producing a fully resolved JavaScript object with dereferenced references.
Project status
- Upstream appears archived and development looks quiet, with the last upstream push on 2025-02-01 and the newest listed update (1.2.1) on 2023-10-24. This suggests the project is not actively evolving in 2026.
- Update cadence is low and irregular, with updates/releases in 2022-03, 2022-12, then 2023-10, and no clearly evidenced updates after that period.
AI summary generated
Recent updates
1.2.1
Release 1.2.1 is primarily a maintenance update, consisting of dependency bumps and CI workflow tweaks, plus a fix to error on invalid JSON Schema $ref pointers. The code change adds stricter validation in dereferencing so malformed fragment pointers now raise an InvalidPointerError instead of proceeding.
Breaking1.2.0
Release 1.2.0 primarily introduces a new $refs.circularRefs property to expose the locations of any circular $ref pointers discovered during dereferencing. In addition, it contains a large set of development dependency bumps (TypeScript, eslint, prettier, mocha, karma, and Node typings) plus CI/workflow related dependency updates.
Features1.1.0
This release focuses on correctness and compatibility improvements. It fixes YAML loading to only produce JSON-compatible types, and adds support for OpenAPI 3.1 style $ref override behavior.
Features