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

package/lib/module/api/options/ScreenOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["OptionsChain","ScreenOptions","withOptions","options","read","built","title","topBar","text","subtitle","leftButtons","rightButtons","centerButtons","searchBar","toolbar","fab","keyCommands","readScreenOptions"],"sourceRoot":"../../../../src","sources":["api/options/ScreenOptions.ts"],"mappings":";;AAWA,SAASA,YAAY,QAAQ,mBAAgB;;AAE7C;;AAKA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,SAASD,YAAY,CAAC;EACpCE,WAAWA,CAACC,OAAgB,EAAQ;IAC5C,OAAO,IAAIF,aAAa,CAACE,OAAO,CAAC;EACnC;;EAEA;EACA,OAAOC,IAAIA,CAACD,OAAsB,EAAW;IAC3C,OAAOA,OAAO,CAACE,KAAK;EACtB;EAEAC,KAAKA,CAACA,KAAkC,EAAQ;IAC9C,OAAO,IAAI,CAACC,MAAM,CAAC;MACjBD,KAAK,EAAE,OAAOA,KAAK,KAAK,QAAQ,GAAG;QAAEE,IAAI,EAAEF;MAAM,CAAC,GAAGA;IACvD,CAAC,CAAC;EACJ;EAEAG,QAAQA,CAACA,QAAwC,EAAQ;IACvD,OAAO,IAAI,CAACF,MAAM,CAAC;MACjBE,QAAQ,EAAE,OAAOA,QAAQ,KAAK,QAAQ,GAAG;QAAED,IAAI,EAAEC;MAAS,CAAC,GAAGA;IAChE,CAAC,CAAC;EACJ;;EAEA;EACAC,WAAWA,CAAC,GAAGA,WAA+B,EAAQ;IACpD,OAAO,IAAI,CAACH,MAAM,CAAC;MAAEG;IAAY,CAAC,CAAC;EACrC;;EAEA;EACAC,YAAYA,CAAC,GAAGA,YAAgC,EAAQ;IACtD,OAAO,IAAI,CAACJ,MAAM,CAAC;MAAEI;IAAa,CAAC,CAAC;EACtC;;EAEA;EACAC,aAAaA,CAAC,GAAGA,aAAiC,EAAQ;IACxD,OAAO,IAAI,CAACL,MAAM,CAAC;MAAEK;IAAc,CAAC,CAAC;EACvC;EAEAC,SAASA,CAACA,SAA2B,EAAQ;IAC3C,OAAO,IAAI,CAACN,MAAM,CAAC;MAAEM;IAAU,CAAC,CAAC;EACnC;;EAEA;EACAC,OAAOA,CAACA,OAAuB,EAAQ;IACrC,OAAO,IAAI,CAACX,OAAO,CAAC;MAAEW;IAAQ,CAAC,CAAC;EAClC;;EAEA;EACAC,GAAGA,CAACA,GAAkB,EAAQ;IAC5B,OAAO,IAAI,CAACZ,OAAO,CAAC;MAAEY,GAAG,EAAEA;IAAsB,CAAC,CAAC;EACrD;EAEAC,WAAWA,CAAC,GAAGA,WAAgC,EAAQ;IACrD,OAAO,IAAI,CAACb,OAAO,CAAC;MAAEa;IAAY,CAAC,CAAC;EACtC;AACF;AAEA,OAAO,SAASC,iBAAiBA,CAACd,OAAsB,EAAW;EACjE,OAAOF,aAAa,CAACG,IAAI,CAACD,OAAO,CAAC;AACpC","ignoreList":[]}

package/lib/module/api/options/buttons.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=buttons.js.map

package/lib/module/api/options/buttons.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../src","sources":["api/options/buttons.ts"],"mappings":"","ignoreList":[]}

package/lib/module/api/safeArea/ANNSafeAreaViewNativeComponent.ts

@@ -0,0 +1,28 @@
+import {
+  codegenNativeComponent,
+  type CodegenTypes,
+  type HostComponent,
+  type ViewProps,
+} from 'react-native';
+
+export interface NativeProps extends ViewProps {
+  /** The screen whose safe area the view keeps its content out of. */
+  screenId: string;
+  /** Once: the view is laid out in its place, with a size. */
+  onReady?: CodegenTypes.DirectEventHandler<null>;
+  /**
+   * The screen is rendered into the view, also when it renders nothing (`null`): what a transition into the screen
+   * waits for.
+   */
+  contentRendered?: CodegenTypes.WithDefault<boolean, false>;
+  /**
+   * `[top, right, bottom, left]`: the padding of a screen laid out before its push (Android), so the first layout
+   * already has it. Empty: the native side gives it once the screen is laid out.
+   */
+  initialPadding?: ReadonlyArray<CodegenTypes.Float>;
+}
+
+// The C++ of the component is the library's own: its state holds the padding the native side gives it.
+export default codegenNativeComponent<NativeProps>('ANNSafeAreaView', {
+  interfaceOnly: true,
+}) as HostComponent<NativeProps>;

package/lib/module/api/safeArea/screenInsets.js

@@ -0,0 +1,86 @@
+"use strict";
+
+import ANNTurboModule from "../../adapters/NativeANNTurboModule.js";
+import { onNativeEvent } from "../../engine/native.js";
+
+/**
+ * How much of a screen's content the bars and the system cover on each side, past the screen's own padding: points on
+ * iOS, dp on Android.
+ */
+
+const NONE = Object.freeze({
+  top: 0,
+  right: 0,
+  bottom: 0,
+  left: 0
+});
+
+// The insets of the screens read so far, by screen id, until the screen unmounts.
+const insetsById = new Map();
+const listeners = new Map();
+let listening = false;
+
+/**
+ * The insets of a screen: the last ones the native side sent, or read from it at once, so a screen's first render
+ * has them when the screen is laid out; none before that.
+ */
+export function getScreenInsets(screenId) {
+  listen();
+  const known = insetsById.get(screenId);
+  if (known) return known;
+  const read = readNative(screenId);
+  if (!read) return NONE;
+  insetsById.set(screenId, read);
+  return read;
+}
+
+/** Calls `onChange` when the screen's insets change; returns the function that stops it. */
+export function subscribeScreenInsets(screenId, onChange) {
+  listen();
+  const own = listeners.get(screenId) ?? new Set();
+  own.add(onChange);
+  listeners.set(screenId, own);
+  return () => {
+    own.delete(onChange);
+    if (own.size === 0) listeners.delete(screenId);
+  };
+}
+
+/** The screen unmounted: its insets go. */
+export function forgetScreenInsets(screenId) {
+  insetsById.delete(screenId);
+  listeners.delete(screenId);
+}
+function listen() {
+  if (listening) return;
+  listening = true;
+  onNativeEvent('ScreenInsetsChanged', ({
+    componentId,
+    ...insets
+  }) => {
+    // Only the screens that read their insets keep them.
+    if (!insetsById.has(componentId) && !listeners.has(componentId)) return;
+    const next = toInsets(insets);
+    const current = insetsById.get(componentId);
+    if (current && sameInsets(current, next)) return;
+    insetsById.set(componentId, next);
+    listeners.get(componentId)?.forEach(onChange => onChange());
+  });
+}
+function readNative(screenId) {
+  // No native module in tests with the mock.
+  const read = ANNTurboModule?.getScreenInsets?.(screenId);
+  return read && typeof read.top === 'number' ? toInsets(read) : undefined;
+}
+function toInsets(value) {
+  return {
+    top: value.top ?? 0,
+    right: value.right ?? 0,
+    bottom: value.bottom ?? 0,
+    left: value.left ?? 0
+  };
+}
+function sameInsets(a, b) {
+  return a.top === b.top && a.right === b.right && a.bottom === b.bottom && a.left === b.left;
+}
+//# sourceMappingURL=screenInsets.js.map

package/lib/module/api/safeArea/screenInsets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ANNTurboModule","onNativeEvent","NONE","Object","freeze","top","right","bottom","left","insetsById","Map","listeners","listening","getScreenInsets","screenId","listen","known","get","read","readNative","set","subscribeScreenInsets","onChange","own","Set","add","delete","size","forgetScreenInsets","componentId","insets","has","next","toInsets","current","sameInsets","forEach","undefined","value","a","b"],"sourceRoot":"../../../../src","sources":["api/safeArea/screenInsets.ts"],"mappings":";;AAAA,OAAOA,cAAc,MAAM,wCAAqC;AAChE,SAASC,aAAa,QAAQ,wBAAqB;;AAGnD;AACA;AACA;AACA;;AAQA,MAAMC,IAAgB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,CAAC;EAAEC,KAAK,EAAE,CAAC;EAAEC,MAAM,EAAE,CAAC;EAAEC,IAAI,EAAE;AAAE,CAAC,CAAC;;AAEhF;AACA,MAAMC,UAAU,GAAG,IAAIC,GAAG,CAAqB,CAAC;AAChD,MAAMC,SAAS,GAAG,IAAID,GAAG,CAA0B,CAAC;AACpD,IAAIE,SAAS,GAAG,KAAK;;AAErB;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAACC,QAAgB,EAAc;EAC5DC,MAAM,CAAC,CAAC;EACR,MAAMC,KAAK,GAAGP,UAAU,CAACQ,GAAG,CAACH,QAAQ,CAAC;EACtC,IAAIE,KAAK,EAAE,OAAOA,KAAK;EACvB,MAAME,IAAI,GAAGC,UAAU,CAACL,QAAQ,CAAC;EACjC,IAAI,CAACI,IAAI,EAAE,OAAOhB,IAAI;EACtBO,UAAU,CAACW,GAAG,CAACN,QAAQ,EAAEI,IAAI,CAAC;EAC9B,OAAOA,IAAI;AACb;;AAEA;AACA,OAAO,SAASG,qBAAqBA,CAACP,QAAgB,EAAEQ,QAAoB,EAAc;EACxFP,MAAM,CAAC,CAAC;EACR,MAAMQ,GAAG,GAAGZ,SAAS,CAACM,GAAG,CAACH,QAAQ,CAAC,IAAI,IAAIU,GAAG,CAAa,CAAC;EAC5DD,GAAG,CAACE,GAAG,CAACH,QAAQ,CAAC;EACjBX,SAAS,CAACS,GAAG,CAACN,QAAQ,EAAES,GAAG,CAAC;EAC5B,OAAO,MAAM;IACXA,GAAG,CAACG,MAAM,CAACJ,QAAQ,CAAC;IACpB,IAAIC,GAAG,CAACI,IAAI,KAAK,CAAC,EAAEhB,SAAS,CAACe,MAAM,CAACZ,QAAQ,CAAC;EAChD,CAAC;AACH;;AAEA;AACA,OAAO,SAASc,kBAAkBA,CAACd,QAAgB,EAAE;EACnDL,UAAU,CAACiB,MAAM,CAACZ,QAAQ,CAAC;EAC3BH,SAAS,CAACe,MAAM,CAACZ,QAAQ,CAAC;AAC5B;AAEA,SAASC,MAAMA,CAAA,EAAG;EAChB,IAAIH,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBX,aAAa,CAA2B,qBAAqB,EAAE,CAAC;IAAE4B,WAAW;IAAE,GAAGC;EAAO,CAAC,KAAK;IAC7F;IACA,IAAI,CAACrB,UAAU,CAACsB,GAAG,CAACF,WAAW,CAAC,IAAI,CAAClB,SAAS,CAACoB,GAAG,CAACF,WAAW,CAAC,EAAE;IACjE,MAAMG,IAAI,GAAGC,QAAQ,CAACH,MAAM,CAAC;IAC7B,MAAMI,OAAO,GAAGzB,UAAU,CAACQ,GAAG,CAACY,WAAW,CAAC;IAC3C,IAAIK,OAAO,IAAIC,UAAU,CAACD,OAAO,EAAEF,IAAI,CAAC,EAAE;IAC1CvB,UAAU,CAACW,GAAG,CAACS,WAAW,EAAEG,IAAI,CAAC;IACjCrB,SAAS,CAACM,GAAG,CAACY,WAAW,CAAC,EAAEO,OAAO,CAAEd,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;EAC/D,CAAC,CAAC;AACJ;AAEA,SAASH,UAAUA,CAACL,QAAgB,EAA0B;EAC5D;EACA,MAAMI,IAAI,GAAGlB,cAAc,EAAEa,eAAe,GAAGC,QAAQ,CAAoC;EAC3F,OAAOI,IAAI,IAAI,OAAOA,IAAI,CAACb,GAAG,KAAK,QAAQ,GAAG4B,QAAQ,CAACf,IAAI,CAAC,GAAGmB,SAAS;AAC1E;AAEA,SAASJ,QAAQA,CAACK,KAA0B,EAAc;EACxD,OAAO;IACLjC,GAAG,EAAEiC,KAAK,CAACjC,GAAG,IAAI,CAAC;IACnBC,KAAK,EAAEgC,KAAK,CAAChC,KAAK,IAAI,CAAC;IACvBC,MAAM,EAAE+B,KAAK,CAAC/B,MAAM,IAAI,CAAC;IACzBC,IAAI,EAAE8B,KAAK,CAAC9B,IAAI,IAAI;EACtB,CAAC;AACH;AAEA,SAAS2B,UAAUA,CAACI,CAAa,EAAEC,CAAa,EAAE;EAChD,OAAOD,CAAC,CAAClC,GAAG,KAAKmC,CAAC,CAACnC,GAAG,IAAIkC,CAAC,CAACjC,KAAK,KAAKkC,CAAC,CAAClC,KAAK,IAAIiC,CAAC,CAAChC,MAAM,KAAKiC,CAAC,CAACjC,MAAM,IAAIgC,CAAC,CAAC/B,IAAI,KAAKgC,CAAC,CAAChC,IAAI;AAC7F","ignoreList":[]}

package/lib/module/api/safeArea/screenRegions.js

@@ -0,0 +1,84 @@
+"use strict";
+
+import ANNTurboModule from "../../adapters/NativeANNTurboModule.js";
+import { onNativeEvent } from "../../engine/native.js";
+
+/** A part of a screen in its coordinates: points on iOS, dp on Android. */
+
+/** The parts of a screen the hardware takes. */
+
+const NONE = Object.freeze({
+  division: [],
+  occlusion: []
+});
+
+// The regions of the screens read so far, by screen id, until the screen unmounts.
+const regionsById = new Map();
+const listeners = new Map();
+let listening = false;
+
+/**
+ * The regions of a screen: the last ones the native side sent, or read from it at once, so a screen's first render
+ * has them; none before its first layout and where the platform has none.
+ */
+export function getScreenRegions(screenId) {
+  listen();
+  const known = regionsById.get(screenId);
+  if (known) return known;
+  const read = readNative(screenId);
+  if (!read) return NONE;
+  regionsById.set(screenId, read);
+  return read;
+}
+
+/** Calls `onChange` when the screen's regions change; returns the function that stops it. */
+export function subscribeScreenRegions(screenId, onChange) {
+  listen();
+  const own = listeners.get(screenId) ?? new Set();
+  own.add(onChange);
+  listeners.set(screenId, own);
+  return () => {
+    own.delete(onChange);
+    if (own.size === 0) listeners.delete(screenId);
+  };
+}
+
+/** The screen unmounted: its regions go. */
+export function forgetScreenRegions(screenId) {
+  regionsById.delete(screenId);
+  listeners.delete(screenId);
+}
+function listen() {
+  if (listening) return;
+  listening = true;
+  onNativeEvent('ScreenRegionsChanged', ({
+    componentId,
+    ...regions
+  }) => {
+    // Only the screens that read their regions keep them.
+    if (!regionsById.has(componentId) && !listeners.has(componentId)) return;
+    const next = toRegions(regions);
+    const current = regionsById.get(componentId);
+    if (current && sameRegions(current, next)) return;
+    regionsById.set(componentId, next);
+    listeners.get(componentId)?.forEach(onChange => onChange());
+  });
+}
+function readNative(screenId) {
+  // No native module in tests with the mock.
+  const read = ANNTurboModule?.getScreenRegions?.(screenId);
+  return read && Array.isArray(read.division) ? toRegions(read) : undefined;
+}
+function toRegions(value) {
+  return {
+    division: value.division ?? [],
+    occlusion: value.occlusion ?? []
+  };
+}
+function sameRegions(a, b) {
+  return sameList(a.division, b.division) && sameList(a.occlusion, b.occlusion);
+}
+function sameList(a, b) {
+  return a.length === b.length && a.every((region, index) => region.x === b[index].x && region.y === b[index].y && region.width === b[index].width && region.height === b[index].height);
+}
+//# sourceMappingURL=screenRegions.js.map

package/lib/module/api/safeArea/screenRegions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ANNTurboModule","onNativeEvent","NONE","Object","freeze","division","occlusion","regionsById","Map","listeners","listening","getScreenRegions","screenId","listen","known","get","read","readNative","set","subscribeScreenRegions","onChange","own","Set","add","delete","size","forgetScreenRegions","componentId","regions","has","next","toRegions","current","sameRegions","forEach","Array","isArray","undefined","value","a","b","sameList","length","every","region","index","x","y","width","height"],"sourceRoot":"../../../../src","sources":["api/safeArea/screenRegions.ts"],"mappings":";;AAAA,OAAOA,cAAc,MAAM,wCAAqC;AAChE,SAASC,aAAa,QAAQ,wBAAqB;;AAGnD;;AAQA;;AAQA,MAAMC,IAAqB,GAAGC,MAAM,CAACC,MAAM,CAAC;EAAEC,QAAQ,EAAE,EAAE;EAAEC,SAAS,EAAE;AAAG,CAAC,CAAC;;AAE5E;AACA,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAA0B,CAAC;AACtD,MAAMC,SAAS,GAAG,IAAID,GAAG,CAA0B,CAAC;AACpD,IAAIE,SAAS,GAAG,KAAK;;AAErB;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,QAAgB,EAAmB;EAClEC,MAAM,CAAC,CAAC;EACR,MAAMC,KAAK,GAAGP,WAAW,CAACQ,GAAG,CAACH,QAAQ,CAAC;EACvC,IAAIE,KAAK,EAAE,OAAOA,KAAK;EACvB,MAAME,IAAI,GAAGC,UAAU,CAACL,QAAQ,CAAC;EACjC,IAAI,CAACI,IAAI,EAAE,OAAOd,IAAI;EACtBK,WAAW,CAACW,GAAG,CAACN,QAAQ,EAAEI,IAAI,CAAC;EAC/B,OAAOA,IAAI;AACb;;AAEA;AACA,OAAO,SAASG,sBAAsBA,CAACP,QAAgB,EAAEQ,QAAoB,EAAc;EACzFP,MAAM,CAAC,CAAC;EACR,MAAMQ,GAAG,GAAGZ,SAAS,CAACM,GAAG,CAACH,QAAQ,CAAC,IAAI,IAAIU,GAAG,CAAa,CAAC;EAC5DD,GAAG,CAACE,GAAG,CAACH,QAAQ,CAAC;EACjBX,SAAS,CAACS,GAAG,CAACN,QAAQ,EAAES,GAAG,CAAC;EAC5B,OAAO,MAAM;IACXA,GAAG,CAACG,MAAM,CAACJ,QAAQ,CAAC;IACpB,IAAIC,GAAG,CAACI,IAAI,KAAK,CAAC,EAAEhB,SAAS,CAACe,MAAM,CAACZ,QAAQ,CAAC;EAChD,CAAC;AACH;;AAEA;AACA,OAAO,SAASc,mBAAmBA,CAACd,QAAgB,EAAE;EACpDL,WAAW,CAACiB,MAAM,CAACZ,QAAQ,CAAC;EAC5BH,SAAS,CAACe,MAAM,CAACZ,QAAQ,CAAC;AAC5B;AAEA,SAASC,MAAMA,CAAA,EAAG;EAChB,IAAIH,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBT,aAAa,CAA4B,sBAAsB,EAAE,CAAC;IAAE0B,WAAW;IAAE,GAAGC;EAAQ,CAAC,KAAK;IAChG;IACA,IAAI,CAACrB,WAAW,CAACsB,GAAG,CAACF,WAAW,CAAC,IAAI,CAAClB,SAAS,CAACoB,GAAG,CAACF,WAAW,CAAC,EAAE;IAClE,MAAMG,IAAI,GAAGC,SAAS,CAACH,OAAO,CAAC;IAC/B,MAAMI,OAAO,GAAGzB,WAAW,CAACQ,GAAG,CAACY,WAAW,CAAC;IAC5C,IAAIK,OAAO,IAAIC,WAAW,CAACD,OAAO,EAAEF,IAAI,CAAC,EAAE;IAC3CvB,WAAW,CAACW,GAAG,CAACS,WAAW,EAAEG,IAAI,CAAC;IAClCrB,SAAS,CAACM,GAAG,CAACY,WAAW,CAAC,EAAEO,OAAO,CAAEd,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;EAC/D,CAAC,CAAC;AACJ;AAEA,SAASH,UAAUA,CAACL,QAAgB,EAA+B;EACjE;EACA,MAAMI,IAAI,GAAGhB,cAAc,EAAEW,gBAAgB,GAAGC,QAAQ,CAAyC;EACjG,OAAOI,IAAI,IAAImB,KAAK,CAACC,OAAO,CAACpB,IAAI,CAACX,QAAQ,CAAC,GAAG0B,SAAS,CAACf,IAAI,CAAC,GAAGqB,SAAS;AAC3E;AAEA,SAASN,SAASA,CAACO,KAA+B,EAAmB;EACnE,OAAO;IAAEjC,QAAQ,EAAEiC,KAAK,CAACjC,QAAQ,IAAI,EAAE;IAAEC,SAAS,EAAEgC,KAAK,CAAChC,SAAS,IAAI;EAAG,CAAC;AAC7E;AAEA,SAAS2B,WAAWA,CAACM,CAAkB,EAAEC,CAAkB,EAAW;EACpE,OAAOC,QAAQ,CAACF,CAAC,CAAClC,QAAQ,EAAEmC,CAAC,CAACnC,QAAQ,CAAC,IAAIoC,QAAQ,CAACF,CAAC,CAACjC,SAAS,EAAEkC,CAAC,CAAClC,SAAS,CAAC;AAC/E;AAEA,SAASmC,QAAQA,CAACF,CAAmB,EAAEC,CAAmB,EAAW;EACnE,OACED,CAAC,CAACG,MAAM,KAAKF,CAAC,CAACE,MAAM,IACrBH,CAAC,CAACI,KAAK,CACL,CAACC,MAAM,EAAEC,KAAK,KACZD,MAAM,CAACE,CAAC,KAAKN,CAAC,CAACK,KAAK,CAAC,CAAEC,CAAC,IACxBF,MAAM,CAACG,CAAC,KAAKP,CAAC,CAACK,KAAK,CAAC,CAAEE,CAAC,IACxBH,MAAM,CAACI,KAAK,KAAKR,CAAC,CAACK,KAAK,CAAC,CAAEG,KAAK,IAChCJ,MAAM,CAACK,MAAM,KAAKT,CAAC,CAACK,KAAK,CAAC,CAAEI,MAChC,CAAC;AAEL","ignoreList":[]}

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

@@ -0,0 +1,44 @@
+"use strict";
+
+import React, { Component } from 'react';
+
+/**
+ * What `errorFallback` gets: the error, the screen, and `retry`, which renders the screen again. When the start failed,
+ * the screen is the first root it shows in, and `retry` runs the start again from `willMount`.
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Keeps an error of a screen inside it: the screen shows the fallback, or nothing, and the other screens go on. With
+ * `appProvider` every screen is in one React tree, which an error would take down whole.
+ */
+export class ScreenBoundary extends Component {
+  state = {
+    failed: false,
+    error: undefined
+  };
+  static getDerivedStateFromError(error) {
+    return {
+      failed: true,
+      error
+    };
+  }
+  componentDidCatch(error, info) {
+    this.props.onError?.(error, info.componentStack);
+  }
+  retry = () => {
+    this.setState({
+      failed: false,
+      error: undefined
+    });
+  };
+  render() {
+    if (!this.state.failed) return this.props.children;
+    const Fallback = this.props.fallback;
+    return Fallback ? /*#__PURE__*/_jsx(Fallback, {
+      error: this.state.error,
+      screen: this.props.screen,
+      retry: this.retry
+    }) : null;
+  }
+}
+//# sourceMappingURL=ScreenBoundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","Component","jsx","_jsx","ScreenBoundary","state","failed","error","undefined","getDerivedStateFromError","componentDidCatch","info","props","onError","componentStack","retry","setState","render","children","Fallback","fallback","screen"],"sourceRoot":"../../../../src","sources":["api/screens/ScreenBoundary.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,SAAS,QAA4D,OAAO;;AAG5F;AACA;AACA;AACA;AAHA,SAAAC,GAAA,IAAAC,IAAA;AAsBA;AACA;AACA;AACA;AACA,OAAO,MAAMC,cAAc,SAASH,SAAS,CAAe;EAC1DI,KAAK,GAAU;IAAEC,MAAM,EAAE,KAAK;IAAEC,KAAK,EAAEC;EAAU,CAAC;EAElD,OAAOC,wBAAwBA,CAACF,KAAc,EAAS;IACrD,OAAO;MAAED,MAAM,EAAE,IAAI;MAAEC;IAAM,CAAC;EAChC;EAEAG,iBAAiBA,CAACH,KAAc,EAAEI,IAAe,EAAE;IACjD,IAAI,CAACC,KAAK,CAACC,OAAO,GAAGN,KAAK,EAAEI,IAAI,CAACG,cAAc,CAAC;EAClD;EAEAC,KAAK,GAAGA,CAAA,KAAM;IACZ,IAAI,CAACC,QAAQ,CAAC;MAAEV,MAAM,EAAE,KAAK;MAAEC,KAAK,EAAEC;IAAU,CAAC,CAAC;EACpD,CAAC;EAEDS,MAAMA,CAAA,EAAG;IACP,IAAI,CAAC,IAAI,CAACZ,KAAK,CAACC,MAAM,EAAE,OAAO,IAAI,CAACM,KAAK,CAACM,QAAQ;IAClD,MAAMC,QAAQ,GAAG,IAAI,CAACP,KAAK,CAACQ,QAAQ;IACpC,OAAOD,QAAQ,gBACbhB,IAAA,CAACgB,QAAQ;MAACZ,KAAK,EAAE,IAAI,CAACF,KAAK,CAACE,KAAM;MAACc,MAAM,EAAE,IAAI,CAACT,KAAK,CAACS,MAAO;MAACN,KAAK,EAAE,IAAI,CAACA;IAAM,CAAE,CAAC,GACjF,IAAI;EACV;AACF","ignoreList":[]}

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

@@ -0,0 +1,63 @@
+"use strict";
+
+const ARRANGEMENT = Symbol('apexnative.navigation.arrangement');
+
+/**
+ * A screen with a second screen beside or under it in a large window (iPad, iPhone Duo open, Android tablets and open
+ * foldables): `arrangement` of `defineScreen` and `nativeScreen`. Anywhere else (any phone, iPhone Duo folded, iOS
+ * before 27.1) the screen shows alone, as a plain screen.
+ */
+
+/** A pair under a name of its own, with every setting: `defineArrangement`. */
+
+/** An entry of `screens` made by `defineArrangement`. */
+
+/**
+ * Two screens of `screens` shown as one screen of a stack under a name of their own, with every setting of the pair.
+ * Commands, layouts and links name it as a screen. For a screen that always comes with the same second screen,
+ * `arrangement` of `defineScreen` is simpler.
+ *
+ * @example
+ * const screens = {
+ *   Profile: ProfileScreen,
+ *   Details: DetailsScreen,
+ *   ProfileDetails: defineArrangement<{ id: string }>({
+ *     primary: 'Profile',
+ *     secondary: 'Details',
+ *     style: 'overlay',
+ *   }),
+ * };
+ * navigation.push('ProfileDetails', { props: { id: '7' } });
+ */
+export function defineArrangement(definition) {
+  checkFraction(definition.fraction);
+  return {
+    [ARRANGEMENT]: true,
+    definition
+  };
+}
+export function isArrangement(value) {
+  return typeof value === 'object' && value !== null && ARRANGEMENT in value;
+}
+
+/** The pair as the engine keeps it: the settings `arrangement` of a screen has not, at their defaults. */
+export function toEngineArrangement(primary, arrangement) {
+  const full = arrangement;
+  checkFraction(full.fraction);
+  return {
+    primary,
+    secondary: arrangement.secondary,
+    secondaryProps: arrangement.secondaryProps,
+    style: arrangement.style ?? 'split',
+    axes: full.axes ?? 'both',
+    fraction: full.fraction ?? 0.5,
+    primaryEdge: full.primaryEdge ?? 'trailing',
+    compact: full.compact ?? 'primary'
+  };
+}
+function checkFraction(fraction) {
+  if (fraction !== undefined && !(fraction > 0 && fraction < 1)) {
+    throw new Error(`[navigation] arrangement: fraction is ${fraction}, it goes above 0 and below 1`);
+  }
+}
+//# sourceMappingURL=arrangement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ARRANGEMENT","Symbol","defineArrangement","definition","checkFraction","fraction","isArrangement","value","toEngineArrangement","primary","arrangement","full","secondary","secondaryProps","style","axes","primaryEdge","compact","undefined","Error"],"sourceRoot":"../../../../src","sources":["api/screens/arrangement.ts"],"mappings":";;AAEA,MAAMA,WAAW,GAAGC,MAAM,CAAC,mCAAmC,CAAC;;AAE/D;AACA;AACA;AACA;AACA;;AAkBA;;AAkBA;;AAQA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC/BC,UAAwC,EACpB;EACpBC,aAAa,CAACD,UAAU,CAACE,QAAQ,CAAC;EAClC,OAAO;IAAE,CAACL,WAAW,GAAG,IAAI;IAAEG;EAAW,CAAC;AAC5C;AAEA,OAAO,SAASG,aAAaA,CAACC,KAAc,EAA6B;EACvE,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI,IAAIP,WAAW,IAAIO,KAAK;AAC5E;;AAEA;AACA,OAAO,SAASC,mBAAmBA,CACjCC,OAAe,EACfC,WAAgE,EAC7C;EACnB,MAAMC,IAAI,GAAGD,WAAyC;EACtDN,aAAa,CAACO,IAAI,CAACN,QAAQ,CAAC;EAC5B,OAAO;IACLI,OAAO;IACPG,SAAS,EAAEF,WAAW,CAACE,SAAS;IAChCC,cAAc,EAAEH,WAAW,CAACG,cAAc;IAC1CC,KAAK,EAAEJ,WAAW,CAACI,KAAK,IAAI,OAAO;IACnCC,IAAI,EAAEJ,IAAI,CAACI,IAAI,IAAI,MAAM;IACzBV,QAAQ,EAAEM,IAAI,CAACN,QAAQ,IAAI,GAAG;IAC9BW,WAAW,EAAEL,IAAI,CAACK,WAAW,IAAI,UAAU;IAC3CC,OAAO,EAAEN,IAAI,CAACM,OAAO,IAAI;EAC3B,CAAC;AACH;AAEA,SAASb,aAAaA,CAACC,QAA4B,EAAE;EACnD,IAAIA,QAAQ,KAAKa,SAAS,IAAI,EAAEb,QAAQ,GAAG,CAAC,IAAIA,QAAQ,GAAG,CAAC,CAAC,EAAE;IAC7D,MAAM,IAAIc,KAAK,CACb,yCAAyCd,QAAQ,+BACnD,CAAC;EACH;AACF","ignoreList":[]}

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

@@ -0,0 +1,29 @@
+"use strict";
+
+import { getAppContext } from "../context/appContext.js";
+import { readScreenOptions, ScreenOptions } from "../options/ScreenOptions.js";
+import { getTheme } from "../theme/theme.js";
+
+/** What the options of a screen can read besides its props, as they are when a command shows the screen. */
+
+/** The options of a screen: options as they are, or a chain built from its props, the theme and the context. */
+
+/** A screen with what goes with it. */
+
+/**
+ * Describes a screen next to its component, so its registration stays one line. The same object can go right into
+ * `screens` of createNavigation.
+ */
+export function defineScreen(definition) {
+  return definition;
+}
+export function buildScreenOptions(input, props) {
+  if (!input) return {};
+  if (typeof input !== 'function') return input;
+  const app = {
+    theme: getTheme(),
+    context: getAppContext()
+  };
+  return readScreenOptions(input(new ScreenOptions(), props, app));
+}
+//# sourceMappingURL=defineScreen.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["getAppContext","readScreenOptions","ScreenOptions","getTheme","defineScreen","definition","buildScreenOptions","input","props","app","theme","context"],"sourceRoot":"../../../../src","sources":["api/screens/defineScreen.ts"],"mappings":";;AAEA,SAASA,aAAa,QAAQ,0BAAuB;AACrD,SAASC,iBAAiB,EAAEC,aAAa,QAAQ,6BAA0B;AAC3E,SAASC,QAAQ,QAA8B,mBAAgB;;AAI/D;;AAMA;;AAIA;;AAsBA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAQC,UAAmC,EAA2B;EAChG,OAAOA,UAAU;AACnB;AAEA,OAAO,SAASC,kBAAkBA,CAChCC,KAA4C,EAC5CC,KAAY,EACH;EACT,IAAI,CAACD,KAAK,EAAE,OAAO,CAAC,CAAC;EACrB,IAAI,OAAOA,KAAK,KAAK,UAAU,EAAE,OAAOA,KAAK;EAC7C,MAAME,GAAuB,GAAG;IAAEC,KAAK,EAAEP,QAAQ,CAAC,CAAC;IAAEQ,OAAO,EAAEX,aAAa,CAAC;EAAE,CAAC;EAC/E,OAAOC,iBAAiB,CAACM,KAAK,CAAC,IAAIL,aAAa,CAAC,CAAC,EAAEM,KAAK,EAAEC,GAAG,CAAC,CAAC;AAClE","ignoreList":[]}

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

@@ -0,0 +1,34 @@
+"use strict";
+
+import { answerNativeScreenCall, callNativeScreenFunction, nativeScreenInfo } from "../../engine/nativeScreens.js";
+import { onNativeEvent } from "../../engine/native.js";
+import { screenNavigation } from "../hooks/useNavigation.js";
+
+// The commands a native screen runs from itself, as `useNavigation()` of a React screen does.
+const COMMANDS = ['push', 'pop', 'popTo', 'popToRoot', 'showInColumn', 'showModal', 'dismiss', 'showOverlay', 'setOptions', 'selectTab', 'setTabBadge'];
+let listening = false;
+
+/** Runs what the native screens call: the functions of their props, and the commands of the navigation from them. */
+export function listenToNativeScreenCalls() {
+  if (listening) return;
+  listening = true;
+  onNativeEvent('NativeScreenCall', ({
+    componentId,
+    callId,
+    kind,
+    name,
+    args
+  }) => {
+    answerNativeScreenCall(callId, new Promise(resolve => resolve(kind === 'command' ? command(componentId, name, args) : callNativeScreenFunction(componentId, name, args))));
+  });
+}
+function command(componentId, name, args) {
+  const screen = nativeScreenInfo(componentId);
+  if (!screen) throw new Error(`[navigation] No native screen has the id '${componentId}'`);
+  if (!COMMANDS.includes(name)) {
+    throw new Error(`[navigation] '${name}' is not a command of a screen: ${COMMANDS.join(', ')}`);
+  }
+  const navigation = screenNavigation(screen);
+  return navigation[name](...args);
+}
+//# sourceMappingURL=nativeScreenCalls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["answerNativeScreenCall","callNativeScreenFunction","nativeScreenInfo","onNativeEvent","screenNavigation","COMMANDS","listening","listenToNativeScreenCalls","componentId","callId","kind","name","args","Promise","resolve","command","screen","Error","includes","join","navigation"],"sourceRoot":"../../../../src","sources":["api/screens/nativeScreenCalls.ts"],"mappings":";;AAAA,SACEA,sBAAsB,EACtBC,wBAAwB,EACxBC,gBAAgB,QACX,+BAA4B;AACnC,SAASC,aAAa,QAAQ,wBAAqB;AAEnD,SAASC,gBAAgB,QAA+B,2BAAwB;;AAEhF;AACA,MAAMC,QAAQ,GAAG,CACf,MAAM,EACN,KAAK,EACL,OAAO,EACP,WAAW,EACX,cAAc,EACd,WAAW,EACX,SAAS,EACT,aAAa,EACb,YAAY,EACZ,WAAW,EACX,aAAa,CACyC;AAExD,IAAIC,SAAS,GAAG,KAAK;;AAErB;AACA,OAAO,SAASC,yBAAyBA,CAAA,EAAS;EAChD,IAAID,SAAS,EAAE;EACfA,SAAS,GAAG,IAAI;EAChBH,aAAa,CACX,kBAAkB,EAClB,CAAC;IAAEK,WAAW;IAAEC,MAAM;IAAEC,IAAI;IAAEC,IAAI;IAAEC;EAAK,CAAC,KAAK;IAC7CZ,sBAAsB,CACpBS,MAAM,EACN,IAAII,OAAO,CAAEC,OAAO,IAClBA,OAAO,CACLJ,IAAI,KAAK,SAAS,GACdK,OAAO,CAACP,WAAW,EAAEG,IAAI,EAAEC,IAAI,CAAC,GAChCX,wBAAwB,CAACO,WAAW,EAAEG,IAAI,EAAEC,IAAI,CACtD,CACF,CACF,CAAC;EACH,CACF,CAAC;AACH;AAEA,SAASG,OAAOA,CAACP,WAAmB,EAAEG,IAAY,EAAEC,IAAe,EAAW;EAC5E,MAAMI,MAAM,GAAGd,gBAAgB,CAACM,WAAW,CAAC;EAC5C,IAAI,CAACQ,MAAM,EAAE,MAAM,IAAIC,KAAK,CAAC,6CAA6CT,WAAW,GAAG,CAAC;EACzF,IAAI,CAAEH,QAAQ,CAAuBa,QAAQ,CAACP,IAAI,CAAC,EAAE;IACnD,MAAM,IAAIM,KAAK,CAAC,iBAAiBN,IAAI,mCAAmCN,QAAQ,CAACc,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;EAChG;EACA,MAAMC,UAAU,GAAGhB,gBAAgB,CAACY,MAAM,CAGzC;EACD,OAAOI,UAAU,CAACT,IAAI,CAAC,CAAC,GAAGC,IAAI,CAAC;AAClC","ignoreList":[]}

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

@@ -0,0 +1,43 @@
+"use strict";
+
+const NATIVE_SCREEN = Symbol('apexnative.navigation.nativeScreen');
+
+/** A screen made on the native side (SwiftUI, UIKit, Compose, Android views), registered there under `nativeName`. */
+
+/** How a native screen shows: its options, and the hook that gives it the app's data. */
+
+/**
+ * A native screen for `screens`: commands and layouts name it like any other screen, and its props go to the native
+ * creator. `nativeName` is the name it is registered under natively (`ApexNavigation.registerNativeScreen`).
+ *
+ * @example
+ * const Settings = nativeScreen('Settings', {
+ *   useProps: () => {
+ *     const notifications = useSelector(selectNotifications);
+ *     const dispatch = useDispatch();
+ *     return {
+ *       notifications,
+ *       onNotificationsChange: (on: boolean) =>
+ *         dispatch(setNotifications(on)),
+ *     };
+ *   },
+ * });
+ */
+export function nativeScreen(nativeName, definition = {}) {
+  const {
+    options,
+    useProps,
+    arrangement
+  } = definition;
+  return {
+    [NATIVE_SCREEN]: true,
+    nativeName,
+    options,
+    useProps,
+    arrangement
+  };
+}
+export function isNativeScreen(value) {
+  return typeof value === 'object' && value !== null && NATIVE_SCREEN in value;
+}
+//# sourceMappingURL=nativeScreens.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["NATIVE_SCREEN","Symbol","nativeScreen","nativeName","definition","options","useProps","arrangement","isNativeScreen","value"],"sourceRoot":"../../../../src","sources":["api/screens/nativeScreens.ts"],"mappings":";;AAGA,MAAMA,aAAa,GAAGC,MAAM,CAAC,oCAAoC,CAAC;;AAElE;;AAWA;;AAcA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAC1BC,UAAkB,EAClBC,UAAyC,GAAG,CAAC,CAAC,EACzB;EACrB,MAAM;IAAEC,OAAO;IAAEC,QAAQ;IAAEC;EAAY,CAAC,GAAGH,UAAU;EACrD,OAAO;IAAE,CAACJ,aAAa,GAAG,IAAI;IAAEG,UAAU;IAAEE,OAAO;IAAEC,QAAQ;IAAEC;EAAY,CAAC;AAC9E;AAEA,OAAO,SAASC,cAAcA,CAACC,KAAc,EAA8B;EACzE,OAAO,OAAOA,KAAK,KAAK,QAAQ,IAAIA,KAAK,KAAK,IAAI,IAAIT,aAAa,IAAIS,KAAK;AAC9E","ignoreList":[]}