@combos-fun/engine 0.0.3 → 0.0.4

package/dist/engine.cjs.js

@@ -954,6 +954,31 @@ class Scene extends GameObject {
     }
 }
 
+/**
+ * Sent to `window.parent` after each `System.init` completes during `Game.addSystem`
+ * (when running inside an iframe and parent differs from self).
+ */
+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 = '*') {
+    if (typeof window === 'undefined')
+        return;
+    if (!window.parent || window.parent === window)
+        return;
+    const payload = {
+        type: COMBOS_GAME_PLUGIN_INIT_SUCCESS,
+        systemName,
+    };
+    try {
+        window.parent.postMessage(payload, targetOrigin);
+    }
+    catch {
+        /* ignore cross-origin or detached frame */
+    }
+}
+
 function systemClassName(ctor) {
     if ('systemName' in ctor) {
         const sn = ctor.systemName;
@@ -1050,7 +1075,7 @@ const gameObjectPause = gameObjects => {
     }
 };
 class Game extends EventEmitter__default.default {
-    constructor({ systems, frameRate = 60, autoStart = true, needScene = true, onSystemsBootstrapComplete, } = {}) {
+    constructor({ systems, frameRate = 60, autoStart = true, needScene = true, onSystemsBootstrapComplete, pluginInitNotifyTargetOrigin = '*', } = {}) {
         super();
         /**
          * State of game
@@ -1061,6 +1086,11 @@ class Game extends EventEmitter__default.default {
         this.multiScenes = [];
         /** Systems alled to this game */
         this.systems = [];
+        /**
+         * Passed to `postMessage` when reporting `COMBOS_GAME_PLUGIN_INIT_SUCCESS` to `window.parent`.
+         */
+        this.pluginInitNotifyTargetOrigin = '*';
+        this.pluginInitNotifyTargetOrigin = pluginInitNotifyTargetOrigin;
         this.ticker = new Ticker({ autoStart: false, frameRate });
         this.initTicker();
         if (systems && systems.length) {
@@ -1134,6 +1164,7 @@ class Game extends EventEmitter__default.default {
         if (system.init) {
             await Promise.resolve(system.init(system.__systemDefaultParams));
         }
+        postParentPluginInitSuccess(systemClassName(system.constructor), this.pluginInitNotifyTargetOrigin);
         setSystemObserver(system, system.constructor);
         initObserver(system.constructor);
         try {
@@ -1666,6 +1697,7 @@ const decorators = {
 const version = '__VERSION__';
 console.log(`@combos-fun/engine version: ${version}`);
 
+exports.COMBOS_GAME_PLUGIN_INIT_SUCCESS = COMBOS_GAME_PLUGIN_INIT_SUCCESS;
 exports.Component = Component;
 exports.Game = Game;
 exports.GameObject = GameObject;
@@ -1676,6 +1708,7 @@ exports.System = System;
 exports.Transform = Transform;
 exports.componentObserver = componentObserver;
 exports.decorators = decorators;
+exports.postParentPluginInitSuccess = postParentPluginInitSuccess;
 exports.resource = resource;
 exports.resourceLoader = resourceLoader;
 exports.version = version;