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

package/dist/compat/function/before.d.mts

@@ -0,0 +1,27 @@
+/**
+ * Creates a function that invokes `func`, with the `this` binding and arguments
+ * of the created function, while it's called less than `n` times. Subsequent
+ * calls to the created function return the result of the last `func` invocation.
+ *
+ * @template F - The type of the function to be invoked.
+ * @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+ * - 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 {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+ * - Tracks the number of calls.
+ * - Invokes `func` until the `n-1`-th call.
+ * - Returns last result of `func`, if `n` is reached.
+ * @throws {TypeError} - If `func` is not a function.
+ * @example
+ * let count = 0;
+ * const before3 = before(3, () => ++count);
+ *
+ * before3(); // => 1
+ * before3(); // => 2
+ * before3(); // => 3
+ * before3(); // => 3
+ */
+declare function before<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F>;
+
+export { before };

package/dist/compat/function/before.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Creates a function that invokes `func`, with the `this` binding and arguments
+ * of the created function, while it's called less than `n` times. Subsequent
+ * calls to the created function return the result of the last `func` invocation.
+ *
+ * @template F - The type of the function to be invoked.
+ * @param {number} n - The number of times the returned function is allowed to call `func` before stopping.
+ * - 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 {(...args: Parameters<F>) => ReturnType<F> } - A new function that:
+ * - Tracks the number of calls.
+ * - Invokes `func` until the `n-1`-th call.
+ * - Returns last result of `func`, if `n` is reached.
+ * @throws {TypeError} - If `func` is not a function.
+ * @example
+ * let count = 0;
+ * const before3 = before(3, () => ++count);
+ *
+ * before3(); // => 1
+ * before3(); // => 2
+ * before3(); // => 3
+ * before3(); // => 3
+ */
+declare function before<F extends (...args: any[]) => any>(n: number, func: F): (...args: Parameters<F>) => ReturnType<F>;
+
+export { before };

package/dist/compat/function/before.mjs

@@ -0,0 +1,20 @@
+import { toInteger } from '../util/toInteger.mjs';
+
+function before(n, func) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    let result;
+    n = toInteger(n);
+    return function (...args) {
+        if (--n > 0) {
+            result = func.apply(this, args);
+        }
+        if (n <= 1 && func) {
+            func = undefined;
+        }
+        return result;
+    };
+}
+
+export { before };

package/dist/compat/index.d.mts

@@ -46,7 +46,6 @@ 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 { before } from '../function/before.mjs';
 export { after } from '../function/after.mjs';
 export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
@@ -117,6 +116,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { filter } from './array/filter.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
+export { before } from './function/before.mjs';
 export { bindKey } from './function/bindKey.mjs';
 export { defer } from './function/defer.mjs';
 export { rest } from './function/rest.mjs';

package/dist/compat/index.d.ts

@@ -46,7 +46,6 @@ export { zipObject } from '../array/zipObject.js';
 export { zipWith } from '../array/zipWith.js';
 export { AbortError } from '../error/AbortError.js';
 export { TimeoutError } from '../error/TimeoutError.js';
-export { before } from '../function/before.js';
 export { after } from '../function/after.js';
 export { noop } from '../function/noop.js';
 export { once } from '../function/once.js';
@@ -117,6 +116,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.js';
 export { filter } from './array/filter.js';
 export { ary } from './function/ary.js';
 export { bind } from './function/bind.js';
+export { before } from './function/before.js';
 export { bindKey } from './function/bindKey.js';
 export { defer } from './function/defer.js';
 export { rest } from './function/rest.js';

package/dist/compat/index.js

@@ -4,7 +4,7 @@ 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-Dv8J0U.js');
+const flowRight$1 = require('../_chunk/flowRight-CVcg72.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 const range = require('../_chunk/range-BXlMmn.js');
 const randomInt = require('../_chunk/randomInt-CF7bZK.js');
@@ -939,6 +939,23 @@ function bind(func, thisObj, ...partialArgs) {
 const bindPlaceholder = Symbol('bind.placeholder');
 bind.placeholder = bindPlaceholder;
 
+function before(n, func) {
+    if (typeof func !== 'function') {
+        throw new TypeError('Expected a function');
+    }
+    let result;
+    n = toInteger(n);
+    return function (...args) {
+        if (--n > 0) {
+            result = func.apply(this, args);
+        }
+        if (n <= 1 && func) {
+            func = undefined;
+        }
+        return result;
+    };
+}
+
 function bindKey(object, key, ...partialArgs) {
     const bound = function (...providedArgs) {
         const args = [];
@@ -1946,7 +1963,6 @@ exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = flowRight$1.after;
-exports.before = flowRight$1.before;
 exports.curryRight = flowRight$1.curryRight;
 exports.memoize = flowRight$1.memoize;
 exports.negate = flowRight$1.negate;
@@ -1990,6 +2006,7 @@ exports.unescape = pad$1.unescape;
 exports.upperFirst = pad$1.upperFirst;
 exports.ary = ary;
 exports.attempt = attempt;
+exports.before = before;
 exports.bind = bind;
 exports.bindKey = bindKey;
 exports.camelCase = camelCase;

package/dist/compat/index.mjs

@@ -46,7 +46,6 @@ 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 { before } from '../function/before.mjs';
 export { after } from '../function/after.mjs';
 export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
@@ -118,6 +117,7 @@ export { zipObjectDeep } from './array/zipObjectDeep.mjs';
 export { filter } from './array/filter.mjs';
 export { ary } from './function/ary.mjs';
 export { bind } from './function/bind.mjs';
+export { before } from './function/before.mjs';
 export { bindKey } from './function/bindKey.mjs';
 export { defer } from './function/defer.mjs';
 export { rest } from './function/rest.mjs';

package/dist/function/index.js

@@ -2,9 +2,22 @@
 
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 
-const flowRight = require('../_chunk/flowRight-Dv8J0U.js');
+const flowRight = require('../_chunk/flowRight-CVcg72.js');
 const noop = require('../_chunk/noop-2IwLUk.js');
 
+function before(n, func) {
+    if (!Number.isInteger(n) || n < 0) {
+        throw new Error('n must be a non-negative integer.');
+    }
+    let counter = 0;
+    return ((...args) => {
+        if (++counter < n) {
+            return func(...args);
+        }
+        return undefined;
+    });
+}
+
 function throttle(func, throttleMs, { signal, edges = ['leading', 'trailing'] } = {}) {
     let pendingAt = null;
     const debounced = flowRight.debounce(func, throttleMs, { signal, edges });
@@ -54,7 +67,6 @@ function spread(func) {
 
 exports.after = flowRight.after;
 exports.ary = flowRight.ary;
-exports.before = flowRight.before;
 exports.curryRight = flowRight.curryRight;
 exports.debounce = flowRight.debounce;
 exports.flow = flowRight.flow;
@@ -67,6 +79,7 @@ exports.partialRight = flowRight.partialRight;
 exports.rest = flowRight.rest;
 exports.unary = flowRight.unary;
 exports.noop = noop.noop;
+exports.before = before;
 exports.curry = curry;
 exports.spread = spread;
 exports.throttle = throttle;

package/dist/index.js

@@ -5,9 +5,9 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 const zipWith = require('./_chunk/zipWith-EOU_KZ.js');
 const array_index = require('./array/index.js');
 const promise_index = require('./_chunk/index-BGZDR9.js');
-const flowRight = require('./_chunk/flowRight-Dv8J0U.js');
-const noop = require('./_chunk/noop-2IwLUk.js');
 const function_index = require('./function/index.js');
+const flowRight = require('./_chunk/flowRight-CVcg72.js');
+const noop = require('./_chunk/noop-2IwLUk.js');
 const range = require('./_chunk/range-BXlMmn.js');
 const randomInt = require('./_chunk/randomInt-CF7bZK.js');
 const math_index = require('./math/index.js');
@@ -82,9 +82,12 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.timeout = promise_index.timeout;
 exports.withTimeout = promise_index.withTimeout;
+exports.before = function_index.before;
+exports.curry = function_index.curry;
+exports.spread = function_index.spread;
+exports.throttle = function_index.throttle;
 exports.after = flowRight.after;
 exports.ary = flowRight.ary;
-exports.before = flowRight.before;
 exports.curryRight = flowRight.curryRight;
 exports.debounce = flowRight.debounce;
 exports.flow = flowRight.flow;
@@ -97,9 +100,6 @@ exports.partialRight = flowRight.partialRight;
 exports.rest = flowRight.rest;
 exports.unary = flowRight.unary;
 exports.noop = noop.noop;
-exports.curry = function_index.curry;
-exports.spread = function_index.spread;
-exports.throttle = function_index.throttle;
 exports.clamp = range.clamp;
 exports.inRange = range.inRange;
 exports.mean = range.mean;

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