Documentation

ClaDI is a zero-dependency TypeScript toolkit for modular dependency injection and composition-root architecture.

What You Get

Typed contracts via createToken<T>()
Provider-based composition (useValue, useClass, useFactory, useExisting, useLazy)
Scope-aware lifecycles (singleton, scoped, transient)
Runtime diagnostics (validate, explain, snapshot, exportGraph)
Startup hardening (bootstrap, lock, isLocked)
Optional ergonomics for modules and decorators (autowire, composeDecoratedModules)
Dedicated testing helpers via companion package (@elsikora/cladi-testing)

Getting Started - install, bootstrap, and first composition root
Core Concepts - container behavior, provider patterns, and architecture guidance
Utilities - helper APIs for container/token/provider/logging setup
Testing Utilities - practical patterns for createTestingContainer, mockProvider, and overrideProvider
Services - logger contracts and implementation
API Reference - exported enums and interfaces