Refactor WithNpmPackageManager to WithNpm with install parameter

[Copilot]

Refactor WithNpmPackageManager to WithNpm with install parameter

Changes completed:

• Update NodeExtensions.cs to rename WithNpmPackageManager to WithNpm
• Change parameter name from autoInstall to install with default value false
• Update XML documentation to reflect the new parameter name and default
• Update example in XML documentation to use .WithNpm(install: true)
• Update all test usages to explicitly use install: true when installer should be created
• Update test for install: false behavior (renamed test)
• Update playground examples to use .WithNpm(install: true)
• Update template file in aspire-py-starter to use .WithNpm(install: true)
• 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
• Fix existing tests to match new installer naming convention ({name}-installer instead of {name}-npm-install)
• 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)

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[eerhardt]

cc @maddymontaquila

[eerhardt]

@copilot - apply the feedback

[davidfowl]

I think Action<IResourceBuilder<NodeInstallerResource>>? configureInstaller = null should be on another overload.

[github-actions]

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 12325

Or

• Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 12325"

[Copilot]

Pull Request Overview

This PR refactors the npm package manager integration by renaming WithNpmPackageManager to WithNpm and introducing an install parameter that provides more granular control over package installation. The default behavior changes from automatically installing packages to requiring explicit opt-in via install: true.

Key Changes:

• Renamed extension method from WithNpmPackageManager to WithNpm with new install parameter (defaults to false)
• Split monolithic JavaScriptPackageManagerAnnotation into three focused annotations: JavaScriptInstallCommandAnnotation, JavaScriptRunCommandAnnotation, and JavaScriptBuildCommandAnnotation
• Removed useCI parameter as the installer now always uses npm install

Reviewed Changes

Copilot reviewed 8 out of 8 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/Aspire.Hosting.NodeJs/NodeExtensions.cs	Renamed method, implemented conditional installer creation, refactored to use new annotation types
src/Aspire.Hosting.NodeJs/JavaScriptPackageManagerAnnotation.cs	Split single annotation into three specialized annotation classes
tests/Aspire.Hosting.NodeJs.Tests/ResourceCreationTests.cs	Updated test names and calls, removed duplicate tests, added new test for install: false behavior
tests/Aspire.Hosting.NodeJs.Tests/PackageInstallationTests.cs	Updated tests to use new API, removed CI-specific test scenarios
tests/Aspire.Hosting.NodeJs.Tests/IntegrationTests.cs	Updated to use WithNpm(install: true)
tests/Aspire.Hosting.NodeJs.Tests/AddViteAppTests.cs	Updated to use WithNpm(install: true)
playground/AspireWithJavaScript/AspireJavaScript.AppHost/AppHost.cs	Updated all playground examples to use WithNpm(install: true)
src/Aspire.ProjectTemplates/templates/aspire-py-starter/13.0/apphost.cs	Updated template to use WithNpm(install: true)