@simplysm/sd-cli 13.0.68 → 13.0.70

package/src/sd-config.types.ts

@@ -1,32 +1,32 @@
 /**
- * 빌드 타겟 유형 (esbuild로 빌드)
- * - node: Node.js 전용 패키지
- * - browser: 브라우저 전용 패키지
- * - neutral: Node/브라우저 공용 패키지
+ * Build target type (built with esbuild)
+ * - node: Node.js only package
+ * - browser: browser only package
+ * - neutral: Node/browser shared package
  */
 export type BuildTarget = "node" | "browser" | "neutral";
 
-//#region Publish 설정 타입
+//#region Publish configuration types
 
 /**
- * 패키지 publish 설정
- * - "npm": npm 레지스트리에 배포
- * - SdLocalDirectoryPublishConfig: 로컬 디렉토리에 복사
- * - SdStoragePublishConfig: FTP/FTPS/SFTP 서버에 업로드
+ * Package publish configuration
+ * - "npm": deploy to npm registry
+ * - SdLocalDirectoryPublishConfig: copy to local directory
+ * - SdStoragePublishConfig: upload to FTP/FTPS/SFTP server
  */
 export type SdPublishConfig = "npm" | SdLocalDirectoryPublishConfig | SdStoragePublishConfig;
 
 /**
- * 로컬 디렉토리 publish 설정
+ * Local directory publish configuration
  */
 export interface SdLocalDirectoryPublishConfig {
   type: "local-directory";
-  /** 배포 대상 경로 (환경변수 치환 지원: %VER%, %PROJECT%) */
+  /** deployment target path (supports environment variable substitution: %VER%, %PROJECT%) */
   path: string;
 }
 
 /**
- * 스토리지 (FTP/FTPS/SFTP) publish 설정
+ * Storage (FTP/FTPS/SFTP) publish configuration
  */
 export interface SdStoragePublishConfig {
   type: "ftp" | "ftps" | "sftp";
@@ -38,168 +38,168 @@ export interface SdStoragePublishConfig {
 }
 
 /**
- * postPublish 스크립트 설정
+ * postPublish script configuration
  */
 export interface SdPostPublishScriptConfig {
   type: "script";
   cmd: string;
-  /** 스크립트 인자 (환경변수 치환 지원: %VER%, %PROJECT%) */
+  /** script arguments (supports environment variable substitution: %VER%, %PROJECT%) */
   args: string[];
 }
 
 //#endregion
 
 /**
- * 패키지 설정 (node/browser/neutral)
+ * Package configuration (node/browser/neutral)
  */
 export interface SdBuildPackageConfig {
-  /** 빌드 타겟 */
+  /** build target */
   target: BuildTarget;
-  /** publish 설정 */
+  /** publish configuration */
   publish?: SdPublishConfig;
-  /** src/에서 dist/로 복사할 파일 glob 패턴 (src/ 기준 상대 경로) */
+  /** glob patterns for files to copy from src/ to dist/ (relative path based on src/) */
   copySrc?: string[];
 }
 
 /**
- * Capacitor Android 서명 설정
+ * Capacitor Android sign configuration
  */
 export interface SdCapacitorSignConfig {
-  /** keystore 파일 경로 (패키지 디렉토리 기준 상대경로) */
+  /** keystore file path (relative path based on package directory) */
   keystore: string;
-  /** keystore 비밀번호 */
+  /** keystore password */
   storePassword: string;
-  /** 키 별칭 */
+  /** key alias */
   alias: string;
-  /** 키 비밀번호 */
+  /** key password */
   password: string;
-  /** keystore 타입 (기본값: "jks") */
+  /** keystore type (default: "jks") */
   keystoreType?: string;
 }
 
 /**
- * Capacitor Android 권한 설정
+ * Capacitor Android permission configuration
  */
 export interface SdCapacitorPermission {
-  /** 권한 이름 (예: "CAMERA", "WRITE_EXTERNAL_STORAGE") */
+  /** permission name (e.g., "CAMERA", "WRITE_EXTERNAL_STORAGE") */
   name: string;
-  /** 최대 SDK 버전 */
+  /** maximum SDK version */
   maxSdkVersion?: number;
-  /** tools:ignore 속성 값 */
+  /** tools:ignore attribute value */
   ignore?: string;
 }
 
 /**
- * Capacitor Android Intent Filter 설정
+ * Capacitor Android Intent Filter configuration
  */
 export interface SdCapacitorIntentFilter {
-  /** intent action (예: "android.intent.action.VIEW") */
+  /** intent action (e.g., "android.intent.action.VIEW") */
   action?: string;
-  /** intent category (예: "android.intent.category.DEFAULT") */
+  /** intent category (e.g., "android.intent.category.DEFAULT") */
   category?: string;
 }
 
 /**
- * Capacitor Android 플랫폼 설정
+ * Capacitor Android platform configuration
  */
 export interface SdCapacitorAndroidConfig {
-  /** AndroidManifest.xml application 태그 속성 (예: { requestLegacyExternalStorage: "true" }) */
+  /** AndroidManifest.xml application tag attributes (e.g., { requestLegacyExternalStorage: "true" }) */
   config?: Record<string, string>;
-  /** AAB 번들 빌드 여부 (false면 APK) */
+  /** AAB bundle build flag (false for APK) */
   bundle?: boolean;
-  /** Intent Filter 설정 */
+  /** Intent Filter configuration */
   intentFilters?: SdCapacitorIntentFilter[];
-  /** APK/AAB 서명 설정 */
+  /** APK/AAB signing configuration */
   sign?: SdCapacitorSignConfig;
-  /** Android SDK 버전 (minSdk, targetSdk) */
+  /** Android SDK version (minSdk, targetSdk) */
   sdkVersion?: number;
-  /** 추가 권한 설정 */
+  /** additional permission configuration */
   permissions?: SdCapacitorPermission[];
 }
 
 /**
- * Capacitor 설정
+ * Capacitor configuration
  */
 export interface SdCapacitorConfig {
-  /** 앱 ID (예: "com.example.app") */
+  /** app ID (e.g., "com.example.app") */
   appId: string;
-  /** 앱 이름 */
+  /** app name */
   appName: string;
-  /** Capacitor 플러그인 설정 (키: 패키지명, 값: true 또는 플러그인 옵션) */
+  /** Capacitor plugin configuration (key: package name, value: true or plugin options) */
   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 설정
+ * Electron configuration
  */
 export interface SdElectronConfig {
-  /** Electron 앱 ID (예: "com.example.myapp") */
+  /** Electron app ID (e.g., "com.example.myapp") */
   appId: string;
-  /** portable .exe (true) 또는 NSIS 인스톨러 (false/미지정) */
+  /** portable .exe (true) or NSIS installer (false/unspecified) */
   portable?: boolean;
-  /** 인스톨러 아이콘 경로 (.ico, 패키지 디렉토리 기준 상대경로) */
+  /** installer icon path (.ico, relative path based on package directory) */
   installerIcon?: string;
-  /** Electron에 포함할 npm 패키지 (native 모듈 등) */
+  /** npm packages to include in Electron (native modules, etc.) */
   reinstallDependencies?: string[];
-  /** npm postinstall 스크립트 */
+  /** npm postinstall script */
   postInstallScript?: string;
-  /** NSIS 옵션 (portable이 아닌 경우) */
+  /** NSIS options (when portable is false) */
   nsisOptions?: Record<string, unknown>;
-  /** 환경변수 (electron-main.ts에서 process.env로 접근) */
+  /** environment variables (accessible via process.env in electron-main.ts) */
   env?: Record<string, string>;
 }
 
 /**
- * 클라이언트 패키지 설정 (Vite 개발 서버)
+ * Client package configuration (Vite development server)
  */
 export interface SdClientPackageConfig {
-  /** 빌드 타겟 */
+  /** build target */
   target: "client";
   /**
-   * 서버 설정
-   * - string: 연결할 서버 패키지명 (예: "solid-demo-server")
-   * - number: Vite 직접 포트 사용 (하위 호환성)
+   * server configuration
+   * - string: server package name to connect to (e.g., "solid-demo-server")
+   * - number: use Vite port directly (backward compatibility)
    */
   server: string | number;
-  /** 빌드 시 치환할 환경변수 (process.env를 객체로 치환) */
+  /** environment variables to substitute during build (replace process.env with object) */
   env?: Record<string, string>;
-  /** publish 설정 */
+  /** publish configuration */
   publish?: SdPublishConfig;
-  /** Capacitor 설정 */
+  /** Capacitor configuration */
   capacitor?: SdCapacitorConfig;
-  /** Electron 설정 */
+  /** Electron configuration */
   electron?: SdElectronConfig;
   /** runtime config (written to dist/.config.json during build) */
   configs?: Record<string, unknown>;
 }
 
 /**
- * 서버 패키지 설정 (Fastify 서버)
+ * Server package configuration (Fastify server)
  */
 export interface SdServerPackageConfig {
-  /** 빌드 타겟 */
+  /** build target */
   target: "server";
-  /** 빌드 시 치환할 환경변수 (process.env.KEY를 상수로 치환) */
+  /** environment variables to substitute during build (replace process.env.KEY with constant) */
   env?: Record<string, string>;
-  /** publish 설정 */
+  /** publish configuration */
   publish?: SdPublishConfig;
   /** runtime config (written to dist/.config.json during build) */
   configs?: Record<string, unknown>;
-  /** esbuild에서 번들에 포함하지 않을 외부 모듈 (binding.gyp 자동 감지에 더해 수동 지정) */
+  /** external modules not to include in esbuild bundle (in addition to automatic binding.gyp detection) */
   externals?: string[];
-  /** PM2 설정 (지정 시 dist/pm2.config.cjs 생성) */
+  /** PM2 configuration (generates dist/pm2.config.cjs when specified) */
   pm2?: {
-    /** PM2 프로세스 이름 (미지정 시 package.json name에서 생성) */
+    /** PM2 process name (generated from package.json name if unspecified) */
     name?: string;
-    /** PM2 watch에서 제외할 경로 */
+    /** paths to exclude from PM2 watch */
     ignoreWatchPaths?: string[];
   };
   /** Package manager to use (affects mise.toml or volta settings generation) */
@@ -207,15 +207,15 @@ export interface SdServerPackageConfig {
 }
 
 /**
- * 스크립트 전용 패키지 설정 (watch/typecheck 제외)
+ * Scripts-only package configuration (excluded from watch/typecheck)
  */
 export interface SdScriptsPackageConfig {
-  /** 빌드 타겟 */
+  /** build target */
   target: "scripts";
 }
 
 /**
- * 패키지 설정
+ * Package configuration
  */
 export type SdPackageConfig =
   | SdBuildPackageConfig
@@ -224,36 +224,36 @@ export type SdPackageConfig =
   | SdScriptsPackageConfig;
 
 /**
- * sd.config.ts 설정 타입
+ * sd.config.ts configuration type
  */
 export interface SdConfig {
-  /** 패키지별 설정 (키: packages/ 하위 디렉토리 이름, 예: "core-common") */
+  /** per-package configuration (key: subdirectory name under packages/, e.g., "core-common") */
   packages: Record<string, SdPackageConfig | undefined>;
   /**
-   * 의존성 교체 설정 (node_modules 패키지를 로컬 소스로 symlink 교체)
-   * - 키: node_modules에서 찾을 패키지 glob 패턴 (예: "@simplysm/*")
-   * - 값: 소스 디렉토리 경로 (키의 * 캡처값이 값의 *에 치환됨)
-   * - 예: { "@simplysm/*": "../simplysm/packages/*" }
+   * 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/*" }
    */
   replaceDeps?: Record<string, string>;
-  /** 배포 완료 후 실행할 스크립트 */
+  /** script to execute after deployment completes */
   postPublish?: SdPostPublishScriptConfig[];
 }
 
 /**
- * sd.config.ts 함수에 전달되는 파라미터
+ * parameters passed to sd.config.ts function
  */
 export interface SdConfigParams {
-  /** 현재 작업 디렉토리 */
+  /** current working directory */
   cwd: string;
-  /** 개발 모드 여부 */
+  /** development mode flag */
   dev: boolean;
-  /** 추가 옵션 (CLI의 -o 플래그) */
+  /** additional options (from CLI's -o flag) */
   opt: string[];
 }
 
 /**
- * sd.config.ts는 다음과 같은 형태의 함수를 default export해야 한다:
+ * sd.config.ts must default export a function of the following form:
  *
  * ```typescript
  * import type { SdConfig, SdConfigFn, SdConfigParams } from "@simplysm/sd-cli";

package/src/utils/build-env.ts

@@ -2,7 +2,7 @@ import path from "path";
 import fs from "fs/promises";
 
 /**
- * 루트 package.json에서 version 가져오기
+ * Get version from root package.json
  */
 export async function getVersion(cwd: string): Promise<string> {
   const pkgJsonPath = path.join(cwd, "package.json");

package/src/utils/config-editor.ts

@@ -1,9 +1,9 @@
 import { Project, SyntaxKind, type ObjectLiteralExpression } from "ts-morph";
 
 /**
- * sd.config.ts에서 packages 객체 리터럴을 찾는다.
+ * Find packages object literal in sd.config.ts
  *
- * 구조: const config: SdConfigFn = () => ({ packages: { ... } });
+ * Structure: const config: SdConfigFn = () => ({ packages: { ... } });
  * -> ArrowFunction -> ParenthesizedExpression -> ObjectLiteral -> "packages" property -> ObjectLiteral
  */
 function findPackagesObject(configPath: string): {
@@ -13,11 +13,11 @@ function findPackagesObject(configPath: string): {
   const project = new Project();
   const sourceFile = project.addSourceFileAtPath(configPath);
 
-  // "config" 변수 선언 찾기
+  // Find "config" variable declaration
   const configVar = sourceFile.getVariableDeclarationOrThrow("config");
   const arrowFn = configVar.getInitializerIfKindOrThrow(SyntaxKind.ArrowFunction);
 
-  // 화살표 함수 본문에서 반환 객체 찾기
+  // Find return object in arrow function body
   const body = arrowFn.getBody();
   let returnObj: ObjectLiteralExpression;
 
@@ -27,10 +27,10 @@ function findPackagesObject(configPath: string): {
     const returnStmt = body.getFirstDescendantByKindOrThrow(SyntaxKind.ReturnStatement);
     returnObj = returnStmt.getExpressionIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
   } else {
-    throw new Error("sd.config.ts의 구조를 인식할 수 없습니다.");
+    throw new Error("Unable to recognize structure of sd.config.ts");
   }
 
-  // "packages" 프로퍼티 찾기
+  // Find "packages" property
   const packagesProp = returnObj
     .getPropertyOrThrow("packages")
     .asKindOrThrow(SyntaxKind.PropertyAssignment);
@@ -40,9 +40,9 @@ function findPackagesObject(configPath: string): {
 }
 
 /**
- * sd.config.ts의 packages 객체에 새 패키지 항목을 추가한다.
+ * Add new package entry to packages object in sd.config.ts
  *
- * @returns true: 성공, false: 이미 존재
+ * @returns true: success, false: already exists
  */
 export function addPackageToSdConfig(
   configPath: string,
@@ -51,14 +51,14 @@ export function addPackageToSdConfig(
 ): boolean {
   const { project, packagesObj } = findPackagesObject(configPath);
 
-  // 이미 존재하는지 확인 (따옴표 있는 형태와 없는 형태 모두 체크)
+  // Check if already exists (check both quoted and unquoted forms)
   const existing =
     packagesObj.getProperty(`"${packageName}"`) ?? packagesObj.getProperty(packageName);
   if (existing) {
     return false;
   }
 
-  // 새 프로퍼티 추가 -- config 객체를 ts-morph initializer 문자열로 변환
+  // Add new property -- convert config object to ts-morph initializer string
   const configStr = JSON.stringify(config)
     .replace(/"([^"]+)":/g, "$1: ")
     .replace(/"/g, '"');
@@ -73,7 +73,7 @@ export function addPackageToSdConfig(
 }
 
 /**
- * sd.config.ts에서 특정 클라이언트의 server 필드를 설정한다.
+ * Set server field for specific client in sd.config.ts
  */
 export function setClientServerInSdConfig(
   configPath: string,
@@ -85,19 +85,19 @@ export function setClientServerInSdConfig(
   const clientPropNode =
     packagesObj.getProperty(`"${clientName}"`) ?? packagesObj.getProperty(clientName);
   if (clientPropNode == null) {
-    throw new Error(`클라이언트 "${clientName}"을(를) sd.config.ts에서 찾을 수 없습니다.`);
+    throw new Error(`Client "${clientName}" not found in sd.config.ts`);
   }
 
   const clientProp = clientPropNode.asKindOrThrow(SyntaxKind.PropertyAssignment);
   const clientObj = clientProp.getInitializerIfKindOrThrow(SyntaxKind.ObjectLiteralExpression);
 
-  // 기존 server 프로퍼티가 있으면 제거
+  // Remove existing server property if present
   const serverProp = clientObj.getProperty("server");
   if (serverProp) {
     serverProp.remove();
   }
 
-  // server 프로퍼티 추가
+  // Add server property
   clientObj.addPropertyAssignment({
     name: "server",
     initializer: `"${serverName}"`,
@@ -107,26 +107,26 @@ export function setClientServerInSdConfig(
 }
 
 /**
- * eslint.config.ts에 tailwindcss 설정 블록을 추가한다.
+ * Add tailwindcss config block to eslint.config.ts
  *
- * @returns true: 추가됨, false: 이미 존재
+ * @returns true: added, false: already exists
  */
 export function addTailwindToEslintConfig(configPath: string, clientName: string): boolean {
   const project = new Project();
   const sourceFile = project.addSourceFileAtPath(configPath);
 
-  // default export 배열 찾기
+  // Find default export array
   const defaultExport = sourceFile.getFirstDescendantByKindOrThrow(
     SyntaxKind.ArrayLiteralExpression,
   );
 
-  // tailwindcss 설정이 이미 있는지 확인
+  // Check if tailwindcss config already exists
   const text = defaultExport.getText();
   if (text.includes("tailwindcss")) {
     return false;
   }
 
-  // 새 설정 객체 추가
+  // Add new config object
   defaultExport.addElement(`{
     files: ["**/*.{ts,tsx}"],
     settings: {

package/src/utils/copy-public.ts

@@ -10,17 +10,17 @@ import {
 } from "@simplysm/core-node";
 
 /**
- * public/ 및 public-dev/ 디렉토리의 파일을 dist/로 복사한다.
- * public-dev/가 public/보다 우선한다 (overlay).
+ * Copy files from public/ and public-dev/ directories to dist/.
+ * public-dev/ takes priority over public/ (overlay).
  *
- * @param pkgDir 패키지 루트 디렉토리
- * @param includeDev public-dev/ 포함 여부 (dev 모드에서만 true)
+ * @param pkgDir Package root directory
+ * @param includeDev Whether to include public-dev/ (true only in dev mode)
  */
 export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Promise<void> {
   const distDir = path.join(pkgDir, "dist");
   await fsMkdir(distDir);
 
-  // public/ 복사
+  // Copy public/
   const publicDir = path.join(pkgDir, "public");
   if (await fsExists(publicDir)) {
     const files = await fsGlob("**/*", { cwd: publicDir, absolute: true });
@@ -32,7 +32,7 @@ export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Prom
     }
   }
 
-  // public-dev/ 복사 (overlay: public/ 위에 덮어씀)
+  // Copy public-dev/ (overlay: overwrites public/)
   if (includeDev) {
     const publicDevDir = path.join(pkgDir, "public-dev");
     if (await fsExists(publicDevDir)) {
@@ -48,12 +48,12 @@ export async function copyPublicFiles(pkgDir: string, includeDev: boolean): Prom
 }
 
 /**
- * public/ 및 public-dev/ 디렉토리를 감시하여 dist/로 실시간 복사한다.
- * 초기 복사 후 변경/추가/삭제를 자동 반영한다.
+ * Watch public/ and public-dev/ directories and copy files to dist/ in real-time.
+ * Automatically reflects changes/additions/deletions after initial copy.
  *
- * @param pkgDir 패키지 루트 디렉토리
- * @param includeDev public-dev/ 포함 여부 (dev 모드에서만 true)
- * @returns FsWatcher 인스턴스 (shutdown 시 close() 호출 필요) 또는 watch할 대상이 없으면 undefined
+ * @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
  */
 export async function watchPublicFiles(
   pkgDir: string,
@@ -63,10 +63,10 @@ export async function watchPublicFiles(
   const publicDir = path.join(pkgDir, "public");
   const publicDevDir = path.join(pkgDir, "public-dev");
 
-  // 초기 복사
+  // Initial copy
   await copyPublicFiles(pkgDir, includeDev);
 
-  // watch 대상 경로 수집
+  // Collect watch target paths
   const watchPaths: string[] = [];
   if (await fsExists(publicDir)) {
     watchPaths.push(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 (pathIsChildPath(filePath, publicDevDir)) {
         sourceDir = publicDevDir;
@@ -95,14 +95,14 @@ export async function watchPublicFiles(
       const distPath = path.join(distDir, relPath);
 
       if (event === "unlink") {
-        // public에서 삭제 시, public-dev에 같은 파일이 있으면 삭제하지 않음
+        // If deleted from public, don't delete if same file exists in public-dev
         if (sourceDir === publicDir && includeDev) {
           const devOverride = path.join(publicDevDir, relPath);
           if (await fsExists(devOverride)) {
             continue;
           }
         }
-        // public-dev에서 삭제 시, public에 같은 파일이 있으면 복사 (fallback 복원)
+        // If deleted from public-dev, restore from public if it exists (fallback restore)
         if (sourceDir === publicDevDir && includeDev) {
           const publicFallback = path.join(publicDir, relPath);
           if (await fsExists(publicFallback)) {
@@ -113,7 +113,7 @@ export async function watchPublicFiles(
         }
         await fsRm(distPath);
       } else if (event === "add" || event === "change") {
-        // public에서 변경 시, public-dev에 같은 파일이 있으면 overlay 우선이므로 스킵
+        // If changed in public, skip if same file exists in public-dev (overlay takes priority)
         if (sourceDir === publicDir && includeDev) {
           const devOverride = path.join(publicDevDir, relPath);
           if (await fsExists(devOverride)) {

package/src/utils/copy-src.ts

@@ -2,11 +2,11 @@ import path from "path";
 import { fsGlob, fsCopy, fsMkdir, fsRm, FsWatcher } from "@simplysm/core-node";
 
 /**
- * src/에서 glob 패턴에 매칭되는 파일을 dist/로 복사한다.
- * 상대 경로가 유지된다: src/a/b.css → dist/a/b.css
+ * Copy files matching glob patterns from src/ to dist/
+ * Relative paths are preserved: src/a/b.css → dist/a/b.css
  *
- * @param pkgDir 패키지 루트 디렉토리
- * @param patterns glob 패턴 배열 (src/ 기준 상대 경로)
+ * @param pkgDir Package root directory
+ * @param patterns Array of glob patterns (relative to src/)
  */
 export async function copySrcFiles(pkgDir: string, patterns: string[]): Promise<void> {
   const srcDir = path.join(pkgDir, "src");
@@ -24,21 +24,21 @@ export async function copySrcFiles(pkgDir: string, patterns: string[]): Promise<
 }
 
 /**
- * src/에서 glob 패턴에 매칭되는 파일을 감시하여 dist/로 복사한다.
- * 초기 복사 후 변경/추가/삭제를 자동 반영한다.
+ * Watch and copy files matching glob patterns from src/ to dist/
+ * Automatically reflects changes, additions, and deletions after initial copy.
  *
- * @param pkgDir 패키지 루트 디렉토리
- * @param patterns glob 패턴 배열 (src/ 기준 상대 경로)
- * @returns FsWatcher 인스턴스 (shutdown 시 close() 호출 필요)
+ * @param pkgDir Package root directory
+ * @param patterns Array of glob patterns (relative to src/)
+ * @returns FsWatcher instance (call close() on shutdown)
  */
 export async function watchCopySrcFiles(pkgDir: string, patterns: string[]): Promise<FsWatcher> {
   const srcDir = path.join(pkgDir, "src");
   const distDir = path.join(pkgDir, "dist");
 
-  // 초기 복사
+  // Initial copy
   await copySrcFiles(pkgDir, patterns);
 
-  // watch 시작
+  // Start watch
   const watchPaths = patterns.map((p) => path.join(srcDir, p));
   const watcher = await FsWatcher.watch(watchPaths);