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

package/lib/module/engine/options.js

@@ -0,0 +1,170 @@
+"use strict";
+
+import { DynamicColorIOS, Image, Platform, processColor } from 'react-native';
+import { nextId } from "./ids.js";
+import { rememberButtonRoot, setProps } from "./props.js";
+/**
+ * The options as the native side reads them: colors in the format of the platform, images resolved, and every
+ * component in them with an id of its own (its props stay in JavaScript). Options come in their own form only:
+ * animations with `enter` and `exit`, `searchBar` and `interpolation` as objects.
+ */
+export function toNativeOptions(options) {
+  return convert(options);
+}
+
+/**
+ * Options as the native side reads them over others, merged as the native side merges them: groups key by key, while
+ * a color or an image, an object here too, replaces what was there as any value does. `undefined` keeps it.
+ */
+export function mergeNativeOptions(base, over) {
+  const result = {
+    ...base
+  };
+  for (const [key, next] of Object.entries(over)) {
+    if (next === undefined) continue;
+    const previous = result[key];
+    result[key] = !isColor(key) && !isImage(key) && isGroup(previous) && isGroup(next) ? mergeNativeOptions(previous, next) : next;
+  }
+  return result;
+}
+function isGroup(value) {
+  return isFields(value) && !Array.isArray(value);
+}
+function convert(value, key) {
+  if (key !== undefined && isColor(key)) return nativeColor(value);
+  if (key !== undefined && isImage(key)) return nativeImage(value);
+  if (Array.isArray(value)) {
+    const items = value.map(item => convert(item));
+    if (key?.endsWith('Buttons') || key === 'buttons') items.forEach(noteButtonRoot);
+    return key?.endsWith('Buttons') ? items.map(takeButtonProps) : items;
+  }
+  if (!isFields(value)) return value;
+  const result = {};
+  for (const [name, item] of Object.entries(withSymbols(value))) {
+    // The props of a component are its own, not options.
+    result[name] = name === 'passProps' ? item : convert(item, name);
+  }
+  return key === 'component' || key === 'resultsComponent' ? takeComponentProps(result) : result;
+}
+function isColor(key) {
+  return (key === 'color' || key.endsWith('Color')) && key !== 'bkgColor';
+}
+function isImage(key) {
+  return key === 'icon' || key === 'image' || key.endsWith('Icon') || key.endsWith('Image');
+}
+
+// The SF Symbol of an icon goes in the field the native side draws symbols from (a tab draws its filled variant).
+const SYMBOL_FIELDS = {
+  icon: 'sfSymbol',
+  selectedIcon: 'sfSelectedSymbol'
+};
+
+/** An icon for each platform (`{ ios, android }`), as opposed to an image source. */
+function isPlatformIcon(value) {
+  return isFields(value) && !Array.isArray(value) && !('uri' in value) && ('ios' in value || 'android' in value);
+}
+
+/** The fields with the icon of this platform in place of each `{ ios, android }` icon. */
+function withSymbols(fields) {
+  let result = fields;
+  for (const [field, symbolField] of Object.entries(SYMBOL_FIELDS)) {
+    const icon = fields[field];
+    if (!isPlatformIcon(icon)) continue;
+    const own = Platform.OS === 'ios' ? icon.ios : icon.android;
+    result = {
+      ...result
+    };
+    delete result[field];
+    if (own === undefined) continue;
+    if (Platform.OS === 'ios' && typeof own === 'string') result[symbolField] = own;else result[field] = own;
+  }
+  return result;
+}
+
+// An image: a source to resolve, the name of an Android drawable, or an icon for each platform.
+function nativeImage(value) {
+  if (!value || typeof value === 'string') return value;
+  if (isPlatformIcon(value)) {
+    const own = Platform.OS === 'ios' ? value.ios : value.android;
+    if (own === undefined) return undefined;
+    if (typeof own === 'string') return Platform.OS === 'ios' ? {
+      system: own
+    } : own;
+    return Image.resolveAssetSource(own);
+  }
+  return Image.resolveAssetSource(value);
+}
+function isFields(value) {
+  return typeof value === 'object' && value !== null;
+}
+
+// A component in the options gets an id; the native side creates it with that id, and its props wait here.
+function takeComponentProps({
+  passProps,
+  ...component
+}) {
+  const componentId = component.id || nextId('CustomComponent');
+  if (passProps) setProps(componentId, passProps);
+  return {
+    ...component,
+    componentId
+  };
+}
+
+// The component of a bar button (the top bar's `*Buttons`, the toolbar's `buttons`) is a root the native side only
+// sizes: its wrapper centers the content in the button's slot.
+function noteButtonRoot(button) {
+  const component = isFields(button) ? button.component : undefined;
+  if (isFields(component) && typeof component.componentId === 'string') {
+    rememberButtonRoot(component.componentId);
+  }
+}
+
+// The props of a button with a component of its own go with the button's id.
+function takeButtonProps(button) {
+  if (!isFields(button) || !button.passProps || !button.id) return button;
+  const {
+    passProps,
+    ...rest
+  } = button;
+  setProps(button.id, passProps);
+  return rest;
+}
+function nativeColor(value) {
+  if (value === undefined) return undefined;
+  return Platform.OS === 'ios' ? iosColor(value) : androidColor(value);
+}
+
+// One color, a pair for the light and the dark appearance, or a semantic color; null takes the color away.
+function iosColor(value) {
+  if (value === null) return 'NoColor';
+  if (!isFields(value)) return processColor(value);
+  if ('semantic' in value) return value;
+  const pair = 'dynamic' in value ? value.dynamic : value;
+  return DynamicColorIOS({
+    light: processColor(pair.light),
+    dark: processColor(pair.dark)
+  });
+}
+
+// Android always takes a pair; one color goes to both, and the side without a color has none.
+function androidColor(value) {
+  const pair = {
+    dark: 'NoColor',
+    light: 'NoColor'
+  };
+  if (value === null) return pair;
+  if (!isFields(value)) {
+    const color = processColor(value);
+    return {
+      dark: color,
+      light: color
+    };
+  }
+  if ('semantic' in value || 'resource_paths' in value) return value;
+  for (const [appearance, color] of Object.entries(value)) {
+    pair[appearance] = processColor(color);
+  }
+  return pair;
+}
+//# sourceMappingURL=options.js.map

package/lib/module/engine/options.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["DynamicColorIOS","Image","Platform","processColor","nextId","rememberButtonRoot","setProps","toNativeOptions","options","convert","mergeNativeOptions","base","over","result","key","next","Object","entries","undefined","previous","isColor","isImage","isGroup","value","isFields","Array","isArray","nativeColor","nativeImage","items","map","item","endsWith","forEach","noteButtonRoot","takeButtonProps","name","withSymbols","takeComponentProps","SYMBOL_FIELDS","icon","selectedIcon","isPlatformIcon","fields","field","symbolField","own","OS","ios","android","system","resolveAssetSource","passProps","component","componentId","id","button","rest","iosColor","androidColor","pair","dynamic","light","dark","color","appearance"],"sourceRoot":"../../../src","sources":["engine/options.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/engine/places.js

@@ -0,0 +1,178 @@
+"use strict";
+
+import { onNativeEvent } from "./native.js";
+import { screenNameOf } from "./slots.js";
+
+// Where each screen is, noted as the engine builds the layouts of the commands: what it shows in and its place in its
+// stack. A screen keeps its place while it lives (a command can only put screens over it or take it away), so the
+// navigation answers about it at once, without asking the native side.
+
+/** Where a screen is. */
+
+const MENU_PARTS = {
+  SideMenuLeft: 'left',
+  SideMenuCenter: 'center',
+  SideMenuRight: 'right'
+};
+
+/** A column of a split view: the split view's id and the column's name. */
+
+const places = new Map();
+// The column each stack of a split view shows, by the stack's id, and the column of a screen alone in one; the stack
+// of each column, by the split view's id. A screen pushed in a column's stack is in that column too.
+const columnOfStack = new Map();
+const columnOfScreen = new Map();
+const stacksOfSplit = new Map();
+// The split views whose columns show as one stack, one over another, as the native side tells.
+const stackedSplits = new Set();
+let listeningToSplitViews = false;
+// The primaries of pairs shown alone, noted as their node is built, until their place is noted.
+const alone = new Set();
+// The last screens that went, so a command from one of them can say so; a screen the engine never saw is not one.
+const gone = new Set();
+const GONE_KEPT = 200;
+export function placeOf(screenId) {
+  return places.get(screenId);
+}
+
+/** Notes that a screen is the primary of a pair shown alone, where the native side shows no pairs. */
+export function noteAlone(screenId) {
+  alone.add(screenId);
+}
+
+/** The screen was shown and is gone. */
+export function isGone(screenId) {
+  return gone.has(screenId);
+}
+
+/**
+ * Notes the screens of a layout, the first of a stack at `index`. A modal or an overlay given as a whole is a layer of
+ * its own; screens added to one, such as a push, take the layer of the screen they come from.
+ */
+export function notePlaces(node, container, stack = null, index = 0, menu, layer = container === 'root' ? 'root' : node.id) {
+  if (node.type === 'Component' || node.type === 'ExternalComponent') {
+    const name = node.data.name ?? '';
+    gone.delete(node.id);
+    columnOfScreen.delete(node.id);
+    places.set(node.id, {
+      name: screenNameOf(name),
+      container,
+      stack,
+      index,
+      ...(menu && {
+        menu
+      }),
+      layer,
+      ...(alone.delete(node.id) ? {
+        arrangement: {
+          id: node.id,
+          placement: 'primary',
+          alone: true
+        }
+      } : {})
+    });
+  } else if (node.type === 'Arrangement') {
+    // One entry of its stack: both screens have its place there, and each knows the pair.
+    node.children.forEach((child, childIndex) => {
+      notePlaces(child, container, stack, index, menu, layer);
+      const place = places.get(child.id);
+      if (place) {
+        const placement = childIndex === 0 ? 'primary' : 'secondary';
+        places.set(child.id, {
+          ...place,
+          arrangement: {
+            id: node.id,
+            placement
+          }
+        });
+      }
+    });
+  } else if (node.type === 'Stack') {
+    columnOfStack.delete(node.id);
+    node.children.forEach((child, childIndex) => notePlaces(child, container, node.id, childIndex, menu, layer));
+  } else if (node.type === 'SplitView') {
+    // A split view sent again with its id starts anew: its columns are noted again, and it isn't one stack until the
+    // native side says so.
+    forgetSplit(node.id);
+    const columns = node.data.columns ?? [];
+    const stacks = {};
+    node.children.forEach((child, childIndex) => {
+      notePlaces(child, container, null, 0, menu, layer);
+      const column = columns[childIndex];
+      if (!column) return;
+      if (child.type === 'Stack') stacks[column] = child.id;
+      noteColumn(child, {
+        split: node.id,
+        column
+      });
+    });
+    stacksOfSplit.set(node.id, stacks);
+  } else if (node.type === 'SideMenuRoot') {
+    for (const part of node.children) {
+      const side = MENU_PARTS[part.type];
+      part.children.forEach(child => notePlaces(child, container, null, 0, side ? {
+        id: node.id,
+        part: side
+      } : menu, layer));
+    }
+  } else {
+    node.children.forEach(child => notePlaces(child, container, null, 0, menu, layer));
+  }
+}
+
+// The column of every stack and every screen out of a stack under a column of a split view, also in its tabs or menus.
+function noteColumn(node, column) {
+  if (node.type === 'Stack') columnOfStack.set(node.id, column);else if (node.type === 'Component' || node.type === 'ExternalComponent') {
+    columnOfScreen.set(node.id, column);
+  } else node.children.forEach(child => noteColumn(child, column));
+}
+function forgetSplit(split) {
+  stackedSplits.delete(split);
+  stacksOfSplit.delete(split);
+  for (const columns of [columnOfStack, columnOfScreen]) {
+    for (const [id, column] of columns) if (column.split === split) columns.delete(id);
+  }
+}
+
+/** The column of a split view the screen shows in, through its stack or alone; undefined outside a split view. */
+export function columnOf(screenId) {
+  const place = places.get(screenId);
+  if (!place) return undefined;
+  return place.stack !== null ? columnOfStack.get(place.stack) : columnOfScreen.get(screenId);
+}
+
+/** The id of the stack a column of the split view shows, when it shows one. */
+export function stackOfColumn(split, column) {
+  return stacksOfSplit.get(split)?.[column];
+}
+
+/**
+ * Whether the screen is the first of its column's stack and that column is over the column before it: the columns of
+ * its split view show as one stack (a phone), so back goes to the column before.
+ */
+export function coversColumn(screenId) {
+  const place = places.get(screenId);
+  const column = columnOf(screenId);
+  return place !== undefined && place.stack !== null && place.index === 0 && column !== undefined && (column.column === 'secondary' || column.column === 'supplementary') && stackOfColumn(column.split, column.column) === place.stack && stackedSplits.has(column.split);
+}
+
+/** Listens to the split views telling whether their columns show as one stack, once for the app. */
+export function listenToSplitViews() {
+  if (listeningToSplitViews) return;
+  listeningToSplitViews = true;
+  onNativeEvent('SplitViewColumnsStacked', ({
+    componentId,
+    stacked
+  }) => {
+    if (stacked) stackedSplits.add(componentId);else stackedSplits.delete(componentId);
+  });
+}
+
+/** The screen is gone. */
+export function forgetPlace(screenId) {
+  places.delete(screenId);
+  columnOfScreen.delete(screenId);
+  gone.add(screenId);
+  if (gone.size > GONE_KEPT) gone.delete(gone.values().next().value);
+}
+//# sourceMappingURL=places.js.map

package/lib/module/engine/places.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["onNativeEvent","screenNameOf","MENU_PARTS","SideMenuLeft","SideMenuCenter","SideMenuRight","places","Map","columnOfStack","columnOfScreen","stacksOfSplit","stackedSplits","Set","listeningToSplitViews","alone","gone","GONE_KEPT","placeOf","screenId","get","noteAlone","add","isGone","has","notePlaces","node","container","stack","index","menu","layer","id","type","name","data","delete","set","arrangement","placement","children","forEach","child","childIndex","place","forgetSplit","columns","stacks","column","noteColumn","split","part","side","columnOf","undefined","stackOfColumn","coversColumn","listenToSplitViews","componentId","stacked","forgetPlace","size","values","next","value"],"sourceRoot":"../../../src","sources":["engine/places.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/engine/props.js

@@ -0,0 +1,44 @@
+"use strict";
+
+// The props of the screens and of the components in options, by their ids. A command puts them here before the native
+// side creates the views, and each view takes its own as it mounts: React Native passes a root only its id. New props
+// under the id of a view already shown (options that name the same component again) render it again with them.
+const byId = new Map();
+const watchers = new Map();
+// The same object each time, so a view without props is not told they changed.
+const none = {};
+// The roots that are the components of bar buttons: their wrapper centers the content in the button's slot.
+const buttonRoots = new Set();
+export function setProps(id, props) {
+  if (props === undefined) byId.delete(id);else byId.set(id, props);
+  watchers.get(id)?.forEach(watcher => watcher());
+}
+export function propsOf(id) {
+  return byId.get(id) ?? none;
+}
+
+/** Calls back when the props under the id change; returns what stops it. */
+export function watchProps(id, watcher) {
+  let set = watchers.get(id);
+  if (!set) watchers.set(id, set = new Set());
+  set.add(watcher);
+  return () => {
+    set.delete(watcher);
+    if (set.size === 0) watchers.delete(id);
+  };
+}
+export function rememberButtonRoot(id) {
+  buttonRoots.add(id);
+}
+
+/** Whether the root under the id is the component of a bar button (top bar or toolbar). */
+export function isButtonRoot(id) {
+  return buttonRoots.has(id);
+}
+
+/** The view is gone: its props, and whether it is a button's root, are not needed again. */
+export function forgetProps(id) {
+  byId.delete(id);
+  buttonRoots.delete(id);
+}
+//# sourceMappingURL=props.js.map

package/lib/module/engine/props.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["byId","Map","watchers","none","buttonRoots","Set","setProps","id","props","undefined","delete","set","get","forEach","watcher","propsOf","watchProps","add","size","rememberButtonRoot","isButtonRoot","has","forgetProps"],"sourceRoot":"../../../src","sources":["engine/props.ts"],"mappings":";;AAAA;AACA;AACA;AACA,MAAMA,IAAI,GAAG,IAAIC,GAAG,CAAiB,CAAC;AACtC,MAAMC,QAAQ,GAAG,IAAID,GAAG,CAA0B,CAAC;AACnD;AACA,MAAME,IAAI,GAAG,CAAC,CAAC;AACf;AACA,MAAMC,WAAW,GAAG,IAAIC,GAAG,CAAS,CAAC;AAErC,OAAO,SAASC,QAAQA,CAACC,EAAU,EAAEC,KAAyB,EAAQ;EACpE,IAAIA,KAAK,KAAKC,SAAS,EAAET,IAAI,CAACU,MAAM,CAACH,EAAE,CAAC,CAAC,KACpCP,IAAI,CAACW,GAAG,CAACJ,EAAE,EAAEC,KAAK,CAAC;EACxBN,QAAQ,CAACU,GAAG,CAACL,EAAE,CAAC,EAAEM,OAAO,CAAEC,OAAO,IAAKA,OAAO,CAAC,CAAC,CAAC;AACnD;AAEA,OAAO,SAASC,OAAOA,CAACR,EAAU,EAAU;EAC1C,OAAOP,IAAI,CAACY,GAAG,CAACL,EAAE,CAAC,IAAIJ,IAAI;AAC7B;;AAEA;AACA,OAAO,SAASa,UAAUA,CAACT,EAAU,EAAEO,OAAmB,EAAc;EACtE,IAAIH,GAAG,GAAGT,QAAQ,CAACU,GAAG,CAACL,EAAE,CAAC;EAC1B,IAAI,CAACI,GAAG,EAAET,QAAQ,CAACS,GAAG,CAACJ,EAAE,EAAGI,GAAG,GAAG,IAAIN,GAAG,CAAC,CAAE,CAAC;EAC7CM,GAAG,CAACM,GAAG,CAACH,OAAO,CAAC;EAChB,OAAO,MAAM;IACXH,GAAG,CAACD,MAAM,CAACI,OAAO,CAAC;IACnB,IAAIH,GAAG,CAACO,IAAI,KAAK,CAAC,EAAEhB,QAAQ,CAACQ,MAAM,CAACH,EAAE,CAAC;EACzC,CAAC;AACH;AAEA,OAAO,SAASY,kBAAkBA,CAACZ,EAAU,EAAQ;EACnDH,WAAW,CAACa,GAAG,CAACV,EAAE,CAAC;AACrB;;AAEA;AACA,OAAO,SAASa,YAAYA,CAACb,EAAU,EAAW;EAChD,OAAOH,WAAW,CAACiB,GAAG,CAACd,EAAE,CAAC;AAC5B;;AAEA;AACA,OAAO,SAASe,WAAWA,CAACf,EAAU,EAAQ;EAC5CP,IAAI,CAACU,MAAM,CAACH,EAAE,CAAC;EACfH,WAAW,CAACM,MAAM,CAACH,EAAE,CAAC;AACxB","ignoreList":[]}

package/lib/module/engine/reactMeasures.js

@@ -0,0 +1,23 @@
+"use strict";
+
+// In development React records a `performance.measure` for every render of a component, for the performance tracks of
+// React DevTools, and React Native keeps every entry: a long session of navigation runs out of memory. A trace that
+// records takes the entries as they come, so dropping them from the buffer loses nothing.
+
+// React names the measure of a component's render after the component with this mark in front; nothing else does.
+const RENDER_MARK = '​';
+
+// The part of React Native's Performance API this uses.
+
+/** Drops React's measures of component renders (development only); the app's own measures stay. */
+export function dropReactRenderMeasures() {
+  if (!__DEV__) return;
+  const performance = globalThis.performance;
+  if (!performance?.getEntriesByType || !performance.clearMeasures) return;
+  const names = new Set();
+  for (const entry of performance.getEntriesByType('measure')) {
+    if (entry.name.startsWith(RENDER_MARK)) names.add(entry.name);
+  }
+  names.forEach(name => performance.clearMeasures?.(name));
+}
+//# sourceMappingURL=reactMeasures.js.map

package/lib/module/engine/reactMeasures.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["RENDER_MARK","dropReactRenderMeasures","__DEV__","performance","globalThis","getEntriesByType","clearMeasures","names","Set","entry","name","startsWith","add","forEach"],"sourceRoot":"../../../src","sources":["engine/reactMeasures.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA;AACA,MAAMA,WAAW,GAAG,GAAG;;AAEvB;;AAMA;AACA,OAAO,SAASC,uBAAuBA,CAAA,EAAS;EAC9C,IAAI,CAACC,OAAO,EAAE;EACd,MAAMC,WAAW,GAAIC,UAAU,CAAgCD,WAAW;EAC1E,IAAI,CAACA,WAAW,EAAEE,gBAAgB,IAAI,CAACF,WAAW,CAACG,aAAa,EAAE;EAClE,MAAMC,KAAK,GAAG,IAAIC,GAAG,CAAS,CAAC;EAC/B,KAAK,MAAMC,KAAK,IAAIN,WAAW,CAACE,gBAAgB,CAAC,SAAS,CAAC,EAAE;IAC3D,IAAII,KAAK,CAACC,IAAI,CAACC,UAAU,CAACX,WAAW,CAAC,EAAEO,KAAK,CAACK,GAAG,CAACH,KAAK,CAACC,IAAI,CAAC;EAC/D;EACAH,KAAK,CAACM,OAAO,CAAEH,IAAI,IAAKP,WAAW,CAACG,aAAa,GAAGI,IAAI,CAAC,CAAC;AAC5D","ignoreList":[]}

package/lib/module/engine/rememberedOptions.js

@@ -0,0 +1,118 @@
+"use strict";
+
+import { mergeOptions } from "./mergeOptions.js";
+import { mergeNativeOptions, toNativeOptions } from "./options.js";
+
+// The options every mergeOptions sent to a node, merged over one another, by the node's id. Android destroys the
+// activity with every screen while JavaScript lives on, and the last root, set again for the next activity, shows them
+// again. Only the nodes of that root keep them, until another root goes out: the activity takes the screens of the
+// root with it before the root is set again, so they keep them past their unmount.
+
+/** The nodes of the root the native side got last, as it read them. */
+
+const remembered = new Map();
+let lastRoot;
+
+/**
+ * Remembers the options a mergeOptions sent to the node with the id, over those remembered for it before. Only the
+ * nodes of the last root are shown again, so only theirs are kept: a screen pushed or shown in a modal later is not
+ * in that root. The options that act once (a tab to select, a menu to open) stay in no node and are not remembered.
+ */
+export function rememberMergedOptions(id, options) {
+  if (!lastRoot?.ids.has(id)) return;
+  const kept = withoutOneTimeOptions(options);
+  const before = remembered.get(id);
+  remembered.set(id, before ? mergeOptions(before, kept) : kept);
+}
+
+/** Forgets the merged options of a node that went; a node of the last root keeps them until another root goes out. */
+export function forgetMergedOptions(id) {
+  if (!lastRoot?.ids.has(id)) remembered.delete(id);
+}
+
+/** The options merged into the node with the id, as remembered; undefined without any. */
+export function mergedOptionsOf(id) {
+  return remembered.get(id);
+}
+
+/** The root the native side got last; undefined before the first one. */
+export function sentRoot() {
+  return lastRoot;
+}
+
+/**
+ * Notes the layouts of a root going out to the native side now: the root, its modals and its overlays. `again` is the
+ * root the native side had when the last root was set again for a new launch of the native side (Android: a new
+ * activity), undefined for any other root. While it is still the last one, each node of the new layout in the place of
+ * one of its nodes takes the options merged into that one over its own, and keeps them under its own id. Otherwise the
+ * nodes of the root before drop theirs: they all go.
+ */
+export function rootGoesOut(nodes, again) {
+  const before = lastRoot;
+  lastRoot = {
+    nodes,
+    ids: new Set(nodes.flatMap(idsOf))
+  };
+  if (!before) return;
+  const moved = new Map();
+  if (again === before) {
+    pairNodes(before.nodes, nodes, (old, node) => {
+      const options = remembered.get(old.id);
+      if (!options) return;
+      node.data.options = mergeNativeOptions(node.data.options ?? {}, toNativeOptions(options));
+      moved.set(node.id, options);
+    });
+  }
+  before.ids.forEach(id => remembered.delete(id));
+  moved.forEach((options, id) => remembered.set(id, options));
+}
+function idsOf(node) {
+  return [node.id, ...node.children.flatMap(idsOf)];
+}
+
+// The same root built again has the same nodes in the same places, the same kind with the same name; those the app gave
+// no id to get new ids.
+function pairNodes(before, after, pair) {
+  before.forEach((old, index) => {
+    const node = after[index];
+    if (!node || node.type !== old.type || node.data.name !== old.data.name) return;
+    pair(old, node);
+    pairNodes(old.children, node.children, pair);
+  });
+}
+
+// Selecting a tab and opening or closing a menu act when they arrive and stay in no node's options: the root set again
+// neither selects the tab nor opens the menu once more.
+function withoutOneTimeOptions(options) {
+  let result = options;
+  if (options.bottomTabs) {
+    const bottomTabs = {
+      ...options.bottomTabs
+    };
+    delete bottomTabs.currentTabIndex;
+    delete bottomTabs.currentTabId;
+    result = {
+      ...result,
+      bottomTabs
+    };
+  }
+  if (options.sideMenu) {
+    const sideMenu = {
+      ...options.sideMenu
+    };
+    for (const side of ['left', 'right']) {
+      const settings = sideMenu[side] && {
+        ...sideMenu[side]
+      };
+      if (!settings) continue;
+      delete settings.visible;
+      sideMenu[side] = settings;
+    }
+    result = {
+      ...result,
+      sideMenu
+    };
+  }
+  return result;
+}
+//# sourceMappingURL=rememberedOptions.js.map

package/lib/module/engine/rememberedOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mergeOptions","mergeNativeOptions","toNativeOptions","remembered","Map","lastRoot","rememberMergedOptions","id","options","ids","has","kept","withoutOneTimeOptions","before","get","set","forgetMergedOptions","delete","mergedOptionsOf","sentRoot","rootGoesOut","nodes","again","Set","flatMap","idsOf","moved","pairNodes","old","node","data","forEach","children","after","pair","index","type","name","result","bottomTabs","currentTabIndex","currentTabId","sideMenu","side","settings","visible"],"sourceRoot":"../../../src","sources":["engine/rememberedOptions.ts"],"mappings":";;AAEA,SAASA,YAAY,QAAQ,mBAAgB;AAC7C,SAASC,kBAAkB,EAAEC,eAAe,QAAQ,cAAW;;AAE/D;AACA;AACA;AACA;;AAEA;;AAMA,MAAMC,UAAU,GAAG,IAAIC,GAAG,CAAkB,CAAC;AAC7C,IAAIC,QAA8B;;AAElC;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,qBAAqBA,CAACC,EAAU,EAAEC,OAAgB,EAAQ;EACxE,IAAI,CAACH,QAAQ,EAAEI,GAAG,CAACC,GAAG,CAACH,EAAE,CAAC,EAAE;EAC5B,MAAMI,IAAI,GAAGC,qBAAqB,CAACJ,OAAO,CAAC;EAC3C,MAAMK,MAAM,GAAGV,UAAU,CAACW,GAAG,CAACP,EAAE,CAAC;EACjCJ,UAAU,CAACY,GAAG,CAACR,EAAE,EAAEM,MAAM,GAAGb,YAAY,CAACa,MAAM,EAAEF,IAAI,CAAC,GAAGA,IAAI,CAAC;AAChE;;AAEA;AACA,OAAO,SAASK,mBAAmBA,CAACT,EAAU,EAAQ;EACpD,IAAI,CAACF,QAAQ,EAAEI,GAAG,CAACC,GAAG,CAACH,EAAE,CAAC,EAAEJ,UAAU,CAACc,MAAM,CAACV,EAAE,CAAC;AACnD;;AAEA;AACA,OAAO,SAASW,eAAeA,CAACX,EAAU,EAAuB;EAC/D,OAAOJ,UAAU,CAACW,GAAG,CAACP,EAAE,CAAC;AAC3B;;AAEA;AACA,OAAO,SAASY,QAAQA,CAAA,EAAyB;EAC/C,OAAOd,QAAQ;AACjB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASe,WAAWA,CAACC,KAAmB,EAAEC,KAA2B,EAAQ;EAClF,MAAMT,MAAM,GAAGR,QAAQ;EACvBA,QAAQ,GAAG;IAAEgB,KAAK;IAAEZ,GAAG,EAAE,IAAIc,GAAG,CAACF,KAAK,CAACG,OAAO,CAACC,KAAK,CAAC;EAAE,CAAC;EACxD,IAAI,CAACZ,MAAM,EAAE;EACb,MAAMa,KAAK,GAAG,IAAItB,GAAG,CAAkB,CAAC;EACxC,IAAIkB,KAAK,KAAKT,MAAM,EAAE;IACpBc,SAAS,CAACd,MAAM,CAACQ,KAAK,EAAEA,KAAK,EAAE,CAACO,GAAG,EAAEC,IAAI,KAAK;MAC5C,MAAMrB,OAAO,GAAGL,UAAU,CAACW,GAAG,CAACc,GAAG,CAACrB,EAAE,CAAC;MACtC,IAAI,CAACC,OAAO,EAAE;MACdqB,IAAI,CAACC,IAAI,CAACtB,OAAO,GAAGP,kBAAkB,CAAC4B,IAAI,CAACC,IAAI,CAACtB,OAAO,IAAI,CAAC,CAAC,EAAEN,eAAe,CAACM,OAAO,CAAC,CAAC;MACzFkB,KAAK,CAACX,GAAG,CAACc,IAAI,CAACtB,EAAE,EAAEC,OAAO,CAAC;IAC7B,CAAC,CAAC;EACJ;EACAK,MAAM,CAACJ,GAAG,CAACsB,OAAO,CAAExB,EAAE,IAAKJ,UAAU,CAACc,MAAM,CAACV,EAAE,CAAC,CAAC;EACjDmB,KAAK,CAACK,OAAO,CAAC,CAACvB,OAAO,EAAED,EAAE,KAAKJ,UAAU,CAACY,GAAG,CAACR,EAAE,EAAEC,OAAO,CAAC,CAAC;AAC7D;AAEA,SAASiB,KAAKA,CAACI,IAAgB,EAAY;EACzC,OAAO,CAACA,IAAI,CAACtB,EAAE,EAAE,GAAGsB,IAAI,CAACG,QAAQ,CAACR,OAAO,CAACC,KAAK,CAAC,CAAC;AACnD;;AAEA;AACA;AACA,SAASE,SAASA,CAChBd,MAAoB,EACpBoB,KAAmB,EACnBC,IAAiD,EAC3C;EACNrB,MAAM,CAACkB,OAAO,CAAC,CAACH,GAAG,EAAEO,KAAK,KAAK;IAC7B,MAAMN,IAAI,GAAGI,KAAK,CAACE,KAAK,CAAC;IACzB,IAAI,CAACN,IAAI,IAAIA,IAAI,CAACO,IAAI,KAAKR,GAAG,CAACQ,IAAI,IAAIP,IAAI,CAACC,IAAI,CAACO,IAAI,KAAKT,GAAG,CAACE,IAAI,CAACO,IAAI,EAAE;IACzEH,IAAI,CAACN,GAAG,EAAEC,IAAI,CAAC;IACfF,SAAS,CAACC,GAAG,CAACI,QAAQ,EAAEH,IAAI,CAACG,QAAQ,EAAEE,IAAI,CAAC;EAC9C,CAAC,CAAC;AACJ;;AAEA;AACA;AACA,SAAStB,qBAAqBA,CAACJ,OAAgB,EAAW;EACxD,IAAI8B,MAAM,GAAG9B,OAAO;EACpB,IAAIA,OAAO,CAAC+B,UAAU,EAAE;IACtB,MAAMA,UAAU,GAAG;MAAE,GAAG/B,OAAO,CAAC+B;IAAW,CAAC;IAC5C,OAAOA,UAAU,CAACC,eAAe;IACjC,OAAOD,UAAU,CAACE,YAAY;IAC9BH,MAAM,GAAG;MAAE,GAAGA,MAAM;MAAEC;IAAW,CAAC;EACpC;EACA,IAAI/B,OAAO,CAACkC,QAAQ,EAAE;IACpB,MAAMA,QAAQ,GAAG;MAAE,GAAGlC,OAAO,CAACkC;IAAS,CAAC;IACxC,KAAK,MAAMC,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,EAAW;MAC7C,MAAMC,QAAQ,GAAGF,QAAQ,CAACC,IAAI,CAAC,IAAI;QAAE,GAAGD,QAAQ,CAACC,IAAI;MAAE,CAAC;MACxD,IAAI,CAACC,QAAQ,EAAE;MACf,OAAOA,QAAQ,CAACC,OAAO;MACvBH,QAAQ,CAACC,IAAI,CAAC,GAAGC,QAAQ;IAC3B;IACAN,MAAM,GAAG;MAAE,GAAGA,MAAM;MAAEI;IAAS,CAAC;EAClC;EACA,OAAOJ,MAAM;AACf","ignoreList":[]}