From 180b0e30a822c6b90a1ddcf662af1aa08207bce0 Mon Sep 17 00:00:00 2001
From: Roman <dev@rman.dev>
Date: Fri, 11 Sep 2026 22:43:02 +0100
Subject: [PATCH 1/2] fix: improve jsdoc for fonts

---
 packages/astro/src/assets/fonts/types.ts | 28 ++++++++++++------------
 1 file changed, 14 insertions(+), 14 deletions(-)

diff --git a/packages/astro/src/assets/fonts/types.ts b/packages/astro/src/assets/fonts/types.ts
index b9241ca34a4c..7b5ba6649646 100644
--- a/packages/astro/src/assets/fonts/types.ts
+++ b/packages/astro/src/assets/fonts/types.ts
@@ -59,9 +59,9 @@ export interface FontProvider<
 
 export interface FamilyProperties {
 	/**
-	 * @default `"swap"`
-	 *
 	 * Defines [how a font displays](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display) based on when it is downloaded and ready for use.
+	 * 
+	 * @default "swap"
 	 */
 	display?: Display | undefined;
 	/**
@@ -132,8 +132,6 @@ export type FontFamily<TFontProvider extends FontProvider = FontProvider> = Fami
 		 */
 		provider: TFontProvider;
 		/**
-		 * @default `[400]`
-		 *
 		 * An array of [font weights](https://developer.mozilla.org/en-US/docs/Web/CSS/font-weight). If no value is specified in your configuration, only weight `400` is
 		 * included by default to prevent unnecessary downloads. You will need to include this property to access any other font weights.
 		 *
@@ -142,29 +140,29 @@ export type FontFamily<TFontProvider extends FontProvider = FontProvider> = Fami
 		 * ```js
 		 * weight: "100 900"
 		 * ```
+		 * 
+		 * @default [400]
 		 */
 		weights?: [Weight, ...Array<Weight>] | undefined;
 		/**
-		 * @default `["normal", "italic"]`
-		 *
 		 * An array of [font styles](https://developer.mozilla.org/en-US/docs/Web/CSS/font-style).
+		 * 
+		 * @default ["normal", "italic"]
 		 */
 		styles?: [Style, ...Array<Style>] | undefined;
 		/**
-		 * @default `["latin"]`
-		 *
 		 * Defines a list of [font subsets](https://knaap.dev/posts/font-subsetting/).
+		 * 
+		 * @default ["latin"]
 		 */
 		subsets?: [string, ...Array<string>] | undefined;
 		/**
-		 * @default `["woff2"]`
-		 *
 		 * An array of [font formats](https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/At-rules/@font-face/src#font_formats).
+		 * 
+		 * @default ["woff2"]
 		 */
 		formats?: [FontType, ...Array<FontType>] | undefined;
 		/**
-		 * @default `["sans-serif"]`
-		 *
 		 * An array of fonts to use when your chosen font is unavailable, or loading. Fallback fonts will be chosen in the order listed. The first available font will be used:
 		 *
 		 * ```js
@@ -179,12 +177,14 @@ export type FontFamily<TFontProvider extends FontProvider = FontProvider> = Fami
 		 *
 		 * If the last font in the `fallbacks` array is a [generic family name](https://developer.mozilla.org/en-US/docs/Web/CSS/font-family#generic-name), Astro will attempt to
 		 * generate [optimized fallbacks](https://developer.chrome.com/blog/font-fallbacks) using font metrics will be generated. To disable this optimization, set `optimizedFallbacks` to false.
+		 * 
+		 * @default ["sans-serif"]
 		 */
 		fallbacks?: Array<string> | undefined;
 		/**
-		 * @default `true`
-		 *
 		 * Whether or not to enable Astro's default optimization when generating fallback fonts. You may disable this default optimization to have full control over how `fallbacks` are generated.
+		 * 
+		 * @default true
 		 */
 		optimizedFallbacks?: boolean | undefined;
 	};

From ea4bdcc1eeca9bbfe80300077865ffa69193df20 Mon Sep 17 00:00:00 2001
From: Roman <dev@rman.dev>
Date: Fri, 11 Sep 2026 22:47:35 +0100
Subject: [PATCH 2/2] chore: add changeset

---
 .changeset/strong-shrimps-end.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 .changeset/strong-shrimps-end.md

diff --git a/.changeset/strong-shrimps-end.md b/.changeset/strong-shrimps-end.md
new file mode 100644
index 000000000000..fa494c280ac6
--- /dev/null
+++ b/.changeset/strong-shrimps-end.md
@@ -0,0 +1,5 @@
+---
+'astro': patch
+---
+
+Improves JSDoc for fonts api