nativescript 8.8.0 → 8.8.1

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

@@ -1 +1 @@
-{"@jsdevtools/coverage-istanbul-loader":"3.0.5","karma":"6.4.3","karma-coverage":"2.2.1","karma-nativescript-launcher":"0.4.0","mocha":"10.6.0","karma-mocha":"2.0.1","karma-chai":"0.1.0","karma-jasmine":"4.0.2","karma-qunit":"4.2.0","@types/karma-chai":"0.1.6","@types/mocha":"10.0.7","@types/jasmine":"5.1.4","@types/qunit":"2.19.10","nyc":"17.0.0"}
+{"@jsdevtools/coverage-istanbul-loader":"3.0.5","karma":"6.4.4","karma-coverage":"2.2.1","karma-nativescript-launcher":"0.4.0","mocha":"10.7.3","karma-mocha":"2.0.1","karma-chai":"0.1.0","karma-jasmine":"4.0.2","karma-qunit":"4.2.0","@types/karma-chai":"0.1.6","@types/mocha":"10.0.7","@types/jasmine":"5.1.4","@types/qunit":"2.19.10","nyc":"17.0.0"}

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 = "";
@@ -70,11 +74,16 @@ class BasePackageManager {
         return __awaiter(this, void 0, void 0, function* () {
             const npmExecutable = this.getPackageManagerExecutableName();
             const stdioValue = (0, helpers_1.isInteractive)() ? "inherit" : "pipe";
-            yield this.$childProcess.spawnFromEvent(npmExecutable, params, "close", {
+            const sanitizedNpmExecutable = this.$hostInfo.isWindows
+                ? (0, helpers_1.quoteString)(npmExecutable)
+                : npmExecutable;
+            yield this.$childProcess.spawnFromEvent(sanitizedNpmExecutable, params, "close", {
                 cwd: opts.cwd,
                 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;
@@ -127,3 +136,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");
@@ -149,7 +152,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");
@@ -209,3 +212,4 @@ yok_1.injector.requireCommand([
     "native|add|objective-c",
 ], "./commands/native-add");
 require("./key-commands/bootstrap");
+//# sourceMappingURL=bootstrap.js.map

package/lib/bun-package-manager.js

@@ -40,6 +40,9 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             const packageJsonPath = path.join(pathToSave, "package.json");
             const jsonContentBefore = this.$fs.readJson(packageJsonPath);
             const flags = this.getFlagsString(config, true);
+            // TODO: Confirm desired behavior. The npm version uses --legacy-peer-deps
+            // by default, we could use `--no-peer` for Bun if similar is needed; the
+            // pnpm version uses `--shamefully-hoist`, but Bun has no similar flag.
             let params = ["install", "--legacy-peer-deps"];
             const isInstallingAllDependencies = packageName === pathToSave;
             if (!isInstallingAllDependencies) {
@@ -52,6 +55,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;
             }
@@ -65,9 +69,10 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             });
         });
     }
+    // Bun does not have a `view` command; use npm.
     view(packageName, config) {
         return __awaiter(this, void 0, void 0, function* () {
-            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 {
@@ -84,6 +89,7 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
             }
         });
     }
+    // Bun does not have a `search` command; use npm.
     search(filter, config) {
         return __awaiter(this, void 0, void 0, function* () {
             const flags = this.getFlagsString(config, false);
@@ -92,11 +98,20 @@ class BunPackageManager extends base_package_manager_1.BasePackageManager {
     }
     searchNpms(keyword) {
         return __awaiter(this, void 0, void 0, function* () {
+            // 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 = yield 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.
     getRegistryPackageData(packageName) {
         return __awaiter(this, void 0, void 0, function* () {
             const registry = yield this.$childProcess.exec(`npm config get registry`);
@@ -133,3 +148,4 @@ __decorate([
 ], BunPackageManager.prototype, "getCachePath", null);
 exports.BunPackageManager = BunPackageManager;
 yok_1.injector.register("bun", BunPackageManager);
+//# sourceMappingURL=bun-package-manager.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

@@ -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();
     }
@@ -159,3 +159,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

@@ -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

@@ -115,6 +115,7 @@ class CreateProjectCommand {
                 template: selectedTemplate,
                 appId: this.$options.appid,
                 pathToProject: this.$options.path,
+                // its already validated above
                 force: true,
                 ignoreScripts: this.$options.ignoreScripts,
             });
@@ -412,6 +413,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\``
+            // );
         });
     }
 }
@@ -429,3 +434,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/embedding/embed.js

@@ -31,6 +31,7 @@ class EmbedCommand extends prepare_1.PrepareCommand {
     }
     resolveHostProjectPath(hostProjectPath) {
         if (hostProjectPath.charAt(0) === ".") {
+            // resolve relative to the project dir
             const projectDir = this.$projectData.projectDir;
             return (0, path_1.resolve)(projectDir, hostProjectPath);
         }
@@ -63,7 +64,11 @@ class EmbedCommand extends prepare_1.PrepareCommand {
             if (!canSuperExecute) {
                 return false;
             }
+            // args[0] is the platform
+            // args[1] is the path to the host project
+            // args[2] is the host project module name
             const platform = args[0].toLowerCase();
+            // also allow these to be set in the nativescript.config.ts
             if (!args[1]) {
                 const hostProjectPath = this.getEmbedConfigForKey("hostProjectPath", platform);
                 if (hostProjectPath) {
@@ -84,8 +89,10 @@ class EmbedCommand extends prepare_1.PrepareCommand {
         });
     }
     getEmbedConfigForKey(key, platform) {
+        // get the embed.<platform>.<key> value, or fallback to embed.<key> value
         return this.$projectConfigService.getValue(`embed.${platform}.${key}`, this.$projectConfigService.getValue(`embed.${key}`));
     }
 }
 exports.EmbedCommand = EmbedCommand;
 yok_1.injector.registerCommand("embed", EmbedCommand);
+//# sourceMappingURL=embed.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/native-add.js

@@ -194,6 +194,7 @@ class NativeAddObjectiveCCommand extends NativeAddSingleCommand {
         const classFilePath = path.join(iosSourceBase, `${className}.m`);
         const headerFilePath = path.join(iosSourceBase, `${className}.h`);
         if (this.generateObjectiveCFiles(className, classFilePath, headerFilePath)) {
+            // Modify/Generate moduleMap
             this.generateOrUpdateModuleMap(`${className}.h`, path.join(iosSourceBase, "module.modulemap"));
         }
     }
@@ -206,7 +207,9 @@ class NativeAddObjectiveCCommand extends NativeAddSingleCommand {
         }
         const headerDeclaration = `header "${headerPath}"`;
         if (moduleMapContent.includes(`module ${moduleName}`)) {
+            // Module declaration already exists in the module map
             if (moduleMapContent.includes(headerDeclaration)) {
+                // Header is already present in the module map
                 this.$logger.warn(`Header '${headerFileName}' is already added to the module map.`);
                 return;
             }
@@ -214,6 +217,7 @@ class NativeAddObjectiveCCommand extends NativeAddSingleCommand {
             fs.writeFileSync(moduleMapPath, updatedModuleMapContent);
         }
         else {
+            // Module declaration does not exist in the module map
             const moduleDeclaration = `module ${moduleName} {${os_1.EOL}    ${headerDeclaration}${os_1.EOL}    export *${os_1.EOL}}`;
             moduleMapContent += `${os_1.EOL}${os_1.EOL}${moduleDeclaration}`;
             fs.writeFileSync(moduleMapPath, moduleMapContent);
@@ -298,3 +302,4 @@ yok_1.injector.registerCommand(["native|add|java"], NativeAddJavaCommand);
 yok_1.injector.registerCommand(["native|add|kotlin"], NativeAddKotlinCommand);
 yok_1.injector.registerCommand(["native|add|swift"], NativeAddSwiftCommand);
 yok_1.injector.registerCommand(["native|add|objective-c"], NativeAddObjectiveCCommand);
+//# sourceMappingURL=native-add.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