@illuma/core 0.2.0 → 1.1.0

package/dist/index.d.cts

@@ -1,66 +1,7 @@
-import { C as Ctor, N as NodeToken, a as NodeBase, P as Provider, T as Token, M as MultiNodeToken } from './token-BvQrvm-Q.cjs';
-export { e as extractToken, g as iNodeAliasProvider, f as iNodeClassProvider, d as iNodeFactoryProvider, h as iNodeProvider, b as iNodeTokenBaseOptions, c as iNodeValueProvider, i as isNodeBase } from './token-BvQrvm-Q.cjs';
-import { i as iNodeInjectorOptions, E as ExtractInjectedType } from './injection-CJGqGWJ6.cjs';
-export { N as NodeInjectFn, n as nodeInject } from './injection-CJGqGWJ6.cjs';
-import { i as iInjectionNode, T as TreeNode, I as Illuma } from './plugin-container-n0FIqLbh.cjs';
-
-/**
- * Symbol used to mark classes as injectable and store their associated token.
- * @internal
- */
-declare const INJECTION_SYMBOL: unique symbol;
-/**
- * Decorator that marks a class as injectable in the dependency injection system.
- * Automatically creates and associates a NodeToken with the class.
- *
- * @template T - The type of the class being decorated
- * @returns A class decorator function
- *
- * @example
- * ```typescript
- * @NodeInjectable()
- * class UserService {
- *   public getUser() {
- *     return { id: 1, name: 'John' };
- *   }
- * }
- *
- * container.provide(UserService);
- * container.bootstrap();
- * const service = container.get(UserService);
- * ```
- */
-declare function NodeInjectable<T>(): (ctor: Ctor<T>) => Ctor<T>;
-/**
- * Alternative function to mark a class as injectable in the dependency injection system for environments
- * that do not support decorators.
- * @param ctor
- * @returns
- *
- * @example
- * ```typescript
- * import { makeInjectable } from '@illuma/core';
- *
- * class _UserService {
- *   public getUser() {
- *     return { id: 1, name: "John Doe" };
- *    }
- * }
- *
- * export type UserService = _UserService;
- * export const UserService = makeInjectable(_UserService);
- * ```
- */
-declare function makeInjectable<T>(ctor: Ctor<T>): Ctor<T>;
-/** @internal */
-declare function isInjectable<T>(ctor: unknown): ctor is Ctor<T> & {
-    [INJECTION_SYMBOL]: NodeToken<T>;
-};
-/** @internal */
-declare function getInjectableToken<T>(ctor: Ctor<T> & {
-    [INJECTION_SYMBOL]: NodeToken<T>;
-}): NodeToken<T>;
-declare function isConstructor(fn: unknown): fn is Ctor<any>;
+import { N as NodeBase, P as Provider, T as Token, M as MultiNodeToken, a as NodeToken, C as Ctor } from './providers-D9YA8L_g.cjs';
+export { e as extractToken, g as iNodeAliasProvider, f as iNodeClassProvider, d as iNodeFactoryProvider, h as iNodeProvider, b as iNodeTokenBaseOptions, c as iNodeValueProvider, i as isNodeBase } from './providers-D9YA8L_g.cjs';
+export { E as ExtractInjectedType, N as NodeInjectFn, i as iNodeInjectorOptions, n as nodeInject } from './injection-CSxu56ds.cjs';
+import { i as iInjectionNode, T as TreeNode, I as Illuma } from './plugin-container-D8Zwpigq.cjs';
 
 /** @internal */
 type InjectorFn = (token: NodeBase<any>, optional?: boolean) => any;
@@ -103,37 +44,6 @@ declare abstract class InjectionContext {
     static closeAndReport(): Set<iInjectionNode<any>>;
 }
 
-/**
- * Configuration options for the NodeContainer.
- */
-interface iContainerOptions {
-    /**
-     * When true, logs the bootstrap time to the console based on performance.now()
-     * difference before and after bootstrap.
-     * @default false
-     */
-    measurePerformance?: boolean;
-    /**
-     * When true, enables diagnostics reporting after bootstrap.
-     * @default false
-     */
-    diagnostics?: boolean;
-    /**
-     * @internal
-     * The parent container for hierarchical dependency resolution.
-     */
-    parent?: iDIContainer;
-    /**
-     * @experimental
-     * Whether to instantiate dependencies immediately.
-     * If disabled, providers instantiation will happen when first requested.
-     * This helps improve startup performance for large containers.
-     * Enabled by default until stable.
-     *
-     * @default true
-     */
-    instant?: boolean;
-}
 /**
  * Interface for dependency injection containers.
  * Defines the core methods that all DI containers must implement.
@@ -164,6 +74,77 @@ interface iDIContainer {
     produce<T>(fn: Ctor<T> | (() => T)): T;
 }
 
+/**
+ * Symbol used to mark classes as injectable and store their associated token.
+ * @internal
+ */
+declare const INJECTION_SYMBOL: unique symbol;
+/**
+ * Decorator that marks a class as injectable in the dependency injection system.
+ * Automatically creates and associates a NodeToken with the class.
+ *
+ * @template T - The type of the class being decorated
+ * @returns A class decorator function
+ *
+ * @example
+ * ```typescript
+ * @NodeInjectable()
+ * class UserService {
+ *   public getUser() {
+ *     return { id: 1, name: 'John' };
+ *   }
+ * }
+ *
+ * container.provide(UserService);
+ * container.bootstrap();
+ * const service = container.get(UserService);
+ * ```
+ */
+declare function NodeInjectable<T>(): (ctor: Ctor<T>) => Ctor<T>;
+/**
+ * Alternative function to mark a class as injectable in the dependency injection system for environments
+ * that do not support decorators.
+ * @param ctor
+ * @returns
+ *
+ * @example
+ * ```typescript
+ * import { makeInjectable } from '@illuma/core';
+ *
+ * class _UserService {
+ *   public getUser() {
+ *     return { id: 1, name: "John Doe" };
+ *    }
+ * }
+ *
+ * export type UserService = _UserService;
+ * export const UserService = makeInjectable(_UserService);
+ * ```
+ */
+declare function makeInjectable<T>(ctor: Ctor<T>): Ctor<T>;
+/** @internal */
+declare function isInjectable<T>(ctor: unknown): ctor is Ctor<T> & {
+    [INJECTION_SYMBOL]: NodeToken<T>;
+};
+/** @internal */
+declare function getInjectableToken<T>(ctor: Ctor<T> & {
+    [INJECTION_SYMBOL]: NodeToken<T>;
+}): NodeToken<T>;
+declare function isConstructor(fn: unknown): fn is Ctor<any>;
+
+/**
+ * Configuration options for the NodeContainer.
+ */
+interface iContainerOptions {
+    /**
+     * When true, logs the bootstrap time to the console based on performance.now()
+     * difference before and after bootstrap.
+     * @default false
+     */
+    measurePerformance?: boolean;
+    diagnostics?: boolean;
+    parent?: iDIContainer;
+}
 declare class NodeContainer extends Illuma implements iDIContainer {
     private readonly _opts?;
     private _bootstrapped;
@@ -257,24 +238,6 @@ declare class NodeContainer extends Illuma implements iDIContainer {
     produce<T>(fn: Ctor<T> | (() => T)): T;
 }
 
-declare const ERR_CODES: {
-    readonly DUPLICATE_PROVIDER: 100;
-    readonly DUPLICATE_FACTORY: 101;
-    readonly INVALID_CTOR: 102;
-    readonly INVALID_PROVIDER: 103;
-    readonly INVALID_ALIAS: 200;
-    readonly LOOP_ALIAS: 201;
-    readonly NOT_BOOTSTRAPPED: 300;
-    readonly BOOTSTRAPPED: 301;
-    readonly DOUBLE_BOOTSTRAP: 302;
-    readonly NOT_FOUND: 400;
-    readonly CIRCULAR_DEPENDENCY: 401;
-    readonly UNTRACKED: 500;
-    readonly OUTSIDE_CONTEXT: 501;
-    readonly CALLED_UTILS_OUTSIDE_CONTEXT: 502;
-    readonly INSTANCE_ACCESS_FAILED: 503;
-    readonly ACCESS_FAILED: 504;
-};
 declare class InjectionError extends Error {
     readonly code: number;
     constructor(code: number, message: string);
@@ -296,12 +259,6 @@ declare class InjectionError extends Error {
     static accessFailed(): InjectionError;
 }
 
-declare function injectDefer<N>(token: N, options: iNodeInjectorOptions & {
-    optional: true;
-}): () => N extends MultiNodeToken<infer V> ? V[] : N extends NodeToken<infer U> ? U | null : N extends new (...args: any[]) => infer T ? T | null : never;
-declare function injectDefer<N>(token: N, options?: iNodeInjectorOptions): () => N extends MultiNodeToken<infer V> ? V[] : N extends NodeToken<infer U> ? U : N extends new (...args: any) => infer T ? T : never;
-declare function injectDefer<N extends NodeToken<unknown> | MultiNodeToken<unknown>>(token: N, options?: iNodeInjectorOptions): () => ExtractInjectedType<N>;
-
 interface iInjector {
     /** The DI container associated with this injector */
     readonly container: iDIContainer;
@@ -343,7 +300,6 @@ declare class InjectorImpl implements iInjector {
  * @example
  * ```typescript
  * import { Injector, nodeInject, NodeInjectable, NodeContainer } from "@illuma/core";
-import { iDIContainer } from '../container/types';
  *
  * @NodeInjectable()
  * class MyService {
@@ -419,4 +375,4 @@ declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<Nod
 declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<Ctor<T>>>, opts?: iInjectionOptions): () => Promise<T>;
 declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<MultiNodeToken<T>>>, opts?: iInjectionOptions): () => Promise<T>;
 
-export { Ctor, ExtractInjectedType, ERR_CODES as ILLUMA_ERR_CODES, INJECTION_SYMBOL, InjectionContext, InjectionError, Injector, type InjectorFn, InjectorImpl, MultiNodeToken, NodeBase, NodeContainer, NodeInjectable, NodeToken, Provider, Token, getInjectableToken, type iEntrypointConfig, iInjectionNode, type iInjector, iNodeInjectorOptions, injectAsync, injectDefer, injectEntryAsync, injectGroupAsync, isConstructor, isInjectable, makeInjectable };
+export { Ctor, INJECTION_SYMBOL, InjectionContext, InjectionError, Injector, type InjectorFn, InjectorImpl, MultiNodeToken, NodeBase, NodeContainer, NodeInjectable, NodeToken, Provider, Token, getInjectableToken, type iDIContainer, type iEntrypointConfig, iInjectionNode, type iInjector, injectAsync, injectEntryAsync, injectGroupAsync, isConstructor, isInjectable, makeInjectable };

package/dist/index.d.ts

@@ -1,66 +1,7 @@
-import { C as Ctor, N as NodeToken, a as NodeBase, P as Provider, T as Token, M as MultiNodeToken } from './token-BvQrvm-Q.js';
-export { e as extractToken, g as iNodeAliasProvider, f as iNodeClassProvider, d as iNodeFactoryProvider, h as iNodeProvider, b as iNodeTokenBaseOptions, c as iNodeValueProvider, i as isNodeBase } from './token-BvQrvm-Q.js';
-import { i as iNodeInjectorOptions, E as ExtractInjectedType } from './injection-D22uAh1O.js';
-export { N as NodeInjectFn, n as nodeInject } from './injection-D22uAh1O.js';
-import { i as iInjectionNode, T as TreeNode, I as Illuma } from './plugin-container-CUw26ZhP.js';
-
-/**
- * Symbol used to mark classes as injectable and store their associated token.
- * @internal
- */
-declare const INJECTION_SYMBOL: unique symbol;
-/**
- * Decorator that marks a class as injectable in the dependency injection system.
- * Automatically creates and associates a NodeToken with the class.
- *
- * @template T - The type of the class being decorated
- * @returns A class decorator function
- *
- * @example
- * ```typescript
- * @NodeInjectable()
- * class UserService {
- *   public getUser() {
- *     return { id: 1, name: 'John' };
- *   }
- * }
- *
- * container.provide(UserService);
- * container.bootstrap();
- * const service = container.get(UserService);
- * ```
- */
-declare function NodeInjectable<T>(): (ctor: Ctor<T>) => Ctor<T>;
-/**
- * Alternative function to mark a class as injectable in the dependency injection system for environments
- * that do not support decorators.
- * @param ctor
- * @returns
- *
- * @example
- * ```typescript
- * import { makeInjectable } from '@illuma/core';
- *
- * class _UserService {
- *   public getUser() {
- *     return { id: 1, name: "John Doe" };
- *    }
- * }
- *
- * export type UserService = _UserService;
- * export const UserService = makeInjectable(_UserService);
- * ```
- */
-declare function makeInjectable<T>(ctor: Ctor<T>): Ctor<T>;
-/** @internal */
-declare function isInjectable<T>(ctor: unknown): ctor is Ctor<T> & {
-    [INJECTION_SYMBOL]: NodeToken<T>;
-};
-/** @internal */
-declare function getInjectableToken<T>(ctor: Ctor<T> & {
-    [INJECTION_SYMBOL]: NodeToken<T>;
-}): NodeToken<T>;
-declare function isConstructor(fn: unknown): fn is Ctor<any>;
+import { N as NodeBase, P as Provider, T as Token, M as MultiNodeToken, a as NodeToken, C as Ctor } from './providers-D9YA8L_g.js';
+export { e as extractToken, g as iNodeAliasProvider, f as iNodeClassProvider, d as iNodeFactoryProvider, h as iNodeProvider, b as iNodeTokenBaseOptions, c as iNodeValueProvider, i as isNodeBase } from './providers-D9YA8L_g.js';
+export { E as ExtractInjectedType, N as NodeInjectFn, i as iNodeInjectorOptions, n as nodeInject } from './injection-Y_bVmBSk.js';
+import { i as iInjectionNode, T as TreeNode, I as Illuma } from './plugin-container-CwkVlVS4.js';
 
 /** @internal */
 type InjectorFn = (token: NodeBase<any>, optional?: boolean) => any;
@@ -103,37 +44,6 @@ declare abstract class InjectionContext {
     static closeAndReport(): Set<iInjectionNode<any>>;
 }
 
-/**
- * Configuration options for the NodeContainer.
- */
-interface iContainerOptions {
-    /**
-     * When true, logs the bootstrap time to the console based on performance.now()
-     * difference before and after bootstrap.
-     * @default false
-     */
-    measurePerformance?: boolean;
-    /**
-     * When true, enables diagnostics reporting after bootstrap.
-     * @default false
-     */
-    diagnostics?: boolean;
-    /**
-     * @internal
-     * The parent container for hierarchical dependency resolution.
-     */
-    parent?: iDIContainer;
-    /**
-     * @experimental
-     * Whether to instantiate dependencies immediately.
-     * If disabled, providers instantiation will happen when first requested.
-     * This helps improve startup performance for large containers.
-     * Enabled by default until stable.
-     *
-     * @default true
-     */
-    instant?: boolean;
-}
 /**
  * Interface for dependency injection containers.
  * Defines the core methods that all DI containers must implement.
@@ -164,6 +74,77 @@ interface iDIContainer {
     produce<T>(fn: Ctor<T> | (() => T)): T;
 }
 
+/**
+ * Symbol used to mark classes as injectable and store their associated token.
+ * @internal
+ */
+declare const INJECTION_SYMBOL: unique symbol;
+/**
+ * Decorator that marks a class as injectable in the dependency injection system.
+ * Automatically creates and associates a NodeToken with the class.
+ *
+ * @template T - The type of the class being decorated
+ * @returns A class decorator function
+ *
+ * @example
+ * ```typescript
+ * @NodeInjectable()
+ * class UserService {
+ *   public getUser() {
+ *     return { id: 1, name: 'John' };
+ *   }
+ * }
+ *
+ * container.provide(UserService);
+ * container.bootstrap();
+ * const service = container.get(UserService);
+ * ```
+ */
+declare function NodeInjectable<T>(): (ctor: Ctor<T>) => Ctor<T>;
+/**
+ * Alternative function to mark a class as injectable in the dependency injection system for environments
+ * that do not support decorators.
+ * @param ctor
+ * @returns
+ *
+ * @example
+ * ```typescript
+ * import { makeInjectable } from '@illuma/core';
+ *
+ * class _UserService {
+ *   public getUser() {
+ *     return { id: 1, name: "John Doe" };
+ *    }
+ * }
+ *
+ * export type UserService = _UserService;
+ * export const UserService = makeInjectable(_UserService);
+ * ```
+ */
+declare function makeInjectable<T>(ctor: Ctor<T>): Ctor<T>;
+/** @internal */
+declare function isInjectable<T>(ctor: unknown): ctor is Ctor<T> & {
+    [INJECTION_SYMBOL]: NodeToken<T>;
+};
+/** @internal */
+declare function getInjectableToken<T>(ctor: Ctor<T> & {
+    [INJECTION_SYMBOL]: NodeToken<T>;
+}): NodeToken<T>;
+declare function isConstructor(fn: unknown): fn is Ctor<any>;
+
+/**
+ * Configuration options for the NodeContainer.
+ */
+interface iContainerOptions {
+    /**
+     * When true, logs the bootstrap time to the console based on performance.now()
+     * difference before and after bootstrap.
+     * @default false
+     */
+    measurePerformance?: boolean;
+    diagnostics?: boolean;
+    parent?: iDIContainer;
+}
 declare class NodeContainer extends Illuma implements iDIContainer {
     private readonly _opts?;
     private _bootstrapped;
@@ -257,24 +238,6 @@ declare class NodeContainer extends Illuma implements iDIContainer {
     produce<T>(fn: Ctor<T> | (() => T)): T;
 }
 
-declare const ERR_CODES: {
-    readonly DUPLICATE_PROVIDER: 100;
-    readonly DUPLICATE_FACTORY: 101;
-    readonly INVALID_CTOR: 102;
-    readonly INVALID_PROVIDER: 103;
-    readonly INVALID_ALIAS: 200;
-    readonly LOOP_ALIAS: 201;
-    readonly NOT_BOOTSTRAPPED: 300;
-    readonly BOOTSTRAPPED: 301;
-    readonly DOUBLE_BOOTSTRAP: 302;
-    readonly NOT_FOUND: 400;
-    readonly CIRCULAR_DEPENDENCY: 401;
-    readonly UNTRACKED: 500;
-    readonly OUTSIDE_CONTEXT: 501;
-    readonly CALLED_UTILS_OUTSIDE_CONTEXT: 502;
-    readonly INSTANCE_ACCESS_FAILED: 503;
-    readonly ACCESS_FAILED: 504;
-};
 declare class InjectionError extends Error {
     readonly code: number;
     constructor(code: number, message: string);
@@ -296,12 +259,6 @@ declare class InjectionError extends Error {
     static accessFailed(): InjectionError;
 }
 
-declare function injectDefer<N>(token: N, options: iNodeInjectorOptions & {
-    optional: true;
-}): () => N extends MultiNodeToken<infer V> ? V[] : N extends NodeToken<infer U> ? U | null : N extends new (...args: any[]) => infer T ? T | null : never;
-declare function injectDefer<N>(token: N, options?: iNodeInjectorOptions): () => N extends MultiNodeToken<infer V> ? V[] : N extends NodeToken<infer U> ? U : N extends new (...args: any) => infer T ? T : never;
-declare function injectDefer<N extends NodeToken<unknown> | MultiNodeToken<unknown>>(token: N, options?: iNodeInjectorOptions): () => ExtractInjectedType<N>;
-
 interface iInjector {
     /** The DI container associated with this injector */
     readonly container: iDIContainer;
@@ -343,7 +300,6 @@ declare class InjectorImpl implements iInjector {
  * @example
  * ```typescript
  * import { Injector, nodeInject, NodeInjectable, NodeContainer } from "@illuma/core";
-import { iDIContainer } from '../container/types';
  *
  * @NodeInjectable()
  * class MyService {
@@ -419,4 +375,4 @@ declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<Nod
 declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<Ctor<T>>>, opts?: iInjectionOptions): () => Promise<T>;
 declare function injectEntryAsync<T>(fn: MaybeAsyncFactory<iEntrypointConfig<MultiNodeToken<T>>>, opts?: iInjectionOptions): () => Promise<T>;
 
-export { Ctor, ExtractInjectedType, ERR_CODES as ILLUMA_ERR_CODES, INJECTION_SYMBOL, InjectionContext, InjectionError, Injector, type InjectorFn, InjectorImpl, MultiNodeToken, NodeBase, NodeContainer, NodeInjectable, NodeToken, Provider, Token, getInjectableToken, type iEntrypointConfig, iInjectionNode, type iInjector, iNodeInjectorOptions, injectAsync, injectDefer, injectEntryAsync, injectGroupAsync, isConstructor, isInjectable, makeInjectable };
+export { Ctor, INJECTION_SYMBOL, InjectionContext, InjectionError, Injector, type InjectorFn, InjectorImpl, MultiNodeToken, NodeBase, NodeContainer, NodeInjectable, NodeToken, Provider, Token, getInjectableToken, type iDIContainer, type iEntrypointConfig, iInjectionNode, type iInjector, injectAsync, injectEntryAsync, injectGroupAsync, isConstructor, isInjectable, makeInjectable };