@energy8platform/game-engine 0.14.1 → 0.14.3

package/dist/index.d.ts

@@ -1355,6 +1355,7 @@ declare class FlexContainer extends Container {
     /** @internal */ _rawHeight: number | string;
     private _layoutChildren;
     private _layoutDirty;
+    private _layoutSuspended;
     constructor(config?: FlexContainerConfig);
     /** Add a child with optional flex config. Also registers in flex layout. */
     addFlexChild(child: Container, flexConfig?: FlexItemConfig): this;
@@ -1367,9 +1368,14 @@ declare class FlexContainer extends Container {
      * This enables declarative usage from React JSX.
      */
     addChild<T extends Container>(...children: T[]): T;
+    addChildAt<T extends Container>(child: T, index: number): T;
     removeChild<T extends Container>(...children: T[]): T;
     /** Get all flex layout children (read-only) */
     get flexChildren(): readonly Container[];
+    /** Suspend automatic layout recalculation. Call resumeLayout() to flush. */
+    suspendLayout(): void;
+    /** Resume automatic layout and flush if dirty. */
+    resumeLayout(): void;
     /** Update the container size and recalculate layout */
     resize(width: number, height: number): void;
     /** Update layout direction */
@@ -1687,6 +1693,10 @@ declare class Panel extends Container {
     constructor(config?: PanelConfig);
     /** Access the content flex container — add children here for layout */
     get content(): FlexContainer;
+    /** Suspend content layout recalculation. Call resumeLayout() to flush. */
+    suspendLayout(): void;
+    /** Resume content layout and flush if dirty. */
+    resumeLayout(): void;
     /** Convenience: add a child to the content layout */
     addContent(child: Container): this;
     /** Resize the panel */

package/dist/index.esm.js

@@ -3150,6 +3150,7 @@ class FlexContainer extends Container {
     /** @internal */ _rawHeight;
     _layoutChildren = [];
     _layoutDirty = true;
+    _layoutSuspended = false;
     constructor(config = {}) {
         super();
         this._config = {
@@ -3211,7 +3212,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;
     }
@@ -3229,12 +3242,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) {
@@ -3267,6 +3291,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;
@@ -3475,11 +3503,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) {
@@ -4062,6 +4091,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);