@combos-fun/engine 0.0.38 → 0.0.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/engine",
-  "version": "0.0.38",
+  "version": "0.0.40",
   "description": "ECS microkernel",
   "main": "index.js",
   "module": "dist/engine.esm.js",
@@ -41,13 +41,17 @@
   ],
   "author": "sun668 <q947692259@gmail.com>",
   "dependencies": {
-    "@combos-fun/inspector-decorator": "0.0.38",
+    "@combos-fun/inspector-decorator": "0.0.39",
     "eventemitter3": "^5.0.4",
     "lodash-es": "^4.17.21",
     "resource-loader": "^4.0.0-rc4",
     "sprite-timeline": "^1.10.2"
   },
+  "devDependencies": {
+    "tsx": "^4.20.3"
+  },
   "scripts": {
-    "build": "node ../../scripts/build-package.mjs"
+    "build": "node ../../scripts/build-package.mjs",
+    "test": "node --import tsx --test test/normalizeResourceSrc.test.ts test/normalizeSpritesheetData.test.ts"
   }
 }

package/references/bootstrap-examples.md

@@ -55,49 +55,76 @@ resource.loadConfig([
 ]);
 ```
 
-`ResourceBase` requires both `type: RESOURCE_TYPE` and a nested `src` object keyed by media slot (`image` / `json` / `audio` / `video` / `tex` / `ske` / …) where each slot is `{ type, url }`. A flat `src: 'logo.png'` is invalid.
-
 ## 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

@@ -6,11 +6,11 @@ Open only when the short `agent-skill` card is insufficient for a named symbol o
 
 ### Values
 
-`Game`, `Scene`, `GameObject`, `Component`, `System`, `Transform`, `resource`, `resourceLoader`, `decorators`, `IDEProp`, `componentObserver`, `LOAD_EVENT`, `RESOURCE_TYPE`, `OBSERVER_TYPE`, `LOAD_SCENE_MODE`, `RESOURCE_TYPE_STRATEGY`, `version`, `COMBOS_GAME_PLUGIN_INIT_SUCCESS`, `COMBOS_GAME_READY`, `COMBOS_GAME_SET_PLAYING`, `COMBOS_GAME_STATE_CHANGED`, `postParentPluginInitSuccess`, `postParentGameReady`, `postParentGameState`, `parseSetPlayingMessage`, `DEFAULT_ALLOWED_MESSAGE_HOST_SUFFIXES`, `isAllowedMessageOrigin`, `mergeAllowedMessageOrigins`.
+`Game`, `Scene`, `GameObject`, `Component`, `System`, `Transform`, `resource`, `resourceLoader`, `decorators`, `IDEProp`, `componentObserver`, `LOAD_EVENT`, `RESOURCE_TYPE`, `OBSERVER_TYPE`, `LOAD_SCENE_MODE`, `RESOURCE_TYPE_STRATEGY`, `normalizeResourceSrc`, `normalizeSpritesheetData`, `version`, `COMBOS_GAME_PLUGIN_INIT_SUCCESS`, `COMBOS_GAME_READY`, `COMBOS_GAME_SET_PLAYING`, `COMBOS_GAME_STATE_CHANGED`, `postParentPluginInitSuccess`, `postParentGameReady`, `postParentGameState`, `parseSetPlayingMessage`, `DEFAULT_ALLOWED_MESSAGE_HOST_SUFFIXES`, `isAllowedMessageOrigin`, `mergeAllowedMessageOrigins`.
 
 ### 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`