Nonna – TypeScript Dependency injection without the reflection tax

Nonna is a dependency-injection framework for TypeScript and JavaScript, paired with an ahead-of-time compiler. Its central design goal is to move dependency analysis out of runtime: the compiler uses TypeScript’s type checker to infer constructor dependencies and generate registration metadata, avoiding reflection and the need for reflect-metadata. A typical setup marks classes as injectable, imports the generated dependency file, builds an injector, retrieves services, and destroys the injector when finished. The project presents the same core container as usable across Node.js, Deno, Bun, edge environments, and integrations for frontend frameworks including React, Vue, and Svelte.

The framework emphasizes a small runtime, lifecycle control, and request isolation. It supports request-scoped dependencies tied to asynchronous execution, while guarding against those instances leaking into singletons; lifecycle hooks run predictably, with teardown in reverse order and combined error reporting. Other features include multi-providers, aliases, synchronous and asynchronous factories, and container inspection. Its performance approach includes integer-keyed registrations, cached dependency metadata, lightweight circular-dependency tracking, avoiding AsyncLocalStorage when request scope is unused, and concurrently starting independent eager providers. The project also highlights zero runtime dependencies and compatibility across runtimes as engineering constraints, and offers framework adapters, a Vite plugin, documentation, examples, and an MIT license.