feature: provide way for custom serializer in styledstring methods

resolves #118

Author: TheFruxz

src/main/kotlin/dev/fruxz/stacked/Stacked.kt

@@ -1,9 +1,10 @@
 package dev.fruxz.stacked
 
+import dev.fruxz.stacked.extension.OpenMiniMessageSerializer
 import dev.fruxz.stacked.extension.api.StyledString
 import dev.fruxz.stacked.extension.asStyledComponent
+import dev.fruxz.stacked.extension.miniMessageSerializer
 import net.kyori.adventure.text.Component
-import net.kyori.adventure.text.ComponentBuilder
 import net.kyori.adventure.text.ComponentLike
 import net.kyori.adventure.text.TextComponent
 import net.kyori.adventure.text.TextComponent.Builder
@@ -158,7 +159,11 @@ fun Builder.click(process: () -> ClickEvent?) = this.clickEvent(process())
  * @since 1.0
  */
 @Stacked
-inline fun text(@StyledString content: String, builder: StackedBuilder.() -> Unit = { }) = content.asStyledComponent(builder)
+inline fun text(
+    @StyledString content: String,
+    serializer: OpenMiniMessageSerializer = miniMessageSerializer,
+    builder: StackedBuilder.() -> Unit = { },
+) = content.asStyledComponent(serializer = serializer, builder = builder)
 
 /**
  * This function uses the [component] to apply it to an new [TextComponent.Builder]
@@ -170,8 +175,10 @@ inline fun text(@StyledString content: String, builder: StackedBuilder.() -> Uni
  * @since 1.0
  */
 @Stacked
-inline fun text(component: ComponentLike, builder: StackedBuilder.() -> Unit = { }) =
-	StackedBuilder(Component.text().append(component)).apply(builder).build()
+inline fun text(
+    component: ComponentLike,
+    builder: StackedBuilder.() -> Unit = { },
+) = StackedBuilder(Component.text().append(component)).apply(builder).build()
 
 /**
  * This function uses the [componentBuilder] and applies the [builder] process
@@ -183,8 +190,10 @@ inline fun text(component: ComponentLike, builder: StackedBuilder.() -> Unit = {
  * @since 1.0
  */
 @Stacked
-inline fun text(componentBuilder: Builder, builder: StackedBuilder.() -> Unit = { }) =
-	StackedBuilder(componentBuilder).apply(builder).build()
+inline fun text(
+    componentBuilder: Builder,
+    builder: StackedBuilder.() -> Unit = { },
+) = StackedBuilder(componentBuilder).apply(builder).build()
 
 /**
  * This function uses a new [Component.empty] component and applies the [builder] process

src/main/kotlin/dev/fruxz/stacked/extension/Adventure.kt

@@ -35,10 +35,10 @@ var plainAdventureSerializer: ComponentSerializer<Component, TextComponent, Stri
  * @author Fruxz
  * @since 1.0
  */
-var miniMessageSerializer: ComponentSerializer<Component, Component, String> =
+var miniMessageSerializer: OpenMiniMessageSerializer =
 	MiniMessage.miniMessage()
 
-var strictMiniMessageSerializer: ComponentSerializer<Component, Component, String> =
+var strictMiniMessageSerializer: OpenMiniMessageSerializer =
 	MiniMessage.builder().strict(true).build()
 
 /**
@@ -103,8 +103,11 @@ val Iterable<String>.asComponents: List<TextComponent>
 val ComponentLike.asStyledString: String
 	get() = strictMiniMessageSerializer.serialize(asComponent())
 
-fun ComponentLike.asStyledString(strict: Boolean = true) =
-	strict.switch(asStyledString, miniMessageSerializer.serialize(asComponent()))
+fun ComponentLike.asStyledString(
+    serializer: OpenMiniMessageSerializer = strictMiniMessageSerializer,
+    strict: Boolean = true
+) =
+	strict.switch(asStyledString, serializer.serialize(asComponent()))
 
 /**
  * This computational value converts this [String] into a [TextComponent]
@@ -118,8 +121,12 @@ fun ComponentLike.asStyledString(strict: Boolean = true) =
 val String.asStyledComponent: TextComponent
 	get() = Component.text().append(miniMessageSerializer.deserializeOr(this, Component.empty())!!).build()
 
-inline fun String.asStyledComponent(builder: StackedBuilder.() -> Unit) =
-	StackedBuilder(Component.text().append(asStyledComponent)).apply(builder).build()
+inline fun String.asStyledComponent(
+    serializer: OpenMiniMessageSerializer = miniMessageSerializer,
+    builder: StackedBuilder.() -> Unit = { },
+) = StackedBuilder(Component.text().append(serializer.deserializeOr(this, Component.empty())!!))
+    .apply(builder)
+    .build()
 
 /**
  * This computational value converts this [String] into a [TextComponent]
@@ -133,6 +140,10 @@ inline fun String.asStyledComponent(builder: StackedBuilder.() -> Unit) =
 val String.asStyledComponents: List<TextComponent>
 	get() = this.lines().asStyledComponents
 
+fun String.asStyledComponents(
+    serializer: OpenMiniMessageSerializer = miniMessageSerializer,
+): List<TextComponent> = this.lines().asStyledComponents(serializer)
+
 /**
  * This computational value converts this [Iterable] into a [TextComponent]
  * list (every entry represents a line) by using the [MiniMessage], provided by the
@@ -143,4 +154,8 @@ val String.asStyledComponents: List<TextComponent>
  * @since 1.0
  */
 val Iterable<String>.asStyledComponents: List<TextComponent>
-	get() = map { it.asStyledComponent }
+	get() = map { it.asStyledComponent }
+
+fun Iterable<String>.asStyledComponents(
+    serializer: OpenMiniMessageSerializer = miniMessageSerializer,
+): List<TextComponent> = map { it.asStyledComponent(serializer) }

src/main/kotlin/dev/fruxz/stacked/extension/Title.kt

@@ -19,7 +19,8 @@ fun Title(
     @StyledString styledTitle: String,
     @StyledString styledSubtitle: String,
     times: AdventureTimes? = null,
-) = AdventureTitle.title(styledTitle.asStyledComponent, styledSubtitle.asStyledComponent, times)
+    serializer: OpenMiniMessageSerializer = miniMessageSerializer,
+) = AdventureTitle.title(styledTitle.asStyledComponent(serializer = serializer), styledSubtitle.asStyledComponent(serializer = serializer), times)
 
 fun Times(
     fadeIn: Duration,

src/main/kotlin/dev/fruxz/stacked/extension/TypeAlias.kt

@@ -0,0 +1,6 @@
+package dev.fruxz.stacked.extension
+
+import net.kyori.adventure.text.Component
+import net.kyori.adventure.text.serializer.ComponentSerializer
+
+typealias OpenMiniMessageSerializer = ComponentSerializer<Component, Component, String>