fix(ls): add lint rules for OpenAPI 3.1 Reference Object

packages/apidom-ls/src/config/codes.ts

@@ -888,6 +888,8 @@ enum ApilintCodes {
 
   OPENAPI3_1_REFERENCE = 7040000,
   OPENAPI3_1_REFERENCE_FIELD_$REF_ALLOWED_SIBLINGS = 7040100,
+  OPENAPI3_1_REFERENCE_FIELD_DESCRIPTION_TYPE = 7040200,
+  OPENAPI3_1_REFERENCE_FIELD_SUMMARY_TYPE = 7040300,
 
   OPENAPI3_1_SECURITY_SCHEME = 7050000,
   OPENAPI3_1_SECURITY_SCHEME_FIELD_TYPE_EQUALS = 7050100,

packages/apidom-ls/src/config/openapi/reference/lint/$ref--no-siblings-3-0.ts → packages/apidom-ls/src/config/openapi/reference/lint/$ref-3-0--no-siblings.ts

@@ -4,7 +4,7 @@ import ApilintCodes from '../../../codes';
 import { LinterMeta } from '../../../../apidom-language-types';
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const $refNoSiblings3_0Lint: LinterMeta = {
+const $ref3_0NoSiblingsLint: LinterMeta = {
   code: ApilintCodes.OPENAPI3_0_REFERENCE_FIELD_$REF_NO_SIBLINGS,
   source: 'apilint',
   message: 'All other properties in a "$ref" object are ignored',
@@ -36,4 +36,4 @@ const $refNoSiblings3_0Lint: LinterMeta = {
   ],
 };
 
-export default $refNoSiblings3_0Lint;
+export default $ref3_0NoSiblingsLint;

packages/apidom-ls/src/config/openapi/reference/lint/$ref--allowed-siblings-3-1.ts → packages/apidom-ls/src/config/openapi/reference/lint/$ref-3-1--allowed-siblings.ts

@@ -4,7 +4,7 @@ import ApilintCodes from '../../../codes';
 import { LinterMeta } from '../../../../apidom-language-types';
 
 // eslint-disable-next-line @typescript-eslint/naming-convention
-const $refAllowedSiblings3_1Lint: LinterMeta = {
+const $ref3_1AllowedSiblingsLint: LinterMeta = {
   code: ApilintCodes.OPENAPI3_1_REFERENCE_FIELD_$REF_ALLOWED_SIBLINGS,
   source: 'apilint',
   message:
@@ -23,4 +23,4 @@ const $refAllowedSiblings3_1Lint: LinterMeta = {
   targetSpecs: [{ namespace: 'openapi', version: '3.1.0' }],
 };
 
-export default $refAllowedSiblings3_1Lint;
+export default $ref3_1AllowedSiblingsLint;

packages/apidom-ls/src/config/openapi/reference/lint/description-3-1--type.ts

@@ -0,0 +1,20 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+
+import ApilintCodes from '../../../codes';
+import { LinterMeta } from '../../../../apidom-language-types';
+
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const description3_1TypeLint: LinterMeta = {
+  code: ApilintCodes.OPENAPI3_1_REFERENCE_FIELD_DESCRIPTION_TYPE,
+  source: 'apilint',
+  message: 'description must be a string',
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'apilintType',
+  linterParams: ['string'],
+  marker: 'value',
+  target: 'description',
+  data: {},
+  targetSpecs: [{ namespace: 'openapi', version: '3.1.0' }],
+};
+
+export default description3_1TypeLint;

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

@@ -1,7 +1,15 @@
 import $refFormatURILint from './$ref--format-uri';
-import $refNoSiblings3_0Lint from './$ref--no-siblings-3-0';
-import $refAllowedSiblings3_1Lint from './$ref--allowed-siblings-3-1';
+import $ref3_0NoSiblingsLint from './$ref-3-0--no-siblings';
+import $ref3_1AllowedSiblingsLint from './$ref-3-1--allowed-siblings';
+import description3_1TypeLint from './description-3-1--type';
+import summary3_1TypeLint from './summary-3-1--type';
 
-const lints = [$refFormatURILint, $refNoSiblings3_0Lint, $refAllowedSiblings3_1Lint];
+const lints = [
+  $refFormatURILint,
+  $ref3_0NoSiblingsLint,
+  $ref3_1AllowedSiblingsLint,
+  description3_1TypeLint,
+  summary3_1TypeLint,
+];
 
 export default lints;

packages/apidom-ls/src/config/openapi/reference/lint/summary-3-1--type.ts

@@ -0,0 +1,20 @@
+import { DiagnosticSeverity } from 'vscode-languageserver-types';
+
+import ApilintCodes from '../../../codes';
+import { LinterMeta } from '../../../../apidom-language-types';
+
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const summary3_1TypeLint: LinterMeta = {
+  code: ApilintCodes.OPENAPI3_1_REFERENCE_FIELD_SUMMARY_TYPE,
+  source: 'apilint',
+  message: 'summary must be a string',
+  severity: DiagnosticSeverity.Error,
+  linterFunction: 'apilintType',
+  linterParams: ['string'],
+  marker: 'value',
+  target: 'summary',
+  data: {},
+  targetSpecs: [{ namespace: 'openapi', version: '3.1.0' }],
+};
+
+export default summary3_1TypeLint;