@swagger-api/apidom-ns-openapi-3-1 1.0.0-beta.9 → 1.0.0-rc.0

package/CHANGELOG.md

@@ -3,6 +3,193 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.0.0-rc.0](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.51...v1.0.0-rc.0) (2025-10-21)
+
+### Performance Improvements
+
+- flatten sourceMap to improve memory usage ([#4964](https://github.com/swagger-api/apidom/issues/4964)) ([bda1edf](https://github.com/swagger-api/apidom/commit/bda1edf7b1b37adc728b8632337b22866e33fa4a))
+
+# [1.0.0-beta.51](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.50...v1.0.0-beta.51) (2025-10-14)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.50](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.49...v1.0.0-beta.50) (2025-09-26)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.49](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.48...v1.0.0-beta.49) (2025-09-22)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.48](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.47...v1.0.0-beta.48) (2025-09-09)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.47](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.46...v1.0.0-beta.47) (2025-09-01)
+
+### Features
+
+- **ls:** disable newly added rules for 3.1 spec ([#4997](https://github.com/swagger-api/apidom/issues/4997)) ([d5b16f8](https://github.com/swagger-api/apidom/commit/d5b16f82a916aea70929d2f3ff5be04769d8d8d3))
+
+# [1.0.0-beta.46](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.45...v1.0.0-beta.46) (2025-08-19)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.45](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.44...v1.0.0-beta.45) (2025-08-01)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.44](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.43...v1.0.0-beta.44) (2025-07-07)
+
+### Features
+
+- add PoC of handling discriminator for allOf case in OpenAPI 3.1 ([#4959](https://github.com/swagger-api/apidom/issues/4959)) ([4eee665](https://github.com/swagger-api/apidom/commit/4eee66574c9ff4ab08cbd3f89d32247d07cde7e2))
+- add PoC of handling discriminator for oneOf/anyOf cases in OpenAPI 3.1 ([#4952](https://github.com/swagger-api/apidom/issues/4952)) ([e8ddbb7](https://github.com/swagger-api/apidom/commit/e8ddbb7522476903a153474cd6a00a2d505735db))
+
+# [1.0.0-beta.43](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.42...v1.0.0-beta.43) (2025-06-13)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.42](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.41...v1.0.0-beta.42) (2025-06-06)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.41](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.40...v1.0.0-beta.41) (2025-06-04)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.40](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.39...v1.0.0-beta.40) (2025-05-30)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.39](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.38...v1.0.0-beta.39) (2025-05-20)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.38](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.37...v1.0.0-beta.38) (2025-05-16)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.37](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.36...v1.0.0-beta.37) (2025-05-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.36](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.35...v1.0.0-beta.36) (2025-05-06)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.35](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.34...v1.0.0-beta.35) (2025-05-02)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.34](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.33...v1.0.0-beta.34) (2025-05-02)
+
+### Bug Fixes
+
+- **ns-openapi-3-1:** use spec compliant JSON Pointer implementation ([#4880](https://github.com/swagger-api/apidom/issues/4880)) ([9499aa8](https://github.com/swagger-api/apidom/commit/9499aa8733445f15ec7441c7f87b89dab8542c49)), closes [#4870](https://github.com/swagger-api/apidom/issues/4870)
+
+# [1.0.0-beta.33](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.32...v1.0.0-beta.33) (2025-04-30)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.32](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.31...v1.0.0-beta.32) (2025-04-28)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.31](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.30...v1.0.0-beta.31) (2025-04-24)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.30](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.29...v1.0.0-beta.30) (2025-03-17)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.29](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.28...v1.0.0-beta.29) (2025-03-17)
+
+### Bug Fixes
+
+- **security:** eliminate CVE-2025-27789 ([#4797](https://github.com/swagger-api/apidom/issues/4797)) ([af335c3](https://github.com/swagger-api/apidom/commit/af335c3d53616b7991acc74329e61d350398997a))
+
+# [1.0.0-beta.28](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.27...v1.0.0-beta.28) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.27](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.26...v1.0.0-beta.27) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.26](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.25...v1.0.0-beta.26) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.25](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.24...v1.0.0-beta.25) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.24](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.23...v1.0.0-beta.24) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.23](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.22...v1.0.0-beta.23) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.22](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.21...v1.0.0-beta.22) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.21](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.20...v1.0.0-beta.21) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.20](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.19...v1.0.0-beta.20) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.19](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.18...v1.0.0-beta.19) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.18](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.17...v1.0.0-beta.18) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.17](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.16...v1.0.0-beta.17) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.16](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.15...v1.0.0-beta.16) (2025-03-12)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.15](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.14...v1.0.0-beta.15) (2025-03-11)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.14](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.13...v1.0.0-beta.14) (2025-03-11)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.13](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.12...v1.0.0-beta.13) (2025-03-10)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
+# [1.0.0-beta.12](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.11...v1.0.0-beta.12) (2025-02-11)
+
+### Bug Fixes
+
+- **ns-openapi-3-1:** import only JSON Schema 2020-12 namespace ([#4716](https://github.com/swagger-api/apidom/issues/4716)) ([ab1ca15](https://github.com/swagger-api/apidom/commit/ab1ca15aeecc0d8e8621afb706ec76ee007183d1)), closes [#4705](https://github.com/swagger-api/apidom/issues/4705)
+
+# [1.0.0-beta.11](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.10...v1.0.0-beta.11) (2025-01-27)
+
+### Features
+
+- **ns-openapi-3-1:** use JSON Schema 2020-12 namespace ([#4691](https://github.com/swagger-api/apidom/issues/4691)) ([f68adb7](https://github.com/swagger-api/apidom/commit/f68adb7645b692152c80537828247e9ad71e5933)), closes [#1822](https://github.com/swagger-api/apidom/issues/1822)
+
+# [1.0.0-beta.10](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.9...v1.0.0-beta.10) (2025-01-25)
+
+**Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1
+
 # [1.0.0-beta.9](https://github.com/swagger-api/apidom/compare/v1.0.0-beta.8...v1.0.0-beta.9) (2025-01-23)
 
 **Note:** Version bump only for package @swagger-api/apidom-ns-openapi-3-1

package/README.md

@@ -52,7 +52,7 @@ isOpenApi3_1Element(openApiElement); // => true
 
 ## Traversal
 
-Traversing ApiDOM in this namespace is possible by using `visit` function from `apidom` package.
+Traversing ApiDOM in this namespace is possible by using `visit` function from `apidom-core` package.
 This package comes with its own [keyMap](https://github.com/swagger-api/apidom/blob/main/packages/apidom-ns-openapi-3-1/src/traversal/visitor.ts#L11) and [nodeTypeGetter](https://github.com/swagger-api/apidom/blob/main/packages/apidom-ns-openapi-3-1/src/traversal/visitor.ts#L4).
 To learn more about these `visit` configuration options please refer to [@swagger-api/apidom-ast documentation](https://github.com/swagger-api/apidom/blob/main/packages/apidom-ast/README.md#visit).
 
@@ -139,6 +139,7 @@ InfoElement.refract(objectElement, { plugins: [plugin] }); // => InfoElement({ t
 
 You can define as many plugins as needed to enhance the resulting namespaced ApiDOM structure.
 If multiple plugins with the same visitor method are defined, they run in parallel (just like in Babel).
+All the plugins available in `@swagger-api/apidom-ns-openapi-3-1` are idempotent and the normalization state is stored in the root `OpenApi3_1Element` in `<storageField>`. `<storageField>` can be customized in the plugin configuration (default: `x-normalized`).
 
 #### Replace Empty Element plugin
 
@@ -431,6 +432,375 @@ toValue(openApiElement);
 //   }
 // }
 ```
+#### Normalize Parameter examples plugin
+
+`parameter.examples` and `parameter.example` override `parameter.schema.examples` and `parameter.schema.example` fields. The plugin overrides only the existing `parameter.schema.examples` and `parameter.schema.example`.
+
+- Does not apply to parameters defined under `components`.
+- `parameter.examples` has precedence over deprecated `parameter.example`.
+
+```js 
+import { toValue } from '@swagger-api/apidom-core';
+import { OpenApi3_1Element, refractorPluginNormalizeParameterExamples } from '@swagger-api/apidom-ns-openapi-3-1';
+import { parse } from '@swagger-api/apidom-parser-adapter-yaml-1-2';
+
+const yamlDefinition = `
+openapi: 3.1.0
+paths:
+  /:
+    get:
+      parameters:
+          - in: query
+            name: idempotent
+            schema:
+              type: number
+              examples: [1]
+            examples:
+              example1:
+                value: 2`
+
+const apiDOM = await parse(yamlDefinition);
+
+//default 
+const openApiElement = OpenApi3_1Element.refract(apiDOM.result, {
+  plugins: [refractorPluginNormalizeParameterExamples()],
+});
+toValue(openApiElement);
+// =>
+// {
+//   openapi: '3.1.0',
+//   paths: {
+//     '/': {
+//       get: {
+//         parameters: [
+//           {
+//             in: 'query',
+//             name: 'idempotent',
+//             schema: { type: 'number', examples: [ 2 ] },
+//             examples: { example1: { value: 2 } }
+//           }
+//         ]
+//       }
+//     }
+//   },
+//   'x-normalized': { 'parameter-examples': [ '/paths/~1/get/parameters/0' ] }
+// }
+
+// custom storage field name
+const openApiElementWithCustomField = OpenApi3_1Element.refract(apiDOM.result, {
+  plugins: [refractorPluginNormalizeParameterExamples({ storageField: '$$my-normalized' })],
+});
+toValue(openApiElementWithCustomField);
+// =>
+// {
+//   openapi: '3.1.0',
+//   paths: {
+//     '/': {
+//       get: {
+//         parameters: [
+//           {
+//             in: 'query',
+//             name: 'idempotent',
+//             schema: { type: 'number', examples: [2] },
+//             examples: { example1: { value: 2 } }
+//           }
+//         ]
+//       }
+//     }
+//   },
+//   '$$my-normalized': { 'parameter-examples': [ '/paths/~1/get/parameters/0' ] }
+// }
+```
+
+#### Normalize Header examples plugin
+
+`Header.examples` and `header.example` override `header.schema.examples` and `header.schema.example` fields. The plugin overrides only the existing `header.schema.examples` and `header.schema.example`.
+
+- Does not apply to headers defined under `components`.
+- `header.examples` has precedence over deprecated `header.example`.
+
+```js 
+import { toValue } from '@swagger-api/apidom-core';
+import { OpenApi3_1Element, refractorPluginNormalizeHeaderExamples } from '@swagger-api/apidom-ns-openapi-3-1';
+import { parse } from '@swagger-api/apidom-parser-adapter-yaml-1-2';
+
+const yamlDefinition = `
+openapi: 3.1.0
+paths:
+  /:
+    get:
+      responses:
+        "200":
+          headers:
+            content-type:
+              schema:
+                type: number
+                example: 1
+              examples:
+                example1:
+                  value: 2
+`
+const apiDOM = await parse(yamlDefinition);
+
+// default
+const openApiElement = OpenApi3_1Element.refract(apiDOM.result, {
+   plugins: [refractorPluginNormalizeHeaderExamples()],
+});
+toValue(openApiElement);
+// =>
+// {
+//   openapi: '3.1.0',
+//   paths: {
+//     '/': {
+//       get: {
+//         responses: {
+//           '200': {
+//             headers: {
+//               'content-type': {
+//                 schema: { type: 'number', example: 2 },
+//                 examples: { example1: { value: 2 } }
+//               }
+//             }
+//           }
+//         }
+//       }
+//     }
+//   },
+//   'x-normalized': {
+//     'header-examples': [ '/paths/~1/get/responses/200/headers/content-type' ]
+//   }
+// }
+
+// custom storage field name
+
+const openApiElementWithCustomField = OpenApi3_1Element.refract(apiDOM.result, {
+   plugins: [refractorPluginNormalizeHeaderExamples({ storageField: '$$normalized' })],
+});
+toValue(openApiElementWithCustomField);
+// =>
+// {
+//   openapi: '3.1.0',
+//   paths: {
+//     '/': {
+//       get: {
+//         responses: {
+//           '200': {
+//             headers: {
+//               'content-type': {
+//                 schema: { type: 'number', example: 2 },
+//                 examples: { example1: { value: 2 } }
+//               }
+//             }
+//           }
+//         }
+//       }
+//     }
+//   },
+//   '$$normalized': {
+//     'header-examples': [ '/paths/~1/get/responses/200/headers/content-type' ]
+//   }
+// }
+```
+
+#### Normalize Discriminator mapping plugin
+This plugin normalizes the `discriminator.mapping` field in a Schema Object by:
+
+- Converting mapping values into inline Schema Objects when possible.
+- Adding missing mapping entries based on the schema's `oneOf`, `anyOf`, or a prepared `allOf` mapping. The `allOf` mapping 
+  is created based on the schemas defined in `components.schemas` during dereferencing.
+
+The `discriminator.mapping` field is not modified by the plugin.
+
+This plugin is intended to run on dereferenced OpenAPI 3.1 documents. During dereferencing Schema Objects are annotated with meta properties and the `allOf` mapping is created for Schema Objects defined in `components.schemas`. 
+
+```json 
+
+// fixture-example.json
+{
+  "openapi": "3.1.0",
+  "components": {
+    "schemas": {
+      "MyResponse": {
+        "type": "object",
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/Cat"
+          },
+          {
+            "$ref": "#/components/schemas/Dog"
+          }
+        ],
+        "discriminator": {
+          "propertyName": "petType"
+        }
+      },
+      "Pet": {
+        "type": "object",
+        "properties": {
+          "petType": {
+            "type": "string"
+          }
+        }
+      },
+      "Cat": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Pet"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "meows": {
+                "type": "boolean"
+              }
+            }
+          }
+        ]
+      },
+      "Dog": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/Pet"
+          },
+          {
+            "type": "object",
+            "properties": {
+              "barks": {
+                "type": "boolean"
+              }
+            }
+          }
+        ]
+      }
+    }
+  }
+}
+```
+
+```js 
+import { toValue, dispatchRefractorPlugins } from '@swagger-api/apidom-core';
+import { dereference } from '@swagger-api/apidom-reference';
+import FileResolver from '@swagger-api/apidom-reference/resolve/resolvers/file';
+import {
+  createToolbox,
+  refractorPluginNormalizeDiscriminatorMapping,
+  keyMap,
+  getNodeType,
+  mediaTypes,
+} from '@swagger-api/apidom-ns-openapi-3-1';
+const uri = 'path/to/fixture-example.json'; // the arbitrary file name shown above
+
+// 1) dereference the document to annotate schemas with required metadata
+const dereferenced = await dereference(uri, {
+  parse: { mediaType: mediaTypes.latest('json') },
+  resolve: {
+    baseURI: uri,
+    resolvers: [ new FileResolver({ fileAllowList: [/\.json$/] }) ],
+  },
+  dereference: { strategyOpts: { 'openapi-3-1': { dereferenceDiscriminatorMapping: true } } },
+});
+
+// 2) dispatch the plugin and pass the same baseURI
+const normalized = dispatchRefractorPlugins(
+  dereferenced.result,
+  [refractorPluginNormalizeDiscriminatorMapping({ baseURI: uri })],
+  { toolboxCreator: createToolbox, visitorOptions: { keyMap, nodeTypeGetter: getNodeType } }
+);
+toValue(normalized)
+
+// => 
+// {
+//   openapi: '3.1.0',
+//   components: {
+//     schemas: {
+//       MyResponse: {
+//         type: 'object',
+//         oneOf: [
+//           {
+//             allOf: [
+//               {
+//                 type: 'object',
+//                 properties: { petType: { type: 'string' } }
+//               },
+//               {
+//                 type: 'object',
+//                 properties: { meows: { type: 'boolean' } }
+//               }
+//             ]
+//           },
+//           {
+//             allOf: [
+//               {
+//                 type: 'object',
+//                 properties: { petType: { type: 'string' } }
+//               },
+//               {
+//                 type: 'object',
+//                 properties: { barks: { type: 'boolean' } }
+//               }
+//             ]
+//           }
+//         ],
+//         discriminator: {
+//           propertyName: 'petType',
+//           'x-normalized-mapping': {
+//             Cat: {
+//               allOf: [
+//                 {
+//                   type: 'object',
+//                   properties: { petType: { type: 'string' } }
+//                 },
+//                 {
+//                   type: 'object',
+//                   properties: { meows: { type: 'boolean' } }
+//                 }
+//               ]
+//             },
+//             Dog: {
+//               allOf: [
+//                 {
+//                   type: 'object',
+//                   properties: { petType: { type: 'string' } }
+//                 },
+//                 {
+//                   type: 'object',
+//                   properties: { barks: { type: 'boolean' } }
+//                 }
+//               ]
+//             }
+//           }
+//         }
+//       },
+//       Pet: { type: 'object', properties: { petType: { type: 'string' } } },
+//       Cat: {
+//         allOf: [
+//           {
+//             type: 'object',
+//             properties: { petType: { type: 'string' } }
+//           },
+//           {
+//             type: 'object',
+//             properties: { meows: { type: 'boolean' } }
+//           }
+//         ]
+//       },
+//       Dog: {
+//         allOf: [
+//           {
+//             type: 'object',
+//             properties: { petType: { type: 'string' } }
+//           },
+//           {
+//             type: 'object',
+//             properties: { barks: { type: 'boolean' } }
+//           }
+//         ]
+//       }
+//     }
+//   },
+//   'x-normalized': { 'discriminator-mapping': [ '/components/schemas/MyResponse' ] }
+// }
+```
 
 ## Implementation progress