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

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

@@ -0,0 +1 @@
+{"version":3,"file":"useSafeAreaInsets.d.ts","sourceRoot":"","sources":["../../../../src/api/hooks/useSafeAreaInsets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,UAAU,EAA0C,MAAM,6BAA0B,CAAC;AAGnG;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,IAAI,UAAU,CAO9C"}

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

@@ -0,0 +1,60 @@
+export { AppRegistry } from './app/AppRegistry.js';
+export { createNavigation } from './app/createNavigation.js';
+export type { NavigationApp, NavigationConfig, NavigationErrorSource, } from './app/createNavigation.js';
+export type { RootParam, RootsMap, RootTarget, RootValue } from './app/roots.js';
+export { Root } from './layout/Root.js';
+export type { RootElement, RootLayout, RootTransition } from './layout/Root.js';
+export { Screen } from './layout/Screen.js';
+export type { ScreenElement } from './layout/Screen.js';
+export { SideMenu } from './layout/SideMenu.js';
+export type { SideMenuElement, SideMenuParts } from './layout/SideMenu.js';
+export { SplitView } from './layout/SplitView.js';
+export type { SplitViewColumns, SplitViewElement } from './layout/SplitView.js';
+export { Stack } from './layout/Stack.js';
+export type { StackElement, StackEntry } from './layout/Stack.js';
+export { Tab, Tabs } from './layout/Tabs.js';
+export type { TabElement, TabItemStyle, TabsElement } from './layout/Tabs.js';
+export type { LayoutContent, LayoutElement } from './layout/element.js';
+export type { ColumnConfig, ModalConfig, OverlayConfig, Presentation, PushConfig, } from './commands/presentation.js';
+export type { SplitColumn } from './commands/commands.js';
+export type { Transition, TransitionPreset } from './commands/transitions.js';
+export type { ButtonPressEvent, ButtonPressHandler, NavigationButton, NavigationButtonMenu, NavigationFab, NavigationMenuItem, NavigationSubmenu, } from './options/buttons.js';
+export type { TabPressEvent, TabPressHandler } from './events/tabPresses.js';
+export type { AccessoryPlacementChangedEvent, ButtonPressedEvent, KeyCommandPressedEvent, ModalDismissAttemptedEvent, ModalDismissedEvent, NavigationEventName, NavigationEvents, NavigationListeners, PreviewCompletedEvent, ScreenDidAppearEvent, ScreenDidDisappearEvent, ScreenPoppedEvent, ScreenWillAppearEvent, SearchCancelledEvent, SearchChangedEvent, SearchSubmittedEvent, SearchSuggestionPickedEvent, SheetDetentChangedEvent, SplitViewDisplayModeChangedEvent, TabLongPressedEvent, TabPressedEvent, TabSelectedEvent, TitleRenamedEvent, } from './events/navigationEvents.js';
+export { useFocusEffect, useIsFocused, useNavigationButton, useNavigationEvent, useNavigationState, usePreventLeave, useScreen, useScreenAppear, useScreenDisappear, useScreenEvent, useScreenOptions, useSearchBar, useTabPress, } from './hooks/screenHooks.js';
+export type { ScreenEventName } from './hooks/screenHooks.js';
+export { useAppContext, useNavigationTheme } from './hooks/appHooks.js';
+export { useSafeAreaInsets } from './hooks/useSafeAreaInsets.js';
+export { useReservedRegions } from './hooks/useReservedRegions.js';
+export { useArrangement } from './hooks/useArrangement.js';
+export { useHinge, useHingeChange } from './hooks/useHinge.js';
+export { usePreview } from './hooks/usePreview.js';
+export { usePendingLink } from './hooks/usePendingLink.js';
+export { useSplash } from './app/splash.js';
+export type { Splash, SplashConfig, SplashLogo } from './app/splash.js';
+export type { LinkHandler, LinkInfo, LinkingConfig, LinkParams, LinkRoute, LinkRouteConfig, PendingLink, } from './linking/types.js';
+export type { PreviewAction, PreviewConfig } from './hooks/usePreview.js';
+export { screenNavigation, useNavigation } from './hooks/useNavigation.js';
+export type { ScreenNavigation } from './hooks/useNavigation.js';
+export { navigation } from './navigation.js';
+export type { AppNavigation } from './navigation.js';
+export { defineScreen } from './screens/defineScreen.js';
+export { TestIDs } from './testIDs.js';
+export { nativeScreen } from './screens/nativeScreens.js';
+export type { NativeScreen } from './screens/nativeScreens.js';
+export { defineArrangement } from './screens/arrangement.js';
+export type { Arrangement, ArrangementDefinition, ScreenArrangement } from './screens/arrangement.js';
+export type { OptionsEnvironment, ScreenDefinition, ScreenOptionsInput, } from './screens/defineScreen.js';
+export type { OptionsChain } from './options/OptionsChain.js';
+export type { ScreenOptions, ToolbarOptions } from './options/ScreenOptions.js';
+export type { LoadingFallback, ScreenEntry, ScreenGroup, ScreenInfo, ScreenProvider, Screens, } from './screens/registerScreens.js';
+export type { ErrorFallbackProps } from './screens/ScreenBoundary.js';
+export type { EdgeInsets } from './safeArea/screenInsets.js';
+export type { ReservedRegion, ReservedRegions } from './safeArea/screenRegions.js';
+export type { ArrangementState } from './arrangement/arrangementState.js';
+export type { Hinge } from './hinge/hinge.js';
+export type { AppOptionsInput, NavigationDirection, NavigationTheme, ResolvedNavigationTheme, } from './theme/theme.js';
+export type { AppProvider } from '../engine/slots.js';
+export type { NavigationState } from './state/navigationState.js';
+export type { Register, RegisteredContext, ScreenName, ScreenProps, ShowArgs } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

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

package/lib/typescript/api/layout/Root.d.ts

@@ -0,0 +1,47 @@
+import type { LayoutRoot } from '../../interfaces/Layout.js';
+import type { EnterExitAnimationOptions } from '../../interfaces/Options.js';
+import { type TransitionPreset } from '../commands/transitions.js';
+import { type LayoutContent, type ScreenUse, type ShowsScreens, type UsesOf } from './element.js';
+/**
+ * How a root replaces the one before: a preset the new root comes in with, or its own `enter` and `exit`. `'platform'`
+ * is the platform's own transition, `'none'` shows the new root at once, once its content is drawn, whatever setRoot
+ * animation the app's options set.
+ */
+export type RootTransition = TransitionPreset | EnterExitAnimationOptions;
+declare const BUILD_ROOT: unique symbol;
+/** A root with the modals shown over it, and how it replaces the one before. */
+export declare class RootElement<Uses extends ScreenUse = ScreenUse> {
+    private readonly root;
+    private readonly modals;
+    private readonly rootTransition;
+    constructor(root: LayoutContent, modals?: readonly LayoutContent[], rootTransition?: RootTransition);
+    /**
+     * A modal over the root once it is in place, such as the screen a notification opens at a cold start. It comes with
+     * its animation; each one goes over the one before, and the ones under the last come at once.
+     */
+    modal<const Content extends LayoutContent>(modal: Content): RootElement<Uses | UsesOf<Content>>;
+    /**
+     * How the root replaces the one before: `'platform'` (the default), `'fade'`, `'slideUp'`, `'slideFromEnd'` or
+     * `'scale'` (250 ms), `'none'` at once, or `{ enter, exit }` of its own. `'platform'` is the platform's transition: a
+     * cross dissolve on iOS, the fade through on Android. The first root of the app comes in place of the splash screen:
+     * at once with `'platform'` and `'none'`, over the splash with a preset or `{ enter, exit }`.
+     */
+    transition(transition: RootTransition): RootElement<Uses>;
+    [BUILD_ROOT](): LayoutRoot;
+}
+export interface RootElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+export declare function Root<const Content extends LayoutContent>(root: Content): RootElement<UsesOf<Content>>;
+/** What `root`, `roots` and `switchTo` take: content, `Root(…)`, or a root as JSON. */
+export type RootLayout = LayoutContent | RootElement<any> | LayoutRoot;
+/** The screens a root shows; a root as JSON is not checked. */
+export type UsesOfRoot<Value> = Value extends RootElement<infer Uses> ? Uses : UsesOf<Value>;
+export declare function buildRoot(value: RootLayout): LayoutRoot;
+/**
+ * The root with `transition` when it has no setRoot animation of its own: how the first root replaces the app's
+ * splash in React Native. It comes in once its content is drawn, unless the transition says otherwise: Android
+ * otherwise starts a root's own animation at once, over a screen still empty.
+ */
+export declare function withDefaultTransition(layout: LayoutRoot, transition: RootTransition): LayoutRoot;
+export {};
+//# sourceMappingURL=Root.d.ts.map

package/lib/typescript/api/layout/Root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Root.d.ts","sourceRoot":"","sources":["../../../../src/api/layout/Root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA0B,CAAC;AAC1E,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,4BAAyB,CAAC;AAC/E,OAAO,EAGL,KAAK,aAAa,EAGlB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,cAAW,CAAC;AAEnB;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,yBAAyB,CAAC;AAe1E,QAAA,MAAM,UAAU,eAA4C,CAAC;AAE7D,gFAAgF;AAChF,qBAAa,WAAW,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS;IAEvD,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;gBAFd,IAAI,EAAE,aAAa,EACnB,MAAM,GAAE,SAAS,aAAa,EAAO,EACrC,cAAc,GAAE,cAA2B;IAG9D;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;IAI/F;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,cAAc,GAAG,WAAW,CAAC,IAAI,CAAC;IAIzD,CAAC,UAAU,CAAC,IAAI,UAAU;CAU3B;AAGD,MAAM,WAAW,WAAW,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,IAAI,CAAC;CAAG;AAE9F,wBAAgB,IAAI,CAAC,KAAK,CAAC,OAAO,SAAS,aAAa,EACtD,IAAI,EAAE,OAAO,GACZ,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAE9B;AAED,uFAAuF;AACvF,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC;AAEvE,+DAA+D;AAC/D,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI,KAAK,SAAS,WAAW,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAE7F,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAIvD;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,cAAc,GAAG,UAAU,CAQhG"}

package/lib/typescript/api/layout/Screen.d.ts

@@ -0,0 +1,32 @@
+import type { Layout } from '../../interfaces/Layout.js';
+import type { Options } from '../../interfaces/Options.js';
+import { type ScreenOptionsInput } from '../screens/defineScreen.js';
+import { BUILD, type LayoutElement, type ScreenUse, type ShowsScreens } from './element.js';
+/** A screen of `screens` shown on its own, without a stack around it, or with options of this show. */
+export declare class ScreenElement<Uses extends ScreenUse = ScreenUse> implements LayoutElement<Uses> {
+    private readonly name;
+    private readonly props?;
+    private readonly built;
+    private readonly screenId?;
+    constructor(name: string, props?: object | undefined, built?: Options, screenId?: string | undefined);
+    /** The options of this show, over those of the screen's definition. */
+    options(options: ScreenOptionsInput<object>): ScreenElement<Uses>;
+    /** The id of the screen, to address it. */
+    id(id: string): ScreenElement<Uses>;
+    [BUILD](): Layout;
+}
+export interface ScreenElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+/**
+ * A screen of `screens` in a layout, with its props: `Screen('Details', { id: '42' })`. A screen without props can go
+ * by its name alone. The commands that take the layout check the name and the props.
+ */
+export declare function Screen<Name extends string>(name: Name): ScreenElement<{
+    name: Name;
+    props: undefined;
+}>;
+export declare function Screen<Name extends string, const Props extends object>(name: Name, props: Props): ScreenElement<{
+    name: Name;
+    props: Props;
+}>;
+//# sourceMappingURL=Screen.d.ts.map

package/lib/typescript/api/layout/Screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Screen.d.ts","sourceRoot":"","sources":["../../../../src/api/layout/Screen.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA0B,CAAC;AAExD,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,4BAAyB,CAAC;AACtF,OAAO,EAAE,KAAK,EAAE,KAAK,aAAa,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,MAAM,cAAW,CAAC;AAEzF,uGAAuG;AACvG,qBAAa,aAAa,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,aAAa,CAAC,IAAI,CAAC;IAEzF,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAHT,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,KAAK,GAAE,OAAY,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA;IAGpC,uEAAuE;IACvE,OAAO,CAAC,OAAO,EAAE,kBAAkB,CAAC,MAAM,CAAC,GAAG,aAAa,CAAC,IAAI,CAAC;IAKjE,2CAA2C;IAC3C,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,aAAa,CAAC,IAAI,CAAC;IAInC,CAAC,KAAK,CAAC,IAAI,MAAM;CAUlB;AAGD,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,IAAI,CAAC;CAAG;AAEhG;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,SAAS,MAAM,EACxC,IAAI,EAAE,IAAI,GACT,aAAa,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC;AACnD,wBAAgB,MAAM,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,CAAC,KAAK,SAAS,MAAM,EACpE,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,KAAK,GACX,aAAa,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC,CAAC"}

package/lib/typescript/api/layout/SideMenu.d.ts

@@ -0,0 +1,33 @@
+import type { Layout } from '../../interfaces/Layout.js';
+import type { Options, OptionsSideMenu, SideMenuSide } from '../../interfaces/Options.js';
+import { BUILD, type LayoutContent, type LayoutElement, type ScreenUse, type ShowsScreens, type UsesOf } from './element.js';
+/** The parts of a side menu: a screen named alone is a screen in a menu, and gets a stack in the center. */
+export interface SideMenuParts {
+    left?: LayoutContent;
+    center: LayoutContent;
+    right?: LayoutContent;
+}
+/** Side menus around a center. */
+export declare class SideMenuElement<Uses extends ScreenUse = ScreenUse> implements LayoutElement<Uses> {
+    private readonly parts;
+    private readonly built;
+    constructor(parts: SideMenuParts, built?: Options);
+    private withMenu;
+    left(left: SideMenuSide): SideMenuElement<Uses>;
+    right(right: SideMenuSide): SideMenuElement<Uses>;
+    /** #### (iOS specific) Where a swipe opens a menu. */
+    gesture(openGestureMode: NonNullable<OptionsSideMenu['openGestureMode']>): SideMenuElement<Uses>;
+    /** #### (iOS specific) */
+    animation(animationType: NonNullable<OptionsSideMenu['animationType']>): SideMenuElement<Uses>;
+    /** Modifiers for iOS only. */
+    ios(build: (menu: SideMenuElement<Uses>) => SideMenuElement<Uses>): SideMenuElement<Uses>;
+    /** Modifiers for Android only. */
+    android(build: (menu: SideMenuElement<Uses>) => SideMenuElement<Uses>): SideMenuElement<Uses>;
+    /** Options of the side menu no modifier covers. The options of screens go on the screens. */
+    options(options: OptionsSideMenu): SideMenuElement<Uses>;
+    [BUILD](): Layout;
+}
+export interface SideMenuElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+export declare function SideMenu<const Parts extends SideMenuParts>(parts: Parts): SideMenuElement<UsesOf<Parts[keyof Parts]>>;
+//# sourceMappingURL=SideMenu.d.ts.map

package/lib/typescript/api/layout/SideMenu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SideMenu.d.ts","sourceRoot":"","sources":["../../../../src/api/layout/SideMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,4BAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,6BAA0B,CAAC;AAEvF,OAAO,EACL,KAAK,EAEL,KAAK,aAAa,EAClB,KAAK,aAAa,EAElB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,cAAW,CAAC;AAEnB,4GAA4G;AAC5G,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,MAAM,EAAE,aAAa,CAAC;IACtB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAED,kCAAkC;AAClC,qBAAa,eAAe,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,aAAa,CAAC,IAAI,CAAC;IAG3F,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,KAAK,EAAE,aAAa,EACpB,KAAK,GAAE,OAAY;IAGtC,OAAO,CAAC,QAAQ;IAIhB,IAAI,CAAC,IAAI,EAAE,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC;IAI/C,KAAK,CAAC,KAAK,EAAE,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC;IAIjD,sDAAsD;IACtD,OAAO,CAAC,eAAe,EAAE,WAAW,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC;IAIhG,0BAA0B;IAC1B,SAAS,CAAC,aAAa,EAAE,WAAW,CAAC,eAAe,CAAC,eAAe,CAAC,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC;IAI9F,8BAA8B;IAC9B,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC;IAIzF,kCAAkC;IAClC,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,KAAK,eAAe,CAAC,IAAI,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC;IAI7F,6FAA6F;IAC7F,OAAO,CAAC,OAAO,EAAE,eAAe,GAAG,eAAe,CAAC,IAAI,CAAC;IAIxD,CAAC,KAAK,CAAC,IAAI,MAAM;CAWlB;AAGD,MAAM,WAAW,eAAe,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,IAAI,CAAC;CAAG;AAElG,wBAAgB,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,aAAa,EACxD,KAAK,EAAE,KAAK,GACX,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAE7C"}

package/lib/typescript/api/layout/SplitView.d.ts

@@ -0,0 +1,48 @@
+import type { Layout } from '../../interfaces/Layout.js';
+import type { Options, OptionsSplitView, OptionsSplitViewColumn } from '../../interfaces/Options.js';
+import { BUILD, type LayoutContent, type LayoutElement, type ScreenUse, type ShowsScreens, type UsesOf } from './element.js';
+/** The columns of a split view; a screen alone, by name or `Screen(…)`, gets a stack, but in the inspector. */
+export interface SplitViewColumns {
+    primary: LayoutContent;
+    secondary: LayoutContent;
+    /** The middle column (iOS). */
+    supplementary?: LayoutContent;
+    /** The column at the trailing edge (iOS 26+). */
+    inspector?: LayoutContent;
+    /** What an iPhone, a narrow window and a narrow Android screen show. */
+    compact?: LayoutContent;
+}
+/**
+ * Columns side by side on iPad. On Android the primary and the secondary pane: side by side when the width takes
+ * both (a tablet, a phone in landscape); narrower, the compact layout, or without it the secondary pane over the
+ * primary one. Android has no supplementary or inspector column.
+ */
+export declare class SplitViewElement<Uses extends ScreenUse = ScreenUse> implements LayoutElement<Uses> {
+    private readonly columns;
+    private readonly built;
+    constructor(columns: SplitViewColumns, built?: Options);
+    private withSplit;
+    displayMode(displayMode: NonNullable<OptionsSplitView['displayMode']>): SplitViewElement<Uses>;
+    splitBehavior(splitBehavior: NonNullable<OptionsSplitView['splitBehavior']>): SplitViewElement<Uses>;
+    primaryColumn(column: OptionsSplitViewColumn & {
+        edge?: OptionsSplitView['primaryEdge'];
+        background?: OptionsSplitView['primaryBackgroundStyle'];
+    }): SplitViewElement<Uses>;
+    supplementaryColumn(supplementary: OptionsSplitViewColumn): SplitViewElement<Uses>;
+    inspectorColumn(inspector: NonNullable<OptionsSplitView['inspector']>): SplitViewElement<Uses>;
+    displayModeButton(displayModeButton: NonNullable<OptionsSplitView['displayModeButton']>): SplitViewElement<Uses>;
+    presentsWithGesture(presentsWithGesture: boolean): SplitViewElement<Uses>;
+    showsSecondaryOnlyButton(showsSecondaryOnlyButton: boolean): SplitViewElement<Uses>;
+    compactTopColumn(compactTopColumn: NonNullable<OptionsSplitView['compactTopColumn']>): SplitViewElement<Uses>;
+    /** Modifiers for iOS only. */
+    ios(build: (split: SplitViewElement<Uses>) => SplitViewElement<Uses>): SplitViewElement<Uses>;
+    /** Modifiers for Android only. */
+    android(build: (split: SplitViewElement<Uses>) => SplitViewElement<Uses>): SplitViewElement<Uses>;
+    /** Options of the split view no modifier covers. The options of screens go on the screens. */
+    options(options: OptionsSplitView): SplitViewElement<Uses>;
+    [BUILD](): Layout;
+}
+export interface SplitViewElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+export declare function SplitView<const Columns extends SplitViewColumns>(columns: Columns): SplitViewElement<UsesOf<Columns[keyof Columns]>>;
+//# sourceMappingURL=SplitView.d.ts.map

package/lib/typescript/api/layout/SplitView.d.ts.map

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

package/lib/typescript/api/layout/Stack.d.ts

@@ -0,0 +1,21 @@
+import type { Layout, LayoutStackChildren } from '../../interfaces/Layout.js';
+import type { Options } from '../../interfaces/Options.js';
+import { BUILD, type LayoutElement, type ScreenUse, type ShowsScreens, type UsesOf } from './element.js';
+import { ScreenElement } from './Screen.js';
+/** A screen of a stack: by name, or `Screen(…)` with its props and the options of this show. */
+export type StackEntry = string | ScreenElement<any>;
+/**
+ * A stack of screens; the last one shows, and back goes to the one before. The options of screens go on the screens
+ * (`defineScreen`, `Screen(…).options()`), or on many at once through `groups` and `presentation`.
+ */
+export declare class StackElement<Uses extends ScreenUse = ScreenUse> implements LayoutElement<Uses> {
+    private readonly entries;
+    private readonly built;
+    constructor(entries: readonly StackEntry[], built?: Options);
+    [BUILD](): Layout;
+}
+export declare function stackChild(entry: StackEntry): LayoutStackChildren;
+export interface StackElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+export declare function Stack<const Entries extends readonly StackEntry[]>(...entries: Entries): StackElement<UsesOf<Entries[number]>>;
+//# sourceMappingURL=Stack.d.ts.map

package/lib/typescript/api/layout/Stack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stack.d.ts","sourceRoot":"","sources":["../../../../src/api/layout/Stack.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,4BAAyB,CAAC;AAC3E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA0B,CAAC;AACxD,OAAO,EACL,KAAK,EACL,KAAK,aAAa,EAElB,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,MAAM,EACZ,MAAM,cAAW,CAAC;AACnB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAU,CAAC;AAEzC,gGAAgG;AAChG,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;AAErD;;;GAGG;AACH,qBAAa,YAAY,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,YAAW,aAAa,CAAC,IAAI,CAAC;IAGxF,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK;gBADL,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,KAAK,GAAE,OAAY;IAGtC,CAAC,KAAK,CAAC,IAAI,MAAM;CAQlB;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,UAAU,GAAG,mBAAmB,CAEjE;AAGD,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,IAAI,CAAC;CAAG;AAE/F,wBAAgB,KAAK,CAAC,KAAK,CAAC,OAAO,SAAS,SAAS,UAAU,EAAE,EAC/D,GAAG,OAAO,EAAE,OAAO,GAClB,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAEvC"}

package/lib/typescript/api/layout/Tabs.d.ts

@@ -0,0 +1,120 @@
+import type { Layout } from '../../interfaces/Layout.js';
+import type { BottomTabsCustomRowOptions, DotIndicatorOptions, ImageResource, Options, OptionsBottomTab, OptionsBottomTabs } from '../../interfaces/Options.js';
+import { type TabPressHandler } from '../../engine/tabs.js';
+import { BUILD, type LayoutContent, type LayoutElement, type ScreenUse, type ShowsScreens, type UsesOf } from './element.js';
+/**
+ * The text of a tab badge as the native side takes it, an empty one for none: a count of `0` is nothing to show, as
+ * with unread messages.
+ */
+export declare function badgeText(badge: string | number | null): string;
+/** The look of a tab item; `Tabs().itemStyle()` gives it to every tab, a tab's own goes over it. */
+export type TabItemStyle = Pick<OptionsBottomTab, 'iconColor' | 'selectedIconColor' | 'textColor' | 'selectedTextColor' | 'badgeColor' | 'fontFamily' | 'fontStyle' | 'fontWeight' | 'fontSize' | 'selectedFontSize' | 'iconInsets' | 'iconWidth' | 'iconHeight' | 'disableIconTint' | 'disableSelectedIconTint'>;
+declare const BUILD_TAB: unique symbol;
+declare const PRESS_HANDLER: unique symbol;
+/**
+ * A tab: a screen named alone gets a stack around it. The tab's item options go on the layout of the tab, not on its
+ * first screen: the layout stays in the options a tab reads whatever screen is on top of it.
+ */
+export declare class TabElement<Uses extends ScreenUse = ScreenUse> {
+    private readonly content;
+    private readonly item;
+    private readonly tabId?;
+    private readonly pressHandler?;
+    constructor(content: LayoutContent | undefined, item?: OptionsBottomTab, tabId?: string | undefined, pressHandler?: TabPressHandler | undefined);
+    private withItem;
+    label(label: string): TabElement<Uses>;
+    icon(icon: ImageResource): TabElement<Uses>;
+    /** #### (iOS specific) */
+    selectedIcon(selectedIcon: ImageResource): TabElement<Uses>;
+    /** The badge of the tab: a count or a short text. `null` and the number `0` show none; the text `'0'` shows "0". */
+    badge(badge: string | number | null): TabElement<Uses>;
+    dot(dot?: boolean | DotIndicatorOptions): TabElement<Uses>;
+    /** #### (iOS specific) */
+    role(role: NonNullable<OptionsBottomTab['role']>): TabElement<Uses>;
+    /**
+     * A tap on the tab while it is selected goes back to the first screen of its stack, and on the first screen scrolls
+     * it to the top. On by default; `false` turns it off.
+     */
+    popToRootOnPress(popToRootOnPress?: boolean): TabElement<Uses>;
+    /** `false`: a tap does not select the tab, it only sends `bottomTabPressed`. */
+    selectOnPress(selectTabOnPress: boolean): TabElement<Uses>;
+    /**
+     * Called on every press of the tab, a second one too (`wasSelected`). It runs after the native side has acted on
+     * the press: with `.selectOnPress(false)` the tab stays unselected and the handler decides what to do.
+     */
+    onPress(handler: TabPressHandler): TabElement<Uses>;
+    /** When the user leaves the tab, its stack goes back to its first screen, so the tab opens on it next time. */
+    popToRootOnBlur(popToRootOnBlur?: boolean): TabElement<Uses>;
+    itemStyle(style: TabItemStyle): TabElement<Uses>;
+    /** #### (iOS specific, iOS 18+) With `Tabs().customizable()`. */
+    customization(customization: NonNullable<OptionsBottomTab['customization']>, more?: Pick<OptionsBottomTab, 'shownByDefault' | 'allowsHiding'>): TabElement<Uses>;
+    testID(testID: string): TabElement<Uses>;
+    /** Modifiers for iOS only. */
+    ios(build: (tab: TabElement<Uses>) => TabElement<Uses>): TabElement<Uses>;
+    /** Modifiers for Android only. */
+    android(build: (tab: TabElement<Uses>) => TabElement<Uses>): TabElement<Uses>;
+    /** The id of the tab, for `Tabs().selected()` and to address it. */
+    id(id: string): TabElement<Uses>;
+    /** Options of the tab item no modifier covers, such as `disableIconTint`. The options of screens go on the screens. */
+    options(options: OptionsBottomTab): TabElement<Uses>;
+    get [PRESS_HANDLER](): TabPressHandler | undefined;
+    [BUILD_TAB](style: TabItemStyle): Layout;
+}
+/** Bottom tabs. */
+export declare class TabsElement<Uses extends ScreenUse = ScreenUse> implements LayoutElement<Uses> {
+    private readonly tabs;
+    private readonly built;
+    private readonly style;
+    private readonly tabsId?;
+    constructor(tabs: readonly TabElement<any>[], built?: Options, style?: TabItemStyle, tabsId?: string | undefined);
+    private withOptions;
+    private withTabs;
+    /** The tab to show first: its index, or its id. */
+    selected(tab: number | string): TabsElement<Uses>;
+    /** Each tab is created the first time it shows. */
+    lazy(): TabsElement<Uses>;
+    /** The look of every tab item; a tab's own goes over it. */
+    itemStyle(style: TabItemStyle): TabsElement<Uses>;
+    /** #### (iOS specific, iOS 26+) */
+    minimize(minimizeBehavior: NonNullable<OptionsBottomTabs['minimizeBehavior']>): TabsElement<Uses>;
+    /** #### (iOS specific, iOS 26+) A screen of `screens` above the tab bar, as the mini player of Apple Music. */
+    accessory<Name extends string, const Props extends object | undefined = undefined>(name: Name, props?: Props): TabsElement<Uses | {
+        name: Name;
+        props: Props;
+    }>;
+    /** #### (iOS specific, iOS 18+) How the tabs show on iPad. */
+    sidebar(sidebar: NonNullable<OptionsBottomTabs['sidebar']>, sidebarLayout?: OptionsBottomTabs['sidebarLayout']): TabsElement<Uses>;
+    /** #### (iOS specific, iOS 18+) The user arranges the tabs; the id keeps the arrangement. */
+    customizable(customizationId: string): TabsElement<Uses>;
+    /** The row of tab items drawn by components (`bottomTab.component`). */
+    customRow(customRow: BottomTabsCustomRowOptions): TabsElement<Uses>;
+    /** #### (Android specific) What back does on the first screen of a tab. */
+    backBehavior(bottomTabsOnPress: 'exit' | 'first' | 'previous'): TabsElement<Uses>;
+    /** Modifiers for iOS only. */
+    ios(build: (tabs: TabsElement<Uses>) => TabsElement<Uses>): TabsElement<Uses>;
+    /** Modifiers for Android only. */
+    android(build: (tabs: TabsElement<Uses>) => TabsElement<Uses>): TabsElement<Uses>;
+    /**
+     * The id of the tabs: the `bottomTabsId` of the tab events (`tabSelected`, `tabPressed`, `tabLongPressed`), to tell
+     * two sets of tabs apart, such as the root's and those of a modal. Without it the id is generated. The commands take
+     * the id of a tab (`Tab().id()`), not this one.
+     */
+    id(id: string): TabsElement<Uses>;
+    /** Options of the tab bar, such as `titleDisplayMode`. The options of screens go on the screens. */
+    options(options: OptionsBottomTabs): TabsElement<Uses>;
+    [BUILD](): Layout;
+}
+export interface TabElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+export interface TabsElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+}
+type UsesOfTab<Tab> = Tab extends TabElement<infer Uses> ? Uses : never;
+/**
+ * A tab with its content: a screen by name, `Screen(…)`, or a layout. Without content the tab is a button: it never
+ * becomes current, and `onPress` decides what it does, such as a New tab that opens a modal.
+ */
+export declare function Tab(): TabElement<never>;
+export declare function Tab<const Content extends LayoutContent>(content: Content): TabElement<UsesOf<Content>>;
+export declare function Tabs<const Items extends readonly TabElement<any>[]>(...tabs: Items): TabsElement<UsesOfTab<Items[number]>>;
+export {};
+//# sourceMappingURL=Tabs.d.ts.map

package/lib/typescript/api/layout/Tabs.d.ts.map

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

package/lib/typescript/api/layout/element.d.ts

@@ -0,0 +1,52 @@
+import type { Layout, LayoutComponent } from '../../interfaces/Layout.js';
+import type { Options } from '../../interfaces/Options.js';
+/** Builds the layout of an element; the library calls it when a command takes the element. */
+export declare const BUILD: unique symbol;
+/**
+ * A screen a layout shows, for the types: its name, and its props (`undefined` for a screen named alone). The
+ * commands that take a layout check them against the screens of the app, as they check their own.
+ */
+export interface ScreenUse {
+    name: string;
+    props: object | undefined;
+}
+declare const screensShown: unique symbol;
+/** Carries the screens a layout shows, for the types. */
+export interface ShowsScreens<Uses extends ScreenUse> {
+    /** Never set. */
+    readonly [screensShown]?: Uses;
+}
+/** An element of a layout: a screen, a stack, tabs, a side menu, a split view. */
+export interface LayoutElement<Uses extends ScreenUse = ScreenUse> extends ShowsScreens<Uses> {
+    [BUILD](): Layout;
+}
+/**
+ * What a place in a layout takes: a screen by name, an element (`Screen(name, props)` for a screen with props), or a
+ * layout as JSON.
+ */
+export type LayoutContent = string | LayoutElement<any> | Layout;
+/** The screens a place of a layout shows; a layout as JSON is not checked. */
+export type UsesOf<Content> = Content extends string ? {
+    name: Content;
+    props: undefined;
+} : Content extends LayoutElement<infer Uses> ? Uses : never;
+export declare function isLayoutElement(value: unknown): value is LayoutElement<any>;
+export declare function screenComponent(name: string): {
+    component: LayoutComponent;
+};
+/**
+ * The layout of a place. A screen named alone becomes a stack with it where it navigates on (`'stack'`: the root, a
+ * tab, the center of a side menu, a column), and stays a screen where it does not (`'screen'`: a side menu, an
+ * overlay).
+ */
+export declare function buildContent(content: LayoutContent, screenAlone: 'stack' | 'screen'): Layout;
+/** The options of the layout's top node. */
+export declare function layoutOptions(layout: Layout): Options | undefined;
+/** The layout with options merged into its top node. */
+export declare function mergeLayoutOptions(layout: Layout, options: Options): Layout;
+/** The layout with an id on its top node. */
+export declare function setLayoutId(layout: Layout, id: string): Layout;
+/** The element with modifiers for one platform only. */
+export declare function onPlatform<Element>(os: 'ios' | 'android', element: Element, build: (element: Element) => Element): Element;
+export {};
+//# sourceMappingURL=element.d.ts.map

package/lib/typescript/api/layout/element.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"element.d.ts","sourceRoot":"","sources":["../../../../src/api/layout/element.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,4BAAyB,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA0B,CAAC;AAGxD,8FAA8F;AAC9F,eAAO,MAAM,KAAK,eAAwC,CAAC;AAE3D;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,OAAO,CAAC,MAAM,YAAY,EAAE,OAAO,MAAM,CAAC;AAE1C,yDAAyD;AACzD,MAAM,WAAW,YAAY,CAAC,IAAI,SAAS,SAAS;IAClD,iBAAiB;IACjB,QAAQ,CAAC,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC;CAChC;AAED,kFAAkF;AAClF,MAAM,WAAW,aAAa,CAAC,IAAI,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,IAAI,CAAC;IAC3F,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;AAEjE,8EAA8E;AAC9E,MAAM,MAAM,MAAM,CAAC,OAAO,IAAI,OAAO,SAAS,MAAM,GAChD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GACnC,OAAO,SAAS,aAAa,CAAC,MAAM,IAAI,CAAC,GACvC,IAAI,GACJ,KAAK,CAAC;AAEZ,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,GAAG,CAAC,CAE3E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,eAAe,CAAA;CAAE,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAO5F;AAWD,4CAA4C;AAC5C,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAMjE;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAW3E;AAED,6CAA6C;AAC7C,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAM9D;AAED,wDAAwD;AACxD,wBAAgB,UAAU,CAAC,OAAO,EAChC,EAAE,EAAE,KAAK,GAAG,SAAS,EACrB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,GACnC,OAAO,CAET"}

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

@@ -0,0 +1,31 @@
+/** A URL taken apart: the path without the prefix, and the query. */
+export interface ParsedLink {
+    url: string;
+    path: string;
+    query: Record<string, string>;
+}
+/** A path matched by a route. */
+export interface LinkMatch extends ParsedLink {
+    /** The pattern of the route. */
+    route: string;
+    params: Record<string, string>;
+}
+/** A pattern split into parts, ready to match. */
+export interface CompiledRoute {
+    pattern: string;
+    parts: {
+        name: string;
+        param: boolean;
+        optional: boolean;
+    }[];
+}
+/** The path and the query of a URL; undefined when it starts with none of `prefixes`. */
+export declare function parseLink(url: string, prefixes: readonly string[] | undefined): ParsedLink | undefined;
+/**
+ * The routes in the order they are tried: more required parts first, then a static part before a param at the same
+ * place, then fewer parts, then as written.
+ */
+export declare function compileRoutes(patterns: readonly string[]): CompiledRoute[];
+/** The first route that takes the path, with its params; undefined when none does. */
+export declare function matchLink(link: ParsedLink, routes: readonly CompiledRoute[]): LinkMatch | undefined;
+//# sourceMappingURL=linkPaths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkPaths.d.ts","sourceRoot":"","sources":["../../../../src/api/linking/linkPaths.ts"],"names":[],"mappings":"AAEA,qEAAqE;AACrE,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,iCAAiC;AACjC,MAAM,WAAW,SAAU,SAAQ,UAAU;IAC3C,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;CAC9D;AAED,yFAAyF;AACzF,wBAAgB,SAAS,CACvB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACtC,UAAU,GAAG,SAAS,CAiBxB;AA6CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,GAAG,aAAa,EAAE,CA0B1E;AAoBD,sFAAsF;AACtF,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,SAAS,aAAa,EAAE,GAC/B,SAAS,GAAG,SAAS,CAgBvB"}

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

@@ -0,0 +1,37 @@
+import type { LayoutRoot } from '../../interfaces/Layout.js';
+import { type RootsMap } from '../app/roots.js';
+import { type NavigationState } from '../state/navigationState.js';
+import { type LinkMatch } from './linkPaths.js';
+import type { LinkingConfig } from './types.js';
+type Config = Omit<LinkingConfig<any, any, string, any>, 'routes'> & {
+    routes: object;
+};
+/** Starts the links of the app, once per JavaScript runtime. */
+export declare function setupLinking(linking: Config, options: {
+    roots: RootsMap | undefined;
+    onError: ((error: unknown, url: string) => void) | undefined;
+}): void;
+/**
+ * The link that launched the app, matched as the app starts (`unmatched` may run commands then); the same one for
+ * every try of the first start.
+ */
+export declare function launchLink(): Promise<LinkMatch | undefined>;
+/**
+ * The first root the launch link makes with `start`, when its route has one and may run now. `handled`: the link
+ * needs nothing more — it made the root, or its `start` failed and went to `onError`.
+ */
+export declare function launchRoot(link: LinkMatch | undefined): {
+    root?: LayoutRoot;
+    handled: boolean;
+};
+/** A link that failed outside its route: the native side couldn't set the root its `start` made. */
+export declare function reportLink(error: unknown, url: string): void;
+/**
+ * The first root is shown: once the native side told its screen, the launch link runs unless it was handled, then the
+ * links that came meanwhile.
+ */
+export declare function linksStarted(link: LinkMatch | undefined, handled: boolean, stateBefore: NavigationState): Promise<void>;
+/** The native side launched again (Android: a new activity): its link runs as in a running app. */
+export declare function linksRelaunched(stateBefore: NavigationState): Promise<void>;
+export {};
+//# sourceMappingURL=linking.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linking.d.ts","sourceRoot":"","sources":["../../../../src/api/linking/linking.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAAyB,CAAC;AAC1D,OAAO,EAAe,KAAK,QAAQ,EAAE,MAAM,iBAAc,CAAC;AAK1D,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,6BAA0B,CAAC;AACrG,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,gBAAa,CAAC;AAErB,OAAO,KAAK,EAAY,aAAa,EAAE,MAAM,YAAS,CAAC;AAgBvD,KAAK,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgBxF,gEAAgE;AAChE,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,OAAO,EAAE;IACP,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CAC9D,GACA,IAAI,CAYN;AAED;;;GAGG;AACH,wBAAgB,UAAU,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAG3D;AAQD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,GAAG;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAY/F;AAED,oGAAoG;AACpG,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAE5D;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,SAAS,GAAG,SAAS,EAC3B,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,eAAe,GAC3B,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,mGAAmG;AACnG,wBAAsB,eAAe,CAAC,WAAW,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjF"}

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

@@ -0,0 +1,8 @@
+import type { PendingLink } from './types.js';
+export declare function getPendingLink(): PendingLink | null;
+export declare function setPendingLink(link: PendingLink | null): void;
+export declare function subscribePendingLink(listener: () => void): () => void;
+export declare function setPendingLinkOpener(open: (link: PendingLink) => Promise<void>): void;
+/** Runs the waiting link now, whatever `when` says, and forgets it; false without one. */
+export declare function openPendingLink(): Promise<boolean>;
+//# sourceMappingURL=pendingLinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pendingLinks.d.ts","sourceRoot":"","sources":["../../../../src/api/linking/pendingLinks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAS,CAAC;AAQ3C,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAEnD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAI7D;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI,CAKrE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAErF;AAED,0FAA0F;AAC1F,wBAAsB,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC,CAMxD"}