From 39f0a874c7a04e1135863d585f135ae497ae8246 Mon Sep 17 00:00:00 2001
From: KingSimon <19822231+KingOfSquares@users.noreply.github.com>
Date: Sun, 21 Nov 2021 22:42:35 +0100
Subject: [PATCH] Abstract out style methods to StyleWriter/Reader

---
 .../net/kyori/adventure/text/Component.java   |  31 +++-
 .../adventure/text/ComponentBuilder.java      |  19 +--
 .../text/format/MutableStyleWriter.java       |  74 +++++++++
 .../kyori/adventure/text/format/Style.java    |  28 ++--
 .../adventure/text/format/StyleImpl.java      |  25 ---
 .../adventure/text/format/StyleReader.java    | 103 ++++++++++++
 .../adventure/text/format/StyleWriter.java    | 155 ++++++++++++++++++
 7 files changed, 378 insertions(+), 57 deletions(-)
 create mode 100644 api/src/main/java/net/kyori/adventure/text/format/MutableStyleWriter.java
 create mode 100644 api/src/main/java/net/kyori/adventure/text/format/StyleReader.java
 create mode 100644 api/src/main/java/net/kyori/adventure/text/format/StyleWriter.java

diff --git a/api/src/main/java/net/kyori/adventure/text/Component.java b/api/src/main/java/net/kyori/adventure/text/Component.java
index 2d5f700885..1b4639f38f 100644
--- a/api/src/main/java/net/kyori/adventure/text/Component.java
+++ b/api/src/main/java/net/kyori/adventure/text/Component.java
@@ -43,6 +43,8 @@
 import net.kyori.adventure.text.event.HoverEvent;
 import net.kyori.adventure.text.event.HoverEventSource;
 import net.kyori.adventure.text.format.Style;
+import net.kyori.adventure.text.format.StyleReader;
+import net.kyori.adventure.text.format.StyleWriter;
 import net.kyori.adventure.text.format.TextColor;
 import net.kyori.adventure.text.format.TextDecoration;
 import net.kyori.adventure.text.serializer.ComponentSerializer;
@@ -101,7 +103,7 @@
  * @since 4.0.0
  */
 @ApiStatus.NonExtendable
-public interface Component extends ComponentBuilderApplicable, ComponentLike, Examinable, HoverEventSource<Component> {
+public interface Component extends ComponentBuilderApplicable, ComponentLike, Examinable, HoverEventSource<Component>, StyleReader, StyleWriter<Component> {
   /**
    * A predicate that checks equality of two {@code Component}s using {@link Objects#equals(Object, Object)}.
    *
@@ -1802,6 +1804,27 @@ default void detectCycle(final @NotNull Component that) {
     return this.style(this.style().merge(that.style(), merges));
   }
 
+  /**
+   * Gets the font.
+   *
+   * @return the font of this component
+   * @since 4.10.0
+   */
+  default @Nullable Key font() {
+    return this.style().font();
+  }
+
+  /**
+   * Sets the font.
+   *
+   * @param key a font
+   * @return a component
+   * @since 4.10.0
+   */
+  default @NotNull Component font(final @Nullable Key key) {
+    return this.style(this.style().font(key));
+  }
+
   /**
    * Gets the color of this component.
    *
@@ -1846,7 +1869,7 @@ default void detectCycle(final @NotNull Component that) {
    * @since 4.0.0
    */
   default boolean hasDecoration(final @NotNull TextDecoration decoration) {
-    return this.decoration(decoration) == TextDecoration.State.TRUE;
+    return StyleReader.super.hasDecoration(decoration);
   }
 
   /**
@@ -1858,7 +1881,7 @@ default boolean hasDecoration(final @NotNull TextDecoration decoration) {
    */
   @Contract(pure = true)
   default @NotNull Component decorate(final @NotNull TextDecoration decoration) {
-    return this.decoration(decoration, TextDecoration.State.TRUE);
+    return StyleWriter.super.decorate(decoration);
   }
 
   /**
@@ -1885,7 +1908,7 @@ default boolean hasDecoration(final @NotNull TextDecoration decoration) {
    */
   @Contract(pure = true)
   default @NotNull Component decoration(final @NotNull TextDecoration decoration, final boolean flag) {
-    return this.decoration(decoration, TextDecoration.State.byBoolean(flag));
+    return StyleWriter.super.decoration(decoration, flag);
   }
 
   /**
diff --git a/api/src/main/java/net/kyori/adventure/text/ComponentBuilder.java b/api/src/main/java/net/kyori/adventure/text/ComponentBuilder.java
index a9e3b62938..0bc32c0792 100644
--- a/api/src/main/java/net/kyori/adventure/text/ComponentBuilder.java
+++ b/api/src/main/java/net/kyori/adventure/text/ComponentBuilder.java
@@ -31,10 +31,12 @@
 import net.kyori.adventure.key.Key;
 import net.kyori.adventure.text.event.ClickEvent;
 import net.kyori.adventure.text.event.HoverEventSource;
+import net.kyori.adventure.text.format.MutableStyleWriter;
 import net.kyori.adventure.text.format.Style;
 import net.kyori.adventure.text.format.TextColor;
 import net.kyori.adventure.text.format.TextDecoration;
 import net.kyori.adventure.util.Buildable;
+import org.jetbrains.annotations.ApiStatus;
 import org.jetbrains.annotations.Contract;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -46,7 +48,8 @@
  * @param <B> the builder type
  * @since 4.0.0
  */
-public interface ComponentBuilder<C extends BuildableComponent<C, B>, B extends ComponentBuilder<C, B>> extends Buildable.Builder<C>, ComponentBuilderApplicable, ComponentLike {
+@ApiStatus.NonExtendable
+public interface ComponentBuilder<C extends BuildableComponent<C, B>, B extends ComponentBuilder<C, B>> extends Buildable.Builder<C>, ComponentBuilderApplicable, ComponentLike, MutableStyleWriter<B> {
   /**
    * Appends a component to this component.
    *
@@ -227,9 +230,7 @@ public interface ComponentBuilder<C extends BuildableComponent<C, B>, B extends
   @Contract("_, _ -> this")
   @SuppressWarnings("unchecked")
   default @NotNull B decorations(final @NotNull Set<TextDecoration> decorations, final boolean flag) {
-    final TextDecoration.State state = TextDecoration.State.byBoolean(flag);
-    decorations.forEach(decoration -> this.decoration(decoration, state));
-    return (B) this;
+    return MutableStyleWriter.super.decorations(decorations, flag);
   }
 
   /**
@@ -254,10 +255,7 @@ public interface ComponentBuilder<C extends BuildableComponent<C, B>, B extends
   @Contract("_ -> this")
   @SuppressWarnings("unchecked")
   default @NotNull B decorate(final @NotNull TextDecoration@NotNull... decorations) {
-    for (int i = 0, length = decorations.length; i < length; i++) {
-      this.decorate(decorations[i]);
-    }
-    return (B) this;
+    return MutableStyleWriter.super.decorate(decorations);
   }
 
   /**
@@ -286,10 +284,7 @@ public interface ComponentBuilder<C extends BuildableComponent<C, B>, B extends
   @Contract("_ -> this")
   @SuppressWarnings("unchecked")
   default @NotNull B decorations(final @NotNull Map<TextDecoration, TextDecoration.State> decorations) {
-    for (final Map.Entry<TextDecoration, TextDecoration.State> entry : decorations.entrySet()) {
-      this.decoration(entry.getKey(), entry.getValue());
-    }
-    return (B) this;
+    return MutableStyleWriter.super.decorations(decorations);
   }
 
   /**
diff --git a/api/src/main/java/net/kyori/adventure/text/format/MutableStyleWriter.java b/api/src/main/java/net/kyori/adventure/text/format/MutableStyleWriter.java
new file mode 100644
index 0000000000..e03d021508
--- /dev/null
+++ b/api/src/main/java/net/kyori/adventure/text/format/MutableStyleWriter.java
@@ -0,0 +1,74 @@
+package net.kyori.adventure.text.format;
+
+import java.util.Map;
+import java.util.Set;
+
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Writes style properties to a mutable object. Used to override some default methods from {@link net.kyori.adventure.text.format.StyleWriter}
+ * with faster alternatives that only work for mutable objects.
+ *
+ * @param <T> The type implementing this interface e.g. {@link net.kyori.adventure.text.Component}
+ * @see net.kyori.adventure.text.format.StyleWriter
+ * @since 4.10.0
+ */
+@ApiStatus.NonExtendable
+public interface MutableStyleWriter<T extends MutableStyleWriter<?>> extends StyleWriter<T> {
+
+  /**
+   * Sets {@code decorations} to {@link TextDecoration.State#TRUE}.
+   *
+   * @param decorations the decorations
+   * @return a mutable object ({@code T})
+   * @since 4.10.0
+   */
+  @Override
+  @Contract("_ -> this")
+  @SuppressWarnings("unchecked")
+  default @NotNull T decorate(final @NotNull TextDecoration@NotNull... decorations) {
+    for (int i = 0, length = decorations.length; i < length; i++) {
+      this.decorate(decorations[i]);
+    }
+    return (T) this;
+  }
+
+  /**
+   * Sets decorations using the specified {@code decorations} map.
+   *
+   * <p>If a given decoration does not have a value explicitly set, the value of that particular decoration is not changed.</p>
+   *
+   * @param decorations a map containing text decorations and their respective state.
+   * @return a mutable object ({@code T})
+   * @since 4.10.0
+   */
+  @Override
+  @Contract("_ -> this")
+  @SuppressWarnings("unchecked")
+  default @NotNull T decorations(final @NotNull Map<TextDecoration, TextDecoration.State> decorations) {
+    for (final Map.Entry<TextDecoration, TextDecoration.State> entry : decorations.entrySet()) {
+      this.decoration(entry.getKey(), entry.getValue());
+    }
+    return (T) this;
+  }
+
+  /**
+   * Sets the state of a set of decorations to {@code flag}.
+   *
+   * @param decorations the decorations
+   * @param flag {@code true} if this mutable object should have the decorations, {@code false} if
+   *     this mutable object should not have the decorations
+   * @return a mutable object ({@code T})
+   * @since 4.10.0
+   */
+  @Override
+  @Contract("_, _ -> this")
+  @SuppressWarnings("unchecked")
+  default @NotNull T decorations(final @NotNull Set<TextDecoration> decorations, final boolean flag) {
+    final TextDecoration.State state = TextDecoration.State.byBoolean(flag);
+    decorations.forEach(decoration -> this.decoration(decoration, state));
+    return (T) this;
+  }
+}
diff --git a/api/src/main/java/net/kyori/adventure/text/format/Style.java b/api/src/main/java/net/kyori/adventure/text/format/Style.java
index 702a0d6d30..672795edf6 100644
--- a/api/src/main/java/net/kyori/adventure/text/format/Style.java
+++ b/api/src/main/java/net/kyori/adventure/text/format/Style.java
@@ -60,7 +60,7 @@
  * @since 4.0.0
  */
 @ApiStatus.NonExtendable
-public interface Style extends Buildable<Style, Style.Builder>, Examinable {
+public interface Style extends Buildable<Style, Style.Builder>, Examinable, StyleReader, StyleWriter<Style> {
   /**
    * The default font.
    *
@@ -280,7 +280,7 @@ public interface Style extends Buildable<Style, Style.Builder>, Examinable {
    * @since 4.0.0
    */
   default boolean hasDecoration(final @NotNull TextDecoration decoration) {
-    return this.decoration(decoration) == TextDecoration.State.TRUE;
+    return StyleReader.super.hasDecoration(decoration);
   }
 
   /**
@@ -302,7 +302,7 @@ default boolean hasDecoration(final @NotNull TextDecoration decoration) {
    * @since 4.0.0
    */
   default @NotNull Style decorate(final @NotNull TextDecoration decoration) {
-    return this.decoration(decoration, TextDecoration.State.TRUE);
+    return StyleWriter.super.decorate(decoration);
   }
 
   /**
@@ -315,7 +315,7 @@ default boolean hasDecoration(final @NotNull TextDecoration decoration) {
    * @since 4.0.0
    */
   default @NotNull Style decoration(final @NotNull TextDecoration decoration, final boolean flag) {
-    return this.decoration(decoration, TextDecoration.State.byBoolean(flag));
+    return StyleWriter.super.decoration(decoration, flag);
   }
 
   /**
@@ -337,7 +337,9 @@ default boolean hasDecoration(final @NotNull TextDecoration decoration) {
    * @return a set of decorations this style has
    * @since 4.0.0
    */
-  @Unmodifiable @NotNull Map<TextDecoration, TextDecoration.State> decorations();
+  default @Unmodifiable @NotNull Map<TextDecoration, TextDecoration.State> decorations() {
+    return StyleReader.super.decorations();
+  }
 
   /**
    * Sets decorations for this style using the specified {@code decorations} map.
@@ -621,7 +623,7 @@ public enum Strategy {
    *
    * @since 4.0.0
    */
-  interface Builder extends Buildable.Builder<Style> {
+  interface Builder extends Buildable.Builder<Style>, MutableStyleWriter<Builder> {
     /**
      * Sets the font.
      *
@@ -662,7 +664,7 @@ interface Builder extends Buildable.Builder<Style> {
      */
     @Contract("_ -> this")
     default @NotNull Builder decorate(final @NotNull TextDecoration decoration) {
-      return this.decoration(decoration, TextDecoration.State.TRUE);
+      return MutableStyleWriter.super.decorate(decoration);
     }
 
     /**
@@ -674,10 +676,7 @@ interface Builder extends Buildable.Builder<Style> {
      */
     @Contract("_ -> this")
     default @NotNull Builder decorate(final @NotNull TextDecoration@NotNull... decorations) {
-      for (int i = 0, length = decorations.length; i < length; i++) {
-        this.decorate(decorations[i]);
-      }
-      return this;
+      return MutableStyleWriter.super.decorate(decorations);
     }
 
     /**
@@ -691,7 +690,7 @@ interface Builder extends Buildable.Builder<Style> {
      */
     @Contract("_, _ -> this")
     default @NotNull Builder decoration(final @NotNull TextDecoration decoration, final boolean flag) {
-      return this.decoration(decoration, TextDecoration.State.byBoolean(flag));
+      return MutableStyleWriter.super.decoration(decoration, flag);
     }
 
     /**
@@ -705,10 +704,7 @@ interface Builder extends Buildable.Builder<Style> {
      */
     @Contract("_ -> this")
     default @NotNull Builder decorations(final @NotNull Map<TextDecoration, TextDecoration.State> decorations) {
-      for (final Map.Entry<TextDecoration, TextDecoration.State> entry : decorations.entrySet()) {
-        this.decoration(entry.getKey(), entry.getValue());
-      }
-      return this;
+      return MutableStyleWriter.super.decorations(decorations);
     }
 
     /**
diff --git a/api/src/main/java/net/kyori/adventure/text/format/StyleImpl.java b/api/src/main/java/net/kyori/adventure/text/format/StyleImpl.java
index cbb6e401f0..4c920ec187 100644
--- a/api/src/main/java/net/kyori/adventure/text/format/StyleImpl.java
+++ b/api/src/main/java/net/kyori/adventure/text/format/StyleImpl.java
@@ -23,7 +23,6 @@
  */
 package net.kyori.adventure.text.format;
 
-import java.util.EnumMap;
 import java.util.Map;
 import java.util.Objects;
 import java.util.Set;
@@ -148,17 +147,6 @@ static void decorate(final Builder builder, final TextDecoration[] decorations)
     throw new IllegalArgumentException(String.format("unknown decoration '%s'", decoration));
   }
 
-  @Override
-  public @NotNull Map<TextDecoration, TextDecoration.State> decorations() {
-    final Map<TextDecoration, TextDecoration.State> decorations = new EnumMap<>(TextDecoration.class);
-    for (int i = 0, length = DECORATIONS.length; i < length; i++) {
-      final TextDecoration decoration = DECORATIONS[i];
-      final TextDecoration.State value = this.decoration(decoration);
-      decorations.put(decoration, value);
-    }
-    return decorations;
-  }
-
   @Override
   public @NotNull Style decorations(final @NotNull Map<TextDecoration, TextDecoration.State> decorations) {
     final TextDecoration.State obfuscated = decorations.getOrDefault(TextDecoration.OBFUSCATED, this.obfuscated);
@@ -334,19 +322,6 @@ static final class BuilderImpl implements Builder {
       return this;
     }
 
-    @Override
-    public @NotNull Builder decorate(final @NotNull TextDecoration decoration) {
-      return this.decoration(decoration, TextDecoration.State.TRUE);
-    }
-
-    @Override
-    public @NotNull Builder decorate(final @NotNull TextDecoration@NotNull... decorations) {
-      for (int i = 0, length = decorations.length; i < length; i++) {
-        this.decorate(decorations[i]);
-      }
-      return this;
-    }
-
     @Override
     public @NotNull Builder decoration(final @NotNull TextDecoration decoration, final TextDecoration.@NotNull State state) {
       requireNonNull(state, "state");
diff --git a/api/src/main/java/net/kyori/adventure/text/format/StyleReader.java b/api/src/main/java/net/kyori/adventure/text/format/StyleReader.java
new file mode 100644
index 0000000000..b5e6a16027
--- /dev/null
+++ b/api/src/main/java/net/kyori/adventure/text/format/StyleReader.java
@@ -0,0 +1,103 @@
+package net.kyori.adventure.text.format;
+
+import java.util.EnumMap;
+import java.util.Map;
+import net.kyori.adventure.key.Key;
+import net.kyori.adventure.text.event.ClickEvent;
+import net.kyori.adventure.text.event.HoverEvent;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.Unmodifiable;
+
+/**
+ * Reads style properties from an object.
+ *
+ * @see net.kyori.adventure.text.format.Style
+ * @since 4.10.0
+ */
+@ApiStatus.NonExtendable
+public interface StyleReader {
+  @ApiStatus.Internal TextDecoration[] DECORATIONS = TextDecoration.values();
+
+  /**
+   * Gets the font.
+   *
+   * @return the font
+   * @since 4.10.0
+   * @sinceMinecraft 1.16
+   */
+  @Nullable Key font();
+
+  /**
+   * Gets the color.
+   *
+   * @return the color
+   * @since 4.10.0
+   */
+  @Nullable TextColor color();
+
+  /**
+   * Tests if this stylable has a decoration.
+   *
+   * @param decoration the decoration
+   * @return {@code true} if this stylable has the decoration, {@code false} if this
+   *     stylable does not have the decoration
+   * @since 4.10.0
+   */
+  default boolean hasDecoration(final @NotNull TextDecoration decoration) {
+    return this.decoration(decoration) == TextDecoration.State.TRUE;
+  }
+
+  /**
+   * Gets the state of a decoration on this stylable.
+   *
+   * @param decoration the decoration
+   * @return {@link TextDecoration.State#TRUE} if this stylable has the decoration,
+   *     {@link TextDecoration.State#FALSE} if this stylable does not have the decoration,
+   *     and {@link TextDecoration.State#NOT_SET} if not set
+   * @since 4.10.0
+   */
+  TextDecoration.@NotNull State decoration(final @NotNull TextDecoration decoration);
+
+  /**
+   * Gets a map of decorations this stylable has.
+   *
+   * @return a set of decorations this stylable has
+   * @since 4.10.0
+   */
+  @SuppressWarnings("Duplicates")
+  default @Unmodifiable @NotNull Map<TextDecoration, TextDecoration.State> decorations() {
+    final Map<TextDecoration, TextDecoration.State> decorations = new EnumMap<>(TextDecoration.class);
+    for (int i = 0, length = DECORATIONS.length; i < length; i++) {
+      final TextDecoration decoration = DECORATIONS[i];
+      final TextDecoration.State value = this.decoration(decoration);
+      decorations.put(decoration, value);
+    }
+    return decorations;
+  }
+
+  /**
+   * Gets the click event.
+   *
+   * @return the click event
+   * @since 4.10.0
+   */
+  @Nullable ClickEvent clickEvent();
+
+  /**
+   * Gets the hover event.
+   *
+   * @return the hover event
+   * @since 4.10.0
+   */
+  @Nullable HoverEvent<?> hoverEvent();
+
+  /**
+   * Gets the string to be inserted when this stylable is shift-clicked.
+   *
+   * @return the insertion string
+   * @since 4.10.0
+   */
+  @Nullable String insertion();
+}
diff --git a/api/src/main/java/net/kyori/adventure/text/format/StyleWriter.java b/api/src/main/java/net/kyori/adventure/text/format/StyleWriter.java
new file mode 100644
index 0000000000..7b2a639533
--- /dev/null
+++ b/api/src/main/java/net/kyori/adventure/text/format/StyleWriter.java
@@ -0,0 +1,155 @@
+package net.kyori.adventure.text.format;
+
+import java.util.EnumMap;
+import java.util.Map;
+import java.util.Set;
+import java.util.function.Function;
+import java.util.stream.Collectors;
+import net.kyori.adventure.key.Key;
+import net.kyori.adventure.text.event.ClickEvent;
+import net.kyori.adventure.text.event.HoverEventSource;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+/**
+ * Writes style properties to an object.
+ *
+ * @param <T> The type implementing this interface, e.g. {@link net.kyori.adventure.text.Component}
+ * @see net.kyori.adventure.text.format.Style
+ * @since 4.10.0
+ */
+@ApiStatus.NonExtendable
+public interface StyleWriter<T extends StyleWriter<?>> {
+
+  /**
+   * Sets the font.
+   *
+   * @param font the font
+   * @return an object ({@code T})
+   * @since 4.10.0
+   * @sinceMinecraft 1.16
+   */
+  @NotNull T font(final @Nullable Key font);
+
+  /**
+   * Sets the color.
+   *
+   * @param color the color
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T color(final @Nullable TextColor color);
+
+  /**
+   * Sets the color if there isn't one set already.
+   *
+   * @param color the color
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T colorIfAbsent(final @Nullable TextColor color);
+
+  /**
+   * Sets the state of {@code decoration} to {@link TextDecoration.State#TRUE}.
+   *
+   * @param decoration the decoration
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  default @NotNull T decorate(final @NotNull TextDecoration decoration) {
+    return this.decoration(decoration, TextDecoration.State.TRUE);
+  }
+
+  /**
+   * Sets {@code decorations} to {@link TextDecoration.State#TRUE}.
+   *
+   * @param decorations the decorations
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  default @NotNull T decorate(final @NotNull TextDecoration@NotNull... decorations) {
+    final Map<TextDecoration, TextDecoration.State> map = new EnumMap<>(TextDecoration.class);
+    for (int i = 0, length = decorations.length; i < length; i++) {
+      map.put(decorations[i], TextDecoration.State.TRUE);
+    }
+    return this.decorations(map);
+  }
+
+  /**
+   * Sets the state of a decoration.
+   *
+   * @param decoration the decoration
+   * @param flag {@code true} if this object should have the decoration, {@code false} if
+   *     this object should not have the decoration
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  default @NotNull T decoration(final @NotNull TextDecoration decoration, final boolean flag) {
+    return this.decoration(decoration, TextDecoration.State.byBoolean(flag));
+  }
+
+  /**
+   * Sets the value of a decoration.
+   *
+   * @param decoration the decoration
+   * @param state {@link TextDecoration.State#TRUE} if this object should have the
+   *     decoration, {@link TextDecoration.State#FALSE} if this object should not
+   *     have the decoration, and {@link TextDecoration.State#NOT_SET} if the decoration
+   *     should not have a set value
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T decoration(final @NotNull TextDecoration decoration, final TextDecoration.@NotNull State state);
+
+  /**
+   * Sets decorations using the specified {@code decorations} map.
+   *
+   * <p>If a given decoration does not have a value explicitly set, the value of that particular decoration is not changed.</p>
+   *
+   * @param decorations the decorations
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T decorations(final @NotNull Map<TextDecoration, TextDecoration.State> decorations);
+
+  /**
+   * Sets the state of a set of decorations to {@code flag}.
+   *
+   * @param decorations the decorations
+   * @param flag {@code true} if this builder should have the decorations, {@code false} if
+   *     this builder should not have the decorations
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  default @NotNull T decorations(final @NotNull Set<TextDecoration> decorations, final boolean flag) {
+    return this.decorations(decorations.stream().collect(Collectors.toMap(Function.identity(), d -> TextDecoration.State.byBoolean(flag))));
+  }
+
+  /**
+   * Sets the click event.
+   *
+   * @param event the click event
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T clickEvent(final @Nullable ClickEvent event);
+
+  /**
+   * Sets the hover event.
+   *
+   * @param source the hover event source
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T hoverEvent(final @Nullable HoverEventSource<?> source);
+
+  /**
+   * Sets the string to be inserted when this object ({@code T}) is shift-clicked.
+   *
+   * @param insertion the insertion string
+   * @return an object ({@code T})
+   * @since 4.10.0
+   */
+  @NotNull T insertion(final @Nullable String insertion);
+}