import { ComponentType, type APISelectMenuComponent, type APISelectMenuOption } from 'discord-api-types/v10'; import { normalizeArray, type RestOrArray } from '../../util/normalizeArray.js'; import { customIdValidator, disabledValidator, jsonOptionValidator, minMaxValidator, optionsLengthValidator, placeholderValidator, validateRequiredSelectMenuParameters, } from '../Assertions.js'; import { ComponentBuilder } from '../Component.js'; import { SelectMenuOptionBuilder } from './SelectMenuOption.js'; /** * Represents a select menu component */ export class SelectMenuBuilder extends ComponentBuilder { /** * The options within this select menu */ public readonly options: SelectMenuOptionBuilder[]; public constructor(data?: Partial) { const { options, ...initData } = data ?? {}; super({ type: ComponentType.SelectMenu, ...initData }); this.options = options?.map((option) => new SelectMenuOptionBuilder(option)) ?? []; } /** * Sets the placeholder for this select menu * * @param placeholder - The placeholder to use for this select menu */ public setPlaceholder(placeholder: string) { this.data.placeholder = placeholderValidator.parse(placeholder); return this; } /** * Sets the minimum values that must be selected in the select menu * * @param minValues - The minimum values that must be selected */ public setMinValues(minValues: number) { this.data.min_values = minMaxValidator.parse(minValues); return this; } /** * Sets the maximum values that must be selected in the select menu * * @param maxValues - The maximum values that must be selected */ public setMaxValues(maxValues: number) { this.data.max_values = minMaxValidator.parse(maxValues); return this; } /** * Sets the custom id for this select menu * * @param customId - The custom id to use for this select menu */ public setCustomId(customId: string) { this.data.custom_id = customIdValidator.parse(customId); return this; } /** * Sets whether this select menu is disabled * * @param disabled - Whether this select menu is disabled */ public setDisabled(disabled = true) { this.data.disabled = disabledValidator.parse(disabled); return this; } /** * Adds options to this select menu * * @param options - The options to add to this select menu * @returns */ public addOptions(...options: RestOrArray) { // eslint-disable-next-line no-param-reassign options = normalizeArray(options); optionsLengthValidator.parse(this.options.length + options.length); this.options.push( ...options.map((option) => option instanceof SelectMenuOptionBuilder ? option : new SelectMenuOptionBuilder(jsonOptionValidator.parse(option)), ), ); return this; } /** * Sets the options on this select menu * * @param options - The options to set on this select menu */ public setOptions(...options: RestOrArray) { // eslint-disable-next-line no-param-reassign options = normalizeArray(options); optionsLengthValidator.parse(options.length); this.options.splice( 0, this.options.length, ...options.map((option) => option instanceof SelectMenuOptionBuilder ? option : new SelectMenuOptionBuilder(jsonOptionValidator.parse(option)), ), ); return this; } /** * {@inheritDoc ComponentBuilder.toJSON} */ public toJSON(): APISelectMenuComponent { validateRequiredSelectMenuParameters(this.options, this.data.custom_id); return { ...this.data, options: this.options.map((option) => option.toJSON()), } as APISelectMenuComponent; } }