feat(parser-adapter-asyncapi-yaml-3): add package for parser adapter … (#5047)

* feat(parser-adapter-asyncapi-yaml-3): parser

Author: lukaszzazulak

package-lock.json

@@ -106,6 +106,7 @@
     "@swagger-api/apidom-parser-adapter-api-design-systems-yaml": "^1.0.0-rc.3",
     "@swagger-api/apidom-parser-adapter-asyncapi-json-2": "^1.0.0-rc.3",
     "@swagger-api/apidom-parser-adapter-asyncapi-yaml-2": "^1.0.0-rc.3",
+    "@swagger-api/apidom-parser-adapter-asyncapi-yaml-3": "^1.0.0-rc.3",
     "@swagger-api/apidom-parser-adapter-json": "^1.0.0-rc.3",
     "@swagger-api/apidom-parser-adapter-openapi-json-2": "^1.0.0-rc.3",
     "@swagger-api/apidom-parser-adapter-openapi-json-3-0": "^1.0.0-rc.3",

packages/apidom-ls/package.json

@@ -450,6 +450,14 @@ export class DefaultValidationService implements ValidationService {
 
     let processedText;
     const nameSpace = await findNamespace(text, this.settings?.defaultContentLanguage);
+    // TODO: Turned off validation, because we will implement it in the future.
+    if (
+      nameSpace.namespace === 'asyncapi' &&
+      nameSpace.version &&
+      ['3.0.0', '3.0.1'].includes(nameSpace.version)
+    ) {
+      return [];
+    }
     let docNs: string = nameSpace.namespace;
     // no API document has been parsed
     if (result.annotations) {

packages/apidom-ls/src/services/validation/validation-service.ts

@@ -6,6 +6,7 @@ import * as openapi31xAdapterJson from '@swagger-api/apidom-parser-adapter-opena
 import * as openapi31xAdapterYaml from '@swagger-api/apidom-parser-adapter-openapi-yaml-3-1';
 import * as asyncapi2AdapterJson from '@swagger-api/apidom-parser-adapter-asyncapi-json-2';
 import * as asyncapi2AdapterYaml from '@swagger-api/apidom-parser-adapter-asyncapi-yaml-2';
+import * as asyncapi3AdapterYaml from '@swagger-api/apidom-parser-adapter-asyncapi-yaml-3';
 import * as adsAdapterJson from '@swagger-api/apidom-parser-adapter-api-design-systems-json';
 import * as adsAdapterYaml from '@swagger-api/apidom-parser-adapter-api-design-systems-yaml';
 import * as adapterJson from '@swagger-api/apidom-parser-adapter-json';
@@ -836,6 +837,19 @@ export async function findNamespace(
     };
   }
 
+  if (await asyncapi3AdapterYaml.detect(text)) {
+    const asyncapi3YamlMatch = text.match(asyncapi3AdapterYaml.detectionRegExp)!;
+    const groups = asyncapi3YamlMatch.groups!;
+    const version = groups.version_json ?? groups.version_yaml;
+
+    return {
+      namespace: 'asyncapi',
+      version,
+      format: 'YAML',
+      mediaType: asyncapi3AdapterYaml.mediaTypes.findBy(version, 'yaml'),
+    };
+  }
+
   if (await openapi2AdapterJson.detect(text)) {
     const openapi2JsonMatch = text.match(openapi2AdapterJson.detectionRegExp)!;
     const groups = openapi2JsonMatch.groups!;

packages/apidom-ls/src/utils/utils.ts

@@ -438,7 +438,9 @@ describe('apidom-ls-hover-provider', function () {
     logLevel,
   };
 
-  it('test hover ref provider', async function () {
+  // TODO: Flaky test.
+  // eslint-disable-next-line mocha/no-skipped-tests
+  xit('test hover ref provider', async function () {
     let languageService: LanguageService = getLanguageService(contextAsyncRef);
 
     try {

packages/apidom-ls/test/hover-provider.ts

@@ -1,12 +1,8 @@
 import { Mixin } from 'ts-mixer';
-import { test } from 'ramda';
 import { ObjectElement } from '@swagger-api/apidom-core';
 import { isReferenceLikeElement } from '@swagger-api/apidom-ns-asyncapi-2';
 
-import PatternedFieldsVisitor, {
-  PatternedFieldsVisitorOptions,
-  SpecPath,
-} from '../../generics/PatternedFieldsVisitor.ts';
+import MapVisitor, { SpecPath, MapVisitorOptions } from '../../generics/MapVisitor.ts';
 import FallbackVisitor, { FallbackVisitorOptions } from '../../FallbackVisitor.ts';
 import MessagesElement from '../../../../elements/Messages.ts';
 import ReferenceElement from '../../../../elements/Reference.ts';
@@ -15,14 +11,12 @@ import { isReferenceElement } from '../../../../predicates.ts';
 /**
  * @public
  */
-export interface MessagesVisitorOptions
-  extends PatternedFieldsVisitorOptions,
-    FallbackVisitorOptions {}
+export interface MessagesVisitorOptions extends MapVisitorOptions, FallbackVisitorOptions {}
 
 /**
  * @public
  */
-class MessagesVisitor extends Mixin(PatternedFieldsVisitor, FallbackVisitor) {
+class MessagesVisitor extends Mixin(MapVisitor, FallbackVisitor) {
   declare public readonly element: MessagesElement;
 
   declare protected readonly specPath: SpecPath<
@@ -41,12 +35,10 @@ class MessagesVisitor extends Mixin(PatternedFieldsVisitor, FallbackVisitor) {
         : ['document', 'objects', 'Message'];
     };
     this.canSupportSpecificationExtensions = false;
-    // @ts-ignore
-    this.fieldPatternPredicate = test(/^[A-Za-z0-9_-]+$/);
   }
 
   ObjectElement(objectElement: ObjectElement) {
-    const result = PatternedFieldsVisitor.prototype.ObjectElement.call(this, objectElement);
+    const result = MapVisitor.prototype.ObjectElement.call(this, objectElement);
 
     // @ts-ignore
     this.element.filter(isReferenceElement).forEach((referenceElement: ReferenceElement) => {

packages/apidom-ns-asyncapi-3/src/refractor/visitors/async-api-3/messages/index.ts

@@ -1,12 +1,8 @@
 import { Mixin } from 'ts-mixer';
-import { test } from 'ramda';
 import { ObjectElement } from '@swagger-api/apidom-core';
 import { isReferenceLikeElement } from '@swagger-api/apidom-ns-asyncapi-2';
 
-import PatternedFieldsVisitor, {
-  PatternedFieldsVisitorOptions,
-  SpecPath,
-} from '../../generics/PatternedFieldsVisitor.ts';
+import MapVisitor, { MapVisitorOptions, SpecPath } from '../../generics/MapVisitor.ts';
 import FallbackVisitor, { FallbackVisitorOptions } from '../../FallbackVisitor.ts';
 import OperationsElement from '../../../../elements/Operations.ts';
 import ReferenceElement from '../../../../elements/Reference.ts';
@@ -15,14 +11,12 @@ import { isReferenceElement } from '../../../../predicates.ts';
 /**
  * @public
  */
-export interface OperationsVisitorOptions
-  extends PatternedFieldsVisitorOptions,
-    FallbackVisitorOptions {}
+export interface OperationsVisitorOptions extends MapVisitorOptions, FallbackVisitorOptions {}
 
 /**
  * @public
  */
-class OperationsVisitor extends Mixin(PatternedFieldsVisitor, FallbackVisitor) {
+class OperationsVisitor extends Mixin(MapVisitor, FallbackVisitor) {
   declare public readonly element: OperationsElement;
 
   declare protected readonly specPath: SpecPath<
@@ -41,12 +35,10 @@ class OperationsVisitor extends Mixin(PatternedFieldsVisitor, FallbackVisitor) {
         : ['document', 'objects', 'Operation'];
     };
     this.canSupportSpecificationExtensions = false;
-    // @ts-ignore
-    this.fieldPatternPredicate = test(/^[A-Za-z0-9_-]+$/);
   }
 
   ObjectElement(objectElement: ObjectElement) {
-    const result = PatternedFieldsVisitor.prototype.ObjectElement.call(this, objectElement);
+    const result = MapVisitor.prototype.ObjectElement.call(this, objectElement);
 
     // @ts-ignore
     this.element.filter(isReferenceElement).forEach((referenceElement: ReferenceElement) => {

packages/apidom-ns-asyncapi-3/src/refractor/visitors/async-api-3/operations/index.ts

@@ -0,0 +1,8 @@
+/**/*.js
+/**/*.mjs
+/**/*.cjs
+/dist
+/types
+/config
+/.nyc_output
+/node_modules

packages/apidom-parser-adapter-asyncapi-yaml-3/.eslintignore

@@ -0,0 +1,7 @@
+/src/**/*.mjs
+/src/**/*.cjs
+/test/**/*.mjs
+/dist
+/types
+/NOTICE
+/swagger-api-apidom-parser-adapter-asyncapi-yaml-3-*.tgz

packages/apidom-parser-adapter-asyncapi-yaml-3/.gitignore

@@ -0,0 +1,8 @@
+{
+  "extensions": ["ts"],
+  "loader": "ts-node/esm",
+  "recursive": true,
+  "spec": "test/**/*.ts",
+  "file": ["test/mocha-bootstrap.ts"],
+  "ignore": ["test/perf/**/*.ts"]
+}