rngine 0.3.0 → 0.3.2

package/README.md

@@ -17,7 +17,7 @@ import { GameEngine, configure, update } from 'rngine';
 
 configure({
   tickRate: 60,
-  world: { width: 800, height: 800, color: '#1a1a1a' },
+  screen: { width: 800, height: 800, color: '#1a1a1a' },
   entities: [
     {
       id: 'player',
@@ -52,7 +52,7 @@ configure({
       ids: ['enemy'],
       onTick: (enemies) => {
         enemies.forEach((enemy) => {
-          // reverse direction when reaching world edges
+          // reverse direction when reaching screen edges
           if (enemy.px <= 0 || enemy.px + enemy.width >= 800) {
             update({ id: enemy.id, vx: -enemy.vx });
           }
@@ -74,7 +74,7 @@ export default function App() {
 
 **Systems** define your game logic. Each system declares which entities it cares about via `ids` and runs every tick receiving those entities. See [`System`](./src/types.ts).
 
-**World** defines the game world dimensions and background color. Entities outside the world bounds are automatically clipped. See [`World`](./src/types.ts).
+**Screen** defines the viewport dimensions and background color. Entities outside the screen bounds are automatically clipped. See [`Screen`](./src/types.ts).
 
 ## Entity Querying
 
@@ -99,13 +99,13 @@ This makes it easy to build entity groups naturally through naming. No extra con
 
 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 |
-| `entities` |          | `Entity[]` | `[]`    | Initial entities to spawn             |
-| `systems`  |          | `System[]` | `[]`    | Systems to run each tick              |
-| `paused`   |          | `boolean`  | `true`  | Whether to start paused               |
+| param      | required | type       | default | description                            |
+| ---------- | -------- | ---------- | ------- | -------------------------------------- |
+| `tickRate` | ✓        | `number`   | -       | Game logic updates per second          |
+| `screen`   | ✓        | `Screen`   | -       | Screen dimensions and background color |
+| `entities` |          | `Entity[]` | `[]`    | Initial entities to spawn              |
+| `systems`  |          | `System[]` | `[]`    | Systems to run each tick               |
+| `paused`   |          | `boolean`  | `true`  | Whether to start paused                |
 
 ### `spawn(entity | entity[])`
 

package/lib/module/GameMethods.js

@@ -6,13 +6,13 @@ const gameMethods = NitroModules.createHybridObject('GameMethods');
 /** Sets up the game engine with the given configuration. Call this before anything else. */
 export function configure({
   tickRate,
-  world,
+  screen,
   entities = [],
   systems = [],
   paused = true
 }) {
   gameMethods.setTickRate(tickRate);
-  gameMethods.setWorld(world);
+  gameMethods.setScreen(screen);
   gameMethods.setEntities(entities);
   gameMethods.setSystems(systems);
   if (paused) {

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","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":[]}
+{"version":3,"names":["NitroModules","gameMethods","createHybridObject","configure","tickRate","screen","entities","systems","paused","setTickRate","setScreen","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,MAAM;EACNC,QAAQ,GAAG,EAAE;EACbC,OAAO,GAAG,EAAE;EACZC,MAAM,GAAG;AACH,CAAC,EAAE;EACTP,WAAW,CAACQ,WAAW,CAACL,QAAQ,CAAC;EACjCH,WAAW,CAACS,SAAS,CAACL,MAAM,CAAC;EAC7BJ,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,7 @@
 "use strict";
 
 import GameEngine from "./GameEngine.js";
-import { configure, pause, resume, spawn, despawn, update } from "./GameMethods.js";
-export { GameEngine, configure, pause, resume, spawn, despawn, update };
+export * from "./GameMethods.js";
+export * from "./types.js";
+export { GameEngine };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"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":[]}
+{"version":3,"names":["GameEngine"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,OAAOA,UAAU,MAAM,iBAAc;AAErC,cAAc,kBAAe;AAC7B,cAAc,YAAS;AACvB,SAASA,UAAU","ignoreList":[]}

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

@@ -1,6 +1,6 @@
 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;
+export declare function 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. */

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,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"}
+{"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,MAAM,EACN,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,11 +1,11 @@
 import type { HybridObject } from 'react-native-nitro-modules';
-import type { Entity, EntityUpdate, System, World } from './types';
+import type { Entity, EntityUpdate, System, Screen } from './types';
 export interface GameMethods extends HybridObject<{
     ios: 'c++';
     android: 'c++';
 }> {
     setTickRate(tickRate: number): void;
-    setWorld(world: World): void;
+    setScreen(screen: Screen): void;
     setEntities(entities: Entity[]): void;
     setSystems(systems: System[]): void;
     pause(): void;

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,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"}
+{"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,MAAM,EAAE,MAAM,SAAS,CAAC;AAEpE,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,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,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,5 @@
 import GameEngine from './GameEngine';
-import { configure, pause, resume, spawn, despawn, update } from './GameMethods';
-export { GameEngine, configure, pause, resume, spawn, despawn, update };
+export * from './GameMethods';
+export * from './types';
+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;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"}
+{"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,SAAS,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,CAAC"}

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

@@ -1,9 +1,9 @@
-export type World = {
-    /** Width of the world in game units. */
+export type Screen = {
+    /** Width of the screen in game units. */
     width: number;
-    /** Height of the world in game units. */
+    /** Height of the screen in game units. */
     height: number;
-    /** Background color of the world as a hex string e.g. `'#1a1a1a'`. */
+    /** Background color of the screen as a hex string e.g. `'#1a1a1a'`. */
     color: string;
 };
 export type Entity = {
@@ -51,8 +51,8 @@ export type EntityUpdate = {
 export type Config = {
     /** Number of game logic updates per second. */
     tickRate: number;
-    /** World dimensions and background color. */
-    world: World;
+    /** Screen dimensions and background color. */
+    screen: Screen;
     /** Initial entities to spawn. */
     entities?: Entity[];
     /**

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,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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACnB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,uEAAuE;IACvE,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,8CAA8C;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,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++/HybridGameMethodsSpec.cpp

@@ -15,7 +15,7 @@ namespace margelo::nitro::rngine {
     // load custom methods/properties
     registerHybrids(this, [](Prototype& prototype) {
       prototype.registerHybridMethod("setTickRate", &HybridGameMethodsSpec::setTickRate);
-      prototype.registerHybridMethod("setWorld", &HybridGameMethodsSpec::setWorld);
+      prototype.registerHybridMethod("setScreen", &HybridGameMethodsSpec::setScreen);
       prototype.registerHybridMethod("setEntities", &HybridGameMethodsSpec::setEntities);
       prototype.registerHybridMethod("setSystems", &HybridGameMethodsSpec::setSystems);
       prototype.registerHybridMethod("pause", &HybridGameMethodsSpec::pause);

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

@@ -13,8 +13,8 @@
 #error NitroModules cannot be found! Are you sure you installed NitroModules properly?
 #endif
 
-// Forward declaration of `World` to properly resolve imports.
-namespace margelo::nitro::rngine { struct World; }
+// Forward declaration of `Screen` to properly resolve imports.
+namespace margelo::nitro::rngine { struct Screen; }
 // Forward declaration of `Entity` to properly resolve imports.
 namespace margelo::nitro::rngine { struct Entity; }
 // Forward declaration of `System` to properly resolve imports.
@@ -22,7 +22,7 @@ namespace margelo::nitro::rngine { struct System; }
 // Forward declaration of `EntityUpdate` to properly resolve imports.
 namespace margelo::nitro::rngine { struct EntityUpdate; }
 
-#include "World.hpp"
+#include "Screen.hpp"
 #include "Entity.hpp"
 #include <vector>
 #include "System.hpp"
@@ -61,7 +61,7 @@ namespace margelo::nitro::rngine {
     public:
       // Methods
       virtual void setTickRate(double tickRate) = 0;
-      virtual void setWorld(const World& world) = 0;
+      virtual void setScreen(const Screen& screen) = 0;
       virtual void setEntities(const std::vector<Entity>& entities) = 0;
       virtual void setSystems(const std::vector<System>& systems) = 0;
       virtual void pause() = 0;

package/nitrogen/generated/shared/c++/{World.hpp → Screen.hpp}

@@ -1,5 +1,5 @@
 ///
-/// World.hpp
+/// Screen.hpp
 /// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
 /// https://github.com/mrousavy/nitro
 /// Copyright © Marc Rousavy @ Margelo
@@ -35,38 +35,38 @@
 namespace margelo::nitro::rngine {
 
   /**
-   * A struct which can be represented as a JavaScript object (World).
+   * A struct which can be represented as a JavaScript object (Screen).
    */
-  struct World final {
+  struct Screen final {
   public:
     double width     SWIFT_PRIVATE;
     double height     SWIFT_PRIVATE;
     std::string color     SWIFT_PRIVATE;
 
   public:
-    World() = default;
-    explicit World(double width, double height, std::string color): width(width), height(height), color(color) {}
+    Screen() = default;
+    explicit Screen(double width, double height, std::string color): width(width), height(height), color(color) {}
 
   public:
-    friend bool operator==(const World& lhs, const World& rhs) = default;
+    friend bool operator==(const Screen& lhs, const Screen& rhs) = default;
   };
 
 } // namespace margelo::nitro::rngine
 
 namespace margelo::nitro {
 
-  // C++ World <> JS World (object)
+  // C++ Screen <> JS Screen (object)
   template <>
-  struct JSIConverter<margelo::nitro::rngine::World> final {
-    static inline margelo::nitro::rngine::World fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+  struct JSIConverter<margelo::nitro::rngine::Screen> final {
+    static inline margelo::nitro::rngine::Screen fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
       jsi::Object obj = arg.asObject(runtime);
-      return margelo::nitro::rngine::World(
+      return margelo::nitro::rngine::Screen(
         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")))
       );
     }
-    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::rngine::World& arg) {
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::rngine::Screen& arg) {
       jsi::Object obj(runtime);
       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));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rngine",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "React Native 2D game engine powered by Nitro Modules",
   "main": "./lib/module/index.js",
   "types": "./lib/typescript/src/index.d.ts",

package/shared/ColorUtils.hpp

@@ -1,25 +1,34 @@
 #pragma once
-#include <stdexcept>
 #include <string>
 
 namespace margelo::nitro::rngine {
 
 inline uint32_t parseHexColor(const std::string &color) {
-  if (color.empty() || color[0] != '#') {
-    throw std::invalid_argument("Only hex colors supported");
-  }
-  std::string hex = color.substr(1);
-  if (hex.size() == 6) {
-    return 0xFF000000 | std::stoul(hex, nullptr, 16);
-  } else if (hex.size() == 8) {
-    uint32_t rgba = std::stoul(hex, nullptr, 16);
-    uint32_t r = (rgba >> 24) & 0xFF;
-    uint32_t g = (rgba >> 16) & 0xFF;
-    uint32_t b = (rgba >> 8) & 0xFF;
-    uint32_t a = rgba & 0xFF;
-    return (a << 24) | (r << 16) | (g << 8) | b;
+  if (!color.empty() && color[0] == '#') {
+    std::string hex = color.substr(1);
+
+    if (hex.size() == 3 || hex.size() == 4) {
+      std::string expanded;
+      expanded.reserve(hex.size() * 2);
+      for (char c : hex) {
+        expanded += c;
+        expanded += c;
+      }
+      hex = std::move(expanded);
+    }
+
+    if (hex.size() == 6) {
+      return 0xFF000000 | std::stoul(hex, nullptr, 16);
+    } else if (hex.size() == 8) {
+      uint32_t rgba = std::stoul(hex, nullptr, 16);
+      uint32_t r = (rgba >> 24) & 0xFF;
+      uint32_t g = (rgba >> 16) & 0xFF;
+      uint32_t b = (rgba >> 8) & 0xFF;
+      uint32_t a = rgba & 0xFF;
+      return (a << 24) | (r << 16) | (g << 8) | b;
+    }
   }
-  throw std::invalid_argument("Invalid hex color: " + color);
-}
 
+  return 0x00000000;
+}
 } // namespace margelo::nitro::rngine

package/shared/GameLoop.cpp

@@ -56,18 +56,18 @@ std::vector<Rect> GameLoop::getRectsSnapshot() {
   rects.reserve(_entities.size() + 1);
 
   rects.push_back(
-      {0, _world.width, 0, _world.height, parseHexColor(_world.color)});
+      {0, _screen.width, 0, _screen.height, parseHexColor(_screen.color)});
 
   for (const auto &[id, entity] : _entities) {
-    if (entity.px + entity.width < 0 || entity.px > _world.width ||
-        entity.py + entity.height < 0 || entity.py > _world.height) {
+    if (entity.px + entity.width < 0 || entity.px > _screen.width ||
+        entity.py + entity.height < 0 || entity.py > _screen.height) {
       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),
+    rects.push_back({std::clamp(entity.px, 0.0, _screen.width),
+                     std::clamp(entity.px + entity.width, 0.0, _screen.width),
+                     std::clamp(entity.py, 0.0, _screen.height),
+                     std::clamp(entity.py + entity.height, 0.0, _screen.height),
                      parseHexColor(entity.color)});
   }
   return rects;

package/shared/GameLoop.hpp

@@ -3,8 +3,8 @@
 #include "Entity.hpp"
 #include "GameStats.hpp"
 #include "Rect.hpp"
+#include "Screen.hpp"
 #include "System.hpp"
-#include "World.hpp"
 #include <atomic>
 #include <memory>
 #include <thread>
@@ -25,7 +25,7 @@ public:
   std::map<string, Entity> &getEntitiesInternal() { return _entities; };
   std::vector<System> &getSystemsInternal() { return _systems; };
   std::atomic<bool> &getIsPausedInternal() { return _isPaused; };
-  World &getWorldInternal() { return _world; };
+  Screen &getScreenInternal() { return _screen; };
 
   std::vector<Entity *> resolveEntitiesInternal(const std::string &prefix);
   std::vector<Rect> getRectsSnapshot();
@@ -40,7 +40,7 @@ private:
   std::atomic<bool> _isRunning{true};
   std::atomic<bool> _isPaused{true};
   double _tickRate{60.0};
-  World _world;
+  Screen _screen;
   GameStats _gameStats;
   std::unique_ptr<std::thread> _gameThread;
 

package/shared/GameMethods.cpp

@@ -12,13 +12,13 @@ void GameMethods::setTickRate(double tickRate) {
                       "setTickRate: tickRate=%.1f", tickRate);
 }
 
-void GameMethods::setWorld(const World &world) {
+void GameMethods::setScreen(const Screen &screen) {
   auto &instance = GameLoop::getInstance();
   std::lock_guard<std::mutex> lock(instance.getMutexInternal());
-  instance.getWorldInternal() = world;
+  instance.getScreenInternal() = screen;
   __android_log_print(ANDROID_LOG_INFO, "GameMethods",
-                      "setWorld: width=%.0f height=%.0f", world.width,
-                      world.height);
+                      "setWorld: width=%.0f height=%.0f", screen.width,
+                      screen.height);
 }
 
 void GameMethods::setEntities(const std::vector<Entity> &entities) {

package/shared/GameMethods.hpp

@@ -7,7 +7,7 @@ class GameMethods : public HybridGameMethodsSpec {
 public:
   GameMethods() : HybridObject(TAG) {}
   void setTickRate(double tickRate) override;
-  void setWorld(const World &world) override;
+  void setScreen(const Screen &screen) override;
   void setEntities(const std::vector<Entity> &entities) override;
   void setSystems(const std::vector<System> &systems) override;
   void pause() override;

package/src/GameMethods.nitro.ts

@@ -1,12 +1,12 @@
 import type { HybridObject } from 'react-native-nitro-modules';
-import type { Entity, EntityUpdate, System, World } from './types';
+import type { Entity, EntityUpdate, System, Screen } from './types';
 
 export interface GameMethods extends HybridObject<{
   ios: 'c++';
   android: 'c++';
 }> {
   setTickRate(tickRate: number): void;
-  setWorld(world: World): void;
+  setScreen(screen: Screen): void;
   setEntities(entities: Entity[]): void;
   setSystems(systems: System[]): void;
   pause(): void;

package/src/GameMethods.ts

@@ -7,13 +7,13 @@ const gameMethods = NitroModules.createHybridObject<GameMethods>('GameMethods');
 /** Sets up the game engine with the given configuration. Call this before anything else. */
 export function configure({
   tickRate,
-  world,
+  screen,
   entities = [],
   systems = [],
   paused = true,
 }: Config) {
   gameMethods.setTickRate(tickRate);
-  gameMethods.setWorld(world);
+  gameMethods.setScreen(screen);
   gameMethods.setEntities(entities);
   gameMethods.setSystems(systems);
   if (paused) {

package/src/index.tsx

@@ -1,11 +1,5 @@
 import GameEngine from './GameEngine';
-import {
-  configure,
-  pause,
-  resume,
-  spawn,
-  despawn,
-  update,
-} from './GameMethods';
 
-export { GameEngine, configure, pause, resume, spawn, despawn, update };
+export * from './GameMethods';
+export * from './types';
+export { GameEngine };

package/src/types.ts

@@ -1,9 +1,9 @@
-export type World = {
-  /** Width of the world in game units. */
+export type Screen = {
+  /** Width of the screen in game units. */
   width: number;
-  /** Height of the world in game units. */
+  /** Height of the screen in game units. */
   height: number;
-  /** Background color of the world as a hex string e.g. `'#1a1a1a'`. */
+  /** Background color of the screen as a hex string e.g. `'#1a1a1a'`. */
   color: string;
 };
 
@@ -55,8 +55,8 @@ export type EntityUpdate = {
 export type Config = {
   /** Number of game logic updates per second. */
   tickRate: number;
-  /** World dimensions and background color. */
-  world: World;
+  /** Screen dimensions and background color. */
+  screen: Screen;
   /** Initial entities to spawn. */
   entities?: Entity[];
   /**