astro 1.5.3 → 1.6.1

package/client-base.d.ts

@@ -1,19 +1,106 @@
 /// <reference path="./import-meta.d.ts" />
 
+type MD = import('./dist/@types/astro').MarkdownInstance<Record<string, any>>;
+interface ExportedMarkdownModuleEntities {
+	frontmatter: MD['frontmatter'];
+	file: MD['file'];
+	url: MD['url'];
+	getHeadings: MD['getHeadings'];
+	/** @deprecated Renamed to `getHeadings()` */
+	getHeaders: () => void;
+	Content: MD['Content'];
+	rawContent: MD['rawContent'];
+	compiledContent: MD['compiledContent'];
+	load: MD['default'];
+}
+
 declare module '*.md' {
-	type MD = import('./dist/@types/astro').MarkdownInstance<Record<string, any>>;
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
+	export default load;
+}
 
-	export const frontmatter: MD['frontmatter'];
-	export const file: MD['file'];
-	export const url: MD['url'];
-	export const getHeadings: MD['getHeadings'];
-	/** @deprecated Renamed to `getHeadings()` */
-	export const getHeaders: () => void;
-	export const Content: MD['Content'];
-	export const rawContent: MD['rawContent'];
-	export const compiledContent: MD['compiledContent'];
+declare module '*.markdown' {
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
+	export default load;
+}
+
+declare module '*.mkdn' {
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
+	export default load;
+}
+
+declare module '*.mkd' {
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
+	export default load;
+}
+
+declare module '*.mdwn' {
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
+	export default load;
+}
 
-	const load: MD['default'];
+declare module '*.mdown' {
+	const { load }: ExportedMarkdownModuleEntities;
+	export const {
+		frontmatter,
+		file,
+		url,
+		getHeadings,
+		getHeaders,
+		Content,
+		rawContent,
+		compiledContent,
+	}: ExportedMarkdownModuleEntities;
 	export default load;
 }
 

package/dist/@types/astro.d.ts

@@ -11,6 +11,7 @@ import type { PageBuildData } from '../core/build/types';
 import type { AstroConfigSchema } from '../core/config';
 import type { AstroCookies } from '../core/cookies';
 import type { AstroComponentFactory } from '../runtime/server';
+import { SUPPORTED_MARKDOWN_FILE_EXTENSIONS } from './../core/constants.js';
 export type { MarkdownHeading, MarkdownMetadata, MarkdownRenderingResult, RehypePlugins, RemarkPlugins, ShikiConfig, } from '@astrojs/markdown-remark';
 export type { SSRManifest } from '../core/app/types';
 export interface AstroBuiltinProps {
@@ -54,6 +55,7 @@ export interface AstroComponentMetadata {
 export interface CLIFlags {
     root?: string;
     site?: string;
+    base?: string;
     host?: string | boolean;
     port?: number;
     config?: string;
@@ -219,6 +221,8 @@ export interface AstroGlobal<Props extends Record<string, any> = Record<string,
         render(slotName: string, args?: any[]): Promise<string>;
     };
 }
+/** Union type of supported markdown file extensions */
+declare type MarkdowFileExtension = typeof SUPPORTED_MARKDOWN_FILE_EXTENSIONS[number];
 export interface AstroGlobalPartial {
     /**
      * @deprecated since version 0.24. See the {@link https://astro.build/deprecated/resolve upgrade guide} for more details.
@@ -237,7 +241,7 @@ export interface AstroGlobalPartial {
      * [Astro reference](https://docs.astro.build/en/reference/api-reference/#astroglob)
      */
     glob(globStr: `${any}.astro`): Promise<AstroInstance[]>;
-    glob<T extends Record<string, any>>(globStr: `${any}.md`): Promise<MarkdownInstance<T>[]>;
+    glob<T extends Record<string, any>>(globStr: `${any}${MarkdowFileExtension}`): Promise<MarkdownInstance<T>[]>;
     glob<T extends Record<string, any>>(globStr: `${any}.mdx`): Promise<MDXInstance<T>[]>;
     glob<T extends Record<string, any>>(globStr: string): Promise<T[]>;
     /**
@@ -675,7 +679,7 @@ export interface AstroUserConfig {
          * Pass [remark plugins](https://github.com/remarkjs/remark) to customize how your Markdown is built. You can import and apply the plugin function (recommended), or pass the plugin name as a string.
          *
          * :::caution
-         * Providing a list of plugins will **remove** our default plugins. To preserve these defaults, see the `extendDefaultPlugins` flag.
+         * Providing a list of plugins will **remove** our default plugins. To preserve these defaults, see the [`extendDefaultPlugins`](#markdownextenddefaultplugins) flag.
          * :::
          *
          * ```js
@@ -696,7 +700,7 @@ export interface AstroUserConfig {
          * Pass [rehype plugins](https://github.com/remarkjs/remark-rehype) to customize how your Markdown's output HTML is processed. You can import and apply the plugin function (recommended), or pass the plugin name as a string.
          *
          * :::caution
-         * Providing a list of plugins will **remove** our default plugins. To preserve these defaults, see the `extendDefaultPlugins` flag.
+         * Providing a list of plugins will **remove** our default plugins. To preserve these defaults, see the [`extendDefaultPlugins`](#markdownextenddefaultplugins) flag.
          * :::
          *
          * ```js
@@ -816,7 +820,7 @@ export interface AstroUserConfig {
          * @default `false`
          * @version 1.0.0-rc.1
          * @description
-         * Enable Astro's pre-v1.0 support for components and JSX expressions in `.md` Markdown files.
+         * Enable Astro's pre-v1.0 support for components and JSX expressions in `.md` (and alternative extensions for markdown files like ".markdown") Markdown files.
          * In Astro `1.0.0-rc`, this original behavior was removed as the default, in favor of our new [MDX integration](/en/guides/integrations-guide/mdx/).
          *
          * To enable this behavior, set `legacy.astroFlavoredMarkdown` to `true` in your [`astro.config.mjs` configuration file](/en/guides/configuring-astro/#the-astro-config-file).

package/dist/cli/index.js

@@ -14,13 +14,13 @@ import {
 } from "../core/config/index.js";
 import { ASTRO_VERSION } from "../core/constants.js";
 import devServer from "../core/dev/index.js";
-import { collectErrorMetadata } from "../core/errors.js";
+import { collectErrorMetadata } from "../core/errors/dev/index.js";
+import { createSafeError } from "../core/errors/index.js";
 import { debug, error, info } from "../core/logger/core.js";
 import { enableVerboseLogging, nodeLogDestination } from "../core/logger/node.js";
 import { formatConfigErrorMessage, formatErrorMessage, printHelp } from "../core/messages.js";
 import { appendForwardSlash } from "../core/path.js";
 import preview from "../core/preview/index.js";
-import { createSafeError } from "../core/util.js";
 import * as event from "../events/index.js";
 import { eventConfigError, eventError, telemetry } from "../events/index.js";
 import { check } from "./check/index.js";
@@ -44,6 +44,8 @@ function printAstroHelp() {
       "Global Flags": [
         ["--config <path>", "Specify your config file."],
         ["--root <path>", "Specify your project root folder."],
+        ["--site <url>", "Specify your project site."],
+        ["--base <pathname>", "Specify your project base."],
         ["--verbose", "Enable verbose logging."],
         ["--silent", "Disable all logging."],
         ["--version", "Show the version number and exit."],

package/dist/core/build/index.js

@@ -8,7 +8,7 @@ import {
   runHookConfigSetup
 } from "../../integrations/index.js";
 import { createVite } from "../create-vite.js";
-import { fixViteErrorMessage } from "../errors.js";
+import { enhanceViteSSRError } from "../errors/dev/index.js";
 import { debug, info, levels, timerMessage } from "../logger/core.js";
 import { apply as applyPolyfill } from "../polyfill.js";
 import { RouteCache } from "../render/route-cache.js";
@@ -127,7 +127,7 @@ class AstroBuilder {
     try {
       await this.build(setupData);
     } catch (_err) {
-      throw fixViteErrorMessage(_err);
+      throw enhanceViteSSRError(_err);
     }
   }
   validateConfig() {

package/dist/core/build/static-build.js

@@ -92,6 +92,7 @@ async function ssrBuild(opts, internals, input) {
       emptyOutDir: false,
       manifest: false,
       outDir: fileURLToPath(out),
+      copyPublicDir: !ssr,
       rollupOptions: {
         ...(_a = viteConfig.build) == null ? void 0 : _a.rollupOptions,
         input: [],
@@ -105,7 +106,7 @@ async function ssrBuild(opts, internals, input) {
       },
       ssr: true,
       minify: false,
-      polyfillModulePreload: false,
+      modulePreload: { polyfill: false },
       reportCompressedSize: false
     },
     plugins: [
@@ -120,7 +121,6 @@ async function ssrBuild(opts, internals, input) {
       settings.config.output === "server" && vitePluginSSR(internals, settings.adapter),
       vitePluginAnalyzer(internals)
     ],
-    publicDir: ssr ? false : viteConfig.publicDir,
     envPrefix: "PUBLIC_",
     base: settings.config.base
   };

package/dist/core/compile/compile.js

@@ -1,7 +1,8 @@
 import { transform } from "@astrojs/compiler";
-import { AstroErrorCodes } from "../errors.js";
+import { AstroErrorCodes } from "../errors/codes.js";
+import { AggregateError, CompilerError } from "../errors/errors.js";
 import { prependForwardSlash } from "../path.js";
-import { AggregateError, resolvePath, viteID } from "../util.js";
+import { resolvePath, viteID } from "../util.js";
 import { createStylePreprocessor } from "./style.js";
 const configCache = /* @__PURE__ */ new WeakMap();
 async function compile({
@@ -28,23 +29,42 @@ async function compile({
       return resolvePath(specifier, filename);
     }
   }).catch((err) => {
-    err.code = err.code || AstroErrorCodes.UnknownCompilerError;
-    throw err;
+    throw new CompilerError({
+      errorCode: AstroErrorCodes.UnknownCompilerError,
+      message: err.message ?? "Unknown compiler error",
+      stack: err.stack,
+      location: {
+        file: filename
+      }
+    });
   }).then((result) => {
+    const compilerError = result.diagnostics.find(
+      (diag) => diag.severity === 1 && diag.code < 2e3
+    );
+    if (compilerError) {
+      throw new CompilerError({
+        errorCode: compilerError.code,
+        message: compilerError.text,
+        location: {
+          line: compilerError.location.line,
+          column: compilerError.location.column,
+          file: compilerError.location.file
+        },
+        hint: compilerError.hint ? compilerError.hint : void 0
+      });
+    }
     switch (cssTransformErrors.length) {
       case 0:
         return result;
       case 1: {
         let error = cssTransformErrors[0];
-        if (!error.code) {
-          error.code = AstroErrorCodes.UnknownCompilerCSSError;
+        if (!error.errorCode) {
+          error.errorCode = AstroErrorCodes.UnknownCompilerCSSError;
         }
         throw cssTransformErrors[0];
       }
       default: {
-        const aggregateError = new AggregateError(cssTransformErrors);
-        aggregateError.code = AstroErrorCodes.UnknownCompilerCSSError;
-        throw aggregateError;
+        throw new AggregateError({ ...cssTransformErrors[0], errors: cssTransformErrors });
       }
     }
   });

package/dist/core/config/config.js

@@ -72,6 +72,7 @@ function resolveFlags(flags) {
   return {
     root: typeof flags.root === "string" ? flags.root : void 0,
     site: typeof flags.site === "string" ? flags.site : void 0,
+    base: typeof flags.base === "string" ? flags.base : void 0,
     port: typeof flags.port === "number" ? flags.port : void 0,
     config: typeof flags.config === "string" ? flags.config : void 0,
     host: typeof flags.host === "string" || typeof flags.host === "boolean" ? flags.host : void 0,
@@ -86,6 +87,8 @@ function mergeCLIFlags(astroConfig, flags, cmd) {
   astroConfig.markdown = astroConfig.markdown || {};
   if (typeof flags.site === "string")
     astroConfig.site = flags.site;
+  if (typeof flags.base === "string")
+    astroConfig.base = flags.base;
   if (typeof flags.drafts === "boolean")
     astroConfig.markdown.drafts = flags.drafts;
   if (typeof flags.port === "number") {

package/dist/core/config/settings.js

@@ -1,3 +1,4 @@
+import { SUPPORTED_MARKDOWN_FILE_EXTENSIONS } from "./../constants.js";
 import jsxRenderer from "../../jsx/renderer.js";
 import { loadTSConfig } from "./tsconfig.js";
 function createSettings(config, cwd) {
@@ -8,7 +9,7 @@ function createSettings(config, cwd) {
     tsConfigPath: tsconfig == null ? void 0 : tsconfig.path,
     adapter: void 0,
     injectedRoutes: [],
-    pageExtensions: [".astro", ".md", ".html"],
+    pageExtensions: [".astro", ".html", ...SUPPORTED_MARKDOWN_FILE_EXTENSIONS],
     renderers: [jsxRenderer],
     scripts: [],
     watchFiles: (tsconfig == null ? void 0 : tsconfig.exists) ? [tsconfig.path, ...tsconfig.extendedPaths] : []

package/dist/core/constants.d.ts

@@ -1 +1,2 @@
 export declare const ASTRO_VERSION: string;
+export declare const SUPPORTED_MARKDOWN_FILE_EXTENSIONS: readonly [".markdown", ".mdown", ".mkdn", ".mkd", ".mdwn", ".md"];

package/dist/core/constants.js

@@ -1,4 +1,13 @@
-const ASTRO_VERSION = "1.5.3";
+const ASTRO_VERSION = "1.6.1";
+const SUPPORTED_MARKDOWN_FILE_EXTENSIONS = [
+  ".markdown",
+  ".mdown",
+  ".mkdn",
+  ".mkd",
+  ".mdwn",
+  ".md"
+];
 export {
-  ASTRO_VERSION
+  ASTRO_VERSION,
+  SUPPORTED_MARKDOWN_FILE_EXTENSIONS
 };

package/dist/core/create-vite.js

@@ -1,8 +1,6 @@
-import fs from "fs";
-import { createRequire } from "module";
-import path from "path";
 import { fileURLToPath } from "url";
 import * as vite from "vite";
+import { crawlFrameworkPkgs } from "vitefu";
 import astroPostprocessVitePlugin from "../vite-plugin-astro-postprocess/index.js";
 import astroViteServerPlugin from "../vite-plugin-astro-server/index.js";
 import astroVitePlugin from "../vite-plugin-astro/index.js";
@@ -15,7 +13,7 @@ import legacyMarkdownVitePlugin from "../vite-plugin-markdown-legacy/index.js";
 import markdownVitePlugin from "../vite-plugin-markdown/index.js";
 import astroScriptsPlugin from "../vite-plugin-scripts/index.js";
 import astroScriptsPageSSRPlugin from "../vite-plugin-scripts/page-ssr.js";
-import { createCustomViteLogger } from "./errors.js";
+import { createCustomViteLogger } from "./errors/dev/index.js";
 import { resolveDependency } from "./util.js";
 const ALWAYS_NOEXTERNAL = /* @__PURE__ */ new Set([
   "astro",
@@ -35,7 +33,22 @@ function getSsrNoExternalDeps(projectRoot) {
   return noExternalDeps;
 }
 async function createVite(commandConfig, { settings, logging, mode }) {
-  const thirdPartyAstroPackages = await getAstroPackages(settings);
+  const astroPkgsConfig = await crawlFrameworkPkgs({
+    root: fileURLToPath(settings.config.root),
+    isBuild: mode === "build",
+    isFrameworkPkgByJson(pkgJson) {
+      var _a, _b, _c, _d;
+      return ((_a = pkgJson.peerDependencies) == null ? void 0 : _a.astro) || ((_b = pkgJson.dependencies) == null ? void 0 : _b.astro) || ((_c = pkgJson.keywords) == null ? void 0 : _c.includes("astro")) || ((_d = pkgJson.keywords) == null ? void 0 : _d.includes("astro-component")) || /^(@[^\/]+\/)?astro\-/.test(pkgJson.name);
+    },
+    isFrameworkPkgByName(pkgName) {
+      const isNotAstroPkg = isCommonNotAstro(pkgName);
+      if (isNotAstroPkg) {
+        return false;
+      } else {
+        return void 0;
+      }
+    }
+  });
   const commonConfig = {
     cacheDir: fileURLToPath(new URL("./node_modules/.vite/", settings.config.root)),
     clearScreen: false,
@@ -88,8 +101,11 @@ async function createVite(commandConfig, { settings, logging, mode }) {
       conditions: ["astro"]
     },
     ssr: {
-      noExternal: [...getSsrNoExternalDeps(settings.config.root), ...thirdPartyAstroPackages],
-      external: mode === "dev" ? ["shiki"] : []
+      noExternal: [
+        ...getSsrNoExternalDeps(settings.config.root),
+        ...astroPkgsConfig.ssr.noExternal
+      ],
+      external: [...mode === "dev" ? ["shiki"] : [], ...astroPkgsConfig.ssr.external]
     }
   };
   let result = commonConfig;
@@ -118,84 +134,6 @@ function sortPlugins(pluginOptions) {
   pluginOptions.splice(mdxPluginIndex, 1);
   pluginOptions.splice(jsxPluginIndex, 0, mdxPlugin);
 }
-async function getAstroPackages(settings) {
-  const { astroPackages } = new DependencyWalker(settings.config.root);
-  return astroPackages;
-}
-class DependencyWalker {
-  constructor(root) {
-    this.astroDeps = /* @__PURE__ */ new Set();
-    this.nonAstroDeps = /* @__PURE__ */ new Set();
-    const pkgUrl = new URL("./package.json", root);
-    this.require = createRequire(pkgUrl);
-    const pkgPath = fileURLToPath(pkgUrl);
-    if (!fs.existsSync(pkgPath))
-      return;
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf8"));
-    const deps = [
-      ...Object.keys(pkg.dependencies || {}),
-      ...Object.keys(pkg.devDependencies || {})
-    ];
-    this.scanDependencies(deps);
-  }
-  get astroPackages() {
-    return Array.from(this.astroDeps);
-  }
-  seen(dep) {
-    return this.astroDeps.has(dep) || this.nonAstroDeps.has(dep);
-  }
-  readPkgJSON(dir) {
-    try {
-      const filePath = path.join(dir, "package.json");
-      return JSON.parse(fs.readFileSync(filePath, "utf-8"));
-    } catch (e) {
-    }
-  }
-  resolvePkgJSON(dep) {
-    try {
-      const pkgJson = this.require(dep + "/package.json");
-      return pkgJson;
-    } catch (e) {
-      try {
-        let dir = path.dirname(this.require.resolve(dep));
-        while (dir) {
-          const pkgJSON = this.readPkgJSON(dir);
-          if (pkgJSON && pkgJSON.name === dep)
-            return pkgJSON;
-          const parentDir = path.dirname(dir);
-          if (parentDir === dir)
-            break;
-          dir = parentDir;
-        }
-      } catch {
-      }
-    }
-  }
-  scanDependencies(deps) {
-    const newDeps = [];
-    for (const dep of deps) {
-      if (isCommonNotAstro(dep)) {
-        this.nonAstroDeps.add(dep);
-        continue;
-      }
-      const pkgJson = this.resolvePkgJSON(dep);
-      if (!pkgJson) {
-        this.nonAstroDeps.add(dep);
-        continue;
-      }
-      const { dependencies = {}, peerDependencies = {}, keywords = [] } = pkgJson;
-      if (peerDependencies.astro || dependencies.astro || keywords.includes("astro") || keywords.includes("astro-component") || /^(@[^\/]+\/)?astro\-/.test(dep)) {
-        this.astroDeps.add(dep);
-        const unknownDependencies = Object.keys(dependencies).filter((d) => !this.seen(d));
-        newDeps.push(...unknownDependencies);
-      } else {
-        this.nonAstroDeps.add(dep);
-      }
-    }
-    if (newDeps.length)
-      this.scanDependencies(newDeps);
-  }
-}
 const COMMON_DEPENDENCIES_NOT_ASTRO = [
   "autoprefixer",
   "react",

package/dist/core/dev/index.js

@@ -54,7 +54,7 @@ async function dev(settings, options) {
       isRestart
     })
   );
-  const currentVersion = "1.5.3";
+  const currentVersion = "1.6.1";
   if (currentVersion.includes("-")) {
     warn(options.logging, null, msg.prerelease({ currentVersion }));
   }

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

@@ -0,0 +1,15 @@
+export declare enum AstroErrorCodes {
+    StaticRedirectNotAllowed = 2005,
+    UnavailableInSSR = 2006,
+    GenericRuntimeError = 3000,
+    CssSyntaxError = 4000,
+    CssUnknownError = 4001,
+    FailedToLoadModuleSSR = 5000,
+    ConfigError = 6000,
+    GenericMarkdownError = 7000,
+    MarkdownFrontmatterParseError = 7001,
+    UnknownCompilerError = 9000,
+    UnknownCompilerCSSError = 9001,
+    UnknownViteSSRError = 9002,
+    UnknownError = 9999
+}

package/dist/core/errors/codes.js

@@ -0,0 +1,19 @@
+var AstroErrorCodes = /* @__PURE__ */ ((AstroErrorCodes2) => {
+  AstroErrorCodes2[AstroErrorCodes2["StaticRedirectNotAllowed"] = 2005] = "StaticRedirectNotAllowed";
+  AstroErrorCodes2[AstroErrorCodes2["UnavailableInSSR"] = 2006] = "UnavailableInSSR";
+  AstroErrorCodes2[AstroErrorCodes2["GenericRuntimeError"] = 3e3] = "GenericRuntimeError";
+  AstroErrorCodes2[AstroErrorCodes2["CssSyntaxError"] = 4e3] = "CssSyntaxError";
+  AstroErrorCodes2[AstroErrorCodes2["CssUnknownError"] = 4001] = "CssUnknownError";
+  AstroErrorCodes2[AstroErrorCodes2["FailedToLoadModuleSSR"] = 5e3] = "FailedToLoadModuleSSR";
+  AstroErrorCodes2[AstroErrorCodes2["ConfigError"] = 6e3] = "ConfigError";
+  AstroErrorCodes2[AstroErrorCodes2["GenericMarkdownError"] = 7e3] = "GenericMarkdownError";
+  AstroErrorCodes2[AstroErrorCodes2["MarkdownFrontmatterParseError"] = 7001] = "MarkdownFrontmatterParseError";
+  AstroErrorCodes2[AstroErrorCodes2["UnknownCompilerError"] = 9e3] = "UnknownCompilerError";
+  AstroErrorCodes2[AstroErrorCodes2["UnknownCompilerCSSError"] = 9001] = "UnknownCompilerCSSError";
+  AstroErrorCodes2[AstroErrorCodes2["UnknownViteSSRError"] = 9002] = "UnknownViteSSRError";
+  AstroErrorCodes2[AstroErrorCodes2["UnknownError"] = 9999] = "UnknownError";
+  return AstroErrorCodes2;
+})(AstroErrorCodes || {});
+export {
+  AstroErrorCodes
+};

package/dist/core/errors/dev/index.d.ts

@@ -0,0 +1,2 @@
+export { collectErrorMetadata } from './utils.js';
+export { createCustomViteLogger, enhanceViteSSRError, getViteErrorPayload } from './vite.js';

package/dist/core/errors/dev/index.js

@@ -0,0 +1,8 @@
+import { collectErrorMetadata } from "./utils.js";
+import { createCustomViteLogger, enhanceViteSSRError, getViteErrorPayload } from "./vite.js";
+export {
+  collectErrorMetadata,
+  createCustomViteLogger,
+  enhanceViteSSRError,
+  getViteErrorPayload
+};

package/dist/core/errors/dev/utils.d.ts

@@ -0,0 +1,10 @@
+import { ErrorWithMetadata } from '../errors.js';
+export declare const incompatiblePackages: {
+    'react-spectrum': string;
+};
+export declare const incompatPackageExp: RegExp;
+/**
+ * Takes any error-like object and returns a standardized Error + metadata object.
+ * Useful for consistent reporting regardless of where the error surfaced from.
+ */
+export declare function collectErrorMetadata(e: any, filePath?: URL): ErrorWithMetadata;

package/dist/core/errors/dev/utils.js

@@ -0,0 +1,69 @@
+import * as fs from "node:fs";
+import { AggregateError } from "../errors.js";
+import { codeFrame } from "../printer.js";
+import { collectInfoFromStacktrace } from "../utils.js";
+const incompatiblePackages = {
+  "react-spectrum": `@adobe/react-spectrum is not compatible with Vite's server-side rendering mode at the moment. You can still use React Spectrum from the client. Create an island React component and use the client:only directive. From there you can use React Spectrum.`
+};
+const incompatPackageExp = new RegExp(`(${Object.keys(incompatiblePackages).join("|")})`);
+function collectErrorMetadata(e, filePath) {
+  const err = AggregateError.is(e) ? e.errors : [e];
+  err.forEach((error) => {
+    if (error.stack) {
+      error = collectInfoFromStacktrace(e);
+    }
+    if (!error.frame && error.loc) {
+      try {
+        const fileContents = fs.readFileSync(error.loc.file, "utf8");
+        const frame = codeFrame(fileContents, error.loc);
+        error.frame = frame;
+      } catch {
+      }
+    }
+    if (!error.hint) {
+      error.hint = generateHint(e, filePath);
+    }
+  });
+  if (!AggregateError.is(e) && Array.isArray(e.errors)) {
+    e.errors.forEach((buildError, i) => {
+      const { location, pluginName } = buildError;
+      if (location) {
+        err[i].loc = { file: location.file, line: location.line, column: location.column };
+        err[i].id = err[0].id || (location == null ? void 0 : location.file);
+      }
+      const possibleFilePath = err[i].pluginCode || err[i].id || (location == null ? void 0 : location.file);
+      if (possibleFilePath && !err[i].frame) {
+        try {
+          const fileContents = fs.readFileSync(possibleFilePath, "utf8");
+          err[i].frame = codeFrame(fileContents, { ...err[i].loc, file: possibleFilePath });
+        } catch {
+        }
+      }
+      if (pluginName) {
+        err[i].plugin = pluginName;
+      }
+      err[i].hint = generateHint(err[0], filePath);
+    });
+  }
+  return err[0];
+}
+function generateHint(err, filePath) {
+  var _a, _b;
+  if (/Unknown file extension \"\.(jsx|vue|svelte|astro|css)\" for /.test(err.message)) {
+    return "You likely need to add this package to `vite.ssr.noExternal` in your astro config file.";
+  } else if (err.toString().startsWith("ReferenceError") && ((_b = ((_a = err.loc) == null ? void 0 : _a.file) ?? (filePath == null ? void 0 : filePath.pathname)) == null ? void 0 : _b.endsWith(".astro"))) {
+    return "export statements in `.astro` files do not have access to local variable declarations, only imported values.";
+  } else {
+    const res = incompatPackageExp.exec(err.stack);
+    if (res) {
+      const key = res[0];
+      return incompatiblePackages[key];
+    }
+  }
+  return void 0;
+}
+export {
+  collectErrorMetadata,
+  incompatPackageExp,
+  incompatiblePackages
+};

package/dist/core/errors/dev/vite.d.ts

@@ -0,0 +1,11 @@
+import { type ErrorPayload, type Logger, type LogLevel, type ViteDevServer } from 'vite';
+import { AstroError, type ErrorWithMetadata } from '../errors.js';
+/**
+ * Custom logger with better error reporting for incompatible packages
+ */
+export declare function createCustomViteLogger(logLevel: LogLevel): Logger;
+export declare function enhanceViteSSRError(error: Error, filePath?: URL, viteServer?: ViteDevServer): AstroError;
+/**
+ * Generate a payload for Vite's error overlay
+ */
+export declare function getViteErrorPayload(err: ErrorWithMetadata): ErrorPayload;