astro 5.5.6 → 5.6.0

package/dist/prefetch/index.d.ts

@@ -23,6 +23,14 @@ export interface PrefetchOptions {
      * Should prefetch even on data saver mode or slow connection. (default `false`)
      */
     ignoreSlowConnection?: boolean;
+    /**
+     * A string providing a hint to the browser as to how eagerly it should prefetch/prerender link targets in order to balance performance advantages against resource overheads. (default `immediate`)
+     * Only works if `clientPrerender` is enabled and browser supports Speculation Rules API.
+     * The browser takes this hint into consideration along with its own heuristics, so it may select a link that the author has hinted as less eager than another, if the less eager candidate is considered a better choice.
+     *
+     * https://developer.mozilla.org/en-US/docs/Web/HTML/Element/script/type/speculationrules#eagerness
+     */
+    eagerness?: 'immediate' | 'eager' | 'moderate' | 'conservative';
 }
 /**
  * Prefetch a URL so it's cached when the user navigates to it.

package/dist/prefetch/index.js

@@ -125,7 +125,7 @@ function prefetch(url, opts) {
   prefetchedUrls.add(url);
   if (clientPrerender && HTMLScriptElement.supports?.("speculationrules")) {
     debug?.(`[astro] Prefetching ${url} with <script type="speculationrules">`);
-    appendSpeculationRules(url);
+    appendSpeculationRules(url, opts?.eagerness ?? "immediate");
   } else if (document.createElement("link").relList?.supports?.("prefetch") && opts?.with !== "fetch") {
     debug?.(`[astro] Prefetching ${url} with <link rel="prefetch">`);
     const link = document.createElement("link");
@@ -182,14 +182,15 @@ function onPageLoad(cb) {
     cb();
   });
 }
-function appendSpeculationRules(url) {
+function appendSpeculationRules(url, eagerness) {
   const script = document.createElement("script");
   script.type = "speculationrules";
   script.textContent = JSON.stringify({
     prerender: [
       {
         source: "list",
-        urls: [url]
+        urls: [url],
+        eagerness
       }
     ],
     // Currently, adding `prefetch` is required to fallback if `prerender` fails.
@@ -198,7 +199,8 @@ function appendSpeculationRules(url) {
     prefetch: [
       {
         source: "list",
-        urls: [url]
+        urls: [url],
+        eagerness
       }
     ]
   });

package/dist/types/public/config.d.ts

@@ -4,9 +4,8 @@ import type { RehypePlugins, RemarkPlugins, RemarkRehype, ShikiConfig, SyntaxHig
 import type { BuiltinDriverName, BuiltinDriverOptions, Driver, Storage } from 'unstorage';
 import type { UserConfig as OriginalViteUserConfig, SSROptions as ViteSSROptions } from 'vite';
 import type { ImageFit, ImageLayout } from '../../assets/types.js';
-import type { SvgRenderMode } from '../../assets/utils/svg.js';
 import type { AssetsPrefix } from '../../core/app/types.js';
-import type { AstroConfigType } from '../../core/config/schema.js';
+import type { AstroConfigType } from '../../core/config/schemas/index.js';
 import type { REDIRECT_STATUS_CODES } from '../../core/constants.js';
 import type { AstroCookieSetOptions } from '../../core/cookies/cookies.js';
 import type { LoggerLevel } from '../../core/logger/core.js';
@@ -1978,7 +1977,7 @@ export interface ViteUserConfig extends OriginalViteUserConfig {
         /**
          *
          * @name experimental.svg
-         * @type {boolean|object}
+         * @type {boolean}
          * @default `undefined`
          * @version 5.x
          * @description
@@ -2009,28 +2008,7 @@ export interface ViteUserConfig extends OriginalViteUserConfig {
          * For a complete overview, and to give feedback on this experimental API,
          * see the [Feature RFC](https://github.com/withastro/roadmap/pull/1035).
          */
-        svg?: boolean | {
-            /**
-             *
-             * @name experimental.svg.mode
-             * @type {string}
-             * @default 'inline'
-             *
-             * The default technique for handling imported SVG files. Astro will inline the SVG content into your HTML output if not specified.
-             *
-             * - `inline`: Astro will inline the SVG content into your HTML output.
-             * - `sprite`: Astro will generate a sprite sheet with all imported SVG files.
-             *
-             * ```astro
-             * ---
-             * import Logo from './path/to/svg/file.svg';
-             * ---
-             *
-             * <Logo size={24} mode="sprite" />
-             * ```
-             */
-            mode: SvgRenderMode;
-        };
+        svg?: boolean;
         /**
          * @name experimental.serializeConfig
          * @type {boolean}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astro",
-  "version": "5.5.6",
+  "version": "5.6.0",
   "description": "Astro is a modern site builder with web best practices, performance, and DX front-of-mind.",
   "type": "module",
   "author": "withastro",