@bun-native/cli 0.0.0-stage → 0.33.0

package/src/scripts/native.ts

@@ -0,0 +1,219 @@
+#!/usr/bin/env bun
+import { mkdir, mkdtemp, rm } from 'node:fs/promises'
+import { join, resolve } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { parseArgs } from 'node:util'
+import { prebuiltHost } from './native/host.ts'
+import { createProject, readProject } from './native/project.ts'
+
+const repository = resolve(import.meta.dir, '..')
+const usage = `Bun Native application tooling
+
+  bun run native create apps/my-app [--framework solid|react] [--language typescript|javascript]
+  bun scripts/native.ts create /path/to/my-app --packages /path/to/package-set/manifest.json
+  bun run native dev apps/my-app --host /absolute/path/to/bun-native-host|auto [--watch]
+  bun run native build apps/my-app --host /absolute/path/to/bun-native-host|auto --host-profile dev|release [--outdir directory] [--bundle-id reverse.dns.id]
+  bun run native check apps/my-app
+  bun run native format apps/my-app [--check]
+  bun run native lint apps/my-app
+  bun run native doctor [apps/my-app] [--host /absolute/path/to/bun-native-host|auto]
+  bun run native host install [--version x.y.z] [--force]
+
+Projects use checkout dependencies unless --packages selects a standalone local package set.
+Standalone scripts use their own installed CLI. Native hosts are supplied explicitly: an absolute path,
+or auto for this checkout version's released host (linux-x64, linux-arm64, darwin-arm64, darwin-x64).
+dev starts once; --watch remounts the app after edits and resets state. build produces unsigned same-platform AOT artifacts.
+check runs Bun's built-in type checker, formatter check and the pinned oxlint; format applies the formatter.
+lint runs only the pinned oxlint, never on vendored packages or generated output.
+doctor reports Bun, platform, host-header and project compatibility without launching anything.
+host install and --host auto download the unsigned release host once, check it against the release's
+SHA256SUMS and reuse it from .bun-native/hosts. No other command downloads a host; none runs Cargo.
+See docs/developer-tooling.md.`
+
+async function resolveHost(value: string | undefined): Promise<string> {
+  if (value !== 'auto') return prebuiltHost(value)
+  const { installReleaseHost } = await import('./native/host-download.ts')
+  return installReleaseHost({ version: await checkoutVersion(), cache: hostCache })
+}
+
+const hostCache = join(repository, '.bun-native', 'hosts')
+
+async function checkoutVersion(): Promise<string> {
+  const manifest: { version?: unknown } = await Bun.file(join(repository, 'package.json')).json()
+  if (typeof manifest.version !== 'string') throw new Error('The checkout has no workspace version')
+  return manifest.version
+}
+
+async function main(args: string[]): Promise<void> {
+  if (args.length === 0 || (args.length === 1 && ['--help', '-h'].includes(args[0]!))) {
+    console.log(usage)
+    return
+  }
+  const [command, ...rest] = args
+  if (command === 'create') {
+    const { values, positionals } = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: {
+        framework: { type: 'string', default: 'solid' },
+        language: { type: 'string', default: 'typescript' },
+        packages: { type: 'string' },
+      },
+    })
+    if (positionals.length !== 1)
+      throw new Error('create requires exactly one new project directory')
+    if (values.framework !== 'solid' && values.framework !== 'react')
+      throw new Error('--framework must be solid or react')
+    if (values.language !== 'typescript' && values.language !== 'javascript')
+      throw new Error('--language must be typescript or javascript')
+    const path = await createProject(
+      repository,
+      positionals[0]!,
+      values.framework,
+      values.language,
+      values.packages
+    )
+    console.log(`Created ${values.framework} ${values.language} project: ${path}`)
+    console.log(
+      values.packages
+        ? 'Follow the generated README to install the pinned dependencies, then run check and dev with a prebuilt host.'
+        : 'Run its check script, then dev with --host pointing to a prebuilt native host.'
+    )
+    return
+  }
+  if (command === 'check' || command === 'format' || command === 'lint') {
+    const { values, positionals } = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: command === 'format' ? { check: { type: 'boolean' } } : {},
+    })
+    if (positionals.length !== 1)
+      throw new Error(`${command} requires exactly one project directory`)
+    const project = await readProject(repository, positionals[0]!)
+    const { checkProject, formatProject } = await import('./native/quality.ts')
+    const steps = []
+    if (command === 'format') steps.push(formatProject(project, values.check === true))
+    else {
+      if (command === 'check') steps.push(...checkProject(project))
+      // Only check and lint load the CLI's pinned oxlint; format never depends on it.
+      const { lintProject } = await import('./native/lint.ts')
+      steps.push(lintProject(project))
+    }
+    for (const step of steps) {
+      if (step.output) console.log(step.output)
+      console.log(`${step.name}: ${step.exitCode === 0 ? 'passed' : 'failed'}`)
+    }
+    if (steps.some((step) => step.exitCode !== 0)) {
+      const formatting = steps.find((step) => step.name === 'format')
+      if (formatting && formatting.exitCode !== 0 && (command === 'check' || values.check === true))
+        console.error(
+          'Apply formatting with the project format script or the native format command.'
+        )
+      process.exitCode = 1
+    }
+    return
+  }
+  if (command === 'host') {
+    const { values, positionals } = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: { version: { type: 'string' }, force: { type: 'boolean' } },
+    })
+    if (positionals.length !== 1 || positionals[0] !== 'install')
+      throw new Error('Usage: bun run native host install [--version x.y.z] [--force]')
+    const { installReleaseHost } = await import('./native/host-download.ts')
+    const host = await installReleaseHost({
+      version: values.version ?? (await checkoutVersion()),
+      cache: hostCache,
+      force: values.force === true,
+    })
+    console.log(host)
+    return
+  }
+  if (command === 'doctor') {
+    const { values, positionals } = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: { host: { type: 'string' } },
+    })
+    if (positionals.length > 1) throw new Error('doctor accepts at most one project directory')
+    const { diagnose } = await import('./native/doctor.ts')
+    const host = values.host === 'auto' ? await resolveHost('auto') : values.host
+    const results = await diagnose(repository, { host, project: positionals[0] })
+    for (const result of results)
+      console.log(`${result.status.padEnd(7)} ${result.name}: ${result.detail}`)
+    if (results.some((result) => result.status === 'failed')) process.exitCode = 1
+    return
+  }
+  if (command !== 'dev' && command !== 'build')
+    throw new Error(`Unknown command: ${command}\n${usage}`)
+  const options: Record<string, { type: 'string' | 'boolean' }> = { host: { type: 'string' } }
+  if (command === 'build') {
+    options['outdir'] = { type: 'string' }
+    options['host-profile'] = { type: 'string' }
+    options['bundle-id'] = { type: 'string' }
+  } else options['watch'] = { type: 'boolean' }
+  const { values, positionals } = parseArgs({
+    args: rest,
+    allowPositionals: true,
+    strict: true,
+    options,
+  })
+  if (positionals.length !== 1) throw new Error(`${command} requires exactly one project directory`)
+  const host = await resolveHost(typeof values['host'] === 'string' ? values['host'] : undefined)
+  const project = await readProject(repository, positionals[0]!)
+  if (command === 'dev' && values.watch) {
+    const { watchProject } = await import('./native/watch.ts')
+    await watchProject(repository, project.directory, host)
+    return
+  }
+  const { buildProject, bundleProject } = await import('./native/build.ts')
+  if (command === 'build') {
+    const profile = values['host-profile']
+    if (profile !== 'dev' && profile !== 'release')
+      throw new Error(
+        'build requires --host-profile dev or release (declared provenance, not a verified build profile)'
+      )
+    const outdir = resolve(
+      typeof values.outdir === 'string' ? values.outdir : join(project.directory, 'dist')
+    )
+    const bundleIdentifier = values['bundle-id']
+    await buildProject(
+      project,
+      host,
+      outdir,
+      profile,
+      typeof bundleIdentifier === 'string' ? { bundleIdentifier } : {}
+    )
+    console.log(`Built unsigned AOT application and supplied host in ${outdir}`)
+    return
+  }
+  const cache = join(project.directory, '.bun-native')
+  await mkdir(cache, { recursive: true })
+  const directory = await mkdtemp(join(cache, 'dev-'))
+  const originalHost = process.env['BUN_NATIVE_HOST']
+  try {
+    const entry = await bundleProject(project, directory)
+    process.env['BUN_NATIVE_HOST'] = host
+    console.log(`Starting ${project.framework} application with prebuilt host ${host}`)
+    await import(pathToFileURL(entry).href)
+  } finally {
+    if (originalHost === undefined) delete process.env['BUN_NATIVE_HOST']
+    else process.env['BUN_NATIVE_HOST'] = originalHost
+    await rm(directory, { recursive: true, force: true })
+  }
+}
+
+if (import.meta.main) {
+  try {
+    await main(process.argv.slice(2))
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error))
+    if (error instanceof AggregateError) for (const detail of error.errors) console.error(detail)
+    process.exitCode = 1
+  }
+}

package/src/scripts/solid/transform.ts

@@ -0,0 +1,16 @@
+import { transformSync } from '@babel/core'
+import solid from 'babel-preset-solid'
+
+/** Official Solid universal transform; project/Babel configuration cannot select DOM output. */
+export function transformSolid(source: string, filename: string): string {
+  const result = transformSync(source, {
+    filename,
+    babelrc: false,
+    configFile: false,
+    sourceMaps: false,
+    parserOpts: { plugins: ['typescript', 'jsx'] },
+    presets: [[solid, { generate: 'universal', moduleName: '@bun-native/solid', dev: false }]],
+  })
+  if (!result?.code) throw new Error('Solid JSX transform produced no application code')
+  return result.code
+}

package/src/scripts/solid-build.ts

@@ -0,0 +1,43 @@
+import { mkdir, realpath, stat } from 'node:fs/promises'
+import { isAbsolute, resolve } from 'node:path'
+import { transformSolid } from './solid/transform.ts'
+
+/** Build-time JSX conversion only; the generated module is shared by dev and AOT. */
+export async function buildSolid(entry: string, outdir: string): Promise<string> {
+  const source = await realpath(entry)
+  if (!(await stat(source)).isFile() || !/\.[jt]sx?$/.test(source))
+    throw new Error('Solid entry must be a TypeScript/JavaScript source file')
+  const destination = resolve(outdir)
+  await mkdir(destination, { recursive: true })
+  const result = await Bun.build({
+    entrypoints: [source],
+    outdir: destination,
+    naming: 'application.js',
+    target: 'bun',
+    format: 'esm',
+    conditions: ['browser'],
+    define: { 'process.env.NODE_ENV': '"production"' },
+    sourcemap: 'external',
+    plugins: [
+      {
+        name: 'solid-native-universal',
+        setup(build) {
+          build.onLoad({ filter: /\.[jt]sx$/ }, async ({ path }) => ({
+            contents: transformSolid(await Bun.file(path).text(), path),
+            loader: 'ts',
+          }))
+        },
+      },
+    ],
+  })
+  if (!result.success) throw new AggregateError(result.logs, 'Solid native build failed')
+  return resolve(destination, 'application.js')
+}
+
+if (import.meta.main) {
+  const entry = process.argv[2]
+  const outdir = process.argv[3]
+  if (!entry || !outdir || process.argv.length !== 4 || !isAbsolute(outdir))
+    throw new Error('Usage: bun scripts/solid-build.ts ENTRY ABSOLUTE_OUTPUT_DIRECTORY')
+  console.log(await buildSolid(entry, outdir))
+}

package/src/toolchain.json

@@ -0,0 +1,64 @@
+{
+  "schemaVersion": 2,
+  "bun": {
+    "version": "1.4.4-canary.1",
+    "revision": "b1007f1177fd402fae67387b8548cae5ae9b5707",
+    "cliRevision": "1.4.4-canary.1+b1007f117",
+    "source": "https://github.com/oven-sh/bun/tree/b1007f1177fd402fae67387b8548cae5ae9b5707",
+    "compileArguments": ["compile", "--no-script", "--production"],
+    "distribution": "npm",
+    "packages": {
+      "linux-x64": {
+        "name": "@oven/bun-linux-x64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-linux-x64/-/bun-linux-x64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-eJqVFA3brmF4UPBynqjPbQEKvId1TvdThVuYUmtP4J/VVs42iKOd6M7mfp4DnRd4sOqY7FClDaPf04J4tun5Gw==",
+        "unpackedSize": 140680988
+      },
+      "linux-arm64": {
+        "name": "@oven/bun-linux-aarch64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-linux-aarch64/-/bun-linux-aarch64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-6ASK2HEbe9/DK7KUXVjRifcQUNY6Cykz/JP8Z1uoNOMlUlh7NeC5pWJA3qWsaWvB/sy3Ozl0fUNNaT9xt31ebw==",
+        "unpackedSize": 142145540
+      },
+      "darwin-x64": {
+        "name": "@oven/bun-darwin-x64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-darwin-x64/-/bun-darwin-x64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-QJLJxX78hR/rZTY/j/yQJ2Baf/x4m74HzDG5Z3ePGWM9f8gCIbVFd17KHEvH7F4VbrGZF+sLAyH/WXzVMkGuvA==",
+        "unpackedSize": 134455089
+      },
+      "darwin-arm64": {
+        "name": "@oven/bun-darwin-aarch64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-darwin-aarch64/-/bun-darwin-aarch64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-qEQgT/3BrHUFchVvCzEMIw/SrQTR+9waTTQo/FLdyOt5OiFUdTlKrHDjIS9w9XMK+b6UdA6iVJs+B2VVnWv6iw==",
+        "unpackedSize": 123685464
+      },
+      "win32-x64": {
+        "name": "@oven/bun-windows-x64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-windows-x64/-/bun-windows-x64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-cy0DX5IP29NyjhNvPyOYqlsThwJlaKOp/3YnT2W9CojTzgQm9leZHmNQEIu/Kbip4M3LTEWd6gtVL73HvCoR6Q==",
+        "unpackedSize": 149885955
+      },
+      "win32-arm64": {
+        "name": "@oven/bun-windows-aarch64",
+        "version": "1.4.4-canary.20261105.1+b1007f1",
+        "url": "https://registry.npmjs.org/@oven/bun-windows-aarch64/-/bun-windows-aarch64-1.4.4-canary.20261105.1.tgz",
+        "integrity": "sha512-CP7pwT7C7LzhiTBnPPzMpA9DQgP2fZBLuCweSJStZTuu3ig3qzwI3gvqZcInPD7ZtTLZ6oSXGCkSqBMlMpgJBw==",
+        "unpackedSize": 133801483
+      }
+    }
+  },
+  "rust": {
+    "version": "1.98.1",
+    "components": ["rustfmt", "clippy"]
+  },
+  "gpui": {
+    "repository": "https://github.com/zed-industries/zed",
+    "revision": "ba63a022c9a22ca66d68ef2a8f0bb9b5b0a9984d",
+    "version": "0.2.2"
+  }
+}

package/src/tsconfig.json

@@ -0,0 +1,45 @@
+{
+  "compilerOptions": {
+    "target": "ES2024",
+    "lib": ["ES2024"],
+    "module": "Preserve",
+    "moduleResolution": "Bundler",
+    "allowImportingTsExtensions": true,
+    "allowJs": true,
+    "checkJs": true,
+    "verbatimModuleSyntax": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "useUnknownInCatchVariables": true,
+    "noImplicitOverride": true,
+    "noFallthroughCasesInSwitch": true,
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "types": ["bun"],
+    "jsx": "preserve",
+    "jsxImportSource": "@bun-native/solid"
+  },
+  "include": [
+    "packages/**/*.ts",
+    "scripts/**/*.ts",
+    "scripts/**/*.mjs",
+    "tests/**/*.ts",
+    "examples/**/*.ts",
+    "benchmarks/**/*.ts",
+    "tests/native/javascript.js",
+    "experiments/**/*.ts",
+    "packages/**/*.tsx",
+    "examples/**/*.tsx",
+    "tests/**/*.tsx",
+    "benchmarks/**/*.tsx"
+  ],
+  "exclude": [
+    "**/dist/**",
+    "**/node_modules/**",
+    "tests/fixtures/**",
+    "benchmarks/electrobun/app/**"
+  ]
+}