Address remaining PR feedback and fix Docker Compose publish

PR feedback from #15691:
- Add [ResourceName] attribute to all Add* API name parameters
- Replace null-forgiving operator with explicit throw in EndpointsManifestTransformer
- Use StringComparison.OrdinalIgnoreCase for route comparison
- Fix '.NET Aspire' phrasing in README files

Docker Compose publish fixes for Blazor gateway:
- Add GatewayOriginReference (IValueProvider + IManifestExpressionProvider)
- Use ReferenceExpression for ConfigResponse so publishers emit proper placeholders
- Use TextEncoderSettings to escape braces in JSON string values
- Simplify Gateway.cs.in (serve ConfigResponse directly, no Replace logic)
- Add System.Text.Unicode dependency for brace-escaping encoder

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

Author: javiercn

playground/BlazorHosted/README.md

@@ -1,6 +1,6 @@
 # BlazorHosted
 
-This sample demonstrates how to integrate a **hosted Blazor WebAssembly** application (Blazor Web App with Interactive WebAssembly render mode) with .NET Aspire, enabling full observability (logs, traces) and service discovery for both the server and the WASM client.
+This sample demonstrates how to integrate a **hosted Blazor WebAssembly** application (Blazor Web App with Interactive WebAssembly render mode) with Aspire, enabling full observability (logs, traces) and service discovery for both the server and the WASM client.
 
 ## Overview
 

playground/BlazorStandalone/README.md

@@ -1,6 +1,6 @@
 # BlazorStandalone
 
-This sample demonstrates how to integrate a **standalone Blazor WebAssembly** application with .NET Aspire, enabling full observability (logs, traces) and service discovery without requiring a hosted Blazor Server backend.
+This sample demonstrates how to integrate a **standalone Blazor WebAssembly** application with Aspire, enabling full observability (logs, traces) and service discovery without requiring a hosted Blazor Server backend.
 
 ## Overview
 

src/Aspire.Hosting.Blazor/Aspire.Hosting.Blazor.csproj

@@ -11,8 +11,20 @@
   <PropertyGroup>
     <MinCodeCoverage>0</MinCodeCoverage>
     <EnablePackageValidation>false</EnablePackageValidation>
+    <!-- The minimum .NET version for Docker images used in the Blazor gateway publish pipeline.
+         Derived from the highest TFM in the repo (currently net10.0). The Gateway.cs file-based
+         app and the WASM client projects target this version, so published containers must use
+         matching SDK/runtime base images. -->
+    <BlazorGatewayDotNetImageTag>10.0</BlazorGatewayDotNetImageTag>
   </PropertyGroup>
 
+  <ItemGroup>
+    <AssemblyAttribute Include="System.Reflection.AssemblyMetadataAttribute">
+      <_Parameter1>BlazorGatewayDotNetImageTag</_Parameter1>
+      <_Parameter2>$(BlazorGatewayDotNetImageTag)</_Parameter2>
+    </AssemblyAttribute>
+  </ItemGroup>
+
   <ItemGroup>
     <ProjectReference Include="..\Aspire.Hosting\Aspire.Hosting.csproj" />
   </ItemGroup>

src/Aspire.Hosting.Blazor/BlazorGatewayExtensions.cs

@@ -21,10 +21,6 @@ namespace Aspire.Hosting;
 [Experimental("ASPIREBLAZOR001", UrlFormat = "https://aka.ms/aspire/diagnostics/{0}")]
 public static class BlazorGatewayExtensions
 {
-    // Derive the .NET image tag from the runtime version of the app host process.
-    // The Gateway is a file-based app compiled with the same SDK, so the major.minor
-    // version of the running host matches the required SDK/ASP.NET base images.
-    // Pre-release runtimes (preview/RC) use suffixed tags like "10.0-preview" or "11.0-rc".
     private static readonly string s_dotNetImageTag = GetDotNetImageTag();
     private const string DotNetSdkImageRepo = "mcr.microsoft.com/dotnet/sdk";
     private const string DotNetAspNetImageRepo = "mcr.microsoft.com/dotnet/aspnet";
@@ -37,7 +33,7 @@ public static class BlazorGatewayExtensions
     [AspireExportIgnore(Reason = "Blazor gateway APIs are not yet stable for ATS export.")]
     public static IResourceBuilder<ProjectResource> AddBlazorGateway(
         this IDistributedApplicationBuilder builder,
-        string name)
+        [ResourceName] string name)
     {
         var gatewayPath = GetScriptPath("Gateway.cs");
         var gateway = builder.AddCSharpApp(name, gatewayPath)
@@ -84,7 +80,7 @@ public static IResourceBuilder<ProjectResource> AddBlazorGateway(
     [AspireExportIgnore(Reason = "Open generic type parameter TProject is not ATS-compatible.")]
     public static IResourceBuilder<BlazorWasmAppResource> AddBlazorWasmProject<TProject>(
         this IDistributedApplicationBuilder builder,
-        string name)
+        [ResourceName] string name)
         where TProject : IProjectMetadata, new()
     {
         var metadata = new TProject();
@@ -109,7 +105,7 @@ public static IResourceBuilder<BlazorWasmAppResource> AddBlazorWasmProject<TProj
     [AspireExportIgnore(Reason = "Blazor gateway APIs are not yet stable for ATS export.")]
     public static IResourceBuilder<BlazorWasmAppResource> AddBlazorWasmApp(
         this IDistributedApplicationBuilder builder,
-        string name,
+        [ResourceName] string name,
         string projectPath)
     {
         var resolvedPath = Path.GetFullPath(Path.Combine(builder.AppHostDirectory, projectPath));
@@ -201,8 +197,7 @@ internal static IResourceBuilder<ProjectResource> WithBlazorApp(
         var annotation = GetOrAddGatewayAppsAnnotation(gateway.Resource);
 
         var gatewayOutputRoot = Path.Combine(
-            gateway.ApplicationBuilder.AppHostDirectory,
-            "obj", "Aspire.Hosting.Blazor", "gateways", gateway.Resource.Name);
+            GetBlazorStorePath(gateway.ApplicationBuilder), "gateways", gateway.Resource.Name);
 
         if (!annotation.IsInitialized)
         {
@@ -253,9 +248,8 @@ internal static IResourceBuilder<ProjectResource> WithBlazorApp(
                 // and isolated mode). Fall back to configuration for cases where the dashboard
                 // resource isn't in the model (e.g. external dashboard).
                 var httpOtlpEndpointUrl = ResolveHttpOtlpEndpointUrl(context, gateway.ApplicationBuilder.Configuration);
-                var resourceLoggerService = context.ExecutionContext.ServiceProvider.GetRequiredService<ResourceLoggerService>();
 
-                GatewayConfigurationBuilder.EmitProxyConfiguration(context.EnvironmentVariables, registeredApps, gatewayEndpoint, httpGatewayEndpoint, httpOtlpEndpointUrl, resourceLoggerService);
+                GatewayConfigurationBuilder.EmitProxyConfiguration(context.EnvironmentVariables, registeredApps, gatewayEndpoint, httpGatewayEndpoint, httpOtlpEndpointUrl);
             });
         }
 
@@ -413,14 +407,14 @@ private static void CreatePublishCompanion(
         var relativeProjectPath = Path.GetRelativePath(
             project.SolutionRoot, wasmApp.Resource.ProjectPath).Replace('\\', '/');
 
-        // Copy the PrefixEndpoints.cs script into a project-local build folder so it's
-        // available inside the Docker build context without clobbering the solution root.
+        // Copy PrefixEndpoints.cs into .aspire/scripts/ within the solution root so it's
+        // included in the Docker build context.
         var scriptSource = GetScriptPath("PrefixEndpoints.cs");
-        var scriptRelativePath = Path.Combine(project.RelativeProjectPath, "obj", "Aspire.Hosting.Blazor", "PrefixEndpoints.cs")
-            .Replace('\\', '/');
-        var scriptDest = Path.Combine(project.SolutionRoot, scriptRelativePath.Replace('/', Path.DirectorySeparatorChar));
+        var scriptDest = Path.Combine(project.SolutionRoot, ".aspire", "scripts", "PrefixEndpoints.cs");
         Directory.CreateDirectory(Path.GetDirectoryName(scriptDest)!);
         File.Copy(scriptSource, scriptDest, overwrite: true);
+        var scriptRelativePath = Path.GetRelativePath(project.SolutionRoot, scriptDest)
+            .Replace('\\', '/');
 
         var companion = gateway.ApplicationBuilder.AddResource(
             new BlazorWasmPublishResource(publishResourceName))
@@ -466,6 +460,17 @@ private static string GetScriptPath(string scriptName)
         return scriptPath;
     }
 
+    /// <summary>
+    /// Gets the Blazor-specific store path under the Aspire store directory.
+    /// </summary>
+    private static string GetBlazorStorePath(IDistributedApplicationBuilder builder)
+    {
+        var storePath = builder.Configuration["Aspire:Store:Path"]
+            ?? builder.AppHostDirectory;
+
+        return Path.Combine(storePath, ".aspire", "blazor");
+    }
+
     private static List<EndpointReferenceAnnotation> GetServiceDiscoveryReferences(IResource resource)
     {
         // EndpointReferenceAnnotation is added by WithReference and tracks which endpoint
@@ -637,30 +642,58 @@ private readonly struct ProjectInfo(string solutionRoot, string relativeProjectP
     }
 
     /// <summary>
-    /// Resolves the Docker image tag for the .NET SDK/ASP.NET base images.
-    /// Returns "Major.Minor" for stable releases (e.g. "10.0", "11.0"),
-    /// and appends "-preview" or "-rc" for pre-release runtimes to match the
-    /// MCR tag naming convention (e.g. "10.0-preview", "11.0-rc").
+    /// Resolves the Docker image tag for .NET base images. Uses the maximum of the build-time
+    /// stamped version and the actual runtime version, with pre-release suffix when applicable.
     /// </summary>
     private static string GetDotNetImageTag()
     {
-        var tag = $"{Environment.Version.Major}.{Environment.Version.Minor}";
+        var runtimeMajor = Environment.Version.Major;
+        var runtimeMinor = Environment.Version.Minor;
 
-        // The runtime's informational version contains the full pre-release label,
-        // e.g. "10.0.0-preview.7.25352.1+..." or "11.0.0-rc.1.25400.3+...".
-        // Stable/servicing builds use "10.0.6-servicing..." which we ignore.
-        var informationalVersion = (System.Reflection.AssemblyInformationalVersionAttribute?)
-            Attribute.GetCustomAttribute(typeof(object).Assembly, typeof(System.Reflection.AssemblyInformationalVersionAttribute));
+        var stampedMajor = runtimeMajor;
+        var stampedMinor = runtimeMinor;
 
-        if (informationalVersion is not null)
+        var stampedValue = typeof(BlazorGatewayExtensions).Assembly
+            .GetCustomAttributes(typeof(System.Reflection.AssemblyMetadataAttribute), inherit: false)
+            .OfType<System.Reflection.AssemblyMetadataAttribute>()
+            .FirstOrDefault(a => a.Key == "BlazorGatewayDotNetImageTag")
+            ?.Value;
+
+        if (!string.IsNullOrEmpty(stampedValue))
         {
-            if (informationalVersion.InformationalVersion.Contains("-preview", StringComparison.OrdinalIgnoreCase))
+            var parts = stampedValue.Split('.');
+            if (parts.Length >= 2
+                && int.TryParse(parts[0], out var sMajor)
+                && int.TryParse(parts[1], out var sMinor))
             {
-                tag += "-preview";
+                stampedMajor = sMajor;
+                stampedMinor = sMinor;
             }
-            else if (informationalVersion.InformationalVersion.Contains("-rc", StringComparison.OrdinalIgnoreCase))
+        }
+
+        var major = Math.Max(runtimeMajor, stampedMajor);
+        var minor = (major == runtimeMajor && major == stampedMajor)
+            ? Math.Max(runtimeMinor, stampedMinor)
+            : (major == runtimeMajor ? runtimeMinor : stampedMinor);
+
+        var tag = $"{major}.{minor}";
+
+        // Append pre-release suffix when the runtime version won and is pre-release.
+        if (major == runtimeMajor && minor == runtimeMinor)
+        {
+            var informationalVersion = (System.Reflection.AssemblyInformationalVersionAttribute?)
+                Attribute.GetCustomAttribute(typeof(object).Assembly, typeof(System.Reflection.AssemblyInformationalVersionAttribute));
+
+            if (informationalVersion is not null)
             {
-                tag += "-rc";
+                if (informationalVersion.InformationalVersion.Contains("-preview", StringComparison.OrdinalIgnoreCase))
+                {
+                    tag += "-preview";
+                }
+                else if (informationalVersion.InformationalVersion.Contains("-rc", StringComparison.OrdinalIgnoreCase))
+                {
+                    tag += "-rc";
+                }
             }
         }
 

src/Aspire.Hosting.Blazor/BlazorHostedExtensions.cs

@@ -99,7 +99,6 @@ private static void EnsureEnvironmentCallback(
                 annotation.Services,
                 annotation.ProxyBlazorTelemetry,
                 httpOtlpEndpointUrl,
-                context.Logger,
                 annotation.OtlpPrefix);
         });
     }