@codefast/di 0.10.0 → 0.10.1

package/dist/resolution/context.d.ts

@@ -1,7 +1,7 @@
 /** The `ResolutionContext` a factory is handed, and the callbacks the resolver answers it with. */
-import type { Token } from "#/core/token";
-import type { BindingIdentifier, BindingKind, BindingScope, ConstraintContext, Constructor, ResolutionFrame, ResolutionContext, ResolveOptions } from "#/core/types";
-import type { BranchDepth, OwnedBranchStack } from "#/resolution/path/resolution-path";
+import type { Token } from "#core/token";
+import type { BindingIdentifier, BindingKind, BindingScope, ConstraintContext, Constructor, ResolutionFrame, ResolutionContext, ResolveOptions } from "#core/types";
+import type { BranchDepth, OwnedBranchStack } from "#resolution/path/resolution-path";
 /**
  * The engine surface a resolution context calls back into to resolve further dependencies.
  *

package/dist/resolution/context.js

@@ -1,4 +1,4 @@
-import { UNOWNED_BRANCH } from "#/resolution/path/resolution-path";
+import { UNOWNED_BRANCH } from "#resolution/path/resolution-path";
 /**
  * The `ResolutionContext` handed to factories and hooks, backed by the engine's callbacks.
  *

package/dist/resolution/path/resolution-path.d.ts

@@ -1,4 +1,4 @@
-import type { BindingIdentifier, ResolutionFrame } from "#/core/types";
+import type { BindingIdentifier, ResolutionFrame } from "#core/types";
 /**
  * Where the cycle check switches from a linear frame scan to an attached Set.
  *

package/dist/resolution/path/resolution-path.js

@@ -1,5 +1,5 @@
 /** Cycle-detection bookkeeping carried on the resolution stack itself. */
-import { CircularDependencyError } from "#/errors/errors";
+import { CircularDependencyError } from "#errors/errors";
 const RESOLUTION_SET_KEY = Symbol("di:resolution-set");
 /**
  * Where the cycle check switches from a linear frame scan to an attached Set.

package/dist/resolution/plan/instantiation-plan.d.ts

@@ -4,11 +4,11 @@
  * @remarks A dependency the compiler cannot inline escapes to a resolver callback instead; the
  * closure must stay callable for it, which is what bounds what may be inlined.
  */
-import type { Binding } from "#/core/binding";
-import type { ConstructorInvocation } from "#/core/constructor-type";
-import type { Token } from "#/core/token";
-import type { Constructor, ResolutionFrame, ResolveOptions } from "#/core/types";
-import type { ConstructorMetadata } from "#/metadata/metadata-types";
+import type { Binding } from "#core/binding";
+import type { ConstructorInvocation } from "#core/constructor-type";
+import type { Token } from "#core/token";
+import type { Constructor, ResolutionFrame, ResolveOptions } from "#core/types";
+import type { ConstructorMetadata } from "#metadata/metadata-types";
 /**
  * Compilation asked to retry later (class lifecycle metadata not discovered yet).
  *

package/dist/resolution/plan/instantiation-plan.js

@@ -1,8 +1,8 @@
-import { NO_INSTANCE } from "#/core/binding";
-import { tokenName } from "#/core/token";
-import { AsyncResolutionError } from "#/errors/errors";
-import { injectionSlotToResolveOptions } from "#/injection/resolve-options";
-import { generateAsyncPlan, generatePlan, isPlanCodegenAvailable, PLAN_CODEGEN_THRESHOLD, } from "#/resolution/plan/plan-codegen";
+import { NO_INSTANCE } from "#core/binding";
+import { tokenName } from "#core/token";
+import { AsyncResolutionError } from "#errors/errors";
+import { injectionSlotToResolveOptions } from "#injection/resolve-options";
+import { generateAsyncPlan, generatePlan, isPlanCodegenAvailable, PLAN_CODEGEN_THRESHOLD, } from "#resolution/plan/plan-codegen";
 // Past this depth a dependency escapes to the runtime path rather than inlining further —
 // compiled closures nest one JS frame per level, and pathological graphs are the runtime's job.
 const PLAN_DEPTH_LIMIT = 32;

package/dist/resolution/plan/plan-codegen.d.ts

@@ -1,10 +1,10 @@
 /**
  * Generates a hot instantiation plan as a function of its own, so its call sites answer for one plan only.
  */
-import type { Binding } from "#/core/binding";
-import type { ConstructorInvocation } from "#/core/constructor-type";
+import type { Binding } from "#core/binding";
+import type { ConstructorInvocation } from "#core/constructor-type";
 /**
- * Runs a plan's closure makes before the plan is generated as its own function.
+ * The number of runs a plan's closure makes before the plan is generated as its own function.
  *
  * @remarks Below it a plan stays a closure, which is all a cold container or a per-request child
  * ever runs; above it a plan pays one compile for call sites nothing else feeds.

package/dist/resolution/plan/plan-codegen.js

@@ -1,6 +1,6 @@
-import { NO_INSTANCE } from "#/core/binding";
+import { NO_INSTANCE } from "#core/binding";
 /**
- * Runs a plan's closure makes before the plan is generated as its own function.
+ * The number of runs a plan's closure makes before the plan is generated as its own function.
  *
  * @remarks Below it a plan stays a closure, which is all a cold container or a per-request child
  * ever runs; above it a plan pays one compile for call sites nothing else feeds.

package/dist/resolution/resolver.d.ts

@@ -1,15 +1,15 @@
-import type { Container } from "#/container/container";
-import type { Binding } from "#/core/binding";
-import type { BindingRegistry } from "#/core/registry";
-import type { Token } from "#/core/token";
-import type { BindingTag, Constructor, ResolutionFrame, ResolveOptions } from "#/core/types";
-import type { ResolutionDiagnostics } from "#/errors/diagnostics";
-import type { LifecycleManager } from "#/lifecycle/lifecycle-manager";
-import type { ScopeManager } from "#/lifecycle/scope-manager";
-import type { MetadataReader } from "#/metadata/metadata-types";
-import type { DefaultLookupEntry } from "#/resolution/cache/binding-lookup-cache";
-import type { ResolverCallbacks } from "#/resolution/context";
-import type { BranchDepth } from "#/resolution/path/resolution-path";
+import type { Container } from "#container/container";
+import type { Binding } from "#core/binding";
+import type { BindingRegistry } from "#core/registry";
+import type { Token } from "#core/token";
+import type { BindingTag, Constructor, ResolutionFrame, ResolveOptions } from "#core/types";
+import type { ResolutionDiagnostics } from "#errors/diagnostics";
+import type { LifecycleManager } from "#lifecycle/lifecycle-manager";
+import type { ScopeManager } from "#lifecycle/scope-manager";
+import type { MetadataReader } from "#metadata/metadata-types";
+import type { DefaultLookupEntry } from "#resolution/cache/binding-lookup-cache";
+import type { ResolverCallbacks } from "#resolution/context";
+import type { BranchDepth } from "#resolution/path/resolution-path";
 /**
  * The resolution engine driving binding selection, instantiation, scoping, and lifecycle hooks.
  *

package/dist/resolution/resolver.js

@@ -1,16 +1,16 @@
-import { NO_INSTANCE } from "#/core/binding";
-import { NO_TAG_KEYS, slotNameCriterionOf } from "#/core/tag";
-import { tokenName } from "#/core/token";
-import { AsyncActivationError, AsyncResolutionError, CircularDependencyError, DisposedContainerError, InternalError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, TokenNotBoundError, } from "#/errors/errors";
-import { loneTagBesideNameOf, resolveOptionsForSlot, singleCriterionForSlot, singleCriterionOnlyOf, } from "#/injection/resolve-options";
-import { SCOPED_MISS } from "#/lifecycle/scope-manager";
-import { ActivationNeedCache } from "#/resolution/cache/activation-need";
-import { BindingLookupCache } from "#/resolution/cache/binding-lookup-cache";
-import { ClassIntrospector } from "#/resolution/cache/class-introspector";
-import { AsyncCascadeContext, AsyncLevelContext, buildResolutionFrame, DefaultResolutionContext, } from "#/resolution/context";
-import { branchDepthOf, cycleNamesOf, enterResolutionPath, extendResolutionBranch, ROOT_BRANCH, UNOWNED_BRANCH, } from "#/resolution/path/resolution-path";
-import { InstantiationPlanCompiler, PLAN_RETRY } from "#/resolution/plan/instantiation-plan";
-import { matchesSlot, requestedTagKeyMask, selectAllBindings, selectBinding } from "#/resolution/select/binding-select";
+import { NO_INSTANCE } from "#core/binding";
+import { NO_TAG_KEYS, slotNameCriterionOf } from "#core/tag";
+import { tokenName } from "#core/token";
+import { AsyncActivationError, AsyncResolutionError, CircularDependencyError, DisposedContainerError, InternalError, MissingMetadataError, MissingScopeContextError, NoMatchingBindingError, TokenNotBoundError, } from "#errors/errors";
+import { loneTagBesideNameOf, resolveOptionsForSlot, singleCriterionForSlot, singleCriterionOnlyOf, } from "#injection/resolve-options";
+import { SCOPED_MISS } from "#lifecycle/scope-manager";
+import { ActivationNeedCache } from "#resolution/cache/activation-need";
+import { BindingLookupCache } from "#resolution/cache/binding-lookup-cache";
+import { ClassIntrospector } from "#resolution/cache/class-introspector";
+import { AsyncCascadeContext, AsyncLevelContext, buildResolutionFrame, DefaultResolutionContext, } from "#resolution/context";
+import { branchDepthOf, cycleNamesOf, enterResolutionPath, extendResolutionBranch, ROOT_BRANCH, UNOWNED_BRANCH, } from "#resolution/path/resolution-path";
+import { InstantiationPlanCompiler, PLAN_RETRY } from "#resolution/plan/instantiation-plan";
+import { matchesSlot, requestedTagKeyMask, selectAllBindings, selectBinding } from "#resolution/select/binding-select";
 // Where a multi-tag resolve switches from scanning the token's list to walking the tag indexes.
 const MULTI_TAG_INDEX_THRESHOLD = 8;
 const EMPTY_STRING_LIST = [];
@@ -411,7 +411,12 @@ export class DependencyResolver {
     // that never resolves a class or a resolved factory never pays for the host.
     #planCompiler;
     #compiler() {
-        return (this.#planCompiler ??= new InstantiationPlanCompiler({
+        return (this.#planCompiler ??= new InstantiationPlanCompiler(this.#buildPlanCompilerHost()));
+    }
+    // The behaviour the plan compiler needs from this resolver — lookups, escapes, plan swaps, and the
+    // accessor construction path. Built once with the compiler, so each closure is allocated once.
+    #buildPlanCompilerHost() {
+        return {
             hasActivationHandlers: (binding) => this.#ownerOf(binding).#lifecycle.hasActivationHandlers(binding.token),
             knownPostConstruct: (target) => this.#classes.knownPostConstruct(target),
             needsActiveContainer: (target) => this.#classes.needsActiveContainer(target),
@@ -488,7 +493,7 @@ export class DependencyResolver {
                 }
                 return this.resolveAsync(token, options, resolutionStack, UNOWNED_BRANCH);
             },
-        }));
+        };
     }
     /** The async lane's plan for a statically-visible transient binding, mirroring the sync getter. */
     #getAsyncInstantiationPlan(binding) {
@@ -608,9 +613,12 @@ export class DependencyResolver {
             resolutionSet?.delete(frame.bindingId);
         }
     }
-    /** Path-continuing resolution handed to the ambient slot while an accessor class constructs. */
-    // The ambient resolution a top-level construction hands its accessors: the lent root stack is one
-    // array for the resolver's lifetime, so the pair of closures over it is built once and reused.
+    /**
+     * Path-continuing resolution handed to the ambient slot while an accessor class constructs.
+     *
+     * @remarks The lent root stack is one array for the resolver's lifetime, so the closure pair over
+     * it is built once and reused.
+     */
     #rootAmbientResolution;
     #ambientResolutionFor(resolutionStack) {
         if (resolutionStack === this.rootStack) {
@@ -1464,8 +1472,13 @@ export class DependencyResolver {
         return created;
     }
 }
-/** A constant whose value is its answer on every read: no own hook, and the caller has ruled out container hooks. */
-// A cached singleton reads like a constant until a registry change evicts it, which also drops the memo.
+/**
+ * Whether a binding answers a collection read with a fixed value: a hook-free constant, or a
+ * singleton whose instance is already cached.
+ *
+ * @remarks A cached singleton reads like a constant until a registry change evicts it, which also
+ * drops the memo.
+ */
 function isStableCollectionMember(binding) {
     if (binding.kind === "alias" || binding.activationHook !== undefined) {
         return false;

package/dist/resolution/select/binding-select.d.ts

@@ -1,9 +1,10 @@
-import type { Binding, BindingSlot } from "#/core/binding";
-import type { TagKeyMask } from "#/core/tag";
-import type { ConstraintContext, ResolveOptions } from "#/core/types";
+import type { Binding, BindingSlot } from "#core/binding";
+import type { TagKeyMask } from "#core/tag";
+import type { ConstraintContext, ResolveOptions } from "#core/types";
 /**
- * Selects a single candidate from a list of bindings using slot matching + predicates.
- * Returns undefined if no match, throws AmbiguousBindingError if multiple match.
+ * The single candidate a request selects from a list, by slot match then predicate.
+ *
+ * @remarks `undefined` when nothing matches; throws {@link AmbiguousBindingError} when several do.
  *
  * @since 0.3.16-canary.0
  */

package/dist/resolution/select/binding-select.js

@@ -1,8 +1,9 @@
-import { coversTagKeys, NO_TAG_KEYS, slotName, slotNameCriterionOf } from "#/core/tag";
-import { AmbiguousBindingError } from "#/errors/errors";
+import { coversTagKeys, NO_TAG_KEYS, slotName, slotNameCriterionOf } from "#core/tag";
+import { AmbiguousBindingError } from "#errors/errors";
 /**
- * Selects a single candidate from a list of bindings using slot matching + predicates.
- * Returns undefined if no match, throws AmbiguousBindingError if multiple match.
+ * The single candidate a request selects from a list, by slot match then predicate.
+ *
+ * @remarks `undefined` when nothing matches; throws {@link AmbiguousBindingError} when several do.
  *
  * @since 0.3.16-canary.0
  */

package/dist/resolution/select/constraints.d.ts

@@ -1,6 +1,6 @@
-import type { BindingTag } from "#/core/tag";
-import type { Token } from "#/core/token";
-import type { BindingConstraint, Constructor } from "#/core/types";
+import type { BindingTag } from "#core/tag";
+import type { Token } from "#core/token";
+import type { BindingConstraint, Constructor } from "#core/types";
 /**
  * Matches when the direct parent frame resolves the given token.
  *

package/dist/resolution/select/constraints.js

@@ -1,7 +1,7 @@
-import { requiringAncestorSlotName, requiringAncestorSlotNames } from "#/core/constraint-requirement";
-import { coversTagKeys, slotName, tagKeyMaskOf } from "#/core/tag";
-import { tokenName } from "#/core/token";
-import { EmptyTagCriteriaError } from "#/errors/errors";
+import { requiringAncestorSlotName, requiringAncestorSlotNames } from "#core/constraint-requirement";
+import { coversTagKeys, slotName, tagKeyMaskOf } from "#core/tag";
+import { tokenName } from "#core/token";
+import { EmptyTagCriteriaError } from "#errors/errors";
 /**
  * Matches when the direct parent frame resolves the given token.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@codefast/di",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Lightweight dependency injection primitives for Codefast",
   "keywords": [
     "codefast",
@@ -32,7 +32,7 @@
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "imports": {
-    "#/*": {
+    "#*": {
       "types": "./dist/*.d.ts",
       "default": "./dist/*.js"
     }
@@ -224,6 +224,6 @@
     "access": "public"
   },
   "engines": {
-    "node": ">=24.0.0"
+    "node": ">=22.12.0"
   }
 }