fix(ls): fix required lints in OpenAPI

Required lints are now performed only when
 field is missing.

Refs #2264
Refs swagger-api/swagger-editor#3652

Author: char0n

packages/apidom-ls/src/config/openapi/operation/lint/index.ts

@@ -9,7 +9,7 @@ import parametersTypeLint from './parameters--type';
 import parametersItemsTypeLint from './parameters--items-type';
 import requestBodyTypeLint from './request-body--type';
 import responsesTypeLint from './responses--type';
-import responsesRequiredLint3_0 from './responses-3-0--required';
+import responsesRequired3_0Lint from './responses-3-0--required';
 import callbacksValuesTypeLint from './callbacks--values-type';
 import deprecatedTypeLint from './deprecated--type';
 import securityTypeLint from './security--type';
@@ -28,7 +28,7 @@ const lints = [
   parametersItemsTypeLint,
   requestBodyTypeLint,
   responsesTypeLint,
-  responsesRequiredLint3_0,
+  responsesRequired3_0Lint,
   callbacksValuesTypeLint,
   deprecatedTypeLint,
   securityTypeLint,

packages/apidom-ls/src/config/openapi/operation/lint/responses-3-0--required.ts

@@ -2,7 +2,7 @@ import ApilintCodes from '../../../codes';
 import { LinterMeta } from '../../../../apidom-language-types';
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const responsesRequiredLint3_0: LinterMeta = {
+const responsesRequired3_0Lint: LinterMeta = {
   code: ApilintCodes.OPENAPI3_0_OPERATION_FIELD_RESPONSES_REQUIRED,
   source: 'apilint',
   message: "should always have a 'responses'",
@@ -28,4 +28,4 @@ const responsesRequiredLint3_0: LinterMeta = {
   ],
 };
 
-export default responsesRequiredLint3_0;
+export default responsesRequired3_0Lint;

packages/apidom-ls/src/config/openapi/parameter/lint/required--required.ts

@@ -15,6 +15,10 @@ const requiredRequiredLint: LinterMeta = {
       function: 'apilintContainsValue',
       params: ['path'],
     },
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
   ],
   data: {
     quickFix: [

packages/apidom-ls/src/config/openapi/request-body/lint/content--required.ts

@@ -19,6 +19,12 @@ const requiredRequiredLint: LinterMeta = {
       },
     ],
   },
+  conditions: [
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
+  ],
 };
 
 export default requiredRequiredLint;

packages/apidom-ls/src/config/openapi/response/lint/description--required.ts

@@ -19,6 +19,12 @@ const descriptionRequiredLint: LinterMeta = {
       },
     ],
   },
+  conditions: [
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
+  ],
 };
 
 export default descriptionRequiredLint;

packages/apidom-ls/src/config/openapi/security-scheme/lint/flows--required.ts

@@ -25,6 +25,10 @@ const flowsRequiredLint: LinterMeta = {
       function: 'apilintContainsValue',
       params: ['oauth2'],
     },
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
   ],
 };
 

packages/apidom-ls/src/config/openapi/security-scheme/lint/name--required.ts

@@ -25,6 +25,10 @@ const nameRequiredLint: LinterMeta = {
       function: 'apilintContainsValue',
       params: ['apiKey'],
     },
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
   ],
 };
 

packages/apidom-ls/src/config/openapi/security-scheme/lint/open-id-connect-url--required.ts

@@ -25,6 +25,10 @@ const openIdConnectUrlRequiredLint: LinterMeta = {
       function: 'apilintContainsValue',
       params: ['openIdConnect'],
     },
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
   ],
 };
 

packages/apidom-ls/src/config/openapi/security-scheme/lint/scheme--required.ts

@@ -25,6 +25,10 @@ const schemeRequiredLint: LinterMeta = {
       function: 'apilintContainsValue',
       params: ['http'],
     },
+    {
+      function: 'missingField',
+      params: ['$ref'],
+    },
   ],
 };