@combos-fun/engine 0.0.46 → 0.0.48

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@combos-fun/engine",
-  "version": "0.0.46",
+  "version": "0.0.48",
   "description": "ECS microkernel",
   "main": "index.js",
   "module": "dist/engine.esm.js",
@@ -45,7 +45,7 @@
     "lodash-es": "^4.17.21",
     "resource-loader": "^4.0.0-rc4",
     "sprite-timeline": "^1.10.2",
-    "@combos-fun/inspector-decorator": "0.0.46"
+    "@combos-fun/inspector-decorator": "0.0.48"
   },
   "devDependencies": {
     "tsx": "^4.20.3"

package/plugin-authoring.md

@@ -150,6 +150,10 @@ class MyRenderer3D extends Renderer3D {
 
 **Async loading pattern** (3D only): use the inherited `increaseAsyncId(id)` before async work and `validateAsyncId(id, asyncId)` after each `await` to cancel stale operations when the component is removed mid-load.
 
+## Host `postMessage` type names
+
+Only `@combos-fun/engine` may invent `combos-game:*` types (`plugin-init-success`, `ready`, `set-playing`, `state-changed`). Every other plugin’s iframe / parent / `window` / `game.emit` host command uses the `combos-development-tool:` prefix — including features implemented outside `plugin-development-tool` (for example mute in `plugin-sound`). Do not add `combos-sound:*`, `combos-<plugin>:*`, or a new prefix.
+
 ## `combos-plugin.json` (manifest)
 
 Validate against `schemas/combos-plugin.schema.json`. Required fields: `name`, `pluginId`, `category`, `dimension`, `agentSkill`. For non-core packages, `category` ∈ {`rendering`, `physics`, `audio`, `input`, `ui`, `a11y`, `animation`, `devtool`, `other`} and `dimension` ∈ {`2d`, `3d`, `shared`}.

package/references/public-api.md

@@ -61,7 +61,7 @@ Core `Game` speaks a `postMessage` protocol with the embedding page so a host AP
 
 Recommended flow: create the game with `autoStart:false`, wait for `combos-game:ready`, keep the game held at frame 0 (host shows a cover/loading overlay), then post `{ type: 'combos-game:set-playing', playing: true }` when the user taps play. `game.setPlaying(playing)` is the programmatic equivalent. Helpers: `postParentGameReady`, `postParentGameState`, `parseSetPlayingMessage`.
 
-> Note: play/pause is owned by the engine core here, **not** by `plugin-development-tool` (which now only handles pick mode + mute).
+> Host type prefix: **only** this engine package uses `combos-game:*`. Every plugin host message (mute, pick, scene edit, …) uses `combos-development-tool:*`, even when the handler lives in another plugin such as `@combos-fun/plugin-sound`. Play/pause stays here; mute is `plugin-sound` listening to `combos-development-tool:set-muted` / posting `combos-development-tool:state-changed`.
 
 
 ### `Game` methods