@lodev09/react-native-true-sheet 4.0.0-beta.2 → 4.0.0-beta.20

package/src/TrueSheetBackground.tsx

@@ -0,0 +1,17 @@
+import { StyleSheet, View } from 'react-native';
+import type { TrueSheetProps } from './TrueSheet.types';
+
+export const TrueSheetBackground = ({
+  background,
+  backgroundStyle,
+}: Pick<TrueSheetProps, 'background' | 'backgroundStyle'>) => (
+  <View
+    pointerEvents="none"
+    style={[
+      StyleSheet.absoluteFill,
+      { backgroundColor: StyleSheet.flatten(backgroundStyle)?.backgroundColor },
+    ]}
+  >
+    {background}
+  </View>
+);

package/src/TrueSheetOverlay.tsx

@@ -0,0 +1,24 @@
+import { StyleSheet, type ViewProps } from 'react-native';
+
+import TrueSheetOverlayViewNativeComponent from './fabric/TrueSheetOverlayViewNativeComponent';
+
+/**
+ * Renders its children in a native layer above every presented sheet — for
+ * toasts, dialogs, and other content a sheet must not cover.
+ * Fills the window; touches that miss its children pass through to the views beneath.
+ */
+export const TrueSheetOverlay = ({ style, ...rest }: ViewProps) => (
+  <TrueSheetOverlayViewNativeComponent {...rest} style={[styles.overlay, style]} />
+);
+
+const styles = StyleSheet.create({
+  // Sized to the window from native — absolute so it takes no layout space.
+  // Children render in a native container, so the host itself must never
+  // catch touches (Android forces it visible on layout).
+  overlay: {
+    position: 'absolute',
+    top: 0,
+    left: 0,
+    pointerEvents: 'none',
+  },
+});

package/src/TrueSheetOverlay.web.tsx

@@ -0,0 +1,33 @@
+/// <reference lib="dom" />
+import { useLayoutEffect, useState } from 'react';
+import { createPortal } from 'react-dom';
+import { StyleSheet, View, type ViewProps } from 'react-native';
+
+/**
+ * Renders its children in a layer above every presented sheet — for
+ * toasts, dialogs, and other content a sheet must not cover.
+ * Fills the window; touches that miss its children pass through to the views beneath.
+ */
+export const TrueSheetOverlay = ({ style, ...rest }: ViewProps) => {
+  // Portal target appended to the body so it stacks above the sheets' portal
+  const [container] = useState(() =>
+    typeof document !== 'undefined' ? document.createElement('div') : null
+  );
+
+  useLayoutEffect(() => {
+    if (!container) return;
+
+    container.style.cssText = 'position:fixed;inset:0;pointer-events:none';
+    document.body.appendChild(container);
+    return () => {
+      container.remove();
+    };
+  }, [container]);
+
+  if (!container) return null;
+
+  return createPortal(
+    <View pointerEvents="box-none" {...rest} style={[StyleSheet.absoluteFill, style]} />,
+    container
+  );
+};

package/src/TrueSheetPeek.web.tsx

@@ -1,16 +1,15 @@
-import { createContext, type RefObject, useContext, useEffect, useRef } from 'react';
+import { createContext, type RefObject, useContext, useLayoutEffect, useRef } from 'react';
 import { type LayoutChangeEvent, View, type ViewProps } from 'react-native';
 
-import { getDOMElement } from './web/dom';
-
 /**
- * Reports the measured peek content height to the owning TrueSheet.
+ * Registers a peek with the owning TrueSheet so it can measure the peek live.
  * @internal
  */
 export interface TrueSheetPeekContextValue {
   contentRef: RefObject<View | null>;
-  peekRef: RefObject<View | null>;
-  setPeekContentHeight: (height: number) => void;
+  attachPeek: (view: View) => void;
+  detachPeek: (view: View) => void;
+  measurePeek: (view: View) => void;
 }
 
 export const TrueSheetPeekContext = createContext<TrueSheetPeekContextValue | null>(null);
@@ -19,14 +18,19 @@ export const TrueSheetPeekContext = createContext<TrueSheetPeekContextValue | nu
  * Distance from the top of the content view to the bottom of the peek view,
  * so the peek view's offset within the content (padding, views above it)
  * counts toward the peek detent. Both rects live in the drawer's transformed
- * subtree, so an in-flight translate cancels out of the delta.
+ * subtree, so an in-flight translate cancels out of the delta. Rounded so the
+ * sub-pixel noise of a mid-transition measurement doesn't register as a
+ * change — the content re-measures every frame while the snap animates, and
+ * a new value would restart the snap.
  * @internal
  */
 export const measurePeekContentHeight = (
   peekElement: HTMLElement,
   contentElement: HTMLElement
 ): number =>
-  peekElement.getBoundingClientRect().bottom - contentElement.getBoundingClientRect().top;
+  Math.round(
+    peekElement.getBoundingClientRect().bottom - contentElement.getBoundingClientRect().top
+  );
 
 /**
  * Wrapper component that marks its children as the sheet's peek content.
@@ -36,25 +40,23 @@ export const measurePeekContentHeight = (
  */
 export const TrueSheetPeek = ({ onLayout, ...rest }: ViewProps) => {
   const context = useContext(TrueSheetPeekContext);
-  const localRef = useRef<View>(null);
+  const viewRef = useRef<View>(null);
 
-  // Register into the sheet's peek ref so it can measure the peek live
-  // during detent geometry computation (state lags the first willPresent).
-  const viewRef = context?.peekRef ?? localRef;
+  // Attach by instance rather than sharing a ref — during a screen swap the
+  // incoming peek mounts before the outgoing one unmounts, and a shared ref
+  // would be nulled by the outgoing unmount.
+  useLayoutEffect(() => {
+    const view = viewRef.current;
+    if (!context || !view) return;
 
-  useEffect(() => () => context?.setPeekContentHeight(0), [context]);
+    context.attachPeek(view);
+    return () => context.detachPeek(view);
+  }, [context]);
 
   const handleLayout = (event: LayoutChangeEvent) => {
-    if (context) {
-      const peekElement = getDOMElement(viewRef.current);
-      const contentElement = getDOMElement(context.contentRef.current);
-
-      const bottom =
-        peekElement && contentElement
-          ? measurePeekContentHeight(peekElement, contentElement)
-          : event.nativeEvent.layout.height;
-
-      context.setPeekContentHeight(bottom);
+    const view = viewRef.current;
+    if (context && view) {
+      context.measurePeek(view);
     }
 
     onLayout?.(event);

package/src/detentBackgrounds.ts

@@ -0,0 +1,24 @@
+import type { DetentBackground } from './TrueSheet.types';
+
+export function normalizeDetentBackground(entry: DetentBackground | null | undefined) {
+  return typeof entry === 'string' ? { color: entry } : entry;
+}
+
+export function getDetentBackgroundIndex(
+  height: number,
+  detentHeights: readonly number[],
+  displayedIndex: number
+): number {
+  if (detentHeights.length === 0) return -1;
+
+  let nextIndex = Math.max(0, Math.min(displayedIndex, detentHeights.length - 1));
+  let distance = Math.abs(height - detentHeights[nextIndex]!);
+  for (let index = 0; index < detentHeights.length; index++) {
+    const nextDistance = Math.abs(height - detentHeights[index]!);
+    if (nextDistance < distance) {
+      nextIndex = index;
+      distance = nextDistance;
+    }
+  }
+  return nextIndex;
+}

package/src/fabric/TrueSheetContentViewNativeComponent.ts

@@ -6,7 +6,7 @@ export interface NativeProps extends ViewProps {
 }
 
 // interfaceOnly: shadow node/state/descriptor are custom (common/cpp) so the
-// content can be bounded to the container when a ScrollView is pinned
+// content can be bounded to the container when a ScrollView is detected
 export default codegenNativeComponent<NativeProps>('TrueSheetContentView', {
   interfaceOnly: true,
 });

package/src/fabric/TrueSheetOverlayViewNativeComponent.ts

@@ -0,0 +1,12 @@
+import type { ViewProps } from 'react-native';
+import { codegenNativeComponent } from 'react-native';
+
+export interface NativeProps extends ViewProps {
+  // No props needed - sized to the window from native
+}
+
+// interfaceOnly: shadow node/state/descriptor are custom (common/cpp) so the
+// overlay is sized to the window
+export default codegenNativeComponent<NativeProps>('TrueSheetOverlayView', {
+  interfaceOnly: true,
+});

package/src/fabric/TrueSheetViewNativeComponent.ts

@@ -27,15 +27,12 @@ type AccessibilityOptionsType = Readonly<{
   paneTitle?: WithDefault<string, 'Bottom sheet'>;
 }>;
 
-type BlurOptionsType = Readonly<{
-  intensity?: WithDefault<Double, -1>;
-  interaction?: WithDefault<boolean, true>;
-}>;
-
 type ScrollEdgeEffect = 'automatic' | 'hard' | 'soft' | 'hidden';
 
 type ScrollableOptionsType = Readonly<{
+  contentInsetAdjustment?: WithDefault<'automatic' | 'safe-area' | 'footer' | 'never', 'automatic'>;
   keyboardScrollOffset?: WithDefault<Double, 0>;
+  keyboardOffset?: WithDefault<Double, 0>;
   scrollingExpandsSheet?: WithDefault<boolean, true>;
   topScrollEdgeEffect?: WithDefault<ScrollEdgeEffect, 'hidden'>;
   bottomScrollEdgeEffect?: WithDefault<ScrollEdgeEffect, 'hidden'>;
@@ -46,6 +43,7 @@ type FooterOptionsType = Readonly<{
   // the field name, so a second `position` would redefine TrueSheetViewPosition
   footerPosition?: WithDefault<'relative' | 'absolute', 'relative'>;
   keyboardOffset?: WithDefault<Double, 0>;
+  avoidKeyboard?: WithDefault<boolean, true>;
 }>;
 
 type HeaderOptionsType = Readonly<{
@@ -68,6 +66,12 @@ export interface PositionChangeEventPayload {
 export interface NativeProps extends ViewProps {
   // Array properties
   detents?: ReadonlyArray<Double>;
+  detentBackgrounds?: ReadonlyArray<
+    Readonly<{
+      color?: ProcessedColorValue | null;
+      blur?: string;
+    }>
+  >;
 
   // Number properties - use 0 as default to avoid nil insertion
   maxContentHeight?: WithDefault<Double, 0>;
@@ -107,13 +111,10 @@ export interface NativeProps extends ViewProps {
     'none'
   >;
 
-  anchor?: WithDefault<'left' | 'center' | 'right', 'center'>;
-  anchorOffset?: WithDefault<Double, 16>;
+  placement?: WithDefault<'automatic' | 'leading' | 'center' | 'trailing', 'automatic'>;
+  placementOffset?: WithDefault<Double, 16>;
   insetAdjustment?: WithDefault<'automatic' | 'never', 'automatic'>;
 
-  // Blur options
-  blurOptions?: BlurOptionsType;
-
   // Boolean properties - match defaults from TrueSheet.types.ts
   grabber?: WithDefault<boolean, true>;
   grabberOptions?: GrabberOptionsType;
@@ -122,6 +123,8 @@ export interface NativeProps extends ViewProps {
   draggable?: WithDefault<boolean, true>;
   dimmed?: WithDefault<boolean, true>;
   initialDetentAnimated?: WithDefault<boolean, true>;
+  // React tag of the scrollable component within the content (see scrollableRef)
+  scrollableHandle?: WithDefault<Int32, -1>;
   scrollableOptions?: ScrollableOptionsType;
   headerOptions?: HeaderOptionsType;
   footerOptions?: FooterOptionsType;
@@ -133,6 +136,7 @@ export interface NativeProps extends ViewProps {
   onDidPresent?: DirectEventHandler<DetentInfoEventPayload>;
   onWillDismiss?: DirectEventHandler<null>;
   onDidDismiss?: DirectEventHandler<null>;
+  onDismissAttempt?: DirectEventHandler<null>;
   onDetentChange?: DirectEventHandler<DetentInfoEventPayload>;
   onDragBegin?: DirectEventHandler<DetentInfoEventPayload>;
   onDragChange?: DirectEventHandler<DetentInfoEventPayload>;

package/src/index.ts

@@ -1,4 +1,5 @@
 export * from './TrueSheet';
 export * from './TrueSheet.types';
 export { TrueSheetPeek } from './TrueSheetPeek';
+export { TrueSheetOverlay } from './TrueSheetOverlay';
 export { TrueSheetProvider, useTrueSheet } from './TrueSheetProvider';

package/src/mocks/index.ts

@@ -2,6 +2,7 @@ import React, { createElement, isValidElement, type ReactNode } from 'react';
 import { View, type ViewProps } from 'react-native';
 
 import type { TrueSheetProps, TrueSheetStaticMethods } from '../TrueSheet.types';
+import { TrueSheetBackground } from '../TrueSheetBackground';
 
 interface TrueSheetState {
   shouldRenderNativeView: boolean;
@@ -54,8 +55,15 @@ export class TrueSheet extends React.Component<TrueSheetProps, TrueSheetState> {
   }
 
   render() {
-    const { children, style } = this.props;
-    return React.createElement(View, { style }, this.renderHeader(), children, this.renderFooter());
+    const { children, style, background, backgroundStyle } = this.props;
+    return React.createElement(
+      View,
+      { style },
+      React.createElement(TrueSheetBackground, { background, backgroundStyle }),
+      this.renderHeader(),
+      children,
+      this.renderFooter()
+    );
   }
 }
 
@@ -66,6 +74,13 @@ export function TrueSheetPeek({ children, ...rest }: ViewProps) {
   return React.createElement(View, rest, children);
 }
 
+/**
+ * Mock TrueSheetOverlay component for testing.
+ */
+export function TrueSheetOverlay({ children, ...rest }: ViewProps) {
+  return React.createElement(View, rest, children);
+}
+
 /**
  * Mock TrueSheetProvider for testing.
  */

package/src/mocks/navigationExpoRouter.ts

@@ -1,6 +1,5 @@
-import type { ParamListBase } from '@react-navigation/native';
-
-import type { TrueSheetNavigationProp } from '../navigation/types';
+import type { ParamListBase } from '../navigation/expo-router/base-types';
+import type { TrueSheetNavigationProp } from '../navigation/expo-router/types';
 import {
   TrueSheetActions,
   useTrueSheetNavigation as useTrueSheetNavigationMock,
@@ -22,8 +21,10 @@ export const Sheet = Object.assign(
  * Mock useTrueSheetNavigation hook for testing.
  */
 export const useTrueSheetNavigation = jest.fn(
+  // Double cast: the shared mock is typed against React Navigation, this entry
+  // against Expo Router's vendored copy — identical shapes, unrelated declarations
   <T extends ParamListBase = ParamListBase>(): TrueSheetNavigationProp<T> =>
-    useTrueSheetNavigationMock() as TrueSheetNavigationProp<T>
+    useTrueSheetNavigationMock() as unknown as TrueSheetNavigationProp<T>
 );
 
 export { TrueSheetActions };
@@ -37,4 +38,4 @@ export type {
   TrueSheetNavigationProp,
   TrueSheetNavigationState,
   TrueSheetScreenProps,
-} from '../navigation/types';
+} from '../navigation/expo-router/types';

package/src/navigation/base-types.ts

@@ -0,0 +1,20 @@
+/**
+ * Base navigation types for the React Navigation entry point.
+ *
+ * The Expo Router entry has its own copy sourced from `expo-router/react-navigation`
+ * (see `./expo-router/base-types`) because Expo Router apps never install
+ * `@react-navigation/*` — importing it there would silently resolve to `any`.
+ */
+export type {
+  DefaultNavigatorOptions,
+  Descriptor,
+  NavigationAction,
+  NavigationHelpers,
+  NavigationProp,
+  NavigationState,
+  ParamListBase,
+  RouteProp,
+  Router,
+  StackActionHelpers,
+  StackRouterOptions,
+} from '@react-navigation/core';

package/src/navigation/createTrueSheetRouter.ts

@@ -1,29 +1,5 @@
-import type {
-  NavigationAction,
-  NavigationState,
-  ParamListBase,
-  Router,
-  StackRouterOptions,
-} from '@react-navigation/core';
-
-import { TrueSheetActions, type TrueSheetActionType } from './actions';
-import type { TrueSheetNavigationState } from './types';
-
-export type TrueSheetRouterOptions = StackRouterOptions;
-
-/**
- * The base `StackRouter` factory to wrap, typed generically over the state and
- * action types the wrapper threads through — `StackRouter` is structural and
- * never touches the sheet-specific fields.
- * Injected by each entry point so the shared router never imports
- * `@react-navigation/*` at runtime (Expo Router apps don't install it).
- */
-export type StackRouterFactory = <
-  State extends NavigationState<ParamListBase>,
-  Action extends NavigationAction,
->(
-  options: TrueSheetRouterOptions
-) => Router<State, Action>;
+import { TrueSheetActions } from './actions';
+import type { TrueSheetRouter, TrueSheetRouterFactory, TrueSheetRouterOptions } from './types';
 
 const uid = () => Math.random().toString(36).slice(2, 10);
 
@@ -56,13 +32,9 @@ const ensureBaseRoute = <T extends { routes: { name: string }[] }>(
 };
 
 export const createTrueSheetRouter =
-  (stackRouter: StackRouterFactory) =>
-  (
-    routerOptions: TrueSheetRouterOptions
-  ): Router<TrueSheetNavigationState<ParamListBase>, TrueSheetActionType> => {
-    const baseRouter = stackRouter<TrueSheetNavigationState<ParamListBase>, TrueSheetActionType>(
-      routerOptions
-    );
+  (stackRouter: TrueSheetRouterFactory) =>
+  (routerOptions: TrueSheetRouterOptions): TrueSheetRouter => {
+    const baseRouter = stackRouter(routerOptions);
 
     return {
       ...baseRouter,

package/src/navigation/expo-router/base-types.ts

@@ -0,0 +1,18 @@
+/**
+ * Base navigation types for the Expo Router entry point.
+ *
+ * Sourced from Expo Router's vendored React Navigation so apps that only install
+ * `expo-router` still get real types — see `../base-types` for the React Navigation copy.
+ */
+export type {
+  DefaultNavigatorOptions,
+  NavigationAction,
+  NavigationHelpers,
+  NavigationProp,
+  NavigationState,
+  ParamListBase,
+  RouteProp,
+  Router,
+  StackActionHelpers,
+  StackRouterOptions,
+} from 'expo-router/react-navigation';

package/src/navigation/expo-router/index.ts

@@ -1,48 +1,46 @@
-import type { ParamListBase } from '@react-navigation/core';
 import { StackRouter, unstable_integrateWithRouter, useNavigation } from 'expo-router';
 
-import {
-  createTrueSheetRouter,
-  type StackRouterFactory,
-  type TrueSheetRouterOptions,
-} from '../createTrueSheetRouter';
+import { createTrueSheetRouter } from '../createTrueSheetRouter';
 import { trueSheetNavigator } from '../navigator';
+import type { ParamListBase } from './base-types';
 import type {
+  StackRouterFactory,
   TrueSheetNavigationOptions,
   TrueSheetNavigationProp,
   TrueSheetNavigationState,
   TrueSheetNavigatorContentExtraProps,
   TrueSheetNavigatorProps,
+  TrueSheetRouterFactory,
+  TrueSheetRouterOptions,
   TrueSheetStandardEventMap,
-} from '../types';
+} from './types';
 
+// expo-router's vendored StackRouter is structurally identical to @react-navigation's.
+// Pinned to this entry's own router types: `createTrueSheetRouter` is shared and typed
+// against React Navigation, which resolves to `any` in apps that only install expo-router.
+const sheetRouter: TrueSheetRouterFactory = createTrueSheetRouter(
+  StackRouter as StackRouterFactory
+);
+
+// `routes`/`dispatch` are injected by `createProps`, so they are declared as
+// CreateProps (last generic) and excluded from the public navigator props
 const SheetNavigator = unstable_integrateWithRouter<
   TrueSheetNavigationOptions,
   TrueSheetNavigationState<ParamListBase>,
   TrueSheetStandardEventMap,
-  TrueSheetNavigatorContentExtraProps,
-  TrueSheetRouterOptions
->(
-  trueSheetNavigator,
-  // expo-router's vendored StackRouter is structurally identical to @react-navigation's
-  createTrueSheetRouter(StackRouter as StackRouterFactory),
-  {
-    createProps: ({ state, dispatch }) => ({
-      routes: state.routes,
-      dispatch,
-    }),
-  }
-);
+  object,
+  TrueSheetRouterOptions,
+  TrueSheetNavigatorContentExtraProps
+>(trueSheetNavigator, sheetRouter, {
+  createProps: ({ state, dispatch }) => ({
+    routes: state.routes,
+    dispatch,
+  }),
+});
 
-// Public props: `routes`/`dispatch` are injected by `createProps` (optional here
-// so the navigator type stays comparable), and expo-router intersects the event
-// map with an index signature which breaks precisely typed `screenListeners`
-// callbacks - replace it with the exact map
-type SheetProps = Omit<
-  React.ComponentProps<typeof SheetNavigator>,
-  'screenListeners' | 'routes' | 'dispatch'
-> &
-  Partial<Pick<React.ComponentProps<typeof SheetNavigator>, 'routes' | 'dispatch'>> &
+// expo-router intersects the event map with an index signature which breaks
+// precisely typed `screenListeners` callbacks - replace it with the exact map
+type SheetProps = Omit<React.ComponentProps<typeof SheetNavigator>, 'screenListeners'> &
   Pick<TrueSheetNavigatorProps, 'screenListeners'>;
 
 /**
@@ -86,4 +84,4 @@ export type {
   TrueSheetNavigationProp,
   TrueSheetNavigationState,
   TrueSheetScreenProps,
-} from '../types';
+} from './types';

package/src/navigation/expo-router/types.ts

@@ -0,0 +1,116 @@
+/**
+ * Expo Router flavour of `../types`: same shapes, but bound to Expo Router's
+ * vendored React Navigation types so apps that only install `expo-router` still
+ * get real types instead of `any` — see `./base-types`.
+ */
+import type { TrueSheetActionType } from '../actions';
+import type {
+  TrueSheetActionHelpersOf,
+  TrueSheetDispatch,
+  TrueSheetNavigationEventMap,
+  TrueSheetNavigationOptions,
+  TrueSheetStateOf,
+} from '../types';
+import type {
+  DefaultNavigatorOptions,
+  NavigationAction,
+  NavigationHelpers,
+  NavigationProp,
+  NavigationState,
+  ParamListBase,
+  RouteProp,
+  Router,
+  StackActionHelpers,
+  StackRouterOptions,
+} from './base-types';
+
+export type TrueSheetRouterOptions = StackRouterOptions;
+
+export type TrueSheetNavigationState<ParamList extends ParamListBase> = TrueSheetStateOf<
+  NavigationState<ParamList>
+>;
+
+export type TrueSheetRouterState = TrueSheetNavigationState<ParamListBase>;
+
+export type TrueSheetRouter = Router<TrueSheetRouterState, TrueSheetActionType>;
+
+export type TrueSheetRouterFactory = (options: TrueSheetRouterOptions) => TrueSheetRouter;
+
+/**
+ * The base `StackRouter` factory to wrap — see `../types` for the shared contract.
+ */
+export type StackRouterFactory = <
+  State extends NavigationState<ParamListBase>,
+  Action extends NavigationAction,
+>(
+  options: TrueSheetRouterOptions
+) => Router<State, Action>;
+
+export type TrueSheetRoute = TrueSheetNavigationState<ParamListBase>['routes'][number];
+
+/**
+ * Props injected into the navigator content by Expo Router's `createProps`.
+ * Raw routes carry the custom fields (`closing`, `resizeIndex`, `resizeKey`)
+ * that the standard state strips out.
+ */
+export interface TrueSheetNavigatorContentExtraProps {
+  routes: TrueSheetRoute[];
+  dispatch: TrueSheetDispatch;
+}
+
+export type TrueSheetActionHelpers<ParamList extends ParamListBase> = TrueSheetActionHelpersOf<
+  StackActionHelpers<ParamList>
+>;
+
+export type TrueSheetNavigationProp<
+  ParamList extends ParamListBase,
+  RouteName extends keyof ParamList = string,
+  NavigatorID extends string | undefined = undefined,
+> = NavigationProp<
+  ParamList,
+  RouteName,
+  NavigatorID,
+  TrueSheetNavigationState<ParamList>,
+  TrueSheetNavigationOptions,
+  TrueSheetNavigationEventMap
+> &
+  TrueSheetActionHelpers<ParamList>;
+
+export type TrueSheetScreenProps<
+  ParamList extends ParamListBase,
+  RouteName extends keyof ParamList = string,
+  NavigatorID extends string | undefined = undefined,
+> = {
+  navigation: TrueSheetNavigationProp<ParamList, RouteName, NavigatorID>;
+  route: RouteProp<ParamList, RouteName>;
+};
+
+export type TrueSheetNavigationHelpers = NavigationHelpers<
+  ParamListBase,
+  TrueSheetNavigationEventMap
+>;
+
+export type TrueSheetNavigatorProps = DefaultNavigatorOptions<
+  ParamListBase,
+  string | undefined,
+  TrueSheetNavigationState<ParamListBase>,
+  TrueSheetNavigationOptions,
+  TrueSheetNavigationEventMap,
+  unknown
+> & {
+  /**
+   * The name of the route to use as the base screen.
+   * This screen will be rendered as a regular screen, while other screens are presented as sheets.
+   * Defaults to the first screen defined in the navigator.
+   */
+  initialRouteName?: string;
+};
+
+export type {
+  PositionChangeHandler,
+  TrueSheetDispatch,
+  TrueSheetNavigationEventMap,
+  TrueSheetNavigationOptions,
+  TrueSheetNavigationSheetProps,
+  TrueSheetStandardEventMap,
+} from '../types';