Deprecate prepend option on project reference

Author: sheetalkamat

src/compiler/program.ts

@@ -4302,15 +4302,38 @@ export function createProgram(rootNamesOrOptions: readonly string[] | CreateProg
         if (options.out) {
             createDeprecatedDiagnosticForOption(version, "out");
         }
+
+        forEachProjectReference(projectReferences, resolvedProjectReferences, (_resolvedRef, parent, index) => {
+            const ref = (parent ? parent.commandLine.projectReferences : projectReferences)![index];
+            if (ref.prepend) {
+                createDeprecatedOptionForVersionDiagnostic(
+                    version,
+                    (message, arg0, arg1, arg2) => createDiagnosticForReference(parent?.sourceFile as JsonSourceFile | undefined, index, message, arg0, arg1, arg2),
+                    "prepend",
+                );
+            }
+        });
     }
 
     function createDeprecatedDiagnosticForOption(version: string, name: string, value?: string) {
+        return createDeprecatedOptionForVersionDiagnostic(
+            version,
+            (message, arg0, arg1, arg2) => createDiagnosticForOption(/*onKey*/ !value, name, /*option2*/ undefined, message, arg0, arg1, arg2),
+            name,
+            value,
+        );
+    }
+
+    function createDeprecatedOptionForVersionDiagnostic(
+        version: string,
+        createDiagnostic: (message: DiagnosticMessage, arg0: string, arg1?: string, arg2?: string) => void,
+        name: string,
+        value?: string) {
         if (version === DeprecationVersion.v6_0) {
-            createDiagnosticForOption(/*onKey*/ !value, name, /*option2*/ undefined, Diagnostics.Flag_0_is_deprecated_Please_remove_it_from_your_configuration, value || name);
+            createDiagnostic(Diagnostics.Flag_0_is_deprecated_Please_remove_it_from_your_configuration, value || name);
         }
         else {
-            createDiagnosticForOption(/*onKey*/ !value, name, /*option2*/ undefined,
-                Diagnostics.Flag_0_is_deprecated_and_will_stop_functioning_in_TypeScript_1_Specify_ignoreDeprecations_Colon_2_to_silence_this_error, value || name, DeprecationVersion.v5_5, DeprecationVersion.v5_0);
+            createDiagnostic(Diagnostics.Flag_0_is_deprecated_and_will_stop_functioning_in_TypeScript_1_Specify_ignoreDeprecations_Colon_2_to_silence_this_error, value || name, DeprecationVersion.v5_5, DeprecationVersion.v5_0);
         }
     }
 
@@ -4548,14 +4571,14 @@ export function createProgram(rootNamesOrOptions: readonly string[] | CreateProg
         createDiagnosticForOption(/*onKey*/ false, option1, /*option2*/ undefined, message, arg0, arg1);
     }
 
-    function createDiagnosticForReference(sourceFile: JsonSourceFile | undefined, index: number, message: DiagnosticMessage, arg0?: string | number, arg1?: string | number) {
+    function createDiagnosticForReference(sourceFile: JsonSourceFile | undefined, index: number, message: DiagnosticMessage, arg0?: string | number, arg1?: string | number, arg2?: string | number) {
         const referencesSyntax = firstDefined(getTsConfigPropArray(sourceFile || options.configFile, "references"),
             property => isArrayLiteralExpression(property.initializer) ? property.initializer : undefined);
         if (referencesSyntax && referencesSyntax.elements.length > index) {
-            programDiagnostics.add(createDiagnosticForNodeInSourceFile(sourceFile || options.configFile!, referencesSyntax.elements[index], message, arg0, arg1));
+            programDiagnostics.add(createDiagnosticForNodeInSourceFile(sourceFile || options.configFile!, referencesSyntax.elements[index], message, arg0, arg1, arg2));
         }
         else {
-            programDiagnostics.add(createCompilerDiagnostic(message, arg0, arg1));
+            programDiagnostics.add(createCompilerDiagnostic(message, arg0, arg1, arg2));
         }
     }
 

src/testRunner/unittests/tsbuild/amdModulesWithOut.ts

@@ -59,6 +59,11 @@ describe("unittests:: tsbuild:: outFile:: on amd modules with --out", () => {
             subScenario: "modules and globals mixed in amd",
         });
 
+        verifyOutFileScenario({
+            subScenario: "prepend reports deprecation error",
+            modifyFs: fs => replaceText(fs, "/src/app/tsconfig.json", `"ignoreDeprecations": "5.0"`, ""),
+        });
+
         // Prologues
         describe("Prologues", () => {
             verifyOutFileScenario({

src/testRunner/unittests/tsbuild/javascriptProjectEmit.ts

@@ -125,6 +125,7 @@ describe("unittests:: tsbuild:: javascriptProjectEmit::", () => {
                     {
                         "extends": "../tsconfig.base.json",
                         "compilerOptions": {
+                            "ignoreDeprecations":"5.0",
                             "composite": true,
                             "outFile": "sub-project.js",
                             
@@ -150,6 +151,7 @@ describe("unittests:: tsbuild:: javascriptProjectEmit::", () => {
                     {
                         "extends": "../tsconfig.base.json",
                         "compilerOptions": {
+                            "ignoreDeprecations":"5.0",
                             "composite": true,
                             "outFile": "sub-project-2.js",
                             
@@ -162,6 +164,7 @@ describe("unittests:: tsbuild:: javascriptProjectEmit::", () => {
             "/src/tsconfig.json": Utils.dedent`
                     {
                         "compilerOptions": {
+                            "ignoreDeprecations":"5.0",
                             "composite": true,
                             "outFile": "src.js"
                         },

src/testRunner/unittests/tsbuild/outFile.ts

@@ -611,6 +611,7 @@ ${internal} enum internalEnum { a, b, c }`);
                     }));
                     fs.writeFileSync("/src/third/tsconfig.json", JSON.stringify({
                         compilerOptions: {
+                            ignoreDeprecations: "5.0",
                             composite: true,
                             declaration: true,
                             declarationMap: false,

src/testRunner/unittests/tsbuildWatch/programUpdates.ts

@@ -274,7 +274,7 @@ export class someClass2 { }`),
                 const logicTsConfig: File = {
                     path: logic[0].path,
                     content: JSON.stringify({
-                        compilerOptions: { composite: true, declaration: true, outFile: "index.js" },
+                        compilerOptions: { ignoreDeprecations: "5.0", composite: true, declaration: true, outFile: "index.js" },
                         references: [{ path: "../core", prepend: true }]
                     })
                 };

tests/baselines/reference/tsbuild/amdModulesWithOut/modules-and-globals-mixed-in-amd.js

@@ -24,6 +24,7 @@ const myVar = 30;
 //// [/src/app/tsconfig.json]
 {
     "compilerOptions": {
+        "ignoreDeprecations": "5.0",
         "target": "es5",
         "module": "amd",
         "composite": true,

tests/baselines/reference/tsbuild/amdModulesWithOut/multiple-emitHelpers-in-all-projects.js

@@ -29,6 +29,7 @@ appfile4Spread(10, ...appfile4_ar);
 //// [/src/app/tsconfig.json]
 {
     "compilerOptions": {
+        "ignoreDeprecations": "5.0",
         "target": "es5",
         "module": "amd",
         "composite": true,

tests/baselines/reference/tsbuild/amdModulesWithOut/multiple-prologues-in-all-projects.js

@@ -26,6 +26,7 @@ const myVar = 30;
 //// [/src/app/tsconfig.json]
 {
     "compilerOptions": {
+        "ignoreDeprecations": "5.0",
         "target": "es5",
         "module": "amd",
         "composite": true,