@bun-native/cli 0.0.0-stage → 0.33.1

package/src/scripts/native.ts

@@ -0,0 +1,237 @@
+#!/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 { cliContext, releaseVersion, type CliContext } from './native/context.ts'
+// Command modules load lazily: --help and the light commands never pay for the
+// package-set, archive and hashing modules they do not use.
+
+const repository = resolve(import.meta.dir, '..')
+const usage = (cli: string) => `Bun Native application tooling
+
+  ${cli} 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
+  ${cli} dev apps/my-app --host /absolute/path/to/bun-native-host|auto [--watch]
+  ${cli} build apps/my-app --host /absolute/path/to/bun-native-host|auto --host-profile dev|release [--outdir directory] [--bundle-id reverse.dns.id]
+  ${cli} check apps/my-app
+  ${cli} format apps/my-app [--check]
+  ${cli} lint apps/my-app
+  ${cli} doctor [apps/my-app] [--host /absolute/path/to/bun-native-host|auto]
+  ${cli} host install [--version x.y.z] [--force]
+
+In a checkout, projects use checkout dependencies; an npm-installed CLI creates projects on its own
+@bun-native release. --packages selects a standalone local package set instead.
+Standalone scripts use their own installed CLI. Native hosts are supplied explicitly: an absolute path,
+or auto for this CLI 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 the checkout's .bun-native/hosts or the user cache. No other command downloads a host; none runs Cargo.
+See docs/developer-tooling.md.`
+
+async function resolveHost(context: CliContext, value: string | undefined): Promise<string> {
+  if (value !== 'auto') {
+    const { prebuiltHost } = await import('./native/host.ts')
+    return prebuiltHost(value)
+  }
+  const { installReleaseHost } = await import('./native/host-download.ts')
+  return installReleaseHost({ version: releaseVersion(context), cache: context.hostCache })
+}
+
+async function main(args: string[]): Promise<void> {
+  const context = await cliContext(repository)
+  if (args.length === 0 || (args.length === 1 && ['--help', '-h'].includes(args[0]!))) {
+    console.log(usage(context.command))
+    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')
+    // An npm-installed CLI creates a project on the same registry release.
+    const registry =
+      values.packages === undefined && context.mode === 'package'
+        ? (await (await import('./native/registry-project.ts')).installedTemplates(repository))[
+            values.framework
+          ]
+        : undefined
+    const { createProject } = await import('./native/project.ts')
+    const path = await createProject(
+      repository,
+      positionals[0]!,
+      values.framework,
+      values.language,
+      values.packages,
+      registry
+    )
+    console.log(`Created ${values.framework} ${values.language} project: ${path}`)
+    console.log(
+      values.packages || registry
+        ? '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 { readProject } = await import('./native/project.ts')
+    const project = await readProject(repository, positionals[0]!, { verification: 'stamp' })
+    const { checkProject, formatProject } = await import('./native/quality.ts')
+    // The steps run concurrently; their reports print in this fixed order.
+    const steps =
+      command === 'format'
+        ? [await formatProject(project, values.check === true)]
+        : (
+            await Promise.all([
+              command === 'check' ? checkProject(project) : [],
+              // Only check and lint load the CLI's pinned oxlint; format never depends on it.
+              import('./native/lint.ts').then(({ lintProject }) => lintProject(project)),
+            ])
+          ).flat()
+    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: ${context.command} host install [--version x.y.z] [--force]`)
+    const { installReleaseHost } = await import('./native/host-download.ts')
+    const host = await installReleaseHost({
+      version: releaseVersion(context, values.version),
+      cache: context.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(context, '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(context.command)}`)
+  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(
+    context,
+    typeof values['host'] === 'string' ? values['host'] : undefined
+  )
+  const { readProject } = await import('./native/project.ts')
+  // A build always re-verifies the package set it ships; dev may reuse the stamp.
+  const project = await readProject(repository, positionals[0]!, {
+    verification: command === 'build' ? 'full' : 'stamp',
+  })
+  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/toolchain.json

@@ -0,0 +1,74 @@
+{
+  "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": [
+      "--no-install",
+      "compile",
+      "--no-script",
+      "--production",
+      "--explain=json"
+    ],
+    "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,
+        "executable": {
+          "bytes": 140680448,
+          "sha256": "8f55345e8a878f2b4f9b233184ffa424fdd67667fa70c16b1f11a1ae8387e9ab"
+        }
+      },
+      "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/**"
+  ]
+}