@astrojs/starlight 0.10.0 → 0.10.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @astrojs/starlight
 
+## 0.10.2
+
+### Patch Changes
+
+- [#735](https://github.com/withastro/starlight/pull/735) [`2da8692`](https://github.com/withastro/starlight/commit/2da86929c8041f6585790c3baf1cba42220650cc) Thanks [@delucis](https://github.com/delucis)! - Use Starlight font custom property in Pagefind modal
+
+- [#735](https://github.com/withastro/starlight/pull/735) [`2da8692`](https://github.com/withastro/starlight/commit/2da86929c8041f6585790c3baf1cba42220650cc) Thanks [@delucis](https://github.com/delucis)! - Fix RTL styling in Pagefind modal
+
+- [#739](https://github.com/withastro/starlight/pull/739) [`a9de4a7`](https://github.com/withastro/starlight/commit/a9de4a7dcf9ec8c5c801e8a6cbb0d7faf2c34db7) Thanks [@radenpioneer](https://github.com/radenpioneer)! - Add Indonesian UI translation
+
+- [#747](https://github.com/withastro/starlight/pull/747) [`7589515`](https://github.com/withastro/starlight/commit/75895154b11cf9368d4d6b45647b156ce32a88f0) Thanks [@nirtamir2](https://github.com/nirtamir2)! - Add Hebrew UI translations
+
+## 0.10.1
+
+### Patch Changes
+
+- [#726](https://github.com/withastro/starlight/pull/726) [`f3157c6`](https://github.com/withastro/starlight/commit/f3157c6065943af39995b6dbae5f63cf424bd9a3) Thanks [@delucis](https://github.com/delucis)! - Fix a rare bug in table of contents when handling headings that increase by more than one level on a page.
+
+- [#729](https://github.com/withastro/starlight/pull/729) [`80c6ab1`](https://github.com/withastro/starlight/commit/80c6ab1c1ec48805e74c53b615a78d65127eeacb) Thanks [@delucis](https://github.com/delucis)! - Upgrade Pagefind to v1.0.3
+
+- [#715](https://github.com/withastro/starlight/pull/715) [`e726155`](https://github.com/withastro/starlight/commit/e7261559f2539a0ceefd36a28e4fbbc17f5970b8) Thanks [@itsmatteomanf](https://github.com/itsmatteomanf)! - feat: prevent scroll on body when search is open
+
 ## 0.10.0
 
 ### Minor Changes

package/components/Search.astro

@@ -72,20 +72,23 @@ const pagefindTranslations = {
 
 			const openModal = (event?: MouseEvent) => {
 				dialog.showModal();
+				document.body.toggleAttribute('data-search-modal-open', true);
 				this.querySelector('input')?.focus();
 				event?.stopPropagation();
 				window.addEventListener('click', onClick);
 			};
 
-			const closeModal = () => {
-				dialog.close();
-				window.removeEventListener('click', onClick);
-			};
+			const closeModal = () => dialog.close();
 
 			openBtn.addEventListener('click', openModal);
 			openBtn.disabled = false;
 			closeBtn.addEventListener('click', closeModal);
 
+			dialog.addEventListener('close', () => {
+				document.body.toggleAttribute('data-search-modal-open', false);
+				window.removeEventListener('click', onClick);
+			});
+
 			// Listen for `/` and `cmd + k` keyboard shortcuts.
 			window.addEventListener('keydown', (e) => {
 				const isInput =
@@ -202,6 +205,7 @@ const pagefindTranslations = {
 	#starlight__search {
 		--pagefind-ui-primary: var(--sl-color-accent-light);
 		--pagefind-ui-text: var(--sl-color-gray-2);
+		--pagefind-ui-font: var(--__sl-font);
 		--pagefind-ui-background: var(--sl-color-black);
 		--pagefind-ui-border: var(--sl-color-gray-5);
 		--pagefind-ui-border-width: 1px;
@@ -230,6 +234,10 @@ const pagefindTranslations = {
 </style>
 
 <style is:global>
+	[data-search-modal-open] {
+		overflow: hidden;
+	}
+
 	#starlight__search {
 		--sl-search-result-spacing: calc(1.25rem * var(--pagefind-ui-scale));
 		--sl-search-result-pad-inline-start: calc(3.75rem * var(--pagefind-ui-scale));
@@ -383,6 +391,12 @@ const pagefindTranslations = {
 		mask-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='none' stroke='currentColor' stroke-linecap='round' stroke-linejoin='round' viewBox='0 0 16 16'%3E%3Cpath d='M8 0v12m6 0H8'/%3E%3C/svg%3E");
 	}
 
+	/* Flip page and tree icons around the vertical axis when in an RTL layout. */
+	[dir='rtl'] .pagefind-ui__result-title::before,
+	[dir='rtl'] .pagefind-ui__result-nested::before {
+		transform: matrix(-1, 0, 0, 1, 0, 0);
+	}
+
 	#starlight__search .pagefind-ui__result-link::after {
 		content: '';
 		position: absolute;

package/components/TableOfContents/generateToC.ts

@@ -4,52 +4,29 @@ export interface TocItem extends MarkdownHeading {
 	children: TocItem[];
 }
 
-function diveChildren(item: TocItem, depth: number): TocItem[] {
-	if (depth === 1) {
-		return item.children;
-	} else if (item.children.length > 0) {
-		return diveChildren(item.children.at(-1)!, depth - 1);
-	} else {
-		return [];
-	}
-}
-
 interface TocOpts {
 	minHeadingLevel: number;
 	maxHeadingLevel: number;
-	title?: string;
+	title: string;
 }
 
+/** Convert the flat headings array generated by Astro into a nested tree structure. */
 export function generateToC(
 	headings: MarkdownHeading[],
-	{ minHeadingLevel, maxHeadingLevel, title = 'Overview' }: TocOpts
+	{ minHeadingLevel, maxHeadingLevel, title }: TocOpts
 ) {
-	const overview = { depth: 2, slug: '_top', text: title };
-	headings = [
-		overview,
-		...headings.filter(({ depth }) => depth >= minHeadingLevel && depth <= maxHeadingLevel),
-	];
-	const toc: Array<TocItem> = [];
+	headings = headings.filter(({ depth }) => depth >= minHeadingLevel && depth <= maxHeadingLevel);
+	const toc: Array<TocItem> = [{ depth: 2, slug: '_top', text: title, children: [] }];
+	for (const heading of headings) injectChild(toc, { ...heading, children: [] });
+	return toc;
+}
 
-	for (const heading of headings) {
-		if (toc.length === 0) {
-			toc.push({ ...heading, children: [] });
-		} else {
-			const lastItemInToc = toc.at(-1)!;
-			if (heading.depth < lastItemInToc.depth) {
-				throw new Error(`Orphan heading found: ${heading.text}.`);
-			}
-			if (heading.depth === lastItemInToc.depth) {
-				// same depth
-				toc.push({ ...heading, children: [] });
-			} else {
-				// higher depth
-				// push into children, or children's children alike
-				const gap = heading.depth - lastItemInToc.depth;
-				const target = diveChildren(lastItemInToc, gap);
-				target.push({ ...heading, children: [] });
-			}
-		}
+/** Inject a ToC entry as deep in the tree as its `depth` property requires. */
+function injectChild(items: TocItem[], item: TocItem): void {
+	const lastItem = items.at(-1);
+	if (!lastItem || lastItem.depth >= item.depth) {
+		items.push(item);
+	} else {
+		return injectChild(lastItem.children, item);
 	}
-	return toc;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.10.0",
+  "version": "0.10.2",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",
@@ -39,13 +39,13 @@
   "dependencies": {
     "@astrojs/mdx": "^1.0.0",
     "@astrojs/sitemap": "^3.0.0",
-    "@pagefind/default-ui": "^1.0.2",
+    "@pagefind/default-ui": "^1.0.3",
     "@types/mdast": "^3.0.11",
     "bcp-47": "^2.1.0",
     "execa": "^7.1.1",
     "hast-util-select": "^5.0.5",
     "hastscript": "^7.2.0",
-    "pagefind": "^1.0.2",
+    "pagefind": "^1.0.3",
     "rehype": "^12.0.1",
     "remark-directive": "^2.0.1",
     "unified": "^10.1.2",

package/translations/he.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "דלגו לתוכן",
+  "search.label": "חיפוש",
+  "search.shortcutLabel": "(לחצו / כדי לחפש)",
+  "search.cancelLabel": "ביטול",
+  "search.devWarning": "החיפוש זמין רק בסביבת ייצור. \nנסו לבנות ולהציג תצוגה מקדימה של האתר כדי לבדוק אותו באופן מקומי.",
+  "themeSelect.accessibleLabel": "בחרו פרופיל צבע",
+  "themeSelect.dark": "כהה",
+  "themeSelect.light": "בהיר",
+  "themeSelect.auto": "מערכת",
+  "languageSelect.accessibleLabel": "בחרו שפה",
+  "menuButton.accessibleLabel": "תפריט",
+  "sidebarNav.accessibleLabel": "ראשי",
+  "tableOfContents.onThisPage": "בדף זה",
+  "tableOfContents.overview": "סקירה כללית",
+  "i18n.untranslatedContent": "תוכן זה אינו זמין עדיין בשפה שלך.",
+  "page.editLink": "ערכו דף",
+  "page.lastUpdated": "עדכון אחרון:",
+  "page.previousLink": "הקודם",
+  "page.nextLink": "הבא",
+  "404.text": "הדף לא נמצא. אנא בדקו את כתובת האתר או נסו להשתמש בסרגל החיפוש."
+}

package/translations/id.json

@@ -0,0 +1,22 @@
+{
+  "skipLink.label": "Lewati ke konten",
+  "search.label": "Pencarian",
+  "search.shortcutLabel": "(Tekan / untuk mencari)",
+  "search.cancelLabel": "Batal",
+  "search.devWarning": "Pencarian hanya tersedia pada build produksi. \nLakukan proses build dan pratinjau situs Anda sebelum mencoba di lingkungan lokal.",
+  "themeSelect.accessibleLabel": "Pilih tema",
+  "themeSelect.dark": "Gelap",
+  "themeSelect.light": "Terang",
+  "themeSelect.auto": "Otomatis",
+  "languageSelect.accessibleLabel": "Pilih Bahasa",
+  "menuButton.accessibleLabel": "Menu",
+  "sidebarNav.accessibleLabel": "Utama",
+  "tableOfContents.onThisPage": "Di halaman ini",
+  "tableOfContents.overview": "Selayang Pandang",
+  "i18n.untranslatedContent": "Konten ini belum tersedia dalam bahasa Anda.",
+  "page.editLink": "Edit halaman",
+  "page.lastUpdated": "Terakhir diperbaharui:",
+  "page.previousLink": "Sebelumnya",
+  "page.nextLink": "Selanjutnya",
+  "404.text": "Halaman tidak ditemukan. Cek kembali kolom URL atau gunakan fitur pencarian."
+}

package/translations/index.ts

@@ -7,6 +7,8 @@ import ja from './ja.json';
 import pt from './pt.json';
 import fa from './fa.json';
 import fr from './fr.json';
+import he from './he.json';
+import id from './id.json';
 import it from './it.json';
 import nl from './nl.json';
 import da from './da.json';
@@ -21,7 +23,26 @@ import ru from './ru.json';
 const { parse } = builtinI18nSchema();
 
 export default Object.fromEntries(
-	Object.entries({ cs, en, es, de, ja, pt, fa, fr, it, nl, da, tr, ar, nb, zh, ko, sv, ru }).map(
-		([key, dict]) => [key, parse(dict)]
-	)
+	Object.entries({
+		cs,
+		en,
+		es,
+		de,
+		ja,
+		pt,
+		fa,
+		fr,
+		he,
+		id,
+		it,
+		nl,
+		da,
+		tr,
+		ar,
+		nb,
+		zh,
+		ko,
+		sv,
+		ru,
+	}).map(([key, dict]) => [key, parse(dict)])
 );