LayoutDSL: Improve component names

With LayoutDSL, all components eventually end up being called just
"BoxContainer", "RowContainer", etc. which isn't too useful.

This commit adds code to automatically try to guess better names by
peeking at the call stack.
This allows LayoutDSL-style function components to automatically receive
the name of the function.

Source-Commit: 8d180e417aa2e1589966466b577542c08f3c0f19

Author: Johni0702

unstable/layoutdsl/src/main/kotlin/gg/essential/elementa/layoutdsl/containers.kt

@@ -26,7 +26,7 @@ fun LayoutScope.box(modifier: Modifier = Modifier, block: LayoutScope.() -> Unit
     }
 
     val container = TransparentBlock().apply {
-        componentName = "BoxContainer"
+        automaticComponentName("box")
         setWidth(ChildBasedSizeConstraint())
         setHeight(ChildBasedSizeConstraint())
     }
@@ -46,7 +46,7 @@ fun LayoutScope.row(modifier: Modifier, horizontalArrangement: Arrangement = Arr
     }
 
     val rowContainer = TransparentBlock().apply {
-        componentName = "RowContainer"
+        automaticComponentName("row")
         setWidth(ChildBasedSizeConstraint())
         setHeight(ChildBasedMaxSizeConstraint())
     }
@@ -68,7 +68,7 @@ fun LayoutScope.column(modifier: Modifier, verticalArrangement: Arrangement = Ar
     }
 
     val columnContainer = TransparentBlock().apply {
-        componentName = "ColumnContainer"
+        automaticComponentName("column")
         setWidth(ChildBasedMaxSizeConstraint())
         setHeight(ChildBasedSizeConstraint())
     }
@@ -93,7 +93,7 @@ fun LayoutScope.flowContainer(
     }
 
     val flowContainer = TransparentBlock().apply {
-        componentName = "FlowContainer"
+        automaticComponentName("flowContainer")
         setHeight(ChildBasedSizeConstraint())
     }
 
@@ -132,7 +132,7 @@ fun LayoutScope.scrollable(
     val content = HollowUIContainer() childOf outer // actually adds to `inner` because ScrollComponent redirects it
 
     outer.apply {
-        componentName = "scrollable"
+        automaticComponentName("scrollable")
         setWidth(ChildBasedSizeConstraint() boundTo content)
         setHeight(ChildBasedSizeConstraint() boundTo content)
     }
@@ -165,6 +165,7 @@ fun LayoutScope.floatingBox(
     }
 
     val box = box(modifier, block)
+    box.automaticComponentName("floatingBox")
     effect(box) {
         box.isFloating = floating()
     }

unstable/layoutdsl/src/main/kotlin/gg/essential/elementa/layoutdsl/lazy.kt

@@ -21,6 +21,8 @@ fun LayoutScope.lazyBox(modifier: Modifier = Modifier.fillParent(), block: Layou
         } `else` {
             LazyComponent(initialized)(Modifier.fillParent())
         }
+    }.apply {
+        automaticComponentName("lazyBox")
     }
 }
 

unstable/layoutdsl/src/main/kotlin/gg/essential/elementa/layoutdsl/util.kt

@@ -6,6 +6,7 @@ import gg.essential.elementa.dsl.boundTo
 import gg.essential.elementa.dsl.percent
 import gg.essential.elementa.dsl.pixels
 import gg.essential.elementa.effects.Effect
+import gg.essential.elementa.utils.elementaDev
 import gg.essential.elementa.common.Spacer
 import java.awt.Color
 
@@ -32,6 +33,23 @@ internal inline fun <T> Iterable<T>.sumOf(selector: (T) -> Float): Float {
     return sum
 }
 
+fun UIComponent.automaticComponentName(default: String) {
+    if (!elementaDev) return
+
+    componentName = Throwable().stackTrace
+        .asSequence()
+        .filterNot { it.lineNumber == 1 } // synthetic accessor methods
+        .filterNot { it.methodName.endsWith("\$default") } // synthetic Kotlin defaults methods
+        .map { it.methodName }
+        .distinct() // collapse overloads
+        .drop(1) // "automaticComponentName"
+        .drop(1) // caller method (e.g. "box")
+        .firstOrNull()
+        ?.takeUnless { it == "invoke" } // anonymous component (the `block` of `LayoutScope.invoke`)
+        ?.takeUnless { it == "<init>" } // anonymous component (likely direct child of a class component)
+        ?: default
+}
+
 fun UIComponent.getChildModifier() =
     effects
         .filterIsInstance<ChildModifierMarker>()