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

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

@@ -0,0 +1,69 @@
+import type { ModalOptions, OptionsModalPopover, OptionsModalPresentationStyle, OptionsModalSheet } from '../../interfaces/Options.js';
+import type { ScreenOptionsInput } from '../screens/defineScreen.js';
+import type { Transition } from './transitions.js';
+/** How `push` shows a screen. */
+export interface PushConfig {
+    /**
+     * How the screen comes and goes: a preset (`'fade'`, `'slideUp'`, `'scale'`…), the zoom of iOS 18 out of a view, or
+     * views that move into the screen. The way back is the same in reverse. `options.animations` go over it.
+     */
+    transition?: Transition;
+    /** Options of the screen for this show, over those of its definition. */
+    options?: ScreenOptionsInput<object>;
+}
+/** How `showInColumn` shows a screen. */
+export interface ColumnConfig {
+    /**
+     * The column: `'secondary'`, the one beside the sidebar, or `'supplementary'`, the middle one of three. Android has
+     * the secondary column only.
+     */
+    column?: 'secondary' | 'supplementary';
+    /** Options of the screen for this show, over those of its definition. */
+    options?: ScreenOptionsInput<object>;
+}
+/** How `showModal` shows a screen. */
+export interface ModalConfig {
+    /** The presentation style of the modal. */
+    style?: `${OptionsModalPresentationStyle}`;
+    /** A sheet with detents (on Android the Material bottom sheet); it is a page sheet unless `style` says otherwise. */
+    sheet?: OptionsModalSheet;
+    /** #### (iOS specific) A popover from a button or a view; it is a popover unless `style` says otherwise. */
+    popover?: OptionsModalPopover;
+    /** #### (iOS specific) The size of a form sheet. */
+    contentSize?: ModalOptions['contentSize'];
+    /** `false`: the screen shows without a stack around it, so without a top bar. */
+    stack?: boolean;
+    /**
+     * A close button at the leading edge of the modal's first screen, which dismisses the modal: the system one on iOS,
+     * an icon on Android. Its id and testID are `CloseButton`. Needs the stack.
+     */
+    closeButton?: boolean;
+    /**
+     * Called once the modal is gone, whatever dismissed it: a command, a swipe, a new root. `setStack` inside the
+     * modal replaces its first screen, and calls it too.
+     */
+    onDismiss?: () => void;
+    /**
+     * How the screen comes and goes: a preset (`'fade'`, `'slideUp'`, `'scale'`…), the zoom of iOS 18 out of a view, or
+     * views that move into the screen. The way back is the same in reverse. `options.animations` go over it.
+     */
+    transition?: Transition;
+    /** Options of the screen for this show, over those of its definition. */
+    options?: ScreenOptionsInput<object>;
+}
+/**
+ * How `showOverlay` shows a screen; its background is transparent. Touches outside its views reach the app under it.
+ */
+export interface OverlayConfig {
+    /** Touches outside the overlay's views don't reach the app: a small overlay that still stops it. */
+    blockTouches?: boolean;
+    /** Options of the screen for this show, over those of its definition. */
+    options?: ScreenOptionsInput<object>;
+}
+/** What every push, modal and overlay of the app starts from; the settings of a command go over it. */
+export interface Presentation {
+    push?: PushConfig;
+    modal?: Omit<ModalConfig, 'onDismiss'>;
+    overlay?: OverlayConfig;
+}
+//# sourceMappingURL=presentation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"presentation.d.ts","sourceRoot":"","sources":["../../../../src/api/commands/presentation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,6BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4BAAyB,CAAC;AAClE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAe,CAAC;AAEhD,iCAAiC;AACjC,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yEAAyE;IACzE,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,yCAAyC;AACzC,MAAM,WAAW,YAAY;IAC3B;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,eAAe,CAAC;IACvC,yEAAyE;IACzE,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAW;IAC1B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,GAAG,6BAA6B,EAAE,CAAC;IAC3C,qHAAqH;IACrH,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,4GAA4G;IAC5G,OAAO,CAAC,EAAE,mBAAmB,CAAC;IAC9B,oDAAoD;IACpD,WAAW,CAAC,EAAE,YAAY,CAAC,aAAa,CAAC,CAAC;IAC1C,iFAAiF;IACjF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,IAAI,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,yEAAyE;IACzE,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,oGAAoG;IACpG,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,OAAO,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,KAAK,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB"}

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

@@ -0,0 +1,14 @@
+type MenuSide = 'left' | 'right';
+/** Keeps the center the user saw last and the open menu of each side menu; the app starts it with its state. */
+export declare function watchSideMenus(): void;
+/** The screen of the center a menu screen acts from, when the menu has one. */
+export declare function centerOf(menuId: string): string | undefined;
+/** Opens a menu of the side menu the screen is in; resolves once it is open and the state shows its screen. */
+export declare function openMenu(screenId: string, side: MenuSide): Promise<void>;
+/**
+ * Closes the menu that is open in the side menu the screen is in; resolves once it is closed and the state shows the
+ * screen under it.
+ */
+export declare function closeMenu(screenId: string): Promise<void>;
+export {};
+//# sourceMappingURL=sideMenus.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sideMenus.d.ts","sourceRoot":"","sources":["../../../../src/api/commands/sideMenus.ts"],"names":[],"mappings":"AAMA,KAAK,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAWjC,gHAAgH;AAChH,wBAAgB,cAAc,IAAI,IAAI,CAerC;AAED,+EAA+E;AAC/E,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE3D;AA2DD,+GAA+G;AAC/G,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQxE;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASzD"}

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

@@ -0,0 +1,33 @@
+import type { AnimationOptions, ScreenAnimationOptions } from '../../interfaces/Options.js';
+/** A ready transition: how a screen comes, and the same in reverse when it goes. */
+export type TransitionPreset = 'platform' | 'none' | 'fade' | 'slideUp' | 'slideFromEnd' | 'scale';
+/**
+ * How a screen comes and goes; the way back is the same in reverse. A preset, a preset with its duration, the zoom of
+ * iOS 18 out of the view with a `nativeID`, or views that move from this screen into the new one (`nativeID` pairs,
+ * with a fade of the rest unless `type` says otherwise).
+ */
+export type Transition = TransitionPreset | {
+    type: TransitionPreset;
+    duration?: number;
+} | {
+    zoom: string;
+} | {
+    shared: [from: string, to: string][];
+    type?: TransitionPreset;
+    duration?: number;
+};
+/**
+ * The content of a preset as the screen comes (`show`) and as it goes (`hide`); none for `platform` and `none`.
+ * `slideFromEnd` comes from the right, or from the left in a right-to-left layout.
+ */
+export declare function presetContent(preset: TransitionPreset, duration?: number): {
+    show: ScreenAnimationOptions;
+    hide: ScreenAnimationOptions;
+} | undefined;
+/** The animations of a push and of the pop of the screen it shows. */
+export declare function pushAnimations(transition: Transition | undefined): AnimationOptions | undefined;
+/** The animations of a modal as it shows and as it is dismissed. */
+export declare function modalAnimations(transition: Transition | undefined): AnimationOptions | undefined;
+/** The object without its undefined values, so they don't go to the native side. */
+export declare function defined<T extends object>(value: T): T;
+//# sourceMappingURL=transitions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"transitions.d.ts","sourceRoot":"","sources":["../../../../src/api/commands/transitions.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,6BAA0B,CAAC;AAEzF,oFAAoF;AACpF,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,OAAO,CAAC;AAEnG;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAClB,gBAAgB,GAChB;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IAAC,IAAI,CAAC,EAAE,gBAAgB,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAyBzF;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,MAAM,EAAE,gBAAgB,EACxB,QAAQ,GAAE,MAAiB,GAC1B;IAAE,IAAI,EAAE,sBAAsB,CAAC;IAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,GAAG,SAAS,CAmC5E;AASD,sEAAsE;AACtE,wBAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAe/F;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAiBhG;AAED,oFAAoF;AACpF,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAErD"}

package/lib/typescript/api/context/appContext.d.ts

@@ -0,0 +1,4 @@
+export declare function getAppContext<Context>(): Context;
+export declare function setAppContext<Context>(next: Context | ((previous: Context) => Context)): void;
+export declare function subscribeAppContext(listener: () => void): () => void;
+//# sourceMappingURL=appContext.d.ts.map

package/lib/typescript/api/context/appContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appContext.d.ts","sourceRoot":"","sources":["../../../../src/api/context/appContext.ts"],"names":[],"mappings":"AAKA,wBAAgB,aAAa,CAAC,OAAO,KAAK,OAAO,CAEhD;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,QAMtF;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKpE"}

package/lib/typescript/api/events/navigationEvents.d.ts

@@ -0,0 +1,70 @@
+import { type ScreenEventOf } from '../../engine/events.js';
+import type { BottomAccessoryPlacementChangedEvent, ComponentDidAppearEvent, ComponentDidDisappearEvent, ComponentWillAppearEvent, KeyCommandPressedEvent as NativeKeyCommandPressedEvent, ModalAttemptedToDismissEvent, ModalDismissedEvent as NativeModalDismissedEvent, NavigationButtonPressedEvent, PreviewCompletedEvent as NativePreviewCompletedEvent, ScreenPoppedEvent as NativeScreenPoppedEvent, SearchBarCancelPressedEvent, SearchSuggestionPickedEvent as NativeSearchSuggestionPickedEvent, SearchBarSubmittedEvent, SearchBarUpdatedEvent, SheetDetentChangedEvent as NativeSheetDetentChangedEvent, SplitViewDisplayModeChangedEvent as NativeSplitViewDisplayModeChangedEvent, TitleRenamedEvent as NativeTitleRenamedEvent } from '../../interfaces/ComponentEvents.js';
+import type { BottomTabLongPressedEvent, BottomTabPressedEvent, BottomTabSelectedEvent } from '../../interfaces/Events.js';
+import { type NavigationState } from '../state/navigationState.js';
+/** The events of the navigation by name, with what each one gets; the events of a screen carry it as `screen`. */
+export interface NavigationEvents {
+    /** A screen is about to appear; the components of the bars (title, buttons, background) are not screens. */
+    screenWillAppear: ScreenEventOf<ComponentWillAppearEvent>;
+    /** A screen appeared. */
+    screenDidAppear: ScreenEventOf<ComponentDidAppearEvent>;
+    /** A screen disappeared: something covers it, or it left. */
+    screenDidDisappear: ScreenEventOf<ComponentDidDisappearEvent>;
+    /** A screen left its stack by back, a swipe or `pop`. */
+    screenPopped: ScreenEventOf<NativeScreenPoppedEvent>;
+    buttonPressed: ScreenEventOf<NavigationButtonPressedEvent>;
+    tabSelected: BottomTabSelectedEvent;
+    tabPressed: BottomTabPressedEvent;
+    tabLongPressed: BottomTabLongPressedEvent;
+    modalDismissed: ScreenEventOf<NativeModalDismissedEvent>;
+    /** A swipe tried to dismiss a modal whose screen keeps the user (`usePreventLeave`). */
+    modalDismissAttempted: ScreenEventOf<ModalAttemptedToDismissEvent>;
+    searchChanged: ScreenEventOf<SearchBarUpdatedEvent>;
+    searchSubmitted: ScreenEventOf<SearchBarSubmittedEvent>;
+    searchCancelled: ScreenEventOf<SearchBarCancelPressedEvent>;
+    /** #### (iOS 16+, Android) The user picked a suggestion of `searchBar.suggestions`; the text stays. */
+    searchSuggestionPicked: ScreenEventOf<NativeSearchSuggestionPickedEvent>;
+    /** #### (iOS specific) */
+    sheetDetentChanged: ScreenEventOf<NativeSheetDetentChangedEvent>;
+    /** #### (iOS specific) */
+    splitViewDisplayModeChanged: NativeSplitViewDisplayModeChangedEvent;
+    keyCommandPressed: ScreenEventOf<NativeKeyCommandPressedEvent>;
+    /** #### (iOS specific) */
+    titleRenamed: ScreenEventOf<NativeTitleRenamedEvent>;
+    /** #### (iOS specific, iOS 26+) */
+    accessoryPlacementChanged: BottomAccessoryPlacementChangedEvent;
+    /** #### (iOS specific) */
+    previewCompleted: ScreenEventOf<NativePreviewCompletedEvent>;
+    /** What the user sees changed: the screen or the selected tab. */
+    stateChanged: NavigationState;
+}
+export type NavigationEventName = keyof NavigationEvents;
+export type ScreenWillAppearEvent = NavigationEvents['screenWillAppear'];
+export type ScreenDidAppearEvent = NavigationEvents['screenDidAppear'];
+export type ScreenDidDisappearEvent = NavigationEvents['screenDidDisappear'];
+export type ScreenPoppedEvent = NavigationEvents['screenPopped'];
+export type ButtonPressedEvent = NavigationEvents['buttonPressed'];
+export type TabSelectedEvent = NavigationEvents['tabSelected'];
+export type TabPressedEvent = NavigationEvents['tabPressed'];
+export type TabLongPressedEvent = NavigationEvents['tabLongPressed'];
+export type ModalDismissedEvent = NavigationEvents['modalDismissed'];
+export type ModalDismissAttemptedEvent = NavigationEvents['modalDismissAttempted'];
+export type SearchChangedEvent = NavigationEvents['searchChanged'];
+export type SearchSubmittedEvent = NavigationEvents['searchSubmitted'];
+export type SearchCancelledEvent = NavigationEvents['searchCancelled'];
+export type SearchSuggestionPickedEvent = NavigationEvents['searchSuggestionPicked'];
+export type SheetDetentChangedEvent = NavigationEvents['sheetDetentChanged'];
+export type SplitViewDisplayModeChangedEvent = NavigationEvents['splitViewDisplayModeChanged'];
+export type KeyCommandPressedEvent = NavigationEvents['keyCommandPressed'];
+export type TitleRenamedEvent = NavigationEvents['titleRenamed'];
+export type AccessoryPlacementChangedEvent = NavigationEvents['accessoryPlacementChanged'];
+export type PreviewCompletedEvent = NavigationEvents['previewCompleted'];
+/** Handlers of the events of the navigation, by event name. */
+export type NavigationListeners = {
+    [Name in NavigationEventName]?: (event: NavigationEvents[Name]) => void;
+};
+/** Listens to an event of the navigation; returns the function that stops listening. */
+export declare function onNavigationEvent<Name extends NavigationEventName>(name: Name, handler: (event: NavigationEvents[Name]) => void): () => void;
+/** Listens to the events of `listeners`, for as long as the app runs. */
+export declare function addNavigationListeners(listeners: NavigationListeners): void;
+//# sourceMappingURL=navigationEvents.d.ts.map

package/lib/typescript/api/events/navigationEvents.d.ts.map

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

package/lib/typescript/api/events/screenLifecycle.d.ts

@@ -0,0 +1,5 @@
+/** Runs the handler once the screen unmounts: its native screen is gone. */
+export declare function whenScreenUnmounts(screenId: string, handler: () => void): void;
+/** A screen of `screens` unmounted. */
+export declare function screenUnmounted(screenId: string): void;
+//# sourceMappingURL=screenLifecycle.d.ts.map

package/lib/typescript/api/events/screenLifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenLifecycle.d.ts","sourceRoot":"","sources":["../../../../src/api/events/screenLifecycle.ts"],"names":[],"mappings":"AAUA,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,IAAI,QAEvE;AAED,uCAAuC;AACvC,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,QAU/C"}

package/lib/typescript/api/events/tabPresses.d.ts

@@ -0,0 +1,5 @@
+import type { TabPressHandler } from '../../engine/tabs.js';
+export type { TabPressEvent, TabPressHandler } from '../../engine/tabs.js';
+/** Calls the handler when the tab of the screen is pressed while it shows the screen; returns the function to stop. */
+export declare function onScreenTabPress(screenId: string, handler: TabPressHandler): () => void;
+//# sourceMappingURL=tabPresses.d.ts.map

package/lib/typescript/api/events/tabPresses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabPresses.d.ts","sourceRoot":"","sources":["../../../../src/api/events/tabPresses.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,sBAAmB,CAAC;AAGxE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAmB,CAAC;AAMxE,uHAAuH;AACvH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,MAAM,IAAI,CASvF"}

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

@@ -0,0 +1,21 @@
+/** The device's hinge. */
+export interface Hinge {
+    /**
+     * `closed`, `partiallyOpen`, `fullyOpen` (open as far as the device allows), or `unknown`. On Android `closed` is
+     * told by the hinge angle sensor: the app's window has no fold and the angle is below 90°.
+     */
+    state: 'closed' | 'partiallyOpen' | 'fullyOpen' | 'unknown';
+    /**
+     * Degrees: 0 closed, 180 open flat, beyond 180 on Android devices that fold back. Null where the platform gives no
+     * angle: on Android without a hinge sensor, and on iOS while the state is unknown.
+     */
+    angle: number | null;
+}
+/** The last hinge value; null without a hinge and before the native side sent the first one. */
+export declare function getHinge(): Hinge | null;
+/**
+ * Calls `listener` on every change of the hinge; returns the function that stops it. The native side watches the hinge
+ * only while something listens: a hinge sensor on Android costs power.
+ */
+export declare function subscribeHinge(listener: (hinge: Hinge | null) => void): () => void;
+//# sourceMappingURL=hinge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hinge.d.ts","sourceRoot":"","sources":["../../../../src/api/hinge/hinge.ts"],"names":[],"mappings":"AAIA,0BAA0B;AAC1B,MAAM,WAAW,KAAK;IACpB;;;OAGG;IACH,KAAK,EAAE,QAAQ,GAAG,eAAe,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5D;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAOD,gGAAgG;AAChG,wBAAgB,QAAQ,IAAI,KAAK,GAAG,IAAI,CASvC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI,CAOlF"}

package/lib/typescript/api/hooks/appHooks.d.ts

@@ -0,0 +1,15 @@
+import { type ResolvedNavigationTheme } from '../theme/theme.js';
+import type { RegisteredContext } from '../types.js';
+/**
+ * The theme of the navigation, its colors for the current appearance: they go straight into styles. The component
+ * renders again when `navigation.setTheme` changes the theme, and when the appearance turns light or dark.
+ */
+export declare function useNavigationTheme(): ResolvedNavigationTheme;
+/**
+ * The app's context: `context` of createNavigation, as `navigation.setContext` changed it since. Any component, in any
+ * screen. With `select`, the component renders again only when the selected part changes, so a change of the language
+ * doesn't render a component that reads the user; without it, on every change.
+ */
+export declare function useAppContext<Context = RegisteredContext>(): Context;
+export declare function useAppContext<Selected, Context = RegisteredContext>(select: (context: Context) => Selected): Selected;
+//# sourceMappingURL=appHooks.d.ts.map

package/lib/typescript/api/hooks/appHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appHooks.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/appHooks.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,uBAAuB,EAE7B,MAAM,mBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAU,CAAC;AAElD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,uBAAuB,CAI5D;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAG,iBAAiB,KAAK,OAAO,CAAC;AACtE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,iBAAiB,EACjE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GACrC,QAAQ,CAAC"}

package/lib/typescript/api/hooks/screenHooks.d.ts

@@ -0,0 +1,74 @@
+import { type TabPressHandler } from '../events/tabPresses.js';
+import { type ButtonPressedEvent, type NavigationEventName, type NavigationEvents, type ScreenDidAppearEvent, type ScreenDidDisappearEvent, type SearchCancelledEvent, type SearchChangedEvent, type SearchSubmittedEvent } from '../events/navigationEvents.js';
+/** The events a screen hears about itself: those that carry the screen, and the move of the accessory it shows. */
+export type ScreenEventName = {
+    [Name in NavigationEventName]: NavigationEvents[Name] extends {
+        screen: unknown;
+    } ? Name : never;
+}[NavigationEventName] | 'accessoryPlacementChanged';
+import { ScreenOptions } from '../options/ScreenOptions.js';
+import { type NavigationState } from '../state/navigationState.js';
+import { type ScreenInfo } from '../screens/registerScreens.js';
+/**
+ * While `prevent` is true, keeps the user on this screen: the back button, the swipe back and the history menu (iOS),
+ * the system back (Android), the swipe down of the modal the screen is in and its close button call `onAttempt`
+ * instead, so the screen can ask. The commands of the app are not held: `goBack()` after the user agreed leaves.
+ * Leaving the app is not held either: on the first screen of the root the system back of Android leaves it, as the
+ * home gesture does on iOS; to ask before that, React Native's `BackHandler`.
+ */
+export declare function usePreventLeave(prevent: boolean, onAttempt: () => void): void;
+/** The screen the component is in. */
+export declare function useScreen(): ScreenInfo;
+/**
+ * An event of the screen the component is in, by its name in `listeners` and `navigation.on`: only this screen's. The
+ * handler can change on every render.
+ *
+ * @example
+ * useScreenEvent('sheetDetentChanged', ({ detent }) => {
+ *   setExpanded(detent === 'large');
+ * });
+ */
+export declare function useScreenEvent<Name extends ScreenEventName>(name: Name, handler: (event: NavigationEvents[Name]) => void): void;
+/** Each time the screen appears. */
+export declare function useScreenAppear(handler: (event: ScreenDidAppearEvent) => void): void;
+/** Each time the screen disappears: something covers it, or it leaves. */
+export declare function useScreenDisappear(handler: (event: ScreenDidDisappearEvent) => void): void;
+/**
+ * Runs the effect each time the screen gets the focus, and its cleanup when it loses it or unmounts: a refresh, a
+ * subscription, a video that plays only while the screen shows. The screen has the focus while it shows and nothing
+ * covers it: a modal or a sheet over it takes the focus away, and its closing gives it back. A component mounted while
+ * its screen has the focus runs it at once; mounted under a sheet, once the sheet goes.
+ */
+export declare function useFocusEffect(effect: () => void | (() => void)): void;
+/**
+ * What the user sees: the screen and the selected tab. The component renders again when the selected part changes, so
+ * select only what it needs.
+ */
+export declare function useNavigationState(): NavigationState;
+export declare function useNavigationState<Selected>(select: (state: NavigationState) => Selected): Selected;
+/** The screen the component is in is the one the user sees. */
+export declare function useIsFocused(): boolean;
+/** A press on a button of the screen's top bar or toolbar. */
+export declare function useNavigationButton(buttonId: string, handler: (event: ButtonPressedEvent) => void): void;
+/** The search bar of the screen. */
+export declare function useSearchBar(handlers: {
+    onChange?: (event: SearchChangedEvent) => void;
+    onSubmit?: (event: SearchSubmittedEvent) => void;
+    onCancel?: (event: SearchCancelledEvent) => void;
+    /** (iOS 16+, Android) A suggestion of `searchBar.suggestions` is picked, by its `id`; the text stays. */
+    onSuggestion?: (suggestionId: string) => void;
+}): void;
+/**
+ * Options of the screen from its state, such as a title from loaded data or a button that turns on. They are built on
+ * each render and applied before the screen paints when they changed; buttons take `onPress`, and a new handler takes
+ * the press at once.
+ */
+export declare function useScreenOptions(build: (options: ScreenOptions) => ScreenOptions): void;
+/** Listens to an event of the whole navigation while the component is mounted. */
+export declare function useNavigationEvent<Name extends NavigationEventName>(name: Name, handler: (event: NavigationEvents[Name]) => void): void;
+/**
+ * Called when the tab of this screen is pressed while the tab shows it; `wasSelected` tells a second press, on which
+ * apps scroll to the top. The handler can change on every render.
+ */
+export declare function useTabPress(handler: TabPressHandler): void;
+//# sourceMappingURL=screenHooks.d.ts.map

package/lib/typescript/api/hooks/screenHooks.d.ts.map

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

package/lib/typescript/api/hooks/useArrangement.d.ts

@@ -0,0 +1,13 @@
+import { type ArrangementState } from '../arrangement/arrangementState.js';
+/**
+ * How this screen's pair (`arrangement` of a screen, or `defineArrangement`) shows now: which view the screen is, how the two lie, whether the
+ * screen is over the other one or out of the window. Null for a screen outside a pair. Changes as the window and the
+ * fold change, as the safe area does.
+ *
+ * @example
+ * // A list under a player: shorter while the player covers it.
+ * const pair = useArrangement();
+ * const collapsed = pair?.layout === 'overlay' && !pair.front;
+ */
+export declare function useArrangement(): ArrangementState | null;
+//# sourceMappingURL=useArrangement.d.ts.map

package/lib/typescript/api/hooks/useArrangement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useArrangement.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/useArrangement.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,gBAAgB,EAGtB,MAAM,oCAAiC,CAAC;AAGzC;;;;;;;;;GASG;AACH,wBAAgB,cAAc,IAAI,gBAAgB,GAAG,IAAI,CAOxD"}

package/lib/typescript/api/hooks/useHinge.d.ts

@@ -0,0 +1,16 @@
+import { type Hinge } from '../hinge/hinge.js';
+/**
+ * The device's hinge: its state and angle. Null on a device without a hinge, and for the moment before the first value
+ * comes. The screen renders again on every change, often while the hinge moves: for an animation driven by the angle,
+ * `useHingeChange`. For the layout of a screen the fold calls for, `defineArrangement` and `useReservedRegions`.
+ */
+export declare function useHinge(): Hinge | null;
+/**
+ * Calls `listener` on every change of the hinge, without rendering again: for animations driven by the angle.
+ *
+ * @example
+ * const lid = useRef(new Animated.Value(180)).current;
+ * useHingeChange((hinge) => lid.setValue(hinge?.angle ?? 180));
+ */
+export declare function useHingeChange(listener: (hinge: Hinge | null) => void): void;
+//# sourceMappingURL=useHinge.d.ts.map

package/lib/typescript/api/hooks/useHinge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHinge.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/useHinge.ts"],"names":[],"mappings":"AACA,OAAO,EAAY,KAAK,KAAK,EAAkB,MAAM,mBAAgB,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,KAAK,GAAG,IAAI,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,IAAI,CAM5E"}

package/lib/typescript/api/hooks/useNavigation.d.ts

@@ -0,0 +1,108 @@
+import type { SplitColumn } from '../commands/commands.js';
+import type { ColumnConfig, ModalConfig, OverlayConfig, PushConfig } from '../commands/presentation.js';
+import type { StackEntry } from '../layout/Stack.js';
+import { type AppNavigation, type CheckedEntries } from '../navigation.js';
+import type { ScreenOptionsInput } from '../screens/defineScreen.js';
+import { type ScreenInfo } from '../screens/registerScreens.js';
+import type { ScreenName, ShowArgs } from '../types.js';
+/** The commands that act from the screen, so they take no ids. */
+interface ScreenCommands {
+    /** The screen the commands act from. */
+    readonly screen: ScreenInfo;
+    /** Shows a screen over this one in its stack; resolves with the id of the screen shown. */
+    push<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, PushConfig>): Promise<string>;
+    /**
+     * Goes back to the screen before this one in its stack. The first screen of a split view column shown over the list
+     * (a phone) goes back to the list.
+     */
+    pop(): Promise<string>;
+    /** Goes back to a screen of this stack, by its id. */
+    popTo(screenId: string): Promise<string>;
+    /** Goes back to the first screen of this stack. */
+    popToRoot(): Promise<string>;
+    /**
+     * Shows a screen in place of the whole history of this stack: it comes in as a push does and is alone in the stack,
+     * so there is no back. For a point the user shouldn't go back from, such as a payment once it is made. Resolves with
+     * the id of the screen shown.
+     */
+    replace<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, PushConfig>): Promise<string>;
+    /** Replaces the screens of this stack: the last one shows, back goes to the one before. */
+    setStack<const Entries extends readonly StackEntry[]>(...entries: CheckedEntries<Entries>): Promise<string>;
+    /**
+     * Shows a screen in a column of the split view this screen is in, in place of what the column shows: Details beside
+     * a list. The column comes into view: a sidebar over it goes away; collapsed into one stack (iPhone, a narrow
+     * window) the screen goes on top, and back comes here; on Android the secondary pane comes over the primary one.
+     * With a `compact` layout on screen and outside a split view the screen is pushed over this one.
+     *
+     * @example
+     * // Settings: sections in the sidebar, the picked one beside them.
+     * navigation.switchTo(
+     *   SplitView({ primary: Screen('Settings'), secondary: Screen('Details') })
+     * );
+     *
+     * function Settings() {
+     *   const navigation = useNavigation();
+     *   const open = (section: string) =>
+     *     navigation.showInColumn('Details', { props: { section } });
+     *   return <Button title="Profile" onPress={() => open('profile')} />;
+     * }
+     */
+    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>;
+    /** Closes the modal or the overlay this screen is in, with all its screens. */
+    dismiss(): Promise<string>;
+    /**
+     * There is a screen under this one in its stack, or this one is the first of a split view column shown over the list
+     * (a phone), so `pop()` has one to go back to. Answers at once.
+     */
+    canPop(): boolean;
+    /** This screen is in a modal or an overlay, so `dismiss()` has one to close. Answers at once. */
+    canDismiss(): boolean;
+    /**
+     * What the back button would do here: `pop()` when there is a screen under this one in its stack, `dismiss()` when it
+     * is the first screen of a modal. For a screen that opens both ways, pushed in one place and in a modal in another.
+     */
+    goBack(): Promise<string>;
+    /** `goBack()` has something to do: `canPop()` or `canDismiss()`. Answers at once. */
+    canGoBack(): boolean;
+    /** Shows a screen over everything, without taking the place of any. */
+    showOverlay<Name extends ScreenName>(name: Name, ...args: ShowArgs<Name, OverlayConfig>): Promise<string>;
+    /**
+     * Shows a column of the split view this screen is in, as the platform does for the split behavior: the sidebar
+     * (`'primary'`), the middle column (`'supplementary'`), the inspector. Resolves once the columns have moved. On
+     * Android the primary pane: beside the secondary one it comes back, under it the secondary pane goes away.
+     */
+    showColumn(column: SplitColumn): Promise<void>;
+    /** Hides a column of the split view this screen is in: `hideColumn('primary')` leaves the item alone. */
+    hideColumn(column: SplitColumn): Promise<void>;
+    /** Opens a menu of the side menu this screen is in; resolves once it is open and `getState()` shows its screen. */
+    openMenu(side: 'left' | 'right'): Promise<void>;
+    /**
+     * Closes the menu that is open in the side menu this screen is in; resolves once it is closed and `getState()` shows
+     * the center.
+     */
+    closeMenu(): Promise<void>;
+    /** Changes the options of this screen. */
+    setOptions(options: ScreenOptionsInput<object>): void;
+    /**
+     * Selects a tab of the tabs this screen is in: by its index, or by the id of the tab (`Tab().id()`). Resolves once the
+     * state shows it, as `navigation.selectTab` does.
+     */
+    selectTab(tab: number | string): Promise<void>;
+    /** The badge of this screen's tab, or of the tab with the id; `null` and the number `0` take it away. */
+    setTabBadge(badge: string | number | null, tab?: string): Promise<void>;
+}
+/**
+ * The navigation of a screen: its own commands act from it and take no ids, and the commands of the whole app are
+ * here too (`switchTo`, `dismissAllModals`, `getState`, `on`, the theme and the context), so a screen needs nothing
+ * else.
+ */
+export interface ScreenNavigation extends Omit<AppNavigation, keyof ScreenCommands>, ScreenCommands {
+}
+/** The navigation of the screen the component is in. */
+export declare function useNavigation(): ScreenNavigation;
+/** The navigation of a screen, for code outside React that knows the screen. */
+export declare function screenNavigation(screen: ScreenInfo): ScreenNavigation;
+export {};
+//# sourceMappingURL=useNavigation.d.ts.map

package/lib/typescript/api/hooks/useNavigation.d.ts.map

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

package/lib/typescript/api/hooks/usePendingLink.d.ts

@@ -0,0 +1,7 @@
+import type { PendingLink } from '../linking/types.js';
+/**
+ * The link that waits for `when` of `linking`, or null: the component renders again when one starts waiting and when
+ * it runs or is forgotten. For a screen that offers it after a sign-in.
+ */
+export declare function usePendingLink(): PendingLink | null;
+//# sourceMappingURL=usePendingLink.d.ts.map

package/lib/typescript/api/hooks/usePendingLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePendingLink.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/usePendingLink.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAkB,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD"}

package/lib/typescript/api/hooks/usePreview.d.ts

@@ -0,0 +1,29 @@
+import type { ScreenName, ScreenProps } from '../types.js';
+/** An item of the menu under a preview; with `actions`, a submenu. */
+export interface PreviewAction {
+    id: string;
+    title: string;
+    style?: 'default' | 'selected' | 'destructive';
+    onPress?: () => void;
+    actions?: PreviewAction[];
+}
+/** What a view previews: the screen with its props, and the menu under it. */
+export type PreviewConfig<Name extends ScreenName> = {
+    screen: Name;
+    actions?: PreviewAction[];
+    /** The width of the preview; the width of the screen without it. */
+    width?: number;
+    /** The height of the preview; the height of the screen without it. */
+    height?: number;
+} & (Partial<ScreenProps<Name>> extends ScreenProps<Name> ? {
+    props?: ScreenProps<Name>;
+} : {
+    props: ScreenProps<Name>;
+});
+/**
+ * (iOS) A long press on the view with `nativeID` in this screen (a right click with a pointer on iPad) shows `screen`
+ * small, with `actions` as a menu under it; a tap on the preview pushes the screen. UIKit's context menu. The preview
+ * goes when the component unmounts. Elsewhere the view has no preview.
+ */
+export declare function usePreview<Name extends ScreenName>(nativeID: string, config: PreviewConfig<Name>): void;
+//# sourceMappingURL=usePreview.d.ts.map

package/lib/typescript/api/hooks/usePreview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePreview.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/usePreview.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAU,CAAC;AAGxD,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,CAAC;IAC/C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,8EAA8E;AAC9E,MAAM,MAAM,aAAa,CAAC,IAAI,SAAS,UAAU,IAAI;IACnD,MAAM,EAAE,IAAI,CAAC;IACb,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,SAAS,WAAW,CAAC,IAAI,CAAC,GACrD;IAAE,KAAK,CAAC,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;CAAE,GAC7B;IAAE,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAAC;AAElC;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,SAAS,UAAU,EAChD,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,aAAa,CAAC,IAAI,CAAC,GAC1B,IAAI,CAqDN"}

package/lib/typescript/api/hooks/useReservedRegions.d.ts

@@ -0,0 +1,13 @@
+import { type ReservedRegions } from '../safeArea/screenRegions.js';
+/**
+ * The parts of this screen the hardware takes, in the screen's coordinates: `division`, the fold of a partly folded
+ * device, and `occlusion`, a camera or a hinge over the screen. Only what is active now: the fold of a device opened
+ * flat is not there. Empty where the platform has none (before iOS 27.1, a device without a fold). Changes as the
+ * device folds, as the safe area does.
+ *
+ * @example
+ * const { division } = useReservedRegions();
+ * const fold = division[0]; // keep the buttons on one side of it
+ */
+export declare function useReservedRegions(): ReservedRegions;
+//# sourceMappingURL=useReservedRegions.d.ts.map

package/lib/typescript/api/hooks/useReservedRegions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useReservedRegions.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/useReservedRegions.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,eAAe,EAErB,MAAM,8BAA2B,CAAC;AAGnC;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD"}

package/lib/typescript/api/hooks/useSafeAreaInsets.d.ts

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