@simplysm/solid 13.0.0-beta.6

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

@@ -0,0 +1,51 @@
+import type { Bytes } from "../common.types";
+/**
+ * 여러 Uint8Array 연결
+ * @param arrays 연결할 Uint8Array 배열
+ * @returns 연결된 새 Uint8Array
+ * @example
+ * const a = new Uint8Array([1, 2]);
+ * const b = new Uint8Array([3, 4]);
+ * bytesConcat([a, b]);
+ * // Uint8Array([1, 2, 3, 4])
+ */
+export declare function bytesConcat(arrays: Bytes[]): Bytes;
+/**
+ * hex 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns 소문자 hex 문자열
+ * @example
+ * bytesToHex(new Uint8Array([255, 0, 127]));
+ * // "ff007f"
+ */
+export declare function bytesToHex(bytes: Bytes): string;
+/**
+ * hex 문자열에서 Uint8Array로 변환
+ * @param hex 변환할 hex 문자열 (소문자/대문자 모두 허용)
+ * @returns 변환된 Uint8Array
+ * @throws {ArgumentError} 홀수 길이 또는 유효하지 않은 hex 문자가 포함된 경우
+ * @example
+ * bytesFromHex("ff007f");
+ * // Uint8Array([255, 0, 127])
+ */
+export declare function bytesFromHex(hex: string): Bytes;
+/**
+ * Bytes를 base64 문자열로 변환
+ * @param bytes 변환할 Uint8Array
+ * @returns base64 인코딩된 문자열
+ * @example
+ * bytesToBase64(new Uint8Array([72, 101, 108, 108, 111]));
+ * // "SGVsbG8="
+ */
+export declare function bytesToBase64(bytes: Bytes): string;
+/**
+ * base64 문자열을 Bytes로 변환
+ * @param base64 변환할 base64 문자열
+ * @returns 디코딩된 Uint8Array
+ * @throws {ArgumentError} 유효하지 않은 base64 문자가 포함된 경우
+ * @example
+ * bytesFromBase64("SGVsbG8=");
+ * // Uint8Array([72, 101, 108, 108, 111])
+ */
+export declare function bytesFromBase64(base64: string): Bytes;
+//# sourceMappingURL=bytes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bytes.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/bytes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AA0B7C;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CASlD;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAO/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAY/C;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAiBlD;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAoCrD"}

package/dist/core-common/src/utils/date-format.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 월 설정 시 연도/월/일 정규화 결과
+ */
+export interface DtNormalizedMonth {
+    year: number;
+    month: number;
+    day: number;
+}
+/**
+ * 월 설정 시 연도/월/일을 정규화
+ * - 월이 1-12 범위를 벗어나면 연도를 조정
+ * - 대상 월의 일수보다 현재 일자가 크면 해당 월의 마지막 날로 조정
+ *
+ * @param year 기준 연도
+ * @param month 설정할 월 (1-12 범위 외의 값도 허용)
+ * @param day 기준 일자
+ * @returns 정규화된 연도, 월, 일
+ *
+ * @example
+ * normalizeMonth(2025, 13, 15) // { year: 2026, month: 1, day: 15 }
+ * normalizeMonth(2025, 2, 31)  // { year: 2025, month: 2, day: 28 }
+ */
+export declare function normalizeMonth(year: number, month: number, day: number): DtNormalizedMonth;
+/**
+ * 12시간제를 24시간제로 변환
+ * - 오전 12시 = 0시, 오후 12시 = 12시
+ * - 오전 1-11시 = 1-11시, 오후 1-11시 = 13-23시
+ *
+ * @param rawHour 12시간제 시 (1-12)
+ * @param isPM 오후 여부
+ * @returns 24시간제 시 (0-23)
+ */
+export declare function convert12To24(rawHour: number, isPM: boolean): number;
+/**
+ * 포맷 문자열에 따라 날짜/시간을 문자열로 변환한다
+ *
+ * @param formatString 포맷 문자열
+ * @param args 날짜/시간 구성 요소
+ *
+ * @remarks
+ * C#과 동일한 포맷 문자열을 지원한다:
+ *
+ * | 포맷 | 설명 | 예시 |
+ * |------|------|------|
+ * | yyyy | 4자리 연도 | 2024 |
+ * | yy | 2자리 연도 | 24 |
+ * | MM | 0으로 패딩된 월 | 01~12 |
+ * | M | 월 | 1~12 |
+ * | ddd | 요일 (한글) | 일, 월, 화, 수, 목, 금, 토 |
+ * | dd | 0으로 패딩된 일 | 01~31 |
+ * | d | 일 | 1~31 |
+ * | tt | 오전/오후 | 오전, 오후 |
+ * | hh | 0으로 패딩된 12시간 | 01~12 |
+ * | h | 12시간 | 1~12 |
+ * | HH | 0으로 패딩된 24시간 | 00~23 |
+ * | H | 24시간 | 0~23 |
+ * | mm | 0으로 패딩된 분 | 00~59 |
+ * | m | 분 | 0~59 |
+ * | ss | 0으로 패딩된 초 | 00~59 |
+ * | s | 초 | 0~59 |
+ * | fff | 밀리초 (3자리) | 000~999 |
+ * | ff | 밀리초 (2자리) | 00~99 |
+ * | f | 밀리초 (1자리) | 0~9 |
+ * | zzz | 타임존 오프셋 (±HH:mm) | +09:00 |
+ * | zz | 타임존 오프셋 (±HH) | +09 |
+ * | z | 타임존 오프셋 (±H) | +9 |
+ *
+ * @example
+ * ```typescript
+ * formatDate("yyyy-MM-dd", { year: 2024, month: 3, day: 15 });
+ * // "2024-03-15"
+ *
+ * formatDate("yyyy년 M월 d일 (ddd)", { year: 2024, month: 3, day: 15 });
+ * // "2024년 3월 15일 (금)"
+ *
+ * formatDate("tt h:mm:ss", { hour: 14, minute: 30, second: 45 });
+ * // "오후 2:30:45"
+ * ```
+ */
+export declare function formatDate(formatString: string, args: {
+    year?: number;
+    month?: number;
+    day?: number;
+    hour?: number;
+    minute?: number;
+    second?: number;
+    millisecond?: number;
+    timezoneOffsetMinutes?: number;
+}): string;
+//# sourceMappingURL=date-format.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date-format.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/date-format.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAY1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,CAKpE;AAyCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IACJ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACA,MAAM,CAwFR"}

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

@@ -0,0 +1,34 @@
+/**
+ * 객체를 JSON 문자열로 직렬화
+ * DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array 등 커스텀 타입 지원
+ *
+ * @param obj 직렬화할 객체
+ * @param options 직렬화 옵션
+ * @param options.space JSON 들여쓰기 (숫자: 공백 수, 문자열: 들여쓰기 문자열)
+ * @param options.replacer 커스텀 replacer 함수. 기본 타입 변환 전에 호출됨
+ * @param options.redactBytes true 시 Uint8Array 내용을 "__hidden__"으로 대체 (로깅용). 이 옵션으로 직렬화한 결과는 jsonParse()로 원본 Uint8Array를 복원할 수 없음
+ *
+ * @remarks
+ * - 순환 참조가 있는 객체는 TypeError를 던짐
+ * - 객체의 toJSON 메서드가 있으면 호출하여 결과를 사용함 (Date, DateTime 등 커스텀 타입 제외)
+ * - 전역 프로토타입을 수정하지 않아 Worker 환경에서도 안전함
+ */
+export declare function jsonStringify(obj: unknown, options?: {
+    space?: string | number;
+    replacer?: (key: string | undefined, value: unknown) => unknown;
+    redactBytes?: boolean;
+}): string;
+/**
+ * JSON 문자열을 객체로 역직렬화
+ * DateTime, DateOnly, Time, Uuid, Set, Map, Error, Uint8Array 등 커스텀 타입 복원
+ *
+ * @remarks
+ * `__type__`과 `data` 키를 가진 객체는 타입 복원에 사용된다.
+ * 사용자 데이터에 `{ __type__: "Date" | "DateTime" | "DateOnly" | "Time" | "Uuid" | "Set" | "Map" | "Error" | "Uint8Array", data: ... }`
+ * 형태가 있으면 의도치 않게 타입 변환될 수 있으므로 주의한다.
+ *
+ * @security 개발 모드(`__DEV__`)에서만 에러 메시지에 JSON 문자열 전체가 포함된다.
+ * 프로덕션 모드에서는 JSON 길이만 포함된다.
+ */
+export declare function jsonParse<T = unknown>(json: string): T;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../../core-common/src/utils/json.ts"],"names":[],"mappings":"AAoBA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,MAAM,CAkHR;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAqDtD"}

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":"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"}

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"}