@combos-fun/engine 0.0.13 → 0.0.15

package/agent-skill.md

@@ -36,6 +36,21 @@ Read this every time before working on a Combos Fun project. The entry skill loa
 | `pluginInitNotifyTargetOrigin` | `string`                 | `'*'`   | postMessage target                       |
 
 
+When the game runs inside an iframe (`window.parent !== window`), each `Game.addSystem` call posts to the parent after that system's `init` completes:
+
+```typescript
+{
+  type: 'combos-game:plugin-init-success',
+  systemName: string,       // System.systemName
+  engineVersion: string,    // @combos-fun/engine build version
+  packageName?: string,     // npm name, injected at plugin build
+  packageVersion?: string,  // semver from plugin package.json, injected at plugin build
+}
+```
+
+Official `@combos-fun/plugin-*` packages get `packageName` / `packageVersion` automatically via `scripts/build-package.mjs` (no hand-written static fields). Host pages can gate tooling on specific systems or versions using this payload. Types: `CombosGamePluginInitSuccessMessage`, helper `postParentPluginInitSuccess` in `bootstrapMessages.ts`.
+
+
 ### `Game` methods
 
 `addSystem(system)`, `removeSystem(system | class | string)` (calls `system.destroy()` internally), `getSystem(class | string)`, `loadScene({ scene, mode?, params? })` (`LOAD_SCENE_MODE.SINGLE | MULTI_CANVAS`), `start()`, `pause()`, `resume()`, `destroy()`.

package/dist/engine.cjs.js

@@ -963,6 +963,9 @@ class Scene extends GameObject {
     }
 }
 
+/** Generated at build from package.json */
+const version = "0.0.15";
+
 /**
  * Sent to `window.parent` after each `System.init` completes during `Game.addSystem`
  * (when running inside an iframe and parent differs from self).
@@ -971,14 +974,17 @@ const COMBOS_GAME_PLUGIN_INIT_SUCCESS = "combos-game:plugin-init-success";
 /**
  * Notifies the embedding page that a system (plugin) finished async/sync `init`.
  */
-function postParentPluginInitSuccess(systemName, targetOrigin = "*") {
+function postParentPluginInitSuccess(input, targetOrigin = "*") {
     if (typeof window === "undefined")
         return;
     if (!window.parent || window.parent === window)
         return;
     const payload = {
         type: COMBOS_GAME_PLUGIN_INIT_SUCCESS,
-        systemName,
+        systemName: input.systemName,
+        engineVersion: version,
+        ...(input.packageName ? { packageName: input.packageName } : {}),
+        ...(input.packageVersion ? { packageVersion: input.packageVersion } : {}),
     };
     try {
         window.parent.postMessage(payload, targetOrigin);
@@ -996,6 +1002,13 @@ function systemClassName(ctor) {
     }
     return "UnknownSystem";
 }
+function systemPackageMeta(ctor) {
+    const meta = ctor;
+    return {
+        packageName: typeof meta.packageName === "string" ? meta.packageName : undefined,
+        packageVersion: typeof meta.packageVersion === "string" ? meta.packageVersion : undefined,
+    };
+}
 function componentClassName(ctor) {
     if ("componentName" in ctor) {
         const cn = ctor.componentName;
@@ -1173,7 +1186,10 @@ class Game extends EventEmitter__default.default {
         if (system.init) {
             await Promise.resolve(system.init(system.__systemDefaultParams));
         }
-        postParentPluginInitSuccess(systemClassName(system.constructor), this.pluginInitNotifyTargetOrigin);
+        postParentPluginInitSuccess({
+            systemName: systemClassName(system.constructor),
+            ...systemPackageMeta(system.constructor),
+        }, this.pluginInitNotifyTargetOrigin);
         setSystemObserver(system, system.constructor);
         initObserver(system.constructor);
         try {
@@ -1709,7 +1725,6 @@ const decorators = {
     IDEProp,
     componentObserver,
 };
-const version = '__VERSION__';
 console.log(`@combos-fun/engine version: ${version}`);
 
 exports.COMBOS_GAME_PLUGIN_INIT_SUCCESS = COMBOS_GAME_PLUGIN_INIT_SUCCESS;