@astrojs/starlight 0.38.2 → 0.38.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @astrojs/starlight
 
+## 0.38.4
+
+### Patch Changes
+
+- [#3828](https://github.com/withastro/starlight/pull/3828) [`342038b`](https://github.com/withastro/starlight/commit/342038b60b35c0e8cd4489e6a3ee16902445cfce) Thanks [@MangelMaxime](https://github.com/MangelMaxime)! - Fixes aside styling when used without any content
+
+- [#3853](https://github.com/withastro/starlight/pull/3853) [`563e11b`](https://github.com/withastro/starlight/commit/563e11b71f5c23d0ca982f7e061ade0796101ffb) Thanks [@delucis](https://github.com/delucis)! - Fixes a type-checking issue for users on newer versions of TypeScript
+
+## 0.38.3
+
+### Patch Changes
+
+- [#3799](https://github.com/withastro/starlight/pull/3799) [`313611b`](https://github.com/withastro/starlight/commit/313611b1cd9c1f38688cb98cc103ddd758e80ec2) Thanks [@JosefJezek](https://github.com/JosefJezek)! - Improves Czech UI translations
+
+- [#3770](https://github.com/withastro/starlight/pull/3770) [`6e7bed1`](https://github.com/withastro/starlight/commit/6e7bed1e6b3b586b9719c620924f60d3678a1f83) Thanks [@gameroman](https://github.com/gameroman)! - Adds examples to the inline documentation for `title` in the Starlight configuration object
+
+- [#3801](https://github.com/withastro/starlight/pull/3801) [`fedd48b`](https://github.com/withastro/starlight/commit/fedd48b701ea9ca764b19139404c744099565f4c) Thanks [@delucis](https://github.com/delucis)! - Fixes missing draft content warning in dev on pages using the hero layout
+
 ## 0.38.2
 
 ### Patch Changes

package/components/ContentNotice.astro

@@ -28,6 +28,7 @@ const { icon, label } = Astro.props;
 			gap: 0.75em;
 			font-size: var(--sl-text-body-sm);
 			line-height: var(--sl-line-height-headings);
+			text-align: start;
 		}
 	}
 </style>

package/components/Hero.astro

@@ -1,5 +1,6 @@
 ---
 import { Image } from 'astro:assets';
+import DraftContentNotice from 'virtual:starlight/components/DraftContentNotice';
 import { PAGE_TITLE_ID } from '../constants';
 import LinkButton from '../user-components/LinkButton.astro';
 
@@ -44,6 +45,7 @@ if (image) {
 	<div class="sl-flex stack">
 		<div class="sl-flex copy">
 			<h1 id={PAGE_TITLE_ID} data-page-title set:html={title} />
+			{data.draft && <DraftContentNotice />}
 			{tagline && <div class="tagline" set:html={tagline} />}
 		</div>
 		{
@@ -67,6 +69,7 @@ if (image) {
 	@layer starlight.core {
 		.hero {
 			display: grid;
+			grid-template-columns: 100%;
 			align-items: center;
 			gap: 1rem;
 			padding-bottom: 1rem;

package/package.json

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

package/style/asides.css

@@ -45,6 +45,10 @@
 		margin-top: 0.5rem;
 	}
 
+	.starlight-aside__content:empty {
+		display: none;
+	}
+
 	.starlight-aside__content a {
 		color: var(--sl-color-asides-text-accent);
 	}

package/translations/cs.json

@@ -15,19 +15,19 @@
   "tableOfContents.overview": "Přehled",
   "i18n.untranslatedContent": "Tento obsah zatím není dostupný ve vašem jazyce.",
   "page.editLink": "Upravit stránku",
-  "page.lastUpdated": "Poslední aktualizace:",
+  "page.lastUpdated": "Aktualizováno:",
   "page.previousLink": "Předchozí",
   "page.nextLink": "Další",
   "page.draft": "Tento obsah je koncept a nebude zahrnutý v produkčním sestavení.",
-  "404.text": "Stránka nenalezena. Zkontrolujte adresu nebo zkuste použít vyhledávač",
+  "404.text": "Stránka nenalezena. Zkontrolujte adresu nebo zkuste použít vyhledávač.",
   "aside.note": "Poznámka",
   "aside.tip": "Tip",
   "aside.caution": "Upozornění",
   "aside.danger": "Nebezpečí",
   "fileTree.directory": "Adresář",
-  "builtWithStarlight.label": "Postavené s Starlight",
+  "builtWithStarlight.label": "Postaveno se Starlight",
   "expressiveCode.copyButtonCopied": "Zkopírováno!",
-  "expressiveCode.copyButtonTooltip": "Kopíruj do schránky",
+  "expressiveCode.copyButtonTooltip": "Kopírovat do schránky",
   "expressiveCode.terminalWindowFallbackTitle": "Terminál",
   "pagefind.clear_search": "Vyčistit",
   "pagefind.load_more": "Načíst další výsledky",
@@ -39,5 +39,5 @@
   "pagefind.alt_search": "Žádné výsledky pro [SEARCH_TERM]. Namísto toho zobrazuji výsledky pro: [DIFFERENT_TERM]",
   "pagefind.search_suggestion": "Žádný výsledek pro [SEARCH_TERM]. Zkus nějaké z těchto hledání:",
   "pagefind.searching": "Hledám [SEARCH_TERM]...",
-  "heading.anchorLabel": "Section titled “{{title}}”"
+  "heading.anchorLabel": "Sekce “{{title}}”"
 }

package/user-components/Aside.astro

@@ -34,7 +34,11 @@ if (!title) {
 	<p class="starlight-aside__title" aria-hidden="true">
 		<Icon name={icon || icons[type]} class="starlight-aside__icon" />{title}
 	</p>
-	<div class="starlight-aside__content">
-		<slot />
-	</div>
+	{
+		/* 
+		The slot is intentionally not wrapped in newlines/whitespace to ensure CSS `:empty` 
+		can match when no content is provided. 
+	*/
+	}
+	<div class="starlight-aside__content"><slot /></div>
 </aside>

package/utils/i18n.ts

@@ -193,6 +193,9 @@ function getLocaleDir(locale: Intl.Locale): 'ltr' | 'rtl' {
 	}
 	// Firefox does not support `textInfo` or `getTextInfo` yet so we fallback to a well-known list
 	// of right-to-left languages.
+	// eslint-disable-next-line @typescript-eslint/ban-ts-comment
+	// @ts-ignore — This is a type error with newer versions of TypeScript’s DOM types.
+	// TODO: remove or switch to @ts-expect-error in #3572
 	return wellKnownRTL.includes(locale.language) ? 'rtl' : 'ltr';
 }
 

package/utils/user-config.ts

@@ -22,7 +22,15 @@ const LocaleSchema = z.object({
 });
 
 const UserConfigSchema = z.object({
-	/** Title for your website. Will be used in metadata and as browser tab title. */
+	/**
+	 * Title for your website. Will be used in metadata and as browser tab title.
+	 *
+	 * @example
+	 * title: 'My Docs'
+	 *
+	 * @example
+	 * title: { en: 'My Docs' }
+	 */
 	title: TitleConfigSchema(),
 
 	/** Description metadata for your website. Can be used in page metadata. */