plugin-tls 2.0.1 → 3.0.0

package/dist/plugin-host/PluginHost.d.ts

@@ -1,261 +1,76 @@
 import { PluginManager } from "../plugin-manager/PluginManager";
-import type { IPlugin, PluginCreatedReturnType, PluginUseReturnType, GetNormalizePluginOptions, FormatUsePluginParameters } from "../plugin-manager/PluginManager";
-import type { ReplaceConstructorReturn } from "../extend/mixin";
-import { WebDestroyable } from "@gby/destroyable";
-/**
- * 插件宿主的接口
- *
- * @typeParam HostClassType 插件宿主类的类型
- */
-export interface IPluginHost<HostClassType extends IPluginHostConstructor<any, Plugin>, Plugin extends IPlugin<HostClassType, any> = IPlugin<HostClassType, any>> {
-    /**
-     * PluginHost 的插件管理器
-     */
-    get pluginManager(): HostClassType["pluginManager"];
-    /**
-     * 实例的注册插件的方法
-     * @param plugin
-     * @param options
-     * @returns
-     */
-    use<P extends Plugin>(plugin: P, options: GetNormalizePluginOptions<P>): PluginCreatedReturnType<P> | void;
-}
-/**
- * 插件宿主构造函数的接口
- * @typeParam HostClassType 插件宿主类的类型
- */
-export interface IPluginHostConstructor<HostClassType, Plugin extends IPlugin<HostClassType, any> = IPlugin<HostClassType, any>> {
-    /**
-     * PluginHost 的插件管理器
-     */
-    get pluginManager(): PluginManager<HostClassType, Plugin>;
-    /**
-     * {@inheritDoc PluginManager.use}
-     */
-    use<P extends Plugin>(plugin: P, options: GetNormalizePluginOptions<P>): PluginUseReturnType<P> | void;
-}
+import type { IPlugin, PluginUseArgs, PluginUseReturn } from "../plugin-manager/index";
+import { Destroyable } from "@gby/destroyable";
+import type { IPluginHost } from "./type";
+import type { ClassType } from "type-tls";
 /**
  * 插件的宿主
  *
  * @remarks
- * 插件宿主 就是 拥有插件机制的宿主
  *
  * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
  *
  * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
  * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+ *
+ *
+ * 将泛型设计成 <Host,HostClass = ClassType<Host>> 而不是 <HostClass> 的原因是：
+ * 如果设计为  <HostClass> ，则在子类中需要
+ * ```ts
+ * class SubPluginHost extends PluginHost<typeof SubPluginHost> {}
+ * ```
+ * 而这种写法 ts 会报循环引用自身的错误；
+ * 改成  <Host,HostClass = ClassType<Host>> 后，子类中只需像下面这样写，就不会报错了；
+ * ```ts
+ * class SubPluginHost extends PluginHost<SubPluginHost> {}
+ * ```
+ * 而且这样
+ * 1. 子类可以通过继承来实现自定义的 Host
+ * 2. 子类可以通过继承来实现自定义的 HostClass
  */
-export declare class PluginHost<Plugin extends IPlugin<typeof PluginHost, any> = IPlugin<typeof PluginHost, any>> extends WebDestroyable {
+export declare class PluginHost<Host, HostClass = ClassType<Host>> extends Destroyable implements IPluginHost<Host, HostClass> {
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    static isolatedPluginManager: boolean;
     /**
      * 插件管理器
      */
-    static get pluginManager(): PluginManager<any, IPlugin<any, any>>;
-    protected static _pluginManager: PluginManager<any>;
+    static get pluginManager(): PluginManager<any, any>;
+    static _pluginManager: PluginManager<any, any>;
     /**
      * 插件管理器 {@link PluginHost.pluginManager}
      */
-    get pluginManager(): PluginManager<any, IPlugin<any, any>>;
+    get pluginManager(): PluginManager<Host, HostClass>;
     /**
      * {@inheritDoc PluginManager.use}
      */
-    static use<Plugin extends IPlugin<typeof PluginHost, any>>(plugin: Plugin, ...options: FormatUsePluginParameters<Plugin>): void | ReturnType<Plugin["used"]>;
+    static use<Plugin extends IPlugin<any, any>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
     /**
      * 需要在子类中调用
      *
-     * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
-     * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+     * 之所以没写在该类中的函数中，是因为 `this.pluginManager.onCreate(this,...args)` 通常会在构建函数执行的最后时才调用；
+     * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.onCreate(this,...args)` 不是在最后的执行；
      */
     /**
      * 实例的注册插件的方法
      * @param plugin
-     * @param options
+     * @param args
      * @returns
      */
-    use<P extends Plugin>(plugin: P, ...options: FormatUsePluginParameters<P>): PluginCreatedReturnType<P> | void;
+    use<P extends IPlugin<Host, HostClass>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * 初始化实例
+     * @remarks
+     * 会调用 {@link PluginManager.onInit}
+     * @param args
+     */
+    init(...args: any): Promise<void>;
     /**
      * 销毁实例
      * @returns
      */
-    destroyThis(): void;
+    destroyThis(): Promise<void>;
 }
-/**
- * 创建插件的缩主类
- *
- * @remarks
- * 比 直接使用 PluginHost 提供了完善的类型推导
- *
- * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
- *
- * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
- * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
- * @returns
- */
-export declare function createPluginHost<HOST, P extends new (...args: any) => Object, Plugin extends IPlugin<HOST, any> = IPlugin<HOST, any>>(ParentClass: P): {
-    new (...args: any): {
-        /**
-         *  插件管理器 {@link CEarth.pluginManager}
-         */
-        get pluginManager(): PluginManager<any, IPlugin<any, any>>;
-        /**
-        /**
-         * 实例的注册插件的方法
-         * @param plugin
-         * @param options
-         * @returns
-         */
-        use<P_1 extends Plugin>(plugin: P_1, ...options: FormatUsePluginParameters<P_1>): PluginCreatedReturnType<P_1> | void;
-        /**
-         * 销毁实例
-         * @returns
-         */
-        destroyThis(): void;
-        readonly isDestroyed: boolean;
-        _isDestroyed: boolean;
-        _destroyers: import("@gby/destroyable").FunDestroyer[];
-        disposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDisposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        disposeObj<T extends unknown>(obj: T, sync?: boolean): T;
-        cancelDisposeObj<T extends unknown>(obj: T): T;
-        dispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        dispose<T extends unknown>(obj: T, asyncDestroy?: boolean): T;
-        dispose<T extends unknown>(objOrFun: T, asyncDestroy?: boolean): T;
-        cancelDispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDispose<T extends unknown>(obj: T): T;
-        cancelDispose<T extends unknown>(objOrFun: T): T;
-        destroy(): true | undefined;
-        destroyAsync(): Promise<true | undefined>;
-        constructor: Function;
-        toString: (() => string) & (() => string);
-        toLocaleString: (() => string) & (() => string);
-        valueOf: (() => Object) & (() => Object);
-        hasOwnProperty: ((v: PropertyKey) => boolean) & ((v: PropertyKey) => boolean);
-        isPrototypeOf: ((v: Object) => boolean) & ((v: Object) => boolean);
-        propertyIsEnumerable: ((v: PropertyKey) => boolean) & ((v: PropertyKey) => boolean);
-    };
-    /**
-     * PluginHost 的插件管理器
-     */
-    get pluginManager(): PluginManager<typeof PluginHost & HOST & (new (...args: any) => {
-        readonly isDestroyed: boolean;
-        _isDestroyed: boolean;
-        _destroyers: import("@gby/destroyable").FunDestroyer[];
-        disposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDisposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        disposeObj<T extends any>(obj: T, sync?: boolean): T;
-        cancelDisposeObj<T extends any>(obj: T): T;
-        dispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        dispose<T extends any>(obj: T, asyncDestroy?: boolean): T;
-        dispose<T extends any | import("@gby/destroyable").FunDestroyer>(objOrFun: T, asyncDestroy?: boolean): T;
-        cancelDispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDispose<T extends any>(obj: T): T;
-        cancelDispose<T extends any | import("@gby/destroyable").FunDestroyer>(objOrFun: T): T;
-        destroyThis(): void;
-        destroy(): true | undefined;
-        destroyAsync(): Promise<true | undefined>;
-        constructor: Function;
-        toString(): string;
-        toLocaleString(): string;
-        valueOf(): Object;
-        hasOwnProperty(v: PropertyKey): boolean;
-        isPrototypeOf(v: Object): boolean;
-        propertyIsEnumerable(v: PropertyKey): boolean;
-    }) & P, Plugin>;
-    _pluginManager: PluginManager<typeof PluginHost & HOST & (new (...args: any) => {
-        readonly isDestroyed: boolean;
-        _isDestroyed: boolean;
-        _destroyers: import("@gby/destroyable").FunDestroyer[];
-        disposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDisposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        disposeObj<T extends any>(obj: T, sync?: boolean): T;
-        cancelDisposeObj<T extends any>(obj: T): T;
-        dispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        dispose<T extends any>(obj: T, asyncDestroy?: boolean): T;
-        dispose<T extends any | import("@gby/destroyable").FunDestroyer>(objOrFun: T, asyncDestroy?: boolean): T;
-        cancelDispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
-        cancelDispose<T extends any>(obj: T): T;
-        cancelDispose<T extends any | import("@gby/destroyable").FunDestroyer>(objOrFun: T): T;
-        destroyThis(): void;
-        destroy(): true | undefined;
-        destroyAsync(): Promise<true | undefined>;
-        constructor: Function;
-        toString(): string;
-        toLocaleString(): string;
-        valueOf(): Object;
-        hasOwnProperty(v: PropertyKey): boolean;
-        isPrototypeOf(v: Object): boolean;
-        propertyIsEnumerable(v: PropertyKey): boolean;
-    }) & P, Plugin>;
-    /**
-     * {@inheritDoc PluginManager.use}
-     */
-    use<P_1 extends Plugin>(plugin: P_1, ...options: FormatUsePluginParameters<P_1>): void | ReturnType<P_1["used"]>;
-} & P;
-/**
- * 将 HOST 变成插件宿主类型
- */
-export type BecomePluginHost<HOST extends new (...args: any) => Object, Plugin extends IPlugin<HOST, any> = IPlugin<HOST, any>> = HOST & IPluginHostConstructor<HOST & IPluginHostConstructor<HOST, Plugin>, Plugin> & ReplaceConstructorReturn<HOST, InstanceType<HOST> & IPluginHost<HOST & IPluginHostConstructor<HOST & IPluginHostConstructor<HOST, Plugin>, Plugin>>>;
-/**
- * 变成插件宿主
- * @remarks
- * 也可作为装饰器
- *
- * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
- *
- * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
- * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
- * @param target
- * @param context
- * @returns
- */
-export declare function becomePluginHost<HOST extends new (...args: any) => Object, Plugin extends IPlugin<HOST, any> = IPlugin<HOST, any>>(target: HOST): BecomePluginHost<HOST, Plugin>;
-/**
- * 变成插件宿主
- * @remarks
- * 也可作为装饰器
- * @param target
- * @param context
- * @returns
- */
-export declare function becomePluginHost_Proxy<HOST extends new (...args: any) => Object, Plugin extends IPlugin<HOST, any> = IPlugin<HOST, any>>(target: HOST): HOST;
-/**
- * 插件缩主类的装饰器（继承版）
- * @remarks
- * 通过继承实现
- */
-export declare function becomePluginHost_Extends<HOST extends new (...args: any) => Object>(target: HOST): {
-    new (...args: any): {
-        /**
-         * 插件管理器 {@link PluginHost.pluginManager}
-         */
-        get pluginManager(): PluginManager</*elided*/ any & HOST, IPlugin</*elided*/ any & HOST, any>>;
-        /**
-         * 实例的注册插件的方法
-         * @param plugin
-         * @param options
-         * @returns
-         */
-        use<Plugin extends IPlugin</*elided*/ any & HOST, any>>(plugin: Plugin, ...options: FormatUsePluginParameters<Plugin>): void | PluginCreatedReturnType<Plugin>;
-        /**
-         * 销毁实例
-         * @returns
-         */
-        destroy(): void;
-        constructor: Function;
-        toString(): string;
-        toLocaleString(): string;
-        valueOf(): Object;
-        hasOwnProperty(v: PropertyKey): boolean;
-        isPrototypeOf(v: Object): boolean;
-        propertyIsEnumerable(v: PropertyKey): boolean;
-    };
-    /**
-     * 插件管理器
-     */
-    get pluginManager(): PluginManager</*elided*/ any & HOST, IPlugin</*elided*/ any & HOST, any>>;
-    _pluginManager: PluginManager</*elided*/ any & HOST>;
-    /**
-     * {@inheritDoc PluginManager.use}
-     */
-    use<Plugin extends IPlugin</*elided*/ any & HOST, any>>(plugin: Plugin, ...options: FormatUsePluginParameters<Plugin>): void | ReturnType<Plugin["used"]>;
-} & HOST;
 //# sourceMappingURL=PluginHost.d.ts.map

package/dist/plugin-host/PluginHost.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginHost.d.ts","sourceRoot":"","sources":["../../src/plugin-host/PluginHost.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"PluginHost.d.ts","sourceRoot":"","sources":["../../src/plugin-host/PluginHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,UAAU,CAAC,IAAI,EAAC,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAE,SAAQ,WAAY,YAAW,WAAW,CAAC,IAAI,EAAC,SAAS,CAAC;IAClH;;;OAGG;IACH,MAAM,CAAC,qBAAqB,UAAS;IAErC;;OAEG;IACH,MAAM,KAAK,aAAa,4BAKvB;IACD,MAAM,CAAC,cAAc,0BAAoC;IAEzD;;OAEG;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,IAAI,EAAC,SAAS,CAAC,CAEjD;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,SAAS,OAAO,CAAC,GAAG,EAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;IAI1F;;;;;OAKG;IAOH;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,EAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAKhG;;;;;OAKG;IACH,IAAI,CAAC,GAAG,IAAI,EAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACY,WAAW;CAK3B"}

package/dist/plugin-host/PluginHostEventEmitter.d.ts

@@ -0,0 +1,64 @@
+import { PluginManager } from "../plugin-manager/PluginManager";
+import type { IPlugin, PluginUseArgs, PluginUseReturn } from "../plugin-manager/index";
+import { DestroyableEventEmitter } from "@gby/destroyable";
+import type { DefaultEventMap, EventMap } from "@gby/destroyable";
+import type { IPluginHost } from "./type";
+import type { ClassType } from "type-tls";
+export type { DefaultEventMap, EventMap };
+/**
+ * 插件的宿主
+ *
+ * @remarks
+ * 插件宿主 就是 拥有插件机制的宿主
+ *
+ * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
+ *
+ * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
+ * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+ */
+export declare class PluginHostEventEmitter<Host, HostClass = ClassType<Host>, EM extends EventMap<EM> = DefaultEventMap> extends DestroyableEventEmitter<EM> implements IPluginHost<Host, HostClass> {
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    static isolatedPluginManager: boolean;
+    /**
+     * 插件管理器
+     */
+    static get pluginManager(): PluginManager<any, any>;
+    static _pluginManager: PluginManager<any, any>;
+    /**
+     * 插件管理器 {@link PluginHost.pluginManager}
+     */
+    get pluginManager(): PluginManager<Host, HostClass>;
+    /**
+     * {@inheritDoc PluginManager.use}
+     */
+    static use<Plugin extends IPlugin<any, any>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
+    /**
+     * 需要在子类中调用
+     *
+     * 之所以没写在该类中的函数中，是因为 `this.pluginManager.onCreate(this,...args)` 通常会在构建函数执行的最后时才调用；
+     * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.onCreate(this,...args)` 不是在最后的执行；
+     */
+    /**
+     * 实例的注册插件的方法
+     * @param plugin
+     * @param args
+     * @returns
+     */
+    use<P extends IPlugin<Host, HostClass>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * 初始化实例
+     * @remarks
+     * 会调用 {@link PluginManager.onInit}
+     * @param args
+     */
+    init(...args: any): Promise<void>;
+    /**
+     * 销毁实例
+     * @returns
+     */
+    destroyThis(): Promise<void>;
+}
+//# sourceMappingURL=PluginHostEventEmitter.d.ts.map

package/dist/plugin-host/PluginHostEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHostEventEmitter.d.ts","sourceRoot":"","sources":["../../src/plugin-host/PluginHostEventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAE1C,YAAY,EAAE,eAAe,EAAC,QAAQ,EAAC,CAAA;AAGvC;;;;;;;;;;GAUG;AACH,qBAAa,sBAAsB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,QAAQ,CAAC,EAAE,CAAC,GAAG,eAAe,CAAE,SAAQ,uBAAuB,CAAC,EAAE,CAAE,YAAW,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;IAC3L;;;OAGG;IACH,MAAM,CAAC,qBAAqB,UAAS;IAErC;;OAEG;IACH,MAAM,KAAK,aAAa,4BAKvB;IACD,MAAM,CAAC,cAAc,0BAAoC;IAEzD;;OAEG;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAElD;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;IAI3F;;;;;OAKG;IAOH;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAKjG;;;;;OAKG;IACH,IAAI,CAAC,GAAG,IAAI,EAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACY,WAAW;CAK3B"}

package/dist/plugin-host/PluginHostEventTarget.d.ts

@@ -0,0 +1,62 @@
+import { PluginManager } from "../plugin-manager/PluginManager";
+import type { IPlugin, PluginUseArgs, PluginUseReturn } from "../plugin-manager/index";
+import { DestroyableEventTarget } from "@gby/destroyable";
+import type { IPluginHost } from "./type";
+import type { ClassType } from "type-tls";
+/**
+ * 插件的宿主
+ *
+ * @remarks
+ * 插件宿主 就是 拥有插件机制的宿主
+ *
+ * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
+ *
+ * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
+ * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+ */
+export declare class PluginHostEventTarget<Host, HostClass = ClassType<Host>, EM extends Record<string, any> = Record<string, any>> extends DestroyableEventTarget<EM> implements IPluginHost<Host, HostClass> {
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    static isolatedPluginManager: boolean;
+    /**
+     * 插件管理器
+     */
+    static get pluginManager(): PluginManager<any, any>;
+    static _pluginManager: PluginManager<any, any>;
+    /**
+     * 插件管理器 {@link PluginHost.pluginManager}
+     */
+    get pluginManager(): PluginManager<Host, HostClass>;
+    /**
+     * {@inheritDoc PluginManager.use}
+     */
+    static use<Plugin extends IPlugin<any, any>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
+    /**
+     * 需要在子类中调用
+     *
+     * 之所以没写在该类中的函数中，是因为 `this.pluginManager.onCreate(this,...args)` 通常会在构建函数执行的最后时才调用；
+     * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.onCreate(this,...args)` 不是在最后的执行；
+     */
+    /**
+     * 实例的注册插件的方法
+     * @param plugin
+     * @param args
+     * @returns
+     */
+    use<P extends IPlugin<Host, HostClass>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * 初始化实例
+     * @remarks
+     * 会调用 {@link PluginManager.onInit}
+     * @param args
+     */
+    init(...args: any): Promise<void>;
+    /**
+     * 销毁实例
+     * @returns
+     */
+    destroyThis(): Promise<void>;
+}
+//# sourceMappingURL=PluginHostEventTarget.d.ts.map

package/dist/plugin-host/PluginHostEventTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginHostEventTarget.d.ts","sourceRoot":"","sources":["../../src/plugin-host/PluginHostEventTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAEvF,OAAO,EAAE,sBAAsB,EAAC,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAK1C;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAE,SAAQ,sBAAsB,CAAC,EAAE,CAAE,YAAW,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC;IACpM;;;OAGG;IACH,MAAM,CAAC,qBAAqB,UAAS;IAErC;;OAEG;IACH,MAAM,KAAK,aAAa,4BAKvB;IACD,MAAM,CAAC,cAAc,0BAAoC;IAEzD;;OAEG;IACH,IAAI,aAAa,IAAI,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,CAElD;IAED;;OAEG;IACH,MAAM,CAAC,GAAG,CAAC,MAAM,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;IAI3F;;;;;OAKG;IAOH;;;;;OAKG;IACH,GAAG,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAKjG;;;;;OAKG;IACH,IAAI,CAAC,GAAG,IAAI,EAAC,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhC;;;OAGG;IACY,WAAW;CAK3B"}

package/dist/plugin-host/createPluginHost.d.ts

@@ -0,0 +1,87 @@
+import { PluginManager } from "../plugin-manager/PluginManager";
+import type { IPlugin, PluginUseArgs, PluginUseReturn } from "../plugin-manager/index";
+import type { ClassType } from "type-tls";
+/**
+ * 创建插件的缩主类
+ *
+ * @remarks
+ * 比 直接使用 PluginHost 提供了完善的类型推导
+ *
+ * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
+ *
+ * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
+ * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+ * @returns
+ */
+export declare function createPluginHost<P extends new (...args: any) => Object>(ParentClass: P): {
+    new <Host, HostClass = ClassType<Host, any>>(...args: any): {
+        /**
+         * 插件管理器 {@link PluginHostSub.pluginManager}
+         */
+        get pluginManager(): PluginManager<Host, HostClass>;
+        /**
+         * 需要在子类中调用
+         *
+         * 之所以没写在该类中的函数中，是因为 `this.pluginManager.onCreate(this)` 通常会在构建函数执行的最后时才调用；
+         * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.onCreate(this)` 不是在最后的执行；
+         */
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        use<P_1 extends IPlugin<Host, HostClass>>(plugin: P_1, ...args: PluginUseArgs<P_1>): PluginUseReturn<P_1>;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginManager.onInit}
+         * @param args
+         */
+        init(...args: any): Promise<void>;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroyThis(): Promise<void>;
+        refCount: number;
+        readonly isDestroyed: boolean;
+        _isDestroyed: boolean;
+        readonly canDestroy: boolean;
+        _destroyers: import("@gby/destroyable").FunDestroyer[];
+        disposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
+        cancelDisposeFun<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
+        disposeObj<T extends import("@gby/destroyable").IDestroyable>(obj: T, sync?: boolean): T;
+        cancelDisposeObj<T extends import("@gby/destroyable").IDestroyable>(obj: T): T;
+        dispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
+        dispose<T extends import("@gby/destroyable").IDestroyable>(obj: T, asyncDestroy?: boolean): T;
+        dispose<T extends import("@gby/destroyable").IDestroyable | import("@gby/destroyable").FunDestroyer>(objOrFun: T, asyncDestroy?: boolean): T;
+        cancelDispose<T extends import("@gby/destroyable").FunDestroyer>(fun: T): T;
+        cancelDispose<T extends import("@gby/destroyable").IDestroyable>(obj: T): T;
+        cancelDispose<T extends import("@gby/destroyable").IDestroyable | import("@gby/destroyable").FunDestroyer>(objOrFun: T): T;
+        destroy(): Promise<boolean>;
+        destroySync(): boolean;
+        constructor: Function;
+        toString: (() => string) & (() => string);
+        toLocaleString: (() => string) & (() => string);
+        valueOf: (() => Object) & (() => Object);
+        hasOwnProperty: ((v: PropertyKey) => boolean) & ((v: PropertyKey) => boolean);
+        isPrototypeOf: ((v: Object) => boolean) & ((v: Object) => boolean);
+        propertyIsEnumerable: ((v: PropertyKey) => boolean) & ((v: PropertyKey) => boolean);
+    };
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    isolatedPluginManager: boolean;
+    /**
+     * 插件管理器
+     */
+    get pluginManager(): PluginManager<any, any>;
+    _pluginManager: PluginManager<any, any>;
+    /**
+     * {@inheritDoc PluginManager.use}
+     */
+    use<Plugin extends IPlugin<any, any>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
+} & P;
+//# sourceMappingURL=createPluginHost.d.ts.map

package/dist/plugin-host/createPluginHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createPluginHost.d.ts","sourceRoot":"","sources":["../../src/plugin-host/createPluginHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,EAAE,WAAW,EAAE,CAAC;SAS1D,IAAI,EAAE,SAAS;QAkBxC;;WAEG;6BACkB,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC;QAWnD;;;;;WAKG;QAMH;;;;;WAKG;wBACW,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,UAAU,GAAC,WAAW,aAAa,CAAC,GAAC,CAAC,GAAG,eAAe,CAAC,GAAC,CAAC;QAMjG;;;;;WAKG;sBACW,GAAG;QAIjB;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;IAnEH;;;OAGG;;IAGH;;OAEG;;;IAgBH;;OAEG;QACQ,MAAM,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,MAAM,WAAW,aAAa,CAAC,MAAM,CAAC;MA+C9F"}