From dc53086c1e73d43d3a28fc4cdf161e83d09b1877 Mon Sep 17 00:00:00 2001
From: Adam <2363879+adamdotdevin@users.noreply.github.com>
Date: Mon, 9 Feb 2026 11:34:35 -0600
Subject: wip(docs): i18n (#12681)

---
 packages/web/src/components/Header.astro | 228 ++++++++++++++++---------------
 1 file changed, 118 insertions(+), 110 deletions(-)

(limited to 'packages/web/src/components/Header.astro')

diff --git a/packages/web/src/components/Header.astro b/packages/web/src/components/Header.astro
index 396200a3e..bb13c9117 100644
--- a/packages/web/src/components/Header.astro
+++ b/packages/web/src/components/Header.astro
@@ -1,128 +1,136 @@
 ---
-import config from '../../config.mjs';
-import astroConfig from 'virtual:starlight/user-config';
-import { Icon } from '@astrojs/starlight/components';
-import { HeaderLinks } from 'toolbeam-docs-theme/components';
-import Default from 'toolbeam-docs-theme/overrides/Header.astro';
-import SocialIcons from 'virtual:starlight/components/SocialIcons';
-import SiteTitle from '@astrojs/starlight/components/SiteTitle.astro';
+import config from "../../config.mjs"
+import astroConfig from "virtual:starlight/user-config"
+import { getRelativeLocaleUrl } from "astro:i18n"
+import { Icon } from "@astrojs/starlight/components"
+import Default from "toolbeam-docs-theme/overrides/Header.astro"
+import SiteTitle from "@astrojs/starlight/components/SiteTitle.astro"
 
-const path = Astro.url.pathname;
-
-const links = astroConfig.social || [];
-const headerLinks = config.headerLinks;
+const path = Astro.url.pathname
+const locale = Astro.currentLocale || "root"
+const route = Astro.locals.starlightRoute
+const t = Astro.locals.t as (key: string) => string
+const links = astroConfig.social || []
+const headerLinks = config.headerLinks
+const sharePath = /\/s(\/|$)/.test(path)
 
+function href(url: string) {
+  if (url === "/" || url === "/docs" || url === "/docs/") {
+    return getRelativeLocaleUrl(locale, "")
+  }
+  return url
+}
 ---
 
-{ path.startsWith("/s")
-? <div class="header sl-flex">
-	<div class="title-wrapper sl-flex">
-		<SiteTitle {...Astro.props} />
-	</div>
-	<div class="middle-group sl-flex">
-		{
-		  headerLinks?.map(({ name, url }) => (
-		    <a class="links" href={url}>{name}</a>
-		  ))
-		}
-	</div>
-	<div class="sl-hidden md:sl-flex right-group">
-		{
-			links.length > 0 && (
-				<div class="sl-flex social-icons">
-					{links.map(({ href, icon }) => (
-						<a {href} rel="me" target="_blank">
-							<Icon name={icon} size="1rem" />
-						</a>
-					))}
-				</div>
-			)
-		}
-	</div>
-</div>
-  : <Default {...Astro.props}><slot /></Default>
-}
+{sharePath ? (
+  <div class="header sl-flex">
+    <div class="title-wrapper sl-flex">
+      <SiteTitle {...route} />
+    </div>
+    <div class="middle-group sl-flex">
+      {headerLinks?.map(({ name, url }) => (
+        <a class="links" href={href(url)}>{t(name)}</a>
+      ))}
+    </div>
+    <div class="sl-hidden md:sl-flex right-group">
+      {links.length > 0 && (
+        <div class="sl-flex social-icons">
+          {links.map(({ href, icon }) => (
+            <a {href} rel="me" target="_blank">
+              <Icon name={icon} size="1rem" />
+            </a>
+          ))}
+        </div>
+      )}
+    </div>
+  </div>
+) : (
+  <Default {...route} />
+)}
+
 <style>
-	.header {
-		gap: var(--sl-nav-gap);
-		justify-content: space-between;
-		align-items: center;
-		height: 100%;
-	}
+  .header {
+    gap: var(--sl-nav-gap);
+    justify-content: space-between;
+    align-items: center;
+    height: 100%;
+  }
 
-	.title-wrapper {
-		/* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
-		overflow: clip;
-		/* Avoid clipping focus ring around link inside title wrapper. */
+  .title-wrapper {
+    /* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
+    overflow: clip;
+    /* Avoid clipping focus ring around link inside title wrapper. */
     padding: calc(0.25rem + 2px) 0.25rem calc(0.25rem - 2px);
-		margin: -0.25rem;
-	}
+    margin: -0.25rem;
+  }
 
-	.middle-group {
-		justify-content: flex-end;
-		gap: var(--sl-nav-gap);
-	}
-	@media (max-width: 50rem) {
-		:global(:root[data-has-sidebar]) {
-			.middle-group {
-				display: none;
-			}
-		}
-	}
-	@media (min-width: 50rem) {
-		.middle-group {
-			display: flex;
-		}
-	}
+  .middle-group {
+    justify-content: flex-end;
+    gap: var(--sl-nav-gap);
+  }
 
-	.right-group,
-	.social-icons {
-		gap: 1rem;
-		align-items: center;
+  @media (max-width: 50rem) {
+    :global(:root[data-has-sidebar]) {
+      .middle-group {
+        display: none;
+      }
+    }
+  }
+
+  @media (min-width: 50rem) {
+    .middle-group {
+      display: flex;
+    }
+  }
+
+  .right-group,
+  .social-icons {
+    gap: 1rem;
+    align-items: center;
 
     a {
-          line-height: 1;
+      line-height: 1;
 
-          svg {
-              color: var(--sl-color-text-dimmed);
-          }
+      svg {
+        color: var(--sl-color-text-dimmed);
       }
-  a.links {
-		text-transform: uppercase;
-    font-size: var(--sl-text-sm);
-    color: var(--sl-color-text-secondary);
-    line-height: normal;
+    }
+
+    a.links {
+      text-transform: uppercase;
+      font-size: var(--sl-text-sm);
+      color: var(--sl-color-text-secondary);
+      line-height: normal;
+    }
   }
-	}
 
-	@media (min-width: 50rem) {
-		:global(:root[data-has-sidebar]) {
-			--__sidebar-pad: calc(2 * var(--sl-nav-pad-x));
-		}
-		:global(:root:not([data-has-toc])) {
-			--__toc-width: 0rem;
-		}
-		.header {
-			--__sidebar-width: max(0rem, var(--sl-content-inline-start, 0rem) - var(--sl-nav-pad-x));
-			--__main-column-fr: calc(
-				(
-						100% + var(--__sidebar-pad, 0rem) - var(--__toc-width, var(--sl-sidebar-width)) -
-							(2 * var(--__toc-width, var(--sl-nav-pad-x))) - var(--sl-content-inline-start, 0rem) -
-							var(--sl-content-width)
-					) / 2
-			);
-			display: grid;
-			grid-template-columns:
+  @media (min-width: 50rem) {
+    :global(:root[data-has-sidebar]) {
+      --__sidebar-pad: calc(2 * var(--sl-nav-pad-x));
+    }
+
+    :global(:root:not([data-has-toc])) {
+      --__toc-width: 0rem;
+    }
+
+    .header {
+      --__sidebar-width: max(0rem, var(--sl-content-inline-start, 0rem) - var(--sl-nav-pad-x));
+      --__main-column-fr: calc(
+        (
+            100% + var(--__sidebar-pad, 0rem) - var(--__toc-width, var(--sl-sidebar-width)) -
+              (2 * var(--__toc-width, var(--sl-nav-pad-x))) - var(--sl-content-inline-start, 0rem) -
+              var(--sl-content-width)
+          ) / 2
+      );
+      display: grid;
+      grid-template-columns:
         /* 1 (site title): runs up until the main content column’s left edge or the width of the title, whichever is the largest  */
-				minmax(
-					calc(var(--__sidebar-width) + max(0rem, var(--__main-column-fr) - var(--sl-nav-gap))),
-					auto
-				)
-				/* 2 (search box): all free space that is available. */
-				1fr
-				/* 3 (right items): use the space that these need. */
-				auto;
-			align-content: center;
-		}
-	}
+        minmax(calc(var(--__sidebar-width) + max(0rem, var(--__main-column-fr) - var(--sl-nav-gap))), auto)
+        /* 2 (search box): all free space that is available. */
+        1fr
+        /* 3 (right items): use the space that these need. */
+        auto;
+      align-content: center;
+    }
+  }
 </style>
-- 
cgit v1.2.3