Ngememoize NPM

Ngememoize: Angular Memoization Library

\ Easily boost the performance of your Angular applications by memoizing functions and getters with this lightweight and simple-to-use library.

✨ Features

Memoize Functions: Cache function results for improved performance.
Memoize Getters: Optimize computed properties with caching.
Lightweight: Designed for efficiency without adding unnecessary overhead.
Decorator Support: Memoization is as simple as adding a decorator.
Angular Compatible: Fully supports Angular 18 and later.
Tree Shakable: Only include what you need.

📦 Installation

To get started, install Ngememoize via npm:

npm install ngememoize

Or, if you use Yarn or PNPM:

yarn add ngememoize
# or
pnpm add ngememoize

🚀 Quick Start

Memoize a Function

import { Ngememoize } from 'ngememoize';

// Method example
@Memoize<[number], number>({
  debugLabel: 'processData'
})
processData(value: number): number {
  console.log('Processing...');
  return value * 2;
}

// Getter example
@Memoize<never, number>({
  debugLabel: 'computedValue'
})
get computedValue(): number {
  console.log('Computing...');
  return this.data.reduce((sum, val) => sum + val, 0);
}

// Dependent getter example
@MemoizeWithDeps<never, number>(
  function(this: ExampleComponent) {
    return [this.data, this.multiplier];
  },
  { debugLabel: 'dependentValue' }
)
get dependentValue(): number {
  console.log('Computing dependent...');
  return this.computedValue * this.multiplier;
}

// Async method example
@Memoize<[string], Promise<string>>({
  debugLabel: 'fetchData',
  maxAge: 5000
})
async fetchData(id: string): Promise<string> {
  console.log('Fetching...');
  return new Promise(resolve => 
    setTimeout(() => resolve(`Data for ${id}`), 1000)
  );
}

For more examples on how to use Ngememoize, please refer to the /projects/example directory.