feat: add dismissAll static method (#393)

* fix(android): keyboard and focus handling inside RN Modal

- Use targetView.rootView.findFocus() instead of activity.currentFocus in keyboard observer
- Use delegate.findRootContainerView().findFocus() for saveFocusedView
- Add findRootContainerView to TrueSheetViewControllerDelegate interface

* feat: add dismissAll static method

* fix(ios): dismiss all sheets without dismissing external view controllers

* fix(android): dismiss all sheets without dismissing sheets behind modal

* docs: add dismissAll method documentation

* fix(android): prevent translation of sheets hidden by modal

* feat(web): add dismissAll method

* feat(web): add static methods for present, dismiss, resize

Author: lodev09

android/src/main/java/com/lodev09/truesheet/TrueSheetModule.kt

@@ -95,6 +95,31 @@ class TrueSheetModule(reactContext: ReactApplicationContext) :
     }
   }
 
+  /**
+   * Dismiss all presented sheets by dismissing from the bottom of the stack
+   *
+   * @param animated Whether to animate the dismissals
+   * @param promise Promise that resolves when all sheets are dismissed
+   */
+  @ReactMethod
+  fun dismissAll(animated: Boolean, promise: Promise) {
+    Handler(Looper.getMainLooper()).post {
+      try {
+        val rootSheet = TrueSheetStackManager.getRootSheet()
+        if (rootSheet == null) {
+          promise.resolve(null)
+          return@post
+        }
+
+        rootSheet.dismissAll(animated) {
+          promise.resolve(null)
+        }
+      } catch (e: Exception) {
+        promise.reject("OPERATION_FAILED", "Failed to dismiss all sheets: ${e.message}", e)
+      }
+    }
+  }
+
   /**
    * Helper method to get TrueSheetView by tag and execute closure
    */

android/src/main/java/com/lodev09/truesheet/TrueSheetView.kt

@@ -310,6 +310,16 @@ class TrueSheetView(private val reactContext: ThemedReactContext) :
     viewController.dismiss(animated)
   }
 
+  @UiThread
+  fun dismissAll(animated: Boolean = true, promiseCallback: () -> Unit) {
+    // Dismiss all sheets above first
+    dismiss(animated) {}
+
+    // Then dismiss itself
+    viewController.dismissPromise = promiseCallback
+    viewController.dismiss(animated)
+  }
+
   @UiThread
   fun resize(detentIndex: Int, promiseCallback: () -> Unit) {
     if (!viewController.isPresented) {

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

@@ -131,7 +131,7 @@ class TrueSheetViewController(private val reactContext: ThemedReactContext) :
 
   private var interactionState: InteractionState = InteractionState.Idle
   private var isDismissing = false
-  private var wasHiddenByModal = false
+  internal var wasHiddenByModal = false
   private var shouldAnimatePresent = false
   private var isPresentAnimating = false
 

android/src/main/java/com/lodev09/truesheet/core/TrueSheetStackManager.kt

@@ -22,12 +22,12 @@ object TrueSheetStackManager {
   }
 
   /**
-   * Returns the topmost presented and visible sheet.
+   * Returns the topmost presented and visible sheet that is not hidden by modal.
    * Must be called within synchronized block.
    */
   private fun findTopmostSheet(): TrueSheetView? =
     presentedSheetStack.lastOrNull {
-      it.viewController.isPresented && it.viewController.isSheetVisible
+      it.viewController.isPresented && it.viewController.isSheetVisible && !it.viewController.wasHiddenByModal
     }
 
   /**
@@ -151,4 +151,27 @@ object TrueSheetStackManager {
       return findTopmostSheet()
     }
   }
+
+  /**
+   * Returns the root presented sheet for dismissAll.
+   * Starts from the topmost sheet and walks up to find the root of its stack.
+   * Stops at modal boundary (parent hidden by modal) or when there's no parent.
+   */
+  @JvmStatic
+  fun getRootSheet(): TrueSheetView? {
+    synchronized(presentedSheetStack) {
+      val topmost = presentedSheetStack.lastOrNull { it.viewController.isPresented } ?: return null
+
+      var current: TrueSheetView = topmost
+      while (true) {
+        val parent = current.viewController.parentSheetView ?: return current
+
+        if (parent.viewController.wasHiddenByModal) {
+          return current
+        }
+
+        current = parent
+      }
+    }
+  }
 }

docs/docs/guides/stacking.mdx

@@ -52,6 +52,18 @@ await sheet3.current?.dismiss() // Dismisses Sheet 3, Sheet 1 and Sheet 2 stay
 
 This is useful when you need to dismiss all child sheets and return focus to a parent sheet without closing it.
 
+### Dismiss All Sheets
+
+To dismiss all sheets in the current stack at once, use the static [`dismissAll()`](/reference/methods#dismissall) method:
+
+```tsx
+await TrueSheet.dismissAll()
+```
+
+:::info Presentation Context
+This only dismisses sheets in the current presentation context. Sheets presented behind a modal (e.g., React Navigation modal or React Native Modal) will not be affected.
+:::
+
 ## Stack Behavior (Web)
 
 On web, you can customize the stacking behavior using the [`stackBehavior`](https://gorhom.dev/react-native-bottom-sheet/modal/props#stackbehavior) prop:

docs/docs/reference/03-methods.mdx

@@ -103,3 +103,22 @@ await TrueSheet.dismiss('my-sheet', false)
 // Resize to 80%
 await TrueSheet.resize('my-sheet', 0.8)
 ```
+
+### `dismissAll`
+
+Dismisses all presented sheets in the current stack. This is useful when you need to close all sheets at once, for example when navigating away or resetting the UI state.
+
+| Parameters | Required | Default |
+| - | - | - |
+| `animated: boolean` | No | `true` |
+
+```tsx
+await TrueSheet.dismissAll()
+
+// Dismiss all without animation
+await TrueSheet.dismissAll(false)
+```
+
+:::note
+This only dismisses sheets in the current presentation context. Sheets presented behind a modal (e.g., React Navigation modal or React Native Modal) will not be affected.
+:::

example/shared/src/components/sheets/BasicSheet.tsx

@@ -124,6 +124,8 @@ export const BasicSheet = forwardRef((props: BasicSheetProps, ref: Ref<TrueSheet
         <DemoContent color={DARK_BLUE} />
         <DemoContent color={DARK_BLUE} />
         <DemoContent color={DARK_BLUE} />
+        <Button text="Dismiss All" onPress={() => TrueSheet.dismissAll()} />
+        <Button text="Dismiss Stack" onPress={() => TrueSheet.dismiss('main')} />
         <Button text="Close" onPress={() => childSheet.current?.dismiss()} />
       </TrueSheet>
     </TrueSheet>

example/shared/src/screens/ModalScreen.tsx

@@ -4,7 +4,7 @@ import { TrueSheet, TrueSheetProvider } from '@lodev09/react-native-true-sheet';
 
 import { BLUE, DARK_GRAY, GAP, LIGHT_GRAY, SPACING } from '../utils';
 import { Button, Input, Spacer } from '../components';
-import { PromptSheet, FlatListSheet, ScrollViewSheet } from '../components/sheets';
+import { PromptSheet, FlatListSheet, ScrollViewSheet, BasicSheet } from '../components/sheets';
 
 export interface ModalScreenProps {
   onNavigateToTest?: () => void;
@@ -15,7 +15,10 @@ export const ModalScreen = ({ onNavigateToTest, onDismiss }: ModalScreenProps) =
   const promptSheet = useRef<TrueSheet>(null);
   const flatlistSheet = useRef<TrueSheet>(null);
 
+  const basicSheet = useRef<TrueSheet>(null);
+
   const [modalVisible, setModalVisible] = useState(false);
+  const modalBasicSheet = useRef<TrueSheet>(null);
   const modalPromptSheet = useRef<TrueSheet>(null);
   const modalFlatlistSheet = useRef<TrueSheet>(null);
   const modalScrollViewSheet = useRef<TrueSheet>(null);
@@ -37,12 +40,14 @@ export const ModalScreen = ({ onNavigateToTest, onDismiss }: ModalScreenProps) =
         </View>
         <Input />
         <Button text="Dismiss Modal" onPress={onDismiss} />
+        <Button text="TrueSheet Basic" onPress={() => basicSheet.current?.present()} />
         <Button text="TrueSheet Prompt" onPress={() => promptSheet.current?.present()} />
         <Button text="TrueSheet FlatList" onPress={() => flatlistSheet.current?.present()} />
         <Button text="Open RN Modal" onPress={() => setModalVisible(true)} />
         <Spacer />
         <Button text="Navigate Test" onPress={onNavigateToTest} />
 
+        <BasicSheet ref={basicSheet} />
         <PromptSheet ref={promptSheet} />
         <FlatListSheet ref={flatlistSheet} />
 
@@ -59,6 +64,7 @@ export const ModalScreen = ({ onNavigateToTest, onDismiss }: ModalScreenProps) =
                   This is a React Native Modal. You can present TrueSheets from here!
                 </Text>
               </View>
+              <Button text="Basic Sheet" onPress={() => modalBasicSheet.current?.present()} />
               <Button text="Prompt Sheet" onPress={() => modalPromptSheet.current?.present()} />
               <Button
                 text="ScrollView Sheet"
@@ -68,6 +74,7 @@ export const ModalScreen = ({ onNavigateToTest, onDismiss }: ModalScreenProps) =
               <Spacer />
               <Button text="Close Modal" onPress={() => setModalVisible(false)} />
 
+              <BasicSheet ref={modalBasicSheet} />
               <PromptSheet ref={modalPromptSheet} />
               <FlatListSheet ref={modalFlatlistSheet} />
               <ScrollViewSheet ref={modalScrollViewSheet} />

ios/TrueSheetModule.mm

@@ -14,6 +14,7 @@
 #import "TrueSheetModule.h"
 #import <React/RCTUtils.h>
 #import "TrueSheetView.h"
+#import "TrueSheetViewController.h"
 
 #import <TrueSheetSpec/TrueSheetSpec.h>
 
@@ -115,6 +116,46 @@ - (void)resizeByRef:(double)viewTag
   });
 }
 
+- (void)dismissAll:(BOOL)animated
+           resolve:(RCTPromiseResolveBlock)resolve
+            reject:(RCTPromiseRejectBlock)reject {
+  RCTExecuteOnMainQueue(^{
+    @synchronized(viewRegistry) {
+      // Find the root presented sheet (one without a parent TrueSheet)
+      TrueSheetView *rootSheet = nil;
+
+      for (TrueSheetView *view in viewRegistry.allValues) {
+        if (!view.viewController.isPresented) {
+          continue;
+        }
+
+        UIViewController *presenter = view.viewController.presentingViewController;
+        BOOL hasParentSheet = [presenter isKindOfClass:[TrueSheetViewController class]];
+
+        if (!hasParentSheet) {
+          rootSheet = view;
+          break;
+        }
+      }
+
+      if (!rootSheet) {
+        resolve(nil);
+        return;
+      }
+
+      [rootSheet dismissAllAnimated:animated
+                         completion:^(BOOL success, NSError *_Nullable error) {
+                           if (success) {
+                             resolve(nil);
+                           } else {
+                             reject(@"DISMISS_FAILED", error.localizedDescription ?: @"Failed to dismiss sheets",
+                                    error);
+                           }
+                         }];
+    }
+  });
+}
+
 #pragma mark - Helper Methods
 
 + (nullable TrueSheetView *)getTrueSheetViewByTag:(NSNumber *)reactTag {

ios/TrueSheetView.h

@@ -23,6 +23,8 @@ typedef void (^TrueSheetCompletionBlock)(BOOL success, NSError *_Nullable error)
 
 @interface TrueSheetView : RCTViewComponentView
 
+@property (nonatomic, readonly) TrueSheetViewController *viewController;
+
 // TurboModule methods
 - (void)presentAtIndex:(NSInteger)index
               animated:(BOOL)animated
@@ -32,6 +34,8 @@ typedef void (^TrueSheetCompletionBlock)(BOOL success, NSError *_Nullable error)
 
 - (void)resizeToIndex:(NSInteger)index completion:(nullable TrueSheetCompletionBlock)completion;
 
+- (void)dismissAllAnimated:(BOOL)animated completion:(nullable TrueSheetCompletionBlock)completion;
+
 @end
 
 NS_ASSUME_NONNULL_END