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

package/lib/module/api/linking/linking.js

@@ -0,0 +1,244 @@
+"use strict";
+
+import { Linking, Platform } from 'react-native';
+import { getLaunchLink } from "../../engine/native.js";
+import { resolveRoot } from "../app/roots.js";
+import { commandsStarted, whenCommandsSettle } from "../commands/errors.js";
+import { getAppContext, subscribeAppContext } from "../context/appContext.js";
+import { buildRoot } from "../layout/Root.js";
+import { navigation } from "../navigation.js";
+import { getNavigationState, whenScreenAfter } from "../state/navigationState.js";
+import { compileRoutes, matchLink, parseLink } from "./linkPaths.js";
+import { getPendingLink, setPendingLink, setPendingLinkOpener } from "./pendingLinks.js";
+
+// The links of the app: the one that launched it, which can make the first root, and those that come while it runs.
+// A link runs once the first root is shown and the native side told which screen shows, so its commands act from
+// there; one whose `when` is false waits as the pending link. What the app's callbacks throw goes to `onError`.
+
+// The routes as the app wrote them; each is read as a `Route`.
+
+let config;
+let roots;
+let routes = [];
+let onError;
+// The links run at once. Before, they wait in `early`.
+let started = false;
+const early = [];
+// The launch URL as the native side gave it, and matched: kept for every try of the first start.
+let launchUrl;
+let launch;
+let pendingCheck = false;
+// The links whose `when` threw, reported once each.
+const whenFailed = new Set();
+
+/** Starts the links of the app, once per JavaScript runtime. */
+export function setupLinking(linking, options) {
+  config = linking;
+  roots = options.roots;
+  onError = options.onError;
+  // On iOS the first React content to appear sends the waiting links to Linking as `url` events; asked now, before
+  // a warning can show LogBox, the launch link stays for the first root. Android reads it from the activity, which
+  // is there once the native side launched.
+  if (Platform.OS === 'ios') takeLaunchUrl();
+  routes = compileRoutes(Object.keys(linking.routes));
+  Linking.addEventListener('url', ({
+    url
+  }) => receive(url));
+  subscribeAppContext(openPendingWhenAllowed);
+  setPendingLinkOpener(link => run(link, routeOf(link), false));
+}
+
+/**
+ * The link that launched the app, matched as the app starts (`unmatched` may run commands then); the same one for
+ * every try of the first start.
+ */
+export function launchLink() {
+  launch ??= takeLaunchUrl().then(url => url ? find(url) : undefined);
+  return launch;
+}
+function takeLaunchUrl() {
+  // A link the native side can't read (a broken intent of another app) is no link: the start goes on.
+  launchUrl ??= config ? getLaunchLink().catch(() => null) : Promise.resolve(null);
+  return launchUrl;
+}
+
+/**
+ * The first root the launch link makes with `start`, when its route has one and may run now. `handled`: the link
+ * needs nothing more — it made the root, or its `start` failed and went to `onError`.
+ */
+export function launchRoot(link) {
+  if (!link) return {
+    handled: false
+  };
+  const route = routeOf(link);
+  if (typeof route !== 'object' || !route.start || !allowed(route, link.url)) {
+    return {
+      handled: false
+    };
+  }
+  try {
+    return {
+      root: toRoot(route.start(link.params, infoOf(link, true))),
+      handled: true
+    };
+  } catch (error) {
+    report(error, link.url);
+    return {
+      handled: true
+    };
+  }
+}
+
+/** A link that failed outside its route: the native side couldn't set the root its `start` made. */
+export function reportLink(error, url) {
+  report(error, url);
+}
+
+/**
+ * The first root is shown: once the native side told its screen, the launch link runs unless it was handled, then the
+ * links that came meanwhile.
+ */
+export async function linksStarted(link, handled, stateBefore) {
+  // A first frame can take long on a slow device: the limit only keeps a lost state from holding the links.
+  await whenScreenAfter(stateBefore, 3000);
+  started = true;
+  if (link && !handled) handle(link, true);
+  early.splice(0).forEach(({
+    link: next,
+    initial
+  }) => handle(next, initial));
+}
+
+/** The native side launched again (Android: a new activity): its link runs as in a running app. */
+export async function linksRelaunched(stateBefore) {
+  const url = await getLaunchLink().catch(() => null);
+  const link = url ? find(url) : undefined;
+  if (!link) return;
+  await whenScreenAfter(stateBefore, 3000);
+  handle(link, true);
+}
+function receive(url) {
+  const link = find(url);
+  if (!link) return;
+  if (started) handle(link, false);else early.push({
+    link,
+    initial: false
+  });
+}
+function find(url) {
+  const parsed = parseLink(url, config?.prefixes);
+  const link = parsed && matchLink(parsed, routes);
+  if (link) return link;
+  try {
+    if (config?.unmatched) config.unmatched(url);else if (__DEV__) console.warn(`[navigation] No route of linking takes '${url}'`);
+  } catch (error) {
+    report(error, url);
+  }
+  return undefined;
+}
+function routeOf(link) {
+  return config.routes[link.route];
+}
+
+// A `when` that throws keeps the link waiting; its error is reported once for the link.
+function allowed(route, url) {
+  const when = typeof route === 'object' && route.when || config?.when;
+  try {
+    return !when || when(getAppContext());
+  } catch (error) {
+    if (!whenFailed.has(url)) {
+      whenFailed.add(url);
+      report(error, url);
+    }
+    return false;
+  }
+}
+function handle(link, initial) {
+  const route = routeOf(link);
+  if (allowed(route, link.url)) {
+    run(link, route, initial);
+    return;
+  }
+  const {
+    url,
+    path,
+    route: pattern,
+    params,
+    query
+  } = link;
+  setPendingLink({
+    url,
+    path,
+    route: pattern,
+    params,
+    query
+  });
+}
+
+/** Runs a route as in a running app: `open`, the screen pushed, or `start` shown with `switchTo`. */
+async function run(link, route, initial) {
+  const info = infoOf(link, initial);
+  try {
+    if (typeof route === 'string') {
+      await navigation.push(route, {
+        props: {
+          ...link.query,
+          ...link.params
+        }
+      });
+    } else if (typeof route === 'function') {
+      await route(link.params, info);
+    } else if (route.open) {
+      await route.open(link.params, info);
+    } else if (route.start) {
+      await switchToTarget(route.start(link.params, info));
+    }
+  } catch (error) {
+    report(error, link.url);
+  }
+}
+function switchToTarget(target) {
+  const switchTo = navigation.switchTo;
+  if (Array.isArray(target)) return switchTo(target[0], ...target.slice(1));
+  return switchTo(target);
+}
+function toRoot(target) {
+  if (typeof target === 'string') return resolveRoot(roots, target, []);
+  if (Array.isArray(target)) return resolveRoot(roots, target[0], target.slice(1));
+  return buildRoot(target);
+}
+function infoOf(link, initial) {
+  return {
+    url: link.url,
+    path: link.path,
+    query: link.query,
+    initial
+  };
+}
+function report(error, url) {
+  if (onError) onError(error, url);else console.error(`[navigation] The link '${url}' failed`, error);
+}
+
+// A waiting link runs once the context lets it, after the commands of the same change — the `switchTo` that follows
+// `setContext` at a sign-in — and after the native side told the screen they show, so the link opens in the new root.
+function openPendingWhenAllowed() {
+  if (config?.pending === 'manual' || pendingCheck || !getPendingLink()) return;
+  pendingCheck = true;
+  const stateBefore = getNavigationState();
+  const commandsBefore = commandsStarted();
+  setTimeout(async () => {
+    try {
+      await whenCommandsSettle(commandsBefore);
+      if (commandsStarted() !== commandsBefore) await whenScreenAfter(stateBefore, 1000);
+    } finally {
+      pendingCheck = false;
+    }
+    const link = getPendingLink();
+    if (!link || !allowed(routeOf(link), link.url)) return;
+    setPendingLink(null);
+    run({
+      ...link
+    }, routeOf(link), false);
+  }, 0);
+}
+//# sourceMappingURL=linking.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Linking","Platform","getLaunchLink","resolveRoot","commandsStarted","whenCommandsSettle","getAppContext","subscribeAppContext","buildRoot","navigation","getNavigationState","whenScreenAfter","compileRoutes","matchLink","parseLink","getPendingLink","setPendingLink","setPendingLinkOpener","config","roots","routes","onError","started","early","launchUrl","launch","pendingCheck","whenFailed","Set","setupLinking","linking","options","OS","takeLaunchUrl","Object","keys","addEventListener","url","receive","openPendingWhenAllowed","link","run","routeOf","launchLink","then","find","undefined","catch","Promise","resolve","launchRoot","handled","route","start","allowed","root","toRoot","params","infoOf","error","report","reportLink","linksStarted","stateBefore","handle","splice","forEach","next","initial","linksRelaunched","push","parsed","prefixes","unmatched","__DEV__","console","warn","when","has","add","path","pattern","query","info","props","open","switchToTarget","target","switchTo","Array","isArray","slice","pending","commandsBefore","setTimeout"],"sourceRoot":"../../../../src","sources":["api/linking/linking.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/linking/pendingLinks.js

@@ -0,0 +1,34 @@
+"use strict";
+
+// The link that waits for `when` of `linking`: one, the latest. The navigation and `usePendingLink` read it here; the
+// linking runs it through the opener it gives at its start.
+let pending = null;
+const listeners = new Set();
+let opener;
+export function getPendingLink() {
+  return pending;
+}
+export function setPendingLink(link) {
+  if (pending === link) return;
+  pending = link;
+  listeners.forEach(listener => listener());
+}
+export function subscribePendingLink(listener) {
+  listeners.add(listener);
+  return () => {
+    listeners.delete(listener);
+  };
+}
+export function setPendingLinkOpener(open) {
+  opener = open;
+}
+
+/** Runs the waiting link now, whatever `when` says, and forgets it; false without one. */
+export async function openPendingLink() {
+  const link = pending;
+  if (!link || !opener) return false;
+  setPendingLink(null);
+  await opener(link);
+  return true;
+}
+//# sourceMappingURL=pendingLinks.js.map

package/lib/module/api/linking/pendingLinks.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["pending","listeners","Set","opener","getPendingLink","setPendingLink","link","forEach","listener","subscribePendingLink","add","delete","setPendingLinkOpener","open","openPendingLink"],"sourceRoot":"../../../../src","sources":["api/linking/pendingLinks.ts"],"mappings":";;AAEA;AACA;AACA,IAAIA,OAA2B,GAAG,IAAI;AACtC,MAAMC,SAAS,GAAG,IAAIC,GAAG,CAAa,CAAC;AACvC,IAAIC,MAA0D;AAE9D,OAAO,SAASC,cAAcA,CAAA,EAAuB;EACnD,OAAOJ,OAAO;AAChB;AAEA,OAAO,SAASK,cAAcA,CAACC,IAAwB,EAAQ;EAC7D,IAAIN,OAAO,KAAKM,IAAI,EAAE;EACtBN,OAAO,GAAGM,IAAI;EACdL,SAAS,CAACM,OAAO,CAAEC,QAAQ,IAAKA,QAAQ,CAAC,CAAC,CAAC;AAC7C;AAEA,OAAO,SAASC,oBAAoBA,CAACD,QAAoB,EAAc;EACrEP,SAAS,CAACS,GAAG,CAACF,QAAQ,CAAC;EACvB,OAAO,MAAM;IACXP,SAAS,CAACU,MAAM,CAACH,QAAQ,CAAC;EAC5B,CAAC;AACH;AAEA,OAAO,SAASI,oBAAoBA,CAACC,IAA0C,EAAQ;EACrFV,MAAM,GAAGU,IAAI;AACf;;AAEA;AACA,OAAO,eAAeC,eAAeA,CAAA,EAAqB;EACxD,MAAMR,IAAI,GAAGN,OAAO;EACpB,IAAI,CAACM,IAAI,IAAI,CAACH,MAAM,EAAE,OAAO,KAAK;EAClCE,cAAc,CAAC,IAAI,CAAC;EACpB,MAAMF,MAAM,CAACG,IAAI,CAAC;EAClB,OAAO,IAAI;AACb","ignoreList":[]}

package/lib/module/api/linking/types.js

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

package/lib/module/api/linking/types.js.map

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

package/lib/module/api/navigation.js

@@ -0,0 +1,105 @@
+"use strict";
+
+import { setRoot } from "../engine/commands.js";
+import { withSlots } from "../engine/slots.js";
+import { getActiveApp } from "./app/activeApp.js";
+import { resolveRoot } from "./app/roots.js";
+import * as commands from "./commands/commands.js";
+import { command } from "./commands/errors.js";
+import { closeMenu, openMenu } from "./commands/sideMenus.js";
+import { onNavigationEvent } from "./events/navigationEvents.js";
+import { buildRoot } from "./layout/Root.js";
+import { getNavigationState, whenTabShows } from "./state/navigationState.js";
+import { getAppContext, setAppContext } from "./context/appContext.js";
+import { getPendingLink, openPendingLink, setPendingLink } from "./linking/pendingLinks.js";
+import { setDirection, setTheme } from "./theme/theme.js";
+
+/** The screens of a stack, each checked against the screens of the app. */
+
+/** The started app; a command made while it starts comes after its first root. */
+async function startedApp() {
+  const app = getActiveApp();
+  if (!app) {
+    throw new Error('[navigation] A command before the app started: register it with AppRegistry.registerComponent');
+  }
+  await app.mounted;
+  return app;
+}
+function switchTo(target, ...param) {
+  return command('switchTo', async () => {
+    const app = await startedApp();
+    const root = typeof target === 'string' ? resolveRoot(app.roots, target, param) : buildRoot(target);
+    await withSlots(() => setRoot(root));
+  });
+}
+
+/** The screen the user sees, which the stack commands outside the screens act from. */
+async function currentScreen() {
+  await startedApp();
+  const screen = getNavigationState().screen;
+  if (!screen) throw new Error('[navigation] No screen shows, so there is no stack to act on');
+  return screen.id;
+}
+
+/** A check of the screen the user sees; false while none shows. */
+function seenScreen(check) {
+  const screen = getNavigationState().screen;
+  return screen ? check(screen.id) : false;
+}
+
+/** A command from the screen the user sees; an error says which command it was. */
+function fromCurrent(name, run) {
+  return command(name, async () => run(await currentScreen()));
+}
+
+/** A command that needs no screen, only the app started: made while it starts, it comes after the first root. */
+function afterStart(name, run) {
+  return command(name, async () => {
+    await startedApp();
+    return run();
+  });
+}
+
+/** The navigation of the app, for anywhere, outside the screens too. */
+export const navigation = {
+  switchTo,
+  push: (name, config) => fromCurrent('push', id => commands.push(id, name, config)),
+  pop: () => fromCurrent('pop', id => commands.pop(id)),
+  popTo: screenId => afterStart('popTo', () => commands.popTo(screenId)),
+  popToRoot: () => fromCurrent('popToRoot', id => commands.popToRoot(id)),
+  replace: (name, config) => fromCurrent('replace', id => commands.replace(id, name, config)),
+  canPop: () => seenScreen(id => commands.canPop(id)),
+  canDismiss: () => seenScreen(id => commands.canDismiss(id)),
+  goBack: () => fromCurrent('goBack', id => commands.goBack(id)),
+  showColumn: column => fromCurrent('showColumn', id => commands.setColumnShown(id, column, true)),
+  hideColumn: column => fromCurrent('hideColumn', id => commands.setColumnShown(id, column, false)),
+  openMenu: side => fromCurrent('openMenu', id => openMenu(id, side)),
+  closeMenu: () => fromCurrent('closeMenu', id => closeMenu(id)),
+  canGoBack: () => seenScreen(id => commands.canPop(id) || commands.canDismiss(id)),
+  setStack: (...entries) => fromCurrent('setStack', id => commands.setStack(id, entries)),
+  showInColumn: (name, config) => fromCurrent('showInColumn', id => commands.showInColumn(id, name, config)),
+  showModal: (name, config) => afterStart('showModal', () => commands.showModal(name, config)),
+  dismissModal: modalId => afterStart('dismissModal', () => commands.dismissModal(modalId)),
+  dismissAllModals: () => afterStart('dismissAllModals', () => commands.dismissAllModals()),
+  showOverlay: (name, config) => afterStart('showOverlay', () => commands.showOverlay(name, config)),
+  dismissOverlay: overlayId => afterStart('dismissOverlay', () => commands.dismissOverlay(overlayId)),
+  dismissAllOverlays: () => afterStart('dismissAllOverlays', () => commands.dismissAllOverlays()),
+  // Resolves once the state shows the tab, so the next command acts in it.
+  selectTab: tab => fromCurrent('selectTab', async id => {
+    const shown = whenTabShows(tab);
+    commands.selectTab(id, tab);
+    await shown;
+  }),
+  // A tab with an id needs no screen, only a started app.
+  setTabBadge: (badge, tab) => tab ? afterStart('setTabBadge', async () => commands.setTabBadge(tab, badge, tab)) : fromCurrent('setTabBadge', async id => commands.setTabBadge(id, badge)),
+  setTheme,
+  setDirection,
+  getContext: () => getAppContext(),
+  setContext: next => setAppContext(next),
+  getState: getNavigationState,
+  getPendingLink,
+  openPendingLink,
+  clearPendingLink: () => setPendingLink(null),
+  on: onNavigationEvent
+};
+//# sourceMappingURL=navigation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["setRoot","withSlots","getActiveApp","resolveRoot","commands","command","closeMenu","openMenu","onNavigationEvent","buildRoot","getNavigationState","whenTabShows","getAppContext","setAppContext","getPendingLink","openPendingLink","setPendingLink","setDirection","setTheme","startedApp","app","Error","mounted","switchTo","target","param","root","roots","currentScreen","screen","id","seenScreen","check","fromCurrent","name","run","afterStart","navigation","push","config","pop","popTo","screenId","popToRoot","replace","canPop","canDismiss","goBack","showColumn","column","setColumnShown","hideColumn","side","canGoBack","setStack","entries","showInColumn","showModal","dismissModal","modalId","dismissAllModals","showOverlay","dismissOverlay","overlayId","dismissAllOverlays","selectTab","tab","shown","setTabBadge","badge","getContext","setContext","next","getState","clearPendingLink","on"],"sourceRoot":"../../../src","sources":["api/navigation.ts"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,158 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import { mergeOptions } from "../../engine/mergeOptions.js";
+
+/**
+ * The modifiers of the options of a screen. Each modifier returns a copy with the options merged over the ones before,
+ * so the last one wins; `options()` takes anything the modifiers don't cover.
+ */
+export class OptionsChain {
+  constructor(built = {}) {
+    this.built = built;
+  }
+
+  /** A copy with other options. */
+
+  /** Any options. */
+  options(options) {
+    return this.withOptions(mergeOptions(this.built, options));
+  }
+
+  // Top bar
+
+  topBar(topBar) {
+    return this.options({
+      topBar
+    });
+  }
+
+  /** #### (iOS specific) */
+  largeTitle(largeTitle = true) {
+    return this.topBar({
+      largeTitle: typeof largeTitle === 'boolean' ? {
+        visible: largeTitle
+      } : largeTitle
+    });
+  }
+  backButton(backButton) {
+    return this.topBar({
+      backButton
+    });
+  }
+
+  /** Hides the top bar; `hideTopBar(fullScreen)` takes the value from state, `false` shows it. */
+  hideTopBar(hidden = true) {
+    return this.topBar({
+      visible: !hidden
+    });
+  }
+
+  /** Hides the tab bar under this screen; `false` shows it. */
+  hideBottomTabs(hidden = true) {
+    return this.bottomTabs({
+      visible: !hidden
+    });
+  }
+
+  // Screen and system
+
+  layout(layout) {
+    return this.options({
+      layout
+    });
+  }
+
+  /**
+   * The edges on which the screen keeps its content out of its safe area (bars, status bar, home indicator, cutout);
+   * none with no edge. Without it: all four on Android, and on iOS every edge but those where the content goes under
+   * a bar. On iOS a large title leaves the top out by itself.
+   */
+  safeArea(...edges) {
+    return this.layout({
+      safeAreaEdges: edges
+    });
+  }
+  backgroundColor(backgroundColor) {
+    return this.layout({
+      backgroundColor
+    });
+  }
+  orientation(...orientation) {
+    return this.layout({
+      orientation
+    });
+  }
+
+  /** `false`: the bars of the screen stay horizontal on iPhone Duo. #### (iOS specific) */
+  verticalBars(verticalBars = true) {
+    return this.layout({
+      verticalBars
+    });
+  }
+  statusBar(statusBar) {
+    return this.options({
+      statusBar
+    });
+  }
+  navigationBar(navigationBar) {
+    return this.options({
+      navigationBar
+    });
+  }
+
+  /** #### (iOS specific) */
+  scrollEdgeEffect(scrollEdgeEffect) {
+    return this.options({
+      scrollEdgeEffect
+    });
+  }
+
+  // Behavior
+
+  /** #### (iOS specific) */
+  popGesture(popGesture) {
+    return this.options({
+      popGesture
+    });
+  }
+  hardwareBackButton(hardwareBackButton) {
+    return this.options({
+      hardwareBackButton
+    });
+  }
+
+  // Transitions
+
+  animations(animations) {
+    return this.options({
+      animations
+    });
+  }
+
+  // The containers, while a screen with these options is on top
+
+  bottomTabs(bottomTabs) {
+    return this.options({
+      bottomTabs
+    });
+  }
+  sideMenu(sideMenu) {
+    return this.options({
+      sideMenu
+    });
+  }
+
+  // Platforms
+
+  /** Modifiers for iOS only. */
+  ios(build) {
+    return Platform.OS === 'ios' ? build(this) : this;
+  }
+
+  /** Modifiers for Android only. */
+  android(build) {
+    return Platform.OS === 'android' ? build(this) : this;
+  }
+}
+//# sourceMappingURL=OptionsChain.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","mergeOptions","OptionsChain","constructor","built","options","withOptions","topBar","largeTitle","visible","backButton","hideTopBar","hidden","hideBottomTabs","bottomTabs","layout","safeArea","edges","safeAreaEdges","backgroundColor","orientation","verticalBars","statusBar","navigationBar","scrollEdgeEffect","popGesture","hardwareBackButton","animations","sideMenu","ios","build","OS","android"],"sourceRoot":"../../../../src","sources":["api/options/OptionsChain.ts"],"mappings":";;AAAA,SAASA,QAAQ,QAAQ,cAAc;AAkBvC,SAASC,YAAY,QAAQ,8BAA2B;;AAExD;AACA;AACA;AACA;AACA,OAAO,MAAeC,YAAY,CAAC;EACjCC,WAAWA,CAAoBC,KAAc,GAAG,CAAC,CAAC,EAAE;IAAA,KAArBA,KAAc,GAAdA,KAAc;EAAQ;;EAErD;;EAGA;EACAC,OAAOA,CAACA,OAAgB,EAAQ;IAC9B,OAAO,IAAI,CAACC,WAAW,CAACL,YAAY,CAAC,IAAI,CAACG,KAAK,EAAEC,OAAO,CAAC,CAAC;EAC5D;;EAEA;;EAEAE,MAAMA,CAACA,MAAqB,EAAQ;IAClC,OAAO,IAAI,CAACF,OAAO,CAAC;MAAEE;IAAO,CAAC,CAAC;EACjC;;EAEA;EACAC,UAAUA,CAACA,UAA6C,GAAG,IAAI,EAAQ;IACrE,OAAO,IAAI,CAACD,MAAM,CAAC;MACjBC,UAAU,EAAE,OAAOA,UAAU,KAAK,SAAS,GAAG;QAAEC,OAAO,EAAED;MAAW,CAAC,GAAGA;IAC1E,CAAC,CAAC;EACJ;EAEAE,UAAUA,CAACA,UAAmC,EAAQ;IACpD,OAAO,IAAI,CAACH,MAAM,CAAC;MAAEG;IAAW,CAAC,CAAC;EACpC;;EAEA;EACAC,UAAUA,CAACC,MAAM,GAAG,IAAI,EAAQ;IAC9B,OAAO,IAAI,CAACL,MAAM,CAAC;MAAEE,OAAO,EAAE,CAACG;IAAO,CAAC,CAAC;EAC1C;;EAEA;EACAC,cAAcA,CAACD,MAAM,GAAG,IAAI,EAAQ;IAClC,OAAO,IAAI,CAACE,UAAU,CAAC;MAAEL,OAAO,EAAE,CAACG;IAAO,CAAC,CAAC;EAC9C;;EAEA;;EAEAG,MAAMA,CAACA,MAAqB,EAAQ;IAClC,OAAO,IAAI,CAACV,OAAO,CAAC;MAAEU;IAAO,CAAC,CAAC;EACjC;;EAEA;AACF;AACA;AACA;AACA;EACEC,QAAQA,CAAC,GAAGC,KAAqB,EAAQ;IACvC,OAAO,IAAI,CAACF,MAAM,CAAC;MAAEG,aAAa,EAAED;IAAM,CAAC,CAAC;EAC9C;EAEAE,eAAeA,CAACA,eAAsB,EAAQ;IAC5C,OAAO,IAAI,CAACJ,MAAM,CAAC;MAAEI;IAAgB,CAAC,CAAC;EACzC;EAEAC,WAAWA,CAAC,GAAGA,WAAgC,EAAQ;IACrD,OAAO,IAAI,CAACL,MAAM,CAAC;MAAEK;IAAY,CAAC,CAAC;EACrC;;EAEA;EACAC,YAAYA,CAACA,YAAY,GAAG,IAAI,EAAQ;IACtC,OAAO,IAAI,CAACN,MAAM,CAAC;MAAEM;IAAa,CAAC,CAAC;EACtC;EAEAC,SAASA,CAACA,SAA2B,EAAQ;IAC3C,OAAO,IAAI,CAACjB,OAAO,CAAC;MAAEiB;IAAU,CAAC,CAAC;EACpC;EAEAC,aAAaA,CAACA,aAAmC,EAAQ;IACvD,OAAO,IAAI,CAAClB,OAAO,CAAC;MAAEkB;IAAc,CAAC,CAAC;EACxC;;EAEA;EACAC,gBAAgBA,CAACA,gBAAyC,EAAQ;IAChE,OAAO,IAAI,CAACnB,OAAO,CAAC;MAAEmB;IAAiB,CAAC,CAAC;EAC3C;;EAEA;;EAEA;EACAC,UAAUA,CAACA,UAA4B,EAAQ;IAC7C,OAAO,IAAI,CAACpB,OAAO,CAAC;MAAEoB;IAAW,CAAC,CAAC;EACrC;EAEAC,kBAAkBA,CAACA,kBAA6C,EAAQ;IACtE,OAAO,IAAI,CAACrB,OAAO,CAAC;MAAEqB;IAAmB,CAAC,CAAC;EAC7C;;EAEA;;EAEAC,UAAUA,CAACA,UAAkD,EAAQ;IACnE,OAAO,IAAI,CAACtB,OAAO,CAAC;MAAEsB;IAAW,CAAC,CAAC;EACrC;;EAEA;;EAEAb,UAAUA,CAACA,UAA6B,EAAQ;IAC9C,OAAO,IAAI,CAACT,OAAO,CAAC;MAAES;IAAW,CAAC,CAAC;EACrC;EAEAc,QAAQA,CAACA,QAAyB,EAAQ;IACxC,OAAO,IAAI,CAACvB,OAAO,CAAC;MAAEuB;IAAS,CAAC,CAAC;EACnC;;EAEA;;EAEA;EACAC,GAAGA,CAACC,KAA8B,EAAQ;IACxC,OAAO9B,QAAQ,CAAC+B,EAAE,KAAK,KAAK,GAAGD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI;EACnD;;EAEA;EACAE,OAAOA,CAACF,KAA8B,EAAQ;IAC5C,OAAO9B,QAAQ,CAAC+B,EAAE,KAAK,SAAS,GAAGD,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI;EACvD;AACF","ignoreList":[]}

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

@@ -0,0 +1,83 @@
+"use strict";
+
+import { OptionsChain } from "./OptionsChain.js";
+
+/** The toolbar, with buttons that take `onPress`. */
+
+/**
+ * The options of a screen as a chain: the modifiers of `OptionsChain` and those that belong to one screen only, such
+ * as its title and buttons.
+ */
+export class ScreenOptions extends OptionsChain {
+  withOptions(options) {
+    return new ScreenOptions(options);
+  }
+
+  /** The options built by a chain. */
+  static read(options) {
+    return options.built;
+  }
+  title(title) {
+    return this.topBar({
+      title: typeof title === 'string' ? {
+        text: title
+      } : title
+    });
+  }
+  subtitle(subtitle) {
+    return this.topBar({
+      subtitle: typeof subtitle === 'string' ? {
+        text: subtitle
+      } : subtitle
+    });
+  }
+
+  /** Buttons take `onPress`. */
+  leftButtons(...leftButtons) {
+    return this.topBar({
+      leftButtons
+    });
+  }
+
+  /** Buttons take `onPress`. */
+  rightButtons(...rightButtons) {
+    return this.topBar({
+      rightButtons
+    });
+  }
+
+  /** #### (iOS specific) Buttons take `onPress`. */
+  centerButtons(...centerButtons) {
+    return this.topBar({
+      centerButtons
+    });
+  }
+  searchBar(searchBar) {
+    return this.topBar({
+      searchBar
+    });
+  }
+
+  /** #### (iOS specific) Buttons take `onPress`. */
+  toolbar(toolbar) {
+    return this.options({
+      toolbar
+    });
+  }
+
+  /** #### (Android specific) The FAB and its `actions` take `onPress`. */
+  fab(fab) {
+    return this.options({
+      fab: fab
+    });
+  }
+  keyCommands(...keyCommands) {
+    return this.options({
+      keyCommands
+    });
+  }
+}
+export function readScreenOptions(options) {
+  return ScreenOptions.read(options);
+}
+//# sourceMappingURL=ScreenOptions.js.map