@energy8platform/game-engine 0.14.1 → 0.14.3

package/dist/react.esm.js

@@ -22,7 +22,7 @@ function extend(components) {
 
 const RESERVED = new Set(['children', 'key', 'ref']);
 /** Props handled by the reconciler as flex item config, not forwarded to components */
-const FLEX_ITEM_PROPS$1 = new Set(['flexGrow', 'flexShrink', 'layoutWidth', 'layoutHeight', 'alignSelf', 'flexExclude']);
+const FLEX_ITEM_PROPS$1 = new Set(['flexGrow', 'flexShrink', 'layoutWidth', 'layoutHeight', 'alignSelf', 'flexExclude', 'top', 'right', 'bottom', 'left']);
 // ─── UI Component helpers ────────────────────────────────
 /**
  * Extract a config object from React props.
@@ -444,6 +444,7 @@ class FlexContainer extends Container {
     /** @internal */ _rawHeight;
     _layoutChildren = [];
     _layoutDirty = true;
+    _layoutSuspended = false;
     constructor(config = {}) {
         super();
         this._config = {
@@ -505,7 +506,19 @@ class FlexContainer extends Container {
             }
         }
         const result = super.addChild(...children);
-        if (this._layoutDirty)
+        if (this._layoutDirty && !this._layoutSuspended)
+            this.updateLayout();
+        return result;
+    }
+    addChildAt(child, index) {
+        if (!this._layoutChildren.includes(child)) {
+            // Insert into layout children at matching position
+            const layoutIndex = Math.min(index, this._layoutChildren.length);
+            this._layoutChildren.splice(layoutIndex, 0, child);
+            this._layoutDirty = true;
+        }
+        const result = super.addChildAt(child, index);
+        if (this._layoutDirty && !this._layoutSuspended)
             this.updateLayout();
         return result;
     }
@@ -523,12 +536,23 @@ class FlexContainer extends Container {
     get flexChildren() {
         return this._layoutChildren;
     }
+    /** Suspend automatic layout recalculation. Call resumeLayout() to flush. */
+    suspendLayout() {
+        this._layoutSuspended = true;
+    }
+    /** Resume automatic layout and flush if dirty. */
+    resumeLayout() {
+        this._layoutSuspended = false;
+        if (this._layoutDirty)
+            this.updateLayout();
+    }
     /** Update the container size and recalculate layout */
     resize(width, height) {
         this._explicitWidth = width;
         this._explicitHeight = height;
         this._layoutDirty = true;
-        this.updateLayout();
+        if (!this._layoutSuspended)
+            this.updateLayout();
     }
     /** Update layout direction */
     setDirection(direction) {
@@ -561,6 +585,10 @@ class FlexContainer extends Container {
      * adding/removing children without resize.
      */
     updateLayout() {
+        if (this._layoutSuspended) {
+            this._layoutDirty = true;
+            return;
+        }
         this._layoutDirty = false;
         const { direction, justifyContent, alignItems, gap, flexWrap, alignContent } = this._config;
         const [pt, pr, pb, pl] = this._padding;
@@ -769,11 +797,12 @@ class FlexContainer extends Container {
                 this._explicitWidth = typeof w === 'number' ? w : 0;
                 this._explicitHeight = typeof h === 'number' ? h : 0;
                 this._layoutDirty = true;
-                this.updateLayout();
+                if (!this._layoutSuspended)
+                    this.updateLayout();
             }
             return;
         }
-        if (this._layoutDirty)
+        if (this._layoutDirty && !this._layoutSuspended)
             this.updateLayout();
     }
     destroy(options) {
@@ -784,6 +813,11 @@ class FlexContainer extends Container {
 
 /** Flex item prop names that should be forwarded to _flexConfig on the child */
 const FLEX_ITEM_PROPS = ['flexGrow', 'flexShrink', 'layoutWidth', 'layoutHeight', 'alignSelf', 'flexExclude', 'top', 'right', 'bottom', 'left'];
+function isSuspendable(obj) {
+    return typeof obj?.suspendLayout === 'function' && typeof obj?.resumeLayout === 'function';
+}
+/** Layout containers that need flush after commit phase */
+const pendingLayoutFlush = new Set();
 /** Extract FlexItemConfig from props if any flex item props are present */
 function extractFlexItemConfig(props) {
     let config;
@@ -848,6 +882,8 @@ const hostConfig = {
     },
     appendInitialChild(parent, child) {
         if (child instanceof Container) {
+            if (isSuspendable(parent))
+                parent.suspendLayout();
             if (parent instanceof FlexContainer) {
                 addChildToFlex(parent, child);
             }
@@ -858,6 +894,10 @@ const hostConfig = {
     },
     appendChild(parent, child) {
         if (child instanceof Container) {
+            if (isSuspendable(parent)) {
+                parent.suspendLayout();
+                pendingLayoutFlush.add(parent);
+            }
             if (parent instanceof FlexContainer) {
                 addChildToFlex(parent, child);
             }
@@ -872,6 +912,10 @@ const hostConfig = {
     },
     removeChild(parent, child) {
         if (child instanceof Container) {
+            if (isSuspendable(parent)) {
+                parent.suspendLayout();
+                pendingLayoutFlush.add(parent);
+            }
             parent.removeChild(child);
             child.destroy({ children: true });
         }
@@ -886,6 +930,10 @@ const hostConfig = {
         if (child instanceof Container && beforeChild instanceof Container) {
             if (child.parent)
                 child.parent.removeChild(child);
+            if (isSuspendable(parent)) {
+                parent.suspendLayout();
+                pendingLayoutFlush.add(parent);
+            }
             const index = parent.getChildIndex(beforeChild);
             parent.addChildAt(child, index);
         }
@@ -923,7 +971,11 @@ const hostConfig = {
             instance.eventMode = 'static';
         }
     },
-    finalizeInitialChildren() {
+    finalizeInitialChildren(instance) {
+        // Resume layout after all initial children have been appended
+        if (isSuspendable(instance)) {
+            instance.resumeLayout();
+        }
         return false;
     },
     prepareUpdate() {
@@ -944,7 +996,13 @@ const hostConfig = {
     prepareForCommit() {
         return null;
     },
-    resetAfterCommit() { },
+    resetAfterCommit() {
+        // Flush deferred layout for all FlexContainers modified during this commit
+        for (const fc of pendingLayoutFlush) {
+            fc.resumeLayout();
+        }
+        pendingLayoutFlush.clear();
+    },
     preparePortalMount() { },
     scheduleTimeout: setTimeout,
     cancelTimeout: clearTimeout,
@@ -1772,6 +1830,14 @@ class Panel extends Container {
     get content() {
         return this._content;
     }
+    /** Suspend content layout recalculation. Call resumeLayout() to flush. */
+    suspendLayout() {
+        this._content.suspendLayout();
+    }
+    /** Resume content layout and flush if dirty. */
+    resumeLayout() {
+        this._content.resumeLayout();
+    }
     /** Convenience: add a child to the content layout */
     addContent(child) {
         this._content.addFlexChild(child);