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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@speclynx/apidom-ns-openapi-3-1",
-  "version": "4.0.5",
+  "version": "4.1.0",
   "description": "OpenAPI 3.1.x namespace for ApiDOM.",
   "keywords": [
     "apidom",
@@ -60,12 +60,12 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@babel/runtime-corejs3": "^7.28.4",
-    "@speclynx/apidom-core": "4.0.5",
-    "@speclynx/apidom-datamodel": "4.0.5",
-    "@speclynx/apidom-json-pointer": "4.0.5",
-    "@speclynx/apidom-ns-json-schema-2020-12": "4.0.5",
-    "@speclynx/apidom-ns-openapi-3-0": "4.0.5",
-    "@speclynx/apidom-traverse": "4.0.5",
+    "@speclynx/apidom-core": "4.1.0",
+    "@speclynx/apidom-datamodel": "4.1.0",
+    "@speclynx/apidom-json-pointer": "4.1.0",
+    "@speclynx/apidom-ns-json-schema-2020-12": "4.1.0",
+    "@speclynx/apidom-ns-openapi-3-0": "4.1.0",
+    "@speclynx/apidom-traverse": "4.1.0",
     "ramda": "~0.32.0",
     "ramda-adjunct": "^6.0.0",
     "ts-mixer": "^6.0.4"
@@ -80,5 +80,5 @@
     "README.md",
     "CHANGELOG.md"
   ],
-  "gitHead": "5a85d2a832eeefb07d03760faa391b457447e966"
+  "gitHead": "41d4a41ac6157808b01e08d271019e53c4c8d6c5"
 }

package/src/index.cjs

@@ -22,45 +22,45 @@ var _normalizeOperationIds = _interopRequireDefault(require("./refractor/plugins
 exports.refractorPluginNormalizeOperationIds = _normalizeOperationIds.default;
 var _normalizeParameterExamples = _interopRequireDefault(require("./refractor/plugins/normalize-parameter-examples.cjs"));
 exports.refractorPluginNormalizeParameterExamples = _normalizeParameterExamples.default;
-var _index = _interopRequireDefault(require("./refractor/plugins/normalize-header-examples/index.cjs"));
-exports.refractorPluginNormalizeHeaderExamples = _index.default;
+var _normalizeHeaderExamples = _interopRequireDefault(require("./refractor/plugins/normalize-header-examples.cjs"));
+exports.refractorPluginNormalizeHeaderExamples = _normalizeHeaderExamples.default;
 var _toolbox = _interopRequireDefault(require("./refractor/toolbox.cjs"));
 exports.createToolbox = _toolbox.default;
 var _specification = _interopRequireDefault(require("./refractor/specification.cjs"));
 exports.specificationObj = _specification.default;
-var _index2 = _interopRequireWildcard(require("./refractor/index.cjs"));
-exports.refract = _index2.default;
-exports.refractOpenApi3_1 = _index2.refractOpenApi3_1;
-exports.refractInfo = _index2.refractInfo;
-exports.refractContact = _index2.refractContact;
-exports.refractLicense = _index2.refractLicense;
-exports.refractServer = _index2.refractServer;
-exports.refractServerVariable = _index2.refractServerVariable;
-exports.refractComponents = _index2.refractComponents;
-exports.refractPaths = _index2.refractPaths;
-exports.refractPathItem = _index2.refractPathItem;
-exports.refractOperation = _index2.refractOperation;
-exports.refractExternalDocumentation = _index2.refractExternalDocumentation;
-exports.refractParameter = _index2.refractParameter;
-exports.refractRequestBody = _index2.refractRequestBody;
-exports.refractMediaType = _index2.refractMediaType;
-exports.refractEncoding = _index2.refractEncoding;
-exports.refractResponses = _index2.refractResponses;
-exports.refractResponse = _index2.refractResponse;
-exports.refractCallback = _index2.refractCallback;
-exports.refractExample = _index2.refractExample;
-exports.refractLink = _index2.refractLink;
-exports.refractHeader = _index2.refractHeader;
-exports.refractTag = _index2.refractTag;
-exports.refractReference = _index2.refractReference;
-exports.refractSchema = _index2.refractSchema;
-exports.refractDiscriminator = _index2.refractDiscriminator;
-exports.refractXml = _index2.refractXml;
-exports.refractSecurityScheme = _index2.refractSecurityScheme;
-exports.refractOAuthFlows = _index2.refractOAuthFlows;
-exports.refractOAuthFlow = _index2.refractOAuthFlow;
-exports.refractSecurityRequirement = _index2.refractSecurityRequirement;
-exports.refractJsonSchemaDialect = _index2.refractJsonSchemaDialect;
+var _index = _interopRequireWildcard(require("./refractor/index.cjs"));
+exports.refract = _index.default;
+exports.refractOpenApi3_1 = _index.refractOpenApi3_1;
+exports.refractInfo = _index.refractInfo;
+exports.refractContact = _index.refractContact;
+exports.refractLicense = _index.refractLicense;
+exports.refractServer = _index.refractServer;
+exports.refractServerVariable = _index.refractServerVariable;
+exports.refractComponents = _index.refractComponents;
+exports.refractPaths = _index.refractPaths;
+exports.refractPathItem = _index.refractPathItem;
+exports.refractOperation = _index.refractOperation;
+exports.refractExternalDocumentation = _index.refractExternalDocumentation;
+exports.refractParameter = _index.refractParameter;
+exports.refractRequestBody = _index.refractRequestBody;
+exports.refractMediaType = _index.refractMediaType;
+exports.refractEncoding = _index.refractEncoding;
+exports.refractResponses = _index.refractResponses;
+exports.refractResponse = _index.refractResponse;
+exports.refractCallback = _index.refractCallback;
+exports.refractExample = _index.refractExample;
+exports.refractLink = _index.refractLink;
+exports.refractHeader = _index.refractHeader;
+exports.refractTag = _index.refractTag;
+exports.refractReference = _index.refractReference;
+exports.refractSchema = _index.refractSchema;
+exports.refractDiscriminator = _index.refractDiscriminator;
+exports.refractXml = _index.refractXml;
+exports.refractSecurityScheme = _index.refractSecurityScheme;
+exports.refractOAuthFlows = _index.refractOAuthFlows;
+exports.refractOAuthFlow = _index.refractOAuthFlow;
+exports.refractSecurityRequirement = _index.refractSecurityRequirement;
+exports.refractJsonSchemaDialect = _index.refractJsonSchemaDialect;
 var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-0");
 exports.AlternatingVisitor = _apidomNsOpenapi.AlternatingVisitor;
 exports.FixedFieldsVisitor = _apidomNsOpenapi.FixedFieldsVisitor;

package/src/index.mjs

@@ -6,7 +6,7 @@ export { default as refractorPluginNormalizeSecurityRequirements } from "./refra
 export { default as refractorPluginNormalizeServers } from "./refractor/plugins/normalize-servers.mjs";
 export { default as refractorPluginNormalizeOperationIds } from "./refractor/plugins/normalize-operation-ids.mjs";
 export { default as refractorPluginNormalizeParameterExamples } from "./refractor/plugins/normalize-parameter-examples.mjs";
-export { default as refractorPluginNormalizeHeaderExamples } from "./refractor/plugins/normalize-header-examples/index.mjs";
+export { default as refractorPluginNormalizeHeaderExamples } from "./refractor/plugins/normalize-header-examples.mjs";
 export { default as createToolbox } from "./refractor/toolbox.mjs";
 export { default as specificationObj } from "./refractor/specification.mjs";
 export { default as refract, refractOpenApi3_1, refractInfo, refractContact, refractLicense, refractServer, refractServerVariable, refractComponents, refractPaths, refractPathItem, refractOperation, refractExternalDocumentation, refractParameter, refractRequestBody, refractMediaType, refractEncoding, refractResponses, refractResponse, refractCallback, refractExample, refractLink, refractHeader, refractTag, refractReference, refractSchema, refractDiscriminator, refractXml, refractSecurityScheme, refractOAuthFlows, refractOAuthFlow, refractSecurityRequirement, refractJsonSchemaDialect } from "./refractor/index.mjs";

package/src/refractor/plugins/{normalize-header-examples/index.cjs → normalize-header-examples.cjs}

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-var _NormalizeStorage = _interopRequireDefault(require("./NormalizeStorage.cjs"));
+var _index = _interopRequireDefault(require("./normalize-storage/index.cjs"));
 /**
  * Override of Schema.example and Schema.examples field inside the Header Objects.
  *
@@ -28,8 +28,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -37,7 +36,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _NormalizeStorage.default(element, storageField, 'header-examples');
+          storage = new _index.default(element, storageField, 'header-examples');
         },
         leave() {
           storage = undefined;
@@ -61,7 +60,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)) {

package/src/refractor/plugins/{normalize-header-examples/index.mjs → normalize-header-examples.mjs}

@@ -1,5 +1,5 @@
 import { cloneDeep } from '@speclynx/apidom-datamodel';
-import NormalizeStorage from "./NormalizeStorage.mjs";
+import NormalizeStorage from "./normalize-storage/index.mjs";
 /**
  * Override of Schema.example and Schema.examples field inside the Header Objects.
  *
@@ -22,8 +22,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -55,7 +54,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)) {

package/src/refractor/plugins/normalize-operation-ids.cjs

@@ -6,7 +6,7 @@ exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _apidomCore = require("@speclynx/apidom-core");
-var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
+var _index = _interopRequireDefault(require("./normalize-storage/index.cjs"));
 const removeSpaces = operationId => {
   return operationId.replace(/\s/g, '');
 };
@@ -53,7 +53,6 @@ const plugin = ({
 } = {}) => toolbox => {
   const {
     predicates,
-    ancestorLineageToJSONPointer,
     namespace
   } = toolbox;
   const pathTemplates = [];
@@ -65,7 +64,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _NormalizeStorage.default(element, storageField, 'operation-ids');
+          storage = new _index.default(element, storageField, 'operation-ids');
         },
         leave() {
           // group normalized operations by normalized operationId
@@ -120,11 +119,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)) {

package/src/refractor/plugins/normalize-operation-ids.mjs

@@ -1,7 +1,7 @@
 import { last, defaultTo, groupBy } from 'ramda';
 import { cloneDeep } from '@speclynx/apidom-datamodel';
 import { toValue } from '@speclynx/apidom-core';
-import NormalizeStorage from "./normalize-header-examples/NormalizeStorage.mjs";
+import NormalizeStorage from "./normalize-storage/index.mjs";
 const removeSpaces = operationId => {
   return operationId.replace(/\s/g, '');
 };
@@ -48,7 +48,6 @@ const plugin = ({
 } = {}) => toolbox => {
   const {
     predicates,
-    ancestorLineageToJSONPointer,
     namespace
   } = toolbox;
   const pathTemplates = [];
@@ -115,11 +114,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)) {

package/src/refractor/plugins/normalize-parameter-examples.cjs

@@ -4,7 +4,7 @@ var _interopRequireDefault = require("@babel/runtime-corejs3/helpers/interopRequ
 exports.__esModule = true;
 exports.default = void 0;
 var _apidomDatamodel = require("@speclynx/apidom-datamodel");
-var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
+var _index = _interopRequireDefault(require("./normalize-storage/index.cjs"));
 /**
  * Override of Schema.example and Schema.examples field inside the Parameter Objects.
  *
@@ -28,8 +28,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -37,7 +36,7 @@ const plugin = ({
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _NormalizeStorage.default(element, storageField, 'parameter-examples');
+          storage = new _index.default(element, storageField, 'parameter-examples');
         },
         leave() {
           storage = undefined;
@@ -61,7 +60,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)) {

package/src/refractor/plugins/normalize-parameter-examples.mjs

@@ -1,5 +1,5 @@
 import { cloneDeep } from '@speclynx/apidom-datamodel';
-import NormalizeStorage from "./normalize-header-examples/NormalizeStorage.mjs";
+import NormalizeStorage from "./normalize-storage/index.mjs";
 /**
  * Override of Schema.example and Schema.examples field inside the Parameter Objects.
  *
@@ -22,8 +22,7 @@ const plugin = ({
   storageField = 'x-normalized'
 } = {}) => toolbox => {
   const {
-    predicates,
-    ancestorLineageToJSONPointer
+    predicates
   } = toolbox;
   let storage;
   return {
@@ -55,7 +54,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)) {

package/src/refractor/plugins/normalize-parameters.cjs

@@ -5,8 +5,10 @@ exports.__esModule = true;
 exports.default = void 0;
 var _ramda = require("ramda");
 var _apidomCore = require("@speclynx/apidom-core");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
 var _apidomNsOpenapi = require("@speclynx/apidom-ns-openapi-3-0");
-var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examples/NormalizeStorage.cjs"));
+var _index = _interopRequireDefault(require("./normalize-storage/index.cjs"));
+var _predicates = require("../../predicates.cjs");
 /**
  * Inheritance of Parameter Objects.
  *
@@ -20,6 +22,38 @@ var _NormalizeStorage = _interopRequireDefault(require("./normalize-header-examp
  * @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.isParameterElement)(parameter1)) return false;
+  if (!(0, _predicates.isParameterElement)(parameter2)) return false;
+  if (!(0, _apidomDatamodel.isStringElement)(parameter1.name)) return false;
+  if (!(0, _apidomDatamodel.isStringElement)(parameter1.in)) return false;
+  if (!(0, _apidomDatamodel.isStringElement)(parameter2.name)) return false;
+  if (!(0, _apidomDatamodel.isStringElement)(parameter2.in)) return false;
+  return (0, _apidomCore.toValue)(parameter1.name) === (0, _apidomCore.toValue)(parameter2.name) && (0, _apidomCore.toValue)(parameter1.in) === (0, _apidomCore.toValue)(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, _apidomDatamodel.isArrayElement)(pathItemElement.parameters) ? [...pathItemElement.parameters] : [];
+  if (pathItemParams.length === 0) return;
+  const operationParams = (0, _apidomDatamodel.isArrayElement)(operationElement.parameters) ? [...operationElement.parameters] : [];
+
+  // prefers the first item if two items compare equal based on the predicate
+  const mergedParameters = (0, _ramda.uniqWith)(parameterEquals, [...operationParams, ...pathItemParams]);
+  operationElement.parameters = new _apidomNsOpenapi.OperationParametersElement(mergedParameters);
+};
+
 /**
  * @public
  */
@@ -27,83 +61,47 @@ 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, _apidomCore.toValue)(parameter1.name) === (0, _apidomCore.toValue)(parameter2.name) && (0, _apidomCore.toValue)(parameter1.in) === (0, _apidomCore.toValue)(parameter2.in);
-  };
-  const pathItemParameters = [];
   let storage;
   return {
     visitor: {
       OpenApi3_1Element: {
         enter(path) {
           const element = path.node;
-          storage = new _NormalizeStorage.default(element, storageField, 'parameters');
+          storage = new _index.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.last)(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.pathOr)([], ['parameters', 'content'], operationElement);
-
-          // prefers the first item if two items compare equal based on the predicate
-          const mergedParameters = (0, _ramda.uniqWith)(parameterEquals, [...operationParameters, ...parentPathItemParameters]);
-          operationElement.parameters = new _apidomNsOpenapi.OperationParametersElement(mergedParameters);
+          inheritParametersToOperation(operationElement, parentPathItemElement);
           storage.append(operationJSONPointer);
         }
       }
     }
   };
 };
+plugin.inheritParametersToOperation = inheritParametersToOperation;
 var _default = exports.default = plugin;

package/src/refractor/plugins/normalize-parameters.mjs

@@ -1,7 +1,9 @@
-import { uniqWith, pathOr, last } from 'ramda';
+import { uniqWith } from 'ramda';
 import { toValue } from '@speclynx/apidom-core';
+import { isStringElement, isArrayElement } from '@speclynx/apidom-datamodel';
 import { OperationParametersElement } from '@speclynx/apidom-ns-openapi-3-0';
-import NormalizeStorage from "./normalize-header-examples/NormalizeStorage.mjs";
+import NormalizeStorage from "./normalize-storage/index.mjs";
+import { isParameterElement } from "../../predicates.mjs";
 /**
  * Inheritance of Parameter Objects.
  *
@@ -14,6 +16,38 @@ import NormalizeStorage from "./normalize-header-examples/NormalizeStorage.mjs";
  * NOTE: this plugin is idempotent
  * @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 (!isParameterElement(parameter1)) return false;
+  if (!isParameterElement(parameter2)) return false;
+  if (!isStringElement(parameter1.name)) return false;
+  if (!isStringElement(parameter1.in)) return false;
+  if (!isStringElement(parameter2.name)) return false;
+  if (!isStringElement(parameter2.in)) return false;
+  return toValue(parameter1.name) === toValue(parameter2.name) && toValue(parameter1.in) === toValue(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 = isArrayElement(pathItemElement.parameters) ? [...pathItemElement.parameters] : [];
+  if (pathItemParams.length === 0) return;
+  const operationParams = isArrayElement(operationElement.parameters) ? [...operationElement.parameters] : [];
+
+  // prefers the first item if two items compare equal based on the predicate
+  const mergedParameters = uniqWith(parameterEquals, [...operationParams, ...pathItemParams]);
+  operationElement.parameters = new OperationParametersElement(mergedParameters);
+};
+
 /**
  * @public
  */
@@ -21,24 +55,8 @@ 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 toValue(parameter1.name) === toValue(parameter2.name) && toValue(parameter1.in) === toValue(parameter2.in);
-  };
-  const pathItemParameters = [];
   let storage;
   return {
     visitor: {
@@ -51,53 +69,33 @@ const plugin = ({
           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 = last(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 = pathOr([], ['parameters', 'content'], operationElement);
-
-          // prefers the first item if two items compare equal based on the predicate
-          const mergedParameters = uniqWith(parameterEquals, [...operationParameters, ...parentPathItemParameters]);
-          operationElement.parameters = new OperationParametersElement(mergedParameters);
+          inheritParametersToOperation(operationElement, parentPathItemElement);
           storage.append(operationJSONPointer);
         }
       }
     }
   };
 };
+plugin.inheritParametersToOperation = inheritParametersToOperation;
 export default plugin;