@astrojs/starlight 0.17.2 → 0.17.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @astrojs/starlight
 
+## 0.17.3
+
+### Patch Changes
+
+- [#1461](https://github.com/withastro/starlight/pull/1461) [`2e17880`](https://github.com/withastro/starlight/commit/2e17880957d1aae2a84c77500afa9b66e5292a6a) Thanks [@liruifengv](https://github.com/liruifengv)! - Improves the table of contents title translation in Simplified Chinese
+
+- [#1462](https://github.com/withastro/starlight/pull/1462) [`4741ccc`](https://github.com/withastro/starlight/commit/4741cccc8adbef500bcaf95416a1c61a90761c06) Thanks [@delucis](https://github.com/delucis)! - Fixes overflow of very long site titles on narrow viewports
+
+- [#1459](https://github.com/withastro/starlight/pull/1459) [`9a8e0ec`](https://github.com/withastro/starlight/commit/9a8e0ec59cba0e088512ea9b6d17224085f3a178) Thanks [@delucis](https://github.com/delucis)! - Fixes a bug where table of contents highlighting could break given very specific combinations of content and viewport size
+
+- [#1458](https://github.com/withastro/starlight/pull/1458) [`8c88642`](https://github.com/withastro/starlight/commit/8c88642875e8344396074a780e28fb0860b249f8) Thanks [@delucis](https://github.com/delucis)! - Silences i18n content collection warnings for projects without custom translations.
+
 ## 0.17.2
 
 ### Patch Changes

package/components/Header.astro

@@ -16,7 +16,7 @@ const shouldRenderSearch =
 ---
 
 <div class="header sl-flex">
-	<div class="sl-flex">
+	<div class="title-wrapper sl-flex">
 		<SiteTitle {...Astro.props} />
 	</div>
 	<div class="sl-flex">
@@ -39,6 +39,11 @@ const shouldRenderSearch =
 		height: 100%;
 	}
 
+	.title-wrapper {
+		/* Prevent long titles overflowing and covering the search and menu buttons on narrow viewports. */
+		overflow: hidden;
+	}
+
 	.right-group,
 	.social-icons {
 		gap: 1rem;

package/components/SiteTitle.astro

@@ -38,9 +38,6 @@ const href = formatPath(Astro.props.locale || '/');
 
 <style>
 	.site-title {
-		justify-self: flex-start;
-		max-width: 100%;
-		overflow: hidden;
 		align-items: center;
 		gap: var(--sl-nav-gap);
 		font-size: var(--sl-text-h4);

package/components/TableOfContents/starlight-toc.ts

@@ -95,8 +95,8 @@ export class StarlightTOC extends HTMLElement {
 		const mobileTocHeight = this.querySelector('summary')?.getBoundingClientRect().height || 0;
 		/** Start intersections at nav height + 2rem padding. */
 		const top = navBarHeight + mobileTocHeight + 32;
-		/** End intersections 1.5rem later. */
-		const bottom = top + 24;
+		/** End intersections `53px` later. This is slightly more than the maximum `margin-top` in Markdown content. */
+		const bottom = top + 53;
 		const height = document.documentElement.clientHeight;
 		return `-${top}px 0% ${bottom - height}px`;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.17.2",
+  "version": "0.17.3",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",

package/translations/zh-CN.json

@@ -11,7 +11,7 @@
   "languageSelect.accessibleLabel": "选择语言",
   "menuButton.accessibleLabel": "菜单",
   "sidebarNav.accessibleLabel": "主要",
-  "tableOfContents.onThisPage": "本页",
+  "tableOfContents.onThisPage": "本页内容",
   "tableOfContents.overview": "概述",
   "i18n.untranslatedContent": "此内容尚不支持你的语言。",
   "page.editLink": "编辑此页",

package/utils/translations.ts

@@ -3,16 +3,23 @@ import config from 'virtual:starlight/user-config';
 import type { i18nSchemaOutput } from '../schemas/i18n';
 import { createTranslationSystem } from './createTranslationSystem';
 
-/** All translation data from the i18n collection, keyed by `id`, which matches locale. */
-let userTranslations: Record<string, i18nSchemaOutput> = {};
-try {
-	// Load the user’s i18n collection and ignore the error if it doesn’t exist.
-	userTranslations = Object.fromEntries(
-		// @ts-ignore — may be an error in projects without an i18n collection
-
-		(await getCollection('i18n')).map(({ id, data }) => [id, data] as const)
-	);
-} catch {}
+/** Get all translation data from the i18n collection, keyed by `id`, which matches locale. */
+async function loadTranslations() {
+	let userTranslations: Record<string, i18nSchemaOutput> = {};
+	// Briefly override `console.warn()` to silence logging when a project has no i18n collection.
+	const warn = console.warn;
+	console.warn = () => {};
+	try {
+		// Load the user’s i18n collection and ignore the error if it doesn’t exist.
+		userTranslations = Object.fromEntries(
+			// @ts-ignore — may be an error in projects without an i18n collection
+			(await getCollection('i18n')).map(({ id, data }) => [id, data] as const)
+		);
+	} catch {}
+	// Restore the original warn implementation.
+	console.warn = warn;
+	return userTranslations;
+}
 
 /**
  * Generate a utility function that returns UI strings for the given `locale`.
@@ -21,4 +28,4 @@ try {
  * const t = useTranslations('en');
  * const label = t('search.label'); // => 'Search'
  */
-export const useTranslations = createTranslationSystem(userTranslations, config);
+export const useTranslations = createTranslationSystem(await loadTranslations(), config);