@simplysm/sd-cli 13.0.11 → 13.0.13

package/src/orchestrators/WatchOrchestrator.ts

@@ -1,12 +1,11 @@
 import path from "path";
-import { Listr } from "listr2";
 import { consola } from "consola";
 import type { BuildTarget, SdConfig, SdPackageConfig } from "../sd-config.types";
 import { loadSdConfig } from "../utils/sd-config";
 import { filterPackagesByTargets } from "../utils/package-utils";
 import { setupReplaceDeps, watchReplaceDeps, type WatchReplaceDepResult } from "../utils/replace-deps";
 import { printErrors } from "../utils/output-utils";
-import { RebuildListrManager } from "../utils/listr-manager";
+import { RebuildManager } from "../utils/rebuild-manager";
 import { ResultCollector } from "../infra/ResultCollector";
 import { SignalHandler } from "../infra/SignalHandler";
 import { LibraryBuilder } from "../builders/LibraryBuilder";
@@ -38,7 +37,7 @@ export class WatchOrchestrator {
 
   private _resultCollector!: ResultCollector;
   private _signalHandler!: SignalHandler;
-  private _rebuildManager!: RebuildListrManager;
+  private _rebuildManager!: RebuildManager;
   private _libraryBuilder!: LibraryBuilder;
   private _dtsBuilder!: DtsBuilder;
   private _packages: PackageInfo[] = [];
@@ -69,7 +68,7 @@ export class WatchOrchestrator {
       });
       this._logger.debug("sd.config.ts 로드 완료");
     } catch (err) {
-      consola.error(`sd.config.ts 로드 실패: ${err instanceof Error ? err.message : err}`);
+      this._logger.error(`sd.config.ts 로드 실패: ${err instanceof Error ? err.message : err}`);
       process.exitCode = 1;
       throw err;
     }
@@ -109,7 +108,7 @@ export class WatchOrchestrator {
     // 인프라 초기화
     this._resultCollector = new ResultCollector();
     this._signalHandler = new SignalHandler();
-    this._rebuildManager = new RebuildListrManager(this._logger);
+    this._rebuildManager = new RebuildManager(this._logger);
 
     // 배치 완료 시 에러 출력
     this._rebuildManager.on("batchComplete", () => {
@@ -133,7 +132,7 @@ export class WatchOrchestrator {
 
   /**
    * Watch 모드 시작
-   * - 초기 빌드 Listr 실행
+   * - 초기 빌드 실행
    * - 결과 출력
    */
   async start(): Promise<void> {
@@ -141,26 +140,10 @@ export class WatchOrchestrator {
       return;
     }
 
-    // 초기 빌드 Listr 구성
+    // 초기 빌드 Promise 구성
     const buildPromises = this._libraryBuilder.getInitialBuildPromises();
     const dtsPromises = this._dtsBuilder.getInitialBuildPromises();
 
-    const initialListr = new Listr(
-      [
-        // Library 빌드 태스크
-        ...this._packages.map((pkg) => ({
-          title: `${pkg.name} (${pkg.config.target})`,
-          task: () => buildPromises.get(`${pkg.name}:build`) ?? Promise.resolve(),
-        })),
-        // DTS 태스크
-        ...this._packages.map((pkg) => ({
-          title: `${pkg.name} (dts)`,
-          task: () => dtsPromises.get(`${pkg.name}:dts`) ?? Promise.resolve(),
-        })),
-      ],
-      { concurrent: true },
-    );
-
     // copySrc watch 시작
     for (const pkg of this._packages) {
       const buildConfig = pkg.config as SdBuildPackageConfig;
@@ -174,8 +157,42 @@ export class WatchOrchestrator {
     void this._libraryBuilder.startWatch();
     void this._dtsBuilder.startWatch();
 
-    // Listr 실행 (초기 빌드 완료까지 대기)
-    await initialListr.run();
+    // 초기 빌드 시작
+    this._logger.start("초기 빌드 진행 중...");
+
+    // Library 빌드 및 DTS 빌드 전체 Promise 배열 구성
+    const allBuildTasks: Array<{ name: string; promise: Promise<void> }> = [];
+
+    // Library 빌드 태스크
+    for (const pkg of this._packages) {
+      const promise = buildPromises.get(`${pkg.name}:build`) ?? Promise.resolve();
+      allBuildTasks.push({
+        name: `${pkg.name}:build`,
+        promise: (async () => {
+          this._logger.debug(`${pkg.name} (${pkg.config.target}) 빌드 시작`);
+          await promise;
+          this._logger.debug(`${pkg.name} (${pkg.config.target}) 빌드 완료`);
+        })(),
+      });
+    }
+
+    // DTS 태스크
+    for (const pkg of this._packages) {
+      const promise = dtsPromises.get(`${pkg.name}:dts`) ?? Promise.resolve();
+      allBuildTasks.push({
+        name: `${pkg.name}:dts`,
+        promise: (async () => {
+          this._logger.debug(`${pkg.name} (dts) 시작`);
+          await promise;
+          this._logger.debug(`${pkg.name} (dts) 완료`);
+        })(),
+      });
+    }
+
+    // 모든 빌드 작업 동시 실행 (초기 빌드 완료까지 대기)
+    await Promise.allSettled(allBuildTasks.map((task) => task.promise));
+
+    this._logger.success("초기 빌드 완료");
 
     // 초기 빌드 결과 출력
     printErrors(this._resultCollector.toMap());

package/src/orchestrators/index.ts

@@ -1 +1,3 @@
+export { BuildOrchestrator, type BuildOrchestratorOptions } from "./BuildOrchestrator";
+export { DevOrchestrator, type DevOrchestratorOptions } from "./DevOrchestrator";
 export { WatchOrchestrator, type WatchOrchestratorOptions } from "./WatchOrchestrator";

package/src/sd-cli-entry.ts

@@ -85,7 +85,7 @@ export function createCliParser(argv: string[]): Argv {
             default: [],
           })
           .options({
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -96,7 +96,7 @@ export function createCliParser(argv: string[]): Argv {
       async (args) => {
         await runTypecheck({
           targets: args.targets,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -114,7 +114,7 @@ export function createCliParser(argv: string[]): Argv {
             default: [],
           })
           .options({
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -125,7 +125,7 @@ export function createCliParser(argv: string[]): Argv {
       async (args) => {
         await runWatch({
           targets: args.targets,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -143,7 +143,7 @@ export function createCliParser(argv: string[]): Argv {
             default: [],
           })
           .options({
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -154,7 +154,7 @@ export function createCliParser(argv: string[]): Argv {
       async (args) => {
         await runDev({
           targets: args.targets,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -172,7 +172,7 @@ export function createCliParser(argv: string[]): Argv {
             default: [],
           })
           .options({
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -183,7 +183,7 @@ export function createCliParser(argv: string[]): Argv {
       async (args) => {
         await runBuild({
           targets: args.targets,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -206,7 +206,7 @@ export function createCliParser(argv: string[]): Argv {
               alias: "u",
               describe: "개발 서버 URL (미지정 시 sd.config.ts의 server 설정 사용)",
             },
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -218,7 +218,7 @@ export function createCliParser(argv: string[]): Argv {
         await runDevice({
           package: args.package,
           url: args.url,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -279,7 +279,7 @@ export function createCliParser(argv: string[]): Argv {
               describe: "실제 배포 없이 시뮬레이션",
               default: false,
             },
-            "options": {
+            "configOpt": {
               type: "string",
               array: true,
               alias: "o",
@@ -292,7 +292,7 @@ export function createCliParser(argv: string[]): Argv {
           targets: args.targets,
           noBuild: !args.build,
           dryRun: args.dryRun,
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )
@@ -304,7 +304,7 @@ export function createCliParser(argv: string[]): Argv {
           .version(false)
           .hide("help")
           .options({
-            options: {
+            configOpt: {
               type: "string",
               array: true,
               alias: "o",
@@ -314,7 +314,7 @@ export function createCliParser(argv: string[]): Argv {
           }),
       async (args) => {
         await runReplaceDeps({
-          options: args.options,
+          options: args.configOpt,
         });
       },
     )

package/src/sd-cli.ts

@@ -12,15 +12,16 @@ import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
 
-const cliEntryUrl = import.meta.resolve("./sd-cli-entry");
-const cliEntryFilePath = fileURLToPath(cliEntryUrl);
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const isDev = path.extname(__filename) === ".ts";
 
-if (path.extname(cliEntryFilePath) === ".ts") {
+if (isDev) {
   // 개발 모드 (.ts): affinity 적용 후 직접 실행
   // import만으로는 메인 모듈 감지가 실패하므로 (process.argv[1] ≠ sd-cli-entry)
   // createCliParser를 명시적으로 호출한다.
   configureAffinityAndPriority(process.pid);
-  const { createCliParser } = await import(cliEntryUrl);
+  const { createCliParser } = await import("./sd-cli-entry.js");
   await createCliParser(process.argv.slice(2)).parse();
 } else {
   // 배포 모드 (.js): 2단계 실행
@@ -38,6 +39,7 @@ if (path.extname(cliEntryFilePath) === ".ts") {
   }
 
   // Phase 2: 새 프로세스로 실제 CLI 실행 (모듈 캐시 초기화)
+  const cliEntryFilePath = path.join(__dirname, "sd-cli-entry.js");
   const child = spawn(
     "node",
     ["--max-old-space-size=8192", "--max-semi-space-size=16", cliEntryFilePath, ...process.argv.slice(2)],

package/src/utils/esbuild-config.ts

@@ -2,45 +2,42 @@ import path from "path";
 import { readFileSync, existsSync } from "fs";
 import fs from "fs/promises";
 import { createRequire } from "module";
-import { glob } from "glob";
 import type esbuild from "esbuild";
 import { solidPlugin } from "esbuild-plugin-solid";
 import type { TypecheckEnv } from "./tsconfig";
 
 /**
- * ESM 상대 import 경로에 .js 확장자를 추가하는 esbuild 플러그인.
+ * esbuild outputFiles 중 실제로 변경된 파일만 디스크에 쓴다.
  *
- * bundle: false 모드에서 esbuild는 import 경로를 그대로 유지하므로,
- * Node.js ESM에서 직접 실행 시 확장자 누락으로 모듈을 찾지 못하는 문제를 해결한다.
+ * - .js 파일: ESM 상대 import 경로에 .js 확장자를 추가한 후 비교
+ * - 그 외 파일(.js.map 등): 원본 그대로 비교
+ * - 기존 파일과 내용이 동일하면 쓰기를 건너뛰어 타임스탬프를 유지한다.
  */
-function esmRelativeImportPlugin(outdir: string): esbuild.Plugin {
-  return {
-    name: "esm-relative-import",
-    setup(build) {
-      build.onEnd(async () => {
-        const files = await glob("**/*.js", { cwd: outdir });
-
-        await Promise.all(
-          files.map(async (file) => {
-            const filePath = path.join(outdir, file);
-            const content = await fs.readFile(filePath, "utf-8");
-
-            const rewritten = content.replace(
-              /((?:from|import)\s*["'])(\.\.?\/[^"']*?)(["'])/g,
-              (_match, prefix: string, importPath: string, suffix: string) => {
-                if (/\.(js|mjs|cjs|json|css|wasm|node)$/i.test(importPath)) return _match;
-                return `${prefix}${importPath}.js${suffix}`;
-              },
-            );
-
-            if (rewritten !== content) {
-              await fs.writeFile(filePath, rewritten);
-            }
-          }),
-        );
-      });
-    },
-  };
+export async function writeChangedOutputFiles(outputFiles: esbuild.OutputFile[]): Promise<void> {
+  await Promise.all(
+    outputFiles.map(async (file) => {
+      const finalText = file.path.endsWith(".js")
+        ? file.text.replace(
+            /((?:from|import)\s*["'])(\.\.?\/[^"']*?)(["'])/g,
+            (_match, prefix: string, importPath: string, suffix: string) => {
+              if (/\.(js|mjs|cjs|json|css|wasm|node)$/i.test(importPath)) return _match;
+              return `${prefix}${importPath}.js${suffix}`;
+            },
+          )
+        : file.text;
+
+      // Compare with existing file — skip write if unchanged
+      try {
+        const existing = await fs.readFile(file.path, "utf-8");
+        if (existing === finalText) return;
+      } catch {
+        // File doesn't exist yet
+      }
+
+      await fs.mkdir(path.dirname(file.path), { recursive: true });
+      await fs.writeFile(file.path, finalText);
+    }),
+  );
 }
 
 /**
@@ -86,7 +83,7 @@ function hasSolidDependency(pkgDir: string): boolean {
  * - target: node면 node20, 그 외는 chrome84
  */
 export function createLibraryEsbuildOptions(options: LibraryEsbuildOptions): esbuild.BuildOptions {
-  const plugins: esbuild.Plugin[] = [esmRelativeImportPlugin(path.join(options.pkgDir, "dist"))];
+  const plugins: esbuild.Plugin[] = [];
 
   if (hasSolidDependency(options.pkgDir)) {
     plugins.unshift(solidPlugin());
@@ -101,6 +98,7 @@ export function createLibraryEsbuildOptions(options: LibraryEsbuildOptions): esb
     platform: options.target === "node" ? "node" : "browser",
     target: options.target === "node" ? "node20" : "chrome84",
     bundle: false,
+    write: false,
     tsconfigRaw: { compilerOptions: options.compilerOptions as esbuild.TsconfigRaw["compilerOptions"] },
     plugins,
   };

package/src/utils/output-utils.ts

@@ -10,7 +10,6 @@ type ErrorResult = PackageResult | BuildResult;
 
 /**
  * 에러만 출력한다.
- * 성공한 빌드는 listr의 체크마크로 이미 표시되므로 별도 출력하지 않음.
  * @param results 패키지별 빌드 결과 상태
  */
 export function printErrors(results: Map<string, ErrorResult>): void {
@@ -35,7 +34,7 @@ export function printErrors(results: Map<string, ErrorResult>): void {
  */
 export function printServers(results: Map<string, PackageResult>, serverClientsMap?: Map<string, string[]>): void {
   // 서버 정보 수집
-  const servers = [...results.values()].filter((r) => r.status === "server" && r.port != null);
+  const servers = [...results.values()].filter((r) => r.status === "running" && r.port != null);
 
   // 서버 정보 출력 (있으면 앞에 빈 줄 추가)
   if (servers.length > 0) {

package/src/utils/package-utils.ts

@@ -1,5 +1,20 @@
+import path from "path";
+import fs from "fs";
 import type { SdPackageConfig } from "../sd-config.types";
 
+/**
+ * import.meta.dirname에서 상위로 올라가며 package.json을 찾아 패키지 루트를 반환한다.
+ */
+export function findPackageRoot(startDir: string): string {
+  let dir = startDir;
+  while (!fs.existsSync(path.join(dir, "package.json"))) {
+    const parent = path.dirname(dir);
+    if (parent === dir) throw new Error("package.json을 찾을 수 없습니다.");
+    dir = parent;
+  }
+  return dir;
+}
+
 /**
  * 패키지명에서 watch scope 목록을 생성한다.
  * - 패키지명의 scope (예: "@myapp/root" → "@myapp")
@@ -23,7 +38,7 @@ export interface PackageResult {
   name: string;
   target: string;
   type: "build" | "dts" | "server" | "capacitor";
-  status: "success" | "error" | "server";
+  status: "success" | "error" | "running";
   message?: string;
   port?: number;
 }

package/src/utils/rebuild-manager.ts

@@ -0,0 +1,65 @@
+import { EventEmitter } from "node:events";
+import { consola } from "consola";
+
+interface RebuildManagerEvents {
+  batchComplete: [];
+}
+
+export class RebuildManager extends EventEmitter<RebuildManagerEvents> {
+  private _isRunning = false;
+  private readonly _pendingBuilds = new Map<string, { title: string; promise: Promise<void>; resolver: () => void }>();
+  private readonly _logger: ReturnType<typeof consola.withTag>;
+
+  constructor(logger: ReturnType<typeof consola.withTag>) {
+    super();
+    this._logger = logger;
+  }
+
+  registerBuild(key: string, title: string): () => void {
+    let resolver!: () => void;
+    const promise = new Promise<void>((resolve) => {
+      resolver = resolve;
+    });
+
+    this._pendingBuilds.set(key, { title, promise, resolver });
+
+    if (!this._isRunning) {
+      void Promise.resolve().then(() => void this._runBatch());
+    }
+
+    return resolver;
+  }
+
+  private async _runBatch(): Promise<void> {
+    if (this._isRunning || this._pendingBuilds.size === 0) {
+      return;
+    }
+
+    this._isRunning = true;
+
+    const batchBuilds = new Map(this._pendingBuilds);
+    this._pendingBuilds.clear();
+
+    const tasks = Array.from(batchBuilds.entries());
+    for (const [, { title }] of tasks) {
+      this._logger.debug(`리빌드 시작: ${title}`);
+    }
+
+    const results = await Promise.allSettled(tasks.map(([, { promise }]) => promise));
+
+    const failed = results.filter((r): r is PromiseRejectedResult => r.status === "rejected");
+    if (failed.length > 0) {
+      for (const result of failed) {
+        this._logger.error("리빌드 중 오류 발생", { error: String(result.reason) });
+      }
+    }
+
+    this.emit("batchComplete");
+
+    this._isRunning = false;
+
+    if (this._pendingBuilds.size > 0) {
+      void this._runBatch();
+    }
+  }
+}

package/src/utils/replace-deps.ts

@@ -120,19 +120,15 @@ export interface WatchReplaceDepResult {
 }
 
 /**
- * replaceDeps 설정에 따라 node_modules 내 패키지를 소스 디렉토리로 복사 교체한다.
+ * 프로젝트 루트와 workspace 패키지 경로 목록을 수집한다.
  *
- * 1. pnpm-workspace.yaml 파싱 → workspace 패키지 경로 목록
- * 2. [루트, ...workspace 패키지]의 node_modules에서 매칭되는 패키지 찾기
- * 3. 기존 symlink/디렉토리 제거 → 소스 경로를 복사 (node_modules, package.json, .cache, tests 제외)
+ * pnpm-workspace.yaml을 파싱하여 workspace 패키지들의 절대 경로를 수집한다.
+ * 파일이 없거나 파싱 실패 시 루트 경로만 반환한다.
  *
  * @param projectRoot - 프로젝트 루트 경로
- * @param replaceDeps - sd.config.ts의 replaceDeps 설정
+ * @returns [루트, ...workspace 패키지 경로] 배열
  */
-export async function setupReplaceDeps(projectRoot: string, replaceDeps: Record<string, string>): Promise<void> {
-  const logger = consola.withTag("sd:cli:replace-deps");
-
-  // 1. Workspace 패키지 경로 목록 수집
+async function collectSearchRoots(projectRoot: string): Promise<string[]> {
   const searchRoots = [projectRoot];
 
   const workspaceYamlPath = path.join(projectRoot, "pnpm-workspace.yaml");
@@ -148,6 +144,25 @@ export async function setupReplaceDeps(projectRoot: string, replaceDeps: Record<
     // pnpm-workspace.yaml가 없으면 루트만 처리
   }
 
+  return searchRoots;
+}
+
+/**
+ * replaceDeps 설정에 따라 node_modules 내 패키지를 소스 디렉토리로 복사 교체한다.
+ *
+ * 1. pnpm-workspace.yaml 파싱 → workspace 패키지 경로 목록
+ * 2. [루트, ...workspace 패키지]의 node_modules에서 매칭되는 패키지 찾기
+ * 3. 기존 symlink/디렉토리 제거 → 소스 경로를 복사 (node_modules, package.json, .cache, tests 제외)
+ *
+ * @param projectRoot - 프로젝트 루트 경로
+ * @param replaceDeps - sd.config.ts의 replaceDeps 설정
+ */
+export async function setupReplaceDeps(projectRoot: string, replaceDeps: Record<string, string>): Promise<void> {
+  const logger = consola.withTag("sd:cli:replace-deps");
+
+  // 1. Workspace 패키지 경로 목록 수집
+  const searchRoots = await collectSearchRoots(projectRoot);
+
   // 2. 각 searchRoot의 node_modules에서 매칭되는 패키지 찾기
   for (const searchRoot of searchRoots) {
     const nodeModulesDir = path.join(searchRoot, "node_modules");
@@ -226,20 +241,7 @@ export async function watchReplaceDeps(
   const entries: ReplaceDepEntry[] = [];
 
   // 1. Workspace 패키지 경로 목록 수집
-  const searchRoots = [projectRoot];
-
-  const workspaceYamlPath = path.join(projectRoot, "pnpm-workspace.yaml");
-  try {
-    const yamlContent = await fs.promises.readFile(workspaceYamlPath, "utf-8");
-    const workspaceGlobs = parseWorkspaceGlobs(yamlContent);
-
-    for (const pattern of workspaceGlobs) {
-      const dirs = await glob(pattern, { cwd: projectRoot, absolute: true });
-      searchRoots.push(...dirs);
-    }
-  } catch {
-    // pnpm-workspace.yaml가 없으면 루트만 처리
-  }
+  const searchRoots = await collectSearchRoots(projectRoot);
 
   // 2. 각 searchRoot의 node_modules에서 매칭되는 패키지 찾기
   for (const searchRoot of searchRoots) {