peachsim 0.1.1635 → 0.1.1641

package/dist-lib/worklet-executable.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.1635 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1641 | (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.1635 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.1641 | (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/package.json

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

package/src/backend-origin.ts

@@ -29,6 +29,14 @@ export function isLoopbackHost(hostname: string): boolean {
   )
 }
 
+export function isLoopbackOrigin(origin: string): boolean {
+  try {
+    return isLoopbackHost(new URL(origin).hostname)
+  } catch {
+    return false
+  }
+}
+
 // a browser page may use a local peach bridge (its proxies, websocket,
 // settings and account routes) only when this machine served the page: a
 // loopback origin, or the bridge's own host when a tunnel or reverse proxy
@@ -98,12 +106,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 +127,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/expo-swift-host.ts

@@ -136,7 +136,10 @@ export async function collectExpoSwiftSources(
   let bytes = 0
   let fileCount = 0
   // native Expo resolves packages by name before generating its Apple provider.
-  for (const [, entry] of Object.entries(search).sort(([a], [b]) => a.localeCompare(b))) {
+  // the search result is keyed by that name; older autolinkers add no name field.
+  for (const [packageName, entry] of Object.entries(search).sort(([a], [b]) =>
+    a.localeCompare(b),
+  )) {
     if (!entry || typeof entry !== 'object')
       throw new Error('invalid Expo autolinking entry')
     const sourceRoot = Reflect.get(entry, 'path')
@@ -149,7 +152,7 @@ export async function collectExpoSwiftSources(
       (candidate) =>
         candidate &&
         typeof candidate === 'object' &&
-        Reflect.get(candidate, 'packageName') === Reflect.get(entry, 'name'),
+        Reflect.get(candidate, 'packageName') === packageName,
     )
     const namespaces =
       resolution && typeof resolution === 'object'

package/src/expoKotlinContract.ts

@@ -1,4 +1,5 @@
 import { insertBundleGlobalFooter, readBundleGlobalFooter } from './bundleGlobalFooter'
+import { isRecord } from './is-record'
 
 // what the dev server answers for an app's local Expo Kotlin modules on an
 // Android device: one linked Kotlin/Wasm process, or each module's diagnostic.
@@ -10,14 +11,10 @@ export interface ExpoKotlinCompilationResult {
   failures: { namespace: string; diagnostic: string }[]
 }
 
-function record(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === 'object' && !Array.isArray(value)
-}
-
 export function readExpoKotlinMetadata(value: unknown): ExpoKotlinCompilationResult {
   const invalid = () => new Error('invalid Expo Kotlin compilation metadata')
   if (
-    !record(value) ||
+    !isRecord(value) ||
     !Array.isArray(value.namespaces) ||
     !Array.isArray(value.failures)
   )
@@ -30,7 +27,7 @@ export function readExpoKotlinMetadata(value: unknown): ExpoKotlinCompilationRes
   const failures: ExpoKotlinCompilationResult['failures'] = []
   for (const failure of value.failures) {
     if (
-      !record(failure) ||
+      !isRecord(failure) ||
       typeof failure.namespace !== 'string' ||
       typeof failure.diagnostic !== 'string'
     )
@@ -40,7 +37,7 @@ export function readExpoKotlinMetadata(value: unknown): ExpoKotlinCompilationRes
   const module = value.module
   if (module === null) return { namespaces, module: null, failures }
   if (
-    !record(module) ||
+    !isRecord(module) ||
     typeof module.url !== 'string' ||
     typeof module.hash !== 'string' ||
     typeof module.compose !== 'boolean'

package/src/expoSwiftContract.ts

@@ -1,4 +1,5 @@
 import { insertBundleGlobalFooter, readBundleGlobalFooter } from './bundleGlobalFooter'
+import { isRecord } from './is-record'
 
 export interface ExpoSwiftPreparationOptions {
   signal?: AbortSignal
@@ -33,9 +34,6 @@ export interface ExpoSwiftCompilationResult {
   failures: { namespace: string; diagnostic: string }[]
 }
 
-function record(value: unknown): value is Record<string, unknown> {
-  return value !== null && typeof value === 'object' && !Array.isArray(value)
-}
 function strings(value: unknown): value is string[] {
   return Array.isArray(value) && value.every((item) => typeof item === 'string')
 }
@@ -44,7 +42,7 @@ export function isExpoSwiftCompilationResult(
   value: unknown,
 ): value is ExpoSwiftCompilationResult {
   if (
-    !record(value) ||
+    !isRecord(value) ||
     !strings(value.namespaces) ||
     !Array.isArray(value.modules) ||
     value.modules.length > 1 ||
@@ -62,7 +60,7 @@ export function isExpoSwiftCompilationResult(
     return false
   for (const artifact of value.modules) {
     if (
-      !record(artifact) ||
+      !isRecord(artifact) ||
       !strings(artifact.namespaces) ||
       artifact.namespaces.length === 0 ||
       !artifact.namespaces.every((namespace) => remaining.delete(namespace)) ||
@@ -75,7 +73,7 @@ export function isExpoSwiftCompilationResult(
   }
   for (const failure of value.failures) {
     if (
-      !record(failure) ||
+      !isRecord(failure) ||
       typeof failure.namespace !== 'string' ||
       !remaining.delete(failure.namespace) ||
       typeof failure.diagnostic !== 'string'

package/src/host/staged-host-files.ts

@@ -95,6 +95,15 @@ export async function handleStagedHostFileRequest(
     res.end('staged file not found')
     return
   }
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204, {
+      'Access-Control-Allow-Methods': 'GET, HEAD',
+      'Access-Control-Allow-Headers':
+        req.headers['access-control-request-headers'] ?? '*',
+    })
+    res.end()
+    return
+  }
   if (req.method !== 'GET' && req.method !== 'HEAD') {
     res.writeHead(405, { Allow: 'GET, HEAD' })
     res.end('method not allowed')

package/src/native-app-identity-project.ts

@@ -2,6 +2,7 @@ import fs from 'node:fs'
 import { createRequire } from 'node:module'
 import path from 'node:path'
 import { androidMergedResourceValuesDirectory } from './android-app-identity'
+import { isRecord } from './is-record'
 import {
   extractNativeAppIdentityFromFiles,
   type NativeAppIdentity,
@@ -17,10 +18,6 @@ import {
   type XcodeAppTarget,
 } from './xcode-project'
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value)
-}
-
 function nonEmptyString(value: unknown): string | undefined {
   return typeof value === 'string' && value.length > 0 ? value : undefined
 }

package/src/native-app-identity.ts

@@ -10,6 +10,7 @@
 
 import { nativeAppIdentityFromAndroidManifest } from './android-app-identity'
 import { findBundleFooter } from './bundleGlobalFooter'
+import { isRecord } from './is-record'
 import {
   resolveNativeAppIconArtwork,
   isNativeAppIconArtwork,
@@ -99,10 +100,6 @@ interface NativeAppIdentityGlobals {
   __sootsim_native_app_identity?: NativeAppIdentity | null
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value)
-}
-
 function nonEmptyString(value: unknown): string | null {
   return typeof value === 'string' && value.length > 0 ? value : null
 }

package/src/nativeAppIconContract.ts

@@ -1,14 +1,11 @@
 import { isSwiftImageVariants, type SwiftImageVariants } from './assetCatalogContract'
+import { isRecord } from './is-record'
 
 export interface NativeAppIconArtwork {
   primary?: SwiftImageVariants
   alternates: Record<string, SwiftImageVariants>
 }
 
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return typeof value === 'object' && value !== null && !Array.isArray(value)
-}
-
 export function isNativeAppIconArtwork(value: unknown): value is NativeAppIconArtwork {
   return (
     isRecord(value) &&

package/src/output-lock-stdio.ts

@@ -0,0 +1,36 @@
+import { fstatSync } from 'node:fs'
+import type { IOType, StdioOptions } from 'node:child_process'
+
+// lock identities name actual inherited descriptors, never paths to reopen.
+export function outputLockStdio(
+  standard: [IOType, IOType, IOType],
+  env: NodeJS.ProcessEnv = process.env,
+): StdioOptions {
+  const stdio: StdioOptions = [...standard]
+  for (const [key, value] of Object.entries(process.env)) {
+    if (key.startsWith('REMOTE_OUTPUT_LOCK_') && env[key] !== value)
+      throw new Error(`inherited output lock identity changed for ${key}`)
+  }
+  for (const [key, value] of Object.entries(env)) {
+    if (!key.startsWith('REMOTE_OUTPUT_LOCK_')) continue
+    const fd = Number(value)
+    if (
+      !/^REMOTE_OUTPUT_LOCK_[a-f0-9]{64}$/.test(key) ||
+      !value ||
+      !/^\d+$/.test(value) ||
+      !Number.isSafeInteger(fd) ||
+      fd < 3
+    )
+      throw new Error(`invalid inherited output lock descriptor for ${key}`)
+    try {
+      fstatSync(fd)
+    } catch (cause) {
+      throw new Error(`inherited output lock descriptor ${fd} unavailable for ${key}`, {
+        cause,
+      })
+    }
+    while (stdio.length <= fd) stdio.push('ignore')
+    stdio[fd] = fd
+  }
+  return stdio
+}

package/src/react-native-bridge-modules.ts

@@ -6,7 +6,11 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { swiftCodeMask, swiftSourceClosure } from './swift-compile'
-import { listXcodeAppTargets, readXcodeAppTarget } from './xcode-project'
+import {
+  findXcodeProject,
+  listXcodeAppTargets,
+  readXcodeAppTarget,
+} from './xcode-project'
 import type { ExpoSwiftSourceUnit } from './expoSwiftContract'
 
 interface MethodInfo {
@@ -312,9 +316,9 @@ function swiftClassFor(objcName: string, files: Record<string, string>): string
 export const BRIDGE_MODULE_FILE_PREFIX = '__peach_react_module_'
 
 /**
- * the app target's legacy bridge modules, one compile unit each, or null
- * when the app has no iOS project or registers none. a module the host
- * cannot provide is a unit with a diagnostic instead of files.
+ * the app and its framework targets' legacy bridge modules, one compile unit
+ * each, or null when the app has no iOS project or registers none. a module
+ * the host cannot provide is a unit with a diagnostic instead of files.
  */
 export function collectBridgeModuleSources(
   appRoot: string,
@@ -326,91 +330,115 @@ export function collectBridgeModuleSources(
   signal?.throwIfAborted()
   const iosRoot = path.join(appRoot, 'ios')
   if (!fs.existsSync(iosRoot)) return null
-  const projects = fs
-    .readdirSync(iosRoot, { withFileTypes: true })
-    .filter((entry) => entry.isDirectory() && entry.name.endsWith('.xcodeproj'))
-    .map((entry) => path.join(iosRoot, entry.name))
-  const targets = projects.flatMap((project) =>
-    listXcodeAppTargets(project, { requireSources: false }).map((name) => ({
-      project,
-      name,
-    })),
-  )
+  const projectRoot = fs.realpathSync(appRoot)
+  const project = findXcodeProject(iosRoot)
+  if (!project) return null
+  const targets = listXcodeAppTargets(project, { requireSources: false })
   // RCTRegisterModule runs in the one app binary; several targets are
   // several apps, and nothing here says which one this bundle runs in
   if (targets.length !== 1) return null
-  const app = readXcodeAppTarget(targets[0]!.project, targets[0]!.name, 'Release', {
+  const app = readXcodeAppTarget(project, targets[0]!, 'Release', {
     requireSources: false,
   })
-  const own = (file: string) =>
-    !file.split(path.sep).some((part) => part === 'Pods' || part === 'node_modules')
-  const objc = app.allSources.filter((file) => /\.mm?$/.test(file) && own(file))
-  if (objc.length === 0) return null
-  // headers declare the superclasses; they sit beside the sources that import them
-  const headers = [...new Set(objc.map((file) => path.dirname(file)))].flatMap((dir) =>
-    fs
-      .readdirSync(dir)
-      .filter((name) => name.endsWith('.h'))
-      .sort()
-      .map((name) => path.join(dir, name)),
-  )
-  const declarations = parseObjectiveCModules(
-    [...objc, ...headers].map((file) => ({ file, text: fs.readFileSync(file, 'utf8') })),
-  )
-  if (declarations.modules.length === 0) return null
-  const namespace = app.moduleName.replace(/[^A-Za-z0-9_]/g, '_')
-  const swiftFiles: Record<string, string> = {}
-  for (const file of app.sources.filter(own)) {
-    const relative = path.relative(iosRoot, file)
-    if (relative.startsWith('..') || path.isAbsolute(relative))
-      throw new Error(`${file}: app Swift source outside ${iosRoot}`)
-    swiftFiles[`Sources/${namespace}/${relative.split(path.sep).join('/')}`] =
-      `#sourceLocation(file: ${JSON.stringify(file)}, line: 1)\n${fs.readFileSync(file, 'utf8')}`
+  const own = (file: string) => {
+    const resolved = fs.realpathSync(file)
+    if (
+      [file, resolved].some((name) =>
+        name.split(path.sep).some((part) => part === 'Pods' || part === 'node_modules'),
+      )
+    )
+      return false
+    const relative = path.relative(projectRoot, resolved)
+    if (
+      relative === '..' ||
+      relative.startsWith(`..${path.sep}`) ||
+      path.isAbsolute(relative)
+    )
+      throw new Error(`${file}: app native source outside ${projectRoot}`)
+    return true
   }
   const units: ExpoSwiftSourceUnit[] = []
   const failures: { namespace: string; diagnostic: string }[] = []
-  const seen = new Set<string>()
-  for (const module of declarations.modules) {
+  // the reader owns dependency order and visits a shared framework only once.
+  // each target keeps its own Swift module identity and compilation settings.
+  for (const target of [...app.frameworks, app]) {
     signal?.throwIfAborted()
-    if (seen.has(module.className)) continue
-    seen.add(module.className)
-    const moduleId = `${namespace}.${module.className}`
-    const methods = declarations.methods.get(module.className) ?? []
-    const swiftClass = module.extern ? swiftClassFor(module.className, swiftFiles) : null
-    const unit: ExpoSwiftSourceUnit = {
-      namespace,
-      moduleId,
-      classes: [],
-      bridgeModules: [],
-      files: {},
-      frameworks: [],
-      swiftLanguageMode: app.languageMode,
+    const objc = [
+      ...new Set(
+        target.allSources
+          .filter((file) => /\.mm?$/.test(file) && own(file))
+          .map((file) => fs.realpathSync(file)),
+      ),
+    ]
+    if (objc.length === 0) continue
+    // headers declare the superclasses; they sit beside the sources that import them
+    const headers = [...new Set(objc.map((file) => path.dirname(file)))].flatMap((dir) =>
+      fs
+        .readdirSync(dir)
+        .filter((name) => name.endsWith('.h'))
+        .sort()
+        .map((name) => path.join(dir, name))
+        .filter(own),
+    )
+    const declarations = parseObjectiveCModules(
+      [...objc, ...headers].map((file) => ({
+        file,
+        text: fs.readFileSync(file, 'utf8'),
+      })),
+    )
+    if (declarations.modules.length === 0) continue
+    const namespace = target.moduleName.replace(/[^A-Za-z0-9_]/g, '_')
+    const swiftFiles: Record<string, string> = {}
+    for (const file of target.sources.filter(own)) {
+      const relative = path.relative(projectRoot, fs.realpathSync(file))
+      swiftFiles[`Sources/${namespace}/${relative.split(path.sep).join('/')}`] =
+        `#sourceLocation(file: ${JSON.stringify(file)}, line: 1)\n${fs.readFileSync(file, 'utf8')}`
     }
-    if (swiftClass) {
-      const register = `__peachReactModule_${module.className}`
-      unit.files = swiftSourceClosure(swiftFiles, [swiftClass])
-      unit.files[
-        `Sources/${namespace}/${BRIDGE_MODULE_FILE_PREFIX}${module.className}.swift`
-      ] =
-        `import React\n\n// ${module.file}: RCT_EXTERN_MODULE(${module.className})\npublic func ${register}() -> RCTModuleHost.Registration {\n  RCTModuleHost.Registration(className: ${swiftString(module.className)}, moduleName: ${swiftString(module.jsName)}, methods: ${methodsLiteral(methods)}, make: { ${swiftClass}() })\n}\n`
-      unit.bridgeModules = [`${namespace}.${register}()`]
-    } else {
-      const superclass = compiledSuperclass(module.className, declarations.superclasses)
-      const selectors = declarations.implementations.get(module.className)
-      if (!selectors || !superclass) {
-        failures.push({
-          namespace: moduleId,
-          diagnostic: !selectors
-            ? `${module.file}: no Swift class or Objective-C @implementation provides ${module.className}`
-            : `${module.file}: ${module.className}'s superclass ${declarations.superclasses.get(module.className) ?? '(none)'} is Objective-C, which Peach does not compile`,
-        })
-        continue
+    const seen = new Set<string>()
+    for (const module of declarations.modules) {
+      signal?.throwIfAborted()
+      if (seen.has(module.className)) continue
+      seen.add(module.className)
+      const moduleId = `${namespace}.${module.className}`
+      const methods = declarations.methods.get(module.className) ?? []
+      const swiftClass = module.extern
+        ? swiftClassFor(module.className, swiftFiles)
+        : null
+      const unit: ExpoSwiftSourceUnit = {
+        namespace,
+        moduleId,
+        classes: [],
+        bridgeModules: [],
+        files: {},
+        frameworks: [],
+        swiftLanguageMode: target.languageMode,
+      }
+      if (swiftClass) {
+        const register = `__peachReactModule_${module.className}`
+        unit.files = swiftSourceClosure(swiftFiles, [swiftClass])
+        unit.files[
+          `Sources/${namespace}/${BRIDGE_MODULE_FILE_PREFIX}${module.className}.swift`
+        ] =
+          `import React\n\n// ${module.file}: RCT_EXTERN_MODULE(${module.className})\npublic func ${register}() -> RCTModuleHost.Registration {\n  RCTModuleHost.Registration(className: ${swiftString(module.className)}, moduleName: ${swiftString(module.jsName)}, methods: ${methodsLiteral(methods)}, make: { ${swiftClass}() })\n}\n`
+        unit.bridgeModules = [`${namespace}.${register}()`]
+      } else {
+        const superclass = compiledSuperclass(module.className, declarations.superclasses)
+        const selectors = declarations.implementations.get(module.className)
+        if (!selectors || !superclass) {
+          failures.push({
+            namespace: moduleId,
+            diagnostic: !selectors
+              ? `${module.file}: no Swift class or Objective-C @implementation provides ${module.className}`
+              : `${module.file}: ${module.className}'s superclass ${declarations.superclasses.get(module.className) ?? '(none)'} is Objective-C, which Peach does not compile`,
+          })
+          continue
+        }
+        unit.bridgeModules = [
+          `RCTModuleHost.Registration(className: ${swiftString(module.className)}, moduleName: ${swiftString(module.jsName)}, methods: ${methodsLiteral(methods)}, objectiveCSelectors: ${JSON.stringify([...selectors].sort())}, superclass: { ${superclass}() })`,
+        ]
       }
-      unit.bridgeModules = [
-        `RCTModuleHost.Registration(className: ${swiftString(module.className)}, moduleName: ${swiftString(module.jsName)}, methods: ${methodsLiteral(methods)}, objectiveCSelectors: ${JSON.stringify([...selectors].sort())}, superclass: { ${superclass}() })`,
-      ]
+      units.push(unit)
     }
-    units.push(unit)
   }
-  return { units, failures }
+  return units.length === 0 && failures.length === 0 ? null : { units, failures }
 }

package/src/react-native-host-modules.ts

@@ -43,7 +43,10 @@ export const REACT_NATIVE_PASSTHROUGH_SPECIFIERS: readonly string[] = [
 ]
 
 export function isReactNativePassthroughSpecifier(specifier: string): boolean {
+  // checked in place: every module of a bundle asks at boot
   return REACT_NATIVE_PASSTHROUGH_SPECIFIERS.some(
-    (passthrough) => specifier === passthrough || specifier.startsWith(`${passthrough}/`),
+    (passthrough) =>
+      specifier.startsWith(passthrough) &&
+      (specifier.length === passthrough.length || specifier[passthrough.length] === '/'),
   )
 }

package/src/settings-bundle.ts

@@ -1,5 +1,6 @@
 import { readFile, readdir, stat } from 'node:fs/promises'
 import { join } from 'node:path'
+import { isRecord } from './is-record'
 import { parsePlistSource } from './plist.ts'
 import type { AppPreferenceValue, AppSettingsSpecifier } from '@peach/globals'
 
@@ -22,10 +23,6 @@ interface CachedSettingsBundle {
 
 const settingsBundleCache = new Map<string, CachedSettingsBundle>()
 
-function isRecord(value: unknown): value is PlistRecord {
-  return typeof value === 'object' && value !== null && !Array.isArray(value)
-}
-
 function optionalString(value: unknown): string | undefined {
   return typeof value === 'string' ? value : undefined
 }