Merge branch 'main' into chris/docsearch

.github/workflows/size-limit.yml

@@ -33,7 +33,7 @@ jobs:
       - uses: actions/checkout@v4
       - uses: pnpm/action-setup@v3
       - name: Run size-limit
-        uses: andresz1/size-limit-action@dd31dce7dcc72a041fd3e49abf0502b13fc4ce05
+        uses: andresz1/size-limit-action@v1.8.0
         with:
           github_token: ${{ secrets.FREDKBOT_GITHUB_TOKEN }}
           build_script: 'build:examples'

docs/astro.config.mjs

@@ -208,7 +208,7 @@ export default defineConfig({
 							errorOnFallbackPages: false,
 							errorOnInconsistentLocale: true,
 						}),
-				  ]
+					]
 				: [],
 		}),
 	],

docs/package.json

@@ -14,17 +14,17 @@
     "lunaria:build": "lunaria build"
   },
   "dependencies": {
-    "@astro-community/astro-embed-youtube": "^0.4.4",
+    "@astro-community/astro-embed-youtube": "^0.5.2",
     "@astrojs/starlight": "workspace:*",
     "@lunariajs/core": "^0.1.0",
     "@types/culori": "^2.0.0",
-    "astro": "^4.8.6",
+    "astro": "^4.10.2",
     "culori": "^3.2.0",
     "sharp": "^0.32.5"
   },
   "devDependencies": {
     "pa11y-ci": "^3.0.1",
-    "starlight-links-validator": "^0.7.1",
-    "start-server-and-test": "^2.0.0"
+    "starlight-links-validator": "^0.9.0",
+    "start-server-and-test": "^2.0.4"
   }
 }

docs/src/content/docs/es/guides/authoring-content.md

@@ -360,6 +360,31 @@ Un título opcional del bloque de código se puede establecer con un atributo `t
   ```
   ````
 
+## Details
+
+Los details (también conocidos como "revelaciones" o "acordeones") son útiles para ocultar contenido que no es inmediatamente relevante.
+Los usuarios pueden hacer clic en un breve resumen para expandir y ver el contenido completo.
+
+Usa el elemento HTML estándar [`<details>`](https://developer.mozilla.org/es/docs/Web/HTML/Element/details) y [`<summary>`](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary) en tu contenido Markdown para crear un widget de revelación.
+
+Puedes anidar cualquier otra sintaxis de Markdown dentro de un elemento `<details>`.
+
+<details>
+<summary>¿Dónde y cuándo es más visible la constelación de Andrómeda?</summary>
+
+La [constelación de Andrómeda](<https://es.wikipedia.org/wiki/Andr%C3%B3meda_(constelaci%C3%B3n)>) es más visible en el cielo nocturno durante el mes de noviembre en latitudes entre `+90°` y `−40°`.
+
+</details>
+
+```md
+<details>
+<summary>¿Dónde y cuándo es más visible la constelación de Andrómeda?</summary>
+
+La [constelación de Andrómeda](<https://es.wikipedia.org/wiki/Andr%C3%B3meda_(constelaci%C3%B3n)>) es más visible en el cielo nocturno durante el mes de noviembre en latitudes entre `+90°` y `−40°`.
+
+</details>
+```
+
 ## Otras características comunes de Markdown
 
 Starlight admite todas las demás sintaxis de autoría de Markdown, como listas y tablas. Puedes consultar la [Guía de referencia de Markdown](https://www.markdownguide.org/cheat-sheet/) para obtener una descripción general rápida de todos los elementos de sintaxis de Markdown.

docs/src/content/docs/es/guides/i18n.mdx

@@ -67,6 +67,8 @@ Starlight proporciona soporte incorporado para sitios multilingües, incluidas l
 
 </Steps>
 
+Para escenarios de i18n más avanzados, Starlight también admite la configuración de internacionalizaciónutlizando la [opción `i18n` de Astro](https://docs.astro.build/es/guides/internationalization/#configuración-de-rutas-i18n).
+
 ### Usa una raíz de configuración regional
 
 Puedes usar una raíz de configuración regional para servir un idioma sin ningún prefijo i18n en tu ruta. Por ejemplo, si el inglés es tu configuración regional, una ruta de página en inglés se vería como `/about` en lugar de `/en/about`.
@@ -178,7 +180,8 @@ import UIStringsList from '~/components/ui-strings-list.astro';
 Además de alojar archivos de contenido traducidos, Starlight te permite traducir las etiquetas de UI predeterminadas (p. ej. el encabezado "En esta página" en la tabla de contenidos) para que tus lectores puedan experimentar tu sitio completamente en el idioma seleccionado.
 
 <LanguagesList startsSentence /> los strings de UI traducidos se proporcionan de
-forma predeterminada, y damos la bienvenida a [contribuciones para agregar más idiomas
+forma predeterminada, y damos la bienvenida a [contribuciones para agregar más
+idiomas
 predeterminados](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
 
 Puedes proprocionar traducciones para idiomas adicionales, o editar nuestras etiquetas predeterminadas, a través de la colección de datos `i18n`.
@@ -273,3 +276,17 @@ export const collections = {
 ```
 
 Aprende más sobre los esquemas de colección de contenido en [“Definir un esquema de colección”](https://docs.astro.build/es/guides/content-collections/#definiendo-un-esquema-de-colección) en la documentación de Astro.
+
+## Acceder al idioma actual
+
+Puedes usar [`Astro.currentLocale`](https://docs.astro.build/es/reference/api-reference/#astrocurrentlocale) para leer el idioma actual en componentes `.astro`.
+
+El siguiente ejemplo lee el idioma actual y lo utiliza para generar un enlace a una página Acerca de en el idioma actual:
+
+```astro
+---
+// src/components/AboutLink.astro
+---
+
+<a href={`/${Astro.currentLocale}/about`}>Acerca</a>
+```

docs/src/content/docs/es/reference/configuration.mdx

@@ -215,7 +215,8 @@ type SidebarItem = {
 ```ts
 interface BadgeConfig {
 	text: string;
-	variant: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
+	variant?: 'note' | 'tip' | 'caution' | 'danger' | 'success' | 'default';
+	class?: string;
 }
 ```
 
@@ -568,3 +569,13 @@ starlight({
 ```
 
 Consulta la [Referencia de Plugins](/es/reference/plugins/) para obtener detalles sobre cómo crear tus propios plugins.
+
+### `credits`
+
+Habilita la visualización de un enlace “Hecho con Starlight” en el pie de página de tu sitio.
+
+```js
+starlight({
+	credits: true,
+});
+```

docs/src/content/docs/guides/i18n.mdx

@@ -180,8 +180,9 @@ import UIStringsList from '~/components/ui-strings-list.astro';
 
 In addition to hosting translated content files, Starlight allows you to translate the default UI strings (e.g. the "On this page" heading in the table of contents) so that your readers can experience your site entirely in the selected language.
 
-<LanguagesList startsSentence /> translated UI strings are provided out of the box,
-and we welcome [contributions to add more default languages](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
+<LanguagesList startsSentence /> translated UI strings are provided out of the
+box, and we welcome [contributions to add more default
+languages](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
 
 You can provide translations for additional languages you support — or override our default labels — via the `i18n` data collection.
 

docs/src/content/docs/hi/guides/i18n.mdx

@@ -178,9 +178,10 @@ import UIStringsList from '~/components/ui-strings-list.astro';
 
 अनुवादित कंटेंट फ़ाइलों को होस्ट करने के अलावा, Starlight आपको डिफ़ॉल्ट UI स्ट्रिंग्स (उदाहरण के लिए कंटेंट तालिका में "इस पेज पर" शीर्षक) का अनुवाद करने की अनुमति देता है ताकि आपके पाठक आपकी साइट को पूरी तरह से चयनित भाषा में अनुभव कर सकें।
 
-<LanguagesList startsSentence /> अनुवादित UI स्ट्रिंग्स सामने से मिलती हैं , और हम
-[अधिक डिफ़ॉल्ट भाषाएँ जोड़ने के लिए योगदान](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md)
-का स्वागत करते हैं।
+<LanguagesList startsSentence /> अनुवादित UI स्ट्रिंग्स सामने से मिलती हैं , और
+हम [अधिक डिफ़ॉल्ट भाषाएँ जोड़ने के लिए
+योगदान](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md) का
+स्वागत करते हैं।
 
 आप `i18n` डेटा संग्रह के माध्यम से उन अतिरिक्त भाषाओं के लिए अनुवाद प्रदान कर सकते हैं जिनका आप समर्थन करते हैं - या हमारे डिफ़ॉल्ट लेबल को ओवरराइड कर सकते हैं।
 

docs/src/content/docs/ru/guides/i18n.mdx

@@ -178,9 +178,10 @@ import UIStringsList from '~/components/ui-strings-list.astro';
 
 Кроме размещения переведённых файлов с контентом, Starlight позволяет вам переводить текст интерфейсе (например, заголовок «На этой странице» в оглавлении), чтобы ваши читатели могли полностью погрузиться в ваш сайт на выбранном языке.
 
-<LanguagesList startsSentence /> — все переведённые строки пользовательского интерфейса
-на указанных языках предоставляются «из коробки», и мы приветствуем [вклад в добавление
-дополнительных языков по умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
+<LanguagesList startsSentence /> — все переведённые строки пользовательского
+интерфейса на указанных языках предоставляются «из коробки», и мы приветствуем
+[вклад в добавление дополнительных языков по
+умолчанию](https://github.com/withastro/starlight/blob/main/CONTRIBUTING.md).
 
 Вы можете добавить переводы для дополнительных языков, которые вы поддерживаете — или переопределить наши стандартные тексты — через коллекцию данных `i18n`.
 

docs/src/content/docs/tr/guides/sidebar.mdx

@@ -49,8 +49,8 @@ Aşdağıdaki gibi kenar çubuğu otomatik olarak oluşturulacaktır:
 		},
 	]}
 />
-Otomatik oluşturulan kenar çubukları ile ilgili daha fazla bilgiye [otomatik oluşturulan
-gruplar](#otomatik-oluşturulmuş-gruplar) bölümünden ulaşabilirsiniz.
+Otomatik oluşturulan kenar çubukları ile ilgili daha fazla bilgiye [otomatik
+oluşturulan gruplar](#otomatik-oluşturulmuş-gruplar) bölümünden ulaşabilirsiniz.
 
 ## Bağlantı ve Bağlantı Grupları Ekleme
 

examples/basics/package.json

@@ -11,8 +11,8 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.24.1",
-    "astro": "^4.8.6",
+    "@astrojs/starlight": "^0.24.2",
+    "astro": "^4.10.2",
     "sharp": "^0.32.5"
   }
 }

examples/tailwind/package.json

@@ -11,11 +11,11 @@
     "astro": "astro"
   },
   "dependencies": {
-    "@astrojs/starlight": "^0.24.1",
+    "@astrojs/starlight": "^0.24.2",
     "@astrojs/starlight-tailwind": "^2.0.3",
     "@astrojs/tailwind": "^5.1.0",
-    "astro": "^4.8.6",
+    "astro": "^4.10.2",
     "sharp": "^0.32.5",
-    "tailwindcss": "^3.4.1"
+    "tailwindcss": "^3.4.4"
   }
 }

package.json

@@ -12,32 +12,35 @@
   },
   "license": "MIT",
   "devDependencies": {
-    "@astrojs/check": "^0.5.10",
-    "@changesets/changelog-github": "^0.4.8",
-    "@changesets/cli": "^2.26.1",
-    "@size-limit/file": "^8.2.4",
-    "astro": "^4.8.6",
-    "prettier": "^3.0.0",
-    "prettier-plugin-astro": "^0.13.0",
-    "size-limit": "^8.2.4",
+    "@astrojs/check": "^0.7.0",
+    "@changesets/changelog-github": "^0.5.0",
+    "@changesets/cli": "^2.27.5",
+    "@size-limit/file": "^11.1.4",
+    "astro": "^4.10.2",
+    "prettier": "^3.3.2",
+    "prettier-plugin-astro": "^0.14.0",
+    "size-limit": "^11.1.4",
     "typescript": "^5.4.5"
   },
   "packageManager": "[email protected]",
   "size-limit": [
     {
       "name": "/index.html",
       "path": "examples/basics/dist/index.html",
-      "limit": "10 kB"
+      "limit": "10 kB",
+      "gzip": true
     },
     {
       "name": "/_astro/*.js",
       "path": "examples/basics/dist/_astro/*.js",
-      "limit": "23 kB"
+      "limit": "23 kB",
+      "gzip": true
     },
     {
       "name": "/_astro/*.css",
       "path": "examples/basics/dist/_astro/*.css",
-      "limit": "14.5 kB"
+      "limit": "14.5 kB",
+      "gzip": true
     }
   ]
 }

packages/file-icons-generator/package.json

@@ -9,7 +9,7 @@
   "license": "MIT",
   "dependencies": {
     "opentype.js": "^1.3.4",
-    "tsx": "^4.7.1"
+    "tsx": "^4.15.2"
   },
   "devDependencies": {
     "@types/opentype.js": "^1.3.8"

packages/starlight/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @astrojs/starlight
 
+## 0.24.2
+
+### Patch Changes
+
+- [#2008](https://github.com/withastro/starlight/pull/2008) [`40359c7`](https://github.com/withastro/starlight/commit/40359c7b73d9c7d60f0b44a870dbc93ba941228f) Thanks [@vnepogodin](https://github.com/vnepogodin)! - Add Slovak language UI translation.
+
+- [#2004](https://github.com/withastro/starlight/pull/2004) [`0aa2f06`](https://github.com/withastro/starlight/commit/0aa2f06d3a35a3c5182b4d461c8f3489ac145301) Thanks [@liruifengv](https://github.com/liruifengv)! - Removes an outdated export in `package.json`
+
+- [#2007](https://github.com/withastro/starlight/pull/2007) [`44ca490`](https://github.com/withastro/starlight/commit/44ca490f36ecd6789d0865dd2506e5ea03dfa0fb) Thanks [@delucis](https://github.com/delucis)! - Updates internal dependencies
+
+- [#1993](https://github.com/withastro/starlight/pull/1993) [`60165b2`](https://github.com/withastro/starlight/commit/60165b20c9d11a08c4c4793615778e045b41b7de) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Fixes an i18n configuration issue when using a single root locale.
+
 ## 0.24.1
 
 ### Patch Changes

packages/starlight/__e2e__/fixtures/basics/package.json

@@ -4,6 +4,6 @@
   "private": true,
   "dependencies": {
     "@astrojs/starlight": "workspace:*",
-    "astro": "^4.8.6"
+    "astro": "^4.10.2"
   }
 }

packages/starlight/__tests__/i18n/translations-ec.test.ts

@@ -4,9 +4,8 @@ import { addTranslations } from '../../integrations/expressive-code/translations
 import { StarlightConfigSchema, type StarlightUserConfig } from '../../utils/user-config';
 
 vi.mock('astro-expressive-code', async () => {
-	const mod = await vi.importActual<typeof import('astro-expressive-code')>(
-		'astro-expressive-code'
-	);
+	const mod =
+		await vi.importActual<typeof import('astro-expressive-code')>('astro-expressive-code');
 	return {
 		...mod,
 		pluginFramesTexts: {