@fountain-ui/lab 2.0.0-beta.17 → 2.0.0-beta.18

package/build/module/Carousel/hooks/index.js

@@ -1,6 +1,6 @@
 export { default as useAutoplayController } from './useAutoplayController';
 export { default as useIndexController } from './useIndexController';
 export { default as useLoopedData } from './useLoopedData';
-export { default as usePagingAnimation } from './usePagingAnimation';
+export { default as usePagingAnimator } from './usePagingAnimator';
 export { default as useItemVisibilityStore } from './useItemVisibilityStore';
 //# sourceMappingURL=index.js.map

package/build/module/Carousel/hooks/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["default","useAutoplayController","useIndexController","useLoopedData","usePagingAnimation","useItemVisibilityStore"],"sources":["index.ts"],"sourcesContent":["export { default as useAutoplayController } from './useAutoplayController';\nexport { default as useIndexController } from './useIndexController';\nexport { default as useLoopedData } from './useLoopedData';\nexport { default as usePagingAnimation } from './usePagingAnimation';\nexport { default as useItemVisibilityStore } from './useItemVisibilityStore';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,qBAApB,QAAiD,yBAAjD;AACA,SAASD,OAAO,IAAIE,kBAApB,QAA8C,sBAA9C;AACA,SAASF,OAAO,IAAIG,aAApB,QAAyC,iBAAzC;AACA,SAASH,OAAO,IAAII,kBAApB,QAA8C,sBAA9C;AACA,SAASJ,OAAO,IAAIK,sBAApB,QAAkD,0BAAlD"}
+{"version":3,"names":["default","useAutoplayController","useIndexController","useLoopedData","usePagingAnimator","useItemVisibilityStore"],"sources":["index.ts"],"sourcesContent":["export { default as useAutoplayController } from './useAutoplayController';\nexport { default as useIndexController } from './useIndexController';\nexport { default as useLoopedData } from './useLoopedData';\nexport { default as usePagingAnimator } from './usePagingAnimator';\nexport { default as useItemVisibilityStore } from './useItemVisibilityStore';\n"],"mappings":"AAAA,SAASA,OAAO,IAAIC,qBAApB,QAAiD,yBAAjD;AACA,SAASD,OAAO,IAAIE,kBAApB,QAA8C,sBAA9C;AACA,SAASF,OAAO,IAAIG,aAApB,QAAyC,iBAAzC;AACA,SAASH,OAAO,IAAII,iBAApB,QAA6C,qBAA7C;AACA,SAASJ,OAAO,IAAIK,sBAApB,QAAkD,0BAAlD"}

package/build/module/Carousel/hooks/useIndexController.js

@@ -12,8 +12,16 @@ export default function useIndexController(params) {
   } = params;
   const currentIndex = useImperativeState(initialIndex);
   const currentPosition = useImperativeState(initialIndex);
-  const notifyAnimationState = useCallback(state => {
-    if (state === 'finished' || state === 'interrupted') {
+  const notifyScrollStateHasChanged = useCallback(_ref => {
+    let {
+      offset,
+      state
+    } = _ref;
+    const normalized = -Math.round(offset / itemWidth);
+    const index = Math.floor(mod(normalized, numberOfOriginalData));
+    const position = Math.floor(mod(normalized, numberOfData));
+
+    if (state === 'idle' || state === 'interrupted') {
       if (currentIndex.hasChanged()) {
         onIndexChange === null || onIndexChange === void 0 ? void 0 : onIndexChange(currentIndex.get());
       }
@@ -22,21 +30,14 @@ export default function useIndexController(params) {
         onPositionChange === null || onPositionChange === void 0 ? void 0 : onPositionChange(currentPosition.get());
       }
     }
-  }, [onIndexChange, onPositionChange]);
-  const notifyOffsetHasChanged = useCallback(offset => {
-    const roundedOffset = Math.round(offset / itemWidth) * itemWidth; // To prevent floating point problem, make sure index is integer type.
-
-    const nextIndex = Math.floor(mod(-roundedOffset / itemWidth, numberOfOriginalData));
-    currentIndex.set(nextIndex); // To prevent floating point problem, make sure index is integer type.
 
-    const nextPosition = Math.floor(mod(-roundedOffset / itemWidth, numberOfData));
-    currentPosition.set(nextPosition);
-  }, [itemWidth, numberOfData, numberOfOriginalData]);
+    currentIndex.set(index);
+    currentPosition.set(position);
+  }, [itemWidth, numberOfData, numberOfOriginalData, onIndexChange, onPositionChange]);
   return {
     getCurrentIndex: currentIndex.get,
     lastIndex: numberOfOriginalData - 1,
-    notifyAnimationState,
-    notifyOffsetHasChanged
+    notifyScrollStateHasChanged
   };
 }
 ;

package/build/module/Carousel/hooks/useIndexController.js.map

@@ -1 +1 @@
-{"version":3,"names":["useCallback","useImperativeState","mod","useIndexController","params","initialIndex","itemWidth","numberOfData","numberOfOriginalData","onIndexChange","onPositionChange","currentIndex","currentPosition","notifyAnimationState","state","hasChanged","get","notifyOffsetHasChanged","offset","roundedOffset","Math","round","nextIndex","floor","set","nextPosition","getCurrentIndex","lastIndex"],"sources":["useIndexController.tsx"],"sourcesContent":["import { useCallback } from 'react';\nimport { useImperativeState } from '@fountain-ui/core';\nimport { mod } from '@fountain-ui/utils';\nimport type { AnimationState, IndexController } from '../types';\n\nexport interface UseIndexControllerParameters {\n    initialIndex: number;\n    itemWidth: number;\n    numberOfData: number;\n    numberOfOriginalData: number;\n    onIndexChange?: (itemIndex: number) => void;\n    onPositionChange?: (position: number) => void;\n}\n\nexport default function useIndexController(params: UseIndexControllerParameters): IndexController {\n    const {\n        initialIndex,\n        itemWidth,\n        numberOfData,\n        numberOfOriginalData,\n        onIndexChange,\n        onPositionChange,\n    } = params;\n\n    const currentIndex = useImperativeState(initialIndex);\n    const currentPosition = useImperativeState(initialIndex);\n\n    const notifyAnimationState = useCallback((state: AnimationState) => {\n        if (state === 'finished' || state === 'interrupted') {\n            if (currentIndex.hasChanged()) {\n                onIndexChange?.(currentIndex.get());\n            }\n\n            if (currentPosition.hasChanged()) {\n                onPositionChange?.(currentPosition.get());\n            }\n        }\n    }, [\n        onIndexChange,\n        onPositionChange,\n    ]);\n\n    const notifyOffsetHasChanged = useCallback((offset: number) => {\n        const roundedOffset = Math.round(offset / itemWidth) * itemWidth;\n\n        // To prevent floating point problem, make sure index is integer type.\n        const nextIndex = Math.floor(mod((-roundedOffset / itemWidth), numberOfOriginalData));\n        currentIndex.set(nextIndex);\n\n        // To prevent floating point problem, make sure index is integer type.\n        const nextPosition = Math.floor(mod((-roundedOffset / itemWidth), numberOfData));\n        currentPosition.set(nextPosition);\n    }, [\n        itemWidth,\n        numberOfData,\n        numberOfOriginalData,\n    ]);\n\n    return {\n        getCurrentIndex: currentIndex.get,\n        lastIndex: numberOfOriginalData - 1,\n        notifyAnimationState,\n        notifyOffsetHasChanged,\n    };\n};\n"],"mappings":"AAAA,SAASA,WAAT,QAA4B,OAA5B;AACA,SAASC,kBAAT,QAAmC,mBAAnC;AACA,SAASC,GAAT,QAAoB,oBAApB;AAYA,eAAe,SAASC,kBAAT,CAA4BC,MAA5B,EAAmF;EAC9F,MAAM;IACFC,YADE;IAEFC,SAFE;IAGFC,YAHE;IAIFC,oBAJE;IAKFC,aALE;IAMFC;EANE,IAOFN,MAPJ;EASA,MAAMO,YAAY,GAAGV,kBAAkB,CAACI,YAAD,CAAvC;EACA,MAAMO,eAAe,GAAGX,kBAAkB,CAACI,YAAD,CAA1C;EAEA,MAAMQ,oBAAoB,GAAGb,WAAW,CAAEc,KAAD,IAA2B;IAChE,IAAIA,KAAK,KAAK,UAAV,IAAwBA,KAAK,KAAK,aAAtC,EAAqD;MACjD,IAAIH,YAAY,CAACI,UAAb,EAAJ,EAA+B;QAC3BN,aAAa,SAAb,IAAAA,aAAa,WAAb,YAAAA,aAAa,CAAGE,YAAY,CAACK,GAAb,EAAH,CAAb;MACH;;MAED,IAAIJ,eAAe,CAACG,UAAhB,EAAJ,EAAkC;QAC9BL,gBAAgB,SAAhB,IAAAA,gBAAgB,WAAhB,YAAAA,gBAAgB,CAAGE,eAAe,CAACI,GAAhB,EAAH,CAAhB;MACH;IACJ;EACJ,CAVuC,EAUrC,CACCP,aADD,EAECC,gBAFD,CAVqC,CAAxC;EAeA,MAAMO,sBAAsB,GAAGjB,WAAW,CAAEkB,MAAD,IAAoB;IAC3D,MAAMC,aAAa,GAAGC,IAAI,CAACC,KAAL,CAAWH,MAAM,GAAGZ,SAApB,IAAiCA,SAAvD,CAD2D,CAG3D;;IACA,MAAMgB,SAAS,GAAGF,IAAI,CAACG,KAAL,CAAWrB,GAAG,CAAE,CAACiB,aAAD,GAAiBb,SAAnB,EAA+BE,oBAA/B,CAAd,CAAlB;IACAG,YAAY,CAACa,GAAb,CAAiBF,SAAjB,EAL2D,CAO3D;;IACA,MAAMG,YAAY,GAAGL,IAAI,CAACG,KAAL,CAAWrB,GAAG,CAAE,CAACiB,aAAD,GAAiBb,SAAnB,EAA+BC,YAA/B,CAAd,CAArB;IACAK,eAAe,CAACY,GAAhB,CAAoBC,YAApB;EACH,CAVyC,EAUvC,CACCnB,SADD,EAECC,YAFD,EAGCC,oBAHD,CAVuC,CAA1C;EAgBA,OAAO;IACHkB,eAAe,EAAEf,YAAY,CAACK,GAD3B;IAEHW,SAAS,EAAEnB,oBAAoB,GAAG,CAF/B;IAGHK,oBAHG;IAIHI;EAJG,CAAP;AAMH;AAAA"}
+{"version":3,"names":["useCallback","useImperativeState","mod","useIndexController","params","initialIndex","itemWidth","numberOfData","numberOfOriginalData","onIndexChange","onPositionChange","currentIndex","currentPosition","notifyScrollStateHasChanged","offset","state","normalized","Math","round","index","floor","position","hasChanged","get","set","getCurrentIndex","lastIndex"],"sources":["useIndexController.tsx"],"sourcesContent":["import { useCallback } from 'react';\nimport { useImperativeState } from '@fountain-ui/core';\nimport { mod } from '@fountain-ui/utils';\nimport type { IndexController, ScrollStateChangeEvent } from '../types';\n\nexport interface UseIndexControllerParameters {\n    initialIndex: number;\n    itemWidth: number;\n    numberOfData: number;\n    numberOfOriginalData: number;\n    onIndexChange?: (itemIndex: number) => void;\n    onPositionChange?: (position: number) => void;\n}\n\nexport default function useIndexController(params: UseIndexControllerParameters): IndexController {\n    const {\n        initialIndex,\n        itemWidth,\n        numberOfData,\n        numberOfOriginalData,\n        onIndexChange,\n        onPositionChange,\n    } = params;\n\n    const currentIndex = useImperativeState(initialIndex);\n    const currentPosition = useImperativeState(initialIndex);\n\n    const notifyScrollStateHasChanged = useCallback(({ offset, state }: ScrollStateChangeEvent) => {\n        const normalized = -Math.round(offset / itemWidth);\n        const index = Math.floor(mod(normalized, numberOfOriginalData));\n        const position = Math.floor(mod(normalized, numberOfData));\n\n        if (state === 'idle' || state === 'interrupted') {\n            if (currentIndex.hasChanged()) {\n                onIndexChange?.(currentIndex.get());\n            }\n            if (currentPosition.hasChanged()) {\n                onPositionChange?.(currentPosition.get());\n            }\n        }\n\n        currentIndex.set(index);\n        currentPosition.set(position);\n    }, [\n        itemWidth,\n        numberOfData,\n        numberOfOriginalData,\n        onIndexChange,\n        onPositionChange,\n    ]);\n\n    return {\n        getCurrentIndex: currentIndex.get,\n        lastIndex: numberOfOriginalData - 1,\n        notifyScrollStateHasChanged,\n    };\n};\n"],"mappings":"AAAA,SAASA,WAAT,QAA4B,OAA5B;AACA,SAASC,kBAAT,QAAmC,mBAAnC;AACA,SAASC,GAAT,QAAoB,oBAApB;AAYA,eAAe,SAASC,kBAAT,CAA4BC,MAA5B,EAAmF;EAC9F,MAAM;IACFC,YADE;IAEFC,SAFE;IAGFC,YAHE;IAIFC,oBAJE;IAKFC,aALE;IAMFC;EANE,IAOFN,MAPJ;EASA,MAAMO,YAAY,GAAGV,kBAAkB,CAACI,YAAD,CAAvC;EACA,MAAMO,eAAe,GAAGX,kBAAkB,CAACI,YAAD,CAA1C;EAEA,MAAMQ,2BAA2B,GAAGb,WAAW,CAAC,QAA+C;IAAA,IAA9C;MAAEc,MAAF;MAAUC;IAAV,CAA8C;IAC3F,MAAMC,UAAU,GAAG,CAACC,IAAI,CAACC,KAAL,CAAWJ,MAAM,GAAGR,SAApB,CAApB;IACA,MAAMa,KAAK,GAAGF,IAAI,CAACG,KAAL,CAAWlB,GAAG,CAACc,UAAD,EAAaR,oBAAb,CAAd,CAAd;IACA,MAAMa,QAAQ,GAAGJ,IAAI,CAACG,KAAL,CAAWlB,GAAG,CAACc,UAAD,EAAaT,YAAb,CAAd,CAAjB;;IAEA,IAAIQ,KAAK,KAAK,MAAV,IAAoBA,KAAK,KAAK,aAAlC,EAAiD;MAC7C,IAAIJ,YAAY,CAACW,UAAb,EAAJ,EAA+B;QAC3Bb,aAAa,SAAb,IAAAA,aAAa,WAAb,YAAAA,aAAa,CAAGE,YAAY,CAACY,GAAb,EAAH,CAAb;MACH;;MACD,IAAIX,eAAe,CAACU,UAAhB,EAAJ,EAAkC;QAC9BZ,gBAAgB,SAAhB,IAAAA,gBAAgB,WAAhB,YAAAA,gBAAgB,CAAGE,eAAe,CAACW,GAAhB,EAAH,CAAhB;MACH;IACJ;;IAEDZ,YAAY,CAACa,GAAb,CAAiBL,KAAjB;IACAP,eAAe,CAACY,GAAhB,CAAoBH,QAApB;EACH,CAhB8C,EAgB5C,CACCf,SADD,EAECC,YAFD,EAGCC,oBAHD,EAICC,aAJD,EAKCC,gBALD,CAhB4C,CAA/C;EAwBA,OAAO;IACHe,eAAe,EAAEd,YAAY,CAACY,GAD3B;IAEHG,SAAS,EAAElB,oBAAoB,GAAG,CAF/B;IAGHK;EAHG,CAAP;AAKH;AAAA"}

package/build/module/Carousel/hooks/{usePagingAnimation.js → usePagingAnimator.js}

@@ -1,4 +1,5 @@
-import { useCallback, useRef } from 'react';
+import { useCallback, useMemo, useRef } from 'react';
+import { Animated } from 'react-native';
 
 function directionToValue(itemWidth) {
   return function (direction) {
@@ -25,22 +26,27 @@ function toValueCompensator(itemWidth) {
   };
 }
 
-export default function usePagingAnimation(params) {
+export default function usePagingAnimator(config) {
   const {
     createScrollAnimation,
     itemWidth,
     indexController,
+    initialIndex,
     loop,
-    numberOfData,
-    offsetX,
-    translateX
-  } = params;
+    numberOfData
+  } = config;
   const {
     getCurrentIndex,
     lastIndex,
-    notifyAnimationState,
-    notifyOffsetHasChanged
+    notifyScrollStateHasChanged
   } = indexController;
+  const initialOffsetX = itemWidth * initialIndex;
+  const accumulativeOffsetX = useRef(new Animated.Value(initialOffsetX)).current;
+  const animationOffsetX = useRef(new Animated.Value(0)).current;
+  const gestureTranslationX = useRef(new Animated.Value(0)).current;
+  const globalInterpolation = useMemo(() => {
+    return Animated.add(Animated.add(accumulativeOffsetX, animationOffsetX), gestureTranslationX);
+  }, []);
   const toValueRef = useRef(0);
   const currentOffsetRef = useRef(0);
   const isAnimatingRef = useRef(false);
@@ -60,32 +66,37 @@ export default function usePagingAnimation(params) {
   const requireNewOffset = useCallback(newOffset => {
     const nextOffset = ensureOffsetBoundary(newOffset);
     currentOffsetRef.current = nextOffset;
-    offsetX.setValue(nextOffset);
+    accumulativeOffsetX.setValue(nextOffset);
     toValueRef.current = 0;
-    translateX.setValue(0);
-  }, [ensureOffsetBoundary, offsetX, translateX]);
+    animationOffsetX.setValue(0);
+  }, [ensureOffsetBoundary]);
   const interruptAnimation = useCallback(() => {
     if (!isAnimatingRef.current) {
       return;
     }
 
-    translateX.stopAnimation(lastValue => {
+    animationOffsetX.stopAnimation(lastValue => {
       isAnimatingRef.current = false;
       const prevOffset = currentOffsetRef.current;
       const totalOffset = prevOffset + lastValue;
-      notifyOffsetHasChanged(totalOffset);
-      notifyAnimationState('interrupted');
       requireNewOffset(totalOffset);
+      notifyScrollStateHasChanged({
+        offset: totalOffset,
+        state: 'interrupted'
+      });
     });
-  }, [requireNewOffset, translateX]);
+  }, [notifyScrollStateHasChanged, requireNewOffset]);
   const finalizeAnimation = useCallback(() => {
-    notifyAnimationState('finished');
     isAnimatingRef.current = false;
     const prevOffset = currentOffsetRef.current;
     const toValue = toValueRef.current;
     const totalOffset = prevOffset + toValue;
     requireNewOffset(totalOffset);
-  }, [notifyAnimationState, requireNewOffset]);
+    notifyScrollStateHasChanged({
+      offset: totalOffset,
+      state: 'idle'
+    });
+  }, [notifyScrollStateHasChanged, requireNewOffset]);
   const startPagingAnimation = useCallback((type, config) => {
     if (isAnimatingRef.current) {
       return;
@@ -143,10 +154,19 @@ export default function usePagingAnimation(params) {
     const toValue = compensateToValue(wantedToValue, currentOffsetRef.current);
     toValueRef.current = toValue;
     isAnimatingRef.current = true;
-    notifyOffsetHasChanged(currentOffsetRef.current + toValue);
+    notifyScrollStateHasChanged({
+      offset: currentOffsetRef.current + toValue,
+      state: 'dragging'
+    });
+    const lastGestureTranslationX = configWithDefaults.lastGestureTranslationX ?? 0;
+
+    if (Number.isFinite(lastGestureTranslationX)) {
+      animationOffsetX.setValue(lastGestureTranslationX);
+      gestureTranslationX.setValue(0);
+    }
 
     if (configWithDefaults.animated) {
-      const animation = createScrollAnimation(translateX, toValue);
+      const animation = createScrollAnimation(animationOffsetX, toValue);
       animation.start(_ref2 => {
         let {
           finished
@@ -156,15 +176,16 @@ export default function usePagingAnimation(params) {
           finalizeAnimation();
         }
       });
-      notifyAnimationState('started');
     } else {
       finalizeAnimation();
     }
-  }, [createScrollAnimation, getCurrentIndex, finalizeAnimation, itemWidth, lastIndex, loop, notifyAnimationState, notifyOffsetHasChanged]);
+  }, [createScrollAnimation, getCurrentIndex, finalizeAnimation, itemWidth, lastIndex, loop, notifyScrollStateHasChanged]);
   return {
+    gestureTranslationX,
+    globalInterpolation,
     interruptAnimation,
     startPagingAnimation
   };
 }
 ;
-//# sourceMappingURL=usePagingAnimation.js.map
+//# sourceMappingURL=usePagingAnimator.js.map

package/build/module/Carousel/hooks/usePagingAnimator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useMemo","useRef","Animated","directionToValue","itemWidth","direction","toValueCompensator","toValue","currentOffset","remainder","Math","abs","halfOfItemWidth","compensateVector","usePagingAnimator","config","createScrollAnimation","indexController","initialIndex","loop","numberOfData","getCurrentIndex","lastIndex","notifyScrollStateHasChanged","initialOffsetX","accumulativeOffsetX","Value","current","animationOffsetX","gestureTranslationX","globalInterpolation","add","toValueRef","currentOffsetRef","isAnimatingRef","maxWidth","ensureOffsetBoundary","offset","isCloseToEnd","signOfOffset","requireNewOffset","newOffset","nextOffset","setValue","interruptAnimation","stopAnimation","lastValue","prevOffset","totalOffset","state","finalizeAnimation","startPagingAnimation","type","configWithDefaults","animated","currentIndex","getValueByDirectionOnAllAdjacentItemsVisible","compensateToValue","getValueByDirectionalPagingOnLoopDisabled","_config","isOriginatedFromGesture","getValueByDirectionalPaging","_configWithDefaults","getValueByIndexPaging","index","distance","wantedToValue","lastGestureTranslationX","Number","isFinite","animation","start","finished"],"sources":["usePagingAnimator.ts"],"sourcesContent":["import { useCallback, useMemo, useRef } from 'react';\nimport { Animated } from 'react-native';\nimport type {\n    CreateScrollAnimation,\n    DirectionalPagingAnimationConfig,\n    IndexController,\n    IndexPagingAnimationConfig,\n    PagingAnimationConfig,\n    PagingAnimationType,\n    PagingDirection,\n    StartPagingAnimation,\n} from '../types';\n\nexport interface PagingAnimatorConfig {\n    createScrollAnimation: CreateScrollAnimation;\n    itemWidth: number;\n    indexController: IndexController;\n    initialIndex: number;\n    loop: boolean;\n    numberOfData: number;\n}\n\nexport interface PagingAnimator {\n    gestureTranslationX: Animated.Value;\n    globalInterpolation: Animated.AnimatedInterpolation;\n    interruptAnimation: () => void;\n    startPagingAnimation: StartPagingAnimation;\n}\n\nfunction directionToValue(itemWidth: number) {\n    return function (direction: PagingDirection): number {\n        switch (direction) {\n            case 'next':\n                return -itemWidth;\n            case 'prev':\n                return itemWidth;\n            case 'stay':\n                return 0;\n        }\n    };\n}\n\nfunction toValueCompensator(itemWidth: number) {\n    return function (toValue: number, currentOffset: number): number {\n        const remainder = Math.abs(currentOffset % itemWidth);\n\n        const halfOfItemWidth = Math.abs(itemWidth / 2);\n        const compensateVector = remainder > halfOfItemWidth\n            ? remainder - itemWidth\n            : remainder;\n\n        const direction = currentOffset > 0 ? -1 : 1;\n\n        return toValue + (direction * compensateVector);\n    };\n}\n\nexport default function usePagingAnimator(config: PagingAnimatorConfig): PagingAnimator {\n    const {\n        createScrollAnimation,\n        itemWidth,\n        indexController,\n        initialIndex,\n        loop,\n        numberOfData,\n    } = config;\n\n    const {\n        getCurrentIndex,\n        lastIndex,\n        notifyScrollStateHasChanged,\n    } = indexController;\n\n    const initialOffsetX = itemWidth * initialIndex;\n    const accumulativeOffsetX = useRef(new Animated.Value(initialOffsetX)).current;\n    const animationOffsetX = useRef(new Animated.Value(0)).current;\n    const gestureTranslationX = useRef(new Animated.Value(0)).current;\n\n    const globalInterpolation = useMemo(() => {\n        return Animated.add(\n            Animated.add(accumulativeOffsetX, animationOffsetX),\n            gestureTranslationX,\n        );\n    }, []);\n\n    const toValueRef = useRef<number>(0);\n    const currentOffsetRef = useRef<number>(0);\n\n    const isAnimatingRef = useRef<boolean>(false);\n\n    const maxWidth = Math.abs(numberOfData * itemWidth);\n\n    const ensureOffsetBoundary: (offset: number) => number = useCallback((offset: number) => {\n        if (loop) {\n            const isCloseToEnd = Math.abs(offset) >= (maxWidth - itemWidth);\n            if (isCloseToEnd) {\n                const signOfOffset = offset > 0 ? 1 : -1;\n                return offset + (-signOfOffset * maxWidth);\n            }\n        }\n\n        return offset % maxWidth;\n    }, [itemWidth, loop, maxWidth]);\n\n    const requireNewOffset = useCallback((newOffset: number) => {\n        const nextOffset = ensureOffsetBoundary(newOffset);\n\n        currentOffsetRef.current = nextOffset;\n        accumulativeOffsetX.setValue(nextOffset);\n\n        toValueRef.current = 0;\n        animationOffsetX.setValue(0);\n    }, [\n        ensureOffsetBoundary,\n    ]);\n\n    const interruptAnimation = useCallback(() => {\n        if (!isAnimatingRef.current) {\n            return;\n        }\n\n        animationOffsetX.stopAnimation(lastValue => {\n            isAnimatingRef.current = false;\n\n            const prevOffset = currentOffsetRef.current;\n            const totalOffset = prevOffset + lastValue;\n\n            requireNewOffset(totalOffset);\n\n            notifyScrollStateHasChanged({ offset: totalOffset, state: 'interrupted' });\n        });\n    }, [\n        notifyScrollStateHasChanged,\n        requireNewOffset,\n    ]);\n\n    const finalizeAnimation = useCallback(() => {\n        isAnimatingRef.current = false;\n\n        const prevOffset = currentOffsetRef.current;\n        const toValue = toValueRef.current;\n        const totalOffset = prevOffset + toValue;\n\n        requireNewOffset(totalOffset);\n\n        notifyScrollStateHasChanged({ offset: totalOffset, state: 'idle' });\n    }, [\n        notifyScrollStateHasChanged,\n        requireNewOffset,\n    ]);\n\n    const startPagingAnimation = useCallback((type: PagingAnimationType, config: PagingAnimationConfig) => {\n        if (isAnimatingRef.current) {\n            return;\n        }\n\n        const configWithDefaults: PagingAnimationConfig = {\n            animated: true,\n            ...config,\n        };\n\n        const currentIndex = getCurrentIndex();\n\n        const getValueByDirectionOnAllAdjacentItemsVisible = directionToValue(itemWidth);\n        const compensateToValue = toValueCompensator(itemWidth);\n\n        const getValueByDirectionalPagingOnLoopDisabled = (_config: DirectionalPagingAnimationConfig): number => {\n            const { direction, isOriginatedFromGesture } = _config;\n\n            if (currentIndex === 0 && direction === 'prev') {\n                return isOriginatedFromGesture\n                    ? getValueByDirectionOnAllAdjacentItemsVisible('stay')\n                    : -lastIndex * itemWidth; // last position\n            } else if (currentIndex === lastIndex && direction === 'next') {\n                return isOriginatedFromGesture\n                    ? getValueByDirectionOnAllAdjacentItemsVisible('stay')\n                    : lastIndex * itemWidth; // first position\n            }\n            return getValueByDirectionOnAllAdjacentItemsVisible(direction);\n        };\n\n        const getValueByDirectionalPaging = (_config: DirectionalPagingAnimationConfig): number => {\n            const _configWithDefaults: DirectionalPagingAnimationConfig = {\n                isOriginatedFromGesture: false,\n                ..._config,\n            };\n\n            return loop\n                ? getValueByDirectionOnAllAdjacentItemsVisible(_configWithDefaults.direction)\n                : getValueByDirectionalPagingOnLoopDisabled(_configWithDefaults);\n        };\n\n        const getValueByIndexPaging = ({ index }: IndexPagingAnimationConfig): number => {\n            if (index < 0 || index > lastIndex || index === currentIndex) {\n                // no animation if index is invalid or equals to current index\n                return 0;\n            }\n\n            const distance = Math.abs(currentIndex - index) * itemWidth;\n            const direction = index > currentIndex ? -1 : 1;\n\n            return distance * direction;\n        };\n\n        const wantedToValue = type === 'directional'\n            // @ts-ignore\n            ? getValueByDirectionalPaging(configWithDefaults)\n            // @ts-ignore\n            : getValueByIndexPaging(configWithDefaults);\n\n        const toValue = compensateToValue(wantedToValue, currentOffsetRef.current);\n\n        toValueRef.current = toValue;\n        isAnimatingRef.current = true;\n\n        notifyScrollStateHasChanged({\n            offset: currentOffsetRef.current + toValue,\n            state: 'dragging',\n        });\n\n        const lastGestureTranslationX: number = configWithDefaults.lastGestureTranslationX ?? 0;\n        if (Number.isFinite(lastGestureTranslationX)) {\n            animationOffsetX.setValue(lastGestureTranslationX);\n            gestureTranslationX.setValue(0);\n        }\n\n        if (configWithDefaults.animated) {\n            const animation = createScrollAnimation(animationOffsetX, toValue);\n\n            animation.start(({ finished }) => {\n                if (finished) {\n                    finalizeAnimation();\n                }\n            });\n        } else {\n            finalizeAnimation();\n        }\n    }, [\n        createScrollAnimation,\n        getCurrentIndex,\n        finalizeAnimation,\n        itemWidth,\n        lastIndex,\n        loop,\n        notifyScrollStateHasChanged,\n    ]);\n\n    return {\n        gestureTranslationX,\n        globalInterpolation,\n        interruptAnimation,\n        startPagingAnimation,\n    };\n};\n"],"mappings":"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"}

package/build/module/Carousel/types.js

@@ -1,4 +1,4 @@
 const directions = ['next', 'prev', 'stay'];
-const animationStates = ['started', 'finished', 'interrupted'];
+const scrollStates = ['idle', 'dragging', 'interrupted'];
 export {};
 //# sourceMappingURL=types.js.map

package/build/module/Carousel/types.js.map

@@ -1 +1 @@
-{"version":3,"names":["directions","animationStates"],"sources":["types.ts"],"sourcesContent":["import type { ReactElement } from 'react';\nimport type { Animated, ViewProps } from 'react-native';\n\nconst directions = ['next', 'prev', 'stay'] as const;\n\nexport type PagingDirection = (typeof directions)[number];\n\nconst animationStates = ['started', 'finished', 'interrupted'] as const;\n\nexport type AnimationState = (typeof animationStates)[number];\n\nexport type ItemHeight = number | 'auto';\n\nexport interface RenderItem<T> {\n    (info: { item: T, index: number, interpolation: Animated.AnimatedInterpolation }): ReactElement | null;\n}\n\nexport interface CreateScrollAnimation {\n    (aValue: Animated.AnimatedValue, toValue: number): Animated.CompositeAnimation;\n}\n\nexport interface CreateItemStyle {\n    (itemInterpolation: Animated.AnimatedInterpolation, itemWidth: number): Animated.AnimatedProps<ViewProps['style']>;\n}\n\nexport interface GetCurrentIndex {\n    (): number;\n}\n\nexport interface OnIndexChange {\n    (itemIndex: number): void;\n}\n\nexport interface OnPositionChange {\n    (position: number): void;\n}\n\nexport interface IndexController {\n    getCurrentIndex: GetCurrentIndex;\n    lastIndex: number;\n    notifyAnimationState: (state: AnimationState) => void;\n    notifyOffsetHasChanged: (offset: number) => void;\n}\n\nexport type PagingAnimationType = 'directional' | 'index';\n\nexport interface BasePagingAnimationConfig {\n    animated?: boolean;\n}\n\nexport interface DirectionalPagingAnimationConfig extends BasePagingAnimationConfig {\n    direction: PagingDirection;\n    isOriginatedFromGesture?: boolean;\n}\n\nexport interface IndexPagingAnimationConfig extends BasePagingAnimationConfig {\n    index: number;\n}\n\nexport type PagingAnimationConfig = DirectionalPagingAnimationConfig | IndexPagingAnimationConfig;\n\nexport interface StartPagingAnimation {\n    (type: PagingAnimationType, config: PagingAnimationConfig): void;\n}\n\nexport type VisibleIndexRanges = Array<[number, number]>;\n\nexport interface StoreSubscription {\n    (): void;\n}\n\nexport interface ItemVisibilityStore {\n    dispatch: (ranges: VisibleIndexRanges) => void;\n    subscribe: (listener: (ranges: VisibleIndexRanges) => void) => StoreSubscription;\n    removeAllListeners: () => void;\n}\n\nexport interface AutoplayController {\n    pause: () => void;\n    resume: () => void;\n}\n\nexport interface ScrollToOption {\n    index: number;\n    animated?: boolean;\n}\n\nexport interface CarouselInstance {\n    /**\n     * Get current visible item index.\n     */\n    getCurrentIndex: GetCurrentIndex;\n\n    /**\n     * Scroll to next visible item.\n     */\n    next: () => void;\n\n    /**\n     * Scroll to previous visible item.\n     */\n    prev: () => void;\n\n    /**\n     * Scroll to desired indexed item.\n     * Invalid index is ignored.\n     */\n    scrollTo: (option: ScrollToOption) => void;\n}\n"],"mappings":"AAGA,MAAMA,UAAU,GAAG,CAAC,MAAD,EAAS,MAAT,EAAiB,MAAjB,CAAnB;AAIA,MAAMC,eAAe,GAAG,CAAC,SAAD,EAAY,UAAZ,EAAwB,aAAxB,CAAxB"}
+{"version":3,"names":["directions","scrollStates"],"sources":["types.ts"],"sourcesContent":["import type { ReactElement } from 'react';\nimport type { Animated, ViewProps } from 'react-native';\n\nconst directions = ['next', 'prev', 'stay'] as const;\n\nexport type PagingDirection = (typeof directions)[number];\n\nconst scrollStates = ['idle', 'dragging', 'interrupted'] as const;\n\nexport type ScrollState = (typeof scrollStates)[number];\n\nexport type ItemHeight = number | 'auto';\n\nexport interface RenderItem<T> {\n    (info: { item: T, index: number, interpolation: Animated.AnimatedInterpolation }): ReactElement | null;\n}\n\nexport interface CreateScrollAnimation {\n    (aValue: Animated.AnimatedValue, toValue: number): Animated.CompositeAnimation;\n}\n\nexport interface CreateItemStyle {\n    (itemInterpolation: Animated.AnimatedInterpolation, itemWidth: number): Animated.AnimatedProps<ViewProps['style']>;\n}\n\nexport interface GetCurrentIndex {\n    (): number;\n}\n\nexport interface OnIndexChange {\n    (itemIndex: number): void;\n}\n\nexport interface OnPositionChange {\n    (position: number): void;\n}\n\nexport interface ScrollStateChangeEvent {\n    offset: number;\n    state: ScrollState;\n}\n\nexport interface IndexController {\n    getCurrentIndex: GetCurrentIndex;\n    lastIndex: number;\n    notifyScrollStateHasChanged: (event: ScrollStateChangeEvent) => void;\n}\n\nexport type PagingAnimationType = 'directional' | 'index';\n\nexport interface BasePagingAnimationConfig {\n    animated?: boolean;\n    lastGestureTranslationX?: number;\n}\n\nexport interface DirectionalPagingAnimationConfig extends BasePagingAnimationConfig {\n    direction: PagingDirection;\n    isOriginatedFromGesture?: boolean;\n}\n\nexport interface IndexPagingAnimationConfig extends BasePagingAnimationConfig {\n    index: number;\n}\n\nexport type PagingAnimationConfig = DirectionalPagingAnimationConfig | IndexPagingAnimationConfig;\n\nexport interface StartPagingAnimation {\n    (type: PagingAnimationType, config: PagingAnimationConfig): void;\n}\n\nexport type VisibleIndexRanges = Array<[number, number]>;\n\nexport interface StoreSubscription {\n    (): void;\n}\n\nexport interface ItemVisibilityStore {\n    dispatch: (ranges: VisibleIndexRanges) => void;\n    subscribe: (listener: (ranges: VisibleIndexRanges) => void) => StoreSubscription;\n    removeAllListeners: () => void;\n}\n\nexport interface AutoplayController {\n    pause: () => void;\n    resume: () => void;\n}\n\nexport interface ScrollToOption {\n    index: number;\n    animated?: boolean;\n}\n\nexport interface CarouselInstance {\n    /**\n     * Get current visible item index.\n     */\n    getCurrentIndex: GetCurrentIndex;\n\n    /**\n     * Scroll to next visible item.\n     */\n    next: () => void;\n\n    /**\n     * Scroll to previous visible item.\n     */\n    prev: () => void;\n\n    /**\n     * Scroll to desired indexed item.\n     * Invalid index is ignored.\n     */\n    scrollTo: (option: ScrollToOption) => void;\n}\n"],"mappings":"AAGA,MAAMA,UAAU,GAAG,CAAC,MAAD,EAAS,MAAT,EAAiB,MAAjB,CAAnB;AAIA,MAAMC,YAAY,GAAG,CAAC,MAAD,EAAS,UAAT,EAAqB,aAArB,CAArB"}

package/build/typescript/Carousel/components/ScrollViewGesture.d.ts

@@ -4,8 +4,8 @@ import type { AutoplayController, StartPagingAnimation } from '../types';
 export interface ScrollViewGestureProps {
     autoplayController: AutoplayController;
     children: ReactNode;
+    gestureTranslationX: Animated.Value;
     interruptAnimation: () => void;
-    translateX: Animated.Value;
     scrollEnabled: boolean;
     startPagingAnimation: StartPagingAnimation;
 }

package/build/typescript/Carousel/hooks/index.d.ts

@@ -1,5 +1,5 @@
 export { default as useAutoplayController } from './useAutoplayController';
 export { default as useIndexController } from './useIndexController';
 export { default as useLoopedData } from './useLoopedData';
-export { default as usePagingAnimation } from './usePagingAnimation';
+export { default as usePagingAnimator } from './usePagingAnimator';
 export { default as useItemVisibilityStore } from './useItemVisibilityStore';

package/build/typescript/Carousel/hooks/{usePagingAnimation.d.ts → usePagingAnimator.d.ts}

@@ -1,16 +1,17 @@
 import { Animated } from 'react-native';
 import type { CreateScrollAnimation, IndexController, StartPagingAnimation } from '../types';
-export interface PagingAnimationParameters {
+export interface PagingAnimatorConfig {
     createScrollAnimation: CreateScrollAnimation;
     itemWidth: number;
     indexController: IndexController;
+    initialIndex: number;
     loop: boolean;
     numberOfData: number;
-    offsetX: Animated.Value;
-    translateX: Animated.Value;
 }
-export interface UsePagingAnimation {
+export interface PagingAnimator {
+    gestureTranslationX: Animated.Value;
+    globalInterpolation: Animated.AnimatedInterpolation;
     interruptAnimation: () => void;
     startPagingAnimation: StartPagingAnimation;
 }
-export default function usePagingAnimation(params: PagingAnimationParameters): UsePagingAnimation;
+export default function usePagingAnimator(config: PagingAnimatorConfig): PagingAnimator;

package/build/typescript/Carousel/types.d.ts

@@ -2,8 +2,8 @@ import type { ReactElement } from 'react';
 import type { Animated, ViewProps } from 'react-native';
 declare const directions: readonly ["next", "prev", "stay"];
 export declare type PagingDirection = (typeof directions)[number];
-declare const animationStates: readonly ["started", "finished", "interrupted"];
-export declare type AnimationState = (typeof animationStates)[number];
+declare const scrollStates: readonly ["idle", "dragging", "interrupted"];
+export declare type ScrollState = (typeof scrollStates)[number];
 export declare type ItemHeight = number | 'auto';
 export interface RenderItem<T> {
     (info: {
@@ -27,15 +27,19 @@ export interface OnIndexChange {
 export interface OnPositionChange {
     (position: number): void;
 }
+export interface ScrollStateChangeEvent {
+    offset: number;
+    state: ScrollState;
+}
 export interface IndexController {
     getCurrentIndex: GetCurrentIndex;
     lastIndex: number;
-    notifyAnimationState: (state: AnimationState) => void;
-    notifyOffsetHasChanged: (offset: number) => void;
+    notifyScrollStateHasChanged: (event: ScrollStateChangeEvent) => void;
 }
 export declare type PagingAnimationType = 'directional' | 'index';
 export interface BasePagingAnimationConfig {
     animated?: boolean;
+    lastGestureTranslationX?: number;
 }
 export interface DirectionalPagingAnimationConfig extends BasePagingAnimationConfig {
     direction: PagingDirection;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fountain-ui/lab",
-  "version": "2.0.0-beta.17",
+  "version": "2.0.0-beta.18",
   "private": false,
   "author": "Fountain-UI Team",
   "description": "Incubator for Fountain-UI React components.",
@@ -70,5 +70,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "973591c61fab2561cea9f30d03e802a24817b5f8"
+  "gitHead": "8ca13c00c2424b287a26c7cb62619c2c0a9596df"
 }

package/src/Carousel/Carousel.tsx

@@ -1,5 +1,4 @@
-import React, { forwardRef, memo, useImperativeHandle, useMemo, useRef } from 'react';
-import { Animated } from 'react-native';
+import React, { forwardRef, memo, useImperativeHandle, useMemo } from 'react';
 import ViewabilityTrackerView from '../ViewabilityTrackerView';
 import type CarouselProps from './CarouselProps';
 import type { CarouselInstance } from './types';
@@ -8,7 +7,7 @@ import {
     useIndexController,
     useItemVisibilityStore,
     useLoopedData,
-    usePagingAnimation,
+    usePagingAnimator,
 } from './hooks';
 import { createDefaultItemStyle, createDefaultScrollAnimation } from './animation';
 import { InternalContext, RootView, ScrollViewGesture } from './components';
@@ -34,11 +33,6 @@ const Carousel = forwardRef<CarouselInstance, CarouselProps>(function Carousel(p
 
     const data = useLoopedData(originalData, loop);
 
-    const initialTx = itemWidth * initialIndex;
-    const offsetX = useRef(new Animated.Value(initialTx)).current;
-    const translateX = useRef(new Animated.Value(0)).current;
-    const globalInterpolation = Animated.add(offsetX, translateX);
-
     const [itemVisibilityStore, onPositionChange] = useItemVisibilityStore({
         initialIndex,
         numberOfData: data.length,
@@ -57,16 +51,17 @@ const Carousel = forwardRef<CarouselInstance, CarouselProps>(function Carousel(p
     const { getCurrentIndex } = indexController;
 
     const {
+        gestureTranslationX,
+        globalInterpolation,
         interruptAnimation,
         startPagingAnimation,
-    } = usePagingAnimation({
+    } = usePagingAnimator({
         createScrollAnimation,
         itemWidth,
         indexController,
+        initialIndex,
         loop,
         numberOfData: data.length,
-        offsetX,
-        translateX,
     });
 
     const autoplayController = useAutoplayController({
@@ -119,8 +114,8 @@ const Carousel = forwardRef<CarouselInstance, CarouselProps>(function Carousel(p
             >
                 <ScrollViewGesture
                     autoplayController={autoplayController}
+                    gestureTranslationX={gestureTranslationX}
                     interruptAnimation={interruptAnimation}
-                    translateX={translateX}
                     scrollEnabled={scrollEnabled}
                     startPagingAnimation={startPagingAnimation}
                 >

package/src/Carousel/components/ScrollViewGesture.tsx

@@ -8,8 +8,8 @@ import type { AutoplayController, PagingDirection, StartPagingAnimation } from '
 export interface ScrollViewGestureProps {
     autoplayController: AutoplayController;
     children: ReactNode;
+    gestureTranslationX: Animated.Value,
     interruptAnimation: () => void;
-    translateX: Animated.Value,
     scrollEnabled: boolean;
     startPagingAnimation: StartPagingAnimation;
 }
@@ -40,7 +40,7 @@ export default function ScrollViewGesture(props: ScrollViewGestureProps) {
         autoplayController,
         children,
         interruptAnimation,
-        translateX,
+        gestureTranslationX,
         scrollEnabled,
         startPagingAnimation,
     } = props;
@@ -54,7 +54,7 @@ export default function ScrollViewGesture(props: ScrollViewGestureProps) {
     }, [interruptAnimation, pauseAutoplay]);
 
     const handleGestureEvent = useCallback(Animated.event(
-        [{ nativeEvent: { translationX: translateX } }],
+        [{ nativeEvent: { translationX: gestureTranslationX } }],
         { useNativeDriver: true },
     ), []);
 
@@ -68,7 +68,11 @@ export default function ScrollViewGesture(props: ScrollViewGestureProps) {
 
             startPagingAnimation(
                 'directional',
-                { direction: direction, isOriginatedFromGesture: true },
+                {
+                    direction: direction,
+                    isOriginatedFromGesture: true,
+                    lastGestureTranslationX: translationX,
+                },
             );
 
             resumeAutoplay();

package/src/Carousel/hooks/index.ts

@@ -1,5 +1,5 @@
 export { default as useAutoplayController } from './useAutoplayController';
 export { default as useIndexController } from './useIndexController';
 export { default as useLoopedData } from './useLoopedData';
-export { default as usePagingAnimation } from './usePagingAnimation';
+export { default as usePagingAnimator } from './usePagingAnimator';
 export { default as useItemVisibilityStore } from './useItemVisibilityStore';

package/src/Carousel/hooks/useIndexController.tsx

@@ -1,7 +1,7 @@
 import { useCallback } from 'react';
 import { useImperativeState } from '@fountain-ui/core';
 import { mod } from '@fountain-ui/utils';
-import type { AnimationState, IndexController } from '../types';
+import type { IndexController, ScrollStateChangeEvent } from '../types';
 
 export interface UseIndexControllerParameters {
     initialIndex: number;
@@ -25,41 +25,33 @@ export default function useIndexController(params: UseIndexControllerParameters)
     const currentIndex = useImperativeState(initialIndex);
     const currentPosition = useImperativeState(initialIndex);
 
-    const notifyAnimationState = useCallback((state: AnimationState) => {
-        if (state === 'finished' || state === 'interrupted') {
+    const notifyScrollStateHasChanged = useCallback(({ offset, state }: ScrollStateChangeEvent) => {
+        const normalized = -Math.round(offset / itemWidth);
+        const index = Math.floor(mod(normalized, numberOfOriginalData));
+        const position = Math.floor(mod(normalized, numberOfData));
+
+        if (state === 'idle' || state === 'interrupted') {
             if (currentIndex.hasChanged()) {
                 onIndexChange?.(currentIndex.get());
             }
-
             if (currentPosition.hasChanged()) {
                 onPositionChange?.(currentPosition.get());
             }
         }
-    }, [
-        onIndexChange,
-        onPositionChange,
-    ]);
-
-    const notifyOffsetHasChanged = useCallback((offset: number) => {
-        const roundedOffset = Math.round(offset / itemWidth) * itemWidth;
-
-        // To prevent floating point problem, make sure index is integer type.
-        const nextIndex = Math.floor(mod((-roundedOffset / itemWidth), numberOfOriginalData));
-        currentIndex.set(nextIndex);
 
-        // To prevent floating point problem, make sure index is integer type.
-        const nextPosition = Math.floor(mod((-roundedOffset / itemWidth), numberOfData));
-        currentPosition.set(nextPosition);
+        currentIndex.set(index);
+        currentPosition.set(position);
     }, [
         itemWidth,
         numberOfData,
         numberOfOriginalData,
+        onIndexChange,
+        onPositionChange,
     ]);
 
     return {
         getCurrentIndex: currentIndex.get,
         lastIndex: numberOfOriginalData - 1,
-        notifyAnimationState,
-        notifyOffsetHasChanged,
+        notifyScrollStateHasChanged,
     };
 };