@simplysm/sd-cli 14.0.30 → 14.0.33

package/tests/utils/ngtsc-build-core-write-emit.spec.ts

@@ -2,7 +2,7 @@ import { describe, it, expect, beforeEach, afterEach } from "vitest";
 import type {
   SideEffectScssOptions,
   SideEffectScssEntry,
-} from "../../src/utils/ngtsc-build-core";
+} from "../../src/angular/ngtsc-build-core";
 import path from "path";
 import fs from "fs";
 import os from "os";
@@ -22,7 +22,7 @@ describe("writeEmitResults", () => {
   });
 
   it("emitResults를 output-path-rewriting 적용하여 파일로 쓴다", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     // Simulate nested output: dist/my-pkg/src/index.js
@@ -40,7 +40,7 @@ describe("writeEmitResults", () => {
   });
 
   it("output-path-rewriter가 null을 반환하면 파일을 쓰지 않는다", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     // Nested output from OTHER package: dist/other-pkg/src/index.js
@@ -59,7 +59,7 @@ describe("writeEmitResults", () => {
   });
 
   it("이미 flat 구조인 경로는 그대로 쓴다", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     const flatPath = path.join(distDir, "index.js");
@@ -74,7 +74,7 @@ describe("writeEmitResults", () => {
   });
 
   it("디렉��리가 없으면 ��동 생성한다", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     // Nested path under new subdirectory
@@ -109,7 +109,7 @@ describe("writeEmitResults with side-effect SCSS", () => {
   });
 
   it("compiles side-effect SCSS to CSS and rewrites import path in JS", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     // Create source SCSS file
     const scssPath = path.join(srcDir, "ui", "layout", "sd-flex.scss");
@@ -149,7 +149,7 @@ describe("writeEmitResults with side-effect SCSS", () => {
 
   // Acceptance: Scenario "SCSS @use 의존성 해석"
   it("resolves SCSS @use dependencies via loadPaths", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     // Create SCSS load path with a shared variables file
     const scssLoadDir = path.join(pkgDir, "scss");
@@ -194,7 +194,7 @@ describe("writeEmitResults with side-effect SCSS", () => {
 
   // Acceptance: Scenario "SCSS 컴파일 에러"
   it("reports SCSS compilation error in scssErrors", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     // Create SCSS file with syntax error
     const scssPath = path.join(srcDir, "ui", "layout", "broken.scss");
@@ -224,7 +224,7 @@ describe("writeEmitResults with side-effect SCSS", () => {
 
   // Acceptance: Scenario "참조하는 SCSS 파일이 존재하지 않음"
   it("reports error when referenced SCSS file does not exist", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     const jsPath = path.join(distDir, "my-pkg", "src", "ui", "layout", "missing.directive.js");
@@ -267,7 +267,7 @@ describe("writeEmitResults with registry", () => {
   });
 
   it("registers side-effect SCSS entries in registry when provided", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     // Create source SCSS file
     const scssPath = path.join(srcDir, "ui", "layout", "sd-flex.scss");
@@ -304,7 +304,7 @@ describe("writeEmitResults with registry", () => {
   });
 
   it("clears stale registry entries for re-emitted source file before registering new ones", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const scssPath = path.join(srcDir, "ui", "layout", "sd-flex.scss");
     fs.writeFileSync(scssPath, ".sd-flex { display: flex; }", "utf-8");
@@ -345,7 +345,7 @@ describe("writeEmitResults with registry", () => {
   });
 
   it("removes registry entry when source file is re-emitted without SCSS imports", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     const sourceFileName = path.join(srcDir, "ui", "layout", "sd-flex.directive.ts");
@@ -382,7 +382,7 @@ describe("writeEmitResults with registry", () => {
   });
 
   it("preserves registry entries for non-emitted source files", async () => {
-    const { writeEmitResults } = await import("../../src/utils/angular-build-pipeline");
+    const { writeEmitResults } = await import("../../src/angular/angular-build-pipeline");
 
     const distDir = path.join(pkgDir, "dist");
     const sourceFileA = path.join(srcDir, "ui", "layout", "sd-flex.directive.ts");
@@ -450,7 +450,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: side-effect SCSS 파일 내용 변경
   it("compiles all registry entries to CSS", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     // Create source SCSS
     const scssPath = path.join(srcDir, "ui", "layout", "sd-flex.scss");
@@ -473,7 +473,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: 여러 side-effect SCSS 파일 동시 변경
   it("compiles multiple registry entries", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     // Create two SCSS files
     const scssPath1 = path.join(srcDir, "ui", "layout", "sd-flex.scss");
@@ -502,7 +502,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: @use 의존성 파일 변경
   it("resolves @use dependencies via loadPaths and tracks them", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     // Create shared variables file
     const scssLoadDir = path.join(pkgDir, "scss");
@@ -545,7 +545,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: 간접 의존성 변경
   it("tracks transitive @use dependencies", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     // Create transitive dependency chain: sd-flex.scss -> _mixins.scss -> _variables.scss
     const scssLoadDir = path.join(pkgDir, "scss");
@@ -591,7 +591,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: SCSS 문법 에러
   it("reports error and preserves existing CSS when SCSS has syntax error", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     // Create existing CSS (from previous successful build)
     const cssAbsPath = path.join(distDir, "ui", "layout", "sd-flex.css");
@@ -620,7 +620,7 @@ describe("compileSideEffectScss", () => {
 
   // Scenario: 에러 수정 후 정상 재빌드
   it("compiles successfully after fixing syntax error", async () => {
-    const { compileSideEffectScss } = await import("../../src/utils/ngtsc-build-core");
+    const { compileSideEffectScss } = await import("../../src/angular/ngtsc-build-core");
 
     const scssPath = path.join(srcDir, "ui", "layout", "sd-flex.scss");
     const cssAbsPath = path.join(distDir, "ui", "layout", "sd-flex.css");

package/tests/utils/ngtsc-build-core.spec.ts

@@ -12,7 +12,7 @@ const mockGetTsProgram = vi.fn().mockReturnValue({
 
 const angularCompilerConstructorSpy = vi.fn();
 
-vi.mock("../../src/utils/angular-compiler", () => {
+vi.mock("../../src/angular/angular-compiler", () => {
   class AngularCompiler {
     constructor(options: unknown) {
       angularCompilerConstructorSpy(options);
@@ -59,7 +59,7 @@ vi.mock("../../src/utils/tsconfig", () => ({
 }));
 
 const ngtscProgramSpy = vi.fn();
-vi.mock("../../src/utils/angular-build", () => {
+vi.mock("../../src/angular/angular-build", () => {
   class NgtscProgram {
     constructor(...args: unknown[]) {
       ngtscProgramSpy(...args);
@@ -89,10 +89,10 @@ vi.mock("../../src/utils/angular-build", () => {
 
 const {
   buildScssLoadPaths,
-} = await import("../../src/utils/ngtsc-build-core");
+} = await import("../../src/angular/ngtsc-build-core");
 const {
   createLibraryTransformStylesheet,
-} = await import("../../src/utils/angular-build-pipeline");
+} = await import("../../src/angular/angular-build-pipeline");
 
 import { join } from "node:path";
 

package/tests/utils/orchestrator-utils.spec.ts

@@ -46,8 +46,8 @@ describe("loadAndValidateConfig", () => {
     expect(result).toBe(config);
   });
 
-  // Acceptance: Scenario "DevWatchOrchestrator가 공유 초기화 유틸을 사용한다"
-  it("works with dev:true for DevWatchOrchestrator", async () => {
+  // Acceptance: dev:true 모드 동작 확인
+  it("works with dev:true", async () => {
     const config: SdConfig = {
       packages: { "demo-server": { target: "server" } as any },
     };

package/tests/utils/output-utils.spec.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, vi, beforeEach } from "vitest";
 import { consola } from "consola";
 import { formatBuildMessages, printErrors, printServers } from "../../src/utils/output-utils";
-import type { BuildResult } from "../../src/infra/ResultCollector";
+import type { BuildResult } from "../../src/runtime/ResultCollector";
 
 vi.spyOn(consola, "error").mockImplementation(() => {});
 vi.spyOn(consola, "info").mockImplementation(() => {});

package/tests/utils/package-utils.spec.ts

@@ -7,8 +7,8 @@ import {
   discoverWorkspacePackages,
   hasAngularCoreDependency,
   mergeTestsPackagesIntoConfig,
-  iteratePackages,
 } from "../../src/utils/package-utils";
+import { iteratePackages } from "../../src/utils/package-classify";
 
 describe("validateTargets", () => {
   const packages = {

package/tests/utils/rebuild-manager.spec.ts

@@ -1,5 +1,5 @@
-import { describe, it, expect, vi } from "vitest";
-import { RebuildManager } from "../../src/utils/rebuild-manager";
+import { describe, it, expect, vi, beforeEach, afterEach } from "vitest";
+import { RebuildManager } from "../../src/runtime/rebuild-manager";
 
 function createManager() {
   const logger = { start: vi.fn(), success: vi.fn(), error: vi.fn(), debug: vi.fn() };
@@ -8,6 +8,14 @@ function createManager() {
 }
 
 describe("RebuildManager", () => {
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+
+  afterEach(() => {
+    vi.useRealTimers();
+  });
+
   it("batches concurrent builds into single batchComplete event", async () => {
     const { manager } = createManager();
     const batchComplete = vi.fn();
@@ -20,8 +28,8 @@ describe("RebuildManager", () => {
     resolverA();
     resolverB();
 
-    // Wait for batch to process (microtask)
-    await new Promise((r) => setTimeout(r, 50));
+    // 100ms 디바운스 타이머 소진 + Promise 해소
+    await vi.advanceTimersByTimeAsync(100);
 
     expect(batchComplete).toHaveBeenCalledOnce();
   });
@@ -34,12 +42,17 @@ describe("RebuildManager", () => {
     const resolverA = manager.registerBuild("a", "Build A");
     resolverA();
 
-    // Wait for first batch to start, then register new build
-    await new Promise((r) => setTimeout(r, 10));
+    // 첫 번째 배치 타이머 소진 → _runBatch 시작
+    await vi.advanceTimersByTimeAsync(100);
+
+    expect(batchComplete).toHaveBeenCalledTimes(1);
+
+    // 첫 번째 배치 완료 후 새 빌드 등록
     const resolverB = manager.registerBuild("b", "Build B");
     resolverB();
 
-    await new Promise((r) => setTimeout(r, 100));
+    // 두 번째 배치 타이머 소진
+    await vi.advanceTimersByTimeAsync(100);
 
     expect(batchComplete).toHaveBeenCalledTimes(2);
   });

package/tests/utils/replace-deps-split.verify.md

@@ -0,0 +1,15 @@
+# replace-deps.ts 분할 -- LLM 검증
+
+## 검증 항목
+
+- [x] 파일 구조: `replace-deps-resolve.ts` 신규 생성, `replace-deps.ts` 기존 유지 확인
+- [x] 해석 함수 이동: `resolveReplaceDepEntries`, `parseWorkspaceGlobs`, `collectSearchRoots`, `resolveAllReplaceDepEntries`가 `replace-deps-resolve.ts`에 위치
+- [x] 타입 위치: `ReplaceDepEntry`가 `replace-deps-resolve.ts`에서 export, `replace-deps.ts`에서 `export type` re-export
+- [x] `WatchReplaceDepResult`가 `replace-deps.ts`에서 export
+- [x] `replace-deps.ts`에서 `resolveAllReplaceDepEntries`를 import하여 사용
+- [x] `commands/publish.ts` import 경로가 `../utils/replace-deps-resolve`로 변경
+- [x] `sd-cli.ts`, `BaseOrchestrator.ts`, `commands/replace-deps.ts`의 import 경로는 변경 없음 (실행 함수만 사용)
+- [x] `tests/utils/replace-deps.spec.ts` import 경로가 `../../src/deps/replace-deps-resolve`로 변경
+- [x] `tests/utils/replace-deps-watch.spec.ts`, `replace-deps-watch.acc.spec.ts`의 import 경로는 변경 없음
+- [x] `replace-deps.ts`에서 `glob` import가 제거됨 (해석 로직 전용)
+- [x] `replace-deps-resolve.ts`에서 `fsx`, `FsWatcher`, `exec` import가 없음 (실행 로직 전용)

package/tests/utils/replace-deps-watch.acc.spec.ts

@@ -0,0 +1,131 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { watchReplaceDeps } from "../../src/deps/replace-deps/replace-deps";
+import type { WatchReplaceDepResult } from "../../src/deps/replace-deps/replace-deps";
+
+/**
+ * watchReplaceDeps onChanged 콜백 통합 테스트.
+ *
+ * 실제 파일시스템에서 임시 디렉토리 구조를 생성하고,
+ * watchReplaceDeps를 실행한 뒤 파일 변경 → onChanged 콜백 호출을 검증한다.
+ *
+ * 구조:
+ *   tmpDir/
+ *     source-pkg/         ← replaceDeps 소스 (감시 대상)
+ *       src/
+ *         index.ts
+ *     project/
+ *       node_modules/
+ *         @test/
+ *           pkg/          ← replaceDeps 타겟 (복사 대상)
+ *             src/
+ *               index.ts
+ *       pnpm-workspace.yaml
+ */
+describe("watchReplaceDeps onChanged 콜백", () => {
+  let tmpDir: string;
+  let watchResult: WatchReplaceDepResult | undefined;
+
+  beforeEach(async () => {
+    tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "sd-replace-deps-"));
+
+    // 소스 패키지 생성
+    const sourceDir = path.join(tmpDir, "source-pkg", "src");
+    await fs.promises.mkdir(sourceDir, { recursive: true });
+    await fs.promises.writeFile(path.join(sourceDir, "index.ts"), "export const a = 1;");
+
+    // 프로젝트 구조 생성
+    const targetDir = path.join(tmpDir, "project", "node_modules", "@test", "pkg", "src");
+    await fs.promises.mkdir(targetDir, { recursive: true });
+    await fs.promises.writeFile(path.join(targetDir, "index.ts"), "export const a = 1;");
+
+    // pnpm-workspace.yaml (빈 워크스페이스)
+    await fs.promises.writeFile(
+      path.join(tmpDir, "project", "pnpm-workspace.yaml"),
+      "packages:\n",
+    );
+  });
+
+  afterEach(async () => {
+    watchResult?.dispose();
+    watchResult = undefined;
+    // 임시 디렉토리 정리
+    await fs.promises.rm(tmpDir, { recursive: true, force: true });
+  });
+
+  it("파일 복사 완료 후 onChanged 콜백이 호출된다", async () => {
+    const projectRoot = path.join(tmpDir, "project");
+    const sourcePath = path.join(tmpDir, "source-pkg");
+    const replaceDeps = { "@test/pkg": sourcePath };
+
+    let resolveChanged: () => void;
+    const changedPromise = new Promise<void>((resolve) => {
+      resolveChanged = resolve;
+    });
+
+    watchResult = await watchReplaceDeps(projectRoot, replaceDeps, {
+      onChanged: () => {
+        resolveChanged();
+      },
+    });
+
+    // 소스 파일 수정
+    await fs.promises.writeFile(
+      path.join(sourcePath, "src", "index.ts"),
+      "export const a = 2;",
+    );
+
+    // 콜백 호출 대기
+    await changedPromise;
+  }, 10_000);
+
+  it("onChanged 미등록 시 에러 없이 정상 동작한다", async () => {
+    const projectRoot = path.join(tmpDir, "project");
+    const sourcePath = path.join(tmpDir, "source-pkg");
+    const replaceDeps = { "@test/pkg": sourcePath };
+
+    // onChanged 없이 호출
+    watchResult = await watchReplaceDeps(projectRoot, replaceDeps);
+
+    // 소스 파일 수정
+    await fs.promises.writeFile(
+      path.join(sourcePath, "src", "index.ts"),
+      "export const a = 3;",
+    );
+
+    // 에러 없이 대기
+    await new Promise((r) => setTimeout(r, 1500));
+
+    // 파일이 복사되었는지 확인
+    const targetContent = await fs.promises.readFile(
+      path.join(tmpDir, "project", "node_modules", "@test", "pkg", "src", "index.ts"),
+      "utf-8",
+    );
+    expect(targetContent).toBe("export const a = 3;");
+  }, 10_000);
+
+  it("파일 삭제 시에도 onChanged 콜백이 호출된다", async () => {
+    const projectRoot = path.join(tmpDir, "project");
+    const sourcePath = path.join(tmpDir, "source-pkg");
+    const replaceDeps = { "@test/pkg": sourcePath };
+
+    let resolveChanged: () => void;
+    const changedPromise = new Promise<void>((resolve) => {
+      resolveChanged = resolve;
+    });
+
+    watchResult = await watchReplaceDeps(projectRoot, replaceDeps, {
+      onChanged: () => {
+        resolveChanged();
+      },
+    });
+
+    // 소스 파일 삭제
+    await fs.promises.unlink(path.join(sourcePath, "src", "index.ts"));
+
+    // 콜백 호출 대기
+    await changedPromise;
+  }, 10_000);
+});

package/tests/utils/replace-deps-watch.spec.ts

@@ -0,0 +1,91 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import fs from "fs";
+import path from "path";
+import os from "os";
+import { watchReplaceDeps } from "../../src/deps/replace-deps/replace-deps";
+import type { WatchReplaceDepResult } from "../../src/deps/replace-deps/replace-deps";
+
+/**
+ * watchReplaceDeps onChanged 콜백 단위 테스트.
+ * 실제 파일시스템으로 테스트하되 개별 동작에 집중한다.
+ */
+describe("watchReplaceDeps onChanged", () => {
+  let tmpDir: string;
+  let watchResult: WatchReplaceDepResult | undefined;
+
+  beforeEach(async () => {
+    tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "sd-replace-deps-unit-"));
+
+    // 소스 패키지 생성
+    const sourceDir = path.join(tmpDir, "source-pkg", "src");
+    await fs.promises.mkdir(sourceDir, { recursive: true });
+    await fs.promises.writeFile(path.join(sourceDir, "index.ts"), "export const v = 1;");
+
+    // 프로젝트 구조 생성
+    const targetDir = path.join(tmpDir, "project", "node_modules", "@test", "pkg", "src");
+    await fs.promises.mkdir(targetDir, { recursive: true });
+    await fs.promises.writeFile(path.join(targetDir, "index.ts"), "export const v = 1;");
+
+    // pnpm-workspace.yaml
+    await fs.promises.writeFile(
+      path.join(tmpDir, "project", "pnpm-workspace.yaml"),
+      "packages:\n",
+    );
+  });
+
+  afterEach(async () => {
+    watchResult?.dispose();
+    watchResult = undefined;
+    await fs.promises.rm(tmpDir, { recursive: true, force: true });
+  });
+
+  it("복수 파일 변경 시 300ms 배칭 후 onChanged가 한 번 호출된다", async () => {
+    const projectRoot = path.join(tmpDir, "project");
+    const sourcePath = path.join(tmpDir, "source-pkg");
+
+    // 추가 파일 생성
+    await fs.promises.writeFile(path.join(sourcePath, "src", "utils.ts"), "export const u = 1;");
+    const targetUtilsDir = path.join(tmpDir, "project", "node_modules", "@test", "pkg", "src");
+    await fs.promises.writeFile(path.join(targetUtilsDir, "utils.ts"), "export const u = 1;");
+
+    let callCount = 0;
+    let resolveChanged: () => void;
+    const changedPromise = new Promise<void>((resolve) => {
+      resolveChanged = resolve;
+    });
+
+    watchResult = await watchReplaceDeps(projectRoot, { "@test/pkg": sourcePath }, {
+      onChanged: () => {
+        callCount++;
+        resolveChanged();
+      },
+    });
+
+    // 짧은 간격으로 두 파일 모두 변경
+    await fs.promises.writeFile(path.join(sourcePath, "src", "index.ts"), "export const v = 2;");
+    await fs.promises.writeFile(path.join(sourcePath, "src", "utils.ts"), "export const u = 2;");
+
+    // 콜백 호출 대기
+    await changedPromise;
+
+    // 추가 호출이 없는지 확인하기 위해 잠시 대기
+    await new Promise((r) => setTimeout(r, 1000));
+
+    // 배칭으로 인해 1번만 호출
+    expect(callCount).toBe(1);
+  }, 10_000);
+
+  it("options 파라미터가 undefined일 때 에러가 발생하지 않는다", async () => {
+    const projectRoot = path.join(tmpDir, "project");
+    const sourcePath = path.join(tmpDir, "source-pkg");
+
+    // options를 명시적으로 undefined 전달
+    watchResult = await watchReplaceDeps(projectRoot, { "@test/pkg": sourcePath }, undefined);
+
+    // 파일 변경
+    await fs.promises.writeFile(path.join(sourcePath, "src", "index.ts"), "export const v = 99;");
+
+    await new Promise((r) => setTimeout(r, 1500));
+    // 에러 없이 완료됨
+  }, 10_000);
+});

package/tests/utils/replace-deps-watch.verify.md

@@ -0,0 +1,9 @@
+# replaceDeps 감시 통합 — LLM 검증
+
+## 검증 항목
+
+- [x] watchReplaceDeps 시그니처에 optional `options` 파라미터가 추가되었는가: `replace-deps.ts:321`에 `options?: { onChanged?: () => void }` 확인
+- [x] onChanged 콜백이 파일 복사 루프 완료 후(for 루프 바깥) 호출되는가: `replace-deps.ts:393`에서 for 루프(346-392) 완료 후 `options?.onChanged?.()` 호출 확인
+- [x] 기존 watchReplaceDeps 호출자가 새 시그니처와 호환되는가: `DevWatchOrchestrator.ts:121`에서 2개 인자로 호출 — 3번째 optional 파라미터 생략으로 호환
+- [x] esbuild onEnd 플러그인(esbuild-client-config.ts)이 빌드 결과를 외부로 전달하는 경로가 존재하는가: `esbuild-client-config.ts:215-218`에 `sd-on-end` 플러그인이 `options.onEnd(result)` 호출
+- [x] hmrService.onBuildEnd()가 metafile 기반으로 HMR 메시지를 디스패치하는 경로가 존재하는가: `hmr-service.ts:49-133`에 metafile 기반 변경 판별 → WS broadcast 로직 존재

package/tests/utils/replace-deps.spec.ts

@@ -1,5 +1,5 @@
 import { describe, it, expect } from "vitest";
-import { resolveReplaceDepEntries, parseWorkspaceGlobs } from "../../src/utils/replace-deps";
+import { resolveReplaceDepEntries, parseWorkspaceGlobs } from "../../src/deps/replace-deps/replace-deps-resolve";
 
 describe("resolveReplaceDepEntries", () => {
   it("matches exact package names", () => {

package/tests/utils/scss-compiler.spec.ts

@@ -6,7 +6,7 @@ import {
   compileScssFile,
   compileScssFileAsync,
   compileScssStringAsync,
-} from "../../src/utils/scss-compiler";
+} from "../../src/angular/scss-compiler";
 
 const FIXTURE_DIR = resolve(import.meta.dirname, "../angular/fixtures/packages/basic-lib");
 

package/tests/utils/tsc-build.spec.ts

@@ -38,7 +38,7 @@ vi.mock("../../src/utils/output-path-rewriter", () => ({
   addJsExtensionToImports: vi.fn((text: string) => text + "/* js-ext-applied */"),
 }));
 
-vi.mock("../../src/utils/typecheck-serialization", () => ({
+vi.mock("../../src/typecheck/typecheck-serialization", () => ({
   serializeDiagnostic: vi.fn((d: any) => ({ code: d.code, category: d.category })),
 }));
 

package/tests/utils/typecheck-non-package.spec.ts

@@ -11,7 +11,7 @@ vi.mock("../../src/utils/tsconfig", () => ({
   parseTsconfig: mocks.parseTsconfig,
 }));
 
-vi.mock("../../src/utils/typecheck-serialization", () => ({
+vi.mock("../../src/typecheck/typecheck-serialization", () => ({
   serializeDiagnostic: mocks.serializeDiagnostic,
 }));
 
@@ -29,7 +29,7 @@ vi.mock("typescript", async (importOriginal) => {
   };
 });
 
-const { typecheckNonPackageFiles } = await import("../../src/utils/typecheck-non-package");
+const { typecheckNonPackageFiles } = await import("../../src/typecheck/typecheck-non-package");
 
 describe("typecheckNonPackageFiles", () => {
   beforeEach(() => {

package/tests/utils/worker-utils.spec.ts

@@ -1,5 +1,6 @@
+/* eslint-disable no-restricted-properties -- 테스트 환경변수 조작 필요 */
 import { describe, it, expect, vi, afterEach } from "vitest";
-import { setupWorkerConsola, createOnceGuard, registerCleanupHandlers } from "../../src/utils/worker-utils";
+import { setupWorkerConsola, createOnceGuard, registerCleanupHandlers } from "../../src/runtime/worker-utils";
 import consola, { LogLevels } from "consola";
 
 describe("setupWorkerConsola", () => {