@speclynx/apidom-ns-openapi-3-1 4.0.5 → 4.2.0

package/dist/apidom-ns-openapi-3-1.browser.js

@@ -1668,54 +1668,7 @@ const refractJsonSchemaDialect = (value, options = {}) => refract(value, {
 
 /***/ },
 
-/***/ 36891
-(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
-
-__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__(25162);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(97601);
-/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(97071);
-
-class NormalizeStorage {
-  internalStore;
-  constructor(storageElement, storageField, storageSubField) {
-    this.storageElement = storageElement;
-    this.storageField = storageField;
-    this.storageSubField = storageSubField;
-  }
-  get store() {
-    if (!this.internalStore) {
-      let rootStore = this.storageElement.get(this.storageField);
-      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isObjectElement)(rootStore)) {
-        rootStore = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]();
-        this.storageElement.set(this.storageField, rootStore);
-      }
-      let store = rootStore.get(this.storageSubField);
-      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(store)) {
-        store = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]();
-        rootStore.set(this.storageSubField, store);
-      }
-      this.internalStore = store;
-    }
-    return this.internalStore;
-  }
-  append(pointer) {
-    if (!this.includes(pointer)) {
-      this.store.push(pointer);
-    }
-  }
-  includes(pointer) {
-    return this.store.includes(pointer);
-  }
-}
-/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (NormalizeStorage);
-
-/***/ },
-
-/***/ 26031
+/***/ 40048
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
 __webpack_require__.r(__webpack_exports__);
@@ -1723,7 +1676,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(12111);
-/* harmony import */ var _NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36891);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(33313);
 
 
 
@@ -1750,8 +1703,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -1759,7 +1711,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__["default"](element, storageField, 'header-examples');
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_1__["default"](element, storageField, 'header-examples');
         },
         leave() {
           storage = undefined;
@@ -1768,7 +1720,7 @@ const plugin = ({
       HeaderElement: {
         leave(path) {
           const headerElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+          const ancestors = path.getAncestorNodes(); // parent to root order
 
           // skip visiting this Header Object
           if (ancestors.some(predicates.isComponentsElement)) {
@@ -1783,7 +1735,7 @@ const plugin = ({
           if (typeof headerElement.schema?.example === 'undefined' && typeof headerElement.schema?.examples === 'undefined') {
             return;
           }
-          const headerJSONPointer = ancestorLineageToJSONPointer([...ancestors, headerElement]);
+          const headerJSONPointer = path.formatPath();
 
           // skip visiting this Header Object if it's already normalized
           if (storage.includes(headerJSONPointer)) {
@@ -1844,7 +1796,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(49451);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(12111);
 /* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(44673);
-/* harmony import */ var _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(36891);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(33313);
 
 
 
@@ -1895,7 +1847,6 @@ const plugin = ({
 } = {}) => toolbox => {
   const {
     predicates,
-    ancestorLineageToJSONPointer,
     namespace
   } = toolbox;
   const pathTemplates = [];
@@ -1907,7 +1858,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_5__["default"](element, storageField, 'operation-ids');
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_5__["default"](element, storageField, 'operation-ids');
         },
         leave() {
           // group normalized operations by normalized operationId
@@ -1962,11 +1913,10 @@ const plugin = ({
       OperationElement: {
         enter(path) {
           const operationElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
 
           // operationId field is undefined, needs no normalization
           if (typeof operationElement.operationId === 'undefined') return;
-          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, operationElement]);
+          const operationJSONPointer = path.formatPath();
 
           // skip visiting this Operation Object if it's already normalized
           if (storage.includes(operationJSONPointer)) {
@@ -2017,7 +1967,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(12111);
-/* harmony import */ var _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36891);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(33313);
 
 
 
@@ -2044,8 +1994,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -2053,7 +2002,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__["default"](element, storageField, 'parameter-examples');
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_1__["default"](element, storageField, 'parameter-examples');
         },
         leave() {
           storage = undefined;
@@ -2062,7 +2011,7 @@ const plugin = ({
       ParameterElement: {
         leave(path) {
           const parameterElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+          const ancestors = path.getAncestorNodes(); // parent to root order
 
           // skip visiting this Parameter Object
           if (ancestors.some(predicates.isComponentsElement)) {
@@ -2077,7 +2026,7 @@ const plugin = ({
           if (typeof parameterElement.schema?.example === 'undefined' && typeof parameterElement.schema?.examples === 'undefined') {
             return;
           }
-          const parameterJSONPointer = ancestorLineageToJSONPointer([...ancestors, parameterElement]);
+          const parameterJSONPointer = path.formatPath();
 
           // skip visiting this Parameter Object if it's already normalized
           if (storage.includes(parameterJSONPointer)) {
@@ -2133,12 +2082,14 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
-/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(49451);
-/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(44181);
-/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(41942);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(25926);
-/* harmony import */ var _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(36891);
+/* harmony import */ var ramda__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(41942);
+/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(44673);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(25926);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(33313);
+/* harmony import */ var _predicates_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(97269);
+
+
 
 
 
@@ -2157,6 +2108,38 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
+/**
+ * Establishes identity between two Parameter Objects.
+ * A unique parameter is defined by a combination of a name and location.
+ *
+ * {@link https://spec.openapis.org/oas/v3.1.2.html#operation-parameters}
+ */
+const parameterEquals = (parameter1, parameter2) => {
+  if (!(0,_predicates_ts__WEBPACK_IMPORTED_MODULE_5__.isParameterElement)(parameter1)) return false;
+  if (!(0,_predicates_ts__WEBPACK_IMPORTED_MODULE_5__.isParameterElement)(parameter2)) return false;
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(parameter1.name)) return false;
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(parameter1.in)) return false;
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(parameter2.name)) return false;
+  if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isStringElement)(parameter2.in)) return false;
+  return (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])(parameter1.name) === (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])(parameter2.name) && (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])(parameter1.in) === (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_1__["default"])(parameter2.in);
+};
+
+/**
+ * Inherits parameters from a PathItem into an Operation element.
+ * Operation parameters take precedence; PathItem parameters are merged in
+ * for any (name, in) combination not already defined at the Operation level.
+ * @public
+ */
+const inheritParametersToOperation = (operationElement, pathItemElement) => {
+  const pathItemParams = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isArrayElement)(pathItemElement.parameters) ? [...pathItemElement.parameters] : [];
+  if (pathItemParams.length === 0) return;
+  const operationParams = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__.isArrayElement)(operationElement.parameters) ? [...operationElement.parameters] : [];
+
+  // prefers the first item if two items compare equal based on the predicate
+  const mergedParameters = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(parameterEquals, [...operationParams, ...pathItemParams]);
+  operationElement.parameters = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__["default"](mergedParameters);
+};
+
 /**
  * @public
  */
@@ -2164,85 +2147,49 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
-  /**
-   * Establishes identity between two Parameter Objects.
-   *
-   * {@link https://spec.openapis.org/oas/v3.1.2.html#operation-parameters}
-   */
-  const parameterEquals = (parameter1, parameter2) => {
-    if (!predicates.isParameterElement(parameter1)) return false;
-    if (!predicates.isParameterElement(parameter2)) return false;
-    if (!predicates.isStringElement(parameter1.name)) return false;
-    if (!predicates.isStringElement(parameter1.in)) return false;
-    if (!predicates.isStringElement(parameter2.name)) return false;
-    if (!predicates.isStringElement(parameter2.in)) return false;
-    return (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(parameter1.name) === (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(parameter2.name) && (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(parameter1.in) === (0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_3__["default"])(parameter2.in);
-  };
-  const pathItemParameters = [];
   let storage;
   return {
     visitor: {
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_5__["default"](element, storageField, 'parameters');
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_4__["default"](element, storageField, 'parameters');
         },
         leave() {
           storage = undefined;
         }
       },
-      PathItemElement: {
-        enter(path) {
-          const pathItemElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+      OperationElement: {
+        leave(path) {
+          const operationElement = path.node;
+          const ancestors = path.getAncestorNodes(); // parent to root order
 
-          // skip visiting this Path Item
+          // skip visiting this Operation
           if (ancestors.some(predicates.isComponentsElement)) {
             return;
           }
-          const {
-            parameters
-          } = pathItemElement;
-          if (predicates.isArrayElement(parameters)) {
-            pathItemParameters.push([...(parameters.content ?? [])]);
-          } else {
-            pathItemParameters.push([]);
-          }
-        },
-        leave() {
-          pathItemParameters.pop();
-        }
-      },
-      OperationElement: {
-        leave(path) {
-          const operationElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
-          const parentPathItemParameters = (0,ramda__WEBPACK_IMPORTED_MODULE_0__["default"])(pathItemParameters);
+          const parentPathItemElement = ancestors.find(predicates.isPathItemElement);
 
-          // no Path Item Object parameters to inherit from
-          if (!Array.isArray(parentPathItemParameters) || parentPathItemParameters.length === 0) {
+          // no parent Path Item to inherit from
+          if (!predicates.isPathItemElement(parentPathItemElement)) {
             return;
           }
-          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, operationElement]);
+          const operationJSONPointer = path.formatPath();
 
           // skip visiting this Operation Object if it's already normalized
           if (storage.includes(operationJSONPointer)) {
             return;
           }
-          const operationParameters = (0,ramda__WEBPACK_IMPORTED_MODULE_1__["default"])([], ['parameters', 'content'], operationElement);
-
-          // prefers the first item if two items compare equal based on the predicate
-          const mergedParameters = (0,ramda__WEBPACK_IMPORTED_MODULE_2__["default"])(parameterEquals, [...operationParameters, ...parentPathItemParameters]);
-          operationElement.parameters = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_4__["default"](mergedParameters);
+          inheritParametersToOperation(operationElement, parentPathItemElement);
           storage.append(operationJSONPointer);
         }
       }
     }
   };
 };
+plugin.inheritParametersToOperation = inheritParametersToOperation;
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (plugin);
 
 /***/ },
@@ -2254,8 +2201,10 @@ __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_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(63072);
-/* harmony import */ var _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36891);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(63072);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(33313);
+
 
 
 /**
@@ -2272,6 +2221,19 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
+/**
+ * Inherits top-level security requirements into an Operation element.
+ * If Operation.security is missing and OpenAPI.security is defined, copies it down.
+ * @public
+ */
+const inheritSecurityToOperation = (operationElement, openapiElement) => {
+  const missingOperationLevelSecurity = typeof operationElement.security === 'undefined';
+  const hasTopLevelSecurity = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(openapiElement.security);
+  if (missingOperationLevelSecurity && hasTopLevelSecurity) {
+    operationElement.security = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__["default"]([...openapiElement.security]);
+  }
+};
+
 /**
  * @public
  */
@@ -2279,8 +2241,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let topLevelSecurity;
   let storage;
@@ -2289,7 +2250,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const openapiElement = path.node;
-          storage = new _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_1__["default"](openapiElement, storageField, 'security-requirements');
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_2__["default"](openapiElement, storageField, 'security-requirements');
           if (predicates.isArrayElement(openapiElement.security)) {
             topLevelSecurity = openapiElement.security;
           }
@@ -2302,13 +2263,13 @@ const plugin = ({
       OperationElement: {
         leave(path) {
           const operationElement = path.node;
-          const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+          const ancestors = path.getAncestorNodes(); // parent to root order
 
           // skip visiting this Operation
           if (ancestors.some(predicates.isComponentsElement)) {
             return;
           }
-          const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, operationElement]);
+          const operationJSONPointer = path.formatPath();
 
           // skip visiting this Operation Object if it's already normalized
           if (storage.includes(operationJSONPointer)) {
@@ -2317,7 +2278,7 @@ const plugin = ({
           const missingOperationLevelSecurity = typeof operationElement.security === 'undefined';
           const hasTopLevelSecurity = typeof topLevelSecurity !== 'undefined';
           if (missingOperationLevelSecurity && hasTopLevelSecurity) {
-            operationElement.security = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_0__["default"](topLevelSecurity?.content ?? undefined);
+            operationElement.security = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__["default"]([...topLevelSecurity]);
             storage.append(operationJSONPointer);
           }
         }
@@ -2325,6 +2286,7 @@ const plugin = ({
     }
   };
 };
+plugin.inheritSecurityToOperation = inheritSecurityToOperation;
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (plugin);
 
 /***/ },
@@ -2336,11 +2298,13 @@ __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_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(36882);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(94689);
-/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(51865);
-/* harmony import */ var _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(36891);
-/* harmony import */ var _index_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(14074);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(25162);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(36882);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(94689);
+/* harmony import */ var _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(51865);
+/* harmony import */ var _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(33313);
+/* harmony import */ var _index_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(14074);
+
 
 
 
@@ -2359,6 +2323,63 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
+/**
+ * Ensures the OpenAPI document has at least one server defined.
+ * If `servers` is missing or empty, adds a default server with `url: "/"`.
+ * @public
+ */
+const ensureDefaultServer = openapiElement => {
+  const isServersUndefined = typeof openapiElement.servers === 'undefined';
+  const isServersArray = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(openapiElement.servers);
+  const isServersEmpty = isServersArray && openapiElement.servers.length === 0;
+  const defaultServer = (0,_index_ts__WEBPACK_IMPORTED_MODULE_5__.refractServer)({
+    url: '/'
+  });
+  if (isServersUndefined || !isServersArray) {
+    openapiElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_3__["default"]([defaultServer]);
+  } else if (isServersArray && isServersEmpty) {
+    openapiElement.servers.push(defaultServer);
+  }
+};
+
+/**
+ * Inherits servers from the OpenAPI root into a PathItem element.
+ * If PathItem.servers is missing or empty, copies from OpenAPI.servers.
+ * @public
+ */
+const inheritServersToPathItem = (pathItemElement, openapiElement) => {
+  const isServersUndefined = typeof pathItemElement.servers === 'undefined';
+  const isServersArray = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(pathItemElement.servers);
+  const isServersEmpty = isServersArray && pathItemElement.servers.length === 0;
+  const openapiServers = [...(openapiElement.servers ?? [])];
+  if (isServersUndefined || !isServersArray) {
+    pathItemElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_2__["default"](openapiServers);
+  } else if (isServersArray && isServersEmpty) {
+    openapiServers.forEach(server => {
+      pathItemElement.servers.push(server);
+    });
+  }
+};
+
+/**
+ * Inherits servers from a PathItem into an Operation element.
+ * If Operation.servers is missing or empty, copies from PathItem.servers.
+ * @public
+ */
+const inheritServersToOperation = (operationElement, pathItemElement) => {
+  const isServersUndefined = typeof operationElement.servers === 'undefined';
+  const isServersArray = (0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(operationElement.servers);
+  const isServersEmpty = isServersArray && operationElement.servers.length === 0;
+  const pathItemServers = [...(pathItemElement.servers ?? [])];
+  if (isServersUndefined || !isServersArray) {
+    operationElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__["default"](pathItemServers);
+  } else if (isServersArray && isServersEmpty) {
+    pathItemServers.forEach(server => {
+      operationElement.servers.push(server);
+    });
+  }
+};
+
 /**
  * @public
  */
@@ -2366,7 +2387,6 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    ancestorLineageToJSONPointer,
     predicates
   } = toolbox;
   let storage;
@@ -2375,18 +2395,8 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const openapiElement = path.node;
-          const isServersUndefined = typeof openapiElement.servers === 'undefined';
-          const isServersArrayElement = predicates.isArrayElement(openapiElement.servers);
-          const isServersEmpty = isServersArrayElement && openapiElement.servers.length === 0;
-          const defaultServer = (0,_index_ts__WEBPACK_IMPORTED_MODULE_4__.refractServer)({
-            url: '/'
-          });
-          if (isServersUndefined || !isServersArrayElement) {
-            openapiElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_2__["default"]([defaultServer]);
-          } else if (isServersArrayElement && isServersEmpty) {
-            openapiElement.servers.push(defaultServer);
-          }
-          storage = new _normalize_header_examples_NormalizeStorage_ts__WEBPACK_IMPORTED_MODULE_3__["default"](openapiElement, storageField, 'servers');
+          ensureDefaultServer(openapiElement);
+          storage = new _normalize_storage_index_ts__WEBPACK_IMPORTED_MODULE_4__["default"](openapiElement, storageField, 'servers');
         },
         leave() {
           storage = undefined;
@@ -2394,76 +2404,99 @@ const plugin = ({
       },
       PathItemElement(path) {
         const pathItemElement = path.node;
-        const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+        const ancestors = path.getAncestorNodes(); // parent to root order
 
         // skip visiting this Path Item
         if (ancestors.some(predicates.isComponentsElement)) return;
         if (!ancestors.some(predicates.isOpenApi3_1Element)) return;
-        const pathItemJSONPointer = ancestorLineageToJSONPointer([...ancestors, pathItemElement]);
+        const pathItemJSONPointer = path.formatPath();
 
         // skip visiting this Path Item Object if it's already normalized
         if (storage.includes(pathItemJSONPointer)) {
           return;
         }
         const parentOpenapiElement = ancestors.find(predicates.isOpenApi3_1Element);
-        const isServersUndefined = typeof pathItemElement.servers === 'undefined';
-        const isServersArrayElement = predicates.isArrayElement(pathItemElement.servers);
-        const isServersEmpty = isServersArrayElement && pathItemElement.servers.length === 0;
-
-        // duplicate OpenAPI.servers into this Path Item object
         if (predicates.isOpenApi3_1Element(parentOpenapiElement)) {
-          const openapiServersContent = parentOpenapiElement.servers?.content;
-          const openapiServers = openapiServersContent ?? [];
-          if (isServersUndefined || !isServersArrayElement) {
-            pathItemElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_1__["default"](openapiServers);
-          } else if (isServersArrayElement && isServersEmpty) {
-            openapiServers.forEach(server => {
-              pathItemElement.servers.push(server);
-            });
-          }
+          inheritServersToPathItem(pathItemElement, parentOpenapiElement);
           storage.append(pathItemJSONPointer);
         }
       },
       OperationElement(path) {
         const operationElement = path.node;
-        const ancestors = path.getAncestorNodes().reverse(); // root to parent order
+        const ancestors = path.getAncestorNodes(); // parent to root order
 
         // skip visiting this Operation
         if (ancestors.some(predicates.isComponentsElement)) return;
         if (!ancestors.some(predicates.isOpenApi3_1Element)) return;
-        const operationJSONPointer = ancestorLineageToJSONPointer([...ancestors, operationElement]);
+        const operationJSONPointer = path.formatPath();
 
         // skip visiting this Operation Object if it's already normalized
         if (storage.includes(operationJSONPointer)) {
           return;
         }
-
-        // @TODO(vladimir.gorej@gmail.com): can be replaced by Array.prototype.findLast in future
-        const parentPathItemElement = ancestors.findLast(predicates.isPathItemElement);
-        const isServersUndefined = typeof operationElement.servers === 'undefined';
-        const isServersArrayElement = predicates.isArrayElement(operationElement.servers);
-        const isServersEmpty = isServersArrayElement && operationElement.servers.length === 0;
+        const parentPathItemElement = ancestors.find(predicates.isPathItemElement);
         if (predicates.isPathItemElement(parentPathItemElement)) {
-          const pathItemServersContent = parentPathItemElement.servers?.content;
-          const pathItemServers = pathItemServersContent ?? [];
-          if (isServersUndefined || !isServersArrayElement) {
-            // duplicate parent PathItem.servers into this Operation object
-            operationElement.servers = new _speclynx_apidom_ns_openapi_3_0__WEBPACK_IMPORTED_MODULE_0__["default"](pathItemServers);
-          } else if (isServersArrayElement && isServersEmpty) {
-            pathItemServers.forEach(server => {
-              operationElement.servers.push(server);
-            });
-          }
+          inheritServersToOperation(operationElement, parentPathItemElement);
           storage.append(operationJSONPointer);
         }
       }
     }
   };
 };
+plugin.ensureDefaultServer = ensureDefaultServer;
+plugin.inheritServersToPathItem = inheritServersToPathItem;
+plugin.inheritServersToOperation = inheritServersToOperation;
 /* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (plugin);
 
 /***/ },
 
+/***/ 33313
+(__unused_webpack_module, __webpack_exports__, __webpack_require__) {
+
+__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__(25162);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(97601);
+/* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(97071);
+
+class NormalizeStorage {
+  internalStore;
+  constructor(storageElement, storageField, storageSubField) {
+    this.storageElement = storageElement;
+    this.storageField = storageField;
+    this.storageSubField = storageSubField;
+  }
+  get store() {
+    if (this.internalStore === undefined) {
+      let rootStore = this.storageElement.get(this.storageField);
+      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isObjectElement)(rootStore)) {
+        rootStore = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_2__["default"]();
+        this.storageElement.set(this.storageField, rootStore);
+      }
+      let store = rootStore.get(this.storageSubField);
+      if (!(0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__.isArrayElement)(store)) {
+        store = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__["default"]();
+        rootStore.set(this.storageSubField, store);
+      }
+      this.internalStore = store;
+    }
+    return this.internalStore;
+  }
+  append(pointer) {
+    if (!this.includes(pointer)) {
+      this.store.push(pointer);
+    }
+  }
+  includes(pointer) {
+    return this.store.includes(pointer);
+  }
+}
+/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (NormalizeStorage);
+
+/***/ },
+
 /***/ 74000
 (__unused_webpack_module, __webpack_exports__, __webpack_require__) {
 
@@ -3843,18 +3876,13 @@ const specification = {
 
 __webpack_require__.r(__webpack_exports__);
 /* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   ancestorLineageToJSONPointer: () => (/* binding */ ancestorLineageToJSONPointer),
 /* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
 /* harmony export */ });
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(55156);
 /* harmony import */ var _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(25162);
-/* harmony import */ var _speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(44673);
-/* harmony import */ var _speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(61198);
-/* harmony import */ var _predicates_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(97269);
-/* harmony import */ var _predicates_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(83990);
-/* harmony import */ var _namespace_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(9936);
-
-
+/* harmony import */ var _predicates_ts__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(97269);
+/* harmony import */ var _predicates_ts__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(83990);
+/* harmony import */ var _namespace_ts__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(9936);
 
 
 
@@ -3864,46 +3892,21 @@ __webpack_require__.r(__webpack_exports__);
  * @public
  */
 
-/**
- * Translates visitor ancestor lineage to a JSON Pointer tokens.
- * Ancestor lineage is constructed of following visitor method arguments:
- *
- *  - ancestors
- *  - parent
- *  - element
- * @public
- */
-const ancestorLineageToJSONPointer = elementPath => {
-  const jsonPointerTokens = elementPath.reduce((path, element, index) => {
-    if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isMemberElement)(element)) {
-      const token = String((0,_speclynx_apidom_core__WEBPACK_IMPORTED_MODULE_2__["default"])(element.key));
-      path.push(token);
-    } else if ((0,_speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isArrayElement)(elementPath[index - 2])) {
-      const arrayElement = elementPath[index - 2];
-      const token = String(arrayElement.content?.indexOf(element) ?? -1);
-      path.push(token);
-    }
-    return path;
-  }, []);
-  return (0,_speclynx_apidom_json_pointer__WEBPACK_IMPORTED_MODULE_3__.compile)(jsonPointerTokens);
-};
-
 /**
  * @public
  */
 const createToolbox = () => {
   const namespace = new _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_0__["default"]();
   const predicates = {
-    ..._predicates_ts__WEBPACK_IMPORTED_MODULE_5__,
-    ..._predicates_ts__WEBPACK_IMPORTED_MODULE_4__,
+    ..._predicates_ts__WEBPACK_IMPORTED_MODULE_3__,
+    ..._predicates_ts__WEBPACK_IMPORTED_MODULE_2__,
     isStringElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isStringElement,
     isArrayElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isArrayElement,
     isObjectElement: _speclynx_apidom_datamodel__WEBPACK_IMPORTED_MODULE_1__.isObjectElement
   };
-  namespace.use(_namespace_ts__WEBPACK_IMPORTED_MODULE_6__["default"]);
+  namespace.use(_namespace_ts__WEBPACK_IMPORTED_MODULE_4__["default"]);
   return {
     predicates,
-    ancestorLineageToJSONPointer,
     namespace
   };
 };
@@ -20456,46 +20459,6 @@ var path = /*#__PURE__*/(0,_internal_curry2_js__WEBPACK_IMPORTED_MODULE_0__["def
 
 /***/ },
 
-/***/ 44181
-(__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
-
-__webpack_require__.r(__webpack_exports__);
-/* harmony export */ __webpack_require__.d(__webpack_exports__, {
-/* harmony export */   "default": () => (__WEBPACK_DEFAULT_EXPORT__)
-/* harmony export */ });
-/* harmony import */ var _internal_curry3_js__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(39088);
-/* harmony import */ var _internal_path_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(68067);
-/* harmony import */ var _defaultTo_js__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(66719);
-
-
-
-
-/**
- * If the given, non-null object has a value at the given path, returns the
- * value at that path. Otherwise returns the provided default value.
- *
- * @func
- * @memberOf R
- * @since v0.18.0
- * @category Object
- * @typedefn Idx = String | Int | Symbol
- * @sig a -> [Idx] -> {a} -> a
- * @param {*} d The default value.
- * @param {Array} p The path to use.
- * @param {Object} obj The object to retrieve the nested property from.
- * @return {*} The data at `path` of the supplied object or the default value.
- * @example
- *
- *      R.pathOr('N/A', ['a', 'b'], {a: {b: 2}}); //=> 2
- *      R.pathOr('N/A', ['a', 'b'], {c: {b: 2}}); //=> "N/A"
- */
-var pathOr = /*#__PURE__*/(0,_internal_curry3_js__WEBPACK_IMPORTED_MODULE_0__["default"])(function pathOr(d, p, obj) {
-  return (0,_defaultTo_js__WEBPACK_IMPORTED_MODULE_2__["default"])(d, (0,_internal_path_js__WEBPACK_IMPORTED_MODULE_1__["default"])(p, obj));
-});
-/* harmony default export */ const __WEBPACK_DEFAULT_EXPORT__ = (pathOr);
-
-/***/ },
-
 /***/ 44787
 (__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) {
 
@@ -38034,7 +37997,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony export */   refractServerVariable: () => (/* reexport safe */ _refractor_index_ts__WEBPACK_IMPORTED_MODULE_11__.refractServerVariable),
 /* harmony export */   refractTag: () => (/* reexport safe */ _refractor_index_ts__WEBPACK_IMPORTED_MODULE_11__.refractTag),
 /* harmony export */   refractXml: () => (/* reexport safe */ _refractor_index_ts__WEBPACK_IMPORTED_MODULE_11__.refractXml),
-/* harmony export */   refractorPluginNormalizeHeaderExamples: () => (/* reexport safe */ _refractor_plugins_normalize_header_examples_index_ts__WEBPACK_IMPORTED_MODULE_8__["default"]),
+/* harmony export */   refractorPluginNormalizeHeaderExamples: () => (/* reexport safe */ _refractor_plugins_normalize_header_examples_ts__WEBPACK_IMPORTED_MODULE_8__["default"]),
 /* harmony export */   refractorPluginNormalizeOperationIds: () => (/* reexport safe */ _refractor_plugins_normalize_operation_ids_ts__WEBPACK_IMPORTED_MODULE_6__["default"]),
 /* harmony export */   refractorPluginNormalizeParameterExamples: () => (/* reexport safe */ _refractor_plugins_normalize_parameter_examples_ts__WEBPACK_IMPORTED_MODULE_7__["default"]),
 /* harmony export */   refractorPluginNormalizeParameters: () => (/* reexport safe */ _refractor_plugins_normalize_parameters_ts__WEBPACK_IMPORTED_MODULE_3__["default"]),
@@ -38051,7 +38014,7 @@ __webpack_require__.r(__webpack_exports__);
 /* harmony import */ var _refractor_plugins_normalize_servers_ts__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(96255);
 /* harmony import */ var _refractor_plugins_normalize_operation_ids_ts__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(2261);
 /* harmony import */ var _refractor_plugins_normalize_parameter_examples_ts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(43058);
-/* harmony import */ var _refractor_plugins_normalize_header_examples_index_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(26031);
+/* harmony import */ var _refractor_plugins_normalize_header_examples_ts__WEBPACK_IMPORTED_MODULE_8__ = __webpack_require__(40048);
 /* harmony import */ var _refractor_toolbox_ts__WEBPACK_IMPORTED_MODULE_9__ = __webpack_require__(84225);
 /* harmony import */ var _refractor_specification_ts__WEBPACK_IMPORTED_MODULE_10__ = __webpack_require__(27715);
 /* harmony import */ var _refractor_index_ts__WEBPACK_IMPORTED_MODULE_11__ = __webpack_require__(14074);