es-toolkit 1.23.0-dev.732 → 1.23.0-dev.734

package/dist/compat/index.d.mts

@@ -61,6 +61,7 @@ export { randomInt } from '../math/randomInt.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
 export { range } from '../math/range.mjs';
+export { rangeRight } from '../math/rangeRight.mjs';
 export { omitBy } from '../object/omitBy.mjs';
 export { pickBy } from '../object/pickBy.mjs';
 export { invert } from '../object/invert.mjs';

package/dist/compat/index.d.ts

@@ -61,6 +61,7 @@ export { randomInt } from '../math/randomInt.js';
 export { sum } from '../math/sum.js';
 export { sumBy } from '../math/sumBy.js';
 export { range } from '../math/range.js';
+export { rangeRight } from '../math/rangeRight.js';
 export { omitBy } from '../object/omitBy.js';
 export { pickBy } from '../object/pickBy.js';
 export { invert } from '../object/invert.js';

package/dist/compat/index.js

@@ -4,9 +4,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
 const zipWith = require('../_chunk/zipWith-EOU_KZ.js');
 const promise_index = require('../_chunk/index-BGZDR9.js');
-const flowRight$1 = require('../_chunk/flowRight-CVcg72.js');
+const flowRight$1 = require('../_chunk/flowRight-B6_Omw.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
-const range = require('../_chunk/range-BXlMmn.js');
+const rangeRight = require('../_chunk/rangeRight-CtcxMd.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 const isObjectLike = require('../_chunk/isObjectLike-aywuSF.js');
 const isPlainObject$1 = require('../_chunk/isPlainObject-DgrsU7.js');
@@ -1754,7 +1754,7 @@ function clamp(value, bound1, bound2) {
     if (Number.isNaN(bound2)) {
         bound2 = 0;
     }
-    return range.clamp(value, bound1, bound2);
+    return rangeRight.clamp(value, bound1, bound2);
 }
 
 function max(items = []) {
@@ -1842,7 +1842,7 @@ function inRange(value, minimum, maximum) {
     if (minimum === maximum) {
         return false;
     }
-    return range.inRange(value, minimum, maximum);
+    return rangeRight.inRange(value, minimum, maximum);
 }
 
 function random(...args) {
@@ -1971,11 +1971,12 @@ exports.partial = flowRight$1.partial;
 exports.partialRight = flowRight$1.partialRight;
 exports.unary = flowRight$1.unary;
 exports.noop = noop.noop;
-exports.mean = range.mean;
-exports.meanBy = range.meanBy;
-exports.range = range.range;
-exports.sum = range.sum;
-exports.sumBy = range.sumBy;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
+exports.sumBy = rangeRight.sumBy;
 exports.randomInt = randomInt.randomInt;
 exports.clone = isObjectLike.clone;
 exports.flattenObject = isObjectLike.flattenObject;

package/dist/compat/index.mjs

@@ -61,6 +61,7 @@ export { randomInt } from '../math/randomInt.mjs';
 export { sum } from '../math/sum.mjs';
 export { sumBy } from '../math/sumBy.mjs';
 export { range } from '../math/range.mjs';
+export { rangeRight } from '../math/rangeRight.mjs';
 export { omitBy } from '../object/omitBy.mjs';
 export { pickBy } from '../object/pickBy.mjs';
 export { invert } from '../object/invert.mjs';

package/dist/function/before.d.mts

@@ -6,7 +6,7 @@
  * - If `n` is 0, `func` will never be called.
  * - If `n` is a positive integer, `func` will be called up to `n-1` times.
  * @param {F} func - The function to be called with the limit applied.
- * @returns {F} - A new function that:
+ * @returns {(...args: Parameters<F>) => ReturnType<F> | undefined} - A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` until the `n-1`-th call.
  * - Returns `undefined` if the number of calls reaches or exceeds `n`, stopping further calls.
@@ -26,6 +26,6 @@
  * // Will not log anything.
  * beforeFn();
  */
-declare function before<F extends (...args: any[]) => any>(n: number, func: F): F;
+declare function before<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
 
 export { before };

package/dist/function/before.d.ts

@@ -6,7 +6,7 @@
  * - If `n` is 0, `func` will never be called.
  * - If `n` is a positive integer, `func` will be called up to `n-1` times.
  * @param {F} func - The function to be called with the limit applied.
- * @returns {F} - A new function that:
+ * @returns {(...args: Parameters<F>) => ReturnType<F> | undefined} - A new function that:
  * - Tracks the number of calls.
  * - Invokes `func` until the `n-1`-th call.
  * - Returns `undefined` if the number of calls reaches or exceeds `n`, stopping further calls.
@@ -26,6 +26,6 @@
  * // Will not log anything.
  * beforeFn();
  */
-declare function before<F extends (...args: any[]) => any>(n: number, func: F): F;
+declare function before<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F> | undefined;
 
 export { before };

package/dist/function/before.mjs

@@ -3,12 +3,12 @@ function before(n, func) {
         throw new Error('n must be a non-negative integer.');
     }
     let counter = 0;
-    return ((...args) => {
+    return (...args) => {
         if (++counter < n) {
             return func(...args);
         }
         return undefined;
-    });
+    };
 }
 
 export { before };

package/dist/function/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const flowRight = require('../_chunk/flowRight-CVcg72.js');
+const flowRight = require('../_chunk/flowRight-B6_Omw.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 
 function before(n, func) {
@@ -10,12 +10,12 @@ function before(n, func) {
         throw new Error('n must be a non-negative integer.');
     }
     let counter = 0;
-    return ((...args) => {
+    return (...args) => {
         if (++counter < n) {
             return func(...args);
         }
         return undefined;
-    });
+    };
 }
 
 function throttle(func, throttleMs, { signal, edges = ['leading', 'trailing'] } = {}) {

package/dist/function/once.d.mts

@@ -3,7 +3,7 @@
  * Repeated calls to the function will return the value from the first invocation.
  *
  * @template F - The type of function.
- * @param {F} func - The function to restrict.
+ * @param {F extends () => any} func - The function to restrict.
  * @returns {F} A new function that invokes `func` once and caches the result.
  *
  * @example
@@ -16,5 +16,20 @@
  * initialize(); // Returns true without logging
  */
 declare function once<F extends () => any>(func: F): F;
+/**
+ * Creates a function that is restricted to invoking the provided function `func` once.
+ * Repeated calls to the function will return the value from the first invocation.
+ *
+ * @template F - The type of function.
+ * @param {F extends (...args: any[]) => void} func - The function to restrict with arguments.
+ * @returns {F} A new function that invokes `func` once.
+ *
+ * @example
+ * const log = once(console.log);
+ *
+ * log('Hello, world!'); // prints 'Hello, world!' and doesn't return anything
+ * log('Hello, world!'); // doesn't print anything and doesn't return anything
+ */
+declare function once<F extends (...args: any[]) => void>(func: F): F;
 
 export { once };

package/dist/function/once.d.ts

@@ -3,7 +3,7 @@
  * Repeated calls to the function will return the value from the first invocation.
  *
  * @template F - The type of function.
- * @param {F} func - The function to restrict.
+ * @param {F extends () => any} func - The function to restrict.
  * @returns {F} A new function that invokes `func` once and caches the result.
  *
  * @example
@@ -16,5 +16,20 @@
  * initialize(); // Returns true without logging
  */
 declare function once<F extends () => any>(func: F): F;
+/**
+ * Creates a function that is restricted to invoking the provided function `func` once.
+ * Repeated calls to the function will return the value from the first invocation.
+ *
+ * @template F - The type of function.
+ * @param {F extends (...args: any[]) => void} func - The function to restrict with arguments.
+ * @returns {F} A new function that invokes `func` once.
+ *
+ * @example
+ * const log = once(console.log);
+ *
+ * log('Hello, world!'); // prints 'Hello, world!' and doesn't return anything
+ * log('Hello, world!'); // doesn't print anything and doesn't return anything
+ */
+declare function once<F extends (...args: any[]) => void>(func: F): F;
 
 export { once };

package/dist/function/once.mjs

@@ -1,14 +1,12 @@
 function once(func) {
     let called = false;
     let cache;
-    return function () {
-        if (called) {
-            return cache;
+    return function (...args) {
+        if (!called) {
+            called = true;
+            cache = func(...args);
         }
-        const result = func();
-        called = true;
-        cache = result;
-        return result;
+        return cache;
     };
 }
 

package/dist/index.d.mts

@@ -84,6 +84,7 @@ export { round } from './math/round.mjs';
 export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { range } from './math/range.mjs';
+export { rangeRight } from './math/rangeRight.mjs';
 export { omit } from './object/omit.mjs';
 export { omitBy } from './object/omitBy.mjs';
 export { pick } from './object/pick.mjs';

package/dist/index.d.ts

@@ -84,6 +84,7 @@ export { round } from './math/round.js';
 export { sum } from './math/sum.js';
 export { sumBy } from './math/sumBy.js';
 export { range } from './math/range.js';
+export { rangeRight } from './math/rangeRight.js';
 export { omit } from './object/omit.js';
 export { omitBy } from './object/omitBy.js';
 export { pick } from './object/pick.js';

package/dist/index.js

@@ -6,9 +6,9 @@ const zipWith = require('./_chunk/zipWith-EOU_KZ.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
 const function_index = require('./function/index.js');
-const flowRight = require('./_chunk/flowRight-CVcg72.js');
+const flowRight = require('./_chunk/flowRight-B6_Omw.js');
 const noop = require('./_chunk/noop-2IwLUk.js');
-const range = require('./_chunk/range-BXlMmn.js');
+const rangeRight = require('./_chunk/rangeRight-CtcxMd.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
 const object_index = require('./object/index.js');
@@ -100,13 +100,14 @@ exports.partialRight = flowRight.partialRight;
 exports.rest = flowRight.rest;
 exports.unary = flowRight.unary;
 exports.noop = noop.noop;
-exports.clamp = range.clamp;
-exports.inRange = range.inRange;
-exports.mean = range.mean;
-exports.meanBy = range.meanBy;
-exports.range = range.range;
-exports.sum = range.sum;
-exports.sumBy = range.sumBy;
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
+exports.sumBy = rangeRight.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = math_index.round;

package/dist/index.mjs

@@ -84,6 +84,7 @@ export { round } from './math/round.mjs';
 export { sum } from './math/sum.mjs';
 export { sumBy } from './math/sumBy.mjs';
 export { range } from './math/range.mjs';
+export { rangeRight } from './math/rangeRight.mjs';
 export { omit } from './object/omit.mjs';
 export { omitBy } from './object/omitBy.mjs';
 export { pick } from './object/pick.mjs';

package/dist/math/index.d.mts

@@ -8,3 +8,4 @@ export { round } from './round.mjs';
 export { sum } from './sum.mjs';
 export { sumBy } from './sumBy.mjs';
 export { range } from './range.mjs';
+export { rangeRight } from './rangeRight.mjs';

package/dist/math/index.d.ts

@@ -8,3 +8,4 @@ export { round } from './round.js';
 export { sum } from './sum.js';
 export { sumBy } from './sumBy.js';
 export { range } from './range.js';
+export { rangeRight } from './rangeRight.js';

package/dist/math/index.js

@@ -2,7 +2,7 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const range = require('../_chunk/range-BXlMmn.js');
+const rangeRight = require('../_chunk/rangeRight-CtcxMd.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
 
 function round(value, precision = 0) {
@@ -13,13 +13,14 @@ function round(value, precision = 0) {
     return Math.round(value * multiplier) / multiplier;
 }
 
-exports.clamp = range.clamp;
-exports.inRange = range.inRange;
-exports.mean = range.mean;
-exports.meanBy = range.meanBy;
-exports.range = range.range;
-exports.sum = range.sum;
-exports.sumBy = range.sumBy;
+exports.clamp = rangeRight.clamp;
+exports.inRange = rangeRight.inRange;
+exports.mean = rangeRight.mean;
+exports.meanBy = rangeRight.meanBy;
+exports.range = rangeRight.range;
+exports.rangeRight = rangeRight.rangeRight;
+exports.sum = rangeRight.sum;
+exports.sumBy = rangeRight.sumBy;
 exports.random = randomInt.random;
 exports.randomInt = randomInt.randomInt;
 exports.round = round;

package/dist/math/index.mjs

@@ -8,3 +8,4 @@ export { round } from './round.mjs';
 export { sum } from './sum.mjs';
 export { sumBy } from './sumBy.mjs';
 export { range } from './range.mjs';
+export { rangeRight } from './rangeRight.mjs';

package/dist/math/rangeRight.d.mts

@@ -0,0 +1,38 @@
+/**
+ * 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[];
+
+export { rangeRight };

package/dist/math/rangeRight.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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[];
+
+export { rangeRight };

package/dist/math/rangeRight.mjs

@@ -0,0 +1,20 @@
+function rangeRight(start, end, step) {
+    if (end == null) {
+        end = start;
+        start = 0;
+    }
+    if (step == null) {
+        step = 1;
+    }
+    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;
+}
+
+export { rangeRight };

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.23.0-dev.732+65d65b57",
+  "version": "1.23.0-dev.734+21bd4826",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {