peachsim 0.1.637 → 0.1.639

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! rnx v0.1.637 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
+/*! rnx v0.1.639 | (c) 2026 Tamagui LLC | Proprietary — see LICENSE */
 let __sootsim_import_meta_url = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; } catch {}
 "use strict";
 var __create = Object.create;
@@ -801,8 +801,16 @@ function streamFile(res, stream) {
   stream.pipe(res);
 }
 
-// src/vite-plugin-one.ts
+// src/swift-submit.ts
+var SWIFT_PACKAGE_PATH = "/__peach/swift-package/";
 var SWIFT_HMR_PATH = "/__peach/swift-hmr";
+var MAX_SWIFT_COMPILE_SOURCE_BYTES = 2 * 1024 * 1024;
+var MAX_SWIFT_COMPILE_RESOURCE_BYTES = 2 * 1024 * 1024;
+var MAX_SWIFT_COMPILE_RESOURCE_TOTAL_BYTES = 8 * 1024 * 1024;
+var MAX_SWIFT_COMPILE_IMAGE_BYTES = 4 * 1024 * 1024;
+var MAX_SWIFT_COMPILE_IMAGE_TOTAL_BYTES = 16 * 1024 * 1024;
+
+// src/vite-plugin-one.ts
 var SWIFT_ROUTE_PREFIX = "/__peach/swift";
 var swiftHost;
 var loadSwiftHost = () => swiftHost ??= import("peachsim/vite-swift");
@@ -904,7 +912,8 @@ function rnxPlugin(options = {}) {
           if (!served) next();
         }).catch(next);
       });
-      server.watcher.on("change", (file) => {
+      server.watcher.on("all", (event, file) => {
+        if (event !== "add" && event !== "unlink" && event !== "change") return;
         if (activeSwiftPackages.size === 0) return;
         const moduleRoot = moduleRootFor();
         let packages;
@@ -952,7 +961,7 @@ function rnxPlugin(options = {}) {
         if (!pathname.startsWith(SWIFT_ROUTE_PREFIX)) return next();
         loadSwiftHost().then((host) => {
           if (host.serveSwiftPackageAsset(pathname, res)) return;
-          const prefix2 = "/__peach/swift-package/";
+          const prefix2 = SWIFT_PACKAGE_PATH;
           if (!pathname.startsWith(prefix2)) return next();
           if (!swiftSockets) {
             res.statusCode = 501;

package/package.json

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

package/skills/contrast/SKILL.md

@@ -19,6 +19,7 @@ automation, inspecting the render tree, and managing sims.
 
 | command | description |
 | --- | --- |
+| `peach swift` | preview a SwiftPM app with hosted compilation and live Swift edits |
 | `peach maestro` | author, generate, and run Maestro YAML flows against peach |
 | `peach detox` | run existing Detox suites against peach on headless Chromium |
 | `peach cleanup` | inspect and reclaim local peach disk usage |

package/src/assetCatalogContract.ts

@@ -0,0 +1,16 @@
+// the asset data exchanged by project hosts and the private renderer.
+export interface SwiftImageSource {
+  uri: string
+  scale: number
+}
+
+// an app catalog color resolves by appearance or names a system color.
+export type AppCatalogColor = { light: string; dark: string } | { system: string }
+
+export interface SfSymbolVector {
+  viewBox: '0 0 24 24'
+  advance: number
+  box?: readonly [number, number, number, number]
+  controlBoxes?: Record<string, readonly [number, number, number]>
+  layers: readonly { d: string; color?: string }[]
+}

package/src/bridge-contract-input.ts

@@ -1,4 +1,5 @@
 import { SIM_LONG_PRESS_MAX_MS } from './bridge-contract'
+import { isRecord } from './is-record'
 // untrusted JSON -> bridge-contract argument. one owner for that conversion, so
 // every transport in front of a sim (the Peach Cloud sim service's HTTP and
 // WebSocket routes) validates its request bodies here rather than growing a
@@ -13,7 +14,6 @@ import type {
 } from './bridge-contract'
 import type { SimPerformStep, SimScreenshotOptions } from './sim-client'
 import type { SootSimReplayTarget } from '@peach/globals'
-import { isRecord } from './is-record'
 
 /** the caller sent a value this bridge argument cannot be read from. */
 export class BridgeInputError extends Error {
@@ -371,6 +371,7 @@ export function parseSemanticQuery(value: unknown): SimSemanticQuery {
   const query = recordValue(value, 'query')
   const kind = stringValue(query.kind, 'query.kind')
   if (kind === 'count') return { kind }
+  if (kind === 'accessibility') return { kind }
   if (kind === 'tree') {
     const depth = optionalNumber(query, 'depth', 'query')
     return { kind, ...(depth === undefined ? {} : { depth }) }
@@ -378,7 +379,7 @@ export function parseSemanticQuery(value: unknown): SimSemanticQuery {
   if (kind === 'find') {
     return { kind, selector: parseSemanticSelector(query.selector, 'query.selector') }
   }
-  return validationFailure('query.kind', 'must be tree, find, or count')
+  return validationFailure('query.kind', 'must be tree, find, count, or accessibility')
 }
 
 function semanticResolveSelector(

package/src/bridge-contract.ts

@@ -9,6 +9,7 @@
 // this is the direction that ships.
 
 import type {
+  PeachAccessibilityNode,
   SootSimAgentActionDetail,
   SootSimCaptureFilter,
   SootSimExternalAppLifecycleOptions,
@@ -489,10 +490,17 @@ export type SimSemanticQuery =
   | { kind: 'tree'; depth?: number }
   | { kind: 'find'; selector: SimSemanticSelector }
   | { kind: 'count' }
+  // the XCTest accessibility projection. it is not a SimSemanticNode tree, so
+  // the snapshot rides in `accessibility` and `nodes` stays empty.
+  | { kind: 'accessibility' }
 
 export interface SimSemanticQueryResult {
   nodes: SimSemanticNode[]
   total: number
+  // present only for { kind: 'accessibility' }: the engine's recursive
+  // accessibility snapshot (PeachAccessibilityNode), the same tree the
+  // Maestro structural selectors resolve against.
+  accessibility?: PeachAccessibilityNode[]
 }
 
 export type SimSemanticResolveSelector = { testID: string } | { text: string }

package/src/host/bridge-host.ts

@@ -229,6 +229,8 @@ interface BridgeForwardedCommand {
 export interface BridgeHostOptions {
   /** use 0 for an OS-assigned port; startAsync returns the bound address. */
   port?: number
+  /** listener address; defaults to 127.0.0.1. */
+  host?: string
   openUrl?: (url: string, options?: OpenUrlOptions) => Promise<void> | void
   /** Contrast-specific excludes for the agent host's dev-server scan. passed
    *  through to AgentHost; see packages/peach-engine/src/dev-scan-excludes.ts
@@ -404,6 +406,7 @@ export class SootSimBridgeHost {
   // of reconnecting the zombie straight back in.
   private static SIM_IDLE_REAP_TTL_MS = 30 * 60_000
 
+  private bindHost: string
   private preferredPort: number
   private portFallbackCount: number
   private shouldWriteLockfile: boolean
@@ -438,6 +441,7 @@ export class SootSimBridgeHost {
   private static SCAN_FRESH_MS = 2000
 
   constructor(opts: BridgeHostOptions = {}) {
+    this.bindHost = opts.host ?? '127.0.0.1'
     this.preferredPort = opts.port ?? DEFAULT_SOOTSIM_BRIDGE_PORT
     this.port = this.preferredPort
     // default off — callers that want the lockfile (peach serve) opt in.
@@ -533,11 +537,7 @@ export class SootSimBridgeHost {
       }
       server.once('error', onError)
 
-      // loopback-only bind. we listen on 127.0.0.1 explicitly because the
-      // daemon serves the active runtime's dist as plain static files —
-      // never expose that to LAN peers. tests + the electron renderer use
-      // 127.0.0.1 explicitly to avoid the localhost-vs-::1 DNS coinflip.
-      server.listen(port, '127.0.0.1', () => {
+      server.listen(port, this.bindHost, () => {
         if (settled) return
         const address = server.address()
         if (!address || typeof address === 'string') {

package/src/metro-runtime-source.ts

@@ -0,0 +1,15 @@
+// GENERATED by scripts/generate-runtime-source.ts — do not edit.
+// verbatim metro-runtime@0.84.4 sources, inlined so the worker never touches a filesystem.
+
+export const METRO_RUNTIME_VERSION = '0.84.4'
+
+// metro-runtime/src/polyfills/require.js — defines global.__d / __r / __c / __accept
+export const METRO_REQUIRE_POLYFILL =
+  '"use strict";\n\nglobal.__r = metroRequire;\nglobal[`${__METRO_GLOBAL_PREFIX__}__d`] = define;\nglobal.__c = clear;\nglobal.__registerSegment = registerSegment;\nvar modules = clear();\nconst EMPTY = {};\nconst CYCLE_DETECTED = {};\nconst { hasOwnProperty } = {};\nif (__DEV__) {\n  global.$RefreshReg$ = global.$RefreshReg$ ?? (() => {});\n  global.$RefreshSig$ = global.$RefreshSig$ ?? (() => (type) => type);\n}\nfunction clear() {\n  modules = new Map();\n  return modules;\n}\nif (__DEV__) {\n  var verboseNamesToModuleIds = new Map();\n  var getModuleIdForVerboseName = (verboseName) => {\n    const moduleId = verboseNamesToModuleIds.get(verboseName);\n    if (moduleId == null) {\n      throw new Error(`Unknown named module: "${verboseName}"`);\n    }\n    return moduleId;\n  };\n  var initializingModuleIds = [];\n}\nfunction define(factory, moduleId, dependencyMap) {\n  if (modules.has(moduleId)) {\n    if (__DEV__) {\n      const inverseDependencies = arguments[4];\n      if (inverseDependencies) {\n        global.__accept(moduleId, factory, dependencyMap, inverseDependencies);\n      }\n    }\n    return;\n  }\n  const mod = {\n    dependencyMap,\n    factory,\n    hasError: false,\n    importedAll: EMPTY,\n    importedDefault: EMPTY,\n    isInitialized: false,\n    publicModule: {\n      exports: {},\n    },\n  };\n  modules.set(moduleId, mod);\n  if (__DEV__) {\n    mod.hot = createHotReloadingObject();\n    const verboseName = arguments[3];\n    if (verboseName) {\n      mod.verboseName = verboseName;\n      verboseNamesToModuleIds.set(verboseName, moduleId);\n    }\n  }\n}\nfunction metroRequire(moduleId, maybeNameForDev) {\n  if (moduleId === null) {\n    if (__DEV__ && typeof maybeNameForDev === "string") {\n      throw new Error("Cannot find module \'" + maybeNameForDev + "\'");\n    }\n    throw new Error("Cannot find module");\n  }\n  if (__DEV__ && typeof moduleId === "string") {\n    const verboseName = moduleId;\n    moduleId = getModuleIdForVerboseName(verboseName);\n    console.warn(\n      `Requiring module "${verboseName}" by name is only supported for ` +\n        "debugging purposes and will BREAK IN PRODUCTION!",\n    );\n  }\n  const moduleIdReallyIsNumber = moduleId;\n  if (__DEV__) {\n    const initializingIndex = initializingModuleIds.indexOf(\n      moduleIdReallyIsNumber,\n    );\n    if (initializingIndex !== -1) {\n      const cycle = initializingModuleIds\n        .slice(initializingIndex)\n        .map((id) => modules.get(id)?.verboseName ?? "[unknown]");\n      if (shouldPrintRequireCycle(cycle)) {\n        cycle.push(cycle[0]);\n        console.warn(\n          `Require cycle: ${cycle.join(" -> ")}\\n\\n` +\n            "Require cycles are allowed, but can result in uninitialized values. " +\n            "Consider refactoring to remove the need for a cycle.",\n        );\n      }\n    }\n  }\n  const module = modules.get(moduleIdReallyIsNumber);\n  return module && module.isInitialized\n    ? module.publicModule.exports\n    : guardedLoadModule(moduleIdReallyIsNumber, module);\n}\nfunction shouldPrintRequireCycle(modules) {\n  const regExps =\n    global[__METRO_GLOBAL_PREFIX__ + "__requireCycleIgnorePatterns"];\n  if (!Array.isArray(regExps)) {\n    return true;\n  }\n  const isIgnored = (module) =>\n    module != null && regExps.some((regExp) => regExp.test(module));\n  return modules.every((module) => !isIgnored(module));\n}\nfunction metroImportDefault(moduleId) {\n  if (__DEV__ && typeof moduleId === "string") {\n    const verboseName = moduleId;\n    moduleId = getModuleIdForVerboseName(verboseName);\n  }\n  const moduleIdReallyIsNumber = moduleId;\n  const maybeInitializedModule = modules.get(moduleIdReallyIsNumber);\n  if (\n    maybeInitializedModule &&\n    maybeInitializedModule.importedDefault !== EMPTY\n  ) {\n    return maybeInitializedModule.importedDefault;\n  }\n  const exports = metroRequire(moduleIdReallyIsNumber);\n  const importedDefault =\n    exports && exports.__esModule ? exports.default : exports;\n  const initializedModule = modules.get(moduleIdReallyIsNumber);\n  return (initializedModule.importedDefault = importedDefault);\n}\nmetroRequire.importDefault = metroImportDefault;\nfunction metroImportAll(moduleId) {\n  if (__DEV__ && typeof moduleId === "string") {\n    const verboseName = moduleId;\n    moduleId = getModuleIdForVerboseName(verboseName);\n  }\n  const moduleIdReallyIsNumber = moduleId;\n  const maybeInitializedModule = modules.get(moduleIdReallyIsNumber);\n  if (maybeInitializedModule && maybeInitializedModule.importedAll !== EMPTY) {\n    return maybeInitializedModule.importedAll;\n  }\n  const exports = metroRequire(moduleIdReallyIsNumber);\n  let importedAll;\n  if (exports && exports.__esModule) {\n    importedAll = exports;\n  } else {\n    importedAll = {};\n    if (exports) {\n      for (const key in exports) {\n        if (hasOwnProperty.call(exports, key)) {\n          importedAll[key] = exports[key];\n        }\n      }\n    }\n    importedAll.default = exports;\n  }\n  const initializedModule = modules.get(moduleIdReallyIsNumber);\n  return (initializedModule.importedAll = importedAll);\n}\nmetroRequire.importAll = metroImportAll;\nmetroRequire.context = function fallbackRequireContext() {\n  if (__DEV__) {\n    throw new Error(\n      "The experimental Metro feature `require.context` is not enabled in your project.\\nThis can be enabled by setting the `transformer.unstable_allowRequireContext` property to `true` in your Metro configuration.",\n    );\n  }\n  throw new Error(\n    "The experimental Metro feature `require.context` is not enabled in your project.",\n  );\n};\nmetroRequire.resolveWeak = function fallbackRequireResolveWeak() {\n  if (__DEV__) {\n    throw new Error(\n      "require.resolveWeak cannot be called dynamically. Ensure you are using the same version of `metro` and `metro-runtime`.",\n    );\n  }\n  throw new Error("require.resolveWeak cannot be called dynamically.");\n};\nlet inGuard = false;\nfunction guardedLoadModule(moduleId, module) {\n  if (!inGuard && global.ErrorUtils) {\n    inGuard = true;\n    let returnValue;\n    try {\n      returnValue = loadModuleImplementation(moduleId, module);\n    } catch (e) {\n      global.ErrorUtils.reportFatalError(e);\n    }\n    inGuard = false;\n    return returnValue;\n  } else {\n    return loadModuleImplementation(moduleId, module);\n  }\n}\nconst ID_MASK_SHIFT = 16;\nconst LOCAL_ID_MASK = ~0 >>> ID_MASK_SHIFT;\nfunction unpackModuleId(moduleId) {\n  const segmentId = moduleId >>> ID_MASK_SHIFT;\n  const localId = moduleId & LOCAL_ID_MASK;\n  return {\n    segmentId,\n    localId,\n  };\n}\nmetroRequire.unpackModuleId = unpackModuleId;\nfunction packModuleId(value) {\n  return (value.segmentId << ID_MASK_SHIFT) + value.localId;\n}\nmetroRequire.packModuleId = packModuleId;\nconst moduleDefinersBySegmentID = [];\nconst definingSegmentByModuleID = new Map();\nfunction registerSegment(segmentId, moduleDefiner, moduleIds) {\n  moduleDefinersBySegmentID[segmentId] = moduleDefiner;\n  if (__DEV__) {\n    if (segmentId === 0 && moduleIds) {\n      throw new Error(\n        "registerSegment: Expected moduleIds to be null for main segment",\n      );\n    }\n    if (segmentId !== 0 && !moduleIds) {\n      throw new Error(\n        "registerSegment: Expected moduleIds to be passed for segment #" +\n          segmentId,\n      );\n    }\n  }\n  if (moduleIds) {\n    moduleIds.forEach((moduleId) => {\n      if (!modules.has(moduleId) && !definingSegmentByModuleID.has(moduleId)) {\n        definingSegmentByModuleID.set(moduleId, segmentId);\n      }\n    });\n  }\n}\nfunction loadModuleImplementation(moduleId, module) {\n  if (!module && moduleDefinersBySegmentID.length > 0) {\n    const segmentId = definingSegmentByModuleID.get(moduleId) ?? 0;\n    const definer = moduleDefinersBySegmentID[segmentId];\n    if (definer != null) {\n      definer(moduleId);\n      module = modules.get(moduleId);\n      definingSegmentByModuleID.delete(moduleId);\n    }\n  }\n  const nativeRequire = global.nativeRequire;\n  if (!module && nativeRequire) {\n    const { segmentId, localId } = unpackModuleId(moduleId);\n    nativeRequire(localId, segmentId);\n    module = modules.get(moduleId);\n  }\n  if (!module) {\n    throw unknownModuleError(moduleId);\n  }\n  if (module.hasError) {\n    throw module.error;\n  }\n  if (__DEV__) {\n    var Systrace = requireSystrace();\n    var Refresh = requireRefresh();\n  }\n  module.isInitialized = true;\n  const { factory, dependencyMap } = module;\n  if (__DEV__) {\n    initializingModuleIds.push(moduleId);\n  }\n  try {\n    if (__DEV__) {\n      Systrace.beginEvent("JS_require_" + (module.verboseName || moduleId));\n    }\n    const moduleObject = module.publicModule;\n    if (__DEV__) {\n      moduleObject.hot = module.hot;\n      var prevRefreshReg = global.$RefreshReg$;\n      var prevRefreshSig = global.$RefreshSig$;\n      if (Refresh != null) {\n        const RefreshRuntime = Refresh;\n        global.$RefreshReg$ = (type, id) => {\n          const prefixedModuleId =\n            __METRO_GLOBAL_PREFIX__ + " " + moduleId + " " + id;\n          RefreshRuntime.register(type, prefixedModuleId);\n        };\n        global.$RefreshSig$ =\n          RefreshRuntime.createSignatureFunctionForTransform;\n      }\n    }\n    moduleObject.id = moduleId;\n    factory(\n      global,\n      metroRequire,\n      metroImportDefault,\n      metroImportAll,\n      moduleObject,\n      moduleObject.exports,\n      dependencyMap,\n    );\n    if (!__DEV__) {\n      module.factory = undefined;\n      module.dependencyMap = undefined;\n    }\n    if (__DEV__) {\n      Systrace.endEvent();\n      if (Refresh != null) {\n        const prefixedModuleId = __METRO_GLOBAL_PREFIX__ + " " + moduleId;\n        registerExportsForReactRefresh(\n          Refresh,\n          moduleObject.exports,\n          prefixedModuleId,\n        );\n      }\n    }\n    return moduleObject.exports;\n  } catch (e) {\n    module.hasError = true;\n    module.error = e;\n    module.isInitialized = false;\n    module.publicModule.exports = undefined;\n    throw e;\n  } finally {\n    if (__DEV__) {\n      if (initializingModuleIds.pop() !== moduleId) {\n        throw new Error(\n          "initializingModuleIds is corrupt; something is terribly wrong",\n        );\n      }\n      global.$RefreshReg$ = prevRefreshReg;\n      global.$RefreshSig$ = prevRefreshSig;\n    }\n  }\n}\nfunction unknownModuleError(id) {\n  let message = \'Requiring unknown module "\' + id + \'".\';\n  if (__DEV__) {\n    message +=\n      " If you are sure the module exists, try restarting Metro. " +\n      "You may also want to run `yarn` or `npm install`.";\n  }\n  return Error(message);\n}\nif (__DEV__) {\n  metroRequire.Systrace = {\n    beginEvent: () => {},\n    endEvent: () => {},\n  };\n  metroRequire.getModules = () => {\n    return modules;\n  };\n  var createHotReloadingObject = function () {\n    const hot = {\n      _acceptCallback: null,\n      _disposeCallback: null,\n      _didAccept: false,\n      accept: (callback) => {\n        hot._didAccept = true;\n        hot._acceptCallback = callback;\n      },\n      dispose: (callback) => {\n        hot._disposeCallback = callback;\n      },\n    };\n    return hot;\n  };\n  let reactRefreshTimeout = null;\n  const metroHotUpdateModule = function (\n    id,\n    factory,\n    dependencyMap,\n    inverseDependencies,\n  ) {\n    const mod = modules.get(id);\n    if (!mod) {\n      if (factory) {\n        return;\n      }\n      throw unknownModuleError(id);\n    }\n    const forceFullRefreshPatterns =\n      global[__METRO_GLOBAL_PREFIX__ + "__unstable_forceFullRefreshPatterns"];\n    if (\n      forceFullRefreshPatterns != null &&\n      Array.isArray(forceFullRefreshPatterns) &&\n      mod.verboseName != null &&\n      forceFullRefreshPatterns.some((pattern) =>\n        pattern.test(mod.verboseName ?? ""),\n      )\n    ) {\n      performFullRefresh("Module matched unstable_forceFullRefreshPatterns", {\n        source: mod,\n      });\n      return;\n    }\n    if (!mod.hasError && !mod.isInitialized) {\n      mod.factory = factory;\n      mod.dependencyMap = dependencyMap;\n      return;\n    }\n    const Refresh = requireRefresh();\n    const refreshBoundaryIDs = new Set();\n    let didBailOut = false;\n    let updatedModuleIDs;\n    try {\n      updatedModuleIDs = topologicalSort(\n        [id],\n        (pendingID) => {\n          const pendingModule = modules.get(pendingID);\n          if (pendingModule == null) {\n            return [];\n          }\n          const pendingHot = pendingModule.hot;\n          if (pendingHot == null) {\n            throw new Error(\n              "[Refresh] Expected module.hot to always exist in DEV.",\n            );\n          }\n          let canAccept = pendingHot._didAccept;\n          if (!canAccept && Refresh != null) {\n            const isBoundary = isReactRefreshBoundary(\n              Refresh,\n              pendingModule.publicModule.exports,\n            );\n            if (isBoundary) {\n              canAccept = true;\n              refreshBoundaryIDs.add(pendingID);\n            }\n          }\n          if (canAccept) {\n            return [];\n          }\n          const parentIDs = inverseDependencies[pendingID];\n          if (parentIDs.length === 0) {\n            performFullRefresh("No root boundary", {\n              source: mod,\n              failed: pendingModule,\n            });\n            didBailOut = true;\n            return [];\n          }\n          return parentIDs;\n        },\n        () => didBailOut,\n      ).reverse();\n    } catch (e) {\n      if (e === CYCLE_DETECTED) {\n        performFullRefresh("Dependency cycle", {\n          source: mod,\n        });\n        return;\n      }\n      throw e;\n    }\n    if (didBailOut) {\n      return;\n    }\n    const seenModuleIDs = new Set();\n    for (let i = 0; i < updatedModuleIDs.length; i++) {\n      const updatedID = updatedModuleIDs[i];\n      if (seenModuleIDs.has(updatedID)) {\n        continue;\n      }\n      seenModuleIDs.add(updatedID);\n      const updatedMod = modules.get(updatedID);\n      if (updatedMod == null) {\n        throw new Error("[Refresh] Expected to find the updated module.");\n      }\n      const prevExports = updatedMod.publicModule.exports;\n      const didError = runUpdatedModule(\n        updatedID,\n        updatedID === id ? factory : undefined,\n        updatedID === id ? dependencyMap : undefined,\n      );\n      const nextExports = updatedMod.publicModule.exports;\n      if (didError) {\n        return;\n      }\n      if (refreshBoundaryIDs.has(updatedID)) {\n        const isNoLongerABoundary = !isReactRefreshBoundary(\n          Refresh,\n          nextExports,\n        );\n        const didInvalidate = shouldInvalidateReactRefreshBoundary(\n          Refresh,\n          prevExports,\n          nextExports,\n        );\n        if (isNoLongerABoundary || didInvalidate) {\n          const parentIDs = inverseDependencies[updatedID];\n          if (parentIDs.length === 0) {\n            performFullRefresh(\n              isNoLongerABoundary\n                ? "No longer a boundary"\n                : "Invalidated boundary",\n              {\n                source: mod,\n                failed: updatedMod,\n              },\n            );\n            return;\n          }\n          for (let j = 0; j < parentIDs.length; j++) {\n            const parentID = parentIDs[j];\n            const parentMod = modules.get(parentID);\n            if (parentMod == null) {\n              throw new Error("[Refresh] Expected to find parent module.");\n            }\n            const canAcceptParent = isReactRefreshBoundary(\n              Refresh,\n              parentMod.publicModule.exports,\n            );\n            if (canAcceptParent) {\n              refreshBoundaryIDs.add(parentID);\n              updatedModuleIDs.push(parentID);\n            } else {\n              performFullRefresh("Invalidated boundary", {\n                source: mod,\n                failed: parentMod,\n              });\n              return;\n            }\n          }\n        }\n      }\n    }\n    if (Refresh != null) {\n      if (reactRefreshTimeout == null) {\n        reactRefreshTimeout = setTimeout(() => {\n          reactRefreshTimeout = null;\n          Refresh.performReactRefresh();\n        }, 30);\n      }\n    }\n  };\n  const topologicalSort = function (roots, getEdges, earlyStop) {\n    const result = [];\n    const visited = new Set();\n    const stack = new Set();\n    function traverseDependentNodes(node) {\n      if (stack.has(node)) {\n        throw CYCLE_DETECTED;\n      }\n      if (visited.has(node)) {\n        return;\n      }\n      visited.add(node);\n      stack.add(node);\n      const dependentNodes = getEdges(node);\n      if (earlyStop(node)) {\n        stack.delete(node);\n        return;\n      }\n      dependentNodes.forEach((dependent) => {\n        traverseDependentNodes(dependent);\n      });\n      stack.delete(node);\n      result.push(node);\n    }\n    roots.forEach((root) => {\n      traverseDependentNodes(root);\n    });\n    return result;\n  };\n  const runUpdatedModule = function (id, factory, dependencyMap) {\n    const mod = modules.get(id);\n    if (mod == null) {\n      throw new Error("[Refresh] Expected to find the module.");\n    }\n    const { hot } = mod;\n    if (!hot) {\n      throw new Error("[Refresh] Expected module.hot to always exist in DEV.");\n    }\n    if (hot._disposeCallback) {\n      try {\n        hot._disposeCallback();\n      } catch (error) {\n        console.error(\n          `Error while calling dispose handler for module ${id}: `,\n          error,\n        );\n      }\n    }\n    if (factory) {\n      mod.factory = factory;\n    }\n    if (dependencyMap) {\n      mod.dependencyMap = dependencyMap;\n    }\n    mod.hasError = false;\n    mod.error = undefined;\n    mod.importedAll = EMPTY;\n    mod.importedDefault = EMPTY;\n    mod.isInitialized = false;\n    const prevExports = mod.publicModule.exports;\n    mod.publicModule.exports = {};\n    hot._didAccept = false;\n    hot._acceptCallback = null;\n    hot._disposeCallback = null;\n    metroRequire(id);\n    if (mod.hasError) {\n      mod.hasError = false;\n      mod.isInitialized = true;\n      mod.error = null;\n      mod.publicModule.exports = prevExports;\n      return true;\n    }\n    if (hot._acceptCallback) {\n      try {\n        hot._acceptCallback();\n      } catch (error) {\n        console.error(\n          `Error while calling accept handler for module ${id}: `,\n          error,\n        );\n      }\n    }\n    return false;\n  };\n  const performFullRefresh = (reason, modules) => {\n    if (\n      typeof window !== "undefined" &&\n      window.location != null &&\n      typeof window.location.reload === "function"\n    ) {\n      window.location.reload();\n    } else {\n      const Refresh = requireRefresh();\n      if (Refresh != null) {\n        const sourceName = modules.source?.verboseName ?? "unknown";\n        const failedName = modules.failed?.verboseName ?? "unknown";\n        Refresh.performFullRefresh(\n          `Fast Refresh - ${reason} <${sourceName}> <${failedName}>`,\n        );\n      } else {\n        console.warn("Could not reload the application after an edit.");\n      }\n    }\n  };\n  const isExportSafeToAccess = (moduleExports, key) => {\n    return (\n      moduleExports?.__esModule ||\n      Object.getOwnPropertyDescriptor(moduleExports, key)?.get == null\n    );\n  };\n  var isReactRefreshBoundary = function (Refresh, moduleExports) {\n    if (Refresh.isLikelyComponentType(moduleExports)) {\n      return true;\n    }\n    if (moduleExports == null || typeof moduleExports !== "object") {\n      return false;\n    }\n    let hasExports = false;\n    let areAllExportsComponents = true;\n    for (const key in moduleExports) {\n      hasExports = true;\n      if (key === "__esModule") {\n        continue;\n      } else if (!isExportSafeToAccess(moduleExports, key)) {\n        return false;\n      }\n      const exportValue = moduleExports[key];\n      if (!Refresh.isLikelyComponentType(exportValue)) {\n        areAllExportsComponents = false;\n      }\n    }\n    return hasExports && areAllExportsComponents;\n  };\n  var shouldInvalidateReactRefreshBoundary = (\n    Refresh,\n    prevExports,\n    nextExports,\n  ) => {\n    const prevSignature = getRefreshBoundarySignature(Refresh, prevExports);\n    const nextSignature = getRefreshBoundarySignature(Refresh, nextExports);\n    if (prevSignature.length !== nextSignature.length) {\n      return true;\n    }\n    for (let i = 0; i < nextSignature.length; i++) {\n      if (prevSignature[i] !== nextSignature[i]) {\n        return true;\n      }\n    }\n    return false;\n  };\n  var getRefreshBoundarySignature = (Refresh, moduleExports) => {\n    const signature = [];\n    signature.push(Refresh.getFamilyByType(moduleExports));\n    if (moduleExports == null || typeof moduleExports !== "object") {\n      return signature;\n    }\n    for (const key in moduleExports) {\n      if (key === "__esModule") {\n        continue;\n      } else if (!isExportSafeToAccess(moduleExports, key)) {\n        continue;\n      }\n      const exportValue = moduleExports[key];\n      signature.push(key);\n      signature.push(Refresh.getFamilyByType(exportValue));\n    }\n    return signature;\n  };\n  var registerExportsForReactRefresh = (Refresh, moduleExports, moduleID) => {\n    Refresh.register(moduleExports, moduleID + " %exports%");\n    if (moduleExports == null || typeof moduleExports !== "object") {\n      return;\n    }\n    for (const key in moduleExports) {\n      if (!isExportSafeToAccess(moduleExports, key)) {\n        continue;\n      }\n      const exportValue = moduleExports[key];\n      const typeID = moduleID + " %exports% " + key;\n      Refresh.register(exportValue, typeID);\n    }\n  };\n  global.__accept = metroHotUpdateModule;\n}\nif (__DEV__) {\n  var requireSystrace = function requireSystrace() {\n    return (\n      global[__METRO_GLOBAL_PREFIX__ + "__SYSTRACE"] || metroRequire.Systrace\n    );\n  };\n  var requireRefresh = function requireRefresh() {\n    return (\n      global[__METRO_GLOBAL_PREFIX__ + "__ReactRefresh"] ||\n      global[global.__METRO_GLOBAL_PREFIX__ + "__ReactRefresh"] ||\n      metroRequire.Refresh\n    );\n  };\n}\n'
+
+// metro-runtime/src/modules/asyncRequire.js — the module import() compiles down to
+export const METRO_ASYNC_REQUIRE =
+  '"use strict";\n\nfunction maybeLoadBundle(moduleID, paths) {\n  const loadBundle = global[`${__METRO_GLOBAL_PREFIX__}__loadBundleAsync`];\n  if (loadBundle != null) {\n    const stringModuleID = String(moduleID);\n    if (paths != null) {\n      const bundlePath = paths[stringModuleID];\n      if (bundlePath != null) {\n        return loadBundle(bundlePath);\n      }\n    }\n  }\n  return undefined;\n}\nfunction asyncRequireImpl(moduleID, paths) {\n  const maybeLoadBundlePromise = maybeLoadBundle(moduleID, paths);\n  const importAll = () => require.importAll(moduleID);\n  if (maybeLoadBundlePromise != null) {\n    return maybeLoadBundlePromise.then(importAll);\n  }\n  return importAll();\n}\nasync function asyncRequire(moduleID, paths, moduleName) {\n  return asyncRequireImpl(moduleID, paths);\n}\nasyncRequire.unstable_importMaybeSync = function unstable_importMaybeSync(\n  moduleID,\n  paths,\n) {\n  return asyncRequireImpl(moduleID, paths);\n};\nasyncRequire.prefetch = function (moduleID, paths, moduleName) {\n  maybeLoadBundle(moduleID, paths)?.then(\n    () => {},\n    () => {},\n  );\n};\nmodule.exports = asyncRequire;\n'
+
+// metro-runtime/src/modules/empty-module.js — what a browser-field `false` redirect resolves to
+export const METRO_EMPTY_MODULE = '"use strict";\n'

package/src/native-seam-manifest.ts

@@ -153,15 +153,13 @@ export const NATIVE_SEAM_MANIFEST: NativeSeamEntry[] = [
   },
   {
     pkg: '@bam.tech/react-native-image-resizer',
-    // upstream is not shipped to most guest bundles via node_modules — it
-    // arrives through the bundle-loader stub-registry which routes the
-    // package entry to `stubs/bam-react-native-image-resizer.ts`. listed here
-    // for documentation parity; vite-path redirect would key on
-    // `NativeImageResizer`.
+    // a Metro bundle reaches the same seam through the ImageResizer
+    // TurboModule that `stubs/bam-react-native-image-resizer-register.ts`
+    // registers.
     seamBasenames: ['NativeImageResizer'],
     target: seamPath('bam-react-native-image-resizer'),
     notes:
-      'ImageResizer TurboModule — browser-side canvas resize implementing the iOS contain/cover/stretch + onlyScaleDown semantics from ios/ImageResizer.mm',
+      'ImageResizer TurboModule following ios/ImageResizer.mm: loader decode, rotation, scaling, and the file written to the app container',
   },
   {
     pkg: 'react-native-adjust',

package/src/swift-compile.ts

@@ -224,8 +224,8 @@ export function swiftArtifactHash(
   moduleRoot: string,
 ): string {
   const hash = createHash('sha256')
-  // v2: sources compile with os(iOS) true (swiftSourceAsIOS)
-  hash.update(`swift-compile/v2\n${release}\n`)
+  // v3: sources compile with os(iOS) true on code lines (swiftSourceAsIOS)
+  hash.update(`swift-compile/v3\n${release}\n`)
   if (input.oneModule) hash.update('one-module\n')
   hash.update(linkedModuleDigest(moduleRoot))
   for (const file of Object.keys(input.files).sort()) {
@@ -347,15 +347,111 @@ function syncSwiftTree(base: string, files: Map<string, string>): void {
 // every iOS branch of the app would compile out. a condition line names iOS
 // as `true` padded to the same length, so diagnostics keep their columns;
 // os(WASI) still holds for code written for wasm. only `#if` and `#elseif`
-// lines change, and the artifact hash stays over the original text.
-const CONDITION_LINE = /^([ \t]*#(?:if|elseif)\b)(.*)$/gm
+// lines that begin in code change: a line inside a string literal or a block
+// comment is content. the artifact hash stays over the original text.
+const DIRECTIVE = /^[ \t]*#(?:if|elseif)\b/
 const OS_IOS = /\bos\(\s*iOS\s*\)/g
 export function swiftSourceAsIOS(source: string): string {
-  return source.replace(
-    CONDITION_LINE,
-    (_, directive: string, condition: string) =>
-      directive + condition.replace(OS_IOS, (match) => 'true'.padEnd(match.length)),
-  )
+  const code = swiftCodeLineStarts(source)
+  let offset = 0
+  return source
+    .split('\n')
+    .map((line) => {
+      const start = offset
+      offset += line.length + 1
+      if (!code.has(start) || !DIRECTIVE.test(line)) return line
+      return line.replace(OS_IOS, (match) => 'true'.padEnd(match.length))
+    })
+    .join('\n')
+}
+
+// the offsets of the lines that begin in code, from a scan of Swift's lexical
+// contexts: nested block comments, line comments, string literals (single and
+// multiline, raw with any number of #, interpolations holding code and
+// strings of their own) and #/ /# regex literals. a bare /regex/ literal
+// reads as code.
+type Lexical =
+  | { kind: 'code'; parens: number }
+  | { kind: 'block'; depth: number }
+  | { kind: 'string'; hashes: number; multiline: boolean }
+  | { kind: 'regex'; hashes: number }
+function swiftCodeLineStarts(source: string): Set<number> {
+  const starts = new Set<number>()
+  const stack: Lexical[] = [{ kind: 'code', parens: 0 }]
+  const hashesAt = (at: number) => {
+    let end = at
+    while (source[end] === '#') end++
+    return end - at
+  }
+  const closes = (at: number, hashes: number) => source.startsWith('#'.repeat(hashes), at)
+  let i = 0
+  while (i < source.length) {
+    const top = stack[stack.length - 1]
+    if ((i === 0 || source[i - 1] === '\n') && top.kind === 'code' && stack.length === 1)
+      starts.add(i)
+    const char = source[i]
+    if (top.kind === 'block') {
+      if (source.startsWith('/*', i)) {
+        top.depth++
+        i += 2
+      } else if (source.startsWith('*/', i)) {
+        if (--top.depth === 0) stack.pop()
+        i += 2
+      } else i++
+      continue
+    }
+    if (top.kind === 'string') {
+      if (char === '\\' && closes(i + 1, top.hashes)) {
+        const after = i + 1 + top.hashes
+        if (source[after] === '(') {
+          stack.push({ kind: 'code', parens: 0 })
+          i = after + 1
+        } else i = after + 1
+        continue
+      }
+      const quote = top.multiline ? '"""' : '"'
+      if (source.startsWith(quote, i) && closes(i + quote.length, top.hashes)) {
+        stack.pop()
+        i += quote.length + top.hashes
+      } else i++
+      continue
+    }
+    if (top.kind === 'regex') {
+      if (char === '/' && closes(i + 1, top.hashes)) {
+        stack.pop()
+        i += 1 + top.hashes
+      } else i++
+      continue
+    }
+    if (source.startsWith('//', i)) {
+      const end = source.indexOf('\n', i)
+      i = end === -1 ? source.length : end
+    } else if (source.startsWith('/*', i)) {
+      stack.push({ kind: 'block', depth: 1 })
+      i += 2
+    } else if (char === '"' || char === '#') {
+      const hashes = hashesAt(i)
+      const at = i + hashes
+      if (source.startsWith('"""', at)) {
+        stack.push({ kind: 'string', hashes, multiline: true })
+        i = at + 3
+      } else if (source[at] === '"') {
+        stack.push({ kind: 'string', hashes, multiline: false })
+        i = at + 1
+      } else if (hashes > 0 && source[at] === '/') {
+        stack.push({ kind: 'regex', hashes })
+        i = at + 1
+      } else i = Math.max(at, i + 1)
+    } else if (char === '(') {
+      top.parens++
+      i++
+    } else if (char === ')') {
+      if (top.parens === 0 && stack.length > 1) stack.pop()
+      else top.parens--
+      i++
+    } else i++
+  }
+  return starts
 }
 
 const compiledSource = (file: string, contents: string) =>

package/src/swift-guest.ts

@@ -0,0 +1,51 @@
+// the built-in guest uses the existing Metro runtime and host module seam.
+// the author supplies Swift; this entry carries no engine or compiler code.
+import {
+  appendRNXMetroModuleIdentityFooter,
+  RNX_METRO_MODULE_IDENTITY_VERSION,
+} from './metro-production-bundle'
+import { METRO_REQUIRE_POLYFILL } from './metro-runtime-source'
+
+export function swiftGuestBundle(packageName: string): string {
+  const modules = [
+    {
+      name: 'peach-swift-entry.js',
+      code: `const { AppRegistry } = require(1)
+const { createSwiftPreviewEntry } = require(2)
+AppRegistry.registerComponent('PeachSwift', () => createSwiftPreviewEntry(${JSON.stringify(packageName)}))`,
+      deps: [1, 2],
+    },
+    {
+      name: 'react-native',
+      code: `module.exports = global.__contrastHostModules['react-native']`,
+      deps: [],
+    },
+    {
+      name: 'peachsim/swift',
+      code: `module.exports = global.__contrastHostModules['peachsim/swift']`,
+      deps: [],
+    },
+    {
+      name: 'react',
+      code: `module.exports = global.__contrastHostModules['react']`,
+      deps: [],
+    },
+  ]
+  const bundle = [
+    `var __METRO_GLOBAL_PREFIX__='';`,
+    `(function(global){${METRO_REQUIRE_POLYFILL}})(globalThis);`,
+    ...modules.map(
+      (module, id) =>
+        `__d(function(global,require,_importDefault,_importAll,module,exports,_dependencyMap){\n${module.code}\n},${id},${JSON.stringify(module.deps)},${JSON.stringify(module.name)});`,
+    ),
+    '__r(0);',
+  ].join('\n')
+  return appendRNXMetroModuleIdentityFooter(bundle, {
+    version: RNX_METRO_MODULE_IDENTITY_VERSION,
+    identitySource: 'contrast-bundler',
+    modulePaths: Object.fromEntries(modules.map((module, id) => [id, module.name])),
+    logicalSpecifiers: Object.fromEntries(
+      modules.flatMap((module, id) => (id === 0 ? [] : [[id, [module.name]]])),
+    ),
+  })
+}