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

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [4.2.0](https://github.com/speclynx/apidom/compare/v4.1.0...v4.2.0) (2026-03-17)
+
+### Features
+
+- **ns-openapi-2-0:** add normalization refractor plugins ([#170](https://github.com/speclynx/apidom/issues/170)) ([315b5c6](https://github.com/speclynx/apidom/commit/315b5c620f752941749df13c0a5ab4bd14d41597))
+- **ns-openapi-3-0:** add normalization refractor plugins ([#169](https://github.com/speclynx/apidom/issues/169)) ([fb0ec23](https://github.com/speclynx/apidom/commit/fb0ec23dd8c933a9a4d72762f3fb643e3e11d037))
+
 # [4.1.0](https://github.com/speclynx/apidom/compare/v4.0.5...v4.1.0) (2026-03-16)
 
 ### Features

package/README.md

@@ -251,7 +251,7 @@ toValue(openApiElement);
 
 Duplicates Parameters from Path Items to Operation Objects using following rules:
 
-- If a parameter is already defined at the Path Item, the new definition will override it but can never remove it
+- An Operation-level parameter with the same name and location overrides the inherited Path Item parameter, but Path Item parameters can never be removed at the Operation level
 - The list MUST NOT include duplicated parameters
 - A unique parameter is defined by a combination of a name and location.
 
@@ -281,30 +281,31 @@ toValue(openApiElement);
 // {
 //   "openapi": "3.1.0",
 //   "paths": {
-//   "/": {
-//     "parameters": [
-//       {
-//         "name": "param1",
-//         "in": "query"
-//       },
-//       {
-//         "name": "param2",
-//         "in": "query"
-//       }
-//     ],
-//     "get": {
+//     "/": {
 //       "parameters": [
-//          {
-//            "name": "param1",
-//            "in": "query"
-//          },
-//          {
-//            "name": "param2",
-//            "in": "query"
-//          }
-//        ],
-//      }
-//    }
+//         {
+//           "name": "param1",
+//           "in": "query"
+//         },
+//         {
+//           "name": "param2",
+//           "in": "query"
+//         }
+//       ],
+//       "get": {
+//         "parameters": [
+//           {
+//             "name": "param1",
+//             "in": "query"
+//           },
+//           {
+//             "name": "param2",
+//             "in": "query"
+//           }
+//         ]
+//       }
+//     }
+//   }
 // }
 ```
 

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

@@ -1720,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)) {
@@ -2011,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)) {
@@ -2263,7 +2263,7 @@ 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)) {
@@ -2404,7 +2404,7 @@ 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;
@@ -2423,7 +2423,7 @@ const plugin = ({
       },
       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;
@@ -2434,7 +2434,7 @@ const plugin = ({
         if (storage.includes(operationJSONPointer)) {
           return;
         }
-        const parentPathItemElement = ancestors.findLast(predicates.isPathItemElement);
+        const parentPathItemElement = ancestors.find(predicates.isPathItemElement);
         if (predicates.isPathItemElement(parentPathItemElement)) {
           inheritServersToOperation(operationElement, parentPathItemElement);
           storage.append(operationJSONPointer);