feat: add reference related metadata to namespaces

Author: frantuma

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-field');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

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-asyncapi-2-0/test/refractor/__snapshots__/index.ts.snap

@@ -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-field');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $RefVisitor;

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-field');
+
+      return BREAK;
+    },
+  },
+});
 
 export default $refVisitor;

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

@@ -79,13 +79,24 @@ const SchemaVisitor = stampit(FixedFieldsVisitor, ParentSchemaAwareVisitor, Fall
       this.element.setMetaProperty('inherited$id', inherited$id);
     };
 
+    const handle$ref = (objectElement: ObjectElement) => {
+      // get current $ref keyword
+      const $ref = objectElement.get('$ref')?.toValue();
+
+      // if it's a non empty strings
+      if (isNonEmptyString($ref)) {
+        this.element.classes.push('reference-element');
+      }
+    };
+
     /**
      * Public Api.
      */
     this.ObjectElement = function _ObjectElement(objectElement: ObjectElement) {
       this.element = new SchemaElement();
       handle$schema(objectElement);
       handle$id(objectElement);
+      handle$ref(objectElement);
 
       // for further processing consider this Schema Element as parent for all embedded Schema Elements
       this.parent = this.element;