@speclynx/apidom-ns-openapi-3-1 1.12.1 → 2.0.1

package/src/refractor/plugins/replace-empty-element.mjs

@@ -1,4 +1,6 @@
-import { ArrayElement, ObjectElement, cloneDeep, toValue } from '@speclynx/apidom-core';
+import { ArrayElement, ObjectElement, isStringElement, isArrayElement, isMemberElement, includesClasses, cloneDeep, SourceMapElement } from '@speclynx/apidom-datamodel';
+import { toValue } from '@speclynx/apidom-core';
+import { getNodeType } from '@speclynx/apidom-traverse';
 import { ServersElement, SecurityElement, TagsElement, ServerVariablesElement, ComponentsSchemasElement, ComponentsResponsesElement, ComponentsParametersElement, ComponentsExamplesElement, ComponentsRequestBodiesElement, ComponentsHeadersElement, ComponentsSecuritySchemesElement, ComponentsLinksElement, ComponentsCallbacksElement, PathItemServersElement, PathItemParametersElement, OperationParametersElement, ParameterExamplesElement, ParameterContentElement, HeaderExamplesElement, HeaderContentElement, OperationTagsElement, OperationCallbacksElement, OperationSecurityElement, OperationServersElement, RequestBodyContentElement, MediaTypeExamplesElement, MediaTypeEncodingElement, EncodingHeadersElement, ResponseHeadersElement, ResponseContentElement, ResponseLinksElement, DiscriminatorMappingElement, OAuthFlowScopesElement } from '@speclynx/apidom-ns-openapi-3-0';
 
 /**
@@ -34,7 +36,6 @@ import SecurityRequirementElement from "../../elements/SecurityRequirement.mjs";
 import TagElement from "../../elements/Tag.mjs"; // non-concrete Elements (NCEs)
 import ComponentsPathItemsElement from "../../elements/nces/ComponentsPathItems.mjs";
 import WebhooksElement from "../../elements/nces/Webhooks.mjs";
-import { getNodeType } from "../../traversal/visitor.mjs";
 /**
  * This plugin is specific to YAML 1.2 format, which allows defining key-value pairs
  * with empty key, empty value, or both. If the value is not provided in YAML format,
@@ -68,7 +69,6 @@ import { getNodeType } from "../../traversal/visitor.mjs";
  *      (StringElement)
  *      (InfoElement))
  */
-
 const schema = {
   // concrete types handling (CTs)
   OpenApi3_1Element: {
@@ -618,7 +618,7 @@ const schema = {
   }
 };
 const findElementFactory = (ancestor, keyName) => {
-  const elementType = getNodeType(ancestor); // @ts-ignore
+  const elementType = getNodeType(ancestor);
   const keyMapping = schema[elementType] || schema[toValue(ancestor.classes.first)];
   return typeof keyMapping === 'undefined' ? undefined : Object.hasOwn(keyMapping, '[key: *]') ? keyMapping['[key: *]'] : keyMapping[keyName];
 };
@@ -626,31 +626,32 @@ const findElementFactory = (ancestor, keyName) => {
 /**
  * @public
  */
-const plugin = () => ({
-  predicates
-}) => {
-  const isEmptyElement = element => predicates.isStringElement(element) && predicates.includesClasses(['yaml-e-node', 'yaml-e-scalar'], element);
+const plugin = () => () => {
+  const isEmptyElement = element => isStringElement(element) && includesClasses(element, ['yaml-e-node', 'yaml-e-scalar']);
   return {
     visitor: {
-      StringElement(element, key, parent, path, ancestors) {
-        if (!isEmptyElement(element)) return undefined;
-        const lineage = [...ancestors, parent].filter(predicates.isElement);
+      StringElement(path) {
+        const element = path.node;
+        if (!isEmptyElement(element)) return;
+        const lineage = path.getAncestorNodes().reverse(); // root to parent
         const parentElement = lineage.at(-1);
         let elementFactory;
         let context;
-        if (predicates.isArrayElement(parentElement)) {
+        if (isArrayElement(parentElement)) {
           context = element;
           elementFactory = findElementFactory(parentElement, '<*>');
-        } else if (predicates.isMemberElement(parentElement)) {
+        } else if (isMemberElement(parentElement)) {
           context = lineage.at(-2);
           elementFactory = findElementFactory(context, toValue(parentElement.key));
         }
 
         // no element factory found
-        if (typeof elementFactory !== 'function') return undefined;
-        return elementFactory.call({
+        if (typeof elementFactory !== 'function') return;
+        const newElement = elementFactory.call({
           context
         }, undefined, cloneDeep(element.meta), cloneDeep(element.attributes));
+        SourceMapElement.transfer(element, newElement);
+        path.replaceWith(newElement);
       }
     }
   };

package/src/refractor/predicates.cjs

@@ -0,0 +1,36 @@
+"use strict";
+
+exports.__esModule = true;
+exports.isTagLikeElement = exports.isServerLikeElement = exports.isReferenceLikeElement = exports.isOpenApiExtension = void 0;
+var _ramda = require("ramda");
+var _apidomDatamodel = require("@speclynx/apidom-datamodel");
+var _apidomCore = require("@speclynx/apidom-core");
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+const isReferenceLikeElement = element => {
+  return (0, _apidomDatamodel.isObjectElement)(element) && element.hasKey('$ref');
+};
+
+/**
+ * @public
+ */
+exports.isReferenceLikeElement = isReferenceLikeElement;
+const isServerLikeElement = exports.isServerLikeElement = _apidomDatamodel.isObjectElement;
+
+/**
+ * @public
+ */
+const isTagLikeElement = exports.isTagLikeElement = _apidomDatamodel.isObjectElement;
+
+/**
+ * @public
+ */
+const isOpenApiExtension = element => {
+  return (0, _apidomDatamodel.isStringElement)(element.key) && (0, _ramda.startsWith)('x-', (0, _apidomCore.toValue)(element.key));
+};
+exports.isOpenApiExtension = isOpenApiExtension;

package/src/refractor/predicates.mjs

@@ -0,0 +1,31 @@
+import { startsWith } from 'ramda';
+import { isStringElement, isObjectElement } from '@speclynx/apidom-datamodel';
+import { toValue } from '@speclynx/apidom-core';
+
+/**
+ * @public
+ */
+
+/**
+ * @public
+ */
+export const isReferenceLikeElement = element => {
+  return isObjectElement(element) && element.hasKey('$ref');
+};
+
+/**
+ * @public
+ */
+export const isServerLikeElement = isObjectElement;
+
+/**
+ * @public
+ */
+export const isTagLikeElement = isObjectElement;
+
+/**
+ * @public
+ */
+export const isOpenApiExtension = element => {
+  return isStringElement(element.key) && startsWith('x-', toValue(element.key));
+};

package/src/refractor/specification.cjs

@@ -11,6 +11,7 @@ var _index3 = _interopRequireDefault(require("./visitors/open-api-3-1/contact/in
 var _index4 = _interopRequireDefault(require("./visitors/open-api-3-1/license/index.cjs"));
 var _index5 = _interopRequireDefault(require("./visitors/open-api-3-1/link/index.cjs"));
 var _JsonSchemaDialectVisitor = _interopRequireDefault(require("./visitors/open-api-3-1/JsonSchemaDialectVisitor.cjs"));
+var _OpenapiVisitor = _interopRequireDefault(require("./visitors/open-api-3-1/OpenapiVisitor.cjs"));
 var _index6 = _interopRequireDefault(require("./visitors/open-api-3-1/server/index.cjs"));
 var _index7 = _interopRequireDefault(require("./visitors/open-api-3-1/server-variable/index.cjs"));
 var _index8 = _interopRequireDefault(require("./visitors/open-api-3-1/media-type/index.cjs"));
@@ -67,13 +68,20 @@ const specification = {
     document: {
       objects: {
         OpenApi: {
+          element: 'openApi3_1',
           $visitor: _index.default,
           fixedFields: {
-            openapi: _apidomNsOpenapi.specificationObj.visitors.document.objects.OpenApi.fixedFields.openapi,
+            openapi: {
+              element: 'openapi',
+              $visitor: _OpenapiVisitor.default
+            },
             info: {
               $ref: '#/visitors/document/objects/Info'
             },
-            jsonSchemaDialect: _JsonSchemaDialectVisitor.default,
+            jsonSchemaDialect: {
+              element: 'jsonSchemaDialect',
+              $visitor: _JsonSchemaDialectVisitor.default
+            },
             servers: _apidomNsOpenapi.specificationObj.visitors.document.objects.OpenApi.fixedFields.servers,
             paths: {
               $ref: '#/visitors/document/objects/Paths'
@@ -90,6 +98,7 @@ const specification = {
           }
         },
         Info: {
+          element: 'info',
           $visitor: _index2.default,
           fixedFields: {
             title: _apidomNsOpenapi.specificationObj.visitors.document.objects.Info.fixedFields.title,
@@ -108,6 +117,7 @@ const specification = {
           }
         },
         Contact: {
+          element: 'contact',
           $visitor: _index3.default,
           fixedFields: {
             name: _apidomNsOpenapi.specificationObj.visitors.document.objects.Contact.fixedFields.name,
@@ -116,6 +126,7 @@ const specification = {
           }
         },
         License: {
+          element: 'license',
           $visitor: _index4.default,
           fixedFields: {
             name: _apidomNsOpenapi.specificationObj.visitors.document.objects.License.fixedFields.name,
@@ -126,6 +137,7 @@ const specification = {
           }
         },
         Server: {
+          element: 'server',
           $visitor: _index6.default,
           fixedFields: {
             url: _apidomNsOpenapi.specificationObj.visitors.document.objects.Server.fixedFields.url,
@@ -134,6 +146,7 @@ const specification = {
           }
         },
         ServerVariable: {
+          element: 'serverVariable',
           $visitor: _index7.default,
           fixedFields: {
             enum: _apidomNsOpenapi.specificationObj.visitors.document.objects.ServerVariable.fixedFields.enum,
@@ -142,6 +155,7 @@ const specification = {
           }
         },
         Components: {
+          element: 'components',
           $visitor: _index0.default,
           fixedFields: {
             schemas: _SchemasVisitor.default,
@@ -157,16 +171,19 @@ const specification = {
           }
         },
         Paths: {
+          element: 'paths',
           $visitor: _index19.default
         },
         PathItem: {
+          element: 'pathItem',
           $visitor: _index25.default,
           fixedFields: {
             $ref: _apidomNsOpenapi.specificationObj.visitors.document.objects.PathItem.fixedFields.$ref,
             summary: _apidomNsOpenapi.specificationObj.visitors.document.objects.PathItem.fixedFields.summary,
             description: _apidomNsOpenapi.specificationObj.visitors.document.objects.PathItem.fixedFields.description,
             get: {
-              $ref: '#/visitors/document/objects/Operation'
+              $ref: '#/visitors/document/objects/Operation',
+              alias: 'getField'
             },
             put: {
               $ref: '#/visitors/document/objects/Operation'
@@ -175,7 +192,8 @@ const specification = {
               $ref: '#/visitors/document/objects/Operation'
             },
             delete: {
-              $ref: '#/visitors/document/objects/Operation'
+              $ref: '#/visitors/document/objects/Operation',
+              alias: 'deleteField'
             },
             options: {
               $ref: '#/visitors/document/objects/Operation'
@@ -194,6 +212,7 @@ const specification = {
           }
         },
         Operation: {
+          element: 'operation',
           $visitor: _index24.default,
           fixedFields: {
             tags: _apidomNsOpenapi.specificationObj.visitors.document.objects.Operation.fixedFields.tags,
@@ -215,6 +234,7 @@ const specification = {
           }
         },
         ExternalDocumentation: {
+          element: 'externalDocumentation',
           $visitor: _index17.default,
           fixedFields: {
             description: _apidomNsOpenapi.specificationObj.visitors.document.objects.ExternalDocumentation.fixedFields.description,
@@ -222,6 +242,7 @@ const specification = {
           }
         },
         Parameter: {
+          element: 'parameter',
           $visitor: _index11.default,
           fixedFields: {
             name: _apidomNsOpenapi.specificationObj.visitors.document.objects.Parameter.fixedFields.name,
@@ -242,6 +263,7 @@ const specification = {
           }
         },
         RequestBody: {
+          element: 'requestBody',
           $visitor: _index20.default,
           fixedFields: {
             description: _apidomNsOpenapi.specificationObj.visitors.document.objects.RequestBody.fixedFields.description,
@@ -250,6 +272,7 @@ const specification = {
           }
         },
         MediaType: {
+          element: 'mediaType',
           $visitor: _index8.default,
           fixedFields: {
             schema: {
@@ -261,6 +284,7 @@ const specification = {
           }
         },
         Encoding: {
+          element: 'encoding',
           $visitor: _index18.default,
           fixedFields: {
             contentType: _apidomNsOpenapi.specificationObj.visitors.document.objects.Encoding.fixedFields.contentType,
@@ -271,12 +295,14 @@ const specification = {
           }
         },
         Responses: {
+          element: 'responses',
           $visitor: _index23.default,
           fixedFields: {
             default: _apidomNsOpenapi.specificationObj.visitors.document.objects.Responses.fixedFields.default
           }
         },
         Response: {
+          element: 'response',
           $visitor: _index22.default,
           fixedFields: {
             description: _apidomNsOpenapi.specificationObj.visitors.document.objects.Response.fixedFields.description,
@@ -286,9 +312,11 @@ const specification = {
           }
         },
         Callback: {
+          element: 'callback',
           $visitor: _index21.default
         },
         Example: {
+          element: 'example',
           $visitor: _index16.default,
           fixedFields: {
             summary: _apidomNsOpenapi.specificationObj.visitors.document.objects.Example.fixedFields.summary,
@@ -298,6 +326,7 @@ const specification = {
           }
         },
         Link: {
+          element: 'link',
           $visitor: _index5.default,
           fixedFields: {
             operationRef: _apidomNsOpenapi.specificationObj.visitors.document.objects.Link.fixedFields.operationRef,
@@ -311,6 +340,7 @@ const specification = {
           }
         },
         Header: {
+          element: 'header',
           $visitor: _index12.default,
           fixedFields: {
             description: _apidomNsOpenapi.specificationObj.visitors.document.objects.Header.fixedFields.description,
@@ -329,6 +359,7 @@ const specification = {
           }
         },
         Tag: {
+          element: 'tag',
           $visitor: _index1.default,
           fixedFields: {
             name: _apidomNsOpenapi.specificationObj.visitors.document.objects.Tag.fixedFields.name,
@@ -339,6 +370,7 @@ const specification = {
           }
         },
         Reference: {
+          element: 'reference',
           $visitor: _index10.default,
           fixedFields: {
             $ref: _apidomNsOpenapi.specificationObj.visitors.document.objects.Reference.fixedFields.$ref,
@@ -357,6 +389,7 @@ const specification = {
           ...LinkDescriptionVisitor
         },
         Schema: {
+          element: 'schema',
           $visitor: _index13.default,
           fixedFields: {
             ...JSONSchemaVisitor.fixedFields,
@@ -422,6 +455,7 @@ const specification = {
           }
         },
         Discriminator: {
+          element: 'discriminator',
           $visitor: _index14.default,
           fixedFields: {
             propertyName: _apidomNsOpenapi.specificationObj.visitors.document.objects.Discriminator.fixedFields.propertyName,
@@ -429,6 +463,7 @@ const specification = {
           }
         },
         XML: {
+          element: 'xml',
           $visitor: _index15.default,
           fixedFields: {
             name: _apidomNsOpenapi.specificationObj.visitors.document.objects.XML.fixedFields.name,
@@ -439,6 +474,7 @@ const specification = {
           }
         },
         SecurityScheme: {
+          element: 'securityScheme',
           $visitor: _index26.default,
           fixedFields: {
             type: _apidomNsOpenapi.specificationObj.visitors.document.objects.SecurityScheme.fixedFields.type,
@@ -454,6 +490,7 @@ const specification = {
           }
         },
         OAuthFlows: {
+          element: 'oAuthFlows',
           $visitor: _index27.default,
           fixedFields: {
             implicit: {
@@ -471,6 +508,7 @@ const specification = {
           }
         },
         OAuthFlow: {
+          element: 'oAuthFlow',
           $visitor: _index28.default,
           fixedFields: {
             authorizationUrl: _apidomNsOpenapi.specificationObj.visitors.document.objects.OAuthFlow.fixedFields.authorizationUrl,
@@ -480,6 +518,7 @@ const specification = {
           }
         },
         SecurityRequirement: {
+          element: 'securityRequirement',
           $visitor: _index9.default
         }
       },

package/src/refractor/specification.mjs

@@ -6,6 +6,7 @@ import ContactVisitor from "./visitors/open-api-3-1/contact/index.mjs";
 import LicenseVisitor from "./visitors/open-api-3-1/license/index.mjs";
 import LinkVisitor from "./visitors/open-api-3-1/link/index.mjs";
 import JsonSchemaDialectVisitor from "./visitors/open-api-3-1/JsonSchemaDialectVisitor.mjs";
+import OpenapiVisitor from "./visitors/open-api-3-1/OpenapiVisitor.mjs";
 import ServerVisitor from "./visitors/open-api-3-1/server/index.mjs";
 import ServerVariableVisitor from "./visitors/open-api-3-1/server-variable/index.mjs";
 import MediaTypeVisitor from "./visitors/open-api-3-1/media-type/index.mjs";
@@ -62,13 +63,20 @@ const specification = {
     document: {
       objects: {
         OpenApi: {
+          element: 'openApi3_1',
           $visitor: OpenApi3_1Visitor,
           fixedFields: {
-            openapi: OpenApi3_0Specification.visitors.document.objects.OpenApi.fixedFields.openapi,
+            openapi: {
+              element: 'openapi',
+              $visitor: OpenapiVisitor
+            },
             info: {
               $ref: '#/visitors/document/objects/Info'
             },
-            jsonSchemaDialect: JsonSchemaDialectVisitor,
+            jsonSchemaDialect: {
+              element: 'jsonSchemaDialect',
+              $visitor: JsonSchemaDialectVisitor
+            },
             servers: OpenApi3_0Specification.visitors.document.objects.OpenApi.fixedFields.servers,
             paths: {
               $ref: '#/visitors/document/objects/Paths'
@@ -85,6 +93,7 @@ const specification = {
           }
         },
         Info: {
+          element: 'info',
           $visitor: InfoVisitor,
           fixedFields: {
             title: OpenApi3_0Specification.visitors.document.objects.Info.fixedFields.title,
@@ -103,6 +112,7 @@ const specification = {
           }
         },
         Contact: {
+          element: 'contact',
           $visitor: ContactVisitor,
           fixedFields: {
             name: OpenApi3_0Specification.visitors.document.objects.Contact.fixedFields.name,
@@ -111,6 +121,7 @@ const specification = {
           }
         },
         License: {
+          element: 'license',
           $visitor: LicenseVisitor,
           fixedFields: {
             name: OpenApi3_0Specification.visitors.document.objects.License.fixedFields.name,
@@ -121,6 +132,7 @@ const specification = {
           }
         },
         Server: {
+          element: 'server',
           $visitor: ServerVisitor,
           fixedFields: {
             url: OpenApi3_0Specification.visitors.document.objects.Server.fixedFields.url,
@@ -129,6 +141,7 @@ const specification = {
           }
         },
         ServerVariable: {
+          element: 'serverVariable',
           $visitor: ServerVariableVisitor,
           fixedFields: {
             enum: OpenApi3_0Specification.visitors.document.objects.ServerVariable.fixedFields.enum,
@@ -137,6 +150,7 @@ const specification = {
           }
         },
         Components: {
+          element: 'components',
           $visitor: ComponentsVisitor,
           fixedFields: {
             schemas: ComponentsSchemasVisitor,
@@ -152,16 +166,19 @@ const specification = {
           }
         },
         Paths: {
+          element: 'paths',
           $visitor: PathsVisitor
         },
         PathItem: {
+          element: 'pathItem',
           $visitor: PathItemVisitor,
           fixedFields: {
             $ref: OpenApi3_0Specification.visitors.document.objects.PathItem.fixedFields.$ref,
             summary: OpenApi3_0Specification.visitors.document.objects.PathItem.fixedFields.summary,
             description: OpenApi3_0Specification.visitors.document.objects.PathItem.fixedFields.description,
             get: {
-              $ref: '#/visitors/document/objects/Operation'
+              $ref: '#/visitors/document/objects/Operation',
+              alias: 'getField'
             },
             put: {
               $ref: '#/visitors/document/objects/Operation'
@@ -170,7 +187,8 @@ const specification = {
               $ref: '#/visitors/document/objects/Operation'
             },
             delete: {
-              $ref: '#/visitors/document/objects/Operation'
+              $ref: '#/visitors/document/objects/Operation',
+              alias: 'deleteField'
             },
             options: {
               $ref: '#/visitors/document/objects/Operation'
@@ -189,6 +207,7 @@ const specification = {
           }
         },
         Operation: {
+          element: 'operation',
           $visitor: OperationVisitor,
           fixedFields: {
             tags: OpenApi3_0Specification.visitors.document.objects.Operation.fixedFields.tags,
@@ -210,6 +229,7 @@ const specification = {
           }
         },
         ExternalDocumentation: {
+          element: 'externalDocumentation',
           $visitor: ExternalDocumentationVisitor,
           fixedFields: {
             description: OpenApi3_0Specification.visitors.document.objects.ExternalDocumentation.fixedFields.description,
@@ -217,6 +237,7 @@ const specification = {
           }
         },
         Parameter: {
+          element: 'parameter',
           $visitor: ParameterVisitor,
           fixedFields: {
             name: OpenApi3_0Specification.visitors.document.objects.Parameter.fixedFields.name,
@@ -237,6 +258,7 @@ const specification = {
           }
         },
         RequestBody: {
+          element: 'requestBody',
           $visitor: RequestBodyVisitor,
           fixedFields: {
             description: OpenApi3_0Specification.visitors.document.objects.RequestBody.fixedFields.description,
@@ -245,6 +267,7 @@ const specification = {
           }
         },
         MediaType: {
+          element: 'mediaType',
           $visitor: MediaTypeVisitor,
           fixedFields: {
             schema: {
@@ -256,6 +279,7 @@ const specification = {
           }
         },
         Encoding: {
+          element: 'encoding',
           $visitor: EncodingVisitor,
           fixedFields: {
             contentType: OpenApi3_0Specification.visitors.document.objects.Encoding.fixedFields.contentType,
@@ -266,12 +290,14 @@ const specification = {
           }
         },
         Responses: {
+          element: 'responses',
           $visitor: ResponsesVisitor,
           fixedFields: {
             default: OpenApi3_0Specification.visitors.document.objects.Responses.fixedFields.default
           }
         },
         Response: {
+          element: 'response',
           $visitor: ResponseVisitor,
           fixedFields: {
             description: OpenApi3_0Specification.visitors.document.objects.Response.fixedFields.description,
@@ -281,9 +307,11 @@ const specification = {
           }
         },
         Callback: {
+          element: 'callback',
           $visitor: CallbackVisitor
         },
         Example: {
+          element: 'example',
           $visitor: ExampleVisitor,
           fixedFields: {
             summary: OpenApi3_0Specification.visitors.document.objects.Example.fixedFields.summary,
@@ -293,6 +321,7 @@ const specification = {
           }
         },
         Link: {
+          element: 'link',
           $visitor: LinkVisitor,
           fixedFields: {
             operationRef: OpenApi3_0Specification.visitors.document.objects.Link.fixedFields.operationRef,
@@ -306,6 +335,7 @@ const specification = {
           }
         },
         Header: {
+          element: 'header',
           $visitor: HeaderVisitor,
           fixedFields: {
             description: OpenApi3_0Specification.visitors.document.objects.Header.fixedFields.description,
@@ -324,6 +354,7 @@ const specification = {
           }
         },
         Tag: {
+          element: 'tag',
           $visitor: TagVisitor,
           fixedFields: {
             name: OpenApi3_0Specification.visitors.document.objects.Tag.fixedFields.name,
@@ -334,6 +365,7 @@ const specification = {
           }
         },
         Reference: {
+          element: 'reference',
           $visitor: ReferenceVisitor,
           fixedFields: {
             $ref: OpenApi3_0Specification.visitors.document.objects.Reference.fixedFields.$ref,
@@ -352,6 +384,7 @@ const specification = {
           ...LinkDescriptionVisitor
         },
         Schema: {
+          element: 'schema',
           $visitor: SchemaVisitor,
           fixedFields: {
             ...JSONSchemaVisitor.fixedFields,
@@ -417,6 +450,7 @@ const specification = {
           }
         },
         Discriminator: {
+          element: 'discriminator',
           $visitor: DiscriminatorVisitor,
           fixedFields: {
             propertyName: OpenApi3_0Specification.visitors.document.objects.Discriminator.fixedFields.propertyName,
@@ -424,6 +458,7 @@ const specification = {
           }
         },
         XML: {
+          element: 'xml',
           $visitor: XmlVisitor,
           fixedFields: {
             name: OpenApi3_0Specification.visitors.document.objects.XML.fixedFields.name,
@@ -434,6 +469,7 @@ const specification = {
           }
         },
         SecurityScheme: {
+          element: 'securityScheme',
           $visitor: SecuritySchemeVisitor,
           fixedFields: {
             type: OpenApi3_0Specification.visitors.document.objects.SecurityScheme.fixedFields.type,
@@ -449,6 +485,7 @@ const specification = {
           }
         },
         OAuthFlows: {
+          element: 'oAuthFlows',
           $visitor: OAuthFlowsVisitor,
           fixedFields: {
             implicit: {
@@ -466,6 +503,7 @@ const specification = {
           }
         },
         OAuthFlow: {
+          element: 'oAuthFlow',
           $visitor: OAuthFlowVisitor,
           fixedFields: {
             authorizationUrl: OpenApi3_0Specification.visitors.document.objects.OAuthFlow.fixedFields.authorizationUrl,
@@ -475,6 +513,7 @@ const specification = {
           }
         },
         SecurityRequirement: {
+          element: 'securityRequirement',
           $visitor: SecurityRequirementVisitor
         }
       },