Merge remote-tracking branch 'origin/main' into pre/v9-combined-testing

Author: NathanWalker

.github/workflows/codeql-advanced.yml

@@ -60,7 +60,7 @@ jobs:
         # your codebase is analyzed, see https://docs.github.com/en/code-security/code-scanning/creating-an-advanced-setup-for-code-scanning/codeql-code-scanning-for-compiled-languages
     steps:
     - name: Checkout repository
-      uses: actions/checkout@08eba0b27e820071cde6df949e0beb9ba4906955 # v4.3.0
+      uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
 
     # Add any setup steps before running the `github/codeql-action/init` action.
     # This includes steps like installing compilers or runtimes (`actions/setup-node`
@@ -70,7 +70,7 @@ jobs:
 
     # Initializes the CodeQL tools for scanning.
     - name: Initialize CodeQL
-      uses: github/codeql-action/init@d3678e237b9c32a6c9bffb3315c335f976f3549f # v3.30.2
+      uses: github/codeql-action/init@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
       with:
         languages: ${{ matrix.language }}
         build-mode: ${{ matrix.build-mode }}
@@ -98,6 +98,6 @@ jobs:
         exit 1
 
     - name: Perform CodeQL Analysis
-      uses: github/codeql-action/analyze@d3678e237b9c32a6c9bffb3315c335f976f3549f # v3.30.2
+      uses: github/codeql-action/analyze@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
       with:
         category: "/language:${{matrix.language}}"

.github/workflows/dependency-review.yml

@@ -17,6 +17,6 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: 'Checkout Repository'
-        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.3.0
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v4.3.0
       - name: 'Dependency Review'
-        uses: actions/dependency-review-action@595b5aeba73380359d98a5e087f648dbb0edce1b # v4.7.3
+        uses: actions/dependency-review-action@40c09b7dc99638e5ddb0bfd91c1673effc064d8a # v4.8.1

.github/workflows/npm_release_cli.yml

@@ -20,13 +20,13 @@ jobs:
     steps:
 
       - name: Harden the runner (Audit all outbound calls)
-        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
+        uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
         with:
           egress-policy: audit
 
-      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
 
-      - uses: actions/setup-node@3235b876344d2a9aa001b8d1453c930bba69e610 # v3.9.1
+      - uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903 # v6.0.0
         with:
           node-version: 22.14.0
 

.github/workflows/npm_release_doctor.yml

@@ -24,11 +24,11 @@ jobs:
     steps:
 
       - name: Harden the runner (Audit all outbound calls)
-        uses: step-security/harden-runner@ec9f2d5744a09debf3a187a3f4f675c53b671911 # v2.13.0
+        uses: step-security/harden-runner@f4a75cfd619ee5ce8d5b864b0d183aff3c69b55a # v2.13.1
         with:
           egress-policy: audit
 
-      - uses: actions/checkout@ee0669bd1cc54295c223e0bb666b733df41de1c5 # v2.7.0
+      - uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v5.0.0
 
       - name: Setup
         run: npm install

.github/workflows/scorecard.yml

@@ -33,12 +33,12 @@ jobs:
     steps:
 
       - name: "Checkout code"
-        uses: actions/checkout@ff7abcd0c3c05ccf6adc123a8cd1fd4fb30fb493 # v4.3.0
+        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8 # v4.3.0
         with:
           persist-credentials: false
 
       - name: "Run analysis"
-        uses: ossf/scorecard-action@05b42c624433fc40578a4040d5cf5e36ddca8cde # v2.4.2
+        uses: ossf/scorecard-action@4eaacf0543bb3f2c246792bd56e8cdeffafb205a # v2.4.3
         with:
           results_file: results.sarif
           results_format: sarif
@@ -60,14 +60,14 @@ jobs:
       # Upload the results as artifacts (optional). Commenting out will disable uploads of run results in SARIF
       # format to the repository Actions tab.
       - name: "Upload artifact"
-        uses: actions/upload-artifact@ea165f8d65b6e75b540449e92b4886f43607fa02 # v4.6.2
+        uses: actions/upload-artifact@330a01c490aca151604b8cf639adc76d48f6c5d4 # v5.0.0
         with:
           name: SARIF file
           path: results.sarif
           retention-days: 5
 
       # Upload the results to GitHub's code scanning dashboard.
       - name: "Upload to code-scanning"
-        uses: github/codeql-action/upload-sarif@2d92b76c45b91eb80fc44c74ce3fce0ee94e8f9d # v3.30.0
+        uses: github/codeql-action/upload-sarif@0499de31b99561a6d14a36a5f662c2a54f91beee # v4.31.2
         with:
           sarif_file: results.sarif

docs/build-jekyll-md.sh

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

docs/man_pages/config/config-get.md

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

docs/man_pages/config/config-set.md

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

docs/man_pages/config/config.md

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

lib/commands/debug.ts

@@ -20,7 +20,8 @@ import * as _ from "lodash";
 
 export class DebugPlatformCommand
 	extends ValidatePlatformCommandBase
-	implements ICommand {
+	implements ICommand
+{
 	public allowedParameters: ICommandParameter[] = [];
 
 	constructor(
@@ -36,13 +37,13 @@ export class DebugPlatformCommand
 		private $debugDataService: IDebugDataService,
 		private $debugController: IDebugController,
 		private $liveSyncCommandHelper: ILiveSyncCommandHelper,
-		private $migrateController: IMigrateController
+		private $migrateController: IMigrateController,
 	) {
 		super(
 			$options,
 			$platformsDataService,
 			$platformValidationService,
-			$projectData
+			$projectData,
 		);
 		$cleanupService.setShouldDispose(false);
 	}
@@ -66,10 +67,10 @@ export class DebugPlatformCommand
 			const debugData = this.$debugDataService.getDebugData(
 				selectedDeviceForDebug.deviceInfo.identifier,
 				this.$projectData,
-				debugOptions
+				debugOptions,
 			);
 			await this.$debugController.printDebugInformation(
-				await this.$debugController.startDebug(debugData)
+				await this.$debugController.startDebug(debugData),
 			);
 			return;
 		}
@@ -83,7 +84,7 @@ export class DebugPlatformCommand
 				},
 				buildPlatform: undefined,
 				skipNativePrepare: false,
-			}
+			},
 		);
 	}
 
@@ -98,17 +99,17 @@ export class DebugPlatformCommand
 		if (
 			!this.$platformValidationService.isPlatformSupportedForOS(
 				this.platform,
-				this.$projectData
+				this.$projectData,
 			)
 		) {
 			this.$errors.fail(
-				`Applications for platform ${this.platform} can not be built on this OS`
+				`Applications for platform ${this.platform} can not be built on this OS`,
 			);
 		}
 
 		if (this.$options.release) {
 			this.$errors.failWithHelp(
-				"--release flag is not applicable to this command."
+				"--release flag is not applicable to this command.",
 			);
 		}
 
@@ -138,12 +139,12 @@ export class DebugIOSCommand implements ICommand {
 		private $sysInfo: ISysInfo,
 		private $projectData: IProjectData,
 		$iosDeviceOperations: IIOSDeviceOperations,
-		$iOSSimulatorLogProvider: Mobile.IiOSSimulatorLogProvider
+		$iOSSimulatorLogProvider: Mobile.IiOSSimulatorLogProvider,
 	) {
 		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.
+		// That's why the `$ ns debug ios --justlaunch` command will not release the terminal.
 		// In case we do not set it to false, the dispose will be called once the command finishes its execution, which will prevent the debugging.
 		$iosDeviceOperations.setShouldDispose(false);
 		$iOSSimulatorLogProvider.setShouldDispose(false);
@@ -157,18 +158,18 @@ export class DebugIOSCommand implements ICommand {
 		if (
 			!this.$platformValidationService.isPlatformSupportedForOS(
 				this.$devicePlatformsConstants.iOS,
-				this.$projectData
+				this.$projectData,
 			)
 		) {
 			this.$errors.fail(
-				`Applications for platform ${this.$devicePlatformsConstants.iOS} can not be built on this OS`
+				`Applications for platform ${this.$devicePlatformsConstants.iOS} can not be built on this OS`,
 			);
 		}
 
 		const isValidTimeoutOption = this.isValidTimeoutOption();
 		if (!isValidTimeoutOption) {
 			this.$errors.fail(
-				`Timeout option specifies the seconds NativeScript CLI will wait to find the inspector socket port from device's logs. Must be a number.`
+				`Timeout option specifies the seconds NativeScript CLI will wait to find the inspector socket port from device's logs. Must be a number.`,
 			);
 		}
 
@@ -179,7 +180,7 @@ export class DebugIOSCommand implements ICommand {
 				macOSWarning.severity === SystemWarningsSeverity.high
 			) {
 				this.$errors.fail(
-					`You cannot use NativeScript Inspector on this OS. To use it, please update your OS.`
+					`You cannot use NativeScript Inspector on this OS. To use it, please update your OS.`,
 				);
 			}
 		}
@@ -224,7 +225,7 @@ export class DebugAndroidCommand implements ICommand {
 		private $devicePlatformsConstants: Mobile.IDevicePlatformsConstants,
 		private $injector: IInjector,
 		private $projectData: IProjectData,
-		private $options: IOptions
+		private $options: IOptions,
 	) {
 		this.$projectData.initializeProjectData();
 	}