astro 7.0.0-alpha.0 → 7.0.0-alpha.2

package/dist/core/errors/errors-data.js

@@ -11,7 +11,7 @@ const ClientAddressNotAvailable = {
 const PrerenderClientAddressNotAvailable = {
   name: "PrerenderClientAddressNotAvailable",
   title: "`Astro.clientAddress` cannot be used inside prerendered routes.",
-  message: (name) => `\`Astro.clientAddress\` cannot be used inside prerendered route ${name}`
+  message: (name) => `\`Astro.clientAddress\` cannot be used inside prerendered route ${name}.`
 };
 const StaticClientAddressNotAvailable = {
   name: "StaticClientAddressNotAvailable",
@@ -34,7 +34,7 @@ const OnlyResponseCanBeReturned = {
 const MissingMediaQueryDirective = {
   name: "MissingMediaQueryDirective",
   title: "Missing value for `client:media` directive.",
-  message: 'Media query not provided for `client:media` directive. A media query similar to `client:media="(max-width: 600px)"` must be provided'
+  message: 'Media query not provided for `client:media` directive. A media query similar to `client:media="(max-width: 600px)"` must be provided.'
 };
 const NoMatchingRenderer = {
   name: "NoMatchingRenderer",
@@ -57,42 +57,42 @@ const NoClientOnlyHint = {
   name: "NoClientOnlyHint",
   title: "Missing hint on client:only directive.",
   message: (componentName) => `Unable to render \`${componentName}\`. When using the \`client:only\` hydration strategy, Astro needs a hint to use the correct renderer.`,
-  hint: (probableRenderers) => `Did you mean to pass \`client:only="${probableRenderers}"\`? See https://docs.astro.build/en/reference/directives-reference/#clientonly for more information on client:only`
+  hint: (probableRenderers) => `Did you mean to pass \`client:only="${probableRenderers}"\`? See https://docs.astro.build/en/reference/directives-reference/#clientonly for more information on \`client:only\`.`
 };
 const InvalidGetStaticPathParam = {
   name: "InvalidGetStaticPathParam",
-  title: "Invalid value returned by a `getStaticPaths` path.",
-  message: (paramType) => `Invalid params given to \`getStaticPaths\` path. Expected an \`object\`, got \`${paramType}\``,
-  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on getStaticPaths."
+  title: "Invalid value returned by a route from `getStaticPaths()`.",
+  message: (paramType) => `Invalid \`params\` value returned by a route from \`getStaticPaths()\`. Expected an \`object\`, got \`${paramType}\`.`,
+  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on `getStaticPaths()`."
 };
 const InvalidGetStaticPathsEntry = {
   name: "InvalidGetStaticPathsEntry",
-  title: "Invalid entry inside getStaticPath's return value",
-  message: (entryType) => `Invalid entry returned by getStaticPaths. Expected an object, got \`${entryType}\``,
-  hint: "If you're using a `.map` call, you might be looking for `.flatMap()` instead. See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on getStaticPaths."
+  title: "Invalid entry inside `getStaticPaths()`'s return value.",
+  message: (entryType) => `Invalid entry returned by \`getStaticPaths()\`. Expected an object, got \`${entryType}\`.`,
+  hint: "If you're using a `.map` call, you might be looking for `.flatMap()` instead. See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on `getStaticPaths()`."
 };
 const InvalidGetStaticPathsReturn = {
   name: "InvalidGetStaticPathsReturn",
-  title: "Invalid value returned by getStaticPaths.",
-  message: (returnType) => `Invalid type returned by \`getStaticPaths\`. Expected an \`array\`, got \`${returnType}\``,
-  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on getStaticPaths."
+  title: "Invalid value returned by `getStaticPaths()`.",
+  message: (returnType) => `Invalid type returned by \`getStaticPaths()\`. Expected an \`array\`, got \`${returnType}\`.`,
+  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on `getStaticPaths()`."
 };
 const GetStaticPathsExpectedParams = {
   name: "GetStaticPathsExpectedParams",
-  title: "Missing params property on `getStaticPaths` route.",
-  message: "Missing or empty required `params` property on `getStaticPaths` route.",
-  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on getStaticPaths."
+  title: "Missing params property on `getStaticPaths()` route.",
+  message: "Missing or empty required `params` property on `getStaticPaths()` route.",
+  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on `getStaticPaths()`."
 };
 const GetStaticPathsInvalidRouteParam = {
   name: "GetStaticPathsInvalidRouteParam",
   title: "Invalid route parameter returned by `getStaticPaths()`.",
-  message: (key, value, valueType) => `Invalid \`getStaticPaths()\` route parameter for \`${key}\`. Expected a string or undefined, received \`${valueType}\` (\`${value}\`)`,
-  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on getStaticPaths."
+  message: (key, value, valueType) => `Invalid \`getStaticPaths()\` route parameter for \`${key}\`. Expected a string or undefined, received \`${valueType}\` (\`${value}\`).`,
+  hint: "See https://docs.astro.build/en/reference/routing-reference/#getstaticpaths for more information on `getStaticPaths()`."
 };
 const GetStaticPathsRequired = {
   name: "GetStaticPathsRequired",
   title: "`getStaticPaths()` function required for dynamic routes.",
-  message: "`getStaticPaths()` function is required for dynamic routes. Make sure that you `export` a `getStaticPaths` function from your dynamic route.",
+  message: "`getStaticPaths()` function is required for dynamic routes. Make sure that you `export` a `getStaticPaths()` function from your dynamic route.",
   hint: `See https://docs.astro.build/en/guides/routing/#dynamic-routes for more information on dynamic routes.
 
 	If you meant for this route to be server-rendered, set \`export const prerender = false;\` in the page.`
@@ -104,7 +104,7 @@ const ReservedSlotName = {
 };
 const NoAdapterInstalled = {
   name: "NoAdapterInstalled",
-  title: "Cannot use Server-side Rendering without an adapter.",
+  title: "Cannot use server-side rendering without an adapter.",
   message: `Cannot use server-rendered pages without an adapter. Please install and configure the appropriate server adapter for your final deployment.`,
   hint: "See https://docs.astro.build/en/guides/on-demand-rendering/ for more information."
 };
@@ -115,7 +115,7 @@ const AdapterSupportOutputMismatch = {
 };
 const NoAdapterInstalledServerIslands = {
   name: "NoAdapterInstalledServerIslands",
-  title: "Cannot use Server Islands without an adapter.",
+  title: "Cannot use server islands without an adapter.",
   message: `Cannot use server islands without an adapter. Please install and configure the appropriate server adapter for your final deployment.`,
   hint: "See https://docs.astro.build/en/guides/on-demand-rendering/ for more information."
 };
@@ -128,8 +128,8 @@ const NoMatchingImport = {
 const InvalidPrerenderExport = {
   name: "InvalidPrerenderExport",
   title: "Invalid prerender export.",
-  message(prefix, suffix, isHydridOutput) {
-    const defaultExpectedValue = isHydridOutput ? "false" : "true";
+  message(prefix, suffix, isHybridOutput) {
+    const defaultExpectedValue = isHybridOutput ? "false" : "true";
     let msg = `A \`prerender\` export has been detected, but its value cannot be statically analyzed.`;
     if (prefix !== "const") msg += `
 Expected \`const\` declaration but got \`${prefix}\`.`;
@@ -165,25 +165,25 @@ const InvalidImageService = {
 };
 const MissingImageDimension = {
   name: "MissingImageDimension",
-  title: "Missing image dimensions",
+  title: "Missing image dimensions.",
   message: (missingDimension, imageURL) => `Missing ${missingDimension === "both" ? "width and height attributes" : `${missingDimension} attribute`} for ${imageURL}. When using remote images, both dimensions are required in order to avoid CLS.`,
   hint: "If your image is inside your `src` folder, you probably meant to import it instead. See [the Imports guide for more information](https://docs.astro.build/en/guides/imports/#other-assets). You can also use `inferSize={true}` for remote images to get the original dimensions."
 };
 const FailedToFetchRemoteImageDimensions = {
   name: "FailedToFetchRemoteImageDimensions",
-  title: "Failed to retrieve remote image dimensions",
+  title: "Failed to retrieve remote image dimensions.",
   message: (imageURL) => `Failed to get the dimensions for ${imageURL}.`,
   hint: "Verify your remote image URL is accurate, and that you are not using `inferSize` with a file located in your `public/` folder."
 };
 const RemoteImageNotAllowed = {
   name: "RemoteImageNotAllowed",
-  title: "Remote image is not allowed",
+  title: "Remote image is not allowed.",
   message: (imageURL) => `Remote image ${imageURL} is not allowed by your image configuration.`,
   hint: "Update `image.domains` or `image.remotePatterns`, or remove `inferSize` for this image."
 };
 const UnsupportedImageFormat = {
   name: "UnsupportedImageFormat",
-  title: "Unsupported image format",
+  title: "Unsupported image format.",
   message: (format, imagePath, supportedFormats) => `Received unsupported format \`${format}\` from \`${imagePath}\`. Currently only ${supportedFormats.join(
     ", "
   )} are supported by our image services.`,
@@ -191,12 +191,12 @@ const UnsupportedImageFormat = {
 };
 const UnsupportedImageConversion = {
   name: "UnsupportedImageConversion",
-  title: "Unsupported image conversion",
+  title: "Unsupported image conversion.",
   message: "Converting between vector (such as SVGs) and raster (such as PNGs and JPEGs) images is not currently supported."
 };
 const CannotOptimizeSvg = {
   name: "CannotOptimizeSvg",
-  title: "Cannot optimize SVG",
+  title: "Cannot optimize SVG.",
   message: (path, name) => `An error occurred while optimizing SVG file "${path}" with the "${name}" optimizer.`,
   hint: "Review the included error message provided for guidance."
 };
@@ -223,7 +223,7 @@ Full serialized options received: \`${fullOptions}\`.`,
 const ExpectedImageOptions = {
   name: "ExpectedImageOptions",
   title: "Expected image options.",
-  message: (options) => `Expected getImage() parameter to be an object. Received \`${options}\`.`
+  message: (options) => `Expected \`getImage()\` parameter to be an object. Received \`${options}\`.`
 };
 const ExpectedNotESMImage = {
   name: "ExpectedNotESMImage",
@@ -235,11 +235,11 @@ const GetImageNotUsedOnServer = {
   name: "GetImageNotUsedOnServer",
   title: "`getImage()` must be used on the server.",
   message: "`getImage()` should only be used on the server. To use images on the client, render the `src` from `getImage()` during the server render, then pass it to the client for usage.",
-  hint: "See https://docs.astro.build/en/reference/modules/astro-assets/#getimage for more information on getImage()."
+  hint: "See https://docs.astro.build/en/reference/modules/astro-assets/#getimage for more information on `getImage()`."
 };
 const IncompatibleDescriptorOptions = {
   name: "IncompatibleDescriptorOptions",
-  title: "Cannot set both `densities` and `widths`",
+  title: "Cannot set both `densities` and `widths`.",
   message: "Only one of `densities` or `widths` can be specified. In most cases, you'll probably want to use only `widths` if you require specific widths.",
   hint: "Those attributes are used to construct a `srcset` attribute, which cannot have both `x` and `w` descriptors."
 };
@@ -307,8 +307,8 @@ const MiddlewareCantBeLoaded = {
 const LocalImageUsedWrongly = {
   name: "LocalImageUsedWrongly",
   title: "Local images must be imported.",
-  message: (imageFilePath) => `\`Image\`'s and \`getImage\`'s \`src\` parameter must be an imported image or an URL, it cannot be a string filepath. Received \`${imageFilePath}\`.`,
-  hint: "If you want to use an image from your `src` folder, you need to either import it or if the image is coming from a content collection, use the [image() schema helper](https://docs.astro.build/en/guides/images/#images-in-content-collections). See https://docs.astro.build/en/guides/images/#src-required for more information on the `src` property."
+  message: (imageFilePath) => `\`Image\`'s and \`getImage\`'s \`src\` parameter must be an imported image or a URL, it cannot be a string filepath. Received \`${imageFilePath}\`.`,
+  hint: "If you want to use an image from your `src` folder, you need to either import it or if the image is coming from a content collection, use the [image() schema helper](https://docs.astro.build/en/guides/images/#images-in-content-collections). See https://docs.astro.build/en/reference/modules/astro-assets/#src-required for more information on the `src` property."
 };
 const AstroGlobUsedOutside = {
   name: "AstroGlobUsedOutside",
@@ -335,8 +335,14 @@ const UnsupportedExternalRedirect = {
 const InvalidRedirectDestination = {
   name: "InvalidRedirectDestination",
   title: "Invalid redirect destination.",
-  message: (from, to) => `The redirect from "${from}" to "${to}" is invalid. The destination "${to}" does not match any existing route in your project.`,
-  hint: 'If you are redirecting to a specific page of a dynamic route (e.g., "/posts/[slug]/1"), this is not supported. The destination must be either a static path or a route pattern that matches an existing page (e.g., "/posts/[slug]/[page]").'
+  message(from, to, missingParams) {
+    if (missingParams && missingParams.length > 0) {
+      const formatted = missingParams.map((p) => `[${p}]`).join(", ");
+      return `The redirect from "${from}" to "${to}" is invalid. The destination route is missing dynamic parameter(s) ${formatted} required by the source route "${from}".`;
+    }
+    return `The redirect from "${from}" to "${to}" is invalid. The destination "${to}" does not match any existing route in your project.`;
+  },
+  hint: 'The destination of a dynamic redirect must include all dynamic parameters from the source route. For example, a redirect from "/old/[slug]" must go to a route that also has a [slug] parameter, like "/new/[slug]".'
 };
 const InvalidDynamicRoute = {
   name: "InvalidDynamicRoute",
@@ -351,7 +357,7 @@ const MissingSharp = {
 };
 const UnknownViteError = {
   name: "UnknownViteError",
-  title: "Unknown Vite Error."
+  title: "Unknown Vite error."
 };
 const FailedToLoadModuleSSR = {
   name: "FailedToLoadModuleSSR",
@@ -367,7 +373,7 @@ const InvalidGlob = {
 };
 const FailedToFindPageMapSSR = {
   name: "FailedToFindPageMapSSR",
-  title: "Astro couldn't find the correct page to render",
+  title: "Astro couldn't find the correct page to render.",
   message: "Astro couldn't find the correct page to render, probably because it wasn't correctly mapped for SSR usage. This is an internal error. Please file an issue."
 };
 const MissingLocale = {
@@ -383,13 +389,13 @@ const MissingIndexForInternationalization = {
 };
 const IncorrectStrategyForI18n = {
   name: "IncorrectStrategyForI18n",
-  title: "You can't use the current function with the current strategy",
+  title: "Function incompatible with the current strategy.",
   message: (functionName) => `The function \`${functionName}\` can only be used when the \`i18n.routing.strategy\` is set to \`"manual"\`.`
 };
 const NoPrerenderedRoutesWithDomains = {
   name: "NoPrerenderedRoutesWithDomains",
   title: "Prerendered routes aren't supported when internationalization domains are enabled.",
-  message: (component) => `Static pages aren't yet supported with multiple domains. To enable this feature, you must disable prerendering for the page ${component}`
+  message: (component) => `Static pages aren't yet supported with multiple domains. To enable this feature, you must disable prerendering for the page ${component}.`
 };
 const MissingMiddlewareForInternationalization = {
   name: "MissingMiddlewareForInternationalization",
@@ -398,31 +404,31 @@ const MissingMiddlewareForInternationalization = {
 };
 const InvalidI18nMiddlewareConfiguration = {
   name: "InvalidI18nMiddlewareConfiguration",
-  title: "Invalid internationalization middleware configuration",
+  title: "Invalid internationalization middleware configuration.",
   message: "The option `redirectToDefaultLocale` can be enabled only when `prefixDefaultLocale` is also set to `true`; otherwise, redirects might cause infinite loops. Enable the option `prefixDefaultLocale` to continue to use `redirectToDefaultLocale`, or ensure both are set to `false`."
 };
 const CantRenderPage = {
   name: "CantRenderPage",
   title: "Astro can't render the route.",
   message: "Astro cannot find any content to render for this route. There is no file or redirect associated with this route.",
-  hint: "If you expect to find a route here, this may be an Astro bug. Please file an issue/restart the dev server"
+  hint: "If you expect to find a route here, this may be an Astro bug. Please file an issue/restart the dev server."
 };
 const UnhandledRejection = {
   name: "UnhandledRejection",
-  title: "Unhandled rejection",
+  title: "Unhandled rejection.",
   message: (stack) => `Astro detected an unhandled rejection. Here's the stack trace:
 ${stack}`,
   hint: "Make sure your promises all have an `await` or a `.catch()` handler."
 };
 const i18nNotEnabled = {
   name: "i18nNotEnabled",
-  title: "i18n Not Enabled",
-  message: "The `astro:i18n` module cannot be used without enabling i18n in your Astro config.",
+  title: "Internationalization routing is not enabled.",
+  message: "The `astro:i18n` module cannot be used without enabling `i18n` in your Astro config.",
   hint: "See https://docs.astro.build/en/guides/internationalization for a guide on setting up i18n."
 };
 const i18nNoLocaleFoundInPath = {
   name: "i18nNoLocaleFoundInPath",
-  title: "The path doesn't contain any locale",
+  title: "The path doesn't contain any locale.",
   message: "You tried to use an i18n utility on a path that doesn't contain any locale. You can use `pathHasLocale` first to determine if the path has a locale."
 };
 const RouteNotFound = {
@@ -432,7 +438,7 @@ const RouteNotFound = {
 };
 const EnvInvalidVariables = {
   name: "EnvInvalidVariables",
-  title: "Invalid Environment Variables",
+  title: "Invalid environment variables.",
   message: (errors) => `The following environment variables defined in \`env.schema\` are invalid:
 
 ${errors.map((err) => `- ${err}`).join("\n")}
@@ -440,7 +446,7 @@ ${errors.map((err) => `- ${err}`).join("\n")}
 };
 const EnvPrefixConflictsWithSecret = {
   name: "EnvPrefixConflictsWithSecret",
-  title: "envPrefix conflicts with secret environment variables",
+  title: "`envPrefix` conflicts with secret environment variables.",
   message: (conflicts) => `The following environment variables are declared with \`access: "secret"\` in \`env.schema\`, but their names match a prefix in \`vite.envPrefix\`, which would expose them in client-side bundles:
 
 ${conflicts.map((c) => `- ${c}`).join("\n")}
@@ -449,13 +455,13 @@ Either remove the conflicting prefixes from \`vite.envPrefix\`, or rename these
 };
 const ServerOnlyModule = {
   name: "ServerOnlyModule",
-  title: "Module is only available server-side",
+  title: "Module is only available server-side.",
   message: (name) => `The "${name}" module is only available server-side.`
 };
 const RewriteWithBodyUsed = {
   name: "RewriteWithBodyUsed",
-  title: "Cannot use Astro.rewrite after the request body has been read",
-  message: "Astro.rewrite() cannot be used if the request body has already been read. If you need to read the body, first clone the request."
+  title: "Cannot use `Astro.rewrite()` after the request body has been read.",
+  message: "`Astro.rewrite()` cannot be used if the request body has already been read. If you need to read the body, first clone the request."
 };
 const ForbiddenRewrite = {
   name: "ForbiddenRewrite",
@@ -465,7 +471,7 @@ const ForbiddenRewrite = {
 The static route '${to}' is rendered by the component
 '${component}', which is marked as prerendered. This is a forbidden operation because during the build, the component '${component}' is compiled to an
 HTML file, which can't be retrieved at runtime by Astro.`,
-  hint: (component) => `Add \`export const prerender = false\` to the component '${component}', or use a Astro.redirect().`
+  hint: (component) => `Add \`export const prerender = false\` to the component '${component}', or use \`Astro.redirect()\`.`
 };
 const UnknownFilesystemError = {
   name: "UnknownFilesystemError",
@@ -475,30 +481,30 @@ const UnknownFilesystemError = {
 const CannotExtractFontType = {
   name: "CannotExtractFontType",
   title: "Cannot extract the font type from the given URL.",
-  message: (url) => `An error occurred while trying to extract the font type from ${url}`,
+  message: (url) => `An error occurred while trying to extract the font type from ${url}.`,
   hint: "Open an issue at https://github.com/withastro/astro/issues."
 };
 const CannotDetermineWeightAndStyleFromFontFile = {
   name: "CannotDetermineWeightAndStyleFromFontFile",
   title: "Cannot determine weight and style from font file.",
-  message: (family, url) => `An error occurred while determining the \`weight\` and \`style\` from local family "${family}" font file: ${url}`,
+  message: (family, url) => `An error occurred while determining the \`weight\` and \`style\` from local family "${family}" font file: ${url}.`,
   hint: "Update your family config and set `weight` and `style` manually instead."
 };
 const CannotFetchFontFile = {
   name: "CannotFetchFontFile",
   title: "Cannot fetch the given font file.",
-  message: (url) => `An error occurred while fetching the font file from ${url}`,
+  message: (url) => `An error occurred while fetching the font file from ${url}.`,
   hint: "This is often caused by connectivity issues. If the error persists, open an issue at https://github.com/withastro/astro/issues."
 };
 const FontFamilyNotFound = {
   name: "FontFamilyNotFound",
-  title: "Font family not found",
+  title: "Font family not found.",
   message: (family) => `No data was found for the \`"${family}"\` family passed to the \`<Font>\` component.`,
   hint: "This is often caused by a typo. Check that the `<Font />` component is using a `cssVariable` specified in your config."
 };
 const FontFileUrlNotFound = {
   name: "FontFileUrlNotFound",
-  title: "Font file URL not found",
+  title: "Font file URL not found.",
   message: (url) => `The \`"${url}"\` URL passed to the \`experimental_getFontFileURL()\` function is invalid.`,
   hint: "Make sure you pass a valid URL, obtained via the `fontData` object."
 };
@@ -509,8 +515,8 @@ const MissingGetFontFileRequestUrl = {
 };
 const UnavailableAstroGlobal = {
   name: "UnavailableAstroGlobal",
-  title: "Unavailable Astro global in getStaticPaths()",
-  message: (name) => `The Astro global is not available in this scope. Please remove "Astro.${name}" from your getStaticPaths() function.`
+  title: "Unavailable Astro global in `getStaticPaths()`.",
+  message: (name) => `The Astro global is not available in this scope. Please remove \`Astro.${name}\` from your \`getStaticPaths()\` function.`
 };
 const UnableToLoadLogger = {
   name: "UnableToLoadLogger",
@@ -519,19 +525,19 @@ const UnableToLoadLogger = {
 };
 const LoggerConfigurationNotSerializable = {
   name: "LoggerConfigurationNotSerializable",
-  title: "The configuration of the logger is not serializable"
+  title: "The configuration of the logger is not serializable."
 };
 const UnknownCSSError = {
   name: "UnknownCSSError",
-  title: "Unknown CSS Error."
+  title: "Unknown CSS error."
 };
 const CSSSyntaxError = {
   name: "CSSSyntaxError",
-  title: "CSS Syntax Error."
+  title: "CSS syntax error."
 };
 const UnknownMarkdownError = {
   name: "UnknownMarkdownError",
-  title: "Unknown Markdown Error."
+  title: "Unknown Markdown error."
 };
 const MarkdownFrontmatterParseError = {
   name: "MarkdownFrontmatterParseError",
@@ -566,22 +572,22 @@ const ConfigLegacyKey = {
 };
 const UnknownCLIError = {
   name: "UnknownCLIError",
-  title: "Unknown CLI Error."
+  title: "Unknown CLI error."
 };
 const GenerateContentTypesError = {
   name: "GenerateContentTypesError",
   title: "Failed to generate content types.",
-  message: (errorMessage) => `\`astro sync\` command failed to generate content collection types: ${errorMessage}`,
+  message: (errorMessage) => `\`astro sync\` command failed to generate content collection types: ${errorMessage}.`,
   hint: (fileName) => `This error is often caused by a syntax error inside your content, or your content configuration file. Check your ${fileName ?? "content config"} file for typos.`
 };
 const UnknownContentCollectionError = {
   name: "UnknownContentCollectionError",
-  title: "Unknown Content Collection Error."
+  title: "Unknown content collection error."
 };
 const RenderUndefinedEntryError = {
   name: "RenderUndefinedEntryError",
   title: "Attempted to render an undefined content collection entry.",
-  hint: "Check if the entry is undefined before passing it to `render()`"
+  hint: "Check if the entry is undefined before passing it to `render()`."
 };
 const GetEntryDeprecationError = {
   name: "GetEntryDeprecationError",
@@ -665,7 +671,7 @@ const LiveContentConfigError = {
 };
 const ContentLoaderInvalidDataError = {
   name: "ContentLoaderInvalidDataError",
-  title: "Content entry is missing an ID",
+  title: "Content entry is missing an ID.",
   message(collection, extra) {
     return `**${String(collection)}** entry is missing an ID.
 ${extra}`;
@@ -684,7 +690,7 @@ const InvalidContentEntrySlugError = {
 };
 const ContentSchemaContainsSlugError = {
   name: "ContentSchemaContainsSlugError",
-  title: "Content Schema should not contain `slug`.",
+  title: "Content schema should not contain `slug`.",
   message: (collectionName) => `A content collection schema should not contain \`slug\` since it is reserved for slug generation. Remove this from your ${collectionName} collection schema.`,
   hint: "See https://docs.astro.build/en/guides/content-collections/ for more on the `slug` field."
 };
@@ -727,19 +733,19 @@ Full error: ${parseError}`,
 };
 const FileParserNotFound = {
   name: "FileParserNotFound",
-  title: "File parser not found",
+  title: "File parser not found.",
   message: (fileName) => `No parser was found for '${fileName}'. Pass a parser function (e.g. \`parser: csv\`) to the \`file\` loader.`
 };
 const FileGlobNotSupported = {
   name: "FileGlobNotSupported",
-  title: "Glob patterns are not supported in the file loader",
+  title: "Glob patterns are not supported in the file loader.",
   message: "Glob patterns are not supported in the `file` loader. Use the `glob` loader instead.",
   hint: `See Astro's file loader https://docs.astro.build/en/reference/content-loader-reference/#file-loader for supported usage.`
 };
 const ActionsWithoutServerOutputError = {
   name: "ActionsWithoutServerOutputError",
   title: "Actions must be used with server output.",
-  message: "A server is required to create callable backend functions. To deploy routes to a server, add an adapter to your Astro config and configure your route for on-demand rendering",
+  message: "A server is required to create callable backend functions. To deploy routes to a server, add an adapter to your Astro config and configure your route for on-demand rendering.",
   hint: "Add an adapter and enable on-demand rendering: https://docs.astro.build/en/guides/on-demand-rendering/"
 };
 const ActionsReturnedInvalidDataError = {
@@ -756,8 +762,8 @@ const ActionNotFoundError = {
 };
 const ActionCalledFromServerError = {
   name: "ActionCalledFromServerError",
-  title: "Action unexpected called from the server.",
-  message: "Action called from a server page or endpoint without using `Astro.callAction()`. This wrapper must be used to call actions from server code.",
+  title: "Action called from the server without `Astro.callAction()`.",
+  message: "Action called from a server-rendered page or endpoint without using `Astro.callAction()`. This wrapper must be used to call actions from server code.",
   hint: "See the `Astro.callAction()` reference for usage examples: https://docs.astro.build/en/reference/api-reference/#callaction"
 };
 const UnknownError = { name: "UnknownError", title: "Unknown Error." };

package/dist/core/errors/handler.d.ts

@@ -0,0 +1,9 @@
+import type { RenderErrorOptions } from '../app/base.js';
+/**
+ * A strategy for rendering error responses (404, 500, etc.). Each execution
+ * environment (prod SSR, build/prerender, dev server) supplies its own
+ * implementation rather than overriding a method on the app.
+ */
+export interface ErrorHandler {
+    renderError(request: Request, options: RenderErrorOptions): Promise<Response>;
+}

package/dist/core/errors/zod-error-map.js

@@ -24,6 +24,17 @@ const errorMap = (issue) => {
         `> ${getTypeOrLiteralMsg(error)}`
       ) : `> ${prefix(key, getTypeOrLiteralMsg(error))}`
     );
+    if (details.length === 0) {
+      if ("discriminator" in issue && issue.discriminator && "options" in issue) {
+        const options = issue.options;
+        if (Array.isArray(options)) {
+          details.push(
+            `> Expected \`${issue.discriminator}\` to be ${options.map((o) => `\`${stringify(o)}\``).join(" | ")}`
+          );
+          details.push("> Received `" + stringify(issue.input) + "`");
+        }
+      }
+    }
     if (details.length === 0) {
       const expectedShapes = [];
       for (const unionErrors of issue.errors) {
@@ -33,7 +44,9 @@ const errorMap = (issue) => {
             return errorMap(_issue);
           }
           const relativePath = flattenErrorPath(_issue.path).replace(baseErrorPath, "").replace(leadingPeriod, "");
-          if ("expected" in _issue && typeof _issue.expected === "string") {
+          if (_issue.code === "custom" && _issue.message && _issue.message.includes("security.csp")) {
+            expectedShape.push(_issue.message);
+          } else if ("expected" in _issue && typeof _issue.expected === "string") {
             expectedShape.push(
               relativePath ? `${relativePath}: ${_issue.expected}` : _issue.expected
             );
@@ -59,6 +72,22 @@ const errorMap = (issue) => {
     return {
       message: messages.concat(details).join("\n")
     };
+  } else if (issue.code === "invalid_key") {
+    const keyIssues = issue.issues;
+    if (Array.isArray(keyIssues) && keyIssues.length > 0) {
+      const firstIssue = keyIssues[0];
+      const msg = firstIssue.message || "Invalid key in record";
+      return { message: prefix(baseErrorPath, msg) };
+    }
+    return { message: prefix(baseErrorPath, "Invalid key in record") };
+  } else if (issue.code === "invalid_element") {
+    const elementIssues = issue.issues;
+    if (Array.isArray(elementIssues) && elementIssues.length > 0) {
+      const firstIssue = elementIssues[0];
+      const msg = firstIssue.message || "Invalid element";
+      return { message: prefix(baseErrorPath, msg) };
+    }
+    return { message: prefix(baseErrorPath, "Invalid element") };
   } else if (issue.code === "invalid_type") {
     return {
       message: prefix(

package/dist/core/fetch/default-handler.d.ts

@@ -0,0 +1,17 @@
+import type { BaseApp, ResolvedRenderOptions } from '../app/base.js';
+import type { Pipeline } from '../base-pipeline.js';
+import type { FetchHandler } from './types.js';
+/**
+ * The default request handler for `BaseApp`. Builds the per-request
+ * `FetchState` and delegates to an `AstroHandler`.
+ */
+export declare class DefaultFetchHandler {
+    #private;
+    constructor(app?: BaseApp<Pipeline>);
+    /**
+     * Fast path: called directly by `BaseApp.render()` with pre-resolved
+     * options, avoiding the `Reflect.set/get` round-trip through the request.
+     */
+    renderWithOptions(request: Request, options: ResolvedRenderOptions): Promise<Response>;
+    fetch: FetchHandler;
+}

package/dist/core/fetch/default-handler.js

@@ -0,0 +1,45 @@
+import { FetchState } from "./fetch-state.js";
+import { appSymbol } from "../constants.js";
+import { AstroHandler } from "../routing/handler.js";
+class DefaultFetchHandler {
+  #app;
+  #handler;
+  constructor(app) {
+    this.#app = app ?? null;
+    this.#handler = app ? new AstroHandler(app) : null;
+  }
+  /**
+   * Fast path: called directly by `BaseApp.render()` with pre-resolved
+   * options, avoiding the `Reflect.set/get` round-trip through the request.
+   */
+  renderWithOptions(request, options) {
+    if (!this.#app) {
+      const app = Reflect.get(request, appSymbol);
+      if (!app) {
+        throw new Error("No fetch handler provided.");
+      }
+      this.#app = app;
+      this.#handler = new AstroHandler(app);
+    }
+    const state = new FetchState(this.#app.pipeline, request, options);
+    return this.#handler.handle(state);
+  }
+  fetch = (request) => {
+    if (!this.#app) {
+      const app = Reflect.get(request, appSymbol);
+      if (!app) {
+        throw new Error("No fetch handler provided.");
+      }
+      this.#app = app;
+      this.#handler = new AstroHandler(app);
+    }
+    const state = new FetchState(this.#app.pipeline, request);
+    if (!this.#handler) {
+      throw new Error("No fetch handler provided.");
+    }
+    return this.#handler.handle(state);
+  };
+}
+export {
+  DefaultFetchHandler
+};