astro 2.1.3 → 2.1.5

package/dist/core/config/schema.d.ts

@@ -73,11 +73,11 @@ export declare const AstroConfigSchema: z.ZodObject<{
         port: number;
     }, unknown>;
     image: z.ZodDefault<z.ZodObject<{
-        service: z.ZodUnion<[z.ZodLiteral<"astro/assets/services/sharp">, z.ZodLiteral<"astro/assets/services/squoosh">, z.ZodIntersection<z.ZodString, z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>]>;
+        service: z.ZodUnion<[z.ZodLiteral<"astro/assets/services/sharp">, z.ZodLiteral<"astro/assets/services/squoosh">, z.ZodString]>;
     }, "strip", z.ZodTypeAny, {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     }, {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     }>>;
     markdown: z.ZodDefault<z.ZodObject<{
         drafts: z.ZodDefault<z.ZodBoolean>;
@@ -95,8 +95,8 @@ export declare const AstroConfigSchema: z.ZodObject<{
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         }>>;
-        remarkPlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RemarkPlugin<any[]>, z.ZodTypeDef, RemarkPlugin<any[]>>, z.ZodTuple<[z.ZodType<RemarkPlugin<any[]>, z.ZodTypeDef, RemarkPlugin<any[]>>, z.ZodAny], null>]>, "many">>;
-        rehypePlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RehypePlugin<any[]>, z.ZodTypeDef, RehypePlugin<any[]>>, z.ZodTuple<[z.ZodType<RehypePlugin<any[]>, z.ZodTypeDef, RehypePlugin<any[]>>, z.ZodAny], null>]>, "many">>;
+        remarkPlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RemarkPlugin, z.ZodTypeDef, RemarkPlugin>, z.ZodTuple<[z.ZodType<RemarkPlugin, z.ZodTypeDef, RemarkPlugin>, z.ZodAny], null>]>, "many">>;
+        rehypePlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RehypePlugin, z.ZodTypeDef, RehypePlugin>, z.ZodTuple<[z.ZodType<RehypePlugin, z.ZodTypeDef, RehypePlugin>, z.ZodAny], null>]>, "many">>;
         remarkRehype: z.ZodDefault<z.ZodOptional<z.ZodType<RemarkRehype, z.ZodTypeDef, RemarkRehype>>>;
         gfm: z.ZodDefault<z.ZodBoolean>;
         smartypants: z.ZodDefault<z.ZodBoolean>;
@@ -108,8 +108,8 @@ export declare const AstroConfigSchema: z.ZodObject<{
             theme: string | import("shiki").IShikiTheme;
             wrap: boolean | null;
         };
-        remarkPlugins: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[];
-        rehypePlugins: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[];
+        remarkPlugins: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[];
+        rehypePlugins: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[];
         remarkRehype: RemarkRehype;
         gfm: boolean;
         smartypants: boolean;
@@ -121,8 +121,8 @@ export declare const AstroConfigSchema: z.ZodObject<{
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         } | undefined;
-        remarkPlugins?: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[] | undefined;
-        rehypePlugins?: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[] | undefined;
+        remarkPlugins?: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[] | undefined;
+        rehypePlugins?: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[] | undefined;
         remarkRehype?: RemarkRehype | undefined;
         gfm?: boolean | undefined;
         smartypants?: boolean | undefined;
@@ -151,8 +151,8 @@ export declare const AstroConfigSchema: z.ZodObject<{
             theme: string | import("shiki").IShikiTheme;
             wrap: boolean | null;
         };
-        remarkPlugins: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[];
-        rehypePlugins: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[];
+        remarkPlugins: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[];
+        rehypePlugins: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[];
         remarkRehype: RemarkRehype;
         gfm: boolean;
         smartypants: boolean;
@@ -180,7 +180,7 @@ export declare const AstroConfigSchema: z.ZodObject<{
         serverEntry: string;
     };
     image: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     };
     vite: ViteUserConfig;
     experimental: {
@@ -198,8 +198,8 @@ export declare const AstroConfigSchema: z.ZodObject<{
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         } | undefined;
-        remarkPlugins?: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[] | undefined;
-        rehypePlugins?: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[] | undefined;
+        remarkPlugins?: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[] | undefined;
+        rehypePlugins?: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[] | undefined;
         remarkRehype?: RemarkRehype | undefined;
         gfm?: boolean | undefined;
         smartypants?: boolean | undefined;
@@ -224,7 +224,7 @@ export declare const AstroConfigSchema: z.ZodObject<{
         serverEntry?: string | undefined;
     } | undefined;
     image?: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     } | undefined;
     vite?: ViteUserConfig | undefined;
     experimental?: {
@@ -251,8 +251,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         }>>;
-        remarkPlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RemarkPlugin<any[]>, z.ZodTypeDef, RemarkPlugin<any[]>>, z.ZodTuple<[z.ZodType<RemarkPlugin<any[]>, z.ZodTypeDef, RemarkPlugin<any[]>>, z.ZodAny], null>]>, "many">>;
-        rehypePlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RehypePlugin<any[]>, z.ZodTypeDef, RehypePlugin<any[]>>, z.ZodTuple<[z.ZodType<RehypePlugin<any[]>, z.ZodTypeDef, RehypePlugin<any[]>>, z.ZodAny], null>]>, "many">>;
+        remarkPlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RemarkPlugin, z.ZodTypeDef, RemarkPlugin>, z.ZodTuple<[z.ZodType<RemarkPlugin, z.ZodTypeDef, RemarkPlugin>, z.ZodAny], null>]>, "many">>;
+        rehypePlugins: z.ZodDefault<z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodTuple<[z.ZodString, z.ZodAny], null>, z.ZodType<RehypePlugin, z.ZodTypeDef, RehypePlugin>, z.ZodTuple<[z.ZodType<RehypePlugin, z.ZodTypeDef, RehypePlugin>, z.ZodAny], null>]>, "many">>;
         remarkRehype: z.ZodDefault<z.ZodOptional<z.ZodType<RemarkRehype, z.ZodTypeDef, RemarkRehype>>>;
         gfm: z.ZodDefault<z.ZodBoolean>;
         smartypants: z.ZodDefault<z.ZodBoolean>;
@@ -264,8 +264,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme: string | import("shiki").IShikiTheme;
             wrap: boolean | null;
         };
-        remarkPlugins: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[];
-        rehypePlugins: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[];
+        remarkPlugins: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[];
+        rehypePlugins: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[];
         remarkRehype: RemarkRehype;
         gfm: boolean;
         smartypants: boolean;
@@ -277,8 +277,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         } | undefined;
-        remarkPlugins?: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[] | undefined;
-        rehypePlugins?: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[] | undefined;
+        remarkPlugins?: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[] | undefined;
+        rehypePlugins?: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[] | undefined;
         remarkRehype?: RemarkRehype | undefined;
         gfm?: boolean | undefined;
         smartypants?: boolean | undefined;
@@ -309,11 +309,11 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
         hooks: {};
     }[], unknown>;
     image: z.ZodDefault<z.ZodObject<{
-        service: z.ZodUnion<[z.ZodLiteral<"astro/assets/services/sharp">, z.ZodLiteral<"astro/assets/services/squoosh">, z.ZodIntersection<z.ZodString, z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>>]>;
+        service: z.ZodUnion<[z.ZodLiteral<"astro/assets/services/sharp">, z.ZodLiteral<"astro/assets/services/squoosh">, z.ZodString]>;
     }, "strip", z.ZodTypeAny, {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     }, {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     }>>;
     vite: z.ZodDefault<z.ZodType<ViteUserConfig, z.ZodTypeDef, ViteUserConfig>>;
     experimental: z.ZodDefault<z.ZodOptional<z.ZodObject<{
@@ -383,8 +383,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme: string | import("shiki").IShikiTheme;
             wrap: boolean | null;
         };
-        remarkPlugins: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[];
-        rehypePlugins: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[];
+        remarkPlugins: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[];
+        rehypePlugins: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[];
         remarkRehype: RemarkRehype;
         gfm: boolean;
         smartypants: boolean;
@@ -413,7 +413,7 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
         serverEntry: string;
     };
     image: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     };
     vite: ViteUserConfig;
     experimental: {
@@ -431,8 +431,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         } | undefined;
-        remarkPlugins?: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[] | undefined;
-        rehypePlugins?: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[] | undefined;
+        remarkPlugins?: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[] | undefined;
+        rehypePlugins?: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[] | undefined;
         remarkRehype?: RemarkRehype | undefined;
         gfm?: boolean | undefined;
         smartypants?: boolean | undefined;
@@ -457,7 +457,7 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
         serverEntry?: string | undefined;
     } | undefined;
     image?: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     } | undefined;
     vite?: ViteUserConfig | undefined;
     experimental?: {
@@ -479,8 +479,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme: string | import("shiki").IShikiTheme;
             wrap: boolean | null;
         };
-        remarkPlugins: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[];
-        rehypePlugins: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[];
+        remarkPlugins: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[];
+        rehypePlugins: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[];
         remarkRehype: RemarkRehype;
         gfm: boolean;
         smartypants: boolean;
@@ -509,7 +509,7 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
         serverEntry: string;
     };
     image: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     };
     vite: ViteUserConfig;
     experimental: {
@@ -527,8 +527,8 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
             theme?: string | import("shiki").IShikiTheme | undefined;
             wrap?: boolean | null | undefined;
         } | undefined;
-        remarkPlugins?: (string | [string, any] | RemarkPlugin<any[]> | [RemarkPlugin<any[]>, any])[] | undefined;
-        rehypePlugins?: (string | [string, any] | RehypePlugin<any[]> | [RehypePlugin<any[]>, any])[] | undefined;
+        remarkPlugins?: (string | [string, any] | RemarkPlugin | [RemarkPlugin, any])[] | undefined;
+        rehypePlugins?: (string | [string, any] | RehypePlugin | [RehypePlugin, any])[] | undefined;
         remarkRehype?: RemarkRehype | undefined;
         gfm?: boolean | undefined;
         smartypants?: boolean | undefined;
@@ -553,7 +553,7 @@ export declare function createRelativeSchema(cmd: string, fileProtocolRoot: URL)
         serverEntry?: string | undefined;
     } | undefined;
     image?: {
-        service: "astro/assets/services/sharp" | "astro/assets/services/squoosh" | (string & {});
+        service: string;
     } | undefined;
     vite?: ViteUserConfig | undefined;
     experimental?: {

package/dist/core/config/schema.js

@@ -43,7 +43,9 @@ const AstroConfigSchema = z.object({
   output: z.union([z.literal("static"), z.literal("server")]).optional().default("static"),
   adapter: z.object({ name: z.string(), hooks: z.object({}).passthrough().default({}) }).optional(),
   integrations: z.preprocess(
+    // preprocess
     (val) => Array.isArray(val) ? val.flat(Infinity).filter(Boolean) : val,
+    // validate
     z.array(z.object({ name: z.string(), hooks: z.object({}).passthrough().default({}) })).default(ASTRO_CONFIG_DEFAULTS.integrations)
   ),
   build: z.object({
@@ -54,7 +56,11 @@ const AstroConfigSchema = z.object({
     serverEntry: z.string().optional().default(ASTRO_CONFIG_DEFAULTS.build.serverEntry)
   }).optional().default({}),
   server: z.preprocess(
+    // preprocess
+    // NOTE: Uses the "error" command here because this is overwritten by the
+    // individualized schema parser with the correct command.
     (val) => typeof val === "function" ? val({ command: "error" }) : val,
+    // validate
     z.object({
       host: z.union([z.string(), z.boolean()]).optional().default(ASTRO_CONFIG_DEFAULTS.server.host),
       port: z.number().optional().default(ASTRO_CONFIG_DEFAULTS.server.port),
@@ -65,7 +71,7 @@ const AstroConfigSchema = z.object({
     service: z.union([
       z.literal("astro/assets/services/sharp"),
       z.literal("astro/assets/services/squoosh"),
-      z.string().and(z.object({}))
+      z.string()
     ])
   }).default({
     service: "astro/assets/services/squoosh"
@@ -114,6 +120,7 @@ function createRelativeSchema(cmd, fileProtocolRoot) {
       serverEntry: z.string().optional().default(ASTRO_CONFIG_DEFAULTS.build.serverEntry)
     }).optional().default({}),
     server: z.preprocess(
+      // preprocess
       (val) => {
         if (typeof val === "function") {
           const result = val({ command: cmd === "dev" ? "dev" : "preview" });
@@ -126,6 +133,7 @@ function createRelativeSchema(cmd, fileProtocolRoot) {
           return val;
         }
       },
+      // validate
       z.object({
         host: z.union([z.string(), z.boolean()]).optional().default(ASTRO_CONFIG_DEFAULTS.server.host),
         port: z.number().optional().default(ASTRO_CONFIG_DEFAULTS.server.port),

package/dist/core/config/timer.js

@@ -5,6 +5,9 @@ class AstroTimer {
     this.stats = {};
     this.enabled = !!process.env.ASTRO_TIMER_PATH;
   }
+  /**
+   * Start a timer for a scope with a given name.
+   */
   start(name) {
     var _a;
     if (!this.enabled)
@@ -15,6 +18,9 @@ class AstroTimer {
       startHeap: process.memoryUsage().heapUsed
     });
   }
+  /**
+   * End a timer for a scope with a given name.
+   */
   end(name) {
     var _a;
     if (!this.enabled)
@@ -31,6 +37,9 @@ class AstroTimer {
     };
     this.ongoingTimers.delete(name);
   }
+  /**
+   * Write stats to `process.env.ASTRO_TIMER_PATH`
+   */
   writeStats() {
     if (!this.enabled)
       return;

package/dist/core/config/tsconfig.js

@@ -6,6 +6,7 @@ const defaultTSConfig = { extends: "astro/tsconfigs/base" };
 const presets = /* @__PURE__ */ new Map([
   [
     "vue",
+    // Settings needed for template intellisense when using Volar
     {
       compilerOptions: {
         jsx: "preserve"
@@ -14,6 +15,7 @@ const presets = /* @__PURE__ */ new Map([
   ],
   [
     "react",
+    // Default TypeScript settings, but we need to redefine them in case the users changed them previously
     {
       compilerOptions: {
         jsx: "react-jsx",
@@ -23,6 +25,7 @@ const presets = /* @__PURE__ */ new Map([
   ],
   [
     "preact",
+    // https://preactjs.com/guide/v10/typescript/#typescript-configuration
     {
       compilerOptions: {
         jsx: "react-jsx",
@@ -32,6 +35,7 @@ const presets = /* @__PURE__ */ new Map([
   ],
   [
     "solid-js",
+    // https://www.solidjs.com/guides/typescript#configuring-typescript
     {
       compilerOptions: {
         jsx: "preserve",

package/dist/core/config/vite-load.js

@@ -8,6 +8,9 @@ async function createViteLoader(root, fs) {
     clearScreen: false,
     appType: "custom",
     ssr: {
+      // NOTE: Vite doesn't externalize linked packages by default. During testing locally,
+      // these dependencies trip up Vite's dev SSR transform. Awaiting upstream feature:
+      // https://github.com/vitejs/vite/pull/10939
       external: [
         "@astrojs/tailwind",
         "@astrojs/mdx",

package/dist/core/constants.js

@@ -1,4 +1,4 @@
-const ASTRO_VERSION = "2.1.3";
+const ASTRO_VERSION = "2.1.5";
 const SUPPORTED_MARKDOWN_FILE_EXTENSIONS = [
   ".markdown",
   ".mdown",

package/dist/core/cookies/cookies.js

@@ -1,5 +1,5 @@
 import { parse, serialize } from "cookie";
-const DELETED_EXPIRATION = new Date(0);
+const DELETED_EXPIRATION = /* @__PURE__ */ new Date(0);
 const DELETED_VALUE = "deleted";
 class AstroCookie {
   constructor(value) {
@@ -31,6 +31,12 @@ class AstroCookies {
     this.#requestValues = null;
     this.#outgoing = null;
   }
+  /**
+   * Astro.cookies.delete(key) is used to delete a cookie. Using this method will result
+   * in a Set-Cookie header added to the response.
+   * @param key The cookie to delete
+   * @param options Options related to this deletion, such as the path of the cookie.
+   */
   delete(key, options) {
     const serializeOptions = {
       expires: DELETED_EXPIRATION
@@ -47,6 +53,13 @@ class AstroCookies {
       false
     ]);
   }
+  /**
+   * Astro.cookies.get(key) is used to get a cookie value. The cookie value is read from the
+   * request. If you have set a cookie via Astro.cookies.set(key, value), the value will be taken
+   * from that set call, overriding any values already part of the request.
+   * @param key The cookie to get.
+   * @returns An object containing the cookie value as well as convenience methods for converting its value.
+   */
   get(key) {
     if (this.#outgoing !== null && this.#outgoing.has(key)) {
       let [serializedValue, , isSetValue] = this.#outgoing.get(key);
@@ -60,6 +73,12 @@ class AstroCookies {
     const value = values[key];
     return new AstroCookie(value);
   }
+  /**
+   * Astro.cookies.has(key) returns a boolean indicating whether this cookie is either
+   * part of the initial request or set via Astro.cookies.set(key)
+   * @param key The cookie to check for.
+   * @returns
+   */
   has(key) {
     if (this.#outgoing !== null && this.#outgoing.has(key)) {
       let [, , isSetValue] = this.#outgoing.get(key);
@@ -68,6 +87,15 @@ class AstroCookies {
     const values = this.#ensureParsed();
     return !!values[key];
   }
+  /**
+   * Astro.cookies.set(key, value) is used to set a cookie's value. If provided
+   * an object it will be stringified via JSON.stringify(value). Additionally you
+   * can provide options customizing how this cookie will be set, such as setting httpOnly
+   * in order to prevent the cookie from being read in client-side JavaScript.
+   * @param key The name of the cookie to set.
+   * @param value A value, either a string or other primitive or an object.
+   * @param options Options for the cookie, such as the path and security settings.
+   */
   set(key, value, options) {
     let serializedValue;
     if (typeof value === "string") {
@@ -90,6 +118,12 @@ class AstroCookies {
       true
     ]);
   }
+  /**
+   * Astro.cookies.header() returns an iterator for the cookies that have previously
+   * been set by either Astro.cookies.set() or Astro.cookies.delete().
+   * This method is primarily used by adapters to set the header on outgoing responses.
+   * @returns
+   */
   *headers() {
     if (this.#outgoing == null)
       return;

package/dist/core/create-vite.js

@@ -25,13 +25,20 @@ import astroScriptsPlugin from "../vite-plugin-scripts/index.js";
 import astroScriptsPageSSRPlugin from "../vite-plugin-scripts/page-ssr.js";
 import { vitePluginSSRManifest } from "../vite-plugin-ssr-manifest/index.js";
 const ALWAYS_NOEXTERNAL = [
+  // This is only because Vite's native ESM doesn't resolve "exports" correctly.
   "astro",
+  // Vite fails on nested `.astro` imports without bundling
   "astro/components",
+  // Handle recommended nanostores. Only @nanostores/preact is required from our testing!
+  // Full explanation and related bug report: https://github.com/withastro/astro/pull/3667
   "@nanostores/preact",
+  // fontsource packages are CSS that need to be processed
   "@fontsource/*"
 ];
 const ONLY_DEV_EXTERNAL = [
+  // Imported by `<Code/>` which is processed by Vite
   "shiki",
+  // Imported by `@astrojs/prism` which exposes `<Prism/>` that is processed by Vite
   "prismjs/components/index.js"
 ];
 async function createVite(commandConfig, { settings, logging, mode, command, fs = nodeFs }) {
@@ -45,7 +52,12 @@ async function createVite(commandConfig, { settings, logging, mode, command, fs
       if (((_a2 = pkgJson == null ? void 0 : pkgJson.astro) == null ? void 0 : _a2.external) === true) {
         return false;
       }
-      return ((_b2 = pkgJson.peerDependencies) == null ? void 0 : _b2.astro) || ((_c = pkgJson.dependencies) == null ? void 0 : _c.astro) || ((_d = pkgJson.keywords) == null ? void 0 : _d.includes("astro")) || ((_e = pkgJson.keywords) == null ? void 0 : _e.includes("astro-component")) || /^(@[^\/]+\/)?astro\-/.test(pkgJson.name);
+      return (
+        // Attempt: package relies on `astro`. ✅ Definitely an Astro package
+        ((_b2 = pkgJson.peerDependencies) == null ? void 0 : _b2.astro) || ((_c = pkgJson.dependencies) == null ? void 0 : _c.astro) || // Attempt: package is tagged with `astro` or `astro-component`. ✅ Likely a community package
+        ((_d = pkgJson.keywords) == null ? void 0 : _d.includes("astro")) || ((_e = pkgJson.keywords) == null ? void 0 : _e.includes("astro-component")) || // Attempt: package is named `astro-something` or `@scope/astro-something`. ✅ Likely a community package
+        /^(@[^\/]+\/)?astro\-/.test(pkgJson.name)
+      );
     },
     isFrameworkPkgByName(pkgName) {
       const isNotAstroPkg = isCommonNotAstro(pkgName);
@@ -58,8 +70,11 @@ async function createVite(commandConfig, { settings, logging, mode, command, fs
   });
   const commonConfig = {
     cacheDir: fileURLToPath(new URL("./node_modules/.vite/", settings.config.root)),
+    // using local caches allows Astro to be used in monorepos, etc.
     clearScreen: false,
+    // we want to control the output, not Vite
     logLevel: "warn",
+    // log warnings and errors only
     appType: "custom",
     optimizeDeps: {
       entries: ["src/**/*"],
@@ -70,6 +85,8 @@ async function createVite(commandConfig, { settings, logging, mode, command, fs
       astroLoadFallbackPlugin({ fs, root: settings.config.root }),
       astroVitePlugin({ settings, logging }),
       astroScriptsPlugin({ settings }),
+      // The server plugin is for dev only and having it run during the build causes
+      // the build to run very slow as the filewatcher is triggered often.
       mode !== "build" && vitePluginAstroServer({ settings, logging, fs }),
       envVitePlugin({ settings }),
       markdownVitePlugin({ settings, logging }),
@@ -95,23 +112,32 @@ async function createVite(commandConfig, { settings, logging, mode, command, fs
     },
     server: {
       hmr: process.env.NODE_ENV === "test" || process.env.NODE_ENV === "production" ? false : void 0,
-      proxy: {},
+      // disable HMR for test
+      // handle Vite URLs
+      proxy: {
+        // add proxies here
+      },
       watch: {
+        // Prevent watching during the build to speed it up
         ignored: mode === "build" ? ["**"] : void 0
       }
     },
     resolve: {
       alias: [
         {
+          // This is needed for Deno compatibility, as the non-browser version
+          // of this module depends on Node `crypto`
           find: "randombytes",
           replacement: "randombytes/browser"
         },
         {
+          // Typings are imported from 'astro' (e.g. import { Type } from 'astro')
           find: /^astro$/,
           replacement: fileURLToPath(new URL("../@types/astro", import.meta.url))
         }
       ],
       conditions: ["astro"],
+      // Astro imports in third-party packages should use the same version as root
       dedupe: ["astro"]
     },
     ssr: {
@@ -125,7 +151,7 @@ async function createVite(commandConfig, { settings, logging, mode, command, fs
     const applyToFilter = command === "build" ? "serve" : "build";
     const applyArgs = [
       { ...settings.config.vite, mode },
-      { command, mode }
+      { command: command === "dev" ? "serve" : command, mode }
     ];
     plugins = plugins.flat(Infinity).filter((p) => {
       if (!p || (p == null ? void 0 : p.apply) === applyToFilter) {
@@ -206,6 +232,7 @@ const COMMON_PREFIXES_NOT_ASTRO = [
 function isCommonNotAstro(dep) {
   return COMMON_DEPENDENCIES_NOT_ASTRO.includes(dep) || COMMON_PREFIXES_NOT_ASTRO.some(
     (prefix) => prefix.startsWith("@") ? dep.startsWith(prefix) : dep.substring(dep.lastIndexOf("/") + 1).startsWith(prefix)
+    // check prefix omitting @scope/
   );
 }
 export {

package/dist/core/dev/container.js

@@ -65,6 +65,7 @@ async function createContainer(params = {}) {
     handle(req, res) {
       viteServer.middlewares.handle(req, res, Function.prototype);
     },
+    // TODO deprecate and remove
     close() {
       return closeContainer(container);
     }

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

@@ -6,7 +6,7 @@ import type { AddressInfo } from 'net';
 import type * as vite from 'vite';
 import type yargs from 'yargs-parser';
 import type { AstroSettings } from '../../@types/astro';
-import { LogOptions } from '../logger/core.js';
+import { type LogOptions } from '../logger/core.js';
 export interface DevOptions {
     configFlag: string | undefined;
     configFlagPath: string | undefined;

package/dist/core/dev/dev.js

@@ -31,6 +31,7 @@ async function dev(settings, options) {
   const restart = await createContainerWithAutomaticRestart({
     flags: options.flags ?? {},
     handleConfigError: options.handleConfigError,
+    // eslint-disable-next-line no-console
     beforeRestart: () => console.clear(),
     params: {
       settings,
@@ -51,7 +52,7 @@ async function dev(settings, options) {
       isRestart: options.isRestart
     })
   );
-  const currentVersion = "2.1.3";
+  const currentVersion = "2.1.5";
   if (currentVersion.includes("-")) {
     warn(options.logging, null, msg.prerelease({ currentVersion }));
   }

package/dist/core/endpoint/index.d.ts

@@ -2,7 +2,7 @@
 import type { AstroConfig, EndpointHandler } from '../../@types/astro';
 import type { Environment, RenderContext } from '../render/index';
 import { AstroCookies } from '../cookies/index.js';
-import { LogOptions } from '../logger/core.js';
+import { type LogOptions } from '../logger/core.js';
 type EndpointCallResult = {
     type: 'simple';
     body: string;

package/dist/core/endpoint/index.js

@@ -28,6 +28,7 @@ function createAPIContext({
       });
     },
     url: new URL(request.url),
+    // @ts-expect-error
     get clientAddress() {
       if (!(clientAddressSymbol in request)) {
         if (adapterName) {

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

@@ -1,4 +1,4 @@
-import { ErrorWithMetadata } from '../errors.js';
+import { type ErrorWithMetadata } from '../errors.js';
 /**
  * Takes any error-like object and returns a standardized Error + metadata object.
  * Useful for consistent reporting regardless of where the error surfaced from.

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

@@ -92,7 +92,8 @@ function collectInfoFromStacktrace(error) {
   error.stack = normalizeLF(error.stack);
   const stackText = stripAnsi(error.stack);
   if (!error.loc || !error.loc.column && !error.loc.line) {
-    const possibleFilePath = ((_a = error.loc) == null ? void 0 : _a.file) || error.pluginCode || error.id || stackText.split("\n").find((ln) => ln.includes("src") || ln.includes("node_modules"));
+    const possibleFilePath = ((_a = error.loc) == null ? void 0 : _a.file) || error.pluginCode || error.id || // TODO: this could be better, `src` might be something else
+    stackText.split("\n").find((ln) => ln.includes("src") || ln.includes("node_modules"));
     const source = possibleFilePath == null ? void 0 : possibleFilePath.replace(/^[^(]+\(([^)]+).*$/, "$1").replace(/^\s+at\s+/, "");
     let file = source == null ? void 0 : source.replace(/(:[0-9]+)/g, "");
     const location = /:([0-9]+):([0-9]+)/g.exec(source) ?? [];

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

@@ -1,6 +1,6 @@
 import type { ErrorPayload } from 'vite';
 import type { ModuleLoader } from '../../module-loader/index.js';
-import { ErrorWithMetadata } from '../errors.js';
+import { type ErrorWithMetadata } from '../errors.js';
 import type { SSRLoadedRenderer } from './../../../@types/astro.js';
 export declare function enhanceViteSSRError({ error, filePath, loader, renderers, }: {
     error: unknown;

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

@@ -72,6 +72,7 @@ function enhanceViteSSRError({
   return safeError;
 }
 const ALTERNATIVE_JS_EXTS = ["cjs", "mjs"];
+const ALTERNATIVE_MD_EXTS = ["mdoc"];
 async function getViteErrorPayload(err) {
   var _a, _b, _c, _d, _e, _f;
   let plugin = err.plugin;
@@ -83,6 +84,7 @@ async function getViteErrorPayload(err) {
   const hasDocs = err.type && err.name && [
     "AstroError",
     "AggregateError",
+    /* 'CompilerError' ,*/
     "CSSError",
     "MarkdownError"
   ] || ["FailedToLoadModuleSSR", "InvalidGlob"].includes(err.name);
@@ -92,6 +94,9 @@ async function getViteErrorPayload(err) {
   if (ALTERNATIVE_JS_EXTS.includes(highlighterLang ?? "")) {
     highlighterLang = "js";
   }
+  if (ALTERNATIVE_MD_EXTS.includes(highlighterLang ?? "")) {
+    highlighterLang = "md";
+  }
   const highlightedCode = err.fullCode ? highlighter.codeToHtml(err.fullCode, {
     lang: highlighterLang,
     lineOptions: ((_c = err.loc) == null ? void 0 : _c.line) ? [{ line: err.loc.line, classes: ["error-line"] }] : void 0