starlight-theme-nova 0.9.1 → 0.9.3

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "starlight-theme-nova",
   "type": "module",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "",
   "author": "ocavue <ocavue@gmail.com>",
   "license": "MIT",
@@ -28,9 +28,9 @@
   "dependencies": {
     "@aria-ui/core": "^0.0.21",
     "@pagefind/default-ui": "^1.3.0",
-    "@shikijs/transformers": "^3.7.0",
-    "@shikijs/twoslash": "^3.7.0",
-    "@shikijs/types": "^3.7.0",
+    "@shikijs/transformers": "^3.9.1",
+    "@shikijs/twoslash": "^3.9.1",
+    "@shikijs/types": "^3.9.1",
     "@types/hast": "^3.0.4",
     "astro-theme-toggle": "^0.6.1",
     "hast-util-is-element": "^3.0.0",
@@ -47,17 +47,17 @@
     }
   },
   "devDependencies": {
-    "@astrojs/starlight": "^0.34.4",
+    "@astrojs/starlight": "^0.35.2",
     "@iconify-json/bxl": "^1.2.2",
-    "@iconify-json/logos": "^1.2.4",
-    "@iconify-json/lucide": "^1.2.54",
-    "@iconify-json/tabler": "^1.2.19",
+    "@iconify-json/logos": "^1.2.5",
+    "@iconify-json/lucide": "^1.2.59",
+    "@iconify-json/tabler": "^1.2.20",
     "@ocavue/tsconfig": "^0.3.7",
     "@types/node": "^20.17.30",
-    "@unocss/cli": "^66.1.3",
-    "astro": "^5.10.1",
+    "@unocss/cli": "^66.3.2",
+    "astro": "^5.12.7",
     "typescript": "^5.8.3",
-    "unocss": "^66.1.3",
+    "unocss": "^66.3.2",
     "unocss-preset-animations": "^1.2.1"
   },
   "scripts": {

package/src/components/Header.astro

@@ -9,30 +9,11 @@ import ThemeSelect from 'virtual:starlight/components/ThemeSelect'
 
 import options from 'virtual:starlight-theme-nova/user-config'
 import MobileMenuToggle from './MobileMenuToggle.astro'
+import { getI18nText } from './get-i18n-text'
 
 const nav = options.nav ?? []
 
-const { locale } = Astro.locals.starlightRoute
-
-const getLocalizedValue = (
-  value: string | { [local: string]: string },
-): string => {
-  if (typeof value === 'string') {
-    return value
-  }
-
-  if (typeof locale === 'string' && value[locale]) {
-    return value[locale]
-  }
-
-  // Use the same "root" convention as the Starlight docs to get the default value.
-  // https://github.com/withastro/starlight/blob/9d3ba179c5d524c1c61d771ceb1a7b4e754bee16/docs/src/content/docs/guides/i18n.mdx?plain=1#L72-L75
-  if (value['root']) {
-    return value['root']
-  }
-
-  return Object.values(value)[0] ?? ''
-}
+const route = Astro.locals.starlightRoute
 ---
 
 <div class="nova-header">
@@ -42,8 +23,8 @@ const getLocalizedValue = (
   <nav class="nova-header-nav">
     {
       nav.map((item) => (
-        <a class="nova-header-nav-link" href={getLocalizedValue(item.href)}>
-          {getLocalizedValue(item.label)}
+        <a class="nova-header-nav-link" href={getI18nText(item.href, route)}>
+          {getI18nText(item.label, route)}
         </a>
       ))
     }

package/src/components/PageFrame.astro

@@ -41,7 +41,7 @@ const { hasSidebar } = Astro.locals.starlightRoute
     .sidebar-content {
       height: 100%;
       min-height: max-content;
-      padding: 1rem var(--sl-sidebar-pad-x) 0;
+      padding: 1rem var(--sl-sidebar-pad-x) 1rem;
       flex-direction: column;
       gap: 1rem;
     }

package/src/components/get-i18n-text.ts

@@ -0,0 +1,45 @@
+import type { StarlightRouteData } from '@astrojs/starlight/route-data'
+import config from 'virtual:starlight/user-config'
+
+export function getI18nText(
+  value: string | Record<string, string>,
+  route: StarlightRouteData,
+): string {
+  if (typeof value === 'string') {
+    return value
+  }
+
+  const { lang, locale } = route
+
+  // Try `lang` first, which is a BCP-47 language tag
+  if (value[lang]) {
+    return value[lang]
+  }
+
+  // Use the same "root" convention as the Starlight docs to get the default value.
+  // https://github.com/withastro/starlight/blob/9d3ba179c5d524c1c61d771ceb1a7b4e754bee16/docs/src/content/docs/guides/i18n.mdx?plain=1#L72-L75
+  if (
+    config.defaultLocale.lang === lang ||
+    config.defaultLocale.locale === locale
+  ) {
+    if (value['root']) {
+      return value['root']
+    }
+  }
+
+  const message =
+    `[Astrobook] Unable to find the translation for language "${lang}".\n` +
+    `Are you using the correct BCP-47 language tag ` +
+    `(e.g. "en", "ar", or "zh-CN") in the following configuration?\n` +
+    JSON.stringify(value, null, 2) +
+    '\n'
+
+  // Fallback to the `locale`, which is a base path at which a language is
+  // served. This is not of the same format as the `lang` BCP-47 language tag.
+  if (locale && value[locale]) {
+    console.warn(message)
+    return value[locale]
+  }
+
+  throw new Error(message)
+}

package/src/user-options.ts

@@ -1,5 +1,13 @@
 export interface NavItem {
+  /**
+   * The visible label for this item in the navigation. It could be a string or
+   * a record of strings with the language code as the key.
+   */
   label: string | Record<string, string>
+  /**
+   * The link to this item’s content. It could be a string or a record of
+   * strings with the language code as the key.
+   */
   href: string | Record<string, string>
 }