nativescript 8.8.0 → 8.8.1

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

@@ -32,6 +32,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;
             }
             yield this.$iosDeviceOperations.startLookingForDevices((deviceInfo) => {
@@ -61,3 +62,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

@@ -40,12 +40,14 @@ class IOSSimulatorDiscovery extends device_discovery_1.DeviceDiscovery {
         return __awaiter(this, void 0, void 0, function* () {
             if (this.$hostInfo.isDarwin) {
                 const currentSimulators = yield 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 &&
@@ -107,3 +109,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

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

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

@@ -80,3 +80,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

@@ -36,6 +36,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;
@@ -137,7 +138,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();
@@ -146,6 +149,7 @@ class Prompter {
                 output: this.muteStreamInstance,
             });
             this.ctrlcReader.on("SIGINT", () => {
+                // enable terminal cursor
                 process.stdout.write("\x1B[?25h");
                 process.exit();
             });
@@ -155,6 +159,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;
@@ -163,6 +168,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",
@@ -189,3 +196,4 @@ class Prompter {
 }
 exports.Prompter = Prompter;
 yok_1.injector.register("prompter", Prompter);
+//# sourceMappingURL=prompter.js.map

package/lib/common/queue.js

@@ -35,3 +35,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

package/lib/common/services/auto-completion-service.js

@@ -36,12 +36,15 @@ class AutoCompletionService {
     get shellProfiles() {
         return [
             this.getHomePath(".bashrc"),
-            this.getHomePath(".zshrc"),
+            this.getHomePath(".zshrc"), // zsh - http://www.acm.uiuc.edu/workshops/zsh/startup_files.html
         ];
     }
     get cliRunCommandsFile() {
         let cliRunCommandsFile = this.getHomePath(util.format(".%src", this.$staticConfig.CLIENT_NAME.toLowerCase()));
         if (this.$hostInfo.isWindows) {
+            // on Windows bash, file is incorrectly written as C:\Users\<username>, which leads to errors when trying to execute the script:
+            // $ source ~/.bashrc
+            // sh.exe": C:Usersusername.appbuilderrc: No such file or directory
             cliRunCommandsFile = cliRunCommandsFile.replace(/\\/g, "/");
         }
         return cliRunCommandsFile;
@@ -56,7 +59,9 @@ class AutoCompletionService {
         return new RegExp(util.format("%s[\\s\\S]*%s", AutoCompletionService.GENERATED_TABTAB_COMPLETION_START, AutoCompletionService.GENERATED_TABTAB_COMPLETION_END));
     }
     removeObsoleteAutoCompletion() {
+        // In previous releases we were writing directly in .bash_profile, .bashrc, .zshrc and .profile - remove this old code
         const shellProfilesToBeCleared = this.shellProfiles;
+        // Add .profile only here as we do not want new autocompletion in this file, but we have to remove our old code from it.
         shellProfilesToBeCleared.push(this.getHomePath(".profile"));
         shellProfilesToBeCleared.forEach((file) => {
             try {
@@ -109,6 +114,7 @@ class AutoCompletionService {
                 this.isNewAutoCompletionEnabledInFile(filePath) ||
                     this.isObsoleteAutoCompletionEnabledInFile(filePath);
             if (!result) {
+                // break each
                 return false;
             }
         });
@@ -136,6 +142,7 @@ class AutoCompletionService {
         _.each(this.shellProfiles, (shellProfile) => {
             result = this.isObsoleteAutoCompletionEnabledInFile(shellProfile);
             if (!result) {
+                // break each
                 return false;
             }
         });
@@ -174,6 +181,8 @@ class AutoCompletionService {
         }
         catch (err) {
             this.$logger.info("Unable to update %s. Command-line completion might not work.", fileName);
+            // When npm is installed with sudo, in some cases the installation cannot write to shell profiles
+            // Advise the user how to enable autocompletion after the installation is completed.
             if ((err.code === "EPERM" || err.code === "EACCES") &&
                 !this.$hostInfo.isWindows &&
                 process.env.SUDO_USER) {
@@ -194,6 +203,7 @@ class AutoCompletionService {
             }
         }
         catch (err) {
+            // If file does not exist, autocompletion was not working for it, so ignore this error.
             if (err.code !== "ENOENT") {
                 this.$logger.info("Failed to update %s. Auto-completion may still work or work incorrectly. ", fileName);
                 this.$logger.info(err);
@@ -226,6 +236,7 @@ class AutoCompletionService {
                             this.$fs.writeFile(filePath, newText);
                         }
                     }
+                    // The generated seems to be inconsistent in it's start/end markers so adding our own.
                     this.$fs.appendFile(filePath, `\n${AutoCompletionService.GENERATED_TABTAB_COMPLETION_START}\n`);
                     yield this.$childProcess.exec(`"${process.argv[0]}" "${pathToExecutableFile}" completion_generate_script >> "${filePath}"`);
                     this.$fs.appendFile(filePath, this.completionAliasDefinition);
@@ -263,3 +274,4 @@ __decorate([
 ], AutoCompletionService.prototype, "completionShellScriptContent", null);
 exports.AutoCompletionService = AutoCompletionService;
 yok_1.injector.register("autoCompletionService", AutoCompletionService);
+//# sourceMappingURL=auto-completion-service.js.map

package/lib/common/services/cancellation.js

@@ -38,7 +38,7 @@ class CancellationService {
                 .watch(triggerFile, { ignoreInitial: true })
                 .on("unlink", (filePath) => {
                 this.$logger.info(`Exiting process as the file ${filePath} has been deleted. Probably reinstalling CLI while there's a working instance.`);
-                process.exit(132);
+                process.exit(132 /* ErrorCodes.DELETED_KILL_FILE */);
             });
             if (watcher) {
                 this.watches[name] = watcher;
@@ -65,3 +65,4 @@ class CancellationService {
     }
 }
 yok_1.injector.register("cancellation", CancellationService);
+//# sourceMappingURL=cancellation.js.map

package/lib/common/services/commands-service.js

@@ -48,11 +48,11 @@ class CommandsService {
                 if (!this.$staticConfig.disableAnalytics &&
                     !command.disableAnalytics &&
                     !this.$options.disableAnalytics) {
-                    const analyticsService = this.$injector.resolve("analyticsService");
+                    const analyticsService = this.$injector.resolve("analyticsService"); // This should be resolved here due to cyclic dependency
                     yield analyticsService.checkConsent();
                     const beautifiedCommandName = this.beautifyCommandName(commandName).replace(/\|/g, " ");
                     const googleAnalyticsPageData = {
-                        googleAnalyticsDataType: "pageview",
+                        googleAnalyticsDataType: "pageview" /* GoogleAnalyticsDataType.Page */,
                         path: beautifiedCommandName,
                         title: beautifiedCommandName,
                     };
@@ -62,10 +62,11 @@ class CommandsService {
                 const shouldExecuteHooks = !this.$staticConfig.disableCommandHooks &&
                     (command.enableHooks === undefined || command.enableHooks === true);
                 if (shouldExecuteHooks) {
+                    // Handle correctly hierarchical commands
                     const hierarchicalCommandName = this.$injector.buildHierarchicalCommand(commandName, commandArguments);
                     if (hierarchicalCommandName) {
-                        commandName = helpers.stringReplaceAll(hierarchicalCommandName.commandName, "|*", "-");
-                        commandName = helpers.stringReplaceAll(commandName, "|", "-");
+                        commandName = helpers.stringReplaceAll(hierarchicalCommandName.commandName, "|*" /* CommandsDelimiters.DefaultHierarchicalCommand */, "-" /* CommandsDelimiters.HooksCommand */);
+                        commandName = helpers.stringReplaceAll(commandName, "|" /* CommandsDelimiters.HierarchicalCommand */, "-" /* CommandsDelimiters.HooksCommand */);
                     }
                     yield this.$hooksService.executeBeforeHooks(commandName);
                 }
@@ -116,6 +117,7 @@ class CommandsService {
                 yield this.executeCommandAction(commandName, commandArguments, this.executeCommandUnchecked);
             }
             else {
+                // If canExecuteCommand returns false, the command cannot be executed or there's no such command at all.
                 const command = this.$injector.resolveCommand(commandName);
                 if (command) {
                     let commandWithArgs = commandName;
@@ -133,12 +135,15 @@ class CommandsService {
             const command = this.$injector.resolveCommand(commandName);
             const beautifiedName = helpers.stringReplaceAll(commandName, "|", " ");
             if (command) {
+                // Verify command is enabled
                 if (command.isDisabled) {
                     this.$errors.fail("This command is not applicable to your environment.");
                 }
+                // If command wants to handle canExecute logic on its own.
                 if (command.canExecute) {
                     return yield command.canExecute(commandArguments);
                 }
+                // First part of hierarchical commands should be validated in specific way.
                 if (yield this.$injector.isValidHierarchicalCommand(commandName, commandArguments)) {
                     return true;
                 }
@@ -150,8 +155,8 @@ class CommandsService {
             }
             const commandInfo = {
                 inputStrings: [commandName, ...commandArguments],
-                commandDelimiter: "|",
-                defaultCommandDelimiter: "|*",
+                commandDelimiter: "|" /* CommandsDelimiters.HierarchicalCommand */,
+                defaultCommandDelimiter: "|*" /* CommandsDelimiters.DefaultHierarchicalCommand */,
             };
             const extensionData = yield this.$extensibilityService.getExtensionNameWhereCommandIsRegistered(commandInfo);
             if (extensionData) {
@@ -169,11 +174,13 @@ class CommandsService {
         return __awaiter(this, void 0, void 0, function* () {
             const commandArgsHelper = new CommandArgumentsValidationHelper(true, commandArguments);
             if (mandatoryParams.length > 0) {
+                // If command has more mandatory params than the passed ones, we shouldn't execute it
                 if (mandatoryParams.length > commandArguments.length) {
                     const customErrorMessages = _.map(mandatoryParams, (mp) => mp.errorMessage);
                     customErrorMessages.splice(0, 0, "You need to provide all the required parameters.");
                     this.$errors.failWithHelp(customErrorMessages.join(os_1.EOL));
                 }
+                // If we reach here, the commandArguments are at least as much as mandatoryParams. Now we should verify that we have each of them.
                 for (let mandatoryParamIndex = 0; mandatoryParamIndex < mandatoryParams.length; ++mandatoryParamIndex) {
                     const mandatoryParam = mandatoryParams[mandatoryParamIndex];
                     let argument = null;
@@ -202,12 +209,14 @@ class CommandsService {
             if (!commandArgsHelper.isValid) {
                 return false;
             }
+            // Command doesn't have any allowedParameters
             if (!command.allowedParameters || command.allowedParameters.length === 0) {
                 if (commandArguments.length > 0) {
                     this.$errors.failWithHelp("This command doesn't accept parameters.");
                 }
             }
             else {
+                // Exclude mandatory params, we've already checked them
                 const unverifiedAllowedParams = command.allowedParameters.filter((param) => !param.mandatory);
                 for (let remainingArgsIndex = 0; remainingArgsIndex < commandArgsHelper.remainingArguments.length; ++remainingArgsIndex) {
                     const argument = commandArgsHelper.remainingArguments[remainingArgsIndex];
@@ -221,6 +230,7 @@ class CommandsService {
                     }
                     if (parameter) {
                         const index = unverifiedAllowedParams.indexOf(parameter);
+                        // Remove the matched parameter from unverifiedAllowedParams collection, so it will not be used to verify another argument.
                         unverifiedAllowedParams.splice(index, 1);
                     }
                     else {
@@ -266,3 +276,4 @@ class CommandsService {
 }
 exports.CommandsService = CommandsService;
 yok_1.injector.register("commandsService", CommandsService);
+//# sourceMappingURL=commands-service.js.map

package/lib/common/services/help-service.js

@@ -52,6 +52,7 @@ class HelpService {
             this.$logger.trace("Opening help for command '%s'. FileName is '%s'.", commandName, htmlPage);
             this.$fs.ensureDirectoryExists(this.pathToHtmlPages);
             if (!this.tryOpeningSelectedPage(htmlPage)) {
+                // HTML pages may have been skipped on post-install, lets generate them.
                 this.$logger.trace("Required HTML file '%s' is missing. Let's try generating HTML files and see if we'll find it.", htmlPage);
                 yield this.generateHtmlPages();
                 if (!this.tryOpeningSelectedPage(htmlPage)) {
@@ -113,6 +114,11 @@ class HelpService {
             this.$logger.printMarkdown(help);
         });
     }
+    /**
+     * Gets the help content for a specific command that should be shown on the terminal.
+     * @param {string} commandName Name of the command for which to read the help.
+     * @returns {Promise<string>} Help content of the command parsed with all terminal rules applied (stripped content that should be shown only for html help).
+     */
     getCommandLineHelpForCommand(commandData) {
         return __awaiter(this, void 0, void 0, function* () {
             const helpText = yield this.readMdFileForCommand(commandData);
@@ -126,6 +132,7 @@ class HelpService {
             return commandLineHelp;
         });
     }
+    // This method should return Promise in order to generate all html pages simultaneously.
     createHtmlPage(htmlPageGenerationData) {
         return __awaiter(this, void 0, void 0, function* () {
             const { basicHtmlPage, pathToMdFile, pathToMdPages, pathToHtmlPages, extensionName, } = htmlPageGenerationData;
@@ -177,8 +184,8 @@ class HelpService {
             const commandName = commandData.commandName;
             const commandInfo = {
                 inputStrings: [commandName, ...commandData.commandArguments],
-                commandDelimiter: "|",
-                defaultCommandDelimiter: "|*",
+                commandDelimiter: "|" /* CommandsDelimiters.HierarchicalCommand */,
+                defaultCommandDelimiter: "|*" /* CommandsDelimiters.DefaultHierarchicalCommand */,
             };
             const extensionData = yield this.$extensibilityService.getExtensionNameWhereCommandIsRegistered(commandInfo);
             if (extensionData) {
@@ -247,6 +254,7 @@ HelpService.RELATIVE_PATH_TO_INDEX_REGEX = /@RELATIVE_PATH_TO_INDEX@/g;
 HelpService.EXTENSION_NAME_REGEX = /@EXTENSION_NAME@/g;
 HelpService.MARKDOWN_LINK_REGEX = /\[([\w \-\`\<\>\*\:\\]+?)\]\([\s\S]+?\)/g;
 HelpService.SPAN_REGEX = /([\s\S]*?)(?:\r?\n)?<span.*?>([\s\S]*?)<\/span>(?:\r?\n)*/g;
-HelpService.NEW_LINE_REGEX = /<\/?\s*?br\s*?\/?>/g;
+HelpService.NEW_LINE_REGEX = /<\/?\s*?br\s*?\/?>/g; // <br>, <br > <br/> <br />
 exports.HelpService = HelpService;
 yok_1.injector.register("helpService", HelpService);
+//# sourceMappingURL=help-service.js.map

package/lib/common/services/hooks-service.js

@@ -61,6 +61,7 @@ class HooksService {
         }
     }
     static formatHookName(commandName) {
+        // Remove everything after | (including the pipe)
         return commandName.replace(/\|[\s\S]*$/, "");
     }
     executeBeforeHooks(commandName, hookArguments) {
@@ -129,6 +130,11 @@ class HooksService {
                     this.$logger.warn(`${hook.fullPath} will NOT be executed because it has invalid arguments - ${color_1.color.grey(invalidArguments.join(", "))}.`);
                     return;
                 }
+                // HACK for backwards compatibility:
+                // In case $projectData wasn't resolved by the time we got here (most likely we got here without running a command but through a service directly)
+                // then it is probably passed as a hookArg
+                // if that is the case then pass it directly to the hook instead of trying to resolve $projectData via injector
+                // This helps make hooks stateless
                 const projectDataHookArg = hookArguments["hookArgs"] && hookArguments["hookArgs"]["projectData"];
                 if (projectDataHookArg) {
                     hookArguments["projectData"] = hookArguments["$projectData"] = projectDataHookArg;
@@ -146,6 +152,7 @@ class HooksService {
                             this.$logger.warn(err.message || err);
                         }
                         else {
+                            // Print the actual error with its callstack, so it is easy to find out which hooks is causing troubles.
                             this.$logger.error(err);
                             throw err || new Error(`Failed to execute hook: ${hook.fullPath}.`);
                         }
@@ -251,6 +258,7 @@ class HooksService {
                 interpreter = sheBangMatch[1];
             }
             if (interpreter) {
+                // Likewise, make /usr/bin/bash work like "bash".
                 shMatch = interpreter.match(/bin\/((?:ba)?sh)$/);
             }
             if (shMatch) {
@@ -291,6 +299,7 @@ class HooksService {
     }
     validateHookArguments(hookConstructor, hookFullPath) {
         const invalidArguments = [];
+        // We need to annotate the hook in order to have the arguments of the constructor.
         (0, helpers_1.annotate)(hookConstructor);
         _.each(hookConstructor.$inject.args, (argument) => {
             try {
@@ -310,9 +319,13 @@ HooksService.HOOKS_DIRECTORY_NAME = "hooks";
 __decorate([
     (0, decorators_1.memoize)({
         shouldCache() {
+            // only cache if we have hooks directories, the only case to
+            // not have hooks directories is when the project dir is
+            // not set yet, ie. when creating a project.
             return !!this.hooksDirectories.length;
         },
     })
 ], HooksService.prototype, "initialize", null);
 exports.HooksService = HooksService;
 yok_1.injector.register("hooksService", HooksService);
+//# sourceMappingURL=hooks-service.js.map

package/lib/common/services/ios-notification-service.js

@@ -47,3 +47,4 @@ class IOSNotificationService {
 }
 exports.IOSNotificationService = IOSNotificationService;
 yok_1.injector.register("iOSNotificationService", IOSNotificationService);
+//# sourceMappingURL=ios-notification-service.js.map

package/lib/common/services/json-file-settings-service.js

@@ -35,6 +35,8 @@ class JsonFileSettingsService {
                     const dataToReturn = data.modifiedByCacheMechanism ? data.value : data;
                     if (cacheOpts && cacheOpts.cacheTimeout) {
                         if (!data.modifiedByCacheMechanism) {
+                            // If data has no cache, but we want to check the timeout, consider the data as outdated.
+                            // this should be a really rare case
                             return null;
                         }
                         const currentTime = Date.now();
@@ -100,6 +102,8 @@ class JsonFileSettingsService {
             if (!this.$fs.exists(this.jsonSettingsFilePath)) {
                 const unexistingDirs = this.getUnexistingDirectories(this.jsonSettingsFilePath);
                 this.$fs.writeFile(this.jsonSettingsFilePath, null);
+                // when running under 'sudo' we create the <path to home dir>/.local/share/.nativescript-cli dir with root as owner
+                // and other Applications cannot access this directory anymore. (bower/heroku/etc)
                 if (process.env.SUDO_USER) {
                     for (const dir of unexistingDirs) {
                         yield this.$fs.setCurrentUserAsOwner(dir, process.env.SUDO_USER);
@@ -120,6 +124,7 @@ class JsonFileSettingsService {
         const unexistingDirs = [];
         let currentDir = path.join(filePath, "..");
         while (true) {
+            // this directory won't be created.
             if (this.$fs.exists(currentDir)) {
                 break;
             }
@@ -131,3 +136,4 @@ class JsonFileSettingsService {
 }
 exports.JsonFileSettingsService = JsonFileSettingsService;
 yok_1.injector.register("jsonFileSettingsService", JsonFileSettingsService, false);
+//# sourceMappingURL=json-file-settings-service.js.map

package/lib/common/services/lock-service.js

@@ -31,6 +31,7 @@ class LockService {
     }
     get defaultLockParams() {
         const lockParams = {
+            // https://www.npmjs.com/package/retry#retrytimeoutsoptions
             retriesObj: { retries: 13, minTimeout: 100, maxTimeout: 1000, factor: 2 },
             stale: 10 * 1000,
             realpath: false,
@@ -89,6 +90,8 @@ class LockService {
         });
     }
     getPathsForCleanupAction(lockPath) {
+        // The proper-lockfile creates directory with the passed name and `.lock` at the end.
+        // Ensure we will take care of it as well.
         return [lockPath, `${lockPath}.lock`];
     }
     getLockFileSettings(filePath, fileOpts) {
@@ -104,6 +107,7 @@ class LockService {
             fileOpts.retriesObj.retries = fileOpts.retries;
         }
         if (fileOpts.retryWait) {
+            // backwards compatibility
             fileOpts.retriesObj.minTimeout = fileOpts.retriesObj.maxTimeout =
                 fileOpts.retryWait;
         }
@@ -126,4 +130,6 @@ __decorate([
 ], LockService.prototype, "defaultLockFilePath", null);
 exports.LockService = LockService;
 yok_1.injector.register("lockService", LockService);
+// backwards compatibility
 yok_1.injector.register("lockfile", LockService);
+//# sourceMappingURL=lock-service.js.map

package/lib/common/services/message-contract-generator.js

@@ -81,3 +81,4 @@ class MessageContractGenerator {
 }
 exports.MessageContractGenerator = MessageContractGenerator;
 yok_1.injector.register("messageContractGenerator", MessageContractGenerator);
+//# sourceMappingURL=message-contract-generator.js.map

package/lib/common/services/messages-service.js

@@ -75,3 +75,4 @@ class MessagesService {
 }
 exports.MessagesService = MessagesService;
 yok_1.injector.register("messagesService", MessagesService);
+//# sourceMappingURL=messages-service.js.map

package/lib/common/services/micro-templating-service.js

@@ -18,12 +18,16 @@ const _ = require("lodash");
 class MicroTemplateService {
     constructor($injector) {
         this.$injector = $injector;
+        // Injector's dynamicCallRegex doesn't have 'g' option, which we need here.
+        // Use ( ) in order to use $1 to get whole expression later
         this.dynamicCallRegex = new RegExp(util.format("(%s)", this.$injector.dynamicCallRegex.source), "g");
     }
     parseContent(data, options) {
         return __awaiter(this, void 0, void 0, function* () {
             const localVariables = this.getLocalVariables(options);
             const compiledTemplate = _.template(data.replace(this.dynamicCallRegex, 'this.$injector.getDynamicCallData("$1")'));
+            // When debugging parsing, uncomment the line below:
+            // console.log(compiledTemplate.source);
             return yield compiledTemplate.apply(this, [localVariables]);
         });
     }
@@ -33,6 +37,7 @@ class MicroTemplateService {
     }
     getLocalVariables(options) {
         const isHtml = options.isHtml;
+        // in html help we want to show all help. Only CONSOLE specific help(wrapped in if(isConsole) ) must be omitted
         const localVariables = {
             constants,
         };
@@ -47,3 +52,4 @@ class MicroTemplateService {
 }
 exports.MicroTemplateService = MicroTemplateService;
 yok_1.injector.register("microTemplateService", MicroTemplateService);
+//# sourceMappingURL=micro-templating-service.js.map

package/lib/common/services/net-service.js

@@ -24,6 +24,7 @@ class Net {
     getFreePort() {
         return __awaiter(this, void 0, void 0, function* () {
             const server = net.createServer((sock) => {
+                /* empty - noone will connect here */
             });
             return new Promise((resolve, reject) => {
                 let isResolved = false;
@@ -57,6 +58,7 @@ class Net {
                 });
                 server.once("close", () => {
                     if (!isResolved) {
+                        // "close" will be emitted right after "error"
                         isResolved = true;
                         resolve(true);
                     }
@@ -135,3 +137,4 @@ class Net {
 Net.DEFAULT_INTERVAL = 1000;
 exports.Net = Net;
 yok_1.injector.register("net", Net);
+//# sourceMappingURL=net-service.js.map

package/lib/common/services/project-files-manager.js

@@ -66,6 +66,7 @@ class ProjectFilesManager {
         this.processPlatformSpecificFilesCore(platform, files, projectFilesConfig);
     }
     processPlatformSpecificFilesCore(platform, files, projectFilesConfig) {
+        // Renames the files that have `platform` as substring and removes the files from other platform
         _.each(files, (filePath) => {
             const projectFileInfo = this.$projectFilesProvider.getProjectFileInfo(filePath, platform, projectFilesConfig);
             if (!projectFileInfo.shouldIncludeFile) {
@@ -73,6 +74,7 @@ class ProjectFilesManager {
             }
             else if (projectFileInfo.onDeviceFileName) {
                 const onDeviceFilePath = path.join(path.dirname(filePath), projectFileInfo.onDeviceFileName);
+                // Fix .js.map entries
                 const extension = path.extname(projectFileInfo.onDeviceFileName);
                 if (onDeviceFilePath !== filePath) {
                     if (extension === ".js" || extension === ".map") {
@@ -86,6 +88,8 @@ class ProjectFilesManager {
                         fileContent = fileContent.replace(new RegExp(oldName, "g"), newName);
                         this.$fs.writeFile(filePath, fileContent);
                     }
+                    // Rename the file
+                    // this.$fs.rename is not called as it is error prone on some systems with slower hard drives and rigorous antivirus software
                     this.$fs.writeFile(onDeviceFilePath, this.$fs.readText(filePath));
                     this.$fs.deleteFile(filePath);
                 }
@@ -98,3 +102,4 @@ class ProjectFilesManager {
 }
 exports.ProjectFilesManager = ProjectFilesManager;
 yok_1.injector.register("projectFilesManager", ProjectFilesManager);
+//# sourceMappingURL=project-files-manager.js.map

package/lib/common/services/project-files-provider-base.js

@@ -52,3 +52,4 @@ class ProjectFilesProviderBase {
     }
 }
 exports.ProjectFilesProviderBase = ProjectFilesProviderBase;
+//# sourceMappingURL=project-files-provider-base.js.map

package/lib/common/services/proxy-service.js

@@ -62,3 +62,4 @@ class ProxyService {
 }
 exports.ProxyService = ProxyService;
 yok_1.injector.register("proxyService", ProxyService);
+//# sourceMappingURL=proxy-service.js.map

package/lib/common/services/qr.js

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

package/lib/common/services/settings-service.js

@@ -40,3 +40,4 @@ __decorate([
 ], SettingsService.prototype, "setSettings", null);
 exports.SettingsService = SettingsService;
 yok_1.injector.register("settingsService", SettingsService);
+//# sourceMappingURL=settings-service.js.map

package/lib/common/services/xcode-select-service.js

@@ -60,3 +60,4 @@ __decorate([
 ], XcodeSelectService.prototype, "getXcodeVersion", null);
 exports.XcodeSelectService = XcodeSelectService;
 yok_1.injector.register("xcodeSelectService", XcodeSelectService);
+//# sourceMappingURL=xcode-select-service.js.map

package/lib/common/utils.js

@@ -36,3 +36,4 @@ function capitalizeFirstLetter(value) {
 }
 exports.capitalizeFirstLetter = capitalizeFirstLetter;
 yok_1.injector.register("utils", Utils);
+//# sourceMappingURL=utils.js.map

package/lib/common/validators/project-name-validator.js

@@ -86,3 +86,4 @@ ProjectNameValidator.INVALID_FILENAMES = [
 ProjectNameValidator.INVALID_EXTENSIONS = [];
 exports.ProjectNameValidator = ProjectNameValidator;
 yok_1.injector.register("projectNameValidator", ProjectNameValidator);
+//# sourceMappingURL=project-name-validator.js.map

package/lib/common/validators/validation-result.js

@@ -14,3 +14,4 @@ class ValidationResult {
 }
 ValidationResult.Successful = new ValidationResult(null);
 exports.ValidationResult = ValidationResult;
+//# sourceMappingURL=validation-result.js.map