@lodev09/react-native-true-sheet 3.11.9 → 3.11.10

package/src/TrueSheet.tsx

@@ -42,6 +42,7 @@ import {
   findNodeHandle,
   processColor,
   type NativeEventSubscription,
+  type GestureResponderEvent,
 } from 'react-native';
 
 const LINKING_ERROR =
@@ -57,6 +58,13 @@ if (!TrueSheetModule) {
 
 type NativeRef = ComponentRef<typeof TrueSheetViewNativeComponent>;
 
+// Claim touches that no descendant claimed so the responder negotiation
+// doesn't bubble up to touchables outside the sheet
+const absorbUnclaimedTouches = () => true;
+
+// Stop raw touch events from bubbling past the sheet to outside ancestors
+const stopTouchPropagation = (event: GestureResponderEvent) => event.stopPropagation();
+
 interface TrueSheetState {
   shouldRenderNativeView: boolean;
 }
@@ -357,12 +365,18 @@ export class TrueSheet
   private handleBackPress(): boolean {
     if (!this.isPresented || !this.isSheetVisible) return false;
 
+    // The native view can be detached (e.g. host screen unmounted by navigation)
+    // before onDidDismiss removes this subscription. Treat back press as a no-op
+    // instead of throwing from the handle getter.
+    const nodeHandle = findNodeHandle(this.nativeRef.current);
+    if (nodeHandle == null || nodeHandle === -1) return false;
+
     // When not dismissible, let back propagate (e.g. navigation goes back to the previous screen)
     if (this.props.dismissible === false) {
       return this.props.onBackPress?.() ?? false;
     }
 
-    TrueSheetModule?.handleBackPress(this.handle);
+    TrueSheetModule?.handleBackPress(nodeHandle);
     return this.props.onBackPress?.() ?? true;
   }
 
@@ -446,6 +460,7 @@ export class TrueSheet
       draggable = true,
       grabber = true,
       grabberOptions,
+      accessibilityOptions,
       dimmed = true,
       initialDetentIndex = -1,
       initialDetentAnimated = true,
@@ -504,6 +519,7 @@ export class TrueSheet
         cornerRadius={cornerRadius}
         grabber={grabber}
         grabberOptions={this.resolvedGrabberOptions}
+        accessibilityOptions={accessibilityOptions}
         dimmed={dimmed}
         dimmedDetentIndex={dimmedDetentIndex}
         initialDetentIndex={initialDetentIndex}
@@ -538,6 +554,11 @@ export class TrueSheet
         {this.state.shouldRenderNativeView && (
           <TrueSheetContainerViewNativeComponent
             style={scrollable ? styles.scrollableContainer : undefined}
+            onStartShouldSetResponder={absorbUnclaimedTouches}
+            onTouchStart={stopTouchPropagation}
+            onTouchMove={stopTouchPropagation}
+            onTouchEnd={stopTouchPropagation}
+            onTouchCancel={stopTouchPropagation}
           >
             {header && (
               <TrueSheetHeaderViewNativeComponent style={[styles.header, headerStyle]}>

package/src/TrueSheet.types.ts

@@ -88,6 +88,71 @@ export interface GrabberOptions {
   adaptive?: boolean;
 }
 
+/**
+ * Options for customizing (e.g. localizing) the accessibility strings
+ * announced by screen readers.
+ *
+ * On iOS, the grabber strings only apply when `grabberOptions` is provided.
+ * Without it, iOS uses the system grabber which is already localized.
+ */
+export interface AccessibilityOptions {
+  /**
+   * The accessibility label of the grabber.
+   *
+   * @default iOS: 'Sheet Grabber', Android: 'Drag handle'
+   */
+  grabberLabel?: string;
+  /**
+   * The accessibility hint of the grabber.
+   *
+   * @platform ios
+   * @default 'Double-tap to expand. Swipe up or down to resize the sheet'
+   */
+  grabberHint?: string;
+  /**
+   * The value announced when the sheet is at the last detent.
+   *
+   * @default 'Expanded'
+   */
+  expandedValue?: string;
+  /**
+   * The value announced when the sheet is at the first detent.
+   *
+   * @default 'Collapsed'
+   */
+  collapsedValue?: string;
+  /**
+   * The value announced when the sheet is at an intermediate detent.
+   * Supports `{index}` and `{count}` placeholders.
+   *
+   * @default 'Detent {index} of {count}'
+   */
+  detentValue?: string;
+  /**
+   * The label of the expand accessibility action.
+   *
+   * @platform android
+   * @default 'Expand'
+   */
+  expandActionLabel?: string;
+  /**
+   * The label of the collapse accessibility action.
+   *
+   * @platform android
+   * @default 'Collapse'
+   */
+  collapseActionLabel?: string;
+  /**
+   * The title announced when the sheet appears.
+   * Sets the accessibility pane title on Android and the
+   * hidden dialog title on Web.
+   *
+   * @platform android, web
+   * @default Android: 'Bottom sheet', Web: 'Sheet'
+   */
+  paneTitle?: string;
+}
+
 /**
  * Scroll edge effect style for iOS 26+.
  * Controls the blur/gradient overlay applied to scroll view edges.
@@ -354,6 +419,12 @@ export interface TrueSheetProps extends ViewProps {
    */
   grabberOptions?: GrabberOptions;
 
+  /**
+   * Options for customizing (e.g. localizing) the accessibility strings
+   * announced by screen readers.
+   */
+  accessibilityOptions?: AccessibilityOptions;
+
   /**
    * Controls the sheet presentation style on iPad and web (landscape/tablet).
    * - `'page'`: bottom-attached page sheet (full or readable width).

package/src/TrueSheet.web.tsx

@@ -69,6 +69,7 @@ const TrueSheetComponent = forwardRef<TrueSheetMethods, TrueSheetProps>((props,
     anchorOffset = DEFAULT_ANCHOR_OFFSET,
     grabber = true,
     grabberOptions,
+    accessibilityOptions,
     detents = [0.5, 1],
     dimmed = true,
     dimmedDetentIndex = 0,
@@ -999,7 +1000,9 @@ const TrueSheetComponent = forwardRef<TrueSheetMethods, TrueSheetProps>((props,
               ) : undefined
             }
           >
-            <Drawer.Title style={visuallyHiddenStyle}>Sheet</Drawer.Title>
+            <Drawer.Title style={visuallyHiddenStyle}>
+              {accessibilityOptions?.paneTitle ?? 'Sheet'}
+            </Drawer.Title>
             {grabber && <Drawer.Handle style={handleStyle} />}
             {scrollable ? (
               // vaul wraps children in `[data-vaul-auto-size-wrapper]` (display:

package/src/fabric/TrueSheetViewNativeComponent.ts

@@ -16,6 +16,17 @@ type GrabberOptionsType = Readonly<{
   adaptive?: WithDefault<boolean, true>;
 }>;
 
+type AccessibilityOptionsType = Readonly<{
+  grabberLabel?: WithDefault<string, 'Sheet Grabber'>;
+  grabberHint?: WithDefault<string, 'Double-tap to expand. Swipe up or down to resize the sheet'>;
+  expandedValue?: WithDefault<string, 'Expanded'>;
+  collapsedValue?: WithDefault<string, 'Collapsed'>;
+  detentValue?: WithDefault<string, 'Detent {index} of {count}'>;
+  expandActionLabel?: WithDefault<string, 'Expand'>;
+  collapseActionLabel?: WithDefault<string, 'Collapse'>;
+  paneTitle?: WithDefault<string, 'Bottom sheet'>;
+}>;
+
 type BlurOptionsType = Readonly<{
   intensity?: WithDefault<Double, -1>;
   interaction?: WithDefault<boolean, true>;
@@ -99,6 +110,7 @@ export interface NativeProps extends ViewProps {
   // Boolean properties - match defaults from TrueSheet.types.ts
   grabber?: WithDefault<boolean, true>;
   grabberOptions?: GrabberOptionsType;
+  accessibilityOptions?: AccessibilityOptionsType;
   dismissible?: WithDefault<boolean, true>;
   draggable?: WithDefault<boolean, true>;
   dimmed?: WithDefault<boolean, true>;

package/src/navigation/types.ts

@@ -129,6 +129,7 @@ export type TrueSheetNavigationSheetProps = Pick<
   | 'draggable'
   | 'grabber'
   | 'grabberOptions'
+  | 'accessibilityOptions'
   | 'dimmed'
   | 'dimmedDetentIndex'
   | 'backgroundBlur'