@wendellhu/redi

redi

redi (pronounced 'ready') is a lightweight dependency injection library for TypeScript and JavaScript, with React bindings included.

Why redi?

Quick Start

npm install @wendellhu/redi

import { Inject, Injector } from '@wendellhu/redi';

class AuthService {
  getCurrentUserInfo(): UserInfo {
    /* ... */
  }
}

class FileListService {
  constructor(@Inject(AuthService) private authService: AuthService) {}

  getUserFiles(): Promise<Files> {
    const user = this.authService.getCurrentUserInfo();
    // ...
  }
}

const injector = new Injector([[AuthService], [FileListService]]);
const fileList = injector.get(FileListService);

Getting started.

Features

• Dependency Items: Class { useClass }, Value { useValue }, Factory { useFactory }, Async { useAsync }
• Interface Injection: Use createIdentifier for interface-based injection
• Lazy Instantiation: Defer creation with { lazy: true }
• Hierarchy Injection: Parent-child injectors with @Self() and @SkipSelf()
• Optional & Many: @Optional() and @Many() decorators
• React Integration: useDependency, connectDependencies and more hooks
• RxJS Support: useObservable and useUpdateBinder for reactive programming

Who's Using redi?

• Univer
• ByteDance

Links

• Demo TodoMVC (source)
• Starter Template
• Contributing Guide

License

MIT. Copyright 2021-present Wenzhao Hu.