@simplysm/core-node 13.0.0-beta.1

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

@@ -0,0 +1,60 @@
+/**
+ * 숫자 유틸리티 함수
+ */
+/**
+ * 문자열을 정수로 파싱
+ * 숫자가 아닌 문자(0-9, -, . 제외)는 제거 후 파싱
+ *
+ * @note 소수점이 포함된 문자열은 정수 부분만 반환됩니다 (예: '12.34' → 12).
+ *       반올림이 필요하면 {@link numParseRoundedInt}를 사용하세요.
+ * @note 문자열 중간의 `-`도 유지되므로 의도치 않은 음수가 될 수 있습니다.
+ *       예: `"가-123나"` → `-123`
+ */
+export declare function numParseInt(text: unknown): number | undefined;
+/**
+ * 문자열을 실수로 파싱 후 반올림하여 정수 반환
+ */
+export declare function numParseRoundedInt(text: unknown): number | undefined;
+/**
+ * 문자열을 실수로 파싱
+ * 숫자가 아닌 문자는 제거 후 파싱
+ */
+export declare function numParseFloat(text: unknown): number | undefined;
+/**
+ * undefined, null, 0 체크 (타입 가드)
+ *
+ * 타입 가드로 동작하여, true 반환 시 `val`이 `0 | undefined`임을 보장합니다.
+ * false 반환 시 `val`이 0이 아닌 유효한 숫자임이 보장됩니다.
+ *
+ * @param val 체크할 값
+ * @returns undefined, null, 0이면 true
+ * @example
+ * const count: number | undefined = getValue();
+ * if (numIsNullOrEmpty(count)) {
+ *   // count: 0 | undefined
+ *   console.log("비어있음");
+ * } else {
+ *   // count: number (0이 아닌 값)
+ *   console.log(`개수: ${count}`);
+ * }
+ */
+export declare function numIsNullOrEmpty(val: number | undefined): val is 0 | undefined;
+/**
+ * 숫자를 천단위 구분자가 포함된 문자열로 포맷팅
+ * @param val 포맷팅할 숫자
+ * @param digit 소수점 자릿수 옵션
+ * @param digit.max 최대 소수점 자릿수
+ * @param digit.min 최소 소수점 자릿수 (부족하면 0으로 채움)
+ * @example
+ * numFormat(1234.567, { max: 2 }) // "1,234.57"
+ * numFormat(1234, { min: 2 }) // "1,234.00"
+ */
+export declare function numFormat(val: number, digit?: {
+    max?: number;
+    min?: number;
+}): string;
+export declare function numFormat(val: number | undefined, digit?: {
+    max?: number;
+    min?: number;
+}): string | undefined;
+//# sourceMappingURL=num.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"num.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/num.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQ7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAGpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAQ/D;AAMD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,CAAC,GAAG,SAAS,CAE9E;AAMD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAAC;AACvF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,CAAC,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,SAAS,CAAC"}

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

@@ -0,0 +1,258 @@
+/**
+ * 깊은 복사
+ * - 순환 참조 지원
+ * - 커스텀 타입(DateTime, DateOnly, Time, Uuid, Uint8Array) 복사 지원
+ *
+ * @note 함수, Symbol은 복사되지 않고 참조가 유지됨
+ * @note WeakMap, WeakSet은 지원되지 않음 (일반 객체로 복사되어 빈 객체가 됨)
+ * @note 프로토타입 체인은 유지됨 (Object.setPrototypeOf 사용)
+ * @note getter/setter는 현재 값으로 평가되어 복사됨 (접근자 속성 자체는 복사되지 않음)
+ */
+export declare function objClone<T>(source: T): T;
+/** objEqual 옵션 타입 */
+export interface EqualOptions {
+    /** 비교할 키 목록. 지정 시 해당 키만 비교 (최상위 레벨에만 적용) */
+    topLevelIncludes?: string[];
+    /** 비교에서 제외할 키 목록 (최상위 레벨에만 적용) */
+    topLevelExcludes?: string[];
+    /** 배열 순서 무시 여부. true 시 O(n²) 복잡도 */
+    ignoreArrayIndex?: boolean;
+    /** 얕은 비교 여부. true 시 1단계만 비교 (참조 비교) */
+    onlyOneDepth?: boolean;
+}
+/**
+ * 깊은 비교
+ *
+ * @param source 비교 대상 1
+ * @param target 비교 대상 2
+ * @param options 비교 옵션
+ * @param options.topLevelIncludes 비교할 키 목록. 지정 시 해당 키만 비교 (최상위 레벨에만 적용)
+ *   @example `{ topLevelIncludes: ["id", "name"] }` - id, name 키만 비교
+ * @param options.topLevelExcludes 비교에서 제외할 키 목록 (최상위 레벨에만 적용)
+ *   @example `{ topLevelExcludes: ["updatedAt"] }` - updatedAt 키를 제외하고 비교
+ * @param options.ignoreArrayIndex 배열 순서 무시 여부. true 시 O(n²) 복잡도
+ * @param options.onlyOneDepth 얕은 비교 여부. true 시 1단계만 비교 (참조 비교)
+ *
+ * @note topLevelIncludes/topLevelExcludes 옵션은 object 속성 키에만 적용됨.
+ *       Map의 모든 키는 항상 비교에 포함됨.
+ * @note 성능 고려사항:
+ * - 기본 배열 비교: O(n) 시간 복잡도
+ * - `ignoreArrayIndex: true` 사용 시: O(n²) 시간 복잡도
+ *   (대용량 배열에서 성능 저하 가능)
+ * @note `ignoreArrayIndex: true` 동작 특성:
+ * - 배열 순서를 무시하고 동일한 요소들의 순열인지 비교
+ * - 예: `[1,2,3]`과 `[3,2,1]` → true, `[1,1,1]`과 `[1,2,3]` → false
+ */
+export declare function objEqual(source: unknown, target: unknown, options?: EqualOptions): boolean;
+/** objMerge 옵션 타입 */
+export interface ObjMergeOptions {
+    /** 배열 처리 방식. "replace": target으로 대체(기본), "concat": 합침(중복 제거) */
+    arrayProcess?: "replace" | "concat";
+    /** target이 null일 때 해당 키 삭제 여부 */
+    useDelTargetNull?: boolean;
+}
+/**
+ * 깊은 병합 (source를 base로 target을 병합)
+ *
+ * @param source 기준 객체
+ * @param target 병합할 객체
+ * @param opt 병합 옵션
+ * @param opt.arrayProcess 배열 처리 방식
+ *   - `"replace"`: target 배열로 대체 (기본값)
+ *   - `"concat"`: source와 target 배열을 합침 (Set으로 중복 제거)
+ * @param opt.useDelTargetNull target 값이 null일 때 해당 키 삭제 여부
+ *   - `true`: target이 null이면 결과에서 해당 키 삭제
+ *   - `false` 또는 미지정: source 값 유지
+ *
+ * @note 원본 객체를 수정하지 않고 새 객체를 반환함 (불변성 보장)
+ * @note arrayProcess="concat" 사용 시 Set을 통해 중복을 제거하며,
+ *       객체 배열의 경우 참조(주소) 비교로 중복을 판단함
+ * @note 타입이 다른 경우 target 값으로 덮어씀
+ */
+export declare function objMerge<T, P>(source: T, target: P, opt?: ObjMergeOptions): T & P;
+/** merge3 옵션 타입 */
+export interface ObjMerge3KeyOptions {
+    /** 비교할 하위 키 목록 (equal의 topLevelIncludes와 동일) */
+    keys?: string[];
+    /** 비교에서 제외할 하위 키 목록 */
+    excludes?: string[];
+    /** 배열 순서 무시 여부 */
+    ignoreArrayIndex?: boolean;
+}
+/**
+ * 3-way 병합
+ *
+ * source, origin, target 세 객체를 비교하여 병합합니다.
+ * - source와 origin이 같고 target이 다르면 → target 값 사용
+ * - target과 origin이 같고 source가 다르면 → source 값 사용
+ * - source와 target이 같으면 → 해당 값 사용
+ * - 세 값이 모두 다르면 → 충돌 발생 (origin 값 유지)
+ *
+ * @param source 변경된 버전 1
+ * @param origin 기준 버전 (공통 조상)
+ * @param target 변경된 버전 2
+ * @param optionsObj 키별 비교 옵션. 각 키에 대해 equal() 비교 옵션을 개별 지정
+ *   - `keys`: 비교할 하위 키 목록 (equal의 topLevelIncludes와 동일)
+ *   - `excludes`: 비교에서 제외할 하위 키 목록
+ *   - `ignoreArrayIndex`: 배열 순서 무시 여부
+ * @returns conflict: 충돌 발생 여부, result: 병합 결과
+ *
+ * @example
+ * const { conflict, result } = merge3(
+ *   { a: 1, b: 2 },  // source
+ *   { a: 1, b: 1 },  // origin
+ *   { a: 2, b: 1 },  // target
+ * );
+ * // conflict: false, result: { a: 2, b: 2 }
+ */
+export declare function objMerge3<S extends Record<string, unknown>, O extends Record<string, unknown>, T extends Record<string, unknown>>(source: S, origin: O, target: T, optionsObj?: Record<string, ObjMerge3KeyOptions>): {
+    conflict: boolean;
+    result: O & S & T;
+};
+/**
+ * 객체에서 특정 키들을 제외
+ * @param item 원본 객체
+ * @param omitKeys 제외할 키 배열
+ * @returns 지정된 키가 제외된 새 객체
+ * @example
+ * const user = { name: "Alice", age: 30, email: "alice@example.com" };
+ * objOmit(user, ["email"]);
+ * // { name: "Alice", age: 30 }
+ */
+export declare function objOmit<T extends Record<string, unknown>, K extends keyof T>(item: T, omitKeys: K[]): Omit<T, K>;
+/**
+ * 조건에 맞는 키들을 제외
+ * @internal
+ * @param item 원본 객체
+ * @param omitKeyFn 키를 받아 제외 여부를 반환하는 함수 (true면 제외)
+ * @returns 조건에 맞는 키가 제외된 새 객체
+ * @example
+ * const data = { name: "Alice", _internal: "secret", age: 30 };
+ * objOmitByFilter(data, (key) => key.startsWith("_"));
+ * // { name: "Alice", age: 30 }
+ */
+export declare function objOmitByFilter<T extends Record<string, unknown>>(item: T, omitKeyFn: (key: keyof T) => boolean): T;
+/**
+ * 객체에서 특정 키들만 선택
+ * @param item 원본 객체
+ * @param keys 선택할 키 배열
+ * @returns 지정된 키만 포함된 새 객체
+ * @example
+ * const user = { name: "Alice", age: 30, email: "alice@example.com" };
+ * objPick(user, ["name", "age"]);
+ * // { name: "Alice", age: 30 }
+ */
+export declare function objPick<T extends Record<string, unknown>, K extends keyof T>(item: T, keys: K[]): Pick<T, K>;
+/**
+ * 체인 경로로 값 가져오기
+ * @example objGetChainValue(obj, "a.b[0].c")
+ */
+export declare function objGetChainValue(obj: unknown, chain: string, optional: true): unknown | undefined;
+export declare function objGetChainValue(obj: unknown, chain: string): unknown;
+/**
+ * depth만큼 같은 키로 내려가기
+ * @internal
+ * @param obj 대상 객체
+ * @param key 내려갈 키
+ * @param depth 내려갈 깊이 (1 이상)
+ * @param optional true면 중간에 null/undefined가 있어도 에러 없이 undefined 반환
+ * @throws ArgumentError depth가 1 미만일 경우
+ * @example objGetChainValueByDepth({ parent: { parent: { name: 'a' } } }, 'parent', 2) => { name: 'a' }
+ */
+export declare function objGetChainValueByDepth<T, K extends keyof T>(obj: T, key: K, depth: number, optional: true): T[K] | undefined;
+export declare function objGetChainValueByDepth<T, K extends keyof T>(obj: T, key: K, depth: number): T[K];
+/**
+ * 체인 경로로 값 설정
+ * @example objSetChainValue(obj, "a.b[0].c", value)
+ */
+export declare function objSetChainValue(obj: unknown, chain: string, value: unknown): void;
+/**
+ * 체인 경로의 값 삭제
+ * @example objDeleteChainValue(obj, "a.b[0].c")
+ */
+export declare function objDeleteChainValue(obj: unknown, chain: string): void;
+/**
+ * 객체에서 undefined 값을 가진 키 삭제
+ * @internal
+ *
+ * @mutates 원본 객체를 직접 수정함
+ */
+export declare function objClearUndefined<T extends object>(obj: T): T;
+/**
+ * 객체의 모든 키 삭제
+ * @internal
+ *
+ * @mutates 원본 객체를 직접 수정함
+ */
+export declare function objClear<T extends Record<string, unknown>>(obj: T): Record<string, never>;
+/**
+ * null을 undefined로 변환 (재귀적)
+ * @internal
+ *
+ * @mutates 원본 배열/객체를 직접 수정함
+ */
+export declare function objNullToUndefined<T>(obj: T): T | undefined;
+/**
+ * flat된 객체를 nested 객체로 변환
+ * @internal
+ * @example objUnflatten({ "a.b.c": 1 }) => { a: { b: { c: 1 } } }
+ */
+export declare function objUnflatten(flatObj: Record<string, unknown>): Record<string, unknown>;
+/**
+ * undefined를 가진 프로퍼티를 optional로 변환
+ * @example { a: string; b: string | undefined } → { a: string; b?: string | undefined }
+ */
+export type ObjUndefToOptional<T> = {
+    [K in keyof T as undefined extends T[K] ? K : never]?: T[K];
+} & {
+    [K in keyof T as undefined extends T[K] ? never : K]: T[K];
+};
+/**
+ * optional 프로퍼티를 required + undefined 유니온으로 변환
+ * @example { a: string; b?: string } → { a: string; b: string | undefined }
+ */
+export type ObjOptionalToUndef<T> = {
+    [K in keyof T]-?: {} extends Pick<T, K> ? T[K] | undefined : T[K];
+};
+/**
+ * Object.keys의 타입 안전한 버전
+ * @param obj 키를 추출할 객체
+ * @returns 객체의 키 배열
+ */
+export declare function objKeys<T extends object>(obj: T): (keyof T)[];
+/**
+ * Object.entries의 타입 안전한 버전
+ * @param obj 엔트리를 추출할 객체
+ * @returns [키, 값] 튜플 배열
+ */
+export declare function objEntries<T extends object>(obj: T): ObjEntries<T>;
+/**
+ * Object.fromEntries의 타입 안전한 버전
+ * @param entries [키, 값] 튜플 배열
+ * @returns 생성된 객체
+ */
+export declare function objFromEntries<T extends [string, unknown]>(entries: T[]): {
+    [K in T[0]]: T[1];
+};
+type ObjEntries<T> = {
+    [K in keyof T]: [K, T[K]];
+}[keyof T][];
+/**
+ * 객체의 각 엔트리를 변환하여 새 객체 반환
+ * @param obj 변환할 객체
+ * @param fn 변환 함수 (key, value) => [newKey, newValue]
+ * @returns 변환된 키와 값을 가진 새 객체
+ * @example
+ * const colors = { primary: "255, 0, 0", secondary: "0, 255, 0" };
+ *
+ * // 값만 변환
+ * objMap(colors, (key, rgb) => [null, `rgb(${rgb})`]);
+ * // { primary: "rgb(255, 0, 0)", secondary: "rgb(0, 255, 0)" }
+ *
+ * // 키와 값 모두 변환
+ * objMap(colors, (key, rgb) => [`${key}Light`, `rgb(${rgb})`]);
+ * // { primaryLight: "rgb(255, 0, 0)", secondaryLight: "rgb(0, 255, 0)" }
+ */
+export declare function objMap<T extends object, NK extends string, NV>(obj: T, fn: (key: keyof T, value: T[keyof T]) => [NK | null, NV]): Record<NK | Extract<keyof T, string>, NV>;
+export {};
+//# sourceMappingURL=obj.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"obj.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/obj.ts"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAExC;AAiHD,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,oCAAoC;IACpC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,uCAAuC;IACvC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CA0C1F;AAuMD,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,YAAY,CAAC,EAAE,SAAS,GAAG,QAAQ,CAAC;IACpC,iCAAiC;IACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,CAAC,GAAG,CAAC,CAiEjF;AAED,mBAAmB;AACnB,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kBAAkB;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,SAAS,CACvB,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAEjC,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,CAAC,EACT,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAC/C;IACD,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;CACnB,CAoBA;AAMD;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAQhH;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,CAAC,CAQnH;AAED;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAM5G;AA4BD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC;AACnG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;AAcvE;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAC1D,GAAG,EAAE,CAAC,EACN,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,IAAI,GACb,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;AACpB,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAqBnG;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAclF;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAkBrE;AAMD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAQ7D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAKzF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS,CAE3D;AAwCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBtF;AAMD;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;CAC5D,GAAG;KAAG,CAAC,IAAI,MAAM,CAAC,IAAI,SAAS,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,SAAS,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC;CAClE,CAAC;AAIF;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,CAE7D;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAElE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG;KAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,CAE/F;AAED,KAAK,UAAU,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,EAAE,SAAS,MAAM,EAAE,EAAE,EAC5D,GAAG,EAAE,CAAC,EACN,EAAE,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,GACvD,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAE3C"}

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

@@ -0,0 +1,23 @@
+/**
+ * 경로 유틸리티 함수
+ * Node.js path 모듈 대체용 (브라우저 환경 지원)
+ *
+ * @note 이 유틸리티는 POSIX 스타일 경로(슬래시 `/`)만 지원합니다.
+ *       Windows 백슬래시(`\`) 경로는 지원하지 않습니다.
+ *       브라우저 환경 및 Capacitor 플러그인용으로 설계되었습니다.
+ */
+/**
+ * 경로 조합 (path.join 대체)
+ * @note POSIX 스타일 경로만 지원 (슬래시 `/`)
+ */
+export declare function pathJoin(...segments: string[]): string;
+/**
+ * 파일명 추출 (path.basename 대체)
+ */
+export declare function pathBasename(filePath: string, ext?: string): string;
+/**
+ * 확장자 추출 (path.extname 대체)
+ * @note 숨김 파일(예: `.gitignore`)은 빈 문자열을 반환합니다 (Node.js path.extname과 동일)
+ */
+export declare function pathExtname(filePath: string): string;
+//# sourceMappingURL=path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/path.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAKtD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAMnE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIpD"}

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

@@ -0,0 +1,18 @@
+import type { PrimitiveTypeMap, PrimitiveTypeStr } from "../common.types";
+/**
+ * 값에서 PrimitiveTypeStr 추론
+ *
+ * 런타임에서 값의 타입을 검사하여 해당하는 PrimitiveTypeStr을 반환합니다.
+ *
+ * @param value 타입을 추론할 값
+ * @returns 값에 해당하는 PrimitiveTypeStr
+ * @throws ArgumentError 지원하지 않는 타입인 경우
+ *
+ * @example
+ * getPrimitiveTypeStr("hello") // "string"
+ * getPrimitiveTypeStr(123) // "number"
+ * getPrimitiveTypeStr(new DateTime()) // "DateTime"
+ * getPrimitiveTypeStr(new Uint8Array()) // "Bytes"
+ */
+export declare function getPrimitiveTypeStr(value: PrimitiveTypeMap[PrimitiveTypeStr]): PrimitiveTypeStr;
+//# sourceMappingURL=primitive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"primitive.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/primitive.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAE1E;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAU/F"}

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

@@ -0,0 +1,103 @@
+/**
+ * 문자열 유틸리티 함수
+ */
+/**
+ * 한글 조사를 받침에 따라 적절히 반환
+ * @param text 텍스트
+ * @param type 조사 타입
+ *   - `"을"`: 을/를
+ *   - `"은"`: 은/는
+ *   - `"이"`: 이/가
+ *   - `"와"`: 과/와
+ *   - `"랑"`: 이랑/랑
+ *   - `"로"`: 으로/로
+ *   - `"라"`: 이라/라
+ *
+ * @example
+ * getSuffix("사과", "을") // "를"
+ * getSuffix("책", "이") // "이"
+ */
+export declare function strGetSuffix(text: string, type: "을" | "은" | "이" | "와" | "랑" | "로" | "라"): string;
+/**
+ * 전각(Full-width) 문자를 반각(Half-width) 문자로 변환
+ *
+ * 변환 대상:
+ * - 전각 영문 대문자 (Ａ-Ｚ → A-Z)
+ * - 전각 영문 소문자 (ａ-ｚ → a-z)
+ * - 전각 숫자 (０-９ → 0-9)
+ * - 전각 공백 (　 → 일반 공백)
+ * - 전각 괄호 (（） → ())
+ *
+ * @example
+ * replaceSpecialDefaultChar("Ａ１２３") // "A123"
+ * replaceSpecialDefaultChar("（株）") // "(株)"
+ */
+export declare function strReplaceFullWidth(str: string): string;
+/**
+ * PascalCase로 변환
+ * @example "hello-world" → "HelloWorld"
+ * @example "hello_world" → "HelloWorld"
+ * @example "hello.world" → "HelloWorld"
+ */
+export declare function strToPascalCase(str: string): string;
+/**
+ * camelCase로 변환
+ * @example "hello-world" → "helloWorld"
+ * @example "hello_world" → "helloWorld"
+ * @example "HelloWorld" → "helloWorld"
+ */
+export declare function strToCamelCase(str: string): string;
+/**
+ * kebab-case로 변환
+ *
+ * @example "HelloWorld" → "hello-world"
+ * @example "helloWorld" → "hello-world"
+ * @example "hello_world" → "hello_world" (소문자만 있으면 변환 안됨)
+ * @example "Hello_World" → "hello-_world" (기존 분리자는 유지됨)
+ * @example "Hello-World" → "hello--world" (기존 분리자는 유지됨)
+ * @example "XMLParser" → "x-m-l-parser" (연속된 대문자는 각각 분리됨)
+ */
+export declare function strToKebabCase(str: string): string;
+/**
+ * snake_case로 변환
+ *
+ * @example "HelloWorld" → "hello_world"
+ * @example "helloWorld" → "hello_world"
+ * @example "hello-world" → "hello-world" (소문자만 있으면 변환 안됨)
+ * @example "Hello-World" → "hello_-world" (기존 분리자는 유지됨)
+ * @example "Hello_World" → "hello__world" (기존 분리자는 유지됨)
+ * @example "XMLParser" → "x_m_l_parser" (연속된 대문자는 각각 분리됨)
+ */
+export declare function strToSnakeCase(str: string): string;
+/**
+ * undefined 또는 빈 문자열 여부 체크 (타입 가드)
+ *
+ * @param str 체크할 문자열
+ * @returns undefined, null, 빈 문자열이면 true
+ *
+ * @example
+ * const name: string | undefined = getValue();
+ * if (strIsNullOrEmpty(name)) {
+ *   // name: "" | undefined
+ *   console.log("이름이 비어있습니다");
+ * } else {
+ *   // name: string (비어있지 않은 문자열)
+ *   console.log(`이름: ${name}`);
+ * }
+ */
+export declare function strIsNullOrEmpty(str: string | undefined): str is "" | undefined;
+/**
+ * 문자열 특정 위치에 삽입
+ *
+ * @param str 원본 문자열
+ * @param index 삽입할 위치 (0부터 시작)
+ * @param insertString 삽입할 문자열
+ * @returns 삽입된 새 문자열
+ *
+ * @example
+ * strInsert("Hello World", 5, ","); // "Hello, World"
+ * strInsert("abc", 0, "X"); // "Xabc"
+ * strInsert("abc", 3, "X"); // "abcX"
+ */
+export declare function strInsert(str: string, index: number, insertString: string): string;
+//# sourceMappingURL=str.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"str.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/str.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,MAAM,CAyBhG;AA8ED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAMD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAElD;AAUD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,GAAG,IAAI,EAAE,GAAG,SAAS,CAE/E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAElF"}

package/dist/core-common/src/utils/template-strings.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 템플릿 문자열 태그 함수들
+ * IDE 코드 하이라이팅 지원용 (실제 동작은 문자열 조합 + 들여쓰기 정리)
+ */
+/**
+ * JavaScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const code = js`
+ *   function hello() {
+ *     return "world";
+ *   }
+ * `;
+ */
+export declare function js(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * TypeScript 코드 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const code = ts`
+ *   interface User {
+ *     name: string;
+ *     age: number;
+ *   }
+ * `;
+ */
+export declare function ts(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * HTML 마크업 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const markup = html`
+ *   <div class="container">
+ *     <span>${name}</span>
+ *   </div>
+ * `;
+ */
+export declare function html(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * MSSQL T-SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = tsql`
+ *   SELECT TOP 10 *
+ *   FROM Users
+ *   WHERE Name LIKE '%${keyword}%'
+ * `;
+ */
+export declare function tsql(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * MySQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = mysql`
+ *   SELECT *
+ *   FROM users
+ *   LIMIT 10
+ * `;
+ */
+export declare function mysql(strings: TemplateStringsArray, ...values: unknown[]): string;
+/**
+ * PostgreSQL SQL 하이라이팅용 템플릿 태그
+ * @param strings 템플릿 문자열 배열
+ * @param values 보간된 값들
+ * @returns 들여쓰기가 정리된 문자열
+ * @example
+ * const query = pgsql`
+ *   SELECT *
+ *   FROM users
+ *   OFFSET 0 LIMIT 10
+ * `;
+ */
+export declare function pgsql(strings: TemplateStringsArray, ...values: unknown[]): string;
+//# sourceMappingURL=template-strings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template-strings.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/template-strings.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,EAAE,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAE9E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEhF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEjF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAEjF"}

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

@@ -0,0 +1,47 @@
+/**
+ * Worker 간 전송 가능한 객체 타입
+ *
+ * 이 코드에서는 ArrayBuffer만 사용됩니다.
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Transferable_objects
+ */
+type Transferable = ArrayBuffer;
+/**
+ * Transferable 변환 유틸리티 함수
+ *
+ * Worker 간 데이터 전송을 위한 직렬화/역직렬화를 수행합니다.
+ * structuredClone이 지원하지 않는 커스텀 타입들을 처리합니다.
+ *
+ * 지원 타입:
+ * - Date, DateTime, DateOnly, Time, Uuid, RegExp
+ * - Error (cause, code, detail 포함)
+ * - Uint8Array (다른 TypedArray는 미지원, 일반 객체로 처리됨)
+ * - Array, Map, Set, 일반 객체
+ *
+ * @note 순환 참조가 있으면 transferableEncode 시 TypeError 발생 (경로 정보 포함)
+ * @note 동일 객체가 여러 곳에서 참조되면 캐시된 인코딩 결과를 재사용합니다
+ *
+ * @example
+ * // Worker로 데이터 전송
+ * const { result, transferList } = transferableEncode(data);
+ * worker.postMessage(result, transferList);
+ *
+ * // Worker에서 데이터 수신
+ * const decoded = transferableDecode(event.data);
+ */
+/**
+ * 심플리즘 타입을 사용한 객체를 일반 객체로 변환
+ * Worker에 전송할 수 있는 형태로 직렬화
+ *
+ * @throws 순환 참조 감지 시 TypeError
+ */
+export declare function transferableEncode(obj: unknown): {
+    result: unknown;
+    transferList: Transferable[];
+};
+/**
+ * serialize 객체를 심플리즘 타입 사용 객체로 변환
+ * Worker로부터 받은 데이터를 역직렬화
+ */
+export declare function transferableDecode(obj: unknown): unknown;
+export {};
+//# sourceMappingURL=transferable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transferable.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/transferable.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,KAAK,YAAY,GAAG,WAAW,CAAC;AAEhC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAIH;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG;IAChD,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,YAAY,EAAE,CAAC;CAC9B,CAMA;AAqID;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA2ExD"}

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

@@ -0,0 +1,19 @@
+/**
+ * 조건이 참이 될 때까지 대기
+ * @param forwarder 조건 함수
+ * @param milliseconds 체크 간격 (기본: 100ms)
+ * @param maxCount 최대 시도 횟수 (undefined면 무제한)
+ *
+ * @note 조건이 첫 번째 호출에서 true면 즉시 반환됩니다.
+ * @example
+ * // maxCount=3: 최대 3번 조건 확인 후 모두 false면 TimeoutError
+ * await waitUntil(() => someCondition, 100, 3);
+ * @throws TimeoutError 최대 시도 횟수 초과 시
+ */
+export declare function waitUntil(forwarder: () => boolean | Promise<boolean>, milliseconds?: number, maxCount?: number): Promise<void>;
+/**
+ * 지정된 시간만큼 대기
+ * @param millisecond 대기 시간 (ms)
+ */
+export declare function waitTime(millisecond: number): Promise<void>;
+//# sourceMappingURL=wait.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wait.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/wait.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAC7B,SAAS,EAAE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC3C,YAAY,CAAC,EAAE,MAAM,EACrB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEjE"}