Add new version dropdown feature flag and enhance existing dropdown

Author: reakaleek

src/Elastic.ApiExplorer/Endpoints/EndpointView.cshtml

@@ -13,7 +13,9 @@
 		Previous = null,
 		Next = null,
 		NavigationHtml = Model.NavigationHtml,
-		LegacyPage = null,
+		LegacyPages = [],
+		CurrentVersion = null,
+		VersionDropdown = null,
 		UrlPathPrefix = null,
 		GithubEditUrl = null,
 		ReportIssueUrl = null,

src/Elastic.ApiExplorer/Landing/LandingView.cshtml

@@ -13,7 +13,9 @@
 		Previous = null,
 		Next = null,
 		NavigationHtml = Model.NavigationHtml,
-		LegacyPage = null,
+		LegacyPages = [],
+		CurrentVersion = null,
+		VersionDropdown = null,
 		UrlPathPrefix = null,
 		GithubEditUrl = null,
 		ReportIssueUrl = null,

src/Elastic.ApiExplorer/Operations/OperationView.cshtml

@@ -13,7 +13,9 @@
 		Previous = null,
 		Next = null,
 		NavigationHtml = Model.NavigationHtml,
-		LegacyPage = null,
+		LegacyPages = [],
+		VersionDropdown = null,
+		CurrentVersion = null,
 		UrlPathPrefix = null,
 		GithubEditUrl = null,
 		ReportIssueUrl = null,

src/Elastic.Documentation.Configuration/Assembler/AssemblyConfiguration.cs

@@ -67,6 +67,9 @@ private static TRepository RepositoryDefaults<TRepository>(TRepository r, string
 		return repository;
 	}
 
+	[YamlMember(Alias = "versions")]
+	public Dictionary<string, VersionEntry> Versions { get; set; } = [];
+
 	[YamlMember(Alias = "narrative")]
 	public NarrativeRepository Narrative { get; set; } = new();
 

src/Elastic.Documentation.Configuration/Assembler/VersionEntry.cs

@@ -0,0 +1,19 @@
+// Licensed to Elasticsearch B.V under one or more agreements.
+// Elasticsearch B.V licenses this file to you under the Apache 2.0 License.
+// See the LICENSE file in the project root for more information
+
+using YamlDotNet.Serialization;
+
+namespace Elastic.Documentation.Configuration.Assembler;
+
+public record VersionEntry
+{
+	[YamlMember(Alias = "base")]
+	public string? Base { get; set; }
+
+	[YamlMember(Alias = "current")]
+	public string? Current { get; set; }
+
+	[YamlMember(Alias = "legacy_versions")]
+	public IReadOnlyList<string> LegacyVersions { get; set; } = [];
+}

src/Elastic.Documentation.Configuration/Builder/FeatureFlags.cs

@@ -7,7 +7,7 @@ namespace Elastic.Documentation.Configuration.Builder;
 public class FeatureFlags(Dictionary<string, bool> featureFlags)
 {
 	public bool IsPrimaryNavEnabled => IsEnabled("primary-nav");
-	public bool IsLandingPageEnabled => IsEnabled("landing-page");
+	public bool IsVersionDropdownEnabled => IsEnabled("version-dropdown");
 	private bool IsEnabled(string key)
 	{
 		var envKey = $"FEATURE_{key.ToUpperInvariant().Replace('-', '_')}";

src/Elastic.Documentation.Configuration/Builder/Products.cs

@@ -6,13 +6,24 @@
 
 namespace Elastic.Documentation.Configuration.Builder;
 
-public record Product(string Id, string DisplayName);
+public record Product(string Id, string DisplayName, HashSet<Product>? SubProduct = null);
 
 public static class Products
 {
 	public static FrozenSet<Product> All { get; } = [
 		new("apm", "APM"),
-		new("apm-agent", "APM Agent"),
+		new("apm-agent", "APM Agent", [
+			new Product("apm-agent-android", "APM Android Agent"),
+			new Product("apm-agent-dotnet", "APM .NET Agent"),
+			new Product("apm-agent-go", "APM Go Agent"),
+			new Product("apm-agent-java", "APM Java Agent"),
+			new Product("apm-agent-nodejs", "APM Node.js Agent"),
+			new Product("apm-agent-php", "APM PHP Agent"),
+			new Product("apm-agent-python", "APM Python Agent"),
+			new Product("apm-agent-ruby", "APM Ruby Agent"),
+			new Product("apm-agent-rum-js", "APM RUM JS Agent"),
+			new Product("apm-agent-ios", "APM RUM React Agent"),
+		]),
 		new("auditbeat", "Auditbeat"),
 		new("beats", "Beats"),
 		new("cloud-control-ecctl", "Elastic Cloud Control ECCTL"),

src/Elastic.Documentation.Configuration/Serialization/YamlStaticContext.cs

@@ -14,4 +14,5 @@ namespace Elastic.Documentation.Configuration.Serialization;
 [YamlSerializable(typeof(PublishEnvironment))]
 [YamlSerializable(typeof(GoogleTagManager))]
 [YamlSerializable(typeof(ContentSource))]
+[YamlSerializable(typeof(VersionEntry))]
 public partial class YamlStaticContext;

src/Elastic.Documentation.Site/Assets/main.ts

@@ -11,6 +11,7 @@ import 'htmx-ext-preload'
 import 'htmx.org'
 import { $, $$ } from 'select-dom'
 import { UAParser } from 'ua-parser-js'
+import './web-components/VersionDropdown'
 
 const { getOS } = new UAParser()