Add documentation and example for new args functionality

Co-authored-by: aaronpowell <434140+aaronpowell@users.noreply.github.com>

Author: Copilot

examples/nodejs-ext/CommunityToolkit.Aspire.Hosting.NodeJS.Extensions.AppHost/Program.cs

@@ -9,4 +9,9 @@
 builder.AddViteApp("pnpm-demo", packageManager: "pnpm")
     .WithPnpmPackageInstallation();
 
+// Example of using custom args - useful for legacy packages
+builder.AddNpmApp("npm-with-flags", "../vite-demo")
+    .WithNpmPackageInstallation(useCI: false, args: ["--legacy-peer-deps"])
+    .WithHttpEndpoint(env: "PORT");
+
 builder.Build().Run();

src/CommunityToolkit.Aspire.Hosting.NodeJS.Extensions/README.md

@@ -24,6 +24,27 @@ builder.AddPnpmApp("pnpm-demo")
     .WithExternalHttpEndpoints();
 ```
 
+### Package installation with custom flags
+
+You can pass additional flags to package managers during installation:
+
+```csharp
+// npm with legacy peer deps support
+builder.AddNpmApp("npm-app", "./path/to/app")
+    .WithNpmPackageInstallation(useCI: false, args: ["--legacy-peer-deps"])
+    .WithExternalHttpEndpoints();
+
+// yarn with frozen lockfile
+builder.AddYarnApp("yarn-app", "./path/to/app")  
+    .WithYarnPackageInstallation(args: ["--frozen-lockfile", "--verbose"])
+    .WithExternalHttpEndpoints();
+
+// pnpm with frozen lockfile
+builder.AddPnpmApp("pnpm-app", "./path/to/app")
+    .WithPnpmPackageInstallation(args: ["--frozen-lockfile"])
+    .WithExternalHttpEndpoints();
+```
+
 ## Additional Information
 
 https://learn.microsoft.com/dotnet/aspire/community-toolkit/hosting-nodejs-extensions

src/CommunityToolkit.Aspire.Hosting.NodeJS.Extensions/api/CommunityToolkit.Aspire.Hosting.NodeJS.Extensions.cs

@@ -16,10 +16,10 @@ public static partial class NodeJSHostingExtensions
 
         public static ApplicationModel.IResourceBuilder<NodeAppResource> AddYarnApp(this IDistributedApplicationBuilder builder, string name, string workingDirectory, string scriptName = "start", string[]? args = null) { throw null; }
 
-        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithNpmPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource, bool useCI = false) { throw null; }
+        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithNpmPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource, bool useCI = false, string[]? args = null) { throw null; }
 
-        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithPnpmPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource) { throw null; }
+        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithPnpmPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource, string[]? args = null) { throw null; }
 
-        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithYarnPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource) { throw null; }
+        public static ApplicationModel.IResourceBuilder<NodeAppResource> WithYarnPackageInstallation(this ApplicationModel.IResourceBuilder<NodeAppResource> resource, string[]? args = null) { throw null; }
     }
 }