feat(i18n): enhance I18n with dialogue support and placeholder helpers

Add dialogueLines() methods to I18n for splitting pipe-delimited
translations into String arrays for NPC dialogue sequences.
Add string() overloads with Map<String,String> placeholder support.
Add DialogueSet.ofTranslation() factory methods to create dialogue
sets directly from translation keys.

Author: Swofty-Developments

type.generic/src/main/java/net/swofty/type/generic/entity/npc/HypixelNPC.java

@@ -16,6 +16,7 @@
 import net.swofty.type.generic.entity.npc.impl.NPCViewable;
 import net.swofty.type.generic.entity.npc.impl.NPCVillagerEntityImpl;
 import net.swofty.type.generic.event.custom.NPCInteractEvent;
+import net.swofty.type.generic.i18n.I18n;
 import net.swofty.type.generic.user.HypixelPlayer;
 import org.tinylog.Logger;
 
@@ -268,5 +269,21 @@ public Entity get(HypixelNPC npc) {
     @Builder
     public record DialogueSet(String key, String[] lines, Sound sound) {
         public static final DialogueSet[] EMPTY = new DialogueSet[0];
+
+        public static DialogueSet ofTranslation(String key, String translationKey) {
+            return new DialogueSet(key, I18n.dialogueLines(translationKey), null);
+        }
+
+        public static DialogueSet ofTranslation(String key, String translationKey, Sound sound) {
+            return new DialogueSet(key, I18n.dialogueLines(translationKey), sound);
+        }
+
+        public static DialogueSet ofTranslation(String key, String translationKey, Map<String, String> placeholders) {
+            return new DialogueSet(key, I18n.dialogueLines(translationKey, placeholders), null);
+        }
+
+        public static DialogueSet ofTranslation(String key, String translationKey, Map<String, String> placeholders, Sound sound) {
+            return new DialogueSet(key, I18n.dialogueLines(translationKey, placeholders), sound);
+        }
     }
 }

type.generic/src/main/java/net/swofty/type/generic/i18n/I18n.java

@@ -6,12 +6,15 @@
 import net.kyori.adventure.translation.GlobalTranslator;
 
 import java.util.Locale;
+import java.util.Map;
 
 public class I18n {
 
     private static final LegacyComponentSerializer LEGACY =
             LegacyComponentSerializer.legacySection();
 
+    private static final String DIALOGUE_SEPARATOR = "\\|";
+
     public static TranslatableComponent t(String key) {
         return Component.translatable(key);
     }
@@ -28,4 +31,34 @@ public static String string(String key, Locale locale) {
     public static String string(String key) {
         return string(key, HypixelTranslator.defaultLocale);
     }
+
+    public static String string(String key, Map<String, String> placeholders) {
+        String result = string(key);
+        for (Map.Entry<String, String> entry : placeholders.entrySet()) {
+            result = result.replace("{" + entry.getKey() + "}", entry.getValue());
+        }
+        return result;
+    }
+
+    public static String string(String key, Locale locale, Map<String, String> placeholders) {
+        String result = string(key, locale);
+        for (Map.Entry<String, String> entry : placeholders.entrySet()) {
+            result = result.replace("{" + entry.getKey() + "}", entry.getValue());
+        }
+        return result;
+    }
+
+    public static String[] dialogueLines(String key) {
+        return dialogueLines(key, HypixelTranslator.defaultLocale);
+    }
+
+    public static String[] dialogueLines(String key, Locale locale) {
+        String resolved = string(key, locale);
+        return resolved.split(DIALOGUE_SEPARATOR);
+    }
+
+    public static String[] dialogueLines(String key, Map<String, String> placeholders) {
+        String resolved = string(key, placeholders);
+        return resolved.split(DIALOGUE_SEPARATOR);
+    }
 }