@codefast/di 0.3.15 → 0.3.16-canary.1

package/dist/environment.d.mts

@@ -4,34 +4,49 @@ 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;
-  resolveAsyncFromContext<const Value>(token: Token<Value> | Constructor<Value>, path: string[], stack: MaterializationFrame[]): Promise<Value>;
-  resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Promise<Value>;
-  resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Value | undefined;
-  resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: string[], stack: MaterializationFrame[]): Promise<Value | undefined>;
-  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[]>;
+  resolveFromContext<const Value>(token: Token<Value> | Constructor<Value>, path: Array<string>, stack: Array<MaterializationFrame>): Value;
+  resolve<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Value;
+  resolveAsyncFromContext<const Value>(token: Token<Value> | Constructor<Value>, path: Array<string>, stack: Array<MaterializationFrame>): Promise<Value>;
+  resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Promise<Value>;
+  resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Value | undefined;
+  resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Promise<Value | undefined>;
+  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Array<Value>;
+  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint: ResolveOptions | undefined, path: Array<string>, stack: Array<MaterializationFrame>): Promise<Array<Value>>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class DefaultResolutionContext implements ResolutionContext {
   private _resolver;
   private _resolutionPath;
   private _materializationStack;
   private _currentHint;
-  constructor(resolver: ResolverCallbacks, resolutionPath: string[], materializationStack: MaterializationFrame[], currentHint: ResolveOptions | undefined);
+  constructor(resolver: ResolverCallbacks, resolutionPath: Array<string>, materializationStack: Array<MaterializationFrame>, currentHint: ResolveOptions | undefined);
   private _graph;
   get graph(): ConstraintContext;
-  reset(resolver: ResolverCallbacks, resolutionPath: string[], materializationStack: MaterializationFrame[], currentHint: ResolveOptions | undefined): void;
+  reset(resolver: ResolverCallbacks, resolutionPath: Array<string>, materializationStack: Array<MaterializationFrame>, currentHint: ResolveOptions | undefined): void;
   resolve<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value;
   resolveAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value>;
   resolveOptional<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value | undefined;
   resolveOptionalAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value | undefined>;
-  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Value[];
-  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Value[]>;
+  resolveAll<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Array<Value>;
+  resolveAllAsync<const Value>(token: Token<Value> | Constructor<Value>, hint?: ResolveOptions): Promise<Array<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,92 +1,153 @@
 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;
   readonly hint: ResolveOptions;
-  readonly availableSlots: string[];
-  constructor(tokenName: string, hint: ResolveOptions, availableSlots: string[]);
+  readonly availableSlots: Array<string>;
+  constructor(tokenName: string, hint: ResolveOptions, availableSlots: Array<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[]);
+  readonly candidateIds: ReadonlyArray<BindingIdentifier>;
+  constructor(tokenName: string, candidateIds: ReadonlyArray<BindingIdentifier>);
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class CircularDependencyError extends DiError {
   readonly code = "CIRCULAR_DEPENDENCY";
-  readonly cycle: string[];
-  constructor(cycle: string[]);
+  readonly cycle: Array<string>;
+  constructor(cycle: Array<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;
   readonly dependencyToken: string;
   readonly dependencyScope: BindingScope;
-  readonly path: string[];
+  readonly path: Array<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();
 }
+/**
+ * @since 0.3.16-canary.0
+ */
+declare class AsyncActivationError extends DiError {
+  readonly code = "ASYNC_ACTIVATION";
+  readonly tokenName: string;
+  readonly hookKind: "postConstruct" | "onActivation";
+  readonly methodName: string | undefined;
+  constructor(tokenName: string, hookKind: "postConstruct" | "onActivation", methodName?: string);
+}
 //#endregion
-export { AmbiguousBindingError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationDetails, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError };
+export { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationDetails, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError };

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,11 +168,30 @@ var RebindUnboundTokenError = class extends DiError {
 		this.tokenName = tokenName;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 var DisposedContainerError = class extends DiError {
 	code = "DISPOSED_CONTAINER";
 	constructor() {
 		super("Cannot perform operations on a disposed container.");
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
+var AsyncActivationError = class extends DiError {
+	code = "ASYNC_ACTIVATION";
+	tokenName;
+	hookKind;
+	methodName;
+	constructor(tokenName, hookKind, methodName) {
+		const detail = hookKind === "postConstruct" ? `@postConstruct method '${methodName ?? ""}' returned a Promise` : `onActivation for '${tokenName}' returned a Promise`;
+		super(`${detail}. Use resolveAsync() instead.`);
+		this.tokenName = tokenName;
+		this.hookKind = hookKind;
+		this.methodName = methodName;
+	}
+};
 //#endregion
-export { AmbiguousBindingError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError };
+export { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError };

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[];
+  nodes: Array<ReactFlowNode>;
+  edges: Array<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/index.d.mts

@@ -4,14 +4,15 @@ import { ActivationHandler, BindingIdentifier, BindingKind, BindingScope, Constr
 import { InjectOptions, InjectableDependency, InjectionDescriptor, inject, injectAll, isInjectionDescriptor, optional } from "./decorators/inject.mjs";
 import { AliasBindingBuilder, BindToBuilder, BindingBuilder, ConstantBindingBuilder, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, TransientBindingBuilder } from "./binding.mjs";
 import { effectiveBindingScope } from "./binding-scope.mjs";
-import { AsyncModule, AsyncModuleBuilder, Module, ModuleBuilder, SyncModule } from "./module.mjs";
+import { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll } from "./constraints.mjs";
+import { AsyncModule, AsyncModuleBuilder, Module, ModuleBuilder, SyncModule, isSyncModule } from "./module.mjs";
 import { BindingSnapshot, ContainerSnapshot } from "./inspector.mjs";
 import { MetadataReader, MutableLifecycleMetadata } from "./metadata/metadata-types.mjs";
 import { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions } from "./dependency-graph.mjs";
 import { AutoRegisterRegistry, InjectableOptions, createAutoRegisterRegistry, injectable } from "./decorators/injectable.mjs";
 import { Container, ContainerStatic } from "./container.mjs";
 import { postConstruct, preDestroy } from "./decorators/lifecycle-decorators.mjs";
-import { AmbiguousBindingError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationDetails, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError } from "./errors.mjs";
+import { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationDetails, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError } from "./errors.mjs";
 import { injectableSlotToResolveOptions, slotKeyToResolveOptions } from "./resolve-options.mjs";
 import { MetadataReaderToken } from "./metadata/metadata-reader-token.mjs";
-export { type ActivationHandler, type AliasBindingBuilder, AmbiguousBindingError, AsyncDeactivationError, AsyncModule, type AsyncModuleBuilder, AsyncModuleLoadError, AsyncResolutionError, type AutoRegisterRegistry, type BindToBuilder, type BindingBuilder, type BindingIdentifier, type BindingKind, type BindingScope, type BindingSnapshot, CircularDependencyError, type ConstantBindingBuilder, type ConstraintContext, type Constructor, Container, type ContainerGraphJson, type Container as ContainerInterface, type ContainerSnapshot, type ContainerStatic, type DeactivationHandler, type DependencyKey, DiError, DisposedContainerError, type GraphEdge, type GraphNode, type GraphOptions, type InjectOptions, type InjectableDependency, type InjectableOptions, type InjectionDescriptor, InternalError, type MaterializationFrame, type MetadataReader, MetadataReaderToken, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, Module, type ModuleBuilder, type MutableLifecycleMetadata, NoMatchingBindingError, RebindUnboundTokenError, type ResolutionContext, type ResolveOptions, type ScopeViolationDetails, ScopeViolationError, type ScopedBindingBuilder, type SingletonBindingBuilder, type SingletonLifecycleBuilder, SyncDisposalNotSupportedError, SyncModule, type Token, TokenNotBoundError, type TokenValue, type TransientBindingBuilder, createAutoRegisterRegistry, effectiveBindingScope, inject, injectAll, injectable, injectableSlotToResolveOptions, isInjectionDescriptor, isToken, optional, postConstruct, preDestroy, slotKeyToResolveOptions, token, tokenName };
+export { type ActivationHandler, type AliasBindingBuilder, AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModule, type AsyncModuleBuilder, AsyncModuleLoadError, AsyncResolutionError, type AutoRegisterRegistry, type BindToBuilder, type BindingBuilder, type BindingIdentifier, type BindingKind, type BindingScope, type BindingSnapshot, CircularDependencyError, type ConstantBindingBuilder, type ConstraintContext, type Constructor, Container, type ContainerGraphJson, type Container as ContainerInterface, type ContainerSnapshot, type ContainerStatic, type DeactivationHandler, type DependencyKey, DiError, DisposedContainerError, type GraphEdge, type GraphNode, type GraphOptions, type InjectOptions, type InjectableDependency, type InjectableOptions, type InjectionDescriptor, InternalError, type MaterializationFrame, type MetadataReader, MetadataReaderToken, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, Module, type ModuleBuilder, type MutableLifecycleMetadata, NoMatchingBindingError, RebindUnboundTokenError, type ResolutionContext, type ResolveOptions, type ScopeViolationDetails, ScopeViolationError, type ScopedBindingBuilder, type SingletonBindingBuilder, type SingletonLifecycleBuilder, SyncDisposalNotSupportedError, SyncModule, type Token, TokenNotBoundError, type TokenValue, type TransientBindingBuilder, createAutoRegisterRegistry, effectiveBindingScope, inject, injectAll, injectable, injectableSlotToResolveOptions, isInjectionDescriptor, isSyncModule, isToken, optional, postConstruct, preDestroy, slotKeyToResolveOptions, token, tokenName, whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll };

package/dist/index.mjs

@@ -1,11 +1,12 @@
 import { effectiveBindingScope } from "./binding-scope.mjs";
-import { AmbiguousBindingError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError } from "./errors.mjs";
+import { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, DiError, DisposedContainerError, InternalError, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, TokenNotBoundError } from "./errors.mjs";
 import { isToken, token, tokenName } from "./token.mjs";
+import { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll } from "./constraints.mjs";
 import { injectableSlotToResolveOptions, slotKeyToResolveOptions } from "./resolve-options.mjs";
 import { MetadataReaderToken } from "./metadata/metadata-reader-token.mjs";
 import { inject, injectAll, isInjectionDescriptor, optional } from "./decorators/inject.mjs";
-import { AsyncModule, Module, SyncModule } from "./module.mjs";
+import { AsyncModule, Module, SyncModule, isSyncModule } from "./module.mjs";
 import { Container } from "./container.mjs";
 import { createAutoRegisterRegistry, injectable } from "./decorators/injectable.mjs";
 import { postConstruct, preDestroy } from "./decorators/lifecycle-decorators.mjs";
-export { AmbiguousBindingError, AsyncDeactivationError, AsyncModule, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, Container, DiError, DisposedContainerError, InternalError, MetadataReaderToken, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, Module, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, SyncModule, TokenNotBoundError, createAutoRegisterRegistry, effectiveBindingScope, inject, injectAll, injectable, injectableSlotToResolveOptions, isInjectionDescriptor, isToken, optional, postConstruct, preDestroy, slotKeyToResolveOptions, token, tokenName };
+export { AmbiguousBindingError, AsyncActivationError, AsyncDeactivationError, AsyncModule, AsyncModuleLoadError, AsyncResolutionError, CircularDependencyError, Container, DiError, DisposedContainerError, InternalError, MetadataReaderToken, MissingContainerContextError, MissingMetadataError, MissingScopeContextError, Module, NoMatchingBindingError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError, SyncModule, TokenNotBoundError, createAutoRegisterRegistry, effectiveBindingScope, inject, injectAll, injectable, injectableSlotToResolveOptions, isInjectionDescriptor, isSyncModule, isToken, optional, postConstruct, preDestroy, slotKeyToResolveOptions, token, tokenName, whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenAnyAncestorTaggedAll, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged, whenParentTaggedAll };

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,13 +18,18 @@ interface BindingSnapshot {
   };
   readonly id: BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ContainerSnapshot {
-  readonly ownBindings: readonly BindingSnapshot[];
-  readonly bindings: readonly BindingSnapshot[];
+  readonly ownBindings: ReadonlyArray<BindingSnapshot>;
   readonly cachedSingletonCount: number;
   readonly hasParent: boolean;
   readonly isDisposed: boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare class Inspector {
   private readonly _registry;
   private readonly _scope;
@@ -29,7 +37,7 @@ declare class Inspector {
   private readonly _isDisposed;
   constructor(_registry: BindingRegistry, _scope: ScopeManager, _hasParent: boolean, _isDisposed: () => boolean);
   inspect(): ContainerSnapshot;
-  lookupBindings<Value>(token: Token<Value> | Constructor<Value>): readonly BindingSnapshot[];
+  lookupBindings<Value>(token: Token<Value> | Constructor<Value>): ReadonlyArray<BindingSnapshot>;
   has(token: Token<unknown> | Constructor, hint?: ResolveOptions, parentHas?: () => boolean): boolean;
   hasOwn(token: Token<unknown> | Constructor, hint?: ResolveOptions): boolean;
   private allBindingSnapshots;

package/dist/inspector.mjs

@@ -2,7 +2,14 @@ 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 {
+	_registry;
+	_scope;
+	_hasParent;
+	_isDisposed;
 	constructor(_registry, _scope, _hasParent, _isDisposed) {
 		this._registry = _registry;
 		this._scope = _scope;
@@ -10,10 +17,8 @@ var Inspector = class {
 		this._isDisposed = _isDisposed;
 	}
 	inspect() {
-		const snapshots = this.allBindingSnapshots();
 		return {
-			ownBindings: snapshots,
-			bindings: snapshots,
+			ownBindings: this.allBindingSnapshots(),
 			cachedSingletonCount: this._scope.getAllSingletons().size,
 			hasParent: this._hasParent,
 			isDisposed: this._isDisposed()