@downdraft/engine 0.1.0 → 0.1.1

package/README.md

@@ -0,0 +1,33 @@
+# `@downdraft/engine`
+
+Downdraft engine — a native-runtime game engine (winit + wgpu, no Electron, no browser shell). The JS host is interchangeable: Bun, Node, and Deno all run the same engine through a shared FFI/device layer.
+
+Everything the engine ships is exposed as **subpath exports** of this one package:
+
+- `@downdraft/engine` — core index (ECS, render loop, HostAPI types)
+- `@downdraft/engine/app/renderer` — `startGame()` / `bootstrapGame()` game bootstrap
+- `@downdraft/engine/libraries/<name>` — engine building blocks (physics, audio, models, water, weather, navmesh, gpu-kernels, …)
+- `@downdraft/engine/modules/<name>` — opt-in feature modules with lifecycle + typed DI (movement-2d/3d, terrain, sailing, camera-controls, devtools, …)
+- `@downdraft/engine/platform/…` — runtime adapters (native surface, FFI, SAB channels)
+
+## Install
+
+```sh
+bun add @downdraft/engine @downdraft/platform-native @downdraft/cli
+```
+
+`@downdraft/platform-native` supplies the native window/GPU device layer (prebuilt binaries per OS/arch arrive via optional dependencies).
+
+## Quick start
+
+```ts
+import { startGame } from "@downdraft/engine/app/renderer";
+
+startGame({
+  renderer: (canvas) => new WebGPURenderer(canvas),
+  sim: (seed) => new SimWebWorker(seed?.libraryBuffers),
+  simConfig: { seed: 12345 },
+});
+```
+
+See the [Downdraft engine repository](https://github.com/knackstedt/downdraft) for architecture docs and examples.

package/core/src/platform/runtime.ts

@@ -11,6 +11,15 @@
 /** True when running under Bun (typeof Bun !== "undefined"). */
 export const isBun: boolean = typeof (globalThis as any).Bun !== "undefined";
 
+/**
+ * True inside a `bun build --compile` binary. In compiled executables
+ * `Bun.main` is `/$bunfs/root/<entry>` instead of a real filesystem path —
+ * this is a global and stays correct even in bundles where a packager has
+ * rewritten a module's own `import.meta.url` to the staged asset tree.
+ */
+export const isCompiledBinary: boolean =
+  isBun && /^\/\$bunfs\//.test((globalThis as any).Bun?.main ?? "");
+
 /**
  * Dev mode. Resolved from (in priority order):
  *   1. DOWNDRAFT_DEV=1 env var

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downdraft/engine",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/knackstedt/downdraft.git",