A JavaScript library that resolves and dereferences references inside JSON Schemas, making it useful for preparing OpenAPI or Swagger-style schemas that use `$ref`. It lets you add schemas by id, list discovered references and dependencies, and produce a dereferenced schema via the `RefResolver` API.
Project status
- Maintenance status: The project shows a very recent upstream push (2026-08-07), which suggests ongoing work, but the most recent published updates shown are older (v3.0.0 on 2025-03-08), so maintenance appears somewhat intermittent from a release perspective.
- Update cadence: After v3.0.0 (2025-03-08), there is no newer version tag in the provided history, indicating sparse published updates (over ~17 months), despite recent commit activity in 2026.
AI summary generated
Recent updates
v3.0.0
v3.0.0 release notes describe repository automation updates: Dependabot update cadence, CI trigger branch support, and CI job permissions and node version coverage. The accompanying code diff confirms these changes, and shows a package.json version bump to 3.0.0.
v2.0.1
v2.0.1 primarily updates development and CI tooling (Node 22 in CI, neostandard and eslint configuration, c8 and neostandard version bumps, dependabot, funding/bugs metadata). It also tweaks error message wording and related documentation/test expectations.
v2.0.0
v2.0.0 modernizes the resolver implementation by switching equality logic from fast-deep-equal to dequal and adjusting schema dereferencing to handle cases where the root schema lacks a non-anchor $id. The release also declares explicit CommonJS module type in package.json and includes some workflow automation changes.
v1.0.1
v1.0.1 improves ref resolution error handling by throwing errors in cases where the target schema is missing or a ref cannot be resolved. It also enhances the error messages to be more informative for debugging resolution failures.
BreakingFeatures