@thi.ng/memoize 3.1.65 → 3.2.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2024-03-13T14:04:31Z
+- **Last updated**: 2024-03-27T09:53:45Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -9,6 +9,20 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [3.2.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/memoize@3.2.0) (2024-03-27)
+
+#### 🚀 Features
+
+- add memoizeO() ([af2ead9](https://github.com/thi-ng/umbrella/commit/af2ead9))
+- add memoize2/3/4O() ([8309236](https://github.com/thi-ng/umbrella/commit/8309236))
+
+#### ♻️ Refactoring
+
+- minor updates, use plain objects where possible ([f44be23](https://github.com/thi-ng/umbrella/commit/f44be23))
+  - update defOnce() & memoizeJ() to use Object.create(null) as default store
+  - update default args in others
+  - update docs
+
 ### [3.1.41](https://github.com/thi-ng/umbrella/tree/@thi.ng/memoize@3.1.41) (2023-11-09)
 
 #### ♻️ Refactoring

package/README.md

@@ -72,7 +72,7 @@ For Node.js REPL:
 const memoize = await import("@thi.ng/memoize");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 247 bytes
+Package sizes (brotli'd, pre-treeshake): ESM: 334 bytes
 
 ## Dependencies
 

package/defonce.d.ts

@@ -1,14 +1,18 @@
 import type { Fn0 } from "@thi.ng/api";
 /**
- * Lightweight named singleton factory, intended for hot-module
- * replacement situations. Takes a (preferably globally unique) `id` and
- * `factory` function. If there's no value defined for `id` yet, calls
- * `factory` to produce the singleton value and caches it. Returns
- * singleton value.
+ * Lightweight named singleton factory, intended for hot-module replacement
+ * situations. Takes a (preferably globally unique) `id` and `factory` function.
+ * If there's no value defined for `id` yet, calls `factory` to produce the
+ * singleton value and caches it. Returns singleton value.
  *
- * Note: All created values will remain in the private cache until the
- * JS process terminates or this module itself has been reloaded (though
- * the latter shouldn't happen in an HMR workflow).
+ * @remarks
+ * Note: All created values will remain in the private cache until the JS
+ * process terminates or this module itself has been reloaded (though the latter
+ * shouldn't happen in an HMR workflow).
+ *
+ * For more control over memory usage, consider using other memoize functions in
+ * this package with one of the available cache implementations from
+ * [thi.ng/cache](https://thi.ng/cache).
  *
  * @param id -
  * @param factory -

package/defonce.js

@@ -1,5 +1,5 @@
-const cache = {};
-const defonce = (id, factory) => cache.hasOwnProperty(id) ? cache[id] : cache[id] = factory();
+const cache = /* @__PURE__ */ Object.create(null);
+const defonce = (id, factory) => id in cache ? cache[id] : cache[id] = factory();
 export {
   defonce
 };

package/do-once.js

@@ -1,11 +1,8 @@
-const doOnce = (fn, cache) => {
-  !cache && (cache = /* @__PURE__ */ new Map());
-  return (x) => {
-    if (!cache.has(x)) {
-      cache.set(x, true);
-      fn(x);
-    }
-  };
+const doOnce = (fn, cache = /* @__PURE__ */ new Map()) => (x) => {
+  if (!cache.has(x)) {
+    cache.set(x, true);
+    fn(x);
+  }
 };
 export {
   doOnce

package/index.d.ts

@@ -4,4 +4,5 @@ export * from "./do-once.js";
 export * from "./memoize.js";
 export * from "./memoize1.js";
 export * from "./memoizej.js";
+export * from "./memoizeo.js";
 //# sourceMappingURL=index.d.ts.map

package/index.js

@@ -4,3 +4,4 @@ export * from "./do-once.js";
 export * from "./memoize.js";
 export * from "./memoize1.js";
 export * from "./memoizej.js";
+export * from "./memoizeo.js";

package/memoize.d.ts

@@ -6,10 +6,13 @@ import type { MapLike } from "./api.js";
  * memoized result of given args. Supports generics for up to 4 args (otherwise
  * untyped).
  *
+ * @remarks
  * **Important:** It only makes sense to use `Map` types which support value
  * (rather than object) equality, e.g. those provided by
  * [`thi.ng/associative`](https://thi.ng/associative). Using a native `Map` type
- * here will lead to memory leaks! Alternatively, use {@link memoizeJ}.
+ * here will lead to memory leaks!
+ *
+ * Also see {@link memoizeJ}, {@link memoize1}, {@link memoizeO}.
  *
  * @param fn -
  * @param cache -

package/memoize1.d.ts

@@ -1,11 +1,16 @@
 import type { Fn } from "@thi.ng/api";
 import type { MapLike } from "./api.js";
 /**
- * Optimized memoization for single arg functions. If the function expects args
- * other than strings or numbers, you MUST provide a `Map` implementation which
- * supports value (rather than object) equality, e.g. one of those provided by
+ * Optimized memoization for single arg functions.
+ *
+ * @remarks
+ * If the function expects args other than strings or numbers, you MUST provide
+ * a `Map` implementation which supports value (rather than object) equality,
+ * e.g. one of those provided by
  * [`thi.ng/associative`](https://thi.ng/associative). Using a native `Map` type
- * here will lead to memory leaks! Alternatively, use {@link memoizeJ}.
+ * here will lead to memory leaks!
+ *
+ * Also see {@link memoizeO}, {@link memoizeJ}, {@link memoize}.
  *
  * @param fn -
  * @param cache -

package/memoize1.js

@@ -1,9 +1,6 @@
-const memoize1 = (fn, cache) => {
-  !cache && (cache = /* @__PURE__ */ new Map());
-  return (x) => {
-    let res;
-    return cache.has(x) ? cache.get(x) : (cache.set(x, res = fn(x)), res);
-  };
+const memoize1 = (fn, cache = /* @__PURE__ */ new Map()) => (x) => {
+  let res;
+  return cache.has(x) ? cache.get(x) : (cache.set(x, res = fn(x)), res);
 };
 export {
   memoize1

package/memoizej.d.ts

@@ -5,9 +5,12 @@ import type { Fn, Fn2, Fn3, Fn4, IObjectOf } from "@thi.ng/api";
  * memoized result for given args. Supports generics for up to 4 args
  * (otherwise untyped).
  *
+ * @remarks
  * **Important:** If the given args cannot be stringified, the user
  * function will ALWAYS be called (without caching result).
  *
+ * Also see {@link memoize}, {@link memoize1}, {@link memoizeO}.
+ *
  * @param fn -
  * @param cache -
  */

package/memoizej.js

@@ -1,5 +1,4 @@
-function memoizeJ(fn, cache) {
-  !cache && (cache = {});
+function memoizeJ(fn, cache = /* @__PURE__ */ Object.create(null)) {
   return (...args) => {
     const key = JSON.stringify(args);
     if (key !== void 0) {

package/memoizeo.d.ts

@@ -0,0 +1,53 @@
+import type { Fn, Fn2, Fn3, Fn4, NumOrString } from "@thi.ng/api";
+/**
+ * The most minimalistic & fastest memoization function of this package. Similar
+ * to {@link memoize1}, but only supports numbers or strings as keys and uses a
+ * vanilla JS object as cache.
+ *
+ * @remarks
+ * Also see {@link memoize1}, {@link memoizeJ}, {@link memoize}.
+ *
+ * @example
+ * ```ts tangle:../../export/memoizeo.ts
+ * import { memoizeO } from "@thi.ng/memoize";
+ *
+ * const test = memoizeO((x: number) => (console.log("exec", x), x * 10));
+ *
+ * console.log(test(1));
+ * // exec 1
+ * // 10
+ *
+ * console.log(test(1))
+ * // 10
+ *
+ * console.log(test(2));
+ * // exec 2
+ * // 20
+ * ```
+ *
+ * @param fn
+ * @param cache
+ */
+export declare const memoizeO: <A extends NumOrString, B>(fn: Fn<A, B>, cache?: Record<NumOrString, B>) => (x: A) => B;
+/**
+ * Like {@link memoizeO}, but for functions with 2 arguments.
+ *
+ * @param fn
+ * @param cache
+ */
+export declare const memoize2O: <A extends NumOrString, B extends NumOrString, C>(fn: Fn2<A, B, C>, cache?: Record<string, C>) => (a: A, b: B) => C;
+/**
+ * Like {@link memoizeO}, but for functions with 3 arguments.
+ *
+ * @param fn
+ * @param cache
+ */
+export declare const memoize3O: <A extends NumOrString, B extends NumOrString, C extends NumOrString, D>(fn: Fn3<A, B, C, D>, cache?: Record<string, D>) => (a: A, b: B, c: C) => D;
+/**
+ * Like {@link memoizeO}, but for functions with 4 arguments.
+ *
+ * @param fn
+ * @param cache
+ */
+export declare const memoize4O: <A extends NumOrString, B extends NumOrString, C extends NumOrString, D extends NumOrString, E>(fn: Fn4<A, B, C, D, E>, cache?: Record<string, E>) => (a: A, b: B, c: C, d: D) => E;
+//# sourceMappingURL=memoizeo.d.ts.map

package/memoizeo.js

@@ -0,0 +1,19 @@
+const memoizeO = (fn, cache = /* @__PURE__ */ Object.create(null)) => (x) => x in cache ? cache[x] : cache[x] = fn(x);
+const memoize2O = (fn, cache = /* @__PURE__ */ Object.create(null)) => (a, b) => {
+  const key = a + "-" + b;
+  return key in cache ? cache[key] : cache[key] = fn(a, b);
+};
+const memoize3O = (fn, cache = /* @__PURE__ */ Object.create(null)) => (a, b, c) => {
+  const key = a + "-" + b + "-" + c;
+  return key in cache ? cache[key] : cache[key] = fn(a, b, c);
+};
+const memoize4O = (fn, cache = /* @__PURE__ */ Object.create(null)) => (a, b, c, d) => {
+  const key = a + "-" + b + "-" + c + "-" + d;
+  return key in cache ? cache[key] : cache[key] = fn(a, b, c, d);
+};
+export {
+  memoize2O,
+  memoize3O,
+  memoize4O,
+  memoizeO
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/memoize",
-  "version": "3.1.65",
+  "version": "3.2.0",
   "description": "Function memoization with configurable caching",
   "type": "module",
   "module": "./index.js",
@@ -36,14 +36,14 @@
     "tool:tangle": "../../node_modules/.bin/tangle src/**/*.ts"
   },
   "dependencies": {
-    "@thi.ng/api": "^8.9.30"
+    "@thi.ng/api": "^8.9.31"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.42.3",
-    "esbuild": "^0.20.1",
+    "@microsoft/api-extractor": "^7.43.0",
+    "esbuild": "^0.20.2",
     "rimraf": "^5.0.5",
     "typedoc": "^0.25.12",
-    "typescript": "^5.4.2"
+    "typescript": "^5.4.3"
   },
   "keywords": [
     "cache",
@@ -82,6 +82,9 @@
     },
     "./memoizej": {
       "default": "./memoizej.js"
+    },
+    "./memoizeo": {
+      "default": "./memoizeo.js"
     }
   },
   "thi.ng": {
@@ -90,5 +93,5 @@
     ],
     "year": 2018
   },
-  "gitHead": "7f3fcbd6c0462b0ce45afa141fe163d1f297fd51\n"
+  "gitHead": "feb3b24654f2c931cd3c3308c1c0c807ee14d0e4\n"
 }