mapples 0.2.0-beta.12 → 0.2.0-beta.13

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.12",
+  "version": "0.2.0-beta.13",
   "description": "Mapples CLI — two-way code sync between Creator and your Expo project",
   "license": "MIT",
   "author": "Oleksandr Soloviov <oleksolv@gmail.com>",
@@ -18,9 +18,9 @@
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
-    "@mapples/codegen": "^1.6.0-beta.20260917131610",
-    "@mapples/sid-ast": "^1.6.0-beta.20260917131610",
-    "@mapples/textpatch": "^1.6.0-beta.20260929132641",
+    "@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

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

@@ -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

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/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/package.json

@@ -10,16 +10,19 @@
     "sync": "mapples sync"
   },
   "dependencies": {
-    "@mapples/action": "^1.1.2",
-    "@mapples/app": "^1.6.0-beta.0",
-    "@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",
+    "@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__",
     "@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",
@@ -38,6 +41,7 @@
     "@react-native-vector-icons/zocial": "^13.1.0",
     "expo": "~57.0.23",
     "expo-constants": "~57.0.18",
+    "expo-dev-client": "~57.0.19",
     "expo-font": "~57.0.4",
     "expo-image": "~57.0.5",
     "expo-linear-gradient": "~57.0.2",
@@ -48,6 +52,7 @@
     "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",
@@ -58,12 +63,15 @@
     "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"
   },