@bornengine/engine 0.4.16

package/native/web/build.sh

@@ -0,0 +1,131 @@
+#!/bin/bash
+# Build Bloom Engine for Web
+#
+# Usage:
+#   ./native/web/build.sh [game.ts] [--output dist/]
+#
+# Steps:
+#   1. Build bloom_web.wasm via wasm-pack
+#   2. Compile game TypeScript via perry --target wasm (if provided)
+#   3. Assemble output directory with all files needed to serve
+#
+# Prerequisites:
+#   - wasm-pack: cargo install wasm-pack
+#   - perry: ../../../perry/perry/target/release/perry (or in PATH)
+#   - wasm-opt (optional): for binary size optimization
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+ENGINE_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
+WEB_CRATE="$SCRIPT_DIR"
+OUTPUT_DIR="${2:-$ENGINE_DIR/dist/web}"
+GAME_FILE="$1"
+
+# Resolve the game file to an absolute path NOW, while still in the caller's
+# working directory — the build cd's into the web crate before compiling, so a
+# relative path like `examples/pong/main.ts` would otherwise no longer resolve.
+if [ -n "$GAME_FILE" ]; then
+  if [ -f "$GAME_FILE" ]; then
+    GAME_FILE="$(cd "$(dirname "$GAME_FILE")" && pwd)/$(basename "$GAME_FILE")"
+  else
+    echo "ERROR: game file not found: $GAME_FILE"
+    exit 1
+  fi
+fi
+
+echo "=== Bloom Web Build ==="
+echo ""
+
+# 1. Build Bloom WASM via wasm-pack
+echo "[1/4] Building bloom_web.wasm..."
+cd "$WEB_CRATE"
+wasm-pack build --target web --out-dir pkg --no-typescript 2>&1 | tail -3
+echo "  Output: $WEB_CRATE/pkg/"
+
+# 2. Optimize WASM binary (if wasm-opt is available)
+if command -v wasm-opt &> /dev/null; then
+  echo "[2/4] Optimizing WASM with wasm-opt..."
+  WASM_FILE="$WEB_CRATE/pkg/bloom_web_bg.wasm"
+  ORIG_SIZE=$(wc -c < "$WASM_FILE")
+  wasm-opt -Oz "$WASM_FILE" -o "$WASM_FILE.opt"
+  mv "$WASM_FILE.opt" "$WASM_FILE"
+  OPT_SIZE=$(wc -c < "$WASM_FILE")
+  echo "  Optimized: $((ORIG_SIZE / 1024))KB → $((OPT_SIZE / 1024))KB"
+else
+  echo "[2/4] Skipping wasm-opt (not installed). Install with: cargo install wasm-opt"
+fi
+
+# 3. Compile game (if provided)
+PERRY_HTML=""
+if [ -n "$GAME_FILE" ] && [ -f "$GAME_FILE" ]; then
+  echo "[3/4] Compiling game: $GAME_FILE"
+
+  # Find perry compiler
+  PERRY=""
+  if command -v perry &> /dev/null; then
+    PERRY="perry"
+  elif [ -f "$ENGINE_DIR/../../perry/perry/target/release/perry" ]; then
+    PERRY="$ENGINE_DIR/../../perry/perry/target/release/perry"
+  else
+    echo "  ERROR: perry compiler not found. Install it or add to PATH."
+    exit 1
+  fi
+
+  # Perry emits a self-contained HTML carrying the game WASM (base64) plus its
+  # full runtime bridge (the ~280 `rt`-namespace host functions + NaN-boxing +
+  # closure dispatch). build.sh later splices the Bloom engine bootstrap into it.
+  # Use a temp dir (portable across GNU/BSD mktemp) so cleanup is a single rm.
+  PERRY_TMP="$(mktemp -d)"
+  PERRY_HTML="$PERRY_TMP/game.html"
+  $PERRY "$GAME_FILE" --target wasm -o "$PERRY_HTML"
+  echo "  Game compiled to WASM ($PERRY_HTML)"
+else
+  echo "[3/4] No game file specified, skipping game compilation"
+fi
+
+# 4. Assemble output directory
+echo "[4/4] Assembling output..."
+mkdir -p "$OUTPUT_DIR"
+
+# Copy Bloom WASM package
+cp -r "$WEB_CRATE/pkg" "$OUTPUT_DIR/pkg"
+
+# Engine bootstrap + Jolt bridge are needed by both the game and engine-only pages.
+cp "$WEB_CRATE/bloom_glue.js" "$OUTPUT_DIR/bloom_glue.js"
+cp "$WEB_CRATE/jolt_bridge.js" "$OUTPUT_DIR/jolt_bridge.js"
+
+if [ -n "$PERRY_HTML" ]; then
+  # Game build: splice the Bloom bootstrap into Perry's HTML and gate the game's
+  # bootPerryWasm() call on engine readiness → dist/web/index.html.
+  python3 "$WEB_CRATE/splice_game.py" "$PERRY_HTML" "$OUTPUT_DIR/index.html"
+  rm -rf "$PERRY_TMP"
+  echo "  Spliced game + engine into index.html"
+else
+  # No game: ship the engine-only standalone page.
+  cp "$WEB_CRATE/index.html" "$OUTPUT_DIR/index.html"
+  echo "  Copied engine-only index.html (no game compiled)"
+fi
+
+# Copy game assets (if game directory has an assets/ folder)
+if [ -n "$GAME_FILE" ]; then
+  GAME_DIR="$(dirname "$(realpath "$GAME_FILE")")"
+  if [ -d "$GAME_DIR/assets" ]; then
+    cp -r "$GAME_DIR/assets" "$OUTPUT_DIR/assets"
+    echo "  Copied assets/ directory"
+  fi
+fi
+
+# Calculate total size
+TOTAL_SIZE=$(du -sh "$OUTPUT_DIR" | cut -f1)
+WASM_SIZE=$(wc -c < "$OUTPUT_DIR/pkg/bloom_web_bg.wasm" 2>/dev/null || echo "0")
+
+echo ""
+echo "=== Build Complete ==="
+echo "  Output: $OUTPUT_DIR"
+echo "  WASM size: $((WASM_SIZE / 1024))KB"
+echo "  Total size: $TOTAL_SIZE"
+echo ""
+echo "To serve locally:"
+echo "  cd $OUTPUT_DIR && python3 -m http.server 8080"
+echo "  Open http://localhost:8080"

package/native/web/index.html

@@ -0,0 +1,35 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Bloom Engine</title>
+  <style>
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    html, body { width: 100vw; height: 100vh; overflow: hidden; background: #000; }
+    #bloom-canvas { position: fixed; inset: 0; width: 100vw; height: 100vh; display: block; }
+    #loading { position: absolute; top: 50%; left: 50%; transform: translate(-50%, -50%);
+               color: #fff; font-family: monospace; font-size: 14px; }
+  </style>
+</head>
+<body>
+  <canvas id="bloom-canvas"></canvas>
+  <div id="loading">Loading Bloom Engine...</div>
+
+  <!--
+    Engine-only page (no compiled game). `build.sh` produces a different page
+    for game builds: it splices this same bootstrap into Perry's self-contained
+    WASM HTML and gates the game's bootPerryWasm() call on __bloomReady.
+
+    The promise is created here, synchronously during parse, so any later
+    boot script can register `.then()` before the deferred module below runs.
+  -->
+  <script>
+    window.__bloomReady = new Promise((resolve, reject) => {
+      window.__bloomReadyResolve = resolve;
+      window.__bloomReadyReject = reject;
+    });
+  </script>
+  <script type="module" src="./bloom_glue.js"></script>
+</body>
+</html>