@astrojs/starlight 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # @astrojs/starlight
 
+## 0.4.0
+
+### Minor Changes
+
+- [#259](https://github.com/withastro/starlight/pull/259) [`8102389`](https://github.com/withastro/starlight/commit/810238934ae1a95c53042ca2875bb4033aad0114) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Add support for collapsed sidebar groups
+
+- [#254](https://github.com/withastro/starlight/pull/254) [`faa70de`](https://github.com/withastro/starlight/commit/faa70de584bf596fdd7184c4a8622d67d1410ecf) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Expose `<Icon>` component
+
+- [#256](https://github.com/withastro/starlight/pull/256) [`048e948`](https://github.com/withastro/starlight/commit/048e948bce650d559517850c73d827733b8164c4) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Add new global `lastUpdated` option defaulting to `false` to define whether or not the last updated date is shown in the footer. A page can override this setting or the generated date using the new `lastUpdated` frontmatter field.
+
+  ⚠️ Breaking change. Starlight will no longer show this date by default. To keep the previous behavior, you must explicitly set `lastUpdated` to `true` in your configuration.
+
+  ```diff
+  starlight({
+  + lastUpdated: true,
+  }),
+  ```
+
+### Patch Changes
+
+- [#264](https://github.com/withastro/starlight/pull/264) [`ed1e46b`](https://github.com/withastro/starlight/commit/ed1e46beb1bc054ecdba36ecfe566ecaeaf8799b) Thanks [@astridx](https://github.com/astridx)! - Add new icon for displaying codeberg.org in social links.
+
+- [#260](https://github.com/withastro/starlight/pull/260) [`01b65b1`](https://github.com/withastro/starlight/commit/01b65b1adf012474daf5678b4a709e3a7a484814) Thanks [@ElianCodes](https://github.com/ElianCodes)! - Add Dutch UI translations
+
+- [#269](https://github.com/withastro/starlight/pull/269) [`fdc18b5`](https://github.com/withastro/starlight/commit/fdc18b5476957f8017a0fa1489c6fed89d5a9480) Thanks [@baspinarenes](https://github.com/baspinarenes)! - Add Turkish UI translations
+
+- [#270](https://github.com/withastro/starlight/pull/270) [`1d3e705`](https://github.com/withastro/starlight/commit/1d3e705256fa0668db73b01c898e7e3b3b505c49) Thanks [@cbontems](https://github.com/cbontems)! - Improve French UI translations
+
+- [#272](https://github.com/withastro/starlight/pull/272) [`6b23ebc`](https://github.com/withastro/starlight/commit/6b23ebc9974828837a2de9175297664e5d28a999) Thanks [@cbontems](https://github.com/cbontems)! - Add YouTube social link support
+
+- [#267](https://github.com/withastro/starlight/pull/267) [`af2e43c`](https://github.com/withastro/starlight/commit/af2e43c7325a8f7fa6c9f867a3ec864daae39e96) Thanks [@nikcio](https://github.com/nikcio)! - Add Danish UI translations
+
+- [#273](https://github.com/withastro/starlight/pull/273) [`d4f5134`](https://github.com/withastro/starlight/commit/d4f5134c91b393ac448efc3f44849fc886a05551) Thanks [@Waxer59](https://github.com/Waxer59)! - Fix typo in Spanish UI translations
+
+## 0.3.1
+
+### Patch Changes
+
+- [#257](https://github.com/withastro/starlight/pull/257) [`0502327`](https://github.com/withastro/starlight/commit/050232770c8a2d22f317def8e734e4abb36387c6) Thanks [@JosefJezek](https://github.com/JosefJezek)! - Add Czech language support
+
+- [#261](https://github.com/withastro/starlight/pull/261) [`2062b9e`](https://github.com/withastro/starlight/commit/2062b9e21695b5dc3f116731dbfdf609e495018c) Thanks [@delucis](https://github.com/delucis)! - Fix autogenerated navigation for pages using fallback content
+
 ## 0.3.0
 
 ### Minor Changes

package/components/CallToAction.astro

@@ -1,5 +1,5 @@
 ---
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 import type { Icons } from './Icons';
 
 interface Props {

package/components/EditLink.astro

@@ -2,7 +2,7 @@
 import type { CollectionEntry } from 'astro:content';
 import config from 'virtual:starlight/user-config';
 import { useTranslations } from '../utils/translations';
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   data: CollectionEntry<'docs'>['data'];

package/components/FallbackContentNotice.astro

@@ -1,6 +1,6 @@
 ---
 import { useTranslations } from '../utils/translations';
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   locale: string | undefined;

package/components/Footer.astro

@@ -24,7 +24,20 @@ const prevNextLinks = getPrevNextLinks(sidebar);
         <EditLink data={entry.data} id={entry.id} {locale} />
       )
     }
-    <LastUpdated id={entry.id} {lang} {locale} />
+    {
+      (entry.data.lastUpdated ?? config.lastUpdated) && (
+        <LastUpdated
+          id={entry.id}
+          {lang}
+          lastUpdated={
+            typeof entry.data.lastUpdated !== 'boolean'
+              ? entry.data.lastUpdated
+              : undefined
+          }
+          {locale}
+        />
+      )
+    }
   </div>
   <PrevNextLinks {...prevNextLinks} {dir} {locale} />
 </footer>

package/components/Icons.ts

@@ -60,4 +60,8 @@ export const Icons = {
     '<path d="M24 4.4a10 10 0 0 1-2.83.78 5.05 5.05 0 0 0 2.17-2.79 9.7 9.7 0 0 1-3.13 1.23 4.89 4.89 0 0 0-5.94-1.03 5 5 0 0 0-2.17 2.38 5.15 5.15 0 0 0-.3 3.25c-1.95-.1-3.86-.63-5.61-1.53a14.04 14.04 0 0 1-4.52-3.74 5.2 5.2 0 0 0-.09 4.91c.39.74.94 1.35 1.61 1.82a4.77 4.77 0 0 1-2.23-.63v.06c0 1.16.4 2.29 1.12 3.18a4.9 4.9 0 0 0 2.84 1.74c-.73.22-1.5.26-2.24.12a4.89 4.89 0 0 0 4.59 3.49A9.78 9.78 0 0 1 0 19.73 13.65 13.65 0 0 0 7.55 22a13.63 13.63 0 0 0 9.96-4.16A14.26 14.26 0 0 0 21.6 7.65V7c.94-.72 1.75-1.6 2.4-2.6Z"/>',
   mastodon:
     '<path d="M16.45 17.77c2.77-.33 5.18-2.03 5.49-3.58.47-2.45.44-5.97.44-5.97 0-4.77-3.15-6.17-3.15-6.17-1.58-.72-4.3-1.03-7.13-1.05h-.07c-2.83.02-5.55.33-7.13 1.05 0 0-3.14 1.4-3.14 6.17v.91c-.01.88-.02 1.86 0 2.88.12 4.67.87 9.27 5.2 10.4 2 .53 3.72.64 5.1.57 2.51-.14 3.92-.9 3.92-.9l-.08-1.8s-1.8.56-3.8.5c-2-.08-4.1-.22-4.43-2.66a4.97 4.97 0 0 1-.04-.68s1.96.48 4.44.59c1.51.07 2.94-.09 4.38-.26Zm2.22-3.4h-2.3v-5.6c0-1.19-.5-1.79-1.5-1.79-1.1 0-1.66.71-1.66 2.12v3.07h-2.3V9.1c0-1.4-.55-2.12-1.65-2.12-1 0-1.5.6-1.5 1.78v5.61h-2.3V8.6c0-1.18.3-2.12.9-2.81a3.17 3.17 0 0 1 2.47-1.05c1.18 0 2.07.45 2.66 1.35l.57.96.58-.96a2.97 2.97 0 0 1 2.66-1.35c1.01 0 1.83.36 2.46 1.05.6.7.9 1.63.9 2.81v5.78Z"/>',
+  codeberg:
+    '<path d="M12 .5a12 12 0 0 0-12 12 12 12 0 0 0 1.8 6.4l10-13a.2.1 0 0 1 .4 0l10 13a12 12 0 0 0 1.8-6.4 12 12 0 0 0-12-12zm.3 6.5 4.4 16.5a12 12 0 0 0 5.2-4.2z"/>',
+  youtube:
+    '<path d="M23.5 6.2A3 3 0 0 0 21.4 4c-1.9-.5-9.4-.5-9.4-.5s-7.5 0-9.4.5A3 3 0 0 0 .5 6.3C0 8 0 12 0 12s0 4 .5 5.8A3 3 0 0 0 2.6 20c1.9.6 9.4.6 9.4.6s7.5 0 9.4-.6a3 3 0 0 0 2.1-2c.5-2 .5-5.9.5-5.9s0-4-.5-5.8zm-14 9.4V8.4l6.3 3.6-6.3 3.6z"/>',
 };

package/components/LastUpdated.astro

@@ -8,19 +8,22 @@ import { useTranslations } from '../utils/translations';
 interface Props {
   id: CollectionEntry<'docs'>['id'];
   lang: string;
+  lastUpdated: Date | undefined;
   locale: string | undefined;
 }
 
-const { id, lang, locale } = Astro.props;
+const { id, lang, lastUpdated, locale } = Astro.props;
 const t = useTranslations(locale);
 
 const currentFilePath = fileURLToPath(
   new URL('src/content/docs/' + id, project.root)
 );
 
-let date: Date | undefined;
+let date = lastUpdated;
 try {
-  ({ date } = getFileCommitDate(currentFilePath, 'newest'));
+  if (!date) {
+    ({ date } = getFileCommitDate(currentFilePath, 'newest'));
+  }
 } catch {}
 ---
 

package/components/MobileMenuToggle.astro

@@ -1,5 +1,5 @@
 ---
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 import { useTranslations } from '../utils/translations';
 
 interface Props {

package/components/PrevNextLinks.astro

@@ -1,7 +1,7 @@
 ---
 import type { Link } from '../utils/navigation';
 import { useTranslations } from '../utils/translations';
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   prev: Link | undefined;

package/components/Search.astro

@@ -1,7 +1,7 @@
 ---
 import '@pagefind/default-ui/css/ui.css';
 import { useTranslations } from '../utils/translations';
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   locale: string | undefined;

package/components/Select.astro

@@ -1,5 +1,5 @@
 ---
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   label: string;

package/components/SidebarSublist.astro

@@ -1,6 +1,6 @@
 ---
-import type { SidebarEntry } from '../utils/navigation';
-import Icon from './Icon.astro';
+import { flattenSidebar, type SidebarEntry } from '../utils/navigation';
+import Icon from '../user-components/Icon.astro';
 
 interface Props {
   sublist: SidebarEntry[];
@@ -21,7 +21,9 @@ interface Props {
             {entry.label}
           </a>
         ) : (
-          <details open>
+          <details
+            open={flattenSidebar(entry.entries).some(i => i.isCurrent) || !entry.collapsed}
+          >
             <summary>
               <h2 class="large">{entry.label}</h2>
               <Icon name="right-caret" class="caret" size="1.25rem" />

package/components/SocialIcons.astro

@@ -1,6 +1,6 @@
 ---
 import config from 'virtual:starlight/user-config';
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 
 type Platform = keyof NonNullable<typeof config.social>;
 

package/components/TableOfContents/MobileTableOfContents.astro

@@ -1,6 +1,6 @@
 ---
 import { useTranslations } from '../../utils/translations';
-import Icon from '../Icon.astro';
+import Icon from '../../user-components/Icon.astro';
 import TableOfContentsList from './TableOfContentsList.astro';
 import type { TocItem } from './generateToC';
 

package/components/ThemeProvider.astro

@@ -1,5 +1,5 @@
 ---
-import Icon from './Icon.astro';
+import Icon from '../user-components/Icon.astro';
 ---
 
 {/* This is intentionally inlined to avoid FOUC. */}

package/components.ts

@@ -1,4 +1,5 @@
 export { default as Card } from './user-components/Card.astro';
 export { default as CardGrid } from './user-components/CardGrid.astro';
+export { default as Icon } from './user-components/Icon.astro';
 export { default as Tabs } from './user-components/Tabs.astro';
 export { default as TabItem } from './user-components/TabItem.astro';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",
@@ -47,7 +47,7 @@
     "unified": "^10.1.2",
     "unist-util-remove": "^3.1.1",
     "unist-util-visit": "^4.1.2",
-    "vfile": "^6.0.0"
+    "vfile": "^5.3.7"
   },
   "scripts": {}
 }

package/schema.ts

@@ -113,5 +113,11 @@ export function docsSchema() {
             .default([]),
         })
         .optional(),
+      
+      /**
+       * The last update date of the current page.
+       * Overrides the `lastUpdated` global config or the date generated from the Git history.
+       */
+      lastUpdated: z.union([z.date(), z.boolean()]).optional(),
     });
 }

package/translations/cs.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "Přeskočit na obsah",
+  "search.label": "Hledat",
+  "search.shortcutLabel": "(Vyhledejte stisknutím /)",
+  "search.cancelLabel": "Zrušit",
+  "search.devWarning": "Vyhledávání je dostupné pouze v produkčních sestaveních. \nZkuste sestavit a zobrazit náhled webu a otestovat jej lokálně.",
+  "themeSelect.accessibleLabel": "Vyberte motiv",
+  "themeSelect.dark": "Tmavý",
+  "themeSelect.light": "Světlý",
+  "themeSelect.auto": "Auto",
+  "languageSelect.accessibleLabel": "Vyberte jazyk",
+  "menuButton.accessibleLabel": "Nabídka",
+  "sidebarNav.accessibleLabel": "Hlavní",
+  "tableOfContents.onThisPage": "Na této stránce",
+  "tableOfContents.overview": "Přehled",
+  "i18n.untranslatedContent": "Tento obsah zatím není dostupný ve vašem jazyce.",
+  "page.editLink": "Upravit stránku",
+  "page.lastUpdated": "Poslední aktualizace:",
+  "page.previousLink": "Předchozí",
+  "page.nextLink": "Další",
+  "404.text": "Stránka nenalezena. Zkontrolujte adresu URL nebo zkuste použít vyhledávací pole."
+}

package/translations/da.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "Gå til indhold",
+  "search.label": "Søg",
+  "search.shortcutLabel": "(Tryk / for at søge)",
+  "search.cancelLabel": "Annuller",
+  "search.devWarning": "Søgning er kun tilgængeligt i produktions versioner. \nPrøv at bygge siden og forhåndsvis den for at teste det lokalt.",
+  "themeSelect.accessibleLabel": "Vælg tema",
+  "themeSelect.dark": "Mørk",
+  "themeSelect.light": "Lys",
+  "themeSelect.auto": "Auto",
+  "languageSelect.accessibleLabel": "Vælg sprog",
+  "menuButton.accessibleLabel": "Menu",
+  "sidebarNav.accessibleLabel": "Hovednavigation",
+  "tableOfContents.onThisPage": "På denne side",
+  "tableOfContents.overview": "Oversigt",
+  "i18n.untranslatedContent": "Dette indhold er ikke tilgængeligt i dit sprog endnu.",
+  "page.editLink": "Rediger siden",
+  "page.lastUpdated": "Sidst opdateret:",
+  "page.previousLink": "Forrige",
+  "page.nextLink": "Næste",
+  "404.text": "Siden er ikke fundet. Tjek din URL eller prøv søgelinjen."
+}

package/translations/es.json

@@ -18,5 +18,5 @@
   "page.lastUpdated": "Última actualización:",
   "page.previousLink": "Página anterior",
   "page.nextLink": "Siguiente página",
-  "404.text": "Página no encontrada. Verifique la URL o intente usar la barra de búsqueda."
+  "404.text": "Página no encontrada. Verifica la URL o intenta usar la barra de búsqueda."
 }

package/translations/fr.json

@@ -3,20 +3,20 @@
     "search.label": "Rechercher",
     "search.shortcutLabel": "(Presser / pour rechercher)",
     "search.cancelLabel": "Annuler",
-    "search.devWarning": "Search is only available in production builds. \nTry building and previewing the site to test it out locally.",
+    "search.devWarning": "La recherche est disponible uniquement en mode production. \nEssayez de construire puis de prévisualiser votre site pour tester la recherche localement.",
     "themeSelect.accessibleLabel": "Selectionner le thème",
-    "themeSelect.dark": "Dark",
-    "themeSelect.light": "Light",
+    "themeSelect.dark": "Sombre",
+    "themeSelect.light": "Clair",
     "themeSelect.auto": "Auto",
     "languageSelect.accessibleLabel": "Selectionner la langue",
     "menuButton.accessibleLabel": "Menu",
     "sidebarNav.accessibleLabel": "principale",
     "tableOfContents.onThisPage": "Sur cette page",
-    "tableOfContents.overview": "Vue d'ensemble",
-    "i18n.untranslatedContent": "Ce contenu n'est pas encore disponible dans votre langue.",
-    "page.editLink": "Editer la page",
+    "tableOfContents.overview": "Vue d’ensemble",
+    "i18n.untranslatedContent": "Ce contenu n’est pas encore disponible dans votre langue.",
+    "page.editLink": "Modifier cette page",
     "page.lastUpdated": "Dernière mise à jour :",
     "page.previousLink": "Précédent",
     "page.nextLink": "Suivant",
-    "404.text": "Page non trouvée. Vérifiez l'URL ou essayez d'utiliser la barre de recherche."
+    "404.text": "Page non trouvée. Vérifiez l’URL ou essayez d’utiliser la barre de recherche."
   }

package/translations/index.ts

@@ -1,4 +1,5 @@
 import { builtinI18nSchema } from '../schemas/i18n';
+import cs from './cs.json';
 import en from './en.json';
 import es from './es.json';
 import de from './de.json';
@@ -6,9 +7,15 @@ import ja from './ja.json';
 import pt from './pt.json';
 import fr from './fr.json';
 import it from './it.json';
+import nl from './nl.json';
+import da from './da.json';
+import tr from './tr.json';
 
 const { parse } = builtinI18nSchema();
 
 export default Object.fromEntries(
-  Object.entries({ en, es, de, ja, pt, fr, it }).map(([key, dict]) => [key, parse(dict)])
+  Object.entries({ cs, en, es, de, ja, pt, fr, it, nl, da, tr }).map(([key, dict]) => [
+    key,
+    parse(dict),
+  ])
 );

package/translations/nl.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "Ga naar inhoud",
+  "search.label": "Zoeken",
+  "search.shortcutLabel": "(Druk op / om te zoeken)",
+  "search.cancelLabel": "Annuleren",
+  "search.devWarning": "Zoeken is alleen beschikbaar tijdens productie. \nProbeer om de site te builden en er een preview van te bekijken om lokaal te testen.",
+  "themeSelect.accessibleLabel": "Selecteer thema",
+  "themeSelect.dark": "Donker",
+  "themeSelect.light": "Licht",
+  "themeSelect.auto": "Auto",
+  "languageSelect.accessibleLabel": "Selecteer taal",
+  "menuButton.accessibleLabel": "Menu",
+  "sidebarNav.accessibleLabel": "Hoofdnavigatie",
+  "tableOfContents.onThisPage": "Op deze pagina",
+  "tableOfContents.overview": "Overzicht",
+  "i18n.untranslatedContent": "Deze inhoud is nog niet vertaald.",
+  "page.editLink": "Bewerk pagina",
+  "page.lastUpdated": "Laatst bewerkt:",
+  "page.previousLink": "Laatste",
+  "page.nextLink": "Volgende",
+  "404.text": "Pagina niet gevonden. Controleer de URL of probeer de zoekbalk."
+}

package/translations/tr.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "İçeriğe geç",
+  "search.label": "Ara",
+  "search.shortcutLabel": "(Aramak için / bas)",
+  "search.cancelLabel": "İptal",
+  "search.devWarning": "Arama yalnızca üretim derlemelerinde kullanılabilir. \nYerel bilgisayarınızda test etmek için siteyi derleyin ve önizleme yapın.",
+  "themeSelect.accessibleLabel": "Tema seç",
+  "themeSelect.dark": "Koyu",
+  "themeSelect.light": "Açık",
+  "themeSelect.auto": "Otomatik",
+  "languageSelect.accessibleLabel": "Dil seçin",
+  "menuButton.accessibleLabel": "Menü",
+  "sidebarNav.accessibleLabel": "Ana",
+  "tableOfContents.onThisPage": "Sayfa içeriği",
+  "tableOfContents.overview": "Genel bakış",
+  "i18n.untranslatedContent": "Bu içerik henüz dilinizde mevcut değil.",
+  "page.editLink": "Sayfayı düzenle",
+  "page.lastUpdated": "Son güncelleme:",
+  "page.previousLink": "Önceki",
+  "page.nextLink": "Sonraki",
+  "404.text": "Sayfa bulunamadı. URL'i kontrol edin ya da arama çubuğunu kullanmayı deneyin."
+}

package/user-components/Card.astro

@@ -1,5 +1,5 @@
 ---
-import Icon from '../components/Icon.astro';
+import Icon from './Icon.astro';
 import type { Icons } from '../components/Icons';
 
 interface Props {

package/{components → user-components}/Icon.astro

@@ -1,5 +1,5 @@
 ---
-import { Icons } from './Icons';
+import { Icons } from '../components/Icons';
 
 interface Props {
   name: keyof typeof Icons;

package/utils/navigation.ts

@@ -21,6 +21,7 @@ interface Group {
   type: 'group';
   label: string;
   entries: (Link | Group)[];
+  collapsed: boolean;
 }
 
 export type SidebarEntry = Link | Group;
@@ -53,6 +54,7 @@ function configItemToEntry(
       entries: item.items.map((i) =>
         configItemToEntry(i, currentPathname, locale, routes)
       ),
+      collapsed: item.collapsed,
     };
   }
 }
@@ -64,20 +66,21 @@ function groupFromAutogenerateConfig(
   routes: Route[],
   currentPathname: string
 ): Group {
-  const { directory } = item.autogenerate;
+  const { collapsed: subgroupCollapsed, directory } = item.autogenerate;
   const localeDir = locale ? locale + '/' + directory : directory;
   const dirDocs = routes.filter(
     (doc) =>
       // Match against `foo.md` or `foo/index.md`.
-      stripExtension(doc.entry.id) === localeDir ||
+      stripExtension(doc.id) === localeDir ||
       // Match against `foo/anything/else.md`.
-      doc.entry.id.startsWith(localeDir + '/')
+      doc.id.startsWith(localeDir + '/')
   );
   const tree = treeify(dirDocs, localeDir);
   return {
     type: 'group',
     label: pickLang(item.translations, localeToLang(locale)) || item.label,
-    entries: sidebarFromDir(tree, currentPathname, locale),
+    entries: sidebarFromDir(tree, currentPathname, locale, subgroupCollapsed ?? item.collapsed),
+    collapsed: item.collapsed,
   };
 }
 
@@ -136,7 +139,7 @@ function getBreadcrumbs(path: string, baseDir: string): string[] {
 function treeify(routes: Route[], baseDir: string): Dir {
   const treeRoot: Dir = {};
   routes.forEach((doc) => {
-    const breadcrumbs = getBreadcrumbs(doc.entry.id, baseDir);
+    const breadcrumbs = getBreadcrumbs(doc.id, baseDir);
 
     // Walk down the route’s path to generate the tree.
     let currentDir = treeRoot;
@@ -168,15 +171,17 @@ function groupFromDir(
   fullPath: string,
   dirName: string,
   currentPathname: string,
-  locale: string | undefined
+  locale: string | undefined,
+  collapsed: boolean
 ): Group {
   const entries = Object.entries(dir).map(([key, dirOrSlug]) =>
-    dirToItem(dirOrSlug, `${fullPath}/${key}`, key, currentPathname, locale)
+    dirToItem(dirOrSlug, `${fullPath}/${key}`, key, currentPathname, locale, collapsed)
   );
   return {
     type: 'group',
     label: dirName,
     entries,
+    collapsed,
   };
 }
 
@@ -186,21 +191,23 @@ function dirToItem(
   fullPath: string,
   dirName: string,
   currentPathname: string,
-  locale: string | undefined
+  locale: string | undefined,
+  collapsed: boolean
 ): SidebarEntry {
   return typeof dirOrSlug === 'string'
     ? linkFromSlug(dirOrSlug, currentPathname)
-    : groupFromDir(dirOrSlug, fullPath, dirName, currentPathname, locale);
+    : groupFromDir(dirOrSlug, fullPath, dirName, currentPathname, locale, collapsed);
 }
 
 /** Create a sidebar entry for a given content directory. */
 function sidebarFromDir(
   tree: Dir,
   currentPathname: string,
-  locale: string | undefined
+  locale: string | undefined,
+  collapsed: boolean
 ) {
   return Object.entries(tree).map(([key, dirOrSlug]) =>
-    dirToItem(dirOrSlug, key, key, currentPathname, locale)
+    dirToItem(dirOrSlug, key, key, currentPathname, locale, collapsed)
   );
 }
 
@@ -216,12 +223,12 @@ export function getSidebar(
     );
   } else {
     const tree = treeify(routes, locale || '');
-    return sidebarFromDir(tree, pathname, locale);
+    return sidebarFromDir(tree, pathname, locale, false);
   }
 }
 
 /** Turn the nested tree structure of a sidebar into a flat list of all the links. */
-function flattenSidebar(sidebar: SidebarEntry[]): Link[] {
+export function flattenSidebar(sidebar: SidebarEntry[]): Link[] {
   return sidebar.flatMap((entry) =>
     entry.type === 'group' ? flattenSidebar(entry.entries) : entry
   );

package/utils/routing.ts

@@ -3,6 +3,7 @@ import { CollectionEntry, getCollection } from 'astro:content';
 import config from 'virtual:starlight/user-config';
 import {
   LocaleData,
+  localizedId,
   localizedSlug,
   slugToLocaleData,
   slugToParam,
@@ -16,6 +17,7 @@ export interface Route extends LocaleData {
   entry: StarlightDocsEntry;
   entryMeta: LocaleData;
   slug: string;
+  id: string;
   isFallback?: true;
   [key: string]: unknown;
 }
@@ -41,6 +43,7 @@ function getRoutes(): Route[] {
   const routes: Route[] = docs.map((entry) => ({
     entry,
     slug: entry.slug,
+    id: entry.id,
     entryMeta: slugToLocaleData(entry.slug),
     ...slugToLocaleData(entry.slug),
   }));
@@ -61,11 +64,13 @@ function getRoutes(): Route[] {
       const localeDocs = getLocaleDocs(locale);
       for (const fallback of defaultLocaleDocs) {
         const slug = localizedSlug(fallback.slug, locale);
+        const id = localizedId(fallback.id, locale);
         const doesNotNeedFallback = localeDocs.some((doc) => doc.slug === slug);
         if (doesNotNeedFallback) continue;
         routes.push({
           entry: fallback,
           slug,
+          id,
           isFallback: true,
           lang: localeConfig.lang || 'en',
           locale,

package/utils/slugs.ts

@@ -90,3 +90,24 @@ export function localizedSlug(
   }
   return slug ? locale + '/' + slug : locale;
 }
+
+/**
+ * Convert a collection entry ID to a different locale.
+ * For example, passing an ID of `en/home.md` and a locale of `fr` results in `fr/home.md`.
+ * An undefined locale is treated as the root locale, resulting in `home.md`.
+ * @param id A collection entry ID
+ * @param locale The target locale
+ * @example
+ * localizedSlug('en/home.md', 'fr')       // => 'fr/home.md'
+ * localizedSlug('en/home.md', undefined)  // => 'home.md'
+ */
+export function localizedId(id: string, locale: string | undefined): string {
+  const idLocale = slugToLocale(id);
+  if (idLocale) {
+    return id.replace(idLocale + '/', locale ? locale + '/' : '');
+  } else if (locale) {
+    return locale + '/' + id;
+  } else {
+    return id;
+  }
+}

package/utils/user-config.ts

@@ -35,25 +35,35 @@ const SidebarBaseSchema = z.object({
   translations: z.record(z.string()).default({}),
 });
 
+const SidebarGroupSchema = SidebarBaseSchema.extend({
+  /** Whether this item should be collapsed by default. */
+  collapsed: z.boolean().default(false),
+});
+
 const SidebarLinkItemSchema = SidebarBaseSchema.extend({
   /** The link to this item’s content. Can be a relative link to local files or the full URL of an external page. */
   link: z.string(),
 });
 export type SidebarLinkItem = z.infer<typeof SidebarLinkItemSchema>;
 
-const AutoSidebarGroupSchema = SidebarBaseSchema.extend({
+const AutoSidebarGroupSchema = SidebarGroupSchema.extend({
   /** Enable autogenerating a sidebar category from a specific docs directory. */
   autogenerate: z.object({
     /** The directory to generate sidebar items for. */
     directory: z.string(),
+    /**
+     * Whether the autogenerated subgroups should be collapsed by default.
+     * Defaults to the `AutoSidebarGroup` `collapsed` value. 
+     */
+    collapsed: z.boolean().optional(),
     // TODO: not supported by Docusaurus but would be good to have
     /** How many directories deep to include from this directory in the sidebar. Default: `Infinity`. */
     // depth: z.number().optional(),
-  }),
-});
+  })
+})
 export type AutoSidebarGroup = z.infer<typeof AutoSidebarGroupSchema>;
 
-type ManualSidebarGroupInput = z.input<typeof SidebarBaseSchema> & {
+type ManualSidebarGroupInput = z.input<typeof SidebarGroupSchema> & {
   /** Array of links and subcategories to display in this category. */
   items: Array<
     | z.input<typeof SidebarLinkItemSchema>
@@ -62,7 +72,7 @@ type ManualSidebarGroupInput = z.input<typeof SidebarBaseSchema> & {
   >;
 };
 
-type ManualSidebarGroupOutput = z.output<typeof SidebarBaseSchema> & {
+type ManualSidebarGroupOutput = z.output<typeof SidebarGroupSchema> & {
   /** Array of links and subcategories to display in this category. */
   items: Array<
     | z.output<typeof SidebarLinkItemSchema>
@@ -75,7 +85,7 @@ const ManualSidebarGroupSchema: z.ZodType<
   ManualSidebarGroupOutput,
   z.ZodTypeDef,
   ManualSidebarGroupInput
-> = SidebarBaseSchema.extend({
+> = SidebarGroupSchema.extend({
   /** Array of links and subcategories to display in this category. */
   items: z.lazy(() =>
     z
@@ -86,7 +96,7 @@ const ManualSidebarGroupSchema: z.ZodType<
       ])
       .array()
   ),
-});
+})
 
 const SidebarItemSchema = z.union([
   SidebarLinkItemSchema,
@@ -125,6 +135,10 @@ const UserConfigSchema = z.object({
       github: z.string().url().optional(),
       /** Link to the Discord server for this site, e.g. `'https://astro.build/chat'`. */
       discord: z.string().url().optional(),
+      /** Link to the Codeberg profile or repository for this site, e.g. `'https://codeberg.org/knut/examples'`. */
+      codeberg: z.string().url().optional(),
+      /** Link to the Youtube channel for this site, e.g. `'https://www.youtube.com/@astrodotbuild'`. */
+      youtube: z.string().url().optional(),
     })
     .optional(),
 
@@ -231,6 +245,14 @@ const UserConfigSchema = z.object({
    * })
    */
   customCss: z.string().array().optional().default([]),
+
+  /** Define if the last update date should be visible in the page footer. */
+  lastUpdated: z
+    .boolean()
+    .default(false)
+    .describe(
+      'Define if the last update date should be visible in the page footer.'
+    ),
 });
 
 export const StarlightConfigSchema = UserConfigSchema.strict().transform(