@kaokei/di 3.0.9 → 4.0.0

package/README.md

@@ -14,7 +14,53 @@
 
 本库主要特点是参考借鉴了`InversifyJS`和`Angular`的优秀 API 设计，不依赖`reflect-metadata`，支持属性注入的循环依赖。
 
-- [入门指南](./docs/guide/README.md)
-- [API 文档](./docs/api/README.md)
+- [入门指南](./docs/guide/index.md)
+- [API 文档](./docs/api/index.md)
 - [博客文章](./docs/note/01.什么是Token.md)
-- [codesandbox example](https://codesandbox.io/s/di-playground-zjnyv)
+
+## CodeSandbox 在线示例
+
+以下示例托管在 GitHub 仓库的 `examples/` 目录中，可通过 CodeSandbox 直接在线运行。
+
+URL 格式：`https://codesandbox.io/p/github/kaokei/di/main?file=/examples/<示例目录>/src/index.ts`
+
+| 示例                      | 说明                                              | 在线运行                                                                                                     |
+| ------------------------- | ------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
+| 01-basic-usage            | 基础用法：创建容器、绑定服务、属性注入、单例验证  | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/01-basic-usage/src/index.ts)            |
+| 02-token-usage            | Token 用法：Token 实例作为标识符，三种绑定方式    | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/02-token-usage/src/index.ts)            |
+| 03-optional-inject        | Optional 注入：依赖不存在时返回 undefined         | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/03-optional-inject/src/index.ts)        |
+| 04-hierarchical-di        | 层级容器：父子容器创建与依赖查找                  | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/04-hierarchical-di/src/index.ts)        |
+| 05-self-skipself          | Self 和 SkipSelf：控制依赖查找范围                | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/05-self-skipself/src/index.ts)          |
+| 06-lifecycle-activation   | 激活生命周期：onActivation 钩子与执行顺序         | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/06-lifecycle-activation/src/index.ts)   |
+| 07-lifecycle-deactivation | 销毁生命周期：onDeactivation 钩子与执行顺序       | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/07-lifecycle-deactivation/src/index.ts) |
+| 08-post-construct         | PostConstruct：同步/异步初始化与继承行为          | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/08-post-construct/src/index.ts)         |
+| 09-pre-destroy            | PreDestroy：服务销毁前的清理钩子                  | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/09-pre-destroy/src/index.ts)            |
+| 10-circular-dependency    | 循环依赖：属性注入原生支持循环依赖                | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/10-circular-dependency/src/index.ts)    |
+| 11-lazy-inject            | LazyInject：延迟注入，首次访问时才从容器解析      | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/11-lazy-inject/src/index.ts)            |
+| 12-inheritance            | 继承：子类继承父类的属性注入与 PostConstruct 规则 | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/12-inheritance/src/index.ts)            |
+| 13-to-service             | toService 别名：接口 token 映射到实现类           | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/13-to-service/src/index.ts)             |
+| 14-dynamic-value          | 动态值：toDynamicValue 工厂函数与条件注入         | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/14-dynamic-value/src/index.ts)          |
+| 15-error-handling         | 错误处理：各种错误类型的触发场景与捕获方式        | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/15-error-handling/src/index.ts)         |
+| 16-javascript-usage       | JavaScript 用法：使用 decorate 函数手动应用装饰器 | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/16-javascript-usage/src/index.js)       |
+| 17-container-destroy      | 容器销毁：destroy 递归销毁子容器与 getContainerOf | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/17-container-destroy/src/index.ts)      |
+| 18-deep-circular-dependency | 深层循环依赖：属性注入支持深层循环链，以及循环依赖检测 | [打开](https://codesandbox.io/p/github/kaokei/di/main?file=/examples/18-deep-circular-dependency/src/index.ts) |
+
+每个示例目录包含独立的 `package.json`（依赖已发布的 `@kaokei/di` 版本）和 `tsconfig.json`，与主包构建流程完全隔离，可直接在 CodeSandbox 中运行。
+
+## 项目特点
+
+本项目只有单例模式，没有inversify中其他模式。
+
+本项目中@LazyInject 和 @PostConstruct 只支持class服务。
+
+inversify中执行顺序是：  
+postConstruct --> binding handler --> container handlers  
+container handlers --> binding handler --> preDestroy  
+本项目执行顺序：  
+binding handler --> container handlers --> postConstruct  
+container handlers --> binding handler --> preDestroy
+
+@postConstruct装饰器在inversify中，如果A类继承了B类。  
+此时如果A类和B类都有 @postConstruct，那么B类不会执行，只有A类会执行。  
+如果A类没有@postConstruct，那么会执行B类的。  
+如果A继承B继承C，并且A，B都没有@postConstruct，那么会执行C类的。

package/dist/binding.d.cts

@@ -1,16 +1,22 @@
+import { BindingType, StatusType } from './constants';
 import { Container } from './container';
-import { Newable, Context, Options, CommonToken, DynamicValue, ActivationHandler, DeactivationHandler } from './interfaces';
+import { Newable, Context, Options, CommonToken, RecordObject, DynamicValue, PostConstructParam, ActivationHandler, DeactivationHandler } from './interfaces';
+export interface InjectPropertiesResult {
+    properties: RecordObject;
+    bindings: Binding[];
+}
 export declare class Binding<T = unknown> {
+    static _resolvers: Record<string, string>;
     container: Container;
     context: Context;
     token: CommonToken<T>;
-    type: string;
-    status: string;
-    classValue: Newable<T>;
-    constantValue: T;
-    dynamicValue: DynamicValue<T>;
-    cache: T;
-    postConstructResult?: Promise<void> | Symbol;
+    type: BindingType;
+    status: StatusType;
+    classValue?: Newable<T>;
+    constantValue?: T;
+    dynamicValue?: DynamicValue<T>;
+    cache?: T;
+    postConstructResult: Promise<void> | symbol | undefined;
     onActivationHandler?: ActivationHandler<T>;
     onDeactivationHandler?: DeactivationHandler<T>;
     constructor(token: CommonToken<T>, container: Container);
@@ -23,14 +29,32 @@ export declare class Binding<T = unknown> {
     toConstantValue(value: T): this;
     toDynamicValue(func: DynamicValue<T>): this;
     toService(token: CommonToken<T>): this;
-    get(options: Options<T>): T;
-    private getAwaitBindings;
-    private postConstruct;
+    get(options: Options<T>): any;
+    _getAwaitBindings(bindings: Binding[], filter: PostConstructParam): Binding[];
+    /**
+     * PostConstruct 生命周期处理
+     *
+     * postConstructResult 的三种状态：
+     * - UNINITIALIZED（Symbol）：PostConstruct 尚未执行，用于循环依赖检测
+     * - undefined：没有使用 @PostConstruct 装饰器，或 @PostConstruct() 无参数时同步执行完毕
+     * - Promise<void>：@PostConstruct(value) 有参数时，等待前置服务初始化后异步执行
+     *
+     * @PostConstruct() 无参数时：同步执行，不等待任何前置服务
+     * @PostConstruct(value) 有参数时：等待指定的前置服务初始化完成后再执行
+     *   - 如果前置服务初始化成功，执行当前服务的 PostConstruct 方法
+     *   - 如果前置服务初始化失败，rejected promise 自然传播，当前服务的 PostConstruct 不执行
+     */
+    _postConstruct(options: Options<T>, propertyBindings: Binding[]): void;
     preDestroy(): void;
-    private execute;
-    private resolveInstanceValue;
-    private resolveConstantValue;
-    private resolveDynamicValue;
-    private getConstructorParameters;
-    private getInjectProperties;
+    _execute(key: string): any;
+    _resolveInstanceValue(options: Options<T>): T;
+    _createInstance(): T;
+    _registerInstance(): void;
+    _injectProperties(properties: RecordObject): void;
+    _resolveConstantValue(): T;
+    _resolveDynamicValue(): T;
+    _getInjectProperties(options: Options<T>): {
+        properties: RecordObject;
+        bindings: Binding<unknown>[];
+    };
 }

package/dist/binding.d.ts

@@ -1,16 +1,22 @@
+import { BindingType, StatusType } from './constants';
 import { Container } from './container';
-import { Newable, Context, Options, CommonToken, DynamicValue, ActivationHandler, DeactivationHandler } from './interfaces';
+import { Newable, Context, Options, CommonToken, RecordObject, DynamicValue, PostConstructParam, ActivationHandler, DeactivationHandler } from './interfaces';
+export interface InjectPropertiesResult {
+    properties: RecordObject;
+    bindings: Binding[];
+}
 export declare class Binding<T = unknown> {
+    static _resolvers: Record<string, string>;
     container: Container;
     context: Context;
     token: CommonToken<T>;
-    type: string;
-    status: string;
-    classValue: Newable<T>;
-    constantValue: T;
-    dynamicValue: DynamicValue<T>;
-    cache: T;
-    postConstructResult?: Promise<void> | Symbol;
+    type: BindingType;
+    status: StatusType;
+    classValue?: Newable<T>;
+    constantValue?: T;
+    dynamicValue?: DynamicValue<T>;
+    cache?: T;
+    postConstructResult: Promise<void> | symbol | undefined;
     onActivationHandler?: ActivationHandler<T>;
     onDeactivationHandler?: DeactivationHandler<T>;
     constructor(token: CommonToken<T>, container: Container);
@@ -23,14 +29,32 @@ export declare class Binding<T = unknown> {
     toConstantValue(value: T): this;
     toDynamicValue(func: DynamicValue<T>): this;
     toService(token: CommonToken<T>): this;
-    get(options: Options<T>): T;
-    private getAwaitBindings;
-    private postConstruct;
+    get(options: Options<T>): any;
+    _getAwaitBindings(bindings: Binding[], filter: PostConstructParam): Binding[];
+    /**
+     * PostConstruct 生命周期处理
+     *
+     * postConstructResult 的三种状态：
+     * - UNINITIALIZED（Symbol）：PostConstruct 尚未执行，用于循环依赖检测
+     * - undefined：没有使用 @PostConstruct 装饰器，或 @PostConstruct() 无参数时同步执行完毕
+     * - Promise<void>：@PostConstruct(value) 有参数时，等待前置服务初始化后异步执行
+     *
+     * @PostConstruct() 无参数时：同步执行，不等待任何前置服务
+     * @PostConstruct(value) 有参数时：等待指定的前置服务初始化完成后再执行
+     *   - 如果前置服务初始化成功，执行当前服务的 PostConstruct 方法
+     *   - 如果前置服务初始化失败，rejected promise 自然传播，当前服务的 PostConstruct 不执行
+     */
+    _postConstruct(options: Options<T>, propertyBindings: Binding[]): void;
     preDestroy(): void;
-    private execute;
-    private resolveInstanceValue;
-    private resolveConstantValue;
-    private resolveDynamicValue;
-    private getConstructorParameters;
-    private getInjectProperties;
+    _execute(key: string): any;
+    _resolveInstanceValue(options: Options<T>): T;
+    _createInstance(): T;
+    _registerInstance(): void;
+    _injectProperties(properties: RecordObject): void;
+    _resolveConstantValue(): T;
+    _resolveDynamicValue(): T;
+    _getInjectProperties(options: Options<T>): {
+        properties: RecordObject;
+        bindings: Binding<unknown>[];
+    };
 }

package/dist/cachemap.d.cts

@@ -1,10 +1,25 @@
-import { CommonToken } from './interfaces';
-export declare function defineMetadata(metadataKey: string, metadataValue: any, target: CommonToken): void;
-export declare function getOwnMetadata(metadataKey: string, target: CommonToken): any | undefined;
+import { CommonToken, PostConstructParam } from './interfaces';
+import { KEYS } from './constants';
+export interface MetadataMap {
+    [KEYS.INJECTED_PROPS]: Record<string, Record<string, unknown>>;
+    [KEYS.POST_CONSTRUCT]: {
+        key: string;
+        value?: PostConstructParam;
+    };
+    [KEYS.PRE_DESTROY]: {
+        key: string;
+    };
+}
+export declare function defineMetadata<K extends keyof MetadataMap>(metadataKey: K, metadataValue: MetadataMap[K], target: CommonToken): void;
+export declare function defineMetadata(metadataKey: string, metadataValue: unknown, target: CommonToken): void;
+export declare function getOwnMetadata<K extends keyof MetadataMap>(metadataKey: K, target: CommonToken): MetadataMap[K] | undefined;
+export declare function getOwnMetadata(metadataKey: string, target: CommonToken): unknown | undefined;
 /**
- * 使用hasParentClass判断当前target有没有父类
- * 如果没有父类直接使用getOwnMetadata获取数据
- * 如果有父类，那么需要合并getOwnMetadata(target)和getMetadata(target的父类)
- * 不支持META_KEY_INJECTED_PARAMS作为metadataKey
+ * 使用 hasParentClass 判断当前 target 有没有父类
+ * 如果没有父类直接使用 getOwnMetadata 获取数据
+ * 如果有父类，那么需要合并 getOwnMetadata(target) 和 getMetadata(target 的父类)
+ * 统一使用展开运算符合并，返回外层新对象、内层原始引用
+ * 不支持 META_KEY_INJECTED_PARAMS 作为 metadataKey
  */
-export declare function getMetadata(metadataKey: string, target: CommonToken): any | undefined;
+export declare function getMetadata<K extends keyof MetadataMap>(metadataKey: K, target: CommonToken): MetadataMap[K] | undefined;
+export declare function getMetadata(metadataKey: string, target: CommonToken): unknown | undefined;

package/dist/cachemap.d.ts

@@ -1,10 +1,25 @@
-import { CommonToken } from './interfaces';
-export declare function defineMetadata(metadataKey: string, metadataValue: any, target: CommonToken): void;
-export declare function getOwnMetadata(metadataKey: string, target: CommonToken): any | undefined;
+import { CommonToken, PostConstructParam } from './interfaces';
+import { KEYS } from './constants';
+export interface MetadataMap {
+    [KEYS.INJECTED_PROPS]: Record<string, Record<string, unknown>>;
+    [KEYS.POST_CONSTRUCT]: {
+        key: string;
+        value?: PostConstructParam;
+    };
+    [KEYS.PRE_DESTROY]: {
+        key: string;
+    };
+}
+export declare function defineMetadata<K extends keyof MetadataMap>(metadataKey: K, metadataValue: MetadataMap[K], target: CommonToken): void;
+export declare function defineMetadata(metadataKey: string, metadataValue: unknown, target: CommonToken): void;
+export declare function getOwnMetadata<K extends keyof MetadataMap>(metadataKey: K, target: CommonToken): MetadataMap[K] | undefined;
+export declare function getOwnMetadata(metadataKey: string, target: CommonToken): unknown | undefined;
 /**
- * 使用hasParentClass判断当前target有没有父类
- * 如果没有父类直接使用getOwnMetadata获取数据
- * 如果有父类，那么需要合并getOwnMetadata(target)和getMetadata(target的父类)
- * 不支持META_KEY_INJECTED_PARAMS作为metadataKey
+ * 使用 hasParentClass 判断当前 target 有没有父类
+ * 如果没有父类直接使用 getOwnMetadata 获取数据
+ * 如果有父类，那么需要合并 getOwnMetadata(target) 和 getMetadata(target 的父类)
+ * 统一使用展开运算符合并，返回外层新对象、内层原始引用
+ * 不支持 META_KEY_INJECTED_PARAMS 作为 metadataKey
  */
-export declare function getMetadata(metadataKey: string, target: CommonToken): any | undefined;
+export declare function getMetadata<K extends keyof MetadataMap>(metadataKey: K, target: CommonToken): MetadataMap[K] | undefined;
+export declare function getMetadata(metadataKey: string, target: CommonToken): unknown | undefined;

package/dist/constants.d.cts

@@ -1,5 +1,4 @@
 export declare const KEYS: {
-    readonly INJECTED_PARAMS: "injected:params";
     readonly INJECTED_PROPS: "injected:props";
     readonly INJECT: "inject";
     readonly SELF: "self";
@@ -19,10 +18,24 @@ export declare const BINDING: {
     readonly ConstantValue: "ConstantValue";
     readonly DynamicValue: "DynamicValue";
 };
+/**
+ * 错误消息模板
+ *
+ * 这些消息用于装饰器和 token 模块中的运行时错误检测，
+ * 与 errors/ 目录下的错误类无关（错误类有自己的消息前缀）。
+ */
 export declare const ERRORS: {
-    readonly POST_CONSTRUCT: "Cannot apply @PostConstruct decorator multiple times in the same class.";
-    readonly PRE_DESTROY: "Cannot apply @PreDestroy decorator multiple times in the same class.";
-    readonly MISS_INJECT: "Expected a @Inject decorator to explicitly specify the token.";
-    readonly MISS_CONTAINER: "@LazyInject decorator cannot find the corresponding container.";
+    readonly POST_CONSTRUCT: "Multiple @PostConstruct decorators are not allowed in a single class.";
+    readonly PRE_DESTROY: "Multiple @PreDestroy decorators are not allowed in a single class.";
+    readonly INVALID_TOKEN: "@Inject or @LazyInject requires a valid token, but received null or undefined.";
+    readonly LAZY_INJECT_INVALID_TOKEN: "@LazyInject requires a valid token, but received null or undefined.";
 };
-export declare const DEFAULT_VALUE: unique symbol;
+/**
+ * Object.hasOwn 的兼容性替代函数
+ * Object.hasOwn 在部分旧版浏览器和运行时中不可用（ES2022+），
+ * 此函数使用 Object.prototype.hasOwnProperty.call 实现相同语义。
+ */
+export declare function hasOwn(obj: object, key: PropertyKey): boolean;
+export declare const UNINITIALIZED: unique symbol;
+export type BindingType = (typeof BINDING)[keyof typeof BINDING];
+export type StatusType = (typeof STATUS)[keyof typeof STATUS];

package/dist/constants.d.ts

@@ -1,5 +1,4 @@
 export declare const KEYS: {
-    readonly INJECTED_PARAMS: "injected:params";
     readonly INJECTED_PROPS: "injected:props";
     readonly INJECT: "inject";
     readonly SELF: "self";
@@ -19,10 +18,24 @@ export declare const BINDING: {
     readonly ConstantValue: "ConstantValue";
     readonly DynamicValue: "DynamicValue";
 };
+/**
+ * 错误消息模板
+ *
+ * 这些消息用于装饰器和 token 模块中的运行时错误检测，
+ * 与 errors/ 目录下的错误类无关（错误类有自己的消息前缀）。
+ */
 export declare const ERRORS: {
-    readonly POST_CONSTRUCT: "Cannot apply @PostConstruct decorator multiple times in the same class.";
-    readonly PRE_DESTROY: "Cannot apply @PreDestroy decorator multiple times in the same class.";
-    readonly MISS_INJECT: "Expected a @Inject decorator to explicitly specify the token.";
-    readonly MISS_CONTAINER: "@LazyInject decorator cannot find the corresponding container.";
+    readonly POST_CONSTRUCT: "Multiple @PostConstruct decorators are not allowed in a single class.";
+    readonly PRE_DESTROY: "Multiple @PreDestroy decorators are not allowed in a single class.";
+    readonly INVALID_TOKEN: "@Inject or @LazyInject requires a valid token, but received null or undefined.";
+    readonly LAZY_INJECT_INVALID_TOKEN: "@LazyInject requires a valid token, but received null or undefined.";
 };
-export declare const DEFAULT_VALUE: unique symbol;
+/**
+ * Object.hasOwn 的兼容性替代函数
+ * Object.hasOwn 在部分旧版浏览器和运行时中不可用（ES2022+），
+ * 此函数使用 Object.prototype.hasOwnProperty.call 实现相同语义。
+ */
+export declare function hasOwn(obj: object, key: PropertyKey): boolean;
+export declare const UNINITIALIZED: unique symbol;
+export type BindingType = (typeof BINDING)[keyof typeof BINDING];
+export type StatusType = (typeof STATUS)[keyof typeof STATUS];

package/dist/container.d.cts

@@ -1,12 +1,13 @@
 import { Binding } from './binding';
 import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
 export declare class Container {
-    static map: WeakMap<any, Container>;
+    static _instanceContainerMap: WeakMap<object, Container>;
+    static getContainerOf(instance: object): Container | undefined;
     parent?: Container;
     children?: Set<Container>;
-    private bindings;
-    private onActivationHandler?;
-    private onDeactivationHandler?;
+    _bindings: Map<CommonToken, Binding>;
+    _onActivationHandler?: ActivationHandler;
+    _onDeactivationHandler?: DeactivationHandler;
     bind<T>(token: CommonToken<T>): Binding<T>;
     unbind<T>(token: CommonToken<T>): void;
     unbindAll(): void;
@@ -21,11 +22,14 @@ export declare class Container {
         optional?: false;
     }): T;
     get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
+    _resolveSkipSelf<T>(token: CommonToken<T>, options: Options<T>): T | void;
+    _resolveSelf<T>(token: CommonToken<T>, options: Options<T>): T | void;
+    _resolveDefault<T>(token: CommonToken<T>, options: Options<T>): T | void;
     onActivation(handler: ActivationHandler): void;
     onDeactivation(handler: DeactivationHandler): void;
     activate<T>(input: T, token: CommonToken<T>): T;
     deactivate<T>(binding: Binding<T>): void;
-    private buildBinding;
-    private getBinding;
-    private checkBindingNotFoundError;
+    _buildBinding<T>(token: CommonToken<T>): Binding<T>;
+    _getBinding<T>(token: CommonToken<T>): Binding<T>;
+    _checkBindingNotFoundError<T>(token: CommonToken, options: Options<T>): void;
 }

package/dist/container.d.ts

@@ -1,12 +1,13 @@
 import { Binding } from './binding';
 import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
 export declare class Container {
-    static map: WeakMap<any, Container>;
+    static _instanceContainerMap: WeakMap<object, Container>;
+    static getContainerOf(instance: object): Container | undefined;
     parent?: Container;
     children?: Set<Container>;
-    private bindings;
-    private onActivationHandler?;
-    private onDeactivationHandler?;
+    _bindings: Map<CommonToken, Binding>;
+    _onActivationHandler?: ActivationHandler;
+    _onDeactivationHandler?: DeactivationHandler;
     bind<T>(token: CommonToken<T>): Binding<T>;
     unbind<T>(token: CommonToken<T>): void;
     unbindAll(): void;
@@ -21,11 +22,14 @@ export declare class Container {
         optional?: false;
     }): T;
     get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
+    _resolveSkipSelf<T>(token: CommonToken<T>, options: Options<T>): T | void;
+    _resolveSelf<T>(token: CommonToken<T>, options: Options<T>): T | void;
+    _resolveDefault<T>(token: CommonToken<T>, options: Options<T>): T | void;
     onActivation(handler: ActivationHandler): void;
     onDeactivation(handler: DeactivationHandler): void;
     activate<T>(input: T, token: CommonToken<T>): T;
     deactivate<T>(binding: Binding<T>): void;
-    private buildBinding;
-    private getBinding;
-    private checkBindingNotFoundError;
+    _buildBinding<T>(token: CommonToken<T>): Binding<T>;
+    _getBinding<T>(token: CommonToken<T>): Binding<T>;
+    _checkBindingNotFoundError<T>(token: CommonToken, options: Options<T>): void;
 }

package/dist/decorator.d.cts

@@ -1,18 +1,35 @@
-import { InjectFunction } from './interfaces';
+import { Container } from './container';
+import { InjectFunction, GenericToken } from './interfaces';
 /**
- * 创建装饰器的高阶函数
- * 装饰器的通用逻辑就是通过cachemap记录到全局的WeakMap中
+ * 创建属性装饰器的高阶函数（Stage 3 Field Decorator）
  *
- * @param {(string )} decoratorKey 代表某个装饰器的名称
- * @param {*} [defaultValue] 该装饰器函数的默认参数
- * @return {*} 装饰器函数
+ * 通过 context.addInitializer 在实例化时获取构造函数引用，
+ * 并将装饰器元数据存储到 CacheMap 的 INJECTED_PROPS 分区。
+ *
+ * @param decoratorKey 装饰器名称（如 'inject'、'self' 等）
+ * @param defaultValue 装饰器的默认参数值
+ * @returns 装饰器函数
  */
-declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
 export declare const Inject: InjectFunction<ReturnType<typeof createDecorator>>;
-export declare const Self: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const SkipSelf: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const Optional: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const PostConstruct: (metaValue?: any) => (target: any, propertyKey: string) => void;
-export declare const PreDestroy: (metaValue?: any) => (target: any, propertyKey: string) => void;
-export declare function decorate(decorator: any, target: any, key: number | string): void;
+export declare const Self: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const SkipSelf: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const Optional: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const PostConstruct: (metaValue?: any) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+export declare const PreDestroy: (metaValue?: any) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * 延迟注入装饰器，Stage 3 Field Decorator 签名。
+ * 通过 context.addInitializer 在实例上定义 getter/setter，
+ * 首次访问属性时才从容器中解析依赖。
+ *
+ * @param token 要解析的服务 Token
+ * @param container 可选，显式指定容器。未传入时通过 Container.getContainerOf 查找，
+ *                  仅支持 Instance 类型绑定。toConstantValue / toDynamicValue 场景需显式传入。
+ */
+export declare function LazyInject<T>(token: GenericToken<T>, container?: Container): (_value: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * 创建绑定到指定容器的延迟注入装饰器工厂。
+ */
+export declare function createLazyInject(container: Container): <T>(token: GenericToken<T>) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare function decorate(decorator: any, target: any, key: string): void;
 export {};

package/dist/decorator.d.ts

@@ -1,18 +1,35 @@
-import { InjectFunction } from './interfaces';
+import { Container } from './container';
+import { InjectFunction, GenericToken } from './interfaces';
 /**
- * 创建装饰器的高阶函数
- * 装饰器的通用逻辑就是通过cachemap记录到全局的WeakMap中
+ * 创建属性装饰器的高阶函数（Stage 3 Field Decorator）
  *
- * @param {(string )} decoratorKey 代表某个装饰器的名称
- * @param {*} [defaultValue] 该装饰器函数的默认参数
- * @return {*} 装饰器函数
+ * 通过 context.addInitializer 在实例化时获取构造函数引用，
+ * 并将装饰器元数据存储到 CacheMap 的 INJECTED_PROPS 分区。
+ *
+ * @param decoratorKey 装饰器名称（如 'inject'、'self' 等）
+ * @param defaultValue 装饰器的默认参数值
+ * @returns 装饰器函数
  */
-declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
+declare function createDecorator(decoratorKey: string, defaultValue?: any): (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
 export declare const Inject: InjectFunction<ReturnType<typeof createDecorator>>;
-export declare const Self: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const SkipSelf: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const Optional: (decoratorValue?: any) => (target: any, targetKey?: string, index?: number) => void;
-export declare const PostConstruct: (metaValue?: any) => (target: any, propertyKey: string) => void;
-export declare const PreDestroy: (metaValue?: any) => (target: any, propertyKey: string) => void;
-export declare function decorate(decorator: any, target: any, key: number | string): void;
+export declare const Self: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const SkipSelf: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const Optional: (decoratorValue?: any) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare const PostConstruct: (metaValue?: any) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+export declare const PreDestroy: (metaValue?: any) => (_value: Function, context: ClassMethodDecoratorContext) => void;
+/**
+ * 延迟注入装饰器，Stage 3 Field Decorator 签名。
+ * 通过 context.addInitializer 在实例上定义 getter/setter，
+ * 首次访问属性时才从容器中解析依赖。
+ *
+ * @param token 要解析的服务 Token
+ * @param container 可选，显式指定容器。未传入时通过 Container.getContainerOf 查找，
+ *                  仅支持 Instance 类型绑定。toConstantValue / toDynamicValue 场景需显式传入。
+ */
+export declare function LazyInject<T>(token: GenericToken<T>, container?: Container): (_value: undefined, context: ClassFieldDecoratorContext) => void;
+/**
+ * 创建绑定到指定容器的延迟注入装饰器工厂。
+ */
+export declare function createLazyInject(container: Container): <T>(token: GenericToken<T>) => (_value: undefined, context: ClassFieldDecoratorContext) => void;
+export declare function decorate(decorator: any, target: any, key: string): void;
 export {};

package/dist/errors/BaseError.d.cts

@@ -1,4 +1,5 @@
 import { CommonToken } from '../interfaces';
 export declare class BaseError extends Error {
+    token?: CommonToken;
     constructor(prefix: string, token?: CommonToken);
 }

package/dist/errors/BaseError.d.ts

@@ -1,4 +1,5 @@
 import { CommonToken } from '../interfaces';
 export declare class BaseError extends Error {
+    token?: CommonToken;
     constructor(prefix: string, token?: CommonToken);
 }

package/dist/errors/ContainerNotFoundError.d.cts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken, Newable } from '../interfaces';
+export declare class ContainerNotFoundError extends BaseError {
+    constructor(token: CommonToken, ctor: Newable);
+}

package/dist/errors/ContainerNotFoundError.d.ts

@@ -0,0 +1,5 @@
+import { BaseError } from './BaseError';
+import { CommonToken, Newable } from '../interfaces';
+export declare class ContainerNotFoundError extends BaseError {
+    constructor(token: CommonToken, ctor: Newable);
+}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";var w=Object.defineProperty;var j=(n,t,e)=>t in n?w(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var r=(n,t,e)=>j(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h={INJECTED_PARAMS:"injected:params",INJECTED_PROPS:"injected:props",INJECT:"inject",SELF:"self",SKIP_SELF:"skipSelf",OPTIONAL:"optional",POST_CONSTRUCT:"postConstruct",PRE_DESTROY:"preDestroy"},p={DEFAULT:"default",INITING:"initing",ACTIVATED:"activated"},d={Invalid:"Invalid",Instance:"Instance",ConstantValue:"ConstantValue",DynamicValue:"DynamicValue"},v={POST_CONSTRUCT:"Cannot apply @PostConstruct decorator multiple times in the same class.",PRE_DESTROY:"Cannot apply @PreDestroy decorator multiple times in the same class.",MISS_INJECT:"Expected a @Inject decorator to explicitly specify the token.",MISS_CONTAINER:"@LazyInject decorator cannot find the corresponding container."},m=Symbol(),D=new WeakMap;function B(n){return typeof n=="function"&&Object.getPrototypeOf(n)!==Function.prototype}function b(n,t,e){const s=D.get(e)||{};s[n]=t,D.set(e,s)}function T(n,t){return(D.get(t)||{})[n]}function I(n,t){const e=T(n,t);if(!B(t))return e;const s=I(n,Object.getPrototypeOf(t));if(s||e)return{...s||{},...e||{}}}class _{constructor(t){r(this,"_","");r(this,"name");this.name=t}}class O{constructor(t){r(this,"callback");this.callback=t}resolve(){return this.callback()}}function A(n){if(!n)throw new Error(v.MISS_INJECT);return n instanceof O?n.resolve():n}class E extends Error{constructor(t,e){super(),this.name=this.constructor.name,this.message=`${t}${e==null?void 0:e.name}`}}class V extends E{constructor(t){super("");const e=[];let s=t;for(;s&&s.token;)e.push(s.token),s=s.parent;const i=e.reverse().map(o=>o.name).join(" --> ");this.message=`Circular dependency found: ${i}`}}class k extends E{constructor(t){super("Invalid binding: ",t)}}class H extends V{constructor(t){super(t),this.name="CircularDependencyError inside @PostConstruct"}}class L{constructor(t,e){r(this,"container");r(this,"context");r(this,"token");r(this,"type",d.Invalid);r(this,"status",p.DEFAULT);r(this,"classValue");r(this,"constantValue");r(this,"dynamicValue");r(this,"cache");r(this,"postConstructResult",m);r(this,"onActivationHandler");r(this,"onDeactivationHandler");this.container=e,this.context={container:this.container},this.token=t}onActivation(t){this.onActivationHandler=t}onDeactivation(t){this.onDeactivationHandler=t}activate(t){const e=this.onActivationHandler?this.onActivationHandler(this.context,t):t;return this.container.activate(e,this.token)}deactivate(){this.onDeactivationHandler&&this.onDeactivationHandler(this.cache)}to(t){return this.type=d.Instance,this.classValue=t,this}toSelf(){return this.to(this.token)}toConstantValue(t){return this.type=d.ConstantValue,this.constantValue=t,this}toDynamicValue(t){return this.type=d.DynamicValue,this.dynamicValue=t,this}toService(t){return this.toDynamicValue(e=>e.container.get(t,{parent:{token:this.token}}))}get(t){if(p.INITING===this.status)throw new V(t);if(p.ACTIVATED===this.status)return this.cache;if(d.Instance===this.type)return this.resolveInstanceValue(t);if(d.ConstantValue===this.type)return this.resolveConstantValue();if(d.DynamicValue===this.type)return this.resolveDynamicValue();throw new k(this.token)}getAwaitBindings(t,e){return e===!0?t:Array.isArray(e)?t.filter(s=>e.includes(s.token)):typeof e=="function"?t.filter(e):[]}postConstruct(t,e,s){if(d.Instance===this.type){const{key:i,value:o}=I(h.POST_CONSTRUCT,this.classValue)||{};if(i)if(o){const a=[...e,...s].filter(u=>d.Instance===(u==null?void 0:u.type)),c=this.getAwaitBindings(a,o);for(const u of c)if(u&&u.postConstructResult===m)throw new H({token:u.token,parent:t});const l=c.map(u=>u.postConstructResult);this.postConstructResult=Promise.all(l).then(()=>this.execute(i))}else this.postConstructResult=this.execute(i);else this.postConstructResult=void 0}}preDestroy(){if(d.Instance===this.type){const{key:t}=I(h.PRE_DESTROY,this.classValue)||{};t&&this.execute(t)}y.map.delete(this.cache),this.container=null,this.context=null,this.classValue=null,this.constantValue=null,this.dynamicValue=null,this.cache=null,this.postConstructResult=m,this.onActivationHandler=void 0,this.onDeactivationHandler=void 0}execute(t){const e=this.cache[t];return e==null?void 0:e.call(this.cache)}resolveInstanceValue(t){this.status=p.INITING;const e=this.classValue,[s,i]=this.getConstructorParameters(t),o=new e(...s);this.cache=this.activate(o),this.status=p.ACTIVATED,y.map.set(this.cache,this.container);const[a,c]=this.getInjectProperties(t);return Object.assign(this.cache,a),this.postConstruct(t,i,c),this.cache}resolveConstantValue(){return this.status=p.INITING,this.cache=this.activate(this.constantValue),this.status=p.ACTIVATED,this.cache}resolveDynamicValue(){this.status=p.INITING;const t=this.dynamicValue.call(this,this.context);return this.cache=this.activate(t),this.status=p.ACTIVATED,this.cache}getConstructorParameters(t){const e=T(h.INJECTED_PARAMS,this.classValue)||[],s=[],i=[];for(let o=0;o<e.length;o++){const a=e[o],{inject:c,...l}=a;l.parent=t;const u=this.container.get(A(c),l);s.push(u),i.push(l.binding)}return[s,i]}getInjectProperties(t){const e=I(h.INJECTED_PROPS,this.classValue)||{},s=Object.keys(e),i=Object.create(null),o=[];for(let a=0;a<s.length;a++){const c=s[a],l=e[c],{inject:u,...f}=l;f.parent=t;const g=this.container.get(A(u),f);g===void 0&&l.optional||(i[c]=g),o.push(f.binding)}return[i,o]}}class M extends E{constructor(t){super("No matching binding found for token: ",t)}}class x extends E{constructor(t){super("Cannot bind token multiple times: ",t)}}const C=class C{constructor(){r(this,"parent");r(this,"children");r(this,"bindings",new Map);r(this,"onActivationHandler");r(this,"onDeactivationHandler")}bind(t){if(this.bindings.has(t))throw new x(t);const e=this.buildBinding(t);return this.bindings.set(t,e),e}unbind(t){if(this.bindings.has(t)){const e=this.getBinding(t);this.deactivate(e),e.deactivate(),e.preDestroy(),this.bindings.delete(t)}}unbindAll(){this.bindings.forEach(t=>{this.unbind(t.token)})}isCurrentBound(t){return this.bindings.has(t)}isBound(t){return this.isCurrentBound(t)||!!this.parent&&this.parent.isBound(t)}createChild(){const t=new C;return t.parent=this,this.children||(this.children=new Set),this.children.add(t),t}destroy(){var t,e,s;this.unbindAll(),this.bindings.clear(),(e=(t=this.parent)==null?void 0:t.children)==null||e.delete(this),this.parent=void 0,(s=this.children)==null||s.clear(),this.children=void 0,this.onActivationHandler=void 0,this.onDeactivationHandler=void 0}get(t,e={}){const s=this.getBinding(t);if(e.skipSelf){if(this.parent)return e.skipSelf=!1,this.parent.get(t,e)}else if(e.self||s){if(s)return e.token=t,e.binding=s,s.get(e)}else if(this.parent)return this.parent.get(t,e);return this.checkBindingNotFoundError(t,e)}onActivation(t){this.onActivationHandler=t}onDeactivation(t){this.onDeactivationHandler=t}activate(t,e){return this.onActivationHandler?this.onActivationHandler({container:this},t,e):t}deactivate(t){this.onDeactivationHandler&&this.onDeactivationHandler(t.cache,t.token)}buildBinding(t){return new L(t,this)}getBinding(t){return this.bindings.get(t)}checkBindingNotFoundError(t,e){if(!e.optional)throw new M(t)}};r(C,"map",new WeakMap);let y=C;function S(n,t){return function(e){return function(s,i,o){const a=typeof o=="number",c=a?s:s.constructor,l=a?o:i,u=a?h.INJECTED_PARAMS:h.INJECTED_PROPS,f=a?T(u,c)||[]:I(u,c)||{},g=f[l]||{};g[n]=e===void 0?t:e,f[l]=g,b(u,f,c)}}}function N(n,t){return e=>(s,i)=>{if(T(n,s.constructor))throw new Error(t);b(n,{key:i,value:e},s.constructor)}}const F=S(h.INJECT),J=S(h.SELF,!0),U=S(h.SKIP_SELF,!0),z=S(h.OPTIONAL,!0),G=N(h.POST_CONSTRUCT,v.POST_CONSTRUCT),Y=N(h.PRE_DESTROY,v.PRE_DESTROY);function P(n,t,e,s){for(let i=n.length-1;i>=0;i--)n[i](t,e,s)}function K(n,t,e){n=Array.isArray(n)?n:[n],typeof e=="number"?P(n,t,void 0,e):typeof e=="string"&&P(n,t.prototype,e)}function $(n,t,e,s){function i(){const a=Symbol.for(t);if(!this.hasOwnProperty(a)){const c=s||y.map.get(this),l=this.constructor;if(!c)throw new Error(`${v.MISS_CONTAINER} ${l.name}`);this[a]=c.get(A(e),{parent:{token:l}})}return this[a]}function o(a){const c=Symbol.for(t);this[c]=a}Object.defineProperty(n,t,{configurable:!0,enumerable:!0,get:i,set:o})}function R(n,t){return function(e,s){$(e,s,n,t)}}function W(n){return function(t){return R(t,n)}}exports.Container=y;exports.Inject=F;exports.LazyInject=R;exports.LazyToken=O;exports.Optional=z;exports.PostConstruct=G;exports.PreDestroy=Y;exports.Self=J;exports.SkipSelf=U;exports.Token=_;exports.createLazyInject=W;exports.decorate=K;
+"use strict";var F=Object.defineProperty;var x=(n,t,e)=>t in n?F(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var r=(n,t,e)=>x(n,typeof t!="symbol"?t+"":t,e);Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l={INJECTED_PROPS:"injected:props",INJECT:"inject",SELF:"self",SKIP_SELF:"skipSelf",OPTIONAL:"optional",POST_CONSTRUCT:"postConstruct",PRE_DESTROY:"preDestroy"},f={DEFAULT:"default",INITING:"initing",ACTIVATED:"activated"},d={Invalid:"Invalid",Instance:"Instance",ConstantValue:"ConstantValue",DynamicValue:"DynamicValue"},T={POST_CONSTRUCT:"Multiple @PostConstruct decorators are not allowed in a single class.",PRE_DESTROY:"Multiple @PreDestroy decorators are not allowed in a single class.",INVALID_TOKEN:"@Inject or @LazyInject requires a valid token, but received null or undefined.",LAZY_INJECT_INVALID_TOKEN:"@LazyInject requires a valid token, but received null or undefined."};function O(n,t){return Object.prototype.hasOwnProperty.call(n,t)}const N=Symbol("UNINITIALIZED"),A=new WeakMap;function U(n){return typeof n=="function"&&Object.getPrototypeOf(n)!==Function.prototype}function V(n,t,e){const i=A.get(e)||{};i[n]=t,A.set(e,i)}function w(n,t){return(A.get(t)||{})[n]}function y(n,t){const e=w(n,t);if(!U(t))return e;const i=y(n,Object.getPrototypeOf(t));if(i||e)return{...i||{},...e||{}}}class J{constructor(t){r(this,"name");this.name=t}}class R{constructor(t){r(this,"_callback");this._callback=t}resolve(){return this._callback()}}function b(n){if(!n)throw new Error(T.INVALID_TOKEN);return n instanceof R?n.resolve():n}class I extends Error{constructor(e,i){const s=(i==null?void 0:i.name)||"<unknown token>";super(`${e}${s}`);r(this,"token");this.name=this.constructor.name,this.token=i}}class m extends I{constructor(t){super("");const e=[];let i=t;for(;i&&i.token;)e.push(i.token),i=i.parent;const s=e.reverse().map(o=>o.name||"<anonymous>").join(" --> ");this.message=`Circular dependency found: ${s}`}}class j extends I{constructor(t){super("Invalid binding: ",t)}}class L extends m{constructor(t){super(t),this.name="CircularDependencyError inside @PostConstruct"}}const E=class E{constructor(t,e){r(this,"container");r(this,"context");r(this,"token");r(this,"type",d.Invalid);r(this,"status",f.DEFAULT);r(this,"classValue");r(this,"constantValue");r(this,"dynamicValue");r(this,"cache");r(this,"postConstructResult",N);r(this,"onActivationHandler");r(this,"onDeactivationHandler");this.container=e,this.context={container:this.container},this.token=t}onActivation(t){this.onActivationHandler=t}onDeactivation(t){this.onDeactivationHandler=t}activate(t){const e=this.onActivationHandler?this.onActivationHandler(this.context,t):t;return this.container.activate(e,this.token)}deactivate(){this.onDeactivationHandler&&this.onDeactivationHandler(this.cache)}to(t){return this.type=d.Instance,this.classValue=t,this}toSelf(){return this.to(this.token)}toConstantValue(t){return this.type=d.ConstantValue,this.constantValue=t,this}toDynamicValue(t){return this.type=d.DynamicValue,this.dynamicValue=t,this}toService(t){return this.toDynamicValue(e=>e.container.get(t,{parent:{token:this.token}}))}get(t){if(f.INITING===this.status)throw new m(t);if(f.ACTIVATED===this.status)return this.cache;const e=E._resolvers[this.type];if(e)return this[e](t);throw new j(this.token)}_getAwaitBindings(t,e){return e===!0?t:Array.isArray(e)?t.filter(i=>e.includes(i.token)):typeof e=="function"?t.filter(e):[]}_postConstruct(t,e){if(d.Instance===this.type){const{key:i,value:s}=y(l.POST_CONSTRUCT,this.classValue)||{};if(i)if(s){const o=e.filter(c=>d.Instance===(c==null?void 0:c.type)),a=this._getAwaitBindings(o,s);for(const c of a)if(c&&c.postConstructResult===N)throw new L({token:c.token,parent:t});const u=a.map(c=>c.postConstructResult);this.postConstructResult=Promise.all(u).then(()=>this._execute(i))}else this.postConstructResult=this._execute(i);else this.postConstructResult=void 0}}preDestroy(){if(d.Instance===this.type){const{key:t}=y(l.PRE_DESTROY,this.classValue)||{};t&&this._execute(t)}_._instanceContainerMap.delete(this.cache),this.container=null,this.context=null,this.classValue=void 0,this.constantValue=void 0,this.dynamicValue=void 0,this.cache=void 0,this.postConstructResult=N,this.onActivationHandler=void 0,this.onDeactivationHandler=void 0}_execute(t){const e=this.cache[t];return e==null?void 0:e.call(this.cache)}_resolveInstanceValue(t){this.status=f.INITING;const e=this._createInstance();this.cache=this.activate(e),this.status=f.ACTIVATED,this._registerInstance();const{properties:i,bindings:s}=this._getInjectProperties(t);return this._injectProperties(i),this._postConstruct(t,s),this.cache}_createInstance(){const t=this.classValue;return new t}_registerInstance(){_._instanceContainerMap.set(this.cache,this.container)}_injectProperties(t){Object.assign(this.cache,t)}_resolveConstantValue(){return this.status=f.INITING,this.cache=this.activate(this.constantValue),this.status=f.ACTIVATED,this.cache}_resolveDynamicValue(){this.status=f.INITING;const t=this.dynamicValue(this.context);return this.cache=this.activate(t),this.status=f.ACTIVATED,this.cache}_getInjectProperties(t){const e=y(l.INJECTED_PROPS,this.classValue)||{},i=Object.keys(e),s=Object.create(null),o=[];for(let a=0;a<i.length;a++){const u=i[a],c=e[u],{inject:p,...v}=c;v.parent=t;const h=this.container.get(b(p),v);h===void 0&&c.optional||(s[u]=h),o.push(v.binding)}return{properties:s,bindings:o}}};r(E,"_resolvers",{[d.Instance]:"_resolveInstanceValue",[d.ConstantValue]:"_resolveConstantValue",[d.DynamicValue]:"_resolveDynamicValue"});let C=E;class k extends I{constructor(t){super("No matching binding found for token: ",t)}}class B extends I{constructor(t){super("Cannot bind token multiple times: ",t)}}const g=class g{constructor(){r(this,"parent");r(this,"children");r(this,"_bindings",new Map);r(this,"_onActivationHandler");r(this,"_onDeactivationHandler")}static getContainerOf(t){return g._instanceContainerMap.get(t)}bind(t){if(this._bindings.has(t))throw new B(t);const e=this._buildBinding(t);return this._bindings.set(t,e),e}unbind(t){if(this._bindings.has(t)){const e=this._getBinding(t);this.deactivate(e),e.deactivate(),e.preDestroy(),this._bindings.delete(t)}}unbindAll(){const t=Array.from(this._bindings.keys());for(const e of t)this.unbind(e)}isCurrentBound(t){return this._bindings.has(t)}isBound(t){return this.isCurrentBound(t)||!!this.parent&&this.parent.isBound(t)}createChild(){const t=new g;return t.parent=this,this.children||(this.children=new Set),this.children.add(t),t}destroy(){var t,e;if(this.children){const i=Array.from(this.children);for(const s of i)s.destroy()}this.unbindAll(),this._bindings.clear(),(e=(t=this.parent)==null?void 0:t.children)==null||e.delete(this),this.parent=void 0,this.children=void 0,this._onActivationHandler=void 0,this._onDeactivationHandler=void 0}get(t,e={}){return e.skipSelf?this._resolveSkipSelf(t,e):e.self?this._resolveSelf(t,e):this._resolveDefault(t,e)}_resolveSkipSelf(t,e){return this.parent?(e.skipSelf=!1,this.parent.get(t,e)):this._checkBindingNotFoundError(t,e)}_resolveSelf(t,e){const i=this._getBinding(t);return i?(e.token=t,e.binding=i,i.get(e)):this._checkBindingNotFoundError(t,e)}_resolveDefault(t,e){const i=this._getBinding(t);return i?(e.token=t,e.binding=i,i.get(e)):this.parent?this.parent.get(t,e):this._checkBindingNotFoundError(t,e)}onActivation(t){this._onActivationHandler=t}onDeactivation(t){this._onDeactivationHandler=t}activate(t,e){return this._onActivationHandler?this._onActivationHandler({container:this},t,e):t}deactivate(t){this._onDeactivationHandler&&this._onDeactivationHandler(t.cache,t.token)}_buildBinding(t){return new C(t,this)}_getBinding(t){return this._bindings.get(t)}_checkBindingNotFoundError(t,e){if(!e.optional)throw new k(t)}};r(g,"_instanceContainerMap",new WeakMap);let _=g;class H extends I{constructor(t,e){super(`@LazyInject(${t==null?void 0:t.name}) in class ${e.name} requires a registered container but none was found. Token: `,t)}}function D(n,t){return function(e){return function(i,s){s.addInitializer(function(){const o=this.constructor,a=s.name,u=w(l.INJECTED_PROPS,o)||{},c=u[a]||{};c[n]=e===void 0?t:e,u[a]=c,V(l.INJECTED_PROPS,u,o)})}}}function M(n,t){return e=>(i,s)=>{const o=s.name,a=s.metadata;if(O(a,n))throw new Error(t);a[n]=!0,s.addInitializer(function(){const u=this.constructor;V(n,{key:o,value:e},u)})}}const Y=D(l.INJECT),G=D(l.SELF,!0),K=D(l.SKIP_SELF,!0),$=D(l.OPTIONAL,!0),Z=M(l.POST_CONSTRUCT,T.POST_CONSTRUCT),q=M(l.PRE_DESTROY,T.PRE_DESTROY);function W(n,t,e,i){if(e==null)throw new Error(T.LAZY_INJECT_INVALID_TOKEN);const s=Symbol.for(t);Object.defineProperty(n,t,{configurable:!0,enumerable:!0,get(){if(!O(n,s)){const o=i||_.getContainerOf(n),a=n.constructor;if(!o)throw new H(b(e),a);n[s]=o.get(b(e),{parent:{token:a}})}return n[s]},set(o){n[s]=o}})}function z(n,t){return function(e,i){const s=i.name;i.addInitializer(function(){W(this,s,n,t)})}}function Q(n){return function(t){return z(t,n)}}const S=Symbol("decorate.metadata");function X(n,t,e){const i=Array.isArray(n)?n:[n],s=t.prototype,o=typeof s[e]=="function",a=[];O(t,S)||(t[S]={});const u=t[S],c={kind:o?"method":"field",name:e,static:!1,private:!1,addInitializer(h){a.push(h)},metadata:u};let p=o?s[e]:void 0;for(let h=i.length-1;h>=0;h--){const P=i[h](p,c);o&&typeof P=="function"&&(p=P)}o&&p!==s[e]&&(s[e]=p);const v=Object.create(s);for(const h of a)h.call(v)}exports.BaseError=I;exports.Binding=C;exports.BindingNotFoundError=k;exports.BindingNotValidError=j;exports.CircularDependencyError=m;exports.Container=_;exports.ContainerNotFoundError=H;exports.DuplicateBindingError=B;exports.Inject=Y;exports.LazyInject=z;exports.LazyToken=R;exports.Optional=$;exports.PostConstruct=Z;exports.PostConstructError=L;exports.PreDestroy=q;exports.Self=G;exports.SkipSelf=K;exports.Token=J;exports.createLazyInject=Q;exports.decorate=X;