@illuma/core 0.2.0 → 1.1.0

package/dist/{token-BvQrvm-Q.d.cts → providers-D9YA8L_g.d.cts}

@@ -1,75 +1,3 @@
-/**
- * Represents a constructor function type.
- * @template T - The type that the constructor creates
- */
-type Ctor<T> = new (...args: any[]) => T;
-/**
- * Represents a token that can be either a NodeBase token or a constructor.
- * @template T - The type that the token represents
- */
-type Token<T> = NodeBase<T> | Ctor<T>;
-/**
- * Options for configuring a NodeToken or MultiNodeToken.
- * @template T - The type of value the token represents
- */
-interface iNodeTokenBaseOptions<T> {
-    /**
-     * Optional factory function to create instances of this token.
-     */
-    factory?: () => NoInfer<T>;
-}
-/**
- * Provider that supplies a static value for a token.
- * @template T - The type of value being provided
- */
-interface iNodeValueProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The static value to provide */
-    value: NoInfer<T>;
-}
-/**
- * Provider that uses a factory function to create instances.
- * @template T - The type of value being provided
- */
-interface iNodeFactoryProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** Factory function to create the value */
-    factory: () => NoInfer<T>;
-}
-/**
- * Provider that uses a class constructor to create instances.
- * @template T - The type of value being provided
- */
-interface iNodeClassProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The class to instantiate */
-    useClass: Ctor<T>;
-}
-/**
- * Provider that creates an alias to another token.
- * When this token is injected, the aliased token's value is returned instead.
- * @template T - The type of value being provided
- */
-interface iNodeAliasProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The token to alias to */
-    alias: Token<T>;
-}
-/**
- * Union type of all possible provider configurations.
- * @template T - The type of value being provided
- */
-type iNodeProvider<T> = iNodeValueProvider<T> | iNodeFactoryProvider<T> | iNodeClassProvider<T> | iNodeAliasProvider<T>;
-/**
- * Union type of all values that can be provided to a container.
- * @template T - The type of value being provided
- */
-type Provider<T = unknown> = NodeBase<T> | iNodeProvider<T> | Ctor<T> | Provider<unknown>[];
-
 /**
  * Base class for dependency injection tokens.
  * This class should not be instantiated directly. Use {@link NodeToken} or {@link MultiNodeToken} instead.
@@ -150,4 +78,76 @@ declare function isNodeBase<T>(specimen: unknown): specimen is NodeToken<T> | Mu
  */
 declare function extractToken<T>(provider: Token<T>, isAlias?: boolean): NodeToken<T> | MultiNodeToken<T>;
 
-export { type Ctor as C, MultiNodeToken as M, NodeToken as N, type Provider as P, type Token as T, NodeBase as a, type iNodeTokenBaseOptions as b, type iNodeValueProvider as c, type iNodeFactoryProvider as d, extractToken as e, type iNodeClassProvider as f, type iNodeAliasProvider as g, type iNodeProvider as h, isNodeBase as i };
+/**
+ * Represents a constructor function type.
+ * @template T - The type that the constructor creates
+ */
+type Ctor<T> = new (...args: any[]) => T;
+/**
+ * Represents a token that can be either a NodeBase token or a constructor.
+ * @template T - The type that the token represents
+ */
+type Token<T> = NodeBase<T> | Ctor<T>;
+/**
+ * Options for configuring a NodeToken or MultiNodeToken.
+ * @template T - The type of value the token represents
+ */
+interface iNodeTokenBaseOptions<T> {
+    /**
+     * Optional factory function to create instances of this token.
+     */
+    factory?: () => NoInfer<T>;
+}
+/**
+ * Provider that supplies a static value for a token.
+ * @template T - The type of value being provided
+ */
+interface iNodeValueProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The static value to provide */
+    value: NoInfer<T>;
+}
+/**
+ * Provider that uses a factory function to create instances.
+ * @template T - The type of value being provided
+ */
+interface iNodeFactoryProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** Factory function to create the value */
+    factory: () => NoInfer<T>;
+}
+/**
+ * Provider that uses a class constructor to create instances.
+ * @template T - The type of value being provided
+ */
+interface iNodeClassProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The class to instantiate */
+    useClass: Ctor<T>;
+}
+/**
+ * Provider that creates an alias to another token.
+ * When this token is injected, the aliased token's value is returned instead.
+ * @template T - The type of value being provided
+ */
+interface iNodeAliasProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The token to alias to */
+    alias: Token<T>;
+}
+/**
+ * Union type of all possible provider configurations.
+ * @template T - The type of value being provided
+ */
+type iNodeProvider<T> = iNodeValueProvider<T> | iNodeFactoryProvider<T> | iNodeClassProvider<T> | iNodeAliasProvider<T>;
+/**
+ * Union type of all values that can be provided to a container.
+ * @template T - The type of value being provided
+ */
+type Provider<T = unknown> = NodeBase<T> | iNodeProvider<T> | Ctor<T> | Provider<unknown>[];
+
+export { type Ctor as C, MultiNodeToken as M, NodeBase as N, type Provider as P, type Token as T, NodeToken as a, type iNodeTokenBaseOptions as b, type iNodeValueProvider as c, type iNodeFactoryProvider as d, extractToken as e, type iNodeClassProvider as f, type iNodeAliasProvider as g, type iNodeProvider as h, isNodeBase as i };

package/dist/{token-BvQrvm-Q.d.ts → providers-D9YA8L_g.d.ts}

@@ -1,75 +1,3 @@
-/**
- * Represents a constructor function type.
- * @template T - The type that the constructor creates
- */
-type Ctor<T> = new (...args: any[]) => T;
-/**
- * Represents a token that can be either a NodeBase token or a constructor.
- * @template T - The type that the token represents
- */
-type Token<T> = NodeBase<T> | Ctor<T>;
-/**
- * Options for configuring a NodeToken or MultiNodeToken.
- * @template T - The type of value the token represents
- */
-interface iNodeTokenBaseOptions<T> {
-    /**
-     * Optional factory function to create instances of this token.
-     */
-    factory?: () => NoInfer<T>;
-}
-/**
- * Provider that supplies a static value for a token.
- * @template T - The type of value being provided
- */
-interface iNodeValueProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The static value to provide */
-    value: NoInfer<T>;
-}
-/**
- * Provider that uses a factory function to create instances.
- * @template T - The type of value being provided
- */
-interface iNodeFactoryProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** Factory function to create the value */
-    factory: () => NoInfer<T>;
-}
-/**
- * Provider that uses a class constructor to create instances.
- * @template T - The type of value being provided
- */
-interface iNodeClassProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The class to instantiate */
-    useClass: Ctor<T>;
-}
-/**
- * Provider that creates an alias to another token.
- * When this token is injected, the aliased token's value is returned instead.
- * @template T - The type of value being provided
- */
-interface iNodeAliasProvider<T> {
-    /** The token this provider is for */
-    provide: Token<T>;
-    /** The token to alias to */
-    alias: Token<T>;
-}
-/**
- * Union type of all possible provider configurations.
- * @template T - The type of value being provided
- */
-type iNodeProvider<T> = iNodeValueProvider<T> | iNodeFactoryProvider<T> | iNodeClassProvider<T> | iNodeAliasProvider<T>;
-/**
- * Union type of all values that can be provided to a container.
- * @template T - The type of value being provided
- */
-type Provider<T = unknown> = NodeBase<T> | iNodeProvider<T> | Ctor<T> | Provider<unknown>[];
-
 /**
  * Base class for dependency injection tokens.
  * This class should not be instantiated directly. Use {@link NodeToken} or {@link MultiNodeToken} instead.
@@ -150,4 +78,76 @@ declare function isNodeBase<T>(specimen: unknown): specimen is NodeToken<T> | Mu
  */
 declare function extractToken<T>(provider: Token<T>, isAlias?: boolean): NodeToken<T> | MultiNodeToken<T>;
 
-export { type Ctor as C, MultiNodeToken as M, NodeToken as N, type Provider as P, type Token as T, NodeBase as a, type iNodeTokenBaseOptions as b, type iNodeValueProvider as c, type iNodeFactoryProvider as d, extractToken as e, type iNodeClassProvider as f, type iNodeAliasProvider as g, type iNodeProvider as h, isNodeBase as i };
+/**
+ * Represents a constructor function type.
+ * @template T - The type that the constructor creates
+ */
+type Ctor<T> = new (...args: any[]) => T;
+/**
+ * Represents a token that can be either a NodeBase token or a constructor.
+ * @template T - The type that the token represents
+ */
+type Token<T> = NodeBase<T> | Ctor<T>;
+/**
+ * Options for configuring a NodeToken or MultiNodeToken.
+ * @template T - The type of value the token represents
+ */
+interface iNodeTokenBaseOptions<T> {
+    /**
+     * Optional factory function to create instances of this token.
+     */
+    factory?: () => NoInfer<T>;
+}
+/**
+ * Provider that supplies a static value for a token.
+ * @template T - The type of value being provided
+ */
+interface iNodeValueProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The static value to provide */
+    value: NoInfer<T>;
+}
+/**
+ * Provider that uses a factory function to create instances.
+ * @template T - The type of value being provided
+ */
+interface iNodeFactoryProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** Factory function to create the value */
+    factory: () => NoInfer<T>;
+}
+/**
+ * Provider that uses a class constructor to create instances.
+ * @template T - The type of value being provided
+ */
+interface iNodeClassProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The class to instantiate */
+    useClass: Ctor<T>;
+}
+/**
+ * Provider that creates an alias to another token.
+ * When this token is injected, the aliased token's value is returned instead.
+ * @template T - The type of value being provided
+ */
+interface iNodeAliasProvider<T> {
+    /** The token this provider is for */
+    provide: Token<T>;
+    /** The token to alias to */
+    alias: Token<T>;
+}
+/**
+ * Union type of all possible provider configurations.
+ * @template T - The type of value being provided
+ */
+type iNodeProvider<T> = iNodeValueProvider<T> | iNodeFactoryProvider<T> | iNodeClassProvider<T> | iNodeAliasProvider<T>;
+/**
+ * Union type of all values that can be provided to a container.
+ * @template T - The type of value being provided
+ */
+type Provider<T = unknown> = NodeBase<T> | iNodeProvider<T> | Ctor<T> | Provider<unknown>[];
+
+export { type Ctor as C, MultiNodeToken as M, NodeBase as N, type Provider as P, type Token as T, NodeToken as a, type iNodeTokenBaseOptions as b, type iNodeValueProvider as c, type iNodeFactoryProvider as d, extractToken as e, type iNodeClassProvider as f, type iNodeAliasProvider as g, type iNodeProvider as h, isNodeBase as i };

package/dist/testkit.cjs

@@ -26,29 +26,6 @@ __export(testkit_exports, {
 module.exports = __toCommonJS(testkit_exports);
 
 // src/lib/errors.ts
-var ERR_CODES = {
-  // Provider errors
-  DUPLICATE_PROVIDER: 100,
-  DUPLICATE_FACTORY: 101,
-  INVALID_CTOR: 102,
-  INVALID_PROVIDER: 103,
-  // Alias errors
-  INVALID_ALIAS: 200,
-  LOOP_ALIAS: 201,
-  // Bootstrap errors
-  NOT_BOOTSTRAPPED: 300,
-  BOOTSTRAPPED: 301,
-  DOUBLE_BOOTSTRAP: 302,
-  // Retrieval errors
-  NOT_FOUND: 400,
-  CIRCULAR_DEPENDENCY: 401,
-  // Instantiation errors
-  UNTRACKED: 500,
-  OUTSIDE_CONTEXT: 501,
-  CALLED_UTILS_OUTSIDE_CONTEXT: 502,
-  INSTANCE_ACCESS_FAILED: 503,
-  ACCESS_FAILED: 504
-};
 var InjectionError = class _InjectionError extends Error {
   static {
     __name(this, "InjectionError");
@@ -60,64 +37,64 @@ var InjectionError = class _InjectionError extends Error {
   }
   // Provider errors
   static duplicate(token) {
-    return new _InjectionError(ERR_CODES.DUPLICATE_PROVIDER, `Duplicate provider for token "${token.toString()}" detected.`);
+    return new _InjectionError(100, `Duplicate provider for token "${token.toString()}" detected.`);
   }
   static duplicateFactory(token) {
-    return new _InjectionError(ERR_CODES.DUPLICATE_FACTORY, `Tried to re-provide factory for token "${token.toString()}" detected.`);
+    return new _InjectionError(101, `Tried to re-provide factory for token "${token.toString()}" detected.`);
   }
   static invalidCtor(ctor) {
-    return new _InjectionError(ERR_CODES.INVALID_CTOR, `Cannot use constructor for token "${ctor.name}". Please make sure to use @nodeInjectable() decorator`);
+    return new _InjectionError(102, `Cannot use constructor for token "${ctor.name}". Please make sure to use @nodeInjectable() decorator`);
   }
   static invalidProvider(provider) {
-    return new _InjectionError(ERR_CODES.INVALID_PROVIDER, `Cannot use provider as it is neither a NodeToken nor MultiNodeToken nor a valid constructor.:
+    return new _InjectionError(103, `Cannot use provider as it is neither a NodeToken nor MultiNodeToken nor a valid constructor.:
 ${provider}`);
   }
   // Alias errors
   static invalidAlias(alias) {
     const aliasStr = typeof alias === "function" ? alias.name || "Unknown" : String(alias);
-    return new _InjectionError(ERR_CODES.INVALID_ALIAS, `Invalid alias target "${aliasStr}". Alias must be a NodeToken, MultiNodeToken, or a class decorated with @NodeInjectable().`);
+    return new _InjectionError(200, `Invalid alias target "${aliasStr}". Alias must be a NodeToken, MultiNodeToken, or a class decorated with @NodeInjectable().`);
   }
   static loopAlias(alias) {
-    return new _InjectionError(ERR_CODES.LOOP_ALIAS, `Token "${alias.toString()}" cannot alias itself in a loop.`);
+    return new _InjectionError(201, `Token "${alias.toString()}" cannot alias itself in a loop.`);
   }
   // Bootstrap errors
   static notBootstrapped() {
-    return new _InjectionError(ERR_CODES.NOT_BOOTSTRAPPED, "Cannot retrieve providers before the container has been bootstrapped.");
+    return new _InjectionError(300, "Cannot retrieve providers before the container has been bootstrapped.");
   }
   static bootstrapped() {
-    return new _InjectionError(ERR_CODES.BOOTSTRAPPED, "Cannot modify providers after the container has been bootstrapped.");
+    return new _InjectionError(301, "Cannot modify providers after the container has been bootstrapped.");
   }
   static doubleBootstrap() {
-    return new _InjectionError(ERR_CODES.DOUBLE_BOOTSTRAP, "Container has already been bootstrapped and cannot be bootstrapped again.");
+    return new _InjectionError(302, "Container has already been bootstrapped and cannot be bootstrapped again.");
   }
   // Retrieval errors
   static notFound(token) {
-    return new _InjectionError(ERR_CODES.NOT_FOUND, `No provider found for "${token.toString()}".`);
+    return new _InjectionError(400, `No provider found for "${token.toString()}".`);
   }
   static circularDependency(provider, path) {
     const providerStr = provider instanceof NodeBase ? provider.toString() : provider.name;
     const pathStr = path.map((p) => p instanceof NodeBase ? p.toString() : p.name).join(" -> ");
-    return new _InjectionError(ERR_CODES.CIRCULAR_DEPENDENCY, `Circular dependency detected while resolving "${providerStr}":
+    return new _InjectionError(401, `Circular dependency detected while resolving "${providerStr}":
 ${pathStr}`);
   }
   // Instantiation errors
   static untracked(token, parent) {
     const tokenStr = token instanceof NodeBase ? token.toString() : token.name;
     const parentStr = parent instanceof NodeBase ? parent.toString() : parent.name;
-    return new _InjectionError(ERR_CODES.UNTRACKED, `Cannot instantiate ${parentStr} because it depends on untracked injection ${tokenStr}. Please make sure all injections are properly tracked.`);
+    return new _InjectionError(500, `Cannot instantiate ${parentStr} because it depends on untracked injection ${tokenStr}. Please make sure all injections are properly tracked.`);
   }
   static outsideContext(token) {
     const tokenStr = token instanceof NodeBase ? token.toString() : token.name;
-    return new _InjectionError(ERR_CODES.OUTSIDE_CONTEXT, `Cannot inject "${tokenStr}" outside of an injection context.`);
+    return new _InjectionError(501, `Cannot inject "${tokenStr}" outside of an injection context.`);
   }
   static calledUtilsOutsideContext() {
-    return new _InjectionError(ERR_CODES.CALLED_UTILS_OUTSIDE_CONTEXT, "Cannot call injection utilities outside of an injection context.");
+    return new _InjectionError(502, "Cannot call injection utilities outside of an injection context.");
   }
   static instanceAccessFailed(token) {
-    return new _InjectionError(ERR_CODES.INSTANCE_ACCESS_FAILED, `Failed to access instance for token "${token.toString()}". It was not properly instantiated.`);
+    return new _InjectionError(503, `Failed to access instance for token "${token.toString()}". It was not properly instantiated.`);
   }
   static accessFailed() {
-    return new _InjectionError(ERR_CODES.ACCESS_FAILED, "Failed to access the requested instance due to an unknown error.");
+    return new _InjectionError(504, "Failed to access the requested instance due to an unknown error.");
   }
 };
 
@@ -464,29 +441,23 @@ var TreeRootNode = class {
   static {
     __name(this, "TreeRootNode");
   }
-  instant;
   _deps = /* @__PURE__ */ new Set();
   _treePool = /* @__PURE__ */ new Map();
-  constructor(instant = true) {
-    this.instant = instant;
-  }
   get dependencies() {
     return this._deps;
   }
   addDependency(node) {
     this._deps.add(node);
   }
-  build() {
+  instantiate() {
     for (const dep of this._deps) {
+      dep.instantiate(this._treePool);
       if ("token" in dep.proto) this._treePool.set(dep.proto.token, dep);
-      if (this.instant) dep.instantiate(this._treePool);
-      else dep.collectPool(this._treePool);
     }
   }
   find(token) {
     const node = this._treePool.get(token);
     if (!node) return null;
-    if (!this.instant) node.instantiate(this._treePool);
     return node;
   }
   toString() {
@@ -517,11 +488,6 @@ var TreeNodeSingle = class {
     else this._deps.set(node.proto.token, node);
     node.allocations++;
   }
-  collectPool(pool) {
-    for (const node of this._deps.values()) node.collectPool(pool);
-    for (const dep of this._transparent) dep.collectPool(pool);
-    pool.set(this.proto.token, this);
-  }
   instantiate(pool) {
     if (this._resolved) return;
     for (const node of this._deps.values()) node.instantiate(pool);
@@ -559,10 +525,6 @@ var TreeNodeTransparent = class _TreeNodeTransparent {
     else this._deps.set(node.proto.token, node);
     node.allocations++;
   }
-  collectPool(pool) {
-    for (const node of this._deps.values()) node.collectPool(pool);
-    for (const dep of this._transparent) dep.collectPool(pool);
-  }
   instantiate(pool) {
     if (this._resolved) return;
     for (const dep of this._transparent) dep.instantiate(pool);
@@ -587,10 +549,6 @@ var TreeNodeMulti = class _TreeNodeMulti {
   constructor(proto) {
     this.proto = proto;
   }
-  collectPool(pool) {
-    for (const dep of this._deps) dep.collectPool(pool);
-    pool.set(this.proto.token, this);
-  }
   instantiate(pool) {
     if (this._resolved) return;
     for (const dep of this._deps) {
@@ -896,7 +854,7 @@ var NodeContainer = class extends Illuma {
     return parentNode.findNode(token);
   }
   _buildInjectionTree() {
-    const root = new TreeRootNode(this._opts?.instant);
+    const root = new TreeRootNode();
     const cache = /* @__PURE__ */ new Map();
     const nodes = [
       ...this._protoNodes.values(),
@@ -941,7 +899,7 @@ var NodeContainer = class extends Illuma {
       value: new InjectorImpl(this)
     });
     this._rootNode = this._buildInjectionTree();
-    this._rootNode.build();
+    this._rootNode.instantiate();
     this._bootstrapped = true;
     const end = performance.now();
     const duration = end - start;