@speclynx/apidom-reference 2.2.0 → 2.2.1

package/CHANGELOG.md

@@ -3,6 +3,10 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [2.2.1](https://github.com/speclynx/apidom/compare/v2.2.0...v2.2.1) (2026-01-20)
+
+**Note:** Version bump only for package @speclynx/apidom-reference
+
 # [2.2.0](https://github.com/speclynx/apidom/compare/v2.1.0...v2.2.0) (2026-01-19)
 
 **Note:** Version bump only for package @speclynx/apidom-reference

package/dist/apidom-reference.browser.js

@@ -38507,8 +38507,10 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   Path: () => (/* binding */ Path)
 /* harmony export */ });
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(61198);
-/* harmony import */ var _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(33204);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(61198);
+/* harmony import */ var _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(33204);
+
 
 
 
@@ -38650,14 +38652,34 @@ class Path {
   }
 
   /**
-   * Get the path from root as an array of keys.
+   * Get the semantic path from root as an array of keys.
+   * Returns logical document keys (property names, array indices) rather than
+   * internal ApiDOM structure keys.
+   *
+   * @example
+   * // For a path to $.paths['/pets'].get in an OpenAPI document:
+   * path.getPathKeys(); // => ['paths', '/pets', 'get']
    */
   getPathKeys() {
     const keys = [];
     // eslint-disable-next-line @typescript-eslint/no-this-alias
     let current = this;
     while (current !== null && current.key !== undefined) {
-      keys.unshift(current.key);
+      const {
+        key,
+        parent,
+        parentPath
+      } = current;
+      if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isMemberElement)(parent) && key === 'value') {
+        // Inside MemberElement.value → push the member's key
+        if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isStringElement)(parent.key)) {
+          throw new TypeError('MemberElement.key must be a StringElement');
+        }
+        keys.unshift(parent.key.toValue());
+      } else if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(parentPath?.node) && typeof key === 'number') {
+        // Inside ArrayElement → push the numeric index
+        keys.unshift(key);
+      }
       current = current.parentPath;
     }
     return keys;
@@ -38693,11 +38715,11 @@ class Path {
     }
     if (pathFormat === 'jsonpath') {
       // RFC 9535 Normalized JSONPath
-      return _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_1__.NormalizedPath.from(parts);
+      return _speclynx_apidom_json_path__WEBPACK_IMPORTED_MODULE_2__.NormalizedPath.from(parts);
     }
 
     // RFC 6901 JSON Pointer
-    return (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_0__.compile)(parts);
+    return (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_1__.compile)(parts);
   }
 
   /**