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

package/lib/module/api/commands/sideMenus.js

@@ -0,0 +1,134 @@
+"use strict";
+
+import * as engine from "../../engine/commands.js";
+import { placeOf } from "../../engine/places.js";
+import { onNavigationEvent } from "../events/navigationEvents.js";
+import { getNavigationState, onNavigationStateChange } from "../state/navigationState.js";
+import { command } from "./errors.js";
+// A menu that doesn't tell it moved (a menu screen that never appears) still settles the command after this.
+const MOVE_TIMEOUT = 1000;
+
+// The screen of the center the user saw last, by side menu: the commands of a menu screen act from it. And the side
+// that is open, by side menu, as its screens appear and disappear (the state comes a moment after them).
+const centers = new Map();
+const open = new Map();
+let watching = false;
+
+/** Keeps the center the user saw last and the open menu of each side menu; the app starts it with its state. */
+export function watchSideMenus() {
+  if (watching) return;
+  watching = true;
+  onNavigationStateChange(({
+    screen
+  }) => {
+    const menu = screen && placeOf(screen.id)?.menu;
+    if (screen && menu?.part === 'center') centers.set(menu.id, screen.id);
+  });
+  onNavigationEvent('screenDidAppear', ({
+    screen
+  }) => {
+    const menu = placeOf(screen.id)?.menu;
+    if (menu && menu.part !== 'center') open.set(menu.id, menu.part);
+  });
+  onNavigationEvent('screenDidDisappear', ({
+    screen
+  }) => {
+    const menu = placeOf(screen.id)?.menu;
+    if (menu && menu.part !== 'center' && open.get(menu.id) === menu.part) open.delete(menu.id);
+  });
+}
+
+/** The screen of the center a menu screen acts from, when the menu has one. */
+export function centerOf(menuId) {
+  return centers.get(menuId);
+}
+function menuOf(name, screenId) {
+  const place = placeOf(screenId);
+  if (!place?.menu) {
+    throw new Error(`[navigation] ${name}: ${place?.name ?? screenId} is not in a side menu`);
+  }
+  return place.menu;
+}
+
+/** The side of the side menu that is open. */
+function openSide(menuId) {
+  return open.get(menuId);
+}
+
+/** The part of the side menu the state shows; none while its screen is elsewhere, such as in a modal over it. */
+function partInState(menuId) {
+  const screen = getNavigationState().screen;
+  const menu = screen && placeOf(screen.id)?.menu;
+  return menu?.id === menuId ? menu.part : undefined;
+}
+
+/**
+ * Resolves once a screen of the side of the menu appears or disappears and the state shows it, at the latest after a
+ * while. The native side sends the state a moment after the screen events, and a command right after the move acts
+ * from the screen the state shows: the center after `closeMenu`, not the menu that has closed.
+ */
+function whenMenuMoved(event, menuId, side) {
+  // A state that shows a screen outside the side menu won't show the move: the command settles with the event.
+  const shows = event === 'screenDidAppear' ? part => part === undefined || part === side : part => part !== side;
+  return new Promise(resolve => {
+    let moved = false;
+    const done = () => {
+      clearTimeout(timer);
+      stopEvent();
+      stopState();
+      resolve();
+    };
+    const settle = () => {
+      if (moved && shows(partInState(menuId))) done();
+    };
+    const timer = setTimeout(done, MOVE_TIMEOUT);
+    const stopEvent = onNavigationEvent(event, ({
+      screen
+    }) => {
+      const menu = placeOf(screen.id)?.menu;
+      if (menu?.id !== menuId || menu.part !== side) return;
+      moved = true;
+      settle();
+    });
+    const stopState = onNavigationStateChange(settle);
+  });
+}
+
+/** Opens a menu of the side menu the screen is in; resolves once it is open and the state shows its screen. */
+export function openMenu(screenId, side) {
+  return command('openMenu', () => {
+    const menu = menuOf('openMenu', screenId);
+    if (openSide(menu.id) === side) return Promise.resolve();
+    const moved = whenMenuMoved('screenDidAppear', menu.id, side);
+    engine.mergeOptions(screenId, {
+      sideMenu: {
+        [side]: {
+          visible: true
+        }
+      }
+    });
+    return moved;
+  });
+}
+
+/**
+ * Closes the menu that is open in the side menu the screen is in; resolves once it is closed and the state shows the
+ * screen under it.
+ */
+export function closeMenu(screenId) {
+  return command('closeMenu', () => {
+    const menu = menuOf('closeMenu', screenId);
+    const side = openSide(menu.id);
+    if (!side) return Promise.resolve();
+    const moved = whenMenuMoved('screenDidDisappear', menu.id, side);
+    engine.mergeOptions(screenId, {
+      sideMenu: {
+        [side]: {
+          visible: false
+        }
+      }
+    });
+    return moved;
+  });
+}
+//# sourceMappingURL=sideMenus.js.map

package/lib/module/api/commands/sideMenus.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["engine","placeOf","onNavigationEvent","getNavigationState","onNavigationStateChange","command","MOVE_TIMEOUT","centers","Map","open","watching","watchSideMenus","screen","menu","id","part","set","get","delete","centerOf","menuId","menuOf","name","screenId","place","Error","openSide","partInState","undefined","whenMenuMoved","event","side","shows","Promise","resolve","moved","done","clearTimeout","timer","stopEvent","stopState","settle","setTimeout","openMenu","mergeOptions","sideMenu","visible","closeMenu"],"sourceRoot":"../../../../src","sources":["api/commands/sideMenus.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/commands/transitions.js

@@ -0,0 +1,245 @@
+"use strict";
+
+import { Dimensions, I18nManager } from 'react-native';
+
+/** A ready transition: how a screen comes, and the same in reverse when it goes. */
+
+/**
+ * How a screen comes and goes; the way back is the same in reverse. A preset, a preset with its duration, the zoom of
+ * iOS 18 out of the view with a `nativeID`, or views that move from this screen into the new one (`nativeID` pairs,
+ * with a fade of the rest unless `type` says otherwise).
+ */
+
+const DURATION = 300;
+function parts(transition) {
+  if (typeof transition === 'string') return {
+    preset: transition,
+    duration: DURATION
+  };
+  if ('zoom' in transition) return {
+    preset: 'platform',
+    duration: DURATION,
+    zoom: transition.zoom
+  };
+  if ('shared' in transition) {
+    return {
+      preset: transition.type ?? 'fade',
+      duration: transition.duration ?? DURATION,
+      shared: transition.shared
+    };
+  }
+  return {
+    preset: transition.type,
+    duration: transition.duration ?? DURATION
+  };
+}
+
+/**
+ * The content of a preset as the screen comes (`show`) and as it goes (`hide`); none for `platform` and `none`.
+ * `slideFromEnd` comes from the right, or from the left in a right-to-left layout.
+ */
+export function presetContent(preset, duration = DURATION) {
+  const {
+    width,
+    height
+  } = Dimensions.get('window');
+  const end = I18nManager.isRTL ? -width : width;
+  switch (preset) {
+    case 'fade':
+      return {
+        show: {
+          alpha: {
+            from: 0,
+            to: 1,
+            duration
+          }
+        },
+        hide: {
+          alpha: {
+            from: 1,
+            to: 0,
+            duration
+          }
+        }
+      };
+    case 'slideUp':
+      return {
+        show: {
+          translationY: {
+            from: height,
+            to: 0,
+            duration
+          }
+        },
+        hide: {
+          translationY: {
+            from: 0,
+            to: height,
+            duration
+          }
+        }
+      };
+    case 'slideFromEnd':
+      return {
+        show: {
+          translationX: {
+            from: end,
+            to: 0,
+            duration
+          }
+        },
+        hide: {
+          translationX: {
+            from: 0,
+            to: end,
+            duration
+          }
+        }
+      };
+    case 'scale':
+      return {
+        show: {
+          scaleX: {
+            from: 0.85,
+            to: 1,
+            duration
+          },
+          scaleY: {
+            from: 0.85,
+            to: 1,
+            duration
+          },
+          alpha: {
+            from: 0,
+            to: 1,
+            duration
+          }
+        },
+        hide: {
+          scaleX: {
+            from: 1,
+            to: 0.85,
+            duration
+          },
+          scaleY: {
+            from: 1,
+            to: 0.85,
+            duration
+          },
+          alpha: {
+            from: 1,
+            to: 0,
+            duration
+          }
+        }
+      };
+    default:
+      return undefined;
+  }
+}
+function sharedElements(pairs, duration, back) {
+  if (!pairs?.length) return undefined;
+  return pairs.map(([from, to]) => back ? {
+    fromId: to,
+    toId: from,
+    duration
+  } : {
+    fromId: from,
+    toId: to,
+    duration
+  });
+}
+
+/** The animations of a push and of the pop of the screen it shows. */
+export function pushAnimations(transition) {
+  if (transition === undefined) return undefined;
+  const {
+    preset,
+    duration,
+    zoom,
+    shared
+  } = parts(transition);
+  if (zoom) return {
+    push: {
+      zoom: {
+        fromId: zoom
+      }
+    }
+  };
+  if (preset === 'none') return {
+    push: {
+      enabled: false
+    },
+    pop: {
+      enabled: false
+    }
+  };
+  const content = presetContent(preset, duration);
+  const forth = sharedElements(shared, duration, false);
+  if (!content && !forth) return undefined;
+  return {
+    push: defined({
+      content: content && {
+        enter: content.show
+      },
+      sharedElementTransitions: forth
+    }),
+    pop: defined({
+      content: content && {
+        exit: content.hide
+      },
+      sharedElementTransitions: sharedElements(shared, duration, true)
+    })
+  };
+}
+
+/** The animations of a modal as it shows and as it is dismissed. */
+export function modalAnimations(transition) {
+  if (transition === undefined) return undefined;
+  const {
+    preset,
+    duration,
+    zoom,
+    shared
+  } = parts(transition);
+  if (zoom) return {
+    showModal: {
+      zoom: {
+        fromId: zoom
+      }
+    }
+  };
+  if (preset === 'none') {
+    return {
+      showModal: {
+        enter: {
+          enabled: false
+        }
+      },
+      dismissModal: {
+        exit: {
+          enabled: false
+        }
+      }
+    };
+  }
+  const content = presetContent(preset, duration);
+  const forth = sharedElements(shared, duration, false);
+  if (!content && !forth) return undefined;
+  return {
+    showModal: defined({
+      enter: content?.show,
+      sharedElementTransitions: forth
+    }),
+    dismissModal: defined({
+      exit: content?.hide,
+      sharedElementTransitions: sharedElements(shared, duration, true)
+    })
+  };
+}
+
+/** The object without its undefined values, so they don't go to the native side. */
+export function defined(value) {
+  return Object.fromEntries(Object.entries(value).filter(([, item]) => item !== undefined));
+}
+//# sourceMappingURL=transitions.js.map

package/lib/module/api/commands/transitions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Dimensions","I18nManager","DURATION","parts","transition","preset","duration","zoom","type","shared","presetContent","width","height","get","end","isRTL","show","alpha","from","to","hide","translationY","translationX","scaleX","scaleY","undefined","sharedElements","pairs","back","length","map","fromId","toId","pushAnimations","push","enabled","pop","content","forth","defined","enter","sharedElementTransitions","exit","modalAnimations","showModal","dismissModal","value","Object","fromEntries","entries","filter","item"],"sourceRoot":"../../../../src","sources":["api/commands/transitions.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/context/appContext.js

@@ -0,0 +1,22 @@
+"use strict";
+
+// The app's context: one value for every screen, whatever React root it is in. It starts with `context` of
+// createNavigation, and changes with `navigation.setContext` only.
+let value;
+const listeners = new Set();
+export function getAppContext() {
+  return value;
+}
+export function setAppContext(next) {
+  const resolved = typeof next === 'function' ? next(value) : next;
+  if (Object.is(resolved, value)) return;
+  value = resolved;
+  listeners.forEach(listener => listener());
+}
+export function subscribeAppContext(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+//# sourceMappingURL=appContext.js.map

package/lib/module/api/context/appContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["value","listeners","Set","getAppContext","setAppContext","next","resolved","Object","is","forEach","listener","subscribeAppContext","add","delete"],"sourceRoot":"../../../../src","sources":["api/context/appContext.ts"],"mappings":";;AAAA;AACA;AACA,IAAIA,KAAc;AAClB,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;AAEvC,OAAO,SAASC,aAAaA,CAAA,EAAqB;EAChD,OAAOH,KAAK;AACd;AAEA,OAAO,SAASI,aAAaA,CAAUC,IAAgD,EAAE;EACvF,MAAMC,QAAQ,GACZ,OAAOD,IAAI,KAAK,UAAU,GAAIA,IAAI,CAAoCL,KAAgB,CAAC,GAAGK,IAAI;EAChG,IAAIE,MAAM,CAACC,EAAE,CAACF,QAAQ,EAAEN,KAAK,CAAC,EAAE;EAChCA,KAAK,GAAGM,QAAQ;EAChBL,SAAS,CAACQ,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;AAC7C;AAEA,OAAO,SAASC,mBAAmBA,CAACD,QAAoB,EAAc;EACpET,SAAS,CAACW,GAAG,CAACF,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXT,SAAS,CAACY,MAAM,CAACH,QAAQ,CAAC;EAC5B,CAAC;AACH","ignoreList":[]}

package/lib/module/api/events/navigationEvents.js

@@ -0,0 +1,69 @@
+"use strict";
+
+import { toScreenEvent } from "../../engine/events.js";
+import { onNativeEvent } from "../../engine/native.js";
+import { onNavigationStateChange } from "../state/navigationState.js";
+
+/** The events of the navigation by name, with what each one gets; the events of a screen carry it as `screen`. */
+
+// The events by the names of their types, as the app imports them.
+
+// The events of a screen: the native side names it by its id.
+const SCREEN_EVENTS = new Set(['screenWillAppear', 'screenDidAppear', 'screenDidDisappear', 'screenPopped', 'buttonPressed', 'modalDismissed', 'modalDismissAttempted', 'searchChanged', 'searchSubmitted', 'searchCancelled', 'searchSuggestionPicked', 'sheetDetentChanged', 'keyCommandPressed', 'titleRenamed', 'previewCompleted']);
+
+/** Handlers of the events of the navigation, by event name. */
+
+// The native event behind each event of the navigation; `stateChanged` comes from the kept state.
+const NATIVE_EVENTS = {
+  screenWillAppear: 'ComponentWillAppear',
+  screenDidAppear: 'ComponentDidAppear',
+  screenDidDisappear: 'ComponentDidDisappear',
+  screenPopped: 'ScreenPopped',
+  buttonPressed: 'NavigationButtonPressed',
+  tabSelected: 'BottomTabSelected',
+  tabPressed: 'BottomTabPressed',
+  tabLongPressed: 'BottomTabLongPressed',
+  modalDismissed: 'ModalDismissed',
+  modalDismissAttempted: 'ModalAttemptedToDismiss',
+  searchChanged: 'SearchBarUpdated',
+  searchSubmitted: 'SearchBarSubmitted',
+  searchCancelled: 'SearchBarCancelPressed',
+  searchSuggestionPicked: 'SearchSuggestionPicked',
+  sheetDetentChanged: 'SheetDetentChanged',
+  splitViewDisplayModeChanged: 'SplitViewDisplayModeChanged',
+  keyCommandPressed: 'KeyCommandPressed',
+  titleRenamed: 'TitleRenamed',
+  accessoryPlacementChanged: 'BottomAccessoryPlacementChanged',
+  previewCompleted: 'PreviewCompleted'
+};
+
+// The appearance of screens; the native side tells the components of the bars appearing too, with a type of their own.
+const SCREEN_APPEARANCE = new Set(['screenWillAppear', 'screenDidAppear', 'screenDidDisappear']);
+
+/** Listens to an event of the navigation; returns the function that stops listening. */
+export function onNavigationEvent(name, handler) {
+  // From the kept state, so a handler reads the same state as getState().
+  if (name === 'stateChanged') {
+    return onNavigationStateChange(handler);
+  }
+  const deliver = handler;
+  const nativeName = NATIVE_EVENTS[name];
+  if (SCREEN_APPEARANCE.has(name)) {
+    return onNativeEvent(nativeName, event => {
+      if (event.componentType === 'Component') deliver(toScreenEvent(event));
+    });
+  }
+  if (SCREEN_EVENTS.has(name)) {
+    return onNativeEvent(nativeName, event => deliver(toScreenEvent(event)));
+  }
+  return onNativeEvent(nativeName, deliver);
+}
+
+/** Listens to the events of `listeners`, for as long as the app runs. */
+export function addNavigationListeners(listeners) {
+  for (const name of Object.keys(listeners)) {
+    const handler = listeners[name];
+    if (handler) onNavigationEvent(name, handler);
+  }
+}
+//# sourceMappingURL=navigationEvents.js.map

package/lib/module/api/events/navigationEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["toScreenEvent","onNativeEvent","onNavigationStateChange","SCREEN_EVENTS","Set","NATIVE_EVENTS","screenWillAppear","screenDidAppear","screenDidDisappear","screenPopped","buttonPressed","tabSelected","tabPressed","tabLongPressed","modalDismissed","modalDismissAttempted","searchChanged","searchSubmitted","searchCancelled","searchSuggestionPicked","sheetDetentChanged","splitViewDisplayModeChanged","keyCommandPressed","titleRenamed","accessoryPlacementChanged","previewCompleted","SCREEN_APPEARANCE","onNavigationEvent","name","handler","deliver","nativeName","has","event","componentType","addNavigationListeners","listeners","Object","keys"],"sourceRoot":"../../../../src","sources":["api/events/navigationEvents.ts"],"mappings":";;AAAA,SAA6BA,aAAa,QAAQ,wBAAqB;AACvE,SAASC,aAAa,QAAQ,wBAAqB;AAyBnD,SAA+BC,uBAAuB,QAAQ,6BAA0B;;AAExF;;AAuCA;;AAsBA;AACA,MAAMC,aAAa,GAAG,IAAIC,GAAG,CAAsB,CACjD,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,uBAAuB,EACvB,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,kBAAkB,CACnB,CAAC;;AAEF;;AAKA;AACA,MAAMC,aAAiF,GAAG;EACxFC,gBAAgB,EAAE,qBAAqB;EACvCC,eAAe,EAAE,oBAAoB;EACrCC,kBAAkB,EAAE,uBAAuB;EAC3CC,YAAY,EAAE,cAAc;EAC5BC,aAAa,EAAE,yBAAyB;EACxCC,WAAW,EAAE,mBAAmB;EAChCC,UAAU,EAAE,kBAAkB;EAC9BC,cAAc,EAAE,sBAAsB;EACtCC,cAAc,EAAE,gBAAgB;EAChCC,qBAAqB,EAAE,yBAAyB;EAChDC,aAAa,EAAE,kBAAkB;EACjCC,eAAe,EAAE,oBAAoB;EACrCC,eAAe,EAAE,wBAAwB;EACzCC,sBAAsB,EAAE,wBAAwB;EAChDC,kBAAkB,EAAE,oBAAoB;EACxCC,2BAA2B,EAAE,6BAA6B;EAC1DC,iBAAiB,EAAE,mBAAmB;EACtCC,YAAY,EAAE,cAAc;EAC5BC,yBAAyB,EAAE,iCAAiC;EAC5DC,gBAAgB,EAAE;AACpB,CAAC;;AAED;AACA,MAAMC,iBAAiB,GAAG,IAAItB,GAAG,CAAsB,CACrD,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,CACrB,CAAC;;AAEF;AACA,OAAO,SAASuB,iBAAiBA,CAC/BC,IAAU,EACVC,OAAgD,EACpC;EACZ;EACA,IAAID,IAAI,KAAK,cAAc,EAAE;IAC3B,OAAO1B,uBAAuB,CAAC2B,OAA2C,CAAC;EAC7E;EACA,MAAMC,OAAO,GAAGD,OAAmC;EACnD,MAAME,UAAU,GAAG1B,aAAa,CAACuB,IAAI,CAA+B;EACpE,IAAIF,iBAAiB,CAACM,GAAG,CAACJ,IAAI,CAAC,EAAE;IAC/B,OAAO3B,aAAa,CAAiD8B,UAAU,EAAGE,KAAK,IAAK;MAC1F,IAAIA,KAAK,CAACC,aAAa,KAAK,WAAW,EAAEJ,OAAO,CAAC9B,aAAa,CAACiC,KAAK,CAAC,CAAC;IACxE,CAAC,CAAC;EACJ;EACA,IAAI9B,aAAa,CAAC6B,GAAG,CAACJ,IAAI,CAAC,EAAE;IAC3B,OAAO3B,aAAa,CAA0B8B,UAAU,EAAGE,KAAK,IAC9DH,OAAO,CAAC9B,aAAa,CAACiC,KAAK,CAAC,CAC9B,CAAC;EACH;EACA,OAAOhC,aAAa,CAAC8B,UAAU,EAAED,OAAO,CAAC;AAC3C;;AAEA;AACA,OAAO,SAASK,sBAAsBA,CAACC,SAA8B,EAAE;EACrE,KAAK,MAAMR,IAAI,IAAIS,MAAM,CAACC,IAAI,CAACF,SAAS,CAAC,EAA2B;IAClE,MAAMP,OAAO,GAAGO,SAAS,CAACR,IAAI,CAAC;IAC/B,IAAIC,OAAO,EAAEF,iBAAiB,CAACC,IAAI,EAAEC,OAAyD,CAAC;EACjG;AACF","ignoreList":[]}

package/lib/module/api/events/screenLifecycle.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { forgetArrangementState } from "../arrangement/arrangementState.js";
+import { forgetScreenInsets } from "../safeArea/screenInsets.js";
+import { forgetScreenRegions } from "../safeArea/screenRegions.js";
+import { forgetAppeared } from "../state/navigationState.js";
+import { clearButtonHandlers } from "../../engine/buttons.js";
+import { forgetTabsScreen } from "../../engine/tabs.js";
+
+// What runs when a screen of `screens` unmounts, by screen id.
+const unmountHandlers = new Map();
+
+/** Runs the handler once the screen unmounts: its native screen is gone. */
+export function whenScreenUnmounts(screenId, handler) {
+  unmountHandlers.set(screenId, [...(unmountHandlers.get(screenId) ?? []), handler]);
+}
+
+/** A screen of `screens` unmounted. */
+export function screenUnmounted(screenId) {
+  clearButtonHandlers(screenId);
+  forgetTabsScreen(screenId);
+  forgetScreenInsets(screenId);
+  forgetScreenRegions(screenId);
+  forgetArrangementState(screenId);
+  forgetAppeared(screenId);
+  const handlers = unmountHandlers.get(screenId);
+  unmountHandlers.delete(screenId);
+  handlers?.forEach(handler => handler());
+}
+//# sourceMappingURL=screenLifecycle.js.map

package/lib/module/api/events/screenLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["forgetArrangementState","forgetScreenInsets","forgetScreenRegions","forgetAppeared","clearButtonHandlers","forgetTabsScreen","unmountHandlers","Map","whenScreenUnmounts","screenId","handler","set","get","screenUnmounted","handlers","delete","forEach"],"sourceRoot":"../../../../src","sources":["api/events/screenLifecycle.ts"],"mappings":";;AAAA,SAASA,sBAAsB,QAAQ,oCAAiC;AACxE,SAASC,kBAAkB,QAAQ,6BAA0B;AAC7D,SAASC,mBAAmB,QAAQ,8BAA2B;AAC/D,SAASC,cAAc,QAAQ,6BAA0B;AACzD,SAASC,mBAAmB,QAAQ,yBAAsB;AAC1D,SAASC,gBAAgB,QAAQ,sBAAmB;;AAEpD;AACA,MAAMC,eAAe,GAAG,IAAIC,GAAG,CAAyB,CAAC;;AAEzD;AACA,OAAO,SAASC,kBAAkBA,CAACC,QAAgB,EAAEC,OAAmB,EAAE;EACxEJ,eAAe,CAACK,GAAG,CAACF,QAAQ,EAAE,CAAC,IAAIH,eAAe,CAACM,GAAG,CAACH,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAEC,OAAO,CAAC,CAAC;AACpF;;AAEA;AACA,OAAO,SAASG,eAAeA,CAACJ,QAAgB,EAAE;EAChDL,mBAAmB,CAACK,QAAQ,CAAC;EAC7BJ,gBAAgB,CAACI,QAAQ,CAAC;EAC1BR,kBAAkB,CAACQ,QAAQ,CAAC;EAC5BP,mBAAmB,CAACO,QAAQ,CAAC;EAC7BT,sBAAsB,CAACS,QAAQ,CAAC;EAChCN,cAAc,CAACM,QAAQ,CAAC;EACxB,MAAMK,QAAQ,GAAGR,eAAe,CAACM,GAAG,CAACH,QAAQ,CAAC;EAC9CH,eAAe,CAACS,MAAM,CAACN,QAAQ,CAAC;EAChCK,QAAQ,EAAEE,OAAO,CAAEN,OAAO,IAAKA,OAAO,CAAC,CAAC,CAAC;AAC3C","ignoreList":[]}

package/lib/module/api/events/tabPresses.js

@@ -0,0 +1,32 @@
+"use strict";
+
+import { onNativeEvent } from "../../engine/native.js";
+// The handlers of `useTabPress`, by the id of their screen. Those of `Tab().onPress()` go with the tabs to the engine.
+const screenHandlers = new Map();
+let listening = false;
+
+/** Calls the handler when the tab of the screen is pressed while it shows the screen; returns the function to stop. */
+export function onScreenTabPress(screenId, handler) {
+  listen();
+  const handlers = screenHandlers.get(screenId) ?? new Set();
+  handlers.add(handler);
+  screenHandlers.set(screenId, handlers);
+  return () => {
+    handlers.delete(handler);
+    if (handlers.size === 0) screenHandlers.delete(screenId);
+  };
+}
+function listen() {
+  if (listening) return;
+  listening = true;
+  onNativeEvent('BottomTabPressed', event => {
+    if (!event.screenId) return;
+    const press = {
+      index: event.tabIndex,
+      wasSelected: event.wasSelected,
+      screenId: event.screenId
+    };
+    screenHandlers.get(event.screenId)?.forEach(handler => handler(press));
+  });
+}
+//# sourceMappingURL=tabPresses.js.map

package/lib/module/api/events/tabPresses.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["onNativeEvent","screenHandlers","Map","listening","onScreenTabPress","screenId","handler","listen","handlers","get","Set","add","set","delete","size","event","press","index","tabIndex","wasSelected","forEach"],"sourceRoot":"../../../../src","sources":["api/events/tabPresses.ts"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,wBAAqB;AAMnD;AACA,MAAMC,cAAc,GAAG,IAAIC,GAAG,CAA+B,CAAC;AAC9D,IAAIC,SAAS,GAAG,KAAK;;AAErB;AACA,OAAO,SAASC,gBAAgBA,CAACC,QAAgB,EAAEC,OAAwB,EAAc;EACvFC,MAAM,CAAC,CAAC;EACR,MAAMC,QAAQ,GAAGP,cAAc,CAACQ,GAAG,CAACJ,QAAQ,CAAC,IAAI,IAAIK,GAAG,CAAkB,CAAC;EAC3EF,QAAQ,CAACG,GAAG,CAACL,OAAO,CAAC;EACrBL,cAAc,CAACW,GAAG,CAACP,QAAQ,EAAEG,QAAQ,CAAC;EACtC,OAAO,MAAM;IACXA,QAAQ,CAACK,MAAM,CAACP,OAAO,CAAC;IACxB,IAAIE,QAAQ,CAACM,IAAI,KAAK,CAAC,EAAEb,cAAc,CAACY,MAAM,CAACR,QAAQ,CAAC;EAC1D,CAAC;AACH;AAEA,SAASE,MAAMA,CAAA,EAAG;EAChB,IAAIJ,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBH,aAAa,CAAwB,kBAAkB,EAAGe,KAAK,IAAK;IAClE,IAAI,CAACA,KAAK,CAACV,QAAQ,EAAE;IACrB,MAAMW,KAAoB,GAAG;MAC3BC,KAAK,EAAEF,KAAK,CAACG,QAAQ;MACrBC,WAAW,EAAEJ,KAAK,CAACI,WAAW;MAC9Bd,QAAQ,EAAEU,KAAK,CAACV;IAClB,CAAC;IACDJ,cAAc,CAACQ,GAAG,CAACM,KAAK,CAACV,QAAQ,CAAC,EAAEe,OAAO,CAAEd,OAAO,IAAKA,OAAO,CAACU,KAAK,CAAC,CAAC;EAC1E,CAAC,CAAC;AACJ","ignoreList":[]}

package/lib/module/api/hinge/hinge.js

@@ -0,0 +1,73 @@
+"use strict";
+
+import ANNTurboModule from "../../adapters/NativeANNTurboModule.js";
+import { onNativeEvent } from "../../engine/native.js";
+
+/** The device's hinge. */
+
+let current = null;
+let known = false;
+const listeners = new Set();
+let stopEvents;
+
+/** The last hinge value; null without a hinge and before the native side sent the first one. */
+export function getHinge() {
+  if (!known) {
+    const read = readNative();
+    if (read !== undefined) {
+      current = read;
+      known = true;
+    }
+  }
+  return current;
+}
+
+/**
+ * Calls `listener` on every change of the hinge; returns the function that stops it. The native side watches the hinge
+ * only while something listens: a hinge sensor on Android costs power.
+ */
+export function subscribeHinge(listener) {
+  listeners.add(listener);
+  if (listeners.size === 1) start();
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0) stop();
+  };
+}
+function start() {
+  stopEvents = onNativeEvent('HingeChanged', event => {
+    const next = toHinge(event);
+    if (known && sameHinge(current, next)) return;
+    current = next;
+    known = true;
+    listeners.forEach(listener => listener(next));
+  });
+  ANNTurboModule?.setHingeUpdates?.(true);
+}
+function stop() {
+  ANNTurboModule?.setHingeUpdates?.(false);
+  stopEvents?.();
+  stopEvents = undefined;
+  // Not watched any more: the next listener starts from what the native side says then.
+  known = false;
+  current = null;
+}
+
+// Undefined: the native side knows nothing yet (no update since it started watching).
+function readNative() {
+  // No native module in tests with the mock.
+  const read = ANNTurboModule?.getHinge?.();
+  if (!read || typeof read.state !== 'string') return undefined;
+  return toHinge(read);
+}
+function toHinge(event) {
+  if (typeof event.state !== 'string') return null;
+  return {
+    state: event.state,
+    angle: typeof event.angle === 'number' ? event.angle : null
+  };
+}
+function sameHinge(a, b) {
+  return a === b || a !== null && b !== null && a.state === b.state && a.angle === b.angle;
+}
+//# sourceMappingURL=hinge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ANNTurboModule","onNativeEvent","current","known","listeners","Set","stopEvents","getHinge","read","readNative","undefined","subscribeHinge","listener","add","size","start","delete","stop","event","next","toHinge","sameHinge","forEach","setHingeUpdates","state","angle","a","b"],"sourceRoot":"../../../../src","sources":["api/hinge/hinge.ts"],"mappings":";;AAAA,OAAOA,cAAc,MAAM,wCAAqC;AAChE,SAASC,aAAa,QAAQ,wBAAqB;;AAGnD;;AAcA,IAAIC,OAAqB,GAAG,IAAI;AAChC,IAAIC,KAAK,GAAG,KAAK;AACjB,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAgC,CAAC;AAC1D,IAAIC,UAAoC;;AAExC;AACA,OAAO,SAASC,QAAQA,CAAA,EAAiB;EACvC,IAAI,CAACJ,KAAK,EAAE;IACV,MAAMK,IAAI,GAAGC,UAAU,CAAC,CAAC;IACzB,IAAID,IAAI,KAAKE,SAAS,EAAE;MACtBR,OAAO,GAAGM,IAAI;MACdL,KAAK,GAAG,IAAI;IACd;EACF;EACA,OAAOD,OAAO;AAChB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,cAAcA,CAACC,QAAuC,EAAc;EAClFR,SAAS,CAACS,GAAG,CAACD,QAAQ,CAAC;EACvB,IAAIR,SAAS,CAACU,IAAI,KAAK,CAAC,EAAEC,KAAK,CAAC,CAAC;EACjC,OAAO,MAAM;IACXX,SAAS,CAACY,MAAM,CAACJ,QAAQ,CAAC;IAC1B,IAAIR,SAAS,CAACU,IAAI,KAAK,CAAC,EAAEG,IAAI,CAAC,CAAC;EAClC,CAAC;AACH;AAEA,SAASF,KAAKA,CAAA,EAAG;EACfT,UAAU,GAAGL,aAAa,CAAoB,cAAc,EAAGiB,KAAK,IAAK;IACvE,MAAMC,IAAI,GAAGC,OAAO,CAACF,KAAK,CAAC;IAC3B,IAAIf,KAAK,IAAIkB,SAAS,CAACnB,OAAO,EAAEiB,IAAI,CAAC,EAAE;IACvCjB,OAAO,GAAGiB,IAAI;IACdhB,KAAK,GAAG,IAAI;IACZC,SAAS,CAACkB,OAAO,CAAEV,QAAQ,IAAKA,QAAQ,CAACO,IAAI,CAAC,CAAC;EACjD,CAAC,CAAC;EACFnB,cAAc,EAAEuB,eAAe,GAAG,IAAI,CAAC;AACzC;AAEA,SAASN,IAAIA,CAAA,EAAG;EACdjB,cAAc,EAAEuB,eAAe,GAAG,KAAK,CAAC;EACxCjB,UAAU,GAAG,CAAC;EACdA,UAAU,GAAGI,SAAS;EACtB;EACAP,KAAK,GAAG,KAAK;EACbD,OAAO,GAAG,IAAI;AAChB;;AAEA;AACA,SAASO,UAAUA,CAAA,EAA6B;EAC9C;EACA,MAAMD,IAAI,GAAGR,cAAc,EAAEO,QAAQ,GAAG,CAA2C;EACnF,IAAI,CAACC,IAAI,IAAI,OAAOA,IAAI,CAACgB,KAAK,KAAK,QAAQ,EAAE,OAAOd,SAAS;EAC7D,OAAOU,OAAO,CAACZ,IAAI,CAAC;AACtB;AAEA,SAASY,OAAOA,CAACF,KAAiC,EAAgB;EAChE,IAAI,OAAOA,KAAK,CAACM,KAAK,KAAK,QAAQ,EAAE,OAAO,IAAI;EAChD,OAAO;IAAEA,KAAK,EAAEN,KAAK,CAACM,KAAK;IAAEC,KAAK,EAAE,OAAOP,KAAK,CAACO,KAAK,KAAK,QAAQ,GAAGP,KAAK,CAACO,KAAK,GAAG;EAAK,CAAC;AAC5F;AAEA,SAASJ,SAASA,CAACK,CAAe,EAAEC,CAAe,EAAW;EAC5D,OAAOD,CAAC,KAAKC,CAAC,IAAKD,CAAC,KAAK,IAAI,IAAIC,CAAC,KAAK,IAAI,IAAID,CAAC,CAACF,KAAK,KAAKG,CAAC,CAACH,KAAK,IAAIE,CAAC,CAACD,KAAK,KAAKE,CAAC,CAACF,KAAM;AAC5F","ignoreList":[]}