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

package/config/test-deps-versions-generated.json

@@ -3,14 +3,14 @@
   "karma": "6.4.4",
   "karma-coverage": "2.2.1",
   "karma-nativescript-launcher": "1.0.0",
-  "mocha": "11.7.3",
+  "mocha": "11.7.5",
   "karma-mocha": "2.0.1",
   "karma-chai": "0.1.0",
   "karma-jasmine": "4.0.2",
   "karma-qunit": "4.2.1",
   "@types/karma-chai": "0.1.8",
   "@types/mocha": "10.0.10",
-  "@types/jasmine": "5.1.9",
+  "@types/jasmine": "5.1.12",
   "@types/qunit": "2.19.13",
   "nyc": "17.1.0"
 }

package/docs/build-jekyll-md.sh

@@ -4,4 +4,4 @@ set -e
 rm -rf docs-cli
 npm install --ignore-scripts
 
-grunt docs-jekyll
+npx grunt docs-jekyll

package/docs/man_pages/config/config-get.md

@@ -0,0 +1,36 @@
+<% if (isJekyll) { %>---
+title: ns config get
+position: 2
+---<% } %>
+
+# ns config get
+
+### Description
+
+Prints the value for a specific key from the project's NativeScript configuration.
+
+### Commands
+
+Usage | Synopsis
+------|-------
+General | `$ ns config get <key>`
+
+### Arguments
+
+* `<key>` — The configuration key in dot-notation. Examples: `ios.id`, `android.codeCache`, `bundler`.
+
+### Examples
+
+* `$ ns config get ios.id`
+* `$ ns config get android.codeCache`
+* `$ ns config get bundler`
+
+<% if(isHtml) { %>
+
+### Related Commands
+
+Command | Description
+----------|----------
+[config](config.html) | Lists all configuration values for the current project.
+[config set](config-set.html) | Sets the value for the specified configuration key.
+<% } %>

package/docs/man_pages/config/config-set.md

@@ -0,0 +1,40 @@
+<% if (isJekyll) { %>---
+title: ns config set
+position: 3
+---<% } %>
+
+# ns config set
+
+### Description
+
+Sets the value for a specific key in the project's NativeScript configuration.
+
+### Commands
+
+Usage | Synopsis
+------|-------
+General | `$ ns config set <key> <value>`
+
+### Arguments
+
+* `<key>` — The configuration key in dot-notation. Examples: `ios.id`, `android.codeCache`, `bundler`.
+* `<value>` — The value to set. Parsed as JSON when possible (e.g. `true`, `42`, `{ "foo": "bar" }`). Otherwise treated as a string.
+
+### Examples
+
+* `$ ns config set ios.id org.nativescript.myapp`
+* `$ ns config set android.codeCache true`
+* `$ ns config set bundler vite`
+
+### Notes
+
+* Setting whole objects is not supported. Update individual keys instead. For example, use:
+	`$ ns config set android.codeCache true`
+
+### Related Commands
+
+Command | Description
+----------|----------
+[config](config.html) | Lists all configuration values for the current project.
+[config get](config-get.html) | Prints the value for the specified configuration key.
+<% } %>

package/docs/man_pages/config/config.md

@@ -0,0 +1,39 @@
+<% if (isJekyll) { %>---
+title: ns config
+position: 1
+---<% } %>
+
+# ns config
+
+### Description
+
+View and manage your project's NativeScript configuration stored in `nativescript.config.(js|ts)` (or legacy `nsconfig.json`).
+
+### Commands
+
+Usage | Synopsis
+------|---------
+List all config | `$ ns config`
+Get a value | `$ ns config get <key>`
+Set a value | `$ ns config set <key> <value>`
+
+### Examples
+
+* `$ ns config` — prints all configuration values.
+* `$ ns config get ios.id` — prints the iOS bundle identifier.
+* `$ ns config set android.codeCache true` — enables Android V8 code cache.
+
+### Notes
+
+* Keys use dot-notation, for example: `ios.id`, `android.codeCache`, `bundler`.
+* Values are parsed as JSON when possible. Use quotes for strings with spaces.
+
+<% if(isHtml) { %>
+
+### Related Commands
+
+Command | Description
+----------|----------
+[config get](config-get.html) | Prints the value for the specified configuration key.
+[config set](config-set.html) | Sets the value for the specified configuration key.
+<% } %>

package/docs/man_pages/project/hooks/hooks.md

@@ -0,0 +1,35 @@
+<% if (isJekyll) { %>---
+title: ns hooks
+position: 1
+---<% } %>
+
+# ns create
+
+### Description
+
+Manages lifecycle hooks from installed plugins.
+
+### Commands
+
+Usage | Synopsis
+---------|---------
+Install | `$ ns hooks install`
+List | `$ ns hooks list`
+Lock | `$ ns hooks lock`
+Verify | `$ ns hooks verify`
+
+#### Install
+
+Installs hooks from each installed plugin dependency.
+
+#### List
+
+Lists the plugins which have hooks and which scripts they install
+
+#### Lock
+
+Generates a `hooks-lock.json` containing the hooks that are in the current versions of the plugins.
+
+#### Verify
+
+Verifies that the hooks contained in the installed plugins match those listed in the `hooks-lock.json` file.

package/docs/man_pages/start.md

@@ -51,6 +51,7 @@ Command | Description
 [plugin](lib-management/plugin.html) | Lets you manage the plugins for your project.
 [open](project/configuration/open.md) | Opens the native project in Xcode/Android Studio.
 [widget ios](project/configuration/widget.md) | Adds a new iOS widget to the project.
+[hooks](project/hooks/hooks.html) | Installs lifecycle hooks from plugins.  
 ## Publishing Commands
 Command | Description
 ---|---

package/lib/.d.ts

@@ -23,6 +23,9 @@
 /// <reference path="commands/generate-assets.ts" />
 /// <reference path="commands/generate-help.ts" />
 /// <reference path="commands/generate.ts" />
+/// <reference path="commands/hooks/common.ts" />
+/// <reference path="commands/hooks/hooks-lock.ts" />
+/// <reference path="commands/hooks/hooks.ts" />
 /// <reference path="commands/info.ts" />
 /// <reference path="commands/install.ts" />
 /// <reference path="commands/list-platforms.ts" />
@@ -257,6 +260,7 @@
 /// <reference path="definitions/files-hash-service.d.ts" />
 /// <reference path="definitions/gradle.d.ts" />
 /// <reference path="definitions/hmr-status-service.d.ts" />
+/// <reference path="definitions/hooks.d.ts" />
 /// <reference path="definitions/initialize-service.d.ts" />
 /// <reference path="definitions/ios-debugger-port-service.d.ts" />
 /// <reference path="definitions/ios.d.ts" />

package/lib/android-tools-info.js

@@ -74,6 +74,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;
@@ -87,6 +89,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);
@@ -106,6 +116,7 @@ class AndroidToolsInfo {
         }
         return latestCompileSdk;
     }
+    // TODO check if still needed
     getTargetSdk(compileSdk) {
         const targetSdk = this.$options.sdk
             ? parseInt(this.$options.sdk)
@@ -122,3 +133,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], AndroidToolsInfo.prototype, "validateAndroidHomeEnvVariable", null);
 yok_1.injector.register("androidToolsInfo", AndroidToolsInfo);
+//# sourceMappingURL=android-tools-info.js.map

package/lib/base-package-manager.js

@@ -18,6 +18,8 @@ class BasePackageManager {
         }
         try {
             const viewResult = await 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;
@@ -27,6 +29,8 @@ class BasePackageManager {
         }
     }
     async getPackageNameParts(fullPackageName) {
+        // 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 = "";
@@ -59,6 +63,8 @@ class BasePackageManager {
             stdio: stdioValue,
             shell: this.$hostInfo.isWindows,
         });
+        // 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;
@@ -110,3 +116,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");
@@ -99,6 +100,8 @@ 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");
@@ -128,6 +131,8 @@ yok_1.injector.requireCommand("plugin|remove", "./commands/plugin/remove-plugin"
 yok_1.injector.requireCommand("plugin|update", "./commands/plugin/update-plugin");
 yok_1.injector.requireCommand("plugin|build", "./commands/plugin/build-plugin");
 yok_1.injector.requireCommand("plugin|create", "./commands/plugin/create-plugin");
+yok_1.injector.requireCommand(["hooks|*list", "hooks|install"], "./commands/hooks/hooks");
+yok_1.injector.requireCommand(["hooks|lock", "hooks|verify"], "./commands/hooks/hooks-lock");
 yok_1.injector.require("doctorService", "./services/doctor-service");
 yok_1.injector.require("xcprojService", "./services/xcproj-service");
 yok_1.injector.require("versionsService", "./services/versions-service");
@@ -149,7 +154,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");
@@ -210,3 +215,4 @@ yok_1.injector.requireCommand([
 ], "./commands/native-add");
 yok_1.injector.requireCommand(["widget", "widget|ios"], "./commands/widget");
 require("./key-commands/bootstrap");
+//# sourceMappingURL=bootstrap.js.map

package/lib/bun-package-manager.js

@@ -42,6 +42,7 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             return result;
         }
         catch (err) {
+            // Revert package.json contents to preserve valid state
             this.$fs.writeJson(packageJsonPath, jsonContentBefore);
             throw err;
         }
@@ -52,8 +53,9 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             cwd,
         });
     }
+    // Bun does not have a `view` command; use npm.
     async view(packageName, config) {
-        const wrappedConfig = _.extend({}, config, { json: true });
+        const wrappedConfig = _.extend({}, config, { json: true }); // always require view response as JSON
         const flags = this.getFlagsString(wrappedConfig, false);
         let viewResult;
         try {
@@ -69,15 +71,25 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             return null;
         }
     }
+    // Bun does not have a `search` command; use npm.
     async search(filter, config) {
         const flags = this.getFlagsString(config, false);
         return this.$childProcess.exec(`npm search ${filter.join(" ")} ${flags}`);
     }
     async searchNpms(keyword) {
+        // Bugs with npms.io:
+        // 1. API returns no results when a valid package name contains @ or /
+        //    even if using encodeURIComponent().
+        // 2. npms.io's API no longer returns updated results; see
+        //    https://github.com/npms-io/npms-api/issues/112. Better to switch to
+        //    https://registry.npmjs.org/<query>
         const httpRequestResult = await this.$httpClient.httpRequest(`https://api.npms.io/v2/search?q=keywords:${keyword}`);
         const result = JSON.parse(httpRequestResult.body);
         return result;
     }
+    // Bun does not have a command analogous to `npm config get registry`; Bun
+    // uses `bunfig.toml` to define custom registries.
+    // - TODO: read `bunfig.toml`, if it exists, and return the registry URL.
     async getRegistryPackageData(packageName) {
         const registry = await this.$childProcess.exec(`npm config get registry`);
         const url = registry.trim() + packageName;
@@ -110,3 +122,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], BunPackageManager.prototype, "getCachePath", null);
 yok_1.injector.register("bun", BunPackageManager);
+//# sourceMappingURL=bun-package-manager.js.map

package/lib/color.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stripColors = exports.color = void 0;
 const node_util_1 = require("node:util");
+// Create a chalk-like API using the Node.js util.styleText function
 exports.color = {
     reset: (text) => (0, node_util_1.styleText)("reset", text),
     bold: (text) => (0, node_util_1.styleText)("bold", text),
@@ -11,6 +12,7 @@ exports.color = {
     inverse: (text) => (0, node_util_1.styleText)("inverse", text),
     hidden: (text) => (0, node_util_1.styleText)("hidden", text),
     strikethrough: (text) => (0, node_util_1.styleText)("strikethrough", text),
+    // Text colors
     black: (text) => (0, node_util_1.styleText)("black", text),
     red: (text) => (0, node_util_1.styleText)("red", text),
     blue: (text) => (0, node_util_1.styleText)("blue", text),
@@ -21,6 +23,7 @@ exports.color = {
     yellow: (text) => (0, node_util_1.styleText)("yellow", text),
     green: (text) => (0, node_util_1.styleText)("green", text),
     grey: (text) => (0, node_util_1.styleText)("grey", text),
+    // Background colors
     bgBlack: (text) => (0, node_util_1.styleText)("bgBlack", text),
     bgBlackBright: (text) => (0, node_util_1.styleText)("bgBlackBright", text),
     bgRed: (text) => (0, node_util_1.styleText)("bgRed", text),
@@ -39,3 +42,4 @@ exports.color = {
 };
 const stripColors = (text) => (0, node_util_1.stripVTControlCharacters)(text);
 exports.stripColors = stripColors;
+//# sourceMappingURL=color.js.map

package/lib/commands/add-platform.js

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

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

package/lib/commands/appstore-list.js

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

package/lib/commands/appstore-upload.js

@@ -52,7 +52,9 @@ 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);
                 this.$options.provision = mobileProvisionIdentifier;
@@ -88,3 +90,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

@@ -15,11 +15,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();
     }
@@ -127,3 +127,4 @@ class BuildVisionOsCommand extends BuildIosCommand {
 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

@@ -17,6 +17,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;
@@ -73,6 +85,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;
             }
@@ -81,6 +94,7 @@ class CleanCommand {
             }
         }
         catch (err) {
+            // ignore
         }
         const res = await this.$projectCleanupService.clean(pathsToClean, {
             dryRun: isDryRun,
@@ -104,6 +118,7 @@ class CleanCommand {
     }
     async cleanMultipleProjects(spinner) {
         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;
         }
@@ -119,6 +134,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();
         await promiseMap(paths, (p) => {
@@ -136,8 +152,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();
             });
@@ -162,7 +180,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.styleText(["red", "bold"], "delete files from your system")}!`);
@@ -209,6 +227,7 @@ class CleanCommand {
         let nsDirs = [];
         const getFiles = async (dir) => {
             if (dir.includes("node_modules")) {
+                // skip traversing node_modules
                 return;
             }
             const dirents = await (0, promises_1.readdir)(dir, { withFileTypes: true }).catch((err) => {
@@ -219,6 +238,7 @@ class CleanCommand {
                 ent.name.includes("nativescript.config.js"));
             if (hasNSConfig) {
                 nsDirs.push(dir);
+                // found a NativeScript project, stop traversing
                 return;
             }
             await Promise.all(dirents.map((dirent) => {
@@ -234,3 +254,4 @@ class CleanCommand {
 }
 exports.CleanCommand = CleanCommand;
 yok_1.injector.registerCommand("clean", CleanCommand);
+//# sourceMappingURL=clean.js.map

package/lib/commands/command-base.js

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

package/lib/commands/config.js

@@ -25,6 +25,7 @@ class ConfigListCommand {
                 Object.keys(value)
                     .map((key) => {
                     return (color_1.color.green(`${indent()}${key}: `) +
+                        // @ts-ignore
                         this.getValueString(value[key], depth + 1));
                 })
                     .join("\n"));
@@ -49,6 +50,7 @@ class ConfigGetCommand {
             this.$logger.info(current);
         }
         catch (err) {
+            // ignore
         }
     }
     async canExecute(args) {
@@ -75,6 +77,7 @@ class ConfigSetCommand {
         const convertedValue = this.getConvertedValue(value);
         const existingKey = current !== undefined;
         const keyDisplay = color_1.color.green(key);
+        // when current is undefined, return empty string to avoid throw
         const currentDisplay = current ? color_1.color.yellow(current) : "";
         const updatedDisplay = color_1.color.cyan(convertedValue);
         this.$logger.info(`${existingKey ? "Updating" : "Setting"} ${keyDisplay}${existingKey ? ` from ${currentDisplay} ` : " "}to ${updatedDisplay}`);
@@ -100,6 +103,7 @@ class ConfigSetCommand {
             return JSON.parse(v);
         }
         catch (e) {
+            // just treat it as a string
             return `${v}`;
         }
     }
@@ -108,3 +112,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

@@ -105,6 +105,7 @@ class CreateProjectCommand {
             template: selectedTemplate,
             appId: this.$options.appid,
             pathToProject: this.$options.path,
+            // its already validated above
             force: true,
             ignoreScripts: this.$options.ignoreScripts,
         });
@@ -399,6 +400,10 @@ can skip this prompt next time using the --template option, or using --ng, --rea
             `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\``
+        // );
     }
 }
 exports.CreateProjectCommand = CreateProjectCommand;
@@ -415,3 +420,4 @@ CreateProjectCommand.DrawerTemplateDescription = "An app with pre-built pages th
 CreateProjectCommand.TabsTemplateKey = "Tabs";
 CreateProjectCommand.TabsTemplateDescription = "An app with pre-built pages that uses tabs for navigation";
 yok_1.injector.registerCommand("create", CreateProjectCommand);
+//# sourceMappingURL=create-project.js.map

package/lib/commands/debug.js

@@ -90,6 +90,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 `$ ns 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);
     }
@@ -107,7 +111,7 @@ class DebugIOSCommand {
         if (this.$options.inspector) {
             const macOSWarning = await 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.`);
             }
         }
@@ -167,3 +171,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], DebugAndroidCommand.prototype, "debugPlatformCommand", null);
 yok_1.injector.registerCommand("debug|android", DebugAndroidCommand);
+//# sourceMappingURL=debug.js.map

package/lib/commands/deploy.js

@@ -16,11 +16,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();
     }
@@ -60,3 +60,4 @@ class DeployOnDeviceCommand extends command_base_1.ValidatePlatformCommandBase {
 }
 exports.DeployOnDeviceCommand = DeployOnDeviceCommand;
 yok_1.injector.registerCommand("deploy", DeployOnDeviceCommand);
+//# sourceMappingURL=deploy.js.map