Add more option ifs (#286)

Author: kevinthegreat1

src/main/java/dev/isxander/yacl3/api/ConfigCategory.java

@@ -104,12 +104,29 @@ default Builder optionIf(boolean condition, @NotNull Supplier<@NotNull Option<?>
          * To add to another group, use {@link Builder#groups(Collection)}.
          * To construct an option, use {@link Option#createBuilder()}
          *
+         * @param options the options to add
          * @see ConfigCategory#groups()
          * @see OptionGroup#isRoot()
          */
         @Override
         Builder options(@NotNull Collection<? extends Option<?>> options);
 
+        /**
+         * Adds multiple options to the root group of the category if a condition is met.
+         * To add to another group, use {@link Builder#groups(Collection)}.
+         * To construct an option, use {@link Option#createBuilder()}
+         *
+         * @param condition whether to add the options
+         * @param options the options to add
+         * @see ConfigCategory#groups()
+         * @see OptionGroup#isRoot()
+         */
+        @Override
+        default Builder optionsIf(boolean condition, @NotNull Collection<? extends Option<?>> options) {
+            OptionAddable.super.optionsIf(condition, options);
+            return this;
+        }
+
         /**
          * Adds an option group.
          * To add an option to the root group, use {@link Builder#option(Option)}
@@ -155,9 +172,23 @@ default Builder groupIf(boolean condition, @NotNull Supplier<@NotNull OptionGrou
          * Adds multiple option groups.
          * To add multiple options to the root group, use {@link Builder#options(Collection)}
          * To construct a group, use {@link OptionGroup#createBuilder()}
+         *
+         * @param groups the groups to add
          */
         Builder groups(@NotNull Collection<OptionGroup> groups);
 
+        /**
+         * Adds multiple option groups if a condition is met.
+         * To add multiple options to the root group, use {@link Builder#optionsIf(boolean, Collection)}
+         * To construct a group, use {@link OptionGroup#createBuilder()}
+         *
+         * @param condition whether to add the groups
+         * @param groups the groups to add
+         */
+        default Builder groupsIf(boolean condition, @NotNull Collection<OptionGroup> groups) {
+            return condition ? groups(groups) : this;
+        }
+
         /**
          * Fetches the builder for the root group of the category.
          * This is the group that has no header and options are added through {@link Builder#option(Option)}.

src/main/java/dev/isxander/yacl3/api/OptionAddable.java

@@ -46,6 +46,19 @@ default OptionAddable optionIf(boolean condition, @NotNull Supplier<@NotNull Opt
     /**
      * Adds multiple options to an abstract builder.
      * To construct an option, use {@link Option#createBuilder()}
+     * @param options the options to add
+     * @return this
      */
     OptionAddable options(@NotNull Collection<? extends Option<?>> options);
+
+    /**
+     * Adds multiple options to an abstract builder if a condition is met.
+     * To construct an option, use {@link Option#createBuilder()}
+     * @param condition whether to add the options
+     * @param options the options to add
+     * @return this
+     */
+    default OptionAddable optionsIf(boolean condition, @NotNull Collection<? extends Option<?>> options) {
+        return condition ? options(options) : this;
+    }
 }

src/main/java/dev/isxander/yacl3/api/OptionGroup.java

@@ -63,7 +63,7 @@ interface Builder extends OptionAddable {
 
         /**
          * Adds an option to group.
-         * To construct an option, use {@link Option#createBuilder(Class)}
+         * To construct an option, use {@link Option#createBuilder()}
          *
          * @see OptionGroup#options()
          */
@@ -111,14 +111,26 @@ default Builder optionIf(boolean condition, @NotNull Supplier<@NotNull Option<?>
         }
 
         /**
-         * Adds multiple options to group.
+         * Adds multiple options to this group.
          * To construct an option, use {@link Option#createBuilder()}
          *
          * @see OptionGroup#options()
          */
         @Override
         Builder options(@NotNull Collection<? extends Option<?>> options);
 
+        /**
+         * Adds multiple options to this group if a condition is met.
+         * To construct an option, use {@link Option#createBuilder()}
+         *
+         * @see OptionGroup#options()
+         */
+        @Override
+        default Builder optionsIf(boolean condition, @NotNull Collection<? extends Option<?>> options) {
+            OptionAddable.super.optionsIf(condition, options);
+            return this;
+        }
+
         /**
          * Dictates if the group should be collapsed by default
          *