@combos-fun/plugin-renderer-3d-sprite-animation 0.0.37 → 0.0.39

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/agent-skill.md +3 -3
  2. package/package.json +4 -4
package/agent-skill.md CHANGED
@@ -25,7 +25,7 @@ import { SpriteAnimation3D, SpriteAnimation3DSystem, type SpriteAnimation3DParam
25
25
  | `rotationX` / `Y` / `Z` | `number` | `0` |
26
26
  | `scaleX` / `Y` | `number` | `1` (no `scaleZ` — plane is 2D) |
27
27
 
28
- The system loads the spritesheet JSON (array or hash format) and resolves the image URL **relative to the JSON path**.
28
+ The system fetches the JSON URL directly (not an engine `resource` name). It reads top-level `frames` (array or name-map) and `meta.image` / `meta.size`. Image URL is resolved relative to the JSON path.
29
29
 
30
30
  ## Required setup
31
31
 
@@ -36,8 +36,8 @@ The system loads the spritesheet JSON (array or hash format) and resolves the im
36
36
  | Symptom | Fix |
37
37
  |---------|-----|
38
38
  | Animation never starts | `autoPlay` defaults to `true`; if you set `false`, drive `play()` from a Component lifecycle hook |
39
- | Black plane | Image not loaded verify the JSON's `image`/`meta.image` field resolves correctly relative to the JSON URL |
40
- | Frames in wrong order | Texture Packer hash format may not preserve order; export as array format |
39
+ | Black plane / load error | JSON must have top-level `frames` plus `meta.image` and `meta.size` |
40
+ | Frames in wrong order | Hash `frames` keys are `Object.keys().sort()`; prefer array `frames` for playback order |
41
41
  | Stuck on first frame | Single-frame sheet; verify the JSON contains multiple frame entries |
42
42
 
43
43
  ## Minimal example
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@combos-fun/plugin-renderer-3d-sprite-animation",
3
- "version": "0.0.37",
3
+ "version": "0.0.39",
4
4
  "description": "Spritesheet animation projected onto a PlaneGeometry in 3D space",
5
5
  "main": "index.js",
6
6
  "module": "dist/plugin-renderer-3d-sprite-animation.esm.js",
@@ -26,9 +26,9 @@
26
26
  "pluginManifest": "./combos-plugin.json"
27
27
  },
28
28
  "dependencies": {
29
- "@combos-fun/engine": "0.0.37",
30
- "@combos-fun/inspector-decorator": "0.0.37",
31
- "@combos-fun/plugin-renderer-3d": "0.0.37",
29
+ "@combos-fun/engine": "0.0.39",
30
+ "@combos-fun/inspector-decorator": "0.0.39",
31
+ "@combos-fun/plugin-renderer-3d": "0.0.39",
32
32
  "three": "^0.172.0"
33
33
  },
34
34
  "keywords": [