@astrojs/starlight 0.25.0 → 0.25.2

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # @astrojs/starlight
 
+## 0.25.2
+
+### Patch Changes
+
+- [#2126](https://github.com/withastro/starlight/pull/2126) [`ada51ee`](https://github.com/withastro/starlight/commit/ada51ee1500d07c1819059f57e97dc6e97b4d2ba) Thanks [@essential-randomness](https://github.com/essential-randomness)! - Adds support for markdown formatting in aside titles
+
+- [#2135](https://github.com/withastro/starlight/pull/2135) [`9bbb969`](https://github.com/withastro/starlight/commit/9bbb9690616f79a80f3d286082b2500457bbcae9) Thanks [@oluwatobiss](https://github.com/oluwatobiss)! - Adds Pinterest social icon
+
+## 0.25.1
+
+### Patch Changes
+
+- [#2122](https://github.com/withastro/starlight/pull/2122) [`359a642`](https://github.com/withastro/starlight/commit/359a64219288795936f18fd50fb5f195c412a748) Thanks [@HiDeoo](https://github.com/HiDeoo)! - Fixes an i18n configuration issue for multilingual sites when using Astro’s `i18n` config with `prefixDefaultLocale` set to `false`.
+
+- [#2107](https://github.com/withastro/starlight/pull/2107) [`61e223b`](https://github.com/withastro/starlight/commit/61e223b153cb10958f3fbaa77acf6ac07d982944) Thanks [@sanabel-al-firdaws](https://github.com/sanabel-al-firdaws)! - Updates Arabic UI translations
+
+- [#2105](https://github.com/withastro/starlight/pull/2105) [`81f8a2c`](https://github.com/withastro/starlight/commit/81f8a2c9580ec07dd17e2f596b9b1b50fae8237a) Thanks [@delucis](https://github.com/delucis)! - Fixes an edge case in custom pagination link processing
+
+  Custom link values for `prev`/`next` in page frontmatter are now always used as authored.
+  Previously this was not the case in some edge cases such as for the first and final pages in the sidebar.
+
+- [#2119](https://github.com/withastro/starlight/pull/2119) [`464685a`](https://github.com/withastro/starlight/commit/464685a3ce33e7ccc8d1d7365935732c87ba95e9) Thanks [@evadecker](https://github.com/evadecker)! - Improves styling of `<hr>`, `<blockquote>`, and `<code>` within asides
+
 ## 0.25.0
 
 ### Minor Changes

package/components/Icons.ts

@@ -125,6 +125,8 @@ export const BuiltInIcons = {
 		'<path d="M12.102 0h-.081C5.462 0 .13 5.252.001 11.779v.012L.007 24l12.097-.01c6.582-.055 11.897-5.404 11.897-11.995S18.686.056 12.109 0h-.005zM12 18.857h-.015a6.778 6.778 0 0 1-2.94-.666l.041.018-4.345 1.077 1.227-4.018a6.78 6.78 0 0 1-.83-3.27A6.86 6.86 0 1 1 12 18.857z"/>',
 	zulip:
 		'<path d="M21 19c0 1.7-1.2 3-2.7 3H5.7C4.2 22 3 20.7 3 19a3 3 0 0 1 1.2-2.4l6.7-6c0-.1.3 0 .2.2l-2.5 5s0 .2.2.2h9.5c1.5 0 2.7 1.4 2.7 3Zm0-14a3 3 0 0 1-1.2 2.4l-6.7 6c0 .1-.2 0-.2-.2l2.5-5s0-.2-.2-.2H5.7C4.2 8 3 6.6 3 5c0-1.7 1.2-3 2.7-3h12.6C19.8 2 21 3.3 21 5Z"/>',
+	pinterest:
+		'<path d="M12 0a12 12 0 0 0-4.4 23.1c0-.9-.2-2.4 0-3.4l1.5-6s-.4-.7-.4-1.7c0-1.7 1-3 2.2-3 1 0 1.5.8 1.5 1.7 0 1-.6 2.6-1 4-.3 1.2.6 2.2 1.8 2.2 2.1 0 3.8-2.2 3.8-5.5 0-2.8-2-4.9-5-4.9a5.2 5.2 0 0 0-5.4 5.2c0 1 .3 2.2.8 2.8.1.1.2.2.1.3l-.3 1.4c0 .2-.2.3-.4.2-1.5-.7-2.4-3-2.4-4.7C4.4 8 7 4.5 12.3 4.5c4.1 0 7.4 3 7.4 6.9 0 4.1-2.6 7.4-6.3 7.4-1.2 0-2.3-.6-2.7-1.3l-.8 2.8c-.2 1-1 2.4-1.5 3.2A12 12 0 1 0 12 0z"/>',
 	astro:
 		'<path d="M7.233 15.856c-.456 1.5-.132 3.586.948 4.57v-.036l.036-.096c.132-.636.648-1.032 1.309-1.008.612.012.96.336 1.044 1.044.036.264.036.528.048.803v.084c0 .6.168 1.176.504 1.68.3.48.72.851 1.284 1.103l-.024-.048-.024-.096c-.42-1.26-.12-2.135.984-2.879l.336-.227.745-.492a3.647 3.647 0 0 0 1.536-2.603c.06-.456 0-.9-.132-1.331l-.18.12c-1.668.887-3.577 1.2-5.425.84-1.117-.169-2.197-.48-3-1.416l.011-.012ZM2 15.592s3.205-1.559 6.421-1.559l2.437-7.508c.084-.36.348-.6.648-.6.3 0 .552.24.648.612l2.425 7.496c3.816 0 6.421 1.56 6.421 1.56L15.539.72c-.144-.444-.42-.72-.768-.72H8.24c-.348 0-.6.276-.768.72L2 15.592Z"/>',
 	alpine: '<path d="m18.7 6 5.3 5.3-5.3 5.3-5.4-5.3L18.7 6zM5.3 6l11 11H5.8L0 11.2 5.3 6z"/>',

package/integrations/asides.ts

@@ -2,7 +2,7 @@
 
 import type { AstroConfig, AstroIntegration, AstroUserConfig } from 'astro';
 import { h as _h, s as _s, type Properties } from 'hastscript';
-import type { Node, Paragraph as P, Parent, Root } from 'mdast';
+import type { Node, Paragraph as P, Parent, PhrasingContent, Root } from 'mdast';
 import {
 	type Directives,
 	directiveToMarkdown,
@@ -10,6 +10,7 @@ import {
 	type LeafDirective,
 } from 'mdast-util-directive';
 import { toMarkdown } from 'mdast-util-to-markdown';
+import { toString } from 'mdast-util-to-string';
 import remarkDirective from 'remark-directive';
 import type { Plugin, Transformer } from 'unified';
 import { visit } from 'unist-util-visit';
@@ -156,16 +157,16 @@ function remarkAsides(options: AsidesOptions): Plugin<[], Root> {
 			// prop to <Aside>, so when we find a directive label, we store it for the title prop and
 			// remove the paragraph from the container’s children.
 			let title = t(`aside.${variant}`);
+			let titleNode: PhrasingContent[] = [{ type: 'text', value: title }];
 			const firstChild = node.children[0];
 			if (
 				firstChild?.type === 'paragraph' &&
 				firstChild.data &&
-				'directiveLabel' in firstChild.data
+				'directiveLabel' in firstChild.data &&
+				firstChild.children.length > 0
 			) {
-				const firstGrandChild = firstChild.children[0];
-				if (firstGrandChild?.type === 'text') {
-					title = firstGrandChild.value;
-				}
+				titleNode = firstChild.children;
+				title = toString(firstChild.children);
 				// The first paragraph contains a directive label, we can safely remove it.
 				node.children.splice(0, 1);
 			}
@@ -189,7 +190,7 @@ function remarkAsides(options: AsidesOptions): Plugin<[], Root> {
 							},
 							iconPaths[variant]
 						),
-						{ type: 'text', value: title },
+						...titleNode,
 					]),
 					h('section', { class: 'starlight-aside__content' }, node.children),
 				]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrojs/starlight",
-  "version": "0.25.0",
+  "version": "0.25.2",
   "description": "Build beautiful, high-performance documentation websites with Astro",
   "keywords": [
     "docs",
@@ -195,6 +195,7 @@
     "hastscript": "^9.0.0",
     "mdast-util-directive": "^3.0.0",
     "mdast-util-to-markdown": "^2.1.0",
+    "mdast-util-to-string": "^4.0.0",
     "pagefind": "^1.0.3",
     "rehype": "^13.0.1",
     "rehype-format": "^5.0.0",

package/schemas/social.ts

@@ -32,6 +32,7 @@ export const socialLinks = [
 	'blueSky',
 	'discourse',
 	'zulip',
+	'pinterest',
 ] as const;
 
 export const SocialLinksSchema = () =>
@@ -79,6 +80,7 @@ export const SocialLinksSchema = () =>
 					blueSky: 'BlueSky',
 					discourse: 'Discourse',
 					zulip: 'Zulip',
+					pinterest: 'Pinterest',
 				}[key];
 				labelledLinks[key] = { label, url };
 			}

package/style/markdown.css

@@ -126,16 +126,23 @@
 .sl-markdown-content th:not([align]):not(:where(.not-content *)) {
 	text-align: start;
 }
-/* Table styles inside asides */
-.sl-markdown-content .starlight-aside :is(th, td):not(:where(.not-content *)) {
+/* <table>s, <hr>s, and <blockquote>s inside asides */
+.sl-markdown-content .starlight-aside :is(th, td, hr, blockquote):not(:where(.not-content *)) {
 	border-color: var(--sl-color-gray-4);
 }
 @supports (border-color: color-mix(in srgb, var(--sl-color-asides-text-accent) 30%, transparent)) {
-	.sl-markdown-content .starlight-aside :is(th, td):not(:where(.not-content *)) {
+	.sl-markdown-content .starlight-aside :is(th, td, hr, blockquote):not(:where(.not-content *)) {
 		border-color: color-mix(in srgb, var(--sl-color-asides-text-accent) 30%, transparent);
 	}
 }
 
+/* <code> inside asides */
+@supports (border-color: color-mix(in srgb, var(--sl-color-asides-text-accent) 12%, transparent)) {
+	.sl-markdown-content .starlight-aside code:not(:where(.not-content *)) {
+		background-color: color-mix(in srgb, var(--sl-color-asides-text-accent) 12%, transparent);
+	}
+}
+
 .sl-markdown-content hr:not(:where(.not-content *)) {
 	border: 0;
 	border-bottom: 1px solid var(--sl-color-hairline);

package/translations/ar.json

@@ -13,17 +13,17 @@
   "sidebarNav.accessibleLabel": "الرئيسية",
   "tableOfContents.onThisPage": "على هذه الصفحة",
   "tableOfContents.overview": "نظرة عامة",
-  "i18n.untranslatedContent": "هذا المحتوى لا يتوفر بلغتك بعد.",
+  "i18n.untranslatedContent": "هذا المحتوى غير متوفر بلغتك بعد.",
   "page.editLink": "عدل الصفحة",
-  "page.lastUpdated": "اخر تحديث:",
+  "page.lastUpdated": "آخر تحديث:",
   "page.previousLink": "السابق",
   "page.nextLink": "التالي",
-  "page.draft": "This content is a draft and will not be included in production builds.",
+  "page.draft": "هذا المحتوى مجرد مسودة ولن يظهر في بنيات الإنتاج",
   "404.text": "الصفحة غير موجودة. تأكد من الرابط أو ابحث بإستعمال شريط البحث.",
-  "aside.note": "ملحوظة",
+  "aside.note": "ملاحظة",
   "aside.tip": "نصيحة",
   "aside.caution": "تنبيه",
   "aside.danger": "تحذير",
   "fileTree.directory": "Directory",
-  "builtWithStarlight.label": "Built with Starlight"
+  "builtWithStarlight.label": "طوِّر بواسطة Starlight"
 }

package/utils/i18n.ts

@@ -118,11 +118,12 @@ function getStarlightI18nConfig(
 		locales,
 		defaultLocale: {
 			...inferStarlightLocaleFromAstroLocale(defaultAstroLocale),
-			locale: isMonolingualWithRootLocale
-				? undefined
-				: isAstroLocaleExtendedConfig(defaultAstroLocale)
-					? defaultAstroLocale.codes[0]
-					: defaultAstroLocale,
+			locale:
+				isMonolingualWithRootLocale || (isMultilingual && !prefixDefaultLocale)
+					? undefined
+					: isAstroLocaleExtendedConfig(defaultAstroLocale)
+						? defaultAstroLocale.codes[0]
+						: defaultAstroLocale,
 		},
 	};
 }

package/utils/navigation.ts

@@ -130,7 +130,7 @@ function linkFromSidebarLinkItem(
 		if (locale) href = '/' + locale + href;
 	}
 	const label = pickLang(item.translations, localeToLang(locale)) || item.label;
-	return makeLink(href, label, currentPathname, item.badge, item.attrs);
+	return makeSidebarLink(href, label, currentPathname, item.badge, item.attrs);
 }
 
 /** Create a link entry from an automatic internal link item in user config. */
@@ -160,11 +160,11 @@ function linkFromInternalSidebarLinkItem(
 	}
 	const label =
 		pickLang(item.translations, localeToLang(locale)) || item.label || entry.entry.data.title;
-	return makeLink(entry.slug, label, currentPathname, item.badge, item.attrs);
+	return makeSidebarLink(entry.slug, label, currentPathname, item.badge, item.attrs);
 }
 
-/** Create a link entry. */
-function makeLink(
+/** Process sidebar link options to create a link entry. */
+function makeSidebarLink(
 	href: string,
 	label: string,
 	currentPathname: string,
@@ -174,10 +174,24 @@ function makeLink(
 	if (!isAbsolute(href)) {
 		href = formatPath(href);
 	}
-
 	const isCurrent = pathsMatch(encodeURI(href), currentPathname);
+	return makeLink({ label, href, isCurrent, badge, attrs });
+}
 
-	return { type: 'link', label, href, isCurrent, badge, attrs: attrs ?? {} };
+/** Create a link entry */
+function makeLink({
+	isCurrent = false,
+	attrs = {},
+	badge = undefined,
+	...opts
+}: {
+	label: string;
+	href: string;
+	isCurrent?: boolean;
+	badge?: Badge | undefined;
+	attrs?: LinkHTMLAttributes | undefined;
+}): Link {
+	return { type: 'link', ...opts, badge, isCurrent, attrs };
 }
 
 /** Test if two paths are equivalent even if formatted differently. */
@@ -240,7 +254,7 @@ function treeify(routes: Route[], baseDir: string): Dir {
 
 /** Create a link entry for a given content collection entry. */
 function linkFromRoute(route: Route, currentPathname: string): Link {
-	return makeLink(
+	return makeSidebarLink(
 		slugToPathname(route.slug),
 		route.entry.data.sidebar.label || route.entry.data.title,
 		currentPathname,
@@ -388,7 +402,7 @@ function applyPrevNextLinkConfig(
 		} 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(config.link, config.label, '');
+			return makeLink({ href: config.link, label: config.label });
 		}
 	}
 	// Otherwise, if the global config is enabled, return the generated link if any.