astro 6.0.0-alpha.0 → 6.0.0-alpha.2

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

@@ -1,7 +1,8 @@
 import type { OutgoingHttpHeaders } from 'node:http';
 import type { RemotePattern } from '@astrojs/internal-helpers/remote';
 import type { RehypePlugins, RemarkPlugins, RemarkRehype, ShikiConfig, SyntaxHighlightConfigType } from '@astrojs/markdown-remark';
-import type { BuiltinDriverName, BuiltinDriverOptions, Driver, Storage } from 'unstorage';
+import type { Config as SvgoConfig } from 'svgo';
+import type { BuiltinDriverName, BuiltinDriverOptions, Storage } from 'unstorage';
 import type { UserConfig as OriginalViteUserConfig, SSROptions as ViteSSROptions } from 'vite';
 import type { AstroFontProvider, FontFamily } from '../../assets/fonts/types.js';
 import type { ImageFit, ImageLayout } from '../../assets/types.js';
@@ -18,8 +19,17 @@ export type Locales = (string | {
     path: string;
 })[];
 export type { AstroFontProvider as FontProvider };
-export type { CspAlgorithm };
+export type { CspAlgorithm, CspHash };
 export type { RemotePattern };
+export type CspStyleDirective = {
+    hashes?: CspHash[];
+    resources?: string[];
+};
+export type CspScriptDirective = {
+    hashes?: CspHash[];
+    resources?: string[];
+    strictDynamic?: boolean;
+};
 type NormalizeLocales<T extends Locales> = {
     [K in keyof T]: T[K] extends string ? T[K] : T[K] extends {
         codes: Array<string>;
@@ -136,11 +146,7 @@ interface TestSessionConfig extends CommonSessionConfig {
 export type SessionConfig<TDriver extends SessionDriverName> = [
     TDriver
 ] extends [never] ? CustomSessionConfig : TDriver extends keyof BuiltinDriverOptions ? BuiltinSessionConfig<TDriver> : TDriver extends 'test' ? TestSessionConfig : CustomSessionConfig;
-export type ResolvedSessionConfig<TDriver extends SessionDriverName> = SessionConfig<TDriver> & {
-    driverModule?: () => Promise<{
-        default: () => Driver;
-    }>;
-};
+export type ResolvedSessionConfig<TDriver extends SessionDriverName> = SessionConfig<TDriver>;
 export interface ViteUserConfig extends OriginalViteUserConfig {
     ssr?: ViteSSROptions;
 }
@@ -479,6 +485,58 @@ export interface AstroUserConfig<TLocales extends Locales = never, TSession exte
      * Using `'attribute'` is useful when you are manipulating the `class` attribute of elements and need to avoid conflicts between your own styling logic and Astro's application of styles.
      */
     scopedStyleStrategy?: 'where' | 'class' | 'attribute';
+    /**
+     * @docs
+     * @name prerenderConflictBehavior
+     * @type {'error' | 'warn' | 'ignore'}
+     * @default `'warn'`
+     * @version 6.0
+     * @description
+     * Determines the default behavior when two routes generate the same prerendered URL:
+     * - `error`: fail the build and display an error, forcing you to resolve the conflict
+     * - `warn` (default): log a warning when conflicts occur, but build using the highest-priority route
+     * - `ignore`: silently build using the highest-priority route when conflicts occur
+     *
+     * ```js
+     * {
+     *   prerenderConflictBehavior: 'error'
+     * }
+     * ```
+     */
+    prerenderConflictBehavior?: 'error' | 'warn' | 'ignore';
+    /**
+     * @docs
+     * @name vite
+     * @typeraw {ViteUserConfig}
+     * @description
+     *
+     * Pass additional configuration options to Vite. Useful when Astro doesn't support some advanced configuration that you may need.
+     *
+     * View the full `vite` configuration object documentation on [vite.dev](https://vite.dev/config/).
+     *
+     * #### Examples
+     *
+     * ```js
+     * {
+     *   vite: {
+     *     ssr: {
+     *       // Example: Force a broken package to skip SSR processing, if needed
+     *       external: ['broken-npm-package'],
+     *     }
+     *   }
+     * }
+     * ```
+     *
+     * ```js
+     * {
+     *   vite: {
+     *     // Example: Add custom vite plugins directly to your Astro project
+     *     plugins: [myPlugin()],
+     *   }
+     * }
+     * ```
+     */
+    vite?: ViteUserConfig;
     /**
      * @docs
      * @name security
@@ -562,40 +620,337 @@ export interface AstroUserConfig<TLocales extends Locales = never, TSession exte
          * When not configured, `X-Forwarded-Host` headers are not trusted and will be ignored.
          */
         allowedDomains?: Partial<RemotePattern>[];
+        /**
+         * @docs
+         * @name security.csp
+         * @kind h4
+         * @type {boolean | object}
+         * @default `false`
+         * @version 6.0.0
+         * @description
+         *
+         * Enables support for [Content Security Policy (CSP)](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP) to help minimize certain types of security threats by controlling which resources a document is allowed to load. This provides additional protection against [cross-site scripting (XSS)](https://developer.mozilla.org/en-US/docs/Glossary/Cross-site_scripting) attacks.
+         *
+         * Enabling this feature adds additional security to Astro's handling of processed and bundled scripts and styles by default, and allows you to further configure these, and additional, content types.
+         *
+         * This feature comes with some limitations:
+         * - External scripts and external styles are not supported out of the box, but you can [provide your own hashes](https://v6.docs.astro.build/en/reference/configuration-reference/#hashes).
+         * - [Astro's view transitions](https://v6.docs.astro.build/en/guides/view-transitions/) using the `<ClientRouter />` are not supported, but you can [consider migrating to the browser native View Transition API](https://events-3bg.pages.dev/jotter/astro-view-transitions/) instead if you are not using Astro's enhancements to the native View Transitions and Navigation APIs.
+         * - Shiki isn't currently supported. By design, Shiki functions using inline styles.
+         *
+         * :::note
+         * Due to the nature of the Vite dev server, this feature isn't supported while working in `dev` mode. Instead, you can test this in your Astro project using `build` and `preview`.
+         * :::
+         *
+         * When enabled, Astro will add a `<meta>` element inside the `<head>` element of each page.
+         * This element will have the `http-equiv="content-security-policy"` attribute, and the `content` attribute will provide values for the `script-src` and `style-src` [directives](https://v6.docs.astro.build/en/reference/configuration-reference/#securitycspdirectives) based on the script and styles used in the page.
+         *
+         * ```html
+         *
+         * <head>
+         *   <meta
+         *     http-equiv="content-security-policy"
+         *     content="
+         *     script-src 'self' 'sha256-somehash';
+         *     style-src 'self' 'sha256-somehash';
+         *     "
+         *   >
+         * </head>
+         * ```
+         *
+         * You can further customize the `<meta>` element by enabling this feature with a configuration object that includes additional options.
+         */
+        csp?: boolean | {
+            /**
+             * @docs
+             * @name security.csp.algorithm
+             * @kind h5
+             * @type {"SHA-256" | "SHA-384" | "SHA-512"}
+             * @default `'SHA-256'`
+             * @version 6.0.0
+             * @description
+             *
+             * The [hash function](https://developer.mozilla.org/en-US/docs/Glossary/Hash_function) to use when generating the hashes of the styles and scripts emitted by Astro.
+             *
+             * ```js title="astro.config.mjs"
+             * import { defineConfig } from 'astro/config';
+             *
+             * export default defineConfig({
+             *   security: {
+             *     csp: {
+             *      algorithm: 'SHA-512'
+             *     }
+             *   }
+             * });
+             * ```
+             */
+            algorithm?: CspAlgorithm;
+            /**
+             * @docs
+             * @name security.csp.directives
+             * @kind h5
+             * @type {string[]}
+             * @default `[]`
+             * @version 6.0.0
+             * @description
+             *
+             * A list of [CSP directives](https://content-security-policy.com/#directive) (beyond `script-src` and `style-src` which are included by default) that defines valid sources for specific content types. These directives are added to all pages.
+             *
+             * ```js title="astro.config.mjs"
+             * import { defineConfig } from 'astro/config';
+             *
+             * export default defineConfig({
+             *   security: {
+             *     csp: {
+             *       directives: [
+             *         "default-src 'self'",
+             *         "img-src 'self' https://images.cdn.example.com"
+             *       ]
+             *     }
+             *   }
+             * });
+             * ```
+             * After the build, the `<meta>` element will add your directives into the `content` value alongside Astro's default directives:
+             *
+             * ```html
+             * <meta
+             *   http-equiv="content-security-policy"
+             *   content="
+             *     default-src 'self';
+             *     img-src 'self' 'https://images.cdn.example.com';
+             *     script-src 'self' 'sha256-somehash';
+             *     style-src 'self' 'sha256-somehash';
+             *   "
+             * >
+             * ```
+             */
+            directives?: CspDirective[];
+            /**
+             * @docs
+             * @name security.csp.styleDirective
+             * @kind h5
+             * @type {CspStyleDirective}
+             * @default `undefined`
+             * @version 6.0.0
+             * @description
+             *
+             * A configuration object that allows you to override the default sources for the `style-src` directive with the [`resources`](https://v6.docs.astro.build/en/reference/configuration-reference/#resources) property, or to provide additional [hashes](https://v6.docs.astro.build/en/reference/configuration-reference#hashes) to be rendered.					 */
+            styleDirective?: {
+                /**
+                 * @docs
+                 * @name security.csp.styleDirective.hashes
+                 * @kind h6
+                 * @type {CspHash[]}
+                 * @default `[]`
+                 * @version 6.0.0
+                 * @description
+                 *
+                 * A list of additional hashes to be rendered.
+                 *
+                 * You must provide hashes that start with `sha384-`, `sha512-` or `sha256-`. Other values will cause a validation error. These hashes are added to all pages.
+                 *
+                 * ```js title="astro.config.mjs"
+                 * import { defineConfig } from 'astro/config';
+                 *
+                 * export default defineConfig({
+                 *   security: {
+                 *     csp: {
+                 *       styleDirective: {
+                 *         hashes: [
+                 *           "sha384-styleHash",
+                 *           "sha512-styleHash",
+                 *           "sha256-styleHash"
+                 *         ]
+                 *       }
+                 *     }
+                 *   }
+                 * });
+                 * ```
+                 *
+                 * After the build, the `<meta>` element will include your additional hashes in the `style-src` directives:
+                 *
+                 * ```html
+                 * <meta
+                 *   http-equiv="content-security-policy"
+                 *   content="
+                 *     style-src 'self' 'sha384-styleHash' 'sha512-styleHash' 'sha256-styleHash' 'sha256-generatedByAstro';
+                 *   "
+                 * >
+                 * ```
+                 */
+                hashes?: CspHash[];
+                /**
+                 * @docs
+                 * @name security.csp.styleDirective.resources
+                 * @kind h6
+                 * @type {string[]}
+                 * @default `[]`
+                 * @version 6.0.0
+                 * @description
+                 *
+                 * A list of valid sources for `style-src` directives to override Astro's default sources. This will not include `'self'` by default, and must be included in this list if you wish to keep it. These resources are added to all pages.
+                 *
+                 * ```js title="astro.config.mjs"
+                 * import { defineConfig } from 'astro/config';
+                 *
+                 * export default defineConfig({
+                 *   security: {
+                 *     csp: {
+                 *       styleDirective: {
+                 *         resources: [
+                 *           "'self'",
+                 *           "https://styles.cdn.example.com"
+                 *         ]
+                 *       }
+                 *     }
+                 *   }
+                 * });
+                 * ```
+                 *
+                 * After the build, the `<meta>` element will instead apply your sources to the `style-src` directives:
+                 *
+                 * ```html
+                 * <head>
+                 *   <meta
+                 *     http-equiv="content-security-policy"
+                 *     content="
+                 *      style-src 'self' https://styles.cdn.example.com 'sha256-somehash';
+                 *     "
+                 *   >
+                 * </head>
+                 * ```
+                 *
+                 * When resources are inserted multiple times or from multiple sources (e.g. defined in your `csp` config and added using [the CSP runtime API](/en/reference/api-reference/#csp)), Astro will merge and deduplicate all resources to create your `<meta>` element.
+                 */
+                resources?: string[];
+            };
+            /**
+             * @docs
+             * @name security.csp.scriptDirective
+             * @kind h5
+             * @type {CspScriptDirective}
+             * @default `undefined`
+             * @version 6.0.0
+             * @description
+             *
+             * A configuration object that allows you to override the default sources for the `script-src` directive with the [`resources`](https://v6.docs.astro.build/en/reference/configuration-reference/#resources) property, or to provide additional [hashes]((https://v6.docs.astro.build/en/reference/configuration-reference#hashes) to be rendered.
+             */
+            scriptDirective?: {
+                /**
+                 * @docs
+                 * @name security.csp.scriptDirective.hashes
+                 * @kind h6
+                 * @type {CspHash[]}
+                 * @default `[]`
+                 * @version 6.0.0
+                 * @description
+                 *
+                 * A list of additional hashes to be rendered.
+                 *
+                 * You must provide hashes that start with `sha384-`, `sha512-` or `sha256-`. Other values will cause a validation error. These hashes are added to all pages.
+                 *
+                 * ```js title="astro.config.mjs"
+                 * import { defineConfig } from 'astro/config';
+                 *
+                 * export default defineConfig({
+                 *   security: {
+                 *     csp: {
+                 *       scriptDirective: {
+                 *         hashes: [
+                 *           "sha384-scriptHash",
+                 *           "sha512-scriptHash",
+                 *           "sha256-scriptHash"
+                 *         ]
+                 *       }
+                 *     }
+                 *   }
+                 * });
+                 * ```
+                 *
+                 * After the build, the `<meta>` element will include your additional hashes in the `script-src` directives:
+                 *
+                 * ```html
+                 * <meta
+                 *   http-equiv="content-security-policy"
+                 *   content="
+                 *     script-src 'self' 'sha384-scriptHash' 'sha512-scriptHash' 'sha256-scriptHash' 'sha256-generatedByAstro';
+                 *   "
+                 * >
+                 * ```
+                 */
+                hashes?: CspHash[];
+                /**
+                 * @docs
+                 * @name security.csp.scriptDirective.resources
+                 * @kind h6
+                 * @type {string[]}
+                 * @default `[]`
+                 * @version 6.0.0
+                 * @description
+                 *
+                 * A list of valid sources for the `script-src` directives to override Astro's default sources. This will not include `'self'` by default, and must be included in this list if you wish to keep it. These resources are added to all pages.
+                 *
+                 * ```js title="astro.config.mjs"
+                 * import { defineConfig } from 'astro/config';
+                 *
+                 * export default defineConfig({
+                 *   security: {
+                 *     csp: {
+                 *       scriptDirective: {
+                 *         resources: [
+                 *           "'self'", "https://cdn.example.com"
+                 *         ]
+                 *       }
+                 *     }
+                 *   }
+                 * });
+                 * ```
+                 *
+                 * After the build, the `<meta>` element will instead apply your sources to the `script-src` directives:
+                 *
+                 * ```html
+                 * <head>
+                 *   <meta
+                 *     http-equiv="content-security-policy"
+                 *     content="
+                 *      script-src 'self' https://cdn.example.com 'sha256-somehash';
+                 *     "
+                 *   >
+                 * </head>
+                 * ```
+                 *
+                 * When resources are inserted multiple times or from multiple sources (e.g. defined in your `csp` config and added using [the CSP runtime API](/en/reference/api-reference/#csp)), Astro will merge and deduplicate all resources to create your `<meta>` element.
+                 */
+                resources?: string[];
+                /**
+                 * @docs
+                 * @name security.csp.scriptDirective.strictDynamic
+                 * @kind h6
+                 * @type {boolean}
+                 * @default `false`
+                 * @version 6.0.0
+                 * @description
+                 *
+                 * Enables [the `strict-dynamic` keyword](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP#the_strict-dynamic_keyword) to support the dynamic injection of scripts.
+                 *
+                 * ```js title="astro.config.mjs"
+                 * import { defineConfig } from 'astro/config';
+                 *
+                 * export default defineConfig({
+                 *   security: {
+                 *     csp: {
+                 *       scriptDirective: {
+                 *         strictDynamic: true
+                 *       }
+                 *     }
+                 *   }
+                 * });
+                 * ```
+                 */
+                strictDynamic?: boolean;
+            };
+        };
     };
-    /**
-     * @docs
-     * @name vite
-     * @typeraw {ViteUserConfig}
-     * @description
-     *
-     * Pass additional configuration options to Vite. Useful when Astro doesn't support some advanced configuration that you may need.
-     *
-     * View the full `vite` configuration object documentation on [vite.dev](https://vite.dev/config/).
-     *
-     * #### Examples
-     *
-     * ```js
-     * {
-     *   vite: {
-     *     ssr: {
-     *       // Example: Force a broken package to skip SSR processing, if needed
-     *       external: ['broken-npm-package'],
-     *     }
-     *   }
-     * }
-     * ```
-     *
-     * ```js
-     * {
-     *   vite: {
-     *     // Example: Add custom vite plugins directly to your Astro project
-     *     plugins: [myPlugin()],
-     *   }
-     * }
-     * ```
-     */
-    vite?: ViteUserConfig;
     /**
      * @docs
      * @kind heading
@@ -1966,17 +2321,6 @@ export interface AstroUserConfig<TLocales extends Locales = never, TSession exte
          * See the [Prefetch Guide](https://docs.astro.build/en/guides/prefetch/) for more `prefetch` options and usage.
          */
         clientPrerender?: boolean;
-        /**
-         *
-         * @name experimental.failOnPrerenderConflict
-         * @type {boolean}
-         * @default `false`
-         * @version 5.x
-         * @description
-         * When two routes generate the same prerendered URL, fail the build instead of skipping one.
-         * If disabled (default), a warning is logged when conflicts occur and the highest-priority route wins.
-         */
-        failOnPrerenderConflict?: boolean;
         /**
          *
          * @name experimental.contentIntellisense
@@ -2018,244 +2362,6 @@ export interface AstroUserConfig<TLocales extends Locales = never, TSession exte
          * see the [Fonts RFC](https://github.com/withastro/roadmap/pull/1039).
          */
         fonts?: FontFamily[];
-        /**
-         * @name experimental.csp
-         * @type {boolean | object}
-         * @default `false`
-         * @version 5.9.0
-         * @description
-         *
-         * Enables built-in support for Content Security Policy (CSP). For more information,
-         * refer to the [experimental CSP documentation](https://docs.astro.build/en/reference/experimental-flags/csp/)
-         *
-         */
-        csp?: boolean | {
-            /**
-             * @name experimental.csp.algorithm
-             * @type {"SHA-256" | "SHA-384" | "SHA-512"}
-             * @default `'SHA-256'`
-             * @version 5.9.0
-             * @description
-             *
-             * The [hash function](https://developer.mozilla.org/en-US/docs/Glossary/Hash_function) to use to generate the hashes of the styles and scripts emitted by Astro.
-             *
-             * ```js
-             * import { defineConfig } from 'astro/config';
-             *
-             * export default defineConfig({
-             *   experimental: {
-             *     csp: {
-             *       algorithm: 'SHA-512'
-             *     }
-             *   }
-             * });
-             * ```
-             */
-            algorithm?: CspAlgorithm;
-            /**
-             * @name experimental.csp.styleDirective
-             * @type {{ hashes?: CspHash[], resources?: string[] }}
-             * @default `undefined`
-             * @version 5.9.0
-             * @description
-             *
-             * A configuration object that allows you to override the default sources for the `style-src` directive
-             * with the `resources` property, or to provide additional `hashes` to be rendered.
-             *
-             * These properties are added to all pages and completely override Astro's default resources, not add to them.
-             * Therefore, you must explicitly specify any default values that you want to be included.
-             */
-            styleDirective?: {
-                /**
-                 * @name experimental.csp.styleDirective.hashes
-                 * @type {CspHash[]}
-                 * @default `[]`
-                 * @version 5.9.0
-                 * @description
-                 *
-                 * A list of additional hashes added to the `style-src` directive.
-                 *
-                 * If you have external styles that aren't generated by Astro, this configuration option allows you to provide additional hashes to be rendered.
-                 *
-                 * You must provide hashes that start with `sha384-`, `sha512-` or `sha256-`. Other values will cause a validation error. These hashes are added to all pages.
-                 *
-                 * ```js
-                 * import { defineConfig } from 'astro/config';
-                 *
-                 * export default defineConfig({
-                 *   experimental: {
-                 *     csp: {
-                 *       styleDirective: {
-                 *         hashes: [
-                 *           "sha384-styleHash",
-                 *           "sha512-styleHash",
-                 *           "sha256-styleHash"
-                 *         ]
-                 *       }
-                 *     }
-                 *   }
-                 * });
-                 * ```
-                 */
-                hashes?: CspHash[];
-                /**
-                 * @name experimental.csp.styleDirective.resources
-                 * @type {string[]}
-                 * @default `[]`
-                 * @version 5.9.0
-                 * @description
-                 *
-                 * A list of resources applied to the `style-src` directive. These resources are added to all pages and will override Astro's defaults.
-                 *
-                 * ```js
-                 * import { defineConfig } from 'astro/config';
-                 *
-                 * export default defineConfig({
-                 *   experimental: {
-                 *     csp: {
-                 *       styleDirective: {
-                 *         resources: [
-                 *           "'self'",
-                 *           "https://styles.cdn.example.com"
-                 *         ]
-                 *       }
-                 *     }
-                 *   }
-                 * });
-                 * ```
-                 */
-                resources?: string[];
-            };
-            /**
-             * @name experimental.csp.scriptDirective
-             * @type {{ hashes?: CspHash[], resources?: string[], strictDynamic?: boolean }}
-             * @default `undefined`
-             * @version 5.9.0
-             * @description
-             *
-             * A configuration object that allows you to override the default sources for the `script-src` directive
-             * with the `resources` property, or to provide additional `hashes` to be rendered.
-             *
-             * These properties are added to all pages and completely override Astro's default resources, not add to them.
-             * Therefore, you must explicitly specify any default values that you want to be included.
-             *
-             */
-            scriptDirective?: {
-                /**
-                 * @name experimental.csp.scriptDirective.hashes
-                 * @type {CspHash[]}
-                 * @default `[]`
-                 * @version 5.9.0
-                 * @description
-                 *
-                 * A list of additional hashes added to the `script-src` directive.
-                 *
-                 * If you have external scripts that aren't generated by Astro, or inline scripts, this configuration option allows you to provide additional hashes to be rendered.
-                 *
-                 * You must provide hashes that start with `sha384-`, `sha512-` or `sha256-`. Other values will cause a validation error. These hashes are added to all pages.
-                 *
-                 * ```js
-                 * import { defineConfig } from 'astro/config';
-                 *
-                 * export default defineConfig({
-                 *   experimental: {
-                 *     csp: {
-                 *       scriptDirective: {
-                 *         hashes: [
-                 *           "sha384-scriptHash",
-                 *           "sha512-scriptHash",
-                 *           "sha256-scriptHash"
-                 *         ]
-                 *       }
-                 *     }
-                 *   }
-                 * });
-                 * ```
-                 */
-                hashes?: CspHash[];
-                /**
-                 * @name experimental.csp.scriptDirective.resources
-                 * @type {string[]}
-                 * @default `[]`
-                 * @version 5.9.0
-                 * @description
-                 *
-                 * A list of resources applied to the `script-src` directive. These resources are added to all pages and will override Astro's defaults.
-                 *
-                 * ```js
-                 * import { defineConfig } from 'astro/config';
-                 *
-                 * export default defineConfig({
-                 *   experimental: {
-                 *     csp: {
-                 *       scriptDirective: {
-                 *         resources: [
-                 *           "'self'",
-                 *           "https://cdn.example.com"
-                 *         ]
-                 *       }
-                 *     }
-                 *   }
-                 * });
-                 * ```
-                 *
-                 */
-                resources?: string[];
-                /**
-                 * @name experimental.csp.scriptDirective.strictDynamic
-                 * @type {boolean}
-                 * @default `false`
-                 * @version 5.9.0
-                 * @description
-                 *
-                 * Enables the keyword `strict-dynamic` to support the dynamic injection of scripts.
-                 *
-                 * ```js
-                 * import { defineConfig } from 'astro/config';
-                 *
-                 * export default defineConfig({
-                 *   experimental: {
-                 *     csp: {
-                 *       scriptDirective: {
-                 *         strictDynamic: true
-                 *       }
-                 *     }
-                 *   }
-                 * });
-                 * ```
-                 */
-                strictDynamic?: boolean;
-            };
-            /**
-             * @name experimental.csp.directives
-             * @type {string[]}
-             * @default `[]`
-             * @version 5.9.0
-             * @description
-             *
-             * An array of additional directives to add the content of the `Content-Security-Policy` `<meta>` element.
-             *
-             * Use this configuration to add other directive definitions such as `default-src`, `image-src`, etc.
-             *
-             * ##### Example
-             *
-             * You can define a directive to fetch images only from a CDN `cdn.example.com`.
-             *
-             * ```js
-             * export default defineConfig({
-             * 	experimental: {
-             * 		csp: {
-             * 			directives: [
-             * 				"image-src 'https://cdn.example.com"
-             * 			]
-             * 		}
-             * 	}
-             * })
-             * ```
-             *
-             */
-            directives?: CspDirective[];
-        };
         /**
          * @name experimental.chromeDevtoolsWorkspace
          * @type {boolean}
@@ -2281,6 +2387,49 @@ export interface AstroUserConfig<TLocales extends Locales = never, TSession exte
          * See the [experimental Chrome DevTools workspace feature documentation](https://docs.astro.build/en/reference/experimental-flags/chrome-devtools-workspace/) for more information.
          */
         chromeDevtoolsWorkspace?: boolean;
+        /**
+         * @name experimental.svgo
+         * @type {boolean | SvgoConfig}
+         * @default `false`
+         * @description
+         * Enable SVG optimization using SVGO during build time.
+         *
+         * Set to `true` to enable optimization with default settings, or pass a configuration
+         * object to customize SVGO behavior.
+         *
+         * When enabled, all imported SVG files will be optimized for smaller file sizes
+         * and better performance while maintaining visual quality.
+         *
+         * ```js
+         * {
+         *   experimental: {
+         *     // Enable with defaults
+         *     svgo: true
+         *   }
+         * }
+         * ```
+         *
+         * To customize optimization, pass a [SVGO configuration object](https://svgo.dev/):
+         *
+         * ```js
+         * {
+         *   experimental: {
+         *     svgo: {
+         *       plugins: [
+         *         'preset-default',
+         *         {
+         *           name: 'removeViewBox',
+         *           active: false
+         *         }
+         *       ]
+         *     }
+         *   }
+         * }
+         * ```
+         *
+         * See the [experimental SVGO optimization docs](https://docs.astro.build/en/reference/experimental-flags/svg-optimization/) for more information.
+         */
+        svgo?: boolean | SvgoConfig;
     };
 }
 /**