es-toolkit 1.13.1-dev.371 → 1.13.1-dev.373

package/dist/compat/index.d.mts

@@ -55,6 +55,8 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { throttle } from '../function/throttle.mjs';
 export { negate } from '../function/negate.mjs';
+export { ary } from '../function/ary.mjs';
+export { unary } from '../function/unary.mjs';
 export { bind } from '../function/bind.mjs';
 export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';

package/dist/compat/index.d.ts

@@ -55,6 +55,8 @@ export { noop } from '../function/noop.js';
 export { once } from '../function/once.js';
 export { throttle } from '../function/throttle.js';
 export { negate } from '../function/negate.js';
+export { ary } from '../function/ary.js';
+export { unary } from '../function/unary.js';
 export { bind } from '../function/bind.js';
 export { clamp } from '../math/clamp.js';
 export { inRange } from '../math/inRange.js';

package/dist/compat/index.js

@@ -461,6 +461,7 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = function_index.after;
+exports.ary = function_index.ary;
 exports.before = function_index.before;
 exports.bind = function_index.bind;
 exports.debounce = function_index.debounce;
@@ -468,6 +469,7 @@ exports.negate = function_index.negate;
 exports.noop = function_index.noop;
 exports.once = function_index.once;
 exports.throttle = function_index.throttle;
+exports.unary = function_index.unary;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;
 exports.mean = math_index.mean;

package/dist/compat/index.mjs

@@ -55,6 +55,8 @@ export { noop } from '../function/noop.mjs';
 export { once } from '../function/once.mjs';
 export { throttle } from '../function/throttle.mjs';
 export { negate } from '../function/negate.mjs';
+export { ary } from '../function/ary.mjs';
+export { unary } from '../function/unary.mjs';
 export { bind } from '../function/bind.mjs';
 export { clamp } from '../math/clamp.mjs';
 export { inRange } from '../math/inRange.mjs';

package/dist/function/ary.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Creates a function that invokes func, with up to n arguments, ignoring any additional arguments.
+ *
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @param {number} n - The arity cap.
+ * @param {any} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare const ary: <F extends (...args: any[]) => any>(func: F, n?: number, guard?: any) => ((...args: any[]) => ReturnType<F>);
+
+export { ary };

package/dist/function/ary.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates a function that invokes func, with up to n arguments, ignoring any additional arguments.
+ *
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @param {number} n - The arity cap.
+ * @param {any} guard - Enables use as an iteratee for methods like `map`.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare const ary: <F extends (...args: any[]) => any>(func: F, n?: number, guard?: any) => ((...args: any[]) => ReturnType<F>);
+
+export { ary };

package/dist/function/ary.mjs

@@ -0,0 +1,11 @@
+const ary = (func, n = func.length, guard) => {
+    n = guard ? func.length : Number.parseInt(n.toString());
+    if (Number.isNaN(n) || n < 0) {
+        n = 0;
+    }
+    return function (...args) {
+        return func.apply(this, args.slice(0, n));
+    };
+};
+
+export { ary };

package/dist/function/index.d.mts

@@ -5,4 +5,6 @@ export { noop } from './noop.mjs';
 export { once } from './once.mjs';
 export { throttle } from './throttle.mjs';
 export { negate } from './negate.mjs';
+export { ary } from './ary.mjs';
+export { unary } from './unary.mjs';
 export { bind } from './bind.mjs';

package/dist/function/index.d.ts

@@ -5,4 +5,6 @@ export { noop } from './noop.js';
 export { once } from './once.js';
 export { throttle } from './throttle.js';
 export { negate } from './negate.js';
+export { ary } from './ary.js';
+export { unary } from './unary.js';
 export { bind } from './bind.js';

package/dist/function/index.js

@@ -87,6 +87,20 @@ function negate(func) {
     return ((...args) => !func(...args));
 }
 
+const ary = (func, n = func.length, guard) => {
+    n = guard ? func.length : Number.parseInt(n.toString());
+    if (Number.isNaN(n) || n < 0) {
+        n = 0;
+    }
+    return function (...args) {
+        return func.apply(this, args.slice(0, n));
+    };
+};
+
+const unary = (func) => {
+    return ary(func, 1);
+};
+
 function bind(func, thisArg, ...partials) {
     const wrapper = function (...args) {
         let index = 0;
@@ -109,6 +123,7 @@ function bind(func, thisArg, ...partials) {
 bind.placeholder = Symbol('bind.placeholder');
 
 exports.after = after;
+exports.ary = ary;
 exports.before = before;
 exports.bind = bind;
 exports.debounce = debounce;
@@ -116,3 +131,4 @@ exports.negate = negate;
 exports.noop = noop;
 exports.once = once;
 exports.throttle = throttle;
+exports.unary = unary;

package/dist/function/index.mjs

@@ -5,4 +5,6 @@ export { noop } from './noop.mjs';
 export { once } from './once.mjs';
 export { throttle } from './throttle.mjs';
 export { negate } from './negate.mjs';
+export { ary } from './ary.mjs';
+export { unary } from './unary.mjs';
 export { bind } from './bind.mjs';

package/dist/function/unary.d.mts

@@ -0,0 +1,10 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare const unary: <F extends (...args: any[]) => any>(func: F) => ((...args: any[]) => ReturnType<F>);
+
+export { unary };

package/dist/function/unary.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Creates a function that accepts up to one argument, ignoring any additional arguments.
+ *
+ * @template F - The type of the function.
+ * @param {F} func - The function to cap arguments for.
+ * @returns {(...args: any[]) => ReturnType<F>} Returns the new capped function.
+ */
+declare const unary: <F extends (...args: any[]) => any>(func: F) => ((...args: any[]) => ReturnType<F>);
+
+export { unary };

package/dist/function/unary.mjs

@@ -0,0 +1,7 @@
+import { ary } from './ary.mjs';
+
+const unary = (func) => {
+    return ary(func, 1);
+};
+
+export { unary };

package/dist/index.d.mts

@@ -60,6 +60,8 @@ export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { ary } from './function/ary.mjs';
+export { unary } from './function/unary.mjs';
 export { bind } from './function/bind.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.mjs';

package/dist/index.d.ts

@@ -60,6 +60,8 @@ export { noop } from './function/noop.js';
 export { once } from './function/once.js';
 export { throttle } from './function/throttle.js';
 export { negate } from './function/negate.js';
+export { ary } from './function/ary.js';
+export { unary } from './function/unary.js';
 export { bind } from './function/bind.js';
 export { clamp } from './math/clamp.js';
 export { inRange } from './math/inRange.js';

package/dist/index.js

@@ -75,6 +75,7 @@ exports.TimeoutError = promise_index.TimeoutError;
 exports.delay = promise_index.delay;
 exports.withTimeout = promise_index.withTimeout;
 exports.after = function_index.after;
+exports.ary = function_index.ary;
 exports.before = function_index.before;
 exports.bind = function_index.bind;
 exports.debounce = function_index.debounce;
@@ -82,6 +83,7 @@ exports.negate = function_index.negate;
 exports.noop = function_index.noop;
 exports.once = function_index.once;
 exports.throttle = function_index.throttle;
+exports.unary = function_index.unary;
 exports.clamp = math_index.clamp;
 exports.inRange = math_index.inRange;
 exports.mean = math_index.mean;

package/dist/index.mjs

@@ -60,6 +60,8 @@ export { noop } from './function/noop.mjs';
 export { once } from './function/once.mjs';
 export { throttle } from './function/throttle.mjs';
 export { negate } from './function/negate.mjs';
+export { ary } from './function/ary.mjs';
+export { unary } from './function/unary.mjs';
 export { bind } from './function/bind.mjs';
 export { clamp } from './math/clamp.mjs';
 export { inRange } from './math/inRange.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.13.1-dev.371+86fe776f",
+  "version": "1.13.1-dev.373+db79ff33",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {