@minesa-org/mini-interaction 0.0.14 → 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,
+        };
+    }
+}

package/dist/builders/ModalUserSelectMenuBuilder.d.ts

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

package/dist/builders/ModalUserSelectMenuBuilder.js

@@ -0,0 +1,98 @@
+import { ComponentType, SelectMenuDefaultValueType, } from "discord-api-types/v10";
+/** Builder for Discord user select menu components in modals. */
+export class ModalUserSelectMenuBuilder {
+    data;
+    /**
+     * Creates a new modal user 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.User,
+                }))
+                : 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 user is selected.
+     */
+    setPlaceholder(placeholder) {
+        this.data.placeholder = placeholder ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the minimum number of users that must be selected.
+     */
+    setMinValues(minValues) {
+        this.data.minValues = minValues ?? undefined;
+        return this;
+    }
+    /**
+     * Sets the maximum number of users 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 user selections displayed when the menu renders.
+     */
+    setDefaultValues(defaultValues) {
+        this.data.defaultValues = Array.from(defaultValues, (value) => ({
+            ...value,
+            type: SelectMenuDefaultValueType.User,
+        }));
+        return this;
+    }
+    /**
+     * Serialises the builder into an API compatible user select menu payload.
+     */
+    toJSON() {
+        const { customId } = this.data;
+        if (!customId) {
+            throw new Error("[ModalUserSelectMenuBuilder] custom id is required.");
+        }
+        return {
+            type: ComponentType.UserSelect,
+            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.User,
+            })),
+        };
+    }
+}

package/dist/builders/RoleSelectMenuBuilder.d.ts

@@ -7,7 +7,6 @@ export type RoleSelectMenuBuilderData = {
     minValues?: number;
     maxValues?: number;
     disabled?: boolean;
-    required?: boolean;
     defaultValues?: APISelectMenuDefaultValue<SelectMenuDefaultValueType.Role>[];
 };
 /** Builder for Discord role select menu components. */
@@ -37,10 +36,6 @@ export declare class RoleSelectMenuBuilder implements JSONEncodable<APIRoleSelec
      * 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;
     /**
      * Replaces the default role selections displayed when the menu renders.
      */

package/dist/builders/RoleSelectMenuBuilder.js

@@ -12,7 +12,6 @@ export class RoleSelectMenuBuilder {
             minValues: data.minValues,
             maxValues: data.maxValues,
             disabled: data.disabled,
-            required: data.required,
             defaultValues: data.defaultValues
                 ? data.defaultValues.map((value) => ({
                     ...value,
@@ -56,13 +55,6 @@ export class RoleSelectMenuBuilder {
         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;
-    }
     /**
      * Replaces the default role selections displayed when the menu renders.
      */
@@ -88,7 +80,6 @@ export class RoleSelectMenuBuilder {
             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/StringSelectMenuBuilder.d.ts

@@ -7,7 +7,6 @@ export type StringSelectMenuBuilderData = {
     minValues?: number;
     maxValues?: number;
     disabled?: boolean;
-    required?: boolean;
     options?: APISelectMenuOption[];
 };
 /** Builder for Discord string select menu components. */
@@ -37,10 +36,6 @@ export declare class StringSelectMenuBuilder implements JSONEncodable<APIStringS
      * Toggles whether the select menu is disabled.
      */
     setDisabled(disabled: boolean): this;
-    /**
-     * Marks the select menu options as required.
-     */
-    setRequired(required: boolean): this;
     /**
      * Appends new option entries to the select menu.
      */

package/dist/builders/StringSelectMenuBuilder.js

@@ -12,7 +12,6 @@ export class StringSelectMenuBuilder {
             minValues: data.minValues,
             maxValues: data.maxValues,
             disabled: data.disabled,
-            required: data.required,
             options: data.options ? [...data.options] : [],
         };
     }
@@ -51,13 +50,6 @@ export class StringSelectMenuBuilder {
         this.data.disabled = disabled;
         return this;
     }
-    /**
-     * Marks the select menu options as required.
-     */
-    setRequired(required) {
-        this.data.required = required;
-        return this;
-    }
     /**
      * Appends new option entries to the select menu.
      */
@@ -93,7 +85,6 @@ export class StringSelectMenuBuilder {
             min_values: this.data.minValues,
             max_values: this.data.maxValues,
             disabled: this.data.disabled,
-            required: this.data.required,
             options: options.map((option) => ({ ...option })),
         };
     }

package/dist/builders/index.d.ts

@@ -9,6 +9,16 @@ export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export type { RoleSelectMenuBuilderData } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
 export type { ChannelSelectMenuBuilderData } from "./ChannelSelectMenuBuilder.js";
+export { ModalStringSelectMenuBuilder } from "./ModalStringSelectMenuBuilder.js";
+export type { ModalStringSelectMenuBuilderData } from "./ModalStringSelectMenuBuilder.js";
+export { ModalRoleSelectMenuBuilder } from "./ModalRoleSelectMenuBuilder.js";
+export type { ModalRoleSelectMenuBuilderData } from "./ModalRoleSelectMenuBuilder.js";
+export { ModalUserSelectMenuBuilder } from "./ModalUserSelectMenuBuilder.js";
+export type { ModalUserSelectMenuBuilderData } from "./ModalUserSelectMenuBuilder.js";
+export { ModalChannelSelectMenuBuilder } from "./ModalChannelSelectMenuBuilder.js";
+export type { ModalChannelSelectMenuBuilderData } from "./ModalChannelSelectMenuBuilder.js";
+export { ModalMentionableSelectMenuBuilder } from "./ModalMentionableSelectMenuBuilder.js";
+export type { ModalMentionableSelectMenuBuilderData } from "./ModalMentionableSelectMenuBuilder.js";
 export { ModalBuilder } from "./ModalBuilder.js";
 export type { ModalBuilderData, ModalComponentLike } from "./ModalBuilder.js";
 export { TextInputBuilder } from "./TextInputBuilder.js";

package/dist/builders/index.js

@@ -4,6 +4,11 @@ export { ButtonBuilder } from "./ButtonBuilder.js";
 export { StringSelectMenuBuilder } from "./StringSelectMenuBuilder.js";
 export { RoleSelectMenuBuilder } from "./RoleSelectMenuBuilder.js";
 export { ChannelSelectMenuBuilder } from "./ChannelSelectMenuBuilder.js";
+export { ModalStringSelectMenuBuilder } from "./ModalStringSelectMenuBuilder.js";
+export { ModalRoleSelectMenuBuilder } from "./ModalRoleSelectMenuBuilder.js";
+export { ModalUserSelectMenuBuilder } from "./ModalUserSelectMenuBuilder.js";
+export { ModalChannelSelectMenuBuilder } from "./ModalChannelSelectMenuBuilder.js";
+export { ModalMentionableSelectMenuBuilder } from "./ModalMentionableSelectMenuBuilder.js";
 export { ModalBuilder } from "./ModalBuilder.js";
 export { TextInputBuilder } from "./TextInputBuilder.js";
 export { LabelBuilder } from "./LabelBuilder.js";

package/dist/clients/MiniInteraction.d.ts

@@ -201,11 +201,22 @@ export declare class MiniInteraction {
     private isSupportedModuleFile;
     /**
      * Dynamically imports and validates a command module from disk.
+     * Supports multiple export patterns:
+     * - export default { data, handler }
+     * - export const command = { data, handler }
+     * - export const ping_command = { data, handler }
+     * - export const data = ...; export const handler = ...;
      */
     private importCommandModule;
     /**
      * Dynamically imports and validates a component module from disk.
      * Also handles modal components if they're in a "modals" subdirectory.
+     * Supports multiple export patterns:
+     * - export default { customId, handler }
+     * - export const component = { customId, handler }
+     * - export const ping_button = { customId, handler }
+     * - export const customId = "..."; export const handler = ...;
+     * - export const components = [{ customId, handler }, ...]
      */
     private importComponentModule;
     /**

package/dist/clients/MiniInteraction.js

@@ -515,15 +515,44 @@ export class MiniInteraction {
     }
     /**
      * Dynamically imports and validates a command module from disk.
+     * Supports multiple export patterns:
+     * - export default { data, handler }
+     * - export const command = { data, handler }
+     * - export const ping_command = { data, handler }
+     * - export const data = ...; export const handler = ...;
      */
     async importCommandModule(absolutePath) {
         try {
             const moduleUrl = pathToFileURL(absolutePath).href;
             const imported = await import(moduleUrl);
-            const candidate = imported.default ??
+            // Try to find a command object from various export patterns
+            let candidate = imported.default ??
                 imported.command ??
-                imported.commandDefinition ??
-                imported;
+                imported.commandDefinition;
+            // If not found, look for named exports ending with "_command"
+            if (!candidate) {
+                for (const [key, value] of Object.entries(imported)) {
+                    if (key.endsWith("_command") &&
+                        typeof value === "object" &&
+                        value !== null) {
+                        candidate = value;
+                        break;
+                    }
+                }
+            }
+            // If still not found, try to construct from separate data/handler exports
+            if (!candidate) {
+                if (imported.data && imported.handler) {
+                    candidate = {
+                        data: imported.data,
+                        handler: imported.handler,
+                    };
+                }
+                else {
+                    // Last resort: use the entire module
+                    candidate = imported;
+                }
+            }
             if (!candidate || typeof candidate !== "object") {
                 console.warn(`[MiniInteraction] Command module "${absolutePath}" does not export a command object. Skipping.`);
                 return null;
@@ -547,21 +576,55 @@ export class MiniInteraction {
     /**
      * Dynamically imports and validates a component module from disk.
      * Also handles modal components if they're in a "modals" subdirectory.
+     * Supports multiple export patterns:
+     * - export default { customId, handler }
+     * - export const component = { customId, handler }
+     * - export const ping_button = { customId, handler }
+     * - export const customId = "..."; export const handler = ...;
+     * - export const components = [{ customId, handler }, ...]
      */
     async importComponentModule(absolutePath) {
         try {
             const moduleUrl = pathToFileURL(absolutePath).href;
             const imported = await import(moduleUrl);
-            const candidate = imported.default ??
+            // Collect all potential component candidates
+            const candidates = [];
+            // Try standard exports first
+            const standardExport = imported.default ??
                 imported.component ??
                 imported.components ??
                 imported.componentDefinition ??
                 imported.modal ??
-                imported.modals ??
-                imported;
-            const candidates = Array.isArray(candidate)
-                ? candidate
-                : [candidate];
+                imported.modals;
+            if (standardExport) {
+                if (Array.isArray(standardExport)) {
+                    candidates.push(...standardExport);
+                }
+                else {
+                    candidates.push(standardExport);
+                }
+            }
+            // Look for named exports ending with "_button", "_select", "_modal", etc.
+            for (const [key, value] of Object.entries(imported)) {
+                if ((key.endsWith("_button") ||
+                    key.endsWith("_select") ||
+                    key.endsWith("_modal") ||
+                    key.endsWith("_component")) &&
+                    typeof value === "object" &&
+                    value !== null &&
+                    !candidates.includes(value)) {
+                    candidates.push(value);
+                }
+            }
+            // If no candidates found, try to construct from separate customId/handler exports
+            if (candidates.length === 0) {
+                if (imported.customId && imported.handler) {
+                    candidates.push({
+                        customId: imported.customId,
+                        handler: imported.handler,
+                    });
+                }
+            }
             const components = [];
             // Check if this file is in a "modals" subdirectory
             const isModalFile = absolutePath.includes(path.sep + "modals" + path.sep) ||

package/dist/utils/MessageComponentInteraction.d.ts

@@ -30,49 +30,49 @@ type BaseComponentInteractionHelpers = {
  * Button interaction with helper methods.
  * Buttons don't have values or resolved data.
  */
-export type ButtonInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface ButtonInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageButtonInteractionData;
-} & BaseComponentInteractionHelpers;
+}
 /**
  * String select menu interaction with helper methods.
  */
-export type StringSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface StringSelectInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageStringSelectInteractionData;
     values: string[];
     getStringValues: () => string[];
-} & BaseComponentInteractionHelpers;
+}
 /**
  * Role select menu interaction with helper methods.
  */
-export type RoleSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface RoleSelectInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageRoleSelectInteractionData;
     values: string[];
     getRoles: () => APIRole[];
-} & BaseComponentInteractionHelpers;
+}
 /**
  * User select menu interaction with helper methods.
  */
-export type UserSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface UserSelectInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageUserSelectInteractionData;
     values: string[];
     getUsers: () => ResolvedUserOption[];
-} & BaseComponentInteractionHelpers;
+}
 /**
  * Channel select menu interaction with helper methods.
  */
-export type ChannelSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface ChannelSelectInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageChannelSelectInteractionData;
     values: string[];
     getChannels: () => APIInteractionDataResolvedChannel[];
-} & BaseComponentInteractionHelpers;
+}
 /**
  * Mentionable select menu interaction with helper methods.
  */
-export type MentionableSelectInteraction = Omit<APIMessageComponentInteraction, "data"> & {
+export interface MentionableSelectInteraction extends Omit<APIMessageComponentInteraction, "data">, BaseComponentInteractionHelpers {
     data: APIMessageMentionableSelectInteractionData;
     values: string[];
     getMentionables: () => ResolvedMentionableOption[];
-} & BaseComponentInteractionHelpers;
+}
 /**
  * Represents a component interaction augmented with helper response methods.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@minesa-org/mini-interaction",
-	"version": "0.0.14",
+	"version": "0.0.15",
 	"description": "Mini interaction, connecting your app with Discord via HTTP-interaction (Vercel support).",
 	"type": "module",
 	"main": "dist/index.js",