@simplysm/core-common 13.0.0-beta.1

package/dist/utils/obj.js

@@ -0,0 +1,538 @@
+import { DateTime } from "../types/date-time";
+import { DateOnly } from "../types/date-only";
+import { Time } from "../types/time";
+import { Uuid } from "../types/uuid";
+import { ArgumentError } from "../errors/argument-error";
+function objClone(source) {
+  return objCloneImpl(source);
+}
+function objCloneImpl(source, prevClones) {
+  if (typeof source !== "object" || source === null) {
+    return source;
+  }
+  if (source instanceof Date) {
+    return new Date(source.getTime());
+  }
+  if (source instanceof DateTime) {
+    return new DateTime(source.tick);
+  }
+  if (source instanceof DateOnly) {
+    return new DateOnly(source.tick);
+  }
+  if (source instanceof Time) {
+    return new Time(source.tick);
+  }
+  if (source instanceof Uuid) {
+    return new Uuid(source.toString());
+  }
+  if (source instanceof RegExp) {
+    return new RegExp(source.source, source.flags);
+  }
+  const currPrevClones = prevClones ?? /* @__PURE__ */ new WeakMap();
+  if (currPrevClones.has(source)) {
+    return currPrevClones.get(source);
+  }
+  if (source instanceof Error) {
+    const cloned = Object.create(Object.getPrototypeOf(source));
+    currPrevClones.set(source, cloned);
+    cloned.message = source.message;
+    cloned.name = source.name;
+    cloned.stack = source.stack;
+    if (source.cause !== void 0) {
+      cloned.cause = objCloneImpl(source.cause, currPrevClones);
+    }
+    for (const key of Object.keys(source)) {
+      if (!["message", "name", "stack", "cause"].includes(key)) {
+        cloned[key] = objCloneImpl(
+          source[key],
+          currPrevClones
+        );
+      }
+    }
+    return cloned;
+  }
+  if (source instanceof Uint8Array) {
+    const result2 = source.slice();
+    currPrevClones.set(source, result2);
+    return result2;
+  }
+  if (source instanceof Array) {
+    const result2 = [];
+    currPrevClones.set(source, result2);
+    for (const item of source) {
+      result2.push(objCloneImpl(item, currPrevClones));
+    }
+    return result2;
+  }
+  if (source instanceof Map) {
+    const result2 = /* @__PURE__ */ new Map();
+    currPrevClones.set(source, result2);
+    for (const [key, value] of source) {
+      result2.set(objCloneImpl(key, currPrevClones), objCloneImpl(value, currPrevClones));
+    }
+    return result2;
+  }
+  if (source instanceof Set) {
+    const result2 = /* @__PURE__ */ new Set();
+    currPrevClones.set(source, result2);
+    for (const item of source) {
+      result2.add(objCloneImpl(item, currPrevClones));
+    }
+    return result2;
+  }
+  const result = {};
+  Object.setPrototypeOf(result, Object.getPrototypeOf(source));
+  currPrevClones.set(source, result);
+  for (const key of Object.keys(source)) {
+    const value = source[key];
+    result[key] = objCloneImpl(value, currPrevClones);
+  }
+  return result;
+}
+function objEqual(source, target, options) {
+  if (source === target) return true;
+  if (source == null || target == null) return false;
+  if (typeof source !== typeof target) return false;
+  if (source instanceof Date && target instanceof Date) {
+    return source.getTime() === target.getTime();
+  }
+  if (source instanceof DateTime && target instanceof DateTime || source instanceof DateOnly && target instanceof DateOnly || source instanceof Time && target instanceof Time) {
+    return source.tick === target.tick;
+  }
+  if (source instanceof Uuid && target instanceof Uuid) {
+    return source.toString() === target.toString();
+  }
+  if (source instanceof RegExp && target instanceof RegExp) {
+    return source.source === target.source && source.flags === target.flags;
+  }
+  if (source instanceof Array && target instanceof Array) {
+    return objEqualArray(source, target, options);
+  }
+  if (source instanceof Map && target instanceof Map) {
+    return objEqualMap(source, target, options);
+  }
+  if (source instanceof Set && target instanceof Set) {
+    return objEqualSet(source, target, options);
+  }
+  if (typeof source === "object" && typeof target === "object") {
+    return objEqualObject(source, target, options);
+  }
+  return false;
+}
+function objEqualArray(source, target, options) {
+  if (source.length !== target.length) {
+    return false;
+  }
+  if (options == null ? void 0 : options.ignoreArrayIndex) {
+    const matchedIndices = /* @__PURE__ */ new Set();
+    if (options.onlyOneDepth) {
+      return source.every((sourceItem) => {
+        const idx = target.findIndex((t, i) => !matchedIndices.has(i) && t === sourceItem);
+        if (idx !== -1) {
+          matchedIndices.add(idx);
+          return true;
+        }
+        return false;
+      });
+    } else {
+      const recursiveOptions = { ignoreArrayIndex: options.ignoreArrayIndex, onlyOneDepth: options.onlyOneDepth };
+      return source.every((sourceItem) => {
+        const idx = target.findIndex((t, i) => !matchedIndices.has(i) && objEqual(t, sourceItem, recursiveOptions));
+        if (idx !== -1) {
+          matchedIndices.add(idx);
+          return true;
+        }
+        return false;
+      });
+    }
+  } else {
+    if (options == null ? void 0 : options.onlyOneDepth) {
+      for (let i = 0; i < source.length; i++) {
+        if (source[i] !== target[i]) {
+          return false;
+        }
+      }
+    } else {
+      for (let i = 0; i < source.length; i++) {
+        if (!objEqual(source[i], target[i], {
+          ignoreArrayIndex: options == null ? void 0 : options.ignoreArrayIndex,
+          onlyOneDepth: options == null ? void 0 : options.onlyOneDepth
+        })) {
+          return false;
+        }
+      }
+    }
+  }
+  return true;
+}
+function objEqualMap(source, target, options) {
+  const sourceKeys = Array.from(source.keys()).filter((key) => source.get(key) != null);
+  const targetKeys = Array.from(target.keys()).filter((key) => target.get(key) != null);
+  if (sourceKeys.length !== targetKeys.length) {
+    return false;
+  }
+  const usedTargetKeys = /* @__PURE__ */ new Set();
+  for (const sourceKey of sourceKeys) {
+    if (typeof sourceKey === "string") {
+      const sourceValue = source.get(sourceKey);
+      const targetValue = target.get(sourceKey);
+      if (options == null ? void 0 : options.onlyOneDepth) {
+        if (sourceValue !== targetValue) return false;
+      } else {
+        if (!objEqual(sourceValue, targetValue, {
+          ignoreArrayIndex: options == null ? void 0 : options.ignoreArrayIndex,
+          onlyOneDepth: options == null ? void 0 : options.onlyOneDepth
+        })) {
+          return false;
+        }
+      }
+    } else {
+      let found = false;
+      for (let i = 0; i < targetKeys.length; i++) {
+        const targetKey = targetKeys[i];
+        if (typeof targetKey === "string" || usedTargetKeys.has(i)) continue;
+        if ((options == null ? void 0 : options.onlyOneDepth) ? sourceKey === targetKey : objEqual(sourceKey, targetKey)) {
+          usedTargetKeys.add(i);
+          const sourceValue = source.get(sourceKey);
+          const targetValue = target.get(targetKey);
+          if (options == null ? void 0 : options.onlyOneDepth) {
+            if (sourceValue !== targetValue) return false;
+          } else {
+            if (!objEqual(sourceValue, targetValue, {
+              ignoreArrayIndex: options == null ? void 0 : options.ignoreArrayIndex,
+              onlyOneDepth: options == null ? void 0 : options.onlyOneDepth
+            })) {
+              return false;
+            }
+          }
+          found = true;
+          break;
+        }
+      }
+      if (!found) return false;
+    }
+  }
+  return true;
+}
+function objEqualObject(source, target, options) {
+  const sourceKeys = Object.keys(source).filter(
+    (key) => {
+      var _a;
+      return ((options == null ? void 0 : options.topLevelIncludes) === void 0 || options.topLevelIncludes.includes(key)) && !((_a = options == null ? void 0 : options.topLevelExcludes) == null ? void 0 : _a.includes(key)) && source[key] != null;
+    }
+  );
+  const targetKeys = Object.keys(target).filter(
+    (key) => {
+      var _a;
+      return ((options == null ? void 0 : options.topLevelIncludes) === void 0 || options.topLevelIncludes.includes(key)) && !((_a = options == null ? void 0 : options.topLevelExcludes) == null ? void 0 : _a.includes(key)) && target[key] != null;
+    }
+  );
+  if (sourceKeys.length !== targetKeys.length) {
+    return false;
+  }
+  for (const key of sourceKeys) {
+    if (options == null ? void 0 : options.onlyOneDepth) {
+      if (source[key] !== target[key]) {
+        return false;
+      }
+    } else {
+      if (!objEqual(source[key], target[key], {
+        ignoreArrayIndex: options == null ? void 0 : options.ignoreArrayIndex
+      })) {
+        return false;
+      }
+    }
+  }
+  return true;
+}
+function objEqualSet(source, target, options) {
+  if (source.size !== target.size) {
+    return false;
+  }
+  if (options == null ? void 0 : options.onlyOneDepth) {
+    for (const sourceItem of source) {
+      if (!target.has(sourceItem)) {
+        return false;
+      }
+    }
+  } else {
+    const targetArr = [...target];
+    const matchedIndices = /* @__PURE__ */ new Set();
+    for (const sourceItem of source) {
+      const idx = targetArr.findIndex((t, i) => !matchedIndices.has(i) && objEqual(sourceItem, t, options));
+      if (idx === -1) {
+        return false;
+      }
+      matchedIndices.add(idx);
+    }
+  }
+  return true;
+}
+function objMerge(source, target, opt) {
+  if (source == null) {
+    return objClone(target);
+  }
+  if (target === void 0) {
+    return objClone(source);
+  }
+  if (target === null) {
+    return (opt == null ? void 0 : opt.useDelTargetNull) ? void 0 : objClone(source);
+  }
+  if (typeof target !== "object") {
+    return target;
+  }
+  if (target instanceof Date || target instanceof DateTime || target instanceof DateOnly || target instanceof Time || target instanceof Uuid || target instanceof Uint8Array || (opt == null ? void 0 : opt.arrayProcess) === "replace" && target instanceof Array) {
+    return objClone(target);
+  }
+  if (typeof source !== "object" || source.constructor !== target.constructor) {
+    return objClone(target);
+  }
+  if (source instanceof Map && target instanceof Map) {
+    const result = objClone(source);
+    for (const key of target.keys()) {
+      if (result.has(key)) {
+        result.set(key, objMerge(result.get(key), target.get(key), opt));
+      } else {
+        result.set(key, objClone(target.get(key)));
+      }
+    }
+    return result;
+  }
+  if ((opt == null ? void 0 : opt.arrayProcess) === "concat" && source instanceof Array && target instanceof Array) {
+    let result = [.../* @__PURE__ */ new Set([...source, ...target])];
+    if (opt.useDelTargetNull) {
+      result = result.filter((item) => item !== null);
+    }
+    return result;
+  }
+  const sourceRec = source;
+  const targetRec = target;
+  const resultRec = objClone(sourceRec);
+  for (const key of Object.keys(target)) {
+    resultRec[key] = objMerge(sourceRec[key], targetRec[key], opt);
+    if (resultRec[key] === void 0) {
+      delete resultRec[key];
+    }
+  }
+  return resultRec;
+}
+function objMerge3(source, origin, target, optionsObj) {
+  let conflict = false;
+  const result = objClone(origin);
+  const allKeys = /* @__PURE__ */ new Set([...Object.keys(source), ...Object.keys(target), ...Object.keys(origin)]);
+  for (const key of allKeys) {
+    if (objEqual(source[key], result[key], optionsObj == null ? void 0 : optionsObj[key])) {
+      result[key] = objClone(target[key]);
+    } else if (objEqual(target[key], result[key], optionsObj == null ? void 0 : optionsObj[key])) {
+      result[key] = objClone(source[key]);
+    } else if (objEqual(source[key], target[key], optionsObj == null ? void 0 : optionsObj[key])) {
+      result[key] = objClone(source[key]);
+    } else {
+      conflict = true;
+    }
+  }
+  return {
+    conflict,
+    result
+  };
+}
+function objOmit(item, omitKeys) {
+  const result = {};
+  for (const key of Object.keys(item)) {
+    if (!omitKeys.includes(key)) {
+      result[key] = item[key];
+    }
+  }
+  return result;
+}
+function objOmitByFilter(item, omitKeyFn) {
+  const result = {};
+  for (const key of Object.keys(item)) {
+    if (!omitKeyFn(key)) {
+      result[key] = item[key];
+    }
+  }
+  return result;
+}
+function objPick(item, keys) {
+  const result = {};
+  for (const key of keys) {
+    result[key] = item[key];
+  }
+  return result;
+}
+const chainSplitRegex = /[.[\]]/g;
+const chainCleanRegex = /[?!'"]/g;
+const chainNumericRegex = /^[0-9]*$/;
+function getChainSplits(chain) {
+  const split = chain.split(chainSplitRegex).map((item) => item.replace(chainCleanRegex, "")).filter((item) => Boolean(item));
+  const result = [];
+  for (const splitItem of split) {
+    if (chainNumericRegex.test(splitItem)) {
+      result.push(Number.parseInt(splitItem));
+    } else {
+      result.push(splitItem);
+    }
+  }
+  return result;
+}
+function objGetChainValue(obj, chain, optional) {
+  const splits = getChainSplits(chain);
+  let result = obj;
+  for (const splitItem of splits) {
+    if (optional && result === void 0) {
+      result = void 0;
+    } else {
+      result = result[splitItem];
+    }
+  }
+  return result;
+}
+function objGetChainValueByDepth(obj, key, depth, optional) {
+  if (depth < 1) {
+    throw new ArgumentError("depth\uB294 1 \uC774\uC0C1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.", { depth });
+  }
+  let result = obj;
+  for (let i = 0; i < depth; i++) {
+    if (optional && result == null) {
+      result = void 0;
+    } else {
+      result = result[key];
+    }
+  }
+  return result;
+}
+function objSetChainValue(obj, chain, value) {
+  const splits = getChainSplits(chain);
+  if (splits.length === 0) {
+    throw new ArgumentError("\uCCB4\uC778\uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.", { chain });
+  }
+  let curr = obj;
+  for (const splitItem of splits.slice(0, -1)) {
+    curr[splitItem] = curr[splitItem] ?? {};
+    curr = curr[splitItem];
+  }
+  const last = splits[splits.length - 1];
+  curr[last] = value;
+}
+function objDeleteChainValue(obj, chain) {
+  const splits = getChainSplits(chain);
+  if (splits.length === 0) {
+    throw new ArgumentError("\uCCB4\uC778\uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.", { chain });
+  }
+  let curr = obj;
+  for (const splitItem of splits.slice(0, -1)) {
+    const next = curr[splitItem];
+    if (next == null || typeof next !== "object") {
+      return;
+    }
+    curr = next;
+  }
+  const last = splits[splits.length - 1];
+  delete curr[last];
+}
+function objClearUndefined(obj) {
+  const record = obj;
+  for (const key of Object.keys(record)) {
+    if (record[key] === void 0) {
+      delete record[key];
+    }
+  }
+  return obj;
+}
+function objClear(obj) {
+  for (const key of Object.keys(obj)) {
+    delete obj[key];
+  }
+  return obj;
+}
+function objNullToUndefined(obj) {
+  return objNullToUndefinedImpl(obj, /* @__PURE__ */ new WeakSet());
+}
+function objNullToUndefinedImpl(obj, seen) {
+  if (obj == null) {
+    return void 0;
+  }
+  if (obj instanceof Date || obj instanceof DateTime || obj instanceof DateOnly || obj instanceof Time || obj instanceof Uuid) {
+    return obj;
+  }
+  if (obj instanceof Array) {
+    if (seen.has(obj)) return obj;
+    seen.add(obj);
+    for (let i = 0; i < obj.length; i++) {
+      obj[i] = objNullToUndefinedImpl(obj[i], seen);
+    }
+    return obj;
+  }
+  if (typeof obj === "object") {
+    if (seen.has(obj)) return obj;
+    seen.add(obj);
+    const objRec = obj;
+    for (const key of Object.keys(obj)) {
+      objRec[key] = objNullToUndefinedImpl(objRec[key], seen);
+    }
+    return obj;
+  }
+  return obj;
+}
+function objUnflatten(flatObj) {
+  const result = {};
+  for (const key in flatObj) {
+    const parts = key.split(".");
+    let current = result;
+    for (let i = 0; i < parts.length; i++) {
+      const part = parts[i];
+      if (i === parts.length - 1) {
+        current[part] = flatObj[key];
+      } else {
+        if (!(part in current)) {
+          current[part] = {};
+        }
+        current = current[part];
+      }
+    }
+  }
+  return result;
+}
+function objKeys(obj) {
+  return Object.keys(obj);
+}
+function objEntries(obj) {
+  return Object.entries(obj);
+}
+function objFromEntries(entries) {
+  return Object.fromEntries(entries);
+}
+function objMap(obj, fn) {
+  return objMapImpl(obj, fn);
+}
+function objMapImpl(obj, fn) {
+  const result = {};
+  for (const key of Object.keys(obj)) {
+    const [newKey, newValue] = fn(key, obj[key]);
+    result[newKey ?? key] = newValue;
+  }
+  return result;
+}
+export {
+  objClear,
+  objClearUndefined,
+  objClone,
+  objDeleteChainValue,
+  objEntries,
+  objEqual,
+  objFromEntries,
+  objGetChainValue,
+  objGetChainValueByDepth,
+  objKeys,
+  objMap,
+  objMerge,
+  objMerge3,
+  objNullToUndefined,
+  objOmit,
+  objOmitByFilter,
+  objPick,
+  objSetChainValue,
+  objUnflatten
+};
+//# sourceMappingURL=obj.js.map

package/dist/utils/obj.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/obj.ts"],
+  "sourcesContent": ["import { DateTime } from \"../types/date-time\";\nimport { DateOnly } from \"../types/date-only\";\nimport { Time } from \"../types/time\";\nimport { Uuid } from \"../types/uuid\";\nimport { ArgumentError } from \"../errors/argument-error\";\n\n//#region objClone\n\n/**\n * \uAE4A\uC740 \uBCF5\uC0AC\n * - \uC21C\uD658 \uCC38\uC870 \uC9C0\uC6D0\n * - \uCEE4\uC2A4\uD140 \uD0C0\uC785(DateTime, DateOnly, Time, Uuid, Uint8Array) \uBCF5\uC0AC \uC9C0\uC6D0\n *\n * @note \uD568\uC218, Symbol\uC740 \uBCF5\uC0AC\uB418\uC9C0 \uC54A\uACE0 \uCC38\uC870\uAC00 \uC720\uC9C0\uB428\n * @note WeakMap, WeakSet\uC740 \uC9C0\uC6D0\uB418\uC9C0 \uC54A\uC74C (\uC77C\uBC18 \uAC1D\uCCB4\uB85C \uBCF5\uC0AC\uB418\uC5B4 \uBE48 \uAC1D\uCCB4\uAC00 \uB428)\n * @note \uD504\uB85C\uD1A0\uD0C0\uC785 \uCCB4\uC778\uC740 \uC720\uC9C0\uB428 (Object.setPrototypeOf \uC0AC\uC6A9)\n * @note getter/setter\uB294 \uD604\uC7AC \uAC12\uC73C\uB85C \uD3C9\uAC00\uB418\uC5B4 \uBCF5\uC0AC\uB428 (\uC811\uADFC\uC790 \uC18D\uC131 \uC790\uCCB4\uB294 \uBCF5\uC0AC\uB418\uC9C0 \uC54A\uC74C)\n */\nexport function objClone<T>(source: T): T {\n  return objCloneImpl(source) as T;\n}\n\nfunction objCloneImpl(source: unknown, prevClones?: WeakMap<object, unknown>): unknown {\n  // primitive\uB294 \uADF8\uB300\uB85C \uBC18\uD658\n  if (typeof source !== \"object\" || source === null) {\n    return source;\n  }\n\n  // Immutable-like \uD0C0\uC785\uB4E4 (\uB0B4\uBD80\uC5D0 object \uCC38\uC870 \uC5C6\uC74C)\n  if (source instanceof Date) {\n    return new Date(source.getTime());\n  }\n\n  if (source instanceof DateTime) {\n    return new DateTime(source.tick);\n  }\n\n  if (source instanceof DateOnly) {\n    return new DateOnly(source.tick);\n  }\n\n  if (source instanceof Time) {\n    return new Time(source.tick);\n  }\n\n  if (source instanceof Uuid) {\n    return new Uuid(source.toString());\n  }\n\n  // RegExp\n  if (source instanceof RegExp) {\n    return new RegExp(source.source, source.flags);\n  }\n\n  // \uC21C\uD658 \uCC38\uC870 \uCCB4\uD06C (Error \uD3EC\uD568 \uBAA8\uB4E0 object \uD0C0\uC785\uC5D0 \uC801\uC6A9)\n  const currPrevClones = prevClones ?? new WeakMap<object, unknown>();\n  if (currPrevClones.has(source)) {\n    return currPrevClones.get(source);\n  }\n\n  // Error (cause \uD3EC\uD568)\n  // \uC0DD\uC131\uC790 \uD638\uCD9C \uB300\uC2E0 \uD504\uB85C\uD1A0\uD0C0\uC785 \uAE30\uBC18 \uBCF5\uC0AC - \uCEE4\uC2A4\uD140 Error \uD074\uB798\uC2A4 \uD638\uD658\uC131 \uBCF4\uC7A5\n  if (source instanceof Error) {\n    const cloned = Object.create(Object.getPrototypeOf(source)) as Error;\n    currPrevClones.set(source, cloned);\n    cloned.message = source.message;\n    cloned.name = source.name;\n    cloned.stack = source.stack;\n    if (source.cause !== undefined) {\n      cloned.cause = objCloneImpl(source.cause, currPrevClones);\n    }\n    // \uCEE4\uC2A4\uD140 Error \uC18D\uC131 \uBCF5\uC0AC\n    for (const key of Object.keys(source)) {\n      if (![\"message\", \"name\", \"stack\", \"cause\"].includes(key)) {\n        (cloned as unknown as Record<string, unknown>)[key] = objCloneImpl(\n          (source as unknown as Record<string, unknown>)[key],\n          currPrevClones,\n        );\n      }\n    }\n    return cloned;\n  }\n\n  if (source instanceof Uint8Array) {\n    const result = source.slice();\n    currPrevClones.set(source, result);\n    return result;\n  }\n\n  if (source instanceof Array) {\n    const result: unknown[] = [];\n    currPrevClones.set(source, result);\n    for (const item of source) {\n      result.push(objCloneImpl(item, currPrevClones));\n    }\n    return result;\n  }\n\n  if (source instanceof Map) {\n    const result = new Map();\n    currPrevClones.set(source, result);\n    for (const [key, value] of source) {\n      result.set(objCloneImpl(key, currPrevClones), objCloneImpl(value, currPrevClones));\n    }\n    return result;\n  }\n\n  if (source instanceof Set) {\n    const result = new Set();\n    currPrevClones.set(source, result);\n    for (const item of source) {\n      result.add(objCloneImpl(item, currPrevClones));\n    }\n    return result;\n  }\n\n  // \uAE30\uD0C0 Object\n  const result: Record<string, unknown> = {};\n  Object.setPrototypeOf(result, Object.getPrototypeOf(source));\n  currPrevClones.set(source, result);\n\n  for (const key of Object.keys(source)) {\n    const value = (source as Record<string, unknown>)[key];\n    result[key] = objCloneImpl(value, currPrevClones);\n  }\n\n  return result;\n}\n\n//#endregion\n\n//#region objEqual\n\n/** objEqual \uC635\uC158 \uD0C0\uC785 */\nexport interface EqualOptions {\n  /** \uBE44\uAD50\uD560 \uD0A4 \uBAA9\uB85D. \uC9C0\uC815 \uC2DC \uD574\uB2F9 \uD0A4\uB9CC \uBE44\uAD50 (\uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9) */\n  topLevelIncludes?: string[];\n  /** \uBE44\uAD50\uC5D0\uC11C \uC81C\uC678\uD560 \uD0A4 \uBAA9\uB85D (\uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9) */\n  topLevelExcludes?: string[];\n  /** \uBC30\uC5F4 \uC21C\uC11C \uBB34\uC2DC \uC5EC\uBD80. true \uC2DC O(n\u00B2) \uBCF5\uC7A1\uB3C4 */\n  ignoreArrayIndex?: boolean;\n  /** \uC595\uC740 \uBE44\uAD50 \uC5EC\uBD80. true \uC2DC 1\uB2E8\uACC4\uB9CC \uBE44\uAD50 (\uCC38\uC870 \uBE44\uAD50) */\n  onlyOneDepth?: boolean;\n}\n\n/**\n * \uAE4A\uC740 \uBE44\uAD50\n *\n * @param source \uBE44\uAD50 \uB300\uC0C1 1\n * @param target \uBE44\uAD50 \uB300\uC0C1 2\n * @param options \uBE44\uAD50 \uC635\uC158\n * @param options.topLevelIncludes \uBE44\uAD50\uD560 \uD0A4 \uBAA9\uB85D. \uC9C0\uC815 \uC2DC \uD574\uB2F9 \uD0A4\uB9CC \uBE44\uAD50 (\uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9)\n *   @example `{ topLevelIncludes: [\"id\", \"name\"] }` - id, name \uD0A4\uB9CC \uBE44\uAD50\n * @param options.topLevelExcludes \uBE44\uAD50\uC5D0\uC11C \uC81C\uC678\uD560 \uD0A4 \uBAA9\uB85D (\uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9)\n *   @example `{ topLevelExcludes: [\"updatedAt\"] }` - updatedAt \uD0A4\uB97C \uC81C\uC678\uD558\uACE0 \uBE44\uAD50\n * @param options.ignoreArrayIndex \uBC30\uC5F4 \uC21C\uC11C \uBB34\uC2DC \uC5EC\uBD80. true \uC2DC O(n\u00B2) \uBCF5\uC7A1\uB3C4\n * @param options.onlyOneDepth \uC595\uC740 \uBE44\uAD50 \uC5EC\uBD80. true \uC2DC 1\uB2E8\uACC4\uB9CC \uBE44\uAD50 (\uCC38\uC870 \uBE44\uAD50)\n *\n * @note topLevelIncludes/topLevelExcludes \uC635\uC158\uC740 object \uC18D\uC131 \uD0A4\uC5D0\uB9CC \uC801\uC6A9\uB428.\n *       Map\uC758 \uBAA8\uB4E0 \uD0A4\uB294 \uD56D\uC0C1 \uBE44\uAD50\uC5D0 \uD3EC\uD568\uB428.\n * @note \uC131\uB2A5 \uACE0\uB824\uC0AC\uD56D:\n * - \uAE30\uBCF8 \uBC30\uC5F4 \uBE44\uAD50: O(n) \uC2DC\uAC04 \uBCF5\uC7A1\uB3C4\n * - `ignoreArrayIndex: true` \uC0AC\uC6A9 \uC2DC: O(n\u00B2) \uC2DC\uAC04 \uBCF5\uC7A1\uB3C4\n *   (\uB300\uC6A9\uB7C9 \uBC30\uC5F4\uC5D0\uC11C \uC131\uB2A5 \uC800\uD558 \uAC00\uB2A5)\n * @note `ignoreArrayIndex: true` \uB3D9\uC791 \uD2B9\uC131:\n * - \uBC30\uC5F4 \uC21C\uC11C\uB97C \uBB34\uC2DC\uD558\uACE0 \uB3D9\uC77C\uD55C \uC694\uC18C\uB4E4\uC758 \uC21C\uC5F4\uC778\uC9C0 \uBE44\uAD50\n * - \uC608: `[1,2,3]`\uACFC `[3,2,1]` \u2192 true, `[1,1,1]`\uACFC `[1,2,3]` \u2192 false\n */\nexport function objEqual(source: unknown, target: unknown, options?: EqualOptions): boolean {\n  if (source === target) return true;\n  if (source == null || target == null) return false;\n  if (typeof source !== typeof target) return false;\n\n  if (source instanceof Date && target instanceof Date) {\n    return source.getTime() === target.getTime();\n  }\n\n  if (\n    (source instanceof DateTime && target instanceof DateTime) ||\n    (source instanceof DateOnly && target instanceof DateOnly) ||\n    (source instanceof Time && target instanceof Time)\n  ) {\n    return source.tick === target.tick;\n  }\n\n  if (source instanceof Uuid && target instanceof Uuid) {\n    return source.toString() === target.toString();\n  }\n\n  if (source instanceof RegExp && target instanceof RegExp) {\n    return source.source === target.source && source.flags === target.flags;\n  }\n\n  if (source instanceof Array && target instanceof Array) {\n    return objEqualArray(source, target, options);\n  }\n\n  if (source instanceof Map && target instanceof Map) {\n    return objEqualMap(source, target, options);\n  }\n\n  if (source instanceof Set && target instanceof Set) {\n    return objEqualSet(source, target, options);\n  }\n\n  if (typeof source === \"object\" && typeof target === \"object\") {\n    return objEqualObject(source as Record<string, unknown>, target as Record<string, unknown>, options);\n  }\n\n  return false;\n}\n\nfunction objEqualArray(source: unknown[], target: unknown[], options?: EqualOptions): boolean {\n  if (source.length !== target.length) {\n    return false;\n  }\n\n  if (options?.ignoreArrayIndex) {\n    const matchedIndices = new Set<number>();\n\n    if (options.onlyOneDepth) {\n      return source.every((sourceItem) => {\n        const idx = target.findIndex((t, i) => !matchedIndices.has(i) && t === sourceItem);\n        if (idx !== -1) {\n          matchedIndices.add(idx);\n          return true;\n        }\n        return false;\n      });\n    } else {\n      // \uC7AC\uADC0 \uD638\uCD9C \uC2DC topLevelIncludes/topLevelExcludes \uC635\uC158\uC740 \uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9\uB418\uBBC0\uB85C \uC81C\uC678\n      const recursiveOptions = { ignoreArrayIndex: options.ignoreArrayIndex, onlyOneDepth: options.onlyOneDepth };\n      return source.every((sourceItem) => {\n        const idx = target.findIndex((t, i) => !matchedIndices.has(i) && objEqual(t, sourceItem, recursiveOptions));\n        if (idx !== -1) {\n          matchedIndices.add(idx);\n          return true;\n        }\n        return false;\n      });\n    }\n  } else {\n    if (options?.onlyOneDepth) {\n      for (let i = 0; i < source.length; i++) {\n        if (source[i] !== target[i]) {\n          return false;\n        }\n      }\n    } else {\n      // \uC7AC\uADC0 \uD638\uCD9C \uC2DC topLevelIncludes/topLevelExcludes \uC635\uC158\uC740 \uCD5C\uC0C1\uC704 \uB808\uBCA8\uC5D0\uB9CC \uC801\uC6A9\uB418\uBBC0\uB85C \uC81C\uC678\n      for (let i = 0; i < source.length; i++) {\n        if (\n          !objEqual(source[i], target[i], {\n            ignoreArrayIndex: options?.ignoreArrayIndex,\n            onlyOneDepth: options?.onlyOneDepth,\n          })\n        ) {\n          return false;\n        }\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Map \uAC1D\uCCB4 \uBE44\uAD50\n * @note \uBE44\uBB38\uC790\uC5F4 \uD0A4(\uAC1D\uCCB4, \uBC30\uC5F4 \uB4F1) \uCC98\uB9AC \uC2DC O(n\u00B2) \uBCF5\uC7A1\uB3C4 \uBC1C\uC0DD\n * @note \uB300\uB7C9 \uB370\uC774\uD130\uC758 \uACBD\uC6B0 onlyOneDepth: true \uC635\uC158 \uC0AC\uC6A9 \uAD8C\uC7A5 (\uCC38\uC870 \uBE44\uAD50\uB85C O(n)\uC73C\uB85C \uAC1C\uC120)\n */\nfunction objEqualMap(source: Map<unknown, unknown>, target: Map<unknown, unknown>, options?: EqualOptions): boolean {\n  // Map \uBE44\uAD50 \uC2DC topLevelIncludes/topLevelExcludes \uC635\uC158\uC740 \uBB34\uC2DC\uB428 (object \uC18D\uC131 \uD0A4\uC5D0\uB9CC \uC801\uC6A9)\n  const sourceKeys = Array.from(source.keys()).filter((key) => source.get(key) != null);\n  const targetKeys = Array.from(target.keys()).filter((key) => target.get(key) != null);\n\n  if (sourceKeys.length !== targetKeys.length) {\n    return false;\n  }\n\n  const usedTargetKeys = new Set<number>();\n  for (const sourceKey of sourceKeys) {\n    // \uBB38\uC790\uC5F4 \uD0A4: \uC9C1\uC811 \uBE44\uAD50\n    if (typeof sourceKey === \"string\") {\n      const sourceValue = source.get(sourceKey);\n      const targetValue = target.get(sourceKey);\n      if (options?.onlyOneDepth) {\n        if (sourceValue !== targetValue) return false;\n      } else {\n        if (\n          !objEqual(sourceValue, targetValue, {\n            ignoreArrayIndex: options?.ignoreArrayIndex,\n            onlyOneDepth: options?.onlyOneDepth,\n          })\n        ) {\n          return false;\n        }\n      }\n    } else {\n      // \uBE44\uBB38\uC790\uC5F4 \uD0A4: targetKeys\uC5D0\uC11C \uB3D9\uB4F1\uD55C \uD0A4 \uCC3E\uAE30\n      let found = false;\n      for (let i = 0; i < targetKeys.length; i++) {\n        const targetKey = targetKeys[i];\n        if (typeof targetKey === \"string\" || usedTargetKeys.has(i)) continue;\n        if (options?.onlyOneDepth ? sourceKey === targetKey : objEqual(sourceKey, targetKey)) {\n          usedTargetKeys.add(i);\n          const sourceValue = source.get(sourceKey);\n          const targetValue = target.get(targetKey);\n          if (options?.onlyOneDepth) {\n            if (sourceValue !== targetValue) return false;\n          } else {\n            if (\n              !objEqual(sourceValue, targetValue, {\n                ignoreArrayIndex: options?.ignoreArrayIndex,\n                onlyOneDepth: options?.onlyOneDepth,\n              })\n            ) {\n              return false;\n            }\n          }\n          found = true;\n          break;\n        }\n      }\n      if (!found) return false;\n    }\n  }\n\n  return true;\n}\n\nfunction objEqualObject(\n  source: Record<string, unknown>,\n  target: Record<string, unknown>,\n  options?: EqualOptions,\n): boolean {\n  const sourceKeys = Object.keys(source).filter(\n    (key) =>\n      (options?.topLevelIncludes === undefined || options.topLevelIncludes.includes(key)) &&\n      !options?.topLevelExcludes?.includes(key) &&\n      source[key] != null,\n  );\n  const targetKeys = Object.keys(target).filter(\n    (key) =>\n      (options?.topLevelIncludes === undefined || options.topLevelIncludes.includes(key)) &&\n      !options?.topLevelExcludes?.includes(key) &&\n      target[key] != null,\n  );\n\n  if (sourceKeys.length !== targetKeys.length) {\n    return false;\n  }\n\n  for (const key of sourceKeys) {\n    if (options?.onlyOneDepth) {\n      if (source[key] !== target[key]) {\n        return false;\n      }\n    } else {\n      if (\n        !objEqual(source[key], target[key], {\n          ignoreArrayIndex: options?.ignoreArrayIndex,\n        })\n      ) {\n        return false;\n      }\n    }\n  }\n\n  return true;\n}\n\n/**\n * Set \uAE4A\uC740 \uBE44\uAD50\n * @note deep equal \uBE44\uAD50(`onlyOneDepth: false`)\uB294 O(n\u00B2) \uC2DC\uAC04 \uBCF5\uC7A1\uB3C4\uB97C \uAC00\uC9D0.\n *   primitive Set\uC774\uB098 \uC131\uB2A5\uC774 \uC911\uC694\uD55C \uACBD\uC6B0 `onlyOneDepth: true` \uC0AC\uC6A9 \uAD8C\uC7A5\n */\nfunction objEqualSet(source: Set<unknown>, target: Set<unknown>, options?: EqualOptions): boolean {\n  if (source.size !== target.size) {\n    return false;\n  }\n\n  if (options?.onlyOneDepth) {\n    for (const sourceItem of source) {\n      if (!target.has(sourceItem)) {\n        return false;\n      }\n    }\n  } else {\n    // deep equal: target \uBC30\uC5F4\uC744 \uB8E8\uD504 \uC678\uBD80\uC5D0\uC11C 1\uD68C\uB9CC \uC0DD\uC131\n    // \uB9E4\uCE6D\uB41C \uC778\uB371\uC2A4\uB97C \uCD94\uC801\uD558\uC5EC \uC911\uBCF5 \uB9E4\uCE6D \uBC29\uC9C0\n    const targetArr = [...target];\n    const matchedIndices = new Set<number>();\n    for (const sourceItem of source) {\n      const idx = targetArr.findIndex((t, i) => !matchedIndices.has(i) && objEqual(sourceItem, t, options));\n      if (idx === -1) {\n        return false;\n      }\n      matchedIndices.add(idx);\n    }\n  }\n\n  return true;\n}\n\n//#endregion\n\n//#region objMerge\n\n/** objMerge \uC635\uC158 \uD0C0\uC785 */\nexport interface ObjMergeOptions {\n  /** \uBC30\uC5F4 \uCC98\uB9AC \uBC29\uC2DD. \"replace\": target\uC73C\uB85C \uB300\uCCB4(\uAE30\uBCF8), \"concat\": \uD569\uCE68(\uC911\uBCF5 \uC81C\uAC70) */\n  arrayProcess?: \"replace\" | \"concat\";\n  /** target\uC774 null\uC77C \uB54C \uD574\uB2F9 \uD0A4 \uC0AD\uC81C \uC5EC\uBD80 */\n  useDelTargetNull?: boolean;\n}\n\n/**\n * \uAE4A\uC740 \uBCD1\uD569 (source\uB97C base\uB85C target\uC744 \uBCD1\uD569)\n *\n * @param source \uAE30\uC900 \uAC1D\uCCB4\n * @param target \uBCD1\uD569\uD560 \uAC1D\uCCB4\n * @param opt \uBCD1\uD569 \uC635\uC158\n * @param opt.arrayProcess \uBC30\uC5F4 \uCC98\uB9AC \uBC29\uC2DD\n *   - `\"replace\"`: target \uBC30\uC5F4\uB85C \uB300\uCCB4 (\uAE30\uBCF8\uAC12)\n *   - `\"concat\"`: source\uC640 target \uBC30\uC5F4\uC744 \uD569\uCE68 (Set\uC73C\uB85C \uC911\uBCF5 \uC81C\uAC70)\n * @param opt.useDelTargetNull target \uAC12\uC774 null\uC77C \uB54C \uD574\uB2F9 \uD0A4 \uC0AD\uC81C \uC5EC\uBD80\n *   - `true`: target\uC774 null\uC774\uBA74 \uACB0\uACFC\uC5D0\uC11C \uD574\uB2F9 \uD0A4 \uC0AD\uC81C\n *   - `false` \uB610\uB294 \uBBF8\uC9C0\uC815: source \uAC12 \uC720\uC9C0\n *\n * @note \uC6D0\uBCF8 \uAC1D\uCCB4\uB97C \uC218\uC815\uD558\uC9C0 \uC54A\uACE0 \uC0C8 \uAC1D\uCCB4\uB97C \uBC18\uD658\uD568 (\uBD88\uBCC0\uC131 \uBCF4\uC7A5)\n * @note arrayProcess=\"concat\" \uC0AC\uC6A9 \uC2DC Set\uC744 \uD1B5\uD574 \uC911\uBCF5\uC744 \uC81C\uAC70\uD558\uBA70,\n *       \uAC1D\uCCB4 \uBC30\uC5F4\uC758 \uACBD\uC6B0 \uCC38\uC870(\uC8FC\uC18C) \uBE44\uAD50\uB85C \uC911\uBCF5\uC744 \uD310\uB2E8\uD568\n * @note \uD0C0\uC785\uC774 \uB2E4\uB978 \uACBD\uC6B0 target \uAC12\uC73C\uB85C \uB36E\uC5B4\uC500\n */\nexport function objMerge<T, P>(source: T, target: P, opt?: ObjMergeOptions): T & P {\n  if (source == null) {\n    return objClone(target) as T & P;\n  }\n\n  if (target === undefined) {\n    return objClone(source) as T & P;\n  }\n\n  if (target === null) {\n    return opt?.useDelTargetNull ? (undefined as T & P) : (objClone(source) as T & P);\n  }\n\n  if (typeof target !== \"object\") {\n    return target as T & P;\n  }\n\n  if (\n    target instanceof Date ||\n    target instanceof DateTime ||\n    target instanceof DateOnly ||\n    target instanceof Time ||\n    target instanceof Uuid ||\n    target instanceof Uint8Array ||\n    (opt?.arrayProcess === \"replace\" && target instanceof Array)\n  ) {\n    return objClone(target) as T & P;\n  }\n\n  // source\uAC00 object\uAC00 \uC544\uB2C8\uAC70\uB098, source\uC640 target\uC774 \uB2E4\uB978 \uC885\uB958\uC758 object\uBA74 target\uC73C\uB85C \uB36E\uC5B4\uC500\n  if (typeof source !== \"object\" || source.constructor !== target.constructor) {\n    return objClone(target) as T & P;\n  }\n\n  if (source instanceof Map && target instanceof Map) {\n    const result = objClone(source);\n    for (const key of target.keys()) {\n      if (result.has(key)) {\n        result.set(key, objMerge(result.get(key), target.get(key), opt));\n      } else {\n        result.set(key, objClone(target.get(key)));\n      }\n    }\n    return result as T & P;\n  }\n\n  if (opt?.arrayProcess === \"concat\" && source instanceof Array && target instanceof Array) {\n    let result = [...new Set([...source, ...target])];\n    if (opt.useDelTargetNull) {\n      result = result.filter((item) => item !== null);\n    }\n    return result as T & P;\n  }\n\n  const sourceRec = source as Record<string, unknown>;\n  const targetRec = target as Record<string, unknown>;\n  const resultRec = objClone(sourceRec);\n  for (const key of Object.keys(target)) {\n    resultRec[key] = objMerge(sourceRec[key], targetRec[key], opt);\n    if (resultRec[key] === undefined) {\n      delete resultRec[key];\n    }\n  }\n\n  return resultRec as T & P;\n}\n\n/** merge3 \uC635\uC158 \uD0C0\uC785 */\nexport interface ObjMerge3KeyOptions {\n  /** \uBE44\uAD50\uD560 \uD558\uC704 \uD0A4 \uBAA9\uB85D (equal\uC758 topLevelIncludes\uC640 \uB3D9\uC77C) */\n  keys?: string[];\n  /** \uBE44\uAD50\uC5D0\uC11C \uC81C\uC678\uD560 \uD558\uC704 \uD0A4 \uBAA9\uB85D */\n  excludes?: string[];\n  /** \uBC30\uC5F4 \uC21C\uC11C \uBB34\uC2DC \uC5EC\uBD80 */\n  ignoreArrayIndex?: boolean;\n}\n\n/**\n * 3-way \uBCD1\uD569\n *\n * source, origin, target \uC138 \uAC1D\uCCB4\uB97C \uBE44\uAD50\uD558\uC5EC \uBCD1\uD569\uD569\uB2C8\uB2E4.\n * - source\uC640 origin\uC774 \uAC19\uACE0 target\uC774 \uB2E4\uB974\uBA74 \u2192 target \uAC12 \uC0AC\uC6A9\n * - target\uACFC origin\uC774 \uAC19\uACE0 source\uAC00 \uB2E4\uB974\uBA74 \u2192 source \uAC12 \uC0AC\uC6A9\n * - source\uC640 target\uC774 \uAC19\uC73C\uBA74 \u2192 \uD574\uB2F9 \uAC12 \uC0AC\uC6A9\n * - \uC138 \uAC12\uC774 \uBAA8\uB450 \uB2E4\uB974\uBA74 \u2192 \uCDA9\uB3CC \uBC1C\uC0DD (origin \uAC12 \uC720\uC9C0)\n *\n * @param source \uBCC0\uACBD\uB41C \uBC84\uC804 1\n * @param origin \uAE30\uC900 \uBC84\uC804 (\uACF5\uD1B5 \uC870\uC0C1)\n * @param target \uBCC0\uACBD\uB41C \uBC84\uC804 2\n * @param optionsObj \uD0A4\uBCC4 \uBE44\uAD50 \uC635\uC158. \uAC01 \uD0A4\uC5D0 \uB300\uD574 equal() \uBE44\uAD50 \uC635\uC158\uC744 \uAC1C\uBCC4 \uC9C0\uC815\n *   - `keys`: \uBE44\uAD50\uD560 \uD558\uC704 \uD0A4 \uBAA9\uB85D (equal\uC758 topLevelIncludes\uC640 \uB3D9\uC77C)\n *   - `excludes`: \uBE44\uAD50\uC5D0\uC11C \uC81C\uC678\uD560 \uD558\uC704 \uD0A4 \uBAA9\uB85D\n *   - `ignoreArrayIndex`: \uBC30\uC5F4 \uC21C\uC11C \uBB34\uC2DC \uC5EC\uBD80\n * @returns conflict: \uCDA9\uB3CC \uBC1C\uC0DD \uC5EC\uBD80, result: \uBCD1\uD569 \uACB0\uACFC\n *\n * @example\n * const { conflict, result } = merge3(\n *   { a: 1, b: 2 },  // source\n *   { a: 1, b: 1 },  // origin\n *   { a: 2, b: 1 },  // target\n * );\n * // conflict: false, result: { a: 2, b: 2 }\n */\nexport function objMerge3<\n  S extends Record<string, unknown>,\n  O extends Record<string, unknown>,\n  T extends Record<string, unknown>,\n>(\n  source: S,\n  origin: O,\n  target: T,\n  optionsObj?: Record<string, ObjMerge3KeyOptions>,\n): {\n  conflict: boolean;\n  result: O & S & T;\n} {\n  let conflict = false;\n  const result = objClone(origin) as Record<string, unknown>;\n  const allKeys = new Set([...Object.keys(source), ...Object.keys(target), ...Object.keys(origin)]);\n  for (const key of allKeys) {\n    if (objEqual(source[key], result[key], optionsObj?.[key])) {\n      result[key] = objClone(target[key]);\n    } else if (objEqual(target[key], result[key], optionsObj?.[key])) {\n      result[key] = objClone(source[key]);\n    } else if (objEqual(source[key], target[key], optionsObj?.[key])) {\n      result[key] = objClone(source[key]);\n    } else {\n      conflict = true;\n    }\n  }\n\n  return {\n    conflict,\n    result: result as O & S & T,\n  };\n}\n\n//#endregion\n\n//#region objOmit / objPick\n\n/**\n * \uAC1D\uCCB4\uC5D0\uC11C \uD2B9\uC815 \uD0A4\uB4E4\uC744 \uC81C\uC678\n * @param item \uC6D0\uBCF8 \uAC1D\uCCB4\n * @param omitKeys \uC81C\uC678\uD560 \uD0A4 \uBC30\uC5F4\n * @returns \uC9C0\uC815\uB41C \uD0A4\uAC00 \uC81C\uC678\uB41C \uC0C8 \uAC1D\uCCB4\n * @example\n * const user = { name: \"Alice\", age: 30, email: \"alice@example.com\" };\n * objOmit(user, [\"email\"]);\n * // { name: \"Alice\", age: 30 }\n */\nexport function objOmit<T extends Record<string, unknown>, K extends keyof T>(item: T, omitKeys: K[]): Omit<T, K> {\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(item)) {\n    if (!omitKeys.includes(key as K)) {\n      result[key] = item[key];\n    }\n  }\n  return result as Omit<T, K>;\n}\n\n/**\n * \uC870\uAC74\uC5D0 \uB9DE\uB294 \uD0A4\uB4E4\uC744 \uC81C\uC678\n * @internal\n * @param item \uC6D0\uBCF8 \uAC1D\uCCB4\n * @param omitKeyFn \uD0A4\uB97C \uBC1B\uC544 \uC81C\uC678 \uC5EC\uBD80\uB97C \uBC18\uD658\uD558\uB294 \uD568\uC218 (true\uBA74 \uC81C\uC678)\n * @returns \uC870\uAC74\uC5D0 \uB9DE\uB294 \uD0A4\uAC00 \uC81C\uC678\uB41C \uC0C8 \uAC1D\uCCB4\n * @example\n * const data = { name: \"Alice\", _internal: \"secret\", age: 30 };\n * objOmitByFilter(data, (key) => key.startsWith(\"_\"));\n * // { name: \"Alice\", age: 30 }\n */\nexport function objOmitByFilter<T extends Record<string, unknown>>(item: T, omitKeyFn: (key: keyof T) => boolean): T {\n  const result: Record<string, unknown> = {};\n  for (const key of Object.keys(item)) {\n    if (!omitKeyFn(key)) {\n      result[key] = item[key];\n    }\n  }\n  return result as T;\n}\n\n/**\n * \uAC1D\uCCB4\uC5D0\uC11C \uD2B9\uC815 \uD0A4\uB4E4\uB9CC \uC120\uD0DD\n * @param item \uC6D0\uBCF8 \uAC1D\uCCB4\n * @param keys \uC120\uD0DD\uD560 \uD0A4 \uBC30\uC5F4\n * @returns \uC9C0\uC815\uB41C \uD0A4\uB9CC \uD3EC\uD568\uB41C \uC0C8 \uAC1D\uCCB4\n * @example\n * const user = { name: \"Alice\", age: 30, email: \"alice@example.com\" };\n * objPick(user, [\"name\", \"age\"]);\n * // { name: \"Alice\", age: 30 }\n */\nexport function objPick<T extends Record<string, unknown>, K extends keyof T>(item: T, keys: K[]): Pick<T, K> {\n  const result: Record<string, unknown> = {};\n  for (const key of keys) {\n    result[key as string] = item[key];\n  }\n  return result as Pick<T, K>;\n}\n\n//#endregion\n\n//#region objGetChainValue / objSetChainValue / objDeleteChainValue\n\n// \uC815\uADDC\uC2DD \uCE90\uC2F1 (\uBAA8\uB4C8 \uB85C\uB4DC \uC2DC 1\uD68C\uB9CC \uC0DD\uC131)\nconst chainSplitRegex = /[.[\\]]/g;\nconst chainCleanRegex = /[?!'\"]/g;\nconst chainNumericRegex = /^[0-9]*$/;\n\nfunction getChainSplits(chain: string): (string | number)[] {\n  const split = chain\n    .split(chainSplitRegex)\n    .map((item) => item.replace(chainCleanRegex, \"\"))\n    .filter((item) => Boolean(item));\n  const result: (string | number)[] = [];\n  for (const splitItem of split) {\n    if (chainNumericRegex.test(splitItem)) {\n      result.push(Number.parseInt(splitItem));\n    } else {\n      result.push(splitItem);\n    }\n  }\n\n  return result;\n}\n\n/**\n * \uCCB4\uC778 \uACBD\uB85C\uB85C \uAC12 \uAC00\uC838\uC624\uAE30\n * @example objGetChainValue(obj, \"a.b[0].c\")\n */\nexport function objGetChainValue(obj: unknown, chain: string, optional: true): unknown | undefined;\nexport function objGetChainValue(obj: unknown, chain: string): unknown;\nexport function objGetChainValue(obj: unknown, chain: string, optional?: true): unknown | undefined {\n  const splits = getChainSplits(chain);\n  let result: unknown = obj;\n  for (const splitItem of splits) {\n    if (optional && result === undefined) {\n      result = undefined;\n    } else {\n      result = (result as Record<string | number, unknown>)[splitItem];\n    }\n  }\n  return result;\n}\n\n/**\n * depth\uB9CC\uD07C \uAC19\uC740 \uD0A4\uB85C \uB0B4\uB824\uAC00\uAE30\n * @internal\n * @param obj \uB300\uC0C1 \uAC1D\uCCB4\n * @param key \uB0B4\uB824\uAC08 \uD0A4\n * @param depth \uB0B4\uB824\uAC08 \uAE4A\uC774 (1 \uC774\uC0C1)\n * @param optional true\uBA74 \uC911\uAC04\uC5D0 null/undefined\uAC00 \uC788\uC5B4\uB3C4 \uC5D0\uB7EC \uC5C6\uC774 undefined \uBC18\uD658\n * @throws ArgumentError depth\uAC00 1 \uBBF8\uB9CC\uC77C \uACBD\uC6B0\n * @example objGetChainValueByDepth({ parent: { parent: { name: 'a' } } }, 'parent', 2) => { name: 'a' }\n */\nexport function objGetChainValueByDepth<T, K extends keyof T>(\n  obj: T,\n  key: K,\n  depth: number,\n  optional: true,\n): T[K] | undefined;\nexport function objGetChainValueByDepth<T, K extends keyof T>(obj: T, key: K, depth: number): T[K];\nexport function objGetChainValueByDepth<T, K extends keyof T>(\n  obj: T,\n  key: K,\n  depth: number,\n  optional?: true,\n): T[K] | undefined {\n  if (depth < 1) {\n    throw new ArgumentError(\"depth\uB294 1 \uC774\uC0C1\uC774\uC5B4\uC57C \uD569\uB2C8\uB2E4.\", { depth });\n  }\n  let result: unknown = obj;\n  for (let i = 0; i < depth; i++) {\n    if (optional && result == null) {\n      result = undefined;\n    } else {\n      result = (result as Record<string, unknown>)[key as string];\n    }\n  }\n  return result as T[K] | undefined;\n}\n\n/**\n * \uCCB4\uC778 \uACBD\uB85C\uB85C \uAC12 \uC124\uC815\n * @example objSetChainValue(obj, \"a.b[0].c\", value)\n */\nexport function objSetChainValue(obj: unknown, chain: string, value: unknown): void {\n  const splits = getChainSplits(chain);\n  if (splits.length === 0) {\n    throw new ArgumentError(\"\uCCB4\uC778\uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.\", { chain });\n  }\n\n  let curr: Record<string | number, unknown> = obj as Record<string | number, unknown>;\n  for (const splitItem of splits.slice(0, -1)) {\n    curr[splitItem] = curr[splitItem] ?? {};\n    curr = curr[splitItem] as Record<string | number, unknown>;\n  }\n\n  const last = splits[splits.length - 1];\n  curr[last] = value;\n}\n\n/**\n * \uCCB4\uC778 \uACBD\uB85C\uC758 \uAC12 \uC0AD\uC81C\n * @example objDeleteChainValue(obj, \"a.b[0].c\")\n */\nexport function objDeleteChainValue(obj: unknown, chain: string): void {\n  const splits = getChainSplits(chain);\n  if (splits.length === 0) {\n    throw new ArgumentError(\"\uCCB4\uC778\uC774 \uBE44\uC5B4\uC788\uC2B5\uB2C8\uB2E4.\", { chain });\n  }\n\n  let curr: Record<string | number, unknown> = obj as Record<string | number, unknown>;\n  for (const splitItem of splits.slice(0, -1)) {\n    const next = curr[splitItem];\n    // \uC911\uAC04 \uACBD\uB85C\uAC00 \uC5C6\uC73C\uBA74 \uC870\uC6A9\uD788 \uB9AC\uD134 (\uC0AD\uC81C\uD560 \uAC83\uC774 \uC5C6\uC74C)\n    if (next == null || typeof next !== \"object\") {\n      return;\n    }\n    curr = next as Record<string | number, unknown>;\n  }\n\n  const last = splits[splits.length - 1];\n  delete curr[last];\n}\n\n//#endregion\n\n//#region objClearUndefined / objClear / objNullToUndefined / objUnflatten\n\n/**\n * \uAC1D\uCCB4\uC5D0\uC11C undefined \uAC12\uC744 \uAC00\uC9C4 \uD0A4 \uC0AD\uC81C\n * @internal\n *\n * @mutates \uC6D0\uBCF8 \uAC1D\uCCB4\uB97C \uC9C1\uC811 \uC218\uC815\uD568\n */\nexport function objClearUndefined<T extends object>(obj: T): T {\n  const record = obj as Record<string, unknown>;\n  for (const key of Object.keys(record)) {\n    if (record[key] === undefined) {\n      delete record[key];\n    }\n  }\n  return obj;\n}\n\n/**\n * \uAC1D\uCCB4\uC758 \uBAA8\uB4E0 \uD0A4 \uC0AD\uC81C\n * @internal\n *\n * @mutates \uC6D0\uBCF8 \uAC1D\uCCB4\uB97C \uC9C1\uC811 \uC218\uC815\uD568\n */\nexport function objClear<T extends Record<string, unknown>>(obj: T): Record<string, never> {\n  for (const key of Object.keys(obj)) {\n    delete obj[key];\n  }\n  return obj as Record<string, never>;\n}\n\n/**\n * null\uC744 undefined\uB85C \uBCC0\uD658 (\uC7AC\uADC0\uC801)\n * @internal\n *\n * @mutates \uC6D0\uBCF8 \uBC30\uC5F4/\uAC1D\uCCB4\uB97C \uC9C1\uC811 \uC218\uC815\uD568\n */\nexport function objNullToUndefined<T>(obj: T): T | undefined {\n  return objNullToUndefinedImpl(obj, new WeakSet());\n}\n\nfunction objNullToUndefinedImpl<T>(obj: T, seen: WeakSet<object>): T | undefined {\n  if (obj == null) {\n    return undefined;\n  }\n\n  if (\n    obj instanceof Date ||\n    obj instanceof DateTime ||\n    obj instanceof DateOnly ||\n    obj instanceof Time ||\n    obj instanceof Uuid\n  ) {\n    return obj;\n  }\n\n  if (obj instanceof Array) {\n    if (seen.has(obj)) return obj;\n    seen.add(obj);\n    for (let i = 0; i < obj.length; i++) {\n      obj[i] = objNullToUndefinedImpl(obj[i], seen);\n    }\n    return obj;\n  }\n\n  if (typeof obj === \"object\") {\n    if (seen.has(obj as object)) return obj;\n    seen.add(obj as object);\n    const objRec = obj as Record<string, unknown>;\n    for (const key of Object.keys(obj)) {\n      objRec[key] = objNullToUndefinedImpl(objRec[key], seen);\n    }\n\n    return obj;\n  }\n\n  return obj;\n}\n\n/**\n * flat\uB41C \uAC1D\uCCB4\uB97C nested \uAC1D\uCCB4\uB85C \uBCC0\uD658\n * @internal\n * @example objUnflatten({ \"a.b.c\": 1 }) => { a: { b: { c: 1 } } }\n */\nexport function objUnflatten(flatObj: Record<string, unknown>): Record<string, unknown> {\n  const result: Record<string, unknown> = {};\n\n  for (const key in flatObj) {\n    const parts = key.split(\".\");\n    let current: Record<string, unknown> = result;\n\n    for (let i = 0; i < parts.length; i++) {\n      const part = parts[i];\n\n      if (i === parts.length - 1) {\n        current[part] = flatObj[key];\n      } else {\n        if (!(part in current)) {\n          current[part] = {};\n        }\n        current = current[part] as Record<string, unknown>;\n      }\n    }\n  }\n\n  return result;\n}\n\n//#endregion\n\n//#region \uD0C0\uC785 \uC720\uD2F8\uB9AC\uD2F0\n\n/**\n * undefined\uB97C \uAC00\uC9C4 \uD504\uB85C\uD37C\uD2F0\uB97C optional\uB85C \uBCC0\uD658\n * @example { a: string; b: string | undefined } \u2192 { a: string; b?: string | undefined }\n */\nexport type ObjUndefToOptional<T> = {\n  [K in keyof T as undefined extends T[K] ? K : never]?: T[K];\n} & { [K in keyof T as undefined extends T[K] ? never : K]: T[K] };\n\n/**\n * optional \uD504\uB85C\uD37C\uD2F0\uB97C required + undefined \uC720\uB2C8\uC628\uC73C\uB85C \uBCC0\uD658\n * @example { a: string; b?: string } \u2192 { a: string; b: string | undefined }\n */\nexport type ObjOptionalToUndef<T> = {\n  [K in keyof T]-?: {} extends Pick<T, K> ? T[K] | undefined : T[K];\n};\n\n//#endregion\n\n/**\n * Object.keys\uC758 \uD0C0\uC785 \uC548\uC804\uD55C \uBC84\uC804\n * @param obj \uD0A4\uB97C \uCD94\uCD9C\uD560 \uAC1D\uCCB4\n * @returns \uAC1D\uCCB4\uC758 \uD0A4 \uBC30\uC5F4\n */\nexport function objKeys<T extends object>(obj: T): (keyof T)[] {\n  return Object.keys(obj) as (keyof T)[];\n}\n\n/**\n * Object.entries\uC758 \uD0C0\uC785 \uC548\uC804\uD55C \uBC84\uC804\n * @param obj \uC5D4\uD2B8\uB9AC\uB97C \uCD94\uCD9C\uD560 \uAC1D\uCCB4\n * @returns [\uD0A4, \uAC12] \uD29C\uD50C \uBC30\uC5F4\n */\nexport function objEntries<T extends object>(obj: T): ObjEntries<T> {\n  return Object.entries(obj) as ObjEntries<T>;\n}\n\n/**\n * Object.fromEntries\uC758 \uD0C0\uC785 \uC548\uC804\uD55C \uBC84\uC804\n * @param entries [\uD0A4, \uAC12] \uD29C\uD50C \uBC30\uC5F4\n * @returns \uC0DD\uC131\uB41C \uAC1D\uCCB4\n */\nexport function objFromEntries<T extends [string, unknown]>(entries: T[]): { [K in T[0]]: T[1] } {\n  return Object.fromEntries(entries) as { [K in T[0]]: T[1] };\n}\n\ntype ObjEntries<T> = { [K in keyof T]: [K, T[K]] }[keyof T][];\n\n/**\n * \uAC1D\uCCB4\uC758 \uAC01 \uC5D4\uD2B8\uB9AC\uB97C \uBCC0\uD658\uD558\uC5EC \uC0C8 \uAC1D\uCCB4 \uBC18\uD658\n * @param obj \uBCC0\uD658\uD560 \uAC1D\uCCB4\n * @param fn \uBCC0\uD658 \uD568\uC218 (key, value) => [newKey, newValue]\n * @returns \uBCC0\uD658\uB41C \uD0A4\uC640 \uAC12\uC744 \uAC00\uC9C4 \uC0C8 \uAC1D\uCCB4\n * @example\n * const colors = { primary: \"255, 0, 0\", secondary: \"0, 255, 0\" };\n *\n * // \uAC12\uB9CC \uBCC0\uD658\n * objMap(colors, (key, rgb) => [null, `rgb(${rgb})`]);\n * // { primary: \"rgb(255, 0, 0)\", secondary: \"rgb(0, 255, 0)\" }\n *\n * // \uD0A4\uC640 \uAC12 \uBAA8\uB450 \uBCC0\uD658\n * objMap(colors, (key, rgb) => [`${key}Light`, `rgb(${rgb})`]);\n * // { primaryLight: \"rgb(255, 0, 0)\", secondaryLight: \"rgb(0, 255, 0)\" }\n */\nexport function objMap<T extends object, NK extends string, NV>(\n  obj: T,\n  fn: (key: keyof T, value: T[keyof T]) => [NK | null, NV],\n): Record<NK | Extract<keyof T, string>, NV> {\n  return objMapImpl(obj, fn);\n}\n\nfunction objMapImpl<T extends object, NK extends string, NV>(\n  obj: T,\n  fn: (key: keyof T, value: T[keyof T]) => [NK | null, NV],\n): Record<string, NV> {\n  const result: Record<string, NV> = {};\n  for (const key of Object.keys(obj)) {\n    const [newKey, newValue] = fn(key as keyof T, (obj as Record<string, T[keyof T]>)[key]);\n    result[newKey ?? key] = newValue;\n  }\n  return result;\n}\n"],
+  "mappings": "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",
+  "names": ["result"]
+}

package/dist/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/utils/path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path.d.ts","sourceRoot":"","sources":["../../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"}