@bun-native/cli 0.33.0 → 0.33.1

package/README.md

@@ -2,4 +2,4 @@
 
 Create, check, run and AOT-build Bun Native desktop applications.
 
-Part of [Bun Native](https://github.com/0xPlayerOne/bun-native), an experimental developer preview. Version 0.33.0 was built from [fa8bef754122](https://github.com/0xPlayerOne/bun-native/tree/fa8bef754122621d4235eb06e30bb1085b4f7b1e) and published from GitHub Actions with npm provenance. Use the Bun revision pinned in that commit's toolchain.json. Start with the [getting-started guide](https://github.com/0xPlayerOne/bun-native/blob/fa8bef754122621d4235eb06e30bb1085b4f7b1e/docs/getting-started.md); `bun-native host install` fetches the matching release host. The license notice is in LICENSE.
+Part of [Bun Native](https://github.com/0xPlayerOne/bun-native), an experimental developer preview. Version 0.33.1 was built from [c56fdd675365](https://github.com/0xPlayerOne/bun-native/tree/c56fdd6753653a10144a4167c1d3dfb3c38a0647) and published from GitHub Actions with npm provenance. Use the Bun revision pinned in that commit's toolchain.json. Start with the [getting-started guide](https://github.com/0xPlayerOne/bun-native/blob/c56fdd6753653a10144a4167c1d3dfb3c38a0647/docs/getting-started.md); `bun-native host install` fetches the matching release host. The license notice is in LICENSE.

package/bun-native-source.json

@@ -1,11 +1,11 @@
 {
   "schemaVersion": 1,
-  "commit": "fa8bef754122621d4235eb06e30bb1085b4f7b1e",
-  "tree": "f805e2eb19a4e10fc29d1dc827cf5bc617b5773b",
+  "commit": "c56fdd6753653a10144a4167c1d3dfb3c38a0647",
+  "tree": "c6e81b3f9d041e11dd0413b5fdd7a50910383854",
   "files": {
     "package.json": {
-      "bytes": 2164,
-      "sha256": "db50b6f81f25c113a46f8c9b038bc548a92effaeb4ad9562e5e95044baa7b66f"
+      "bytes": 2115,
+      "sha256": "caf866d56f3cd7530d5735ecbf62512e9e22526bc44c75a4b48a18c26352c0b8"
     },
     ".oxfmtrc.json": {
       "bytes": 402,
@@ -16,36 +16,48 @@
       "sha256": "25e27847d6fd50c27314506d50c83a68764489b84bf91f9c35dceb937134e882"
     },
     "experiments/aot-gpui/compile.ts": {
-      "bytes": 1661,
-      "sha256": "832cec3a32205995551dd270fdda0fd4bd26f0dfdf5b11d65457c73b88ec2b8f"
+      "bytes": 1947,
+      "sha256": "3617b537e53c90759591b2240c94f65aae29ca04d5ce3dcb661ec0e26609cc2a"
     },
     "experiments/aot-gpui/inspect-runtime.ts": {
-      "bytes": 12491,
-      "sha256": "071d377315ba801faad088a2dcf0140598536d38c7112139fd927a649a1ea285"
+      "bytes": 12612,
+      "sha256": "d1b2bebca588db846fc964177ae8b42fc5ae0474bfa0ebc9ee833a41e240c39d"
     },
     "experiments/aot-gpui/inspect.ts": {
-      "bytes": 2383,
-      "sha256": "f80f7ec7e8a070f6e9d8478380d193a0120f9b89dedd88422c7f7fd6b3490d48"
+      "bytes": 2504,
+      "sha256": "e24851ad70d48df0160ed0ace6d39ebcbf7b7845d793cbd3b0b8a42e9736b499"
     },
     "scripts/native.ts": {
-      "bytes": 9688,
-      "sha256": "2290cf2b6508cc8a08c044ff363edc4a6b9b53b5a69169773d14807c3d4ed6c6"
+      "bytes": 10591,
+      "sha256": "8e100fe4929660a5415571b8ec7658074cfaa3c60d2c54fbbed6fb3b2a19be42"
     },
     "scripts/native/artifact.ts": {
-      "bytes": 1131,
-      "sha256": "e0496b30b935f02efb8297b41fd2e7ad310fc58d8a6056c3bd4b0d8c142044c1"
+      "bytes": 2745,
+      "sha256": "a64e82d74f56b05d01fb9ea954414f39c6a94f4a298515aff9c05b0dd257da4d"
     },
     "scripts/native/build.ts": {
-      "bytes": 10234,
-      "sha256": "a72c2639c1a5dd4d31eb48cea48c0a010e71b0ea7794ba1eace2d5f35f7677d1"
+      "bytes": 9504,
+      "sha256": "42cae4ccfb02ade4c170c1a8b1cc2fc364a7bbdf99c2fc39d1118f00e88dcd55"
+    },
+    "scripts/native/bundle.ts": {
+      "bytes": 4215,
+      "sha256": "b29afed376f6fd55ac345bf68a16418301191b89d81e9f0cf52cbab0c21e567f"
+    },
+    "scripts/native/consumer-files.ts": {
+      "bytes": 1599,
+      "sha256": "5176aeffd47dc99b9cc5d5f6d17dfcfdb982365d2f9fbb7d2260e26fbd5c18a9"
+    },
+    "scripts/native/context.ts": {
+      "bytes": 3416,
+      "sha256": "4ca3e7ce77331bec10783c9c9b744f7065363baac7b5888d845062677f5ff524"
     },
     "scripts/native/doctor.ts": {
-      "bytes": 2610,
-      "sha256": "ca2f57dacf6c929bb336324fc71228c03557b3c38ab9f5f8b77da86cb5048f7c"
+      "bytes": 2748,
+      "sha256": "425c1d2bb309556ae4b1a7798130361d09e49b6ce2db7493c241e1fb38737f2c"
     },
     "scripts/native/host-download.ts": {
-      "bytes": 6430,
-      "sha256": "d27ef6968d506ad8adc0b850a1283fe8c41487d9009dd690e75ad5ad379cdc44"
+      "bytes": 7676,
+      "sha256": "2850dcbd88c377dfb85160af90514fb57ef646f1545dbf89b28d604d87b6041d"
     },
     "scripts/native/host-header.ts": {
       "bytes": 1248,
@@ -56,60 +68,68 @@
       "sha256": "5e790bbf787bc22e37aecf031520942d96677717b201fd9889ddcb8eaa2715e1"
     },
     "scripts/native/inputs.ts": {
-      "bytes": 2839,
-      "sha256": "3e98bf1a0208104cc2c18235cfe84fbde719e5e6cf5fc8a4181c3fa69772ce94"
+      "bytes": 3783,
+      "sha256": "4b817e8c697e64bdf669e072df91dc1ac61400cb45c91fdefd4269f9d1be4b73"
     },
     "scripts/native/lint.ts": {
-      "bytes": 1819,
-      "sha256": "eaedd87b266d54722c22a4a5b9ddc5606c96cedeb20d21ea9d2381ed5aaadd33"
+      "bytes": 1842,
+      "sha256": "201e66c00c8c1d861c67a2ed686fb71e9f7830356db83701a1ce851d72f41b95"
     },
     "scripts/native/package-archive.ts": {
-      "bytes": 4945,
-      "sha256": "249cda6f7edf4eade989c324e473826899bcc0062cdf9cafde76b0d1c074247e"
+      "bytes": 4610,
+      "sha256": "faea43432b0f85f315f0dc17ad9b0ca3bdabcd5324ce942577a1ac9940a49d65"
     },
     "scripts/native/package-lock.ts": {
       "bytes": 9244,
       "sha256": "ad8f2b73ca5b88075b503a18c2f0405f13ec60a6c1d9a9d172056d707c0b5e10"
     },
     "scripts/native/package-set.ts": {
-      "bytes": 16263,
-      "sha256": "b7207b884b90303a0d44dc9a181617c03e24683850fc17a6db802fc740f0a26a"
+      "bytes": 16516,
+      "sha256": "79fd8a3a0f4e74f4e312cb511beec9e4893eb18b7ddef8c1179dcff47fc3e858"
+    },
+    "scripts/native/package-stamp.ts": {
+      "bytes": 7982,
+      "sha256": "b622a5c2e60da5f804425b37181e573008b1c468afbf9cfe6cab472145cc6e3a"
     },
     "scripts/native/paths.ts": {
       "bytes": 806,
       "sha256": "6ccf669071878d65dbe4686e9b8585bbb217b4a9cd834f7c1866c9448c0c9a55"
     },
     "scripts/native/project.ts": {
-      "bytes": 11175,
-      "sha256": "c62044f4e0baa004bba1bd27a0ae3a53beb6aa02d558e356464c39fc471b0c61"
+      "bytes": 12188,
+      "sha256": "80464428b3efd46253e94cb0ab2a7041ba31753fb97f29dde8acba86fa3c0b21"
     },
     "scripts/native/quality.ts": {
-      "bytes": 2380,
-      "sha256": "5d2c68657e9a85db9e654b1be6ffc437bcd4fdc623854a98eda5f9da842e38cc"
+      "bytes": 2917,
+      "sha256": "f68f6730c1371cfd63763716256f717b3f52581ee4b07f4bfa2572873ab49ff9"
+    },
+    "scripts/native/registry-project.ts": {
+      "bytes": 4651,
+      "sha256": "4a265b611dce5a7d2614abeb04ca010433f75be80837ae997706ae48f03c3814"
     },
     "scripts/native/session.ts": {
-      "bytes": 9635,
-      "sha256": "def47965ad2d36d95e0f9a5b1f778443e5d811e8a82b9fb094e4ee79916eb26f"
+      "bytes": 9768,
+      "sha256": "d1132c54f9e11286198be5ac10cd68d388616ea90b2a400181c578faebfc1a2c"
     },
     "scripts/native/standalone.ts": {
-      "bytes": 6195,
-      "sha256": "c464f48f3c054dbbb057e621b1f4b55e2679b797bca3282561eed39cfe510f6f"
+      "bytes": 5235,
+      "sha256": "1830b5f41cfa7516560a5b6d1908899dfb2e93425e6c0a09d8cef608d9490517"
+    },
+    "scripts/native/ustar.ts": {
+      "bytes": 1264,
+      "sha256": "c8011ecb1de6e4c1065c1e90cede7cc12a1cf7344231267d01472dfacd9d9d88"
     },
     "scripts/native/watch.ts": {
       "bytes": 3793,
       "sha256": "b5d7f98516135ae1577823ccd6d4647f53d84df7a0f1fa68d4cad5a2c62cdd0f"
     },
-    "scripts/solid-build.ts": {
-      "bytes": 1615,
-      "sha256": "5f263562cc299642e2971cce1dd913533ff092bc5543abd11d07048e8b3e5908"
-    },
     "scripts/solid/transform.ts": {
       "bytes": 642,
       "sha256": "281fdbd71b10e613d9080e0494320161e51cfaf9a1c7b9966707eba0dd24ef1c"
     },
     "toolchain.json": {
-      "bytes": 3012,
-      "sha256": "00c3f707aae8abe9ca75cd2e162f5e1c7c34362a03675da39afead60d856066a"
+      "bytes": 3234,
+      "sha256": "9f4d9362cb4cc38c0f4e705295789a0cbfec46ffdd007e0541b9441a7c3003a7"
     },
     "tsconfig.json": {
       "bytes": 1104,
@@ -121,8 +141,8 @@
     }
   },
   "toolchain": {
-    "bytes": 3012,
-    "sha256": "00c3f707aae8abe9ca75cd2e162f5e1c7c34362a03675da39afead60d856066a"
+    "bytes": 3234,
+    "sha256": "9f4d9362cb4cc38c0f4e705295789a0cbfec46ffdd007e0541b9441a7c3003a7"
   },
   "dependencyLock": {
     "bytes": 28357,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bun-native/cli",
-  "version": "0.33.0",
+  "version": "0.33.1",
   "type": "module",
   "license": "MIT",
   "files": [
@@ -31,5 +31,35 @@
   "publishConfig": {
     "access": "public",
     "provenance": true
+  },
+  "bunNative": {
+    "templates": {
+      "solid": {
+        "dependencies": {
+          "@bun-native/core": "0.33.1",
+          "@bun-native/solid": "0.33.1",
+          "solid-js": "1.9.18"
+        },
+        "devDependencies": {
+          "@bun-native/cli": "0.33.1",
+          "@types/bun": "1.4.4",
+          "oxlint": "1.92.0"
+        }
+      },
+      "react": {
+        "dependencies": {
+          "@bun-native/core": "0.33.1",
+          "@bun-native/react": "0.33.1",
+          "react": "19.3.1"
+        },
+        "devDependencies": {
+          "@bun-native/cli": "0.33.1",
+          "@types/bun": "1.4.4",
+          "oxlint": "1.92.0",
+          "@types/react": "19.3.0",
+          "@types/react-reconciler": "0.34.1"
+        }
+      }
+    }
   }
 }

package/src/experiments/aot-gpui/compile.ts

@@ -1,4 +1,4 @@
-import { writeFileSync } from 'node:fs'
+import { readFileSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { inspectBunExecutable } from './inspect'
 import { inspectBunRuntime } from './inspect-runtime'
@@ -7,14 +7,11 @@ import toolchain from '../../toolchain.json'
 /** Shared real AOT compiler and executable checks for fixtures and application tooling. */
 export function compileApplication(input: string, output: string, cwd: string, trim = false) {
   if (Bun.revision !== toolchain.bun.revision) throw new Error('Use the pinned Bun AOT compiler')
+  // toolchain.json is the one record of the compiler arguments (with the pinned revision).
   const compileCommand = [
     process.execPath,
-    '--no-install',
-    'compile',
-    '--no-script',
-    '--production',
+    ...toolchain.bun.compileArguments,
     ...(trim ? ['--trim'] : []),
-    '--explain=json',
     input,
     '--outfile',
     output,
@@ -31,11 +28,17 @@ export function compileApplication(input: string, output: string, cwd: string, t
   if (result.exitCode !== 0)
     throw new Error(`compile-aot failed (${result.exitCode}): ${result.stderr}`)
   const buildMs = performance.now() - start
-  const inspection = inspectBunExecutable(output)
+  // Read the executable once for both inspectors and its digest.
+  const bytes = readFileSync(output)
+  const inspection = inspectBunExecutable(bytes)
   if (!inspection.hasCompiledProgram)
     throw new Error('Compiler output has no compiled-program record')
-  const runtimeFeatures = inspectBunRuntime(output)
+  const runtimeFeatures = inspectBunRuntime(bytes)
   if (runtimeFeatures.jit === 'present' || runtimeFeatures.jitRemovedRanges.count === 0)
     throw new Error('Compiler output does not record removal of the JIT compiler')
-  return { compileCommand, buildMs, inspection, runtimeFeatures }
+  const executable = {
+    bytes: bytes.length,
+    sha256: new Bun.CryptoHasher('sha256').update(bytes).digest('hex'),
+  }
+  return { compileCommand, buildMs, inspection, runtimeFeatures, executable }
 }

package/src/experiments/aot-gpui/inspect-runtime.ts

@@ -218,8 +218,9 @@ function overlappingMappings(table: Section[], start: bigint, length: bigint): S
   )
 }
 
-export function inspectBunRuntime(path: string) {
-  const bytes = readFileSync(path)
+/** Inspect an executable by path, or bytes a caller already read. */
+export function inspectBunRuntime(source: string | Buffer) {
+  const bytes = typeof source === 'string' ? readFileSync(source) : source
   const { format, name, table } = imageSections(bytes)
   const candidates = table.filter((section) => section.name === name)
   const section = candidates[0]

package/src/experiments/aot-gpui/inspect.ts

@@ -8,14 +8,15 @@ const offsetsSize = 32
 const moduleRecordSize = 52
 const compiledProgramFlag = 1 << 14
 
-export function inspectBunExecutable(path: string): {
+/** Inspect an executable by path, or bytes a caller already read. */
+export function inspectBunExecutable(source: string | Buffer): {
   format: 'elf' | 'macho' | 'pe'
   payloadOffset: number
   payloadBytes: number
   flags: number
   hasCompiledProgram: boolean
 } {
-  const bytes = readFileSync(path)
+  const bytes = typeof source === 'string' ? readFileSync(source) : source
   const magic = bytes.length >= 4 ? bytes.readUInt32LE(0) : 0
   const format =
     magic === 0x464c457f

package/src/scripts/native/artifact.ts

@@ -1,5 +1,5 @@
-import { createHash } from 'node:crypto'
-import { open, readFile, stat } from 'node:fs/promises'
+import { mkdir, open, readFile, rename, rm, stat, writeFile } from 'node:fs/promises'
+import { dirname } from 'node:path'
 
 export type FileDigest = { bytes: number; sha256: string }
 
@@ -8,8 +8,13 @@ export type FileDigest = { bytes: number; sha256: string }
 const WHOLE_FILE_BYTES = 4 * 1024 * 1024
 const CHUNK_BYTES = 1024 * 1024
 
+/** SHA-256 hex through Bun's native hasher; avoids loading node:crypto on CLI paths. */
+export function sha256(data: string | Uint8Array): string {
+  return new Bun.CryptoHasher('sha256').update(data).digest('hex')
+}
+
 export async function fileDigest(path: string): Promise<FileDigest> {
-  const hash = createHash('sha256')
+  const hash = new Bun.CryptoHasher('sha256')
   // The size only picks a strategy; both read to EOF and count what they read.
   if ((await stat(path)).size <= WHOLE_FILE_BYTES) {
     const data = await readFile(path)
@@ -30,3 +35,39 @@ export async function fileDigest(path: string): Promise<FileDigest> {
   }
   return { bytes, sha256: hash.digest('hex') }
 }
+
+/**
+ * The digest of a large, rarely changing file (the compiler), reused from `cache`
+ * while the file keeps its device, inode, size, mtime and ctime. Any write or
+ * replacement changes one of those, and the file is hashed again.
+ */
+export async function cachedFileDigest(path: string, cache: string): Promise<FileDigest> {
+  const identity = async () => {
+    const stats = await stat(path, { bigint: true })
+    return [stats.dev, stats.ino, stats.size, stats.mtimeNs, stats.ctimeNs].join(':')
+  }
+  const before = await identity()
+  try {
+    const cached = await Bun.file(cache).json()
+    if (
+      cached?.path === path &&
+      cached.identity === before &&
+      Number.isSafeInteger(cached.digest?.bytes) &&
+      /^[0-9a-f]{64}$/.test(cached.digest?.sha256)
+    )
+      return { bytes: cached.digest.bytes, sha256: cached.digest.sha256 }
+  } catch {}
+  const digest = await fileDigest(path)
+  if ((await identity()) === before) {
+    const partial = `${cache}.${process.pid}.partial`
+    try {
+      await mkdir(dirname(cache), { recursive: true })
+      await writeFile(partial, JSON.stringify({ path, identity: before, digest }) + '\n')
+      await rename(partial, cache)
+    } catch {
+      // The cache is optional; a read-only project hashes every time.
+      await rm(partial, { force: true }).catch(() => {})
+    }
+  }
+  return digest
+}

package/src/scripts/native/build.ts

@@ -3,48 +3,20 @@ import { chmod, copyFile, mkdir, readFile, readdir, writeFile } from 'node:fs/pr
 import { dirname, isAbsolute, join, relative, resolve } from 'node:path'
 import { compileApplication } from '../../experiments/aot-gpui/compile.ts'
 import type { Project } from './project.ts'
-import { fileDigest } from './artifact.ts'
+import { bundleApplication } from './bundle.ts'
+import { cachedFileDigest, fileDigest, sha256 } from './artifact.ts'
+import { userCache } from './context.ts'
 import toolchain from '../../toolchain.json'
 
-/**
- * Bun.build names each module in its `// path` comments relative to the process
- * working directory, so bundling from another cwd changed the module bytes. Anchor
- * it to the project for the bundle's duration; every path used here is absolute.
- */
-async function inProjectDirectory<T>(project: Project, bundle: () => Promise<T>): Promise<T> {
-  const previous = process.cwd()
-  process.chdir(project.directory)
-  try {
-    return await bundle()
-  } finally {
-    process.chdir(previous)
-  }
-}
-
+/** Bundle a project's entry into `outdir/application.js` with the shared configuration. */
 export async function bundleProject(project: Project, outdir: string): Promise<string> {
-  const destination = resolve(outdir)
-  return inProjectDirectory(project, () => bundleFromProject(project, destination))
-}
-
-async function bundleFromProject(project: Project, outdir: string): Promise<string> {
-  if (project.framework === 'solid') {
-    // Only Solid needs the Babel universal transform; React builds skip loading it.
-    const { buildSolid } = await import('../solid-build.ts')
-    return buildSolid(project.entry, outdir)
-  }
-  await mkdir(outdir, { recursive: true })
-  const result = await Bun.build({
-    entrypoints: [project.entry],
+  const { module } = await bundleApplication({
+    framework: project.framework,
+    entry: project.entry,
     outdir,
-    naming: 'application.js',
-    target: 'bun',
-    format: 'esm',
-    jsx: { runtime: 'automatic', importSource: '@bun-native/react' },
-    define: { 'process.env.NODE_ENV': '"production"' },
-    sourcemap: 'external',
+    cwd: project.directory,
   })
-  if (!result.success) throw new AggregateError(result.logs, 'React native build failed')
-  return join(outdir, 'application.js')
+  return module
 }
 
 /** The application bundle that holds the host in a macOS build. */
@@ -148,7 +120,10 @@ export async function buildProject(
     `import { dirname, join } from 'node:path'\nprocess.env['BUN_NATIVE_HOST'] ??= join(dirname(process.execPath), ${JSON.stringify(hostFile)})\nawait import('./development/application.js')\n`,
     { flag: 'wx' }
   )
-  const compiled = compileApplication(launcher, join(outdir, applicationFile), project.directory)
+  // The compiler names the program by its path relative to its working directory,
+  // so compiling the relative launcher from the output directory keeps the
+  // executable independent of where that directory is.
+  const compiled = compileApplication('launcher.ts', join(outdir, applicationFile), outdir)
   if (layout.infoPlist && infoPlist) {
     await mkdir(dirname(join(outdir, hostFile)), { recursive: true })
     await writeFile(join(outdir, layout.infoPlist), infoPlist, { flag: 'wx' })
@@ -165,7 +140,7 @@ export async function buildProject(
     throw new Error('Application module changed during AOT compilation')
   // Keep machine-local paths and wall-clock timing out of the manifest so equal
   // inputs produce an identical manifest; timing goes to a separate diagnostic.
-  const { compileCommand, buildMs, ...inspected } = compiled
+  const { compileCommand, buildMs, executable, ...inspected } = compiled
   await writeFile(
     join(outdir, 'build-metrics.json'),
     JSON.stringify({ schemaVersion: 1, compileMs: buildMs }, null, 2) + '\n',
@@ -180,13 +155,19 @@ export async function buildProject(
     toolchain,
     application: {
       file: applicationFile,
-      ...(await fileDigest(join(outdir, applicationFile))),
+      ...executable,
       // Absolute arguments are recorded relative to this artifact directory; the
       // compiler is identified by its digest instead of its install path.
       compileCommand: compileCommand.map((argument, index) =>
         index === 0 ? 'bun' : isAbsolute(argument) ? relative(outdir, argument) : argument
       ),
-      compiler: { revision: Bun.revision, executable: await fileDigest(process.execPath) },
+      compiler: {
+        revision: Bun.revision,
+        executable: await cachedFileDigest(
+          process.execPath,
+          join(userCache(), 'compiler', `${sha256(process.execPath).slice(0, 32)}.json`)
+        ),
+      },
       ...inspected,
     },
     developmentModule: { file: 'development/application.js', ...developmentModule },

package/src/scripts/native/bundle.ts

@@ -0,0 +1,121 @@
+import type { BuildConfig, BunPlugin } from 'bun'
+import { mkdir, realpath, stat } from 'node:fs/promises'
+import { join, resolve, sep } from 'node:path'
+
+export type Framework = 'solid' | 'react'
+
+/**
+ * The one bundler configuration for a Bun Native application module. `native dev`,
+ * `native build`, the CI fixtures and the benchmarks all bundle through it, so CI
+ * qualifies the bytes users build. The module is not minified: `native dev` runs it
+ * as is (readable stacks), and the AOT compiler's `--production` minifies the
+ * compiled program anyway.
+ */
+export function bundleConfig(
+  framework: Framework,
+  entry: string,
+  outdir: string,
+  plugins: BunPlugin[] = []
+): BuildConfig & { outdir: string } {
+  return {
+    entrypoints: [entry],
+    outdir,
+    naming: 'application.js',
+    target: 'bun',
+    format: 'esm',
+    define: { 'process.env.NODE_ENV': '"production"' },
+    sourcemap: 'external',
+    metafile: true,
+    plugins,
+    // Solid's universal renderer is selected through the `browser` export condition;
+    // React uses its automatic JSX runtime from the adapter.
+    ...(framework === 'solid'
+      ? { conditions: ['browser'] }
+      : { jsx: { runtime: 'automatic', importSource: '@bun-native/react' } }),
+  }
+}
+
+/** Solid's universal JSX transform as a bundler plugin; Babel loads only for Solid builds. */
+async function solidPlugin(): Promise<BunPlugin> {
+  const { transformSolid } = await import('../solid/transform.ts')
+  return {
+    name: 'solid-native-universal',
+    setup(build) {
+      build.onLoad({ filter: /\.[jt]sx$/ }, async ({ path }) => ({
+        contents: transformSolid(await Bun.file(path).text(), path),
+        loader: 'ts',
+      }))
+    },
+  }
+}
+
+export type Bundle = {
+  /** The absolute path of `application.js`; its source map is next to it. */
+  module: string
+  /** Every module the bundle read, relative to `cwd`, `/`-separated and sorted (from the metafile). */
+  inputs: string[]
+}
+
+/**
+ * Bundle one application entry into `outdir/application.js`.
+ *
+ * Bun.build names each module in its `// path` comments relative to the process
+ * working directory, so the bundle runs with the working directory set to `cwd` (the
+ * project, or the checkout for fixtures) and equal sources give equal bytes from any
+ * caller directory.
+ */
+export async function bundleApplication(options: {
+  framework: Framework
+  entry: string
+  outdir: string
+  cwd: string
+  plugins?: BunPlugin[]
+}): Promise<Bundle> {
+  const entry = await realpath(options.entry)
+  if (!(await stat(entry)).isFile() || !/\.[jt]sx?$/.test(entry))
+    throw new Error(
+      `${options.framework === 'solid' ? 'Solid' : 'React'} entry must be a TypeScript/JavaScript source file`
+    )
+  const outdir = resolve(options.outdir)
+  await mkdir(outdir, { recursive: true })
+  const plugins =
+    options.plugins ?? (options.framework === 'solid' ? [await solidPlugin()] : undefined)
+  const previous = process.cwd()
+  process.chdir(options.cwd)
+  let result: Awaited<ReturnType<typeof Bun.build>>
+  try {
+    result = await Bun.build(bundleConfig(options.framework, entry, outdir, plugins))
+  } finally {
+    process.chdir(previous)
+  }
+  if (!result.success)
+    throw new AggregateError(
+      result.logs,
+      `${options.framework === 'solid' ? 'Solid' : 'React'} native build failed`
+    )
+  return {
+    module: join(outdir, 'application.js'),
+    inputs: Object.keys(result.metafile?.inputs ?? {})
+      .map((path) => path.split(sep).join('/'))
+      .sort(),
+  }
+}
+
+/**
+ * The modules an entry that is compiled directly (without a framework bundle) reads,
+ * from the same resolution `bun compile` uses; nothing is written.
+ */
+export async function moduleInputs(entry: string, cwd: string): Promise<string[]> {
+  const previous = process.cwd()
+  process.chdir(cwd)
+  let result: Awaited<ReturnType<typeof Bun.build>>
+  try {
+    result = await Bun.build({ entrypoints: [entry], target: 'bun', format: 'esm', metafile: true })
+  } finally {
+    process.chdir(previous)
+  }
+  if (!result.success) throw new AggregateError(result.logs, `Cannot resolve ${entry}`)
+  return Object.keys(result.metafile?.inputs ?? {})
+    .map((path) => path.split(sep).join('/'))
+    .sort()
+}

package/src/scripts/native/consumer-files.ts

@@ -0,0 +1,46 @@
+import compilerConfig from '../../tsconfig.json'
+
+/**
+ * Files shared by every project that installs Bun Native from packages (a local
+ * package set or the npm registry) instead of using a checkout's workspace.
+ */
+
+/** The installed CLI, run without auto-install so a missing package fails instead of downloading. */
+export const installedCli = 'bun --no-install ./node_modules/@bun-native/cli/src/scripts/native.ts'
+
+export const json = (value: unknown) => JSON.stringify(value, null, 2) + '\n'
+
+/** The template formatter keeps short string arrays on one line, so format checks pass as generated. */
+const formattedJSON = (value: unknown) =>
+  json(value).replace(
+    /\[\n\s*("[^"\n]*"(?:,\n\s*"[^"\n]*")*)\n\s*\]/g,
+    (_, items: string) => `[${items.split(/,\n\s*/).join(', ')}]`
+  )
+
+export function consumerScripts(): Record<string, string> {
+  return {
+    // The persistent watch controller returns freed bundler pages promptly;
+    // see docs/developer-tooling.md "Controller memory".
+    dev: `MIMALLOC_PURGE_DELAY=0 ${installedCli} dev .`,
+    build: `${installedCli} build .`,
+    check: 'bun --no-install check --no-script --no-pretty',
+    format: `${installedCli} format .`,
+    'format:check': `${installedCli} format . --check`,
+    lint: `${installedCli} lint .`,
+  }
+}
+
+export function consumerTsconfig(
+  framework: 'solid' | 'react',
+  entry: string,
+  exclude: string[]
+): string {
+  return formattedJSON({
+    compilerOptions: {
+      ...compilerConfig.compilerOptions,
+      jsxImportSource: `@bun-native/${framework}`,
+    },
+    include: [entry],
+    exclude,
+  })
+}