@kurdel/ioc 0.1.0-beta.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025-2026 Andrii Sorokin
+
+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,39 @@
+# @kurdel/ioc
+
+Lightweight **dependency injection container** used across the Kurdel framework.  
+Designed for modular architecture, request-scoped resolution, and type-safe tokens.
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @kurdel/ioc
+```
+
+---
+
+## 🚀 Usage
+
+```ts
+import { createContainer, createToken } from '@kurdel/ioc';
+
+interface UserRepo { findAll(): any[] }
+class UserRepoImpl implements UserRepo {
+  findAll() { return [{ id: 1, name: 'Ada' }]; }
+}
+
+const token = createToken<UserRepo>('UserRepo');
+const ioc = createContainer();
+
+ioc.bind(token).to(UserRepoImpl).inSingletonScope();
+
+const repo = ioc.get(token);
+console.log(repo.findAll());
+```
+
+---
+
+## 📄 License
+
+MIT © Andrii Sorokin

package/lib/api/container.d.ts

@@ -0,0 +1,135 @@
+import type { Newable } from '@kurdel/common';
+import type { Identifier } from '../api/identifier.js';
+/**
+ * Fluent API returned by {@link Container.bind}.
+ * Allows binding an abstract identifier (interface, symbol, token)
+ * to a concrete implementation and configuring additional metadata.
+ */
+export interface BindingToContract<T> {
+    /**
+     * Bind this identifier to the given class constructor.
+     * @param impl - Class to instantiate when this identifier is resolved.
+     * @returns A fluent builder for configuring deps/scope.
+     */
+    to(impl: Newable<T>): BindingWithInContract<T>;
+    /**
+     * Bind this identifier to a pre-created instance.
+     * The same value will be returned for each resolution.
+     * @param value - Instance to associate with the identifier.
+     */
+    toInstance(value: T): void;
+}
+/**
+ * Fluent API returned by {@link Container.put} or {@link BindingToContract.to}.
+ * Used to configure constructor dependencies and scope.
+ */
+export interface BindingWithInContract<T> {
+    /**
+     * Define constructor dependencies for the bound class.
+     * Each key corresponds to a constructor parameter name,
+     * and the value is the identifier of the dependency.
+     *
+     * @example
+     * container.put(UserService).with({ repo: UserRepository });
+     */
+    with(deps: Record<string, Identifier>): this;
+    /**
+     * Mark this binding as a singleton.
+     * The same instance will be reused across resolutions within this container
+     * (and possibly its child scopes, depending on the implementation).
+     */
+    inSingletonScope(): this;
+}
+/**
+ * Node in a dependency graph produced by {@link Container.getGraph}.
+ */
+export interface DependencyNode {
+    /** Human-readable name or key of the binding. */
+    key: string;
+    /** Indicates whether this dependency originated from a parent container. */
+    fromParent?: boolean;
+    /** Nested dependency nodes (constructor deps). */
+    deps: DependencyNode[];
+}
+/**
+ * Minimal Dependency Injection container contract.
+ *
+ * Defines all essential operations supported by the Kurdel IoC system.
+ * Implementations should follow SOLID principles and be runtime-agnostic.
+ */
+export interface Container {
+    /**
+     * Create a new **child (request-scoped)** container.
+     *
+     * The child delegates lookups to this container (its parent) when
+     * a binding is not found locally. Singleton bindings registered in the
+     * parent remain shared; bindings added to the child are isolated to the
+     * child’s lifetime.
+     *
+     * @returns A new child container.
+     */
+    createScope(): Container;
+    /**
+     * Bind an abstract identifier (symbol/interface) to a concrete class.
+     * Returns a fluent API to configure its dependencies and lifetime.
+     *
+     * @example
+     * container.bind<IDb>(DBToken).to(SqliteDb).inSingletonScope();
+     */
+    bind<T>(key: Identifier<T>): BindingToContract<T>;
+    /**
+     * Register a concrete class (constructor) directly in the container.
+     * Returns a fluent API to configure constructor dependencies and lifetime.
+     *
+     * @example
+     * container.put(UserService).with({ repo: UserRepository });
+     */
+    put<T>(ctor: Newable<T>): BindingWithInContract<T>;
+    /**
+     * Register a factory function that produces an instance each time
+     * the dependency is resolved, unless the binding is marked as singleton.
+     *
+     * @param key - Identifier to bind.
+     * @param factory - Function returning the instance.
+     */
+    toFactory<T>(key: Identifier<T>, factory: () => T): void;
+    /**
+     * Register a ready-made instance for the identifier.
+     * The instance will be reused for all subsequent resolutions.
+     *
+     * @param key - Identifier for the instance.
+     * @param value - The actual instance to store.
+     */
+    set<T>(key: Identifier<T>, value: T): void;
+    /**
+     * Resolve and return an instance for the given identifier.
+     * Implementations must recursively resolve declared dependencies.
+     *
+     * @typeParam T - Expected instance type.
+     * @param key - Identifier (token/class) to resolve.
+     * @throws If the identifier is not registered in this container hierarchy.
+     */
+    get<T>(key: Identifier<T>): T;
+    /**
+     * Check whether an identifier is bound in this container or any parent.
+     *
+     * @param key - Identifier to check.
+     * @returns `true` if found locally or in the parent chain.
+     */
+    has(key: Identifier): boolean;
+    /**
+     * Build and return a dependency graph for this container.
+     * Useful for introspection and debugging.
+     *
+     * @param rootKey - Optional starting identifier (defaults to all local bindings).
+     * @returns Dependency tree(s) describing how bindings reference each other.
+     */
+    getGraph(rootKey?: Identifier): DependencyNode[];
+    /**
+     * Print a visual representation of the dependency graph to the console.
+     * Intended for developer diagnostics and debugging.
+     *
+     * @param rootKey - Optional starting identifier.
+     */
+    printGraph(rootKey?: Identifier): void;
+}

package/lib/api/container.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=container.js.map

package/lib/api/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/api/container.ts"],"names":[],"mappings":""}

package/lib/api/identifier.d.ts

@@ -0,0 +1,2 @@
+import type { Newable } from '@kurdel/common';
+export type Identifier<T = unknown> = string | symbol | Newable<T>;

package/lib/api/identifier.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=identifier.js.map

package/lib/api/identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifier.js","sourceRoot":"","sources":["../../src/api/identifier.ts"],"names":[],"mappings":""}

package/lib/api/injection-token.d.ts

@@ -0,0 +1,7 @@
+export type InjectionToken<T> = symbol & {
+    __type?: T;
+};
+export type TokenFor<T> = InjectionToken<T>;
+export declare function createToken<T>(key: string, global?: boolean): InjectionToken<T>;
+export declare const createGlobalToken: <T>(key: string) => InjectionToken<T>;
+export declare const createLocalToken: <T>(key: string) => InjectionToken<T>;

package/lib/api/injection-token.js

@@ -0,0 +1,7 @@
+export function createToken(key, global = false) {
+    const s = global ? Symbol.for(key) : Symbol(key);
+    return s;
+}
+export const createGlobalToken = (key) => createToken(key, true);
+export const createLocalToken = (key) => createToken(key, false);
+//# sourceMappingURL=injection-token.js.map

package/lib/api/injection-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injection-token.js","sourceRoot":"","sources":["../../src/api/injection-token.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,WAAW,CAAI,GAAW,EAAE,MAAM,GAAG,KAAK;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,CAAsB,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAI,GAAW,EAAE,EAAE,CAAC,WAAW,CAAI,GAAG,EAAE,IAAI,CAAC,CAAC;AAC/E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAI,GAAW,EAAE,EAAE,CAAC,WAAW,CAAI,GAAG,EAAE,KAAK,CAAC,CAAC"}

package/lib/api/types.d.ts

@@ -0,0 +1,2 @@
+export type ScopeType = 'Transient' | 'Singleton';
+export type BindingType = 'Constructor' | 'Instance';

package/lib/api/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/lib/api/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/api/types.ts"],"names":[],"mappings":""}

package/lib/index.d.ts

@@ -0,0 +1,4 @@
+export * from './api/identifier.js';
+export * from './api/injection-token.js';
+export * from './api/container.js';
+export * from './runtime/ioc-container.js';

package/lib/index.js

@@ -0,0 +1,5 @@
+export * from './api/identifier.js';
+export * from './api/injection-token.js';
+export * from './api/container.js';
+export * from './runtime/ioc-container.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC;AAErC,cAAc,8BAA8B,CAAC"}

package/lib/runtime/binding-in-contract.d.ts

@@ -0,0 +1,21 @@
+import type { Binding } from '../runtime/binding.js';
+/**
+ * Fluent contract returned after `.to()` or `.toInstance()`.
+ *
+ * Allows you to configure the binding scope:
+ * - transient (default) → new instance every time
+ * - singleton → one instance cached and reused
+ */
+export declare class BindingInContract<T> {
+    private binding;
+    constructor(binding: Binding<T>);
+    /**
+     * Make this binding a singleton.
+     *
+     * @example
+     * ```ts
+     * container.bind<IDatabase>(IDatabase).to(SQLiteDatabase).inSingletonScope();
+     * ```
+     */
+    inSingletonScope(): this;
+}

package/lib/runtime/binding-in-contract.js

@@ -0,0 +1,25 @@
+/**
+ * Fluent contract returned after `.to()` or `.toInstance()`.
+ *
+ * Allows you to configure the binding scope:
+ * - transient (default) → new instance every time
+ * - singleton → one instance cached and reused
+ */
+export class BindingInContract {
+    constructor(binding) {
+        this.binding = binding;
+    }
+    /**
+     * Make this binding a singleton.
+     *
+     * @example
+     * ```ts
+     * container.bind<IDatabase>(IDatabase).to(SQLiteDatabase).inSingletonScope();
+     * ```
+     */
+    inSingletonScope() {
+        this.binding.scope = 'Singleton';
+        return this;
+    }
+}
+//# sourceMappingURL=binding-in-contract.js.map

package/lib/runtime/binding-in-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-in-contract.js","sourceRoot":"","sources":["../../src/runtime/binding-in-contract.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IAG5B,YAAY,OAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;OAOG;IACH,gBAAgB;QACd,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/runtime/binding-to-contract-impl.d.ts

@@ -0,0 +1,38 @@
+import type { Newable } from '@kurdel/common';
+import type { BindingToContract, BindingWithInContract } from '../api/container.js';
+import type { Binding } from '../runtime/binding.js';
+/**
+ * Contract returned by `IoCContainer.bind`.
+ *
+ * Provides methods to bind an abstract identifier (interface, symbol, etc.)
+ * to a concrete implementation or to an existing instance.
+ */
+export declare class BindingToContractImpl<T> implements BindingToContract<T> {
+    private binding;
+    constructor(binding: Binding<T>);
+    /**
+     * Bind the identifier to a class constructor.
+     *
+     * @example
+     * ```ts
+     * container.bind(IDatabase).to(SQLiteDatabase);
+     * ```
+     *
+     * @param constructor The class to instantiate when resolving this identifier.
+     * @returns {BindingWithInContract<T>} Allows chaining `.inSingletonScope()`.
+     */
+    to(constructor: Newable<T>): BindingWithInContract<T>;
+    /**
+     * Bind the identifier to an existing instance.
+     * Marks this binding as a singleton.
+     *
+     * @example
+     * ```ts
+     * const db = new SQLiteDatabase();
+     * container.bind(IDatabase).toInstance(db);
+     * ```
+     *
+     * @param instance The instance to use when resolving this identifier.
+     */
+    toInstance(instance: T): void;
+}

package/lib/runtime/binding-to-contract-impl.js

@@ -0,0 +1,46 @@
+import { BindingWithInContractImpl } from '../runtime/binding-with-in-contract-impl.js';
+/**
+ * Contract returned by `IoCContainer.bind`.
+ *
+ * Provides methods to bind an abstract identifier (interface, symbol, etc.)
+ * to a concrete implementation or to an existing instance.
+ */
+export class BindingToContractImpl {
+    constructor(binding) {
+        this.binding = binding;
+    }
+    /**
+     * Bind the identifier to a class constructor.
+     *
+     * @example
+     * ```ts
+     * container.bind(IDatabase).to(SQLiteDatabase);
+     * ```
+     *
+     * @param constructor The class to instantiate when resolving this identifier.
+     * @returns {BindingWithInContract<T>} Allows chaining `.inSingletonScope()`.
+     */
+    to(constructor) {
+        this.binding.boundEntity = constructor;
+        return new BindingWithInContractImpl(this.binding);
+    }
+    /**
+     * Bind the identifier to an existing instance.
+     * Marks this binding as a singleton.
+     *
+     * @example
+     * ```ts
+     * const db = new SQLiteDatabase();
+     * container.bind(IDatabase).toInstance(db);
+     * ```
+     *
+     * @param instance The instance to use when resolving this identifier.
+     */
+    toInstance(instance) {
+        this.binding.boundEntity = instance;
+        this.binding.cache = instance;
+        this.binding.scope = 'Singleton';
+        this.binding.activated = true;
+    }
+}
+//# sourceMappingURL=binding-to-contract-impl.js.map

package/lib/runtime/binding-to-contract-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-to-contract-impl.js","sourceRoot":"","sources":["../../src/runtime/binding-to-contract-impl.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,yBAAyB,EAAE,MAAM,8CAA8C,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,OAAO,qBAAqB;IAGhC,YAAY,OAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;;OAUG;IACH,EAAE,CAAC,WAAuB;QACxB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,WAAW,CAAC;QACvC,OAAO,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrD,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,QAAW;QACpB,IAAI,CAAC,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAC;QACpC,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,KAAK,GAAG,WAAW,CAAC;QACjC,IAAI,CAAC,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAChC,CAAC;CACF"}

package/lib/runtime/binding-with-contract.d.ts

@@ -0,0 +1,33 @@
+import type { Identifier } from '../api/identifier.js';
+import type { Binding } from '../runtime/binding.js';
+/**
+ * Fluent contract returned from IoCContainer.put() when configuring dependencies.
+ *
+ * Allows you to declare dependencies as a key-to-identifier map.
+ *
+ * @example
+ * ```ts
+ * ioc.put(UserController).with({
+ *   userService: UserService,
+ *   logger: Logger,
+ * });
+ * ```
+ */
+export declare class BindingWithContract<T> {
+    private binding;
+    constructor(binding: Binding<T>);
+    /**
+     * Declare dependencies for this binding as a map of identifiers.
+     * Each entry will be resolved from the container and injected into
+     * the constructor as an object.
+     *
+     * @example
+     * ```ts
+     * ioc.put(UserController).with({
+     *   userService: UserService,
+     *   logger: Logger,
+     * });
+     * ```
+     */
+    with(deps: Record<string, Identifier>): this;
+}

package/lib/runtime/binding-with-contract.js

@@ -0,0 +1,36 @@
+/**
+ * Fluent contract returned from IoCContainer.put() when configuring dependencies.
+ *
+ * Allows you to declare dependencies as a key-to-identifier map.
+ *
+ * @example
+ * ```ts
+ * ioc.put(UserController).with({
+ *   userService: UserService,
+ *   logger: Logger,
+ * });
+ * ```
+ */
+export class BindingWithContract {
+    constructor(binding) {
+        this.binding = binding;
+    }
+    /**
+     * Declare dependencies for this binding as a map of identifiers.
+     * Each entry will be resolved from the container and injected into
+     * the constructor as an object.
+     *
+     * @example
+     * ```ts
+     * ioc.put(UserController).with({
+     *   userService: UserService,
+     *   logger: Logger,
+     * });
+     * ```
+     */
+    with(deps) {
+        this.binding.depsMap = deps;
+        return this;
+    }
+}
+//# sourceMappingURL=binding-with-contract.js.map

package/lib/runtime/binding-with-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-with-contract.js","sourceRoot":"","sources":["../../src/runtime/binding-with-contract.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,mBAAmB;IAG9B,YAAY,OAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,IAAI,CAAC,IAAgC;QACnC,IAAI,CAAC,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/runtime/binding-with-in-contract-impl.d.ts

@@ -0,0 +1,34 @@
+import type { BindingWithInContract } from '../api/container.js';
+import type { Identifier } from '../api/identifier.js';
+import type { Binding } from '../runtime/binding.js';
+/**
+ * Fluent contract returned from IoCContainer.put().
+ *
+ * Allows you to configure additional options for the binding:
+ *
+ * - declare dependencies with .with({ key: Identifier })
+ * - control scope with .inSingletonScope()
+ *
+ * @example
+ * ```ts
+ * ioc.put(UserController)
+ *    .with({ userService: UserService, logger: Logger })
+ *    .inSingletonScope();
+ * ```
+ */
+export declare class BindingWithInContractImpl<T> implements BindingWithInContract<T> {
+    private bindingInContract;
+    private bindingWithContract;
+    constructor(binding: Binding<T>);
+    /**
+     * Make this binding a singleton — only one instance will be created
+     * and cached in the container.
+     */
+    inSingletonScope(): this;
+    /**
+     * Declare dependencies for this binding as a map of identifiers.
+     * Each entry will be resolved from the container and injected into
+     * the constructor as an object.
+     */
+    with(deps: Record<string, Identifier>): this;
+}

package/lib/runtime/binding-with-in-contract-impl.js

@@ -0,0 +1,41 @@
+import { BindingWithContract } from '../runtime/binding-with-contract.js';
+import { BindingInContract } from '../runtime/binding-in-contract.js';
+/**
+ * Fluent contract returned from IoCContainer.put().
+ *
+ * Allows you to configure additional options for the binding:
+ *
+ * - declare dependencies with .with({ key: Identifier })
+ * - control scope with .inSingletonScope()
+ *
+ * @example
+ * ```ts
+ * ioc.put(UserController)
+ *    .with({ userService: UserService, logger: Logger })
+ *    .inSingletonScope();
+ * ```
+ */
+export class BindingWithInContractImpl {
+    constructor(binding) {
+        this.bindingInContract = new BindingInContract(binding);
+        this.bindingWithContract = new BindingWithContract(binding);
+    }
+    /**
+     * Make this binding a singleton — only one instance will be created
+     * and cached in the container.
+     */
+    inSingletonScope() {
+        this.bindingInContract.inSingletonScope();
+        return this;
+    }
+    /**
+     * Declare dependencies for this binding as a map of identifiers.
+     * Each entry will be resolved from the container and injected into
+     * the constructor as an object.
+     */
+    with(deps) {
+        this.bindingWithContract.with(deps);
+        return this;
+    }
+}
+//# sourceMappingURL=binding-with-in-contract-impl.js.map

package/lib/runtime/binding-with-in-contract-impl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-with-in-contract-impl.js","sourceRoot":"","sources":["../../src/runtime/binding-with-in-contract-impl.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,yBAAyB;IAIpC,YAAY,OAAmB;QAC7B,IAAI,CAAC,iBAAiB,GAAG,IAAI,iBAAiB,CAAI,OAAO,CAAC,CAAC;QAC3D,IAAI,CAAC,mBAAmB,GAAG,IAAI,mBAAmB,CAAI,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;OAGG;IACH,gBAAgB;QACd,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAgC;QACnC,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/lib/runtime/binding.d.ts

@@ -0,0 +1,22 @@
+import type { Newable } from '@kurdel/common';
+import type { Identifier } from '../api/identifier.js';
+import type { ScopeType } from '../api/types.js';
+/**
+ * Binding
+ *
+ * Stores information about how a dependency is resolved:
+ * - boundEntity → class or instance
+ * - depsMap → dependencies for constructor injection
+ * - toFactory → custom factory function
+ * - scope → lifecycle (Transient or Singleton)
+ * - cache → cached instance (for Singleton)
+ */
+export declare class Binding<T> {
+    boundEntity: Newable<T> | T | null;
+    depsMap?: Record<string, Identifier>;
+    toFactory?: () => T;
+    scope: ScopeType;
+    cache: T | null;
+    activated: boolean;
+    constructor();
+}

package/lib/runtime/binding.js

@@ -0,0 +1,21 @@
+/**
+ * Binding
+ *
+ * Stores information about how a dependency is resolved:
+ * - boundEntity → class or instance
+ * - depsMap → dependencies for constructor injection
+ * - toFactory → custom factory function
+ * - scope → lifecycle (Transient or Singleton)
+ * - cache → cached instance (for Singleton)
+ */
+export class Binding {
+    constructor() {
+        this.boundEntity = null;
+        this.scope = 'Transient';
+        this.cache = null;
+        this.activated = false;
+        this.depsMap = undefined;
+        this.toFactory = undefined;
+    }
+}
+//# sourceMappingURL=binding.js.map

package/lib/runtime/binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.js","sourceRoot":"","sources":["../../src/runtime/binding.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,OAAO,OAAO;IAQlB;QACE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF"}

package/lib/runtime/ioc-container.d.ts

@@ -0,0 +1,102 @@
+import type { Newable } from '@kurdel/common';
+import type { Identifier } from '../api/identifier.js';
+import type { Container, BindingToContract, BindingWithInContract } from '../api/container.js';
+interface DependencyNode {
+    key: string;
+    fromParent?: boolean;
+    deps: DependencyNode[];
+}
+/**
+ * Simple Inversion of Control (IoC) container.
+ *
+ * Supports two registration styles:
+ * - `bind` for interfaces or symbols → bind an identifier to implementation
+ * - `put` for concrete classes → register classes with dependencies
+ *
+ * Provides dependency resolution with support for constructor injection
+ * and singleton scope.
+ */
+export declare class IoCContainer implements Container {
+    private readonly dictionary;
+    private readonly parent?;
+    constructor(parent?: IoCContainer);
+    /**
+     * Creates a new **request-scoped** child container.
+     *
+     * The child delegates lookups to this container (its parent) when a binding
+     * is not found locally. Singleton bindings registered in the parent remain
+     * shared; bindings added to the child are isolated to the child’s lifetime.
+     *
+     * @returns A new `IoCContainer` whose parent is this container.
+     *
+     * @example
+     * const root = new IoCContainer();
+     * const scope = root.createScope(); // per-request container
+     * // scope.get(...) will fall back to root if not found locally
+     */
+    createScope(): IoCContainer;
+    /**
+     * Bind an identifier (interface or symbol) to an implementation.
+     *
+     * @example
+     * ```ts
+     * container.bind<IDatabase>(IDatabase).to(SQLiteDatabase);
+     * ```
+     */
+    bind<T>(key: Identifier<T>): BindingToContract<T>;
+    /**
+     * Register a concrete class in the container.
+     *
+     * @example
+     * ```ts
+     * container.put(UserService);
+     * container.put(UserController).with({ userService: UserService });
+     * ```
+     */
+    put<T>(constructor: Newable<T>): BindingWithInContract<T>;
+    /** @inheritdoc */
+    toFactory<T>(key: Identifier<T>, factory: () => T): void;
+    /** @inheritdoc */
+    set<T>(key: Identifier<T>, value: T): void;
+    /**
+     * Resolve an instance bound to the given identifier.
+     *
+     * Resolution rules:
+     * 1) If the binding is not present locally, delegate to the parent container.
+     * 2) If the binding has a `toFactory`, invoke it (respecting singleton scope).
+     * 3) If the binding has a concrete `boundEntity`, recursively resolve its deps
+     *    and instantiate it; cache singletons.
+     *
+     * @typeParam T - Resolved instance type.
+     * @param key - Identifier (token/class) to resolve.
+     * @returns The resolved instance of type `T`.
+     * @throws If no binding was found in this container hierarchy.
+     */
+    get<T>(key: Identifier<T>): T;
+    /**
+     * Check whether a binding exists for the given identifier **in this container**.
+     *
+     * Note: this implementation does not consult a parent container.
+     * If you use hierarchical scoping, prefer a version that also checks `parent.has(key)`
+     * to mirror `get()` fallback behavior.
+     *
+     * @param key - Identifier (token/class) to look up.
+     * @returns `true` if the identifier is bound in this container.
+     */
+    has(key: Identifier): boolean;
+    /**
+     * Build a dependency graph for debugging and visualization.
+     *
+     * Traverses constructor and factory bindings, following `depsMap`
+     * recursively across parent containers.
+     *
+     * @param rootKey - Optional starting identifier (defaults to all local bindings).
+     * @returns Dependency tree(s) describing how bindings reference each other.
+     */
+    getGraph(rootKey?: Identifier): DependencyNode[];
+    /** @inheritdoc */
+    printGraph(rootKey?: Identifier): void;
+    /** Returns a human-readable label for an identifier (for diagnostics). */
+    private keyLabel;
+}
+export {};

package/lib/runtime/ioc-container.js

@@ -0,0 +1,218 @@
+import { Binding } from '../runtime/binding.js';
+import { BindingToContractImpl } from '../runtime/binding-to-contract-impl.js';
+import { BindingWithInContractImpl } from '../runtime/binding-with-in-contract-impl.js';
+/**
+ * Simple Inversion of Control (IoC) container.
+ *
+ * Supports two registration styles:
+ * - `bind` for interfaces or symbols → bind an identifier to implementation
+ * - `put` for concrete classes → register classes with dependencies
+ *
+ * Provides dependency resolution with support for constructor injection
+ * and singleton scope.
+ */
+export class IoCContainer {
+    constructor(parent) {
+        this.dictionary = new Map();
+        this.parent = parent;
+    }
+    /**
+     * Creates a new **request-scoped** child container.
+     *
+     * The child delegates lookups to this container (its parent) when a binding
+     * is not found locally. Singleton bindings registered in the parent remain
+     * shared; bindings added to the child are isolated to the child’s lifetime.
+     *
+     * @returns A new `IoCContainer` whose parent is this container.
+     *
+     * @example
+     * const root = new IoCContainer();
+     * const scope = root.createScope(); // per-request container
+     * // scope.get(...) will fall back to root if not found locally
+     */
+    createScope() {
+        return new IoCContainer(this);
+    }
+    /**
+     * Bind an identifier (interface or symbol) to an implementation.
+     *
+     * @example
+     * ```ts
+     * container.bind<IDatabase>(IDatabase).to(SQLiteDatabase);
+     * ```
+     */
+    bind(key) {
+        const binding = new Binding();
+        if (this.dictionary.has(key)) {
+            throw new Error(`Dependency ${key.toString()} already registered.`);
+        }
+        this.dictionary.set(key, binding);
+        return new BindingToContractImpl(binding);
+    }
+    /**
+     * Register a concrete class in the container.
+     *
+     * @example
+     * ```ts
+     * container.put(UserService);
+     * container.put(UserController).with({ userService: UserService });
+     * ```
+     */
+    put(constructor) {
+        if (this.dictionary.has(constructor)) {
+            throw new Error(`Dependency ${constructor.name.toString()} already registered.`);
+        }
+        const binding = new Binding();
+        binding.boundEntity = constructor;
+        this.dictionary.set(constructor, binding);
+        return new BindingWithInContractImpl(binding);
+    }
+    /** @inheritdoc */
+    toFactory(key, factory) {
+        const binding = new Binding();
+        binding.toFactory = factory;
+        this.dictionary.set(key, binding);
+    }
+    /** @inheritdoc */
+    set(key, value) {
+        if (this.dictionary.has(key)) {
+            throw new Error(`Dependency ${String(key)} already registered.`);
+        }
+        const b = new Binding();
+        b.boundEntity = value;
+        b.scope = 'Singleton';
+        b.activated = true;
+        b.cache = value;
+        this.dictionary.set(key, b);
+    }
+    /**
+     * Resolve an instance bound to the given identifier.
+     *
+     * Resolution rules:
+     * 1) If the binding is not present locally, delegate to the parent container.
+     * 2) If the binding has a `toFactory`, invoke it (respecting singleton scope).
+     * 3) If the binding has a concrete `boundEntity`, recursively resolve its deps
+     *    and instantiate it; cache singletons.
+     *
+     * @typeParam T - Resolved instance type.
+     * @param key - Identifier (token/class) to resolve.
+     * @returns The resolved instance of type `T`.
+     * @throws If no binding was found in this container hierarchy.
+     */
+    get(key) {
+        const local = this.dictionary.get(key);
+        if (!local) {
+            if (this.parent)
+                return this.parent.get(key);
+            throw new Error(`No dependency found for ${String(key)}`);
+        }
+        // factory binding
+        if (local.toFactory) {
+            if (local.scope === 'Singleton') {
+                if (!local.activated) {
+                    local.cache = local.toFactory();
+                    local.activated = true;
+                }
+                return local.cache;
+            }
+            return local.toFactory();
+        }
+        if (!local.boundEntity) {
+            throw new Error(`No dependency found for ${String(key)}`);
+        }
+        const { boundEntity, depsMap } = local;
+        // value binding
+        if (typeof boundEntity !== 'function') {
+            return boundEntity;
+        }
+        const Ctor = boundEntity;
+        const resolvedDeps = depsMap
+            ? Object.fromEntries(Object.entries(depsMap).map(([k, dep]) => [k, this.get(dep)]))
+            : {};
+        if (local.scope === 'Singleton') {
+            if (!local.activated) {
+                local.cache = new Ctor(resolvedDeps);
+                local.activated = true;
+            }
+            return local.cache;
+        }
+        return new Ctor(resolvedDeps);
+    }
+    /**
+     * Check whether a binding exists for the given identifier **in this container**.
+     *
+     * Note: this implementation does not consult a parent container.
+     * If you use hierarchical scoping, prefer a version that also checks `parent.has(key)`
+     * to mirror `get()` fallback behavior.
+     *
+     * @param key - Identifier (token/class) to look up.
+     * @returns `true` if the identifier is bound in this container.
+     */
+    has(key) {
+        return this.dictionary.has(key);
+    }
+    /**
+     * Build a dependency graph for debugging and visualization.
+     *
+     * Traverses constructor and factory bindings, following `depsMap`
+     * recursively across parent containers.
+     *
+     * @param rootKey - Optional starting identifier (defaults to all local bindings).
+     * @returns Dependency tree(s) describing how bindings reference each other.
+     */
+    getGraph(rootKey) {
+        const roots = rootKey ? [rootKey] : Array.from(this.dictionary.keys());
+        const walk = (key, path = new Set(), fromParent = false) => {
+            if (path.has(key)) {
+                return { key: this.keyLabel(key) + ' (circular)', deps: [] };
+            }
+            const binding = this.dictionary.get(key) ?? this.parent?.dictionary.get(key);
+            if (!binding) {
+                return { key: this.keyLabel(key) + ' (unbound)', deps: [] };
+            }
+            const isFromParent = fromParent || !this.dictionary.has(key);
+            const deps = binding.depsMap ? Object.values(binding.depsMap) : [];
+            const newPath = new Set(path);
+            newPath.add(key);
+            const depsNodes = deps.map(dep => walk(dep, newPath, isFromParent));
+            const labelParts = [this.keyLabel(key)];
+            if (isFromParent)
+                labelParts.push('[parent]');
+            if (binding.toFactory)
+                labelParts.push('[factory]');
+            if (binding.scope === 'Singleton')
+                labelParts.push('[singleton]');
+            if (binding.boundEntity && typeof binding.boundEntity !== 'function')
+                labelParts.push('[instance]');
+            return {
+                key: labelParts.join(' '),
+                fromParent: isFromParent,
+                deps: depsNodes,
+            };
+        };
+        return roots.map(k => walk(k));
+    }
+    /** @inheritdoc */
+    printGraph(rootKey) {
+        const graph = this.getGraph(rootKey);
+        const render = (node, prefix = '') => {
+            const line = `${prefix}- ${node.key}\n`;
+            const nextPrefix = prefix + '  ';
+            return line + node.deps.map(d => render(d, nextPrefix)).join('');
+        };
+        for (const root of graph) {
+            console.log(render(root));
+        }
+    }
+    /** Returns a human-readable label for an identifier (for diagnostics). */
+    keyLabel(key) {
+        if (typeof key === 'string')
+            return key;
+        if (typeof key === 'symbol')
+            return key.description ?? String(key);
+        if (typeof key === 'function')
+            return key.name || '[AnonymousClass]';
+        return String(key);
+    }
+}
+//# sourceMappingURL=ioc-container.js.map

package/lib/runtime/ioc-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ioc-container.js","sourceRoot":"","sources":["../../src/runtime/ioc-container.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@kurdel/ioc",
+  "version": "0.1.0-beta.1",
+  "description": "Dependency injection container for Kurdel",
+  "type": "module",
+  "exports": {
+    ".": "./lib/index.js"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "prepack": "npm run build",
+    "test": "vitest run",
+    "test:ui": "vitest",
+    "test:watch": "vitest --watch",
+    "coverage": "vitest run --coverage",
+    "clean": "rimraf lib ../../.cache/tsconfig.ioc.build.tsbuildinfo",
+    "build": "tsc -p tsconfig.build.json && tsc-alias -p tsconfig.build.json",
+    "build:force": "npm run clean && tsc -p tsconfig.build.json --force && tsc-alias -p tsconfig.build.json"
+  },
+  "keywords": [
+    "kurdel",
+    "dependency-injection",
+    "ioc",
+    "typescript"
+  ],
+  "author": "Andrii Sorokin",
+  "license": "MIT",
+  "engines": {
+    "node": "^20.19.0 || ^22.12.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ignorantic/kurdel.git",
+    "directory": "packages/ioc"
+  },
+  "homepage": "https://github.com/ignorantic/kurdel/tree/main/packages/ioc#readme",
+  "bugs": {
+    "url": "https://github.com/ignorantic/kurdel/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "tag": "beta"
+  },
+  "devDependencies": {
+    "@types/node": "^20.9.0",
+    "rimraf": "^6.0.1",
+    "tsc-alias": "^1.8.16"
+  },
+  "dependencies": {
+    "@kurdel/common": "0.1.0-beta.1"
+  }
+}