es-toolkit 1.29.0 → 1.30.0

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

@@ -0,0 +1,15 @@
+/**
+ * Checks if value is less than or equal to other.
+ *
+ * @param {unknown} value The value to compare.
+ * @param {unknown} other The other value to compare.
+ * @returns {boolean} Returns `true` if value is less than or equal to other, else `false`.
+ *
+ * @example
+ * lte(1, 3); // => true
+ * lte(3, 3); // => true
+ * lte(3, 1); // => false
+ */
+declare function lte(value: unknown, other: unknown): boolean;
+
+export { lte };

package/dist/compat/util/lte.mjs

@@ -0,0 +1,10 @@
+import { toNumber } from './toNumber.mjs';
+
+function lte(value, other) {
+    if (typeof value === 'string' && typeof other === 'string') {
+        return value <= other;
+    }
+    return toNumber(value) <= toNumber(other);
+}
+
+export { lte };

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

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

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

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

package/dist/compat/util/method.mjs

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

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

@@ -0,0 +1,18 @@
+/**
+ * Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+ *
+ * @returns {number} The current time in milliseconds.
+ *
+ * @example
+ * const currentTime = now();
+ * console.log(currentTime); // Outputs the current time in milliseconds
+ *
+ * @example
+ * const startTime = now();
+ * // Some time-consuming operation
+ * const endTime = now();
+ * console.log(`Operation took ${endTime - startTime} milliseconds`);
+ */
+declare function now(): number;
+
+export { now };

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

@@ -0,0 +1,18 @@
+/**
+ * Returns the number of milliseconds elapsed since January 1, 1970 00:00:00 UTC.
+ *
+ * @returns {number} The current time in milliseconds.
+ *
+ * @example
+ * const currentTime = now();
+ * console.log(currentTime); // Outputs the current time in milliseconds
+ *
+ * @example
+ * const startTime = now();
+ * // Some time-consuming operation
+ * const endTime = now();
+ * console.log(`Operation took ${endTime - startTime} milliseconds`);
+ */
+declare function now(): number;
+
+export { now };

package/dist/compat/util/now.mjs

@@ -0,0 +1,5 @@
+function now() {
+    return Date.now();
+}
+
+export { now };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns a new empty array.
+ *
+ * @returns {Array} A new empty array.
+ * @example
+ * stubArray() // Returns []
+ */
+declare function stubArray(): [];
+
+export { stubArray };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns a new empty array.
+ *
+ * @returns {Array} A new empty array.
+ * @example
+ * stubArray() // Returns []
+ */
+declare function stubArray(): [];
+
+export { stubArray };

package/dist/compat/util/stubArray.mjs

@@ -0,0 +1,5 @@
+function stubArray() {
+    return [];
+}
+
+export { stubArray };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns false.
+ *
+ * @returns {boolean} false.
+ * @example
+ * stubFalse() // Returns false
+ */
+declare function stubFalse(): boolean;
+
+export { stubFalse };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns false.
+ *
+ * @returns {boolean} false.
+ * @example
+ * stubFalse() // Returns false
+ */
+declare function stubFalse(): boolean;
+
+export { stubFalse };

package/dist/compat/util/stubFalse.mjs

@@ -0,0 +1,5 @@
+function stubFalse() {
+    return false;
+}
+
+export { stubFalse };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns an empty object.
+ *
+ * @returns {Object} An empty object.
+ * @example
+ * stubObject() // Returns {}
+ */
+declare function stubObject(): {};
+
+export { stubObject };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns an empty object.
+ *
+ * @returns {Object} An empty object.
+ * @example
+ * stubObject() // Returns {}
+ */
+declare function stubObject(): {};
+
+export { stubObject };

package/dist/compat/util/stubObject.mjs

@@ -0,0 +1,5 @@
+function stubObject() {
+    return {};
+}
+
+export { stubObject };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns an empty string.
+ *
+ * @returns {string} An empty string.
+ * @example
+ * stubString() // Returns ''
+ */
+declare function stubString(): '';
+
+export { stubString };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns an empty string.
+ *
+ * @returns {string} An empty string.
+ * @example
+ * stubString() // Returns ''
+ */
+declare function stubString(): '';
+
+export { stubString };

package/dist/compat/util/stubString.mjs

@@ -0,0 +1,5 @@
+function stubString() {
+    return '';
+}
+
+export { stubString };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns true.
+ *
+ * @returns {boolean} true.
+ * @example
+ * stubTrue() // Returns true
+ */
+declare function stubTrue(): boolean;
+
+export { stubTrue };

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

@@ -0,0 +1,10 @@
+/**
+ * Returns true.
+ *
+ * @returns {boolean} true.
+ * @example
+ * stubTrue() // Returns true
+ */
+declare function stubTrue(): boolean;
+
+export { stubTrue };

package/dist/compat/util/stubTrue.mjs

@@ -0,0 +1,5 @@
+function stubTrue() {
+    return true;
+}
+
+export { stubTrue };

package/dist/compat/util/toArray.mjs

@@ -8,9 +8,6 @@ function toArray(value) {
     if (isArrayLike(value) || isMap(value)) {
         return Array.from(value);
     }
-    if (typeof value === 'string') {
-        return value.split('');
-    }
     if (typeof value === 'object') {
         return Object.values(value);
     }

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

@@ -0,0 +1,16 @@
+/**
+ * Converts value to a plain object flattening inherited enumerable string keyed properties of value to own properties of the plain object.
+ *
+ * @param {any} value The value to convert.
+ * @returns {Record<string, any>} Returns the converted plain object.
+ *
+ * @example
+ * function Foo() {
+ *   this.b = 2;
+ * }
+ * Foo.prototype.c = 3;
+ * toPlainObject(new Foo()); // { b: 2, c: 3 }
+ */
+declare function toPlainObject(value: any): Record<string, any>;
+
+export { toPlainObject };

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

@@ -0,0 +1,16 @@
+/**
+ * Converts value to a plain object flattening inherited enumerable string keyed properties of value to own properties of the plain object.
+ *
+ * @param {any} value The value to convert.
+ * @returns {Record<string, any>} Returns the converted plain object.
+ *
+ * @example
+ * function Foo() {
+ *   this.b = 2;
+ * }
+ * Foo.prototype.c = 3;
+ * toPlainObject(new Foo()); // { b: 2, c: 3 }
+ */
+declare function toPlainObject(value: any): Record<string, any>;
+
+export { toPlainObject };

package/dist/compat/util/toPlainObject.mjs

@@ -0,0 +1,24 @@
+import { keysIn } from '../object/keysIn.mjs';
+
+function toPlainObject(value) {
+    const plainObject = {};
+    const valueKeys = keysIn(value);
+    for (let i = 0; i < valueKeys.length; i++) {
+        const key = valueKeys[i];
+        const objValue = value[key];
+        if (key === '__proto__') {
+            Object.defineProperty(plainObject, key, {
+                configurable: true,
+                enumerable: true,
+                value: objValue,
+                writable: true,
+            });
+        }
+        else {
+            plainObject[key] = objValue;
+        }
+    }
+    return plainObject;
+}
+
+export { toPlainObject };

package/dist/index.d.mts

@@ -29,6 +29,7 @@ export { maxBy } from './array/maxBy.mjs';
 export { minBy } from './array/minBy.mjs';
 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 { sample } from './array/sample.mjs';
 export { sampleSize } from './array/sampleSize.mjs';

package/dist/index.d.ts

@@ -29,6 +29,7 @@ export { maxBy } from './array/maxBy.js';
 export { minBy } from './array/minBy.js';
 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 { sample } from './array/sample.js';
 export { sampleSize } from './array/sampleSize.js';

package/dist/index.js

@@ -2,13 +2,13 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const zipWith = require('./_chunk/zipWith-Bb2eZI.js');
+const zipWith = require('./_chunk/zipWith-nbzldx.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
 const unary = require('./_chunk/unary-CcTNuC.js');
 const function_index = require('./function/index.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
-const rangeRight = require('./_chunk/rangeRight-w3WrXN.js');
+const range = require('./_chunk/range-HnEIT7.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
 const toMerged = require('./_chunk/toMerged-DGFrN7.js');
@@ -52,6 +52,7 @@ exports.last = zipWith.last;
 exports.maxBy = zipWith.maxBy;
 exports.minBy = zipWith.minBy;
 exports.partition = zipWith.partition;
+exports.pull = zipWith.pull;
 exports.pullAt = zipWith.pullAt;
 exports.sample = zipWith.sample;
 exports.sampleSize = zipWith.sampleSize;
@@ -59,7 +60,6 @@ exports.shuffle = zipWith.shuffle;
 exports.tail = zipWith.tail;
 exports.take = zipWith.take;
 exports.takeRight = zipWith.takeRight;
-exports.takeRightWhile = zipWith.takeRightWhile;
 exports.takeWhile = zipWith.takeWhile;
 exports.toFilled = zipWith.toFilled;
 exports.union = zipWith.union;
@@ -79,6 +79,7 @@ exports.zipObject = zipWith.zipObject;
 exports.zipWith = zipWith.zipWith;
 exports.orderBy = array_index.orderBy;
 exports.sortBy = array_index.sortBy;
+exports.takeRightWhile = array_index.takeRightWhile;
 exports.AbortError = promise_index.AbortError;
 exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
@@ -103,17 +104,17 @@ exports.curryRight = function_index.curryRight;
 exports.spread = function_index.spread;
 exports.throttle = function_index.throttle;
 exports.noop = noop.noop;
-exports.clamp = rangeRight.clamp;
-exports.inRange = rangeRight.inRange;
-exports.mean = rangeRight.mean;
-exports.meanBy = rangeRight.meanBy;
-exports.median = rangeRight.median;
-exports.medianBy = rangeRight.medianBy;
-exports.range = rangeRight.range;
-exports.rangeRight = rangeRight.rangeRight;
-exports.sum = rangeRight.sum;
+exports.clamp = range.clamp;
+exports.inRange = range.inRange;
+exports.mean = range.mean;
+exports.meanBy = range.meanBy;
+exports.median = range.median;
+exports.medianBy = range.medianBy;
+exports.range = range.range;
+exports.sum = range.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
+exports.rangeRight = math_index.rangeRight;
 exports.round = math_index.round;
 exports.sumBy = math_index.sumBy;
 exports.clone = toMerged.clone;

package/dist/index.mjs

@@ -29,6 +29,7 @@ export { maxBy } from './array/maxBy.mjs';
 export { minBy } from './array/minBy.mjs';
 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 { sample } from './array/sample.mjs';
 export { sampleSize } from './array/sampleSize.mjs';

package/dist/math/index.js

@@ -2,9 +2,25 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
+const range = require('../_chunk/range-HnEIT7.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
+function rangeRight(start, end, step = 1) {
+    if (end == null) {
+        end = start;
+        start = 0;
+    }
+    if (!Number.isInteger(step) || step === 0) {
+        throw new Error(`The step value must be a non-zero integer.`);
+    }
+    const length = Math.max(Math.ceil((end - start) / step), 0);
+    const result = new Array(length);
+    for (let i = 0; i < length; i++) {
+        result[i] = start + (length - i - 1) * step;
+    }
+    return result;
+}
+
 function round(value, precision = 0) {
     if (!Number.isInteger(precision)) {
         throw new Error('Precision must be an integer.');
@@ -21,16 +37,16 @@ function sumBy(items, getValue) {
     return result;
 }
 
-exports.clamp = rangeRight.clamp;
-exports.inRange = rangeRight.inRange;
-exports.mean = rangeRight.mean;
-exports.meanBy = rangeRight.meanBy;
-exports.median = rangeRight.median;
-exports.medianBy = rangeRight.medianBy;
-exports.range = rangeRight.range;
-exports.rangeRight = rangeRight.rangeRight;
-exports.sum = rangeRight.sum;
+exports.clamp = range.clamp;
+exports.inRange = range.inRange;
+exports.mean = range.mean;
+exports.meanBy = range.meanBy;
+exports.median = range.median;
+exports.medianBy = range.medianBy;
+exports.range = range.range;
+exports.sum = range.sum;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
+exports.rangeRight = rangeRight;
 exports.round = round;
 exports.sumBy = sumBy;

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.29.0",
+  "version": "1.30.0",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {

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

@@ -1,25 +0,0 @@
-/**
- * Generates a unique identifier, optionally prefixed with a given string.
- *
- * @param {string} [prefix] - An optional string to prefix the unique identifier.
- *                            If not provided or not a string, only the unique
- *                            numeric identifier is returned.
- * @returns {string} A string containing the unique identifier, with the optional
- *                   prefix if provided.
- *
- * @example
- * // Generate a unique ID with a prefix
- * uniqueId('user_');  // => 'user_1'
- *
- * @example
- * // Generate a unique ID without a prefix
- * uniqueId();  // => '2'
- *
- * @example
- * // Subsequent calls increment the internal counter
- * uniqueId('item_');  // => 'item_3'
- * uniqueId();         // => '4'
- */
-declare function uniqueId(prefix?: string): string;
-
-export { uniqueId };

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

@@ -1,25 +0,0 @@
-/**
- * Generates a unique identifier, optionally prefixed with a given string.
- *
- * @param {string} [prefix] - An optional string to prefix the unique identifier.
- *                            If not provided or not a string, only the unique
- *                            numeric identifier is returned.
- * @returns {string} A string containing the unique identifier, with the optional
- *                   prefix if provided.
- *
- * @example
- * // Generate a unique ID with a prefix
- * uniqueId('user_');  // => 'user_1'
- *
- * @example
- * // Generate a unique ID without a prefix
- * uniqueId();  // => '2'
- *
- * @example
- * // Subsequent calls increment the internal counter
- * uniqueId('item_');  // => 'item_3'
- * uniqueId();         // => '4'
- */
-declare function uniqueId(prefix?: string): string;
-
-export { uniqueId };

package/dist/compat/util/uniqueId.mjs

@@ -1,7 +0,0 @@
-let idCounter = 0;
-function uniqueId(prefix = '') {
-    const id = ++idCounter;
-    return `${prefix}${id}`;
-}
-
-export { uniqueId };