@speclynx/apidom-ns-arazzo-1 3.2.1 → 4.0.0

package/CHANGELOG.md

@@ -3,6 +3,18 @@
 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-arazzo-1

package/dist/apidom-ns-arazzo-1.browser.js

@@ -27712,7 +27712,9 @@ class Path {
    *
    * @example
    * // For a path to $.paths['/pets'].get in an OpenAPI document:
+   * ```
    * path.getPathKeys(); // => ['paths', '/pets', 'get']
+   * ```
    */
   getPathKeys() {
     const keys = [];
@@ -27747,18 +27749,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();
@@ -27966,15 +27972,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);
       }
     }
   });
@@ -27999,7 +28005,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
  */
@@ -28024,7 +28030,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
@@ -28046,15 +28052,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();
       }
     }
@@ -28072,9 +28078,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
@@ -28083,7 +28087,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) => {
@@ -28091,15 +28095,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);
       }
     }
   });
@@ -28146,11 +28150,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);
 
@@ -28166,7 +28170,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-arazzo-1",
-  "version": "3.2.1",
+  "version": "4.0.0",
   "description": "Arazzo Specification 1.0.1 namespace for ApiDOM.",
   "keywords": [
     "apidom",
@@ -58,10 +58,10 @@
   "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-ns-json-schema-2020-12": "3.2.1",
-    "@speclynx/apidom-traverse": "3.2.1",
+    "@speclynx/apidom-core": "4.0.0",
+    "@speclynx/apidom-datamodel": "4.0.0",
+    "@speclynx/apidom-ns-json-schema-2020-12": "4.0.0",
+    "@speclynx/apidom-traverse": "4.0.0",
     "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": "384ff82a1bb68d015fd6801de641898b4b582876"
 }

package/src/elements/Arazzo.cjs

@@ -1,17 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class Arazzo extends _apidomDatamodel.StringElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'arazzo';
-    this.classes.push('spec-version');
-    this.classes.push('version');
-  }
-}
-var _default = exports.default = Arazzo;

package/src/elements/Arazzo.mjs

@@ -1,14 +0,0 @@
-import { StringElement } from '@speclynx/apidom-datamodel';
-
-/**
- * @public
- */
-class Arazzo extends StringElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'arazzo';
-    this.classes.push('spec-version');
-    this.classes.push('version');
-  }
-}
-export default Arazzo;

package/src/elements/ArazzoSpecification1.cjs

@@ -1,46 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class ArazzoSpecification1 extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'arazzoSpecification1';
-    this.classes.push('api');
-  }
-  get arazzo() {
-    return this.get('arazzo');
-  }
-  set arazzo(arazzo) {
-    this.set('arazzo', arazzo);
-  }
-  get info() {
-    return this.get('info');
-  }
-  set info(info) {
-    this.set('info', info);
-  }
-  get sourceDescriptions() {
-    return this.get('sourceDescriptions');
-  }
-  set sourceDescriptions(sourceDescriptions) {
-    this.set('sourceDescriptions', sourceDescriptions);
-  }
-  get workflows() {
-    return this.get('workflows');
-  }
-  set workflows(workflows) {
-    this.set('workflows', workflows);
-  }
-  get components() {
-    return this.get('components');
-  }
-  set components(components) {
-    this.set('components', components);
-  }
-}
-var _default = exports.default = ArazzoSpecification1;

package/src/elements/ArazzoSpecification1.mjs

@@ -1,42 +0,0 @@
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-/**
- * @public
- */
-class ArazzoSpecification1 extends ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'arazzoSpecification1';
-    this.classes.push('api');
-  }
-  get arazzo() {
-    return this.get('arazzo');
-  }
-  set arazzo(arazzo) {
-    this.set('arazzo', arazzo);
-  }
-  get info() {
-    return this.get('info');
-  }
-  set info(info) {
-    this.set('info', info);
-  }
-  get sourceDescriptions() {
-    return this.get('sourceDescriptions');
-  }
-  set sourceDescriptions(sourceDescriptions) {
-    this.set('sourceDescriptions', sourceDescriptions);
-  }
-  get workflows() {
-    return this.get('workflows');
-  }
-  set workflows(workflows) {
-    this.set('workflows', workflows);
-  }
-  get components() {
-    return this.get('components');
-  }
-  set components(components) {
-    this.set('components', components);
-  }
-}
-export default ArazzoSpecification1;

package/src/elements/Components.cjs

@@ -1,39 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class Components extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'components';
-  }
-  get inputs() {
-    return this.get('inputs');
-  }
-  set inputs(inputs) {
-    this.set('inputs', inputs);
-  }
-  get parameters() {
-    return this.get('parameters');
-  }
-  set parameters(parameters) {
-    this.set('parameters', parameters);
-  }
-  get successActions() {
-    return this.get('successActions');
-  }
-  set successActions(successActions) {
-    this.set('successActions', successActions);
-  }
-  get failureActions() {
-    return this.get('failureActions');
-  }
-  set failureActions(failureActions) {
-    this.set('failureActions', failureActions);
-  }
-}
-var _default = exports.default = Components;

package/src/elements/Components.mjs

@@ -1,35 +0,0 @@
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-/**
- * @public
- */
-class Components extends ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'components';
-  }
-  get inputs() {
-    return this.get('inputs');
-  }
-  set inputs(inputs) {
-    this.set('inputs', inputs);
-  }
-  get parameters() {
-    return this.get('parameters');
-  }
-  set parameters(parameters) {
-    this.set('parameters', parameters);
-  }
-  get successActions() {
-    return this.get('successActions');
-  }
-  set successActions(successActions) {
-    this.set('successActions', successActions);
-  }
-  get failureActions() {
-    return this.get('failureActions');
-  }
-  set failureActions(failureActions) {
-    this.set('failureActions', failureActions);
-  }
-}
-export default Components;

package/src/elements/Criterion.cjs

@@ -1,33 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class Criterion extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'criterion';
-  }
-  get context() {
-    return this.get('context');
-  }
-  set context(context) {
-    this.set('context', context);
-  }
-  get condition() {
-    return this.get('condition');
-  }
-  set condition(condition) {
-    this.set('condition', condition);
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-}
-var _default = exports.default = Criterion;

package/src/elements/Criterion.mjs

@@ -1,29 +0,0 @@
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-/**
- * @public
- */
-class Criterion extends ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'criterion';
-  }
-  get context() {
-    return this.get('context');
-  }
-  set context(context) {
-    this.set('context', context);
-  }
-  get condition() {
-    return this.get('condition');
-  }
-  set condition(condition) {
-    this.set('condition', condition);
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-}
-export default Criterion;

package/src/elements/CriterionExpressionType.cjs

@@ -1,27 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class CriterionExpressionType extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'criterionExpressionType';
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-  get version() {
-    return this.get('version');
-  }
-  set version(version) {
-    this.set('version', version);
-  }
-}
-var _default = exports.default = CriterionExpressionType;

package/src/elements/CriterionExpressionType.mjs

@@ -1,24 +0,0 @@
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-
-/**
- * @public
- */
-class CriterionExpressionType extends ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'criterionExpressionType';
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-  get version() {
-    return this.get('version');
-  }
-  set version(version) {
-    this.set('version', version);
-  }
-}
-export default CriterionExpressionType;

package/src/elements/FailureAction.cjs

@@ -1,57 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class FailureAction extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'failureAction';
-  }
-  get name() {
-    return this.get('name');
-  }
-  set name(name) {
-    this.set('name', name);
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-  get workflowId() {
-    return this.get('workflowId');
-  }
-  set workflowId(workflowId) {
-    this.set('workflowId', workflowId);
-  }
-  get stepId() {
-    return this.get('stepId');
-  }
-  set stepId(stepId) {
-    this.set('stepId', stepId);
-  }
-  get retryAfter() {
-    return this.get('retryAfter');
-  }
-  set retryAfter(retryAfter) {
-    this.set('retryAfter', retryAfter);
-  }
-  get retryLimit() {
-    return this.get('retryLimit');
-  }
-  set retryLimit(retryLimit) {
-    this.set('retryLimit', retryLimit);
-  }
-  get criteria() {
-    return this.get('criteria');
-  }
-  set criteria(criteria) {
-    this.set('criteria', criteria);
-  }
-}
-var _default = exports.default = FailureAction;

package/src/elements/FailureAction.mjs

@@ -1,53 +0,0 @@
-import { ObjectElement } from '@speclynx/apidom-datamodel';
-/**
- * @public
- */
-class FailureAction extends ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'failureAction';
-  }
-  get name() {
-    return this.get('name');
-  }
-  set name(name) {
-    this.set('name', name);
-  }
-  get type() {
-    return this.get('type');
-  }
-  set type(type) {
-    this.set('type', type);
-  }
-  get workflowId() {
-    return this.get('workflowId');
-  }
-  set workflowId(workflowId) {
-    this.set('workflowId', workflowId);
-  }
-  get stepId() {
-    return this.get('stepId');
-  }
-  set stepId(stepId) {
-    this.set('stepId', stepId);
-  }
-  get retryAfter() {
-    return this.get('retryAfter');
-  }
-  set retryAfter(retryAfter) {
-    this.set('retryAfter', retryAfter);
-  }
-  get retryLimit() {
-    return this.get('retryLimit');
-  }
-  set retryLimit(retryLimit) {
-    this.set('retryLimit', retryLimit);
-  }
-  get criteria() {
-    return this.get('criteria');
-  }
-  set criteria(criteria) {
-    this.set('criteria', criteria);
-  }
-}
-export default FailureAction;

package/src/elements/Info.cjs

@@ -1,40 +0,0 @@
-"use strict";
-
-exports.__esModule = true;
-exports.default = void 0;
-var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-/**
- * @public
- */
-class Info extends _apidomDatamodel.ObjectElement {
-  constructor(content, meta, attributes) {
-    super(content, meta, attributes);
-    this.element = 'info';
-    this.classes.push('info');
-  }
-  get title() {
-    return this.get('title');
-  }
-  set title(title) {
-    this.set('title', title);
-  }
-  get summary() {
-    return this.get('summary');
-  }
-  set summary(summary) {
-    this.set('summary', summary);
-  }
-  get description() {
-    return this.get('description');
-  }
-  set description(description) {
-    this.set('description', description);
-  }
-  get version() {
-    return this.get('version');
-  }
-  set version(version) {
-    this.set('version', version);
-  }
-}
-var _default = exports.default = Info;