Add radio buttons

README.md

@@ -26,6 +26,7 @@ To know more about the library and how to get started check the [examples](https
 - Text
 - Buttons
 - Checkboxes
+- Radio Buttons
 - Sliders
 - Text Input
 - Movable components (including windows)

core/src/main/scala/eu/joaocosta/interim/api/Components.scala

@@ -39,6 +39,27 @@ trait Components:
     if (itemStatus.hot && itemStatus.active && summon[InputState].mouseDown == false) Ref.modify(value, v => !v)
     else Ref.get(value)
 
+  /** Radio button component. Returns value currently selected.
+    *
+    * @param buttonIndex the index of this button (value that this button returns when selected)
+    * @param label text label to show on this button
+    */
+  final def radioButton(
+      id: ItemId,
+      area: Rect,
+      buttonIndex: Int,
+      label: String,
+      skin: ButtonSkin = ButtonSkin.default()
+  )(value: Int | Ref[Int]): Component[Int] =
+    val buttonArea = skin.buttonArea(area)
+    val itemStatus = UiState.registerItem(id, buttonArea)
+    val newValue =
+      if (itemStatus.hot && itemStatus.active && summon[InputState].mouseDown == false) Ref.set[Int](value, buttonIndex)
+      else Ref.get[Int](value)
+    if (newValue == buttonIndex) skin.renderButton(area, label, itemStatus.copy(hot = true, active = true))
+    else (skin.renderButton(area, label, itemStatus))
+    newValue
+
   /** Slider component. Returns the current position of the slider, between min and max.
     *
     * @param min minimum value for this slider

core/src/main/scala/eu/joaocosta/interim/api/Ref.scala

@@ -33,8 +33,24 @@ object Ref {
     * The new value is returned. Refs will be mutated while immutable values will not.
     */
   inline def modify[T](x: T | Ref[T], f: T => T): T = x match
-    case value: T => f(value)
+    case value: T =>
+      f(value)
     case ref: Ref[T] =>
       ref.value = f(ref.value)
       ref.value
+
+  /** Creates a Ref that can be used inside a block and returns that value.
+    *
+    * Useful to set temporary mutable variables.
+    */
+  def withRef[T](initialValue: T)(block: Ref[T] => Unit): T =
+    val ref = Ref(initialValue)
+    block(ref)
+    ref.value
+
+  /** Wraps this value into a Ref and passes it to a block, returning the final value of the ref.
+    *
+    * Useful to set temporary mutable variables.
+    */
+  extension [T](x: T) def asRef(block: Ref[T] => Unit): T = withRef(x)(block)
 }