feat: add reference related metadata to namespaces

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/channel-item/$RefVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const $RefVisitor = FallbackVisitor;
+const $RefVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/channel-item/index.ts

@@ -1,5 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
+import { ObjectElement, isStringElement } from 'apidom';
 
 import ChannelItemElement from '../../../../elements/ChannelItem';
 import FallbackVisitor from '../../FallbackVisitor';
@@ -13,6 +14,19 @@ const ChannelItemVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
   init() {
     this.element = new ChannelItemElement();
   },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this ChannelItemElement with reference metadata
+      if (isStringElement(this.element.$ref)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
+    },
+  },
 });
 
 export default ChannelItemVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/reference/$RefVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const $RefVisitor = FallbackVisitor;
+const $RefVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/reference/index.ts

@@ -1,5 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
+import { ObjectElement, isStringElement } from 'apidom';
 
 import ReferenceElement from '../../../../elements/Reference';
 import FixedFieldsVisitor from '../../generics/FixedFieldsVisitor';
@@ -13,6 +14,19 @@ const ReferenceVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
   init() {
     this.element = new ReferenceElement();
   },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this ReferenceElement with reference metadata
+      if (isStringElement(this.element.$ref)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
+    },
+  },
 });
 
 export default ReferenceVisitor;

apidom/packages/apidom-ns-asyncapi-2-0/src/refractor/visitors/async-api-2-0/servers/index.ts

@@ -13,6 +13,7 @@ const ServersVisitor = stampit(PatternedFieldsVisitor, FallbackVisitor, {
   },
   init() {
     this.element = new ServersElement();
+    this.element.classes.push('servers');
   },
 });
 

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

@@ -136,7 +136,7 @@ import ExampleVisitor from './visitors/open-api-3-1/example';
 import ExampleSummaryVisitor from './visitors/open-api-3-1/example/SummaryVisitor';
 import ExampleDescriptionVisitor from './visitors/open-api-3-1/example/DescriptionVisitor';
 import ExampleValueVisitor from './visitors/open-api-3-1/example/ValueVisitor';
-import ExampleExternalValueVisitor from './visitors/open-api-3-1/example/ExaternalValueVisitor';
+import ExampleExternalValueVisitor from './visitors/open-api-3-1/example/ExternalValueVisitor';
 import ExternalDocumentationVisitor from './visitors/open-api-3-1/external-documentation';
 import ExternalDocumentationDescriptionVisitor from './visitors/open-api-3-1/external-documentation/DescriptionVisitor';
 import ExternalDocumentationUrlVisitor from './visitors/open-api-3-1/external-documentation/UrlVisitor';

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/example/ExternalValueVisitor.ts

@@ -0,0 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
+import FallbackVisitor from '../../FallbackVisitor';
+
+const ExternalValueVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
+
+export default ExternalValueVisitor;

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

@@ -1,5 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
+import { ObjectElement, isStringElement } from 'apidom';
 
 import ExampleElement from '../../../../elements/Example';
 import FallbackVisitor from '../../FallbackVisitor';
@@ -13,6 +14,19 @@ const ExampleVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
   init() {
     this.element = new ExampleElement();
   },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this ExampleElement with reference metadata
+      if (isStringElement(this.element.externalValue)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
+    },
+  },
 });
 
 export default ExampleVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/link/OperationIdVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const OperationIdVisitor = FallbackVisitor;
+const OperationIdVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default OperationIdVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/link/OperationRefVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const OperationRefVisitor = FallbackVisitor;
+const OperationRefVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default OperationRefVisitor;

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

@@ -1,5 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
+import { isStringElement, ObjectElement } from 'apidom';
 
 import LinkElement from '../../../../elements/Link';
 import FallbackVisitor from '../../FallbackVisitor';
@@ -13,6 +14,19 @@ const LinkVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
   init() {
     this.element = new LinkElement();
   },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this LinkElement with reference metadata
+      if (isStringElement(this.element.operationId) || isStringElement(this.element.operationRef)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
+    },
+  },
 });
 
 export default LinkVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/path-item/$RefVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const $RefVisitor = FallbackVisitor;
+const $RefVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

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

@@ -1,6 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
-import { StringElement, ObjectElement } from 'apidom';
+import { StringElement, ObjectElement, isStringElement } from 'apidom';
 
 import PathItemElement from '../../../../elements/PathItem';
 import OperationElement from '../../../../elements/Operation';
@@ -29,6 +29,11 @@ const PathItemVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
           operationElement.setMetaProperty('httpMethod', httpMethodElementCS);
         });
 
+      // mark this PathItemElement with reference metadata
+      if (isStringElement(this.element.$ref)) {
+        this.element.classes.push('reference-element');
+      }
+
       return result;
     },
   },

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/reference/$RefVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const $RefVisitor = FallbackVisitor;
+const $RefVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

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

@@ -1,5 +1,6 @@
 import stampit from 'stampit';
 import { always } from 'ramda';
+import { ObjectElement, isStringElement } from 'apidom';
 
 import ReferenceElement from '../../../../elements/Reference';
 import FixedFieldsVisitor from '../../generics/FixedFieldsVisitor';
@@ -13,6 +14,19 @@ const ReferenceVisitor = stampit(FixedFieldsVisitor, FallbackVisitor, {
   init() {
     this.element = new ReferenceElement();
   },
+  methods: {
+    ObjectElement(objectElement: ObjectElement) {
+      // @ts-ignore
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this ReferenceElement with reference metadata
+      if (isStringElement(this.element.$ref)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
+    },
+  },
 });
 
 export default ReferenceVisitor;

apidom/packages/apidom-ns-openapi-3-1/src/refractor/visitors/open-api-3-1/schema/$refVisitor.ts

@@ -1,5 +1,17 @@
+import stampit from 'stampit';
+import { StringElement, BREAK } from 'apidom';
+
 import FallbackVisitor from '../../FallbackVisitor';
 
-const $refVisitor = FallbackVisitor;
+const $refVisitor = stampit(FallbackVisitor, {
+  methods: {
+    StringElement(stringElement: StringElement) {
+      this.element = stringElement.clone();
+      this.element.classes.push('reference-value');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $refVisitor;

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

@@ -90,7 +90,14 @@ const SchemaVisitor = stampit(FixedFieldsVisitor, ParentSchemaAwareVisitor, Fall
       // for further processing consider this Schema Element as parent for all embedded Schema Elements
       this.parent = this.element;
       // @ts-ignore
-      return FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+      const result = FixedFieldsVisitor.compose.methods.ObjectElement.call(this, objectElement);
+
+      // mark this SchemaElement with reference metadata
+      if (isStringElement(this.element.$ref)) {
+        this.element.classes.push('reference-element');
+      }
+
+      return result;
     };
 
     this.BooleanElement = function _BooleanElement(booleanElement: BooleanElement) {