nativescript 8.7.0-rc.0 → 8.7.0-rc.2

package/lib/android-tools-info.js

@@ -84,6 +84,8 @@ class AndroidToolsInfo {
                 return doctor_1.androidToolsInfo.getPathToAdbFromAndroidHome();
             }
             catch (err) {
+                // adb does not exist, so ANDROID_HOME is not set correctly
+                // try getting default adb path (included in CLI package)
                 this.$logger.trace(`Error while executing '${path.join(doctor_1.androidToolsInfo.androidHome, "platform-tools", "adb")} help'. Error is: ${err.message}`);
             }
             return null;
@@ -98,6 +100,14 @@ class AndroidToolsInfo {
     shouldGenerateTypings() {
         return this.$options.androidTypings;
     }
+    /**
+     * Prints messages on the screen. In case the showWarningsAsErrors flag is set to true, warnings are shown, else - errors.
+     * Uses logger.warn for warnings and errors.failWithoutHelp when erros must be shown.
+     * In case additional details must be shown as info message, use the second parameter.
+     * NOTE: The additional information will not be printed when showWarningsAsErrors flag is set.
+     * @param  {string} msg The message that will be shown as warning or error.
+     * @return {void}
+     */
     printMessage(msg, showWarningsAsErrors) {
         if (showWarningsAsErrors) {
             this.$errors.fail(msg);
@@ -117,6 +127,7 @@ class AndroidToolsInfo {
         }
         return latestCompileSdk;
     }
+    // TODO check if still needed
     getTargetSdk(compileSdk) {
         const targetSdk = this.$options.sdk
             ? parseInt(this.$options.sdk)
@@ -133,3 +144,4 @@ __decorate([
 ], AndroidToolsInfo.prototype, "validateAndroidHomeEnvVariable", null);
 exports.AndroidToolsInfo = AndroidToolsInfo;
 yok_1.injector.register("androidToolsInfo", AndroidToolsInfo);
+//# sourceMappingURL=android-tools-info.js.map

package/lib/base-package-manager.js

@@ -28,6 +28,8 @@ class BasePackageManager {
             }
             try {
                 const viewResult = yield this.view(packageName, { name: true });
+                // `npm view nonExistingPackageName` will return `nativescript`
+                // if executed in the root dir of the CLI (npm 6.4.1)
                 const packageNameRegex = new RegExp(packageName, "i");
                 const isProperResult = packageNameRegex.test(viewResult);
                 return isProperResult;
@@ -39,6 +41,8 @@ class BasePackageManager {
     }
     getPackageNameParts(fullPackageName) {
         return __awaiter(this, void 0, void 0, function* () {
+            // support <reserved_name>@<version> syntax, for example typescript@1.0.0
+            // support <scoped_package_name>@<version> syntax, for example @nativescript/vue-template@1.0.0
             const lastIndexOfAtSign = fullPackageName.lastIndexOf("@");
             let version = "";
             let templateName = "";
@@ -74,6 +78,8 @@ class BasePackageManager {
                 cwd: opts.cwd,
                 stdio: stdioValue,
             });
+            // Whenever calling "npm install" or "yarn add" without any arguments (hence installing all dependencies) no output is emitted on stdout
+            // Luckily, whenever you call "npm install" or "yarn add" to install all dependencies chances are you won't need the name/version of the package you're installing because there is none.
             const { isInstallingAllDependencies } = opts;
             if (isInstallingAllDependencies) {
                 return null;
@@ -126,3 +132,4 @@ class BasePackageManager {
     }
 }
 exports.BasePackageManager = BasePackageManager;
+//# sourceMappingURL=base-package-manager.js.map

package/lib/bootstrap.js

@@ -5,6 +5,7 @@ require("./common/bootstrap");
 yok_1.injector.requirePublicClass("logger", "./common/logger/logger");
 yok_1.injector.require("config", "./config");
 yok_1.injector.require("options", "./options");
+// note: order above is important!
 yok_1.injector.requirePublicClass("constants", "./constants-provider");
 yok_1.injector.require("projectData", "./project-data");
 yok_1.injector.requirePublic("projectDataService", "./services/project-data-service");
@@ -90,12 +91,16 @@ yok_1.injector.requireCommand("fonts", "./commands/fonts");
 yok_1.injector.requireCommand("prepare", "./commands/prepare");
 yok_1.injector.requireCommand("build|ios", "./commands/build");
 yok_1.injector.requireCommand("build|android", "./commands/build");
+yok_1.injector.requireCommand("build|vision", "./commands/build");
+yok_1.injector.requireCommand("build|visionos", "./commands/build");
 yok_1.injector.requireCommand("deploy", "./commands/deploy");
 yok_1.injector.require("testExecutionService", "./services/test-execution-service");
 yok_1.injector.requireCommand("dev-test|android", "./commands/test");
 yok_1.injector.requireCommand("dev-test|ios", "./commands/test");
 yok_1.injector.requireCommand("test|android", "./commands/test");
 yok_1.injector.requireCommand("test|ios", "./commands/test");
+// injector.requireCommand("test|vision", "./commands/test");
+// injector.requireCommand("test|visionos", "./commands/test");
 yok_1.injector.requireCommand("test|init", "./commands/test-init");
 yok_1.injector.requireCommand("dev-generate-help", "./commands/generate-help");
 yok_1.injector.requireCommand("appstore|*list", "./commands/appstore-list");
@@ -145,7 +150,7 @@ yok_1.injector.require("LiveSyncSocket", "./services/livesync/livesync-socket");
 yok_1.injector.requirePublicClass("androidLivesyncTool", "./services/livesync/android-livesync-tool");
 yok_1.injector.require("androidLiveSyncService", "./services/livesync/android-livesync-service");
 yok_1.injector.require("iOSLiveSyncService", "./services/livesync/ios-livesync-service");
-yok_1.injector.require("usbLiveSyncService", "./services/livesync/livesync-service");
+yok_1.injector.require("usbLiveSyncService", "./services/livesync/livesync-service"); // The name is used in https://github.com/NativeScript/nativescript-dev-typescript
 yok_1.injector.requirePublic("sysInfo", "./sys-info");
 yok_1.injector.require("iOSNotificationService", "./services/ios-notification-service");
 yok_1.injector.require("appDebugSocketProxyFactory", "./device-sockets/ios/app-debug-socket-proxy-factory");
@@ -198,3 +203,4 @@ yok_1.injector.require("keyCommandHelper", "./helpers/key-command-helper");
 yok_1.injector.requireCommand("start", "./commands/start");
 yok_1.injector.require("startService", "./services/start-service");
 require("./key-commands/bootstrap");
+//# sourceMappingURL=bootstrap.js.map

package/lib/color.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.color = exports.stripColors = void 0;
+// using chalk as some of our other dependencies are already using it...
+// exporting from here so we can easily refactor to a different color library if needed
 const ansi = require("ansi-colors");
 const chalk = require("chalk");
 function stripColors(formatStr) {
@@ -8,3 +10,4 @@ function stripColors(formatStr) {
 }
 exports.stripColors = stripColors;
 exports.color = chalk;
+//# sourceMappingURL=color.js.map

package/lib/commands/add-platform.js

@@ -47,3 +47,4 @@ class AddPlatformCommand extends command_base_1.ValidatePlatformCommandBase {
 }
 exports.AddPlatformCommand = AddPlatformCommand;
 yok_1.injector.registerCommand("platform|add", AddPlatformCommand);
+//# sourceMappingURL=add-platform.js.map

package/lib/commands/apple-login.js

@@ -50,3 +50,4 @@ class AppleLogin {
 }
 exports.AppleLogin = AppleLogin;
 yok_1.injector.registerCommand("apple-login", AppleLogin);
+//# sourceMappingURL=apple-login.js.map

package/lib/commands/appstore-list.js

@@ -73,3 +73,4 @@ class ListiOSApps {
 }
 exports.ListiOSApps = ListiOSApps;
 yok_1.injector.registerCommand("appstore|*list", ListiOSApps);
+//# sourceMappingURL=appstore-list.js.map

package/lib/commands/appstore-upload.js

@@ -63,9 +63,12 @@ class PublishIOS {
             this.$options.release = true;
             if (!ipaFilePath) {
                 const platform = this.$devicePlatformsConstants.iOS.toLowerCase();
+                // No .ipa path provided, build .ipa on out own.
                 if (mobileProvisionIdentifier) {
+                    // This is not very correct as if we build multiple targets we will try to sign all of them using the signing identity here.
                     this.$logger.info("Building .ipa with the selected mobile provision and/or certificate. " +
                         mobileProvisionIdentifier);
+                    // As we need to build the package for device
                     this.$options.forDevice = true;
                     this.$options.provision = mobileProvisionIdentifier;
                     const buildData = new build_data_1.IOSBuildData(this.$projectData.projectDir, platform, Object.assign(Object.assign({}, this.$options.argv), { watch: false }));
@@ -104,3 +107,4 @@ class PublishIOS {
 }
 exports.PublishIOS = PublishIOS;
 yok_1.injector.registerCommand(["publish|ios", "appstore|upload"], PublishIOS);
+//# sourceMappingURL=appstore-upload.js.map

package/lib/commands/build.js

@@ -9,7 +9,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BuildAndroidCommand = exports.BuildIosCommand = exports.BuildCommandBase = void 0;
+exports.BuildVisionOsCommand = exports.BuildAndroidCommand = exports.BuildIosCommand = exports.BuildCommandBase = void 0;
 const constants_1 = require("../constants");
 const command_base_1 = require("./command-base");
 const helpers_1 = require("../common/helpers");
@@ -24,11 +24,11 @@ class BuildCommandBase extends command_base_1.ValidatePlatformCommandBase {
         this.$logger = $logger;
         this.dashedOptions = {
             watch: {
-                type: "boolean",
+                type: "boolean" /* OptionType.Boolean */,
                 default: false,
                 hasSensitiveValue: false,
             },
-            hmr: { type: "boolean", default: false, hasSensitiveValue: false },
+            hmr: { type: "boolean" /* OptionType.Boolean */, default: false, hasSensitiveValue: false },
         };
         this.$projectData.initializeProjectData();
     }
@@ -143,3 +143,20 @@ class BuildAndroidCommand extends BuildCommandBase {
 }
 exports.BuildAndroidCommand = BuildAndroidCommand;
 yok_1.injector.registerCommand("build|android", BuildAndroidCommand);
+class BuildVisionOsCommand extends BuildIosCommand {
+    constructor($options, $errors, $projectData, $platformsDataService, $devicePlatformsConstants, $buildController, $platformValidationService, $logger, $buildDataService, $migrateController) {
+        super($options, $errors, $projectData, $platformsDataService, $devicePlatformsConstants, $buildController, $platformValidationService, $logger, $buildDataService, $migrateController);
+        this.$options = $options;
+        this.$migrateController = $migrateController;
+    }
+    canExecute(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.$errors.fail('Building for "visionOS" platform is not supported via the CLI. Please open the project in Xcode and build it from there.');
+            return false;
+        });
+    }
+}
+exports.BuildVisionOsCommand = BuildVisionOsCommand;
+yok_1.injector.registerCommand("build|vision", BuildVisionOsCommand);
+yok_1.injector.registerCommand("build|visionos", BuildVisionOsCommand);
+//# sourceMappingURL=build.js.map

package/lib/commands/clean.js

@@ -26,6 +26,18 @@ function bytesToHumanReadable(bytes) {
     }
     return `${bytes.toFixed(2)} ${units[unit]}`;
 }
+/**
+ * A helper function to map an array of values to promises with a concurrency limit.
+ * The mapper function should return a promise. It will be called for each value in the values array.
+ * The concurrency limit is the number of promises that can be running at the same time.
+ *
+ * This function will return a promise that resolves when all values have been mapped.
+ *
+ * @param values A static array of values to map to promises
+ * @param mapper	A function that maps a value to a promise
+ * @param concurrency The number of promises that can be running at the same time
+ * @returns Promise<void>
+ */
 function promiseMap(values, mapper, concurrency = 10) {
     let index = 0;
     let pending = 0;
@@ -84,6 +96,7 @@ class CleanCommand {
             try {
                 const overridePathsToClean = this.$projectConfigService.getValue("cli.pathsToClean");
                 const additionalPaths = this.$projectConfigService.getValue("cli.additionalPathsToClean");
+                // allow overriding default paths to clean
                 if (Array.isArray(overridePathsToClean)) {
                     pathsToClean = overridePathsToClean;
                 }
@@ -92,6 +105,7 @@ class CleanCommand {
                 }
             }
             catch (err) {
+                // ignore
             }
             const res = yield this.$projectCleanupService.clean(pathsToClean, {
                 dryRun: isDryRun,
@@ -117,6 +131,7 @@ class CleanCommand {
     cleanMultipleProjects(spinner) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!(0, helpers_1.isInteractive)() || this.$options.json) {
+                // interactive terminal is required, and we can't output json in an interactive command.
                 this.$logger.warn("No project found in the current directory.");
                 return;
             }
@@ -132,6 +147,7 @@ class CleanCommand {
                 const current = color_1.color.grey(`${computed}/${paths.length}`);
                 spinner.start(`Gathering cleanable sizes. This may take a while... ${current}`);
             };
+            // update the progress initially
             updateProgress();
             const projects = new Map();
             yield promiseMap(paths, (p) => {
@@ -149,8 +165,10 @@ class CleanCommand {
                 })
                     .then((size) => {
                     if (size > 0 || size === -1) {
+                        // only store size if it's larger than 0 or -1 (error while getting size)
                         projects.set(p, size);
                     }
+                    // update the progress after each processed project
                     computed++;
                     updateProgress();
                 });
@@ -175,7 +193,7 @@ class CleanCommand {
                     value: p,
                 };
             }), true, {
-                optionsPerPage: process.stdout.rows - 6,
+                optionsPerPage: process.stdout.rows - 6, // 6 lines are taken up by the instructions
             });
             this.$logger.clearScreen();
             spinner.warn(`This will run "${color_1.color.yellow(`ns clean`)}" in all the selected projects and ${color_1.color.red.bold("delete files from your system")}!`);
@@ -224,6 +242,7 @@ class CleanCommand {
             let nsDirs = [];
             const getFiles = (dir) => __awaiter(this, void 0, void 0, function* () {
                 if (dir.includes("node_modules")) {
+                    // skip traversing node_modules
                     return;
                 }
                 const dirents = yield (0, promises_1.readdir)(dir, { withFileTypes: true }).catch((err) => {
@@ -234,6 +253,7 @@ class CleanCommand {
                     ent.name.includes("nativescript.config.js"));
                 if (hasNSConfig) {
                     nsDirs.push(dir);
+                    // found a NativeScript project, stop traversing
                     return;
                 }
                 yield Promise.all(dirents.map((dirent) => {
@@ -250,3 +270,4 @@ class CleanCommand {
 }
 exports.CleanCommand = CleanCommand;
 yok_1.injector.registerCommand("clean", CleanCommand);
+//# sourceMappingURL=clean.js.map

package/lib/commands/command-base.js

@@ -44,3 +44,4 @@ class ValidatePlatformCommandBase {
     }
 }
 exports.ValidatePlatformCommandBase = ValidatePlatformCommandBase;
+//# sourceMappingURL=command-base.js.map

package/lib/commands/config.js

@@ -61,6 +61,7 @@ class ConfigGetCommand {
                 this.$logger.info(current);
             }
             catch (err) {
+                // ignore
             }
         });
     }
@@ -119,6 +120,7 @@ class ConfigSetCommand {
             return JSON.parse(v);
         }
         catch (e) {
+            // just treat it as a string
             return `${v}`;
         }
     }
@@ -127,3 +129,4 @@ exports.ConfigSetCommand = ConfigSetCommand;
 yok_1.injector.registerCommand("config|*list", ConfigListCommand);
 yok_1.injector.registerCommand("config|get", ConfigGetCommand);
 yok_1.injector.registerCommand("config|set", ConfigSetCommand);
+//# sourceMappingURL=config.js.map

package/lib/commands/create-project.js

@@ -44,19 +44,43 @@ class CreateProjectCommand {
             }
             let projectName = args[0];
             let selectedTemplate;
-            if (this.$options.js) {
-                selectedTemplate = constants.JAVASCRIPT_NAME;
+            if (this.$options["vision-ng"] ||
+                (this.$options.vision && this.$options.ng)) {
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-ng"];
+            }
+            else if (this.$options["vision-react"] ||
+                (this.$options.vision && this.$options.react)) {
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-react"];
+            }
+            else if (this.$options["vision-solid"]) {
+                // note: we don't have solid templates or --solid
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-solid"];
             }
-            else if (this.$options.vue && this.$options.tsc) {
+            else if (this.$options["vision-svelte"] ||
+                (this.$options.vision && this.$options.svelte)) {
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-svelte"];
+            }
+            else if (this.$options["vision-vue"] ||
+                (this.$options.vision && (this.$options.vue || this.$options.vuejs))) {
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-vue"];
+            }
+            else if ((this.$options.vue || this.$options.vuejs) &&
+                this.$options.tsc) {
                 selectedTemplate = "@nativescript/template-blank-vue-ts";
             }
+            else if (this.$options.vision) {
+                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision"];
+            }
+            else if (this.$options.js) {
+                selectedTemplate = constants.JAVASCRIPT_NAME;
+            }
             else if (this.$options.tsc) {
                 selectedTemplate = constants.TYPESCRIPT_NAME;
             }
             else if (this.$options.ng) {
                 selectedTemplate = constants.ANGULAR_NAME;
             }
-            else if (this.$options.vue) {
+            else if (this.$options.vue || this.$options.vuejs) {
                 selectedTemplate = constants.VUE_NAME;
             }
             else if (this.$options.react) {
@@ -65,21 +89,6 @@ class CreateProjectCommand {
             else if (this.$options.svelte) {
                 selectedTemplate = constants.SVELTE_NAME;
             }
-            else if (this.$options["vision-ng"]) {
-                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-ng"];
-            }
-            else if (this.$options["vision-react"]) {
-                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-react"];
-            }
-            else if (this.$options["vision-solid"]) {
-                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-solid"];
-            }
-            else if (this.$options["vision-svelte"]) {
-                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-svelte"];
-            }
-            else if (this.$options["vision-vue"]) {
-                selectedTemplate = constants.RESERVED_TEMPLATE_NAMES["vision-vue"];
-            }
             else {
                 selectedTemplate = this.$options.template;
             }
@@ -102,6 +111,7 @@ class CreateProjectCommand {
                 template: selectedTemplate,
                 appId: this.$options.appid,
                 pathToProject: this.$options.path,
+                // its already validated above
                 force: true,
                 ignoreScripts: this.$options.ignoreScripts,
             });
@@ -376,6 +386,10 @@ can skip this prompt next time using the --template option, or the --ng, --react
                 `For more options consult the docs or run ${color_1.color.green("ns --help")}`,
                 "",
             ].join("\n"));
+            // todo: add back ns preview
+            // this.$logger.printMarkdown(
+            // 	`After that you can preview it on device by executing \`$ ns preview\``
+            // );
         });
     }
 }
@@ -393,3 +407,4 @@ CreateProjectCommand.TabsTemplateKey = "Tabs";
 CreateProjectCommand.TabsTemplateDescription = "An app with pre-built pages that uses tabs for navigation";
 exports.CreateProjectCommand = CreateProjectCommand;
 yok_1.injector.registerCommand("create", CreateProjectCommand);
+//# sourceMappingURL=create-project.js.map

package/lib/commands/debug.js

@@ -106,6 +106,10 @@ class DebugIOSCommand {
         this.allowedParameters = [];
         this.platform = this.$devicePlatformsConstants.iOS;
         this.$projectData.initializeProjectData();
+        // Do not dispose ios-device-lib, so the process will remain alive and the debug application (NativeScript Inspector or Chrome DevTools) will be able to connect to the socket.
+        // In case we dispose ios-device-lib, the socket will be closed and the code will fail when the debug application tries to read/send data to device socket.
+        // That's why the `$ tns debug ios --justlaunch` command will not release the terminal.
+        // In case we do not set it to false, the dispose will be called once the command finishes its execution, which will prevent the debugging.
         $iosDeviceOperations.setShouldDispose(false);
         $iOSSimulatorLogProvider.setShouldDispose(false);
     }
@@ -124,7 +128,7 @@ class DebugIOSCommand {
             if (this.$options.inspector) {
                 const macOSWarning = yield this.$sysInfo.getMacOSWarningMessage();
                 if (macOSWarning &&
-                    macOSWarning.severity === "high") {
+                    macOSWarning.severity === "high" /* SystemWarningsSeverity.high */) {
                     this.$errors.fail(`You cannot use NativeScript Inspector on this OS. To use it, please update your OS.`);
                 }
             }
@@ -189,3 +193,4 @@ __decorate([
 ], DebugAndroidCommand.prototype, "debugPlatformCommand", null);
 exports.DebugAndroidCommand = DebugAndroidCommand;
 yok_1.injector.registerCommand("debug|android", DebugAndroidCommand);
+//# sourceMappingURL=debug.js.map

package/lib/commands/deploy.js

@@ -25,11 +25,11 @@ class DeployOnDeviceCommand extends command_base_1.ValidatePlatformCommandBase {
         this.allowedParameters = [];
         this.dashedOptions = {
             watch: {
-                type: "boolean",
+                type: "boolean" /* OptionType.Boolean */,
                 default: false,
                 hasSensitiveValue: false,
             },
-            hmr: { type: "boolean", default: false, hasSensitiveValue: false },
+            hmr: { type: "boolean" /* OptionType.Boolean */, default: false, hasSensitiveValue: false },
         };
         this.$projectData.initializeProjectData();
     }
@@ -76,3 +76,4 @@ class DeployOnDeviceCommand extends command_base_1.ValidatePlatformCommandBase {
 }
 exports.DeployOnDeviceCommand = DeployOnDeviceCommand;
 yok_1.injector.registerCommand("deploy", DeployOnDeviceCommand);
+//# sourceMappingURL=deploy.js.map

package/lib/commands/extensibility/install-extension.js

@@ -31,3 +31,4 @@ class InstallExtensionCommand {
 }
 exports.InstallExtensionCommand = InstallExtensionCommand;
 yok_1.injector.registerCommand("extension|install", InstallExtensionCommand);
+//# sourceMappingURL=install-extension.js.map

package/lib/commands/extensibility/list-extensions.js

@@ -38,3 +38,4 @@ class ListExtensionsCommand {
 }
 exports.ListExtensionsCommand = ListExtensionsCommand;
 yok_1.injector.registerCommand("extension|*list", ListExtensionsCommand);
+//# sourceMappingURL=list-extensions.js.map

package/lib/commands/extensibility/uninstall-extension.js

@@ -30,3 +30,4 @@ class UninstallExtensionCommand {
 }
 exports.UninstallExtensionCommand = UninstallExtensionCommand;
 yok_1.injector.registerCommand("extension|uninstall", UninstallExtensionCommand);
+//# sourceMappingURL=uninstall-extension.js.map

package/lib/commands/fonts.js

@@ -62,3 +62,4 @@ class FontsCommand {
 }
 exports.FontsCommand = FontsCommand;
 yok_1.injector.registerCommand("fonts", FontsCommand);
+//# sourceMappingURL=fonts.js.map

package/lib/commands/generate-assets.js

@@ -69,3 +69,4 @@ class GenerateSplashScreensCommand extends GenerateCommandBase {
 }
 exports.GenerateSplashScreensCommand = GenerateSplashScreensCommand;
 yok_1.injector.registerCommand("resources|generate|splashes", GenerateSplashScreensCommand);
+//# sourceMappingURL=generate-assets.js.map

package/lib/commands/generate-help.js

@@ -24,3 +24,4 @@ class GenerateHelpCommand {
 }
 exports.GenerateHelpCommand = GenerateHelpCommand;
 yok_1.injector.registerCommand("dev-generate-help", GenerateHelpCommand);
+//# sourceMappingURL=generate-help.js.map

package/lib/commands/generate.js

@@ -58,16 +58,25 @@ class GenerateCommand {
     }
 }
 exports.GenerateCommand = GenerateCommand;
+/**
+ * Converts an array of command line arguments to options for the executed schematic.
+ * @param rawArgs The command line arguments. They should be in the format 'key=value' for strings or 'key' for booleans.
+ */
 function parseSchematicSettings(rawArgs) {
     const [optionStrings, args] = partition(rawArgs, (item) => item.includes("="));
     const options = optionStrings
-        .map((o) => o.split("="))
-        .map(([key, ...value]) => [key, value.join("=")])
+        .map((o) => o.split("=")) // split to key and value pairs
+        .map(([key, ...value]) => [key, value.join("=")]) // concat the value arrays if there are multiple = signs
         .reduce((obj, [key, value]) => {
         return Object.assign(Object.assign({}, obj), { [key]: value });
     }, {});
     return { options, args };
 }
+/**
+ * Splits an array into two groups based on a predicate.
+ * @param array The array to split.
+ * @param predicate The condition to be used for splitting.
+ */
 function partition(array, predicate) {
     return array.reduce(([pass, fail], item) => {
         return predicate(item)
@@ -76,3 +85,4 @@ function partition(array, predicate) {
     }, [[], []]);
 }
 yok_1.injector.registerCommand("generate", GenerateCommand);
+//# sourceMappingURL=generate.js.map

package/lib/commands/info.js

@@ -24,3 +24,4 @@ class InfoCommand {
 }
 exports.InfoCommand = InfoCommand;
 yok_1.injector.registerCommand("info", InfoCommand);
+//# sourceMappingURL=info.js.map

package/lib/commands/install.js

@@ -78,3 +78,4 @@ class InstallCommand {
 }
 exports.InstallCommand = InstallCommand;
 yok_1.injector.registerCommand("install", InstallCommand);
+//# sourceMappingURL=install.js.map

package/lib/commands/list-platforms.js

@@ -43,3 +43,4 @@ class ListPlatformsCommand {
 }
 exports.ListPlatformsCommand = ListPlatformsCommand;
 yok_1.injector.registerCommand("platform|*list", ListPlatformsCommand);
+//# sourceMappingURL=list-platforms.js.map

package/lib/commands/migrate.js

@@ -42,3 +42,4 @@ class MigrateCommand {
 }
 exports.MigrateCommand = MigrateCommand;
 yok_1.injector.registerCommand("migrate", MigrateCommand);
+//# sourceMappingURL=migrate.js.map

package/lib/commands/platform-clean.js

@@ -52,3 +52,4 @@ class CleanCommand {
 }
 exports.CleanCommand = CleanCommand;
 yok_1.injector.registerCommand("platform|clean", CleanCommand);
+//# sourceMappingURL=platform-clean.js.map

package/lib/commands/plugin/add-plugin.js

@@ -41,3 +41,4 @@ class AddPluginCommand {
 }
 exports.AddPluginCommand = AddPluginCommand;
 yok_1.injector.registerCommand(["plugin|add", "plugin|install"], AddPluginCommand);
+//# sourceMappingURL=add-plugin.js.map

package/lib/commands/plugin/build-plugin.js

@@ -66,3 +66,4 @@ class BuildPluginCommand {
 }
 exports.BuildPluginCommand = BuildPluginCommand;
 yok_1.injector.registerCommand("plugin|build", BuildPluginCommand);
+//# sourceMappingURL=build-plugin.js.map

package/lib/commands/plugin/create-plugin.js

@@ -38,12 +38,14 @@ class CreatePluginCommand {
             const selectedTemplate = this.$options.template;
             const selectedPath = path.resolve(pathToProject || ".");
             const projectDir = path.join(selectedPath, pluginRepoName);
+            // Must be out of try catch block, because will throw error if folder alredy exists and we don't want to delete it.
             this.ensurePackageDir(projectDir);
             try {
                 yield this.downloadPackage(selectedTemplate, projectDir);
                 yield this.setupSeed(projectDir, pluginRepoName);
             }
             catch (err) {
+                // The call to this.ensurePackageDir() above will throw error if folder alredy exists, so it is safe to delete here.
                 this.$fs.deleteDirectory(projectDir);
                 throw err;
             }
@@ -83,6 +85,7 @@ class CreatePluginCommand {
                     !config.includeTypeScriptDemo)) {
                 this.$logger.printMarkdown("Using default values for plugin creation options since your shell is not interactive.");
             }
+            // run postclone script manually and kill it if it takes more than 10 sec
             const pathToPostCloneScript = path.join("scripts", "postclone");
             const params = [
                 pathToPostCloneScript,
@@ -143,6 +146,7 @@ class CreatePluginCommand {
     getPluginNameSource(pluginNameSource, pluginRepoName) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!pluginNameSource) {
+                // remove nativescript- prefix for naming plugin files
                 const prefix = "nativescript-";
                 pluginNameSource = pluginRepoName.toLowerCase().startsWith(prefix)
                     ? pluginRepoName.slice(prefix.length, pluginRepoName.length)
@@ -173,3 +177,4 @@ class CreatePluginCommand {
 }
 exports.CreatePluginCommand = CreatePluginCommand;
 yok_1.injector.registerCommand(["plugin|create"], CreatePluginCommand);
+//# sourceMappingURL=create-plugin.js.map

package/lib/commands/plugin/list-plugins.js

@@ -52,3 +52,4 @@ class ListPluginsCommand {
 }
 exports.ListPluginsCommand = ListPluginsCommand;
 yok_1.injector.registerCommand("plugin|*list", ListPluginsCommand);
+//# sourceMappingURL=list-plugins.js.map

package/lib/commands/plugin/remove-plugin.js

@@ -33,6 +33,7 @@ class RemovePluginCommand {
             }
             let pluginNames = [];
             try {
+                // try installing the plugins, so we can get information from node_modules about their native code, libs, etc.
                 const installedPlugins = yield this.$pluginsService.getAllInstalledPlugins(this.$projectData);
                 pluginNames = installedPlugins.map((pl) => pl.name);
             }
@@ -50,3 +51,4 @@ class RemovePluginCommand {
 }
 exports.RemovePluginCommand = RemovePluginCommand;
 yok_1.injector.registerCommand("plugin|remove", RemovePluginCommand);
+//# sourceMappingURL=remove-plugin.js.map

package/lib/commands/plugin/update-plugin.js

@@ -50,3 +50,4 @@ class UpdatePluginCommand {
 }
 exports.UpdatePluginCommand = UpdatePluginCommand;
 yok_1.injector.registerCommand("plugin|update", UpdatePluginCommand);
+//# sourceMappingURL=update-plugin.js.map