Skip to content

Release 3.3.0

Choose a tag to compare

View all tags
@eds2002 eds2002 released this 14 Feb 01:27
· 44 commits to main since this release
v3.3.0
3370474

Changelog

3.3.0 (2026-02-14)

Highlights

  • Introduced snap points and sheet/drawer interactions as a first-class transition model.
  • Promoted after a multi-week beta/rc soak with production validation.
  • Stabilized deep linking, nested gesture behavior, and rapid navigation edge cases.

Major Architecture: Gesture Ownership System

  • Reworked gestures around per-direction ownership with explicit claim, inheritance, and shadowing behavior.
  • Implemented direction-aware ScrollView handoff so nested flows resolve the correct owner per direction.
  • Reduced shadowing delays and race conditions across nested sheets/stacks.
  • Hardened no-dismiss snap flows to prevent invalid zero-target fallback and ancestor leakage.

Features

  • Added snapPoints and initialSnapIndex for sheet-style transitions.
  • Added programmatic snapTo.
  • Added animated snapIndex in ScreenInterpolationProps (available via useScreenAnimation()).
  • Added horizontal snap support (drawers) in addition to vertical sheets.
  • Added snapVelocityImpact for snap-target tuning.
  • Added customizable expand / collapse transition specs.
  • Added backdrop behaviors including collapse.
  • Added backdropComponent for fully custom backdrop rendering/interaction.
  • Added gestureSnapLocked to lock gesture-based snapping at the current point.

Bug Fixes

  • Fixed deep-link/worklet serialization by normalizing deep-link params.
  • Fixed ScrollView ownership resolution to be per-direction (not just per-axis).
  • Fixed multiple gesture race conditions in nested and shadowed sheet scenarios.
  • Fixed ScrollView boundary and bounce-state edge cases for snap interactions.
  • Fixed snapTo behavior in nested layout routes.
  • Fixed stale options ref updates.
  • Fixed optimistic focused index during rapid dismiss chains.
  • Fixed blank-stack background touch leakage during transitions.
  • Fixed bounds refresh/refocus issues and remeasureOnFocus crash.
  • Fixed user onScroll handler composition with transition scroll handlers.
  • Fixed no-dismiss snap edge cases (invalid zero target and ancestor fallback).
  • Fixed overlay default float behavior and optimistic focus sync.
  • Fixed rapid multi-screen spam dismissal edge case.
  • Fixed previous-screen animation during in-flight transitions.

Performance Improvements

  • Reduced JS coordination overhead during push/overlay transitions.

Notes

  • This stable release includes the pre-release train from 3.3.0-beta.0 through 3.3.0-rc.3.
Assets 2
Loading