@reckona/mreact-router 0.0.119 → 0.0.121

package/src/build.ts

@@ -39,9 +39,7 @@ import {
 } from "./module-runner.js";
 import { scanAppRoutes } from "./routes.js";
 import type { AppRoute } from "./routes.js";
-import {
-  appFileConventionForRootFilename,
-} from "./file-conventions.js";
+import { appFileConventionForRootFilename } from "./file-conventions.js";
 import {
   resolveAppRouterProjectOptions,
   resolveBuildTargets,
@@ -98,7 +96,7 @@ export interface BuildAppOptions extends AppRouterProjectOptions {
   onBuildPhaseTiming?: ((timing: BuildAppPhaseTiming) => void) | undefined;
   outDir: string;
   targets?: readonly AppRouterBuildTarget[] | undefined;
-  viteConfig?: Pick<UserConfig, "plugins"> | undefined;
+  viteConfig?: Pick<UserConfig, "define" | "plugins"> | undefined;
 }
 
 export type BuildAppPhase =
@@ -210,6 +208,7 @@ export interface BuiltRouteSourceAnalysisSummary {
   authIncludesClaims: boolean;
   cachePolicy?: RouteCachePolicy | undefined;
   clientBoundaryImports: readonly string[];
+  clientBoundaryFallbackImports: readonly string[];
   clientRoute: boolean;
   hasLoader: boolean;
   routeCode: string;
@@ -233,6 +232,7 @@ interface BuildSourceAnalysis {
 
 interface BuildRouteSourceAnalysis extends BuildSourceAnalysis {
   clientBoundaryImports: readonly string[];
+  clientBoundaryFallbackImports: readonly string[];
   clientRoute: boolean;
   file: string;
   route: AppRoute & { kind: "page" };
@@ -273,6 +273,7 @@ export async function buildApp(options: BuildAppOptions): Promise<BuildAppResult
       : await timeBuildPhase(timingSink, "scan", () =>
           scanAppRoutes({ appDir: project.routesDir }),
         );
+  const viteDefine = options.viteConfig?.define;
   const vitePlugins = options.viteConfig?.plugins;
   const files =
     timingSink === undefined
@@ -427,7 +428,11 @@ export async function buildApp(options: BuildAppOptions): Promise<BuildAppResult
   }));
   const [serverModuleArtifacts, clientBundle] = await Promise.all([
     timingSink === undefined
-      ? writeServerModuleArtifactFiles(serverDir, serverModules, generatedImportPolicy.runtimePackages)
+      ? writeServerModuleArtifactFiles(
+          serverDir,
+          serverModules,
+          generatedImportPolicy.runtimePackages,
+        )
       : timeBuildPhase(timingSink, "serverModuleArtifacts", () =>
           writeServerModuleArtifactFiles(
             serverDir,
@@ -519,6 +524,7 @@ export async function buildApp(options: BuildAppOptions): Promise<BuildAppResult
       timingSink === undefined
         ? await writeCloudflareRouteModules({
             cloudflareDir,
+            define: viteDefine,
             files,
             prerenderedRoutes,
             projectRoot: project.projectRoot,
@@ -531,6 +537,7 @@ export async function buildApp(options: BuildAppOptions): Promise<BuildAppResult
         : await timeBuildPhase(timingSink, "cloudflare", () =>
             writeCloudflareRouteModules({
               cloudflareDir,
+              define: viteDefine,
               files,
               prerenderedRoutes,
               projectRoot: project.projectRoot,
@@ -740,6 +747,7 @@ async function analyzeBuildRouteSources(options: {
         {
           ...analyzeBuildSource(source, route.file),
           clientBoundaryImports: clientInference.clientBoundaryImports,
+          clientBoundaryFallbackImports: clientInference.clientBoundaryFallbackImports,
           clientRoute: clientInference.client,
           file,
           route,
@@ -1201,7 +1209,11 @@ async function collectRuntimeOptionalPackages(options: {
     { packageName: options.packageName, optional: false, startDir: options.projectRoot },
   ];
 
-  for (let index = 0; index < queue.length && seenPackageJson.size < maxRuntimePackageManifestReads; index += 1) {
+  for (
+    let index = 0;
+    index < queue.length && seenPackageJson.size < maxRuntimePackageManifestReads;
+    index += 1
+  ) {
     const item = queue[index];
     if (item === undefined || !isValidRuntimePackageName(item.packageName)) {
       continue;
@@ -1297,7 +1309,11 @@ async function findRuntimePackageJson(
 }
 
 function isRuntimePackageSpecifier(specifier: string): boolean {
-  if (specifier.startsWith(".") || specifier.startsWith("/") || /^[A-Za-z][A-Za-z0-9+.-]*:/.test(specifier)) {
+  if (
+    specifier.startsWith(".") ||
+    specifier.startsWith("/") ||
+    /^[A-Za-z][A-Za-z0-9+.-]*:/.test(specifier)
+  ) {
     return false;
   }
 
@@ -1425,7 +1441,11 @@ function isSourceModuleFile(file: string): boolean {
 }
 
 function isAppRelativeFile(file: string, relativeRoutesDir: string): boolean {
-  return relativeRoutesDir === "" || file === relativeRoutesDir || file.startsWith(`${relativeRoutesDir}/`);
+  return (
+    relativeRoutesDir === "" ||
+    file === relativeRoutesDir ||
+    file.startsWith(`${relativeRoutesDir}/`)
+  );
 }
 
 function moduleIdForBuildFile(file: string, relativeRoutesDir: string): string {
@@ -1465,10 +1485,7 @@ async function collectPublicAssetPaths(publicDir: string): Promise<string[]> {
   return paths.sort();
 }
 
-async function copyAppFileConventionAssets(
-  appDir: string,
-  outDir: string,
-): Promise<string[]> {
+async function copyAppFileConventionAssets(appDir: string, outDir: string): Promise<string[]> {
   let entries: Dirent[];
   try {
     entries = await readdir(appDir, { withFileTypes: true });
@@ -1493,9 +1510,7 @@ async function copyAppFileConventionAssets(
       continue;
     }
 
-    const outputPath = convention.path.startsWith("/")
-      ? convention.path.slice(1)
-      : convention.path;
+    const outputPath = convention.path.startsWith("/") ? convention.path.slice(1) : convention.path;
     await copyFile(join(appDir, entry.name), join(outDir, outputPath));
     paths.push(convention.path);
   }
@@ -1745,205 +1760,219 @@ async function buildServerModuleArtifacts(options: {
     }
   }
 
-  const requestBatchOutputs = requestBatchEntries.length >= 3
-    ? await bundleRouteRequestModuleBatchCode({
-        appDir: options.project.routesDir,
-        bundleCache: options.bundleCache,
-        cacheDir: options.cacheDir,
-        entries: requestBatchEntries,
-        importPolicy: requestModuleImportPolicy,
-        vitePlugins: options.vitePlugins,
-      })
-    : new Map<string, string>();
-
-  const artifactEntries = await mapWithBuildConcurrency(Object.entries(options.files), async ([file, source]) => {
-    const absoluteFile = join(options.projectRoot, file);
-    const route = routeByFile.get(file);
-    const routeAnalysis = options.sourceAnalysis.byRouteFile.get(file);
-    const artifact: BuiltServerModuleArtifact = {};
+  const requestBatchOutputs =
+    requestBatchEntries.length >= 3
+      ? await bundleRouteRequestModuleBatchCode({
+          appDir: options.project.routesDir,
+          bundleCache: options.bundleCache,
+          cacheDir: options.cacheDir,
+          entries: requestBatchEntries,
+          importPolicy: requestModuleImportPolicy,
+          vitePlugins: options.vitePlugins,
+        })
+      : new Map<string, string>();
 
-    if (
-      requestArtifactFiles.has(file) ||
-      loaderArtifactFiles.has(file) ||
-      metadataArtifactFiles.has(file)
-    ) {
-      if (loaderArtifactFiles.has(file)) {
-        const code = requestBatchOutputs.get(routeRequestArtifactBatchKey(file, "loader")) ??
-          await bundleRouteLoaderModuleCode({
-            appDir: options.project.routesDir,
-            bundleCache: options.bundleCache,
-            cacheDir: options.cacheDir,
-            code: stripRouteLoaderOnlyExports(source, absoluteFile),
-            filename: absoluteFile,
-            importPolicy: requestModuleImportPolicy,
-            vitePlugins: options.vitePlugins,
-          });
-        artifact.loader = {
-          code,
-          sourceHash: hashText(source),
-        };
-      }
+  const artifactEntries = await mapWithBuildConcurrency(
+    Object.entries(options.files),
+    async ([file, source]) => {
+      const absoluteFile = join(options.projectRoot, file);
+      const route = routeByFile.get(file);
+      const routeAnalysis = options.sourceAnalysis.byRouteFile.get(file);
+      const artifact: BuiltServerModuleArtifact = {};
 
-      if (metadataArtifactFiles.has(file)) {
-        const code = requestBatchOutputs.get(routeRequestArtifactBatchKey(file, "metadata")) ??
-          await bundleRouteRequestModuleCode({
-            appDir: options.project.routesDir,
-            bundleCache: options.bundleCache,
-            cacheDir: options.cacheDir,
-            code: stripRouteMetadataOnlyExports(source, absoluteFile),
-            filename: absoluteFile,
-            importPolicy: requestModuleImportPolicy,
-            label: "Metadata",
-            vitePlugins: options.vitePlugins,
-          });
-        artifact.routeMetadata = {
-          code,
-          sourceHash: hashText(source),
-        };
-      }
+      if (
+        requestArtifactFiles.has(file) ||
+        loaderArtifactFiles.has(file) ||
+        metadataArtifactFiles.has(file)
+      ) {
+        if (loaderArtifactFiles.has(file)) {
+          const code =
+            requestBatchOutputs.get(routeRequestArtifactBatchKey(file, "loader")) ??
+            (await bundleRouteLoaderModuleCode({
+              appDir: options.project.routesDir,
+              bundleCache: options.bundleCache,
+              cacheDir: options.cacheDir,
+              code: stripRouteLoaderOnlyExports(source, absoluteFile),
+              filename: absoluteFile,
+              importPolicy: requestModuleImportPolicy,
+              vitePlugins: options.vitePlugins,
+            }));
+          artifact.loader = {
+            code,
+            sourceHash: hashText(source),
+          };
+        }
 
-      if (requestArtifactFiles.has(file)) {
-        const batchedRequestCode = requestBatchOutputs.get(
-          routeRequestArtifactBatchKey(file, "request"),
-        );
-        artifact.request = {
-          code: batchedRequestCode ??
-            await buildRequestModuleArtifactCode({
+        if (metadataArtifactFiles.has(file)) {
+          const code =
+            requestBatchOutputs.get(routeRequestArtifactBatchKey(file, "metadata")) ??
+            (await bundleRouteRequestModuleCode({
               appDir: options.project.routesDir,
               bundleCache: options.bundleCache,
               cacheDir: options.cacheDir,
+              code: stripRouteMetadataOnlyExports(source, absoluteFile),
               filename: absoluteFile,
               importPolicy: requestModuleImportPolicy,
-              routeKind: route?.kind,
-              source,
+              label: "Metadata",
               vitePlugins: options.vitePlugins,
-            }),
-          sourceHash: hashText(source),
-        };
+            }));
+          artifact.routeMetadata = {
+            code,
+            sourceHash: hashText(source),
+          };
+        }
+
+        if (requestArtifactFiles.has(file)) {
+          const batchedRequestCode = requestBatchOutputs.get(
+            routeRequestArtifactBatchKey(file, "request"),
+          );
+          artifact.request = {
+            code:
+              batchedRequestCode ??
+              (await buildRequestModuleArtifactCode({
+                appDir: options.project.routesDir,
+                bundleCache: options.bundleCache,
+                cacheDir: options.cacheDir,
+                filename: absoluteFile,
+                importPolicy: requestModuleImportPolicy,
+                routeKind: route?.kind,
+                source,
+                vitePlugins: options.vitePlugins,
+              })),
+            sourceHash: hashText(source),
+          };
+        }
       }
-    }
 
-    if (!isServerComponentFile(file)) {
-      return Object.keys(artifact).length > 0 ? ([file, artifact] as const) : undefined;
-    }
+      if (!isServerComponentFile(file)) {
+        return Object.keys(artifact).length > 0 ? ([file, artifact] as const) : undefined;
+      }
 
-    const closureUsesAwait = routeAnalysis?.streamRoute ??
-      shouldBuildRouteAsStream({
-        filename: file,
-        files: options.files,
-        projectRoot: options.projectRoot,
-        source,
-      });
-    const streamRoute = route !== undefined && closureUsesAwait;
-    const serverOutputs =
-      streamRoute || (route === undefined && closureUsesAwait)
-        ? (["stream", "string"] as const)
-        : (["string"] as const);
-    const code = routeAnalysis?.routeCode ??
-      (route === undefined ? source : stripRouteBuildExports(source, absoluteFile));
-    const clientInference = routeAnalysis === undefined
-      ? await inferClientRouteModule({
-          ...(route === undefined ? {} : { appDir: options.project.routesDir }),
-          cache: options.clientRouteInferenceCache,
-          code:
-            route === undefined
-              ? stripRouteClientOnlyExports(source, absoluteFile)
-              : stripRouteClientSource({ code: source, filename: route.file }),
-          filename: join(options.projectRoot, file),
-          ...(route === undefined ? {} : { routePath: route.path }),
-          vitePlugins: options.vitePlugins,
-        })
-      : undefined;
-    const clientBoundaryImports = routeAnalysis?.clientBoundaryImports ??
-      clientInference?.clientBoundaryImports ??
-      [];
+      const closureUsesAwait =
+        routeAnalysis?.streamRoute ??
+        shouldBuildRouteAsStream({
+          filename: file,
+          files: options.files,
+          projectRoot: options.projectRoot,
+          source,
+        });
+      const streamRoute = route !== undefined && closureUsesAwait;
+      const serverOutputs =
+        streamRoute || (route === undefined && closureUsesAwait)
+          ? (["stream", "string"] as const)
+          : (["string"] as const);
+      const code =
+        routeAnalysis?.routeCode ??
+        (route === undefined ? source : stripRouteBuildExports(source, absoluteFile));
+      const clientInference =
+        routeAnalysis === undefined
+          ? await inferClientRouteModule({
+              ...(route === undefined ? {} : { appDir: options.project.routesDir }),
+              cache: options.clientRouteInferenceCache,
+              code:
+                route === undefined
+                  ? stripRouteClientOnlyExports(source, absoluteFile)
+                  : stripRouteClientSource({ code: source, filename: route.file }),
+              filename: join(options.projectRoot, file),
+              ...(route === undefined ? {} : { routePath: route.path }),
+              vitePlugins: options.vitePlugins,
+            })
+          : undefined;
+      const clientBoundaryImports =
+        routeAnalysis?.clientBoundaryImports ?? clientInference?.clientBoundaryImports ?? [];
+      const clientBoundaryFallbackImports =
+        routeAnalysis?.clientBoundaryFallbackImports ??
+        clientInference?.clientBoundaryFallbackImports ??
+        [];
+
+      for (const diagnostic of clientInference?.diagnostics ?? []) {
+        console.warn(formatClientRouteInferenceDiagnostic(diagnostic));
+      }
 
-    for (const diagnostic of clientInference?.diagnostics ?? []) {
-      console.warn(formatClientRouteInferenceDiagnostic(diagnostic));
-    }
+      if (routeAnalysis !== undefined) {
+        artifact.analysis = builtRouteSourceAnalysisSummary({
+          analysis: routeAnalysis,
+        });
+      }
 
-    if (routeAnalysis !== undefined) {
-      artifact.analysis = builtRouteSourceAnalysisSummary({
-        analysis: routeAnalysis,
-      });
-    }
+      const serverOutputArtifacts = await mapWithBuildConcurrency(
+        serverOutputs,
+        async (serverOutput) => {
+          const output = await transformServerRouteSource({
+            cache: options.serverTransformCache,
+            code,
+            clientBoundaryImports,
+            clientBoundaryFallbackImports,
+            filename: join(options.projectRoot, file),
+            moduleContextCache: options.clientRouteInferenceCache,
+            serverOutput,
+          });
+          const fatalDiagnostics = output.diagnostics.filter(
+            (diagnostic) => diagnostic.code !== "MR_UNSUPPORTED_SERVER_EVENT_HANDLER",
+          );
 
-    const serverOutputArtifacts = await mapWithBuildConcurrency(
-      serverOutputs,
-      async (serverOutput) => {
-        const output = await transformServerRouteSource({
-          cache: options.serverTransformCache,
-          code,
-          clientBoundaryImports,
-          filename: join(options.projectRoot, file),
-          moduleContextCache: options.clientRouteInferenceCache,
-          serverOutput,
-        });
-        const fatalDiagnostics = output.diagnostics.filter(
-          (diagnostic) => diagnostic.code !== "MR_UNSUPPORTED_SERVER_EVENT_HANDLER",
-        );
+          if (fatalDiagnostics.length > 0) {
+            if (
+              serverOutput === "string" &&
+              streamRoute &&
+              route?.kind === "page" &&
+              fatalDiagnostics.every(
+                (diagnostic) => diagnostic.code === "MR_UNSUPPORTED_AWAIT_INNER_COMPONENT",
+              )
+            ) {
+              return undefined;
+            }
+
+            throw new Error(
+              fatalDiagnostics.map((diagnostic) => formatDiagnostic(file, diagnostic)).join("\n"),
+            );
+          }
 
-        if (fatalDiagnostics.length > 0) {
           if (
             serverOutput === "string" &&
             streamRoute &&
             route?.kind === "page" &&
-            fatalDiagnostics.every(
-              (diagnostic) => diagnostic.code === "MR_UNSUPPORTED_AWAIT_INNER_COMPONENT",
-            )
+            source.includes("<Await") &&
+            /\bLink\b/.test(source)
           ) {
+            // Native Link renders pre-rendered children as HTML. Keep direct
+            // Await renderers on the stream artifact so the string artifact
+            // cannot drop deferred Link content before the boundary resolves.
             return undefined;
           }
 
-          throw new Error(
-            fatalDiagnostics.map((diagnostic) => formatDiagnostic(file, diagnostic)).join("\n"),
-          );
-        }
+          return [
+            serverOutput,
+            {
+              ...(options.prebundleServerComponents
+                ? {
+                    bundleCode: await buildServerComponentBundleArtifactCode({
+                      clientRouteInferenceCache: options.clientRouteInferenceCache,
+                      code: output.code,
+                      filename: absoluteFile,
+                      root: options.projectRoot,
+                      serverOutput,
+                      vitePlugins: options.vitePlugins,
+                    }),
+                  }
+                : {}),
+              code: output.code,
+              metadata: output.metadata,
+              sourceHash: hashText(code),
+            },
+          ] as const;
+        },
+      );
 
-        if (
-          serverOutput === "string" &&
-          streamRoute &&
-          route?.kind === "page" &&
-          source.includes("<Await") &&
-          /\bLink\b/.test(source)
-        ) {
-          // Native Link renders pre-rendered children as HTML. Keep direct
-          // Await renderers on the stream artifact so the string artifact
-          // cannot drop deferred Link content before the boundary resolves.
-          return undefined;
+      for (const entry of serverOutputArtifacts) {
+        if (entry !== undefined) {
+          artifact[entry[0]] = entry[1];
         }
-
-        return [
-          serverOutput,
-          {
-            ...(options.prebundleServerComponents
-              ? {
-                  bundleCode: await buildServerComponentBundleArtifactCode({
-                    clientRouteInferenceCache: options.clientRouteInferenceCache,
-                    code: output.code,
-                    filename: absoluteFile,
-                    root: options.projectRoot,
-                    serverOutput,
-                    vitePlugins: options.vitePlugins,
-                  }),
-                }
-              : {}),
-            code: output.code,
-            metadata: output.metadata,
-            sourceHash: hashText(code),
-          },
-        ] as const;
-      },
-    );
-
-    for (const entry of serverOutputArtifacts) {
-      if (entry !== undefined) {
-        artifact[entry[0]] = entry[1];
       }
-    }
 
-    return [file, artifact] as const;
-  });
+      return [file, artifact] as const;
+    },
+  );
 
   for (const entry of artifactEntries) {
     if (entry !== undefined) {
@@ -1981,6 +2010,7 @@ async function buildServerComponentBundleArtifactCode(options: {
 async function transformServerRouteSource(options: {
   cache: ServerTransformCache;
   clientBoundaryImports: readonly string[];
+  clientBoundaryFallbackImports?: readonly string[];
   code: string;
   filename: string;
   moduleContextCache: ClientRouteInferenceCache;
@@ -1988,6 +2018,7 @@ async function transformServerRouteSource(options: {
 }): Promise<ServerTransformOutput> {
   const cacheKey = stableCacheKey({
     clientBoundaryImports: options.clientBoundaryImports,
+    clientBoundaryFallbackImports: options.clientBoundaryFallbackImports ?? [],
     codeHash: hashText(options.code),
     filename: resolve(options.filename),
     serverOutput: options.serverOutput,
@@ -2009,6 +2040,7 @@ async function transformServerRouteSource(options: {
     return transformCompilerModuleContext({
       code: options.code,
       clientBoundaryImports: options.clientBoundaryImports,
+      clientBoundaryFallbackImports: options.clientBoundaryFallbackImports ?? [],
       dev: false,
       filename: options.filename,
       moduleContext,
@@ -2026,8 +2058,11 @@ function builtRouteSourceAnalysisSummary(options: {
 }): BuiltRouteSourceAnalysisSummary {
   return {
     authIncludesClaims: options.analysis.authIncludesClaims,
-    ...(options.analysis.cachePolicy === undefined ? {} : { cachePolicy: options.analysis.cachePolicy }),
+    ...(options.analysis.cachePolicy === undefined
+      ? {}
+      : { cachePolicy: options.analysis.cachePolicy }),
     clientBoundaryImports: options.analysis.clientBoundaryImports,
+    clientBoundaryFallbackImports: options.analysis.clientBoundaryFallbackImports,
     clientRoute: options.analysis.clientRoute,
     hasLoader: options.analysis.hasLoader,
     routeCode: options.analysis.routeCode,
@@ -2086,7 +2121,10 @@ function usesRuntimeCacheControl(code: string): boolean {
   return /\bcacheControl\s*\(/.test(code);
 }
 
-function routeRequestArtifactBatchKey(file: string, kind: "loader" | "metadata" | "request"): string {
+function routeRequestArtifactBatchKey(
+  file: string,
+  kind: "loader" | "metadata" | "request",
+): string {
   return `${kind}:${file}`;
 }
 
@@ -2126,15 +2164,15 @@ async function buildRequestModuleArtifactCode(options: {
     });
   }
 
-    return await bundleRouteLoaderModuleCode({
-      appDir: options.appDir,
-      bundleCache: options.bundleCache,
-      cacheDir: options.cacheDir,
-      code: stripRouteRequestOnlyExports(options.source, options.filename),
-      filename: options.filename,
-      importPolicy: options.importPolicy,
-      vitePlugins: options.vitePlugins,
-    });
+  return await bundleRouteLoaderModuleCode({
+    appDir: options.appDir,
+    bundleCache: options.bundleCache,
+    cacheDir: options.cacheDir,
+    code: stripRouteRequestOnlyExports(options.source, options.filename),
+    filename: options.filename,
+    importPolicy: options.importPolicy,
+    vitePlugins: options.vitePlugins,
+  });
 }
 
 async function bundleRouteLoaderModuleCode(options: {
@@ -2211,24 +2249,29 @@ async function bundleRouteRequestModuleBatchCode(options: {
         label: "Request artifact",
       }),
     ],
-    root: options.importPolicy?.projectRoot ?? dirname(options.entries[0]?.filename ?? options.appDir),
+    root:
+      options.importPolicy?.projectRoot ?? dirname(options.entries[0]?.filename ?? options.appDir),
     vitePlugins: options.vitePlugins,
   });
 
   if (output.chunks.some((chunk) => !chunk.isEntry)) {
-    const fallbackEntries = await mapWithBuildConcurrency(options.entries, async (entry) => [
-      entry.key,
-      await bundleRouteRequestModuleCode({
-        appDir: options.appDir,
-        bundleCache: options.bundleCache,
-        cacheDir: options.cacheDir,
-        code: entry.code,
-        filename: entry.filename,
-        importPolicy: options.importPolicy,
-        label: entry.label,
-        vitePlugins: options.vitePlugins,
-      }),
-    ] as const);
+    const fallbackEntries = await mapWithBuildConcurrency(
+      options.entries,
+      async (entry) =>
+        [
+          entry.key,
+          await bundleRouteRequestModuleCode({
+            appDir: options.appDir,
+            bundleCache: options.bundleCache,
+            cacheDir: options.cacheDir,
+            code: entry.code,
+            filename: entry.filename,
+            importPolicy: options.importPolicy,
+            label: entry.label,
+            vitePlugins: options.vitePlugins,
+          }),
+        ] as const,
+    );
     return new Map(fallbackEntries);
   }
 
@@ -2343,9 +2386,11 @@ function isMiddlewareFile(appDir: string, file: string): boolean {
 }
 
 function hasMetadataExport(code: string): boolean {
-  return /\bexport\s+const\s+metadata\s*=/.test(code) ||
+  return (
+    /\bexport\s+const\s+metadata\s*=/.test(code) ||
     /\bexport\s+(?:async\s+)?function\s+generateMetadata\b/.test(code) ||
-    /\bexport\s*\{[^}]*\bgenerateMetadata\b[^}]*\}/.test(code);
+    /\bexport\s*\{[^}]*\bgenerateMetadata\b[^}]*\}/.test(code)
+  );
 }
 
 async function readDeclaredProjectPackages(projectRoot: string): Promise<string[]> {
@@ -2409,6 +2454,7 @@ interface RouteRequestModuleBatchEntry {
 async function writeCloudflareRouteModules(options: {
   cacheDir?: string | undefined;
   cloudflareDir: string;
+  define?: UserConfig["define"] | undefined;
   files: Record<string, string>;
   prerenderedRoutes: Record<string, BuiltPrerenderedRoute>;
   projectRoot: string;
@@ -2428,11 +2474,13 @@ async function writeCloudflareRouteModules(options: {
 
         return analysis === undefined
           ? []
-          : [{
-              route,
-              routeFile,
-              routeId: routeIdForPath(route.path),
-            }];
+          : [
+              {
+                route,
+                routeFile,
+                routeId: routeIdForPath(route.path),
+              },
+            ];
       }),
   );
 
@@ -2440,6 +2488,7 @@ async function writeCloudflareRouteModules(options: {
 
   const serverRouteModules = await buildCloudflareServerRouteModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     routes: requiredRoutes
       .filter(({ route }) => route.kind === "server" || route.kind === "metadata")
       .map(({ route, routeId }) => ({ filename: route.file, routeId })),
@@ -2448,9 +2497,12 @@ async function writeCloudflareRouteModules(options: {
   });
   const loaderRouteModules = await buildCloudflareRouteLoaderModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     routes: requiredRoutes
-      .filter(({ route, routeFile }) =>
-        route.kind === "page" && options.sourceAnalysis.byRouteFile.get(routeFile)?.hasLoader === true
+      .filter(
+        ({ route, routeFile }) =>
+          route.kind === "page" &&
+          options.sourceAnalysis.byRouteFile.get(routeFile)?.hasLoader === true,
       )
       .map(({ route, routeId }) => ({ filename: route.file, routeId })),
     root: options.projectRoot,
@@ -2474,6 +2526,7 @@ async function writeCloudflareRouteModules(options: {
   );
   const directComponentModules = await buildCloudflareServerComponentModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     projectRoot: options.projectRoot,
     routes: directComponentRoutes,
     serverModules: options.serverModules,
@@ -2482,6 +2535,7 @@ async function writeCloudflareRouteModules(options: {
   });
   const stringShellComponentModules = await buildCloudflareStringRouteComponentModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     projectRoot: options.projectRoot,
     routes: stringShellComponentRoutes,
     serverModules: options.serverModules,
@@ -2496,112 +2550,120 @@ async function writeCloudflareRouteModules(options: {
     writeCloudflareBatchedRouteModuleChunks(options.cloudflareDir, stringShellComponentModules),
   ]);
 
-  const registryEntries = await mapWithBuildConcurrency(requiredRoutes, async ({ route, routeFile, routeId }) => {
-    const routeModuleFile = `routes/${routeId}.mjs`;
-    let routeModuleExports: string[];
+  const registryEntries = await mapWithBuildConcurrency(
+    requiredRoutes,
+    async ({ route, routeFile, routeId }) => {
+      const routeModuleFile = `routes/${routeId}.mjs`;
+      let routeModuleExports: string[];
 
-    if (route.kind === "server" || route.kind === "metadata") {
-      try {
-        const serverRouteModule = serverRouteModules.entries.get(routeId);
+      if (route.kind === "server" || route.kind === "metadata") {
+        try {
+          const serverRouteModule = serverRouteModules.entries.get(routeId);
 
-        if (serverRouteModule === undefined) {
-          throw new Error(`Missing bundled Cloudflare ${route.kind} route module.`);
+          if (serverRouteModule === undefined) {
+            throw new Error(`Missing bundled Cloudflare ${route.kind} route module.`);
+          }
+
+          const serverRouteFile = serverRouteModule.fileName;
+          const serverRouteImport = `./${serverRouteFile.split("/").pop() ?? serverRouteFile}`;
+          routeModuleExports = [
+            `export * from ${JSON.stringify(serverRouteImport)};`,
+            ...(route.kind === "metadata"
+              ? [`export { default } from ${JSON.stringify(serverRouteImport)};`]
+              : []),
+          ];
+        } catch (error) {
+          throw new Error(
+            `Failed to build Cloudflare ${route.kind} route module for ${routeFile}: ${errorMessage(error)}`,
+          );
         }
 
-        const serverRouteFile = serverRouteModule.fileName;
-        const serverRouteImport = `./${serverRouteFile.split("/").pop() ?? serverRouteFile}`;
-        routeModuleExports = [
-          `export * from ${JSON.stringify(serverRouteImport)};`,
-          ...(route.kind === "metadata"
-            ? [`export { default } from ${JSON.stringify(serverRouteImport)};`]
-            : []),
-        ];
-      } catch (error) {
-        throw new Error(
-          `Failed to build Cloudflare ${route.kind} route module for ${routeFile}: ${errorMessage(error)}`,
+        await writeFile(
+          join(options.cloudflareDir, routeModuleFile),
+          `${routeModuleExports.join("\n")}\n`,
         );
+        return `${JSON.stringify(routeFile)}: () => import(${JSON.stringify(`./${routeModuleFile}`)})`;
       }
 
-      await writeFile(join(options.cloudflareDir, routeModuleFile), `${routeModuleExports.join("\n")}\n`);
-      return `${JSON.stringify(routeFile)}: () => import(${JSON.stringify(`./${routeModuleFile}`)})`;
-    }
-
-    const serverOutput =
-      options.serverModules[routeFile]?.analysis?.streamRoute === true ||
-      options.sourceAnalysis.byRouteFile.get(routeFile)?.streamRoute === true
-        ? "stream"
-        : "string";
+      const serverOutput =
+        options.serverModules[routeFile]?.analysis?.streamRoute === true ||
+        options.sourceAnalysis.byRouteFile.get(routeFile)?.streamRoute === true
+          ? "stream"
+          : "string";
 
-    try {
-      const batchedComponent =
-        stringShellComponentRouteIds.has(routeId)
+      try {
+        const batchedComponent = stringShellComponentRouteIds.has(routeId)
           ? stringShellComponentModules.entries.get(routeId)
           : directComponentRouteIds.has(routeId)
             ? directComponentModules.entries.get(routeId)
             : undefined;
-      let componentFile = batchedComponent?.fileName;
-
-      if (batchedComponent === undefined) {
-        const componentOutput =
-          serverOutput === "stream"
-            ? await buildCloudflareStreamRouteComponentModule({
-                cacheDir: options.cacheDir,
-                filename: route.file,
-                projectRoot: options.projectRoot,
-                routesDir: options.routesDir,
-                serverModules: options.serverModules,
-                sourceAnalysis: options.sourceAnalysis,
-                vitePlugins: options.vitePlugins,
-              })
-            : await buildCloudflareStringRouteComponentModule({
-                cacheDir: options.cacheDir,
-                filename: route.file,
-                projectRoot: options.projectRoot,
-                routesDir: options.routesDir,
-                serverModules: options.serverModules,
-                sourceAnalysis: options.sourceAnalysis,
-                vitePlugins: options.vitePlugins,
-              });
+        let componentFile = batchedComponent?.fileName;
+
+        if (batchedComponent === undefined) {
+          const componentOutput =
+            serverOutput === "stream"
+              ? await buildCloudflareStreamRouteComponentModule({
+                  cacheDir: options.cacheDir,
+                  define: options.define,
+                  filename: route.file,
+                  projectRoot: options.projectRoot,
+                  routesDir: options.routesDir,
+                  serverModules: options.serverModules,
+                  sourceAnalysis: options.sourceAnalysis,
+                  vitePlugins: options.vitePlugins,
+                })
+              : await buildCloudflareStringRouteComponentModule({
+                  cacheDir: options.cacheDir,
+                  define: options.define,
+                  filename: route.file,
+                  projectRoot: options.projectRoot,
+                  routesDir: options.routesDir,
+                  serverModules: options.serverModules,
+                  sourceAnalysis: options.sourceAnalysis,
+                  vitePlugins: options.vitePlugins,
+                });
+
+          componentFile = `routes/${routeId}.${hashText(componentOutput).slice(0, 8)}.component.mjs`;
+          await writeFile(join(options.cloudflareDir, componentFile), componentOutput);
+        }
 
-        componentFile = `routes/${routeId}.${hashText(componentOutput).slice(0, 8)}.component.mjs`;
-        await writeFile(join(options.cloudflareDir, componentFile), componentOutput);
-      }
+        if (componentFile === undefined) {
+          throw new Error("Missing bundled Cloudflare component module.");
+        }
 
-      if (componentFile === undefined) {
-        throw new Error("Missing bundled Cloudflare component module.");
+        const componentImport = `./${componentFile.split("/").pop() ?? componentFile}`;
+        routeModuleExports = [cloudflarePageRouteFacadeModuleSource(componentImport)];
+      } catch (error) {
+        throw new Error(
+          `Failed to build Cloudflare route module for ${routeFile}: ${errorMessage(error)}`,
+        );
       }
 
-      const componentImport = `./${componentFile.split("/").pop() ?? componentFile}`;
-      routeModuleExports = [
-        cloudflarePageRouteFacadeModuleSource(componentImport),
-      ];
-    } catch (error) {
-      throw new Error(
-        `Failed to build Cloudflare route module for ${routeFile}: ${errorMessage(error)}`,
-      );
-    }
+      if (options.sourceAnalysis.byRouteFile.get(routeFile)?.hasLoader === true) {
+        try {
+          const loaderModule = loaderRouteModules.entries.get(routeId);
 
-    if (options.sourceAnalysis.byRouteFile.get(routeFile)?.hasLoader === true) {
-      try {
-        const loaderModule = loaderRouteModules.entries.get(routeId);
+          if (loaderModule === undefined) {
+            throw new Error("Missing bundled Cloudflare loader module.");
+          }
 
-        if (loaderModule === undefined) {
-          throw new Error("Missing bundled Cloudflare loader module.");
+          const loaderFile = loaderModule.fileName;
+          const loaderImport = `./${loaderFile.split("/").pop() ?? loaderFile}`;
+          routeModuleExports.push(`export { loader } from ${JSON.stringify(loaderImport)};`);
+        } catch (error) {
+          throw new Error(
+            `Failed to build Cloudflare loader module for ${routeFile}: ${errorMessage(error)}`,
+          );
         }
-
-        const loaderFile = loaderModule.fileName;
-        const loaderImport = `./${loaderFile.split("/").pop() ?? loaderFile}`;
-        routeModuleExports.push(`export { loader } from ${JSON.stringify(loaderImport)};`);
-      } catch (error) {
-        throw new Error(
-          `Failed to build Cloudflare loader module for ${routeFile}: ${errorMessage(error)}`,
-        );
       }
-    }
 
-    await writeFile(join(options.cloudflareDir, routeModuleFile), `${routeModuleExports.join("\n")}\n`);
-    return `${JSON.stringify(routeFile)}: () => import(${JSON.stringify(`./${routeModuleFile}`)})`;
-  });
+      await writeFile(
+        join(options.cloudflareDir, routeModuleFile),
+        `${routeModuleExports.join("\n")}\n`,
+      );
+      return `${JSON.stringify(routeFile)}: () => import(${JSON.stringify(`./${routeModuleFile}`)})`;
+    },
+  );
 
   const registrySource = [
     `export const routeModules = {`,
@@ -2754,6 +2816,7 @@ interface CloudflareShellFile {
 
 async function buildCloudflareServerComponentModuleBatch(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   projectRoot: string;
   routes: readonly CloudflareBatchedComponentRoute[];
   serverModules: Record<string, BuiltServerModuleArtifact>;
@@ -2769,6 +2832,7 @@ async function buildCloudflareServerComponentModuleBatch(options: {
     options.routes.map(async (route) => {
       const metadataModule = await buildCloudflareRouteMetadataExportModule({
         cacheDir: options.cacheDir,
+        define: options.define,
         filename: route.filename,
         hasMetadata: buildSourceAnalysisForFile(
           options.sourceAnalysis,
@@ -2801,6 +2865,7 @@ async function buildCloudflareServerComponentModuleBatch(options: {
   const output = await bundleRouterModules({
     cacheDir: options.cacheDir,
     chunkFileNames: "routes/chunks/[name].[hash].mjs",
+    define: options.define,
     entries: bundleEntries,
     entryFileNames: "routes/[name].[hash].mjs",
     minify: true,
@@ -2844,6 +2909,7 @@ async function buildCloudflareServerComponentModuleBatch(options: {
 
 async function buildCloudflareStringRouteComponentModuleBatch(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   projectRoot: string;
   routes: readonly CloudflareBatchedStringRoute[];
   serverModules: Record<string, BuiltServerModuleArtifact>;
@@ -2861,6 +2927,7 @@ async function buildCloudflareStringRouteComponentModuleBatch(options: {
       const pageMetadataId = `mreact:metadata:${route.routeId}:page`;
       const pageMetadataModule = await buildCloudflareRouteMetadataExportModule({
         cacheDir: options.cacheDir,
+        define: options.define,
         filename: route.filename,
         hasMetadata: buildSourceAnalysisForFile(
           options.sourceAnalysis,
@@ -2878,7 +2945,9 @@ async function buildCloudflareStringRouteComponentModuleBatch(options: {
           contents: pageMetadataModule,
           resolveDir: dirname(route.filename),
         });
-        metadataImports.push(`import * as pageMetadataModule from ${JSON.stringify(pageMetadataId)};`);
+        metadataImports.push(
+          `import * as pageMetadataModule from ${JSON.stringify(pageMetadataId)};`,
+        );
       }
 
       const shellMetadataImports = await Promise.all(
@@ -2886,6 +2955,7 @@ async function buildCloudflareStringRouteComponentModuleBatch(options: {
           const shellMetadataId = `mreact:metadata:${route.routeId}:shell:${index}`;
           const shellMetadataModule = await buildCloudflareRouteMetadataExportModule({
             cacheDir: options.cacheDir,
+            define: options.define,
             filename: shell.file,
             hasMetadata: buildSourceAnalysisForFile(
               options.sourceAnalysis,
@@ -2926,6 +2996,7 @@ async function buildCloudflareStringRouteComponentModuleBatch(options: {
   const output = await bundleRouterModules({
     cacheDir: options.cacheDir,
     chunkFileNames: "routes/chunks/[name].[hash].mjs",
+    define: options.define,
     entries: bundleEntries,
     entryFileNames: "routes/[name].[hash].mjs",
     minify: true,
@@ -3055,6 +3126,7 @@ ${cloudflareShellRuntimeSource()}`;
 
 async function buildCloudflareServerComponentModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   filename: string;
   projectRoot: string;
   serverOutput: ServerOutputMode;
@@ -3064,8 +3136,13 @@ async function buildCloudflareServerComponentModule(options: {
 }): Promise<string> {
   const metadataModule = await buildCloudflareRouteMetadataExportModule({
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: options.filename,
-    hasMetadata: buildSourceAnalysisForFile(options.sourceAnalysis, options.projectRoot, options.filename)?.hasMetadata,
+    hasMetadata: buildSourceAnalysisForFile(
+      options.sourceAnalysis,
+      options.projectRoot,
+      options.filename,
+    )?.hasMetadata,
     root: options.projectRoot,
     vitePlugins: options.vitePlugins,
   });
@@ -3078,9 +3155,9 @@ async function buildCloudflareServerComponentModule(options: {
     entry,
     filename: `${options.filename}.mreact-cloudflare-component.js`,
     cacheDir: options.cacheDir,
-    modules: metadataModule === undefined
-      ? new Map()
-      : new Map([["mreact:metadata", metadataModule]]),
+    define: options.define,
+    modules:
+      metadataModule === undefined ? new Map() : new Map([["mreact:metadata", metadataModule]]),
     plugins: [
       cloudflareServerSourceTransformPlugin({
         projectRoot: options.projectRoot,
@@ -3113,6 +3190,7 @@ export const slots = routeModule.slots;`;
 
 async function buildCloudflareStringRouteComponentModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   filename: string;
   projectRoot: string;
   routesDir: string;
@@ -3125,6 +3203,7 @@ async function buildCloudflareStringRouteComponentModule(options: {
   if (shellFiles.length === 0) {
     return buildCloudflareServerComponentModule({
       cacheDir: options.cacheDir,
+      define: options.define,
       filename: options.filename,
       projectRoot: options.projectRoot,
       serverModules: options.serverModules,
@@ -3136,6 +3215,7 @@ async function buildCloudflareStringRouteComponentModule(options: {
 
   const pageModule = await buildCloudflareComponentExportModule({
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: options.filename,
     projectRoot: options.projectRoot,
     serverModules: options.serverModules,
@@ -3147,6 +3227,7 @@ async function buildCloudflareStringRouteComponentModule(options: {
     shellFiles.map((shell) =>
       buildCloudflareComponentExportModule({
         cacheDir: options.cacheDir,
+        define: options.define,
         filename: shell.file,
         projectRoot: options.projectRoot,
         serverModules: options.serverModules,
@@ -3156,7 +3237,9 @@ async function buildCloudflareStringRouteComponentModule(options: {
       }),
     ),
   );
-  const shellImports = shellFiles.map((_, index) => `import * as shell${index} from "mreact:shell-${index}";`);
+  const shellImports = shellFiles.map(
+    (_, index) => `import * as shell${index} from "mreact:shell-${index}";`,
+  );
   const shellDefinitions = shellFiles.map(
     (shell, index) =>
       `{ component: selectComponent(shell${index}, ${JSON.stringify(shell.file)}), id: ${JSON.stringify(shell.id)}, kind: ${JSON.stringify(shell.kind)}, module: shell${index} }`,
@@ -3215,6 +3298,7 @@ ${cloudflareShellRuntimeSource()}`;
   return bundleCloudflareVirtualModule({
     entry,
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: `${options.filename}.mreact-cloudflare-string-route.js`,
     modules: new Map([
       ["mreact:page", pageModule],
@@ -3229,6 +3313,7 @@ ${cloudflareShellRuntimeSource()}`;
 
 async function buildCloudflareStreamRouteComponentModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   filename: string;
   projectRoot: string;
   routesDir: string;
@@ -3238,6 +3323,7 @@ async function buildCloudflareStreamRouteComponentModule(options: {
 }): Promise<string> {
   const pageModule = await buildCloudflareComponentExportModule({
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: options.filename,
     projectRoot: options.projectRoot,
     serverModules: options.serverModules,
@@ -3250,6 +3336,7 @@ async function buildCloudflareStreamRouteComponentModule(options: {
     shellFiles.map((shell) =>
       buildCloudflareComponentExportModule({
         cacheDir: options.cacheDir,
+        define: options.define,
         filename: shell.file,
         projectRoot: options.projectRoot,
         serverModules: options.serverModules,
@@ -3259,7 +3346,9 @@ async function buildCloudflareStreamRouteComponentModule(options: {
       }),
     ),
   );
-  const shellImports = shellFiles.map((_, index) => `import * as shell${index} from "mreact:shell-${index}";`);
+  const shellImports = shellFiles.map(
+    (_, index) => `import * as shell${index} from "mreact:shell-${index}";`,
+  );
   const shellDefinitions = shellFiles.map(
     (shell, index) =>
       `{ component: selectComponent(shell${index}, ${JSON.stringify(shell.file)}), id: ${JSON.stringify(shell.id)}, kind: ${JSON.stringify(shell.kind)}, module: shell${index} }`,
@@ -3336,6 +3425,7 @@ ${cloudflareShellRuntimeSource()}`;
   return bundleCloudflareVirtualModule({
     entry,
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: `${options.filename}.mreact-cloudflare-stream-route.js`,
     modules: new Map([
       ["mreact:page", pageModule],
@@ -3646,6 +3736,7 @@ function escapeHtml(value) {
 
 async function buildCloudflareComponentExportModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   filename: string;
   projectRoot: string;
   serverModules: Record<string, BuiltServerModuleArtifact>;
@@ -3655,8 +3746,13 @@ async function buildCloudflareComponentExportModule(options: {
 }): Promise<string> {
   const metadataModule = await buildCloudflareRouteMetadataExportModule({
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: options.filename,
-    hasMetadata: buildSourceAnalysisForFile(options.sourceAnalysis, options.projectRoot, options.filename)?.hasMetadata,
+    hasMetadata: buildSourceAnalysisForFile(
+      options.sourceAnalysis,
+      options.projectRoot,
+      options.filename,
+    )?.hasMetadata,
     root: options.projectRoot,
     vitePlugins: options.vitePlugins,
   });
@@ -3673,10 +3769,10 @@ export const slots = routeModule.slots;`;
   return bundleCloudflareVirtualModule({
     entry,
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: `${options.filename}.mreact-cloudflare-${options.serverOutput}-component.js`,
-    modules: metadataModule === undefined
-      ? new Map()
-      : new Map([["mreact:metadata", metadataModule]]),
+    modules:
+      metadataModule === undefined ? new Map() : new Map([["mreact:metadata", metadataModule]]),
     plugins: [
       cloudflareServerSourceTransformPlugin({
         projectRoot: options.projectRoot,
@@ -3707,12 +3803,14 @@ async function writeCloudflareBatchedRouteModuleChunks(
 
 async function buildCloudflareRouteLoaderModuleBatch(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   routes: readonly { filename: string; routeId: string }[];
   root: string;
   vitePlugins?: readonly PluginOption[] | undefined;
 }): Promise<CloudflareBatchedRouteModules> {
   return await bundleCloudflareModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     entries: options.routes.map((route) => ({
       code: cloudflareRouteLoaderModuleEntry(route.filename),
       filename: `${route.filename}.mreact-cloudflare-loader.js`,
@@ -3726,12 +3824,14 @@ async function buildCloudflareRouteLoaderModuleBatch(options: {
 
 export async function __buildCloudflareRouteLoaderModuleBatchForTests(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   projectRoot: string;
   routes: readonly { filename: string; routeId: string }[];
   vitePlugins?: readonly PluginOption[] | undefined;
 }): Promise<Record<string, string>> {
   const output = await buildCloudflareRouteLoaderModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     root: options.projectRoot,
     routes: options.routes,
     vitePlugins: options.vitePlugins,
@@ -3744,12 +3844,14 @@ export async function __buildCloudflareRouteLoaderModuleBatchForTests(options: {
 
 async function buildCloudflareServerRouteModuleBatch(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   routes: readonly { filename: string; routeId: string }[];
   root: string;
   vitePlugins?: readonly PluginOption[] | undefined;
 }): Promise<CloudflareBatchedRouteModules> {
   return await bundleCloudflareModuleBatch({
     cacheDir: options.cacheDir,
+    define: options.define,
     entries: options.routes.map((route) => ({
       code: cloudflareServerRouteModuleEntry(route.filename),
       filename: `${route.filename}.mreact-cloudflare-server-route.js`,
@@ -3763,6 +3865,7 @@ async function buildCloudflareServerRouteModuleBatch(options: {
 
 async function bundleCloudflareModuleBatch(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   entries: readonly {
     code: string;
     filename: string;
@@ -3779,6 +3882,7 @@ async function bundleCloudflareModuleBatch(options: {
   const output = await bundleRouterModules({
     cacheDir: options.cacheDir,
     chunkFileNames: "routes/chunks/[name].[hash].mjs",
+    define: options.define,
     entries: options.entries,
     entryFileNames: "routes/[name].[hash].mjs",
     minify: true,
@@ -3817,6 +3921,7 @@ function cloudflareRouteLoaderModuleEntry(filename: string): string {
 
 async function buildCloudflareRouteMetadataExportModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   filename: string;
   hasMetadata?: boolean | undefined;
   root?: string | undefined;
@@ -3833,6 +3938,7 @@ export const metadata = routeMetadataModule.metadata;`;
   return bundleCloudflareModule({
     entry,
     cacheDir: options.cacheDir,
+    define: options.define,
     filename: `${options.filename}.mreact-cloudflare-metadata.js`,
     plugins: [cloudflareWorkspaceRuntimePlugin()],
     resolveDir: dirname(options.filename),
@@ -3858,6 +3964,7 @@ export default defaultHandler;`;
 
 async function bundleCloudflareModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   entry: string;
   filename: string;
   plugins: RouterCompatPlugin[];
@@ -3868,6 +3975,7 @@ async function bundleCloudflareModule(options: {
   const output = await bundleRouterModule({
     cacheDir: options.cacheDir,
     code: options.entry,
+    define: options.define,
     filename: options.filename,
     minify: true,
     platform: "node",
@@ -3888,6 +3996,7 @@ async function bundleCloudflareModule(options: {
 
 async function bundleCloudflareVirtualModule(options: {
   cacheDir?: string | undefined;
+  define?: UserConfig["define"] | undefined;
   entry: string;
   filename: string;
   modules: ReadonlyMap<string, string>;
@@ -3898,6 +4007,7 @@ async function bundleCloudflareVirtualModule(options: {
 }): Promise<string> {
   return bundleCloudflareModule({
     cacheDir: options.cacheDir,
+    define: options.define,
     entry: options.entry,
     filename: options.filename,
     plugins: [
@@ -4047,6 +4157,7 @@ async function transformCloudflareServerSource(options: {
   const output = transformCompilerModuleContext({
     code: options.source,
     clientBoundaryImports: clientInference.clientBoundaryImports,
+    clientBoundaryFallbackImports: clientInference.clientBoundaryFallbackImports,
     dev: false,
     filename: options.filename,
     moduleContext,
@@ -4060,7 +4171,9 @@ async function transformCloudflareServerSource(options: {
 
   if (fatalDiagnostics.length > 0) {
     throw new Error(
-      fatalDiagnostics.map((diagnostic) => formatDiagnostic(options.filename, diagnostic)).join("\n"),
+      fatalDiagnostics
+        .map((diagnostic) => formatDiagnostic(options.filename, diagnostic))
+        .join("\n"),
     );
   }
 
@@ -4101,9 +4214,18 @@ function cloudflareWorkspaceRuntimePlugin(): RouterCompatPlugin {
       "@reckona/mreact-compat/event-priority",
       packageFile("react-compat", "@reckona/mreact-compat", "event-priority"),
     ],
-    ["@reckona/mreact-compat/flight", packageFile("react-compat", "@reckona/mreact-compat", "flight")],
-    ["@reckona/mreact-compat/hooks", packageFile("react-compat", "@reckona/mreact-compat", "hooks-entry")],
-    ["@reckona/mreact-compat/internal", packageFile("react-compat", "@reckona/mreact-compat", "internal")],
+    [
+      "@reckona/mreact-compat/flight",
+      packageFile("react-compat", "@reckona/mreact-compat", "flight"),
+    ],
+    [
+      "@reckona/mreact-compat/hooks",
+      packageFile("react-compat", "@reckona/mreact-compat", "hooks-entry"),
+    ],
+    [
+      "@reckona/mreact-compat/internal",
+      packageFile("react-compat", "@reckona/mreact-compat", "internal"),
+    ],
     [
       "@reckona/mreact-compat/jsx-dev-runtime",
       packageFile("react-compat", "@reckona/mreact-compat", "jsx-dev-runtime"),
@@ -4112,9 +4234,15 @@ function cloudflareWorkspaceRuntimePlugin(): RouterCompatPlugin {
       "@reckona/mreact-compat/jsx-runtime",
       packageFile("react-compat", "@reckona/mreact-compat", "jsx-runtime"),
     ],
-    ["@reckona/mreact-compat/scheduler", packageFile("react-compat", "@reckona/mreact-compat", "scheduler")],
+    [
+      "@reckona/mreact-compat/scheduler",
+      packageFile("react-compat", "@reckona/mreact-compat", "scheduler"),
+    ],
     ["@reckona/mreact-query", packageFile("query", "@reckona/mreact-query", "index")],
-    ["@reckona/mreact-reactive-core", packageFile("reactive-core", "@reckona/mreact-reactive-core", "index")],
+    [
+      "@reckona/mreact-reactive-core",
+      packageFile("reactive-core", "@reckona/mreact-reactive-core", "index"),
+    ],
     [
       "@reckona/mreact-router/adapters/cloudflare",
       packageFile("router", "@reckona/mreact-router", "adapters/cloudflare"),
@@ -4133,10 +4261,13 @@ function cloudflareWorkspaceRuntimePlugin(): RouterCompatPlugin {
   return {
     name: "mreact-cloudflare-workspace-runtime",
     setup(buildApi) {
-      buildApi.onResolve({ filter: /^@reckona\/mreact-router\/(?:internal\/)?native-escape$/ }, () => ({
-        namespace: "mreact-cloudflare-native-escape",
-        path: "native-escape",
-      }));
+      buildApi.onResolve(
+        { filter: /^@reckona\/mreact-router\/(?:internal\/)?native-escape$/ },
+        () => ({
+          namespace: "mreact-cloudflare-native-escape",
+          path: "native-escape",
+        }),
+      );
       buildApi.onResolve({ filter: /^@reckona\/mreact-router$/ }, () => ({
         namespace: "mreact-cloudflare-router-index",
         path: "index",
@@ -4146,8 +4277,10 @@ function cloudflareWorkspaceRuntimePlugin(): RouterCompatPlugin {
 
         return path === undefined ? undefined : { path };
       });
-      buildApi.onLoad({ filter: /^native-escape$/, namespace: "mreact-cloudflare-native-escape" }, () => ({
-        contents: `function escapeHtml(value) {
+      buildApi.onLoad(
+        { filter: /^native-escape$/, namespace: "mreact-cloudflare-native-escape" },
+        () => ({
+          contents: `function escapeHtml(value) {
   return String(value ?? "").replace(/[&<>"']/g, (char) =>
     char === "&" ? "&amp;" : char === "<" ? "&lt;" : char === ">" ? "&gt;" : char === '"' ? "&quot;" : "&#39;"
   );
@@ -4155,8 +4288,9 @@ function cloudflareWorkspaceRuntimePlugin(): RouterCompatPlugin {
 export function escapeHtmlBatch(values) {
   return values.map(escapeHtml);
 }`,
-        loader: "js",
-      }));
+          loader: "js",
+        }),
+      );
       buildApi.onLoad({ filter: /^index$/, namespace: "mreact-cloudflare-router-index" }, () => ({
         contents: `export { cacheControl, revalidatePath } from ${JSON.stringify(routerCachePath)};
 export { deleteCookie, parseCookieHeader, serializeCookie, setCookie } from ${JSON.stringify(routerCookiesPath)};
@@ -4170,12 +4304,15 @@ export { getServerRuntimeState } from ${JSON.stringify(routerRuntimeStatePath)};
         loader: "js",
         resolveDir: dirname(routerNavigationPath),
       }));
-      buildApi.onLoad({ filter: /(?:^|[/\\])packages[/\\]server[/\\](?:src|dist)[/\\]native-flight\.[jt]s$/ }, () => ({
-        contents: `export function getNativeFlight() {
+      buildApi.onLoad(
+        { filter: /(?:^|[/\\])packages[/\\]server[/\\](?:src|dist)[/\\]native-flight\.[jt]s$/ },
+        () => ({
+          contents: `export function getNativeFlight() {
   return undefined;
 }`,
-        loader: "js",
-      }));
+          loader: "js",
+        }),
+      );
     },
   };
 }
@@ -4377,18 +4514,23 @@ async function writeClientRouteBundles(options: {
     });
   } catch (error) {
     const routeContexts = clientEntries
-      .map((entry) => `Failed to build client bundle for ${entry.route.path} (${entry.route.file}).`)
+      .map(
+        (entry) => `Failed to build client bundle for ${entry.route.path} (${entry.route.file}).`,
+      )
       .join("\n");
 
-    throw new Error(`${routeContexts}\nFailed to build client route bundles.\n${errorMessage(error)}`, {
-      cause: error,
-    });
+    throw new Error(
+      `${routeContexts}\nFailed to build client route bundles.\n${errorMessage(error)}`,
+      {
+        cause: error,
+      },
+    );
   }
 
   const routeOutputs = new Map(output.routes.map((route) => [route.routePath, route]));
   const mapAssets = new Map(
     output.chunks.flatMap((chunk) =>
-      chunk.map === undefined ? [] : [[`${chunk.fileName}.map`, chunk.map] as const]
+      chunk.map === undefined ? [] : [[`${chunk.fileName}.map`, chunk.map] as const],
     ),
   );
 
@@ -4413,9 +4555,7 @@ async function writeClientRouteBundles(options: {
 
   for (const asset of output.assets ?? []) {
     const source =
-      typeof asset.source === "string"
-        ? asset.source
-        : Buffer.from(asset.source).toString("utf8");
+      typeof asset.source === "string" ? asset.source : Buffer.from(asset.source).toString("utf8");
 
     await mkdir(dirname(join(options.clientDir, asset.fileName)), { recursive: true });
     await writeFile(join(options.clientDir, asset.fileName), source);
@@ -4492,12 +4632,16 @@ async function writeRouteCssAssetBatches(options: {
       appDir: options.appDir,
       pageFile: route.file,
       projectRoot: options.projectRoot,
-      readSource: (file) => buildSourceAnalysisForFile(options.sourceAnalysis, options.projectRoot, file)?.source,
+      readSource: (file) =>
+        buildSourceAnalysisForFile(options.sourceAnalysis, options.projectRoot, file)?.source,
     });
 
     return { cssFiles, route };
   });
-  const groups = new Map<string, { cssFiles: string[]; routeIds: string[]; routeFiles: string[] }>();
+  const groups = new Map<
+    string,
+    { cssFiles: string[]; routeIds: string[]; routeFiles: string[] }
+  >();
 
   for (const { cssFiles, route } of cssInputs) {
     if (cssFiles.length === 0) {
@@ -4511,18 +4655,22 @@ async function writeRouteCssAssetBatches(options: {
     groups.set(key, group);
   }
 
-  const writtenGroups = await mapWithBuildConcurrency([...groups.entries()], async ([key, group]) => [
-    key,
-    await writeRouteCssAssetsForFiles({
-      cacheDir: options.cacheDir,
-      clientDir: options.clientDir,
-      cssFiles: group.cssFiles,
-      pageFile: group.routeFiles[0] ?? options.appDir,
-      projectRoot: options.projectRoot,
-      routeIds: group.routeIds,
-      vitePlugins: options.vitePlugins,
-    }),
-  ] as const);
+  const writtenGroups = await mapWithBuildConcurrency(
+    [...groups.entries()],
+    async ([key, group]) =>
+      [
+        key,
+        await writeRouteCssAssetsForFiles({
+          cacheDir: options.cacheDir,
+          clientDir: options.clientDir,
+          cssFiles: group.cssFiles,
+          pageFile: group.routeFiles[0] ?? options.appDir,
+          projectRoot: options.projectRoot,
+          routeIds: group.routeIds,
+          vitePlugins: options.vitePlugins,
+        }),
+      ] as const,
+  );
   const cssByGroup = new Map(writtenGroups);
   const cssByRoute = new Map<string, string[]>();
 
@@ -4566,15 +4714,14 @@ async function writeRouteCssAssetsForFiles(options: {
   });
   const cssAssets = (output.assets ?? []).filter((asset) => asset.fileName.endsWith(".css"));
   const written: string[] = [];
-  const routeStem = options.routeIds.length === 1
-    ? (options.routeIds[0] ?? "index")
-    : `shared.${hashText(cssFiles.join("\0")).slice(0, 8)}`;
+  const routeStem =
+    options.routeIds.length === 1
+      ? (options.routeIds[0] ?? "index")
+      : `shared.${hashText(cssFiles.join("\0")).slice(0, 8)}`;
 
   for (const [index, asset] of cssAssets.entries()) {
     const source =
-      typeof asset.source === "string"
-        ? asset.source
-        : Buffer.from(asset.source).toString("utf8");
+      typeof asset.source === "string" ? asset.source : Buffer.from(asset.source).toString("utf8");
     const hash = createHash("sha256").update(source).digest("hex").slice(0, 8);
     const cssFile = `assets/routes/${routeStem}${cssAssets.length === 1 ? "" : `.${index}`}.${hash}.css`;
 
@@ -4752,7 +4899,9 @@ function isBarePackageImport(specifier: string): boolean {
 
 async function assertAwsLambdaRuntimeDependencies(outDir: string): Promise<void> {
   try {
-    const info = await stat(join(outDir, "node_modules", "@reckona", "mreact-router", "package.json"));
+    const info = await stat(
+      join(outDir, "node_modules", "@reckona", "mreact-router", "package.json"),
+    );
     if (info.isFile()) {
       return;
     }
@@ -4845,7 +4994,9 @@ function assertPackageOutputDoesNotReplaceBuildOutput(options: {
   outDir: string;
 }): void {
   if (resolve(options.fromDir) === resolve(options.outDir)) {
-    throw new Error("Package output directory must be different from the mreact build output directory.");
+    throw new Error(
+      "Package output directory must be different from the mreact build output directory.",
+    );
   }
 }
 
@@ -4909,7 +5060,9 @@ async function collectArtifactFiles(
     }
   }
 
-  return files.sort((left, right) => right.bytes - left.bytes || left.path.localeCompare(right.path));
+  return files.sort(
+    (left, right) => right.bytes - left.bytes || left.path.localeCompare(right.path),
+  );
 }
 
 function awsLambdaHandlerSource(outDirRelativeToHandler: string): string {
@@ -4954,6 +5107,7 @@ async function validateProductionRoutes(options: {
       cache: options.serverTransformCache,
       code: analysis.routeCode,
       clientBoundaryImports: analysis.clientBoundaryImports,
+      clientBoundaryFallbackImports: analysis.clientBoundaryFallbackImports,
       filename: route.file,
       moduleContextCache: options.clientRouteInferenceCache,
       serverOutput: analysis.streamRoute ? "stream" : "string",
@@ -4993,10 +5147,10 @@ async function collectBuildFiles(
 
       return [{ file, relativeFile }];
     });
-    const fileContents = await mapWithBuildConcurrency(sourceFiles, async ({ file, relativeFile }) => [
-      relativeFile,
-      await readFile(file, "utf8"),
-    ] as const);
+    const fileContents = await mapWithBuildConcurrency(
+      sourceFiles,
+      async ({ file, relativeFile }) => [relativeFile, await readFile(file, "utf8")] as const,
+    );
 
     for (const [relativeFile, source] of fileContents) {
       files[relativeFile] = source;