@symbiote-native/navigation 2.1.0 → 3.0.0

package/src/react/drawer-screen.ts

@@ -5,7 +5,11 @@
 // <third_party_rn_packages_are_react_only> - this and Drawer import nothing from react-native.
 
 import type { FC, ReactElement } from 'react';
-import type { IDrawerNavigatorHandle, IDrawerScreenOptions, IRoute } from '../core';
+import type {
+  IDrawerNavigatorHandle,
+  IDrawerScreenOptions,
+  IRoute,
+} from '../core';
 
 // The options resolver runs INSIDE Drawer while it computes a screen's options, closing over the
 // live navigator handle - not the mounted screen component (that reads navigation/route via the
@@ -15,7 +19,9 @@ export type IDrawerScreenOptionsArgs = {
   navigation: IDrawerNavigatorHandle;
 };
 
-export type IDrawerScreenOptionsResolver = (args: IDrawerScreenOptionsArgs) => IDrawerScreenOptions;
+export type IDrawerScreenOptionsResolver = (
+  args: IDrawerScreenOptionsArgs,
+) => IDrawerScreenOptions;
 
 export type IDrawerScreenProps = {
   name: string;

package/src/react/hooks/use-focus-effect.ts

@@ -24,8 +24,14 @@ export function useFocusEffect(effect: EffectCallback): void {
       cleanup = undefined;
     };
 
-    const unsubscribeFocus = emitter.addListener(NAVIGATION_EVENT_FOCUS, runEffect);
-    const unsubscribeBlur = emitter.addListener(NAVIGATION_EVENT_BLUR, runCleanup);
+    const unsubscribeFocus = emitter.addListener(
+      NAVIGATION_EVENT_FOCUS,
+      runEffect,
+    );
+    const unsubscribeBlur = emitter.addListener(
+      NAVIGATION_EVENT_BLUR,
+      runCleanup,
+    );
 
     return () => {
       unsubscribeFocus();

package/src/react/hooks/use-is-focused.ts

@@ -14,8 +14,12 @@ export function useIsFocused(): boolean {
   const [isFocused, setIsFocused] = useState(false);
 
   useEffect(() => {
-    const unsubscribeFocus = emitter.addListener(NAVIGATION_EVENT_FOCUS, () => setIsFocused(true));
-    const unsubscribeBlur = emitter.addListener(NAVIGATION_EVENT_BLUR, () => setIsFocused(false));
+    const unsubscribeFocus = emitter.addListener(NAVIGATION_EVENT_FOCUS, () =>
+      setIsFocused(true),
+    );
+    const unsubscribeBlur = emitter.addListener(NAVIGATION_EVENT_BLUR, () =>
+      setIsFocused(false),
+    );
     return () => {
       unsubscribeFocus();
       unsubscribeBlur();

package/src/react/hooks/use-navigation.ts

@@ -5,12 +5,18 @@
 // ../../core/navigation-events; this hook only reads NavigationContext and binds identity.
 
 import { useMemo } from 'react';
-import type { INavigationEventListener, INavigationEventName } from '../../core';
+import type {
+  INavigationEventListener,
+  INavigationEventName,
+} from '../../core';
 import { useRequiredNavigationContext } from '../navigation-context';
 import type { IAnyNavigatorHandle } from '../navigation-context';
 
 export type INavigationHandle = IAnyNavigatorHandle & {
-  addListener: (event: INavigationEventName, listener: INavigationEventListener) => () => void;
+  addListener: (
+    event: INavigationEventName,
+    listener: INavigationEventListener,
+  ) => () => void;
   // Walks exactly ONE hop up navigation-context.ts's `parent` chain to the enclosing navigator's
   // handle - e.g. a Tab screen nested inside a Stack screen calling getParent() to push a new
   // Stack route. Callers narrow the union themselves ('push' in parent, etc.). Deliberately NOT

package/src/react/index.ts

@@ -8,19 +8,40 @@ import '../register';
 export { Stack } from './stack';
 export type { INavigatorHandle, IStackProps } from './stack';
 export { Screen } from './screen';
-export type { IScreenOptionsArgs, IScreenOptionsResolver, IScreenProps } from './screen';
-export type { IScreenOptions, IStackAnimation, IStackPresentation } from '../core';
+export type {
+  IScreenOptionsArgs,
+  IScreenOptionsResolver,
+  IScreenProps,
+} from './screen';
+export type {
+  IScreenOptions,
+  IStackAnimation,
+  IStackPresentation,
+} from '../core';
 
-export { useNavigation, useRoute, useIsFocused, useFocusEffect, useNavigationState } from './hooks';
+export {
+  useNavigation,
+  useRoute,
+  useIsFocused,
+  useFocusEffect,
+  useNavigationState,
+} from './hooks';
 export type { INavigationHandle } from './hooks';
-export { useStackNavigation, useTabNavigation, useDrawerNavigation } from './hooks';
+export {
+  useStackNavigation,
+  useTabNavigation,
+  useDrawerNavigation,
+} from './hooks';
 export type {
   IStackNavigationHandle,
   ITabNavigationHandle,
   IDrawerNavigationHandle,
 } from './hooks';
 export { NavigationContext } from './navigation-context';
-export type { INavigationContextValue, IAnyNavigatorHandle } from './navigation-context';
+export type {
+  INavigationContextValue,
+  IAnyNavigatorHandle,
+} from './navigation-context';
 
 export { useLinkingIntegration } from './linking';
 export type { ILinkingConfig, IScreenLinkingConfig } from '../core';
@@ -42,11 +63,20 @@ export type { ITabOptions, ITabBarIcon } from '../core';
 // ../register import above). See react/drawer.ts's header for the feasibility note re:
 // react-native-gesture-handler / react-native-reanimated parity gaps.
 export { Drawer } from './drawer';
-export type { IDrawerNavigatorHandle, IDrawerProps, IDrawerDescriptorMap } from './drawer';
+export type {
+  IDrawerNavigatorHandle,
+  IDrawerProps,
+  IDrawerDescriptorMap,
+} from './drawer';
 export { DrawerScreen } from './drawer-screen';
 export type {
   IDrawerScreenOptionsArgs,
   IDrawerScreenOptionsResolver,
   IDrawerScreenProps,
 } from './drawer-screen';
-export type { IDrawerOptions, IDrawerScreenOptions, IDrawerType, IDrawerPosition } from '../core';
+export type {
+  IDrawerOptions,
+  IDrawerScreenOptions,
+  IDrawerType,
+  IDrawerPosition,
+} from '../core';

package/src/react/linking.ts

@@ -24,7 +24,10 @@ export function useLinkingIntegration(
   handleRef.current = navigatorHandle;
 
   useEffect(() => {
-    function applyRoute(url: string, dispatch: (name: string, params?: unknown) => void): void {
+    function applyRoute(
+      url: string,
+      dispatch: (name: string, params?: unknown) => void,
+    ): void {
       const route = resolveRouteFromUrl(configRef.current, url);
       if (route === null) {
         dlog(`useLinkingIntegration: no route resolved for "${url}"`);

package/src/react/navigation-context.ts

@@ -24,12 +24,16 @@ export type INavigationContextValue = {
   parent?: INavigationContextValue;
 };
 
-export const NavigationContext = createContext<INavigationContextValue | undefined>(undefined);
+export const NavigationContext = createContext<
+  INavigationContextValue | undefined
+>(undefined);
 
 // Every hook in ./hooks needs the same `useContext(NavigationContext)` + missing-provider throw,
 // so it's co-located here instead of repeated per hook. `hookName` keeps each hook's own name in
 // the thrown message.
-export function useRequiredNavigationContext(hookName: string): INavigationContextValue {
+export function useRequiredNavigationContext(
+  hookName: string,
+): INavigationContextValue {
   const context = useContext(NavigationContext);
   if (!context) {
     throw new Error(

package/src/react/screen.ts

@@ -5,7 +5,11 @@
 
 import type { FC, ReactElement, RefObject } from 'react';
 import type { IRoute } from '../core';
-import type { ISearchBarCommands, ISearchBarOptions, IScreenOptions } from '../core';
+import type {
+  ISearchBarCommands,
+  ISearchBarOptions,
+  IScreenOptions,
+} from '../core';
 import type { INavigatorHandle } from '../core';
 
 // The imperative ref (focus/blur/clearText/setText/cancelSearch/toggleCancelButton) carries a
@@ -17,7 +21,10 @@ export type IReactSearchBarOptions = ISearchBarOptions & {
   ref?: RefObject<ISearchBarCommands | null>;
 };
 
-export type IReactScreenOptions = Omit<IScreenOptions, 'headerSearchBarOptions'> & {
+export type IReactScreenOptions = Omit<
+  IScreenOptions,
+  'headerSearchBarOptions'
+> & {
   headerSearchBarOptions?: IReactSearchBarOptions;
 };
 
@@ -30,7 +37,9 @@ export type IScreenOptionsArgs = {
   navigation: INavigatorHandle;
 };
 
-export type IScreenOptionsResolver = (args: IScreenOptionsArgs) => IReactScreenOptions;
+export type IScreenOptionsResolver = (
+  args: IScreenOptionsArgs,
+) => IReactScreenOptions;
 
 export type IScreenProps = {
   name: string;