@mandujs/core 0.54.23 → 0.54.25

package/src/bundler/build.ts

@@ -4,7 +4,7 @@ import type * as __ManduPluginsReactCompilerTypes0 from "./plugins/react-compile
  * Bun.build 기반 클라이언트 번들 빌드
  */
 
-import type { RouteClientBoundary, RoutesManifest, RouteSpec } from "../spec/schema";
+import type { RouteClientBoundary, RoutesManifest, RouteSpec } from "../spec/schema";
 import { needsHydration, getRouteHydration } from "../spec/schema";
 import type {
   BundleResult,
@@ -36,19 +36,19 @@ import {
   type VendorCacheWriteEntry,
 } from "./vendor-cache";
 import path from "path";
-import fs from "fs/promises";
-
-interface BoundaryBundleBuild {
-  id: string;
-  route: string;
-  js: string;
-  module: string;
-  exportName: string;
-  priority: "immediate" | "visible" | "idle" | "interaction";
-  hydrate: string;
-  size: number;
-  gzipSize: number;
-}
+import fs from "fs/promises";
+
+interface BoundaryBundleBuild {
+  id: string;
+  route: string;
+  js: string;
+  module: string;
+  exportName: string;
+  priority: "immediate" | "visible" | "idle" | "interaction";
+  hydrate: string;
+  size: number;
+  gzipSize: number;
+}
 
 /**
  * Resolve Mandu's default bundler plugin set from a `BundlerOptions`
@@ -423,24 +423,24 @@ function createEmptyManifest(env: "development" | "production"): BundleManifest
 /**
  * Hydration이 필요한 라우트 필터링
  */
-function getHydratedRoutes(manifest: RoutesManifest): RouteSpec[] {
-  return manifest.routes.filter(
-    (route) =>
-      route.kind === "page" &&
-      (!!route.clientModule || !!route.boundaries?.length) &&
-      needsHydration(route)
-  );
-}
+function getHydratedRoutes(manifest: RoutesManifest): RouteSpec[] {
+  return manifest.routes.filter(
+    (route) =>
+      route.kind === "page" &&
+      (!!route.clientModule || !!route.boundaries?.length) &&
+      needsHydration(route)
+  );
+}
 
 function getHydrationRoutesMissingClientModule(manifest: RoutesManifest): RouteSpec[] {
   return manifest.routes.filter(
-    (route) =>
-      route.kind === "page" &&
-      !route.clientModule &&
-      !route.boundaries?.length &&
-      needsHydration(route)
-  );
-}
+    (route) =>
+      route.kind === "page" &&
+      !route.clientModule &&
+      !route.boundaries?.length &&
+      needsHydration(route)
+  );
+}
 
 const REACT_SHIM_EXPORTS = [
   "Activity",
@@ -514,9 +514,9 @@ function formatShimBindings(names: readonly string[], indent = "  "): string {
   return names.map((name) => `${indent}${name},`).join("\n");
 }
 
-/**
- * Runtime bundle entry point.
- *
+/**
+ * Runtime bundle entry point.
+ *
  * The browser runtime lives in client/runtime-entry.ts so it is typechecked
  * with the rest of core and imports the shared props deserializer directly.
  */
@@ -633,9 +633,11 @@ function generateJsxRuntimeShimSource(): string {
 /**
  * Mandu JSX Runtime Shim (Generated)
  * Production JSX 변환용
- * 순환 참조 방지: 'react'에서 import (import map이 _react.js로 매핑)
+ * jsx/jsxs/Fragment는 'react/jsx-runtime' 원본에서 직접 가져온다.
+ * import map의 'react/jsx-runtime'이 다시 이 셰임을 가리키므로,
+ * 셰임 내부는 실제 원본 경로를 직접 참조해야 순환/누락이 생기지 않는다.
  */
-import { jsx, jsxs, Fragment } from 'react';
+import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // Named exports
 export { jsx, jsxs, Fragment };
@@ -654,9 +656,11 @@ function generateJsxDevRuntimeShimSource(): string {
 /**
  * Mandu JSX Dev Runtime Shim (Generated)
  * Development JSX 변환용
- * 순환 참조 방지: 'react'에서 import (import map이 _react.js로 매핑)
+ * jsxDEV/Fragment는 'react'가 아니라 'react/jsx-dev-runtime'에서만 export된다.
+ * import map의 'react/jsx-dev-runtime'이 다시 이 셰임을 가리키므로,
+ * 셰임 내부는 실제 원본 경로를 직접 참조해야 순환/누락(jsxDEV undefined)이 생기지 않는다.
  */
-import { jsxDEV, Fragment } from 'react';
+import { jsxDEV, Fragment } from 'react/jsx-dev-runtime';
 
 // Named exports
 export { jsxDEV, Fragment };
@@ -666,6 +670,18 @@ export default { jsxDEV, Fragment };
 `;
 }
 
+/**
+ * Test-only access to the JSX runtime shim generators so tests can assert
+ * that jsx/jsxDEV/Fragment are sourced from the correct React subpaths
+ * (regression guard for #322: jsxDEV must come from 'react/jsx-dev-runtime',
+ * never from bare 'react' which does not export it).
+ *
+ * @internal
+ */
+export const _testOnly_generateJsxRuntimeShimSource = generateJsxRuntimeShimSource;
+/** @internal */
+export const _testOnly_generateJsxDevRuntimeShimSource = generateJsxDevRuntimeShimSource;
+
 /**
  * Client-side Router 런타임 소스 생성
  */
@@ -730,44 +746,44 @@ function patternCacheSet(key, value) {
   patternCache.set(key, value);
 }
 
-function compilePattern(pattern) {
-  var cached = patternCacheGet(pattern);
-  if (cached) return cached;
-
-  const paramNames = [];
-  const normalized = pattern === '/' ? '/' : pattern.replace(/\\/+$/, '') || '/';
-  const segments = normalized.split('/').filter(Boolean);
-  const regexStr = segments.length === 0
-    ? '/'
-    : segments.map((segment) => {
-        if (segment === '*') return '/.+';
-        const wildcardMatch = segment.match(/^:([a-zA-Z_][a-zA-Z0-9_]*)\\*(\\?)?$/);
-        if (wildcardMatch) {
-          paramNames.push(wildcardMatch[1]);
-          return wildcardMatch[2] === '?' ? '(?:/(.*))?' : '/(.+)';
-        }
-        const paramMatch = segment.match(/^:([a-zA-Z_][a-zA-Z0-9_]*)$/);
-        if (paramMatch) {
-          paramNames.push(paramMatch[1]);
-          return '/([^/]+)';
-        }
-        return '/' + segment.replace(/[.*+?^\${}()|[\\]\\\\]/g, '\\\\$&');
-      }).join('');
-
-  const compiled = { regex: new RegExp('^' + regexStr + '$'), paramNames };
-  patternCacheSet(pattern, compiled);
-  return compiled;
-}
+function compilePattern(pattern) {
+  var cached = patternCacheGet(pattern);
+  if (cached) return cached;
+
+  const paramNames = [];
+  const normalized = pattern === '/' ? '/' : pattern.replace(/\\/+$/, '') || '/';
+  const segments = normalized.split('/').filter(Boolean);
+  const regexStr = segments.length === 0
+    ? '/'
+    : segments.map((segment) => {
+        if (segment === '*') return '/.+';
+        const wildcardMatch = segment.match(/^:([a-zA-Z_][a-zA-Z0-9_]*)\\*(\\?)?$/);
+        if (wildcardMatch) {
+          paramNames.push(wildcardMatch[1]);
+          return wildcardMatch[2] === '?' ? '(?:/(.*))?' : '/(.+)';
+        }
+        const paramMatch = segment.match(/^:([a-zA-Z_][a-zA-Z0-9_]*)$/);
+        if (paramMatch) {
+          paramNames.push(paramMatch[1]);
+          return '/([^/]+)';
+        }
+        return '/' + segment.replace(/[.*+?^\${}()|[\\]\\\\]/g, '\\\\$&');
+      }).join('');
+
+  const compiled = { regex: new RegExp('^' + regexStr + '$'), paramNames };
+  patternCacheSet(pattern, compiled);
+  return compiled;
+}
 
 function extractParams(pattern, pathname) {
   const compiled = compilePattern(pattern);
   const match = pathname.match(compiled.regex);
   if (!match) return {};
-
-  const params = {};
-  compiled.paramNames.forEach((name, i) => { params[name] = match[i + 1] || ''; });
-  return params;
-}
+
+  const params = {};
+  compiled.paramNames.forEach((name, i) => { params[name] = match[i + 1] || ''; });
+  return params;
+}
 
 function notifyListeners() {
   const state = getGlobalState();
@@ -1010,74 +1026,74 @@ async function buildRouterRuntime(
  * - Runtime이 dynamic import로 로드
  * - 등록/초기화 코드 없음
  */
-function generateIslandEntry(routeId: string, clientModulePath: string, exportName?: string): string {
-  // Windows 경로의 백슬래시를 슬래시로 변환 (JS escape 문제 방지)
-  const normalizedPath = clientModulePath.replace(/\\/g, "/");
-  const normalizedExportName = exportName && exportName !== "default" ? exportName : undefined;
-  const namedExport = normalizedExportName && /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(normalizedExportName)
-    ? `export const ${normalizedExportName} = exportedIsland;`
-    : "";
-  const candidates = [
-    normalizedExportName,
-    inferClientExportNameFromPath(clientModulePath),
-    inferClientExportNameFromRouteId(routeId),
-  ].filter((candidate, index, values): candidate is string =>
-    !!candidate && values.indexOf(candidate) === index
-  );
-  const importSpecifier = JSON.stringify(normalizedPath);
-  const routeLabel = JSON.stringify(routeId);
-  const commentRouteId = routeId.replace(/\*\//g, "* /");
-  return `
-/**
- * Mandu Island: ${commentRouteId} (Generated)
- * Pure export - no side effects
- */
-import React from "react";
-import * as islandModule from ${importSpecifier};
-
-const candidateExportNames = ${JSON.stringify(candidates)};
-const explicitExportName = ${JSON.stringify(normalizedExportName ?? null)};
-
-function resolveIslandExport(mod) {
-  if (explicitExportName && mod[explicitExportName]) return mod[explicitExportName];
-  if (mod.default) return mod.default;
-  for (const name of candidateExportNames) {
-    if (mod[name]) return mod[name];
-  }
-  const runtimeExports = Object.keys(mod).filter((name) => name !== "__esModule");
-  if (runtimeExports.length === 1) return mod[runtimeExports[0]];
-  throw new Error(
-    "[Mandu Island] " + ${routeLabel} + " must export a default component" +
-      (candidateExportNames.length > 0 ? " or one of: " + candidateExportNames.join(", ") : "")
-  );
-}
-
-const island = resolveIslandExport(islandModule);
-const exportedIsland = island && island.__mandu_island === true
-  ? island
-  : function ManduGeneratedIsland(props) {
-      return React.createElement(island, props || {});
-    };
-
-export default exportedIsland;
-${namedExport}
-`;
-}
-
-function inferClientExportNameFromPath(clientModulePath: string): string | null {
-  const basename = path.basename(clientModulePath).replace(/\.[cm]?[jt]sx?$/, "");
-  const withoutClientSuffix = basename.replace(/\.(client|island)$/, "");
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(withoutClientSuffix) ? withoutClientSuffix : null;
-}
-
-function inferClientExportNameFromRouteId(routeId: string): string | null {
-  const pascal = routeId
-    .split(/[^A-Za-z0-9]+/)
-    .filter(Boolean)
-    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-    .join("");
-  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(pascal) ? pascal : null;
-}
+function generateIslandEntry(routeId: string, clientModulePath: string, exportName?: string): string {
+  // Windows 경로의 백슬래시를 슬래시로 변환 (JS escape 문제 방지)
+  const normalizedPath = clientModulePath.replace(/\\/g, "/");
+  const normalizedExportName = exportName && exportName !== "default" ? exportName : undefined;
+  const namedExport = normalizedExportName && /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(normalizedExportName)
+    ? `export const ${normalizedExportName} = exportedIsland;`
+    : "";
+  const candidates = [
+    normalizedExportName,
+    inferClientExportNameFromPath(clientModulePath),
+    inferClientExportNameFromRouteId(routeId),
+  ].filter((candidate, index, values): candidate is string =>
+    !!candidate && values.indexOf(candidate) === index
+  );
+  const importSpecifier = JSON.stringify(normalizedPath);
+  const routeLabel = JSON.stringify(routeId);
+  const commentRouteId = routeId.replace(/\*\//g, "* /");
+  return `
+/**
+ * Mandu Island: ${commentRouteId} (Generated)
+ * Pure export - no side effects
+ */
+import React from "react";
+import * as islandModule from ${importSpecifier};
+
+const candidateExportNames = ${JSON.stringify(candidates)};
+const explicitExportName = ${JSON.stringify(normalizedExportName ?? null)};
+
+function resolveIslandExport(mod) {
+  if (explicitExportName && mod[explicitExportName]) return mod[explicitExportName];
+  if (mod.default) return mod.default;
+  for (const name of candidateExportNames) {
+    if (mod[name]) return mod[name];
+  }
+  const runtimeExports = Object.keys(mod).filter((name) => name !== "__esModule");
+  if (runtimeExports.length === 1) return mod[runtimeExports[0]];
+  throw new Error(
+    "[Mandu Island] " + ${routeLabel} + " must export a default component" +
+      (candidateExportNames.length > 0 ? " or one of: " + candidateExportNames.join(", ") : "")
+  );
+}
+
+const island = resolveIslandExport(islandModule);
+const exportedIsland = island && island.__mandu_island === true
+  ? island
+  : function ManduGeneratedIsland(props) {
+      return React.createElement(island, props || {});
+    };
+
+export default exportedIsland;
+${namedExport}
+`;
+}
+
+function inferClientExportNameFromPath(clientModulePath: string): string | null {
+  const basename = path.basename(clientModulePath).replace(/\.[cm]?[jt]sx?$/, "");
+  const withoutClientSuffix = basename.replace(/\.(client|island)$/, "");
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(withoutClientSuffix) ? withoutClientSuffix : null;
+}
+
+function inferClientExportNameFromRouteId(routeId: string): string | null {
+  const pascal = routeId
+    .split(/[^A-Za-z0-9]+/)
+    .filter(Boolean)
+    .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+    .join("");
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(pascal) ? pascal : null;
+}
 
 function generatePartialEntry(partialId: string, partialModulePath: string): string {
   const normalizedPath = partialModulePath.replace(/\\/g, "/");
@@ -1123,17 +1139,17 @@ export default {
 /**
  * Runtime 번들 빌드
  */
-async function buildRuntime(
-  outDir: string,
-  options: BundlerOptions
-): Promise<{ success: boolean; outputPath: string; errors: string[] }> {
-  const runtimePath = getRuntimeEntryPath();
-  const outputName = "_runtime.js";
-
-  try {
-    const result = await safeBuild({
-      entrypoints: [runtimePath],
-      outdir: outDir,
+async function buildRuntime(
+  outDir: string,
+  options: BundlerOptions
+): Promise<{ success: boolean; outputPath: string; errors: string[] }> {
+  const runtimePath = getRuntimeEntryPath();
+  const outputName = "_runtime.js";
+
+  try {
+    const result = await safeBuild({
+      entrypoints: [runtimePath],
+      outdir: outDir,
       naming: outputName,
       minify: shouldMinify(options),
       sourcemap: options.sourcemap ? "external" : "none",
@@ -1144,24 +1160,24 @@ async function buildRuntime(
         "process.env.NODE_ENV": nodeEnvDefine(options),
         ...options.define,
       },
-    });
-
-    if (!result.success) {
-      const grouped = result.logs.map((l) => `  - ${l.message}`).join("\n");
-      return {
-        success: false,
-        outputPath: "",
-        errors: [`Runtime bundle build failed (source: ${runtimePath}):\n${grouped}\n  Hint: Check the import paths and TypeScript types.`],
-      };
-    }
-
-    return {
-      success: true,
-      outputPath: `/.mandu/client/${outputName}`,
-      errors: [],
-    };
-  } catch (error: unknown) {
-    const extra: string[] = [];
+    });
+
+    if (!result.success) {
+      const grouped = result.logs.map((l) => `  - ${l.message}`).join("\n");
+      return {
+        success: false,
+        outputPath: "",
+        errors: [`Runtime bundle build failed (source: ${runtimePath}):\n${grouped}\n  Hint: Check the import paths and TypeScript types.`],
+      };
+    }
+
+    return {
+      success: true,
+      outputPath: `/.mandu/client/${outputName}`,
+      errors: [],
+    };
+  } catch (error: unknown) {
+    const extra: string[] = [];
     const errObj = error as Record<string, unknown> | null;
     if (errObj && Array.isArray(errObj.errors)) {
       extra.push(...errObj.errors.map((e: unknown) => String((e as Record<string, unknown>)?.message || e)));
@@ -1500,41 +1516,41 @@ async function buildVendorShims(
   };
 }
 
-function vendorShimFailureHint(shimName: string): string {
-  if (shimName.includes("react-refresh")) {
-    return "Hint: install the optional dev peer dependency with `bun add -d react-refresh`.";
-  }
-  return "Hint: check the import paths and ensure the vendor package is installed.";
-}
-
-function routeIdToAssetStem(routeId: string): string {
-  const safe = routeId.replace(/[<>:"/\\|?*\x00-\x1F]/g, (ch) =>
-    `_${ch.codePointAt(0)!.toString(16)}_`
-  );
-  return safe.replace(/[. ]+$/g, "") || "route";
-}
-
-/**
- * 단일 Island 번들 빌드
- */
-async function buildIsland(
+function vendorShimFailureHint(shimName: string): string {
+  if (shimName.includes("react-refresh")) {
+    return "Hint: install the optional dev peer dependency with `bun add -d react-refresh`.";
+  }
+  return "Hint: check the import paths and ensure the vendor package is installed.";
+}
+
+function routeIdToAssetStem(routeId: string): string {
+  const safe = routeId.replace(/[<>:"/\\|?*\x00-\x1F]/g, (ch) =>
+    `_${ch.codePointAt(0)!.toString(16)}_`
+  );
+  return safe.replace(/[. ]+$/g, "") || "route";
+}
+
+/**
+ * 단일 Island 번들 빌드
+ */
+async function buildIsland(
   route: RouteSpec,
   rootDir: string,
   outDir: string,
   options: BundlerOptions
-): Promise<BundleOutput> {
-  const clientModulePath = path.join(rootDir, route.clientModule!);
-  const assetStem = routeIdToAssetStem(route.id);
-  const entryStem = `_entry_${assetStem}`;
-  const entryPath = path.join(outDir, `${entryStem}.js`);
-  const outputName = `${assetStem}.island.js`;
+): Promise<BundleOutput> {
+  const clientModulePath = path.join(rootDir, route.clientModule!);
+  const assetStem = routeIdToAssetStem(route.id);
+  const entryStem = `_entry_${assetStem}`;
+  const entryPath = path.join(outDir, `${entryStem}.js`);
+  const outputName = `${assetStem}.island.js`;
 
   // Phase 7.1 B-1/B-4: wire native Fast Refresh transform + Mandu's
   // boundary injection plugin. Dev-only; prod bundles remain clean.
   const isDev = isDevelopmentBuild(options);
   try {
     // 엔트리 래퍼 생성
-    await Bun.write(entryPath, generateIslandEntry(route.id, clientModulePath, route.clientExportName));
+    await Bun.write(entryPath, generateIslandEntry(route.id, clientModulePath, route.clientExportName));
 
     // 빌드
     // splitting 옵션: true면 공통 코드를 별도 청크로 추출
@@ -1568,11 +1584,11 @@ async function buildIsland(
     let actualOutputPath: string;
     let actualOutputName: string;
 
-    if (options.splitting && result.outputs.length > 0) {
-      // splitting 모드: 결과에서 엔트리 파일 찾기
-      const entryOutput = result.outputs.find(
-        (o) => o.kind === "entry-point" || o.path.includes(entryStem) || o.path.includes(assetStem)
-      );
+    if (options.splitting && result.outputs.length > 0) {
+      // splitting 모드: 결과에서 엔트리 파일 찾기
+      const entryOutput = result.outputs.find(
+        (o) => o.kind === "entry-point" || o.path.includes(entryStem) || o.path.includes(assetStem)
+      );
       if (entryOutput) {
         actualOutputPath = entryOutput.path;
         actualOutputName = path.basename(entryOutput.path);
@@ -1600,171 +1616,171 @@ async function buildIsland(
   } catch (error) {
     await fs.unlink(entryPath).catch(() => {});
     throw error;
-  }
-}
-
-async function buildBoundaryBundle(
-  boundary: RouteClientBoundary,
-  rootDir: string,
-  outDir: string,
-  options: BundlerOptions,
-): Promise<BoundaryBundleBuild> {
-  const clientModulePath = path.join(rootDir, boundary.module);
-  const assetStem = routeIdToAssetStem(boundary.id);
-  const entryStem = `_entry_boundary_${assetStem}`;
-  const entryPath = path.join(outDir, `${entryStem}.js`);
-  const outputName = `${assetStem}.boundary.js`;
-  const isDev = isDevelopmentBuild(options);
-
-  try {
-    await Bun.write(entryPath, generateIslandEntry(boundary.id, clientModulePath, boundary.exportName));
-
-    const result = await safeBuild({
-      entrypoints: [entryPath],
-      outdir: outDir,
-      naming: options.splitting ? "[name]-[hash].js" : outputName,
-      minify: shouldMinify(options),
-      sourcemap: options.sourcemap ? "external" : "none",
-      target: "browser",
-      splitting: shouldSplitChunks(options),
-      ...(isDev ? { reactFastRefresh: true } : {}),
-      plugins: [...manduClientPlugins(options), ...(isDev ? [fastRefreshPlugin()] : [])],
-      external: ["react", "react-dom", "react-dom/client", ...(options.external || [])],
-      define: {
-        "process.env.NODE_ENV": nodeEnvDefine(options),
-        ...options.define,
-      },
-    });
-
-    await fs.unlink(entryPath).catch(() => {});
-
-    if (!result.success) {
-      const grouped = result.logs.map((l) => `  - ${l.message}`).join("\n");
-      throw new Error(`Boundary build failed for '${boundary.id}' (source: ${clientModulePath}):\n${grouped}\n  Hint: Check the import paths and TypeScript types in this client boundary file.`);
-    }
-
-    let actualOutputPath: string;
-    let actualOutputName: string;
-    if (options.splitting && result.outputs.length > 0) {
-      const entryOutput = result.outputs.find(
-        (o) => o.kind === "entry-point" || o.path.includes(entryStem) || o.path.includes(assetStem),
-      );
-      actualOutputPath = entryOutput?.path ?? result.outputs[0].path;
-      actualOutputName = path.basename(actualOutputPath);
-    } else {
-      actualOutputPath = path.join(outDir, outputName);
-      actualOutputName = outputName;
-    }
-
-    const outputFile = Bun.file(actualOutputPath);
-    const content = await sanitizeGeneratedClientBundle(actualOutputPath, isDev);
-    const gzipped = Bun.gzipSync(Buffer.from(content));
-    const priority = boundaryPriorityToLegacyPriority(boundary.hydrate);
-
-    return {
-      id: boundary.id,
-      route: boundary.routeId,
-      js: `/.mandu/client/${actualOutputName}`,
-      module: boundary.module,
-      exportName: boundary.exportName,
-      priority,
-      hydrate: boundary.hydrate,
-      size: outputFile.size,
-      gzipSize: gzipped.length,
-    };
-  } finally {
-    await fs.unlink(entryPath).catch(() => {});
-  }
-}
-
-async function buildBoundaryBundlesForRecords(
-  boundaries: RouteClientBoundary[],
-  rootDir: string,
-  outDir: string,
-  options: BundlerOptions,
-  errors: string[],
-): Promise<BoundaryBundleBuild[]> {
-  if (boundaries.length === 0) return [];
-  if (pushDuplicateBoundaryIdErrors(boundaries, errors)) return [];
-
-  const results = await Promise.all(
-    boundaries.map(async (boundary) => {
-      try {
-        return await buildBoundaryBundle(boundary, rootDir, outDir, options);
-      } catch (error) {
-        errors.push(`[boundary:${boundary.id}] ${String(error)}`);
-        return null;
-      }
-    }),
-  );
-
-  return results.filter((result): result is BoundaryBundleBuild => result !== null);
-}
-
-function pushDuplicateBoundaryIdErrors(boundaries: RouteClientBoundary[], errors: string[]): boolean {
-  const firstById = new Map<string, RouteClientBoundary>();
-  let hasDuplicate = false;
-
-  for (const boundary of boundaries) {
-    const first = firstById.get(boundary.id);
-    if (!first) {
-      firstById.set(boundary.id, boundary);
-      continue;
-    }
-
-    hasDuplicate = true;
-    errors.push(
-      `[boundary:${boundary.id}] MANDU_BOUNDARY_DUPLICATE_ID Duplicate client boundary id. ` +
-      `First route="${first.routeId}" source="${first.source.file}", duplicate route="${boundary.routeId}" source="${boundary.source.file}". ` +
-      "Boundary ids must be unique before bundle manifest generation.",
-    );
-  }
-
-  return hasDuplicate;
-}
-
-function mergeBoundaryBundlesIntoManifest(
-  manifest: BundleManifest,
-  routeIds: Iterable<string>,
-  boundaryBundles: BoundaryBundleBuild[],
-): void {
-  const rebuiltRouteIds = new Set(routeIds);
-  if (rebuiltRouteIds.size === 0 && boundaryBundles.length === 0) return;
-
-  if (manifest.boundaries) {
-    for (const [id, boundary] of Object.entries(manifest.boundaries)) {
-      if (rebuiltRouteIds.has(boundary.route)) {
-        delete manifest.boundaries[id];
-      }
-    }
-  }
-
-  if (boundaryBundles.length > 0) {
-    manifest.boundaries = manifest.boundaries || {};
-    for (const boundary of boundaryBundles) {
-      manifest.boundaries[boundary.id] = {
-        route: boundary.route,
-        js: boundary.js,
-        module: boundary.module,
-        exportName: boundary.exportName,
-        priority: boundary.priority,
-        hydrate: boundary.hydrate,
-      };
-    }
-  }
-
-  if (manifest.boundaries && Object.keys(manifest.boundaries).length === 0) {
-    delete manifest.boundaries;
-  }
-}
-
-function boundaryPriorityToLegacyPriority(value: string): BoundaryBundleBuild["priority"] {
-  if (value === "load") return "immediate";
-  if (value === "immediate" || value === "visible" || value === "idle" || value === "interaction") {
-    return value;
-  }
-  return "visible";
-}
+  }
+}
+
+async function buildBoundaryBundle(
+  boundary: RouteClientBoundary,
+  rootDir: string,
+  outDir: string,
+  options: BundlerOptions,
+): Promise<BoundaryBundleBuild> {
+  const clientModulePath = path.join(rootDir, boundary.module);
+  const assetStem = routeIdToAssetStem(boundary.id);
+  const entryStem = `_entry_boundary_${assetStem}`;
+  const entryPath = path.join(outDir, `${entryStem}.js`);
+  const outputName = `${assetStem}.boundary.js`;
+  const isDev = isDevelopmentBuild(options);
+
+  try {
+    await Bun.write(entryPath, generateIslandEntry(boundary.id, clientModulePath, boundary.exportName));
+
+    const result = await safeBuild({
+      entrypoints: [entryPath],
+      outdir: outDir,
+      naming: options.splitting ? "[name]-[hash].js" : outputName,
+      minify: shouldMinify(options),
+      sourcemap: options.sourcemap ? "external" : "none",
+      target: "browser",
+      splitting: shouldSplitChunks(options),
+      ...(isDev ? { reactFastRefresh: true } : {}),
+      plugins: [...manduClientPlugins(options), ...(isDev ? [fastRefreshPlugin()] : [])],
+      external: ["react", "react-dom", "react-dom/client", ...(options.external || [])],
+      define: {
+        "process.env.NODE_ENV": nodeEnvDefine(options),
+        ...options.define,
+      },
+    });
+
+    await fs.unlink(entryPath).catch(() => {});
+
+    if (!result.success) {
+      const grouped = result.logs.map((l) => `  - ${l.message}`).join("\n");
+      throw new Error(`Boundary build failed for '${boundary.id}' (source: ${clientModulePath}):\n${grouped}\n  Hint: Check the import paths and TypeScript types in this client boundary file.`);
+    }
+
+    let actualOutputPath: string;
+    let actualOutputName: string;
+    if (options.splitting && result.outputs.length > 0) {
+      const entryOutput = result.outputs.find(
+        (o) => o.kind === "entry-point" || o.path.includes(entryStem) || o.path.includes(assetStem),
+      );
+      actualOutputPath = entryOutput?.path ?? result.outputs[0].path;
+      actualOutputName = path.basename(actualOutputPath);
+    } else {
+      actualOutputPath = path.join(outDir, outputName);
+      actualOutputName = outputName;
+    }
+
+    const outputFile = Bun.file(actualOutputPath);
+    const content = await sanitizeGeneratedClientBundle(actualOutputPath, isDev);
+    const gzipped = Bun.gzipSync(Buffer.from(content));
+    const priority = boundaryPriorityToLegacyPriority(boundary.hydrate);
+
+    return {
+      id: boundary.id,
+      route: boundary.routeId,
+      js: `/.mandu/client/${actualOutputName}`,
+      module: boundary.module,
+      exportName: boundary.exportName,
+      priority,
+      hydrate: boundary.hydrate,
+      size: outputFile.size,
+      gzipSize: gzipped.length,
+    };
+  } finally {
+    await fs.unlink(entryPath).catch(() => {});
+  }
+}
+
+async function buildBoundaryBundlesForRecords(
+  boundaries: RouteClientBoundary[],
+  rootDir: string,
+  outDir: string,
+  options: BundlerOptions,
+  errors: string[],
+): Promise<BoundaryBundleBuild[]> {
+  if (boundaries.length === 0) return [];
+  if (pushDuplicateBoundaryIdErrors(boundaries, errors)) return [];
+
+  const results = await Promise.all(
+    boundaries.map(async (boundary) => {
+      try {
+        return await buildBoundaryBundle(boundary, rootDir, outDir, options);
+      } catch (error) {
+        errors.push(`[boundary:${boundary.id}] ${String(error)}`);
+        return null;
+      }
+    }),
+  );
+
+  return results.filter((result): result is BoundaryBundleBuild => result !== null);
+}
+
+function pushDuplicateBoundaryIdErrors(boundaries: RouteClientBoundary[], errors: string[]): boolean {
+  const firstById = new Map<string, RouteClientBoundary>();
+  let hasDuplicate = false;
+
+  for (const boundary of boundaries) {
+    const first = firstById.get(boundary.id);
+    if (!first) {
+      firstById.set(boundary.id, boundary);
+      continue;
+    }
+
+    hasDuplicate = true;
+    errors.push(
+      `[boundary:${boundary.id}] MANDU_BOUNDARY_DUPLICATE_ID Duplicate client boundary id. ` +
+      `First route="${first.routeId}" source="${first.source.file}", duplicate route="${boundary.routeId}" source="${boundary.source.file}". ` +
+      "Boundary ids must be unique before bundle manifest generation.",
+    );
+  }
+
+  return hasDuplicate;
+}
+
+function mergeBoundaryBundlesIntoManifest(
+  manifest: BundleManifest,
+  routeIds: Iterable<string>,
+  boundaryBundles: BoundaryBundleBuild[],
+): void {
+  const rebuiltRouteIds = new Set(routeIds);
+  if (rebuiltRouteIds.size === 0 && boundaryBundles.length === 0) return;
+
+  if (manifest.boundaries) {
+    for (const [id, boundary] of Object.entries(manifest.boundaries)) {
+      if (rebuiltRouteIds.has(boundary.route)) {
+        delete manifest.boundaries[id];
+      }
+    }
+  }
+
+  if (boundaryBundles.length > 0) {
+    manifest.boundaries = manifest.boundaries || {};
+    for (const boundary of boundaryBundles) {
+      manifest.boundaries[boundary.id] = {
+        route: boundary.route,
+        js: boundary.js,
+        module: boundary.module,
+        exportName: boundary.exportName,
+        priority: boundary.priority,
+        hydrate: boundary.hydrate,
+      };
+    }
+  }
+
+  if (manifest.boundaries && Object.keys(manifest.boundaries).length === 0) {
+    delete manifest.boundaries;
+  }
+}
+
+function boundaryPriorityToLegacyPriority(value: string): BoundaryBundleBuild["priority"] {
+  if (value === "load") return "immediate";
+  if (value === "immediate" || value === "visible" || value === "idle" || value === "interaction") {
+    return value;
+  }
+  return "visible";
+}
 
 async function sanitizeGeneratedClientBundle(outputPath: string, isDev: boolean): Promise<string> {
   const source = await Bun.file(outputPath).text();
@@ -1817,11 +1833,11 @@ function createBundleManifest(
   runtimePath: string,
   vendorResult: VendorBuildResult,
   routerPath: string,
-  env: "development" | "production",
-  islandBundles?: Array<{ name: string; js: string; route: string; priority: IslandFileEntry["priority"] }>,
-  partialBundles?: Array<{ name: string; js: string; priority: PartialFileEntry["priority"] }>,
-  boundaryBundles?: BoundaryBundleBuild[],
-): BundleManifest {
+  env: "development" | "production",
+  islandBundles?: Array<{ name: string; js: string; route: string; priority: IslandFileEntry["priority"] }>,
+  partialBundles?: Array<{ name: string; js: string; priority: PartialFileEntry["priority"] }>,
+  boundaryBundles?: BoundaryBundleBuild[],
+): BundleManifest {
   const bundles: BundleManifest["bundles"] = {};
 
   for (const output of outputs) {
@@ -1848,7 +1864,7 @@ function createBundleManifest(
     }
   }
 
-  let partials: BundleManifest["partials"];
+  let partials: BundleManifest["partials"];
   if (partialBundles && partialBundles.length > 0) {
     partials = {};
     for (const partial of partialBundles) {
@@ -1857,22 +1873,22 @@ function createBundleManifest(
         priority: partial.priority,
       };
     }
-  }
-
-  let boundaries: BundleManifest["boundaries"];
-  if (boundaryBundles && boundaryBundles.length > 0) {
-    boundaries = {};
-    for (const boundary of boundaryBundles) {
-      boundaries[boundary.id] = {
-        route: boundary.route,
-        js: boundary.js,
-        module: boundary.module,
-        exportName: boundary.exportName,
-        priority: boundary.priority,
-        hydrate: boundary.hydrate,
-      };
-    }
-  }
+  }
+
+  let boundaries: BundleManifest["boundaries"];
+  if (boundaryBundles && boundaryBundles.length > 0) {
+    boundaries = {};
+    for (const boundary of boundaryBundles) {
+      boundaries[boundary.id] = {
+        route: boundary.route,
+        js: boundary.js,
+        module: boundary.module,
+        exportName: boundary.exportName,
+        priority: boundary.priority,
+        hydrate: boundary.hydrate,
+      };
+    }
+  }
 
   // Phase 7.1 B-2: expose Fast Refresh dev bundles so the HTML
   // preamble can inject a dynamic import pointing at them. Only
@@ -1889,11 +1905,11 @@ function createBundleManifest(
     version: 1,
     buildTime: new Date().toISOString(),
     env,
-    bundles,
-    ...(islands ? { islands } : {}),
-    ...(partials ? { partials } : {}),
-    ...(boundaries ? { boundaries } : {}),
-    shared: {
+    bundles,
+    ...(islands ? { islands } : {}),
+    ...(partials ? { partials } : {}),
+    ...(boundaries ? { boundaries } : {}),
+    shared: {
       runtime: runtimePath,
       vendor: vendorResult.react, // primary vendor for backwards compatibility
       router: routerPath, // Client-side Router
@@ -2089,37 +2105,37 @@ export async function buildClientBundles(
     };
   }
 
-  // 부분 빌드 모드: targetRouteIds가 지정되면 해당 Island만 재빌드 (#122)
-  if (options.targetRouteIds && options.targetRouteIds.length > 0) {
-    const targetRouteIds = new Set(options.targetRouteIds);
-    const targetRoutes = hydratedRoutes.filter((r) => targetRouteIds.has(r.id));
-    const targetIslandRoutes = targetRoutes.filter((route) => !!route.clientModule);
-
-    const targetResults = await Promise.all(
-      targetIslandRoutes.map(async (route) => {
-        try {
-          return { ok: true as const, result: await buildIsland(route, rootDir, outDir, options) };
-        } catch (error) {
+  // 부분 빌드 모드: targetRouteIds가 지정되면 해당 Island만 재빌드 (#122)
+  if (options.targetRouteIds && options.targetRouteIds.length > 0) {
+    const targetRouteIds = new Set(options.targetRouteIds);
+    const targetRoutes = hydratedRoutes.filter((r) => targetRouteIds.has(r.id));
+    const targetIslandRoutes = targetRoutes.filter((route) => !!route.clientModule);
+
+    const targetResults = await Promise.all(
+      targetIslandRoutes.map(async (route) => {
+        try {
+          return { ok: true as const, result: await buildIsland(route, rootDir, outDir, options) };
+        } catch (error) {
           return { ok: false as const, routeId: route.id, error: String(error) };
         }
       }),
     );
     for (const r of targetResults) {
       if (r.ok) outputs.push(r.result);
-      else errors.push(`[${r.routeId}] ${r.error}`);
-    }
-
-    const boundaryRecords = targetRoutes.flatMap((route) => route.boundaries ?? []);
-    const boundaryBundles = await buildBoundaryBundlesForRecords(
-      boundaryRecords,
-      rootDir,
-      outDir,
-      options,
-      errors,
-    );
-
-    // 기존 매니페스트를 읽어 변경된 Island만 갱신
-    let existingManifest: BundleManifest;
+      else errors.push(`[${r.routeId}] ${r.error}`);
+    }
+
+    const boundaryRecords = targetRoutes.flatMap((route) => route.boundaries ?? []);
+    const boundaryBundles = await buildBoundaryBundlesForRecords(
+      boundaryRecords,
+      rootDir,
+      outDir,
+      options,
+      errors,
+    );
+
+    // 기존 매니페스트를 읽어 변경된 Island만 갱신
+    let existingManifest: BundleManifest;
     try {
       const manifestData = await fs.readFile(path.join(rootDir, ".mandu/manifest.json"), "utf-8");
       existingManifest = JSON.parse(manifestData) as BundleManifest;
@@ -2132,45 +2148,45 @@ export async function buildClientBundles(
     for (const routeId of invalidClientRouteIds) {
       delete existingManifest.bundles[routeId];
     }
-    if (outputs.length > 0 || invalidClientRouteIds.size > 0 || boundaryRecords.length > 0) {
-      for (const output of outputs) {
-        if (existingManifest.bundles[output.routeId]) {
-          existingManifest.bundles[output.routeId].js = output.outputPath;
-        } else {
-          const route = targetIslandRoutes.find((r) => r.id === output.routeId);
-          const hydration = route ? getRouteHydration(route) : null;
-          existingManifest.bundles[output.routeId] = {
-            js: output.outputPath,
+    if (outputs.length > 0 || invalidClientRouteIds.size > 0 || boundaryRecords.length > 0) {
+      for (const output of outputs) {
+        if (existingManifest.bundles[output.routeId]) {
+          existingManifest.bundles[output.routeId].js = output.outputPath;
+        } else {
+          const route = targetIslandRoutes.find((r) => r.id === output.routeId);
+          const hydration = route ? getRouteHydration(route) : null;
+          existingManifest.bundles[output.routeId] = {
+            js: output.outputPath,
             dependencies: ["_runtime", "_react"],
             priority: hydration?.priority || HYDRATION.DEFAULT_PRIORITY,
-          };
-        }
-      }
-
-      mergeBoundaryBundlesIntoManifest(
-        existingManifest,
-        targetRoutes.map((route) => route.id),
-        boundaryBundles,
-      );
-
-      await fs.writeFile(
-        path.join(rootDir, ".mandu/manifest.json"),
+          };
+        }
+      }
+
+      mergeBoundaryBundlesIntoManifest(
+        existingManifest,
+        targetRoutes.map((route) => route.id),
+        boundaryBundles,
+      );
+
+      await fs.writeFile(
+        path.join(rootDir, ".mandu/manifest.json"),
         JSON.stringify(existingManifest, null, 2)
       );
     }
-    // When all builds failed, do NOT overwrite manifest — keep previous good state
-
-    const stats = calculateStats(
-      outputs,
-      startTime,
-      boundaryBundles.map((boundary) => ({
-        routeId: `boundary:${boundary.id}`,
-        size: boundary.size,
-        gzipSize: boundary.gzipSize,
-      })),
-    );
-    return { success: errors.length === 0, outputs, errors, manifest: existingManifest, stats };
-  }
+    // When all builds failed, do NOT overwrite manifest — keep previous good state
+
+    const stats = calculateStats(
+      outputs,
+      startTime,
+      boundaryBundles.map((boundary) => ({
+        routeId: `boundary:${boundary.id}`,
+        size: boundary.size,
+        gzipSize: boundary.gzipSize,
+      })),
+    );
+    return { success: errors.length === 0, outputs, errors, manifest: existingManifest, stats };
+  }
 
   // #185: Framework-internal 번들 스킵 모드
   // 사용자 코드(src/shared 등) 변경 시 runtime/router/vendor/devtools 재빌드는 낭비.
@@ -2226,7 +2242,7 @@ export async function buildClientBundles(
     }
 
     const islandResults = await Promise.all(
-      hydratedRoutes.filter((route) => !!route.clientModule).map(async (route) => {
+      hydratedRoutes.filter((route) => !!route.clientModule).map(async (route) => {
         try {
           return { ok: true as const, result: await buildIsland(route, rootDir, outDir, options) };
         } catch (error) {
@@ -2272,32 +2288,32 @@ export async function buildClientBundles(
         };
       }
     }
-    if (perIslandBundles.length > 0) {
-      existingManifest.islands = existingManifest.islands || {};
-      for (const ib of perIslandBundles) {
-        existingManifest.islands[ib.name] = {
+    if (perIslandBundles.length > 0) {
+      existingManifest.islands = existingManifest.islands || {};
+      for (const ib of perIslandBundles) {
+        existingManifest.islands[ib.name] = {
           js: ib.js,
           route: ib.route,
           priority: ib.priority,
-        };
-      }
-    }
-
-    const boundaryRecords = hydratedRoutes.flatMap((route) => route.boundaries ?? []);
-    const boundaryBundles = await buildBoundaryBundlesForRecords(
-      boundaryRecords,
-      rootDir,
-      outDir,
-      options,
-      errors,
-    );
-    mergeBoundaryBundlesIntoManifest(
-      existingManifest,
-      hydratedRoutes.map((route) => route.id),
-      boundaryBundles,
-    );
-
-    const partialBundles: PartialBundleBuild[] = [];
+        };
+      }
+    }
+
+    const boundaryRecords = hydratedRoutes.flatMap((route) => route.boundaries ?? []);
+    const boundaryBundles = await buildBoundaryBundlesForRecords(
+      boundaryRecords,
+      rootDir,
+      outDir,
+      options,
+      errors,
+    );
+    mergeBoundaryBundlesIntoManifest(
+      existingManifest,
+      hydratedRoutes.map((route) => route.id),
+      boundaryBundles,
+    );
+
+    const partialBundles: PartialBundleBuild[] = [];
     if (partialFiles.length > 0) {
       const partialResults = await Promise.all(
         partialFiles.map(async (entry) => {
@@ -2331,22 +2347,22 @@ export async function buildClientBundles(
       JSON.stringify(existingManifest, null, 2),
     );
 
-    const stats = calculateStats(
-      outputs,
-      startTime,
-      [
-        ...partialBundles.map((partial) => ({
-          routeId: `partial:${partial.name}`,
-          size: partial.size,
-          gzipSize: partial.gzipSize,
-        })),
-        ...boundaryBundles.map((boundary) => ({
-          routeId: `boundary:${boundary.id}`,
-          size: boundary.size,
-          gzipSize: boundary.gzipSize,
-        })),
-      ],
-    );
+    const stats = calculateStats(
+      outputs,
+      startTime,
+      [
+        ...partialBundles.map((partial) => ({
+          routeId: `partial:${partial.name}`,
+          size: partial.size,
+          gzipSize: partial.gzipSize,
+        })),
+        ...boundaryBundles.map((boundary) => ({
+          routeId: `boundary:${boundary.id}`,
+          size: boundary.size,
+          gzipSize: boundary.gzipSize,
+        })),
+      ],
+    );
     return { success: errors.length === 0, outputs, errors, manifest: existingManifest, stats };
   }
 
@@ -2404,7 +2420,7 @@ export async function buildClientBundles(
 
   // 5. 각 Island 번들 병렬 빌드 (#185: L1631의 per-island와 일관성 확보)
   const fullIslandResults = await Promise.all(
-    hydratedRoutes.filter((route) => !!route.clientModule).map(async (route) => {
+    hydratedRoutes.filter((route) => !!route.clientModule).map(async (route) => {
       try {
         return { ok: true as const, result: await buildIsland(route, rootDir, outDir, options) };
       } catch (error) {
@@ -2413,27 +2429,27 @@ export async function buildClientBundles(
     }),
   );
   for (const r of fullIslandResults) {
-    if (r.ok) {
-      outputs.push(r.result);
-    } else {
-      const errorStr = r.error;
-      if (errorStr.includes("AggregateError") || errorStr.includes("Could not resolve")) {
-        const clientModule = r.route.clientModule || "";
-        errors.push(
-          `[${r.route.id}] ${errorStr}\n` +
-          `  Hint: Check import paths and browser-compatible exports for this island. File: ${clientModule}`,
-        );
-      } else {
-        errors.push(`[${r.route.id}] ${errorStr}`);
-      }
+    if (r.ok) {
+      outputs.push(r.result);
+    } else {
+      const errorStr = r.error;
+      if (errorStr.includes("AggregateError") || errorStr.includes("Could not resolve")) {
+        const clientModule = r.route.clientModule || "";
+        errors.push(
+          `[${r.route.id}] ${errorStr}\n` +
+          `  Hint: Check import paths and browser-compatible exports for this island. File: ${clientModule}`,
+        );
+      } else {
+        errors.push(`[${r.route.id}] ${errorStr}`);
+      }
     }
   }
 
   // 5.5. Per-island code splitting: scan and build individual island bundles
   const islandFiles = await scanIslandFiles(hydratedRoutes, rootDir);
-  const islandBundles: Array<{ name: string; js: string; route: string; priority: IslandFileEntry["priority"] }> = [];
+  const islandBundles: Array<{ name: string; js: string; route: string; priority: IslandFileEntry["priority"] }> = [];
 
-  if (islandFiles.length > 0) {
+  if (islandFiles.length > 0) {
     const islandResults = await Promise.all(
       islandFiles.map(async (entry) => {
         try {
@@ -2447,27 +2463,27 @@ export async function buildClientBundles(
     for (const result of islandResults) {
       if (result) islandBundles.push(result);
     }
-  }
-
-  const boundaryRecords = hydratedRoutes.flatMap((route) => route.boundaries ?? []);
-  const boundaryBundles: BoundaryBundleBuild[] = [];
-  if (boundaryRecords.length > 0 && !pushDuplicateBoundaryIdErrors(boundaryRecords, errors)) {
-    const boundaryResults = await Promise.all(
-      boundaryRecords.map(async (boundary) => {
-        try {
-          return await buildBoundaryBundle(boundary, rootDir, outDir, options);
-        } catch (error) {
-          errors.push(`[boundary:${boundary.id}] ${String(error)}`);
-          return null;
-        }
-      }),
-    );
-    for (const result of boundaryResults) {
-      if (result) boundaryBundles.push(result);
-    }
-  }
-
-  const partialBundles: PartialBundleBuild[] = [];
+  }
+
+  const boundaryRecords = hydratedRoutes.flatMap((route) => route.boundaries ?? []);
+  const boundaryBundles: BoundaryBundleBuild[] = [];
+  if (boundaryRecords.length > 0 && !pushDuplicateBoundaryIdErrors(boundaryRecords, errors)) {
+    const boundaryResults = await Promise.all(
+      boundaryRecords.map(async (boundary) => {
+        try {
+          return await buildBoundaryBundle(boundary, rootDir, outDir, options);
+        } catch (error) {
+          errors.push(`[boundary:${boundary.id}] ${String(error)}`);
+          return null;
+        }
+      }),
+    );
+    for (const result of boundaryResults) {
+      if (result) boundaryBundles.push(result);
+    }
+  }
+
+  const partialBundles: PartialBundleBuild[] = [];
   if (partialFiles.length > 0) {
     const partialResults = await Promise.all(
       partialFiles.map(async (entry) => {
@@ -2491,11 +2507,11 @@ export async function buildClientBundles(
     runtimeResult.outputPath,
     vendorResult,
     routerResult.outputPath,
-    env,
-    islandBundles,
-    partialBundles,
-    boundaryBundles,
-  );
+    env,
+    islandBundles,
+    partialBundles,
+    boundaryBundles,
+  );
 
   await fs.writeFile(
     path.join(rootDir, ".mandu/manifest.json"),
@@ -2503,22 +2519,22 @@ export async function buildClientBundles(
   );
 
   // 7. 통계 계산
-  const stats = calculateStats(
-    outputs,
-    startTime,
-    [
-      ...partialBundles.map((partial) => ({
-        routeId: `partial:${partial.name}`,
-        size: partial.size,
-        gzipSize: partial.gzipSize,
-      })),
-      ...boundaryBundles.map((boundary) => ({
-        routeId: `boundary:${boundary.id}`,
-        size: boundary.size,
-        gzipSize: boundary.gzipSize,
-      })),
-    ],
-  );
+  const stats = calculateStats(
+    outputs,
+    startTime,
+    [
+      ...partialBundles.map((partial) => ({
+        routeId: `partial:${partial.name}`,
+        size: partial.size,
+        gzipSize: partial.gzipSize,
+      })),
+      ...boundaryBundles.map((boundary) => ({
+        routeId: `boundary:${boundary.id}`,
+        size: boundary.size,
+        gzipSize: boundary.gzipSize,
+      })),
+    ],
+  );
 
   // Phase 18.τ — fire onBundleComplete(stats) before return.
   await fireOnBundleComplete(stats);
@@ -2547,15 +2563,15 @@ export function formatSize(bytes: number): string {
  */
 export function printBundleStats(result: BundleResult): void {
   console.log("\n📦 Mandu Client Bundles");
-  console.log("=".repeat(50));
-
-  const partialCount = Object.keys(result.manifest.partials ?? {}).length;
-  const boundaryCount = Object.keys(result.manifest.boundaries ?? {}).length;
-  if (result.outputs.length === 0 && partialCount === 0 && boundaryCount === 0) {
-    console.log("No islands, partials, or boundaries to bundle (hydration: none or no client entry)");
-    if (result.errors.length > 0) {
-      console.log("\n⚠️ Errors:");
-      for (const error of result.errors) {
+  console.log("=".repeat(50));
+
+  const partialCount = Object.keys(result.manifest.partials ?? {}).length;
+  const boundaryCount = Object.keys(result.manifest.boundaries ?? {}).length;
+  if (result.outputs.length === 0 && partialCount === 0 && boundaryCount === 0) {
+    console.log("No islands, partials, or boundaries to bundle (hydration: none or no client entry)");
+    if (result.errors.length > 0) {
+      console.log("\n⚠️ Errors:");
+      for (const error of result.errors) {
         console.log(`  ${error}`);
       }
     }
@@ -2575,14 +2591,14 @@ export function printBundleStats(result: BundleResult): void {
       `  ${output.routeId}: ${formatSize(output.size)} (gzip: ${formatSize(output.gzipSize)})`
     );
   }
-  if (partialCount > 0) {
-    console.log(`  Partials: ${partialCount}`);
-  }
-  if (boundaryCount > 0) {
-    console.log(`  Boundaries: ${boundaryCount}`);
-  }
-
-  if (result.errors.length > 0) {
+  if (partialCount > 0) {
+    console.log(`  Partials: ${partialCount}`);
+  }
+  if (boundaryCount > 0) {
+    console.log(`  Boundaries: ${boundaryCount}`);
+  }
+
+  if (result.errors.length > 0) {
     console.log("\n⚠️ Errors:");
     for (const error of result.errors) {
       console.log(`  ${error}`);