react-native-puff-pop 1.0.1 → 1.0.3

package/LICENSE

@@ -20,3 +20,4 @@ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 
+

package/README.md

@@ -133,6 +133,25 @@ function App() {
 }
 ```
 
+### Loop Animation
+
+```tsx
+// Loop infinitely
+<PuffPop effect="rotate" loop={true}>
+  <LoadingSpinner />
+</PuffPop>
+
+// Loop 3 times
+<PuffPop effect="bounce" loop={3}>
+  <NotificationBadge />
+</PuffPop>
+
+// Loop with delay between iterations
+<PuffPop effect="scale" loop={true} loopDelay={500}>
+  <PulsingDot />
+</PuffPop>
+```
+
 ## Props
 
 | Prop | Type | Default | Description |
@@ -147,6 +166,8 @@ function App() {
 | `animateOnMount` | `boolean` | `true` | Animate when component mounts |
 | `onAnimationComplete` | `() => void` | - | Callback when animation completes |
 | `style` | `ViewStyle` | - | Custom container style |
+| `loop` | `boolean \| number` | `false` | Loop animation (true=infinite, number=times) |
+| `loopDelay` | `number` | `0` | Delay between loop iterations in ms |
 
 ### Animation Effects (`PuffPopEffect`)
 

package/lib/module/index.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useRef, useState, useCallback, } from 'react';
+import { useEffect, useRef, useState, useCallback, useMemo, } from 'react';
 import { View, Animated, StyleSheet, Easing, } from 'react-native';
 /**
  * Get easing function based on type
@@ -25,7 +25,7 @@ function getEasing(type) {
 /**
  * PuffPop - Animate children with beautiful entrance effects
  */
-export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0, easing = 'easeOut', skeleton = true, visible = true, onAnimationComplete, style, animateOnMount = true, }) {
+export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0, easing = 'easeOut', skeleton = true, visible = true, onAnimationComplete, style, animateOnMount = true, loop = false, loopDelay = 0, }) {
     // Animation values
     const opacity = useRef(new Animated.Value(animateOnMount ? 0 : 1)).current;
     const scale = useRef(new Animated.Value(animateOnMount ? getInitialScale(effect) : 1)).current;
@@ -36,6 +36,26 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
     const [measuredHeight, setMeasuredHeight] = useState(null);
     const animatedHeight = useRef(new Animated.Value(0)).current;
     const hasAnimated = useRef(false);
+    const loopAnimationRef = useRef(null);
+    const loopTimeoutRef = useRef(null);
+    // Memoize effect type checks to avoid repeated includes() calls
+    const effectFlags = useMemo(() => ({
+        hasScale: ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect),
+        hasRotate: ['rotate', 'rotateScale'].includes(effect),
+        hasFlip: effect === 'flip',
+        hasTranslateX: ['slideLeft', 'slideRight'].includes(effect),
+        hasTranslateY: ['slideUp', 'slideDown', 'bounce'].includes(effect),
+        hasRotateEffect: ['rotate', 'rotateScale', 'flip'].includes(effect),
+    }), [effect]);
+    // Memoize interpolations to avoid recreating on every render
+    const rotateInterpolation = useMemo(() => rotate.interpolate({
+        inputRange: [-360, 0, 360],
+        outputRange: ['-360deg', '0deg', '360deg'],
+    }), [rotate]);
+    const flipInterpolation = useMemo(() => rotate.interpolate({
+        inputRange: [-180, 0],
+        outputRange: ['-180deg', '0deg'],
+    }), [rotate]);
     // Handle layout measurement for non-skeleton mode
     const onLayout = useCallback((event) => {
         if (!skeleton && measuredHeight === null) {
@@ -61,7 +81,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             ...config,
         }));
         // Scale animation
-        if (['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect)) {
+        if (effectFlags.hasScale) {
             const targetScale = toVisible ? 1 : getInitialScale(effect);
             animations.push(Animated.timing(scale, {
                 toValue: targetScale,
@@ -70,7 +90,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             }));
         }
         // Rotate animation
-        if (['rotate', 'rotateScale', 'flip'].includes(effect)) {
+        if (effectFlags.hasRotate || effectFlags.hasFlip) {
             const targetRotate = toVisible ? 0 : getInitialRotate(effect);
             animations.push(Animated.timing(rotate, {
                 toValue: targetRotate,
@@ -78,7 +98,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             }));
         }
         // TranslateX animation
-        if (['slideLeft', 'slideRight'].includes(effect)) {
+        if (effectFlags.hasTranslateX) {
             const targetX = toVisible ? 0 : getInitialTranslateX(effect);
             animations.push(Animated.timing(translateX, {
                 toValue: targetX,
@@ -86,7 +106,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             }));
         }
         // TranslateY animation
-        if (['slideUp', 'slideDown', 'bounce'].includes(effect)) {
+        if (effectFlags.hasTranslateY) {
             const targetY = toVisible ? 0 : getInitialTranslateY(effect);
             animations.push(Animated.timing(translateY, {
                 toValue: targetY,
@@ -105,18 +125,70 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
         }
         // Run animations with delay
         const parallelAnimation = Animated.parallel(animations);
+        // Reset values function for looping
+        const resetValues = () => {
+            opacity.setValue(0);
+            scale.setValue(getInitialScale(effect));
+            rotate.setValue(getInitialRotate(effect));
+            translateX.setValue(getInitialTranslateX(effect));
+            translateY.setValue(getInitialTranslateY(effect));
+            if (!skeleton && measuredHeight !== null) {
+                animatedHeight.setValue(0);
+            }
+        };
+        // Build the animation sequence
+        let animation;
         if (delay > 0) {
-            Animated.sequence([
+            animation = Animated.sequence([
                 Animated.delay(delay),
                 parallelAnimation,
-            ]).start(() => {
-                if (toVisible && onAnimationComplete) {
-                    onAnimationComplete();
-                }
-            });
+            ]);
         }
         else {
-            parallelAnimation.start(() => {
+            animation = parallelAnimation;
+        }
+        // Handle loop option
+        if (toVisible && loop) {
+            // Stop any existing loop animation
+            if (loopAnimationRef.current) {
+                loopAnimationRef.current.stop();
+            }
+            const loopCount = typeof loop === 'number' ? loop : -1;
+            let currentIteration = 0;
+            const runLoop = () => {
+                resetValues();
+                animation.start(({ finished }) => {
+                    if (finished) {
+                        currentIteration++;
+                        if (loopCount === -1 || currentIteration < loopCount) {
+                            // Add delay between loops if specified
+                            if (loopDelay > 0) {
+                                // Clear any existing timeout before setting a new one
+                                if (loopTimeoutRef.current) {
+                                    clearTimeout(loopTimeoutRef.current);
+                                }
+                                loopTimeoutRef.current = setTimeout(runLoop, loopDelay);
+                            }
+                            else {
+                                runLoop();
+                            }
+                        }
+                        else if (onAnimationComplete) {
+                            onAnimationComplete();
+                        }
+                    }
+                });
+            };
+            // Store reference and start
+            runLoop();
+        }
+        else {
+            // Stop any existing loop animation
+            if (loopAnimationRef.current) {
+                loopAnimationRef.current.stop();
+                loopAnimationRef.current = null;
+            }
+            animation.start(() => {
                 if (toVisible && onAnimationComplete) {
                     onAnimationComplete();
                 }
@@ -127,6 +199,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
         duration,
         easing,
         effect,
+        effectFlags,
         measuredHeight,
         onAnimationComplete,
         opacity,
@@ -136,6 +209,8 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
         translateX,
         translateY,
         animatedHeight,
+        loop,
+        loopDelay,
     ]);
     // Handle initial mount animation
     useEffect(() => {
@@ -150,36 +225,30 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             animate(visible);
         }
     }, [visible, animate]);
-    // For non-skeleton mode, measure first
-    if (!skeleton && measuredHeight === null) {
-        return (_jsx(View, { style: styles.measureContainer, onLayout: onLayout, children: _jsx(View, { style: styles.hidden, children: children }) }));
-    }
-    // Build transform based on effect
-    const getTransform = () => {
-        const hasScale = ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect);
-        const hasRotate = ['rotate', 'rotateScale'].includes(effect);
-        const hasFlip = effect === 'flip';
-        const hasTranslateX = ['slideLeft', 'slideRight'].includes(effect);
-        const hasTranslateY = ['slideUp', 'slideDown', 'bounce'].includes(effect);
+    // Cleanup loop animation and timeout on unmount
+    useEffect(() => {
+        return () => {
+            if (loopAnimationRef.current) {
+                loopAnimationRef.current.stop();
+            }
+            if (loopTimeoutRef.current) {
+                clearTimeout(loopTimeoutRef.current);
+            }
+        };
+    }, []);
+    // Memoize transform array to avoid recreating on every render
+    // IMPORTANT: All hooks must be called before any conditional returns
+    const transform = useMemo(() => {
+        const { hasScale, hasRotate, hasFlip, hasTranslateX, hasTranslateY } = effectFlags;
         const transforms = [];
         if (hasScale) {
             transforms.push({ scale });
         }
         if (hasRotate) {
-            transforms.push({
-                rotate: rotate.interpolate({
-                    inputRange: [-360, 0, 360],
-                    outputRange: ['-360deg', '0deg', '360deg'],
-                }),
-            });
+            transforms.push({ rotate: rotateInterpolation });
         }
         if (hasFlip) {
-            transforms.push({
-                rotateY: rotate.interpolate({
-                    inputRange: [-180, 0],
-                    outputRange: ['-180deg', '0deg'],
-                }),
-            });
+            transforms.push({ rotateY: flipInterpolation });
         }
         if (hasTranslateX) {
             transforms.push({ translateX });
@@ -188,15 +257,26 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             transforms.push({ translateY });
         }
         return transforms.length > 0 ? transforms : undefined;
-    };
-    const animatedStyle = {
+    }, [effectFlags, scale, rotateInterpolation, flipInterpolation, translateX, translateY]);
+    // Memoize animated style
+    const animatedStyle = useMemo(() => ({
         opacity,
-        transform: getTransform(),
-    };
-    // Container style for non-skeleton mode
-    const containerAnimatedStyle = !skeleton && measuredHeight !== null
-        ? { height: animatedHeight, overflow: 'hidden' }
-        : {};
+        transform,
+    }), [opacity, transform]);
+    // Memoize container style for non-skeleton mode
+    const containerAnimatedStyle = useMemo(() => {
+        if (!skeleton && measuredHeight !== null) {
+            return {
+                height: animatedHeight,
+                overflow: effectFlags.hasRotateEffect ? 'visible' : 'hidden'
+            };
+        }
+        return {};
+    }, [skeleton, measuredHeight, animatedHeight, effectFlags.hasRotateEffect]);
+    // For non-skeleton mode, measure first (after all hooks)
+    if (!skeleton && measuredHeight === null) {
+        return (_jsx(View, { style: styles.measureContainer, onLayout: onLayout, children: _jsx(View, { style: styles.hidden, children: children }) }));
+    }
     return (_jsx(Animated.View, { style: [styles.container, style, containerAnimatedStyle], children: _jsx(Animated.View, { style: animatedStyle, children: children }) }));
 }
 /**

package/lib/typescript/src/index.d.ts

@@ -57,9 +57,21 @@ export interface PuffPopProps {
      * @default true
      */
     animateOnMount?: boolean;
+    /**
+     * Loop the animation
+     * - true: loop infinitely
+     * - number: loop specific number of times
+     * @default false
+     */
+    loop?: boolean | number;
+    /**
+     * Delay between loop iterations in milliseconds
+     * @default 0
+     */
+    loopDelay?: number;
 }
 /**
  * PuffPop - Animate children with beautiful entrance effects
  */
-export declare function PuffPop({ children, effect, duration, delay, easing, skeleton, visible, onAnimationComplete, style, animateOnMount, }: PuffPopProps): ReactElement;
+export declare function PuffPop({ children, effect, duration, delay, easing, skeleton, visible, onAnimationComplete, style, animateOnMount, loop, loopDelay, }: PuffPopProps): ReactElement;
 export default PuffPop;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-puff-pop",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A React Native animation library for revealing children components with beautiful puff and pop effects",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/src/index.tsx

@@ -3,6 +3,7 @@ import {
   useRef,
   useState,
   useCallback,
+  useMemo,
   type ReactNode,
   type ReactElement,
 } from 'react';
@@ -101,6 +102,20 @@ export interface PuffPopProps {
    * @default true
    */
   animateOnMount?: boolean;
+
+  /**
+   * Loop the animation
+   * - true: loop infinitely
+   * - number: loop specific number of times
+   * @default false
+   */
+  loop?: boolean | number;
+
+  /**
+   * Delay between loop iterations in milliseconds
+   * @default 0
+   */
+  loopDelay?: number;
 }
 
 /**
@@ -139,6 +154,8 @@ export function PuffPop({
   onAnimationComplete,
   style,
   animateOnMount = true,
+  loop = false,
+  loopDelay = 0,
 }: PuffPopProps): ReactElement {
   // Animation values
   const opacity = useRef(new Animated.Value(animateOnMount ? 0 : 1)).current;
@@ -151,6 +168,31 @@ export function PuffPop({
   const [measuredHeight, setMeasuredHeight] = useState<number | null>(null);
   const animatedHeight = useRef(new Animated.Value(0)).current;
   const hasAnimated = useRef(false);
+  const loopAnimationRef = useRef<Animated.CompositeAnimation | null>(null);
+  const loopTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
+
+  // Memoize effect type checks to avoid repeated includes() calls
+  const effectFlags = useMemo(() => ({
+    hasScale: ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect),
+    hasRotate: ['rotate', 'rotateScale'].includes(effect),
+    hasFlip: effect === 'flip',
+    hasTranslateX: ['slideLeft', 'slideRight'].includes(effect),
+    hasTranslateY: ['slideUp', 'slideDown', 'bounce'].includes(effect),
+    hasRotateEffect: ['rotate', 'rotateScale', 'flip'].includes(effect),
+  }), [effect]);
+
+  // Memoize interpolations to avoid recreating on every render
+  const rotateInterpolation = useMemo(() => 
+    rotate.interpolate({
+      inputRange: [-360, 0, 360],
+      outputRange: ['-360deg', '0deg', '360deg'],
+    }), [rotate]);
+
+  const flipInterpolation = useMemo(() => 
+    rotate.interpolate({
+      inputRange: [-180, 0],
+      outputRange: ['-180deg', '0deg'],
+    }), [rotate]);
 
   // Handle layout measurement for non-skeleton mode
   const onLayout = useCallback(
@@ -187,7 +229,7 @@ export function PuffPop({
       );
 
       // Scale animation
-      if (['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect)) {
+      if (effectFlags.hasScale) {
         const targetScale = toVisible ? 1 : getInitialScale(effect);
         animations.push(
           Animated.timing(scale, {
@@ -199,7 +241,7 @@ export function PuffPop({
       }
 
       // Rotate animation
-      if (['rotate', 'rotateScale', 'flip'].includes(effect)) {
+      if (effectFlags.hasRotate || effectFlags.hasFlip) {
         const targetRotate = toVisible ? 0 : getInitialRotate(effect);
         animations.push(
           Animated.timing(rotate, {
@@ -210,7 +252,7 @@ export function PuffPop({
       }
 
       // TranslateX animation
-      if (['slideLeft', 'slideRight'].includes(effect)) {
+      if (effectFlags.hasTranslateX) {
         const targetX = toVisible ? 0 : getInitialTranslateX(effect);
         animations.push(
           Animated.timing(translateX, {
@@ -221,7 +263,7 @@ export function PuffPop({
       }
 
       // TranslateY animation
-      if (['slideUp', 'slideDown', 'bounce'].includes(effect)) {
+      if (effectFlags.hasTranslateY) {
         const targetY = toVisible ? 0 : getInitialTranslateY(effect);
         animations.push(
           Animated.timing(translateY, {
@@ -246,18 +288,74 @@ export function PuffPop({
 
       // Run animations with delay
       const parallelAnimation = Animated.parallel(animations);
+
+      // Reset values function for looping
+      const resetValues = () => {
+        opacity.setValue(0);
+        scale.setValue(getInitialScale(effect));
+        rotate.setValue(getInitialRotate(effect));
+        translateX.setValue(getInitialTranslateX(effect));
+        translateY.setValue(getInitialTranslateY(effect));
+        if (!skeleton && measuredHeight !== null) {
+          animatedHeight.setValue(0);
+        }
+      };
+
+      // Build the animation sequence
+      let animation: Animated.CompositeAnimation;
       
       if (delay > 0) {
-        Animated.sequence([
+        animation = Animated.sequence([
           Animated.delay(delay),
           parallelAnimation,
-        ]).start(() => {
-          if (toVisible && onAnimationComplete) {
-            onAnimationComplete();
-          }
-        });
+        ]);
       } else {
-        parallelAnimation.start(() => {
+        animation = parallelAnimation;
+      }
+
+      // Handle loop option
+      if (toVisible && loop) {
+        // Stop any existing loop animation
+        if (loopAnimationRef.current) {
+          loopAnimationRef.current.stop();
+        }
+
+        const loopCount = typeof loop === 'number' ? loop : -1;
+        let currentIteration = 0;
+
+        const runLoop = () => {
+          resetValues();
+          animation.start(({ finished }) => {
+            if (finished) {
+              currentIteration++;
+              if (loopCount === -1 || currentIteration < loopCount) {
+                // Add delay between loops if specified
+                if (loopDelay > 0) {
+                  // Clear any existing timeout before setting a new one
+                  if (loopTimeoutRef.current) {
+                    clearTimeout(loopTimeoutRef.current);
+                  }
+                  loopTimeoutRef.current = setTimeout(runLoop, loopDelay);
+                } else {
+                  runLoop();
+                }
+              } else if (onAnimationComplete) {
+                onAnimationComplete();
+              }
+            }
+          });
+        };
+
+        // Store reference and start
+        runLoop();
+      } else {
+        // Stop any existing loop animation
+        if (loopAnimationRef.current) {
+          loopAnimationRef.current.stop();
+          loopAnimationRef.current = null;
+        }
+
+        animation.start(() => {
           if (toVisible && onAnimationComplete) {
             onAnimationComplete();
           }
@@ -269,6 +367,7 @@ export function PuffPop({
       duration,
       easing,
       effect,
+      effectFlags,
       measuredHeight,
       onAnimationComplete,
       opacity,
@@ -278,6 +377,8 @@ export function PuffPop({
       translateX,
       translateY,
       animatedHeight,
+      loop,
+      loopDelay,
     ]
   );
 
@@ -296,23 +397,22 @@ export function PuffPop({
     }
   }, [visible, animate]);
 
-  // For non-skeleton mode, measure first
-  if (!skeleton && measuredHeight === null) {
-    return (
-      <View style={styles.measureContainer} onLayout={onLayout}>
-        <View style={styles.hidden}>{children}</View>
-      </View>
-    );
-  }
-
-  // Build transform based on effect
-  const getTransform = () => {
-    const hasScale = ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect);
-    const hasRotate = ['rotate', 'rotateScale'].includes(effect);
-    const hasFlip = effect === 'flip';
-    const hasTranslateX = ['slideLeft', 'slideRight'].includes(effect);
-    const hasTranslateY = ['slideUp', 'slideDown', 'bounce'].includes(effect);
+  // Cleanup loop animation and timeout on unmount
+  useEffect(() => {
+    return () => {
+      if (loopAnimationRef.current) {
+        loopAnimationRef.current.stop();
+      }
+      if (loopTimeoutRef.current) {
+        clearTimeout(loopTimeoutRef.current);
+      }
+    };
+  }, []);
 
+  // Memoize transform array to avoid recreating on every render
+  // IMPORTANT: All hooks must be called before any conditional returns
+  const transform = useMemo(() => {
+    const { hasScale, hasRotate, hasFlip, hasTranslateX, hasTranslateY } = effectFlags;
     const transforms = [];
 
     if (hasScale) {
@@ -320,21 +420,11 @@ export function PuffPop({
     }
 
     if (hasRotate) {
-      transforms.push({
-        rotate: rotate.interpolate({
-          inputRange: [-360, 0, 360],
-          outputRange: ['-360deg', '0deg', '360deg'],
-        }),
-      });
+      transforms.push({ rotate: rotateInterpolation });
     }
 
     if (hasFlip) {
-      transforms.push({
-        rotateY: rotate.interpolate({
-          inputRange: [-180, 0],
-          outputRange: ['-180deg', '0deg'],
-        }),
-      });
+      transforms.push({ rotateY: flipInterpolation });
     }
 
     if (hasTranslateX) {
@@ -346,17 +436,33 @@ export function PuffPop({
     }
 
     return transforms.length > 0 ? transforms : undefined;
-  };
+  }, [effectFlags, scale, rotateInterpolation, flipInterpolation, translateX, translateY]);
 
-  const animatedStyle = {
+  // Memoize animated style
+  const animatedStyle = useMemo(() => ({
     opacity,
-    transform: getTransform(),
-  };
+    transform,
+  }), [opacity, transform]);
+
+  // Memoize container style for non-skeleton mode
+  const containerAnimatedStyle = useMemo(() => {
+    if (!skeleton && measuredHeight !== null) {
+      return { 
+        height: animatedHeight, 
+        overflow: effectFlags.hasRotateEffect ? 'visible' as const : 'hidden' as const 
+      };
+    }
+    return {};
+  }, [skeleton, measuredHeight, animatedHeight, effectFlags.hasRotateEffect]);
 
-  // Container style for non-skeleton mode
-  const containerAnimatedStyle = !skeleton && measuredHeight !== null
-    ? { height: animatedHeight, overflow: 'hidden' as const }
-    : {};
+  // For non-skeleton mode, measure first (after all hooks)
+  if (!skeleton && measuredHeight === null) {
+    return (
+      <View style={styles.measureContainer} onLayout={onLayout}>
+        <View style={styles.hidden}>{children}</View>
+      </View>
+    );
+  }
 
   return (
     <Animated.View style={[styles.container, style, containerAnimatedStyle]}>