@codefast/di 0.11.0 → 0.13.0

package/dist/resolution/resolver.d.ts

@@ -3,13 +3,14 @@ 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 { NoMatchingBindingError, TokenNotBoundError } from "#errors";
+import type { ResolutionDiagnostics } from "#introspection/diagnostics";
+import type { LifecycleManager } from "#lifecycle/hooks";
+import type { ScopeManager } from "#lifecycle/scopes";
+import type { MetadataReader } from "#metadata/types";
+import type { DefaultLookupEntry } from "#resolution/cache/lookup";
 import type { ResolverCallbacks } from "#resolution/context";
-import type { BranchDepth } from "#resolution/path/resolution-path";
+import type { BranchDepth } from "#resolution/path";
 /**
  * The resolution engine driving binding selection, instantiation, scoping, and lifecycle hooks.
  *
@@ -39,6 +40,17 @@ export declare class DependencyResolver implements ResolverCallbacks {
      * Mirrors {@link DependencyResolver.resolveAll} candidate selection only (no instantiation).
      */
     peekCandidateBindingsForValidate(token: Token<unknown> | Constructor, options: ResolveOptions | undefined): ReadonlyArray<Binding>;
+    /**
+     * The error `resolve` raises for a request nothing selects, or `undefined` while a `when()` candidate leaves it open.
+     *
+     * @remarks A predicate reads the resolution path, which a static walk does not have, so a slot-matching candidate
+     * that carries one may still be selected when the request is really made.
+     */
+    missForValidate(token: Token<unknown> | Constructor, options: ResolveOptions | undefined, path: ReadonlyArray<string>): TokenNotBoundError | NoMatchingBindingError | undefined;
+    /** The resolver whose chain a binding this one can see resolves its dependencies from, as a singleton does. */
+    ownerForValidate(binding: Binding): DependencyResolver;
+    /** Deactivates a scoped instance of a binding this resolver owns, with its hooks and reader, when it owes a teardown. */
+    deactivateScoped(binding: Binding, instance: unknown): Promise<void> | undefined;
     resolveFromContext<Value>(token: Token<Value> | Constructor<Value>, resolutionStack: Array<ResolutionFrame>): Value;
     resolve<Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionStack: Array<ResolutionFrame>, precomputedCriterion?: BindingTag | null): Value;
     resolveOptional<Value>(token: Token<Value> | Constructor<Value>, options: ResolveOptions | undefined, resolutionStack: Array<ResolutionFrame>, precomputedCriterion?: BindingTag | null): Value | undefined;
@@ -51,7 +63,7 @@ export declare class DependencyResolver implements ResolverCallbacks {
      * shape it had; the container routes a top-level read with no options here.
      */
     resolveRootCollection<Value>(token: Token<Value> | Constructor<Value>): ReadonlyArray<Value>;
-    /** The async twin of `resolveRootCollection`: a stable value list settles at once, candidates fan out as usual. */
+    /** The async twin of `resolveRootCollection`: a stable value list answers at once, candidates fan out as usual. */
     resolveRootCollectionAsync<Value>(token: Token<Value> | Constructor<Value>): Promise<ReadonlyArray<Value>>;
     resolveAsyncFromContext<Value>(token: Token<Value> | Constructor<Value>, resolutionStack: Array<ResolutionFrame>, branchDepth: BranchDepth): Promise<Value>;
     /**