@astrojs/starlight 0.41.11 → 0.42.0

package/utils/navigation.ts

@@ -1,574 +0,0 @@
-import { AstroError } from 'astro/errors';
-import project from 'virtual:starlight/project-context';
-import config from 'virtual:starlight/user-config';
-import type { Badge, I18nBadge, I18nBadgeConfig } from '../schemas/badge';
-import type { PrevNextLinkConfig } from '../schemas/prevNextLink';
-import type {
-	AutoSidebarEntries,
-	InternalSidebarLinkItem,
-	LinkHTMLAttributes,
-	SidebarItem,
-	SidebarLinkItem,
-} from '../schemas/sidebar';
-import { getCollectionPathFromRoot } from './collection';
-import { createPathFormatter } from './createPathFormatter';
-import { formatPath } from './format-path';
-import { BuiltInDefaultLocale, pickLang } from './i18n';
-import {
-	ensureLeadingSlash,
-	ensureTrailingSlash,
-	stripExtension,
-	stripLeadingAndTrailingSlashes,
-} from './path';
-import { getLocaleRoutes, getRouteById } from './routing';
-import type {
-	SidebarGroup,
-	SidebarLink,
-	SidebarManualLink,
-	PaginationLinks,
-	Route,
-	SidebarEntry,
-	SidebarAutoLink,
-	SidebarAutoGroup,
-	SidebarAutogenerateRouteData,
-} from './routing/types';
-import { localeToLang, localizedFilePath, slugToPathname } from './slugs';
-import { hasProtocol } from './url';
-import type { StarlightConfig } from './user-config';
-
-const DirKey = Symbol('DirKey');
-const SlugKey = Symbol('SlugKey');
-
-const rootAutogenerate: SidebarAutogenerateRouteData = { directory: '' };
-
-const neverPathFormatter = createPathFormatter({ trailingSlash: 'never' });
-const sidebarCollator = new Intl.Collator(localeToLang(undefined));
-
-const docsCollectionPathFromRoot = getCollectionPathFromRoot('docs', project);
-
-/**
- * A representation of the route structure. For each object entry:
- * if it’s a folder, the key is the directory name, and value is the directory
- * content; if it’s a route entry, the key is the last segment of the route, and value
- * is the full entry.
- */
-interface Dir {
-	[DirKey]: undefined;
-	[SlugKey]: string;
-	[item: string]: Dir | Route;
-}
-
-/** Create a new directory object. */
-function makeDir(slug: string): Dir {
-	const dir = {} as Dir;
-	// Add DirKey and SlugKey as non-enumerable properties so that `Object.entries(dir)` ignores them.
-	Object.defineProperty(dir, DirKey, { enumerable: false });
-	Object.defineProperty(dir, SlugKey, { value: slug, enumerable: false });
-	return dir;
-}
-
-/** Test if the passed object is a directory record.  */
-function isDir(data: Record<string, unknown>): data is Dir {
-	return DirKey in data;
-}
-
-/** Convert an item in a user’s sidebar config to a sidebar entry. */
-function configItemToEntry(
-	item: SidebarItem,
-	locale: string | undefined,
-	routes: Route[]
-): SidebarEntry | SidebarEntry[] {
-	if ('link' in item) {
-		return linkFromSidebarLinkItem(item, locale);
-	} else if ('autogenerate' in item) {
-		return entriesFromAutogenerateConfig(item, locale, routes);
-	} else if ('slug' in item) {
-		return linkFromInternalSidebarLinkItem(item, locale);
-	} else {
-		const label = pickLang(item.translations, localeToLang(locale)) || item.label;
-		return {
-			type: 'group',
-			label,
-			entries: item.items.flatMap((i) => configItemToEntry(i, locale, routes)),
-			collapsed: item.collapsed,
-			badge: getSidebarBadge(item.badge, locale, label),
-		};
-	}
-}
-
-/** Autogenerate links and groups from a user’s sidebar config. */
-function entriesFromAutogenerateConfig(
-	item: AutoSidebarEntries,
-	locale: string | undefined,
-	routes: Route[]
-): (SidebarAutoLink | SidebarGroup)[] {
-	const { attrs, collapsed, directory } = item.autogenerate;
-	const localeDir = locale ? locale + '/' + directory : directory;
-	const autogenerate = { directory };
-	const dirDocs = routes.filter((doc) => {
-		const filePathFromContentDir = getRoutePathRelativeToCollectionRoot(doc, locale);
-		return (
-			// Match against `foo.md` or `foo/index.md`.
-			stripExtension(filePathFromContentDir) === localeDir ||
-			// Match against `foo/anything/else.md`.
-			filePathFromContentDir.startsWith(localeDir + '/')
-		);
-	});
-	const tree = treeify(dirDocs, locale, localeDir);
-	return sidebarFromDir(tree, { collapsed: collapsed ?? false, attrs }, autogenerate);
-}
-
-/** Create a link entry from a manual link item in user config. */
-function linkFromSidebarLinkItem(item: SidebarLinkItem, locale: string | undefined) {
-	let href = item.link;
-	if (!hasProtocol(href)) {
-		href = ensureLeadingSlash(href);
-		// Inject current locale into link.
-		if (locale) href = '/' + locale + href;
-	}
-	const label = pickLang(item.translations, localeToLang(locale)) || item.label;
-	return makeSidebarLink({
-		href,
-		label,
-		badge: getSidebarBadge(item.badge, locale, label),
-		attrs: item.attrs,
-	});
-}
-
-/** Create a link entry from an automatic internal link item in user config. */
-function linkFromInternalSidebarLinkItem(
-	item: InternalSidebarLinkItem,
-	locale: string | undefined
-) {
-	// Astro passes root `index.[md|mdx]` entries with a slug of `index`
-	const slug = item.slug === 'index' ? '' : item.slug;
-	const localizedSlug = locale ? (slug ? locale + '/' + slug : locale) : slug;
-	const route = getRouteById(localizedSlug);
-	if (!route) {
-		const hasExternalSlashes = item.slug.at(0) === '/' || item.slug.at(-1) === '/';
-		if (hasExternalSlashes) {
-			throw new AstroError(
-				`The slug \`"${item.slug}"\` specified in the Starlight sidebar config must not start or end with a slash.`,
-				`Please try updating \`"${item.slug}"\` to \`"${stripLeadingAndTrailingSlashes(item.slug)}"\`.`
-			);
-		} else {
-			throw new AstroError(
-				`The slug \`"${item.slug}"\` specified in the Starlight sidebar config does not exist.`,
-				'Update the Starlight config to reference a valid entry slug in the docs content collection.\n' +
-					'Learn more about Astro content collection slugs at https://docs.astro.build/en/reference/modules/astro-content/#getentry'
-			);
-		}
-	}
-	const frontmatter = route.entry.data;
-	const label =
-		pickLang(item.translations, localeToLang(locale)) ||
-		item.label ||
-		frontmatter.sidebar?.label ||
-		frontmatter.title;
-	const badge = item.badge ?? frontmatter.sidebar?.badge;
-	const attrs = { ...frontmatter.sidebar?.attrs, ...item.attrs };
-	return makeSidebarLink({
-		href: slugToPathname(route.id),
-		label,
-		badge: getSidebarBadge(badge, locale, label),
-		attrs,
-	});
-}
-
-interface MakeLinkOptions {
-	autogenerate?: SidebarAutogenerateRouteData | undefined;
-	href: string;
-	label: string;
-	badge?: Badge | undefined;
-	attrs?: LinkHTMLAttributes | undefined;
-}
-
-/** Process sidebar link options to create a link entry. */
-function makeSidebarLink(opts: MakeLinkOptions & { autogenerate?: undefined }): SidebarManualLink;
-function makeSidebarLink(
-	opts: MakeLinkOptions & { autogenerate: SidebarAutogenerateRouteData }
-): SidebarAutoLink;
-function makeSidebarLink({ attrs, badge, href, label, autogenerate }: MakeLinkOptions) {
-	if (!hasProtocol(href)) {
-		href = formatPath(href);
-	}
-	return makeLink({ label, href, badge, attrs, autogenerate });
-}
-
-/** Create a link entry */
-function makeLink({ attrs = {}, badge, autogenerate, ...opts }: MakeLinkOptions): SidebarLink {
-	return {
-		type: 'link',
-		...opts,
-		badge,
-		isCurrent: false,
-		attrs,
-		...(autogenerate ? { autogenerate } : {}),
-	};
-}
-
-/** Get the segments leading to a page. */
-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 [];
-	// Ensure base directory ends in a trailing slash.
-	baseDir = ensureTrailingSlash(baseDir);
-	// Strip base directory from path if present.
-	const relativePath = pathWithoutExt.startsWith(baseDir)
-		? pathWithoutExt.replace(baseDir, '')
-		: pathWithoutExt;
-
-	return relativePath.split('/');
-}
-
-/** Return the path of a route relative to the root of the collection. */
-function getRoutePathRelativeToCollectionRoot(route: Route, locale: string | undefined) {
-	// Use a localized filePath relative to the collection
-	return localizedFilePath(
-		route.entry.filePath.replace(`${docsCollectionPathFromRoot}/`, ''),
-		locale
-	);
-}
-
-/** Turn a flat array of routes into a tree structure. */
-function treeify(routes: Route[], locale: string | undefined, baseDir: string): Dir {
-	const treeRoot: Dir = makeDir(baseDir);
-	routes
-		// Remove any entries that should be hidden
-		.filter((doc) => !doc.entry.data.sidebar.hidden)
-		// Compute the path of each entry from the root of the collection ahead of time.
-		.map((doc) => [getRoutePathRelativeToCollectionRoot(doc, locale), doc] as const)
-		// Sort by depth, to build the tree depth first.
-		.sort(([a], [b]) => b.split('/').length - a.split('/').length)
-		// Build the tree
-		.forEach(([filePathFromContentDir, doc]) => {
-			const parts = getBreadcrumbs(filePathFromContentDir, baseDir);
-			let currentNode = treeRoot;
-
-			parts.forEach((part, index) => {
-				const isLeaf = index === parts.length - 1;
-
-				// Handle directory index pages by renaming them to `index`
-				if (isLeaf && Object.hasOwn(currentNode, part)) {
-					currentNode = currentNode[part] as Dir;
-					part = 'index';
-				}
-
-				// Recurse down the tree if this isn’t the leaf node.
-				if (!isLeaf) {
-					const path = currentNode[SlugKey];
-					currentNode[part] ||= makeDir(stripLeadingAndTrailingSlashes(path + '/' + part));
-					currentNode = currentNode[part] as Dir;
-				} else {
-					currentNode[part] = doc;
-				}
-			});
-		});
-
-	return treeRoot;
-}
-
-/** Create a link entry for a given content collection entry. */
-function linkFromRoute(
-	route: Route,
-	attrs: LinkHTMLAttributes | undefined,
-	autogenerate: SidebarAutogenerateRouteData
-): SidebarAutoLink {
-	return makeSidebarLink({
-		href: slugToPathname(route.id),
-		label: route.entry.data.sidebar.label || route.entry.data.title,
-		badge: route.entry.data.sidebar.badge,
-		attrs: { ...attrs, ...route.entry.data.sidebar.attrs },
-		autogenerate,
-	});
-}
-
-/**
- * Get the sort weight for a given route or directory. Lower numbers rank higher.
- * Directories have the weight of the lowest weighted route they contain.
- */
-function getOrder(routeOrDir: Route | Dir): number {
-	const cachedOrder = orderByEntry.get(routeOrDir);
-	if (cachedOrder !== undefined) return cachedOrder;
-	const order = isDir(routeOrDir)
-		? Math.min(...Object.values(routeOrDir).flatMap(getOrder))
-		: // If no order value is found, set it to the largest number possible.
-			(routeOrDir.entry.data.sidebar.order ?? Number.MAX_VALUE);
-	orderByEntry.set(routeOrDir, order);
-	return order;
-}
-
-const orderByEntry = new WeakMap<Dir | Route, number>();
-
-/** Sort a directory’s entries by user-specified order or alphabetically if no order specified. */
-function sortDirEntries(dir: [string, Dir | Route][]): [string, Dir | Route][] {
-	return dir.sort(([_keyA, a], [_keyB, b]) => {
-		const [aOrder, bOrder] = [getOrder(a), getOrder(b)];
-		// Pages are sorted by order in ascending order.
-		if (aOrder !== bOrder) return aOrder < bOrder ? -1 : 1;
-		// If two pages have the same order value they will be sorted by their slug.
-		return sidebarCollator.compare(isDir(a) ? a[SlugKey] : a.id, isDir(b) ? b[SlugKey] : b.id);
-	});
-}
-
-interface SidebarDirOptions {
-	collapsed: boolean;
-	attrs: LinkHTMLAttributes | undefined;
-}
-
-interface SidebarDirContext extends SidebarDirOptions {
-	fullPath: string;
-	dirName: string;
-	autogenerate: SidebarAutogenerateRouteData;
-}
-
-/** Create a group entry for a given content collection directory. */
-function groupFromDir(dir: Dir, context: SidebarDirContext): SidebarAutoGroup {
-	const { fullPath, dirName, collapsed, autogenerate } = context;
-	const entries = sortDirEntries(Object.entries(dir)).map(([key, dirOrRoute]) =>
-		dirToItem(dirOrRoute, { ...context, fullPath: `${fullPath}/${key}`, dirName: key })
-	);
-	return {
-		type: 'group',
-		label: dirName,
-		entries,
-		collapsed,
-		badge: undefined,
-		autogenerate,
-	};
-}
-
-/** Create a sidebar entry for a directory or content entry. */
-function dirToItem(
-	dirOrRoute: Dir[string],
-	context: SidebarDirContext
-): SidebarAutoGroup | SidebarAutoLink {
-	const { attrs, autogenerate } = context;
-	return isDir(dirOrRoute)
-		? groupFromDir(dirOrRoute, context)
-		: linkFromRoute(dirOrRoute, attrs, autogenerate);
-}
-
-/** Create a sidebar entry for a given content directory. */
-function sidebarFromDir(
-	tree: Dir,
-	options: SidebarDirOptions,
-	autogenerate: SidebarAutogenerateRouteData = rootAutogenerate
-) {
-	return sortDirEntries(Object.entries(tree)).map(([key, dirOrRoute]) =>
-		dirToItem(dirOrRoute, { ...options, fullPath: key, dirName: key, autogenerate })
-	);
-}
-
-/**
- * Intermediate sidebar represents sidebar entries generated from the user config for a specific
- * locale. These representations are cached per locale to avoid regenerating them for each page.
- * When generating the final sidebar for a page, the current page entry in the sidebar is marked
- * with `isCurrent` and cached. Subsequent runs then reset the previous current entry before marking
- * the new current page.
- *
- * Sidebars, like all route data, are deep cloned before the data is passed to users for mutation,
- * so optimising with a single mutable object per locale is safe.
- *
- * @see getSidebarFromIntermediateSidebar
- */
-const intermediateSidebars = new Map<string | undefined, SidebarEntry[]>();
-const lastCurrentEntryByLocale = new Map<string | undefined, SidebarLink>();
-
-/** Get the sidebar for the current page using the global config. */
-export function getSidebar(pathname: string, locale: string | undefined): SidebarEntry[] {
-	let intermediateSidebar = intermediateSidebars.get(locale);
-	if (!intermediateSidebar) {
-		intermediateSidebar = getIntermediateSidebarFromConfig(config.sidebar, locale);
-		intermediateSidebars.set(locale, intermediateSidebar);
-	}
-	setIntermediateSidebarCurrentEntry(intermediateSidebar, pathname, locale);
-	return intermediateSidebar;
-}
-
-/** Get the sidebar for the current page using the specified sidebar config. */
-export function getSidebarFromConfig(
-	sidebarConfig: StarlightConfig['sidebar'],
-	pathname: string,
-	locale: string | undefined
-): SidebarEntry[] {
-	const sidebar = getIntermediateSidebarFromConfig(sidebarConfig, locale);
-	const currentEntry = getSidebarCurrentEntry(sidebar, pathname);
-	if (currentEntry) currentEntry.isCurrent = true;
-	return sidebar;
-}
-
-/** Get the intermediate sidebar for a locale using the specified sidebar config. */
-function getIntermediateSidebarFromConfig(
-	sidebarConfig: StarlightConfig['sidebar'],
-	locale: string | undefined
-): SidebarEntry[] {
-	const routes = getLocaleRoutes(locale);
-	if (sidebarConfig) {
-		return sidebarConfig.flatMap((group) => configItemToEntry(group, locale, routes));
-	} else {
-		const tree = treeify(routes, locale, locale || '');
-		return sidebarFromDir(tree, { collapsed: false, attrs: undefined });
-	}
-}
-
-/** Marks the current page in an intermediate sidebar. */
-function setIntermediateSidebarCurrentEntry(
-	intermediateSidebar: SidebarEntry[],
-	pathname: string,
-	locale: string | undefined
-): void {
-	// Reset the `isCurrent` flag in this sidebar if it was previously set.
-	const lastCurrentEntry = lastCurrentEntryByLocale.get(locale);
-	if (lastCurrentEntry) {
-		lastCurrentEntry.isCurrent = false;
-	}
-	// Find the new current entry.
-	const entry = getSidebarCurrentEntry(intermediateSidebar, pathname);
-	// Mark it as current and store it to be reset later.
-	if (entry) {
-		entry.isCurrent = true;
-		lastCurrentEntryByLocale.set(locale, entry);
-	}
-}
-
-/** Finds the current page in a sidebar. */
-function getSidebarCurrentEntry(sidebar: SidebarEntry[], pathname: string): SidebarLink | null {
-	let entriesByPath = sidebarEntriesByPath.get(sidebar);
-	if (!entriesByPath) {
-		entriesByPath = new Map();
-		for (const entry of flattenSidebar(sidebar)) {
-			const path = neverPathFormatter(encodeURI(entry.href));
-			if (!entriesByPath.has(path)) entriesByPath.set(path, entry);
-		}
-		sidebarEntriesByPath.set(sidebar, entriesByPath);
-	}
-	return entriesByPath.get(neverPathFormatter(pathname)) ?? null;
-}
-
-const sidebarEntriesByPath = new WeakMap<SidebarEntry[], Map<string, SidebarLink>>();
-
-/** Generates a deterministic string based on the content of the passed sidebar. */
-export function getSidebarHash(sidebar: SidebarEntry[]): string {
-	let hash = 0;
-	const sidebarIdentity = recursivelyBuildSidebarIdentity(sidebar);
-	for (let i = 0; i < sidebarIdentity.length; i++) {
-		const char = sidebarIdentity.charCodeAt(i);
-		hash = (hash << 5) - hash + char;
-	}
-	return (hash >>> 0).toString(36).padStart(7, '0');
-}
-
-/** Recurses through a sidebar tree to generate a string concatenating labels and link hrefs. */
-function recursivelyBuildSidebarIdentity(sidebar: SidebarEntry[]): string {
-	return sidebar
-		.flatMap((entry) =>
-			entry.type === 'group'
-				? entry.label + recursivelyBuildSidebarIdentity(entry.entries)
-				: entry.label + entry.href
-		)
-		.join('');
-}
-
-/** Turn the nested tree structure of a sidebar into a flat list of all the links. */
-export function flattenSidebar(sidebar: SidebarEntry[]): SidebarLink[] {
-	const cachedSidebar = flattenedSidebars.get(sidebar);
-	if (cachedSidebar) return cachedSidebar;
-	const flattenedSidebar = sidebar.flatMap((entry) =>
-		entry.type === 'group' ? flattenSidebar(entry.entries) : entry
-	);
-	flattenedSidebars.set(sidebar, flattenedSidebar);
-	return flattenedSidebar;
-}
-
-const flattenedSidebars = new WeakMap<SidebarEntry[], SidebarLink[]>();
-
-/** Get previous/next pages in the sidebar or the ones from the frontmatter if any. */
-export function getPrevNextLinks(
-	sidebar: SidebarEntry[],
-	paginationEnabled: boolean,
-	config: {
-		prev?: PrevNextLinkConfig;
-		next?: PrevNextLinkConfig;
-	}
-): PaginationLinks {
-	const entries = flattenSidebar(sidebar);
-	const currentIndex = entries.findIndex((entry) => entry.isCurrent);
-	const prev = applyPrevNextLinkConfig(entries[currentIndex - 1], paginationEnabled, config.prev);
-	const next = applyPrevNextLinkConfig(
-		currentIndex > -1 ? entries[currentIndex + 1] : undefined,
-		paginationEnabled,
-		config.next
-	);
-	return { prev, next };
-}
-
-/** Apply a prev/next link config to a navigation link. */
-function applyPrevNextLinkConfig(
-	link: SidebarLink | undefined,
-	paginationEnabled: boolean,
-	config: PrevNextLinkConfig | undefined
-): SidebarLink | undefined {
-	// Explicitly remove the link.
-	if (config === false) return undefined;
-	// Use the generated link if any.
-	else if (config === true) return link;
-	// If a link exists, update its label if needed.
-	else if (typeof config === 'string' && link) {
-		return { ...link, label: config };
-	} else if (typeof config === 'object') {
-		if (link) {
-			// If a link exists, update both its label and href if needed.
-			return {
-				...link,
-				label: config.label ?? link.label,
-				href: config.link ?? link.href,
-				// Explicitly remove sidebar link attributes for prev/next links.
-				attrs: {},
-			};
-		} else if (config.link && config.label) {
-			// If there is no link and the frontmatter contains both a URL and a label,
-			// create a new link.
-			return makeLink({ href: config.link, label: config.label });
-		}
-	}
-	// Otherwise, if the global config is enabled, return the generated link if any.
-	return paginationEnabled ? link : undefined;
-}
-
-/** Get a sidebar badge for a given item. */
-function getSidebarBadge(
-	config: I18nBadgeConfig,
-	locale: string | undefined,
-	itemLabel: string
-): Badge | undefined {
-	if (!config) return;
-	if (typeof config === 'string') {
-		return { variant: 'default', text: config };
-	}
-	return { ...config, text: getSidebarBadgeText(config.text, locale, itemLabel) };
-}
-
-/** Get the badge text for a sidebar item. */
-function getSidebarBadgeText(
-	text: I18nBadge['text'],
-	locale: string | undefined,
-	itemLabel: string
-): string {
-	if (typeof text === 'string') return text;
-	const defaultLang =
-		config.defaultLocale?.lang || config.defaultLocale?.locale || BuiltInDefaultLocale.lang;
-	const defaultText = text[defaultLang];
-
-	if (!defaultText) {
-		throw new AstroError(
-			`The badge text for "${itemLabel}" must have a key for the default language "${defaultLang}".`,
-			'Update the Starlight config to include a badge text for the default language.\n' +
-				'Learn more about sidebar badges internationalization at https://starlight.astro.build/guides/sidebar/#internationalization-with-badges'
-		);
-	}
-
-	return pickLang(text, localeToLang(locale)) || defaultText;
-}

package/utils/path.ts

@@ -1,58 +0,0 @@
-/** Ensure the passed path starts with a leading slash. */
-export function ensureLeadingSlash(href: string): string {
-	if (href[0] !== '/') href = '/' + href;
-	return href;
-}
-
-/** Ensure the passed path ends with a trailing slash. */
-export function ensureTrailingSlash(href: string): string {
-	if (href[href.length - 1] !== '/') href += '/';
-	return href;
-}
-
-/** Ensure the passed path starts and ends with slashes. */
-export function ensureLeadingAndTrailingSlashes(href: string): string {
-	href = ensureLeadingSlash(href);
-	href = ensureTrailingSlash(href);
-	return href;
-}
-
-/** Ensure the passed path does not start with a leading slash. */
-export function stripLeadingSlash(href: string) {
-	if (href[0] === '/') href = href.slice(1);
-	return href;
-}
-
-/** Ensure the passed path does not end with a trailing slash. */
-export function stripTrailingSlash(href: string) {
-	if (href[href.length - 1] === '/') href = href.slice(0, -1);
-	return href;
-}
-
-/** Ensure the passed path does not start and end with slashes. */
-export function stripLeadingAndTrailingSlashes(href: string): string {
-	href = stripLeadingSlash(href);
-	href = stripTrailingSlash(href);
-	return href;
-}
-
-/** Remove the extension from a path. */
-export function stripHtmlExtension(path: string) {
-	const pathWithoutTrailingSlash = stripTrailingSlash(path);
-	return pathWithoutTrailingSlash.endsWith('.html') ? pathWithoutTrailingSlash.slice(0, -5) : path;
-}
-
-/** Add '.html' extension to a path. */
-export function ensureHtmlExtension(path: string) {
-	path = stripLeadingAndTrailingSlashes(path);
-	if (!path.endsWith('.html')) {
-		path = path ? path + '.html' : '/index.html';
-	}
-	return ensureLeadingSlash(path);
-}
-
-/** Remove the extension from a path. */
-export function stripExtension(path: string) {
-	const periodIndex = path.lastIndexOf('.');
-	return path.slice(0, periodIndex > -1 ? periodIndex : undefined);
-}