@kaokei/di 5.0.4 → 5.0.5

package/README.md

@@ -14,12 +14,11 @@
 
 本库主要特点是参考借鉴了`InversifyJS`和`Angular`的优秀 API 设计，不依赖`reflect-metadata`，支持属性注入的循环依赖。
 
-- [入门指南](./docs/guide/index.md)
+- [快速开始](./docs/guide/index.md)
 - [API 文档](./docs/api/index.md)
-- [博客文章](./docs/note/01.什么是Token.md)
-- [CodeSandbox 在线示例](./docs/guide/EXAMPLES.md)
+- [示例代码](./docs/examples/index.md)
+- [笔记文章](./docs/note/01.什么是Token.md)
 
 ## Todo List
 
 1. 改成tsdown来打包代码
-2. 源码-->单元测试-->文档-->示例代码

package/dist/binding.d.cts

@@ -6,9 +6,9 @@ export interface InjectPropertiesResult {
     bindings: Binding[];
 }
 export declare class Binding<T = unknown> {
-    static _resolvers: Record<string, string>;
-    container: Container;
-    context: Context;
+    static _resolvers: Map<string, (this: Binding, options: Options) => unknown>;
+    container?: Container;
+    context?: Context;
     token: CommonToken<T>;
     type: BindingType;
     status: StatusType;
@@ -31,7 +31,7 @@ export declare class Binding<T = unknown> {
     toDynamicValue(func: DynamicValue<T>): this;
     inTransientScope(): this;
     toService(token: CommonToken<T>): this;
-    get(options: Options<T>): any;
+    get(options: Options<T>): unknown;
     _getAwaitBindings(bindings: Binding[], filter: PostConstructParam): Binding[];
     /**
      * PostConstruct 生命周期处理

package/dist/binding.d.ts

@@ -6,9 +6,9 @@ export interface InjectPropertiesResult {
     bindings: Binding[];
 }
 export declare class Binding<T = unknown> {
-    static _resolvers: Record<string, string>;
-    container: Container;
-    context: Context;
+    static _resolvers: Map<string, (this: Binding, options: Options) => unknown>;
+    container?: Container;
+    context?: Context;
     token: CommonToken<T>;
     type: BindingType;
     status: StatusType;
@@ -31,7 +31,7 @@ export declare class Binding<T = unknown> {
     toDynamicValue(func: DynamicValue<T>): this;
     inTransientScope(): this;
     toService(token: CommonToken<T>): this;
-    get(options: Options<T>): any;
+    get(options: Options<T>): unknown;
     _getAwaitBindings(bindings: Binding[], filter: PostConstructParam): Binding[];
     /**
      * PostConstruct 生命周期处理

package/dist/container.d.cts

@@ -1,34 +1,38 @@
 import { Binding } from './binding';
-import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
+import { GetOptions, Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
 export declare class Container {
     static _instanceContainerMap: WeakMap<object, Container>;
     static getContainerOf(instance: object): Container | undefined;
     parent?: Container;
     children?: Set<Container>;
     _bindings: Map<CommonToken, Binding>;
+    _destroyed: boolean;
     _onActivationHandler?: ActivationHandler;
     _onDeactivationHandler?: DeactivationHandler;
     bind<T>(token: CommonToken<T>): Binding<T>;
     unbind<T>(token: CommonToken<T>): void;
+    tryGet<T>(token: CommonToken<T>): T | undefined;
+    rebind<T>(token: CommonToken<T>): Binding<T>;
     unbindAll(): void;
     isCurrentBound<T>(token: CommonToken<T>): boolean;
     isBound<T>(token: CommonToken<T>): boolean;
     createChild(): Container;
     destroy(): void;
-    get<T>(token: CommonToken<T>, options: Options<T> & {
+    get<T>(token: CommonToken<T>, options: GetOptions & {
         optional: true;
     }): T | void;
-    get<T>(token: CommonToken<T>, options?: Options<T> & {
+    get<T>(token: CommonToken<T>, options?: GetOptions & {
         optional?: false;
     }): T;
-    get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
-    getAsync<T>(token: CommonToken<T>, options: Options<T> & {
+    get<T>(token: CommonToken<T>, options?: GetOptions): T | void;
+    getAsync<T>(token: CommonToken<T>, options: GetOptions & {
         optional: true;
     }): Promise<T | void>;
-    getAsync<T>(token: CommonToken<T>, options?: Options<T> & {
+    getAsync<T>(token: CommonToken<T>, options?: GetOptions & {
         optional?: false;
     }): Promise<T>;
-    getAsync<T>(token: CommonToken<T>, options?: Options<T>): Promise<T | void>;
+    getAsync<T>(token: CommonToken<T>, options?: GetOptions): Promise<T | void>;
+    _resolveWithInternalOpts<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;

package/dist/container.d.ts

@@ -1,34 +1,38 @@
 import { Binding } from './binding';
-import { Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
+import { GetOptions, Options, CommonToken, ActivationHandler, DeactivationHandler } from './interfaces';
 export declare class Container {
     static _instanceContainerMap: WeakMap<object, Container>;
     static getContainerOf(instance: object): Container | undefined;
     parent?: Container;
     children?: Set<Container>;
     _bindings: Map<CommonToken, Binding>;
+    _destroyed: boolean;
     _onActivationHandler?: ActivationHandler;
     _onDeactivationHandler?: DeactivationHandler;
     bind<T>(token: CommonToken<T>): Binding<T>;
     unbind<T>(token: CommonToken<T>): void;
+    tryGet<T>(token: CommonToken<T>): T | undefined;
+    rebind<T>(token: CommonToken<T>): Binding<T>;
     unbindAll(): void;
     isCurrentBound<T>(token: CommonToken<T>): boolean;
     isBound<T>(token: CommonToken<T>): boolean;
     createChild(): Container;
     destroy(): void;
-    get<T>(token: CommonToken<T>, options: Options<T> & {
+    get<T>(token: CommonToken<T>, options: GetOptions & {
         optional: true;
     }): T | void;
-    get<T>(token: CommonToken<T>, options?: Options<T> & {
+    get<T>(token: CommonToken<T>, options?: GetOptions & {
         optional?: false;
     }): T;
-    get<T>(token: CommonToken<T>, options?: Options<T>): T | void;
-    getAsync<T>(token: CommonToken<T>, options: Options<T> & {
+    get<T>(token: CommonToken<T>, options?: GetOptions): T | void;
+    getAsync<T>(token: CommonToken<T>, options: GetOptions & {
         optional: true;
     }): Promise<T | void>;
-    getAsync<T>(token: CommonToken<T>, options?: Options<T> & {
+    getAsync<T>(token: CommonToken<T>, options?: GetOptions & {
         optional?: false;
     }): Promise<T>;
-    getAsync<T>(token: CommonToken<T>, options?: Options<T>): Promise<T | void>;
+    getAsync<T>(token: CommonToken<T>, options?: GetOptions): Promise<T | void>;
+    _resolveWithInternalOpts<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;

package/dist/errors/BindingNotFoundError.d.cts

@@ -1,5 +1,5 @@
 import { BaseError } from './BaseError';
-import { CommonToken } from '../interfaces';
+import { CommonToken, Options } from '../interfaces';
 export declare class BindingNotFoundError extends BaseError {
-    constructor(token: CommonToken);
+    constructor(token: CommonToken, options?: Options);
 }

package/dist/errors/BindingNotFoundError.d.ts

@@ -1,5 +1,5 @@
 import { BaseError } from './BaseError';
-import { CommonToken } from '../interfaces';
+import { CommonToken, Options } from '../interfaces';
 export declare class BindingNotFoundError extends BaseError {
-    constructor(token: CommonToken);
+    constructor(token: CommonToken, options?: Options);
 }

package/dist/errors/ContainerDestroyedError.d.cts

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

package/dist/errors/ContainerDestroyedError.d.ts

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

package/dist/index.cjs

@@ -1 +1,3 @@
-"use strict";var z=Object.defineProperty;var U=(n,t,e)=>t in n?z(n,t,{enumerable:!0,configurable:!0,writable:!0,value:e}):n[t]=e;var r=(n,t,e)=>U(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"},p={INVALID:"Invalid",INSTANCE:"Instance",CONSTANT:"ConstantValue",DYNAMIC:"DynamicValue"},g={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."},S=Symbol("UNINITIALIZED");function E(n,t){return Object.prototype.hasOwnProperty.call(n,t)}function Y(n){return n!==null&&typeof n=="object"}const y=new WeakMap;function b(n){return typeof n=="function"&&Object.getPrototypeOf(n)!==Function.prototype}function m(n,t){y.set(n,t)}function V(n){const t=y.get(n);if(t)return t[l.POST_CONSTRUCT];if(b(n))return V(Object.getPrototypeOf(n))}function j(n){const t=y.get(n);if(t)return t[l.PRE_DESTROY];if(b(n))return j(Object.getPrototypeOf(n))}function w(n){const t=y.get(n),e=t&&E(t,l.INJECTED_PROPS)?t[l.INJECTED_PROPS]:void 0;if(!b(n))return e;const i=w(Object.getPrototypeOf(n));if(i||e)return Object.assign({},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 O(n){if(!n)throw new Error(g.INVALID_TOKEN);return n instanceof R?n.resolve():n}class _ 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 P extends _{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 L extends _{constructor(t){super("Invalid binding: ",t)}}class k extends P{constructor(t){super(t),this.name="CircularDependencyError inside @PostConstruct"}}const C=class C{constructor(t,e){r(this,"container");r(this,"context");r(this,"token");r(this,"type",p.INVALID);r(this,"status",f.DEFAULT);r(this,"classValue");r(this,"constantValue");r(this,"dynamicValue");r(this,"cache");r(this,"postConstructResult",S);r(this,"transient",!1);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=p.INSTANCE,this.classValue=t,this}toSelf(){return this.to(this.token)}toConstantValue(t){return this.type=p.CONSTANT,this.constantValue=t,this}toDynamicValue(t){return this.type=p.DYNAMIC,this.dynamicValue=t,this}inTransientScope(){return this.transient=!0,this}toService(t){return this.toDynamicValue(e=>e.container.get(t,{parent:{token:this.token}}))}get(t){if(f.INITING===this.status)throw new P(t);if(f.ACTIVATED===this.status)if(this.transient)this.status=f.DEFAULT;else return this.cache;const e=C._resolvers[this.type];if(e)return this[e](t);throw new L(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(p.INSTANCE===this.type){const{key:i,value:s}=V(this.classValue)||{};if(i)if(s){const o=e.filter(u=>p.INSTANCE===(u==null?void 0:u.type)),a=this._getAwaitBindings(o,s);for(const u of a)if(u&&u.postConstructResult===S)throw new k({token:u.token,parent:t});const c=a.map(u=>u.postConstructResult);this.postConstructResult=Promise.all(c).then(()=>this._execute(i))}else this.postConstructResult=this._execute(i);else this.postConstructResult=void 0}}preDestroy(){if(p.INSTANCE===this.type){const{key:t}=j(this.classValue)||{};t&&this._execute(t)}I._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=S,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(){I._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=w(this.classValue)||{},i=Object.keys(e),s=Object.create(null),o=[];for(let a=0;a<i.length;a++){const c=i[a],u=e[c],h=Object.assign({},u);h.parent=t;const d=this.container.get(O(h.inject),h);d===void 0&&h.optional||(s[c]=d),o.push(h.binding)}return{properties:s,bindings:o}}};r(C,"_resolvers",{[p.INSTANCE]:"_resolveInstanceValue",[p.CONSTANT]:"_resolveConstantValue",[p.DYNAMIC]:"_resolveDynamicValue"});let T=C;class B extends _{constructor(t){super("No matching binding found for token: ",t)}}class H extends _{constructor(t){super("Cannot bind token multiple times: ",t)}}const v=class v{constructor(){r(this,"parent");r(this,"children");r(this,"_bindings",new Map);r(this,"_onActivationHandler");r(this,"_onDeactivationHandler")}static getContainerOf(t){return v._instanceContainerMap.get(t)}bind(t){if(this._bindings.has(t))throw new H(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 v;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)}getAsync(t,e={}){let i;try{i=this.get(t,e)}catch(o){return Promise.reject(o)}const s=e.binding;return(s==null?void 0:s.postConstructResult)instanceof Promise?s.postConstructResult.then(()=>i):Promise.resolve(i)}_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 T(t,this)}_getBinding(t){return this._bindings.get(t)}_checkBindingNotFoundError(t,e){if(!e.optional)throw new B(t)}};r(v,"_instanceContainerMap",new WeakMap);let I=v;class M extends _{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){const o=s.name,a=s.metadata;E(a,l.INJECTED_PROPS)||(a[l.INJECTED_PROPS]={});const c=a[l.INJECTED_PROPS];c[o]||(c[o]={}),c[o][n]=e===void 0?t:e}}}function F(n,t){return e=>(i,s)=>{const o=s.name,a=s.metadata;if(E(a,n))throw new Error(t);a[n]={key:o,value:e}}}const K=D(l.INJECT),G=D(l.SELF,!0),$=D(l.SKIP_SELF,!0),Z=D(l.OPTIONAL,!0),q=F(l.POST_CONSTRUCT,g.POST_CONSTRUCT),W=F(l.PRE_DESTROY,g.PRE_DESTROY);function Q(){return function(n,t){const e=t.metadata;m(n,e)}}function X(n,t,e,i){if(e==null)throw new Error(g.LAZY_INJECT_INVALID_TOKEN);let s,o=!1;Object.defineProperty(n,t,{configurable:!0,enumerable:!0,get(){if(!o){const a=i||I.getContainerOf(n),c=n.constructor;if(!a)throw new M(O(e),c);s=a.get(O(e),{parent:{token:c}}),o=!0}return s},set(a){s=a,o=!0}})}function x(n,t){return function(e,i){const s=i.name;i.addInitializer(function(){X(this,s,n,t)})}}function tt(n){return function(t){return x(t,n)}}function et(n,t){const e=t.name;t.addInitializer(function(){this[e]=n.bind(this)})}const A=new WeakMap;function nt(n,t,e){const i=Array.isArray(n)?n:[n],s=t.prototype,o=typeof s[e]=="function",a=[];A.has(t)||A.set(t,{});const c=A.get(t),u={kind:o?"method":"field",name:e,static:!1,private:!1,addInitializer(d){a.push(d)},metadata:c};let h=o?s[e]:void 0;for(let d=i.length-1;d>=0;d--){const N=i[d](h,u);o&&typeof N=="function"&&(h=N)}if(o&&h!==s[e]&&(s[e]=h),m(t,c),a.length>0){const d=Object.create(s);for(const N of a)N.call(d)}}exports.BaseError=_;exports.Binding=T;exports.BindingNotFoundError=B;exports.BindingNotValidError=L;exports.CircularDependencyError=P;exports.Container=I;exports.ContainerNotFoundError=M;exports.DuplicateBindingError=H;exports.ERRORS=g;exports.Inject=K;exports.Injectable=Q;exports.LazyInject=x;exports.LazyToken=R;exports.Optional=Z;exports.PostConstruct=q;exports.PostConstructError=k;exports.PreDestroy=W;exports.Self=G;exports.SkipSelf=$;exports.Token=J;exports.autobind=et;exports.createLazyInject=tt;exports.decorate=nt;exports.hasOwn=E;exports.isObject=Y;
+"use strict";var Y=Object.defineProperty;var J=(n,t,e)=>t in n?Y(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 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"},p={INVALID:"Invalid",INSTANCE:"Instance",CONSTANT:"ConstantValue",DYNAMIC:"DynamicValue"},C={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."},D=Symbol("UNINITIALIZED");function E(n,t){return Object.prototype.hasOwnProperty.call(n,t)}function G(n){return n!==null&&typeof n=="object"}const O=new WeakMap,y=new WeakMap;function m(n){return typeof n=="function"&&Object.getPrototypeOf(n)!==Function.prototype}function j(n,t){O.set(n,t),y.delete(n)}function V(n){const t=O.get(n);if(t)return t[l.POST_CONSTRUCT];if(m(n))return V(Object.getPrototypeOf(n))}function w(n){const t=O.get(n);if(t)return t[l.PRE_DESTROY];if(m(n))return w(Object.getPrototypeOf(n))}function R(n){if(y.has(n)){const e=y.get(n);return e&&Object.assign({},e)}const t=K(n);return y.set(n,t),t&&Object.assign({},t)}function K(n){const t=O.get(n),e=t&&E(t,l.INJECTED_PROPS)?t[l.INJECTED_PROPS]:void 0;if(!m(n))return e;const i=R(Object.getPrototypeOf(n));if(i||e)return Object.assign({},i,e)}class q{constructor(t){r(this,"name");this.name=t}}class L{constructor(t){r(this,"_callback");this._callback=t}resolve(){return this._callback()}}function A(n){if(!n)throw new Error(C.INVALID_TOKEN);return n instanceof L?n.resolve():n}class _ 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}}function B(n){const t=[];let e=n;for(;e&&e.token;)t.push(e.token.name||"<anonymous>"),e=e.parent;return t.reverse()}class P extends _{constructor(t){super(""),this.message="Circular dependency found: "+B(t).join(" --> ")}}class k extends _{constructor(t){super("Binding is not configured (missing .to() / .toSelf() / .toConstantValue() / .toDynamicValue()): ",t)}}class M extends P{constructor(t){super(t),this.name="CircularDependencyError inside @PostConstruct"}}const T=class T{constructor(t,e){r(this,"container");r(this,"context");r(this,"token");r(this,"type",p.INVALID);r(this,"status",f.DEFAULT);r(this,"classValue");r(this,"constantValue");r(this,"dynamicValue");r(this,"cache");r(this,"postConstructResult",D);r(this,"transient",!1);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=p.INSTANCE,this.classValue=t,this}toSelf(){return this.to(this.token)}toConstantValue(t){return this.type=p.CONSTANT,this.constantValue=t,this}toDynamicValue(t){return this.type=p.DYNAMIC,this.dynamicValue=t,this}inTransientScope(){return this.transient=!0,this}toService(t){return this.toDynamicValue(e=>e.container._resolveWithInternalOpts(t,{parent:{token:this.token}}))}get(t){if(f.INITING===this.status)throw new P(t);if(f.ACTIVATED===this.status)if(this.transient)this.status=f.DEFAULT;else return this.cache;const e=T._resolvers.get(this.type);if(e)return e.call(this,t);throw new k(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(p.INSTANCE===this.type){const{key:i,value:s}=V(this.classValue)||{};if(i)if(s){const o=e.filter(u=>p.INSTANCE===(u==null?void 0:u.type)),a=this._getAwaitBindings(o,s);for(const u of a)if(u&&u.postConstructResult===D)throw new M({token:u.token,parent:t});const c=a.map(u=>u.postConstructResult);this.postConstructResult=Promise.all(c).then(()=>this._execute(i))}else this.postConstructResult=this._execute(i);else this.postConstructResult=void 0}}preDestroy(){if(p.INSTANCE===this.type&&this.cache!==void 0){const{key:t}=w(this.classValue)||{};t&&this._execute(t)}this.container&&!this.container._destroyed&&I._instanceContainerMap.delete(this.cache),this.container=void 0,this.context=void 0,this.classValue=void 0,this.constantValue=void 0,this.dynamicValue=void 0,this.cache=void 0,this.postConstructResult=D,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(){I._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=R(this.classValue)||{},i=Object.keys(e),s=Object.create(null),o=[];for(let a=0;a<i.length;a++){const c=i[a],u=e[c],h=Object.assign({},u);h.parent=t;const d=this.container._resolveWithInternalOpts(A(h.inject),h);d===void 0&&h.optional||(s[c]=d),o.push(h.binding)}return{properties:s,bindings:o}}};r(T,"_resolvers",new Map([[p.INSTANCE,function(t){return this._resolveInstanceValue(t)}],[p.CONSTANT,function(t){return this._resolveConstantValue()}],[p.DYNAMIC,function(t){return this._resolveDynamicValue()}]]));let N=T;class H extends _{constructor(t,e){if(super("No matching binding found for token: ",t),e!=null&&e.parent){const i=B(e.parent);i.length>0&&(this.message+=`
+`+i.map(s=>"  required by: "+s).join(`
+`))}}}class F extends _{constructor(t){super("Cannot bind token multiple times: ",t)}}class x extends _{constructor(t){super("Container has been destroyed. Cannot call get() for token: ",t)}}const v=class v{constructor(){r(this,"parent");r(this,"children");r(this,"_bindings",new Map);r(this,"_destroyed",!1);r(this,"_onActivationHandler");r(this,"_onDeactivationHandler")}static getContainerOf(t){return v._instanceContainerMap.get(t)}bind(t){if(this._bindings.has(t))throw new F(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)}}tryGet(t){return this.get(t,{optional:!0})}rebind(t){return this._bindings.has(t)&&this.unbind(t),this.bind(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 v;return t.parent=this,this.children||(this.children=new Set),this.children.add(t),t}destroy(){var t,e;if(this._destroyed=!0,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={}){const i=Object.assign({},e);return this._resolveWithInternalOpts(t,i)}getAsync(t,e={}){const i=Object.assign({},e);let s;try{s=this._resolveWithInternalOpts(t,i)}catch(a){return Promise.reject(a)}const o=i.binding;return(o==null?void 0:o.postConstructResult)instanceof Promise?o.postConstructResult.then(()=>s):Promise.resolve(s)}_resolveWithInternalOpts(t,e){if(this._destroyed)throw new x(t);return e.skipSelf?this._resolveSkipSelf(t,e):e.self?this._resolveSelf(t,e):this._resolveDefault(t,e)}_resolveSkipSelf(t,e){if(this.parent){const i=Object.assign({},e,{skipSelf:!1});return this.parent._resolveWithInternalOpts(t,i)}return 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._resolveWithInternalOpts(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 N(t,this)}_getBinding(t){return this._bindings.get(t)}_checkBindingNotFoundError(t,e){if(!e.optional)throw new H(t,e)}};r(v,"_instanceContainerMap",new WeakMap);let I=v;class z extends _{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 b(n,t){return function(e){return function(i,s){const o=s.name,a=s.metadata;E(a,l.INJECTED_PROPS)||(a[l.INJECTED_PROPS]={});const c=a[l.INJECTED_PROPS];c[o]||(c[o]={}),c[o][n]=e===void 0?t:e}}}function W(n,t){return e=>(i,s)=>{const o=s.name,a=s.metadata;if(E(a,n))throw new Error(t);a[n]={key:o,value:e}}}const Z=b(l.INJECT),$=b(l.SELF,!0),Q=b(l.SKIP_SELF,!0),X=b(l.OPTIONAL,!0),tt=W(l.POST_CONSTRUCT,C.POST_CONSTRUCT),et=W(l.PRE_DESTROY,C.PRE_DESTROY);function nt(){return function(n,t){const e=t.metadata;j(n,e)}}function it(n,t,e,i){if(e==null)throw new Error(C.LAZY_INJECT_INVALID_TOKEN);let s,o=!1;Object.defineProperty(n,t,{configurable:!0,enumerable:!0,get(){if(!o){const a=i||I.getContainerOf(n),c=n.constructor;if(!a)throw new z(A(e),c);s=a._resolveWithInternalOpts(A(e),{parent:{token:c}}),o=!0}return s},set(a){s=a,o=!0}})}function U(n,t){return function(e,i){const s=i.name;i.addInitializer(function(){it(this,s,n,t)})}}function st(n){return function(t){return U(t,n)}}function rt(n,t){const e=t.name;t.addInitializer(function(){this[e]=n.bind(this)})}const S=new WeakMap;function ot(n,t,e){const i=Array.isArray(n)?n:[n],s=t.prototype,o=typeof s[e]=="function",a=[];S.has(t)||S.set(t,{});const c=S.get(t),u={kind:o?"method":"field",name:e,static:!1,private:!1,addInitializer(d){a.push(d)},metadata:c};let h=o?s[e]:void 0;for(let d=i.length-1;d>=0;d--){const g=i[d](h,u);o&&typeof g=="function"&&(h=g)}if(o&&h!==s[e]&&(s[e]=h),j(t,c),a.length>0){const d=Object.create(s);for(const g of a)g.call(d)}}exports.BaseError=_;exports.Binding=N;exports.BindingNotFoundError=H;exports.BindingNotValidError=k;exports.CircularDependencyError=P;exports.Container=I;exports.ContainerDestroyedError=x;exports.ContainerNotFoundError=z;exports.DuplicateBindingError=F;exports.ERRORS=C;exports.Inject=Z;exports.Injectable=nt;exports.LazyInject=U;exports.LazyToken=L;exports.Optional=X;exports.PostConstruct=tt;exports.PostConstructError=M;exports.PreDestroy=et;exports.Self=$;exports.SkipSelf=Q;exports.Token=q;exports.autobind=rt;exports.createLazyInject=st;exports.decorate=ot;exports.hasOwn=E;exports.isObject=G;

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-export type { Newable, InjectFunction, CommonToken, TokenType, GenericToken, LazyTokenCallback, Context, DynamicValue, RecordObject, Options, ActivationHandler, DeactivationHandler, PostConstructParam, } from './interfaces';
+export type { Newable, InjectFunction, CommonToken, TokenType, GenericToken, LazyTokenCallback, Context, DynamicValue, RecordObject, GetOptions, Options, ActivationHandler, DeactivationHandler, PostConstructParam, } from './interfaces';
 export { Container } from './container';
 export { Binding } from './binding';
 export { Token, LazyToken } from './token';
@@ -10,4 +10,5 @@ export { CircularDependencyError } from './errors/CircularDependencyError';
 export { DuplicateBindingError } from './errors/DuplicateBindingError';
 export { PostConstructError } from './errors/PostConstructError';
 export { ContainerNotFoundError } from './errors/ContainerNotFoundError';
+export { ContainerDestroyedError } from './errors/ContainerDestroyedError';
 export { hasOwn, isObject, ERRORS } from './constants';

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export type { Newable, InjectFunction, CommonToken, TokenType, GenericToken, LazyTokenCallback, Context, DynamicValue, RecordObject, Options, ActivationHandler, DeactivationHandler, PostConstructParam, } from './interfaces';
+export type { Newable, InjectFunction, CommonToken, TokenType, GenericToken, LazyTokenCallback, Context, DynamicValue, RecordObject, GetOptions, Options, ActivationHandler, DeactivationHandler, PostConstructParam, } from './interfaces';
 export { Container } from './container';
 export { Binding } from './binding';
 export { Token, LazyToken } from './token';
@@ -10,4 +10,5 @@ export { CircularDependencyError } from './errors/CircularDependencyError';
 export { DuplicateBindingError } from './errors/DuplicateBindingError';
 export { PostConstructError } from './errors/PostConstructError';
 export { ContainerNotFoundError } from './errors/ContainerNotFoundError';
+export { ContainerDestroyedError } from './errors/ContainerDestroyedError';
 export { hasOwn, isObject, ERRORS } from './constants';

package/dist/index.js

@@ -1,6 +1,6 @@
-var L = Object.defineProperty;
-var k = (n, t, e) => t in n ? L(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
-var r = (n, t, e) => k(n, typeof t != "symbol" ? t + "" : t, e);
+var B = Object.defineProperty;
+var M = (n, t, e) => t in n ? B(n, t, { enumerable: !0, configurable: !0, writable: !0, value: e }) : n[t] = e;
+var r = (n, t, e) => M(n, typeof t != "symbol" ? t + "" : t, e);
 const l = {
   // 记录实例属性装饰器对应的数据的键
   INJECTED_PROPS: "injected:props",
@@ -25,7 +25,7 @@ const l = {
   INSTANCE: "Instance",
   CONSTANT: "ConstantValue",
   DYNAMIC: "DynamicValue"
-}, g = {
+}, T = {
   // 用于 decorator.ts 的 createMetaDecorator —— 重复装饰器检测
   POST_CONSTRUCT: "Multiple @PostConstruct decorators are not allowed in a single class.",
   PRE_DESTROY: "Multiple @PreDestroy decorators are not allowed in a single class.",
@@ -33,50 +33,58 @@ const l = {
   INVALID_TOKEN: "@Inject or @LazyInject requires a valid token, but received null or undefined.",
   // 用于 decorator.ts 的 defineLazyProperty —— 无效 token
   LAZY_INJECT_INVALID_TOKEN: "@LazyInject requires a valid token, but received null or undefined."
-}, y = Symbol("UNINITIALIZED");
+}, E = Symbol("UNINITIALIZED");
 function m(n, t) {
   return Object.prototype.hasOwnProperty.call(n, t);
 }
-function K(n) {
+function Z(n) {
   return n !== null && typeof n == "object";
 }
-const C = /* @__PURE__ */ new WeakMap();
-function O(n) {
+const y = /* @__PURE__ */ new WeakMap(), g = /* @__PURE__ */ new WeakMap();
+function S(n) {
   return typeof n == "function" && Object.getPrototypeOf(n) !== Function.prototype;
 }
-function b(n, t) {
-  C.set(n, t);
+function P(n, t) {
+  y.set(n, t), g.delete(n);
 }
-function P(n) {
-  const t = C.get(n);
+function V(n) {
+  const t = y.get(n);
   if (t)
     return t[l.POST_CONSTRUCT];
-  if (O(n))
-    return P(Object.getPrototypeOf(n));
+  if (S(n))
+    return V(Object.getPrototypeOf(n));
 }
-function V(n) {
-  const t = C.get(n);
+function w(n) {
+  const t = y.get(n);
   if (t)
     return t[l.PRE_DESTROY];
-  if (O(n))
-    return V(Object.getPrototypeOf(n));
+  if (S(n))
+    return w(Object.getPrototypeOf(n));
 }
-function w(n) {
-  const t = C.get(n), e = t && m(t, l.INJECTED_PROPS) ? t[l.INJECTED_PROPS] : void 0;
-  if (!O(n))
+function j(n) {
+  if (g.has(n)) {
+    const e = g.get(n);
+    return e && Object.assign({}, e);
+  }
+  const t = H(n);
+  return g.set(n, t), t && Object.assign({}, t);
+}
+function H(n) {
+  const t = y.get(n), e = t && m(t, l.INJECTED_PROPS) ? t[l.INJECTED_PROPS] : void 0;
+  if (!S(n))
     return e;
-  const i = w(Object.getPrototypeOf(n));
+  const i = j(Object.getPrototypeOf(n));
   if (i || e)
     return Object.assign({}, i, e);
 }
-class G {
+class $ {
   constructor(t) {
     // 仅类型层面存在，无运行时开销
     r(this, "name");
     this.name = t;
   }
 }
-class B {
+class x {
   constructor(t) {
     r(this, "_callback");
     this._callback = t;
@@ -87,10 +95,10 @@ class B {
 }
 function D(n) {
   if (!n)
-    throw new Error(g.INVALID_TOKEN);
-  return n instanceof B ? n.resolve() : n;
+    throw new Error(T.INVALID_TOKEN);
+  return n instanceof x ? n.resolve() : n;
 }
-class v extends Error {
+class _ extends Error {
   constructor(e, i) {
     const s = (i == null ? void 0 : i.name) || "<unknown token>";
     super(`${e}${s}`);
@@ -98,28 +106,32 @@ class v extends Error {
     this.name = this.constructor.name, this.token = i;
   }
 }
-class R extends v {
+function R(n) {
+  const t = [];
+  let e = n;
+  for (; e && e.token; )
+    t.push(e.token.name || "<anonymous>"), e = e.parent;
+  return t.reverse();
+}
+class L extends _ {
   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}`;
+    super(""), this.message = "Circular dependency found: " + R(t).join(" --> ");
   }
 }
-class H extends v {
+class F extends _ {
   constructor(t) {
-    super("Invalid binding: ", t);
+    super(
+      "Binding is not configured (missing .to() / .toSelf() / .toConstantValue() / .toDynamicValue()): ",
+      t
+    );
   }
 }
-class M extends R {
+class W extends L {
   constructor(t) {
     super(t), this.name = "CircularDependencyError inside @PostConstruct";
   }
 }
-const T = class T {
+const N = class N {
   constructor(t, e) {
     r(this, "container");
     r(this, "context");
@@ -130,7 +142,7 @@ const T = class T {
     r(this, "constantValue");
     r(this, "dynamicValue");
     r(this, "cache");
-    r(this, "postConstructResult", y);
+    r(this, "postConstructResult", E);
     // 是否为瞬态作用域，默认 false（单例）
     r(this, "transient", !1);
     r(this, "onActivationHandler");
@@ -167,21 +179,21 @@ const T = class T {
   }
   toService(t) {
     return this.toDynamicValue(
-      (e) => e.container.get(t, { parent: { token: this.token } })
+      (e) => e.container._resolveWithInternalOpts(t, { parent: { token: this.token } })
     );
   }
   get(t) {
     if (f.INITING === this.status)
-      throw new R(t);
+      throw new L(t);
     if (f.ACTIVATED === this.status)
       if (this.transient)
         this.status = f.DEFAULT;
       else
         return this.cache;
-    const e = T._resolvers[this.type];
+    const e = N._resolvers.get(this.type);
     if (e)
-      return this[e](t);
-    throw new H(this.token);
+      return e.call(this, t);
+    throw new F(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) : [];
@@ -201,15 +213,15 @@ const T = class T {
    */
   _postConstruct(t, e) {
     if (p.INSTANCE === this.type) {
-      const { key: i, value: s } = P(this.classValue) || {};
+      const { key: i, value: s } = V(this.classValue) || {};
       if (i)
         if (s) {
           const o = e.filter(
             (u) => p.INSTANCE === (u == null ? void 0 : u.type)
           ), a = this._getAwaitBindings(o, s);
           for (const u of a)
-            if (u && u.postConstructResult === y)
-              throw new M({
+            if (u && u.postConstructResult === E)
+              throw new W({
                 token: u.token,
                 parent: t
               });
@@ -224,11 +236,11 @@ const T = class T {
     }
   }
   preDestroy() {
-    if (p.INSTANCE === this.type) {
-      const { key: t } = V(this.classValue) || {};
+    if (p.INSTANCE === this.type && this.cache !== void 0) {
+      const { key: t } = w(this.classValue) || {};
       t && this._execute(t);
     }
-    I._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 = y, this.onActivationHandler = void 0, this.onDeactivationHandler = void 0;
+    this.container && !this.container._destroyed && v._instanceContainerMap.delete(this.cache), this.container = void 0, this.context = void 0, this.classValue = void 0, this.constantValue = void 0, this.dynamicValue = void 0, this.cache = void 0, this.postConstructResult = E, this.onActivationHandler = void 0, this.onDeactivationHandler = void 0;
   }
   _execute(t) {
     const e = this.cache[t];
@@ -248,7 +260,7 @@ const T = class T {
   }
   // 注册实例与容器的映射关系
   _registerInstance() {
-    I._instanceContainerMap.set(this.cache, this.container);
+    v._instanceContainerMap.set(this.cache, this.container);
   }
   // 将解析后的属性注入到实例上
   _injectProperties(t) {
@@ -263,11 +275,11 @@ const T = class T {
     return this.cache = this.activate(t), this.status = f.ACTIVATED, this.cache;
   }
   _getInjectProperties(t) {
-    const e = w(this.classValue) || {}, i = Object.keys(e), s = /* @__PURE__ */ Object.create(null), o = [];
+    const e = j(this.classValue) || {}, i = Object.keys(e), s = /* @__PURE__ */ Object.create(null), o = [];
     for (let a = 0; a < i.length; a++) {
       const c = i[a], u = e[c], h = Object.assign({}, u);
       h.parent = t;
-      const d = this.container.get(
+      const d = this.container._resolveWithInternalOpts(
         D(h.inject),
         h
       );
@@ -276,38 +288,55 @@ const T = class T {
     return { properties: s, bindings: o };
   }
 };
-// 类型到解析方法的静态映射表，用于替代 get 方法中的 if-else 链
-r(T, "_resolvers", {
-  [p.INSTANCE]: "_resolveInstanceValue",
-  [p.CONSTANT]: "_resolveConstantValue",
-  [p.DYNAMIC]: "_resolveDynamicValue"
-});
-let S = T;
-class x extends v {
-  constructor(t) {
-    super("No matching binding found for token: ", t);
+// 类型到解析函数的静态映射表，直接存储函数引用，消除字符串查表和 as any 间接调用
+r(N, "_resolvers", /* @__PURE__ */ new Map([
+  [p.INSTANCE, function(t) {
+    return this._resolveInstanceValue(t);
+  }],
+  [p.CONSTANT, function(t) {
+    return this._resolveConstantValue();
+  }],
+  [p.DYNAMIC, function(t) {
+    return this._resolveDynamicValue();
+  }]
+]));
+let A = N;
+class z extends _ {
+  constructor(t, e) {
+    if (super("No matching binding found for token: ", t), e != null && e.parent) {
+      const i = R(e.parent);
+      i.length > 0 && (this.message += `
+` + i.map((s) => "  required by: " + s).join(`
+`));
+    }
   }
 }
-class F extends v {
+class U extends _ {
   constructor(t) {
     super("Cannot bind token multiple times: ", t);
   }
 }
-const _ = class _ {
+class Y extends _ {
+  constructor(t) {
+    super("Container has been destroyed. Cannot call get() for token: ", t);
+  }
+}
+const I = class I {
   constructor() {
     r(this, "parent");
     r(this, "children");
     r(this, "_bindings", /* @__PURE__ */ new Map());
+    r(this, "_destroyed", !1);
     r(this, "_onActivationHandler");
     r(this, "_onDeactivationHandler");
   }
   // 查询实例所属的容器
   static getContainerOf(t) {
-    return _._instanceContainerMap.get(t);
+    return I._instanceContainerMap.get(t);
   }
   bind(t) {
     if (this._bindings.has(t))
-      throw new F(t);
+      throw new U(t);
     const e = this._buildBinding(t);
     return this._bindings.set(t, e), e;
   }
@@ -317,6 +346,12 @@ const _ = class _ {
       this.deactivate(e), e.deactivate(), e.preDestroy(), this._bindings.delete(t);
     }
   }
+  tryGet(t) {
+    return this.get(t, { optional: !0 });
+  }
+  rebind(t) {
+    return this._bindings.has(t) && this.unbind(t), this.bind(t);
+  }
   unbindAll() {
     const t = Array.from(this._bindings.keys());
     for (const e of t)
@@ -329,12 +364,12 @@ const _ = class _ {
     return this.isCurrentBound(t) || !!this.parent && this.parent.isBound(t);
   }
   createChild() {
-    const t = new _();
+    const t = new I();
     return t.parent = this, this.children || (this.children = /* @__PURE__ */ new Set()), this.children.add(t), t;
   }
   destroy() {
     var t, e;
-    if (this.children) {
+    if (this._destroyed = !0, this.children) {
       const i = Array.from(this.children);
       for (const s of i)
         s.destroy();
@@ -342,21 +377,33 @@ const _ = class _ {
     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);
+    const i = Object.assign({}, e);
+    return this._resolveWithInternalOpts(t, i);
   }
   getAsync(t, e = {}) {
-    let i;
+    const i = Object.assign({}, e);
+    let s;
     try {
-      i = this.get(t, e);
-    } catch (o) {
-      return Promise.reject(o);
+      s = this._resolveWithInternalOpts(t, i);
+    } catch (a) {
+      return Promise.reject(a);
     }
-    const s = e.binding;
-    return (s == null ? void 0 : s.postConstructResult) instanceof Promise ? s.postConstructResult.then(() => i) : Promise.resolve(i);
+    const o = i.binding;
+    return (o == null ? void 0 : o.postConstructResult) instanceof Promise ? o.postConstructResult.then(() => s) : Promise.resolve(s);
+  }
+  // 内部解析入口，接受完整 Options；被 getAsync、toService、_getInjectProperties 等内部路径调用
+  _resolveWithInternalOpts(t, e) {
+    if (this._destroyed)
+      throw new Y(t);
+    return e.skipSelf ? this._resolveSkipSelf(t, e) : e.self ? this._resolveSelf(t, e) : this._resolveDefault(t, e);
   }
   // 处理 skipSelf 选项：跳过当前容器，委托父容器解析
   _resolveSkipSelf(t, e) {
-    return this.parent ? (e.skipSelf = !1, this.parent.get(t, e)) : this._checkBindingNotFoundError(t, e);
+    if (this.parent) {
+      const i = Object.assign({}, e, { skipSelf: !1 });
+      return this.parent._resolveWithInternalOpts(t, i);
+    }
+    return this._checkBindingNotFoundError(t, e);
   }
   // 处理 self 选项：仅在当前容器中查找
   _resolveSelf(t, e) {
@@ -366,7 +413,7 @@ const _ = class _ {
   // 默认解析流程：当前容器 → 父容器 → 抛错
   _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);
+    return i ? (e.token = t, e.binding = i, i.get(e)) : this.parent ? this.parent._resolveWithInternalOpts(t, e) : this._checkBindingNotFoundError(t, e);
   }
   onActivation(t) {
     this._onActivationHandler = t;
@@ -381,14 +428,14 @@ const _ = class _ {
     this._onDeactivationHandler && this._onDeactivationHandler(t.cache, t.token);
   }
   _buildBinding(t) {
-    return new S(t, this);
+    return new A(t, this);
   }
   _getBinding(t) {
     return this._bindings.get(t);
   }
   _checkBindingNotFoundError(t, e) {
     if (!e.optional)
-      throw new x(t);
+      throw new z(t, e);
   }
 };
 // 实例到容器的映射表，用于 @LazyInject 查找实例所属容器
@@ -397,9 +444,9 @@ const _ = class _ {
 // 同一对象可能通过 toConstantValue 被绑定到多个容器，WeakMap 只能保留最后一次映射，
 // 会导致 @LazyInject 从错误的容器解析依赖。
 // 由于 Instance 类型每次都通过 new ClassName() 创建新实例，不存在同一实例被多个容器注册的覆盖风险
-r(_, "_instanceContainerMap", /* @__PURE__ */ new WeakMap());
-let I = _;
-class z extends v {
+r(I, "_instanceContainerMap", /* @__PURE__ */ new WeakMap());
+let v = I;
+class J extends _ {
   constructor(t, e) {
     super(
       `@LazyInject(${t == null ? void 0 : t.name}) in class ${e.name} requires a registered container but none was found. Token: `,
@@ -407,7 +454,7 @@ class z extends v {
     );
   }
 }
-function E(n, t) {
+function O(n, t) {
   return function(e) {
     return function(i, s) {
       const o = s.name, a = s.metadata;
@@ -417,7 +464,7 @@ function E(n, t) {
     };
   };
 }
-function j(n, t) {
+function k(n, t) {
   return (e) => (i, s) => {
     const o = s.name, a = s.metadata;
     if (m(a, n))
@@ -425,32 +472,32 @@ function j(n, t) {
     a[n] = { key: o, value: e };
   };
 }
-const $ = E(l.INJECT), Z = E(l.SELF, !0), q = E(l.SKIP_SELF, !0), W = E(l.OPTIONAL, !0), Q = j(
+const Q = O(l.INJECT), X = O(l.SELF, !0), tt = O(l.SKIP_SELF, !0), et = O(l.OPTIONAL, !0), nt = k(
   l.POST_CONSTRUCT,
-  g.POST_CONSTRUCT
-), X = j(
+  T.POST_CONSTRUCT
+), it = k(
   l.PRE_DESTROY,
-  g.PRE_DESTROY
+  T.PRE_DESTROY
 );
-function tt() {
+function st() {
   return function(n, t) {
     const e = t.metadata;
-    b(n, e);
+    P(n, e);
   };
 }
-function U(n, t, e, i) {
+function G(n, t, e, i) {
   if (e == null)
-    throw new Error(g.LAZY_INJECT_INVALID_TOKEN);
+    throw new Error(T.LAZY_INJECT_INVALID_TOKEN);
   let s, o = !1;
   Object.defineProperty(n, t, {
     configurable: !0,
     enumerable: !0,
     get() {
       if (!o) {
-        const a = i || I.getContainerOf(n), c = n.constructor;
+        const a = i || v.getContainerOf(n), c = n.constructor;
         if (!a)
-          throw new z(D(e), c);
-        s = a.get(D(e), {
+          throw new J(D(e), c);
+        s = a._resolveWithInternalOpts(D(e), {
           parent: { token: c }
         }), o = !0;
       }
@@ -461,30 +508,30 @@ function U(n, t, e, i) {
     }
   });
 }
-function Y(n, t) {
+function K(n, t) {
   return function(e, i) {
     const s = i.name;
     i.addInitializer(function() {
-      U(this, s, n, t);
+      G(this, s, n, t);
     });
   };
 }
-function et(n) {
+function rt(n) {
   return function(t) {
-    return Y(t, n);
+    return K(t, n);
   };
 }
-function nt(n, t) {
+function ot(n, t) {
   const e = t.name;
   t.addInitializer(function() {
     this[e] = n.bind(this);
   });
 }
-const A = /* @__PURE__ */ new WeakMap();
-function it(n, t, e) {
+const b = /* @__PURE__ */ new WeakMap();
+function at(n, t, e) {
   const i = Array.isArray(n) ? n : [n], s = t.prototype, o = typeof s[e] == "function", a = [];
-  A.has(t) || A.set(t, {});
-  const c = A.get(t), u = {
+  b.has(t) || b.set(t, {});
+  const c = b.get(t), u = {
     kind: o ? "method" : "field",
     name: e,
     static: !1,
@@ -496,39 +543,40 @@ function it(n, t, e) {
   };
   let h = o ? s[e] : void 0;
   for (let d = i.length - 1; d >= 0; d--) {
-    const N = i[d](h, u);
-    o && typeof N == "function" && (h = N);
+    const C = i[d](h, u);
+    o && typeof C == "function" && (h = C);
   }
-  if (o && h !== s[e] && (s[e] = h), b(t, c), a.length > 0) {
+  if (o && h !== s[e] && (s[e] = h), P(t, c), a.length > 0) {
     const d = Object.create(s);
-    for (const N of a)
-      N.call(d);
+    for (const C of a)
+      C.call(d);
   }
 }
 export {
-  v as BaseError,
-  S as Binding,
-  x as BindingNotFoundError,
-  H as BindingNotValidError,
-  R as CircularDependencyError,
-  I as Container,
-  z as ContainerNotFoundError,
-  F as DuplicateBindingError,
-  g as ERRORS,
-  $ as Inject,
-  tt as Injectable,
-  Y as LazyInject,
-  B as LazyToken,
-  W as Optional,
-  Q as PostConstruct,
-  M as PostConstructError,
-  X as PreDestroy,
-  Z as Self,
-  q as SkipSelf,
-  G as Token,
-  nt as autobind,
-  et as createLazyInject,
-  it as decorate,
+  _ as BaseError,
+  A as Binding,
+  z as BindingNotFoundError,
+  F as BindingNotValidError,
+  L as CircularDependencyError,
+  v as Container,
+  Y as ContainerDestroyedError,
+  J as ContainerNotFoundError,
+  U as DuplicateBindingError,
+  T as ERRORS,
+  Q as Inject,
+  st as Injectable,
+  K as LazyInject,
+  x as LazyToken,
+  et as Optional,
+  nt as PostConstruct,
+  W as PostConstructError,
+  it as PreDestroy,
+  X as Self,
+  tt as SkipSelf,
+  $ as Token,
+  ot as autobind,
+  rt as createLazyInject,
+  at as decorate,
   m as hasOwn,
-  K as isObject
+  Z as isObject
 };

package/dist/interfaces.d.cts

@@ -12,11 +12,13 @@ export interface Context {
 }
 export type DynamicValue<T> = (ctx: Context) => T;
 export type RecordObject = Record<string, unknown>;
-export interface Options<T = unknown> {
-    inject?: GenericToken<T>;
+export interface GetOptions {
     optional?: boolean;
     self?: boolean;
     skipSelf?: boolean;
+}
+export interface Options<T = unknown> extends GetOptions {
+    inject?: GenericToken<T>;
     token?: CommonToken<T>;
     binding?: Binding<T>;
     parent?: Options<any>;

package/dist/interfaces.d.ts

@@ -12,11 +12,13 @@ export interface Context {
 }
 export type DynamicValue<T> = (ctx: Context) => T;
 export type RecordObject = Record<string, unknown>;
-export interface Options<T = unknown> {
-    inject?: GenericToken<T>;
+export interface GetOptions {
     optional?: boolean;
     self?: boolean;
     skipSelf?: boolean;
+}
+export interface Options<T = unknown> extends GetOptions {
+    inject?: GenericToken<T>;
     token?: CommonToken<T>;
     binding?: Binding<T>;
     parent?: Options<any>;

package/dist/utils.d.cts

@@ -0,0 +1,2 @@
+import { Options } from './interfaces';
+export declare function buildTokenChain(options: Options): string[];

package/dist/utils.d.ts

@@ -0,0 +1,2 @@
+import { Options } from './interfaces';
+export declare function buildTokenChain(options: Options): string[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaokei/di",
-  "version": "5.0.4",
+  "version": "5.0.5",
   "type": "module",
   "description": "Tiny di library depends on typescript decorator.",
   "main": "./dist/index.cjs",