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

package/lib/module/api/hooks/appHooks.js

@@ -0,0 +1,26 @@
+"use strict";
+
+import { useMemo, useSyncExternalStore } from 'react';
+import { useColorScheme } from 'react-native';
+import { getAppContext, subscribeAppContext } from "../context/appContext.js";
+import { getTheme, resolveTheme, subscribeTheme } from "../theme/theme.js";
+/**
+ * The theme of the navigation, its colors for the current appearance: they go straight into styles. The component
+ * renders again when `navigation.setTheme` changes the theme, and when the appearance turns light or dark.
+ */
+export function useNavigationTheme() {
+  const theme = useSyncExternalStore(subscribeTheme, getTheme);
+  const scheme = useColorScheme() === 'dark' ? 'dark' : 'light';
+  return useMemo(() => resolveTheme(theme, scheme), [theme, scheme]);
+}
+
+/**
+ * The app's context: `context` of createNavigation, as `navigation.setContext` changed it since. Any component, in any
+ * screen. With `select`, the component renders again only when the selected part changes, so a change of the language
+ * doesn't render a component that reads the user; without it, on every change.
+ */
+
+export function useAppContext(select) {
+  return useSyncExternalStore(subscribeAppContext, () => select ? select(getAppContext()) : getAppContext());
+}
+//# sourceMappingURL=appHooks.js.map

package/lib/module/api/hooks/appHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useMemo","useSyncExternalStore","useColorScheme","getAppContext","subscribeAppContext","getTheme","resolveTheme","subscribeTheme","useNavigationTheme","theme","scheme","useAppContext","select"],"sourceRoot":"../../../../src","sources":["api/hooks/appHooks.ts"],"mappings":";;AAAA,SAASA,OAAO,EAAEC,oBAAoB,QAAQ,OAAO;AACrD,SAASC,cAAc,QAAQ,cAAc;AAC7C,SAASC,aAAa,EAAEC,mBAAmB,QAAQ,0BAAuB;AAC1E,SACEC,QAAQ,EACRC,YAAY,EAEZC,cAAc,QACT,mBAAgB;AAGvB;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAA4B;EAC5D,MAAMC,KAAK,GAAGR,oBAAoB,CAACM,cAAc,EAAEF,QAAQ,CAAC;EAC5D,MAAMK,MAAM,GAAGR,cAAc,CAAC,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,OAAO;EAC7D,OAAOF,OAAO,CAAC,MAAMM,YAAY,CAACG,KAAK,EAAEC,MAAM,CAAC,EAAE,CAACD,KAAK,EAAEC,MAAM,CAAC,CAAC;AACpE;;AAEA;AACA;AACA;AACA;AACA;;AAKA,OAAO,SAASC,aAAaA,CAC3BC,MAAuC,EACnB;EACpB,OAAOX,oBAAoB,CAACG,mBAAmB,EAAE,MAC/CQ,MAAM,GAAGA,MAAM,CAACT,aAAa,CAAU,CAAC,CAAC,GAAGA,aAAa,CAAU,CACrE,CAAC;AACH","ignoreList":[]}

package/lib/module/api/hooks/screenHooks.js

@@ -0,0 +1,250 @@
+"use strict";
+
+import { useContext, useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
+import { takeButtonHandlers } from "../../engine/buttons.js";
+import { mergeOptions } from "../../engine/commands.js";
+import { holdLeave } from "../commands/commands.js";
+import { placeOf } from "../../engine/places.js";
+import { onScreenTabPress } from "../events/tabPresses.js";
+import { onNavigationEvent } from "../events/navigationEvents.js";
+
+/** The events a screen hears about itself: those that carry the screen, and the move of the accessory it shows. */
+
+import { readScreenOptions, ScreenOptions } from "../options/ScreenOptions.js";
+import { getNavigationState, hasAppeared, onNavigationStateChange } from "../state/navigationState.js";
+import { ScreenContext } from "../screens/registerScreens.js";
+
+// The ids the native side sends a held back with: the back button of the bar, the system back of Android.
+const BACK_BUTTON = 'ApexNavigation.back';
+const HARDWARE_BACK = 'ApexNavigation.hardwareBackButton';
+
+// What holds every way the user leaves a screen for another screen of the app, as the native side reads it: back
+// pops no more, a swipe down leaves the modal in place; each try comes as an event instead. The first screen of a
+// stack has no back button: held, iOS would draw one.
+function holdOptions(hold, first) {
+  return {
+    ...(!first && {
+      topBar: {
+        backButton: {
+          popStackOnPress: !hold
+        }
+      }
+    }),
+    hardwareBackButton: {
+      popStackOnPress: !hold,
+      dismissModalOnPress: !hold
+    },
+    modal: {
+      swipeToDismiss: !hold
+    }
+  };
+}
+
+/**
+ * While `prevent` is true, keeps the user on this screen: the back button, the swipe back and the history menu (iOS),
+ * the system back (Android), the swipe down of the modal the screen is in and its close button call `onAttempt`
+ * instead, so the screen can ask. The commands of the app are not held: `goBack()` after the user agreed leaves.
+ * Leaving the app is not held either: on the first screen of the root the system back of Android leaves it, as the
+ * home gesture does on iOS; to ask before that, React Native's `BackHandler`.
+ */
+export function usePreventLeave(prevent, onAttempt) {
+  const {
+    id
+  } = useScreen();
+  const latest = useRef(onAttempt);
+  useLayoutEffect(() => {
+    latest.current = onAttempt;
+  });
+  useLayoutEffect(() => {
+    mergeOptions(id, holdOptions(prevent, placeOf(id)?.index === 0));
+    return prevent ? holdLeave(id, () => latest.current()) : undefined;
+  }, [id, prevent]);
+  useScreenEvent('buttonPressed', ({
+    buttonId
+  }) => {
+    if (prevent && (buttonId === BACK_BUTTON || buttonId === HARDWARE_BACK)) latest.current();
+  });
+  useScreenEvent('modalDismissAttempted', () => {
+    if (prevent) latest.current();
+  });
+}
+
+/** The screen the component is in. */
+export function useScreen() {
+  const screen = useContext(ScreenContext);
+  if (!screen) {
+    throw new Error('[navigation] This hook is for the screens of createNavigation, and the component is not in one');
+  }
+  return screen;
+}
+
+/**
+ * An event of the screen the component is in, by its name in `listeners` and `navigation.on`: only this screen's. The
+ * handler can change on every render.
+ *
+ * @example
+ * useScreenEvent('sheetDetentChanged', ({ detent }) => {
+ *   setExpanded(detent === 'large');
+ * });
+ */
+export function useScreenEvent(name, handler) {
+  const {
+    id
+  } = useScreen();
+  const latest = useRef(handler);
+  useLayoutEffect(() => {
+    latest.current = handler;
+  });
+  useEffect(() => onNavigationEvent(name, event => {
+    // The accessory's event names its component, which is this screen when the accessory renders the hook.
+    const about = event;
+    if ((about.screen?.id ?? about.componentId) === id) latest.current(event);
+  }), [name, id]);
+}
+
+/** Each time the screen appears. */
+export function useScreenAppear(handler) {
+  useScreenEvent('screenDidAppear', handler);
+}
+
+/** Each time the screen disappears: something covers it, or it leaves. */
+export function useScreenDisappear(handler) {
+  useScreenEvent('screenDidDisappear', handler);
+}
+
+/**
+ * Whether a shown screen is in the layer the user sees: the state's screen is in its layer (the root, or its modal). An
+ * overlay is over every layer. A sheet over the screen is a layer over it, though the screen doesn't disappear then.
+ */
+function inTopLayer(screenId) {
+  const place = placeOf(screenId);
+  const shown = getNavigationState().screen;
+  const top = shown && placeOf(shown.id);
+  return !place || place.container === 'overlay' || !top || top.layer === place.layer;
+}
+
+/**
+ * Runs the effect each time the screen gets the focus, and its cleanup when it loses it or unmounts: a refresh, a
+ * subscription, a video that plays only while the screen shows. The screen has the focus while it shows and nothing
+ * covers it: a modal or a sheet over it takes the focus away, and its closing gives it back. A component mounted while
+ * its screen has the focus runs it at once; mounted under a sheet, once the sheet goes.
+ */
+export function useFocusEffect(effect) {
+  const {
+    id: componentId
+  } = useScreen();
+  const latest = useRef(effect);
+  useLayoutEffect(() => {
+    latest.current = effect;
+  });
+  useEffect(() => {
+    let appeared = hasAppeared(componentId);
+    let running = false;
+    let cleanup;
+    const update = () => {
+      const focused = appeared && inTopLayer(componentId);
+      if (focused === running) return;
+      running = focused;
+      if (focused) {
+        cleanup = latest.current();
+      } else {
+        cleanup?.();
+        cleanup = undefined;
+      }
+    };
+    const stops = [onNavigationEvent('screenDidAppear', ({
+      screen
+    }) => {
+      if (screen.id !== componentId) return;
+      appeared = true;
+      update();
+    }), onNavigationEvent('screenDidDisappear', ({
+      screen
+    }) => {
+      if (screen.id !== componentId) return;
+      appeared = false;
+      update();
+    }), onNavigationStateChange(update)];
+    update();
+    return () => {
+      stops.forEach(stop => stop());
+      if (running) cleanup?.();
+    };
+  }, [componentId]);
+}
+
+/**
+ * What the user sees: the screen and the selected tab. The component renders again when the selected part changes, so
+ * select only what it needs.
+ */
+
+export function useNavigationState(select) {
+  return useSyncExternalStore(onNavigationStateChange, () => select ? select(getNavigationState()) : getNavigationState());
+}
+
+/** The screen the component is in is the one the user sees. */
+export function useIsFocused() {
+  const {
+    id: componentId
+  } = useScreen();
+  return useNavigationState(state => state.screen?.id === componentId);
+}
+
+/** A press on a button of the screen's top bar or toolbar. */
+export function useNavigationButton(buttonId, handler) {
+  useScreenEvent('buttonPressed', event => {
+    if (event.buttonId === buttonId) handler(event);
+  });
+}
+
+/** The search bar of the screen. */
+export function useSearchBar(handlers) {
+  useScreenEvent('searchChanged', event => handlers.onChange?.(event));
+  useScreenEvent('searchSubmitted', event => handlers.onSubmit?.(event));
+  useScreenEvent('searchCancelled', event => handlers.onCancel?.(event));
+  useScreenEvent('searchSuggestionPicked', event => handlers.onSuggestion?.(event.suggestionId));
+}
+
+/**
+ * Options of the screen from its state, such as a title from loaded data or a button that turns on. They are built on
+ * each render and applied before the screen paints when they changed; buttons take `onPress`, and a new handler takes
+ * the press at once.
+ */
+export function useScreenOptions(build) {
+  const {
+    id: componentId
+  } = useScreen();
+  const sent = useRef(undefined);
+  useLayoutEffect(() => {
+    const options = takeButtonHandlers(componentId, readScreenOptions(build(new ScreenOptions())));
+    const key = JSON.stringify(options);
+    if (key === sent.current) return;
+    sent.current = key;
+    mergeOptions(componentId, options);
+  });
+}
+
+/** Listens to an event of the whole navigation while the component is mounted. */
+export function useNavigationEvent(name, handler) {
+  const latest = useRef(handler);
+  useLayoutEffect(() => {
+    latest.current = handler;
+  });
+  useEffect(() => onNavigationEvent(name, event => latest.current(event)), [name]);
+}
+
+/**
+ * Called when the tab of this screen is pressed while the tab shows it; `wasSelected` tells a second press, on which
+ * apps scroll to the top. The handler can change on every render.
+ */
+export function useTabPress(handler) {
+  const {
+    id: componentId
+  } = useScreen();
+  const latest = useRef(handler);
+  useLayoutEffect(() => {
+    latest.current = handler;
+  });
+  useEffect(() => onScreenTabPress(componentId, event => latest.current(event)), [componentId]);
+}
+//# sourceMappingURL=screenHooks.js.map

package/lib/module/api/hooks/screenHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useEffect","useLayoutEffect","useRef","useSyncExternalStore","takeButtonHandlers","mergeOptions","holdLeave","placeOf","onScreenTabPress","onNavigationEvent","readScreenOptions","ScreenOptions","getNavigationState","hasAppeared","onNavigationStateChange","ScreenContext","BACK_BUTTON","HARDWARE_BACK","holdOptions","hold","first","topBar","backButton","popStackOnPress","hardwareBackButton","dismissModalOnPress","modal","swipeToDismiss","usePreventLeave","prevent","onAttempt","id","useScreen","latest","current","index","undefined","useScreenEvent","buttonId","screen","Error","name","handler","event","about","componentId","useScreenAppear","useScreenDisappear","inTopLayer","screenId","place","shown","top","container","layer","useFocusEffect","effect","appeared","running","cleanup","update","focused","stops","forEach","stop","useNavigationState","select","useIsFocused","state","useNavigationButton","useSearchBar","handlers","onChange","onSubmit","onCancel","onSuggestion","suggestionId","useScreenOptions","build","sent","options","key","JSON","stringify","useNavigationEvent","useTabPress"],"sourceRoot":"../../../../src","sources":["api/hooks/screenHooks.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/hooks/useArrangement.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { useCallback, useSyncExternalStore } from 'react';
+import { getArrangementState, subscribeArrangementState } from "../arrangement/arrangementState.js";
+import { useScreen } from "./screenHooks.js";
+
+/**
+ * How this screen's pair (`arrangement` of a screen, or `defineArrangement`) shows now: which view the screen is, how the two lie, whether the
+ * screen is over the other one or out of the window. Null for a screen outside a pair. Changes as the window and the
+ * fold change, as the safe area does.
+ *
+ * @example
+ * // A list under a player: shorter while the player covers it.
+ * const pair = useArrangement();
+ * const collapsed = pair?.layout === 'overlay' && !pair.front;
+ */
+export function useArrangement() {
+  const {
+    id
+  } = useScreen();
+  const subscribe = useCallback(onChange => subscribeArrangementState(id, onChange), [id]);
+  return useSyncExternalStore(subscribe, () => getArrangementState(id));
+}
+//# sourceMappingURL=useArrangement.js.map

package/lib/module/api/hooks/useArrangement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useSyncExternalStore","getArrangementState","subscribeArrangementState","useScreen","useArrangement","id","subscribe","onChange"],"sourceRoot":"../../../../src","sources":["api/hooks/useArrangement.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,oBAAoB,QAAQ,OAAO;AACzD,SAEEC,mBAAmB,EACnBC,yBAAyB,QACpB,oCAAiC;AACxC,SAASC,SAAS,QAAQ,kBAAe;;AAEzC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAA4B;EACxD,MAAM;IAAEC;EAAG,CAAC,GAAGF,SAAS,CAAC,CAAC;EAC1B,MAAMG,SAAS,GAAGP,WAAW,CAC1BQ,QAAoB,IAAKL,yBAAyB,CAACG,EAAE,EAAEE,QAAQ,CAAC,EACjE,CAACF,EAAE,CACL,CAAC;EACD,OAAOL,oBAAoB,CAACM,SAAS,EAAE,MAAML,mBAAmB,CAACI,EAAE,CAAC,CAAC;AACvE","ignoreList":[]}

package/lib/module/api/hooks/useHinge.js

@@ -0,0 +1,29 @@
+"use strict";
+
+import { useEffect, useLayoutEffect, useRef, useSyncExternalStore } from 'react';
+import { getHinge, subscribeHinge } from "../hinge/hinge.js";
+
+/**
+ * The device's hinge: its state and angle. Null on a device without a hinge, and for the moment before the first value
+ * comes. The screen renders again on every change, often while the hinge moves: for an animation driven by the angle,
+ * `useHingeChange`. For the layout of a screen the fold calls for, `defineArrangement` and `useReservedRegions`.
+ */
+export function useHinge() {
+  return useSyncExternalStore(subscribeHinge, getHinge);
+}
+
+/**
+ * Calls `listener` on every change of the hinge, without rendering again: for animations driven by the angle.
+ *
+ * @example
+ * const lid = useRef(new Animated.Value(180)).current;
+ * useHingeChange((hinge) => lid.setValue(hinge?.angle ?? 180));
+ */
+export function useHingeChange(listener) {
+  const latest = useRef(listener);
+  useLayoutEffect(() => {
+    latest.current = listener;
+  });
+  useEffect(() => subscribeHinge(hinge => latest.current(hinge)), []);
+}
+//# sourceMappingURL=useHinge.js.map

package/lib/module/api/hooks/useHinge.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useLayoutEffect","useRef","useSyncExternalStore","getHinge","subscribeHinge","useHinge","useHingeChange","listener","latest","current","hinge"],"sourceRoot":"../../../../src","sources":["api/hooks/useHinge.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,eAAe,EAAEC,MAAM,EAAEC,oBAAoB,QAAQ,OAAO;AAChF,SAASC,QAAQ,EAAcC,cAAc,QAAQ,mBAAgB;;AAErE;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAA,EAAiB;EACvC,OAAOH,oBAAoB,CAACE,cAAc,EAAED,QAAQ,CAAC;AACvD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,cAAcA,CAACC,QAAuC,EAAQ;EAC5E,MAAMC,MAAM,GAAGP,MAAM,CAACM,QAAQ,CAAC;EAC/BP,eAAe,CAAC,MAAM;IACpBQ,MAAM,CAACC,OAAO,GAAGF,QAAQ;EAC3B,CAAC,CAAC;EACFR,SAAS,CAAC,MAAMK,cAAc,CAAEM,KAAK,IAAKF,MAAM,CAACC,OAAO,CAACC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;AACvE","ignoreList":[]}

package/lib/module/api/hooks/useNavigation.js

@@ -0,0 +1,117 @@
+"use strict";
+
+import { useContext, useMemo } from 'react';
+import { setPressEvent } from "../../engine/buttons.js";
+import * as commands from "../commands/commands.js";
+import { command } from "../commands/errors.js";
+import { navigation } from "../navigation.js";
+import { ScreenContext } from "../screens/registerScreens.js";
+import { whenTabShows } from "../state/navigationState.js";
+import { placeOf } from "../../engine/places.js";
+import { centerOf, closeMenu, openMenu } from "../commands/sideMenus.js";
+
+/** The commands that act from the screen, so they take no ids. */
+
+/**
+ * The navigation of a screen: its own commands act from it and take no ids, and the commands of the whole app are
+ * here too (`switchTo`, `dismissAllModals`, `getState`, `on`, the theme and the context), so a screen needs nothing
+ * else.
+ */
+
+/** The navigation of the screen the component is in. */
+export function useNavigation() {
+  const screen = useContext(ScreenContext);
+  if (!screen) {
+    throw new Error('[navigation] useNavigation is for the screens of createNavigation, and this component is not in one');
+  }
+  return useMemo(() => screenNavigation(screen), [screen]);
+}
+
+// The commands of a stack, which a screen makes from where it is.
+
+function stackCommands(id) {
+  return {
+    push: (name, config) => commands.push(id, name, config),
+    pop: () => commands.pop(id),
+    popToRoot: () => commands.popToRoot(id),
+    replace: (name, config) => commands.replace(id, name, config),
+    setStack: (...entries) => commands.setStack(id, entries),
+    showInColumn: (name, config) => commands.showInColumn(id, name, config),
+    // Resolves once the state shows the tab, so the next command acts in it.
+    selectTab: tab => command('selectTab', async () => {
+      const shown = whenTabShows(tab);
+      commands.selectTab(id, tab);
+      await shown;
+    }),
+    setTabBadge: (badge, tab) => command('setTabBadge', async () => commands.setTabBadge(id, badge, tab))
+  };
+}
+
+/** The commands of the center for a menu screen: the menu closes once the center has changed. */
+function fromCenter(center, menuScreen) {
+  const centerCommands = stackCommands(center);
+  const closing = run => async (...args) => {
+    const result = await run(...args);
+    await closeMenu(menuScreen);
+    return result;
+  };
+  return {
+    push: closing(centerCommands.push),
+    pop: closing(centerCommands.pop),
+    popToRoot: closing(centerCommands.popToRoot),
+    replace: closing(centerCommands.replace),
+    setStack: closing(centerCommands.setStack),
+    showInColumn: closing(centerCommands.showInColumn),
+    selectTab: closing(centerCommands.selectTab),
+    setTabBadge: centerCommands.setTabBadge
+  };
+}
+
+/** The navigation of a screen, for code outside React that knows the screen. */
+export function screenNavigation(screen) {
+  const id = screen.id;
+  const own = stackCommands(id);
+  // A screen without a stack of its own acts from elsewhere: an overlay from the screen the user sees (a banner opens a
+  // chat), a menu from the center of its side menu.
+  const stack = () => {
+    const place = placeOf(id);
+    if (place?.container === 'overlay') return navigation;
+    if (place?.menu && place.menu.part !== 'center') {
+      const center = centerOf(place.menu.id);
+      if (center) return fromCenter(center, id);
+    }
+    return own;
+  };
+  return {
+    ...navigation,
+    screen,
+    push: (...args) => stack().push(...args),
+    pop: () => stack().pop(),
+    popTo: screenId => commands.popTo(screenId),
+    popToRoot: () => stack().popToRoot(),
+    replace: (...args) => stack().replace(...args),
+    setStack: (...args) => stack().setStack(...args),
+    showInColumn: (...args) => stack().showInColumn(...args),
+    showModal: (name, config) => commands.showModal(name, config),
+    dismiss: () => commands.dismiss(id),
+    canPop: () => commands.canPop(id),
+    canDismiss: () => commands.canDismiss(id),
+    goBack: () => commands.goBack(id),
+    canGoBack: () => commands.canPop(id) || commands.canDismiss(id),
+    showOverlay: (name, config) => commands.showOverlay(name, config),
+    setOptions: options => commands.setOptions(id, options),
+    showColumn: column => commands.setColumnShown(id, column, true),
+    hideColumn: column => commands.setColumnShown(id, column, false),
+    openMenu: side => openMenu(id, side),
+    closeMenu: () => closeMenu(id),
+    selectTab: tab => stack().selectTab(tab),
+    setTabBadge: (badge, tab) => stack().setTabBadge(badge, tab)
+  };
+}
+
+// A press of a button in the options gets the navigation of its screen.
+setPressEvent(event => ({
+  ...event,
+  navigation: screenNavigation(event.screen)
+}));
+//# sourceMappingURL=useNavigation.js.map

package/lib/module/api/hooks/useNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","useMemo","setPressEvent","commands","command","navigation","ScreenContext","whenTabShows","placeOf","centerOf","closeMenu","openMenu","useNavigation","screen","Error","screenNavigation","stackCommands","id","push","name","config","pop","popToRoot","replace","setStack","entries","showInColumn","selectTab","tab","shown","setTabBadge","badge","fromCenter","center","menuScreen","centerCommands","closing","run","args","result","own","stack","place","container","menu","part","popTo","screenId","showModal","dismiss","canPop","canDismiss","goBack","canGoBack","showOverlay","setOptions","options","showColumn","column","setColumnShown","hideColumn","side","event"],"sourceRoot":"../../../../src","sources":["api/hooks/useNavigation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/hooks/usePendingLink.js

@@ -0,0 +1,12 @@
+"use strict";
+
+import { useSyncExternalStore } from 'react';
+import { getPendingLink, subscribePendingLink } from "../linking/pendingLinks.js";
+/**
+ * The link that waits for `when` of `linking`, or null: the component renders again when one starts waiting and when
+ * it runs or is forgotten. For a screen that offers it after a sign-in.
+ */
+export function usePendingLink() {
+  return useSyncExternalStore(subscribePendingLink, getPendingLink);
+}
+//# sourceMappingURL=usePendingLink.js.map

package/lib/module/api/hooks/usePendingLink.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useSyncExternalStore","getPendingLink","subscribePendingLink","usePendingLink"],"sourceRoot":"../../../../src","sources":["api/hooks/usePendingLink.ts"],"mappings":";;AAAA,SAASA,oBAAoB,QAAQ,OAAO;AAC5C,SAASC,cAAc,EAAEC,oBAAoB,QAAQ,4BAAyB;AAG9E;AACA;AACA;AACA;AACA,OAAO,SAASC,cAAcA,CAAA,EAAuB;EACnD,OAAOH,oBAAoB,CAACE,oBAAoB,EAAED,cAAc,CAAC;AACnE","ignoreList":[]}

package/lib/module/api/hooks/usePreview.js

@@ -0,0 +1,97 @@
+"use strict";
+
+import { useEffect, useLayoutEffect, useRef } from 'react';
+import { Platform } from 'react-native';
+import { dismissPreview } from "../../engine/commands.js";
+import { nextId } from "../../engine/ids.js";
+import { pushPreview } from "../commands/commands.js";
+import { onNavigationEvent } from "../events/navigationEvents.js";
+import { useScreen } from "./screenHooks.js";
+
+/** An item of the menu under a preview; with `actions`, a submenu. */
+
+/** What a view previews: the screen with its props, and the menu under it. */
+
+/**
+ * (iOS) A long press on the view with `nativeID` in this screen (a right click with a pointer on iPad) shows `screen`
+ * small, with `actions` as a menu under it; a tap on the preview pushes the screen. UIKit's context menu. The preview
+ * goes when the component unmounts. Elsewhere the view has no preview.
+ */
+export function usePreview(nativeID, config) {
+  const {
+    id: screenId
+  } = useScreen();
+  const {
+    screen,
+    props,
+    actions = [],
+    width,
+    height
+  } = config;
+  const latest = useRef(actions);
+  useLayoutEffect(() => {
+    latest.current = actions;
+  });
+  // A new preview when what it shows changes; the handlers of the menu are read when it is pressed.
+  const shown = JSON.stringify([screen, props ?? null, menuOf(actions), width, height]);
+  useEffect(() => {
+    if (Platform.OS !== 'ios') return undefined;
+    const [name, previewProps, menu, previewWidth, previewHeight] = JSON.parse(shown);
+    let active = true;
+    let current;
+    const stop = onNavigationEvent('buttonPressed', event => {
+      if (event.screen?.id === current) findAction(latest.current, event.buttonId)?.onPress?.();
+    });
+    // A preview stands for one push: once a tap opened the screen, the view previews it again. The push ends with an
+    // error when the preview goes, which is not one here.
+    const arm = () => {
+      const previewId = nextId('Preview');
+      current = previewId;
+      pushPreview(screenId, name, previewProps ?? undefined, {
+        nativeID,
+        commit: true,
+        actions: menu,
+        width: previewWidth,
+        height: previewHeight
+      }, previewId, () => active).then(() => {
+        if (active) arm();
+      }, () => {});
+    };
+    arm();
+    // The preview goes with the component, or when what it shows changes: otherwise it and its screen stay until the
+    // screen it is in closes. One a tap has just pushed stays, the native side tells them apart.
+    return () => {
+      active = false;
+      stop();
+      if (current) dismissPreview(current);
+    };
+  }, [screenId, nativeID, shown]);
+}
+
+// The menu as the native side takes it: the titles and the ids, without the handlers.
+function menuOf(actions) {
+  return actions.map(({
+    id,
+    title,
+    style,
+    actions: submenu
+  }) => ({
+    id,
+    title,
+    ...(style && {
+      style
+    }),
+    ...(submenu && {
+      actions: menuOf(submenu)
+    })
+  }));
+}
+function findAction(actions, id) {
+  for (const action of actions) {
+    if (action.id === id) return action;
+    const inner = action.actions && findAction(action.actions, id);
+    if (inner) return inner;
+  }
+  return undefined;
+}
+//# sourceMappingURL=usePreview.js.map

package/lib/module/api/hooks/usePreview.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useLayoutEffect","useRef","Platform","dismissPreview","nextId","pushPreview","onNavigationEvent","useScreen","usePreview","nativeID","config","id","screenId","screen","props","actions","width","height","latest","current","shown","JSON","stringify","menuOf","OS","undefined","name","previewProps","menu","previewWidth","previewHeight","parse","active","stop","event","findAction","buttonId","onPress","arm","previewId","commit","then","map","title","style","submenu","action","inner"],"sourceRoot":"../../../../src","sources":["api/hooks/usePreview.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/hooks/useReservedRegions.js

@@ -0,0 +1,24 @@
+"use strict";
+
+import { useCallback, useSyncExternalStore } from 'react';
+import { getScreenRegions, subscribeScreenRegions } from "../safeArea/screenRegions.js";
+import { useScreen } from "./screenHooks.js";
+
+/**
+ * The parts of this screen the hardware takes, in the screen's coordinates: `division`, the fold of a partly folded
+ * device, and `occlusion`, a camera or a hinge over the screen. Only what is active now: the fold of a device opened
+ * flat is not there. Empty where the platform has none (before iOS 27.1, a device without a fold). Changes as the
+ * device folds, as the safe area does.
+ *
+ * @example
+ * const { division } = useReservedRegions();
+ * const fold = division[0]; // keep the buttons on one side of it
+ */
+export function useReservedRegions() {
+  const {
+    id
+  } = useScreen();
+  const subscribe = useCallback(onChange => subscribeScreenRegions(id, onChange), [id]);
+  return useSyncExternalStore(subscribe, () => getScreenRegions(id));
+}
+//# sourceMappingURL=useReservedRegions.js.map

package/lib/module/api/hooks/useReservedRegions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useSyncExternalStore","getScreenRegions","subscribeScreenRegions","useScreen","useReservedRegions","id","subscribe","onChange"],"sourceRoot":"../../../../src","sources":["api/hooks/useReservedRegions.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,oBAAoB,QAAQ,OAAO;AACzD,SACEC,gBAAgB,EAEhBC,sBAAsB,QACjB,8BAA2B;AAClC,SAASC,SAAS,QAAQ,kBAAe;;AAEzC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,kBAAkBA,CAAA,EAAoB;EACpD,MAAM;IAAEC;EAAG,CAAC,GAAGF,SAAS,CAAC,CAAC;EAC1B,MAAMG,SAAS,GAAGP,WAAW,CAC1BQ,QAAoB,IAAKL,sBAAsB,CAACG,EAAE,EAAEE,QAAQ,CAAC,EAC9D,CAACF,EAAE,CACL,CAAC;EACD,OAAOL,oBAAoB,CAACM,SAAS,EAAE,MAAML,gBAAgB,CAACI,EAAE,CAAC,CAAC;AACpE","ignoreList":[]}