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

package/lib/typescript/api/linking/types.d.ts

@@ -0,0 +1,105 @@
+import type { RootLayout } from '../layout/Root.js';
+import type { RootsMap, RootTarget } from '../app/roots.js';
+import type { CheckedScreens } from '../types.js';
+/** The params of a path pattern, each a string: `'user/:userId/:tab?'` gives `{ userId: string; tab?: string }`. */
+export type LinkParams<Pattern extends string> = Simplify<{
+    [Name in RequiredParam<Segment<Pattern>>]: string;
+} & {
+    [Name in OptionalParam<Segment<Pattern>>]?: string;
+}>;
+type Segment<Pattern extends string> = Pattern extends `${infer Head}/${infer Rest}` ? Head | Segment<Rest> : Pattern;
+type RequiredParam<Part> = Part extends `:${string}?` ? never : Part extends `:${infer Name}` ? Name : never;
+type OptionalParam<Part> = Part extends `:${infer Name}?` ? Name : never;
+type Simplify<Value> = {
+    [Key in keyof Value]: Value[Key];
+} & {};
+/** A link as a route gets it. */
+export interface LinkInfo {
+    /** The whole URL. */
+    url: string;
+    /** The path the route matched, without the prefix and the query: `user/42`. */
+    path: string;
+    /** The query string by key; a key given twice keeps its last value. */
+    query: Record<string, string>;
+    /** Whether this link launched the app, or on Android a new activity of it. */
+    initial: boolean;
+}
+/** What a route does in a running app: any commands. */
+export type LinkHandler<Pattern extends string> = (params: LinkParams<Pattern>, link: LinkInfo) => void;
+/** A route with what it does when the link launches the app, when the app runs, and when it may run. */
+export interface LinkRouteConfig<Pattern extends string, Context, Roots extends RootsMap> {
+    /**
+     * The first root when the link launches the app, in place of `root` / `initialRoot`: the screen of the link with the
+     * screens to go back to, shown at once. A layout, or a root of `roots` (its name, or `[name, param]`). In a running
+     * app, a route without `open` shows it with `navigation.switchTo`.
+     */
+    start?: (params: LinkParams<Pattern>, link: LinkInfo) => RootTarget<Roots> | Exclude<RootLayout, string>;
+    /**
+     * What the link does in a running app, and when it launches the app and the route has no `start`: then it runs
+     * once the first root is shown.
+     */
+    open?: LinkHandler<Pattern>;
+    /** Whether the link may run now, in place of `when` of `linking`; while it is false the link waits. */
+    when?: (context: Context) => boolean;
+}
+/**
+ * The screens of the app that take the params of a pattern as their props, for a route given as a screen name.
+ */
+type LinkScreen<Pattern extends string, AppScreens> = {
+    [Name in keyof AppScreens & string]: unknown extends CheckedScreens<{
+        name: Name;
+        props: LinkParams<Pattern>;
+    }, AppScreens> ? Name : never;
+}[keyof AppScreens & string];
+/**
+ * A route: a screen name, pushed with the params and the query as its props; a function, its `open`; or
+ * `{ start, open, when }`.
+ */
+export type LinkRoute<Pattern extends string, Context, Roots extends RootsMap, AppScreens> = NoInfer<LinkScreen<Pattern, AppScreens>> | LinkHandler<Pattern> | LinkRouteConfig<Pattern, Context, Roots>;
+/** The links that open the app's screens: custom schemes, universal links (iOS) and App Links (Android). */
+export interface LinkingConfig<Context = unknown, Roots extends RootsMap = RootsMap, Patterns extends string = string, AppScreens = Record<string, unknown>> {
+    /**
+     * The starts of the URLs the app takes: `'myapp://'`, `'https://example.com'`; what follows is the path. A URL that
+     * starts with none is not the app's. Without it every URL goes: the host of an `http(s)` URL is left out, and for
+     * another scheme the path starts after `://`.
+     */
+    prefixes?: string[];
+    /**
+     * The routes by path pattern: static parts, `:param`, and `:param?` at the end. The most specific match wins: more
+     * required parts first, then a static part before a param at the same place, then fewer parts, then the order here.
+     */
+    routes: {
+        [Pattern in Patterns]: LinkRoute<Pattern, Context, Roots, AppScreens>;
+    };
+    /**
+     * Whether a link may run now, from the app's context: `(context) => context.signedIn`. While it is false the link
+     * doesn't run and waits; the latest one waiting is kept (`navigation.getPendingLink`). A route's own `when` goes
+     * over it. Without it every link runs at once. It is asked when a link comes and, for a waiting one, on each
+     * `setContext`: a `when` that reads a store (Redux, Zustand) instead isn't asked again when the store changes, so
+     * use `pending: 'manual'` there.
+     */
+    when?: (context: Context) => boolean;
+    /**
+     * What a waiting link does once `when` lets it: `'auto'` runs it when the context changes so, after the commands then
+     * on their way (`setContext` and `switchTo` of a sign-in); `'manual'` keeps it for `navigation.openPendingLink`,
+     * which the app calls once it is ready, such as after a sign-in kept in a store. `'auto'` without it.
+     */
+    pending?: 'auto' | 'manual';
+    /** A URL no route takes, or with none of `prefixes`. Without it a warning in development. */
+    unmatched?: (url: string) => void;
+}
+/** A link that waits for `when` of `linking`. */
+export interface PendingLink {
+    /** The whole URL. */
+    url: string;
+    /** The path, without the prefix and the query. */
+    path: string;
+    /** The pattern of its route in `routes`. */
+    route: string;
+    /** The params of the path. */
+    params: Record<string, string>;
+    /** The query string by key. */
+    query: Record<string, string>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/api/linking/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/api/linking/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/api/navigation.d.ts

@@ -0,0 +1,115 @@
+import { type RootParam } from './app/roots.js';
+import type { SplitColumn } from './commands/commands.js';
+import type { ColumnConfig, ModalConfig, OverlayConfig, PushConfig } from './commands/presentation.js';
+import { type NavigationEventName, type NavigationEvents } from './events/navigationEvents.js';
+import { type RootLayout, type UsesOfRoot } from './layout/Root.js';
+import { type NavigationState } from './state/navigationState.js';
+import type { StackEntry } from './layout/Stack.js';
+import type { UsesOf } from './layout/element.js';
+import type { PendingLink } from './linking/types.js';
+import { type NavigationDirection, type NavigationTheme } from './theme/theme.js';
+import type { CheckedScreens, RegisteredContext, RegisteredRoots, RegisteredScreens, ScreenName, ShowArgs } from './types.js';
+type RootName = keyof RegisteredRoots & string;
+/** The screens of a stack, each checked against the screens of the app. */
+export type CheckedEntries<Entries extends readonly StackEntry[]> = {
+    [Index in keyof Entries]: Entries[Index] & NoInfer<CheckedScreens<UsesOf<Entries[Index]>, RegisteredScreens>>;
+};
+export interface AppNavigation {
+    /** Replaces the whole navigation with a root of `roots`: the modals close, the overlays stay. */
+    switchTo<Name extends RootName>(name: Name, ...param: RootParam<RegisteredRoots[Name]>): Promise<void>;
+    /**
+     * Replaces the whole navigation with a root of its own, such as the screens of a deep link. A screen named alone
+     * is a root name here, so it goes as `Stack('Name')`.
+     */
+    switchTo<const Layout extends Exclude<RootLayout, string>>(layout: Layout & NoInfer<CheckedScreens<UsesOfRoot<Layout>, RegisteredScreens>>): Promise<void>;
+    /** Shows a screen in the stack of the screen the user sees; resolves with the id of the screen shown. */
+    push<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, PushConfig>): Promise<string>;
+    /** Goes back in the stack of the screen the user sees; see `useNavigation().pop`. */
+    pop(): Promise<string>;
+    /** Goes back to a screen of its stack, by its id. */
+    popTo(screenId: string): Promise<string>;
+    /** `pop()` has a screen to go back to from the one the user sees; see `useNavigation().canPop`. Answers at once. */
+    canPop(): boolean;
+    /** The screen the user sees is in a modal or an overlay. Answers at once. */
+    canDismiss(): boolean;
+    /** Shows a column of the split view the user is in; see `useNavigation().showColumn`. */
+    showColumn(column: SplitColumn): Promise<void>;
+    /** Hides a column of the split view the user is in. */
+    hideColumn(column: SplitColumn): Promise<void>;
+    /** Opens a menu of the side menu the user is in; resolves once it is open and `getState()` shows its screen. */
+    openMenu(side: 'left' | 'right'): Promise<void>;
+    /**
+     * Closes the menu that is open; resolves once it is closed and `getState()` shows the center, so the next command
+     * acts from there.
+     */
+    closeMenu(): Promise<void>;
+    /** What the back button would do on the screen the user sees: `pop()`, or `dismiss()` of its modal. */
+    goBack(): Promise<string>;
+    /** `goBack()` has something to do. Answers at once. */
+    canGoBack(): boolean;
+    /** Goes back to the first screen of the stack of the screen the user sees. */
+    popToRoot(): Promise<string>;
+    /** Shows a screen alone in the stack of the screen the user sees, in place of its history; see `useNavigation().replace`. */
+    replace<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, PushConfig>): Promise<string>;
+    /** Replaces the screens of the stack of the screen the user sees. */
+    setStack<const Entries extends readonly StackEntry[]>(...entries: CheckedEntries<Entries>): Promise<string>;
+    /** Shows a screen in a column of the split view of the screen the user sees; see `useNavigation().showInColumn`. */
+    showInColumn<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, ColumnConfig>): Promise<string>;
+    /** Shows a screen over everything, in a stack of its own unless `stack: false`. */
+    showModal<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, ModalConfig>): Promise<string>;
+    /** Dismisses a modal by its id, or the modal a screen with this id is in. */
+    dismissModal(modalId: string): Promise<string>;
+    dismissAllModals(): Promise<string>;
+    /** Shows a screen over everything, without taking the place of any. */
+    showOverlay<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, OverlayConfig>): Promise<string>;
+    /**
+     * Dismisses an overlay by its id. iOS also takes the id of a screen inside the overlay; Android takes only the
+     * overlay's own id and rejects the id of a screen inside it.
+     */
+    dismissOverlay(overlayId: string): Promise<string>;
+    dismissAllOverlays(): Promise<string>;
+    /**
+     * Selects a tab of the tabs of the screen the user sees: by its index, or by the id of the tab. Resolves once the
+     * state shows it, so the next command acts in that tab. The state has the tab of the root's tabs only: in tabs over
+     * them (tabs in a modal) it resolves on the next change of the state, at the latest after 300 ms, and at once when
+     * the root's tabs show a tab with that index.
+     */
+    selectTab(tab: number | string): Promise<void>;
+    /**
+     * The badge of the tab with the id, or of the tab of the screen the user sees: a count or a short text. `null` and the
+     * number `0` take it away, so a count of unread messages goes as it is; the text `'0'` shows "0".
+     */
+    setTabBadge(badge: string | number | null, tab?: string): Promise<void>;
+    /** Changes the theme of the navigation: the screens shown take it too, `useNavigationTheme` renders again. */
+    setTheme(theme: NavigationTheme): void;
+    /**
+     * Changes the direction of the app (`direction` of createNavigation): the bars, the transitions and the swipe back
+     * follow at once, React content in the screens created after it. On iOS 15–16 a stack already shown keeps its
+     * direction (its bar, its swipe back and its transitions) until its next push; on iOS 17+ so does a stack that isn't
+     * on screen at the change (another tab, under a full-screen modal) when the app had no direction before.
+     */
+    setDirection(direction: NavigationDirection): void;
+    /** The app's context: `context` of createNavigation, as `setContext` changed it since. */
+    getContext(): RegisteredContext;
+    /** Changes the app's context: every `useAppContext` renders again. */
+    setContext(next: RegisteredContext | ((previous: RegisteredContext) => RegisteredContext)): void;
+    /**
+     * What the user sees now: the screen and the selected tab. Once a command resolves, it shows what the command did.
+     */
+    getState(): NavigationState;
+    /** The link that waits for `when` of `linking`, the latest one; null when none waits. */
+    getPendingLink(): PendingLink | null;
+    /**
+     * Runs the waiting link now, as in a running app, whatever its `when` says, and forgets it. Resolves once its route
+     * has run, with false when no link waits; a route that fails goes to `onError`.
+     */
+    openPendingLink(): Promise<boolean>;
+    /** Forgets the waiting link. */
+    clearPendingLink(): void;
+    /** Listens to an event of the navigation, outside the screens too; returns the function that stops listening. */
+    on<Name extends NavigationEventName>(name: Name, handler: (event: NavigationEvents[Name]) => void): () => void;
+}
+/** The navigation of the app, for anywhere, outside the screens too. */
+export declare const navigation: AppNavigation;
+export {};
+//# sourceMappingURL=navigation.d.ts.map

package/lib/typescript/api/navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigation.d.ts","sourceRoot":"","sources":["../../../src/api/navigation.ts"],"names":[],"mappings":"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"}

package/lib/typescript/api/options/OptionsChain.d.ts

@@ -0,0 +1,47 @@
+import type { AnimationOptions, Color, HardwareBackButtonOptions, LayoutOrientation, NavigationBarOptions, Options, OptionsBottomTabs, OptionsLayout, OptionsScrollEdgeEffect, OptionsSideMenu, OptionsStatusBar, OptionsTopBar, OptionsTopBarBackButton, OptionsTopBarLargeTitle, SafeAreaEdge } from '../../interfaces/Options.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 declare abstract class OptionsChain {
+    protected readonly built: Options;
+    constructor(built?: Options);
+    /** A copy with other options. */
+    protected abstract withOptions(options: Options): this;
+    /** Any options. */
+    options(options: Options): this;
+    topBar(topBar: OptionsTopBar): this;
+    /** #### (iOS specific) */
+    largeTitle(largeTitle?: boolean | OptionsTopBarLargeTitle): this;
+    backButton(backButton: OptionsTopBarBackButton): this;
+    /** Hides the top bar; `hideTopBar(fullScreen)` takes the value from state, `false` shows it. */
+    hideTopBar(hidden?: boolean): this;
+    /** Hides the tab bar under this screen; `false` shows it. */
+    hideBottomTabs(hidden?: boolean): this;
+    layout(layout: OptionsLayout): this;
+    /**
+     * 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: SafeAreaEdge[]): this;
+    backgroundColor(backgroundColor: Color): this;
+    orientation(...orientation: LayoutOrientation[]): this;
+    /** `false`: the bars of the screen stay horizontal on iPhone Duo. #### (iOS specific) */
+    verticalBars(verticalBars?: boolean): this;
+    statusBar(statusBar: OptionsStatusBar): this;
+    navigationBar(navigationBar: NavigationBarOptions): this;
+    /** #### (iOS specific) */
+    scrollEdgeEffect(scrollEdgeEffect: OptionsScrollEdgeEffect): this;
+    /** #### (iOS specific) */
+    popGesture(popGesture: boolean | 'edge'): this;
+    hardwareBackButton(hardwareBackButton: HardwareBackButtonOptions): this;
+    animations(animations: Pick<AnimationOptions, 'push' | 'pop'>): this;
+    bottomTabs(bottomTabs: OptionsBottomTabs): this;
+    sideMenu(sideMenu: OptionsSideMenu): this;
+    /** Modifiers for iOS only. */
+    ios(build: (options: this) => this): this;
+    /** Modifiers for Android only. */
+    android(build: (options: this) => this): this;
+}
+//# sourceMappingURL=OptionsChain.d.ts.map

package/lib/typescript/api/options/OptionsChain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionsChain.d.ts","sourceRoot":"","sources":["../../../../src/api/options/OptionsChain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAChB,KAAK,EACL,yBAAyB,EACzB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACP,iBAAiB,EACjB,aAAa,EACb,uBAAuB,EACvB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACb,MAAM,6BAA0B,CAAC;AAGlC;;;GAGG;AACH,8BAAsB,YAAY;IACpB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,OAAO;gBAAd,KAAK,GAAE,OAAY;IAElD,iCAAiC;IACjC,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAEtD,mBAAmB;IACnB,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAM/B,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAInC,0BAA0B;IAC1B,UAAU,CAAC,UAAU,GAAE,OAAO,GAAG,uBAA8B,GAAG,IAAI;IAMtE,UAAU,CAAC,UAAU,EAAE,uBAAuB,GAAG,IAAI;IAIrD,gGAAgG;IAChG,UAAU,CAAC,MAAM,UAAO,GAAG,IAAI;IAI/B,6DAA6D;IAC7D,cAAc,CAAC,MAAM,UAAO,GAAG,IAAI;IAMnC,MAAM,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAInC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,KAAK,EAAE,YAAY,EAAE,GAAG,IAAI;IAIxC,eAAe,CAAC,eAAe,EAAE,KAAK,GAAG,IAAI;IAI7C,WAAW,CAAC,GAAG,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI;IAItD,yFAAyF;IACzF,YAAY,CAAC,YAAY,UAAO,GAAG,IAAI;IAIvC,SAAS,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAI5C,aAAa,CAAC,aAAa,EAAE,oBAAoB,GAAG,IAAI;IAIxD,0BAA0B;IAC1B,gBAAgB,CAAC,gBAAgB,EAAE,uBAAuB,GAAG,IAAI;IAMjE,0BAA0B;IAC1B,UAAU,CAAC,UAAU,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAI9C,kBAAkB,CAAC,kBAAkB,EAAE,yBAAyB,GAAG,IAAI;IAMvE,UAAU,CAAC,UAAU,EAAE,IAAI,CAAC,gBAAgB,EAAE,MAAM,GAAG,KAAK,CAAC,GAAG,IAAI;IAMpE,UAAU,CAAC,UAAU,EAAE,iBAAiB,GAAG,IAAI;IAI/C,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IAMzC,8BAA8B;IAC9B,GAAG,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAIzC,kCAAkC;IAClC,OAAO,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;CAG9C"}

package/lib/typescript/api/options/ScreenOptions.d.ts

@@ -0,0 +1,32 @@
+import type { Options, OptionsKeyCommand, OptionsSearchBar, OptionsToolbar, OptionsToolbarSearchField, OptionsToolbarSpace, OptionsTopBarSubtitle, OptionsTopBarTitle } from '../../interfaces/Options.js';
+import type { NavigationButton, NavigationFab } from './buttons.js';
+import { OptionsChain } from './OptionsChain.js';
+/** The toolbar, with buttons that take `onPress`. */
+export type ToolbarOptions = Omit<OptionsToolbar, 'buttons'> & {
+    buttons?: (NavigationButton | OptionsToolbarSpace | OptionsToolbarSearchField)[];
+};
+/**
+ * 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 declare class ScreenOptions extends OptionsChain {
+    protected withOptions(options: Options): this;
+    /** The options built by a chain. */
+    static read(options: ScreenOptions): Options;
+    title(title: string | OptionsTopBarTitle): this;
+    subtitle(subtitle: string | OptionsTopBarSubtitle): this;
+    /** Buttons take `onPress`. */
+    leftButtons(...leftButtons: NavigationButton[]): this;
+    /** Buttons take `onPress`. */
+    rightButtons(...rightButtons: NavigationButton[]): this;
+    /** #### (iOS specific) Buttons take `onPress`. */
+    centerButtons(...centerButtons: NavigationButton[]): this;
+    searchBar(searchBar: OptionsSearchBar): this;
+    /** #### (iOS specific) Buttons take `onPress`. */
+    toolbar(toolbar: ToolbarOptions): this;
+    /** #### (Android specific) The FAB and its `actions` take `onPress`. */
+    fab(fab: NavigationFab): this;
+    keyCommands(...keyCommands: OptionsKeyCommand[]): this;
+}
+export declare function readScreenOptions(options: ScreenOptions): Options;
+//# sourceMappingURL=ScreenOptions.d.ts.map

package/lib/typescript/api/options/ScreenOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenOptions.d.ts","sourceRoot":"","sources":["../../../../src/api/options/ScreenOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,yBAAyB,EACzB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,6BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,cAAW,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAgB,CAAC;AAE9C,qDAAqD;AACrD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG;IAC7D,OAAO,CAAC,EAAE,CAAC,gBAAgB,GAAG,mBAAmB,GAAG,yBAAyB,CAAC,EAAE,CAAC;CAClF,CAAC;AAEF;;;GAGG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAI7C,oCAAoC;IACpC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO;IAI5C,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAM/C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,GAAG,IAAI;IAMxD,8BAA8B;IAC9B,WAAW,CAAC,GAAG,WAAW,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAIrD,8BAA8B;IAC9B,YAAY,CAAC,GAAG,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAIvD,kDAAkD;IAClD,aAAa,CAAC,GAAG,aAAa,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAIzD,SAAS,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAI5C,kDAAkD;IAClD,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAItC,wEAAwE;IACxE,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI;IAI7B,WAAW,CAAC,GAAG,WAAW,EAAE,iBAAiB,EAAE,GAAG,IAAI;CAGvD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAEjE"}

package/lib/typescript/api/options/buttons.d.ts

@@ -0,0 +1,35 @@
+import type { OptionsFab, OptionsTopBarButton, OptionsTopBarButtonMenu, OptionsTopBarButtonMenuItem, OptionsTopBarButtonSubmenu } from '../../interfaces/Options.js';
+import type { ButtonPressedEvent } from '../events/navigationEvents.js';
+import type { ScreenNavigation } from '../hooks/useNavigation.js';
+/** A press of a button or of an item of its menu, with the navigation of the screen whose button it is. */
+export type ButtonPressEvent = ButtonPressedEvent & {
+    navigation: ScreenNavigation;
+};
+/**
+ * Called when the button is pressed. The function stays in JavaScript; the native side gets the button's id. It gets
+ * the navigation of its screen, so the options need no import: `onPress: ({ navigation }) => navigation.openMenu('left')`.
+ */
+export type ButtonPressHandler = (event: ButtonPressEvent) => void;
+/** An item of a button menu, with what picking it does. */
+export type NavigationMenuItem = OptionsTopBarButtonMenuItem & {
+    onPress?: ButtonPressHandler;
+};
+/** A submenu of a button menu. */
+export type NavigationSubmenu = Omit<OptionsTopBarButtonSubmenu, 'items'> & {
+    items: (NavigationMenuItem | NavigationSubmenu)[];
+};
+/** The menu of a button, whose items take `onPress`. */
+export type NavigationButtonMenu = Omit<OptionsTopBarButtonMenu, 'items'> & {
+    items: (NavigationMenuItem | NavigationSubmenu)[];
+};
+/** The floating action button, and each of its `actions`, with what its press does. */
+export type NavigationFab = Omit<OptionsFab, 'actions'> & {
+    onPress?: ButtonPressHandler;
+    actions?: NavigationFab[];
+};
+/** A button of the top bar or the toolbar, with what its press does. */
+export type NavigationButton = Omit<OptionsTopBarButton, 'menu'> & {
+    onPress?: ButtonPressHandler;
+    menu?: NavigationButtonMenu;
+};
+//# sourceMappingURL=buttons.d.ts.map

package/lib/typescript/api/options/buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../../../src/api/options/buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,mBAAmB,EACnB,uBAAuB,EACvB,2BAA2B,EAC3B,0BAA0B,EAC3B,MAAM,6BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA4B,CAAC;AACrE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAAwB,CAAC;AAE/D,2GAA2G;AAC3G,MAAM,MAAM,gBAAgB,GAAG,kBAAkB,GAAG;IAAE,UAAU,EAAE,gBAAgB,CAAA;CAAE,CAAC;AAErF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAEnE,2DAA2D;AAC3D,MAAM,MAAM,kBAAkB,GAAG,2BAA2B,GAAG;IAAE,OAAO,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC;AAEhG,kCAAkC;AAClC,MAAM,MAAM,iBAAiB,GAAG,IAAI,CAAC,0BAA0B,EAAE,OAAO,CAAC,GAAG;IAC1E,KAAK,EAAE,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,EAAE,CAAC;CACnD,CAAC;AAEF,wDAAwD;AACxD,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,uBAAuB,EAAE,OAAO,CAAC,GAAG;IAC1E,KAAK,EAAE,CAAC,kBAAkB,GAAG,iBAAiB,CAAC,EAAE,CAAC;CACnD,CAAC;AAEF,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG;IACxD,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B,CAAC;AAEF,wEAAwE;AACxE,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,GAAG;IACjE,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,IAAI,CAAC,EAAE,oBAAoB,CAAC;CAC7B,CAAC"}

package/lib/typescript/api/safeArea/ANNSafeAreaViewNativeComponent.d.ts

@@ -0,0 +1,20 @@
+import { 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>;
+}
+declare const _default: HostComponent<NativeProps>;
+export default _default;
+//# sourceMappingURL=ANNSafeAreaViewNativeComponent.d.ts.map

package/lib/typescript/api/safeArea/ANNSafeAreaViewNativeComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ANNSafeAreaViewNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/api/safeArea/ANNSafeAreaViewNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,4DAA4D;IAC5D,OAAO,CAAC,EAAE,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,eAAe,CAAC,EAAE,YAAY,CAAC,WAAW,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3D;;;OAGG;IACH,cAAc,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;CACpD;wBAKK,aAAa,CAAC,WAAW,CAAC;AAFhC,wBAEiC"}

package/lib/typescript/api/safeArea/screenInsets.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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.
+ */
+export interface EdgeInsets {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/**
+ * 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 declare function getScreenInsets(screenId: string): EdgeInsets;
+/** Calls `onChange` when the screen's insets change; returns the function that stops it. */
+export declare function subscribeScreenInsets(screenId: string, onChange: () => void): () => void;
+/** The screen unmounted: its insets go. */
+export declare function forgetScreenInsets(screenId: string): void;
+//# sourceMappingURL=screenInsets.d.ts.map

package/lib/typescript/api/safeArea/screenInsets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenInsets.d.ts","sourceRoot":"","sources":["../../../../src/api/safeArea/screenInsets.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AASD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,CAQ5D;AAED,4FAA4F;AAC5F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CASxF;AAED,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,QAGlD"}

package/lib/typescript/api/safeArea/screenRegions.d.ts

@@ -0,0 +1,24 @@
+/** A part of a screen in its coordinates: points on iOS, dp on Android. */
+export interface ReservedRegion {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** The parts of a screen the hardware takes. */
+export interface ReservedRegions {
+    /** Where the screen divides: the fold of a partly folded device. Keep controls and text off it. */
+    division: ReservedRegion[];
+    /** Where hardware covers the screen: a camera, a hinge that hides what is under it. */
+    occlusion: ReservedRegion[];
+}
+/**
+ * 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 declare function getScreenRegions(screenId: string): ReservedRegions;
+/** Calls `onChange` when the screen's regions change; returns the function that stops it. */
+export declare function subscribeScreenRegions(screenId: string, onChange: () => void): () => void;
+/** The screen unmounted: its regions go. */
+export declare function forgetScreenRegions(screenId: string): void;
+//# sourceMappingURL=screenRegions.d.ts.map

package/lib/typescript/api/safeArea/screenRegions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenRegions.d.ts","sourceRoot":"","sources":["../../../../src/api/safeArea/screenRegions.ts"],"names":[],"mappings":"AAIA,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,mGAAmG;IACnG,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,uFAAuF;IACvF,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AASD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe,CAQlE;AAED,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CASzF;AAED,4CAA4C;AAC5C,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,QAGnD"}

package/lib/typescript/api/screens/ScreenBoundary.d.ts

@@ -0,0 +1,34 @@
+import React, { Component, type ComponentType, type ErrorInfo, type ReactNode } from 'react';
+import type { ScreenInfo } from './registerScreens.js';
+/**
+ * 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`.
+ */
+export interface ErrorFallbackProps {
+    error: unknown;
+    screen: ScreenInfo;
+    retry: () => void;
+}
+interface Props {
+    screen: ScreenInfo;
+    fallback?: ComponentType<ErrorFallbackProps>;
+    onError?: (error: unknown, componentStack: string | null | undefined) => void;
+    children: ReactNode;
+}
+interface State {
+    failed: boolean;
+    error: unknown;
+}
+/**
+ * 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 declare class ScreenBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: unknown): State;
+    componentDidCatch(error: unknown, info: ErrorInfo): void;
+    retry: () => void;
+    render(): string | number | bigint | boolean | Iterable<React.ReactNode> | Promise<string | number | bigint | boolean | React.ReactPortal | React.ReactElement<unknown, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | null | undefined> | React.JSX.Element | null | undefined;
+}
+export {};
+//# sourceMappingURL=ScreenBoundary.d.ts.map

package/lib/typescript/api/screens/ScreenBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenBoundary.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/ScreenBoundary.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAAE,SAAS,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAmB,CAAC;AAEpD;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;IAC9E,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,UAAU,KAAK;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;IACzD,KAAK,EAAE,KAAK,CAAuC;IAEnD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK;IAItD,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;IAIjD,KAAK,aAEH;IAEF,MAAM;CAOP"}

package/lib/typescript/api/screens/arrangement.d.ts

@@ -0,0 +1,70 @@
+import type { EngineArrangement } from '../../engine/screens.js';
+declare const ARRANGEMENT: unique symbol;
+/**
+ * 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.
+ */
+export interface ScreenArrangement<Props extends object = {}> {
+    /**
+     * The screen beside or under this one: a name of `screens`. What belongs to the whole window is the primary's: the
+     * secondary's `topBar`, `toolbar`, `statusBar` and `layout.orientation` have no effect (iOS: also the home indicator,
+     * the deferred system gestures and `layout.verticalBars`; Android: also `navigationBar`).
+     */
+    secondary: string;
+    /** The props of the secondary from those of the show; without it the same props. */
+    secondaryProps?: (props: Props) => object;
+    /**
+     * `split`: side by side, each on its side of the fold of a partly folded device. `overlay`: this screen over the
+     * secondary, both full size; side by side on a partly folded device.
+     * @default 'split'
+     */
+    style?: 'split' | 'overlay';
+}
+/** A pair under a name of its own, with every setting: `defineArrangement`. */
+export interface ArrangementDefinition<Props extends object = {}> extends ScreenArrangement<Props> {
+    /** The screen that owns the bar: its title, buttons, toolbar and status bar are the pair's. A name of `screens`. */
+    primary: string;
+    /** The axes the pair may use. Where the window allows none of them, only the primary shows. @default 'both' */
+    axes?: 'horizontal' | 'vertical' | 'both';
+    /** `split`: the primary's share along the split, above 0 and below 1, where the fold does not decide. @default 0.5 */
+    fraction?: number;
+    /** `overlay`: the edge the primary takes when the pair goes side by side. @default 'trailing' */
+    primaryEdge?: 'leading' | 'trailing' | 'top' | 'bottom';
+    /**
+     * Outside a large window: `primary` — the primary alone, as a plain screen; `pair` — the pair as the system lays it
+     * out (one above the other on a phone held upright).
+     * @default 'primary'
+     */
+    compact?: 'primary' | 'pair';
+}
+/** An entry of `screens` made by `defineArrangement`. */
+export interface Arrangement<Props extends object = {}> {
+    readonly [ARRANGEMENT]: true;
+    readonly definition: ArrangementDefinition<Props>;
+    /** Carries the type of the props; never set. */
+    readonly props?: Props;
+}
+/**
+ * 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 declare function defineArrangement<Props extends object = {}>(definition: ArrangementDefinition<Props>): Arrangement<Props>;
+export declare function isArrangement(value: unknown): value is Arrangement<any>;
+/** The pair as the engine keeps it: the settings `arrangement` of a screen has not, at their defaults. */
+export declare function toEngineArrangement(primary: string, arrangement: ScreenArrangement<any> | ArrangementDefinition<any>): EngineArrangement;
+export {};
+//# sourceMappingURL=arrangement.d.ts.map

package/lib/typescript/api/screens/arrangement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrangement.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/arrangement.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAsB,CAAC;AAE9D,QAAA,MAAM,WAAW,eAA8C,CAAC;AAEhE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE;IAC1D;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC1C;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC7B;AAED,+EAA+E;AAC/E,MAAM,WAAW,qBAAqB,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE,CAAE,SAAQ,iBAAiB,CAAC,KAAK,CAAC;IAChG,oHAAoH;IACpH,OAAO,EAAE,MAAM,CAAC;IAChB,+GAA+G;IAC/G,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;IAC1C,sHAAsH;IACtH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iGAAiG;IACjG,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;IACxD;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAC9B;AAED,yDAAyD;AACzD,MAAM,WAAW,WAAW,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE;IACpD,QAAQ,CAAC,CAAC,WAAW,CAAC,EAAE,IAAI,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAClD,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE,EACzD,UAAU,EAAE,qBAAqB,CAAC,KAAK,CAAC,GACvC,WAAW,CAAC,KAAK,CAAC,CAGpB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAAC,GAAG,CAAC,CAEvE;AAED,0GAA0G;AAC1G,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAC/D,iBAAiB,CAanB"}

package/lib/typescript/api/screens/defineScreen.d.ts

@@ -0,0 +1,41 @@
+import type { ComponentType } from 'react';
+import type { Options } from '../../interfaces/Options.js';
+import { ScreenOptions } from '../options/ScreenOptions.js';
+import { type NavigationTheme } from '../theme/theme.js';
+import type { RegisteredContext } from '../types.js';
+import type { ScreenArrangement } from './arrangement.js';
+/** What the options of a screen can read besides its props, as they are when a command shows the screen. */
+export interface OptionsEnvironment {
+    theme: NavigationTheme;
+    context: RegisteredContext;
+}
+/** The options of a screen: options as they are, or a chain built from its props, the theme and the context. */
+export type ScreenOptionsInput<Props> = Options | ((options: ScreenOptions, props: Props, app: OptionsEnvironment) => ScreenOptions);
+/** A screen with what goes with it. */
+export interface ScreenDefinition<Props = any> {
+    component: ComponentType<Props>;
+    /** Applied when a command shows the screen, before it appears. */
+    options?: ScreenOptionsInput<Props>;
+    /**
+     * One screen per item, such as the chat with one person: a push of this screen goes back to the screen of the same
+     * stack with the same key, closing the screens over it, instead of showing a second one. The name of the screen goes
+     * in front of the key, so two screens never share one. In another stack it shows as usual.
+     */
+    key?: (props: Props) => string | number;
+    /**
+     * A second screen beside or under this one in a large window (iPad, iPhone Duo open, Android tablets and open
+     * foldables); anywhere else this screen shows alone, as it does without it. Shown by its own name, the screen is the
+     * primary of the pair: its bar is the pair's. For a pair with every setting, `defineArrangement`.
+     *
+     * @example
+     * defineScreen({ component: ProfileScreen, arrangement: { secondary: 'Details' } });
+     */
+    arrangement?: ScreenArrangement<Props & object>;
+}
+/**
+ * Describes a screen next to its component, so its registration stays one line. The same object can go right into
+ * `screens` of createNavigation.
+ */
+export declare function defineScreen<Props>(definition: ScreenDefinition<Props>): ScreenDefinition<Props>;
+export declare function buildScreenOptions<Props>(input: ScreenOptionsInput<Props> | undefined, props: Props): Options;
+//# sourceMappingURL=defineScreen.d.ts.map

package/lib/typescript/api/screens/defineScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineScreen.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/defineScreen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA0B,CAAC;AAExD,OAAO,EAAqB,aAAa,EAAE,MAAM,6BAA0B,CAAC;AAC5E,OAAO,EAAY,KAAK,eAAe,EAAE,MAAM,mBAAgB,CAAC;AAChE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAU,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAe,CAAC;AAEvD,4GAA4G;AAC5G,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,EAAE,iBAAiB,CAAC;CAC5B;AAED,gHAAgH;AAChH,MAAM,MAAM,kBAAkB,CAAC,KAAK,IAClC,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,kBAAkB,KAAK,aAAa,CAAC,CAAC;AAE/F,uCAAuC;AACvC,MAAM,WAAW,gBAAgB,CAAC,KAAK,GAAG,GAAG;IAC3C,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC;IAChC,kEAAkE;IAClE,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpC;;;;OAIG;IACH,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,GAAG,MAAM,CAAC;IACxC;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,GAAG,MAAM,CAAC,CAAC;CACjD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,EAAE,gBAAgB,CAAC,KAAK,CAAC,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAEhG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EACtC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,GAAG,SAAS,EAC5C,KAAK,EAAE,KAAK,GACX,OAAO,CAKT"}

package/lib/typescript/api/screens/nativeScreenCalls.d.ts

@@ -0,0 +1,3 @@
+/** Runs what the native screens call: the functions of their props, and the commands of the navigation from them. */
+export declare function listenToNativeScreenCalls(): void;
+//# sourceMappingURL=nativeScreenCalls.d.ts.map

package/lib/typescript/api/screens/nativeScreenCalls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nativeScreenCalls.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/nativeScreenCalls.ts"],"names":[],"mappings":"AA0BA,qHAAqH;AACrH,wBAAgB,yBAAyB,IAAI,IAAI,CAkBhD"}