@miyauci/memo/script/memo.d.ts

Memoization tools, TC39 proposal-function-memo implementation

/** Returns the proxy function whose call is monitored. It calls at most once for each given arguments.
 * @example
 * ```ts
 * import { memo } from "https://deno.land/x/memoization@$VERSION/memo.ts";
 *
 * function f(x: number): number {
 *  console.log(x);
 *  return x * 2;
 * }
 *
 * const fMemo = memo(f);
 * fMemo(3); // Prints 3 and returns 6.
 * fMemo(3); // Does not print anything. Returns 6.
 * fMemo(2); // Prints 2 and returns 4.
 * fMemo(2); // Does not print anything. Returns 4.
 * fMemo(3); // Does not print anything. Returns 6.
 * ```
 *
 * Either version would work with recursive functions:
 *
 * @example
 * ```ts
 * import { memo } from "https://deno.land/x/memoization@$VERSION/memo.ts";
 *
 * const fib = memo((num: number): number => {
 *  if (num < 2) return num;
 *
 *  return fib(num - 1) + fib(num - 2);
 * });
 *
 * fib(1000);
 * ```
 */
export declare function memo<T extends (...args: any) => any>(fn: T, cache?: MapLike<object, ReturnType<T>>, 
/** Keying for cache key. */
keying?: (args: Parameters<T>) => unknown[]): T;
export declare function memo<T extends abstract new (...args: any) => any>(fn: T, cache?: MapLike<object, InstanceType<T>>, keying?: (args: ConstructorParameters<T>) => unknown[]): T;
/** {@link Map} like API. */
export interface MapLike<K, V> {
    /** Returns a specified element. If the value that is associated to the provided key is an object, then you will get a reference to that object and any change made to that object will effectively modify it. */
    get(key: K): V | undefined;
    /** Whether an element with the specified key exists or not. */
    has(key: K): boolean;
    /** Adds a new element with a specified key and value. */
    set(key: K, value: V): void;
}