minor fixes, improvements & javadoc

Author: brachy84

src/main/java/com/cleanroommc/modularui/api/widget/IWidget.java

@@ -168,7 +168,8 @@ default boolean hasChildren() {
     ModularPanel getPanel();
 
     /**
-     * Returns if this element is enabled. Disabled elements are not drawn and can not be interacted with.
+     * Returns if this element is enabled. Disabled elements are not drawn and can not be interacted with. If this is disabled, the children
+     * will be considered disabled to without actually being disabled.
      *
      * @return if this element is enabled
      */
@@ -177,6 +178,11 @@ default boolean hasChildren() {
 
     void setEnabled(boolean enabled);
 
+    /**
+     * Checks if all ancestors are enabled. Only then this widget is visible and interactable.
+     *
+     * @return if all ancestors are enabled.
+     */
     default boolean areAncestorsEnabled() {
         IWidget parent = this;
         do {
@@ -186,14 +192,32 @@ default boolean areAncestorsEnabled() {
         return true;
     }
 
+    /**
+     * If this widget can be seen on the screen even partly. If this returns false it will be culled. This is visually only!
+     *
+     * @param stack viewport stack
+     * @return false if this widget can not be seen currently and should not be drawn
+     */
     default boolean canBeSeen(IViewportStack stack) {
         return Stencil.isInsideScissorArea(getArea(), stack);
     }
 
+    /**
+     * Determines if this widget can have any hover interaction. Interactions with mouse or keyboard like clicks ignore this.
+     * This is useful, when you have a widget which changes its background when hovered or has a tooltip and some decoration child. Normally
+     * you can click through the child, but while you hover it the widget will not show its tooltip etc. To change that return false here.
+     *
+     * @return if this widget can have any hover interaction
+     */
     default boolean canHover() {
         return true;
     }
 
+    /**
+     * Determines if widgets below this can receive a click callback. This is only called when this widget didn't consume the click.
+     *
+     * @return if widgets below this should be able to receive a click
+     */
     default boolean canClickThrough() {
         return true;
     }

src/main/java/com/cleanroommc/modularui/test/TestTile.java

@@ -164,10 +164,8 @@ public ModularPanel buildUI(PosGuiData guiData, PanelSyncManager syncManager, UI
                         .background(GuiTextures.MC_BACKGROUND)
                         .excludeAreaInJei()
                         .stencilTransform((r, expanded) -> {
-                            if (expanded) {
-                                r.width -= 5;
-                                r.height -= 5;
-                            }
+                            r.width = Math.max(20, r.width - 5);
+                            r.height = Math.max(20, r.height - 5);
                         })
                         .animationDuration(500)
                         .interpolation(Interpolation.BOUNCE_OUT)
@@ -445,8 +443,8 @@ public ModularPanel openSecondWindow(PanelSyncManager syncManager, IPanelHandler
                 .setDraggable(true)
                 .size(100, 100);
         SlotGroup slotGroup = new SlotGroup("small_inv", 2);
-        IntSyncValue timeSync = new IntSyncValue(() -> (int)java.lang.System.currentTimeMillis());
-        syncManager.syncValue(123456,timeSync);
+        IntSyncValue timeSync = new IntSyncValue(() -> (int) java.lang.System.currentTimeMillis());
+        syncManager.syncValue(123456, timeSync);
         syncManager.registerSlotGroup(slotGroup);
         AtomicInteger number = new AtomicInteger(0);
         syncManager.syncValue("int_value", new IntSyncValue(number::get, number::set));

src/main/java/com/cleanroommc/modularui/widget/Widget.java

@@ -618,7 +618,7 @@ public Flex getFlex() {
      */
     @Override
     public Flex flex() {
-        return this.flex;
+        return getFlex();
     }
 
     /**

src/main/java/com/cleanroommc/modularui/widget/sizer/Area.java

@@ -106,7 +106,7 @@ public int ey() {
     }
 
     public void ey(int ey) {
-        this.y = ey - this.width;
+        this.y = ey - this.height;
     }
 
     public int mx() {

src/main/java/com/cleanroommc/modularui/widgets/layout/Flow.java

@@ -7,6 +7,8 @@
 import com.cleanroommc.modularui.widget.ParentWidget;
 import com.cleanroommc.modularui.widget.sizer.Box;
 
+import java.util.function.IntFunction;
+
 public class Flow extends ParentWidget<Flow> implements ILayoutWidget, IExpander {
 
     public static Flow row() {
@@ -176,6 +178,20 @@ public void onChildChangeEnabled(IWidget child, boolean enabled) {
         }
     }
 
+    public Flow children(Iterable<IWidget> widgets) {
+        for (IWidget widget : widgets) {
+            child(widget);
+        }
+        return getThis();
+    }
+
+    public Flow children(int amount, IntFunction<IWidget> widgetCreator) {
+        for (int i = 0; i < amount; i++) {
+            child(widgetCreator.apply(i));
+        }
+        return getThis();
+    }
+
     public Flow crossAxisAlignment(Alignment.CrossAxis caa) {
         this.caa = caa;
         return this;