utilium 1.4.0 → 1.5.0

package/dist/objects.d.ts

@@ -38,3 +38,14 @@ export type JSONObject = {
     [K in string]: JSONValue;
 };
 export type JSONValue = JSONPrimitive | JSONObject | JSONValue[];
+/**
+ * An object `T` with all of its functions bound to a `This` value
+ */
+type Bound<T extends object, This = any> = T & {
+    [k in keyof T]: T[k] extends (...args: any[]) => any ? (this: This, ...args: Parameters<T[k]>) => ReturnType<T[k]> : T[k];
+};
+/**
+ * Binds a this value for all of the functions in an object (not recursive)
+ */
+export declare function bindFunctions<T extends object, This = any>(fns: T, thisValue: This): Bound<T, This>;
+export {};

package/dist/objects.js

@@ -59,3 +59,9 @@ export function setByString(object, path, value, separator = /[.[\]'"]/) {
         .filter(p => p)
         .reduce((o, p, i) => (o[p] = path.split(separator).filter(p => p).length === ++i ? value : o[p] || {}), object);
 }
+/**
+ * Binds a this value for all of the functions in an object (not recursive)
+ */
+export function bindFunctions(fns, thisValue) {
+    return Object.fromEntries(Object.entries(fns).map(([k, v]) => [k, typeof v == 'function' ? v.bind(thisValue) : v]));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "utilium",
-	"version": "1.4.0",
+	"version": "1.5.0",
 	"description": "Typescript utilities",
 	"funding": {
 		"type": "individual",

package/src/objects.ts

@@ -118,3 +118,21 @@ export type JSONPrimitive = null | string | number | boolean;
 export type JSONObject = { [K in string]: JSONValue };
 
 export type JSONValue = JSONPrimitive | JSONObject | JSONValue[];
+
+/**
+ * An object `T` with all of its functions bound to a `This` value
+ */
+type Bound<T extends object, This = any> = T & {
+	[k in keyof T]: T[k] extends (...args: any[]) => any
+		? (this: This, ...args: Parameters<T[k]>) => ReturnType<T[k]>
+		: T[k];
+};
+
+/**
+ * Binds a this value for all of the functions in an object (not recursive)
+ */
+export function bindFunctions<T extends object, This = any>(fns: T, thisValue: This): Bound<T, This> {
+	return Object.fromEntries(
+		Object.entries(fns).map(([k, v]) => [k, typeof v == 'function' ? v.bind(thisValue) : v])
+	) as Bound<T, This>;
+}