@onekeyfe/react-native-pager-view 3.0.179-alpha.2026101502 → 3.0.179-alpha.2026101503

package/docs/SPEC.md

@@ -36,7 +36,9 @@ outer PagerView transition
 releases the current edge interaction before moving its shared headers and
 applying visible-page masks; completion or cancellation reattaches the actual
 settled owner. An inactive inner pager retains the external header inset while
-its edge interaction is released.
+its edge interaction is released. Without an outer PagerView, a standalone
+external-overlay pager owns its edge interaction directly; page-activity and
+transition gates apply only while an outer PagerView is registered.
 
 `topOverlayColorScheme` is optional (`"light" | "dark"`) and coordinates the
 fixed overlay's effective appearance with React theme commits. It does not

package/ios/RNCCollapsiblePagerViewComponentView.mm

@@ -2050,6 +2050,7 @@ static void RNCLogNativeTabScrollBoundary(NSString *owner,
   if (@available(iOS 26.0, *)) {
     if (_pendingTopOverlayAppearanceCommit) scrollView = nil;
     BOOL externalOwnerReady = _externalTopOverlayTag <= 0 ||
+      _externalOuterPager == nil ||
       (_externalOuterPageActive && !_externalOuterTransitioning);
     BOOL hasOverlay = _topScrollEdgeHard && self.hasFixedTopOverlay &&
       externalOwnerReady && self.window != nil;

package/ios/tests/RNCCollapsiblePagerHitTestTests.mm

@@ -1,10 +1,15 @@
 #import <XCTest/XCTest.h>
 
 #import "RNCCollapsiblePagerViewComponentView.h"
+#import "RNCPagerViewComponentView.h"
 #import <react/renderer/components/pagerview/Props.h>
 
 using namespace facebook::react;
 
+@interface RNCCollapsiblePagerViewComponentView (ScrollEdgeTesting)
+- (void)updateTopScrollEdgeForScrollView:(UIScrollView *)scrollView;
+@end
+
 @interface RNCCollapsiblePagerHitTestTests : XCTestCase
 @property (nonatomic, strong) UIView *root;
 @property (nonatomic, strong) UIButton *toolbar;
@@ -77,4 +82,48 @@ using namespace facebook::react;
   XCTAssertNil([self.pager hitTest:CGPointMake(20, 90) withEvent:nil]);
 }
 
+- (void)testExternalOverlayWithoutOuterPagerOwnsItsEdgeAndRegisteredOuterStillGates
+{
+  if (@available(iOS 26.0, *)) {
+    UIWindow *window = [[UIWindow alloc] initWithFrame:self.root.bounds];
+    [window addSubview:self.root];
+    UIScrollView *scrollView = [[UIScrollView alloc] initWithFrame:self.pager.bounds];
+    [self.pager addSubview:scrollView];
+    UIScrollEdgeEffectStyle *originalStyle = scrollView.topEdgeEffect.style;
+    [self.pager setValue:@YES forKey:@"topScrollEdgeHard"];
+    [self.pager setValue:@123 forKey:@"externalTopOverlayTag"];
+    [self.pager setValue:@64 forKey:@"externalTopOverlayHeight"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertEqual([self.pager valueForKey:@"topEdgeScrollView"], scrollView);
+    UIScrollEdgeElementContainerInteraction *interaction =
+      [self.pager valueForKey:@"topEdgeInteraction"];
+    XCTAssertEqual(interaction.scrollView, scrollView);
+    UIView *host = [self.pager valueForKey:@"topEdgeInteractionHost"];
+    XCTAssertTrue([host.interactions containsObject:interaction]);
+
+    RNCPagerViewComponentView *outer = [RNCPagerViewComponentView new];
+    [self.pager setValue:outer forKey:@"externalOuterPager"];
+    [self.pager setValue:@NO forKey:@"externalOuterPageActive"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager setValue:@YES forKey:@"externalOuterPageActive"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNotNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager setValue:@YES forKey:@"externalOuterTransitioning"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+
+    [self.pager setValue:nil forKey:@"externalOuterPager"];
+    [self.pager updateTopScrollEdgeForScrollView:scrollView];
+    XCTAssertNotNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    [self.pager removeFromSuperview];
+    XCTAssertNil([self.pager valueForKey:@"topEdgeInteraction"]);
+    XCTAssertNil([self.pager valueForKey:@"topEdgeScrollView"]);
+    XCTAssertEqual(scrollView.topEdgeEffect.style, originalStyle);
+    [self.root removeFromSuperview];
+  } else {
+    XCTSkip(@"Scroll-edge interactions require iOS 26 or newer");
+  }
+}
+
 @end

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@onekeyfe/react-native-pager-view",
-  "version": "3.0.179-alpha.2026101502",
+  "version": "3.0.179-alpha.2026101503",
   "description": "React Native wrapper for Android and iOS ViewPager",
   "source": "./src/index.tsx",
   "main": "./lib/module/index.js",
@@ -72,7 +72,7 @@
     "typescript": "^5.9.2"
   },
   "peerDependencies": {
-    "@onekeyfe/react-native-native-logger": "3.0.179-alpha.2026101502",
+    "@onekeyfe/react-native-native-logger": "3.0.179-alpha.2026101503",
     "react": "*",
     "react-native": "*"
   },