feat: add memory function

workspace/mauss/src/core/README.md

@@ -44,6 +44,14 @@ A function to check for values equality between two variables. This will work fo
 
 A function that accepts a function and returns the same function with the order of parameters reversed. This can be used in conjunction with `compare` methods to sort the items in ascending values.
 
+## `memory`
+
+```typescript
+export function memory<T>(initial: T, fn: (previous: T) => void): (updated: T) => T;
+```
+
+A higher-order function that runs a callback function only when the `initial`/previous and `updated` are different. This is useful for updating the state of a component only when the value has changed.
+
 ## `pipe`
 
 A type-safe higher-order function that accepts any number of arguments, it returns a function with the parameters of the first function passed and a return type/value of the last function.

workspace/mauss/src/core/standard/index.ts

@@ -55,6 +55,16 @@ export function inverse<Function extends AnyFunction>(fn: Function) {
 	return (...parameters: Reversed): Returned => fn(...parameters.reverse());
 }
 
+export function memory<T>(initial: T, fn: AnyFunction<[previous: T], void>) {
+	let previous = initial;
+	return (updated: T) => {
+		if (!identical(previous, updated)) {
+			fn(previous), (previous = updated);
+		}
+		return updated;
+	};
+}
+
 /**
  * regexp - implementation of global RegExp constructor with escaped pattern
  * @param pattern passed in the form of string literal