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

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

@@ -0,0 +1,47 @@
+import type { ScreenArrangement } from './arrangement.js';
+import type { ScreenOptionsInput } from './defineScreen.js';
+declare const NATIVE_SCREEN: unique symbol;
+/** A screen made on the native side (SwiftUI, UIKit, Compose, Android views), registered there under `nativeName`. */
+export interface NativeScreen<Props extends object = {}> {
+    readonly [NATIVE_SCREEN]: true;
+    readonly nativeName: string;
+    readonly options?: ScreenOptionsInput<Props>;
+    readonly useProps?: (props: Props) => object;
+    readonly arrangement?: ScreenArrangement<Props>;
+    /** Carries the type of the props; never set. */
+    readonly props?: Props;
+}
+/** How a native screen shows: its options, and the hook that gives it the app's data. */
+export interface NativeScreenDefinition<Props extends object> {
+    options?: ScreenOptionsInput<Props>;
+    /**
+     * Gives the screen props from the app while it is open: data of the stores and of the app's context, functions the
+     * native side calls (`dispatch`, the API client). A hook: it runs in a component of its own, inside the app's
+     * providers and with the navigation of the screen, so any hook works in it. What it returns goes over the props of
+     * the command; the command shows the screen once it has returned, and every change goes to the native side.
+     */
+    useProps?: (props: Props) => object;
+    /** A second screen beside or under this one in a large window, as `arrangement` of `defineScreen`. */
+    arrangement?: ScreenArrangement<Props>;
+}
+/**
+ * A native screen for `screens`: commands and layouts name it like any other screen, and its props go to the native
+ * creator. `nativeName` is the name it is registered under natively (`ApexNavigation.registerNativeScreen`).
+ *
+ * @example
+ * const Settings = nativeScreen('Settings', {
+ *   useProps: () => {
+ *     const notifications = useSelector(selectNotifications);
+ *     const dispatch = useDispatch();
+ *     return {
+ *       notifications,
+ *       onNotificationsChange: (on: boolean) =>
+ *         dispatch(setNotifications(on)),
+ *     };
+ *   },
+ * });
+ */
+export declare function nativeScreen<Props extends object = {}>(nativeName: string, definition?: NativeScreenDefinition<Props>): NativeScreen<Props>;
+export declare function isNativeScreen(value: unknown): value is NativeScreen<any>;
+export {};
+//# sourceMappingURL=nativeScreens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nativeScreens.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/nativeScreens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAe,CAAC;AACvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAgB,CAAC;AAEzD,QAAA,MAAM,aAAa,eAA+C,CAAC;AAEnE,sHAAsH;AACtH,MAAM,WAAW,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE;IACrD,QAAQ,CAAC,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAChD,gDAAgD;IAChD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,yFAAyF;AACzF,MAAM,WAAW,sBAAsB,CAAC,KAAK,SAAS,MAAM;IAC1D,OAAO,CAAC,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACpC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;IACpC,sGAAsG;IACtG,WAAW,CAAC,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAC;CACxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS,MAAM,GAAG,EAAE,EACpD,UAAU,EAAE,MAAM,EAClB,UAAU,GAAE,sBAAsB,CAAC,KAAK,CAAM,GAC7C,YAAY,CAAC,KAAK,CAAC,CAGrB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAAC,GAAG,CAAC,CAEzE"}

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

@@ -0,0 +1,61 @@
+import React, { type ComponentType, type ReactNode } from 'react';
+import { type ScreenDefinition, type ScreenOptionsInput } from './defineScreen.js';
+import { type NativeScreen } from './nativeScreens.js';
+import { type Arrangement } from './arrangement.js';
+import { type ErrorFallbackProps } from './ScreenBoundary.js';
+type ScreenComponent = ComponentType<any>;
+type ScreenModule = ScreenComponent | ScreenDefinition | {
+    default: ScreenComponent | ScreenDefinition;
+};
+/**
+ * A screen: its component, its definition (`{ component, options }`, see `defineScreen`), `{ load }` to load its
+ * module the first time a command shows it (`() => import('./screens/Settings')`, the screen is its default export),
+ * or a screen of the native side (`nativeScreen`).
+ */
+export type ScreenEntry = ScreenComponent | ScreenDefinition | {
+    load: () => ScreenModule | PromiseLike<ScreenModule>;
+} | NativeScreen<any> | Arrangement<any>;
+export type Screens = Record<string, ScreenEntry>;
+/** A screen: the id of this showing of it, and its name in `screens`. */
+export interface ScreenInfo {
+    /** The id of this showing: two screens pushed one over the other have the same name and different ids. */
+    id: string;
+    /** Its name in `screens`. */
+    name: string;
+}
+/** Wraps every screen on its own. */
+export type ScreenProvider = ComponentType<{
+    children: ReactNode;
+    screen: ScreenInfo;
+}>;
+/** What a screen shows while it waits for a lazy component or data. */
+export type LoadingFallback = ComponentType<{
+    screen: ScreenInfo;
+}>;
+/** What the app wraps each of its screens in. */
+export interface ScreenWrapper {
+    provider?: ScreenProvider;
+    errorFallback?: ComponentType<ErrorFallbackProps>;
+    loadingFallback?: LoadingFallback;
+    /** An error of a screen's render, with the screen and React's component stack. */
+    onError?: (error: unknown, screen: ScreenInfo, componentStack: string | null | undefined) => void;
+}
+export declare const ScreenContext: React.Context<ScreenInfo | null>;
+/** Screens sharing options, such as the sign-in screens without a top bar. */
+export interface ScreenGroup {
+    /** The options of every screen of the group; the screen's own options go over them. */
+    options?: ScreenOptionsInput<object>;
+    screens: Screens;
+}
+/** Screens to register: those of `screens`, or of a group. */
+export interface ScreenSet {
+    /** Where the screens come from, for the errors. */
+    source: string;
+    screens: Screens;
+    options?: ScreenOptionsInput<object>;
+    /** The screens render as React roots of their own, in the app's one tree too. */
+    ownRoot?: boolean;
+}
+export declare function registerScreens(sets: ScreenSet[], wrapper?: ScreenWrapper): void;
+export {};
+//# sourceMappingURL=registerScreens.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registerScreens.d.ts","sourceRoot":"","sources":["../../../../src/api/screens/registerScreens.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,EAEZ,KAAK,aAAa,EAIlB,KAAK,SAAS,EAKf,MAAM,OAAO,CAAC;AAef,OAAO,EAAsB,KAAK,gBAAgB,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAgB,CAAC;AACpG,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,oBAAiB,CAAC;AACpE,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,kBAAe,CAAC;AACvB,OAAO,EAAE,KAAK,kBAAkB,EAAkB,MAAM,qBAAkB,CAAC;AAG3E,KAAK,eAAe,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AAC1C,KAAK,YAAY,GACf,eAAe,GAAG,gBAAgB,GAAG;IAAE,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAAA;CAAE,CAAC;AAEvF;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACnB,eAAe,GACf,gBAAgB,GAChB;IAAE,IAAI,EAAE,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,CAAC,CAAA;CAAE,GACxD,YAAY,CAAC,GAAG,CAAC,GACjB,WAAW,CAAC,GAAG,CAAC,CAAC;AAErB,MAAM,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAElD,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,0GAA0G;IAC1G,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qCAAqC;AACrC,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAExF,uEAAuE;AACvE,MAAM,MAAM,eAAe,GAAG,aAAa,CAAC;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAAC,CAAC;AAEpE,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,aAAa,CAAC,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,kFAAkF;IAClF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,KAAK,IAAI,CAAC;CACnG;AAED,eAAO,MAAM,aAAa,kCAAyC,CAAC;AAEpE,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;IACrC,iFAAiF;IACjF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD,wBAAgB,eAAe,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,OAAO,GAAE,aAAkB,QAiB7E"}

package/lib/typescript/api/slots/ANNSlotNativeComponent.d.ts

@@ -0,0 +1,15 @@
+import { type CodegenTypes, type HostComponent, type ViewProps } from 'react-native';
+export interface NativeProps extends ViewProps {
+    /**
+     * `[width, height]` in dp: the size of the container its screen was laid out in before the push (Android), so the
+     * first layout already has it. Empty: the container gives it once it is laid out.
+     */
+    initialSize?: ReadonlyArray<CodegenTypes.Float>;
+}
+/**
+ * Shows its children inside the native container with the same slot id (`nativeID`), at the container's size. The
+ * children stay in the app's one React tree, so they read its providers.
+ */
+declare const _default: HostComponent<NativeProps>;
+export default _default;
+//# sourceMappingURL=ANNSlotNativeComponent.d.ts.map

package/lib/typescript/api/slots/ANNSlotNativeComponent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ANNSlotNativeComponent.d.ts","sourceRoot":"","sources":["../../../../src/api/slots/ANNSlotNativeComponent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAGtB,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C;;;OAGG;IACH,WAAW,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;CACjD;AAED;;;GAGG;wBAGG,aAAa,CAAC,WAAW,CAAC;AAFhC,wBAEiC"}

package/lib/typescript/api/slots/SlotHost.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+/**
+ * The app's hidden React root, which the native side runs as `SLOT_HOST_MODULE`: in one tree, the app's provider
+ * around a slot for every screen shown; in any mode, the hooks of the native screens (`useProps`), inside the app's
+ * provider when there is one. Before the app starts, as after a reload, it renders no screens.
+ */
+export declare function SlotHost(): React.JSX.Element;
+//# sourceMappingURL=SlotHost.d.ts.map

package/lib/typescript/api/slots/SlotHost.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SlotHost.d.ts","sourceRoot":"","sources":["../../../../src/api/slots/SlotHost.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA0E,MAAM,OAAO,CAAC;AA0C/F;;;;GAIG;AACH,wBAAgB,QAAQ,sBAgBvB"}

package/lib/typescript/api/state/navigationState.d.ts

@@ -0,0 +1,26 @@
+import type { NavigationStateChangedEvent } from '../../interfaces/Events.js';
+/**
+ * What the user sees: the screen and the selected tab. The native side sends it when it changes, and before a command
+ * that changed it resolves.
+ */
+export type NavigationState = NavigationStateChangedEvent;
+/** Keeps the last state from the native side and the screens shown; the app starts it before its first root. */
+export declare function listenToNavigationState(): void;
+/** Whether the screen has appeared and not disappeared since, as the native side told it. */
+export declare function hasAppeared(screenId: string): boolean;
+/** The screen is gone: a disappearance that never came doesn't count it as shown for a screen with its id later. */
+export declare function forgetAppeared(screenId: string): void;
+export declare function getNavigationState(): NavigationState;
+/** Calls the listener on each change; returns the function that stops it. */
+export declare function onNavigationStateChange(listener: (state: NavigationState) => void): () => void;
+/**
+ * Resolves once the native side sent a state newer than `since` with a screen in it, at the latest after `timeout`:
+ * the state then shows what the commands before it changed, such as the screen of a new root.
+ */
+export declare function whenScreenAfter(since: NavigationState, timeout: number): Promise<void>;
+/**
+ * Resolves once the state shows the tab: a tab by index at once when it shows already, otherwise on the next change of
+ * the state, and at the latest after `timeout` (a tab by id that shows already changes nothing).
+ */
+export declare function whenTabShows(tab: number | string, timeout?: number): Promise<void>;
+//# sourceMappingURL=navigationState.d.ts.map

package/lib/typescript/api/state/navigationState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationState.d.ts","sourceRoot":"","sources":["../../../../src/api/state/navigationState.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAAyB,CAAC;AAE3E;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,2BAA2B,CAAC;AAQ1D,gHAAgH;AAChH,wBAAgB,uBAAuB,SAatC;AAED,6FAA6F;AAC7F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,oHAAoH;AACpH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAErD;AAED,wBAAgB,kBAAkB,IAAI,eAAe,CAEpD;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,GAAG,MAAM,IAAI,CAK9F;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CActF;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,SAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAa/E"}

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

@@ -0,0 +1,12 @@
+/**
+ * Ids of the views the navigation shows without an id from the app, for end-to-end tests (Detox, Maestro, Appium) to
+ * find them by.
+ */
+export declare const TestIDs: {
+    /**
+     * The back button of a stack's top bar: UIKit gives the system button this id on iOS, and the navigation gives the
+     * same one on Android. `topBar.backButton.testID` sets another on Android.
+     */
+    readonly backButton: "BackButton";
+};
+//# sourceMappingURL=testIDs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"testIDs.d.ts","sourceRoot":"","sources":["../../../src/api/testIDs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,OAAO;IAClB;;;OAGG;;CAEK,CAAC"}

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

@@ -0,0 +1,70 @@
+import type { ColorValue } from 'react-native';
+import type { Color, Options, WindowOptions } from '../../interfaces/Options.js';
+import { ScreenOptions } from '../options/ScreenOptions.js';
+import type { OptionsEnvironment } from '../screens/defineScreen.js';
+/**
+ * The look of the navigation: its bars, tabs and screen backgrounds. A color can be `{ light, dark }`: the native side
+ * picks the one of the system's appearance. A color left out keeps the platform's look: on iOS 26 the glass bars, on
+ * Android the colors of the app's Material 3 theme (`Theme.ApexNavigation`: neutral grays).
+ */
+export interface NavigationTheme {
+    colors?: {
+        /** Buttons of the top bar, the back button, the selected tab, the cursor of the search. */
+        primary?: Color;
+        /** Behind every screen. */
+        background?: Color;
+        /** The top bar and the tab bar. */
+        bar?: Color;
+        /** Titles. */
+        text?: Color;
+        /** The lines under the top bar and over the tab bar. */
+        border?: Color;
+        /** The badges of the tabs. */
+        badge?: Color;
+    };
+}
+/**
+ * The theme as React content takes it: each color for the current appearance, ready for a style. A color the theme
+ * leaves out is undefined.
+ */
+export interface ResolvedNavigationTheme {
+    colors: {
+        [Key in keyof NonNullable<NavigationTheme['colors']>]?: ColorValue;
+    };
+}
+/**
+ * The default options of every screen: options as they are, or a chain built from the theme and the app's context. A
+ * chain is built again when the theme changes.
+ */
+export type AppOptionsInput = Options | ((options: ScreenOptions, app: OptionsEnvironment) => ScreenOptions);
+/** The direction of the app: right to left, left to right, or as the language of the app. */
+export type NavigationDirection = 'ltr' | 'rtl' | 'locale';
+/**
+ * The default options as the native side takes them: the color of the app's window goes with them (iOS), and the
+ * direction of the app.
+ */
+export type DefaultOptions = Options & {
+    window?: WindowOptions;
+    layout?: {
+        direction?: NavigationDirection;
+    };
+};
+/** The app's own default options, over those of the theme: `options` between what goes under and over them. */
+export interface AppDefaults {
+    under?: DefaultOptions;
+    options?: AppOptionsInput;
+    over?: DefaultOptions;
+}
+export declare function getTheme(): NavigationTheme;
+/** The theme's colors for the light or the dark appearance: of a `{ light, dark }` pair the one, others as they are. */
+export declare function resolveTheme({ colors }: NavigationTheme, scheme: 'light' | 'dark'): ResolvedNavigationTheme;
+export declare function subscribeTheme(listener: () => void): () => void;
+/** The theme, the default options and the direction of the app, before its first launch. */
+export declare function initTheme(initial: NavigationTheme | undefined, defaults: AppDefaults, initialDirection?: NavigationDirection): void;
+/** The default options of the theme with the app's own over them; undefined when there are none. */
+export declare function themedDefaultOptions(): DefaultOptions | undefined;
+/** Changes the theme: the screens shown take it too. */
+export declare function setTheme(next: NavigationTheme): void;
+/** Changes the direction of the app: the bars, the transitions and the swipe back follow at once. */
+export declare function setDirection(next: NavigationDirection): void;
+//# sourceMappingURL=theme.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../../../src/api/theme/theme.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA0B,CAAC;AAI9E,OAAO,EAAqB,aAAa,EAAE,MAAM,6BAA0B,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAAyB,CAAC;AAElE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE;QACP,2FAA2F;QAC3F,OAAO,CAAC,EAAE,KAAK,CAAC;QAChB,2BAA2B;QAC3B,UAAU,CAAC,EAAE,KAAK,CAAC;QACnB,mCAAmC;QACnC,GAAG,CAAC,EAAE,KAAK,CAAC;QACZ,cAAc;QACd,IAAI,CAAC,EAAE,KAAK,CAAC;QACb,wDAAwD;QACxD,MAAM,CAAC,EAAE,KAAK,CAAC;QACf,8BAA8B;QAC9B,KAAK,CAAC,EAAE,KAAK,CAAC;KACf,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE;SAAG,GAAG,IAAI,MAAM,WAAW,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU;KAAE,CAAC;CAChF;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GACzB,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,EAAE,kBAAkB,KAAK,aAAa,CAAC,CAAC;AAEjF,6FAA6F;AAC7F,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,mBAAmB,CAAA;KAAE,CAAC;CAC9C,CAAC;AAEF,+GAA+G;AAC/G,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAOD,wBAAgB,QAAQ,IAAI,eAAe,CAE1C;AAED,wHAAwH;AACxH,wBAAgB,YAAY,CAC1B,EAAE,MAAW,EAAE,EAAE,eAAe,EAChC,MAAM,EAAE,OAAO,GAAG,MAAM,GACvB,uBAAuB,CAOzB;AAaD,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAK/D;AAED,4FAA4F;AAC5F,wBAAgB,SAAS,CACvB,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,QAAQ,EAAE,WAAW,EACrB,gBAAgB,CAAC,EAAE,mBAAmB,QAKvC;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,IAAI,cAAc,GAAG,SAAS,CAWjE;AAED,wDAAwD;AACxD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,QAI7C;AAED,qGAAqG;AACrG,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,QAGrD"}

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

@@ -0,0 +1,64 @@
+import type { ComponentType } from 'react';
+import type { NavigationApp } from './app/createNavigation.js';
+import type { RootsMap } from './app/roots.js';
+import type { Arrangement } from './screens/arrangement.js';
+import type { ScreenDefinition } from './screens/defineScreen.js';
+import type { NativeScreen } from './screens/nativeScreens.js';
+import type { ScreenEntry } from './screens/registerScreens.js';
+/**
+ * The app's navigation, for the types of its names and params. An app registers it once:
+ * `declare module '@apexnative/navigation' { interface Register { app: typeof App } }`.
+ */
+export interface Register {
+}
+/** The roots of the registered app; without the registration any name goes. */
+export type RegisteredRoots = Register extends {
+    app: NavigationApp<infer Roots, any>;
+} ? Roots : RootsMap;
+/** The screens of the registered app, those of its groups too; without the registration any name goes. */
+export type RegisteredScreens = Register extends {
+    app: NavigationApp<any, infer Screens>;
+} ? Screens : Record<string, ScreenEntry>;
+export type ScreenName = keyof RegisteredScreens & string;
+/**
+ * The type of the app's context, for `useAppContext`, `navigation.getContext` and the options. It is registered next
+ * to the app, `interface Register { app: typeof App; context: AppContext }`: read from the app it would go round,
+ * since the screens' options are part of the app's type.
+ */
+export type RegisteredContext = Register extends {
+    context: infer Context;
+} ? Context : unknown;
+/** The props a screen takes: what a command gives it. */
+export type ScreenProps<Name extends ScreenName> = PropsOf<RegisteredScreens[Name]>;
+/** The settings of a command with the props of the screen, which are required when the screen has required ones. */
+export type ShowArgs<Name extends ScreenName, Config> = Partial<ScreenProps<Name>> extends ScreenProps<Name> ? [config?: Config & {
+    props?: ScreenProps<Name>;
+}] : [config: Config & {
+    props: ScreenProps<Name>;
+}];
+/**
+ * What is wrong with a screen a layout shows, by the screens of the app: a message, or never when it fits. A screen
+ * named alone needs all its props to be optional; an untyped element is not checked.
+ */
+type ScreenUseError<Use, AppScreens> = 0 extends 1 & Use ? never : Use extends {
+    name: infer Name extends string;
+    props: infer Props;
+} ? string extends Name ? 'a screen goes by its name in screens, not by any string' : Name extends keyof AppScreens ? [Props] extends [undefined] ? Partial<PropsOf<AppScreens[Name]>> extends PropsOf<AppScreens[Name]> ? never : `'${Name}' takes props: Screen('${Name}', props)` : Props extends AsWritten<PropsOf<AppScreens[Name]>> ? never : `the props of '${Name}' are not those its component takes` : `there is no screen '${Name}' in screens` : never;
+type AsWritten<Value> = Value extends (...args: any[]) => unknown ? Value : Value extends readonly (infer Item)[] ? readonly AsWritten<Item>[] : Value extends object ? {
+    readonly [Key in keyof Value]: AsWritten<Value[Key]>;
+} : Value;
+/**
+ * A layout whose screens are screens of the app with their props: unknown. Otherwise a property named by what is
+ * wrong, which no layout has, so the type error says why.
+ */
+export type CheckedScreens<Uses, AppScreens> = [ScreenUseError<Uses, AppScreens>] extends [never] ? unknown : {
+    readonly [Message in `[navigation] ${ScreenUseError<Uses, AppScreens>}`]: never;
+};
+type PropsOf<Entry> = Entry extends Arrangement<infer Props> ? Props : Entry extends NativeScreen<infer Props> ? Props : Entry extends ScreenDefinition<infer Props> ? Props : Entry extends ComponentType<infer Props> ? Props : Entry extends {
+    load: () => infer Module;
+} ? PropsOfModule<Awaited<Module>> : object;
+type PropsOfModule<Module> = Module extends {
+    default: infer Default;
+} ? PropsOf<Default> : PropsOf<Module>;
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/lib/typescript/engine/backListeners.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Tells the native side whether JavaScript listens to the back button (Android). The navigation takes the back button
+ * only while it has something to go back to or JavaScript listens: on the first screen the system then plays its own
+ * animation back to the home screen. React Native keeps the listeners to itself, so `BackHandler.addEventListener` is
+ * wrapped to count them; a listener added before `createNavigation` was called isn't counted.
+ */
+export declare function watchBackListeners(): void;
+//# sourceMappingURL=backListeners.d.ts.map

package/lib/typescript/engine/backListeners.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backListeners.d.ts","sourceRoot":"","sources":["../../../src/engine/backListeners.ts"],"names":[],"mappings":"AAOA;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAsBzC"}

package/lib/typescript/engine/buttons.d.ts

@@ -0,0 +1,11 @@
+import type { NavigationButtonPressedEvent } from '../interfaces/ComponentEvents.js';
+import type { Options } from '../interfaces/Options.js';
+import { toScreenEvent } from './events.js';
+declare let pressEvent: (event: ReturnType<typeof toScreenEvent<NavigationButtonPressedEvent>>) => unknown;
+/** What a press handler gets: the API adds the navigation of the screen to the event. */
+export declare function setPressEvent(make: typeof pressEvent): void;
+/** The options without the press handlers of their buttons, menu items and FAB, which the screen keeps. */
+export declare function takeButtonHandlers(screenId: string, options: Options): Options;
+export declare function clearButtonHandlers(screenId: string): void;
+export {};
+//# sourceMappingURL=buttons.d.ts.map

package/lib/typescript/engine/buttons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buttons.d.ts","sourceRoot":"","sources":["../../../src/engine/buttons.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,kCAA+B,CAAC;AAClF,OAAO,KAAK,EACV,OAAO,EAIR,MAAM,0BAAuB,CAAC;AAC/B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAU,CAAC;AAgBzC,QAAA,IAAI,UAAU,EAAE,CACd,KAAK,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,4BAA4B,CAAC,CAAC,KAClE,OAA0B,CAAC;AAGhC,yFAAyF;AACzF,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,UAAU,GAAG,IAAI,CAE3D;AAED,2GAA2G;AAC3G,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CA4C9E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,QAEnD"}

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

@@ -0,0 +1,38 @@
+import type { Layout, LayoutRoot } from '../interfaces/Layout.js';
+import type { Options } from '../interfaces/Options.js';
+/**
+ * Every root passes here, so a root set with the low-level API comes back too when Android launches again. The last
+ * root set again so comes with the options merged into its nodes since it was set.
+ */
+export declare function setRoot(root: LayoutRoot): Promise<string>;
+export declare function setDefaultOptions(options: Options): void;
+/**
+ * Merges options into a node: a screen, or any node of a layout. Made while a show waits in JS, it goes after it. The
+ * engine remembers them by the node's id, so the root set again for a new launch of the native side shows them too.
+ */
+export declare function mergeOptions(componentId: string, options: Options): void;
+/**
+ * Pushes a layout over the screen. A push that is no longer `wanted` when it is about to go out (a preview whose
+ * component unmounted while its screen loaded or its native screen got its first props) is dropped: its
+ * `dismissPreview` already went, and it would come after it.
+ */
+export declare function push(componentId: string, layout: Layout, wanted?: () => boolean): Promise<string>;
+/**
+ * Takes away a preview that waits on the native side (iOS). A preview whose push hasn't gone out yet isn't there: the
+ * `wanted` of that push drops it.
+ */
+export declare function dismissPreview(previewId: string): void;
+export declare function pop(componentId: string): Promise<string>;
+export declare function popTo(componentId: string): Promise<string>;
+export declare function popToRoot(componentId: string): Promise<string>;
+export declare function setStackRoot(componentId: string, children: Layout[]): Promise<string>;
+export declare function showInColumn(componentId: string, column: string, layout: Layout): Promise<string>;
+/** Shows or hides a column of the split view the screen is in, as the platform does it. */
+export declare function setColumnShown(componentId: string, column: string, shown: boolean): Promise<void>;
+export declare function showModal(layout: Layout): Promise<string>;
+export declare function dismissModal(componentId: string, options?: Options): Promise<string>;
+export declare function dismissAllModals(options?: Options): Promise<string>;
+export declare function showOverlay(layout: Layout): Promise<string>;
+export declare function dismissOverlay(componentId: string): Promise<string>;
+export declare function dismissAllOverlays(): Promise<string>;
+//# sourceMappingURL=commands.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../../src/engine/commands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,yBAAsB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAAuB,CAAC;AAmFrD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BzD;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAGxD;AAaD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAUxE;AA+CD;;;;GAIG;AACH,wBAAgB,IAAI,CAClB,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,MAAM,OAAoB,GACjC,OAAO,CAAC,MAAM,CAAC,CA8BjB;AAoFD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAEtD;AAGD,wBAAgB,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIxD;AAED,wBAAgB,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI1D;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAI9D;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwBrF;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBjG;AAeD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjG;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAazD;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAMpF;AAED,wBAAgB,gBAAgB,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAa3D;AAED,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAInE;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAIpD"}

package/lib/typescript/engine/events.d.ts

@@ -0,0 +1,17 @@
+/** A screen as the app knows it: its id, and its name in `screens`. */
+export interface ScreenRef {
+    id: string;
+    name: string;
+}
+declare const NATIVE_FIELDS: readonly ["componentId", "componentName", "componentType", "passProps"];
+type NativeFields = (typeof NATIVE_FIELDS)[number];
+/** An event of a screen as the app gets it: the screen as `{ id, name }`, without the fields of the native side. */
+export type ScreenEventOf<Event> = Omit<Event, NativeFields> & {
+    screen: ScreenRef;
+};
+/** The event of a screen as the app gets it. */
+export declare function toScreenEvent<Event extends {
+    componentId: string;
+}>(event: Event): ScreenEventOf<Event>;
+export {};
+//# sourceMappingURL=events.d.ts.map

package/lib/typescript/engine/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../src/engine/events.ts"],"names":[],"mappings":"AAEA,uEAAuE;AACvE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,QAAA,MAAM,aAAa,yEAA0E,CAAC;AAC9F,KAAK,YAAY,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnD,oHAAoH;AACpH,MAAM,MAAM,aAAa,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE,YAAY,CAAC,GAAG;IAAE,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAErF,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,KAAK,SAAS;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,EACjE,KAAK,EAAE,KAAK,GACX,aAAa,CAAC,KAAK,CAAC,CAMtB"}

package/lib/typescript/engine/ids.d.ts

@@ -0,0 +1,3 @@
+/** A new id for this run of JavaScript: the prefix and a number all prefixes share, such as `Component12`. */
+export declare function nextId(prefix: string): string;
+//# sourceMappingURL=ids.d.ts.map

package/lib/typescript/engine/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../../src/engine/ids.ts"],"names":[],"mappings":"AAEA,8GAA8G;AAC9G,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAG7C"}

package/lib/typescript/engine/launchState.d.ts

@@ -0,0 +1,25 @@
+import type { LayoutRoot } from '../interfaces/Layout.js';
+import type { Options } from '../interfaces/Options.js';
+/**
+ * What the native side needs again when it launches once more in the same JavaScript runtime: Android destroys the
+ * activity with every screen while JavaScript lives on, then sends AppLaunched again.
+ */
+export declare const launchState: {
+    /** The AppLaunched events received in this JavaScript runtime. */
+    launch: number;
+    /** The launch the current root was set in. */
+    rootLaunch: number;
+    /** The last root set, as it was passed: React screens keep their props, functions included. */
+    root: LayoutRoot | undefined;
+    /** The last default options set. */
+    defaultOptions: Options | undefined;
+};
+/**
+ * Whether a setRoot of this root sets the last root again for a launch of the native side after the one it was set in,
+ * as a new activity needs it, rather than a root of the app's own.
+ */
+export declare function restoresRoot(layout: LayoutRoot): boolean;
+/** Every setRoot passes here, so a root set with the low-level API comes back too. */
+export declare function rememberRoot(layout: LayoutRoot): void;
+export declare function rememberDefaultOptions(options: Options): void;
+//# sourceMappingURL=launchState.d.ts.map

package/lib/typescript/engine/launchState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"launchState.d.ts","sourceRoot":"","sources":["../../../src/engine/launchState.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAAuB,CAAC;AAErD;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB,kEAAkE;;IAElE,8CAA8C;;IAE9C,+FAA+F;UAC5E,UAAU,GAAG,SAAS;IACzC,oCAAoC;oBACP,OAAO,GAAG,SAAS;CACjD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAExD;AAED,sFAAsF;AACtF,wBAAgB,YAAY,CAAC,MAAM,EAAE,UAAU,QAG9C;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAEtD"}

package/lib/typescript/engine/layout.d.ts

@@ -0,0 +1,32 @@
+import type { Layout } from '../interfaces/Layout.js';
+import type { Options } from '../interfaces/Options.js';
+export type LayoutType = 'Component' | 'ExternalComponent' | 'Stack' | 'BottomTabs' | 'SideMenuRoot' | 'SideMenuLeft' | 'SideMenuCenter' | 'SideMenuRight' | 'SplitView' | 'Arrangement';
+/** A node of the layout as the native side reads it. */
+export interface LayoutNode {
+    id: string;
+    type: LayoutType;
+    data: {
+        name?: string;
+        options?: Options;
+        passProps?: object;
+        /** The names of the functions in the props of a native screen, which it calls in JS. */
+        functions?: string[];
+        /** The key of a screen: a push of a screen with the same key goes back to it in its stack. */
+        key?: string;
+        columns?: string[];
+        /** A pair: how it lies (`arrangement` of a screen, `defineArrangement`). */
+        style?: 'split' | 'overlay';
+        axes?: 'horizontal' | 'vertical' | 'both';
+        fraction?: number;
+        primaryEdge?: 'leading' | 'trailing' | 'top' | 'bottom';
+        compact?: 'primary' | 'pair';
+    };
+    children: LayoutNode[];
+}
+/**
+ * The layout as the native side reads it. Each screen gets its id and its own options under those of the show; the
+ * press handlers of its buttons stay here, a native screen goes as an external component, and in one tree a React
+ * screen goes as a slot. The props of the React screens wait here for them. The layout passed stays as it was.
+ */
+export declare function toNativeLayout(layout: Layout): LayoutNode;
+//# sourceMappingURL=layout.d.ts.map

package/lib/typescript/engine/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/engine/layout.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,MAAM,EAKP,MAAM,yBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,0BAAuB,CAAC;AAqBrD,MAAM,MAAM,UAAU,GAClB,WAAW,GACX,mBAAmB,GACnB,OAAO,GACP,YAAY,GACZ,cAAc,GACd,cAAc,GACd,gBAAgB,GAChB,eAAe,GACf,WAAW,GACX,aAAa,CAAC;AAElB,wDAAwD;AACxD,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE;QACJ,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,wFAAwF;QACxF,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,8FAA8F;QAC9F,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,4EAA4E;QAC5E,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,EAAE,YAAY,GAAG,UAAU,GAAG,MAAM,CAAC;QAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,KAAK,GAAG,QAAQ,CAAC;QACxD,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,EAAE,UAAU,EAAE,CAAC;CACxB;AAKD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAazD"}

package/lib/typescript/engine/mergeOptions.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Merges options over the ones before: objects merge key by key, anything else — arrays such as buttons, values,
+ * images — replaces what was there. `undefined` keeps the value before.
+ */
+export declare function mergeOptions<T extends object>(base: T, override: T): T;
+//# sourceMappingURL=mergeOptions.d.ts.map

package/lib/typescript/engine/mergeOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeOptions.d.ts","sourceRoot":"","sources":["../../../src/engine/mergeOptions.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAStE"}

package/lib/typescript/engine/native.d.ts

@@ -0,0 +1,22 @@
+import { type Spec } from '../adapters/NativeANNTurboModule.js';
+/** The commands of the native side; missing without it (Jest). */
+export declare const commands: Spec;
+/** The URL that launched the native side, given once; null without one, and without the native side (Jest). */
+export declare function getLaunchLink(): Promise<string | null>;
+/** What the native side tells the JavaScript at its start. */
+export interface StartInfo {
+    /** The first JavaScript runtime of the process: a cold start, not a reload. */
+    coldStart: boolean;
+    /** The size of the native splash's logo as the CLI wrote it, in points (dp); null without it. */
+    splashLogo: {
+        width: number;
+        height: number;
+    } | null;
+    /** Whether the native side shows two screens as a pair: iOS 27.1+ built with its SDK, Android. */
+    arrangements: boolean;
+}
+/** What the native side tells at the start, asked once; without the native side (Jest) a cold start without a logo. */
+export declare function getStartInfo(): StartInfo;
+/** Listens to an event of the native side, `ANN.<name>`; returns the function that stops listening. */
+export declare function onNativeEvent<Event>(name: string, listener: (event: Event) => void): () => void;
+//# sourceMappingURL=native.d.ts.map

package/lib/typescript/engine/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../../src/engine/native.ts"],"names":[],"mappings":"AACA,OAAqB,EAAE,KAAK,IAAI,EAAE,MAAM,qCAAkC,CAAC;AAG3E,kEAAkE;AAClE,eAAO,MAAM,QAAQ,EAAE,IAAmB,CAAC;AAc3C,+GAA+G;AAC/G,wBAAgB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAEtD;AAED,8DAA8D;AAC9D,MAAM,WAAW,SAAS;IACxB,+EAA+E;IAC/E,SAAS,EAAE,OAAO,CAAC;IACnB,iGAAiG;IACjG,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACrD,kGAAkG;IAClG,YAAY,EAAE,OAAO,CAAC;CACvB;AAID,uHAAuH;AACvH,wBAAgB,YAAY,IAAI,SAAS,CAOxC;AAED,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,MAAM,IAAI,CAG/F"}

package/lib/typescript/engine/nativeScreens.d.ts

@@ -0,0 +1,49 @@
+import type { ComponentType } from 'react';
+import type { LayoutNode } from './layout.js';
+/** What the hidden host renders for a native screen with `useProps`. */
+export interface NativeControllerProps {
+    componentId: string;
+    /** The props of the command that showed the screen. */
+    props: object;
+    /** What the hook returned, after each render React committed. */
+    onProps(props: object): void;
+    /** The hook failed: a command still waiting for it fails. */
+    onError(error: unknown): void;
+}
+/** The hook of a native screen, as the hidden host renders it. */
+export interface NativeScreenHook extends NativeControllerProps {
+    /** Tells apart two screens shown under one id, so the later one starts with a hook of its own. */
+    key: string;
+    Controller: ComponentType<NativeControllerProps>;
+}
+/** The hooks of the open native screens, for the hidden host. */
+export declare const nativeScreenHooks: {
+    subscribe(listener: () => void): () => void;
+    get: () => readonly NativeScreenHook[];
+};
+/**
+ * A native screen a command shows. Its props go into the node, the data apart from the names of the functions; a
+ * screen with `useProps` starts its hook, and its props go in once the hook has returned (`whenNativeScreensReady`).
+ */
+export declare function showNativeScreen(node: LayoutNode, name: string, props: object): void;
+/**
+ * Sends a command once the native screens it shows have their props: those with `useProps` wait for the first result
+ * of the hook, the others go at once. When the command fails, its native screens go.
+ */
+export declare function whenNativeScreensReady(nodes: LayoutNode[], send: () => Promise<string>): Promise<string>;
+/** Runs a function of the props of a native screen, which the native side called by its name. */
+export declare function callNativeScreenFunction(id: string, name: string, args: unknown[]): unknown;
+/** The native screen with the id, for the navigation of its calls. */
+export declare function nativeScreenInfo(id: string): {
+    id: string;
+    name: string;
+} | undefined;
+/** Gives the native side what its call came to: what it returned, as plain data, or the error's message. */
+export declare function answerNativeScreenCall(callId: string, outcome: Promise<unknown>): void;
+/** The hidden host renders, or is gone (a reload); the commands waiting for it go on. */
+export declare function hostMountedChanged(mounted: boolean): void;
+/** Starts the hidden host that runs the hooks (in one tree it runs already); resolves once it renders. */
+export declare function startHost(): Promise<void>;
+/** Listens to the native side letting its screens go, once for the app. */
+export declare function listenToNativeScreens(): void;
+//# sourceMappingURL=nativeScreens.d.ts.map