@wular/pnext 0.0.4 → 0.0.7

package/src/client/build.ts

@@ -1,7 +1,7 @@
-import { createHash } from 'node:crypto';
-import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs';
-import { copyFile, mkdir, readFile, rename, stat } from 'node:fs/promises';
-import path from 'node:path';
+import { createHash } from 'node:crypto'
+import { existsSync, readFileSync, realpathSync, statSync } from 'node:fs'
+import { copyFile, mkdir, readFile, rename, stat } from 'node:fs/promises'
+import path from 'node:path'
 import {
   build,
   type BuildOptions,
@@ -12,23 +12,27 @@ import {
   type Plugin,
   type PluginBuild,
   type ResolveResult,
-} from 'esbuild';
-import { foldInitialChunks } from './chunk-fold';
-import { clientEntryName } from './paths';
-import { clientProfile } from './profile';
-import { publicEnvDefines, type ResolvedConfig } from '../config';
-import { cssModuleClientPlugin } from '../css';
-import { withAssetPrefix } from '../css/build';
-import { devDynamicSplitEnabled, rewriteDeferredDynamicImports, rewriteLiteralDynamicCalls } from '../dynamic/source';
-import { scanFacts } from '../resolve/scan-facts';
-import { readSourceText } from '../resolve/source-text';
-import { ensureDir, listFiles, readText, writeText } from '../utils/fs';
-import { escapeRegex } from '../utils/source';
+} from 'esbuild'
+import { foldInitialChunks } from './chunk-fold'
+import { clientEntryName } from './chunk-name'
+import { clientProfile } from './profile'
+import { frameworkRuntimeAliasEntries, publicEnvDefines, type ResolvedConfig } from '../config'
+import { cssModuleClientPlugin } from '../css/build'
+import { withAssetPrefix } from '../css/build'
+import {
+  devDynamicSplitEnabled,
+  rewriteDeferredDynamicImports,
+  rewriteLiteralDynamicCalls,
+} from '../resolve/dynamic'
+import { scanFacts } from '../resolve/scan-facts'
+import { readSourceText } from '../resolve/source-text'
+import { ensureDir, listFiles, readText, writeText } from '../utils/fs'
+import { escapeRegex } from '../utils/code'
 import {
   getExternalPackagePolicy,
   resolveImport,
   resolveLinkedPackageSpecifier,
-} from '../resolve/imports';
+} from '../resolve/imports'
 import {
   CLIENT_RUNTIME_MODULE,
   DYN_SHARED_GLOBAL,
@@ -37,8 +41,8 @@ import {
   clientRuntimeFacts,
   clientRuntimeSource,
   type ClientRuntimeFacts,
-} from './entry';
-import { clientSuspenseFree } from './compat-surface';
+} from './entry'
+import { clientSuspenseFree } from './react-tier'
 import {
   ensurePrebuiltRuntime,
   prebuiltAssets,
@@ -48,13 +52,13 @@ import {
   prebuiltSpecifierFilter,
   settlePrebuiltRuntime,
   type PrebuiltRuntime,
-} from './prebuilt';
-import { findLayouts } from '../routing/routes';
-import { clientReferenceId, ssrClientReference, type ClientReference } from './reference';
-import { shouldReactCompile, transformReactCompiler } from './react-compiler';
-import { createVerboseLogger } from '../utils/verbose';
-import { dim as dimText } from '../utils/ansi';
-import type { RouteManifestEntry } from '../types';
+} from './prebuilt'
+import { findLayouts } from '../routing/routes'
+import { clientReferenceId, ssrClientReference, type ClientReference } from './reference'
+import { shouldReactCompile, transformReactCompiler } from './react-compiler'
+import { createVerboseLogger, formatDuration } from '../utils/verbose'
+import { dim as dimText } from '../utils/ansi'
+import type { RouteManifestEntry } from '../types'
 import {
   applyClientSourceAsyncPreTransforms,
   applyClientSourceTransforms,
@@ -64,7 +68,7 @@ import {
   getImportAliasExtensions,
   hasClientSourceAsyncPreTransforms,
   type CompatModeExtensions,
-} from '../extensions';
+} from '../extensions'
 
 /**
  * Write the standalone static chunks a bundler extension supplies (compat: the
@@ -73,44 +77,44 @@ import {
  * build. No-op for pure-core apps (the seam returns none).
  */
 export async function emitStaticClientChunks(config: ResolvedConfig, outDir: string) {
-  const chunks = getBundlerExtensions().staticClientChunks(config);
-  if (chunks.length === 0) return;
-  const chunksDir = path.join(outDir, 'chunks');
-  await ensureDir(chunksDir);
+  const chunks = getBundlerExtensions().staticClientChunks(config)
+  if (chunks.length === 0) return
+  const chunksDir = path.join(outDir, 'chunks')
+  await ensureDir(chunksDir)
   for (const chunk of chunks) {
-    await writeText(path.join(chunksDir, chunk.name), chunk.contents);
+    await writeText(path.join(chunksDir, chunk.name), chunk.contents)
   }
 }
 
 interface ClientBuildOptions {
-  config: ResolvedConfig;
-  route: RouteManifestEntry;
-  outDir: string;
-  dev?: boolean;
+  config: ResolvedConfig
+  route: RouteManifestEntry
+  outDir: string
+  dev?: boolean
 }
 
 interface ClientBatchBuildOptions {
-  config: ResolvedConfig;
-  routes: RouteManifestEntry[];
-  outDir: string;
-  verbose?: boolean;
+  config: ResolvedConfig
+  routes: RouteManifestEntry[]
+  outDir: string
+  verbose?: boolean
   /**
    * The app defines at least one server action (the build's action manifest). Unset means "unknown" -
    * dev, where the manifest is discovered per request - and the action runtime is emitted, since only
    * prod bundles are budgeted.
    */
-  hasServerActions?: boolean;
+  hasServerActions?: boolean
   /**
    * A pipeline already warmed by the caller (the build starts one under the
    * route-fact scan). Omitted — dev, tests — the stage opens its own.
    */
-  pipeline?: ClientSourcePipeline;
+  pipeline?: ClientSourcePipeline
 }
 
-const virtualEntryNamespace = 'pnext-client-entry';
+const virtualEntryNamespace = 'pnext-client-entry'
 
 function nextCompatEnabled(config: ResolvedConfig) {
-  return getCompatModeExtensions().nextEnabled(config);
+  return getCompatModeExtensions().nextEnabled(config)
 }
 
 /**
@@ -119,13 +123,13 @@ function nextCompatEnabled(config: ResolvedConfig) {
  * directories once per route. Memoized for the duration of one build and cleared at each entry
  * point, so a dev rebuild re-stats after a file is added or removed.
  */
-const conventionCache = new Map<string, unknown>();
+const conventionCache = new Map<string, unknown>()
 
 function memoConvention<T>(key: string, compute: () => T): T {
-  if (conventionCache.has(key)) return conventionCache.get(key) as T;
-  const value = compute();
-  conventionCache.set(key, value);
-  return value;
+  if (conventionCache.has(key)) return conventionCache.get(key) as T
+  const value = compute()
+  conventionCache.set(key, value)
+  return value
 }
 
 /**
@@ -136,10 +140,10 @@ function memoConvention<T>(key: string, compute: () => T): T {
  * drops it.
  */
 function appUsesActions(routes: RouteManifestEntry[], hasServerActions?: boolean) {
-  if (hasServerActions !== false) return true;
+  if (hasServerActions !== false) return true
   return routes.some(route =>
     route.clientEntryReasons?.some(reason => reason === 'actions' || reason === 'form'),
-  );
+  )
 }
 
 /**
@@ -148,10 +152,10 @@ function appUsesActions(routes: RouteManifestEntry[], hasServerActions?: boolean
  * actions elsewhere.
  */
 function routeUsesActions(route: RouteManifestEntry, appActions: boolean) {
-  if (!appActions) return false;
+  if (!appActions) return false
   return (
     route.clientEntryReasons?.some(reason => reason === 'actions' || reason === 'form') === true
-  );
+  )
 }
 
 /**
@@ -160,15 +164,15 @@ function routeUsesActions(route: RouteManifestEntry, appActions: boolean) {
  * file - has to be in the tree to catch it.
  */
 function routeThrowsClientControlFlow(route: RouteManifestEntry): boolean {
-  return route.clientEntryReasons?.includes('control-flow') === true;
+  return route.clientEntryReasons?.includes('control-flow') === true
 }
 
 function routeErrorFile(config: ResolvedConfig, route: RouteManifestEntry): string | undefined {
-  return routeConventionFile(config, route, 'error');
+  return routeConventionFile(config, route, 'error')
 }
 
 function routeNotFoundFile(config: ResolvedConfig, route: RouteManifestEntry): string | undefined {
-  return routeConventionFile(config, route, 'not-found');
+  return routeConventionFile(config, route, 'not-found')
 }
 
 // Nearest segment convention file for a route: walked from the page's own
@@ -178,26 +182,26 @@ function routeConventionFile(
   route: RouteManifestEntry,
   name: string,
 ): string | undefined {
-  if (!nextCompatEnabled(config)) return undefined;
-  const appPath = path.resolve(config.appPath);
-  const start = path.dirname(path.resolve(route.file));
-  const relative = path.relative(appPath, start);
-  if (relative.startsWith('..') || path.isAbsolute(relative)) return undefined;
+  if (!nextCompatEnabled(config)) return undefined
+  const appPath = path.resolve(config.appPath)
+  const start = path.dirname(path.resolve(route.file))
+  const relative = path.relative(appPath, start)
+  if (relative.startsWith('..') || path.isAbsolute(relative)) return undefined
   // Memoized per directory, not per route: sibling routes walk the same chain,
   // and a parent's answer is the tail of every child's walk.
   return memoConvention(`${name}\0${start}`, () => {
-    let dir = start;
+    let dir = start
     for (;;) {
       for (const ext of ['tsx', 'ts', 'jsx', 'js']) {
-        const candidate = path.join(dir, `${name}.${ext}`);
-        if (existsSync(candidate)) return candidate;
+        const candidate = path.join(dir, `${name}.${ext}`)
+        if (existsSync(candidate)) return candidate
       }
-      if (dir === appPath) return undefined;
-      const parent = path.dirname(dir);
-      if (parent === dir) return undefined;
-      dir = parent;
+      if (dir === appPath) return undefined
+      const parent = path.dirname(dir)
+      if (parent === dir) return undefined
+      dir = parent
     }
-  });
+  })
 }
 
 // The app-root global-error.* convention file (single per app, unlike error.*
@@ -205,15 +209,15 @@ function routeConventionFile(
 // can mount a user global-error component for client throws that escape every
 // route error boundary. Absent → the built-in fallback document is used.
 function globalErrorFile(config: ResolvedConfig): string | undefined {
-  if (!nextCompatEnabled(config)) return undefined;
-  const appPath = path.resolve(config.appPath);
+  if (!nextCompatEnabled(config)) return undefined
+  const appPath = path.resolve(config.appPath)
   return memoConvention(`global-error\0${appPath}`, () => {
     for (const ext of ['tsx', 'ts', 'jsx', 'js']) {
-      const candidate = path.join(appPath, `global-error.${ext}`);
-      if (existsSync(candidate)) return candidate;
+      const candidate = path.join(appPath, `global-error.${ext}`)
+      if (existsSync(candidate)) return candidate
     }
-    return undefined;
-  });
+    return undefined
+  })
 }
 
 /**
@@ -225,10 +229,10 @@ function globalErrorFile(config: ResolvedConfig): string | undefined {
  * this is true, and the shell path depends on those markers.
  */
 function hasClientRootLayout(config: ResolvedConfig, route: RouteManifestEntry): boolean {
-  if (route.client) return false;
-  const rootLayout = shellLayoutOrder(config, route)[0];
-  if (!rootLayout) return false;
-  return route.clientReferences.some(reference => reference.file === rootLayout);
+  if (route.client) return false
+  const rootLayout = shellLayoutOrder(config, route)[0]
+  if (!rootLayout) return false
+  return route.clientReferences.some(reference => reference.file === rootLayout)
 }
 
 /**
@@ -240,7 +244,7 @@ function shellLayoutOrder(config: ResolvedConfig, route: RouteManifestEntry): st
   // Asked three times per route (shell order, client-root check, runtime facts).
   return memoConvention(`layouts\0${config.appPath}\0${route.file}`, () =>
     findLayouts(config.appPath, route.file),
-  );
+  )
 }
 
 /**
@@ -256,24 +260,22 @@ function prebuiltLocation(config: ResolvedConfig, outDir: string, key: string, d
       dir: prebuiltRuntimeDir(config, key),
       publicPath: `/__pnext/runtime/${key}`,
       assetPath: `__pnext/runtime/${key}`,
-    };
+    }
   }
   // The SERVED url, not a relative one: chunks sit a directory below the
   // entries, so no single relative path is correct from both — and esbuild
   // writes an external path through verbatim, the same string everywhere.
-  const served = nextCompatEnabled(config)
-    ? `/_next/static/rt/${key}`
-    : `/assets/rt/${key}`;
+  const served = nextCompatEnabled(config) ? `/_next/static/rt/${key}` : `/assets/rt/${key}`
   return {
     dir: path.join(outDir, 'rt', key),
     publicPath: withAssetPrefix(config, served),
     assetPath: `assets/rt/${key}`,
-  };
+  }
 }
 
 /** Where the dev server reads the artifact back from. */
 export function prebuiltRuntimeDir(config: ResolvedConfig, key: string) {
-  return path.join(config.root, 'node_modules', '.cache', 'pnext', 'client-runtime', key);
+  return path.join(config.root, 'node_modules', '.cache', 'pnext', 'client-runtime', key)
 }
 
 /**
@@ -285,7 +287,7 @@ export function prebuiltRuntimeDir(config: ResolvedConfig, key: string) {
  */
 function prebuiltEnabled() {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
-  return process.env.PNEXT_PREBUILT_RUNTIME === '1';
+  return process.env.PNEXT_PREBUILT_RUNTIME === '1'
 }
 
 /**
@@ -296,7 +298,7 @@ function prebuiltEnabled() {
  * the same framework names.
  */
 function surfaceSignature(config: ResolvedConfig, route: RouteManifestEntry, actions: boolean) {
-  const nextCompat = nextCompatEnabled(config);
+  const nextCompat = nextCompatEnabled(config)
   const facts = clientRuntimeFacts(
     [
       {
@@ -306,7 +308,7 @@ function surfaceSignature(config: ResolvedConfig, route: RouteManifestEntry, act
     ],
     nextCompat,
     !routeSuspenseFree(config, route),
-  );
+  )
   return JSON.stringify([
     nextCompat,
     actions,
@@ -316,14 +318,14 @@ function surfaceSignature(config: ResolvedConfig, route: RouteManifestEntry, act
     routeThrowsClientControlFlow(route) === true,
     Boolean(route.needsRouterEntry),
     facts,
-  ]);
+  ])
 }
 
 interface PreparedPrebuilt {
-  runtime: PrebuiltRuntime;
-  plugin: Plugin;
+  runtime: PrebuiltRuntime
+  plugin: Plugin
   /** Fold what the build demanded into the artifact. */
-  settle(): Promise<void>;
+  settle(): Promise<void>
 }
 
 /**
@@ -339,10 +341,10 @@ async function preparePrebuilt(
   signature = '',
   reactLite = false,
 ): Promise<PreparedPrebuilt | undefined> {
-  if (!prebuiltEnabled()) return undefined;
-  const buildOptions = baseClientBuildOptions(config, dev);
-  const key = prebuiltRuntimeKey(config, buildOptions, signature);
-  const { dir, publicPath, assetPath } = prebuiltLocation(config, outDir, key, dev);
+  if (!prebuiltEnabled()) return undefined
+  const buildOptions = baseClientBuildOptions(config, dev)
+  const key = prebuiltRuntimeKey(config, buildOptions, signature)
+  const { dir, publicPath, assetPath } = prebuiltLocation(config, outDir, key, dev)
   // The artifact build gets the same plugin chain — and therefore the same
   // aliases, transforms and asset seam — as the route build it stands in for.
   // Not the prebuilt plugin itself: inside the artifact, framework imports are
@@ -355,51 +357,51 @@ async function preparePrebuilt(
     assetPath,
     buildOptions,
     plugins: () => clientBuildPlugins(config, createClientSourcePipeline(config), [], reactLite),
-  };
-  const runtime = await ensurePrebuiltRuntime(options);
-  const unprobed = new Set<string>();
+  }
+  const runtime = await ensurePrebuiltRuntime(options)
+  const unprobed = new Set<string>()
   return {
     runtime,
     plugin: prebuiltExternalPlugin(runtime, prebuiltSpecifierFilter(config), unprobed, sourceOf),
     async settle() {
-      await settlePrebuiltRuntime(runtime, options, outDir, unprobed);
+      await settlePrebuiltRuntime(runtime, options, outDir, unprobed)
     },
-  };
+  }
 }
 
 /** The served URL of a deferred dynamic reference's on-demand chunk (dev split). */
 export function deferredDynamicChunkHref(reference: Pick<ClientReference, 'id'>) {
-  return `/__pnext/client-dyn/${reference.id}.js`;
+  return `/__pnext/client-dyn/${reference.id}.js`
 }
 
 export interface DeferredDynamicRef {
-  file: string;
-  exportName: string;
+  file: string
+  exportName: string
 }
 
 // Process-level registry the dev chunk endpoint resolves ids through. Entries
 // come from the pipeline rewrite below and from each out-dir's sidecar (a
 // restart serving a cached entry never re-ran the rewrite).
-const deferredDynamicRefs = new Map<string, DeferredDynamicRef>();
+const deferredDynamicRefs = new Map<string, DeferredDynamicRef>()
 
 export function registerDeferredDynamicRef(id: string, ref: DeferredDynamicRef) {
-  deferredDynamicRefs.set(id, ref);
+  deferredDynamicRefs.set(id, ref)
 }
 
 export function deferredDynamicRefById(id: string) {
-  return deferredDynamicRefs.get(id);
+  return deferredDynamicRefs.get(id)
 }
 
 /** Sidecar name persisted next to a dev entry naming its deferred dynamic refs. */
-export const DEFERRED_DYNAMIC_SIDECAR = 'dyn-refs.json';
+export const DEFERRED_DYNAMIC_SIDECAR = 'dyn-refs.json'
 
 /** Dev-only: deferred dynamic references load from the on-demand chunk endpoint. */
 function devDeferredDynamicHref(dev: boolean | undefined) {
-  if (!dev || !devDynamicSplitEnabled()) return undefined;
+  if (!dev || !devDynamicSplitEnabled()) return undefined
   return (reference: ClientReference) =>
     reference.dynamic && !ssrClientReference(reference)
       ? deferredDynamicChunkHref(reference)
-      : undefined;
+      : undefined
 }
 
 /** Deferred chunk URLs resolve at runtime, never inside the entry build. */
@@ -410,15 +412,15 @@ function deferredDynamicExternalPlugin(): Plugin {
       build.onResolve({ filter: /^\/__pnext\/client-dyn\// }, args => ({
         path: args.path,
         external: true,
-      }));
+      }))
     },
-  };
+  }
 }
 
 export async function buildClientEntry({ config, route, outDir, dev }: ClientBuildOptions) {
-  conventionCache.clear();
-  await ensureDir(outDir);
-  const suspense = routeSuspenseFree(config, route) === false;
+  conventionCache.clear()
+  await ensureDir(outDir)
+  const suspense = routeSuspenseFree(config, route) === false
   const source = clientEntrySource({
     deferredDynamicHref: devDeferredDynamicHref(dev),
     pageFile: route.client ? route.file : undefined,
@@ -434,11 +436,11 @@ export async function buildClientEntry({ config, route, outDir, dev }: ClientBui
     router: Boolean(route.needsRouterEntry),
     clientRootLayout: hasClientRootLayout(config, route),
     shellLayoutOrder: shellLayoutOrder(config, route),
-  });
-  const entryName = clientEntryName(route);
-  const outfile = path.join(outDir, `${entryName}.js`);
-  const pipeline = createClientSourcePipeline(config, dev === true);
-  pipeline.warmRoutes([route]);
+  })
+  const entryName = clientEntryName(route)
+  const outfile = path.join(outDir, `${entryName}.js`)
+  const pipeline = createClientSourcePipeline(config, dev === true)
+  pipeline.warmRoutes([route])
   const runtimeFacts = clientRuntimeFacts(
     [
       {
@@ -448,65 +450,76 @@ export async function buildClientEntry({ config, route, outDir, dev }: ClientBui
     ],
     nextCompatEnabled(config),
     suspense,
-  );
-  const prebuilt = await clientProfile.timeAsync('prebuilt', () => preparePrebuilt(
-    config,
-    outDir,
-    dev === true,
-    importer =>
-      importer === CLIENT_RUNTIME_MODULE
-        ? clientRuntimeSource(runtimeFacts)
-        : (pipeline.sourceOf(importer) ?? readTextSyncSafe(importer)),
-    // One route is its own surface group, so the key is the same one the batch
-    // build would give this route's group — dev and prod derive it identically.
-    surfaceSignature(config, route, true),
-    !suspense,
-  ));
-
-  let metafile: Metafile | undefined;
+  )
+  const prebuilt = await clientProfile.timeAsync('prebuilt', () =>
+    preparePrebuilt(
+      config,
+      outDir,
+      dev === true,
+      importer =>
+        importer === CLIENT_RUNTIME_MODULE
+          ? clientRuntimeSource(runtimeFacts)
+          : (pipeline.sourceOf(importer) ?? readTextSyncSafe(importer)),
+      // One route is its own surface group, so the key is the same one the batch
+      // build would give this route's group — dev and prod derive it identically.
+      surfaceSignature(config, route, true),
+      !suspense,
+    ),
+  )
+
+  let metafile: Metafile | undefined
   try {
     const result = await profileClientBuild(route, dev, () =>
-      clientProfile.timeAsync('esbuild', () => build({
-        ...baseClientBuildOptions(config, dev),
-        stdin: {
-          contents: source,
-          loader: 'ts',
-          resolveDir: process.cwd(),
-          sourcefile: `${route.id}.ts`,
-        },
-        outdir: outDir,
-        entryNames: entryName,
-        metafile: true,
-        plugins: clientBuildPlugins(config, pipeline, [
-          ...(prebuilt ? [prebuilt.plugin] : []),
-          ...(devDeferredDynamicHref(dev) ? [deferredDynamicExternalPlugin()] : []),
-          clientRuntimePlugin(runtimeFacts),
-        ], !suspense),
-      })),
-    );
-    metafile = result.metafile;
+      clientProfile.timeAsync('esbuild', () =>
+        build({
+          ...baseClientBuildOptions(config, dev),
+          stdin: {
+            contents: source,
+            loader: 'ts',
+            resolveDir: process.cwd(),
+            sourcefile: `${route.id}.ts`,
+          },
+          outdir: outDir,
+          entryNames: entryName,
+          metafile: true,
+          plugins: clientBuildPlugins(
+            config,
+            pipeline,
+            [
+              ...(prebuilt ? [prebuilt.plugin] : []),
+              ...(devDeferredDynamicHref(dev) ? [deferredDynamicExternalPlugin()] : []),
+              clientRuntimePlugin(runtimeFacts),
+            ],
+            !suspense,
+          ),
+        }),
+      ),
+    )
+    metafile = result.metafile
   } catch (error) {
-    throw withClientImportTrace(error, config, route, source);
+    throw withClientImportTrace(error, config, route, source)
   }
-  await clientProfile.timeAsync('prebuiltSettle', () => prebuilt?.settle() ?? Promise.resolve());
+  await clientProfile.timeAsync('prebuiltSettle', () => prebuilt?.settle() ?? Promise.resolve())
 
   if (metafile) {
-    metafile = await clientProfile.timeAsync('fold', () => foldInitialChunks({
-      outDir,
-      metafile: metafile!,
-      buildOptions: baseClientBuildOptions(config, dev),
-    }));
+    metafile = await clientProfile.timeAsync('fold', () =>
+      foldInitialChunks({
+        outDir,
+        metafile: metafile!,
+        buildOptions: baseClientBuildOptions(config, dev),
+      }),
+    )
   }
-  await clientProfile.timeAsync('write', () => nameSharedClientChunks(outDir, metafile));
+  await clientProfile.timeAsync('write', () => nameSharedClientChunks(outDir, metafile))
   if (dev && devDynamicSplitEnabled() && pipeline.deferredRefs().size > 0) {
     await writeText(
       path.join(outDir, DEFERRED_DYNAMIC_SIDECAR),
       JSON.stringify(Object.fromEntries(pipeline.deferredRefs())),
-    );
+    )
   }
-  clientProfile.report(`client entry ${route.id}`);
+  clientProfile.report(`client entry ${route.id}`)
 
-  return outfile;
+  return outfile
 }
 
 /**
@@ -522,71 +535,73 @@ export async function buildClientDynamicChunk({
   reference,
   outDir,
 }: {
-  config: ResolvedConfig;
-  route?: RouteManifestEntry;
-  reference: DeferredDynamicRef & { id: string };
-  outDir: string;
+  config: ResolvedConfig
+  route?: RouteManifestEntry
+  reference: DeferredDynamicRef & { id: string }
+  outDir: string
 }) {
-  await ensureDir(outDir);
-  const pipeline = createClientSourcePipeline(config, true);
+  await ensureDir(outDir)
+  const pipeline = createClientSourcePipeline(config, true)
   const prebuilt = await preparePrebuilt(
     config,
     outDir,
     true,
     importer => pipeline.sourceOf(importer) ?? readTextSyncSafe(importer),
     route ? surfaceSignature(config, route, true) : '',
-  );
+  )
   const source = [
     reference.exportName === 'default'
       ? `export { default } from ${JSON.stringify(reference.file)};`
       : '',
     `export * from ${JSON.stringify(reference.file)};`,
-  ].join('\n');
-  const outfile = path.join(outDir, `${reference.id}.js`);
-  await clientProfile.timeAsync('dynChunk', () => build({
-    ...baseClientBuildOptions(config, true),
-    stdin: {
-      contents: source,
-      loader: 'ts',
-      resolveDir: process.cwd(),
-      sourcefile: `${reference.id}.dyn.ts`,
-    },
-    outdir: outDir,
-    entryNames: reference.id,
-    plugins: clientBuildPlugins(config, pipeline, [
-      ...(prebuilt ? [prebuilt.plugin] : []),
-      dynSharedVendorPlugin(nextCompatEnabled(config)),
-      deferredDynamicExternalPlugin(),
-    ]),
-  }));
-  await prebuilt?.settle();
-  clientProfile.report(`client dynamic chunk ${reference.id}`);
-  return outfile;
+  ].join('\n')
+  const outfile = path.join(outDir, `${reference.id}.js`)
+  await clientProfile.timeAsync('dynChunk', () =>
+    build({
+      ...baseClientBuildOptions(config, true),
+      stdin: {
+        contents: source,
+        loader: 'ts',
+        resolveDir: process.cwd(),
+        sourcefile: `${reference.id}.dyn.ts`,
+      },
+      outdir: outDir,
+      entryNames: reference.id,
+      plugins: clientBuildPlugins(config, pipeline, [
+        ...(prebuilt ? [prebuilt.plugin] : []),
+        dynSharedVendorPlugin(nextCompatEnabled(config)),
+        deferredDynamicExternalPlugin(),
+      ]),
+    }),
+  )
+  await prebuilt?.settle()
+  clientProfile.report(`client dynamic chunk ${reference.id}`)
+  return outfile
 }
 
 /** Shared-vendor shims: preact resolves to the entry's published namespace. */
 function dynSharedVendorPlugin(nextCompat: boolean): Plugin {
-  const namespace = 'pnext-dyn-shared';
-  const filter = new RegExp(`^(?:${dynSharedSpecifiers(nextCompat).map(escapeRegex).join('|')})$`);
+  const namespace = 'pnext-dyn-shared'
+  const filter = new RegExp(`^(?:${dynSharedSpecifiers(nextCompat).map(escapeRegex).join('|')})$`)
   return {
     name: 'pnext-dyn-shared-vendor',
     setup(build) {
       build.onResolve({ filter }, args =>
         args.namespace === namespace ? undefined : { path: args.path, namespace },
-      );
+      )
       build.onLoad({ filter: /.*/, namespace }, async args => {
         const names = Object.keys((await import(args.path)) as Record<string, unknown>).filter(
           name => /^[A-Za-z_$][\w$]*$/.test(name) && name !== 'default',
-        );
+        )
         const lines = [
           `const m = window.${DYN_SHARED_GLOBAL}[${JSON.stringify(args.path)}];`,
           'export default (m && m.default);',
           ...names.map(name => `export const ${name} = m.${name};`),
-        ];
-        return { contents: lines.join('\n'), loader: 'js' };
-      });
+        ]
+        return { contents: lines.join('\n'), loader: 'js' }
+      })
     },
-  };
+  }
 }
 
 /**
@@ -603,84 +618,86 @@ export async function buildClientEntries({
   hasServerActions,
   pipeline: warmed,
 }: ClientBatchBuildOptions) {
-  if (!warmed) conventionCache.clear();
-  const actions = appUsesActions(routes, hasServerActions);
-  const entries = clientProfile.time('entrySources', () => routes
-    .filter(route => route.client || route.clientReferences.length > 0 || route.needsRouterEntry)
-    .map(route => ({
-      route,
-      entryName: clientEntryName(route),
-      source: clientEntrySource({
-        pageFile: route.client ? route.file : undefined,
-        clientReferences: route.clientReferences,
-        nextCompat: nextCompatEnabled(config),
-        suspense: !routeSuspenseFree(config, route),
-        actions: routeUsesActions(route, actions),
-        errorFile: routeErrorFile(config, route),
-        globalErrorFile: globalErrorFile(config),
-        notFoundFile: routeNotFoundFile(config, route),
-        controlFlow: routeThrowsClientControlFlow(route),
-      router: Boolean(route.needsRouterEntry),
-        clientRootLayout: hasClientRootLayout(config, route),
-        shellLayoutOrder: shellLayoutOrder(config, route),
-      }),
-    })));
-  if (entries.length === 0) return;
+  if (!warmed) conventionCache.clear()
+  const actions = appUsesActions(routes, hasServerActions)
+  const entries = clientProfile.time('entrySources', () =>
+    routes
+      .filter(route => route.client || route.clientReferences.length > 0 || route.needsRouterEntry)
+      .map(route => ({
+        route,
+        entryName: clientEntryName(route),
+        source: clientEntrySource({
+          pageFile: route.client ? route.file : undefined,
+          clientReferences: route.clientReferences,
+          nextCompat: nextCompatEnabled(config),
+          suspense: !routeSuspenseFree(config, route),
+          actions: routeUsesActions(route, actions),
+          errorFile: routeErrorFile(config, route),
+          globalErrorFile: globalErrorFile(config),
+          notFoundFile: routeNotFoundFile(config, route),
+          controlFlow: routeThrowsClientControlFlow(route),
+          router: Boolean(route.needsRouterEntry),
+          clientRootLayout: hasClientRootLayout(config, route),
+          shellLayoutOrder: shellLayoutOrder(config, route),
+        }),
+      })),
+  )
+  if (entries.length === 0) return
   // Every route's client sources start their transform and React Compiler pass here, in one batch on
   // oxc's threadpool, while esbuild is still booting and walking the graph. A caller-warmed pipeline
   // has them in flight already; warming twice is a Map hit, so the same call covers both.
-  const pipeline = warmed ?? createClientSourcePipeline(config);
-  pipeline.warmRoutes(entries.map(entry => entry.route));
-  await ensureDir(outDir);
-  const groups = surfaceGroups(config, entries, actions);
-  clientProfile.count('group#', groups.length);
-  const built: BuiltEntryGroup[] = [];
+  const pipeline = warmed ?? createClientSourcePipeline(config)
+  pipeline.warmRoutes(entries.map(entry => entry.route))
+  await ensureDir(outDir)
+  const groups = surfaceGroups(config, entries, actions)
+  clientProfile.count('group#', groups.length)
+  const built: BuiltEntryGroup[] = []
   for (const group of groups) {
-    built.push(await buildEntryGroup({ config, outDir, entries, group, pipeline, verbose }));
+    built.push(await buildEntryGroup({ config, outDir, entries, group, pipeline, verbose }))
   }
 
   // Fold and rename once over the finished output, never per group. Chunk names
   // are content hashes, so two groups emit the same file for the same chunk —
   // and the fold DELETES the members it merges, so a per-group fold would
   // unlink a chunk another group's manifest still points at.
-  let merged: Metafile = { inputs: {}, outputs: {} };
+  let merged: Metafile = { inputs: {}, outputs: {} }
   for (const item of built) {
-    if (!item.metafile) continue;
-    Object.assign(merged.inputs, item.metafile.inputs);
-    Object.assign(merged.outputs, item.metafile.outputs);
+    if (!item.metafile) continue
+    Object.assign(merged.inputs, item.metafile.inputs)
+    Object.assign(merged.outputs, item.metafile.outputs)
   }
   merged = await clientProfile.timeAsync('fold', () =>
     foldInitialChunks({ outDir, metafile: merged, buildOptions: baseClientBuildOptions(config) }),
-  );
+  )
   const renames = await clientProfile.timeAsync('write', () =>
     nameSharedClientChunks(outDir, merged),
-  );
+  )
   clientProfile.time('entryImports', () => {
     for (const item of built) {
       if (item.metafile) {
-        assignClientEntryImports(item.group.entries, merged, outDir, renames, item.prebuilt);
+        assignClientEntryImports(item.group.entries, merged, outDir, renames, item.prebuilt)
       }
     }
-  });
-  clientProfile.report('client stage');
+  })
+  clientProfile.report('client stage')
 }
 
 interface ClientEntry {
-  route: RouteManifestEntry;
-  entryName: string;
-  source: string;
+  route: RouteManifestEntry
+  entryName: string
+  source: string
 }
 
 interface SurfaceGroup {
-  signature: string;
-  facts: ClientRuntimeFacts;
-  entries: ClientEntry[];
+  signature: string
+  facts: ClientRuntimeFacts
+  entries: ClientEntry[]
 }
 
 interface BuiltEntryGroup {
-  group: SurfaceGroup;
-  metafile: Metafile | undefined;
-  prebuilt: PreparedPrebuilt | undefined;
+  group: SurfaceGroup
+  metafile: Metafile | undefined
+  prebuilt: PreparedPrebuilt | undefined
 }
 
 /**
@@ -704,16 +721,16 @@ function surfaceGroups(
       })),
       nextCompatEnabled(config),
       !members.every(entry => routeSuspenseFree(config, entry.route)),
-    );
+    )
   // eslint-disable-next-line turbo/no-undeclared-env-vars
   if (!prebuiltEnabled() || process.env.PNEXT_PREBUILT_GROUPS === '0')
-    return [{ signature: '', facts: facts(entries), entries }];
-  const bySignature = new Map<string, ClientEntry[]>();
+    return [{ signature: '', facts: facts(entries), entries }]
+  const bySignature = new Map<string, ClientEntry[]>()
   for (const entry of entries) {
-    const signature = surfaceSignature(config, entry.route, routeUsesActions(entry.route, actions));
-    const members = bySignature.get(signature) ?? [];
-    bySignature.set(signature, members);
-    members.push(entry);
+    const signature = surfaceSignature(config, entry.route, routeUsesActions(entry.route, actions))
+    const members = bySignature.get(signature) ?? []
+    bySignature.set(signature, members)
+    members.push(entry)
   }
   return [...bySignature].map(([signature, members]) => ({
     signature,
@@ -722,7 +739,7 @@ function surfaceGroups(
     // no route in this group has.
     facts: facts(members),
     entries: members,
-  }));
+  }))
 }
 
 async function buildEntryGroup({
@@ -733,62 +750,69 @@ async function buildEntryGroup({
   pipeline,
   verbose,
 }: {
-  config: ResolvedConfig;
-  outDir: string;
+  config: ResolvedConfig
+  outDir: string
   /** Every entry in the app: the batch fallback and `sourceOf` span groups. */
-  entries: ClientEntry[];
-  group: SurfaceGroup;
-  pipeline: ClientSourcePipeline;
-  verbose?: boolean;
+  entries: ClientEntry[]
+  group: SurfaceGroup
+  pipeline: ClientSourcePipeline
+  verbose?: boolean
 }): Promise<BuiltEntryGroup> {
-  const reactLite = group.facts.suspense === false;
+  const reactLite = group.facts.suspense === false
   const prebuilt = await clientProfile.timeAsync('prebuilt', () =>
     preparePrebuilt(
       config,
       outDir,
       false,
       importer => {
-        if (importer === CLIENT_RUNTIME_MODULE) return clientRuntimeSource(group.facts);
-        const entry = entries.find(item => item.route.id === importer);
-        return entry?.source ?? pipeline.sourceOf(importer) ?? readTextSyncSafe(importer);
+        if (importer === CLIENT_RUNTIME_MODULE) return clientRuntimeSource(group.facts)
+        const entry = entries.find(item => item.route.id === importer)
+        return entry?.source ?? pipeline.sourceOf(importer) ?? readTextSyncSafe(importer)
       },
       group.signature,
       reactLite,
     ),
-  );
+  )
 
-  let metafile: Metafile | undefined;
+  let metafile: Metafile | undefined
   try {
-    const result = await clientProfile.timeAsync('esbuild', () => build({
-      ...baseClientBuildOptions(config),
-      entryPoints: group.entries.map(entry => ({
-        in: virtualEntryPath(entry.route.id),
-        out: entry.entryName,
-      })),
-      outdir: outDir,
-      metafile: true,
-      plugins: clientBuildPlugins(config, pipeline, [
-        ...(prebuilt ? [prebuilt.plugin] : []),
-        virtualEntryPlugin(group.entries),
-        clientRuntimePlugin(group.facts),
-      ], reactLite),
-    }));
-    metafile = result.metafile;
+    const result = await clientProfile.timeAsync('esbuild', () =>
+      build({
+        ...baseClientBuildOptions(config),
+        entryPoints: group.entries.map(entry => ({
+          in: virtualEntryPath(entry.route.id),
+          out: entry.entryName,
+        })),
+        outdir: outDir,
+        metafile: true,
+        plugins: clientBuildPlugins(
+          config,
+          pipeline,
+          [
+            ...(prebuilt ? [prebuilt.plugin] : []),
+            virtualEntryPlugin(group.entries),
+            clientRuntimePlugin(group.facts),
+          ],
+          reactLite,
+        ),
+      }),
+    )
+    metafile = result.metafile
   } catch (error) {
     // A batched build cannot attribute a "Could not resolve" error to a single route, so fall back to
     // per-route builds - the offending route then throws with its precise client import trace. Other
     // diagnostics already carry a clear message from the batch build; re-throw rather than let a
     // per-route build surface a more confusing downstream error.
-    if (!hasUnresolvedImportError(error)) throw error;
+    if (!hasUnresolvedImportError(error)) throw error
     for (const { route } of group.entries) {
-      await buildClientEntry({ config, route, outDir });
+      await buildClientEntry({ config, route, outDir })
     }
-    throw error;
+    throw error
   }
-  await clientProfile.timeAsync('prebuiltSettle', () => prebuilt?.settle() ?? Promise.resolve());
+  await clientProfile.timeAsync('prebuiltSettle', () => prebuilt?.settle() ?? Promise.resolve())
 
-  if (verbose && metafile) reportClientBundleSizes(group.entries, metafile, outDir);
-  return { group, metafile, prebuilt };
+  if (verbose && metafile) reportClientBundleSizes(group.entries, metafile, outDir)
+  return { group, metafile, prebuilt }
 }
 
 /**
@@ -802,11 +826,11 @@ async function buildEntryGroup({
  * Memoized per build; a group of routes qualifies iff every member does.
  */
 function routeSuspenseFree(config: ResolvedConfig, route: RouteManifestEntry): boolean {
-  if (!nextCompatEnabled(config)) return false;
+  if (!nextCompatEnabled(config)) return false
   return memoConvention(`suspenseFree:${route.id}`, () => {
-    const seeds: string[] = [];
-    if (route.client) seeds.push(route.file);
-    for (const reference of route.clientReferences) seeds.push(reference.file);
+    const seeds: string[] = []
+    if (route.client) seeds.push(route.file)
+    for (const reference of route.clientReferences) seeds.push(reference.file)
     for (const file of [
       routeErrorFile(config, route),
       globalErrorFile(config),
@@ -814,19 +838,19 @@ function routeSuspenseFree(config: ResolvedConfig, route: RouteManifestEntry): b
       // Shell layouts hydrate client-side only when the root layout is 'use client'.
       ...(hasClientRootLayout(config, route) ? shellLayoutOrder(config, route) : []),
     ]) {
-      if (file) seeds.push(file);
+      if (file) seeds.push(file)
     }
-    return clientSuspenseFree(seeds);
-  });
+    return clientSuspenseFree(seeds)
+  })
 }
 
 function routeClientSources(routes: RouteManifestEntry[]) {
-  const files = new Set<string>();
+  const files = new Set<string>()
   for (const route of routes) {
-    if (route.client) files.add(route.file);
-    for (const reference of route.clientReferences) files.add(reference.file);
+    if (route.client) files.add(route.file)
+    for (const reference of route.clientReferences) files.add(reference.file)
   }
-  return files;
+  return files
 }
 
 // Record each entry's static chunk closure on the route so rendered pages can
@@ -839,58 +863,58 @@ function assignClientEntryImports(
   renames: Map<string, string>,
   prebuilt: PreparedPrebuilt | undefined,
 ) {
-  const outputs = metafile.outputs;
+  const outputs = metafile.outputs
   // One basename index for the whole entry set: the linear scan this replaces
   // was O(entries × outputs), which on a route-per-page app is the entire
   // output list walked once per route.
-  const byBasename = new Map<string, string>();
+  const byBasename = new Map<string, string>()
   for (const item of Object.keys(outputs)) {
     // First match wins, as the linear scan did.
-    const basename = path.basename(item);
-    if (!byBasename.has(basename)) byBasename.set(basename, item);
+    const basename = path.basename(item)
+    if (!byBasename.has(basename)) byBasename.set(basename, item)
   }
   for (const { route, entryName } of entries) {
-    const entryOutput = byBasename.get(`${entryName}.js`);
-    if (!entryOutput) continue;
-    const staticImports = new Set<string>();
-    const dynamicImports = new Set<string>();
-    const visited = new Set([`${entryOutput}:static`]);
-    const queue = [{ output: entryOutput, dynamic: false }];
+    const entryOutput = byBasename.get(`${entryName}.js`)
+    if (!entryOutput) continue
+    const staticImports = new Set<string>()
+    const dynamicImports = new Set<string>()
+    const visited = new Set([`${entryOutput}:static`])
+    const queue = [{ output: entryOutput, dynamic: false }]
     // eslint-disable-next-line @typescript-eslint/prefer-for-of
     for (let head = 0; head < queue.length; head += 1) {
-      const current = queue[head];
-      if (!current) continue;
+      const current = queue[head]
+      if (!current) continue
       for (const imported of outputs[current.output]?.imports ?? []) {
-        if (imported.kind !== 'import-statement' && imported.kind !== 'dynamic-import') continue;
-        const dynamic = current.dynamic || imported.kind === 'dynamic-import';
-        const visitKey = `${imported.path}:${dynamic ? 'dynamic' : 'static'}`;
-        if (visited.has(visitKey)) continue;
-        visited.add(visitKey);
+        if (imported.kind !== 'import-statement' && imported.kind !== 'dynamic-import') continue
+        const dynamic = current.dynamic || imported.kind === 'dynamic-import'
+        const visitKey = `${imported.path}:${dynamic ? 'dynamic' : 'static'}`
+        if (visited.has(visitKey)) continue
+        visited.add(visitKey)
         // Prebuilt-runtime shims are external: already a url relative to the
         // assets root, and with no output in THIS metafile to walk into. Their
         // own chunk closure comes from the artifact's manifest instead, so the
         // page preloads the whole set rather than discovering chunks one
         // round trip after the shim lands.
         if (imported.external) {
-          if (!prebuilt || imported.path !== prebuiltModuleUrl(prebuilt.runtime)) continue;
-          const assets = prebuiltAssets(prebuilt.runtime);
-          for (const asset of assets.static) (dynamic ? dynamicImports : staticImports).add(asset);
-          for (const asset of assets.dynamic) dynamicImports.add(asset);
-          continue;
+          if (!prebuilt || imported.path !== prebuiltModuleUrl(prebuilt.runtime)) continue
+          const assets = prebuiltAssets(prebuilt.runtime)
+          for (const asset of assets.static) (dynamic ? dynamicImports : staticImports).add(asset)
+          for (const asset of assets.dynamic) dynamicImports.add(asset)
+          continue
         }
-        queue.push({ output: imported.path, dynamic });
-        const basename = path.basename(imported.path);
-        const relative = path.relative(outDir, path.resolve(imported.path));
+        queue.push({ output: imported.path, dynamic })
+        const basename = path.basename(imported.path)
+        const relative = path.relative(outDir, path.resolve(imported.path))
         const publicRelative = path
           .join('assets', path.dirname(relative), renames.get(basename) ?? basename)
           .split(path.sep)
-          .join('/');
-        (dynamic ? dynamicImports : staticImports).add(publicRelative);
+          .join('/')
+        ;(dynamic ? dynamicImports : staticImports).add(publicRelative)
       }
     }
-    if (staticImports.size > 0) route.clientEntryImports = [...staticImports];
-    for (const asset of staticImports) dynamicImports.delete(asset);
-    if (dynamicImports.size > 0) route.clientDynamicImports = [...dynamicImports];
+    if (staticImports.size > 0) route.clientEntryImports = [...staticImports]
+    for (const asset of staticImports) dynamicImports.delete(asset)
+    if (dynamicImports.size > 0) route.clientDynamicImports = [...dynamicImports]
   }
 }
 
@@ -905,62 +929,62 @@ function reportClientBundleSizes(
   metafile: Metafile,
   outDir: string,
 ) {
-  const log = createVerboseLogger(true, 'client');
-  const outputs = metafile.outputs;
+  const log = createVerboseLogger(true, 'client')
+  const outputs = metafile.outputs
   const rows = entries
     .map(({ route, entryName }) => {
-      const key = `${path.relative(process.cwd(), path.join(outDir, `${entryName}.js`))}`;
+      const key = `${path.relative(process.cwd(), path.join(outDir, `${entryName}.js`))}`
       const output = outputs[key]
         ? key
-        : Object.keys(outputs).find(item => path.basename(item) === `${entryName}.js`);
-      const bytes = output ? reachableOutputBytes(output, outputs) : 0;
-      return { route: route.route, bytes };
+        : Object.keys(outputs).find(item => path.basename(item) === `${entryName}.js`)
+      const bytes = output ? reachableOutputBytes(output, outputs) : 0
+      return { route: route.route, bytes }
     })
-    .sort((a, b) => b.bytes - a.bytes);
+    .sort((a, b) => b.bytes - a.bytes)
 
   for (const row of rows) {
-    log.log(`${row.route} ${dimText(`→ ${formatBytes(row.bytes)}`)}`);
+    log.log(`${row.route} ${dimText(`→ ${formatBytes(row.bytes)}`)}`)
   }
 }
 
 function reachableOutputBytes(entry: string, outputs: Metafile['outputs']) {
-  const visited = new Set<string>();
-  const queue = [entry];
-  let bytes = 0;
+  const visited = new Set<string>()
+  const queue = [entry]
+  let bytes = 0
 
   while (queue.length > 0) {
-    const current = queue.shift();
-    if (!current || visited.has(current)) continue;
-    visited.add(current);
-    const output = outputs[current];
-    if (!output) continue;
-    bytes += output.bytes;
+    const current = queue.shift()
+    if (!current || visited.has(current)) continue
+    visited.add(current)
+    const output = outputs[current]
+    if (!output) continue
+    bytes += output.bytes
     for (const imported of output.imports) {
       if (imported.kind === 'import-statement' || imported.kind === 'dynamic-import') {
-        queue.push(imported.path);
+        queue.push(imported.path)
       }
     }
   }
 
-  return bytes;
+  return bytes
 }
 
 function formatBytes(bytes: number) {
-  if (bytes < 1024) return `${bytes} B`;
-  const units = ['KB', 'MB'] as const;
-  let value = bytes / 1024;
-  let unitIndex = 0;
+  if (bytes < 1024) return `${bytes} B`
+  const units = ['KB', 'MB'] as const
+  let value = bytes / 1024
+  let unitIndex = 0
   while (value >= 1024 && unitIndex < units.length - 1) {
-    value /= 1024;
-    unitIndex += 1;
+    value /= 1024
+    unitIndex += 1
   }
-  return `${value >= 10 ? value.toFixed(1) : value.toFixed(2)} ${units[unitIndex]}`;
+  return `${value >= 10 ? value.toFixed(1) : value.toFixed(2)} ${units[unitIndex]}`
 }
 
 function baseClientBuildOptions(config: ResolvedConfig, dev = false): BuildOptions {
-  const extensions = getBundlerExtensions();
-  const pure = extensions.clientPureFunctions(config);
-  const inject = extensions.clientInjects();
+  const extensions = getBundlerExtensions()
+  const pure = extensions.clientPureFunctions(config)
+  const inject = extensions.clientInjects()
   return {
     ...(inject.length > 0 ? { inject } : {}),
     chunkNames: 'chunks/[name]-[hash]',
@@ -1003,15 +1027,15 @@ function baseClientBuildOptions(config: ResolvedConfig, dev = false): BuildOptio
       '.otf': 'file',
       '.eot': 'file',
     },
-  };
+  }
 }
 
 function deploymentIdDefine(): Record<string, string> {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
-  const deploymentId = process.env.NEXT_DEPLOYMENT_ID;
+  const deploymentId = process.env.NEXT_DEPLOYMENT_ID
   return deploymentId === undefined
     ? {}
-    : { 'process.env.NEXT_DEPLOYMENT_ID': JSON.stringify(deploymentId) };
+    : { 'process.env.NEXT_DEPLOYMENT_ID': JSON.stringify(deploymentId) }
 }
 
 /**
@@ -1021,28 +1045,29 @@ function deploymentIdDefine(): Record<string, string> {
  * slow" from "we are answering 40k questions". Off unless PNEXT_CLIENT_PROFILE.
  */
 function instrumentedPlugins(plugins: Plugin[]): Plugin[] {
-  if (!clientProfile.enabled) return plugins;
+  if (!clientProfile.enabled) return plugins
   return plugins.map(plugin => ({
     name: plugin.name,
     setup(build) {
-      const wrap = (kind: 'resolve' | 'load', register: (options: any, cb: any) => void) =>
+      const wrap =
+        (kind: 'resolve' | 'load', register: (options: any, cb: any) => void) =>
         (options: any, callback: any) =>
           register(options, async (args: any) => {
-            clientProfile.count(`${plugin.name}:${kind}#`);
-            const start = performance.now();
+            clientProfile.count(`${plugin.name}:${kind}#`)
+            const start = performance.now()
             try {
-              return await (callback as (a: unknown) => unknown)(args);
+              return await (callback as (a: unknown) => unknown)(args)
             } finally {
-              clientProfile.count(`${plugin.name}:${kind}ms`, performance.now() - start);
+              clientProfile.count(`${plugin.name}:${kind}ms`, performance.now() - start)
             }
-          });
+          })
       return plugin.setup({
         ...build,
         onResolve: wrap('resolve', build.onResolve.bind(build)),
         onLoad: wrap('load', build.onLoad.bind(build)),
-      });
+      })
     },
-  }));
+  }))
 }
 
 /**
@@ -1057,49 +1082,52 @@ function instrumentedPlugins(plugins: Plugin[]): Plugin[] {
  */
 export function coalesceResolveHooks(plugins: Plugin[], name: string): Plugin[] {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
-  if (process.env.PNEXT_CLIENT_COALESCE === '0') return plugins;
+  if (process.env.PNEXT_CLIENT_COALESCE === '0') return plugins
   interface Registration {
-    plugin: string;
-    filter: RegExp;
-    namespace?: string;
-    callback: (args: OnResolveArgs) => unknown;
+    plugin: string
+    filter: RegExp
+    namespace?: string
+    callback: (args: OnResolveArgs) => unknown
   }
   return [
     {
       name,
       async setup(build) {
-        const registered: Registration[] = [];
+        const registered: Registration[] = []
         // Registrations made after setup (rare, and esbuild allows it) keep
         // their own hook: the chain's order is already fixed by then.
-        let sealed = false;
+        let sealed = false
         /** The chain, minus one plugin's own hooks — see `resolve` below. */
         const dispatch = async (args: OnResolveArgs, skip?: string) => {
           for (const entry of registered) {
-            if (entry.plugin === skip) continue;
-            if (entry.namespace !== undefined && entry.namespace !== args.namespace) continue;
-            if (!entry.filter.test(args.path)) continue;
-            const result = (await entry.callback(args)) as OnResolveResult | null | undefined;
-            if (result == null) continue;
+            if (entry.plugin === skip) continue
+            if (entry.namespace !== undefined && entry.namespace !== args.namespace) continue
+            if (!entry.filter.test(args.path)) continue
+            const result = (await entry.callback(args)) as OnResolveResult | null | undefined
+            if (result == null) continue
             for (const message of [...(result.errors ?? []), ...(result.warnings ?? [])]) {
-              message.pluginName ??= entry.plugin;
+              message.pluginName ??= entry.plugin
             }
-            return result;
+            return result
           }
-          return undefined;
-        };
+          return undefined
+        }
         for (const plugin of plugins) {
           const proxy: PluginBuild = {
             ...build,
             onResolve(options: OnResolveOptions, callback: (args: OnResolveArgs) => unknown) {
-              if (sealed) return build.onResolve(options, callback as never);
+              if (sealed) return build.onResolve(options, callback as never)
               registered.push({
                 plugin: plugin.name,
                 // Drop /g and /y: a sticky or global regex carries lastIndex
                 // between tests, which would make dispatch order-dependent.
-                filter: new RegExp(options.filter.source, options.filter.flags.replace(/[gy]/g, '')),
+                filter: new RegExp(
+                  options.filter.source,
+                  options.filter.flags.replace(/[gy]/g, ''),
+                ),
                 namespace: options.namespace,
                 callback,
-              });
+              })
             },
             // esbuild's own `resolve` re-runs every plugin EXCEPT the caller's (its recursion guard,
             // keyed on plugin name). Sharing one name would make it skip the whole chain and fall
@@ -1122,16 +1150,16 @@ export function coalesceResolveHooks(plugins: Plugin[], name: string): Plugin[]
                   ? resolvedFromHook(specifier, result)
                   : build.resolve(specifier, { ...options, pluginName: name }),
               ),
-          };
-          await plugin.setup(proxy);
+          }
+          await plugin.setup(proxy)
         }
-        sealed = true;
-        if (registered.length === 0) return;
-        const filter = new RegExp(registered.map(entry => `(?:${entry.filter.source})`).join('|'));
-        build.onResolve({ filter }, args => dispatch(args));
+        sealed = true
+        if (registered.length === 0) return
+        const filter = new RegExp(registered.map(entry => `(?:${entry.filter.source})`).join('|'))
+        build.onResolve({ filter }, args => dispatch(args))
       },
     },
-  ];
+  ]
 }
 
 /**
@@ -1139,7 +1167,7 @@ export function coalesceResolveHooks(plugins: Plugin[], name: string): Plugin[]
  * this specifier, do not bundle it" - esbuild's own rule, verified against the binary.
  */
 function resolvedFromHook(specifier: string, result: OnResolveResult): ResolveResult {
-  const resolved = result.path ?? (result.external ? specifier : '');
+  const resolved = result.path ?? (result.external ? specifier : '')
   return {
     errors: (result.errors ?? []) as ResolveResult['errors'],
     warnings: (result.warnings ?? []) as ResolveResult['warnings'],
@@ -1149,7 +1177,7 @@ function resolvedFromHook(specifier: string, result: OnResolveResult): ResolveRe
     namespace: result.namespace ?? (result.path ? 'file' : ''),
     suffix: result.suffix ?? '',
     pluginData: result.pluginData as unknown,
-  };
+  }
 }
 
 /**
@@ -1163,7 +1191,7 @@ function resolveHookSettled(result: OnResolveResult) {
     result.external !== undefined ||
     (result.errors?.length ?? 0) > 0 ||
     (result.warnings?.length ?? 0) > 0
-  );
+  )
 }
 
 function clientBuildPlugins(
@@ -1172,55 +1200,66 @@ function clientBuildPlugins(
   extra: Plugin[] = [],
   reactLite = false,
 ): Plugin[] {
-  return coalesceResolveHooks(instrumentedPlugins([
-    serverOnlyClientImportPlugin(),
-    // The virtual-module plugins (`extra`: generated entries + the shared route
-    // runtime) go first so they claim their own synthetic specifiers before the
-    // resolve-chain plugins are asked about them — one entry point per route is
-    // otherwise offered to every plugin in the chain that only ever declines it.
-    ...extra,
-    ...getBundlerExtensions().clientEsbuildPlugins(config),
-    linkedPackageClientResolvePlugin(config),
-    clientStaticAssetPlugin(config),
-    pipeline.plugin(),
-    importAliasPlugin(config, reactLite),
-    cssModuleClientPlugin(),
-  ]), 'pnext-client-resolve-chain');
+  return coalesceResolveHooks(
+    instrumentedPlugins([
+      serverOnlyClientImportPlugin(),
+      // The virtual-module plugins (`extra`: generated entries + the shared route
+      // runtime) go first so they claim their own synthetic specifiers before the
+      // resolve-chain plugins are asked about them — one entry point per route is
+      // otherwise offered to every plugin in the chain that only ever declines it.
+      ...extra,
+      ...getBundlerExtensions().clientEsbuildPlugins(config),
+      linkedPackageClientResolvePlugin(config),
+      clientStaticAssetPlugin(config),
+      pipeline.plugin(),
+      importAliasPlugin(config, reactLite),
+      cssModuleClientPlugin(),
+    ]),
+    'pnext-client-resolve-chain',
+  )
 }
 
 function importAliasPlugin(config: ResolvedConfig, reactLite = false): Plugin {
-  const aliases = { ...getImportAliasExtensions().aliases(config, 'client') };
+  // preact core/hooks/jsx-runtime are single-instance, compat or not: an app with its
+  // own `preact` in node_modules otherwise bundles a second physical copy next to the
+  // framework's, and hooks called from framework components (Link) read a null current
+  // component off options the app's copy never installed. The server runtime pins the
+  // same set unconditionally (loader's coreAliases); the client build must match.
+  const aliases: Record<string, string> = {
+    ...frameworkRuntimeAliasEntries(),
+    ...getImportAliasExtensions().aliases(config, 'client'),
+  }
   // Suspense-free tier: the app's `react` imports resolve to the compat-free lite shim, so the
   // bundle ships preact core + hooks without preact/compat (see clientSuspenseFree).
   if (reactLite && aliases.react) {
-    aliases.react = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'client-lite.ts');
+    aliases.react = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'client-lite.ts')
   }
-  const specifiers = Object.keys(aliases);
+  const specifiers = Object.keys(aliases)
   return {
     name: 'pnext-import-alias',
     setup(build) {
       build.onResolve({ filter: /^(?:react(?:-dom)?|next)(?:\/|$)/ }, args => {
-        if (aliases[args.path]) return undefined;
-        const message = getImportAliasExtensions().missingImportError(config, args.path);
-        return message ? { errors: [{ text: message }] } : undefined;
-      });
-      if (specifiers.length === 0) return;
+        if (aliases[args.path]) return undefined
+        const message = getImportAliasExtensions().missingImportError(config, args.path)
+        return message ? { errors: [{ text: message }] } : undefined
+      })
+      if (specifiers.length === 0) return
       build.onResolve(
         { filter: new RegExp(`^(${specifiers.map(escapeRegex).join('|')})$`) },
         async args => {
-          const target = aliases[args.path];
-          if (!target) return undefined;
-          if (path.isAbsolute(target)) return { path: target };
+          const target = aliases[args.path]
+          if (!target) return undefined
+          if (path.isAbsolute(target)) return { path: target }
           return build.resolve(target, {
             kind: args.kind,
             importer: args.importer,
             namespace: args.namespace,
             resolveDir: args.resolveDir,
-          });
+          })
         },
-      );
+      )
     },
-  };
+  }
 }
 
 // preact core + preact/compat + react/react-dom/next are single-instance: they must ALWAYS resolve
@@ -1230,11 +1269,11 @@ function importAliasPlugin(config: ResolvedConfig, reactLite = false): Plugin {
 // `preact` to the linked copy while pnext-internal compat code keeps resolving to the alias -
 // shipping TWO physical preact cores. That breaks single-instance option hooks, context identity and
 // error interception. Never let the linked-package resolver shadow these; the alias owns them.
-const frameworkAliasedSpecifier = /^(?:preact|react|react-dom|next)(?:\/|$)/;
+const frameworkAliasedSpecifier = /^(?:preact|react|react-dom|next)(?:\/|$)/
 
 function linkedPackageClientResolvePlugin(config: ResolvedConfig): Plugin {
-  const compatPreact = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'preact.ts');
-  const compatReactClient = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'client.ts');
+  const compatPreact = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'preact.ts')
+  const compatReactClient = path.resolve(import.meta.dirname, '..', 'compat', 'react', 'client.ts')
   return {
     name: 'pnext-linked-package-client-resolve',
     setup(build) {
@@ -1243,36 +1282,36 @@ function linkedPackageClientResolvePlugin(config: ResolvedConfig): Plugin {
         // outputs under node_modules paths, e.g. @next/third-parties client
         // components) where no sibling ./preact exists; only a real sibling
         // file (an app's own ./preact.*) opts out.
-        if (path.resolve(args.importer) === compatReactClient) return { path: compatPreact };
+        if (path.resolve(args.importer) === compatReactClient) return { path: compatPreact }
         const hasRealSibling = ['.ts', '.tsx', '.js', '.mjs', '.jsx'].some(ext =>
           existsSync(path.join(args.resolveDir, `preact${ext}`)),
-        );
-        if (hasRealSibling) return undefined;
-        return { path: compatPreact };
-      });
+        )
+        if (hasRealSibling) return undefined
+        return { path: compatPreact }
+      })
       // One build's worth of memo, keyed on exactly what esbuild hands us: the resolver walks
       // node_modules and probes package targets per call, and a directory of components importing
       // the same few packages asks the same question repeatedly. Per-BUILD, so a linked package's
       // layout changing between builds is still seen - esbuild already assumes it is fixed within one.
-      const linked = new Map<string, string | undefined>();
+      const linked = new Map<string, string | undefined>()
       build.onResolve({ filter: /^[^./#][^:]*$/ }, args => {
-        if (frameworkAliasedSpecifier.test(args.path)) return undefined;
-        const dir = args.resolveDir || config.root;
-        const key = `${dir}\0${args.path}`;
-        let resolved = linked.get(key);
+        if (frameworkAliasedSpecifier.test(args.path)) return undefined
+        const dir = args.resolveDir || config.root
+        const key = `${dir}\0${args.path}`
+        let resolved = linked.get(key)
         if (resolved === undefined && !linked.has(key)) {
           resolved = resolveLinkedPackageSpecifier(
             config.root,
             path.join(dir, 'pnext-resolve.ts'),
             args.path,
             ['browser', 'style', 'import', 'default'],
-          );
-          linked.set(key, resolved);
+          )
+          linked.set(key, resolved)
         }
-        return resolved ? { path: resolved } : undefined;
-      });
+        return resolved ? { path: resolved } : undefined
+      })
     },
-  };
+  }
 }
 
 // Mirror of the server build's static-asset seam for the CLIENT bundle. A static image import from a
@@ -1280,7 +1319,7 @@ function linkedPackageClientResolvePlugin(config: ResolvedConfig): Plugin {
 // object - with the asset emitted under `/_next/static/media/...` - rather than a bare `file` loader
 // URL string. Uses core's `staticAssetModule` extension seam so compat (next/image) supplies the
 // descriptor and pure-core apps fall back to the generic URL module.
-const staticImageAssetFilter = /\.(?:png|jpe?g|gif|webp|avif|svg|ico|bmp)(?:$|[?#])/;
+const staticImageAssetFilter = /\.(?:png|jpe?g|gif|webp|avif|svg|ico|bmp)(?:$|[?#])/
 
 function clientStaticAssetPlugin(config: ResolvedConfig): Plugin {
   return {
@@ -1291,66 +1330,66 @@ function clientStaticAssetPlugin(config: ResolvedConfig): Plugin {
         // `*.svg`) preempts the generic static-image resolver: defer so the
         // compat loader-rule plugin runs the chain instead.
         if (getAssetExtensions().hasLoaderRuleFor(args.path)) {
-          return undefined;
+          return undefined
         }
         return {
           path: resolveAssetPath(args.path, args.resolveDir),
           namespace: 'pnext-client-static-asset',
-        };
-      });
+        }
+      })
       build.onLoad({ filter: /.*/, namespace: 'pnext-client-static-asset' }, async args => ({
         contents: await staticImageModuleSource(config, args.path),
         loader: 'js',
-      }));
+      }))
     },
-  };
+  }
 }
 
 function resolveAssetPath(specifier: string, resolveDir: string) {
-  const { sourcePath, hash } = splitAssetHash(specifier);
-  const resolved = path.isAbsolute(sourcePath) ? sourcePath : path.resolve(resolveDir, sourcePath);
-  return `${resolved}${hash}`;
+  const { sourcePath, hash } = splitAssetHash(specifier)
+  const resolved = path.isAbsolute(sourcePath) ? sourcePath : path.resolve(resolveDir, sourcePath)
+  return `${resolved}${hash}`
 }
 
 function splitAssetHash(specifier: string) {
-  const index = specifier.search(/[?#]/);
+  const index = specifier.search(/[?#]/)
   return index === -1
     ? { sourcePath: specifier, hash: '' }
-    : { sourcePath: specifier.slice(0, index), hash: specifier.slice(index) };
+    : { sourcePath: specifier.slice(0, index), hash: specifier.slice(index) }
 }
 
 async function staticImageModuleSource(config: ResolvedConfig, file: string) {
-  const { sourcePath } = splitAssetHash(file);
-  const bytes = new Uint8Array(await readFile(sourcePath));
-  const emitted: string[] = [];
+  const { sourcePath } = splitAssetHash(file)
+  const bytes = new Uint8Array(await readFile(sourcePath))
+  const emitted: string[] = []
   const emit = (relative: string) => {
-    emitted.push(relative);
-    return `/${relative}`;
-  };
-  const compat = await getAssetExtensions().staticAssetModule({ sourcePath, bytes, emit });
-  const source = compat ?? coreStaticAssetModule(sourcePath, bytes, emit);
+    emitted.push(relative)
+    return `/${relative}`
+  }
+  const compat = await getAssetExtensions().staticAssetModule({ sourcePath, bytes, emit })
+  const source = compat ?? coreStaticAssetModule(sourcePath, bytes, emit)
   for (const relative of emitted) {
-    const target = path.join(config.outPath, 'public', ...relative.split('/'));
-    await mkdir(path.dirname(target), { recursive: true });
-    if (!existsSync(target)) await copyFile(sourcePath, target);
+    const target = path.join(config.outPath, 'public', ...relative.split('/'))
+    await mkdir(path.dirname(target), { recursive: true })
+    if (!existsSync(target)) await copyFile(sourcePath, target)
   }
-  return source;
+  return source
 }
 
 // Core's generic static-asset module (no compat override): emit under a hashed
 // `/_next/static/media` URL and export the URL string as default. Mirrors the
-// identically named helper in runtime/server.ts + dev/imports.ts.
+// identically named helper in runtime/loader.ts + runtime/modules.ts.
 function coreStaticAssetModule(
   sourcePath: string,
   bytes: Uint8Array,
   emit: (relative: string) => string,
 ): string {
-  const ext = path.extname(sourcePath).toLowerCase() || '.bin';
-  const hash = createHash('sha256').update(bytes).digest('hex').slice(0, 8);
-  const base = path.basename(sourcePath, path.extname(sourcePath)).replace(/[^A-Za-z0-9_-]+/g, '-');
-  const relative = path.posix.join('_next', 'static', 'media', `${base}.${hash}${ext}`);
-  const src = emit(relative);
-  return `const src = ${JSON.stringify(src)};\nexport default src;\nexport { src };\n`;
+  const ext = path.extname(sourcePath).toLowerCase() || '.bin'
+  const hash = createHash('sha256').update(bytes).digest('hex').slice(0, 8)
+  const base = path.basename(sourcePath, path.extname(sourcePath)).replace(/[^A-Za-z0-9_-]+/g, '-')
+  const relative = path.posix.join('_next', 'static', 'media', `${base}.${hash}${ext}`)
+  const src = emit(relative)
+  return `const src = ${JSON.stringify(src)};\nexport default src;\nexport { src };\n`
 }
 
 /**
@@ -1366,91 +1405,93 @@ function coreStaticAssetModule(
  * loader; scoped to the source roots, so third-party node_modules .js keeps esbuild's default loader.
  */
 function createClientSourcePipeline(config: ResolvedConfig, dev = false) {
-  const sourceRewrite = nextCompatEnabled(config);
-  const compiler = getCompatModeExtensions().reactCompilerOptions(config);
-  const asyncPre = hasClientSourceAsyncPreTransforms();
+  const sourceRewrite = nextCompatEnabled(config)
+  const compiler = getCompatModeExtensions().reactCompilerOptions(config)
+  const asyncPre = hasClientSourceAsyncPreTransforms()
   // Under a source root, and under a root only first-party source plus transpiled packages - said in
   // the FILTER, not the callback: a dependency's files are the bulk of a real graph, so a callback
   // would decline most of them one at a time.
-  const roots = clientSourceRoots(config).map(root => escapeRegex(root)).join('|');
-  const sep = escapeRegex(path.sep);
+  const roots = clientSourceRoots(config)
+    .map(root => escapeRegex(root))
+    .join('|')
+  const sep = escapeRegex(path.sep)
   const filter = new RegExp(
     `^(?:${roots})(?:${sep}${nonSegmentPattern('node_modules', sep)})*${sep}[^${sep}]*\\.(?:[cm]?[jt]sx?)$`,
-  );
-  const transpiled = sourceRewrite ? transpiledPackageFilter(roots) : undefined;
+  )
+  const transpiled = sourceRewrite ? transpiledPackageFilter(roots) : undefined
   // One in-flight pipeline per file for the whole build: `warm()` and the
   // onLoad hook share it, so a warmed file is already done (or in flight on
   // oxc's threadpool) by the time esbuild asks for it, and a component shared
   // by twenty routes is prepared once.
-  const prepared = new Map<string, Promise<OnLoadOutput>>();
+  const prepared = new Map<string, Promise<OnLoadOutput>>()
   // Deferred dynamic refs THIS pipeline rewrote — persisted as the out-dir sidecar.
-  const deferredRefs = new Map<string, DeferredDynamicRef>();
+  const deferredRefs = new Map<string, DeferredDynamicRef>()
   // The text esbuild actually parsed, kept so the prebuilt seam can read a
   // file's framework imports off the POST-transform source — a compat rewrite
   // can add or rename one, and the seam must offer exactly what is there.
-  const loaded = new Map<string, string>();
+  const loaded = new Map<string, string>()
 
   function prepare(resolved: string): Promise<OnLoadOutput> {
-    const existing = prepared.get(resolved);
-    if (existing) return existing;
-    const pending = runPipeline(resolved);
-    prepared.set(resolved, pending);
-    return pending;
+    const existing = prepared.get(resolved)
+    if (existing) return existing
+    const pending = runPipeline(resolved)
+    prepared.set(resolved, pending)
+    return pending
   }
 
   async function runPipeline(resolved: string): Promise<OnLoadOutput> {
-    const inNodeModules = resolved.split(path.sep).includes('node_modules');
+    const inNodeModules = resolved.split(path.sep).includes('node_modules')
     // A nested node_modules under a source root is a dependency, not app
     // source: only an explicitly transpiled package opts into the rewrites,
     // and none of them are ever React-Compiled.
-    if (inNodeModules && (!sourceRewrite || !isTranspiledPackageFile(resolved))) return undefined;
-    clientProfile.count('loadFiles');
+    if (inNodeModules && (!sourceRewrite || !isTranspiledPackageFile(resolved))) return undefined
+    clientProfile.count('loadFiles')
     // Build-scoped cache: the route-fact walk has already read most of these,
     // so this is a map lookup rather than a second read of the same file.
-    const original = await clientProfile.timeAsync('read', () => readSourceText(resolved));
-    let contents = original;
+    const original = await clientProfile.timeAsync('read', () => readSourceText(resolved))
+    let contents = original
     // Worker bundling runs first and awaits: it consumes `import.meta.url`,
     // which the sync chain inlines.
     if (asyncPre) {
-      contents = await applyClientSourceAsyncPreTransforms(contents, resolved, config.root);
+      contents = await applyClientSourceAsyncPreTransforms(contents, resolved, config.root)
     }
     contents = clientProfile.time('chain', () =>
       applyClientSourceTransforms(contents, resolved, config.root),
-    );
-    contents = clientProfile.time('dynamic', () => rewriteLiteralDynamicCalls(contents, resolved));
+    )
+    contents = clientProfile.time('dynamic', () => rewriteLiteralDynamicCalls(contents, resolved))
     if (dev && devDynamicSplitEnabled()) {
       contents = rewriteDeferredDynamicImports(
         contents,
         resolved,
         specifier => resolveImport(rootFromFile(resolved), resolved, specifier),
         target => {
-          const id = clientReferenceId(target.file, target.exportName);
-          registerDeferredDynamicRef(id, target);
-          deferredRefs.set(id, target);
-          return deferredDynamicChunkHref({ id });
+          const id = clientReferenceId(target.file, target.exportName)
+          registerDeferredDynamicRef(id, target)
+          deferredRefs.set(id, target)
+          return deferredDynamicChunkHref({ id })
         },
-      );
+      )
     }
     if (compiler && !inNodeModules && shouldReactCompile(contents, resolved)) {
       contents = await clientProfile.timeAsync('reactCompiler', () =>
         reactCompiled(resolved, contents, compiler),
-      );
+      )
     }
     // Unchanged sources go back to esbuild's native loader; only .js/.mjs
     // must be claimed to force the jsx parse.
-    loaded.set(resolved, contents);
-    if (contents === original && !/\.m?js$/.test(resolved)) return undefined;
-    return { contents, loader: clientSourceLoader(resolved) };
+    loaded.set(resolved, contents)
+    if (contents === original && !/\.m?js$/.test(resolved)) return undefined
+    return { contents, loader: clientSourceLoader(resolved) }
   }
 
   return {
     /** The parsed text of a file this build has loaded, if it has. */
     sourceOf(file: string) {
-      return loaded.get(file);
+      return loaded.get(file)
     },
     /** Deferred dynamic refs rewritten during this build (dev split). */
     deferredRefs() {
-      return deferredRefs;
+      return deferredRefs
     },
     /**
      * Start the pipeline for sources the route table already names, before esbuild runs. Without it
@@ -1459,15 +1500,15 @@ function createClientSourcePipeline(config: ResolvedConfig, dev = false) {
      */
     /** `warm` for whole routes - every client source the route table names. */
     warmRoutes(routes: RouteManifestEntry[]) {
-      this.warm(routeClientSources(routes));
+      this.warm(routeClientSources(routes))
     },
     warm(files: Iterable<string>) {
       for (const file of files) {
-        const resolved = path.resolve(file);
-        if (!filter.test(resolved) && !transpiled?.test(resolved)) continue;
+        const resolved = path.resolve(file)
+        if (!filter.test(resolved) && !transpiled?.test(resolved)) continue
         // Errors surface at the onLoad await, where esbuild attributes them to
         // the importing module; nothing must reject on the warm path.
-        prepare(resolved).catch(() => undefined);
+        prepare(resolved).catch(() => undefined)
       }
     },
     /**
@@ -1483,24 +1524,24 @@ function createClientSourcePipeline(config: ResolvedConfig, dev = false) {
           // namespace: 'file' — an onLoad without a namespace matches EVERY
           // namespace, which would hijack virtual modules (e.g. the server-action
           // client stub) whose paths end in .js and feed back the original source.
-          build.onLoad({ filter, namespace: 'file' }, args => prepare(path.resolve(args.path)));
+          build.onLoad({ filter, namespace: 'file' }, args => prepare(path.resolve(args.path)))
           // Second hook, not a wider first one: `transpilePackages` opts a
           // dependency's own files into the same pipeline, and they are the only
           // node_modules paths that ever produce contents.
           if (transpiled) {
             build.onLoad({ filter: transpiled, namespace: 'file' }, args =>
               prepare(path.resolve(args.path)),
-            );
+            )
           }
         },
-      };
+      }
     },
-  };
+  }
 }
 
-type OnLoadOutput = { contents: string; loader: 'js' | 'ts' | 'tsx' | 'jsx' } | undefined;
+type OnLoadOutput = { contents: string; loader: 'js' | 'ts' | 'tsx' | 'jsx' } | undefined
 
-export type ClientSourcePipeline = ReturnType<typeof createClientSourcePipeline>;
+export type ClientSourcePipeline = ReturnType<typeof createClientSourcePipeline>
 
 /**
  * Open the client-source pipeline early so the build can feed it routes as the fact scan resolves
@@ -1509,64 +1550,64 @@ export type ClientSourcePipeline = ReturnType<typeof createClientSourcePipeline>
  * otherwise create for itself.
  */
 export function startClientSources(config: ResolvedConfig): ClientSourcePipeline {
-  conventionCache.clear();
-  return createClientSourcePipeline(config);
+  conventionCache.clear()
+  return createClientSourcePipeline(config)
 }
 
 // The compiled-source cache is keyed on the file and a hash of its post-rewrite
 // input, so a rebuild of an unchanged file skips the oxc pass. It holds the
 // PROMISE, so two concurrent loads of the same source (two routes sharing a
 // component) share one compile instead of racing two.
-const reactCompiledCache = new Map<string, { hash: bigint; code: Promise<string> }>();
+const reactCompiledCache = new Map<string, { hash: bigint; code: Promise<string> }>()
 
 function reactCompiled(
   file: string,
   source: string,
   options: NonNullable<ReturnType<CompatModeExtensions['reactCompilerOptions']>>,
 ) {
-  const hash = Bun.hash.wyhash(`${options.target}\0${source}`);
-  const cached = reactCompiledCache.get(file);
-  if (cached?.hash === hash) return cached.code;
-  const code = transformReactCompiler(source, file, options);
-  reactCompiledCache.set(file, { hash, code });
-  return code;
+  const hash = Bun.hash.wyhash(`${options.target}\0${source}`)
+  const cached = reactCompiledCache.get(file)
+  if (cached?.hash === hash) return cached.code
+  const code = transformReactCompiler(source, file, options)
+  reactCompiledCache.set(file, { hash, code })
+  return code
 }
 
 // config.root can sit outside the workspace root (and vice versa), so both
 // anchor the filter — as does each one's realpath, since esbuild reports
 // resolved paths through the OS realpath.
 function clientSourceRoots(config: ResolvedConfig) {
-  const roots = new Set<string>();
+  const roots = new Set<string>()
   for (const root of [config.root, config.workspaceRoot]) {
-    const resolved = path.resolve(root);
-    roots.add(resolved);
+    const resolved = path.resolve(root)
+    roots.add(resolved)
     try {
-      roots.add(realpathSync.native(resolved));
+      roots.add(realpathSync.native(resolved))
     } catch {
       // A root that cannot be realpath'd is already covered by its literal form.
     }
   }
-  return [...roots];
+  return [...roots]
 }
 
 // `.cjs` keeps the plain js loader: CommonJS never carries JSX, and parsing a
 // `a < b` comparison as JSX would fail the build.
 function clientSourceLoader(file: string): 'js' | 'ts' | 'tsx' | 'jsx' {
-  if (file.endsWith('.tsx')) return 'tsx';
-  if (/\.[cm]?ts$/.test(file)) return 'ts';
-  return file.endsWith('.cjs') ? 'js' : 'jsx';
+  if (file.endsWith('.tsx')) return 'tsx'
+  if (/\.[cm]?ts$/.test(file)) return 'ts'
+  return file.endsWith('.cjs') ? 'js' : 'jsx'
 }
 
 // A path segment that is NOT `word`, spelled positively: esbuild's Go regexp has
 // no lookahead, so the negation enumerates "differs at some position / ends
 // early / runs longer".
 function nonSegmentPattern(word: string, sep: string) {
-  const parts = [`${word}[^${sep}]+`];
+  const parts = [`${word}[^${sep}]+`]
   for (let index = 0; index < word.length; index += 1) {
-    const prefix = word.slice(0, index);
-    parts.push(prefix, `${prefix}[^${sep}${word[index]}][^${sep}]*`);
+    const prefix = word.slice(0, index)
+    parts.push(prefix, `${prefix}[^${sep}${word[index]}][^${sep}]*`)
   }
-  return `(?:${parts.join('|')})`;
+  return `(?:${parts.join('|')})`
 }
 
 /**
@@ -1575,45 +1616,45 @@ function nonSegmentPattern(word: string, sep: string) {
  * path on the hook.
  */
 function transpiledPackageFilter(roots: string): RegExp | undefined {
-  const sep = escapeRegex(path.sep);
-  const names = getExternalPackagePolicy().transpiled?.();
-  if (names?.length === 0) return undefined;
+  const sep = escapeRegex(path.sep)
+  const names = getExternalPackagePolicy().transpiled?.()
+  if (names?.length === 0) return undefined
   const packages = names
     ? `(?:${names.map(name => escapeRegex(name).split('/').join(sep)).join('|')})${sep}`
-    : '';
-  return new RegExp(`^(?:${roots}).*${sep}node_modules${sep}${packages}.*\\.(?:[cm]?[jt]sx?)$`);
+    : ''
+  return new RegExp(`^(?:${roots}).*${sep}node_modules${sep}${packages}.*\\.(?:[cm]?[jt]sx?)$`)
 }
 
 function isTranspiledPackageFile(file: string) {
-  const parts = file.split(path.sep);
-  const nodeModules = parts.lastIndexOf('node_modules');
-  if (nodeModules === -1) return false;
-  const first = parts[nodeModules + 1];
-  if (!first) return false;
-  const name = first.startsWith('@') ? `${first}/${parts[nodeModules + 2] ?? ''}` : first;
-  return getExternalPackagePolicy().transpile(name);
+  const parts = file.split(path.sep)
+  const nodeModules = parts.lastIndexOf('node_modules')
+  if (nodeModules === -1) return false
+  const first = parts[nodeModules + 1]
+  if (!first) return false
+  const name = first.startsWith('@') ? `${first}/${parts[nodeModules + 2] ?? ''}` : first
+  return getExternalPackagePolicy().transpile(name)
 }
 
 function virtualEntryPath(routeId: string) {
-  return `${virtualEntryNamespace}:${routeId}`;
+  return `${virtualEntryNamespace}:${routeId}`
 }
 
 function virtualEntryPlugin(entries: { route: RouteManifestEntry; source: string }[]): Plugin {
-  const sources = new Map(entries.map(entry => [entry.route.id, entry.source]));
+  const sources = new Map(entries.map(entry => [entry.route.id, entry.source]))
   return {
     name: 'pnext-virtual-client-entry',
     setup(build) {
       build.onResolve({ filter: new RegExp(`^${escapeRegex(virtualEntryNamespace)}:`) }, args => ({
         path: args.path.slice(virtualEntryNamespace.length + 1),
         namespace: virtualEntryNamespace,
-      }));
+      }))
       build.onLoad({ filter: /.*/, namespace: virtualEntryNamespace }, args => {
-        const contents = sources.get(args.path);
-        if (contents === undefined) return undefined;
-        return { contents, loader: 'ts', resolveDir: process.cwd() };
-      });
+        const contents = sources.get(args.path)
+        if (contents === undefined) return undefined
+        return { contents, loader: 'ts', resolveDir: process.cwd() }
+      })
     },
-  };
+  }
 }
 
 // The shared route runtime: one virtual module per build, imported by every
@@ -1626,14 +1667,14 @@ function clientRuntimePlugin(facts: ClientRuntimeFacts): Plugin {
       build.onResolve({ filter: new RegExp(`^${escapeRegex(CLIENT_RUNTIME_MODULE)}$`) }, () => ({
         path: CLIENT_RUNTIME_MODULE,
         namespace: CLIENT_RUNTIME_MODULE,
-      }));
+      }))
       build.onLoad({ filter: /.*/, namespace: CLIENT_RUNTIME_MODULE }, () => ({
         contents: clientRuntimeSource(facts),
         loader: 'ts',
         resolveDir: process.cwd(),
-      }));
+      }))
     },
-  };
+  }
 }
 
 async function profileClientBuild<T>(
@@ -1642,25 +1683,18 @@ async function profileClientBuild<T>(
   task: () => Promise<T>,
 ) {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
-  if (!process.env.PNEXT_DEV_PROFILE) return task();
-  const start = performance.now();
+  if (!process.env.PNEXT_DEV_PROFILE) return task()
+  const start = performance.now()
   try {
-    return await task();
+    return await task()
   } finally {
-    const mode = dev ? 'dev' : 'prod';
+    const mode = dev ? 'dev' : 'prod'
     console.log(
       `dev-profile client build ${mode} ${route.route} in ${formatDuration(performance.now() - start)}`,
-    );
+    )
   }
 }
 
-function formatDuration(durationMs: number) {
-  const ms = Math.max(0, durationMs);
-  if (ms < 10) return `${ms.toFixed(1)}ms`;
-  if (ms < 1000) return `${Math.round(ms)}ms`;
-  return `${(ms / 1000).toFixed(ms < 10000 ? 2 : 1)}s`;
-}
-
 function serverOnlyClientImportPlugin(): Plugin {
   return {
     name: 'pnext-server-only-client-import',
@@ -1674,26 +1708,26 @@ function serverOnlyClientImportPlugin(): Plugin {
             },
           ],
         }),
-      );
+      )
     },
-  };
+  }
 }
 
 interface EsbuildLikeError extends Error {
   errors?: {
-    text?: string;
+    text?: string
     location?: {
-      file?: string;
-    };
-  }[];
+      file?: string
+    }
+  }[]
 }
 
 interface TraceParent {
-  file: string;
-  specifier: string;
+  file: string
+  specifier: string
 }
 
-const traceSourceExtensions = ['.tsx', '.ts', '.jsx', '.js', '.mts', '.cts', '.module.css', '.css'];
+const traceSourceExtensions = ['.tsx', '.ts', '.jsx', '.js', '.mts', '.cts', '.module.css', '.css']
 
 function withClientImportTrace(
   error: unknown,
@@ -1701,16 +1735,16 @@ function withClientImportTrace(
   route: RouteManifestEntry,
   entrySource: string,
 ) {
-  const message = error instanceof Error ? error.message : String(error);
-  const trace = clientImportTrace(config, route, entrySource, error);
-  if (!trace) return error;
-  const next = new Error(`${message}\n\n${trace}`);
+  const message = error instanceof Error ? error.message : String(error)
+  const trace = clientImportTrace(config, route, entrySource, error)
+  if (!trace) return error
+  const next = new Error(`${message}\n\n${trace}`)
   if (error instanceof Error) {
-    next.name = error.name;
-    next.stack = error.stack ? `${error.stack}\n\n${trace}` : next.stack;
-    Object.assign(next, error);
+    next.name = error.name
+    next.stack = error.stack ? `${error.stack}\n\n${trace}` : next.stack
+    Object.assign(next, error)
   }
-  return next;
+  return next
 }
 
 function clientImportTrace(
@@ -1719,51 +1753,51 @@ function clientImportTrace(
   entrySource: string,
   error: unknown,
 ) {
-  const unresolved = unresolvedImportFromError(error);
-  if (!unresolved) return undefined;
+  const unresolved = unresolvedImportFromError(error)
+  if (!unresolved) return undefined
 
-  const entryFile = `${route.id}.ts`;
-  const failedFile = unresolved.file ? resolveTraceFile(unresolved.file) : undefined;
-  const parents = new Map<string, TraceParent>();
-  const visited = new Set<string>();
-  const queue: { file: string; source: string }[] = [{ file: entryFile, source: entrySource }];
-  let unresolvedImporter: string | undefined;
+  const entryFile = `${route.id}.ts`
+  const failedFile = unresolved.file ? resolveTraceFile(unresolved.file) : undefined
+  const parents = new Map<string, TraceParent>()
+  const visited = new Set<string>()
+  const queue: { file: string; source: string }[] = [{ file: entryFile, source: entrySource }]
+  let unresolvedImporter: string | undefined
 
   while (queue.length > 0) {
-    const current = queue.shift();
-    if (!current || visited.has(current.file)) continue;
-    visited.add(current.file);
-    if (visited.size > 2000) break;
+    const current = queue.shift()
+    if (!current || visited.has(current.file)) continue
+    visited.add(current.file)
+    if (visited.size > 2000) break
 
     for (const specifier of localImports(current.file, current.source)) {
-      const resolved = resolveTraceImport(config.root, current.file, specifier);
+      const resolved = resolveTraceImport(config.root, current.file, specifier)
       if (!resolved) {
         if (
           specifier === unresolved.specifier &&
           (!failedFile || sameFile(current.file, failedFile))
         ) {
-          unresolvedImporter = current.file;
-          queue.length = 0;
-          break;
+          unresolvedImporter = current.file
+          queue.length = 0
+          break
         }
-        continue;
+        continue
       }
 
-      if (!parents.has(resolved)) parents.set(resolved, { file: current.file, specifier });
+      if (!parents.has(resolved)) parents.set(resolved, { file: current.file, specifier })
       if (failedFile && sameFile(resolved, failedFile)) {
-        unresolvedImporter = resolved;
-        queue.length = 0;
-        break;
+        unresolvedImporter = resolved
+        queue.length = 0
+        break
       }
       if (!visited.has(resolved) && !isAssetLike(resolved)) {
-        queue.push({ file: resolved, source: readTextSyncSafe(resolved) });
+        queue.push({ file: resolved, source: readTextSyncSafe(resolved) })
       }
     }
   }
 
-  if (!unresolvedImporter) return undefined;
-  const trace = tracePath(entryFile, unresolvedImporter, parents);
-  if (trace.length === 0) return undefined;
+  if (!unresolvedImporter) return undefined
+  const trace = tracePath(entryFile, unresolvedImporter, parents)
+  if (trace.length === 0) return undefined
 
   return [
     `pnext client import trace for route ${route.route}:`,
@@ -1771,135 +1805,135 @@ function clientImportTrace(
       (file, index) => `${index === 0 ? '  ' : '  -> '}${displayTraceFile(config, file)}`,
     ),
     `  -> ${unresolved.specifier} (unresolved in browser client bundle)`,
-  ].join('\n');
+  ].join('\n')
 }
 
 /** True when the build failed because an import could not be resolved. */
 function hasUnresolvedImportError(error: unknown): boolean {
-  const errors = (error as EsbuildLikeError).errors;
+  const errors = (error as EsbuildLikeError).errors
   if (Array.isArray(errors)) {
-    return errors.some(item => item.text?.startsWith('Could not resolve '));
+    return errors.some(item => item.text?.startsWith('Could not resolve '))
   }
-  const message = error instanceof Error ? error.message : String(error);
-  return message.includes('Could not resolve ');
+  const message = error instanceof Error ? error.message : String(error)
+  return message.includes('Could not resolve ')
 }
 
 function unresolvedImportFromError(error: unknown) {
-  const buildError = error as EsbuildLikeError;
-  const diagnostic = buildError.errors?.find(item => item.text?.startsWith('Could not resolve '));
-  const message = error instanceof Error ? error.message : String(error);
-  const text = diagnostic?.text ?? message;
-  const specifier = /Could not resolve "([^"]+)"/.exec(text)?.[1];
-  if (!specifier) return undefined;
+  const buildError = error as EsbuildLikeError
+  const diagnostic = buildError.errors?.find(item => item.text?.startsWith('Could not resolve '))
+  const message = error instanceof Error ? error.message : String(error)
+  const text = diagnostic?.text ?? message
+  const specifier = /Could not resolve "([^"]+)"/.exec(text)?.[1]
+  if (!specifier) return undefined
   return {
     specifier,
     file: diagnostic?.location?.file ?? errorFileFromMessage(message),
-  };
+  }
 }
 
 function errorFileFromMessage(message: string) {
-  const match = /\n\s+([^:\n]+):\d+:\d+:\s+ERROR:\s+Could not resolve /.exec(message);
-  return match?.[1];
+  const match = /\n\s+([^:\n]+):\d+:\d+:\s+ERROR:\s+Could not resolve /.exec(message)
+  return match?.[1]
 }
 
 function resolveTraceImport(root: string, fromFile: string, specifier: string) {
-  if (path.isAbsolute(specifier)) return resolveTraceCandidate(specifier);
-  return resolveImport(root, fromFile, specifier);
+  if (path.isAbsolute(specifier)) return resolveTraceCandidate(specifier)
+  return resolveImport(root, fromFile, specifier)
 }
 
 function resolveTraceFile(file: string) {
   return canonicalTraceFile(
     path.isAbsolute(file) ? path.resolve(file) : path.resolve(process.cwd(), file),
-  );
+  )
 }
 
 function resolveTraceCandidate(base: string) {
-  const ext = path.extname(base);
+  const ext = path.extname(base)
   const candidates = ext
     ? [base]
     : [
         ...traceSourceExtensions.map(extension => `${base}${extension}`),
         ...traceSourceExtensions.map(extension => path.join(base, `index${extension}`)),
         base,
-      ];
-  const resolved = candidates.find(isTraceFile);
-  return resolved ? canonicalTraceFile(resolved) : undefined;
+      ]
+  const resolved = candidates.find(isTraceFile)
+  return resolved ? canonicalTraceFile(resolved) : undefined
 }
 
 function isTraceFile(file: string) {
   try {
-    return statSync(file).isFile();
+    return statSync(file).isFile()
   } catch {
-    return false;
+    return false
   }
 }
 
 function readTextSyncSafe(file: string) {
   try {
-    return existsSync(file) ? readFileSync(file, 'utf8') : '';
+    return existsSync(file) ? readFileSync(file, 'utf8') : ''
   } catch {
-    return '';
+    return ''
   }
 }
 
 function tracePath(entryFile: string, targetFile: string, parents: Map<string, TraceParent>) {
-  const pathItems = [targetFile];
-  let current = targetFile;
+  const pathItems = [targetFile]
+  let current = targetFile
 
   while (current !== entryFile) {
-    const parent = parents.get(current);
-    if (!parent) return [];
-    current = parent.file;
-    pathItems.push(current);
+    const parent = parents.get(current)
+    if (!parent) return []
+    current = parent.file
+    pathItems.push(current)
   }
 
-  return pathItems.reverse();
+  return pathItems.reverse()
 }
 
 function sameFile(a: string, b: string) {
-  return canonicalTraceFile(a) === canonicalTraceFile(b);
+  return canonicalTraceFile(a) === canonicalTraceFile(b)
 }
 
 function displayTraceFile(config: ResolvedConfig, file: string) {
-  if (!path.isAbsolute(file)) return `${file} (generated client entry)`;
-  const root = canonicalTraceFile(config.root);
-  const workspaceRoot = canonicalTraceFile(config.workspaceRoot);
-  const resolvedFile = canonicalTraceFile(file);
-  const rootRelative = path.relative(root, resolvedFile);
-  if (!rootRelative.startsWith('..') && !path.isAbsolute(rootRelative)) return rootRelative;
-  const workspaceRelative = path.relative(workspaceRoot, resolvedFile);
+  if (!path.isAbsolute(file)) return `${file} (generated client entry)`
+  const root = canonicalTraceFile(config.root)
+  const workspaceRoot = canonicalTraceFile(config.workspaceRoot)
+  const resolvedFile = canonicalTraceFile(file)
+  const rootRelative = path.relative(root, resolvedFile)
+  if (!rootRelative.startsWith('..') && !path.isAbsolute(rootRelative)) return rootRelative
+  const workspaceRelative = path.relative(workspaceRoot, resolvedFile)
   if (!workspaceRelative.startsWith('..') && !path.isAbsolute(workspaceRelative))
-    return workspaceRelative;
-  return resolvedFile;
+    return workspaceRelative
+  return resolvedFile
 }
 
 function canonicalTraceFile(file: string) {
   try {
-    return realpathSync.native(file);
+    return realpathSync.native(file)
   } catch {
-    return path.resolve(file);
+    return path.resolve(file)
   }
 }
 
 /** One walked client source, with the stat that lets a later boot skip reading it. */
 export interface ClientCacheSource {
-  file: string;
-  mtimeMs: number;
-  size: number;
-  hash: string;
+  file: string
+  mtimeMs: number
+  size: number
+  hash: string
 }
 
 export interface ClientCacheKeyParts {
-  key: string;
-  staticHash: string;
-  sources: ClientCacheSource[];
+  key: string
+  staticHash: string
+  sources: ClientCacheSource[]
 }
 
 /**
  * The half of the key that is not a walked source: the client build pipeline's own sources, the
  * generated entry, and the route's reference list. A handful of small reads, so it is cheap to
  * recompute on every lookup - which is what lets the expensive source walk be validated from a
- * persisted index instead (see dev/client-key-cache.ts).
+ * persisted index instead (see dev/restart/client-key.ts).
  */
 export async function clientCacheStaticHash(
   route: RouteManifestEntry,
@@ -1908,18 +1942,18 @@ export async function clientCacheStaticHash(
 ) {
   // The key must observe convention files added since the last build, so it
   // never reads a memo an earlier call left behind.
-  conventionCache.clear();
-  const hash = createHash('sha256');
+  conventionCache.clear()
+  const hash = createHash('sha256')
   for (const file of clientBuildPipelineFiles()) {
-    hash.update(file);
-    hash.update('\0');
-    hash.update(await readText(file));
-    hash.update('\0');
+    hash.update(file)
+    hash.update('\0')
+    hash.update(await readText(file))
+    hash.update('\0')
   }
 
   hash.update(
     clientEntrySource({
-      // Dev-only callers (client-key-cache): the key must move with the split
+      // Dev-only callers (restart/client-key): the key must move with the split
       // flag or a toggled PNEXT_DYNAMIC_SPLIT would serve the other arm's entry.
       deferredDynamicHref: devDeferredDynamicHref(true),
       pageFile: route.client ? route.file : undefined,
@@ -1933,11 +1967,11 @@ export async function clientCacheStaticHash(
       clientRootLayout: config ? hasClientRootLayout(config, route) : false,
       shellLayoutOrder: config ? shellLayoutOrder(config, route) : [],
     }),
-  );
-  hash.update('\0');
-  hash.update(route.client ? route.file : '');
-  hash.update(JSON.stringify(route.clientReferences));
-  return hash.digest('hex');
+  )
+  hash.update('\0')
+  hash.update(route.client ? route.file : '')
+  hash.update(JSON.stringify(route.clientReferences))
+  return hash.digest('hex')
 }
 
 /** The out-dir name: the static half plus every walked source's content hash. */
@@ -1945,18 +1979,18 @@ export function clientCacheKeyFrom(
   staticHash: string,
   sources: readonly { file: string; hash: string }[],
 ) {
-  const hash = createHash('sha256').update(staticHash).update('\0');
+  const hash = createHash('sha256').update(staticHash).update('\0')
   for (const source of sources) {
-    hash.update(source.file);
-    hash.update('\0');
-    hash.update(source.hash);
-    hash.update('\0');
+    hash.update(source.file)
+    hash.update('\0')
+    hash.update(source.hash)
+    hash.update('\0')
   }
-  return hash.digest('hex').slice(0, 16);
+  return hash.digest('hex').slice(0, 16)
 }
 
 export function clientSourceHash(source: string) {
-  return Bun.hash(source).toString(36);
+  return Bun.hash(source).toString(36)
 }
 
 /**
@@ -1965,13 +1999,13 @@ export function clientSourceHash(source: string) {
  * hash that stat never described.
  */
 export async function readClientCacheSource(file: string): Promise<ClientCacheSource> {
-  const stats = await stat(file).catch(() => undefined);
+  const stats = await stat(file).catch(() => undefined)
   return {
     file,
     mtimeMs: stats?.mtimeMs ?? 0,
     size: stats?.size ?? 0,
     hash: clientSourceHash(await readText(file)),
-  };
+  }
 }
 
 export async function clientCacheKeyParts(
@@ -1980,11 +2014,11 @@ export async function clientCacheKeyParts(
   config?: ResolvedConfig,
   staticHash?: string,
 ): Promise<ClientCacheKeyParts> {
-  const staticDigest = staticHash ?? (await clientCacheStaticHash(route, nextCompat, config));
+  const staticDigest = staticHash ?? (await clientCacheStaticHash(route, nextCompat, config))
   const sources = await Promise.all(
     (await clientSourceFiles(route)).map(file => readClientCacheSource(file)),
-  );
-  return { key: clientCacheKeyFrom(staticDigest, sources), staticHash: staticDigest, sources };
+  )
+  return { key: clientCacheKeyFrom(staticDigest, sources), staticHash: staticDigest, sources }
 }
 
 export async function clientCacheKey(
@@ -1992,7 +2026,7 @@ export async function clientCacheKey(
   nextCompat?: boolean,
   config?: ResolvedConfig,
 ) {
-  return (await clientCacheKeyParts(route, nextCompat, config)).key;
+  return (await clientCacheKeyParts(route, nextCompat, config)).key
 }
 
 function clientBuildPipelineFiles() {
@@ -2004,61 +2038,61 @@ function clientBuildPipelineFiles() {
     path.join(import.meta.dirname, 'build.ts'),
     path.resolve(import.meta.dirname, '..', 'compat', 'react', 'client.ts'),
     path.resolve(import.meta.dirname, '..', 'compat', 'react', 'preact.ts'),
-  ].filter(file => existsSync(file));
+  ].filter(file => existsSync(file))
 }
 
 async function clientSourceFiles(route: RouteManifestEntry) {
   const entryFiles = [
     ...(route.client ? [route.file] : []),
     ...route.clientReferences.map(reference => reference.file),
-  ];
-  const files = new Set<string>();
+  ]
+  const files = new Set<string>()
 
-  await Promise.all(entryFiles.map(file => collectClientSourceFile(file, files)));
+  await Promise.all(entryFiles.map(file => collectClientSourceFile(file, files)))
 
-  return [...files].sort();
+  return [...files].sort()
 }
 
 // The walk fans out: every file joins `files` before its own read starts, so
 // concurrent branches still visit each file once. Serially this was the whole
 // cost of a route's client cache key (~1.8 s on a 300-module route).
 async function collectClientSourceFile(file: string, files: Set<string>) {
-  if (files.has(file) || !existsSync(file)) return;
-  files.add(file);
-  if (isAssetLike(file)) return;
+  if (files.has(file) || !existsSync(file)) return
+  files.add(file)
+  if (isAssetLike(file)) return
 
-  const source = rewriteLiteralDynamicCalls(await readText(file), file);
+  const source = rewriteLiteralDynamicCalls(await readText(file), file)
   await Promise.all(
     [...localImports(file, source)].map(specifier => {
-      const resolved = resolveImport(rootFromFile(file), file, specifier);
-      return resolved ? collectClientSourceFile(resolved, files) : Promise.resolve();
+      const resolved = resolveImport(rootFromFile(file), file, specifier)
+      return resolved ? collectClientSourceFile(resolved, files) : Promise.resolve()
     }),
-  );
+  )
 }
 
 // Value imports, re-exports and literal `import()` of one module, off the
 // memoized parse (PERF-REWRITES #21) — type-only imports bind nothing and are
 // already excluded there.
 export function localImports(file: string, source: string) {
-  const facts = scanFacts(file, source);
-  const imports = new Set<string>();
-  for (const edge of facts.imports) imports.add(edge.specifier);
-  for (const edge of facts.dynamicImports) imports.add(edge.specifier);
-  return imports;
+  const facts = scanFacts(file, source)
+  const imports = new Set<string>()
+  for (const edge of facts.imports) imports.add(edge.specifier)
+  for (const edge of facts.dynamicImports) imports.add(edge.specifier)
+  return imports
 }
 
 function isAssetLike(file: string) {
-  return /\.(css|svg|png|jpe?g|gif|webp|ico|woff2?)$/.test(file);
+  return /\.(css|svg|png|jpe?g|gif|webp|ico|woff2?)$/.test(file)
 }
 
 function rootFromFile(file: string) {
-  const parts = file.split(path.sep);
-  const srcApp = parts.lastIndexOf('src');
+  const parts = file.split(path.sep)
+  const srcApp = parts.lastIndexOf('src')
   if (srcApp !== -1 && parts[srcApp + 1] === 'app')
-    return parts.slice(0, srcApp).join(path.sep) || path.sep;
-  const app = parts.lastIndexOf('app');
-  if (app !== -1) return parts.slice(0, app).join(path.sep) || path.sep;
-  return path.dirname(file);
+    return parts.slice(0, srcApp).join(path.sep) || path.sep
+  const app = parts.lastIndexOf('app')
+  if (app !== -1) return parts.slice(0, app).join(path.sep) || path.sep
+  return path.dirname(file)
 }
 
 // esbuild names every shared chunk "chunk-<hash>", which makes bundle reports
@@ -2068,96 +2102,96 @@ function rootFromFile(file: string) {
 async function nameSharedClientChunks(outDir: string, metafile?: Metafile) {
   // eslint-disable-next-line turbo/no-undeclared-env-vars
   if (metafile && process.env.PNEXT_CLIENT_METAFILE) {
-    await writeText(path.join(outDir, 'metafile.json'), JSON.stringify(metafile));
+    await writeText(path.join(outDir, 'metafile.json'), JSON.stringify(metafile))
   }
-  const chunksDir = path.join(outDir, 'chunks');
-  const files = (await listFiles(chunksDir)).filter(file => file.endsWith('.js'));
-  const labels = metafile ? chunkLabelsFromMetafile(metafile) : new Map<string, string>();
-  const renames = new Map<string, string>();
+  const chunksDir = path.join(outDir, 'chunks')
+  const files = (await listFiles(chunksDir)).filter(file => file.endsWith('.js'))
+  const labels = metafile ? chunkLabelsFromMetafile(metafile) : new Map<string, string>()
+  const renames = new Map<string, string>()
 
   for (const file of files) {
-    const basename = path.basename(file);
-    if (!basename.startsWith('chunk-')) continue;
-    renames.set(basename, `${labels.get(basename) ?? 'shared'}-${hashSuffix(basename)}.js`);
+    const basename = path.basename(file)
+    if (!basename.startsWith('chunk-')) continue
+    renames.set(basename, `${labels.get(basename) ?? 'shared'}-${hashSuffix(basename)}.js`)
   }
 
-  if (renames.size === 0) return renames;
+  if (renames.size === 0) return renames
 
   await Promise.all(
     [...renames].map(async ([from, to]) => {
-      const fromPath = path.join(chunksDir, from);
-      const toPath = path.join(chunksDir, to);
-      if (from === to || !existsSync(fromPath)) return;
+      const fromPath = path.join(chunksDir, from)
+      const toPath = path.join(chunksDir, to)
+      if (from === to || !existsSync(fromPath)) return
       try {
-        await rename(fromPath, toPath);
+        await rename(fromPath, toPath)
       } catch (error) {
         // Tolerate a concurrent build having already moved this chunk (ENOENT);
         // the reference rewrite below still points at the renamed file.
-        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error
       }
       // Move the external sourcemap alongside its chunk. The `sourceMappingURL`
       // comment in the renamed chunk is rewritten below (replaceChunkNames matches
       // the `chunk-<hash>.js` prefix inside `chunk-<hash>.js.map`), so the map file
       // must adopt the new name to keep the link resolvable.
-      const fromMap = `${fromPath}.map`;
-      if (!existsSync(fromMap)) return;
+      const fromMap = `${fromPath}.map`
+      if (!existsSync(fromMap)) return
       try {
-        await rename(fromMap, `${toPath}.map`);
+        await rename(fromMap, `${toPath}.map`)
       } catch (error) {
-        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error;
+        if ((error as NodeJS.ErrnoException).code !== 'ENOENT') throw error
       }
     }),
-  );
+  )
 
   // One read+rewrite per output file. An app with a route per page has hundreds
   // of them, so they go out concurrently rather than one await at a time.
-  const outputs = (await listFiles(outDir)).filter(item => item.endsWith('.js'));
+  const outputs = (await listFiles(outDir)).filter(item => item.endsWith('.js'))
   await Promise.all(
     outputs.map(async file => {
-      const source = await readText(file);
-      const next = replaceChunkNames(source, renames);
-      if (next !== source) await writeText(file, next);
+      const source = await readText(file)
+      const next = replaceChunkNames(source, renames)
+      if (next !== source) await writeText(file, next)
     }),
-  );
+  )
 
-  return renames;
+  return renames
 }
 
 function hashSuffix(file: string) {
-  return path.basename(file, '.js').split('-').at(-1) ?? 'chunk';
+  return path.basename(file, '.js').split('-').at(-1) ?? 'chunk'
 }
 
 function chunkLabelsFromMetafile(metafile: Metafile) {
-  const labels = new Map<string, string>();
+  const labels = new Map<string, string>()
   for (const [outputPath, output] of Object.entries(metafile.outputs)) {
-    const basename = path.basename(outputPath);
-    if (!basename.startsWith('chunk-') || !basename.endsWith('.js')) continue;
-    const weights = new Map<string, number>();
+    const basename = path.basename(outputPath)
+    if (!basename.startsWith('chunk-') || !basename.endsWith('.js')) continue
+    const weights = new Map<string, number>()
     for (const [input, { bytesInOutput }] of Object.entries(output.inputs)) {
-      const label = chunkInputLabel(input);
-      if (!label) continue;
-      weights.set(label, (weights.get(label) ?? 0) + bytesInOutput);
+      const label = chunkInputLabel(input)
+      if (!label) continue
+      weights.set(label, (weights.get(label) ?? 0) + bytesInOutput)
     }
-    const top = [...weights.entries()].sort((a, b) => b[1] - a[1])[0];
-    if (top) labels.set(basename, top[0]);
+    const top = [...weights.entries()].sort((a, b) => b[1] - a[1])[0]
+    if (top) labels.set(basename, top[0])
   }
-  return labels;
+  return labels
 }
 
 function chunkInputLabel(input: string) {
-  const posix = input.split(path.sep).join('/');
-  const packageIndex = posix.lastIndexOf('node_modules/');
+  const posix = input.split(path.sep).join('/')
+  const packageIndex = posix.lastIndexOf('node_modules/')
   if (packageIndex !== -1) {
-    const parts = posix.slice(packageIndex + 'node_modules/'.length).split('/');
-    const name = parts[0]?.startsWith('@') ? `${parts[0]}-${parts[1] ?? ''}` : parts[0];
-    return sanitizeChunkLabel(name ?? '');
+    const parts = posix.slice(packageIndex + 'node_modules/'.length).split('/')
+    const name = parts[0]?.startsWith('@') ? `${parts[0]}-${parts[1] ?? ''}` : parts[0]
+    return sanitizeChunkLabel(name ?? '')
   }
   return sanitizeChunkLabel(
     posix
       .split('/')
       .at(-1)
       ?.replace(/\.[^.]+$/, '') ?? '',
-  );
+  )
 }
 
 function sanitizeChunkLabel(label: string) {
@@ -2165,11 +2199,11 @@ function sanitizeChunkLabel(label: string) {
     .replace(/^@/, '')
     .replace(/[^a-zA-Z0-9._-]+/g, '-')
     .replace(/^[-.]+|[-.]+$/g, '')
-    .slice(0, 40);
-  return clean || undefined;
+    .slice(0, 40)
+  return clean || undefined
 }
 
 function replaceChunkNames(source: string, renames: Map<string, string>) {
-  const pattern = new RegExp([...renames.keys()].map(escapeRegex).join('|'), 'g');
-  return source.replace(pattern, match => renames.get(match) ?? match);
+  const pattern = new RegExp([...renames.keys()].map(escapeRegex).join('|'), 'g')
+  return source.replace(pattern, match => renames.get(match) ?? match)
 }