feat: add named argument support to token emitter

text-minimessage/src/main/java/net/kyori/adventure/text/minimessage/MiniMessageSerializer.java

@@ -199,6 +199,18 @@ void completeTag() {
       return this;
     }
 
+    @Override
+    public @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull String arg) {
+      if (!this.tagState.isTag) {
+        throw new IllegalStateException("Not within a tag!");
+      }
+      this.consumer.append(' ');
+      this.consumer.append(name);
+      this.consumer.append(TokenParser.NAME_VALUE_SEPARATOR);
+      this.escapeTagContent(arg, null);
+      return this;
+    }
+
     @Override
     public @NotNull TokenEmitter argument(final @NotNull String arg, final @NotNull QuotingOverride quotingPreference) {
       if (!this.tagState.isTag) {
@@ -209,12 +221,30 @@ void completeTag() {
       return this;
     }
 
+    @Override
+    public @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull String arg, final @NotNull QuotingOverride quotingPreference) {
+      if (!this.tagState.isTag) {
+        throw new IllegalStateException("Not within a tag!");
+      }
+      this.consumer.append(' ');
+      this.consumer.append(name);
+      this.consumer.append(TokenParser.NAME_VALUE_SEPARATOR);
+      this.escapeTagContent(arg, requireNonNull(quotingPreference, "quotingPreference"));
+      return this;
+    }
+
     @Override
     public @NotNull TokenEmitter argument(final @NotNull Component arg) {
       final String serialized = MiniMessageSerializer.serialize(arg, this.resolver, this.strict);
       return this.argument(serialized, QuotingOverride.QUOTED); // always quote tokens
     }
 
+    @Override
+    public @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull Component arg) {
+      final String serialized = MiniMessageSerializer.serialize(arg, this.resolver, this.strict);
+      return this.namedArgument(name, serialized, QuotingOverride.QUOTED); // always quote tokens
+    }
+
     @Override
     public @NotNull Collector text(final @NotNull String text) {
       this.completeTag();

text-minimessage/src/main/java/net/kyori/adventure/text/minimessage/internal/serializer/TokenEmitter.java

@@ -79,6 +79,18 @@ public interface TokenEmitter {
    */
   @NotNull TokenEmitter argument(final @NotNull String arg);
 
+  /**
+   * Add a single named argument to the current tag.
+   *
+   * <p>Must be called after {@link #tag(String)}, but before any call to {@link #text(String)}.</p>
+   *
+   * @param name name of the argument
+   * @param arg argument value
+   * @return this emitter
+   * @since 4.25.0
+   */
+  @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull String arg);
+
   /**
    * Add a single argument to the current tag.
    *
@@ -91,6 +103,19 @@ public interface TokenEmitter {
    */
   @NotNull TokenEmitter argument(final @NotNull String arg, final @NotNull QuotingOverride quotingPreference);
 
+  /**
+   * Add a single named argument to the current tag.
+   *
+   * <p>Must be called after {@link #tag(String)}, but before any call to {@link #text(String)}.</p>
+   *
+   * @param name name of the argument
+   * @param arg argument value
+   * @param quotingPreference an argument-specific quoting instruction
+   * @return this emitter
+   * @since 4.25.0
+   */
+  @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull String arg, final @NotNull QuotingOverride quotingPreference);
+
   /**
    * Add a single argument to the current tag.
    *
@@ -102,6 +127,18 @@ public interface TokenEmitter {
    */
   @NotNull TokenEmitter argument(final @NotNull Component arg);
 
+  /**
+   * Add a single named argument to the current tag.
+   *
+   * <p>Must be called after {@link #tag(String)}, but before any call to {@link #text(String)}.</p>
+   *
+   * @param name name of the argument
+   * @param arg argument value, serialized as a nested MiniMessage string
+   * @return this emitter
+   * @since 4.25.0
+   */
+  @NotNull TokenEmitter namedArgument(final @NotNull String name, final @NotNull Component arg);
+
   /**
    * Emit literal text.
    *