@simplysm/sd-cli 14.0.29 → 14.0.32

package/src/workers/server-watch-manager.ts

@@ -0,0 +1,124 @@
+import fs from "fs";
+import type { ConsolaInstance } from "consola";
+import { FsWatcher, pathx } from "@simplysm/core-node";
+import { err as errNs } from "@simplysm/core-common";
+import type { ServerWatchInfo } from "./server-build.worker";
+import {
+  parseTsconfig,
+  getPackageSourceFiles,
+} from "../utils/tsconfig";
+import { collectAllExternals } from "../deps/server-externals/server-production-files";
+import { hasFileAddOrRemove } from "./build-change-filter";
+import * as esbuildCtx from "./server-esbuild-context";
+
+/**
+ * server-build watch 루프 설정
+ */
+export interface ServerWatchLoopConfig {
+  info: ServerWatchInfo;
+  watchPaths: string[];
+  logger: ConsolaInstance;
+  /** watch 시작 시 수집된 초기 외부 모듈 */
+  initialExternals: string[];
+  /** 빌드 시작 이벤트 콜백 */
+  onBuildStart: () => void;
+  /** 빌드 완료 이벤트 콜백 */
+  onBuild: (result: { build: { success: boolean; errors?: string[]; warnings?: string[] }; mainJsPath: string }) => void;
+  /** 에러 이벤트 콜백 */
+  onError: (message: string) => void;
+  /** 리빌드 실행 콜백 */
+  rebuild: () => Promise<{ build: { success: boolean; errors?: string[]; warnings?: string[] }; mainJsPath: string }>;
+}
+
+/**
+ * server-build 전용 FsWatcher 감시 루프를 시작한다.
+ *
+ * onChange 핸들러:
+ * - 파일 추가/삭제: tsconfig 재파싱, esbuild context 재생성, 리빌드
+ * - 파일 변경: metafile 기반 필터링 → 관련 파일이면 리빌드, 아니면 건너뜀
+ */
+export async function startServerWatchLoop(config: ServerWatchLoopConfig): Promise<FsWatcher> {
+  const { info, watchPaths, logger } = config;
+  let cachedExternal = [...config.initialExternals];
+
+  const watcher = await FsWatcher.watch(watchPaths);
+
+  watcher.onChange({ delay: 300 }, async (changes) => {
+    try {
+      const addOrRemove = hasFileAddOrRemove(changes);
+
+      if (addOrRemove) {
+        config.onBuildStart();
+
+        // 파일 추가/삭제 시 컨텍스트 재생성
+        const newParsedConfig = parseTsconfig(info.pkgDir);
+        const newEntryPoints = getPackageSourceFiles(info.pkgDir, newParsedConfig);
+
+        // package.json이 변경된 경우에만 외부 모듈 재수집
+        const hasPackageJsonChange = changes.some((c) =>
+          c.path.endsWith("package.json"),
+        );
+        if (hasPackageJsonChange) {
+          cachedExternal = collectAllExternals(info.pkgDir, info.externals);
+        }
+
+        if (info.output.js) {
+          await esbuildCtx.recreateContext({
+            pkgDir: info.pkgDir,
+            entryPoints: newEntryPoints,
+            env: info.env,
+            external: cachedExternal,
+          });
+        }
+
+        const result = await config.rebuild();
+        config.onBuild(result);
+        return;
+      }
+
+      // 파일 변경만 있는 경우: metafile로 필터링
+      if (!esbuildCtx.hasContext()) {
+        config.onBuildStart();
+        const result = await config.rebuild();
+        config.onBuild(result);
+        return;
+      }
+
+      const currentMetafile = esbuildCtx.getMetafile();
+      if (currentMetafile == null) {
+        config.onBuildStart();
+        const result = await config.rebuild();
+        config.onBuild(result);
+        return;
+      }
+
+      // metafile 입력 기반 필터링
+      const metafileAbsPaths = new Set(
+        Object.keys(currentMetafile.inputs).map((key) => pathx.posixResolve(info.cwd, key)),
+      );
+
+      const hasRelevantChange = changes.some((c) => {
+        if (metafileAbsPaths.has(c.path)) return true;
+        // pnpm symlink 경로와 esbuild resolved 경로 불일치 대응
+        try {
+          const realPath = pathx.posix(fs.realpathSync(c.path));
+          return metafileAbsPaths.has(realPath);
+        } catch {
+          return false;
+        }
+      });
+
+      if (hasRelevantChange) {
+        config.onBuildStart();
+        const result = await config.rebuild();
+        config.onBuild(result);
+      } else {
+        logger.debug("변경된 파일이 빌드에 포함되지 않아 리빌드 건너뜀");
+      }
+    } catch (err) {
+      config.onError(errNs.message(err));
+    }
+  });
+
+  return watcher;
+}

package/src/workers/shared-worker-lifecycle.ts

@@ -0,0 +1,24 @@
+import { type ConsolaInstance, consola } from "consola";
+import {
+  setupWorkerConsola,
+  registerCleanupHandlers,
+  createOnceGuard,
+} from "../runtime/worker-utils";
+
+/**
+ * Worker Thread의 공통 초기화를 단일 호출로 수행한다.
+ *
+ * 1. setupWorkerConsola() — consola CLI 모드 설정
+ * 2. consola.withTag() — 워커별 태그 로거 생성
+ * 3. registerCleanupHandlers() — SIGTERM/SIGINT 정리 핸들러 등록
+ * 4. createOnceGuard("startWatch") — startWatch 중복 호출 방지 가드 생성
+ */
+export function setupWorkerLifecycle(
+  workerName: string,
+  cleanupFn: () => void | Promise<void>,
+): { logger: ConsolaInstance; guardStartWatch: () => void } {
+  setupWorkerConsola();
+  const logger = consola.withTag(`sd:cli:${workerName}:worker`);
+  registerCleanupHandlers(cleanupFn, logger);
+  return { logger, guardStartWatch: createOnceGuard("startWatch") };
+}

package/tests/angular/angular-build-pipeline.spec.ts

@@ -1,8 +1,8 @@
 import { describe, it, expect } from "vitest";
 import path from "path";
 import ts from "typescript";
-import { AngularBuildPipeline } from "../../src/utils/angular-build-pipeline.js";
-import { AngularSourceFileCache } from "../../src/utils/angular-compiler.js";
+import { AngularBuildPipeline } from "../../src/angular/angular-build-pipeline.js";
+import { AngularSourceFileCache } from "../../src/angular/angular-compiler.js";
 import { getPackageSourceFiles } from "../../src/utils/tsconfig.js";
 
 const FIXTURE_DIR = path.resolve(import.meta.dirname, "fixtures/packages/basic-app");

package/tests/angular/angular-compiler-aot.acc.spec.ts

@@ -0,0 +1,68 @@
+import { describe, it, expect, afterEach } from "vitest";
+import path from "path";
+import ts from "typescript";
+import { AngularCompiler, AngularSourceFileCache } from "../../src/angular/angular-compiler.js";
+
+const FIXTURE_DIR = path.resolve(import.meta.dirname, "fixtures/packages/basic-app");
+const TSCONFIG_PATH = path.join(FIXTURE_DIR, "tsconfig.json");
+const APP_COMPONENT_PATH = path.join(FIXTURE_DIR, "src/app.component.ts").replace(/\\/g, "/");
+
+function loadTsConfig(): { rootNames: string[]; compilerOptions: ts.CompilerOptions } {
+  const configFile = ts.readConfigFile(TSCONFIG_PATH, ts.sys.readFile);
+  const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, FIXTURE_DIR);
+  return { rootNames: parsed.fileNames, compilerOptions: parsed.options };
+}
+
+describe("AngularCompiler AOT (HMR dead code 제거 후)", () => {
+  let compiler: AngularCompiler | undefined;
+
+  afterEach(() => {
+    compiler = undefined;
+  });
+
+  // Scenario: initialize() 반환에 templateUpdates가 없음
+  // Scenario: enableHmr 없이 pipeline.initialize()를 호출하면 AOT 컴파일이 정상 완료된다
+  it("initialize returns affectedFiles without templateUpdates", async () => {
+    const { rootNames, compilerOptions } = loadTsConfig();
+
+    compiler = new AngularCompiler({
+      rootNames,
+      compilerOptions,
+      compilerOptionsTransformer: (opts) => ({ ...opts, noEmit: false, declaration: false }),
+    });
+
+    const result = await compiler.initialize();
+
+    // affectedFiles가 반환된다
+    expect(result.affectedFiles).toBeDefined();
+    expect(result.affectedFiles.size).toBeGreaterThan(0);
+
+    // templateUpdates가 반환 객체에 존재하지 않는다
+    expect("templateUpdates" in result).toBe(false);
+  });
+
+  // Scenario: update() 반환에 templateUpdates가 없음
+  // Scenario: 증분 재컴파일 정상 동작
+  it("update returns affectedFiles without templateUpdates", async () => {
+    const { rootNames, compilerOptions } = loadTsConfig();
+    const sourceFileCache = new AngularSourceFileCache();
+
+    compiler = new AngularCompiler({
+      rootNames,
+      compilerOptions,
+      sourceFileCache,
+      compilerOptionsTransformer: (opts) => ({ ...opts, noEmit: false, declaration: false }),
+    });
+
+    await compiler.initialize();
+
+    // 파일 변경 후 update() 호출
+    const updateResult = await compiler.update([APP_COMPONENT_PATH]);
+
+    // affectedFiles가 반환된다
+    expect(updateResult.affectedFiles).toBeDefined();
+
+    // templateUpdates가 반환 객체에 존재하지 않는다
+    expect("templateUpdates" in updateResult).toBe(false);
+  });
+});

package/tests/angular/angular-compiler-aot.spec.ts

@@ -0,0 +1,80 @@
+import { describe, it, expect } from "vitest";
+import path from "path";
+import ts from "typescript";
+import { AngularCompiler, AngularSourceFileCache } from "../../src/angular/angular-compiler.js";
+import { AngularBuildPipeline } from "../../src/angular/angular-build-pipeline.js";
+import { getPackageSourceFiles } from "../../src/utils/tsconfig.js";
+
+const FIXTURE_DIR = path.resolve(import.meta.dirname, "fixtures/packages/basic-app");
+const TSCONFIG_PATH = path.join(FIXTURE_DIR, "tsconfig.json");
+
+function loadTsConfig(): { rootNames: string[]; compilerOptions: ts.CompilerOptions } {
+  const configFile = ts.readConfigFile(TSCONFIG_PATH, ts.sys.readFile);
+  const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, FIXTURE_DIR);
+  return { rootNames: parsed.fileNames, compilerOptions: parsed.options };
+}
+
+describe("AngularCompiler — HMR 코드 제거", () => {
+  // initialize() 반환 객체에 templateUpdates 키가 없다
+  it("initialize result has no templateUpdates property", async () => {
+    const { rootNames, compilerOptions } = loadTsConfig();
+    const compiler = new AngularCompiler({
+      rootNames,
+      compilerOptions,
+      compilerOptionsTransformer: (opts) => ({ ...opts, noEmit: false, declaration: false }),
+    });
+
+    const result = await compiler.initialize();
+    expect(Object.keys(result)).toEqual(["affectedFiles"]);
+  });
+
+});
+
+describe("AngularBuildPipeline — HMR 전파 제거", () => {
+  function createPipelineOptions() {
+    const configFile = ts.readConfigFile(TSCONFIG_PATH, ts.sys.readFile);
+    const parsed = ts.parseJsonConfigFileContent(configFile.config, ts.sys, FIXTURE_DIR);
+    const rootNames = getPackageSourceFiles(FIXTURE_DIR, parsed);
+    return {
+      mode: "library" as const,
+      pkgDir: FIXTURE_DIR,
+      cwd: FIXTURE_DIR,
+      rootNames,
+      compilerOptions: {
+        ...parsed.options,
+        noEmit: false,
+        declaration: false,
+        declarationMap: false,
+      },
+      angularCompilerOptions: parsed.raw?.angularCompilerOptions as
+        | Record<string, unknown>
+        | undefined,
+    };
+  }
+
+  // PipelineResult에 templateUpdates가 없다
+  it("pipeline result has no templateUpdates property", async () => {
+    const pipeline = new AngularBuildPipeline(createPipelineOptions());
+    const result = await pipeline.initialize();
+
+    expect("templateUpdates" in result).toBe(false);
+    expect(result.affectedFiles).toBeDefined();
+    expect(result.diagnostics).toBeDefined();
+    expect(result.scssErrors).toBeDefined();
+  });
+
+  // pipeline update 결과에도 templateUpdates가 없다
+  it("pipeline update result has no templateUpdates property", async () => {
+    const pipeline = new AngularBuildPipeline({
+      ...createPipelineOptions(),
+      sourceFileCache: new AngularSourceFileCache(),
+    });
+    await pipeline.initialize();
+
+    const appPath = path.join(FIXTURE_DIR, "src/app.component.ts").replace(/\\/g, "/");
+    const updateResult = await pipeline.update([appPath]);
+
+    expect("templateUpdates" in updateResult).toBe(false);
+    expect(updateResult.affectedFiles).toBeDefined();
+  });
+});

package/tests/angular/angular-compiler-hmr-removal.verify.md

@@ -0,0 +1,16 @@
+# AngularCompiler HMR dead code 제거 — LLM 검증
+
+## 검증 항목
+
+- [x] enableHmr 프로퍼티가 AngularCompilerOptions에서 제거됨: `angular-compiler.ts` 인터페이스에 `enableHmr` 없음 확인
+- [x] HMR_MODIFIED_FILE_LIMIT 상수가 제거됨: `angular-compiler.ts`에서 해당 상수 없음 확인
+- [x] collectHmrCandidates import가 제거됨: `angular-compiler.ts`에서 `hmr-candidates` import 없음 확인
+- [x] stale source file 수집 로직이 제거됨: `angular-compiler.ts`에서 `staleSourceFiles`, `useHmr` 변수 없음 확인
+- [x] enableHmr 프로퍼티가 AngularBuildPipelineOptions에서 제거됨: `angular-build-pipeline.ts` 인터페이스에 `enableHmr` 없음 확인
+- [x] templateUpdates 프로퍼티가 PipelineResult에서 제거됨: `angular-build-pipeline.ts` 인터페이스에 `templateUpdates` 없음 확인
+- [x] vite-angular-plugin.ts의 `enableHmr: false` 제거됨: Pipeline 생성 시 `enableHmr` 옵션 없음 확인
+- [x] hmr-candidates.ts 파일 삭제됨: `src/utils/hmr-candidates.ts` 파일 존재하지 않음
+- [x] angular-compiler-hmr.spec.ts 삭제됨: `tests/angular/angular-compiler-hmr.spec.ts` 파일 존재하지 않음
+- [x] hmr-candidates.spec.ts 삭제됨: `tests/angular/hmr-candidates.spec.ts` 파일 존재하지 않음
+- [x] client.worker.ts 변경 없음: `client.worker.ts`는 `createCompilerPlugin` 경로를 사용하며 AngularCompiler를 직접 참조하지 않음
+- [x] hmr-service.ts, hmr-client-script.ts, esbuild-client-config.ts 변경 없음: client.worker.ts 경로의 HMR 인프라는 그대로 유지됨

package/tests/angular/vite-angular-plugin-legacy-watch.spec.ts

@@ -27,10 +27,8 @@ describe("sdAngularPlugin legacy watch rebuild", () => {
 
   // Acceptance: 재빌드 시 변경 파일의 캐시가 무효화되고 증분 컴파일된다
   it("invalidates cache and produces updated output on watch rebuild", async () => {
-    const onBuild = vi.fn();
     const plugin = sdAngularPlugin({
       pkg: "basic-app",
-      onBuild,
     });
 
     // 초기 빌드
@@ -58,21 +56,13 @@ describe("sdAngularPlugin legacy watch rebuild", () => {
     expect(rebuiltResult.code).toBeDefined();
     expect(rebuiltResult.code.length).toBeGreaterThan(0);
 
-    // onBuild이 초기 빌드와 재빌드 모두에서 호출되어야 한다
-    expect(onBuild).toHaveBeenCalledTimes(2);
-    expect(onBuild).toHaveBeenCalledWith(
-      expect.objectContaining({ success: true }),
-    );
-
     await (plugin as any).buildEnd?.call({});
   });
 
   // Acceptance: 첫 buildStart는 기존 로직으로 전체 컴파일한다
   it("performs full compilation on first buildStart", async () => {
-    const onBuild = vi.fn();
     const plugin = sdAngularPlugin({
       pkg: "basic-app",
-      onBuild,
     });
 
     // watchChange 없이 첫 buildStart
@@ -86,20 +76,13 @@ describe("sdAngularPlugin legacy watch rebuild", () => {
     expect(result).toBeDefined();
     expect(result.code.length).toBeGreaterThan(0);
 
-    // onBuild 정상 호출
-    expect(onBuild).toHaveBeenCalledWith(
-      expect.objectContaining({ success: true }),
-    );
-
     await (plugin as any).buildEnd?.call({});
   });
 
   // Acceptance: watchChange 없이 buildStart 재호출 시에도 정상 동작
   it("handles buildStart re-invocation without watchChange gracefully", async () => {
-    const onBuild = vi.fn();
     const plugin = sdAngularPlugin({
       pkg: "basic-app",
-      onBuild,
     });
 
     // 초기 빌드

package/tests/angular/vite-angular-plugin-vitest.spec.ts

@@ -55,17 +55,12 @@ describe("sdAngularPlugin Vitest 지원", () => {
       createTestSdConfig({ target: "browser" } as any),
     );
 
-    const onBuild = vi.fn();
-    const browserPlugin = sdAngularPlugin({ pkg: "basic-app", onBuild });
+    const browserPlugin = sdAngularPlugin({ pkg: "basic-app" });
 
     await (browserPlugin as any).config?.({}, { mode: "development", command: "serve" });
     (browserPlugin as any).configResolved?.({ build: { sourcemap: false } });
     await (browserPlugin as any).buildStart?.call({});
 
-    expect(onBuild).toHaveBeenCalledWith(
-      expect.objectContaining({ success: expect.any(Boolean) }),
-    );
-
     const appComponentPath = resolve(PKG_DIR, "src/app.component.ts");
     const result = await (browserPlugin as any).transform?.call({}, "", appComponentPath);
     expect(result).toBeDefined();

package/tests/angular/vite-angular-plugin-vitest.verify.md

@@ -0,0 +1,20 @@
+# Slice 2: Vite 제거 + vite-angular-plugin 축소 — LLM 검증
+
+## 검증 항목
+
+- [x] vite-config.ts 삭제됨: `ls packages/sd-cli/src/utils/vite-config.ts` → 파일 없음 확인
+- [x] vite-scope-watch-plugin.ts 삭제됨: `ls packages/sd-cli/src/utils/vite-scope-watch-plugin.ts` → 파일 없음 확인
+- [x] vite-postcss-inline-plugin.ts 삭제됨: `ls packages/sd-cli/src/angular/vite-postcss-inline-plugin.ts` → 파일 없음 확인
+- [x] vite-pwa-plugin.ts 삭제됨: `ls packages/sd-cli/src/utils/vite-pwa-plugin.ts` → 파일 없음 확인
+- [x] vite-angular-plugin.ts에서 config() 훅 유지: config()는 isDev, pkgConfig, resolvedPkgDir 초기화에 필수. Vitest가 Vite plugin lifecycle을 호출하므로 유지. 단, optimizeDeps/define 반환값 제거됨
+- [x] vite-angular-plugin.ts에서 configResolved() 훅 유지: enableSourcemap 설정에 필요. 단, prebundleTransformer 생성 제거됨
+- [x] handleHotUpdate() 제거됨: HMR 배칭(pendingHmrFiles, hmrBatchTimer, processHmrBatch) 모두 제거됨
+- [x] configureServer() 제거됨: devServer, isDevServer, angularComponentMiddleware 모두 제거됨
+- [x] onBuildStart/onBuild 콜백 제거됨: SdAngularPluginOptions에서 onBuildStart, onBuild 필드 삭제됨. buildStart()에서 options.onBuild 호출 제거됨
+- [x] resolveReplaceDeps() 제거됨: scope watch 관련 replaceDepDistPaths, resolveReplaceDepEntries import 모두 제거됨
+- [x] watchChange(id) 유지됨: pendingWatchChanges에 파일 경로 수집. Vitest watch 모드에서 캐시 무효화에 사용
+- [x] buildStart() 유지됨: tsconfig 파싱, AngularSourceFileCache 생성/재사용, AngularBuildPipeline 초기화, 전체/증분 컴파일 수행. enableHmr: false로 고정 (Vitest에서 HMR 불필요)
+- [x] transform() 유지됨: .ts 파일에 대해 Pipeline emit JS 반환 + JavaScriptTransformer 적용. query param 제거 및 인라인 소스맵 분리 로직 유지
+- [x] buildEnd() 간소화됨: isDev 분기 제거. 항상 jsTransformer.close() + pipeline 해제. prebundleTransformer 제거
+- [x] Vite 타입 import 축소: `ModuleNode`, `ViteDevServer` import 제거됨. `Plugin` 타입만 유지
+- [x] 미사용 import 제거: `createHash`, `fsp`, `fs`, `IncomingMessage`, `ServerResponse`, `SdConfig`, `resolveReplaceDepEntries` 제거됨

package/tests/angular/vite-angular-plugin.spec.ts

@@ -23,20 +23,7 @@ beforeEach(() => {
 });
 
 describe("sdAngularPlugin", () => {
-  // Scenario: Angular define 설정
-  it("sets ngDevMode and ngJitMode defines", async () => {
-    const devPlugin = sdAngularPlugin({ pkg: "basic-app"});
-    const prodPlugin = sdAngularPlugin({ pkg: "basic-app"});
-
-    const devConfig = await (devPlugin as any).config?.({}, { mode: "development", command: "serve" });
-    const prodConfig = await (prodPlugin as any).config?.({}, { mode: "production", command: "build" });
-
-    expect(devConfig?.define?.ngJitMode).toBe("false");
-    expect(devConfig?.define?.ngDevMode).toBeUndefined();
-
-    expect(prodConfig?.define?.ngJitMode).toBe("false");
-    expect(prodConfig?.define?.ngDevMode).toBe("false");
-  });
+  // config() define 반환은 Vitest 축소로 제거됨 (esbuild-client-config에서 처리)
 
   // Scenario: non-Angular .ts 파일은 기본 처리
   it("returns undefined for non-emitted .ts files", async () => {
@@ -60,159 +47,8 @@ describe("sdAngularPlugin", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Scenario: Angular 컴포넌트 .ts 파일 수정 시 컴포넌트 HMR
-  it("updates emit cache and returns affected modules when handleHotUpdate is called", async () => {
-    const onBuildStart = vi.fn();
-    const onBuild = vi.fn();
-
-    const plugin = sdAngularPlugin({
-      pkg: "basic-app",
-     
-      onBuildStart,
-      onBuild,
-    });
-    await initPlugin(plugin);
-
-    const appComponentPath = path
-      .join(PKG_DIR, "src/app.component.ts")
-      .replace(/\\/g, "/");
-
-    const initialResult = await (plugin as any).transform?.call({}, "", appComponentPath);
-    expect(initialResult).toBeDefined();
-    expect(initialResult.code.length).toBeGreaterThan(0);
-
-    expect((plugin as any).handleHotUpdate).toBeDefined();
-
-    const mockModule = { file: appComponentPath, id: appComponentPath };
-    const hmrResult = await (plugin as any).handleHotUpdate?.({
-      file: appComponentPath,
-      modules: [mockModule],
-      server: { watcher: { emit: vi.fn() } },
-      timestamp: Date.now(),
-      read: () => Promise.resolve(""),
-    });
-
-    expect(onBuildStart).toHaveBeenCalled();
-    expect(onBuild).toHaveBeenCalledWith(
-      expect.objectContaining({ success: expect.any(Boolean) }),
-    );
-    expect(Array.isArray(hmrResult)).toBe(true);
-
-    const afterResult = await (plugin as any).transform?.call({}, "", appComponentPath);
-    expect(afterResult).toBeDefined();
-    expect(afterResult.code.length).toBeGreaterThan(0);
-
-    await (plugin as any).buildEnd?.call({});
-  });
-
-  // Scenario: ngHmrMode define 설정
-  it("sets ngHmrMode in dev mode and disables in prod mode", async () => {
-    const devPlugin = sdAngularPlugin({ pkg: "basic-app"});
-    const prodPlugin = sdAngularPlugin({ pkg: "basic-app"});
-
-    const devConfig = await (devPlugin as any).config?.({}, { mode: "development", command: "serve" });
-    const prodConfig = await (prodPlugin as any).config?.({}, { mode: "production", command: "build" });
-
-    expect(devConfig?.define?.ngHmrMode).toBeUndefined();
-    expect(prodConfig?.define?.ngHmrMode).toBe("false");
-  });
-
-  // Scenario: 컴파일 에러 발생 및 복구
-  it("calls onBuild with success=false when handleHotUpdate encounters compile error", async () => {
-    const onBuild = vi.fn();
-    const plugin = sdAngularPlugin({
-      pkg: "basic-app",
-     
-      onBuild,
-    });
-    await initPlugin(plugin);
-
-    const _hmrResult = await (plugin as any).handleHotUpdate?.({
-      file: path.join(PKG_DIR, "src/nonexistent-file.ts").replace(/\\/g, "/"),
-      modules: [],
-      server: { watcher: { emit: vi.fn() } },
-      timestamp: Date.now(),
-      read: () => Promise.resolve(""),
-    });
-
-    expect(onBuild).toHaveBeenCalled();
-    await (plugin as any).buildEnd?.call({});
-  });
-
-  // Scenario: non-Angular .ts 파일 수정 — handleHotUpdate passes through
-  it("handleHotUpdate skips non-ts/html/scss files", async () => {
-    const onBuildStart = vi.fn();
-    const plugin = sdAngularPlugin({
-      pkg: "basic-app",
-     
-      onBuildStart,
-    });
-    await initPlugin(plugin);
-
-    const result = await (plugin as any).handleHotUpdate?.({
-      file: "/some/file.json",
-      modules: [],
-      server: {},
-      timestamp: Date.now(),
-      read: () => Promise.resolve(""),
-    });
-
-    expect(result).toBeUndefined();
-    expect(onBuildStart).not.toHaveBeenCalled();
-    await (plugin as any).buildEnd?.call({});
-  });
-
-  // Scenario: dev 모드에서 buildEnd 후 facade 유지
-  it("keeps facade alive after buildEnd in dev mode", async () => {
-    const plugin = sdAngularPlugin({ pkg: "basic-app"});
-    await initPlugin(plugin);
-    await (plugin as any).buildEnd?.call({});
-
-    const appComponentPath = path
-      .join(PKG_DIR, "src/app.component.ts")
-      .replace(/\\/g, "/");
-    const result = await (plugin as any).transform?.call({}, "", appComponentPath);
-    expect(result).toBeDefined();
-    expect(result.code.length).toBeGreaterThan(0);
-  });
-
-  // Scenario: optimizeDeps에 Angular Linker esbuild 플러그인이 등록된다
-  it("registers angular-vite-optimize-deps esbuild plugin in optimizeDeps config", async () => {
-    const plugin = sdAngularPlugin({ pkg: "basic-app"});
-    const config = await (plugin as any).config?.({}, { mode: "development", command: "serve" });
-
-    const esbuildPlugins = config?.optimizeDeps?.esbuildOptions?.plugins as
-      | { name: string }[]
-      | undefined;
-    expect(esbuildPlugins).toBeDefined();
-    expect(esbuildPlugins!.some((p) => p.name === "angular-vite-optimize-deps")).toBe(true);
-  });
-
-  // Scenario: replaceDeps 없을 때 .js 변경은 무시
-  it("handleHotUpdate ignores .js files when no replaceDeps configured", async () => {
-    const plugin = sdAngularPlugin({ pkg: "basic-app"});
-    await initPlugin(plugin);
-
-    const mockHotSend = vi.fn();
-    const mockServer = {
-      middlewares: { use: vi.fn() },
-      httpServer: { on: vi.fn() },
-      config: { base: "/" },
-      hot: { send: mockHotSend },
-    };
-    (plugin as any).configureServer?.(mockServer);
-
-    const hmrResult = await (plugin as any).handleHotUpdate?.({
-      file: "/some/external/lib.js",
-      modules: [],
-      server: mockServer,
-      timestamp: Date.now(),
-      read: () => Promise.resolve(""),
-    });
-
-    expect(hmrResult).toBeUndefined();
-    await (plugin as any).buildEnd?.call({});
-  });
+  // handleHotUpdate, configureServer, optimizeDeps는 Vitest 축소로 제거됨
+  // Feature 3.3에서 esbuild 기반 테스트로 교체 예정
 
   // Scenario: .mjs 파일이 JavaScriptTransformer를 통과한다
   it("transforms .mjs files through JavaScriptTransformer", async () => {
@@ -283,17 +119,7 @@ describe("sdAngularPlugin", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Scenario: legacyModule이 sd.config.ts에서 resolve되어 HMR 비활성화
-  it("resolves legacyModule from sd.config.ts and disables HMR", async () => {
-    mockLoadSdConfig.mockResolvedValue(
-      createTestSdConfig({ browserSupport: { legacyModule: true } }),
-    );
-
-    const plugin = sdAngularPlugin({ pkg: "basic-app" });
-    const config = await (plugin as any).config?.({}, { mode: "development", command: "serve" });
-
-    expect(config?.define?.ngHmrMode).toBe("false");
-  });
+  // config() define 반환값은 Vitest 축소로 제거됨 (Feature 3.3에서 별도 테스트)
 
   // Scenario: browserSupport 미설정 시 기본값 동작
   it("works when browserSupport is not set in sd.config.ts", async () => {

package/tests/capacitor/capacitor-android.spec.ts

@@ -1,3 +1,4 @@
+/* eslint-disable no-restricted-properties -- 테스트 환경변수 조작 필요 */
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 
 //#region Mocks

package/tests/capacitor/capacitor-build.spec.ts

@@ -1,3 +1,4 @@
+/* eslint-disable no-restricted-properties -- 테스트 환경변수 조작 필요 */
 import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
 import { consola } from "consola";