@combos-fun/plugin-renderer-3d-img 0.1.15 → 0.1.17

package/agent-skill.md

@@ -1,54 +1,23 @@
 # `@combos-fun/plugin-renderer-3d-img` — Agent notes
 
-Renders one named image on a Three.js plane for billboards, backdrops, decals, and in-world panels.
-
-Prerequisite: follow the parent `@combos-fun/plugin-renderer-3d` skill for system order, named resources, pose seeding, hierarchy, and stale-async handling.
-
-## Public API
+One IMAGE on a plane. Parent: `plugin-renderer-3d`. Repeating textures: `TilingSprite3D`.
 
 ```ts
-import { Img3D, Img3DSystem, type Img3DParams } from '@combos-fun/plugin-renderer-3d-img';
+import { Img3D, Img3DSystem } from '@combos-fun/plugin-renderer-3d-img';
 ```
 
-`componentName = 'Img3D'`; `systemName = 'Img3DSystem'`.
-
-## Parameters
-
-| Field | Type | Default |
-|-------|------|---------|
-| `resource` | `string` | `''`; empty on ADD is a silent no-op |
-| `positionX/Y/Z` | `number` | `0` |
-| `rotationX/Y/Z` | `number` | `0` radians |
-| `scaleX/Y` | `number` | `1` |
-| `opacity` | `number` | `1` |
-| `doubleSide` | `boolean` | `false` |
-
-There is no `scaleZ`, `width`, or `height`. The generated `PlaneGeometry` is `(imageWidth / imageHeight) × 1` world units before scaling.
+`componentName = 'Img3D'`. `systemName = 'Img3DSystem'`.
 
-## Runtime and lifecycle
+| Field | Default |
+| --- | --- |
+| `resource` | `''` — IMAGE name. Empty on add does nothing |
+| `position*` / `rotation*` | `0` |
+| `scaleX` / `scaleY` | `1` |
+| `opacity` | `1` |
+| `doubleSide` | `false` |
 
-- The system creates a new Three `Texture` from the IMAGE resource's `data.image`; it does not replace or reuse the Pixi IMAGE instance.
-- Loading is async. Resource replacement or removal invalidates the old request; a stale texture is disposed before return.
-- Changing `resource` replaces the plane. `opacity` and `doubleSide` update the existing material; pose and scale synchronize per frame.
-- With renderer shadows enabled, the mesh receives `castShadow` and `receiveShadow`.
-
-## Package-specific pitfalls
-
-- The front face only is visible unless `doubleSide: true`.
-- Use `scaleX/scaleY` to size the image; use `TilingSprite3D` when the texture must repeat.
-- `Img3D.opacity` is the material value, but a sibling `Render3D` overwrites opacity each frame for the root subtree.
-
-## Minimal example
+No `scaleZ`, `width`, or `height`. Plane size is `(imageWidth / imageHeight) × 1` before scale. The texture is a new Three texture from `data.image`, not the Pixi image. Front face only unless `doubleSide: true`. Changing `resource` rebuilds the plane. A sibling `Render3D` overwrites `opacity` each frame. Load is async and drops a stale texture.
 
 ```ts
-const billboard = new GameObject('billboard');
-billboard.addComponent(new Img3D({
-  resource: 'poster',
-  positionZ: -3,
-  doubleSide: true,
-}));
+billboard.addComponent(new Img3D({ resource: 'poster', positionZ: -3, doubleSide: true }));
 ```
-
-## Verification
-
-`pnpm --filter @combos-fun/plugin-renderer-3d-img run build`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-renderer-3d-img",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "3D textured plane",
   "main": "index.js",
   "module": "dist/plugin-renderer-3d-img.esm.js",
@@ -27,9 +27,9 @@
   },
   "dependencies": {
     "three": "^0.172.0",
-    "@combos-fun/engine": "0.1.15",
-    "@combos-fun/inspector-decorator": "0.1.15",
-    "@combos-fun/plugin-renderer-3d": "0.1.15"
+    "@combos-fun/inspector-decorator": "0.1.17",
+    "@combos-fun/plugin-renderer-3d": "0.1.17",
+    "@combos-fun/engine": "0.1.17"
   },
   "keywords": [
     "combos-fun",