Refactor and Replace Inventory GUI Framework with Custom DSL-Based System

gradle.properties

@@ -7,5 +7,5 @@ org.jetbrains.dokka.experimental.gradle.pluginMode=V2Enabled
 javaVersion=21
 mcVersion=1.21.4
 group=dev.slne.surf
-version=1.21.4-2.15.1-SNAPSHOT
+version=1.21.4-2.16.0-SNAPSHOT
 relocationPrefix=dev.slne.surf.surfapi.libs

gradle/libs.versions.toml

@@ -50,7 +50,6 @@ reflection-remapper = "0.1.1"
 brigadier = "1.0.18"
 configurate = "4.1.2"
 more-persistent-data-types = "2.4.0"
-inventoryframework = "0.10.19"
 flogger = "0.8"
 aide-reflection = "1.3"
 auto-service = "1.1.1"
@@ -136,7 +135,6 @@ configurate-yaml = { module = "org.spongepowered:configurate-yaml", version.ref
 configurate-jackson = { module = "org.spongepowered:configurate-jackson", version.ref = "configurate" }
 configurate-kotlin = { module = "org.spongepowered:configurate-extra-kotlin", version.ref = "configurate" }
 more-persistent-data-types = { module = "com.jeff_media:MorePersistentDataTypes", version.ref = "more-persistent-data-types" }
-inventoryframework = { module = "com.github.stefvanschie.inventoryframework:IF", version.ref = "inventoryframework" }
 flogger = { module = "com.google.flogger:flogger", version.ref = "flogger" }
 flogger-slf4j-backend = { module = "com.google.flogger:flogger-slf4j-backend", version.ref = "flogger" }
 aide-reflection = { module = "tech.hiddenproject:aide-reflection", version.ref = "aide-reflection" }

surf-api-bukkit/surf-api-bukkit-api/build.gradle.kts

@@ -11,7 +11,6 @@ dependencies {
     compileOnlyApi(libs.commandapi.bukkit)
     compileOnlyApi(libs.reflection.remapper)
     compileOnlyApi(libs.more.persistent.data.types)
-    compileOnlyApi(libs.inventoryframework)
 
     api(libs.commandapi.bukkit.kotlin)
     compileOnlyApi(libs.mccoroutine.folia.api)
@@ -22,3 +21,10 @@ description = "surf-api-bukkit-api"
 configurations.all {
     exclude(group = "org.spigotmc", module = "spigot-api")
 }
+
+kotlin {
+    compilerOptions {
+        optIn.add("dev.slne.surf.surfapi.core.api.util.InternalSurfApi")
+        optIn.add("kotlin.contracts.ExperimentalContracts")
+    }
+}

surf-api-bukkit/surf-api-bukkit-api/src/main/kotlin/dev/slne/surf/surfapi/bukkit/api/inventory/InventoryBridge.kt

@@ -0,0 +1,42 @@
+package dev.slne.surf.surfapi.bukkit.api.inventory
+
+import dev.slne.surf.surfapi.bukkit.api.inventory.gui.Gui
+import dev.slne.surf.surfapi.bukkit.api.inventory.gui.types.ChestGui
+import dev.slne.surf.surfapi.bukkit.api.inventory.item.GuiItem
+import dev.slne.surf.surfapi.bukkit.api.inventory.item.UpdatableGuiItem
+import dev.slne.surf.surfapi.bukkit.api.inventory.pane.panes.OutlinePane
+import dev.slne.surf.surfapi.bukkit.api.inventory.pane.panes.PaginatedPane
+import dev.slne.surf.surfapi.bukkit.api.inventory.pane.panes.StaticPane
+import dev.slne.surf.surfapi.bukkit.api.inventory.pane.utils.Mask
+import dev.slne.surf.surfapi.bukkit.api.inventory.pane.utils.Pattern
+import dev.slne.surf.surfapi.bukkit.api.inventory.utils.Slot
+import dev.slne.surf.surfapi.core.api.util.InternalSurfApi
+import dev.slne.surf.surfapi.core.api.util.requiredService
+import org.bukkit.NamespacedKey
+import org.bukkit.inventory.Inventory
+import java.util.*
+
+@InternalSurfApi
+interface InventoryBridge {
+
+    fun getGuiByInventory(inventory: Inventory): Gui?
+    fun createGuiItem(key: NamespacedKey?, uuid: UUID?): GuiItem
+    fun createUpdatableGuiItem(
+        key: NamespacedKey?,
+        uuid: UUID?
+    ): UpdatableGuiItem
+
+    fun createMask(vararg mask: String): Mask
+    fun createPattern(vararg pattern: String): Pattern
+
+    fun createChestGui(size: ChestGui.ChestGuiSize, parent: Gui? = null): ChestGui
+
+
+    fun createOutlinePane(slot: Slot, length: Int, height: Int, uuid: UUID?): OutlinePane
+    fun createPaginatedPane(slot: Slot, length: Int, height: Int, uuid: UUID?): PaginatedPane
+    fun createStaticPane(slot: Slot, length: Int, height: Int, uuid: UUID?): StaticPane
+
+    companion object {
+        val instance = requiredService<InventoryBridge>()
+    }
+}

surf-api-bukkit/surf-api-bukkit-api/src/main/kotlin/dev/slne/surf/surfapi/bukkit/api/inventory/dsl/markers.kt

@@ -3,3 +3,11 @@ package dev.slne.surf.surfapi.bukkit.api.inventory.dsl
 @Target(AnnotationTarget.CLASS, AnnotationTarget.TYPE)
 @DslMarker
 annotation class PaneMarker
+
+@Target(AnnotationTarget.CLASS, AnnotationTarget.TYPE)
+@DslMarker
+annotation class GuiDsl
+
+@Target(AnnotationTarget.CLASS, AnnotationTarget.TYPE)
+@DslMarker
+annotation class GuiItemDsl