@wild-framework/container 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# @wild-framework/container
+
+Dependency injection container for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/container
+```
+
+## Usage
+
+```ts
+import { Container, ContainerProvider } from "@wild-framework/container";
+
+const container = new Container();
+container.singleton(UserService, (c) => new UserService(c.resolve(UserRepository)));
+container.transient(Logger, (c) => new Logger());
+
+const service = container.resolve(UserService);
+```
+
+Register `ContainerProvider` with the application to enable `app.resolve()`.
+
+## License
+
+MIT

package/dist/container.d.ts

@@ -0,0 +1,49 @@
+import type { Resolver } from "@wild-framework/core";
+/**
+ * Factory function that receives the container and returns an instance.
+ */
+type Factory<T> = (container: Container) => T;
+/**
+ * Dependency injection container.
+ *
+ * Supports singleton and transient lifetimes. All bindings are explicit —
+ * no decorators, no reflect-metadata, no auto-wiring magic.
+ *
+ * Implements core's `Resolver` interface so `app.resolve()` delegates here.
+ */
+export declare class Container implements Resolver {
+    private bindings;
+    /** Tokens currently being resolved (for circular detection). */
+    private resolving;
+    /**
+     * Register a singleton binding for a class — type is inferred from the token.
+     */
+    singleton<T>(token: abstract new (...args: any[]) => T, factory: Factory<T>): void;
+    /**
+     * Register a singleton binding for an arbitrary token.
+     */
+    singleton<T>(token: unknown, factory: Factory<T>): void;
+    /**
+     * Register a transient binding for a class — type is inferred from the token.
+     */
+    transient<T>(token: abstract new (...args: any[]) => T, factory: Factory<T>): void;
+    /**
+     * Register a transient binding for an arbitrary token.
+     */
+    transient<T>(token: unknown, factory: Factory<T>): void;
+    /**
+     * Resolve a class constructor — type is inferred from the token.
+     */
+    resolve<T>(token: abstract new (...args: any[]) => T): T;
+    /**
+     * Resolve an arbitrary token (string, Symbol, etc.) — type must be explicit.
+     */
+    resolve<T>(token: unknown): T;
+    /**
+     * Check whether a binding exists for the given token.
+     */
+    has(token: unknown): boolean;
+    private assertNotBound;
+}
+export {};
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAGrD;;GAEG;AACH,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;AAY9C;;;;;;;GAOG;AACH,qBAAa,SAAU,YAAW,QAAQ;IACtC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,gEAAgE;IAChE,OAAO,CAAC,SAAS,CAAsB;IAMvC;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAClF;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAavD;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAClF;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAgBvD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;IACxD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC;IA8C7B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ5B,OAAO,CAAC,cAAc;CAKzB"}

package/dist/container.js

@@ -0,0 +1,84 @@
+import { BindingAlreadyExistsError, BindingNotFoundError, CircularDependencyError } from "./errors.js";
+/**
+ * Dependency injection container.
+ *
+ * Supports singleton and transient lifetimes. All bindings are explicit —
+ * no decorators, no reflect-metadata, no auto-wiring magic.
+ *
+ * Implements core's `Resolver` interface so `app.resolve()` delegates here.
+ */
+export class Container {
+    bindings = new Map();
+    /** Tokens currently being resolved (for circular detection). */
+    resolving = new Set();
+    /**
+     * Register a singleton binding.
+     *
+     * The factory is called once and the result is cached for all subsequent
+     * calls to `resolve()`.
+     */
+    singleton(token, factory) {
+        this.assertNotBound(token);
+        this.bindings.set(token, { factory, lifetime: "singleton" });
+    }
+    /**
+     * Register a transient binding.
+     *
+     * The factory is called every time `resolve()` is invoked.
+     */
+    transient(token, factory) {
+        this.assertNotBound(token);
+        this.bindings.set(token, { factory, lifetime: "transient" });
+    }
+    /**
+     * Resolve a dependency by its token.
+     *
+     * For singletons, the factory is called once and the result is cached.
+     * For transients, the factory is called on every resolution.
+     *
+     * Throws `BindingNotFoundError` if no binding exists for the token.
+     * Throws `CircularDependencyError` if a circular chain is detected.
+     */
+    resolve(token) {
+        const binding = this.bindings.get(token);
+        if (!binding) {
+            throw new BindingNotFoundError(token);
+        }
+        // Singleton — return cached instance if available
+        if (binding.lifetime === "singleton" && binding.instance !== undefined) {
+            return binding.instance;
+        }
+        // Circular dependency check
+        if (this.resolving.has(token)) {
+            const chain = [...this.resolving].map(t => typeof t === "function" ? t.name : String(t));
+            chain.push(typeof token === "function" ? token.name : String(token));
+            throw new CircularDependencyError(chain);
+        }
+        this.resolving.add(token);
+        try {
+            const instance = binding.factory(this);
+            if (binding.lifetime === "singleton") {
+                binding.instance = instance;
+            }
+            return instance;
+        }
+        finally {
+            this.resolving.delete(token);
+        }
+    }
+    /**
+     * Check whether a binding exists for the given token.
+     */
+    has(token) {
+        return this.bindings.has(token);
+    }
+    // -----------------------------------------------------------------------
+    // Helpers
+    // -----------------------------------------------------------------------
+    assertNotBound(token) {
+        if (this.bindings.has(token)) {
+            throw new BindingAlreadyExistsError(token);
+        }
+    }
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAiBvG;;;;;;;GAOG;AACH,MAAM,OAAO,SAAS;IACV,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC/C,gEAAgE;IACxD,SAAS,GAAG,IAAI,GAAG,EAAW,CAAC;IAevC;;;;;OAKG;IACH,SAAS,CAAI,KAAc,EAAE,OAAmB;QAC5C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;IAWD;;;;OAIG;IACH,SAAS,CAAI,KAAc,EAAE,OAAmB;QAC5C,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;IACjE,CAAC;IAeD;;;;;;;;OAQG;IACH,OAAO,CAAI,KAAc;QACrB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,kDAAkD;QAClD,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YACrE,OAAO,OAAO,CAAC,QAAa,CAAC;QACjC,CAAC;QAED,4BAA4B;QAC5B,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CACtC,OAAO,CAAC,KAAK,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAC/C,CAAC;YACF,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YACrE,MAAM,IAAI,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAE1B,IAAI,CAAC;YACD,MAAM,QAAQ,GAAI,OAAO,CAAC,OAAsB,CAAC,IAAI,CAAC,CAAC;YAEvD,IAAI,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACnC,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAChC,CAAC;YAED,OAAO,QAAQ,CAAC;QACpB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACjC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAc;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,0EAA0E;IAC1E,UAAU;IACV,0EAA0E;IAElE,cAAc,CAAC,KAAc;QACjC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,IAAI,yBAAyB,CAAC,KAAK,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;CACJ"}

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Thrown when resolving a token that has no binding registered.
+ */
+export declare class BindingNotFoundError extends Error {
+    constructor(token: unknown);
+}
+/**
+ * Thrown when a circular dependency is detected during resolution.
+ */
+export declare class CircularDependencyError extends Error {
+    constructor(chain: string[]);
+}
+/**
+ * Thrown when attempting to register a binding for a token that already exists.
+ */
+export declare class BindingAlreadyExistsError extends Error {
+    constructor(token: unknown);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBAC/B,KAAK,EAAE,OAAO;CAK7B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;gBAClC,KAAK,EAAE,MAAM,EAAE;CAI9B;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;gBACpC,KAAK,EAAE,OAAO;CAK7B"}

package/dist/errors.js

@@ -0,0 +1,30 @@
+/**
+ * Thrown when resolving a token that has no binding registered.
+ */
+export class BindingNotFoundError extends Error {
+    constructor(token) {
+        const name = typeof token === "function" ? token.name : String(token);
+        super(`No binding found for "${name}". Register it with container.singleton() or container.transient() before resolving.`);
+        this.name = "BindingNotFoundError";
+    }
+}
+/**
+ * Thrown when a circular dependency is detected during resolution.
+ */
+export class CircularDependencyError extends Error {
+    constructor(chain) {
+        super(`Circular dependency detected: ${chain.join(" → ")}.`);
+        this.name = "CircularDependencyError";
+    }
+}
+/**
+ * Thrown when attempting to register a binding for a token that already exists.
+ */
+export class BindingAlreadyExistsError extends Error {
+    constructor(token) {
+        const name = typeof token === "function" ? token.name : String(token);
+        super(`A binding for "${name}" already exists.`);
+        this.name = "BindingAlreadyExistsError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC3C,YAAY,KAAc;QACtB,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,CAAC,yBAAyB,IAAI,sFAAsF,CAAC,CAAC;QAC3H,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACvC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C,YAAY,KAAe;QACvB,KAAK,CAAC,iCAAiC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChD,YAAY,KAAc;QACtB,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtE,KAAK,CAAC,kBAAkB,IAAI,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { Container } from "./container.js";
+export { ContainerProvider } from "./provider.js";
+export { BindingAlreadyExistsError, BindingNotFoundError, CircularDependencyError } from "./errors.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { Container } from "./container.js";
+export { ContainerProvider } from "./provider.js";
+export { BindingAlreadyExistsError, BindingNotFoundError, CircularDependencyError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,oBAAoB,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC"}

package/dist/provider.d.ts

@@ -0,0 +1,11 @@
+import type { Provider, Application } from "@wild-framework/core";
+/**
+ * Registers the dependency injection container with the application.
+ *
+ * Must be one of the first providers registered — other providers
+ * depend on it to register their own bindings via `app.resolve(Container)`.
+ */
+export declare class ContainerProvider implements Provider {
+    register(app: Application): void;
+}
+//# sourceMappingURL=provider.d.ts.map

package/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;;;GAKG;AACH,qBAAa,iBAAkB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI;CAQnC"}

package/dist/provider.js

@@ -0,0 +1,16 @@
+import { Container } from "./container.js";
+/**
+ * Registers the dependency injection container with the application.
+ *
+ * Must be one of the first providers registered — other providers
+ * depend on it to register their own bindings via `app.resolve(Container)`.
+ */
+export class ContainerProvider {
+    register(app) {
+        const container = new Container();
+        // Self-bind so other providers can resolve the container itself
+        container.singleton(Container, () => container);
+        app.setResolver(container);
+    }
+}
+//# sourceMappingURL=provider.js.map

package/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,OAAO,iBAAiB;IAC1B,QAAQ,CAAC,GAAgB;QACrB,MAAM,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QAElC,gEAAgE;QAChE,SAAS,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEhD,GAAG,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC/B,CAAC;CACJ"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@wild-framework/container",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Dependency injection container for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "di",
+    "container",
+    "injection"
+  ],
+  "dependencies": {
+    "@wild-framework/core": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}