@combos-fun/engine 0.0.3 → 0.0.5

package/dist/engine.cjs.js

@@ -954,21 +954,46 @@ 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) {
+    if ("systemName" in ctor) {
         const sn = ctor.systemName;
-        if (typeof sn === 'string')
+        if (typeof sn === "string")
             return sn;
     }
-    return 'UnknownSystem';
+    return "UnknownSystem";
 }
 function componentClassName(ctor) {
-    if ('componentName' in ctor) {
+    if ("componentName" in ctor) {
         const cn = ctor.componentName;
-        if (typeof cn === 'string')
+        if (typeof cn === "string")
             return cn;
     }
-    return 'UnknownComponent';
+    return "UnknownComponent";
 }
 exports.LOAD_SCENE_MODE = void 0;
 (function (LOAD_SCENE_MODE) {
@@ -993,7 +1018,7 @@ const triggerStart = (obj) => {
         }
     }
 };
-const getAllGameObjects = game => {
+const getAllGameObjects = (game) => {
     const mainSceneGameObjects = game?.scene?.gameObjects || [];
     const gameObjectsArray = game?.multiScenes.map(({ gameObjects }) => gameObjects);
     let otherSceneGameObjects = [];
@@ -1025,7 +1050,7 @@ const gameObjectLoop = (e, gameObjects = []) => {
         }
     }
 };
-const gameObjectResume = gameObjects => {
+const gameObjectResume = (gameObjects) => {
     for (const gameObject of gameObjects) {
         for (const component of gameObject.components) {
             try {
@@ -1037,7 +1062,7 @@ const gameObjectResume = gameObjects => {
         }
     }
 };
-const gameObjectPause = gameObjects => {
+const gameObjectPause = (gameObjects) => {
     for (const gameObject of gameObjects) {
         for (const component of gameObject.components) {
             try {
@@ -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) {
@@ -1079,7 +1109,7 @@ class Game extends EventEmitter__default.default {
                 await this.addSystem(system);
             }
             if (needScene) {
-                this.loadScene(new Scene('scene'));
+                this.loadScene(new Scene("scene"));
             }
             if (autoStart) {
                 this.start();
@@ -1087,7 +1117,7 @@ class Game extends EventEmitter__default.default {
         }
         catch (e) {
             error = e;
-            console.error('Game bootstrap failed', e);
+            console.error("Game bootstrap failed", e);
         }
         finally {
             onComplete?.(this, error);
@@ -1120,10 +1150,10 @@ class Game extends EventEmitter__default.default {
             system = S;
         }
         else {
-            console.warn('can only add System');
+            console.warn("can only add System");
             return;
         }
-        const hasTheSystem = this.systems.find(item => {
+        const hasTheSystem = this.systems.find((item) => {
             return item.constructor === system.constructor;
         });
         if (hasTheSystem) {
@@ -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 {
@@ -1153,14 +1184,14 @@ class Game extends EventEmitter__default.default {
         if (!system)
             return;
         let index = -1;
-        if (typeof system === 'string') {
-            index = this.systems.findIndex(s => s.name === system);
+        if (typeof system === "string") {
+            index = this.systems.findIndex((s) => s.name === system);
         }
         else if (system instanceof Function) {
-            index = this.systems.findIndex(s => s.constructor === system);
+            index = this.systems.findIndex((s) => s.constructor === system);
         }
         else if (system instanceof System) {
-            index = this.systems.findIndex(s => s === system);
+            index = this.systems.findIndex((s) => s === system);
         }
         if (index > -1) {
             this.systems[index].destroy && this.systems[index].destroy();
@@ -1173,8 +1204,8 @@ class Game extends EventEmitter__default.default {
      * @returns system instance
      */
     getSystem(S) {
-        return this.systems.find(system => {
-            if (typeof S === 'string') {
+        return this.systems.find((system) => {
+            if (typeof S === "string") {
                 return system.name === S;
             }
             else {
@@ -1216,7 +1247,7 @@ class Game extends EventEmitter__default.default {
      * 4. call lastUpdate method on all system
      */
     initTicker() {
-        this.ticker.add(e => {
+        this.ticker.add((e) => {
             this.scene && gameObjectLoop(e, this.gameObjects);
             for (const system of this.systems) {
                 try {
@@ -1280,7 +1311,7 @@ class Game extends EventEmitter__default.default {
         this.canvas = null;
         this.multiScenes = null;
     }
-    loadScene({ scene, mode = exports.LOAD_SCENE_MODE.SINGLE, params = {} }) {
+    loadScene({ scene, mode = exports.LOAD_SCENE_MODE.SINGLE, params = {}, }) {
         if (!scene) {
             return;
         }
@@ -1292,7 +1323,7 @@ class Game extends EventEmitter__default.default {
                 this.multiScenes.push(scene);
                 break;
         }
-        this.emit('sceneChanged', { scene, mode, params });
+        this.emit("sceneChanged", { scene, mode, params });
     }
 }