@nlozgachev/pipekit 0.5.2 → 0.5.3

package/esm/src/Composition/converge.js

@@ -0,0 +1,3 @@
+export function converge(f, transformers) {
+    return (a) => f(...transformers.map((t) => t(a)));
+}

package/esm/src/Composition/index.js

@@ -1,10 +1,13 @@
 export * from "./compose.js";
+export * from "./converge.js";
 export * from "./curry.js";
 export * from "./flip.js";
 export * from "./fn.js";
 export * from "./flow.js";
+export * from "./juxt.js";
 export * from "./memoize.js";
 export * from "./not.js";
+export * from "./on.js";
 export * from "./pipe.js";
 export * from "./tap.js";
 export * from "./uncurry.js";

package/esm/src/Composition/juxt.js

@@ -0,0 +1,3 @@
+export function juxt(fns) {
+    return (a) => fns.map((f) => f(a));
+}

package/esm/src/Composition/on.js

@@ -0,0 +1,12 @@
+/**
+ * Applies a projection to both arguments of a binary function before calling it.
+ * Most useful for building comparators and equality checks over projected values.
+ *
+ * @example
+ * ```ts
+ * const byLength = on((a: number, b: number) => a - b, (s: string) => s.length);
+ *
+ * ["banana", "fig", "apple"].sort(byLength); // ["fig", "apple", "banana"]
+ * ```
+ */
+export const on = (f, g) => (a, b) => f(g(a), g(b));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nlozgachev/pipekit",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "Simple functional programming toolkit for TypeScript",
   "keywords": [
     "functional",

package/script/src/Composition/converge.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.converge = converge;
+function converge(f, transformers) {
+    return (a) => f(...transformers.map((t) => t(a)));
+}

package/script/src/Composition/index.js

@@ -15,12 +15,15 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./compose.js"), exports);
+__exportStar(require("./converge.js"), exports);
 __exportStar(require("./curry.js"), exports);
 __exportStar(require("./flip.js"), exports);
 __exportStar(require("./fn.js"), exports);
 __exportStar(require("./flow.js"), exports);
+__exportStar(require("./juxt.js"), exports);
 __exportStar(require("./memoize.js"), exports);
 __exportStar(require("./not.js"), exports);
+__exportStar(require("./on.js"), exports);
 __exportStar(require("./pipe.js"), exports);
 __exportStar(require("./tap.js"), exports);
 __exportStar(require("./uncurry.js"), exports);

package/script/src/Composition/juxt.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.juxt = juxt;
+function juxt(fns) {
+    return (a) => fns.map((f) => f(a));
+}

package/script/src/Composition/on.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.on = void 0;
+/**
+ * Applies a projection to both arguments of a binary function before calling it.
+ * Most useful for building comparators and equality checks over projected values.
+ *
+ * @example
+ * ```ts
+ * const byLength = on((a: number, b: number) => a - b, (s: string) => s.length);
+ *
+ * ["banana", "fig", "apple"].sort(byLength); // ["fig", "apple", "banana"]
+ * ```
+ */
+const on = (f, g) => (a, b) => f(g(a), g(b));
+exports.on = on;

package/types/src/Composition/converge.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Applies an input to several transformer functions independently, then passes all results to a
+ * combining function.
+ *
+ * @example
+ * ```ts
+ * const toNameRecord = converge(
+ *   (trimmed: string, initials: string) => ({ trimmed, initials }),
+ *   [
+ *     (name: string) => name.trim(),
+ *     (name: string) => name.split(" ").map((w) => w[0]).join(""),
+ *   ],
+ * );
+ *
+ * toNameRecord("  Alice Bob  "); // { trimmed: "Alice Bob", initials: "AB" }
+ * ```
+ */
+export declare function converge<A, B, C, R>(f: (b: B, c: C) => R, transformers: [(a: A) => B, (a: A) => C]): (a: A) => R;
+export declare function converge<A, B, C, D, R>(f: (b: B, c: C, d: D) => R, transformers: [(a: A) => B, (a: A) => C, (a: A) => D]): (a: A) => R;
+export declare function converge<A, B, C, D, E, R>(f: (b: B, c: C, d: D, e: E) => R, transformers: [(a: A) => B, (a: A) => C, (a: A) => D, (a: A) => E]): (a: A) => R;
+//# sourceMappingURL=converge.d.ts.map

package/types/src/Composition/converge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"converge.d.ts","sourceRoot":"","sources":["../../../src/src/Composition/converge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACjC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EACpB,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GACvC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACpC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAC1B,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GACpD,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACf,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EACvC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,EAChC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GACjE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC"}

package/types/src/Composition/index.d.ts

@@ -1,10 +1,13 @@
 export * from "./compose.js";
+export * from "./converge.js";
 export * from "./curry.js";
 export * from "./flip.js";
 export * from "./fn.js";
 export * from "./flow.js";
+export * from "./juxt.js";
 export * from "./memoize.js";
 export * from "./not.js";
+export * from "./on.js";
 export * from "./pipe.js";
 export * from "./tap.js";
 export * from "./uncurry.js";

package/types/src/Composition/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/Composition/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/src/Composition/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/types/src/Composition/juxt.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Applies an input to an array of functions and collects the results into a tuple.
+ *
+ * @example
+ * ```ts
+ * const nameParts = juxt([
+ *   (name: string) => name.split(" ")[0],
+ *   (name: string) => name.split(" ").slice(1).join(" "),
+ * ]);
+ *
+ * nameParts("Alice Smith"); // ["Alice", "Smith"]
+ * ```
+ */
+export declare function juxt<A, B, C>(fns: [(a: A) => B, (a: A) => C]): (a: A) => [B, C];
+export declare function juxt<A, B, C, D>(fns: [(a: A) => B, (a: A) => C, (a: A) => D]): (a: A) => [B, C, D];
+export declare function juxt<A, B, C, D, E>(fns: [(a: A) => B, (a: A) => C, (a: A) => D, (a: A) => E]): (a: A) => [B, C, D, E];
+export declare function juxt<A, B>(fns: ReadonlyArray<(a: A) => B>): (a: A) => B[];
+//# sourceMappingURL=juxt.d.ts.map

package/types/src/Composition/juxt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"juxt.d.ts","sourceRoot":"","sources":["../../../src/src/Composition/juxt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjF,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAC7B,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAC3C,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACvB,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAChC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GACxD,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC1B,wBAAgB,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC"}

package/types/src/Composition/on.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Applies a projection to both arguments of a binary function before calling it.
+ * Most useful for building comparators and equality checks over projected values.
+ *
+ * @example
+ * ```ts
+ * const byLength = on((a: number, b: number) => a - b, (s: string) => s.length);
+ *
+ * ["banana", "fig", "apple"].sort(byLength); // ["fig", "apple", "banana"]
+ * ```
+ */
+export declare const on: <A, B, C>(f: (b1: B, b2: B) => C, g: (a: A) => B) => (a: A, b: A) => C;
+//# sourceMappingURL=on.d.ts.map

package/types/src/Composition/on.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"on.d.ts","sourceRoot":"","sources":["../../../src/src/Composition/on.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,EAAE,GACZ,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,MAC/C,GAAG,CAAC,EAAE,GAAG,CAAC,KAAG,CACC,CAAC"}