fix: use JSDoc style for comments

Author: Enda Phelan

src/validation/rules/KnownArgumentNames.js

@@ -45,7 +45,9 @@ export function KnownArgumentNames(context: ValidationContext): ASTVisitor {
   };
 }
 
-// @internal
+/**
+ * @internal
+ */
 export function KnownArgumentNamesOnDirectives(
   context: ValidationContext | SDLValidationContext,
 ): ASTVisitor {

src/validation/rules/ProvidedRequiredArguments.js

@@ -71,7 +71,9 @@ export function ProvidedRequiredArguments(
   };
 }
 
-// @internal
+/**
+ * @internal
+ */
 export function ProvidedRequiredArgumentsOnDirectives(
   context: ValidationContext | SDLValidationContext,
 ): ASTVisitor {

src/validation/specifiedRules.js

@@ -60,7 +60,7 @@ import { UniqueDirectivesPerLocation } from './rules/UniqueDirectivesPerLocation
 // Spec Section: "Argument Names"
 import {
   KnownArgumentNames,
-  KnownArgumentNamesOnDirectives, // @internal
+  KnownArgumentNamesOnDirectives,
 } from './rules/KnownArgumentNames';
 
 // Spec Section: "Argument Uniqueness"
@@ -72,7 +72,7 @@ import { ValuesOfCorrectType } from './rules/ValuesOfCorrectType';
 // Spec Section: "Argument Optionality"
 import {
   ProvidedRequiredArguments,
-  ProvidedRequiredArgumentsOnDirectives, // @internal
+  ProvidedRequiredArgumentsOnDirectives,
 } from './rules/ProvidedRequiredArguments';
 
 // Spec Section: "All Variable Usages Are Allowed"
@@ -127,7 +127,9 @@ import { UniqueFieldDefinitionNames } from './rules/UniqueFieldDefinitionNames';
 import { UniqueDirectiveNames } from './rules/UniqueDirectiveNames';
 import { PossibleTypeExtensions } from './rules/PossibleTypeExtensions';
 
-// @internal
+/**
+ * @internal
+ */
 export const specifiedSDLRules = Object.freeze([
   LoneSchemaDefinition,
   UniqueOperationTypes,

tstypes/language/blockString.d.ts

@@ -6,7 +6,9 @@
  */
 export function dedentBlockStringValue(rawString: string): string;
 
-// @internal
+/**
+ * @internal
+ */
 export function getBlockStringIndentation(lines: ReadonlyArray<string>): number;
 
 /**

tstypes/language/directiveLocation.d.ts

@@ -3,7 +3,9 @@
  */
 export const DirectiveLocation: _DirectiveLocation;
 
-// @internal
+/**
+ * @internal
+ */
 type _DirectiveLocation = {
   // Request Definitions
   QUERY: 'QUERY';

tstypes/language/kinds.d.ts

@@ -3,7 +3,9 @@
  */
 export const Kind: _Kind;
 
-// @internal
+/**
+ * @internal
+ */
 type _Kind = {
   // Name
   NAME: 'Name';

tstypes/utilities/findBreakingChanges.d.ts

@@ -4,7 +4,9 @@ import { DirectiveLocationEnum } from '../language/directiveLocation';
 
 export const BreakingChangeType: _BreakingChangeType;
 
-// @internal
+/**
+ * @internal
+ */
 type _BreakingChangeType = {
   TYPE_REMOVED: 'TYPE_REMOVED';
   TYPE_CHANGED_KIND: 'TYPE_CHANGED_KIND';
@@ -25,7 +27,9 @@ type _BreakingChangeType = {
 
 export const DangerousChangeType: _DangerousChangeType;
 
-// @internal
+/**
+ * @internal
+ */
 type _DangerousChangeType = {
   VALUE_ADDED_TO_ENUM: 'VALUE_ADDED_TO_ENUM';
   TYPE_ADDED_TO_UNION: 'TYPE_ADDED_TO_UNION';

tstypes/validation/rules/KnownArgumentNames.d.ts

@@ -9,7 +9,9 @@ import { ASTVisitor } from '../../language/visitor';
  */
 export function KnownArgumentNames(context: ValidationContext): ASTVisitor;
 
-// @internal
+/**
+ * @internal
+ */
 export function KnownArgumentNamesOnDirectives(
   context: ValidationContext | SDLValidationContext,
 ): ASTVisitor;

tstypes/validation/rules/ProvidedRequiredArguments.d.ts

@@ -11,7 +11,9 @@ export function ProvidedRequiredArguments(
   context: ValidationContext,
 ): ASTVisitor;
 
-// @internal
+/**
+ * @internal
+ */
 export function ProvidedRequiredArgumentsOnDirectives(
   context: ValidationContext | SDLValidationContext,
 ): ASTVisitor;

tstypes/validation/specifiedRules.d.ts

@@ -60,7 +60,7 @@ import { UniqueDirectivesPerLocation } from './rules/UniqueDirectivesPerLocation
 // Spec Section: "Argument Names"
 import {
   KnownArgumentNames,
-  KnownArgumentNamesOnDirectives, // @internal
+  KnownArgumentNamesOnDirectives,
 } from './rules/KnownArgumentNames';
 
 // Spec Section: "Argument Uniqueness"
@@ -72,7 +72,7 @@ import { ValuesOfCorrectType } from './rules/ValuesOfCorrectType';
 // Spec Section: "Argument Optionality"
 import {
   ProvidedRequiredArguments,
-  ProvidedRequiredArgumentsOnDirectives, // @internal
+  ProvidedRequiredArgumentsOnDirectives,
 } from './rules/ProvidedRequiredArguments';
 
 // Spec Section: "All Variable Usages Are Allowed"
@@ -94,5 +94,7 @@ export const specifiedRules: ReadonlyArray<ValidationRule>;
 
 import { LoneSchemaDefinition } from './rules/LoneSchemaDefinition';
 
-// @internal
+/**
+ * @internal
+ */
 export const specifiedSDLRules: ReadonlyArray<SDLValidationRule>;

tstypes/validation/validate.d.ts

@@ -29,7 +29,9 @@ export function validate(
   options?: { maxErrors?: number },
 ): ReadonlyArray<GraphQLError>;
 
-// @internal
+/**
+ * @internal
+ */
 export function validateSDL(
   documentAST: DocumentNode,
   schemaToExtend?: Maybe<GraphQLSchema>,