refactor: Deprecate project/sourceFile.getDiagnostics() and `progra…

…m.getPreEmitDiagnostics()`.

BREAKING CHANGE: `project/sourceFile.getDiagnostics()` and `program.getPreEmitDiagnostics()` no longer exist. Use `project/sourceFile.getPreEmitDiagnostics()`.

breaking-changes.md

@@ -4,6 +4,12 @@ View [CHANGELOG.md](CHANGELOG.md) for more detail on releases. This file is only
 
 ## Version 14
 
+### Deprecated `project/sourceFile.getDiagnostics()`
+
+Use `project.getPreEmitDiagnostics()` and `sourceFile.getPreEmitDiagnostics()` instead. Read why in [#384](issues/384).
+
+Also, deprecated `program.getPreEmitDiagnostics()`. It didn't make sense for this method to be on `Program`.
+
 ### `BindingNamedNode` now correctly possibly returns a `BindingElement`
 
 For example, given the following code:

src/Project.ts

@@ -394,18 +394,6 @@ export class Project {
         }
     }
 
-    /**
-     * Gets the compiler diagnostics.
-     * @deprecated Use getPreEmitDiagnostics().
-     */
-    getDiagnostics(): Diagnostic[] {
-        return [
-            ...this.context.program.getSyntacticDiagnostics(),
-            ...this.context.program.getSemanticDiagnostics(),
-            ...this.context.program.getDeclarationDiagnostics()
-        ];
-    }
-
     /**
      * Gets the pre-emit diagnostics.
      */

src/compiler/file/SourceFile.ts

@@ -771,18 +771,6 @@ export class SourceFile extends SourceFileBase<ts.SourceFile> {
         return errors.throwIfNullOrUndefined(this.getDefaultExportSymbol(), "Expected to find a default export symbol");
     }
 
-    /**
-     * Gets the syntactic, semantic, and declaration diagnostics.
-     * @deprecated - Use getPreEmitDiagnostics().
-     */
-    getDiagnostics(): Diagnostic[] {
-        return [
-            ...this.context.program.getSyntacticDiagnostics(this),
-            ...this.context.program.getSemanticDiagnostics(this),
-            ...this.context.program.getDeclarationDiagnostics(this)
-        ];
-    }
-
     /**
      * Gets the pre-emit diagnostics of the specified source file.
      */

src/compiler/tools/Program.ts

@@ -122,15 +122,6 @@ export class Program {
         return compilerDiagnostics.map(d => this.context.compilerFactory.getDiagnostic(d));
     }
 
-    /**
-     * Gets the pre-emit diagnostics.
-     * @param sourceFile - Source file.
-     * @deprecated - Call .getPreEmitDiagnostics() on the source file or project instead.
-     */
-    getPreEmitDiagnostics(sourceFile?: SourceFile): Diagnostic[] {
-        return this.context.getPreEmitDiagnostics(sourceFile);
-    }
-
     /**
      * Gets the emit module resolution kind.
      */

src/next-major-deprecations.md

@@ -1,3 +1,3 @@
 # Deprecations in the next major
 
-* Project and SourceFile - getDiagnostics()
+None.