@minesa-org/mini-interaction 0.0.13 → 0.0.15

package/dist/builders/ChannelSelectMenuBuilder.d.ts

@@ -8,7 +8,6 @@ export type ChannelSelectMenuBuilderData = {
     minValues?: number;
     maxValues?: number;
     disabled?: boolean;
-    required?: boolean;
     channelTypes?: ChannelType[];
     defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>[];
 };
@@ -39,10 +38,6 @@ export declare class ChannelSelectMenuBuilder implements JSONEncodable<APIChanne
      * Toggles whether the select menu is disabled.
      */
     setDisabled(disabled: boolean): this;
-    /**
-     * Marks the select menu as requiring at least the minimum number of selections.
-     */
-    setRequired(required: boolean): this;
     /**
      * Filters selectable channels by the provided channel types.
      */

package/dist/builders/ChannelSelectMenuBuilder.js

@@ -12,7 +12,6 @@ export class ChannelSelectMenuBuilder {
             minValues: data.minValues,
             maxValues: data.maxValues,
             disabled: data.disabled,
-            required: data.required,
             channelTypes: data.channelTypes
                 ? [...data.channelTypes]
                 : undefined,
@@ -59,13 +58,6 @@ export class ChannelSelectMenuBuilder {
         this.data.disabled = disabled;
         return this;
     }
-    /**
-     * Marks the select menu as requiring at least the minimum number of selections.
-     */
-    setRequired(required) {
-        this.data.required = required;
-        return this;
-    }
     /**
      * Filters selectable channels by the provided channel types.
      */
@@ -98,7 +90,6 @@ export class ChannelSelectMenuBuilder {
             min_values: this.data.minValues,
             max_values: this.data.maxValues,
             disabled: this.data.disabled,
-            required: this.data.required,
             channel_types: this.data.channelTypes
                 ? [...this.data.channelTypes]
                 : undefined,

package/dist/builders/ModalChannelSelectMenuBuilder.d.ts

@@ -0,0 +1,52 @@
+import { SelectMenuDefaultValueType, type APIChannelSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial modal channel select menu data accepted by the builder. */
+export type ModalChannelSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>[];
+};
+/** Builder for Discord channel select menu components in modals. */
+export declare class ModalChannelSelectMenuBuilder implements JSONEncodable<APIChannelSelectComponent> {
+    private data;
+    /**
+     * Creates a new modal channel select menu builder with optional seed data.
+     */
+    constructor(data?: ModalChannelSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no channel is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of channels that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of channels that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Replaces the default channel selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Channel>>): this;
+    /**
+     * Serialises the builder into an API compatible channel select menu payload.
+     */
+    toJSON(): APIChannelSelectComponent;
+}

package/dist/builders/ModalChannelSelectMenuBuilder.js

@@ -0,0 +1,98 @@
+import { ComponentType, SelectMenuDefaultValueType, } from "discord-api-types/v10";
+/** Builder for Discord channel select menu components in modals. */
+export class ModalChannelSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new modal channel select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            defaultValues: data.defaultValues
+                ? data.defaultValues.map((value) => ({
+                    ...value,
+                    type: SelectMenuDefaultValueType.Channel,
+                }))
+                : undefined,
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no channel is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of channels that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of channels that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Replaces the default channel selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues, (value) => ({
+            ...value,
+            type: SelectMenuDefaultValueType.Channel,
+        }));
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible channel select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ModalChannelSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.ChannelSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            default_values: this.data.defaultValues?.map((value) => ({
+                ...value,
+                type: SelectMenuDefaultValueType.Channel,
+            })),
+        };
+    }
+}

package/dist/builders/ModalMentionableSelectMenuBuilder.d.ts

@@ -0,0 +1,52 @@
+import { SelectMenuDefaultValueType, type APIMentionableSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial modal mentionable select menu data accepted by the builder. */
+export type ModalMentionableSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    defaultValues?: (APISelectMenuDefaultValue<SelectMenuDefaultValueType.User> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>)[];
+};
+/** Builder for Discord mentionable select menu components in modals. */
+export declare class ModalMentionableSelectMenuBuilder implements JSONEncodable<APIMentionableSelectComponent> {
+    private data;
+    /**
+     * Creates a new modal mentionable select menu builder with optional seed data.
+     */
+    constructor(data?: ModalMentionableSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no mentionable is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of mentionables that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of mentionables that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Replaces the default mentionable selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.User> | APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>>): this;
+    /**
+     * Serialises the builder into an API compatible mentionable select menu payload.
+     */
+    toJSON(): APIMentionableSelectComponent;
+}

package/dist/builders/ModalMentionableSelectMenuBuilder.js

@@ -0,0 +1,89 @@
+import { ComponentType, } from "discord-api-types/v10";
+/** Builder for Discord mentionable select menu components in modals. */
+export class ModalMentionableSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new modal mentionable select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            defaultValues: data.defaultValues
+                ? [...data.defaultValues]
+                : undefined,
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no mentionable is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of mentionables that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of mentionables that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Replaces the default mentionable selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues);
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible mentionable select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ModalMentionableSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.MentionableSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            default_values: this.data.defaultValues,
+        };
+    }
+}

package/dist/builders/ModalRoleSelectMenuBuilder.d.ts

@@ -0,0 +1,52 @@
+import { SelectMenuDefaultValueType, type APIRoleSelectComponent, type APISelectMenuDefaultValue } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial modal role select menu data accepted by the builder. */
+export type ModalRoleSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>[];
+};
+/** Builder for Discord role select menu components in modals. */
+export declare class ModalRoleSelectMenuBuilder implements JSONEncodable<APIRoleSelectComponent> {
+    private data;
+    /**
+     * Creates a new modal role select menu builder with optional seed data.
+     */
+    constructor(data?: ModalRoleSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no role is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of roles that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of roles that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Replaces the default role selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues: Iterable<APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>>): this;
+    /**
+     * Serialises the builder into an API compatible role select menu payload.
+     */
+    toJSON(): APIRoleSelectComponent;
+}

package/dist/builders/ModalRoleSelectMenuBuilder.js

@@ -0,0 +1,98 @@
+import { ComponentType, SelectMenuDefaultValueType, } from "discord-api-types/v10";
+/** Builder for Discord role select menu components in modals. */
+export class ModalRoleSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new modal role select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            defaultValues: data.defaultValues
+                ? data.defaultValues.map((value) => ({
+                    ...value,
+                    type: SelectMenuDefaultValueType.Role,
+                }))
+                : undefined,
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no role is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of roles that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of roles that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Replaces the default role selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues, (value) => ({
+            ...value,
+            type: SelectMenuDefaultValueType.Role,
+        }));
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible role select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ModalRoleSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.RoleSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            default_values: this.data.defaultValues?.map((value) => ({
+                ...value,
+                type: SelectMenuDefaultValueType.Role,
+            })),
+        };
+    }
+}

package/dist/builders/ModalStringSelectMenuBuilder.d.ts

@@ -0,0 +1,56 @@
+import { type APISelectMenuOption, type APIStringSelectComponent } from "discord-api-types/v10";
+import type { JSONEncodable } from "./shared.js";
+/** Shape describing initial modal string select menu data accepted by the builder. */
+export type ModalStringSelectMenuBuilderData = {
+    customId?: string;
+    placeholder?: string;
+    minValues?: number;
+    maxValues?: number;
+    disabled?: boolean;
+    required?: boolean;
+    options?: APISelectMenuOption[];
+};
+/** Builder for Discord string select menu components in modals. */
+export declare class ModalStringSelectMenuBuilder implements JSONEncodable<APIStringSelectComponent> {
+    private data;
+    /**
+     * Creates a new modal string select menu builder with optional seed data.
+     */
+    constructor(data?: ModalStringSelectMenuBuilderData);
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId: string): this;
+    /**
+     * Sets or clears the placeholder text displayed when no option is selected.
+     */
+    setPlaceholder(placeholder: string | null | undefined): this;
+    /**
+     * Sets the minimum number of options that must be selected.
+     */
+    setMinValues(minValues: number | null | undefined): this;
+    /**
+     * Sets the maximum number of options that can be selected.
+     */
+    setMaxValues(maxValues: number | null | undefined): this;
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled: boolean): this;
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required: boolean): this;
+    /**
+     * Adds an option to the select menu.
+     */
+    addOption(option: APISelectMenuOption): this;
+    /**
+     * Replaces all options in the select menu.
+     */
+    setOptions(options: Iterable<APISelectMenuOption>): this;
+    /**
+     * Serialises the builder into an API compatible string select menu payload.
+     */
+    toJSON(): APIStringSelectComponent;
+}

package/dist/builders/ModalStringSelectMenuBuilder.js

@@ -0,0 +1,94 @@
+import { ComponentType, } from "discord-api-types/v10";
+/** Builder for Discord string select menu components in modals. */
+export class ModalStringSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new modal string select menu builder with optional seed data.
+     */
+    constructor(data = {}) {
+        this.data = {
+            customId: data.customId,
+            placeholder: data.placeholder,
+            minValues: data.minValues,
+            maxValues: data.maxValues,
+            disabled: data.disabled,
+            required: data.required,
+            options: data.options ? [...data.options] : [],
+        };
+    }
+    /**
+     * Sets the unique custom identifier for the select menu interaction.
+     */
+    setCustomId(customId) {
+        this.data.customId = customId;
+        return this;
+    }
+    /**
+     * Sets or clears the placeholder text displayed when no option is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of options that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of options that can be selected.
+     */
+    setMaxValues(maxValues) {
+        this.data.maxValues = maxValues ?? undefined;
+        return this;
+    }
+    /**
+     * Toggles whether the select menu is disabled.
+     */
+    setDisabled(disabled) {
+        this.data.disabled = disabled;
+        return this;
+    }
+    /**
+     * Marks the select menu as required in the modal.
+     */
+    setRequired(required) {
+        this.data.required = required;
+        return this;
+    }
+    /**
+     * Adds an option to the select menu.
+     */
+    addOption(option) {
+        this.data.options.push(option);
+        return this;
+    }
+    /**
+     * Replaces all options in the select menu.
+     */
+    setOptions(options) {
+        this.data.options = Array.from(options);
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible string select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ModalStringSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.StringSelect,
+            custom_id: customId,
+            placeholder: this.data.placeholder,
+            min_values: this.data.minValues,
+            max_values: this.data.maxValues,
+            disabled: this.data.disabled,
+            required: this.data.required,
+            options: this.data.options,
+        };
+    }
+}