@codefast/di 0.5.0 → 0.6.1

package/dist/metadata/metadata-reader-token.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-reader-token.js","sourceRoot":"","sources":["../../src/metadata/metadata-reader-token.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGhC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0B,KAAK,CAAiB,gBAAgB,CAAC,CAAC"}
+{"version":3,"file":"metadata-reader-token.js","sourceRoot":"","sources":["../../src/metadata/metadata-reader-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAIrC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA0B,KAAK,CAAiB,gBAAgB,CAAC,CAAC"}

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

@@ -1,16 +1,16 @@
-import type { InjectionDescriptor } from "#/decorators/inject";
-import type { Token } from "#/token";
-import type { Constructor } from "#/types";
+import type { Constructor } from "#/core/types";
+import type { InjectionDescriptor } from "#/injection/descriptor";
+import type { DependencySlot } from "#/injection/resolve-options";
 /**
+ * One constructor parameter's declaration.
+ *
+ * @remarks Extends {@link DependencySlot} so the two dependency sources stay literally one shape
+ * rather than two that happen to match; `index` is the only thing a parameter adds.
+ *
  * @since 0.3.16-canary.0
  */
-export interface ParamMetadata {
+export interface ParamMetadata extends DependencySlot {
     readonly index: number;
-    readonly token: Token<unknown> | Constructor;
-    readonly optional: boolean;
-    readonly multi: boolean;
-    readonly name?: string;
-    readonly tags?: ReadonlyArray<readonly [string, unknown]>;
 }
 /**
  * @since 0.3.16-canary.0

package/dist/metadata/metadata-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAC3D;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7E,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzE,mBAAmB,CAAC,CAClB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC3G"}
+{"version":3,"file":"metadata-types.d.ts","sourceRoot":"","sources":["../../src/metadata/metadata-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,WAAW,aAAc,SAAQ,cAAc;IACnD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAC5C;AAED;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAAC;IAC7E,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACzE,mBAAmB,CAAC,CAClB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC,GAAG,SAAS,CAAC;CAC3G"}

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

@@ -1,20 +1,33 @@
-import type { InjectionDescriptor } from "#/decorators/inject";
+import type { Constructor } from "#/core/types";
+import type { InjectionDescriptor } from "#/injection/descriptor";
 import type { ConstructorMetadata, LifecycleMetadata, MetadataReader } from "#/metadata/metadata-types";
-import type { Constructor } from "#/types";
+type AccessorEntry = {
+    readonly key: string | symbol;
+    readonly descriptor: InjectionDescriptor;
+};
 /**
  * @since 0.3.16-canary.0
  */
 export declare class SymbolMetadataReader implements MetadataReader {
     #private;
     getConstructorMetadata(target: Constructor): ConstructorMetadata | undefined;
+    /**
+     * Lifecycle hooks aggregated over the base chain — an inherited hook method exists on the instance.
+     *
+     * @remarks `postConstruct` runs base first (a derived hook may rely on base state); `preDestroy`
+     * runs derived first, mirroring teardown. A method name repeated across levels runs once.
+     */
     getLifecycleMetadata(target: Constructor): LifecycleMetadata | undefined;
-    getAccessorMetadata(target: Constructor): Array<{
-        key: string | symbol;
-        descriptor: InjectionDescriptor;
-    }> | undefined;
+    /**
+     * Accessor injections aggregated over the base chain, base first — the order initializers run.
+     *
+     * @remarks Not deduplicated: a derived accessor shadowing a base one still runs both initializers.
+     */
+    getAccessorMetadata(target: Constructor): ReadonlyArray<AccessorEntry> | undefined;
 }
 /**
  * @since 0.3.16-canary.0
  */
 export declare const defaultMetadataReader: SymbolMetadataReader;
+export {};
 //# sourceMappingURL=symbol-metadata-reader.d.ts.map

package/dist/metadata/symbol-metadata-reader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"symbol-metadata-reader.d.ts","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AACxG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;;IAazD,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAG3E;IAED,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAGvE;IAED,mBAAmB,CACjB,MAAM,EAAE,WAAW,GAClB,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;QAAC,UAAU,EAAE,mBAAmB,CAAA;KAAE,CAAC,GAAG,SAAS,CAK9E;CACF;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,sBAA6B,CAAC"}
+{"version":3,"file":"symbol-metadata-reader.d.ts","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAElE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAExG,KAAK,aAAa,GAAG;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEjG;;GAEG;AACH,qBAAa,oBAAqB,YAAW,cAAc;;IAsCzD,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAE3E;IAED;;;;;OAKG;IACH,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CAmBvE;IAED;;;;OAIG;IACH,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAC,aAAa,CAAC,GAAG,SAAS,CAgBjF;CACF;AAiBD;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,oBAAiD,CAAC"}

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

@@ -3,29 +3,109 @@ import { INJECT_ACCESSOR_KEY, INJECTABLE_KEY, LIFECYCLE_KEY, METADATA_SYMBOL } f
  * @since 0.3.16-canary.0
  */
 export class SymbolMetadataReader {
-    #getMetadataRecord(target, key) {
+    // Merged chain answers, cached per class: decorator metadata cannot change once a class is defined.
+    #lifecycleByClass;
+    #accessorsByClass;
+    /**
+     * Whatever a decorator stored under `key` on this exact class, narrowed as far as the platform allows.
+     *
+     * @remarks Own-property only: an inherited `Symbol.metadata` belongs to the base class. Constructor
+     * metadata must not be borrowed (each class opts into its deps); the lifecycle and accessor readers
+     * walk the base chain themselves, because the platform runs inherited members regardless.
+     */
+    #read(target, key) {
         const descriptor = Object.getOwnPropertyDescriptor(target, METADATA_SYMBOL);
         if (descriptor === undefined) {
             return undefined;
         }
         const record = descriptor.value;
-        if (!record || typeof record !== "object" || !Object.hasOwn(record, key)) {
+        if (typeof record !== "object" || record === null || !Object.hasOwn(record, key)) {
             return undefined;
         }
-        return record;
+        return Reflect.get(record, key);
+    }
+    /** Each class level's own bucket under `key`, base first — the order construction runs them. */
+    #ownBucketsBaseFirst(target, key) {
+        const buckets = [];
+        let current = target;
+        while (typeof current === "function" && current !== Function.prototype) {
+            const bucket = this.#read(current, key);
+            if (bucket !== undefined) {
+                buckets.unshift(bucket);
+            }
+            current = Object.getPrototypeOf(current);
+        }
+        return buckets;
     }
     getConstructorMetadata(target) {
-        const record = this.#getMetadataRecord(target, INJECTABLE_KEY);
-        return record?.[INJECTABLE_KEY];
+        return this.#read(target, INJECTABLE_KEY);
     }
+    /**
+     * Lifecycle hooks aggregated over the base chain — an inherited hook method exists on the instance.
+     *
+     * @remarks `postConstruct` runs base first (a derived hook may rely on base state); `preDestroy`
+     * runs derived first, mirroring teardown. A method name repeated across levels runs once.
+     */
     getLifecycleMetadata(target) {
-        const record = this.#getMetadataRecord(target, LIFECYCLE_KEY);
-        return record?.[LIFECYCLE_KEY];
+        const cached = this.#lifecycleByClass?.get(target);
+        if (cached !== undefined) {
+            return cached ?? undefined;
+        }
+        const buckets = this.#ownBucketsBaseFirst(target, LIFECYCLE_KEY);
+        let merged;
+        if (buckets.length === 0) {
+            merged = null;
+        }
+        else if (buckets.length === 1) {
+            merged = buckets[0];
+        }
+        else {
+            merged = {
+                postConstruct: mergeUniqueNames(buckets.map((bucket) => bucket.postConstruct)),
+                preDestroy: mergeUniqueNames(buckets.map((bucket) => bucket.preDestroy).reverse()),
+            };
+        }
+        (this.#lifecycleByClass ??= new WeakMap()).set(target, merged);
+        return merged ?? undefined;
     }
+    /**
+     * Accessor injections aggregated over the base chain, base first — the order initializers run.
+     *
+     * @remarks Not deduplicated: a derived accessor shadowing a base one still runs both initializers.
+     */
     getAccessorMetadata(target) {
-        const record = this.#getMetadataRecord(target, INJECT_ACCESSOR_KEY);
-        return record?.[INJECT_ACCESSOR_KEY];
+        const cached = this.#accessorsByClass?.get(target);
+        if (cached !== undefined) {
+            return cached ?? undefined;
+        }
+        const buckets = this.#ownBucketsBaseFirst(target, INJECT_ACCESSOR_KEY);
+        let merged;
+        if (buckets.length === 0) {
+            merged = null;
+        }
+        else if (buckets.length === 1) {
+            merged = buckets[0];
+        }
+        else {
+            merged = buckets.flat();
+        }
+        (this.#accessorsByClass ??= new WeakMap()).set(target, merged);
+        return merged ?? undefined;
+    }
+}
+/** Concatenates hook-name lists in the given order, keeping each name's first occurrence. */
+function mergeUniqueNames(lists) {
+    const seen = new Set();
+    const merged = [];
+    for (const list of lists) {
+        for (const name of list) {
+            if (!seen.has(name)) {
+                seen.add(name);
+                merged.push(name);
+            }
+        }
     }
+    return merged;
 }
 /**
  * @since 0.3.16-canary.0

package/dist/metadata/symbol-metadata-reader.js.map

@@ -1 +1 @@
-{"version":3,"file":"symbol-metadata-reader.js","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAI/G;;GAEG;AACH,MAAM,OAAO,oBAAoB;IAC/B,kBAAkB,CAAC,MAAmB,EAAE,GAAoB;QAC1D,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC5E,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,UAAU,CAAC,KAA4D,CAAC;QACvF,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;YACzE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,sBAAsB,CAAC,MAAmB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;QAC/D,OAAO,MAAM,EAAE,CAAC,cAAc,CAAoC,CAAC;IACrE,CAAC;IAED,oBAAoB,CAAC,MAAmB;QACtC,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;QAC9D,OAAO,MAAM,EAAE,CAAC,aAAa,CAAkC,CAAC;IAClE,CAAC;IAED,mBAAmB,CACjB,MAAmB;QAEnB,MAAM,MAAM,GAAG,IAAI,CAAC,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;QACpE,OAAO,MAAM,EAAE,CAAC,mBAAmB,CAEtB,CAAC;IAChB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,oBAAoB,EAAE,CAAC"}
+{"version":3,"file":"symbol-metadata-reader.js","sourceRoot":"","sources":["../../src/metadata/symbol-metadata-reader.ts"],"names":[],"mappings":"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"}

package/dist/metadata/verifying-metadata-reader.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Wraps a foreign {@link MetadataReader} so its answers are verified before anything dereferences
+ * them.
+ */
+import type { MetadataReader } from "#/metadata/metadata-types";
+/**
+ * The reader a container should hand its resolver: verified when it came from outside.
+ *
+ * @remarks The decorator reader writes the metadata it later reads, so there is nothing to check and
+ * nothing to pay — a container that supplies no reader of its own is left on the same code path it
+ * has always taken. A supplied reader is a claim, and only its callers can be charged for checking.
+ *
+ * @since 0.6.0
+ */
+export declare function verifyingMetadataReader(reader: MetadataReader): MetadataReader;
+//# sourceMappingURL=verifying-metadata-reader.d.ts.map

package/dist/metadata/verifying-metadata-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifying-metadata-reader.d.ts","sourceRoot":"","sources":["../../src/metadata/verifying-metadata-reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAWhE;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CAe9E"}

package/dist/metadata/verifying-metadata-reader.js

@@ -0,0 +1,32 @@
+/**
+ * Wraps a foreign {@link MetadataReader} so its answers are verified before anything dereferences
+ * them.
+ */
+import { defaultMetadataReader } from "#/metadata/symbol-metadata-reader";
+import { verifyAccessorMetadata, verifyConstructorMetadata, verifyLifecycleMetadata, } from "#/resolution/cache/class-introspector";
+// Wrapping a wrapper would stack a layer per child container, so each one is remembered.
+const verifyingReaders = new WeakSet();
+/**
+ * The reader a container should hand its resolver: verified when it came from outside.
+ *
+ * @remarks The decorator reader writes the metadata it later reads, so there is nothing to check and
+ * nothing to pay — a container that supplies no reader of its own is left on the same code path it
+ * has always taken. A supplied reader is a claim, and only its callers can be charged for checking.
+ *
+ * @since 0.6.0
+ */
+export function verifyingMetadataReader(reader) {
+    if (reader === defaultMetadataReader || verifyingReaders.has(reader)) {
+        return reader;
+    }
+    const verifying = {
+        getConstructorMetadata: (target) => verifyConstructorMetadata(reader, target),
+        getLifecycleMetadata: (target) => verifyLifecycleMetadata(reader, target),
+        ...(reader.getAccessorMetadata === undefined
+            ? {}
+            : { getAccessorMetadata: (target) => verifyAccessorMetadata(reader, target) }),
+    };
+    verifyingReaders.add(verifying);
+    return verifying;
+}
+//# sourceMappingURL=verifying-metadata-reader.js.map

package/dist/metadata/verifying-metadata-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifying-metadata-reader.js","sourceRoot":"","sources":["../../src/metadata/verifying-metadata-reader.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,uCAAuC,CAAC;AAE/C,yFAAyF;AACzF,MAAM,gBAAgB,GAAG,IAAI,OAAO,EAAkB,CAAC;AAEvD;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,IAAI,MAAM,KAAK,qBAAqB,IAAI,gBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;QACrE,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,SAAS,GAAmB;QAChC,sBAAsB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7E,oBAAoB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,CAAC;QACzE,GAAG,CAAC,MAAM,CAAC,mBAAmB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,mBAAmB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;KACjF,CAAC;IAEF,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEhC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/resolution/{activation-need.d.ts → cache/activation-need.d.ts}

@@ -4,17 +4,17 @@
  * @remarks Versioned on the lifecycle manager plus the own registry, since `onActivation` can be
  * registered at any time and a rebind mints binding ids the memo must not keep forever.
  */
-import type { Binding } from "#/binding";
-import type { BindingRegistry } from "#/registry";
-import type { ClassIntrospector } from "#/resolution/class-introspector";
-import type { LifecycleManager } from "#/resolution/lifecycle";
+import type { Binding } from "#/core/binding";
+import type { BindingRegistry } from "#/core/registry";
+import type { LifecycleManager } from "#/lifecycle/lifecycle-manager";
+import type { ClassIntrospector } from "#/resolution/cache/class-introspector";
 /**
  * @since 0.5.0-canary.8
  */
 export declare class ActivationNeedCache {
     #private;
     constructor(lifecycle: LifecycleManager, classes: ClassIntrospector, registry: BindingRegistry);
-    needsActivation<const Value>(binding: Binding<Value>): boolean;
+    needsActivation<Value>(binding: Binding<Value>): boolean;
     /**
      * Settles a class binding's answer once its lifecycle metadata has actually been read, which
      * only happens on the first instantiation.

package/dist/resolution/cache/activation-need.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-need.d.ts","sourceRoot":"","sources":["../../../src/resolution/cache/activation-need.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAE/E;;GAEG;AACH,qBAAa,mBAAmB;;IAO9B,YAAY,SAAS,EAAE,gBAAgB,EAAE,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,eAAe,EAI7F;IAED,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,OAAO,CA0BvD;IAED;;;;;;OAMG;IACH,8BAA8B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,EAAE,eAAe,EAAE,OAAO,GAAG,OAAO,CAOhG;CAcF"}

package/dist/resolution/cache/activation-need.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation-need.js","sourceRoot":"","sources":["../../../src/resolution/cache/activation-need.ts"],"names":[],"mappings":"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"}

package/dist/resolution/{binding-lookup-cache.d.ts → cache/binding-lookup-cache.d.ts}

@@ -1,12 +1,14 @@
 /**
  * Options-less token → terminal binding, memoized per container chain.
  *
- * @see `ARCHITECTURE.md` — why these caches form their own parent chain.
+ * @remarks Each cache links to its parent's, so a child answers from its own chain without walking
+ * the container hierarchy again.
  */
-import type { Binding } from "#/binding";
-import type { BindingRegistry } from "#/registry";
-import type { Token } from "#/token";
-import type { Constructor } from "#/types";
+import type { Binding } from "#/core/binding";
+import type { BindingRegistry } from "#/core/registry";
+import type { BindingTag } from "#/core/tag";
+import type { Token } from "#/core/token";
+import type { Constructor } from "#/core/types";
 /**
  * A token's terminal binding with alias hops already folded, plus the container that owns it.
  *
@@ -37,5 +39,7 @@ export declare class BindingLookupCache<Owner> {
     defaultEntry(token: Token<unknown> | Constructor): DefaultLookupEntry<Owner> | null;
     /** `null` when the name's shape needs the full selection path. */
     namedEntry(token: Token<unknown> | Constructor, name: string): DefaultLookupEntry<Owner> | null;
+    /** `null` when the tag's shape needs the full selection path. */
+    taggedEntry(token: Token<unknown> | Constructor, tag: BindingTag): DefaultLookupEntry<Owner> | null;
 }
 //# sourceMappingURL=binding-lookup-cache.d.ts.map

package/dist/resolution/cache/binding-lookup-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-lookup-cache.d.ts","sourceRoot":"","sources":["../../../src/resolution/cache/binding-lookup-cache.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB,CAAC,KAAK;IACvC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,KAAK,CAAC;AASlC;;GAEG;AACH,qBAAa,kBAAkB,CAAC,KAAK;;IAuBnC,YAAY,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,SAAS,EAIjG;IAED,6EAA6E;IAC7E,YAAY,IAAI,MAAM,CAMrB;IAED,mEAAmE;IACnE,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAiBlF;IAED,kEAAkE;IAClE,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CAe9F;IAED,iEAAiE;IACjE,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,WAAW,EAAE,GAAG,EAAE,UAAU,GAAG,kBAAkB,CAAC,KAAK,CAAC,GAAG,IAAI,CA4BlG;CA0DF"}

package/dist/resolution/{binding-lookup-cache.js → cache/binding-lookup-cache.js}

@@ -9,6 +9,7 @@ export const ALIAS_HOP_LIMIT = 32;
  * @since 0.5.0-canary.8
  */
 const newNameToEntryMap = () => new Map();
+const newTagToEntryMap = () => new Map();
 /**
  * @since 0.5.0-canary.9
  */
@@ -22,6 +23,14 @@ export class BindingLookupCache {
     #lastEntry = null;
     #byTokenAndName = new Map();
     #namedVersion = -1;
+    #byTokenAndTag = new Map();
+    #taggedVersion = -1;
+    // One entry in front of the tag map, and the map is not written until a second distinct request
+    // shape appears: a per-request child usually asks one (token, tag) once, and the inner-map
+    // allocation was that shape's whole regression when this memo landed.
+    #lastTagToken;
+    #lastTag;
+    #lastTaggedEntry = null;
     #registry;
     #owner;
     #parent;
@@ -75,6 +84,38 @@ export class BindingLookupCache {
         }
         return entry;
     }
+    /** `null` when the tag's shape needs the full selection path. */
+    taggedEntry(token, tag) {
+        const version = this.chainVersion();
+        if (version !== this.#taggedVersion) {
+            this.#byTokenAndTag.clear();
+            this.#taggedVersion = version;
+            this.#lastTagToken = undefined;
+            this.#lastTag = undefined;
+        }
+        else if (token === this.#lastTagToken && tag === this.#lastTag) {
+            return this.#lastTaggedEntry;
+        }
+        let entry;
+        if (this.#lastTagToken === undefined) {
+            // First shape this cache generation sees: answer from the walk and defer the map entirely.
+            entry = this.#findTaggedInChain(token, tag);
+        }
+        else {
+            // Keyed by the criterion object itself: criteria are interned, so identity is the slot
+            // contract's own `Object.is` — the same exactness the registry's tagged index relies on.
+            const byTag = this.#byTokenAndTag.getOrInsertComputed(token, newTagToEntryMap);
+            entry = byTag.get(tag);
+            if (entry === undefined) {
+                entry = this.#findTaggedInChain(token, tag);
+                byTag.set(tag, entry);
+            }
+        }
+        this.#lastTagToken = token;
+        this.#lastTag = tag;
+        this.#lastTaggedEntry = entry;
+        return entry;
+    }
     #foldAliases(token) {
         let current = token;
         for (let hop = 0; hop < ALIAS_HOP_LIMIT; hop += 1) {
@@ -114,5 +155,19 @@ export class BindingLookupCache {
         }
         return this.#parent === undefined ? null : this.#parent.#findNamedInChain(token, name);
     }
+    #findTaggedInChain(token, tag) {
+        const tagged = this.#registry.getSimpleTagged(token, tag);
+        if (tagged !== undefined) {
+            // Predicates need a live context; aliases carry options through the full path.
+            if (tagged.predicate !== undefined || tagged.kind === "alias") {
+                return null;
+            }
+            return { binding: tagged, owner: this.#owner };
+        }
+        if (this.#registry.has(token)) {
+            return null;
+        }
+        return this.#parent === undefined ? null : this.#parent.#findTaggedInChain(token, tag);
+    }
 }
 //# sourceMappingURL=binding-lookup-cache.js.map

package/dist/resolution/cache/binding-lookup-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding-lookup-cache.js","sourceRoot":"","sources":["../../../src/resolution/cache/binding-lookup-cache.ts"],"names":[],"mappings":"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"}

package/dist/resolution/cache/class-introspector.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Per-class decorator metadata, cached by constructor.
+ *
+ * @remarks Metadata cannot change once a class is defined, so nothing here needs version stamping.
+ */
+import type { AmbientResolution } from "#/ambient/active-container";
+import type { Container } from "#/container/container";
+import type { Constructor } from "#/core/types";
+import type { InjectionDescriptor } from "#/injection/descriptor";
+import type { ConstructorMetadata, LifecycleMetadata, MetadataReader } from "#/metadata/metadata-types";
+/**
+ * A reader's constructor metadata for a class, verified the first time this process asks.
+ *
+ * @remarks Metadata cannot change once a class is defined, so re-checking per container would charge
+ * every fresh container for a fact already established — a per-request child or a cold boot pays
+ * that repeatedly.
+ *
+ * @since 0.6.0
+ */
+export declare function verifyConstructorMetadata(reader: MetadataReader, target: Constructor): ConstructorMetadata | undefined;
+/**
+ * Verifies what a reader claims about a class, since a `MetadataReader` is a public seam.
+ *
+ * @remarks Every path that reads constructor metadata comes through here, so a reader that answers
+ * wrongly is a named error at the class it described rather than a `TypeError` raised later inside a
+ * resolve. Only what a consumer dereferences is checked: `params` and each entry's `token`.
+ * `optional`/`multi` degrade to falsy without crashing, and `index` is decorative — dependencies are
+ * consumed positionally.
+ *
+ * @since 0.6.0
+ */
+export declare function assertConstructorMetadata(metadata: unknown, target: Constructor): ConstructorMetadata | undefined;
+/**
+ * A reader's lifecycle metadata for a class, verified the first time this process asks.
+ *
+ * @since 0.6.0
+ */
+export declare function verifyLifecycleMetadata(reader: MetadataReader, target: Constructor): LifecycleMetadata | undefined;
+/**
+ * A reader's accessor metadata for a class, verified the first time this process asks.
+ *
+ * @since 0.6.0
+ */
+export declare function verifyAccessorMetadata(reader: MetadataReader, target: Constructor): ReadonlyArray<{
+    readonly key: string | symbol;
+    readonly descriptor: InjectionDescriptor;
+}> | undefined;
+/**
+ * @since 0.5.0-canary.8
+ */
+export declare class ClassIntrospector {
+    #private;
+    constructor(reader: MetadataReader, container: Container);
+    constructorMetadata(target: Constructor): ConstructorMetadata | undefined;
+    /**
+     * Whether the class has a `@postConstruct` hook, or `undefined` until {@link discoverPostConstruct}.
+     *
+     * @remarks Callers treat unknown as "assume it does", so the first activation settles it.
+     */
+    knownPostConstruct(target: Constructor): boolean | undefined;
+    discoverPostConstruct(target: Constructor): void;
+    /** True when the class has accessor injection, which reads the container during construction. */
+    needsActiveContainer(target: Constructor): boolean;
+    instantiate(target: Constructor, deps: Array<unknown>, resolution?: AmbientResolution): unknown;
+}
+//# sourceMappingURL=class-introspector.d.ts.map

package/dist/resolution/cache/class-introspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"class-introspector.d.ts","sourceRoot":"","sources":["../../../src/resolution/cache/class-introspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AA6BxG;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,GAClB,mBAAmB,GAAG,SAAS,CAYjC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CA4BjH;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,SAAS,CA2BlH;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,WAAW,GAClB,aAAa,CAAC;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;CAAE,CAAC,GAAG,SAAS,CAoCxG;AAED;;GAEG;AACH,qBAAa,iBAAiB;;IAS5B,YAAY,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAGvD;IAED,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,SAAS,CAQxE;IAED;;;;OAIG;IACH,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,GAAG,SAAS,CAE3D;IAED,qBAAqB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAM/C;IAED,iGAAiG;IACjG,oBAAoB,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAOjD;IAED,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAM9F;CACF"}