From 80d1473d569f9942734c83aed46308fd436d3ef1 Mon Sep 17 00:00:00 2001
From: Jan Calanog <reakaleek@users.noreply.github.com>
Date: Fri, 18 Sep 2026 12:34:14 +0200
Subject: [PATCH 1/2] Mount Jump to API in the assembler API sidebar

API reference pages need the box. Markdown docs, isolated builds, and air-gapped layouts must not get it.

Co-Authored-By: Cursor Grok 4.6 <noreply@anthropic.com>
---
 docs/data/openapi/api-explorer.md             |  2 +
 .../_Partials/Layout/_ApiPagesNav.cshtml      | 42 ++++++++------
 .../web-components/loadWebComponents.ts       |  2 +
 .../ApiPagesNavRenderingTests.cs              | 55 ++++++++++++++++++-
 4 files changed, 84 insertions(+), 17 deletions(-)

diff --git a/docs/data/openapi/api-explorer.md b/docs/data/openapi/api-explorer.md
index 0f6d7154a4..0c5617db63 100644
--- a/docs/data/openapi/api-explorer.md
+++ b/docs/data/openapi/api-explorer.md
@@ -151,6 +151,8 @@ specs per product are not currently supported.
 
 Product pages show an API product switcher in the left navigation. The list includes every declared API and a Back to hub option.
 
+Assembler API pages also show a Jump to API box at the top of that sidebar. The box searches API operations only. Isolated and air-gapped builds omit the box. Markdown docs pages do not get it back.
+
 ## Remote spec resolution
 
 When `spec:` does not resolve to a file on disk, {{dbuild}} resolves the current (`main`) version
diff --git a/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml b/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
index 430c6a9917..e7d565cb47 100644
--- a/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
+++ b/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
@@ -4,26 +4,36 @@
 		id="pages-nav"
 		@(Model.Features.NavigationPreviewEnabled ? "hx-preserve" : "")
 		class="sidebar-nav h-full simple-scrollbar">
-		@if (Model.HubSwitcherItems.Count > 0)
+		@{
+			var showJumpToPage = Model.BuildType == BuildType.Assembler && !Model.Features.AirGappedEnabled;
+		}
+		@if (showJumpToPage || Model.HubSwitcherItems.Count > 0)
 		{
 			<div class="sticky top-0 z-10 bg-white px-4 pt-4 pb-2 flex flex-col gap-2">
-				<label for="api-hub-switcher" class="sr-only">API product</label>
-				<select
-					id="api-hub-switcher"
-					class="w-full border border-grey-20 rounded-sm font-sans font-semibold text-sm pl-3 pr-8 py-2 bg-white hover:border-grey-40 focus:outline-none focus:ring-2 focus:ring-blue-elastic-50 cursor-pointer"
-					onchange="window.location.href = this.value">
-					@foreach (var item in Model.HubSwitcherItems)
-					{
-						if (item.Selected)
-						{
-							<option value="@item.Url" selected>@item.Label</option>
-						}
-						else
+				@if (showJumpToPage)
+				{
+					<navigation-search type="api" placeholder="Jump to API"></navigation-search>
+				}
+				@if (Model.HubSwitcherItems.Count > 0)
+				{
+					<label for="api-hub-switcher" class="sr-only">API product</label>
+					<select
+						id="api-hub-switcher"
+						class="w-full border border-grey-20 rounded-sm font-sans font-semibold text-sm pl-3 pr-8 py-2 bg-white hover:border-grey-40 focus:outline-none focus:ring-2 focus:ring-blue-elastic-50 cursor-pointer"
+						onchange="window.location.href = this.value">
+						@foreach (var item in Model.HubSwitcherItems)
 						{
-							<option value="@item.Url">@item.Label</option>
+							if (item.Selected)
+							{
+								<option value="@item.Url" selected>@item.Label</option>
+							}
+							else
+							{
+								<option value="@item.Url">@item.Label</option>
+							}
 						}
-					}
-				</select>
+					</select>
+				}
 			</div>
 		}
 		<ul class="hidden md:flex items-center gap-4 px-4 pt-3">
diff --git a/src/Elastic.Documentation.Site/Assets/web-components/loadWebComponents.ts b/src/Elastic.Documentation.Site/Assets/web-components/loadWebComponents.ts
index 359c94d6ad..7ee078079f 100644
--- a/src/Elastic.Documentation.Site/Assets/web-components/loadWebComponents.ts
+++ b/src/Elastic.Documentation.Site/Assets/web-components/loadWebComponents.ts
@@ -35,6 +35,8 @@ export const loadWebComponents = createWebComponentLoader({
     'version-dropdown': () => import('./VersionDropdown'),
     'applies-to-popover': () => import('./AppliesToPopover'),
     'page-feedback': () => import('./PageFeedback'),
+    'navigation-search': () =>
+        import('./NavigationSearch/NavigationSearchComponent'),
     'diagnostics-panel': () => import('./Diagnostics/DiagnosticsComponent'),
     'storybook-story': () => import('./StorybookStory/StorybookStoryComponent'),
     'vector-sizing-calculator': () =>
diff --git a/tests/Elastic.ApiExplorer.Tests/ApiPagesNavRenderingTests.cs b/tests/Elastic.ApiExplorer.Tests/ApiPagesNavRenderingTests.cs
index 2548479386..0c11f20d46 100644
--- a/tests/Elastic.ApiExplorer.Tests/ApiPagesNavRenderingTests.cs
+++ b/tests/Elastic.ApiExplorer.Tests/ApiPagesNavRenderingTests.cs
@@ -85,12 +85,64 @@ public async Task Render_PreservesTheNavAcrossHtmxSwapsWhenPreviewEnabled()
 		html.Should().Contain("hx-preserve");
 	}
 
+	[Fact]
+	public async Task Render_ShowsJumpToPageOnAssemblerBuilds()
+	{
+		var model = CreateLayoutModel("/api/doc/elasticsearch/", "/api/doc/elasticsearch.md", buildType: BuildType.Assembler);
+
+		var html = await _ApiPagesNav.Create(model).RenderAsync(cancellationToken: TestContext.Current.CancellationToken);
+
+		html.Should().Contain("<navigation-search type=\"api\" placeholder=\"Jump to API\"></navigation-search>");
+	}
+
+	[Fact]
+	public async Task Render_ShowsJumpToPageWhenNavigationPreviewIsOn()
+	{
+		var model = CreateLayoutModel(
+			"/api/doc/elasticsearch/",
+			"/api/doc/elasticsearch.md",
+			features: new FeatureFlags(new Dictionary<string, bool> { ["navigation-preview"] = true }),
+			buildType: BuildType.Assembler
+		);
+
+		var html = await _ApiPagesNav.Create(model).RenderAsync(cancellationToken: TestContext.Current.CancellationToken);
+
+		html.Should().Contain("<navigation-search type=\"api\" placeholder=\"Jump to API\"></navigation-search>");
+		html.Should().Contain("hx-preserve");
+	}
+
+	[Fact]
+	public async Task Render_OmitsJumpToPageOnIsolatedBuilds()
+	{
+		var model = CreateLayoutModel("/api/doc/elasticsearch/", "/api/doc/elasticsearch.md", buildType: BuildType.Isolated);
+
+		var html = await _ApiPagesNav.Create(model).RenderAsync(cancellationToken: TestContext.Current.CancellationToken);
+
+		html.Should().NotContain("navigation-search");
+	}
+
+	[Fact]
+	public async Task Render_OmitsJumpToPageWhenAirGapped()
+	{
+		var model = CreateLayoutModel(
+			"/api/doc/elasticsearch/",
+			"/api/doc/elasticsearch.md",
+			features: new FeatureFlags(new Dictionary<string, bool> { ["air-gapped"] = true }),
+			buildType: BuildType.Assembler
+		);
+
+		var html = await _ApiPagesNav.Create(model).RenderAsync(cancellationToken: TestContext.Current.CancellationToken);
+
+		html.Should().NotContain("navigation-search");
+	}
+
 	private static ApiLayoutViewModel CreateLayoutModel(
 		string navigationUrl,
 		string markdownUrl,
 		IReadOnlyList<ApiVersionSwitcherItem>? versionSwitcherItems = null,
 		IReadOnlyList<ApiVersionSwitcherItem>? hubSwitcherItems = null,
-		FeatureFlags? features = null
+		FeatureFlags? features = null,
+		BuildType buildType = BuildType.Isolated
 	)
 	{
 		var fs = new FileSystem();
@@ -120,6 +172,7 @@ private static ApiLayoutViewModel CreateLayoutModel(
 			Breadcrumbs = ApiBreadcrumbTrail.Empty,
 			VersionSwitcherItems = versionSwitcherItems ?? [],
 			HubSwitcherItems = hubSwitcherItems ?? [],
+			BuildType = buildType,
 		};
 	}
 

From 68743454c2a5ebe5bb5972b4944e9a99dfe61c71 Mon Sep 17 00:00:00 2001
From: Jan Calanog <reakaleek@users.noreply.github.com>
Date: Tue, 22 Sep 2026 10:03:31 +0200
Subject: [PATCH 2/2] fix: precompute Jump to API visibility (per review by
 @github-actions)

The nav partial computed the flag in a decision block. The view now branches
on ShowJumpToPage, which the layout model already knows.

Co-Authored-By: Grok 4.7 <noreply@anthropic.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
---
 src/Elastic.ApiExplorer/Infrastructure/ApiViewModel.cs     | 4 ++++
 .../_Partials/Layout/_ApiPagesNav.cshtml                   | 7 ++-----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/Elastic.ApiExplorer/Infrastructure/ApiViewModel.cs b/src/Elastic.ApiExplorer/Infrastructure/ApiViewModel.cs
index 6ce5455f1a..c55959ed50 100644
--- a/src/Elastic.ApiExplorer/Infrastructure/ApiViewModel.cs
+++ b/src/Elastic.ApiExplorer/Infrastructure/ApiViewModel.cs
@@ -28,6 +28,10 @@ public record ApiLayoutViewModel : GlobalLayoutViewModel
 	public required ApiBreadcrumbTrail Breadcrumbs { get; init; }
 	public IReadOnlyList<ApiVersionSwitcherItem> VersionSwitcherItems { get; init; } = [];
 	public IReadOnlyList<ApiVersionSwitcherItem> HubSwitcherItems { get; init; } = [];
+
+	/// <summary>Assembler builds host Jump to API unless the site is air-gapped.</summary>
+	public bool ShowJumpToPage => BuildType == BuildType.Assembler && !Features.AirGappedEnabled;
+
 	public required string MarkdownUrl { get; init; }
 
 	/// <summary>
diff --git a/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml b/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
index e7d565cb47..f84ad301c6 100644
--- a/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
+++ b/src/Elastic.ApiExplorer/_Partials/Layout/_ApiPagesNav.cshtml
@@ -4,13 +4,10 @@
 		id="pages-nav"
 		@(Model.Features.NavigationPreviewEnabled ? "hx-preserve" : "")
 		class="sidebar-nav h-full simple-scrollbar">
-		@{
-			var showJumpToPage = Model.BuildType == BuildType.Assembler && !Model.Features.AirGappedEnabled;
-		}
-		@if (showJumpToPage || Model.HubSwitcherItems.Count > 0)
+		@if (Model.ShowJumpToPage || Model.HubSwitcherItems.Count > 0)
 		{
 			<div class="sticky top-0 z-10 bg-white px-4 pt-4 pb-2 flex flex-col gap-2">
-				@if (showJumpToPage)
+				@if (Model.ShowJumpToPage)
 				{
 					<navigation-search type="api" placeholder="Jump to API"></navigation-search>
 				}