docs: update README and types for RTL support clarification

Author: AlshehriAli0

README.md

@@ -16,7 +16,7 @@ An extremely lightweight, opinionated toast component for React Native.
 - Promise handling with automatic loading → success/error states
 - Toast stacking with configurable limits
 - **Works above modals** - automatic on iOS, simple setup on Android
-- **RTL support** - perfect for Arabic and other RTL languages
+- **RTL support** - code-level RTL for when you're not using native RTL (`I18nManager`)
 - Completely customizable - colors, icons, styles, animations
 - Full Expo compatibility
 
@@ -181,7 +181,7 @@ Customize all toasts globally via the `config` prop on `<BreadLoaf />`:
 <BreadLoaf
   config={{
     position: 'bottom',
-    rtl: false, // Enable for RTL languages
+    rtl: false, // Code-level RTL — not needed if using native RTL (I18nManager)
     stacking: true,
     maxStack: 3,
     defaultDuration: 4000,

packages/react-native-bread/src/types.ts

@@ -43,7 +43,11 @@ export interface ToastTheme {
   position: ToastPosition;
   /** Extra offset from safe area edge (in addition to safe area insets) */
   offset: number;
-  /** Enable right-to-left layout (reverses icon/text order) */
+  /**
+   * Enable right-to-left layout at the code level (reverses icon/text order and text alignment).
+   * Only needed when you handle RTL in JavaScript — native RTL (e.g. via `I18nManager.forceRTL`)
+   * already flips the entire layout automatically, so this option is unnecessary in that case.
+   */
   rtl: boolean;
   /** Whether to show multiple toasts stacked (default: true). When false, only one toast shows at a time. */
   stacking: boolean;