@bloomengine/engine 0.4.3 → 0.4.4

package/README.md

@@ -5,6 +5,10 @@
 Write TypeScript. Ship native games — and now the web too.
 Bloom compiles your game to Metal, DirectX 12, Vulkan, OpenGL, and WebGPU — one codebase for every platform.
 
+> **Inspired by [raylib](https://github.com/raysan5/raylib).** Bloom models its public
+> API on raylib's — in our view one of the best API designs in gamedev. Bloom is an
+> independent implementation, not a port — [how Bloom relates to raylib »](#how-bloom-relates-to-raylib)
+
 ## Install
 
 ```bash
@@ -37,7 +41,7 @@ initWindow(800, 450, "My Game");
 
 while (!windowShouldClose()) {
   beginDrawing();
-  clearBackground(Colors.RAYWHITE);
+  clearBackground(Colors.SNOW);
   drawText("Hello, Bloom!", 190, 200, 20, Colors.DARKGRAY);
   endDrawing();
 }
@@ -53,7 +57,7 @@ import { initWindow, runGame, clearBackground, drawText, Colors } from "@bloomen
 initWindow(800, 450, "My Game");
 
 runGame((dt) => {
-  clearBackground(Colors.RAYWHITE);
+  clearBackground(Colors.SNOW);
   drawText("Hello, Bloom!", 190, 200, 20, Colors.DARKGRAY);
 });
 ```
@@ -73,6 +77,23 @@ cd dist/web && python3 -m http.server 8080
 - **Unified 2D/3D** — Shapes, textures, text, 3D models, and audio in one engine.
 - **Zero magic** — Explicit game loops, no hidden framework overhead.
 
+## How Bloom relates to raylib
+
+Bloom's public API is heavily inspired by [raylib](https://github.com/raysan5/raylib).
+raylib's API is, in our opinion, one of the best in the gamedev space — a flat library
+of plain functions, no classes, small enough to learn from a cheatsheet — so we model
+ours on it. You'll recognize the shape immediately: `initWindow`, `beginDrawing`,
+`clearBackground`, `drawText`, and modules named core / shapes / textures / text /
+audio / models.
+
+That's where the relationship ends. **Bloom's implementation is entirely independent —
+it does not link against, embed, or call raylib.** Bloom compiles TypeScript directly to
+native code via Perry, our LLVM-based AOT compiler, and renders through wgpu (Metal,
+DirectX 12, Vulkan, OpenGL, WebGPU). It is not a port or a binding — just an engine that
+admires raylib's API design. Thanks to
+[Ramon Santamaria (@raysan5)](https://github.com/raysan5) and the raylib community for
+setting the bar. ([full design rationale](docs/design-api.md))
+
 ## Modules
 
 | Module | Import | Description |

package/native/ios/Cargo.toml

@@ -11,6 +11,14 @@ crate-type = ["staticlib"]
 default = ["jolt"]
 jolt = ["bloom-shared/jolt"]
 
+# Match perry-runtime's panic strategy so the final perry-driven link
+# doesn't see two copies of rust_eh_personality (and friends) from two
+# independent Rust staticlibs. ld64.lld flags these as duplicate symbols;
+# GNU ld silently tolerates them, which is why only Apple targets break.
+# Mirrors the same setting in native/watchos/Cargo.toml.
+[profile.release]
+panic = "abort"
+
 [dependencies]
 bloom-shared = { path = "../shared", default-features = false, features = ["mp3"] }
 objc2 = "0.6"

package/native/macos/Cargo.toml

@@ -15,6 +15,14 @@ crate-type = ["staticlib"]
 default = ["jolt"]
 jolt = ["bloom-shared/jolt"]
 
+# Match perry-runtime's panic strategy so the final perry-driven link
+# doesn't see two copies of rust_eh_personality (and friends) from two
+# independent Rust staticlibs. ld64.lld flags these as duplicate symbols;
+# GNU ld silently tolerates them, which is why only Apple targets break.
+# Mirrors the same setting in native/watchos/Cargo.toml.
+[profile.release]
+panic = "abort"
+
 [dependencies]
 bloom-shared = { path = "../shared", default-features = false, features = ["mp3"] }
 image = { version = "0.25", default-features = false, features = ["hdr"] }

package/native/tvos/Cargo.toml

@@ -11,6 +11,14 @@ crate-type = ["staticlib"]
 default = ["jolt"]
 jolt = ["bloom-shared/jolt"]
 
+# Match perry-runtime's panic strategy so the final perry-driven link
+# doesn't see two copies of rust_eh_personality (and friends) from two
+# independent Rust staticlibs. ld64.lld flags these as duplicate symbols;
+# GNU ld silently tolerates them, which is why only Apple targets break.
+# Mirrors the same setting in native/watchos/Cargo.toml.
+[profile.release]
+panic = "abort"
+
 [dependencies]
 bloom-shared = { path = "../shared", default-features = false, features = ["mp3"] }
 objc2 = "0.6"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bloomengine/engine",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "Bloom Engine: native TypeScript game engine compiled by Perry",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -536,7 +536,7 @@
         },
         "linux": {
           "crate": "native/linux/",
-          "lib": "libbloom_linux_bundled.a",
+          "lib": "libbloom_linux.a",
           "libs": ["stdc++"],
           "pkgConfig": ["x11", "xi", "alsa"]
         },

package/src/core/colors.ts

@@ -5,7 +5,7 @@ import { Color as ColorType } from './types';
 // emits a `_perry_fn_src_core_colors_ts__Color` symbol that examples
 // importing `Color` from `bloom/core` can link against.
 export const Color: Record<string, ColorType> = {
-  RayWhite:   { r: 245, g: 245, b: 245, a: 255 },
+  Snow:       { r: 245, g: 245, b: 245, a: 255 },
   White:      { r: 255, g: 255, b: 255, a: 255 },
   Black:      { r: 0,   g: 0,   b: 0,   a: 255 },
   Red:        { r: 230, g: 41,  b: 55,  a: 255 },
@@ -58,6 +58,6 @@ export const Colors: Record<string, ColorType> = {
   BEIGE:      Color.Beige,
   MAGENTA:    Color.Magenta,
   VIOLET:     Color.Violet,
-  RAYWHITE:   Color.RayWhite,
+  SNOW:       Color.Snow,
   BLANK:      Color.Blank,
 };