@combos-fun/engine 0.0.39 → 0.0.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/engine",
-  "version": "0.0.39",
+  "version": "0.0.40",
   "description": "ECS microkernel",
   "main": "index.js",
   "module": "dist/engine.esm.js",

package/references/bootstrap-examples.md

@@ -58,44 +58,73 @@ resource.loadConfig([
 ## Minimal 3D bootstrap
 
 ```ts
-import { Game, GameObject } from "@combos-fun/engine";
+import {
+  Game,
+  GameObject,
+  resource,
+  RESOURCE_TYPE,
+  LOAD_EVENT,
+} from "@combos-fun/engine";
 import { Renderer3DSystem } from "@combos-fun/plugin-renderer-3d";
 import {
   Graphics3D,
   Graphics3DSystem,
 } from "@combos-fun/plugin-renderer-3d-graphics";
+import { Model3D, Model3DSystem } from "@combos-fun/plugin-renderer-3d-model";
+import { Event3D, Event3DSystem } from "@combos-fun/plugin-renderer-3d-event";
 
-new Game({
-  systems: [
-    new Renderer3DSystem({
-      canvas: document.querySelector("#canvas")!,
-      width: 750,
-      height: 1000,
-    }),
-    new Graphics3DSystem(),
-  ],
-  // Safe place to wire the scene graph: every system has finished init.
-  onSystemsBootstrapComplete: (g) => {
-    // 3D position / rotation / scale go through the component's own params
-    // (positionX/Y/Z, rotationX/Y/Z, scaleX/Y/Z) — GameObject's TransformParams
-    // is 2D-only (Vector2 + Size2) and is not read by 3D renderers.
-    const box = new GameObject("box");
-    box.addComponent(
-      new Graphics3D({
-        shape: "box",
-        width: 1,
-        height: 1,
-        depth: 1,
-        color: 0xff0000,
-        positionX: 0,
-        positionY: 1,
-        positionZ: 0,
+resource.once(LOAD_EVENT.COMPLETE, () => {
+  new Game({
+    systems: [
+      new Renderer3DSystem({
+        canvas: document.querySelector("#canvas")!,
+        width: 750,
+        height: 1334,
       }),
-    );
-    // Use addChild — not addGameObject — so transform parent + scene are both wired.
-    g.scene.addChild(box);
-  },
+      new Graphics3DSystem(),
+      new Model3DSystem(),
+      new Event3DSystem(),
+    ],
+    // Safe place to wire the scene graph: every system has finished init.
+    onSystemsBootstrapComplete: (g) => {
+      // 3D position / rotation / scale go through the component's own params
+      // (positionX/Y/Z, rotationX/Y/Z, scaleX/Y/Z) — GameObject's TransformParams
+      // is 2D-only (Vector2 + Size2) and is not read by 3D renderers.
+      const box = new GameObject("box");
+      box.addComponent(
+        new Graphics3D({
+          shape: "box",
+          width: 1,
+          height: 1,
+          depth: 1,
+          color: 0xff0000,
+          positionX: 0,
+          positionY: 1,
+          positionZ: 0,
+        }),
+      );
+      box.addComponent(new Event3D());
+      box.getComponent(Event3D)!.on("tap", () => {
+        /* handle */
+      });
+      // Use addChild — not addGameObject — so transform parent + scene are both wired.
+      g.scene.addChild(box);
+
+      const hero = new GameObject("hero");
+      hero.addComponent(new Model3D({ resource: "hero", positionY: 0 }));
+      g.scene.addChild(hero);
+    },
+  });
 });
+
+resource.loadConfig([
+  {
+    name: "hero",
+    type: RESOURCE_TYPE.MODEL,
+    src: { model: { type: "glb", url: "https://cdn.example/hero.glb" } },
+    preload: true,
+  },
+]);
 ```
 
 ## Verification

package/references/public-api.md

@@ -10,7 +10,7 @@ Open only when the short `agent-skill` card is insufficient for a named symbol o
 
 ### Types
 
-`GameParams`, `PluginStruct`, `TransformParams`, `ComponentChanged`, `UpdateParams`, `ComponentParams`, `ObserverInfo`, `PureObserverInfo`, `ResourceBase`, `SystemConstructor`, `CombosGamePluginInitSuccessMessage`, `CombosGameReadyMessage`, `CombosGameStateChangedMessage`, `CombosGameSetPlayingMessage`.
+`GameParams`, `PluginStruct`, `TransformParams`, `ComponentChanged`, `UpdateParams`, `ComponentParams`, `ObserverInfo`, `PureObserverInfo`, `ResourceBase`, `ResourceStruct`, `SystemConstructor`, `CombosGamePluginInitSuccessMessage`, `CombosGameReadyMessage`, `CombosGameStateChangedMessage`, `CombosGameSetPlayingMessage`.
 
 ### `GameParams`