@symbiote-native/navigation 2.1.0 → 3.0.0

package/src/angular/tabs/index.ts

@@ -66,7 +66,12 @@ let tabInstanceCounter = 0;
 @Component({
   selector: 'Tab',
   standalone: true,
-  imports: [NgComponentOutlet, NavigationScopeDirective, DescriptorOutlet, View],
+  imports: [
+    NgComponentOutlet,
+    NavigationScopeDirective,
+    DescriptorOutlet,
+    View,
+  ],
   changeDetection: ChangeDetectionStrategy.OnPush,
   template: `
     <View [style]="rootStyle">
@@ -101,7 +106,8 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
   // Keyed by name -> the LIVE TabScreenDirective instance - see stack.ts's matching comment for
   // why a snapshot copy would go stale on an in-place `[options]`/`[component]` change.
   private readonly registry = new Map<string, TabScreenDirective>();
-  private tabScreenChildrenSubscription: { unsubscribe: () => void } | undefined;
+  private tabScreenChildrenSubscription:
+    { unsubscribe: () => void } | undefined;
 
   private readonly stateSignal = signal<ITabRouterState | undefined>(undefined);
   readonly state = this.stateSignal.asReadonly();
@@ -116,9 +122,10 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
 
   ngAfterContentInit(): void {
     this.syncRegistry();
-    this.tabScreenChildrenSubscription = this.tabScreenChildren.changes.subscribe(() => {
-      this.syncRegistry();
-    });
+    this.tabScreenChildrenSubscription =
+      this.tabScreenChildren.changes.subscribe(() => {
+        this.syncRegistry();
+      });
   }
 
   ngOnDestroy(): void {
@@ -150,7 +157,8 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
   private syncRegistry(): void {
     this.rebuildRegistry();
     const routes = this.routesFromRegistry();
-    if (routes.length === 0) dlog('Tab: no <ng-template symbioteTabScreen> children registered');
+    if (routes.length === 0)
+      dlog('Tab: no <ng-template symbioteTabScreen> children registered');
     const current = this.stateSignal();
     if (current !== undefined) {
       this.stateSignal.set(reconcileTabRoutes(current, routes));
@@ -168,9 +176,15 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
     this.stateSignal.set(tabRouterReducer(current, action));
   }
 
-  private resolveTabOptions(entry: TabScreenDirective, route: IRoute<unknown>): ITabOptions {
+  private resolveTabOptions(
+    entry: TabScreenDirective,
+    route: IRoute<unknown>,
+  ): ITabOptions {
     const props: ITabScreenOptionsArgs = { route, navigation: this };
-    const own = typeof entry.options === 'function' ? entry.options(props) : entry.options;
+    const own =
+      typeof entry.options === 'function'
+        ? entry.options(props)
+        : entry.options;
     return { ...this.screenOptions, ...own };
   }
 
@@ -207,8 +221,12 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
   focusedRouteEmitter(): INavigationEmitter {
     const key = this.focusedRoute()?.key;
     return untracked(() => {
-      if (key === this.currentEmitterKey && this.currentEmitter) return this.currentEmitter;
-      const { blurKey, focusKey } = diffFocusedRoute(this.currentEmitterKey, key);
+      if (key === this.currentEmitterKey && this.currentEmitter)
+        return this.currentEmitter;
+      const { blurKey, focusKey } = diffFocusedRoute(
+        this.currentEmitterKey,
+        key,
+      );
       if (blurKey !== undefined && this.currentEmitter) {
         dlog('Tab: previous route blurred');
         this.currentEmitter.emit(NAVIGATION_EVENT_BLUR);
@@ -257,12 +275,18 @@ export class Tab implements AfterContentInit, OnDestroy, ITabNavigatorHandle {
     });
 
     const focusedRoute = this.focusedRoute();
-    const focusedEntry = focusedRoute ? this.registry.get(focusedRoute.name) : undefined;
+    const focusedEntry = focusedRoute
+      ? this.registry.get(focusedRoute.name)
+      : undefined;
     const focusedOptions =
       focusedEntry && focusedRoute
         ? this.resolveTabOptions(focusedEntry, focusedRoute)
         : this.screenOptions;
 
-    return renderTabBar({ items, style: focusedOptions?.tabBarStyle, passthrough: {} });
+    return renderTabBar({
+      items,
+      style: focusedOptions?.tabBarStyle,
+      passthrough: {},
+    });
   }
 }

package/src/core/constants.ts

@@ -11,12 +11,14 @@ export const RNS_SCREEN_VIEW_NAME = 'RNSScreen';
 // render-stack.ts for why a formSheet/modal screen MUST use this different Fabric name.
 export const RNS_MODAL_SCREEN_VIEW_NAME = 'RNSModalScreen';
 export const RNS_SCREEN_STACK_VIEW_NAME = 'RNSScreenStack';
-export const RNS_SCREEN_STACK_HEADER_CONFIG_VIEW_NAME = 'RNSScreenStackHeaderConfig';
+export const RNS_SCREEN_STACK_HEADER_CONFIG_VIEW_NAME =
+  'RNSScreenStackHeaderConfig';
 // The header-subview leaf react-native-screens itself uses to host arbitrary framework children
 // (left/right/back/title/center/searchBar) inside the header. Registered here for ground-truth
 // parity, but unconsumed by any fold in v1 scope: renderHeaderConfig's Descriptor never takes
 // framework children (see render-stack.ts), so mounting a subview child is left to the adapter.
-export const RNS_SCREEN_STACK_HEADER_SUBVIEW_VIEW_NAME = 'RNSScreenStackHeaderSubview';
+export const RNS_SCREEN_STACK_HEADER_SUBVIEW_VIEW_NAME =
+  'RNSScreenStackHeaderSubview';
 export const RNS_SEARCH_BAR_VIEW_NAME = 'RNSSearchBar';
 // react-native-screens' own JS layer (ScreenStackItem -> DebugContainer -> ScreenContentWrapper)
 // ALWAYS wraps a screen's content in this native view, `collapsable: false` so Fabric can never
@@ -43,7 +45,8 @@ export const STACK_ON_FINISH_TRANSITIONING = 'onFinishTransitioning';
 // plain bar-button-item press, and a press on a (possibly nested) menu action of a 'menu'-type
 // bar-button item.
 export const HEADER_ON_PRESS_BAR_BUTTON_ITEM = 'onPressHeaderBarButtonItem';
-export const HEADER_ON_PRESS_BAR_BUTTON_MENU_ITEM = 'onPressHeaderBarButtonMenuItem';
+export const HEADER_ON_PRESS_BAR_BUTTON_MENU_ITEM =
+  'onPressHeaderBarButtonMenuItem';
 
 // RNSSearchBar event prop keys (all DirectEventHandler in the codegen spec). onClose/onOpen are
 // Android-only per the codegen spec's own comment.

package/src/core/drawer-options/index.ts

@@ -7,7 +7,10 @@
 // PanResponder equivalent (see packages/navigation's README / the drawer feasibility note for the
 // full gap list).
 
-import type { IPanResponderGestureState, ISymbioteEvent } from '@symbiote-native/engine';
+import type {
+  IPanResponderGestureState,
+  ISymbioteEvent,
+} from '@symbiote-native/engine';
 import { isRecord } from '../guards';
 import type { IDrawerSlot } from '../render-drawer';
 
@@ -59,7 +62,9 @@ export function resolveDrawerType(options: IDrawerOptions): IDrawerType {
   return options.drawerType ?? DRAWER_DEFAULT_TYPE;
 }
 
-export function resolveDrawerPosition(options: IDrawerOptions): IDrawerPosition {
+export function resolveDrawerPosition(
+  options: IDrawerOptions,
+): IDrawerPosition {
   return options.drawerPosition ?? DRAWER_DEFAULT_POSITION;
 }
 
@@ -90,7 +95,9 @@ export function isDrawerOverlayVisible(options: IDrawerOptions): boolean {
 // slide: panel AND content move together by the same delta, overlay fades in (content still
 //   covers the panel partially as they slide in tandem, same as front visually at rest).
 // permanent: static, all zero (isDrawerAnimated() gates callers off this path already).
-export function resolveDrawerGeometry(options: IDrawerOptions): IDrawerGeometry {
+export function resolveDrawerGeometry(
+  options: IDrawerOptions,
+): IDrawerGeometry {
   const width = resolveDrawerWidth(options);
   const type = resolveDrawerType(options);
   const sign = resolveDrawerPosition(options) === 'left' ? 1 : -1;
@@ -188,25 +195,37 @@ export function resolveDrawerSlotInterpolation(
       return {
         translateX: {
           inputRange: DRAWER_PROGRESS_INPUT_RANGE,
-          outputRange: [geometry.contentTranslateXClosed, geometry.contentTranslateXOpen],
+          outputRange: [
+            geometry.contentTranslateXClosed,
+            geometry.contentTranslateXOpen,
+          ],
         },
       };
     case 'overlay':
       return {
         opacity: {
           inputRange: DRAWER_PROGRESS_INPUT_RANGE,
-          outputRange: [geometry.overlayOpacityClosed, geometry.overlayOpacityOpen],
+          outputRange: [
+            geometry.overlayOpacityClosed,
+            geometry.overlayOpacityOpen,
+          ],
         },
         translateX: {
           inputRange: DRAWER_PROGRESS_INPUT_RANGE,
-          outputRange: [geometry.contentTranslateXClosed, geometry.contentTranslateXOpen],
+          outputRange: [
+            geometry.contentTranslateXClosed,
+            geometry.contentTranslateXOpen,
+          ],
         },
       };
     case 'panel':
       return {
         translateX: {
           inputRange: DRAWER_PROGRESS_INPUT_RANGE,
-          outputRange: [geometry.panelTranslateXClosed, geometry.panelTranslateXOpen],
+          outputRange: [
+            geometry.panelTranslateXClosed,
+            geometry.panelTranslateXOpen,
+          ],
         },
       };
   }
@@ -235,7 +254,9 @@ export function isSwipeStartInEdge(
 // ScrollView's way).
 const MOVE_CLAIM_THRESHOLD = 5;
 
-export function isHorizontalDrag(gestureState: IPanResponderGestureState): boolean {
+export function isHorizontalDrag(
+  gestureState: IPanResponderGestureState,
+): boolean {
   return (
     Math.abs(gestureState.dx) > MOVE_CLAIM_THRESHOLD &&
     Math.abs(gestureState.dx) > Math.abs(gestureState.dy)
@@ -258,8 +279,10 @@ export function resolveSwipeIntent(
   // symmetrically for a right drawer's leftward drag).
   const signedDx = sign * gestureState.dx;
   const signedVx = sign * gestureState.vx;
-  const minDistance = options.swipeMinDistance ?? DRAWER_DEFAULT_SWIPE_MIN_DISTANCE;
-  const minVelocity = options.swipeMinVelocity ?? DRAWER_DEFAULT_SWIPE_MIN_VELOCITY;
+  const minDistance =
+    options.swipeMinDistance ?? DRAWER_DEFAULT_SWIPE_MIN_DISTANCE;
+  const minVelocity =
+    options.swipeMinVelocity ?? DRAWER_DEFAULT_SWIPE_MIN_VELOCITY;
 
   const pastDistance = Math.abs(signedDx) >= minDistance;
   const pastVelocity = Math.abs(signedVx) >= minVelocity;
@@ -276,7 +299,9 @@ export function clamp01(value: number): number {
 }
 
 function toFiniteNumber(value: unknown): number | undefined {
-  return typeof value === 'number' && Number.isFinite(value) ? value : undefined;
+  return typeof value === 'number' && Number.isFinite(value)
+    ? value
+    : undefined;
 }
 
 // The touch's real starting page-X, read off the raw event rather than gestureState.x0: the
@@ -293,7 +318,8 @@ export function startPageXOf(event: ISymbioteEvent): number | undefined {
   const direct = toFiniteNumber(nativeEvent.pageX);
   if (direct !== undefined) return direct;
   const touches = nativeEvent.touches;
-  if (Array.isArray(touches) && isRecord(touches[0])) return toFiniteNumber(touches[0].pageX);
+  if (Array.isArray(touches) && isRecord(touches[0]))
+    return toFiniteNumber(touches[0].pageX);
   return undefined;
 }
 
@@ -323,7 +349,8 @@ export function shouldClaimDrawerSwipe(
   options: IDrawerOptions,
   phase: 'start' | 'move',
 ): boolean {
-  if ((options.swipeEnabled ?? DRAWER_DEFAULT_SWIPE_ENABLED) === false) return false;
+  if ((options.swipeEnabled ?? DRAWER_DEFAULT_SWIPE_ENABLED) === false)
+    return false;
   if (!isDrawerAnimated(options)) return false;
   const startX = startPageXOf(event) ?? gestureState.x0;
   if (!isSwipeStartInEdge(startX, screenWidth, isOpen, options)) return false;

package/src/core/drawer-router-state/index.ts

@@ -34,7 +34,11 @@ export function createInitialDrawerRouterState(
     return { routes, index: INITIAL_FOCUSED_INDEX, isOpen: false };
   }
   const index = routes.findIndex(route => route.name === initialRouteName);
-  return { routes, index: index === -1 ? INITIAL_FOCUSED_INDEX : index, isOpen: false };
+  return {
+    routes,
+    index: index === -1 ? INITIAL_FOCUSED_INDEX : index,
+    isOpen: false,
+  };
 }
 
 // Mirrors @react-navigation/drawer's DrawerActions: jumpTo focuses a route by NAME (TabRouter's
@@ -49,7 +53,9 @@ export function drawerRouterReducer(
     case 'jumpTo': {
       const index = state.routes.findIndex(route => route.name === action.name);
       if (index === -1) return state;
-      return index === state.index && !state.isOpen ? state : { ...state, index, isOpen: false };
+      return index === state.index && !state.isOpen
+        ? state
+        : { ...state, index, isOpen: false };
     }
 
     case 'openDrawer':
@@ -66,6 +72,8 @@ export function drawerRouterReducer(
   }
 }
 
-export function focusedDrawerRoute(state: IDrawerRouterState): IRouteEntry | undefined {
+export function focusedDrawerRoute(
+  state: IDrawerRouterState,
+): IRouteEntry | undefined {
   return state.routes[state.index];
 }

package/src/core/guards.ts

@@ -19,5 +19,7 @@ export function isRecord(value: unknown): value is Record<string, unknown> {
 // navigator-state.ts (Stack) and tab-router-state.ts (Tabs) so the two reducers can't drift on
 // this rule independently.
 export function mergeParams(current: unknown, incoming: unknown): unknown {
-  return isRecord(current) && isRecord(incoming) ? { ...current, ...incoming } : incoming;
+  return isRecord(current) && isRecord(incoming)
+    ? { ...current, ...incoming }
+    : incoming;
 }

package/src/core/header-bar-buttons.ts

@@ -21,7 +21,9 @@ import type {
 // time (both the structured `icon` field AND the flat native keys reach native - RNS's own
 // prepareHeaderBarButtonItems keeps both), and resolves image assets through the same resolver
 // the Image component uses.
-function prepareIcon(icon: IHeaderBarButtonIcon | undefined): Record<string, unknown> {
+function prepareIcon(
+  icon: IHeaderBarButtonIcon | undefined,
+): Record<string, unknown> {
   if (!icon) return {};
   switch (icon.type) {
     case 'sfSymbol':
@@ -31,7 +33,9 @@ function prepareIcon(icon: IHeaderBarButtonIcon | undefined): Record<string, unk
     case 'imageSource':
       return { imageSource: imageStatics.resolveAssetSource(icon.imageSource) };
     case 'templateSource':
-      return { templateSource: imageStatics.resolveAssetSource(icon.templateSource) };
+      return {
+        templateSource: imageStatics.resolveAssetSource(icon.templateSource),
+      };
   }
 }
 
@@ -40,7 +44,11 @@ type ISharedItem = IHeaderBarButtonItemAction | IHeaderBarButtonItemMenu;
 // The one id algorithm both the payload tagger (prepareMenuItems/prepareHeaderBarButtonItems)
 // and the dispatch-lookup builder (collectMenuHandlers/collectBarButtonHandlers) call - so a
 // change to the id scheme genuinely can't desync payload tagging from dispatch lookup.
-function buildMenuId(path: string, index: number, side: 'left' | 'right'): string {
+function buildMenuId(
+  path: string,
+  index: number,
+  side: 'left' | 'right',
+): string {
   return `${path}-${index}-${side}`;
 }
 
@@ -54,18 +62,26 @@ function prepareTitleStyle(
   if (!titleStyle) return undefined;
   return {
     ...titleStyle,
-    color: titleStyle.color === undefined ? undefined : processColor(titleStyle.color),
+    color:
+      titleStyle.color === undefined
+        ? undefined
+        : processColor(titleStyle.color),
   };
 }
 
-function prepareBadge(badge: ISharedItem['badge']): Record<string, unknown> | undefined {
+function prepareBadge(
+  badge: ISharedItem['badge'],
+): Record<string, unknown> | undefined {
   if (!badge) return undefined;
   return {
     ...badge,
     style: badge.style
       ? {
           ...badge.style,
-          color: badge.style.color === undefined ? undefined : processColor(badge.style.color),
+          color:
+            badge.style.color === undefined
+              ? undefined
+              : processColor(badge.style.color),
           backgroundColor:
             badge.style.backgroundColor === undefined
               ? undefined
@@ -81,7 +97,9 @@ function prepareBadge(badge: ISharedItem['badge']): Record<string, unknown> | un
 // headerRightBarButtonItems array it's nested in - not just the one bad field - so bar buttons and
 // menu actions never reached native at all, despite the buttonId/menuId dispatch wiring itself
 // being entirely correct.
-function excludeOnPress<T extends { onPress: unknown }>(item: T): Omit<T, 'onPress'> {
+function excludeOnPress<T extends { onPress: unknown }>(
+  item: T,
+): Omit<T, 'onPress'> {
   const { onPress: _onPress, ...rest } = item;
   return rest;
 }
@@ -95,12 +113,15 @@ function prepareSharedFields(
     ...(item.type === 'button' ? excludeOnPress(item) : item),
     ...prepareIcon(item.icon),
     titleStyle: prepareTitleStyle(item.titleStyle),
-    tintColor: item.tintColor === undefined ? undefined : processColor(item.tintColor),
+    tintColor:
+      item.tintColor === undefined ? undefined : processColor(item.tintColor),
     badge: prepareBadge(item.badge),
   };
 }
 
-type IMenuLike = { items: (IHeaderBarButtonMenuAction | IHeaderBarButtonSubmenu)[] };
+type IMenuLike = {
+  items: (IHeaderBarButtonMenuAction | IHeaderBarButtonSubmenu)[];
+};
 
 // Recursively tags every menu action with a `menuId` derived from its tree position
 // (`${path}-${index}-${side}`), mirroring RNS's own prepareMenu exactly - the id must match what
@@ -117,7 +138,11 @@ function prepareMenuItems<T extends IMenuLike>(
       const currentPath = path ? `${path}.${menuIndex}` : `${menuIndex}`;
       const icon = prepareIcon(menuItem.icon);
       if (menuItem.type === 'submenu') {
-        return { ...menuItem, ...icon, ...prepareMenuItems(menuItem, index, side, currentPath) };
+        return {
+          ...menuItem,
+          ...icon,
+          ...prepareMenuItems(menuItem, index, side, currentPath),
+        };
       }
       return {
         ...excludeOnPress(menuItem),
@@ -139,7 +164,8 @@ export function prepareHeaderBarButtonItems(
   return items.map((item, index) => {
     if (item.type === 'spacing') return item;
     const prepared = prepareSharedFields(item);
-    if (item.type === 'button') return { ...prepared, buttonId: buildButtonId(index, side) };
+    if (item.type === 'button')
+      return { ...prepared, buttonId: buildButtonId(index, side) };
     return { ...prepared, menu: prepareMenuItems(item.menu, index, side) };
   });
 }
@@ -176,7 +202,10 @@ function collectBarButtonHandlers(
   });
 }
 
-function readStringField(record: Record<string, unknown>, key: string): string | undefined {
+function readStringField(
+  record: Record<string, unknown>,
+  key: string,
+): string | undefined {
   const value = record[key];
   return typeof value === 'string' ? value : undefined;
 }

package/src/core/index.ts

@@ -14,7 +14,11 @@ export {
   computeActivityState,
   isTopRoute,
 } from './navigator-state';
-export type { IRoute, INavigatorState, INavigatorAction } from './navigator-state';
+export type {
+  IRoute,
+  INavigatorState,
+  INavigatorAction,
+} from './navigator-state';
 
 // Drops history entries whose `<Stack.Screen>` marker has unregistered - see
 // stack-router-state.ts's header for why the Stack's history needs this and the Tab's projection
@@ -50,7 +54,11 @@ export type {
   ISearchBarViewProps,
 } from './navigator-props';
 
-export { resolveHeaderConfigView, resolveScreenView, resolveSearchBarView } from './screen-options';
+export {
+  resolveHeaderConfigView,
+  resolveScreenView,
+  resolveSearchBarView,
+} from './screen-options';
 
 export { buildSearchBarHandle } from './search-bar-commands';
 export type { ISearchBarCommands } from './search-bar-commands';
@@ -70,7 +78,10 @@ export {
 } from './render-stack';
 export type { IScreenRenderPlanInput, IScreenRenderPlan } from './render-stack';
 
-export { serializeNavigatorState, deserializeNavigatorState } from './state-persistence';
+export {
+  serializeNavigatorState,
+  deserializeNavigatorState,
+} from './state-persistence';
 
 export {
   createNavigationEmitter,
@@ -120,7 +131,10 @@ export {
   drawerRouterReducer,
   focusedDrawerRoute,
 } from './drawer-router-state';
-export type { IDrawerRouterState, IDrawerRouterAction } from './drawer-router-state';
+export type {
+  IDrawerRouterState,
+  IDrawerRouterAction,
+} from './drawer-router-state';
 
 export type {
   IDrawerType,

package/src/core/linking-config/index.ts

@@ -49,7 +49,9 @@ function normalizeSegment(segment: string): string {
 }
 
 function joinPath(parent: string, child: string): string {
-  const parts = [normalizeSegment(parent), normalizeSegment(child)].filter(part => part.length > 0);
+  const parts = [normalizeSegment(parent), normalizeSegment(child)].filter(
+    part => part.length > 0,
+  );
   return parts.join('/');
 }
 
@@ -68,14 +70,17 @@ function flattenScreens(
       continue;
     }
 
-    const nextParent = entry.path !== undefined ? joinPath(parentPath, entry.path) : parentPath;
+    const nextParent =
+      entry.path !== undefined ? joinPath(parentPath, entry.path) : parentPath;
 
     if (entry.screens !== undefined) {
       flattenScreens(entry.screens, nextParent, out);
     } else if (entry.path !== undefined) {
       out.push({ name, pattern: nextParent });
     } else {
-      dlog(`linking-config: screen "${name}" has neither a path nor nested screens, skipping`);
+      dlog(
+        `linking-config: screen "${name}" has neither a path nor nested screens, skipping`,
+      );
     }
   }
   return out;
@@ -93,12 +98,16 @@ function segmentCount(pattern: string): number {
 // More static segments should win over a param that would also match (e.g. a literal
 // '/user/me' pattern over '/user/:id'), mirroring how react-navigation prefers exact matches.
 function bySpecificity(a: IFlatRoutePattern, b: IFlatRoutePattern): number {
-  const dynamicDiff = dynamicSegmentCount(a.pattern) - dynamicSegmentCount(b.pattern);
+  const dynamicDiff =
+    dynamicSegmentCount(a.pattern) - dynamicSegmentCount(b.pattern);
   if (dynamicDiff !== 0) return dynamicDiff;
   return segmentCount(b.pattern) - segmentCount(a.pattern);
 }
 
-function matchPattern(pattern: string, pathname: string): Record<string, string> | null {
+function matchPattern(
+  pattern: string,
+  pathname: string,
+): Record<string, string> | null {
   const patternSegments = pattern.length === 0 ? [] : pattern.split('/');
   const pathSegments = pathname.length === 0 ? [] : pathname.split('/');
   if (patternSegments.length !== pathSegments.length) return null;
@@ -127,7 +136,9 @@ function stripQueryAndHash(url: string): string {
 // neither applies - an unrecognized scheme/host, not "no route matched".
 function extractPathname(config: ILinkingConfig, url: string): string | null {
   const withoutQuery = stripQueryAndHash(url);
-  const sortedPrefixes = [...config.prefixes].sort((a, b) => b.length - a.length);
+  const sortedPrefixes = [...config.prefixes].sort(
+    (a, b) => b.length - a.length,
+  );
   for (const prefix of sortedPrefixes) {
     if (withoutQuery.startsWith(prefix)) {
       return normalizeSegment(withoutQuery.slice(prefix.length));
@@ -137,14 +148,19 @@ function extractPathname(config: ILinkingConfig, url: string): string | null {
   return null;
 }
 
-export function resolveRouteFromUrl(config: ILinkingConfig, url: string): IRoute<unknown> | null {
+export function resolveRouteFromUrl(
+  config: ILinkingConfig,
+  url: string,
+): IRoute<unknown> | null {
   const pathname = extractPathname(config, url);
   if (pathname === null) {
     dlog(`linking-config: url "${url}" matched no configured prefix`);
     return null;
   }
 
-  const candidates = flattenScreens(config.config.screens, '', []).sort(bySpecificity);
+  const candidates = flattenScreens(config.config.screens, '', []).sort(
+    bySpecificity,
+  );
   for (const candidate of candidates) {
     const params = matchPattern(candidate.pattern, pathname);
     if (params !== null) {
@@ -159,7 +175,9 @@ export function resolveRouteFromUrl(config: ILinkingConfig, url: string): IRoute
     }
   }
 
-  dlog(`linking-config: url "${url}" (path "${pathname}") matched no configured screen`);
+  dlog(
+    `linking-config: url "${url}" (path "${pathname}") matched no configured screen`,
+  );
   return null;
 }
 
@@ -182,7 +200,10 @@ function fillPattern(pattern: string, params: unknown): string | null {
   return segments.join('/');
 }
 
-export function resolveUrlFromRoute(config: ILinkingConfig, route: IRoute<unknown>): string | null {
+export function resolveUrlFromRoute(
+  config: ILinkingConfig,
+  route: IRoute<unknown>,
+): string | null {
   const candidate = flattenScreens(config.config.screens, '', []).find(
     entry => entry.name === route.name,
   );

package/src/core/navigation-events/index.ts

@@ -32,11 +32,17 @@ export type INavigationEventListener<TData = unknown> = (data: TData) => void;
 
 export type INavigationEmitter = {
   emit: (event: INavigationEventName, data?: unknown) => void;
-  addListener: (event: INavigationEventName, listener: INavigationEventListener) => () => void;
+  addListener: (
+    event: INavigationEventName,
+    listener: INavigationEventListener,
+  ) => () => void;
 };
 
 export function createNavigationEmitter(): INavigationEmitter {
-  const listenersByEvent = new Map<INavigationEventName, Set<INavigationEventListener>>();
+  const listenersByEvent = new Map<
+    INavigationEventName,
+    Set<INavigationEventListener>
+  >();
 
   function addListener(
     event: INavigationEventName,

package/src/core/navigator-handles/index.ts

@@ -44,9 +44,12 @@ export type IDrawerDescriptorMap = Record<
 // return this union since they don't know which navigator mounted the calling component; the
 // three guards below narrow it (used once, inside useStackNavigation/useTabNavigation/
 // useDrawerNavigation and their Vue/Angular equivalents) so app code never writes the guard itself.
-export type IAnyNavigatorHandle = INavigatorHandle | ITabNavigatorHandle | IDrawerNavigatorHandle;
+export type IAnyNavigatorHandle =
+  INavigatorHandle | ITabNavigatorHandle | IDrawerNavigatorHandle;
 
-export function isStackNavigatorHandle(handle: IAnyNavigatorHandle): handle is INavigatorHandle {
+export function isStackNavigatorHandle(
+  handle: IAnyNavigatorHandle,
+): handle is INavigatorHandle {
   return 'push' in handle;
 }
 
@@ -58,6 +61,8 @@ export function isDrawerNavigatorHandle(
 
 // jumpTo exists on both Tab and Drawer handles, so a Tab handle is a jumpTo-having handle that
 // isn't a Drawer handle (Drawer's own openDrawer/closeDrawer/toggleDrawer rule it out).
-export function isTabNavigatorHandle(handle: IAnyNavigatorHandle): handle is ITabNavigatorHandle {
+export function isTabNavigatorHandle(
+  handle: IAnyNavigatorHandle,
+): handle is ITabNavigatorHandle {
   return 'jumpTo' in handle && !isDrawerNavigatorHandle(handle);
 }

package/src/core/navigator-props.ts

@@ -51,8 +51,10 @@ export type IOptionalBooleanNativeProp = 'undefined' | 'false' | 'true';
 // mirrors react-native-screens' own ScreenProps['sheetAllowedDetents'] - a plain fraction array,
 // sorted ascending, or one of RNS's named presets; the fold to the native `sheetAllowedDetents:
 // number[]` array happens in screen-options.ts, replicating RNS's own resolveSheetAllowedDetents.
-export type ISheetAllowedDetents = number[] | 'fitToContents' | 'large' | 'medium' | 'all';
-export type ISheetLargestUndimmedDetent = number | 'last' | 'none' | 'all' | 'large' | 'medium';
+export type ISheetAllowedDetents =
+  number[] | 'fitToContents' | 'large' | 'medium' | 'all';
+export type ISheetLargestUndimmedDetent =
+  number | 'last' | 'none' | 'all' | 'large' | 'medium';
 export type ISheetInitialDetent = number | 'last';
 
 // A bar-button item's icon: SF Symbol / iOS asset-catalog name, or an image asset. Mirrors RNS's
@@ -143,13 +145,20 @@ export type IHeaderBarButtonItemMenu = ISharedHeaderBarButtonItem & {
 export type IHeaderBarButtonItemSpacing = { type: 'spacing'; spacing: number };
 
 export type IHeaderBarButtonItem =
-  IHeaderBarButtonItemAction | IHeaderBarButtonItemMenu | IHeaderBarButtonItemSpacing;
+  | IHeaderBarButtonItemAction
+  | IHeaderBarButtonItemMenu
+  | IHeaderBarButtonItemSpacing;
 
 export type ISearchBarAutoCapitalize =
   'systemDefault' | 'none' | 'words' | 'sentences' | 'characters';
 
 export type ISearchBarPlacement =
-  'automatic' | 'inline' | 'stacked' | 'integrated' | 'integratedButton' | 'integratedCentered';
+  | 'automatic'
+  | 'inline'
+  | 'stacked'
+  | 'integrated'
+  | 'integratedButton'
+  | 'integratedCentered';
 
 // RNSSearchBar's full static config surface plus every event callback react-native-screens'
 // own SearchBarProps exposes (types.tsx): onChangeText/onSearchButtonPress carry the current