expo-scroll-forwarder 0.1.0

package/.eslintrc.js

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

package/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## Unpublished
+
+### 🛠 Breaking changes
+
+### 🎉 New features
+
+### 🐛 Bug fixes
+
+### 💡 Others

package/README.md

@@ -0,0 +1,182 @@
+# 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/) 🚀

package/android/build.gradle

@@ -0,0 +1,51 @@
+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
+  }
+}
+
+repositories {
+  mavenCentral()
+}
+
+dependencies {
+  implementation "androidx.core:core-ktx:1.10.1"
+}

package/android/src/main/AndroidManifest.xml

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

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

@@ -0,0 +1,16 @@
+package expo.modules.scrollforwarder
+
+import expo.modules.kotlin.modules.Module
+import expo.modules.kotlin.modules.ModuleDefinition
+
+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

@@ -0,0 +1,229 @@
+package expo.modules.scrollforwarder
+
+import android.animation.ValueAnimator
+import android.content.Context
+import android.view.GestureDetector
+import android.view.MotionEvent
+import android.view.View
+import android.view.ViewGroup
+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.viewevent.EventDispatcher
+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 = ev.getHistoricalX(0)
+          val initialY = ev.getHistoricalY(0)
+          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.scrollY = 0
+        }
+        return true
+      }
+      
+      MotionEvent.ACTION_MOVE -> {
+        val deltaY = (lastY - event.rawY).toInt()
+        val newOffset = dampenOffset(initialScrollY + deltaY)
+        
+        scrollView.scrollY = 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 -> {
+            if (startOffset <= 1) {
+              scrollView.smoothScrollTo(0, 0)
+            } else {
+              scrollView.scrollY = 0
+            }
+            cancel()
+          }
+          else -> {
+            scrollView.scrollY = 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) {
+    // Find RefreshControl if it exists
+    for (i in 0 until scrollView.childCount) {
+      val child = scrollView.getChildAt(i)
+      // React Native's RefreshControl detection
+      if (child.javaClass.simpleName.contains("RefreshControl")) {
+        try {
+          val method = child.javaClass.getMethod("setRefreshing", Boolean::class.java)
+          method.invoke(child, true)
+        } catch (e: Exception) {
+          // RefreshControl not available or different implementation
+        }
+        break
+      }
+    }
+  }
+
+  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

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

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

@@ -0,0 +1 @@
+{"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

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

package/build/ExpoScrollForwarder.types.js.map

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

package/build/ExpoScrollForwarderView.android.d.ts

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

package/build/ExpoScrollForwarderView.android.d.ts.map

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

package/build/ExpoScrollForwarderView.android.js

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

package/build/ExpoScrollForwarderView.android.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoScrollForwarderView.android.js","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.android.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAI7D,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\";\r\n\r\nimport { type ExpoScrollForwarderViewProps } from \"./ExpoScrollForwarder.types\";\r\n\r\nconst NativeView: React.ComponentType<ExpoScrollForwarderViewProps> =\r\n  requireNativeViewManager(\"ExpoScrollForwarder\");\r\n\r\nexport function ExpoScrollForwarderView({\r\n  children,\r\n  ...rest\r\n}: ExpoScrollForwarderViewProps) {\r\n  return <NativeView {...rest}>{children}</NativeView>;\r\n}\r\n"]}

package/build/ExpoScrollForwarderView.d.ts

@@ -0,0 +1,3 @@
+import { type ExpoScrollForwarderViewProps } from './ExpoScrollForwarder.types';
+export declare function ExpoScrollForwarderView({ children, }: React.PropsWithChildren<ExpoScrollForwarderViewProps>): import("react").ReactNode;
+//# sourceMappingURL=ExpoScrollForwarderView.d.ts.map

package/build/ExpoScrollForwarderView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoScrollForwarderView.d.ts","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,KAAK,4BAA4B,EAAC,MAAM,6BAA6B,CAAA;AAE7E,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,GACT,EAAE,KAAK,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,6BAEvD"}

package/build/ExpoScrollForwarderView.ios.d.ts

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

package/build/ExpoScrollForwarderView.ios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoScrollForwarderView.ios.d.ts","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.ios.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAC,KAAK,4BAA4B,EAAC,MAAM,6BAA6B,CAAA;AAK7E,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,GAAG,IAAI,EACR,EAAE,4BAA4B,+BAE9B"}

package/build/ExpoScrollForwarderView.ios.js

@@ -0,0 +1,6 @@
+import { requireNativeViewManager } from 'expo-modules-core';
+const NativeView = requireNativeViewManager('ExpoScrollForwarder');
+export function ExpoScrollForwarderView({ children, ...rest }) {
+    return <NativeView {...rest}>{children}</NativeView>;
+}
+//# sourceMappingURL=ExpoScrollForwarderView.ios.js.map

package/build/ExpoScrollForwarderView.ios.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoScrollForwarderView.ios.js","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.ios.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAC,wBAAwB,EAAC,MAAM,mBAAmB,CAAA;AAI1D,MAAM,UAAU,GACd,wBAAwB,CAAC,qBAAqB,CAAC,CAAA;AAEjD,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,CAAA;AACtD,CAAC","sourcesContent":["import {requireNativeViewManager} from 'expo-modules-core'\r\n\r\nimport {type ExpoScrollForwarderViewProps} from './ExpoScrollForwarder.types'\r\n\r\nconst NativeView: React.ComponentType<ExpoScrollForwarderViewProps> =\r\n  requireNativeViewManager('ExpoScrollForwarder')\r\n\r\nexport function ExpoScrollForwarderView({\r\n  children,\r\n  ...rest\r\n}: ExpoScrollForwarderViewProps) {\r\n  return <NativeView {...rest}>{children}</NativeView>\r\n}\r\n"]}

package/build/ExpoScrollForwarderView.js

@@ -0,0 +1,4 @@
+export function ExpoScrollForwarderView({ children, }) {
+    return children;
+}
+//# sourceMappingURL=ExpoScrollForwarderView.js.map

package/build/ExpoScrollForwarderView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExpoScrollForwarderView.js","sourceRoot":"","sources":["../src/ExpoScrollForwarderView.tsx"],"names":[],"mappings":"AAEA,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,GAC8C;IACtD,OAAO,QAAQ,CAAA;AACjB,CAAC","sourcesContent":["import {type ExpoScrollForwarderViewProps} from './ExpoScrollForwarder.types'\r\n\r\nexport function ExpoScrollForwarderView({\r\n  children,\r\n}: React.PropsWithChildren<ExpoScrollForwarderViewProps>) {\r\n  return children\r\n}\r\n"]}

package/build/index.d.ts

@@ -0,0 +1,3 @@
+export { ExpoScrollForwarderView } from "./ExpoScrollForwarderView";
+export type { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

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

package/build/index.js

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

package/build/index.js.map

@@ -0,0 +1 @@
+{"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\";\nexport type { ExpoScrollForwarderViewProps } from \"./ExpoScrollForwarder.types\";\n"]}

package/expo-module.config.json

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

package/ios/ExpoScrollForwarder.podspec

@@ -0,0 +1,29 @@
+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/ios/ExpoScrollForwarderModule.swift

@@ -0,0 +1,48 @@
+import ExpoModulesCore
+
+public class ExpoScrollForwarderModule: Module {
+  // Each module class must implement the definition function. The definition consists of components
+  // that describes the module's functionality and behavior.
+  // See https://docs.expo.dev/modules/module-api for more details about available components.
+  public func definition() -> ModuleDefinition {
+    // Sets the name of the module that JavaScript code will use to refer to the module. Takes a string as an argument.
+    // Can be inferred from module's class name, but it's recommended to set it explicitly for clarity.
+    // The module will be accessible from `requireNativeModule('ExpoScrollForwarder')` in JavaScript.
+    Name("ExpoScrollForwarder")
+
+    // Defines constant property on the module.
+    Constant("PI") {
+      Double.pi
+    }
+
+    // Defines event names that the module can send to JavaScript.
+    Events("onChange")
+
+    // Defines a JavaScript synchronous function that runs the native code on the JavaScript thread.
+    Function("hello") {
+      return "Hello world! 👋"
+    }
+
+    // Defines a JavaScript function that always returns a Promise and whose native code
+    // is by default dispatched on the different thread than the JavaScript runtime runs on.
+    AsyncFunction("setValueAsync") { (value: String) in
+      // Send an event to JavaScript.
+      self.sendEvent("onChange", [
+        "value": value
+      ])
+    }
+
+    // Enables the module to be used as a native view. Definition components that are accepted as part of the
+    // view definition: Prop, Events.
+    View(ExpoScrollForwarderView.self) {
+      // Defines a setter for the `url` prop.
+      Prop("url") { (view: ExpoScrollForwarderView, url: URL) in
+        if view.webView.url != url {
+          view.webView.load(URLRequest(url: url))
+        }
+      }
+
+      Events("onLoad")
+    }
+  }
+}

package/ios/ExpoScrollForwarderView.swift

@@ -0,0 +1,38 @@
+import ExpoModulesCore
+import WebKit
+
+// 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 {
+  let webView = WKWebView()
+  let onLoad = EventDispatcher()
+  var delegate: WebViewDelegate?
+
+  required init(appContext: AppContext? = nil) {
+    super.init(appContext: appContext)
+    clipsToBounds = true
+    delegate = WebViewDelegate { url in
+      self.onLoad(["url": url])
+    }
+    webView.navigationDelegate = delegate
+    addSubview(webView)
+  }
+
+  override func layoutSubviews() {
+    webView.frame = bounds
+  }
+}
+
+class WebViewDelegate: NSObject, WKNavigationDelegate {
+  let onUrlChange: (String) -> Void
+
+  init(onUrlChange: @escaping (String) -> Void) {
+    self.onUrlChange = onUrlChange
+  }
+
+  func webView(_ webView: WKWebView, didFinish navigation: WKNavigation) {
+    if let url = webView.url {
+      onUrlChange(url.absoluteString)
+    }
+  }
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "expo-scroll-forwarder",
+  "version": "0.1.0",
+  "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 Nafi <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": "*"
+  },
+  "packageManager": "yarn@1.22.22+sha512.a6b2f7906b721bba3d67d4aff083df04dad64c399707841b7acf00f6b133b7ac24255f2652fa22ae3534329dc6180534e98d17432037ff6fd140556e2bb3137e"
+}

package/src/ExpoScrollForwarder.types.ts

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

package/src/ExpoScrollForwarderView.android.tsx

@@ -0,0 +1,13 @@
+import { requireNativeViewManager } from "expo-modules-core";
+
+import { type 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.ios.tsx

@@ -0,0 +1,13 @@
+import {requireNativeViewManager} from 'expo-modules-core'
+
+import {type 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

@@ -0,0 +1,7 @@
+import {type ExpoScrollForwarderViewProps} from './ExpoScrollForwarder.types'
+
+export function ExpoScrollForwarderView({
+  children,
+}: React.PropsWithChildren<ExpoScrollForwarderViewProps>) {
+  return children
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { ExpoScrollForwarderView } from "./ExpoScrollForwarderView";
+export type { ExpoScrollForwarderViewProps } from "./ExpoScrollForwarder.types";

package/tsconfig.json

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