@polyv/vue-components 1.5.0 → 1.5.1

package/vue2/src/hooks/animation/types/common.d.ts

@@ -14,7 +14,7 @@ export interface AnimationImplement {
     /**
      * 播放一次动画
      */
-    playSingleAnimation: () => Promise<void>;
+    playSingleAnimation: (options?: PlayAnimationOptions) => Promise<void>;
 }
 export declare const useCommonAnimation: (hookOptions: AnimationControllerOptions, implement: AnimationImplement) => {
     wrapRef: import('vue').Ref<HTMLDivElement | undefined>;

package/vue2/src/hooks/animation/types/index.d.ts

@@ -26,6 +26,11 @@ export interface PlayAnimationOptions extends AnimationCallback {
      * 循环间隔时间
      */
     loopTimeInterval?: number;
+    /**
+     * 是否强制刷新图片资源（添加时间戳参数避免缓存）
+     * @default false
+     */
+    forceRefresh?: boolean;
 }
 export interface AnimationControllerOptions extends AnimationCallback {
     /**

package/vue2/src/hooks/animation/use-gif-handler/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 判断是否为 GIF 图片 URL
+ * 使用正则表达式匹配 .gif 扩展名（可包含查询参数）
+ */
+export declare function isGifUrl(url: string): boolean;
+export interface UseGifHandlerOptions {
+    /** 最大缓存数量，默认20 */
+    maxCacheSize?: number;
+}
+export interface GifHandler {
+    /** 判断URL是否为GIF图片 */
+    isGifUrl: (url: string) => boolean;
+    /** 获取GIF动画时长（毫秒） */
+    getGifDuration: (url: string, defaultDuration?: number) => Promise<number>;
+    /** 获取GIF图片的object URL（用于播放） */
+    getGifObjectUrl: (url: string) => Promise<string | null>;
+    /** 回收GIF object URL */
+    revokeGifUrl: (url: string) => void;
+    /** 清理所有资源 */
+    cleanupGifCache: () => void;
+}
+/**
+ * GIF图片处理hook
+ * 负责GIF图片的检测、时长解析、blob缓存和object URL管理
+ */
+export declare const useGifHandler: (options?: UseGifHandlerOptions) => GifHandler;

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

@@ -18,13 +18,17 @@ export interface UseSpecialEffectOptions {
     disabled?: MaybeResponsive<boolean>;
 }
 export interface AnimationQueueItem {
-    url: string;
-}
-export interface PushAnimationQueueOptions {
     /**
      * 动画文件地址
      */
     url: string;
+    /**
+     * 是否强制刷新图片资源（添加时间戳参数避免缓存）
+     * @default false
+     */
+    forceRefresh?: boolean;
+}
+export interface PushAnimationQueueOptions extends AnimationQueueItem {
     /**
      * 是否从头部插入
      * @default false
@@ -42,12 +46,13 @@ export interface PushAnimationQueueOptions {
     filterRepeat?: boolean;
 }
 /**
- * 特殊播放器
+ * 特效播放器
  */
 export declare const useSpecialEffect: (options?: UseSpecialEffectOptions) => {
     wrapRef: Ref<HTMLDivElement | undefined>;
     animationQueue: Ref<{
         url: string;
+        forceRefresh?: boolean | undefined;
     }[]>;
     currentAnimationItem: Ref<AnimationQueueItem | undefined>;
     pushAnimationQueue: (options: PushAnimationQueueOptions) => void;

package/vue2/src/hooks/exports.d.ts

@@ -1,3 +1,4 @@
+export * from './animation/use-gif-handler';
 export * from './animation/use-image-animation';
 export * from './animation/use-special-effect';
 export * from './animation/use-svga-animation';