package dev.isxander.yacl.api; import com.google.common.collect.ImmutableList; import dev.isxander.yacl.impl.OptionGroupImpl; import net.minecraft.text.MutableText; import net.minecraft.text.Text; import org.apache.commons.lang3.Validate; import org.jetbrains.annotations.NotNull; import java.util.ArrayList; import java.util.Collection; import java.util.List; /** * Serves as a separator between multiple chunks of options * that may be too similar or too few to be placed in a separate {@link ConfigCategory}. * Or maybe you just want your config to feel less dense. */ public interface OptionGroup { /** * Name of the option group, displayed as a separator in the option lists. * Can be empty. */ Text name(); /** * Tooltip displayed on hover. */ Text tooltip(); /** * List of all options in the group */ @NotNull ImmutableList> options(); /** * Dictates if the group should be collapsed by default. */ boolean collapsed(); /** * Always false when using the {@link Builder} * used to not render the separator if true */ boolean isRoot(); /** * Creates a builder to construct a {@link OptionGroup} */ static Builder createBuilder() { return new Builder(); } class Builder { private Text name = Text.empty(); private final List tooltipLines = new ArrayList<>(); private final List> options = new ArrayList<>(); private boolean collapsed = false; private Builder() { } /** * Sets name of the group, can be {@link Text#empty()} to just separate options, like sodium. * * @see OptionGroup#name() */ public Builder name(@NotNull Text name) { Validate.notNull(name, "`name` must not be null"); this.name = name; return this; } /** * Sets the tooltip to be used by the option group. * Can be invoked twice to append more lines. * No need to wrap the text yourself, the gui does this itself. * * @param tooltips text lines - merged with a new-line on {@link Builder#build()}. */ public Builder tooltip(@NotNull Text... tooltips) { Validate.notEmpty(tooltips, "`tooltips` cannot be empty"); tooltipLines.addAll(List.of(tooltips)); return this; } /** * Adds an option to group. * To construct an option, use {@link Option#createBuilder(Class)} * * @see OptionGroup#options() */ public Builder option(@NotNull Option option) { Validate.notNull(option, "`option` must not be null"); this.options.add(option); return this; } /** * Adds multiple options to group. * To construct an option, use {@link Option#createBuilder(Class)} * * @see OptionGroup#options() */ public Builder options(@NotNull Collection> options) { Validate.notEmpty(options, "`options` must not be empty"); this.options.addAll(options); return this; } /** * Dictates if the group should be collapsed by default * * @see OptionGroup#collapsed() */ public Builder collapsed(boolean collapsible) { this.collapsed = collapsible; return this; } public OptionGroup build() { Validate.notEmpty(options, "`options` must not be empty to build `OptionGroup`"); MutableText concatenatedTooltip = Text.empty(); boolean first = true; for (Text line : tooltipLines) { if (!first) concatenatedTooltip.append("\n"); first = false; concatenatedTooltip.append(line); } return new OptionGroupImpl(name, concatenatedTooltip, ImmutableList.copyOf(options), collapsed, false); } } }