@simplysm/sd-cli 14.0.11 → 14.0.12

package/dist/engines/types.d.ts

@@ -3,7 +3,7 @@ import type { SerializedDiagnostic } from "../utils/typecheck-serialization";
 import type { TypecheckEnv } from "../utils/tsconfig";
 import type { LintWithProgramResult } from "../utils/lint-with-program";
 /**
- * Package information
+ * 패키지 정보
  */
 export interface PackageInfo {
     name: string;
@@ -11,38 +11,38 @@ export interface PackageInfo {
     config: SdPackageConfig;
 }
 /**
- * PackageInfo narrowed for build packages (node/browser/neutral)
+ * 빌드 패키지(node/browser/neutral)로 좁혀진 PackageInfo
  */
 export type BuildPackageInfo = PackageInfo & {
     config: SdBuildPackageConfig;
 };
 /**
- * PackageInfo narrowed for server packages
+ * 서버 패키지로 좁혀진 PackageInfo
  */
 export type ServerPackageInfo = PackageInfo & {
     config: SdServerPackageConfig;
 };
 /**
- * PackageInfo narrowed for client packages
+ * 클라이언트 패키지로 좁혀진 PackageInfo
  */
 export type ClientPackageInfo = PackageInfo & {
     config: SdClientPackageConfig;
 };
 /**
- * Build output control flags
+ * 빌드 출력 제어 플래그
  */
 export interface BuildOutput {
     js: boolean;
     dts: boolean;
-    /** When true, run ESLint using the ts.Program created during typecheck. */
+    /** true일 때, 타입체크 중 생성된 ts.Program으로 ESLint를 실행한다. */
     lint?: boolean;
-    /** Typecheck environment. When set, adjusts compilerOptions via getCompilerOptionsForEnv(). */
+    /** 타입체크 환경. 설정 시 getCompilerOptionsForEnv()를 통해 compilerOptions를 조정한다. */
     env?: TypecheckEnv;
-    /** Include tests/ files in typecheck scope. Only used by check command. */
+    /** 타입체크 범위에 tests/ 파일을 포함한다. check 커맨드에서만 사용된다. */
     includeTests?: boolean;
 }
 /**
- * BuildEngine.run() return value
+ * BuildEngine.run() 반환값
  */
 export interface EngineResult {
     success: boolean;
@@ -52,30 +52,30 @@ export interface EngineResult {
         warnings: string[];
         diagnostics: SerializedDiagnostic[];
     };
-    /** Lint result (present when BuildOutput.lint is true) */
+    /** 린트 결과 (BuildOutput.lint가 true일 때 존재) */
     lint?: LintWithProgramResult;
 }
 /**
- * Build engine interface
+ * 빌드 엔진 인터페이스
  *
- * Common contract for all build engines.
- * typecheck (diagnostics) is always included — not optional.
+ * 모든 빌드 엔진의 공통 계약.
+ * 타입체크(diagnostics)는 항상 포함되며 선택사항이 아니다.
  */
 export interface BuildEngine {
     /**
-     * One-time build (for production builds)
-     * Creates workers, runs build, returns combined result.
-     * Call stop() after to clean up resources.
+     * 일회성 빌드 (프로덕션)
+     * Worker를 생성하고, 빌드를 실행하고, 결합된 결과를 반환한다.
+     * 호출 후 stop()으로 리소스를 정리한다.
      */
     run(output: BuildOutput): Promise<EngineResult>;
     /**
-     * Start watch mode
-     * Promise resolves when initial build is complete.
-     * Subsequent rebuilds are reported via injected ResultCollector.
+     * 워치 모드 시작
+     * 초기 빌드가 완료되면 Promise가 resolve된다.
+     * 이후 리빌드는 주입된 ResultCollector를 통해 보고된다.
      */
     startWatch(output: BuildOutput): Promise<void>;
     /**
-     * Stop engine and clean up resources (workers, esbuild contexts)
+     * 엔진을 중지하고 리소스(Worker, esbuild context 등)를 정리한다
      */
     stop(): Promise<void>;
 }

package/dist/engines/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engines/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9H,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,2EAA2E;IAC3E,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+FAA+F;IAC/F,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,2EAA2E;IAC3E,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,oBAAoB,EAAE,CAAC;KACrC,CAAC;IACF,0DAA0D;IAC1D,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engines/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC9H,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,eAAe,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG;IAAE,MAAM,EAAE,qBAAqB,CAAA;CAAE,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,qDAAqD;IACrD,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,0EAA0E;IAC1E,GAAG,CAAC,EAAE,YAAY,CAAC;IACnB,mDAAmD;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE;QACL,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,WAAW,EAAE,oBAAoB,EAAE,CAAC;KACrC,CAAC;IACF,2CAA2C;IAC3C,IAAI,CAAC,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhD;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/C;;OAEG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/infra/ResultCollector.d.ts

@@ -1,5 +1,5 @@
 /**
- * Build result status
+ * 빌드 결과 상태
  */
 export interface BuildResult {
     name: string;
@@ -10,25 +10,25 @@ export interface BuildResult {
     port?: number;
 }
 /**
- * Class that collects and manages build results
+ * 빌드 결과를 수집·관리하는 클래스
  *
- * Manages build results from multiple Builders at a central location and
- * provides filtering and output functionality by status.
+ * 여러 Builder의 빌드 결과를 중앙에서 관리하며,
+ * 상태별 필터링 및 출력 기능을 제공한다.
  */
 export declare class ResultCollector {
     private readonly _results;
     /**
-     * Add result
-     * @param result build result
+     * 결과를 추가한다
+     * @param result 빌드 결과
      */
     add(result: BuildResult): void;
     /**
-     * Get result by key
-     * @param key result key (e.g., "core-common:build")
+     * 키로 결과를 조회한다
+     * @param key 결과 키 (예: "core-common:build")
      */
     get(key: string): BuildResult | undefined;
     /**
-     * Return internal Map (for backward compatibility)
+     * 내부 Map을 반환한다 (외부 접근용)
      */
     toMap(): Map<string, BuildResult>;
 }

package/dist/infra/ResultCollector.js

@@ -1,28 +1,28 @@
 /**
- * Class that collects and manages build results
+ * 빌드 결과를 수집·관리하는 클래스
  *
- * Manages build results from multiple Builders at a central location and
- * provides filtering and output functionality by status.
+ * 여러 Builder의 빌드 결과를 중앙에서 관리하며,
+ * 상태별 필터링 및 출력 기능을 제공한다.
  */
 export class ResultCollector {
     _results = new Map();
     /**
-     * Add result
-     * @param result build result
+     * 결과를 추가한다
+     * @param result 빌드 결과
      */
     add(result) {
         const key = `${result.name}:${result.type}`;
         this._results.set(key, result);
     }
     /**
-     * Get result by key
-     * @param key result key (e.g., "core-common:build")
+     * 키로 결과를 조회한다
+     * @param key 결과 키 (예: "core-common:build")
      */
     get(key) {
         return this._results.get(key);
     }
     /**
-     * Return internal Map (for backward compatibility)
+     * 내부 Map을 반환한다 (외부 접근용)
      */
     toMap() {
         return this._results;

package/dist/infra/SignalHandler.d.ts

@@ -1,8 +1,8 @@
 /**
- * Class that handles process termination signals
+ * 프로세스 종료 시그널을 처리하는 클래스
  *
- * Detects SIGINT (Ctrl+C) and SIGTERM signals and
- * provides a Promise that waits until termination.
+ * SIGINT(Ctrl+C) 및 SIGTERM 시그널을 감지하고,
+ * 종료까지 대기하는 Promise를 제공한다.
  */
 export declare class SignalHandler {
     private _terminateResolver;
@@ -10,16 +10,16 @@ export declare class SignalHandler {
     private _terminated;
     constructor();
     /**
-     * Wait until termination signal is received
+     * 종료 시그널이 수신될 때까지 대기한다
      */
     waitForTermination(): Promise<void>;
     /**
-     * Check if terminated
+     * 종료 여부를 확인한다
      */
     isTerminated(): boolean;
     /**
-     * Request termination programmatically
-     * (used when triggering termination from tests or externally)
+     * 프로그래밍 방식으로 종료를 요청한다
+     * (테스트나 외부에서 종료를 트리거할 때 사용)
      */
     requestTermination(): void;
 }

package/dist/infra/SignalHandler.js

@@ -1,8 +1,8 @@
 /**
- * Class that handles process termination signals
+ * 프로세스 종료 시그널을 처리하는 클래스
  *
- * Detects SIGINT (Ctrl+C) and SIGTERM signals and
- * provides a Promise that waits until termination.
+ * SIGINT(Ctrl+C) 및 SIGTERM 시그널을 감지하고,
+ * 종료까지 대기하는 Promise를 제공한다.
  */
 export class SignalHandler {
     _terminateResolver = null;
@@ -22,20 +22,20 @@ export class SignalHandler {
         process.on("SIGTERM", handler);
     }
     /**
-     * Wait until termination signal is received
+     * 종료 시그널이 수신될 때까지 대기한다
      */
     waitForTermination() {
         return this._terminatePromise;
     }
     /**
-     * Check if terminated
+     * 종료 여부를 확인한다
      */
     isTerminated() {
         return this._terminated;
     }
     /**
-     * Request termination programmatically
-     * (used when triggering termination from tests or externally)
+     * 프로그래밍 방식으로 종료를 요청한다
+     * (테스트나 외부에서 종료를 트리거할 때 사용)
      */
     requestTermination() {
         if (!this._terminated) {

package/dist/infra/WorkerManager.d.ts

@@ -1,39 +1,39 @@
 import { type WorkerProxy, type WorkerModule } from "@simplysm/core-node";
 /**
- * Class that manages Worker lifecycle
+ * Worker 생명주기를 관리하는 클래스
  *
- * Centrally manages Worker creation, lookup, and termination
- * to prevent resource leaks and provide consistent Worker management.
+ * Worker 생성, 조회, 종료를 중앙에서 관리하여
+ * 리소스 누수를 방지하고 일관된 Worker 관리를 제공한다.
  */
 export declare class WorkerManager {
     private readonly _workers;
     /**
-     * Create a new Worker
-     * @param id Worker identifier (e.g., "core-common:build")
-     * @param workerPath Worker file path
-     * @returns Created WorkerProxy
+     * 새 Worker를 생성한다
+     * @param id Worker 식별자 (예: "core-common:build")
+     * @param workerPath Worker 파일 경로
+     * @returns 생성된 WorkerProxy
      */
     create<TModule extends WorkerModule>(id: string, workerPath: string): WorkerProxy<TModule>;
     /**
-     * Lookup Worker by ID
-     * @param id Worker identifier
+     * ID로 Worker를 조회한다
+     * @param id Worker 식별자
      */
     get<TModule extends WorkerModule>(id: string): WorkerProxy<TModule> | undefined;
     /**
-     * Terminate and remove a specific Worker
-     * @param id Worker identifier
+     * 특정 Worker를 종료하고 제거한다
+     * @param id Worker 식별자
      */
     terminate(id: string): Promise<void>;
     /**
-     * Terminate all Workers
+     * 모든 Worker를 종료한다
      */
     terminateAll(): Promise<void>;
     /**
-     * Number of managed Workers
+     * 관리 중인 Worker 수
      */
     get size(): number;
     /**
-     * List of all Worker IDs
+     * 모든 Worker ID 목록
      */
     get ids(): string[];
 }

package/dist/infra/WorkerManager.js

@@ -1,17 +1,17 @@
 import { Worker } from "@simplysm/core-node";
 /**
- * Class that manages Worker lifecycle
+ * Worker 생명주기를 관리하는 클래스
  *
- * Centrally manages Worker creation, lookup, and termination
- * to prevent resource leaks and provide consistent Worker management.
+ * Worker 생성, 조회, 종료를 중앙에서 관리하여
+ * 리소스 누수를 방지하고 일관된 Worker 관리를 제공한다.
  */
 export class WorkerManager {
     _workers = new Map();
     /**
-     * Create a new Worker
-     * @param id Worker identifier (e.g., "core-common:build")
-     * @param workerPath Worker file path
-     * @returns Created WorkerProxy
+     * 새 Worker를 생성한다
+     * @param id Worker 식별자 (예: "core-common:build")
+     * @param workerPath Worker 파일 경로
+     * @returns 생성된 WorkerProxy
      */
     create(id, workerPath) {
         const worker = Worker.create(workerPath);
@@ -19,15 +19,15 @@ export class WorkerManager {
         return worker;
     }
     /**
-     * Lookup Worker by ID
-     * @param id Worker identifier
+     * ID로 Worker를 조회한다
+     * @param id Worker 식별자
      */
     get(id) {
         return this._workers.get(id);
     }
     /**
-     * Terminate and remove a specific Worker
-     * @param id Worker identifier
+     * 특정 Worker를 종료하고 제거한다
+     * @param id Worker 식별자
      */
     async terminate(id) {
         const worker = this._workers.get(id);
@@ -37,20 +37,20 @@ export class WorkerManager {
         }
     }
     /**
-     * Terminate all Workers
+     * 모든 Worker를 종료한다
      */
     async terminateAll() {
         await Promise.all([...this._workers.values()].map((w) => w.terminate()));
         this._workers.clear();
     }
     /**
-     * Number of managed Workers
+     * 관리 중인 Worker 수
      */
     get size() {
         return this._workers.size;
     }
     /**
-     * List of all Worker IDs
+     * 모든 Worker ID 목록
      */
     get ids() {
         return [...this._workers.keys()];

package/dist/orchestrators/BuildOrchestrator.d.ts

@@ -1,52 +1,52 @@
 import type { SdBuildPackageConfig, SdClientPackageConfig, SdServerPackageConfig } from "../sd-config.types";
 /**
- * Build Orchestrator options
+ * BuildOrchestrator 옵션
  */
 export interface BuildOrchestratorOptions {
-    /** Package filter for build (empty array includes all packages) */
+    /** 빌드 대상 패키지 필터 (빈 배열이면 전체) */
     targets: string[];
-    /** Additional options to pass to sd.config.ts */
+    /** sd.config.ts에 전달할 추가 옵션 */
     options: string[];
 }
 /**
- * Package classification result
+ * 패키지 분류 결과
  */
 interface ClassifiedPackages {
-    /** node/browser/neutral target (JS + dts) */
+    /** node/browser/neutral 대상 (JS + DTS) */
     buildPackages: Array<{
         name: string;
         config: SdBuildPackageConfig;
     }>;
-    /** server target (JS build, no dts) */
+    /** server 대상 (JS 빌드, DTS 없음) */
     serverPackages: Array<{
         name: string;
         config: SdServerPackageConfig;
     }>;
-    /** client target (Vite production build, no dts) */
+    /** client 대상 (Vite 프로덕션 빌드, DTS 없음) */
     clientPackages: Array<{
         name: string;
         config: SdClientPackageConfig;
     }>;
 }
 /**
- * Classify packages by target
- * - node/browser/neutral: buildPackages (JS + dts)
- * - server: serverPackages (JS build, no dts)
- * - client: clientPackages (Vite production build, no dts)
- * - scripts: excluded
+ * 패키지를 target별로 분류
+ * - node/browser/neutral: buildPackages (JS + DTS)
+ * - server: serverPackages (JS 빌드, DTS 없음)
+ * - client: clientPackages (Vite 프로덕션 빌드, DTS 없음)
+ * - scripts: 제외
  */
 export declare function classifyPackages(packages: Record<string, SdBuildPackageConfig | SdClientPackageConfig | SdServerPackageConfig | {
     target: "scripts";
 } | undefined>, targets: string[]): ClassifiedPackages;
 /**
- * Orchestrator for coordinating production builds
+ * 프로덕션 빌드를 조율하는 Orchestrator
  *
- * Classifies packages based on sd.config.ts and executes builds.
- * - Clean dist folders (clean build)
- * - Run lint + build concurrently
- * - node/browser/neutral targets: esbuild JS build + dts generation
- * - server targets: esbuild JS build
- * - client targets: Vite production build
+ * sd.config.ts 기반으로 패키지를 분류하고 빌드를 실행한다.
+ * - dist 폴더 정리 (클린 빌드)
+ * - lint + 빌드 동시 실행
+ * - 라이브러리 패키지: TscEngine/NgtscEngine으로 JS + DTS 빌드
+ * - 서버 패키지: BuildEngine으로 JS 빌드
+ * - 클라이언트 패키지: ViteEngine으로 Vite 프로덕션 빌드
  */
 export declare class BuildOrchestrator {
     private readonly _cwd;
@@ -66,16 +66,16 @@ export declare class BuildOrchestrator {
      */
     initialize(): Promise<void>;
     /**
-     * Execute build
-     * - Clean
-     * - Lint + Build (concurrent)
-     * - Output results
+     * 빌드 실행
+     * - 클린
+     * - lint + 빌드 (동시 실행)
+     * - 결과 출력
      *
-     * @returns whether errors occurred (true: errors present)
+     * @returns 에러 발생 여부 (true: 에러 있음)
      */
     start(): Promise<boolean>;
     /**
-     * Shutdown Orchestrator (no resources to clean up currently)
+     * Orchestrator 종료 (현재 정리할 리소스 없음)
      */
     shutdown(): Promise<void>;
 }

package/dist/orchestrators/BuildOrchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BuildOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/BuildOrchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAc5B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,mEAAmE;IACnE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD;;GAEG;AACH,UAAU,kBAAkB;IAC1B,6CAA6C;IAC7C,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;IACrE,uCAAuC;IACvC,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;IACvE,oDAAoD;IACpD,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;CACxE;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CACd,MAAM,EACJ,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB,SAAS,CACZ,EACD,OAAO,EAAE,MAAM,EAAE,GAChB,kBAAkB,CAkBpB;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,OAAO,EAAE,wBAAwB;IAK7C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAwR/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}
+{"version":3,"file":"BuildOrchestrator.d.ts","sourceRoot":"","sources":["../../src/orchestrators/BuildOrchestrator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAEV,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACtB,MAAM,oBAAoB,CAAC;AAc5B;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,+BAA+B;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD;;GAEG;AACH,UAAU,kBAAkB;IAC1B,yCAAyC;IACzC,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,oBAAoB,CAAA;KAAE,CAAC,CAAC;IACrE,gCAAgC;IAChC,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;IACvE,uCAAuC;IACvC,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,qBAAqB,CAAA;KAAE,CAAC,CAAC;CACxE;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,CACd,MAAM,EACJ,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,GACrB,SAAS,CACZ,EACD,OAAO,EAAE,MAAM,EAAE,GAChB,kBAAkB,CAkBpB;AAaD;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAE3D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAA2C;gBAE/C,OAAO,EAAE,wBAAwB;IAK7C;;;;;;OAMG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA2CjC;;;;;;;OAOG;IACG,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAwR/B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/orchestrators/BuildOrchestrator.js

@@ -14,11 +14,11 @@ import { Electron } from "../electron/electron.js";
 //#endregion
 //#region Utilities
 /**
- * Classify packages by target
- * - node/browser/neutral: buildPackages (JS + dts)
- * - server: serverPackages (JS build, no dts)
- * - client: clientPackages (Vite production build, no dts)
- * - scripts: excluded
+ * 패키지를 target별로 분류
+ * - node/browser/neutral: buildPackages (JS + DTS)
+ * - server: serverPackages (JS 빌드, DTS 없음)
+ * - client: clientPackages (Vite 프로덕션 빌드, DTS 없음)
+ * - scripts: 제외
  */
 export function classifyPackages(packages, targets) {
     const buildPackages = [];
@@ -40,7 +40,7 @@ export function classifyPackages(packages, targets) {
     return { buildPackages, serverPackages, clientPackages };
 }
 /**
- * Delete dist folders
+ * dist 폴더 삭제
  */
 async function cleanDistFolders(cwd, packageNames) {
     await Promise.all(packageNames.map((name) => fsx.rm(pathx.posixResolve(cwd, "packages", name, "dist"))));
@@ -48,14 +48,14 @@ async function cleanDistFolders(cwd, packageNames) {
 //#endregion
 //#region BuildOrchestrator
 /**
- * Orchestrator for coordinating production builds
+ * 프로덕션 빌드를 조율하는 Orchestrator
  *
- * Classifies packages based on sd.config.ts and executes builds.
- * - Clean dist folders (clean build)
- * - Run lint + build concurrently
- * - node/browser/neutral targets: esbuild JS build + dts generation
- * - server targets: esbuild JS build
- * - client targets: Vite production build
+ * sd.config.ts 기반으로 패키지를 분류하고 빌드를 실행한다.
+ * - dist 폴더 정리 (클린 빌드)
+ * - lint + 빌드 동시 실행
+ * - 라이브러리 패키지: TscEngine/NgtscEngine으로 JS + DTS 빌드
+ * - 서버 패키지: BuildEngine으로 JS 빌드
+ * - 클라이언트 패키지: ViteEngine으로 Vite 프로덕션 빌드
  */
 export class BuildOrchestrator {
     _cwd;
@@ -115,12 +115,12 @@ export class BuildOrchestrator {
         });
     }
     /**
-     * Execute build
-     * - Clean
-     * - Lint + Build (concurrent)
-     * - Output results
+     * 빌드 실행
+     * - 클린
+     * - lint + 빌드 (동시 실행)
+     * - 결과 출력
      *
-     * @returns whether errors occurred (true: errors present)
+     * @returns 에러 발생 여부 (true: 에러 있음)
      */
     async start() {
         if (this._allPackageNames.length === 0) {
@@ -128,13 +128,13 @@ export class BuildOrchestrator {
         }
         const classified = this._classified;
         const baseEnv = this._baseEnv;
-        // Collect results
+        // 결과 수집
         const results = [];
-        // Track errors (wrapped in object to allow mutation tracking in callbacks)
+        // 에러 추적 (콜백에서 변경 추적을 위해 객체로 래핑)
         const state = { hasError: false };
-        // File cache (for diagnostics output)
+        // 파일 캐시 (진단 출력용)
         const fileCache = new Map();
-        // formatHost (for diagnostics output)
+        // formatHost (진단 출력용)
         const formatHost = {
             getCanonicalFileName: (f) => f,
             getCurrentDirectory: () => this._cwd,
@@ -146,9 +146,9 @@ export class BuildOrchestrator {
         this._logger.success("dist 폴더 정리 완료");
         // Phase 2: 빌드
         const concurrency = getMaxConcurrency();
-        // Create list of build tasks
+        // 빌드 태스크 목록 생성
         const buildTasks = [];
-        // buildPackages: JS build + dts generation via BuildEngine
+        // 라이브러리 패키지: BuildEngine으로 JS + DTS 빌드
         for (const { name, config } of classified.buildPackages) {
             const pkgDir = pathx.posixResolve(this._cwd, "packages", name);
             buildTasks.push(async () => {
@@ -193,7 +193,7 @@ export class BuildOrchestrator {
                 this._logger.debug(`[${name}] (${config.target}) 빌드 완료`);
             });
         }
-        // serverPackages: JS build + typecheck via BuildEngine
+        // 서버 패키지: BuildEngine으로 JS 빌드 + 타입체크
         for (const { name, config } of classified.serverPackages) {
             const pkgDir = pathx.posixResolve(this._cwd, "packages", name);
             buildTasks.push(async () => {
@@ -233,7 +233,7 @@ export class BuildOrchestrator {
                 this._logger.debug(`[${name}] (server) 빌드 완료`);
             });
         }
-        // clientPackages: Vite production build via ViteEngine (no dts)
+        // 클라이언트 패키지: ViteEngine으로 Vite 프로덕션 빌드 (DTS 없음)
         for (const { name, config } of classified.clientPackages) {
             const pkgDir = pathx.posixResolve(this._cwd, "packages", name);
             buildTasks.push(async () => {
@@ -362,11 +362,11 @@ export class BuildOrchestrator {
         return state.hasError;
     }
     /**
-     * Shutdown Orchestrator (no resources to clean up currently)
+     * Orchestrator 종료 (현재 정리할 리소스 없음)
      */
     async shutdown() {
-        // Production builds are one-time operations, so there are no resources to clean up at shutdown
-        // Workers are cleaned up with terminate() within each build task
+        // 프로덕션 빌드는 일회성 작업이므로 종료 시 정리할 리소스가 없음
+        // Worker는 각 빌드 태스크 내에서 terminate()로 정리됨
         await Promise.resolve();
     }
 }