- Make UIDesignRequiresCompatibility a sub-section of Disabling Liquid Glass
- Add backgroundColor/backgroundBlur as first option to disable Liquid Glass per-sheet
- Add note about iOS 26.1+ requirement for per-sheet disabling
- Add Apple documentation reference for UIDesignRequiresCompatibility
- Add Liquid Glass info to backgroundColor and backgroundBlur props in configuration
- Move backgroundBlur and blurOptions next to backgroundColor in configuration
* fix(ios): use native backgroundEffect for blur on iOS 26.1+
- Extract blur style mapping into BlurUtil
- Refactor setupBackground and setupGrabber into helper methods
- Add sheet getter for cleaner code
- Use native UIBlurEffect on backgroundEffect when only blurTint is set (iOS 26.1+)
* refactor: rename blurTint to backgroundBlur
- When stackBehavior is 'none', uses regular BottomSheet instead of BottomSheetModal
- Bypasses the modal stack entirely for non-modal sheet behavior
- Updated types, web implementation, and documentation
* docs: add planning doc
* refactor(android): migrate from DialogFragment to CoordinatorLayout
This solves the touch lag issue when TrueSheet is presented over interactive
components like Maps. The sheet now stays in the same activity window instead
of a separate dialog window.
Changes:
- Add TrueSheetCoordinatorLayout to host sheet and dim view
- Add TrueSheetBottomSheetView with BottomSheetBehavior
- Refactor TrueSheetViewController to use CoordinatorLayout approach
- Update TrueSheetDimView for in-hierarchy usage with touch handling
- Remove TrueSheetDialogFragment (no longer needed)
- Remove unused dialog styles and animations
* fix(android): animate sheet on present using BottomSheetBehavior
* fix(android): animate sheet on present when not dismissible
* refactor(android): simplify dismiss animation using ViewPropertyAnimator
* docs: update AGENTS.md with new Android architecture
* fix(android): prevent duplicate initial present on re-mount
* fix(android): fix keyboard handling and parent sheet translation
* fix(android): prevent parent sheet layout reset when keyboard shows
- Add TrueSheetBottomSheetViewDelegate with isTopmostSheet property
- Skip onLayout for parent sheets to prevent BottomSheetBehavior from
resetting translationY during system layout passes
- Refactor TrueSheetCoordinatorLayout.Delegate to standalone interface
* fix(android): preserve parent sheet translation during keyboard transitions
Override setTranslationY in TrueSheetBottomSheetView to prevent
keyboard inset animations from resetting parent sheet translation to 0.
Parent sheets (non-topmost) now maintain their translation value.
* refactor(android): rename TrueSheetDialogObserver to TrueSheetStackManager
* refactor(android): remove edgeToEdgeFullScreen prop
* fix(android): prevent sheet from showing during navigation within modal
* fix(android): clamp detent heights to available screen space
* fix(android): post when initialDetentAnimated is false
- Move guide mdx files from subfolders to guides root
- Consolidate all guide images into guides/assets folder
- Update image import paths in guide files
- Fix blog post reference to navigation.gif
* chore: tidy clean script
* fix: implement TrueSheetProvider for web
* refactor(example): move TrueSheetProvider to screen level and improve web support
- Move TrueSheetProvider and ReanimatedTrueSheetProvider from root layout to individual screens
- Remove (sheet) folder and rename route to 'sheet'
- Improve web grabber defaults and container layout
- Fix Platform.select to use 'default' instead of 'android' for web compatibility
- Update Input placeholder color and add text color for web visibility
- Add backgroundComponent={null} and fix handle zIndex in web implementation
* feat(web): add stackBehavior prop for sheet stacking control
* docs: simplify Expo Router example with proper types
* feat: add expo-example workspace with SDK 54
* fix: use relative imports and fix metro config for expo-example
* feat(expo-example): add native tabs and TrueSheet demo with stacking
* feat(web): add web support with TrueSheetProvider and useTrueSheet hook
* refactor: consolidate TrueSheetRef type and remove TrueSheetInstanceMethods
* chore: add gorhom/bottom-sheet as peerDependency
* feat(web): add gorhom/bottom-sheet as optional dependency and web guide
* chore: exclude expo-example
* chore: update expo-example to use web
* docs: add demo gif
* feat(web): add reanimated support for web
* chore: remove expo-example tests
- Simplify API: accept worklet function directly
- Add positionChangeHandler to regular TrueSheetScreen
- When reanimated enabled, handler must be a worklet
- Remove ReanimatedTrueSheetScreenProps type
- Update documentation
* feat(android): adjust android layout calculations
* fix(android): fix footer positioning
* fix(android): emit correct position relative to js screen height
* fix(android): fix halfExpandedRatio calculation with 3 detents
* refactor(android): pre-calculate positions by index
* chore: restore examples
* fix(android): fix halfExpandedRatio calculation
* feat(android): add bottomInset to detent heights for iOS consistency
- Add bottomInset to auto and fractional detent heights to match iOS behavior
- Update ScreenUtils to use ReactContext instead of View for reliable inset retrieval
- Remove unused getScreenY method
- Simplify currentSheetTop to use view.top directly
* fix(android): adjust halfExpandedRatio and expandedOffset for edgeToEdgeFullScreen
- Use maxOf(edgeToEdgeTopInset, realHeight - detentHeight) for expandedOffset
- Subtract edgeToEdgeTopInset from detent heights when calculating halfExpandedRatio
- Ensures sheet respects top inset when edgeToEdgeFullScreen is disabled
* fix(android): emit position on dismiss and sheet stacking
- Add emitDismissedPosition() for dismiss scenarios
- Add emitPosition parameter to hideDialog/showDialog
- Emit position when sheet is hidden/shown due to sheet stacking
- Skip position emission for RN Screens modal show/hide
* refactor(android): simplify setupSheetDetents calculation
- Extract common pattern for peekHeight, halfExpandedRatio, expandedOffset
- Fix halfExpandedRatio to cap at maxAvailableHeight instead of subtracting edgeToEdgeTopInset
- Remove redundant when block with unified calculation logic
* feat: add insetAdjustment prop for controlling bottom inset behavior
* fix(ios): fix ios insetAdjustment logic
* fix(ios): add pending layout update flag for detents and insetAdjustment changes
* refactor(ios): rename to detentBottomInsetForHeight, skip for iOS 26 floating sheets
* docs: add insetAdjustment prop documentation
* docs: fix broken links
* feat: add react-navigation integration
- Add createTrueSheetNavigator for custom sheet navigator
- Add TrueSheetRouter with snapTo action creator
- Add TrueSheetView component for rendering sheet screens
- Add useTrueSheetNavigation hook
- Export as separate optional import via /navigation
- Add optional peer dependencies for @react-navigation/native, nanoid
* docs: add expo-router support section to navigation guide
* feat: add sheet navigator for react-navigation integration
- Add createTrueSheetNavigator for react-navigation support
- Add TrueSheetRouter with RESIZE action
- Add TrueSheetView to render first screen as content, rest as sheets
- Add useTrueSheetNavigation hook with resize method
- Add navigation module as separate import (@lodev09/react-native-true-sheet/navigation)
- Refactor example to use navigators folder structure
- Update documentation with usage examples and Expo Router support
* fix: wait for sheet dismiss animation before removing route
- Intercept GO_BACK/POP actions to mark route as closing instead of removing
- Add DISMISS and REMOVE custom actions to TrueSheetRouter
- Sheet stays in navigation state until dismiss animation completes
- Handle user swipe dismiss by calling goBack then skipping dismiss
- Refactor example: rename NavigationScreen to StandardScreen
- Remove MapView from SheetNavigator example
- Add navigation examples to SheetNavigator (Test screen, Modal)
* refactor(navigation): use Pick for TrueSheetNavigationOptions type
* fix(android): prevent state reset during resize animation
* refactor(navigation): clean up types and remove redundancies
- Remove unused TrueSheetNavigationConfig type
- Combine GO_BACK, POP, and DISMISS action handling in router
- Remove unused navigation prop from TrueSheetView
- Remove unused rest spread from TrueSheetNavigator
- Export TrueSheetActionType and TrueSheetNavigationState types
* refactor(navigation): simplify detentIndex logic and use initialDetentIndex
- Use initialDetentIndex prop for faster initial presentation (no JS-native roundtrip)
- Capture initialDetentIndex in ref to prevent prop changes on resize
- Extract clampDetentIndex helper for cleaner index calculation
- Apply detent defaults in destructuring instead of inline nullish coalescing
* feat(navigation): add sheet-specific navigation events
- Add sheetWillPresent, sheetDidPresent events
- Add sheetWillDismiss, sheetDidDismiss events
- Add sheetDetentChange event
- Add sheetDragBegin, sheetDragChange, sheetDragEnd events
- Add sheetPositionChange event with realtime flag
- Add sheetWillFocus, sheetDidFocus, sheetWillBlur, sheetDidBlur events
- Export DetentChangeEventData and PositionChangeEventData types
- Add example usage in SheetNavigator
* refactor(navigation): reuse event payload types from TrueSheet.types
- Replace DetentChangeEventData with DetentInfoEventPayload
- Replace PositionChangeEventData with PositionChangeEventPayload
- Re-export payload types from TrueSheet.types in navigation index
* refactor(navigation): use nested pattern instead of independent tree
- First screen in Sheet.Navigator is base content (existing app/navigator)
- Subsequent screens are presented as sheets on top
- Prevents dismissing base screen in router
- Updated docs to show wrapping existing navigation pattern
- Updated Expo Router example with (main)/ route group structure
* feat(navigation): support initialRouteName to determine base screen
- Base screen is determined by initialRouteName (defaults to first screen)
- Updated docs and example to reflect the new pattern
* docs: simplify navigation doc
* docs: update navigation doc
* docs: tidy
* chore(example): restore example
* fix(navigation): bubble goBack to parent when on base screen
- Return null instead of state when goBack is called on base screen
- Allows navigation actions to propagate to parent navigator
- Simplified navigation docs
- Remove unconditional reanimated export from main index
- Add separate export path for reanimated integration
- Update example app to use new import path
Users can now import reanimated features via:
import { ReanimatedTrueSheet } from '@lodev09/react-native-true-sheet/reanimated'
* fix(ios): skip presenting VC that is being dismissed
- Update findPresentingViewController to check isBeingDismissed flag
- Add documentation for presenting sheet on screen focus
- Add requestAnimationFrame workaround in example
* chore: revert MapScreen.tsx example changes
* feat(ios): add custom grabber view with vibrancy effect
* refactor(ios): simplify blur and grabber view setup
* feat: add grabberOptions prop for customizing grabber appearance
- Add GrabberOptions type with width, height, topMargin, and color options
- iOS: Use system grabber by default, custom grabber when options provided
- Android: Pass options to TrueSheetGrabberView
- Update docs with new prop and type reference
* fix(ios): fix grabberOptions color handling
- Use Int32 for color in codegen spec (like background prop)
- Process color with processColor in TrueSheet.tsx
- Apply color to vibrancy view backgroundColor
* refactor(ios): consolidate blur options into blurOptions prop
- Add BlurOptions type with intensity and interaction properties
- Use -1 as sentinel value for intensity to support value of 0
- Keep blurTint as separate prop
- Update docs
* refactor: use WithDefault in codegen for blurOptions
* feat: add cornerRadius option to grabberOptions
* feat(ios): emit consistent position values for lifecycle events
- Update delegate protocol to pass index, position, and detent params
- Use dispatch_async for willPresent, didPresent, detentChange events
- Remove unused methods from public header
- Update TrueSheetView to use delegate params directly
* refactor(ios): remove layoutTransitioning property
* fix(ios): correct interpolated index and detent values for position changes
- Store actual Y positions when sheet settles at each detent
- Use stored positions for accurate interpolation instead of estimating from detent fractions
- Add estimatedPositionForIndex helper to calculate positions with offset correction
- Fixes incorrect interpolated values caused by iOS safe area insets
Fixes#255
* fix(ios): update resolved position in viewDidLayoutSubviews
- Move position storage to viewDidLayoutSubviews for centralized handling
- Handles content size changes correctly
- Remove duplicate storage from detent change delegate
* feat(example): add content toggle to MapScreen for testing dynamic height
* fix(android): correct interpolated index and detent values for position changes
* refactor(ios): extract findSegmentForPosition helper to reduce duplication
* fix(ios): emit detent change after sheet settles for programmatic resize
* refactor(ios): simplify position tracking and remove transition animation tracking
* fix(ios): emit realtime position changes when another controller is presented
* fix(android): adjust sheet position when content size changes at auto detent
* docs: remove auto detent placement restriction note
* feat(android): add bottom inset adjustment to match iOS behavior
Adds native bottom safe area inset handling on Android to align with iOS changes from #256.
- Add getNavigationBarHeight() to ScreenUtils
- Add bottomInset to TrueSheetViewController
- Update getDetentHeight() to include bottom inset
- Update getDetentValueForIndex() for consistent interpolation
- Refactor ScreenUtils to reduce redundancy
* docs: update footer and migration docs for Android bottom inset support
* fix: use Double instead of Float for detent values to preserve precision
* fix(ios): remove dispatch_after when emitting position after drag
* feat: interpolate detent value during position changes
- Use Double instead of Float for detent values to preserve precision
- Add interpolatedDetentForPosition method on iOS and Android
- Rename detent to animatedDetent in Reanimated provider
- animatedDetent now animates smoothly like animatedIndex
* refactor: remove insetAdjustment and let iOS handle bottom insets natively
* fix: update example Footer to handle bottom safe area inset
* docs: add safe area handling for footer and migration guide
* chore: remove unused import in MapScreen
* fix(ios): use __typeof instead of typeof in TrueSheetBlurView
Also adds note about react-native-screens patch for navigation.
Closes#251
* chore: update podlock
* ci: re-enable build jobs and add common to turbo inputs
