@codefast/di 0.3.15 → 0.3.16-canary.0

package/dist/environment.d.mts

@@ -4,8 +4,17 @@ import { BindingIdentifier, BindingKind, BindingScope, ConstraintContext, Materi
 import { Container } from "./container.mjs";
 
 //#region src/environment.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function runWithContainer<Result>(container: Container, fn: () => Result): Result;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function getActiveContainer(): Container | undefined;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ResolverCallbacks {
   resolveFromContext<const Value>(token: Token<Value> | Constructor<Value>, path: string[], stack: MaterializationFrame[]): Value;
   resolve<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Value;
@@ -16,6 +25,9 @@ interface ResolverCallbacks {
   resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Value[];
   resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Promise<Value[]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class DefaultResolutionContext implements ResolutionContext {
   private _resolver;
   private _resolutionPath;
@@ -32,6 +44,9 @@ declare class DefaultResolutionContext implements ResolutionContext {
   resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value[];
   resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value[]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function buildMaterializationFrame(tokenName: string, scope: BindingScope, bindingId: BindingIdentifier, kind: BindingKind, slot: {
   name: string | undefined;
   tags: ReadonlyArray<readonly [string, unknown]>;

package/dist/environment.mjs

@@ -1,5 +1,8 @@
 //#region src/environment.ts
 let _activeContainer;
+/**
+* @since 0.3.16-canary.0
+*/
 function runWithContainer(container, fn) {
 	const prev = _activeContainer;
 	_activeContainer = container;
@@ -9,9 +12,15 @@ function runWithContainer(container, fn) {
 		_activeContainer = prev;
 	}
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function getActiveContainer() {
 	return _activeContainer;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 var DefaultResolutionContext = class {
 	_resolver;
 	_resolutionPath;
@@ -73,6 +82,9 @@ var DefaultConstraintContext = class {
 		return this._ancestors;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 function buildMaterializationFrame(tokenName, scope, bindingId, kind, slot) {
 	return {
 		tokenName,

package/dist/errors.d.mts

@@ -1,19 +1,31 @@
 import { BindingIdentifier, BindingScope, ResolveOptions } from "./types.mjs";
 
 //#region src/errors.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare abstract class DiError extends Error {
   abstract readonly code: string;
   constructor(message: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class InternalError extends DiError {
   readonly code = "INTERNAL_ERROR";
   constructor(message: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class TokenNotBoundError extends DiError {
   readonly code = "TOKEN_NOT_BOUND";
   readonly tokenName: string;
   constructor(tokenName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class NoMatchingBindingError extends DiError {
   readonly code = "NO_MATCHING_BINDING";
   readonly tokenName: string;
@@ -21,28 +33,43 @@ declare class NoMatchingBindingError extends DiError {
   readonly availableSlots: string[];
   constructor(tokenName: string, hint: ResolveOptions, availableSlots: string[]);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class AmbiguousBindingError extends DiError {
   readonly code = "AMBIGUOUS_BINDING";
   readonly tokenName: string;
   readonly candidateIds: readonly BindingIdentifier[];
   constructor(tokenName: string, candidateIds: readonly BindingIdentifier[]);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class CircularDependencyError extends DiError {
   readonly code = "CIRCULAR_DEPENDENCY";
   readonly cycle: string[];
   constructor(cycle: string[]);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class AsyncResolutionError extends DiError {
   readonly code = "ASYNC_RESOLUTION";
   readonly tokenName: string;
   readonly asyncSourceToken: string;
   constructor(tokenName: string, asyncSourceToken: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class AsyncDeactivationError extends DiError {
   readonly code = "ASYNC_DEACTIVATION";
   readonly tokenName: string;
   constructor(tokenName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ScopeViolationDetails {
   readonly consumerToken: string;
   readonly consumerScope: BindingScope;
@@ -50,40 +77,64 @@ interface ScopeViolationDetails {
   readonly dependencyScope: BindingScope;
   readonly path: string[];
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class ScopeViolationError extends DiError {
   readonly code = "SCOPE_VIOLATION";
   readonly details: ScopeViolationDetails;
   constructor(details: ScopeViolationDetails);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class MissingMetadataError extends DiError {
   readonly code = "MISSING_METADATA";
   readonly targetName: string;
   constructor(targetName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class AsyncModuleLoadError extends DiError {
   readonly code = "ASYNC_MODULE_LOAD";
   readonly moduleName: string;
   constructor(moduleName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class SyncDisposalNotSupportedError extends DiError {
   readonly code = "SYNC_DISPOSAL_NOT_SUPPORTED";
   constructor();
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class MissingScopeContextError extends DiError {
   readonly code = "MISSING_SCOPE_CONTEXT";
   readonly tokenName: string;
   constructor(tokenName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class MissingContainerContextError extends DiError {
   readonly code = "MISSING_CONTAINER_CONTEXT";
   readonly targetName: string;
   constructor(targetName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class RebindUnboundTokenError extends DiError {
   readonly code = "REBIND_UNBOUND_TOKEN";
   readonly tokenName: string;
   constructor(tokenName: string);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class DisposedContainerError extends DiError {
   readonly code = "DISPOSED_CONTAINER";
   constructor();

package/dist/errors.mjs

@@ -1,16 +1,25 @@
 //#region src/errors.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var DiError = class extends Error {
 	constructor(message) {
 		super(message);
 		this.name = this.constructor.name;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var InternalError = class extends DiError {
 	code = "INTERNAL_ERROR";
 	constructor(message) {
 		super(message);
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var TokenNotBoundError = class extends DiError {
 	code = "TOKEN_NOT_BOUND";
 	tokenName;
@@ -19,6 +28,9 @@ var TokenNotBoundError = class extends DiError {
 		this.tokenName = tokenName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var NoMatchingBindingError = class extends DiError {
 	code = "NO_MATCHING_BINDING";
 	tokenName;
@@ -33,6 +45,9 @@ var NoMatchingBindingError = class extends DiError {
 		this.availableSlots = availableSlots;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var AmbiguousBindingError = class extends DiError {
 	code = "AMBIGUOUS_BINDING";
 	tokenName;
@@ -43,6 +58,9 @@ var AmbiguousBindingError = class extends DiError {
 		this.candidateIds = candidateIds;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var CircularDependencyError = class extends DiError {
 	code = "CIRCULAR_DEPENDENCY";
 	cycle;
@@ -51,6 +69,9 @@ var CircularDependencyError = class extends DiError {
 		this.cycle = cycle;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var AsyncResolutionError = class extends DiError {
 	code = "ASYNC_RESOLUTION";
 	tokenName;
@@ -61,6 +82,9 @@ var AsyncResolutionError = class extends DiError {
 		this.asyncSourceToken = asyncSourceToken;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var AsyncDeactivationError = class extends DiError {
 	code = "ASYNC_DEACTIVATION";
 	tokenName;
@@ -69,6 +93,9 @@ var AsyncDeactivationError = class extends DiError {
 		this.tokenName = tokenName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var ScopeViolationError = class extends DiError {
 	code = "SCOPE_VIOLATION";
 	details;
@@ -77,6 +104,9 @@ var ScopeViolationError = class extends DiError {
 		this.details = details;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var MissingMetadataError = class extends DiError {
 	code = "MISSING_METADATA";
 	targetName;
@@ -85,6 +115,9 @@ var MissingMetadataError = class extends DiError {
 		this.targetName = targetName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var AsyncModuleLoadError = class extends DiError {
 	code = "ASYNC_MODULE_LOAD";
 	moduleName;
@@ -93,12 +126,18 @@ var AsyncModuleLoadError = class extends DiError {
 		this.moduleName = moduleName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var SyncDisposalNotSupportedError = class extends DiError {
 	code = "SYNC_DISPOSAL_NOT_SUPPORTED";
 	constructor() {
 		super("Container cannot be disposed synchronously because onDeactivation handlers may be async. Use `await using` or call container.dispose() explicitly.");
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var MissingScopeContextError = class extends DiError {
 	code = "MISSING_SCOPE_CONTEXT";
 	tokenName;
@@ -107,6 +146,9 @@ var MissingScopeContextError = class extends DiError {
 		this.tokenName = tokenName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var MissingContainerContextError = class extends DiError {
 	code = "MISSING_CONTAINER_CONTEXT";
 	targetName;
@@ -115,6 +157,9 @@ var MissingContainerContextError = class extends DiError {
 		this.targetName = targetName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var RebindUnboundTokenError = class extends DiError {
 	code = "REBIND_UNBOUND_TOKEN";
 	tokenName;
@@ -123,6 +168,9 @@ var RebindUnboundTokenError = class extends DiError {
 		this.tokenName = tokenName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var DisposedContainerError = class extends DiError {
 	code = "DISPOSED_CONTAINER";
 	constructor() {

package/dist/graph-adapters/cytoscape.d.mts

@@ -1,6 +1,9 @@
 import { ContainerGraphJson } from "../dependency-graph.mjs";
 
 //#region src/graph-adapters/cytoscape.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface CytoscapeNode {
   data: {
     id: string;
@@ -10,6 +13,9 @@ interface CytoscapeNode {
     fromParent: boolean;
   };
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface CytoscapeEdge {
   data: {
     id: string;
@@ -18,7 +24,13 @@ interface CytoscapeEdge {
     label?: string;
   };
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 type CytoscapeElements = Array<CytoscapeNode | CytoscapeEdge>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function toCytoscapeGraph(graph: ContainerGraphJson): CytoscapeElements;
 //#endregion
 export { CytoscapeEdge, CytoscapeElements, CytoscapeNode, toCytoscapeGraph };

package/dist/graph-adapters/cytoscape.mjs

@@ -1,4 +1,7 @@
 //#region src/graph-adapters/cytoscape.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function toCytoscapeGraph(graph) {
 	const elements = [];
 	for (const node of graph.nodes) elements.push({ data: {

package/dist/graph-adapters/dot.d.mts

@@ -1,6 +1,9 @@
 import { ContainerGraphJson } from "../dependency-graph.mjs";
 
 //#region src/graph-adapters/dot.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function toDotGraph(graph: ContainerGraphJson): string;
 //#endregion
 export { toDotGraph };

package/dist/graph-adapters/dot.mjs

@@ -1,4 +1,7 @@
 //#region src/graph-adapters/dot.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function toDotGraph(graph) {
 	const lines = ["digraph DI {", "  rankdir=TB;"];
 	for (const node of graph.nodes) {

package/dist/graph-adapters/reactflow.d.mts

@@ -1,6 +1,9 @@
 import { ContainerGraphJson } from "../dependency-graph.mjs";
 
 //#region src/graph-adapters/reactflow.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ReactFlowNode {
   id: string;
   data: {
@@ -14,16 +17,25 @@ interface ReactFlowNode {
     y: number;
   };
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ReactFlowEdge {
   id: string;
   source: string;
   target: string;
   label?: string;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ReactFlowGraph {
   nodes: ReactFlowNode[];
   edges: ReactFlowEdge[];
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function toReactFlowGraph(graph: ContainerGraphJson): ReactFlowGraph;
 //#endregion
 export { ReactFlowEdge, ReactFlowGraph, ReactFlowNode, toReactFlowGraph };

package/dist/graph-adapters/reactflow.mjs

@@ -1,4 +1,7 @@
 //#region src/graph-adapters/reactflow.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function toReactFlowGraph(graph) {
 	return {
 		nodes: graph.nodes.map((node, idx) => ({

package/dist/inspector.d.mts

@@ -5,6 +5,9 @@ import { BindingRegistry } from "./registry.mjs";
 import { ScopeManager } from "./scope.mjs";
 
 //#region src/inspector.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface BindingSnapshot {
   readonly tokenName: string;
   readonly kind: BindingKind;
@@ -15,6 +18,9 @@ interface BindingSnapshot {
   };
   readonly id: BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ContainerSnapshot {
   readonly ownBindings: readonly BindingSnapshot[];
   readonly bindings: readonly BindingSnapshot[];
@@ -22,6 +28,9 @@ interface ContainerSnapshot {
   readonly hasParent: boolean;
   readonly isDisposed: boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class Inspector {
   private readonly _registry;
   private readonly _scope;

package/dist/inspector.mjs

@@ -2,6 +2,9 @@ import { effectiveBindingScope } from "./binding-scope.mjs";
 import { selectBinding } from "./binding-select.mjs";
 import { tokenName } from "./token.mjs";
 //#region src/inspector.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var Inspector = class {
 	constructor(_registry, _scope, _hasParent, _isDisposed) {
 		this._registry = _registry;

package/dist/lifecycle.d.mts

@@ -5,6 +5,9 @@ import { Binding } from "./binding.mjs";
 import { MetadataReader } from "./metadata/metadata-types.mjs";
 
 //#region src/lifecycle.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class LifecycleManager {
   private readonly _activationHooks;
   private readonly _deactivationHooks;

package/dist/lifecycle.mjs

@@ -1,6 +1,9 @@
 import { AsyncDeactivationError } from "./errors.mjs";
 import { tokenName } from "./token.mjs";
 //#region src/lifecycle.ts
+/**
+* @since 0.3.16-canary.0
+*/
 var LifecycleManager = class {
 	_activationHooks = /* @__PURE__ */ new Map();
 	_deactivationHooks = /* @__PURE__ */ new Map();

package/dist/metadata/metadata-keys.d.mts

@@ -1,11 +1,29 @@
 import { ConstructorMetadata, MutableLifecycleMetadata } from "./metadata-types.mjs";
 
 //#region src/metadata/metadata-keys.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const INJECTABLE_KEY: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const LIFECYCLE_KEY: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const INJECT_ACCESSOR_KEY: unique symbol;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const constructorMetadataMap: WeakMap<object, ConstructorMetadata>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const lifecycleMetadataMap: WeakMap<object, MutableLifecycleMetadata>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const lifecycleByConstructorMetadataMap: WeakMap<object, MutableLifecycleMetadata>;
 //#endregion
 export { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, constructorMetadataMap, lifecycleByConstructorMetadataMap, lifecycleMetadataMap };

package/dist/metadata/metadata-keys.mjs

@@ -1,9 +1,27 @@
 //#region src/metadata/metadata-keys.ts
+/**
+* @since 0.3.16-canary.0
+*/
 const INJECTABLE_KEY = Symbol("di:injectable");
+/**
+* @since 0.3.16-canary.0
+*/
 const LIFECYCLE_KEY = Symbol("di:lifecycle");
+/**
+* @since 0.3.16-canary.0
+*/
 const INJECT_ACCESSOR_KEY = Symbol("di:inject-accessor");
+/**
+* @since 0.3.16-canary.0
+*/
 const constructorMetadataMap = /* @__PURE__ */ new WeakMap();
+/**
+* @since 0.3.16-canary.0
+*/
 const lifecycleMetadataMap = /* @__PURE__ */ new WeakMap();
+/**
+* @since 0.3.16-canary.0
+*/
 const lifecycleByConstructorMetadataMap = /* @__PURE__ */ new WeakMap();
 //#endregion
 export { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, constructorMetadataMap, lifecycleByConstructorMetadataMap, lifecycleMetadataMap };

package/dist/metadata/metadata-reader-token.d.mts

@@ -2,6 +2,9 @@ import { Token } from "../token.mjs";
 import { MetadataReader } from "./metadata-types.mjs";
 
 //#region src/metadata/metadata-reader-token.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const MetadataReaderToken: Token<MetadataReader>;
 //#endregion
 export { MetadataReaderToken };

package/dist/metadata/metadata-reader-token.mjs

@@ -1,5 +1,8 @@
 import { token } from "../token.mjs";
 //#region src/metadata/metadata-reader-token.ts
+/**
+* @since 0.3.16-canary.0
+*/
 const MetadataReaderToken = token("MetadataReader");
 //#endregion
 export { MetadataReaderToken };

package/dist/metadata/metadata-types.d.mts

@@ -2,6 +2,9 @@ import { Constructor } from "../constructor-type.mjs";
 import { Token } from "../token.mjs";
 
 //#region src/metadata/metadata-types.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ParamMetadata {
   readonly index: number;
   readonly token: Token<unknown> | Constructor;
@@ -10,18 +13,31 @@ interface ParamMetadata {
   readonly name?: string;
   readonly tags?: ReadonlyArray<readonly [string, unknown]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ConstructorMetadata {
   readonly params: readonly ParamMetadata[];
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface LifecycleMetadata {
   readonly postConstruct: readonly string[];
   readonly preDestroy: readonly string[];
 }
-/** Mutable buckets used while aggregating decorator metadata (same keys as {@link LifecycleMetadata}). */
+/**
+ * Mutable buckets used while aggregating decorator metadata (same keys as {@link LifecycleMetadata}).
+ *
+ * @since 0.3.16-canary.0
+ */
 interface MutableLifecycleMetadata {
   postConstruct: string[];
   preDestroy: string[];
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface MetadataReader {
   getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
   getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;

package/dist/metadata/symbol-metadata-reader.d.mts

@@ -3,6 +3,9 @@ import { InjectionDescriptor } from "../decorators/inject.mjs";
 import { ConstructorMetadata, LifecycleMetadata, MetadataReader } from "./metadata-types.mjs";
 
 //#region src/metadata/symbol-metadata-reader.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class SymbolMetadataReader implements MetadataReader {
   getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
   getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
@@ -11,6 +14,9 @@ declare class SymbolMetadataReader implements MetadataReader {
     descriptor: InjectionDescriptor;
   }> | undefined;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const defaultMetadataReader: SymbolMetadataReader;
 //#endregion
 export { SymbolMetadataReader, defaultMetadataReader };