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

package/agent-skill.md

@@ -1,61 +1,25 @@
 # `@combos-fun/plugin-renderer-3d-tiling-sprite` — Agent notes
 
-Repeats one IMAGE texture across a `PlaneGeometry` using `RepeatWrapping`, for floors, walls, and tiled patterns.
-
-Prerequisite: follow the parent `@combos-fun/plugin-renderer-3d` skill for system order, named resources, pose seeding, hierarchy, and stale-async handling.
-
-## Public API
+Repeats one IMAGE on a plane. Parent: `plugin-renderer-3d`.
 
 ```ts
-import {
-  TilingSprite3D,
-  TilingSprite3DSystem,
-  type TilingSprite3DParams,
-} from '@combos-fun/plugin-renderer-3d-tiling-sprite';
+import { TilingSprite3D, TilingSprite3DSystem } from '@combos-fun/plugin-renderer-3d-tiling-sprite';
 ```
 
-`componentName = 'TilingSprite3D'`; `systemName = 'TilingSprite3DSystem'`.
-
-## Parameters
-
-| Field | Type | Default |
-|-------|------|---------|
-| `resource` | `string` | `''`; empty on ADD is a silent no-op |
-| `repeatX/Y` | `number` | `1` |
-| `width/height` | `number` | `10` |
-| `positionX/Y/Z` | `number` | `0` |
-| `rotationX/Y/Z` | `number` | `0` radians |
-| `opacity` | `number` | `1` |
-
-There are no scale or double-side fields. `width/height` are the plane's world-unit dimensions; the material is front-sided.
+`componentName = 'TilingSprite3D'`. `systemName = 'TilingSprite3DSystem'`.
 
-## Runtime and lifecycle
+| Field | Default |
+| --- | --- |
+| `resource` | `''` — IMAGE name. Empty on add does nothing |
+| `repeatX` / `repeatY` | `1` |
+| `width` / `height` | `10` — plane size in world units |
+| `position*` / `rotation*` | `0` |
+| `opacity` | `1` |
 
-- IMAGE loading is async. Replacement/removal invalidates old work; a stale loaded texture is disposed before return.
-- `resource` replacement rebuilds the mesh. `repeatX/Y` update texture repeat, `width/height` replace and dispose geometry, and `opacity` updates material transparency.
-- Pose synchronizes per frame. With renderer shadows enabled, the mesh casts and receives shadows.
-- Removal disposes geometry, material, and texture.
-
-## Package-specific pitfalls
-
-- Rotate the plane toward the camera; it is invisible from the back.
-- Use a seamless texture to avoid visible tile boundaries.
-- `TilingSprite3D.opacity` can be overwritten each frame by a sibling `Render3D`.
-
-## Minimal example
+No scale or `doubleSide`. The plane uses `RepeatWrapping` and is front-sided; rotate it toward the camera. `width` / `height` replace the geometry. A sibling `Render3D` overwrites `opacity`. Load is async and drops a stale texture.
 
 ```ts
-const floor = new GameObject('floor');
 floor.addComponent(new TilingSprite3D({
-  resource: 'floor',
-  repeatX: 4,
-  repeatY: 4,
-  width: 10,
-  height: 10,
-  rotationX: -Math.PI / 2,
+  resource: 'floor', repeatX: 4, repeatY: 4, width: 10, height: 10, rotationX: -Math.PI / 2,
 }));
 ```
-
-## Verification
-
-`pnpm --filter @combos-fun/plugin-renderer-3d-tiling-sprite run build`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-renderer-3d-tiling-sprite",
-  "version": "0.1.15",
+  "version": "0.1.17",
   "description": "Repeating texture on a 3D plane (PlaneGeometry + RepeatWrapping texture)",
   "main": "index.js",
   "module": "dist/plugin-renderer-3d-tiling-sprite.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/engine": "0.1.17",
+    "@combos-fun/plugin-renderer-3d": "0.1.17",
+    "@combos-fun/inspector-decorator": "0.1.17"
   },
   "keywords": [
     "combos-fun",