refactor: move ambient const enums into real modules

TypeScript inlines `const enum` values at compile time and erases the
import, so declaring them in .d.ts files worked only because tsc has
whole-program type information. Any file-local transpiler (esbuild, swc,
tsx, vite, bun) cannot inline them and fails to resolve the import, which
blocks running the sources without a full tsc pass.

The 12 ambient const enums now live in real modules:

- 5 from lib/common/declarations.d.ts  -> lib/common/enums.ts
- BuildNames                           -> lib/constants.ts, next to the
                                          other build-related enums
- detached-process-enums, system-warnings and
  google-analytics-custom-dimensions   -> .d.ts renamed to .ts; they held
                                          nothing but enums
- SpecialKeys                          -> key-commands.d.ts renamed to .ts,
                                          which already exported everything,
                                          so importers are unchanged

The four global files had no imports, making their enums globally visible;
consumers now import them explicitly.

GoogleAnalyticsCrossClientCustomDimensions is referenced nowhere and was
dropped rather than converted into a dead runtime module.

Renaming key-commands to .ts surfaced two interface methods whose missing
return types an ambient context had allowed; both implementations return
nothing, so they are annotated void.

Author: edusperoni

lib/commands/build.ts

@@ -13,7 +13,8 @@ import {
 import { IPlatformsDataService } from "../definitions/platform";
 import { IBuildController, IBuildDataService } from "../definitions/build";
 import { IMigrateController } from "../definitions/migrate";
-import { IErrors, OptionType } from "../common/declarations";
+import { IErrors } from "../common/declarations";
+import { OptionType } from "../common/enums";
 import { ICommandParameter, ICommand } from "../common/definitions/commands";
 import { injector } from "../common/yok";
 

lib/commands/debug.ts

@@ -17,6 +17,7 @@ import { ICleanupService } from "../definitions/cleanup-service";
 import { IInjector } from "../common/definitions/yok";
 import { injector } from "../common/yok";
 import * as _ from "lodash";
+import { SystemWarningsSeverity } from "../definitions/system-warnings";
 
 export class DebugPlatformCommand
 	extends ValidatePlatformCommandBase

lib/commands/deploy.ts

@@ -10,12 +10,14 @@ import { IPlatformValidationService, IOptions } from "../declarations";
 import { IPlatformsDataService } from "../definitions/platform";
 import { IMigrateController } from "../definitions/migrate";
 import { ICommand, ICommandParameter } from "../common/definitions/commands";
-import { OptionType, IErrors } from "../common/declarations";
+import { IErrors } from "../common/declarations";
+import { OptionType } from "../common/enums";
 import { injector } from "../common/yok";
 
 export class DeployOnDeviceCommand
 	extends ValidatePlatformCommandBase
-	implements ICommand {
+	implements ICommand
+{
 	public allowedParameters: ICommandParameter[] = [];
 
 	public dashedOptions = {
@@ -36,13 +38,13 @@ export class DeployOnDeviceCommand
 		private $mobileHelper: Mobile.IMobileHelper,
 		$platformsDataService: IPlatformsDataService,
 		private $deployCommandHelper: DeployCommandHelper,
-		private $migrateController: IMigrateController
+		private $migrateController: IMigrateController,
 	) {
 		super(
 			$options,
 			$platformsDataService,
 			$platformValidationService,
-			$projectData
+			$projectData,
 		);
 		this.$projectData.initializeProjectData();
 	}

lib/commands/prepare.ts

@@ -6,7 +6,7 @@ import { IOptions, IPlatformValidationService } from "../declarations";
 import { IPlatformsDataService } from "../definitions/platform";
 import { IMigrateController } from "../definitions/migrate";
 import { ICommand, ICommandParameter } from "../common/definitions/commands";
-import { OptionType } from "../common/declarations";
+import { OptionType } from "../common/enums";
 import { injector } from "../common/yok";
 
 export class PrepareCommand

lib/commands/test.ts

@@ -9,12 +9,11 @@ import { IPlatformEnvironmentRequirements } from "../definitions/platform";
 import { IMigrateController } from "../definitions/migrate";
 import { ICommandParameter, ICommand } from "../common/definitions/commands";
 import {
-	OptionType,
 	IAnalyticsService,
 	IErrors,
 	IDictionary,
-	ErrorCodes,
 } from "../common/declarations";
+import { ErrorCodes, OptionType } from "../common/enums";
 import { ICleanupService } from "../definitions/cleanup-service";
 import { injector } from "../common/yok";
 
@@ -47,19 +46,18 @@ abstract class TestCommandBase {
 				sdk: this.$options.sdk,
 			});
 
-			const selectedDeviceForDebug = await this.$devicesService.pickSingleDevice(
-				{
+			const selectedDeviceForDebug =
+				await this.$devicesService.pickSingleDevice({
 					onlyEmulators: this.$options.emulator,
 					onlyDevices: this.$options.forDevice,
 					deviceId: this.$options.device,
-				}
-			);
+				});
 			devices = [selectedDeviceForDebug];
 			// const debugData = this.getDebugData(platform, projectData, deployOptions, { device: selectedDeviceForDebug.deviceInfo.identifier });
 			// await this.$debugService.debug(debugData, this.$options);
 		} else {
 			devices = await this.$liveSyncCommandHelper.getDeviceInstances(
-				this.platform
+				this.platform,
 			);
 		}
 
@@ -69,25 +67,26 @@ abstract class TestCommandBase {
 		this.$options.env.unitTesting = true;
 
 		const liveSyncInfo = this.$liveSyncCommandHelper.getLiveSyncData(
-			this.$projectData.projectDir
+			this.$projectData.projectDir,
 		);
 
 		const deviceDebugMap: IDictionary<boolean> = {};
 		devices.forEach(
 			(device) =>
-				(deviceDebugMap[device.deviceInfo.identifier] = this.$options.debugBrk)
+				(deviceDebugMap[device.deviceInfo.identifier] = this.$options.debugBrk),
 		);
 
-		const deviceDescriptors = await this.$liveSyncCommandHelper.createDeviceDescriptors(
-			devices,
-			this.platform,
-			<any>{ deviceDebugMap }
-		);
+		const deviceDescriptors =
+			await this.$liveSyncCommandHelper.createDeviceDescriptors(
+				devices,
+				this.platform,
+				<any>{ deviceDebugMap },
+			);
 
 		await this.$testExecutionService.startKarmaServer(
 			this.platform,
 			liveSyncInfo,
-			deviceDescriptors
+			deviceDescriptors,
 		);
 		// if we got here, it means karma exited with exit code 0 (success)
 		process.exit(0);
@@ -100,7 +99,7 @@ abstract class TestCommandBase {
 				// because the Runtime does not watch for the `/data/local/tmp<appId>-livesync-in-progress` file deletion.
 				// The App is closing itself after each test execution and the bug will be reproducible on each LiveSync.
 				this.$errors.fail(
-					"The `--hmr` option is not supported for this command."
+					"The `--hmr` option is not supported for this command.",
 				);
 			}
 
@@ -112,23 +111,21 @@ abstract class TestCommandBase {
 
 		this.$projectData.initializeProjectData();
 		this.$analyticsService.setShouldDispose(
-			this.$options.justlaunch || !this.$options.watch
+			this.$options.justlaunch || !this.$options.watch,
 		);
 		this.$cleanupService.setShouldDispose(
-			this.$options.justlaunch || !this.$options.watch
+			this.$options.justlaunch || !this.$options.watch,
 		);
 
-		const output = await this.$platformEnvironmentRequirements.checkEnvironmentRequirements(
-			{
+		const output =
+			await this.$platformEnvironmentRequirements.checkEnvironmentRequirements({
 				platform: this.platform,
 				projectDir: this.$projectData.projectDir,
 				options: this.$options,
-			}
-		);
+			});
 
-		const canStartKarmaServer = await this.$testExecutionService.canStartKarmaServer(
-			this.$projectData
-		);
+		const canStartKarmaServer =
+			await this.$testExecutionService.canStartKarmaServer(this.$projectData);
 		if (!canStartKarmaServer) {
 			this.$errors.fail({
 				formatStr:
@@ -154,7 +151,7 @@ class TestAndroidCommand extends TestCommandBase implements ICommand {
 		protected $cleanupService: ICleanupService,
 		protected $liveSyncCommandHelper: ILiveSyncCommandHelper,
 		protected $devicesService: Mobile.IDevicesService,
-		protected $migrateController: IMigrateController
+		protected $migrateController: IMigrateController,
 	) {
 		super();
 	}
@@ -195,7 +192,7 @@ class TestIosCommand extends TestCommandBase implements ICommand {
 		protected $cleanupService: ICleanupService,
 		protected $liveSyncCommandHelper: ILiveSyncCommandHelper,
 		protected $devicesService: Mobile.IDevicesService,
-		protected $migrateController: IMigrateController
+		protected $migrateController: IMigrateController,
 	) {
 		super();
 	}