@simplysm/core-node 13.0.0-beta.1

package/dist/core-common/src/utils/xml.d.ts

@@ -0,0 +1,36 @@
+/**
+ * XML 변환 유틸리티
+ */
+import type { XmlBuilderOptions } from "fast-xml-parser";
+/**
+ * XML 문자열을 객체로 파싱
+ * @param str XML 문자열
+ * @param options 옵션
+ * @param options.stripTagPrefix 태그 prefix 제거 여부 (namespace)
+ * @returns 파싱된 객체. 구조:
+ *   - 속성: `$` 객체에 그룹화
+ *   - 텍스트 노드: `_` 키에 저장
+ *   - 자식 요소: 배열로 변환 (루트 요소 제외)
+ * @example
+ * xmlParse('<root id="1"><item>hello</item></root>');
+ * // { root: { $: { id: "1" }, item: [{ _: "hello" }] } }
+ */
+export declare function xmlParse(str: string, options?: {
+    stripTagPrefix?: boolean;
+}): unknown;
+/**
+ * 객체를 XML 문자열로 직렬화
+ * @param obj 직렬화할 객체
+ * @param options fast-xml-parser XmlBuilderOptions (선택)
+ * @returns XML 문자열
+ * @example
+ * xmlStringify({
+ *   root: {
+ *     $: { id: "1" },
+ *     item: [{ _: "hello" }, { _: "world" }],
+ *   },
+ * });
+ * // '<root id="1"><item>hello</item><item>world</item></root>'
+ */
+export declare function xmlStringify(obj: unknown, options?: XmlBuilderOptions): string;
+//# sourceMappingURL=xml.d.ts.map

package/dist/core-common/src/utils/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/xml.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAKzD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,cAAc,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAarF;AAMD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAS9E"}

package/dist/core-common/src/zip/sd-zip.d.ts

@@ -0,0 +1,80 @@
+import type { Bytes } from "../common.types";
+export interface ZipArchiveProgress {
+    fileName: string;
+    totalSize: number;
+    extractedSize: number;
+}
+/**
+ * ZIP 아카이브 처리 클래스
+ *
+ * ZIP 파일의 읽기, 쓰기, 압축/해제를 처리합니다.
+ * 내부 캐시를 사용하여 동일 파일의 중복 압축 해제를 방지합니다.
+ *
+ * @example
+ * // ZIP 파일 읽기
+ * await using archive = new ZipArchive(zipBytes);
+ * const content = await archive.get("file.txt");
+ *
+ * @example
+ * // ZIP 파일 생성
+ * await using archive = new ZipArchive();
+ * archive.write("file.txt", textBytes);
+ * archive.write("data.json", jsonBytes);
+ * const zipBytes = await archive.compress();
+ *
+ * @example
+ * // 전체 압축 해제 (진행률 표시)
+ * await using archive = new ZipArchive(zipBytes);
+ * const files = await archive.extractAll((progress) => {
+ *   console.log(`${progress.fileName}: ${progress.extractedSize}/${progress.totalSize}`);
+ * });
+ */
+export declare class ZipArchive {
+    private readonly _reader?;
+    private readonly _cache;
+    private _entries?;
+    /**
+     * ZipArchive 생성
+     * @param data ZIP 데이터 (생략 시 새 아카이브 생성)
+     */
+    constructor(data?: Blob | Bytes);
+    private _getEntries;
+    /**
+     * 모든 파일을 압축 해제
+     * @param progressCallback 진행률 콜백
+     */
+    extractAll(progressCallback?: (progress: ZipArchiveProgress) => void): Promise<Map<string, Bytes | undefined>>;
+    /**
+     * 특정 파일 압축 해제
+     * @param fileName 파일 이름
+     */
+    get(fileName: string): Promise<Bytes | undefined>;
+    /**
+     * 파일 존재 여부 확인
+     * @param fileName 파일 이름
+     */
+    exists(fileName: string): Promise<boolean>;
+    /**
+     * 파일 쓰기 (캐시에 저장)
+     * @param fileName 파일 이름
+     * @param bytes 파일 내용
+     */
+    write(fileName: string, bytes: Bytes): void;
+    /**
+     * 캐시된 파일들을 ZIP으로 압축
+     *
+     * @remarks
+     * 내부적으로 `extractAll()`을 호출하여 모든 파일을 메모리에 로드한 후 압축합니다.
+     * 대용량 ZIP 파일의 경우 메모리 사용량에 주의가 필요합니다.
+     */
+    compress(): Promise<Bytes>;
+    /**
+     * 리더 닫기 및 캐시 정리
+     */
+    close(): Promise<void>;
+    /**
+     * await using 지원
+     */
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=sd-zip.d.ts.map

package/dist/core-common/src/zip/sd-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sd-zip.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/zip/sd-zip.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAE7C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA0B;IACnD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,CAA6D;IAE9E;;;OAGG;gBACS,IAAI,CAAC,EAAE,IAAI,GAAG,KAAK;YAUjB,WAAW;IAQzB;;;OAGG;IACG,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,kBAAkB,KAAK,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;IAkDpH;;;OAGG;IACG,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAwBvD;;;OAGG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgBhD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI;IAM3C;;;;;;OAMG;IACG,QAAQ,IAAI,OAAO,CAAC,KAAK,CAAC;IAiBhC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;OAEG;IACG,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7C"}

package/dist/core-node/src/features/fs-watcher.d.ts

@@ -0,0 +1,70 @@
+import * as chokidar from "chokidar";
+import { type NormPath } from "../utils/path";
+/**
+ * 지원하는 파일 변경 이벤트 타입 목록.
+ */
+declare const FS_WATCHER_EVENTS: readonly ["add", "addDir", "change", "unlink", "unlinkDir"];
+/**
+ * 파일 변경 이벤트 타입.
+ */
+export type FsWatcherEvent = (typeof FS_WATCHER_EVENTS)[number];
+/**
+ * 파일 변경 정보.
+ */
+export interface FsWatcherChangeInfo {
+    /** 변경 이벤트 타입 */
+    event: FsWatcherEvent;
+    /** 변경된 파일/디렉토리 경로 (정규화됨) */
+    path: NormPath;
+}
+/**
+ * chokidar 기반 파일 시스템 감시 래퍼.
+ * 짧은 시간 내 발생한 이벤트를 병합하여 콜백 호출.
+ *
+ * **주의**: chokidar의 `ignoreInitial` 옵션은 내부적으로 항상 `true`로 설정된다.
+ * `options.ignoreInitial: false`를 전달하면 `onChange` 첫 호출 시 빈 배열로
+ * 콜백이 호출되지만, 실제 초기 파일 목록은 포함되지 않는다.
+ * 이는 이벤트 병합 로직과의 충돌을 방지하기 위한 의도된 동작이다.
+ *
+ * @example
+ * const watcher = await FsWatcher.watch(["src/**\/*.ts"]);
+ * watcher.onChange({ delay: 300 }, (changes) => {
+ *   for (const { path, event } of changes) {
+ *     console.log(`${event}: ${path}`);
+ *   }
+ * });
+ *
+ * // 종료
+ * await watcher.close();
+ */
+export declare class FsWatcher {
+    /**
+     * 파일 감시 시작 (비동기).
+     * ready 이벤트가 발생할 때까지 대기.
+     *
+     * @param paths - 감시할 파일/디렉토리 경로 또는 glob 패턴 배열
+     * @param options - chokidar 옵션
+     */
+    static watch(paths: string[], options?: chokidar.ChokidarOptions): Promise<FsWatcher>;
+    private readonly _watcher;
+    private readonly _ignoreInitial;
+    private readonly _debounceQueues;
+    private readonly _logger;
+    private constructor();
+    /**
+     * 파일 변경 이벤트 핸들러 등록.
+     * 지정된 delay 시간 동안 이벤트를 모아서 한 번에 콜백 호출.
+     *
+     * @param opt.delay - 이벤트 병합 대기 시간 (ms)
+     * @param cb - 변경 이벤트 콜백
+     */
+    onChange(opt: {
+        delay?: number;
+    }, cb: (changeInfos: FsWatcherChangeInfo[]) => void | Promise<void>): this;
+    /**
+     * 파일 감시 종료.
+     */
+    close(): Promise<void>;
+}
+export {};
+//# sourceMappingURL=fs-watcher.d.ts.map

package/dist/core-node/src/features/fs-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-watcher.d.ts","sourceRoot":"","sources":["../../../../src/features/fs-watcher.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,UAAU,CAAC;AAGrC,OAAO,EAAE,KAAK,QAAQ,EAAY,MAAM,eAAe,CAAC;AAIxD;;GAEG;AACH,QAAA,MAAM,iBAAiB,6DAA8D,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,gBAAgB;IAChB,KAAK,EAAE,cAAc,CAAC;IACtB,4BAA4B;IAC5B,IAAI,EAAE,QAAQ,CAAC;CAChB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,SAAS;IACpB;;;;;;OAMG;WACU,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAU3F,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAuB;IAEvD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4C;IAEpE,OAAO;IAcP;;;;;;OAMG;IACH,QAAQ,CAAC,GAAG,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,EAAE,EAAE,CAAC,WAAW,EAAE,mBAAmB,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAkEzG;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAO7B"}

package/dist/core-node/src/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./utils/fs";
+export * from "./utils/path";
+export * from "./features/fs-watcher";
+export * from "./worker/types";
+export * from "./worker/worker";
+export * from "./worker/create-worker";
+//# sourceMappingURL=index.d.ts.map

package/dist/core-node/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAG7B,cAAc,uBAAuB,CAAC;AAGtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC"}

package/dist/core-node/src/utils/fs.d.ts

@@ -0,0 +1,197 @@
+import fs from "fs";
+import { type GlobOptions } from "glob";
+import "@simplysm/core-common";
+/**
+ * 파일 또는 디렉토리 존재 확인 (동기).
+ * @param targetPath - 확인할 경로
+ */
+export declare function fsExistsSync(targetPath: string): boolean;
+/**
+ * 파일 또는 디렉토리 존재 확인 (비동기).
+ * @param targetPath - 확인할 경로
+ */
+export declare function fsExists(targetPath: string): Promise<boolean>;
+/**
+ * 디렉토리 생성 (recursive).
+ * @param targetPath - 생성할 디렉토리 경로
+ */
+export declare function fsMkdirSync(targetPath: string): void;
+/**
+ * 디렉토리 생성 (recursive, 비동기).
+ * @param targetPath - 생성할 디렉토리 경로
+ */
+export declare function fsMkdir(targetPath: string): Promise<void>;
+/**
+ * 파일 또는 디렉토리 삭제.
+ * @param targetPath - 삭제할 경로
+ * @remarks 동기 버전은 재시도 없이 즉시 실패함. 파일 잠금 등 일시적 오류 가능성이 있는 경우 fsRm 사용을 권장함.
+ */
+export declare function fsRmSync(targetPath: string): void;
+/**
+ * 파일 또는 디렉토리 삭제 (비동기).
+ * @param targetPath - 삭제할 경로
+ * @remarks 비동기 버전은 파일 잠금 등의 일시적 오류에 대해 최대 6회(500ms 간격) 재시도함.
+ */
+export declare function fsRm(targetPath: string): Promise<void>;
+/**
+ * 파일 또는 디렉토리 복사.
+ *
+ * sourcePath가 존재하지 않으면 아무 작업도 수행하지 않고 반환한다.
+ *
+ * @param sourcePath 복사할 원본 경로
+ * @param targetPath 복사 대상 경로
+ * @param filter 복사 여부를 결정하는 필터 함수.
+ *               각 파일/디렉토리의 **절대 경로**가 전달되며,
+ *               true를 반환하면 복사, false면 제외.
+ *               **주의**: 최상위 sourcePath는 필터 대상이 아니며,
+ *               모든 하위 항목(자식, 손자 등)에 재귀적으로 filter 함수가 적용된다.
+ *               디렉토리에 false를 반환하면 해당 디렉토리와 모든 하위 항목이 건너뛰어짐.
+ */
+export declare function fsCopySync(sourcePath: string, targetPath: string, filter?: (absolutePath: string) => boolean): void;
+/**
+ * 파일 또는 디렉토리 복사 (비동기).
+ *
+ * sourcePath가 존재하지 않으면 아무 작업도 수행하지 않고 반환한다.
+ *
+ * @param sourcePath 복사할 원본 경로
+ * @param targetPath 복사 대상 경로
+ * @param filter 복사 여부를 결정하는 필터 함수.
+ *               각 파일/디렉토리의 **절대 경로**가 전달되며,
+ *               true를 반환하면 복사, false면 제외.
+ *               **주의**: 최상위 sourcePath는 필터 대상이 아니며,
+ *               모든 하위 항목(자식, 손자 등)에 재귀적으로 filter 함수가 적용된다.
+ *               디렉토리에 false를 반환하면 해당 디렉토리와 모든 하위 항목이 건너뛰어짐.
+ */
+export declare function fsCopy(sourcePath: string, targetPath: string, filter?: (absolutePath: string) => boolean): Promise<void>;
+/**
+ * 파일 읽기 (UTF-8 문자열).
+ * @param targetPath - 읽을 파일 경로
+ */
+export declare function fsReadSync(targetPath: string): string;
+/**
+ * 파일 읽기 (UTF-8 문자열, 비동기).
+ * @param targetPath - 읽을 파일 경로
+ */
+export declare function fsRead(targetPath: string): Promise<string>;
+/**
+ * 파일 읽기 (Buffer).
+ * @param targetPath - 읽을 파일 경로
+ */
+export declare function fsReadBufferSync(targetPath: string): Buffer;
+/**
+ * 파일 읽기 (Buffer, 비동기).
+ * @param targetPath - 읽을 파일 경로
+ */
+export declare function fsReadBuffer(targetPath: string): Promise<Buffer>;
+/**
+ * JSON 파일 읽기 (JsonConvert 사용).
+ * @param targetPath - 읽을 JSON 파일 경로
+ */
+export declare function fsReadJsonSync<T = unknown>(targetPath: string): T;
+/**
+ * JSON 파일 읽기 (JsonConvert 사용, 비동기).
+ * @param targetPath - 읽을 JSON 파일 경로
+ */
+export declare function fsReadJson<T = unknown>(targetPath: string): Promise<T>;
+/**
+ * 파일 쓰기 (부모 디렉토리 자동 생성).
+ * @param targetPath - 쓸 파일 경로
+ * @param data - 쓸 데이터 (문자열 또는 바이너리)
+ */
+export declare function fsWriteSync(targetPath: string, data: string | Uint8Array): void;
+/**
+ * 파일 쓰기 (부모 디렉토리 자동 생성, 비동기).
+ * @param targetPath - 쓸 파일 경로
+ * @param data - 쓸 데이터 (문자열 또는 바이너리)
+ */
+export declare function fsWrite(targetPath: string, data: string | Uint8Array): Promise<void>;
+/**
+ * JSON 파일 쓰기 (JsonConvert 사용).
+ * @param targetPath - 쓸 JSON 파일 경로
+ * @param data - 쓸 데이터
+ * @param options - JSON 직렬화 옵션
+ */
+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 직렬화 옵션
+ */
+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 - 읽을 디렉토리 경로
+ */
+export declare function fsReaddirSync(targetPath: string): string[];
+/**
+ * 디렉토리 내용 읽기 (비동기).
+ * @param targetPath - 읽을 디렉토리 경로
+ */
+export declare function fsReaddir(targetPath: string): Promise<string[]>;
+/**
+ * 파일/디렉토리 정보 (심볼릭 링크 따라감).
+ * @param targetPath - 정보를 조회할 경로
+ */
+export declare function fsStatSync(targetPath: string): fs.Stats;
+/**
+ * 파일/디렉토리 정보 (심볼릭 링크 따라감, 비동기).
+ * @param targetPath - 정보를 조회할 경로
+ */
+export declare function fsStat(targetPath: string): Promise<fs.Stats>;
+/**
+ * 파일/디렉토리 정보 (심볼릭 링크 따라가지 않음).
+ * @param targetPath - 정보를 조회할 경로
+ */
+export declare function fsLstatSync(targetPath: string): fs.Stats;
+/**
+ * 파일/디렉토리 정보 (심볼릭 링크 따라가지 않음, 비동기).
+ * @param targetPath - 정보를 조회할 경로
+ */
+export declare function fsLstat(targetPath: string): Promise<fs.Stats>;
+/**
+ * 글로브 패턴으로 파일 검색.
+ * @param pattern - 글로브 패턴 (예: "**\/*.ts")
+ * @param options - glob 옵션
+ * @returns 매칭된 파일들의 절대 경로 배열
+ */
+export declare function fsGlobSync(pattern: string, options?: GlobOptions): string[];
+/**
+ * 글로브 패턴으로 파일 검색 (비동기).
+ * @param pattern - 글로브 패턴 (예: "**\/*.ts")
+ * @param options - glob 옵션
+ * @returns 매칭된 파일들의 절대 경로 배열
+ */
+export declare function fsGlob(pattern: string, options?: GlobOptions): Promise<string[]>;
+/**
+ * 지정 디렉토리 하위의 빈 디렉토리를 재귀적으로 탐색하여 삭제.
+ * 하위 디렉토리가 모두 삭제되어 빈 디렉토리가 된 경우, 해당 디렉토리도 삭제 대상이 됨.
+ */
+export declare function fsClearEmptyDirectory(dirPath: string): Promise<void>;
+/**
+ * 시작 경로부터 루트 방향으로 상위 디렉토리를 순회하며 glob 패턴 검색.
+ * 각 디렉토리에서 childGlob 패턴에 매칭되는 모든 파일 경로를 수집.
+ * @param childGlob - 각 디렉토리에서 검색할 glob 패턴
+ * @param fromPath - 검색 시작 경로
+ * @param rootPath - 검색 종료 경로 (미지정 시 파일시스템 루트까지).
+ *                   **주의**: fromPath가 rootPath의 자식 경로여야 함.
+ *                   그렇지 않으면 파일시스템 루트까지 검색함.
+ */
+export declare function fsFindAllParentChildPathsSync(childGlob: string, fromPath: string, rootPath?: string): string[];
+/**
+ * 시작 경로부터 루트 방향으로 상위 디렉토리를 순회하며 glob 패턴 검색 (비동기).
+ * 각 디렉토리에서 childGlob 패턴에 매칭되는 모든 파일 경로를 수집.
+ * @param childGlob - 각 디렉토리에서 검색할 glob 패턴
+ * @param fromPath - 검색 시작 경로
+ * @param rootPath - 검색 종료 경로 (미지정 시 파일시스템 루트까지).
+ *                   **주의**: fromPath가 rootPath의 자식 경로여야 함.
+ *                   그렇지 않으면 파일시스템 루트까지 검색함.
+ */
+export declare function fsFindAllParentChildPaths(childGlob: string, fromPath: string, rootPath?: string): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/core-node/src/utils/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../../src/utils/fs.ts"],"names":[],"mappings":"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"}

package/dist/core-node/src/utils/path.d.ts

@@ -0,0 +1,75 @@
+declare const NORM: unique symbol;
+/**
+ * 정규화된 경로를 나타내는 브랜드 타입.
+ * pathNorm()을 통해서만 생성 가능.
+ */
+export type NormPath = string & {
+    [NORM]: never;
+};
+/**
+ * POSIX 스타일 경로로 변환 (백슬래시 → 슬래시).
+ *
+ * @example
+ * pathPosix("C:\\Users\\test"); // "C:/Users/test"
+ * pathPosix("src", "index.ts"); // "src/index.ts"
+ */
+export declare function pathPosix(...args: string[]): string;
+/**
+ * 파일 경로의 디렉토리를 변경.
+ *
+ * @example
+ * pathChangeFileDirectory("/a/b/c.txt", "/a", "/x");
+ * // → "/x/b/c.txt"
+ *
+ * @throws 파일이 fromDirectory 안에 없으면 에러
+ */
+export declare function pathChangeFileDirectory(filePath: string, fromDirectory: string, toDirectory: string): string;
+/**
+ * 확장자를 제거한 파일명(basename)을 반환.
+ *
+ * @example
+ * pathGetBasenameWithoutExt("file.txt"); // "file"
+ * pathGetBasenameWithoutExt("/path/to/file.spec.ts"); // "file.spec"
+ */
+export declare function pathGetBasenameWithoutExt(filePath: string): string;
+/**
+ * childPath가 parentPath의 자식 경로인지 확인.
+ * 같은 경로는 false 반환.
+ *
+ * 경로는 내부적으로 `pathNorm()`으로 정규화된 후 비교되며,
+ * 플랫폼별 경로 구분자(Windows: `\`, Unix: `/`)를 사용한다.
+ *
+ * @example
+ * pathIsChildPath("/a/b/c", "/a/b"); // true
+ * pathIsChildPath("/a/b", "/a/b/c"); // false
+ * pathIsChildPath("/a/b", "/a/b"); // false (같은 경로)
+ */
+export declare function pathIsChildPath(childPath: string, parentPath: string): boolean;
+/**
+ * 경로를 정규화하여 NormPath로 반환.
+ * 절대 경로로 변환되며, 플랫폼별 구분자로 정규화됨.
+ *
+ * @example
+ * pathNorm("/some/path"); // NormPath
+ * pathNorm("relative", "path"); // NormPath (절대 경로로 변환)
+ */
+export declare function pathNorm(...paths: string[]): NormPath;
+/**
+ * 타겟 경로 목록을 기준으로 파일을 필터링.
+ * 파일이 타겟 경로와 같거나 타겟의 자식 경로일 때 포함.
+ *
+ * @param files - 필터링할 파일 경로 목록.
+ *                **주의**: cwd 하위의 절대 경로여야 함.
+ *                cwd 외부 경로는 상대 경로(../ 형태)로 변환되어 처리됨.
+ * @param targets - 타겟 경로 목록 (cwd 기준 상대 경로, POSIX 스타일 권장)
+ * @param cwd - 현재 작업 디렉토리 (절대 경로)
+ * @returns targets가 빈 배열이면 files 그대로, 아니면 타겟 경로 하위 파일만
+ *
+ * @example
+ * const files = ["/proj/src/a.ts", "/proj/src/b.ts", "/proj/tests/c.ts"];
+ * pathFilterByTargets(files, ["src"], "/proj");
+ * // → ["/proj/src/a.ts", "/proj/src/b.ts"]
+ */
+export declare function pathFilterByTargets(files: string[], targets: string[], cwd: string): string[];
+export {};
+//# sourceMappingURL=path.d.ts.map

package/dist/core-node/src/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../src/utils/path.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,IAAI,eAAqB,CAAC;AAEhC;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAC9B,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC;CACf,CAAC;AAMF;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAGnD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAU5G;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAa9E;AAED;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAErD;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAO7F"}

package/dist/core-node/src/worker/create-worker.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 워커 스레드에서 사용할 워커 팩토리.
+ *
+ * @example
+ * // 이벤트 없는 워커
+ * export default createWorker({
+ *   add: (a: number, b: number) => a + b,
+ * });
+ *
+ * // 이벤트 있는 워커
+ * interface MyEvents { progress: number; }
+ * const methods = {
+ *   calc: (x: number) => { sender.send("progress", 50); return x * 2; },
+ * };
+ * const sender = createWorker<typeof methods, MyEvents>(methods);
+ * export default sender;
+ */
+export declare function createWorker<TMethods extends Record<string, (...args: any[]) => unknown>, TEvents extends Record<string, unknown> = Record<string, never>>(methods: TMethods): {
+    send<K extends keyof TEvents & string>(event: K, data?: TEvents[K]): void;
+    __methods: TMethods;
+    __events: TEvents;
+};
+//# sourceMappingURL=create-worker.d.ts.map

package/dist/core-node/src/worker/create-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-worker.d.ts","sourceRoot":"","sources":["../../../../src/worker/create-worker.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,EAC5D,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAE/D,OAAO,EAAE,QAAQ,GAChB;IACD,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,GAAG,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAC1E,SAAS,EAAE,QAAQ,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;CACnB,CA0GA"}

package/dist/core-node/src/worker/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * `createWorker()`가 반환하는 워커 모듈의 타입 구조.
+ * `Worker.create<typeof import("./worker")>()`에서 타입 추론에 사용된다.
+ *
+ * @see createWorker - 워커 모듈 생성
+ * @see Worker.create - 워커 프록시 생성
+ */
+export interface WorkerModule {
+    default: {
+        __methods: Record<string, (...args: any[]) => unknown>;
+        __events: Record<string, unknown>;
+    };
+}
+/**
+ * 메서드 타입의 반환값을 Promise로 래핑하는 매핑 타입.
+ * 워커 메서드는 postMessage 기반으로 동작하여 항상 비동기이므로,
+ * 동기 메서드 타입도 `Promise<Awaited<R>>`로 변환한다.
+ */
+export type PromisifyMethods<T> = {
+    [K in keyof T]: T[K] extends (...args: infer P) => infer R ? (...args: P) => Promise<Awaited<R>> : never;
+};
+/**
+ * SdWorker.create()가 반환하는 Proxy 타입.
+ * Promisified 메서드들 + on() + terminate() 제공.
+ */
+export type WorkerProxy<TModule extends WorkerModule> = PromisifyMethods<TModule["default"]["__methods"]> & {
+    /**
+     * 워커 이벤트 리스너 등록.
+     */
+    on<K extends keyof TModule["default"]["__events"] & string>(event: K, listener: (data: TModule["default"]["__events"][K]) => void): void;
+    /**
+     * 워커 이벤트 리스너 제거.
+     */
+    off<K extends keyof TModule["default"]["__events"] & string>(event: K, listener: (data: TModule["default"]["__events"][K]) => void): void;
+    /**
+     * 워커 종료.
+     */
+    terminate(): Promise<void>;
+};
+/**
+ * Worker 내부 요청 메시지.
+ */
+export interface WorkerRequest {
+    id: string;
+    method: string;
+    params: unknown[];
+}
+/**
+ * Worker 내부 응답 메시지.
+ */
+export type WorkerResponse = {
+    request: WorkerRequest;
+    type: "return";
+    body?: unknown;
+} | {
+    request: WorkerRequest;
+    type: "error";
+    body: Error;
+} | {
+    type: "event";
+    event: string;
+    body?: unknown;
+} | {
+    type: "log";
+    body: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core-node/src/worker/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/worker/types.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE;QACP,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,CAAC;QACvD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,CAAC;CACH;AAED;;;;GAIG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAC/B,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACzG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,OAAO,SAAS,YAAY,IAAI,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG;IAC1G;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,EACxD,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1D,IAAI,CAAC;IAER;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,GAAG,MAAM,EACzD,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAC1D,IAAI,CAAC;IAER;;OAEG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB;IACE,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACD;IACE,OAAO,EAAE,aAAa,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;CACb,GACD;IACE,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GACD;IACE,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CACd,CAAC"}

package/dist/core-node/src/worker/worker.d.ts

@@ -0,0 +1,27 @@
+import type { WorkerOptions as WorkerRawOptions } from "worker_threads";
+import type { WorkerModule, WorkerProxy } from "./types";
+/**
+ * 타입 안전한 Worker 래퍼.
+ *
+ * @example
+ * // worker.ts
+ * export default createWorker({
+ *   add: (a: number, b: number) => a + b,
+ * });
+ *
+ * // main.ts
+ * const worker = Worker.create<typeof import("./worker")>("./worker.ts");
+ * const result = await worker.add(10, 20);  // 30
+ * await worker.terminate();
+ */
+export declare const Worker: {
+    /**
+     * 타입 안전한 Worker Proxy 생성.
+     *
+     * @param filePath - 워커 파일 경로 (file:// URL 또는 절대 경로)
+     * @param opt - Worker 옵션
+     * @returns Proxy 객체 (메서드 직접 호출, on(), terminate() 지원)
+     */
+    create<TModule extends WorkerModule>(filePath: string, opt?: Omit<WorkerRawOptions, "stdout" | "stderr">): WorkerProxy<TModule>;
+};
+//# sourceMappingURL=worker.d.ts.map

package/dist/core-node/src/worker/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../src/worker/worker.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAExE,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAiC,MAAM,SAAS,CAAC;AAoJxF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM;IACjB;;;;;;OAMG;WACI,OAAO,SAAS,YAAY,YACvB,MAAM,QACV,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAChD,WAAW,CAAC,OAAO,CAAC;CAyBxB,CAAC"}