extend grid methods

Author: EmRe-One

src/main/kotlin/tr/emreone/kotlin_utils/extensions/Grid.kt

@@ -21,6 +21,12 @@ val Grid<*>.width: Int get() = firstOrNull()?.size ?: 0
 val Grid<*>.height: Int get() = size
 val Grid<*>.area: Area get() = origin to lastPoint
 
+val Iterable<Point>.area: Area get() = areaOrNull ?: error("No points given")
+val Iterable<Point>.areaOrNull: Area? get() = boundingArea()
+val MapGrid<*>.area: Area get() = areaOrNull ?: error("No points given in Map")
+val MapGrid<*>.areaOrNull: Area? get() = keys.boundingArea()
+
+
 /**
  * The last (bottom right) point in this [Grid] or `-1 to -1` for an empty Grid.
  */
@@ -165,6 +171,23 @@ fun <T> MapGrid<T>.formatted(
     }
 }
 
+fun <T> MapGrid<T>.formatted(
+    area: Area? = null,
+    filler: Any = ' ',
+    reverseX: Boolean = false,
+    reverseY: Boolean = false,
+    showHeaders: Boolean = true,
+    transform: (Point, T?) -> String? = { _, value -> "$value" },
+): String {
+    val relevantArea = area ?: keys.boundingArea() ?: return "empty map, nothing to show"
+    val default = filler.toString()
+    return relevantArea.buildFormatted(reverseX, reverseY, showHeaders) { col, row ->
+        val point = col to row
+        val value = get(point)
+        transform(col to row, value) ?: default
+    }
+}
+
 fun Iterable<Point>.plot(
     restrictArea: Area? = null, on: String = "#", off: String = " ",
     reverseX: Boolean = false,

src/main/kotlin/tr/emreone/kotlin_utils/math/PointsAndAreas.kt

@@ -165,6 +165,17 @@ inline fun Area.forBorder(f: (p: Point) -> Unit) {
 }
 
 operator fun Area.contains(p: Point) = p.x in first.x..second.x && p.y in first.y..second.y
+operator fun Area.plus(amount: Int) = grow(by = amount)
+operator fun Area.minus(amount: Int) = shrink(by = amount)
+
+const val LEFT_ARROW = '\u2190'
+const val UP_ARROW = '\u2191'
+const val RIGHT_ARROW = '\u2192'
+const val DOWN_ARROW = '\u2193'
+const val NW_ARROW = '\u2196'
+const val NE_ARROW = '\u2197'
+const val SE_ARROW = '\u2198'
+const val SW_ARROW = '\u2199'
 
 val Area.width: Int
     get() = (second.x - first.x + 1).coerceAtLeast(0)