@astrojs/starlight 0.0.1

package/layout/PageFrame.astro

@@ -0,0 +1,88 @@
+---
+import MobileMenuToggle from '../components/MobileMenuToggle.astro';
+
+const hasSidebar = Astro.slots.has('sidebar');
+---
+
+<div class:list={['page', { hasSidebar }]}>
+  <header class="header"><slot name="header" /></header>
+  {
+    hasSidebar && (
+      <nav class="sidebar" aria-label="Main">
+        <MobileMenuToggle />
+        <div id="starlight__sidebar" class="sidebar-pane">
+          <div class="sidebar-content">
+            <slot name="sidebar" />
+          </div>
+        </div>
+      </nav>
+    )
+  }
+  <div class="main-frame"><slot /></div>
+</div>
+
+<style>
+  .page {
+    display: flex;
+    flex-direction: column;
+    min-height: 100vh;
+  }
+
+  .header {
+    z-index: var(--sl-z-index-navbar);
+    position: fixed;
+    inset-inline-start: 0;
+    inset-block-start: 0;
+    width: 100%;
+    height: var(--sl-nav-height);
+    border-bottom: 1px solid var(--sl-color-hairline-shade);
+    padding: var(--sl-nav-pad-y) var(--sl-nav-pad-x);
+    padding-inline-end: var(--sl-nav-pad-x);
+    background-color: var(--sl-color-bg-nav);
+  }
+
+  .hasSidebar .header {
+    padding-inline-end: calc(
+      var(--sl-nav-gap) + var(--sl-nav-pad-x) + var(--sl-menu-button-size)
+    );
+  }
+
+  .sidebar-pane {
+    visibility: var(--sl-sidebar-visibility, hidden);
+    position: fixed;
+    inset-block: 0;
+    inset-inline-start: 0;
+    padding-top: var(--sl-nav-height);
+    width: 100%;
+    background-color: var(--sl-color-black);
+  }
+
+  :global([aria-expanded='true']) ~ .sidebar-pane {
+    --sl-sidebar-visibility: visible;
+  }
+
+  .sidebar-content {
+    height: 100%;
+    overflow-y: auto;
+  }
+
+  .main-frame {
+    padding-top: var(--sl-nav-height);
+  }
+
+  @media (min-width: 50rem) {
+    .hasSidebar .header {
+      padding-inline-end: var(--sl-nav-pad-x);
+    }
+    .sidebar-pane {
+      --sl-sidebar-visibility: visible;
+      width: var(--sl-sidebar-width);
+      background-color: var(--sl-color-bg-sidebar);
+      border-inline-end: 1px solid var(--sl-color-hairline-shade);
+    }
+
+    .hasSidebar .main-frame {
+      padding-inline-start: var(--sl-sidebar-width);
+    }
+  }
+</style>

package/layout/TwoColumnContent.astro

@@ -0,0 +1,42 @@
+<div class="container">
+  <aside class="right-sidebar-container">
+    <div class="right-sidebar"><slot name="right-sidebar" /></div>
+  </aside>
+  <div class="main-pane"><slot /></div>
+</div>
+
+<style>
+  @media (min-width: 72rem) {
+    .container {
+      display: flex;
+    }
+
+    .right-sidebar-container {
+      order: 2;
+      position: relative;
+      width: calc(
+        var(--sl-sidebar-width) +
+          (100% - var(--sl-content-width) - var(--sl-sidebar-width)) / 2
+      );
+    }
+
+    .right-sidebar {
+      position: fixed;
+      top: 0;
+      border-inline-start: 1px solid var(--sl-color-gray-6);
+      padding-top: var(--sl-nav-height);
+      width: 100%;
+      height: 100vh;
+      overflow-y: auto;
+      scrollbar-width: none;
+    }
+
+    .main-pane {
+      order: 1;
+      width: calc(
+        var(--sl-content-width) +
+          (100% - var(--sl-content-width) - var(--sl-sidebar-width)) / 2
+      );
+    }
+  }
+</style>

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@astrojs/starlight",
+  "version": "0.0.1",
+  "description": "Build beautiful, high-performance documentation websites with Astro",
+  "keywords": [
+    "docs",
+    "documentation",
+    "astro",
+    "withastro"
+  ],
+  "author": "Chris Swithinbank <swithinbank@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": "./index.ts",
+    "./schema": "./schema.ts",
+    "./types": "./types.ts",
+    "./index.astro": "./index.astro",
+    "./404.astro": "./404.astro"
+  },
+  "peerDependencies": {
+    "astro": "^2.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^18.15.11",
+    "astro": "^2.4.3"
+  },
+  "dependencies": {
+    "@astrojs/mdx": "^0.19.1",
+    "@pagefind/default-ui": "^0.12.0",
+    "@types/mdast": "^3.0.11",
+    "bcp-47": "^2.1.0",
+    "execa": "^7.1.1",
+    "hastscript": "^7.2.0",
+    "pagefind": "^0.12.0",
+    "remark-directive": "^2.0.1",
+    "unified": "^10.1.2",
+    "unist-util-remove": "^3.1.1",
+    "unist-util-visit": "^4.1.2"
+  },
+  "scripts": {}
+}

package/schema.ts

@@ -0,0 +1,23 @@
+import { z } from 'astro:content';
+
+export function docsSchema() {
+  return z.object({
+    /** The title of the current page. Required. */
+    title: z.string(),
+
+    /**
+     * A short description of the current page’s content. Optional, but recommended.
+     * A good description is 150–160 characters long and outlines the key content
+     * of the page in a clear and engaging way.
+     */
+    description: z.string().optional(),
+
+    /**
+     * Custom URL where a reader can edit this page.
+     * Overrides the `editLink.baseUrl` global config if set.
+     *
+     * Can also be set to `false` to disable showing an edit link on this page.
+     */
+    editUrl: z.union([z.string().url(), z.boolean()]).optional().default(true),
+  });
+}

package/style/asides.css

@@ -0,0 +1,49 @@
+.starlight-aside {
+  padding: 1rem;
+  border-inline-start: 0.25rem solid;
+  color: var(--sl-color-white);
+}
+.starlight-aside--note {
+  --sl-color-asides-text-accent: var(--sl-color-blue-high);
+  border-color: var(--sl-color-blue);
+  background-color: var(--sl-color-blue-low);
+}
+.starlight-aside--tip {
+  --sl-color-asides-text-accent: var(--sl-color-purple-high);
+  border-color: var(--sl-color-purple);
+  background-color: var(--sl-color-purple-low);
+}
+.starlight-aside--caution {
+  --sl-color-asides-text-accent: var(--sl-color-orange-high);
+  border-color: var(--sl-color-orange);
+  background-color: var(--sl-color-orange-low);
+}
+.starlight-aside--danger {
+  --sl-color-asides-text-accent: var(--sl-color-red-high);
+  border-color: var(--sl-color-red);
+  background-color: var(--sl-color-red-low);
+}
+
+.starlight-aside__title {
+  display: flex;
+  gap: 0.5rem;
+  align-items: center;
+  font-size: var(--sl-text-h5);
+  font-weight: 600;
+  line-height: var(--sl-line-height-headings);
+  color: var(--sl-color-asides-text-accent);
+}
+
+.starlight-aside__icon {
+  font-size: 1.333em;
+  width: 1em;
+  height: 1em;
+}
+
+.starlight-aside__title + .starlight-aside__content {
+  margin-top: 0.5rem;
+}
+
+.starlight-aside__content a {
+  color: var(--sl-color-asides-text-accent);
+}

package/style/props.css

@@ -0,0 +1,197 @@
+:root,
+::backdrop {
+  /* Colors (dark mode) */
+  --sl-color-white: hsl(0, 0%, 100%); /* “white” */
+  --sl-color-gray-1: hsl(231, 23%, 94%);
+  --sl-color-gray-2: hsl(228, 8%, 77%);
+  --sl-color-gray-3: hsl(221, 8%, 56%);
+  --sl-color-gray-4: hsl(225, 9%, 36%);
+  --sl-color-gray-5: hsl(222, 11%, 23%);
+  --sl-color-gray-6: hsl(222, 13%, 16%);
+  --sl-color-black: hsl(223, 13%, 10%);
+
+  --sl-hue-orange: 41;
+  --sl-color-orange-low: hsl(var(--sl-hue-orange), 39%, 22%);
+  --sl-color-orange: hsl(var(--sl-hue-orange), 82%, 63%);
+  --sl-color-orange-high: hsl(var(--sl-hue-orange), 82%, 87%);
+  --sl-hue-green: 101;
+  --sl-color-green-low: hsl(var(--sl-hue-green), 39%, 22%);
+  --sl-color-green: hsl(var(--sl-hue-green), 82%, 63%);
+  --sl-color-green-high: hsl(var(--sl-hue-green), 82%, 87%);
+  --sl-hue-blue: 234;
+  --sl-color-blue-low: hsl(var(--sl-hue-blue), 54%, 20%);
+  --sl-color-blue: hsl(var(--sl-hue-blue), 100%, 60%);
+  --sl-color-blue-high: hsl(var(--sl-hue-blue), 100%, 87%);
+  --sl-hue-purple: 281;
+  --sl-color-purple-low: hsl(var(--sl-hue-purple), 39%, 22%);
+  --sl-color-purple: hsl(var(--sl-hue-purple), 82%, 63%);
+  --sl-color-purple-high: hsl(var(--sl-hue-purple), 82%, 89%);
+  --sl-hue-red: 339;
+  --sl-color-red-low: hsl(var(--sl-hue-red), 39%, 22%);
+  --sl-color-red: hsl(var(--sl-hue-red), 82%, 63%);
+  --sl-color-red-high: hsl(var(--sl-hue-red), 82%, 87%);
+
+  --sl-hue-accent: var(--sl-hue-blue);
+  --sl-color-accent-low: hsl(var(--sl-hue-accent), 54%, 20%);
+  --sl-color-accent: hsl(var(--sl-hue-accent), 100%, 60%);
+  --sl-color-accent-high: hsl(var(--sl-hue-accent), 100%, 87%);
+
+  --sl-color-text: var(--sl-color-gray-2);
+  --sl-color-text-accent: var(--sl-color-accent-high);
+  --sl-color-text-invert: var(--sl-color-accent-low);
+  --sl-color-bg: var(--sl-color-black);
+  --sl-color-bg-nav: var(--sl-color-gray-6);
+  --sl-color-bg-sidebar: var(--sl-color-gray-6);
+  --sl-color-bg-inline-code: var(--sl-color-gray-5);
+  --sl-color-hairline: var(--sl-color-gray-6);
+  --sl-color-hairline-shade: var(--sl-color-black);
+
+  --sl-color-backdrop-overlay: hsla(223, 13%, 10%, 0.66);
+
+  /* Shadows (dark mode) */
+  --sl-shadow-sm: 0px 1px 1px hsla(0, 0%, 0%, 0.12),
+    0px 2px 1px hsla(0, 0%, 0%, 0.24);
+  --sl-shadow-md: 0px 8px 4px hsla(0, 0%, 0%, 0.08),
+    0px 5px 2px hsla(0, 0%, 0%, 0.08), 0px 3px 2px hsla(0, 0%, 0%, 0.12),
+    0px 1px 1px hsla(0, 0%, 0%, 0.15);
+  --sl-shadow-lg: 0px 25px 7px hsla(0, 0%, 0%, 0.03),
+    0px 16px 6px hsla(0, 0%, 0%, 0.1), 0px 9px 5px hsla(223, 13%, 10%, 0.33),
+    0px 4px 4px hsla(0, 0%, 0%, 0.75), 0px 4px 2px hsla(0, 0%, 0%, 0.25);
+
+  /* Gradients (unchanged across dark & light modes) */
+  --sl-gradient-blue-purple: linear-gradient(
+    to bottom,
+    hsl(234, 100%, 59.8%) 0%,
+    hsl(281, 82.1%, 62.7%) 100%
+  );
+  --sl-gradient-red-pink: linear-gradient(
+    to bottom,
+    hsl(0, 67.9%, 52.4%) 0%,
+    hsl(295, 100%, 62.7%) 100%
+  );
+  --sl-gradient-orange-yellow: linear-gradient(
+    to bottom,
+    hsl(54, 93.5%, 57.6%) 0%,
+    hsl(14, 100%, 66.5%) 100%
+  );
+  --sl-gradient-blue-green: linear-gradient(
+    to bottom,
+    hsl(165, 86.6%, 62%) 0%,
+    hsl(227, 58.4%, 44.3%) 100%
+  );
+
+  /* Text size and line height */
+  --sl-text-xs: 0.8125rem; /* 13px */
+  --sl-text-sm: 0.875rem; /* 14px */
+  --sl-text-base: 1rem; /* 16px */
+  --sl-text-lg: 1.125rem; /* 18px */
+  --sl-text-xl: 1.25rem; /* 20px */
+  --sl-text-2xl: 1.5rem; /* 24px */
+  --sl-text-3xl: 1.8125rem; /* 29px */
+  --sl-text-4xl: 2.1875rem; /* 35px */
+  --sl-text-5xl: 2.625rem; /* 42px */
+
+  --sl-text-body: var(--sl-text-base);
+  --sl-text-body-sm: var(--sl-text-xs);
+  --sl-text-code: var(--sl-text-base);
+  --sl-text-code-sm: var(--sl-text-xs);
+  --sl-text-h1: var(--sl-text-4xl);
+  --sl-text-h2: var(--sl-text-3xl);
+  --sl-text-h3: var(--sl-text-2xl);
+  --sl-text-h4: var(--sl-text-xl);
+  --sl-text-h5: var(--sl-text-lg);
+
+  --sl-line-height: 1.8;
+  --sl-line-height-headings: 1.2;
+
+  --sl-font-system: ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+    'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans', sans-serif,
+    'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+  --sl-font-system-mono: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas,
+    'Liberation Mono', 'Courier New', monospace;
+  --__sb-font: var(--sl-font, ''), var(--sl-font-system);
+  --__sb-font-mono: var(--sl-font-mono, ''), var(--sl-font-system-mono);
+
+  /** Key layout values */
+  --sl-nav-height: 4rem;
+  --sl-nav-pad-x: 1.5rem;
+  --sl-nav-pad-y: 0.75rem;
+  --sl-sidebar-width: 18.75rem;
+  --sl-sidebar-pad-x: 1rem;
+  --sl-content-width: 45rem;
+  --sl-content-pad-x: 1rem;
+  --sl-menu-button-size: 2rem;
+  --sl-nav-gap: var(--sl-content-pad-x);
+
+  /* Global z-index values */
+  --sl-z-index-navbar: 10;
+  --sl-z-index-skiplink: 20;
+}
+
+:root[data-theme='light'],
+[data-theme='light'] ::backdrop {
+  /* Colours (light mode) */
+  --sl-color-white: hsl(223, 13%, 10%);
+  --sl-color-gray-1: hsl(222, 13%, 16%);
+  --sl-color-gray-2: hsl(222, 11%, 23%);
+  --sl-color-gray-3: hsl(225, 9%, 36%);
+  --sl-color-gray-4: hsl(221, 8%, 56%);
+  --sl-color-gray-5: hsl(228, 8%, 77%);
+  --sl-color-gray-6: hsl(231, 23%, 94%);
+  --sl-color-gray-7: hsl(240, 20%, 97%);
+  --sl-color-black: hsl(0, 0%, 100%);
+
+  --sl-color-orange-high: hsl(var(--sl-hue-orange), 80%, 25%);
+  --sl-color-orange: hsl(var(--sl-hue-orange), 90%, 60%);
+  --sl-color-orange-low: hsl(var(--sl-hue-orange), 90%, 88%);
+  --sl-color-green-high: hsl(var(--sl-hue-green), 80%, 22%);
+  --sl-color-green: hsl(var(--sl-hue-green), 90%, 60%);
+  --sl-color-green-low: hsl(var(--sl-hue-green), 85%, 90%);
+  --sl-color-blue-high: hsl(var(--sl-hue-blue), 80%, 30%);
+  --sl-color-blue: hsl(var(--sl-hue-blue), 90%, 60%);
+  --sl-color-blue-low: hsl(var(--sl-hue-blue), 88%, 90%);
+  --sl-color-purple-high: hsl(var(--sl-hue-purple), 39%, 30%);
+  --sl-color-purple: hsl(var(--sl-hue-purple), 90%, 60%);
+  --sl-color-purple-low: hsl(var(--sl-hue-purple), 80%, 90%);
+  --sl-color-red-high: hsl(var(--sl-hue-red), 80%, 30%);
+  --sl-color-red: hsl(var(--sl-hue-red), 90%, 60%);
+  --sl-color-red-low: hsl(var(--sl-hue-red), 80%, 90%);
+
+  --sl-color-accent-high: hsl(var(--sl-hue-accent), 80%, 30%);
+  --sl-color-accent: hsl(var(--sl-hue-accent), 90%, 60%);
+  --sl-color-accent-low: hsl(var(--sl-hue-accent), 88%, 90%);
+
+  --sl-color-text-accent: var(--sl-color-accent);
+  --sl-color-text-invert: var(--sl-color-black);
+  --sl-color-bg-nav: var(--sl-color-gray-7);
+  --sl-color-bg-sidebar: var(--sl-color-bg);
+  --sl-color-bg-inline-code: var(--sl-color-gray-6);
+  --sl-color-hairline-shade: var(--sl-color-gray-6);
+
+  --sl-color-backdrop-overlay: hsla(225, 9%, 36%, 0.66);
+
+  /* Shadows (light mode) */
+  --sl-shadow-sm: 0px 1px 1px hsla(0, 0%, 0%, 0.06),
+    0px 2px 1px hsla(0, 0%, 0%, 0.06);
+  --sl-shadow-md: 0px 8px 4px hsla(0, 0%, 0%, 0.03),
+    0px 5px 2px hsla(0, 0%, 0%, 0.03), 0px 3px 2px hsla(0, 0%, 0%, 0.06),
+    0px 1px 1px hsla(0, 0%, 0%, 0.06);
+  --sl-shadow-lg: 0px 25px 7px rgba(0, 0, 0, 0.01),
+    0px 16px 6px hsla(0, 0%, 0%, 0.03), 0px 9px 5px hsla(223, 13%, 10%, 0.08),
+    0px 4px 4px hsla(0, 0%, 0%, 0.16), 0px 4px 2px hsla(0, 0%, 0%, 0.04);
+}
+
+@media (min-width: 50em) {
+  :root {
+    --sl-text-h1: var(--sl-text-5xl);
+    --sl-text-h2: var(--sl-text-4xl);
+    --sl-text-h3: var(--sl-text-3xl);
+    --sl-text-h4: var(--sl-text-2xl);
+  }
+}
+
+@media (min-width: 72rem) {
+  :root {
+    --sl-content-pad-x: 1.5rem;
+  }
+}

package/style/reset.css

@@ -0,0 +1,43 @@
+*,
+*::before,
+*::after {
+  box-sizing: border-box;
+}
+
+* {
+  margin: 0;
+}
+
+html {
+  color-scheme: dark;
+  accent-color: var(--sl-color-accent);
+}
+
+html[data-theme='light'] {
+  color-scheme: light;
+}
+
+body {
+  font-family: var(--__sb-font);
+  line-height: var(--sl-line-height);
+  -webkit-font-smoothing: antialiased;
+  color: var(--sl-color-text);
+  background-color: var(--sl-color-bg);
+}
+
+input,
+button,
+textarea,
+select {
+  font: inherit;
+}
+
+p,
+h1,
+h2,
+h3,
+h4,
+h5,
+h6 {
+  overflow-wrap: break-word;
+}

package/style/shiki.css

@@ -0,0 +1,13 @@
+:root {
+  --astro-code-color-text: var(--sl-color-white);
+  --astro-code-color-background: var(--sl-color-gray-6);
+  --astro-code-token-constant: var(--sl-color-blue-high);
+  --astro-code-token-string: var(--sl-color-green-high);
+  --astro-code-token-comment: var(--sl-color-gray-2);
+  --astro-code-token-keyword: var(--sl-color-purple-high);
+  --astro-code-token-parameter: var(--sl-color-red-high);
+  --astro-code-token-function: var(--sl-color-red-high);
+  --astro-code-token-string-expression: var(--sl-color-green-high);
+  --astro-code-token-punctuation: var(--sl-color-gray-2);
+  --astro-code-token-link: var(--sl-color-blue-high);
+}

package/style/util.css

@@ -0,0 +1,32 @@
+.sr-only {
+  position: absolute;
+  width: 1px;
+  height: 1px;
+  padding: 0;
+  margin: -1px;
+  overflow: hidden;
+  clip: rect(0, 0, 0, 0);
+  white-space: nowrap;
+  border-width: 0;
+}
+
+.hidden {
+  display: none;
+}
+.flex {
+  display: flex;
+}
+.block {
+  display: block;
+}
+@media (min-width: 50rem) {
+  .md\:hidden {
+    display: none;
+  }
+  .md\:flex {
+    display: flex;
+  }
+  .md\:block {
+    display: block;
+  }
+}

package/types.ts

@@ -0,0 +1 @@
+export { StarlightConfig } from './utils/user-config';

package/utils/git.ts

@@ -0,0 +1,96 @@
+/**
+ * Heavily inspired by
+ * https://github.com/facebook/docusaurus/blob/46d2aa231ddb18ed67311b6195260af46d7e8bdc/packages/docusaurus-utils/src/gitUtils.ts
+ *
+ * Copyright (c) Facebook, Inc. and its affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+import path from 'node:path';
+import { execaSync } from 'execa';
+
+/** Custom error thrown when git is not found in `PATH`. */
+class GitNotFoundError extends Error {}
+
+/** Custom error thrown when the current file is not tracked by git. */
+class FileNotTrackedError extends Error {}
+
+/**
+ * Fetches the git history of a file and returns a relevant commit date.
+ * It gets the commit date instead of author date so that amended commits
+ * can have their dates updated.
+ *
+ * @throws {GitNotFoundError} If git is not found in `PATH`.
+ * @throws {FileNotTrackedError} If the current file is not tracked by git.
+ * @throws Also throws when `git log` exited with non-zero, or when it outputs
+ * unexpected text.
+ */
+export function getFileCommitDate(
+  file: string,
+  age: 'oldest' | 'newest' = 'oldest'
+): {
+  date: Date;
+  timestamp: number;
+} {
+  try {
+    const { stdout } = execaSync('which', ['git']);
+    if (!stdout) {
+      throw new GitNotFoundError(
+        `Failed to retrieve git history for "${file}" because git is not installed.`
+      );
+    }
+  } catch {}
+
+  try {
+    const { stdout } = execaSync('test', ['-f', file]);
+    if (!stdout) {
+      throw new Error(
+        `Failed to retrieve git history for "${file}" because the file does not exist.`
+      );
+    }
+  } catch {}
+
+  const result = execaSync(
+    'git',
+    [
+      'log',
+      `--format=%ct`,
+      '--max-count=1',
+      ...(age === 'oldest' ? ['--follow', '--diff-filter=A'] : []),
+      '--',
+      path.basename(file),
+    ],
+    {
+      cwd: path.dirname(file),
+    }
+  );
+  if (result.exitCode !== 0) {
+    throw new Error(
+      `Failed to retrieve the git history for file "${file}" with exit code ${result.exitCode}: ${result.stderr}`
+    );
+  }
+  let regex = /^(?<timestamp>\d+)$/;
+
+  const output = result.stdout.trim();
+
+  if (!output) {
+    throw new FileNotTrackedError(
+      `Failed to retrieve the git history for file "${file}" because the file is not tracked by git.`
+    );
+  }
+
+  const match = output.match(regex);
+
+  if (!match) {
+    throw new Error(
+      `Failed to retrieve the git history for file "${file}" with unexpected output: ${output}`
+    );
+  }
+
+  const timestamp = Number(match.groups!.timestamp);
+  const date = new Date(timestamp * 1000);
+
+  return { date, timestamp };
+}

package/utils/localizedUrl.ts

@@ -0,0 +1,32 @@
+import config from 'virtual:starlight/user-config';
+
+/**
+ * Get the equivalent of the passed URL for the passed locale.
+ */
+export function localizedUrl(url: URL, locale: string | undefined): URL {
+  // Create a new URL object to void mutating the global.
+  url = new URL(url);
+  if (!config.locales) {
+    // i18n is not configured on this site, no localization required.
+    return url;
+  }
+  if (locale === 'root') locale = '';
+  /** Base URL with trailing `/` stripped. */
+  const base = import.meta.env.BASE_URL.replace(/\/$/, '');
+  const hasBase = url.pathname.startsWith(base);
+  // Temporarily remove base to simplify
+  if (hasBase) url.pathname = url.pathname.replace(base, '');
+  const [_leadingSlash, baseSegment] = url.pathname.split('/');
+  if (baseSegment && baseSegment in config.locales) {
+    // We’re in a localized route, substitute the new locale (or strip for root lang).
+    url.pathname = locale
+      ? url.pathname.replace(baseSegment, locale)
+      : url.pathname.replace('/' + baseSegment, '');
+  } else if (locale) {
+    // We’re in the root language. Inject the new locale if we have one.
+    url.pathname = '/' + locale + url.pathname;
+  }
+  // Restore base
+  if (hasBase) url.pathname = base + url.pathname;
+  return url;
+}