@lodev09/react-native-true-sheet 3.5.0-beta.1 → 3.5.0

package/android/src/main/java/com/lodev09/truesheet/TrueSheetViewController.kt

@@ -4,7 +4,6 @@ import android.annotation.SuppressLint
 import android.graphics.Color
 import android.graphics.drawable.ShapeDrawable
 import android.graphics.drawable.shapes.RoundRectShape
-import android.util.Log
 import android.util.TypedValue
 import android.view.MotionEvent
 import android.view.View
@@ -38,6 +37,10 @@ import com.lodev09.truesheet.core.TrueSheetKeyboardObserver
 import com.lodev09.truesheet.core.TrueSheetKeyboardObserverDelegate
 import com.lodev09.truesheet.utils.ScreenUtils
 
+// =============================================================================
+// MARK: - Data Types & Delegate Protocol
+// =============================================================================
+
 data class DetentInfo(val index: Int, val position: Float)
 
 interface TrueSheetViewControllerDelegate {
@@ -58,9 +61,13 @@ interface TrueSheetViewControllerDelegate {
   fun viewControllerDidBackPress()
 }
 
+// =============================================================================
+// MARK: - TrueSheetViewController
+// =============================================================================
+
 /**
- * TrueSheetViewController manages the bottom sheet dialog and its presentation lifecycle.
- * This view also acts as a RootView to properly handle and dispatch touch events to React Native.
+ * Manages the bottom sheet dialog and its presentation lifecycle.
+ * Acts as a RootView to properly dispatch touch events to React Native.
  */
 @SuppressLint("ClickableViewAccessibility", "ViewConstructor")
 class TrueSheetViewController(private val reactContext: ThemedReactContext) :
@@ -72,6 +79,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
   companion object {
     const val TAG_NAME = "TrueSheet"
 
+    // Prevents fully expanded ratio which causes behavior issues
     private const val MAX_HALF_EXPANDED_RATIO = 0.999f
     private const val GRABBER_TAG = "TrueSheetGrabber"
     private const val DEFAULT_MAX_WIDTH = 640 // dp
@@ -79,49 +87,28 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     private const val TRANSLATE_ANIMATION_DURATION = 200L
   }
 
-  // ====================================================================
-  // MARK: - Delegate
-  // ====================================================================
-
-  var delegate: TrueSheetViewControllerDelegate? = null
-
-  // ====================================================================
-  // MARK: - Dialog & Views
-  // ====================================================================
-
-  private var dialog: BottomSheetDialog? = null
-  private var dimView: TrueSheetDimView? = null
-  private var parentDimView: TrueSheetDimView? = null
-
-  private val behavior: BottomSheetBehavior<FrameLayout>?
-    get() = dialog?.behavior
+  // =============================================================================
+  // MARK: - Types
+  // =============================================================================
 
-  private val sheetContainer: FrameLayout?
-    get() = this.parent as? FrameLayout
-
-  override val bottomSheetView: FrameLayout?
-    get() = dialog?.findViewById(com.google.android.material.R.id.design_bottom_sheet)
-
-  private val containerView: TrueSheetContainerView?
-    get() = if (this.isNotEmpty()) getChildAt(0) as? TrueSheetContainerView else null
-
-  override val contentHeight: Int
-    get() = containerView?.contentHeight ?: 0
-
-  override val headerHeight: Int
-    get() = containerView?.headerHeight ?: 0
-
-  // ====================================================================
-  // MARK: - State
-  // ====================================================================
-
-  /** Interaction state for the sheet */
   private sealed class InteractionState {
     data object Idle : InteractionState()
     data class Dragging(val startTop: Int) : InteractionState()
     data object Reconfiguring : InteractionState()
   }
 
+  // =============================================================================
+  // MARK: - Properties
+  // =============================================================================
+
+  var delegate: TrueSheetViewControllerDelegate? = null
+
+  // Dialog & Views
+  private var dialog: BottomSheetDialog? = null
+  private var dimView: TrueSheetDimView? = null
+  private var parentDimView: TrueSheetDimView? = null
+
+  // Presentation State
   var isPresented = false
     private set
 
@@ -139,48 +126,47 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
   private var lastStateWidth: Int = 0
   private var lastStateHeight: Int = 0
   private var lastEmittedPositionPx: Int = -1
+
+  // Keyboard State
   private var detentIndexBeforeKeyboard: Int = -1
   private var isKeyboardTransitioning: Boolean = false
 
+  // Promises
   var presentPromise: (() -> Unit)? = null
   var dismissPromise: (() -> Unit)? = null
 
-  // Reference to parent TrueSheetView (if presented from another sheet)
+  // For stacked sheets
   var parentSheetView: TrueSheetView? = null
 
-  // ====================================================================
-  // MARK: - Helper Classes
-  // ====================================================================
-
+  // Helper Objects
   private val sheetAnimator = TrueSheetAnimator(this)
   private var keyboardObserver: TrueSheetKeyboardObserver? = null
   private var rnScreensObserver: RNScreensFragmentObserver? = null
+  private val detentCalculator = TrueSheetDetentCalculator(this)
 
-  // ====================================================================
-  // MARK: - Configuration Properties
-  // ====================================================================
-
-  override val screenHeight: Int
-    get() = ScreenUtils.getScreenHeight(reactContext)
-  val screenWidth: Int
-    get() = ScreenUtils.getScreenWidth(reactContext)
-  override val realScreenHeight: Int
-    get() = ScreenUtils.getRealScreenHeight(reactContext)
+  // Touch Dispatchers
+  internal var eventDispatcher: EventDispatcher? = null
+  private val jSTouchDispatcher = JSTouchDispatcher(this)
+  private var jSPointerDispatcher: JSPointerDispatcher? = null
 
+  // Detent Configuration
   override var maxSheetHeight: Int? = null
   override var detents: MutableList<Double> = mutableListOf(0.5, 1.0)
 
+  // Appearance Configuration
   var dimmed = true
   var dimmedDetentIndex = 0
   var grabber: Boolean = true
   var grabberOptions: GrabberOptions? = null
+  var sheetBackgroundColor: Int? = null
+  var edgeToEdgeFullScreen: Boolean = false
+  var insetAdjustment: String = "automatic"
+
   var sheetCornerRadius: Float = DEFAULT_CORNER_RADIUS.dpToPx()
     set(value) {
       field = if (value < 0) DEFAULT_CORNER_RADIUS.dpToPx() else value
       if (isPresented) setupBackground()
     }
-  var sheetBackgroundColor: Int? = null
-  var edgeToEdgeFullScreen: Boolean = false
 
   var dismissible: Boolean = true
     set(value) {
@@ -198,13 +184,47 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
       behavior?.isDraggable = value
     }
 
-  // ====================================================================
+  // =============================================================================
   // MARK: - Computed Properties
-  // ====================================================================
+  // =============================================================================
+
+  // Dialog
+  private val behavior: BottomSheetBehavior<FrameLayout>?
+    get() = dialog?.behavior
+
+  private val sheetContainer: FrameLayout?
+    get() = this.parent as? FrameLayout
+
+  override val bottomSheetView: FrameLayout?
+    get() = dialog?.findViewById(com.google.android.material.R.id.design_bottom_sheet)
+
+  private val containerView: TrueSheetContainerView?
+    get() = if (this.isNotEmpty()) getChildAt(0) as? TrueSheetContainerView else null
+
+  // Screen Measurements
+  override val screenHeight: Int
+    get() = ScreenUtils.getScreenHeight(reactContext)
+
+  val screenWidth: Int
+    get() = ScreenUtils.getScreenWidth(reactContext)
+
+  // Includes system bars for accurate positioning
+  override val realScreenHeight: Int
+    get() = ScreenUtils.getRealScreenHeight(reactContext)
+
+  // Content Measurements
+  override val contentHeight: Int
+    get() = containerView?.contentHeight ?: 0
 
+  override val headerHeight: Int
+    get() = containerView?.headerHeight ?: 0
+
+  // Insets
+  // Target keyboard height used for detent calculations
   override val keyboardInset: Int
     get() = keyboardObserver?.targetHeight ?: 0
 
+  // Current animated keyboard height for positioning
   private val currentKeyboardInset: Int
     get() = keyboardObserver?.currentHeight ?: 0
 
@@ -214,8 +234,6 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
   val topInset: Int
     get() = if (edgeToEdgeEnabled) ScreenUtils.getInsets(reactContext).top else 0
 
-  var insetAdjustment: String = "automatic"
-
   override val contentBottomInset: Int
     get() = if (insetAdjustment == "automatic") bottomInset else 0
 
@@ -225,24 +243,33 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
       return BuildConfig.EDGE_TO_EDGE_ENABLED || dialog?.edgeToEdgeEnabled == true || defaultEnabled
     }
 
-  internal var eventDispatcher: EventDispatcher? = null
-  private val jSTouchDispatcher = JSTouchDispatcher(this)
-  private var jSPointerDispatcher: JSPointerDispatcher? = null
+  // Sheet State
+  val isExpanded: Boolean
+    get() {
+      val sheetTop = bottomSheetView?.top ?: return false
+      return sheetTop <= topInset
+    }
 
-  /** Single instance that reads current values via TrueSheetDetentMeasurements interface */
-  private val detentCalculator = TrueSheetDetentCalculator(this)
+  val currentTranslationY: Int
+    get() = bottomSheetView?.translationY?.toInt() ?: 0
 
-  // ====================================================================
+  private val isTopmostSheet: Boolean
+    get() {
+      val hostView = delegate as? TrueSheetView ?: return true
+      return TrueSheetDialogObserver.isTopmostSheet(hostView)
+    }
+
+  // =============================================================================
   // MARK: - Initialization
-  // ====================================================================
+  // =============================================================================
 
   init {
     jSPointerDispatcher = JSPointerDispatcher(this)
   }
 
-  // ====================================================================
-  // MARK: - Dialog Lifecycle
-  // ====================================================================
+  // =============================================================================
+  // MARK: - Dialog Creation & Cleanup
+  // =============================================================================
 
   fun createDialog() {
     if (dialog != null) return
@@ -307,6 +334,10 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     shouldAnimatePresent = true
   }
 
+  // =============================================================================
+  // MARK: - Dialog Listeners
+  // =============================================================================
+
   private fun setupDialogListeners(dialog: BottomSheetDialog) {
     dialog.setOnShowListener {
       bottomSheetView?.visibility = VISIBLE
@@ -421,33 +452,30 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     }
   }
 
+  // =============================================================================
+  // MARK: - Modal Observer (react-native-screens)
+  // =============================================================================
+
   private fun setupModalObserver() {
     rnScreensObserver = RNScreensFragmentObserver(
       reactContext = reactContext,
       onModalPresented = {
-        if (isPresented && isDialogVisible) {
-          isDialogVisible = false
-          wasHiddenByModal = true
-
-          dialog?.window?.setWindowAnimations(com.lodev09.truesheet.R.style.TrueSheetFastFadeOut)
-          dialog?.window?.decorView?.visibility = GONE
-          dimView?.visibility = INVISIBLE
-          parentDimView?.visibility = INVISIBLE
+        if (isPresented && isDialogVisible && isTopmostSheet) {
+          hideForModal()
         }
       },
       onModalWillDismiss = {
-        if (isPresented && wasHiddenByModal) {
-          isDialogVisible = true
-
-          dialog?.window?.setWindowAnimations(0)
-          dialog?.window?.decorView?.visibility = VISIBLE
-          dimView?.visibility = VISIBLE
-          parentDimView?.visibility = VISIBLE
+        if (isPresented && wasHiddenByModal && isTopmostSheet) {
+          showAfterModal()
         }
       },
       onModalDidDismiss = {
         if (isPresented && wasHiddenByModal) {
           wasHiddenByModal = false
+          // Restore parent sheet after this sheet is restored
+          parentSheetView?.viewController?.let { parent ->
+            post { parent.showAfterModal() }
+          }
         }
       }
     )
@@ -459,88 +487,36 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     rnScreensObserver = null
   }
 
-  // ====================================================================
-  // MARK: - Event Emission
-  // ====================================================================
-
-  private fun emitWillPresentEvents() {
-    val (index, position, detent) = getDetentInfoWithValue(currentDetentIndex)
-    parentSheetView?.viewControllerWillBlur()
-    delegate?.viewControllerWillPresent(index, position, detent)
-    delegate?.viewControllerWillFocus()
-  }
-
-  private fun emitWillDismissEvents() {
-    delegate?.viewControllerWillBlur()
-    delegate?.viewControllerWillDismiss()
-    parentSheetView?.viewControllerWillFocus()
-  }
-
-  private fun emitDidDismissEvents() {
-    val hadParent = parentSheetView != null
-    parentSheetView?.viewControllerDidFocus()
-    parentSheetView = null
-
-    delegate?.viewControllerDidBlur()
-    delegate?.viewControllerDidDismiss(hadParent)
-
-    dismissPromise?.invoke()
-    dismissPromise = null
-  }
+  private fun hideForModal() {
+    isDialogVisible = false
+    wasHiddenByModal = true
 
-  private fun emitChangePositionDelegate(currentTop: Int, realtime: Boolean = true) {
-    if (currentTop == lastEmittedPositionPx) return
+    // Prepare for fast fade out
+    dimView?.alpha = 0f
+    parentDimView?.alpha = 0f
 
-    lastEmittedPositionPx = currentTop
-    val visibleHeight = realScreenHeight - currentTop
-    val position = detentCalculator.getPositionDp(visibleHeight)
-    val interpolatedIndex = detentCalculator.getInterpolatedIndexForPosition(currentTop)
-    val detent = detentCalculator.getInterpolatedDetentForPosition(currentTop)
-    delegate?.viewControllerDidChangePosition(interpolatedIndex, position, detent, realtime)
-  }
+    dialog?.window?.setWindowAnimations(com.lodev09.truesheet.R.style.TrueSheetFastFadeOut)
+    dialog?.window?.decorView?.visibility = GONE
+    dimView?.visibility = INVISIBLE
+    parentDimView?.visibility = INVISIBLE
 
-  private fun getDetentInfoWithValue(index: Int): Triple<Int, Float, Float> {
-    val state = detentCalculator.getStateForDetentIndex(index)
-    val detentIndex = detentCalculator.getDetentIndexForState(state) ?: 0
-    val position = getPositionForDetentIndex(detentIndex)
-    val detent = detentCalculator.getDetentValueForIndex(detentIndex)
-    return Triple(detentIndex, position, detent)
+    parentSheetView?.viewController?.hideForModal()
   }
 
-  // ====================================================================
-  // MARK: - Dialog Visibility (for stacking)
-  // ====================================================================
-
-  val isExpanded: Boolean
-    get() {
-      val sheetTop = bottomSheetView?.top ?: return false
-      return sheetTop <= topInset
-    }
-
-  val currentTranslationY: Int
-    get() = bottomSheetView?.translationY?.toInt() ?: 0
-
-  fun getExpectedSheetTop(detentIndex: Int): Int {
-    if (detentIndex < 0 || detentIndex >= detents.size) return screenHeight
-    return realScreenHeight - detentCalculator.getDetentHeight(detents[detentIndex])
-  }
+  private fun showAfterModal() {
+    isDialogVisible = true
 
-  fun translateDialog(translationY: Int) {
-    val bottomSheet = bottomSheetView ?: return
+    dialog?.window?.setWindowAnimations(0)
+    dialog?.window?.decorView?.visibility = VISIBLE
+    dimView?.visibility = VISIBLE
+    parentDimView?.visibility = VISIBLE
 
-    bottomSheet.animate()
-      .translationY(translationY.toFloat())
-      .setDuration(TRANSLATE_ANIMATION_DURATION)
-      .setUpdateListener {
-        val effectiveTop = bottomSheet.top + bottomSheet.translationY.toInt()
-        emitChangePositionDelegate(effectiveTop)
-      }
-      .start()
+    updateDimAmount(animated = true)
   }
 
-  // ====================================================================
+  // =============================================================================
   // MARK: - Presentation
-  // ====================================================================
+  // =============================================================================
 
   fun present(detentIndex: Int, animated: Boolean = true) {
     val dialog = this.dialog ?: run {
@@ -564,6 +540,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
       setupBackground()
       setupGrabber()
 
+      // Hide until animation starts
       bottomSheetView?.visibility = INVISIBLE
 
       dialog.show()
@@ -601,9 +578,9 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     presentPromise = null
   }
 
-  // ====================================================================
+  // =============================================================================
   // MARK: - Sheet Configuration
-  // ====================================================================
+  // =============================================================================
 
   fun setupSheetDetents() {
     val behavior = this.behavior ?: return
@@ -627,9 +604,14 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
       val maxDetentHeight = detentCalculator.getDetentHeight(detents.last())
 
       val adjustedHalfExpandedHeight = minOf(halfExpandedDetentHeight, maxAvailableHeight)
-      halfExpandedRatio = minOf(adjustedHalfExpandedHeight.toFloat() / realScreenHeight.toFloat(), MAX_HALF_EXPANDED_RATIO)
+      halfExpandedRatio = minOf(
+        adjustedHalfExpandedHeight.toFloat() / realScreenHeight.toFloat(),
+        MAX_HALF_EXPANDED_RATIO
+      )
 
       expandedOffset = maxOf(edgeToEdgeTopInset, realScreenHeight - maxDetentHeight)
+
+      // fitToContents works better with <= 2 detents when no expanded offset
       isFitToContents = detents.size < 3 && expandedOffset == 0
 
       val offset = if (expandedOffset == 0) topInset else 0
@@ -655,6 +637,14 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     positionFooter()
   }
 
+  fun setStateForDetentIndex(index: Int) {
+    behavior?.state = detentCalculator.getStateForDetentIndex(index)
+  }
+
+  // =============================================================================
+  // MARK: - Grabber
+  // =============================================================================
+
   fun setupGrabber() {
     val bottomSheet = bottomSheetView ?: return
 
@@ -671,61 +661,14 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     bottomSheet.addView(grabberView)
   }
 
-  // ====================================================================
-  // MARK: - Keyboard Handling
-  // ====================================================================
-
-  private fun shouldHandleKeyboard(): Boolean {
-    if (wasHiddenByModal) return false
-
-    val parentView = parentSheetView ?: return true
-    return TrueSheetDialogObserver.getSheetsAbove(parentView).firstOrNull()?.viewController == this
-  }
-
-  fun setupKeyboardObserver() {
-    val bottomSheet = bottomSheetView ?: return
-    keyboardObserver = TrueSheetKeyboardObserver(bottomSheet, reactContext).apply {
-      delegate = object : TrueSheetKeyboardObserverDelegate {
-        override fun keyboardWillShow(height: Int) {
-          if (!shouldHandleKeyboard()) return
-          detentIndexBeforeKeyboard = currentDetentIndex
-          isKeyboardTransitioning = true
-          setupSheetDetents()
-          setStateForDetentIndex(detents.size - 1)
-        }
-
-        override fun keyboardWillHide() {
-          if (!shouldHandleKeyboard()) return
-          setupSheetDetents()
-          if (detentIndexBeforeKeyboard >= 0) {
-            setStateForDetentIndex(detentIndexBeforeKeyboard)
-            detentIndexBeforeKeyboard = -1
-          }
-        }
-
-        override fun keyboardDidHide() {
-          if (!shouldHandleKeyboard()) return
-          isKeyboardTransitioning = false
-        }
-
-        override fun keyboardDidChangeHeight(height: Int) {}
-      }
-      start()
-    }
-  }
-
-  fun cleanupKeyboardObserver() {
-    keyboardObserver?.stop()
-    keyboardObserver = null
-  }
-
-  // ====================================================================
+  // =============================================================================
   // MARK: - Background & Dimming
-  // ====================================================================
+  // =============================================================================
 
   fun setupBackground() {
     val bottomSheet = bottomSheetView ?: return
 
+    // Rounded corners only on top
     val outerRadii = floatArrayOf(
       sheetCornerRadius,
       sheetCornerRadius,
@@ -759,6 +702,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
         if (dimView == null) dimView = TrueSheetDimView(reactContext)
         if (!parentDimVisible) dimView?.attach(null)
 
+        // Attach dim view to parent sheet if stacked
         val parentController = parentSheetView?.viewController
         val parentBottomSheet = parentController?.bottomSheetView
         if (parentBottomSheet != null) {
@@ -780,6 +724,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
           true
         }
       } else {
+        // Pass through touches to parent or activity when not dimmed
         touchOutside.setOnTouchListener { v, event ->
           event.setLocation(event.rawX - v.x, event.rawY - v.y)
           (
@@ -793,13 +738,42 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     }
   }
 
-  fun updateDimAmount(sheetTop: Int? = null) {
+  fun updateDimAmount(sheetTop: Int? = null, animated: Boolean = false) {
     if (!dimmed) return
     val top = (sheetTop ?: bottomSheetView?.top ?: return) + currentKeyboardInset
-    dimView?.interpolateAlpha(top, dimmedDetentIndex, detentCalculator::getSheetTopForDetentIndex)
-    parentDimView?.interpolateAlpha(top, dimmedDetentIndex, detentCalculator::getSheetTopForDetentIndex)
+
+    if (animated) {
+      val targetAlpha = dimView?.calculateAlpha(
+        top,
+        dimmedDetentIndex,
+        detentCalculator::getSheetTopForDetentIndex
+      ) ?: 0f
+      dimView?.animate()?.alpha(targetAlpha)?.setDuration(200)?.start()
+      parentDimView?.animate()?.alpha(targetAlpha)?.setDuration(200)?.start()
+    } else {
+      dimView?.interpolateAlpha(top, dimmedDetentIndex, detentCalculator::getSheetTopForDetentIndex)
+      parentDimView?.interpolateAlpha(top, dimmedDetentIndex, detentCalculator::getSheetTopForDetentIndex)
+    }
+  }
+
+  fun getDefaultBackgroundColor(): Int {
+    val typedValue = TypedValue()
+    return if (reactContext.theme.resolveAttribute(
+        com.google.android.material.R.attr.colorSurfaceContainerLow,
+        typedValue,
+        true
+      )
+    ) {
+      typedValue.data
+    } else {
+      Color.WHITE
+    }
   }
 
+  // =============================================================================
+  // MARK: - Footer Positioning
+  // =============================================================================
+
   fun positionFooter(slideOffset: Float? = null) {
     val footerView = containerView?.footerView ?: return
     val bottomSheet = bottomSheetView ?: return
@@ -809,35 +783,66 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     val sheetTop = bottomSheet.top
 
     var footerY = (sheetHeight - sheetTop - footerHeight - currentKeyboardInset).toFloat()
+
+    // Adjust during dismiss animation when slideOffset is negative
     if (slideOffset != null && slideOffset < 0) {
       footerY -= (footerHeight * slideOffset)
     }
 
+    // Clamp to prevent footer going above safe area
     val maxAllowedY = (sheetHeight - topInset - footerHeight).toFloat()
     footerView.y = minOf(footerY, maxAllowedY)
   }
 
-  fun setStateForDetentIndex(index: Int) {
-    behavior?.state = detentCalculator.getStateForDetentIndex(index)
+  // =============================================================================
+  // MARK: - Keyboard Handling
+  // =============================================================================
+
+  private fun shouldHandleKeyboard(): Boolean {
+    if (wasHiddenByModal) return false
+    return isTopmostSheet
   }
 
-  fun getDefaultBackgroundColor(): Int {
-    val typedValue = TypedValue()
-    return if (reactContext.theme.resolveAttribute(
-        com.google.android.material.R.attr.colorSurfaceContainerLow,
-        typedValue,
-        true
-      )
-    ) {
-      typedValue.data
-    } else {
-      Color.WHITE
+  fun setupKeyboardObserver() {
+    val bottomSheet = bottomSheetView ?: return
+    keyboardObserver = TrueSheetKeyboardObserver(bottomSheet, reactContext).apply {
+      delegate = object : TrueSheetKeyboardObserverDelegate {
+        override fun keyboardWillShow(height: Int) {
+          if (!shouldHandleKeyboard()) return
+          detentIndexBeforeKeyboard = currentDetentIndex
+          isKeyboardTransitioning = true
+          setupSheetDetents()
+          setStateForDetentIndex(detents.size - 1)
+        }
+
+        override fun keyboardWillHide() {
+          if (!shouldHandleKeyboard()) return
+          setupSheetDetents()
+          if (detentIndexBeforeKeyboard >= 0) {
+            setStateForDetentIndex(detentIndexBeforeKeyboard)
+            detentIndexBeforeKeyboard = -1
+          }
+        }
+
+        override fun keyboardDidHide() {
+          if (!shouldHandleKeyboard()) return
+          isKeyboardTransitioning = false
+        }
+
+        override fun keyboardDidChangeHeight(height: Int) {}
+      }
+      start()
     }
   }
 
-  // ====================================================================
+  fun cleanupKeyboardObserver() {
+    keyboardObserver?.stop()
+    keyboardObserver = null
+  }
+
+  // =============================================================================
   // MARK: - Drag Handling
-  // ====================================================================
+  // =============================================================================
 
   private fun handleDragBegin(sheetView: View) {
     val position = detentCalculator.getPositionDp(detentCalculator.getVisibleSheetHeight(sheetView.top))
@@ -853,13 +858,75 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     delegate?.viewControllerDidDragChange(currentDetentIndex, position, detent)
   }
 
-  // ====================================================================
+  // =============================================================================
+  // MARK: - Event Emission
+  // =============================================================================
+
+  private fun emitWillPresentEvents() {
+    val (index, position, detent) = getDetentInfoWithValue(currentDetentIndex)
+    parentSheetView?.viewControllerWillBlur()
+    delegate?.viewControllerWillPresent(index, position, detent)
+    delegate?.viewControllerWillFocus()
+  }
+
+  private fun emitWillDismissEvents() {
+    delegate?.viewControllerWillBlur()
+    delegate?.viewControllerWillDismiss()
+    parentSheetView?.viewControllerWillFocus()
+  }
+
+  private fun emitDidDismissEvents() {
+    val hadParent = parentSheetView != null
+    parentSheetView?.viewControllerDidFocus()
+    parentSheetView = null
+
+    delegate?.viewControllerDidBlur()
+    delegate?.viewControllerDidDismiss(hadParent)
+
+    dismissPromise?.invoke()
+    dismissPromise = null
+  }
+
+  private fun emitChangePositionDelegate(currentTop: Int, realtime: Boolean = true) {
+    // Dedupe emissions for same position
+    if (currentTop == lastEmittedPositionPx) return
+
+    lastEmittedPositionPx = currentTop
+    val visibleHeight = realScreenHeight - currentTop
+    val position = detentCalculator.getPositionDp(visibleHeight)
+    val interpolatedIndex = detentCalculator.getInterpolatedIndexForPosition(currentTop)
+    val detent = detentCalculator.getInterpolatedDetentForPosition(currentTop)
+    delegate?.viewControllerDidChangePosition(interpolatedIndex, position, detent, realtime)
+  }
+
+  // =============================================================================
   // MARK: - Detent Helpers
-  // ====================================================================
+  // =============================================================================
+
+  fun getExpectedSheetTop(detentIndex: Int): Int {
+    if (detentIndex < 0 || detentIndex >= detents.size) return screenHeight
+    return realScreenHeight - detentCalculator.getDetentHeight(detents[detentIndex])
+  }
+
+  fun translateDialog(translationY: Int) {
+    val bottomSheet = bottomSheetView ?: return
+
+    bottomSheet.animate()
+      .translationY(translationY.toFloat())
+      .setDuration(TRANSLATE_ANIMATION_DURATION)
+      .setUpdateListener {
+        val effectiveTop = bottomSheet.top + bottomSheet.translationY.toInt()
+        emitChangePositionDelegate(effectiveTop)
+      }
+      .start()
+  }
 
-  fun getDetentInfoForState(state: Int): DetentInfo? {
-    val index = detentCalculator.getDetentIndexForState(state) ?: return null
-    return DetentInfo(index, getPositionForDetentIndex(index))
+  private fun getDetentInfoWithValue(index: Int): Triple<Int, Float, Float> {
+    val state = detentCalculator.getStateForDetentIndex(index)
+    val detentIndex = detentCalculator.getDetentIndexForState(state) ?: 0
+    val position = getPositionForDetentIndex(detentIndex)
+    val detent = detentCalculator.getDetentValueForIndex(detentIndex)
+    return Triple(detentIndex, position, detent)
   }
 
   private fun getPositionForDetentIndex(index: Int): Float {
@@ -867,7 +934,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
 
     bottomSheetView?.let {
       val visibleSheetHeight = detentCalculator.getVisibleSheetHeight(it.top)
-      if (visibleSheetHeight > 0 && visibleSheetHeight < realScreenHeight) {
+      if (visibleSheetHeight in 1..<realScreenHeight) {
         return detentCalculator.getPositionDp(visibleSheetHeight)
       }
     }
@@ -876,12 +943,9 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     return detentCalculator.getPositionDp(detentHeight)
   }
 
-  fun getDetentInfoForIndex(index: Int): DetentInfo =
-    getDetentInfoForState(detentCalculator.getStateForDetentIndex(index)) ?: DetentInfo(0, 0f)
-
-  // ====================================================================
+  // =============================================================================
   // MARK: - RootView Implementation
-  // ====================================================================
+  // =============================================================================
 
   override fun onInitializeAccessibilityNodeInfo(info: AccessibilityNodeInfo) {
     super.onInitializeAccessibilityNodeInfo(info)
@@ -893,6 +957,8 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
 
     if (w == oldw && h == oldh) return
     if (!isPresented) return
+
+    // Skip reconfiguration if expanded and only height changed (e.g., keyboard)
     if (h + topInset >= screenHeight && isExpanded && oldw == w) return
 
     this.post {
@@ -906,17 +972,19 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
     reactContext.reactApplicationContext.handleException(RuntimeException(t))
   }
 
-  // ====================================================================
+  // =============================================================================
   // MARK: - Touch Event Handling
-  // ====================================================================
+  // =============================================================================
 
   override fun dispatchTouchEvent(event: MotionEvent): Boolean {
+    // Footer needs special handling since it's positioned absolutely
     val footer = containerView?.footerView
     if (footer != null && footer.isVisible) {
       val footerLocation = ScreenUtils.getScreenLocation(footer)
       val touchScreenX = event.rawX.toInt()
       val touchScreenY = event.rawY.toInt()
 
+      // Check if touch is within footer bounds
       if (touchScreenX >= footerLocation[0] &&
         touchScreenX <= footerLocation[0] + footer.width &&
         touchScreenY >= footerLocation[1] &&

package/android/src/main/java/com/lodev09/truesheet/core/TrueSheetDialogObserver.kt

@@ -106,4 +106,14 @@ object TrueSheetDialogObserver {
       return presentedSheetStack[index - 1]
     }
   }
+
+  /**
+   * Returns true if the given sheet is the topmost presented sheet.
+   */
+  @JvmStatic
+  fun isTopmostSheet(sheetView: TrueSheetView): Boolean {
+    synchronized(presentedSheetStack) {
+      return presentedSheetStack.lastOrNull() == sheetView
+    }
+  }
 }

package/android/src/main/java/com/lodev09/truesheet/core/TrueSheetDimView.kt

@@ -48,12 +48,12 @@ class TrueSheetDimView(private val reactContext: ThemedReactContext) : View(reac
     targetView = null
   }
 
-  fun interpolateAlpha(sheetTop: Int, dimmedDetentIndex: Int, getSheetTopForDetentIndex: (Int) -> Int) {
+  fun calculateAlpha(sheetTop: Int, dimmedDetentIndex: Int, getSheetTopForDetentIndex: (Int) -> Int): Float {
     val realHeight = ScreenUtils.getRealScreenHeight(reactContext)
     val dimmedDetentTop = getSheetTopForDetentIndex(dimmedDetentIndex)
     val belowDimmedTop = if (dimmedDetentIndex > 0) getSheetTopForDetentIndex(dimmedDetentIndex - 1) else realHeight
 
-    alpha = when {
+    return when {
       sheetTop <= dimmedDetentTop -> MAX_ALPHA
 
       sheetTop >= belowDimmedTop -> 0f
@@ -64,4 +64,8 @@ class TrueSheetDimView(private val reactContext: ThemedReactContext) : View(reac
       }
     }
   }
+
+  fun interpolateAlpha(sheetTop: Int, dimmedDetentIndex: Int, getSheetTopForDetentIndex: (Int) -> Int) {
+    alpha = calculateAlpha(sheetTop, dimmedDetentIndex, getSheetTopForDetentIndex)
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lodev09/react-native-true-sheet",
-  "version": "3.5.0-beta.1",
+  "version": "3.5.0",
   "description": "The true native bottom sheet experience for your React Native Apps.",
   "source": "./src/index.ts",
   "main": "./lib/module/index.js",