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

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

@@ -0,0 +1,25 @@
+"use strict";
+
+import { useCallback, useSyncExternalStore } from 'react';
+import { getScreenInsets, subscribeScreenInsets } from "../safeArea/screenInsets.js";
+import { useScreen } from "./screenHooks.js";
+
+/**
+ * How much of this screen's content the bars and the system still cover on each side, past what the screen keeps its
+ * content off itself (`layout.safeAreaEdges`): 0 on an edge the screen pads, the whole inset on an edge its content goes
+ * under — under a top bar, under the vertical bar at the side of iPhone Duo, every edge with `safeAreaEdges: []`. A list
+ * adds exactly this to its own padding. The native side measures every screen on its own, also the screens of
+ * `appProvider`.
+ *
+ * @example
+ * const insets = useSafeAreaInsets();
+ * <ScrollView contentContainerStyle={{ paddingLeft: 16 + insets.left, paddingRight: 16 + insets.right }} />
+ */
+export function useSafeAreaInsets() {
+  const {
+    id
+  } = useScreen();
+  const subscribe = useCallback(onChange => subscribeScreenInsets(id, onChange), [id]);
+  return useSyncExternalStore(subscribe, () => getScreenInsets(id));
+}
+//# sourceMappingURL=useSafeAreaInsets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useSyncExternalStore","getScreenInsets","subscribeScreenInsets","useScreen","useSafeAreaInsets","id","subscribe","onChange"],"sourceRoot":"../../../../src","sources":["api/hooks/useSafeAreaInsets.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,oBAAoB,QAAQ,OAAO;AACzD,SAA0BC,eAAe,EAAEC,qBAAqB,QAAQ,6BAA0B;AAClG,SAASC,SAAS,QAAQ,kBAAe;;AAEzC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAA,EAAe;EAC9C,MAAM;IAAEC;EAAG,CAAC,GAAGF,SAAS,CAAC,CAAC;EAC1B,MAAMG,SAAS,GAAGP,WAAW,CAC1BQ,QAAoB,IAAKL,qBAAqB,CAACG,EAAE,EAAEE,QAAQ,CAAC,EAC7D,CAACF,EAAE,CACL,CAAC;EACD,OAAOL,oBAAoB,CAACM,SAAS,EAAE,MAAML,eAAe,CAACI,EAAE,CAAC,CAAC;AACnE","ignoreList":[]}

package/lib/module/api/index.js

@@ -0,0 +1,26 @@
+"use strict";
+
+export { AppRegistry } from "./app/AppRegistry.js";
+export { createNavigation } from "./app/createNavigation.js";
+export { Root } from "./layout/Root.js";
+export { Screen } from "./layout/Screen.js";
+export { SideMenu } from "./layout/SideMenu.js";
+export { SplitView } from "./layout/SplitView.js";
+export { Stack } from "./layout/Stack.js";
+export { Tab, Tabs } from "./layout/Tabs.js";
+export { useFocusEffect, useIsFocused, useNavigationButton, useNavigationEvent, useNavigationState, usePreventLeave, useScreen, useScreenAppear, useScreenDisappear, useScreenEvent, useScreenOptions, useSearchBar, useTabPress } from "./hooks/screenHooks.js";
+export { useAppContext, useNavigationTheme } from "./hooks/appHooks.js";
+export { useSafeAreaInsets } from "./hooks/useSafeAreaInsets.js";
+export { useReservedRegions } from "./hooks/useReservedRegions.js";
+export { useArrangement } from "./hooks/useArrangement.js";
+export { useHinge, useHingeChange } from "./hooks/useHinge.js";
+export { usePreview } from "./hooks/usePreview.js";
+export { usePendingLink } from "./hooks/usePendingLink.js";
+export { useSplash } from "./app/splash.js";
+export { screenNavigation, useNavigation } from "./hooks/useNavigation.js";
+export { navigation } from "./navigation.js";
+export { defineScreen } from "./screens/defineScreen.js";
+export { TestIDs } from "./testIDs.js";
+export { nativeScreen } from "./screens/nativeScreens.js";
+export { defineArrangement } from "./screens/arrangement.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["AppRegistry","createNavigation","Root","Screen","SideMenu","SplitView","Stack","Tab","Tabs","useFocusEffect","useIsFocused","useNavigationButton","useNavigationEvent","useNavigationState","usePreventLeave","useScreen","useScreenAppear","useScreenDisappear","useScreenEvent","useScreenOptions","useSearchBar","useTabPress","useAppContext","useNavigationTheme","useSafeAreaInsets","useReservedRegions","useArrangement","useHinge","useHingeChange","usePreview","usePendingLink","useSplash","screenNavigation","useNavigation","navigation","defineScreen","TestIDs","nativeScreen","defineArrangement"],"sourceRoot":"../../../src","sources":["api/index.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,sBAAmB;AAC/C,SAASC,gBAAgB,QAAQ,2BAAwB;AAOzD,SAASC,IAAI,QAAQ,kBAAe;AAEpC,SAASC,MAAM,QAAQ,oBAAiB;AAExC,SAASC,QAAQ,QAAQ,sBAAmB;AAE5C,SAASC,SAAS,QAAQ,uBAAoB;AAE9C,SAASC,KAAK,QAAQ,mBAAgB;AAEtC,SAASC,GAAG,EAAEC,IAAI,QAAQ,kBAAe;AA+CzC,SACEC,cAAc,EACdC,YAAY,EACZC,mBAAmB,EACnBC,kBAAkB,EAClBC,kBAAkB,EAClBC,eAAe,EACfC,SAAS,EACTC,eAAe,EACfC,kBAAkB,EAClBC,cAAc,EACdC,gBAAgB,EAChBC,YAAY,EACZC,WAAW,QACN,wBAAqB;AAE5B,SAASC,aAAa,EAAEC,kBAAkB,QAAQ,qBAAkB;AACpE,SAASC,iBAAiB,QAAQ,8BAA2B;AAC7D,SAASC,kBAAkB,QAAQ,+BAA4B;AAC/D,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,QAAQ,EAAEC,cAAc,QAAQ,qBAAkB;AAC3D,SAASC,UAAU,QAAQ,uBAAoB;AAC/C,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,SAAS,QAAQ,iBAAc;AAYxC,SAASC,gBAAgB,EAAEC,aAAa,QAAQ,0BAAuB;AAEvE,SAASC,UAAU,QAAQ,iBAAc;AAEzC,SAASC,YAAY,QAAQ,2BAAwB;AACrD,SAASC,OAAO,QAAQ,cAAW;AACnC,SAASC,YAAY,QAAQ,4BAAyB;AAEtD,SAASC,iBAAiB,QAAQ,0BAAuB","ignoreList":[]}

package/lib/module/api/layout/Root.js

@@ -0,0 +1,121 @@
+"use strict";
+
+import { presetContent } from "../commands/transitions.js";
+import { buildContent, isLayoutElement, layoutOptions, mergeLayoutOptions } from "./element.js";
+
+/**
+ * How a root replaces the one before: a preset the new root comes in with, or its own `enter` and `exit`. `'platform'`
+ * is the platform's own transition, `'none'` shows the new root at once, once its content is drawn, whatever setRoot
+ * animation the app's options set.
+ */
+
+const ROOT_DURATION = 250;
+function rootAnimation(transition) {
+  if (typeof transition !== 'string') return transition;
+  // At once, but not empty: without the wait Android would show the new root before React draws it. Both sides are off,
+  // so a setRoot animation of the app's default options doesn't play either.
+  if (transition === 'none') {
+    return {
+      enter: {
+        enabled: false,
+        waitForRender: true
+      },
+      exit: {
+        enabled: false
+      }
+    };
+  }
+  const content = presetContent(transition, ROOT_DURATION);
+  return content && {
+    enter: content.show
+  };
+}
+const BUILD_ROOT = Symbol('apexnative.navigation.buildRoot');
+
+/** A root with the modals shown over it, and how it replaces the one before. */
+export class RootElement {
+  constructor(root, modals = [], rootTransition = 'platform') {
+    this.root = root;
+    this.modals = modals;
+    this.rootTransition = rootTransition;
+  }
+
+  /**
+   * A modal over the root once it is in place, such as the screen a notification opens at a cold start. It comes with
+   * its animation; each one goes over the one before, and the ones under the last come at once.
+   */
+  modal(modal) {
+    return new RootElement(this.root, [...this.modals, modal], this.rootTransition);
+  }
+
+  /**
+   * How the root replaces the one before: `'platform'` (the default), `'fade'`, `'slideUp'`, `'slideFromEnd'` or
+   * `'scale'` (250 ms), `'none'` at once, or `{ enter, exit }` of its own. `'platform'` is the platform's transition: a
+   * cross dissolve on iOS, the fade through on Android. The first root of the app comes in place of the splash screen:
+   * at once with `'platform'` and `'none'`, over the splash with a preset or `{ enter, exit }`.
+   */
+  transition(transition) {
+    return new RootElement(this.root, this.modals, transition);
+  }
+  [BUILD_ROOT]() {
+    const animation = rootAnimation(this.rootTransition);
+    const root = buildContent(this.root, 'stack');
+    return {
+      root: animation ? mergeLayoutOptions(root, {
+        animations: {
+          setRoot: animation
+        }
+      }) : root,
+      ...(this.modals.length > 0 && {
+        modals: this.modals.map(modal => buildContent(modal, 'stack'))
+      })
+    };
+  }
+}
+
+// The type of an element carries the screens it shows.
+
+export function Root(root) {
+  return new RootElement(root);
+}
+
+/** What `root`, `roots` and `switchTo` take: content, `Root(…)`, or a root as JSON. */
+
+/** The screens a root shows; a root as JSON is not checked. */
+
+export function buildRoot(value) {
+  if (value instanceof RootElement) return value[BUILD_ROOT]();
+  if (isLayoutRoot(value)) return value;
+  return {
+    root: buildContent(value, 'stack')
+  };
+}
+
+/**
+ * The root with `transition` when it has no setRoot animation of its own: how the first root replaces the app's
+ * splash in React Native. It comes in once its content is drawn, unless the transition says otherwise: Android
+ * otherwise starts a root's own animation at once, over a screen still empty.
+ */
+export function withDefaultTransition(layout, transition) {
+  const animation = rootAnimation(transition);
+  if (!animation || layoutOptions(layout.root)?.animations?.setRoot) return layout;
+  const enter = {
+    ...animation.enter,
+    waitForRender: animation.enter?.waitForRender ?? true
+  };
+  return {
+    ...layout,
+    root: mergeLayoutOptions(layout.root, {
+      animations: {
+        setRoot: {
+          ...animation,
+          enter
+        }
+      }
+    })
+  };
+}
+function isLayoutRoot(value) {
+  return typeof value === 'object' && !isLayoutElement(value) && 'root' in value;
+}
+//# sourceMappingURL=Root.js.map

package/lib/module/api/layout/Root.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["presetContent","buildContent","isLayoutElement","layoutOptions","mergeLayoutOptions","ROOT_DURATION","rootAnimation","transition","enter","enabled","waitForRender","exit","content","show","BUILD_ROOT","Symbol","RootElement","constructor","root","modals","rootTransition","modal","animation","animations","setRoot","length","map","Root","buildRoot","value","isLayoutRoot","withDefaultTransition","layout"],"sourceRoot":"../../../../src","sources":["api/layout/Root.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/layout/Screen.js

@@ -0,0 +1,52 @@
+"use strict";
+
+import { mergeOptions } from "../../engine/mergeOptions.js";
+import { buildScreenOptions } from "../screens/defineScreen.js";
+import { BUILD } from "./element.js";
+
+/** A screen of `screens` shown on its own, without a stack around it, or with options of this show. */
+export class ScreenElement {
+  constructor(name, props, built = {}, screenId) {
+    this.name = name;
+    this.props = props;
+    this.built = built;
+    this.screenId = screenId;
+  }
+
+  /** The options of this show, over those of the screen's definition. */
+  options(options) {
+    const built = mergeOptions(this.built, buildScreenOptions(options, this.props ?? {}));
+    return new ScreenElement(this.name, this.props, built, this.screenId);
+  }
+
+  /** The id of the screen, to address it. */
+  id(id) {
+    return new ScreenElement(this.name, this.props, this.built, id);
+  }
+  [BUILD]() {
+    return {
+      component: {
+        ...(this.screenId && {
+          id: this.screenId
+        }),
+        name: this.name,
+        ...(this.props && {
+          passProps: this.props
+        }),
+        options: this.built
+      }
+    };
+  }
+}
+
+// The type of an element carries the screens it shows.
+
+/**
+ * A screen of `screens` in a layout, with its props: `Screen('Details', { id: '42' })`. A screen without props can go
+ * by its name alone. The commands that take the layout check the name and the props.
+ */
+
+export function Screen(name, props) {
+  return new ScreenElement(name, props);
+}
+//# sourceMappingURL=Screen.js.map

package/lib/module/api/layout/Screen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mergeOptions","buildScreenOptions","BUILD","ScreenElement","constructor","name","props","built","screenId","options","id","component","passProps","Screen"],"sourceRoot":"../../../../src","sources":["api/layout/Screen.ts"],"mappings":";;AAEA,SAASA,YAAY,QAAQ,8BAA2B;AACxD,SAASC,kBAAkB,QAAiC,4BAAyB;AACrF,SAASC,KAAK,QAA+D,cAAW;;AAExF;AACA,OAAO,MAAMC,aAAa,CAAoE;EAC5FC,WAAWA,CACQC,IAAY,EACZC,KAAc,EACdC,KAAc,GAAG,CAAC,CAAC,EACnBC,QAAiB,EAClC;IAAA,KAJiBH,IAAY,GAAZA,IAAY;IAAA,KACZC,KAAc,GAAdA,KAAc;IAAA,KACdC,KAAc,GAAdA,KAAc;IAAA,KACdC,QAAiB,GAAjBA,QAAiB;EACjC;;EAEH;EACAC,OAAOA,CAACA,OAAmC,EAAuB;IAChE,MAAMF,KAAK,GAAGP,YAAY,CAAC,IAAI,CAACO,KAAK,EAAEN,kBAAkB,CAACQ,OAAO,EAAE,IAAI,CAACH,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,IAAIH,aAAa,CAAC,IAAI,CAACE,IAAI,EAAE,IAAI,CAACC,KAAK,EAAEC,KAAK,EAAE,IAAI,CAACC,QAAQ,CAAC;EACvE;;EAEA;EACAE,EAAEA,CAACA,EAAU,EAAuB;IAClC,OAAO,IAAIP,aAAa,CAAC,IAAI,CAACE,IAAI,EAAE,IAAI,CAACC,KAAK,EAAE,IAAI,CAACC,KAAK,EAAEG,EAAE,CAAC;EACjE;EAEA,CAACR,KAAK,IAAY;IAChB,OAAO;MACLS,SAAS,EAAE;QACT,IAAI,IAAI,CAACH,QAAQ,IAAI;UAAEE,EAAE,EAAE,IAAI,CAACF;QAAS,CAAC,CAAC;QAC3CH,IAAI,EAAE,IAAI,CAACA,IAAI;QACf,IAAI,IAAI,CAACC,KAAK,IAAI;UAAEM,SAAS,EAAE,IAAI,CAACN;QAAM,CAAC,CAAC;QAC5CG,OAAO,EAAE,IAAI,CAACF;MAChB;IACF,CAAC;EACH;AACF;;AAEA;;AAGA;AACA;AACA;AACA;;AAQA,OAAO,SAASM,MAAMA,CAACR,IAAY,EAAEC,KAAc,EAAiB;EAClE,OAAO,IAAIH,aAAa,CAACE,IAAI,EAAEC,KAAK,CAAC;AACvC","ignoreList":[]}

package/lib/module/api/layout/SideMenu.js

@@ -0,0 +1,85 @@
+"use strict";
+
+import { mergeOptions } from "../../engine/mergeOptions.js";
+import { BUILD, buildContent, onPlatform } from "./element.js";
+
+/** The parts of a side menu: a screen named alone is a screen in a menu, and gets a stack in the center. */
+
+/** Side menus around a center. */
+export class SideMenuElement {
+  // No command takes the id of a side menu: its screens open and close it (`openMenu`, `closeMenu`).
+  constructor(parts, built = {}) {
+    this.parts = parts;
+    this.built = built;
+  }
+  withMenu(sideMenu) {
+    return new SideMenuElement(this.parts, mergeOptions(this.built, {
+      sideMenu
+    }));
+  }
+  left(left) {
+    return this.withMenu({
+      left
+    });
+  }
+  right(right) {
+    return this.withMenu({
+      right
+    });
+  }
+
+  /** #### (iOS specific) Where a swipe opens a menu. */
+  gesture(openGestureMode) {
+    return this.withMenu({
+      openGestureMode
+    });
+  }
+
+  /** #### (iOS specific) */
+  animation(animationType) {
+    return this.withMenu({
+      animationType
+    });
+  }
+
+  /** Modifiers for iOS only. */
+  ios(build) {
+    return onPlatform('ios', this, build);
+  }
+
+  /** Modifiers for Android only. */
+  android(build) {
+    return onPlatform('android', this, build);
+  }
+
+  /** Options of the side menu no modifier covers. The options of screens go on the screens. */
+  options(options) {
+    return this.withMenu(options);
+  }
+  [BUILD]() {
+    const {
+      left,
+      center,
+      right
+    } = this.parts;
+    return {
+      sideMenu: {
+        ...(left && {
+          left: buildContent(left, 'screen')
+        }),
+        center: buildContent(center, 'stack'),
+        ...(right && {
+          right: buildContent(right, 'screen')
+        }),
+        options: this.built
+      }
+    };
+  }
+}
+
+// The type of an element carries the screens it shows.
+
+export function SideMenu(parts) {
+  return new SideMenuElement(parts);
+}
+//# sourceMappingURL=SideMenu.js.map

package/lib/module/api/layout/SideMenu.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["mergeOptions","BUILD","buildContent","onPlatform","SideMenuElement","constructor","parts","built","withMenu","sideMenu","left","right","gesture","openGestureMode","animation","animationType","ios","build","android","options","center","SideMenu"],"sourceRoot":"../../../../src","sources":["api/layout/SideMenu.ts"],"mappings":";;AAEA,SAASA,YAAY,QAAQ,8BAA2B;AACxD,SACEC,KAAK,EACLC,YAAY,EAGZC,UAAU,QAIL,cAAW;;AAElB;;AAOA;AACA,OAAO,MAAMC,eAAe,CAAoE;EAC9F;EACAC,WAAWA,CACQC,KAAoB,EACpBC,KAAc,GAAG,CAAC,CAAC,EACpC;IAAA,KAFiBD,KAAoB,GAApBA,KAAoB;IAAA,KACpBC,KAAc,GAAdA,KAAc;EAC9B;EAEKC,QAAQA,CAACC,QAAyB,EAAyB;IACjE,OAAO,IAAIL,eAAe,CAAC,IAAI,CAACE,KAAK,EAAEN,YAAY,CAAC,IAAI,CAACO,KAAK,EAAE;MAAEE;IAAS,CAAC,CAAC,CAAC;EAChF;EAEAC,IAAIA,CAACA,IAAkB,EAAyB;IAC9C,OAAO,IAAI,CAACF,QAAQ,CAAC;MAAEE;IAAK,CAAC,CAAC;EAChC;EAEAC,KAAKA,CAACA,KAAmB,EAAyB;IAChD,OAAO,IAAI,CAACH,QAAQ,CAAC;MAAEG;IAAM,CAAC,CAAC;EACjC;;EAEA;EACAC,OAAOA,CAACC,eAAgE,EAAyB;IAC/F,OAAO,IAAI,CAACL,QAAQ,CAAC;MAAEK;IAAgB,CAAC,CAAC;EAC3C;;EAEA;EACAC,SAASA,CAACC,aAA4D,EAAyB;IAC7F,OAAO,IAAI,CAACP,QAAQ,CAAC;MAAEO;IAAc,CAAC,CAAC;EACzC;;EAEA;EACAC,GAAGA,CAACC,KAA6D,EAAyB;IACxF,OAAOd,UAAU,CAAwB,KAAK,EAAE,IAAI,EAAEc,KAAK,CAAC;EAC9D;;EAEA;EACAC,OAAOA,CAACD,KAA6D,EAAyB;IAC5F,OAAOd,UAAU,CAAwB,SAAS,EAAE,IAAI,EAAEc,KAAK,CAAC;EAClE;;EAEA;EACAE,OAAOA,CAACA,OAAwB,EAAyB;IACvD,OAAO,IAAI,CAACX,QAAQ,CAACW,OAAO,CAAC;EAC/B;EAEA,CAAClB,KAAK,IAAY;IAChB,MAAM;MAAES,IAAI;MAAEU,MAAM;MAAET;IAAM,CAAC,GAAG,IAAI,CAACL,KAAK;IAC1C,OAAO;MACLG,QAAQ,EAAE;QACR,IAAIC,IAAI,IAAI;UAAEA,IAAI,EAAER,YAAY,CAACQ,IAAI,EAAE,QAAQ;QAAE,CAAC,CAAC;QACnDU,MAAM,EAAElB,YAAY,CAACkB,MAAM,EAAE,OAAO,CAAC;QACrC,IAAIT,KAAK,IAAI;UAAEA,KAAK,EAAET,YAAY,CAACS,KAAK,EAAE,QAAQ;QAAE,CAAC,CAAC;QACtDQ,OAAO,EAAE,IAAI,CAACZ;MAChB;IACF,CAAC;EACH;AACF;;AAEA;;AAGA,OAAO,SAASc,QAAQA,CACtBf,KAAY,EACiC;EAC7C,OAAO,IAAIF,eAAe,CAACE,KAAK,CAAC;AACnC","ignoreList":[]}

package/lib/module/api/layout/SplitView.js

@@ -0,0 +1,137 @@
+"use strict";
+
+import { Platform } from 'react-native';
+import { mergeOptions } from "../../engine/mergeOptions.js";
+import { BUILD, buildContent, onPlatform } from "./element.js";
+
+/** The columns of a split view; a screen alone, by name or `Screen(…)`, gets a stack, but in the inspector. */
+
+/**
+ * Columns side by side on iPad. On Android the primary and the secondary pane: side by side when the width takes
+ * both (a tablet, a phone in landscape); narrower, the compact layout, or without it the secondary pane over the
+ * primary one. Android has no supplementary or inspector column.
+ */
+export class SplitViewElement {
+  // No command takes the id of a split view: its screens show and hide its columns (`showColumn`, `hideColumn`).
+  constructor(columns, built = {}) {
+    this.columns = columns;
+    this.built = built;
+  }
+  withSplit(splitView) {
+    return new SplitViewElement(this.columns, mergeOptions(this.built, {
+      splitView
+    }));
+  }
+  displayMode(displayMode) {
+    return this.withSplit({
+      displayMode
+    });
+  }
+  splitBehavior(splitBehavior) {
+    return this.withSplit({
+      splitBehavior
+    });
+  }
+  primaryColumn(column) {
+    const {
+      edge,
+      background,
+      ...size
+    } = column;
+    return this.withSplit({
+      ...size,
+      primaryEdge: edge,
+      primaryBackgroundStyle: background
+    });
+  }
+  supplementaryColumn(supplementary) {
+    return this.withSplit({
+      supplementary
+    });
+  }
+  inspectorColumn(inspector) {
+    return this.withSplit({
+      inspector
+    });
+  }
+  displayModeButton(displayModeButton) {
+    return this.withSplit({
+      displayModeButton
+    });
+  }
+  presentsWithGesture(presentsWithGesture) {
+    return this.withSplit({
+      presentsWithGesture
+    });
+  }
+  showsSecondaryOnlyButton(showsSecondaryOnlyButton) {
+    return this.withSplit({
+      showsSecondaryOnlyButton
+    });
+  }
+  compactTopColumn(compactTopColumn) {
+    return this.withSplit({
+      compactTopColumn
+    });
+  }
+
+  /** Modifiers for iOS only. */
+  ios(build) {
+    return onPlatform('ios', this, build);
+  }
+
+  /** Modifiers for Android only. */
+  android(build) {
+    return onPlatform('android', this, build);
+  }
+
+  /** Options of the split view no modifier covers. The options of screens go on the screens. */
+  options(options) {
+    return this.withSplit(options);
+  }
+  [BUILD]() {
+    const {
+      primary,
+      secondary,
+      compact
+    } = this.columns;
+    // Android has no supplementary or inspector column.
+    const ios = Platform.OS === 'ios';
+    const supplementary = ios ? this.columns.supplementary : undefined;
+    const inspector = ios ? this.columns.inspector : undefined;
+    // A screen alone gets a stack of its own, on iOS too where UIKit would give it a navigation controller (and
+    // leaves one in the compact column without it): the column has a bar and pushes, and the navigation knows the
+    // stack.
+    const pane = content => {
+      const layout = buildContent(content, 'stack');
+      return layout.component || layout.externalComponent ? {
+        stack: {
+          children: [layout]
+        }
+      } : layout;
+    };
+    return {
+      splitView: {
+        master: pane(primary),
+        detail: pane(secondary),
+        ...(supplementary && {
+          supplementary: pane(supplementary)
+        }),
+        ...(inspector && {
+          inspector: buildContent(inspector, 'screen')
+        }),
+        ...(compact && {
+          compact: pane(compact)
+        }),
+        options: this.built
+      }
+    };
+  }
+}
+
+// The type of an element carries the screens it shows.
+
+export function SplitView(columns) {
+  return new SplitViewElement(columns);
+}
+//# sourceMappingURL=SplitView.js.map

package/lib/module/api/layout/SplitView.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Platform","mergeOptions","BUILD","buildContent","onPlatform","SplitViewElement","constructor","columns","built","withSplit","splitView","displayMode","splitBehavior","primaryColumn","column","edge","background","size","primaryEdge","primaryBackgroundStyle","supplementaryColumn","supplementary","inspectorColumn","inspector","displayModeButton","presentsWithGesture","showsSecondaryOnlyButton","compactTopColumn","ios","build","android","options","primary","secondary","compact","OS","undefined","pane","content","layout","component","externalComponent","stack","children","master","detail","SplitView"],"sourceRoot":"../../../../src","sources":["api/layout/SplitView.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/api/layout/Stack.js

@@ -0,0 +1,36 @@
+"use strict";
+
+import { BUILD, screenComponent } from "./element.js";
+import { ScreenElement } from "./Screen.js";
+
+/** A screen of a stack: by name, or `Screen(…)` with its props and the options of this show. */
+
+/**
+ * A stack of screens; the last one shows, and back goes to the one before. The options of screens go on the screens
+ * (`defineScreen`, `Screen(…).options()`), or on many at once through `groups` and `presentation`.
+ */
+export class StackElement {
+  // No command takes the id of a stack: the commands of a stack act from one of its screens.
+  constructor(entries, built = {}) {
+    this.entries = entries;
+    this.built = built;
+  }
+  [BUILD]() {
+    return {
+      stack: {
+        children: this.entries.map(stackChild),
+        options: this.built
+      }
+    };
+  }
+}
+export function stackChild(entry) {
+  return entry instanceof ScreenElement ? entry[BUILD]() : screenComponent(entry);
+}
+
+// The type of an element carries the screens it shows.
+
+export function Stack(...entries) {
+  return new StackElement(entries);
+}
+//# sourceMappingURL=Stack.js.map

package/lib/module/api/layout/Stack.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BUILD","screenComponent","ScreenElement","StackElement","constructor","entries","built","stack","children","map","stackChild","options","entry","Stack"],"sourceRoot":"../../../../src","sources":["api/layout/Stack.ts"],"mappings":";;AAEA,SACEA,KAAK,EAELC,eAAe,QAIV,cAAW;AAClB,SAASC,aAAa,QAAQ,aAAU;;AAExC;;AAGA;AACA;AACA;AACA;AACA,OAAO,MAAMC,YAAY,CAAoE;EAC3F;EACAC,WAAWA,CACQC,OAA8B,EAC9BC,KAAc,GAAG,CAAC,CAAC,EACpC;IAAA,KAFiBD,OAA8B,GAA9BA,OAA8B;IAAA,KAC9BC,KAAc,GAAdA,KAAc;EAC9B;EAEH,CAACN,KAAK,IAAY;IAChB,OAAO;MACLO,KAAK,EAAE;QACLC,QAAQ,EAAE,IAAI,CAACH,OAAO,CAACI,GAAG,CAACC,UAAU,CAAC;QACtCC,OAAO,EAAE,IAAI,CAACL;MAChB;IACF,CAAC;EACH;AACF;AAEA,OAAO,SAASI,UAAUA,CAACE,KAAiB,EAAuB;EACjE,OAAOA,KAAK,YAAYV,aAAa,GAAGU,KAAK,CAACZ,KAAK,CAAC,CAAC,CAAC,GAAGC,eAAe,CAACW,KAAK,CAAC;AACjF;;AAEA;;AAGA,OAAO,SAASC,KAAKA,CACnB,GAAGR,OAAgB,EACoB;EACvC,OAAO,IAAIF,YAAY,CAACE,OAAO,CAAC;AAClC","ignoreList":[]}