feat(ns-openapi-3-1): add support for Tag Object

apidom/packages/apidom-ns-openapi-3-1/README.md

@@ -156,7 +156,7 @@ Only fully implemented specification objects should be checked here.
 - [ ] [Example Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#exampleObject)
 - [ ] [Link Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#linkObject)
 - [ ] [Header Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#headerObject)
-- [ ] [Tag Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#tagObject)
+- [x] [Tag Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#tagObject)
 - [x] [Reference Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#referenceObject)
 - [x] [Schema Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#schemaObject)
 - [x] [Discriminator Object](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.1.0.md#discriminatorObject)

apidom/packages/apidom-ns-openapi-3-1/src/elements/Tag.ts

@@ -0,0 +1,37 @@
+import { Attributes, Meta } from 'minim';
+import { ObjectElement, StringElement } from 'apidom';
+
+import ExternalDocumentationElement from './ExternalDocumentation';
+
+class Tag extends ObjectElement {
+  constructor(content?: Record<string, unknown>, meta?: Meta, attributes?: Attributes) {
+    super(content, meta, attributes);
+    this.element = 'tag';
+  }
+
+  get name(): StringElement {
+    return this.get('name');
+  }
+
+  set name(name: StringElement) {
+    this.set('name', name);
+  }
+
+  get description(): StringElement {
+    return this.get('description');
+  }
+
+  set description(description: StringElement) {
+    this.set('description', description);
+  }
+
+  get externalDocs(): ExternalDocumentationElement {
+    return this.get('externalDocs');
+  }
+
+  set externalDocs(externalDocs: ExternalDocumentationElement) {
+    this.set('externalDocs', externalDocs);
+  }
+}
+
+export default Tag;

apidom/packages/apidom-ns-openapi-3-1/src/index.ts

@@ -80,4 +80,5 @@ export { default as SecurityRequirementElement } from './elements/SecurityRequir
 export { default as SecurityScheme } from './elements/SecurityScheme';
 export { default as ServerElement } from './elements/Server';
 export { default as ServerVariableElement } from './elements/ServerVariable';
+export { default as TagElement } from './elements/Tag';
 export { default as XmlElement } from './elements/Xml';

apidom/packages/apidom-ns-openapi-3-1/src/namespace.ts

@@ -26,6 +26,7 @@ import SecurityRequirementElement from './elements/SecurityRequirement';
 import SecuritySchemeElement from './elements/SecurityScheme';
 import ServerElement from './elements/Server';
 import ServerVariableElement from './elements/ServerVariable';
+import TagElement from './elements/Tag';
 import XmlElement from './elements/Xml';
 
 const openApi3_1 = {
@@ -58,6 +59,7 @@ const openApi3_1 = {
     base.register('securityScheme', SecuritySchemeElement);
     base.register('server', ServerElement);
     base.register('serverVariable', ServerVariableElement);
+    base.register('tag', TagElement);
     base.register('xml', XmlElement);
 
     return base;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/registration.ts

@@ -24,6 +24,7 @@ import SecurityRequirementElement from '../elements/SecurityRequirement';
 import SecuritySchemeElement from '../elements/SecurityScheme';
 import ServerElement from '../elements/Server';
 import ServerVariableElement from '../elements/ServerVariable';
+import TagElement from '../elements/Tag';
 import XmlElement from '../elements/Xml';
 import { createRefractor } from './index';
 
@@ -188,4 +189,5 @@ ServerVariableElement.refract = createRefractor([
   'ServerVariable',
   '$visitor',
 ]);
+TagElement.refract = createRefractor(['visitors', 'document', 'objects', 'Tag', '$visitor']);
 XmlElement.refract = createRefractor(['visitors', 'document', 'objects', 'XML', '$visitor']);

apidom/packages/apidom-ns-openapi-3-1/src/refractor/specification.ts

@@ -29,6 +29,9 @@ import FallbackVisitor from './visitors/FallbackVisitor';
 import SecurityRequirementVisitor from './visitors/open-api-3-1/security-requirement';
 import SecurityVisitor from './visitors/open-api-3-1/SecurityVisitor';
 import ComponentsVisitor from './visitors/open-api-3-1/components';
+import TagVisitor from './visitors/open-api-3-1/tag';
+import TagNameVisitor from './visitors/open-api-3-1/tag/NameVisitor';
+import TagDescriptionVisitor from './visitors/open-api-3-1/tag/DescriptionVisitor';
 import ReferenceVisitor from './visitors/open-api-3-1/reference';
 import Reference$RefVisitor from './visitors/open-api-3-1/reference/$RefVisitor';
 import ReferenceSummaryVisitor from './visitors/open-api-3-1/reference/SummaryVisitor';
@@ -349,6 +352,16 @@ const specification = {
           $visitor: CallbackVisitor,
           fixedFields: {},
         },
+        Tag: {
+          $visitor: TagVisitor,
+          fixedFields: {
+            name: TagNameVisitor,
+            description: TagDescriptionVisitor,
+            externalDocs: {
+              $ref: '#/visitors/document/objects/ExternalDocumentation',
+            },
+          },
+        },
         Reference: {
           $visitor: ReferenceVisitor,
           fixedFields: {

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/tag/DescriptionVisitor.ts

@@ -0,0 +1,7 @@
+import stampit from 'stampit';
+
+import FallbackVisitor from '../../FallbackVisitor';
+
+const DescriptionVisitor = stampit(FallbackVisitor);
+
+export default DescriptionVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/tag/NameVisitor.ts

@@ -0,0 +1,7 @@
+import stampit from 'stampit';
+
+import FallbackVisitor from '../../FallbackVisitor';
+
+const NameVisitor = stampit(FallbackVisitor);
+
+export default NameVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/tag/index.ts

@@ -0,0 +1,18 @@
+import stampit from 'stampit';
+import { always } from 'ramda';
+
+import TagElement from '../../../../elements/Tag';
+import FallbackVisitor from '../../FallbackVisitor';
+import FixedFieldsVisitor from '../../generics/FixedFieldsVisitor';
+
+const TagVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
+  props: {
+    specPath: always(['document', 'objects', 'Tag']),
+    canSupportSpecificationExtensions: true,
+  },
+  init() {
+    this.element = new TagElement();
+  },
+});
+
+export default TagVisitor;