@astrojs/starlight 0.29.2 → 0.30.0

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # @astrojs/starlight
 
+## 0.30.0
+
+### Minor Changes
+
+- [#2612](https://github.com/withastro/starlight/pull/2612) [`8d5a4e8`](https://github.com/withastro/starlight/commit/8d5a4e8000d9e3a4bb9ca8178767cf3d8bc48773) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Adds support for Astro v5, drops support for Astro v4.
+
+  #### Upgrade Astro and dependencies
+
+  ⚠️ **BREAKING CHANGE:** Astro v4 is no longer supported. Make sure you [update Astro](https://docs.astro.build/en/guides/upgrade-to/v5/) and any other official integrations at the same time as updating Starlight:
+
+  ```sh
+  npx @astrojs/upgrade
+  ```
+
+  _Community Starlight plugins and Astro integrations may also need to be manually updated to work with Astro v5. If you encounter any issues, please reach out to the plugin or integration author to see if it is a known issue or if an updated version is being worked on._
+
+  #### Update your collections
+
+  ⚠️ **BREAKING CHANGE:** Starlight's internal [content collections](https://docs.astro.build/en/guides/content-collections/), which organize, validate, and render your content, have been updated to use Astro's new Content Layer API and require configuration changes in your project.
+
+  1. **Move the content config file.** This file no longer lives within the `src/content/config.ts` folder and should now exist at `src/content.config.ts`.
+  1. **Edit the collection definition(s).** To update the `docs` collection, a `loader` is now required:
+
+     ```diff
+      // src/content.config.ts
+      import { defineCollection } from "astro:content";
+     +import { docsLoader } from "@astrojs/starlight/loaders";
+      import { docsSchema } from "@astrojs/starlight/schema";
+
+      export const collections = {
+     -  docs: defineCollection({ schema: docsSchema() }),
+     +  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+      };
+     ```
+
+     If you are using the [`i18n` collection](https://starlight.astro.build/guides/i18n/#translate-starlights-ui) to provide translations for additional languages you support or override our default labels, you will need to update the collection definition in a similar way and remove the collection `type` which is no longer available:
+
+     ```diff
+      // src/content.config.ts
+      import { defineCollection } from "astro:content";
+     +import { docsLoader, i18nLoader } from "@astrojs/starlight/loaders";
+      import { docsSchema, i18nSchema } from "@astrojs/starlight/schema";
+
+      export const collections = {
+     -  docs: defineCollection({ schema: docsSchema() }),
+     +  docs: defineCollection({ loader: docsLoader(), schema: docsSchema() }),
+     -  i18n: defineCollection({ type: 'data', schema: i18nSchema() }),
+     +  i18n: defineCollection({ loader: i18nLoader(), schema: i18nSchema() }),
+      };
+     ```
+
+  1. **Update other collections.** To update any other collections you may have, follow the [“Updating existing collections”](https://docs.astro.build/en/guides/upgrade-to/v5/#updating-existing-collections) section in the Astro 5 upgrade guide.
+
+  If you are unable to make any changes to your collections at this time, including Starlight's default `docs` and `i18n` collections, you can enable the [`legacy.collections` flag](https://docs.astro.build/en/reference/legacy-flags/) to upgrade to v5 without updating your collections. This legacy flag exists to provide temporary backwards compatibility, and will allow you to keep your collections in their current state until the legacy flag is no longer supported.
+
+### Patch Changes
+
+- [#2669](https://github.com/withastro/starlight/pull/2669) [`310df7d`](https://github.com/withastro/starlight/commit/310df7d6b01f5c4a56540bdba9243fb60dace323) Thanks [@aaronperezaguilera](https://github.com/aaronperezaguilera)! - Adds Catalan UI translations
+
+- [#2664](https://github.com/withastro/starlight/pull/2664) [`62ff007`](https://github.com/withastro/starlight/commit/62ff0074d9a3f82e46f5c62db85c04d87ff5e931) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Publishes provenance containing verifiable data to link a package back to its source repository and the specific build instructions used to publish it.
+
+- [#2670](https://github.com/withastro/starlight/pull/2670) [`0223b42`](https://github.com/withastro/starlight/commit/0223b425249f8d1fa468e367c632467276c9c208) Thanks [@aaronperezaguilera](https://github.com/aaronperezaguilera)! - Adds Spanish UI translations for the Pagefind search modal
+
+## 0.29.3
+
+### Patch Changes
+
+- [#2642](https://github.com/withastro/starlight/pull/2642) [`12750ae`](https://github.com/withastro/starlight/commit/12750ae1bc303f2c53efd25adf01428e54aced90) Thanks [@dragomano](https://github.com/dragomano)! - Updates Russian UI translations
+
+- [#2656](https://github.com/withastro/starlight/pull/2656) [`4d543be`](https://github.com/withastro/starlight/commit/4d543bec280f3b5e00e21727d78f25756a1ced75) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Improves error message when an invalid configuration or no configuration is provided to the Starlight integration.
+
+- [#2645](https://github.com/withastro/starlight/pull/2645) [`cf12beb`](https://github.com/withastro/starlight/commit/cf12beb91b4cb2f212dbcc0cc1ed56e79d055ff0) Thanks [@techfg](https://github.com/techfg)! - Fixes support for favicon URLs that contain a search query and/or hash
+
+- [#2650](https://github.com/withastro/starlight/pull/2650) [`38db4ec`](https://github.com/withastro/starlight/commit/38db4ecfdb572b1f6362aca544f72f5128f5fe08) Thanks [@raviqqe](https://github.com/raviqqe)! - Moves `@types/js-yaml` package to non-dev dependencies
+
+- [#2633](https://github.com/withastro/starlight/pull/2633) [`5adb720`](https://github.com/withastro/starlight/commit/5adb720afd354d99b3682d045b9dc8729a1ff274) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Fixes a VoiceOver issue with Safari where the content of a `<script>` element could be read before the sidebar content.
+
+- [#2663](https://github.com/withastro/starlight/pull/2663) [`34755f9`](https://github.com/withastro/starlight/commit/34755f9c5f2fa451e8a56aecf3ff5a6ff499767b) Thanks [@astrobot-houston](https://github.com/astrobot-houston)! - Adds a new `seti:vite` icon for Vite configuration files in the `<FileTree>` component
+
 ## 0.29.2
 
 ### Patch Changes

package/components/Page.astro

@@ -35,16 +35,14 @@ const pagefindEnabled =
 	Astro.props.entry.slug !== '404' &&
 	!Astro.props.entry.slug.endsWith('/404') &&
 	Astro.props.entry.data.pagefind !== false;
+
+const dataAttributes: DOMStringMap = { 'data-theme': 'dark' };
+if (Boolean(Astro.props.toc)) dataAttributes['data-has-toc'] = '';
+if (Astro.props.hasSidebar) dataAttributes['data-has-sidebar'] = '';
+if (Boolean(Astro.props.entry.data.hero)) dataAttributes['data-has-hero'] = '';
 ---
 
-<html
-	lang={Astro.props.lang}
-	dir={Astro.props.dir}
-	data-has-toc={Boolean(Astro.props.toc)}
-	data-has-sidebar={Astro.props.hasSidebar}
-	data-has-hero={Boolean(Astro.props.entry.data.hero)}
-	data-theme="dark"
->
+<html lang={Astro.props.lang} dir={Astro.props.dir} {...dataAttributes}>
 	<head>
 		<Head {...Astro.props} />
 		<style>

package/components/Search.astro

@@ -12,12 +12,12 @@ const pagefindTranslations = {
 			.map(([key, value]) => [key.replace('pagefind.', ''), value])
 	),
 };
+
+const dataAttributes: DOMStringMap = { 'data-translations': JSON.stringify(pagefindTranslations) };
+if (project.trailingSlash === 'never') dataAttributes['data-strip-trailing-slash'] = '';
 ---
 
-<site-search
-	data-translations={JSON.stringify(pagefindTranslations)}
-	data-strip-trailing-slash={project.trailingSlash === 'never'}
->
+<site-search class={Astro.props.class} {...dataAttributes}>
 	<button
 		data-open-modal
 		disabled

package/components/SidebarPersister.astro

@@ -12,6 +12,11 @@
   - On smaller viewports, restoring state is skipped as the sidebar is collapsed inside a menu.
   - The state is parsed from session storage and restored.
   - This is a progressive enhancement, so any errors are swallowed silently.
+
+  The `aria-hidden` attribute on script tags is used to prevent a Safari/VoiceOver bug where the
+  script is read out loud due to them being inside a container with `display: contents`.
+  @see https://bugs.webkit.org/show_bug.cgi?id=283645
+  @see https://github.com/withastro/starlight/pull/2633
 */
 
 import type { Props } from '../props';
@@ -28,7 +33,7 @@ declare global {
 ---
 
 <sl-sidebar-state-persist data-hash={hash}>
-	<script is:inline>
+	<script is:inline aria-hidden="true">
 		(() => {
 			try {
 				if (!matchMedia('(min-width: 50em)').matches) return;
@@ -55,7 +60,7 @@ declare global {
 
 	<slot />
 
-	<script is:inline>
+	<script is:inline aria-hidden="true">
 		(() => {
 			const scroller = document.getElementById('starlight__sidebar');
 			if (!window._starlightScrollRestore || !scroller) return;

package/index.ts

@@ -9,6 +9,7 @@
 
 import mdx from '@astrojs/mdx';
 import type { AstroIntegration } from 'astro';
+import { AstroError } from 'astro/errors';
 import { spawn } from 'node:child_process';
 import { dirname, relative } from 'node:path';
 import { fileURLToPath } from 'node:url';
@@ -27,10 +28,16 @@ import {
 import { processI18nConfig } from './utils/i18n';
 import type { StarlightConfig } from './types';
 
-export default function StarlightIntegration({
-	plugins,
-	...opts
-}: StarlightUserConfigWithPlugins): AstroIntegration {
+export default function StarlightIntegration(
+	userOpts: StarlightUserConfigWithPlugins
+): AstroIntegration {
+	if (typeof userOpts !== 'object' || userOpts === null || Array.isArray(userOpts))
+		throw new AstroError(
+			'Invalid config passed to starlight integration',
+			`The Starlight integration expects a configuration object with at least a \`title\` property.\n\n` +
+				`See more details in the [Starlight configuration reference](https://starlight.astro.build/reference/configuration/)\n`
+		);
+	const { plugins, ...opts } = userOpts;
 	let userConfig: StarlightConfig;
 	let pluginTranslations: PluginTranslations = {};
 	return {
@@ -130,9 +137,6 @@ export default function StarlightIntegration({
 					scopedStyleStrategy: 'where',
 					// If not already configured, default to prefetching all links on hover.
 					prefetch: config.prefetch ?? { prefetchAll: true },
-					experimental: {
-						globalRoutePriority: true,
-					},
 					i18n: astroI18nConfig,
 				});
 			},

package/integrations/shared/pathToLocale.ts

@@ -1,5 +1,6 @@
 import type { AstroConfig } from 'astro';
 import type { StarlightConfig } from '../../types';
+import { getCollectionPath } from '../../utils/collection';
 import { slugToLocale } from './slugToLocale';
 
 /** Get current locale from the full file path. */
@@ -13,15 +14,14 @@ export function pathToLocale(
 		astroConfig: { root: AstroConfig['root']; srcDir: AstroConfig['srcDir'] };
 	}
 ): string | undefined {
-	const srcDir = new URL(astroConfig.srcDir, astroConfig.root);
-	const docsDir = new URL('content/docs/', srcDir);
+	const docsPath = getCollectionPath('docs', astroConfig.srcDir);
 	// Format path to unix style path.
 	path = path?.replace(/\\/g, '/');
 	// Ensure that the page path starts with a slash if the docs directory also does,
 	// which makes stripping the docs path in the next step work on Windows, too.
-	if (path && !path.startsWith('/') && docsDir.pathname.startsWith('/')) path = '/' + path;
+	if (path && !path.startsWith('/') && docsPath.startsWith('/')) path = '/' + path;
 	// Strip docs path leaving only content collection file ID.
 	// Example: /Users/houston/repo/src/content/docs/en/guide.md => en/guide.md
-	const slug = path?.replace(docsDir.pathname, '');
+	const slug = path?.replace(docsPath, '');
 	return slugToLocale(slug, starlightConfig);
 }

package/integrations/virtual-user-config.ts

@@ -1,6 +1,8 @@
 import type { AstroConfig, HookParameters, ViteUserConfig } from 'astro';
+import { existsSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { resolveCollectionPath } from '../utils/collection';
 import type { StarlightConfig } from '../utils/user-config';
 import { getAllNewestCommitDate } from '../utils/git';
 import type { PluginTranslations } from '../utils/plugins';
@@ -15,11 +17,13 @@ export function vitePluginStarlightUserConfig(
 	opts: StarlightConfig,
 	{
 		build,
+		legacy,
 		root,
 		srcDir,
 		trailingSlash,
 	}: Pick<AstroConfig, 'root' | 'srcDir' | 'trailingSlash'> & {
 		build: Pick<AstroConfig['build'], 'format'>;
+		legacy: Pick<AstroConfig['legacy'], 'collections'>;
 	},
 	pluginTranslations: PluginTranslations
 ): NonNullable<ViteUserConfig['plugins']>[number] {
@@ -42,7 +46,19 @@ export function vitePluginStarlightUserConfig(
 	const resolveLocalPath = (path: string) =>
 		JSON.stringify(fileURLToPath(new URL(path, import.meta.url)));
 
-	const docsPath = resolve(fileURLToPath(srcDir), 'content/docs');
+	const rootPath = fileURLToPath(root);
+	const docsPath = resolveCollectionPath('docs', srcDir);
+
+	let collectionConfigImportPath = resolve(
+		fileURLToPath(srcDir),
+		legacy.collections ? './content/config.ts' : './content.config.ts'
+	);
+	// If not using legacy collections and the config doesn't exist, fallback to the legacy location.
+	// We need to test this ahead of time as we cannot `try/catch` a failing import in the virtual
+	// module as this would fail at build time when Rollup tries to resolve a non-existent path.
+	if (!legacy.collections && !existsSync(collectionConfigImportPath)) {
+		collectionConfigImportPath = resolve(fileURLToPath(srcDir), './content/config.ts');
+	}
 
 	const virtualComponentModules = Object.fromEntries(
 		Object.entries(opts.components).map(([name, path]) => [
@@ -56,6 +72,7 @@ export function vitePluginStarlightUserConfig(
 		'virtual:starlight/user-config': `export default ${JSON.stringify(opts)}`,
 		'virtual:starlight/project-context': `export default ${JSON.stringify({
 			build: { format: build.format },
+			legacyCollections: legacy.collections,
 			root,
 			srcDir,
 			trailingSlash,
@@ -63,9 +80,9 @@ export function vitePluginStarlightUserConfig(
 		'virtual:starlight/git-info':
 			(command !== 'build'
 				? `import { makeAPI } from ${resolveLocalPath('../utils/git.ts')};` +
-					`const api = makeAPI(${JSON.stringify(docsPath)});`
+					`const api = makeAPI(${JSON.stringify(rootPath)});`
 				: `import { makeAPI } from ${resolveLocalPath('../utils/gitInlined.ts')};` +
-					`const api = makeAPI(${JSON.stringify(getAllNewestCommitDate(docsPath))});`) +
+					`const api = makeAPI(${JSON.stringify(getAllNewestCommitDate(rootPath, docsPath))});`) +
 			'export const getNewestCommitDate = api.getNewestCommitDate;',
 		'virtual:starlight/user-css': opts.customCss.map((id) => `import ${resolveId(id)};`).join(''),
 		'virtual:starlight/user-images': opts.logo
@@ -79,7 +96,7 @@ export function vitePluginStarlightUserConfig(
 			: 'export const logos = {};',
 		'virtual:starlight/collection-config': `let userCollections;
 			try {
-				userCollections = (await import(${resolveId('./content/config.ts', srcDir)})).collections;
+				userCollections = (await import(${JSON.stringify(collectionConfigImportPath)})).collections;
 			} catch {}
 			export const collections = userCollections;`,
 		'virtual:starlight/plugin-translations': `export default ${JSON.stringify(pluginTranslations)}`,

package/loaders.ts

@@ -0,0 +1,40 @@
+import { glob, type Loader, type LoaderContext } from 'astro/loaders';
+import { getCollectionPathFromRoot, type StarlightCollection } from './utils/collection';
+
+// https://github.com/withastro/astro/blob/main/packages/astro/src/core/constants.ts#L87
+// https://github.com/withastro/astro/blob/main/packages/integrations/mdx/src/index.ts#L59
+const docsExtensions = ['markdown', 'mdown', 'mkdn', 'mkd', 'mdwn', 'md', 'mdx'];
+const i18nExtensions = ['json', 'yml', 'yaml'];
+
+export function docsLoader(): Loader {
+	return {
+		name: 'starlight-docs-loader',
+		load: createGlobLoadFn('docs'),
+	};
+}
+
+export function i18nLoader(): Loader {
+	return {
+		name: 'starlight-i18n-loader',
+		load: createGlobLoadFn('i18n'),
+	};
+}
+
+function createGlobLoadFn(collection: StarlightCollection): Loader['load'] {
+	return (context: LoaderContext) => {
+		const extensions = collection === 'docs' ? docsExtensions : i18nExtensions;
+
+		if (
+			collection === 'docs' &&
+			context.config.integrations.find(({ name }) => name === '@astrojs/markdoc')
+		) {
+			// https://github.com/withastro/astro/blob/main/packages/integrations/markdoc/src/content-entry-type.ts#L28
+			extensions.push('mdoc');
+		}
+
+		return glob({
+			base: getCollectionPathFromRoot(collection, context.config),
+			pattern: `**/[^_]*.{${extensions.join(',')}}`,
+		}).load(context);
+	};
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.29.2",
+  "version": "0.30.0",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",
@@ -158,6 +158,7 @@
     "./internal": "./internal.ts",
     "./props": "./props.ts",
     "./schema": "./schema.ts",
+    "./loaders": "./loaders.ts",
     "./types": "./types.ts",
     "./expressive-code": {
       "types": "./expressive-code.d.ts",
@@ -171,23 +172,23 @@
     "./style/markdown.css": "./style/markdown.css"
   },
   "peerDependencies": {
-    "astro": "^4.14.0"
+    "astro": "^5.0.0"
   },
   "devDependencies": {
-    "@astrojs/markdown-remark": "^5.3.0",
+    "@astrojs/markdown-remark": "^6.0.0",
     "@playwright/test": "^1.45.0",
-    "@types/js-yaml": "^4.0.9",
     "@types/node": "^18.16.19",
-    "@vitest/coverage-v8": "^1.6.0",
-    "astro": "^4.16.10",
+    "@vitest/coverage-v8": "2.1.6",
+    "astro": "^5.0.2",
     "linkedom": "^0.18.4",
-    "vitest": "^1.6.0"
+    "vitest": "2.1.6"
   },
   "dependencies": {
-    "@astrojs/mdx": "^3.1.3",
+    "@astrojs/mdx": "^4.0.1",
     "@astrojs/sitemap": "^3.1.6",
     "@pagefind/default-ui": "^1.0.3",
     "@types/hast": "^3.0.4",
+    "@types/js-yaml": "^4.0.9",
     "@types/mdast": "^4.0.4",
     "astro-expressive-code": "^0.38.3",
     "bcp-47": "^2.1.0",
@@ -208,8 +209,12 @@
     "unist-util-visit": "^5.0.0",
     "vfile": "^6.0.2"
   },
+  "publishConfig": {
+    "provenance": true
+  },
   "scripts": {
     "test": "vitest",
+    "test:legacy": "LEGACY_COLLECTIONS=true vitest",
     "test:coverage": "vitest run --coverage",
     "test:e2e": "playwright install --with-deps chromium && playwright test"
   }

package/routes/common.astro

@@ -1,4 +1,5 @@
 ---
+import { render } from 'astro:content';
 import { generateRouteData } from '../utils/route-data';
 import type { Route } from '../utils/routing';
 import Page from '../components/Page.astro';
@@ -9,7 +10,7 @@ export type Props = {
 
 const { route } = Astro.props;
 
-const { Content, headings } = await route.entry.render();
+const { Content, headings } = await render(route.entry);
 const routeData = generateRouteData({ props: { ...route, headings }, url: Astro.url });
 ---
 

package/routes/static/404.astro

@@ -1,8 +1,14 @@
 ---
 import { getEntry } from 'astro:content';
+import project from 'virtual:starlight/project-context';
 import config from 'virtual:starlight/user-config';
-import EmptyContent from '../../components/EmptyMarkdown.md';
-import type { Route, StarlightDocsEntry } from '../../utils/routing';
+import { getCollectionPathFromRoot } from '../../utils/collection';
+import {
+	normalizeCollectionEntry,
+	type Route,
+	type StarlightDocsCollectionEntry,
+	type StarlightDocsEntry,
+} from '../../utils/routing';
 import { BuiltInDefaultLocale } from '../../utils/i18n';
 import CommonPage from '../common.astro';
 
@@ -17,7 +23,7 @@ const entryMeta = { dir, lang, locale };
 
 const fallbackEntry: StarlightDocsEntry = {
 	slug: '404',
-	id: '404.md' as StarlightDocsEntry['id'],
+	id: '404',
 	body: '',
 	collection: 'docs',
 	data: {
@@ -30,15 +36,11 @@ const fallbackEntry: StarlightDocsEntry = {
 		sidebar: { hidden: false, attrs: {} },
 		draft: false,
 	},
-	render: async () => ({
-		Content: EmptyContent,
-		headings: [],
-		remarkPluginFrontmatter: {},
-	}),
+	filePath: `${getCollectionPathFromRoot('docs', project)}/404.md`,
 };
 
-const userEntry = await getEntry('docs', '404');
-const entry = userEntry || fallbackEntry;
+const userEntry = (await getEntry('docs', '404')) as StarlightDocsCollectionEntry;
+const entry = userEntry ? normalizeCollectionEntry(userEntry) : fallbackEntry;
 const route: Route = { ...entryMeta, entryMeta, entry, id: entry.id, slug: entry.slug };
 ---
 

package/schemas/favicon.ts

@@ -15,7 +15,9 @@ export const FaviconSchema = () =>
 		.string()
 		.default('/favicon.svg')
 		.transform((favicon, ctx) => {
-			const ext = extname(favicon).toLowerCase();
+			// favicon can be absolute or relative url
+			const { pathname } = new URL(favicon, 'https://example.com');
+			const ext = extname(pathname).toLowerCase();
 
 			if (!isFaviconExt(ext)) {
 				ctx.addIssue({

package/style/shiki.css

@@ -1,6 +1,6 @@
 :root {
-	--astro-code-color-text: var(--sl-color-white);
-	--astro-code-color-background: var(--sl-color-gray-6);
+	--astro-code-foreground: var(--sl-color-white);
+	--astro-code-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);

package/translations/ca.json

@@ -0,0 +1,42 @@
+{
+  "skipLink.label": "Saltar al contingut",
+  "search.label": "Cercar",
+  "search.ctrlKey": "Ctrl",
+  "search.cancelLabel": "Cancel·lar",
+  "search.devWarning": "La cerca només està disponible a les versions de producció.  \nProva de construir i previsualitzar el lloc per provar-ho localment.",
+  "themeSelect.accessibleLabel": "Seleccionar tema",
+  "themeSelect.dark": "Fosc",
+  "themeSelect.light": "Clar",
+  "themeSelect.auto": "Automàtic",
+  "languageSelect.accessibleLabel": "Seleccionar idioma",
+  "menuButton.accessibleLabel": "Menú",
+  "sidebarNav.accessibleLabel": "Primari",
+  "tableOfContents.onThisPage": "En aquesta pàgina",
+  "tableOfContents.overview": "Sinopsi",
+  "i18n.untranslatedContent": "Aquesta pàgina encara no està disponible en el teu idioma.",
+  "page.editLink": "Edita aquesta pàgina",
+  "page.lastUpdated": "Última actualització:",
+  "page.previousLink": "Pàgina anterior",
+  "page.nextLink": "Pàgina següent",
+  "page.draft": "Aquest contingut és un esborrany i no s'inclourà en les versions de producció.",
+  "404.text": "Pàgina no trobada. Comprova la URL o intenta utilitzar la barra de cerca.",
+  "aside.note": "Nota",
+  "aside.tip": "Consell",
+  "aside.caution": "Precaució",
+  "aside.danger": "Perill",
+  "expressiveCode.copyButtonCopied": "Copiat!",
+  "expressiveCode.copyButtonTooltip": "Copiar al porta-retalls",
+  "expressiveCode.terminalWindowFallbackTitle": "Finestra del terminal",
+  "fileTree.directory": "Directori",
+  "builtWithStarlight.label": "Fet amb Starlight",
+  "pagefind.clear_search": "Netejar",
+  "pagefind.load_more": "Carregar més resultats",
+  "pagefind.search_label": "Cercar pàgina",
+  "pagefind.filters_label": "Filtres",
+  "pagefind.zero_results": "Cap resultat per a: [SEARCH_TERM]",
+  "pagefind.many_results": "[COUNT] resultats per a: [SEARCH_TERM]",
+  "pagefind.one_result": "[COUNT] resultat per a: [SEARCH_TERM]",
+  "pagefind.alt_search": "Cap resultat per a [SEARCH_TERM]. Mostrant resultats per a: [DIFFERENT_TERM]",
+  "pagefind.search_suggestion": "Cap resultat per a [SEARCH_TERM]. Prova alguna d’aquestes cerques:",
+  "pagefind.searching": "Cercant [SEARCH_TERM]..."
+}

package/translations/es.json

@@ -28,5 +28,15 @@
   "expressiveCode.copyButtonTooltip": "Copiar al portapapeles",
   "expressiveCode.terminalWindowFallbackTitle": "Ventana de terminal",
   "fileTree.directory": "Directory",
-  "builtWithStarlight.label": "Hecho con Starlight"
+  "builtWithStarlight.label": "Hecho con Starlight",
+  "pagefind.clear_search": "Limpiar",
+  "pagefind.load_more": "Cargar más resultados",
+  "pagefind.search_label": "Buscar página",
+  "pagefind.filters_label": "Filtros",
+  "pagefind.zero_results": "Ningún resultado para: [SEARCH_TERM]",
+  "pagefind.many_results": "[COUNT] resultados para: [SEARCH_TERM]",
+  "pagefind.one_result": "[COUNT] resultado para: [SEARCH_TERM]",
+  "pagefind.alt_search": "Ningún resultado para [SEARCH_TERM]. Mostrando resultados para: [DIFFERENT_TERM]",
+  "pagefind.search_suggestion": "Ningún resultado para [SEARCH_TERM]. Prueba alguna de estas búsquedas:",
+  "pagefind.searching": "Buscando [SEARCH_TERM]..."
 }

package/translations/index.ts

@@ -2,6 +2,7 @@ import { builtinI18nSchema } from '../schemas/i18n';
 import cs from './cs.json';
 import en from './en.json';
 import es from './es.json';
+import ca from './ca.json';
 import de from './de.json';
 import ja from './ja.json';
 import pt from './pt.json';
@@ -35,6 +36,7 @@ export default Object.fromEntries(
 		cs,
 		en,
 		es,
+		ca,
 		de,
 		ja,
 		pt,

package/translations/ru.json

@@ -3,7 +3,7 @@
   "search.label": "Поиск",
   "search.ctrlKey": "Ctrl",
   "search.cancelLabel": "Отменить",
-  "search.devWarning": "Поиск доступен только в производственных сборках. \nПопробуйте выполнить сборку и просмотреть сайт, чтобы протестировать его локально.",
+  "search.devWarning": "Поиск доступен только в продакшен-сборках. \nВыполните сборку и запустите превью, чтобы протестировать поиск локально.",
   "themeSelect.accessibleLabel": "Выберите тему",
   "themeSelect.dark": "Тёмная",
   "themeSelect.light": "Светлая",
@@ -18,7 +18,7 @@
   "page.lastUpdated": "Последнее обновление:",
   "page.previousLink": "Предыдущая",
   "page.nextLink": "Следующая",
-  "page.draft": "Этот контент является черновиком и не будет добавлен в производственные сборки.",
+  "page.draft": "Этот контент является черновиком и не будет добавлен в продакшен-сборки.",
   "404.text": "Страница не найдена. Проверьте URL или используйте поиск по сайту.",
   "aside.note": "Заметка",
   "aside.tip": "Совет",

package/user-components/file-tree-icons.ts

@@ -62,6 +62,12 @@ export const definitions: Definitions = {
 		mvnw: 'seti:maven',
 		'pom.xml': 'seti:maven',
 		'tsconfig.json': 'seti:tsconfig',
+		'vite.config.js': 'seti:vite',
+		'vite.config.ts': 'seti:vite',
+		'vite.config.mjs': 'seti:vite',
+		'vite.config.mts': 'seti:vite',
+		'vite.config.cjs': 'seti:vite',
+		'vite.config.cts': 'seti:vite',
 		'swagger.json': 'seti:json',
 		'swagger.yml': 'seti:json',
 		'swagger.yaml': 'seti:json',
@@ -570,7 +576,7 @@ export const FileIcons = {
 	'seti:jade':
 		'<path d="M23.247 16.411L23.247 16.411Q22.923 14.719 23.103 12.595L23.103 12.595Q23.247 11.911 23.247 11.551L23.247 11.551Q23.283 10.975 23.103 10.435L23.103 10.435Q22.887 9.751 22.671 8.419L22.671 8.419L22.635 8.203Q22.419 6.799 22.275 6.079L22.275 6.079Q22.023 4.855 21.663 3.919L21.663 3.919Q21.447 3.523 21.267 3.343L21.267 3.343Q21.015 3.127 20.655 3.127L20.655 3.127Q19.971 3.127 19.971 3.811L19.971 3.811Q20.007 4.315 20.187 5.377Q20.367 6.439 20.403 6.943L20.403 6.943Q20.475 7.339 20.637 8.077Q20.799 8.815 20.871 9.211L20.871 9.211L20.871 9.643Q20.547 9.643 20.403 9.535L20.403 9.535L20.043 9.283Q19.431 8.851 19.179 8.527L19.179 8.527Q18.351 7.339 17.847 6.151L17.847 6.151L17.307 4.927Q16.371 2.659 15.795 1.687L15.795 1.687Q15.327 0.895 14.607 0.571L14.607 0.571Q14.031 0.319 13.095 0.319L13.095 0.319Q12.663 0.319 12.663 0.751L12.663 0.751L12.735 1.111Q12.843 1.543 12.987 1.795L12.987 1.795Q13.491 2.695 14.445 4.549Q15.399 6.403 15.903 7.303L15.903 7.303Q16.191 7.735 16.839 8.599L16.839 8.599L17.055 8.851Q17.379 9.355 17.307 9.607Q17.235 9.859 16.695 10.111L16.695 10.111L16.587 10.111L16.479 10.219Q15.327 10.507 14.355 9.535L14.355 9.535Q13.419 8.815 12.303 8.635L12.303 8.635Q12.159 8.635 11.763 8.581Q11.367 8.527 11.187 8.527L11.187 8.527Q9.819 8.419 8.883 8.491L8.883 8.491Q7.659 8.599 6.579 8.995L6.579 8.995Q4.995 9.535 3.879 10.831L3.879 10.831Q2.943 11.947 2.295 13.711L2.295 13.711Q2.079 14.395 1.647 15.943L1.647 15.943Q1.503 15.727 1.395 15.619L1.395 15.619Q1.179 15.403 1.179 15.187L1.179 15.187L1.035 15.259Q0.819 15.475 0.747 15.619L0.747 15.619L0.747 16.195Q0.747 16.627 0.963 17.095L0.963 17.095Q2.259 20.227 3.195 22.927L3.195 22.927Q3.555 23.611 4.203 23.611L4.203 23.611Q6.111 23.791 7.479 23.503L7.479 23.503L9.495 23.143Q9.063 22.711 8.847 22.603L8.847 22.603Q8.847 22.531 8.901 22.477Q8.955 22.423 8.955 22.351L8.955 22.351L10.503 22.711Q13.347 23.755 16.047 23.611L16.047 23.611Q16.659 23.611 16.803 23.143L16.803 23.143L17.163 22.495Q17.415 21.415 18.279 20.119L18.279 20.119L18.315 20.047Q18.711 19.507 18.855 19.363Q18.999 19.219 19.197 19.219Q19.395 19.219 19.863 19.363L19.863 19.363L20.187 19.435Q21.195 19.795 22.023 19.345Q22.851 18.895 23.103 17.851L23.103 17.851Q23.247 17.419 23.247 16.411ZM21.987 15.043L21.987 15.043Q21.663 15.403 21.555 15.403L21.555 15.403Q19.683 15.583 18.603 15.043L18.603 15.043Q18.351 14.971 17.955 14.539L17.955 14.539L17.703 14.287Q18.387 14.035 18.603 13.927L18.603 13.927Q20.007 13.783 21.447 14.503L21.447 14.503Q21.483 14.503 21.591 14.539L21.591 14.539L21.663 14.611Q21.987 14.935 21.987 15.043Z"/>',
 	'seti:java':
-		'<path d="M12 0L12 0Q8.760 0 5.960 1.640L5.960 1.640Q3.240 3.240 1.640 5.960L1.640 5.960Q0 8.760 0 12Q0 15.240 1.640 18.040L1.640 18.040Q3.240 20.760 5.960 22.360L5.960 22.360Q8.760 24 12 24Q15.240 24 18.040 22.360L18.040 22.360Q20.760 20.760 22.360 18.040L22.360 18.040Q24 15.240 24 12Q24 8.760 22.360 5.960L22.360 5.960Q20.760 3.240 18.040 1.640L18.040 1.640Q15.240 0 12 0ZM16.280 5.600L16.280 13.600Q16.400 14.560 16.100 15.480Q15.800 16.400 15.120 17.100Q14.440 17.800 13.560 18.140Q12.680 18.480 11.720 18.400L11.720 18.400Q10.560 18.480 9.500 18.020Q8.440 17.560 7.720 16.680L7.720 16.680L9.160 14.840Q9.600 15.400 10.240 15.720Q10.880 16.040 11.640 16.040L11.640 16.040Q12.640 16.040 13.200 15.380Q13.760 14.720 13.760 13.400L13.760 13.400L13.760 5.600L16.280 5.600Z"/>',
+		'<path d="M19.896 0.198L19.896 14.940Q19.854 15.108 19.854 15.444L19.854 15.444Q19.854 16.410 19.812 16.914L19.812 16.914Q19.728 17.796 19.518 18.384L19.518 18.384Q18.972 20.106 17.733 21.387Q16.494 22.668 14.856 23.340L14.856 23.340Q14.100 23.634 13.365 23.718Q12.630 23.802 11.454 23.802L11.454 23.802Q9.060 23.802 7.338 23.130L7.338 23.130Q5.448 22.248 4.104 20.610L4.104 20.610L6.750 17.208Q7.548 18.258 8.745 18.846Q9.942 19.434 11.328 19.434L11.328 19.434Q13.176 19.434 14.205 18.216Q15.234 16.998 15.234 14.562L15.234 14.562L15.234 0.198L19.896 0.198Z"/>',
 	'seti:javascript':
 		'<path d="M5.376 14.300L5.376 3.352L9.286 3.352L9.286 14.300Q9.286 17.842 7.630 19.452L7.630 19.452Q6.112 20.924 3.076 20.924L3.076 20.924Q2.386 20.924 1.558 20.809Q0.730 20.694 0.224 20.464L0.224 20.464L0.638 17.336Q1.512 17.750 2.662 17.750L2.662 17.750Q3.950 17.750 4.594 17.060L4.594 17.060Q5.376 16.232 5.376 14.300L5.376 14.300ZM11.862 19.912L12.736 16.600Q13.564 17.060 14.668 17.382L14.668 17.382Q15.910 17.750 17.014 17.750L17.014 17.750Q18.394 17.750 19.084 17.267Q19.774 16.784 19.774 15.910Q19.774 15.036 19.130 14.507Q18.486 13.978 16.876 13.426L16.876 13.426Q12.138 11.770 12.138 8.274L12.138 8.274Q12.138 5.974 13.909 4.525Q15.680 3.076 18.762 3.076L18.762 3.076Q21.200 3.076 23.224 3.950L23.224 3.950L22.350 7.124L22.074 6.986Q21.246 6.664 20.740 6.526L20.740 6.526Q19.774 6.250 18.762 6.250L18.762 6.250Q17.520 6.250 16.853 6.733Q16.186 7.216 16.186 7.998Q16.186 8.780 16.922 9.286L16.922 9.286Q17.474 9.700 19.314 10.436L19.314 10.436Q21.614 11.310 22.695 12.552Q23.776 13.794 23.776 15.588L23.776 15.588Q23.776 17.888 22.028 19.314L22.028 19.314Q20.142 20.924 16.738 20.924L16.738 20.924Q15.404 20.924 13.932 20.556L13.932 20.556Q12.782 20.326 11.862 19.912L11.862 19.912Z"/>',
 	'seti:jinja':
@@ -670,7 +676,7 @@ export const FileIcons = {
 	'seti:db':
 		'<path d="M12.546 9.327L12.546 9.327Q9.858 9.327 7.884 9.201L7.884 9.201Q5.448 9.033 3.348 8.571L3.348 8.571Q2.844 8.487 1.920 8.109L1.920 8.109Q1.416 7.857 1.122 7.773L1.122 7.773Q0.576 7.605 0.576 6.975L0.576 6.975L0.576 2.397Q0.576 2.187 0.681 2.019Q0.786 1.851 0.954 1.851L0.954 1.851L1.374 1.683Q2.802 1.053 3.600 0.927L3.600 0.927Q5.784 0.423 8.472 0.255L8.472 0.255Q10.068 0.171 13.302 0.171L13.302 0.171Q17.712 0.171 21.198 1.095L21.198 1.095Q21.996 1.263 22.878 1.725L22.878 1.725Q23.424 1.893 23.424 2.523L23.424 2.523L23.424 7.101Q23.424 7.395 23.046 7.773L23.046 7.773Q21.996 8.277 21.450 8.445L21.450 8.445L19.602 8.739Q17.166 9.117 15.948 9.201L15.948 9.201Q15.360 9.285 14.205 9.285Q13.050 9.285 12.546 9.327ZM23.424 9.621L23.424 9.621L23.424 14.325Q23.424 14.535 23.193 14.766Q22.962 14.997 22.752 14.997L22.752 14.997L22.080 15.249Q20.820 15.669 20.274 15.795L20.274 15.795Q15.360 16.635 8.976 16.425L8.976 16.425L8.892 16.425Q6.792 16.299 5.700 16.173L5.700 16.173Q3.936 15.963 2.550 15.501L2.550 15.501Q2.004 15.375 0.996 14.871L0.996 14.871Q0.576 14.661 0.576 14.199L0.576 14.199L0.576 9.621Q3.180 10.503 6.288 10.839L6.288 10.839Q8.514 11.049 12 11.049L12 11.049Q15.150 11.175 17.712 10.881L17.712 10.881Q20.736 10.545 23.424 9.621ZM23.424 16.971L23.424 16.971L23.424 21.549Q23.424 21.759 23.193 21.990Q22.962 22.221 22.752 22.347L22.752 22.347Q21.702 22.725 21.198 22.893L21.198 22.893Q20.316 23.187 19.602 23.271L19.602 23.271Q11.580 24.447 3.726 23.145L3.726 23.145Q3.054 23.019 1.710 22.557L1.710 22.557L1.122 22.347Q0.828 22.263 0.702 22.053Q0.576 21.843 0.576 21.423L0.576 21.423L0.576 16.971Q3.096 17.853 6.204 18.189L6.204 18.189Q8.430 18.399 12 18.399L12 18.399Q15.486 18.399 17.712 18.189L17.712 18.189Q20.820 17.853 23.424 16.971Z"/>',
 	'seti:terraform':
-		'<path d="M8.584 11.604L8.584 4.773L15.415 8.238L15.415 15.102L8.584 11.604ZM23.666 11.604L23.666 4.773L16.834 8.238L16.834 15.102L23.666 11.604ZM0.334 7.479L0.334 0.648L7.165 4.113L7.165 10.977L0.334 7.479ZM8.584 19.854L8.584 13.023L15.415 16.488L15.415 23.352L8.584 19.854Z"/>',
+		'<path d="M8.850 11.880L8.850 4.200L15.150 8.040L15.150 15.720L8.850 11.880ZM22.590 4.200L15.900 8.040L15.900 15.720L22.590 11.880L22.590 4.200ZM8.100 3.840L1.410 0.120L1.410 7.560L8.100 11.280L8.100 3.840ZM8.850 12.750L8.850 20.160L15.150 23.880L15.150 16.470L8.850 12.750Z"/>',
 	'seti:tex':
 		'<path d="M3.651 6.951L3.651 13.650L2.199 13.650L2.199 14.970L6.753 14.970L6.753 13.650L5.400 13.650L5.400 6.951L5.829 6.951Q6.456 6.951 6.753 7.017Q7.050 7.083 7.198 7.281Q7.347 7.479 7.479 7.974L7.479 7.974L8.700 7.974L8.502 5.598L0.450 5.598L0.153 9.327L1.374 9.327L1.374 8.799Q1.473 7.842 1.605 7.545L1.605 7.545Q1.770 7.149 2.100 7.050L2.100 7.050Q2.397 6.951 3.222 6.951L3.222 6.951L3.651 6.951ZM11.802 17.346L11.802 17.346L10.053 17.346L10.053 14.475L10.647 14.475Q11.076 14.475 11.191 14.508Q11.307 14.541 11.340 14.706Q11.373 14.871 11.373 15.399L11.373 15.399L11.373 15.927L12.627 15.927L12.627 11.670L11.373 11.670L11.373 12.198Q11.373 12.726 11.340 12.891Q11.307 13.056 11.191 13.089Q11.076 13.122 10.647 13.122L10.647 13.122L10.053 13.122L10.053 10.647L11.703 10.647Q12.462 10.647 12.809 10.812Q13.155 10.977 13.287 11.373L13.287 11.373Q13.386 11.703 13.452 12.495L13.452 12.495L14.673 12.495L14.376 9.195L7.149 9.195L7.149 10.548L8.172 10.548L8.172 17.148L7.149 17.148L7.149 18.501L14.475 18.501L14.871 15.795L13.551 15.795Q13.551 16.686 13.171 17.016Q12.792 17.346 11.802 17.346ZM17.874 14.970L17.874 13.749L17.379 13.749L18.897 11.472L20.448 13.749L20.151 13.749L20.151 14.871L23.847 14.871L23.847 13.650L23.352 13.650Q22.890 13.650 22.791 13.617Q22.692 13.584 22.626 13.452L22.626 13.452L20.151 9.822L21.801 7.446L21.900 7.347Q22.098 7.116 22.263 7.017L22.263 7.017Q22.527 6.852 22.923 6.852L22.923 6.852L23.451 6.852L23.451 5.499L20.250 5.499L20.250 6.720L20.778 6.720L20.679 6.852L19.425 8.601L18.072 6.951L18.402 6.951L18.402 5.499L14.673 5.499L14.673 6.951L15.201 6.951Q15.663 6.951 15.745 6.967Q15.828 6.984 15.927 7.149L15.927 7.149L18.072 10.350L16.224 13.122L15.927 13.452Q15.597 13.749 15.102 13.749L15.102 13.749L14.574 13.749L14.574 14.970L17.874 14.970Z"/>',
 	'seti:default':
@@ -683,6 +689,8 @@ export const FileIcons = {
 		'<path d="M1.668 0.198L1.668 0.198L22.332 0.198Q22.962 0.198 23.382 0.618Q23.802 1.038 23.802 1.668L23.802 1.668L23.802 22.332Q23.802 22.962 23.382 23.382Q22.962 23.802 22.332 23.802L22.332 23.802L1.668 23.802Q1.038 23.802 0.618 23.382Q0.198 22.962 0.198 22.332L0.198 22.332L0.198 1.668Q0.198 1.038 0.618 0.618Q1.038 0.198 1.668 0.198ZM10.572 12.546L13.470 12.546L13.470 10.530L5.364 10.530L5.364 12.546L8.262 12.546L8.262 21.576L10.572 21.576L10.572 12.546ZM14.268 19.140L14.268 21.702Q14.898 22.038 15.675 22.185Q16.452 22.332 17.313 22.332Q18.174 22.332 18.951 22.164Q19.728 21.996 20.337 21.576Q20.946 21.156 21.282 20.526Q21.618 19.896 21.618 18.930L21.618 18.930Q21.618 18.216 21.408 17.712Q21.198 17.208 20.820 16.788Q20.442 16.368 19.917 16.032Q19.392 15.696 18.804 15.444L18.804 15.444Q18.342 15.234 17.985 15.045Q17.628 14.856 17.355 14.667Q17.082 14.478 16.914 14.226Q16.746 13.974 16.746 13.701Q16.746 13.428 16.893 13.218Q17.040 13.008 17.271 12.861Q17.502 12.714 17.838 12.630Q18.174 12.546 18.594 12.546L18.594 12.546Q19.602 12.546 20.526 13.008L20.526 13.008Q20.862 13.134 21.114 13.344L21.114 13.344L21.114 10.950Q20.526 10.740 19.938 10.614L19.938 10.614Q19.182 10.530 18.426 10.530L18.426 10.530Q17.586 10.530 16.809 10.719Q16.032 10.908 15.465 11.328Q14.898 11.748 14.562 12.378Q14.226 13.008 14.226 13.932L14.226 13.932Q14.226 15.066 14.835 15.864Q15.444 16.662 16.704 17.208L16.704 17.208L17.628 17.628Q18.048 17.838 18.363 18.069Q18.678 18.300 18.867 18.573Q19.056 18.846 19.056 19.140L19.056 19.140Q19.056 19.686 18.594 19.980L18.594 19.980Q18.384 20.148 18.006 20.232Q17.628 20.316 17.208 20.316L17.208 20.316Q16.410 20.316 15.654 20.022Q14.898 19.728 14.268 19.140L14.268 19.140Z"/>',
 	'seti:vala':
 		'<path d="M13.452 8.241L13.490 8.241Q15.010 8.241 16.454 8.583L16.454 8.583L17.024 8.849Q18.050 9.343 18.278 10.255L18.278 10.255Q18.506 11.053 18.088 11.927L18.088 11.927Q17.974 12.307 17.670 12.725L17.670 12.725Q17.480 12.953 17.024 13.333L17.024 13.333L16.796 13.599Q16.112 14.169 14.592 15.157L14.592 15.157L13.718 15.727Q13.414 15.917 12.806 16.297L12.806 16.297Q11.704 17.019 11.210 17.513L11.210 17.513Q11.096 17.627 10.925 17.855Q10.754 18.083 10.602 18.197L10.602 18.197Q10.450 18.463 10.431 18.786Q10.412 19.109 10.488 19.413L10.488 19.413Q10.754 19.945 11.267 20.363Q11.780 20.781 12.445 20.952Q13.110 21.123 13.604 20.743Q14.098 20.363 14.174 19.641L14.174 19.641L14.174 19.147Q14.174 18.691 14.554 18.349L14.554 18.349Q15.162 17.893 15.846 17.741L15.846 17.741Q17.100 17.475 17.746 17.627L17.746 17.627Q17.974 17.627 18.088 17.741L18.088 17.741Q18.544 17.931 18.658 18.197Q18.772 18.463 18.696 18.919L18.696 18.919Q18.202 20.895 16.568 22.377L16.568 22.377Q15.124 23.631 13.338 23.783L13.338 23.783Q11.932 23.973 10.488 23.441L10.488 23.441Q5.814 21.655 4.218 16.791L4.218 16.791Q3.686 15.005 4.180 13.447Q4.674 11.889 6.118 10.749L6.118 10.749Q7.752 9.229 10.754 8.583L10.754 8.583Q11.704 8.355 12.160 8.355L12.160 8.355Q12.768 8.241 13.452 8.241L13.452 8.241ZM15.010 4.783L15.010 4.783Q15.200 1.933 17.518 0.641L17.518 0.641Q18.924-0.081 20.368 0.299L20.368 0.299Q21.166 0.451 21.470 0.907Q21.774 1.363 21.641 2.199Q21.508 3.035 20.824 3.966Q20.140 4.897 19.722 5.353L19.722 5.353Q19.038 6.075 18.354 6.455L18.354 6.455Q17.594 7.025 16.796 7.177L16.796 7.177Q16.226 7.253 15.827 7.063Q15.428 6.873 15.238 6.341L15.238 6.341Q15.010 5.619 15.010 4.783ZM13.338 2.769L13.338 2.769Q13.338 4.479 12.502 5.619L12.502 5.619Q12.350 5.961 12.046 6.113L12.046 6.113Q11.780 6.379 11.457 6.379Q11.134 6.379 10.868 6.113L10.868 6.113Q10.488 5.733 10.260 5.049L10.260 5.049Q9.842 3.605 10.146 2.427L10.146 2.427Q10.526 1.097 11.932 1.097L11.932 1.097Q12.388 1.097 12.711 1.287Q13.034 1.477 13.110 1.819L13.110 1.819Q13.224 1.933 13.224 2.199L13.224 2.199Q13.224 2.541 13.338 2.769ZM8.474 4.897L8.474 5.277Q8.474 5.847 8.436 6.151L8.436 6.151Q8.360 6.607 8.132 6.949L8.132 6.949Q7.942 7.405 7.600 7.462Q7.258 7.519 6.840 7.177L6.840 7.177Q5.814 6.341 5.624 5.049L5.624 5.049L5.624 4.213Q5.738 3.643 6.137 3.263Q6.536 2.883 7.068 2.883L7.068 2.883Q7.676 2.883 8.018 3.377L8.018 3.377Q8.474 4.023 8.474 4.897L8.474 4.897ZM5.168 8.735L5.168 8.697Q5.168 9.077 4.940 9.533L4.940 9.533Q4.750 10.065 4.218 9.913L4.218 9.913L4.104 9.875L3.990 9.799Q3.268 9.533 2.793 8.716Q2.318 7.899 2.318 7.177L2.318 7.177Q2.318 6.759 2.584 6.417Q2.850 6.075 3.268 5.847L3.268 5.847Q3.800 5.695 4.332 6.227L4.332 6.227Q4.636 6.531 4.788 7.025L4.788 7.025Q4.902 7.291 5.016 7.899L5.016 7.899L5.054 8.013Q5.168 8.355 5.168 8.735L5.168 8.735Z"/>',
+	'seti:vite':
+		'<path d="M16.232 0.179L16.232 0.179L6.392 2.139Q6.152 2.179 6.112 2.459L6.112 2.459L5.512 12.659Q5.512 12.859 5.652 12.979Q5.792 13.099 5.952 13.059L5.952 13.059L8.672 12.419Q8.872 12.379 9.012 12.519Q9.152 12.659 9.112 12.819L9.112 12.819L8.312 16.819Q8.272 17.019 8.432 17.159Q8.592 17.299 8.752 17.219L8.752 17.219L10.472 16.699Q10.672 16.659 10.812 16.799Q10.952 16.939 10.912 17.139L10.912 17.139L9.632 23.379Q9.552 23.699 9.832 23.799Q10.112 23.899 10.272 23.659L10.272 23.659L10.432 23.419L18.432 7.459Q18.552 7.259 18.412 7.079Q18.272 6.899 18.032 6.939L18.032 6.939L15.232 7.459Q15.032 7.499 14.892 7.359Q14.752 7.219 14.832 7.019L14.832 7.019L16.672 0.659Q16.712 0.459 16.572 0.299Q16.432 0.139 16.232 0.179Z"/>',
 	'seti:vue':
 		'<path d="M6.117 1.659L12.000 11.870L17.883 1.659L14.775 1.659L12.000 6.469L9.225 1.659L6.117 1.659ZM23.951 1.659L19.178 1.659L12.000 14.090L4.822 1.659L0.049 1.659L12.000 22.341L23.951 1.659Z"/>',
 	'seti:wasm':

package/utils/collection.ts

@@ -0,0 +1,45 @@
+import { resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const collectionNames = ['docs', 'i18n'] as const;
+export type StarlightCollection = (typeof collectionNames)[number];
+
+/**
+ * We still rely on the content collection folder structure to be fixed for now:
+ *
+ * - At build time, if the feature is enabled, we get all the last commit dates for each file in
+ *   the docs folder ahead of time. In the current approach, we cannot know at this time the
+ *   user-defined content folder path in the integration context as this would only be available
+ *   from the loader. A potential solution could be to do that from a custom loader re-implementing
+ *   the glob loader or built on top of it. Although, we don't have access to the Starlight
+ *   configuration from the loader to even know we should do that.
+ * - Remark plugins get passed down an absolute path to a content file and we need to figure out
+ *   the language from that path. Without knowing the content folder path, we cannot reliably do
+ *   so.
+ *
+ * Below are various functions to easily get paths to these collections and avoid having to
+ * hardcode them throughout the codebase. When user-defined content folder locations are supported,
+ * these helper functions should be updated to reflect that in one place.
+ */
+
+export function getCollectionPath(collection: StarlightCollection, srcDir: URL) {
+	return new URL(`content/${collection}/`, srcDir).pathname;
+}
+
+export function resolveCollectionPath(collection: StarlightCollection, srcDir: URL) {
+	return resolve(fileURLToPath(srcDir), `content/${collection}`);
+}
+
+export function getCollectionPathFromRoot(
+	collection: StarlightCollection,
+	{ root, srcDir }: { root: URL | string; srcDir: URL | string }
+) {
+	return (
+		(typeof srcDir === 'string' ? srcDir : srcDir.pathname).replace(
+			typeof root === 'string' ? root : root.pathname,
+			''
+		) +
+		'content/' +
+		collection
+	);
+}

package/utils/git.ts

@@ -55,8 +55,8 @@ function getRepoRoot(directory: string): string {
 	}
 }
 
-export function getAllNewestCommitDate(directory: string): [string, number][] {
-	const repoRoot = getRepoRoot(directory);
+export function getAllNewestCommitDate(rootPath: string, docsPath: string): [string, number][] {
+	const repoRoot = getRepoRoot(docsPath);
 
 	const gitLog = spawnSync(
 		'git',
@@ -67,7 +67,7 @@ export function getAllNewestCommitDate(directory: string): [string, number][] {
 			// In each entry include the name and status for each modified file
 			'--name-status',
 			'--',
-			directory,
+			docsPath,
 		],
 		{
 			cwd: repoRoot,
@@ -105,7 +105,9 @@ export function getAllNewestCommitDate(directory: string): [string, number][] {
 
 	return Array.from(latestDates.entries()).map(([file, date]) => {
 		const fileFullPath = resolve(repoRoot, file);
-		const fileInDirectory = relative(directory, fileFullPath);
+		let fileInDirectory = relative(rootPath, fileFullPath);
+		// Format path to unix style path.
+		fileInDirectory = fileInDirectory?.replace(/\\/g, '/');
 
 		return [fileInDirectory, date];
 	});

package/utils/navigation.ts

@@ -205,8 +205,8 @@ function pathsMatch(pathA: string, pathB: string) {
 function getBreadcrumbs(path: string, baseDir: string): string[] {
 	// Strip extension from path.
 	const pathWithoutExt = stripExtension(path);
-	// Index paths will match `baseDir` and don’t include breadcrumbs.
-	if (pathWithoutExt === baseDir) return [];
+	// Index paths will match `baseDir` but we still need to consider them as a single segment.
+	if (pathWithoutExt === baseDir) return [path];
 	// Ensure base directory ends in a trailing slash.
 	baseDir = ensureTrailingSlash(baseDir);
 	// Strip base directory from path if present.

package/utils/plugins.ts

@@ -2,7 +2,6 @@ import type { AstroIntegration, HookParameters } from 'astro';
 import { z } from 'astro/zod';
 import { StarlightConfigSchema, type StarlightUserConfig } from '../utils/user-config';
 import { parseWithFriendlyErrors } from '../utils/error-map';
-import { AstroError } from 'astro/errors';
 import type { UserI18nSchema } from './translations';
 
 /**
@@ -83,14 +82,6 @@ export async function runPlugins(
 		});
 	}
 
-	if (context.config.output === 'static' && !starlightConfig.prerender) {
-		throw new AstroError(
-			'Starlight’s `prerender: false` option requires `output: "hybrid"` or `"server"` in your Astro config.',
-			'Either set `output` in your Astro config or set `prerender: true` in the Starlight options.\n\n' +
-				'Learn more about rendering modes in the Astro docs: https://docs.astro.build/en/basics/rendering-modes/'
-		);
-	}
-
 	return { integrations, starlightConfig, pluginTranslations };
 }
 

package/utils/route-data.ts

@@ -1,12 +1,10 @@
 import type { MarkdownHeading } from 'astro';
-import project from 'virtual:starlight/project-context';
 import config from 'virtual:starlight/user-config';
 import { generateToC, type TocItem } from './generateToC';
 import { getNewestCommitDate } from 'virtual:starlight/git-info';
 import { getPrevNextLinks, getSidebar, type SidebarEntry } from './navigation';
 import { ensureTrailingSlash } from './path';
 import type { Route } from './routing';
-import { localizedId } from './slugs';
 import { formatPath } from './format-path';
 import { useTranslations } from './translations';
 import { DeprecatedLabelsPropProxy } from './i18n';
@@ -85,7 +83,7 @@ function getLastUpdated({ entry }: PageProps): Date | undefined {
 		try {
 			return frontmatterLastUpdated instanceof Date
 				? frontmatterLastUpdated
-				: getNewestCommitDate(entry.id);
+				: getNewestCommitDate(entry.filePath);
 		} catch {
 			// If the git command fails, ignore the error.
 			return undefined;
@@ -95,7 +93,7 @@ function getLastUpdated({ entry }: PageProps): Date | undefined {
 	return undefined;
 }
 
-function getEditUrl({ entry, id, isFallback }: PageProps): URL | undefined {
+function getEditUrl({ entry }: PageProps): URL | undefined {
 	const { editUrl } = entry.data;
 	// If frontmatter value is false, editing is disabled for this page.
 	if (editUrl === false) return;
@@ -105,10 +103,8 @@ function getEditUrl({ entry, id, isFallback }: PageProps): URL | undefined {
 		// If a URL was provided in frontmatter, use that.
 		url = editUrl;
 	} else if (config.editLink.baseUrl) {
-		const srcPath = project.srcDir.replace(project.root, '');
-		const filePath = isFallback ? localizedId(id, config.defaultLocale.locale) : id;
 		// If a base URL was added in Starlight config, synthesize the edit URL from it.
-		url = ensureTrailingSlash(config.editLink.baseUrl) + srcPath + 'content/docs/' + filePath;
+		url = ensureTrailingSlash(config.editLink.baseUrl) + entry.filePath;
 	}
 	return url ? new URL(url) : undefined;
 }

package/utils/routing.ts

@@ -1,6 +1,8 @@
 import type { GetStaticPathsItem } from 'astro';
 import { type CollectionEntry, getCollection } from 'astro:content';
 import config from 'virtual:starlight/user-config';
+import project from 'virtual:starlight/project-context';
+import { getCollectionPathFromRoot } from './collection';
 import {
 	type LocaleData,
 	localizedId,
@@ -15,7 +17,22 @@ import { BuiltInDefaultLocale } from './i18n';
 // We do this here so all pages trigger it and at the top level so it runs just once.
 validateLogoImports();
 
-export type StarlightDocsEntry = Omit<CollectionEntry<'docs'>, 'slug'> & {
+// The type returned from `CollectionEntry` is different for legacy collections and collections
+// using a loader. This type is a common subset of both types.
+export type StarlightDocsCollectionEntry = Omit<
+	CollectionEntry<'docs'>,
+	'id' | 'filePath' | 'render' | 'slug'
+> & {
+	// Update the `id` property to be a string like in the loader type.
+	id: string;
+	// Add the `filePath` property which is only present in the loader type.
+	filePath?: string;
+	// Add the `slug` property which is only present in the legacy type.
+	slug?: string;
+};
+
+export type StarlightDocsEntry = StarlightDocsCollectionEntry & {
+	filePath: string;
 	slug: string;
 };
 
@@ -24,9 +41,9 @@ export interface Route extends LocaleData {
 	entry: StarlightDocsEntry;
 	/** Locale metadata for the page content. Can be different from top-level locale values when a page is using fallback content. */
 	entryMeta: LocaleData;
-	/** The slug, a.k.a. permalink, for this page. */
+	/** @deprecated Migrate to the new Content Layer API and use `id` instead. */
 	slug: string;
-	/** The unique ID for this page. */
+	/** The slug or unique ID if using the `legacy.collections` flag. */
 	id: string;
 	/** True if this page is untranslated in the current language and using fallback content from the default locale. */
 	isFallback?: true;
@@ -45,16 +62,27 @@ interface Path extends GetStaticPathsItem {
  */
 const normalizeIndexSlug = (slug: string) => (slug === 'index' ? '' : slug);
 
+/** Normalize the different collection entry we can get from a legacy collection or a loader. */
+export function normalizeCollectionEntry(entry: StarlightDocsCollectionEntry): StarlightDocsEntry {
+	const slug = normalizeIndexSlug(entry.slug ?? entry.id);
+	return {
+		...entry,
+		// In a collection with a loader, the `id` is a slug and should be normalized.
+		id: entry.slug ? entry.id : slug,
+		// In a legacy collection, the `filePath` property doesn't exist.
+		filePath: entry.filePath ?? `${getCollectionPathFromRoot('docs', project)}/${entry.id}`,
+		// In a collection with a loader, the `slug` property is replaced by the `id`.
+		slug: normalizeIndexSlug(entry.slug ?? entry.id),
+	};
+}
+
 /** All entries in the docs content collection. */
 const docs: StarlightDocsEntry[] = (
 	(await getCollection('docs', ({ data }) => {
 		// In production, filter out drafts.
 		return import.meta.env.MODE !== 'production' || data.draft === false;
 	})) ?? []
-).map(({ slug, ...entry }) => ({
-	...entry,
-	slug: normalizeIndexSlug(slug),
-}));
+).map(normalizeCollectionEntry);
 
 function getRoutes(): Route[] {
 	const routes: Route[] = docs.map((entry) => ({
@@ -79,7 +107,7 @@ 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 id = project.legacyCollections ? localizedId(fallback.id, locale) : slug;
 				const doesNotNeedFallback = localeDocs.some((doc) => doc.slug === slug);
 				if (doesNotNeedFallback) continue;
 				routes.push({

package/utils/slugs.ts

@@ -82,7 +82,7 @@ export function localizedSlug(slug: string, locale: string | undefined): string
 }
 
 /**
- * Convert a collection entry ID to a different locale.
+ * Convert a legacy 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

package/utils/starlight-page.ts

@@ -1,6 +1,8 @@
 import { z } from 'astro/zod';
 import { type ContentConfig, type SchemaContext } from 'astro:content';
+import project from 'virtual:starlight/project-context';
 import config from 'virtual:starlight/user-config';
+import { getCollectionPathFromRoot } from './collection';
 import { parseWithFriendlyErrors, parseAsyncWithFriendlyErrors } from './error-map';
 import { stripLeadingAndTrailingSlashes } from './path';
 import {
@@ -97,8 +99,8 @@ export type StarlightPageProps = Prettify<
  */
 type StarlightPageDocsEntry = Omit<StarlightDocsEntry, 'id' | 'render'> & {
 	/**
-	 * The unique ID for this Starlight page which cannot be inferred from codegen like content
-	 * collection entries.
+	 * The unique ID if using the `legacy.collections` for this Starlight page which cannot be
+	 * inferred from codegen like content collection entries or the slug.
 	 */
 	id: string;
 };
@@ -113,7 +115,7 @@ export async function generateStarlightPageRouteData({
 	const { isFallback, frontmatter, ...routeProps } = props;
 	const slug = urlToSlug(url);
 	const pageFrontmatter = await getStarlightPageFrontmatter(frontmatter);
-	const id = `${stripLeadingAndTrailingSlashes(slug)}.md`;
+	const id = project.legacyCollections ? `${stripLeadingAndTrailingSlashes(slug)}.md` : slug;
 	const localeData = slugToLocaleData(slug);
 	const sidebar = props.sidebar
 		? getSidebarFromConfig(validateSidebarProp(props.sidebar), url.pathname, localeData.locale)
@@ -124,6 +126,7 @@ export async function generateStarlightPageRouteData({
 		slug,
 		body: '',
 		collection: 'docs',
+		filePath: `${getCollectionPathFromRoot('docs', project)}/${stripLeadingAndTrailingSlashes(slug)}.md`,
 		data: {
 			...pageFrontmatter,
 			sidebar: {

package/virtual-internal.d.ts

@@ -6,6 +6,7 @@ declare module 'virtual:starlight/project-context' {
 		build: {
 			format: import('astro').AstroConfig['build']['format'];
 		};
+		legacyCollections: boolean;
 	};
 	export default ProjectContext;
 }