feat: refactor Sponge configuration classes and add ModernTestConfig example

- Updated `SpongeYmlConfigClass` and `SpongeJsonConfigClass` constructors to accept `configFolder` and `fileName` as parameters.
- Adjusted `SpongeConfigClass` to make `configFolder` and `fileName` non-abstract.
- Added new `ModernTestConfig` class with example usage and randomization functionality.

Author: twisti-dev

surf-api-bukkit/surf-api-bukkit-api/api/surf-api-bukkit-api.api

@@ -5975,25 +5975,25 @@ public abstract interface annotation class dev/slne/surf/surfapi/core/api/config
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public synthetic fun <init> (Ljava/lang/Class;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public synthetic fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun edit (ZLkotlin/jvm/functions/Function1;)V
 	public static synthetic fun edit$default (Ldev/slne/surf/surfapi/core/api/config/SpongeConfigClass;ZLkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
 	public final fun getConfig ()Ljava/lang/Object;
-	protected abstract fun getConfigFolder ()Ljava/nio/file/Path;
-	protected abstract fun getFileName ()Ljava/lang/String;
+	protected final fun getConfigFolder ()Ljava/nio/file/Path;
+	protected final fun getFileName ()Ljava/lang/String;
 	public abstract fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 	public final fun init ()V
 	public final fun reloadFromFile ()Ljava/lang/Object;
 	public final fun save ()V
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeJsonConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeYmlConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }
 

surf-api-bukkit/surf-api-bukkit-plugin-test/src/main/java/dev/slne/surf/surfapi/bukkit/test/BukkitPluginMain.java

@@ -6,6 +6,7 @@
 import dev.slne.surf.surfapi.bukkit.test.command.SurfApiTestCommand;
 import dev.slne.surf.surfapi.bukkit.test.command.subcommands.inventory.TestInventoryView;
 import dev.slne.surf.surfapi.bukkit.test.command.subcommands.reflection.Reflection;
+import dev.slne.surf.surfapi.bukkit.test.config.ModernTestConfig;
 import dev.slne.surf.surfapi.bukkit.test.listener.ChatListener;
 import org.bukkit.plugin.java.JavaPlugin;
 import org.jetbrains.annotations.NotNull;
@@ -19,6 +20,9 @@ public class BukkitPluginMain extends JavaPlugin {
 
   @Override
   public void onLoad() {
+    ModernTestConfig.Companion.init();
+    ModernTestConfig.Companion.randomise();
+
     SurfBukkitPacketListenerApi.Companion.getInstance().registerListeners(new ChatListener());
     InventoryFrameworkExtensions.register(TestInventoryView.INSTANCE);
 //    TestConfig config = SurfCore#Api.getCore()

surf-api-bukkit/surf-api-bukkit-plugin-test/src/main/kotlin/dev/slne/surf/surfapi/bukkit/test/config/ModernTestConfig.kt

@@ -0,0 +1,24 @@
+package dev.slne.surf.surfapi.bukkit.test.config
+
+import dev.slne.surf.surfapi.bukkit.test.BukkitPluginMain
+import dev.slne.surf.surfapi.core.api.config.SpongeYmlConfigClass
+import org.spongepowered.configurate.objectmapping.ConfigSerializable
+
+@ConfigSerializable
+data class ModernTestConfig(
+    var message: String = "Hello from Modern Config!",
+    var number: Int = 42,
+    var enabled: Boolean = true
+) {
+    companion object : SpongeYmlConfigClass<ModernTestConfig>(
+        ModernTestConfig::class.java,
+        BukkitPluginMain.getInstance().dataPath,
+        "modern-test-config.yml"
+    ) {
+        fun randomise() = edit {
+            message = "Random Message ${Math.random()}"
+            number = (Math.random() * 100).toInt()
+            enabled = Math.random() > 0.5
+        }
+    }
+}

surf-api-core/surf-api-core-api/api/surf-api-core-api.api

@@ -602,25 +602,25 @@ public abstract interface annotation class dev/slne/surf/surfapi/core/api/config
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public synthetic fun <init> (Ljava/lang/Class;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public synthetic fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun edit (ZLkotlin/jvm/functions/Function1;)V
 	public static synthetic fun edit$default (Ldev/slne/surf/surfapi/core/api/config/SpongeConfigClass;ZLkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
 	public final fun getConfig ()Ljava/lang/Object;
-	protected abstract fun getConfigFolder ()Ljava/nio/file/Path;
-	protected abstract fun getFileName ()Ljava/lang/String;
+	protected final fun getConfigFolder ()Ljava/nio/file/Path;
+	protected final fun getFileName ()Ljava/lang/String;
 	public abstract fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 	public final fun init ()V
 	public final fun reloadFromFile ()Ljava/lang/Object;
 	public final fun save ()V
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeJsonConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeYmlConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }
 

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/config/SpongeConfigClass.kt

@@ -20,19 +20,20 @@ import java.nio.file.Path
  * @param configClass the Java class of [C], used by underlying config frameworks
  * to create and map configuration instances.
  */
-sealed class SpongeConfigClass<C>(configClass: Class<C>) {
+sealed class SpongeConfigClass<C>(
+    configClass: Class<C>,
     /**
      * Folder where the configuration file is stored.
      *
      * Implementations should point this to a plugin- or module-specific config directory.
      */
-    protected abstract val configFolder: Path
-
+    protected val configFolder: Path,
     /**
      * The name of the configuration file, including its extension
      * (for example `settings.yml` or `settings.json`).
      */
-    protected abstract val fileName: String
+    protected val fileName: String
+) {
 
     /**
      * The underlying configuration manager responsible for loading, saving,

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/config/SpongeJsonConfigClass.kt

@@ -1,5 +1,7 @@
 package dev.slne.surf.surfapi.core.api.config
 
+import java.nio.file.Path
+
 /**
  * Convenience base class for JSON-backed Sponge configuration classes.
  *
@@ -12,17 +14,21 @@ package dev.slne.surf.surfapi.core.api.config
  * data class MyJsonConfig(
  *     var someField: String = "value"
  * ) {
- *     companion object : SpongeJsonConfigClass<MyJsonConfig>(MyJsonConfig::class.java) {
- *         override val configFolder = Path("config/my-plugin")
- *         override val fileName = "my-config.json"
+ *     companion object : SpongeJsonConfigClass<MyJsonConfig>(
+ *         MyJsonConfig::class.java,
+ *         Path("config/my-plugin"),
+ *         "my-config.json"
+ *     ) {
  *     }
  * }
  * ```
  *
  * @param C the type of the configuration data object.
  * @param configClass the Java class of [C], used by the underlying config framework.
  */
-abstract class SpongeJsonConfigClass<C>(configClass: Class<C>) : SpongeConfigClass<C>(configClass) {
+abstract class SpongeJsonConfigClass<C>(
+    configClass: Class<C>, configFolder: Path, fileName: String
+) : SpongeConfigClass<C>(configClass, configFolder, fileName) {
 
     /**
      * JSON-backed configuration manager for this config type.

surf-api-core/surf-api-core-api/src/main/kotlin/dev/slne/surf/surfapi/core/api/config/SpongeYmlConfigClass.kt

@@ -1,5 +1,7 @@
 package dev.slne.surf.surfapi.core.api.config
 
+import java.nio.file.Path
+
 /**
  * Convenience base class for YAML-backed Sponge configuration classes.
  *
@@ -12,17 +14,21 @@ package dev.slne.surf.surfapi.core.api.config
  * data class MyConfig(
  *     var someField: String = "value"
  * ) {
- *     companion object : SpongeYmlConfigClass<MyConfig>(MyConfig::class.java) {
- *         override val configFolder = Path("config/my-plugin")
- *         override val fileName = "my-config.yml"
+ *     companion object : SpongeYmlConfigClass<MyConfig>(
+ *         MyConfig::class.java,
+ *         Path("config/my-plugin"),
+ *         "my-config.yml"
+ *     ) {
  *     }
  * }
  * ```
  *
  * @param C the type of the configuration data object.
  * @param configClass the Java class of [C], used by the underlying config framework.
  */
-abstract class SpongeYmlConfigClass<C>(configClass: Class<C>) : SpongeConfigClass<C>(configClass) {
+abstract class SpongeYmlConfigClass<C>(
+    configClass: Class<C>, configFolder: Path, fileName: String
+) : SpongeConfigClass<C>(configClass, configFolder, fileName) {
 
     /**
      * YAML-backed configuration manager for this config type.

surf-api-velocity/surf-api-velocity-api/api/surf-api-velocity-api.api

@@ -3908,25 +3908,25 @@ public abstract interface annotation class dev/slne/surf/surfapi/core/api/config
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public synthetic fun <init> (Ljava/lang/Class;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
+	public synthetic fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;Lkotlin/jvm/internal/DefaultConstructorMarker;)V
 	public final fun edit (ZLkotlin/jvm/functions/Function1;)V
 	public static synthetic fun edit$default (Ldev/slne/surf/surfapi/core/api/config/SpongeConfigClass;ZLkotlin/jvm/functions/Function1;ILjava/lang/Object;)V
 	public final fun getConfig ()Ljava/lang/Object;
-	protected abstract fun getConfigFolder ()Ljava/nio/file/Path;
-	protected abstract fun getFileName ()Ljava/lang/String;
+	protected final fun getConfigFolder ()Ljava/nio/file/Path;
+	protected final fun getFileName ()Ljava/lang/String;
 	public abstract fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 	public final fun init ()V
 	public final fun reloadFromFile ()Ljava/lang/Object;
 	public final fun save ()V
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeJsonConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }
 
 public abstract class dev/slne/surf/surfapi/core/api/config/SpongeYmlConfigClass : dev/slne/surf/surfapi/core/api/config/SpongeConfigClass {
-	public fun <init> (Ljava/lang/Class;)V
+	public fun <init> (Ljava/lang/Class;Ljava/nio/file/Path;Ljava/lang/String;)V
 	public fun getManager ()Ldev/slne/surf/surfapi/core/api/config/manager/SpongeConfigManager;
 }