es-toolkit 1.30.1 → 1.31.0-dev.989

package/dist/compat/index.mjs

@@ -21,6 +21,7 @@ export { unionBy } from '../array/unionBy.mjs';
 export { unionWith } from '../array/unionWith.mjs';
 export { uniqWith } from '../array/uniqWith.mjs';
 export { unzipWith } from '../array/unzipWith.mjs';
+export { windowed } from '../array/windowed.mjs';
 export { xor } from '../array/xor.mjs';
 export { xorBy } from '../array/xorBy.mjs';
 export { xorWith } from '../array/xorWith.mjs';
@@ -28,9 +29,9 @@ export { zipObject } from '../array/zipObject.mjs';
 export { zipWith } from '../array/zipWith.mjs';
 export { AbortError } from '../error/AbortError.mjs';
 export { TimeoutError } from '../error/TimeoutError.mjs';
+export { asyncNoop } from '../function/asyncNoop.mjs';
 export { identity } from '../function/identity.mjs';
 export { memoize } from '../function/memoize.mjs';
-export { negate } from '../function/negate.mjs';
 export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { partial } from '../function/partial.mjs';
@@ -50,7 +51,6 @@ export { omitBy } from '../object/omitBy.mjs';
 export { pickBy } from '../object/pickBy.mjs';
 export { toMerged } from '../object/toMerged.mjs';
 export { isBlob } from '../predicate/isBlob.mjs';
-export { isBuffer } from '../predicate/isBuffer.mjs';
 export { isEqual } from '../predicate/isEqual.mjs';
 export { eq } from './util/eq.mjs';
 export { isFile } from '../predicate/isFile.mjs';
@@ -100,6 +100,9 @@ export { map } from './array/map.mjs';
 export { nth } from './array/nth.mjs';
 export { orderBy } from './array/orderBy.mjs';
 export { pull } from './array/pull.mjs';
+export { pullAll } from './array/pullAll.mjs';
+export { remove } from './array/remove.mjs';
+export { reverse } from './array/reverse.mjs';
 export { sample } from './array/sample.mjs';
 export { size } from './array/size.mjs';
 export { slice } from './array/slice.mjs';
@@ -130,6 +133,7 @@ export { delay } from './function/delay.mjs';
 export { flip } from './function/flip.mjs';
 export { flow } from './function/flow.mjs';
 export { flowRight } from './function/flowRight.mjs';
+export { negate } from './function/negate.mjs';
 export { nthArg } from './function/nthArg.mjs';
 export { rearg } from './function/rearg.mjs';
 export { rest } from './function/rest.mjs';
@@ -147,6 +151,7 @@ export { random } from './math/random.mjs';
 export { range } from './math/range.mjs';
 export { rangeRight } from './math/rangeRight.mjs';
 export { round } from './math/round.mjs';
+export { subtract } from './math/subtract.mjs';
 export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { assignIn, assignIn as extend } from './object/assignIn.mjs';
@@ -179,6 +184,7 @@ export { isArrayBuffer } from './predicate/isArrayBuffer.mjs';
 export { isArrayLike } from './predicate/isArrayLike.mjs';
 export { isArrayLikeObject } from './predicate/isArrayLikeObject.mjs';
 export { isBoolean } from './predicate/isBoolean.mjs';
+export { isBuffer } from './predicate/isBuffer.mjs';
 export { isDate } from './predicate/isDate.mjs';
 export { isElement } from './predicate/isElement.mjs';
 export { isEmpty } from './predicate/isEmpty.mjs';
@@ -238,6 +244,7 @@ export { iteratee } from './util/iteratee.mjs';
 export { lt } from './util/lt.mjs';
 export { lte } from './util/lte.mjs';
 export { method } from './util/method.mjs';
+export { methodOf } from './util/methodOf.mjs';
 export { now } from './util/now.mjs';
 export { stubArray } from './util/stubArray.mjs';
 export { stubFalse } from './util/stubFalse.mjs';

package/dist/compat/math/subtract.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Subtracts one number from another.
+ *
+ * If either of the numbers is `NaN`, the function returns `NaN`.
+ *
+ * @param {number} value The first number. (minuend)
+ * @param {number} other The second number.(subtrahend)
+ * @returns {number} The difference of the two numbers, or `NaN` if any input is `NaN`.
+ *
+ * @example
+ * subtract(6, 3); // => 3
+ * subtract(6, NaN); // => NaN
+ * subtract(NaN, 3); // => NaN
+ */
+declare function subtract(value: number, other: number): number;
+
+export { subtract };

package/dist/compat/math/subtract.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Subtracts one number from another.
+ *
+ * If either of the numbers is `NaN`, the function returns `NaN`.
+ *
+ * @param {number} value The first number. (minuend)
+ * @param {number} other The second number.(subtrahend)
+ * @returns {number} The difference of the two numbers, or `NaN` if any input is `NaN`.
+ *
+ * @example
+ * subtract(6, 3); // => 3
+ * subtract(6, NaN); // => NaN
+ * subtract(NaN, 3); // => NaN
+ */
+declare function subtract(value: number, other: number): number;
+
+export { subtract };

package/dist/compat/math/subtract.mjs

@@ -0,0 +1,5 @@
+function subtract(value, other) {
+    return value - other;
+}
+
+export { subtract };

package/dist/compat/object/mergeWith.mjs

@@ -1,5 +1,6 @@
 import { cloneDeep } from './cloneDeep.mjs';
 import { clone } from '../../object/clone.mjs';
+import { isPrimitive } from '../../predicate/isPrimitive.mjs';
 import { getSymbols } from '../_internal/getSymbols.mjs';
 import { isArguments } from '../predicate/isArguments.mjs';
 import { isObjectLike } from '../predicate/isObjectLike.mjs';
@@ -12,11 +13,14 @@ function mergeWith(object, ...otherArgs) {
     let result = object;
     for (let i = 0; i < sources.length; i++) {
         const source = sources[i];
-        result = mergeWithDeep(object, source, merge, new Map());
+        result = mergeWithDeep(result, source, merge, new Map());
     }
     return result;
 }
 function mergeWithDeep(target, source, merge, stack) {
+    if (isPrimitive(target)) {
+        target = Object(target);
+    }
     if (source == null || typeof source !== 'object') {
         return target;
     }
@@ -45,7 +49,7 @@ function mergeWithDeep(target, source, merge, stack) {
             sourceValue = cloneDeep(sourceValue);
         }
         if (Array.isArray(sourceValue)) {
-            if (typeof targetValue === 'object') {
+            if (typeof targetValue === 'object' && targetValue != null) {
                 const cloned = [];
                 const targetKeys = Reflect.ownKeys(targetValue);
                 for (let i = 0; i < targetKeys.length; i++) {

package/dist/compat/predicate/isBuffer.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a Buffer instance.
+ *
+ * This function tests whether the provided value is an instance of Buffer.
+ * It returns `true` if the value is a Buffer, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `Buffer`.
+ *
+ * @param {unknown} x - The value to check if it is a Buffer.
+ * @returns {boolean} Returns `true` if `x` is a Buffer, else `false`.
+ *
+ * @example
+ * const buffer = Buffer.from("test");
+ * console.log(isBuffer(buffer)); // true
+ *
+ * const notBuffer = "not a buffer";
+ * console.log(isBuffer(notBuffer)); // false
+ */
+declare function isBuffer(x?: unknown): boolean;
+
+export { isBuffer };

package/dist/compat/predicate/isBuffer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Checks if the given value is a Buffer instance.
+ *
+ * This function tests whether the provided value is an instance of Buffer.
+ * It returns `true` if the value is a Buffer, and `false` otherwise.
+ *
+ * This function can also serve as a type predicate in TypeScript, narrowing the type of the argument to `Buffer`.
+ *
+ * @param {unknown} x - The value to check if it is a Buffer.
+ * @returns {boolean} Returns `true` if `x` is a Buffer, else `false`.
+ *
+ * @example
+ * const buffer = Buffer.from("test");
+ * console.log(isBuffer(buffer)); // true
+ *
+ * const notBuffer = "not a buffer";
+ * console.log(isBuffer(notBuffer)); // false
+ */
+declare function isBuffer(x?: unknown): boolean;
+
+export { isBuffer };

package/dist/compat/predicate/isBuffer.mjs

@@ -0,0 +1,7 @@
+import { isBuffer as isBuffer$1 } from '../../predicate/isBuffer.mjs';
+
+function isBuffer(x) {
+    return isBuffer$1(x);
+}
+
+export { isBuffer };

package/dist/compat/predicate/isMatch.mjs

@@ -13,10 +13,7 @@ function isMatch(target, source) {
             }
             const keys = Object.keys(source);
             if (target == null) {
-                if (keys.length === 0) {
-                    return true;
-                }
-                return false;
+                return keys.length === 0;
             }
             if (Array.isArray(source)) {
                 return isArrayMatch(target, source);

package/dist/compat/util/methodOf.d.mts

@@ -0,0 +1,22 @@
+/**
+ * Creates a function that invokes the method at a given path of `object` with the provided arguments.
+ *
+ * @param {object} object - The object to query.
+ * @param {...any} args - The arguments to invoke the method with.
+ * @returns {(path: PropertyKey | PropertyKey[]) => any} - Returns a new function that takes a path and invokes the method at `path` with `args`.
+ *
+ * @example
+ * const object = {
+ *  a: {
+ *   b: function (x, y) {
+ *    return x + y;
+ *    }
+ *   }
+ * };
+ *
+ * const add = methodOf(object, 1, 2);
+ * console.log(add('a.b')); // => 3
+ */
+declare function methodOf(object: object, ...args: any[]): (path: PropertyKey | PropertyKey[]) => any;
+
+export { methodOf };

package/dist/compat/util/methodOf.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Creates a function that invokes the method at a given path of `object` with the provided arguments.
+ *
+ * @param {object} object - The object to query.
+ * @param {...any} args - The arguments to invoke the method with.
+ * @returns {(path: PropertyKey | PropertyKey[]) => any} - Returns a new function that takes a path and invokes the method at `path` with `args`.
+ *
+ * @example
+ * const object = {
+ *  a: {
+ *   b: function (x, y) {
+ *    return x + y;
+ *    }
+ *   }
+ * };
+ *
+ * const add = methodOf(object, 1, 2);
+ * console.log(add('a.b')); // => 3
+ */
+declare function methodOf(object: object, ...args: any[]): (path: PropertyKey | PropertyKey[]) => any;
+
+export { methodOf };

package/dist/compat/util/methodOf.mjs

@@ -0,0 +1,9 @@
+import { invoke } from './invoke.mjs';
+
+function methodOf(object, ...args) {
+    return function (path) {
+        return invoke(object, path, args);
+    };
+}
+
+export { methodOf };

package/dist/function/asyncNoop.d.mts

@@ -0,0 +1,12 @@
+/**
+ * An asynchronous no-operation function that does nothing.
+ * This can be used as a placeholder or default function.
+ *
+ * @example
+ * asyncNoop(); // Does nothing
+ *
+ * @returns {Promise<void>} This function returns a Promise that resolves to undefined.
+ */
+declare function asyncNoop(): Promise<void>;
+
+export { asyncNoop };

package/dist/function/asyncNoop.d.ts

@@ -0,0 +1,12 @@
+/**
+ * An asynchronous no-operation function that does nothing.
+ * This can be used as a placeholder or default function.
+ *
+ * @example
+ * asyncNoop(); // Does nothing
+ *
+ * @returns {Promise<void>} This function returns a Promise that resolves to undefined.
+ */
+declare function asyncNoop(): Promise<void>;
+
+export { asyncNoop };

package/dist/function/asyncNoop.mjs

@@ -0,0 +1,3 @@
+async function asyncNoop() { }
+
+export { asyncNoop };

package/dist/function/index.d.mts

@@ -1,5 +1,6 @@
 export { after } from './after.mjs';
 export { ary } from './ary.mjs';
+export { asyncNoop } from './asyncNoop.mjs';
 export { before } from './before.mjs';
 export { curry } from './curry.mjs';
 export { curryRight } from './curryRight.mjs';

package/dist/function/index.d.ts

@@ -1,5 +1,6 @@
 export { after } from './after.js';
 export { ary } from './ary.js';
+export { asyncNoop } from './asyncNoop.js';
 export { before } from './before.js';
 export { curry } from './curry.js';
 export { curryRight } from './curryRight.js';

package/dist/function/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const unary = require('../_chunk/unary-CcTNuC.js');
+const unary = require('../_chunk/unary-B6qG7C.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 
 function before(n, func) {
@@ -87,6 +87,7 @@ function throttle(func, throttleMs, { signal, edges = ['leading', 'trailing'] }
 
 exports.after = unary.after;
 exports.ary = unary.ary;
+exports.asyncNoop = unary.asyncNoop;
 exports.debounce = unary.debounce;
 exports.flow = unary.flow;
 exports.flowRight = unary.flowRight;

package/dist/function/index.mjs

@@ -1,5 +1,6 @@
 export { after } from './after.mjs';
 export { ary } from './ary.mjs';
+export { asyncNoop } from './asyncNoop.mjs';
 export { before } from './before.mjs';
 export { curry } from './curry.mjs';
 export { curryRight } from './curryRight.mjs';

package/dist/index.d.mts

@@ -31,6 +31,7 @@ export { orderBy } from './array/orderBy.mjs';
 export { partition } from './array/partition.mjs';
 export { pull } from './array/pull.mjs';
 export { pullAt } from './array/pullAt.mjs';
+export { remove } from './array/remove.mjs';
 export { sample } from './array/sample.mjs';
 export { sampleSize } from './array/sampleSize.mjs';
 export { shuffle } from './array/shuffle.mjs';
@@ -49,6 +50,7 @@ export { uniqBy } from './array/uniqBy.mjs';
 export { uniqWith } from './array/uniqWith.mjs';
 export { unzip } from './array/unzip.mjs';
 export { unzipWith } from './array/unzipWith.mjs';
+export { windowed } from './array/windowed.mjs';
 export { without } from './array/without.mjs';
 export { xor } from './array/xor.mjs';
 export { xorBy } from './array/xorBy.mjs';
@@ -60,6 +62,7 @@ export { AbortError } from './error/AbortError.mjs';
 export { TimeoutError } from './error/TimeoutError.mjs';
 export { after } from './function/after.mjs';
 export { ary } from './function/ary.mjs';
+export { asyncNoop } from './function/asyncNoop.mjs';
 export { before } from './function/before.mjs';
 export { curry } from './function/curry.mjs';
 export { curryRight } from './function/curryRight.mjs';

package/dist/index.d.ts

@@ -31,6 +31,7 @@ export { orderBy } from './array/orderBy.js';
 export { partition } from './array/partition.js';
 export { pull } from './array/pull.js';
 export { pullAt } from './array/pullAt.js';
+export { remove } from './array/remove.js';
 export { sample } from './array/sample.js';
 export { sampleSize } from './array/sampleSize.js';
 export { shuffle } from './array/shuffle.js';
@@ -49,6 +50,7 @@ export { uniqBy } from './array/uniqBy.js';
 export { uniqWith } from './array/uniqWith.js';
 export { unzip } from './array/unzip.js';
 export { unzipWith } from './array/unzipWith.js';
+export { windowed } from './array/windowed.js';
 export { without } from './array/without.js';
 export { xor } from './array/xor.js';
 export { xorBy } from './array/xorBy.js';
@@ -60,6 +62,7 @@ export { AbortError } from './error/AbortError.js';
 export { TimeoutError } from './error/TimeoutError.js';
 export { after } from './function/after.js';
 export { ary } from './function/ary.js';
+export { asyncNoop } from './function/asyncNoop.js';
 export { before } from './function/before.js';
 export { curry } from './function/curry.js';
 export { curryRight } from './function/curryRight.js';

package/dist/index.js

@@ -2,10 +2,10 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('./_chunk/zipWith-nbzldx.js');
+const zipWith = require('./_chunk/zipWith-Bdyzuy.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
-const unary = require('./_chunk/unary-CcTNuC.js');
+const unary = require('./_chunk/unary-B6qG7C.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
 const range = require('./_chunk/range-HnEIT7.js');
@@ -54,6 +54,7 @@ exports.minBy = zipWith.minBy;
 exports.partition = zipWith.partition;
 exports.pull = zipWith.pull;
 exports.pullAt = zipWith.pullAt;
+exports.remove = zipWith.remove;
 exports.sample = zipWith.sample;
 exports.sampleSize = zipWith.sampleSize;
 exports.shuffle = zipWith.shuffle;
@@ -70,6 +71,7 @@ exports.uniqBy = zipWith.uniqBy;
 exports.uniqWith = zipWith.uniqWith;
 exports.unzip = zipWith.unzip;
 exports.unzipWith = zipWith.unzipWith;
+exports.windowed = zipWith.windowed;
 exports.without = zipWith.without;
 exports.xor = zipWith.xor;
 exports.xorBy = zipWith.xorBy;
@@ -87,6 +89,7 @@ exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = unary.after;
 exports.ary = unary.ary;
+exports.asyncNoop = unary.asyncNoop;
 exports.debounce = unary.debounce;
 exports.flow = unary.flow;
 exports.flowRight = unary.flowRight;

package/dist/index.mjs

@@ -31,6 +31,7 @@ export { orderBy } from './array/orderBy.mjs';
 export { partition } from './array/partition.mjs';
 export { pull } from './array/pull.mjs';
 export { pullAt } from './array/pullAt.mjs';
+export { remove } from './array/remove.mjs';
 export { sample } from './array/sample.mjs';
 export { sampleSize } from './array/sampleSize.mjs';
 export { shuffle } from './array/shuffle.mjs';
@@ -49,6 +50,7 @@ export { uniqBy } from './array/uniqBy.mjs';
 export { uniqWith } from './array/uniqWith.mjs';
 export { unzip } from './array/unzip.mjs';
 export { unzipWith } from './array/unzipWith.mjs';
+export { windowed } from './array/windowed.mjs';
 export { without } from './array/without.mjs';
 export { xor } from './array/xor.mjs';
 export { xorBy } from './array/xorBy.mjs';
@@ -60,6 +62,7 @@ export { AbortError } from './error/AbortError.mjs';
 export { TimeoutError } from './error/TimeoutError.mjs';
 export { after } from './function/after.mjs';
 export { ary } from './function/ary.mjs';
+export { asyncNoop } from './function/asyncNoop.mjs';
 export { before } from './function/before.mjs';
 export { curry } from './function/curry.mjs';
 export { curryRight } from './function/curryRight.mjs';

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.30.1",
+  "version": "1.31.0-dev.989+32a18382",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {