@codefast/di 0.3.16-canary.1 → 0.3.16-canary.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @codefast/di
 
+## 0.3.16-canary.2
+
+### Patch Changes
+
+- [`1ad2cb7`](https://github.com/codefastlabs/codefast/commit/1ad2cb73a3f6f8bff2b001e9df2f2492efd89aa2) Thanks [@thevuong](https://github.com/thevuong)! - chore: align package config globs
+
+- [`4fda78b`](https://github.com/codefastlabs/codefast/commit/4fda78b20f98646d114cfddb09e66af609a625a2) Thanks [@thevuong](https://github.com/thevuong)! - fix: support Node 26 mirror export verification
+
+- [`1b0df2e`](https://github.com/codefastlabs/codefast/commit/1b0df2e55140c927b7f3ba39ccdcb4cba87ec7ff) Thanks [@thevuong](https://github.com/thevuong)! - refactor(di): clarify contextual names
+
 ## 0.3.16-canary.1
 
 ## 0.3.16-canary.0

package/README.md

@@ -181,7 +181,7 @@ Start with `container.bind(key)` and chain a strategy, then optional constraints
 | `.toDynamicAsync(factory)`        | Async factory `(ctx: ResolutionContext) => Promise<Value>`.                                                 |
 | `.toResolved(factory, deps)`      | Factory with a typed dependency tuple; dependencies are resolved in order.                                  |
 | `.toResolvedAsync(factory, deps)` | Like `toResolved`, but the factory returns a `Promise`.                                                     |
-| `.toAlias(targetToken)`           | Redirect resolution to another token; the alias follows the target’s materialization.                       |
+| `.toAlias(targetToken)`           | Redirect resolution to another token; the alias follows the target’s resolution.                            |
 
 ```typescript
 container.bind(AppConfigToken).toConstantValue({ port: 3000 });
@@ -271,7 +271,7 @@ Built-in predicates (all from `@codefast/di/constraints`):
 | ----------------------------------- | -------------------------------------------------------------------------- |
 | `whenParentIs(key)`                 | The direct parent binding was registered for `key`.                        |
 | `whenNoParentIs(key)`               | There is no parent, or the parent is not registered for `key`.             |
-| `whenAnyAncestorIs(key)`            | Any ancestor on the materialization stack was registered for `key`.        |
+| `whenAnyAncestorIs(key)`            | Any ancestor on the resolution stack was registered for `key`.             |
 | `whenNoAncestorIs(key)`             | No ancestor was registered for `key`.                                      |
 | `whenParentNamed(name)`             | The immediate parent binding’s slot name is `name`.                        |
 | `whenAnyAncestorNamed(name)`        | Some ancestor’s slot name is `name`.                                       |
@@ -645,7 +645,7 @@ The root entry re-exports the full façade (`package.json` → `"."`). Subpaths
 | `@codefast/di/decorators/injectable`           | `injectable`, `createAutoRegisterRegistry`, `AutoRegisterRegistry`                                                                                                   |
 | `@codefast/di/decorators/lifecycle-decorators` | `postConstruct`, `preDestroy`                                                                                                                                        |
 | `@codefast/di/dependency-graph`                | `buildDependencyGraph`, `ContainerGraphJson`, `GraphOptions`, …                                                                                                      |
-| `@codefast/di/environment`                     | `runWithContainer`, `getActiveContainer`, `DefaultResolutionContext`, `ResolverCallbacks`, `buildMaterializationFrame`                                               |
+| `@codefast/di/environment`                     | `runWithContainer`, `getActiveContainer`, `DefaultResolutionContext`, `ResolverCallbacks`, `buildResolutionFrame`                                                    |
 | `@codefast/di/errors`                          | Full `DiError` hierarchy                                                                                                                                             |
 | `@codefast/di/graph-adapters/cytoscape`        | `toCytoscapeGraph`                                                                                                                                                   |
 | `@codefast/di/graph-adapters/dot`              | `toDotGraph`                                                                                                                                                         |
@@ -659,7 +659,7 @@ The root entry re-exports the full façade (`package.json` → `"."`). Subpaths
 | `@codefast/di/metadata/symbol-metadata-reader` | `SymbolMetadataReader`, `defaultMetadataReader`                                                                                                                      |
 | `@codefast/di/module`                          | `Module`, `AsyncModule`, `SyncModule`, `isSyncModule`, builders                                                                                                      |
 | `@codefast/di/registry`                        | `BindingRegistry`                                                                                                                                                    |
-| `@codefast/di/resolve-options`                 | `injectableSlotToResolveOptions`, `slotKeyToResolveOptions`                                                                                                          |
+| `@codefast/di/resolve-options`                 | `injectionSlotToResolveOptions`, `bindingSlotToResolveOptions`                                                                                                       |
 | `@codefast/di/resolver`                        | `DependencyResolver`                                                                                                                                                 |
 | `@codefast/di/scope`                           | `ScopeManager`                                                                                                                                                       |
 | `@codefast/di/token`                           | `token`, `Token`, `tokenName`, …                                                                                                                                     |

package/dist/binding-select.d.mts

@@ -8,7 +8,7 @@ import { Binding } from "./binding.mjs";
  *
  * @since 0.3.16-canary.0
  */
-declare function selectBinding(bindings: ReadonlyArray<Binding>, hint: ResolveOptions | undefined, ctx: ConstraintContext, tName: string): Binding | undefined;
+declare function selectBinding(bindings: ReadonlyArray<Binding>, hint: ResolveOptions | undefined, ctx: ConstraintContext, tokenDisplayName: string): Binding | undefined;
 /**
  * Select all candidates matching hint + predicates.
  *

package/dist/binding-select.mjs

@@ -6,11 +6,11 @@ import { AmbiguousBindingError } from "./errors.mjs";
 *
 * @since 0.3.16-canary.0
 */
-function selectBinding(bindings, hint, ctx, tName) {
+function selectBinding(bindings, hint, ctx, tokenDisplayName) {
 	const candidates = filterBindings(bindings, hint, ctx);
 	if (candidates.length === 0) return;
 	if (candidates.length === 1) return candidates[0];
-	throw new AmbiguousBindingError(tName, candidates.map((c) => c.id));
+	throw new AmbiguousBindingError(tokenDisplayName, candidates.map((c) => c.id));
 }
 /**
 * Select all candidates matching hint + predicates.
@@ -20,10 +20,10 @@ function selectBinding(bindings, hint, ctx, tName) {
 function selectAllBindings(bindings, hint, ctx) {
 	return filterBindings(bindings, hint, ctx, "all");
 }
-function filterBindings(bindings, hint, ctx, mode = "single") {
+function filterBindings(bindings, hint, ctx, selectionMode = "single") {
 	if (hint === void 0) {
 		const resultWithoutHint = [];
-		if (mode === "all") {
+		if (selectionMode === "all") {
 			for (const binding of bindings) if (matchesPredicate(binding, ctx)) resultWithoutHint.push(binding);
 		} else for (const binding of bindings) {
 			const slot = binding.slot;
@@ -32,7 +32,7 @@ function filterBindings(bindings, hint, ctx, mode = "single") {
 		return resultWithoutHint;
 	}
 	const result = [];
-	for (const binding of bindings) if ((mode === "all" ? matchesSlotForResolveAll(binding, hint) : matchesSlot(binding, hint)) && matchesPredicate(binding, ctx)) result.push(binding);
+	for (const binding of bindings) if ((selectionMode === "all" ? matchesSlotForResolveAll(binding, hint) : matchesSlot(binding, hint)) && matchesPredicate(binding, ctx)) result.push(binding);
 	return result;
 }
 function matchesSlotForResolveAll(binding, hint) {

package/dist/binding.d.mts

@@ -7,26 +7,26 @@ import { InjectionDescriptor } from "./decorators/inject.mjs";
 /**
  * @since 0.3.16-canary.0
  */
-interface SlotKey {
+interface BindingSlot {
   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;
+declare function bindingSlotEquals(left: BindingSlot, right: BindingSlot): boolean;
 /**
  * @since 0.3.16-canary.0
  */
-declare const DEFAULT_SLOT: SlotKey;
+declare const DEFAULT_BINDING_SLOT: BindingSlot;
 /**
  * @since 0.3.16-canary.0
  */
-declare function slotKeyToString(slot: SlotKey): string;
+declare function bindingSlotToString(slot: BindingSlot): string;
 interface BindingBase<Value> {
   readonly id: BindingIdentifier;
   readonly token: Token<Value> | Constructor<Value>;
-  readonly slot: SlotKey;
+  readonly slot: BindingSlot;
   readonly predicate?: (ctx: ConstraintContext) => boolean;
 }
 /**
@@ -188,4 +188,4 @@ interface SingletonLifecycleBuilder<Value> {
   id(): BindingIdentifier;
 }
 //#endregion
-export { AliasBinding, AliasBindingBuilder, BindToBuilder, Binding, BindingBuilder, ClassBinding, ConstantBinding, ConstantBindingBuilder, DEFAULT_SLOT, DynamicAsyncBinding, DynamicBinding, PartialBinding, ResolvedAsyncBinding, ResolvedBinding, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, SlotKey, TransientBindingBuilder, generateBindingId, slotKeyEquals, slotKeyToString };
+export { AliasBinding, AliasBindingBuilder, BindToBuilder, Binding, BindingBuilder, BindingSlot, ClassBinding, ConstantBinding, ConstantBindingBuilder, DEFAULT_BINDING_SLOT, DynamicAsyncBinding, DynamicBinding, PartialBinding, ResolvedAsyncBinding, ResolvedBinding, ScopedBindingBuilder, SingletonBindingBuilder, SingletonLifecycleBuilder, TransientBindingBuilder, bindingSlotEquals, bindingSlotToString, generateBindingId };

package/dist/binding.mjs

@@ -2,27 +2,27 @@
 /**
 * @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;
+function bindingSlotEquals(left, right) {
+	if (left.name !== right.name) return false;
+	if (left.tags.length !== right.tags.length) return false;
+	for (const [tagKey, tagValue] of left.tags) if (!right.tags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue))) return false;
 	return true;
 }
 /**
 * @since 0.3.16-canary.0
 */
-const DEFAULT_SLOT = {
+const DEFAULT_BINDING_SLOT = {
 	name: void 0,
 	tags: []
 };
 /**
 * @since 0.3.16-canary.0
 */
-function slotKeyToString(slot) {
+function bindingSlotToString(slot) {
 	if (slot.name === void 0 && slot.tags.length === 0) return "default";
 	const parts = [];
 	if (slot.name !== void 0) parts.push(`name:${slot.name}`);
-	for (const [k, v] of slot.tags) parts.push(`tag:${k}=${String(v)}`);
+	for (const [tagKey, tagValue] of slot.tags) parts.push(`tag:${tagKey}=${String(tagValue)}`);
 	return parts.join(",");
 }
 let _idCounter = 0;
@@ -33,4 +33,4 @@ function generateBindingId() {
 	return String(++_idCounter);
 }
 //#endregion
-export { DEFAULT_SLOT, generateBindingId, slotKeyEquals, slotKeyToString };
+export { DEFAULT_BINDING_SLOT, bindingSlotEquals, bindingSlotToString, generateBindingId };

package/dist/constraints.mjs

@@ -67,7 +67,7 @@ function whenParentTaggedAll(tags) {
 		const { parent } = constraintContext;
 		if (parent === void 0) return false;
 		const { tags: parentTags } = parent.slot;
-		return tags.every(([tagKey, tagValue]) => parentTags.some(([k, v]) => k === tagKey && Object.is(v, tagValue)));
+		return tags.every(([tagKey, tagValue]) => parentTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)));
 	};
 }
 /**
@@ -80,7 +80,7 @@ function whenParentTaggedAll(tags) {
 function whenAnyAncestorTaggedAll(tags) {
 	return (constraintContext) => constraintContext.ancestors.some((frame) => {
 		const { tags: frameTags } = frame.slot;
-		return tags.every(([tagKey, tagValue]) => frameTags.some(([k, v]) => k === tagKey && Object.is(v, tagValue)));
+		return tags.every(([tagKey, tagValue]) => frameTags.some(([otherKey, otherValue]) => otherKey === tagKey && Object.is(otherValue, tagValue)));
 	});
 }
 //#endregion

package/dist/container.mjs

@@ -1,11 +1,11 @@
 import { effectiveBindingScope } from "./binding-scope.mjs";
 import { AsyncModuleLoadError, CircularDependencyError, DisposedContainerError, InternalError, RebindUnboundTokenError, ScopeViolationError, SyncDisposalNotSupportedError } from "./errors.mjs";
-import { DEFAULT_SLOT, generateBindingId } from "./binding.mjs";
+import { DEFAULT_BINDING_SLOT, generateBindingId } from "./binding.mjs";
 import { tokenName } from "./token.mjs";
 import { BindingRegistry } from "./registry.mjs";
 import { ScopeManager } from "./scope.mjs";
 import { LifecycleManager } from "./lifecycle.mjs";
-import { injectableSlotToResolveOptions, slotKeyToResolveOptions } from "./resolve-options.mjs";
+import { bindingSlotToResolveOptions, injectionSlotToResolveOptions } from "./resolve-options.mjs";
 import { DependencyResolver } from "./resolver.mjs";
 import { Inspector } from "./inspector.mjs";
 import { buildDependencyGraph } from "./dependency-graph.mjs";
@@ -53,7 +53,7 @@ var DefaultContainer = class DefaultContainer {
 	}
 	_createBindToBuilder(token, moduleRef) {
 		const registry = this._registry;
-		const commitBinding = (b, previousId) => {
+		const commitBinding = (binding, previousId) => {
 			if (previousId !== void 0) {
 				registry.removeById(previousId);
 				if (moduleRef !== void 0) {
@@ -64,18 +64,18 @@ var DefaultContainer = class DefaultContainer {
 					}
 				}
 			}
-			registry.add(b);
+			registry.add(binding);
 			if (moduleRef !== void 0) {
 				let ids = this._moduleBindingIds.get(moduleRef);
 				if (ids === void 0) {
 					ids = [];
 					this._moduleBindingIds.set(moduleRef, ids);
 				}
-				ids.push(b.id);
+				ids.push(binding.id);
 			}
-			return b.id;
+			return binding.id;
 		};
-		return new BindToBuilderImpl(token, commitBinding);
+		return new BindingEntry(token, commitBinding);
 	}
 	unbind(tokenOrId) {
 		this._assertNotDisposed();
@@ -130,8 +130,8 @@ var DefaultContainer = class DefaultContainer {
 	}
 	_getBindingsForTokenOrId(tokenOrId) {
 		if (typeof tokenOrId === "string") {
-			const b = this._registry.getById(tokenOrId);
-			return b !== void 0 ? [b] : [];
+			const binding = this._registry.getById(tokenOrId);
+			return binding !== void 0 ? [binding] : [];
 		}
 		return [...this._registry.getAll(tokenOrId)];
 	}
@@ -141,72 +141,72 @@ var DefaultContainer = class DefaultContainer {
 	}
 	_loadSyncModules(modules) {
 		const toLoad = this._collectModuleDeps(modules);
-		for (const mod of toLoad) {
-			if (!isSyncModule(mod)) throw new AsyncModuleLoadError(mod.name);
-			const ref = mod;
-			const existing = this._moduleRefs.get(ref);
+		for (const module of toLoad) {
+			if (!isSyncModule(module)) throw new AsyncModuleLoadError(module.name);
+			const moduleRef = module;
+			const existing = this._moduleRefs.get(moduleRef);
 			if (existing !== void 0) {
-				this._moduleRefs.set(ref, existing + 1);
+				this._moduleRefs.set(moduleRef, existing + 1);
 				continue;
 			}
-			this._moduleRefs.set(ref, 1);
-			const builder = this._createModuleBuilder(ref);
-			mod._setup(builder);
+			this._moduleRefs.set(moduleRef, 1);
+			const builder = this._createModuleBuilder(moduleRef);
+			module._setup(builder);
 		}
 	}
 	_collectModuleDeps(modules) {
 		const seen = /* @__PURE__ */ new Set();
 		const result = [];
-		const visit = (mod) => {
-			const ref = mod;
-			if (seen.has(ref)) return;
-			seen.add(ref);
-			result.push(mod);
+		const visit = (module) => {
+			const moduleRef = module;
+			if (seen.has(moduleRef)) return;
+			seen.add(moduleRef);
+			result.push(module);
 		};
-		for (const m of modules) visit(m);
+		for (const module of modules) visit(module);
 		return result;
 	}
 	async loadAsync(...modules) {
 		this._assertNotDisposed();
-		for (const mod of modules) await this._loadOneModuleAsync(mod);
+		for (const module of modules) await this._loadOneModuleAsync(module);
 	}
-	async _loadOneModuleAsync(mod) {
-		const ref = mod;
-		const existing = this._moduleRefs.get(ref);
+	async _loadOneModuleAsync(module) {
+		const moduleRef = module;
+		const existing = this._moduleRefs.get(moduleRef);
 		if (existing !== void 0) {
-			this._moduleRefs.set(ref, existing + 1);
+			this._moduleRefs.set(moduleRef, existing + 1);
 			return;
 		}
-		this._moduleRefs.set(ref, 1);
-		if (isSyncModule(mod)) {
-			const builder = this._createModuleBuilder(ref);
-			mod._setup(builder);
+		this._moduleRefs.set(moduleRef, 1);
+		if (isSyncModule(module)) {
+			const builder = this._createModuleBuilder(moduleRef);
+			module._setup(builder);
 		} else {
 			const importPromises = [];
-			const builder = this._createAsyncModuleBuilder(ref, importPromises);
-			await mod._setup(builder);
+			const builder = this._createAsyncModuleBuilder(moduleRef, importPromises);
+			await module._setup(builder);
 			if (importPromises.length > 0) await Promise.all(importPromises);
 		}
 	}
 	_createModuleBuilder(moduleRef) {
 		return {
-			bind: (t) => this._createBindToBuilder(t, moduleRef),
-			import: (...mods) => {
-				this._loadSyncModules(mods);
+			bind: (token) => this._createBindToBuilder(token, moduleRef),
+			import: (...modules) => {
+				this._loadSyncModules(modules);
 			}
 		};
 	}
 	_createAsyncModuleBuilder(moduleRef, importPromises) {
 		return {
-			bind: (t) => this._createBindToBuilder(t, moduleRef),
-			import: (...mods) => {
-				for (const mod of mods) importPromises.push(this._loadOneModuleAsync(mod));
+			bind: (token) => this._createBindToBuilder(token, moduleRef),
+			import: (...modules) => {
+				for (const module of modules) importPromises.push(this._loadOneModuleAsync(module));
 			}
 		};
 	}
 	unload(...modules) {
 		this._assertNotDisposed();
-		for (const mod of modules) this._unloadModuleSync(mod);
+		for (const module of modules) this._unloadModuleSync(module);
 	}
 	_unloadModuleSync(ref) {
 		const count = this._moduleRefs.get(ref) ?? 0;
@@ -229,7 +229,7 @@ var DefaultContainer = class DefaultContainer {
 	}
 	async unloadAsync(...modules) {
 		this._assertNotDisposed();
-		for (const mod of modules) await this._unloadModuleAsync(mod);
+		for (const module of modules) await this._unloadModuleAsync(module);
 	}
 	async _unloadModuleAsync(ref) {
 		const count = this._moduleRefs.get(ref) ?? 0;
@@ -254,10 +254,10 @@ var DefaultContainer = class DefaultContainer {
 		this._assertNotDisposed();
 		const entries = registry.entries();
 		for (const { target, scope } of entries) {
-			const bb = this._createBindToBuilder(target).toSelf();
-			if (scope === "singleton") bb.singleton();
-			else if (scope === "scoped") bb.scoped();
-			else bb.transient();
+			const bindingBuilder = this._createBindToBuilder(target).toSelf();
+			if (scope === "singleton") bindingBuilder.singleton();
+			else if (scope === "scoped") bindingBuilder.scoped();
+			else bindingBuilder.transient();
 		}
 		return entries.length;
 	}
@@ -323,7 +323,7 @@ var DefaultContainer = class DefaultContainer {
 			if (effectiveBindingScope(binding) === "singleton" && !this._scope.hasSingleton(binding.id)) {
 				if (binding.predicate !== void 0) continue;
 				if (binding.kind === "constant" && binding.onActivation === void 0) continue;
-				const slotHint = slotKeyToResolveOptions(binding.slot);
+				const slotHint = bindingSlotToResolveOptions(binding.slot);
 				await this.resolveAsync(binding.token, slotHint);
 			}
 		}
@@ -407,7 +407,7 @@ var DefaultContainer = class DefaultContainer {
 			const meta = reader.getConstructorMetadata(binding.target);
 			if (meta === void 0) return edges;
 			for (const param of meta.params) {
-				const paramHint = injectableSlotToResolveOptions(param);
+				const paramHint = injectionSlotToResolveOptions(param);
 				if (param.optional) continue;
 				const tokenRef = param.token;
 				if (param.multi) {
@@ -426,7 +426,7 @@ var DefaultContainer = class DefaultContainer {
 			return edges;
 		}
 		if (binding.kind === "resolved" || binding.kind === "resolved-async") for (const dep of binding.deps) {
-			const depHint = injectableSlotToResolveOptions(dep);
+			const depHint = injectionSlotToResolveOptions(dep);
 			if (dep.optional) continue;
 			const tokenRef = dep.token;
 			if (dep.multi) {
@@ -478,7 +478,7 @@ function updateSlotTag(slot, tag, value) {
 		tags: existing
 	};
 }
-var BindToBuilderImpl = class {
+var BindingEntry = class {
 	_token;
 	_commit;
 	constructor(_token, _commit) {
@@ -486,7 +486,7 @@ var BindToBuilderImpl = class {
 		this._commit = _commit;
 	}
 	to(type) {
-		return new BindingBuilderImpl(this._token, {
+		return new ConstraintBuilder(this._token, {
 			kind: "class",
 			target: type,
 			scope: "transient"
@@ -494,32 +494,32 @@ var BindToBuilderImpl = class {
 	}
 	toSelf() {
 		if (typeof this._token !== "function") throw new Error("toSelf() requires token to be a Constructor");
-		return new BindingBuilderImpl(this._token, {
+		return new ConstraintBuilder(this._token, {
 			kind: "class",
 			target: this._token,
 			scope: "transient"
 		}, this._commit);
 	}
 	toConstantValue(value) {
-		return new ConstantBindingBuilderImpl(this._token, value, this._commit);
+		return new ConstantBuilder(this._token, value, this._commit);
 	}
 	toDynamic(factory) {
-		return new BindingBuilderImpl(this._token, {
+		return new ConstraintBuilder(this._token, {
 			kind: "dynamic",
 			factory,
 			scope: "transient"
 		}, this._commit);
 	}
 	toDynamicAsync(factory) {
-		return new BindingBuilderImpl(this._token, {
+		return new ConstraintBuilder(this._token, {
 			kind: "dynamic-async",
 			factory,
 			scope: "transient"
 		}, this._commit);
 	}
 	toResolved(factory, deps) {
-		const normalizedDeps = deps.map((d) => normalizeToDescriptor(d));
-		return new BindingBuilderImpl(this._token, {
+		const normalizedDeps = deps.map((dependency) => normalizeToDescriptor(dependency));
+		return new ConstraintBuilder(this._token, {
 			kind: "resolved",
 			factory,
 			deps: normalizedDeps,
@@ -527,8 +527,8 @@ var BindToBuilderImpl = class {
 		}, this._commit);
 	}
 	toResolvedAsync(factory, deps) {
-		const normalizedDeps = deps.map((d) => normalizeToDescriptor(d));
-		return new BindingBuilderImpl(this._token, {
+		const normalizedDeps = deps.map((dependency) => normalizeToDescriptor(dependency));
+		return new ConstraintBuilder(this._token, {
 			kind: "resolved-async",
 			factory,
 			deps: normalizedDeps,
@@ -536,10 +536,10 @@ var BindToBuilderImpl = class {
 		}, this._commit);
 	}
 	toAlias(target) {
-		return new AliasBindingBuilderImpl(this._token, target, this._commit);
+		return new AliasBuilder(this._token, target, this._commit);
 	}
 };
-var BindingBuilderImpl = class {
+var ConstraintBuilder = class {
 	_token;
 	_partial;
 	_commit;
@@ -551,7 +551,7 @@ var BindingBuilderImpl = class {
 		this._partial = _partial;
 		this._commit = _commit;
 		this._slot = {
-			...DEFAULT_SLOT,
+			...DEFAULT_BINDING_SLOT,
 			tags: []
 		};
 		this._doCommit();
@@ -591,7 +591,7 @@ var BindingBuilderImpl = class {
 	singleton() {
 		const previousId = this._committed;
 		this._committed = void 0;
-		return new ScopeBuilderImpl(this._token, {
+		return new ScopeBuilder(this._token, {
 			...this._partial,
 			scope: "singleton"
 		}, this._slot, this._predicate, this._commit, "singleton", previousId);
@@ -599,7 +599,7 @@ var BindingBuilderImpl = class {
 	transient() {
 		const previousId = this._committed;
 		this._committed = void 0;
-		return new ScopeBuilderImpl(this._token, {
+		return new ScopeBuilder(this._token, {
 			...this._partial,
 			scope: "transient"
 		}, this._slot, this._predicate, this._commit, "transient", previousId);
@@ -607,7 +607,7 @@ var BindingBuilderImpl = class {
 	scoped() {
 		const previousId = this._committed;
 		this._committed = void 0;
-		return new ScopeBuilderImpl(this._token, {
+		return new ScopeBuilder(this._token, {
 			...this._partial,
 			scope: "scoped"
 		}, this._slot, this._predicate, this._commit, "scoped", previousId);
@@ -616,7 +616,7 @@ var BindingBuilderImpl = class {
 		return this._committed;
 	}
 };
-var ScopeBuilderImpl = class {
+var ScopeBuilder = class {
 	_token;
 	_partial;
 	_slot;
@@ -664,7 +664,7 @@ var ScopeBuilderImpl = class {
 		return this._committed;
 	}
 };
-var ConstantBindingBuilderImpl = class {
+var ConstantBuilder = class {
 	_token;
 	_value;
 	_commit;
@@ -678,7 +678,7 @@ var ConstantBindingBuilderImpl = class {
 		this._value = _value;
 		this._commit = _commit;
 		this._slot = {
-			...DEFAULT_SLOT,
+			...DEFAULT_BINDING_SLOT,
 			tags: []
 		};
 		this._doCommit();
@@ -733,7 +733,7 @@ var ConstantBindingBuilderImpl = class {
 		return this._committed;
 	}
 };
-var AliasBindingBuilderImpl = class {
+var AliasBuilder = class {
 	_token;
 	_target;
 	_commit;
@@ -745,7 +745,7 @@ var AliasBindingBuilderImpl = class {
 		this._target = _target;
 		this._commit = _commit;
 		this._slot = {
-			...DEFAULT_SLOT,
+			...DEFAULT_BINDING_SLOT,
 			tags: []
 		};
 		this._doCommit();

package/dist/decorators/inject.d.mts

@@ -30,7 +30,7 @@ declare function isInjectionDescriptor(value: unknown): value is InjectionDescri
 /**
  * @since 0.3.16-canary.0
  */
-declare function normalizeToDescriptor(dep: InjectableDependency): InjectionDescriptor;
+declare function normalizeToDescriptor(dependency: InjectableDependency): InjectionDescriptor;
 type ClassAccessorDecorator<This, Value> = (target: ClassAccessorDecoratorTarget<This, Value>, context: ClassAccessorDecoratorContext<This, Value>) => ClassAccessorDecoratorResult<This, Value> | void;
 /**
  * @since 0.3.16-canary.0

package/dist/decorators/inject.mjs

@@ -1,6 +1,6 @@
 import { InternalError, MissingContainerContextError } from "../errors.mjs";
 import { getActiveContainer } from "../environment.mjs";
-import { injectableSlotToResolveOptions } from "../resolve-options.mjs";
+import { injectionSlotToResolveOptions } from "../resolve-options.mjs";
 import { INJECT_ACCESSOR_KEY, accessorMetadataByMetadataObjectMap } from "../metadata/metadata-keys.mjs";
 //#region src/decorators/inject.ts
 /**
@@ -15,10 +15,10 @@ function isInjectionDescriptor(value) {
 /**
 * @since 0.3.16-canary.0
 */
-function normalizeToDescriptor(dep) {
-	if (isInjectionDescriptor(dep)) return materializeInjectionDescriptor(dep);
+function normalizeToDescriptor(dependency) {
+	if (isInjectionDescriptor(dependency)) return materializeInjectionDescriptor(dependency);
 	return {
-		token: dep,
+		token: dependency,
 		optional: false,
 		multi: false
 	};
@@ -27,9 +27,9 @@ function normalizeToDescriptor(dep) {
 * Dual-role `inject()` values are functions: [[Function]].name must not be treated as a DI slot name.
 * Only enumerable own `name` / `tags` from `Object.defineProperties` are real injection options.
 */
-function materializeInjectionDescriptor(dep) {
-	if (typeof dep !== "function") return dep;
-	const dualRole = dep;
+function materializeInjectionDescriptor(dependency) {
+	if (typeof dependency !== "function") return dependency;
+	const dualRole = dependency;
 	const base = {
 		token: dualRole.token,
 		optional: dualRole.optional,
@@ -92,7 +92,7 @@ function inject(token, options) {
 		context.addInitializer(function() {
 			const container = getActiveContainer();
 			if (container === void 0) throw new MissingContainerContextError(String(context.name));
-			const hint = options === void 0 ? void 0 : injectableSlotToResolveOptions({
+			const hint = options === void 0 ? void 0 : injectionSlotToResolveOptions({
 				...options.name !== void 0 ? { name: options.name } : {},
 				...options.tags !== void 0 ? { tags: options.tags } : {}
 			});