es-toolkit 1.36.0 → 1.37.0

package/CHANGELOG.md

@@ -1,4 +1,19 @@
 # es-toolkit Changelog
+
+## Version v1.37.0
+
+Released on May 3rd, 2025.
+
+- Introduced compatibility functions for [result](https://es-toolkit.slash.page/reference/compat/object/result.html), [omitBy](https://es-toolkit.slash.page/reference/object/omitBy.html), [xorBy](https://es-toolkit.slash.page/reference/array/xorBy.html), [xorWith](https://es-toolkit.slash.page/reference/array/xorWith.html), [unzipWith](https://es-toolkit.slash.page/reference/array/unzipWith.html), [sampleSize](https://es-toolkit.slash.page/reference/array/sampleSize.html), [transform](https://es-toolkit.slash.page/reference/compat/object/transform.html), [wrap](https://es-toolkit.slash.page/reference/compat/function/wrap.html), [countBy](https://es-toolkit.slash.page/reference/array/countBy.html), and [xor](https://es-toolkit.slash.page/reference/array/xor.html).
+- Added vitest benchmark for [ary](https://es-toolkit.slash.page/reference/function/ary.html) function.
+- Fixed string comparison in [sortBy](https://es-toolkit.slash.page/reference/array/sortBy.html) and [orderBy](https://es-toolkit.slash.page/reference/array/orderBy.html) by removing locale comparison and using ASCII code instead.
+- Fixed type definition in [isBuffer](https://es-toolkit.slash.page/reference/predicate/isBuffer.html).
+- Fixed internal documentation links for Korean and Japanese headings.
+- Improved code readability and documentation for various functions.
+- Prevented circular dependencies by updating import paths in [toCamelCaseKeys](https://es-toolkit.slash.page/reference/object/toCamelCaseKeys.html) and [toSnakeCaseKeys](https://es-toolkit.slash.page/reference/object/toSnakeCaseKeys.html).
+
+We sincerely thank @chldmsqls34, @umsungjun, @raon0211, @dayongkr, @shren207, @oror-sine, @L2HYUNN, @D-Sketon, @ariandel-dev, @Jeong-Rae, and @beomxtone for their contributions. We appreciate your great efforts!
+
 ## Version v1.36.0
 
 Released on April 24th, 2025.

package/dist/_chunk/isPlainObject-Xaozpc.js

@@ -0,0 +1,93 @@
+'use strict';
+
+function isPrimitive(value) {
+    return value == null || (typeof value !== 'object' && typeof value !== 'function');
+}
+
+function isTypedArray(x) {
+    return ArrayBuffer.isView(x) && !(x instanceof DataView);
+}
+
+function getSymbols(object) {
+    return Object.getOwnPropertySymbols(object).filter(symbol => Object.prototype.propertyIsEnumerable.call(object, symbol));
+}
+
+function getTag(value) {
+    if (value == null) {
+        return value === undefined ? '[object Undefined]' : '[object Null]';
+    }
+    return Object.prototype.toString.call(value);
+}
+
+const regexpTag = '[object RegExp]';
+const stringTag = '[object String]';
+const numberTag = '[object Number]';
+const booleanTag = '[object Boolean]';
+const argumentsTag = '[object Arguments]';
+const symbolTag = '[object Symbol]';
+const dateTag = '[object Date]';
+const mapTag = '[object Map]';
+const setTag = '[object Set]';
+const arrayTag = '[object Array]';
+const functionTag = '[object Function]';
+const arrayBufferTag = '[object ArrayBuffer]';
+const objectTag = '[object Object]';
+const errorTag = '[object Error]';
+const dataViewTag = '[object DataView]';
+const uint8ArrayTag = '[object Uint8Array]';
+const uint8ClampedArrayTag = '[object Uint8ClampedArray]';
+const uint16ArrayTag = '[object Uint16Array]';
+const uint32ArrayTag = '[object Uint32Array]';
+const bigUint64ArrayTag = '[object BigUint64Array]';
+const int8ArrayTag = '[object Int8Array]';
+const int16ArrayTag = '[object Int16Array]';
+const int32ArrayTag = '[object Int32Array]';
+const bigInt64ArrayTag = '[object BigInt64Array]';
+const float32ArrayTag = '[object Float32Array]';
+const float64ArrayTag = '[object Float64Array]';
+
+function isPlainObject(value) {
+    if (!value || typeof value !== 'object') {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    const hasObjectPrototype = proto === null ||
+        proto === Object.prototype ||
+        Object.getPrototypeOf(proto) === null;
+    if (!hasObjectPrototype) {
+        return false;
+    }
+    return Object.prototype.toString.call(value) === '[object Object]';
+}
+
+exports.argumentsTag = argumentsTag;
+exports.arrayBufferTag = arrayBufferTag;
+exports.arrayTag = arrayTag;
+exports.bigInt64ArrayTag = bigInt64ArrayTag;
+exports.bigUint64ArrayTag = bigUint64ArrayTag;
+exports.booleanTag = booleanTag;
+exports.dataViewTag = dataViewTag;
+exports.dateTag = dateTag;
+exports.errorTag = errorTag;
+exports.float32ArrayTag = float32ArrayTag;
+exports.float64ArrayTag = float64ArrayTag;
+exports.functionTag = functionTag;
+exports.getSymbols = getSymbols;
+exports.getTag = getTag;
+exports.int16ArrayTag = int16ArrayTag;
+exports.int32ArrayTag = int32ArrayTag;
+exports.int8ArrayTag = int8ArrayTag;
+exports.isPlainObject = isPlainObject;
+exports.isPrimitive = isPrimitive;
+exports.isTypedArray = isTypedArray;
+exports.mapTag = mapTag;
+exports.numberTag = numberTag;
+exports.objectTag = objectTag;
+exports.regexpTag = regexpTag;
+exports.setTag = setTag;
+exports.stringTag = stringTag;
+exports.symbolTag = symbolTag;
+exports.uint16ArrayTag = uint16ArrayTag;
+exports.uint32ArrayTag = uint32ArrayTag;
+exports.uint8ArrayTag = uint8ArrayTag;
+exports.uint8ClampedArrayTag = uint8ClampedArrayTag;

package/dist/_chunk/{isPromise-CxqI1v.js → isWeakSet-C2NpfO.js}

@@ -1,107 +1,35 @@
 'use strict';
 
+const isPlainObject = require('./isPlainObject-Xaozpc.js');
 const noop = require('./noop-2IwLUk.js');
 
-function isPrimitive(value) {
-    return value == null || (typeof value !== 'object' && typeof value !== 'function');
-}
-
-function isTypedArray(x) {
-    return ArrayBuffer.isView(x) && !(x instanceof DataView);
-}
-
-function getSymbols(object) {
-    return Object.getOwnPropertySymbols(object).filter(symbol => Object.prototype.propertyIsEnumerable.call(object, symbol));
-}
-
-function getTag(value) {
-    if (value == null) {
-        return value === undefined ? '[object Undefined]' : '[object Null]';
-    }
-    return Object.prototype.toString.call(value);
+function isArrayBuffer(value) {
+    return value instanceof ArrayBuffer;
 }
 
-const regexpTag = '[object RegExp]';
-const stringTag = '[object String]';
-const numberTag = '[object Number]';
-const booleanTag = '[object Boolean]';
-const argumentsTag = '[object Arguments]';
-const symbolTag = '[object Symbol]';
-const dateTag = '[object Date]';
-const mapTag = '[object Map]';
-const setTag = '[object Set]';
-const arrayTag = '[object Array]';
-const functionTag = '[object Function]';
-const arrayBufferTag = '[object ArrayBuffer]';
-const objectTag = '[object Object]';
-const errorTag = '[object Error]';
-const dataViewTag = '[object DataView]';
-const uint8ArrayTag = '[object Uint8Array]';
-const uint8ClampedArrayTag = '[object Uint8ClampedArray]';
-const uint16ArrayTag = '[object Uint16Array]';
-const uint32ArrayTag = '[object Uint32Array]';
-const bigUint64ArrayTag = '[object BigUint64Array]';
-const int8ArrayTag = '[object Int8Array]';
-const int16ArrayTag = '[object Int16Array]';
-const int32ArrayTag = '[object Int32Array]';
-const bigInt64ArrayTag = '[object BigInt64Array]';
-const float32ArrayTag = '[object Float32Array]';
-const float64ArrayTag = '[object Float64Array]';
-
-function isPlainObject(value) {
-    if (!value || typeof value !== 'object') {
-        return false;
-    }
-    const proto = Object.getPrototypeOf(value);
-    const hasObjectPrototype = proto === null ||
-        proto === Object.prototype ||
-        Object.getPrototypeOf(proto) === null;
-    if (!hasObjectPrototype) {
+function isBlob(x) {
+    if (typeof Blob === 'undefined') {
         return false;
     }
-    return Object.prototype.toString.call(value) === '[object Object]';
-}
-
-function isLength(value) {
-    return Number.isSafeInteger(value) && value >= 0;
-}
-
-function eq(value, other) {
-    return value === other || (Number.isNaN(value) && Number.isNaN(other));
-}
-
-function isNil(x) {
-    return x == null;
-}
-
-function isNull(x) {
-    return x === null;
-}
-
-function isUndefined(x) {
-    return x === undefined;
-}
-
-function isSymbol(value) {
-    return typeof value === 'symbol';
+    return x instanceof Blob;
 }
 
-function isFunction(value) {
-    return typeof value === 'function';
+function isBrowser() {
+    return typeof window !== 'undefined' && window?.document != null;
 }
 
 function isBuffer(x) {
     return typeof Buffer !== 'undefined' && Buffer.isBuffer(x);
 }
 
-function isArrayBuffer(value) {
-    return value instanceof ArrayBuffer;
-}
-
 function isDate(value) {
     return value instanceof Date;
 }
 
+function eq(value, other) {
+    return value === other || (Number.isNaN(value) && Number.isNaN(other));
+}
+
 function isEqualWith(a, b, areValuesEqual) {
     return isEqualWithImpl(a, b, undefined, undefined, undefined, undefined, areValuesEqual);
 }
@@ -136,33 +64,33 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
     if (Object.is(a, b)) {
         return true;
     }
-    let aTag = getTag(a);
-    let bTag = getTag(b);
-    if (aTag === argumentsTag) {
-        aTag = objectTag;
+    let aTag = isPlainObject.getTag(a);
+    let bTag = isPlainObject.getTag(b);
+    if (aTag === isPlainObject.argumentsTag) {
+        aTag = isPlainObject.objectTag;
     }
-    if (bTag === argumentsTag) {
-        bTag = objectTag;
+    if (bTag === isPlainObject.argumentsTag) {
+        bTag = isPlainObject.objectTag;
     }
     if (aTag !== bTag) {
         return false;
     }
     switch (aTag) {
-        case stringTag:
+        case isPlainObject.stringTag:
             return a.toString() === b.toString();
-        case numberTag: {
+        case isPlainObject.numberTag: {
             const x = a.valueOf();
             const y = b.valueOf();
             return eq(x, y);
         }
-        case booleanTag:
-        case dateTag:
-        case symbolTag:
+        case isPlainObject.booleanTag:
+        case isPlainObject.dateTag:
+        case isPlainObject.symbolTag:
             return Object.is(a.valueOf(), b.valueOf());
-        case regexpTag: {
+        case isPlainObject.regexpTag: {
             return a.source === b.source && a.flags === b.flags;
         }
-        case functionTag: {
+        case isPlainObject.functionTag: {
             return a === b;
         }
     }
@@ -176,7 +104,7 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
     stack.set(b, a);
     try {
         switch (aTag) {
-            case mapTag: {
+            case isPlainObject.mapTag: {
                 if (a.size !== b.size) {
                     return false;
                 }
@@ -187,7 +115,7 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
                 }
                 return true;
             }
-            case setTag: {
+            case isPlainObject.setTag: {
                 if (a.size !== b.size) {
                     return false;
                 }
@@ -205,18 +133,18 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
                 }
                 return true;
             }
-            case arrayTag:
-            case uint8ArrayTag:
-            case uint8ClampedArrayTag:
-            case uint16ArrayTag:
-            case uint32ArrayTag:
-            case bigUint64ArrayTag:
-            case int8ArrayTag:
-            case int16ArrayTag:
-            case int32ArrayTag:
-            case bigInt64ArrayTag:
-            case float32ArrayTag:
-            case float64ArrayTag: {
+            case isPlainObject.arrayTag:
+            case isPlainObject.uint8ArrayTag:
+            case isPlainObject.uint8ClampedArrayTag:
+            case isPlainObject.uint16ArrayTag:
+            case isPlainObject.uint32ArrayTag:
+            case isPlainObject.bigUint64ArrayTag:
+            case isPlainObject.int8ArrayTag:
+            case isPlainObject.int16ArrayTag:
+            case isPlainObject.int32ArrayTag:
+            case isPlainObject.bigInt64ArrayTag:
+            case isPlainObject.float32ArrayTag:
+            case isPlainObject.float64ArrayTag: {
                 if (typeof Buffer !== 'undefined' && Buffer.isBuffer(a) !== Buffer.isBuffer(b)) {
                     return false;
                 }
@@ -230,29 +158,29 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
                 }
                 return true;
             }
-            case arrayBufferTag: {
+            case isPlainObject.arrayBufferTag: {
                 if (a.byteLength !== b.byteLength) {
                     return false;
                 }
                 return areObjectsEqual(new Uint8Array(a), new Uint8Array(b), stack, areValuesEqual);
             }
-            case dataViewTag: {
+            case isPlainObject.dataViewTag: {
                 if (a.byteLength !== b.byteLength || a.byteOffset !== b.byteOffset) {
                     return false;
                 }
                 return areObjectsEqual(new Uint8Array(a), new Uint8Array(b), stack, areValuesEqual);
             }
-            case errorTag: {
+            case isPlainObject.errorTag: {
                 return a.name === b.name && a.message === b.message;
             }
-            case objectTag: {
+            case isPlainObject.objectTag: {
                 const areEqualInstances = areObjectsEqual(a.constructor, b.constructor, stack, areValuesEqual) ||
-                    (isPlainObject(a) && isPlainObject(b));
+                    (isPlainObject.isPlainObject(a) && isPlainObject.isPlainObject(b));
                 if (!areEqualInstances) {
                     return false;
                 }
-                const aKeys = [...Object.keys(a), ...getSymbols(a)];
-                const bKeys = [...Object.keys(b), ...getSymbols(b)];
+                const aKeys = [...Object.keys(a), ...isPlainObject.getSymbols(a)];
+                const bKeys = [...Object.keys(b), ...isPlainObject.getSymbols(b)];
                 if (aKeys.length !== bKeys.length) {
                     return false;
                 }
@@ -280,37 +208,6 @@ function areObjectsEqual(a, b, stack, areValuesEqual) {
     }
 }
 
-function isMap(value) {
-    return value instanceof Map;
-}
-
-function isRegExp(value) {
-    return value instanceof RegExp;
-}
-
-function isSet(value) {
-    return value instanceof Set;
-}
-
-function isWeakMap(value) {
-    return value instanceof WeakMap;
-}
-
-function isWeakSet(value) {
-    return value instanceof WeakSet;
-}
-
-function isBlob(x) {
-    if (typeof Blob === 'undefined') {
-        return false;
-    }
-    return x instanceof Blob;
-}
-
-function isBrowser() {
-    return typeof window !== 'undefined' && window?.document != null;
-}
-
 function isEqual(a, b) {
     return isEqualWith(a, b, noop.noop);
 }
@@ -322,6 +219,10 @@ function isFile(x) {
     return isBlob(x) && x instanceof File;
 }
 
+function isFunction(value) {
+    return typeof value === 'function';
+}
+
 function isJSON(value) {
     if (typeof value !== 'string') {
         return false;
@@ -357,7 +258,7 @@ function isJSONArray(value) {
     return value.every(item => isJSONValue(item));
 }
 function isJSONObject(obj) {
-    if (!isPlainObject(obj)) {
+    if (!isPlainObject.isPlainObject(obj)) {
         return false;
     }
     const keys = Reflect.ownKeys(obj);
@@ -374,6 +275,18 @@ function isJSONObject(obj) {
     return true;
 }
 
+function isLength(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+
+function isMap(value) {
+    return value instanceof Map;
+}
+
+function isNil(x) {
+    return x == null;
+}
+
 function isNode() {
     return typeof process !== 'undefined' && process?.versions?.node != null;
 }
@@ -382,24 +295,39 @@ function isNotNil(x) {
     return x != null;
 }
 
+function isNull(x) {
+    return x === null;
+}
+
 function isPromise(value) {
     return value instanceof Promise;
 }
 
-exports.argumentsTag = argumentsTag;
-exports.arrayBufferTag = arrayBufferTag;
-exports.arrayTag = arrayTag;
-exports.booleanTag = booleanTag;
-exports.dataViewTag = dataViewTag;
-exports.dateTag = dateTag;
+function isRegExp(value) {
+    return value instanceof RegExp;
+}
+
+function isSet(value) {
+    return value instanceof Set;
+}
+
+function isSymbol(value) {
+    return typeof value === 'symbol';
+}
+
+function isUndefined(x) {
+    return x === undefined;
+}
+
+function isWeakMap(value) {
+    return value instanceof WeakMap;
+}
+
+function isWeakSet(value) {
+    return value instanceof WeakSet;
+}
+
 exports.eq = eq;
-exports.float32ArrayTag = float32ArrayTag;
-exports.float64ArrayTag = float64ArrayTag;
-exports.getSymbols = getSymbols;
-exports.getTag = getTag;
-exports.int16ArrayTag = int16ArrayTag;
-exports.int32ArrayTag = int32ArrayTag;
-exports.int8ArrayTag = int8ArrayTag;
 exports.isArrayBuffer = isArrayBuffer;
 exports.isBlob = isBlob;
 exports.isBrowser = isBrowser;
@@ -419,24 +347,10 @@ exports.isNil = isNil;
 exports.isNode = isNode;
 exports.isNotNil = isNotNil;
 exports.isNull = isNull;
-exports.isPlainObject = isPlainObject;
-exports.isPrimitive = isPrimitive;
 exports.isPromise = isPromise;
 exports.isRegExp = isRegExp;
 exports.isSet = isSet;
 exports.isSymbol = isSymbol;
-exports.isTypedArray = isTypedArray;
 exports.isUndefined = isUndefined;
 exports.isWeakMap = isWeakMap;
 exports.isWeakSet = isWeakSet;
-exports.mapTag = mapTag;
-exports.numberTag = numberTag;
-exports.objectTag = objectTag;
-exports.regexpTag = regexpTag;
-exports.setTag = setTag;
-exports.stringTag = stringTag;
-exports.symbolTag = symbolTag;
-exports.uint16ArrayTag = uint16ArrayTag;
-exports.uint32ArrayTag = uint32ArrayTag;
-exports.uint8ArrayTag = uint8ArrayTag;
-exports.uint8ClampedArrayTag = uint8ClampedArrayTag;

package/dist/_chunk/snakeCase-BwvoPi.js

@@ -0,0 +1,30 @@
+'use strict';
+
+function capitalize(str) {
+    return (str.charAt(0).toUpperCase() + str.slice(1).toLowerCase());
+}
+
+const CASE_SPLIT_PATTERN = /\p{Lu}?\p{Ll}+|[0-9]+|\p{Lu}+(?!\p{Ll})|\p{Emoji_Presentation}|\p{Extended_Pictographic}|\p{L}+/gu;
+function words(str) {
+    return Array.from(str.match(CASE_SPLIT_PATTERN) ?? []);
+}
+
+function camelCase(str) {
+    const words$1 = words(str);
+    if (words$1.length === 0) {
+        return '';
+    }
+    const [first, ...rest] = words$1;
+    return `${first.toLowerCase()}${rest.map(word => capitalize(word)).join('')}`;
+}
+
+function snakeCase(str) {
+    const words$1 = words(str);
+    return words$1.map(word => word.toLowerCase()).join('_');
+}
+
+exports.CASE_SPLIT_PATTERN = CASE_SPLIT_PATTERN;
+exports.camelCase = camelCase;
+exports.capitalize = capitalize;
+exports.snakeCase = snakeCase;
+exports.words = words;