nativescript 9.0.0-alpha.13 → 9.0.0-alpha.14

package/lib/common/mobile/ios/device/ios-device.js

@@ -106,6 +106,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
             const majorVersionAsString = productType.match(/.*?(\d+)\,(\d+)/)[1];
             const majorVersion = parseInt(majorVersionAsString);
             let isArm64Architecture = false;
+            //https://en.wikipedia.org/wiki/List_of_iOS_devices
             if (_.startsWith(productType, "iphone")) {
                 isArm64Architecture = majorVersion >= 6;
             }
@@ -116,6 +117,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
                 isArm64Architecture = majorVersion >= 7;
             }
             else if (_.startsWith(productType, "realitydevice")) {
+                // visionos
                 isArm64Architecture = true;
             }
             activeArchitecture = isArm64Architecture ? "arm64" : "armv7";
@@ -125,6 +127,7 @@ class IOSDevice extends ios_device_base_1.IOSDeviceBase {
     getPlatform(productType) {
         productType = productType.toLowerCase().trim();
         if (_.startsWith(productType, "realitydevice")) {
+            // visionos
             return this.$devicePlatformsConstants.visionOS;
         }
         return this.$devicePlatformsConstants.iOS;
@@ -135,3 +138,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], IOSDevice.prototype, "openDeviceLogStream", null);
 yok_1.injector.register("iOSDevice", IOSDevice);
+//# sourceMappingURL=ios-device.js.map

package/lib/common/mobile/ios/ios-device-base.js

@@ -83,3 +83,4 @@ exports.IOSDeviceBase = IOSDeviceBase;
 __decorate([
     (0, decorators_1.performanceLog)()
 ], IOSDeviceBase.prototype, "getDebugSocket", null);
+//# sourceMappingURL=ios-device-base.js.map

package/lib/common/mobile/ios/ios-device-product-name-mapper.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const yok_1 = require("../../yok");
 class IosDeviceProductNameMapper {
     constructor() {
+        // http://support.hockeyapp.net/kb/client-integration-ios-mac-os-x/ios-device-types
         this.map = {
             "iPhone1,1": "iPhone",
             "iPhone1,2": "iPhone 3G",
@@ -63,3 +64,4 @@ class IosDeviceProductNameMapper {
     }
 }
 yok_1.injector.register("iOSDeviceProductNameMapper", IosDeviceProductNameMapper);
+//# sourceMappingURL=ios-device-product-name-mapper.js.map

package/lib/common/mobile/ios/ios-log-filter.js

@@ -22,3 +22,4 @@ class IOSLogFilter {
 }
 exports.IOSLogFilter = IOSLogFilter;
 yok_1.injector.register("iOSLogFilter", IOSLogFilter);
+//# sourceMappingURL=ios-log-filter.js.map

package/lib/common/mobile/ios/simulator/ios-emulator-services.js

@@ -18,6 +18,7 @@ class IosEmulatorServices {
         try {
             if (options.platform === this.$devicePlatformsConstants.visionOS &&
                 !options.emulatorIdOrName) {
+                // find first available visionOS simulator (for now).
                 const { devices } = await this.tryGetiOSSimDevices();
                 options.emulatorIdOrName = (_a = devices.find((device) => device.platform === this.$devicePlatformsConstants.visionOS)) === null || _a === void 0 ? void 0 : _a.id;
             }
@@ -51,6 +52,8 @@ class IosEmulatorServices {
     }
     async connectToPort(data) {
         try {
+            // node v17+ resolves localhost to ::1 (ipv6) instead of 127.0.0.1 (ipv4)
+            // so we explicitly pass ipv4
             const socket = net.connect(data.port, "127.0.0.1");
             return socket;
         }
@@ -108,3 +111,4 @@ class IosEmulatorServices {
     }
 }
 yok_1.injector.register("iOSEmulatorServices", IosEmulatorServices);
+//# sourceMappingURL=ios-emulator-services.js.map

package/lib/common/mobile/ios/simulator/ios-sim-resolver.js

@@ -21,3 +21,4 @@ exports.IOSSimResolver = IOSSimResolver;
 IOSSimResolver.iOSSimName = "ios-sim-portable";
 IOSSimResolver.iOSStandaloneExecutableName = "ios-sim-standalone.js";
 yok_1.injector.register("iOSSimResolver", IOSSimResolver);
+//# sourceMappingURL=ios-sim-resolver.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-application-manager.js

@@ -73,8 +73,13 @@ class IOSSimulatorApplicationManager extends application_manager_base_1.Applicat
         return [];
     }
     async getDebuggableAppViews(appIdentifiers) {
+        // Implement when we can find debuggable applications for iOS.
         return Promise.resolve(null);
     }
+    // iOS will kill the app if we freeze it in the NativeScript Runtime and wait for debug-brk.
+    // In order to avoid that, we are attaching lldb and passing it "process continue".
+    // In this way, iOS will not kill the app because it has a native debugger attached
+    // and the users will be able to attach a debug session using the debug-brk flag.
     attachNativeDebugger(appId, pid) {
         this._lldbProcesses[appId] = this.$childProcess.spawn("lldb", ["-p", pid]);
         if (log4js.levels.TRACE.isGreaterThanOrEqualTo(this.$logger.getLevel())) {
@@ -116,3 +121,4 @@ __decorate([
 __decorate([
     (0, decorators_1.cache)()
 ], IOSSimulatorApplicationManager.prototype, "startDeviceLog", null);
+//# sourceMappingURL=ios-simulator-application-manager.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-device.js

@@ -65,11 +65,15 @@ class IOSSimulator extends ios_device_base_1.IOSDeviceBase {
         let socket;
         const attachRequestMessage = this.$iOSNotification.getAttachRequest(appId, this.deviceInfo.identifier);
         await this.$iOSEmulatorServices.postDarwinNotification(attachRequestMessage, this.deviceInfo.identifier);
+        // Retry posting the notification every five seconds, in case the AttachRequest
+        // event handler wasn't registered when the first one was sent
         const postNotificationRetryInterval = setInterval(() => {
             this.$iOSEmulatorServices
                 .postDarwinNotification(attachRequestMessage, this.deviceInfo.identifier)
                 .catch((e) => this.$logger.error(e));
         }, 5e3);
+        // the internal retry-mechanism of getDebuggerPort will ensure the above
+        // interval has a chance to execute multiple times
         const port = await super.getDebuggerPort(appId).finally(() => {
             clearInterval(postNotificationRetryInterval);
         });
@@ -88,3 +92,4 @@ exports.IOSSimulator = IOSSimulator;
 __decorate([
     (0, decorators_1.cache)()
 ], IOSSimulator.prototype, "openDeviceLogStream", null);
+//# sourceMappingURL=ios-simulator-device.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-file-system.js

@@ -54,3 +54,4 @@ class IOSSimulatorFileSystem {
     }
 }
 exports.IOSSimulatorFileSystem = IOSSimulatorFileSystem;
+//# sourceMappingURL=ios-simulator-file-system.js.map

package/lib/common/mobile/ios/simulator/ios-simulator-log-provider.js

@@ -56,3 +56,4 @@ class IOSSimulatorLogProvider extends events_1.EventEmitter {
 }
 exports.IOSSimulatorLogProvider = IOSSimulatorLogProvider;
 yok_1.injector.register("iOSSimulatorLogProvider", IOSSimulatorLogProvider);
+//# sourceMappingURL=ios-simulator-log-provider.js.map

package/lib/common/mobile/local-to-device-path-data-factory.js

@@ -35,3 +35,4 @@ class LocalToDevicePathDataFactory {
 }
 exports.LocalToDevicePathDataFactory = LocalToDevicePathDataFactory;
 yok_1.injector.register("localToDevicePathDataFactory", LocalToDevicePathDataFactory);
+//# sourceMappingURL=local-to-device-path-data-factory.js.map

package/lib/common/mobile/log-filter.js

@@ -24,6 +24,7 @@ class LogFilter {
         if (deviceLogFilter) {
             return deviceLogFilter.filterData(data, loggingOptions);
         }
+        // In case the platform is not valid, just return the data without filtering.
         return data;
     }
     getDeviceLogFilterInstance(platform) {
@@ -49,3 +50,4 @@ class LogFilter {
 }
 exports.LogFilter = LogFilter;
 yok_1.injector.register("logFilter", LogFilter);
+//# sourceMappingURL=log-filter.js.map

package/lib/common/mobile/logging-levels.js

@@ -10,3 +10,4 @@ class LoggingLevels {
 }
 exports.LoggingLevels = LoggingLevels;
 yok_1.injector.register("loggingLevels", LoggingLevels);
+//# sourceMappingURL=logging-levels.js.map

package/lib/common/mobile/mobile-core/android-device-discovery.js

@@ -38,6 +38,7 @@ class AndroidDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
     }
     async checkCurrentData(result) {
         const currentDevices = result.map((element) => {
+            // http://developer.android.com/tools/help/adb.html#devicestatus
             const data = element.split("\t");
             const identifier = data[0];
             const status = data[1];
@@ -70,3 +71,4 @@ class AndroidDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
 }
 exports.AndroidDeviceDiscovery = AndroidDeviceDiscovery;
 yok_1.injector.register("androidDeviceDiscovery", AndroidDeviceDiscovery);
+//# sourceMappingURL=android-device-discovery.js.map

package/lib/common/mobile/mobile-core/android-emulator-discovery.js

@@ -21,9 +21,11 @@ class AndroidEmulatorDiscovery extends events_1.EventEmitter {
         const availableEmulatorsOutput = await this.$androidEmulatorServices.getEmulatorImages();
         const currentEmulators = availableEmulatorsOutput.devices;
         const cachedEmulators = _.values(this._emulators);
+        // Remove old emulators
         const lostEmulators = _(cachedEmulators)
             .reject((e) => _.some(currentEmulators, (emulator) => emulator && e && emulator.imageIdentifier === e.imageIdentifier))
             .value();
+        // Add new emulators
         const foundEmulators = _(currentEmulators)
             .reject((e) => _.some(cachedEmulators, (emulator) => emulator && e && emulator.imageIdentifier === e.imageIdentifier))
             .value();
@@ -52,3 +54,4 @@ class AndroidEmulatorDiscovery extends events_1.EventEmitter {
 }
 exports.AndroidEmulatorDiscovery = AndroidEmulatorDiscovery;
 yok_1.injector.register("androidEmulatorDiscovery", AndroidEmulatorDiscovery);
+//# sourceMappingURL=android-emulator-discovery.js.map

package/lib/common/mobile/mobile-core/android-process-service.js

@@ -71,6 +71,19 @@ class AndroidProcessService {
     async getDebuggableApps(deviceIdentifier) {
         const adb = this.getAdb(deviceIdentifier);
         const androidWebViewPortInformation = (await this.getAbstractPortsInformation(adb)).split(os_1.EOL);
+        // TODO: Add tests and make sure only unique names are returned. Input before groupBy is:
+        // [ { deviceIdentifier: 'SH26BW100473',
+        // 	appIdentifier: 'com.telerik.EmptyNS',
+        // 	framework: 'NativeScript' },
+        // 	{ deviceIdentifier: 'SH26BW100473',
+        // 	appIdentifier: 'com.telerik.EmptyNS',
+        // 	framework: 'Cordova' },
+        // 	{ deviceIdentifier: 'SH26BW100473',
+        // 	appIdentifier: 'chrome',
+        // 	framework: 'Cordova' },
+        // 	{ deviceIdentifier: 'SH26BW100473',
+        // 	appIdentifier: 'chrome',
+        // 	framework: 'Cordova' } ]
         const portInformation = await Promise.all(_.map(androidWebViewPortInformation, async (line) => (await this.getApplicationInfoFromWebViewPortInformation(adb, deviceIdentifier, line)) ||
             (await this.getNativeScriptApplicationInformation(adb, deviceIdentifier, line))));
         return _(portInformation)
@@ -109,6 +122,7 @@ class AndroidProcessService {
         return adb;
     }
     async getApplicationInfoFromWebViewPortInformation(adb, deviceIdentifier, information) {
+        // Need to search by processId to check for old Android webviews (@webview_devtools_remote_<processId>).
         const processIdRegExp = /@webview_devtools_remote_(.+)/g;
         const processIdMatches = processIdRegExp.exec(information);
         let cordovaAppIdentifier;
@@ -117,6 +131,7 @@ class AndroidProcessService {
             cordovaAppIdentifier = await this.getApplicationIdentifierFromPid(adb, processId);
         }
         else {
+            // Search for appIdentifier (@<appIdentifier>_devtools_remote).
             const chromeAppIdentifierRegExp = /@(.+)_devtools_remote\s?/g;
             const chromeAppIdentifierMatches = chromeAppIdentifierRegExp.exec(information);
             if (chromeAppIdentifierMatches && chromeAppIdentifierMatches.length > 0) {
@@ -133,6 +148,7 @@ class AndroidProcessService {
         return null;
     }
     async getNativeScriptApplicationInformation(adb, deviceIdentifier, information) {
+        // Search for appIdentifier (@<appIdentifier-debug>).
         const nativeScriptAppIdentifierRegExp = /@(.+)-(debug|inspectorServer)/g;
         const nativeScriptAppIdentifierMatches = nativeScriptAppIdentifierRegExp.exec(information);
         if (nativeScriptAppIdentifierMatches &&
@@ -147,6 +163,10 @@ class AndroidProcessService {
         return null;
     }
     async getAbstractPortForApplication(adb, processId, appIdentifier, abstractPortsInformation, framework) {
+        // The result will look like this (without the columns names):
+        // Num       		 RefCount Protocol Flags    Type St Inode  Path
+        // 0000000000000000: 00000002 00000000 00010000 0001 01 189004 @webview_devtools_remote_25512
+        // The Path column is the abstract port.
         framework = framework || "";
         switch (framework.toLowerCase()) {
             case constants_1.TARGET_FRAMEWORK_IDENTIFIERS.Cordova.toLowerCase():
@@ -173,6 +193,9 @@ class AndroidProcessService {
         return match && match[1];
     }
     async getProcessIds(adb, appIdentifiers) {
+        // Process information will look like this (without the columns names):
+        // USER     PID   PPID  VSIZE   RSS   WCHAN    PC         NAME
+        // u0_a63   25512 1334  1519560 96040 ffffffff f76a8f75 S com.telerik.appbuildertabstest
         const result = {};
         const processIdInformation = await adb.executeShellCommand(["ps"]);
         _.each(appIdentifiers, (appIdentifier) => {
@@ -183,6 +206,11 @@ class AndroidProcessService {
     }
     async getAlreadyMappedPort(adb, deviceIdentifier, abstractPort, adbForwardList) {
         const allForwardedPorts = adbForwardList || (await adb.executeCommand(["forward", "--list"])) || "";
+        // Sample output:
+        // 5e2e580b tcp:62503 localabstract:webview_devtools_remote_7985
+        // 5e2e580b tcp:62524 localabstract:webview_devtools_remote_7986
+        // 5e2e580b tcp:63160 localabstract:webview_devtools_remote_7987
+        // 5e2e580b tcp:57577 localabstract:com.telerik.nrel-debug
         const regex = new RegExp(`${deviceIdentifier}\\s+?tcp:(\\d+?)\\s+?.*?${abstractPort}$`);
         return this.getFirstMatchingGroupFromMultilineResult(allForwardedPorts, regex);
     }
@@ -196,6 +224,9 @@ class AndroidProcessService {
     }
     async getApplicationIdentifierFromPid(adb, pid, psData) {
         psData = psData || (await adb.executeShellCommand(["ps"]));
+        // Process information will look like this (without the columns names):
+        // USER     PID   PPID  VSIZE   RSS   WCHAN    PC         NAME
+        // u0_a63   25512 1334  1519560 96040 ffffffff f76a8f75 S com.telerik.appbuildertabstest
         return this.getFirstMatchingGroupFromMultilineResult(psData, new RegExp(`\\s+${pid}(?:\\s+\\d+){3}\\s+.*\\s+(.*?)$`));
     }
     getFirstMatchingGroupFromMultilineResult(input, regex) {
@@ -218,3 +249,4 @@ __decorate([
     (0, decorators_1.exported)("androidProcessService")
 ], AndroidProcessService.prototype, "getAppProcessId", null);
 yok_1.injector.register("androidProcessService", AndroidProcessService);
+//# sourceMappingURL=android-process-service.js.map

package/lib/common/mobile/mobile-core/device-discovery.js

@@ -51,3 +51,4 @@ class DeviceDiscovery extends events_1.EventEmitter {
 }
 exports.DeviceDiscovery = DeviceDiscovery;
 yok_1.injector.register("deviceDiscovery", DeviceDiscovery);
+//# sourceMappingURL=device-discovery.js.map

package/lib/common/mobile/mobile-core/devices-service.js

@@ -62,6 +62,7 @@ class DevicesService extends events_1.EventEmitter {
             const device = await this.getDevice(options.deviceId);
             return device;
         }
+        // Now let's take data for each device:
         const availableDevicesAndEmulators = this.getDeviceInstances().filter((d) => d.deviceInfo.status === constants_2.CONNECTED_STATUS &&
             (!this.platform ||
                 d.deviceInfo.platform.toLowerCase() === this.platform.toLowerCase()));
@@ -84,6 +85,8 @@ class DevicesService extends events_1.EventEmitter {
                 const devices = sortedInstances.filter((d) => !d.isEmulator);
                 let selectedInstance;
                 if (options.onlyEmulators || options.onlyDevices) {
+                    // When --emulator or --forDevice is passed, the instances are already filtered
+                    // So we are sure we have exactly the type we need and we can safely return the last one (highest OS version).
                     selectedInstance = _.last(sortedInstances);
                 }
                 else {
@@ -142,6 +145,7 @@ class DevicesService extends events_1.EventEmitter {
                 ...additionalErrors,
             ];
         }
+        // emulator is already running
         if (emulator.status === constants.RUNNING_EMULATOR_STATUS) {
             return null;
         }
@@ -173,9 +177,11 @@ class DevicesService extends events_1.EventEmitter {
         return !!(this.$mobileHelper.isiOSPlatform(device.deviceInfo.platform) &&
             device.isEmulator);
     }
+    /* tslint:disable:no-unused-variable */
     setLogLevel(logLevel, deviceIdentifier) {
         this.$deviceLogProvider.setLogLevel(logLevel, deviceIdentifier);
     }
+    /* tslint:enable:no-unused-variable */
     isAppInstalledOnDevices(deviceIdentifiers, appId, projectName, projectDir) {
         this.$logger.trace(`Called isInstalledOnDevices for identifiers ${deviceIdentifiers}. AppIdentifier is ${appId}.`);
         return _.map(deviceIdentifiers, (deviceIdentifier) => this.isApplicationInstalledOnDevice(deviceIdentifier, {
@@ -247,6 +253,9 @@ class DevicesService extends events_1.EventEmitter {
         delete this._availableEmulators[emulator.imageIdentifier];
         this.emit(constants.EmulatorDiscoveryNames.EMULATOR_IMAGE_LOST, emulator);
     }
+    /**
+     * Starts looking for devices. Any found devices are pushed to "_devices" variable.
+     */
     async detectCurrentlyAttachedDevices(deviceInitOpts) {
         const options = this.getDeviceLookingOptions(deviceInitOpts);
         for (const deviceDiscovery of this._allDeviceDiscoveries) {
@@ -315,6 +324,11 @@ class DevicesService extends events_1.EventEmitter {
             clearInterval(this.emulatorDetectionInterval);
         }
     }
+    /**
+     * Returns device that matches an identifier.
+     * The identifier is expected to be the same as the running device declares it (emulator-5554 for android or GUID for ios).
+     * @param identifier running emulator or device identifier
+     */
     getDeviceByIdentifier(identifier) {
         const searchedDevice = _.find(this.getDeviceInstances(), (device) => {
             if (this.$mobileHelper.isApplePlatform(device.deviceInfo.platform) &&
@@ -330,6 +344,9 @@ class DevicesService extends events_1.EventEmitter {
         }
         return searchedDevice;
     }
+    /**
+     * Starts looking for running devices. All found devices are pushed to _devices variable.
+     */
     async startLookingForDevices(deviceInitOpts) {
         this.$logger.trace("startLookingForDevices; platform is %s", this._platform);
         if (this._platform) {
@@ -339,10 +356,20 @@ class DevicesService extends events_1.EventEmitter {
         await this.detectCurrentlyAvailableEmulators();
         await this.startDeviceDetectionInterval(deviceInitOpts);
     }
+    /**
+     * Returns device depending on the passed index.
+     * The index refers to assigned number to listed devices by ns device command.
+     * @param index assigned device number
+     */
     getDeviceByIndex(index) {
         this.validateIndex(index - 1);
         return this.getDeviceInstances()[index - 1];
     }
+    /**
+     * Returns running device for specified --device <DeviceId>.
+     * Method expects running devices.
+     * @param deviceOption parameter passed by the user to --device flag. Can be name, identifier or imageIdentifier.
+     */
     async getDevice(deviceOption) {
         let device = null;
         if (!device) {
@@ -362,6 +389,11 @@ class DevicesService extends events_1.EventEmitter {
         }
         return device;
     }
+    /**
+     * Method runs action for a --device (value), specified by the user.
+     * @param action action to be executed if canExecute returns true
+     * @param canExecute predicate to decide whether the command can be ran
+     */
     async executeOnDevice(action, canExecute) {
         if (!canExecute || canExecute(this._device)) {
             return {
@@ -370,6 +402,11 @@ class DevicesService extends events_1.EventEmitter {
             };
         }
     }
+    /**
+     * Executes passed action for each found device.
+     * @param action action to be executed if canExecute returns true
+     * @param canExecute predicate to decide whether the command can be ran
+     */
     async executeOnAllConnectedDevices(action, canExecute) {
         const devices = this.filterDevicesByPlatform();
         const sortedDevices = _.sortBy(devices, (device) => device.deviceInfo.platform);
@@ -421,6 +458,12 @@ class DevicesService extends events_1.EventEmitter {
             });
         });
     }
+    /**
+     * Runs the passed action if the predicate "canExecute" returns true
+     * @param action action to be executed if canExecute returns true.
+     * @param canExecute predicate to decide whether the command can be ran
+     * @param options all possible options that can be passed to the command.
+     */
     async execute(action, canExecute, options) {
         assert.ok(this._isInitialized, "Devices services not initialized!");
         if (this.hasDevices) {
@@ -429,6 +472,7 @@ class DevicesService extends events_1.EventEmitter {
                 this.$mobileHelper.isiOSPlatform(this._platform) &&
                 this.$options.emulator &&
                 !this.isOnlyiOSSimultorRunning()) {
+                // Executes the command only on iOS simulator
                 const originalCanExecute = canExecute;
                 canExecute = (dev) => this.isiOSSimulator(dev) &&
                     (!originalCanExecute || !!originalCanExecute(dev));
@@ -452,6 +496,11 @@ class DevicesService extends events_1.EventEmitter {
             }
         }
     }
+    /**
+     * Starts emulator or simulator if necessary depending on --device or --emulator flags.
+     * If no options are passed runs default emulator/simulator if no devices are connected.
+     * @param deviceInitOpts mainly contains information about --emulator and --deviceId flags.
+     */
     async startEmulatorIfNecessary(deviceInitOpts) {
         if (deviceInitOpts && deviceInitOpts.deviceId && deviceInitOpts.emulator) {
             this.$errors.fail(`--device and --emulator are incompatible options.
@@ -460,6 +509,7 @@ class DevicesService extends events_1.EventEmitter {
         if (deviceInitOpts &&
             deviceInitOpts.platform &&
             !deviceInitOpts.skipEmulatorStart) {
+            // are there any running devices
             this._platform = deviceInitOpts.platform;
             try {
                 await this.startLookingForDevices(deviceInitOpts);
@@ -485,9 +535,11 @@ class DevicesService extends events_1.EventEmitter {
     }
     async _startEmulatorIfNecessary(data) {
         const deviceInstances = this.getDeviceInstances();
+        //if no --device is passed and no devices are found, the default emulator is started
         if (!data.deviceId && _.isEmpty(deviceInstances)) {
             return this.startEmulatorCore(data);
         }
+        //check if --device(value) is running, if it's not or it's not the same as is specified, start with name from --device(value)
         if (data.deviceId) {
             if (!helpers.isNumberWithoutExponent(data.deviceId)) {
                 const activeDeviceInstance = _.find(deviceInstances, (device) => device.deviceInfo.identifier === data.deviceId);
@@ -496,6 +548,7 @@ class DevicesService extends events_1.EventEmitter {
                 }
             }
         }
+        // make sure if the target platform is visionOS we don't try to run it on an already running iOS simulator...
         if (data.platform === this.$devicePlatformsConstants.visionOS &&
             deviceInstances.length) {
             const runningDeviceInstance = deviceInstances.find((device) => device.deviceInfo.platform ===
@@ -504,6 +557,7 @@ class DevicesService extends events_1.EventEmitter {
                 return this.startEmulatorCore(data);
             }
         }
+        // if only emulator flag is passed and no other emulators are running, start default emulator
         if (data.emulator && deviceInstances.length) {
             const runningDeviceInstance = _.some(deviceInstances, (value) => value.isEmulator);
             if (!runningDeviceInstance) {
@@ -511,6 +565,12 @@ class DevicesService extends events_1.EventEmitter {
             }
         }
     }
+    /**
+     * Takes care of gathering information about all running devices.
+     * Sets "_isInitialized" to true after infomation is present.
+     * Method expects running devices.
+     * @param data mainly contains information about --emulator and --deviceId flags.
+     */
     async initialize(data) {
         if (!this._deviceInitializePromise) {
             this._deviceInitializePromise = this.initializeCore(data);
@@ -519,6 +579,7 @@ class DevicesService extends events_1.EventEmitter {
             await this._deviceInitializePromise;
         }
         catch (err) {
+            // In case the initalization fails, we want to allow calling `initlialize` again with other arguments for example, so remove the cached promise value.
             this.$logger.trace(`Error while initializing devicesService: ${err}`);
             this._deviceInitializePromise = null;
             throw err;
@@ -542,6 +603,7 @@ class DevicesService extends events_1.EventEmitter {
         deviceInitOpts = deviceInitOpts || {};
         this._data = deviceInitOpts;
         if (!deviceInitOpts.skipEmulatorStart) {
+            // TODO: Remove from here as it calls startLookingForDevices, so we double the calls to specific device detection services
             await this.startEmulatorIfNecessary(deviceInitOpts);
         }
         const platform = deviceInitOpts.platform;
@@ -572,6 +634,7 @@ class DevicesService extends events_1.EventEmitter {
             await this.startLookingForDevices(deviceLookingOptions);
         }
         else {
+            // platform and deviceId are not specified
             if (deviceInitOpts.skipInferPlatform) {
                 if (deviceInitOpts.skipDeviceDetectionInterval) {
                     await this.detectCurrentlyAttachedDevices(deviceLookingOptions);
@@ -679,6 +742,11 @@ class DevicesService extends events_1.EventEmitter {
         }
         return null;
     }
+    /**
+     * Starts emulator for platform and makes sure started devices/emulators/simulators are in _devices array before finishing.
+     * @param platform (optional) platform to start emulator/simulator for
+     * @param emulatorIdOrName (optional) emulator/simulator image identifier or name
+     */
     async startEmulatorCore(deviceInitOpts = {}) {
         const { deviceId } = deviceInitOpts;
         const platform = deviceInitOpts.platform || this._platform;
@@ -802,3 +870,4 @@ __decorate([
     (0, decorators_1.exported)("devicesService")
 ], DevicesService.prototype, "getDebuggableViews", null);
 yok_1.injector.register("devicesService", DevicesService);
+//# sourceMappingURL=devices-service.js.map

package/lib/common/mobile/mobile-core/ios-device-discovery.js

@@ -22,6 +22,7 @@ class IOSDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
             return;
         }
         if (this.$mobileHelper.isvisionOSPlatform(options.platform)) {
+            // look for ios devices - same logic.
             options.platform = this.$devicePlatformsConstants.iOS;
         }
         await this.$iosDeviceOperations.startLookingForDevices((deviceInfo) => {
@@ -50,3 +51,4 @@ class IOSDeviceDiscovery extends device_discovery_1.DeviceDiscovery {
 }
 exports.IOSDeviceDiscovery = IOSDeviceDiscovery;
 yok_1.injector.register("iOSDeviceDiscovery", IOSDeviceDiscovery);
+//# sourceMappingURL=ios-device-discovery.js.map

package/lib/common/mobile/mobile-core/ios-simulator-discovery.js

@@ -28,12 +28,14 @@ class IOSSimulatorDiscovery extends device_discovery_1.DeviceDiscovery {
     async checkForDevices() {
         if (this.$hostInfo.isDarwin) {
             const currentSimulators = await this.$iOSSimResolver.iOSSim.getRunningSimulators();
+            // Remove old simulators
             _(this.cachedSimulators)
                 .reject((s) => _.some(currentSimulators, (simulator) => simulator &&
                 s &&
                 simulator.id === s.id &&
                 simulator.state === s.state))
                 .each((s) => this.deleteAndRemoveDevice(s));
+            // Add new simulators
             _(currentSimulators)
                 .reject((s) => _.some(this.cachedSimulators, (simulator) => simulator &&
                 s &&
@@ -92,3 +94,4 @@ class IOSSimulatorDiscovery extends device_discovery_1.DeviceDiscovery {
 }
 exports.IOSSimulatorDiscovery = IOSSimulatorDiscovery;
 yok_1.injector.register("iOSSimulatorDiscovery", IOSSimulatorDiscovery);
+//# sourceMappingURL=ios-simulator-discovery.js.map

package/lib/common/mobile/mobile-helper.js

@@ -89,3 +89,4 @@ class MobileHelper {
 exports.MobileHelper = MobileHelper;
 MobileHelper.DEVICE_PATH_SEPARATOR = "/";
 yok_1.injector.register("mobileHelper", MobileHelper);
+//# sourceMappingURL=mobile-helper.js.map

package/lib/common/mobile/wp8/wp8-emulator-services.js

@@ -53,3 +53,4 @@ class Wp8EmulatorServices {
 Wp8EmulatorServices.WP8_LAUNCHER = "XapDeployCmd.exe";
 Wp8EmulatorServices.WP8_LAUNCHER_PATH = "Microsoft SDKs\\Windows Phone\\v8.0\\Tools\\XAP Deployment";
 yok_1.injector.register("wp8EmulatorServices", Wp8EmulatorServices);
+//# sourceMappingURL=wp8-emulator-services.js.map

package/lib/common/opener.js

@@ -14,3 +14,4 @@ class Opener {
 }
 exports.Opener = Opener;
 yok_1.injector.register("opener", Opener);
+//# sourceMappingURL=opener.js.map

package/lib/common/os-info.js

@@ -19,3 +19,4 @@ class OsInfo {
 }
 exports.OsInfo = OsInfo;
 yok_1.injector.register("osInfo", OsInfo);
+//# sourceMappingURL=os-info.js.map

package/lib/common/plist-parser.js

@@ -22,3 +22,4 @@ class PlistParser {
 }
 exports.PlistParser = PlistParser;
 yok_1.injector.register("plistParser", PlistParser);
+//# sourceMappingURL=plist-parser.js.map

package/lib/common/project-helper.js

@@ -68,3 +68,4 @@ class ProjectHelper {
 }
 exports.ProjectHelper = ProjectHelper;
 yok_1.injector.register("projectHelper", ProjectHelper);
+//# sourceMappingURL=project-helper.js.map

package/lib/common/prompter.js

@@ -26,6 +26,7 @@ class Prompter {
                 else {
                     const result = {};
                     _.each(questions, (s) => {
+                        // Curly brackets needed because s.default() may return false and break the loop
                         result[s.name] = s.default();
                     });
                     return result;
@@ -122,7 +123,9 @@ class Prompter {
     }
     muteStdout() {
         if (helpers.isInteractive()) {
-            process.stdin.setRawMode(true);
+            process.stdin.setRawMode(true); // After setting rawMode to true, Ctrl+C doesn't work for non node.js events loop i.e device log command
+            // We need to create mute-stream and to pass it as output to ctrlcReader
+            // This will prevent the prompter to show the user's text twice on the console
             this.muteStreamInstance = new MuteStream();
             this.muteStreamInstance.pipe(process.stdout);
             this.muteStreamInstance.mute();
@@ -131,6 +134,7 @@ class Prompter {
                 output: this.muteStreamInstance,
             });
             this.ctrlcReader.on("SIGINT", () => {
+                // enable terminal cursor
                 process.stdout.write("\x1B[?25h");
                 process.exit();
             });
@@ -140,6 +144,7 @@ class Prompter {
         if (helpers.isInteractive()) {
             process.stdin.setRawMode(false);
             if (this.muteStreamInstance) {
+                // We need to clean the event listeners from the process.stdout because the MuteStream.pipe function calls the pipe function of the Node js Stream which adds event listeners and this can cause memory leak if we display more than ~10 prompts.
                 this.cleanEventListeners(process.stdout);
                 this.muteStreamInstance.unmute();
                 this.muteStreamInstance = null;
@@ -148,6 +153,8 @@ class Prompter {
         }
     }
     cleanEventListeners(stream) {
+        // The events names and listeners names can be found here https://github.com/nodejs/node/blob/master/lib/stream.js
+        // Which event cause memory leak can be tested with stream.listeners("event-name") and if the listeners count keeps increasing with each prompt we need to remove the listener.
         const memoryLeakEvents = [
             {
                 eventName: "close",
@@ -174,3 +181,4 @@ class Prompter {
 }
 exports.Prompter = Prompter;
 yok_1.injector.register("prompter", Prompter);
+//# sourceMappingURL=prompter.js.map

package/lib/common/queue.js

@@ -24,3 +24,4 @@ class Queue {
     }
 }
 exports.Queue = Queue;
+//# sourceMappingURL=queue.js.map

package/lib/common/resource-loader.js

@@ -23,3 +23,4 @@ class ResourceLoader {
 }
 exports.ResourceLoader = ResourceLoader;
 yok_1.injector.register("resources", ResourceLoader);
+//# sourceMappingURL=resource-loader.js.map