expo-scroll-forwarder 0.1.6 → 1.0.0

package/ExpoScrollForwarder.podspec

@@ -0,0 +1,17 @@
+Pod::Spec.new do |s|
+  s.name         = 'ExpoScrollForwarder'
+  s.version      = '1.0.0'
+  s.summary      = 'Forward scroll gesture from UIView to UIScrollView'
+  s.description  = 'Forward scroll gesture from UIView to UIScrollView'
+  s.author       = 'Sharif Rayhan Nafi'
+  s.homepage     = 'https://github.com/sharifrayhan/expo-scroll-forwarder'
+  s.platforms    = { :ios => '13.4' }
+  s.source       = { git: '', tag: s.version } 
+  s.static_framework = true
+  s.dependency 'ExpoModulesCore'
+  s.pod_target_xcconfig = {
+    'DEFINES_MODULE' => 'YES',
+    'SWIFT_COMPILATION_MODE' => 'wholemodule'
+  }
+  s.source_files = "src/ios/*.{h,m,mm,swift,hpp,cpp}"
+end

package/README.md

@@ -1,182 +1,30 @@
-# expo-scroll-forwarder
-
-A native module for React Native and Expo that forwards scroll gestures from a non-scrollable view to a ScrollView. Perfect for creating sticky headers that can initiate scrolling, or any UI where you want touch gestures on one view to control scrolling in another.
-
-## Features
-
-- ✨ Forward scroll gestures from any view to a ScrollView
-- 📱 Works on both iOS and Android
-- 🎯 Supports pull-to-refresh
-- 🚀 Smooth momentum scrolling with decay animation
-- 💫 Haptic feedback at refresh threshold
-- 🎨 Natural damping for overscroll
-- 👆 Tap to cancel scroll momentum
-
-## Installation
-
-```bash
-npx expo install expo-scroll-forwarder
-```
-
-## Usage
-
-```typescript
-import React, { useRef, useState, useEffect } from "react";
-import { ExpoScrollForwarderView } from "expo-scroll-forwarder";
-import {
-  ScrollView,
-  View,
-  Text,
-  RefreshControl,
-  findNodeHandle,
-} from "react-native";
-
-export default function App() {
-  const scrollViewRef = useRef<ScrollView>(null);
-  const [scrollViewTag, setScrollViewTag] = useState<number | null>(null);
-  const [refreshing, setRefreshing] = useState(false);
-
-  // Get the native tag of the ScrollView
-  useEffect(() => {
-    if (scrollViewRef.current) {
-      const tag = findNodeHandle(scrollViewRef.current);
-      setScrollViewTag(tag);
-    }
-  }, []);
-
-  const onRefresh = () => {
-    setRefreshing(true);
-    setTimeout(() => setRefreshing(false), 2000);
-  };
-
-  return (
-    <>
-      {/* Header that forwards scroll gestures */}
-      <ExpoScrollForwarderView scrollViewTag={scrollViewTag}>
-        <View style={{ padding: 20, backgroundColor: "#6366f1" }}>
-          <Text style={{ color: "white", fontSize: 20 }}>
-            Swipe down here to scroll
-          </Text>
-        </View>
-      </ExpoScrollForwarderView>
-
-      {/* Main ScrollView */}
-      <ScrollView
-        ref={scrollViewRef}
-        refreshControl={
-          <RefreshControl refreshing={refreshing} onRefresh={onRefresh} />
-        }
-      >
-        <View style={{ padding: 20 }}>
-          <Text>Your scrollable content here</Text>
-          {/* Add more content... */}
-        </View>
-      </ScrollView>
-    </>
-  );
-}
-```
-
-## API Reference
-
-### ExpoScrollForwarderView
-
-A view component that forwards scroll gestures to a target ScrollView.
-
-#### Props
-
-| Prop            | Type              | Required | Description                                                                                                        |
-| --------------- | ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------ |
-| `scrollViewTag` | `number \| null`  | Yes      | The native tag of the ScrollView to forward gestures to. Obtain this using `findNodeHandle(scrollViewRef.current)` |
-| `children`      | `React.ReactNode` | Yes      | The content that will capture and forward scroll gestures                                                          |
-
-## How It Works
-
-1. **Get ScrollView Tag**: Use `findNodeHandle()` to get the native tag of your ScrollView
-2. **Wrap Your Header**: Wrap any view in `ExpoScrollForwarderView` and pass the tag
-3. **Gesture Forwarding**: Touch gestures on the wrapped view are forwarded to the ScrollView
-4. **Natural Scrolling**: Includes momentum, damping, and all native scroll behaviors
-
-## Use Cases
-
-- **Collapsible Headers**: Create headers that users can swipe to scroll the content below
-- **Custom Navigation Bars**: Make navigation bars scrollable
-- **Dashboard Cards**: Allow cards or panels to initiate scrolling
-- **Video Player Controls**: Overlay controls that don't block scroll gestures
-- **Chat Input Areas**: Input fields that can still control chat scroll
-
-## Platform Support
-
-- ✅ iOS 13.4+
-- ✅ Android API 21+
-- ✅ Expo SDK 50+
-
-## Example
-
-Check out the [example app](./example) in the repository for a full working demo.
-
-## Technical Details
-
-### iOS Implementation
-
-- Uses `UIPanGestureRecognizer` for gesture detection
-- Custom decay animation with configurable friction
-- Integrates with native `UIScrollView` and `RCTRefreshControl`
-- Prevents conflicts with swipe-back gestures
-
-### Android Implementation
-
-- Uses `GestureDetector` and custom touch event handling
-- `ValueAnimator` for smooth decay animations
-- Integrates with `ReactScrollView` and RefreshControl
-- Proper velocity tracking and momentum calculation
-
-## Troubleshooting
-
-### ScrollView not responding to gestures
-
-Make sure you're correctly getting and setting the `scrollViewTag`:
-
-```typescript
-const tag = findNodeHandle(scrollViewRef.current);
-setScrollViewTag(tag);
-```
-
-### Gestures interfering with other touch handlers
-
-The module automatically handles gesture conflicts, but ensure your view hierarchy is correct - the `ExpoScrollForwarderView` should be a sibling or parent of the ScrollView, not a child.
-
-### Pull-to-refresh not working
-
-Ensure you've added a `RefreshControl` to your ScrollView:
-
-```typescript
-<ScrollView
-  refreshControl={
-    <RefreshControl refreshing={refreshing} onRefresh={onRefresh} />
-  }
->
-```
-
-## Contributing
-
-Contributions are welcome! Please feel free to submit a Pull Request.
-
-## License
-
-MIT © [Sharif Rayhan Nafi](https://github.com/sharifrayhan)
-
-## Author
-
-**Sharif Rayhan Nafi**
-
-- GitHub: [@sharifrayhan](https://github.com/sharifrayhan)
-- Email: sharifrayhan.official@gmail.com
-
-## Acknowledgments
-
-This module was inspired by the scroll forwarding behavior in the Bluesky app
-.
-Special thanks to the Bluesky engineering team — their implementation and user experience provided valuable insight into creating a natural, responsive gesture-forwarding system.
-
-Built with [Expo Modules](https://docs.expo.dev/modules/) 🚀
+# expo-scroll-forwarder
+
+[![npm version](https://img.shields.io/npm/v/expo-scroll-forwarder.svg)](https://www.npmjs.com/package/expo-scroll-forwarder)
+[![license](https://img.shields.io/npm/l/expo-scroll-forwarder.svg)](https://github.com/sharifrayhan/expo-scroll-forwarder/blob/main/LICENSE)
+
+`expo-scroll-forwarder` is an **iOS-only Expo module** that allows you to forward scroll gestures from a native view to a `ScrollView`. This is useful for creating **custom headers, pull-to-refresh areas, or gesture-forwarding components** in React Native and Expo.
+
+> ⚠️ Android support will be added in a future release.
+
+---
+
+## Features
+
+- Forward vertical scroll gestures from a native view to a `ScrollView`.
+- Compatible with Expo modules architecture.
+- Pure iOS implementation using Swift and `ExpoModulesCore`.
+- Works with `ScrollView` and `RefreshControl`.
+- Fully typed with TypeScript for React Native.
+
+---
+
+## Installation
+
+Install the package in your Expo or React Native project:
+
+```bash
+npm install expo-scroll-forwarder
+# or
+yarn add expo-scroll-forwarder
+```

package/expo-module.config.json

@@ -1,9 +1,6 @@
-{
-  "platforms": ["apple", "android"],
-  "apple": {
-    "modules": ["ExpoScrollForwarderModule"]
-  },
-  "android": {
-    "modules": ["expo.modules.scrollforwarder.ExpoScrollForwarderModule"]
-  }
-}
+{
+  "platforms": ["ios"],
+  "ios": {
+    "modules": ["ExpoScrollForwarderModule"]
+  }
+}

package/index.ts

@@ -0,0 +1 @@
+export { ExpoScrollForwarderView } from "./src/ExpoScrollForwarderView";

package/package.json

@@ -1,43 +1,33 @@
-{
-  "name": "expo-scroll-forwarder",
-  "version": "0.1.6",
-  "description": "Forward scroll gestures from any view to a ScrollView in React Native and Expo.",
-  "main": "build/index.js",
-  "types": "build/index.d.ts",
-  "scripts": {
-    "build": "expo-module build",
-    "clean": "expo-module clean",
-    "lint": "expo-module lint",
-    "test": "expo-module test",
-    "prepare": "expo-module prepare",
-    "prepublishOnly": "expo-module prepublishOnly",
-    "expo-module": "expo-module",
-    "open:ios": "xed example/ios",
-    "open:android": "open -a \"Android Studio\" example/android"
-  },
-  "keywords": [
-    "react-native",
-    "expo",
-    "expo-scroll-forwarder",
-    "ExpoScrollForwarder"
-  ],
-  "repository": "https://github.com/sharifrayhan/expo-scroll-forwarder",
-  "bugs": {
-    "url": "https://github.com/sharifrayhan/expo-scroll-forwarder/issues"
-  },
-  "author": "Sharif Rayhan <sharifrayhan.official@gmail.com> (https://github.com/sharifrayhan)",
-  "license": "MIT",
-  "homepage": "https://github.com/sharifrayhan/expo-scroll-forwarder#readme",
-  "dependencies": {},
-  "devDependencies": {
-    "@types/react": "~19.1.0",
-    "expo-module-scripts": "^5.0.7",
-    "expo": "^54.0.18",
-    "react-native": "0.81.5"
-  },
-  "peerDependencies": {
-    "expo": "*",
-    "react": "*",
-    "react-native": "*"
-  }
-}
+{
+  "name": "expo-scroll-forwarder",
+  "version": "1.0.0",
+  "main": "index.ts",
+  "types": "index.ts",
+  "files": [
+    "src",
+    "index.ts",
+    "ExpoScrollForwarder.podspec",
+    "expo-module.config.json"
+  ],
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "expo-modules-core": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.2.0",
+    "@types/react": "^18.2.0",
+    "@types/react-native": "^0.72.0",
+    "expo-modules-core": "*"
+  },
+  "scripts": {
+    "build": "tsc --build"
+  },
+  "keywords": [
+    "expo",
+    "react-native",
+    "scroll",
+    "forwarder",
+    "module"
+  ]
+}

package/src/ExpoScrollForwarder.types.ts

@@ -1,4 +1,4 @@
-export interface ExpoScrollForwarderViewProps {
-  scrollViewTag: number | null
-  children: React.ReactNode
-}
+export interface ExpoScrollForwarderViewProps {
+  scrollViewTag: number | null;
+  children: React.ReactNode;
+}

package/src/ExpoScrollForwarderView.android.tsx

@@ -0,0 +1,8 @@
+import * as React from "react";
+import { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
+
+export function ExpoScrollForwarderView({
+  children,
+}: ExpoScrollForwarderViewProps) {
+  return children; // placeholder for Android
+}

package/src/ExpoScrollForwarderView.ios.tsx

@@ -0,0 +1,13 @@
+import * as React from "react";
+import { requireNativeViewManager } from "expo-modules-core";
+import { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
+
+const NativeView: React.ComponentType<ExpoScrollForwarderViewProps> =
+  requireNativeViewManager("ExpoScrollForwarder");
+
+export function ExpoScrollForwarderView({
+  children,
+  ...rest
+}: ExpoScrollForwarderViewProps) {
+  return <NativeView {...rest}>{children}</NativeView>;
+}

package/src/ExpoScrollForwarderView.tsx

@@ -1,13 +1,8 @@
-import { requireNativeViewManager } from "expo-modules-core";
-import * as React from "react";
-import { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
-
-const NativeView: React.ComponentType<ExpoScrollForwarderViewProps> =
-  requireNativeViewManager("ExpoScrollForwarder");
-
-export function ExpoScrollForwarderView({
-  children,
-  ...rest
-}: ExpoScrollForwarderViewProps) {
-  return <NativeView {...rest}>{children}</NativeView>;
-}
+import * as React from "react";
+import { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
+
+export function ExpoScrollForwarderView({
+  children,
+}: ExpoScrollForwarderViewProps) {
+  return children; // cross-platform fallback
+}

package/{ios → src/ios}/ExpoScrollForwarderModule.swift

@@ -1,13 +1,13 @@
-import ExpoModulesCore
-
-public class ExpoScrollForwarderModule: Module {
-  public func definition() -> ModuleDefinition {
-    Name("ExpoScrollForwarder")
-
-    View(ExpoScrollForwarderView.self) {
-      Prop("scrollViewTag") { (view: ExpoScrollForwarderView, prop: Int) in
-        view.scrollViewTag = prop
-      }
-    }
-  }
-}
+import ExpoModulesCore
+
+public class ExpoScrollForwarderModule: Module {
+  public func definition() -> ModuleDefinition {
+    Name("ExpoScrollForwarder")
+
+    View(ExpoScrollForwarderView.self) {
+      Prop("scrollViewTag") { (view: ExpoScrollForwarderView, prop: Int) in
+        view.scrollViewTag = prop
+      }
+    }
+  }
+}

package/{ios → src/ios}/ExpoScrollForwarderView.swift

@@ -1,221 +1,138 @@
-import ExpoModulesCore
-
-// This view will be used as a native component. Make sure to inherit from `ExpoView`
-// to apply the proper styling (e.g. border radius and shadows).
-class ExpoScrollForwarderView: ExpoView, UIGestureRecognizerDelegate {
-  var scrollViewTag: Int? {
-    didSet {
-      self.tryFindScrollView()
-    }
-  }
-
-  private var rctScrollView: RCTScrollView?
-  private var rctRefreshCtrl: RCTRefreshControl?
-  private var cancelGestureRecognizers: [UIGestureRecognizer]?
-  private var animTimer: Timer?
-  private var initialOffset: CGFloat = 0.0
-  private var didImpact: Bool = false
-
-  required init(appContext: AppContext? = nil) {
-    super.init(appContext: appContext)
-
-    let pg = UIPanGestureRecognizer(target: self, action: #selector(callOnPan(_:)))
-    pg.delegate = self
-    self.addGestureRecognizer(pg)
-
-    let tg = UITapGestureRecognizer(target: self, action: #selector(callOnPress(_:)))
-    tg.isEnabled = false
-    tg.delegate = self
-
-    let lpg = UILongPressGestureRecognizer(target: self, action: #selector(callOnPress(_:)))
-    lpg.minimumPressDuration = 0.01
-    lpg.isEnabled = false
-    lpg.delegate = self
-
-    self.cancelGestureRecognizers = [lpg, tg]
-  }
-
-  // We don't want to recognize the scroll pan gesture and the swipe back gesture together
-  func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
-    if gestureRecognizer is UIPanGestureRecognizer, otherGestureRecognizer is UIPanGestureRecognizer {
-      return false
-    }
-
-    return true
-  }
-
-  // We only want the "scroll" gesture to happen whenever the pan is vertical, otherwise it will
-  // interfere with the native swipe back gesture.
-  override func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
-    guard let gestureRecognizer = gestureRecognizer as? UIPanGestureRecognizer else {
-      return true
-    }
-
-    let velocity = gestureRecognizer.velocity(in: self)
-    return abs(velocity.y) > abs(velocity.x)
-  }
-
-  // This will be used to cancel the scroll animation whenever we tap inside of the header. We don't need another
-  // recognizer for this one.
-  override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
-    self.stopTimer()
-  }
-
-  // This will be used to cancel the animation whenever we press inside of the scroll view. We don't want to change
-  // the scroll view gesture's delegate, so we add an additional recognizer to detect this.
-  @IBAction func callOnPress(_ sender: UITapGestureRecognizer) {
-    self.stopTimer()
-  }
-
-  @IBAction func callOnPan(_ sender: UIPanGestureRecognizer) {
-    guard let rctsv = self.rctScrollView, let sv = rctsv.scrollView else {
-      return
-    }
-
-    let translation = sender.translation(in: self).y
-
-    if sender.state == .began {
-      if sv.contentOffset.y < 0 {
-        sv.contentOffset.y = 0
-      }
-
-      self.initialOffset = sv.contentOffset.y
-    }
-
-    if sender.state == .changed {
-      sv.contentOffset.y = self.dampenOffset(-translation + self.initialOffset)
-
-      if sv.contentOffset.y <= -130, !didImpact {
-        let generator = UIImpactFeedbackGenerator(style: .light)
-        generator.impactOccurred()
-
-        self.didImpact = true
-      }
-    }
-
-    if sender.state == .ended {
-      let velocity = sender.velocity(in: self).y
-      self.didImpact = false
-
-      if sv.contentOffset.y <= -130 {
-        if let ctrl = self.rctRefreshCtrl {
-          if ctrl.responds(to: Selector(("forwarderBeginRefreshing"))) {
-            ctrl.perform(Selector(("forwarderBeginRefreshing")))
-          } else {
-            ctrl.beginRefreshing()
-            ctrl.sendActions(for: .valueChanged)
-          }
-        }
-
-        return
-      }
-
-      // A check for a velocity under 250 prevents animations from occurring when they wouldn't in a normal
-      // scroll view
-      if abs(velocity) < 250, sv.contentOffset.y >= 0 {
-        return
-      }
-
-      self.startDecayAnimation(translation, velocity)
-    }
-  }
-
-  func startDecayAnimation(_ translation: CGFloat, _ velocity: CGFloat) {
-    guard let sv = self.rctScrollView?.scrollView else {
-      return
-    }
-
-    var velocity = velocity
-
-    self.enableCancelGestureRecognizers()
-
-    if velocity > 0 {
-      velocity = min(velocity, 5000)
-    } else {
-      velocity = max(velocity, -5000)
-    }
-
-    var animTranslation = -translation
-    self.animTimer = Timer.scheduledTimer(withTimeInterval: 1.0 / 120, repeats: true) { _ in
-      velocity *= 0.9875
-      animTranslation = (-velocity / 120) + animTranslation
-
-      let nextOffset = self.dampenOffset(animTranslation + self.initialOffset)
-
-      if nextOffset <= 0 {
-        if self.initialOffset <= 1 {
-          self.scrollToOffset(0)
-        } else {
-          sv.contentOffset.y = 0
-        }
-
-        self.stopTimer()
-        return
-      } else {
-        sv.contentOffset.y = nextOffset
-      }
-
-      if abs(velocity) < 5 {
-        self.stopTimer()
-      }
-    }
-  }
-
-  func dampenOffset(_ offset: CGFloat) -> CGFloat {
-    if offset < 0 {
-      return offset - (offset * 0.55)
-    }
-
-    return offset
-  }
-
-  func tryFindScrollView() {
-    guard let scrollViewTag = scrollViewTag else {
-      return
-    }
-
-    // Before we switch to a different scrollview, we always want to remove the cancel gesture recognizer.
-    // Otherwise we might end up with duplicates when we switch back to that scrollview.
-    self.removeCancelGestureRecognizers()
-
-    self.rctScrollView = self.appContext?
-      .findView(withTag: scrollViewTag, ofType: RCTScrollView.self)
-    self.rctRefreshCtrl = self.rctScrollView?.scrollView.refreshControl as? RCTRefreshControl
-
-    self.addCancelGestureRecognizers()
-  }
-
-  func addCancelGestureRecognizers() {
-    self.cancelGestureRecognizers?.forEach { r in
-      self.rctScrollView?.scrollView?.addGestureRecognizer(r)
-    }
-  }
-
-  func removeCancelGestureRecognizers() {
-    self.cancelGestureRecognizers?.forEach { r in
-      self.rctScrollView?.scrollView?.removeGestureRecognizer(r)
-    }
-  }
-
-  func enableCancelGestureRecognizers() {
-    self.cancelGestureRecognizers?.forEach { r in
-      r.isEnabled = true
-    }
-  }
-
-  func disableCancelGestureRecognizers() {
-    self.cancelGestureRecognizers?.forEach { r in
-      r.isEnabled = false
-    }
-  }
-
-  func scrollToOffset(_ offset: Int, animated: Bool = true) {
-    self.rctScrollView?.scroll(toOffset: CGPoint(x: 0, y: offset), animated: animated)
-  }
-
-  func stopTimer() {
-    self.disableCancelGestureRecognizers()
-    self.animTimer?.invalidate()
-    self.animTimer = nil
-  }
-}
+import ExpoModulesCore
+
+class ExpoScrollForwarderView: ExpoView, UIGestureRecognizerDelegate {
+  var scrollViewTag: Int? {
+    didSet {
+      self.tryFindScrollView()
+    }
+  }
+
+  private var rctScrollView: RCTScrollView?
+  private var rctRefreshCtrl: RCTRefreshControl?
+  private var cancelGestureRecognizers: [UIGestureRecognizer]?
+  private var animTimer: Timer?
+  private var initialOffset: CGFloat = 0.0
+  private var didImpact: Bool = false
+
+  required init(appContext: AppContext? = nil) {
+    super.init(appContext: appContext)
+
+    let pg = UIPanGestureRecognizer(target: self, action: #selector(callOnPan(_:)))
+    pg.delegate = self
+    self.addGestureRecognizer(pg)
+
+    let tg = UITapGestureRecognizer(target: self, action: #selector(callOnPress(_:)))
+    tg.isEnabled = false
+    tg.delegate = self
+
+    let lpg = UILongPressGestureRecognizer(target: self, action: #selector(callOnPress(_:)))
+    lpg.minimumPressDuration = 0.01
+    lpg.isEnabled = false
+    lpg.delegate = self
+
+    self.cancelGestureRecognizers = [lpg, tg]
+  }
+
+  func gestureRecognizer(_ gestureRecognizer: UIGestureRecognizer, shouldRecognizeSimultaneouslyWith otherGestureRecognizer: UIGestureRecognizer) -> Bool {
+    if gestureRecognizer is UIPanGestureRecognizer, otherGestureRecognizer is UIPanGestureRecognizer {
+      return false
+    }
+    return true
+  }
+
+  override func gestureRecognizerShouldBegin(_ gestureRecognizer: UIGestureRecognizer) -> Bool {
+    guard let gestureRecognizer = gestureRecognizer as? UIPanGestureRecognizer else {
+      return true
+    }
+    let velocity = gestureRecognizer.velocity(in: self)
+    return abs(velocity.y) > abs(velocity.x)
+  }
+
+  override func touchesBegan(_ touches: Set<UITouch>, with event: UIEvent?) {
+    self.stopTimer()
+  }
+
+  @IBAction func callOnPress(_ sender: UITapGestureRecognizer) {
+    self.stopTimer()
+  }
+
+  @IBAction func callOnPan(_ sender: UIPanGestureRecognizer) {
+    guard let rctsv = self.rctScrollView, let sv = rctsv.scrollView else { return }
+
+    let translation = sender.translation(in: self).y
+
+    if sender.state == .began {
+      if sv.contentOffset.y < 0 { sv.contentOffset.y = 0 }
+      self.initialOffset = sv.contentOffset.y
+    }
+
+    if sender.state == .changed {
+      sv.contentOffset.y = self.dampenOffset(-translation + self.initialOffset)
+      if sv.contentOffset.y <= -130, !didImpact {
+        let generator = UIImpactFeedbackGenerator(style: .light)
+        generator.impactOccurred()
+        self.didImpact = true
+      }
+    }
+
+    if sender.state == .ended {
+      let velocity = sender.velocity(in: self).y
+      self.didImpact = false
+
+      if sv.contentOffset.y <= -130 {
+        self.rctRefreshCtrl?.forwarderBeginRefreshing()
+        return
+      }
+
+      if abs(velocity) < 250, sv.contentOffset.y >= 0 { return }
+      self.startDecayAnimation(translation, velocity)
+    }
+  }
+
+  func startDecayAnimation(_ translation: CGFloat, _ velocity: CGFloat) {
+    guard let sv = self.rctScrollView?.scrollView else { return }
+
+    var velocity = velocity
+    self.enableCancelGestureRecognizers()
+
+    if velocity > 0 { velocity = min(velocity, 5000) }
+    else { velocity = max(velocity, -5000) }
+
+    var animTranslation = -translation
+    self.animTimer = Timer.scheduledTimer(withTimeInterval: 1.0/120, repeats: true) { _ in
+      velocity *= 0.9875
+      animTranslation = (-velocity/120) + animTranslation
+      let nextOffset = self.dampenOffset(animTranslation + self.initialOffset)
+
+      if nextOffset <= 0 {
+        if self.initialOffset <= 1 { self.scrollToOffset(0) }
+        else { sv.contentOffset.y = 0 }
+        self.stopTimer()
+        return
+      } else {
+        sv.contentOffset.y = nextOffset
+      }
+
+      if abs(velocity) < 5 { self.stopTimer() }
+    }
+  }
+
+  func dampenOffset(_ offset: CGFloat) -> CGFloat {
+    return offset < 0 ? offset - (offset*0.55) : offset
+  }
+
+  func tryFindScrollView() {
+    guard let scrollViewTag = scrollViewTag else { return }
+    self.removeCancelGestureRecognizers()
+    self.rctScrollView = self.appContext?.findView(withTag: scrollViewTag, ofType: RCTScrollView.self)
+    self.rctRefreshCtrl = self.rctScrollView?.scrollView.refreshControl as? RCTRefreshControl
+    self.addCancelGestureRecognizers()
+  }
+
+  func addCancelGestureRecognizers() { self.cancelGestureRecognizers?.forEach { r in self.rctScrollView?.scrollView?.addGestureRecognizer(r) } }
+  func removeCancelGestureRecognizers() { self.cancelGestureRecognizers?.forEach { r in self.rctScrollView?.scrollView?.removeGestureRecognizer(r) } }
+  func enableCancelGestureRecognizers() { self.cancelGestureRecognizers?.forEach { r in r.isEnabled = true } }
+  func disableCancelGestureRecognizers() { self.cancelGestureRecognizers?.forEach { r in r.isEnabled = false } }
+  func scrollToOffset(_ offset: Int, animated: Bool = true) { self.rctScrollView?.scroll(toOffset: CGPoint(x:0,y:offset), animated:animated) }
+  func stopTimer() { self.disableCancelGestureRecognizers(); self.animTimer?.invalidate(); self.animTimer=nil }
+}

package/.eslintrc.js

@@ -1,5 +0,0 @@
-module.exports = {
-  root: true,
-  extends: ['universe/native', 'universe/web'],
-  ignorePatterns: ['build'],
-};

package/android/build.gradle

@@ -1,48 +0,0 @@
-apply plugin: 'com.android.library'
-
-group = 'expo.modules.scrollforwarder'
-version = '0.1.0'
-
-def expoModulesCorePlugin = new File(project(":expo-modules-core").projectDir.absolutePath, "ExpoModulesCorePlugin.gradle")
-apply from: expoModulesCorePlugin
-applyKotlinExpoModulesCorePlugin()
-useCoreDependencies()
-useExpoPublishing()
-
-// If you want to use the managed Android SDK versions from expo-modules-core, set this to true.
-// The Android SDK versions will be bumped from time to time in SDK releases and may introduce breaking changes in your module code.
-// Most of the time, you may like to manage the Android SDK versions yourself.
-def useManagedAndroidSdkVersions = false
-if (useManagedAndroidSdkVersions) {
-  useDefaultAndroidSdkVersions()
-} else {
-  buildscript {
-    // Simple helper that allows the root project to override versions declared by this library.
-    ext.safeExtGet = { prop, fallback ->
-      rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
-    }
-  }
-  project.android {
-    compileSdkVersion safeExtGet("compileSdkVersion", 36)
-    defaultConfig {
-      minSdkVersion safeExtGet("minSdkVersion", 24)
-      targetSdkVersion safeExtGet("targetSdkVersion", 36)
-    }
-  }
-}
-
-android {
-  namespace "expo.modules.scrollforwarder"
-  defaultConfig {
-    versionCode 1
-    versionName "0.1.0"
-  }
-  lintOptions {
-    abortOnError false
-  }
-}
-
-// Add the dependencies block here
-dependencies {
-  implementation 'com.facebook.react:react-android'
-}

package/android/src/main/AndroidManifest.xml

@@ -1,2 +0,0 @@
-<manifest>
-</manifest>

package/android/src/main/java/expo/modules/scrollforwarder/ExpoScrollForwarderModule.kt

@@ -1,17 +0,0 @@
-package expo.modules.scrollforwarder
-
-import expo.modules.kotlin.modules.Module
-import expo.modules.kotlin.modules.ModuleDefinition
-import expo.modules.kotlin.views.ExpoView
-
-class ExpoScrollForwarderModule : Module() {
-  override fun definition() = ModuleDefinition {
-    Name("ExpoScrollForwarder")
-
-    View(ExpoScrollForwarderView::class) {
-      Prop("scrollViewTag") { view: ExpoScrollForwarderView, prop: Int ->
-        view.scrollViewTag = prop
-      }
-    }
-  }
-}

package/android/src/main/java/expo/modules/scrollforwarder/ExpoScrollForwarderView.kt

@@ -1,223 +0,0 @@
-package expo.modules.scrollforwarder
-
-import android.animation.ValueAnimator
-import android.content.Context
-import android.view.GestureDetector
-import android.view.MotionEvent
-import android.view.animation.DecelerateInterpolator
-import androidx.core.view.GestureDetectorCompat
-import com.facebook.react.views.scroll.ReactScrollView
-import expo.modules.kotlin.AppContext
-import expo.modules.kotlin.views.ExpoView
-import kotlin.math.abs
-
-class ExpoScrollForwarderView(context: Context, appContext: AppContext) : ExpoView(context, appContext) {
-  
-  var scrollViewTag: Int? = null
-    set(value) {
-      field = value
-      tryFindScrollView()
-    }
-
-  private var reactScrollView: ReactScrollView? = null
-  private var gestureDetector: GestureDetectorCompat
-  private var isScrolling = false
-  private var initialScrollY = 0
-  private var lastY = 0f
-  private var decayAnimator: ValueAnimator? = null
-  private var didImpact = false
-
-  init {
-    gestureDetector = GestureDetectorCompat(context, GestureListener())
-  }
-
-  override fun onInterceptTouchEvent(ev: MotionEvent): Boolean {
-    val scrollView = reactScrollView ?: return super.onInterceptTouchEvent(ev)
-    
-    when (ev.action) {
-      MotionEvent.ACTION_DOWN -> {
-        stopDecayAnimation()
-        lastY = ev.rawY
-        initialScrollY = scrollView.scrollY
-        isScrolling = false
-      }
-      MotionEvent.ACTION_MOVE -> {
-        val deltaY = lastY - ev.rawY
-        
-        // Check if this is a vertical scroll gesture
-        if (!isScrolling && abs(deltaY) > 10) {
-          // Calculate if the gesture is more vertical than horizontal
-          val initialX = if (ev.historySize > 0) ev.getHistoricalX(0) else ev.x
-          val initialY = if (ev.historySize > 0) ev.getHistoricalY(0) else ev.y
-          val deltaX = ev.x - initialX
-          val deltaYCheck = ev.y - initialY
-          
-          if (abs(deltaYCheck) > abs(deltaX)) {
-            isScrolling = true
-            return true
-          }
-        }
-      }
-    }
-    
-    return isScrolling || super.onInterceptTouchEvent(ev)
-  }
-
-  override fun onTouchEvent(event: MotionEvent): Boolean {
-    val scrollView = reactScrollView ?: return super.onTouchEvent(event)
-    
-    gestureDetector.onTouchEvent(event)
-    
-    when (event.action) {
-      MotionEvent.ACTION_DOWN -> {
-        stopDecayAnimation()
-        lastY = event.rawY
-        initialScrollY = scrollView.scrollY
-        if (scrollView.scrollY < 0) {
-          scrollView.scrollTo(0, 0)
-        }
-        return true
-      }
-      
-      MotionEvent.ACTION_MOVE -> {
-        val deltaY = (lastY - event.rawY).toInt()
-        val newOffset = dampenOffset(initialScrollY + deltaY)
-        
-        scrollView.scrollTo(0, newOffset)
-        
-        // Haptic feedback at refresh threshold
-        if (newOffset <= -130 && !didImpact) {
-          performHapticFeedback(android.view.HapticFeedbackConstants.LONG_PRESS)
-          didImpact = true
-        }
-        
-        return true
-      }
-      
-      MotionEvent.ACTION_UP, MotionEvent.ACTION_CANCEL -> {
-        val velocityY = calculateVelocity(event)
-        didImpact = false
-        
-        // Check for pull-to-refresh threshold
-        if (scrollView.scrollY <= -130) {
-          triggerRefresh(scrollView)
-          return true
-        }
-        
-        // Don't animate if velocity is too low and we're at a valid position
-        if (abs(velocityY) < 250 && scrollView.scrollY >= 0) {
-          isScrolling = false
-          return true
-        }
-        
-        startDecayAnimation(scrollView, velocityY.toFloat())
-        isScrolling = false
-        return true
-      }
-    }
-    
-    return super.onTouchEvent(event)
-  }
-
-  private fun calculateVelocity(event: MotionEvent): Int {
-    if (event.historySize == 0) return 0
-    
-    val lastHistoricalY = event.getHistoricalY(event.historySize - 1)
-    val lastHistoricalTime = event.getHistoricalEventTime(event.historySize - 1)
-    val deltaY = event.y - lastHistoricalY
-    val deltaTime = (event.eventTime - lastHistoricalTime) / 1000f
-    
-    return if (deltaTime > 0) {
-      (-deltaY / deltaTime).toInt()
-    } else {
-      0
-    }
-  }
-
-  private fun startDecayAnimation(scrollView: ReactScrollView, velocity: Float) {
-    var currentVelocity = velocity.coerceIn(-5000f, 5000f)
-    val startOffset = scrollView.scrollY
-    var currentOffset = startOffset.toFloat()
-    
-    decayAnimator = ValueAnimator.ofFloat(0f, 1f).apply {
-      duration = 3000
-      interpolator = DecelerateInterpolator()
-      
-      addUpdateListener { animator ->
-        currentVelocity *= 0.9875f
-        currentOffset += (-currentVelocity / 120f)
-        
-        val newOffset = dampenOffset(currentOffset.toInt())
-        
-        when {
-          newOffset <= 0 -> {
-            scrollView.smoothScrollTo(0, 0)
-            cancel()
-          }
-          else -> {
-            scrollView.scrollTo(0, newOffset)
-          }
-        }
-        
-        if (abs(currentVelocity) < 5) {
-          cancel()
-        }
-      }
-    }
-    decayAnimator?.start()
-  }
-
-  private fun dampenOffset(offset: Int): Int {
-    return if (offset < 0) {
-      (offset - (offset * 0.55)).toInt()
-    } else {
-      offset
-    }
-  }
-
-  private fun triggerRefresh(scrollView: ReactScrollView) {
-    // Trigger refresh by finding and activating the refresh control
-    try {
-      for (i in 0 until scrollView.childCount) {
-        val child = scrollView.getChildAt(i)
-        if (child.javaClass.simpleName.contains("Refresh")) {
-          // Try to invoke setRefreshing via reflection
-          val method = child.javaClass.getMethod("setRefreshing", Boolean::class.javaPrimitiveType)
-          method.invoke(child, true)
-          break
-        }
-      }
-    } catch (e: Exception) {
-      // Fallback: just scroll to trigger position
-      scrollView.scrollTo(0, -140)
-    }
-  }
-
-  private fun stopDecayAnimation() {
-    decayAnimator?.cancel()
-    decayAnimator = null
-  }
-
-  private fun tryFindScrollView() {
-    val tag = scrollViewTag ?: return
-    
-    reactScrollView = appContext?.findView(tag) as? ReactScrollView
-  }
-
-  inner class GestureListener : GestureDetector.SimpleOnGestureListener() {
-    override fun onDown(e: MotionEvent): Boolean {
-      stopDecayAnimation()
-      return true
-    }
-
-    override fun onSingleTapUp(e: MotionEvent): Boolean {
-      stopDecayAnimation()
-      return true
-    }
-  }
-
-  override fun onDetachedFromWindow() {
-    super.onDetachedFromWindow()
-    stopDecayAnimation()
-  }
-}

package/build/ExpoScrollForwarder.types.d.ts

@@ -1,5 +0,0 @@
-export interface ExpoScrollForwarderViewProps {
-    scrollViewTag: number | null;
-    children: React.ReactNode;
-}
-//# sourceMappingURL=ExpoScrollForwarder.types.d.ts.map

package/build/ExpoScrollForwarder.types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExpoScrollForwarder.types.d.ts","sourceRoot":"","sources":["../src/ExpoScrollForwarder.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,4BAA4B;IAC3C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAC1B"}

package/build/ExpoScrollForwarder.types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=ExpoScrollForwarder.types.js.map

package/build/ExpoScrollForwarder.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExpoScrollForwarder.types.js","sourceRoot":"","sources":["../src/ExpoScrollForwarder.types.ts"],"names":[],"mappings":"","sourcesContent":["export interface ExpoScrollForwarderViewProps {\n  scrollViewTag: number | null\n  children: React.ReactNode\n}\n"]}

package/build/ExpoScrollForwarderView.d.ts

@@ -1,4 +0,0 @@
-import * as React from "react";
-import { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
-export declare function ExpoScrollForwarderView({ children, ...rest }: ExpoScrollForwarderViewProps): React.JSX.Element;
-//# sourceMappingURL=ExpoScrollForwarderView.d.ts.map

package/build/ExpoScrollForwarderView.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExpoScrollForwarderView.d.ts","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAK3E,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,4BAA4B,qBAE9B"}

package/build/ExpoScrollForwarderView.js

@@ -1,7 +0,0 @@
-import { requireNativeViewManager } from "expo-modules-core";
-import * as React from "react";
-const NativeView = requireNativeViewManager("ExpoScrollForwarder");
-export function ExpoScrollForwarderView({ children, ...rest }) {
-    return <NativeView {...rest}>{children}</NativeView>;
-}
-//# sourceMappingURL=ExpoScrollForwarderView.js.map

package/build/ExpoScrollForwarderView.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ExpoScrollForwarderView.js","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,MAAM,UAAU,GACd,wBAAwB,CAAC,qBAAqB,CAAC,CAAC;AAElD,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,GAAG,IAAI,EACsB;IAC7B,OAAO,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import { requireNativeViewManager } from \"expo-modules-core\";\nimport * as React from \"react\";\nimport { ExpoScrollForwarderViewProps } from \"./ExpoScrollForwarder.types\";\n\nconst NativeView: React.ComponentType<ExpoScrollForwarderViewProps> =\n  requireNativeViewManager(\"ExpoScrollForwarder\");\n\nexport function ExpoScrollForwarderView({\n  children,\n  ...rest\n}: ExpoScrollForwarderViewProps) {\n  return <NativeView {...rest}>{children}</NativeView>;\n}\n"]}

package/build/index.d.ts

@@ -1,2 +0,0 @@
-export { ExpoScrollForwarderView } from "./ExpoScrollForwarderView";
-//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/build/index.js

@@ -1,2 +0,0 @@
-export { ExpoScrollForwarderView } from "./ExpoScrollForwarderView";
-//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC","sourcesContent":["export { ExpoScrollForwarderView } from \"./ExpoScrollForwarderView\";\n"]}

package/ios/ExpoScrollForwarder.podspec

@@ -1,29 +0,0 @@
-require 'json'
-
-package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
-
-Pod::Spec.new do |s|
-  s.name           = 'ExpoScrollForwarder'
-  s.version        = package['version']
-  s.summary        = package['description']
-  s.description    = package['description']
-  s.license        = package['license']
-  s.author         = package['author']
-  s.homepage       = package['homepage']
-  s.platforms      = {
-    :ios => '15.1',
-    :tvos => '15.1'
-  }
-  s.swift_version  = '5.9'
-  s.source         = { git: 'https://github.com/sharifrayhan/expo-scroll-forwarder' }
-  s.static_framework = true
-
-  s.dependency 'ExpoModulesCore'
-
-  # Swift/Objective-C compatibility
-  s.pod_target_xcconfig = {
-    'DEFINES_MODULE' => 'YES',
-  }
-
-  s.source_files = "**/*.{h,m,mm,swift,hpp,cpp}"
-end

package/src/index.ts

@@ -1 +0,0 @@
-export { ExpoScrollForwarderView } from "./ExpoScrollForwarderView";

package/tsconfig.json

@@ -1,9 +0,0 @@
-// @generated by expo-module-scripts
-{
-  "extends": "expo-module-scripts/tsconfig.base",
-  "compilerOptions": {
-    "outDir": "./build"
-  },
-  "include": ["./src"],
-  "exclude": ["**/__mocks__/*", "**/__tests__/*", "**/__rsc_tests__/*"]
-}