@simplysm/sd-cli 14.0.30 → 14.0.33

package/src/workers/client.worker.ts

@@ -1,18 +1,21 @@
-import { createServer, build as viteBuild, type ViteDevServer } from "vite";
 import path from "path";
 import fs from "node:fs";
-import http from "node:http";
-import mime from "mime";
 import { createWorker } from "@simplysm/core-node";
 import { err as errNs } from "@simplysm/core-common";
-import { consola } from "consola";
-import { registerCleanupHandlers, setupWorkerConsola } from "../utils/worker-utils.js";
-import { createClientViteConfig } from "../utils/vite-config.js";
-import type { ScopeWatchReplaceDep } from "../utils/vite-scope-watch-plugin.js";
-import type { SdPwaConfig } from "../sd-config.types.js";
-import { loadSdConfig } from "../utils/sd-config.js";
-
-setupWorkerConsola();
+import { setupWorkerLifecycle } from "./shared-worker-lifecycle.js";
+import {
+  createClientEsbuildContext,
+  type ClientEsbuildResult,
+} from "../esbuild/esbuild-client-config.js";
+import { generateIndexHtml } from "../esbuild/esbuild-index-html.js";
+import { applyPwa, createPwaHtmlTransform } from "../esbuild/esbuild-pwa.js";
+import { createDevHttpServer, type DevHttpServer } from "../dev-server/dev-http-server.js";
+import { createHmrService, type HmrService } from "../dev-server/hmr-service.js";
+import { createHmrPostTransform } from "../dev-server/hmr-client-script.js";
+import { copyPublicFiles, watchPublicFiles } from "../utils/copy-public.js";
+import type { SdBrowserSupportConfig, SdPwaConfig } from "../sd-config.types.js";
+import type { FsWatcher } from "@simplysm/core-node";
+import type esbuild from "esbuild";
 
 //#region Types
 
@@ -21,24 +24,20 @@ export interface ClientBuildInfo {
   name: string;
   cwd: string;
   pkgDir: string;
-  /** 클라이언트 프레임워크 선택 */
-  framework?: "angular" | "solid";
-  /** Vite dev server 포트 (standalone clients with server: number) */
+  /** dev server 포트 (standalone clients with server: number) */
   port?: number;
   /** 빌드 시 치환할 환경변수 */
   env?: Record<string, string>;
   /** 런타임 설정 (dist/.config.json에 기록) */
   configs?: Record<string, unknown>;
-  /** replaceDeps 목록 (dev 모드에서 sdScopeWatchPlugin에 전달) */
-  replaceDeps?: ScopeWatchReplaceDep[];
   /** PWA 설정. false로 비활성화. 미설정 시 기본값으로 활성화 */
   pwa?: false | SdPwaConfig;
-  /** Vite optimizeDeps.exclude에 전달할 패키지 목록 */
-  exclude?: string[];
   /** 빌드 출력 경로 (미설정 시 pkgDir/dist) */
   outDir?: string;
-  /** Vite base 경로 (미설정 시 /{pkgName}/) */
+  /** base 경로 (미설정 시 /{pkgName}/) */
   base?: string;
+  /** 브라우저 지원 설정 (메인 프로세스에서 전달, Worker 내 sd.config.ts 재로드 방지) */
+  browserSupport?: SdBrowserSupportConfig;
 }
 
 /** Client 빌드 결과 */
@@ -54,293 +53,282 @@ export interface ClientWorkerEvents extends Record<string, unknown> {
   build: ClientBuildResult;
   serverReady: { port: number };
   error: { message: string };
-  scopeRebuild: Record<string, never>;
 }
 
 //#endregion
 
 //#region Worker
 
-const logger = consola.withTag("sd:cli:client:worker");
-
-/** viteBuild({ build: { watch: {} } }) 반환 타입의 최소 인터페이스 */
-interface WatcherHandle {
-  on(event: string, handler: (event: { code: string; error?: { message: string } }) => void): void;
-  close(): Promise<void>;
-}
-
-let viteServer: ViteDevServer | undefined;
-let rollupWatcher: WatcherHandle | undefined;
-let legacyHttpServer: http.Server | undefined;
-
-/** SSE 연결된 클라이언트 목록 (live reload용) */
-const sseClients = new Set<http.ServerResponse>();
-
-/** SSE 연결된 모든 클라이언트에 reload 신호를 전송한다 */
-function notifyLiveReload(): void {
-  for (const client of sseClients) {
-    client.write("data: reload\n\n");
-  }
-}
-
-
-/** live reload 클라이언트 스크립트 (HTML에 주입) */
-const LIVE_RELOAD_SCRIPT = `<script>(function(){var s=new EventSource("__live-reload");s.onmessage=function(){location.reload();};})()</script>`;
-
-/**
- * HTML 응답 시 live reload 스크립트를 </body> 직전에 주입한다.
- */
-function injectLiveReloadScript(html: string): string {
-  const idx = html.lastIndexOf("</body>");
-  if (idx !== -1) {
-    return html.slice(0, idx) + LIVE_RELOAD_SCRIPT + html.slice(idx);
-  }
-  return html + LIVE_RELOAD_SCRIPT;
-}
-
-/**
- * legacy dev 모드용 HTTP 정적 파일 서버를 생성한다.
- * dist/ 디렉토리의 파일을 서빙하고, SPA fallback + SSE live reload를 지원한다.
- */
-function createLegacyHttpServer(distDir: string, basePath: string): http.Server {
-  return http.createServer((req, res) => {
-    const url = (req.url ?? "/").split("?")[0];
-
-    // basePath prefix 제거
-    let relativePath: string;
-    if (url.startsWith(basePath)) {
-      relativePath = url.slice(basePath.length);
-    } else {
-      res.writeHead(404);
-      res.end("Not Found");
-      return;
-    }
-
-    // SSE live reload 엔드포인트
-    if (relativePath === "__live-reload" || relativePath === "/__live-reload") {
-      res.writeHead(200, {
-        "Content-Type": "text/event-stream",
-        "Cache-Control": "no-cache",
-        "Connection": "keep-alive",
-      });
-      sseClients.add(res);
-      req.on("close", () => {
-        sseClients.delete(res);
-      });
-      return;
-    }
-
-    // 빈 경로 또는 / → index.html
-    if (relativePath === "" || relativePath === "/") {
-      relativePath = "index.html";
-    }
+let esbuildResult: ClientEsbuildResult | undefined;
+let devServer: DevHttpServer | undefined;
+let hmrService: HmrService | undefined;
+let publicWatcher: FsWatcher | undefined;
 
-    // 선행 슬래시 제거
-    if (relativePath.startsWith("/")) {
-      relativePath = relativePath.slice(1);
-    }
-
-    const filePath = path.join(distDir, relativePath);
-    const ext = path.extname(filePath);
-
-    // 파일 존재 확인
-    if (fs.existsSync(filePath) && !fs.statSync(filePath).isDirectory()) {
-      const contentType = mime.getType(ext) ?? "application/octet-stream";
-      if (ext === ".html") {
-        // HTML: live reload 스크립트 주입
-        const content = injectLiveReloadScript(fs.readFileSync(filePath, "utf-8"));
-        res.writeHead(200, { "Content-Type": contentType });
-        res.end(content);
-      } else {
-        const content = fs.readFileSync(filePath);
-        res.writeHead(200, { "Content-Type": contentType });
-        res.end(content);
-      }
-    } else {
-      // SPA fallback: index.html 반환 (live reload 스크립트 주입)
-      const indexPath = path.join(distDir, "index.html");
-      if (fs.existsSync(indexPath)) {
-        const content = injectLiveReloadScript(fs.readFileSync(indexPath, "utf-8"));
-        res.writeHead(200, { "Content-Type": "text/html" });
-        res.end(content);
-      } else {
-        res.writeHead(404);
-        res.end("Not Found");
-      }
-    }
-  });
-}
+const { logger, guardStartWatch } = setupWorkerLifecycle("client", async () => {
+  await stopWatch();
+});
 
-async function resolvePackageInfo(info: ClientBuildInfo): Promise<{
+function resolvePackageInfo(info: ClientBuildInfo): {
   pkgName: string;
   legacyModule: boolean;
-}> {
+  browserslist: string | string[] | undefined;
+  postcssPlugins: [string, (object | string)?][] | undefined;
+} {
   const pkgJsonPath = path.join(info.pkgDir, "package.json");
   const pkgName = (
     JSON.parse(fs.readFileSync(pkgJsonPath, "utf-8")) as { name: string }
   ).name;
-  const name = pkgName.replace(/^@[^/]+\//, "");
-  const sdConfig = await loadSdConfig({ cwd: info.cwd, dev: true, opt: [] });
-  const pkgConfig = sdConfig.packages[name];
-  const legacyModule = pkgConfig?.target === "client" ? pkgConfig.browserSupport?.legacyModule === true : false;
-  return { pkgName, legacyModule };
+  return {
+    pkgName,
+    legacyModule: info.browserSupport?.legacyModule === true,
+    browserslist: info.browserSupport?.browserslist,
+    postcssPlugins: info.browserSupport?.postCss?.plugins,
+  };
 }
 
 /**
- * dev server 시작. Vite dev server를 생성하고 listen한다.
- * 서버가 준비되면 serverReady 이벤트로 포트를 알린다.
+ * 프로덕션 빌드
  */
-async function startWatch(info: ClientBuildInfo): Promise<ClientBuildResult> {
-  const { pkgName, legacyModule } = await resolvePackageInfo(info);
-  if (legacyModule) {
-    return startLegacyWatch(info, pkgName);
-  }
-  logger.debug(`[${info.name}] client worker startWatch 시작 (port: ${info.port ?? "auto"})`);
+async function build(info: ClientBuildInfo): Promise<ClientBuildResult> {
+  logger.debug(`[${info.name}] client worker build 시작`);
   try {
+    const { pkgName, legacyModule, browserslist, postcssPlugins } =
+      resolvePackageInfo(info);
+
+    const outdir = info.outDir ?? path.join(info.pkgDir, "dist");
+
+    // 1. public/ 복사
+    await copyPublicFiles(info.pkgDir, false);
 
-    // polyfills.ts 자동 감지
+    // 2. polyfills 감지
     const polyfillsPath = path.join(info.pkgDir, "src", "polyfills.ts");
-    const polyfills = fs.existsSync(polyfillsPath) ? ["./src/polyfills.ts"] : undefined;
+    const polyfills = fs.existsSync(polyfillsPath) ? ["src/polyfills.ts"] : undefined;
 
-    const viteConfig = await createClientViteConfig({
-      framework: info.framework,
+    // 3. esbuild context 생성
+    const entryNames = ["main", ...(polyfills != null ? ["polyfills"] : [])];
+
+    const templateUpdates = new Map<string, string>();
+    const ctx = await createClientEsbuildContext({
       pkgDir: info.pkgDir,
-      pkgName,
-      mode: "dev",
-      serverPort: info.port ?? 0,
+      cwd: info.cwd,
+      mode: "build",
       env: info.env,
-      onBuildStart: () => sender.send("buildStart", {}),
-      onBuild: (result) => sender.send("build", result),
-      replaceDeps: info.replaceDeps,
-      onScopeRebuild: () => sender.send("scopeRebuild", {}),
+      outdir,
+      browserslist,
       polyfills,
-      pwa: info.pwa,
-      exclude: info.exclude,
+      legacyModule,
+      postcssPlugins,
+      postcssConfigPath: info.pkgDir,
+      templateUpdates,
     });
 
-    logger.debug(`[${info.name}] Vite server 생성 시작`);
-    viteServer = await createServer(viteConfig);
-    await viteServer.listen();
-    logger.debug(`[${info.name}] Vite server listen 완료`);
-
-    // 실제 포트 감지
-    const address = viteServer.httpServer?.address();
-    const actualPort =
-      typeof address === "object" && address != null ? address.port : undefined;
-
-    if (actualPort == null) {
-      sender.send("error", {
-        message: "Vite dev server 포트를 감지할 수 없습니다.",
-      });
-      return {
-        success: false,
-        errors: ["Vite dev server 포트를 감지할 수 없습니다."],
-      };
-    }
+    // 4. 빌드 실행
+    const result = await ctx.context.rebuild();
 
-    sender.send("serverReady", { port: actualPort });
+    // 5. index.html 생성
+    const name = pkgName.replace(/^@[^/]+\//, "");
+    const basePath = info.base ?? `/${name}/`;
+    const indexPath = path.join(info.pkgDir, "src", "index.html");
 
-    // .dev-port 기록 (device 명령어에서 자동 탐지용)
-    const distDir = path.join(info.pkgDir, "dist");
-    fs.mkdirSync(distDir, { recursive: true });
-    fs.writeFileSync(path.join(distDir, ".dev-port"), String(actualPort));
+    const pwaHtmlTransform =
+      info.pwa !== false ? createPwaHtmlTransform() : undefined;
 
-    // .config.json 생성
-    writeConfigJson(distDir, info.configs);
+    const indexResult = await generateIndexHtml({
+      indexPath,
+      metafile: result.metafile!,
+      outdir,
+      baseHref: basePath,
+      mode: "build",
+      entryNames,
+      postTransform: pwaHtmlTransform,
+    });
+
+    fs.writeFileSync(path.join(outdir, "index.html"), indexResult.content);
 
-    return { success: true };
+    // 6. PWA 적용
+    await applyPwa({
+      pkgDir: info.pkgDir,
+      pkgName: name,
+      cwd: info.cwd,
+      outdir,
+      baseHref: basePath,
+      mode: "build",
+      pwa: info.pwa,
+    });
+
+    // 7. 리소스 해제
+    await ctx.context.dispose();
+    // SourceFileCache는 LMDB 기반. context.dispose()에 의해 정리됨.
+
+    // 8. .config.json 기록
+    writeConfigJson(path.join(info.pkgDir, "dist"), info.configs);
+
+    logger.debug(`[${info.name}] client worker build 완료`);
+    return {
+      success: indexResult.errors.length === 0,
+      errors: indexResult.errors.length > 0 ? indexResult.errors : undefined,
+      warnings: indexResult.warnings.length > 0 ? indexResult.warnings : undefined,
+    };
   } catch (err) {
-    const message = errNs.message(err);
-    sender.send("error", { message });
-    return { success: false, errors: [message] };
+    const errors: string[] = [];
+    if (err != null && typeof err === "object" && "errors" in err) {
+      const buildErrors = (err as { errors: Array<{ text: string }> }).errors;
+      errors.push(...buildErrors.map((e) => e.text));
+    }
+    if (errors.length === 0) {
+      errors.push(errNs.message(err));
+    }
+    logger.debug(`[${info.name}] client worker build 예외: ${errors.join("; ")}`);
+    return { success: false, errors };
   }
 }
 
 /**
- * legacy watch 시작. Vite build --watch로 파일 변경을 감시한다.
- * legacyModule: true일 때 createServer 대신 사용한다.
+ * dev watch 시작
  */
-async function startLegacyWatch(info: ClientBuildInfo, pkgName: string): Promise<ClientBuildResult> {
-  logger.debug(`[${info.name}] client worker startLegacyWatch 시작`);
+async function startWatch(info: ClientBuildInfo): Promise<ClientBuildResult> {
+  guardStartWatch();
+  const { pkgName, legacyModule, browserslist, postcssPlugins } =
+    resolvePackageInfo(info);
+
+  logger.debug(
+    `[${info.name}] client worker startWatch 시작 (port: ${info.port ?? "auto"}, legacy: ${legacyModule})`,
+  );
+
   try {
+    const outdir = path.join(info.pkgDir, "dist");
+    const name = pkgName.replace(/^@[^/]+\//, "");
+    const basePath = info.base ?? `/${name}/`;
 
-    // dist 초기화 (첫 빌드만 비움)
-    const distDir = path.join(info.pkgDir, "dist");
-    fs.rmSync(distDir, { recursive: true, force: true });
+    // 1. dist/ 초기화
+    fs.rmSync(outdir, { recursive: true, force: true });
 
-    // polyfills.ts 자동 감지
+    // 2. public/ 복사 + 감시
+    publicWatcher = await watchPublicFiles(info.pkgDir, true);
+
+    // 3. polyfills 감지
     const polyfillsPath = path.join(info.pkgDir, "src", "polyfills.ts");
-    const polyfills = fs.existsSync(polyfillsPath) ? ["./src/polyfills.ts"] : undefined;
+    const polyfills = fs.existsSync(polyfillsPath) ? ["src/polyfills.ts"] : undefined;
+    const entryNames = ["main", ...(polyfills != null ? ["polyfills"] : [])];
+
+    // 4. templateUpdates Map + esbuild context 생성
+    const templateUpdates = new Map<string, string>();
+    let initialBuildResolve: ((result: ClientBuildResult) => void) | undefined;
+    let isInitialBuild = true;
 
-    const viteConfig = await createClientViteConfig({
-      framework: info.framework,
+    esbuildResult = await createClientEsbuildContext({
       pkgDir: info.pkgDir,
-      pkgName,
+      cwd: info.cwd,
       mode: "dev",
-      serverPort: 0,
       env: info.env,
-      watch: true,
-      onBuildStart: () => sender.send("buildStart", {}),
-      onBuild: (result) => sender.send("build", result),
-      replaceDeps: info.replaceDeps,
-      onScopeRebuild: () => sender.send("scopeRebuild", {}),
+      outdir,
+      browserslist,
       polyfills,
-      pwa: false,
-      exclude: info.exclude,
-    });
+      legacyModule,
+      postcssPlugins,
+      postcssConfigPath: info.pkgDir,
+      templateUpdates: legacyModule ? undefined : templateUpdates,
+      plugins: [
+        {
+          name: "sd-build-start",
+          setup(pluginBuild: esbuild.PluginBuild) {
+            pluginBuild.onStart(() => {
+              if (!isInitialBuild) {
+                sender.send("buildStart", {});
+              }
+            });
+          },
+        },
+      ],
+      onEnd: async (result: esbuild.BuildResult) => {
+        try {
+          // index.html 재생성
+          if (result.metafile != null) {
+            const hmrPostTransform = createHmrPostTransform(basePath);
+            const indexPath = path.join(info.pkgDir, "src", "index.html");
+            const indexResult = await generateIndexHtml({
+              indexPath,
+              metafile: result.metafile,
+              outdir,
+              baseHref: basePath,
+              mode: "dev",
+              entryNames,
+              postTransform: hmrPostTransform,
+            });
+            fs.writeFileSync(path.join(outdir, "index.html"), indexResult.content);
+          }
 
-    const watcher = (await viteBuild(viteConfig)) as WatcherHandle;
-    rollupWatcher = watcher;
+          // HMR 메시지 디스패치
+          if (hmrService != null && result.metafile != null && !isInitialBuild) {
+            hmrService.onBuildEnd(result.metafile);
+          }
 
-    // .config.json 생성
-    writeConfigJson(path.join(info.pkgDir, "dist"), info.configs);
+          // build 이벤트 전송
+          const success = result.errors.length === 0;
+          if (!isInitialBuild) {
+            sender.send("build", {
+              success,
+              errors:
+                result.errors.length > 0
+                  ? result.errors.map((e) => e.text)
+                  : undefined,
+              warnings:
+                result.warnings.length > 0
+                  ? result.warnings.map((w) => w.text)
+                  : undefined,
+            });
+          }
 
-    // HTTP 정적 파일 서버 시작
-    const name = pkgName.replace(/^@[^/]+\//, "");
-    const basePath = `/${name}/`;
-    const httpServer = createLegacyHttpServer(distDir, basePath);
-    legacyHttpServer = httpServer;
-
-    const serverPort = await new Promise<number>((resolve, reject) => {
-      httpServer.listen(info.port ?? 0, "0.0.0.0", () => {
-        const addr = httpServer.address();
-        if (typeof addr === "object" && addr != null) {
-          resolve(addr.port);
-        } else {
-          reject(new Error("HTTP 서버 포트를 감지할 수 없습니다."));
+          // 초기 빌드 완료 시 resolve
+          if (isInitialBuild) {
+            isInitialBuild = false;
+            initialBuildResolve?.({ success });
+          }
+        } catch (err) {
+          const message = errNs.message(err);
+          sender.send("error", { message });
+          if (isInitialBuild) {
+            isInitialBuild = false;
+            initialBuildResolve?.({ success: false, errors: [message] });
+          }
         }
-      });
-      httpServer.on("error", reject);
+      },
     });
 
-    sender.send("serverReady", { port: serverPort });
+    // 5. HTTP dev server 생성
+    const httpDevServer = createDevHttpServer({
+      distDir: outdir,
+      basePath,
+      port: info.port ?? 0,
+      onRequest: (req, res) => hmrService?.handleRequest(req, res) ?? false,
+    });
+    devServer = httpDevServer;
 
-    // .dev-port 기록 (device 명령어에서 자동 탐지용)
-    fs.writeFileSync(path.join(info.pkgDir, "dist", ".dev-port"), String(serverPort));
+    // 6. HMR WebSocket 서비스 생성
+    hmrService = createHmrService({
+      httpServer: httpDevServer.httpServer,
+      basePath,
+      templateUpdates,
+    });
 
-    // 첫 빌드 완료 대기
-    return await new Promise<ClientBuildResult>((resolve) => {
-      let firstBuildResolved = false;
+    // 7. esbuild watch 시작 + 초기 빌드 대기
+    await esbuildResult.context.watch();
 
-      watcher.on("event", (event: { code: string; error?: { message: string } }) => {
-        if (event.code === "END") {
-          if (!firstBuildResolved) {
-            firstBuildResolved = true;
-            resolve({ success: true });
-          } else {
-            // 재빌드 완료 → 브라우저 live reload
-            notifyLiveReload();
-          }
-        } else if (event.code === "ERROR") {
-          const message = event.error?.message ?? "Unknown build error";
-          sender.send("error", { message });
-          if (!firstBuildResolved) {
-            firstBuildResolved = true;
-            resolve({ success: false, errors: [message] });
-          }
-        }
-      });
+    const initialResult = await new Promise<ClientBuildResult>((resolve) => {
+      initialBuildResolve = resolve;
     });
+
+    // 8. HTTP 서버 시작
+    const actualPort = await httpDevServer.listen();
+
+    // 9. serverReady 이벤트 전송
+    sender.send("serverReady", { port: actualPort });
+
+    // 10. .config.json + .dev-port 기록
+    writeConfigJson(outdir, info.configs);
+    fs.writeFileSync(path.join(outdir, ".dev-port"), String(actualPort));
+
+    return initialResult;
   } catch (err) {
     const message = errNs.message(err);
     sender.send("error", { message });
@@ -349,90 +337,36 @@ async function startLegacyWatch(info: ClientBuildInfo, pkgName: string): Promise
 }
 
 /**
- * dev server 중지. Vite server 또는 RollupWatcher를 정리한다.
+ * dev watch 중지
  */
 async function stopWatch(): Promise<void> {
-  logger.debug("Vite server 정리 시작");
+  logger.debug("esbuild watch 정리 시작");
 
-  const watcherToClose = rollupWatcher;
-  rollupWatcher = undefined;
-  if (watcherToClose != null) {
-    await watcherToClose.close();
+  // 1. esbuild context dispose
+  if (esbuildResult != null) {
+    await esbuildResult.context.dispose();
+    esbuildResult = undefined;
   }
 
-  // SSE 클라이언트 정리
-  for (const client of sseClients) {
-    client.end();
-  }
-  sseClients.clear();
-
-  const httpServerToClose = legacyHttpServer;
-  legacyHttpServer = undefined;
-  if (httpServerToClose != null) {
-    await new Promise<void>((resolve, reject) => {
-      httpServerToClose.close((err) => {
-        if (err != null) reject(err);
-        else resolve();
-      });
-    });
+  // 2. HMR 서비스 종료
+  if (hmrService != null) {
+    hmrService.close();
+    hmrService = undefined;
   }
 
-  const serverToClose = viteServer;
-  viteServer = undefined;
-  if (serverToClose != null) {
-    await serverToClose.close();
+  // 3. HTTP 서버 종료
+  if (devServer != null) {
+    await devServer.close();
+    devServer = undefined;
   }
 
-  logger.debug("Vite server 정리 완료");
-}
-
-/**
- * 프로덕션 빌드. Vite build API로 번들을 생성한다.
- */
-async function build(info: ClientBuildInfo): Promise<ClientBuildResult> {
-  logger.debug(`[${info.name}] client worker build 시작`);
-  try {
-    const { pkgName } = await resolvePackageInfo(info);
-
-    // polyfills.ts 자동 감지
-    const polyfillsPath = path.join(info.pkgDir, "src", "polyfills.ts");
-    const polyfills = fs.existsSync(polyfillsPath) ? ["./src/polyfills.ts"] : undefined;
-
-    let buildSuccess = true;
-    let buildErrors: string[] | undefined;
-    let buildWarnings: string[] | undefined;
-
-    const viteConfig = await createClientViteConfig({
-      framework: info.framework,
-      pkgDir: info.pkgDir,
-      pkgName,
-      mode: "build",
-      serverPort: 0,
-      env: info.env,
-      onBuild: (result) => {
-        buildSuccess = result.success;
-        buildErrors = result.errors;
-        buildWarnings = result.warnings;
-      },
-      polyfills,
-      pwa: info.pwa,
-      exclude: info.exclude,
-      outDir: info.outDir,
-      base: info.base,
-    });
-
-    await viteBuild(viteConfig);
-
-    // .config.json 생성 (항상 dist/에 기록 — outDir과 무관)
-    writeConfigJson(path.join(info.pkgDir, "dist"), info.configs);
-
-    logger.debug(`[${info.name}] client worker build 완료`);
-    return { success: buildSuccess, errors: buildErrors, warnings: buildWarnings };
-  } catch (err) {
-    const message = errNs.message(err);
-    logger.debug(`[${info.name}] client worker build 예외: ${message}`);
-    return { success: false, errors: [message] };
+  // 4. public/ 감시 종료
+  if (publicWatcher != null) {
+    await publicWatcher.close();
+    publicWatcher = undefined;
   }
+
+  logger.debug("esbuild watch 정리 완료");
 }
 
 /** .config.json 생성 */
@@ -447,10 +381,6 @@ function writeConfigJson(
   );
 }
 
-registerCleanupHandlers(async () => {
-  await stopWatch();
-}, logger);
-
 const sender = createWorker<
   {
     build: typeof build;