feat(Layer): add startup lifecycle method

Desplandis · Desplandis · commit 35935c74e923 · 2025-09-25T13:08:20.000+02:00
diff --git a/packages/Main/src/Core/View.js b/packages/Main/src/Core/View.js
@@ -374,8 +374,7 @@ class View extends THREE.EventDispatcher {
             this.scene.add(layer.object3d);
         }
 
-        Promise.all(layer._promises).then(() => {
-            layer._resolve();
+        layer.startup().then(() => {
             this.notifyChange(parentLayer || layer, false);
             if (!this._frameRequesters[MAIN_LOOP_EVENTS.UPDATE_END] ||
                 !this._frameRequesters[MAIN_LOOP_EVENTS.UPDATE_END].includes(this._allLayersAreReadyCallback)) {
@@ -385,7 +384,7 @@ class View extends THREE.EventDispatcher {
                 type: VIEW_EVENTS.LAYER_ADDED,
                 layerId: layer.id,
             });
-        }, layer._reject);
+        });
 
         return layer.whenReady;
     }
diff --git a/packages/Main/src/Layer/Layer.js b/packages/Main/src/Layer/Layer.js
@@ -179,6 +179,21 @@ class Layer extends THREE.EventDispatcher {
         return resolve;
     }
 
+    /**
+     * The startup stage is the first stage of the layer lifecycle. It is called
+     * internally when the layer is added to the view.
+     * @param {View} context - the context the layer has been added to.
+     * @returns {Promise<void>}
+     */
+    async startup(/* context */) {
+        try {
+            await Promise.all(this._promises);
+            this._resolve();
+        } catch (error) {
+            this._reject(error);
+        }
+    }
+
     /**
      * Defines a property for this layer, with a default value and a callback
      * executed when the property changes.
