@codefast/di 0.3.14 → 0.3.16-canary.0

package/dist/binding-select.mjs

@@ -3,6 +3,8 @@ import { AmbiguousBindingError } from "./errors.mjs";
 /**
 * Select a single candidate from a list of bindings using slot matching + predicates.
 * Returns undefined if no match, throws AmbiguousBindingError if multiple match.
+*
+* @since 0.3.16-canary.0
 */
 function selectBinding(bindings, hint, ctx, tName) {
 	const candidates = filterBindings(bindings, hint, ctx);
@@ -12,6 +14,8 @@ function selectBinding(bindings, hint, ctx, tName) {
 }
 /**
 * Select all candidates matching hint + predicates.
+*
+* @since 0.3.16-canary.0
 */
 function selectAllBindings(bindings, hint, ctx) {
 	return filterBindings(bindings, hint, ctx, "all");

package/dist/binding.d.mts

@@ -4,12 +4,24 @@ import { ActivationHandler, BindingIdentifier, BindingScope, ConstraintContext,
 import { InjectionDescriptor } from "./decorators/inject.mjs";
 
 //#region src/binding.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface SlotKey {
   readonly name: string | undefined;
   readonly tags: ReadonlyArray<readonly [tag: string, value: unknown]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function slotKeyEquals(a: SlotKey, b: SlotKey): boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const DEFAULT_SLOT: SlotKey;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function slotKeyToString(slot: SlotKey): string;
 interface BindingBase<Value> {
   readonly id: BindingIdentifier;
@@ -17,6 +29,9 @@ interface BindingBase<Value> {
   readonly slot: SlotKey;
   readonly predicate?: (ctx: ConstraintContext) => boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ClassBinding<Value> extends BindingBase<Value> {
   readonly kind: "class";
   readonly target: Constructor<Value>;
@@ -24,6 +39,9 @@ interface ClassBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface DynamicBinding<Value> extends BindingBase<Value> {
   readonly kind: "dynamic";
   readonly factory: (ctx: ResolutionContext) => Value;
@@ -31,6 +49,9 @@ interface DynamicBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface DynamicAsyncBinding<Value> extends BindingBase<Value> {
   readonly kind: "dynamic-async";
   readonly factory: (ctx: ResolutionContext) => Promise<Value>;
@@ -38,6 +59,9 @@ interface DynamicAsyncBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ResolvedBinding<Value> extends BindingBase<Value> {
   readonly kind: "resolved";
   readonly factory: (...args: unknown[]) => Value;
@@ -46,6 +70,9 @@ interface ResolvedBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ResolvedAsyncBinding<Value> extends BindingBase<Value> {
   readonly kind: "resolved-async";
   readonly factory: (...args: unknown[]) => Promise<Value>;
@@ -54,6 +81,9 @@ interface ResolvedAsyncBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ConstantBinding<Value> extends BindingBase<Value> {
   readonly kind: "constant";
   readonly value: Value;
@@ -61,14 +91,30 @@ interface ConstantBinding<Value> extends BindingBase<Value> {
   readonly onActivation?: ActivationHandler<Value>;
   readonly onDeactivation?: DeactivationHandler<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface AliasBinding<Value> extends BindingBase<Value> {
   readonly kind: "alias";
   readonly target: Token<Value> | Constructor<Value>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 type Binding<Value = unknown> = ClassBinding<Value> | DynamicBinding<Value> | DynamicAsyncBinding<Value> | ResolvedBinding<Value> | ResolvedAsyncBinding<Value> | ConstantBinding<Value> | AliasBinding<Value>;
-/** Builder-only payload before `id`, `token`, `slot`, and `predicate` are applied. */
+/**
+ * Builder-only payload before `id`, `token`, `slot`, and `predicate` are applied.
+ *
+ * @since 0.3.16-canary.0
+ */
 type PartialBinding<Value> = Omit<ClassBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<DynamicBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<DynamicAsyncBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ResolvedBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ResolvedAsyncBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<ConstantBinding<Value>, "id" | "token" | "slot" | "predicate"> | Omit<AliasBinding<Value>, "id" | "token" | "slot" | "predicate">;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function generateBindingId(): BindingIdentifier;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface BindToBuilder<Value> {
   to(type: Constructor<Value>): BindingBuilder<Value>;
   toSelf(): BindingBuilder<Value>;
@@ -79,6 +125,9 @@ interface BindToBuilder<Value> {
   toResolvedAsync<const Deps extends readonly DependencyKey[]>(factory: (...args: { [K in keyof Deps]: TokenValue<NoInfer<Deps>[K]> }) => Promise<Value>, deps: Deps): BindingBuilder<Value>;
   toAlias(target: Token<Value> | Constructor<Value>): AliasBindingBuilder;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface BindingBuilder<Value> {
   when(predicate: (ctx: ConstraintContext) => boolean): this;
   whenNamed(name: string): this;
@@ -89,6 +138,9 @@ interface BindingBuilder<Value> {
   scoped(): ScopedBindingBuilder<Value>;
   id(): BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ConstantBindingBuilder<Value> {
   when(predicate: (ctx: ConstraintContext) => boolean): this;
   whenNamed(name: string): this;
@@ -98,6 +150,9 @@ interface ConstantBindingBuilder<Value> {
   onDeactivation(fn: DeactivationHandler<Value>): SingletonLifecycleBuilder<Value>;
   id(): BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface AliasBindingBuilder {
   when(predicate: (ctx: ConstraintContext) => boolean): this;
   whenNamed(name: string): this;
@@ -105,16 +160,28 @@ interface AliasBindingBuilder {
   whenDefault(): this;
   id(): BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface SingletonBindingBuilder<Value> {
   onActivation(fn: ActivationHandler<Value>): this;
   onDeactivation(fn: DeactivationHandler<Value>): this;
   id(): BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface TransientBindingBuilder<Value> {
   onActivation(fn: ActivationHandler<Value>): this;
   id(): BindingIdentifier;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ScopedBindingBuilder<Value> extends TransientBindingBuilder<Value> {}
+/**
+ * @since 0.3.16-canary.0
+ */
 interface SingletonLifecycleBuilder<Value> {
   onActivation(fn: ActivationHandler<Value>): this;
   onDeactivation(fn: DeactivationHandler<Value>): this;

package/dist/binding.mjs

@@ -1,14 +1,23 @@
 //#region src/binding.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function slotKeyEquals(a, b) {
 	if (a.name !== b.name) return false;
 	if (a.tags.length !== b.tags.length) return false;
 	for (const [tagKey, tagValue] of a.tags) if (!b.tags.some(([k, v]) => k === tagKey && Object.is(v, tagValue))) return false;
 	return true;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 const DEFAULT_SLOT = {
 	name: void 0,
 	tags: []
 };
+/**
+* @since 0.3.16-canary.0
+*/
 function slotKeyToString(slot) {
 	if (slot.name === void 0 && slot.tags.length === 0) return "default";
 	const parts = [];
@@ -17,6 +26,9 @@ function slotKeyToString(slot) {
 	return parts.join(",");
 }
 let _idCounter = 0;
+/**
+* @since 0.3.16-canary.0
+*/
 function generateBindingId() {
 	return String(++_idCounter);
 }

package/dist/constraints.d.mts

@@ -3,13 +3,37 @@ import { Token } from "./token.mjs";
 import { ConstraintContext } from "./types.mjs";
 
 //#region src/constraints.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenParentIs(t: Token<unknown> | Constructor): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenNoParentIs(t: Token<unknown> | Constructor): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenAnyAncestorIs(t: Token<unknown> | Constructor): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenNoAncestorIs(t: Token<unknown> | Constructor): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenParentNamed(name: string): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenAnyAncestorNamed(name: string): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenParentTagged(tag: string, value: unknown): (ctx: ConstraintContext) => boolean;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function whenAnyAncestorTagged(tag: string, value: unknown): (ctx: ConstraintContext) => boolean;
 //#endregion
 export { whenAnyAncestorIs, whenAnyAncestorNamed, whenAnyAncestorTagged, whenNoAncestorIs, whenNoParentIs, whenParentIs, whenParentNamed, whenParentTagged };

package/dist/constraints.mjs

@@ -3,31 +3,55 @@ import { tokenName } from "./token.mjs";
 function tokenNameOf(t) {
 	return tokenName(t);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenParentIs(t) {
 	const name = tokenNameOf(t);
 	return (ctx) => ctx.parent !== void 0 && ctx.parent.tokenName === name;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenNoParentIs(t) {
 	const name = tokenNameOf(t);
 	return (ctx) => ctx.parent === void 0 || ctx.parent.tokenName !== name;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenAnyAncestorIs(t) {
 	const name = tokenNameOf(t);
 	return (ctx) => ctx.ancestors.some((f) => f.tokenName === name);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenNoAncestorIs(t) {
 	const name = tokenNameOf(t);
 	return (ctx) => ctx.ancestors.every((f) => f.tokenName !== name);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenParentNamed(name) {
 	return (ctx) => ctx.parent !== void 0 && ctx.parent.slot.name === name;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenAnyAncestorNamed(name) {
 	return (ctx) => ctx.ancestors.some((f) => f.slot.name === name);
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenParentTagged(tag, value) {
 	return (ctx) => ctx.parent !== void 0 && ctx.parent.slot.tags.some(([t, v]) => t === tag && Object.is(v, value));
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function whenAnyAncestorTagged(tag, value) {
 	return (ctx) => ctx.ancestors.some((f) => f.slot.tags.some(([t, v]) => t === tag && Object.is(v, value)));
 }

package/dist/constructor-type.d.mts

@@ -5,12 +5,16 @@
  * `strictFunctionTypes` (unlike `unknown[]`, which is not assignable from
  * narrower parameter types). Runtime construction still uses the real shape;
  * this alias is the DI “class token” surface only.
+ *
+ * @since 0.3.16-canary.0
  */
 type Constructor<Value = unknown> = new (...args: never[]) => Value;
 /**
  * Class constructor as invoked by the resolver after metadata-driven
  * resolution of `unknown[]` dependencies — separate from {@link Constructor},
  * which is the public assignable class token.
+ *
+ * @since 0.3.16-canary.0
  */
 type ConstructorInvocation = new (...args: unknown[]) => unknown;
 //#endregion

package/dist/container.d.mts

@@ -8,6 +8,9 @@ import { ContainerGraphJson, GraphOptions } from "./dependency-graph.mjs";
 import { AutoRegisterRegistry } from "./decorators/injectable.mjs";
 
 //#region src/container.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface Container {
   readonly isDisposed: boolean;
   bind<const Value>(token: Token<Value> | Constructor<Value>): BindToBuilder<Value>;
@@ -41,11 +44,17 @@ interface Container {
   inspect(): ContainerSnapshot;
   generateDependencyGraph(options?: GraphOptions): ContainerGraphJson;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ContainerStatic {
   create(): Container;
   fromModules(...modules: SyncModule[]): Container;
   fromModulesAsync(...modules: Array<SyncModule | AsyncModule>): Promise<Container>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare const Container: ContainerStatic & {
   create(): Container;
 };

package/dist/container.mjs

@@ -706,6 +706,9 @@ var AliasBindingBuilderImpl = class {
 		return this._committed;
 	}
 };
+/**
+* @since 0.3.16-canary.0
+*/
 const Container = {
 	create() {
 		return new DefaultContainer();

package/dist/decorators/inject.d.mts

@@ -2,10 +2,16 @@ import { Constructor } from "../constructor-type.mjs";
 import { Token } from "../token.mjs";
 
 //#region src/decorators/inject.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface InjectOptions {
   name?: string;
   tags?: ReadonlyArray<readonly [tag: string, value: unknown]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface InjectionDescriptor<Value = unknown> {
   readonly token: Token<Value> | Constructor<Value>;
   readonly optional: boolean;
@@ -13,12 +19,30 @@ interface InjectionDescriptor<Value = unknown> {
   readonly name?: string;
   readonly tags?: ReadonlyArray<readonly [string, unknown]>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 type InjectableDependency<Value = unknown> = Token<Value> | Constructor<Value> | InjectionDescriptor<Value>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function isInjectionDescriptor(value: unknown): value is InjectionDescriptor;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function normalizeToDescriptor(dep: InjectableDependency): InjectionDescriptor;
 type ClassAccessorDecorator<This, Value> = (target: ClassAccessorDecoratorTarget<This, Value>, context: ClassAccessorDecoratorContext<This, Value>) => ClassAccessorDecoratorResult<This, Value> | void;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function inject<const Value>(t: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Value> & ClassAccessorDecorator<unknown, Value>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function optional<const Value>(t: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Value | undefined>;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function injectAll<const Value>(t: Token<Value> | Constructor<Value>, options?: InjectOptions): InjectionDescriptor<Value[]>;
 //#endregion
 export { InjectOptions, InjectableDependency, InjectionDescriptor, inject, injectAll, isInjectionDescriptor, normalizeToDescriptor, optional };

package/dist/decorators/inject.mjs

@@ -3,12 +3,18 @@ import { getActiveContainer } from "../environment.mjs";
 import { injectableSlotToResolveOptions } from "../resolve-options.mjs";
 import { INJECT_ACCESSOR_KEY } from "../metadata/metadata-keys.mjs";
 //#region src/decorators/inject.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function isInjectionDescriptor(value) {
 	if (value === null || value === void 0) return false;
 	const type = typeof value;
 	if (type !== "object" && type !== "function") return false;
 	return "token" in value && "optional" in value && "multi" in value && typeof value.optional === "boolean" && typeof value.multi === "boolean";
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function normalizeToDescriptor(dep) {
 	if (isInjectionDescriptor(dep)) return materializeInjectionDescriptor(dep);
 	return {
@@ -69,6 +75,9 @@ function buildInjectionDescriptor(t, options) {
 	};
 	return base;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function inject(t, options) {
 	const descriptor = buildInjectionDescriptor(t, options);
 	const decoratorFn = (_target, context) => {
@@ -100,6 +109,9 @@ function inject(t, options) {
 	Object.defineProperties(decoratorFn, props);
 	return decoratorFn;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function optional(t, options) {
 	const base = {
 		token: t,
@@ -121,6 +133,9 @@ function optional(t, options) {
 	};
 	return base;
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function injectAll(t, options) {
 	const base = {
 		token: t,

package/dist/decorators/injectable.d.mts

@@ -3,6 +3,9 @@ import { BindingScope } from "../types.mjs";
 import { InjectableDependency } from "./inject.mjs";
 
 //#region src/decorators/injectable.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface AutoRegisterRegistry {
   register(target: Constructor, scope: BindingScope): void;
   entries(): ReadonlyArray<{
@@ -10,11 +13,20 @@ interface AutoRegisterRegistry {
     scope: BindingScope;
   }>;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function createAutoRegisterRegistry(): AutoRegisterRegistry;
+/**
+ * @since 0.3.16-canary.0
+ */
 interface InjectableOptions {
   autoRegister?: AutoRegisterRegistry;
   scope?: BindingScope;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function injectable(deps?: readonly InjectableDependency[], options?: InjectableOptions): (target: unknown, context: ClassDecoratorContext) => void;
 //#endregion
 export { AutoRegisterRegistry, type InjectableDependency, InjectableOptions, createAutoRegisterRegistry, injectable };

package/dist/decorators/injectable.mjs

@@ -1,6 +1,9 @@
 import { INJECTABLE_KEY, constructorMetadataMap } from "../metadata/metadata-keys.mjs";
 import { normalizeToDescriptor } from "./inject.mjs";
 //#region src/decorators/injectable.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function createAutoRegisterRegistry() {
 	const _entries = [];
 	return {
@@ -15,6 +18,9 @@ function createAutoRegisterRegistry() {
 		}
 	};
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function injectable(deps, options) {
 	return function(target, context) {
 		const constructorMeta = { params: (deps ?? []).map((dep, index) => {

package/dist/decorators/lifecycle-decorators.d.mts

@@ -1,5 +1,11 @@
 //#region src/decorators/lifecycle-decorators.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function postConstruct(): (target: unknown, context: ClassMethodDecoratorContext) => void;
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function preDestroy(): (target: unknown, context: ClassMethodDecoratorContext) => void;
 //#endregion
 export { postConstruct, preDestroy };

package/dist/decorators/lifecycle-decorators.mjs

@@ -20,6 +20,9 @@ function registerByConstructor(target, phase, methodName) {
 		preDestroy: phase === "preDestroy" ? [methodName] : []
 	});
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function postConstruct() {
 	return function(target, context) {
 		const methodName = String(context.name);
@@ -53,6 +56,9 @@ function postConstruct() {
 		} catch {}
 	};
 }
+/**
+* @since 0.3.16-canary.0
+*/
 function preDestroy() {
 	return function(target, context) {
 		const methodName = String(context.name);

package/dist/dependency-graph.d.mts

@@ -3,6 +3,9 @@ import { BindingRegistry } from "./registry.mjs";
 import { MetadataReader } from "./metadata/metadata-types.mjs";
 
 //#region src/dependency-graph.d.ts
+/**
+ * @since 0.3.16-canary.0
+ */
 interface GraphNode {
   readonly id: string;
   readonly tokenName: string;
@@ -10,19 +13,31 @@ interface GraphNode {
   readonly scope: BindingScope;
   readonly fromParent: boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface GraphEdge {
   readonly from: string;
   readonly to: string;
   readonly label?: string;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface ContainerGraphJson {
   readonly nodes: readonly GraphNode[];
   readonly edges: readonly GraphEdge[];
   readonly includesParent: boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 interface GraphOptions {
   readonly includeParent?: boolean;
 }
+/**
+ * @since 0.3.16-canary.0
+ */
 declare function buildDependencyGraph(registry: BindingRegistry, metadataReader: MetadataReader, options: GraphOptions | undefined, parentRegistry?: BindingRegistry): ContainerGraphJson;
 //#endregion
 export { ContainerGraphJson, GraphEdge, GraphNode, GraphOptions, buildDependencyGraph };

package/dist/dependency-graph.mjs

@@ -1,6 +1,9 @@
 import { effectiveBindingScope } from "./binding-scope.mjs";
 import { tokenName } from "./token.mjs";
 //#region src/dependency-graph.ts
+/**
+* @since 0.3.16-canary.0
+*/
 function buildDependencyGraph(registry, metadataReader, options, parentRegistry) {
 	const nodes = [];
 	const edges = [];

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,