feat: adds callfnwith

src/__tests__/applicative.test.ts

@@ -1,4 +1,6 @@
-import { check, bind, fallback, panic, pass } from "../applicative";
+import { array, num } from '..';
+import { check, bind, fallback, panic, pass, callfnwith } from "../applicative";
+import { pipe } from '../pipe';
 
 describe("applicative", () => {
   it("bind", () => {
@@ -9,6 +11,16 @@ describe("applicative", () => {
     expect(fn(teststring)).toEqual(boundfn());
   });
 
+  it("callfnwith", () => {
+    const piped = pipe(
+       num.umultiply(2),
+       num.uadd,
+    );
+
+    expect(callfnwith(10)(piped)(2)).toBe(22);
+    expect(callfnwith(4)(piped)(2)).toBe(10);
+  });
+
   it("check", () => {
     expect(() => check(true, "will not throw")(123)).not.toThrow();
     expect(() => check(false, "will not throw")(123)).toThrow();

src/applicative.ts

@@ -67,6 +67,31 @@ export const bind = <Fn extends FnBase>(
   ...args: ArgsOf<Fn>
 ): (() => ReturnType<Fn>) => () => fn(...args) as ReturnType<Fn>;
 
+/**
+ * Given some arguments, returns a function which accepts another function.
+ * This function will be called with the given arguments.
+ * @since 2.13.0
+ * @example
+ * 
+ * ```ts
+ * import { callfnwith, num, pipe } from 'tiinvo';
+ * 
+ * const piped = pipe(
+ *     num.umultiply(2),
+ *     num.uadd,
+ * );
+ * 
+ * callfnwith(10)(piped)(2) // 22
+ * callfnwith(4)(piped)(2)  // 10
+ * 
+ * ```
+ * 
+ * 
+ * @param args 
+ * @returns 
+ */
+export const callfnwith = <Args extends any[]>(... args: Args) => <Fn extends (... args: Args) => any>(fn: Fn): ReturnType<Fn> => fn.apply(null, args);
+
 /**
  * Checks if a given condition is true, otherwise throws an error with the given error message
  *