es-toolkit 1.10.1-dev.246 → 1.10.1-dev.248

package/dist/index.mjs

@@ -1,4 +1,5 @@
 import "./chunk-NKLIE2OI.mjs";
+import "./chunk-ARZ5BDR6.mjs";
 import "./chunk-XT74R35S.mjs";
 import {
   camelCase
@@ -35,14 +36,19 @@ import {
 import {
   isUndefined
 } from "./chunk-VH2PV426.mjs";
-import "./chunk-ARZ5BDR6.mjs";
 import {
   delay
 } from "./chunk-O64NE2P4.mjs";
-import "./chunk-OSOLEQLZ.mjs";
+import "./chunk-54TK5BIS.mjs";
+import {
+  pickBy
+} from "./chunk-6CLH5YZ2.mjs";
 import {
   clone
 } from "./chunk-U4JGKZ56.mjs";
+import {
+  get
+} from "./chunk-4RQPJUPQ.mjs";
 import {
   invert
 } from "./chunk-OLX53VEF.mjs";
@@ -55,9 +61,6 @@ import {
 import {
   pick
 } from "./chunk-HPFDYUGP.mjs";
-import {
-  pickBy
-} from "./chunk-6CLH5YZ2.mjs";
 import "./chunk-FUS75PJ7.mjs";
 import {
   sumBy
@@ -287,6 +290,7 @@ export {
   flatten,
   flattenDeep,
   forEachRight,
+  get,
   groupBy,
   head,
   inRange,

package/dist/object/get.d.mts

@@ -0,0 +1,20 @@
+/**
+ * Get a value from an object by path.
+ *
+ * This function takes an object and a path, and default value that will be returned if
+ * a returnable value about the given path does not exist.
+ *
+ * @template O - Type of the object to get value from.
+ * @template T - Type of the default value to return if the value does not exist.
+ * @param {O} obj - The object to get value from.
+ * @param {string | string[]} path - The path to get value from.
+ * @param {T} defaultValue - The default value to return if the value does not exist.
+ * @returns {O[keyof O] | undefined} - The value from the object by the given path.
+ *
+ * @example
+ * const obj = { a: { b: 3 } };
+ * get(obj, 'a.b', null); // 3
+ */
+declare function get<O, T>(obj: O, path: string | string[], defaultValue?: T): O[keyof O] | T | undefined;
+
+export { get };

package/dist/object/get.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get a value from an object by path.
+ *
+ * This function takes an object and a path, and default value that will be returned if
+ * a returnable value about the given path does not exist.
+ *
+ * @template O - Type of the object to get value from.
+ * @template T - Type of the default value to return if the value does not exist.
+ * @param {O} obj - The object to get value from.
+ * @param {string | string[]} path - The path to get value from.
+ * @param {T} defaultValue - The default value to return if the value does not exist.
+ * @returns {O[keyof O] | undefined} - The value from the object by the given path.
+ *
+ * @example
+ * const obj = { a: { b: 3 } };
+ * get(obj, 'a.b', null); // 3
+ */
+declare function get<O, T>(obj: O, path: string | string[], defaultValue?: T): O[keyof O] | T | undefined;
+
+export { get };

package/dist/object/get.js

@@ -0,0 +1,58 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/object/get.ts
+var get_exports = {};
+__export(get_exports, {
+  get: () => get
+});
+module.exports = __toCommonJS(get_exports);
+function get(obj, path, defaultValue) {
+  if (!Array.isArray(path)) {
+    const pathArr = path.split(".");
+    path = [];
+    for (let i = 0; i < pathArr.length; i++) {
+      if (/^.+\[[0-9]+\]$/.test(pathArr[i])) {
+        path.push(/^.+(?=\[[0-9]+\]$)/.exec(pathArr[i])[0]);
+        path.push(`${new RegExp("(?<=^.+\\[)[0-9]+(?=\\]$)").exec(pathArr[i])[0]}`);
+      } else {
+        path.push(pathArr[i]);
+      }
+    }
+  }
+  const callback = (innerObj, innerPath) => {
+    if (typeof innerObj[innerPath] === "undefined") {
+      return void 0;
+    }
+    return innerObj[innerPath];
+  };
+  let currentObj = obj;
+  for (let i = 0; i < path.length; i++) {
+    currentObj = callback(currentObj, path[i]);
+    if (typeof currentObj === "undefined") {
+      return typeof defaultValue === "undefined" ? void 0 : defaultValue;
+    }
+  }
+  return currentObj;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  get
+});
+//# sourceMappingURL=get.js.map

package/dist/object/get.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/object/get.ts"],"sourcesContent":["/**\n * Get a value from an object by path.\n * \n * This function takes an object and a path, and default value that will be returned if\n * a returnable value about the given path does not exist.\n * \n * @template O - Type of the object to get value from. \n * @template T - Type of the default value to return if the value does not exist.\n * @param {O} obj - The object to get value from. \n * @param {string | string[]} path - The path to get value from. \n * @param {T} defaultValue - The default value to return if the value does not exist.\n * @returns {O[keyof O] | undefined} - The value from the object by the given path.\n * \n * @example\n * const obj = { a: { b: 3 } };\n * get(obj, 'a.b', null); // 3\n */\n\nexport function get<O, T>(obj: O, path: string | string[], defaultValue?: T): O[keyof O] | T | undefined {\n  if (!Array.isArray(path)) {\n    const pathArr = path.split('.');\n    path = []\n    for (let i = 0; i < pathArr.length; i++) {\n      if (/^.+\\[[0-9]+\\]$/.test(pathArr[i])) {\n        path.push(/^.+(?=\\[[0-9]+\\]$)/.exec(pathArr[i])![0])\n        path.push(`${/(?<=^.+\\[)[0-9]+(?=\\]$)/.exec(pathArr[i])![0]}`)\n      } else {\n        path.push(pathArr[i])\n      }\n    }\n  }\n\n  const callback = (innerObj: any, innerPath: string) => {\n    if (typeof innerObj[innerPath] === 'undefined') {\n      return undefined\n    }\n    return innerObj[innerPath]\n  }\n\n  let currentObj = obj\n  for (let i = 0; i < path.length; i++) {\n    currentObj = callback(currentObj, path[i])\n    if (typeof currentObj === 'undefined') {\n      return typeof defaultValue === 'undefined' ? undefined : defaultValue\n    }\n  }\n  return currentObj as O[keyof O]\n}"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBO,SAAS,IAAU,KAAQ,MAAyB,cAA8C;AACvG,MAAI,CAAC,MAAM,QAAQ,IAAI,GAAG;AACxB,UAAM,UAAU,KAAK,MAAM,GAAG;AAC9B,WAAO,CAAC;AACR,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,UAAI,iBAAiB,KAAK,QAAQ,CAAC,CAAC,GAAG;AACrC,aAAK,KAAK,qBAAqB,KAAK,QAAQ,CAAC,CAAC,EAAG,CAAC,CAAC;AACnD,aAAK,KAAK,GAAG,WAAC,2BAAwB,EAAC,KAAK,QAAQ,CAAC,CAAC,EAAG,CAAC,CAAC,EAAE;AAAA,MAC/D,OAAO;AACL,aAAK,KAAK,QAAQ,CAAC,CAAC;AAAA,MACtB;AAAA,IACF;AAAA,EACF;AAEA,QAAM,WAAW,CAAC,UAAe,cAAsB;AACrD,QAAI,OAAO,SAAS,SAAS,MAAM,aAAa;AAC9C,aAAO;AAAA,IACT;AACA,WAAO,SAAS,SAAS;AAAA,EAC3B;AAEA,MAAI,aAAa;AACjB,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,iBAAa,SAAS,YAAY,KAAK,CAAC,CAAC;AACzC,QAAI,OAAO,eAAe,aAAa;AACrC,aAAO,OAAO,iBAAiB,cAAc,SAAY;AAAA,IAC3D;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/dist/object/get.mjs

@@ -0,0 +1,8 @@
+import {
+  get
+} from "../chunk-4RQPJUPQ.mjs";
+import "../chunk-2MM5EJJX.mjs";
+export {
+  get
+};
+//# sourceMappingURL=get.mjs.map

package/dist/object/get.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/object/index.d.mts

@@ -4,3 +4,4 @@ export { pick } from './pick.mjs';
 export { pickBy } from './pickBy.mjs';
 export { invert } from './invert.mjs';
 export { clone } from './clone.mjs';
+export { get } from './get.mjs';

package/dist/object/index.d.ts

@@ -4,3 +4,4 @@ export { pick } from './pick.js';
 export { pickBy } from './pickBy.js';
 export { invert } from './invert.js';
 export { clone } from './clone.js';
+export { get } from './get.js';

package/dist/object/index.js

@@ -35,6 +35,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var object_exports = {};
 __export(object_exports, {
   clone: () => clone,
+  get: () => get,
   invert: () => invert,
   omit: () => omit,
   omitBy: () => omitBy,
@@ -133,9 +134,40 @@ function clone(obj) {
 function isPrimitive(value) {
   return value == null || typeof value !== "object" && typeof value !== "function";
 }
+
+// src/object/get.ts
+function get(obj, path, defaultValue) {
+  if (!Array.isArray(path)) {
+    const pathArr = path.split(".");
+    path = [];
+    for (let i = 0; i < pathArr.length; i++) {
+      if (/^.+\[[0-9]+\]$/.test(pathArr[i])) {
+        path.push(/^.+(?=\[[0-9]+\]$)/.exec(pathArr[i])[0]);
+        path.push(`${new RegExp("(?<=^.+\\[)[0-9]+(?=\\]$)").exec(pathArr[i])[0]}`);
+      } else {
+        path.push(pathArr[i]);
+      }
+    }
+  }
+  const callback = (innerObj, innerPath) => {
+    if (typeof innerObj[innerPath] === "undefined") {
+      return void 0;
+    }
+    return innerObj[innerPath];
+  };
+  let currentObj = obj;
+  for (let i = 0; i < path.length; i++) {
+    currentObj = callback(currentObj, path[i]);
+    if (typeof currentObj === "undefined") {
+      return typeof defaultValue === "undefined" ? void 0 : defaultValue;
+    }
+  }
+  return currentObj;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   clone,
+  get,
   invert,
   omit,
   omitBy,

package/dist/object/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/object/index.ts","../../src/object/omit.ts","../../src/object/omitBy.ts","../../src/object/pick.ts","../../src/object/pickBy.ts","../../src/object/invert.ts","../../src/object/clone.ts"],"sourcesContent":["export { omit } from './omit.ts';\nexport { omitBy } from './omitBy.ts';\nexport { pick } from './pick.ts';\nexport { pickBy } from './pickBy.ts';\nexport { invert } from './invert.ts';\nexport { clone } from './clone.ts';\n","/**\n * Creates a new object with specified keys omitted.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * excludes the properties corresponding to the specified keys.\n *\n * @template T - The type of object.\n * @template K - The type of keys in object.\n * @param {T} obj - The object to omit keys from.\n * @param {K[]} keys - An array of keys to be omitted from the object.\n * @returns {Omit<T, K>} A new object with the specified keys omitted.\n *\n * @example\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = omit(obj, ['b', 'c']);\n * // result will be { a: 1 }\n */\nexport function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K> {\n  const result = { ...obj };\n\n  for (const key of keys) {\n    delete result[key];\n  }\n\n  return result as Omit<T, K>;\n}\n","/**\n * Creates a new object composed of the properties that do not satisfy the predicate function.\n *\n * This function takes an object and a predicate function, and returns a new object that\n * includes only the properties for which the predicate function returns false.\n *\n * @template T - The type of object.\n * @param {T} obj - The object to omit properties from.\n * @param {(value: T[string], key: keyof T) => boolean} shouldOmit - A predicate function that determines\n * whether a property should be omitted. It takes the property's key and value as arguments and returns `true`\n * if the property should be omitted, and `false` otherwise.\n * @returns {Partial<T>} A new object with the properties that do not satisfy the predicate function.\n *\n * @example\n * const obj = { a: 1, b: 'omit', c: 3 };\n * const shouldOmit = (key, value) => typeof value === 'string';\n * const result = omitBy(obj, shouldOmit);\n * // result will be { a: 1, c: 3 }\n */\nexport function omitBy<T extends Record<string, any>>(\n  obj: T,\n  shouldOmit: (value: T[keyof T], key: keyof T) => boolean\n): Partial<T> {\n  const result: Partial<T> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (shouldOmit(value, key)) {\n      continue;\n    }\n\n    (result as any)[key] = value;\n  }\n\n  return result;\n}\n","/**\n * Creates a new object composed of the picked object properties.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * includes only the properties corresponding to the specified keys.\n *\n * @template T - The type of object.\n * @template K - The type of keys in object.\n * @param {T} obj - The object to pick keys from.\n * @param {K[]} keys - An array of keys to be picked from the object.\n * @returns {Pick<T, K>} A new object with the specified keys picked.\n *\n * @example\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = pick(obj, ['a', 'c']);\n * // result will be { a: 1, c: 3 }\n */\nexport function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n\n  for (const key of keys) {\n    result[key] = obj[key];\n  }\n\n  return result;\n}\n","/**\n * Creates a new object composed of the properties that satisfy the predicate function.\n *\n * This function takes an object and a predicate function, and returns a new object that\n * includes only the properties for which the predicate function returns true.\n *\n * @template T - The type of object.\n * @param {T} obj - The object to pick properties from.\n * @param {(value: T[keyof T], key: keyof T) => boolean} shouldPick - A predicate function that determines\n * whether a property should be picked. It takes the property's key and value as arguments and returns `true`\n * if the property should be picked, and `false` otherwise.\n * @returns {Partial<T>} A new object with the properties that satisfy the predicate function.\n *\n * @example\n * const obj = { a: 1, b: 'pick', c: 3 };\n * const shouldPick = (value) => typeof value === 'string';\n * const result = pickBy(obj, shouldPick);\n * // result will be { b: 'pick' }\n */\nexport function pickBy<T extends Record<string, any>>(\n  obj: T,\n  shouldPick: (value: T[keyof T], key: keyof T) => boolean\n): Partial<T> {\n  const result: Partial<T> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (!shouldPick(value, key)) {\n      continue;\n    }\n\n    (result as any)[key] = value;\n  }\n\n  return result;\n}\n","/**\n * Inverts the keys and values of an object. The keys of the input object become the values of the output object and vice versa.\n *\n * This function takes an object and creates a new object by inverting its keys and values. If the input object has duplicate values,\n * the key of the last occurrence will be used as the value for the new key in the output object. It effectively creates a reverse mapping\n * of the input object's key-value pairs.\n *\n * @template K - Type of the keys in the input object (string, number, symbol)\n * @template V - Type of the values in the input object (string, number, symbol)\n * @param {Record<K, V>} obj - The input object whose keys and values are to be inverted\n * @returns {{ [key in V]: K }} - A new object with keys and values inverted\n *\n * @example\n * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }\n * invert({ 1: 'a', 2: 'b', 3: 'c' }); // { a: '1', b: '2', c: '3' }\n * invert({ a: 1, 2: 'b', c: 3, 4: 'd' }); // { 1: 'a', b: '2', 3: 'c', d: '4' }\n * invert({ a: Symbol('sym1'), b: Symbol('sym2') }); // { [Symbol('sym1')]: 'a', [Symbol('sym2')]: 'b' }\n */\nexport function invert<K extends PropertyKey, V extends PropertyKey>(obj: Record<K, V>): { [key in V]: K } {\n  const result = {} as { [key in V]: K };\n\n  const keys = Object.keys(obj) as K[];\n  \n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n    const value = obj[key];\n    result[value] = key;\n  }\n\n  return result;\n}\n","/**\n * Creates a shallow clone of the given object.\n *\n * @template T - The type of the object.\n * @param {T} obj - The object to clone.\n * @returns {T} - A shallow clone of the given object.\n *\n * @example\n * // Clone a primitive values\n * const num = 29;\n * const clonedNum = clone(num);\n * console.log(clonedNum); // 29\n * console.log(clonedNum === num) ; // true\n *\n * @example\n * // Clone an array\n * const arr = [1, 2, 3];\n * const clonedArr = clone(arr);\n * console.log(clonedArr); // [1, 2, 3]\n * console.log(clonedArr === arr); // false\n *\n * @example\n * // Clone an object\n * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };\n * const clonedObj = clone(obj);\n * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }\n * console.log(clonedObj === obj); // false\n */\nexport function clone<T>(obj: T): T {\n  if (isPrimitive(obj)) {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.slice() as T;\n  }\n\n  if (obj instanceof Date) {\n    return new Date(obj.getTime()) as T;\n  }\n\n  if (obj instanceof RegExp) {\n    return new RegExp(obj.source, obj.flags) as T;\n  }\n\n  if (obj instanceof Map) {\n    const result = new Map();\n    for (const [key, value] of obj) {\n      result.set(key, value);\n    }\n    return result as T;\n  }\n\n  if (obj instanceof Set) {\n    const result = new Set();\n    for (const value of obj) {\n      result.add(value);\n    }\n    return result as T;\n  }\n\n  if (typeof obj === \"object\") {\n    return Object.assign({}, obj) as T;\n  }\n  return obj;\n}\n\ntype Primitive = null | undefined | string | number | boolean | symbol | bigint;\n\nfunction isPrimitive(value: unknown): value is Primitive {\n  return value == null ||\n    (typeof value !== \"object\" && typeof value !== \"function\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACiBO,SAAS,KAAuD,KAAQ,MAAuB;AACpG,QAAM,SAAS,mBAAK;AAEpB,aAAW,OAAO,MAAM;AACtB,WAAO,OAAO,GAAG;AAAA,EACnB;AAEA,SAAO;AACT;;;ACNO,SAAS,OACd,KACA,YACY;AACZ,QAAM,SAAqB,CAAC;AAE5B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,QAAI,WAAW,OAAO,GAAG,GAAG;AAC1B;AAAA,IACF;AAEA,IAAC,OAAe,GAAG,IAAI;AAAA,EACzB;AAEA,SAAO;AACT;;;ACjBO,SAAS,KAAuD,KAAQ,MAAuB;AACpG,QAAM,SAAS,CAAC;AAEhB,aAAW,OAAO,MAAM;AACtB,WAAO,GAAG,IAAI,IAAI,GAAG;AAAA,EACvB;AAEA,SAAO;AACT;;;ACNO,SAAS,OACd,KACA,YACY;AACZ,QAAM,SAAqB,CAAC;AAE5B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,GAAG,GAAG;AAC9C,QAAI,CAAC,WAAW,OAAO,GAAG,GAAG;AAC3B;AAAA,IACF;AAEA,IAAC,OAAe,GAAG,IAAI;AAAA,EACzB;AAEA,SAAO;AACT;;;AChBO,SAAS,OAAqD,KAAsC;AACzG,QAAM,SAAS,CAAC;AAEhB,QAAM,OAAO,OAAO,KAAK,GAAG;AAE5B,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,UAAM,QAAQ,IAAI,GAAG;AACrB,WAAO,KAAK,IAAI;AAAA,EAClB;AAEA,SAAO;AACT;;;ACFO,SAAS,MAAS,KAAW;AAClC,MAAI,YAAY,GAAG,GAAG;AACpB,WAAO;AAAA,EACT;AAEA,MAAI,MAAM,QAAQ,GAAG,GAAG;AACtB,WAAO,IAAI,MAAM;AAAA,EACnB;AAEA,MAAI,eAAe,MAAM;AACvB,WAAO,IAAI,KAAK,IAAI,QAAQ,CAAC;AAAA,EAC/B;AAEA,MAAI,eAAe,QAAQ;AACzB,WAAO,IAAI,OAAO,IAAI,QAAQ,IAAI,KAAK;AAAA,EACzC;AAEA,MAAI,eAAe,KAAK;AACtB,UAAM,SAAS,oBAAI,IAAI;AACvB,eAAW,CAAC,KAAK,KAAK,KAAK,KAAK;AAC9B,aAAO,IAAI,KAAK,KAAK;AAAA,IACvB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,eAAe,KAAK;AACtB,UAAM,SAAS,oBAAI,IAAI;AACvB,eAAW,SAAS,KAAK;AACvB,aAAO,IAAI,KAAK;AAAA,IAClB;AACA,WAAO;AAAA,EACT;AAEA,MAAI,OAAO,QAAQ,UAAU;AAC3B,WAAO,OAAO,OAAO,CAAC,GAAG,GAAG;AAAA,EAC9B;AACA,SAAO;AACT;AAIA,SAAS,YAAY,OAAoC;AACvD,SAAO,SAAS,QACb,OAAO,UAAU,YAAY,OAAO,UAAU;AACnD;","names":[]}
+{"version":3,"sources":["../../src/object/index.ts","../../src/object/omit.ts","../../src/object/omitBy.ts","../../src/object/pick.ts","../../src/object/pickBy.ts","../../src/object/invert.ts","../../src/object/clone.ts","../../src/object/get.ts"],"sourcesContent":["export { omit } from './omit.ts';\nexport { omitBy } from './omitBy.ts';\nexport { pick } from './pick.ts';\nexport { pickBy } from './pickBy.ts';\nexport { invert } from './invert.ts';\nexport { clone } from './clone.ts';\nexport { get } from './get.ts';\n","/**\n * Creates a new object with specified keys omitted.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * excludes the properties corresponding to the specified keys.\n *\n * @template T - The type of object.\n * @template K - The type of keys in object.\n * @param {T} obj - The object to omit keys from.\n * @param {K[]} keys - An array of keys to be omitted from the object.\n * @returns {Omit<T, K>} A new object with the specified keys omitted.\n *\n * @example\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = omit(obj, ['b', 'c']);\n * // result will be { a: 1 }\n */\nexport function omit<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K> {\n  const result = { ...obj };\n\n  for (const key of keys) {\n    delete result[key];\n  }\n\n  return result as Omit<T, K>;\n}\n","/**\n * Creates a new object composed of the properties that do not satisfy the predicate function.\n *\n * This function takes an object and a predicate function, and returns a new object that\n * includes only the properties for which the predicate function returns false.\n *\n * @template T - The type of object.\n * @param {T} obj - The object to omit properties from.\n * @param {(value: T[string], key: keyof T) => boolean} shouldOmit - A predicate function that determines\n * whether a property should be omitted. It takes the property's key and value as arguments and returns `true`\n * if the property should be omitted, and `false` otherwise.\n * @returns {Partial<T>} A new object with the properties that do not satisfy the predicate function.\n *\n * @example\n * const obj = { a: 1, b: 'omit', c: 3 };\n * const shouldOmit = (key, value) => typeof value === 'string';\n * const result = omitBy(obj, shouldOmit);\n * // result will be { a: 1, c: 3 }\n */\nexport function omitBy<T extends Record<string, any>>(\n  obj: T,\n  shouldOmit: (value: T[keyof T], key: keyof T) => boolean\n): Partial<T> {\n  const result: Partial<T> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (shouldOmit(value, key)) {\n      continue;\n    }\n\n    (result as any)[key] = value;\n  }\n\n  return result;\n}\n","/**\n * Creates a new object composed of the picked object properties.\n *\n * This function takes an object and an array of keys, and returns a new object that\n * includes only the properties corresponding to the specified keys.\n *\n * @template T - The type of object.\n * @template K - The type of keys in object.\n * @param {T} obj - The object to pick keys from.\n * @param {K[]} keys - An array of keys to be picked from the object.\n * @returns {Pick<T, K>} A new object with the specified keys picked.\n *\n * @example\n * const obj = { a: 1, b: 2, c: 3 };\n * const result = pick(obj, ['a', 'c']);\n * // result will be { a: 1, c: 3 }\n */\nexport function pick<T extends Record<string, any>, K extends keyof T>(obj: T, keys: K[]): Pick<T, K> {\n  const result = {} as Pick<T, K>;\n\n  for (const key of keys) {\n    result[key] = obj[key];\n  }\n\n  return result;\n}\n","/**\n * Creates a new object composed of the properties that satisfy the predicate function.\n *\n * This function takes an object and a predicate function, and returns a new object that\n * includes only the properties for which the predicate function returns true.\n *\n * @template T - The type of object.\n * @param {T} obj - The object to pick properties from.\n * @param {(value: T[keyof T], key: keyof T) => boolean} shouldPick - A predicate function that determines\n * whether a property should be picked. It takes the property's key and value as arguments and returns `true`\n * if the property should be picked, and `false` otherwise.\n * @returns {Partial<T>} A new object with the properties that satisfy the predicate function.\n *\n * @example\n * const obj = { a: 1, b: 'pick', c: 3 };\n * const shouldPick = (value) => typeof value === 'string';\n * const result = pickBy(obj, shouldPick);\n * // result will be { b: 'pick' }\n */\nexport function pickBy<T extends Record<string, any>>(\n  obj: T,\n  shouldPick: (value: T[keyof T], key: keyof T) => boolean\n): Partial<T> {\n  const result: Partial<T> = {};\n\n  for (const [key, value] of Object.entries(obj)) {\n    if (!shouldPick(value, key)) {\n      continue;\n    }\n\n    (result as any)[key] = value;\n  }\n\n  return result;\n}\n","/**\n * Inverts the keys and values of an object. The keys of the input object become the values of the output object and vice versa.\n *\n * This function takes an object and creates a new object by inverting its keys and values. If the input object has duplicate values,\n * the key of the last occurrence will be used as the value for the new key in the output object. It effectively creates a reverse mapping\n * of the input object's key-value pairs.\n *\n * @template K - Type of the keys in the input object (string, number, symbol)\n * @template V - Type of the values in the input object (string, number, symbol)\n * @param {Record<K, V>} obj - The input object whose keys and values are to be inverted\n * @returns {{ [key in V]: K }} - A new object with keys and values inverted\n *\n * @example\n * invert({ a: 1, b: 2, c: 3 }); // { 1: 'a', 2: 'b', 3: 'c' }\n * invert({ 1: 'a', 2: 'b', 3: 'c' }); // { a: '1', b: '2', c: '3' }\n * invert({ a: 1, 2: 'b', c: 3, 4: 'd' }); // { 1: 'a', b: '2', 3: 'c', d: '4' }\n * invert({ a: Symbol('sym1'), b: Symbol('sym2') }); // { [Symbol('sym1')]: 'a', [Symbol('sym2')]: 'b' }\n */\nexport function invert<K extends PropertyKey, V extends PropertyKey>(obj: Record<K, V>): { [key in V]: K } {\n  const result = {} as { [key in V]: K };\n\n  const keys = Object.keys(obj) as K[];\n  \n  for (let i = 0; i < keys.length; i++) {\n    const key = keys[i];\n    const value = obj[key];\n    result[value] = key;\n  }\n\n  return result;\n}\n","/**\n * Creates a shallow clone of the given object.\n *\n * @template T - The type of the object.\n * @param {T} obj - The object to clone.\n * @returns {T} - A shallow clone of the given object.\n *\n * @example\n * // Clone a primitive values\n * const num = 29;\n * const clonedNum = clone(num);\n * console.log(clonedNum); // 29\n * console.log(clonedNum === num) ; // true\n *\n * @example\n * // Clone an array\n * const arr = [1, 2, 3];\n * const clonedArr = clone(arr);\n * console.log(clonedArr); // [1, 2, 3]\n * console.log(clonedArr === arr); // false\n *\n * @example\n * // Clone an object\n * const obj = { a: 1, b: 'es-toolkit', c: [1, 2, 3] };\n * const clonedObj = clone(obj);\n * console.log(clonedObj); // { a: 1, b: 'es-toolkit', c: [1, 2, 3] }\n * console.log(clonedObj === obj); // false\n */\nexport function clone<T>(obj: T): T {\n  if (isPrimitive(obj)) {\n    return obj;\n  }\n\n  if (Array.isArray(obj)) {\n    return obj.slice() as T;\n  }\n\n  if (obj instanceof Date) {\n    return new Date(obj.getTime()) as T;\n  }\n\n  if (obj instanceof RegExp) {\n    return new RegExp(obj.source, obj.flags) as T;\n  }\n\n  if (obj instanceof Map) {\n    const result = new Map();\n    for (const [key, value] of obj) {\n      result.set(key, value);\n    }\n    return result as T;\n  }\n\n  if (obj instanceof Set) {\n    const result = new Set();\n    for (const value of obj) {\n      result.add(value);\n    }\n    return result as T;\n  }\n\n  if (typeof obj === \"object\") {\n    return Object.assign({}, obj) as T;\n  }\n  return obj;\n}\n\ntype Primitive = null | undefined | string | number | boolean | symbol | bigint;\n\nfunction isPrimitive(value: unknown): value is Primitive {\n  return value == null ||\n    (typeof value !== \"object\" && typeof value !== \"function\");\n}\n","/**\n * Get a value from an object by path.\n * \n * This function takes an object and a path, and default value that will be returned if\n * a returnable value about the given path does not exist.\n * \n * @template O - Type of the object to get value from. \n * @template T - Type of the default value to return if the value does not exist.\n * @param {O} obj - The object to get value from. \n * @param {string | string[]} path - The path to get value from. \n * @param {T} defaultValue - The default value to return if the value does not exist.\n * @returns {O[keyof O] | undefined} - The value from the object by the given path.\n * \n * @example\n * const obj = { a: { b: 3 } };\n * get(obj, 'a.b', null); // 3\n */\n\nexport function get<O, T>(obj: O, path: string | string[], defaultValue?: T): O[keyof O] | T | undefined {\n  if (!Array.isArray(path)) {\n    const pathArr = path.split('.');\n    path = []\n    for (let i = 0; i < pathArr.length; i++) {\n      if (/^.+\\[[0-9]+\\]$/.test(pathArr[i])) {\n        path.push(/^.+(?=\\[[0-9]+\\]$)/.exec(pathArr[i])![0])\n        path.push(`${/(?<=^.+\\[)[0-9]+(?=\\]$)/.exec(pathArr[i])![0]}`)\n      } else {\n        path.push(pathArr[i])\n      }\n    }\n  }\n\n  const callback = (innerObj: any, innerPath: string) => {\n    if (typeof innerObj[innerPath] === 'undefined') {\n      return undefined\n    }\n    return innerObj[innerPath]\n  }\n\n  let currentObj = obj\n  for (let i = 0; i < path.length; i++) {\n    currentObj = callback(currentObj, path[i])\n    if (typeof currentObj === 'undefined') {\n      return typeof defaultValue === 'undefined' ? undefined : defaultValue\n    }\n  }\n  return currentObj as O[keyof O]\n}"],"mappings":"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","names":[]}

package/dist/object/index.mjs

@@ -1,7 +1,13 @@
-import "../chunk-OSOLEQLZ.mjs";
+import "../chunk-54TK5BIS.mjs";
+import {
+  pickBy
+} from "../chunk-6CLH5YZ2.mjs";
 import {
   clone
 } from "../chunk-U4JGKZ56.mjs";
+import {
+  get
+} from "../chunk-4RQPJUPQ.mjs";
 import {
   invert
 } from "../chunk-OLX53VEF.mjs";
@@ -14,12 +20,10 @@ import {
 import {
   pick
 } from "../chunk-HPFDYUGP.mjs";
-import {
-  pickBy
-} from "../chunk-6CLH5YZ2.mjs";
 import "../chunk-2MM5EJJX.mjs";
 export {
   clone,
+  get,
   invert,
   omit,
   omitBy,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "es-toolkit",
   "description": "A state-of-the-art, high-performance JavaScript utility library with a small bundle size and strong type annotations.",
-  "version": "1.10.1-dev.246+404d4a51",
+  "version": "1.10.1-dev.248+a186e5d4",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

package/dist/chunk-OSOLEQLZ.mjs

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-OSOLEQLZ.mjs.map