peachsim 0.1.1625 → 0.1.1640

package/dist-lib/worklet-executable.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1625 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1640 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;
@@ -185,6 +185,8 @@ function enter(node, scope) {
         const name = identifierName(id);
         if (name !== void 0 && isNode(init))
           declare(target, name, { kind: "value", init, scope });
+        else if (name !== void 0 && init === null)
+          declare(target, name, { kind: "uninitialized" });
         else declareOpaque(target, patternNames(id));
       }
       return scope;
@@ -254,12 +256,18 @@ function collectInitData(root) {
     immediate: /* @__PURE__ */ new Map(),
     writes: [],
     reassigned: /* @__PURE__ */ new Set(),
+    assigned: /* @__PURE__ */ new Map(),
     free: /* @__PURE__ */ new Map()
   };
   visit(root, newScope(void 0, true), collection);
   for (const { name, scope, value } of collection.writes) {
     const binding = lookup(scope, name);
-    if (binding) collection.reassigned.add(binding);
+    if (binding?.kind === "uninitialized")
+      collection.assigned.set(
+        binding,
+        collection.assigned.has(binding) || !value ? null : { value, scope }
+      );
+    else if (binding) collection.reassigned.add(binding);
     else
       collection.free.set(
         name,
@@ -320,6 +328,10 @@ function resolveObject(expression, scope, collection, depth) {
       return free ? resolveObject(free.value, free.scope, collection, depth + 1) : void 0;
     }
     if (collection.reassigned.has(binding)) return void 0;
+    if (binding.kind === "uninitialized") {
+      const assigned = collection.assigned.get(binding);
+      return assigned ? resolveObject(assigned.value, assigned.scope, collection, depth + 1) : void 0;
+    }
     if (binding.kind === "value")
       return resolveObject(binding.init, binding.scope, collection, depth + 1);
     if (binding.kind === "param") {

package/dist-lib/worklet-executable.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1625 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1640 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/worklet-executable.ts
 import { parse } from "acorn";
@@ -160,6 +160,8 @@ function enter(node, scope) {
         const name = identifierName(id);
         if (name !== void 0 && isNode(init))
           declare(target, name, { kind: "value", init, scope });
+        else if (name !== void 0 && init === null)
+          declare(target, name, { kind: "uninitialized" });
         else declareOpaque(target, patternNames(id));
       }
       return scope;
@@ -229,12 +231,18 @@ function collectInitData(root) {
     immediate: /* @__PURE__ */ new Map(),
     writes: [],
     reassigned: /* @__PURE__ */ new Set(),
+    assigned: /* @__PURE__ */ new Map(),
     free: /* @__PURE__ */ new Map()
   };
   visit(root, newScope(void 0, true), collection);
   for (const { name, scope, value } of collection.writes) {
     const binding = lookup(scope, name);
-    if (binding) collection.reassigned.add(binding);
+    if (binding?.kind === "uninitialized")
+      collection.assigned.set(
+        binding,
+        collection.assigned.has(binding) || !value ? null : { value, scope }
+      );
+    else if (binding) collection.reassigned.add(binding);
     else
       collection.free.set(
         name,
@@ -295,6 +303,10 @@ function resolveObject(expression, scope, collection, depth) {
       return free ? resolveObject(free.value, free.scope, collection, depth + 1) : void 0;
     }
     if (collection.reassigned.has(binding)) return void 0;
+    if (binding.kind === "uninitialized") {
+      const assigned = collection.assigned.get(binding);
+      return assigned ? resolveObject(assigned.value, assigned.scope, collection, depth + 1) : void 0;
+    }
     if (binding.kind === "value")
       return resolveObject(binding.init, binding.scope, collection, depth + 1);
     if (binding.kind === "param") {

package/kotlin/AppSources/dev/peach/app/PeachDrawable.kt

@@ -4,18 +4,21 @@ import androidx.compose.ui.graphics.Brush
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.graphics.ImageBitmap
 import androidx.compose.ui.graphics.SolidColor
-import androidx.compose.ui.graphics.toComposeImageBitmap
+import androidx.compose.ui.graphics.asComposeImageBitmap
 import androidx.compose.ui.graphics.vector.ImageVector
 import kotlin.io.encoding.Base64
 import kotlin.io.encoding.ExperimentalEncodingApi
+import org.jetbrains.skia.Bitmap as SkiaBitmap
 import org.jetbrains.skia.BlendMode
+import org.jetbrains.skia.Canvas
+import org.jetbrains.skia.Codec
+import org.jetbrains.skia.Data
 import org.jetbrains.skia.FilterMipmap
 import org.jetbrains.skia.FilterMode
 import org.jetbrains.skia.Image
 import org.jetbrains.skia.MipmapMode
 import org.jetbrains.skia.Paint
 import org.jetbrains.skia.Rect
-import org.jetbrains.skia.Surface
 
 // one file a drawable resource resolves to under a density (ResTable_config's
 // value, 0 for an unqualified directory) and a platform version: a vector the
@@ -67,28 +70,32 @@ private fun isBetter(a: PeachDrawable, b: PeachDrawable, requested: Int): Boolea
 // bitmap drawn for a higher density than the display's is scaled down, its
 // size rounded, through a linear filtered draw with the source blend; one
 // drawn for a lower density, or nodpi, keeps its pixels, as from API 28 the
-// upscale is left to draw time, which BitmapPainter does not do
+// upscale is left to draw time, which BitmapPainter does not do. as
+// ImageDecoder does, the codec decodes into a bitmap and the scale draws into
+// another
 @OptIn(ExperimentalEncodingApi::class)
 internal fun peachDecodeBitmap(drawable: PeachDrawable.Bitmap, targetDensity: Int): ImageBitmap {
     if (drawable.ninePatch)
         throw UnsupportedOperationException("peach kotlin: the nine-patch drawable ${drawable.path} is not drawn yet")
-    val image = Image.makeFromEncoded(Base64.decode(drawable.data))
+    val decoded = Codec.makeFromData(Data.makeFromBytes(Base64.decode(drawable.data))).readPixels()
     val density = if (drawable.density == DENSITY_DEFAULT) DENSITY_MEDIUM else drawable.density
-    if (drawable.density == DENSITY_NONE || density <= targetDensity) return image.toComposeImageBitmap()
+    if (drawable.density == DENSITY_NONE || density <= targetDensity) return decoded.asComposeImageBitmap()
     val scale = targetDensity.toFloat() / density
-    val width = maxOf((image.width * scale + 0.5f).toInt(), 1)
-    val height = maxOf((image.height * scale + 0.5f).toInt(), 1)
-    val surface = Surface.makeRasterN32Premul(width, height)
-    surface.canvas.scale(width.toFloat() / image.width, height.toFloat() / image.height)
-    surface.canvas.drawImageRect(
-        image,
-        Rect.makeWH(image.width.toFloat(), image.height.toFloat()),
-        Rect.makeWH(image.width.toFloat(), image.height.toFloat()),
+    val width = maxOf((decoded.width * scale + 0.5f).toInt(), 1)
+    val height = maxOf((decoded.height * scale + 0.5f).toInt(), 1)
+    val scaled = SkiaBitmap().apply { allocN32Pixels(width, height) }
+    val canvas = Canvas(scaled)
+    canvas.scale(width.toFloat() / decoded.width, height.toFloat() / decoded.height)
+    canvas.drawImageRect(
+        Image.makeFromBitmap(decoded),
+        Rect.makeWH(decoded.width.toFloat(), decoded.height.toFloat()),
+        Rect.makeWH(decoded.width.toFloat(), decoded.height.toFloat()),
         FilterMipmap(FilterMode.LINEAR, MipmapMode.NONE),
         Paint().apply { blendMode = BlendMode.SRC },
         false,
     )
-    return surface.makeImageSnapshot().toComposeImageBitmap()
+    canvas.close()
+    return scaled.asComposeImageBitmap()
 }
 
 // ComplexColorCompat.willDraw: a transparent solid color draws nothing

package/kotlin/Sources/androidx/annotation/DrawableRes.kt

@@ -0,0 +1,14 @@
+package androidx.annotation
+
+// androidx.annotation's DrawableRes, which only its android artifact declares
+@MustBeDocumented
+@Retention(AnnotationRetention.BINARY)
+@Target(
+    AnnotationTarget.FUNCTION,
+    AnnotationTarget.PROPERTY_GETTER,
+    AnnotationTarget.PROPERTY_SETTER,
+    AnnotationTarget.VALUE_PARAMETER,
+    AnnotationTarget.FIELD,
+    AnnotationTarget.LOCAL_VARIABLE,
+)
+annotation class DrawableRes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "peachsim",
-  "version": "0.1.1625",
+  "version": "0.1.1640",
   "description": "Vite and Metro plugins, testing drivers, and SDK exports for peach.",
   "author": "Tamagui LLC",
   "license": "SEE LICENSE IN LICENSE",

package/scripts/dev-server-scanner.ts

@@ -25,6 +25,7 @@ import {
 } from '../src/backend-origin.ts'
 import { applyPeachConfigToUrl } from '../src/config.ts'
 import { fetchDevManifest } from '../src/dev-bundle-resolution'
+import { parseExpoManifestBody } from '../src/expo-manifest-body'
 import {
   KOTLIN_DISCOVERY_PATH,
   KOTLIN_GUEST_PATH,
@@ -969,7 +970,7 @@ function applyManifest(
 ): DiscoveredServer {
   if (!manifestRes) return result
   try {
-    const manifest = JSON.parse(manifestRes.body)
+    const manifest = parseExpoManifestBody(manifestRes.body)
     const client = manifest?.extra?.expoClient || manifest?.extra || {}
     if (client.name) result.projectName = client.name
     if (typeof client.primaryColor === 'string') result.primaryColor = client.primaryColor

package/skills/peach-perf/SKILL.md

@@ -310,9 +310,14 @@ attributes a missing frame to its hop:
 - `delivery lag` — vsync postMessage receipt latency above the run's
   best case; jitter here means the shell worker was descheduled or its
   queue was busy.
-- `paint interval` — the end-to-end cadence the user perceives.
-- `idle breaks` — gaps >250ms, excluded from all three: demand-gated
-  quiesce is legitimate, not starvation.
+- `present interval` — intervals between admitted compositor presentations,
+  including native frames, while progress remains pending after the preceding
+  presentation (`motionPending` in `compositorCadence.frameSeries`). Settled
+  admitted frames end a sequence; deferred frames retain the pending gap.
+  `paintIntervals` reports the sample count, so zero samples do not prove
+  smoothness. Shell work and JavaScript flushes can park while native frames
+  continue presenting.
+- `idle breaks` — host gaps >250ms, excluded from host interval statistics.
 
 the compositor `compositorHostFrameClock` keeps its historical name and reports
 display/timer ticks consumed by the compositor worker's resilient clock during
@@ -320,8 +325,9 @@ the acknowledged profile window. `published` is null because renderer-main no
 longer publishes compositor frames. sparse consumed ticks with low production
 time identifies worker scheduling starvation. many consumed ticks with sparse
 paints can be legitimate dirty-gating; correlate the frame series before
-treating it as a regression. shell cadence comes from its worker frame and paint
-series.
+treating it as a regression. Host and shell delivery statistics come from the
+shell worker; `cadence.paintInterval*` comes from compositor presentation times
+during motion.
 
 compare baseline vs contended captures of the same scripted window; also
 compare **painted-frame counts**, the crudest and most robust signal.

package/skills/peach-setup/SKILL.md

@@ -42,7 +42,8 @@ debugging or `/peach-test` for writing tests.
   daemon is down, the dev server port is wrong, or the runtime is missing.
   walk the recovery checklist before reinstalling.
 - **keep one sim for your whole session.** the first `peach open <port>`
-  launches Chrome for Testing with an isolated profile. later opens reuse the
+  launches the simulator window: the native desktop app on Apple silicon macOS
+  and Linux x64, otherwise Chrome for Testing with an isolated profile. later opens reuse the
   saved sim and navigate it in place. use `peach do reload` when the target
   has not changed:
 
@@ -74,27 +75,23 @@ debugging or `/peach-test` for writing tests.
   saved sim to reuse. verify the development server and Peach runtime, then
   retry once after fixing the cause.
 
-## choose the runtime
+## the simulator window
 
-on Apple silicon macOS and Linux x64, recommend trying the optional native
-runtime for faster simulation. it is beta, so the user may run into more issues
-than in the browser. keep the current default unless the user chooses native:
+on Apple silicon macOS and Linux x64, `peach open` shows the app in the native
+desktop app, which is faster than the browser. setup installs it, and on a Mac
+the first `peach open` installs it if it is missing. do not pass a driver flag
+for the user's own viewing.
 
-```sh
-peach desktop install
-peach open 8081 --driver desktop
-```
-
-use the app's actual development server port. the Linux desktop app needs a
-desktop session; its `.deb` installer uses `sudo apt-get install`.
-`peach desktop install --native` on Linux installs the standalone headless host
-instead of the desktop app. Intel Mac and Linux arm64 use the browser.
-`peach open 8081 --driver playwright --headed` explicitly opens a browser window.
-pass the selected driver when opening the app in the steps below; installing
-the desktop app alone does not change the saved window preference.
+the Linux desktop app needs a desktop session; its `.deb` installer uses
+`sudo apt-get install`. `peach desktop install --native` on Linux installs the
+standalone headless host instead of the desktop app. Intel Mac and Linux arm64
+use the browser. `peach open 8081 --driver playwright --headed` explicitly opens
+a browser window. a yellow "GPU disabled" item in the browser simulator's menu
+bar means it is drawing without a GPU and will be slow; move the user to the
+desktop app.
 
-the native runtime renders the simulator. the background service below keeps
-the bridge ready for either runtime and is a separate optional choice.
+the background service below keeps the bridge ready for either window and is a
+separate optional choice.
 
 ## first move
 

package/src/backend-origin.ts

@@ -98,12 +98,16 @@ export function isBrowserAssetProxyUrl(value: string): boolean {
   }
 }
 
+// the PeachSim app's host; the backend serves every path on it
+export const PEACHSIM_NATIVE_HOST = 'native.peachsim.com'
+
 export function isContrastBackendHost(hostname: string): boolean {
   const normalized = normalizeHostname(hostname)
   return (
     isLoopbackHost(normalized) ||
     normalized === 'contrast.dev' ||
-    normalized.endsWith('.contrast.dev')
+    normalized.endsWith('.contrast.dev') ||
+    normalized === PEACHSIM_NATIVE_HOST
   )
 }
 
@@ -115,15 +119,18 @@ export function isContrastBackendOrigin(origin: string): boolean {
   }
 }
 
-export function resolveContrastBackendOrigin(currentOrigin?: string | null): string {
-  const origin = currentOrigin?.trim()
+// a page's `?backend=` names another backend origin, judged by the same rule
+export function resolveContrastBackendOrigin(
+  currentOrigin?: string | null,
+  search?: string | null,
+): string {
+  const origin =
+    new URLSearchParams(search ?? '').get('backend')?.trim() || currentOrigin?.trim()
   if (!origin) return DEFAULT_CONTRAST_BACKEND_ORIGIN
 
   try {
     const parsed = new URL(origin)
-    if (isLoopbackHost(parsed.hostname) || isContrastBackendHost(parsed.hostname)) {
-      return parsed.origin
-    }
+    if (isContrastBackendHost(parsed.hostname)) return parsed.origin
   } catch {}
 
   return DEFAULT_CONTRAST_BACKEND_ORIGIN

package/src/bridge-constants.ts

@@ -6,6 +6,17 @@ import { PEACH_SIMULATOR_PATH } from './simulator-route'
 export const DEFAULT_SOOTSIM_BRIDGE_PORT = 7668
 export const DEFAULT_SOOTSIM_BRIDGE_URL = `http://localhost:${DEFAULT_SOOTSIM_BRIDGE_PORT}/`
 
+export function assertPeachPortEnvironment(env: Record<string, unknown>): void {
+  for (const [removed, replacement] of [
+    ['SOOTSIM_SHELL_PORT', 'PEACH_SHELL_PORT'],
+    ['SOOTSIM_BRIDGE_PORT', 'PEACH_BRIDGE_PORT'],
+  ] satisfies [string, string][]) {
+    if (env[removed] !== undefined) {
+      throw new Error(`${removed} has been removed; unset it and use ${replacement}`)
+    }
+  }
+}
+
 function parsePort(value: unknown): number | null {
   if (typeof value === 'number') {
     return Number.isInteger(value) && value > 0 ? value : null

package/src/bridge-contract.ts

@@ -385,39 +385,29 @@ export const SEMANTIC_READY_POLL_MS = 150
 
 export const HEADLESS_TENANT_FETCH_HUNG_MARKER = 'headless tenant fetch hung'
 
-export function readyProbeHasContent(
-  probe: Pick<SemanticReadyProbe, 'nodes' | 'targets'> &
-    Partial<
-      Pick<
-        SemanticReadyProbe,
-        'liveFrameActive' | 'browserSurfaceCount' | 'paintedAppContent'
-      >
-    >,
-): boolean {
-  return (
-    probe.paintedAppContent === true ||
-    (probe.browserSurfaceCount ?? 0) > 0 ||
-    probe.liveFrameActive ||
-    probe.targets > 0 ||
-    probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR
-  )
+type ReadyContentProbe = Pick<SemanticReadyProbe, 'nodes' | 'targets'> &
+  Partial<
+    Pick<
+      SemanticReadyProbe,
+      'liveFrameActive' | 'browserSurfaceCount' | 'paintedAppContent' | 'flag'
+    >
+  >
+
+// the first content condition a probe satisfies. a probe without the ready
+// flag counts only targeted content, never the node floor. empty when the
+// probe has none.
+export function readyProbeContentBasis(probe: ReadyContentProbe): string {
+  if (probe.paintedAppContent === true) return 'paintedAppContent'
+  if ((probe.browserSurfaceCount ?? 0) > 0) return 'browserSurface'
+  if (probe.liveFrameActive) return 'liveFrame'
+  if (probe.targets > 0) return 'targets'
+  if (probe.flag === true && probe.nodes >= SEMANTIC_READY_CONTENT_NODE_FLOOR)
+    return 'nodeFloor'
+  return ''
 }
 
-export function readyProbeHasTargetContent(
-  probe: Pick<SemanticReadyProbe, 'targets'> &
-    Partial<
-      Pick<
-        SemanticReadyProbe,
-        'liveFrameActive' | 'browserSurfaceCount' | 'paintedAppContent'
-      >
-    >,
-): boolean {
-  return (
-    probe.paintedAppContent === true ||
-    (probe.browserSurfaceCount ?? 0) > 0 ||
-    probe.liveFrameActive ||
-    probe.targets > 0
-  )
+export function readyProbeHasContent(probe: ReadyContentProbe): boolean {
+  return readyProbeContentBasis({ ...probe, flag: true }) !== ''
 }
 
 // one probe shows a ready app: it has said so with content behind it, or it
@@ -426,9 +416,7 @@ export function readyProbeHasTargetContent(
 // already let the app settle judges a single probe with this alone.
 export function readyProbeIsReady(probe: SemanticReadyProbe): boolean {
   return (
-    (probe.flag === true
-      ? readyProbeHasContent(probe)
-      : readyProbeHasTargetContent(probe)) &&
+    readyProbeContentBasis(probe) !== '' &&
     probe.externalReady !== false &&
     !probe.externalError &&
     !probe.loadingText

package/src/config.ts

@@ -76,6 +76,8 @@ export interface PeachConfig<Settings extends Record<string, any> = Record<strin
   runtimeVersion?: string
   // native host identity. omission preserves the Fabric default.
   nativeRenderer?: NativeRenderer
+  // developer-owned browser token, restricted to the runtime's origin.
+  mapKit?: { token: string }
   modules?: Record<string, ModuleResolution>
   // native stubs keyed by the package they answer. the cli lowers these, with
   // installed stub packages, into the wire slots below before anything runs.
@@ -95,6 +97,9 @@ export interface PeachConfig<Settings extends Record<string, any> = Record<strin
     remap?: Record<string, string>
   }
   settings?: Partial<Settings>
+  // the properties a native host hands the root component at launch, the
+  // initialProperties of RCTRootView / runApplication's initialProps.
+  initialProps?: Record<string, unknown>
   initialState?: {
     authenticated?: boolean
     locale?: string
@@ -131,6 +136,11 @@ export function isPeachConfig<Settings extends Record<string, any> = Record<stri
     (value.nativeRenderer === undefined ||
       value.nativeRenderer === 'paper' ||
       value.nativeRenderer === 'fabric') &&
+    (value.mapKit === undefined ||
+      (isRecord(value.mapKit) &&
+        typeof value.mapKit.token === 'string' &&
+        value.mapKit.token.length > 0 &&
+        value.mapKit.token === value.mapKit.token.trim())) &&
     (value.runtimeVersion === undefined ||
       (typeof value.runtimeVersion === 'string' &&
         value.runtimeVersion === value.runtimeVersion.trim() &&
@@ -144,6 +154,7 @@ export function isPeachConfig<Settings extends Record<string, any> = Record<stri
       'env',
       'network',
       'settings',
+      'initialProps',
       'initialState',
     ].every((key) => value[key] === undefined || isRecord(value[key])) &&
     (value.packages === undefined ||
@@ -232,6 +243,7 @@ export function hasPeachConfig<
   if (!config) return false
   return (
     config.nativeRenderer !== undefined ||
+    config.mapKit !== undefined ||
     (typeof config.runtimeVersion === 'string' && config.runtimeVersion.length > 0) ||
     hasOwnKeys(config.modules as Record<string, unknown> | undefined) ||
     hasOwnKeys(config.turboModules as Record<string, unknown> | undefined) ||
@@ -240,6 +252,7 @@ export function hasPeachConfig<
     hasOwnKeys(config.env as Record<string, unknown> | undefined) ||
     hasOwnKeys(config.network?.remap as Record<string, unknown> | undefined) ||
     hasOwnKeys(config.settings as Record<string, unknown> | undefined) ||
+    hasOwnKeys(config.initialProps) ||
     hasOwnKeys(config.initialState as Record<string, unknown> | undefined)
   )
 }
@@ -257,6 +270,7 @@ export function mergePeachConfig<
   return {
     runtimeVersion: override.runtimeVersion ?? base.runtimeVersion,
     nativeRenderer: override.nativeRenderer ?? base.nativeRenderer,
+    mapKit: override.mapKit ?? base.mapKit,
     modules: { ...(base.modules || {}), ...(override.modules || {}) },
     turboModules: { ...(base.turboModules || {}), ...(override.turboModules || {}) },
     nativeModules: {
@@ -272,6 +286,7 @@ export function mergePeachConfig<
       ...(base.settings || {}),
       ...(override.settings || {}),
     } as Partial<Settings>,
+    initialProps: { ...(base.initialProps || {}), ...(override.initialProps || {}) },
     initialState: { ...(base.initialState || {}), ...(override.initialState || {}) },
   }
 }

package/src/desktop-host-delivery.ts

@@ -229,9 +229,13 @@ export function headlessHostCommand(): string[] | null {
     if (!fs.existsSync(launcher) || !hostEntrySupportsAutomaticPort(host)) return null
     return [launcher, '--experimental-vm-modules', host]
   }
-  const version = placedHostVersion()
+  const pin = desktopHostDelivery().resolvePin()
+  if (pin && !/^\d+\.\d+$/.test(pin))
+    throw new Error(`invalid native host version '${pin}' (expected <build>.<attempt>)`)
+  const version = pin || placedHostVersion()
   if (!version) return null
   const dir = desktopHostDir(version)
+  if (!fs.existsSync(path.join(dir, desktopHostExecutable()))) return null
   // a placed host that predates the automatic-port bind upgrades like a missing one
   if (!hostEntrySupportsAutomaticPort(path.join(dir, 'node/host.mjs'))) return null
   return [

package/src/dev-bundle-resolution.ts

@@ -3,6 +3,7 @@ import {
   isLoopbackHost,
   LOOPBACK_PROBE_HOSTNAMES,
 } from './backend-origin'
+import { parseExpoManifestBody } from './expo-manifest-body'
 import {
   alignLoopbackBundleUrlWithProbe,
   METRO_BUNDLE_PATH,
@@ -223,7 +224,7 @@ async function probeExpoManifest(
 
   let manifest: unknown
   try {
-    manifest = JSON.parse(body)
+    manifest = parseExpoManifestBody(body)
   } catch {
     if (answered.headers.get('content-type')?.includes('json'))
       throw new Error(`Metro returned invalid manifest JSON at ${normalizedBaseUrl}/`)

package/src/expo-manifest-body.ts

@@ -0,0 +1,13 @@
+// an Expo packager serves its manifest as JSON, or as the multipart form body
+// Expo Updates defines (older CLIs always, whatever the request accepts) whose
+// `manifest` part carries the same JSON.
+export function parseExpoManifestBody(body: string) {
+  const opening = /^(--[^\r\n]+)\r?\n/.exec(body)
+  if (!opening) return JSON.parse(body)
+  for (const part of body.split(opening[1])) {
+    const headerEnd = part.search(/\r?\n\r?\n/)
+    if (headerEnd < 0 || !/\bname="manifest"/.test(part.slice(0, headerEnd))) continue
+    return JSON.parse(part.slice(headerEnd).trim())
+  }
+  throw new Error('Expo manifest response has no manifest part')
+}