@mapples/app 1.0.2 → 1.1.1

package/README.md

@@ -31,11 +31,7 @@ import React from 'react';
 import MapplesApp from '@mapples/app';
 
 function App() {
-  return (
-    <MapplesApp>
-      {/* Your app components */}
-    </MapplesApp>
-  );
+  return <MapplesApp>{/* Your app components */}</MapplesApp>;
 }
 
 export default App;
@@ -78,10 +74,7 @@ const customStyle = {
 
 function App() {
   return (
-    <MapplesApp
-      assets={customAssets}
-      style={customStyle}
-    >
+    <MapplesApp assets={customAssets} style={customStyle}>
       {/* Your app components */}
     </MapplesApp>
   );
@@ -92,15 +85,16 @@ export default App;
 
 ## API Reference
 
-### MapplesApp (default export)
+### MapplesApp
 
-The main component that provides the core Mapples ecosystem functionality. It wraps the app with `StyleProvider` and `RenderProvider` (using `@mapples/ui` components and optional `assets`), and handles font loading via `expo-font`.
+The main component that provides the core Mapples ecosystem functionality.
 
 **Props:**
 
 - `children` - Child components
 - `style?` - Optional custom style configuration to override the default Mapples styling
 - `assets?` - Optional custom assets configuration to override the default Mapples assets
+- `navigation?` - Optional `NavigationMap` (Mapples action `routeName` → expo-router href) consumed by `useNavigationActions`
 - `showFontLoadingIndicator?` - Whether to show a loading indicator while fonts are loading
 - `FontLoadingIndicator?` - Custom loading indicator component to display while fonts are loading
 
@@ -115,16 +109,48 @@ The main component that provides the core Mapples ecosystem functionality. It wr
 </MapplesApp>
 ```
 
-### MapplesAppProvider
+### Navigation
+
+`@mapples/app` bridges Mapples **navigation** actions (`mapples:navigate`,
+`mapples:switchTab`, `mapples:goBack`, `mapples:openDrawer`,
+`mapples:closeDrawer`) to [expo-router](https://docs.expo.dev/router/introduction/).
 
-Alias for the same component as `MapplesApp`. Use either the default import or `MapplesAppProvider` when you want to make the provider role explicit.
+Pass the generated `NavigationMap` (default-exported from the
+`mapples navigation sync`–generated `navigationMap.ts`) into `MapplesApp` via the
+`navigation` prop, mirroring `assets` and `style`:
 
 ```tsx
-import MapplesApp, { MapplesAppProvider } from '@mapples/app';
+import MapplesApp from '@mapples/app';
+import navigationMap from '../navigation/navigationMap';
 
-// These are equivalent:
-<MapplesApp assets={assets} style={style}>{children}</MapplesApp>
-<MapplesAppProvider assets={assets} style={style}>{children}</MapplesAppProvider>
+<MapplesApp style={style} assets={assets} navigation={navigationMap}>
+  <YourAppContent />
+</MapplesApp>;
+```
+
+Generated route wrappers consume it through `useNavigationActions`, composing the
+result into the Mapplet's `onAction` for the navigation subset:
+
+```tsx
+import { useNavigationActions } from '@mapples/app';
+
+const onNavigation = useNavigationActions();
+// onNavigation(action) → router.push / router.back / OPEN_DRAWER / CLOSE_DRAWER
+```
+
+`useNavigationActions` reads the `NavigationMap` from context and dispatches via
+expo-router's `useRouter` + `useNavigation`. Unknown action types and unmapped
+`routeName`s are no-ops.
+
+#### Peer dependency: `expo-router`
+
+`useNavigationActions` depends on `expo-router`, declared as an **optional peer
+dependency**. Apps that use Mapples navigation already depend on `expo-router`;
+non-navigation apps are not forced to install it because the hook is only ever
+imported from generated route wrappers (which render inside the router context).
+
+```bash
+yarn add expo-router   # only if your app uses Mapples navigation
 ```
 
 ### Utility Functions
@@ -358,4 +384,4 @@ MIT License - see LICENSE file for details.
 
 ## Author
 
-Oleksandr Soloviov - [mapples.org](https://mapples.org/people/olek_soloviov)
+Oleksandr Soloviov - [mapples.org](https://mapples.org/people/olek_soloviov)

package/dist/MapplesApp.d.ts

@@ -1,6 +1,7 @@
 import { FC, PropsWithChildren, JSX } from 'react';
 import { AnyObject } from '@mapples/render';
 import { StyleContextType } from '@mapples/style';
+import { NavigationMap } from './NavigationContext';
 /**
  * Props for the MapplesApp component.
  *
@@ -11,6 +12,8 @@ export interface MapplesAppProps {
     style?: StyleContextType;
     /** Optional custom assets configuration to override the default Mapples assets */
     assets?: AnyObject;
+    /** Optional navigation map (Mapples action `routeName` → expo-router href) for navigation actions */
+    navigation?: NavigationMap;
     /** Whether to show a loading indicator while fonts are loading */
     showFontLoadingIndicator?: boolean;
     /** Custom loading indicator component to display while fonts are loading */
@@ -25,6 +28,7 @@ export interface MapplesAppProps {
  *
  * @component
  * @param props - The component props
+ * @param props.children - The application content to render inside the Mapples providers
  * @returns The configured Mapples app with all necessary providers
  *
  * @example

package/dist/MapplesApp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapplesApp.d.ts","sourceRoot":"","sources":["../src/MapplesApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAYzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,QAAA,MAAM,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAuBtD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"MapplesApp.d.ts","sourceRoot":"","sources":["../src/MapplesApp.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAazE,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAGxE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,kFAAkF;IAClF,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,qGAAqG;IACrG,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,QAAA,MAAM,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CA0BtD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/MapplesApp.js

@@ -8,7 +8,11 @@ import { useFonts } from 'expo-font';
 import assetsConfig from 'mapples::assets';
 // @ts-ignore
 // eslint-disable-next-line import/no-unresolved
+import navigationConfig from 'mapples::navigation';
+// @ts-ignore
+// eslint-disable-next-line import/no-unresolved
 import styleConfig from 'mapples::style';
+import { NavigationProvider } from './NavigationContext';
 import { remapFonts } from './utils';
 /**
  * The main MapplesApp component that provides the core Mapples ecosystem functionality.
@@ -19,6 +23,7 @@ import { remapFonts } from './utils';
  *
  * @component
  * @param props - The component props
+ * @param props.children - The application content to render inside the Mapples providers
  * @returns The configured Mapples app with all necessary providers
  *
  * @example
@@ -50,14 +55,16 @@ import { remapFonts } from './utils';
  * }
  * ```
  */
-const MapplesApp = ({ children, style, assets, showFontLoadingIndicator, FontLoadingIndicator, }) => {
+const MapplesApp = ({ children, style, assets, navigation, showFontLoadingIndicator, FontLoadingIndicator, }) => {
     const [loaded] = useFonts(remapFonts(assets || assetsConfig));
     if (!loaded && showFontLoadingIndicator) {
         return FontLoadingIndicator || null;
     }
     return (<StyleProvider style={Styler.init(style || styleConfig)}>
       <RenderProvider components={{ ...Components, ...UIComponents }} assets={assets || assetsConfig}>
-        {children}
+        <NavigationProvider navigation={navigation || navigationConfig}>
+          {children}
+        </NavigationProvider>
       </RenderProvider>
     </StyleProvider>);
 };

package/dist/MapplesApp.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapplesApp.js","sourceRoot":"","sources":["../src/MapplesApp.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAoB,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,aAAa;AACb,gDAAgD;AAChD,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAC3C,aAAa;AACb,gDAAgD;AAChD,OAAO,WAAW,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,GAA2C,CAAC,EAC1D,QAAQ,EACR,KAAK,EACL,MAAM,EACN,wBAAwB,EACxB,oBAAoB,GACrB,EAAE,EAAE;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC;IAE9D,IAAI,CAAC,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACxC,OAAO,oBAAoB,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,OAAO,CACL,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CACtD;MAAA,CAAC,cAAc,CACb,UAAU,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC,CAC/C,MAAM,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC,CAE/B;QAAA,CAAC,QAAQ,CACX;MAAA,EAAE,cAAc,CAClB;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"MapplesApp.js","sourceRoot":"","sources":["../src/MapplesApp.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAoB,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,aAAa;AACb,gDAAgD;AAChD,OAAO,YAAY,MAAM,iBAAiB,CAAC;AAC3C,aAAa;AACb,gDAAgD;AAChD,OAAO,gBAAgB,MAAM,qBAAqB,CAAC;AACnD,aAAa;AACb,gDAAgD;AAChD,OAAO,WAAW,MAAM,gBAAgB,CAAC;AAEzC,OAAO,EAAiB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,GAA2C,CAAC,EAC1D,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAU,EACV,wBAAwB,EACxB,oBAAoB,GACrB,EAAE,EAAE;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,IAAI,YAAY,CAAC,CAAC,CAAC;IAE9D,IAAI,CAAC,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACxC,OAAO,oBAAoB,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,OAAO,CACL,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,WAAW,CAAC,CAAC,CACtD;MAAA,CAAC,cAAc,CACb,UAAU,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC,CAC/C,MAAM,CAAC,CAAC,MAAM,IAAI,YAAY,CAAC,CAE/B;QAAA,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,UAAU,IAAI,gBAAgB,CAAC,CAC7D;UAAA,CAAC,QAAQ,CACX;QAAA,EAAE,kBAAkB,CACtB;MAAA,EAAE,cAAc,CAClB;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/MapplesAppProvider.d.ts

@@ -1,16 +1,19 @@
 import { FC, PropsWithChildren, JSX } from 'react';
 import { AnyObject } from '@mapples/render';
 import { StyleContextType } from '@mapples/style';
+import { NavigationMap } from './NavigationContext';
 /**
  * Props for the MapplesApp component.
  *
  * @interface MapplesAppProps
  */
 export interface MapplesAppProps {
-    /** Optional custom style configuration to override the default Mapples styling */
+    /** The style configuration for the Mapples styling system */
     style: StyleContextType;
-    /** Optional custom assets configuration to override the default Mapples assets */
+    /** The assets configuration object containing font and image references */
     assets: AnyObject;
+    /** Optional navigation map (Mapples action `routeName` → expo-router href) for navigation actions */
+    navigation?: NavigationMap;
     /** Whether to show a loading indicator while fonts are loading */
     showFontLoadingIndicator?: boolean;
     /** Custom loading indicator component to display while fonts are loading */
@@ -25,6 +28,7 @@ export interface MapplesAppProps {
  *
  * @component
  * @param props - The component props
+ * @param props.children - The application content to render inside the Mapples providers
  * @returns The configured Mapples app with all necessary providers
  *
  * @example

package/dist/MapplesAppProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MapplesAppProvider.d.ts","sourceRoot":"","sources":["../src/MapplesAppProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAMzE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,kFAAkF;IAClF,KAAK,EAAE,gBAAgB,CAAC;IACxB,kFAAkF;IAClF,MAAM,EAAE,SAAS,CAAC;IAClB,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,QAAA,MAAM,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CAuBtD,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"MapplesAppProvider.d.ts","sourceRoot":"","sources":["../src/MapplesAppProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAGnD,OAAO,EAAE,SAAS,EAAkB,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAyB,MAAM,gBAAgB,CAAC;AAIzE,OAAO,EAAE,aAAa,EAAsB,MAAM,qBAAqB,CAAC;AAGxE;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,KAAK,EAAE,gBAAgB,CAAC;IACxB,2EAA2E;IAC3E,MAAM,EAAE,SAAS,CAAC;IAClB,qGAAqG;IACrG,UAAU,CAAC,EAAE,aAAa,CAAC;IAC3B,kEAAkE;IAClE,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,4EAA4E;IAC5E,oBAAoB,CAAC,EAAE,GAAG,CAAC,OAAO,CAAC;CACpC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,QAAA,MAAM,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,eAAe,CAAC,CA0BtD,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/MapplesAppProvider.js

@@ -3,6 +3,7 @@ import { RenderProvider } from '@mapples/render';
 import { StyleProvider, Styler } from '@mapples/style';
 import { UIComponents } from '@mapples/ui';
 import { useFonts } from 'expo-font';
+import { NavigationProvider } from './NavigationContext';
 import { remapFonts } from './utils';
 /**
  * The main MapplesApp component that provides the core Mapples ecosystem functionality.
@@ -13,6 +14,7 @@ import { remapFonts } from './utils';
  *
  * @component
  * @param props - The component props
+ * @param props.children - The application content to render inside the Mapples providers
  * @returns The configured Mapples app with all necessary providers
  *
  * @example
@@ -44,14 +46,16 @@ import { remapFonts } from './utils';
  * }
  * ```
  */
-const MapplesApp = ({ children, style, assets, showFontLoadingIndicator, FontLoadingIndicator, }) => {
+const MapplesApp = ({ children, style, assets, navigation, showFontLoadingIndicator, FontLoadingIndicator, }) => {
     const [loaded] = useFonts(remapFonts(assets));
     if (!loaded && showFontLoadingIndicator) {
         return FontLoadingIndicator || null;
     }
     return (<StyleProvider style={Styler.init(style)}>
       <RenderProvider components={{ ...Components, ...UIComponents }} assets={assets}>
-        {children}
+        <NavigationProvider navigation={navigation}>
+          {children}
+        </NavigationProvider>
       </RenderProvider>
     </StyleProvider>);
 };

package/dist/MapplesAppProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"MapplesAppProvider.js","sourceRoot":"","sources":["../src/MapplesAppProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAoB,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAkBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,GAA2C,CAAC,EAC1D,QAAQ,EACR,KAAK,EACL,MAAM,EACN,wBAAwB,EACxB,oBAAoB,GACrB,EAAE,EAAE;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACxC,OAAO,oBAAoB,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,OAAO,CACL,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CACvC;MAAA,CAAC,cAAc,CACb,UAAU,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC,CAC/C,MAAM,CAAC,CAAC,MAAM,CAAC,CAEf;QAAA,CAAC,QAAQ,CACX;MAAA,EAAE,cAAc,CAClB;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}
+{"version":3,"file":"MapplesAppProvider.js","sourceRoot":"","sources":["../src/MapplesAppProvider.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAa,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,EAAoB,aAAa,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,OAAO,EAAiB,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAoBrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,MAAM,UAAU,GAA2C,CAAC,EAC1D,QAAQ,EACR,KAAK,EACL,MAAM,EACN,UAAU,EACV,wBAAwB,EACxB,oBAAoB,GACrB,EAAE,EAAE;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAE9C,IAAI,CAAC,MAAM,IAAI,wBAAwB,EAAE,CAAC;QACxC,OAAO,oBAAoB,IAAI,IAAI,CAAC;IACtC,CAAC;IAED,OAAO,CACL,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CACvC;MAAA,CAAC,cAAc,CACb,UAAU,CAAC,CAAC,EAAE,GAAG,UAAU,EAAE,GAAG,YAAY,EAAE,CAAC,CAC/C,MAAM,CAAC,CAAC,MAAM,CAAC,CAEf;QAAA,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,UAAU,CAAC,CACzC;UAAA,CAAC,QAAQ,CACX;QAAA,EAAE,kBAAkB,CACtB;MAAA,EAAE,cAAc,CAClB;IAAA,EAAE,aAAa,CAAC,CACjB,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/dist/NavigationContext.d.ts

@@ -0,0 +1,37 @@
+import { FC, PropsWithChildren } from 'react';
+/**
+ * Maps Mapples navigation actions to expo-router hrefs.
+ *
+ * Produced by `mapples navigation sync` (CLI) and default-exported from a
+ * generated `navigationMap.ts` placed outside the `app/` route group. The
+ * consumer passes it into {@link MapplesApp} via the `navigation` prop,
+ * mirroring how `assets` and `style` flow through the app today.
+ *
+ * @interface NavigationMap
+ */
+export interface NavigationMap {
+    /**
+     * Mapples action `routeName` → expo-router href. Both the qualified
+     * `navigator:route` name and (when unambiguous) the bare `route` name are
+     * emitted as keys during the naming transition.
+     */
+    routes: Record<string, string>;
+}
+/**
+ * Context carrying the active {@link NavigationMap}. Defaults to an empty map
+ * so {@link useNavigationActions} no-ops gracefully when navigation isn't wired.
+ */
+export declare const NavigationContext: import("react").Context<NavigationMap>;
+/**
+ * Provides a {@link NavigationMap} to the tree. Wired by `MapplesApp` /
+ * `MapplesAppProvider` alongside `StyleProvider` and `RenderProvider`.
+ *
+ * @param props.navigation - The navigation map to provide. Falls back to an
+ *   empty map when omitted.
+ */
+export declare const NavigationProvider: FC<PropsWithChildren<{
+    navigation?: NavigationMap;
+}>>;
+/** Reads the active {@link NavigationMap} from context. */
+export declare const useNavigationMap: () => NavigationMap;
+//# sourceMappingURL=NavigationContext.d.ts.map

package/dist/NavigationContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContext.d.ts","sourceRoot":"","sources":["../src/NavigationContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAiB,EAAE,EAAE,iBAAiB,EAAc,MAAM,OAAO,CAAC;AAEzE;;;;;;;;;GASG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAKD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,wCACsB,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,EAAE,EAAE,CACjC,iBAAiB,CAAC;IAAE,UAAU,CAAC,EAAE,aAAa,CAAA;CAAE,CAAC,CAKlD,CAAC;AAEF,2DAA2D;AAC3D,eAAO,MAAM,gBAAgB,QAAO,aACL,CAAC"}

package/dist/NavigationContext.js

@@ -0,0 +1,21 @@
+import { createContext, useContext } from 'react';
+/** Empty map used when no navigation configuration is provided. */
+const EMPTY_NAVIGATION_MAP = { routes: {} };
+/**
+ * Context carrying the active {@link NavigationMap}. Defaults to an empty map
+ * so {@link useNavigationActions} no-ops gracefully when navigation isn't wired.
+ */
+export const NavigationContext = createContext(EMPTY_NAVIGATION_MAP);
+/**
+ * Provides a {@link NavigationMap} to the tree. Wired by `MapplesApp` /
+ * `MapplesAppProvider` alongside `StyleProvider` and `RenderProvider`.
+ *
+ * @param props.navigation - The navigation map to provide. Falls back to an
+ *   empty map when omitted.
+ */
+export const NavigationProvider = ({ navigation, children }) => (<NavigationContext.Provider value={navigation ?? EMPTY_NAVIGATION_MAP}>
+    {children}
+  </NavigationContext.Provider>);
+/** Reads the active {@link NavigationMap} from context. */
+export const useNavigationMap = () => useContext(NavigationContext);
+//# sourceMappingURL=NavigationContext.js.map

package/dist/NavigationContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationContext.js","sourceRoot":"","sources":["../src/NavigationContext.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAyB,UAAU,EAAE,MAAM,OAAO,CAAC;AAqBzE,mEAAmE;AACnE,MAAM,oBAAoB,GAAkB,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAE3D;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAC5B,aAAa,CAAgB,oBAAoB,CAAC,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAE3B,CAAC,EAAE,UAAU,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAChC,CAAC,iBAAiB,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,UAAU,IAAI,oBAAoB,CAAC,CACpE;IAAA,CAAC,QAAQ,CACX;EAAA,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAC9B,CAAC;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAClD,UAAU,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -10,4 +10,9 @@ export { default } from './MapplesApp';
 export type { MapplesAppProps } from './MapplesApp';
 export { normalizeKey, remapFonts } from './utils';
 export { default as MapplesAppProvider } from './MapplesAppProvider';
+export type { NavigationMap } from './NavigationContext';
+export { NavigationContext, NavigationProvider, useNavigationMap, } from './NavigationContext';
+export { useNavigationActions } from './useNavigationActions';
+export { createNavigationDispatch } from './navigationDispatch';
+export type { RouterLike, NavigationLike } from './navigationDispatch';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACrE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC;AAChE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -9,4 +9,7 @@
 export { default } from './MapplesApp';
 export { normalizeKey, remapFonts } from './utils';
 export { default as MapplesAppProvider } from './MapplesAppProvider';
+export { NavigationContext, NavigationProvider, useNavigationMap, } from './NavigationContext';
+export { useNavigationActions } from './useNavigationActions';
+export { createNavigationDispatch } from './navigationDispatch';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAErE,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/navigationDispatch.d.ts

@@ -0,0 +1,26 @@
+import type { Action } from '@mapples/types';
+import { NavigationMap } from './NavigationContext';
+/** Minimal structural slice of expo-router's `useRouter()` we depend on. */
+export interface RouterLike {
+    push: (href: {
+        pathname: string;
+        params?: Record<string, unknown>;
+    }) => void;
+    canGoBack: () => boolean;
+    back: () => void;
+}
+/** Minimal structural slice of React Navigation's `useNavigation()`. */
+export interface NavigationLike {
+    dispatch: (action: {
+        type: string;
+    }) => void;
+}
+/**
+ * Build the navigation action dispatcher from a resolved route map and the
+ * router/navigation objects. Pure (no React, no expo-router) so the per-action
+ * behaviour can be unit-tested without a renderer or native modules.
+ *
+ * Logic is ported verbatim from the CLI's `MapplesActions.ts.tmpl` bridge.
+ */
+export declare const createNavigationDispatch: (routes: NavigationMap["routes"], router: RouterLike, navigation: NavigationLike) => (action: Action) => void;
+//# sourceMappingURL=navigationDispatch.d.ts.map

package/dist/navigationDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationDispatch.d.ts","sourceRoot":"","sources":["../src/navigationDispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,CAAC,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,KAAK,IAAI,CAAC;IAC7E,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAC9C;AAED;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB,GAEjC,QAAQ,aAAa,CAAC,QAAQ,CAAC,EAC/B,QAAQ,UAAU,EAClB,YAAY,cAAc,MAE3B,QAAQ,MAAM,KAAG,IAqCjB,CAAC"}

package/dist/navigationDispatch.js

@@ -0,0 +1,39 @@
+/**
+ * Build the navigation action dispatcher from a resolved route map and the
+ * router/navigation objects. Pure (no React, no expo-router) so the per-action
+ * behaviour can be unit-tested without a renderer or native modules.
+ *
+ * Logic is ported verbatim from the CLI's `MapplesActions.ts.tmpl` bridge.
+ */
+export const createNavigationDispatch = (routes, router, navigation) => (action) => {
+    // Read the action structurally — the action shape is owned by
+    // `@mapples/render`/the canvas, not by this package.
+    const a = action;
+    const data = a.payload?.data ?? {};
+    switch (a.type) {
+        case 'mapples:navigate':
+        case 'mapples:switchTab': {
+            const href = data.routeName ? routes[data.routeName] : undefined;
+            if (href) {
+                router.push({ pathname: href, params: data.params });
+            }
+            break;
+        }
+        case 'mapples:goBack':
+            if (router.canGoBack()) {
+                router.back();
+            }
+            break;
+        case 'mapples:openDrawer':
+        case 'mapples:closeDrawer':
+            // Dispatch by canonical React Navigation type string, avoiding a hard
+            // import of `@react-navigation/drawer` (optional for drawer apps).
+            navigation.dispatch({
+                type: a.type === 'mapples:openDrawer' ? 'OPEN_DRAWER' : 'CLOSE_DRAWER',
+            });
+            break;
+        default:
+            break;
+    }
+};
+//# sourceMappingURL=navigationDispatch.js.map

package/dist/navigationDispatch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigationDispatch.js","sourceRoot":"","sources":["../src/navigationDispatch.ts"],"names":[],"mappings":"AAgBA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,wBAAwB,GACnC,CACE,MAA+B,EAC/B,MAAkB,EAClB,UAA0B,EAC1B,EAAE,CACJ,CAAC,MAAc,EAAQ,EAAE;IACvB,8DAA8D;IAC9D,qDAAqD;IACrD,MAAM,CAAC,GAAG,MAKT,CAAC;IACF,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC;IAEnC,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;QACf,KAAK,kBAAkB,CAAC;QACxB,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACjE,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,MAAM;QACR,CAAC;QACD,KAAK,gBAAgB;YACnB,IAAI,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;gBACvB,MAAM,CAAC,IAAI,EAAE,CAAC;YAChB,CAAC;YACD,MAAM;QACR,KAAK,oBAAoB,CAAC;QAC1B,KAAK,qBAAqB;YACxB,sEAAsE;YACtE,mEAAmE;YACnE,UAAU,CAAC,QAAQ,CAAC;gBAClB,IAAI,EACF,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc;aACnE,CAAC,CAAC;YACH,MAAM;QACR;YACE,MAAM;IACV,CAAC;AACH,CAAC,CAAC"}

package/dist/useNavigationActions.d.ts

@@ -0,0 +1,19 @@
+import type { Action } from '@mapples/types';
+/**
+ * Hook that bridges Mapples **navigation** actions to expo-router. It reads the
+ * {@link NavigationMap} from context and uses expo-router's `useRouter` +
+ * `useNavigation`. Generated route wrappers call this and feed the result into
+ * the Mapplet's `onAction` (composed with general action dispatch).
+ *
+ * Scope: navigation actions only (`mapples:navigate`, `mapples:switchTab`,
+ * `mapples:goBack`, `mapples:openDrawer`, `mapples:closeDrawer`). Unknown or
+ * unmapped routes are no-ops.
+ *
+ * Only imported from generated route wrappers, which render inside the
+ * expo-router context — non-navigation apps never reach this module, hence
+ * `expo-router` is an optional peer dependency.
+ *
+ * @returns A handler `(action: Action) => void`.
+ */
+export declare const useNavigationActions: () => ((action: Action) => void);
+//# sourceMappingURL=useNavigationActions.d.ts.map

package/dist/useNavigationActions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationActions.d.ts","sourceRoot":"","sources":["../src/useNavigationActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAU7C;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,oBAAoB,QAAO,CAAC,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAMhE,CAAC"}

package/dist/useNavigationActions.js

@@ -0,0 +1,26 @@
+import { useRouter, useNavigation } from 'expo-router';
+import { useNavigationMap } from './NavigationContext';
+import { createNavigationDispatch, } from './navigationDispatch';
+/**
+ * Hook that bridges Mapples **navigation** actions to expo-router. It reads the
+ * {@link NavigationMap} from context and uses expo-router's `useRouter` +
+ * `useNavigation`. Generated route wrappers call this and feed the result into
+ * the Mapplet's `onAction` (composed with general action dispatch).
+ *
+ * Scope: navigation actions only (`mapples:navigate`, `mapples:switchTab`,
+ * `mapples:goBack`, `mapples:openDrawer`, `mapples:closeDrawer`). Unknown or
+ * unmapped routes are no-ops.
+ *
+ * Only imported from generated route wrappers, which render inside the
+ * expo-router context — non-navigation apps never reach this module, hence
+ * `expo-router` is an optional peer dependency.
+ *
+ * @returns A handler `(action: Action) => void`.
+ */
+export const useNavigationActions = () => {
+    const { routes } = useNavigationMap();
+    const router = useRouter();
+    const navigation = useNavigation();
+    return createNavigationDispatch(routes, router, navigation);
+};
+//# sourceMappingURL=useNavigationActions.js.map

package/dist/useNavigationActions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNavigationActions.js","sourceRoot":"","sources":["../src/useNavigationActions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EACL,wBAAwB,GAGzB,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAA+B,EAAE;IACnE,MAAM,EAAE,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACtC,MAAM,MAAM,GAAG,SAAS,EAA2B,CAAC;IACpD,MAAM,UAAU,GAAG,aAAa,EAA+B,CAAC;IAEhE,OAAO,wBAAwB,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC,CAAC"}

package/expo/index.js

@@ -24,6 +24,17 @@ const mapplesResolver = (resolver) => (context, moduleName, platform) => {
     return context.resolveRequest(context, assetsPath, platform);
   }
 
+  if (moduleName === 'mapples::navigation') {
+    const config = JSON.parse(
+      fs.readFileSync(path.resolve('./.mapplesrc.json'), 'utf-8'),
+    );
+    const navigationMap = path.resolve(
+      `./${config.sourceDir}/${config.dirs.navigation}/navigationMap`,
+    );
+
+    return context.resolveRequest(context, navigationMap, platform);
+  }
+
   if (resolver) {
     return resolver(context, moduleName, platform);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mapples/app",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
@@ -8,6 +8,7 @@
     "watch": "tsc -b --watch tsconfig.build.json",
     "lint": "eslint .",
     "type-check": "tsc --noEmit",
+    "test": "jest",
     "clean": "rm -rf dist"
   },
   "author": {
@@ -21,11 +22,17 @@
     "directory": "packages/@mapples/app"
   },
   "peerDependencies": {
+    "expo-router": ">=56.0.0 <57",
     "react": ">=18.0.0 <20.0.0",
     "react-native": ">=0.71.0"
   },
+  "peerDependenciesMeta": {
+    "expo-router": {
+      "optional": true
+    }
+  },
   "devDependencies": {
-    "typescript": "~5.9.2"
+    "typescript": "~6.0.3"
   },
   "files": [
     "dist",