es-toolkit 1.21.0-dev.679 → 1.21.0-dev.681

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

@@ -0,0 +1,20 @@
+/**
+ * Reverses the order of arguments for a given function.
+ *
+ * @template F - The type of the function being flipped.
+ * @param {F} func - The function whose arguments will be reversed.
+ * @returns {(...args: Reversed<Parameters<F>>) => ReturnType<F>} A new function that takes the
+ * reversed arguments and returns the result of calling `func`.
+ *
+ * @example
+ * function fn(a: string, b: string, c: string, d: string) {
+ *   return [a, b, c, d];
+ * }
+ *
+ * const flipped = flip(fn);
+ * flipped('a', 'b', 'c', 'd'); // => ['d', 'c', 'b', 'a']
+ */
+declare function flip<F extends (...args: any[]) => any>(func: F): (...args: Reversed<Parameters<F>>) => ReturnType<F>;
+type Reversed<T extends any[]> = T extends [infer First, ...infer Rest] ? [...Reversed<Rest>, First] : [];
+
+export { flip };

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

@@ -0,0 +1,20 @@
+/**
+ * Reverses the order of arguments for a given function.
+ *
+ * @template F - The type of the function being flipped.
+ * @param {F} func - The function whose arguments will be reversed.
+ * @returns {(...args: Reversed<Parameters<F>>) => ReturnType<F>} A new function that takes the
+ * reversed arguments and returns the result of calling `func`.
+ *
+ * @example
+ * function fn(a: string, b: string, c: string, d: string) {
+ *   return [a, b, c, d];
+ * }
+ *
+ * const flipped = flip(fn);
+ * flipped('a', 'b', 'c', 'd'); // => ['d', 'c', 'b', 'a']
+ */
+declare function flip<F extends (...args: any[]) => any>(func: F): (...args: Reversed<Parameters<F>>) => ReturnType<F>;
+type Reversed<T extends any[]> = T extends [infer First, ...infer Rest] ? [...Reversed<Rest>, First] : [];
+
+export { flip };

package/dist/compat/function/flip.mjs

@@ -0,0 +1,7 @@
+function flip(func) {
+    return function (...args) {
+        return func.apply(this, args.reverse());
+    };
+}
+
+export { flip };

package/dist/compat/index.d.mts

@@ -123,6 +123,7 @@ export { rearg } from './function/rearg.mjs';
 export { curry } from './function/curry.mjs';
 export { debounce } from './function/debounce.mjs';
 export { throttle } from './function/throttle.mjs';
+export { flip } from './function/flip.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { pick } from './object/pick.mjs';

package/dist/compat/index.d.ts

@@ -123,6 +123,7 @@ export { rearg } from './function/rearg.js';
 export { curry } from './function/curry.js';
 export { debounce } from './function/debounce.js';
 export { throttle } from './function/throttle.js';
+export { flip } from './function/flip.js';
 export { get } from './object/get.js';
 export { set } from './object/set.js';
 export { pick } from './object/pick.js';

package/dist/compat/index.js

@@ -1008,6 +1008,12 @@ function throttle(func, throttleMs = 0, options = {}) {
     return debounce(func, throttleMs, { leading, trailing, signal, maxWait: throttleMs });
 }
 
+function flip(func) {
+    return function (...args) {
+        return func.apply(this, args.reverse());
+    };
+}
+
 function isNil(x) {
     return x == null;
 }
@@ -1835,6 +1841,7 @@ exports.findLastIndex = findLastIndex;
 exports.flatten = flatten;
 exports.flattenDeep = flattenDeep;
 exports.flattenDepth = flattenDepth;
+exports.flip = flip;
 exports.floor = floor;
 exports.fromPairs = fromPairs;
 exports.get = get;

package/dist/compat/index.mjs

@@ -124,6 +124,7 @@ export { rearg } from './function/rearg.mjs';
 export { curry } from './function/curry.mjs';
 export { debounce } from './function/debounce.mjs';
 export { throttle } from './function/throttle.mjs';
+export { flip } from './function/flip.mjs';
 export { get } from './object/get.mjs';
 export { set } from './object/set.mjs';
 export { pick } from './object/pick.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.21.0-dev.679+efe79322",
+  "version": "1.21.0-dev.681+7eed956e",
   "homepage": "https://es-toolkit.slash.page",
   "bugs": "https://github.com/toss/es-toolkit/issues",
   "repository": {