rngine 0.2.1 → 0.3.0

package/README.md

@@ -1,4 +1,4 @@
-# rngine
+# Rngine
 
 A React Native game engine for building 2D games, powered by [Nitro Modules](https://nitro.margelo.com/) for high-performance C++ game logic.
 
@@ -13,7 +13,7 @@ npm install rngine react-native-nitro-modules
 ## Usage
 
 ```tsx
-import { GameEngine, configure, setVelocity } from 'rngine';
+import { GameEngine, configure, update } from 'rngine';
 
 configure({
   tickRate: 60,
@@ -26,8 +26,6 @@ configure({
       width: 40,
       height: 40,
       color: '#00ff00',
-      vx: 0,
-      vy: 0,
     },
     {
       id: 'enemy_1',
@@ -37,7 +35,6 @@ configure({
       height: 40,
       color: '#ff0000',
       vx: 1000,
-      vy: 0,
     },
     {
       id: 'enemy_2',
@@ -47,7 +44,6 @@ configure({
       height: 40,
       color: '#ff0000',
       vx: -1000,
-      vy: 0,
     },
   ],
   systems: [
@@ -58,7 +54,7 @@ configure({
         enemies.forEach((enemy) => {
           // reverse direction when reaching world edges
           if (enemy.px <= 0 || enemy.px + enemy.width >= 800) {
-            setVelocity(enemy.id, -enemy.vx, enemy.vy);
+            update({ id: enemy.id, vx: -enemy.vx });
           }
         });
       },
@@ -82,7 +78,7 @@ export default function App() {
 
 ## Entity Querying
 
-Entity ids use `_` as a hierarchy separator, which enables prefix matching in systems and functions like `setVelocity`. Querying `'enemy'` matches all entities whose id starts with `enemy_`. So `enemy_1`, `enemy_magician_1`, and `enemy_warrior_2` are all returned. Querying `'enemy_magician'` narrows it down to only magician entities. Querying `'enemy_magician_1'` is an exact match.
+Entity ids use `_` as a hierarchy separator, which enables prefix matching in systems and functions like `update`. Querying `'enemy'` matches all entities whose id starts with `enemy_`. So `enemy_1`, `enemy_magician_1`, and `enemy_warrior_2` are all returned. Querying `'enemy_magician'` narrows it down to only magician entities. Querying `'enemy_magician_1'` is an exact match.
 
 This makes it easy to build entity groups naturally through naming. No extra configuration needed.
 
@@ -105,8 +101,8 @@ Sets up the game engine. Call this before anything else.
 
 | param      | required | type       | default | description                           |
 | ---------- | -------- | ---------- | ------- | ------------------------------------- |
-| `tickRate` | ✓        | `number`   | —       | Game logic updates per second         |
-| `world`    | ✓        | `World`    | —       | World dimensions and background color |
+| `tickRate` | ✓        | `number`   | -       | Game logic updates per second         |
+| `world`    | ✓        | `World`    | -       | World dimensions and background color |
 | `entities` |          | `Entity[]` | `[]`    | Initial entities to spawn             |
 | `systems`  |          | `System[]` | `[]`    | Systems to run each tick              |
 | `paused`   |          | `boolean`  | `true`  | Whether to start paused               |
@@ -119,13 +115,10 @@ Spawns one or more entities into the world. Skips duplicates by id.
 
 Removes the entity with the given id, or all entities matching the given prefix.
 
-### `setPosition(id, px, py)`
+### `update(entityUpdate | entityUpdate[])`
 
-Sets the position of a single entity. Requires an exact id.
-
-### `setVelocity(id, vx, vy)`
-
-Sets the velocity of all entities matching the given id or prefix.
+Updates one or more entities. Only the provided fields are changed.
+Matches entities by exact id or prefix.
 
 ### `pause()`
 

package/lib/module/GameMethods.js

@@ -36,9 +36,8 @@ export const spawn = entities => {
 /** Removes an entity or all entities matching the given id prefix from the world. */
 export const despawn = id => gameMethods.despawn(id);
 
-/** Sets the position of the entity with the exact given id. */
-export const setPosition = (id, px, py) => gameMethods.setP(id, px, py);
-
-/** Sets the velocity of all entities matching the given id or prefix. */
-export const setVelocity = (id, vx, vy) => gameMethods.setV(id, vx, vy);
+/** Updates one or more entities. Only the provided fields are changed. */
+export const update = updates => {
+  gameMethods.update(Array.isArray(updates) ? updates : [updates]);
+};
 //# sourceMappingURL=GameMethods.js.map

package/lib/module/GameMethods.js.map

@@ -1 +1 @@
-{"version":3,"names":["NitroModules","gameMethods","createHybridObject","configure","tickRate","world","entities","systems","paused","setTickRate","setWorld","setEntities","setSystems","pause","resume","spawn","Array","isArray","despawn","id","setPosition","px","py","setP","setVelocity","vx","vy","setV"],"sourceRoot":"../../src","sources":["GameMethods.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAIzD,MAAMC,WAAW,GAAGD,YAAY,CAACE,kBAAkB,CAAc,aAAa,CAAC;;AAE/E;AACA,OAAO,SAASC,SAASA,CAAC;EACxBC,QAAQ;EACRC,KAAK;EACLC,QAAQ,GAAG,EAAE;EACbC,OAAO,GAAG,EAAE;EACZC,MAAM,GAAG;AACH,CAAC,EAAE;EACTP,WAAW,CAACQ,WAAW,CAACL,QAAQ,CAAC;EACjCH,WAAW,CAACS,QAAQ,CAACL,KAAK,CAAC;EAC3BJ,WAAW,CAACU,WAAW,CAACL,QAAQ,CAAC;EACjCL,WAAW,CAACW,UAAU,CAACL,OAAO,CAAC;EAC/B,IAAIC,MAAM,EAAE;IACVP,WAAW,CAACY,KAAK,CAAC,CAAC;EACrB,CAAC,MAAM;IACLZ,WAAW,CAACa,MAAM,CAAC,CAAC;EACtB;AACF;;AAEA;AACA,OAAO,MAAMD,KAAK,GAAGA,CAAA,KAAMZ,WAAW,CAACY,KAAK,CAAC,CAAC;;AAE9C;AACA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAAMb,WAAW,CAACa,MAAM,CAAC,CAAC;;AAEhD;AACA,OAAO,MAAMC,KAAK,GAAIT,QAA2B,IAAK;EACpDL,WAAW,CAACc,KAAK,CAACC,KAAK,CAACC,OAAO,CAACX,QAAQ,CAAC,GAAGA,QAAQ,GAAG,CAACA,QAAQ,CAAC,CAAC;AACpE,CAAC;;AAED;AACA,OAAO,MAAMY,OAAO,GAAIC,EAAU,IAAKlB,WAAW,CAACiB,OAAO,CAACC,EAAE,CAAC;;AAE9D;AACA,OAAO,MAAMC,WAAW,GAAGA,CAACD,EAAU,EAAEE,EAAU,EAAEC,EAAU,KAC5DrB,WAAW,CAACsB,IAAI,CAACJ,EAAE,EAAEE,EAAE,EAAEC,EAAE,CAAC;;AAE9B;AACA,OAAO,MAAME,WAAW,GAAGA,CAACL,EAAU,EAAEM,EAAU,EAAEC,EAAU,KAC5DzB,WAAW,CAAC0B,IAAI,CAACR,EAAE,EAAEM,EAAE,EAAEC,EAAE,CAAC","ignoreList":[]}
+{"version":3,"names":["NitroModules","gameMethods","createHybridObject","configure","tickRate","world","entities","systems","paused","setTickRate","setWorld","setEntities","setSystems","pause","resume","spawn","Array","isArray","despawn","id","update","updates"],"sourceRoot":"../../src","sources":["GameMethods.ts"],"mappings":";;AAAA,SAASA,YAAY,QAAQ,4BAA4B;AAIzD,MAAMC,WAAW,GAAGD,YAAY,CAACE,kBAAkB,CAAc,aAAa,CAAC;;AAE/E;AACA,OAAO,SAASC,SAASA,CAAC;EACxBC,QAAQ;EACRC,KAAK;EACLC,QAAQ,GAAG,EAAE;EACbC,OAAO,GAAG,EAAE;EACZC,MAAM,GAAG;AACH,CAAC,EAAE;EACTP,WAAW,CAACQ,WAAW,CAACL,QAAQ,CAAC;EACjCH,WAAW,CAACS,QAAQ,CAACL,KAAK,CAAC;EAC3BJ,WAAW,CAACU,WAAW,CAACL,QAAQ,CAAC;EACjCL,WAAW,CAACW,UAAU,CAACL,OAAO,CAAC;EAC/B,IAAIC,MAAM,EAAE;IACVP,WAAW,CAACY,KAAK,CAAC,CAAC;EACrB,CAAC,MAAM;IACLZ,WAAW,CAACa,MAAM,CAAC,CAAC;EACtB;AACF;;AAEA;AACA,OAAO,MAAMD,KAAK,GAAGA,CAAA,KAAMZ,WAAW,CAACY,KAAK,CAAC,CAAC;;AAE9C;AACA,OAAO,MAAMC,MAAM,GAAGA,CAAA,KAAMb,WAAW,CAACa,MAAM,CAAC,CAAC;;AAEhD;AACA,OAAO,MAAMC,KAAK,GAAIT,QAA2B,IAAK;EACpDL,WAAW,CAACc,KAAK,CAACC,KAAK,CAACC,OAAO,CAACX,QAAQ,CAAC,GAAGA,QAAQ,GAAG,CAACA,QAAQ,CAAC,CAAC;AACpE,CAAC;;AAED;AACA,OAAO,MAAMY,OAAO,GAAIC,EAAU,IAAKlB,WAAW,CAACiB,OAAO,CAACC,EAAE,CAAC;;AAE9D;AACA,OAAO,MAAMC,MAAM,GAAIC,OAAsC,IAAK;EAChEpB,WAAW,CAACmB,MAAM,CAACJ,KAAK,CAACC,OAAO,CAACI,OAAO,CAAC,GAAGA,OAAO,GAAG,CAACA,OAAO,CAAC,CAAC;AAClE,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
 import GameEngine from "./GameEngine.js";
-import { configure, pause, resume, spawn, despawn, setPosition, setVelocity } from "./GameMethods.js";
-export { GameEngine, configure, pause, resume, spawn, despawn, setPosition, setVelocity };
+import { configure, pause, resume, spawn, despawn, update } from "./GameMethods.js";
+export { GameEngine, configure, pause, resume, spawn, despawn, update };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["GameEngine","configure","pause","resume","spawn","despawn","setPosition","setVelocity"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,UAAU,MAAM,iBAAc;AACrC,SACEC,SAAS,EACTC,KAAK,EACLC,MAAM,EACNC,KAAK,EACLC,OAAO,EACPC,WAAW,EACXC,WAAW,QACN,kBAAe;AAEtB,SACEP,UAAU,EACVC,SAAS,EACTC,KAAK,EACLC,MAAM,EACNC,KAAK,EACLC,OAAO,EACPC,WAAW,EACXC,WAAW","ignoreList":[]}
+{"version":3,"names":["GameEngine","configure","pause","resume","spawn","despawn","update"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,UAAU,MAAM,iBAAc;AACrC,SACEC,SAAS,EACTC,KAAK,EACLC,MAAM,EACNC,KAAK,EACLC,OAAO,EACPC,MAAM,QACD,kBAAe;AAEtB,SAASN,UAAU,EAAEC,SAAS,EAAEC,KAAK,EAAEC,MAAM,EAAEC,KAAK,EAAEC,OAAO,EAAEC,MAAM","ignoreList":[]}

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

@@ -1,4 +1,4 @@
-import type { Config, Entity } from './types';
+import type { Config, Entity, EntityUpdate } from './types';
 /** Sets up the game engine with the given configuration. Call this before anything else. */
 export declare function configure({ tickRate, world, entities, systems, paused, }: Config): void;
 /** Pauses the game loop. Systems will stop running. */
@@ -9,8 +9,6 @@ export declare const resume: () => void;
 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;
-/** Sets the position of the entity with the exact given id. */
-export declare const setPosition: (id: string, px: number, py: number) => void;
-/** Sets the velocity of all entities matching the given id or prefix. */
-export declare const setVelocity: (id: string, vx: number, vy: number) => 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,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAI9C,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,QAAa,EACb,OAAY,EACZ,MAAa,GACd,EAAE,MAAM,QAUR;AAED,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,SAEhD,CAAC;AAEF,qFAAqF;AACrF,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,SAA4B,CAAC;AAE/D,+DAA+D;AAC/D,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,SAChC,CAAC;AAE/B,yEAAyE;AACzE,eAAO,MAAM,WAAW,GAAI,IAAI,MAAM,EAAE,IAAI,MAAM,EAAE,IAAI,MAAM,SAChC,CAAC"}
+{"version":3,"file":"GameMethods.d.ts","sourceRoot":"","sources":["../../../src/GameMethods.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI5D,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,EACxB,QAAQ,EACR,KAAK,EACL,QAAa,EACb,OAAY,EACZ,MAAa,GACd,EAAE,MAAM,QAUR;AAED,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,SAEhD,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,SAE5D,CAAC"}

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

@@ -1,5 +1,5 @@
 import type { HybridObject } from 'react-native-nitro-modules';
-import type { Entity, System, World } from './types';
+import type { Entity, EntityUpdate, System, World } from './types';
 export interface GameMethods extends HybridObject<{
     ios: 'c++';
     android: 'c++';
@@ -12,7 +12,6 @@ export interface GameMethods extends HybridObject<{
     resume(): void;
     spawn(entities: Entity[]): void;
     despawn(id: string): void;
-    setP(id: string, px: number, py: number): void;
-    setV(id: string, vx: number, vy: number): void;
+    update(updates: EntityUpdate[]): void;
 }
 //# sourceMappingURL=GameMethods.nitro.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"GameMethods.nitro.d.ts","sourceRoot":"","sources":["../../../src/GameMethods.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErD,MAAM,WAAW,WAAY,SAAQ,YAAY,CAAC;IAChD,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,KAAK,CAAC;CAChB,CAAC;IACA,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAChD"}
+{"version":3,"file":"GameMethods.nitro.d.ts","sourceRoot":"","sources":["../../../src/GameMethods.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,WAAW,WAAY,SAAQ,YAAY,CAAC;IAChD,GAAG,EAAE,KAAK,CAAC;IACX,OAAO,EAAE,KAAK,CAAC;CAChB,CAAC;IACA,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC,KAAK,IAAI,IAAI,CAAC;IACd,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAChC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CACvC"}

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

@@ -1,4 +1,4 @@
 import GameEngine from './GameEngine';
-import { configure, pause, resume, spawn, despawn, setPosition, setVelocity } from './GameMethods';
-export { GameEngine, configure, pause, resume, spawn, despawn, setPosition, setVelocity, };
+import { configure, pause, resume, spawn, despawn, update } from './GameMethods';
+export { GameEngine, configure, pause, resume, spawn, despawn, update };
 //# 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;AACtC,OAAO,EACL,SAAS,EACT,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,WAAW,EACX,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,UAAU,EACV,SAAS,EACT,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,WAAW,EACX,WAAW,GACZ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,EACL,SAAS,EACT,KAAK,EACL,MAAM,EACN,KAAK,EACL,OAAO,EACP,MAAM,EACP,MAAM,eAAe,CAAC;AAEvB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC"}

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

@@ -20,9 +20,9 @@ export type Entity = {
     /** Fill color as a hex string e.g. `'#00ff00'`. */
     color: string;
     /** Velocity on the X axis in game units per second. */
-    vx: number;
+    vx?: number;
     /** Velocity on the Y axis in game units per second. */
-    vy: number;
+    vy?: number;
 };
 export type System = {
     /** Entity ids or prefixes this system subscribes to. */
@@ -30,6 +30,24 @@ export type System = {
     /** Called every tick with the resolved entities. */
     onTick: (entities: Entity[]) => void;
 };
+export type EntityUpdate = {
+    /** Unique identifier or prefix of the entities to update. */
+    id: string;
+    /** X position in game units. */
+    px?: number;
+    /** Y position in game units. */
+    py?: number;
+    /** Width in game units. */
+    width?: number;
+    /** Height in game units. */
+    height?: number;
+    /** Fill color as a hex string e.g. `'#00ff00'`. */
+    color?: string;
+    /** Velocity on the X axis in game units per second. */
+    vx?: number;
+    /** Velocity on the Y axis in game units per second. */
+    vy?: number;
+};
 export type Config = {
     /** Number of game logic updates per second. */
     tickRate: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,EAAE,EAAE,MAAM,CAAC;CACZ,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,wDAAwD;IACxD,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,oFAAoF;IACpF,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,wDAAwD;IACxD,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,oDAAoD;IACpD,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,6DAA6D;IAC7D,EAAE,EAAE,MAAM,CAAC;IACX,gCAAgC;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2BAA2B;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,EAAE,CAAC,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,KAAK,EAAE,KAAK,CAAC;IACb,iCAAiC;IACjC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,iDAAiD;IACjD,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC"}

package/nitrogen/generated/shared/c++/Entity.hpp

@@ -31,6 +31,7 @@
 
 
 #include <string>
+#include <optional>
 
 namespace margelo::nitro::rngine {
 
@@ -45,12 +46,12 @@ namespace margelo::nitro::rngine {
     double width     SWIFT_PRIVATE;
     double height     SWIFT_PRIVATE;
     std::string color     SWIFT_PRIVATE;
-    double vx     SWIFT_PRIVATE;
-    double vy     SWIFT_PRIVATE;
+    std::optional<double> vx     SWIFT_PRIVATE;
+    std::optional<double> vy     SWIFT_PRIVATE;
 
   public:
     Entity() = default;
-    explicit Entity(std::string id, double px, double py, double width, double height, std::string color, double vx, double vy): id(id), px(px), py(py), width(width), height(height), color(color), vx(vx), vy(vy) {}
+    explicit Entity(std::string id, double px, double py, double width, double height, std::string color, std::optional<double> vx, std::optional<double> vy): id(id), px(px), py(py), width(width), height(height), color(color), vx(vx), vy(vy) {}
 
   public:
     friend bool operator==(const Entity& lhs, const Entity& rhs) = default;
@@ -72,8 +73,8 @@ namespace margelo::nitro {
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width"))),
         JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height"))),
         JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "color"))),
-        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx"))),
-        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::rngine::Entity& arg) {
@@ -84,8 +85,8 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "width"), JSIConverter<double>::toJSI(runtime, arg.width));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "height"), JSIConverter<double>::toJSI(runtime, arg.height));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "color"), JSIConverter<std::string>::toJSI(runtime, arg.color));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vx"), JSIConverter<double>::toJSI(runtime, arg.vx));
-      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vy"), JSIConverter<double>::toJSI(runtime, arg.vy));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vx"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.vx));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vy"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.vy));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -102,8 +103,8 @@ namespace margelo::nitro {
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width")))) return false;
       if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))) return false;
       if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "color")))) return false;
-      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx")))) return false;
-      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/EntityUpdate.hpp

@@ -0,0 +1,112 @@
+///
+/// EntityUpdate.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+#include <string>
+#include <optional>
+
+namespace margelo::nitro::rngine {
+
+  /**
+   * A struct which can be represented as a JavaScript object (EntityUpdate).
+   */
+  struct EntityUpdate final {
+  public:
+    std::string id     SWIFT_PRIVATE;
+    std::optional<double> px     SWIFT_PRIVATE;
+    std::optional<double> py     SWIFT_PRIVATE;
+    std::optional<double> width     SWIFT_PRIVATE;
+    std::optional<double> height     SWIFT_PRIVATE;
+    std::optional<std::string> color     SWIFT_PRIVATE;
+    std::optional<double> vx     SWIFT_PRIVATE;
+    std::optional<double> vy     SWIFT_PRIVATE;
+
+  public:
+    EntityUpdate() = default;
+    explicit EntityUpdate(std::string id, std::optional<double> px, std::optional<double> py, std::optional<double> width, std::optional<double> height, std::optional<std::string> color, std::optional<double> vx, std::optional<double> vy): id(id), px(px), py(py), width(width), height(height), color(color), vx(vx), vy(vy) {}
+
+  public:
+    friend bool operator==(const EntityUpdate& lhs, const EntityUpdate& rhs) = default;
+  };
+
+} // namespace margelo::nitro::rngine
+
+namespace margelo::nitro {
+
+  // C++ EntityUpdate <> JS EntityUpdate (object)
+  template <>
+  struct JSIConverter<margelo::nitro::rngine::EntityUpdate> final {
+    static inline margelo::nitro::rngine::EntityUpdate fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::rngine::EntityUpdate(
+        JSIConverter<std::string>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "id"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "px"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "py"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height"))),
+        JSIConverter<std::optional<std::string>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "color"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::rngine::EntityUpdate& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "id"), JSIConverter<std::string>::toJSI(runtime, arg.id));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "px"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.px));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "py"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.py));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "width"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.width));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "height"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.height));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "color"), JSIConverter<std::optional<std::string>>::toJSI(runtime, arg.color));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vx"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.vx));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "vy"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.vy));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<std::string>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "id")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "px")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "py")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))) return false;
+      if (!JSIConverter<std::optional<std::string>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "color")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vx")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "vy")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/nitrogen/generated/shared/c++/HybridGameMethodsSpec.cpp

@@ -22,8 +22,7 @@ namespace margelo::nitro::rngine {
       prototype.registerHybridMethod("resume", &HybridGameMethodsSpec::resume);
       prototype.registerHybridMethod("spawn", &HybridGameMethodsSpec::spawn);
       prototype.registerHybridMethod("despawn", &HybridGameMethodsSpec::despawn);
-      prototype.registerHybridMethod("setP", &HybridGameMethodsSpec::setP);
-      prototype.registerHybridMethod("setV", &HybridGameMethodsSpec::setV);
+      prototype.registerHybridMethod("update", &HybridGameMethodsSpec::update);
     });
   }
 

package/nitrogen/generated/shared/c++/HybridGameMethodsSpec.hpp

@@ -19,12 +19,15 @@ namespace margelo::nitro::rngine { struct World; }
 namespace margelo::nitro::rngine { struct Entity; }
 // Forward declaration of `System` to properly resolve imports.
 namespace margelo::nitro::rngine { struct System; }
+// Forward declaration of `EntityUpdate` to properly resolve imports.
+namespace margelo::nitro::rngine { struct EntityUpdate; }
 
 #include "World.hpp"
 #include "Entity.hpp"
 #include <vector>
 #include "System.hpp"
 #include <string>
+#include "EntityUpdate.hpp"
 
 namespace margelo::nitro::rngine {
 
@@ -65,8 +68,7 @@ namespace margelo::nitro::rngine {
       virtual void resume() = 0;
       virtual void spawn(const std::vector<Entity>& entities) = 0;
       virtual void despawn(const std::string& id) = 0;
-      virtual void setP(const std::string& id, double px, double py) = 0;
-      virtual void setV(const std::string& id, double vx, double vy) = 0;
+      virtual void update(const std::vector<EntityUpdate>& updates) = 0;
 
     protected:
       // Hybrid Setup

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "rngine",
-  "version": "0.2.1",
-  "description": "React native library for building 2d games",
+  "version": "0.3.0",
+  "description": "React Native 2D game engine powered by Nitro Modules",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",
   "exports": {

package/shared/GameLoop.cpp

@@ -64,12 +64,11 @@ std::vector<Rect> GameLoop::getRectsSnapshot() {
       continue;
     }
 
-    rects.push_back(
-        {std::clamp(entity.px, 0.0, _world.width),
-         std::clamp(entity.px + entity.width, 0.0, _world.width),
-         std::clamp(entity.py, 0.0, _world.height),
-         std::clamp(entity.py + entity.height, 0.0, _world.height),
-         parseHexColor(entity.color)});
+    rects.push_back({std::clamp(entity.px, 0.0, _world.width),
+                     std::clamp(entity.px + entity.width, 0.0, _world.width),
+                     std::clamp(entity.py, 0.0, _world.height),
+                     std::clamp(entity.py + entity.height, 0.0, _world.height),
+                     parseHexColor(entity.color)});
   }
   return rects;
 }
@@ -154,8 +153,12 @@ void GameLoop::updateEntities(double deltaTime) {
   std::lock_guard<std::mutex> lock(_mutex);
 
   for (auto &[id, entity] : _entities) {
-    entity.px += entity.vx * deltaTime;
-    entity.py += entity.vy * deltaTime;
+    if (entity.vx) {
+      entity.px += *entity.vx * deltaTime;
+    }
+    if (entity.vy) {
+      entity.py += *entity.vy * deltaTime;
+    }
   }
 }
 } // namespace margelo::nitro::rngine

package/shared/GameMethods.cpp

@@ -1,4 +1,5 @@
 #include "GameMethods.hpp"
+#include "EntityUpdate.hpp"
 #include "GameLoop.hpp"
 #include <android/log.h>
 
@@ -99,39 +100,39 @@ void GameMethods::despawn(const std::string &id) {
   }
 }
 
-void GameMethods::setP(const std::string &id, double px, double py) {
+void GameMethods::update(const std::vector<EntityUpdate> &updates) {
   auto &instance = GameLoop::getInstance();
   std::lock_guard<std::mutex> lock(instance.getMutexInternal());
-  auto &entitiesInternal = instance.getEntitiesInternal();
-  auto it = entitiesInternal.find(id);
-
-  if (it == entitiesInternal.end()) {
-    __android_log_print(ANDROID_LOG_WARN, "GameMethods",
-                        "setP: entity not found for id=%s", id.c_str());
-    return;
-  }
-  __android_log_print(ANDROID_LOG_INFO, "GameMethods",
-                      "setP: entity found, setting px=%f py=%f", px, py);
-  it->second.px = px;
-  it->second.py = py;
-}
+  for (const auto &update : updates) {
+    auto resolvedEntitiesInternals =
+        instance.resolveEntitiesInternal(update.id);
+    if (resolvedEntitiesInternals.empty()) {
+      __android_log_print(ANDROID_LOG_WARN, "GameMethods",
+                          "update: no entity found for id=%s",
+                          update.id.c_str());
+      continue;
+    }
 
-void GameMethods::setV(const std::string &id, double vx, double vy) {
-  auto &instance = GameLoop::getInstance();
-  std::lock_guard<std::mutex> lock(instance.getMutexInternal());
-  auto resolvedEntitiesInternals = instance.resolveEntitiesInternal(id);
+    for (auto *entity : resolvedEntitiesInternals) {
+      if (update.px.has_value())
+        entity->px = update.px.value();
+      if (update.py.has_value())
+        entity->py = update.py.value();
+      if (update.width.has_value())
+        entity->width = update.width.value();
+      if (update.height.has_value())
+        entity->height = update.height.value();
+      if (update.color.has_value())
+        entity->color = update.color.value();
+      if (update.vx.has_value())
+        entity->vx = update.vx.value();
+      if (update.vy.has_value())
+        entity->vy = update.vy.value();
+    }
 
-  if (resolvedEntitiesInternals.empty()) {
-    __android_log_print(ANDROID_LOG_WARN, "GameMethods",
-                        "setV: entity not found for id=%s", id.c_str());
-    return;
-  }
-  for (auto *entity : resolvedEntitiesInternals) {
-    entity->vx = vx;
-    entity->vy = vy;
+    __android_log_print(ANDROID_LOG_INFO, "GameMethods",
+                        "update: patched %zu entities for id=%s",
+                        resolvedEntitiesInternals.size(), update.id.c_str());
   }
-  __android_log_print(ANDROID_LOG_INFO, "GameMethods",
-                      "setV: set vx=%f vy=%f for %zu entities matching id=%s",
-                      vx, vy, resolvedEntitiesInternals.size(), id.c_str());
 }
 } // namespace margelo::nitro::rngine

package/shared/GameMethods.hpp

@@ -14,7 +14,6 @@ public:
   void resume() override;
   void spawn(const std::vector<Entity> &entities) override;
   void despawn(const std::string &id) override;
-  void setP(const std::string &id, double px, double py) override;
-  void setV(const std::string &id, double vx, double vy) override;
+  void update(const std::vector<EntityUpdate> &updates) override;
 };
 } // namespace margelo::nitro::rngine

package/src/GameMethods.nitro.ts

@@ -1,5 +1,5 @@
 import type { HybridObject } from 'react-native-nitro-modules';
-import type { Entity, System, World } from './types';
+import type { Entity, EntityUpdate, System, World } from './types';
 
 export interface GameMethods extends HybridObject<{
   ios: 'c++';
@@ -13,6 +13,5 @@ export interface GameMethods extends HybridObject<{
   resume(): void;
   spawn(entities: Entity[]): void;
   despawn(id: string): void;
-  setP(id: string, px: number, py: number): void;
-  setV(id: string, vx: number, vy: number): void;
+  update(updates: EntityUpdate[]): void;
 }

package/src/GameMethods.ts

@@ -1,6 +1,6 @@
 import { NitroModules } from 'react-native-nitro-modules';
 import type { GameMethods } from './GameMethods.nitro';
-import type { Config, Entity } from './types';
+import type { Config, Entity, EntityUpdate } from './types';
 
 const gameMethods = NitroModules.createHybridObject<GameMethods>('GameMethods');
 
@@ -37,10 +37,7 @@ export const spawn = (entities: Entity | Entity[]) => {
 /** Removes an entity or all entities matching the given id prefix from the world. */
 export const despawn = (id: string) => gameMethods.despawn(id);
 
-/** Sets the position of the entity with the exact given id. */
-export const setPosition = (id: string, px: number, py: number) =>
-  gameMethods.setP(id, px, py);
-
-/** Sets the velocity of all entities matching the given id or prefix. */
-export const setVelocity = (id: string, vx: number, vy: number) =>
-  gameMethods.setV(id, vx, vy);
+/** Updates one or more entities. Only the provided fields are changed. */
+export const update = (updates: EntityUpdate | EntityUpdate[]) => {
+  gameMethods.update(Array.isArray(updates) ? updates : [updates]);
+};

package/src/index.tsx

@@ -5,17 +5,7 @@ import {
   resume,
   spawn,
   despawn,
-  setPosition,
-  setVelocity,
+  update,
 } from './GameMethods';
 
-export {
-  GameEngine,
-  configure,
-  pause,
-  resume,
-  spawn,
-  despawn,
-  setPosition,
-  setVelocity,
-};
+export { GameEngine, configure, pause, resume, spawn, despawn, update };

package/src/types.ts

@@ -21,9 +21,9 @@ export type Entity = {
   /** Fill color as a hex string e.g. `'#00ff00'`. */
   color: string;
   /** Velocity on the X axis in game units per second. */
-  vx: number;
+  vx?: number;
   /** Velocity on the Y axis in game units per second. */
-  vy: number;
+  vy?: number;
 };
 
 export type System = {
@@ -33,6 +33,25 @@ export type System = {
   onTick: (entities: Entity[]) => void;
 };
 
+export type EntityUpdate = {
+  /** Unique identifier or prefix of the entities to update. */
+  id: string;
+  /** X position in game units. */
+  px?: number;
+  /** Y position in game units. */
+  py?: number;
+  /** Width in game units. */
+  width?: number;
+  /** Height in game units. */
+  height?: number;
+  /** Fill color as a hex string e.g. `'#00ff00'`. */
+  color?: string;
+  /** Velocity on the X axis in game units per second. */
+  vx?: number;
+  /** Velocity on the Y axis in game units per second. */
+  vy?: number;
+};
+
 export type Config = {
   /** Number of game logic updates per second. */
   tickRate: number;