Refactor classes

Author: CroaBeast

README.md

@@ -124,6 +124,52 @@ public class MyPlugin extends JavaPlugin {
 
 ---
 
+## Maven / Gradle Installation
+
+To include YAML API to the project, add the following repository and dependency to your build configuration. Replace `${version}` with the desired version tag.
+
+### Maven
+
+Add the repository and dependency to your `pom.xml`:
+
+```xml
+<repositories>
+    <repository>
+        <id>croabeast-repo</id>
+        <url>https://croabeast.github.io/repo/</url>
+    </repository>
+</repositories>
+
+<dependencies>
+    <dependency>
+        <groupId>me.croabeast</groupId>
+        <artifactId>YAML-API</artifactId>
+        <version>${version}</version>
+        <scope>compile</scope>
+    </dependency>
+</dependencies>
+```
+
+### Gradle
+
+Add the repository and dependency to your `build.gradle`:
+
+```groovy
+repositories {
+    maven {
+        url "https://croabeast.github.io/repo/"
+    }
+}
+
+dependencies {
+    implementation "me.croabeast:YAML-API:${version}"
+}
+```
+
+Replace `${version}` with the appropriate module version.
+
+---
+
 ## Conclusion
 
 **YAML API** is a powerful library for managing YAML configurations in your Bukkit/Spigot/Paper plugins. It streamlines file operations, mapping, and updates while preserving comments and ensuring compatibility across server versions. Whether you are building simple configuration systems or working with complex, nested settings, YAML API provides the tools you need to efficiently manage your plugin’s configuration.

…ain/java/me/croabeast/file/Copyable.java …n/java/me/croabeast/common/Copyable.javasrc/main/java/me/croabeast/file/Copyable.java renamed to src/main/java/me/croabeast/common/Copyable.java src/main/java/me/croabeast/file/Copyable.java renamed to src/main/java/me/croabeast/common/Copyable.java

@@ -1,4 +1,4 @@
-package me.croabeast.file;
+package me.croabeast.common;
 
 import org.jetbrains.annotations.NotNull;
 

…main/java/me/croabeast/file/Builder.java …roabeast/common/builder/BaseBuilder.javasrc/main/java/me/croabeast/file/Builder.java renamed to src/main/java/me/croabeast/common/builder/BaseBuilder.java src/main/java/me/croabeast/file/Builder.java renamed to src/main/java/me/croabeast/common/builder/BaseBuilder.java

@@ -1,4 +1,4 @@
-package me.croabeast.file;
+package me.croabeast.common.builder;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -7,7 +7,7 @@
  *
  * @param <B> the specific builder type extending this interface
  */
-public interface Builder<B extends Builder<B>> {
+public interface BaseBuilder<B extends BaseBuilder<B>> {
 
     /**
      * Provides an instance of the builder, ensuring fluent-style method chaining.

src/main/java/me/croabeast/file/Mappable.java

@@ -1,5 +1,7 @@
 package me.croabeast.file;
 
+import me.croabeast.common.Copyable;
+import me.croabeast.common.builder.BaseBuilder;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.*;
@@ -9,7 +11,7 @@
 /**
  * Represents a specialized mapping structure that associates integer keys with collections of elements.
  * <p>
- * {@code Mappable} extends {@link Map} and {@link Builder} to provide a fluent interface for performing operations
+ * {@code Mappable} extends {@link Map} and {@link BaseBuilder} to provide a fluent interface for performing operations
  * such as filtering, ordering, and merging values across grouped collections.
  * </p>
  * <p>
@@ -40,10 +42,10 @@
  * @param <T> The type of elements stored in the collections.
  * @param <C> The type of collection that holds the elements.
  * @param <B> The type of the implementing {@code Mappable} instance.
- * @see Builder
+ * @see BaseBuilder
  */
 public interface Mappable<T, C extends Collection<T>, B extends Mappable<T, C, B>>
-        extends Map<Integer, C>, Iterable<Map.Entry<Integer, C>>, Builder<B>, Copyable<B> {
+        extends Map<Integer, C>, Iterable<Map.Entry<Integer, C>>, BaseBuilder<B>, Copyable<B> {
 
     /**
      * Filters the stored elements based on the given predicate, modifying the current instance.