@simplysm/core-node 13.0.69 → 13.0.70

package/dist/utils/fs.d.ts

@@ -2,196 +2,196 @@ import fs from "fs";
 import { type GlobOptions } from "glob";
 import "@simplysm/core-common";
 /**
- * 파일 또는 디렉토리 존재 확인 (동기).
- * @param targetPath - 확인할 경로
+ * Checks if a file or directory exists (synchronous).
+ * @param targetPath - Path to check
  */
 export declare function fsExistsSync(targetPath: string): boolean;
 /**
- * 파일 또는 디렉토리 존재 확인 (비동기).
- * @param targetPath - 확인할 경로
+ * Checks if a file or directory exists (asynchronous).
+ * @param targetPath - Path to check
  */
 export declare function fsExists(targetPath: string): Promise<boolean>;
 /**
- * 디렉토리 생성 (recursive).
- * @param targetPath - 생성할 디렉토리 경로
+ * Creates a directory (recursive).
+ * @param targetPath - Directory path to create
  */
 export declare function fsMkdirSync(targetPath: string): void;
 /**
- * 디렉토리 생성 (recursive, 비동기).
- * @param targetPath - 생성할 디렉토리 경로
+ * Creates a directory (recursive, asynchronous).
+ * @param targetPath - Directory path to create
  */
 export declare function fsMkdir(targetPath: string): Promise<void>;
 /**
- * 파일 또는 디렉토리 삭제.
- * @param targetPath - 삭제할 경로
- * @remarks 동기 버전은 재시도 없이 즉시 실패함. 파일 잠금 등 일시적 오류 가능성이 있는 경우 fsRm 사용을 권장함.
+ * Deletes a file or directory.
+ * @param targetPath - Path to delete
+ * @remarks The synchronous version fails immediately without retries. Use fsRm for cases with potential transient errors like file locks.
  */
 export declare function fsRmSync(targetPath: string): void;
 /**
- * 파일 또는 디렉토리 삭제 (비동기).
- * @param targetPath - 삭제할 경로
- * @remarks 비동기 버전은 파일 잠금 등의 일시적 오류에 대해 최대 6회(500ms 간격) 재시도함.
+ * Deletes a file or directory (asynchronous).
+ * @param targetPath - Path to delete
+ * @remarks The asynchronous version retries up to 6 times (500ms interval) for transient errors like file locks.
  */
 export declare function fsRm(targetPath: string): Promise<void>;
 /**
- * 파일 또는 디렉토리 복사.
+ * Copies a file or directory.
  *
- * sourcePath가 존재하지 않으면 아무 작업도 수행하지 않고 반환한다.
+ * If sourcePath does not exist, no action is performed and the function returns.
  *
- * @param sourcePath 복사할 원본 경로
- * @param targetPath 복사 대상 경로
- * @param filter 복사 여부를 결정하는 필터 함수.
- *               각 파일/디렉토리의 **절대 경로**가 전달되며,
- *               true를 반환하면 복사, false면 제외.
- *               **주의**: 최상위 sourcePath는 필터 대상이 아니며,
- *               모든 하위 항목(자식, 손자 등)에 재귀적으로 filter 함수가 적용된다.
- *               디렉토리에 false를 반환하면 해당 디렉토리와 모든 하위 항목이 건너뛰어짐.
+ * @param sourcePath Path of the source to copy
+ * @param targetPath Destination path for the copy
+ * @param filter A filter function that determines whether to copy.
+ *               The **absolute path** of each file/directory is passed.
+ *               Returns true to copy, false to exclude.
+ *               **Note**: The top-level sourcePath is not subject to filtering;
+ *               the filter function is applied recursively to all children (direct and indirect).
+ *               Returning false for a directory skips that directory and all its contents.
  */
 export declare function fsCopySync(sourcePath: string, targetPath: string, filter?: (absolutePath: string) => boolean): void;
 /**
- * 파일 또는 디렉토리 복사 (비동기).
+ * Copies a file or directory (asynchronous).
  *
- * sourcePath가 존재하지 않으면 아무 작업도 수행하지 않고 반환한다.
+ * If sourcePath does not exist, no action is performed and the function returns.
  *
- * @param sourcePath 복사할 원본 경로
- * @param targetPath 복사 대상 경로
- * @param filter 복사 여부를 결정하는 필터 함수.
- *               각 파일/디렉토리의 **절대 경로**가 전달되며,
- *               true를 반환하면 복사, false면 제외.
- *               **주의**: 최상위 sourcePath는 필터 대상이 아니며,
- *               모든 하위 항목(자식, 손자 등)에 재귀적으로 filter 함수가 적용된다.
- *               디렉토리에 false를 반환하면 해당 디렉토리와 모든 하위 항목이 건너뛰어짐.
+ * @param sourcePath Path of the source to copy
+ * @param targetPath Destination path for the copy
+ * @param filter A filter function that determines whether to copy.
+ *               The **absolute path** of each file/directory is passed.
+ *               Returns true to copy, false to exclude.
+ *               **Note**: The top-level sourcePath is not subject to filtering;
+ *               the filter function is applied recursively to all children (direct and indirect).
+ *               Returning false for a directory skips that directory and all its contents.
  */
 export declare function fsCopy(sourcePath: string, targetPath: string, filter?: (absolutePath: string) => boolean): Promise<void>;
 /**
- * 파일 읽기 (UTF-8 문자열).
- * @param targetPath - 읽을 파일 경로
+ * Reads a file as a UTF-8 string.
+ * @param targetPath - Path of the file to read
  */
 export declare function fsReadSync(targetPath: string): string;
 /**
- * 파일 읽기 (UTF-8 문자열, 비동기).
- * @param targetPath - 읽을 파일 경로
+ * Reads a file as a UTF-8 string (asynchronous).
+ * @param targetPath - Path of the file to read
  */
 export declare function fsRead(targetPath: string): Promise<string>;
 /**
- * 파일 읽기 (Buffer).
- * @param targetPath - 읽을 파일 경로
+ * Reads a file as a Buffer.
+ * @param targetPath - Path of the file to read
  */
 export declare function fsReadBufferSync(targetPath: string): Buffer;
 /**
- * 파일 읽기 (Buffer, 비동기).
- * @param targetPath - 읽을 파일 경로
+ * Reads a file as a Buffer (asynchronous).
+ * @param targetPath - Path of the file to read
  */
 export declare function fsReadBuffer(targetPath: string): Promise<Buffer>;
 /**
- * JSON 파일 읽기 (JsonConvert 사용).
- * @param targetPath - 읽을 JSON 파일 경로
+ * Reads a JSON file (using JsonConvert).
+ * @param targetPath - Path of the JSON file to read
  */
 export declare function fsReadJsonSync<TData = unknown>(targetPath: string): TData;
 /**
- * JSON 파일 읽기 (JsonConvert 사용, 비동기).
- * @param targetPath - 읽을 JSON 파일 경로
+ * Reads a JSON file (using JsonConvert, asynchronous).
+ * @param targetPath - Path of the JSON file to read
  */
 export declare function fsReadJson<TData = unknown>(targetPath: string): Promise<TData>;
 /**
- * 파일 쓰기 (부모 디렉토리 자동 생성).
- * @param targetPath - 쓸 파일 경로
- * @param data - 쓸 데이터 (문자열 또는 바이너리)
+ * Writes data to a file (auto-creates parent directories).
+ * @param targetPath - Path of the file to write
+ * @param data - Data to write (string or binary)
  */
 export declare function fsWriteSync(targetPath: string, data: string | Uint8Array): void;
 /**
- * 파일 쓰기 (부모 디렉토리 자동 생성, 비동기).
- * @param targetPath - 쓸 파일 경로
- * @param data - 쓸 데이터 (문자열 또는 바이너리)
+ * Writes data to a file (auto-creates parent directories, asynchronous).
+ * @param targetPath - Path of the file to write
+ * @param data - Data to write (string or binary)
  */
 export declare function fsWrite(targetPath: string, data: string | Uint8Array): Promise<void>;
 /**
- * JSON 파일 쓰기 (JsonConvert 사용).
- * @param targetPath - 쓸 JSON 파일 경로
- * @param data - 쓸 데이터
- * @param options - JSON 직렬화 옵션
+ * Writes data to a JSON file (using JsonConvert).
+ * @param targetPath - Path of the JSON file to write
+ * @param data - Data to write
+ * @param options - JSON serialization options
  */
 export declare function fsWriteJsonSync(targetPath: string, data: unknown, options?: {
     replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;
     space?: string | number;
 }): void;
 /**
- * JSON 파일 쓰기 (JsonConvert 사용, 비동기).
- * @param targetPath - 쓸 JSON 파일 경로
- * @param data - 쓸 데이터
- * @param options - JSON 직렬화 옵션
+ * Writes data to a JSON file (using JsonConvert, asynchronous).
+ * @param targetPath - Path of the JSON file to write
+ * @param data - Data to write
+ * @param options - JSON serialization options
  */
 export declare function fsWriteJson(targetPath: string, data: unknown, options?: {
     replacer?: (this: unknown, key: string | undefined, value: unknown) => unknown;
     space?: string | number;
 }): Promise<void>;
 /**
- * 디렉토리 내용 읽기.
- * @param targetPath - 읽을 디렉토리 경로
+ * Reads the contents of a directory.
+ * @param targetPath - Path of the directory to read
  */
 export declare function fsReaddirSync(targetPath: string): string[];
 /**
- * 디렉토리 내용 읽기 (비동기).
- * @param targetPath - 읽을 디렉토리 경로
+ * Reads the contents of a directory (asynchronous).
+ * @param targetPath - Path of the directory to read
  */
 export declare function fsReaddir(targetPath: string): Promise<string[]>;
 /**
- * 파일/디렉토리 정보 (심볼릭 링크 따라감).
- * @param targetPath - 정보를 조회할 경로
+ * Gets file/directory information (follows symbolic links).
+ * @param targetPath - Path to query information for
  */
 export declare function fsStatSync(targetPath: string): fs.Stats;
 /**
- * 파일/디렉토리 정보 (심볼릭 링크 따라감, 비동기).
- * @param targetPath - 정보를 조회할 경로
+ * Gets file/directory information (follows symbolic links, asynchronous).
+ * @param targetPath - Path to query information for
  */
 export declare function fsStat(targetPath: string): Promise<fs.Stats>;
 /**
- * 파일/디렉토리 정보 (심볼릭 링크 따라가지 않음).
- * @param targetPath - 정보를 조회할 경로
+ * Gets file/directory information (does not follow symbolic links).
+ * @param targetPath - Path to query information for
  */
 export declare function fsLstatSync(targetPath: string): fs.Stats;
 /**
- * 파일/디렉토리 정보 (심볼릭 링크 따라가지 않음, 비동기).
- * @param targetPath - 정보를 조회할 경로
+ * Gets file/directory information (does not follow symbolic links, asynchronous).
+ * @param targetPath - Path to query information for
  */
 export declare function fsLstat(targetPath: string): Promise<fs.Stats>;
 /**
- * 글로브 패턴으로 파일 검색.
- * @param pattern - 글로브 패턴 (예: "**\/*.ts")
- * @param options - glob 옵션
- * @returns 매칭된 파일들의 절대 경로 배열
+ * Searches for files using a glob pattern.
+ * @param pattern - Glob pattern (e.g., "**\/*.ts")
+ * @param options - glob options
+ * @returns Array of absolute paths for matched files
  */
 export declare function fsGlobSync(pattern: string, options?: GlobOptions): string[];
 /**
- * 글로브 패턴으로 파일 검색 (비동기).
- * @param pattern - 글로브 패턴 (예: "**\/*.ts")
- * @param options - glob 옵션
- * @returns 매칭된 파일들의 절대 경로 배열
+ * Searches for files using a glob pattern (asynchronous).
+ * @param pattern - Glob pattern (e.g., "**\/*.ts")
+ * @param options - glob options
+ * @returns Array of absolute paths for matched files
  */
 export declare function fsGlob(pattern: string, options?: GlobOptions): Promise<string[]>;
 /**
- * 지정 디렉토리 하위의 빈 디렉토리를 재귀적으로 탐색하여 삭제.
- * 하위 디렉토리가 모두 삭제되어 빈 디렉토리가 된 경우, 해당 디렉토리도 삭제 대상이 됨.
+ * Recursively searches and deletes empty directories under a specified directory.
+ * If all child directories are deleted and a parent becomes empty, it will also be deleted.
  */
 export declare function fsClearEmptyDirectory(dirPath: string): Promise<void>;
 /**
- * 시작 경로부터 루트 방향으로 상위 디렉토리를 순회하며 glob 패턴 검색.
- * 각 디렉토리에서 childGlob 패턴에 매칭되는 모든 파일 경로를 수집.
- * @param childGlob - 각 디렉토리에서 검색할 glob 패턴
- * @param fromPath - 검색 시작 경로
- * @param rootPath - 검색 종료 경로 (미지정 시 파일시스템 루트까지).
- *                   **주의**: fromPath가 rootPath의 자식 경로여야 함.
- *                   그렇지 않으면 파일시스템 루트까지 검색함.
+ * Searches for files matching a glob pattern by traversing parent directories from a start path towards the root.
+ * Collects all file paths matching the childGlob pattern in each directory.
+ * @param childGlob - Glob pattern to search for in each directory
+ * @param fromPath - Path to start searching from
+ * @param rootPath - Path to stop searching at (if not specified, searches to filesystem root).
+ *                   **Note**: fromPath must be a child path of rootPath.
+ *                   Otherwise, searches to the filesystem root.
  */
 export declare function fsFindAllParentChildPathsSync(childGlob: string, fromPath: string, rootPath?: string): string[];
 /**
- * 시작 경로부터 루트 방향으로 상위 디렉토리를 순회하며 glob 패턴 검색 (비동기).
- * 각 디렉토리에서 childGlob 패턴에 매칭되는 모든 파일 경로를 수집.
- * @param childGlob - 각 디렉토리에서 검색할 glob 패턴
- * @param fromPath - 검색 시작 경로
- * @param rootPath - 검색 종료 경로 (미지정 시 파일시스템 루트까지).
- *                   **주의**: fromPath가 rootPath의 자식 경로여야 함.
- *                   그렇지 않으면 파일시스템 루트까지 검색함.
+ * Searches for files matching a glob pattern by traversing parent directories from a start path towards the root (asynchronous).
+ * Collects all file paths matching the childGlob pattern in each directory.
+ * @param childGlob - Glob pattern to search for in each directory
+ * @param fromPath - Path to start searching from
+ * @param rootPath - Path to stop searching at (if not specified, searches to filesystem root).
+ *                   **Note**: fromPath must be a child path of rootPath.
+ *                   Otherwise, searches to the filesystem root.
  */
 export declare function fsFindAllParentChildPaths(childGlob: string, fromPath: string, rootPath?: string): Promise<string[]>;
 //# sourceMappingURL=fs.d.ts.map

package/dist/utils/path.d.ts

@@ -1,13 +1,13 @@
 declare const NORM: unique symbol;
 /**
- * 정규화된 경로를 나타내는 브랜드 타입.
- * pathNorm()을 통해서만 생성 가능.
+ * Brand type representing a normalized path.
+ * Can only be created through pathNorm().
  */
 export type NormPath = string & {
     [NORM]: never;
 };
 /**
- * POSIX 스타일 경로로 변환 (백슬래시 → 슬래시).
+ * Converts to POSIX-style path (backslash → forward slash).
  *
  * @example
  * pathPosix("C:\\Users\\test"); // "C:/Users/test"
@@ -15,17 +15,17 @@ export type NormPath = string & {
  */
 export declare function pathPosix(...args: string[]): string;
 /**
- * 파일 경로의 디렉토리를 변경.
+ * Changes the directory of a file path.
  *
  * @example
  * pathChangeFileDirectory("/a/b/c.txt", "/a", "/x");
  * // → "/x/b/c.txt"
  *
- * @throws 파일이 fromDirectory 안에 없으면 에러
+ * @throws Error if the file is not inside fromDirectory
  */
 export declare function pathChangeFileDirectory(filePath: string, fromDirectory: string, toDirectory: string): string;
 /**
- * 확장자를 제거한 파일명(basename)을 반환.
+ * Returns the filename (basename) without extension.
  *
  * @example
  * pathBasenameWithoutExt("file.txt"); // "file"
@@ -33,37 +33,37 @@ export declare function pathChangeFileDirectory(filePath: string, fromDirectory:
  */
 export declare function pathBasenameWithoutExt(filePath: string): string;
 /**
- * childPath가 parentPath의 자식 경로인지 확인.
- * 같은 경로는 false 반환.
+ * Checks if childPath is a child path of parentPath.
+ * Returns false if the paths are the same.
  *
- * 경로는 내부적으로 `pathNorm()`으로 정규화된 후 비교되며,
- * 플랫폼별 경로 구분자(Windows: `\`, Unix: `/`)를 사용한다.
+ * Paths are internally normalized using `pathNorm()` and compared using
+ * platform-specific path separators (Windows: `\`, Unix: `/`).
  *
  * @example
  * pathIsChildPath("/a/b/c", "/a/b"); // true
  * pathIsChildPath("/a/b", "/a/b/c"); // false
- * pathIsChildPath("/a/b", "/a/b"); // false (같은 경로)
+ * pathIsChildPath("/a/b", "/a/b"); // false (same path)
  */
 export declare function pathIsChildPath(childPath: string, parentPath: string): boolean;
 /**
- * 경로를 정규화하여 NormPath로 반환.
- * 절대 경로로 변환되며, 플랫폼별 구분자로 정규화됨.
+ * Normalizes the path and returns it as NormPath.
+ * Converts to absolute path and normalizes using platform-specific separators.
  *
  * @example
  * pathNorm("/some/path"); // NormPath
- * pathNorm("relative", "path"); // NormPath (절대 경로로 변환)
+ * pathNorm("relative", "path"); // NormPath (converted to absolute path)
  */
 export declare function pathNorm(...paths: string[]): NormPath;
 /**
- * 타겟 경로 목록을 기준으로 파일을 필터링.
- * 파일이 타겟 경로와 같거나 타겟의 자식 경로일 때 포함.
+ * Filters files based on a list of target paths.
+ * Includes files that match or are children of a target path.
  *
- * @param files - 필터링할 파일 경로 목록.
- *                **주의**: cwd 하위의 절대 경로여야 함.
- *                cwd 외부 경로는 상대 경로(../ 형태)로 변환되어 처리됨.
- * @param targets - 타겟 경로 목록 (cwd 기준 상대 경로, POSIX 스타일 권장)
- * @param cwd - 현재 작업 디렉토리 (절대 경로)
- * @returns targets가 빈 배열이면 files 그대로, 아니면 타겟 경로 하위 파일만
+ * @param files - File paths to filter.
+ *                **Note**: Must be absolute paths under cwd.
+ *                Paths outside cwd are converted to relative paths (../) for processing.
+ * @param targets - Target paths (relative to cwd, POSIX style recommended)
+ * @param cwd - Current working directory (absolute path)
+ * @returns If targets is empty, returns files as-is; otherwise returns only files under target paths
  *
  * @example
  * const files = ["/proj/src/a.ts", "/proj/src/b.ts", "/proj/tests/c.ts"];

package/dist/utils/path.js

@@ -10,7 +10,7 @@ function pathChangeFileDirectory(filePath, fromDirectory, toDirectory) {
     return toDirectory;
   }
   if (!pathIsChildPath(filePath, fromDirectory)) {
-    throw new ArgumentError(`'${filePath}'\uAC00 ${fromDirectory} \uC548\uC5D0 \uC5C6\uC2B5\uB2C8\uB2E4.`, {
+    throw new ArgumentError(`'${filePath}' is not inside ${fromDirectory}.`, {
       filePath,
       fromDirectory
     });

package/dist/utils/path.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/utils/path.ts"],
-  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAI9B,MAAM,OAAO,uBAAO,UAAU;AAqBvB,SAAS,aAAa,MAAwB;AACnD,QAAM,eAAe,KAAK,KAAK,GAAG,IAAI;AACtC,SAAO,aAAa,QAAQ,OAAO,GAAG;AACxC;AAWO,SAAS,wBACd,UACA,eACA,aACQ;AACR,MAAI,aAAa,eAAe;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,gBAAgB,UAAU,aAAa,GAAG;AAC7C,UAAM,IAAI,cAAc,IAAI,QAAQ,WAAM,aAAa,2CAAa;AAAA,MAClE;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO,KAAK,QAAQ,aAAa,KAAK,SAAS,eAAe,QAAQ,CAAC;AACzE;AASO,SAAS,uBAAuB,UAA0B;AAC/D,SAAO,KAAK,SAAS,UAAU,KAAK,QAAQ,QAAQ,CAAC;AACvD;AAcO,SAAS,gBAAgB,WAAmB,YAA6B;AAC9E,QAAM,kBAAkB,SAAS,SAAS;AAC1C,QAAM,mBAAmB,SAAS,UAAU;AAG5C,MAAI,oBAAoB,kBAAkB;AACxC,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,iBAAiB,SAAS,KAAK,GAAG,IACpD,mBACA,mBAAmB,KAAK;AAE5B,SAAO,gBAAgB,WAAW,aAAa;AACjD;AAUO,SAAS,YAAY,OAA2B;AACrD,SAAO,KAAK,QAAQ,GAAG,KAAK;AAC9B;AAkBO,SAAS,oBAAoB,OAAiB,SAAmB,KAAuB;AAC7F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,oBAAoB,QAAQ,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;AACzD,SAAO,MAAM,OAAO,CAAC,SAAS;AAC5B,UAAM,eAAe,UAAU,KAAK,SAAS,KAAK,IAAI,CAAC;AACvD,WAAO,kBAAkB;AAAA,MACvB,CAAC,WAAW,iBAAiB,UAAU,aAAa,WAAW,SAAS,GAAG;AAAA,IAC7E;AAAA,EACF,CAAC;AACH;",
+  "mappings": "AAAA,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAI9B,MAAM,OAAO,uBAAO,UAAU;AAqBvB,SAAS,aAAa,MAAwB;AACnD,QAAM,eAAe,KAAK,KAAK,GAAG,IAAI;AACtC,SAAO,aAAa,QAAQ,OAAO,GAAG;AACxC;AAWO,SAAS,wBACd,UACA,eACA,aACQ;AACR,MAAI,aAAa,eAAe;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,gBAAgB,UAAU,aAAa,GAAG;AAC7C,UAAM,IAAI,cAAc,IAAI,QAAQ,mBAAmB,aAAa,KAAK;AAAA,MACvE;AAAA,MACA;AAAA,IACF,CAAC;AAAA,EACH;AAEA,SAAO,KAAK,QAAQ,aAAa,KAAK,SAAS,eAAe,QAAQ,CAAC;AACzE;AASO,SAAS,uBAAuB,UAA0B;AAC/D,SAAO,KAAK,SAAS,UAAU,KAAK,QAAQ,QAAQ,CAAC;AACvD;AAcO,SAAS,gBAAgB,WAAmB,YAA6B;AAC9E,QAAM,kBAAkB,SAAS,SAAS;AAC1C,QAAM,mBAAmB,SAAS,UAAU;AAG5C,MAAI,oBAAoB,kBAAkB;AACxC,WAAO;AAAA,EACT;AAGA,QAAM,gBAAgB,iBAAiB,SAAS,KAAK,GAAG,IACpD,mBACA,mBAAmB,KAAK;AAE5B,SAAO,gBAAgB,WAAW,aAAa;AACjD;AAUO,SAAS,YAAY,OAA2B;AACrD,SAAO,KAAK,QAAQ,GAAG,KAAK;AAC9B;AAkBO,SAAS,oBAAoB,OAAiB,SAAmB,KAAuB;AAC7F,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,oBAAoB,QAAQ,IAAI,CAAC,MAAM,UAAU,CAAC,CAAC;AACzD,SAAO,MAAM,OAAO,CAAC,SAAS;AAC5B,UAAM,eAAe,UAAU,KAAK,SAAS,KAAK,IAAI,CAAC;AACvD,WAAO,kBAAkB;AAAA,MACvB,CAAC,WAAW,iBAAiB,UAAU,aAAa,WAAW,SAAS,GAAG;AAAA,IAC7E;AAAA,EACF,CAAC;AACH;",
   "names": []
 }

package/dist/worker/create-worker.d.ts

@@ -1,13 +1,13 @@
 /**
- * 워커 스레드에서 사용할 워커 팩토리.
+ * Worker factory for use in worker threads.
  *
  * @example
- * // 이벤트 없는 워커
+ * // Worker without events
  * export default createWorker({
  *   add: (a: number, b: number) => a + b,
  * });
  *
- * // 이벤트 있는 워커
+ * // Worker with events
  * interface MyEvents { progress: number; }
  * const methods = {
  *   calc: (x: number) => { sender.send("progress", 50); return x * 2; },

package/dist/worker/create-worker.js

@@ -2,7 +2,7 @@ import { parentPort } from "worker_threads";
 import { SdError, transferableDecode, transferableEncode } from "@simplysm/core-common";
 function createWorker(methods) {
   if (parentPort === null) {
-    throw new SdError("\uC774 \uC2A4\uD06C\uB9BD\uD2B8\uB294 \uC6CC\uCEE4 \uC2A4\uB808\uB4DC\uC5D0\uC11C \uC2E4\uD589\uB418\uC5B4\uC57C \uD569\uB2C8\uB2E4 (parentPort \uD544\uC694).");
+    throw new SdError("This script must be executed in a worker thread (parentPort required).");
   }
   const port = parentPort;
   process.stdout.write = (chunk, encodingOrCallback, callback) => {
@@ -28,7 +28,7 @@ function createWorker(methods) {
       const errorResponse = {
         type: "error",
         request: { id: "unknown", method: "unknown", params: [] },
-        body: new SdError(`\uD615\uC2DD\uC774 \uC798\uBABB\uB41C \uC6CC\uCEE4 \uC694\uCCAD: ${decodedStr}`)
+        body: new SdError(`Invalid worker request format: ${decodedStr}`)
       };
       const serialized = transferableEncode(errorResponse);
       port.postMessage(serialized.result, serialized.transferList);
@@ -40,7 +40,7 @@ function createWorker(methods) {
       const response = {
         request,
         type: "error",
-        body: new SdError(`\uC54C \uC218 \uC5C6\uB294 \uBA54\uC11C\uB4DC: ${request.method}`)
+        body: new SdError(`Unknown method: ${request.method}`)
       };
       const serialized = transferableEncode(response);
       port.postMessage(serialized.result, serialized.transferList);

package/dist/worker/create-worker.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../src/worker/create-worker.ts"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,SAAS,oBAAoB,0BAA0B;AAsBzD,SAAS,aAId,SAKA;AACA,MAAI,eAAe,MAAM;AACvB,UAAM,IAAI,QAAQ,gKAA6C;AAAA,EACjE;AAEA,QAAM,OAAO;AAIb,UAAQ,OAAO,QAAQ,CACrB,OACA,oBACA,aACY;AACZ,UAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,IAAI,YAAY,EAAE,OAAO,KAAK;AAC/E,UAAM,WAA2B,EAAE,MAAM,OAAO,KAAK;AACrD,UAAM,aAAa,mBAAmB,QAAQ;AAC9C,SAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAE3D,UAAM,KAAK,OAAO,uBAAuB,aAAa,qBAAqB;AAC3E,QAAI,IAAI;AACN,qBAAe,MAAM,GAAG,CAAC;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,OAAK,GAAG,WAAW,OAAO,sBAA+B;AACvD,UAAM,UAAU,mBAAmB,iBAAiB;AAGpD,QACE,WAAW,QACX,OAAO,YAAY,YACnB,EAAE,QAAQ,YACV,EAAE,YAAY,YACd,EAAE,YAAY,UACd;AACA,UAAI;AACJ,UAAI;AACF,qBAAa,KAAK,UAAU,OAAO;AAAA,MACrC,QAAQ;AACN,qBAAa,OAAO,OAAO;AAAA,MAC7B;AACA,YAAM,gBAAgC;AAAA,QACpC,MAAM;AAAA,QACN,SAAS,EAAE,IAAI,WAAW,QAAQ,WAAW,QAAQ,CAAC,EAAE;AAAA,QACxD,MAAM,IAAI,QAAQ,oEAAkB,UAAU,EAAE;AAAA,MAClD;AACA,YAAM,aAAa,mBAAmB,aAAa;AACnD,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAC3D;AAAA,IACF;AACA,UAAM,UAAU;AAEhB,UAAM,WAAW,QAAQ,QAAQ,MAAM;AAEvC,QAAI,YAAY,MAAM;AACpB,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM,IAAI,QAAQ,kDAAe,QAAQ,MAAM,EAAE;AAAA,MACnD;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAC3D;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,SAAS,GAAG,QAAQ,MAAM;AAE/C,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D,SAAS,KAAK;AACZ,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAAA,MAC1D;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,WAAW;AAAA,IACX,UAAU,CAAC;AAAA,IACX,KAAuC,OAAU,MAAmB;AAClE,YAAM,WAA2B;AAAA,QAC/B,MAAM;AAAA,QACN;AAAA,QACA,MAAM;AAAA,MACR;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D;AAAA,EACF;AACF;",
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,SAAS,oBAAoB,0BAA0B;AAsBzD,SAAS,aAId,SAKA;AACA,MAAI,eAAe,MAAM;AACvB,UAAM,IAAI,QAAQ,wEAAwE;AAAA,EAC5F;AAEA,QAAM,OAAO;AAIb,UAAQ,OAAO,QAAQ,CACrB,OACA,oBACA,aACY;AACZ,UAAM,OAAO,OAAO,UAAU,WAAW,QAAQ,IAAI,YAAY,EAAE,OAAO,KAAK;AAC/E,UAAM,WAA2B,EAAE,MAAM,OAAO,KAAK;AACrD,UAAM,aAAa,mBAAmB,QAAQ;AAC9C,SAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAE3D,UAAM,KAAK,OAAO,uBAAuB,aAAa,qBAAqB;AAC3E,QAAI,IAAI;AACN,qBAAe,MAAM,GAAG,CAAC;AAAA,IAC3B;AAEA,WAAO;AAAA,EACT;AAEA,OAAK,GAAG,WAAW,OAAO,sBAA+B;AACvD,UAAM,UAAU,mBAAmB,iBAAiB;AAGpD,QACE,WAAW,QACX,OAAO,YAAY,YACnB,EAAE,QAAQ,YACV,EAAE,YAAY,YACd,EAAE,YAAY,UACd;AACA,UAAI;AACJ,UAAI;AACF,qBAAa,KAAK,UAAU,OAAO;AAAA,MACrC,QAAQ;AACN,qBAAa,OAAO,OAAO;AAAA,MAC7B;AACA,YAAM,gBAAgC;AAAA,QACpC,MAAM;AAAA,QACN,SAAS,EAAE,IAAI,WAAW,QAAQ,WAAW,QAAQ,CAAC,EAAE;AAAA,QACxD,MAAM,IAAI,QAAQ,kCAAkC,UAAU,EAAE;AAAA,MAClE;AACA,YAAM,aAAa,mBAAmB,aAAa;AACnD,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAC3D;AAAA,IACF;AACA,UAAM,UAAU;AAEhB,UAAM,WAAW,QAAQ,QAAQ,MAAM;AAEvC,QAAI,YAAY,MAAM;AACpB,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM,IAAI,QAAQ,mBAAmB,QAAQ,MAAM,EAAE;AAAA,MACvD;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAC3D;AAAA,IACF;AAEA,QAAI;AACF,YAAM,SAAS,MAAM,SAAS,GAAG,QAAQ,MAAM;AAE/C,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM;AAAA,MACR;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D,SAAS,KAAK;AACZ,YAAM,WAA2B;AAAA,QAC/B;AAAA,QACA,MAAM;AAAA,QACN,MAAM,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAAA,MAC1D;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D;AAAA,EACF,CAAC;AAED,SAAO;AAAA,IACL,WAAW;AAAA,IACX,UAAU,CAAC;AAAA,IACX,KAAuC,OAAU,MAAmB;AAClE,YAAM,WAA2B;AAAA,QAC/B,MAAM;AAAA,QACN;AAAA,QACA,MAAM;AAAA,MACR;AAEA,YAAM,aAAa,mBAAmB,QAAQ;AAC9C,WAAK,YAAY,WAAW,QAAQ,WAAW,YAAY;AAAA,IAC7D;AAAA,EACF;AACF;",
   "names": []
 }

package/dist/worker/types.d.ts

@@ -1,9 +1,9 @@
 /**
- * `createWorker()`가 반환하는 워커 모듈의 타입 구조.
- * `Worker.create<typeof import("./worker")>()`에서 타입 추론에 사용된다.
+ * Type structure of the worker module returned by `createWorker()`.
+ * Used for type inference in `Worker.create<typeof import("./worker")>()`.
  *
- * @see createWorker - 워커 모듈 생성
- * @see Worker.create - 워커 프록시 생성
+ * @see createWorker - Create worker module
+ * @see Worker.create - Create worker proxy
  */
 export interface WorkerModule {
     default: {
@@ -12,33 +12,33 @@ export interface WorkerModule {
     };
 }
 /**
- * 메서드 타입의 반환값을 Promise로 래핑하는 매핑 타입.
- * 워커 메서드는 postMessage 기반으로 동작하여 항상 비동기이므로,
- * 동기 메서드 타입도 `Promise<Awaited<R>>`로 변환한다.
+ * Mapping type that wraps method return values in Promise.
+ * Worker methods operate based on postMessage and are always asynchronous,
+ * so synchronous method types are also converted to `Promise<Awaited<R>>`.
  */
 export type PromisifyMethods<TMethods> = {
     [K in keyof TMethods]: TMethods[K] extends (...args: infer P) => infer R ? (...args: P) => Promise<Awaited<R>> : never;
 };
 /**
- * SdWorker.create()가 반환하는 Proxy 타입.
- * Promisified 메서드들 + on() + terminate() 제공.
+ * Proxy type returned by Worker.create().
+ * Provides promisified methods + on() + terminate().
  */
 export type WorkerProxy<TModule extends WorkerModule> = PromisifyMethods<TModule["default"]["__methods"]> & {
     /**
-     * 워커 이벤트 리스너 등록.
+     * Registers a worker event listener.
      */
     on<K extends keyof TModule["default"]["__events"] & string>(event: K, listener: (data: TModule["default"]["__events"][K]) => void): void;
     /**
-     * 워커 이벤트 리스너 제거.
+     * Unregisters a worker event listener.
      */
     off<K extends keyof TModule["default"]["__events"] & string>(event: K, listener: (data: TModule["default"]["__events"][K]) => void): void;
     /**
-     * 워커 종료.
+     * Terminates the worker.
      */
     terminate(): Promise<void>;
 };
 /**
- * Worker 내부 요청 메시지.
+ * Internal worker request message.
  */
 export interface WorkerRequest {
     id: string;
@@ -46,7 +46,7 @@ export interface WorkerRequest {
     params: unknown[];
 }
 /**
- * Worker 내부 응답 메시지.
+ * Internal worker response message.
  */
 export type WorkerResponse = {
     request: WorkerRequest;

package/dist/worker/worker.d.ts

@@ -1,7 +1,7 @@
 import type { WorkerOptions as WorkerRawOptions } from "worker_threads";
 import type { WorkerModule, WorkerProxy } from "./types";
 /**
- * 타입 안전한 Worker 래퍼.
+ * Type-safe Worker wrapper.
  *
  * @example
  * // worker.ts
@@ -16,11 +16,11 @@ import type { WorkerModule, WorkerProxy } from "./types";
  */
 export declare const Worker: {
     /**
-     * 타입 안전한 Worker Proxy 생성.
+     * Creates a type-safe Worker Proxy.
      *
-     * @param filePath - 워커 파일 경로 (file:// URL 또는 절대 경로)
-     * @param opt - Worker 옵션
-     * @returns Proxy 객체 (메서드 직접 호출, on(), terminate() 지원)
+     * @param filePath - Worker file path (file:// URL or absolute path)
+     * @param opt - Worker options
+     * @returns Proxy object (supports direct method calls, on(), and terminate())
      */
     create<TModule extends WorkerModule>(filePath: string, opt?: Omit<WorkerRawOptions, "stdout" | "stderr">): WorkerProxy<TModule>;
 };