@combos-fun/plugin-renderer-tiling-sprite 0.0.45 → 0.0.47

package/agent-skill.md

@@ -1,45 +1,24 @@
 # `@combos-fun/plugin-renderer-tiling-sprite` — Agent notes
 
-Repeating tiled texture for the 2D pipeline. Wraps Pixi `TilingSprite`, useful for backgrounds, parallax layers, scrolling floors.
-
-## When to read
-
-Read for any tiling background, parallax layer, or scrolling pattern.
-
-## Public API
+Read only for a repeated IMAGE texture: tiled backgrounds, scrolling floors, and parallax patterns.
 
 ```ts
 import { TilingSprite, TilingSpriteSystem, type TilingSpriteParams } from '@combos-fun/plugin-renderer-tiling-sprite';
 ```
 
-`componentName = 'TilingSprite'`, `systemName = 'TilingSprite'` (class is `TilingSpriteSystem` — use `game.getSystem(TilingSpriteSystem)`, not the string).
-
-### `TilingSpriteParams`
-
-| Field | Type | Default | Notes |
-|-------|------|---------|-------|
-| `resource` | `string` | — | Engine resource name (`RESOURCE_TYPE.IMAGE`) |
-| `tileScale` | `{ x, y }` | `{ x: 1, y: 1 }` | Per-tile scale |
-| `tilePosition` | `{ x, y }` | `{ x: 0, y: 0 }` | Tile UV offset; animate this for scrolling effects |
-
-Total tile area uses `Transform.size`.
-
-## Required setup
+`TilingSprite.componentName = 'TilingSprite'`; `TilingSpriteSystem.systemName = 'TilingSprite'`.
 
-`RendererSystem` then `TilingSpriteSystem`. Resource must be registered and loaded before the component is added.
-
-## Common pitfalls
-
-| Symptom | Fix |
-|---------|-----|
-| Tiles cover entire canvas | Set `Transform.size` to the desired tile area |
-| Visible seams | Use a seamless texture (POT / power-of-two), set `tileScale` to integer values |
-| Scroll feels jumpy | Increment `tilePosition` by a per-frame `delta`, not a fixed amount per tick |
+```ts
+interface TilingSpriteParams {
+  resource: string; // RESOURCE_TYPE.IMAGE name
+  tileScale: { x: number; y: number };
+  tilePosition: { x: number; y: number };
+}
+```
 
-## Minimal example
+All three params are required. The class fields start with `tileScale: { x: 1, y: 1 }` and `tilePosition: { x: 0, y: 0 }` only when no params object overwrites them; normal resource construction must pass both vectors in full.
 
 ```ts
-const bg = new GameObject('bg', { position: { x: 0, y: 0 }, size: { width: 750, height: 1334 } });
 bg.addComponent(new TilingSprite({
   resource: 'bg-tile',
   tileScale: { x: 1, y: 1 },
@@ -47,8 +26,4 @@ bg.addComponent(new TilingSprite({
 }));
 ```
 
-To animate scrolling, drive `tilePosition` from a custom Component's `update(delta)`, not from bootstrap.
-
-## Verification
-
-`pnpm --filter @combos-fun/plugin-renderer-tiling-sprite run build`.
+The repeated area follows `Transform.size`. The system reads IMAGE `data.image` directly, so importing `plugin-renderer-img` is unnecessary. Mutating either vector is observed deeply; advance `tilePosition` using frame delta for smooth scrolling.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-renderer-tiling-sprite",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "Repeating tiled texture",
   "main": "index.js",
   "module": "dist/plugin-renderer-tiling-sprite.esm.js",
@@ -37,10 +37,10 @@
   "author": "sun668 <q947692259@gmail.com>",
   "dependencies": {
     "pixi.js": "^8.18.1",
-    "@combos-fun/plugin-renderer": "0.0.45",
-    "@combos-fun/renderer-adapter": "0.0.45",
-    "@combos-fun/inspector-decorator": "0.0.45",
-    "@combos-fun/engine": "0.0.45"
+    "@combos-fun/inspector-decorator": "0.0.47",
+    "@combos-fun/engine": "0.0.47",
+    "@combos-fun/plugin-renderer": "0.0.47",
+    "@combos-fun/renderer-adapter": "0.0.47"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"