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

package/lib/module/interfaces/options/toolbar.js.map

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

package/lib/module/interfaces/options/topBar.js

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

package/lib/module/interfaces/options/topBar.js.map

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

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/adapters/NativeANNTurboEventEmitter.d.ts

@@ -0,0 +1,14 @@
+import { type TurboModule } from 'react-native';
+/**
+ * (iOS) The module the native side sends its events `ANN.<Name>` through. Android has none: its events come without
+ * a module.
+ */
+export interface Spec extends TurboModule {
+    /** A listener of the event came. */
+    addListener(eventType: string): void;
+    /** The number of listeners that went. */
+    removeListeners(count: number): void;
+}
+declare const _default: Spec | undefined;
+export default _default;
+//# sourceMappingURL=NativeANNTurboEventEmitter.d.ts.map

package/lib/typescript/adapters/NativeANNTurboEventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeANNTurboEventEmitter.d.ts","sourceRoot":"","sources":["../../../src/adapters/NativeANNTurboEventEmitter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAErE;;;GAGG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,oCAAoC;IACpC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,yCAAyC;IACzC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;;AAGD,wBAAkF"}

package/lib/typescript/adapters/NativeANNTurboModule.d.ts

@@ -0,0 +1,77 @@
+import { type CodegenTypes, type TurboModule } from 'react-native';
+/**
+ * The commands and questions JavaScript sends the native side. A command with a promise resolves once what it moves
+ * has settled, or rejects with a sentence that names the screen; a `void` one goes and reports its errors in the log.
+ * The synchronous methods only read what the native side stored for them and answer at once.
+ */
+export interface Spec extends TurboModule {
+    /** Sets the root of the app with `{ root, modals, overlays }`; resolves with the id of the root once all shows. */
+    setRoot(commandId: string, layout: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Starts the hidden React root `apexnative.slots`, once; a second call does nothing. */
+    startHost(): void;
+    /** Replaces the default options of every layout, shown or not, and applies their look to what shows. */
+    setDefaultOptions(options: CodegenTypes.UnsafeObject): void;
+    /** Merges options into the layout with the id and applies them to what shows; an unknown id does nothing. */
+    mergeOptions(componentId: string, options: CodegenTypes.UnsafeObject): void;
+    /** Pushes a layout over the screen in its stack; resolves with the id of the screen that shows. */
+    push(commandId: string, componentId: string, layout: CodegenTypes.UnsafeObject): Promise<string>;
+    /**
+     * (Android, one React tree) Lays the screen of a coming push out in its stack before React renders it, and resolves
+     * with its frame `{ width, height, padding }` in dp; null when it isn't prepared, and always on iOS.
+     */
+    preparePush(commandId: string, componentId: string, layout: CodegenTypes.UnsafeObject): Promise<CodegenTypes.UnsafeObject | null>;
+    /** Drops a screen that `preparePush` laid out; an unknown id does nothing. */
+    cancelPreparedPush(componentId: string): void;
+    /** Takes the screen and every screen above it off its stack; resolves with the id of the screen that went. */
+    pop(commandId: string, componentId: string): Promise<string>;
+    /** Takes the stack back to the screen with the id; resolves with that id. */
+    popTo(commandId: string, componentId: string): Promise<string>;
+    /** Takes the stack of the screen back to its first screen; resolves with the id of that screen. */
+    popToRoot(commandId: string, componentId: string): Promise<string>;
+    /** Replaces the screens of the screen's stack, the last one on top; resolves with the id of the new top screen. */
+    setStackRoot(commandId: string, componentId: string, layout: ReadonlyArray<CodegenTypes.UnsafeObject>): Promise<string>;
+    /** (Android) Whether JavaScript has `BackHandler` listeners; iOS does nothing. */
+    setBackListeners(active: boolean): void;
+    /** Shows a layout as a modal over the top modal or the root; resolves with the id of the modal's root. */
+    showModal(commandId: string, layout: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Dismisses the modal the screen is in; resolves with the id of the modal's root. */
+    dismissModal(commandId: string, componentId: string, options?: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Dismisses every modal; resolves with an empty string. */
+    dismissAllModals(commandId: string, options?: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Shows a layout over everything, apart from the root and the modals; resolves with the id of its root. */
+    showOverlay(commandId: string, layout: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Dismisses the overlay the screen is in; resolves with the id of the overlay. */
+    dismissOverlay(commandId: string, componentId: string): Promise<string>;
+    /** Dismisses every overlay; resolves with an empty string. */
+    dismissAllOverlays(commandId: string): Promise<string>;
+    /**
+     * Shows the layout in a column of the screen's split view in place of what it showed; out of a split view and in the
+     * compact width it is a push. Resolves with the id of the screen that shows.
+     */
+    showInColumn(commandId: string, componentId: string, column: string, layout: CodegenTypes.UnsafeObject): Promise<string>;
+    /** Shows or hides a column of the screen's split view; resolves once the columns stopped moving. */
+    setColumnShown(commandId: string, componentId: string, column: string, shown: boolean): Promise<void>;
+    /** How a screen of a pair shows, `{ placement, layout, front, hidden }`; `{}` out of a pair. */
+    getArrangementState(componentId: string): CodegenTypes.UnsafeObject;
+    /** The safe area of the screen, `{ top, right, bottom, left }`; `{}` before its first layout. */
+    getScreenInsets(componentId: string): CodegenTypes.UnsafeObject;
+    /** The reserved regions of the screen, `{ division, occlusion }`; empty lists before its first layout. */
+    getScreenRegions(componentId: string): CodegenTypes.UnsafeObject;
+    /** Turns `ANN.HingeChanged` on and off. */
+    setHingeUpdates(enabled: boolean): void;
+    /** The last state of the device's hinge, `{ state, angle? }`; `{}` without a hinge. */
+    getHinge(): CodegenTypes.UnsafeObject;
+    /** The link that launched the app (Android: the current activity), given once; null without one. */
+    getLaunchLink(): Promise<string | null>;
+    /** What the native side tells at the start: `{ coldStart, splashLogo, arrangements }`. */
+    getStartInfo(): CodegenTypes.UnsafeObject;
+    /** New props of an open native screen: `{ props, removed, functions }`. */
+    updateNativeScreenProps(componentId: string, update: CodegenTypes.UnsafeObject): void;
+    /** The answer to `ANN.NativeScreenCall`: `{ value }` or `{ error }`. */
+    resolveNativeScreenCall(callId: string, result: CodegenTypes.UnsafeObject): void;
+    /** (iOS) Takes away a preview that waits, with its screen; a screen it opened stays. Android does nothing. */
+    dismissPreview(previewId: string): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeANNTurboModule.d.ts.map

package/lib/typescript/adapters/NativeANNTurboModule.d.ts.map

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

package/lib/typescript/api/app/AppRegistry.d.ts

@@ -0,0 +1,14 @@
+import { AppRegistry as ReactNativeAppRegistry } from 'react-native';
+import { type NavigationApp } from './createNavigation.js';
+type NavigationAppProvider = () => NavigationApp<any, any>;
+/**
+ * Registers the app's navigation under the app's name; it starts when the native side launches the app. A function
+ * that returns the navigation loads its module only then.
+ */
+declare function registerComponent(key: string, navigation: NavigationApp<any, any> | NavigationAppProvider): string;
+/** React Native's AppRegistry, with `registerComponent` taking the navigation instead of a root component. */
+export declare const AppRegistry: Omit<typeof ReactNativeAppRegistry, 'registerComponent'> & {
+    registerComponent: typeof registerComponent;
+};
+export {};
+//# sourceMappingURL=AppRegistry.d.ts.map

package/lib/typescript/api/app/AppRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRegistry.d.ts","sourceRoot":"","sources":["../../../../src/api/app/AppRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAIrE,OAAO,EAAmB,KAAK,aAAa,EAAY,MAAM,uBAAoB,CAAC;AAEnF,KAAK,qBAAqB,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;AAsB3D;;;GAGG;AACH,iBAAS,iBAAiB,CACxB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,qBAAqB,GAC1D,MAAM,CAgBR;AAED,8GAA8G;AAC9G,eAAO,MAAM,WAAW,EAAE,IAAI,CAAC,OAAO,sBAAsB,EAAE,mBAAmB,CAAC,GAAG;IACnF,iBAAiB,EAAE,OAAO,iBAAiB,CAAC;CACM,CAAC"}

package/lib/typescript/api/app/activeApp.d.ts

@@ -0,0 +1,12 @@
+import type { Presentation } from '../commands/presentation.js';
+import type { RootsMap } from './roots.js';
+/** The started app, for the commands made outside it. */
+export interface ActiveApp {
+    roots: RootsMap | undefined;
+    presentation: Presentation | undefined;
+    /** Resolves once the first root is shown. */
+    mounted: Promise<void>;
+}
+export declare function setActiveApp(app: ActiveApp): void;
+export declare function getActiveApp(): ActiveApp | undefined;
+//# sourceMappingURL=activeApp.d.ts.map

package/lib/typescript/api/app/activeApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activeApp.d.ts","sourceRoot":"","sources":["../../../../src/api/app/activeApp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAS,CAAC;AAExC,yDAAyD;AACzD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,YAAY,EAAE,YAAY,GAAG,SAAS,CAAC;IACvC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAID,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,QAE1C;AAED,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAEpD"}

package/lib/typescript/api/app/createNavigation.d.ts

@@ -0,0 +1,182 @@
+import type { ComponentType } from 'react';
+import { type AppProvider } from '../../engine/slots.js';
+import type { SafeAreaEdge, WindowOptions } from '../../interfaces/Options.js';
+import type { Presentation } from '../commands/presentation.js';
+import { type NavigationListeners } from '../events/navigationEvents.js';
+import { type RootLayout } from '../layout/Root.js';
+import { type LoadingFallback, type ScreenGroup, type ScreenInfo, type ScreenProvider, type Screens } from '../screens/registerScreens.js';
+import type { ErrorFallbackProps } from '../screens/ScreenBoundary.js';
+import { type AppOptionsInput, type NavigationDirection, type NavigationTheme } from '../theme/theme.js';
+import { type SplashConfig } from './splash.js';
+import { type RootsMap, type RootTarget, type UsesOfRootValue } from './roots.js';
+import type { LinkingConfig } from '../linking/types.js';
+import type { CheckedScreens } from '../types.js';
+declare const NAVIGATION_APP: unique symbol;
+declare const rootsType: unique symbol;
+declare const screensType: unique symbol;
+/** Where an error that goes to `onError` came from. */
+export type NavigationErrorSource = 
+/** A screen failed to render: it shows `errorFallback`, or nothing, and the other screens go on. */
+{
+    type: 'screen';
+    screen: ScreenInfo;
+    componentStack?: string | null;
+}
+/**
+ * The app failed to start: `willMount` or the first root. `errorFallback` shows as the first screen, and its `retry`
+ * starts again; without it the splash screen stays, and the next launch tries again.
+ */
+ | {
+    type: 'start';
+}
+/** A route of `linking` failed: its `start`, its `open`, or a command they made. The app goes on. */
+ | {
+    type: 'link';
+    url: string;
+};
+/** The navigation made by `createNavigation`, for `AppRegistry.registerComponent`. */
+export interface NavigationApp<Roots extends RootsMap = RootsMap, AppScreens = Screens> {
+    readonly [NAVIGATION_APP]: true;
+    /** Carries the type of the roots for `navigation.switchTo`; never set. */
+    readonly [rootsType]?: Roots;
+    /** Carries the type of the screens for the commands; never set. */
+    readonly [screensType]?: AppScreens;
+}
+/** Starts the app, or brings back its root when the native side launches again. */
+export declare function startApp(app: NavigationApp<any, any>): Promise<void>;
+type ScreenGroups = Record<string, Screens>;
+/** Every screen of the app: those of `screens` and of every group. */
+type AllScreens<AppScreens, Groups extends ScreenGroups> = AppScreens & UnionToIntersection<Groups[keyof Groups]>;
+type UnionToIntersection<Union> = (Union extends unknown ? (value: Union) => void : never) extends (value: infer Intersection) => void ? Intersection : never;
+interface BaseConfig<Context, AppScreens extends Screens, Groups extends ScreenGroups, Roots extends RootsMap = RootsMap, Patterns extends string = string> {
+    /** The screens of the app by name. */
+    screens?: AppScreens;
+    /**
+     * Screens sharing options, by group name. Their names are in one namespace with `screens`: a command names a
+     * screen without its group.
+     */
+    groups?: {
+        [Group in keyof Groups]: ScreenGroup & {
+            screens: Groups[Group];
+        };
+    };
+    /** What every push, modal and overlay starts from; the settings of a command go over it. */
+    presentation?: Presentation;
+    /** Handlers of the events of the navigation, for as long as the app runs. */
+    listeners?: NavigationListeners;
+    /**
+     * Wraps the whole app once. With it every screen of `screens` and `groups` renders in one React tree inside it, so
+     * what it holds (a store, a query client, a theme) is shared and lives as long as the app does.
+     */
+    appProvider?: AppProvider;
+    /** Wraps every screen on its own, inside `appProvider`. */
+    screenProvider?: ScreenProvider;
+    /**
+     * What a screen that failed to render shows instead, with `retry` to render it again; without it the screen is empty
+     * and its top bar stays, so the user can go back. It renders inside `screenProvider`, unless that failed. When the
+     * start fails, it is the first screen, in place of the splash screen, and its `retry` runs the start again from
+     * `willMount`.
+     */
+    errorFallback?: ComponentType<ErrorFallbackProps>;
+    /** What a screen shows while it waits for a lazy component or data (Suspense); nothing without it. */
+    loadingFallback?: LoadingFallback;
+    /**
+     * The errors of the app: a screen that failed to render, a start that failed, and a link whose route failed. Without
+     * it they go to the console, as React and React Native report them.
+     */
+    onError?: (error: unknown, source: NavigationErrorSource) => void;
+    /**
+     * The default options of every screen, over the colors of the theme: options, or a chain built from the theme and the
+     * app's context (`(s, { theme, context }) => …`), which is built again when the theme changes.
+     */
+    options?: AppOptionsInput;
+    /** The look of the navigation: colors of the bars, tabs and backgrounds; `navigation.setTheme` changes it. */
+    theme?: NavigationTheme;
+    /**
+     * The edges on which every screen keeps its content out of its safe area. Without it: all four on Android; on iOS
+     * every edge but those where the content goes under a bar that shows. A screen gives its own with `safeArea(...)`
+     * in its options.
+     */
+    safeArea?: {
+        edges: SafeAreaEdge[];
+    };
+    /** (iOS) The app's window, behind the screens: seen around a modal as it comes in. */
+    window?: WindowOptions;
+    /**
+     * The direction of the app: `'rtl'`, `'ltr'`, or `'locale'` for the language of the app. The bars, the transitions and
+     * the swipe back follow it, and follow `navigation.setDirection` at once (on iOS 15–16 a stack already shown keeps
+     * its direction until its next push; on iOS 17+ a stack not on screen at the change does when the app had no
+     * direction before). React content follows it in the screens created after a change
+     * (React Native's `I18nManager`, which keeps it between launches); a reload of the JavaScript mirrors the screens
+     * already open. The side menus keep their sides.
+     */
+    direction?: NavigationDirection;
+    /**
+     * The first value of the app's context, for every screen (`useAppContext`): there at once, while `willMount` runs
+     * too. Its type is the type of the context. `navigation.setContext` is the one way to change it.
+     */
+    context?: Context;
+    /**
+     * Runs once per JavaScript runtime before the first root, while the splash screen shows. What the first root needs
+     * goes into the context with `navigation.setContext`.
+     */
+    willMount?: () => void | PromiseLike<void>;
+    /** Runs once per JavaScript runtime, once the first root is shown, with the context. */
+    didMount?: (context: Context) => void;
+    /**
+     * The app's own splash in React Native: a component that shows after the native splash on a cold start of the app,
+     * while `willMount` runs; the least time it stays, whether it waits for `useSplash().hide()`, and how the first root
+     * replaces it. Once per process: a reload of the JavaScript goes to the first root at once.
+     */
+    splash?: SplashConfig;
+    /**
+     * The links that open the app's screens: custom schemes, universal links (iOS) and App Links (Android), by path. A
+     * link runs after `willMount`, once the first root is shown; the link that launches the app can make that root itself
+     * (`start`). The app declares its schemes and domains natively (Info.plist, entitlements, AndroidManifest).
+     */
+    linking?: LinkingConfig<Context, Roots, Patterns, AllScreens<AppScreens, Groups>>;
+}
+/** The first root: a layout, or a function making it from the context. */
+type FirstRoot<Context, Layout extends RootLayout = RootLayout> = Layout | ((context: Context) => Layout);
+/** One root: the app always starts with it. */
+interface SingleRootConfig<Context, Root extends FirstRoot<Context> = FirstRoot<Context>> {
+    /** The first root, from the context as `willMount` left it. */
+    root: Root;
+    roots?: never;
+    initialRoot?: never;
+}
+/** Named roots to switch between, such as signed out and signed in. */
+interface NamedRootsConfig<Context, Roots extends RootsMap, Target extends RootTarget<Roots> = RootTarget<Roots>> {
+    /** The roots of the app by name: a layout, or a function making it from a param. */
+    roots: Roots;
+    /** The root to start with, from the context as `willMount` left it: its name, or `[name, param]`. */
+    initialRoot: (context: Context) => Target;
+    root?: never;
+}
+/** What `createNavigation` takes: `screens` and `root`, or `roots` with `initialRoot`; every other key is optional. */
+export type NavigationConfig<Context = void, Roots extends RootsMap = Record<never, never>, Target extends RootTarget<Roots> = RootTarget<Roots>, AppScreens extends Screens = Record<never, never>, Groups extends ScreenGroups = Record<never, never>, Root extends FirstRoot<Context> = FirstRoot<Context>, Patterns extends string = string> = BaseConfig<Context, AppScreens, Groups, Roots, Patterns> & (SingleRootConfig<Context, Root> | NamedRootsConfig<Context, Roots, Target>);
+/**
+ * The roots, checked against the screens of the config itself: the app's registered type is made from this config,
+ * so it can't check it.
+ */
+type CheckedRoots<Root, Roots, AppScreens> = {
+    root?: CheckedScreens<UsesOfRootValue<Root>, AppScreens>;
+    roots?: {
+        [Name in keyof Roots]: CheckedScreens<UsesOfRootValue<Roots[Name]>, AppScreens>;
+    };
+};
+export declare function isNavigationApp(value: unknown): value is NavigationApp;
+/**
+ * The app's navigation in one object: its screens, its first root, how the screens look and show, the data every
+ * screen reads, and what runs at launch. `AppRegistry.registerComponent` in `index.js` takes it, and the app starts
+ * from it when the native side launches.
+ *
+ * @example
+ * export const Navigation = createNavigation({
+ *   screens: { Home: HomeScreen, Details: DetailsScreen },
+ *   root: 'Home',
+ * });
+ */
+export declare function createNavigation<Context = void, const Roots extends RootsMap = Record<never, never>, const Target extends RootTarget<Roots> = RootTarget<Roots>, AppScreens extends Screens = Record<never, never>, Groups extends ScreenGroups = Record<never, never>, const FirstLayout extends RootLayout = never, Patterns extends string = never>(config: NavigationConfig<Context, Roots, Target, AppScreens, Groups, FirstRoot<Context, FirstLayout>, Patterns> & NoInfer<CheckedRoots<FirstLayout, Roots, AllScreens<AppScreens, Groups>>>): NavigationApp<Roots, AllScreens<AppScreens, Groups>>;
+export {};
+//# sourceMappingURL=createNavigation.d.ts.map

package/lib/typescript/api/app/createNavigation.d.ts.map

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

package/lib/typescript/api/app/roots.d.ts

@@ -0,0 +1,15 @@
+import type { LayoutRoot } from '../../interfaces/Layout.js';
+import { type RootLayout, type UsesOfRoot } from '../layout/Root.js';
+/** A root of the app: its layout, or a function making it from a param. */
+export type RootValue = RootLayout | (() => RootLayout) | ((param: any) => RootLayout);
+export type RootsMap = Record<string, RootValue>;
+/** The screens a root of `roots` shows: those of its layout, or of the layout its function makes. */
+export type UsesOfRootValue<Value> = Value extends (...args: any[]) => infer Layout ? UsesOfRoot<Layout> : UsesOfRoot<Value>;
+/** The param a root takes: none for a layout or a function without one. */
+export type RootParam<Value> = Value extends () => RootLayout ? [] : Value extends (param: infer Param) => RootLayout ? [param: Param] : [];
+/** A root to show: its name, or `[name, param]` for a root that takes a param. */
+export type RootTarget<Roots extends RootsMap> = {
+    [Name in keyof Roots & string]: RootParam<Roots[Name]> extends [] ? Name : readonly [Name, ...RootParam<Roots[Name]>];
+}[keyof Roots & string];
+export declare function resolveRoot(roots: RootsMap | undefined, name: string, param: unknown[]): LayoutRoot;
+//# sourceMappingURL=roots.d.ts.map

package/lib/typescript/api/app/roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"roots.d.ts","sourceRoot":"","sources":["../../../../src/api/app/roots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAAyB,CAAC;AAC1D,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAgB,CAAC;AAE7E,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,KAAK,UAAU,CAAC,CAAC;AAEvF,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAEjD,qGAAqG;AACrG,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI,KAAK,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,MAAM,MAAM,GAC/E,UAAU,CAAC,MAAM,CAAC,GAClB,UAAU,CAAC,KAAK,CAAC,CAAC;AAEtB,2EAA2E;AAC3E,MAAM,MAAM,SAAS,CAAC,KAAK,IAAI,KAAK,SAAS,MAAM,UAAU,GACzD,EAAE,GACF,KAAK,SAAS,CAAC,KAAK,EAAE,MAAM,KAAK,KAAK,UAAU,GAC9C,CAAC,KAAK,EAAE,KAAK,CAAC,GACd,EAAE,CAAC;AAET,kFAAkF;AAClF,MAAM,MAAM,UAAU,CAAC,KAAK,SAAS,QAAQ,IAAI;KAC9C,IAAI,IAAI,MAAM,KAAK,GAAG,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,GAC7D,IAAI,GACJ,SAAS,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;CAC/C,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC;AAExB,wBAAgB,WAAW,CACzB,KAAK,EAAE,QAAQ,GAAG,SAAS,EAC3B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,EAAE,GACf,UAAU,CAQZ"}

package/lib/typescript/api/app/splash.d.ts

@@ -0,0 +1,81 @@
+import type { ComponentType } from 'react';
+import type { LayoutRoot } from '../../interfaces/Layout.js';
+import type { RootTransition } from '../layout/Root.js';
+/** The screen of the app's splash in React Native: the first root of a cold start. */
+export declare const SPLASH_SCREEN = "ApexNavigation.Splash";
+/**
+ * The app's own splash in React Native: an animation, a progress. It shows after the native splash on a cold start
+ * of the app, once per process: not after a reload of the JavaScript, and not when Android makes a new activity while
+ * the JavaScript runs on.
+ */
+export interface SplashConfig {
+    /**
+     * What the splash shows: a component without props, over the whole window. It renders before `willMount` ends, so
+     * it is a React root of its own, outside `appProvider` and `screenProvider`, which may need what `willMount`
+     * prepares. The app's context is there (`useAppContext`), as `willMount` leaves it.
+     */
+    component: ComponentType;
+    /** The least time the splash stays on screen, in ms, from when it shows: the length of its animation. `0` by default. */
+    minDuration?: number;
+    /**
+     * When the splash leaves: `'auto'` (the default) once `willMount` ended and `minDuration` passed; `'manual'` waits
+     * for `useSplash().hide()` too.
+     */
+    hide?: 'auto' | 'manual';
+    /**
+     * How the first root replaces the splash: what `Root(…).transition` takes, `'fade'` by default. A first root with a
+     * transition of its own (`Root(…).transition(…)` other than `'platform'`) keeps it.
+     */
+    transition?: RootTransition;
+}
+/** The size of the native splash's logo: points on iOS, dp on Android. */
+export interface SplashLogo {
+    width: number;
+    height: number;
+}
+/** What `useSplash` returns. */
+export interface Splash {
+    /**
+     * Lets the splash leave, with `hide: 'manual'`: it still waits for `willMount` and `minDuration`. Does nothing once
+     * it left, or without a splash.
+     */
+    hide(): void;
+    /**
+     * The logo of the native splash, centered in the window at this size, as `apex-navigation splash` made it: a splash
+     * that starts from it continues the native one without a jump. Undefined without a splash made by the CLI.
+     */
+    logo: SplashLogo | undefined;
+}
+/**
+ * The app's splash in React Native: lets it leave (`hide: 'manual'`), and gives the size of the native splash's logo
+ * to start an animation from.
+ *
+ * @example
+ * function Splash() {
+ *   const { hide, logo } = useSplash();
+ *   // … the logo at logo.width × logo.height in the middle of the window, then an animation that calls hide()
+ * }
+ */
+export declare function useSplash(): Splash;
+/** Whether the splash shows at this start: the app has one, and the JavaScript runs for the first time in the process. */
+export declare function showsSplash(config: SplashConfig | undefined): config is SplashConfig;
+/**
+ * The splash as the first root: at once, as it continues the native splash, over the whole window. Its own screen
+ * options can't hold this, as `component` is any component.
+ */
+export declare const SPLASH_ROOT: LayoutRoot;
+/**
+ * Shows the splash and resolves once it may leave as far as it is concerned: it is on screen, `minDuration` passed
+ * and, with `hide: 'manual'`, `hide()` came; or at once on `releaseSplash()`. A splash that failed to show holds
+ * nothing: the native splash stays until the first root.
+ */
+export declare function showSplash(config: SplashConfig, show: () => Promise<unknown>): Promise<void>;
+/**
+ * The splash can't leave by itself any more, and the start goes on at once: its screen went with an Android activity
+ * (the new one doesn't show it, and its setRoot may never end), or its component failed to render and can't call
+ * `hide()`.
+ */
+export declare function releaseSplash(): void;
+/** The splash left, or won't show: hide() does nothing from now on. */
+export declare function splashDone(): void;
+//# sourceMappingURL=splash.d.ts.map

package/lib/typescript/api/app/splash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"splash.d.ts","sourceRoot":"","sources":["../../../../src/api/app/splash.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAgB,CAAC;AAErD,sFAAsF;AACtF,eAAO,MAAM,aAAa,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,SAAS,EAAE,aAAa,CAAC;IACzB,yHAAyH;IACzH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED,0EAA0E;AAC1E,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gCAAgC;AAChC,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,IAAI,IAAI,IAAI,CAAC;IACb;;;OAGG;IACH,IAAI,EAAE,UAAU,GAAG,SAAS,CAAC;CAC9B;AAaD;;;;;;;;;GASG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,0HAA0H;AAC1H,wBAAgB,WAAW,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,IAAI,YAAY,CAEpF;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,UAYzB,CAAC;AAOF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB5F;AAED;;;;GAIG;AACH,wBAAgB,aAAa,SAE5B;AAED,uEAAuE;AACvE,wBAAgB,UAAU,SAKzB"}

package/lib/typescript/api/app/startFailure.d.ts

@@ -0,0 +1,15 @@
+import { type ComponentType } from 'react';
+import type { ErrorFallbackProps } from '../screens/ScreenBoundary.js';
+/** The screen a failed start shows as the first root, in place of the splash screen: `errorFallback`. */
+export declare const START_FAILURE_SCREEN = "ApexNavigation.StartFailure";
+interface StartFailure {
+    error: unknown;
+    /** Runs the start again, from `willMount`. */
+    retry: () => void;
+}
+/** The start failed: the screen shows this error, or the new one of a try that failed again. */
+export declare function setStartFailure(next: StartFailure): void;
+/** The component of the screen: the app's `errorFallback` with the error of the start, its `retry` starts again. */
+export declare function startFailureScreen(Fallback: ComponentType<ErrorFallbackProps>): ComponentType;
+export {};
+//# sourceMappingURL=startFailure.d.ts.map

package/lib/typescript/api/app/startFailure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startFailure.d.ts","sourceRoot":"","sources":["../../../../src/api/app/startFailure.tsx"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,aAAa,EAAoC,MAAM,OAAO,CAAC;AACpF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA2B,CAAC;AAGpE,yGAAyG;AACzG,eAAO,MAAM,oBAAoB,gCAAgC,CAAC;AAElE,UAAU,YAAY;IACpB,KAAK,EAAE,OAAO,CAAC;IACf,8CAA8C;IAC9C,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAKD,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,QAGjD;AASD,oHAAoH;AACpH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,aAAa,CAAC,kBAAkB,CAAC,GAAG,aAAa,CAQ7F"}

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

@@ -0,0 +1,21 @@
+/** How a screen of a pair (`defineArrangement`) shows now. */
+export interface ArrangementState {
+    /** Which view of the pair this screen is. */
+    placement: 'primary' | 'secondary';
+    /**
+     * How the pair lies: `sideBySide`, `stacked` (one above the other), `overlay` (one over the other, both full size),
+     * `single` (only one view is in the window).
+     */
+    layout: 'sideBySide' | 'stacked' | 'overlay' | 'single';
+    /** `overlay`: this view lies over the other one. */
+    front: boolean;
+    /** `single`: this screen is out of the window. */
+    hidden: boolean;
+}
+/** The state of a screen of a pair; null for a screen outside one. */
+export declare function getArrangementState(screenId: string): ArrangementState | null;
+/** Calls `onChange` when the screen's state in its pair changes; returns the function that stops it. */
+export declare function subscribeArrangementState(screenId: string, onChange: () => void): () => void;
+/** The screen unmounted: its state goes. */
+export declare function forgetArrangementState(screenId: string): void;
+//# sourceMappingURL=arrangementState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"arrangementState.d.ts","sourceRoot":"","sources":["../../../../src/api/arrangement/arrangementState.ts"],"names":[],"mappings":"AAKA,8DAA8D;AAC9D,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,SAAS,EAAE,SAAS,GAAG,WAAW,CAAC;IACnC;;;OAGG;IACH,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IACxD,oDAAoD;IACpD,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;CACjB;AAeD,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAU7E;AAED,wGAAwG;AACxG,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAS5F;AAED,4CAA4C;AAC5C,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,QAGtD"}

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

@@ -0,0 +1,57 @@
+import { type StackEntry } from '../layout/Stack.js';
+import { type ScreenOptionsInput } from '../screens/defineScreen.js';
+import type { ColumnConfig, ModalConfig, OverlayConfig, PushConfig } from './presentation.js';
+type WithProps<Config> = Config & {
+    props?: object;
+};
+export declare function push(fromId: string, name: string, config?: WithProps<PushConfig>): Promise<string>;
+/**
+ * A push that waits as the preview of a view of the screen (`usePreview`): a tap on the preview pushes it. The screen
+ * has the given id, so the presses of its menu reach the hook. A preview that is no longer `wanted` when its push is
+ * about to go out (the component unmounted while the screen loaded) isn't sent: its `dismissPreview` came before it.
+ */
+export declare function pushPreview(fromId: string, name: string, props: object | undefined, preview: object, id: string, wanted: () => boolean): Promise<string>;
+export declare function pop(fromId: string): Promise<string>;
+export declare function popTo(screenId: string): Promise<string>;
+export declare function popToRoot(fromId: string): Promise<string>;
+export declare function setStack(fromId: string, entries: StackEntry[]): Promise<string>;
+/**
+ * The screen alone in the stack of the screen it is made from: the history of the stack goes, so there is no back. It
+ * comes in as a push does; resolves with its id.
+ */
+export declare function replace(fromId: string, name: string, config?: WithProps<PushConfig>): Promise<string>;
+export declare function showInColumn(fromId: string, name: string, config?: WithProps<ColumnConfig>): Promise<string>;
+/** A column of a split view that the app shows and hides. */
+export type SplitColumn = 'primary' | 'supplementary' | 'inspector';
+/** Shows or hides a column of the split view the screen is in; resolves once the columns have moved. */
+export declare function setColumnShown(fromId: string, column: SplitColumn, shown: boolean): Promise<void>;
+export declare function showModal(name: string, config?: WithProps<ModalConfig>): Promise<string>;
+export declare function dismissModal(modalId: string): Promise<string>;
+export declare function dismissAllModals(): Promise<string>;
+export declare function showOverlay(name: string, config?: WithProps<OverlayConfig>): Promise<string>;
+export declare function dismissOverlay(overlayId: string): Promise<string>;
+/**
+ * There is a screen under this one in its stack, or it is the first of a split view column shown over the column
+ * before it.
+ */
+export declare function canPop(screenId: string): boolean;
+/** The screen is in a modal or an overlay. */
+export declare function canDismiss(screenId: string): boolean;
+/**
+ * What the back button would do on the screen: back to the screen under it in its stack, or else it closes the modal
+ * or the overlay it is in.
+ */
+export declare function goBack(screenId: string): Promise<string>;
+/** Closes the modal or the overlay the screen is in. */
+export declare function dismiss(screenId: string): Promise<string>;
+export declare function dismissAllOverlays(): Promise<string>;
+/** Selects a tab of the tabs the screen is in: by its index, or by the id of the tab. */
+export declare function selectTab(screenId: string, tab: number | string): void;
+/** The badge of the tab the screen is in, or of the tab with the id; `null` and `0` take it away. */
+export declare function setTabBadge(screenId: string, badge: string | number | null, tab?: string): void;
+/** A chain of the options gets the props of the screen and `{ theme, context }`, as in `defineScreen`. */
+export declare function setOptions(screenId: string, options: ScreenOptionsInput<object>): void;
+/** Keeps the user on the screen: the close button of its modal calls `onAttempt` instead. Returns what lets go. */
+export declare function holdLeave(screenId: string, onAttempt: () => void): () => void;
+export {};
+//# sourceMappingURL=commands.d.ts.map

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

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

package/lib/typescript/api/commands/errors.d.ts

@@ -0,0 +1,24 @@
+import { type ScreenPlace } from '../../engine/places.js';
+/** Runs a command; what it can't do rejects with the command in the error. */
+export declare function command<T>(name: string, run: () => Promise<T>): Promise<T>;
+/** Counts a command as on its way until it settles; `command` does it, and the commands made without it. */
+export declare function trackCommand<T>(result: Promise<T>): Promise<T>;
+/** How many commands started since the app did: what `whenCommandsSettle` waits from. */
+export declare function commandsStarted(): number;
+/**
+ * Resolves once the commands started after `since` (a value of `commandsStarted`) settled, at the latest after
+ * `timeout`. Older ones don't count: a command the native side never answers (Android without an activity) doesn't
+ * hold what comes later.
+ */
+export declare function whenCommandsSettle(since: number, timeout?: number): Promise<void>;
+/**
+ * The place of the screen a command acts from, when the command can be made from there; otherwise it throws why: the
+ * screen is gone, it is not in a stack (`stack`), it is the first of its stack (`below`), or it is not in a modal or an
+ * overlay (`dismissible`). A screen the engine doesn't know is left to the native side.
+ */
+export declare function placeFor(name: string, screenId: string, needs?: {
+    stack?: boolean;
+    below?: boolean;
+    dismissible?: boolean;
+}): ScreenPlace | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/lib/typescript/api/commands/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../src/api/commands/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,wBAAqB,CAAC;AAYxE,8EAA8E;AAC9E,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAY1E;AAED,4GAA4G;AAC5G,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO9D;AAED,yFAAyF;AACzF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/E;AAWD;;;;GAIG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAO,GACtE,WAAW,GAAG,SAAS,CAgBzB"}