@combos-fun/plugin-renderer-img 0.0.45 → 0.0.46

package/agent-skill.md

@@ -1,59 +1,21 @@
 # `@combos-fun/plugin-renderer-img` — Agent notes
 
-Static image rendering for the 2D pipeline. Loads an `IMAGE` resource and draws it as a Pixi `Sprite` under the GameObject's `Container`.
-
-## When to read
-
-Read whenever you need a single static image: icons, backgrounds, single-frame foregrounds.
-
-## Public API
+Read only for one standalone static image. For a frame inside an atlas, use `Sprite`.
 
 ```ts
 import { Img, ImgSystem, type ImgParams } from '@combos-fun/plugin-renderer-img';
-import { resource, RESOURCE_TYPE } from '@combos-fun/engine';
 ```
 
-`componentName = 'Img'`, `systemName = 'Img'` (class is `ImgSystem` — use `game.getSystem(ImgSystem)`, not the string).
-
-### `ImgParams`
-
-| Field | Type | Notes |
-|-------|------|-------|
-| `resource` | `string` | Engine resource name registered with `RESOURCE_TYPE.IMAGE` |
-
-Side effect: importing the package registers `IMAGE` resource handlers on the engine `resource` singleton.
-
-## Required setup
-
-1. `RendererSystem` and `ImgSystem` registered in that order.
-2. `resource.addResource` with `{ image: { type, url } }`; `name` matches the component's `resource`.
-
-## Common pitfalls
-
-| Symptom | Fix |
-|---------|-----|
-| Resource name not found | Ensure name matches `resource.addResource` and that loading completed (`preload: true` or wait `LOAD_EVENT.COMPLETE`) |
-| `src.<slot>.url is required` | That slot has no url |
-| Image at origin (0,0) | Set `Transform.position` |
-| Wrong anchor | Set `Transform.origin: { x: 0.5, y: 0.5 }` for center anchoring |
-| Multiple drawables on same GO | Don't stack `Img` + `Sprite` — split GOs |
-
-## Minimal example
+`Img.componentName = 'Img'`; `ImgSystem.systemName = 'Img'`.
 
 ```ts
-resource.addResource([
-  {
-    name: 'logo',
-    type: RESOURCE_TYPE.IMAGE,
-    src: { image: { type: 'png', url: 'https://cdn.example/logo.png' } },
-    preload: true,
-  },
-]);
+interface ImgParams {
+  resource: string; // RESOURCE_TYPE.IMAGE name
+}
 
-const go = new GameObject('logo', { position: { x: 100, y: 100 }, size: { width: 200, height: 200 } });
 go.addComponent(new Img({ resource: 'logo' }));
 ```
 
-## Verification
+Importing the package registers the IMAGE instance and destroy handlers. The system reacts to `resource` changes.
 
-`pnpm --filter @combos-fun/plugin-renderer-img run build`.
+Display width and height always follow `Transform.size`; intrinsic image dimensions are not adopted. Set `Transform.position`, `size`, and `origin` as needed—a zero size makes the image invisible.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/plugin-renderer-img",
-  "version": "0.0.45",
+  "version": "0.0.46",
   "description": "Static image rendering",
   "main": "index.js",
   "module": "dist/plugin-renderer-img.esm.js",
@@ -35,10 +35,10 @@
   "author": "sun668 <q947692259@gmail.com>",
   "dependencies": {
     "pixi.js": "^8.18.1",
-    "@combos-fun/plugin-renderer": "0.0.45",
-    "@combos-fun/engine": "0.0.45",
-    "@combos-fun/renderer-adapter": "0.0.45",
-    "@combos-fun/inspector-decorator": "0.0.45"
+    "@combos-fun/plugin-renderer": "0.0.46",
+    "@combos-fun/renderer-adapter": "0.0.46",
+    "@combos-fun/engine": "0.0.46",
+    "@combos-fun/inspector-decorator": "0.0.46"
   },
   "scripts": {
     "build": "node ../../scripts/build-package.mjs"