Mark APIs related to prepend option deprecated (microsoft#52344)

Author: sheetalkamat

src/compiler/builder.ts

@@ -154,6 +154,7 @@ export interface ReusableBuilderProgramState extends BuilderState {
      */
     latestChangedDtsFile: string | undefined;
     /**
+     * @deprecated
      * Bundle information either from oldState or current one so it can be used to complete the information in buildInfo when emitting only js or dts files
      */
     bundle?: BundleBuildInfo;

src/compiler/emitter.ts

@@ -1168,6 +1168,7 @@ export const notImplementedResolver: EmitResolver = {
 /**
  * File that isnt present resulting in error or output files
  *
+ * @deprecated
  * @internal
  */
 export type EmitUsingBuildInfoResult = string | readonly OutputFile[];
@@ -1199,7 +1200,7 @@ function createSourceFilesFromBundleBuildInfo(bundle: BundleBuildInfo, buildInfo
     });
 }
 
-/** @internal */
+/** @deprecated @internal */
 export function emitUsingBuildInfo(
     config: ParsedCommandLine,
     host: CompilerHost,

src/compiler/factory/nodeFactory.ts

@@ -7273,8 +7273,11 @@ const syntheticFactory: BaseNodeFactory = {
 
 export const factory = createNodeFactory(NodeFactoryFlags.NoIndentationOnFreshPropertyAccess, syntheticFactory);
 
+/** @deprecated */
 export function createUnparsedSourceFile(text: string): UnparsedSource;
+/** @deprecated */
 export function createUnparsedSourceFile(inputFile: InputFiles, type: "js" | "dts", stripInternal?: boolean): UnparsedSource;
+/** @deprecated */
 export function createUnparsedSourceFile(text: string, mapPath: string | undefined, map: string | undefined): UnparsedSource;
 export function createUnparsedSourceFile(textOrInputFiles: string | InputFiles, mapPathOrType?: string, mapTextOrStripInternal?: string | boolean): UnparsedSource {
     let stripInternal: boolean | undefined;
@@ -7445,10 +7448,12 @@ function parseOldFileOfCurrentEmit(bundleFileInfo: BundleFileInfo) {
 }
 
 // TODO(rbuckton): Move part of this to factory
+/** @deprecated */
 export function createInputFiles(
     javascriptText: string,
     declarationText: string
 ): InputFiles;
+/** @deprecated */
 export function createInputFiles(
     javascriptText: string,
     declarationText: string,
@@ -7457,6 +7462,7 @@ export function createInputFiles(
     declarationMapPath: string | undefined,
     declarationMapText: string | undefined
 ): InputFiles;
+/** @deprecated */
 export function createInputFiles(
     readFileText: (path: string) => string | undefined,
     javascriptPath: string,
@@ -7493,7 +7499,7 @@ export function createInputFiles(
             declarationMapTextOrBuildInfoPath,
         );
 }
-/** @internal */
+/** @deprecated @internal */
 export function createInputFilesWithFilePaths(
     readFileText: (path: string) => string | undefined,
     javascriptPath: string,
@@ -7546,7 +7552,7 @@ export function createInputFilesWithFilePaths(
     });
     return node;
 }
-/** @internal */
+/** @deprecated @internal */
 export function createInputFilesWithFileTexts(
     javascriptPath: string | undefined,
     javascriptText: string,

src/compiler/factory/nodeTests.ts

@@ -1011,7 +1011,7 @@ export function isEnumMember(node: Node): node is EnumMember {
 // Unparsed
 
 // TODO(rbuckton): isUnparsedPrologue
-
+/** @deprecated */
 export function isUnparsedPrepend(node: Node): node is UnparsedPrepend {
     return node.kind === SyntaxKind.UnparsedPrepend;
 }
@@ -1029,6 +1029,7 @@ export function isBundle(node: Node): node is Bundle {
     return node.kind === SyntaxKind.Bundle;
 }
 
+/** @deprecated */
 export function isUnparsedSource(node: Node): node is UnparsedSource {
     return node.kind === SyntaxKind.UnparsedSource;
 }

src/compiler/program.ts

@@ -5023,7 +5023,7 @@ export function parseConfigHostFromCompilerHostLike(host: CompilerHostLike, dire
     };
 }
 
-/** @internal */
+/** @deprecated @internal */
 export function createPrependNodes(
     projectReferences: readonly ProjectReference[] | undefined,
     getCommandLine: (ref: ProjectReference, index: number) => ParsedCommandLine | undefined,

src/compiler/tsbuild.ts

@@ -16,6 +16,7 @@ export enum UpToDateStatusType {
      */
     UpToDateWithUpstreamTypes,
     /**
+     * @deprecated
      * The project appears out of date because its upstream inputs are newer than its outputs,
      * but all of its outputs are actually newer than the previous identical outputs of its (.d.ts) inputs.
      * This means we can Pseudo-build (just manipulate outputs), as if we had actually built this project.
@@ -87,6 +88,7 @@ export namespace Status {
     }
 
     /**
+     * @deprecated
      * The project is up to date with respect to its inputs except for prepend output changed (no declaration file change in prepend).
      */
     export interface OutOfDateWithPrepend {

src/compiler/tsbuildPublic.ts

@@ -237,8 +237,8 @@ export interface SolutionBuilderHostBase<T extends BuilderProgram> extends Progr
     // TODO: To do better with watch mode and normal build mode api that creates program and emits files
     // This currently helps enable --diagnostics and --extendedDiagnostics
     afterProgramEmitAndDiagnostics?(program: T): void;
-    /** @internal */ beforeEmitBundle?(config: ParsedCommandLine): void;
-    /** @internal */ afterEmitBundle?(config: ParsedCommandLine): void;
+    /** @deprecated @internal */ beforeEmitBundle?(config: ParsedCommandLine): void;
+    /** @deprecated @internal */ afterEmitBundle?(config: ParsedCommandLine): void;
 
     // For testing
     /** @internal */ now?(): Date;
@@ -795,7 +795,7 @@ function setupInitialBuild<T extends BuilderProgram>(state: SolutionBuilderState
 
 export enum InvalidatedProjectKind {
     Build,
-    UpdateBundle,
+    /** @deprecated */ UpdateBundle,
     UpdateOutputFileStamps
 }
 
@@ -847,6 +847,7 @@ export interface BuildInvalidedProject<T extends BuilderProgram> extends Invalid
     // emitNextAffectedFile(writeFile?: WriteFileCallback, cancellationToken?: CancellationToken, customTransformers?: CustomTransformers): AffectedFileResult<EmitResult>;
 }
 
+/** @deprecated */
 export interface UpdateBundleProject<T extends BuilderProgram> extends InvalidatedProjectBase {
     readonly kind: InvalidatedProjectKind.UpdateBundle;
     emit(writeFile?: WriteFileCallback, customTransformers?: CustomTransformers): EmitResult | BuildInvalidedProject<T> | undefined;
@@ -898,9 +899,9 @@ enum BuildStep {
     SyntaxDiagnostics,
     SemanticDiagnostics,
     Emit,
-    EmitBundle,
+    /** @deprecated */ EmitBundle,
     EmitBuildInfo,
-    BuildInvalidatedProjectOfBundle,
+    /** @deprecated */ BuildInvalidatedProjectOfBundle,
     QueueReferencingProjects,
     Done
 }