@simplysm/sd-cli 14.0.18 → 14.0.19

package/tests/angular/linker-disk-cache.spec.ts

@@ -18,14 +18,20 @@ const { sdAngularPlugin } = await import("../../src/angular/vite-angular-plugin.
 const TMP_DIR = path.join(os.tmpdir(), "sd-cli-linker-cache-test");
 const CACHE_DIR = path.join(TMP_DIR, "cache");
 
-type LoadHandler = (id: string) => Promise<string | null>;
+type OnLoadHandler = (args: { path: string }) => Promise<{ contents: string; loader: string } | null>;
 
-function getLoadHandler(plugin: ReturnType<typeof sdAngularPlugin>): LoadHandler {
+function getOnLoadHandler(plugin: ReturnType<typeof sdAngularPlugin>): OnLoadHandler {
   const config = (plugin as any).config();
-  const rolldownPlugin = config.optimizeDeps.rolldownOptions.plugins[0] as {
-    load: (id: string) => Promise<string | null>;
+  const esbuildPlugin = config.optimizeDeps.esbuildOptions.plugins[0] as {
+    setup: (build: { onLoad: Function }) => void;
   };
-  return (id: string) => rolldownPlugin.load(id);
+  let handler: OnLoadHandler;
+  esbuildPlugin.setup({
+    onLoad(_filter: unknown, fn: OnLoadHandler) {
+      handler = fn;
+    },
+  });
+  return handler!;
 }
 
 describe("Linker disk cache (optimizeDeps)", () => {
@@ -49,12 +55,12 @@ describe("Linker disk cache (optimizeDeps)", () => {
       dev: true,
       linkerCacheDir: CACHE_DIR,
     });
-    const load = getLoadHandler(plugin);
+    const onLoad = getOnLoadHandler(plugin);
 
     // First call: cache miss
-    const result1 = await load(jsFile);
+    const result1 = await onLoad({ path: jsFile });
     expect(mockTransformFile).toHaveBeenCalledOnce();
-    expect(result1).toBe("transformed-code");
+    expect(result1).toEqual({ contents: "transformed-code", loader: "js" });
 
     // Cache file created
     const cacheFiles = fs.readdirSync(CACHE_DIR);
@@ -63,9 +69,9 @@ describe("Linker disk cache (optimizeDeps)", () => {
 
     // Second call: cache hit
     mockTransformFile.mockClear();
-    const result2 = await load(jsFile);
+    const result2 = await onLoad({ path: jsFile });
     expect(mockTransformFile).not.toHaveBeenCalled();
-    expect(result2).toBe("transformed-code");
+    expect(result2).toEqual({ contents: "transformed-code", loader: "js" });
   });
 
   // Acceptance: file content change → cache miss
@@ -78,9 +84,9 @@ describe("Linker disk cache (optimizeDeps)", () => {
       dev: true,
       linkerCacheDir: CACHE_DIR,
     });
-    const load = getLoadHandler(plugin);
+    const onLoad = getOnLoadHandler(plugin);
 
-    await load(jsFile);
+    await onLoad({ path: jsFile });
     expect(mockTransformFile).toHaveBeenCalledOnce();
 
     // Change content
@@ -88,9 +94,9 @@ describe("Linker disk cache (optimizeDeps)", () => {
     mockTransformFile.mockClear();
     mockTransformFile.mockResolvedValue("transformed-v2");
 
-    const result = await load(jsFile);
+    const result = await onLoad({ path: jsFile });
     expect(mockTransformFile).toHaveBeenCalledOnce();
-    expect(result).toBe("transformed-v2");
+    expect(result).toEqual({ contents: "transformed-v2", loader: "js" });
   });
 
   // Unit: corrupted cache file → graceful fallback
@@ -103,19 +109,19 @@ describe("Linker disk cache (optimizeDeps)", () => {
       dev: true,
       linkerCacheDir: CACHE_DIR,
     });
-    const load = getLoadHandler(plugin);
+    const onLoad = getOnLoadHandler(plugin);
 
     // First call to populate cache
-    await load(jsFile);
+    await onLoad({ path: jsFile });
 
     // Remove the cache file to simulate corruption/missing cache
     const cacheFiles = fs.readdirSync(CACHE_DIR);
     fs.rmSync(path.join(CACHE_DIR, cacheFiles[0]));
 
     mockTransformFile.mockClear();
-    const result = await load(jsFile);
+    const result = await onLoad({ path: jsFile });
     expect(mockTransformFile).toHaveBeenCalledOnce();
-    expect(result).toBe("transformed-code");
+    expect(result).toEqual({ contents: "transformed-code", loader: "js" });
   });
 
   // Unit: Uint8Array result from transformFile is handled
@@ -130,16 +136,16 @@ describe("Linker disk cache (optimizeDeps)", () => {
       dev: true,
       linkerCacheDir: CACHE_DIR,
     });
-    const load = getLoadHandler(plugin);
+    const onLoad = getOnLoadHandler(plugin);
 
-    const result = await load(jsFile);
-    expect(result).toBe("uint8-transformed");
+    const result = await onLoad({ path: jsFile });
+    expect(result).toEqual({ contents: "uint8-transformed", loader: "js" });
 
     // Second call: cache hit should also return string
     mockTransformFile.mockClear();
-    const result2 = await load(jsFile);
+    const result2 = await onLoad({ path: jsFile });
     expect(mockTransformFile).not.toHaveBeenCalled();
-    expect(result2).toBe("uint8-transformed");
+    expect(result2).toEqual({ contents: "uint8-transformed", loader: "js" });
   });
 
   // Unit: non-.js file returns null (filter)
@@ -149,9 +155,9 @@ describe("Linker disk cache (optimizeDeps)", () => {
       dev: true,
       linkerCacheDir: CACHE_DIR,
     });
-    const load = getLoadHandler(plugin);
+    const onLoad = getOnLoadHandler(plugin);
 
-    const result = await load(path.join(TMP_DIR, "data.json"));
+    const result = await onLoad({ path: path.join(TMP_DIR, "data.json") });
     expect(result).toBeNull();
     expect(mockTransformFile).not.toHaveBeenCalled();
   });

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

@@ -28,7 +28,7 @@ describe("sdAngularPlugin CSS HMR compatibility", () => {
       .join(FIXTURE_DIR, "node_modules/@scope/lib/dist/style.css")
       .replace(/\\/g, "/");
 
-    const hmrResult = await (plugin as any).hotUpdate?.({
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
       file: cssFilePath,
       modules: [{ file: cssFilePath, id: cssFilePath }],
       server: { watcher: { emit: vi.fn() } },
@@ -68,7 +68,7 @@ describe("sdAngularPlugin CSS HMR compatibility", () => {
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    await (plugin as any).hotUpdate?.({
+    await (plugin as any).handleHotUpdate?.({
       file: tsFilePath,
       modules: [{ file: tsFilePath, id: tsFilePath }],
       server: { watcher: { emit: vi.fn() } },
@@ -88,7 +88,7 @@ describe("sdAngularPlugin CSS HMR compatibility", () => {
       .join(FIXTURE_DIR, "node_modules/@scope/lib/dist/style.css")
       .replace(/\\/g, "/");
 
-    await (plugin as any).hotUpdate?.({
+    await (plugin as any).handleHotUpdate?.({
       file: cssFilePath,
       modules: [{ file: cssFilePath, id: cssFilePath }],
       server: { watcher: { emit: vi.fn() } },
@@ -121,7 +121,7 @@ describe("sdAngularPlugin CSS HMR compatibility", () => {
     ];
 
     for (const cssPath of cssVariants) {
-      const result = await (plugin as any).hotUpdate?.({
+      const result = await (plugin as any).handleHotUpdate?.({
         file: cssPath,
         modules: [{ file: cssPath, id: cssPath }],
         server: { watcher: { emit: vi.fn() } },
@@ -159,7 +159,7 @@ describe("sdAngularPlugin CSS HMR compatibility", () => {
       .join(FIXTURE_DIR, "src/styles.scss")
       .replace(/\\/g, "/");
 
-    const result = await (plugin as any).hotUpdate?.({
+    const result = await (plugin as any).handleHotUpdate?.({
       file: scssFilePath,
       modules: [{ file: scssFilePath, id: scssFilePath }],
       server: { watcher: { emit: vi.fn() } },
@@ -209,8 +209,8 @@ describe("sdAngularPlugin HMR fallback", () => {
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    // hotUpdate 호출
-    const hmrResult = await (plugin as any).hotUpdate?.({
+    // handleHotUpdate 호출
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath, id: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },
@@ -218,7 +218,7 @@ describe("sdAngularPlugin HMR fallback", () => {
       read: () => Promise.resolve(""),
     });
 
-    // hotUpdate는 항상 affected modules 배열을 반환해야 한다
+    // handleHotUpdate는 항상 affected modules 배열을 반환해야 한다
     // (templateUpdates가 undefined이든 아니든)
     expect(Array.isArray(hmrResult)).toBe(true);
 
@@ -249,8 +249,8 @@ describe("sdAngularPlugin HMR fallback", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Unit: prod 모드(dev: false)에서는 hotUpdate가 void 반환 (HMR 비활성)
-  it("returns undefined from hotUpdate in prod mode", async () => {
+  // Unit: prod 모드(dev: false)에서는 handleHotUpdate가 void 반환 (HMR 비활성)
+  it("returns undefined from handleHotUpdate in prod mode", async () => {
     const plugin = sdAngularPlugin({
       tsconfig: TSCONFIG_PATH,
       dev: false,
@@ -262,7 +262,7 @@ describe("sdAngularPlugin HMR fallback", () => {
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    const hmrResult = await (plugin as any).hotUpdate?.({
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },
@@ -276,7 +276,7 @@ describe("sdAngularPlugin HMR fallback", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Acceptance: 수정 파일 33개 이상일 때도 hotUpdate가 정상 동작
+  // Acceptance: 수정 파일 33개 이상일 때도 handleHotUpdate가 정상 동작
   // (Angular 컴파일러 내부에서 HMR 분석을 생략하고 templateUpdates=undefined 반환)
   it("handles update with many modified files gracefully (HMR skipped by compiler)", async () => {
     const plugin = sdAngularPlugin({
@@ -290,11 +290,11 @@ describe("sdAngularPlugin HMR fallback", () => {
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    // hotUpdate는 단일 파일에 대해 호출됨 (Vite 설계)
+    // handleHotUpdate는 단일 파일에 대해 호출됨 (Vite 설계)
     // 33개 이상 수정 파일 제한은 Angular 컴파일러 내부에서 처리
     // AngularFacade.update()에서 modifiedFiles가 SourceFileCache.modifiedFiles로 전달되므로
     // 실제 33개 이상 파일 변경은 SourceFileCache를 통해 추적됨
-    const hmrResult = await (plugin as any).hotUpdate?.({
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },
@@ -302,7 +302,7 @@ describe("sdAngularPlugin HMR fallback", () => {
       read: () => Promise.resolve(""),
     });
 
-    // hotUpdate가 에러 없이 동작해야 한다
+    // handleHotUpdate가 에러 없이 동작해야 한다
     expect(Array.isArray(hmrResult)).toBe(true);
 
     await (plugin as any).buildEnd?.call({});

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

@@ -131,8 +131,8 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Acceptance: hotUpdate에서 templateUpdates를 수집하고 middleware에서 서빙
-  it("collects templateUpdates from hotUpdate and serves via middleware", async () => {
+  // Acceptance: handleHotUpdate에서 templateUpdates를 수집하고 middleware에서 서빙
+  it("collects templateUpdates from handleHotUpdate and serves via middleware", async () => {
     const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
 
     await (plugin as any).buildStart?.call({});
@@ -151,12 +151,12 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
     };
     (plugin as any).configureServer?.(mockServer);
 
-    // hotUpdate 호출 (인라인 템플릿 변경)
+    // handleHotUpdate 호출 (인라인 템플릿 변경)
     const appComponentPath = path
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    await (plugin as any).hotUpdate?.({
+    await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath, id: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },
@@ -174,7 +174,7 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
   });
 
   // Acceptance: rebuild 시작 시 이전 templateUpdates 정리
-  it("clears templateUpdates at the start of hotUpdate", async () => {
+  it("clears templateUpdates at the start of handleHotUpdate", async () => {
     const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
     await (plugin as any).buildStart?.call({});
 
@@ -195,8 +195,8 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
       .join(FIXTURE_DIR, "src/app.component.ts")
       .replace(/\\/g, "/");
 
-    // 첫 번째 hotUpdate
-    await (plugin as any).hotUpdate?.({
+    // 첫 번째 handleHotUpdate
+    await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },
@@ -204,8 +204,8 @@ describe("sdAngularPlugin HMR + component-middleware", () => {
       read: () => Promise.resolve(""),
     });
 
-    // 두 번째 hotUpdate — 이전 templateUpdates가 정리되어야 한다
-    await (plugin as any).hotUpdate?.({
+    // 두 번째 handleHotUpdate — 이전 templateUpdates가 정리되어야 한다
+    await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [{ file: appComponentPath }],
       server: { watcher: { emit: vi.fn() } },

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

@@ -0,0 +1,108 @@
+import { describe, it, expect, vi } from "vitest";
+import path from "path";
+import { sdAngularPlugin } from "../../src/angular/vite-angular-plugin.js";
+
+const FIXTURE_DIR = path.resolve(import.meta.dirname, "fixtures/basic-app");
+const TSCONFIG_PATH = path.join(FIXTURE_DIR, "tsconfig.json");
+
+describe("sdAngularPlugin legacy watch rebuild", () => {
+  // Acceptance: 재빌드 시 변경 파일의 캐시가 무효화되고 증분 컴파일된다
+  it("invalidates cache and produces updated output on watch rebuild", async () => {
+    const onBuild = vi.fn();
+    const plugin = sdAngularPlugin({
+      tsconfig: TSCONFIG_PATH,
+      dev: true,
+      legacyModule: true,
+      onBuild,
+    });
+
+    // 초기 빌드
+    await (plugin as any).buildStart?.call({});
+
+    const appComponentPath = path
+      .join(FIXTURE_DIR, "src/app.component.ts")
+      .replace(/\\/g, "/");
+
+    // 초기 transform 결과 캡처
+    const initialResult = await (plugin as any).transform?.call({}, "", appComponentPath);
+    expect(initialResult).toBeDefined();
+    expect(initialResult.code.length).toBeGreaterThan(0);
+
+    // watchChange 호출 (파일 변경 알림)
+    expect((plugin as any).watchChange).toBeDefined();
+    await (plugin as any).watchChange?.call({}, appComponentPath, { event: "update" });
+
+    // 재빌드 (buildStart 재호출)
+    await (plugin as any).buildStart?.call({});
+
+    // 재빌드 후 transform — 컴파일러가 재실행되어 결과를 반환해야 한다
+    const rebuiltResult = await (plugin as any).transform?.call({}, "", appComponentPath);
+    expect(rebuiltResult).toBeDefined();
+    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({
+      tsconfig: TSCONFIG_PATH,
+      dev: true,
+      legacyModule: true,
+      onBuild,
+    });
+
+    // watchChange 없이 첫 buildStart
+    await (plugin as any).buildStart?.call({});
+
+    const appComponentPath = path
+      .join(FIXTURE_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);
+
+    // 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({
+      tsconfig: TSCONFIG_PATH,
+      dev: true,
+      legacyModule: true,
+      onBuild,
+    });
+
+    // 초기 빌드
+    await (plugin as any).buildStart?.call({});
+
+    // watchChange 없이 재빌드 (예: Rolldown이 변경 없이 재빌드 트리거)
+    await (plugin as any).buildStart?.call({});
+
+    const appComponentPath = path
+      .join(FIXTURE_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);
+
+    await (plugin as any).buildEnd?.call({});
+  });
+});

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

@@ -145,7 +145,7 @@ describe("vite-angular-plugin lint integration (Slice 5)", () => {
     });
   });
 
-  describe("Scenario: lint runs in hotUpdate", () => {
+  describe("Scenario: lint runs in handleHotUpdate", () => {
     it("runs lint after incremental compilation and passes result to onBuild", async () => {
       const onBuildResults: any[] = [];
 
@@ -167,9 +167,9 @@ describe("vite-angular-plugin lint integration (Slice 5)", () => {
         formattedOutput: "lint errors found",
       });
 
-      // Call hotUpdate
-      const hotUpdate = (plugin as any).hotUpdate;
-      await hotUpdate.call({}, {
+      // Call handleHotUpdate
+      const handleHotUpdate = (plugin as any).handleHotUpdate;
+      await handleHotUpdate.call({}, {
         file: "/workspace/packages/client/src/app.ts",
         modules: [],
         server: {},

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

@@ -5,13 +5,11 @@ import { sdAngularPlugin } from "../../src/angular/vite-angular-plugin.js";
 const FIXTURE_DIR = path.resolve(import.meta.dirname, "fixtures/basic-app");
 const TSCONFIG_PATH = path.join(FIXTURE_DIR, "tsconfig.json");
 
-function mockEnvironmentContext() {
+function mockServerWithModuleGraph() {
   return {
-    environment: {
-      moduleGraph: {
-        getModulesByFile: (file: string) => {
-          return new Set([{ file, id: file }]);
-        },
+    moduleGraph: {
+      getModulesByFile: (file: string) => {
+        return new Set([{ file, id: file }]);
       },
     },
   };
@@ -35,11 +33,10 @@ describe("sdAngularPlugin SCSS @use HMR", () => {
       .join(FIXTURE_DIR, "scss/_variables.scss")
       .replace(/\\/g, "/");
 
-    const ctx = mockEnvironmentContext();
-    const result = await (plugin as any).hotUpdate?.call(ctx, {
+    const result = await (plugin as any).handleHotUpdate?.({
       file: variablesPath,
       modules: [],
-      server: {},
+      server: mockServerWithModuleGraph(),
       timestamp: Date.now(),
       read: () => Promise.resolve(""),
     });
@@ -54,11 +51,10 @@ describe("sdAngularPlugin SCSS @use HMR", () => {
       .join(FIXTURE_DIR, "scss/_colors.scss")
       .replace(/\\/g, "/");
 
-    const ctx = mockEnvironmentContext();
-    const result = await (plugin as any).hotUpdate?.call(ctx, {
+    const result = await (plugin as any).handleHotUpdate?.({
       file: colorsPath,
       modules: [],
-      server: {},
+      server: mockServerWithModuleGraph(),
       timestamp: Date.now(),
       read: () => Promise.resolve(""),
     });
@@ -73,11 +69,10 @@ describe("sdAngularPlugin SCSS @use HMR", () => {
       .join(FIXTURE_DIR, "scss/_unrelated.scss")
       .replace(/\\/g, "/");
 
-    const ctx = mockEnvironmentContext();
-    const result = await (plugin as any).hotUpdate?.call(ctx, {
+    const result = await (plugin as any).handleHotUpdate?.({
       file: unrelatedPath,
       modules: [],
-      server: {},
+      server: mockServerWithModuleGraph(),
       timestamp: Date.now(),
       read: () => Promise.resolve(""),
     });

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

@@ -54,7 +54,7 @@ describe("sdAngularPlugin", () => {
   });
 
   // Scenario: Angular 컴포넌트 .ts 파일 수정 시 컴포넌트 HMR (Acceptance — Feature 3.3)
-  it("updates emit cache and returns affected modules when hotUpdate is called", async () => {
+  it("updates emit cache and returns affected modules when handleHotUpdate is called", async () => {
     const onBuildStart = vi.fn();
     const onBuild = vi.fn();
 
@@ -77,12 +77,12 @@ describe("sdAngularPlugin", () => {
     expect(initialResult).toBeDefined();
     expect(initialResult.code.length).toBeGreaterThan(0);
 
-    // hotUpdate must exist
-    expect((plugin as any).hotUpdate).toBeDefined();
+    // handleHotUpdate must exist
+    expect((plugin as any).handleHotUpdate).toBeDefined();
 
     // Simulate file change
     const mockModule = { file: appComponentPath, id: appComponentPath };
-    const hmrResult = await (plugin as any).hotUpdate?.({
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
       file: appComponentPath,
       modules: [mockModule],
       server: { watcher: { emit: vi.fn() } },
@@ -122,7 +122,7 @@ describe("sdAngularPlugin", () => {
   });
 
   // Scenario: 컴파일 에러 발생 및 복구 (Acceptance — Feature 3.3)
-  it("calls onBuild with success=false when hotUpdate encounters compile error", async () => {
+  it("calls onBuild with success=false when handleHotUpdate encounters compile error", async () => {
     const onBuild = vi.fn();
     const plugin = sdAngularPlugin({
       tsconfig: TSCONFIG_PATH,
@@ -132,8 +132,8 @@ describe("sdAngularPlugin", () => {
 
     await (plugin as any).buildStart?.call({});
 
-    // hotUpdate with a non-existent file — facade.update() should handle gracefully
-    const _hmrResult = await (plugin as any).hotUpdate?.({
+    // handleHotUpdate with a non-existent file — facade.update() should handle gracefully
+    const _hmrResult = await (plugin as any).handleHotUpdate?.({
       file: path.join(FIXTURE_DIR, "src/nonexistent-file.ts").replace(/\\/g, "/"),
       modules: [],
       server: { watcher: { emit: vi.fn() } },
@@ -147,8 +147,8 @@ describe("sdAngularPlugin", () => {
     await (plugin as any).buildEnd?.call({});
   });
 
-  // Scenario: non-Angular .ts 파일 수정 — hotUpdate passes through
-  it("hotUpdate skips non-ts/html/scss files", async () => {
+  // Scenario: non-Angular .ts 파일 수정 — handleHotUpdate passes through
+  it("handleHotUpdate skips non-ts/html/scss files", async () => {
     const onBuildStart = vi.fn();
     const plugin = sdAngularPlugin({
       tsconfig: TSCONFIG_PATH,
@@ -159,7 +159,7 @@ describe("sdAngularPlugin", () => {
     await (plugin as any).buildStart?.call({});
 
     // .json file should be ignored
-    const result = await (plugin as any).hotUpdate?.({
+    const result = await (plugin as any).handleHotUpdate?.({
       file: "/some/file.json",
       modules: [],
       server: {},
@@ -192,16 +192,81 @@ describe("sdAngularPlugin", () => {
     // (in real use, Vite server close triggers this)
   });
 
-  // Scenario: optimizeDeps에 Angular Linker Rolldown 플러그인이 등록된다
-  it("registers angular-vite-optimize-deps rolldown plugin in optimizeDeps config", () => {
+  // Scenario: optimizeDeps에 Angular Linker esbuild 플러그인이 등록된다
+  it("registers angular-vite-optimize-deps esbuild plugin in optimizeDeps config", () => {
     const plugin = sdAngularPlugin({ tsconfig: TSCONFIG_PATH, dev: true });
     const config = (plugin as any).config?.();
 
-    const rolldownPlugins = config?.optimizeDeps?.rolldownOptions?.plugins as
+    const esbuildPlugins = config?.optimizeDeps?.esbuildOptions?.plugins as
       | { name: string }[]
       | undefined;
-    expect(rolldownPlugins).toBeDefined();
-    expect(rolldownPlugins!.some((p) => p.name === "angular-vite-optimize-deps")).toBe(true);
+    expect(esbuildPlugins).toBeDefined();
+    expect(esbuildPlugins!.some((p) => p.name === "angular-vite-optimize-deps")).toBe(true);
+  });
+
+  // Scenario: Linker 캐시 skip — replaceDeps 파일은 사전 번들링에서 건너뛴다
+  it("angular-vite-optimize-deps returns null for replaceDeps dist files", async () => {
+    const plugin = sdAngularPlugin({
+      tsconfig: TSCONFIG_PATH,
+      dev: true,
+      replaceDepDistPaths: ["/packages/my-client/node_modules/@scope/core/dist"],
+    });
+
+    const config = (plugin as any).config?.();
+    const esbuildPlugins = config?.optimizeDeps?.esbuildOptions?.plugins as
+      | { name: string; setup: (build: { onLoad: Function }) => void }[];
+    const optimizePlugin = esbuildPlugins.find(
+      (p) => p.name === "angular-vite-optimize-deps",
+    )!;
+
+    // esbuild onLoad 핸들러 추출
+    let onLoadHandler: (args: { path: string }) => Promise<unknown>;
+    optimizePlugin.setup({
+      onLoad(_filter: unknown, fn: (args: { path: string }) => Promise<unknown>) {
+        onLoadHandler = fn;
+      },
+    });
+
+    // replaceDeps dist 경로 내 .js 파일 → null 반환 (skip)
+    const result = await onLoadHandler!(
+      { path: "/packages/my-client/node_modules/@scope/core/dist/index.js" },
+    );
+    expect(result).toBeNull();
+  });
+
+  // Scenario: handleHotUpdate에서 replaceDeps .js 변경 시 full-reload 강제
+  it("handleHotUpdate triggers full-reload for replaceDeps .js files", async () => {
+    const plugin = sdAngularPlugin({
+      tsconfig: TSCONFIG_PATH,
+      dev: true,
+      replaceDepDistPaths: ["/packages/my-client/node_modules/@scope/core/dist"],
+    });
+
+    await (plugin as any).buildStart?.call({});
+
+    // configureServer로 server 참조 저장
+    const mockHotSend = vi.fn();
+    const mockServer = {
+      middlewares: { use: vi.fn() },
+      httpServer: { on: vi.fn() },
+      config: { base: "/" },
+      hot: { send: mockHotSend },
+    };
+    (plugin as any).configureServer?.(mockServer);
+
+    // replaceDeps .js 파일 변경 → full-reload
+    const hmrResult = await (plugin as any).handleHotUpdate?.({
+      file: "/packages/my-client/node_modules/@scope/core/dist/component.js",
+      modules: [],
+      server: mockServer,
+      timestamp: Date.now(),
+      read: () => Promise.resolve(""),
+    });
+
+    expect(mockHotSend).toHaveBeenCalledWith({ type: "full-reload" });
+    expect(hmrResult).toEqual([]);
+
+    await (plugin as any).buildEnd?.call({});
   });
 
   // Scenario: .mjs 파일이 JavaScriptTransformer를 통과한다 (Feature 1.1 Angular Linker)