rngine 0.4.2 → 0.6.0

package/README.md

@@ -72,7 +72,7 @@ export default function App() {
 
 **Entities** are the objects in your game world. Each entity has a position, size, color, and velocity. See [`Entity`](./src/nativeTypes.ts).
 
-**Systems** define your game logic. Each system optionally declares which entities it cares about via `entities`, which collision pairs to watch via `collisions`, or both. Systems run every tick receiving the resolved entities and any active collisions. See [`System`](./src/nativeTypes.ts).
+**Systems** define your game logic. Each system optionally declares which entities it cares about via `entities`, which collision pairs to watch via `collisions`, or both. Systems run every tick receiving the resolved entities and any active collisions. See [`System`](./src/types.ts).
 
 **Screen** defines the viewport dimensions and background color. Entities outside the screen bounds are automatically clipped. See [`Screen`](./src/nativeTypes.ts).
 

package/android/src/main/cpp/GameLoopJNI.cpp

@@ -1,36 +1,93 @@
+#include "ColorUtils.hpp"
 #include "GameLoop.hpp"
+#include <cstdint>
 #include <jni.h>
+#include <mutex>
 
 extern "C" {
-JNIEXPORT jobject JNICALL
-Java_com_margelo_nitro_rngine_GameView_getRectsSnapshot(JNIEnv *env, jobject) {
-  auto rects =
-      margelo::nitro::rngine::GameLoop::getInstance().getRectsSnapshot();
-  const size_t size = rects.size() * margelo::nitro::rngine::RECT_SIZE;
-
-  static std::vector<uint8_t> buffer;
-  buffer.resize(size);
-
-  uint8_t *data = buffer.data();
-
-  for (const auto &rect : rects) {
-    memcpy(data, &rect.left, sizeof(float));
-    data += sizeof(float);
-    memcpy(data, &rect.right, sizeof(float));
-    data += sizeof(float);
-    memcpy(data, &rect.top, sizeof(float));
-    data += sizeof(float);
-    memcpy(data, &rect.bottom, sizeof(float));
-    data += sizeof(float);
-    memcpy(data, &rect.progress, sizeof(float));
-    data += sizeof(float);
-    memcpy(data, &rect.color, sizeof(uint32_t));
-    data += sizeof(uint32_t);
-    memcpy(data, &rect.asset, sizeof(int32_t));
-    data += sizeof(int32_t);
+JNIEXPORT jbyteArray JNICALL
+Java_com_margelo_nitro_rngine_GameView_getSnapshot(JNIEnv *env, jobject) {
+  auto &gameLoop = margelo::nitro::rngine::GameLoop::getInstance();
+  auto &snapshotMutex = gameLoop.getSnapshotMutexInternal();
+
+  std::lock_guard<std::mutex> snapshotLock(snapshotMutex);
+  auto &screenSnapshot = gameLoop.getScreenSnapshotInternal();
+  auto &entitiesSnapshot = gameLoop.getEntitiesSnapshotInternal();
+
+  std::vector<uint8_t> buffer;
+
+  auto writeFloat = [&](float v) {
+    const auto *bytes = reinterpret_cast<const uint8_t *>(&v);
+    buffer.insert(buffer.end(), bytes, bytes + sizeof(float));
+  };
+  auto writeI32 = [&](int32_t v) {
+    const auto *bytes = reinterpret_cast<const uint8_t *>(&v);
+    buffer.insert(buffer.end(), bytes, bytes + sizeof(int32_t));
+  };
+  auto writeU32 = [&](uint32_t v) {
+    const auto *bytes = reinterpret_cast<const uint8_t *>(&v);
+    buffer.insert(buffer.end(), bytes, bytes + sizeof(uint32_t));
+  };
+
+  const auto screenSnapshotWidth = static_cast<float>(screenSnapshot.width);
+  const auto screenSnapshotHeight = static_cast<float>(screenSnapshot.height);
+  const auto screenSnapshotColor =
+      margelo::nitro::rngine::parseHexColor(screenSnapshot.color);
+  const auto screenSnapshotAsset =
+      static_cast<int32_t>(screenSnapshot.asset.value_or(0));
+
+  writeFloat(screenSnapshotWidth);
+  writeFloat(screenSnapshotHeight);
+  writeU32(screenSnapshotColor);
+  writeI32(screenSnapshotAsset);
+
+  if (screenSnapshotAsset < 0) {
+    writeFloat(static_cast<float>(screenSnapshot.progress.value_or(0)));
+  }
+
+  for (const auto &[_, entitySnapshot] : entitiesSnapshot) {
+    const auto entitySnapshotLeft =
+        static_cast<float>(entitySnapshot.px - (entitySnapshot.width / 2));
+    const auto entitySnapshotRight =
+        static_cast<float>(entitySnapshot.px + (entitySnapshot.width / 2));
+    const auto entitySnapshotTop =
+        static_cast<float>(entitySnapshot.py - (entitySnapshot.height / 2));
+    const auto entitySnapshotBottom =
+        static_cast<float>(entitySnapshot.py + (entitySnapshot.height / 2));
+
+    if (entitySnapshotRight < 0 || entitySnapshotLeft > screenSnapshot.width ||
+        entitySnapshotBottom < 0 || entitySnapshotTop > screenSnapshot.height) {
+      continue;
+    }
+
+    const auto entitySnapshotColor =
+        margelo::nitro::rngine::parseHexColor(entitySnapshot.color);
+    const auto entitySnapshotAsset =
+        static_cast<int32_t>(entitySnapshot.asset.value_or(0));
+
+    writeFloat(entitySnapshotLeft);
+    writeFloat(entitySnapshotRight);
+    writeFloat(entitySnapshotTop);
+    writeFloat(entitySnapshotBottom);
+    writeU32(entitySnapshotColor);
+    writeI32(entitySnapshotAsset);
+
+    if (entitySnapshotAsset < 0) {
+      writeFloat(static_cast<float>(entitySnapshot.progress.value_or(0)));
+    }
   }
 
-  return env->NewDirectByteBuffer(buffer.data(), (jlong)size);
+  auto bufferSize = static_cast<jsize>(buffer.size());
+  jbyteArray result = env->NewByteArray(bufferSize);
+
+  if (result == nullptr) {
+    return nullptr;
+  }
+
+  env->SetByteArrayRegion(result, 0, bufferSize,
+                          reinterpret_cast<const jbyte *>(buffer.data()));
+
+  return result;
 }
 
 JNIEXPORT void JNICALL

package/android/src/main/java/com/margelo/nitro/rngine/GameAssets.kt

@@ -4,7 +4,9 @@ import android.util.Log
 import com.airbnb.lottie.LottieCompositionFactory
 import com.airbnb.lottie.LottieDrawable
 import com.caverock.androidsvg.SVG
+import com.margelo.nitro.core.Promise
 import java.net.URL
+import com.margelo.nitro.NitroModules
 
 class GameAssets : HybridGameAssetsSpec() {
   private external fun registerLottieDuration(id: Double, duration: Double)
@@ -18,30 +20,42 @@ class GameAssets : HybridGameAssetsSpec() {
     return id.toInt() in assetCache
   }
 
-  override fun registerSvg(id: Double, uri: String) {
-    try {
-      val stream = URL(uri).openStream()
-      assetCache[id.toInt()] = Asset.Svg(SVG.getFromInputStream(stream).renderToPicture())
-      Log.d("GameAssets", "assetCache: $assetCache")
-    } catch (e: Exception) {
-      Log.e("GameAssets", "Failed to parse SVG: $uri", e)
+  override fun registerSvg(id: Double, uri: String): Promise<Unit> {
+    return Promise.async {
+      try {
+        val stream = if (uri.startsWith("http://") || uri.startsWith("https://")) {
+          URL(uri).openStream()
+        } else {
+          val context = NitroModules.applicationContext ?: throw Error("No Context available!")
+          val resId = context.resources.getIdentifier(uri, "raw", context.packageName)
+          if (resId == 0) {
+            throw IllegalStateException("Could not resolve drawable resource for asset: $uri")
+          }
+          context.resources.openRawResource(resId)
+        }
+        assetCache[id.toInt()] = Asset.Svg(SVG.getFromInputStream(stream).renderToPicture())
+        Log.d("GameAssets", "assetCache: $assetCache")
+      } catch (e: Exception) {
+        Log.e("GameAssets", "Failed to parse SVG: $uri", e)
+        throw e
+      }
     }
   }
 
-  override fun registerLottie(id: Double, json: String) {
-    try {
-      val composition = LottieCompositionFactory.fromJsonStringSync(json, null).value
-      if (composition == null) {
-        Log.e("GameAssets", "Failed to parse Lottie JSON for id: $id")
-        return
+  override fun registerLottie(id: Double, json: String): Promise<Unit> {
+    return Promise.async {
+      try {
+        val composition = LottieCompositionFactory.fromJsonStringSync(json, null).value
+          ?: throw IllegalStateException("Failed to parse Lottie JSON for id: $id")
+        val drawable = LottieDrawable()
+        drawable.composition = composition
+        assetCache[id.toInt()] = Asset.Lottie(drawable)
+        registerLottieDuration(id, composition.duration.toDouble() / 1000)
+        Log.d("GameAssets", "assetCache: $assetCache")
+      } catch (e: Exception) {
+        Log.e("GameAssets", "Failed to register Lottie: $id", e)
+        throw e
       }
-      val drawable = LottieDrawable()
-      drawable.composition = composition
-      assetCache[id.toInt()] = Asset.Lottie(drawable)
-      registerLottieDuration(id, composition.duration.toDouble() / 1000)
-      Log.d("GameAssets", "assetCache: $assetCache")
-    } catch (e: Exception) {
-      Log.e("GameAssets", "Failed to register Lottie: $id", e)
     }
   }
 }

package/android/src/main/java/com/margelo/nitro/rngine/GameView.kt

@@ -4,10 +4,8 @@ import android.content.Context
 import android.graphics.Color
 import android.graphics.Paint
 import android.util.AttributeSet
-import android.util.Log
 import android.view.SurfaceView
 import android.view.View
-import java.nio.ByteBuffer
 import androidx.core.graphics.withTranslation
 import androidx.core.graphics.withClip
 
@@ -20,7 +18,7 @@ class GameView(
   attrs,
   defStyleAttr,
 ) {
-  private external fun getRectsSnapshot(): ByteBuffer
+  private external fun getSnapshot(): ByteArray
   var onAttached: () -> Unit = {}
   var onDetached: () -> Unit = {}
 
@@ -29,6 +27,48 @@ class GameView(
     style = Paint.Style.FILL
   }
 
+  private fun drawRenderable(
+    canvas: android.graphics.Canvas,
+    left: Float,
+    top: Float,
+    right: Float,
+    bottom: Float,
+    color: Int,
+    asset: Int,
+    progress: Float?,
+    clampedLeft: Float = left,
+    clampedTop: Float = top,
+    clampedRight: Float = right,
+    clampedBottom: Float = bottom,
+  ) {
+    paint.color = color
+    canvas.drawRect(clampedLeft, clampedTop, clampedRight, clampedBottom, paint)
+
+    canvas.withClip(clampedLeft, clampedTop, clampedRight, clampedBottom) {
+      withTranslation(left, top) {
+        when (val resolvedAsset = GameAssets.getAsset(asset)) {
+          is Asset.Svg -> {
+            scale(
+              (right - left) / resolvedAsset.picture.width,
+              (bottom - top) / resolvedAsset.picture.height
+            )
+            drawPicture(resolvedAsset.picture)
+          }
+
+          is Asset.Lottie -> {
+            progress?.let {
+              resolvedAsset.drawable.progress = it
+            }
+            resolvedAsset.drawable.setBounds(0, 0, (right - left).toInt(), (bottom - top).toInt())
+            resolvedAsset.drawable.draw(canvas)
+          }
+
+          null -> {}
+        }
+      }
+    }
+  }
+
   init {
     addOnAttachStateChangeListener(
       object : OnAttachStateChangeListener {
@@ -40,61 +80,53 @@ class GameView(
   fun drawFrame() {
     if (!holder.surface.isValid) return
     val canvas = holder.lockCanvas() ?: return
+    val snapshot = SnapshotSerializer.decode(getSnapshot())
 
-    val rects = RectSerializer.decode(getRectsSnapshot())
-
-    val worldRect = rects.first()
-    val scaleX = canvas.width / worldRect.right
-    val scaleY = canvas.height / worldRect.bottom
+    val scaleX = canvas.width / snapshot.screen.width
+    val scaleY = canvas.height / snapshot.screen.height
     val scale = minOf(scaleX, scaleY)
 
-    val offsetX = (canvas.width - worldRect.right * scale) / 2f
-    val offsetY = (canvas.height - worldRect.bottom * scale) / 2f
+    val screenLeft = (canvas.width - snapshot.screen.width * scale) / 2f
+    val screenTop = (canvas.height - snapshot.screen.height * scale) / 2f
+    val screenRight = screenLeft + snapshot.screen.width * scale
+    val screenBottom = screenTop + snapshot.screen.height * scale
+
+    drawRenderable(
+      canvas,
+      screenLeft,
+      screenTop,
+      screenRight,
+      screenBottom,
+      snapshot.screen.color,
+      snapshot.screen.asset,
+      snapshot.screen.progress,
+    )
 
-    rects.forEach { rect ->
-      val left = rect.left * scale + offsetX
-      val top = rect.top * scale + offsetY
-      val right = rect.right * scale + offsetX
-      val bottom = rect.bottom * scale + offsetY
+    snapshot.rects.forEach { rect ->
+      val left = rect.left * scale + screenLeft
+      val top = rect.top * scale + screenTop
+      val right = rect.right * scale + screenLeft
+      val bottom = rect.bottom * scale + screenTop
 
-      val clampedLeft = left.coerceAtLeast(offsetX)
-      val clampedTop = top.coerceAtLeast(offsetY)
-      val clampedRight = right.coerceAtMost(offsetX + worldRect.right * scale)
-      val clampedBottom = bottom.coerceAtMost(offsetY + worldRect.bottom * scale)
+      val clampedLeft = left.coerceAtLeast(screenLeft)
+      val clampedTop = top.coerceAtLeast(screenTop)
+      val clampedRight = right.coerceAtMost(screenLeft + snapshot.screen.width * scale)
+      val clampedBottom = bottom.coerceAtMost(screenTop + snapshot.screen.height * scale)
 
-      paint.color = rect.color
-      canvas.drawRect(
+      drawRenderable(
+        canvas,
+        left,
+        top,
+        right,
+        bottom,
+        rect.color,
+        rect.asset,
+        rect.progress,
         clampedLeft,
         clampedTop,
         clampedRight,
-        clampedBottom,
-        paint
+        clampedBottom
       )
-      when(val asset = GameAssets.getAsset(rect.asset)){
-        is Asset.Svg -> {
-          canvas.withClip(clampedLeft, clampedTop, clampedRight, clampedBottom) {
-            withTranslation(left, top) {
-              scale(
-                (right - left) / asset.picture.width,
-                (bottom - top) / asset.picture.height
-              )
-              drawPicture(asset.picture)
-            }
-          }
-        }
-
-        is Asset.Lottie -> {
-          canvas.withClip(clampedLeft, clampedTop, clampedRight, clampedBottom) {
-            withTranslation(left, top) {
-              asset.drawable.progress = rect.progress
-              asset.drawable.setBounds(0, 0, (right - left).toInt(), (bottom - top).toInt())
-              asset.drawable.draw(canvas)
-            }
-          }
-        }
-
-        null -> {}
-      }
     }
     holder.unlockCanvasAndPost(canvas)
   }

package/android/src/main/java/com/margelo/nitro/rngine/Rect.kt

@@ -5,7 +5,7 @@ data class Rect(
   val right: Float,
   val top: Float,
   val bottom: Float,
-  val progress: Float,
   val color: Int,
-  val asset: Int
+  val asset: Int,
+  val progress: Float?,
 )

package/android/src/main/java/com/margelo/nitro/rngine/Screen.kt

@@ -0,0 +1,9 @@
+package com.margelo.nitro.rngine
+
+data class Screen(
+  val width: Float,
+  val height: Float,
+  val color: Int,
+  val asset: Int,
+  val progress: Float?,
+)

package/android/src/main/java/com/margelo/nitro/rngine/Snapshot.kt

@@ -0,0 +1,3 @@
+package com.margelo.nitro.rngine
+
+data class Snapshot(val screen: Screen, val rects: List<Rect>)

package/android/src/main/java/com/margelo/nitro/rngine/SnapshotSerializer.kt

@@ -0,0 +1,33 @@
+package com.margelo.nitro.rngine
+
+import java.nio.ByteBuffer
+import java.nio.ByteOrder
+
+object SnapshotSerializer {
+  fun decode(bytes: ByteArray): Snapshot {
+    val buffer = ByteBuffer.wrap(bytes).order(ByteOrder.nativeOrder())
+
+    val width = buffer.float
+    val height = buffer.float
+    val color = buffer.int
+    val asset = buffer.int
+    val progress = if (asset < 0) buffer.float else null
+
+    val screen = Screen(width, height, color, asset, progress)
+    val rects = ArrayList<Rect>()
+
+    while (buffer.remaining() >= 24) {
+      val left = buffer.float
+      val right = buffer.float
+      val top = buffer.float
+      val bottom = buffer.float
+      val color = buffer.int
+      val asset = buffer.int
+      val progress = if (asset < 0) buffer.float else null
+
+      rects.add(Rect(left, right, top, bottom, color, asset, progress))
+    }
+
+    return Snapshot(screen, rects)
+  }
+}

package/lib/module/GameAssets.js

@@ -0,0 +1,41 @@
+"use strict";
+
+import { Image } from 'react-native';
+import { gameAssets } from "./GameAssets.nitro.js";
+const assetCache = new WeakMap();
+let nextId = -1;
+const loadAsset = async asset => {
+  switch (typeof asset) {
+    case 'object':
+      if (asset === null) {
+        throw new Error('loadAssets: asset cannot be null');
+      }
+      if (assetCache.has(asset)) {
+        return assetCache.get(asset);
+      }
+      const assetId = nextId--;
+      assetCache.set(asset, assetId);
+      await gameAssets.registerLottie(assetId, JSON.stringify(asset));
+      return assetId;
+    case 'number':
+      if (gameAssets.isAssetRegistered(asset)) {
+        return asset;
+      }
+      const assetUri = Image.resolveAssetSource(asset)?.uri;
+      if (!assetUri) {
+        throw new Error(`loadAssets: could not resolve asset URI for ${asset}`);
+      }
+      await gameAssets.registerSvg(asset, assetUri);
+      return asset;
+  }
+  throw new Error(`loadAssets: unsupported asset type "${typeof asset}"`);
+};
+export const loadAssets = async assets => {
+  const keys = Object.keys(assets);
+  const result = {};
+  for (const key of keys) {
+    result[key] = await loadAsset(assets[key]);
+  }
+  return result;
+};
+//# sourceMappingURL=GameAssets.js.map

package/lib/module/GameAssets.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Image","gameAssets","assetCache","WeakMap","nextId","loadAsset","asset","Error","has","get","assetId","set","registerLottie","JSON","stringify","isAssetRegistered","assetUri","resolveAssetSource","uri","registerSvg","loadAssets","assets","keys","Object","result","key"],"sourceRoot":"../../src","sources":["GameAssets.ts"],"mappings":";;AAAA,SAASA,KAAK,QAAQ,cAAc;AACpC,SAASC,UAAU,QAAQ,uBAAoB;AAE/C,MAAMC,UAAU,GAAG,IAAIC,OAAO,CAAiB,CAAC;AAChD,IAAIC,MAAM,GAAG,CAAC,CAAC;AAEf,MAAMC,SAAS,GAAG,MAAOC,KAAc,IAAK;EAC1C,QAAQ,OAAOA,KAAK;IAClB,KAAK,QAAQ;MACX,IAAIA,KAAK,KAAK,IAAI,EAAE;QAClB,MAAM,IAAIC,KAAK,CAAC,kCAAkC,CAAC;MACrD;MACA,IAAIL,UAAU,CAACM,GAAG,CAACF,KAAK,CAAC,EAAE;QACzB,OAAOJ,UAAU,CAACO,GAAG,CAACH,KAAK,CAAC;MAC9B;MACA,MAAMI,OAAO,GAAGN,MAAM,EAAE;MACxBF,UAAU,CAACS,GAAG,CAACL,KAAK,EAAEI,OAAO,CAAC;MAC9B,MAAMT,UAAU,CAACW,cAAc,CAACF,OAAO,EAAEG,IAAI,CAACC,SAAS,CAACR,KAAK,CAAC,CAAC;MAC/D,OAAOI,OAAO;IAEhB,KAAK,QAAQ;MACX,IAAIT,UAAU,CAACc,iBAAiB,CAACT,KAAK,CAAC,EAAE;QACvC,OAAOA,KAAK;MACd;MACA,MAAMU,QAAQ,GAAGhB,KAAK,CAACiB,kBAAkB,CAACX,KAAK,CAAC,EAAEY,GAAG;MACrD,IAAI,CAACF,QAAQ,EAAE;QACb,MAAM,IAAIT,KAAK,CAAC,+CAA+CD,KAAK,EAAE,CAAC;MACzE;MACA,MAAML,UAAU,CAACkB,WAAW,CAACb,KAAK,EAAEU,QAAQ,CAAC;MAC7C,OAAOV,KAAK;EAChB;EAEA,MAAM,IAAIC,KAAK,CAAC,uCAAuC,OAAOD,KAAK,GAAG,CAAC;AACzE,CAAC;AAED,OAAO,MAAMc,UAAU,GAAG,MACxBC,MAAS,IAC+B;EACxC,MAAMC,IAAI,GAAGC,MAAM,CAACD,IAAI,CAACD,MAAM,CAAgB;EAC/C,MAAMG,MAAM,GAAG,CAAC,CAA+B;EAE/C,KAAK,MAAMC,GAAG,IAAIH,IAAI,EAAE;IACtBE,MAAM,CAACC,GAAG,CAAC,GAAG,MAAMpB,SAAS,CAACgB,MAAM,CAACI,GAAG,CAAC,CAAC;EAC5C;EAEA,OAAOD,MAAM;AACf,CAAC","ignoreList":[]}

package/lib/module/GameEngine.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import { getHostComponent } from 'react-native-nitro-modules';
-const GameEngineConfig = require('../nitrogen/generated/shared/json/GameEngineConfig.json');
+import GameEngineConfig from '../nitrogen/generated/shared/json/GameEngineConfig.json';
 /**
  * A game engine view component that renders the game world.
  * Size it using the style prop like any other React Native view.

package/lib/module/GameEngine.js.map

@@ -1 +1 @@
-{"version":3,"names":["getHostComponent","GameEngineConfig","require"],"sourceRoot":"../../src","sources":["GameEngine.tsx"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,4BAA4B;AAC7D,MAAMC,gBAAgB,GAAGC,OAAO,CAAC,yDAAyD,CAAC;AAG3F;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAeF,gBAAgB,CAC7B,YAAY,EACZ,MAAMC,gBACR,CAAC","ignoreList":[]}
+{"version":3,"names":["getHostComponent","GameEngineConfig"],"sourceRoot":"../../src","sources":["GameEngine.tsx"],"mappings":";;AAAA,SAASA,gBAAgB,QAAQ,4BAA4B;AAC7D,OAAOC,gBAAgB,MAAM,yDAAyD;AAGtF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,eAAeD,gBAAgB,CAC7B,YAAY,EACZ,MAAMC,gBACR,CAAC","ignoreList":[]}

package/lib/module/GameMethods.js

@@ -1,6 +1,37 @@
 "use strict";
 
 import { gameMethods } from "./GameMethods.nitro.js";
+/** Sets up the game engine with the given configuration. Call this before anything else. */
+export const configure = ({
+  tickRate,
+  screen,
+  entities = [],
+  systems = [],
+  paused = true
+}) => {
+  let nativeSystems = [];
+  for (const system of systems) {
+    nativeSystems.push({
+      entities: system.entities,
+      collisions: system.collisions,
+      onTick: (e, c) => {
+        const start = Date.now();
+        system.onTick(e, c);
+        const finish = Date.now();
+        return finish - start;
+      }
+    });
+  }
+  gameMethods.setTickRate(tickRate);
+  gameMethods.setScreen(screen);
+  gameMethods.setEntities(entities);
+  gameMethods.setSystems(nativeSystems);
+  if (paused) {
+    gameMethods.pause();
+  } else {
+    gameMethods.resume();
+  }
+};
 
 /** Pauses the game loop. Systems will stop running. */
 export const pause = () => gameMethods.pause();
@@ -8,6 +39,18 @@ export const pause = () => gameMethods.pause();
 /** Resumes the game loop. */
 export const resume = () => gameMethods.resume();
 
+/** Spawns one or more entities into the world. Skips duplicates by id. */
+export const spawn = entities => {
+  const entityArray = Array.isArray(entities) ? entities : [entities];
+  gameMethods.spawn(entityArray);
+};
+
 /** Removes an entity or all entities matching the given id prefix from the world. */
 export const despawn = id => gameMethods.despawn(id);
+
+/** Updates one or more entities. Only the provided fields are changed. */
+export const update = updates => {
+  const entityUpdateArray = Array.isArray(updates) ? updates : [updates];
+  gameMethods.update(entityUpdateArray);
+};
 //# sourceMappingURL=GameMethods.js.map

package/lib/module/GameMethods.js.map

@@ -1 +1 @@
-{"version":3,"names":["gameMethods","pause","resume","despawn","id"],"sourceRoot":"../../src","sources":["GameMethods.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,wBAAqB;;AAEjD;AACA,OAAO,MAAMC,KAAK,GAAGA,CAAA,KAAMD,WAAW,CAACC,KAAK,CAAC,CAAC;;AAE9C;AACA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAAMF,WAAW,CAACE,MAAM,CAAC,CAAC;;AAEhD;AACA,OAAO,MAAMC,OAAO,GAAIC,EAAU,IAAKJ,WAAW,CAACG,OAAO,CAACC,EAAE,CAAC","ignoreList":[]}
+{"version":3,"names":["gameMethods","configure","tickRate","screen","entities","systems","paused","nativeSystems","system","push","collisions","onTick","e","c","start","Date","now","finish","setTickRate","setScreen","setEntities","setSystems","pause","resume","spawn","entityArray","Array","isArray","despawn","id","update","updates","entityUpdateArray"],"sourceRoot":"../../src","sources":["GameMethods.ts"],"mappings":";;AAAA,SAASA,WAAW,QAAQ,wBAAqB;AAIjD;AACA,OAAO,MAAMC,SAAS,GAAGA,CAAC;EACxBC,QAAQ;EACRC,MAAM;EACNC,QAAQ,GAAG,EAAE;EACbC,OAAO,GAAG,EAAE;EACZC,MAAM,GAAG;AACH,CAAC,KAAK;EACZ,IAAIC,aAAuB,GAAG,EAAE;EAEhC,KAAK,MAAMC,MAAM,IAAIH,OAAO,EAAE;IAC5BE,aAAa,CAACE,IAAI,CAAC;MACjBL,QAAQ,EAAEI,MAAM,CAACJ,QAAQ;MACzBM,UAAU,EAAEF,MAAM,CAACE,UAAU;MAC7BC,MAAM,EAAEA,CAACC,CAAC,EAAEC,CAAC,KAAK;QAChB,MAAMC,KAAK,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC;QACxBR,MAAM,CAACG,MAAM,CAACC,CAAC,EAAEC,CAAC,CAAC;QACnB,MAAMI,MAAM,GAAGF,IAAI,CAACC,GAAG,CAAC,CAAC;QACzB,OAAOC,MAAM,GAAGH,KAAK;MACvB;IACF,CAAC,CAAC;EACJ;EAEAd,WAAW,CAACkB,WAAW,CAAChB,QAAQ,CAAC;EACjCF,WAAW,CAACmB,SAAS,CAAChB,MAAM,CAAC;EAC7BH,WAAW,CAACoB,WAAW,CAAChB,QAAQ,CAAC;EACjCJ,WAAW,CAACqB,UAAU,CAACd,aAAa,CAAC;EACrC,IAAID,MAAM,EAAE;IACVN,WAAW,CAACsB,KAAK,CAAC,CAAC;EACrB,CAAC,MAAM;IACLtB,WAAW,CAACuB,MAAM,CAAC,CAAC;EACtB;AACF,CAAC;;AAED;AACA,OAAO,MAAMD,KAAK,GAAGA,CAAA,KAAMtB,WAAW,CAACsB,KAAK,CAAC,CAAC;;AAE9C;AACA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAAMvB,WAAW,CAACuB,MAAM,CAAC,CAAC;;AAEhD;AACA,OAAO,MAAMC,KAAK,GAAIpB,QAA2B,IAAK;EACpD,MAAMqB,WAAW,GAAGC,KAAK,CAACC,OAAO,CAACvB,QAAQ,CAAC,GAAGA,QAAQ,GAAG,CAACA,QAAQ,CAAC;EACnEJ,WAAW,CAACwB,KAAK,CAACC,WAAW,CAAC;AAChC,CAAC;;AAED;AACA,OAAO,MAAMG,OAAO,GAAIC,EAAU,IAAK7B,WAAW,CAAC4B,OAAO,CAACC,EAAE,CAAC;;AAE9D;AACA,OAAO,MAAMC,MAAM,GAAIC,OAAsC,IAAK;EAChE,MAAMC,iBAAiB,GAAGN,KAAK,CAACC,OAAO,CAACI,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC;EACtE/B,WAAW,CAAC8B,MAAM,CAACE,iBAAiB,CAAC;AACvC,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -2,7 +2,7 @@
 
 import GameEngine from "./GameEngine.js";
 export * from "./GameMethods.js";
-export * from "./Shared.js";
+export * from "./GameAssets.js";
 export * from "./types.js";
 export { GameEngine };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["GameEngine"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,UAAU,MAAM,iBAAc;AAErC,cAAc,kBAAe;AAC7B,cAAc,aAAU;AACxB,cAAc,YAAS;AACvB,SAASA,UAAU","ignoreList":[]}
+{"version":3,"names":["GameEngine"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,UAAU,MAAM,iBAAc;AAErC,cAAc,kBAAe;AAC7B,cAAc,iBAAc;AAC5B,cAAc,YAAS;AAQvB,SAASA,UAAU","ignoreList":[]}

package/lib/typescript/src/GameAssets.d.ts

@@ -0,0 +1,2 @@
+export declare const loadAssets: <T extends Record<string, unknown>>(assets: T) => Promise<{ [K in keyof T]: number; }>;
+//# sourceMappingURL=GameAssets.d.ts.map

package/lib/typescript/src/GameAssets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GameAssets.d.ts","sourceRoot":"","sources":["../../../src/GameAssets.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,UAAU,GAAU,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,QAAQ,CAAC,KACR,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAE,CASpC,CAAC"}

package/lib/typescript/src/GameAssets.nitro.d.ts

@@ -4,8 +4,8 @@ interface GameAssets extends HybridObject<{
     android: 'kotlin';
 }> {
     isAssetRegistered(id: number): boolean;
-    registerSvg(id: number, uri: string): void;
-    registerLottie(id: number, json: string): void;
+    registerSvg(id: number, uri: string): Promise<void>;
+    registerLottie(id: number, json: string): Promise<void>;
 }
 export declare const gameAssets: GameAssets;
 export {};

package/lib/typescript/src/GameAssets.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameAssets.nitro.d.ts","sourceRoot":"","sources":["../../../src/GameAssets.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,UAAU,UAAW,SAAQ,YAAY,CAAC;IACxC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;IACA,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD;AAED,eAAO,MAAM,UAAU,YACoC,CAAC"}
+{"version":3,"file":"GameAssets.nitro.d.ts","sourceRoot":"","sources":["../../../src/GameAssets.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,UAAU,UAAW,SAAQ,YAAY,CAAC;IACxC,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;IACA,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACvC,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,UAAU,YACoC,CAAC"}

package/lib/typescript/src/GameMethods.d.ts

@@ -1,7 +1,15 @@
+import type { Entity, EntityUpdate } from './nativeTypes';
+import type { Config } from './types';
+/** Sets up the game engine with the given configuration. Call this before anything else. */
+export declare const configure: ({ tickRate, screen, entities, systems, paused, }: Config) => void;
 /** Pauses the game loop. Systems will stop running. */
 export declare const pause: () => void;
 /** Resumes the game loop. */
 export declare const resume: () => void;
+/** Spawns one or more entities into the world. Skips duplicates by id. */
+export declare const spawn: (entities: Entity | Entity[]) => void;
 /** Removes an entity or all entities matching the given id prefix from the world. */
 export declare const despawn: (id: string) => void;
+/** Updates one or more entities. Only the provided fields are changed. */
+export declare const update: (updates: EntityUpdate | EntityUpdate[]) => void;
 //# sourceMappingURL=GameMethods.d.ts.map

package/lib/typescript/src/GameMethods.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GameMethods.d.ts","sourceRoot":"","sources":["../../../src/GameMethods.ts"],"names":[],"mappings":"AAEA,uDAAuD;AACvD,eAAO,MAAM,KAAK,YAA4B,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,MAAM,YAA6B,CAAC;AAEjD,qFAAqF;AACrF,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,SAA4B,CAAC"}
+{"version":3,"file":"GameMethods.d.ts","sourceRoot":"","sources":["../../../src/GameMethods.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAU,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,4FAA4F;AAC5F,eAAO,MAAM,SAAS,GAAI,kDAMvB,MAAM,SAyBR,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,KAAK,YAA4B,CAAC;AAE/C,6BAA6B;AAC7B,eAAO,MAAM,MAAM,YAA6B,CAAC;AAEjD,0EAA0E;AAC1E,eAAO,MAAM,KAAK,GAAI,UAAU,MAAM,GAAG,MAAM,EAAE,SAGhD,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,SAA4B,CAAC;AAE/D,0EAA0E;AAC1E,eAAO,MAAM,MAAM,GAAI,SAAS,YAAY,GAAG,YAAY,EAAE,SAG5D,CAAC"}

package/lib/typescript/src/index.d.ts

@@ -1,6 +1,7 @@
 import GameEngine from './GameEngine';
 export * from './GameMethods';
-export * from './Shared';
+export * from './GameAssets';
 export * from './types';
+export type { Screen, Entity, CollisionPair, Collision, EntityUpdate, } from './nativeTypes';
 export { GameEngine };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,YAAY,EACV,MAAM,EACN,MAAM,EACN,aAAa,EACb,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,CAAC"}