peachsim 0.1.2194 → 0.1.2195

package/dist-lib/swift-compile.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/swift-compile.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/swift-compile.ts
 import {

package/dist-lib/swift-package.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/swift-package.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/swift-package.ts
 function swiftManifestSettings(target) {

package/dist-lib/swift-submit.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/swift-submit.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/is-record.ts
 function isRecord(value) {

package/dist-lib/swift-toolchain.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __create = Object.create;

package/dist-lib/swift.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/vite-swift.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __create = Object.create;
@@ -30614,7 +30614,7 @@ function sourceClosureDigest(srcDir, entrypoints) {
   return hash.digest("hex");
 }
 var standinSourceDigest = (srcDir = __sootsim_import_meta_dirname) => sourceClosureDigest(srcDir, STANDIN_DIGEST_ENTRYPOINTS);
-var STANDIN_SOURCE_DIGEST = true ? "d9690faaeece4d15e4d1c3fd98fcb05d93d520f33afa9a5f18fdd043578ad02f" : standinSourceDigest();
+var STANDIN_SOURCE_DIGEST = true ? "afff2f6ba145885813b507114e72f9218f9a815a257ab2e44f7da376b7bf5cd1" : standinSourceDigest();
 
 // src/swift-standins.ts
 init_define_SWIFT_COVERAGE_SOURCE_DIGESTS();

package/dist-lib/vite.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __create = Object.create;
@@ -1909,7 +1909,7 @@ function readIosSdkTree(root) {
 
 // src/swift-standin-digest.ts
 init_define_SWIFT_COVERAGE_SOURCE_DIGESTS();
-var STANDIN_SOURCE_DIGEST = true ? "d9690faaeece4d15e4d1c3fd98fcb05d93d520f33afa9a5f18fdd043578ad02f" : standinSourceDigest();
+var STANDIN_SOURCE_DIGEST = true ? "afff2f6ba145885813b507114e72f9218f9a815a257ab2e44f7da376b7bf5cd1" : standinSourceDigest();
 
 // src/expo-native-workspace.ts
 init_define_SWIFT_COVERAGE_SOURCE_DIGESTS();

package/dist-lib/worklet-executable.cjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 let __sootsim_import_meta_url = '', __sootsim_import_meta_dirname = '', __sootsim_import_meta_filename = ''; try { __sootsim_import_meta_url = require('url').pathToFileURL(__filename).href; __sootsim_import_meta_dirname = __dirname; __sootsim_import_meta_filename = __filename; } catch {}
 "use strict";
 var __defProp = Object.defineProperty;

package/dist-lib/worklet-executable.mjs

@@ -1,4 +1,4 @@
-/*! peach v0.1.2194 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
+/*! peach v0.1.2195 | (c) 2026 Tamagui LLC | Proprietary; see LICENSE */
 
 // src/worklet-executable.ts
 import { parse } from "acorn";

package/dist-types/packages/peach-engine/src/engine/types.d.ts

@@ -445,6 +445,7 @@ export interface SootSimStyle {
     _lineLeading?: number;
     _lineAscent?: number;
     _uikitLabel?: true;
+    _uikitLabelCenteredShrink?: true;
     _textKitLeadingAbove?: true;
     _coreTextLine?: true;
     _textViewBlock?: true;

package/package.json

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

package/src/android-bridge-dependencies.ts

@@ -0,0 +1,93 @@
+import fs from 'node:fs'
+import path from 'node:path'
+import { resolveReactNativeAndroidAutolinking } from './android-autolinking'
+import { resolveAndroidGradleSources } from './android-gradle-sources'
+import { readJavaModuleSpecs } from './java-module-abi'
+import { installKotlinSdkArchive } from './kotlin-sdk'
+import { ensureToolchain, readToolchain } from './kotlin-toolchain'
+import type { BridgePackage, BridgeSelection } from './android-bridge-packages'
+
+export async function collectAndroidBridgeDependencies(
+  appRoot: string,
+  moduleRoot: string,
+): Promise<BridgeSelection | null> {
+  const root = path.join(appRoot, 'android')
+  if (!fs.existsSync(path.join(root, 'gradlew'))) return null
+  const dependencies = (await resolveReactNativeAndroidAutolinking(appRoot)).flatMap(
+    (dependency) =>
+      dependency.sourceDir === null || dependency.packageInstance === null
+        ? []
+        : [
+            {
+              ...dependency,
+              sourceDir: dependency.sourceDir,
+              packageInstance: dependency.packageInstance,
+            },
+          ],
+  )
+  if (dependencies.length === 0) return null
+  const models = await resolveAndroidGradleSources({
+    root,
+    projects: [
+      path.join(root, 'app'),
+      ...dependencies.map((dependency) => dependency.sourceDir),
+    ],
+    variant: 'debug',
+  })
+  const applicationId = models[0].applicationId
+  if (applicationId === null) throw new Error(`${root}/app is not an Android application`)
+  const toolchain = readToolchain(moduleRoot)
+  const [sdk, ready] = await Promise.all([
+    installKotlinSdkArchive(
+      fs.readFileSync(path.join(moduleRoot, 'sdk.tar.gz')),
+      toolchain.compiler.sha256,
+    ),
+    ensureToolchain(toolchain),
+  ])
+  const packages: BridgePackage[] = []
+  for (const dependency of dependencies) {
+    const model = models.find(
+      (entry) => entry.projectDir === fs.realpathSync(dependency.sourceDir),
+    )!
+    try {
+      const className = /^import\s+([\w.]+)\s*;$/.exec(
+        dependency.packageImportPath ?? '',
+      )?.[1]
+      const constructor = /^new\s+([\w.]+)\s*\(\s*\)$/.exec(
+        dependency.packageInstance,
+      )?.[1]
+      if (
+        !className ||
+        (constructor !== className && constructor !== className.split('.').pop())
+      )
+        throw new Error(
+          'native package registration requires a constructor without arguments',
+        )
+      const declarations = await readJavaModuleSpecs(model.java, sdk.root, ready)
+      const modules = declarations.specs.flatMap((spec) =>
+        spec.name === null
+          ? []
+          : [
+              {
+                className: spec.className,
+                name: spec.name,
+                methods: spec.methods,
+              },
+            ],
+      )
+      if (modules.length === 0) continue
+      packages.push({
+        className,
+        modules,
+        sources: model.kotlin,
+        javaSpecs: model.java,
+        unsupported: null,
+      })
+    } catch (error) {
+      console.error(
+        `[peach] ${dependency.name} native source is unavailable: ${error instanceof Error ? error.message : String(error)}`,
+      )
+    }
+  }
+  return packages.length ? { applicationId, packages } : null
+}

package/src/android-bridge-packages.ts

@@ -38,6 +38,7 @@ export interface BridgePackage {
   modules: BridgeModule[]
   // the app sources the package's classes need, its own first
   sources: string[]
+  javaSpecs?: string[]
   // why the package cannot be hosted
   unsupported: string | null
 }

package/src/android-gradle-sources.ts

@@ -7,6 +7,7 @@ import { PEACH_FORKED_SCRIPT_ENV } from './forked-script-contract'
 import { isRecord } from './is-record'
 import { kotlinHome } from './kotlin-toolchain'
 import type {
+  AndroidGradleDependency,
   AndroidGradleSourceRequest,
   AndroidGradleSources,
 } from './androidGradleContract'
@@ -15,8 +16,26 @@ const run = promisify(execFile)
 const modelQuery = `
 import groovy.json.JsonOutput
 import groovy.json.JsonSlurper
+import org.gradle.api.artifacts.FileCollectionDependency
+import org.gradle.api.artifacts.component.ModuleComponentIdentifier
+import org.gradle.api.artifacts.component.ProjectComponentIdentifier
+import org.gradle.api.artifacts.result.ResolvedDependencyResult
+import org.gradle.api.attributes.Category
 
 def request = new JsonSlurper().parseText(new String(Base64.decoder.decode('__PEACH_REQUEST__'), 'UTF-8'))
+def selectedVariants = [:]
+gradle.beforeProject { project ->
+    def directory = project.projectDir.canonicalPath
+    if (project.rootProject.projectDir.canonicalPath != request.root || !request.projects.contains(directory)) return
+    ['com.android.application', 'com.android.library'].each { plugin ->
+        project.pluginManager.withPlugin(plugin) {
+            def components = project.extensions.getByName('androidComponents')
+            components.onVariants(components.selector().withName(request.variant)) { variant ->
+                selectedVariants[directory] = variant
+            }
+        }
+    }
+}
 gradle.projectsEvaluated {
     if (gradle.rootProject.projectDir.canonicalPath != request.root) return
     def selected = []
@@ -31,19 +50,15 @@ gradle.projectsEvaluated {
         if (!library && !project.pluginManager.hasPlugin('com.android.application')) {
             throw new GradleException('Project has no Android application or library plugin: ' + project.path)
         }
-        def android = project.extensions.getByName('android')
-        def variants = library ? android.libraryVariants : android.applicationVariants
-        def variant = variants.find { it.name == request.variant }
+        def variant = selectedVariants[directory]
         if (variant == null) throw new GradleException('Android variant ' + request.variant + ' is absent: ' + project.path)
         def generators = []
-        def buildConfig = variant.generateBuildConfigProvider
-        if (buildConfig != null) generators.add(buildConfig)
         if (project.pluginManager.hasPlugin('com.facebook.react')) {
             generators.add(project.tasks.named('generateCodegenArtifactsFromSchema'))
         }
         def kotlin = project.tasks.findByName('compile' + variant.name.capitalize() + 'Kotlin')
         def kotlinSources = kotlin == null ? project.files() : kotlin.sources
-        def javaSources = variant.javaCompileProvider.get().source
+        def javaSources = project.tasks.named('compile' + variant.name.capitalize() + 'JavaWithJavac').get().source
         def query = project.tasks.register(request.task) {
             dependsOn(generators)
             dependsOn(kotlinSources.buildDependencies, javaSources.buildDependencies)
@@ -51,13 +66,31 @@ gradle.projectsEvaluated {
                 def files = (kotlinSources.files + javaSources.files).unique()
                 def unknown = files.find { !it.name.endsWith('.kt') && !it.name.endsWith('.java') }
                 if (unknown != null) throw new GradleException('Unsupported Android source: ' + unknown)
+                def dependencies = [variant.compileConfiguration, variant.runtimeConfiguration].collectMany { configuration ->
+                    def modules = configuration.incoming.resolutionResult.rootComponent.get().dependencies.findAll { !it.constraint }.collectMany { dependency ->
+                        if (!(dependency instanceof ResolvedDependencyResult)) throw new GradleException('Unresolved Android dependency: ' + dependency.requested, dependency.failure)
+                        def category = dependency.resolvedVariant.attributes.getAttribute(Category.CATEGORY_ATTRIBUTE)?.name
+                        if (category == Category.REGULAR_PLATFORM || category == Category.ENFORCED_PLATFORM) return []
+                        def id = dependency.selected.id
+                        if (id instanceof ModuleComponentIdentifier) return [[kind:'module', group:id.group, name:id.module, version:id.version]]
+                        if (id instanceof ProjectComponentIdentifier) return [[kind:'project', name:id.displayName]]
+                        throw new GradleException('Unsupported Android dependency component: ' + id.displayName)
+                    }
+                    def local = configuration.allDependencies.withType(FileCollectionDependency).collectMany { dependency ->
+                        dependency.files.files.collect { [kind:'file', name:it.absolutePath] }
+                    }
+                    modules + local
+                }.unique()
                 new File(request.output, index.toString() + '.json').text = JsonOutput.toJson([
                     projectDir:project.projectDir.canonicalPath,
                     projectPath:project.path,
                     variant:variant.name,
-                    applicationId:library ? null : variant.applicationId,
+                    applicationId:library ? null : variant.applicationId.get(),
+                    namespace:variant.namespace.get(),
+                    targetSdk:library ? null : variant.targetSdk.apiLevel,
                     kotlin:files.findAll { it.name.endsWith('.kt') }.collect { it.absolutePath }.sort(),
-                    java:files.findAll { it.name.endsWith('.java') }.collect { it.absolutePath }.sort()
+                    java:files.findAll { it.name.endsWith('.java') }.collect { it.absolutePath }.sort(),
+                    dependencies:dependencies
                 ])
             }
         }
@@ -97,6 +130,7 @@ export async function resolveAndroidGradleSources(
         `${task}All`,
         '--no-daemon',
         '--no-configuration-cache',
+        '--no-configure-on-demand',
         '--max-workers=1',
         '--console=plain',
       ],
@@ -116,7 +150,13 @@ export async function resolveAndroidGradleSources(
         value.projectDir !== projectDir ||
         value.variant !== variant ||
         typeof value.projectPath !== 'string' ||
-        (value.applicationId !== null && typeof value.applicationId !== 'string')
+        (value.applicationId !== null && typeof value.applicationId !== 'string') ||
+        typeof value.namespace !== 'string' ||
+        !value.namespace ||
+        (value.targetSdk !== null &&
+          (typeof value.targetSdk !== 'number' ||
+            !Number.isInteger(value.targetSdk) ||
+            value.targetSdk <= 0))
       )
         throw new Error('Gradle printed an invalid Android project source model')
       const sources = (field: 'kotlin' | 'java'): string[] => {
@@ -128,13 +168,40 @@ export async function resolveAndroidGradleSources(
           throw new Error(`Gradle printed invalid Android ${field} source paths`)
         return list.map(String)
       }
+      if (!Array.isArray(value.dependencies))
+        throw new Error('Gradle printed invalid Android dependencies')
+      const dependencies = value.dependencies.map(
+        (entry: unknown): AndroidGradleDependency => {
+          if (isRecord(entry) && typeof entry.name === 'string' && entry.name) {
+            if (
+              entry.kind === 'module' &&
+              typeof entry.group === 'string' &&
+              entry.group &&
+              typeof entry.version === 'string' &&
+              entry.version
+            )
+              return {
+                kind: entry.kind,
+                group: entry.group,
+                name: entry.name,
+                version: entry.version,
+              }
+            if (entry.kind === 'project' || entry.kind === 'file')
+              return { kind: entry.kind, name: entry.name }
+          }
+          throw new Error('Gradle printed an invalid Android dependency')
+        },
+      )
       return {
         projectDir,
         projectPath: value.projectPath,
         variant,
         applicationId: value.applicationId,
+        namespace: value.namespace,
+        targetSdk: value.targetSdk,
         kotlin: sources('kotlin'),
         java: sources('java'),
+        dependencies,
       }
     })
   } finally {

package/src/androidGradleContract.ts

@@ -9,6 +9,14 @@ export interface AndroidGradleSources {
   projectPath: string
   variant: string
   applicationId: string | null
+  namespace: string
+  targetSdk: number | null
   kotlin: string[]
   java: string[]
+  dependencies: AndroidGradleDependency[]
 }
+
+export type AndroidGradleDependency =
+  | { kind: 'module'; group: string; name: string; version: string }
+  | { kind: 'project'; name: string }
+  | { kind: 'file'; name: string }

package/src/expo-kotlin-host.ts

@@ -5,6 +5,7 @@
 import fs from 'node:fs'
 import path from 'node:path'
 import { resolveExpoAndroidAutolinking } from './android-autolinking'
+import { collectAndroidBridgeDependencies } from './android-bridge-dependencies'
 import {
   androidAppSources,
   selectBridgePackages,
@@ -27,7 +28,7 @@ export interface ExpoKotlinModules {
   sources: string[]
   javaSpecs?: string[]
   gradleSources?: AndroidGradleSourceRequest
-  // the app's own legacy React Native modules, hosted beside the Expo ones
+  // React Native package modules, hosted beside the Expo ones
   bridge: BridgeSelection | null
 }
 
@@ -113,8 +114,12 @@ export async function collectExpoKotlinModules(
   return result.length === 0 && !answeredInstalled ? null : result
 }
 
-// the app module's ReactPackage classes the application registers
+// native dependency packages followed by the app's own registrations
 async function collectBridgePackages(appRoot: string): Promise<BridgeSelection | null> {
+  const dependencies = await collectAndroidBridgeDependencies(
+    appRoot,
+    peachKotlinModuleRoot(),
+  )
   const app = androidAppSources(appRoot)
   if (
     !app ||
@@ -122,11 +127,14 @@ async function collectBridgePackages(appRoot: string): Promise<BridgeSelection |
       /\b(?:Base|Turbo)?ReactPackage\b/.test(fs.readFileSync(file, 'utf8')),
     )
   )
-    return null
+    return dependencies
   const { scanBridgeFiles } = await import('./kotlin-host')
   const files = await scanBridgeFiles(peachKotlinModuleRoot(), app.kotlin)
   const selection = selectBridgePackages(app.applicationId, files, app.java)
-  return selection.packages.length === 0 ? null : selection
+  const packages = [...(dependencies?.packages ?? []), ...selection.packages]
+  return packages.length
+    ? { applicationId: dependencies?.applicationId ?? selection.applicationId, packages }
+    : null
 }
 
 export async function compileExpoKotlinModules(
@@ -190,22 +198,27 @@ export async function compileExpoKotlinModules(
       const artifact = await expoKotlinArtifact(root, peachKotlinModuleRoot(), origin, {
         modules,
         sources,
+        javaSpecs: [...new Set(hosted.flatMap((entry) => entry.javaSpecs ?? []))],
         bridge: selection && { applicationId: selection.applicationId, packages: hosted },
       })
       return result(artifact)
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error)
       // kotlinc names each failing source line; anything else is the host's
-      const errors = message.match(/^.+\.kt:\d+:\d+: error:.*$/gm)
+      const errors = message.match(/^.+\.(?:kt|java):\d+:\d+: error:.*$/gm)
       if (!errors) throw error
       const linesFor = (sources: string[]) =>
         errors.filter((line) => sources.some((source) => line.startsWith(`${source}:`)))
-      const broken = hosted.filter((entry) => linesFor(entry.sources).length > 0)
+      const broken = hosted.filter(
+        (entry) => linesFor([...entry.sources, ...(entry.javaSpecs ?? [])]).length > 0,
+      )
       const brokenProjects = projects.filter(
         (project) => project.installed && linesFor(project.sources).length > 0,
       )
       if (broken.length > 0 || brokenProjects.length > 0) {
-        drop(broken, (entry) => linesFor(entry.sources).join('\n'))
+        drop(broken, (entry) =>
+          linesFor([...entry.sources, ...(entry.javaSpecs ?? [])]).join('\n'),
+        )
         dropProjects(brokenProjects, (project) => linesFor(project.sources).join('\n'))
         continue
       }

package/src/expoKotlinContract.ts

@@ -12,7 +12,7 @@ export interface ExpoKotlinCompilationResult {
   namespaces: string[]
   module: { url: string; hash: string; compose: boolean } | null
   failures: { namespace: string; diagnostic: string }[]
-  // the namespaces the app's own legacy React Native modules answer for; the
+  // the namespaces the app's React Native package modules answer for; the
   // engine installs them as bridge modules, not as Expo modules
   bridgeModules: string[]
 }

package/src/java-module-abi.ts

@@ -44,7 +44,13 @@ export async function readJavaModuleSpecs(
         ...origins.keys(),
       ],
       { maxBuffer: 16 * 1024 * 1024 },
-    )
+    ).catch((cause: unknown) => {
+      if (!isRecord(cause) || typeof cause.stderr !== 'string') throw cause
+      let diagnostic = cause.stderr
+      for (const [temporary, original] of origins)
+        diagnostic = diagnostic.replaceAll(temporary, original)
+      throw new Error(`Java module read failed:\n${diagnostic.trim()}`, { cause })
+    })
     const specs = stdout
       .split('\n')
       .filter(Boolean)