@speclynx/apidom-ns-json-schema-draft-7 3.2.1 → 4.0.1

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.1](https://github.com/speclynx/apidom/compare/v4.0.0...v4.0.1) (2026-03-11)
+
+**Note:** Version bump only for package @speclynx/apidom-ns-json-schema-draft-7
+
+# [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-draft-7

package/dist/apidom-ns-json-schema-draft-7.browser.js

@@ -22525,7 +22525,9 @@ class Path {
    *
    * @example
    * // For a path to $.paths['/pets'].get in an OpenAPI document:
+   * ```
    * path.getPathKeys(); // => ['paths', '/pets', 'get']
+   * ```
    */
   getPathKeys() {
     const keys = [];
@@ -22560,18 +22562,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();
@@ -22779,15 +22785,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);
       }
     }
   });
@@ -22812,7 +22818,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
  */
@@ -22837,7 +22843,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
@@ -22859,15 +22865,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();
       }
     }
@@ -22885,9 +22891,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
@@ -22896,7 +22900,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) => {
@@ -22904,15 +22908,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);
       }
     }
   });
@@ -22959,11 +22963,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);
 
@@ -22979,7 +22983,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-draft-7",
-  "version": "3.2.1",
+  "version": "4.0.1",
   "description": "JSON Schema Draft 7 namespace for ApiDOM.",
   "keywords": [
     "apidom",
@@ -57,11 +57,11 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "3.2.1",
-    "@speclynx/apidom-datamodel": "3.2.1",
-    "@speclynx/apidom-error": "3.2.1",
-    "@speclynx/apidom-ns-json-schema-draft-6": "3.2.1",
-    "@speclynx/apidom-traverse": "3.2.1",
+    "@speclynx/apidom-core": "4.0.1",
+    "@speclynx/apidom-datamodel": "4.0.1",
+    "@speclynx/apidom-error": "4.0.1",
+    "@speclynx/apidom-ns-json-schema-draft-6": "4.0.1",
+    "@speclynx/apidom-traverse": "4.0.1",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0",
     "ts-mixer": "^6.0.4"
@@ -76,5 +76,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "83a1e97089ef29134e41ff7cacd351973114ea5b"
+  "gitHead": "223132a9b00081ca04842efc2736a491f7876f44"
 }

package/src/elements/JSONSchema.cjs

@@ -1,122 +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-6");
-/**
- * @public
- */
-class JSONSchema extends _apidomNsJsonSchemaDraft.JSONSchemaElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'JSONSchemaDraft7';
-  }
-
-  /**
-   * Core vocabulary
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-01
-   */
-
-  get $comment() {
-    return this.get('$comment');
-  }
-  set $comment($comment) {
-    this.set('$comment', $comment);
-  }
-
-  /**
-   * Validation vocabulary
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01
-   */
-
-  /**
-   * Validation keywords for arrays
-   */
-
-  get itemsField() {
-    return this.get('items');
-  }
-  set itemsField(items) {
-    this.set('items', items);
-  }
-
-  /**
-   * Keywords for Applying Subschemas Conditionally
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-6.6
-   */
-
-  get if() {
-    return this.get('if');
-  }
-  set if(ifValue) {
-    this.set('if', ifValue);
-  }
-  get then() {
-    return this.get('then');
-  }
-  set then(then) {
-    this.set('then', then);
-  }
-  get else() {
-    return this.get('else');
-  }
-  set else(elseValue) {
-    this.set('else', elseValue);
-  }
-
-  /**
-   * Keywords for Applying Subschemas With Boolean Logic
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-6.7
-   */
-
-  get not() {
-    return this.get('not');
-  }
-  set not(not) {
-    this.set('not', not);
-  }
-
-  /**
-   * String-Encoding Non-JSON Data
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-00#section-8
-   */
-
-  get contentEncoding() {
-    return this.get('contentEncoding');
-  }
-  set contentEncoding(contentEncoding) {
-    this.set('contentEncoding', contentEncoding);
-  }
-  get contentMediaType() {
-    return this.get('contentMediaType');
-  }
-  set contentMediaType(contentMediaType) {
-    this.set('contentMediaType', contentMediaType);
-  }
-  get media() {
-    throw new _apidomError.UnsupportedOperationError('media keyword from Hyper-Schema vocabulary has been moved to validation vocabulary as "contentMediaType" / "contentEncoding"');
-  }
-  set media(_media) {
-    throw new _apidomError.UnsupportedOperationError('media keyword from Hyper-Schema vocabulary has been moved to validation vocabulary as "contentMediaType" / "contentEncoding"');
-  }
-
-  /**
-   * Schema annotations
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-10
-   */
-
-  get writeOnly() {
-    return this.get('writeOnly');
-  }
-  set writeOnly(writeOnly) {
-    this.set('writeOnly', writeOnly);
-  }
-}
-var _default = exports.default = JSONSchema;

package/src/elements/JSONSchema.mjs

@@ -1,119 +0,0 @@
-import { UnsupportedOperationError } from '@speclynx/apidom-error';
-import { JSONSchemaElement } from '@speclynx/apidom-ns-json-schema-draft-6';
-
-/**
- * @public
- */
-class JSONSchema extends JSONSchemaElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'JSONSchemaDraft7';
-  }
-
-  /**
-   * Core vocabulary
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-01
-   */
-
-  get $comment() {
-    return this.get('$comment');
-  }
-  set $comment($comment) {
-    this.set('$comment', $comment);
-  }
-
-  /**
-   * Validation vocabulary
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01
-   */
-
-  /**
-   * Validation keywords for arrays
-   */
-
-  get itemsField() {
-    return this.get('items');
-  }
-  set itemsField(items) {
-    this.set('items', items);
-  }
-
-  /**
-   * Keywords for Applying Subschemas Conditionally
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-6.6
-   */
-
-  get if() {
-    return this.get('if');
-  }
-  set if(ifValue) {
-    this.set('if', ifValue);
-  }
-  get then() {
-    return this.get('then');
-  }
-  set then(then) {
-    this.set('then', then);
-  }
-  get else() {
-    return this.get('else');
-  }
-  set else(elseValue) {
-    this.set('else', elseValue);
-  }
-
-  /**
-   * Keywords for Applying Subschemas With Boolean Logic
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-6.7
-   */
-
-  get not() {
-    return this.get('not');
-  }
-  set not(not) {
-    this.set('not', not);
-  }
-
-  /**
-   * String-Encoding Non-JSON Data
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-00#section-8
-   */
-
-  get contentEncoding() {
-    return this.get('contentEncoding');
-  }
-  set contentEncoding(contentEncoding) {
-    this.set('contentEncoding', contentEncoding);
-  }
-  get contentMediaType() {
-    return this.get('contentMediaType');
-  }
-  set contentMediaType(contentMediaType) {
-    this.set('contentMediaType', contentMediaType);
-  }
-  get media() {
-    throw new UnsupportedOperationError('media keyword from Hyper-Schema vocabulary has been moved to validation vocabulary as "contentMediaType" / "contentEncoding"');
-  }
-  set media(_media) {
-    throw new UnsupportedOperationError('media keyword from Hyper-Schema vocabulary has been moved to validation vocabulary as "contentMediaType" / "contentEncoding"');
-  }
-
-  /**
-   * Schema annotations
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-validation-01#section-10
-   */
-
-  get writeOnly() {
-    return this.get('writeOnly');
-  }
-  set writeOnly(writeOnly) {
-    this.set('writeOnly', writeOnly);
-  }
-}
-export default JSONSchema;

package/src/elements/LinkDescription.cjs

@@ -1,138 +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-6");
-/**
- * URI: https://datatracker.ietf.org/doc/html/draft-wright-json-schema-hyperschema-01#section-6
- * @public
- */
-
-class LinkDescription extends _apidomNsJsonSchemaDraft.LinkDescriptionElement {
-  /**
-   * Link context.
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-hyperschema-01#section-6.1
-   */
-
-  get anchor() {
-    return this.get('anchor');
-  }
-  set anchor(anchor) {
-    this.set('anchor', anchor);
-  }
-  get anchorPointer() {
-    return this.get('anchorPointer');
-  }
-  set anchorPointer(anchorPointer) {
-    this.set('anchorPointer', anchorPointer);
-  }
-
-  /**
-   * Adjusting URI Template Resolution.
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-hyperschema-01#section-6.4
-   */
-
-  get templatePointers() {
-    return this.get('templatePointers');
-  }
-  set templatePointers(templatePointers) {
-    this.set('templatePointers', templatePointers);
-  }
-  get templateRequired() {
-    return this.get('templateRequired');
-  }
-  set templateRequired(templateRequired) {
-    this.set('templateRequired', templateRequired);
-  }
-
-  /**
-   * Link Target Attributes.
-   *
-   * URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-hyperschema-01#section-6.5
-   */
-
-  get targetSchema() {
-    return this.get('targetSchema');
-  }
-  set targetSchema(targetSchema) {
-    this.set('targetSchema', targetSchema);
-  }
-  get mediaType() {
-    throw new _apidomError.UnsupportedOperationError('mediaType keyword from Hyper-Schema vocabulary has been renamed to targetMediaType.');
-  }
-  set mediaType(mediaType) {
-    throw new _apidomError.UnsupportedOperationError('mediaType keyword from Hyper-Schema vocabulary has been renamed to targetMediaType.');
-  }
-  get targetMediaType() {
-    return this.get('targetMediaType');
-  }
-  set targetMediaType(targetMediaType) {
-    this.set('targetMediaType', targetMediaType);
-  }
-  get targetHints() {
-    return this.get('targetHints');
-  }
-  set targetHints(targetHints) {
-    this.set('targetHints', targetHints);
-  }
-  get description() {
-    return this.get('description');
-  }
-  set description(description) {
-    this.set('description', description);
-  }
-  get $comment() {
-    return this.get('$comment');
-  }
-  set $comment($comment) {
-    this.set('$comment', $comment);
-  }
-
-  /**
-   *  Link Input.
-   *
-   *  URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-hyperschema-01#section-6.6
-   */
-
-  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);
-  }
-
-  /**
-   *  Submitting Data for Processing.
-   *
-   *  URI: https://datatracker.ietf.org/doc/html/draft-handrews-json-schema-hyperschema-01#section-6.6.4
-   */
-
-  get submissionSchema() {
-    return this.get('submissionSchema');
-  }
-  set submissionSchema(submissionSchema) {
-    this.set('submissionSchema', submissionSchema);
-  }
-  get submissionEncType() {
-    throw new _apidomError.UnsupportedOperationError('submissionEncType keyword from Hyper-Schema vocabulary has been renamed to submissionMediaType.');
-  }
-  set submissionEncType(submissionEncType) {
-    throw new _apidomError.UnsupportedOperationError('submissionEncType keyword from Hyper-Schema vocabulary has been renamed to submissionMediaType.');
-  }
-  get submissionMediaType() {
-    return this.get('submissionMediaType');
-  }
-  set submissionMediaType(submissionMediaType) {
-    this.set('submissionMediaType', submissionMediaType);
-  }
-}
-var _default = exports.default = LinkDescription;