plugin-tls 2.0.1 → 3.1.0

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

@@ -0,0 +1,95 @@
+import { PluginExtendManager } from "../plugin-manager";
+import type { ExtendOptions, IPlugin, PluginUseArgs, PluginUseReturn } from "../plugin-manager/index";
+import type { AbstractConstructor, 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 extends AbstractConstructor<Host> = ClassType<Host, any>>(...args: any): {
+        /**
+         * 插件管理器 {@link PluginHostSub.pluginManager}
+         */
+        get pluginManager(): PluginExtendManager<Host, HostClass>;
+        /**
+         * 需要在子类中调用
+         *
+         * 之所以没写在该类中的函数中，是因为 `this.pluginManager.onCreate(this)` 通常会在构建函数执行的最后时才调用；
+         * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.onCreate(this)` 不是在最后的执行；
+         */
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        usePlugin<P_1 extends IPlugin<Host, HostClass>>(plugin: P_1, ...args: PluginUseArgs<P_1>): PluginUseReturn<P_1>;
+        /**
+         * {@inheritDoc PluginExtendManager.useExtend}
+         */
+        useExtend<E>(ext: ExtendOptions<HostClass, E>, ...args: ConstructorParameters<HostClass>): boolean;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginExtendManager.onInit}
+         * @param args
+         */
+        init(...args: any): any;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroyThis(): any;
+        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;
+        destroySync(): boolean;
+        destroy(): boolean | Promise<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(): PluginExtendManager<any, any>;
+    _pluginManager: PluginExtendManager<any, any>;
+    /**
+     * {@inheritDoc PluginExtendManager.usePlugin}
+     */
+    usePlugin<Plugin extends IPlugin<any, any>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
+    /**
+     * {@inheritDoc PluginExtendManager.useExtend}
+     */
+    useExtend<HostClass extends AbstractConstructor, E>(ext: ExtendOptions<HostClass, E>): boolean;
+} & 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,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGtG,OAAO,KAAK,EAAE,mBAAmB,EAAG,SAAS,EAAC,MAAM,UAAU,CAAC;AAG/D;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,EAAE,WAAW,EAAE,CAAC;SAS1D,IAAI,EAAE,SAAS,SAAS,mBAAmB,CAAC,IAAI,CAAC;QAkB1E;;WAEG;6BACkB,mBAAmB,CAAC,IAAI,EAAE,SAAS,CAAC;QAkBzD;;;;;WAKG;QAMH;;;;;WAKG;8BACiB,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,UAAU,GAAC,WAAW,aAAa,CAAC,GAAC,CAAC,GAAG,eAAe,CAAC,GAAC,CAAC;QAKvG;;WAEG;kBACO,CAAC,6CAA2C,qBAAqB,CAAC,SAAS,CAAC;QAKtF;;;;;WAKG;sBACW,GAAG,GAAE,GAAG;QAItB;;;WAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;IAjFH;;;OAGG;;IAGH;;OAEG;;;IAgBH;;OAEG;cACc,MAAM,SAAS,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,MAAM,WAAW,aAAa,CAAC,MAAM,CAAC;IAIjG;;OAEG;cACc,SAAS,SAAS,mBAAmB,EAAC,CAAC,OAAO,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC;MAyD7F"}

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

@@ -0,0 +1,174 @@
+import { PluginExtendManager } from "../plugin-manager";
+import type { ExtendOptions, IPlugin, PluginUseArgs } from "../plugin-manager/index";
+import type { IPluginHost, IPluginHostClass } from "./type";
+import type { AbstractConstructor, Constructor } from "type-tls";
+/**
+ * 将 HOST 变成插件宿主类型
+ */
+export type BecomePluginHost<HostClass extends AbstractConstructor<any>> = HostClass & IPluginHostClass<InstanceType<HostClass> & IPluginHost<InstanceType<HostClass>, HostClass>>;
+/**
+ * 变成插件宿主
+ * @remarks
+ * 也可作为装饰器
+ *
+ * 子类需要在构建函数中调用 `this.pluginManager.created(this);`
+ *
+ * 之所以没写在该类中的函数中，是因为 `this.pluginManager.created(this)` 通常会在构建函数执行的最后时才调用；
+ * 如果像下面写在该类的构建函数中，然后子类通过 `super()` 来调用，这样就会导致 `this.pluginManager.created(this)` 不是在最后的执行；
+ * @param target
+ * @param context
+ * @returns
+ */
+export declare function becomePluginHost<HostClass extends AbstractConstructor>(target: HostClass): BecomePluginHost<HostClass>;
+/**
+ * 变成插件宿主，通过代理实现
+ * @remarks
+ * 也可作为装饰器
+ * @param target
+ * @param context
+ * @returns
+ */
+export declare function becomePluginHost_Proxy<HOST extends Constructor<any>>(target: HOST): BecomePluginHost<HOST>;
+/**
+ * 插件缩主类的装饰器（继承版）
+ * @remarks
+ * 通过继承实现
+ */
+export declare function becomePluginHost_Extends<HostClass extends Constructor>(target: HostClass): {
+    new (...args: any): {
+        [x: string]: any;
+        /**
+         * 插件管理器 {@link PluginHostExtends.pluginManager}
+         */
+        get pluginManager(): PluginExtendManager</*elided*/ any, /*elided*/ any & HostClass>;
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        usePlugin<P extends IPlugin</*elided*/ any, /*elided*/ any & HostClass>>(plugin: P, ...args: PluginUseArgs<P>): ReturnType<P["onUse"]>;
+        /**
+         * {@inheritDoc PluginExtendManager.useExtend}
+         */
+        useExtend<E>(ext: ExtendOptions</*elided*/ any & HostClass, E>, ...args: ConstructorParameters</*elided*/ any & HostClass>): boolean;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginExtendManager.onInit}
+         * @param args
+         */
+        init(...args: any): any;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroy(): any;
+    };
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    isolatedPluginManager: boolean;
+    /**
+     * 插件管理器
+     */
+    get pluginManager(): PluginExtendManager<{
+        [x: string]: any;
+        /**
+         * 插件管理器 {@link PluginHostExtends.pluginManager}
+         */
+        get pluginManager(): PluginExtendManager</*elided*/ any, /*elided*/ any & HostClass>;
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        usePlugin<P extends IPlugin</*elided*/ any, /*elided*/ any & HostClass>>(plugin: P, ...args: PluginUseArgs<P>): ReturnType<P["onUse"]>;
+        /**
+         * {@inheritDoc PluginExtendManager.useExtend}
+         */
+        useExtend<E>(ext: ExtendOptions</*elided*/ any & HostClass, E>, ...args: ConstructorParameters</*elided*/ any & HostClass>): boolean;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginExtendManager.onInit}
+         * @param args
+         */
+        init(...args: any): any;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroy(): any;
+    }, /*elided*/ any & HostClass>;
+    _pluginManager: PluginExtendManager<{
+        [x: string]: any;
+        /**
+         * 插件管理器 {@link PluginHostExtends.pluginManager}
+         */
+        get pluginManager(): PluginExtendManager</*elided*/ any, /*elided*/ any & HostClass>;
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        usePlugin<P extends IPlugin</*elided*/ any, /*elided*/ any & HostClass>>(plugin: P, ...args: PluginUseArgs<P>): ReturnType<P["onUse"]>;
+        /**
+         * {@inheritDoc PluginExtendManager.useExtend}
+         */
+        useExtend<E>(ext: ExtendOptions</*elided*/ any & HostClass, E>, ...args: ConstructorParameters</*elided*/ any & HostClass>): boolean;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginExtendManager.onInit}
+         * @param args
+         */
+        init(...args: any): any;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroy(): any;
+    }, /*elided*/ any & HostClass>;
+    /**
+     * {@inheritDoc PluginExtendManager.usePlugin}
+     */
+    usePlugin<Plugin extends IPlugin<{
+        [x: string]: any;
+        /**
+         * 插件管理器 {@link PluginHostExtends.pluginManager}
+         */
+        get pluginManager(): PluginExtendManager</*elided*/ any, /*elided*/ any & HostClass>;
+        /**
+         * 实例的注册插件的方法
+         * @param plugin
+         * @param args
+         * @returns
+         */
+        usePlugin<P extends IPlugin</*elided*/ any, /*elided*/ any & HostClass>>(plugin: P, ...args: PluginUseArgs<P>): ReturnType<P["onUse"]>;
+        /**
+         * {@inheritDoc PluginExtendManager.useExtend}
+         */
+        useExtend<E>(ext: ExtendOptions</*elided*/ any & HostClass, E>, ...args: ConstructorParameters</*elided*/ any & HostClass>): boolean;
+        /**
+         * 初始化实例
+         * @remarks
+         * 会调用 {@link PluginExtendManager.onInit}
+         * @param args
+         */
+        init(...args: any): any;
+        /**
+         * 销毁实例
+         * @returns
+         */
+        destroy(): any;
+    }, /*elided*/ any & HostClass>>(plugin: Plugin, ...args: PluginUseArgs<Plugin>): ReturnType<Plugin["onUse"]>;
+    /**
+     * {@inheritDoc PluginExtendManager.useExtend}
+     */
+    useExtend<E>(ext: ExtendOptions</*elided*/ any & HostClass, E>): boolean;
+} & HostClass;
+//# sourceMappingURL=decorator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorator.d.ts","sourceRoot":"","sources":["../../src/plugin-host/decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,aAAa,EAAmB,MAAM,yBAAyB,CAAC;AAEtG,OAAO,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,QAAQ,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAC,MAAM,UAAU,CAAC;AAEhE;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,SAAS,SAAS,mBAAmB,CAAC,GAAG,CAAC,IAAI,SAAS,GAAG,gBAAgB,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,WAAW,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAAC,CAAC;AAGnL;;;;;;;;;;;;GAYG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,SAAS,mBAAmB,EAAE,MAAM,EAAE,SAAS,GA+EtE,gBAAgB,CAAC,SAAS,CAAC,CAC7C;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,SAAS,WAAW,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,IAAI,0BASjF;AAGD;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,SAAS,WAAW,EAAE,MAAM,EAAE,SAAS;kBAyChE,GAAG;;QArBxB;;WAEG;6BACkB,mBAAmB,4CAA6C;QAuBrF;;;;;WAKG;kBACO,CAAC,SAAS,OAAO,4CAA6C;QAIxE;;WAEG;kBACO,CAAC,8DAA0D,qBAAqB,4BAA0B;QAKpH;;;;;WAKG;sBACW,GAAG,GAAE,GAAG;QAYtB;;;WAGG;;;IAlFH;;;OAGG;;IAGH;;OAEG;;;QASH;;WAEG;6BACkB,mBAAmB,4CAA6C;QAuBrF;;;;;WAKG;kBACO,CAAC,SAAS,OAAO,4CAA6C;QAIxE;;WAEG;kBACO,CAAC,8DAA0D,qBAAqB,4BAA0B;QAKpH;;;;;WAKG;sBACW,GAAG,GAAE,GAAG;QAYtB;;;WAGG;;;;;QAjEH;;WAEG;6BACkB,mBAAmB,4CAA6C;QAuBrF;;;;;WAKG;kBACO,CAAC,SAAS,OAAO,4CAA6C;QAIxE;;WAEG;kBACO,CAAC,8DAA0D,qBAAqB,4BAA0B;QAKpH;;;;;WAKG;sBACW,GAAG,GAAE,GAAG;QAYtB;;;WAGG;;;IA1DH;;OAEG;cACc,MAAM,SAAS,OAAO;;QAVvC;;WAEG;6BACkB,mBAAmB,4CAA6C;QAuBrF;;;;;WAKG;kBACO,CAAC,SAAS,OAAO,4CAA6C;QAIxE;;WAEG;kBACO,CAAC,8DAA0D,qBAAqB,4BAA0B;QAKpH;;;;;WAKG;sBACW,GAAG,GAAE,GAAG;QAYtB;;;WAGG;;kCAvDiF,UAAU,MAAM,WAAW,aAAa,CAAC,MAAM,CAAC;IAIpI;;OAEG;cACc,CAAC,OAAO,aAAa,6BAA2B,CAAC,CAAC,GAAE,OAAO;cAiE/E"}

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

@@ -0,0 +1,7 @@
+export * from "./type";
+export * from "./PluginHost";
+export * from "./PluginHostEventEmitter";
+export * from "./PluginHostEventTarget";
+export * from "./createPluginHost";
+export * from "./decorator";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin-host/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC"}

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

@@ -0,0 +1,65 @@
+import type { AbstractConstructor, ClassType } from "type-tls";
+import type { ExtendOptions, PluginExtendManager } from "../plugin-manager/index";
+import type { IPlugin, PluginUseReturn, PluginUseArgs } from "../plugin-manager/index";
+/**
+ * 插件宿主构造函数的接口
+ * @typeParam HostClassType 插件宿主类的类型
+ */
+export interface IPluginHostClass<HostInst> {
+    /**
+     * 构建函数
+     */
+    new (...args: any): HostInst;
+    /**
+     * 插件宿主类的原型
+     */
+    prototype: HostInst;
+    /**
+     * PluginHost 的插件管理器
+     */
+    get pluginManager(): PluginExtendManager<HostInst, this>;
+    /**
+     * 是否使用独立的插件管理器
+     * @defaultValue false
+     */
+    readonly isolatedPluginManager?: boolean;
+    /**
+     * {@inheritDoc PluginExtendManager.usePlugin}
+     */
+    usePlugin<P extends IPlugin<HostInst, this>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * {@inheritDoc PluginExtendManager.useExtend}
+     */
+    useExtend<HostClass extends AbstractConstructor, E>(ext: ExtendOptions<HostClass, E>): boolean;
+}
+/**
+ * 插件宿主的实例类型
+ */
+export interface IPluginHost<Host, HostClass extends AbstractConstructor<Host> = ClassType<Host>> {
+    /**
+     * 插件管理器
+     */
+    readonly pluginManager: PluginExtendManager<Host, HostClass>;
+    /**
+     * 实例的注册插件的方法
+     * @param plugin
+     * @param args
+     * @returns
+     */
+    usePlugin<P extends IPlugin<Host, HostClass>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * {@inheritDoc PluginExtendManager.useExtend}
+     */
+    useExtend<E>(ext: ExtendOptions<HostClass, E>, ...args: ConstructorParameters<HostClass>): boolean;
+    /**
+     * 初始化实例
+     * @param args
+     */
+    init(...args: any): any;
+    /**
+     * 销毁实例
+     * @returns
+     */
+    destroy(): any;
+}
+//# sourceMappingURL=type.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"type.d.ts","sourceRoot":"","sources":["../../src/plugin-host/type.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAC,SAAS,EAAE,MAAM,UAAU,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAGvF;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,QAAQ;IAExC;;OAEG;IACH,KAAK,GAAG,IAAI,EAAE,GAAG,GAAG,QAAQ,CAAC;IAC7B;;OAEG;IACH,SAAS,EAAE,QAAQ,CAAC;IAEpB;;OAEG;IACH,IAAI,aAAa,IAAI,mBAAmB,CAAC,QAAQ,EAAC,IAAI,CAAC,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAEzC;;OAEG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,CAAC,QAAQ,EAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;IAEtG;;OAEG;IACH,SAAS,CAAC,SAAS,SAAS,mBAAmB,EAAC,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC;CAC/F;AAID;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,IAAI,EAAC,SAAS,SAAS,mBAAmB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC;IAC7F;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,mBAAmB,CAAC,IAAI,EAAC,SAAS,CAAC,CAAC;IAC5D;;;;;OAKG;IACH,SAAS,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,CAAC;IAEvG;;OAEG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,EAAC,GAAG,IAAI,EAAC,qBAAqB,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;IAEjG;;;OAGG;IACH,IAAI,CAAC,GAAG,IAAI,EAAC,GAAG,GAAE,GAAG,CAAC;IAEtB;;;OAGG;IACH,OAAO,IAAG,GAAG,CAAC;CACf"}

package/dist/plugin-manager/ExtendManager.d.ts

@@ -0,0 +1,66 @@
+import type { AnyFunction, AbstractConstructor } from "type-tls";
+import { Destroyable } from "@gby/destroyable";
+import { type ExtendOptions, type IExtend } from "./IExtend";
+/**
+ * 插件管理者
+ *
+ * @remarks
+ * 负责管理插件的注册、应用 等
+ *
+ */
+export declare class ExtendManager<HostClass extends AbstractConstructor> extends Destroyable {
+    /**
+     * 插件的宿主
+     */
+    host: HostClass;
+    /**
+     * 所有注册的插件
+     */
+    readonly plugins: Set<IExtend<HostClass>>;
+    /**
+     * @param host - 插件的宿主
+     */
+    constructor(host?: HostClass);
+    destroyThis(): any;
+    /**
+     * 使用插件、注册插件
+     * @param plugin - 插件
+     * @param args - 传递给插件的选项
+     */
+    use<E>(plugin: ExtendOptions<HostClass, E>): boolean;
+    /**
+     * 插件宿主实例的注册插件的方法
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IExtend.use } 方法
+     * @param hostInst - 插件宿主的新实例
+     */
+    instUse<E>(hostInst: InstanceType<HostClass>, plugin: ExtendOptions<HostClass, E>, ...args: ConstructorParameters<HostClass>): boolean;
+    /**
+     * 插件宿主创建实例时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IExtend.onCreate} 方法
+     * 如果插件的 created 方法返回 Promise，则会等待 Promise  resolve
+     * @param hostInst - 插件宿主的新实例
+     */
+    onCreate(hostInst: InstanceType<HostClass>, ...args: ConstructorParameters<HostClass>): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+    /**
+     * 插件宿主创建实例时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IExtend.onCreate } 方法
+     * @param hostInst - 插件宿主的新实例
+     * @param args - 初始化宿主实例时的参数
+     */
+    onInit(hostInst: InstanceType<HostClass>, ...args: any): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+    /**
+     * 插件宿主被销毁时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IExtend.onDestroy} 方法
+     * @param hostInst - 被销毁的插件实例
+     */
+    onDestroy(hostInst: InstanceType<HostClass>): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+}
+//# sourceMappingURL=ExtendManager.d.ts.map

package/dist/plugin-manager/ExtendManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtendManager.d.ts","sourceRoot":"","sources":["../../src/plugin-manager/ExtendManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAyB,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpF;;;;;;GAMG;AACH,qBAAa,aAAa,CAAC,SAAS,SAAS,mBAAmB,CAAE,SAAQ,WAAW;IAEjF;;OAEG;IACH,IAAI,EAAG,SAAS,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,OAAO,0BAAiC;IAIjD;;OAEG;gBACS,IAAI,CAAC,EAAE,SAAS;IAOnB,WAAW;IAMpB;;;;OAIG;IACH,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC;IAQ1C;;;;;;OAMG;IACH,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,EAAG,GAAG,IAAI,EAAC,qBAAqB,CAAC,SAAS,CAAC;IAQ5H;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,EAAG,GAAG,IAAI,EAAC,qBAAqB,CAAC,SAAS,CAAC;IAWrF;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,EAAC,GAAG,IAAI,EAAC,GAAG;IAWpD;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC;CAY9C"}

package/dist/plugin-manager/IExtend.d.ts

@@ -0,0 +1,64 @@
+import type { AbstractConstructor, ClassType } from "type-tls";
+/**
+ * 扩展选项接口
+ * @remarks
+ * 扩展 与 插件的接口很像，他们的区别是：
+ * - 扩展中的方法的 this 值是被扩展的类的实例，而插件中方法的 this 值是插件对象本身
+ * - 扩展中除接口中定义的成员之外，其他成员都会被直接添加到宿主类的原型 prototype 上，而插件的成员不会
+ */
+export interface IExtend<HostClass extends AbstractConstructor> {
+    /**
+     * 当宿主实例被创建时调用
+     * @param host - 新建的宿主实例
+     */
+    onCreate?(host: InstanceType<HostClass>, ...args: ConstructorParameters<HostClass>): any;
+    /**
+     * 当宿主实例被初始化时调用
+     * @param host - 新建的宿主实例
+     * @param args - 初始化宿主实例时的参数
+     */
+    onInit?(host: InstanceType<HostClass>, ...args: any): any;
+    /**
+     * 当宿主实例被销毁时调用
+     * @param host - 被销毁的宿主实例
+     */
+    onDestroy?(host: InstanceType<HostClass>): any;
+}
+/**
+ * 从扩展选项中提取需要设置给宿主类的成员
+ * @param extendOptions
+ * @returns
+ */
+export declare function pickHostExtendMembers<Ext>(extendOptions: Ext): Omit<Ext, keyof IExtend<any>>;
+/**
+ * 扩展目标的选项类型
+ *
+ * @remarks
+ * 它是一个对象类型，它的属性是 E 的属性，并且会自动更改其this的类型为 InstanceType<C> & E
+ *
+ * @param HostClass - 扩展的目标类类型
+ * @param E - 扩展的对象类型
+ */
+export type ExtendOptions<HostClass extends AbstractConstructor, E> = E & ThisType<InstanceType<HostClass> & E> & IExtend<HostClass>;
+/**
+ * 扩展目标的类类型
+ *
+ * @remarks
+ * 它是一个类类型，它的实例类型是 InstanceType<C> & E，构造函数参数是 ConstructorParameters<C>
+ *
+ * @param HostClass - 扩展的目标类类型
+ * @param E - 扩展的对象类型
+ */
+export type ExtendClassType<HostClass extends AbstractConstructor, E> = ClassType<InstanceType<HostClass> & E, ConstructorParameters<HostClass>>;
+/**
+ * 定义扩展的类型便利函数
+ *
+ * @remarks
+ * 它会更改 ext 中方法的this指向为 cla & ext，不会真的执行扩展操作。
+ *
+ * @param hostClass - 扩展的目标，用作 this 的类型
+ * @param ext - 描述扩展内容的对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 ext 对象本身
+ */
+export declare function defineExtend<HostClass extends AbstractConstructor, E>(hostClass: HostClass, ext: ExtendOptions<HostClass, E>): E & ThisType<HostClass & E>;
+//# sourceMappingURL=IExtend.d.ts.map

package/dist/plugin-manager/IExtend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IExtend.d.ts","sourceRoot":"","sources":["../../src/plugin-manager/IExtend.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAC,SAAS,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,OAAO,CAAC,SAAS,SAAS,mBAAmB;IAC1D;;;OAGG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,EAAG,GAAG,IAAI,EAAC,qBAAqB,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAEzF;;;;OAIG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,EAAC,GAAG,IAAI,EAAC,GAAG,GAAG,GAAG,CAAC;IAExD;;;OAGG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;CAClD;AAMD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAC,GAAG,GAAG,IAAI,CAAC,GAAG,EAAC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,CAU1F;AASD;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,CAAC,SAAS,SAAS,mBAAmB,EAAE,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAMrI;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CAAC,SAAS,SAAS,mBAAmB,EAAE,CAAC,IAAI,SAAS,CAAC,YAAY,CAAC,SAAS,CAAC,GAAG,CAAC,EAAC,qBAAqB,CAAC,SAAS,CAAC,CAAC,CAAC;AAQhJ;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,SAAS,mBAAmB,EAAE,CAAC,EAAG,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,SAAS,GAAG,CAAC,CAAC,CAE3J"}

package/dist/plugin-manager/IPlugin.d.ts

@@ -0,0 +1,56 @@
+import type { AnyFunction, AbstractClassType } from "type-tls";
+/**
+ * 插件宿主的实例类型
+ */
+export type HostInst<H> = H extends new (...args: any) => Object ? InstanceType<H> : H;
+/**
+ * 插件的接口
+ * @remarks
+ * 插件 与 扩展的接口很像，他们的区别是：
+ * - 插件中的方法的 this 值是插件对象本身，而扩展中方法的 this 值是宿主实例
+ * - 插件的成员不会被直接添加到宿主类的原型 prototype 上，而扩展的成员会
+ * @typeParam HOST - 插件宿主的类类型
+ */
+export interface IPlugin<Host, HostClass = AbstractClassType<Host>> {
+    /**
+     * 当插件被注册时调用
+     * @param hostClass - 宿主的类型
+     * @param args - 注册插件时的参数
+     */
+    onUse(hostClass: HostClass, ...args: any): any;
+    /**
+     * 当宿主实例被创建时调用
+     * @param host - 新建的宿主实例
+     */
+    onCreate?(host: Host, ...args: any): any;
+    /**
+     * 当宿主实例被初始化时调用
+     * @param host - 新建的宿主实例
+     * @param args - 初始化宿主实例时的参数
+     */
+    onInit?(host: Host, ...args: any): any;
+    /**
+     * 当宿主实例被销毁时调用
+     * @param host - 被销毁的宿主实例
+     */
+    onDestroy?(host: Host): any;
+}
+/**
+ * 获取插件的 used 方法的参数类型
+ */
+export type PluginUseArgs<Plugin extends IPlugin<any, any>> = Plugin["onUse"] extends (host: any, ...args: infer P) => any ? P : never;
+/**
+ * 插件的 used 方法的返回值类型
+ */
+export type PluginUseReturn<P extends IPlugin<any, any>> = ReturnType<P["onUse"]>;
+/**
+ * 插件的 created 方法的返回值类型
+ */
+export type PluginCreatedReturn<P extends IPlugin<any, any>> = P["onCreate"] extends AnyFunction ? ReturnType<P["onCreate"]> : never;
+/**
+ * 判断一个对象是否是插件
+ * @param target
+ * @returns
+ */
+export declare function isPlugin(target: any): target is IPlugin<any, any>;
+//# sourceMappingURL=IPlugin.d.ts.map

package/dist/plugin-manager/IPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPlugin.d.ts","sourceRoot":"","sources":["../../src/plugin-manager/IPlugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,KAAK,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAIvF;;;;;;;GAOG;AACH,MAAM,WAAW,OAAO,CAAC,IAAI,EAAC,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC;IAC7D;;;;OAIG;IACH,KAAK,CAAC,SAAS,EAAE,SAAS,EAAG,GAAG,IAAI,EAAC,GAAG,GAAG,GAAG,CAAC;IAE/C;;;OAGG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,IAAI,EAAG,GAAG,IAAI,EAAC,GAAG,GAAG,GAAG,CAAC;IAEzC;;;;OAIG;IACH,MAAM,CAAC,CAAC,IAAI,EAAE,IAAI,EAAC,GAAG,IAAI,EAAC,GAAG,GAAG,GAAG,CAAC;IAErC;;;OAGG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,IAAI,GAAG,GAAG,CAAC;CAC/B;AAGD;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,MAAM,SAAS,OAAO,CAAC,GAAG,EAAC,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,EAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,GAAG,GAAI,CAAC,GAAG,KAAK,CAAC;AAGtI;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,EAAC,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;AAGjF;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,OAAO,CAAC,GAAG,EAAC,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,GAAG,KAAK,CAAC;AAIpI;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,EAAC,GAAG,CAAC,CAEhE"}

package/dist/plugin-manager/PluginExtendManager.d.ts

@@ -0,0 +1,92 @@
+import type { AnyFunction, AbstractConstructor, ClassType } from "type-tls";
+import { Destroyable } from "@gby/destroyable";
+import { type ExtendOptions, type IExtend } from "./IExtend";
+import { type IPlugin, type PluginUseArgs, type PluginUseReturn } from "./IPlugin";
+/**
+ * 用于标识是扩展的标记
+ */
+export declare const extendMark: unique symbol;
+/**
+ * 插件扩展管理者
+ *
+ * @remarks
+ * 负责管理插件 和 扩展的注册、应用 等
+ * 相当于 PluginManager + ExtendManager
+ *
+ */
+export declare class PluginExtendManager<Host, HostClass extends AbstractConstructor<Host> = ClassType<Host>> extends Destroyable {
+    /**
+     * 插件的宿主
+     */
+    host: HostClass;
+    /**
+     * 所有注册的插件
+     */
+    readonly plugins: Map<IPlugin<Host, HostClass> | IExtend<HostClass>, any>;
+    /**
+     * @param host - 插件的宿主
+     */
+    constructor(host?: HostClass);
+    destroyThis(): any;
+    /**
+     * 判断一个对象是否是插件
+     * @param target
+     * @returns
+     */
+    isPlugin(target: any): target is IPlugin<Host, HostClass>;
+    /**
+     * 使用插件、注册插件
+     * @param ext - 插件
+     * @param args - 传递给插件的选项
+     */
+    useExtend<E>(ext: ExtendOptions<HostClass, E>): boolean;
+    /**
+     * 插件宿主实例的注册插件的方法
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IExtend.use } 方法
+     * @param hostInst - 插件宿主的新实例
+     */
+    instUseExtend<E>(hostInst: InstanceType<HostClass>, ext: ExtendOptions<HostClass, E>, ...args: ConstructorParameters<HostClass>): boolean;
+    /**
+     * 使用插件、注册插件
+     * @param plugin - 插件
+     * @param args - 传递给插件的选项
+     */
+    usePlugin<P extends IPlugin<Host, HostClass>>(plugin: P, ...args: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * 插件宿主实例的注册插件的方法
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IPlugin.use } 方法
+     * @param hostInst - 插件宿主的新实例
+     */
+    instUsePlugin<P extends IPlugin<Host, HostClass>>(hostInst: Host, plugin: P, ...options: PluginUseArgs<P>): PluginUseReturn<P>;
+    /**
+     * 插件宿主创建实例时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IPlugin.onCreate} 方法
+     * 如果插件的 created 方法返回 Promise，则会等待 Promise  resolve
+     * @param hostInst - 插件宿主的新实例
+     */
+    onCreate(hostInst: Host, ...args: any): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+    /**
+     * 插件宿主创建实例时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IPlugin.onCreate } 方法
+     * @param hostInst - 插件宿主的新实例
+     * @param args - 初始化宿主实例时的参数
+     */
+    onInit(hostInst: Host, ...args: any): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+    /**
+     * 插件宿主被销毁时调用
+     *
+     * @remarks
+     * 会调用每个插件的 {@link IPlugin.onDestroy} 方法
+     * @param hostInst - 被销毁的插件实例
+     */
+    onDestroy(hostInst: Host): import("com-tools").SerialCallFunsReturn<AnyFunction>;
+}
+//# sourceMappingURL=PluginExtendManager.d.ts.map

package/dist/plugin-manager/PluginExtendManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginExtendManager.d.ts","sourceRoot":"","sources":["../../src/plugin-manager/PluginExtendManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAC,SAAS,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,OAAO,EAAyB,MAAM,WAAW,CAAC;AACpF,OAAO,EAAY,KAAK,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAI7F;;GAEG;AACH,eAAO,MAAM,UAAU,eAAmB,CAAC;AAG3C;;;;;;;GAOG;AACH,qBAAa,mBAAmB,CAAC,IAAI,EAAC,SAAS,SAAS,mBAAmB,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,CAAE,SAAQ,WAAW;IAEpH;;OAEG;IACH,IAAI,EAAG,SAAS,CAAC;IAEjB;;OAEG;IACH,QAAQ,CAAC,OAAO,0DAA6D;IAG7E;;OAEG;gBACS,IAAI,CAAC,EAAE,SAAS;IAOnB,WAAW;IAMpB;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,IAAI,EAAC,SAAS,CAAC;IAQxD;;;;OAIG;IACH,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC;IAQ7C;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,SAAS,CAAC,EAAE,GAAG,EAAE,aAAa,CAAC,SAAS,EAAE,CAAC,CAAC,EAAG,GAAG,IAAI,EAAC,qBAAqB,CAAC,SAAS,CAAC;IAQ/H;;;;OAIG;IACH,SAAS,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,EAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAC,GAAG,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAQrG;;;;;;OAMG;IACH,aAAa,CAAC,CAAC,SAAS,OAAO,CAAC,IAAI,EAAC,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,GAAG,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC;IAU7H;;;;;;;OAOG;IACH,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAG,GAAG,IAAI,EAAC,GAAG;IAYrC;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,EAAE,IAAI,EAAC,GAAG,IAAI,EAAC,GAAG;IAYjC;;;;;;OAMG;IACH,SAAS,CAAC,QAAQ,EAAE,IAAI;CAa3B"}