@simplysm/sd-cli 14.0.11 → 14.0.12

package/src/sd-config.types.ts

@@ -1,39 +1,39 @@
 /**
- * Build target type (built with esbuild)
- * - node: Node.js only package
- * - browser: browser only package
- * - neutral: Node/browser shared package
+ * 빌드 타겟 타입 (esbuild로 빌드)
+ * - node: Node.js 전용 패키지
+ * - browser: 브라우저 전용 패키지
+ * - neutral: Node/브라우저 공용 패키지
  */
 export type BuildTarget = "node" | "browser" | "neutral";
 
-//#region Publish configuration types
+//#region 배포 설정 타입
 
 /**
- * npm registry publish configuration
+ * npm 레지스트리 배포 설정
  */
 export interface SdNpmPublishConfig {
   type: "npm";
 }
 
 /**
- * Package publish configuration
- * - SdNpmPublishConfig: deploy to npm registry
- * - SdLocalDirectoryPublishConfig: copy to local directory
- * - SdStoragePublishConfig: upload to FTP/FTPS/SFTP server
+ * 패키지 배포 설정
+ * - SdNpmPublishConfig: npm 레지스트리에 배포
+ * - SdLocalDirectoryPublishConfig: 로컬 디렉토리로 복사
+ * - SdStoragePublishConfig: FTP/FTPS/SFTP 서버에 업로드
  */
 export type SdPublishConfig = SdNpmPublishConfig | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
 
 /**
- * Local directory publish configuration
+ * 로컬 디렉토리 배포 설정
  */
 export interface SdLocalDirectoryPublishConfig {
   type: "local-directory";
-  /** deployment target path (supports environment variable substitution: %VER%, %PROJECT%) */
+  /** 배포 대상 경로 (환경 변수 치환 지원: %VER%, %PROJECT%) */
   path: string;
 }
 
 /**
- * Storage (FTP/FTPS/SFTP) publish configuration
+ * 스토리지 (FTP/FTPS/SFTP) 배포 설정
  */
 export interface SdStoragePublishConfig {
   type: "ftp" | "ftps" | "sftp";
@@ -45,131 +45,131 @@ export interface SdStoragePublishConfig {
 }
 
 /**
- * postPublish script configuration
+ * postPublish 스크립트 설정
  */
 export interface SdPostPublishScriptConfig {
   type: "script";
   cmd: string;
-  /** script arguments (supports environment variable substitution: %VER%, %PROJECT%) */
+  /** 스크립트 인수 (환경 변수 치환 지원: %VER%, %PROJECT%) */
   args: string[];
 }
 
 //#endregion
 
 /**
- * Package configuration (node/browser/neutral)
+ * 패키지 설정 (node/browser/neutral)
  */
 export interface SdBuildPackageConfig {
-  /** build target */
+  /** 빌드 타겟 */
   target: BuildTarget;
-  /** publish configuration */
+  /** 배포 설정 */
   publish?: SdPublishConfig;
-  /** glob patterns for files to copy from src/ to dist/ (relative path based on src/) */
+  /** src/에서 dist/로 복사할 파일의 glob 패턴 (src/ 기준 상대 경로) */
   copySrc?: string[];
-  /** watch hook configuration (when set, hook runs alongside build engine in watch mode) */
+  /** watch 훅 설정 (설정 시, watch 모드에서 빌드 엔진과 함께 훅이 실행됨) */
   watch?: SdWatchHookConfig;
 }
 
 /**
- * Capacitor Android sign configuration
+ * Capacitor Android 서명 설정
  */
 export interface SdCapacitorSignConfig {
-  /** keystore file path (relative path based on package directory) */
+  /** keystore 파일 경로 (패키지 디렉토리 기준 상대 경로) */
   keystore: string;
-  /** keystore password */
+  /** keystore 비밀번호 */
   storePassword: string;
-  /** key alias */
+  /** 키 별칭 */
   alias: string;
-  /** key password */
+  /** 키 비밀번호 */
   password: string;
-  /** keystore type (default: "jks") */
+  /** keystore 타입 (기본값: "jks") */
   keystoreType?: string;
 }
 
 /**
- * Capacitor Android permission configuration
+ * Capacitor Android 권한 설정
  */
 export interface SdCapacitorPermission {
-  /** permission name (e.g., "CAMERA", "WRITE_EXTERNAL_STORAGE") */
+  /** 권한 이름 (예: "CAMERA", "WRITE_EXTERNAL_STORAGE") */
   name: string;
-  /** maximum SDK version */
+  /** 최대 SDK 버전 */
   maxSdkVersion?: number;
-  /** tools:ignore attribute value */
+  /** tools:ignore 속성 값 */
   ignore?: string;
 }
 
 /**
- * Capacitor Android Intent Filter configuration
+ * Capacitor Android Intent Filter 설정
  */
 export interface SdCapacitorIntentFilter {
-  /** intent action (e.g., "android.intent.action.VIEW") */
+  /** intent 액션 (예: "android.intent.action.VIEW") */
   action?: string;
-  /** intent category (e.g., "android.intent.category.DEFAULT") */
+  /** intent 카테고리 (예: "android.intent.category.DEFAULT") */
   category?: string;
 }
 
 /**
- * Capacitor Android platform configuration
+ * Capacitor Android 플랫폼 설정
  */
 export interface SdCapacitorAndroidConfig {
-  /** AndroidManifest.xml application tag attributes (e.g., { requestLegacyExternalStorage: "true" }) */
+  /** AndroidManifest.xml application 태그 속성 (예: { requestLegacyExternalStorage: "true" }) */
   config?: Record<string, string>;
-  /** AAB bundle build flag (false for APK) */
+  /** AAB 번들 빌드 플래그 (false이면 APK) */
   bundle?: boolean;
-  /** Intent Filter configuration */
+  /** Intent Filter 설정 */
   intentFilters?: SdCapacitorIntentFilter[];
-  /** APK/AAB signing configuration */
+  /** APK/AAB 서명 설정 */
   sign?: SdCapacitorSignConfig;
-  /** Android SDK version (minSdk, targetSdk) */
+  /** Android SDK 버전 (minSdk, targetSdk) */
   sdkVersion?: number;
-  /** additional permission configuration */
+  /** 추가 권한 설정 */
   permissions?: SdCapacitorPermission[];
 }
 
 /**
- * Capacitor configuration
+ * Capacitor 설정
  */
 export interface SdCapacitorConfig {
-  /** app ID (e.g., "com.example.app") */
+  /** 앱 ID (예: "com.example.app") */
   appId: string;
-  /** app name */
+  /** 앱 이름 */
   appName: string;
-  /** Capacitor plugin configuration (key: package name, value: true or plugin options) */
+  /** Capacitor 플러그인 설정 (key: 패키지명, value: true 또는 플러그인 옵션) */
   plugins?: Record<string, Record<string, unknown> | true>;
-  /** app icon path (relative path based on package directory) */
+  /** 앱 아이콘 경로 (패키지 디렉토리 기준 상대 경로) */
   icon?: string;
-  /** debug build flag */
+  /** 디버그 빌드 플래그 */
   debug?: boolean;
-  /** per-platform configuration */
+  /** 플랫폼별 설정 */
   platform?: {
     android?: SdCapacitorAndroidConfig;
   };
 }
 
 /**
- * Electron configuration
+ * Electron 설정
  */
 export interface SdElectronConfig {
-  /** Electron app ID (e.g., "com.example.myapp") */
+  /** Electron 앱 ID (예: "com.example.myapp") */
   appId: string;
-  /** portable .exe (true) or NSIS installer (false/unspecified) */
+  /** 포터블 .exe (true) 또는 NSIS 설치 프로그램 (false/미지정) */
   portable?: boolean;
-  /** installer icon path (.ico, relative path based on package directory) */
+  /** 설치 프로그램 아이콘 경로 (.ico, 패키지 디렉토리 기준 상대 경로) */
   installerIcon?: string;
-  /** npm packages to include in Electron (native modules, etc.) */
+  /** Electron에 포함할 npm 패키지 (네이티브 모듈 등) */
   reinstallDependencies?: string[];
-  /** npm postinstall script */
+  /** npm postinstall 스크립트 */
   postInstallScript?: string;
-  /** NSIS options (when portable is false) */
+  /** NSIS 옵션 (portable이 false일 때) */
   nsisOptions?: Record<string, unknown>;
-  /** environment variables (accessible via process.env in electron-main.ts) */
+  /** 환경 변수 (electron-main.ts에서 process.env로 접근 가능) */
   env?: Record<string, string>;
 }
 
-//#region PWA configuration types
+//#region PWA 설정 타입
 
 /**
- * PWA manifest configuration (subset of VitePWA manifest options)
+ * PWA manifest 설정 (VitePWA manifest 옵션의 서브셋)
  */
 export interface SdPwaManifestConfig {
   name?: string;
@@ -181,14 +181,14 @@ export interface SdPwaManifestConfig {
 }
 
 /**
- * PWA workbox configuration
+ * PWA workbox 설정
  */
 export interface SdPwaWorkboxConfig {
   globPatterns?: string[];
 }
 
 /**
- * PWA configuration
+ * PWA 설정
  */
 export interface SdPwaConfig {
   manifest?: SdPwaManifestConfig;
@@ -198,98 +198,98 @@ export interface SdPwaConfig {
 //#endregion
 
 /**
- * Browser support configuration for client packages
+ * 클라이언트 패키지용 브라우저 지원 설정
  */
 export interface SdBrowserSupportConfig {
-  /** browserslist query (e.g., "last 2 Chrome versions" or ["ie 11", "last 2 versions"]) */
+  /** browserslist 쿼리 (예: "last 2 Chrome versions" 또는 ["ie 11", "last 2 versions"]) */
   browserslist?: string | string[];
-  /** PostCSS plugins configuration */
+  /** PostCSS 플러그인 설정 */
   postCss?: { plugins: unknown[] };
-  /** legacy module support (disables code splitting + replaces import.meta) */
+  /** 레거시 모듈 지원 (코드 분할 비활성화 + import.meta 치환) */
   legacyModule?: boolean;
 }
 
 /**
- * Client package configuration (Vite development server)
+ * 클라이언트 패키지 설정 (Vite 개발 서버)
  */
 export interface SdClientPackageConfig {
-  /** build target */
+  /** 빌드 타겟 */
   target: "client";
   /**
-   * server configuration
-   * - string: server package name to connect to (e.g., "solid-demo-server")
-   * - number: use Vite port directly (backward compatibility)
+   * 서버 설정
+   * - string: 연결할 서버 패키지명 (예: "solid-demo-server")
+   * - number: Vite 포트 직접 지정 (하위 호환)
    */
   server: string | number;
-  /** environment variables to substitute during build (replace process.env with object) */
+  /** 빌드 시 치환할 환경 변수 (process.env를 객체로 치환) */
   env?: Record<string, string>;
-  /** publish configuration */
+  /** 배포 설정 */
   publish?: SdPublishConfig;
-  /** Capacitor configuration */
+  /** Capacitor 설정 */
   capacitor?: SdCapacitorConfig;
-  /** Electron configuration */
+  /** Electron 설정 */
   electron?: SdElectronConfig;
-  /** runtime config (written to dist/.config.json during build) */
+  /** 런타임 설정 (빌드 시 dist/.config.json으로 기록) */
   configs?: Record<string, unknown>;
-  /** packages to exclude from Vite optimizeDeps and add to Capacitor/Electron package.json */
+  /** Vite optimizeDeps에서 제외하고 Capacitor/Electron package.json에 추가할 패키지 */
   exclude?: string[];
-  /** browser support configuration (browserslist, PostCSS, legacyModule) */
+  /** 브라우저 지원 설정 (browserslist, PostCSS, legacyModule) */
   browserSupport?: SdBrowserSupportConfig;
-  /** PWA configuration. false to disable. Enabled with defaults when not specified */
+  /** PWA 설정. false이면 비활성화. 미지정 시 기본값으로 활성화 */
   pwa?: false | SdPwaConfig;
 }
 
 /**
- * Server package configuration (Fastify server)
+ * 서버 패키지 설정 (Fastify 서버)
  */
 export interface SdServerPackageConfig {
-  /** build target */
+  /** 빌드 타겟 */
   target: "server";
-  /** environment variables to substitute during build (replace process.env.KEY with constant) */
+  /** 빌드 시 치환할 환경 변수 (process.env.KEY를 상수로 치환) */
   env?: Record<string, string>;
-  /** publish configuration */
+  /** 배포 설정 */
   publish?: SdPublishConfig;
-  /** runtime config (written to dist/.config.json during build) */
+  /** 런타임 설정 (빌드 시 dist/.config.json으로 기록) */
   configs?: Record<string, unknown>;
-  /** external modules not to include in esbuild bundle (in addition to automatic binding.gyp detection) */
+  /** esbuild 번들에 포함하지 않을 외부 모듈 (자동 binding.gyp 감지에 추가) */
   externals?: string[];
-  /** PM2 configuration (generates dist/pm2.config.cjs when specified) */
+  /** PM2 설정 (지정 시 dist/pm2.config.cjs 생성) */
   pm2?: {
-    /** PM2 process name (generated from package.json name if unspecified) */
+    /** PM2 프로세스 이름 (미지정 시 package.json name에서 생성) */
     name?: string;
-    /** paths to exclude from PM2 watch */
+    /** PM2 watch에서 제외할 경로 */
     ignoreWatchPaths?: string[];
   };
-  /** Package manager to use (affects mise.toml or volta settings generation) */
+  /** 사용할 패키지 매니저 (mise.toml 또는 volta 설정 생성에 영향) */
   packageManager?: "volta" | "mise";
 }
 
 /**
- * Watch hook configuration for scripts packages
+ * scripts 패키지용 watch 훅 설정
  */
 export interface SdWatchHookConfig {
-  /** glob patterns to watch (relative to package directory) */
+  /** 감시할 glob 패턴 (패키지 디렉토리 기준 상대 경로) */
   target: string[];
-  /** command to execute on change */
+  /** 변경 시 실행할 명령어 */
   cmd: string;
-  /** command arguments */
+  /** 명령어 인수 */
   args?: string[];
 }
 
 /**
- * Scripts-only package configuration (excluded from watch/typecheck unless watch hook is configured)
+ * 스크립트 전용 패키지 설정 (watch 훅이 설정되지 않으면 watch/typecheck에서 제외)
  */
 export interface SdScriptsPackageConfig {
-  /** build target */
+  /** 빌드 타겟 */
   target: "scripts";
-  /** publish configuration */
+  /** 배포 설정 */
   publish?: SdPublishConfig;
-  /** watch hook configuration (when set, package is included in watch mode) */
+  /** watch 훅 설정 (설정 시, watch 모드에 패키지가 포함됨) */
   watch?: SdWatchHookConfig;
 }
 
 /**
- * Package configuration
+ * 패키지 설정
  */
 export type SdPackageConfig =
   | SdBuildPackageConfig
@@ -298,36 +298,36 @@ export type SdPackageConfig =
   | SdScriptsPackageConfig;
 
 /**
- * sd.config.ts configuration type
+ * sd.config.ts 설정 타입
  */
 export interface SdConfig {
-  /** per-package configuration (key: subdirectory name under packages/, e.g., "core-common") */
+  /** 패키지별 설정 (key: packages/ 하위 디렉토리명, 예: "core-common") */
   packages: Record<string, SdPackageConfig | undefined>;
   /**
-   * dependency replacement configuration (replace node_modules packages with local sources via symlink)
-   * - key: package glob pattern to find in node_modules (e.g., "@simplysm/*")
-   * - value: source directory path (captured values from key's * are substituted into value's *)
-   * - example: { "@simplysm/*": "../simplysm/packages/*" }
+   * 의존성 교체 설정 (node_modules 패키지를 로컬 소스로 심링크 교체)
+   * - key: node_modules에서 찾을 패키지 glob 패턴 (예: "@simplysm/*")
+   * - value: 소스 디렉토리 경로 (key의 *에서 캡처된 값이 value의 *에 치환됨)
+   * - 예시: { "@simplysm/*": "../simplysm/packages/*" }
    */
   replaceDeps?: Record<string, string>;
-  /** script to execute after deployment completes */
+  /** 배포 완료 후 실행할 스크립트 */
   postPublish?: SdPostPublishScriptConfig[];
 }
 
 /**
- * parameters passed to sd.config.ts function
+ * sd.config.ts 함수에 전달되는 매개변수
  */
 export interface SdConfigParams {
-  /** current working directory */
+  /** 현재 작업 디렉토리 */
   cwd: string;
-  /** development mode flag */
+  /** 개발 모드 플래그 */
   dev: boolean;
-  /** additional options (from CLI's -o flag) */
+  /** 추가 옵션 (CLI의 -o 플래그에서 전달) */
   options: string[];
 }
 
 /**
- * sd.config.ts must default export a function of the following form:
+ * sd.config.ts는 반드시 다음 형식의 함수를 default export해야 한다:
  *
  * ```typescript
  * import type { SdConfig, SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";

package/src/utils/angular-compiler.ts

@@ -242,7 +242,7 @@ export class AngularCompiler {
       if (options.externalStylesheets == null || hasTemplateExtension(resolvedPath)) {
         return resolvedPath;
       }
-      // stylesheet with externalStylesheets (client mode)
+      // externalStylesheets를 사용한 스타일시트 처리 (클라이언트 모드)
       let externalId = options.externalStylesheets.get(resolvedPath);
       if (externalId === undefined) {
         externalId = createHash("sha256").update(resolvedPath).digest("hex");
@@ -331,7 +331,7 @@ export class AngularCompiler {
       }
     }
 
-    // 11. findAffectedFiles + 12. 리소스 의존성 기반 diagnosticCache 무효화
+    // 11. findAffectedFiles (내부에서 리소스 의존성 기반 diagnosticCache 무효화도 수행)
     const affectedFiles = this._findAffectedFiles(
       builderProgram,
       angularProgram.compiler,
@@ -378,10 +378,10 @@ export class AngularCompiler {
         break;
       }
       if ("fileName" in result.affected) {
-        // ts.SourceFile — single file change
+        // ts.SourceFile — 단일 파일 변경
         affectedFiles.add(result.affected);
       } else {
-        // ts.Program — global scope change, treat all source files as affected
+        // ts.Program — 전역 스코프 변경, 모든 소스 파일을 affected로 처리
         for (const sourceFile of builderProgram.getSourceFiles()) {
           if (!angularCompiler.ignoreForDiagnostics.has(sourceFile)) {
             affectedFiles.add(sourceFile);
@@ -557,7 +557,7 @@ export class AngularCompiler {
     yield* ngOptionDiags;
     yield* tsOptionDiags;
 
-    // 2. Syntactic
+    // 2. Global
     yield* builderProgram.getGlobalDiagnostics();
 
     // 3. 파일별 루프

package/src/utils/build-env.ts

@@ -3,7 +3,7 @@ import fs from "fs/promises";
 import { pathx } from "@simplysm/core-node";
 
 /**
- * Get version from root package.json
+ * 루트 package.json에서 버전을 가져온다.
  */
 export async function getVersion(cwd: string): Promise<string> {
   const pkgJsonPath = pathx.posix(path.join(cwd, "package.json"));

package/src/utils/concurrency.ts

@@ -1,12 +1,12 @@
 import os from "os";
 
 /**
- * Run task functions with limited concurrency.
- * Uses a shared index pattern — each worker consumes the next available task.
+ * 제한된 동시성으로 태스크 함수를 실행한다.
+ * 공유 인덱스 패턴을 사용 — 각 워커가 다음 사용 가능한 태스크를 소비한다.
  *
- * @param tasks Array of async task functions to execute
- * @param concurrency Maximum number of tasks running simultaneously
- * @returns Array of PromiseSettledResult in the same order as input tasks
+ * @param tasks 실행할 비동기 태스크 함수 배열
+ * @param concurrency 동시에 실행할 최대 태스크 수
+ * @returns 입력 태스크와 동일한 순서의 PromiseSettledResult 배열
  */
 export async function runWithConcurrency<T>(
   tasks: Array<() => Promise<T>>,
@@ -35,8 +35,8 @@ export async function runWithConcurrency<T>(
 }
 
 /**
- * Get max concurrency based on CPU cores.
- * Uses 7/8 of available cores (minimum 1).
+ * CPU 코어 수 기반으로 최대 동시성을 반환한다.
+ * 사용 가능한 코어의 7/8을 사용한다 (최소 1).
  */
 export function getMaxConcurrency(): number {
   return Math.max(Math.floor((os.cpus().length * 7) / 8), 1);

package/src/utils/copy-public.ts

@@ -6,17 +6,17 @@ import {
 } from "@simplysm/core-node";
 
 /**
- * Copy files from public/ and public-dev/ directories to dist/.
- * public-dev/ takes priority over public/ (overlay).
+ * public/ 및 public-dev/ 디렉토리의 파일을 dist/로 복사한다.
+ * public-dev/가 public/보다 우선한다 (오버레이).
  *
- * @param pkgDir Package root directory
- * @param includeDev Whether to include public-dev/ (true only in dev mode)
+ * @param pkgDir 패키지 루트 디렉토리
+ * @param includeDev public-dev/ 포함 여부 (dev 모드에서만 true)
  */
 export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Promise<void> {
   const distDir = pathx.posix(path.join(pkgDir, "dist"));
   await fsx.mkdir(distDir);
 
-  // Copy public/
+  // public/ 복사
   const publicDir = pathx.posix(path.join(pkgDir, "public"));
   if (await fsx.exists(publicDir)) {
     const files = await fsx.glob("**/*", { cwd: publicDir, absolute: true });
@@ -30,7 +30,7 @@ export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Prom
     );
   }
 
-  // Copy public-dev/ (overlay: overwrites public/)
+  // public-dev/ 복사 (오버레이: public/ 덮어쓰기)
   if (includeDev) {
     const publicDevDir = pathx.posix(path.join(pkgDir, "public-dev"));
     if (await fsx.exists(publicDevDir)) {
@@ -48,12 +48,12 @@ export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Prom
 }
 
 /**
- * Watch public/ and public-dev/ directories and copy files to dist/ in real-time.
- * Automatically reflects changes/additions/deletions after initial copy.
+ * public/ 및 public-dev/ 디렉토리를 감시하고 변경사항을 실시간으로 dist/에 복사한다.
+ * 초기 복사 후 변경/추가/삭제를 자동으로 반영한다.
  *
- * @param pkgDir Package root directory
- * @param includeDev Whether to include public-dev/ (true only in dev mode)
- * @returns FsWatcher instance (must call close() on shutdown) or undefined if no watch targets
+ * @param pkgDir 패키지 루트 디렉토리
+ * @param includeDev public-dev/ 포함 여부 (dev 모드에서만 true)
+ * @returns FsWatcher 인스턴스 (종료 시 close() 호출 필요) 또는 감시 대상이 없으면 undefined
  */
 export async function watchPublicFiles(
   pkgDir: string,
@@ -63,10 +63,10 @@ export async function watchPublicFiles(
   const publicDir = pathx.posix(path.join(pkgDir, "public"));
   const publicDevDir = pathx.posix(path.join(pkgDir, "public-dev"));
 
-  // Initial copy
+  // 초기 복사
   await copyPublicFiles(pkgDir, includeDev);
 
-  // Collect watch target paths
+  // 감시 대상 경로 수집
   const watchPaths: string[] = [];
   if (await fsx.exists(publicDir)) {
     watchPaths.push(pathx.posix(path.join(publicDir, "**/*")));
@@ -83,7 +83,7 @@ export async function watchPublicFiles(
 
   watcher.onChange({ delay: 300 }, async (changes) => {
     for (const { event, path: filePath } of changes) {
-      // Determine which source directory the change came from
+      // 변경이 발생한 소스 디렉토리 결정
       let sourceDir: string;
       if (pathx.isChildPath(filePath, publicDevDir)) {
         sourceDir = publicDevDir;
@@ -95,14 +95,14 @@ export async function watchPublicFiles(
       const distPath = pathx.posix(path.join(distDir, relPath));
 
       if (event === "unlink") {
-        // If deleted from public, don't delete if same file exists in public-dev
+        // public에서 삭제된 경우, public-dev에 같은 파일이 있으면 삭제하지 않음
         if (sourceDir === publicDir && includeDev) {
           const devOverride = pathx.posix(path.join(publicDevDir, relPath));
           if (await fsx.exists(devOverride)) {
             continue;
           }
         }
-        // If deleted from public-dev, restore from public if it exists (fallback restore)
+        // public-dev에서 삭제된 경우, public에 파일이 있으면 복원 (폴백 복원)
         if (sourceDir === publicDevDir && includeDev) {
           const publicFallback = pathx.posix(path.join(publicDir, relPath));
           if (await fsx.exists(publicFallback)) {
@@ -113,7 +113,7 @@ export async function watchPublicFiles(
         }
         await fsx.rm(distPath);
       } else if (event === "add" || event === "change") {
-        // If changed in public, skip if same file exists in public-dev (overlay takes priority)
+        // public에서 변경된 경우, public-dev에 같은 파일이 있으면 스킵 (오버레이 우선)
         if (sourceDir === publicDir && includeDev) {
           const devOverride = pathx.posix(path.join(publicDevDir, relPath));
           if (await fsx.exists(devOverride)) {