Merge pull request #924 from powercasgamer/feature/join-builder

feat: add join method that accepts JoinConfiguration.Builder

api/src/main/java/net/kyori/adventure/text/Component.java

@@ -192,6 +192,38 @@ public interface Component extends ComponentBuilderApplicable, ComponentLike, Ex
     return Component.text().append(component).build();
   }
 
+  /**
+   * Joins {@code components} using the configuration in {@code configBuilder}.
+   *
+   * @param configBuilder the join configuration
+   * @param components the components
+   * @return the resulting component
+   * @see JoinConfiguration#noSeparators()
+   * @see JoinConfiguration#separator(ComponentLike)
+   * @see JoinConfiguration#separators(ComponentLike, ComponentLike)
+   * @since 4.14.0
+   */
+  @Contract(pure = true)
+  static @NotNull Component join(final JoinConfiguration.@NotNull Builder configBuilder, final @NotNull ComponentLike@NotNull... components) {
+    return join(configBuilder, Arrays.asList(components));
+  }
+
+  /**
+   * Joins {@code components} using the configuration in {@code configBuilder}.
+   *
+   * @param configBuilder the join configuration
+   * @param components the components
+   * @return the resulting component
+   * @see JoinConfiguration#noSeparators()
+   * @see JoinConfiguration#separator(ComponentLike)
+   * @see JoinConfiguration#separators(ComponentLike, ComponentLike)
+   * @since 4.14.0
+   */
+  @Contract(pure = true)
+  static @NotNull Component join(final JoinConfiguration.@NotNull Builder configBuilder, final @NotNull Iterable<? extends ComponentLike> components) {
+    return JoinConfigurationImpl.join(configBuilder.build(), components);
+  }
+
   /**
    * Joins {@code components} using the configuration in {@code config}.
    *