@apexnative/navigation 0.0.0-stage → 1.0.0-alpha.0

package/lib/module/api/screens/registerScreens.js

@@ -0,0 +1,305 @@
+"use strict";
+
+import React, { Component, createContext, lazy, Suspense, useEffect, useMemo, useState } from 'react';
+import { Platform, StyleSheet } from 'react-native';
+import ANNTurboModule from "../../adapters/NativeANNTurboModule.js";
+import { isButtonRoot } from "../../engine/props.js";
+import { checkArrangements, onScreenUnmounted, registerScreen as registerEngineScreen } from "../../engine/screens.js";
+import { screenUnmounted } from "../events/screenLifecycle.js";
+import { mergeOptions } from "../../engine/mergeOptions.js";
+import { preparedPadding } from "../../engine/slots.js";
+import { buildScreenOptions } from "./defineScreen.js";
+import { isNativeScreen } from "./nativeScreens.js";
+import { isArrangement, toEngineArrangement } from "./arrangement.js";
+import { ScreenBoundary } from "./ScreenBoundary.js";
+import ANNSafeAreaView from '../safeArea/ANNSafeAreaViewNativeComponent';
+
+/**
+ * A screen: its component, its definition (`{ component, options }`, see `defineScreen`), `{ load }` to load its
+ * module the first time a command shows it (`() => import('./screens/Settings')`, the screen is its default export),
+ * or a screen of the native side (`nativeScreen`).
+ */
+
+/** A screen: the id of this showing of it, and its name in `screens`. */
+
+/** Wraps every screen on its own. */
+
+/** What a screen shows while it waits for a lazy component or data. */
+
+/** What the app wraps each of its screens in. */
+import { jsx as _jsx } from "react/jsx-runtime";
+export const ScreenContext = /*#__PURE__*/createContext(null);
+
+/** Screens sharing options, such as the sign-in screens without a top bar. */
+
+/** Screens to register: those of `screens`, or of a group. */
+
+// The root of a screen tells when it unmounts: what the screen left behind goes.
+onScreenUnmounted(screenUnmounted);
+export function registerScreens(sets, wrapper = {}) {
+  // The screens of every set are in one namespace: a command names a screen without its group.
+  const sources = new Map();
+  for (const {
+    source,
+    screens,
+    options,
+    ownRoot
+  } of sets) {
+    for (const [name, entry] of Object.entries(screens)) {
+      const other = sources.get(name);
+      if (other) {
+        throw new Error(`[navigation] The screen '${name}' is in ${other} and in ${source}: a name goes once`);
+      }
+      sources.set(name, source);
+      registerScreen(name, entry, wrapper, options, ownRoot);
+    }
+  }
+  // A pair names screens of any set.
+  checkArrangements();
+}
+function registerScreen(name, entry, wrapper, groupOptions, ownRoot) {
+  if (isArrangement(entry)) {
+    registerEngineScreen(name, {
+      pair: toEngineArrangement(entry.definition.primary, entry.definition)
+    });
+    return;
+  }
+  if (isNativeScreen(entry)) {
+    registerEngineScreen(name, {
+      nativeName: entry.nativeName,
+      options: props => mergeOptions(buildScreenOptions(groupOptions, props), buildScreenOptions(entry.options, props)),
+      controller: entry.useProps && wrapNativeScreen(name, entry.useProps, wrapper),
+      arrangement: pairOf(name, entry.arrangement)
+    });
+    return;
+  }
+  // React.memo and forwardRef components are objects, so the kind of entry is told by its keys.
+  if (isObject(entry) && 'load' in entry) {
+    const screen = lazyScreen(entry.load);
+    registerEngineScreen(name, {
+      component: () => wrapScreen(name, screen.component, wrapper),
+      // A command loads the screen before it reads its options.
+      options: props => mergeOptions(buildScreenOptions(groupOptions, props), buildScreenOptions(screen.definition()?.options, props)),
+      key: props => screen.definition()?.key?.(props),
+      load: screen.load,
+      ownRoot,
+      arrangement: () => {
+        const arrangement = screen.definition()?.arrangement;
+        return arrangement && toEngineArrangement(name, arrangement);
+      }
+    });
+    return;
+  }
+  const definition = toDefinition(entry);
+  registerEngineScreen(name, {
+    component: () => wrapScreen(name, definition.component, wrapper),
+    options: props => mergeOptions(buildScreenOptions(groupOptions, props), buildScreenOptions(definition.options, props)),
+    key: definition.key && (props => definition.key(props)),
+    ownRoot,
+    arrangement: pairOf(name, definition.arrangement)
+  });
+}
+
+// The pair of a screen whose `arrangement` is known at registration: checked and filled in once.
+function pairOf(name, arrangement) {
+  if (!arrangement) return undefined;
+  const pair = toEngineArrangement(name, arrangement);
+  return () => pair;
+}
+function toDefinition(value) {
+  return isObject(value) && 'component' in value ? value : {
+    component: value
+  };
+}
+
+/**
+ * A screen whose module loads the first time a command shows it. A failed load is tried again by the next command.
+ * The component renders the loaded screen; one that renders before (a bar's component in the options of another
+ * screen) waits for it in Suspense.
+ */
+function lazyScreen(loadModule) {
+  let definition;
+  let loading;
+  const load = () => {
+    if (definition) return undefined;
+    if (!loading) {
+      loading = Promise.resolve().then(loadModule).then(module => {
+        definition = toDefinition(unwrapModule(module));
+      });
+      loading.catch(() => {
+        loading = undefined;
+      });
+    }
+    return loading;
+  };
+  const Loaded = /*#__PURE__*/lazy(async () => {
+    await load();
+    return {
+      default: definition.component
+    };
+  });
+  function LazyScreen(props) {
+    // The same component for the life of the view, so that the load doesn't mount it again.
+    const [Screen] = useState(() => definition?.component ?? Loaded);
+    return /*#__PURE__*/_jsx(Screen, {
+      ...props
+    });
+  }
+  return {
+    load,
+    definition: () => definition,
+    component: LazyScreen
+  };
+}
+function unwrapModule(loaded) {
+  return isObject(loaded) && 'default' in loaded ? loaded.default : loaded;
+}
+function isObject(value) {
+  return typeof value === 'object' && value !== null;
+}
+
+// Without the native side (tests with the mock) nothing lays the safe area view out: the content renders at once.
+const WAITS_FOR_LAYOUT = ANNTurboModule != null;
+function wrapScreen(name, Screen, wrapper) {
+  const {
+    provider: Provider,
+    errorFallback,
+    loadingFallback: Loading,
+    onError
+  } = wrapper;
+  // The component gets the props of the command, nothing else: its id comes from useScreen().
+  function NavigationScreen({
+    componentId,
+    ...props
+  }) {
+    const screen = useMemo(() => ({
+      id: componentId,
+      name
+    }), [componentId]);
+    // The content renders once the safe area view is laid out in its place, as react-native-safe-area-context does:
+    // a list that is there before the first layout of the top bar makes UIKit start the large title collapsed. A
+    // screen the native side laid out before its push (Android, one tree) knows its padding: it renders at once.
+    const [initialPadding] = useState(() => preparedPadding(componentId));
+    const [ready, setReady] = useState(!WAITS_FOR_LAYOUT || initialPadding !== undefined);
+    // On iOS the native side only sizes a bar button's slot to the content and moves nothing inside it: the content is
+    // centered here. Android's cell centers the component itself.
+    const [barButton] = useState(() => Platform.OS === 'ios' && isButtonRoot(componentId));
+    // One boundary inside the provider, so the fallback has what it provides, and one outside for the provider itself.
+    const boundary = children => /*#__PURE__*/_jsx(ScreenBoundary, {
+      screen: screen,
+      fallback: errorFallback,
+      onError: onError && ((error, stack) => onError(error, screen, stack)),
+      children: children
+    });
+    const content = boundary(/*#__PURE__*/_jsx(Suspense, {
+      fallback: Loading ? /*#__PURE__*/_jsx(Loading, {
+        screen: screen
+      }) : null,
+      children: /*#__PURE__*/_jsx(Screen, {
+        ...props
+      })
+    }));
+    return (
+      /*#__PURE__*/
+      // Outside the providers, so the screen's navigation works inside them and in the fallbacks too.
+      _jsx(ScreenContext.Provider, {
+        value: screen,
+        children: /*#__PURE__*/_jsx(ANNSafeAreaView, {
+          screenId: componentId,
+          initialPadding: initialPadding,
+          onReady: () => setReady(true),
+          contentRendered: ready,
+          pointerEvents: "box-none",
+          style: barButton ? [styles.safeArea, styles.barButton] : styles.safeArea,
+          children: ready ? Provider ? boundary(/*#__PURE__*/_jsx(Provider, {
+            screen: screen,
+            children: content
+          })) : content : null
+        })
+      })
+    );
+  }
+  NavigationScreen.displayName = `Screen(${name})`;
+  return NavigationScreen;
+}
+
+/**
+ * The controller of a native screen's `useProps`: the hook in a component of its own, with the screen's navigation
+ * and inside the screen provider, as a React screen has them. It renders nothing.
+ */
+function wrapNativeScreen(name, useProps, {
+  provider: Provider,
+  onError
+}) {
+  function Hook({
+    props,
+    onProps
+  }) {
+    const result = useProps(props);
+    // After each render React committed, so the native side never shows what the app did not.
+    useEffect(() => onProps(result));
+    return null;
+  }
+  function NativeScreenProps({
+    componentId,
+    props,
+    onProps,
+    onError: failed
+  }) {
+    const screen = useMemo(() => ({
+      id: componentId,
+      name
+    }), [componentId]);
+    const hook = /*#__PURE__*/_jsx(Hook, {
+      props: props,
+      onProps: onProps
+    });
+    return /*#__PURE__*/_jsx(ScreenContext.Provider, {
+      value: screen,
+      children: /*#__PURE__*/_jsx(HookBoundary, {
+        onError: (error, componentStack) => {
+          failed(error);
+          onError?.(error, screen, componentStack);
+        },
+        children: /*#__PURE__*/_jsx(Suspense, {
+          fallback: null,
+          children: Provider ? /*#__PURE__*/_jsx(Provider, {
+            screen: screen,
+            children: hook
+          }) : hook
+        })
+      })
+    });
+  }
+  NativeScreenProps.displayName = `NativeScreenProps(${name})`;
+  return NativeScreenProps;
+}
+
+// A hook that failed renders nothing again: the screen keeps the props it has.
+class HookBoundary extends Component {
+  state = {
+    failed: false
+  };
+  static getDerivedStateFromError() {
+    return {
+      failed: true
+    };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError(error, info.componentStack);
+  }
+  render() {
+    return this.state.failed ? null : this.props.children;
+  }
+}
+const styles = StyleSheet.create({
+  safeArea: {
+    flex: 1
+  },
+  // Centered, not stretched: the content keeps its own size, so the slot still measures the content's width.
+  barButton: {
+    justifyContent: 'center',
+    alignItems: 'center'
+  }
+});
+//# sourceMappingURL=registerScreens.js.map

package/lib/module/api/screens/registerScreens.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","Component","createContext","lazy","Suspense","useEffect","useMemo","useState","Platform","StyleSheet","ANNTurboModule","isButtonRoot","checkArrangements","onScreenUnmounted","registerScreen","registerEngineScreen","screenUnmounted","mergeOptions","preparedPadding","buildScreenOptions","isNativeScreen","isArrangement","toEngineArrangement","ScreenBoundary","ANNSafeAreaView","jsx","_jsx","ScreenContext","registerScreens","sets","wrapper","sources","Map","source","screens","options","ownRoot","name","entry","Object","entries","other","get","Error","set","groupOptions","pair","definition","primary","nativeName","props","controller","useProps","wrapNativeScreen","arrangement","pairOf","isObject","screen","lazyScreen","load","component","wrapScreen","key","toDefinition","undefined","value","loadModule","loading","Promise","resolve","then","module","unwrapModule","catch","Loaded","default","LazyScreen","Screen","loaded","WAITS_FOR_LAYOUT","provider","Provider","errorFallback","loadingFallback","Loading","onError","NavigationScreen","componentId","id","initialPadding","ready","setReady","barButton","OS","boundary","children","fallback","error","stack","content","screenId","onReady","contentRendered","pointerEvents","style","styles","safeArea","displayName","Hook","onProps","result","NativeScreenProps","failed","hook","HookBoundary","componentStack","state","getDerivedStateFromError","componentDidCatch","info","render","create","flex","justifyContent","alignItems"],"sourceRoot":"../../../../src","sources":["api/screens/registerScreens.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/api/slots/ANNSlotNativeComponent.ts

@@ -0,0 +1,23 @@
+import {
+  codegenNativeComponent,
+  type CodegenTypes,
+  type HostComponent,
+  type ViewProps,
+} from 'react-native';
+
+// `nativeID` is the slot id.
+export interface NativeProps extends ViewProps {
+  /**
+   * `[width, height]` in dp: the size of the container its screen was laid out in before the push (Android), so the
+   * first layout already has it. Empty: the container gives it once it is laid out.
+   */
+  initialSize?: ReadonlyArray<CodegenTypes.Float>;
+}
+
+/**
+ * Shows its children inside the native container with the same slot id (`nativeID`), at the container's size. The
+ * children stay in the app's one React tree, so they read its providers.
+ */
+export default codegenNativeComponent<NativeProps>('ANNSlot', {
+  interfaceOnly: true,
+}) as HostComponent<NativeProps>;

package/lib/module/api/slots/SlotHost.js

@@ -0,0 +1,92 @@
+"use strict";
+
+import React, { memo, useEffect, useLayoutEffect, useMemo, useSyncExternalStore } from 'react';
+import { StyleSheet } from 'react-native';
+import { hostMountedChanged, nativeScreenHooks } from "../../engine/nativeScreens.js";
+import { screenRoot } from "../../engine/screens.js";
+import { slotCommitted, slotStore } from "../../engine/slots.js";
+import ANNSlot from './ANNSlotNativeComponent';
+
+// The native side sizes a slot to its container and positions it absolutely; it starts at the corner of the host.
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const styles = StyleSheet.create({
+  slot: {
+    left: 0,
+    top: 0
+  }
+});
+
+// One per screen: a screen shown or gone does not render the others again.
+const SlotScreen = /*#__PURE__*/memo(function SlotContent({
+  slot
+}) {
+  const Screen = screenRoot(slot.name);
+  const {
+    key,
+    held,
+    frame
+  } = slot;
+  const initialSize = useMemo(() => frame && [frame.width, frame.height], [frame]);
+  // A screen laid out before its push is pushed once React committed it.
+  useLayoutEffect(() => {
+    if (frame && !held) slotCommitted(key);
+  }, [key, held, frame]);
+  if (!Screen || held) return null;
+  return /*#__PURE__*/_jsx(ANNSlot, {
+    nativeID: slot.id,
+    style: styles.slot,
+    initialSize: initialSize,
+    children: /*#__PURE__*/_jsx(Screen, {
+      componentId: slot.id
+    })
+  });
+});
+
+// One per native screen with `useProps`: its hook, which renders nothing.
+const NativeScreenProps = /*#__PURE__*/memo(function NativeScreenContent({
+  hook
+}) {
+  const {
+    Controller,
+    componentId,
+    props,
+    onProps,
+    onError
+  } = hook;
+  return /*#__PURE__*/_jsx(Controller, {
+    componentId: componentId,
+    props: props,
+    onProps: onProps,
+    onError: onError
+  });
+});
+function NativeScreenHooks() {
+  const hooks = useSyncExternalStore(nativeScreenHooks.subscribe, nativeScreenHooks.get);
+  return hooks.map(hook => /*#__PURE__*/_jsx(NativeScreenProps, {
+    hook: hook
+  }, hook.key));
+}
+
+/**
+ * The app's hidden React root, which the native side runs as `SLOT_HOST_MODULE`: in one tree, the app's provider
+ * around a slot for every screen shown; in any mode, the hooks of the native screens (`useProps`), inside the app's
+ * provider when there is one. Before the app starts, as after a reload, it renders no screens.
+ */
+export function SlotHost() {
+  const {
+    provider: Provider,
+    slots
+  } = useSyncExternalStore(slotStore.subscribe, slotStore.get);
+  useEffect(() => {
+    hostMountedChanged(true);
+    return () => hostMountedChanged(false);
+  }, []);
+  // The app sets its provider as it launches, before a command shows a screen: the hooks never move under it.
+  if (!Provider) return /*#__PURE__*/_jsx(NativeScreenHooks, {});
+  return /*#__PURE__*/_jsxs(Provider, {
+    children: [slots.map(slot => /*#__PURE__*/_jsx(SlotScreen, {
+      slot: slot
+    }, slot.key)), /*#__PURE__*/_jsx(NativeScreenHooks, {})]
+  });
+}
+//# sourceMappingURL=SlotHost.js.map

package/lib/module/api/slots/SlotHost.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","memo","useEffect","useLayoutEffect","useMemo","useSyncExternalStore","StyleSheet","hostMountedChanged","nativeScreenHooks","screenRoot","slotCommitted","slotStore","ANNSlot","jsx","_jsx","jsxs","_jsxs","styles","create","slot","left","top","SlotScreen","SlotContent","Screen","name","key","held","frame","initialSize","width","height","nativeID","id","style","children","componentId","NativeScreenProps","NativeScreenContent","hook","Controller","props","onProps","onError","NativeScreenHooks","hooks","subscribe","get","map","SlotHost","provider","Provider","slots"],"sourceRoot":"../../../../src","sources":["api/slots/SlotHost.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,IAAI,EAAEC,SAAS,EAAEC,eAAe,EAAEC,OAAO,EAAEC,oBAAoB,QAAQ,OAAO;AAC9F,SAASC,UAAU,QAAQ,cAAc;AACzC,SACEC,kBAAkB,EAElBC,iBAAiB,QACZ,+BAA4B;AACnC,SAASC,UAAU,QAAQ,yBAAsB;AACjD,SAAoBC,aAAa,EAAEC,SAAS,QAAQ,uBAAoB;AACxE,OAAOC,OAAO,MAAM,0BAA0B;;AAE9C;AAAA,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AACA,MAAMC,MAAM,GAAGX,UAAU,CAACY,MAAM,CAAC;EAAEC,IAAI,EAAE;IAAEC,IAAI,EAAE,CAAC;IAAEC,GAAG,EAAE;EAAE;AAAE,CAAC,CAAC;;AAE/D;AACA,MAAMC,UAAU,gBAAGrB,IAAI,CAAC,SAASsB,WAAWA,CAAC;EAAEJ;AAAqB,CAAC,EAAE;EACrE,MAAMK,MAAM,GAAGf,UAAU,CAACU,IAAI,CAACM,IAAI,CAAC;EACpC,MAAM;IAAEC,GAAG;IAAEC,IAAI;IAAEC;EAAM,CAAC,GAAGT,IAAI;EACjC,MAAMU,WAAW,GAAGzB,OAAO,CAAC,MAAMwB,KAAK,IAAI,CAACA,KAAK,CAACE,KAAK,EAAEF,KAAK,CAACG,MAAM,CAAC,EAAE,CAACH,KAAK,CAAC,CAAC;EAChF;EACAzB,eAAe,CAAC,MAAM;IACpB,IAAIyB,KAAK,IAAI,CAACD,IAAI,EAAEjB,aAAa,CAACgB,GAAG,CAAC;EACxC,CAAC,EAAE,CAACA,GAAG,EAAEC,IAAI,EAAEC,KAAK,CAAC,CAAC;EACtB,IAAI,CAACJ,MAAM,IAAIG,IAAI,EAAE,OAAO,IAAI;EAChC,oBACEb,IAAA,CAACF,OAAO;IAACoB,QAAQ,EAAEb,IAAI,CAACc,EAAG;IAACC,KAAK,EAAEjB,MAAM,CAACE,IAAK;IAACU,WAAW,EAAEA,WAAY;IAAAM,QAAA,eACvErB,IAAA,CAACU,MAAM;MAACY,WAAW,EAAEjB,IAAI,CAACc;IAAG,CAAE;EAAC,CACzB,CAAC;AAEd,CAAC,CAAC;;AAEF;AACA,MAAMI,iBAAiB,gBAAGpC,IAAI,CAAC,SAASqC,mBAAmBA,CAAC;EAAEC;AAAiC,CAAC,EAAE;EAChG,MAAM;IAAEC,UAAU;IAAEJ,WAAW;IAAEK,KAAK;IAAEC,OAAO;IAAEC;EAAQ,CAAC,GAAGJ,IAAI;EACjE,oBAAOzB,IAAA,CAAC0B,UAAU;IAACJ,WAAW,EAAEA,WAAY;IAACK,KAAK,EAAEA,KAAM;IAACC,OAAO,EAAEA,OAAQ;IAACC,OAAO,EAAEA;EAAQ,CAAE,CAAC;AACnG,CAAC,CAAC;AAEF,SAASC,iBAAiBA,CAAA,EAAG;EAC3B,MAAMC,KAAK,GAAGxC,oBAAoB,CAACG,iBAAiB,CAACsC,SAAS,EAAEtC,iBAAiB,CAACuC,GAAG,CAAC;EACtF,OAAOF,KAAK,CAACG,GAAG,CAAET,IAAI,iBAAKzB,IAAA,CAACuB,iBAAiB;IAAgBE,IAAI,EAAEA;EAAK,GAArBA,IAAI,CAACb,GAAkB,CAAC,CAAC;AAC9E;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASuB,QAAQA,CAAA,EAAG;EACzB,MAAM;IAAEC,QAAQ,EAAEC,QAAQ;IAAEC;EAAM,CAAC,GAAG/C,oBAAoB,CAACM,SAAS,CAACmC,SAAS,EAAEnC,SAAS,CAACoC,GAAG,CAAC;EAC9F7C,SAAS,CAAC,MAAM;IACdK,kBAAkB,CAAC,IAAI,CAAC;IACxB,OAAO,MAAMA,kBAAkB,CAAC,KAAK,CAAC;EACxC,CAAC,EAAE,EAAE,CAAC;EACN;EACA,IAAI,CAAC4C,QAAQ,EAAE,oBAAOrC,IAAA,CAAC8B,iBAAiB,IAAE,CAAC;EAC3C,oBACE5B,KAAA,CAACmC,QAAQ;IAAAhB,QAAA,GACNiB,KAAK,CAACJ,GAAG,CAAE7B,IAAI,iBACdL,IAAA,CAACQ,UAAU;MAAgBH,IAAI,EAAEA;IAAK,GAArBA,IAAI,CAACO,GAAkB,CACzC,CAAC,eACFZ,IAAA,CAAC8B,iBAAiB,IAAE,CAAC;EAAA,CACb,CAAC;AAEf","ignoreList":[]}

package/lib/module/api/state/navigationState.js

@@ -0,0 +1,98 @@
+"use strict";
+
+import { onNativeEvent } from "../../engine/native.js";
+
+/**
+ * What the user sees: the screen and the selected tab. The native side sends it when it changes, and before a command
+ * that changed it resolves.
+ */
+
+let state = {
+  screen: null,
+  tab: null
+};
+const listeners = new Set();
+// The screens that appeared and haven't disappeared since, for a component that mounts in one later.
+const appeared = new Set();
+let listening = false;
+
+/** Keeps the last state from the native side and the screens shown; the app starts it before its first root. */
+export function listenToNavigationState() {
+  if (listening) return;
+  listening = true;
+  onNativeEvent('NavigationStateChanged', next => {
+    state = next;
+    listeners.forEach(listener => listener(state));
+  });
+  onNativeEvent('ComponentDidAppear', ({
+    componentId
+  }) => {
+    appeared.add(componentId);
+  });
+  onNativeEvent('ComponentDidDisappear', ({
+    componentId
+  }) => {
+    appeared.delete(componentId);
+  });
+}
+
+/** Whether the screen has appeared and not disappeared since, as the native side told it. */
+export function hasAppeared(screenId) {
+  return appeared.has(screenId);
+}
+
+/** The screen is gone: a disappearance that never came doesn't count it as shown for a screen with its id later. */
+export function forgetAppeared(screenId) {
+  appeared.delete(screenId);
+}
+export function getNavigationState() {
+  return state;
+}
+
+/** Calls the listener on each change; returns the function that stops it. */
+export function onNavigationStateChange(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+
+/**
+ * Resolves once the native side sent a state newer than `since` with a screen in it, at the latest after `timeout`:
+ * the state then shows what the commands before it changed, such as the screen of a new root.
+ */
+export function whenScreenAfter(since, timeout) {
+  const shows = next => next !== since && next.screen !== null;
+  if (shows(state)) return Promise.resolve();
+  return new Promise(resolve => {
+    const done = () => {
+      clearTimeout(timer);
+      stop();
+      resolve();
+    };
+    const timer = setTimeout(done, timeout);
+    const stop = onNavigationStateChange(next => {
+      if (shows(next)) done();
+    });
+  });
+}
+
+/**
+ * Resolves once the state shows the tab: a tab by index at once when it shows already, otherwise on the next change of
+ * the state, and at the latest after `timeout` (a tab by id that shows already changes nothing).
+ */
+export function whenTabShows(tab, timeout = 300) {
+  if (typeof tab === 'number' && state.tab === tab) return Promise.resolve();
+  return new Promise(resolve => {
+    const done = () => {
+      clearTimeout(timer);
+      stop();
+      resolve();
+    };
+    const timer = setTimeout(done, timeout);
+    const stop = onNavigationStateChange(next => {
+      if (typeof tab !== 'number' || next.tab === tab) done();
+    });
+  });
+}
+//# sourceMappingURL=navigationState.js.map

package/lib/module/api/state/navigationState.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["onNativeEvent","state","screen","tab","listeners","Set","appeared","listening","listenToNavigationState","next","forEach","listener","componentId","add","delete","hasAppeared","screenId","has","forgetAppeared","getNavigationState","onNavigationStateChange","whenScreenAfter","since","timeout","shows","Promise","resolve","done","clearTimeout","timer","stop","setTimeout","whenTabShows"],"sourceRoot":"../../../../src","sources":["api/state/navigationState.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,wBAAqB;;AAOnD;AACA;AACA;AACA;;AAGA,IAAIC,KAAsB,GAAG;EAAEC,MAAM,EAAE,IAAI;EAAEC,GAAG,EAAE;AAAK,CAAC;AACxD,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAmC,CAAC;AAC7D;AACA,MAAMC,QAAQ,GAAG,IAAID,GAAG,CAAS,CAAC;AAClC,IAAIE,SAAS,GAAG,KAAK;;AAErB;AACA,OAAO,SAASC,uBAAuBA,CAAA,EAAG;EACxC,IAAID,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBP,aAAa,CAA8B,wBAAwB,EAAGS,IAAI,IAAK;IAC7ER,KAAK,GAAGQ,IAAI;IACZL,SAAS,CAACM,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAACV,KAAK,CAAC,CAAC;EAClD,CAAC,CAAC;EACFD,aAAa,CAA0B,oBAAoB,EAAE,CAAC;IAAEY;EAAY,CAAC,KAAK;IAChFN,QAAQ,CAACO,GAAG,CAACD,WAAW,CAAC;EAC3B,CAAC,CAAC;EACFZ,aAAa,CAA6B,uBAAuB,EAAE,CAAC;IAAEY;EAAY,CAAC,KAAK;IACtFN,QAAQ,CAACQ,MAAM,CAACF,WAAW,CAAC;EAC9B,CAAC,CAAC;AACJ;;AAEA;AACA,OAAO,SAASG,WAAWA,CAACC,QAAgB,EAAW;EACrD,OAAOV,QAAQ,CAACW,GAAG,CAACD,QAAQ,CAAC;AAC/B;;AAEA;AACA,OAAO,SAASE,cAAcA,CAACF,QAAgB,EAAQ;EACrDV,QAAQ,CAACQ,MAAM,CAACE,QAAQ,CAAC;AAC3B;AAEA,OAAO,SAASG,kBAAkBA,CAAA,EAAoB;EACpD,OAAOlB,KAAK;AACd;;AAEA;AACA,OAAO,SAASmB,uBAAuBA,CAACT,QAA0C,EAAc;EAC9FP,SAAS,CAACS,GAAG,CAACF,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXP,SAAS,CAACU,MAAM,CAACH,QAAQ,CAAC;EAC5B,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASU,eAAeA,CAACC,KAAsB,EAAEC,OAAe,EAAiB;EACtF,MAAMC,KAAK,GAAIf,IAAqB,IAAKA,IAAI,KAAKa,KAAK,IAAIb,IAAI,CAACP,MAAM,KAAK,IAAI;EAC/E,IAAIsB,KAAK,CAACvB,KAAK,CAAC,EAAE,OAAOwB,OAAO,CAACC,OAAO,CAAC,CAAC;EAC1C,OAAO,IAAID,OAAO,CAAEC,OAAO,IAAK;IAC9B,MAAMC,IAAI,GAAGA,CAAA,KAAM;MACjBC,YAAY,CAACC,KAAK,CAAC;MACnBC,IAAI,CAAC,CAAC;MACNJ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAMG,KAAK,GAAGE,UAAU,CAACJ,IAAI,EAAEJ,OAAO,CAAC;IACvC,MAAMO,IAAI,GAAGV,uBAAuB,CAAEX,IAAI,IAAK;MAC7C,IAAIe,KAAK,CAACf,IAAI,CAAC,EAAEkB,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;EACJ,CAAC,CAAC;AACJ;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,YAAYA,CAAC7B,GAAoB,EAAEoB,OAAO,GAAG,GAAG,EAAiB;EAC/E,IAAI,OAAOpB,GAAG,KAAK,QAAQ,IAAIF,KAAK,CAACE,GAAG,KAAKA,GAAG,EAAE,OAAOsB,OAAO,CAACC,OAAO,CAAC,CAAC;EAC1E,OAAO,IAAID,OAAO,CAAEC,OAAO,IAAK;IAC9B,MAAMC,IAAI,GAAGA,CAAA,KAAM;MACjBC,YAAY,CAACC,KAAK,CAAC;MACnBC,IAAI,CAAC,CAAC;MACNJ,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAMG,KAAK,GAAGE,UAAU,CAACJ,IAAI,EAAEJ,OAAO,CAAC;IACvC,MAAMO,IAAI,GAAGV,uBAAuB,CAAEX,IAAI,IAAK;MAC7C,IAAI,OAAON,GAAG,KAAK,QAAQ,IAAIM,IAAI,CAACN,GAAG,KAAKA,GAAG,EAAEwB,IAAI,CAAC,CAAC;IACzD,CAAC,CAAC;EACJ,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/api/testIDs.js

@@ -0,0 +1,14 @@
+"use strict";
+
+/**
+ * Ids of the views the navigation shows without an id from the app, for end-to-end tests (Detox, Maestro, Appium) to
+ * find them by.
+ */
+export const TestIDs = {
+  /**
+   * The back button of a stack's top bar: UIKit gives the system button this id on iOS, and the navigation gives the
+   * same one on Android. `topBar.backButton.testID` sets another on Android.
+   */
+  backButton: 'BackButton'
+};
+//# sourceMappingURL=testIDs.js.map

package/lib/module/api/testIDs.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TestIDs","backButton"],"sourceRoot":"../../../src","sources":["api/testIDs.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,MAAMA,OAAO,GAAG;EACrB;AACF;AACA;AACA;EACEC,UAAU,EAAE;AACd,CAAU","ignoreList":[]}