cubeforge 0.0.2 → 0.0.3

package/dist/components/Game.d.ts

@@ -1,4 +1,5 @@
 import React, { type CSSProperties } from 'react';
+import { type Plugin } from '@cubeforge/core';
 export interface GameControls {
     pause(): void;
     resume(): void;
@@ -20,9 +21,11 @@ interface GameProps {
     scale?: 'none' | 'contain' | 'pixel';
     /** Called once the engine is ready — receives pause/resume/reset controls */
     onReady?: (controls: GameControls) => void;
+    /** Custom plugins to register after core systems. Each plugin's systems run after Render. */
+    plugins?: Plugin[];
     style?: CSSProperties;
     className?: string;
     children?: React.ReactNode;
 }
-export declare function Game({ width, height, gravity, debug, scale, onReady, style, className, children, }: GameProps): import("react/jsx-runtime").JSX.Element;
+export declare function Game({ width, height, gravity, debug, scale, onReady, plugins, style, className, children, }: GameProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/index.d.ts

@@ -29,7 +29,8 @@ export type { EngineState } from './context';
 export type { GameControls } from './components/Game';
 export type { PlatformerControllerOptions } from './hooks/usePlatformerController';
 export type { TopDownMovementOptions } from './hooks/useTopDownMovement';
-export type { EntityId, ECSWorld, ScriptUpdateFn } from '@cubeforge/core';
+export type { EntityId, ECSWorld, ScriptUpdateFn, Plugin } from '@cubeforge/core';
+export { definePlugin } from '@cubeforge/core';
 export type { InputManager } from '@cubeforge/input';
 export type { TransformComponent } from '@cubeforge/core';
 export type { RigidBodyComponent } from '@cubeforge/physics';

package/dist/index.js

@@ -7,24 +7,36 @@ class ECSWorld {
   components = new Map;
   systems = [];
   queryCache = new Map;
+  dirtyTypes = new Set;
+  dirtyAll = false;
   createEntity() {
     const id = this.nextId++;
     this.entities.add(id);
     this.components.set(id, new Map);
+    this.dirtyAll = true;
     return id;
   }
   destroyEntity(id) {
+    const comps = this.components.get(id);
+    if (comps) {
+      for (const type of comps.keys()) {
+        this.dirtyTypes.add(type);
+      }
+    }
     this.entities.delete(id);
     this.components.delete(id);
+    this.dirtyAll = true;
   }
   hasEntity(id) {
     return this.entities.has(id);
   }
   addComponent(id, component) {
     this.components.get(id)?.set(component.type, component);
+    this.dirtyTypes.add(component.type);
   }
   removeComponent(id, type) {
     this.components.get(id)?.delete(type);
+    this.dirtyTypes.add(type);
   }
   getComponent(id, type) {
     return this.components.get(id)?.get(type);
@@ -77,7 +89,22 @@ class ECSWorld {
       this.systems.splice(idx, 1);
   }
   update(dt) {
-    this.queryCache.clear();
+    if (this.dirtyAll) {
+      this.queryCache.clear();
+    } else if (this.dirtyTypes.size > 0) {
+      for (const key of this.queryCache.keys()) {
+        if (key === "") {
+          this.queryCache.delete(key);
+          continue;
+        }
+        const keyTypes = key.split("\x00");
+        if (keyTypes.some((t) => this.dirtyTypes.has(t))) {
+          this.queryCache.delete(key);
+        }
+      }
+    }
+    this.dirtyAll = false;
+    this.dirtyTypes.clear();
     for (const system of this.systems) {
       system.update(this, dt);
     }
@@ -85,6 +112,9 @@ class ECSWorld {
   clear() {
     this.entities.clear();
     this.components.clear();
+    this.queryCache.clear();
+    this.dirtyTypes.clear();
+    this.dirtyAll = false;
     this.nextId = 0;
   }
   get entityCount() {
@@ -360,6 +390,10 @@ function tween(from, to, duration, ease = Ease.linear, onUpdate, onComplete) {
     }
   };
 }
+// ../core/src/plugin.ts
+function definePlugin(plugin) {
+  return plugin;
+}
 // ../input/src/keyboard.ts
 class Keyboard {
   held = new Set;
@@ -831,6 +865,7 @@ function createRigidBody(opts) {
     gravityScale: 1,
     isStatic: false,
     onGround: false,
+    isNearGround: false,
     bounce: 0,
     friction: 0.85,
     ...opts
@@ -846,6 +881,7 @@ function createBoxCollider(width, height, opts) {
     offsetY: 0,
     isTrigger: false,
     layer: "default",
+    slope: 0,
     ...opts
   };
 }
@@ -870,6 +906,19 @@ function getOverlap(a, b) {
     y: dy >= 0 ? oy : -oy
   };
 }
+function getSlopeSurfaceY(st, sc, worldX) {
+  const hw = sc.width / 2;
+  const hh = sc.height / 2;
+  const cx = st.x + sc.offsetX;
+  const cy = st.y + sc.offsetY;
+  const left = cx - hw;
+  const right = cx + hw;
+  if (worldX < left || worldX > right)
+    return null;
+  const dx = worldX - left;
+  const angleRad = sc.slope * (Math.PI / 180);
+  return cy - hh + dx * Math.tan(angleRad);
+}
 
 class PhysicsSystem {
   gravity;
@@ -933,6 +982,7 @@ class PhysicsSystem {
     for (const id of dynamics) {
       const rb = world2.getComponent(id, "RigidBody");
       rb.onGround = false;
+      rb.isNearGround = false;
       rb.vy += this.gravity * rb.gravityScale * dt;
     }
     for (const id of dynamics) {
@@ -956,6 +1006,8 @@ class PhysicsSystem {
             const sc = world2.getComponent(sid, "BoxCollider");
             if (sc.isTrigger)
               continue;
+            if (sc.slope !== 0)
+              continue;
             const ov = getOverlap(getAABB(transform2, col), getAABB(st, sc));
             if (!ov)
               continue;
@@ -988,6 +1040,22 @@ class PhysicsSystem {
             const sc = world2.getComponent(sid, "BoxCollider");
             if (sc.isTrigger)
               continue;
+            if (sc.slope !== 0) {
+              const ov2 = getOverlap(getAABB(transform2, col), getAABB(st, sc));
+              if (!ov2)
+                continue;
+              const entityBottom = transform2.y + col.offsetY + col.height / 2;
+              const entityCenterX = transform2.x + col.offsetX;
+              const surfaceY = getSlopeSurfaceY(st, sc, entityCenterX);
+              if (surfaceY !== null && entityBottom > surfaceY) {
+                transform2.y -= entityBottom - surfaceY;
+                rb.onGround = true;
+                if (rb.friction < 1)
+                  rb.vx *= rb.friction;
+                rb.vy = rb.bounce > 0 ? -rb.vy * rb.bounce : 0;
+              }
+              continue;
+            }
             const ov = getOverlap(getAABB(transform2, col), getAABB(st, sc));
             if (!ov)
               continue;
@@ -1019,6 +1087,23 @@ class PhysicsSystem {
           this.events?.emit("trigger", { a: ia, b: ib });
           continue;
         }
+        const rba = world2.getComponent(ia, "RigidBody");
+        const rbb = world2.getComponent(ib, "RigidBody");
+        if (Math.abs(ov.y) <= Math.abs(ov.x)) {
+          if (ov.y > 0) {
+            if (rbb.vy > 0) {
+              rba.vy += rbb.vy * 0.3;
+              rbb.vy = 0;
+            }
+            rbb.onGround = true;
+          } else {
+            if (rba.vy > 0) {
+              rbb.vy += rba.vy * 0.3;
+              rba.vy = 0;
+            }
+            rba.onGround = true;
+          }
+        }
         ta.x += ov.x / 2;
         ta.y += ov.y / 2;
         tb.x -= ov.x / 2;
@@ -1026,6 +1111,43 @@ class PhysicsSystem {
         this.events?.emit("collision", { a: ia, b: ib });
       }
     }
+    for (const id of dynamics) {
+      const rb = world2.getComponent(id, "RigidBody");
+      if (rb.onGround) {
+        rb.isNearGround = true;
+        continue;
+      }
+      const transform2 = world2.getComponent(id, "Transform");
+      const col = world2.getComponent(id, "BoxCollider");
+      const probeAABB = {
+        cx: transform2.x + col.offsetX,
+        cy: transform2.y + col.offsetY + 2,
+        hw: col.width / 2,
+        hh: col.height / 2
+      };
+      const candidateCells = this.getCells(probeAABB.cx, probeAABB.cy, probeAABB.hw, probeAABB.hh);
+      const checked = new Set;
+      outer:
+        for (const cell of candidateCells) {
+          const bucket = staticGrid.get(cell);
+          if (!bucket)
+            continue;
+          for (const sid of bucket) {
+            if (checked.has(sid))
+              continue;
+            checked.add(sid);
+            const st = world2.getComponent(sid, "Transform");
+            const sc = world2.getComponent(sid, "BoxCollider");
+            if (sc.isTrigger)
+              continue;
+            const ov = getOverlap(probeAABB, getAABB(st, sc));
+            if (ov && Math.abs(ov.y) <= Math.abs(ov.x) && ov.y < 0) {
+              rb.isNearGround = true;
+              break outer;
+            }
+          }
+        }
+    }
   }
 }
 // src/context.ts
@@ -1140,6 +1262,7 @@ function Game({
   debug = false,
   scale = "none",
   onReady,
+  plugins,
   style,
   className,
   children
@@ -1174,6 +1297,14 @@ function Game({
     });
     const state = { ecs, input, renderer, physics, events, assets, loop, canvas, entityIds };
     setEngine(state);
+    if (plugins) {
+      for (const plugin2 of plugins) {
+        for (const system of plugin2.systems) {
+          ecs.addSystem(system);
+        }
+        plugin2.onInit?.(state);
+      }
+    }
     loop.start();
     onReady?.({
       pause: () => loop.pause(),
@@ -2223,6 +2354,7 @@ export {
   useEvent,
   useEntity,
   tween,
+  definePlugin,
   createAtlas,
   World,
   Transform,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cubeforge",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "React-first 2D browser game engine",
   "main": "./src/index.ts",
   "scripts": {
@@ -17,18 +17,20 @@
       }
     }
   },
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "peerDependencies": {
     "react": "^18.0.0",
     "react-dom": "^18.0.0"
   },
-  "dependencies": {
-    "@cubeforge/core": "workspace:*",
-    "@cubeforge/input": "workspace:*",
-    "@cubeforge/renderer": "workspace:*",
-    "@cubeforge/physics": "workspace:*"
-  },
-  "keywords": ["game-engine", "react", "2d", "browser-game", "cubeforge"],
+  "keywords": [
+    "game-engine",
+    "react",
+    "2d",
+    "browser-game",
+    "cubeforge"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",