mapples 0.2.0-beta.9 → 0.2.0

package/dist/ui/report.js

@@ -14,6 +14,14 @@ export function emptyReport() {
         notes: [],
     };
 }
+/**
+ * A delete whose target is already gone lost nothing: deleting a container
+ * takes its children with it, so their own deletes in the same push find no
+ * target.
+ */
+export function isAlreadyRemoved(dropped) {
+    return dropped.op.op === 'delete' && dropped.reason === 'target deleted or unknown';
+}
 export function renderReport(report) {
     const lines = [];
     const icon = {
@@ -38,13 +46,27 @@ export function renderReport(report) {
             }
         }
     }
+    // Info-level findings (a handler the canvas preview doesn't run) are how
+    // the code is meant to read — one count, so the real warnings stay visible.
+    const infos = report.warnings.filter((w) => w.severity === 'info');
     for (const w of report.warnings) {
+        if (w.severity === 'info')
+            continue;
         lines.push(`  ${chalk.yellow('⚠')} ${w.file ?? ''} ${w.kind}${w.sid ? ` [${w.sid}]` : ''}: ${w.detail}`);
     }
+    if (infos.length > 0) {
+        lines.push(chalk.gray(`  ${infos.length} event handler(s) run in the app only — the canvas preview skips them`));
+    }
+    const alreadyRemoved = report.dropped.filter(isAlreadyRemoved);
     for (const d of report.dropped) {
+        if (isAlreadyRemoved(d))
+            continue;
         const { op } = d;
         lines.push(`  ${chalk.yellow('⚠')} server dropped ${op.op} ${op.entity} ${d.id ?? op.id ?? op.cid ?? ''}: ${d.reason}`);
     }
+    if (alreadyRemoved.length > 0) {
+        lines.push(chalk.gray(`  ${alreadyRemoved.length} delete(s) skipped — already removed with their parent`));
+    }
     for (const w of report.serverWarnings)
         lines.push(`  ${chalk.yellow('⚠')} server warning: ${w}`);
     for (const n of report.notes)

package/dist/ui/report.js.map

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

package/dist/version.d.ts

@@ -1,3 +1,24 @@
 /** The CLI's own published version (read from package.json — never hardcoded). */
 export declare function cliVersion(): string;
 export declare function cliOrigin(): string;
+/**
+ * The npm channel this CLI build was published on: the prerelease id of its
+ * version (`0.2.0-beta.12` -> `beta`), or null for a stable release. The
+ * Changesets pre mode publishes `X.Y.Z-<tag>.N` under the dist-tag `<tag>`.
+ */
+export declare function cliChannel(): string | null;
+/**
+ * The ONE version spec every `@mapples/*` runtime dependency of a generated
+ * app gets. All `@mapples/*` packages publish as one Changesets fixed group
+ * (one shared version from 1.6.0 on), so a single spec keeps an app coherent.
+ *
+ * - Stable CLI: `^<X.Y.Z>`, X.Y.Z being the base version of the CLI's own
+ *   `@mapples/codegen` dependency — the runtime generation the emitted code
+ *   targets (codegen is in the same fixed group). No second constant to drift.
+ * - Prerelease CLI (`mapples@beta`): the dist-tag itself (`"beta"`). A range
+ *   cannot express a channel: semver orders `rc` above `beta`, so
+ *   `^1.6.0-beta.0` resolves to the rc, while caret ranges without a
+ *   prerelease resolve to the old `latest`. The tag resolves every package to
+ *   the same fixed-group publish, and the lockfile pins it.
+ */
+export declare function mapplesRuntimeSpec(): string;

package/dist/version.js

@@ -1,12 +1,49 @@
 import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
-/** The CLI's own published version (read from package.json — never hardcoded). */
-export function cliVersion() {
+function readCliPackageJson() {
     // dist/version.js -> ../package.json
     const pkgPath = fileURLToPath(new URL('../package.json', import.meta.url));
-    return JSON.parse(readFileSync(pkgPath, 'utf8')).version;
+    return JSON.parse(readFileSync(pkgPath, 'utf8'));
+}
+/** The CLI's own published version (read from package.json — never hardcoded). */
+export function cliVersion() {
+    return readCliPackageJson().version;
 }
 export function cliOrigin() {
     return `mapples-cli@${cliVersion()}`;
 }
+/**
+ * The npm channel this CLI build was published on: the prerelease id of its
+ * version (`0.2.0-beta.12` -> `beta`), or null for a stable release. The
+ * Changesets pre mode publishes `X.Y.Z-<tag>.N` under the dist-tag `<tag>`.
+ */
+export function cliChannel() {
+    const match = /^\d+\.\d+\.\d+-([A-Za-z][0-9A-Za-z-]*)(?:\.|$)/.exec(cliVersion());
+    return match ? match[1] : null;
+}
+/**
+ * The ONE version spec every `@mapples/*` runtime dependency of a generated
+ * app gets. All `@mapples/*` packages publish as one Changesets fixed group
+ * (one shared version from 1.6.0 on), so a single spec keeps an app coherent.
+ *
+ * - Stable CLI: `^<X.Y.Z>`, X.Y.Z being the base version of the CLI's own
+ *   `@mapples/codegen` dependency — the runtime generation the emitted code
+ *   targets (codegen is in the same fixed group). No second constant to drift.
+ * - Prerelease CLI (`mapples@beta`): the dist-tag itself (`"beta"`). A range
+ *   cannot express a channel: semver orders `rc` above `beta`, so
+ *   `^1.6.0-beta.0` resolves to the rc, while caret ranges without a
+ *   prerelease resolve to the old `latest`. The tag resolves every package to
+ *   the same fixed-group publish, and the lockfile pins it.
+ */
+export function mapplesRuntimeSpec() {
+    const channel = cliChannel();
+    if (channel)
+        return channel;
+    const codegen = readCliPackageJson().dependencies?.['@mapples/codegen'];
+    const base = codegen ? /(\d+\.\d+\.\d+)/.exec(codegen)?.[1] : undefined;
+    if (!base) {
+        throw new Error(`cannot derive the @mapples runtime version: the CLI's @mapples/codegen dependency is ${JSON.stringify(codegen)}`);
+    }
+    return `^${base}`;
+}
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,kFAAkF;AAClF,MAAM,UAAU,UAAU;IACxB,qCAAqC;IACrC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAQ,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC,OAAO,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,eAAe,UAAU,EAAE,EAAE,CAAC;AACvC,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAOzC,SAAS,kBAAkB;IACzB,qCAAqC;IACrC,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAmB,CAAC;AACrE,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,UAAU;IACxB,OAAO,kBAAkB,EAAE,CAAC,OAAO,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,eAAe,UAAU,EAAE,EAAE,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,gDAAgD,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAC5B,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC,YAAY,EAAE,CAAC,kBAAkB,CAAC,CAAC;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACxE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,wFAAwF,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAClH,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,IAAI,EAAE,CAAC;AACpB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mapples",
-  "version": "0.2.0-beta.9",
+  "version": "0.2.0",
   "description": "Mapples CLI — two-way code sync between Creator and your Expo project",
   "license": "MIT",
   "author": "Oleksandr Soloviov <oleksolv@gmail.com>",
@@ -18,8 +18,9 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@mapples/codegen": "^1.6.0-beta.20260916111702",
-    "@mapples/sid-ast": "^1.6.0-beta.20260916111702",
+    "@mapples/codegen": ">=1.6.0-beta.20260930095510 <1.6.0-rc.0",
+    "@mapples/sid-ast": ">=1.6.0-beta.20260930095510 <1.6.0-rc.0",
+    "@mapples/textpatch": ">=1.6.0-beta.20260930095510 <1.6.0-rc.0",
     "@noble/hashes": "^1.6.1",
     "axios": "^1.7.9",
     "chalk": "^5.4.1",

package/templates/agent/mapples.md

@@ -5,8 +5,11 @@ This app is linked to a **Mapples Creator** project (visual editor at creator.ma
 The link is the `mapples` CLI: screens, components and design tokens are TSX and TS files in
 this repo, and `npx -y mapples@__CLI_VERSION__ sync` pushes your edits to Creator and pulls Creator's edits back
 (two-way, 3-way merged). Every write to the project goes through `npx -y mapples@__CLI_VERSION__ sync` — there is no
-other write path from here. The `mapples` MCP server (`.mcp.json`) is **read-only**: use it to
-look at the project (style tokens, assets); never expect it to change anything.
+other write path from here. The `mapples` MCP server (`.mcp.json`) authenticates with the
+project's API key, which exposes **read-only** tools: `get_project` (project metadata) and
+`get_project_style` (the theme, typography and sizing tokens at the current canvas head). It has
+no resources, prompts or asset listing — assets arrive in this repo through
+`npx -y mapples@__CLI_VERSION__ sync`. Never expect it to change anything.
 
 ## Skills
 
@@ -97,8 +100,10 @@ const styles = Styler.create({
 - Navigation from code: `$actions={{ onPress: { type: 'mapples:navigate', staticData: { pageUuid } } }}`
   on the element's primary event. The target's `pageUuid` is the `uuid` field of
   `.mapples/base/pages/<pageId>.json`; `<pageId>` is the key in `.mapples/pages.json` whose
-  `file` is the target route file. Add a `router.push('/<segment>')` `onPress` handler too so
-  the built app navigates.
+  `file` is the target route file. The built app runs `$actions` itself (as Creator's Play
+  does) — do NOT add a `router.push` `onPress` next to it: the action replaces a code handler
+  for the same event and the app warns about the duplicate. `$data` bindings (`vars.*`,
+  `api.*`, `route.*`) resolve in the app the same way.
 - Images: `<Image source="https://picsum.photos/seed/<topic>/<w>/<h>" contentFit="cover" />`
   with an explicit width/height in `styled.style`. Creator asset references (`$refs`) are
   Creator-side; do not invent them.

package/templates/agent/skills/mapples-conventions/SKILL.md

@@ -39,8 +39,8 @@ identity: keep it verbatim. Renaming the file renames the route in Creator.
 
 | Attribute | Shape | Meaning |
 | --- | --- | --- |
-| `$actions` | `{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<uuid>' } } }` | Creator prototype connection on that event. Other action types (`mapples:setState`, `mapples:goBack`, `mapples:switchTab`) exist; navigate is the one you write. |
-| `$data` | `{ visible: { key: 'vars.sheetOpen', active: true } }` | a data binding of a prop to a project variable — only when the project already has the variable |
+| `$actions` | `{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<uuid>' } } }` | Creator prototype connection on that event — and the handler the built app runs (no `router.push` next to it). Other action types (`mapples:setState`, `mapples:request`, `mapples:goBack`, `mapples:switchTab`) exist; navigate is the one you write. |
+| `$data` | `{ visible: { key: 'vars.sheetOpen', active: true } }` | a data binding of a prop to a project variable (`vars.*`), API response (`api.*`) or route param (`route.*`) — resolved live in the built app; only when the project already has the variable / request |
 | `$refs` | `{ source: 'ref(image:<uuid>)' }` | a Creator asset reference — Creator-side; never invent one |
 
 `pageUuid` lookup: `.mapples/pages.json` maps `pageId → { file, name, route, routeId }`; the
@@ -55,13 +55,14 @@ rewritten by every sync — read them fresh.
 `GridTwoColumns`, `GridThreeColumns`, `GridFourColumns`, `GradientBackground`,
 `ImageBackgroundView`, `Typography`, `Text` (never on a screen — use Typography), `Image`,
 `Icon`, `Svg`, `Vector`, `Video`, `QRCode`, `BarCode`, `Pressable`, `IconButton`, `TextInput`,
-`Select`, `FormView`, `TextField`, `SubmitButton`.
+`Select`, `FormView`, `TextField`, `SubmitButton`, `Button` (themed like the library below, but
+imported from `@mapples/ui`).
 
 `@mapples/components` — the themed library (paints itself from the tokens; prefer it):
 
 | Group | Types |
 | --- | --- |
-| actions | `Button`, `ButtonGroup`, `Fab`, `TextLink`, `BottomActionBar` |
+| actions | `ButtonGroup`, `Fab`, `TextLink`, `BottomActionBar` (`Button` is an `@mapples/ui` import) |
 | input | `InputField`, `SelectField`, `Checkbox`, `RadioGroup`, `Switch`, `Slider`, `NumberStepper`, `PinInput`, `SearchBar`, `ChatComposer`, `SegmentedControl`, `Rating`, `ChipGroup`, `Chip` |
 | content | `Card`, `MediaCard`, `List`, `ListItem`, `SectionHeader`, `Divider`, `Avatar`, `AvatarGroup`, `Badge`, `StatTile`, `Table`, `Timeline`, `ImageCarousel`, `MessageBubble`, `Accordion`, `Skeleton` |
 | navigation | `TopAppBar`, `BottomNavigationBar`, `Tabs`, `Breadcrumbs`, `Steps`, `PageControl` |

package/templates/agent/skills/mapples-design/SKILL.md

@@ -195,8 +195,8 @@ Two screens in one plan step: do them one after the other inside the step, synci
 
 ## Phase N-1 — Wiring
 
-Load `playbooks/screen-flow-wiring.md`. For every navigation the plan names, add to the source
-element's primary event both the Creator connection and the runtime handler:
+Load `playbooks/screen-flow-wiring.md`. For every navigation the plan names, add the Creator
+connection to the source element's primary event — it is also what the built app runs:
 
 ```tsx
 <Button
@@ -204,12 +204,12 @@ element's primary event both the Creator connection and the runtime handler:
   variant="filled"
   size="lg"
   fullWidth
-  onPress={() => router.push('/(main)')}
   $actions={{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<uuid from base>' } } }}
 />
 ```
 
-(`import { router } from 'expo-router'`.) Rows and cards use their own `onPress`. Walk the golden
+No `router.push` handler next to it (the action replaces it, and the app warns about the
+duplicate). Rows and cards use their own `onPress` event. Walk the golden
 path from the entry screen; every screen reachable, every flow with an exit. Sync; the report's
 `pushedOps` must cover every action you added.
 

package/templates/agent/skills/mapples-design/reference/component-library.md

@@ -40,7 +40,7 @@ and `tone` props and the style slots — never rebuild one from Views. Array pro
 
 | Type | Props to know | Use |
 | --- | --- | --- |
-| `Button` | `label`, `variant` filled\|outlined\|text\|tonal, `size` sm\|md\|lg, `fullWidth`, `leadingIconName`, `tone` | the primary action (filled lg fullWidth), secondary actions (outlined/text) |
+| `Button` | `label`, `variant` filled\|outlined\|text\|tonal, `size` sm\|md\|lg, `fullWidth`, `leadingIconName`, `tone` | the primary action (filled lg fullWidth), secondary actions (outlined/text) — **imported from `@mapples/ui`**, not `@mapples/components` |
 | `ButtonGroup` | `options` [{label, value}], `value` | a segmented pair of actions |
 | `Fab` | `iconName`, `accessibilityLabel`, `label`, `extended` | one floating primary action |
 | `TextLink` | `label`, `tone`, `underline` | Skip, Forgot password?, Sign in |
@@ -62,7 +62,7 @@ and `tone` props and the style slots — never rebuild one from Views. Array pro
 | `ChatComposer` | `placeholder`, `leadingIconName` | the chat input pinned to the bottom |
 | `SegmentedControl` | `options`, `value` | switching a view mode |
 | `Rating` | `value`, `max`, `readOnly` | stars |
-| `ChipGroup` | `options` [{label, value, iconName?}], `value`, `variant` filter\|choice, `scrollable` | filters and tags |
+| `ChipGroup` | `options` [{label, value, iconName?}], `value`, `variant` filter\|assist (filter chips toggle the selection, assist chips report a press), `scrollable` | filters and tags |
 | `Chip` | `label`, `variant` assist\|filter\|suggestion, `selected` | a single tag (content-sized; inside a row) |
 
 ### content
@@ -72,7 +72,7 @@ and `tone` props and the style slots — never rebuild one from Views. Array pro
 | `Card` | `variant` elevated\|filled\|outlined; children | any surface that groups content |
 | `MediaCard` | `source`, `title`, `subtitle`, `meta`, `aspectRatio` | a photo-topped tile (rails, grids) |
 | `List` | `variant` plain\|inset\|card, `header`; `ListItem` children | rows — the List draws dividers and the surface |
-| `ListItem` | `title`, `subtitle`, `leading` icon\|avatar\|image\|none, `leadingIconName`, `source`, `trailing` chevron\|text\|switch\|checkbox\|none, `trailingText`, `tone` | one row |
+| `ListItem` | `title`, `subtitle`, `leading` icon\|avatar\|image\|none, `leadingIconName`, `leadingName` (the name whose initials fill a `leading="avatar"` with no `source`), `source`, `trailing` chevron\|text\|switch\|checkbox\|none, `trailingText`, `tone` | one row |
 | `SectionHeader` | `title`, `actionLabel` | "Popular · See all" |
 | `Divider` | `inset` | a hairline between groups |
 | `Avatar` | `name` or `source`, `size` sm\|md\|lg\|xl, `badgeCount` | a person |

package/templates/agent/skills/mapples-design/reference/layout-contract.md

@@ -174,7 +174,6 @@ left visible with no binding covers the screen forever.
 
 ```tsx
 // (the CLI's `// mapples-route:` marker stays on line 1 once the file is synced)
-import { router } from 'expo-router';
 import { Container, GradientBackground, Icon, Typography, View } from '@mapples/ui';
 import { Button, Card, PageControl, TextLink } from '@mapples/components';
 import { Styler } from '@mapples/style';
@@ -183,7 +182,7 @@ export default function Welcome() {
   return (
     <Container styled={{ style: styles.root }}>
       <View styled={{ style: styles.topBar }}>
-        <TextLink label="Skip" tone="neutral" underline={false} onPress={() => router.push('/(main)')} />
+        <TextLink label="Skip" tone="neutral" underline={false} $actions={{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<home uuid>' } } }} />
       </View>
       <View styled={{ style: styles.hero }}>
         <GradientBackground
@@ -201,7 +200,7 @@ export default function Welcome() {
       </View>
       <View styled={{ style: styles.bottom }}>
         <PageControl count={3} value={0} variant="bars" />
-        <Button label="Continue" variant="filled" size="lg" fullWidth onPress={() => router.push('/(onboarding)/features')} />
+        <Button label="Continue" variant="filled" size="lg" fullWidth $actions={{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<features uuid>' } } }} />
       </View>
     </Container>
   );

package/templates/agent/skills/mapples-design/reference/playbooks/onboarding-flow.md

@@ -12,4 +12,4 @@ Structure per screen (root column, `justifyContent: 'space-between'`, screen pad
 
 CTA copy arc: "Continue" on middle screens; the LAST screen carries the real ask — "Get started" primary plus a `TextLink` "Sign in" row underneath for returning users.
 
-Pitfalls: no emoji heroes; one hero per screen, never hero + photo; dots and button positions must not shift between screens (same bottom block on all three); wire screen→screen and last screen→auth or home in the wiring phase (`$actions` navigate + `router.push`).
+Pitfalls: no emoji heroes; one hero per screen, never hero + photo; dots and button positions must not shift between screens (same bottom block on all three); wire screen→screen and last screen→auth or home in the wiring phase (`$actions` navigate — the app runs it).

package/templates/agent/skills/mapples-design/reference/playbooks/screen-flow-wiring.md

@@ -5,22 +5,19 @@ Wiring flows: every CTA connected, entries set, a walkable prototype.
 
 A project becomes a product when every path is walkable. After the screens exist, wire them — this is as much the design as the pixels.
 
-How a connection is written (both halves, on the element's primary event):
+How a connection is written (on the element's primary event):
 
 ```tsx
-import { router } from 'expo-router';
-// …
 <Button
   label="Add to order"
   variant="filled"
   size="lg"
   fullWidth
-  onPress={() => router.push('/(main)/cart')}
   $actions={{ onPress: { type: 'mapples:navigate', staticData: { pageUuid: '<uuid>' } } }}
 />
 ```
 
-`$actions` is the Creator connection (the storyboard arrow); `onPress` is the runtime handler. The `pageUuid` is the `uuid` field of `.mapples/base/pages/<pageId>.json`, where `<pageId>` is the key in `.mapples/pages.json` whose `file` is the target route file. Rows use `ListItem`'s `onPress`, cards `MediaCard`'s / `Card`'s `onPress`.
+`$actions` is the Creator connection (the storyboard arrow) AND the app's handler: the built app runs it the way Creator's Play does (guards, replace-on-sign-in and params included). Never add a `router.push` `onPress` next to it — the action replaces a code handler for the same event and the app warns about the duplicate. The `pageUuid` is the `uuid` field of `.mapples/base/pages/<pageId>.json`, where `<pageId>` is the key in `.mapples/pages.json` whose `file` is the target route file. Rows use `ListItem`'s `onPress`, cards `MediaCard`'s / `Card`'s `onPress`.
 
 The contract:
 - Every PRIMARY `Button` navigates to a real page: onboarding Continue → next screen, Get started → auth or home, list row / card → its detail, detail CTA → the flow it starts (cart, booking, player). No dead primary buttons, ever.

package/templates/agent/skills/mapples-design/reference/style-guides.md

@@ -87,6 +87,8 @@ Regular, Medium, SemiBold, Bold unless noted.
 The icon family is a project setting in Creator; from code, `Icon iconName="…"` uses the glyph
 names of that family (ionicons names like `home-outline`, `search`, `chevron-forward` when in
 doubt). An unknown name renders as a broken glyph — prefer a common name over a guessed one.
+The app ships only the chosen family's `@react-native-vector-icons/*` pack, which
+`npx -y mapples@__CLI_VERSION__ sync` adds once the family is set — never install packs by hand.
 
 > Not ported (Creator-only): the streaming preview cards, the `repairViolations` pass and the
 > four-guide generation count (three here, so the table fits a chat reply).

package/templates/agent/skills/mapples-sync/SKILL.md

@@ -49,11 +49,12 @@ npx -y mapples@__CLI_VERSION__ sync --yes --json
 | --- | --- |
 | `files[].action` | `created` / `updated` / `regenerated` (from Creator after a conflict) / `deprecated` (your version moved to `_depr_…`) |
 | `conflicts[]` | both sides changed the same prop or one deleted what the other edited — the file was deprecated and regenerated |
-| `warnings[]` | lossy steps: `NON_LITERAL_PROP` (an expression prop stays code-only), `UNKNOWN_ELEMENT_WITH_SID`, … |
-| `dropped[]` | ops the server skipped (target gone) — the change did not land |
+| `warnings[]` | lossy steps: `NON_LITERAL_PROP` (an expression prop stays code-only), `UNKNOWN_ELEMENT_WITH_SID`, … An entry with `"severity": "info"` is not a problem: every `onPress` handler gets one (the canvas preview doesn't run your code) — skip those and read the rest |
+| `dropped[]` | ops the server skipped (target gone) — the change did not land. An entry with `"alreadyRemoved": true` lost nothing: it is the delete of a child whose container the same push deleted |
 | `serverWarnings[]` | e.g. `CHILDREN_REBASED`: the server reordered children after a concurrent edit |
 | `offline` | true = nothing reached the server; ops parked in `.mapples/outbox/` and drained next run |
 | `notes[]` | navigator creation, agent-lease heartbeat misses, rebases |
+| `packages` | the app's dependencies follow the Creator project (icon pack of the project's icon family, QRCode/BarCode/Gradient/Video packages): `added` / `removed` changed package.json, `pluginsAdded` app.json; `installNeeded: true` means run `packages.packageManager` install (and rebuild the dev client for a native package) before starting the app. `removable` entries are left for the user. Never add or remove these packages by hand to fix a render error — sync again |
 
 ## Exit codes
 

package/templates/app/_layout.tsx

@@ -1,8 +1,13 @@
 // GENERATED by Mapples — DO NOT EDIT. This layout is owned by the CLI and
 // regenerated from the navigation document on every `mapples sync`.
 // Edit navigation in Creator instead.
+import MapplesApp from '@mapples/app';
 import { Stack } from 'expo-router';
 
 export default function RootLayout() {
-  return <Stack screenOptions={{ headerShown: false }} />;
+  return (
+    <MapplesApp>
+      <Stack screenOptions={{ headerShown: false }} />
+    </MapplesApp>
+  );
 }

package/templates/gitignore

@@ -9,3 +9,5 @@ web-build/
 .mapples/secret
 # agent-session lease state — local only
 .mapples/agent.json
+# build-time secrets for the Creator API requests (EXPO_PUBLIC_MAPPLES_SECRET_*) — never commit
+.env*.local

package/templates/metro.config.js

@@ -0,0 +1,11 @@
+const { getDefaultConfig } = require('expo/metro-config');
+// Resolves the files `mapples sync` writes (mapples/theme.ts, mapples/assetMap.ts)
+// for @mapples/app — see https://www.npmjs.com/package/@mapples/app.
+const { mapplesResolver } = require('@mapples/app/expo');
+
+const config = getDefaultConfig(__dirname);
+config.resolver.resolveRequest = mapplesResolver((context, moduleName, platform) =>
+  context.resolveRequest(context, moduleName, platform),
+);
+
+module.exports = config;

package/templates/package.json

@@ -10,59 +10,53 @@
     "sync": "mapples sync"
   },
   "dependencies": {
-    "@mapples/action": "^1.1.2",
-    "@mapples/components": "^1.2.1",
-    "@mapples/form": "^1.2.0",
-    "@mapples/inlang": "^1.2.0",
-    "@mapples/render": "^1.2.0",
-    "@mapples/state": "^1.2.0",
-    "@mapples/style": "^1.2.0",
-    "@mapples/types": "^1.2.0",
-    "@mapples/ui": "^1.1.3",
-    "@react-native-vector-icons/ant-design": "^13.1.0",
-    "@react-native-vector-icons/entypo": "^13.1.0",
-    "@react-native-vector-icons/evil-icons": "^13.1.0",
-    "@react-native-vector-icons/feather": "^13.1.0",
-    "@react-native-vector-icons/fontawesome": "^13.1.0",
-    "@react-native-vector-icons/fontawesome5": "^13.1.0",
-    "@react-native-vector-icons/fontawesome6": "^13.1.0",
-    "@react-native-vector-icons/fontisto": "^13.1.0",
-    "@react-native-vector-icons/foundation": "^13.1.0",
-    "@react-native-vector-icons/ionicons": "^13.1.0",
-    "@react-native-vector-icons/lucide": "^13.1.0",
-    "@react-native-vector-icons/material-design-icons": "^13.1.0",
-    "@react-native-vector-icons/material-icons": "^13.1.0",
-    "@react-native-vector-icons/octicons": "^21.1.0",
-    "@react-native-vector-icons/simple-line-icons": "^13.1.0",
-    "@react-native-vector-icons/zocial": "^13.1.0",
-    "expo": "~57.0.23",
-    "expo-constants": "~57.0.18",
+    "@expo/ui": "~57.0.21",
+    "@mapples/action": "__MAPPLES_RUNTIME__",
+    "@mapples/app": "__MAPPLES_RUNTIME__",
+    "@mapples/components": "__MAPPLES_RUNTIME__",
+    "@mapples/fonts": "__MAPPLES_RUNTIME__",
+    "@mapples/form": "__MAPPLES_RUNTIME__",
+    "@mapples/inlang": "__MAPPLES_RUNTIME__",
+    "@mapples/navigation": "__MAPPLES_RUNTIME__",
+    "@mapples/render": "__MAPPLES_RUNTIME__",
+    "@mapples/request": "__MAPPLES_RUNTIME__",
+    "@mapples/state": "__MAPPLES_RUNTIME__",
+    "@mapples/style": "__MAPPLES_RUNTIME__",
+    "@mapples/types": "__MAPPLES_RUNTIME__",
+    "@mapples/ui": "__MAPPLES_RUNTIME__",
+    "expo": "~57.0.26",
+    "expo-constants": "~57.0.20",
+    "expo-dev-client": "~57.0.19",
+    "expo-device": "~57.0.2",
     "expo-font": "~57.0.4",
+    "expo-glass-effect": "~57.0.4",
     "expo-image": "~57.0.5",
-    "expo-linear-gradient": "~57.0.2",
-    "expo-linking": "~57.0.10",
-    "expo-router": "~57.0.21",
+    "expo-linking": "~57.0.11",
+    "expo-router": "~57.0.24",
     "expo-splash-screen": "~57.0.9",
     "expo-status-bar": "~57.0.1",
+    "expo-symbols": "~57.0.3",
     "expo-system-ui": "~57.0.4",
     "expo-web-browser": "~57.0.3",
-    "jsbarcode": "^3.12.3",
+    "lodash": "^4.18.0",
     "react": "19.2.3",
     "react-dom": "19.2.3",
     "react-native": "0.86.3",
     "react-native-gesture-handler": "~2.32.0",
-    "react-native-qrcode-svg": "^6.3.22",
     "react-native-reanimated": "4.5.1",
     "react-native-safe-area-context": "~5.7.0",
     "react-native-screens": "~4.26.0",
     "react-native-svg": "15.15.4",
     "react-native-web": "~0.21.0",
-    "react-native-worklets": "0.10.1"
+    "react-native-worklets": "0.10.1",
+    "rxjs": "^7.8.1",
+    "yup": "^1.6.0"
   },
   "devDependencies": {
     "@babel/core": "^7.26.0",
     "@types/react": "~19.2.2",
     "babel-plugin-mapples-sid": "__CLI_VERSION__",
+    "babel-preset-expo": "~57.0.13",
     "mapples": "__CLI_VERSION__",
     "typescript": "~6.0.3"
   },