@idealyst/navigation 1.2.129 → 1.2.130

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idealyst/navigation",
-  "version": "1.2.129",
+  "version": "1.2.130",
   "description": "Cross-platform navigation library for React and React Native",
   "readme": "README.md",
   "main": "src/index.ts",
@@ -45,9 +45,9 @@
   },
   "peerDependencies": {
     "@idealyst/camera": "^1.2.30",
-    "@idealyst/components": "^1.2.129",
+    "@idealyst/components": "^1.2.130",
     "@idealyst/microphone": "^1.2.30",
-    "@idealyst/theme": "^1.2.129",
+    "@idealyst/theme": "^1.2.130",
     "@react-navigation/bottom-tabs": ">=7.0.0",
     "@react-navigation/drawer": ">=7.0.0",
     "@react-navigation/native": ">=7.0.0",
@@ -74,13 +74,13 @@
     "@idealyst/animate": "^1.2.38",
     "@idealyst/blur": "^1.2.40",
     "@idealyst/camera": "^1.2.30",
-    "@idealyst/components": "^1.2.129",
+    "@idealyst/components": "^1.2.130",
     "@idealyst/datagrid": "^1.2.30",
     "@idealyst/datepicker": "^1.2.30",
     "@idealyst/lottie": "^1.2.38",
-    "@idealyst/markdown": "^1.2.129",
+    "@idealyst/markdown": "^1.2.130",
     "@idealyst/microphone": "^1.2.30",
-    "@idealyst/theme": "^1.2.129",
+    "@idealyst/theme": "^1.2.130",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "react": "^19.1.0",

package/src/routing/router.native.tsx

@@ -158,6 +158,7 @@ const buildScreen = (params: RouteParam, Navigator: TypedNavigator, parentPath =
             };
         }
 
+
         // Wrap headerLeft if it's a component
         if (options.headerLeft) {
             const HeaderLeftContent = options.headerLeft as React.ComponentType<any>;

package/src/routing/types.ts

@@ -6,6 +6,36 @@ import type { NavigateParams } from "../context/types";
  */
 export const NOT_FOUND_SCREEN_NAME = '__notFound__';
 
+/**
+ * Screen transition animation type.
+ * On native, maps directly to react-navigation's `animation` option.
+ * On web, this is a noop — no transition animations are applied.
+ *
+ * - "default" — platform default animation
+ * - "fade" — fades screen in or out
+ * - "fade_from_bottom" — fade from bottom animation
+ * - "flip" — flips the screen (iOS only, requires modal presentation)
+ * - "simple_push" — default animation without native header transition (iOS only)
+ * - "slide_from_bottom" — slides in from bottom
+ * - "slide_from_right" — slides in from right (Android only, default on iOS)
+ * - "slide_from_left" — slides in from left
+ * - "ios_from_right" — iOS-style slide from right (Android only, default on iOS)
+ * - "ios_from_left" — iOS-style slide from left (Android only, default on iOS)
+ * - "none" — no animation
+ */
+export type ScreenAnimation =
+    | 'default'
+    | 'fade'
+    | 'fade_from_bottom'
+    | 'flip'
+    | 'simple_push'
+    | 'slide_from_bottom'
+    | 'slide_from_right'
+    | 'slide_from_left'
+    | 'ios_from_right'
+    | 'ios_from_left'
+    | 'none';
+
 /**
  * Tab bar specific screen options
  */
@@ -86,6 +116,14 @@ export type ScreenOptions = {
      * Native: Screen uses fullScreenModal presentation
      */
     fullScreen?: boolean;
+    /**
+     * Screen transition animation.
+     * On native, controls how the screen animates when pushed/popped.
+     * On web, this is a noop.
+     *
+     * @default 'default' (platform default)
+     */
+    animation?: ScreenAnimation;
 
 } & NavigatorOptions;