@illuma/core 1.5.1 → 1.6.0

package/README.md

@@ -1,35 +1,37 @@
-# 🔥 **Illuma** – Angular-style Dependency Injection for TypeScript
+# **Illuma** – Dependency Injection for TypeScript
 
 ![NPM Version](https://img.shields.io/npm/v/%40illuma%2Fcore)
 ![NPM Downloads](https://img.shields.io/npm/dw/%40illuma%2Fcore)
 ![npm bundle size](https://img.shields.io/bundlephobia/min/%40illuma%2Fcore)
 ![Test coverage](./badges/coverage.svg)
 
-A lightweight, type-safe dependency injection container for TypeScript. Zero dependencies.
+A universal, lightweight and type-safe dependency injection container for TypeScript.
+Heavily inspired by Angular's DI system, but designed to work in any environment (Node.js, Bun, Deno, browsers, and more).
 
-## ✨ Features
+## Features
 
-- 🎯 **Type-Safe** – Full TypeScript support with excellent type inference
-- 🪶 **Lightweight** – Zero dependencies, minimal bundle size
-- 🔄 **Flexible** – Classes, factories, values, and aliases
-- 🎨 **Optional decorators** – Angular-style `@NodeInjectable()` decorator
-- 🔗 **Multi-Tokens** – Built-in multi-provider support
-- 🔌 **Plugin System** – Extensible architecture with custom middlewares, scanners, and diagnostics
-- 🧪 **Testkit** – Utilities for easy unit testing and mocking
-- 🌍 **Universal** – Node.js, Deno, browser, and Electron
-## 📦 Installation
+- **Type-Safe** – Excellent type inference
+- **Lightweight** – Zero dependencies, minimal bundle size
+- **Flexible** – Classes, factories, values, and aliases
+- **Optional decorators** – Injectable classes with `@NodeInjectable()` decorator
+- **Multi-Tokens** – Built-in multi-provider support
+- **Plugin System** – Extensible architecture with custom middlewares, scanners, and diagnostics
+- **TestKit** – Unit testing and mocking utilities for any testing framework
+- **Universal** – Node.js, Bun, Deno, browser, and Electron
+
+## Installation
 
 ```bash
 npm install @illuma/core
 ```
 
-## 🤝 Compatibility
+## Compatibility
 
-Anything that supports ES2015+ (ES6+).
-Practically the library is compatible with Node.js (v14+) and all modern browsers.
-For older environments, consider using a transpiler like Babel or TypeScript or provide polyfills as needed.
+Compatible with virtually anything supporting ES2015+ (ES6+).
+Practically the library is compatible with Node.js (v14+), Bun, Deno and all modern browsers.
+For older environments, consider using a transpiler or provide polyfills as needed.
 
-## 🚀 Quick Start
+## Quick start
 
 ```typescript
 import { NodeContainer, NodeInjectable, nodeInject } from '@illuma/core';
@@ -58,9 +60,11 @@ container.bootstrap();
 const userService = container.get(UserService);
 ```
 
-> **Note:** Requires `experimentalDecorators` and `emitDecoratorMetadata` in tsconfig. See [Getting Started](./docs/GETTING_STARTED.md) for decorator-free alternatives.
+> **Note:** 
+> Example above requires `experimentalDecorators` and `emitDecoratorMetadata` in tsconfig. 
+> See [Getting Started](./docs/GETTING_STARTED.md) for decorator-free alternatives.
 
-## 🏷️ Using Tokens
+## Using Tokens
 
 ```typescript
 import { NodeToken, MultiNodeToken, NodeContainer } from '@illuma/core';
@@ -95,7 +99,7 @@ const plugins = container.get(PLUGINS);  // Plugin[]: [AnalyticsPlugin, LoggingP
 
 See [Tokens Guide](./docs/TOKENS.md) for more details.
 
-## 🎨 Provider Types
+## Provider types
 
 ```typescript
 // Class provider
@@ -106,6 +110,7 @@ container.provide({ provide: CONFIG, value: { apiUrl: '...' } });
 
 // Factory provider
 container.provide({ provide: DATABASE, factory: () => {
+  // You can use nodeInject inside factories!
   const env = nodeInject(ENV);
   return createDatabase(env.connectionString);
 } });
@@ -119,7 +124,7 @@ container.provide({ provide: Database, alias: ExistingDatabase });
 
 See [Providers Guide](./docs/PROVIDERS.md) for details.
 
-## 🧪 Testing
+## Testing
 
 ```typescript
 import { createTestFactory } from '@illuma/core/testkit';
@@ -135,36 +140,43 @@ it('should fetch user', () => {
 });
 ```
 
-See [Testing Guide](./docs/TESTKIT.md) for comprehensive examples.
+See [Testing Guide](./docs/TESTKIT.md) for examples.
 
-## 📚 Documentation
+## Documentation
 
 | Guide                                              | Description                                           |
-| -------------------------------------------------- | ----------------------------------------------------- |
+| :--                                                | :--                                                   |
 | [Getting Started](./docs/GETTING_STARTED.md)       | Installation, setup, and basic usage                  |
 | [Providers](./docs/PROVIDERS.md)                   | Value, factory, class, and alias providers            |
 | [Tokens](./docs/TOKENS.md)                         | NodeToken and MultiNodeToken                          |
 | [Async Injection](./docs/ASYNC_INJECTION.md)       | Lazy loading and sub-containers                       |
-| [Testing](./docs/TESTKIT.md)                       | Testkit and mocking                                   |
+| [Testing](./docs/TESTKIT.md)                       | TestKit and mocking                                   |
 | [Plugins](./docs/PLUGINS.md)                       | Extending Illuma with custom scanners and diagnostics |
 | [Technical Overview](./docs/TECHNICAL_OVERVIEW.md) | Deep dive into how Illuma works                       |
 | [API Reference](./docs/API.md)                     | Complete API documentation                            |
 | [Troubleshooting](./docs/TROUBLESHOOTING.md)       | Error codes and solutions                             |
 
-## 🔌 Plugins
+## Plugins
 
-Illuma supports a plugin system for extending functionality. Check out these plugins:
+Illuma supports plugins! Check these out:
 
 - **[@illuma/reflect](https://github.com/git-illuma/reflect)** – Constructor metadata and property decorator injection support
 
 See [Plugins Guide](./docs/PLUGINS.md) for creating your own plugins.
 
-## 📄 License
+## Contributing
+
+Thank you for considering contributing to Illuma! I deeply appreciate your interest in making this project better.
+
+Anyways, to get you started, please take a look at the [Contributing Guide](./CONTRIBUTING.md) for guidelines on how to setup development environment, run tests, and submit pull requests.
+
+## License
 
-MIT © [bebrasmell](https://github.com/bebrasmell)
+MIT
 
-## 🔗 Links
+Created by [bebrasmell](https://github.com/bebrasmell)
 
+## Links
+- [NPM](https://npmjs.com/package/@illuma/core)
 - [GitHub](https://github.com/git-illuma/core)
-- [NPM](https://www.npmjs.com/package/@illuma/core)
 - [Issues](https://github.com/git-illuma/core/issues)

package/dist/index.cjs

@@ -377,7 +377,7 @@ __name(isNotFoundError, "isNotFoundError");
 
 // src/lib/api/decorator.ts
 var tokenRegistry = /* @__PURE__ */ new WeakMap();
-var INJECTION_SYMBOL = Symbol("Injectable");
+var INJECTION_SYMBOL = /* @__PURE__ */ Symbol("Injectable");
 function NodeInjectable() {
   return (ctor) => {
     const nodeToken = new NodeToken(`_${ctor.name}`, {
@@ -1001,7 +1001,7 @@ __name(injectDefer, "injectDefer");
 
 // src/lib/utils/inheritance.ts
 function injectGroupAsync(fn, opts) {
-  const { container: parent } = nodeInject(Injector);
+  const { container: parent } = opts?.injector ?? nodeInject(Injector);
   const factory = /* @__PURE__ */ __name(async () => {
     const providers = await fn();
     const subContainer = new NodeContainer({
@@ -1022,7 +1022,7 @@ function injectGroupAsync(fn, opts) {
 }
 __name(injectGroupAsync, "injectGroupAsync");
 function injectAsync(fn, opts) {
-  const { container: parent } = nodeInject(Injector);
+  const { container: parent } = opts?.injector ?? nodeInject(Injector);
   const factory = /* @__PURE__ */ __name(async () => {
     const token = await fn();
     const tempContainer = new NodeContainer({
@@ -1043,7 +1043,7 @@ function injectAsync(fn, opts) {
 }
 __name(injectAsync, "injectAsync");
 function injectEntryAsync(fn, opts) {
-  const { container: parent } = nodeInject(Injector);
+  const { container: parent } = opts?.injector ?? nodeInject(Injector);
   const factory = /* @__PURE__ */ __name(async () => {
     const { entrypoint, providers } = await fn();
     const subContainer = new NodeContainer({