Add display name and priority support to endpoints

src/Aspire.Dashboard/Components/Controls/ResourceDetails.razor

@@ -63,14 +63,50 @@
                         @FilteredEndpoints.Count()
                     </FluentBadge>
                 </div>
-                <PropertyGrid
-                    TItem="DisplayedEndpoint"
-                    Items="@FilteredEndpoints"
-                    ContentAfterValue="(vm) => GetContentAfterValue(vm)"
-                    ValueSort="_endpointValueSort"
-                    IsValueMaskedChanged="@OnValueMaskedChanged"
-                    HighlightText="@_filter"
-                    GridTemplateColumns="1fr 1.5fr" />
+
+                @{
+                    var hasAnyEndpointDisplayNames = FilteredEndpoints.Any(e => e.DisplayName != null);
+                }
+
+                <FluentDataGrid TGridItem="DisplayedEndpoint"
+                                ItemKey="@(vm => ((IPropertyGridItem)vm).Key)"
+                                Items="@FilteredEndpoints"
+                                ColumnResizeLabels="@_resizeLabels"
+                                ColumnSortLabels="@_sortLabels"
+                                HeaderCellAsButtonWithMenu="true"
+                                ResizableColumns="true"
+                                ResizeType="DataGridResizeType.Discrete"
+                                Style="width:100%"
+                                RowSize="DataGridRowSize.Medium"
+                                GridTemplateColumns="@(hasAnyEndpointDisplayNames ? "1fr 1.5fr 1.5fr" : "1.5fr 1.5fr")"
+                                ShowHover="true">
+                    <AspireTemplateColumn Sortable="true" SortBy="@(GridSort<DisplayedEndpoint>.ByAscending(i => i.Name))" Title="@ControlStringsLoc[nameof(ControlsStrings.NameColumnHeader)]">
+                        <GridValue ValueDescription="@ControlStringsLoc[nameof(ControlsStrings.NameColumnHeader)]"
+                                   Value="@context.Name"
+                                   EnableHighlighting="@(!string.IsNullOrEmpty(_filter))"
+                                   HighlightText="@_filter" />
+                    </AspireTemplateColumn>
+                    @if (hasAnyEndpointDisplayNames)
+                    {
+                        <AspireTemplateColumn Sortable="true" SortBy="@(GridSort<DisplayedEndpoint>.ByAscending(i => i.Name))" Title="@ControlStringsLoc[nameof(ControlsStrings.DisplayNameColumnHeader)]">
+                            @if (context.DisplayName is not null)
+                            {
+                                <GridValue ValueDescription="@ControlStringsLoc[nameof(ControlsStrings.DisplayNameColumnHeader)]"
+                                           Value="@context.DisplayName"
+                                           EnableHighlighting="@(!string.IsNullOrEmpty(_filter))"
+                                           HighlightText="@_filter" />
+                            }
+                        </AspireTemplateColumn>
+                    }
+                    <AspireTemplateColumn Sortable="true" SortBy="@_endpointValueSort" Title="@ControlStringsLoc[nameof(ControlsStrings.PropertyGridValueColumnHeader)]">
+                        <GridValue ValueDescription="@ControlStringsLoc[nameof(ControlsStrings.NameColumnHeader)]"
+                                   Value="@context.OriginalUrlString"
+                                   ContentAfterValue="vm => GetContentAfterValue(context)"
+                                   EnableHighlighting="@(!string.IsNullOrEmpty(_filter))"
+                                   IsMaskedChanged="@(_ => OnValueMaskedChanged(context))"
+                                   HighlightText="@_filter" />
+                    </AspireTemplateColumn>
+                </FluentDataGrid>
             </FluentAccordionItem>
             @if (Resource.IsContainer())
             {

src/Aspire.Dashboard/Model/ResourceEndpointHelpers.cs

@@ -22,10 +22,12 @@ public static List<DisplayedEndpoint> GetEndpoints(ResourceViewModel resource, b
                 endpoints.Add(new DisplayedEndpoint
                 {
                     Name = url.Name,
-                    Text = url.Url.OriginalString,
                     Address = url.Url.Host,
                     Port = url.Url.Port,
-                    Url = url.Url.Scheme is "http" or "https" ? url.Url.OriginalString : null
+                    Url = url.Url.Scheme is "http" or "https" ? url.Url.OriginalString : null,
+                    Priority = url.Priority,
+                    OriginalUrlString = url.Url.OriginalString,
+                    Text = url.DisplayName ?? url.Url.OriginalString
                 });
             }
         }
@@ -36,7 +38,8 @@ public static List<DisplayedEndpoint> GetEndpoints(ResourceViewModel resource, b
         // - other urls
         // - endpoint name
         var orderedEndpoints = endpoints
-            .OrderByDescending(e => e.Url?.StartsWith("https") == true)
+            .OrderByDescending(e => e.Priority ?? 0)
+            .ThenByDescending(e => e.Url?.StartsWith("https") == true)
             .ThenByDescending(e => e.Url != null)
             .ThenBy(e => e.Name, StringComparers.EndpointAnnotationName)
             .ToList();
@@ -53,6 +56,9 @@ public sealed class DisplayedEndpoint : IPropertyGridItem
     public string? Address { get; set; }
     public int? Port { get; set; }
     public string? Url { get; set; }
+    public int? Priority { get; set; }
+    public string? DisplayName { get; set; }
+    public required string OriginalUrlString { get; set; }
 
     /// <summary>
     /// Don't display a plain string value here. The URL will be displayed as a hyperlink

src/Aspire.Dashboard/Model/ResourceViewModel.cs

@@ -324,15 +324,19 @@ public sealed class UrlViewModel
     public string Name { get; }
     public Uri Url { get; }
     public bool IsInternal { get; }
+    public string? DisplayName { get; }
+    public int? Priority { get; }
 
-    public UrlViewModel(string name, Uri url, bool isInternal)
+    public UrlViewModel(string name, Uri url, bool isInternal, string? displayName = null, int? priority = null)
     {
         ArgumentException.ThrowIfNullOrWhiteSpace(name);
         ArgumentNullException.ThrowIfNull(url);
 
         Name = name;
         Url = url;
         IsInternal = isInternal;
+        DisplayName = displayName;
+        Priority = priority;
     }
 }
 

src/Aspire.Dashboard/ResourceService/Partials.cs

@@ -93,7 +93,7 @@ ImmutableArray<UrlViewModel> GetUrls()
             return (from u in Urls
                     let parsedUri = Uri.TryCreate(u.FullUrl, UriKind.Absolute, out var uri) ? uri : null
                     where parsedUri != null
-                    select new UrlViewModel(u.Name, parsedUri, u.IsInternal))
+                    select new UrlViewModel(u.Name, parsedUri, u.IsInternal, u.HasDisplayName ? u.DisplayName : null, u.HasPriority ? u.Priority : null))
                     .ToImmutableArray();
         }
 

src/Aspire.Dashboard/Resources/ControlsStrings.resx

@@ -181,6 +181,9 @@
   <data name="NameColumnHeader" xml:space="preserve">
     <value>Name</value>
   </data>
+  <data name="DisplayNameColumnHeader" xml:space="preserve">
+    <value>Display name</value>
+  </data>
   <data name="PropertyGridValueColumnHeader" xml:space="preserve">
     <value>Value</value>
   </data>
@@ -437,4 +440,4 @@
   <data name="ClearPendingSelectedResource" xml:space="preserve">
     <value>Remove for resource</value>
   </data>
-</root>
+</root>

src/Aspire.Hosting.Azure.CosmosDB/AzureCosmosDBExtensions.cs

@@ -288,10 +288,11 @@ public static IResourceBuilder<AzureCosmosDBEmulatorResource> WithDataExplorer(t
             endpoint.UriScheme = "http";
             endpoint.TargetPort = 1234;
             endpoint.Port = port;
+            endpoint.DisplayName = "Data Explorer";
         });
     }
 
-    /// <summary>    
+    /// <summary>
     /// Configures the resource to use access key authentication with Azure Cosmos DB.
     /// </summary>
     /// <param name="builder">The Azure Cosmos DB resource builder.</param>

src/Aspire.Hosting/ApplicationModel/CustomResourceSnapshot.cs

@@ -177,8 +177,10 @@ public sealed record EnvironmentVariableSnapshot(string Name, string? Value, boo
 /// <param name="Name">Name of the url.</param>
 /// <param name="Url">The full uri.</param>
 /// <param name="IsInternal">Determines if this url is internal.</param>
+/// <param name="DisplayName">The display name of the url.</param>
+/// <param name="Priority">The order of the url in UI.</param>
 [DebuggerDisplay("{Url}", Name = "{Name}")]
-public sealed record UrlSnapshot(string Name, string Url, bool IsInternal);
+public sealed record UrlSnapshot(string Name, string Url, bool IsInternal, string? DisplayName = null, int? Priority = null);
 
 /// <summary>
 /// A snapshot of a volume, mounted to a container.

src/Aspire.Hosting/ApplicationModel/EndpointAnnotation.cs

@@ -31,7 +31,9 @@ public sealed class EndpointAnnotation : IResourceAnnotation
     /// <param name="targetPort">This is the port the resource is listening on. If the endpoint is used for the container, it is the container port.</param>
     /// <param name="isExternal">Indicates that this endpoint should be exposed externally at publish time.</param>
     /// <param name="isProxied">Specifies if the endpoint will be proxied by DCP. Defaults to true.</param>
-    public EndpointAnnotation(ProtocolType protocol, string? uriScheme = null, string? transport = null, [EndpointName] string? name = null, int? port = null, int? targetPort = null, bool? isExternal = null, bool isProxied = true)
+    /// <param name="displayName">Display name of the endpoint, to be displayed in the Aspire Dashboard.</param>
+    /// <param name="priority">Integer to control visual ordering of endpoints in the Aspire Dashboard.</param>
+    public EndpointAnnotation(ProtocolType protocol, string? uriScheme = null, string? transport = null, [EndpointName] string? name = null, int? port = null, int? targetPort = null, bool? isExternal = null, bool isProxied = true, string? displayName = null, int? priority = null)
     {
         // If the URI scheme is null, we'll adopt either udp:// or tcp:// based on the
         // protocol. If the name is null, we'll use the URI scheme as the default. This
@@ -51,6 +53,8 @@ public EndpointAnnotation(ProtocolType protocol, string? uriScheme = null, strin
         _targetPort = targetPort;
         IsExternal = isExternal ?? false;
         IsProxied = isProxied;
+        DisplayName = displayName;
+        Priority = priority;
     }
 
     /// <summary>
@@ -131,6 +135,16 @@ public string Transport
     /// <remarks>Defaults to <c>true</c>.</remarks>
     public bool IsProxied { get; set; } = true;
 
+    /// <summary>
+    /// Display name of the endpoint, to be displayed in the Aspire Dashboard.
+    /// </summary>
+    public string? DisplayName { get; set; }
+
+    /// <summary>
+    /// Integer to control visual ordering of endpoints in the Aspire Dashboard.
+    /// </summary>
+    public int? Priority { get; set; }
+
     /// <summary>
     /// Gets or sets a value indicating whether the endpoint is from a launch profile.
     /// </summary>

src/Aspire.Hosting/ApplicationModel/EndpointReference.cs

@@ -101,6 +101,16 @@ public EndpointReferenceExpression Property(EndpointProperty property)
     /// </summary>
     public string Url => AllocatedEndpoint.UriString;
 
+    /// <summary>
+    /// Gets the display name for this endpoint.
+    /// </summary>
+    public string? DisplayName => EndpointAnnotation.DisplayName;
+
+    /// <summary>
+    /// Gets the visual priority for this endpoint.
+    /// </summary>
+    public int? Priority => EndpointAnnotation.Priority;
+
     internal AllocatedEndpoint AllocatedEndpoint =>
         GetAllocatedEndpoint()
         ?? throw new InvalidOperationException($"The endpoint `{EndpointName}` is not allocated for the resource `{Resource.Name}`.");