es-toolkit 1.29.0-dev.952 → 1.29.0-dev.954

package/dist/compat/index.d.mts

@@ -42,8 +42,6 @@ export { meanBy } from '../math/meanBy.mjs';
 export { median } from '../math/median.mjs';
 export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
-export { range } from '../math/range.mjs';
-export { rangeRight } from '../math/rangeRight.mjs';
 export { clone } from '../object/clone.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
 export { invert } from '../object/invert.mjs';
@@ -144,6 +142,8 @@ export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
 export { parseInt } from './math/parseInt.mjs';
 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 { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';

package/dist/compat/index.d.ts

@@ -42,8 +42,6 @@ export { meanBy } from '../math/meanBy.js';
 export { median } from '../math/median.js';
 export { medianBy } from '../math/medianBy.js';
 export { randomInt } from '../math/randomInt.js';
-export { range } from '../math/range.js';
-export { rangeRight } from '../math/rangeRight.js';
 export { clone } from '../object/clone.js';
 export { flattenObject } from '../object/flattenObject.js';
 export { invert } from '../object/invert.js';
@@ -144,6 +142,8 @@ export { max } from './math/max.js';
 export { min } from './math/min.js';
 export { parseInt } from './math/parseInt.js';
 export { random } from './math/random.js';
+export { range } from './math/range.js';
+export { rangeRight } from './math/rangeRight.js';
 export { round } from './math/round.js';
 export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';

package/dist/compat/index.js

@@ -6,7 +6,7 @@ const zipWith = require('../_chunk/zipWith-nbzldx.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
 const unary = require('../_chunk/unary-CcTNuC.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const rangeRight = require('../_chunk/rangeRight-w3WrXN.js');
+const range$1 = require('../_chunk/range-HnEIT7.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const toMerged = require('../_chunk/toMerged-DGFrN7.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-octpoD.js');
@@ -875,7 +875,7 @@ function forEach(collection, callback = unary.identity) {
     if (!collection) {
         return collection;
     }
-    const keys = isArrayLike(collection) || Array.isArray(collection) ? rangeRight.range(0, collection.length) : Object.keys(collection);
+    const keys = isArrayLike(collection) || Array.isArray(collection) ? range$1.range(0, collection.length) : Object.keys(collection);
     for (let i = 0; i < keys.length; i++) {
         const key = keys[i];
         const value = collection[key];
@@ -1024,7 +1024,7 @@ function map(collection, _iteratee) {
     if (!collection) {
         return [];
     }
-    const keys = isArrayLike(collection) || Array.isArray(collection) ? rangeRight.range(0, collection.length) : Object.keys(collection);
+    const keys = isArrayLike(collection) || Array.isArray(collection) ? range$1.range(0, collection.length) : Object.keys(collection);
     const iteratee$1 = iteratee(_iteratee ?? unary.identity);
     const result = new Array(keys.length);
     for (let i = 0; i < keys.length; i++) {
@@ -1769,7 +1769,7 @@ function clamp(value, bound1, bound2) {
     if (Number.isNaN(bound2)) {
         bound2 = 0;
     }
-    return rangeRight.clamp(value, bound1, bound2);
+    return range$1.clamp(value, bound1, bound2);
 }
 
 function floor(number, precision = 0) {
@@ -1798,7 +1798,7 @@ function inRange(value, minimum, maximum) {
     if (minimum === maximum) {
         return false;
     }
-    return rangeRight.inRange(value, minimum, maximum);
+    return range$1.inRange(value, minimum, maximum);
 }
 
 function max(items = []) {
@@ -1899,6 +1899,50 @@ function random(...args) {
     }
 }
 
+function range(start, end, step) {
+    if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
+        end = step = undefined;
+    }
+    start = toFinite(start);
+    if (end === undefined) {
+        end = start;
+        start = 0;
+    }
+    else {
+        end = toFinite(end);
+    }
+    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
+    const result = new Array(length);
+    for (let index = 0; index < length; index++) {
+        result[index] = start;
+        start += step;
+    }
+    return result;
+}
+
+function rangeRight(start, end, step) {
+    if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
+        end = step = undefined;
+    }
+    start = toFinite(start);
+    if (end === undefined) {
+        end = start;
+        start = 0;
+    }
+    else {
+        end = toFinite(end);
+    }
+    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
+    const result = new Array(length);
+    for (let index = length - 1; index >= 0; index--) {
+        result[index] = start;
+        start += step;
+    }
+    return result;
+}
+
 function round(number, precision = 0) {
     return decimalAdjust('round', number, precision);
 }
@@ -2977,12 +3021,10 @@ exports.partial = unary.partial;
 exports.partialRight = unary.partialRight;
 exports.unary = unary.unary;
 exports.noop = noop.noop;
-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.mean = range$1.mean;
+exports.meanBy = range$1.meanBy;
+exports.median = range$1.median;
+exports.medianBy = range$1.medianBy;
 exports.randomInt = randomInt.randomInt;
 exports.clone = toMerged.clone;
 exports.flattenObject = toMerged.flattenObject;
@@ -3140,6 +3182,8 @@ exports.property = property;
 exports.propertyOf = propertyOf;
 exports.pull = pull;
 exports.random = random;
+exports.range = range;
+exports.rangeRight = rangeRight;
 exports.rearg = rearg;
 exports.repeat = repeat;
 exports.replace = replace;

package/dist/compat/index.mjs

@@ -41,8 +41,6 @@ export { meanBy } from '../math/meanBy.mjs';
 export { median } from '../math/median.mjs';
 export { medianBy } from '../math/medianBy.mjs';
 export { randomInt } from '../math/randomInt.mjs';
-export { range } from '../math/range.mjs';
-export { rangeRight } from '../math/rangeRight.mjs';
 export { clone } from '../object/clone.mjs';
 export { isPrimitive } from '../predicate/isPrimitive.mjs';
 export { flattenObject } from '../object/flattenObject.mjs';
@@ -146,6 +144,8 @@ export { max } from './math/max.mjs';
 export { min } from './math/min.mjs';
 export { parseInt } from './math/parseInt.mjs';
 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 { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';

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

@@ -0,0 +1,47 @@
+/**
+ * Returns an array of numbers from `0` (inclusive) to `end` (exclusive), incrementing by `1`.
+ *
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [0, 1, 2, 3]
+ * range(4);
+ */
+declare function range(end: number): number[];
+/**
+ * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `1`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * range(1, 4);
+ */
+declare function range(start: number, end: number): number[];
+/**
+ * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @param {number} step - The step value for the range.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ *
+ * @example
+ * // Returns [0, 5, 10, 15]
+ * range(0, 20, 5);
+ */
+declare function range(start: number, end: number, step: number): number[];
+/**
+ * Enables use as an iteratee for methods like `_.map`.
+ *
+ * @param {number} end - The current iteratee value.
+ * @param {PropertyKey} index - The iteration index.
+ * @param {object} guard - The iteratee object.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ */
+declare function range(end: number, index: PropertyKey, guard: object): number[];
+
+export { range };

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

@@ -0,0 +1,47 @@
+/**
+ * Returns an array of numbers from `0` (inclusive) to `end` (exclusive), incrementing by `1`.
+ *
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `0` (inclusive) to `end` (exclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [0, 1, 2, 3]
+ * range(4);
+ */
+declare function range(end: number): number[];
+/**
+ * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `1`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [1, 2, 3]
+ * range(1, 4);
+ */
+declare function range(start: number, end: number): number[];
+/**
+ * Returns an array of numbers from `start` (inclusive) to `end` (exclusive), incrementing by `step`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @param {number} step - The step value for the range.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ *
+ * @example
+ * // Returns [0, 5, 10, 15]
+ * range(0, 20, 5);
+ */
+declare function range(start: number, end: number, step: number): number[];
+/**
+ * Enables use as an iteratee for methods like `_.map`.
+ *
+ * @param {number} end - The current iteratee value.
+ * @param {PropertyKey} index - The iteration index.
+ * @param {object} guard - The iteratee object.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ */
+declare function range(end: number, index: PropertyKey, guard: object): number[];
+
+export { range };

package/dist/compat/math/range.mjs

@@ -0,0 +1,26 @@
+import { isIterateeCall } from '../_internal/isIterateeCall.mjs';
+import { toFinite } from '../util/toFinite.mjs';
+
+function range(start, end, step) {
+    if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
+        end = step = undefined;
+    }
+    start = toFinite(start);
+    if (end === undefined) {
+        end = start;
+        start = 0;
+    }
+    else {
+        end = toFinite(end);
+    }
+    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
+    const result = new Array(length);
+    for (let index = 0; index < length; index++) {
+        result[index] = start;
+        start += step;
+    }
+    return result;
+}
+
+export { range };

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

@@ -0,0 +1,47 @@
+/**
+ * Returns an array of numbers from `end` (exclusive) to `0` (inclusive), decrementing by `1`.
+ *
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [3, 2, 1, 0]
+ * rangeRight(4);
+ */
+declare function rangeRight(end: number): number[];
+/**
+ * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `1`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [3, 2, 1]
+ * rangeRight(1, 4);
+ */
+declare function rangeRight(start: number, end: number): number[];
+/**
+ * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @param {number} step - The step value for the range.
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+ *
+ * @example
+ * // Returns [15, 10, 5, 0]
+ * rangeRight(0, 20, 5);
+ */
+declare function rangeRight(start: number, end: number, step: number): number[];
+/**
+ * Enables use as an iteratee for methods like `_.map`.
+ *
+ * @param {number} end - The current iteratee value.
+ * @param {PropertyKey} index - The iteration index.
+ * @param {object} guard - The iteratee object.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ */
+declare function rangeRight(end: number, index: PropertyKey, guard: object): number[];
+
+export { rangeRight };

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

@@ -0,0 +1,47 @@
+/**
+ * Returns an array of numbers from `end` (exclusive) to `0` (inclusive), decrementing by `1`.
+ *
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `0` (inclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [3, 2, 1, 0]
+ * rangeRight(4);
+ */
+declare function rangeRight(end: number): number[];
+/**
+ * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `1`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with a step of `1`.
+ *
+ * @example
+ * // Returns [3, 2, 1]
+ * rangeRight(1, 4);
+ */
+declare function rangeRight(start: number, end: number): number[];
+/**
+ * Returns an array of numbers from `end` (exclusive) to `start` (inclusive), decrementing by `step`.
+ *
+ * @param {number} start - The starting number of the range (inclusive).
+ * @param {number} end - The end number of the range (exclusive).
+ * @param {number} step - The step value for the range.
+ * @returns {number[]} An array of numbers from `end` (exclusive) to `start` (inclusive) with the specified `step`.
+ *
+ * @example
+ * // Returns [15, 10, 5, 0]
+ * rangeRight(0, 20, 5);
+ */
+declare function rangeRight(start: number, end: number, step: number): number[];
+/**
+ * Enables use as an iteratee for methods like `_.map`.
+ *
+ * @param {number} end - The current iteratee value.
+ * @param {PropertyKey} index - The iteration index.
+ * @param {object} guard - The iteratee object.
+ * @returns {number[]} An array of numbers from `start` (inclusive) to `end` (exclusive) with the specified `step`.
+ */
+declare function rangeRight(end: number, index: PropertyKey, guard: object): number[];
+
+export { rangeRight };

package/dist/compat/math/rangeRight.mjs

@@ -0,0 +1,26 @@
+import { isIterateeCall } from '../_internal/isIterateeCall.mjs';
+import { toFinite } from '../util/toFinite.mjs';
+
+function rangeRight(start, end, step) {
+    if (step && typeof step !== 'number' && isIterateeCall(start, end, step)) {
+        end = step = undefined;
+    }
+    start = toFinite(start);
+    if (end === undefined) {
+        end = start;
+        start = 0;
+    }
+    else {
+        end = toFinite(end);
+    }
+    step = step === undefined ? (start < end ? 1 : -1) : toFinite(step);
+    const length = Math.max(Math.ceil((end - start) / (step || 1)), 0);
+    const result = new Array(length);
+    for (let index = length - 1; index >= 0; index--) {
+        result[index] = start;
+        start += step;
+    }
+    return result;
+}
+
+export { rangeRight };

package/dist/index.js

@@ -8,7 +8,7 @@ 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');
@@ -104,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/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-dev.952+8757a87f",
+  "version": "1.29.0-dev.954+99f7611e",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {