@whitesev/pops 4.0.2 → 4.2.0

package/dist/types/src/Pops.d.ts

@@ -17,6 +17,7 @@ declare class Pops {
     config: {
         /** 版本号 */
         version: string;
+        /** 样式配置 */
         cssText: {
             index: string;
             ninePalaceGridPosition: string;
@@ -84,10 +85,9 @@ declare class Pops {
             panel: import("./types/inst").PopsInstGeneralConfig[];
             rightClickMenu: import("./types/inst").PopsInstGeneralConfig[];
         };
-        /** 禁止滚动 */
-        forbiddenScroll: {
-            event(event: Event): false;
-        };
+    };
+    /** 导出的函数 */
+    fn: {
         /** pops使用的工具类 */
         Utils: {
             sleep(timeout: number): Promise<unknown>;
@@ -110,7 +110,10 @@ declare class Pops {
             setInterval(callback: (...args: any[]) => any, timeout?: number): number;
             clearInterval(timeId: number | undefined): void;
             setArray<T>(target: T, key: keyof T, newArr: any[]): void;
-            getMaxZIndexNodeInfoFromPoint($el?: IFunction<HTMLElement | HTMLElement[]>, deviation?: number): {
+            getMaxZIndexNodeInfoFromPoint($el?: IFunction<IArray<HTMLElement> | IArray<{
+                x: number;
+                y: number;
+            }>>, deviation?: number): {
                 zIndex: number;
                 originZIndex: number;
                 node: HTMLElement | null;
@@ -136,9 +139,9 @@ declare class Pops {
             height(element: HTMLElement | string | Window | Document | typeof globalThis, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
             outerWidth(element: HTMLElement | string | Window | Document, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
             outerHeight(element: HTMLElement | string | Window, isShow?: boolean, parent?: HTMLElement | ShadowRoot): number;
-            addClassName($el: Element | undefined | null | undefined, className: string | string[] | (() => string | string[]) | undefined | null): void;
+            addClassName($el: Element | undefined | null, className: string | string[] | (() => string | string[]) | undefined | null): void;
             removeClassName($el: Element | undefined | null, className: string): void;
-            containsClassName($el: HTMLElement | undefined | null, className: string): boolean;
+            containsClassName($el: Element | undefined | null, className: string): boolean;
             css($el: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsTargetElementType, property: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsCSSPropertyType): string;
             css($el: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsTargetElementType, property: string): string;
             css($el: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsTargetElementType, property: import("./types/PopsDOMUtilsEventType").PopsDOMUtilsCSSPropertyType & string, value: string | number): string;
@@ -227,6 +230,9 @@ declare class Pops {
                 isOverMaxZIndex: boolean;
             };
             sortElementListByProperty<T, R>(getBeforeValueFun: (value: T) => R, getAfterValueFun: (value: T) => R, sortByDesc?: boolean): (after_obj: T, before_obj: T) => 1 | 0 | -1;
+            isHide($el: Element): boolean;
+            isNodeInPopsNode($el: Element): boolean;
+            isAnimNode($el: Element): boolean;
         };
         /** pops处理float类型使用的工具类 */
         MathFloatUtils: {
@@ -236,10 +242,10 @@ declare class Pops {
             division(number1: number, number2: number): number;
         };
         /** 实例处理函数 */
-        PopsInstHandler: {
+        InstHandler: {
             removeInstance(totalInstConfigList: import("./types/inst").PopsInstGeneralConfig[][], guid?: string, isAll?: boolean): Promise<import("./types/inst").PopsInstGeneralConfig[][]>;
-            hide(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: import("./types/main").PopsInstStoreType, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
             show(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: import("./types/main").PopsInstStoreType, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
+            hide(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: import("./types/main").PopsInstStoreType, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
             close(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: string, instConfigList: import("./types/inst").PopsInstGeneralConfig[], guid: string, $anim: HTMLElement): Promise<void>;
             drag($move: HTMLElement, options: {
                 dragElement: HTMLElement;
@@ -706,7 +712,7 @@ declare class Pops {
             onAsideItemClick($asideItem: HTMLElement, asideConfig: import("./components/panel/types").PopsPanelContentConfig): void;
         };
         /** pops.panel中的动画 */
-        PopsAnimation: {
+        Animation: {
             $data: {
                 [key: string]: CSSKeyframesRule;
             };
@@ -727,8 +733,22 @@ declare class Pops {
         };
         /** 事件类 */
         EventEmiter: typeof EventEmiter;
+        /** 通用的CSS类名 */
+        CommonCSSClassName: {
+            flexCenter: string;
+            flexYCenter: string;
+            flexXCenter: string;
+            hide: string;
+            hideImportant: string;
+            noBorder: string;
+            noBorderImportant: string;
+            userSelectNone: string;
+            lineHeightCenter: string;
+            widthFill: string;
+            textIsDisabled: string;
+            textIsDisabledImportant: string;
+        };
     };
-    init(): void;
     /**
      * 释放原有的pops控制权
      * @example
@@ -779,7 +799,7 @@ declare class Pops {
             } | Omit<import("./types/position").PopsPosition | undefined, "zIndex"> | undefined;
             animation?: {
                 zIndex: ((IFunction<string | number> | null) & IFunction<number>) | undefined;
-            } | Omit<import("./types/animation").PopsAnimation | undefined, "zIndex"> | undefined;
+            } | Omit<false | import("./types/animation").PopsAnimation | undefined, "zIndex"> | undefined;
             mask?: {
                 zIndex: ((IFunction<string | number> | null) & IFunction<number>) | undefined;
             } | Omit<import("./types/mask").PopsMaskConfig | undefined, "zIndex"> | undefined;
@@ -795,9 +815,9 @@ declare class Pops {
             stopKeyDownEventPropagation?: {
                 zIndex: ((IFunction<string | number> | null) & IFunction<number>) | undefined;
             } | Omit<boolean | undefined, "zIndex"> | undefined;
-            beforeAppendToPageCallBack?: {
+            emitter?: {
                 zIndex: ((IFunction<string | number> | null) & IFunction<number>) | undefined;
-            } | Omit<(($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void) | undefined, "zIndex"> | undefined;
+            } | Omit<EventEmiter<import("./types/EventEmitter").CustomEventMap> | null | undefined, "zIndex"> | undefined;
             drag?: {
                 zIndex: ((IFunction<string | number> | null) & IFunction<number>) | undefined;
             } | Omit<boolean | undefined, "zIndex"> | undefined;
@@ -879,7 +899,87 @@ declare class Pops {
             style: string | null;
             lightStyle: string | null;
             darkStyle: string | null;
-            beforeAppendToPageCallBack: ($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void;
+            emitter: {
+                type: import("./types/main").PopsType;
+                data: {
+                    clear: () => void;
+                    delete: (key: string) => boolean;
+                    forEach: (callbackfn: (value: {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[], key: string, map: Map<string, {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>) => void, thisArg?: any) => void;
+                    get: (key: string) => {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[] | undefined;
+                    has: (key: string) => boolean;
+                    set: (key: string, value: {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]) => Map<string, {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>;
+                    readonly size: number;
+                    entries: () => MapIterator<[string, {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]]>;
+                    keys: () => MapIterator<string>;
+                    values: () => MapIterator<{
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>;
+                    [Symbol.iterator]: () => MapIterator<[string, {
+                        type: import("./types/main").PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]]>;
+                    readonly [Symbol.toStringTag]: string;
+                };
+                on: {
+                    <P extends keyof import("./types/EventEmitter").EventMap>(eventName: P, callback: import("./types/EventEmitter").EventMap[P]): {
+                        off: () => IPromise<void>;
+                        emit: (...args: any[]) => IPromise<void>;
+                    };
+                    <P extends string>(eventName: P, callback: (...args: any[]) => IPromise<void>): {
+                        off: () => IPromise<void>;
+                        emit: (...args: any[]) => IPromise<void>;
+                    };
+                };
+                off: {
+                    <P extends keyof import("./types/EventEmitter").EventMap>(eventName: P, callback: import("./types/EventEmitter").EventMap[P]): IPromise<void>;
+                    <P extends string>(eventName: P, callback: (...args: any[]) => IPromise<void>): IPromise<void>;
+                };
+                emit: {
+                    <P extends string>(eventName: P, ...args: any[]): IPromise<void>;
+                    <P extends keyof import("./types/EventEmitter").EventMap>(eventName: P, ...args: Parameters<import("./types/EventEmitter").EventMap[P]>): IPromise<void>;
+                };
+                offAll: {
+                    <P extends keyof import("./types/EventEmitter").EventMap>(eventName?: P | undefined): IPromise<void>;
+                    <P extends string>(eventName?: P | undefined): IPromise<void>;
+                };
+                getAllEvents: (eventName?: string) => {
+                    type: import("./types/main").PopsType;
+                    time: number;
+                    callback: (...args: any[]) => IPromise<void>;
+                }[] | {
+                    type: import("./types/main").PopsType;
+                    time: number;
+                    callback: (...args: any[]) => IPromise<void>;
+                }[][] | undefined;
+                [Symbol.toStringTag]: string;
+            } | null;
         };
         $shadowContainer: HTMLDivElement;
         $shadowRoot: HTMLElement | ShadowRoot;
@@ -900,7 +1000,7 @@ declare class Pops {
      * 配置面板
      * @param config 配置
      */
-    panel: (config: PopsPanelConfig) => Omit<import("./types/event").PopsEventConfig<EventEmiter<import("./components/panel/types").PopsPanelEventType>>, "function" | "type">;
+    panel: (config: PopsPanelConfig) => Omit<import("./types/event").PopsEventConfig<EventEmiter<import("./types/EventEmitter").EventMap>>, "function" | "type">;
     /**
      * 右键菜单
      * @param config 配置

package/dist/types/src/components/loading/types/index.d.ts

@@ -2,7 +2,7 @@ import type { PopsGeneralConfig, PopsContentConfig } from "../../../types/compon
 /**
  * pops.loading
  */
-export interface PopsLoadingConfig extends Omit<PopsGeneralConfig, "width" | "height" | "position" | "beforeAppendToPageCallBack"> {
+export interface PopsLoadingConfig extends Omit<PopsGeneralConfig, "width" | "height" | "position"> {
     /**
      * 父元素，默认为document.body
      * @default document.body || document.documentElement

package/dist/types/src/components/panel/index.d.ts

@@ -1,5 +1,6 @@
 import { EventEmiter } from "../../event/EventEmiter";
-import type { PopsPanelConfig, PopsPanelEventType } from "./types";
+import type { EventMap } from "../../types/EventEmitter";
+import type { PopsPanelConfig } from "./types";
 export declare const PopsPanel: {
-    init(__config__: PopsPanelConfig): Omit<import("../../types/event").PopsEventConfig<EventEmiter<PopsPanelEventType>>, "function" | "type">;
+    init(__config__: PopsPanelConfig): Omit<import("../../types/event").PopsEventConfig<EventEmiter<EventMap>>, "function" | "type">;
 };

package/dist/types/src/components/rightClickMenu/types/index.d.ts

@@ -60,7 +60,7 @@ export interface PopsRightClickMenuDataConfig {
 /**
  * pops.rightClickMenu
  */
-export interface PopsRightClickMenuConfig extends Pick<PopsGeneralConfig, "useShadowRoot" | "beforeAppendToPageCallBack" | "zIndex" | "style" | "lightStyle" | "darkStyle" | "only"> {
+export interface PopsRightClickMenuConfig extends Pick<PopsGeneralConfig, "useShadowRoot" | "zIndex" | "style" | "lightStyle" | "darkStyle" | "only" | "emitter"> {
     /**
      * 目标元素
      * @default document.documentElement

package/dist/types/src/components/searchSuggestion/types/index.d.ts

@@ -99,7 +99,7 @@ export type PopsSearchSuggestionData<T> = {
  * 搜索建议悬浮窗
  * pops.searchSuggestion
  */
-export interface PopsSearchSuggestionConfig<T = any> extends Pick<PopsGeneralConfig, "useShadowRoot" | "zIndex" | "style" | "lightStyle" | "darkStyle"> {
+export interface PopsSearchSuggestionConfig<T = any> extends Pick<PopsGeneralConfig, "useShadowRoot" | "zIndex" | "style" | "lightStyle" | "darkStyle" | "emitter"> {
     /**
      * 当前的环境，可以是document，可以是shadowroot，默认是document
      *

package/dist/types/src/components/tooltip/index.d.ts

@@ -1,5 +1,6 @@
 import { EventEmiter } from "../../event/EventEmiter";
 import type { EventMap } from "../../types/EventEmitter";
+import type { PopsType } from "../../types/main";
 import type { PopsToolTipConfig } from "./types/index";
 type ToolTipEventTypeName = "MouseEvent" | "TouchEvent";
 export declare class ToolTip {
@@ -213,7 +214,87 @@ export declare const PopsTooltip: {
             style: string | null;
             lightStyle: string | null;
             darkStyle: string | null;
-            beforeAppendToPageCallBack: ($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void;
+            emitter: {
+                type: PopsType;
+                data: {
+                    clear: () => void;
+                    delete: (key: string) => boolean;
+                    forEach: (callbackfn: (value: {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[], key: string, map: Map<string, {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>) => void, thisArg?: any) => void;
+                    get: (key: string) => {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[] | undefined;
+                    has: (key: string) => boolean;
+                    set: (key: string, value: {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]) => Map<string, {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>;
+                    readonly size: number;
+                    entries: () => MapIterator<[string, {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]]>;
+                    keys: () => MapIterator<string>;
+                    values: () => MapIterator<{
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]>;
+                    [Symbol.iterator]: () => MapIterator<[string, {
+                        type: PopsType;
+                        time: number;
+                        callback: (...args: any[]) => IPromise<void>;
+                    }[]]>;
+                    readonly [Symbol.toStringTag]: string;
+                };
+                on: {
+                    <P extends keyof EventMap>(eventName: P, callback: EventMap[P]): {
+                        off: () => IPromise<void>;
+                        emit: (...args: any[]) => IPromise<void>;
+                    };
+                    <P extends string>(eventName: P, callback: (...args: any[]) => IPromise<void>): {
+                        off: () => IPromise<void>;
+                        emit: (...args: any[]) => IPromise<void>;
+                    };
+                };
+                off: {
+                    <P extends keyof EventMap>(eventName: P, callback: EventMap[P]): IPromise<void>;
+                    <P extends string>(eventName: P, callback: (...args: any[]) => IPromise<void>): IPromise<void>;
+                };
+                emit: {
+                    <P extends string>(eventName: P, ...args: any[]): IPromise<void>;
+                    <P extends keyof EventMap>(eventName: P, ...args: Parameters<EventMap[P]>): IPromise<void>;
+                };
+                offAll: {
+                    <P extends keyof EventMap>(eventName?: P | undefined): IPromise<void>;
+                    <P extends string>(eventName?: P | undefined): IPromise<void>;
+                };
+                getAllEvents: (eventName?: string) => {
+                    type: PopsType;
+                    time: number;
+                    callback: (...args: any[]) => IPromise<void>;
+                }[] | {
+                    type: PopsType;
+                    time: number;
+                    callback: (...args: any[]) => IPromise<void>;
+                }[][] | undefined;
+                [Symbol.toStringTag]: string;
+            } | null;
         };
         $shadowContainer: HTMLDivElement;
         $shadowRoot: HTMLElement | ShadowRoot;

package/dist/types/src/components/tooltip/types/index.d.ts

@@ -5,7 +5,7 @@ export type PopsTooltipPosition = "top" | "right" | "bottom" | "left" | "follow"
 /**
  * pops.tooltip
  */
-export interface PopsToolTipConfig extends Pick<PopsGeneralConfig, "useShadowRoot" | "only" | "zIndex" | "style" | "lightStyle" | "darkStyle" | "beforeAppendToPageCallBack"> {
+export interface PopsToolTipConfig extends Pick<PopsGeneralConfig, "useShadowRoot" | "only" | "zIndex" | "style" | "lightStyle" | "darkStyle" | "emitter"> {
     /**
      * 目标元素
      */

package/dist/types/src/config/GlobalConfig.d.ts

@@ -40,7 +40,7 @@ export declare const GlobalConfig: {
         } | Omit<import("../types/position").PopsPosition | undefined, "zIndex"> | undefined;
         animation?: {
             zIndex: GlobalConfigOption["zIndex"];
-        } | Omit<import("../types/animation").PopsAnimation | undefined, "zIndex"> | undefined;
+        } | Omit<false | import("../types/animation").PopsAnimation | undefined, "zIndex"> | undefined;
         mask?: {
             zIndex: GlobalConfigOption["zIndex"];
         } | Omit<import("../types/mask").PopsMaskConfig | undefined, "zIndex"> | undefined;
@@ -56,9 +56,9 @@ export declare const GlobalConfig: {
         stopKeyDownEventPropagation?: {
             zIndex: GlobalConfigOption["zIndex"];
         } | Omit<boolean | undefined, "zIndex"> | undefined;
-        beforeAppendToPageCallBack?: {
+        emitter?: {
             zIndex: GlobalConfigOption["zIndex"];
-        } | Omit<(($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void) | undefined, "zIndex"> | undefined;
+        } | Omit<import("../event/EventEmiter").EventEmiter<import("../types/EventEmitter").CustomEventMap> | null | undefined, "zIndex"> | undefined;
         drag?: {
             zIndex: GlobalConfigOption["zIndex"];
         } | Omit<boolean | undefined, "zIndex"> | undefined;

package/dist/types/src/event/EventEmiter.d.ts

@@ -1,7 +1,13 @@
 import type { EventMap, CustomEventMap } from "../types/EventEmitter";
 import type { PopsType } from "../types/main";
 declare class EventEmiter<T extends CustomEventMap = CustomEventMap> {
-    #private;
+    [Symbol.toStringTag]: string;
+    type: PopsType;
+    data: Map<string, {
+        type: PopsType;
+        time: number;
+        callback: (...args: any[]) => IPromise<void>;
+    }[]>;
     constructor(type: PopsType);
     on<P extends keyof EventMap>(eventName: P, callback: EventMap[P]): {
         off: () => IPromise<void>;

package/dist/types/src/handler/PopsInstHandler.d.ts

@@ -17,7 +17,7 @@ export declare const PopsInstHandler: {
      */
     removeInstance(totalInstConfigList: PopsInstGeneralConfig[][], guid?: string, isAll?: boolean): Promise<PopsInstGeneralConfig[][]>;
     /**
-     * 隐藏
+     * 显示
      * @param popsType
      * @param instConfigList
      * @param guid
@@ -25,9 +25,9 @@ export declare const PopsInstHandler: {
      * @param $anim
      * @param $mask
      */
-    hide(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: PopsInstStoreType, instConfigList: PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
+    show(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: PopsInstStoreType, instConfigList: PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
     /**
-     * 显示
+     * 隐藏
      * @param popsType
      * @param instConfigList
      * @param guid
@@ -35,7 +35,7 @@ export declare const PopsInstHandler: {
      * @param $anim
      * @param $mask
      */
-    show(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: PopsInstStoreType, instConfigList: PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
+    hide(config: PopsAlertConfig | PopsDrawerConfig | PopsPromptConfig | PopsConfirmConfig | PopsIframeConfig | PopsLoadingConfig | PopsPanelConfig | PopsFolderConfig, popsType: PopsInstStoreType, instConfigList: PopsInstGeneralConfig[], guid: string, $anim: HTMLElement, $mask?: HTMLElement): Promise<void>;
     /**
      * 关闭
      * @param popsType

package/dist/types/src/types/EventEmitter.d.ts

@@ -1,12 +1,33 @@
 import type { PopsInstGeneralConfig } from "./inst";
 
 export type EventMap = {
+  /**
+   * 调用`.show`时触发
+   */
   "pops:before-show": (config: PopsInstGeneralConfig) => IPromise<void>;
+  /**
+   * 调用`.show`时触发
+   */
   "pops:show": (config: PopsInstGeneralConfig) => IPromise<void>;
+  /**
+   * 调用`.hide`时触发
+   */
   "pops:before-hide": (config: PopsInstGeneralConfig) => IPromise<void>;
+  /**
+   * 调用`.hide`时触发
+   */
   "pops:hide": (config: PopsInstGeneralConfig) => IPromise<void>;
+  /**
+   * 调用`.close`时触发
+   */
   "pops:before-destory": (config: PopsInstGeneralConfig) => IPromise<void>;
+  /**
+   * 调用`.close`时触发
+   */
   "pops:destory": () => IPromise<void>;
+  /**
+   * 插入到页面中时触发，但是需要传入`EventEmitter`来监听该事件，否则不触发
+   */
   "pops:before-append-to-page": (
     $shadowRoot: ShadowRoot | HTMLElement,
     $shadowContainer: HTMLDivElement

package/dist/types/src/types/PopsDOMUtilsEventType.d.ts

@@ -277,7 +277,7 @@ export declare type PopsDOMUtilsEventListenerOption = AddEventListenerOptions &
   isComposedPath?: boolean;
 };
 
-export type PopsDOMUtilsTargetElementType = HTMLElement | string | NodeList | HTMLElement[];
+export type PopsDOMUtilsTargetElementType = IArray<HTMLElement> | string | NodeList;
 
 /**
  * 属性转驼峰

package/dist/types/src/types/components.d.ts

@@ -2,6 +2,8 @@ import type { PopsAnimation } from "./animation";
 import type { PopsPosition, PopsTextAlign, PopsJustifyContent } from "./position";
 import type { PopsGlobalButtonConfig, PopsButtonConfigAnyType, PopsHeaderCloseButtonConfig } from "./button";
 import type { PopsMaskConfig } from "./mask";
+import type { EventEmiter } from "../event/EventEmiter";
+import type { EventMap } from "./EventEmitter";
 
 /**
  * 标题配置
@@ -139,49 +141,41 @@ export interface PopsDragConfig {
 export interface PopsGeneralConfig {
   /**
    * 是否使用shadowRoot
-   *
    * @default true
    */
   useShadowRoot?: boolean;
   /**
    * 自定义的className
-   *
    * @default ""
    */
   class?: string;
   /**
    * 是否是唯一的
-   *
    * @default false
    */
   only?: boolean;
   /**
    *  宽度
-   *
    * @default "350px"
    */
   width: string;
   /**
    *  高度
-   *
    * @default "200px"
    */
   height: string;
   /**
    * 位置
-   *
    * @default "center"
    */
   position?: PopsPosition;
   /**
    * 动画
-   *
    * @default "pops-anim-fadein-zoom"
    */
-  animation?: PopsAnimation;
+  animation?: PopsAnimation | false;
   /**
    * z-index显示层级
-   *
    * @default 10000
    */
   zIndex?: IFunction<number>;
@@ -193,38 +187,41 @@ export interface PopsGeneralConfig {
    * 是否禁用页面滚动
    *
    * 暂时不会生效
-   *
    * @default false
    */
   forbiddenScroll?: boolean;
   /**
    * （可选）自定义style
-   * @default ""
+   * @default null
    */
   style?: string | null;
   /**
    * （可选）自定义浅色模式的style
    *
-   * 传入的css都在dark内
+   * css都在`@media (prefers-color-scheme: light)`内
+   * @default null
    */
   lightStyle?: string | null;
   /**
    * （可选）自定义深色模式的style
    *
-   * 传入的css都在dark内
+   * css都在`@media (prefers-color-scheme: dark)`内
+   * @default null
    */
   darkStyle?: string | null;
   /**
    * （可选）是否阻止`keydown`事件传播
    *
    * 主要是阻止当`keydown`触发来源为输入框时，即在输入框内按下按键不会触发页面的快捷键
-   * @default true
+   * @default true 阻止
    */
   stopKeyDownEventPropagation?: boolean;
   /**
-   * 在元素添加到页面前的事件
-   * @param $shadowRoot 根元素
-   * @param $shadowContainer 容器
+   * 可传入自定义事件监听器代替内部的eventEmitter
+   *
+   * 一般用于监听内部处理的事件
+   *
+   * 某些事件如：`pops:before-append-to-page`会提前触发，那么就需要自定义的监听器来监听
    */
-  beforeAppendToPageCallBack?: ($shadowRoot: ShadowRoot | HTMLElement, $shadowContainer: HTMLDivElement) => void;
+  emitter?: EventEmiter | null | undefined;
 }

package/dist/types/src/types/global.d.ts

@@ -29,3 +29,5 @@ declare type DeepRequired<T> = T extends any[]
 declare type IPromise<T> = T | Promise<T>;
 
 declare type IFunction<T> = T | (() => T);
+
+declare type IArray<T> = T | T[];

package/dist/types/src/types/mask.d.ts

@@ -16,28 +16,28 @@ export interface PopsMaskConfig {
    */
   enable?: boolean;
   /**
-   * 点击事件
+   * 点击事件配置
    */
   clickEvent?: {
     /**
-     * 点击遮罩层是否触发关闭事件
+     * （可选）点击遮罩层是否触发关闭事件，默认false
      * @default false
      */
     toClose?: boolean;
     /**
-     * 点击遮罩层是否触发隐藏事件
+     * （可选）点击遮罩层是否触发隐藏事件，默认false
      * @default false
      */
     toHide?: boolean;
   };
   /**
    * 遮罩层自定义的点击事件
-   * @param originalRun 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗
-   * @param config 配置信息
    */
   clickCallBack?:
     | ((
-        originalRun: () => void | Promise<void>,
+        /** 当toClose为true，它是关闭弹窗，当toHide为true，它是隐藏弹窗 */
+        continueExec: () => void | Promise<void>,
+        /** 配置信息 */
         config:
           | PopsAlertConfig
           | PopsDrawerConfig

package/dist/types/src/utils/PopsDOMUtils.d.ts

@@ -536,7 +536,7 @@ declare class PopsDOMUtils extends PopsDOMUtilsEvent {
      * @param $el 目标元素
      * @param className className属性
      */
-    addClassName($el: Element | undefined | null | undefined, className: string | string[] | (() => string | string[]) | undefined | null): void;
+    addClassName($el: Element | undefined | null, className: string | string[] | (() => string | string[]) | undefined | null): void;
     /**
      * 删除className
      * @param $el 目标元素
@@ -548,7 +548,7 @@ declare class PopsDOMUtils extends PopsDOMUtilsEvent {
      * @param $el 目标元素
      * @param className className属性
      */
-    containsClassName($el: HTMLElement | undefined | null, className: string): boolean;
+    containsClassName($el: Element | undefined | null, className: string): boolean;
     /**
      * 获取元素的样式属性值
      * @param $el 目标元素