mapples 0.2.0-beta.10 → 0.2.0-beta.13

package/dist/commands/impl/doctorImpl.js.map

@@ -1 +1 @@
-{"version":3,"file":"doctorImpl.js","sourceRoot":"","sources":["../../../src/commands/impl/doctorImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAA6B;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAEvD,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/D,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACjE,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,YAAY,sCAAsC,CAAC,CAAC,CAAC;QACpF,OAAO;IACT,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACnE,CAAC"}
+{"version":3,"file":"doctorImpl.js","sourceRoot":"","sources":["../../../src/commands/impl/doctorImpl.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAE5F,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,IAA6B;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IACvE,IAAI,SAAS;QAAE,MAAM,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAE5D,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CACT,IAAI,CAAC,SAAS,CACZ,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,IAAI,KAAK,EAAE,MAAM,EAAE,EACtE,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACF,IAAI,OAAO;YAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QAClC,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC5C,MAAM,KAAK,GACT,GAAG,YAAY,qBAAqB,MAAM,CAAC,KAAK,aAAa,MAAM,CAAC,UAAU,kBAAkB,MAAM,CAAC,OAAO,YAAY;QAC1H,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,KAAK,sBAAsB,CAAC,CAAC,CAAC;QAC7D,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7E,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CACT,KAAK,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO;QAAE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACpC,CAAC"}

package/dist/commands/impl/initImpl.js

@@ -7,7 +7,8 @@ import { DEFAULT_PAGES_DIR, DEFAULT_ROUTES_DIR, writeConfig, configPath, } from
 import { assetUrlFor, resolveApiUrl } from '../../project/env.js';
 import { writeSecret } from '../../project/secret.js';
 import { agentNextSteps, installAgentIntegration, hooksSnippetHeading, mcpSnippetHeading, parseAgentName, } from '../../services/agentInstall.js';
-import { ensureBabelPlugin, writeSidTypes } from '../../services/scaffold.js';
+import { addRuntimeDependencies, assertLinkableApp, detectPackageManager, runInstall, } from '../../services/appDeps.js';
+import { ensureBabelPlugin, ensureMetroConfig, writeSidTypes } from '../../services/scaffold.js';
 import { runSyncEngine } from '../../services/syncEngine.js';
 import { renderReport } from '../../ui/report.js';
 import { cliOrigin } from '../../version.js';
@@ -21,10 +22,22 @@ export async function runInit(opts) {
     if (existsSync(configPath(root))) {
         throw new Error('this app is already linked (.mapples/config.json exists) — run `mapples sync`');
     }
+    // Refuse an app Mapples cannot run in BEFORE anything is written.
+    assertLinkableApp(root);
     const agent = parseAgentName(opts.agent);
     const secret = await askSecret(opts);
     const apiUrl = resolveApiUrl({ apiUrl: opts.apiUrl, denv: opts.denv });
     const { projectId, name } = await resolveProject(apiUrl, secret);
+    // The synced files import @mapples/* (and metro/babel configs below need
+    // @mapples/app/expo + babel-plugin-mapples-sid): add what the app lacks and
+    // install it with the app's own package manager before linking.
+    const pm = detectPackageManager(root);
+    const deps = addRuntimeDependencies(root);
+    const install = opts.install !== false;
+    if (deps.added.length > 0 && install) {
+        console.log(chalk.gray(`\nadding ${deps.added.length} dependencies, running \`${pm} install\`…`));
+        runInstall(root, pm);
+    }
     writeConfig(root, {
         projectId,
         apiUrl,
@@ -36,6 +49,12 @@ export async function runInit(opts) {
     console.log(chalk.bold('\nmapples init') + (name ? chalk.gray(` — project “${name}”`) : ''));
     console.log(`  ${chalk.green('A')} .mapples/config.json`);
     console.log(`  ${chalk.green('A')} .mapples/secret ${chalk.gray('(gitignored)')}`);
+    if (deps.added.length > 0) {
+        console.log(`  ${chalk.yellow('M')} package.json ${chalk.gray(`— added ${deps.added.map((d) => `${d.name}@${d.spec}`).join(', ')}`)}`);
+    }
+    for (const m of deps.mismatched) {
+        console.log(chalk.yellow(`  ⚠ ${m.name} is "${m.spec}" — every @mapples/* package should use "${m.expected}" (one release group; not changed automatically)`));
+    }
     if (writeSidTypes(root))
         console.log(`  ${chalk.green('A')} mapples/sid.d.ts`);
     const babel = ensureBabelPlugin(root);
@@ -44,6 +63,12 @@ export async function runInit(opts) {
     if (babel === 'manual') {
         console.log(chalk.yellow(`  ⚠ add 'babel-plugin-mapples-sid' to the plugins of your babel.config.js (not edited automatically)`));
     }
+    const metro = ensureMetroConfig(root);
+    if (metro === 'created')
+        console.log(`  ${chalk.green('A')} metro.config.js`);
+    if (metro === 'manual') {
+        console.log(chalk.yellow(`  ⚠ wrap your metro.config.js resolveRequest with mapplesResolver from '@mapples/app/expo' (not edited automatically)`));
+    }
     console.log(chalk.gray(`  ℹ ensure mapples/sid.d.ts is included by your tsconfig (add it to "include" if needed)`));
     let mcpSnippet = null;
     let hooksSnippet = null;
@@ -74,6 +99,14 @@ export async function runInit(opts) {
             throw err;
         console.log(chalk.yellow('  offline — run `mapples sync` once you are online'));
     }
+    console.log([
+        '',
+        chalk.bold('Next steps:'),
+        ...(deps.added.length > 0 && !install ? [`  ${pm} install`] : []),
+        `  npx expo start          — Mapples screens live under ${DEFAULT_ROUTES_DIR}/`,
+        '  npx expo run:ios|android for a native build (Metro on :8081; --port <n> if another Metro holds it)',
+        '  mapples sync            — after edits in Creator or in code',
+    ].join('\n'));
     if (agent) {
         if (mcpSnippet)
             console.log(['', mcpSnippetHeading(agent), mcpSnippet].join('\n'));

package/dist/commands/impl/initImpl.js.map

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

package/dist/commands/init.js

@@ -7,6 +7,7 @@ export function registerInit(program) {
         .option('--api-url <url>', 'Mapples API base URL')
         .option('--agent <name>', 'also set up an AI agent: claude (Claude Code) | cursor | codex (ChatGPT) — skills, instructions, MCP entry')
         .addOption(new Option('--denv <env>').hideHelp()) // internal: dev|staging|prod
+        .option('--no-install', 'add the Mapples dependencies to package.json without installing them')
         .option('--json', 'machine-readable output')
         .action(async (opts) => {
         const { runInit } = await import('./impl/initImpl.js');

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,kDAAkD,CAAC;SAC/E,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CACL,gBAAgB,EAChB,4GAA4G,CAC7G;SACA,SAAS,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,6BAA6B;SAC9E,MAAM,CAAC,QAAQ,EAAE,yBAAyB,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,MAAM,EAAE,MAAM,WAAW,CAAC;AAE5C,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,gDAAgD,CAAC;SAC7D,MAAM,CAAC,mBAAmB,EAAE,kDAAkD,CAAC;SAC/E,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC;SACjD,MAAM,CACL,gBAAgB,EAChB,4GAA4G,CAC7G;SACA,SAAS,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,6BAA6B;SAC9E,MAAM,CAAC,cAAc,EAAE,sEAAsE,CAAC;SAC9F,MAAM,CAAC,QAAQ,EAAE,yBAAyB,CAAC;SAC3C,MAAM,CAAC,KAAK,EAAE,IAA6B,EAAE,EAAE;QAC9C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACvD,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/nav/navigatorTree.d.ts

@@ -36,12 +36,33 @@ export interface NavigatorDoc {
 export declare function extractNavigatorDoc(raw: unknown): NavigatorDoc | null;
 export declare function slugSegment(name: string): string;
 export declare function humanizeSegment(segment: string): string;
+/**
+ * A designed tab bar / drawer: the Creator component the navigator names
+ * (`options.tabBar.componentUuid` / `options.drawer.componentUuid`) and the
+ * file `mapples sync` writes it to, relative to the project root.
+ */
+export interface ChromeComponentFile {
+    name: string;
+    file: string;
+}
+/** How layouts reach files outside the route tree. */
+export interface LayoutContext {
+    /** The project's routes directory (`app`, `app/(mapples)`), relative to the root. */
+    routesDir: string;
+    /** Creator component uuid → its file; resolves designed navigator chrome. */
+    chromeFiles: Map<string, ChromeComponentFile>;
+}
 interface PlannedLayout {
     file: string;
     content: string;
 }
 export interface NavPlan extends RoutePlan {
     layouts: PlannedLayout[];
+    /**
+     * Route id → the expo-router screen names from the root navigator down to
+     * it (`['(main)', 'profile']`) — what the app runtime navigates by.
+     */
+    screensByRoute: Map<string, string[]>;
     /** Navigator id by directory (relative to routesDir, '' = root) — adoption places files by it. */
     navigatorByDir: Map<string, string>;
     /** Navigators no route reaches from the root, by the `(group)` dir they were generated into. */
@@ -53,7 +74,20 @@ export interface NavPlan extends RoutePlan {
  * segment) lets the layout pass after local renames honour the files as the
  * user left them.
  */
-export declare function buildNavPlan(doc: NavigatorDoc, pages: Map<string, PageEntity>, notes: string[], segmentOverrides?: Map<string, string>): NavPlan;
+/**
+ * A route path as expo-router file segments: a Creator `:id` param is the
+ * `[id]` dynamic segment (`product/:id` → `product/[id]`).
+ */
+export declare function pathToSegment(path: string): string;
+export declare function buildNavPlan(doc: NavigatorDoc, pages: Map<string, PageEntity>, notes: string[], segmentOverrides?: Map<string, string>, context?: LayoutContext): NavPlan;
+/** Creator component uuid → its synced file, for designed navigator chrome. */
+export declare function chromeFilesFor(components: Map<string, {
+    uuid?: string;
+    name: string;
+}>, componentsMap: Record<string, {
+    file: string;
+    name: string;
+}>): Map<string, ChromeComponentFile>;
 /** Every layout the CLI writes opens with this; it is how a CLI-owned file is told from a user's. */
 export declare const GENERATED_LAYOUT_HEADER: RegExp;
 /**
@@ -72,7 +106,7 @@ export interface NavigatorSyncResult {
  * push local file renames back as route renames. Runs BEFORE the page merge
  * so the merge reads and writes each page at its final location.
  */
-export declare function syncNavigatorTree(root: string, routesDir: string, pagesDir: string, pages: Map<string, PageEntity>, pagesMap: PagesMap, baseRaw: NavigationDocument | null, remoteRaw: NavigationDocument | null, report: SyncReport): NavigatorSyncResult;
+export declare function syncNavigatorTree(root: string, routesDir: string, pagesDir: string, pages: Map<string, PageEntity>, pagesMap: PagesMap, baseRaw: NavigationDocument | null, remoteRaw: NavigationDocument | null, report: SyncReport, chromeFiles: Map<string, ChromeComponentFile>): NavigatorSyncResult;
 /** Put the merged doc back into whatever wrapper shape the server used. */
 export declare function rewrapDoc(raw: NavigationDocument | null, doc: NavigatorDoc): NavigationDocument;
 export {};

package/dist/nav/navigatorTree.js

@@ -30,13 +30,14 @@
 // may target them). Its pages never use `index`: each answers at its own
 // slug, so pages.json records a real path for them.
 import { existsSync, mkdirSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from 'node:fs';
-import { dirname, join, relative } from 'node:path';
+import { basename, dirname, join, relative } from 'node:path';
 import { printValue } from '@mapples/sid-ast';
 import { withRouteMarker } from '../codegen/emit.js';
+import { writeNavigationModule } from '../runtime/runtimeFiles.js';
 import { deprecateFile } from '../merge/deprecate.js';
 import { deepEqual } from '../merge/mergePatch.js';
 import { makePlan, placePages, pruneEmptyDirs, publicPath, } from './placement.js';
-import { hiddenScreenOptions, mapNavigatorOptions, mapScreenOptions } from './screenOptions.js';
+import { defaultScreenOptions, hiddenScreenOptions, isRef, mapNavigatorOptions, mapScreenOptions, } from './screenOptions.js';
 /** Accepts the canonical doc, or the backend's {id: 'nav_default', data: doc} wrapper. */
 export function extractNavigatorDoc(raw) {
     if (typeof raw !== 'object' || raw === null)
@@ -88,19 +89,38 @@ function uniqueSegment(segment, used) {
  * segment) lets the layout pass after local renames honour the files as the
  * user left them.
  */
-export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
+/**
+ * A route path as expo-router file segments: a Creator `:id` param is the
+ * `[id]` dynamic segment (`product/:id` → `product/[id]`).
+ */
+export function pathToSegment(path) {
+    return (path
+        .replace(/^\/+/, '')
+        .replace(/\/+$/, '')
+        .replace(/(^|\/):([A-Za-z_][A-Za-z0-9_]*)(?=\/|$)/g, '$1[$2]') || 'index');
+}
+/**
+ * The expo-router screen names above the root navigator: the route groups
+ * `routesDir` adds below `app/` (`app/(mapples)` → `['(mapples)']`).
+ */
+function rootScreenPrefix(routesDir) {
+    const parts = routesDir.split(/[\\/]+/).filter(Boolean);
+    return parts[0] === 'app' ? parts.slice(1) : parts;
+}
+export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map(), context = { routesDir: 'app', chromeFiles: new Map() }) {
     const pageByKey = pageKeyIndex(pages);
     const routes = [];
     const layouts = [];
     const navigatorByDir = new Map();
     const detachedByDir = new Map();
+    const screensByRoute = new Map();
     const seen = new Set();
     const segmentFor = (route, isInitial) => {
         const override = segmentOverrides.get(route.id);
         if (override)
             return override;
         if (route.path)
-            return route.path.replace(/^\/+/, '').replace(/\/+$/, '') || 'index';
+            return pathToSegment(route.path);
         if (route.target.kind === 'page')
             return isInitial ? 'index' : slugSegment(route.name);
         return isInitial ? `(${slugSegment(route.name)})` : slugSegment(route.name);
@@ -110,7 +130,9 @@ export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
      * caller emits this one (the root's screen list grows with detached groups
      * first). `detached` subtrees never use `index`/`(group)` positions.
      */
-    const walk = (navigatorId, dir, detached, used) => {
+    const walk = (navigatorId, dir, detached, used, 
+    /** Screen names from the root down to this navigator. */
+    chain) => {
         if (seen.has(navigatorId)) {
             notes.push(`navigation: navigator ${navigatorId} is referenced twice — second reference skipped`);
             return null;
@@ -128,7 +150,9 @@ export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
             const isInitial = !detached && route.id === initialId;
             const segment = uniqueSegment(segmentFor(route, isInitial), used);
             const where = `route “${route.name}” of navigator “${nav.name}”`;
-            const options = mapScreenOptions(route, nav.type, where, notes);
+            const mapped = mapScreenOptions(route, nav.type, where, notes);
+            const options = { ...defaultScreenOptions(route, nav, mapped), ...mapped };
+            screensByRoute.set(route.id, [...chain, segment]);
             if (route.target.kind === 'page') {
                 const pageId = pageByKey.get(route.target.pageUuid);
                 if (!pageId) {
@@ -145,22 +169,27 @@ export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
                     routeName: route.name,
                     routePath: publicPath(dir, segment),
                 });
-                screens.push({ segment, options });
+                screens.push({ segment, options, routeId: route.id });
             }
             else {
-                screens.push({ segment, options });
+                screens.push({ segment, options, routeId: route.id });
                 const childDir = dir ? join(dir, segment) : segment;
-                const child = walk(route.target.navigatorId, childDir, detached, new Set());
+                const child = walk(route.target.navigatorId, childDir, detached, new Set(), [
+                    ...chain,
+                    segment,
+                ]);
                 if (child)
-                    layouts.push(layoutFor(child.nav, childDir, child.screens, notes));
+                    layouts.push(layoutFor(child.nav, childDir, child.screens, notes, context));
             }
         }
         return { nav, screens };
     };
     const rootUsed = new Set();
-    const root = walk(doc.rootNavigatorId, '', false, rootUsed);
-    if (!root)
-        return { ...makePlan(routes), layouts, navigatorByDir, detachedByDir };
+    const prefix = rootScreenPrefix(context.routesDir);
+    const root = walk(doc.rootNavigatorId, '', false, rootUsed, prefix);
+    if (!root) {
+        return { ...makePlan(routes), layouts, navigatorByDir, detachedByDir, screensByRoute };
+    }
     // ---- detached navigators: hidden (group)s under the root directory ----
     const referenced = new Set([doc.rootNavigatorId]);
     for (const nav of Object.values(doc.navigators)) {
@@ -172,11 +201,11 @@ export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
     const attach = (navigatorId) => {
         const nav = doc.navigators[navigatorId];
         const segment = uniqueSegment(`(${slugSegment(nav.name)})`, rootUsed);
-        const group = walk(navigatorId, segment, true, new Set());
+        const group = walk(navigatorId, segment, true, new Set(), [...prefix, segment]);
         if (!group)
             return;
         detachedByDir.set(segment, navigatorId);
-        layouts.push(layoutFor(group.nav, segment, group.screens, notes));
+        layouts.push(layoutFor(group.nav, segment, group.screens, notes, context));
         root.screens.push({ segment, options: hiddenScreenOptions(root.nav.type) });
     };
     // Unreferenced navigators first (deterministic: document order), then whatever
@@ -189,15 +218,30 @@ export function buildNavPlan(doc, pages, notes, segmentOverrides = new Map()) {
         if (!seen.has(id))
             attach(id);
     }
-    layouts.push(layoutFor(root.nav, '', root.screens, notes));
-    return { ...makePlan(routes), layouts, navigatorByDir, detachedByDir };
+    layouts.push(layoutFor(root.nav, '', root.screens, notes, context));
+    return { ...makePlan(routes), layouts, navigatorByDir, detachedByDir, screensByRoute };
 }
-function layoutFor(nav, dir, screens, notes) {
+function layoutFor(nav, dir, screens, notes, context) {
+    const file = dir ? join(dir, '_layout.tsx') : '_layout.tsx';
     return {
-        file: dir ? join(dir, '_layout.tsx') : '_layout.tsx',
-        content: layoutContent(nav, screens, notes),
+        file,
+        content: layoutContent(nav, screens, notes, dir === '', {
+            ...context,
+            layoutFile: join(context.routesDir, file),
+        }),
     };
 }
+/** Creator component uuid → its synced file, for designed navigator chrome. */
+export function chromeFilesFor(components, componentsMap) {
+    const files = new Map();
+    for (const [id, component] of components) {
+        const mapping = componentsMap[id];
+        if (!mapping)
+            continue;
+        files.set(component.uuid ?? id, { name: mapping.name, file: mapping.file });
+    }
+    return files;
+}
 // ---- emission ----
 const NAVIGATOR_IMPORT = {
     stack: { name: 'Stack', module: 'expo-router' },
@@ -206,15 +250,25 @@ const NAVIGATOR_IMPORT = {
 };
 /** Every layout the CLI writes opens with this; it is how a CLI-owned file is told from a user's. */
 export const GENERATED_LAYOUT_HEADER = /^\/\/\s*GENERATED by Mapples/;
-/** Options literal; a string `tabBarIcon`/`drawerIcon` becomes an Icon renderer. */
-function optionsLiteral(options, usesIcon) {
+/**
+ * Options literal; a `tabBarIcon`/`drawerIcon` string becomes an icon
+ * renderer: a Creator reference through `RouteIcon` (the Play runtime's
+ * resolver), a bare glyph name through `Icon`.
+ */
+function optionsLiteral(options, uses) {
     const iconKeys = ['tabBarIcon', 'drawerIcon'];
     const plain = {};
     const iconParts = [];
     for (const [key, value] of Object.entries(options)) {
         if (iconKeys.includes(key) && typeof value === 'string') {
-            usesIcon.value = true;
-            iconParts.push(`${key}: ({ color }) => <Icon iconName=${JSON.stringify(value)} color={color} />`);
+            if (isRef(value)) {
+                uses.routeIcon = true;
+                iconParts.push(`${key}: ({ color, size }) => <RouteIcon icon=${JSON.stringify(value)} color={color} size={size} />`);
+            }
+            else {
+                uses.icon = true;
+                iconParts.push(`${key}: ({ color }) => <Icon iconName=${JSON.stringify(value)} color={color} />`);
+            }
         }
         else {
             plain[key] = value;
@@ -226,32 +280,119 @@ function optionsLiteral(options, usesIcon) {
     const inner = base === '{}' ? '' : base.slice(1, -1).trim().replace(/,\s*$/, '') + ', ';
     return `{ ${inner}${iconParts.join(', ')} }`;
 }
-function layoutContent(nav, screens, notes) {
+/** An import path from one project file to another, extension dropped. */
+function moduleFrom(fromFile, toFile) {
+    let rel = relative(dirname(fromFile), toFile)
+        .split(/[\\/]+/)
+        .join('/')
+        .replace(/\.tsx?$/, '');
+    if (!rel.startsWith('.'))
+        rel = `./${rel}`;
+    return rel;
+}
+function chromeWiring(nav, notes, context, taken) {
+    const options = (nav.options ?? {});
+    if (nav.type === 'tabs' && options.tabBar?.native) {
+        notes.push(`navigation: navigator “${nav.name}” uses the native tab bar — generated layouts render the JavaScript tab bar until NativeTabs emission lands`);
+    }
+    const uuid = nav.type === 'tabs'
+        ? options.tabBar?.componentUuid
+        : nav.type === 'drawer'
+            ? options.drawer?.componentUuid
+            : undefined;
+    if (!uuid)
+        return null;
+    const chrome = context.chromeFiles.get(uuid);
+    if (!chrome) {
+        notes.push(`navigation: navigator “${nav.name}” is designed with component ${uuid}, which has no synced file — the layout renders the stock ${nav.type === 'tabs' ? 'tab bar' : 'drawer'}`);
+        return null;
+    }
+    // The component file's own name (`MainTabBar.tsx` → `MainTabBar`), the
+    // identifier its default export already carries.
+    let component = basename(chrome.file)
+        .replace(/\.tsx?$/, '')
+        .replace(/[^A-Za-z0-9_$]/g, '') || 'NavigatorChrome';
+    if (/^[0-9]/.test(component))
+        component = `Chrome${component}`;
+    while (taken.has(component))
+        component = `${component}Chrome`;
+    return {
+        prop: nav.type === 'tabs' ? 'tabBar' : 'drawerContent',
+        host: nav.type === 'tabs' ? 'TabBarHost' : 'DrawerContentHost',
+        component,
+        module: moduleFrom(context.layoutFile, chrome.file),
+    };
+}
+function layoutContent(nav, screens, notes, isRoot, context) {
     const kind = NAVIGATOR_IMPORT[nav.type] ?? NAVIGATOR_IMPORT.stack;
-    const usesIcon = { value: false };
+    const uses = { icon: false, routeIcon: false };
     const screenLines = screens.map(({ segment, options }) => {
         if (Object.keys(options).length === 0) {
             return `      <${kind.name}.Screen name=${JSON.stringify(segment)} />`;
         }
-        return `      <${kind.name}.Screen name=${JSON.stringify(segment)} options={${optionsLiteral(options, usesIcon)}} />`;
+        return `      <${kind.name}.Screen name=${JSON.stringify(segment)} options={${optionsLiteral(options, uses)}} />`;
     });
     const navOptions = mapNavigatorOptions(nav.options, nav.type, `navigator “${nav.name}”`, notes);
-    const screenOptions = Object.keys(navOptions).length > 0
-        ? ` screenOptions={${optionsLiteral(navOptions, usesIcon)}}`
-        : '';
     const componentName = `${nav.name.replace(/[^A-Za-z0-9]/g, '') || 'Mapples'}Layout`;
+    const chrome = chromeWiring(nav, notes, context, new Set([componentName, kind.name, 'MapplesApp', 'Icon', 'RouteIcon', 'StatusBar']));
+    // Each screen the Creator routes gets its route's behaviour (params,
+    // on-enter action, guard, page variables) from @mapples/app.
+    const routed = screens.filter((screen) => screen.routeId !== undefined);
+    const screenLayout = routed.length > 0
+        ? [
+            '',
+            '// Creator route of each screen: params, on-enter action, guard, page variables.',
+            'const screenLayout = mapplesScreens({',
+            ...routed.map((screen) => `  ${printValue({ [screen.segment]: screen.routeId }).slice(2, -2)},`),
+            '});',
+        ]
+        : [];
+    const navigatorProps = [
+        ...(routed.length > 0 ? [' screenLayout={screenLayout}'] : []),
+        ...(chrome
+            ? [` ${chrome.prop}={(props) => <${chrome.host} {...props} Chrome={${chrome.component}} />}`]
+            : []),
+        ...(Object.keys(navOptions).length > 0
+            ? [` screenOptions={${optionsLiteral(navOptions, uses)}}`]
+            : []),
+    ].join('');
+    // The root layout mounts MapplesApp (tokens, fonts, assets and the
+    // behaviour runtime, from the files `mapples sync` writes); nested
+    // navigator layouts render inside it.
+    const indent = isRoot ? '  ' : '';
+    const navigator = [
+        `    <${kind.name}${navigatorProps}>`,
+        ...screenLines,
+        `    </${kind.name}>`,
+    ].map((line) => indent + line);
+    const appNames = [
+        ...(routed.length > 0 ? ['mapplesScreens'] : []),
+        ...(uses.routeIcon ? ['RouteIcon'] : []),
+    ];
+    const appImport = isRoot
+        ? appNames.length > 0
+            ? `import MapplesApp, { ${appNames.join(', ')} } from '@mapples/app';`
+            : "import MapplesApp from '@mapples/app';"
+        : appNames.length > 0
+            ? `import { ${appNames.join(', ')} } from '@mapples/app';`
+            : null;
     return [
         '// GENERATED by Mapples — DO NOT EDIT. This layout is owned by the CLI and',
         `// regenerated from the navigation document (navigator “${nav.name}”, ${nav.type})`,
         '// on every `mapples sync`. Edit navigation in Creator instead.',
+        ...(appImport ? [appImport] : []),
+        ...(chrome ? [`import { ${chrome.host} } from '@mapples/navigation';`] : []),
+        ...(uses.icon ? ["import { Icon } from '@mapples/ui';"] : []),
         `import { ${kind.name} } from '${kind.module}';`,
-        ...(usesIcon.value ? ["import { Icon } from '@mapples/ui';"] : []),
+        ...(isRoot ? ["import { StatusBar } from 'expo-status-bar';"] : []),
+        ...(chrome ? [`import ${chrome.component} from '${chrome.module}';`] : []),
+        ...screenLayout,
         '',
         `export default function ${componentName}() {`,
         '  return (',
-        `    <${kind.name}${screenOptions}>`,
-        ...screenLines,
-        `    </${kind.name}>`,
+        ...(isRoot ? ['    <MapplesApp>'] : []),
+        ...navigator,
+        ...(isRoot ? ['      <StatusBar style="auto" />', '    </MapplesApp>'] : []),
         '  );',
         '}',
         '',
@@ -266,7 +407,8 @@ function layoutContent(nav, screens, notes) {
 export function writeOwnedLayout(root, routesDir, file, content, report) {
     const rel = join(routesDir, file);
     const abs = join(root, rel);
-    if (existsSync(abs)) {
+    const existed = existsSync(abs);
+    if (existed) {
         const current = readFileSync(abs, 'utf8');
         if (current === content)
             return;
@@ -281,7 +423,11 @@ export function writeOwnedLayout(root, routesDir, file, content, report) {
     }
     mkdirSync(dirname(abs), { recursive: true });
     writeFileSync(abs, content);
-    report.files.push({ file: rel, action: 'updated', detail: 'CLI-owned layout' });
+    report.files.push({
+        file: rel,
+        action: existed ? 'updated' : 'created',
+        detail: 'CLI-owned layout',
+    });
 }
 /** Remove generated layouts the plan no longer has (a navigator moved or went away). Never a user file. */
 function pruneStaleLayouts(root, routesDir, planned, report) {
@@ -319,12 +465,13 @@ function pruneStaleLayouts(root, routesDir, planned, report) {
  * push local file renames back as route renames. Runs BEFORE the page merge
  * so the merge reads and writes each page at its final location.
  */
-export function syncNavigatorTree(root, routesDir, pagesDir, pages, pagesMap, baseRaw, remoteRaw, report) {
+export function syncNavigatorTree(root, routesDir, pagesDir, pages, pagesMap, baseRaw, remoteRaw, report, chromeFiles) {
     const remoteDoc = extractNavigatorDoc(remoteRaw);
     const notes = [];
-    const plan = remoteDoc ? buildNavPlan(remoteDoc, pages, notes) : makePlan([]);
+    const context = { routesDir, chromeFiles };
+    const plan = remoteDoc ? buildNavPlan(remoteDoc, pages, notes, new Map(), context) : makePlan([]);
     const baseDoc = extractNavigatorDoc(baseRaw);
-    const basePlan = baseDoc ? buildNavPlan(baseDoc, pages, []) : null;
+    const basePlan = baseDoc ? buildNavPlan(baseDoc, pages, [], new Map(), context) : null;
     for (const n of notes)
         report.notes.push(n);
     const { renames } = placePages({
@@ -357,11 +504,15 @@ export function syncNavigatorTree(root, routesDir, pagesDir, pages, pagesMap, ba
     // ---- layouts: CLI-owned, regenerated (with local renames reflected) ----
     const segmentOverrides = new Map(plan.routes.map((r) => [r.routeId, r.segment]));
     const mergedDoc = applyRenames(remoteDoc, renameMap);
-    const finalLayouts = buildNavPlan(mergedDoc, pages, [], segmentOverrides).layouts;
+    const finalPlan = buildNavPlan(mergedDoc, pages, [], segmentOverrides, context);
+    const finalLayouts = finalPlan.layouts;
     for (const layout of finalLayouts) {
         writeOwnedLayout(root, routesDir, layout.file, layout.content, report);
     }
     pruneStaleLayouts(root, routesDir, new Set(finalLayouts.map((l) => l.file)), report);
+    // The document the layouts were generated from, and where each route's
+    // screen is: what the app runtime navigates, guards and enters by.
+    writeNavigationModule(root, mergedDoc, finalPlan.screensByRoute, report);
     // ---- push: replace each renamed navigator's routes array wholesale ----
     const pushOps = [];
     // Only a rename that changes the document is worth a commit; a no-op patch