microsoft/tsyringe
Tsyringe
tsyringe is a TypeScript dependency injection container and inversion of control framework. It decouples class implementations from object creation by managing dependencies and object lifecycles using decorators and metadata.
The framework features a hierarchical container system where child containers can maintain independent registration scopes and fall back to parent containers for dependency resolution. It provides a provider system that controls object longevity through singleton and transient instantiation rules.
The system supports recursive constructor injection and handles circular dependencies using proxies. It includes capabilities for token-based registry mapping, multi-implementation resolution, and automated resource disposal for objects that implement cleanup interfaces.
Features
- TypeScript Dependency Injection Libraries - Provides a full-featured dependency injection library tailored for TypeScript, leveraging decorators and metadata for runtime injection.
- Dependency Lifecycle Management - Manages the acquisition and release phases of dependencies to control object longevity.
- Hierarchical Containers - Ships a hierarchical container system where child containers maintain independent scopes and fall back to parent containers.
- Class Registries - Maintains centralized mappings of tokens to provider definitions for dynamic lookup and instantiation.
- Dependency Injection Frameworks - Functions as a comprehensive inversion of control framework that decouples class implementations from their instantiation logic.
- Automatic Constructor Injection - Provides automatic provisioning of dependencies into constructors using metadata and annotations.
- Dependency Resolution - Provides the process of retrieving and instantiating registered services from a container using unique tokens.
- Instance Lifecycles - Controls object longevity through singleton and transient instantiation rules.
- Dependency Metadata - Uses TypeScript decorators to store dependency requirements in class metadata for runtime retrieval.
- Instance Lifecycles - Provides a provider system to control object longevity via singleton and transient instantiation rules.
- Recursive Dependency Resolution - Resolves a graph of nested constructor dependencies recursively until a base instance is created.
- Provider Mappings - Links tokens to classes, values, or factories to define how the container creates dependencies.
- Dependency Resource Disposal - Executes registered cleanup functions for dependencies to release system resources.
- Disposable Resource Management - Automates the cleanup of memory and connections by triggering disposal methods on container-managed objects.
- Circular Dependency Resolvers - Implements mechanisms to break circular dependency loops by providing partially initialized references during object instantiation.
- Resource Cleanup Utilities - Provides utilities for ensuring the deterministic release of system resources during object destruction.
- Circular Dependency Resolution - Implements techniques for deferring component resolution to handle circular module dependencies.
- Dependency State Management - Manages shared resources by defining dependencies as singletons or transient instances.
- Modular Software Design - Provides a foundation for modular software design through token-based registration and decoupled component organization.
- Container Shutdown Cleanup - Triggers cleanup methods on all objects implementing a disposable interface during container shutdown.
- Proxy-Based Resolution - Provides proxy objects that resolve dependencies lazily to break circular dependency loops.
