@speclynx/apidom-ns-json-schema-2019-09 3.2.0 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,22 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.0.0](https://github.com/speclynx/apidom/compare/v3.2.1...v4.0.0) (2026-03-11)
+
+### Features
+
+- **traverse:** all traverse operations work on Path and not Element ([#153](https://github.com/speclynx/apidom/issues/153)) ([67d244c](https://github.com/speclynx/apidom/commit/67d244cfd3e77f6a9db704cede50ba8e45d10b11))
+
+### BREAKING CHANGES
+
+- **traverse:** This is a breaking change as operation callbacks
+  now accept Path instead of Element. By accepting Path, full
+  context of traversal is exposed to consumer instead of just Element.
+
+## [3.2.1](https://github.com/speclynx/apidom/compare/v3.2.0...v3.2.1) (2026-03-09)
+
+**Note:** Version bump only for package @speclynx/apidom-ns-json-schema-2019-09
+
 # [3.2.0](https://github.com/speclynx/apidom/compare/v3.1.0...v3.2.0) (2026-03-08)
 
 ### Features

package/dist/apidom-ns-json-schema-2019-09.browser.js

@@ -23407,7 +23407,9 @@ class Path {
    *
    * @example
    * // For a path to $.paths['/pets'].get in an OpenAPI document:
+   * ```
    * path.getPathKeys(); // => ['paths', '/pets', 'get']
+   * ```
    */
   getPathKeys() {
     const keys = [];
@@ -23442,18 +23444,22 @@ class Path {
    *          or Normalized JSONPath like "$['paths']['/pets']['get']['responses']['200']"
    *
    * @example
+   * ```
    * // JSON Pointer examples:
    * path.formatPath(); // "" (root)
    * path.formatPath(); // "/info"
    * path.formatPath(); // "/paths/~1pets/get"
    * path.formatPath(); // "/paths/~1users~1{id}/parameters/0"
+   * ```
    *
    * @example
+   * ```
    * // JSONPath examples:
    * path.formatPath('jsonpath'); // "$" (root)
    * path.formatPath('jsonpath'); // "$['info']"
    * path.formatPath('jsonpath'); // "$['paths']['/pets']['get']"
    * path.formatPath('jsonpath'); // "$['paths']['/users/{id}']['parameters'][0]"
+   * ```
    */
   formatPath(pathFormat = 'jsonpointer') {
     const parts = this.getPathKeys();
@@ -23661,15 +23667,15 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(2078);
 
 /**
- * Finds all elements matching the predicate.
+ * Finds all paths whose elements match the predicate.
  * @public
  */
 const filter = (element, predicate) => {
   const result = [];
   (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        result.push(path.node);
+      if (predicate(path)) {
+        result.push(path);
       }
     }
   });
@@ -23694,7 +23700,7 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 /**
- * Finds the most inner node at the given offset.
+ * Finds the path of the most inner node at the given offset.
  * If includeRightBound is set, also finds nodes that end at the given offset.
  * @public
  */
@@ -23719,7 +23725,7 @@ const findAtOffset = (element, options) => {
       const endOffset = node.endOffset;
       const isWithinOffsetRange = offset >= startOffset && (offset < endOffset || includeRightBound && offset <= endOffset);
       if (isWithinOffsetRange) {
-        result.push(node);
+        result.push(path);
         return; // push to stack and dive in
       }
       path.skip(); // skip entire sub-tree
@@ -23741,15 +23747,15 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(2078);
 
 /**
- * Find first element that satisfies the provided predicate.
+ * Finds first path whose element satisfies the provided predicate.
  * @public
  */
 const find = (element, predicate) => {
   let result;
   (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        result = path.node;
+      if (predicate(path)) {
+        result = path;
         path.stop();
       }
     }
@@ -23767,9 +23773,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5162);
-/* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(2078);
-
+/* harmony import */ var _traversal_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(2078);
 
 /**
  * @public
@@ -23778,7 +23782,7 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 /**
- * Executes the callback on this element and all descendants.
+ * Executes the callback on this element's path and all descendant paths.
  * @public
  */
 const forEach = (element, options) => {
@@ -23786,15 +23790,15 @@ const forEach = (element, options) => {
   let predicate;
   if (typeof options === 'function') {
     callback = options;
-    predicate = _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement;
+    predicate = () => true;
   } else {
     callback = options.callback ?? (() => {});
-    predicate = options.predicate ?? _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isElement;
+    predicate = options.predicate ?? (() => true);
   }
-  (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_1__.traverse)(element, {
+  (0,_traversal_mjs__WEBPACK_IMPORTED_MODULE_0__.traverse)(element, {
     enter(path) {
-      if (predicate(path.node)) {
-        callback(path.node);
+      if (predicate(path)) {
+        callback(path);
       }
     }
   });
@@ -23841,11 +23845,11 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _filter_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(5247);
 
 /**
- * Complement of filter. Finds all elements NOT matching the predicate.
+ * Complement of filter. Finds all paths whose elements do NOT match the predicate.
  * @public
  */
 const reject = (element, predicate) => {
-  return (0,_filter_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(element, el => !predicate(el));
+  return (0,_filter_mjs__WEBPACK_IMPORTED_MODULE_0__["default"])(element, path => !predicate(path));
 };
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (reject);
 
@@ -23861,7 +23865,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _find_mjs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(4860);
 
 /**
- * Tests whether at least one element passes the predicate.
+ * Tests whether at least one path's element passes the predicate.
  * @public
  */
 const some = (element, predicate) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-ns-json-schema-2019-09",
-  "version": "3.2.0",
+  "version": "4.0.0",
   "description": "JSON Schema 2019-09 namespace for ApiDOM.",
   "keywords": [
     "apidom",
@@ -57,12 +57,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "3.2.0",
-    "@speclynx/apidom-datamodel": "3.2.0",
-    "@speclynx/apidom-error": "3.2.0",
-    "@speclynx/apidom-ns-json-schema-draft-6": "3.2.0",
-    "@speclynx/apidom-ns-json-schema-draft-7": "3.2.0",
-    "@speclynx/apidom-traverse": "3.2.0",
+    "@speclynx/apidom-core": "4.0.0",
+    "@speclynx/apidom-datamodel": "4.0.0",
+    "@speclynx/apidom-error": "4.0.0",
+    "@speclynx/apidom-ns-json-schema-draft-6": "4.0.0",
+    "@speclynx/apidom-ns-json-schema-draft-7": "4.0.0",
+    "@speclynx/apidom-traverse": "4.0.0",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0",
     "ts-mixer": "^6.0.4"
@@ -77,5 +77,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "eeb2f01cd34fb0a95617f02bc1b6683aefc028f2"
+  "gitHead": "384ff82a1bb68d015fd6801de641898b4b582876"
 }

package/src/elements/JSONSchema.cjs

@@ -1,214 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomError = require("@speclynx/apidom-error");
-var _apidomNsJsonSchemaDraft = require("@speclynx/apidom-ns-json-schema-draft-7");
-/**
- * @public
- */
-class JSONSchema extends _apidomNsJsonSchemaDraft.JSONSchemaElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'JSONSchema201909';
-  }
-
-  /**
-   * Core vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/core
-   */
-
-  get $vocabulary() {
-    return this.get('$vocabulary');
-  }
-  set $vocabulary($vocabulary) {
-    this.set('$vocabulary', $vocabulary);
-  }
-  get $anchor() {
-    return this.get('$anchor');
-  }
-  set $anchor($anchor) {
-    this.set('$anchor', $anchor);
-  }
-  get $recursiveAnchor() {
-    return this.get('$recursiveAnchor');
-  }
-  set $recursiveAnchor($recursiveAnchor) {
-    this.set('$recursiveAnchor', $recursiveAnchor);
-  }
-  get $recursiveRef() {
-    return this.get('$recursiveRef');
-  }
-  set $recursiveRef($recursiveRef) {
-    this.set('$recursiveRef', $recursiveRef);
-  }
-  get $ref() {
-    return this.get('$ref');
-  }
-  set $ref($ref) {
-    this.set('$ref', $ref);
-  }
-  get $defs() {
-    return this.get('$defs');
-  }
-  set $defs($defs) {
-    this.set('$defs', $defs);
-  }
-  get definitions() {
-    throw new _apidomError.UnsupportedOperationError('definitions keyword from Validation vocabulary has been renamed to $defs.');
-  }
-  set definitions(_definitions) {
-    throw new _apidomError.UnsupportedOperationError('definitions keyword from Validation vocabulary has been renamed to $defs.');
-  }
-
-  /**
-   * Applicator vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/applicator
-   */
-
-  get not() {
-    return this.get('not');
-  }
-  set not(not) {
-    this.set('not', not);
-  }
-  get if() {
-    return this.get('if');
-  }
-  set if(ifSchema) {
-    this.set('if', ifSchema);
-  }
-  get then() {
-    return this.get('then');
-  }
-  set then(thenSchema) {
-    this.set('then', thenSchema);
-  }
-  get else() {
-    return this.get('else');
-  }
-  set else(elseSchema) {
-    this.set('else', elseSchema);
-  }
-  get dependentSchemas() {
-    return this.get('dependentSchemas');
-  }
-  set dependentSchemas(dependentSchemas) {
-    this.set('dependentSchemas', dependentSchemas);
-  }
-  get dependencies() {
-    throw new _apidomError.UnsupportedOperationError('dependencies keyword from Validation vocabulary has been renamed to dependentSchemas.');
-  }
-  set dependencies(_dependencies) {
-    throw new _apidomError.UnsupportedOperationError('dependencies keyword from Validation vocabulary has been renamed to dependentSchemas.');
-  }
-  get itemsField() {
-    return this.get('items');
-  }
-  set itemsField(items) {
-    this.set('items', items);
-  }
-  get contains() {
-    return this.get('contains');
-  }
-  set contains(contains) {
-    this.set('contains', contains);
-  }
-  get additionalProperties() {
-    return this.get('additionalProperties');
-  }
-  set additionalProperties(additionalProperties) {
-    this.set('additionalProperties', additionalProperties);
-  }
-  get additionalItems() {
-    return this.get('additionalItems');
-  }
-  set additionalItems(additionalItems) {
-    this.set('additionalItems', additionalItems);
-  }
-  get propertyNames() {
-    return this.get('propertyNames');
-  }
-  set propertyNames(propertyNames) {
-    this.set('propertyNames', propertyNames);
-  }
-  get unevaluatedItems() {
-    return this.get('unevaluatedItems');
-  }
-  set unevaluatedItems(unevaluatedItems) {
-    this.set('unevaluatedItems', unevaluatedItems);
-  }
-  get unevaluatedProperties() {
-    return this.get('unevaluatedProperties');
-  }
-  set unevaluatedProperties(unevaluatedProperties) {
-    this.set('unevaluatedProperties', unevaluatedProperties);
-  }
-
-  /**
-   * Validation vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/json-schema-validation#rfc.section.6
-   */
-
-  /**
-   * Validation Keywords for Arrays
-   *
-   * URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-validation-02#rfc.section.6.4
-   */
-
-  get maxContains() {
-    return this.get('maxContains');
-  }
-  set maxContains(maxContains) {
-    this.set('maxContains', maxContains);
-  }
-  get minContains() {
-    return this.get('minContains');
-  }
-  set minContains(minContains) {
-    this.set('minContains', minContains);
-  }
-
-  /**
-   * Validation Keywords for Objects
-   *
-   * URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-validation-02#rfc.section.6.5
-   */
-
-  get dependentRequired() {
-    return this.get('dependentRequired');
-  }
-  set dependentRequired(dependentRequired) {
-    this.set('dependentRequired', dependentRequired);
-  }
-
-  /**
-   * Vocabulary for Basic Meta-Data Annotations
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/meta-data
-   */
-
-  get deprecated() {
-    return this.get('deprecated');
-  }
-  set deprecated(deprecated) {
-    this.set('deprecated', deprecated);
-  }
-
-  /**
-   * Vocabulary for the Contents of String-Encoded Data
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/content
-   */
-
-  get contentSchema() {
-    return this.get('contentSchema');
-  }
-  set contentSchema(contentSchema) {
-    this.set('contentSchema', contentSchema);
-  }
-}
-var _default = exports.default = JSONSchema;

package/src/elements/JSONSchema.mjs

@@ -1,210 +0,0 @@
-import { UnsupportedOperationError } from '@speclynx/apidom-error';
-import { JSONSchemaElement } from '@speclynx/apidom-ns-json-schema-draft-7';
-/**
- * @public
- */
-class JSONSchema extends JSONSchemaElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'JSONSchema201909';
-  }
-
-  /**
-   * Core vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/core
-   */
-
-  get $vocabulary() {
-    return this.get('$vocabulary');
-  }
-  set $vocabulary($vocabulary) {
-    this.set('$vocabulary', $vocabulary);
-  }
-  get $anchor() {
-    return this.get('$anchor');
-  }
-  set $anchor($anchor) {
-    this.set('$anchor', $anchor);
-  }
-  get $recursiveAnchor() {
-    return this.get('$recursiveAnchor');
-  }
-  set $recursiveAnchor($recursiveAnchor) {
-    this.set('$recursiveAnchor', $recursiveAnchor);
-  }
-  get $recursiveRef() {
-    return this.get('$recursiveRef');
-  }
-  set $recursiveRef($recursiveRef) {
-    this.set('$recursiveRef', $recursiveRef);
-  }
-  get $ref() {
-    return this.get('$ref');
-  }
-  set $ref($ref) {
-    this.set('$ref', $ref);
-  }
-  get $defs() {
-    return this.get('$defs');
-  }
-  set $defs($defs) {
-    this.set('$defs', $defs);
-  }
-  get definitions() {
-    throw new UnsupportedOperationError('definitions keyword from Validation vocabulary has been renamed to $defs.');
-  }
-  set definitions(_definitions) {
-    throw new UnsupportedOperationError('definitions keyword from Validation vocabulary has been renamed to $defs.');
-  }
-
-  /**
-   * Applicator vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/applicator
-   */
-
-  get not() {
-    return this.get('not');
-  }
-  set not(not) {
-    this.set('not', not);
-  }
-  get if() {
-    return this.get('if');
-  }
-  set if(ifSchema) {
-    this.set('if', ifSchema);
-  }
-  get then() {
-    return this.get('then');
-  }
-  set then(thenSchema) {
-    this.set('then', thenSchema);
-  }
-  get else() {
-    return this.get('else');
-  }
-  set else(elseSchema) {
-    this.set('else', elseSchema);
-  }
-  get dependentSchemas() {
-    return this.get('dependentSchemas');
-  }
-  set dependentSchemas(dependentSchemas) {
-    this.set('dependentSchemas', dependentSchemas);
-  }
-  get dependencies() {
-    throw new UnsupportedOperationError('dependencies keyword from Validation vocabulary has been renamed to dependentSchemas.');
-  }
-  set dependencies(_dependencies) {
-    throw new UnsupportedOperationError('dependencies keyword from Validation vocabulary has been renamed to dependentSchemas.');
-  }
-  get itemsField() {
-    return this.get('items');
-  }
-  set itemsField(items) {
-    this.set('items', items);
-  }
-  get contains() {
-    return this.get('contains');
-  }
-  set contains(contains) {
-    this.set('contains', contains);
-  }
-  get additionalProperties() {
-    return this.get('additionalProperties');
-  }
-  set additionalProperties(additionalProperties) {
-    this.set('additionalProperties', additionalProperties);
-  }
-  get additionalItems() {
-    return this.get('additionalItems');
-  }
-  set additionalItems(additionalItems) {
-    this.set('additionalItems', additionalItems);
-  }
-  get propertyNames() {
-    return this.get('propertyNames');
-  }
-  set propertyNames(propertyNames) {
-    this.set('propertyNames', propertyNames);
-  }
-  get unevaluatedItems() {
-    return this.get('unevaluatedItems');
-  }
-  set unevaluatedItems(unevaluatedItems) {
-    this.set('unevaluatedItems', unevaluatedItems);
-  }
-  get unevaluatedProperties() {
-    return this.get('unevaluatedProperties');
-  }
-  set unevaluatedProperties(unevaluatedProperties) {
-    this.set('unevaluatedProperties', unevaluatedProperties);
-  }
-
-  /**
-   * Validation vocabulary
-   *
-   * URI: https://json-schema.org/draft/2019-09/json-schema-validation#rfc.section.6
-   */
-
-  /**
-   * Validation Keywords for Arrays
-   *
-   * URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-validation-02#rfc.section.6.4
-   */
-
-  get maxContains() {
-    return this.get('maxContains');
-  }
-  set maxContains(maxContains) {
-    this.set('maxContains', maxContains);
-  }
-  get minContains() {
-    return this.get('minContains');
-  }
-  set minContains(minContains) {
-    this.set('minContains', minContains);
-  }
-
-  /**
-   * Validation Keywords for Objects
-   *
-   * URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-validation-02#rfc.section.6.5
-   */
-
-  get dependentRequired() {
-    return this.get('dependentRequired');
-  }
-  set dependentRequired(dependentRequired) {
-    this.set('dependentRequired', dependentRequired);
-  }
-
-  /**
-   * Vocabulary for Basic Meta-Data Annotations
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/meta-data
-   */
-
-  get deprecated() {
-    return this.get('deprecated');
-  }
-  set deprecated(deprecated) {
-    this.set('deprecated', deprecated);
-  }
-
-  /**
-   * Vocabulary for the Contents of String-Encoded Data
-   *
-   * URI: https://json-schema.org/draft/2019-09/vocab/content
-   */
-
-  get contentSchema() {
-    return this.get('contentSchema');
-  }
-  set contentSchema(contentSchema) {
-    this.set('contentSchema', contentSchema);
-  }
-}
-export default JSONSchema;

package/src/elements/LinkDescription.cjs

@@ -1,53 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomNsJsonSchemaDraft = require("@speclynx/apidom-ns-json-schema-draft-7");
-/**
- * URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-hyperschema-02#rfc.section.6
- * @public
- */
-
-class LinkDescription extends _apidomNsJsonSchemaDraft.LinkDescriptionElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'linkDescription';
-  }
-
-  /**
-   *  Link Target Attributes.
-   *
-   *  URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-hyperschema-02#rfc.section.6.5
-   */
-  get targetSchema() {
-    return this.get('targetSchema');
-  }
-  set targetSchema(targetSchema) {
-    this.set('targetSchema', targetSchema);
-  }
-
-  /**
-   *  Link Input.
-   *
-   *  URI: https://json-schema.org/draft/2019-09/draft-handrews-json-schema-hyperschema-02#input
-   */
-  get hrefSchema() {
-    return this.get('hrefSchema');
-  }
-  set hrefSchema(hrefSchema) {
-    this.set('hrefSchema', hrefSchema);
-  }
-  get headerSchema() {
-    return this.get('headerSchema');
-  }
-  set headerSchema(headerSchema) {
-    this.set('headerSchema', headerSchema);
-  }
-  get submissionSchema() {
-    return this.get('submissionSchema');
-  }
-  set submissionSchema(submissionSchema) {
-    this.set('submissionSchema', submissionSchema);
-  }
-}
-var _default = exports.default = LinkDescription;