@codefast/di 0.3.16-canary.2 → 0.4.0-canary.4

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

@@ -1,5 +1,6 @@
 import { Constructor } from "../constructor-type.mjs";
 import { Token } from "../token.mjs";
+import { InjectionDescriptor } from "../decorators/inject.mjs";
 
 //#region src/metadata/metadata-types.d.ts
 /**
@@ -41,6 +42,10 @@ interface MutableLifecycleMetadata {
 interface MetadataReader {
   getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
   getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
+  getAccessorMetadata?(target: Constructor): ReadonlyArray<{
+    readonly key: string | symbol;
+    readonly descriptor: InjectionDescriptor;
+  }> | undefined;
 }
 //#endregion
 export { ConstructorMetadata, LifecycleMetadata, MetadataReader, MutableLifecycleMetadata, ParamMetadata };

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

@@ -7,6 +7,7 @@ import { ConstructorMetadata, LifecycleMetadata, MetadataReader } from "./metada
  * @since 0.3.16-canary.0
  */
 declare class SymbolMetadataReader implements MetadataReader {
+  private _getMetadataRecord;
   getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
   getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
   getAccessorMetadata(target: Constructor): Array<{

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

@@ -1,46 +1,24 @@
-import { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, accessorMetadataByConstructorMap, accessorMetadataByMetadataObjectMap, constructorMetadataMap, lifecycleByConstructorMetadataMap, lifecycleMetadataMap } from "./metadata-keys.mjs";
+import { INJECTABLE_KEY, INJECT_ACCESSOR_KEY, LIFECYCLE_KEY, METADATA_SYMBOL } from "./metadata-keys.mjs";
 //#region src/metadata/symbol-metadata-reader.ts
 /**
 * @since 0.3.16-canary.0
 */
 var SymbolMetadataReader = class {
+	_getMetadataRecord(target, key) {
+		const descriptor = Object.getOwnPropertyDescriptor(target, METADATA_SYMBOL);
+		if (descriptor === void 0) return;
+		const record = descriptor.value;
+		if (!record || typeof record !== "object" || !Object.hasOwn(record, key)) return;
+		return record;
+	}
 	getConstructorMetadata(target) {
-		const weakMapMetadata = constructorMetadataMap.get(target);
-		if (weakMapMetadata !== void 0) return weakMapMetadata;
-		const metadataDescriptor = Object.getOwnPropertyDescriptor(target, Symbol.metadata);
-		if (metadataDescriptor === void 0) return;
-		const metadataRecord = metadataDescriptor.value;
-		if (!metadataRecord || typeof metadataRecord !== "object" || !Object.hasOwn(metadataRecord, INJECTABLE_KEY)) return;
-		return metadataRecord[INJECTABLE_KEY];
+		return this._getMetadataRecord(target, INJECTABLE_KEY)?.[INJECTABLE_KEY];
 	}
 	getLifecycleMetadata(target) {
-		const lifecycleMetadataByConstructor = lifecycleByConstructorMetadataMap.get(target);
-		if (lifecycleMetadataByConstructor !== void 0) return lifecycleMetadataByConstructor;
-		const metadataDescriptor = Object.getOwnPropertyDescriptor(target, Symbol.metadata);
-		if (metadataDescriptor !== void 0) {
-			const metadataRecord = metadataDescriptor.value;
-			if (metadataRecord && typeof metadataRecord === "object" && Object.hasOwn(metadataRecord, LIFECYCLE_KEY)) return metadataRecord[LIFECYCLE_KEY];
-		}
-		const classMetadataObject = target[Symbol.metadata];
-		if (classMetadataObject !== void 0) {
-			const weakMapMetadata = lifecycleMetadataMap.get(classMetadataObject);
-			if (weakMapMetadata !== void 0) return weakMapMetadata;
-		}
+		return this._getMetadataRecord(target, LIFECYCLE_KEY)?.[LIFECYCLE_KEY];
 	}
 	getAccessorMetadata(target) {
-		const byConstructor = accessorMetadataByConstructorMap.get(target);
-		if (byConstructor !== void 0) return byConstructor;
-		const metadataObject = target[Symbol.metadata];
-		if (metadataObject !== void 0) {
-			const fromWeakMap = accessorMetadataByMetadataObjectMap.get(metadataObject);
-			if (fromWeakMap !== void 0) return fromWeakMap;
-		}
-		const metadataDescriptor = Object.getOwnPropertyDescriptor(target, Symbol.metadata);
-		if (metadataDescriptor === void 0) return;
-		const metadataRecord = metadataDescriptor.value;
-		if (!metadataRecord || typeof metadataRecord !== "object") return;
-		if (!Object.hasOwn(metadataRecord, INJECT_ACCESSOR_KEY)) return;
-		return metadataRecord[INJECT_ACCESSOR_KEY];
+		return this._getMetadataRecord(target, INJECT_ACCESSOR_KEY)?.[INJECT_ACCESSOR_KEY];
 	}
 };
 /**

package/dist/module.mjs

@@ -36,7 +36,7 @@ const Module = {
 * @since 0.3.16-canary.0
 */
 function isSyncModule(module) {
-	return module[SYNC_MODULE_BRAND] === true;
+	return module[SYNC_MODULE_BRAND];
 }
 //#endregion
 export { AsyncModule, Module, SyncModule, isSyncModule };

package/dist/registry.mjs

@@ -12,11 +12,7 @@ var BindingRegistry = class {
 	/** Add or replace binding using slot-aware last-wins. */
 	add(binding) {
 		const key = binding.token;
-		let bindingsForToken = this._bindings.get(key);
-		if (bindingsForToken === void 0) {
-			bindingsForToken = [];
-			this._bindings.set(key, bindingsForToken);
-		}
+		const bindingsForToken = this._bindings.getOrInsert(key, []);
 		if (!this._isPurePredicateBinding(binding)) {
 			const existingIndex = bindingsForToken.findIndex((candidate) => !this._isPurePredicateBinding(candidate) && bindingSlotEquals(candidate.slot, binding.slot));
 			if (existingIndex !== -1) {
@@ -110,17 +106,7 @@ var BindingRegistry = class {
 		const slot = binding.slot;
 		if (slot.name !== void 0 || slot.tags.length !== 1 || binding.predicate !== void 0) return;
 		const [tagKey, tagValue] = slot.tags[0];
-		let byTagKey = this._simpleTagged.get(tokenKey);
-		if (byTagKey === void 0) {
-			byTagKey = /* @__PURE__ */ new Map();
-			this._simpleTagged.set(tokenKey, byTagKey);
-		}
-		let byTagValue = byTagKey.get(tagKey);
-		if (byTagValue === void 0) {
-			byTagValue = /* @__PURE__ */ new Map();
-			byTagKey.set(tagKey, byTagValue);
-		}
-		byTagValue.set(tagValue, binding);
+		this._simpleTagged.getOrInsert(tokenKey, /* @__PURE__ */ new Map()).getOrInsert(tagKey, /* @__PURE__ */ new Map()).set(tagValue, binding);
 	}
 	_deindexSimpleTaggedBinding(tokenKey, binding) {
 		const slot = binding.slot;
@@ -147,12 +133,7 @@ var BindingRegistry = class {
 	_indexSimpleNamedBinding(tokenKey, binding) {
 		const slot = binding.slot;
 		if (slot.name === void 0 || slot.tags.length > 0) return;
-		let bindingsByName = this._simpleNamed.get(tokenKey);
-		if (bindingsByName === void 0) {
-			bindingsByName = /* @__PURE__ */ new Map();
-			this._simpleNamed.set(tokenKey, bindingsByName);
-		}
-		bindingsByName.set(slot.name, binding);
+		this._simpleNamed.getOrInsert(tokenKey, /* @__PURE__ */ new Map()).set(slot.name, binding);
 	}
 	_deindexSimpleNamedBinding(tokenKey, binding) {
 		const slot = binding.slot;

package/dist/resolve-options.d.mts

@@ -1,4 +1,4 @@
-import { ResolveOptions } from "./types.mjs";
+import { BindingTag, ResolveOptions } from "./types.mjs";
 import { BindingSlot } from "./binding.mjs";
 
 //#region src/resolve-options.d.ts
@@ -10,7 +10,7 @@ import { BindingSlot } from "./binding.mjs";
  */
 declare function injectionSlotToResolveOptions(injectionSlot: {
   readonly name?: string;
-  readonly tags?: ReadonlyArray<readonly [string, unknown]>;
+  readonly tags?: ReadonlyArray<BindingTag>;
 }): ResolveOptions | undefined;
 /**
  * Hint from a binding {@link BindingSlot} (tags may be empty; omits when nothing to match).

package/dist/resolve-options.mjs

@@ -1,4 +1,12 @@
 //#region src/resolve-options.ts
+/** Shared core: build a ResolveOptions from already-normalised name + tags. */
+function buildOptions(name, tags) {
+	if (name === void 0 && tags === void 0) return;
+	const options = {};
+	if (name !== void 0) options.name = name;
+	if (tags !== void 0) options.tags = tags;
+	return options;
+}
 /**
 * Builds a {@link ResolveOptions} safe for `exactOptionalPropertyTypes`:
 * omits keys instead of assigning `undefined`.
@@ -6,10 +14,7 @@
 * @since 0.3.16-canary.0
 */
 function injectionSlotToResolveOptions(injectionSlot) {
-	const options = {};
-	if (injectionSlot.name !== void 0) options.name = injectionSlot.name;
-	if (injectionSlot.tags !== void 0) options.tags = injectionSlot.tags;
-	return options.name !== void 0 || options.tags !== void 0 ? options : void 0;
+	return buildOptions(injectionSlot.name, injectionSlot.tags);
 }
 /**
 * Hint from a binding {@link BindingSlot} (tags may be empty; omits when nothing to match).
@@ -17,10 +22,7 @@ function injectionSlotToResolveOptions(injectionSlot) {
 * @since 0.3.16-canary.0
 */
 function bindingSlotToResolveOptions(bindingSlot) {
-	const options = {};
-	if (bindingSlot.name !== void 0) options.name = bindingSlot.name;
-	if (bindingSlot.tags.length > 0) options.tags = bindingSlot.tags;
-	return options.name !== void 0 || options.tags !== void 0 ? options : void 0;
+	return buildOptions(bindingSlot.name, bindingSlot.tags.length > 0 ? bindingSlot.tags : void 0);
 }
 //#endregion
 export { bindingSlotToResolveOptions, injectionSlotToResolveOptions };

package/dist/resolver.d.mts

@@ -2,9 +2,9 @@ import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
 import { ResolutionFrame, ResolveOptions } from "./types.mjs";
 import { Binding } from "./binding.mjs";
+import { MetadataReader } from "./metadata/metadata-types.mjs";
 import { BindingRegistry } from "./registry.mjs";
 import { ScopeManager } from "./scope.mjs";
-import { MetadataReader } from "./metadata/metadata-types.mjs";
 import { Container } from "./container.mjs";
 import { LifecycleManager } from "./lifecycle.mjs";
 
@@ -82,6 +82,11 @@ declare class DependencyResolver {
   private _getResolutionFrame;
   private _needsActivation;
   private _refreshClassPostConstructCache;
+  /**
+   * Refreshes the post-construct cache for class bindings on first instantiation and
+   * returns the (possibly updated) shouldActivate flag.
+   */
+  private _refreshActivationCacheIfNeeded;
   private _requiresResolutionContext;
   private _acquireSyncResolutionContext;
 }

package/dist/resolver.mjs

@@ -176,13 +176,7 @@ var DependencyResolver = class {
 		try {
 			const resolutionCtx = needsActivation || this._requiresResolutionContext(binding) ? this._acquireSyncResolutionContext(resolutionPath, resolutionStack, hint) : void 0;
 			const instance = this._instantiateSync(binding, resolutionCtx, resolutionPath, resolutionStack);
-			let shouldActivate = needsActivation;
-			if (binding.kind === "class" && this._classHasPostConstruct.get(binding.target) === void 0) {
-				this._refreshClassPostConstructCache(binding.target);
-				this._activationNeedByBindingId.delete(binding.id);
-				shouldActivate = this._needsActivation(binding);
-			}
-			const activated = shouldActivate ? this._lifecycle.runActivationSync(resolutionCtx, binding, instance, this._metadataReader) : instance;
+			const activated = this._refreshActivationCacheIfNeeded(binding, needsActivation) ? this._lifecycle.runActivationSync(resolutionCtx, binding, instance, this._metadataReader) : instance;
 			if (scope === "singleton") this._scope.setSingleton(binding.id, activated);
 			else if (scope === "scoped") this._scope.setScoped(binding.id, activated);
 			return activated;
@@ -351,13 +345,7 @@ var DependencyResolver = class {
 			if (scope === "singleton") {
 				const createSingletonPromise = async () => {
 					const instance = await this._instantiateAsync(binding, resolutionCtx, resolutionPath, resolutionStack);
-					let shouldActivate = needsActivation;
-					if (binding.kind === "class" && this._classHasPostConstruct.get(binding.target) === void 0) {
-						this._refreshClassPostConstructCache(binding.target);
-						this._activationNeedByBindingId.delete(binding.id);
-						shouldActivate = this._needsActivation(binding);
-					}
-					const activated = shouldActivate ? await this._lifecycle.runActivation(resolutionCtx, binding, instance, this._metadataReader) : instance;
+					const activated = this._refreshActivationCacheIfNeeded(binding, needsActivation) ? await this._lifecycle.runActivation(resolutionCtx, binding, instance, this._metadataReader) : instance;
 					this._scope.setSingleton(binding.id, activated);
 					this._scope.clearInflight(binding.id);
 					return activated;
@@ -370,13 +358,7 @@ var DependencyResolver = class {
 				return await singletonPromise;
 			}
 			const instance = await this._instantiateAsync(binding, resolutionCtx, resolutionPath, resolutionStack);
-			let shouldActivate = needsActivation;
-			if (binding.kind === "class" && this._classHasPostConstruct.get(binding.target) === void 0) {
-				this._refreshClassPostConstructCache(binding.target);
-				this._activationNeedByBindingId.delete(binding.id);
-				shouldActivate = this._needsActivation(binding);
-			}
-			const activated = shouldActivate ? await this._lifecycle.runActivation(resolutionCtx, binding, instance, this._metadataReader) : instance;
+			const activated = this._refreshActivationCacheIfNeeded(binding, needsActivation) ? await this._lifecycle.runActivation(resolutionCtx, binding, instance, this._metadataReader) : instance;
 			if (scope === "scoped") this._scope.setScoped(binding.id, activated);
 			return activated;
 		} finally {
@@ -754,6 +736,18 @@ var DependencyResolver = class {
 		const hasPostConstruct = lifecycle !== void 0 && lifecycle.postConstruct !== void 0 && lifecycle.postConstruct.length > 0;
 		this._classHasPostConstruct.set(target, hasPostConstruct);
 	}
+	/**
+	* Refreshes the post-construct cache for class bindings on first instantiation and
+	* returns the (possibly updated) shouldActivate flag.
+	*/
+	_refreshActivationCacheIfNeeded(binding, needsActivation) {
+		if (binding.kind === "class" && this._classHasPostConstruct.get(binding.target) === void 0) {
+			this._refreshClassPostConstructCache(binding.target);
+			this._activationNeedByBindingId.delete(binding.id);
+			return this._needsActivation(binding);
+		}
+		return needsActivation;
+	}
 	_requiresResolutionContext(binding) {
 		return binding.kind === "dynamic" || binding.kind === "dynamic-async";
 	}

package/dist/types.d.mts

@@ -2,6 +2,12 @@ import { Constructor } from "./constructor-type.mjs";
 import { Token } from "./token.mjs";
 
 //#region src/types.d.ts
+/**
+ * A single [tag, value] pair used in slot constraints and resolve hints.
+ *
+ * @since 0.3.16-canary.0
+ */
+type BindingTag = readonly [tag: string, value: unknown];
 /**
  * Token or class constructor used as a binding / injection / resolve key.
  *
@@ -40,8 +46,8 @@ interface ResolveOptions {
    * Single-tag shorthand — semantics match including one pair in `tags`.
    * Enables fast-path lookup alongside `tags`.
    */
-  tag?: readonly [tag: string, value: unknown];
-  tags?: ReadonlyArray<readonly [tag: string, value: unknown]>;
+  tag?: BindingTag;
+  tags?: ReadonlyArray<BindingTag>;
 }
 /**
  * @since 0.3.16-canary.0
@@ -53,7 +59,7 @@ interface ResolutionFrame {
   readonly kind: BindingKind;
   readonly slot: {
     readonly name: string | undefined;
-    readonly tags: ReadonlyArray<readonly [tag: string, value: unknown]>;
+    readonly tags: ReadonlyArray<BindingTag>;
   };
 }
 /**
@@ -83,4 +89,4 @@ interface ResolutionContext {
  */
 type TokenValue<Type> = Type extends Token<infer Value> ? Value : Type extends Constructor<infer Value> ? Value : never;
 //#endregion
-export { ActivationHandler, BindingIdentifier, BindingKind, BindingScope, ConstraintContext, type Constructor, DeactivationHandler, DependencyKey, ResolutionContext, ResolutionFrame, ResolveOptions, TokenValue };
+export { ActivationHandler, BindingIdentifier, BindingKind, BindingScope, BindingTag, ConstraintContext, type Constructor, DeactivationHandler, DependencyKey, ResolutionContext, ResolutionFrame, ResolveOptions, TokenValue };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/di",
-  "version": "0.3.16-canary.2",
+  "version": "0.4.0-canary.4",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -18,6 +18,7 @@
   },
   "files": [
     "dist",
+    "src",
     "CHANGELOG.md",
     "README.md",
     "LICENSE"
@@ -45,122 +46,147 @@
   },
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "types": "./dist/index.d.mts",
       "import": "./dist/index.mjs"
     },
     "./binding": {
+      "source": "./src/binding.ts",
       "types": "./dist/binding.d.mts",
       "import": "./dist/binding.mjs"
     },
     "./binding-scope": {
+      "source": "./src/binding-scope.ts",
       "types": "./dist/binding-scope.d.mts",
       "import": "./dist/binding-scope.mjs"
     },
     "./binding-select": {
+      "source": "./src/binding-select.ts",
       "types": "./dist/binding-select.d.mts",
       "import": "./dist/binding-select.mjs"
     },
     "./constraints": {
+      "source": "./src/constraints.ts",
       "types": "./dist/constraints.d.mts",
       "import": "./dist/constraints.mjs"
     },
     "./constructor-type": {
+      "source": "./src/constructor-type.ts",
       "types": "./dist/constructor-type.d.mts",
       "import": "./dist/constructor-type.mjs"
     },
     "./container": {
+      "source": "./src/container.ts",
       "types": "./dist/container.d.mts",
       "import": "./dist/container.mjs"
     },
     "./decorators/inject": {
+      "source": "./src/decorators/inject.ts",
       "types": "./dist/decorators/inject.d.mts",
       "import": "./dist/decorators/inject.mjs"
     },
     "./decorators/injectable": {
+      "source": "./src/decorators/injectable.ts",
       "types": "./dist/decorators/injectable.d.mts",
       "import": "./dist/decorators/injectable.mjs"
     },
     "./decorators/lifecycle-decorators": {
+      "source": "./src/decorators/lifecycle-decorators.ts",
       "types": "./dist/decorators/lifecycle-decorators.d.mts",
       "import": "./dist/decorators/lifecycle-decorators.mjs"
     },
     "./dependency-graph": {
+      "source": "./src/dependency-graph.ts",
       "types": "./dist/dependency-graph.d.mts",
       "import": "./dist/dependency-graph.mjs"
     },
     "./environment": {
+      "source": "./src/environment.ts",
       "types": "./dist/environment.d.mts",
       "import": "./dist/environment.mjs"
     },
     "./errors": {
+      "source": "./src/errors.ts",
       "types": "./dist/errors.d.mts",
       "import": "./dist/errors.mjs"
     },
     "./graph-adapters/cytoscape": {
+      "source": "./src/graph-adapters/cytoscape.ts",
       "types": "./dist/graph-adapters/cytoscape.d.mts",
       "import": "./dist/graph-adapters/cytoscape.mjs"
     },
     "./graph-adapters/dot": {
+      "source": "./src/graph-adapters/dot.ts",
       "types": "./dist/graph-adapters/dot.d.mts",
       "import": "./dist/graph-adapters/dot.mjs"
     },
     "./graph-adapters/reactflow": {
+      "source": "./src/graph-adapters/reactflow.ts",
       "types": "./dist/graph-adapters/reactflow.d.mts",
       "import": "./dist/graph-adapters/reactflow.mjs"
     },
-    "./graph-adapters/types": {
-      "types": "./dist/graph-adapters/types.d.mts",
-      "import": "./dist/graph-adapters/types.mjs"
-    },
     "./inspector": {
+      "source": "./src/inspector.ts",
       "types": "./dist/inspector.d.mts",
       "import": "./dist/inspector.mjs"
     },
     "./lifecycle": {
+      "source": "./src/lifecycle.ts",
       "types": "./dist/lifecycle.d.mts",
       "import": "./dist/lifecycle.mjs"
     },
     "./metadata/metadata-keys": {
+      "source": "./src/metadata/metadata-keys.ts",
       "types": "./dist/metadata/metadata-keys.d.mts",
       "import": "./dist/metadata/metadata-keys.mjs"
     },
     "./metadata/metadata-reader-token": {
+      "source": "./src/metadata/metadata-reader-token.ts",
       "types": "./dist/metadata/metadata-reader-token.d.mts",
       "import": "./dist/metadata/metadata-reader-token.mjs"
     },
     "./metadata/metadata-types": {
+      "source": "./src/metadata/metadata-types.ts",
       "types": "./dist/metadata/metadata-types.d.mts",
       "import": "./dist/metadata/metadata-types.mjs"
     },
     "./metadata/symbol-metadata-reader": {
+      "source": "./src/metadata/symbol-metadata-reader.ts",
       "types": "./dist/metadata/symbol-metadata-reader.d.mts",
       "import": "./dist/metadata/symbol-metadata-reader.mjs"
     },
     "./module": {
+      "source": "./src/module.ts",
       "types": "./dist/module.d.mts",
       "import": "./dist/module.mjs"
     },
     "./registry": {
+      "source": "./src/registry.ts",
       "types": "./dist/registry.d.mts",
       "import": "./dist/registry.mjs"
     },
     "./resolve-options": {
+      "source": "./src/resolve-options.ts",
       "types": "./dist/resolve-options.d.mts",
       "import": "./dist/resolve-options.mjs"
     },
     "./resolver": {
+      "source": "./src/resolver.ts",
       "types": "./dist/resolver.d.mts",
       "import": "./dist/resolver.mjs"
     },
     "./scope": {
+      "source": "./src/scope.ts",
       "types": "./dist/scope.d.mts",
       "import": "./dist/scope.mjs"
     },
     "./token": {
+      "source": "./src/token.ts",
       "types": "./dist/token.d.mts",
       "import": "./dist/token.mjs"
     },
     "./types": {
+      "source": "./src/types.ts",
       "types": "./dist/types.d.mts",
       "import": "./dist/types.mjs"
     },
@@ -170,20 +196,20 @@
     "access": "public"
   },
   "devDependencies": {
-    "@babel/plugin-proposal-decorators": "^7.29.0",
+    "@babel/plugin-proposal-decorators": "8.0.0-rc.6",
     "@rolldown/plugin-babel": "^0.2.3",
-    "@types/node": "^25.7.0",
-    "@typescript/native-preview": "7.0.0-dev.20260514.1",
-    "@vitest/coverage-v8": "^4.1.6",
+    "@types/node": "^25.9.2",
+    "@typescript/native-preview": "7.0.0-dev.20260604.1",
+    "@vitest/coverage-v8": "^4.1.8",
     "expect-type": "^1.3.0",
-    "tsdown": "^0.22.0",
-    "tsx": "^4.22.0",
+    "tsdown": "^0.22.2",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6",
-    "@codefast/typescript-config": "0.3.16-canary.2"
+    "vitest": "^4.1.8",
+    "@codefast/typescript-config": "0.4.0-canary.4"
   },
   "engines": {
-    "node": ">=22.0.0"
+    "node": ">=24.0.0"
   },
   "scripts": {
     "build": "tsdown",

package/src/binding-scope.ts

@@ -0,0 +1,26 @@
+import type { Binding } from "#/binding";
+import type { BindingScope } from "#/types";
+
+/**
+ * Runtime scope used for validation and introspection. Alias bindings are treated as transient
+ * because they defer scope to the aliased target at resolve time.
+ *
+ * @since 0.3.16-canary.0
+ */
+export function effectiveBindingScope(binding: Binding): BindingScope {
+  switch (binding.kind) {
+    case "alias":
+      return "transient";
+    case "class":
+    case "constant":
+    case "dynamic":
+    case "dynamic-async":
+    case "resolved":
+    case "resolved-async":
+      return binding.scope;
+    default: {
+      const exhaustive: never = binding;
+      return exhaustive;
+    }
+  }
+}