mapples 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/nav/screenOptions.js

@@ -0,0 +1,213 @@
+// Creator navigation options -> expo-router / react-navigation option names.
+//
+// The Creator writes the structured shapes of @mapples/types navigation.ts:
+// per-navigator `{header?, tabBar?, drawer?}` and per-route `ScreenOptions`
+// (`Partial<HeaderOptions>` + `tabLabel`/`tabIcon`/`drawerLabel`/`drawerIcon`).
+// The generated `_layout.tsx` hands options straight to `<Stack|Tabs|Drawer>`,
+// which only understand react-navigation names (`headerShown`, `tabBarLabel`,
+// `tabBarIcon`, …), so this module translates — mirroring the runtime mappers in
+// mapples-kit `@mapples/navigation/src/mappers`. Keys that are already
+// react-navigation names (documents saved before the structured options
+// existed carry `headerShown`, `tabBarActiveTintColor`, …) pass through
+// verbatim. Anything inapplicable to the parent navigator kind (a `tabLabel`
+// on a stack screen) is dropped, as the runtime drops it.
+//
+// The CLI never pushes options back to Creator (only route names/paths), so
+// there is no reverse mapping.
+const REF = /^ref\([^:]+:[^:]+:.+\)$/;
+/** `ref(theme:…)` / `ref(icon:…)` — resolvable only by the Creator runtime. */
+export function isRef(value) {
+    return typeof value === 'string' && REF.test(value);
+}
+function isObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/** A colour or icon value; a `ref(…)` is not resolvable in a generated layout and is omitted with a note. */
+function concrete(value, key, where, notes) {
+    if (isRef(value)) {
+        notes.push(`navigation: ${where}: ${key} is a Creator reference (${value}) — references cannot be resolved in generated layouts yet, option omitted`);
+        return undefined;
+    }
+    return value;
+}
+const HEADER_KEYS = new Set([
+    'visible',
+    'title',
+    'backVisible',
+    'shadowVisible',
+    'backgroundColor',
+    'tintColor',
+    'titleStyle',
+]);
+/** HeaderOptions -> native-stack / tabs / drawer header options. */
+function mapHeader(header, kind, where, notes) {
+    const out = {};
+    if (header.visible !== undefined)
+        out.headerShown = header.visible;
+    if (header.title !== undefined)
+        out.title = header.title;
+    // headerBackVisible is a native-stack option only.
+    if (header.backVisible !== undefined && kind === 'stack') {
+        out.headerBackVisible = header.backVisible;
+    }
+    if (header.shadowVisible !== undefined)
+        out.headerShadowVisible = header.shadowVisible;
+    const backgroundColor = concrete(header.backgroundColor, 'backgroundColor', where, notes);
+    if (backgroundColor !== undefined)
+        out.headerStyle = { backgroundColor };
+    const tintColor = concrete(header.tintColor, 'tintColor', where, notes);
+    if (tintColor !== undefined)
+        out.headerTintColor = tintColor;
+    if (isObject(header.titleStyle)) {
+        const titleStyle = {};
+        if (header.titleStyle.fontFamily !== undefined) {
+            titleStyle.fontFamily = header.titleStyle.fontFamily;
+        }
+        if (header.titleStyle.fontSize !== undefined)
+            titleStyle.fontSize = header.titleStyle.fontSize;
+        const color = concrete(header.titleStyle.color, 'titleStyle.color', where, notes);
+        if (color !== undefined)
+            titleStyle.color = color;
+        if (Object.keys(titleStyle).length > 0)
+            out.headerTitleStyle = titleStyle;
+    }
+    return out;
+}
+/** TabBarOptions -> bottom-tabs navigator options. */
+function mapTabBar(tabBar, where, notes) {
+    const out = {};
+    const style = {};
+    if (tabBar.visible !== undefined)
+        style.display = tabBar.visible ? 'flex' : 'none';
+    const backgroundColor = concrete(tabBar.backgroundColor, 'tabBar.backgroundColor', where, notes);
+    if (backgroundColor !== undefined)
+        style.backgroundColor = backgroundColor;
+    if (Object.keys(style).length > 0)
+        out.tabBarStyle = style;
+    const active = concrete(tabBar.activeTintColor, 'tabBar.activeTintColor', where, notes);
+    if (active !== undefined)
+        out.tabBarActiveTintColor = active;
+    const inactive = concrete(tabBar.inactiveTintColor, 'tabBar.inactiveTintColor', where, notes);
+    if (inactive !== undefined)
+        out.tabBarInactiveTintColor = inactive;
+    if (tabBar.labelVisible !== undefined)
+        out.tabBarShowLabel = tabBar.labelVisible;
+    if (isObject(tabBar.labelStyle)) {
+        const labelStyle = {};
+        if (tabBar.labelStyle.fontFamily !== undefined) {
+            labelStyle.fontFamily = tabBar.labelStyle.fontFamily;
+        }
+        if (tabBar.labelStyle.fontSize !== undefined)
+            labelStyle.fontSize = tabBar.labelStyle.fontSize;
+        if (Object.keys(labelStyle).length > 0)
+            out.tabBarLabelStyle = labelStyle;
+    }
+    return out;
+}
+/** DrawerOptions -> drawer navigator options. */
+function mapDrawer(drawer, where, notes) {
+    const out = {};
+    if (drawer.position !== undefined)
+        out.drawerPosition = drawer.position;
+    if (drawer.drawerType !== undefined)
+        out.drawerType = drawer.drawerType;
+    const active = concrete(drawer.activeTintColor, 'drawer.activeTintColor', where, notes);
+    if (active !== undefined)
+        out.drawerActiveTintColor = active;
+    const inactive = concrete(drawer.inactiveTintColor, 'drawer.inactiveTintColor', where, notes);
+    if (inactive !== undefined)
+        out.drawerInactiveTintColor = inactive;
+    const style = {};
+    const backgroundColor = concrete(drawer.backgroundColor, 'drawer.backgroundColor', where, notes);
+    if (backgroundColor !== undefined)
+        style.backgroundColor = backgroundColor;
+    if (drawer.width !== undefined)
+        style.width = drawer.width;
+    if (Object.keys(style).length > 0)
+        out.drawerStyle = style;
+    return out;
+}
+/** Navigator-level options -> `screenOptions` of the generated navigator. */
+export function mapNavigatorOptions(options, kind, where, notes) {
+    if (!options)
+        return {};
+    const out = {};
+    for (const [key, value] of Object.entries(options)) {
+        if (value === undefined)
+            continue;
+        if (key === 'header') {
+            if (isObject(value))
+                Object.assign(out, mapHeader(value, kind, where, notes));
+        }
+        else if (key === 'tabBar') {
+            if (isObject(value) && kind === 'tabs')
+                Object.assign(out, mapTabBar(value, where, notes));
+        }
+        else if (key === 'drawer') {
+            if (isObject(value) && kind === 'drawer')
+                Object.assign(out, mapDrawer(value, where, notes));
+        }
+        else {
+            const verbatim = concrete(value, key, where, notes);
+            if (verbatim !== undefined)
+                out[key] = verbatim;
+        }
+    }
+    return out;
+}
+/** Per-route options (+ stack presentation) -> `<X.Screen options>` of the parent navigator. */
+export function mapScreenOptions(route, kind, where, notes) {
+    const out = {};
+    const header = {};
+    for (const [key, value] of Object.entries(route.options ?? {})) {
+        if (value === undefined)
+            continue;
+        if (HEADER_KEYS.has(key)) {
+            header[key] = value;
+        }
+        else if (key === 'tabLabel') {
+            if (kind === 'tabs')
+                out.tabBarLabel = value;
+        }
+        else if (key === 'tabIcon') {
+            if (kind === 'tabs') {
+                const icon = concrete(value, key, where, notes);
+                if (icon !== undefined)
+                    out.tabBarIcon = icon;
+            }
+        }
+        else if (key === 'drawerLabel') {
+            if (kind === 'drawer')
+                out.drawerLabel = value;
+        }
+        else if (key === 'drawerIcon') {
+            if (kind === 'drawer') {
+                const icon = concrete(value, key, where, notes);
+                if (icon !== undefined)
+                    out.drawerIcon = icon;
+            }
+        }
+        else {
+            // Already a react-navigation name: passes through, minus unresolvable references.
+            const verbatim = concrete(value, key, where, notes);
+            if (verbatim !== undefined)
+                out[key] = verbatim;
+        }
+    }
+    Object.assign(out, mapHeader(header, kind, where, notes));
+    if (route.presentation !== undefined && kind === 'stack')
+        out.presentation = route.presentation;
+    return out;
+}
+/** Options hiding a route group from a tab bar / drawer (detached navigators). */
+export function hiddenScreenOptions(kind) {
+    switch (kind) {
+        case 'tabs':
+            return { href: null };
+        case 'drawer':
+            return { drawerItemStyle: { display: 'none' } };
+        default:
+            return {};
+    }
+}
+//# sourceMappingURL=screenOptions.js.map

package/dist/nav/screenOptions.js.map

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

package/dist/project/baseStore.d.ts

@@ -13,6 +13,14 @@ export declare class BaseStore {
     private get dir();
     exists(): boolean;
     readAll(): BaseSnapshot;
+    /**
+     * The HEAD this base was written at, or null. The sync engine's "nothing
+     * changed, the base is the remote" shortcut is only valid when the stamp
+     * matches the stored head: a base written by an older CLI (or interrupted
+     * mid-write) has no stamp and is refetched in full.
+     */
+    readStamp(): string | null;
+    writeStamp(head: string): void;
     readPageRoot(pageId: string): RenderDomNode | null;
     /** Atomic: write everything into base.tmp, then rename over base. */
     writeAll(snapshot: BaseSnapshot): void;

package/dist/project/baseStore.js

@@ -47,6 +47,21 @@ export class BaseStore {
         }
         return snapshot;
     }
+    /**
+     * The HEAD this base was written at, or null. The sync engine's "nothing
+     * changed, the base is the remote" shortcut is only valid when the stamp
+     * matches the stored head: a base written by an older CLI (or interrupted
+     * mid-write) has no stamp and is refetched in full.
+     */
+    readStamp() {
+        const path = join(this.dir, 'stamp.json');
+        if (!existsSync(path))
+            return null;
+        return JSON.parse(readFileSync(path, 'utf8')).head;
+    }
+    writeStamp(head) {
+        writeFileSync(join(this.dir, 'stamp.json'), JSON.stringify({ head }, null, 2) + '\n');
+    }
     readPageRoot(pageId) {
         const path = join(this.dir, 'pages', `${pageId}.json`);
         if (!existsSync(path))

package/dist/project/baseStore.js.map

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

package/dist/project/componentsMap.d.ts

@@ -0,0 +1,7 @@
+export interface ComponentMapping {
+    file: string;
+    name: string;
+}
+export type ComponentsMap = Record<string, ComponentMapping>;
+export declare function readComponentsMap(root: string): ComponentsMap;
+export declare function writeComponentsMap(root: string, map: ComponentsMap): void;

package/dist/project/componentsMap.js

@@ -0,0 +1,21 @@
+// .mapples/components.json — the componentId <-> file mapping, the component
+// counterpart of pages.json. Files are the code-side identity of a Creator
+// component; the map survives renames on either side.
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { CONFIG_DIR } from './config.js';
+function mapPath(root) {
+    return join(root, CONFIG_DIR, 'components.json');
+}
+export function readComponentsMap(root) {
+    const path = mapPath(root);
+    if (!existsSync(path))
+        return {};
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+export function writeComponentsMap(root, map) {
+    mkdirSync(join(root, CONFIG_DIR), { recursive: true });
+    const sorted = Object.fromEntries(Object.entries(map).sort(([a], [b]) => (a < b ? -1 : 1)));
+    writeFileSync(mapPath(root), JSON.stringify(sorted, null, 2) + '\n');
+}
+//# sourceMappingURL=componentsMap.js.map

package/dist/project/componentsMap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentsMap.js","sourceRoot":"","sources":["../../src/project/componentsMap.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,2EAA2E;AAC3E,sDAAsD;AAEtD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AASzC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAkB,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,GAAkB;IACjE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/project/config.d.ts

@@ -1,13 +1,22 @@
 export interface MapplesConfig {
     projectId: string;
     apiUrl: string;
-    /** Directory (relative to the project root) holding Mapplet pages. */
-    appDir: string;
-    /** Directory holding the expo-router route wrappers (CLI-managed tree). */
+    /**
+     * Directory (relative to the project root) for pages that are not in the
+     * navigation yet. A routed page's file lives under `routesDir` instead, at
+     * the position expo-router expects it.
+     */
+    pagesDir: string;
+    /** Directory for Creator components (`<componentsDir>/<Name>.tsx`). */
+    componentsDir?: string;
+    /** The expo-router tree the navigation document owns (layouts + page files). */
     routesDir?: string;
     schema: 1;
 }
 export declare const CONFIG_DIR = ".mapples";
+export declare const DEFAULT_PAGES_DIR = "mapples/pages";
+export declare const DEFAULT_COMPONENTS_DIR = "mapples/components";
+export declare const DEFAULT_ROUTES_DIR = "app/(mapples)";
 export declare function configPath(root: string): string;
 export declare function readConfig(root: string): MapplesConfig;
 export declare function writeConfig(root: string, config: MapplesConfig): void;

package/dist/project/config.js

@@ -1,6 +1,9 @@
 import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
 import { join } from 'node:path';
 export const CONFIG_DIR = '.mapples';
+export const DEFAULT_PAGES_DIR = 'mapples/pages';
+export const DEFAULT_COMPONENTS_DIR = 'mapples/components';
+export const DEFAULT_ROUTES_DIR = 'app/(mapples)';
 export function configPath(root) {
     return join(root, CONFIG_DIR, 'config.json');
 }
@@ -13,11 +16,17 @@ export function readConfig(root) {
     if (typeof parsed.projectId !== 'string' || typeof parsed.apiUrl !== 'string') {
         throw new Error(`${path} is malformed: projectId and apiUrl are required`);
     }
+    const pagesDir = typeof parsed.pagesDir === 'string'
+        ? parsed.pagesDir
+        : typeof parsed.appDir === 'string'
+            ? parsed.appDir
+            : DEFAULT_PAGES_DIR;
     return {
         projectId: parsed.projectId,
         apiUrl: parsed.apiUrl,
-        appDir: typeof parsed.appDir === 'string' ? parsed.appDir : 'mapples/pages',
-        routesDir: typeof parsed.routesDir === 'string' ? parsed.routesDir : 'app/(mapples)',
+        pagesDir,
+        componentsDir: typeof parsed.componentsDir === 'string' ? parsed.componentsDir : DEFAULT_COMPONENTS_DIR,
+        routesDir: typeof parsed.routesDir === 'string' ? parsed.routesDir : DEFAULT_ROUTES_DIR,
         schema: 1,
     };
 }

package/dist/project/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/project/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AAErC,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,mBAAmB,IAAI,uDAAuD,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA2B,CAAC;IAChF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kDAAkD,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe;QAC3E,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,eAAe;QACpF,MAAM,EAAE,CAAC;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAqB;IAC7D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/project/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAkBjC,MAAM,CAAC,MAAM,UAAU,GAAG,UAAU,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,eAAe,CAAC;AACjD,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,aAAa,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CACb,MAAM,UAAU,mBAAmB,IAAI,uDAAuD,CAC/F,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAGnD,CAAC;IACF,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC9E,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,kDAAkD,CAAC,CAAC;IAC7E,CAAC;IACD,MAAM,QAAQ,GACZ,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ;QACjC,CAAC,CAAC,MAAM,CAAC,QAAQ;QACjB,CAAC,CAAC,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ;YACjC,CAAC,CAAC,MAAM,CAAC,MAAM;YACf,CAAC,CAAC,iBAAiB,CAAC;IAC1B,OAAO;QACL,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ;QACR,aAAa,EACX,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,sBAAsB;QAC1F,SAAS,EAAE,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB;QACvF,MAAM,EAAE,CAAC;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,MAAqB;IAC7D,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AAC1E,CAAC"}

package/dist/project/env.d.ts

@@ -1,10 +1,17 @@
 export type MapplesEnv = 'dev' | 'staging' | 'prod';
 export declare const API_URLS: Record<MapplesEnv, string>;
 export declare const DEFAULT_API_URL: string;
+/** Asset bodies are served from a separate public host per stage (same
+ *  convention as the frozen @mapples/cli: prod-us api -> prod assets). */
+export declare const ASSET_URLS: Record<MapplesEnv, string>;
+/** The asset host for an API URL; custom hosts (mock server) serve their own bodies. */
+export declare function assetUrlFor(apiUrl: string): string;
 /**
- * Precedence: explicit --api-url > --denv flag > MAPPLES_ENV env var > prod.
- * `configuredUrl` (from .mapples/config.json) sits between the flags and the
- * default so a linked app keeps its URL unless the caller overrides per run.
+ * Precedence: --api-url > --denv flag > configured URL > MAPPLES_ENV > prod.
+ * Flags are explicit per-run intent and win over everything; the app's own
+ * .mapples/config.json beats the AMBIENT env var, so a shell that exports
+ * MAPPLES_ENV=dev (the local dev wrapper does) never silently redirects an
+ * app that was linked against another stage or a local mock server.
  */
 export declare function resolveApiUrl(opts: {
     apiUrl?: unknown;

package/dist/project/env.js

@@ -6,6 +6,22 @@ export const API_URLS = {
     prod: 'https://prod-us.mapples.org',
 };
 export const DEFAULT_API_URL = API_URLS.prod;
+/** Asset bodies are served from a separate public host per stage (same
+ *  convention as the frozen @mapples/cli: prod-us api -> prod assets). */
+export const ASSET_URLS = {
+    dev: 'https://dev.assets.mapples.org',
+    staging: 'https://staging.assets.mapples.org',
+    prod: 'https://prod.assets.mapples.org',
+};
+/** The asset host for an API URL; custom hosts (mock server) serve their own bodies. */
+export function assetUrlFor(apiUrl) {
+    const clean = apiUrl.replace(/\/+$/, '');
+    for (const env of Object.keys(API_URLS)) {
+        if (API_URLS[env] === clean)
+            return ASSET_URLS[env];
+    }
+    return clean;
+}
 function urlForEnv(env) {
     const url = API_URLS[env];
     if (!url) {
@@ -14,20 +30,22 @@ function urlForEnv(env) {
     return url;
 }
 /**
- * Precedence: explicit --api-url > --denv flag > MAPPLES_ENV env var > prod.
- * `configuredUrl` (from .mapples/config.json) sits between the flags and the
- * default so a linked app keeps its URL unless the caller overrides per run.
+ * Precedence: --api-url > --denv flag > configured URL > MAPPLES_ENV > prod.
+ * Flags are explicit per-run intent and win over everything; the app's own
+ * .mapples/config.json beats the AMBIENT env var, so a shell that exports
+ * MAPPLES_ENV=dev (the local dev wrapper does) never silently redirects an
+ * app that was linked against another stage or a local mock server.
  */
 export function resolveApiUrl(opts) {
     if (typeof opts.apiUrl === 'string' && opts.apiUrl.length > 0)
         return opts.apiUrl;
     if (typeof opts.denv === 'string' && opts.denv.length > 0)
         return urlForEnv(opts.denv);
+    if (opts.configuredUrl)
+        return opts.configuredUrl;
     const envVar = process.env.MAPPLES_ENV;
     if (envVar)
         return urlForEnv(envVar);
-    if (opts.configuredUrl)
-        return opts.configuredUrl;
     return DEFAULT_API_URL;
 }
 //# sourceMappingURL=env.js.map

package/dist/project/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/project/env.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAI7E,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,GAAG,EAAE,yBAAyB;IAC9B,OAAO,EAAE,6BAA6B;IACtC,IAAI,EAAE,6BAA6B;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE7C,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAiB,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,wBAAwB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,IAI7B;IACC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAClF,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,aAAa,CAAC;IAClD,OAAO,eAAe,CAAC;AACzB,CAAC"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/project/env.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAI7E,MAAM,CAAC,MAAM,QAAQ,GAA+B;IAClD,GAAG,EAAE,yBAAyB;IAC9B,OAAO,EAAE,6BAA6B;IACtC,IAAI,EAAE,6BAA6B;CACpC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,QAAQ,CAAC,IAAI,CAAC;AAE7C;0EAC0E;AAC1E,MAAM,CAAC,MAAM,UAAU,GAA+B;IACpD,GAAG,EAAE,gCAAgC;IACrC,OAAO,EAAE,oCAAoC;IAC7C,IAAI,EAAE,iCAAiC;CACxC,CAAC;AAEF,wFAAwF;AACxF,MAAM,UAAU,WAAW,CAAC,MAAc;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAiB,EAAE,CAAC;QACxD,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,SAAS,CAAC,GAAW;IAC5B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAiB,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,mBAAmB,GAAG,wBAAwB,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,IAI7B;IACC,IAAI,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,CAAC;IAClF,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvF,IAAI,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC,aAAa,CAAC;IAClD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC;IACvC,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,eAAe,CAAC;AACzB,CAAC"}

package/dist/project/pagesMap.d.ts

@@ -2,6 +2,8 @@ export interface PageMapping {
     file: string;
     name: string;
     route: string;
+    /** The navigation route this page renders, when it is in the navigation. */
+    routeId?: string;
 }
 export type PagesMap = Record<string, PageMapping>;
 export declare function readPagesMap(root: string): PagesMap;

package/dist/project/pagesMap.js.map

@@ -1 +1 @@
-{"version":3,"file":"pagesMap.js","sourceRoot":"","sources":["../../src/project/pagesMap.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAa;IACvD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}
+{"version":3,"file":"pagesMap.js","sourceRoot":"","sources":["../../src/project/pagesMap.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAa,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,GAAa;IACvD,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACvE,CAAC"}

package/dist/services/adoptService.d.ts

@@ -1,4 +1,5 @@
 import { JpatchClient } from '../api/client.js';
+import { type NavigatorNode } from '../nav/navigatorTree.js';
 import type { SyncReport } from '../ui/report.js';
 export interface AdoptInput {
     root: string;
@@ -9,3 +10,5 @@ export interface AdoptInput {
     file?: string;
 }
 export declare function proposeAdoptions(input: AdoptInput): Promise<void>;
+/** Navigator kind an expo-router layout renders: `<Tabs>` / `<Drawer>` / otherwise a stack. */
+export declare function navigatorTypeOfLayout(source: string): NavigatorNode['type'];