@bornengine/jolt-prebuilt

Prebuilt JoltPhysics + bloom_jolt static libraries for every (os, arch) BornEngine targets.

Why this exists

@bornengine/engine consumes JoltPhysics for its rigid/soft body physics. Compiling Jolt from C++ via cmake on a consumer's first build takes 5–15 minutes cold. This package ships the libraries prebuilt so consumers skip that step entirely.

Layout

lib/
  macos-arm64/      Apple Silicon
  macos-x64/        Intel Mac
  ios-arm64/        iOS device
  ios-arm64-sim/    iOS simulator on Apple Silicon
  ios-x64-sim/      iOS simulator on Intel
  tvos-arm64/       tvOS device
  tvos-arm64-sim/
  tvos-x64-sim/
  watchos-arm64/    watchOS device
  watchos-arm64-sim/
  watchos-x64-sim/
  linux-x64/
  linux-arm64/
  win32-x64/
  android-arm64/
  android-armv7/
  android-x64/

Each variant directory contains libJolt.a (or Jolt.lib on Windows) and libbloom_jolt.a.

How @bornengine/engine finds it

The engine's native/shared/build.rs walks up from CARGO_MANIFEST_DIR looking for node_modules/@bornengine/jolt-prebuilt/lib/<os>-<arch>/, then the legacy @bloomengine/jolt-prebuilt path for existing Bloom Engine installs. This npm package contains the compiled static libraries; the JoltPhysics source itself is maintained separately as a Git submodule in the BornEngine repository. If no prebuilt is found (or BLOOM_JOLT_FROM_SOURCE=1 is set), a source build requires that submodule to be present in a BornEngine checkout.

Build / publish

Built by .github/workflows/release.yml on each tag push — a matrix job per platform produces the libraries on the appropriate native runner (macos-14 for Apple targets, ubuntu-22.04 for Linux/Android, windows-latest for Windows) and uploads them as artifacts. A final assembly job collects every artifact into this package's lib/ tree and publishes via OIDC trusted publishing.

Each engine release pins a compatible @bornengine/jolt-prebuilt version in package.json. The prebuilt package is versioned independently, so its version may differ from the engine's version.

Licenses

The BornEngine shim and its upstream Bloom Engine copyright notice are covered by the MIT license in LICENSE. JoltPhysics is also distributed under MIT; see JOLT-LICENSE for its original copyright and license notice.