Changelog

v0.7.0 (2026-05-23)

Add JSONSchex.compile_fragment/2 and JSONSchex.Schema.compile_fragment!/2 for compiling JSON Schema fragments while preserving the containing document as the local reference context, useful for OpenAPI 3.1 schemas under paths and components. Fragment entrypoints support exactly one of :entry_pointer or :entry_ref, with :entry_ref providing a base URI/path when :base_uri is omitted
Add JSONSchex.bundle_fragment/2 for producing standalone raw schemas from document fragments, including reachable external resources mounted under $defs
Add JSONSchex.Ref.resolve_selected/2 for selector-driven $ref resolution in JSON-like documents, allowing callers such as OpenAPI tooling to choose which $ref nodes are replaced while preserving unselected refs
Breaking change: rename the remote/reference loading option from :external_loader to :loader

Add first-class support for compiling static JSON Schema literals during module compilation via JSONSchex.Schema.compile!/2 and the ~X sigil in JSONSchex.Sigil
Refactor validation and compiled rule execution to support static compile-time embedding by making rules data-driven and dispatching them through JSONSchex.Validator.Rules
Precompute legacy dependencies execution modes during compilation and simplify runtime rule matching
Prune several compile-time no-op keyword rules such as empty required, properties, patternProperties, dependentRequired, dependentSchemas, and prefixItems
Relax decimal dependency requirement

Embed the Draft 2020-12 built-in meta-schema family directly in code and cache compiled built-in defs for $ref and $dynamicRef resolution
Refactor built-in Draft 2020-12 support into draft-specific modules: JSONSchex.Draft202012.Schemas, JSONSchex.Draft202012.Vocabulary, and JSONSchex.Draft202012.Dialect
Simplify and de-duplicate reference resolution logic, including URI fragment handling and loaded-schema validation flow
Fix built-in meta-schema validation so schemas can be validated against the canonical Draft 2020-12 meta-schema without an external loader
Update official test suite, and adapt to pass the official Draft 2020-12 optional format cases for duration, time, and uri:
- Tighten duration format validation to match the RFC 3339 Appendix A grammar used by the official Draft 2020-12 optional format suite
- Accept RFC 3339 time values with unknown local offset (-00:00)
- Tighten uri and uri-reference format validation to reject invalid percent-encoding triplets

Fixed an issue where $ref could cause an infinite loop during validation
Refactor compile-time and validation-time failures to use the unified JSONSchex.Types.Error model with structured ErrorContext
Improve error formatting so invalid keyword and compile errors produce clearer, more contextual messages
Treat the canonical Draft 2020-12 meta-schema as a built-in dialect without requiring a loader, while still honoring explicit $vocabulary declarations
Split vocabulary handling between supported vocabularies and the built-in Draft 2020-12 default active vocabulary set
Optimize local $ref compilation by batching JSON Pointer resolution for explicit local fragment references
Improve scope scanning so $id, anchors, and explicit local fragment refs are registered more consistently
Consolidate time format validation into the date-time format implementation