@astrojs/starlight 0.41.11 → 0.42.0

package/utils/routing/index.ts

@@ -1,139 +0,0 @@
-import type { GetStaticPathsItem } from 'astro';
-import { getCollection } from 'astro:content';
-import config from 'virtual:starlight/user-config';
-import { localizedSlug, slugToLocaleData, slugToParam } from '../slugs';
-import { validateLogoImports } from '../validateLogoImports';
-import { BuiltInDefaultLocale } from '../i18n';
-import type { Route, StarlightDocsCollectionEntry, StarlightDocsEntry } from './types';
-
-// Validate any user-provided logos imported correctly.
-// We do this here so all pages trigger it and at the top level so it runs just once.
-validateLogoImports();
-
-interface Path extends GetStaticPathsItem {
-	params: { slug: string | undefined };
-}
-
-/**
- * Astro is inconsistent in its `index.md` slug generation. In most cases,
- * `index` is stripped, but in the root of a collection, we get a slug of `index`.
- * We map that to an empty string for consistent behaviour.
- */
-const normalizeIndexSlug = (slug: string) => (slug === 'index' ? '' : slug);
-
-/** Normalize a collection entry. */
-export function normalizeCollectionEntry(entry: StarlightDocsCollectionEntry): StarlightDocsEntry {
-	return {
-		...entry,
-		// The `id` is a slug and should be normalized.
-		id: normalizeIndexSlug(entry.id),
-		// At the moment, Starlight only supports file-based loaders which always include a `filePath`.
-		filePath: entry.filePath!,
-	};
-}
-
-/** 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(normalizeCollectionEntry);
-
-function getRoutes(): Route[] {
-	const routes: Route[] = docs.map((entry) => ({
-		entry,
-		id: entry.id,
-		entryMeta: slugToLocaleData(entry.id),
-		...slugToLocaleData(entry.id),
-	}));
-
-	// In multilingual sites, add required fallback routes.
-	if (config.isMultilingual) {
-		/** Entries in the docs content collection for the default locale. */
-		const defaultLocaleDocs = getLocaleDocs(
-			config.defaultLocale?.locale === 'root' ? undefined : config.defaultLocale?.locale
-		);
-		for (const key in config.locales) {
-			if (key === config.defaultLocale.locale) continue;
-			const localeConfig = config.locales[key];
-			if (!localeConfig) continue;
-			const locale = key === 'root' ? undefined : key;
-			const localeDocs = getLocaleDocs(locale);
-			const localeDocIds = new Set(localeDocs.map(({ id }) => id));
-			for (const fallback of defaultLocaleDocs) {
-				const id = localizedSlug(fallback.id, locale);
-				if (localeDocIds.has(id)) continue;
-				routes.push({
-					entry: fallback,
-					id,
-					isFallback: true,
-					lang: localeConfig.lang || BuiltInDefaultLocale.lang,
-					locale,
-					dir: localeConfig.dir,
-					entryMeta: slugToLocaleData(fallback.id),
-				});
-			}
-		}
-	}
-
-	return routes;
-}
-export const routes = getRoutes();
-
-const routesById = new Map(routes.map((route) => [route.id, route]));
-
-export function getRouteById(id: string): Route | undefined {
-	return routesById.get(id);
-}
-
-function getParamRouteMapping(): ReadonlyMap<string | undefined, Route> {
-	const map = new Map<string | undefined, Route>();
-	for (const route of routes) {
-		map.set(slugToParam(route.id), route);
-	}
-	return map;
-}
-const routesBySlugParam = getParamRouteMapping();
-
-export function getRouteBySlugParam(slugParam: string | undefined): Route | undefined {
-	return routesBySlugParam.get(slugParam?.replace(/\/$/, '') || undefined);
-}
-
-function getPaths(): Path[] {
-	return routes.map((route) => ({
-		params: { slug: slugToParam(route.id) },
-	}));
-}
-export const paths = getPaths();
-
-/**
- * Get all routes for a specific locale.
- * A locale of `undefined` is treated as the “root” locale, if configured.
- */
-export function getLocaleRoutes(locale: string | undefined): Route[] {
-	return filterByLocale(routes, locale);
-}
-
-/**
- * Get all entries in the docs content collection for a specific locale.
- * A locale of `undefined` is treated as the “root” locale, if configured.
- */
-function getLocaleDocs(locale: string | undefined): StarlightDocsEntry[] {
-	return filterByLocale(docs, locale);
-}
-
-/** Filter an array to find items whose slug matches the passed locale. */
-function filterByLocale<T extends { id: string }>(items: T[], locale: string | undefined): T[] {
-	if (config.locales) {
-		if (locale && locale in config.locales) {
-			return items.filter((i) => i.id === locale || i.id.startsWith(locale + '/'));
-		} else if (config.locales.root) {
-			const langKeys = Object.keys(config.locales).filter((k) => k !== 'root');
-			const isLangIndex = new RegExp(`^(${langKeys.join('|')})$`);
-			const isLangDir = new RegExp(`^(${langKeys.join('|')})/`);
-			return items.filter((i) => !isLangIndex.test(i.id) && !isLangDir.test(i.id));
-		}
-	}
-	return items;
-}

package/utils/routing/middleware.ts

@@ -1,81 +0,0 @@
-import type { APIContext } from 'astro';
-import { klona } from 'klona/lite';
-import { routeMiddleware } from 'virtual:starlight/route-middleware';
-import type { StarlightRouteData } from './types';
-
-/**
- * Adds a deep clone of the passed `routeData` object to locals and then runs middleware.
- * @param context Astro context object
- * @param routeData Initial route data object to attach.
- */
-export async function attachRouteDataAndRunMiddleware(
-	context: APIContext,
-	routeData: StarlightRouteData
-) {
-	context.locals.starlightRoute = klona(routeData);
-	const runner = new MiddlewareRunner(context, routeMiddleware);
-	await runner.run();
-}
-
-type MiddlewareHandler<T> = (context: T, next: () => Promise<void>) => void | Promise<void>;
-
-/**
- * A middleware function wrapper that only allows a single execution of the wrapped function.
- * Subsequent calls to `run()` are no-ops.
- */
-class MiddlewareRunnerStep<T> {
-	#callback: MiddlewareHandler<T> | null;
-	constructor(callback: MiddlewareHandler<T>) {
-		this.#callback = callback;
-	}
-	async run(context: T, next: () => Promise<void>): Promise<void> {
-		if (this.#callback) {
-			await this.#callback(context, next);
-			this.#callback = null;
-		}
-	}
-}
-
-/**
- * Class that runs a stack of middleware handlers with an initial context object.
- * Middleware functions can mutate properties of the `context` object, but cannot replace it.
- *
- * @example
- * const context = { value: 10 };
- * const timesTwo = async (ctx, next) => {
- *   await next();
- *   ctx.value *= 2;
- * };
- * const addFive = async (ctx) => {
- *   ctx.value += 5;
- * }
- * const runner = new MiddlewareRunner(context, [timesTwo, addFive]);
- * runner.run();
- * console.log(context); // { value: 30 }
- */
-class MiddlewareRunner<T> {
-	#context: T;
-	#steps: Array<MiddlewareRunnerStep<T>>;
-
-	constructor(
-		/** Context object passed as the first argument to each middleware function. */
-		context: T,
-		/** Array of middleware functions to run in sequence. */
-		stack: Array<MiddlewareHandler<T>> = []
-	) {
-		this.#context = context;
-		this.#steps = stack.map((callback) => new MiddlewareRunnerStep(callback));
-	}
-
-	async #stepThrough(steps: Array<MiddlewareRunnerStep<T>>) {
-		let currentStep: MiddlewareRunnerStep<T>;
-		while (steps.length > 0) {
-			[currentStep, ...steps] = steps as [MiddlewareRunnerStep<T>, ...MiddlewareRunnerStep<T>[]];
-			await currentStep.run(this.#context, async () => this.#stepThrough(steps));
-		}
-	}
-
-	async run() {
-		await this.#stepThrough(this.#steps);
-	}
-}

package/utils/routing/types.ts

@@ -1,101 +0,0 @@
-import type { MarkdownHeading } from 'astro';
-import type { CollectionEntry, RenderResult } from 'astro:content';
-import type { TocItem } from '../generateToC';
-import type { LinkHTMLAttributes } from '../../schemas/sidebar';
-import type { Badge } from '../../schemas/badge';
-import type { HeadConfig } from '../../schemas/head';
-
-export interface LocaleData {
-	/** Writing direction. */
-	dir: 'ltr' | 'rtl';
-	/** BCP-47 language tag. */
-	lang: string;
-	/** The base path at which a language is served. `undefined` for root locale slugs. */
-	locale: string | undefined;
-}
-
-export interface SidebarAutogenerateRouteData {
-	directory: string;
-}
-
-export interface SidebarManualLink {
-	type: 'link';
-	label: string;
-	href: string;
-	isCurrent: boolean;
-	badge: Badge | undefined;
-	attrs: LinkHTMLAttributes;
-}
-
-export interface SidebarAutoLink extends SidebarManualLink {
-	autogenerate: SidebarAutogenerateRouteData;
-}
-
-export interface SidebarManualGroup {
-	type: 'group';
-	label: string;
-	entries: (SidebarLink | SidebarGroup)[];
-	collapsed: boolean;
-	badge: Badge | undefined;
-}
-
-export interface SidebarAutoGroup extends SidebarManualGroup {
-	autogenerate: SidebarAutogenerateRouteData;
-}
-
-export type SidebarLink = SidebarManualLink | SidebarAutoLink;
-export type SidebarGroup = SidebarManualGroup | SidebarAutoGroup;
-export type SidebarEntry = SidebarLink | SidebarGroup;
-
-export interface PaginationLinks {
-	/** Link to previous page in the sidebar. */
-	prev: SidebarLink | undefined;
-	/** Link to next page in the sidebar. */
-	next: SidebarLink | undefined;
-}
-
-// A type representing a docs collection entry returned by the `docsLoader()`.
-export type StarlightDocsCollectionEntry = CollectionEntry<'docs'>;
-
-// A normalized type representing a docs collection entry used throughout Starlight.
-export type StarlightDocsEntry = StarlightDocsCollectionEntry & {
-	// At the moment, Starlight only supports file-based loaders which always include a `filePath`.
-	filePath: string;
-};
-
-export interface Route extends LocaleData {
-	/** Content collection entry for the current page. Includes frontmatter at `data`. */
-	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. */
-	id: string;
-	/** Whether this page is untranslated in the current language and using fallback content from the default locale. */
-	isFallback?: boolean;
-	[key: string]: unknown;
-}
-
-export interface StarlightRouteData extends Route {
-	/** Title of the site. */
-	siteTitle: string;
-	/** URL or path used as the link when clicking on the site title. */
-	siteTitleHref: string;
-	/** Array of Markdown headings extracted from the current page. */
-	headings: MarkdownHeading[];
-	/** Site navigation sidebar entries for this page. */
-	sidebar: SidebarEntry[];
-	/** Whether or not the sidebar should be displayed on this page. */
-	hasSidebar: boolean;
-	/** Links to the previous and next page in the sidebar if enabled. */
-	pagination: PaginationLinks;
-	/** Table of contents for this page if enabled. */
-	toc: { minHeadingLevel: number; maxHeadingLevel: number; items: TocItem[] } | undefined;
-	/** JS Date object representing when this page was last updated if enabled. */
-	lastUpdated: Date | undefined;
-	/** URL object for the address where this page can be edited if enabled. */
-	editUrl: URL | undefined;
-	/** An Astro component to render the current page’s content if this route is a Markdown page. */
-	Content?: RenderResult['Content'];
-	/** Array of tags to include in the `<head>` of the current page. */
-	head: HeadConfig;
-}

package/utils/slugs.ts

@@ -1,119 +0,0 @@
-import config from 'virtual:starlight/user-config';
-import { slugToLocale as getLocaleFromSlug } from '../integrations/shared/slugToLocale';
-import { BuiltInDefaultLocale } from './i18n';
-import { stripTrailingSlash } from './path';
-import type { LocaleData } from './routing/types';
-
-/**
- * Get the “locale” of a slug. This is the base path at which a language is served.
- * For example, if French docs are in `src/content/docs/french/`, the locale is `french`.
- * Root locale slugs will return `undefined`.
- * @param slug A collection entry slug
- */
-function slugToLocale(slug: string): string | undefined {
-	return getLocaleFromSlug(slug, config);
-}
-
-/** Get locale information for a given slug. */
-export function slugToLocaleData(slug: string): LocaleData {
-	const locale = slugToLocale(slug);
-	return { dir: localeToDir(locale), lang: localeToLang(locale), locale };
-}
-
-/**
- * Get the BCP-47 language tag for the given locale.
- * @param locale Locale string or `undefined` for the root locale.
- */
-export function localeToLang(locale: string | undefined): string {
-	const lang = locale ? config.locales?.[locale]?.lang : config.locales?.root?.lang;
-	const defaultLang = config.defaultLocale?.lang || config.defaultLocale?.locale;
-	return lang || defaultLang || BuiltInDefaultLocale.lang;
-}
-
-/**
- * Get the configured writing direction for the given locale.
- * @param locale Locale string or `undefined` for the root locale.
- */
-function localeToDir(locale: string | undefined): 'ltr' | 'rtl' {
-	const dir = locale ? config.locales?.[locale]?.dir : config.locales?.root?.dir;
-	return dir || config.defaultLocale.dir;
-}
-
-/**
- * Convert a content collection slug to a param as expected by Astro’s router.
- * This utility handles stripping `index` from file names and matches
- * [Astro’s param sanitization logic](https://github.com/withastro/astro/blob/687d25365a41ff8a9e6da155d3527f841abb70dd/packages/astro/src/core/routing/manifest/generator.ts#L4-L18)
- * by normalizing strings to their canonical representations.
- * @param slug Content collection slug
- * @returns Param compatible with Astro’s router
- */
-export function slugToParam(slug: string): string | undefined {
-	return slug === 'index' || slug === '' || slug === '/'
-		? undefined
-		: (slug.endsWith('/index') ? slug.slice(0, -6) : slug).normalize();
-}
-
-export function slugToPathname(slug: string): string {
-	const param = slugToParam(slug);
-	return param ? '/' + param + '/' : '/';
-}
-
-/**
- * Convert a slug to a different locale.
- * For example, passing a slug of `en/home` and a locale of `fr` results in `fr/home`.
- * An undefined locale is treated as the root locale, resulting in `home`
- * @param slug A collection entry slug
- * @param locale The target locale
- * @example
- * localizedSlug('en/home', 'fr')       // => 'fr/home'
- * localizedSlug('en/home', undefined)  // => 'home'
- */
-export function localizedSlug(slug: string, locale: string | undefined): string {
-	const slugLocale = slugToLocale(slug);
-	if (slugLocale === locale) return slug;
-	locale = locale || '';
-	if (slugLocale === slug) return locale;
-	if (slugLocale) {
-		return stripTrailingSlash(slug.replace(slugLocale + '/', locale ? locale + '/' : ''));
-	}
-	return slug ? locale + '/' + slug : locale;
-}
-
-/**
- * Convert a file path relative to the collection root to a different locale.
- * For example, passing a file path 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 filePath A collection entry file path relative to the collection root
- * @param locale The target locale
- * @example
- * localizedFilePath('en/home.md', 'fr')       // => 'fr/home.md'
- * localizedFilePath('en/home.md', undefined)  // => 'home.md'
- */
-export function localizedFilePath(filePath: string, locale: string | undefined): string {
-	const filePathLocale = slugToLocale(filePath);
-	if (filePathLocale) {
-		return filePath.replace(filePathLocale + '/', locale ? locale + '/' : '');
-	} else if (locale) {
-		return locale + '/' + filePath;
-	} else {
-		return filePath;
-	}
-}
-
-/** Extract the slug from a URL. */
-export function urlToSlug(url: URL): string {
-	let pathname = url.pathname;
-	const base = stripTrailingSlash(import.meta.env.BASE_URL);
-	if (pathname.startsWith(base)) pathname = pathname.replace(base, '');
-	const segments = pathname.split('/');
-	const htmlExt = '.html';
-	if (segments.at(-1) === 'index.html') {
-		// Remove trailing `index.html`.
-		segments.pop();
-	} else if (segments.at(-1)?.endsWith(htmlExt)) {
-		// Remove trailing `.html`.
-		const last = segments.pop();
-		if (last) segments.push(last.slice(0, -1 * htmlExt.length));
-	}
-	return segments.filter(Boolean).join('/');
-}

package/utils/starlight-page.ts

@@ -1,205 +0,0 @@
-import { z } from 'astro/zod';
-import { type ContentConfig, type ImageFunction, 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 {
-	getSiteTitle,
-	getSiteTitleHref,
-	getToC,
-	type PageProps,
-	type RouteDataContext,
-} from './routing/data';
-import type { StarlightDocsEntry, StarlightRouteData } from './routing/types';
-import { slugToLocaleData, urlToSlug } from './slugs';
-import { getPrevNextLinks, getSidebar, getSidebarFromConfig } from './navigation';
-import { docsSchema } from '../schema';
-import type { Prettify, RemoveIndexSignature } from './types';
-import { SidebarItemSchema } from '../schemas/sidebar';
-import type { StarlightConfig, StarlightUserConfig } from './user-config';
-import { getHead } from './head';
-
-/**
- * The frontmatter schema for Starlight pages derived from the default schema for Starlight’s
- * `docs` content collection.
- * The frontmatter schema for Starlight pages cannot include some properties which will be omitted
- * and some others needs to be refined to a stricter type.
- */
-const StarlightPageFrontmatterSchema = async (context: SchemaContext) => {
-	const userDocsSchema = await getUserDocsSchema();
-	const schema = typeof userDocsSchema === 'function' ? userDocsSchema(context) : userDocsSchema;
-
-	return schema.transform((frontmatter) => {
-		/**
-		 * Starlight pages can only be edited if an edit URL is explicitly provided.
-		 * The `sidebar` frontmatter prop only works for pages in an autogenerated links group.
-		 * Starlight pages edit links cannot be autogenerated.
-		 *
-		 * These changes to the schema are done using a transformer and not using the usual `omit`
-		 * method because when the frontmatter schema is extended by the user, an intersection between
-		 * the default schema and the user schema is created using the `and` method. Intersections in
-		 * Zod returns a `ZodIntersection` object which does not have some methods like `omit` or
-		 * `pick`.
-		 *
-		 * This transformer only sets the `editUrl` default value and removes the `sidebar` property
-		 * from the validated output but does not apply any changes to the input schema type itself so
-		 * this needs to be done manually.
-		 *
-		 * @see StarlightPageFrontmatter
-		 * @see https://github.com/colinhacks/zod#intersections
-		 */
-		const { editUrl, sidebar, ...others } = frontmatter;
-		const pageEditUrl = editUrl === undefined || editUrl === true ? false : editUrl;
-		return { ...others, editUrl: pageEditUrl };
-	});
-};
-
-/**
- * Type of Starlight pages frontmatter schema.
- * We manually refines the `editUrl` type and omit the `sidebar` property as it's not possible to
- * do that on the schema itself using Zod but the proper validation is still using a transformer.
- * @see StarlightPageFrontmatterSchema
- */
-type StarlightPageFrontmatter = Omit<
-	z.input<Awaited<ReturnType<typeof StarlightPageFrontmatterSchema>>>,
-	'editUrl' | 'sidebar'
-> & { editUrl?: string | false };
-
-/** Parse sidebar prop to ensure it's valid. */
-const validateSidebarProp = (
-	sidebarProp: StarlightUserConfig['sidebar']
-): StarlightConfig['sidebar'] => {
-	return parseWithFriendlyErrors(
-		SidebarItemSchema.array().optional(),
-		sidebarProp,
-		'Invalid sidebar prop passed to the `<StarlightPage/>` component.'
-	);
-};
-
-/**
- * The props accepted by the `<StarlightPage/>` component.
- */
-export type StarlightPageProps = Prettify<
-	// Remove the index signature from `Route`, omit undesired properties and make the rest optional.
-	Partial<Omit<RemoveIndexSignature<PageProps>, 'entry' | 'entryMeta' | 'id' | 'locale'>> &
-		// Add the sidebar definitions for a Starlight page.
-		Partial<Pick<StarlightRouteData, 'hasSidebar'>> & {
-			sidebar?: StarlightUserConfig['sidebar'];
-			// And finally add the Starlight page frontmatter properties in a `frontmatter` property.
-			frontmatter: StarlightPageFrontmatter;
-		}
->;
-
-/**
- * A docs entry used for Starlight pages meant to be rendered by plugins and which is safe to cast
- * to a `StarlightDocsEntry`.
- * A Starlight page docs entry cannot be rendered like a content collection entry.
- */
-type StarlightPageDocsEntry = Omit<StarlightDocsEntry, 'render'>;
-
-export async function generateStarlightPageRouteData({
-	props,
-	context,
-}: {
-	props: StarlightPageProps;
-	context: RouteDataContext;
-}): Promise<StarlightRouteData> {
-	const { frontmatter, ...routeProps } = props;
-	const { url } = context;
-	const id = urlToSlug(url);
-	const pageFrontmatter = await getStarlightPageFrontmatter(frontmatter);
-	const localeData = slugToLocaleData(id);
-	const sidebar = props.sidebar
-		? getSidebarFromConfig(validateSidebarProp(props.sidebar), url.pathname, localeData.locale)
-		: getSidebar(url.pathname, localeData.locale);
-	const headings = props.headings ?? [];
-	const pageDocsEntry: StarlightPageDocsEntry = {
-		id,
-		body: '',
-		collection: 'docs',
-		filePath: `${getCollectionPathFromRoot('docs', project)}/${stripLeadingAndTrailingSlashes(id)}.md`,
-		data: {
-			...pageFrontmatter,
-			sidebar: {
-				attrs: {},
-				hidden: false,
-			},
-		},
-	};
-	const entry = pageDocsEntry as StarlightDocsEntry;
-	const entryMeta: StarlightRouteData['entryMeta'] = {
-		dir: props.dir ?? localeData.dir,
-		lang: props.lang ?? localeData.lang,
-		locale: localeData.locale,
-	};
-	const editUrl = pageFrontmatter.editUrl ? new URL(pageFrontmatter.editUrl) : undefined;
-	const lastUpdated =
-		pageFrontmatter.lastUpdated instanceof Date ? pageFrontmatter.lastUpdated : undefined;
-	const pageProps: PageProps = {
-		...routeProps,
-		...localeData,
-		entry,
-		entryMeta,
-		headings,
-		id,
-		locale: localeData.locale,
-	};
-	const siteTitle = getSiteTitle(localeData.lang);
-	const routeData: StarlightRouteData = {
-		...routeProps,
-		...localeData,
-		id,
-		editUrl,
-		entry,
-		entryMeta,
-		hasSidebar: props.hasSidebar ?? entry.data.template !== 'splash',
-		head: getHead(pageProps, context, siteTitle),
-		headings,
-		lastUpdated,
-		pagination: getPrevNextLinks(sidebar, config.pagination, entry.data),
-		sidebar,
-		siteTitle,
-		siteTitleHref: getSiteTitleHref(localeData.locale),
-		toc: getToC(pageProps),
-	};
-	return routeData;
-}
-
-/** Validates the Starlight page frontmatter properties from the props received by a Starlight page. */
-async function getStarlightPageFrontmatter(frontmatter: StarlightPageFrontmatter) {
-	const schema = await StarlightPageFrontmatterSchema({
-		image: (() =>
-			// Mock validator for ImageMetadata.
-			// https://github.com/withastro/astro/blob/cf993bc263b58502096f00d383266cd179f331af/packages/astro/src/assets/types.ts#L32
-			// It uses a custom validation approach because imported SVGs have a type of `function` as
-			// well as containing the metadata properties and this ensures we handle those correctly.
-			z.custom<ReturnType<ImageFunction>>(
-				(value) =>
-					value &&
-					(typeof value === 'function' || typeof value === 'object') &&
-					'src' in value &&
-					'width' in value &&
-					'height' in value &&
-					'format' in value,
-				'Invalid image passed to `<StarlightPage>` component. Expected imported `ImageMetadata` object.'
-			)) as unknown as ImageFunction,
-	});
-
-	// Starting with Astro 4.14.0, a frontmatter schema that contains collection references will
-	// contain an async transform.
-	return parseAsyncWithFriendlyErrors(
-		schema,
-		frontmatter,
-		'Invalid frontmatter props passed to the `<StarlightPage/>` component.'
-	);
-}
-
-/** Returns the user docs schema and falls back to the default schema if needed. */
-async function getUserDocsSchema(): Promise<
-	NonNullable<ContentConfig['collections']['docs']['schema']>
-> {
-	const userCollections = (await import('virtual:starlight/collection-config')).collections;
-	return userCollections?.docs?.schema ?? docsSchema();
-}