@astrojs/starlight 0.34.2 → 0.34.4

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @astrojs/starlight
 
+## 0.34.4
+
+### Patch Changes
+
+- [#3205](https://github.com/withastro/starlight/pull/3205) [`95d124a`](https://github.com/withastro/starlight/commit/95d124ae99f207afd83f305943fa29df32cbbfc9) Thanks [@sgalcheung](https://github.com/sgalcheung)! - Fixes an issue preventing to use the `<StarlightPage>` component when the `docs` content collection that Starlight uses does not exist.
+
+- [#3206](https://github.com/withastro/starlight/pull/3206) [`e6ea584`](https://github.com/withastro/starlight/commit/e6ea5848b20afbb654fd6684956336491b974dc7) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Fixes a text selection issue for heading with a clickable anchor link when using double click to select text in Chrome and Safari.
+
+- [#3233](https://github.com/withastro/starlight/pull/3233) [`3064c40`](https://github.com/withastro/starlight/commit/3064c40b54227b6309b35b6e44e397fae8f284a4) Thanks [@torn4dom4n](https://github.com/torn4dom4n)! - Updates Vietnamese UI translations.
+
+- [#3248](https://github.com/withastro/starlight/pull/3248) [`16c1239`](https://github.com/withastro/starlight/commit/16c1239b36346e84b794fab819d6ad7a9854a244) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Prevents [icons in the `<Card>` component](https://starlight.astro.build/components/cards/#add-icons-to-cards) from being shrunk in some narrow viewports.
+
+- [#3225](https://github.com/withastro/starlight/pull/3225) [`21b93b8`](https://github.com/withastro/starlight/commit/21b93b8ac1894c5ada99a641e516086ebee6ea37) Thanks [@randomguy-2650](https://github.com/randomguy-2650)! - Updates German UI translations
+
+## 0.34.3
+
+### Patch Changes
+
+- [#3058](https://github.com/withastro/starlight/pull/3058) [`274cc06`](https://github.com/withastro/starlight/commit/274cc06112824384771b944f504ab0faab45e2b9) Thanks [@techfg](https://github.com/techfg)! - Fixes display of focus indicator around site title
+
+- [#3181](https://github.com/withastro/starlight/pull/3181) [`449c822`](https://github.com/withastro/starlight/commit/449c8229effaab19ece3c0a34e32595809c33cc8) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Fixes an issue where all headings in Markdown and MDX content were rendered with a [clickable anchor link](https://starlight.astro.build/reference/configuration/#headinglinks), even in non-Starlight pages.
+
+- [#3168](https://github.com/withastro/starlight/pull/3168) [`ca693fe`](https://github.com/withastro/starlight/commit/ca693feb4b6aa9f26b3d536d284288773b788ac6) Thanks [@jsparkdev](https://github.com/jsparkdev)! - Updates Korean langage support with improvements and missing translations
+
 ## 0.34.2
 
 ### Patch Changes

package/components/SiteTitle.astro

@@ -43,6 +43,10 @@ const { siteTitle, siteTitleHref } = Astro.locals.starlightRoute;
 			color: var(--sl-color-text-accent);
 			text-decoration: none;
 			white-space: nowrap;
+			min-width: 0;
+		}
+		span {
+			overflow: hidden;
 		}
 		img {
 			height: calc(var(--sl-nav-height) - 2 * var(--sl-nav-pad-y));

package/integrations/heading-links.ts

@@ -6,6 +6,7 @@ import { h } from 'hastscript';
 import type { Transformer } from 'unified';
 import { SKIP, visit } from 'unist-util-visit';
 import type { HookParameters, StarlightConfig } from '../types';
+import { resolveCollectionPath } from '../utils/collection';
 
 const AnchorLinkIcon = h(
 	'span',
@@ -24,10 +25,14 @@ const AnchorLinkIcon = h(
  * Add anchor links to headings.
  */
 export default function rehypeAutolinkHeadings(
-	useTranslationsForLang: HookParameters<'config:setup'>['useTranslations'],
-	absolutePathToLang: HookParameters<'config:setup'>['absolutePathToLang']
+	docsCollectionPath: string,
+	useTranslationsForLang: AutolinkHeadingsOptions['useTranslations'],
+	absolutePathToLang: AutolinkHeadingsOptions['absolutePathToLang']
 ) {
 	const transformer: Transformer<Root> = (tree, file) => {
+		// If the document is not part of the Starlight docs collection, skip it.
+		if (!normalizePath(file.path).startsWith(docsCollectionPath)) return;
+
 		const pageLang = absolutePathToLang(file.path);
 		const t = useTranslationsForLang(pageLang);
 
@@ -67,7 +72,9 @@ export default function rehypeAutolinkHeadings(
 
 interface AutolinkHeadingsOptions {
 	starlightConfig: Pick<StarlightConfig, 'markdown'>;
-	astroConfig: { experimental: Pick<AstroConfig['experimental'], 'headingIdCompat'> };
+	astroConfig: Pick<AstroConfig, 'srcDir'> & {
+		experimental: Pick<AstroConfig['experimental'], 'headingIdCompat'>;
+	};
 	useTranslations: HookParameters<'config:setup'>['useTranslations'];
 	absolutePathToLang: HookParameters<'config:setup'>['absolutePathToLang'];
 }
@@ -85,10 +92,24 @@ export const starlightAutolinkHeadings = ({
 					rehypeHeadingIds,
 					{ experimentalHeadingIdCompat: astroConfig.experimental?.headingIdCompat },
 				],
-				rehypeAutolinkHeadings(useTranslations, absolutePathToLang),
+				rehypeAutolinkHeadings(
+					normalizePath(resolveCollectionPath('docs', astroConfig.srcDir)),
+					useTranslations,
+					absolutePathToLang
+				),
 			]
 		: [];
 
+/**
+ * File path separators seems to be inconsistent on Windows when the rehype plugin is used on
+ * Markdown vs MDX files.
+ * For the time being, we normalize the path to unix style path.
+ */
+const backSlashRegex = /\\/g;
+function normalizePath(path: string) {
+	return path.replace(backSlashRegex, '/');
+}
+
 // This utility is inlined from https://github.com/syntax-tree/hast-util-heading-rank
 // Copyright (c) 2020 Titus Wormer <tituswormer@gmail.com>
 // MIT License: https://github.com/syntax-tree/hast-util-heading-rank/blob/main/license

package/package.json

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

package/style/anchor-links.css

@@ -91,6 +91,9 @@ how we do it.
 		/* Prevent double or triple clicks from potentially selecting the anchor link a11y text. */
 		-webkit-user-select: none;
 		user-select: none;
+		/* Prevent double clicks on the last word (or single word) of a heading to include an extra new
+     line in Chrome and Safari. */
+		display: inline-flex;
 	}
 
 	/* Increase clickable area for anchor links with a pseudo element that doesn’t impact layout. */

package/translations/de.json

@@ -3,7 +3,7 @@
   "search.label": "Suchen",
   "search.ctrlKey": "Strg",
   "search.cancelLabel": "Abbrechen",
-  "search.devWarning": "Search is only available in production builds. \nTry building and previewing the site to test it out locally.",
+  "search.devWarning": "Die Suche ist nur in Produktions-Builds verfügbar. \nVersuche, die Website zu bauen und in der Vorschau anzusehen, um sie lokal zu testen.",
   "themeSelect.accessibleLabel": "Farbschema wählen",
   "themeSelect.dark": "Dunkel",
   "themeSelect.light": "Hell",
@@ -18,13 +18,13 @@
   "page.lastUpdated": "Zuletzt bearbeitet:",
   "page.previousLink": "Vorherige Seite",
   "page.nextLink": "Nächste Seite",
-  "page.draft": "This content is a draft and will not be included in production builds.",
+  "page.draft": "Dieser Inhalt ist ein Entwurf und wird nicht in den Produktions-Builds enthalten sein.",
   "404.text": "Seite nicht gefunden. Überprüfe die URL oder nutze die Suchleiste.",
   "aside.note": "Hinweis",
   "aside.tip": "Tipp",
   "aside.caution": "Achtung",
   "aside.danger": "Gefahr",
-  "fileTree.directory": "Directory",
+  "fileTree.directory": "Ordner",
   "builtWithStarlight.label": "Erstellt mit Starlight",
   "heading.anchorLabel": "Abschnitt betitelt „{{title}}“"
 }

package/translations/ko.json

@@ -1,30 +1,30 @@
 {
-  "skipLink.label": "컨텐츠로 건너뛰기",
+  "skipLink.label": "콘텐츠로 이동",
   "search.label": "검색",
   "search.ctrlKey": "Ctrl",
   "search.cancelLabel": "취소",
-  "search.devWarning": "검색 기능은 프로덕션 환경에서만 사용할 수 있습니다. \n사이트를 빌드하고 미리 보기를 실행하여 로컬에서 테스트하세요.",
+  "search.devWarning": "검색 기능은 프로덕션 빌드에서만 작동합니다. \n로컬에서 테스트하려면 사이트를 빌드하고 미리 보기를 실행하세요.",
   "themeSelect.accessibleLabel": "테마 선택",
-  "themeSelect.dark": "다크",
-  "themeSelect.light": "라이트",
+  "themeSelect.dark": "어두운 테마",
+  "themeSelect.light": "밝은 테마",
   "themeSelect.auto": "자동",
   "languageSelect.accessibleLabel": "언어 선택",
   "menuButton.accessibleLabel": "메뉴",
   "sidebarNav.accessibleLabel": "메인",
-  "tableOfContents.onThisPage": "이 페이지에서는",
+  "tableOfContents.onThisPage": "목차",
   "tableOfContents.overview": "개요",
-  "i18n.untranslatedContent": "이 콘텐츠는 아직 해당 언어로 제공되지 않습니다.",
-  "page.editLink": "페이지 수정",
+  "i18n.untranslatedContent": "이 콘텐츠는 아직 번역되지 않았습니다.",
+  "page.editLink": "페이지 편집",
   "page.lastUpdated": "마지막 업데이트:",
-  "page.previousLink": "이전",
-  "page.nextLink": "다음",
-  "page.draft": "이 콘텐츠는 초안이며 프로덕션 빌드에는 포함되지 않습니다.",
-  "404.text": "페이지를 찾을 수 없습니다. URL을 확인하거나 검색창을 사용해 보세요.",
-  "aside.note": "노트",
+  "page.previousLink": "이전 페이지",
+  "page.nextLink": "다음 페이지",
+  "page.draft": "이 콘텐츠는 아직 초안 상태이며, 최종 빌드에는 포함되지 않습니다.",
+  "404.text": "페이지를 찾을 수 없습니다. URL을 다시 확인해보거나 검색을 사용해보세요.",
+  "aside.note": "참고",
   "aside.tip": "팁",
   "aside.caution": "주의",
   "aside.danger": "위험",
   "fileTree.directory": "디렉터리",
-  "builtWithStarlight.label": "Starlight로 제작됨",
-  "heading.anchorLabel": "Section titled “{{title}}”"
+  "builtWithStarlight.label": "이 웹사이트는 Starlight로 제작되었습니다.",
+  "heading.anchorLabel": "섹션 제목: “{{title}}”"
 }

package/translations/vi.json

@@ -1,9 +1,9 @@
 {
-  "skipLink.label": "Bỏ qua nội dung",
+  "skipLink.label": "Bỏ qua để đến nội dung",
   "search.label": "Tìm kiếm",
   "search.ctrlKey": "Ctrl",
-  "search.cancelLabel": "Thoát",
-  "search.devWarning": "Tìm kiếm không khả dụng khi đang trong môi trường lập trình. \nThử xuất bản website và tìm kiếm.",
+  "search.cancelLabel": "Hủy",
+  "search.devWarning": "Chức năng tìm kiếm chỉ có sẵn trong các phiên bản thật.\nHãy thử xây dựng và xem trước trang web để kiểm tra.",
   "themeSelect.accessibleLabel": "Chọn giao diện",
   "themeSelect.dark": "Tối",
   "themeSelect.light": "Sáng",
@@ -11,20 +11,20 @@
   "languageSelect.accessibleLabel": "Chọn ngôn ngữ",
   "menuButton.accessibleLabel": "Menu",
   "sidebarNav.accessibleLabel": "Chính",
-  "tableOfContents.onThisPage": "Tóm tắt",
-  "tableOfContents.overview": "Tổng quát",
-  "i18n.untranslatedContent": "Nội dung này không tồn tại trong ngôn ngữ của bạn",
+  "tableOfContents.onThisPage": "Trên trang này",
+  "tableOfContents.overview": "Tổng quan",
+  "i18n.untranslatedContent": "Nội dung này hiện chưa có sẵn bằng ngôn ngữ của bạn.",
   "page.editLink": "Chỉnh sửa trang",
   "page.lastUpdated": "Cập nhật lần cuối:",
-  "page.previousLink": "Tiếp",
-  "page.nextLink": "Trước",
-  "page.draft": "This content is a draft and will not be included in production builds.",
-  "404.text": "Không tìm thấy trang. Kiểm tra URL hoặc thử sử dụng thanh tìm kiếm.",
+  "page.previousLink": "Trước",
+  "page.nextLink": "Tiếp",
+  "page.draft": "Nội dung này là bản nháp và sẽ không được đưa vào các phiên bản thật.",
+  "404.text": "Không tìm thấy trang. Hãy kiểm tra lại URL hoặc thử dùng thanh tìm kiếm.",
   "aside.note": "Ghi chú",
   "aside.tip": "Mẹo",
-  "aside.caution": "Thận trọng",
+  "aside.caution": "Chú ý",
   "aside.danger": "Nguy hiểm",
-  "fileTree.directory": "Danh mục",
-  "builtWithStarlight.label": "Tạo với Starlight",
-  "heading.anchorLabel": "Section titled “{{title}}”"
+  "fileTree.directory": "Thư mục",
+  "builtWithStarlight.label": "Được xây dựng bằng Starlight",
+  "heading.anchorLabel": "Phần tiêu đề “{{title}}”"
 }

package/user-components/Card.astro

@@ -58,6 +58,7 @@ const { icon, title } = Astro.props;
 			background-color: var(--sl-card-bg);
 			padding: 0.2em;
 			border-radius: 0.25rem;
+			flex-shrink: 0;
 		}
 		.card .body {
 			margin: 0;

package/utils/starlight-page.ts

@@ -211,5 +211,5 @@ async function getUserDocsSchema(): Promise<
 	NonNullable<ContentConfig['collections']['docs']['schema']>
 > {
 	const userCollections = (await import('virtual:starlight/collection-config')).collections;
-	return userCollections?.docs.schema ?? docsSchema();
+	return userCollections?.docs?.schema ?? docsSchema();
 }