plugin-tls 0.0.0 → 1.1.0

package/README.md

@@ -1,5 +1,5 @@
-[教程]: ./docs/教程.md
-[API接口文档]: ./doc/index.md
+[教程]: ./doc/教程.md
+[API接口文档]: ./doc/api/index.md
 
 [GitHub仓库]: https://github.com/GuoBinyong/library-vite-template
 [发行地址]: https://github.com/GuoBinyong/library-vite-template/releases
@@ -55,13 +55,13 @@
 
 
 ## 3.1. 方式1：通过 npm 安装
+通过 npm （或 yarn、pnpm 等包管理器）安装
 ```
 npm install library-vite-template
 ```
 
 
 
-
 ## 3.2. 方式3：通过`<script>`标签引入
 您可直接从项目的 [发行地址][] 中下载以 `.iife.js` 作为缀的文件，然后使用如下代码引用 和 使用 library-vite-template：
 
@@ -71,10 +71,10 @@ npm install library-vite-template
    <script src="path/to/package/library-vite-template.iife.js"></script>
    ```
    
-2. 使用全局的 `library-vite-template`
+2. 使用全局的 `LibraryViteTemplate`
    ```
    <script>
-   // 使用全局的 library-vite-template
+   // 使用全局的 LibraryViteTemplate
    </script>
    ```
 

package/dist/extend/extend.d.ts

@@ -0,0 +1,222 @@
+/**
+ * 类的类型、构造函数的类型
+ *
+ * @typeParam Arg - 构建函数的参数类型
+ * @typeParam Instance - 构建函数的返回的实例类型
+ */
+export interface ClassType<Arg extends any[] = any, Instance = any> {
+    new (...args: Arg): Instance;
+}
+/**
+ * 类扩展者的私有方法
+ */
+export interface ClassExtenderPrivateMember<C extends new (...args: any) => any> {
+    /**
+     * 保存扩展类自定义的构建函数
+     */
+    readonly _constructors: ((this: InstanceType<C>, ...args: ConstructorParameters<C>) => void)[];
+    /**
+     * 保存扩展类自定义的销毁函数
+     */
+    readonly _destroys: ((this: InstanceType<C>) => void)[];
+}
+/**
+ * 类扩展者
+ */
+export type ClassExtender<C extends new (...args: any) => any> = C & ClassExtenderPrivateMember<C>;
+/**
+ * 用于定义扩展选项中的私有成员
+ */
+export interface PrivateMemberOfExtend<TargetType extends new (...args: any) => any> {
+    /**
+     * 扩展类中用于定义在创建实例时的初始化的方法
+     * @remarks
+     * 该方法会在创建实例时自动执行，并将构建函数接收到的参数透传给方方法。
+     *
+     * 注意：
+     * _constructor  会被保存在 目标类中的 _constructors 属性中，它是一个数组。
+     *
+     * 目标类 需要在自己的构建函数中逐个调用 cla._constructors 中的函数
+     *
+     * @param args
+     */
+    _constructor?(...args: (TargetType extends new (...args: infer A) => any ? A : never)): void;
+    /**
+     * 扩展类中用于定义在实例销毁时触发的销毁方法
+     * @remarks
+     * 该方法会在实例销毁时自动调用
+     *
+     * 注意：
+     * _destroy  会被保存在 目标类中的 _destroys 属性中，它是一个数组。
+     *
+     * 如果目标类有销毁逻辑，则需要在自己的销毁函数中逐个调用 cla._destroys 中的函数
+     *
+     * @param args
+     */
+    _destroy?(): void;
+}
+/**
+ * 定义扩展的类型便利函数
+ *
+ * @remarks
+ * 它会更改 ext 中方法的this指向为 cla & ext，不会真的执行扩展操作。
+ *
+ * 其中 ext._constructor  会被保存在 cla._constructors 属性中，它是一个数组。
+ *
+ * cla 需要在自己的构建函数中逐个调用 cla._constructors 中的函数
+ *
+ * @param cla - 扩展的目标，用作 this 的类型
+ * @param ext - 描述扩展内容的对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 ext 对象本身
+ */
+export declare function defineExtend<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtend<C>): E & ThisType<C & E>;
+/**
+ * 扩展目标
+ *
+ * @remarks
+ * 与 {@link defineExtend} 的区别是：`targetExtend` 会执行对 cla 的扩展操作，而 {@link defineExtend} 不会
+ *
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @param ext - 扩展描述对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 ext 对象本身
+ */
+export declare function targetExtend<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtend<C>): E & ThisType<InstanceType<C> & E>;
+/**
+ * 创建用于扩展目标的便捷函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link targetExtend} 的功能一样，唯一区别是不再需要接收 cla 参数了
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @returns 可以用于 扩展目标 的便利函数
+ */
+export declare function createTargetExtend<C extends ClassType>(cla: C): <E>(ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtend<C>) => E & ThisType<C & E>;
+/**
+ * 扩展目标
+ *
+ * @remarks
+ * 会执行对 CEarth 类的扩展操作。
+ * 与 {@link targetExtend} 的区别仅仅是返回类型不一样。
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @param ext - 扩展对象，会自动更改其this的类型
+ * @returns 返回扩展后的 cla 对象
+ */
+export declare function extendTarget<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtend<C>): ClassType<ConstructorParameters<C>, E & ThisType<InstanceType<C> & E>>;
+/**
+ * 创建用于扩展目标工具函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link extendTarget} 的功能一样，唯一区别是不再需要接收 cla 参数了
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @returns 可以用于 扩展目标 的便利函数
+ */
+export declare function createExtendTarget<C extends ClassType>(cla: C): <E>(ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtend<C>) => ClassType<ConstructorParameters<C>, E & ThisType<InstanceType<C> & E>>;
+/**
+ * 类扩展者的私有方法
+ */
+export interface ClassExtenderPrivateMemberWithInit<C extends new (...args: any) => any, InitParams extends any[] = any> extends ClassExtenderPrivateMember<C> {
+    /**
+     * 保存扩展类中自定义的初始化方法
+     */
+    readonly _inits: ((this: InstanceType<C>, ...args: InitParams) => void)[];
+}
+/**
+ * 类扩展者
+ */
+export type ClassExtenderWithInit<C extends new (...args: any) => any, InitParams extends any[] = any> = C & ClassExtenderPrivateMemberWithInit<C, InitParams>;
+/**
+ * 用于定义扩展选项中的私有成员
+ */
+export interface PrivateMemberOfExtendWithInit<TargetType extends new (...args: any) => any, InitParams extends any[] = any> extends PrivateMemberOfExtend<TargetType> {
+    /**
+     * 扩展类中用于定义实例初始化逻辑的方法
+     * @remarks
+     * 该方法会在调用实例的 `init()` 方法时自动执行。
+     * @param args
+     */
+    _init?(...args: InitParams): void;
+}
+/**
+ * 对一组函数批量调用 apply
+ * @param funArr
+ * @param thisArg
+ * @param args
+ */
+export declare function allFunctionApply<T, A extends any[], R>(funArr: ((this: T, ...args: A) => void)[], thisArg: T, args: A): void;
+/**
+ * 创建扩展的私有方法的调用者
+ * @param cla
+ * @returns constructed：执行所有 `_constructor` 的便利函数；initialized：执行所有 `_inits` 的便利函数
+ */
+export declare function createCallerOfPrivateMemberOfExtend<C extends ClassType>(cla: C): {
+    constructed: (thisArg: any, args: any[]) => void;
+    initialized: (thisArg: any, args: any[]) => void;
+    destroyed: (thisArg: any, args: any[]) => void;
+};
+/**
+ * 定义扩展的类型便利函数
+ *
+ * @remarks
+ * 它会更改 ext 中方法的this指向为 cla & ext，不会真的执行扩展操作。
+ *
+ * 其中：
+ * - ext._constructor  会被保存在 cla._constructors 属性中，它是一个数组。
+ * - ext._init  会被保存在 cla._inits 属性中，它是一个数组。
+ *
+ * cla 需要：
+ * - 在自己的构建函数中逐个调用 cla._constructors 中的函数
+ * - 在自己的类似初始化`init()` 方法中逐个调用 cla._constructors 中的函数
+ *
+ * @param cla - 扩展的目标，用作 this 的类型
+ * @param ext - 描述扩展内容的对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 ext 对象本身
+ */
+export declare function defineExtendWithInit<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtendWithInit<C>): E & ThisType<C & E>;
+/**
+ * 扩展目标
+ *
+ * @remarks
+ * 与 {@link defineExtendWithInit} 的区别是：`targetExtend` 会执行对 cla 的扩展操作，而 {@link defineExtendWithInit} 不会
+ *
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @param ext - 扩展描述对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 ext 对象本身
+ */
+export declare function targetExtendWithInit<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtendWithInit<C>): E & ThisType<InstanceType<C> & E>;
+/**
+ * 创建用于扩展目标的便捷函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link targetExtendWithInit} 的功能一样，唯一区别是不再需要接收 cla 参数了
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @returns 可以用于 扩展目标 的便利函数
+ */
+export declare function createTargetExtendWithInit<C extends ClassType>(cla: C): <E>(ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtendWithInit<C, any>) => E & ThisType<C & E>;
+/**
+ * 扩展目标
+ *
+ * @remarks
+ * 会执行对 CEarth 类的扩展操作。
+ * 与 {@link targetExtendWithInit} 的区别仅仅是返回类型不一样。
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @param ext - 扩展对象，会自动更改其this的类型
+ * @returns 返回扩展后的 cla 对象
+ */
+export declare function extendTargetWithInit<C extends ClassType, E>(cla: C, ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtendWithInit<C>): ClassType<ConstructorParameters<C>, E & ThisType<InstanceType<C> & E>>;
+/**
+ * 创建用于扩展目标工具函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link extendTargetWithInit} 的功能一样，唯一区别是不再需要接收 cla 参数了
+ *
+ * @param cla - 扩展的目标，也用作 this 的类型
+ * @returns 可以用于 扩展目标 的便利函数
+ */
+export declare function createExtendTargetWithInit<C extends ClassType>(cla: C): <E>(ext: E & ThisType<InstanceType<C> & E> & PrivateMemberOfExtendWithInit<C, any>) => ClassType<ConstructorParameters<C>, E & ThisType<InstanceType<C> & E>>;
+//# sourceMappingURL=extend.d.ts.map

package/dist/extend/extend.d.ts.map

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

package/dist/extend/mixin.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 混合
+ * @internal
+ */
+export declare function mixin<T, S>(target: T, source: S): T & S;
+/**
+ * 混合
+ * @internal
+ */
+export declare function mixin<T, S1, S2>(target: T, source1: S1, source2: S2): T & S1 & S2;
+/**
+ * 混合
+ * @internal
+ */
+export declare function mixin<T, S1, S2, S3>(target: T, source1: S1, source2: S2, source3: S3): T & S1 & S2 & S3;
+/**
+ * 混合
+ * @internal
+ */
+export declare function mixin<T, S1, S2, S3, S4>(target: T, source1: S1, source2: S2, source3: S3, source4: S3): T & S1 & S2 & S3 & S4;
+/**
+ * 混合
+ *
+ * @remarks
+ * 将 source 的所有成员混入 target 对象中。
+ *
+ * 与 `Object.assign()` 的功能类似，不同的是 `mixin()` 会在 target 对象中 保持 source 对象属性的  PropertyDescriptors
+ *
+ * @param target - 目标对象，所有 源对象 的属性都要被混入进到 目标对象中
+ * @param sources - 源对象，所有 源对象 的属性都要被混入进到 目标对象中
+ * @returns 混入后的 target
+ */
+export declare function mixin(target: any, ...sources: any[]): any;
+/**
+ * 定义混合的类型便利函数
+ *
+ * @remarks
+ * 它会更改 mixin 中方法的this指向为 target & mixin，不会真的执行混合操作
+ *
+ * @param target - 混合的目标，用作 this 的类型
+ * @param mixin - 混合对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 mixin 对象本身
+ */
+export declare function defineMixin<T, M>(target: T, mixin: M & ThisType<T & M>): M & ThisType<T & M>;
+/**
+ * 创建定义混合的类型便利函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link defineMixin} 的功能一样，唯一区别是不再需要接收 target 参数了
+ *
+ * @returns 可以用于 定义混合的 类型便利函数
+ */
+export declare function createDefineMixin<T>(): <M>(target: T, mixin: M & ThisType<T & M>) => M & ThisType<T & M>;
+/**
+ * 混合目标
+ *
+ * @remarks
+ * 与 {@link defineMixin} 的区别是：`targetMixin` 会执行对 target 的混合操作，而 {@link defineMixin} 不会
+ *
+ *
+ * @param target - 混合的目标，用作 this 的类型
+ * @param m - 混合对象，会自动更改其this的类型
+ * @returns 返回注入了 this 类型的 mixin 对象本身
+ */
+export declare function targetMixin<T, M>(target: T, m: M & ThisType<T & M>): M & ThisType<T & M>;
+/**
+ * 创建用于混合目标的便捷函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link targetMixin} 的功能一样，唯一区别是不再需要接收 target 参数了
+ *
+ * @param target - 混合的目标，用作 this 的类型
+ * @returns 可以用于 混合目标 的便利函数
+ */
+export declare function createTargetMixin<T>(target: T): <M>(m: M & ThisType<T & M>) => M & ThisType<T & M>;
+/**
+ * 混合目标
+ *
+ * @remarks
+ * 会执行对 CEarth 类的扩展操作。
+ * 与 {@link targetMixin} 的区别仅仅是返回类型不一样。
+ *
+ * @param target - 混合的目标，用作 this 的类型
+ * @param m - 混合对象，会自动更改其this的类型
+ * @returns 返回混合后的 target 对象
+ */
+export declare function mixinTarget<T, M>(target: T, m: M & ThisType<T & M>): M & ThisType<T & M> & T;
+/**
+ * 创建用于混合目标工具函数
+ *
+ * @remarks
+ * 它返回的便利函数的功能与 {@link mixinTarget} 的功能一样，唯一区别是不再需要接收 target 参数了
+ *
+ * @returns 可以用于 混合目标 的便利函数
+ */
+export declare function createMixinTarget<T>(target: T): <M>(m: M & ThisType<T & M>) => M & ThisType<T & M> & T;
+/**
+ * 替换构建函数的参数
+ */
+export type ReplaceConstructorParameters<C extends new (...args: any) => any, NewParms extends any[]> = new (...args: NewParms) => InstanceType<C>;
+/**
+ * 替换构造函数的返回类型
+ */
+export type ReplaceConstructorReturn<C extends new (...args: any) => any, NewReturn> = new (...args: ConstructorParameters<C>) => NewReturn;
+//# sourceMappingURL=mixin.d.ts.map

package/dist/extend/mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../../src/extend/mixin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AACzD;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAC7B,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,GACV,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;AACf;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EACjC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,GACV,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACpB;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EACrC,MAAM,EAAE,CAAC,EACT,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,EAEX,OAAO,EAAE,EAAE,GACV,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACzB;;;;;;;;;;;GAWG;AACH,wBAAgB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC;AAU3D;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GACzB,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAErB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,iBAEvB,CAAC,qDAKZ;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,CAAC,EACT,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GACrB,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAGrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,sDAK7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,CAAC,EAC9B,MAAM,EAAE,CAAC,EACT,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GACrB,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAGzB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,0DAO7C;AAKD;;GAEG;AACH,MAAM,MAAM,4BAA4B,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAC,GAAG,KAAG,GAAG,EAAC,QAAQ,SAAS,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAC,QAAQ,KAAG,YAAY,CAAC,CAAC,CAAC,CAAC;AAE5I;;GAEG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,SAAS,KAAK,GAAG,IAAI,EAAC,GAAG,KAAG,GAAG,EAAC,SAAS,IAAI,KAAK,GAAG,IAAI,EAAC,qBAAqB,CAAC,CAAC,CAAC,KAAG,SAAS,CAAC"}

package/dist/index.d.ts

@@ -16,7 +16,17 @@
  *
  * @packageDocumentation
  */
-export * from "./PluginManager";
-export * from "./PluginHost";
-export * from "./OptionsPluginHost";
-export * from "./defaultOptions";
+export * from "./extend/mixin";
+export * from "./extend/extend";
+export * from "./plugin-manager/PluginManager";
+export * from "./plugin-manager/PluginManagerWithInit";
+export * from "./options-manager/defaultOptions";
+export * from "./options-manager/ModeOptions";
+export * from "./options-manager/TierOptions";
+export * from "./options-manager/TierModeOptions";
+export * from "./options-manager/tools";
+export * from "./plugin-host/PluginHost";
+export * from "./plugin-host/TierOptionsPluginHost";
+export * from "./plugin-host/TierModeOptionsPluginHost";
+export * from "./properties";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAG/B,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wCAAwC,CAAA;AAGtD,cAAc,kCAAkC,CAAA;AAChD,cAAc,+BAA+B,CAAA;AAC7C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,mCAAmC,CAAA;AACjD,cAAc,yBAAyB,CAAA;AAGvC,cAAc,0BAA0B,CAAA;AACxC,cAAc,qCAAqC,CAAA;AACnD,cAAc,yCAAyC,CAAA;AAGvD,cAAc,cAAc,CAAA"}

package/dist/options-manager/ModeOptions.d.ts

@@ -0,0 +1,88 @@
+import { OptionsManager } from "./OptionsManager";
+import { TierOptions } from "./TierOptions";
+/**
+ * 模式选项
+ * @remarks
+ * 针对选项提供了模式和继承的功能；
+ *
+ * 适用以下场景：
+ * 你设计了一个支持许多选项的工具，不同场景下需要配置不同的选项值，比如有如下几个场景：
+ * - 性能模式：所有的配置项以性能为目标进行配置，关闭那些效果类的选项；
+ * - 特效模式：以高质量的渲染效果为目标进行配置，会开启所有的效果选项；
+ * - 平衡模式：兼顾性能和效果，取个折中；
+ *
+ * 并且这些模式也会一些共同的选项；
+ *
+ * 使用该类，你可以：
+ * - 设置一个基本模式：该模式提供的所有模式都会有的共用选项
+ * - 设置 性能模式、特效模式、平衡模式 继承 基本模式；
+ */
+export declare class ModeOptions<Mode extends string | number = string, Option extends {} = any> extends OptionsManager<Option> {
+    constructor(mode: Mode);
+    constructor(mode: Mode, options?: Option);
+    /**
+     * 模式的配置
+     */
+    modes: Record<Mode, TierOptions<Option>>;
+    /**
+     * 当前模式
+     */
+    get mode(): Mode;
+    set mode(value: Mode);
+    protected _mode?: Mode;
+    /**
+     * 所有的模式名字
+     */
+    get modeNames(): Mode[];
+    protected _modeNames: Mode[] | null;
+    /**
+     * 获取所有的模式名字
+     * @returns
+     */
+    getModeNames(): Mode[];
+    /**
+     * 判断是否有某个模式
+     * @param mode
+     * @returns
+     */
+    hasMode(mode: string | number): boolean;
+    /**
+     * 当前模式的选项
+     */
+    get optionManager(): TierOptions<Option>;
+    /**
+     * 当前模式对应的选项
+     */
+    get option(): Option;
+    get plainFullOption(): Option;
+    protected _plainFullOption: Option | null;
+    /**
+     * 更新
+     */
+    updateFullOption(): void;
+    /**
+     * 返回已合并继承选项的选项
+     * @remarks
+     * 与继承选项只是浅合并
+     * @param mode
+     * @returns
+     */
+    getModeOption(mode: Mode): Option | null;
+    /**
+     * 返回已合并继承选项的完整选项
+     * @remarks
+     * 与继承选项合并
+     * @param mode
+     * @returns
+     */
+    getFullModeOption(mode: Mode): Option | null;
+    /**
+     * 给模式设置选项
+     * @param mode
+     * @param option
+     * @param deep - 是否要进行深度合并
+     * @param extend - 继承哪个模式
+     */
+    setModeOption(mode: Mode, option: Option, deep?: boolean, extend?: Mode): Record<Mode, TierOptions<Option>>[Mode];
+}
+//# sourceMappingURL=ModeOptions.d.ts.map

package/dist/options-manager/ModeOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ModeOptions.d.ts","sourceRoot":"","sources":["../../src/options-manager/ModeOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAA;AAC/C,OAAQ,EAAC,WAAW,EAAC,MAAM,eAAe,CAAA;AAG1C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,WAAW,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,GAAG,MAAM,EAAC,MAAM,SAAS,EAAE,GAAG,GAAG,CAAE,SAAQ,cAAc,CAAC,MAAM,CAAC;gBAEtG,IAAI,EAAE,IAAI;gBACV,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM;IASxC;;OAEG;IACH,KAAK,oCAA0C;IAE/C;;OAEG;IACH,IAAI,IAAI,IAAG,IAAI,CAEd;IACD,IAAI,IAAI,CAAC,KAAK,EAHH,IAGG,EAMb;IACD,SAAS,CAAC,KAAK,CAAC,EAAC,IAAI,CAAC;IAGtB;;OAEG;IACH,IAAI,SAAS,WAEZ;IAED,SAAS,CAAC,UAAU,EAAC,IAAI,EAAE,GAAG,IAAI,CAAQ;IAG1C;;;OAGG;IACH,YAAY;IAKZ;;;;OAIG;IACH,OAAO,CAAC,IAAI,EAAC,MAAM,GAAG,MAAM;IAM5B;;OAEG;IACH,IAAI,aAAa,IAAG,WAAW,CAAC,MAAM,CAAC,CAEtC;IAID;;OAEG;IACH,IAAI,MAAM,WAET;IAED,IAAI,eAAe,WAElB;IAED,SAAS,CAAC,gBAAgB,EAAC,MAAM,GAAC,IAAI,CAAQ;IAG9C;;OAEG;IACH,gBAAgB;IAOhB;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAC,IAAI,GAAE,MAAM,GAAC,IAAI;IAIpC;;;;;;OAMG;IACH,iBAAiB,CAAC,IAAI,EAAC,IAAI,GAAE,MAAM,GAAC,IAAI;IAKxC;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAC,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,IAAI,CAAC,EAAC,OAAO,EAAC,MAAM,CAAC,EAAC,IAAI;CAiBnE"}

package/dist/options-manager/OptionsManager.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 视为未定义的选项值
+ * @remarks
+ * 当选项的值是未定义的值
+ */
+export declare enum UndefinedOptionValue {
+    /**
+     * 将 undefined 和 null 都视为未定义的选项
+     */
+    UndefinedAndNull = "UndefinedAndNull",
+    /**
+     * 只将 undefined 视为未定义的选项
+     */
+    Undefined = "Undefined",
+    /**
+     * 只将 null 视为未定义的选项
+     */
+    Null = "Null"
+}
+/**
+ * 各种判断未定义值的函数集
+ */
+export declare const isUndefinedMap: {
+    UndefinedAndNull: (value: any) => boolean;
+    Undefined: (value: any) => boolean;
+    Null: (value: any) => boolean;
+};
+/**
+ * 选项管理器
+ */
+export declare abstract class OptionsManager<Option extends {} = any> {
+    /**
+     * 选项
+     */
+    abstract option: Option;
+    /**
+     * 是否要冻结 fullOption 的成员
+     * @remarks
+     * 只会冻结 fullOption 的直接成员的值，不会冻结 fullOption 孙子成员的值
+     */
+    freezeMember: boolean;
+    /**
+     * 可更新顶级成员值的完整的选项
+     * @remarks
+     * 合并后的选项；
+     * plainFullOption 的代理对象，自动监听了顶层成员的屐；所以可以更改顶级成员的值，不可以更改非顶级成员的值；
+     */
+    fullOption: Option;
+    /**
+     * 完整的选项
+     * @remarks
+     * 合并后的选项
+     */
+    abstract readonly plainFullOption: Option;
+    /**
+     * 更新完整的选项
+     */
+    abstract updateFullOption(): void;
+    /**
+     * 设置选项
+     * @remarks
+     * 会将被设置的选项浅合并进当前选项中
+     * @param option
+     * @param deep - 是否要进行深度合并
+     */
+    setOption(option: Option, deep?: boolean): void | Option;
+    /**
+     * 未定义值的类型
+     */
+    get undefinedValue(): UndefinedOptionValue;
+    set undefinedValue(value: UndefinedOptionValue);
+    protected _undefinedValue: UndefinedOptionValue;
+    /**
+     * 未定义值的判断函数
+     */
+    isUndefined: (value: any) => boolean;
+    /**
+     * 获取选项成员
+     * @param key
+     * @returns
+     */
+    getMember<Key extends keyof Option>(key: Key): Option[Key] | undefined | null;
+    /**
+     * 设置选项成员
+     * @param key
+     * @param value
+     * @param deep - 是否要进行深度合并
+     */
+    setMember<Key extends keyof Option>(key: Key, value?: Option[Key] | null, deep?: boolean): void;
+    /**
+     * 获取属性路径对应的值
+     * @param propPath
+     * @returns
+     */
+    getValue(propPath: string[]): any;
+    /**
+     * 设置属性路径对应的值
+     * @param propPath
+     * @param value
+     * @param deep - 是否要进行深度合并
+     * @returns
+     */
+    setValue(propPath: string[], value: any, deep?: boolean): void;
+}
+//# sourceMappingURL=OptionsManager.d.ts.map

package/dist/options-manager/OptionsManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionsManager.d.ts","sourceRoot":"","sources":["../../src/options-manager/OptionsManager.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,oBAAY,oBAAoB;IAC5B;;OAEG;IACH,gBAAgB,qBAAqB;IACrC;;OAEG;IACH,SAAS,cAAc;IACvB;;OAEG;IACH,IAAI,SAAS;CAEhB;AAED;;GAEG;AACH,eAAO,MAAM,cAAc;8BACuB,GAAG;uBAGV,GAAG;kBAGR,GAAG;CAGxC,CAAA;AAID;;GAEG;AACH,8BAAsB,cAAc,CAAC,MAAM,SAAS,EAAE,GAAG,GAAG;IAGxD;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB;;;;OAIG;IACH,YAAY,UAAQ;IAEpB;;;;;OAKG;IACH,UAAU,SAiCc;IAGxB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAE1C;;OAEG;IACH,QAAQ,CAAC,gBAAgB,IAAI,IAAI;IAEjC;;;;;;OAMG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;IAQxC;;OAEG;IACH,IAAI,cAAc,yBAEjB;IACD,IAAI,cAAc,CAAC,KAAK,sBAAA,EAGvB;IAED,SAAS,CAAC,eAAe,uBAAyC;IAElE;;OAEG;IACH,WAAW,0BAAmC;IAG9C;;;;OAIG;IACH,SAAS,CAAC,GAAG,SAAS,MAAM,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,GAAG,IAAI;IAI7E;;;;;OAKG;IACH,SAAS,CAAC,GAAG,SAAS,MAAM,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,EAAE,IAAI,CAAC,EAAE,OAAO;IAiBxF;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG;IAIjC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO;CAW1D"}

package/dist/options-manager/TierModeOptions.d.ts

@@ -0,0 +1,69 @@
+import { ModeOptions } from "./ModeOptions";
+import type { TierOptions } from "./TierOptions";
+/**
+ * 层级模式选项
+ * @remarks
+ * 即 ModeOptions 和 TierOptions 的结合
+ */
+export declare class TierModeOptions<Mode extends string | number = string, Option extends {} = any> extends ModeOptions<Mode, Option> {
+    constructor(mode: Mode);
+    constructor(mode: Mode, options?: Option, extend?: TierModeOptions<Mode, Option>);
+    /**
+     * 继承的选项
+     */
+    get extends(): TierModeOptions<Mode, Option> | null;
+    set extends(value: TierModeOptions<Mode, Option> | null);
+    protected _extends: TierModeOptions<Mode, Option> | null;
+    /**
+     * 返回已合并继承选项的最终选项
+     * @remarks
+     * 与继承选项只是浅合并
+     * @param mode
+     * @returns
+     */
+    getFullModeOption(mode: Mode): Option | null;
+    /**
+     * 获取所有的模式名字
+     * @returns
+     */
+    getModeNames(): Mode[];
+    /**
+     * 在整个层级上判断是否有某个模式
+     * @param mode
+     * @returns
+     */
+    hasModeOnTier(mode: string | number): boolean;
+    /**
+     * 当前模式的选项
+     */
+    get optionManager(): TierOptions<Option>;
+    /**
+     * 获取模式对应的选项管理器
+     * @param mode
+     * @returns
+     */
+    getModeOptionManager(mode: Mode): TierOptions<Option> | null;
+    /**
+     * 获取选项成员
+     * @param key
+     * @returns
+     */
+    getMember<Key extends keyof Option>(key: Key): Option[Key] | undefined | null;
+    /**
+     * 获取属性路径对应的值
+     * @param propPath
+     * @returns
+     */
+    getValue(propPath: string[]): any;
+}
+/**
+ * 层级模式选项主机装饰器
+ * @remarks
+ * 可让宿主具备层级模式选项；
+ * 需要宿主有静态的同名属性；
+ * @param target
+ * @param context
+ * @returns
+ */
+export declare function tierModeOptionsDecorator<This, Value>(value: ClassAccessorDecoratorTarget<This, Value>, context: ClassAccessorDecoratorContext<This, Value>): ClassAccessorDecoratorResult<This, Value>;
+//# sourceMappingURL=TierModeOptions.d.ts.map