@combos-fun/renderer-adapter 0.0.45 → 0.0.47

package/agent-skill.md

@@ -1,76 +1,57 @@
 # `@combos-fun/renderer-adapter` — Agent notes
 
-Pixi v8 display-object adapter layer used by `@combos-fun/plugin-renderer` and its 2D rendering sub-plugins. **Not** a game `System`. It exposes a stable shape over Pixi primitives so 2D rendering plugins are not coupled to a specific Pixi version.
+Pixi v8 adapter types used by `@combos-fun/plugin-renderer` and its 2D renderer plugins. This package is not a game System.
 
 ## When to read
 
-Read whenever a 2D rendering task touches `Container` parenting, low-level Pixi display object shape, or whenever the entry skill loads "Core" packages for any project.
+Read only for a 2D/Pixi rendering task or when authoring a custom 2D renderer.
 
 ## Public API
 
-Wrappers re-exported from `@combos-fun/renderer-adapter`:
+| Export | Shape | Pass to `addChild` |
+|---|---|---|
+| `Application` | Pixi re-export | — |
+| `Container`, `Graphics`, `Text`, `NinePatch` | Pixi subclasses | adapter instance |
+| `Sprite` | composition | `sprite.sprite` |
+| `TilingSprite` | composition | `tilingSprite.tilingSprite` |
+| `SpriteAnimation` | composition | `spriteAnimation.animatedSprite` |
 
-| Export | Wraps | Used by |
-|--------|-------|---------|
-| `Application` | `pixi.js` Application | `RendererSystem` (plugin-renderer) bootstrap |
-| `Container` | `PIXI.Container` | All container parenting via `containerManager` |
-| `Graphics` | `PIXI.Graphics` | `plugin-renderer-graphics` |
-| `Sprite` | `PIXI.Sprite` | `plugin-renderer-sprite`, `plugin-renderer-img` |
-| `SpriteAnimation` | Pixi animated sprite | `plugin-renderer-sprite-animation` |
-| `NinePatch` | nine-slice sprite | `plugin-renderer-nine-patch` |
-| `TilingSprite` | `PIXI.TilingSprite` | `plugin-renderer-tiling-sprite` |
-| `Text` | `PIXI.Text` | `plugin-renderer-text` |
-
-These are **adapter classes** — plugins consume them, end users typically do not import them directly.
+End users normally consume higher-level renderer plugins rather than these adapters.
 
 ## Required setup
 
-None on the user side. Adapter is a dependency of `@combos-fun/plugin-renderer` and is loaded transitively. End users install the plugin packages, not the adapter directly.
+None for ordinary game code; `plugin-renderer` loads the adapter transitively.
 
 ## Runtime behaviour
 
-- Each wrapper instantiates a Pixi display object and exposes a thin API used
-  by the matching renderer plugin.
-- All 2D rendering plugins reach Pixi via these wrappers; if you are
-  authoring a custom 2D rendering plugin, prefer extending `Renderer` from
-  `plugin-renderer` and constructing display objects via the matching adapter
-  type. Do **not** import `pixi.js` directly in plugin code.
+Custom 2D renderer plugins extend `Renderer`, register with `RendererSystem.rendererManager`, and use adapter display objects with `containerManager.getContainer(gameObject.id)`.
 
 ## Common pitfalls
 
-- Coupling a custom 2D rendering plugin directly to `pixi.js` means a Pixi
-  major bump can break the plugin. Use the adapter types instead.
-- Mixing adapter `Container` and raw `PIXI.Container` in the same scene
-  graph is not supported — `containerManager.getContainer(gameObject.id)`
-  returns the adapter type.
+- Do not import `pixi.js` directly in a custom 2D renderer plugin.
+- A composition adapter is not itself displayable; add its inner Pixi object.
+- Do not mix raw Pixi containers with adapter containers.
 
 ## Minimal example
 
-Inside a custom 2D rendering plugin's `Renderer` subclass:
-
 ```ts
 import { Sprite } from '@combos-fun/renderer-adapter';
 import { Renderer, RendererSystem } from '@combos-fun/plugin-renderer';
 
 class MyRenderer extends Renderer {
   init() {
-    this.rendererSystem = this.game.getSystem(RendererSystem);
-    this.rendererSystem.rendererManager.register(this);
+    this.game.getSystem(RendererSystem).rendererManager.register(this);
   }
-  componentChanged(changed) {
-    if (changed.type === OBSERVER_TYPE.ADD) {
-      const sprite = new Sprite(/* ... */);
-      const container = this.rendererSystem.containerManager.getContainer(
-        changed.gameObject.id,
-      );
-      container.addChild(sprite);
-    }
+
+  add(gameObject, texture) {
+    const sprite = new Sprite(texture);
+    this.containerManager.getContainer(gameObject.id).addChild(sprite.sprite);
   }
 }
 ```
 
+Subclass adapters use `container.addChild(new Graphics())` directly.
+
 ## Verification
 
-- `pnpm --filter @combos-fun/renderer-adapter run build` should succeed.
-- After upgrading `pixi.js`, run any example app from `examples/` to verify
-  no rendering regression.
+Run `pnpm --filter @combos-fun/renderer-adapter run build`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/renderer-adapter",
-  "version": "0.0.45",
+  "version": "0.0.47",
   "description": "Pixi v8 display-object adapter layer used by @combos-fun/plugin-renderer and its 2D rendering sub-plugins",
   "main": "index.js",
   "module": "dist/renderer-adapter.esm.js",