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

package/lib/commands/embedding/embed.js

@@ -22,6 +22,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);
         }
@@ -45,7 +46,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) {
@@ -65,8 +70,10 @@ class EmbedCommand extends prepare_1.PrepareCommand {
         return true;
     }
     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

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

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

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

package/lib/commands/fonts.js

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

package/lib/commands/generate-assets.js

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

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

package/lib/commands/generate.js

@@ -3,7 +3,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenerateCommand = void 0;
 const yok_1 = require("../common/yok");
 class GenerateCommand {
-    constructor($logger, $errors) {
+    // private executionOptions: ExecutionOptions;
+    constructor($logger, 
+    // private $options: IOptions,
+    $errors) {
         this.$logger = $logger;
         this.$errors = $errors;
         this.allowedParameters = [];
@@ -11,6 +14,7 @@ class GenerateCommand {
     async execute(_rawArgs) {
         try {
             this.$logger.info("If you have ideas for this command, please discuss at https://nativescript.org/discord");
+            // await run(this.executionOptions);
         }
         catch (error) {
             this.$errors.fail(error.message);
@@ -22,9 +26,52 @@ class GenerateCommand {
         return true;
     }
     validateExecutionOptions() {
+        // if (!this.executionOptions.schematic) {
+        // 	this.$errors.failWithHelp(
+        // 		`The generate command requires a schematic name to be specified.`
+        // 	);
+        // }
     }
     setExecutionOptions(rawArgs) {
+        // const options = this.parseRawArgs(rawArgs);
+        // this.executionOptions = {
+        // 	...options,
+        // 	logger: this.$logger,
+        // 	directory: process.cwd(),
+        // };
     }
 }
 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: string[]) {
+// 	const [optionStrings, args] = partition<string>(rawArgs, (item) =>
+// 		item.includes("=")
+// 	);
+// 	const options = optionStrings
+// 		.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 { ...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<T>(array: T[], predicate: (item: T) => boolean): T[][] {
+// 	return array.reduce(
+// 		([pass, fail], item) => {
+// 			return predicate(item)
+// 				? [[...pass, item], fail]
+// 				: [pass, [...fail, item]];
+// 		},
+// 		[[], []]
+// 	);
+// }
 yok_1.injector.registerCommand("generate", GenerateCommand);
+//# sourceMappingURL=generate.js.map

package/lib/commands/hooks/common.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HooksVerify = exports.LOCK_FILE_NAME = void 0;
+const path = require("path");
+const crypto = require("crypto");
+exports.LOCK_FILE_NAME = "nativescript-lock.json";
+class HooksVerify {
+    constructor($projectData, $errors, $fs, $logger) {
+        this.$projectData = $projectData;
+        this.$errors = $errors;
+        this.$fs = $fs;
+        this.$logger = $logger;
+        this.allowedParameters = [];
+        this.$projectData.initializeProjectData();
+    }
+    async verifyHooksLock(plugins, hooksLockPath) {
+        var _a;
+        let lockFileContent;
+        let hooksLock;
+        try {
+            lockFileContent = this.$fs.readText(hooksLockPath, "utf8");
+            hooksLock = JSON.parse(lockFileContent);
+        }
+        catch (err) {
+            this.$errors.fail(`❌ Failed to read or parse ${exports.LOCK_FILE_NAME} at ${hooksLockPath}`);
+        }
+        const lockMap = new Map(); // pluginName -> hookType -> hash
+        for (const plugin of hooksLock) {
+            const hookMap = new Map();
+            for (const hook of plugin.hooks) {
+                hookMap.set(hook.type, hook.hash);
+            }
+            lockMap.set(plugin.name, hookMap);
+        }
+        let isValid = true;
+        for (const plugin of plugins) {
+            const pluginLockHooks = lockMap.get(plugin.name);
+            if (!pluginLockHooks) {
+                this.$logger.error(`❌ Plugin '${plugin.name}' not found in ${exports.LOCK_FILE_NAME}`);
+                isValid = false;
+                continue;
+            }
+            for (const hook of ((_a = plugin.nativescript) === null || _a === void 0 ? void 0 : _a.hooks) || []) {
+                const expectedHash = pluginLockHooks.get(hook.type);
+                if (!expectedHash) {
+                    this.$logger.error(`❌ Missing hook '${hook.type}' for plugin '${plugin.name}' in ${exports.LOCK_FILE_NAME}`);
+                    isValid = false;
+                    continue;
+                }
+                let fileContent;
+                try {
+                    fileContent = this.$fs.readFile(path.join(plugin.fullPath, hook.script));
+                }
+                catch (err) {
+                    this.$logger.error(`❌ Cannot read script file '${hook.script}' for hook '${hook.type}' in plugin '${plugin.name}'`);
+                    isValid = false;
+                    continue;
+                }
+                const actualHash = crypto
+                    .createHash("sha256")
+                    .update(fileContent)
+                    .digest("hex");
+                if (actualHash !== expectedHash) {
+                    this.$logger.error(`❌ Hash mismatch for '${hook.script}' (${hook.type} in ${plugin.name}):`);
+                    this.$logger.error(`   Expected: ${expectedHash}`);
+                    this.$logger.error(`   Actual:   ${actualHash}`);
+                    isValid = false;
+                }
+            }
+        }
+        if (isValid) {
+            this.$logger.info("✅ All hooks verified successfully. No issues found.");
+        }
+        else {
+            this.$errors.fail("❌ One or more hooks failed verification.");
+        }
+    }
+}
+exports.HooksVerify = HooksVerify;
+//# sourceMappingURL=common.js.map

package/lib/commands/hooks/hooks-lock.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HooksVerifyPluginCommand = exports.HooksLockPluginCommand = void 0;
+const yok_1 = require("../../common/yok");
+const path = require("path");
+const crypto = require("crypto");
+const common_1 = require("./common");
+class HooksLockPluginCommand {
+    constructor($pluginsService, $projectData, $errors, $fs, $logger) {
+        this.$pluginsService = $pluginsService;
+        this.$projectData = $projectData;
+        this.$errors = $errors;
+        this.$fs = $fs;
+        this.$logger = $logger;
+        this.allowedParameters = [];
+        this.$projectData.initializeProjectData();
+    }
+    async execute() {
+        var _a, _b;
+        const plugins = await this.$pluginsService.getAllInstalledPlugins(this.$projectData);
+        if (plugins && plugins.length > 0) {
+            const pluginsWithHooks = [];
+            for (const plugin of plugins) {
+                if (((_b = (_a = plugin.nativescript) === null || _a === void 0 ? void 0 : _a.hooks) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+                    pluginsWithHooks.push(plugin);
+                }
+            }
+            await this.writeHooksLockFile(pluginsWithHooks, this.$projectData.projectDir);
+        }
+        else {
+            this.$logger.info("No plugins with hooks found.");
+        }
+    }
+    async canExecute(args) {
+        return true;
+    }
+    async writeHooksLockFile(plugins, outputDir) {
+        var _a;
+        const output = [];
+        for (const plugin of plugins) {
+            const hooks = [];
+            for (const hook of ((_a = plugin.nativescript) === null || _a === void 0 ? void 0 : _a.hooks) || []) {
+                try {
+                    const fileContent = this.$fs.readFile(path.join(plugin.fullPath, hook.script));
+                    const hash = crypto
+                        .createHash("sha256")
+                        .update(fileContent)
+                        .digest("hex");
+                    hooks.push({
+                        type: hook.type,
+                        hash,
+                    });
+                }
+                catch (err) {
+                    this.$logger.warn(`Warning: Failed to read script '${hook.script}' for plugin '${plugin.name}'. Skipping this hook.`);
+                    continue;
+                }
+            }
+            output.push({ name: plugin.name, hooks });
+        }
+        const filePath = path.resolve(outputDir, common_1.LOCK_FILE_NAME);
+        try {
+            this.$fs.writeFile(filePath, JSON.stringify(output, null, 2), "utf8");
+            this.$logger.info(`✅ ${common_1.LOCK_FILE_NAME} written to: ${filePath}`);
+        }
+        catch (err) {
+            this.$errors.fail(`❌ Failed to write ${common_1.LOCK_FILE_NAME}: ${err}`);
+        }
+    }
+}
+exports.HooksLockPluginCommand = HooksLockPluginCommand;
+class HooksVerifyPluginCommand extends common_1.HooksVerify {
+    constructor($pluginsService, $projectData, $errors, $fs, $logger) {
+        super($projectData, $errors, $fs, $logger);
+        this.$pluginsService = $pluginsService;
+        this.allowedParameters = [];
+    }
+    async execute() {
+        var _a, _b;
+        const plugins = await this.$pluginsService.getAllInstalledPlugins(this.$projectData);
+        if (plugins && plugins.length > 0) {
+            const pluginsWithHooks = [];
+            for (const plugin of plugins) {
+                if (((_b = (_a = plugin.nativescript) === null || _a === void 0 ? void 0 : _a.hooks) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+                    pluginsWithHooks.push(plugin);
+                }
+            }
+            await this.verifyHooksLock(pluginsWithHooks, path.join(this.$projectData.projectDir, common_1.LOCK_FILE_NAME));
+        }
+        else {
+            this.$logger.info("No plugins with hooks found.");
+        }
+    }
+    async canExecute(args) {
+        return true;
+    }
+}
+exports.HooksVerifyPluginCommand = HooksVerifyPluginCommand;
+yok_1.injector.registerCommand(["hooks|lock"], HooksLockPluginCommand);
+yok_1.injector.registerCommand(["hooks|verify"], HooksVerifyPluginCommand);
+//# sourceMappingURL=hooks-lock.js.map

package/lib/commands/hooks/hooks.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HooksListPluginCommand = exports.HooksPluginCommand = void 0;
+const yok_1 = require("../../common/yok");
+const path = require("path");
+const constants_1 = require("../../constants");
+const helpers_1 = require("../../common/helpers");
+const nsHooks = require("@nativescript/hook");
+const common_1 = require("./common");
+class HooksPluginCommand extends common_1.HooksVerify {
+    constructor($pluginsService, $projectData, $errors, $fs, $logger) {
+        super($projectData, $errors, $fs, $logger);
+        this.$pluginsService = $pluginsService;
+        this.allowedParameters = [];
+    }
+    async execute(args) {
+        var _a, _b;
+        const isList = args.length > 0 && args[0] === "list" ? true : false;
+        const plugins = await this.$pluginsService.getAllInstalledPlugins(this.$projectData);
+        if (plugins && plugins.length > 0) {
+            const hooksDir = path.join(this.$projectData.projectDir, constants_1.HOOKS_DIR_NAME);
+            const pluginsWithHooks = [];
+            for (const plugin of plugins) {
+                if (((_b = (_a = plugin.nativescript) === null || _a === void 0 ? void 0 : _a.hooks) === null || _b === void 0 ? void 0 : _b.length) > 0) {
+                    pluginsWithHooks.push(plugin);
+                }
+            }
+            if (isList) {
+                const headers = ["Plugin", "HookName", "HookPath"];
+                const hookDataData = pluginsWithHooks.flatMap((plugin) => plugin.nativescript.hooks.map((hook) => {
+                    return [plugin.name, hook.type, hook.script];
+                }));
+                const hookDataTable = (0, helpers_1.createTable)(headers, hookDataData);
+                this.$logger.info("Hooks:");
+                this.$logger.info(hookDataTable.toString());
+            }
+            else {
+                if (this.$fs.exists(path.join(this.$projectData.projectDir, common_1.LOCK_FILE_NAME))) {
+                    await this.verifyHooksLock(pluginsWithHooks, path.join(this.$projectData.projectDir, common_1.LOCK_FILE_NAME));
+                }
+                if (pluginsWithHooks.length === 0) {
+                    if (!this.$fs.exists(hooksDir)) {
+                        this.$fs.createDirectory(hooksDir);
+                    }
+                }
+                for (const plugin of pluginsWithHooks) {
+                    nsHooks(plugin.fullPath).postinstall();
+                }
+            }
+        }
+    }
+    async canExecute(args) {
+        if (args.length > 0 && args[0] !== "list") {
+            this.$errors.failWithHelp(`Invalid argument ${args[0]}. Supported argument is "list".`);
+        }
+        return true;
+    }
+}
+exports.HooksPluginCommand = HooksPluginCommand;
+class HooksListPluginCommand extends HooksPluginCommand {
+    constructor($pluginsService, $projectData, $errors, $fs, $logger) {
+        super($pluginsService, $projectData, $errors, $fs, $logger);
+        this.allowedParameters = [];
+    }
+    async execute() {
+        await super.execute(["list"]);
+    }
+}
+exports.HooksListPluginCommand = HooksListPluginCommand;
+yok_1.injector.registerCommand(["hooks|install"], HooksPluginCommand);
+yok_1.injector.registerCommand(["hooks|*list"], HooksListPluginCommand);
+//# sourceMappingURL=hooks.js.map

package/lib/commands/info.js

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

package/lib/commands/install.js

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

package/lib/commands/list-platforms.js

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

package/lib/commands/migrate.js

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

package/lib/commands/native-add.js

@@ -173,6 +173,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"));
         }
     }
@@ -185,7 +186,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;
             }
@@ -193,6 +196,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);
@@ -275,3 +279,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

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

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

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

@@ -28,12 +28,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 {
             await this.downloadPackage(selectedTemplate, projectDir);
             await 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;
         }
@@ -69,6 +71,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,
@@ -123,6 +126,7 @@ class CreatePluginCommand {
     }
     async getPluginNameSource(pluginNameSource, pluginRepoName) {
         if (!pluginNameSource) {
+            // remove nativescript- prefix for naming plugin files
             const prefix = "nativescript-";
             pluginNameSource = pluginRepoName.toLowerCase().startsWith(prefix)
                 ? pluginRepoName.slice(prefix.length, pluginRepoName.length)
@@ -150,3 +154,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

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

@@ -21,6 +21,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 = await this.$pluginsService.getAllInstalledPlugins(this.$projectData);
             pluginNames = installedPlugins.map((pl) => pl.name);
         }
@@ -37,3 +38,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

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

package/lib/commands/post-install.js

@@ -19,13 +19,18 @@ class PostInstallCliCommand {
     async execute(args) {
         const isRunningWithSudoUser = !!process.env.SUDO_USER;
         if (!this.$hostInfo.isWindows) {
+            // when running under 'sudo' we create a working dir with wrong owner (root) and
+            // it is no longer accessible for the user initiating the installation
+            // patch the owner here
             if (isRunningWithSudoUser) {
+                // TODO: Check if this is the correct place, probably we should set this at the end of the command.
                 await this.$fs.setCurrentUserAsOwner(this.$settingsService.getProfileDir(), process.env.SUDO_USER);
             }
         }
         const canExecutePostInstallTask = !isRunningWithSudoUser || (0, helpers_1.doesCurrentNpmCommandMatch)([/^--unsafe-perm$/]);
         if (canExecutePostInstallTask) {
             await this.$helpService.generateHtmlPages();
+            // Explicitly ask for confirmation of usage-reporting:
             await this.$analyticsService.checkConsent();
             await this.$commandsService.tryExecuteCommand("autocomplete", []);
         }
@@ -42,3 +47,4 @@ class PostInstallCliCommand {
 }
 exports.PostInstallCliCommand = PostInstallCliCommand;
 yok_1.injector.registerCommand("post-install-cli", PostInstallCliCommand);
+//# sourceMappingURL=post-install.js.map

package/lib/commands/prepare.js

@@ -17,13 +17,13 @@ class PrepareCommand extends command_base_1.ValidatePlatformCommandBase {
         this.allowedParameters = [this.$platformCommandParameter];
         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 },
             whatever: {
-                type: "boolean",
+                type: "boolean" /* OptionType.Boolean */,
                 default: false,
                 hasSensitiveValue: false,
             },
@@ -54,3 +54,4 @@ class PrepareCommand extends command_base_1.ValidatePlatformCommandBase {
 }
 exports.PrepareCommand = PrepareCommand;
 yok_1.injector.registerCommand("prepare", PrepareCommand);
+//# sourceMappingURL=prepare.js.map

package/lib/commands/preview.js

@@ -24,6 +24,7 @@ class PreviewCommand {
     }
     async execute(args) {
         if (!this.$options.disableNpmInstall) {
+            // ensure latest is installed
             await this.$packageManager.install(`${PREVIEW_CLI_PACKAGE}@latest`, this.$projectData.projectDir, {
                 "save-dev": true,
                 "save-exact": true,
@@ -78,3 +79,4 @@ class PreviewCommand {
 }
 exports.PreviewCommand = PreviewCommand;
 yok_1.injector.registerCommand("preview", PreviewCommand);
+//# sourceMappingURL=preview.js.map

package/lib/commands/remove-platform.js

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

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

@@ -15,6 +15,7 @@ class ResourcesUpdateCommand {
     }
     async canExecute(args) {
         if (!args || args.length === 0) {
+            // Command defaults to migrating the Android App_Resources, unless explicitly specified
             args = ["android"];
         }
         for (const platform of args) {
@@ -30,3 +31,4 @@ class ResourcesUpdateCommand {
 }
 exports.ResourcesUpdateCommand = ResourcesUpdateCommand;
 yok_1.injector.registerCommand("resources|update", ResourcesUpdateCommand);
+//# sourceMappingURL=resources-update.js.map

package/lib/commands/run.js

@@ -154,3 +154,4 @@ class RunVisionOSCommand extends RunIosCommand {
 exports.RunVisionOSCommand = RunVisionOSCommand;
 yok_1.injector.registerCommand("run|vision", RunVisionOSCommand);
 yok_1.injector.registerCommand("run|visionos", RunVisionOSCommand);
+//# sourceMappingURL=run.js.map

package/lib/commands/setup.js

@@ -13,3 +13,4 @@ class SetupCommand {
 }
 exports.SetupCommand = SetupCommand;
 yok_1.injector.registerCommand("setup|*", SetupCommand);
+//# sourceMappingURL=setup.js.map

package/lib/commands/start.js

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

package/lib/commands/test-init.js

@@ -66,6 +66,8 @@ class TestInitCommand {
                     continue;
                 }
                 const dependencyVersion = modulePeerDependencies[peerDependency] || "*";
+                // catch errors when a peerDependency is already installed
+                // e.g karma is installed; karma-jasmine depends on karma and will try to install it again
                 try {
                     await this.$packageManager.install(`${peerDependency}@${dependencyVersion}`, projectDir, {
                         "save-dev": true,
@@ -117,6 +119,7 @@ class TestInitCommand {
             const targetExampleTestRelativePath = path.relative(projectDir, targetExampleTestPath);
             bufferedLogs.push(`Added example test: ${color_1.color.yellow(targetExampleTestRelativePath)}`);
         }
+        // test main entry
         const testMainResourcesPath = this.$resources.resolvePath(`test/test-main${projectFilesExtension}`);
         const testMainPath = path.join(this.$projectData.appDirectoryPath, `test${projectFilesExtension}`);
         if (!this.$fs.exists(testMainPath)) {
@@ -154,3 +157,4 @@ class TestInitCommand {
     }
 }
 yok_1.injector.registerCommand("test|init", TestInitCommand);
+//# sourceMappingURL=test-init.js.map