react-native-screen-transitions 3.1.0 → 3.2.0-beta.0

package/lib/module/component-stack/hooks/use-component-navigation-builder.js

@@ -0,0 +1,316 @@
+"use strict";
+
+import * as React from "react";
+import { useCallback, useMemo, useReducer, useRef } from "react";
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+// Generate unique keys for routes
+let keyCounter = 0;
+const generateKey = () => `component-route-${++keyCounter}`;
+
+// Generate unique key for stack instance
+const generateStackKey = () => `component-stack-${Date.now()}`;
+function createRoute(name, params) {
+  return {
+    key: generateKey(),
+    name,
+    params
+  };
+}
+function navigationReducer(state, action) {
+  switch (action.type) {
+    case "PUSH":
+      {
+        if (!action.screens[action.name]) {
+          console.warn(`[ComponentStack] Screen "${action.name}" not found in navigator`);
+          return state;
+        }
+        const newRoute = createRoute(action.name, action.params);
+        return {
+          ...state,
+          routes: [...state.routes, newRoute],
+          index: state.routes.length
+        };
+      }
+    case "POP":
+      {
+        if (state.routes.length <= 1) {
+          return state;
+        }
+        return {
+          ...state,
+          routes: state.routes.slice(0, -1),
+          index: state.index - 1
+        };
+      }
+    case "POP_BY_KEY":
+      {
+        const routeIndex = state.routes.findIndex(route => route.key === action.key);
+        if (routeIndex === -1) {
+          // Route not found, nothing to do
+          return state;
+        }
+        if (state.routes.length <= 1) {
+          // Can't pop the last route
+          return state;
+        }
+        const nextRoutes = state.routes.filter(route => route.key !== action.key);
+        return {
+          ...state,
+          routes: nextRoutes,
+          index: Math.min(state.index, nextRoutes.length - 1)
+        };
+      }
+    case "NAVIGATE":
+      {
+        if (!action.screens[action.name]) {
+          console.warn(`[ComponentStack] Screen "${action.name}" not found in navigator`);
+          return state;
+        }
+        // Check if screen already exists in stack
+        const existingIndex = state.routes.findIndex(route => route.name === action.name);
+        if (existingIndex !== -1) {
+          // Navigate to existing screen (pop to it)
+          return {
+            ...state,
+            routes: state.routes.slice(0, existingIndex + 1),
+            index: existingIndex
+          };
+        }
+        // Push new screen
+        const newRoute = createRoute(action.name, action.params);
+        return {
+          ...state,
+          routes: [...state.routes, newRoute],
+          index: state.routes.length
+        };
+      }
+    case "RESET":
+      {
+        const targetName = action.name || action.initialRouteName;
+        if (!action.screens[targetName]) {
+          console.warn(`[ComponentStack] Screen "${targetName}" not found in navigator`);
+          return state;
+        }
+        const newRoute = createRoute(targetName, action.params);
+        return {
+          ...state,
+          routes: [newRoute],
+          index: 0
+        };
+      }
+    default:
+      return state;
+  }
+}
+/**
+ * Parse children to extract screen configurations.
+ * Expects children to be ComponentScreen elements.
+ */
+function parseScreens(children) {
+  const screens = {};
+  React.Children.forEach(children, child => {
+    if (! /*#__PURE__*/React.isValidElement(child)) {
+      return;
+    }
+    const props = child.props;
+    if (props.name && props.component) {
+      screens[props.name] = {
+        name: props.name,
+        component: props.component,
+        options: props.options
+      };
+    }
+  });
+  return screens;
+}
+export function useComponentNavigationBuilder({
+  children,
+  initialRouteName,
+  screenOptions
+}) {
+  // Parse screen configs from children
+  const screens = useMemo(() => parseScreens(children), [children]);
+
+  // Determine initial route
+  const screenNames = Object.keys(screens);
+  const initialRoute = initialRouteName || screenNames[0];
+  if (!initialRoute) {
+    throw new Error("[ComponentStack] No screens defined. Add at least one ComponentStack.Screen child.");
+  }
+
+  // Stable stack key
+  const stackKeyRef = useRef(generateStackKey());
+
+  // Navigation state reducer
+  const [state, internalDispatch] = useReducer((state, action) => navigationReducer(state, {
+    ...action,
+    screens,
+    initialRouteName: initialRoute
+  }), {
+    routes: [createRoute(initialRoute)],
+    index: 0,
+    key: stackKeyRef.current
+  });
+
+  // Dispatch method that handles both internal actions and StackActions format
+  const dispatch = useCallback(action => {
+    // Handle StackActions.pop() format from useLocalRoutes: { type: 'POP', source: routeKey }
+    if (action.type === "POP" && "source" in action && typeof action.source === "string") {
+      internalDispatch({
+        type: "POP_BY_KEY",
+        key: action.source
+      });
+      return;
+    }
+
+    // Handle standard internal actions
+    switch (action.type) {
+      case "PUSH":
+        if ("name" in action && typeof action.name === "string") {
+          internalDispatch({
+            type: "PUSH",
+            name: action.name,
+            params: action.params
+          });
+        }
+        break;
+      case "POP":
+        internalDispatch({
+          type: "POP"
+        });
+        break;
+      case "NAVIGATE":
+        if ("name" in action && typeof action.name === "string") {
+          internalDispatch({
+            type: "NAVIGATE",
+            name: action.name,
+            params: action.params
+          });
+        }
+        break;
+      case "RESET":
+        internalDispatch({
+          type: "RESET",
+          name: "name" in action ? action.name : undefined,
+          params: "params" in action ? action.params : undefined
+        });
+        break;
+      case "POP_BY_KEY":
+        if ("key" in action && typeof action.key === "string") {
+          internalDispatch({
+            type: "POP_BY_KEY",
+            key: action.key
+          });
+        }
+        break;
+    }
+  }, []);
+
+  // Ref for getState to always return latest state
+  const stateRef = useRef(state);
+  stateRef.current = state;
+
+  // Navigation object
+  const navigation = useMemo(() => {
+    return {
+      push: (name, params) => {
+        internalDispatch({
+          type: "PUSH",
+          name,
+          params
+        });
+      },
+      pop: () => {
+        internalDispatch({
+          type: "POP"
+        });
+      },
+      goBack: () => {
+        internalDispatch({
+          type: "POP"
+        });
+      },
+      navigate: (name, params) => {
+        internalDispatch({
+          type: "NAVIGATE",
+          name,
+          params
+        });
+      },
+      canGoBack: () => stateRef.current.routes.length > 1,
+      reset: (name, params) => {
+        internalDispatch({
+          type: "RESET",
+          name,
+          params
+        });
+      },
+      dispatch,
+      getState: () => stateRef.current,
+      index: state.index
+    };
+  }, [state.index, dispatch]);
+
+  // Build descriptors for each route
+  const descriptors = useMemo(() => {
+    const result = {};
+    for (const route of state.routes) {
+      const screenConfig = screens[route.name];
+      if (!screenConfig) {
+        continue;
+      }
+      const Component = screenConfig.component;
+      const mergedOptions = {
+        ...screenOptions,
+        ...screenConfig.options
+      };
+      const descriptor = {
+        route,
+        navigation,
+        options: mergedOptions,
+        render: () => /*#__PURE__*/_jsx(Component, {
+          navigation: navigation,
+          route: route
+        })
+      };
+      result[route.key] = descriptor;
+    }
+    return result;
+  }, [state.routes, screens, screenOptions, navigation]);
+
+  // Describe function: creates a descriptor for a route (used for placeholder screens)
+  const describe = useCallback((route, placeholder) => {
+    const screenConfig = screens[route.name];
+    const mergedOptions = {
+      ...screenOptions,
+      ...screenConfig?.options
+    };
+    const Component = screenConfig?.component;
+    return {
+      route,
+      navigation,
+      options: mergedOptions,
+      render: () => placeholder || !Component ? null : /*#__PURE__*/_jsx(Component, {
+        navigation: navigation,
+        route: route
+      })
+    };
+  }, [screens, screenOptions, navigation]);
+
+  // NavigationContent wrapper (simple pass-through for component-stack)
+  const NavigationContent = useCallback(({
+    children
+  }) => {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: children
+    });
+  }, []);
+  return {
+    state,
+    navigation,
+    describe,
+    descriptors,
+    NavigationContent
+  };
+}
+//# sourceMappingURL=use-component-navigation-builder.js.map

package/lib/module/component-stack/hooks/use-component-navigation-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useCallback","useMemo","useReducer","useRef","jsx","_jsx","Fragment","_Fragment","keyCounter","generateKey","generateStackKey","Date","now","createRoute","name","params","key","navigationReducer","state","action","type","screens","console","warn","newRoute","routes","index","length","slice","routeIndex","findIndex","route","nextRoutes","filter","Math","min","existingIndex","targetName","initialRouteName","parseScreens","children","Children","forEach","child","isValidElement","props","component","options","useComponentNavigationBuilder","screenOptions","screenNames","Object","keys","initialRoute","Error","stackKeyRef","internalDispatch","current","dispatch","source","undefined","stateRef","navigation","push","pop","goBack","navigate","canGoBack","reset","getState","descriptors","result","screenConfig","Component","mergedOptions","descriptor","render","describe","placeholder","NavigationContent"],"sourceRoot":"../../../../src","sources":["component-stack/hooks/use-component-navigation-builder.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/component-stack/hooks/use-component-navigation.js

@@ -0,0 +1,25 @@
+"use strict";
+
+import { useComponentNavigationContext } from "../navigators/create-component-navigator";
+
+/**
+ * Hook to access the component navigation object from within a screen.
+ *
+ * @example
+ * ```tsx
+ * function MyScreen() {
+ *   const navigation = useComponentNavigation();
+ *
+ *   return (
+ *     <Button
+ *       title="Go to Details"
+ *       onPress={() => navigation.push('Details')}
+ *     />
+ *   );
+ * }
+ * ```
+ */
+export function useComponentNavigation() {
+  return useComponentNavigationContext();
+}
+//# sourceMappingURL=use-component-navigation.js.map

package/lib/module/component-stack/hooks/use-component-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useComponentNavigationContext","useComponentNavigation"],"sourceRoot":"../../../../src","sources":["component-stack/hooks/use-component-navigation.tsx"],"mappings":";;AAAA,SAASA,6BAA6B,QAAQ,0CAA0C;;AAExF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAA,EAAG;EACxC,OAAOD,6BAA6B,CAAC,CAAC;AACvC","ignoreList":[]}

package/lib/module/component-stack/index.js

@@ -0,0 +1,5 @@
+"use strict";
+
+export { useComponentNavigation } from "./hooks/use-component-navigation";
+export { createComponentNavigator } from "./navigators/create-component-navigator";
+//# sourceMappingURL=index.js.map

package/lib/module/component-stack/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useComponentNavigation","createComponentNavigator"],"sourceRoot":"../../../src","sources":["component-stack/index.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,kCAAkC;AACzE,SAASC,wBAAwB,QAAQ,yCAAyC","ignoreList":[]}

package/lib/module/component-stack/navigators/create-component-navigator.js

@@ -0,0 +1,91 @@
+"use strict";
+
+import * as React from "react";
+import { ComponentView } from "../components/component-view";
+import { useComponentNavigationBuilder } from "../hooks/use-component-navigation-builder";
+import { jsx as _jsx } from "react/jsx-runtime";
+// Context for component navigation
+const ComponentNavigationContext = /*#__PURE__*/React.createContext(null);
+export function useComponentNavigationContext() {
+  const context = React.useContext(ComponentNavigationContext);
+  if (!context) {
+    throw new Error("useComponentNavigation must be used within a ComponentStack.Navigator");
+  }
+  return context;
+}
+
+/**
+ * Screen component for defining screens in a ComponentNavigator.
+ * This is a configuration component - it doesn't render anything itself.
+ */
+function ComponentScreen(_props) {
+  return null;
+}
+
+/**
+ * Navigator component that manages internal component navigation.
+ * Does not affect React Navigation or Expo Router routes.
+ */
+function ComponentNavigator({
+  children,
+  initialRouteName,
+  screenOptions
+}) {
+  const {
+    state,
+    navigation,
+    describe,
+    descriptors,
+    NavigationContent
+  } = useComponentNavigationBuilder({
+    children,
+    initialRouteName,
+    screenOptions
+  });
+  const managedStackProps = {
+    state,
+    navigation,
+    describe,
+    descriptors
+  };
+  return /*#__PURE__*/_jsx(ComponentNavigationContext.Provider, {
+    value: navigation,
+    children: /*#__PURE__*/_jsx(NavigationContent, {
+      children: /*#__PURE__*/_jsx(ComponentView, {
+        ...managedStackProps
+      })
+    })
+  });
+}
+/**
+ * Creates a component navigation stack.
+ *
+ * @example
+ * ```tsx
+ * const Stack = createComponentNavigator();
+ *
+ * function MyComponent() {
+ *   return (
+ *     <Stack.Navigator initialRouteName="Home">
+ *       <Stack.Screen
+ *         name="Home"
+ *         component={HomeScreen}
+ *         options={{ ...SlideFromBottom() }}
+ *       />
+ *       <Stack.Screen
+ *         name="Details"
+ *         component={DetailsScreen}
+ *         options={{ ...SlideFromBottom() }}
+ *       />
+ *     </Stack.Navigator>
+ *   );
+ * }
+ * ```
+ */
+export function createComponentNavigator() {
+  return {
+    Navigator: ComponentNavigator,
+    Screen: ComponentScreen
+  };
+}
+//# sourceMappingURL=create-component-navigator.js.map

package/lib/module/component-stack/navigators/create-component-navigator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","ComponentView","useComponentNavigationBuilder","jsx","_jsx","ComponentNavigationContext","createContext","useComponentNavigationContext","context","useContext","Error","ComponentScreen","_props","ComponentNavigator","children","initialRouteName","screenOptions","state","navigation","describe","descriptors","NavigationContent","managedStackProps","Provider","value","createComponentNavigator","Navigator","Screen"],"sourceRoot":"../../../../src","sources":["component-stack/navigators/create-component-navigator.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAE9B,SAASC,aAAa,QAAQ,8BAA8B;AAC5D,SAASC,6BAA6B,QAAQ,2CAA2C;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAQ1F;AACA,MAAMC,0BAA0B,gBAC/BL,KAAK,CAACM,aAAa,CAA6B,IAAI,CAAC;AAEtD,OAAO,SAASC,6BAA6BA,CAAA,EAAwB;EACpE,MAAMC,OAAO,GAAGR,KAAK,CAACS,UAAU,CAACJ,0BAA0B,CAAC;EAC5D,IAAI,CAACG,OAAO,EAAE;IACb,MAAM,IAAIE,KAAK,CACd,uEACD,CAAC;EACF;EACA,OAAOF,OAAO;AACf;;AAEA;AACA;AACA;AACA;AACA,SAASG,eAAeA,CAACC,MAA4B,EAAQ;EAC5D,OAAO,IAAI;AACZ;;AAEA;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAAC;EAC3BC,QAAQ;EACRC,gBAAgB;EAChBC;AACwB,CAAC,EAAE;EAC3B,MAAM;IAAEC,KAAK;IAAEC,UAAU;IAAEC,QAAQ;IAAEC,WAAW;IAAEC;EAAkB,CAAC,GACpEnB,6BAA6B,CAAC;IAC7BY,QAAQ;IACRC,gBAAgB;IAChBC;EACD,CAAC,CAAC;EAEH,MAAMM,iBAGL,GAAG;IACHL,KAAK;IACLC,UAAU;IACVC,QAAQ;IACRC;EACD,CAAC;EAED,oBACChB,IAAA,CAACC,0BAA0B,CAACkB,QAAQ;IAACC,KAAK,EAAEN,UAAW;IAAAJ,QAAA,eACtDV,IAAA,CAACiB,iBAAiB;MAAAP,QAAA,eACjBV,IAAA,CAACH,aAAa;QAAA,GAAKqB;MAAiB,CAAG;IAAC,CACtB;EAAC,CACgB,CAAC;AAExC;AAOA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,wBAAwBA,CAAA,EAAmB;EAC1D,OAAO;IACNC,SAAS,EAAEb,kBAAkB;IAC7Bc,MAAM,EAAEhB;EACT,CAAC;AACF","ignoreList":[]}

package/lib/module/component-stack/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["component-stack/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/{shared/components → native-stack}/controllers/native-stack-lifecycle.js

@@ -3,14 +3,15 @@
 /** biome-ignore-all lint/style/noNonNullAssertion: <Lifecycles are rendered right under the gesture provider> */
 import { useEffect, useLayoutEffect } from "react";
 import { useDerivedValue } from "react-native-reanimated";
-import { useSharedValueState } from "../../hooks/reanimated/use-shared-value-state";
-import useStableCallback from "../../hooks/use-stable-callback";
-import { useGestureContext } from "../../providers/gestures.provider";
-import { useKeys } from "../../providers/keys.provider";
-import { AnimationStore } from "../../stores/animation.store";
-import { TRUE } from "../../types/state.types";
-import { startScreenTransition } from "../../utils/animation/start-screen-transition";
-import { resetStoresForScreen } from "../../utils/reset-stores-for-screen";
+import { useHighRefreshRate } from "../../shared/hooks/animation/use-high-refresh-rate";
+import { useSharedValueState } from "../../shared/hooks/reanimated/use-shared-value-state";
+import useStableCallback from "../../shared/hooks/use-stable-callback";
+import { useGestureContext } from "../../shared/providers/gestures.provider";
+import { useKeys } from "../../shared/providers/screen/keys.provider";
+import { AnimationStore } from "../../shared/stores/animation.store";
+import { TRUE } from "../../shared/types/state.types";
+import { startScreenTransition } from "../../shared/utils/animation/start-screen-transition";
+import { resetStoresForScreen } from "../../shared/utils/reset-stores-for-screen";
 /**
  * Lifecycle controller built out for Native Stack implementation.
  */
@@ -29,6 +30,10 @@ export const NativeStackScreenLifecycleController = ({
     return ancestorContext?.gestureAnimationValues.isDismissing?.value ?? false;
   }));
   const animations = AnimationStore.getAll(current.route.key);
+  const {
+    deactivateHighRefreshRate,
+    activateHighRefreshRate
+  } = useHighRefreshRate(current);
   const handleBeforeRemove = useStableCallback(e => {
     const isEnabled = current.options.enableTransitions;
     const isFirstScreen = current.navigation.getState().index === 0;
@@ -40,7 +45,9 @@ export const NativeStackScreenLifecycleController = ({
       return;
     }
     e.preventDefault();
+    activateHighRefreshRate();
     const onAnimationFinish = finished => {
+      deactivateHighRefreshRate();
       if (finished) {
         current.navigation.dispatch(e.data.action);
 
@@ -58,10 +65,12 @@ export const NativeStackScreenLifecycleController = ({
     });
   });
   const handleInitialize = useStableCallback(() => {
+    activateHighRefreshRate();
     startScreenTransition({
       target: "open",
       spec: current.options.transitionSpec,
-      animations
+      animations,
+      onAnimationFinish: deactivateHighRefreshRate
     });
   });
   useEffect(() => {

package/lib/module/native-stack/controllers/native-stack-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useLayoutEffect","useDerivedValue","useHighRefreshRate","useSharedValueState","useStableCallback","useGestureContext","useKeys","AnimationStore","TRUE","startScreenTransition","resetStoresForScreen","NativeStackScreenLifecycleController","children","current","ancestorContext","isAncestorDismissingViaGesture","gestureAnimationValues","isDismissing","value","animations","getAll","route","key","deactivateHighRefreshRate","activateHighRefreshRate","handleBeforeRemove","e","isEnabled","options","enableTransitions","isFirstScreen","navigation","getState","index","closing","set","preventDefault","onAnimationFinish","finished","dispatch","data","action","requestAnimationFrame","target","spec","transitionSpec","handleInitialize","unsubscribe","addListener"],"sourceRoot":"../../../../src","sources":["native-stack/controllers/native-stack-lifecycle.tsx"],"mappings":"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","ignoreList":[]}