react-native-screen-transitions 3.3.0-beta.2 → 3.3.0-beta.4

package/lib/typescript/shared/utils/gesture/check-gesture-activation.d.ts

@@ -2,6 +2,7 @@ import type { GestureStateManagerType } from "react-native-gesture-handler/lib/t
 import type { SharedValue } from "react-native-reanimated";
 import type { ScrollConfig } from "../../providers/gestures.provider";
 import { type ActivationArea, type GestureActivationArea, GestureOffsetState } from "../../types/gesture.types";
+import type { Direction } from "../../types/ownership.types";
 import type { Layout } from "../../types/screen.types";
 type Directions = {
     vertical: boolean;
@@ -84,26 +85,29 @@ export declare function shouldActivateOrFail(params: ShouldActivateOrFailProps):
  * Since we're using onTouchesMove to activate our pan, faillOffset and activateOffset don't actually work. In that case we'll create this function to use in onTouchesMove which acts simarly to the original functionality.
  */
 export declare const applyOffsetRules: ({ initialTouch, touch, directions, manager, gestureOffsetState, activationArea, dimensions, responseDistance, }: CheckGestureActivationProps) => ReturnValues;
-interface ScrollAwareActivationParams {
-    swipeInfo: {
-        isSwipingDown: boolean;
-        isSwipingUp: boolean;
-        isSwipingRight: boolean;
-        isSwipingLeft: boolean;
-    };
-    directions: Directions;
-    scrollConfig: ScrollConfig | null;
-    hasSnapPoints?: boolean;
-    canExpandMore?: boolean;
-}
-type GestureDirection = "vertical" | "vertical-inverted" | "horizontal" | "horizontal-inverted";
 /**
- * Checks if a gesture should activate based on scroll position.
- * Returns the direction to activate for, or null if activation should not occur.
+ * Checks if a ScrollView is at its boundary for the given swipe direction.
+ * This is a simplified boundary check that respects axis isolation.
+ *
+ * Per the spec:
+ * - A vertical ScrollView never yields to horizontal gestures
+ * - A horizontal ScrollView never yields to vertical gestures
+ * - ScrollView must be at boundary before yielding control
+ *
+ * For snap point sheets, the boundary depends on where the sheet originates from:
+ * - Bottom sheet (vertical): scrollY = 0 (top/base)
+ * - Top sheet (verticalInverted): scrollY >= maxY (bottom/end)
+ * - Right drawer (horizontal): scrollX = 0 (left/base)
+ * - Left drawer (horizontalInverted): scrollX >= maxX (right/end)
+ *
+ * The rule: "when the ScrollView can't scroll any further in the direction
+ * the sheet came from, yield to the gesture."
+ *
+ * @param scrollConfig - The current scroll state
+ * @param direction - The swipe direction to check
+ * @param snapAxisInverted - For snap point sheets, whether the axis is inverted (top sheet / left drawer)
+ * @returns true if at boundary (gesture should activate), false otherwise
  */
-export declare function checkScrollAwareActivation({ swipeInfo, directions, scrollConfig, hasSnapPoints, canExpandMore, }: ScrollAwareActivationParams): {
-    shouldActivate: boolean;
-    direction: GestureDirection | null;
-};
+export declare function checkScrollBoundary(scrollConfig: ScrollConfig | null, direction: Direction, snapAxisInverted?: boolean): boolean;
 export {};
 //# sourceMappingURL=check-gesture-activation.d.ts.map

package/lib/typescript/shared/utils/gesture/check-gesture-activation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check-gesture-activation.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/check-gesture-activation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"check-gesture-activation.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/check-gesture-activation.ts"],"names":[],"mappings":"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"}

package/lib/typescript/shared/utils/gesture/compute-claimed-directions.d.ts

@@ -0,0 +1,23 @@
+import type { GestureDirection } from "../../types/gesture.types";
+import { type ClaimedDirections } from "../../types/ownership.types";
+/**
+ * Computes which directions a screen claims ownership of.
+ *
+ * A screen claims a direction when:
+ * 1. gestureEnabled is true AND
+ * 2. gestureDirection includes that direction
+ *
+ * For snap points, both directions on the axis are claimed automatically.
+ * This is because a snap point sheet handles both expand (inverse) and collapse (primary) gestures.
+ *
+ * @param gestureEnabled - Whether gestures are enabled for this screen
+ * @param gestureDirection - The gesture direction(s) configured for this screen
+ * @param hasSnapPoints - Whether this screen has snap points configured
+ * @returns The claimed directions for this screen
+ */
+export declare function computeClaimedDirections(gestureEnabled: boolean, gestureDirection: GestureDirection | GestureDirection[] | undefined, hasSnapPoints: boolean): ClaimedDirections;
+/**
+ * Checks if any direction is claimed.
+ */
+export declare function claimsAnyDirection(claims: ClaimedDirections): boolean;
+//# sourceMappingURL=compute-claimed-directions.d.ts.map

package/lib/typescript/shared/utils/gesture/compute-claimed-directions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute-claimed-directions.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/compute-claimed-directions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EACN,KAAK,iBAAiB,EAGtB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CACvC,cAAc,EAAE,OAAO,EACvB,gBAAgB,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,GAAG,SAAS,EACnE,aAAa,EAAE,OAAO,GACpB,iBAAiB,CAsDnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAOrE"}

package/lib/typescript/shared/utils/gesture/determine-snap-target.d.ts

@@ -5,7 +5,11 @@ interface DetermineSnapTargetProps {
     velocity: number;
     /** Screen dimension along the snap axis (width or height) */
     dimension: number;
-    /** How much velocity affects the snap decision (0-1). Default 0.15 */
+    /**
+     * How much velocity affects the snap decision.
+     * Lower values = more deliberate/iOS-like, higher values = more responsive to flicks.
+     * @default 0.1
+     */
     velocityFactor?: number;
     /** Whether dismiss (progress=0) is allowed. Default true */
     canDismiss?: boolean;

package/lib/typescript/shared/utils/gesture/determine-snap-target.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"determine-snap-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/determine-snap-target.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,yBAAyB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAqB,EACrB,UAAiB,GACjB,EAAE,wBAAwB,GAAG,yBAAyB,CA0CtD"}
+{"version":3,"file":"determine-snap-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/determine-snap-target.ts"],"names":[],"mappings":"AAAA,UAAU,wBAAwB;IACjC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,UAAU,yBAAyB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,EACnC,eAAe,EACf,UAAU,EACV,QAAQ,EACR,SAAS,EACT,cAAoB,EACpB,UAAiB,GACjB,EAAE,wBAAwB,GAAG,yBAAyB,CA0CtD"}

package/lib/typescript/shared/utils/gesture/find-collapse-target.d.ts

@@ -0,0 +1,17 @@
+interface FindCollapseTargetResult {
+    target: number;
+    shouldDismiss: boolean;
+}
+/**
+ * Finds the next lower snap point for backdrop collapse behavior.
+ *
+ * - If above min snap: returns next lower snap point
+ * - If at or below min snap: returns 0 (dismiss) if canDismiss, else stays at min
+ *
+ * @param currentProgress - Current animation progress
+ * @param snapPoints - Array of snap points
+ * @param canDismiss - Whether dismissing is allowed
+ */
+export declare function findCollapseTarget(currentProgress: number, snapPoints: number[], canDismiss: boolean): FindCollapseTargetResult;
+export {};
+//# sourceMappingURL=find-collapse-target.d.ts.map

package/lib/typescript/shared/utils/gesture/find-collapse-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-collapse-target.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/find-collapse-target.ts"],"names":[],"mappings":"AAEA,UAAU,wBAAwB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;CACvB;AAED;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CACjC,eAAe,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,OAAO,GACjB,wBAAwB,CAoB1B"}

package/lib/typescript/shared/utils/gesture/resolve-ownership.d.ts

@@ -0,0 +1,36 @@
+import type { ClaimedDirections } from "../../types/ownership.types";
+import { type DirectionOwnership } from "../../types/ownership.types";
+/**
+ * Minimal interface for ancestor context needed for ownership resolution.
+ * This allows the function to be used without importing the full GestureContextType.
+ */
+export interface AncestorClaimsContext {
+    claimedDirections: ClaimedDirections;
+    ancestorContext: AncestorClaimsContext | null;
+}
+/**
+ * Resolves ownership status for all directions relative to the current screen.
+ *
+ * For each direction:
+ * 1. If the current screen claims it → 'self' (should activate)
+ * 2. Else, walk up ancestors looking for a claim → 'ancestor' (should fail to bubble)
+ * 3. If no one claims it → 'none' (should fail, no gesture response)
+ *
+ * This is computed during render (JS thread) and the result can be safely
+ * used in worklets since it's a plain object.
+ *
+ * @param selfClaims - The directions claimed by the current screen
+ * @param ancestorContext - The ancestor context chain (can be null if no ancestors)
+ * @returns Ownership status for all four directions
+ */
+export declare function resolveOwnership(selfClaims: ClaimedDirections, ancestorContext: AncestorClaimsContext | null): DirectionOwnership;
+/**
+ * Finds the nearest ancestor (or self if isCurrentOwner) that claims any direction.
+ * Used for setting up native gesture relationships.
+ *
+ * @param selfClaimsAny - Whether the current screen claims any direction
+ * @param ancestorContext - The ancestor context chain
+ * @returns The nearest context that claims a direction, or null
+ */
+export declare function findNearestOwner(selfClaimsAny: boolean, ancestorContext: AncestorClaimsContext | null): AncestorClaimsContext | null;
+//# sourceMappingURL=resolve-ownership.d.ts.map

package/lib/typescript/shared/utils/gesture/resolve-ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-ownership.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/resolve-ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAa,MAAM,6BAA6B,CAAC;AAChF,OAAO,EAEN,KAAK,kBAAkB,EAGvB,MAAM,6BAA6B,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACrC,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,eAAe,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC9C;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,gBAAgB,CAC/B,UAAU,EAAE,iBAAiB,EAC7B,eAAe,EAAE,qBAAqB,GAAG,IAAI,GAC3C,kBAAkB,CAYpB;AA4BD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC/B,aAAa,EAAE,OAAO,EACtB,eAAe,EAAE,qBAAqB,GAAG,IAAI,GAC3C,qBAAqB,GAAG,IAAI,CAuB9B"}

package/lib/typescript/shared/utils/gesture/velocity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/velocity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,UAAU,sBAAsB;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;IAC9D,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,gBAAgB,EAAE,OAAO,CAAC;KAC1B,CAAC;CACF;AAgID,eAAO,MAAM,QAAQ;yCAvHuB,MAAM,cAAc,MAAM;wCAa3B,MAAM,aAAa,MAAM;uDAU3C,MAAM,0BACN,MAAM;+FAkB5B,sBAAsB;sDAyDL,MAAM,2BACA,MAAM,cACnB,MAAM,kBACF,MAAM;CAuBtB,CAAC"}
+{"version":3,"file":"velocity.d.ts","sourceRoot":"","sources":["../../../../../src/shared/utils/gesture/velocity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,6BAA6B,EAC7B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAEtE,UAAU,sBAAsB;IAC/B,UAAU,EAAE,iBAAiB,CAAC;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,KAAK,EAAE,uBAAuB,CAAC,6BAA6B,CAAC,CAAC;IAC9D,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9C,UAAU,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,QAAQ,EAAE,OAAO,CAAC;QAClB,gBAAgB,EAAE,OAAO,CAAC;KAC1B,CAAC;CACF;AAyID,eAAO,MAAM,QAAQ;yCAjIuB,MAAM,cAAc,MAAM;wCAa3B,MAAM,aAAa,MAAM;uDAU3C,MAAM,0BACN,MAAM;+FAkB5B,sBAAsB;sDAyDL,MAAM,2BACA,MAAM,cACnB,MAAM,kBACF,MAAM;CAiCtB,CAAC"}

package/package.json

@@ -1,122 +1,123 @@
 {
-  "name": "react-native-screen-transitions",
-  "version": "3.3.0-beta.2",
-  "description": "Easy screen transitions for React Native and Expo",
-  "author": "Ed",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/eds2002/react-native-screen-transitions.git",
-    "directory": "packages/react-native-screen-transitions"
-  },
-  "main": "lib/commonjs/shared/index.js",
-  "module": "lib/module/shared/index.js",
-  "types": "lib/typescript/shared/index.d.ts",
-  "react-native": "src/shared/index",
-  "exports": {
-    ".": {
-      "react-native": "./src/shared/index.ts",
-      "import": "./lib/module/shared/index.js",
-      "require": "./lib/commonjs/shared/index.js",
-      "types": "./lib/typescript/shared/index.d.ts"
-    },
-    "./native-stack": {
-      "react-native": "./src/native-stack/index.ts",
-      "import": "./lib/module/native-stack/index.js",
-      "require": "./lib/commonjs/native-stack/index.js",
-      "types": "./lib/typescript/native-stack/index.d.ts"
-    },
-    "./blank-stack": {
-      "react-native": "./src/blank-stack/index.ts",
-      "import": "./lib/module/blank-stack/index.js",
-      "require": "./lib/commonjs/blank-stack/index.js",
-      "types": "./lib/typescript/blank-stack/index.d.ts"
-    },
-    "./component-stack": {
-      "react-native": "./src/component-stack/index.ts",
-      "import": "./lib/module/component-stack/index.js",
-      "require": "./lib/commonjs/component-stack/index.js",
-      "types": "./lib/typescript/component-stack/index.d.ts"
-    }
-  },
-  "scripts": {
-    "build": "bob build",
-    "lint": "biome check ./src",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run build",
-    "release": "release-it",
-    "release:beta": "release-it --preRelease=beta"
-  },
-  "keywords": [
-    "react-native",
-    "transitions",
-    "animation",
-    "react-navigation",
-    "expo-router",
-    "reanimated"
-  ],
-  "files": [
-    "lib",
-    "src",
-    "README.md",
-    "LICENSE"
-  ],
-  "peerDependencies": {
-    "@react-navigation/elements": ">=2.0.0",
-    "@react-navigation/native": ">=6.0.0",
-    "@react-navigation/native-stack": ">=7.0.0",
-    "@types/react": "*",
-    "@types/react-native": "*",
-    "react": "*",
-    "react-native": "*",
-    "react-native-gesture-handler": ">=2.16.1",
-    "react-native-reanimated": ">=3.16.0 || >=4.0.0-",
-    "react-native-safe-area-context": "*",
-    "react-native-screens": ">=4.4.0"
-  },
-  "devDependencies": {
-    "@release-it/conventional-changelog": "^10.0.1",
-    "@types/react": "~19.1.10",
-    "react-native-builder-bob": "0.39.0",
-    "release-it": "^19.0.4",
-    "typescript": "catalog:"
-  },
-  "react-native-builder-bob": {
-    "source": "src",
-    "output": "lib",
-    "targets": [
-      "commonjs",
-      "module",
-      [
-        "typescript",
-        {
-          "project": "tsconfig.build.json"
-        }
-      ]
-    ]
-  },
-  "release-it": {
-    "git": {
-      "commitMessage": "chore: release ${version}",
-      "tagName": "v${version}",
-      "commitArgs": [
-        "-n"
-      ]
-    },
-    "npm": {
-      "publish": true
-    },
-    "github": {
-      "release": true
-    },
-    "plugins": {
-      "@release-it/conventional-changelog": {
-        "preset": {
-          "name": "angular"
-        },
-        "path": "."
-      }
-    }
-  },
-  "gitHead": "888d4df9936ec0e3b8221bea7cd81115e6301693"
+	"name": "react-native-screen-transitions",
+	"version": "3.3.0-beta.4",
+	"description": "Easy screen transitions for React Native and Expo",
+	"author": "Ed",
+	"license": "MIT",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/eds2002/react-native-screen-transitions.git",
+		"directory": "packages/react-native-screen-transitions"
+	},
+	"main": "lib/commonjs/shared/index.js",
+	"module": "lib/module/shared/index.js",
+	"types": "lib/typescript/shared/index.d.ts",
+	"react-native": "src/shared/index",
+	"exports": {
+		".": {
+			"react-native": "./src/shared/index.ts",
+			"import": "./lib/module/shared/index.js",
+			"require": "./lib/commonjs/shared/index.js",
+			"types": "./lib/typescript/shared/index.d.ts"
+		},
+		"./native-stack": {
+			"react-native": "./src/native-stack/index.ts",
+			"import": "./lib/module/native-stack/index.js",
+			"require": "./lib/commonjs/native-stack/index.js",
+			"types": "./lib/typescript/native-stack/index.d.ts"
+		},
+		"./blank-stack": {
+			"react-native": "./src/blank-stack/index.ts",
+			"import": "./lib/module/blank-stack/index.js",
+			"require": "./lib/commonjs/blank-stack/index.js",
+			"types": "./lib/typescript/blank-stack/index.d.ts"
+		},
+		"./component-stack": {
+			"react-native": "./src/component-stack/index.ts",
+			"import": "./lib/module/component-stack/index.js",
+			"require": "./lib/commonjs/component-stack/index.js",
+			"types": "./lib/typescript/component-stack/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "bob build",
+		"lint": "biome check ./src",
+		"typecheck": "tsc --noEmit",
+		"prepublishOnly": "bun run build",
+		"release": "release-it",
+		"release:beta": "release-it --preRelease=beta"
+	},
+	"keywords": [
+		"react-native",
+		"transitions",
+		"animation",
+		"react-navigation",
+		"expo-router",
+		"reanimated"
+	],
+	"files": [
+		"lib",
+		"src",
+		"!src/**/__tests__",
+		"README.md",
+		"LICENSE"
+	],
+	"peerDependencies": {
+		"@react-navigation/elements": ">=2.0.0",
+		"@react-navigation/native": ">=6.0.0",
+		"@react-navigation/native-stack": ">=7.0.0",
+		"@types/react": "*",
+		"@types/react-native": "*",
+		"react": "*",
+		"react-native": "*",
+		"react-native-gesture-handler": ">=2.16.1",
+		"react-native-reanimated": ">=3.16.0 || >=4.0.0-",
+		"react-native-safe-area-context": "*",
+		"react-native-screens": ">=4.4.0"
+	},
+	"devDependencies": {
+		"@release-it/conventional-changelog": "^10.0.1",
+		"@types/react": "~19.1.10",
+		"react-native-builder-bob": "0.39.0",
+		"release-it": "^19.0.4",
+		"typescript": "catalog:"
+	},
+	"react-native-builder-bob": {
+		"source": "src",
+		"output": "lib",
+		"targets": [
+			"commonjs",
+			"module",
+			[
+				"typescript",
+				{
+					"project": "tsconfig.build.json"
+				}
+			]
+		]
+	},
+	"release-it": {
+		"git": {
+			"commitMessage": "chore: release ${version}",
+			"tagName": "v${version}",
+			"commitArgs": [
+				"-n"
+			]
+		},
+		"npm": {
+			"publish": true
+		},
+		"github": {
+			"release": true
+		},
+		"plugins": {
+			"@release-it/conventional-changelog": {
+				"preset": {
+					"name": "angular"
+				},
+				"path": "."
+			}
+		}
+	},
+	"gitHead": "888d4df9936ec0e3b8221bea7cd81115e6301693"
 }

package/src/shared/animation/snap-to.ts

@@ -1,8 +1,10 @@
+/** biome-ignore-all lint/style/noNonNullAssertion: <Options always exist> */
 import { runOnUI } from "react-native-reanimated";
 import { DefaultSnapSpec } from "../configs/specs";
 import { AnimationStore } from "../stores/animation.store";
 import { HistoryStore } from "../stores/history.store";
 import { animateToProgress } from "../utils/animation/animate-to-progress";
+import { logger } from "../utils/logger";
 
 /**
  * Programmatically snap the currently focused screen to a specific snap point.
@@ -21,25 +23,29 @@ import { animateToProgress } from "../utils/animation/animate-to-progress";
  * ```
  */
 export function snapTo(index: number): void {
-	const recent = HistoryStore.getMostRecent();
+	// Find the most recent screen that has snapPoints defined.
+	// This handles cases where parent screens (e.g., expo-router) register after
+	// ComponentStack screens, but the ComponentStack is what we want to snap.
+	const allHistory = HistoryStore.toArray();
+	const screenWithSnapPoints = allHistory
+		.filter((entry) => {
+			const sp = entry.descriptor.options?.snapPoints;
+			return sp && sp.length > 0;
+		})
+		.pop(); // Last item is most recent (toArray returns oldest-first)
 
-	if (!recent) {
-		console.warn("snapTo: No screen in history");
+	if (!screenWithSnapPoints) {
+		logger.warn("snapTo: No screens with snapPoints in history");
 		return;
 	}
 
-	const { descriptor } = recent;
-	const snapPoints = descriptor.options?.snapPoints;
-
-	if (!snapPoints || snapPoints.length === 0) {
-		console.warn("snapTo: No snapPoints defined on current screen");
-		return;
-	}
+	const { descriptor } = screenWithSnapPoints;
+	const snapPoints = descriptor.options!.snapPoints!;
 
 	const sorted = [...snapPoints].sort((a, b) => a - b);
 
 	if (index < 0 || index >= sorted.length) {
-		console.warn(
+		logger.warn(
 			`snapTo: index ${index} out of bounds (0-${sorted.length - 1})`,
 		);
 		return;

package/src/shared/components/create-transition-aware-component.tsx

@@ -6,7 +6,6 @@ import { GestureDetector } from "react-native-gesture-handler";
 import Animated, { runOnUI, useAnimatedRef } from "react-native-reanimated";
 import { useAssociatedStyles } from "../hooks/animation/use-associated-style";
 import { useScrollRegistry } from "../hooks/gestures/use-scroll-registry";
-import { useGestureContext } from "../providers/gestures.provider";
 import { RegisterBoundsProvider } from "../providers/register-bounds.provider";
 import type { TransitionAwareProps } from "../types/screen.types";
 
@@ -26,33 +25,37 @@ export function createTransitionAwareComponent<P extends object>(
 		React.ComponentRef<typeof Wrapped>,
 		TransitionAwareProps<P>
 	>((props: any, ref) => {
-		const { nativeGesture } = useGestureContext()!;
-		const {
-			scrollHandler,
-			onContentSizeChange,
-			onLayout,
-			onTouchStart,
-			onTouchEnd,
-		} = useScrollRegistry({
-			onScroll: props.onScroll,
-			onContentSizeChange: props.onContentSizeChange,
-			onLayout: props.onLayout,
-			onTouchStart: props.onTouchStart,
-			onTouchEnd: props.onTouchEnd,
-		});
+		// Determine scroll direction from the horizontal prop (standard ScrollView API)
+		const scrollDirection = props.horizontal ? "horizontal" : "vertical";
+
+		// Get scroll handlers and the gesture owner's nativeGesture for this axis
+		const { scrollHandler, onContentSizeChange, onLayout, nativeGesture } =
+			useScrollRegistry({
+				onScroll: props.onScroll,
+				onContentSizeChange: props.onContentSizeChange,
+				onLayout: props.onLayout,
+				direction: scrollDirection,
+			});
+
+		const scrollableComponent = (
+			<AnimatedComponent
+				{...(props as any)}
+				ref={ref}
+				onScroll={scrollHandler}
+				onContentSizeChange={onContentSizeChange}
+				onLayout={onLayout}
+				scrollEventThrottle={props.scrollEventThrottle || 16}
+			/>
+		);
+
+		// If no gesture owner found for this axis, render without GestureDetector
+		if (!nativeGesture) {
+			return scrollableComponent;
+		}
 
 		return (
 			<GestureDetector gesture={nativeGesture}>
-				<AnimatedComponent
-					{...(props as any)}
-					ref={ref}
-					onScroll={scrollHandler}
-					onContentSizeChange={onContentSizeChange}
-					onLayout={onLayout}
-					onTouchStart={onTouchStart}
-					onTouchEnd={onTouchEnd}
-					scrollEventThrottle={props.scrollEventThrottle || 16}
-				/>
+				{scrollableComponent}
 			</GestureDetector>
 		);
 	});