nativescript 9.0.0-alpha.2 → 9.0.0-alpha.3

package/lib/services/project-data-service.js

@@ -27,12 +27,14 @@ class ProjectDataService {
         this.$injector = $injector;
         this.projectDataCache = {};
         try {
+            // add the ProjectData of the default projectDir to the projectData cache
             const projectData = this.$injector.resolve("projectData");
             projectData.initializeProjectData();
             this.defaultProjectDir = projectData.projectDir;
             this.projectDataCache[this.defaultProjectDir] = projectData;
         }
         catch (e) {
+            // the CLI is required as a lib from a non-project folder
         }
     }
     get $pluginsService() {
@@ -61,6 +63,8 @@ class ProjectDataService {
         delete projectFileInfo.projectData[ProjectDataService.DEPENDENCIES_KEY_NAME][dependencyName];
         this.$fs.writeJson(projectFileInfo.projectFilePath, projectFileInfo.projectData);
     }
+    // TODO: Add tests
+    // TODO: Remove $projectData and replace it with $projectDataService.getProjectData
     getProjectData(projectDir) {
         projectDir = projectDir || this.defaultProjectDir;
         this.projectDataCache[projectDir] =
@@ -112,6 +116,10 @@ class ProjectDataService {
         this.$logger.trace(`"${propertyName}" property successfully removed.`);
     }
     async getAndroidAssetsStructure(opts) {
+        // TODO: Use image-size package to get the width and height of an image.
+        // TODO: Parse the splash_screen.xml in nodpi directory and get from it the names of the background and center image.
+        // TODO: Parse the AndroidManifest.xml to get the name of the icon.
+        // This way we'll not use the image-definitions.json and the method will return the real android structure.
         const projectDir = opts.projectDir;
         const projectData = this.getProjectData(projectDir);
         const pathToAndroidDir = path.join(projectData.appResourcesDirectoryPath, this.$devicePlatformsConstants.Android);
@@ -125,6 +133,7 @@ class ProjectDataService {
             useLegacy = !manifest.includes(`android:icon="@mipmap/ic_launcher"`);
         }
         catch (err) {
+            // ignore
         }
         const content = this.getImageDefinitions()[useLegacy ? "android_legacy" : "android"];
         return {
@@ -148,6 +157,8 @@ class ProjectDataService {
             }
             if (fstat.isDirectory()) {
                 if (filePath === pathToProjectNodeModules) {
+                    // we do not want to get the files from node_modules directory of the project.
+                    // We'll get here only when you have nativescript.config with appDirectoryPath set to "."
                     return false;
                 }
                 return true;
@@ -162,6 +173,9 @@ class ProjectDataService {
         }
     }
     updateNsConfigValue(projectDir, updateObject, propertiesToRemove) {
+        // todo: figure out a way to update js/ts configs
+        // most likely needs an ast parser/writer
+        // should be delegated to the config service
         const nsConfigPath = path.join(projectDir, constants.CONFIG_FILE_NAME_JS);
         const currentNsConfig = this.getNsConfig(nsConfigPath);
         let newNsConfig = currentNsConfig;
@@ -202,10 +216,14 @@ class ProjectDataService {
         const imageDefinitions = this.getImageDefinitions().ios;
         _.each(content && content.images, (image) => {
             let foundMatchingDefinition = false;
+            // In some cases the image may not be available, it will just be described.
+            // When this happens, the filename will be empty.
+            // So we'll keep the path empty as well.
             if (image.filename) {
                 image.path = path.join(dirPath, image.filename);
             }
             if (image.size) {
+                // size is basically <width>x<height>
                 const [width, height] = image.size
                     .toString()
                     .split(constants_1.AssetConstants.sizeDelimiter);
@@ -214,6 +232,7 @@ class ProjectDataService {
                     image.height = +height;
                 }
             }
+            // Find the image size based on the hardcoded values in the image-definitions.json
             _.each(imageDefinitions, (assetSubGroup) => {
                 const assetItem = _.find(assetSubGroup, (assetElement) => assetElement.filename === image.filename &&
                     path.basename(assetElement.directory) === path.basename(dirPath));
@@ -233,6 +252,7 @@ class ProjectDataService {
                     image.scale = image.scale || assetItem.scale;
                     image.rgba = assetItem.rgba;
                     finalContent.images.push(image);
+                    // break each
                     return false;
                 }
             });
@@ -335,13 +355,16 @@ class ProjectDataService {
     getRuntimePackage(projectDir, platform) {
         platform = platform.toLowerCase();
         const packageJson = this.$fs.readJson(path.join(projectDir, constants.PACKAGE_JSON_FILE_NAME));
-        const runtimeName = platform === "android"
+        const runtimeName = platform === "android" /* PlatformTypes.android */
             ? constants.TNS_ANDROID_RUNTIME_NAME
             : constants.TNS_IOS_RUNTIME_NAME;
         if (packageJson &&
             packageJson.nativescript &&
             packageJson.nativescript[runtimeName] &&
             packageJson.nativescript[runtimeName].version) {
+            // if we have a nativescript key with a runtime version in package.json
+            // that means we are dealing with a legacy project, and should respect
+            // that information
             return {
                 name: runtimeName,
                 version: packageJson.nativescript[runtimeName].version,
@@ -353,19 +376,19 @@ class ProjectDataService {
         const runtimePackage = this.$pluginsService
             .getDependenciesFromPackageJson(projectDir)
             .devDependencies.find((d) => {
-            if (platform === "ios") {
+            if (platform === "ios" /* constants.PlatformTypes.ios */) {
                 return [
                     constants.SCOPED_IOS_RUNTIME_NAME,
                     constants.TNS_IOS_RUNTIME_NAME,
                 ].includes(d.name);
             }
-            else if (platform === "android") {
+            else if (platform === "android" /* constants.PlatformTypes.android */) {
                 return [
                     constants.SCOPED_ANDROID_RUNTIME_NAME,
                     constants.TNS_ANDROID_RUNTIME_NAME,
                 ].includes(d.name);
             }
-            else if (platform === "visionos") {
+            else if (platform === "visionos" /* constants.PlatformTypes.visionos */) {
                 return d.name === constants.SCOPED_VISIONOS_RUNTIME_NAME;
             }
         });
@@ -373,12 +396,14 @@ class ProjectDataService {
             const coerced = semver.coerce(runtimePackage.version);
             const isRange = !!coerced && coerced.version !== runtimePackage.version;
             const isTag = !coerced;
+            // in case we are using a local tgz for the runtime or a range like ~8.0.0, ^8.0.0 etc. or a tag like JSC
             if (runtimePackage.version.includes("tgz") || isRange || isTag) {
                 try {
                     const runtimePackageJsonPath = (0, package_path_helper_1.resolvePackageJSONPath)(runtimePackage.name, {
                         paths: [projectDir],
                     });
                     if (!runtimePackageJsonPath) {
+                        // caught below
                         throw new Error("Runtime package.json not found.");
                     }
                     runtimePackage.version = this.$fs.readJson(runtimePackageJsonPath).version;
@@ -395,20 +420,21 @@ class ProjectDataService {
             }
             return runtimePackage;
         }
+        // default to the scoped runtimes
         this.$logger.trace("Could not find an installed runtime, falling back to default runtimes");
-        if (platform === "ios") {
+        if (platform === "ios" /* constants.PlatformTypes.ios */) {
             return {
                 name: constants.SCOPED_IOS_RUNTIME_NAME,
                 version: null,
             };
         }
-        else if (platform === "android") {
+        else if (platform === "android" /* constants.PlatformTypes.android */) {
             return {
                 name: constants.SCOPED_ANDROID_RUNTIME_NAME,
                 version: null,
             };
         }
-        else if (platform === "visionos") {
+        else if (platform === "visionos" /* constants.PlatformTypes.visionos */) {
             return {
                 name: constants.SCOPED_VISIONOS_RUNTIME_NAME,
                 version: null,
@@ -443,9 +469,11 @@ __decorate([
             return projectDir + ":" + platform;
         },
         shouldCache(result) {
+            // don't cache coerced versions
             if (result._coerced) {
                 return false;
             }
+            // only cache if version is defined
             return !!result.version;
         },
     })
@@ -454,3 +482,4 @@ __decorate([
     (0, decorators_1.exported)("projectDataService")
 ], ProjectDataService.prototype, "getNsConfigDefaultContent", null);
 yok_1.injector.register("projectDataService", ProjectDataService);
+//# sourceMappingURL=project-data-service.js.map

package/lib/services/project-name-service.js

@@ -50,3 +50,4 @@ class ProjectNameService {
 }
 exports.ProjectNameService = ProjectNameService;
 yok_1.injector.register("projectNameService", ProjectNameService);
+//# sourceMappingURL=project-name-service.js.map

package/lib/services/project-service.js

@@ -64,11 +64,15 @@ class ProjectService {
             appId: appId,
             projectName,
         });
+        // can pass --no-git to skip creating a git repo
+        // useful in monorepos where we're creating
+        // sub projects in an existing git repo.
         if (this.$options.git) {
             try {
                 if (!this.$options.force) {
                     const git = (0, simple_git_1.default)(projectDir);
                     if (await git.checkIsRepo()) {
+                        // throwing here since we're catching below.
                         throw new Error("Already part of a git repository.");
                     }
                 }
@@ -108,6 +112,7 @@ class ProjectService {
             this.alterPackageJsonData(projectCreationSettings);
             this.$projectConfigService.writeDefaultConfig(projectDir, appId);
             await this.ensureAppResourcesExist(projectDir);
+            // Install devDependencies and execute all scripts:
             await this.$packageManager.install(projectDir, projectDir, {
                 disableNpmInstall: false,
                 frameworkPath: null,
@@ -137,6 +142,7 @@ class ProjectService {
             this.$logger.trace("Project does not have App_Resources - fetching from default template.");
             this.$fs.createDirectory(appResourcesDestinationPath);
             const tempDir = await this.$tempService.mkdirSync("ns-default-template");
+            // the template installed doesn't have App_Resources -> get from a default template
             await this.$pacoteService.extractPackage(constants.RESERVED_TEMPLATE_NAMES["default"], tempDir);
             const templateProjectData = this.$projectDataService.getProjectData(tempDir);
             const templateAppResourcesDir = templateProjectData.getAppResourcesDirectoryPath(tempDir);
@@ -147,12 +153,14 @@ class ProjectService {
         const { projectDir, projectName } = projectCreationSettings;
         const projectFilePath = path.join(projectDir, this.$staticConfig.PROJECT_FILE_NAME);
         let packageJsonData = this.$fs.readJson(projectFilePath);
+        // clean up keys from the template package.json that we don't care about.
         Object.keys(packageJsonData).forEach((key) => {
             if (key.startsWith("_") ||
                 constants.TemplatesV2PackageJsonKeysToRemove.includes(key)) {
                 delete packageJsonData[key];
             }
         });
+        // this is used to ensure the order of keys is consistent, the blanks are filled in from the template
         const packageJsonSchema = {
             name: projectName,
             main: "",
@@ -160,6 +168,7 @@ class ProjectService {
             private: true,
             dependencies: {},
             devDependencies: {},
+            // anythign else would go below
         };
         packageJsonData = Object.assign(packageJsonSchema, packageJsonData);
         this.$fs.writeJson(projectFilePath, packageJsonData);
@@ -183,3 +192,4 @@ __decorate([
     (0, decorators_2.performanceLog)()
 ], ProjectService.prototype, "alterPackageJsonData", null);
 yok_1.injector.register("projectService", ProjectService);
+//# sourceMappingURL=project-service.js.map

package/lib/services/project-templates-service.js

@@ -40,12 +40,12 @@ class ProjectTemplatesService {
         const templateNameToBeTracked = this.getTemplateNameToBeTracked(templateValue, templatePackageJsonContent);
         if (templateNameToBeTracked) {
             await this.$analyticsService.trackEventActionInGoogleAnalytics({
-                action: "Create project",
+                action: "Create project" /* constants.TrackActionNames.CreateProject */,
                 isForDevice: null,
                 additionalData: templateNameToBeTracked,
             });
             await this.$analyticsService.trackEventActionInGoogleAnalytics({
-                action: "Using Template",
+                action: "Using Template" /* constants.TrackActionNames.UsingTemplate */,
                 additionalData: templateNameToBeTracked,
             });
         }
@@ -97,3 +97,4 @@ __decorate([
     (0, decorators_1.performanceLog)()
 ], ProjectTemplatesService.prototype, "prepareTemplate", null);
 yok_1.injector.register("projectTemplatesService", ProjectTemplatesService);
+//# sourceMappingURL=project-templates-service.js.map

package/lib/services/qr-code-terminal-service.js

@@ -18,3 +18,4 @@ class QrCodeTerminalService {
 }
 exports.QrCodeTerminalService = QrCodeTerminalService;
 yok_1.injector.register("qrCodeTerminalService", QrCodeTerminalService);
+//# sourceMappingURL=qr-code-terminal-service.js.map

package/lib/services/require-service.js

@@ -9,3 +9,4 @@ class RequireService {
 }
 exports.RequireService = RequireService;
 yok_1.injector.register("requireService", RequireService);
+//# sourceMappingURL=require-service.js.map

package/lib/services/start-service.js

@@ -96,3 +96,4 @@ class StartService {
 }
 exports.default = StartService;
 yok_1.injector.register("startService", StartService);
+//# sourceMappingURL=start-service.js.map

package/lib/services/temp-service.js

@@ -21,3 +21,4 @@ class TempService {
 }
 exports.TempService = TempService;
 yok_1.injector.register("tempService", TempService);
+//# sourceMappingURL=temp-service.js.map

package/lib/services/terminal-spinner-service.js

@@ -5,6 +5,7 @@ const ora = require("ora");
 const yok_1 = require("../common/yok");
 class TerminalSpinnerService {
     createSpinner(spinnerOptions = {}) {
+        // @ts-expect-error - options are readonly, however we still want to override them before passing them on...
         spinnerOptions.stream = spinnerOptions.stream || process.stdout;
         return ora(spinnerOptions);
     }
@@ -25,3 +26,4 @@ class TerminalSpinnerService {
 }
 exports.TerminalSpinnerService = TerminalSpinnerService;
 yok_1.injector.register("terminalSpinnerService", TerminalSpinnerService);
+//# sourceMappingURL=terminal-spinner-service.js.map

package/lib/services/test-execution-service.js

@@ -24,8 +24,10 @@ class TestExecutionService {
         platform = platform.toLowerCase();
         this.platform = platform;
         const projectData = this.$projectDataService.getProjectData(liveSyncInfo.projectDir);
+        // We need the dependencies installed here, so we can start the Karma server.
         await this.$pluginsService.ensureAllDependenciesAreInstalled(projectData);
         const karmaConfig = this.getKarmaConfiguration(platform, projectData);
+        // In case you want to debug the unit test runner, add "--inspect-brk=<port>" as a first element in the array of args.
         const karmaRunner = this.$childProcess.spawn(process.execPath, [path.join(__dirname, "karma-execution.js")], { stdio: ["inherit", "inherit", "inherit", "ipc"] });
         const launchKarmaTests = async (karmaData) => {
             this.$logger.trace("## Unit-testing: Parent process received message", karmaData);
@@ -42,6 +44,8 @@ class TestExecutionService {
                 const configJs = this.generateConfig(port, configOptions);
                 this.$fs.writeFile(path.join(liveSyncInfo.projectDir, TestExecutionService.CONFIG_FILE_NAME), configJs);
             }
+            // Prepare the project AFTER the TestExecutionService.CONFIG_FILE_NAME file is created in node_modules
+            // so it will be sent to device.
             await this.$runController.run({
                 liveSyncInfo,
                 deviceDescriptors,
@@ -54,12 +58,13 @@ class TestExecutionService {
             }
             launchKarmaTests(karmaData).catch((result) => {
                 this.$logger.error(result);
-                process.exit(130);
+                process.exit(130 /* ErrorCodes.KARMA_FAIL */);
             });
         });
         return new Promise((resolve, reject) => {
             karmaRunner.on("exit", (exitCode) => {
                 if (exitCode !== 0) {
+                    //End our process with a non-zero exit code
                     const testError = new Error("Test run failed.");
                     reject(testError);
                 }
@@ -72,7 +77,7 @@ class TestExecutionService {
     }
     async canStartKarmaServer(projectData) {
         let canStartKarmaServer = true;
-        const requiredDependencies = ["@nativescript/unit-test-runner"];
+        const requiredDependencies = ["@nativescript/unit-test-runner"]; // we need @nativescript/unit-test-runner at the local level because of hooks!
         _.each(requiredDependencies, (dep) => {
             if (!projectData.dependencies[dep] && !projectData.devDependencies[dep]) {
                 canStartKarmaServer = false;
@@ -121,6 +126,7 @@ class TestExecutionService {
             karmaConfig.logLevel = "DEBUG";
         }
         if (!this.$options.watch) {
+            // Setting singleRun to true will automatically start the tests when new browser (device in our case) is registered in karma.
             karmaConfig.singleRun = true;
         }
         if (this.$options.debugBrk) {
@@ -139,3 +145,4 @@ exports.TestExecutionService = TestExecutionService;
 TestExecutionService.CONFIG_FILE_NAME = `node_modules/${constants.TEST_RUNNER_NAME}/config.js`;
 TestExecutionService.SOCKETIO_JS_FILE_NAME = `node_modules/${constants.TEST_RUNNER_NAME}/socket.io.js`;
 yok_1.injector.register("testExecutionService", TestExecutionService);
+//# sourceMappingURL=test-execution-service.js.map

package/lib/services/test-initialization-service.js

@@ -34,6 +34,9 @@ class TestInitializationService {
         });
         return targetFrameworkDependencies;
     }
+    /**
+     * This method is used from test-init.md file so it is not allowed to use "this" inside the method's body.
+     */
     getFrameworkNames() {
         const configsPath = path.join(__dirname, "..", "..", "config");
         const dependenciesPath = path.join(configsPath, "test-dependencies.json");
@@ -52,3 +55,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], TestInitializationService.prototype, "getFrameworkNames", null);
 yok_1.injector.register("testInitializationService", TestInitializationService);
+//# sourceMappingURL=test-initialization-service.js.map

package/lib/services/timeline-profiler-service.js

@@ -98,3 +98,4 @@ __decorate([
     (0, decorators_1.cache)()
 ], TimelineProfilerService.prototype, "isEnabled", null);
 yok_1.injector.register("timelineProfilerService", TimelineProfilerService);
+//# sourceMappingURL=timeline-profiler-service.js.map

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

@@ -32,3 +32,4 @@ class UserSettingsService {
 }
 exports.UserSettingsService = UserSettingsService;
 yok_1.injector.register("userSettingsService", UserSettingsService);
+//# sourceMappingURL=user-settings-service.js.map

package/lib/services/versions-service.js

@@ -47,6 +47,7 @@ class VersionsService {
             const tnsCoreModulesPath = path.join(nodeModulesPath, constants.TNS_CORE_MODULES_NAME);
             const dependsOnNonScopedPackage = !!this.projectData.dependencies[constants.TNS_CORE_MODULES_NAME];
             const dependsOnScopedPackage = !!this.projectData.dependencies[constants.SCOPED_TNS_CORE_MODULES];
+            // ensure the dependencies are installed, so we can get their actual versions from node_modules
             if (!this.$fs.exists(nodeModulesPath) ||
                 (dependsOnNonScopedPackage && !this.$fs.exists(tnsCoreModulesPath)) ||
                 (dependsOnScopedPackage && !this.$fs.exists(scopedPackagePath))) {
@@ -73,16 +74,16 @@ class VersionsService {
         return versionInformations;
     }
     async getRuntimesVersions(platform) {
-        const iosRuntime = this.$projectDataService.getRuntimePackage(this.projectData.projectDir, "ios");
-        const androidRuntime = this.$projectDataService.getRuntimePackage(this.projectData.projectDir, "android");
+        const iosRuntime = this.$projectDataService.getRuntimePackage(this.projectData.projectDir, "ios" /* constants.PlatformTypes.ios */);
+        const androidRuntime = this.$projectDataService.getRuntimePackage(this.projectData.projectDir, "android" /* constants.PlatformTypes.android */);
         let runtimes = [];
         if (!platform) {
             runtimes = [iosRuntime, androidRuntime];
         }
-        else if (platform === "ios") {
+        else if (platform === "ios" /* PlatformTypes.ios */) {
             runtimes.push(iosRuntime);
         }
-        else if (platform === "android") {
+        else if (platform === "android" /* PlatformTypes.android */) {
             runtimes.push(androidRuntime);
         }
         const runtimesVersions = await Promise.all(runtimes.map(async (runtime) => {
@@ -175,3 +176,4 @@ VersionsService.UP_TO_DATE_MESSAGE = "up to date";
 VersionsService.UPDATE_AVAILABLE_MESSAGE = "Update available";
 VersionsService.NOT_INSTALLED_MESSAGE = "not installed";
 yok_1.injector.register("versionsService", VersionsService);
+//# sourceMappingURL=versions-service.js.map

package/lib/services/watch-ignore-list-service.js

@@ -18,3 +18,4 @@ class WatchIgnoreListService {
 }
 exports.WatchIgnoreListService = WatchIgnoreListService;
 yok_1.injector.register("watchIgnoreListService", WatchIgnoreListService);
+//# sourceMappingURL=watch-ignore-list-service.js.map

package/lib/services/xcconfig-service.js

@@ -55,6 +55,7 @@ class XcconfigService {
                 }
             });
             if (isPropertyParsed) {
+                // property can be an empty string, so we don't check for that.
                 return property;
             }
         }
@@ -63,3 +64,4 @@ class XcconfigService {
 }
 exports.XcconfigService = XcconfigService;
 yok_1.injector.register("xcconfigService", XcconfigService);
+//# sourceMappingURL=xcconfig-service.js.map

package/lib/services/xcproj-service.js

@@ -21,3 +21,4 @@ class XcprojService {
     }
 }
 yok_1.injector.register("xcprojService", XcprojService);
+//# sourceMappingURL=xcproj-service.js.map

package/lib/shared-event-bus.js

@@ -2,6 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 const events_1 = require("events");
 const yok_1 = require("./common/yok");
+/**
+ * Event Bus used by different services to emit state changes and
+ * allow listening for these state changes without needing a reference
+ * to the emitting service.
+ */
 class SharedEventBus extends events_1.EventEmitter {
 }
 yok_1.injector.register("sharedEventBus", SharedEventBus);
+//# sourceMappingURL=shared-event-bus.js.map

package/lib/sys-info.js

@@ -79,7 +79,7 @@ class SysInfo {
         if (macOSVersion && macOSVersion < constants_1.MacOSVersions.HighSierra) {
             return {
                 message: (0, util_1.format)(constants_1.MacOSDeprecationStringFormat, macOSVersion),
-                severity: "high",
+                severity: "high" /* SystemWarningsSeverity.high */,
             };
         }
         return null;
@@ -101,3 +101,4 @@ __decorate([
     (0, decorators_1.exported)("sysInfo")
 ], SysInfo.prototype, "getSupportedNodeVersionRange", null);
 yok_1.injector.register("sysInfo", SysInfo);
+//# sourceMappingURL=sys-info.js.map

package/lib/tools/config-manipulation/config-transformer.js

@@ -55,6 +55,7 @@ class ConfigTransformer {
             const parts = key.split(".");
             const name = parts.shift();
             const property = this.getProperty(name, parent);
+            // no android key, add it to parent to root
             if (!property) {
                 return undefined;
             }
@@ -64,11 +65,14 @@ class ConfigTransformer {
             if (!_parent) {
                 return undefined;
             }
+            // add nonExistent.deep to android: {}
             return this.getProperty(parts.join("."), _parent);
         }
+        // if we have a parent, we are reading the property from it
         if (parent) {
             return parent.getProperty(key);
         }
+        // otherwise we just read it from the root exports object
         return this.getProperty(key, this.getDefaultExportValue());
     }
     addProperty(key, value, parent = null) {
@@ -190,15 +194,22 @@ class ConfigTransformer {
         }
         this.setInitializerValue(initializer, newValue);
     }
+    /**
+     * @internal
+     */
     getFullText() {
         return this.config.getFullText();
     }
+    /**
+     * @internal
+     */
     getValue(key) {
         return this.getPropertyValue(this.getProperty(key));
     }
     setValue(key, value) {
         const property = this.getProperty(key);
         if (!property) {
+            // add new property
             this.addProperty(key, value);
         }
         else {
@@ -208,3 +219,4 @@ class ConfigTransformer {
     }
 }
 exports.ConfigTransformer = ConfigTransformer;
+//# sourceMappingURL=config-transformer.js.map

package/lib/tools/node-modules/node-modules-builder.js

@@ -29,3 +29,4 @@ class NodeModulesBuilder {
 }
 exports.NodeModulesBuilder = NodeModulesBuilder;
 yok_1.injector.register("nodeModulesBuilder", NodeModulesBuilder);
+//# sourceMappingURL=node-modules-builder.js.map

package/lib/tools/node-modules/node-modules-dependencies-builder.js

@@ -56,14 +56,18 @@ class NodeModulesDependenciesBuilder {
             let modulePath = (0, resolve_package_path_1.resolvePackagePath)(depDescription.name, {
                 paths: [parentModulesPath],
             });
+            // perhaps traverse up the tree here?
             if (!modulePath) {
+                // fallback to searching in the root path
                 modulePath = (0, resolve_package_path_1.resolvePackagePath)(depDescription.name, {
                     paths: [rootPath],
                 });
             }
+            // if we failed to find the module...
             if (!modulePath) {
                 return null;
             }
+            // if we already resolved this dependency, we return null to avoid a duplicate resolution
             if (resolvedDependencies.some((r) => {
                 return r.name === depDescription.name && r.directory === modulePath;
             })) {
@@ -88,6 +92,7 @@ class NodeModulesDependenciesBuilder {
             const packageJsonContents = this.$fs.readJson(packageJsonPath);
             dependency.version = packageJsonContents.version;
             if (!!packageJsonContents.nativescript) {
+                // add `nativescript` property, necessary for resolving plugins
                 dependency.nativescript = packageJsonContents.nativescript;
             }
             dependency.dependencies = _.keys(packageJsonContents.dependencies);
@@ -98,3 +103,4 @@ class NodeModulesDependenciesBuilder {
 }
 exports.NodeModulesDependenciesBuilder = NodeModulesDependenciesBuilder;
 yok_1.injector.register("nodeModulesDependenciesBuilder", NodeModulesDependenciesBuilder);
+//# sourceMappingURL=node-modules-dependencies-builder.js.map

package/lib/yarn-package-manager.js

@@ -113,3 +113,4 @@ __decorate([
     (0, decorators_1.exported)("yarn")
 ], YarnPackageManager.prototype, "getCachePath", null);
 yok_1.injector.register("yarn", YarnPackageManager);
+//# sourceMappingURL=yarn-package-manager.js.map

package/lib/yarn2-package-manager.js

@@ -36,6 +36,8 @@ class Yarn2PackageManager extends base_package_manager_1.BasePackageManager {
         }
         const packageJsonPath = path.join(pathToSave, "package.json");
         const jsonContentBefore = this.$fs.readJson(packageJsonPath);
+        // remove unsupported flags
+        // todo: refactor all package managers to map typed flags to the actual flags
         const cleanedConfig = _.omit(config, ["save-dev", "save-exact"]);
         const flags = this.getFlagsString(cleanedConfig, true);
         let params = [];
@@ -122,3 +124,4 @@ __decorate([
     (0, decorators_1.exported)("yarn2")
 ], Yarn2PackageManager.prototype, "getCachePath", null);
 yok_1.injector.register("yarn2", Yarn2PackageManager);
+//# sourceMappingURL=yarn2-package-manager.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "nativescript",
   "main": "./lib/nativescript-cli-lib.js",
-  "version": "9.0.0-alpha.2",
+  "version": "9.0.0-alpha.3",
   "author": "NativeScript <oss@nativescript.org>",
   "description": "Command-line interface for building NativeScript projects",
   "bin": {
@@ -61,7 +61,7 @@
     "@rigor789/trapezedev-project": "7.1.2",
     "ansi-colors": "^4.1.3",
     "archiver": "^7.0.1",
-    "axios": "1.7.9",
+    "axios": "1.11.0",
     "byline": "5.0.0",
     "chalk": "4.1.2",
     "chokidar": "4.0.3",
@@ -144,6 +144,7 @@
     "@types/ws": "8.5.14",
     "@types/xml2js": "0.4.14",
     "@types/yargs": "17.0.33",
+    "braces": ">=3.0.3",
     "chai": "5.2.0",
     "chai-as-promised": "8.0.1",
     "conventional-changelog-cli": "^5.0.0",
@@ -160,7 +161,8 @@
     "lint-staged": "~15.4.3",
     "mocha": "11.1.0",
     "sinon": "19.0.2",
-    "source-map-support": "0.5.21"
+    "source-map-support": "0.5.21",
+    "xml2js": ">=0.5.0"
   },
   "optionalDependencies": {
     "fsevents": "*"
@@ -181,4 +183,4 @@
   "lint-staged": {
     "*.ts": "prettier --write"
   }
-}
+}