refactor(definitions): deprecate the legacy interface aliases

Each alias now carries @deprecated naming its contract, so the call
sites still resolving services by legacy name are flagged in-editor -
the compile-time counterpart of the runtime deprecation tracer.

The aliases themselves stay: they keep existing annotations compiling
until each service migrates.

Author: edusperoni

lib/common/declarations.d.ts

@@ -167,6 +167,7 @@ declare module Server {
 		error?: Error;
 	}
 
+	/** @deprecated Kept so existing annotations compile; use the {@link HttpClient} contract. */
 	interface IHttpClient extends HttpClient {}
 
 	interface IRequestResponseData {
@@ -215,6 +216,7 @@ interface IReadFileOptions {
 	flag?: string;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link FileSystem} contract. */
 interface IFileSystem extends FileSystem {}
 
 // duplicated from fs.Stats, because I cannot import it here
@@ -245,6 +247,7 @@ interface IOpener {
 	open(filename: string, appname?: string): void;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link Errors} contract. */
 interface IErrors extends Errors {}
 
 interface IFailOptions {
@@ -280,6 +283,7 @@ interface ICancellationService extends IDisposable {
 	end(name: string): void;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link ChildProcess} contract. */
 interface IChildProcess extends ChildProcess {}
 
 interface IExecOptions {
@@ -681,6 +685,7 @@ interface ISysInfo {
 	getXcodeWarning(): Promise<string>;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link HostInfo} contract. */
 interface IHostInfo extends HostInfo {}
 
 // tslint:disable-next-line:interface-name
@@ -817,6 +822,7 @@ interface IDashedOption {
  * Code behind of the "doctor" command
  * @interface
  */
+/** @deprecated Kept so existing annotations compile; use the {@link DoctorService} contract. */
 interface IDoctorService extends DoctorService {}
 
 interface IUtils {

lib/common/definitions/logger.d.ts

@@ -15,6 +15,7 @@ declare global {
 		appenderOptions?: IAppenderOptions;
 	}
 
+	/** @deprecated Kept so existing annotations compile; use the {@link Logger} contract. */
 	interface ILogger extends Logger {}
 
 	interface Log4JSAppenderConfiguration extends Configuration {

lib/common/definitions/mobile.d.ts

@@ -588,6 +588,7 @@ declare global {
 			[platform: string]: string;
 		}
 
+		/** @deprecated Kept so existing annotations compile; use the {@link DevicesService} contract. */
 		interface IDevicesService extends DevicesService {}
 
 		interface IPickSingleDeviceOptions {

lib/declarations.d.ts

@@ -110,6 +110,7 @@ interface INodePackageManager {
 	getCachePath(): Promise<string>;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link PackageManager} contract. */
 interface IPackageManager extends PackageManager {}
 
 interface IPerformanceService {
@@ -971,6 +972,7 @@ interface IVersionsService {
 /**
  * Describes methods for project name.
  */
+/** @deprecated Kept so existing annotations compile; use the {@link ProjectNameService} contract. */
 interface IProjectNameService extends ProjectNameService {}
 
 /**

lib/definitions/project.d.ts

@@ -211,8 +211,10 @@ interface INsConfig {
 	buildPath?: string;
 }
 
+/** @deprecated Kept so existing annotations compile; use the {@link ProjectData} contract. */
 interface IProjectData extends ProjectData {}
 
+/** @deprecated Kept so existing annotations compile; use the {@link ProjectDataService} contract. */
 interface IProjectDataService extends ProjectDataService {}
 
 interface IProjectCleanupService {

lib/definitions/prompter.d.ts

@@ -1,5 +1,6 @@
 import type { Prompter } from "../contracts/prompter";
 
 declare global {
+	/** @deprecated Kept so existing annotations compile; use the {@link Prompter} contract. */
 	interface IPrompter extends Prompter {}
 }

lib/definitions/temp-service.d.ts

@@ -9,4 +9,5 @@ export type AffixOptions = {
 /**
  * Declares wrapped functions of temp module
  */
+/** @deprecated Kept so existing annotations compile; use the {@link TempService} contract. */
 export interface ITempService extends TempService {}