react-native-puff-pop 1.0.3 → 1.0.4

package/README.md

@@ -164,10 +164,13 @@ function App() {
 | `skeleton` | `boolean` | `true` | Reserve space before animation |
 | `visible` | `boolean` | `true` | Control visibility |
 | `animateOnMount` | `boolean` | `true` | Animate when component mounts |
+| `onAnimationStart` | `() => void` | - | Callback when animation starts |
 | `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 |
+| `respectReduceMotion` | `boolean` | `true` | Respect system reduce motion setting |
+| `testID` | `string` | - | Test ID for testing purposes |
 
 ### Animation Effects (`PuffPopEffect`)
 
@@ -204,6 +207,22 @@ The component reserves its full space immediately, and only the visual appearanc
 ### `skeleton={false}`
 The component's height starts at 0 and expands during animation, pushing other content below it. This creates a more dynamic entrance effect.
 
+## Accessibility
+
+PuffPop respects the system's "Reduce Motion" accessibility setting by default. When users have enabled reduce motion in their device settings, animations will be instant (0 duration) to avoid discomfort.
+
+```tsx
+// Respect reduce motion setting (default)
+<PuffPop respectReduceMotion={true}>
+  <YourComponent />
+</PuffPop>
+
+// Ignore reduce motion setting (always animate)
+<PuffPop respectReduceMotion={false}>
+  <YourComponent />
+</PuffPop>
+```
+
 ## License
 
 MIT

package/lib/module/index.js

@@ -1,6 +1,6 @@
 import { jsx as _jsx } from "react/jsx-runtime";
 import { useEffect, useRef, useState, useCallback, useMemo, } from 'react';
-import { View, Animated, StyleSheet, Easing, } from 'react-native';
+import { View, Animated, StyleSheet, Easing, AccessibilityInfo, } 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, loop = false, loopDelay = 0, }) {
+export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0, easing = 'easeOut', skeleton = true, visible = true, onAnimationComplete, onAnimationStart, style, animateOnMount = true, loop = false, loopDelay = 0, respectReduceMotion = true, testID, }) {
     // Animation values
     const opacity = useRef(new Animated.Value(animateOnMount ? 0 : 1)).current;
     const scale = useRef(new Animated.Value(animateOnMount ? getInitialScale(effect) : 1)).current;
@@ -38,6 +38,23 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
     const hasAnimated = useRef(false);
     const loopAnimationRef = useRef(null);
     const loopTimeoutRef = useRef(null);
+    // Reduce motion accessibility support
+    const [isReduceMotionEnabled, setIsReduceMotionEnabled] = useState(false);
+    useEffect(() => {
+        if (!respectReduceMotion)
+            return;
+        const checkReduceMotion = async () => {
+            const reduceMotion = await AccessibilityInfo.isReduceMotionEnabled();
+            setIsReduceMotionEnabled(reduceMotion);
+        };
+        checkReduceMotion();
+        const subscription = AccessibilityInfo.addEventListener('reduceMotionChanged', setIsReduceMotionEnabled);
+        return () => {
+            subscription.remove();
+        };
+    }, [respectReduceMotion]);
+    // Effective duration (0 if reduce motion is enabled)
+    const effectiveDuration = respectReduceMotion && isReduceMotionEnabled ? 0 : duration;
     // Memoize effect type checks to avoid repeated includes() calls
     const effectFlags = useMemo(() => ({
         hasScale: ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect),
@@ -65,12 +82,16 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
     }, [skeleton, measuredHeight]);
     // Animate function
     const animate = useCallback((toVisible) => {
+        // Call onAnimationStart callback
+        if (toVisible && onAnimationStart) {
+            onAnimationStart();
+        }
         const easingFn = getEasing(easing);
         // When skeleton is false, we animate height which doesn't support native driver
         // So we must use JS driver for all animations in that case
         const useNative = skeleton;
         const config = {
-            duration,
+            duration: effectiveDuration,
             easing: easingFn,
             useNativeDriver: useNative,
         };
@@ -118,7 +139,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
             const targetHeight = toVisible ? measuredHeight : 0;
             animations.push(Animated.timing(animatedHeight, {
                 toValue: targetHeight,
-                duration,
+                duration: effectiveDuration,
                 easing: easingFn,
                 useNativeDriver: false,
             }));
@@ -196,12 +217,13 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
         }
     }, [
         delay,
-        duration,
+        effectiveDuration,
         easing,
         effect,
         effectFlags,
         measuredHeight,
         onAnimationComplete,
+        onAnimationStart,
         opacity,
         rotate,
         scale,
@@ -277,7 +299,7 @@ export function PuffPop({ children, effect = 'scale', duration = 400, delay = 0,
     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 }) }));
+    return (_jsx(Animated.View, { style: [styles.container, style, containerAnimatedStyle], testID: testID, children: _jsx(Animated.View, { style: animatedStyle, children: children }) }));
 }
 /**
  * Get initial scale value based on effect

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

@@ -69,9 +69,23 @@ export interface PuffPopProps {
      * @default 0
      */
     loopDelay?: number;
+    /**
+     * Callback when animation starts
+     */
+    onAnimationStart?: () => void;
+    /**
+     * Respect system reduce motion accessibility setting
+     * When true and reduce motion is enabled, animations will be instant
+     * @default true
+     */
+    respectReduceMotion?: boolean;
+    /**
+     * Test ID for testing purposes
+     */
+    testID?: string;
 }
 /**
  * PuffPop - Animate children with beautiful entrance effects
  */
-export declare function PuffPop({ children, effect, duration, delay, easing, skeleton, visible, onAnimationComplete, style, animateOnMount, loop, loopDelay, }: PuffPopProps): ReactElement;
+export declare function PuffPop({ children, effect, duration, delay, easing, skeleton, visible, onAnimationComplete, onAnimationStart, style, animateOnMount, loop, loopDelay, respectReduceMotion, testID, }: PuffPopProps): ReactElement;
 export default PuffPop;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-puff-pop",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "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

@@ -12,6 +12,7 @@ import {
   Animated,
   StyleSheet,
   Easing,
+  AccessibilityInfo,
   type LayoutChangeEvent,
   type StyleProp,
   type ViewStyle,
@@ -116,6 +117,23 @@ export interface PuffPopProps {
    * @default 0
    */
   loopDelay?: number;
+
+  /**
+   * Callback when animation starts
+   */
+  onAnimationStart?: () => void;
+
+  /**
+   * Respect system reduce motion accessibility setting
+   * When true and reduce motion is enabled, animations will be instant
+   * @default true
+   */
+  respectReduceMotion?: boolean;
+
+  /**
+   * Test ID for testing purposes
+   */
+  testID?: string;
 }
 
 /**
@@ -152,10 +170,13 @@ export function PuffPop({
   skeleton = true,
   visible = true,
   onAnimationComplete,
+  onAnimationStart,
   style,
   animateOnMount = true,
   loop = false,
   loopDelay = 0,
+  respectReduceMotion = true,
+  testID,
 }: PuffPopProps): ReactElement {
   // Animation values
   const opacity = useRef(new Animated.Value(animateOnMount ? 0 : 1)).current;
@@ -171,6 +192,32 @@ export function PuffPop({
   const loopAnimationRef = useRef<Animated.CompositeAnimation | null>(null);
   const loopTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);
 
+  // Reduce motion accessibility support
+  const [isReduceMotionEnabled, setIsReduceMotionEnabled] = useState(false);
+
+  useEffect(() => {
+    if (!respectReduceMotion) return;
+
+    const checkReduceMotion = async () => {
+      const reduceMotion = await AccessibilityInfo.isReduceMotionEnabled();
+      setIsReduceMotionEnabled(reduceMotion);
+    };
+
+    checkReduceMotion();
+
+    const subscription = AccessibilityInfo.addEventListener(
+      'reduceMotionChanged',
+      setIsReduceMotionEnabled
+    );
+
+    return () => {
+      subscription.remove();
+    };
+  }, [respectReduceMotion]);
+
+  // Effective duration (0 if reduce motion is enabled)
+  const effectiveDuration = respectReduceMotion && isReduceMotionEnabled ? 0 : duration;
+
   // Memoize effect type checks to avoid repeated includes() calls
   const effectFlags = useMemo(() => ({
     hasScale: ['scale', 'bounce', 'zoom', 'rotateScale', 'flip'].includes(effect),
@@ -208,12 +255,17 @@ export function PuffPop({
   // Animate function
   const animate = useCallback(
     (toVisible: boolean) => {
+      // Call onAnimationStart callback
+      if (toVisible && onAnimationStart) {
+        onAnimationStart();
+      }
+
       const easingFn = getEasing(easing);
       // When skeleton is false, we animate height which doesn't support native driver
       // So we must use JS driver for all animations in that case
       const useNative = skeleton;
       const config = {
-        duration,
+        duration: effectiveDuration,
         easing: easingFn,
         useNativeDriver: useNative,
       };
@@ -279,7 +331,7 @@ export function PuffPop({
         animations.push(
           Animated.timing(animatedHeight, {
             toValue: targetHeight,
-            duration,
+            duration: effectiveDuration,
             easing: easingFn,
             useNativeDriver: false,
           })
@@ -364,12 +416,13 @@ export function PuffPop({
     },
     [
       delay,
-      duration,
+      effectiveDuration,
       easing,
       effect,
       effectFlags,
       measuredHeight,
       onAnimationComplete,
+      onAnimationStart,
       opacity,
       rotate,
       scale,
@@ -465,7 +518,10 @@ export function PuffPop({
   }
 
   return (
-    <Animated.View style={[styles.container, style, containerAnimatedStyle]}>
+    <Animated.View 
+      style={[styles.container, style, containerAnimatedStyle]}
+      testID={testID}
+    >
       <Animated.View style={animatedStyle}>{children}</Animated.View>
     </Animated.View>
   );