@polyv/vue-components 1.2.1 → 1.3.0

package/vue3/src/components/tooltip/tooltip.vue.d.ts

@@ -7,11 +7,11 @@ declare function __VLS_template(): {
     };
     refs: {
         popperRef: (import('vue/types/v3-component-public-instance').Vue3Instance<{}, Readonly<import('vue').ExtractPropTypes<{
-            trigger: import('vue-types').VueTypeDef<"click" | "hover" | "focus" | "long-press" | "custom"> & {
-                default: "click" | "hover" | "focus" | "long-press" | "custom";
+            trigger: import('vue-types').VueTypeDef<"click" | "focus" | "hover" | "long-press" | "custom"> & {
+                default: "click" | "focus" | "hover" | "long-press" | "custom";
             };
-            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-                default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+                default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
             };
             arrow: import('vue-types').VueTypeValidableDef<boolean, import('vue-types/dist/types').ValidatorFunction<boolean>> & {
                 default: boolean;
@@ -22,11 +22,11 @@ declare function __VLS_template(): {
             };
             beforeShowPopper: import('vue-types').VueTypeValidableDef<BeforeShowPopper, import('vue-types/dist/types').ValidatorFunction<BeforeShowPopper>>;
         }>>, Readonly<import('vue').ExtractPropTypes<{
-            trigger: import('vue-types').VueTypeDef<"click" | "hover" | "focus" | "long-press" | "custom"> & {
-                default: "click" | "hover" | "focus" | "long-press" | "custom";
+            trigger: import('vue-types').VueTypeDef<"click" | "focus" | "hover" | "long-press" | "custom"> & {
+                default: "click" | "focus" | "hover" | "long-press" | "custom";
             };
-            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-                default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+                default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
             };
             arrow: import('vue-types').VueTypeValidableDef<boolean, import('vue-types/dist/types').ValidatorFunction<boolean>> & {
                 default: boolean;
@@ -37,16 +37,16 @@ declare function __VLS_template(): {
             };
             beforeShowPopper: import('vue-types').VueTypeValidableDef<BeforeShowPopper, import('vue-types/dist/types').ValidatorFunction<BeforeShowPopper>>;
         }>>, {}, {
-            trigger: "click" | "hover" | "focus" | "long-press" | "custom";
-            placement: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
-            arrow: boolean;
             disabled: boolean;
+            trigger: "click" | "focus" | "hover" | "long-press" | "custom";
+            arrow: boolean;
+            placement: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
         }, true, import('vue').ComponentOptionsBase<any, any, any, any, any, any, any, any, any, any>> & Readonly<Readonly<import('vue').ExtractPropTypes<{
-            trigger: import('vue-types').VueTypeDef<"click" | "hover" | "focus" | "long-press" | "custom"> & {
-                default: "click" | "hover" | "focus" | "long-press" | "custom";
+            trigger: import('vue-types').VueTypeDef<"click" | "focus" | "hover" | "long-press" | "custom"> & {
+                default: "click" | "focus" | "hover" | "long-press" | "custom";
             };
-            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-                default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+                default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
             };
             arrow: import('vue-types').VueTypeValidableDef<boolean, import('vue-types/dist/types').ValidatorFunction<boolean>> & {
                 default: boolean;
@@ -61,11 +61,11 @@ declare function __VLS_template(): {
             popperRef: import('vue').Ref<any>;
             popperVisible: import('vue').Ref<boolean>;
         }> & import('vue/types/v3-component-options').ExtractComputedReturns<{}> & import('vue').ComponentCustomProperties & Readonly<import('vue').ExtractPropTypes<{
-            trigger: import('vue-types').VueTypeDef<"click" | "hover" | "focus" | "long-press" | "custom"> & {
-                default: "click" | "hover" | "focus" | "long-press" | "custom";
+            trigger: import('vue-types').VueTypeDef<"click" | "focus" | "hover" | "long-press" | "custom"> & {
+                default: "click" | "focus" | "hover" | "long-press" | "custom";
             };
-            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-                default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+            placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+                default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
             };
             arrow: import('vue-types').VueTypeValidableDef<boolean, import('vue-types/dist/types').ValidatorFunction<boolean>> & {
                 default: boolean;
@@ -88,8 +88,8 @@ declare const __VLS_component: import('vue').DefineComponent<{
     content: import('vue-types').VueTypeValidableDef<string, import('vue-types/dist/types').ValidatorFunction<string>> & {
         default: string;
     };
-    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-        default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+        default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
     };
     effect: import('vue-types').VueTypeDef<"light" | "dark" | "auto"> & {
         default: "light" | "dark" | "auto";
@@ -107,8 +107,8 @@ declare const __VLS_component: import('vue').DefineComponent<{
     content: import('vue-types').VueTypeValidableDef<string, import('vue-types/dist/types').ValidatorFunction<string>> & {
         default: string;
     };
-    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-        default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+        default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
     };
     effect: import('vue-types').VueTypeDef<"light" | "dark" | "auto"> & {
         default: "light" | "dark" | "auto";
@@ -123,10 +123,10 @@ declare const __VLS_component: import('vue').DefineComponent<{
         default: boolean;
     };
 }>>, {
-    placement: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
     effect: "light" | "dark" | "auto";
     content: string;
     disabled: boolean;
+    placement: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
     tooltipClass: string;
     onlyTextEllipsis: boolean;
 }>;

package/vue3/src/components/tooltip/use-tooltip.d.ts

@@ -1,3 +1,4 @@
+import { FormatProps } from '../../vue-utils';
 declare const tooltipEffect: readonly ["dark", "light", "auto"];
 export type TooltipEffect = typeof tooltipEffect[number];
 export declare const tooltipProps: () => {
@@ -12,8 +13,8 @@ export declare const tooltipProps: () => {
      * @propType PopperPlacement
      * @default bottom
      */
-    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
-        default: "bottom" | "left" | "right" | "top" | "top-start" | "top-end" | "bottom-start" | "bottom-end" | "left-start" | "left-end" | "right-start" | "right-end";
+    placement: import('vue-types').VueTypeDef<"bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end"> & {
+        default: "bottom" | "left" | "right" | "top" | "bottom-start" | "bottom-end" | "top-start" | "top-end" | "left-start" | "left-end" | "right-start" | "right-end";
     };
     /**
      * 弹层主题
@@ -43,4 +44,5 @@ export declare const tooltipProps: () => {
         default: boolean;
     };
 };
+export type TooltipOptions = FormatProps<typeof tooltipProps>;
 export {};

package/vue3/src/hooks/animation/use-special-effect/index.d.ts

@@ -1,10 +1,21 @@
 import { Ref } from 'vue';
 import { PlayAnimationOptions } from '../types';
+import { MaybeResponsive } from '../../../vue-utils';
 export interface UseSpecialEffectOptions {
     /**
      * 容器节点
      */
     wrapRef?: Ref<HTMLDivElement | undefined>;
+    /**
+     * 最大数量
+     * @default 200
+     */
+    maxCount?: number;
+    /**
+     * 是否禁用动画
+     * @default false
+     */
+    disabled?: MaybeResponsive<boolean>;
 }
 export interface AnimationQueueItem {
     url: string;
@@ -19,12 +30,20 @@ export interface PushAnimationQueueOptions {
      * @default false
      */
     inHeader?: boolean;
+    /**
+     * 强制插入，不受 maxCount 限制
+     * @default false
+     */
+    forceInsert?: boolean;
     /**
      * 是否过滤重复的动画
      * @default false
      */
     filterRepeat?: boolean;
 }
+/**
+ * 特殊播放器
+ */
 export declare const useSpecialEffect: (options?: UseSpecialEffectOptions) => {
     wrapRef: Ref<HTMLDivElement | undefined>;
     animationQueue: Ref<{

package/vue3/src/hooks/business/use-app-unique-id/index.d.ts

@@ -0,0 +1,12 @@
+declare module '../use-config-provider' {
+    interface ConfigProviderInjectData {
+        /**
+         * 应用唯一 id
+         */
+        appUniqueId?: string;
+    }
+}
+export declare function useAppUniqueId(): {
+    defaultAppUniqueId: string;
+    appUniqueId: string;
+};

package/vue3/src/hooks/business/use-config-provider/index.d.ts

@@ -1,23 +1,5 @@
-import { PwcEventEmitter } from '../../tools/use-event-bus';
-import { I18nLangs } from '../../../lang/types';
 import { InjectionKey } from 'vue';
-import { SkinColorConfig } from '../use-skin-color';
-import { TrackEventData } from '../use-track-event';
 export interface ConfigProviderInjectData {
-    /** 当前语言 */
-    globalLang?: I18nLangs | (() => I18nLangs);
-    /** 是否网页 css 全屏 */
-    pageFullscreen?: boolean | (() => boolean);
-    /** 全屏元素 */
-    fullscreenElement?: string | Element;
-    /** 获取事件订阅器 */
-    getEmitter?: () => PwcEventEmitter;
-    /** 埋点回调 */
-    trackEventCallback?: (data: TrackEventData) => unknown;
-    /**
-     * 皮肤颜色配置
-     */
-    getSkinColorConfig?: () => SkinColorConfig;
 }
 export interface ConfigProviderOptions {
     /**

package/vue3/src/hooks/business/use-nickname/index.d.ts

@@ -0,0 +1,3 @@
+export declare function useNickname(): {
+    translateNick: (nick: string) => string;
+};

package/vue3/src/hooks/business/use-page-fullscreen/index.d.ts

@@ -0,0 +1,14 @@
+declare module '../use-config-provider' {
+    interface ConfigProviderInjectData {
+        /**
+         * 是否网页 css 全屏
+         */
+        pageFullscreen?: boolean | (() => boolean);
+    }
+}
+/**
+ * 网页 css 全屏
+ */
+export declare const usePageFullscreen: () => {
+    pageFullscreen: import('vue').ComputedRef<boolean>;
+};

package/vue3/src/hooks/business/use-resize-oss-image/index.d.ts

@@ -1,5 +1,6 @@
+import { IOSSCompressOptions } from '@polyv/utils/es/image';
 export declare const useResizeOssImage: () => {
     appendToOssProcess: (url: string, additionalParams: string) => string;
-    resizeOSSImg: (url: string, width?: number, height?: number) => string;
+    resizeOSSImg: (url: string, options?: IOSSCompressOptions | number) => string;
     resizeHtmlContentImg: (htmlContent: string, width?: number) => string;
 };

package/vue3/src/hooks/business/use-server/index.d.ts

@@ -1,4 +1,4 @@
-export declare function useServer<T extends (...args: any[]) => unknown>(fn: T, value: ReturnType<T>): ReturnType<T>;
-export declare function useServer<T extends (...args: any[]) => unknown>(fn: T): ReturnType<T> | undefined;
-export declare function useClient<T extends (...args: any[]) => unknown>(fn: T, value: ReturnType<T>): ReturnType<T>;
-export declare function useClient<T extends (...args: any[]) => unknown>(fn: T): ReturnType<T> | undefined;
+export declare function useOnlyServer<T extends (...args: any[]) => unknown>(fn: T, value: ReturnType<T>): ReturnType<T>;
+export declare function useOnlyServer<T extends (...args: any[]) => unknown>(fn: T): ReturnType<T> | undefined;
+export declare function useOnlyClient<T extends (...args: any[]) => unknown>(fn: T, value: ReturnType<T>): ReturnType<T>;
+export declare function useOnlyClient<T extends (...args: any[]) => unknown>(fn: T): ReturnType<T> | undefined;

package/vue3/src/hooks/business/use-short-number/index.d.ts

@@ -0,0 +1,3 @@
+export declare const useShortNumber: () => {
+    shortNumber: (num: number) => string;
+};

package/vue3/src/hooks/business/use-skin-color/index.d.ts

@@ -1,5 +1,13 @@
 import { ConfigProviderInjectData } from '../use-config-provider';
 import { VueProps } from '../../../vue-utils';
+declare module '../use-config-provider' {
+    interface ConfigProviderInjectData {
+        /**
+         * 皮肤颜色配置
+         */
+        getSkinColorConfig?: () => SkinColorConfig;
+    }
+}
 /**
  * 皮肤颜色模式
  */
@@ -32,7 +40,10 @@ export declare const useSkinColorConfig: (_configProviderData?: ConfigProviderIn
 };
 export declare const useSkinColorRoot: (_configProviderData?: ConfigProviderInjectData) => void;
 export declare const skinColorIgnoreProps: () => {
-    /** 是否忽略皮肤颜色 */
+    /**
+     * 是否忽略皮肤颜色
+     * @default true
+     */
     ignoreSkinColor: import('vue-types').VueTypeValidableDef<boolean, import('vue-types/dist/types').ValidatorFunction<boolean>> & {
         default: boolean;
     };

package/vue3/src/hooks/business/use-track-event/index.d.ts

@@ -1,3 +1,11 @@
+declare module '../use-config-provider' {
+    interface ConfigProviderInjectData {
+        /**
+         * 埋点回调
+         */
+        trackEventCallback?: (data: TrackEventData) => unknown;
+    }
+}
 /**
  * 埋点数据
  */

package/vue3/src/hooks/components/use-auto-topmost/index.d.ts

@@ -1,14 +1,27 @@
-import { ResponsiveElement } from '../../../vue-utils';
+import { MaybeResponsive, ResponsiveElement } from '../../../vue-utils';
 import { Ref } from 'vue';
 export interface UseAutoTopmostOptions {
-    /** 置顶事件 */
+    /**
+     * 显示响应式
+     */
+    visible?: MaybeResponsive<boolean>;
+    /**
+     * 置顶事件
+     */
     topmostEvent?: string;
 }
+export interface UseAutoTopmostReturn {
+    /**
+     * 当前层叠数
+     */
+    currentZIndex: Ref<number | undefined>;
+    /**
+     * 置顶元素
+     */
+    topmostElem: () => Promise<void>;
+}
 /**
  * 设置根据显隐状态自动将节点层叠数置顶
- * @param visibleRef 显隐响应式
  * @param elemRef 弹出层节点响应式
  */
-export declare const useAutoTopmost: (visibleRef: Ref<boolean>, elemRef: ResponsiveElement, options?: UseAutoTopmostOptions) => {
-    topmostElem: () => Promise<void>;
-};
+export declare const useAutoTopmost: (elemRef: ResponsiveElement, options?: UseAutoTopmostOptions) => UseAutoTopmostReturn;

package/vue3/src/hooks/components/use-popper/_hooks/common.d.ts

@@ -0,0 +1,4 @@
+import { MaybeResponsive } from '../../../../vue-utils';
+import { ComputedRef, Ref } from 'vue';
+export declare function formatOptionRef<T>(target: T | Ref<T>): Ref<T>;
+export declare function formatOptionComputed<T>(target: MaybeResponsive<T>): ComputedRef<T>;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-append.d.ts

@@ -0,0 +1,2 @@
+import { PopperResult, UsePopperOptions } from '../_popper-type';
+export declare const usePopperAppend: (popperResult: PopperResult, hookOptions: UsePopperOptions) => void;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-arrow.d.ts

@@ -1,2 +1,2 @@
-import { PopperOptions } from '../_popper-type';
-export declare const usePopperArrow: (popperOptions: PopperOptions) => void;
+import { PopperResult, UsePopperOptions } from '../_popper-type';
+export declare const usePopperArrow: (popperResult: PopperResult, hookOptions: UsePopperOptions) => void;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-core.d.ts

@@ -1,13 +1,13 @@
-import { Instance as PopperInstance, OptionsGeneric, Modifier } from '@popperjs/core';
-import { PopperOptions } from '../_popper-type';
+import { Modifier, OptionsGeneric, Instance as PopperInstance } from '@popperjs/core';
+import { PopperResult, UsePopperOptions } from '../_popper-type';
 /**
  * 构建 popperjs 的配置
  */
-export declare const usePopperCoreOptions: (popperOptions: PopperOptions, getPopperCtx: () => PopperInstance | undefined) => {
+export declare const usePopperCoreOptions: (popperResult: PopperResult, hookOptions: UsePopperOptions, getPopperCtx: () => PopperInstance | undefined) => {
     /** 弹层选项 */
     popperCoreOptions: import('vue').ComputedRef<OptionsGeneric<Modifier<unknown, unknown>>>;
 };
-export declare const usePopperCore: (popperOptions: PopperOptions) => {
+export declare const usePopperCore: (popperResult: PopperResult, hookOptions: UsePopperOptions) => {
     getPopperCtx: () => PopperInstance | undefined;
     updatePopper: () => Promise<void>;
     createPopperCore: () => void;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-element.d.ts

@@ -0,0 +1,7 @@
+import { PopperElements, UsePopperOptions } from '../_popper-type';
+export declare const usePopperElement: (hookOptions: UsePopperOptions) => {
+    referenceRef: import('vue').Ref<HTMLElement | undefined>;
+    popperRef: import('vue').Ref<HTMLElement | undefined>;
+    inputRef: import('vue').Ref<HTMLInputElement | undefined>;
+    getElement: () => PopperElements;
+};

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-interactive.d.ts

@@ -1,5 +1,5 @@
-import { PopperOptions } from '../_popper-type';
+import { PopperResult, UsePopperOptions } from '../_popper-type';
 /**
  * 弹层交互方式 hook
  */
-export declare const usePopperInteractive: (popperOptions: PopperOptions) => void;
+export declare const usePopperInteractive: (popperResult: PopperResult, hookOptions: UsePopperOptions) => void;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-size.d.ts

@@ -0,0 +1,2 @@
+import { PopperResult, UsePopperOptions } from '../_popper-type';
+export declare const usePopperSize: (popperResult: PopperResult, hookOptions: UsePopperOptions) => void;

package/vue3/src/hooks/components/use-popper/_hooks/use-popper-visible.d.ts

@@ -1,2 +1,2 @@
 import { PopperVisibleResult, UsePopperOptions } from '../_popper-type';
-export declare const usePopperVisible: (options?: UsePopperOptions) => PopperVisibleResult;
+export declare const usePopperVisible: (hookOptions?: UsePopperOptions) => PopperVisibleResult;

package/vue3/src/hooks/components/use-popper/_popper-type.d.ts

@@ -1,5 +1,5 @@
-import { ResponsiveRef } from '../../../vue-utils';
-import { Ref } from 'vue';
+import { MaybeRef, MaybeResponsive, ResponsiveElement } from '../../../vue-utils';
+import { ComputedRef, Ref } from 'vue';
 export type PopperOffset = [number, number];
 /** 弹层位置 */
 export declare const popperPlacements: readonly ["top", "bottom", "left", "right", "top-start", "top-end", "bottom-start", "bottom-end", "left-start", "left-end", "right-start", "right-end"];
@@ -15,77 +15,127 @@ export interface PopperArrowOptions {
 }
 export type BeforeShowPopper = () => boolean;
 export interface UsePopperOptions {
+    /**
+     * 弹层显示状态
+     * @default false
+     */
     popperVisible?: boolean | Ref<boolean>;
     /**
      * 显示弹层前回调
-     * @returns 是否显示弹层
+     * @returns 返回 false 会阻止弹层显示
      */
     beforeShowPopper?: BeforeShowPopper;
-    /** 触发节点 ref */
-    referenceRef?: HTMLElement | Ref<HTMLElement | undefined>;
-    /** 弹层节点 ref */
-    popperRef?: HTMLElement | Ref<HTMLElement | undefined>;
-    /** 输入框节点 ref，用于聚焦显示的交互 */
-    inputRef?: HTMLInputElement | Ref<HTMLInputElement | undefined>;
-    /** 弹层是否禁用 */
-    popperDisabled?: boolean | ResponsiveRef<boolean>;
-    /** 触发方式 */
-    trigger?: PopperTrigger | Ref<PopperTrigger>;
+    /**
+     * 触发节点
+     */
+    referenceRef?: MaybeRef<HTMLElement | undefined>;
+    /**
+     * 弹层节点
+     */
+    popperRef?: MaybeRef<HTMLElement | undefined>;
+    /**
+     * 输入框节点，用于聚焦显示的交互
+     */
+    inputRef?: MaybeRef<HTMLInputElement | undefined>;
+    /**
+     * 弹层是否禁用
+     * @default false
+     */
+    popperDisabled?: MaybeResponsive<boolean>;
+    /**
+     * 触发方式
+     * @default 'click'
+     */
+    trigger?: MaybeResponsive<PopperTrigger>;
     /**
      * 鼠标移入延迟显示时间
      * @default 100
      */
-    mouseEnterDelay?: number | Ref<number>;
+    hoverEnterDelay?: MaybeResponsive<number>;
     /**
      * 鼠标移出延迟隐藏时间
      * @default 100
      */
-    mouseLeaveDelay?: number | Ref<number>;
-    /** 弹层位置 */
-    placement?: PopperPlacement | Ref<PopperPlacement>;
-    /** 弹层偏移量 */
-    popperOffset?: PopperOffset | Ref<PopperOffset>;
-    /** 是否显示箭头，默认：false */
-    arrow?: boolean | PopperArrowOptions | Ref<boolean | PopperArrowOptions>;
-    /** 强制 outSideClick 关闭，默认：false */
-    forceOutSideClickHide?: boolean | Ref<boolean>;
-    /** outSideClick 关闭时是否延迟，默认：false */
-    outSideClickDelayHide?: boolean | Ref<boolean>;
-    /** 弹层宽度跟随触发节点，默认：false */
-    followReferenceWidth?: boolean | Ref<boolean>;
-    /** 是否插入到 body 中，默认：true */
-    appendToBody?: boolean;
-    /** 渲染到某个元素中(Dom节点选择器) */
-    mountEl?: string;
-    /** 强制 zIndex，默认 null */
-    forceZIndex?: number | null;
+    hoverLeaveDelay?: MaybeResponsive<number>;
+    /**
+     * 弹层位置
+     * @default 'bottom'
+     */
+    placement?: MaybeResponsive<PopperPlacement>;
+    /**
+     * 弹层偏移量
+     * @default 0
+     */
+    popperOffset?: MaybeResponsive<PopperOffset>;
+    /**
+     * 是否显示箭头
+     * @default false
+     */
+    arrow?: MaybeResponsive<boolean | PopperArrowOptions>;
+    /**
+     * 弹层宽度跟随触发节点
+     * @default false
+     */
+    followReferenceWidth?: MaybeResponsive<boolean>;
+    /**
+     * 渲染到某个元素中，传入 `false` 表示不会处理弹层元素
+     */
+    appendTo?: ResponsiveElement | boolean;
 }
 export interface PopperVisibleResult {
-    /** 弹层显示状态 */
+    /**
+     * 弹层显示状态
+     */
     popperVisible: Ref<boolean>;
-    /** 显示弹层 */
+    /**
+     * 弹层是否禁用
+     */
+    popperDisabled: ComputedRef<boolean>;
+    /**
+     * 显示弹层
+     */
     showPopper: () => void;
-    /** 隐藏弹窗 */
+    /**
+     * 隐藏弹窗
+     */
     hidePopper: () => void;
-    /** 切换弹层显示状态 */
+    /**
+     * 切换弹层显示状态
+     */
     togglePopper: () => void;
-    /** 延迟显示弹层 */
+    /**
+     * 延迟显示弹层
+     */
     delayShowPopper: (delay?: number) => void;
-    /** 延迟隐藏弹层 */
+    /**
+     * 延迟隐藏弹层
+     */
     delayHidePopper: (delay?: number) => void;
 }
+export interface PopperElementResult {
+    /**
+     * 触发节点
+     */
+    referenceRef: Ref<HTMLElement | undefined>;
+    /**
+     * 弹层节点
+     */
+    popperRef: Ref<HTMLElement | undefined>;
+    /**
+     * 输入框节点
+     */
+    inputRef: Ref<HTMLInputElement | undefined>;
+    /**
+     * 获取节点信息
+     */
+    getElement: () => PopperElements;
+}
 export interface PopperElements {
     referenceElem: Element | undefined;
     popperElem: Element | undefined;
-    inputElem: Element | undefined;
+    inputElem: HTMLInputElement | undefined;
 }
-export interface OnPopperEventParams {
-    /** 触发节点是否已隐藏 */
-    isReferenceHidden: boolean;
+export interface PopperResult extends PopperElementResult, PopperVisibleResult {
 }
-export interface PopperOptions extends Required<Omit<UsePopperOptions, 'popperVisible' | 'beforeShowPopper'>>, PopperVisibleResult {
-    /** 获取相关 dom 节点 */
-    getElement: () => PopperElements;
-    /** 处理弹层事件 */
-    onPopperEvent: (params: OnPopperEventParams) => void;
+export interface UsePopperReturn extends PopperResult {
 }

package/vue3/src/hooks/components/use-popper/index.d.ts

@@ -1,32 +1,6 @@
-import { OnPopperEventParams, PopperOffset, UsePopperOptions } from './_popper-type';
+import { UsePopperOptions, UsePopperReturn } from './_popper-type';
 export * from './_popper-type';
 /**
  * 弹出层 hook
  */
-export declare const usePopper: (options?: UsePopperOptions) => {
-    updatePopper: () => Promise<void>;
-    getElement: () => import('./_popper-type').PopperElements;
-    onPopperEvent: (params: OnPopperEventParams) => void;
-    referenceRef: HTMLElement | import('vue').Ref<HTMLElement | undefined>;
-    popperRef: HTMLElement | import('vue').Ref<HTMLElement | undefined>;
-    inputRef: HTMLInputElement | import('vue').Ref<HTMLInputElement | undefined>;
-    popperDisabled: boolean | import('../../../vue-utils').ResponsiveRef<boolean>;
-    trigger: import('./_popper-type').PopperTrigger | import('vue').Ref<import('./_popper-type').PopperTrigger>;
-    mouseEnterDelay: number | import('vue').Ref<number>;
-    mouseLeaveDelay: number | import('vue').Ref<number>;
-    placement: import('./_popper-type').PopperPlacement | import('vue').Ref<import('./_popper-type').PopperPlacement>;
-    popperOffset: PopperOffset | import('vue').Ref<PopperOffset>;
-    arrow: boolean | import('./_popper-type').PopperArrowOptions | import('vue').Ref<boolean | import('./_popper-type').PopperArrowOptions>;
-    forceOutSideClickHide: boolean | import('vue').Ref<boolean>;
-    outSideClickDelayHide: boolean | import('vue').Ref<boolean>;
-    followReferenceWidth: boolean | import('vue').Ref<boolean>;
-    appendToBody: boolean;
-    mountEl: string;
-    forceZIndex: number | null;
-    popperVisible: import('vue').Ref<boolean>;
-    showPopper: () => void;
-    hidePopper: () => void;
-    togglePopper: () => void;
-    delayShowPopper: (delay?: number) => void;
-    delayHidePopper: (delay?: number) => void;
-};
+export declare const usePopper: (options?: UsePopperOptions) => UsePopperReturn;

package/vue3/src/hooks/element/use-append-to/index.d.ts

@@ -0,0 +1,7 @@
+import { ResponsiveElement } from '../../../vue-utils';
+/**
+ * 将节点插入到某个容器中
+ * @param elemRef 对应的节点
+ * @param parentRef 父节点
+ */
+export declare function useAppendTo(elemRef: ResponsiveElement, parentRef?: ResponsiveElement): void;