Refactor WithNpmPackageManager to WithNpm with install parameter (dotnet#12325)

## Refactor WithNpmPackageManager to WithNpm with install parameter

### Changes completed:
- [x] Update NodeExtensions.cs to rename `WithNpmPackageManager` to `WithNpm`
- [x] Change parameter name from `autoInstall` to `install` with default value `false`
- [x] Update XML documentation to reflect the new parameter name and default
- [x] Update example in XML documentation to use `.WithNpm(install: true)`
- [x] Update all test usages to explicitly use `install: true` when installer should be created
- [x] Update test for `install: false` behavior (renamed test)
- [x] Update playground examples to use `.WithNpm(install: true)`
- [x] Update template file in aspire-py-starter to use `.WithNpm(install: true)`
- [x] Add comprehensive unit tests for new public APIs:
  - `WithYarn` - tests for both install=true and install=false
  - `WithPnpm` - tests for both install=true and install=false
  - `WithInstallCommand` - tests custom install command with custom args
  - `WithBuildCommand` - tests custom build command
  - Override scenarios for both install and build commands
- [x] Fix existing tests to match new installer naming convention (`{name}-installer` instead of `{name}-npm-install`)
- [x] Run tests to verify all changes work correctly (47 tests passed)

### Summary:
Successfully added comprehensive unit tests for all new public APIs introduced in the refactoring. The tests verify:
- Package manager annotations are correctly set for each package manager (npm, yarn, pnpm)
- Installer resources are created/not created based on the `install` parameter
- Custom install and build commands can be set using `WithInstallCommand` and `WithBuildCommand`
- Existing commands can be overridden
- All tests pass (47/47)

* Refactor WithNpmPackageManager to WithNpm with autoInstall parameter

Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>

* Apply feedback: Rename autoInstall to install with default false

Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>

* WIP - refactor JS

* First round of refactoring

* Refactor and add yarn, pnmp, and WithInstall/BuildCommand APIs

* Fix build

* Apply suggestion from @Copilot

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Add comprehensive unit tests for new public APIs (WithYarn, WithPnpm, WithInstallCommand, WithBuildCommand)

Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>

* Update AspireWithJavaScript playground app

* Add more tests

* Update comments.

* Apply suggestion from @eerhardt

* Respond to PR feedback

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: eerhardt <8291187+eerhardt@users.noreply.github.com>
Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 3 people

.gitignore

@@ -124,6 +124,9 @@ config.ps1
 # Node.js modules
 node_modules/
 
+# Ignore cache created with the Angular CLI.
+.angular/
+
 # Python Compile Outputs
 
 *.pyc

playground/AspireWithJavaScript/AspireJavaScript.AppHost/AppHost.cs

@@ -4,15 +4,15 @@
     .WithExternalHttpEndpoints();
 
 builder.AddNpmApp("angular", "../AspireJavaScript.Angular")
-    .WithNpmPackageManager()
+    .WithNpm(install: true)
     .WithReference(weatherApi)
     .WaitFor(weatherApi)
     .WithHttpEndpoint(env: "PORT")
     .WithExternalHttpEndpoints()
     .PublishAsDockerFile();
 
 builder.AddNpmApp("react", "../AspireJavaScript.React")
-    .WithNpmPackageManager()
+    .WithNpm(install: true)
     .WithReference(weatherApi)
     .WaitFor(weatherApi)
     .WithEnvironment("BROWSER", "none") // Disable opening browser on npm start
@@ -21,15 +21,15 @@
     .PublishAsDockerFile();
 
 builder.AddNpmApp("vue", "../AspireJavaScript.Vue")
-    .WithNpmPackageManager()
+    .WithInstallCommand("npm", ["ci"]) // Use 'npm ci' for clean install
     .WithReference(weatherApi)
     .WaitFor(weatherApi)
     .WithHttpEndpoint(env: "PORT")
     .WithExternalHttpEndpoints()
     .PublishAsDockerFile();
 
 builder.AddViteApp("reactvite", "../AspireJavaScript.Vite")
-    .WithNpmPackageManager()
+    .WithNpm(install: true)
     .WithReference(weatherApi)
     .WithEnvironment("BROWSER", "none")
     .WithExternalHttpEndpoints();

playground/AspireWithJavaScript/AspireJavaScript.Vue/package-lock.json

@@ -0,0 +1,24 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.ApplicationModel;
+
+namespace Aspire.Hosting.NodeJs;
+
+/// <summary>
+/// Represents the annotation for the JavaScript package manager's build command.
+/// </summary>
+/// <param name="command">The executable command name</param>
+/// <param name="args">The command line arguments for the JavaScript package manager's install command.</param>
+public sealed class JavaScriptBuildCommandAnnotation(string command, string[] args) : IResourceAnnotation
+{
+    /// <summary>
+    /// Gets the executable command name.
+    /// </summary>
+    public string Command { get; } = command;
+
+    /// <summary>
+    /// Gets the command-line arguments supplied to the application.
+    /// </summary>
+    public string[] Args { get; } = args;
+}

src/Aspire.Hosting.NodeJs/JavaScriptBuildCommandAnnotation.cs

@@ -0,0 +1,24 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.ApplicationModel;
+
+namespace Aspire.Hosting.NodeJs;
+
+/// <summary>
+/// Represents the annotation for the JavaScript package manager's install command.
+/// </summary>
+/// <param name="command">The executable command name</param>
+/// <param name="args">The command line arguments for the JavaScript package manager's install command.</param>
+public sealed class JavaScriptInstallCommandAnnotation(string command, string[] args) : IResourceAnnotation
+{
+    /// <summary>
+    /// Gets the executable command name.
+    /// </summary>
+    public string Command { get; } = command;
+
+    /// <summary>
+    /// Gets the command-line arguments supplied to the application.
+    /// </summary>
+    public string[] Args { get; } = args;
+}

src/Aspire.Hosting.NodeJs/JavaScriptInstallCommandAnnotation.cs

@@ -0,0 +1,21 @@
+// Licensed to the .NET Foundation under one or more agreements.
+// The .NET Foundation licenses this file to you under the MIT license.
+
+using Aspire.Hosting.ApplicationModel;
+
+namespace Aspire.Hosting.NodeJs;
+
+/// <summary>
+/// Represents the annotation for the JavaScript resource's initial run command line arguments.
+/// </summary>
+/// <remarks>
+/// The Resource contains the command name, while this annotation contains only the arguments.
+/// These arguments are applied to the command before any user supplied arguments.
+/// </remarks>
+public sealed class JavaScriptRunCommandAnnotation(string[] args) : IResourceAnnotation
+{
+    /// <summary>
+    /// Gets the command-line arguments supplied to the application.
+    /// </summary>
+    public string[] Args { get; } = args;
+}