Fix all internal JSDoc comments

If these are regular comments, then they won't appear in our d.ts files.
But, now we are relying on an external d.ts bundler to produce our final
merged, so they need to be present in the "input" d.ts files, meaning
they have to be JSDoc comments.

These comments only work today because all of our builds load their TS
files from scratch, so they see the actual source files and their
non-JSDoc comments.

The comments also need to be attached to a declaration, not floating,
otherwise they won't be used by api-extractor, so move them if needed.

Author: jakebailey

scripts/failed-tests.cjs

@@ -10,6 +10,7 @@ const os = require("os");
     reporter?: Mocha.ReporterConstructor | keyof Mocha.reporters;
     reporterOptions?: any; // TODO(jakebailey): what?
 }} ReporterOptions */
+void 0;
 
 /**
  * .failed-tests reporter

scripts/processDiagnosticMessages.mjs

@@ -9,6 +9,7 @@ import fs from "fs";
     isEarly?: boolean;
     elidedInCompatabilityPyramid?: boolean;
 }} DiagnosticDetails */
+void 0;
 
 /** @typedef {Map<string, DiagnosticDetails>} InputDiagnosticMessageTable */
 

scripts/word2md.mjs

@@ -60,6 +60,7 @@ const sys = (() => {
         subscript?: boolean;
     };
 }} FindReplaceOptions */
+void 0;
 
 /**
  * @param {Word.Document} doc

src/compiler/builder.ts

@@ -92,9 +92,10 @@ export const enum BuilderFileEmit {
     Full
 }
 
-/** @internal */
 /**
  * State to store the changed files, affected files and cache semantic diagnostics
+ *
+ * @internal
  */
 // TODO: GH#18217 Properties of this interface are frequently asserted to be defined.
 export interface BuilderProgramState extends BuilderState, ReusableBuilderProgramState {
@@ -809,15 +810,17 @@ export type ProgramBuildInfoBuilderStateFileInfo = Omit<BuilderState.FileInfo, "
      */
     signature: string | false | undefined;
 };
-/** @internal */
 /**
  * [fileId, signature] if different from file's signature
  * fileId if file wasnt emitted
+ *
+ * @internal
  */
 export type ProgramBuildInfoEmitSignature = ProgramBuildInfoFileId | [fileId: ProgramBuildInfoFileId, signature: string];
-/** @internal */
 /**
  * ProgramBuildInfoFileInfo is string if FileInfo.version === FileInfo.signature && !FileInfo.affectsGlobalScope otherwise encoded FileInfo
+ *
+ * @internal
  */
 export type ProgramBuildInfoFileInfo = string | ProgramBuildInfoBuilderStateFileInfo;
 /** @internal */

src/compiler/builderPublic.ts

@@ -23,46 +23,51 @@ export interface BuilderProgramHost {
     writeFile?: WriteFileCallback;
     /**
      * disable using source file version as signature for testing
+     *
+     * @internal
      */
-    /*@internal*/
     disableUseFileVersionAsSignature?: boolean;
     /**
      * Store the list of files that update signature during the emit
+     *
+     * @internal
      */
-    /*@internal*/
     storeFilesChangingSignatureDuringEmit?: boolean;
     /**
      * Gets the current time
+     *
+     * @internal
      */
-    /*@internal*/
     now?(): Date;
 }
 
 /**
  * Builder to manage the program state changes
  */
 export interface BuilderProgram {
-    /*@internal*/
+    /** @internal */
     getState(): ReusableBuilderProgramState;
-    /*@internal*/
+    /** @internal */
     saveEmitState(): SavedBuildProgramEmitState;
-    /*@internal*/
+    /** @internal */
     restoreEmitState(saved: SavedBuildProgramEmitState): void;
-    /*@internal*/
+    /** @internal */
     hasChangedEmitSignature?(): boolean;
     /**
      * Returns current program
      */
     getProgram(): Program;
     /**
      * Returns current program that could be undefined if the program was released
+     *
+     * @internal
      */
-    /*@internal*/
     getProgramOrUndefined(): Program | undefined;
     /**
      * Releases reference to the program, making all the other operations that need program to fail.
+     *
+     * @internal
      */
-    /*@internal*/
     releaseProgram(): void;
     /**
      * Get compiler options of the program
@@ -122,13 +127,13 @@ export interface BuilderProgram {
      * in that order would be used to write the files
      */
     emit(targetSourceFile?: SourceFile, writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, emitOnlyDtsFiles?: boolean, customTransformers?: CustomTransformers): EmitResult;
-    /*@internal*/
+    /** @internal */
     emitBuildInfo(writeFile?: WriteFileCallback, cancellationToken?: CancellationToken): EmitResult;
     /**
      * Get the current directory of the program
      */
     getCurrentDirectory(): string;
-    /*@internal*/
+    /** @internal */
     close(): void;
 }
 

src/compiler/builderStatePublic.ts

@@ -3,12 +3,12 @@ import { BuildInfo, Diagnostic } from "./_namespaces/ts";
 export interface EmitOutput {
     outputFiles: OutputFile[];
     emitSkipped: boolean;
-    /* @internal */ diagnostics: readonly Diagnostic[];
+    /** @internal */ diagnostics: readonly Diagnostic[];
 }
 
 export interface OutputFile {
     name: string;
     writeByteOrderMark: boolean;
     text: string;
-    /* @internal */ buildInfo?: BuildInfo
+    /** @internal */ buildInfo?: BuildInfo
 }