@mapples/navigation 1.1.1

package/README.md

@@ -0,0 +1,46 @@
+# @mapples/navigation
+
+Runtime interpreter for the Mapples `NavigationDocument`. Renders a document with
+React Navigation (stack / tabs / drawer) and bridges navigation actions emitted
+through `@mapples/action`.
+
+> ⚠️ **Canonical home is `mapples-open-kit`.** This copy is the in-monorepo mirror
+> used so the Creator preview can develop against it. Sync changes to open-kit
+> before publishing; do not release from this repo.
+
+## Usage
+
+```tsx
+import { MapplesNavigation } from '@mapples/navigation';
+
+<MapplesNavigation
+  document={navigationDocument}
+  pages={{ 'page-uuid': HomeScreen }}
+  fallback={({ pageUuid }) => <Missing pageUuid={pageUuid} />}
+  independent // when the host already owns a NavigationContainer (expo-router)
+/>;
+```
+
+## Actions
+
+Components emit these `Action.type` strings (see `NavigationActionType`):
+
+| Type | `payload.data` | Effect |
+| --- | --- | --- |
+| `mapples:navigate` | `{ routeName?, pageUuid?, params? }` | Navigate to a route / page |
+| `mapples:goBack` | — | Pop the current screen |
+| `mapples:openDrawer` | — | Open the nearest drawer |
+| `mapples:closeDrawer` | — | Close the nearest drawer |
+| `mapples:switchTab` | `{ routeName }` | Switch to a sibling tab |
+
+## Ref resolution
+
+Option values may be `ref(theme:<uuid>:<name>)` (resolved against `@mapples/style`)
+or `ref(icon:<uuid>:<name>)` (resolved against the `@mapples/render` assets map).
+Unresolvable refs fall back to a default and `console.warn` rather than crashing.
+
+## Peer dependencies
+
+`@react-navigation/*` ship as direct dependencies; `react-native-screens`,
+`react-native-safe-area-context`, `react-native-gesture-handler` and
+`react-native-reanimated` are peer dependencies provided by the host app.

package/dist/MapplesNavigation.d.ts

@@ -0,0 +1,10 @@
+import { FC } from 'react';
+import { MapplesNavigationProps } from './types';
+/**
+ * Renders a {@link NavigationDocument} with React Navigation and wires the
+ * `@mapples/action` store to navigation. Pass `independent` when the host app
+ * already owns a navigation container (expo-router / the Creator preview).
+ */
+declare const MapplesNavigation: FC<MapplesNavigationProps>;
+export default MapplesNavigation;
+//# sourceMappingURL=MapplesNavigation.d.ts.map

package/dist/MapplesNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapplesNavigation.d.ts","sourceRoot":"","sources":["../src/MapplesNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAW,MAAM,OAAO,CAAC;AAKpC,OAAO,EAAE,sBAAsB,EAAwB,MAAM,SAAS,CAAC;AAQvE;;;;GAIG;AACH,QAAA,MAAM,iBAAiB,EAAE,EAAE,CAAC,sBAAsB,CAqCjD,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/MapplesNavigation.js

@@ -0,0 +1,30 @@
+import { useMemo } from 'react';
+import { NavigatorView } from './buildNavigator';
+import { buildNavigationModel } from './model';
+import NavigationActionHandler from './NavigationActionHandler';
+import useRefResolvers from './useRefResolvers';
+import { createNavigationContainerRef, NavigationContainer, NavigationIndependentTree, } from './vendor';
+/**
+ * Renders a {@link NavigationDocument} with React Navigation and wires the
+ * `@mapples/action` store to navigation. Pass `independent` when the host app
+ * already owns a navigation container (expo-router / the Creator preview).
+ */
+const MapplesNavigation = ({ document, pages, fallback, independent, navigationRef: externalRef, }) => {
+    const resolvers = useRefResolvers();
+    const model = useMemo(() => buildNavigationModel(document), [document]);
+    const internalRef = useMemo(() => createNavigationContainerRef(), []);
+    const navigationRef = externalRef ?? internalRef;
+    if (!model)
+        return null;
+    const ctx = { pages, fallback, resolvers };
+    const container = (<NavigationContainer ref={navigationRef}>
+      <NavigatorView model={model} ctx={ctx}/>
+    </NavigationContainer>);
+    const tree = independent ? (<NavigationIndependentTree>{container}</NavigationIndependentTree>) : (container);
+    return (<>
+      {tree}
+      <NavigationActionHandler navigationRef={navigationRef} document={document}/>
+    </>);
+};
+export default MapplesNavigation;
+//# sourceMappingURL=MapplesNavigation.js.map

package/dist/MapplesNavigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MapplesNavigation.js","sourceRoot":"","sources":["../src/MapplesNavigation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAM,OAAO,EAAE,MAAM,OAAO,CAAC;AAEpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,uBAAuB,MAAM,2BAA2B,CAAC;AAEhE,OAAO,eAAe,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,UAAU,CAAC;AAElB;;;;GAIG;AACH,MAAM,iBAAiB,GAA+B,CAAC,EACrD,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,WAAW,EACX,aAAa,EAAE,WAAW,GAC3B,EAAE,EAAE;IACH,MAAM,SAAS,GAAG,eAAe,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,4BAA4B,EAAE,EAAE,EAAE,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,WAAW,IAAI,WAAW,CAAC;IAEjD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,MAAM,GAAG,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAE3C,MAAM,SAAS,GAAG,CAChB,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,aAAmC,CAAC,CAC5D;MAAA,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EACxC;IAAA,EAAE,mBAAmB,CAAC,CACvB,CAAC;IAEF,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CACzB,CAAC,yBAAyB,CAAC,CAAC,SAAS,CAAC,EAAE,yBAAyB,CAAC,CACnE,CAAC,CAAC,CAAC,CACF,SAAS,CACV,CAAC;IAEF,OAAO,CACL,EACE;MAAA,CAAC,IAAI,CACL;MAAA,CAAC,uBAAuB,CACtB,aAAa,CAAC,CAAC,aAAqC,CAAC,CACrD,QAAQ,CAAC,CAAC,QAAQ,CAAC,EAEvB;IAAA,GAAG,CACJ,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/NavigationActionHandler.d.ts

@@ -0,0 +1,14 @@
+import { NavigationDocument } from '@mapples/types';
+import { MapplesNavigationRef } from './types';
+interface NavigationActionHandlerProps {
+    navigationRef: MapplesNavigationRef;
+    document: NavigationDocument;
+}
+/**
+ * Bridges the `@mapples/action` store to navigation: it subscribes to emitted
+ * actions, maps each to a {@link toNavigationCommand} command, and drives the
+ * shared navigation container ref. Renders nothing.
+ */
+declare const NavigationActionHandler: ({ navigationRef, document, }: NavigationActionHandlerProps) => null;
+export default NavigationActionHandler;
+//# sourceMappingURL=NavigationActionHandler.d.ts.map

package/dist/NavigationActionHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationActionHandler.d.ts","sourceRoot":"","sources":["../src/NavigationActionHandler.tsx"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAIpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAG/C,UAAU,4BAA4B;IACpC,aAAa,EAAE,oBAAoB,CAAC;IACpC,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;AACH,QAAA,MAAM,uBAAuB,GAAI,8BAG9B,4BAA4B,SAyC9B,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/NavigationActionHandler.js

@@ -0,0 +1,50 @@
+import { useEffect } from 'react';
+import { useActionStore } from '@mapples/action';
+import { toNavigationCommand } from './actionCommands';
+import { buildScreenNavigateTarget } from './model';
+import { DrawerActions } from './vendor';
+/**
+ * Bridges the `@mapples/action` store to navigation: it subscribes to emitted
+ * actions, maps each to a {@link toNavigationCommand} command, and drives the
+ * shared navigation container ref. Renders nothing.
+ */
+const NavigationActionHandler = ({ navigationRef, document, }) => {
+    const actionStore = useActionStore();
+    useEffect(() => {
+        const subscription = actionStore.subscribe((action) => {
+            const command = toNavigationCommand(action, document);
+            if (!command || !navigationRef.isReady())
+                return;
+            switch (command.kind) {
+                case 'navigate': {
+                    // Descend into nested navigators: a flat `navigate(name)` can't reach
+                    // a screen registered inside a nested navigator.
+                    const target = buildScreenNavigateTarget(document, command.routeName, command.params);
+                    if (target)
+                        navigationRef.navigate(target.name, target.params);
+                    break;
+                }
+                case 'switchTab': {
+                    const target = buildScreenNavigateTarget(document, command.routeName);
+                    if (target)
+                        navigationRef.navigate(target.name, target.params);
+                    break;
+                }
+                case 'goBack':
+                    if (navigationRef.canGoBack())
+                        navigationRef.goBack();
+                    break;
+                case 'openDrawer':
+                    navigationRef.dispatch(DrawerActions.openDrawer());
+                    break;
+                case 'closeDrawer':
+                    navigationRef.dispatch(DrawerActions.closeDrawer());
+                    break;
+            }
+        });
+        return () => subscription.unsubscribe();
+    }, [actionStore, document, navigationRef]);
+    return null;
+};
+export default NavigationActionHandler;
+//# sourceMappingURL=NavigationActionHandler.js.map

package/dist/NavigationActionHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationActionHandler.js","sourceRoot":"","sources":["../src/NavigationActionHandler.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,SAAS,CAAC;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC;;;;GAIG;AACH,MAAM,uBAAuB,GAAG,CAAC,EAC/B,aAAa,EACb,QAAQ,GACqB,EAAE,EAAE;IACjC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,YAAY,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,MAAM,EAAE,EAAE;YACpD,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACtD,IAAI,CAAC,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE;gBAAE,OAAO;YAEjD,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,UAAU,CAAC,CAAC,CAAC;oBAChB,sEAAsE;oBACtE,iDAAiD;oBACjD,MAAM,MAAM,GAAG,yBAAyB,CACtC,QAAQ,EACR,OAAO,CAAC,SAAS,EACjB,OAAO,CAAC,MAAM,CACf,CAAC;oBACF,IAAI,MAAM;wBAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC/D,MAAM;gBACR,CAAC;gBACD,KAAK,WAAW,CAAC,CAAC,CAAC;oBACjB,MAAM,MAAM,GAAG,yBAAyB,CAAC,QAAQ,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;oBACtE,IAAI,MAAM;wBAAE,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;oBAC/D,MAAM;gBACR,CAAC;gBACD,KAAK,QAAQ;oBACX,IAAI,aAAa,CAAC,SAAS,EAAE;wBAAE,aAAa,CAAC,MAAM,EAAE,CAAC;oBACtD,MAAM;gBACR,KAAK,YAAY;oBACf,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,UAAU,EAAE,CAAC,CAAC;oBACnD,MAAM;gBACR,KAAK,aAAa;oBAChB,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC;oBACpD,MAAM;YACV,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,CAAC;IAC1C,CAAC,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC;IAE3C,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,eAAe,uBAAuB,CAAC"}

package/dist/actionCommands.d.ts

@@ -0,0 +1,11 @@
+import { Action, NavigationDocument } from '@mapples/types';
+import { NavigationCommand } from './types';
+/**
+ * Translate an emitted {@link Action} into a {@link NavigationCommand}, or
+ * `null` if it isn't a navigation action (or can't be resolved). `pageUuid`
+ * navigate targets resolve to the first route referencing that page.
+ *
+ * Pure: no React Navigation involvement, so it can be unit-tested directly.
+ */
+export declare const toNavigationCommand: (action: Action, document: NavigationDocument) => NavigationCommand | null;
+//# sourceMappingURL=actionCommands.d.ts.map

package/dist/actionCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCommands.d.ts","sourceRoot":"","sources":["../src/actionCommands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAI5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAS5C;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,EACd,UAAU,kBAAkB,KAC3B,iBAAiB,GAAG,IA+BtB,CAAC"}

package/dist/actionCommands.js

@@ -0,0 +1,45 @@
+import { NavigationActionType } from './constants';
+import { findRouteNameForPage, resolveScreenName } from './model';
+/**
+ * Translate an emitted {@link Action} into a {@link NavigationCommand}, or
+ * `null` if it isn't a navigation action (or can't be resolved). `pageUuid`
+ * navigate targets resolve to the first route referencing that page.
+ *
+ * Pure: no React Navigation involvement, so it can be unit-tested directly.
+ */
+export const toNavigationCommand = (action, document) => {
+    switch (action.type) {
+        case NavigationActionType.Navigate: {
+            const data = (action.payload?.data ?? {});
+            // `findRouteNameForPage` already returns a qualified name; an explicit
+            // `routeName` may be qualified (current) or bare (legacy), so both pass
+            // through `resolveScreenName`.
+            const target = data.routeName ??
+                (data.pageUuid ? findRouteNameForPage(document, data.pageUuid) : null);
+            if (!target)
+                return null;
+            const routeName = resolveScreenName(document, target);
+            if (!routeName)
+                return null;
+            return { kind: 'navigate', routeName, params: data.params };
+        }
+        case NavigationActionType.GoBack:
+            return { kind: 'goBack' };
+        case NavigationActionType.OpenDrawer:
+            return { kind: 'openDrawer' };
+        case NavigationActionType.CloseDrawer:
+            return { kind: 'closeDrawer' };
+        case NavigationActionType.SwitchTab: {
+            const data = (action.payload?.data ?? {});
+            if (!data.routeName)
+                return null;
+            const routeName = resolveScreenName(document, data.routeName);
+            if (!routeName)
+                return null;
+            return { kind: 'switchTab', routeName };
+        }
+        default:
+            return null;
+    }
+};
+//# sourceMappingURL=actionCommands.js.map

package/dist/actionCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"actionCommands.js","sourceRoot":"","sources":["../src/actionCommands.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAUlE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAAc,EACd,QAA4B,EACF,EAAE;IAC5B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAoB,CAAC;YAC7D,uEAAuE;YACvE,wEAAwE;YACxE,+BAA+B;YAC/B,MAAM,MAAM,GACV,IAAI,CAAC,SAAS;gBACd,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACzE,IAAI,CAAC,MAAM;gBAAE,OAAO,IAAI,CAAC;YACzB,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACtD,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,CAAC;QACD,KAAK,oBAAoB,CAAC,MAAM;YAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,oBAAoB,CAAC,UAAU;YAClC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAChC,KAAK,oBAAoB,CAAC,WAAW;YACnC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;QACjC,KAAK,oBAAoB,CAAC,SAAS,CAAC,CAAC,CAAC;YACpC,MAAM,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAoB,CAAC;YAC7D,IAAI,CAAC,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YACjC,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9D,IAAI,CAAC,SAAS;gBAAE,OAAO,IAAI,CAAC;YAC5B,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;QAC1C,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC,CAAC"}

package/dist/buildNavigator.d.ts

@@ -0,0 +1,14 @@
+import { NavigatorModel } from './model';
+import { MapplesNavigationProps, RefResolvers } from './types';
+/** Everything a navigator needs to resolve its screens. */
+export interface NavigatorBuildContext {
+    pages: MapplesNavigationProps['pages'];
+    fallback?: MapplesNavigationProps['fallback'];
+    resolvers: RefResolvers;
+}
+/** Recursively render a {@link NavigatorModel} with the matching React Navigation navigator. */
+export declare const NavigatorView: ({ model, ctx, }: {
+    model: NavigatorModel;
+    ctx: NavigatorBuildContext;
+}) => import("react").JSX.Element;
+//# sourceMappingURL=buildNavigator.d.ts.map

package/dist/buildNavigator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNavigator.d.ts","sourceRoot":"","sources":["../src/buildNavigator.tsx"],"names":[],"mappings":"AAcA,OAAO,EAAE,cAAc,EAAe,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAS/D,2DAA2D;AAC3D,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACvC,QAAQ,CAAC,EAAE,sBAAsB,CAAC,UAAU,CAAC,CAAC;IAC9C,SAAS,EAAE,YAAY,CAAC;CACzB;AA4LD,gGAAgG;AAChG,eAAO,MAAM,aAAa,GAAI,iBAG3B;IACD,KAAK,EAAE,cAAc,CAAC;IACtB,GAAG,EAAE,qBAAqB,CAAC;CAC5B,gCASA,CAAC"}

package/dist/buildNavigator.js

@@ -0,0 +1,87 @@
+import { useMemo } from 'react';
+import { Text, View } from 'react-native';
+// React Navigation is consumed through expo-router's vendored copy, centralized
+// in `./vendor` (SDK 56+ blocks external `@react-navigation/*`).
+import { mapDrawerItemOptions, mapDrawerOptions, mapHeaderOptions, mapStackScreenOptions, mapTabBarOptions, mapTabItemOptions, } from './mappers';
+import { createBottomTabNavigator, createDrawerNavigator, createNativeStackNavigator, } from './vendor';
+const MissingScreen = () => null;
+/**
+ * React Navigation requires every navigator to have at least one screen. A
+ * navigator with no routes is a valid intermediate state in the editor (you
+ * create it, then add screens), so render a single placeholder rather than
+ * crashing.
+ */
+const EMPTY_ROUTE_NAME = '__mapples_empty__';
+// Blank the header title / tab / drawer label so the internal placeholder route
+// name never leaks into the preview chrome.
+const EMPTY_SCREEN_OPTIONS = { title: '' };
+const EmptyNavigatorScreen = () => (<View style={{
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        padding: 24,
+    }}>
+    <Text style={{ color: '#8E8E93', fontSize: 13, textAlign: 'center' }}>
+      No screens yet. Add a screen to this navigator.
+    </Text>
+  </View>);
+/** Resolve the component a screen renders (page lookup → pages map / fallback). */
+const screenComponent = (screen, ctx) => {
+    if (screen.target.kind === 'navigator') {
+        const child = screen.target.child;
+        const Child = () => (<NavigatorView model={child} ctx={ctx}/>);
+        return Child;
+    }
+    const { pageUuid } = screen.target;
+    const Page = ctx.pages[pageUuid];
+    if (Page)
+        return Page;
+    if (ctx.fallback) {
+        const Fallback = ctx.fallback;
+        const FallbackScreen = () => (<Fallback pageUuid={pageUuid}/>);
+        return FallbackScreen;
+    }
+    return MissingScreen;
+};
+const StackNavigatorView = ({ model, ctx, }) => {
+    const Stack = useMemo(() => createNativeStackNavigator(), []);
+    // When neither the navigator nor the route sets a header title, React
+    // Navigation falls back to the screen name — which is now navigator-qualified
+    // (`<navigator>:<route>`). Default the title to the bare route name in that
+    // case so the prefix never surfaces in the UI; a navigator-level title still
+    // applies to every screen as before.
+    const navHasTitle = model.node.options?.header?.title !== undefined;
+    return (<Stack.Navigator initialRouteName={model.initialRouteName} screenOptions={mapHeaderOptions(model.node.options?.header, ctx.resolvers)}>
+      {model.screens.length ? (model.screens.map((screen) => {
+            const options = mapStackScreenOptions(screen.route, ctx.resolvers);
+            if (options.title === undefined && !navHasTitle) {
+                options.title = screen.route.name;
+            }
+            return (<Stack.Screen key={screen.routeId} name={screen.routeName} component={screenComponent(screen, ctx)} options={options}/>);
+        })) : (<Stack.Screen name={EMPTY_ROUTE_NAME} component={EmptyNavigatorScreen} options={EMPTY_SCREEN_OPTIONS}/>)}
+    </Stack.Navigator>);
+};
+const TabsNavigatorView = ({ model, ctx, }) => {
+    const Tabs = useMemo(() => createBottomTabNavigator(), []);
+    return (<Tabs.Navigator initialRouteName={model.initialRouteName} screenOptions={mapTabBarOptions(model.node.options?.tabBar, ctx.resolvers)}>
+      {model.screens.length ? (model.screens.map((screen) => (<Tabs.Screen key={screen.routeId} name={screen.routeName} component={screenComponent(screen, ctx)} options={mapTabItemOptions(screen.route, ctx.resolvers)}/>))) : (<Tabs.Screen name={EMPTY_ROUTE_NAME} component={EmptyNavigatorScreen} options={EMPTY_SCREEN_OPTIONS}/>)}
+    </Tabs.Navigator>);
+};
+const DrawerNavigatorView = ({ model, ctx, }) => {
+    const Drawer = useMemo(() => createDrawerNavigator(), []);
+    return (<Drawer.Navigator initialRouteName={model.initialRouteName} screenOptions={mapDrawerOptions(model.node.options?.drawer, ctx.resolvers)}>
+      {model.screens.length ? (model.screens.map((screen) => (<Drawer.Screen key={screen.routeId} name={screen.routeName} component={screenComponent(screen, ctx)} options={mapDrawerItemOptions(screen.route, ctx.resolvers)}/>))) : (<Drawer.Screen name={EMPTY_ROUTE_NAME} component={EmptyNavigatorScreen} options={EMPTY_SCREEN_OPTIONS}/>)}
+    </Drawer.Navigator>);
+};
+/** Recursively render a {@link NavigatorModel} with the matching React Navigation navigator. */
+export const NavigatorView = ({ model, ctx, }) => {
+    switch (model.type) {
+        case 'tabs':
+            return <TabsNavigatorView model={model} ctx={ctx}/>;
+        case 'drawer':
+            return <DrawerNavigatorView model={model} ctx={ctx}/>;
+        default:
+            return <StackNavigatorView model={model} ctx={ctx}/>;
+    }
+};
+//# sourceMappingURL=buildNavigator.js.map

package/dist/buildNavigator.js.map

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

package/dist/constants.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Action `type` strings handled by the navigation runtime. Components wire these
+ * to interactions via `RenderComponentType.actionProps` and emit them through
+ * the `@mapples/action` store.
+ */
+export declare const NavigationActionType: {
+    /** Navigate to a route or page. `payload.data: { routeName?, pageUuid?, params? }`. */
+    readonly Navigate: "mapples:navigate";
+    /** Pop the current screen. */
+    readonly GoBack: "mapples:goBack";
+    /** Open the nearest drawer. */
+    readonly OpenDrawer: "mapples:openDrawer";
+    /** Close the nearest drawer. */
+    readonly CloseDrawer: "mapples:closeDrawer";
+    /** Switch to a sibling tab. `payload.data: { routeName }`. */
+    readonly SwitchTab: "mapples:switchTab";
+};
+export type NavigationActionTypeValue = (typeof NavigationActionType)[keyof typeof NavigationActionType];
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;IAC/B,uFAAuF;;IAEvF,8BAA8B;;IAE9B,+BAA+B;;IAE/B,gCAAgC;;IAEhC,8DAA8D;;CAEtD,CAAC;AAEX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/constants.js

@@ -0,0 +1,18 @@
+/**
+ * Action `type` strings handled by the navigation runtime. Components wire these
+ * to interactions via `RenderComponentType.actionProps` and emit them through
+ * the `@mapples/action` store.
+ */
+export const NavigationActionType = {
+    /** Navigate to a route or page. `payload.data: { routeName?, pageUuid?, params? }`. */
+    Navigate: 'mapples:navigate',
+    /** Pop the current screen. */
+    GoBack: 'mapples:goBack',
+    /** Open the nearest drawer. */
+    OpenDrawer: 'mapples:openDrawer',
+    /** Close the nearest drawer. */
+    CloseDrawer: 'mapples:closeDrawer',
+    /** Switch to a sibling tab. `payload.data: { routeName }`. */
+    SwitchTab: 'mapples:switchTab',
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,uFAAuF;IACvF,QAAQ,EAAE,kBAAkB;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,gBAAgB;IACxB,+BAA+B;IAC/B,UAAU,EAAE,oBAAoB;IAChC,gCAAgC;IAChC,WAAW,EAAE,qBAAqB;IAClC,8DAA8D;IAC9D,SAAS,EAAE,mBAAmB;CACtB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @fileoverview Runtime interpreter for the Mapples `NavigationDocument`.
+ *
+ * Renders a navigation document with React Navigation (stack / tabs / drawer)
+ * and bridges navigation actions emitted through `@mapples/action`.
+ */
+export { default as MapplesNavigation } from './MapplesNavigation';
+export { default as NavigationActionHandler } from './NavigationActionHandler';
+export { default as useRefResolvers } from './useRefResolvers';
+export { NavigatorView } from './buildNavigator';
+export type { NavigatorBuildContext } from './buildNavigator';
+export * from './types';
+export * from './constants';
+export * from './refs';
+export * from './model';
+export * from './mappers';
+export * from './actionCommands';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Runtime interpreter for the Mapples `NavigationDocument`.
+ *
+ * Renders a navigation document with React Navigation (stack / tabs / drawer)
+ * and bridges navigation actions emitted through `@mapples/action`.
+ */
+export { default as MapplesNavigation } from './MapplesNavigation';
+export { default as NavigationActionHandler } from './NavigationActionHandler';
+export { default as useRefResolvers } from './useRefResolvers';
+export { NavigatorView } from './buildNavigator';
+export * from './types';
+export * from './constants';
+export * from './refs';
+export * from './model';
+export * from './mappers';
+export * from './actionCommands';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGjD,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,kBAAkB,CAAC"}

package/dist/mappers/drawerOptions.d.ts

@@ -0,0 +1,5 @@
+import { DrawerOptions } from '@mapples/types';
+import { DrawerOptionsPatch, RefResolvers } from '../types';
+/** Map {@link DrawerOptions} to a drawer navigator options patch. */
+export declare const mapDrawerOptions: (drawer: DrawerOptions | undefined, resolvers: RefResolvers) => DrawerOptionsPatch;
+//# sourceMappingURL=drawerOptions.d.ts.map

package/dist/mappers/drawerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawerOptions.d.ts","sourceRoot":"","sources":["../../src/mappers/drawerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5D,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,aAAa,GAAG,SAAS,EACjC,WAAW,YAAY,KACtB,kBAoBF,CAAC"}

package/dist/mappers/drawerOptions.js

@@ -0,0 +1,26 @@
+/** Map {@link DrawerOptions} to a drawer navigator options patch. */
+export const mapDrawerOptions = (drawer, resolvers) => {
+    const patch = {};
+    if (!drawer)
+        return patch;
+    if (drawer.position !== undefined)
+        patch.drawerPosition = drawer.position;
+    if (drawer.drawerType !== undefined)
+        patch.drawerType = drawer.drawerType;
+    const activeTintColor = resolvers.resolveColor(drawer.activeTintColor);
+    if (activeTintColor)
+        patch.drawerActiveTintColor = activeTintColor;
+    const inactiveTintColor = resolvers.resolveColor(drawer.inactiveTintColor);
+    if (inactiveTintColor)
+        patch.drawerInactiveTintColor = inactiveTintColor;
+    const style = {};
+    const backgroundColor = resolvers.resolveColor(drawer.backgroundColor);
+    if (backgroundColor)
+        style.backgroundColor = backgroundColor;
+    if (drawer.width !== undefined)
+        style.width = drawer.width;
+    if (Object.keys(style).length)
+        patch.drawerStyle = style;
+    return patch;
+};
+//# sourceMappingURL=drawerOptions.js.map

package/dist/mappers/drawerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drawerOptions.js","sourceRoot":"","sources":["../../src/mappers/drawerOptions.ts"],"names":[],"mappings":"AAIA,qEAAqE;AACrE,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAAiC,EACjC,SAAuB,EACH,EAAE;IACtB,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS;QAAE,KAAK,CAAC,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC1E,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS;QAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAE1E,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvE,IAAI,eAAe;QAAE,KAAK,CAAC,qBAAqB,GAAG,eAAe,CAAC;IAEnE,MAAM,iBAAiB,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAC3E,IAAI,iBAAiB;QAAE,KAAK,CAAC,uBAAuB,GAAG,iBAAiB,CAAC;IAEzE,MAAM,KAAK,GAAmD,EAAE,CAAC;IACjE,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvE,IAAI,eAAe;QAAE,KAAK,CAAC,eAAe,GAAG,eAAe,CAAC;IAC7D,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3D,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC;IAEzD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/mappers/headerOptions.d.ts

@@ -0,0 +1,10 @@
+import { HeaderOptions } from '@mapples/types';
+import { RefResolvers, StackHeaderOptionsPatch } from '../types';
+/**
+ * Map {@link HeaderOptions} to a native-stack header options patch. Colour
+ * fields are resolved through {@link RefResolvers} (so `ref(theme:…)` becomes a
+ * concrete colour). Only explicitly-set fields are emitted; everything else is
+ * left to the React Navigation default.
+ */
+export declare const mapHeaderOptions: (header: Partial<HeaderOptions> | undefined, resolvers: RefResolvers) => StackHeaderOptionsPatch;
+//# sourceMappingURL=headerOptions.d.ts.map

package/dist/mappers/headerOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerOptions.d.ts","sourceRoot":"","sources":["../../src/mappers/headerOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAEjE;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,OAAO,CAAC,aAAa,CAAC,GAAG,SAAS,EAC1C,WAAW,YAAY,KACtB,uBAiCF,CAAC"}

package/dist/mappers/headerOptions.js

@@ -0,0 +1,42 @@
+/**
+ * Map {@link HeaderOptions} to a native-stack header options patch. Colour
+ * fields are resolved through {@link RefResolvers} (so `ref(theme:…)` becomes a
+ * concrete colour). Only explicitly-set fields are emitted; everything else is
+ * left to the React Navigation default.
+ */
+export const mapHeaderOptions = (header, resolvers) => {
+    const patch = {};
+    if (!header)
+        return patch;
+    if (header.visible !== undefined)
+        patch.headerShown = header.visible;
+    if (header.title !== undefined)
+        patch.title = header.title;
+    if (header.backVisible !== undefined)
+        patch.headerBackVisible = header.backVisible;
+    if (header.shadowVisible !== undefined) {
+        patch.headerShadowVisible = header.shadowVisible;
+    }
+    const backgroundColor = resolvers.resolveColor(header.backgroundColor);
+    if (backgroundColor)
+        patch.headerStyle = { backgroundColor };
+    const tintColor = resolvers.resolveColor(header.tintColor);
+    if (tintColor)
+        patch.headerTintColor = tintColor;
+    if (header.titleStyle) {
+        const titleStyle = {};
+        if (header.titleStyle.fontFamily) {
+            titleStyle.fontFamily = header.titleStyle.fontFamily;
+        }
+        if (header.titleStyle.fontSize !== undefined) {
+            titleStyle.fontSize = header.titleStyle.fontSize;
+        }
+        const color = resolvers.resolveColor(header.titleStyle.color);
+        if (color)
+            titleStyle.color = color;
+        if (Object.keys(titleStyle).length)
+            patch.headerTitleStyle = titleStyle;
+    }
+    return patch;
+};
+//# sourceMappingURL=headerOptions.js.map

package/dist/mappers/headerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headerOptions.js","sourceRoot":"","sources":["../../src/mappers/headerOptions.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,MAA0C,EAC1C,SAAuB,EACE,EAAE;IAC3B,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;QAAE,KAAK,CAAC,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;IACrE,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC3D,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;QAClC,KAAK,CAAC,iBAAiB,GAAG,MAAM,CAAC,WAAW,CAAC;IAC/C,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACvC,KAAK,CAAC,mBAAmB,GAAG,MAAM,CAAC,aAAa,CAAC;IACnD,CAAC;IAED,MAAM,eAAe,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;IACvE,IAAI,eAAe;QAAE,KAAK,CAAC,WAAW,GAAG,EAAE,eAAe,EAAE,CAAC;IAE7D,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3D,IAAI,SAAS;QAAE,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC;IAEjD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,MAAM,UAAU,GACd,EAAE,CAAC;QACL,IAAI,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YACjC,UAAU,CAAC,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC;QACvD,CAAC;QACD,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC7C,UAAU,CAAC,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QACnD,CAAC;QACD,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAC9D,IAAI,KAAK;YAAE,UAAU,CAAC,KAAK,GAAG,KAAK,CAAC;QACpC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM;YAAE,KAAK,CAAC,gBAAgB,GAAG,UAAU,CAAC;IAC1E,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

package/dist/mappers/index.d.ts

@@ -0,0 +1,5 @@
+export * from './headerOptions';
+export * from './tabBarOptions';
+export * from './drawerOptions';
+export * from './screenOptions';
+//# sourceMappingURL=index.d.ts.map

package/dist/mappers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/mappers/index.js

@@ -0,0 +1,5 @@
+export * from './headerOptions';
+export * from './tabBarOptions';
+export * from './drawerOptions';
+export * from './screenOptions';
+//# sourceMappingURL=index.js.map

package/dist/mappers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mappers/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC"}

package/dist/mappers/screenOptions.d.ts

@@ -0,0 +1,13 @@
+import { RouteNode } from '@mapples/types';
+import { DrawerItemOptionsPatch, RefResolvers, StackScreenOptionsPatch, TabItemOptionsPatch } from '../types';
+/**
+ * Per-route native-stack options: the route's header overrides
+ * ({@link RouteNode.options} extends `Partial<HeaderOptions>`) plus its
+ * `presentation`.
+ */
+export declare const mapStackScreenOptions: (route: RouteNode, resolvers: RefResolvers) => StackScreenOptionsPatch;
+/** Per-route bottom-tabs item options (label + icon). */
+export declare const mapTabItemOptions: (route: RouteNode, resolvers: RefResolvers) => TabItemOptionsPatch;
+/** Per-route drawer item options (label + icon). */
+export declare const mapDrawerItemOptions: (route: RouteNode, resolvers: RefResolvers) => DrawerItemOptionsPatch;
+//# sourceMappingURL=screenOptions.d.ts.map

package/dist/mappers/screenOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screenOptions.d.ts","sourceRoot":"","sources":["../../src/mappers/screenOptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EACL,sBAAsB,EACtB,YAAY,EACZ,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAIlB;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAChC,OAAO,SAAS,EAChB,WAAW,YAAY,KACtB,uBAMF,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,iBAAiB,GAC5B,OAAO,SAAS,EAChB,WAAW,YAAY,KACtB,mBAQF,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,oBAAoB,GAC/B,OAAO,SAAS,EAChB,WAAW,YAAY,KACtB,sBAQF,CAAC"}