@magicyan/discord 1.6.4 → 1.7.1

package/dist/functions/components/container.cjs

@@ -4,6 +4,13 @@ const core = require('@magicyan/core');
 const discord_js = require('discord.js');
 const components = require('./components.cjs');
 const message = require('../../guards/message.cjs');
+const row = require('../../guards/components/row.cjs');
+const section = require('../../guards/components/section.cjs');
+const button = require('../../guards/components/button.cjs');
+const textdisplay = require('../../guards/components/textdisplay.cjs');
+const gallery = require('../../guards/components/gallery.cjs');
+const file = require('../../guards/components/file.cjs');
+const separator = require('../../guards/components/separator.cjs');
 
 class ContainerPlusBuilder extends discord_js.ContainerBuilder {
   constructor(data) {
@@ -54,7 +61,16 @@ class ContainerPlusBuilder extends discord_js.ContainerBuilder {
    * container.setComponent(1, null); // Removes the component at index 1.
    */
   setComponent(index, data) {
-    const args = [index, 1];
+    return this._spliceComponents(index, 1, data);
+  }
+  insertComponent(argA, argB) {
+    if (typeof argA === "number") {
+      return this._spliceComponents(argA, 0, argB);
+    }
+    return this._spliceComponents(this.components.length, 0, argA);
+  }
+  _spliceComponents(index, deleteCount, data) {
+    const args = [index, deleteCount];
     if (core.isDefined(data))
       args.push(...components.createComponents(data));
     return this.spliceComponents(...args);
@@ -62,6 +78,43 @@ class ContainerPlusBuilder extends discord_js.ContainerBuilder {
   componentAt(index, type) {
     return core.isDefined(type) ? this.components.filter((builder) => builder.data.type === type).at(index) : this.components.at(index);
   }
+  get buttonComponents() {
+    return this.components.filter(
+      (comp) => row.isActionRowBuilder(comp, "buttons") || section.isSectionBuilder(comp)
+    ).flatMap((comp) => {
+      if (section.isSectionBuilder(comp)) {
+        if (!comp.accessory || !button.isButtonBuilder(comp.accessory))
+          return [];
+        return [comp.accessory];
+      }
+      return comp.components;
+    });
+  }
+  get sectionComponents() {
+    return this.components.filter(section.isSectionBuilder);
+  }
+  get selectMenuComponents() {
+    return this.components.filter(
+      (comp) => row.isActionRowBuilder(comp, "selects")
+    ).flatMap((comp) => comp.components);
+  }
+  get textDisplayComponents() {
+    return this.components.filter(textdisplay.isTextDisplayBuilder);
+  }
+  get actionRowComponents() {
+    return this.components.filter(
+      (row$1) => row.isActionRowBuilder(row$1, "buttons") || row.isActionRowBuilder(row$1, "selects")
+    );
+  }
+  get mediaGalleryComponents() {
+    return this.components.filter(gallery.isMediaGalleryBuilder);
+  }
+  get fileComponents() {
+    return this.components.filter(file.isFileBuilder);
+  }
+  get separatorComponents() {
+    return this.components.filter(separator.isSeparatorBuilder);
+  }
 }
 function createContainer(data, ...items) {
   const isContainerData = (value) => typeof value === "object" && core.isDefined(value) && !Array.isArray(value);

package/dist/functions/components/container.mjs

@@ -2,6 +2,13 @@ import { isDefined } from '@magicyan/core';
 import { ContainerBuilder, resolveColor, ComponentType } from 'discord.js';
 import { createComponents } from './components.mjs';
 import { isMessage } from '../../guards/message.mjs';
+import { isActionRowBuilder } from '../../guards/components/row.mjs';
+import { isSectionBuilder } from '../../guards/components/section.mjs';
+import { isButtonBuilder } from '../../guards/components/button.mjs';
+import { isTextDisplayBuilder } from '../../guards/components/textdisplay.mjs';
+import { isMediaGalleryBuilder } from '../../guards/components/gallery.mjs';
+import { isFileBuilder } from '../../guards/components/file.mjs';
+import { isSeparatorBuilder } from '../../guards/components/separator.mjs';
 
 class ContainerPlusBuilder extends ContainerBuilder {
   constructor(data) {
@@ -52,7 +59,16 @@ class ContainerPlusBuilder extends ContainerBuilder {
    * container.setComponent(1, null); // Removes the component at index 1.
    */
   setComponent(index, data) {
-    const args = [index, 1];
+    return this._spliceComponents(index, 1, data);
+  }
+  insertComponent(argA, argB) {
+    if (typeof argA === "number") {
+      return this._spliceComponents(argA, 0, argB);
+    }
+    return this._spliceComponents(this.components.length, 0, argA);
+  }
+  _spliceComponents(index, deleteCount, data) {
+    const args = [index, deleteCount];
     if (isDefined(data))
       args.push(...createComponents(data));
     return this.spliceComponents(...args);
@@ -60,6 +76,43 @@ class ContainerPlusBuilder extends ContainerBuilder {
   componentAt(index, type) {
     return isDefined(type) ? this.components.filter((builder) => builder.data.type === type).at(index) : this.components.at(index);
   }
+  get buttonComponents() {
+    return this.components.filter(
+      (comp) => isActionRowBuilder(comp, "buttons") || isSectionBuilder(comp)
+    ).flatMap((comp) => {
+      if (isSectionBuilder(comp)) {
+        if (!comp.accessory || !isButtonBuilder(comp.accessory))
+          return [];
+        return [comp.accessory];
+      }
+      return comp.components;
+    });
+  }
+  get sectionComponents() {
+    return this.components.filter(isSectionBuilder);
+  }
+  get selectMenuComponents() {
+    return this.components.filter(
+      (comp) => isActionRowBuilder(comp, "selects")
+    ).flatMap((comp) => comp.components);
+  }
+  get textDisplayComponents() {
+    return this.components.filter(isTextDisplayBuilder);
+  }
+  get actionRowComponents() {
+    return this.components.filter(
+      (row) => isActionRowBuilder(row, "buttons") || isActionRowBuilder(row, "selects")
+    );
+  }
+  get mediaGalleryComponents() {
+    return this.components.filter(isMediaGalleryBuilder);
+  }
+  get fileComponents() {
+    return this.components.filter(isFileBuilder);
+  }
+  get separatorComponents() {
+    return this.components.filter(isSeparatorBuilder);
+  }
 }
 function createContainer(data, ...items) {
   const isContainerData = (value) => typeof value === "object" && isDefined(value) && !Array.isArray(value);

package/dist/functions/components/gallery.cjs

@@ -6,7 +6,7 @@ const core = require('@magicyan/core');
 
 function createMediaGallery(...items) {
   return new discord_js.MediaGalleryBuilder({
-    items: items.flat().filter(core.isDefined).map((item) => {
+    items: items.flat().filter((item) => typeof item !== "boolean").filter(core.isDefined).map((item) => {
       if (typeof item === "string") {
         return { media: { url: item } };
       }

package/dist/functions/components/gallery.mjs

@@ -4,7 +4,7 @@ import { isDefined } from '@magicyan/core';
 
 function createMediaGallery(...items) {
   return new MediaGalleryBuilder({
-    items: items.flat().filter(isDefined).map((item) => {
+    items: items.flat().filter((item) => typeof item !== "boolean").filter(isDefined).map((item) => {
       if (typeof item === "string") {
         return { media: { url: item } };
       }

package/dist/functions/components/label.cjs

@@ -2,26 +2,33 @@
 
 const discord_js = require('discord.js');
 
-function createLabel(argA, argB, argC, argD) {
-  if (typeof argA === "object") {
-    const { component, ...data } = argA;
-    return new discord_js.LabelBuilder({
+function createLabel(a, b, c, d) {
+  const label = new discord_js.LabelBuilder();
+  if (typeof a === "object") {
+    const { component, ...data } = a;
+    Object.assign(label.data, {
       ...data,
-      component: component?.toJSON()
+      component: discord_js.isJSONEncodable(component) ? component.toJSON() : component
     });
+    return label;
   }
-  if (typeof argB === "string") {
-    return new discord_js.LabelBuilder({
-      label: argA,
-      description: argB,
-      ...typeof argC === "number" ? { id: argC } : { component: argC?.toJSON(), id: argD }
+  if (typeof b === "string") {
+    Object.assign(label.data, {
+      label: a,
+      description: b,
+      ...typeof c === "number" ? { id: c } : {
+        component: discord_js.isJSONEncodable(c) ? c.toJSON() : c,
+        id: d
+      }
     });
+    return label;
   }
-  return new discord_js.LabelBuilder({
-    label: argA,
-    component: argB?.toJSON(),
-    ...typeof argC === "number" ? { id: argC } : {}
+  Object.assign(label.data, {
+    label: a,
+    component: discord_js.isJSONEncodable(b) ? b.toJSON() : b,
+    ...typeof c === "number" ? { id: c } : {}
   });
+  return label;
 }
 
 exports.createLabel = createLabel;

package/dist/functions/components/label.mjs

@@ -1,25 +1,32 @@
-import { LabelBuilder } from 'discord.js';
+import { LabelBuilder, isJSONEncodable } from 'discord.js';
 
-function createLabel(argA, argB, argC, argD) {
-  if (typeof argA === "object") {
-    const { component, ...data } = argA;
-    return new LabelBuilder({
+function createLabel(a, b, c, d) {
+  const label = new LabelBuilder();
+  if (typeof a === "object") {
+    const { component, ...data } = a;
+    Object.assign(label.data, {
       ...data,
-      component: component?.toJSON()
+      component: isJSONEncodable(component) ? component.toJSON() : component
     });
+    return label;
   }
-  if (typeof argB === "string") {
-    return new LabelBuilder({
-      label: argA,
-      description: argB,
-      ...typeof argC === "number" ? { id: argC } : { component: argC?.toJSON(), id: argD }
+  if (typeof b === "string") {
+    Object.assign(label.data, {
+      label: a,
+      description: b,
+      ...typeof c === "number" ? { id: c } : {
+        component: isJSONEncodable(c) ? c.toJSON() : c,
+        id: d
+      }
     });
+    return label;
   }
-  return new LabelBuilder({
-    label: argA,
-    component: argB?.toJSON(),
-    ...typeof argC === "number" ? { id: argC } : {}
+  Object.assign(label.data, {
+    label: a,
+    component: isJSONEncodable(b) ? b.toJSON() : b,
+    ...typeof c === "number" ? { id: c } : {}
   });
+  return label;
 }
 
 export { createLabel };

package/dist/functions/components/modal.cjs

@@ -30,6 +30,21 @@ function createModalFields(...components) {
     return data.data;
   });
 }
+function createModal(data, title, ...components) {
+  if (typeof data === "string") {
+    return new discord_js.ModalBuilder({
+      customId: data,
+      title,
+      components: createModalFields(...components)
+    });
+  }
+  return new discord_js.ModalBuilder({
+    customId: data.title,
+    title: data.title,
+    components: createModalFields(...data.components ?? [])
+  });
+}
 
+exports.createModal = createModal;
 exports.createModalFields = createModalFields;
 exports.modalFieldsToRecord = modalFieldsToRecord;

package/dist/functions/components/modal.mjs

@@ -1,5 +1,5 @@
 import { isDefined } from '@magicyan/core';
-import { ComponentType } from 'discord.js';
+import { ComponentType, ModalBuilder } from 'discord.js';
 
 function modalFieldsToRecord(data, parse) {
   const collection = "fields" in data ? "fields" in data.fields ? data.fields.fields : data.fields : data;
@@ -28,5 +28,19 @@ function createModalFields(...components) {
     return data.data;
   });
 }
+function createModal(data, title, ...components) {
+  if (typeof data === "string") {
+    return new ModalBuilder({
+      customId: data,
+      title,
+      components: createModalFields(...components)
+    });
+  }
+  return new ModalBuilder({
+    customId: data.title,
+    title: data.title,
+    components: createModalFields(...data.components ?? [])
+  });
+}
 
-export { createModalFields, modalFieldsToRecord };
+export { createModal, createModalFields, modalFieldsToRecord };

package/dist/functions/components/row.cjs

@@ -1,10 +1,11 @@
 'use strict';
 
+const core = require('@magicyan/core');
 const discord_js = require('discord.js');
 
 function createRow(...components) {
   return new discord_js.ActionRowBuilder({
-    components: components.flat()
+    components: components.flat().filter((c) => typeof c !== "boolean").filter((c) => core.isDefined(c))
   });
 }
 

package/dist/functions/components/row.mjs

@@ -1,8 +1,9 @@
+import { isDefined } from '@magicyan/core';
 import { ActionRowBuilder } from 'discord.js';
 
 function createRow(...components) {
   return new ActionRowBuilder({
-    components: components.flat()
+    components: components.flat().filter((c) => typeof c !== "boolean").filter((c) => isDefined(c))
   });
 }
 

package/dist/guards/components/file.cjs

@@ -0,0 +1,10 @@
+'use strict';
+
+const discord_js = require('discord.js');
+const utils = require('../utils.cjs');
+
+function isFileBuilder(value) {
+  return value instanceof discord_js.FileBuilder || utils.hasConstructor(value) && value.constructor.name === discord_js.FileBuilder.name;
+}
+
+exports.isFileBuilder = isFileBuilder;

package/dist/guards/components/file.mjs

@@ -0,0 +1,8 @@
+import { FileBuilder } from 'discord.js';
+import { hasConstructor } from '../utils.mjs';
+
+function isFileBuilder(value) {
+  return value instanceof FileBuilder || hasConstructor(value) && value.constructor.name === FileBuilder.name;
+}
+
+export { isFileBuilder };

package/dist/guards/components/row.cjs

@@ -4,12 +4,11 @@ const discord_js = require('discord.js');
 const selectmenu = require('./selectmenu.cjs');
 const button = require('./button.cjs');
 const utils = require('../utils.cjs');
-const textinput = require('./textinput.cjs');
 
 function isActionRowBuilder(value, withComponent) {
   const isActionRow = utils.hasConstructor(value) && value.constructor.name === discord_js.ActionRowBuilder.name && "components" in value && Array.isArray(value.components);
   if (isActionRow && withComponent) {
-    const guard = withComponent === "selects" ? selectmenu.isAnySelectMenuBuilder : withComponent === "buttons" ? button.isButtonBuilder : textinput.isTextInputBuilder;
+    const guard = withComponent === "selects" ? selectmenu.isAnySelectMenuBuilder : button.isButtonBuilder;
     return value.components.some(guard);
   }
   return isActionRow;

package/dist/guards/components/row.mjs

@@ -2,12 +2,11 @@ import { ActionRowBuilder } from 'discord.js';
 import { isAnySelectMenuBuilder } from './selectmenu.mjs';
 import { isButtonBuilder } from './button.mjs';
 import { hasConstructor } from '../utils.mjs';
-import { isTextInputBuilder } from './textinput.mjs';
 
 function isActionRowBuilder(value, withComponent) {
   const isActionRow = hasConstructor(value) && value.constructor.name === ActionRowBuilder.name && "components" in value && Array.isArray(value.components);
   if (isActionRow && withComponent) {
-    const guard = withComponent === "selects" ? isAnySelectMenuBuilder : withComponent === "buttons" ? isButtonBuilder : isTextInputBuilder;
+    const guard = withComponent === "selects" ? isAnySelectMenuBuilder : isButtonBuilder;
     return value.components.some(guard);
   }
   return isActionRow;

package/dist/index.cjs

@@ -41,6 +41,7 @@ const modal$1 = require('./guards/components/modal.cjs');
 const row$1 = require('./guards/components/row.cjs');
 const section$1 = require('./guards/components/section.cjs');
 const selectmenu = require('./guards/components/selectmenu.cjs');
+const file$1 = require('./guards/components/file.cjs');
 const separator$2 = require('./guards/components/separator.cjs');
 const textdisplay = require('./guards/components/textdisplay.cjs');
 const textinput = require('./guards/components/textinput.cjs');
@@ -77,6 +78,7 @@ exports.createMediaGallery = gallery.createMediaGallery;
 exports.createModalInput = input.createModalInput;
 exports.createTextInput = input.createTextInput;
 exports.createLabel = label.createLabel;
+exports.createModal = modal.createModal;
 exports.createModalFields = modal.createModalFields;
 exports.modalFieldsToRecord = modal.modalFieldsToRecord;
 exports.createRow = row.createRow;
@@ -106,6 +108,7 @@ exports.isMentionableSelectMenuBuilder = selectmenu.isMentionableSelectMenuBuild
 exports.isRoleSelectMenuBuilder = selectmenu.isRoleSelectMenuBuilder;
 exports.isStringSelectMenuBuilder = selectmenu.isStringSelectMenuBuilder;
 exports.isUserSelectMenuBuilder = selectmenu.isUserSelectMenuBuilder;
+exports.isFileBuilder = file$1.isFileBuilder;
 exports.isSeparatorBuilder = separator$2.isSeparatorBuilder;
 exports.isTextDisplayBuilder = textdisplay.isTextDisplayBuilder;
 exports.isTextInputBuilder = textinput.isTextInputBuilder;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilder, LabelBuilderData, ComponentInLabelData, ModalBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -216,7 +216,7 @@ type CreateComponentData = ComponentData | ContainerBuilder;
 type ContainerComponentBuilder = Exclude<ContainerComponentBuilder$1, ActionRowBuilder> | ActionRowBuilder<MessageActionRowComponentBuilder>;
 type CreateComponentsReturn<IsContainer> = IsContainer extends true ? ContainerComponentBuilder[] : (ContainerComponentBuilder | ContainerBuilder)[];
 type CreateComponentsData<IsContainer> = IsContainer extends true ? ComponentData : ComponentData | ContainerBuilder;
-declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer> = CreateComponentsData<IsContainer>>(...data: (Data | Data[])[]): CreateComponentsReturn<IsContainer>;
+declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer>[] = CreateComponentsData<IsContainer>[]>(...data: (Data | Data[])): CreateComponentsReturn<IsContainer>;
 
 type ContainerColor = (string & {}) | ColorResolvable;
 type ContainerInComponentType = ComponentType.TextDisplay | ComponentType.ActionRow | ComponentType.Section | ComponentType.Separator | ComponentType.MediaGallery | ComponentType.File;
@@ -261,6 +261,9 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
      * container.setComponent(1, null); // Removes the component at index 1.
      */
     setComponent(index: number, data: ComponentData | null): this;
+    insertComponent(data: ComponentData): this;
+    insertComponent(index: number, data?: ComponentData): this;
+    private _spliceComponents;
     /**
      * Retrieves a component from the container at the specified index, optionally filtering by component type.
      *
@@ -281,6 +284,14 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
     componentAt(index: number, type: ComponentType.Separator): SeparatorBuilder | undefined;
     componentAt(index: number, type: ComponentType.MediaGallery): MediaGalleryBuilder | undefined;
     componentAt(index: number, type: ComponentType.File): FileBuilder | undefined;
+    get buttonComponents(): ButtonBuilder[];
+    get sectionComponents(): SectionBuilder[];
+    get selectMenuComponents(): AnySelectMenuBuilder[];
+    get textDisplayComponents(): TextDisplayBuilder[];
+    get actionRowComponents(): (ActionRowBuilder<ButtonBuilder> | ActionRowBuilder<AnySelectMenuBuilder>)[];
+    get mediaGalleryComponents(): MediaGalleryBuilder[];
+    get fileComponents(): FileBuilder[];
+    get separatorComponents(): SeparatorBuilder[];
 }
 /**
  * Creates one or multiple {@link ContainerPlusBuilder} components with optional accent color and child components.
@@ -370,7 +381,7 @@ interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
  */
 declare function createFile(source: FileSource, options?: CreateFileOptions): FileBuilder;
 
-type MediaGallerySource = MediaGalleryItemData | string | Attachment | AttachmentBuilder | null | undefined;
+type MediaGallerySource = MediaGalleryItemData | Attachment | AttachmentBuilder | string | null | undefined | boolean;
 /**
  * Creates a {@link MediaGalleryBuilder} instance with a collection of media items, which can be images, attachments, or URLs.
  *
@@ -422,11 +433,46 @@ declare function createModalInput(data: Omit<TextInputComponentData, "type" | "s
     style?: TextInputStyle;
 }): ActionRowBuilder<TextInputBuilder>;
 
-type CreateLabelData = Omit<LabelBuilderData, "type">;
-type ComponentInLabelBuilder = NonNullable<CreateLabelData["component"]>;
+interface Unstable_CheckboxData {
+    type: ComponentType.Checkbox;
+    customId: string;
+    default?: boolean;
+    id?: number;
+}
+interface Unstable_CheckboxGroupData {
+    type: ComponentType.CheckboxGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface Unstable_RadioGroupData {
+    type: ComponentType.RadioGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface CreateLabelData extends Omit<LabelBuilderData, "type" | "component"> {
+    component?: LabelBuilderData["component"] | ComponentInLabelData | Unstable_CheckboxData | Unstable_CheckboxGroupData | Unstable_RadioGroupData;
+}
 declare function createLabel(data: CreateLabelData): LabelBuilder;
-declare function createLabel(label: string, description?: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
-declare function createLabel(label: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
+declare function createLabel(label: string, description?: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
+declare function createLabel(label: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
 
 type ModalComponents = LabelBuilder | TextDisplayBuilder | string | null | boolean | undefined;
 type ResolveModalData = {
@@ -471,7 +517,17 @@ declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveM
 declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
+interface CreateModalOptions {
+    customId: string;
+    title: string;
+    components: ModalComponents[];
+}
+declare function createModal(data: Partial<CreateModalOptions>): ModalBuilder;
+declare function createModal(customId: string): ModalBuilder;
+declare function createModal(customId: string, title: string): ModalBuilder;
+declare function createModal(customId: string, title: string, ...components: ModalComponents[]): ModalBuilder;
 
+type NullableValues = null | undefined | boolean;
 /**
  * Creates an {@link ActionRowBuilder} containing one or more UI components.
  *
@@ -511,7 +567,7 @@ declare function createModalFields(...components: ModalComponents[]): ModalField
  *     })
  * );
  */
-declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
+declare function createRow<Component extends AnyComponentBuilder>(...components: (NullableValues | Component | Component[])[]): ActionRowBuilder<Component>;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
 /**
@@ -1084,7 +1140,6 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 declare function isActionRowBuilder(value: unknown): value is ActionRowBuilder;
 declare function isActionRowBuilder(value: unknown, withComponents: "selects"): value is ActionRowBuilder<AnySelectMenuBuilder>;
 declare function isActionRowBuilder(value: unknown, withComponents: "buttons"): value is ActionRowBuilder<ButtonBuilder>;
-declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): value is ActionRowBuilder<TextInputBuilder>;
 
 /**
  * Checks whether the given value is a {@link SectionBuilder}.
@@ -1106,6 +1161,26 @@ declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): v
  */
 declare function isSectionBuilder(value: unknown): value is SectionBuilder;
 
+/**
+ * Checks whether the given value is a {@link FileBuilder}.
+ *
+ * This function returns `true` if the value is an instance of `FileBuilder`,
+ * or if it structurally matches by constructor name.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a `FileBuilder`, otherwise `false`.
+ *
+ * @example
+ * import type { FileBuilder } from "discord.js";
+ *
+ * function handle(input: FileBuilder | unknown) {
+ *   if (FileBuilder(input)) {
+ *     input.setURL("https://example.com/image.png");
+ *   }
+ * }
+ */
+declare function isFileBuilder(value: unknown): value is FileBuilder;
+
 /**
  * Checks whether the given value is a {@link SeparatorBuilder}.
  *
@@ -1187,5 +1262,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModal, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isFileBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateModalOptions, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData, Unstable_CheckboxData, Unstable_CheckboxGroupData, Unstable_RadioGroupData };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilder, LabelBuilderData, ComponentInLabelData, ModalBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -216,7 +216,7 @@ type CreateComponentData = ComponentData | ContainerBuilder;
 type ContainerComponentBuilder = Exclude<ContainerComponentBuilder$1, ActionRowBuilder> | ActionRowBuilder<MessageActionRowComponentBuilder>;
 type CreateComponentsReturn<IsContainer> = IsContainer extends true ? ContainerComponentBuilder[] : (ContainerComponentBuilder | ContainerBuilder)[];
 type CreateComponentsData<IsContainer> = IsContainer extends true ? ComponentData : ComponentData | ContainerBuilder;
-declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer> = CreateComponentsData<IsContainer>>(...data: (Data | Data[])[]): CreateComponentsReturn<IsContainer>;
+declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer>[] = CreateComponentsData<IsContainer>[]>(...data: (Data | Data[])): CreateComponentsReturn<IsContainer>;
 
 type ContainerColor = (string & {}) | ColorResolvable;
 type ContainerInComponentType = ComponentType.TextDisplay | ComponentType.ActionRow | ComponentType.Section | ComponentType.Separator | ComponentType.MediaGallery | ComponentType.File;
@@ -261,6 +261,9 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
      * container.setComponent(1, null); // Removes the component at index 1.
      */
     setComponent(index: number, data: ComponentData | null): this;
+    insertComponent(data: ComponentData): this;
+    insertComponent(index: number, data?: ComponentData): this;
+    private _spliceComponents;
     /**
      * Retrieves a component from the container at the specified index, optionally filtering by component type.
      *
@@ -281,6 +284,14 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
     componentAt(index: number, type: ComponentType.Separator): SeparatorBuilder | undefined;
     componentAt(index: number, type: ComponentType.MediaGallery): MediaGalleryBuilder | undefined;
     componentAt(index: number, type: ComponentType.File): FileBuilder | undefined;
+    get buttonComponents(): ButtonBuilder[];
+    get sectionComponents(): SectionBuilder[];
+    get selectMenuComponents(): AnySelectMenuBuilder[];
+    get textDisplayComponents(): TextDisplayBuilder[];
+    get actionRowComponents(): (ActionRowBuilder<ButtonBuilder> | ActionRowBuilder<AnySelectMenuBuilder>)[];
+    get mediaGalleryComponents(): MediaGalleryBuilder[];
+    get fileComponents(): FileBuilder[];
+    get separatorComponents(): SeparatorBuilder[];
 }
 /**
  * Creates one or multiple {@link ContainerPlusBuilder} components with optional accent color and child components.
@@ -370,7 +381,7 @@ interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
  */
 declare function createFile(source: FileSource, options?: CreateFileOptions): FileBuilder;
 
-type MediaGallerySource = MediaGalleryItemData | string | Attachment | AttachmentBuilder | null | undefined;
+type MediaGallerySource = MediaGalleryItemData | Attachment | AttachmentBuilder | string | null | undefined | boolean;
 /**
  * Creates a {@link MediaGalleryBuilder} instance with a collection of media items, which can be images, attachments, or URLs.
  *
@@ -422,11 +433,46 @@ declare function createModalInput(data: Omit<TextInputComponentData, "type" | "s
     style?: TextInputStyle;
 }): ActionRowBuilder<TextInputBuilder>;
 
-type CreateLabelData = Omit<LabelBuilderData, "type">;
-type ComponentInLabelBuilder = NonNullable<CreateLabelData["component"]>;
+interface Unstable_CheckboxData {
+    type: ComponentType.Checkbox;
+    customId: string;
+    default?: boolean;
+    id?: number;
+}
+interface Unstable_CheckboxGroupData {
+    type: ComponentType.CheckboxGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface Unstable_RadioGroupData {
+    type: ComponentType.RadioGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface CreateLabelData extends Omit<LabelBuilderData, "type" | "component"> {
+    component?: LabelBuilderData["component"] | ComponentInLabelData | Unstable_CheckboxData | Unstable_CheckboxGroupData | Unstable_RadioGroupData;
+}
 declare function createLabel(data: CreateLabelData): LabelBuilder;
-declare function createLabel(label: string, description?: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
-declare function createLabel(label: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
+declare function createLabel(label: string, description?: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
+declare function createLabel(label: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
 
 type ModalComponents = LabelBuilder | TextDisplayBuilder | string | null | boolean | undefined;
 type ResolveModalData = {
@@ -471,7 +517,17 @@ declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveM
 declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
+interface CreateModalOptions {
+    customId: string;
+    title: string;
+    components: ModalComponents[];
+}
+declare function createModal(data: Partial<CreateModalOptions>): ModalBuilder;
+declare function createModal(customId: string): ModalBuilder;
+declare function createModal(customId: string, title: string): ModalBuilder;
+declare function createModal(customId: string, title: string, ...components: ModalComponents[]): ModalBuilder;
 
+type NullableValues = null | undefined | boolean;
 /**
  * Creates an {@link ActionRowBuilder} containing one or more UI components.
  *
@@ -511,7 +567,7 @@ declare function createModalFields(...components: ModalComponents[]): ModalField
  *     })
  * );
  */
-declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
+declare function createRow<Component extends AnyComponentBuilder>(...components: (NullableValues | Component | Component[])[]): ActionRowBuilder<Component>;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
 /**
@@ -1084,7 +1140,6 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 declare function isActionRowBuilder(value: unknown): value is ActionRowBuilder;
 declare function isActionRowBuilder(value: unknown, withComponents: "selects"): value is ActionRowBuilder<AnySelectMenuBuilder>;
 declare function isActionRowBuilder(value: unknown, withComponents: "buttons"): value is ActionRowBuilder<ButtonBuilder>;
-declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): value is ActionRowBuilder<TextInputBuilder>;
 
 /**
  * Checks whether the given value is a {@link SectionBuilder}.
@@ -1106,6 +1161,26 @@ declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): v
  */
 declare function isSectionBuilder(value: unknown): value is SectionBuilder;
 
+/**
+ * Checks whether the given value is a {@link FileBuilder}.
+ *
+ * This function returns `true` if the value is an instance of `FileBuilder`,
+ * or if it structurally matches by constructor name.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a `FileBuilder`, otherwise `false`.
+ *
+ * @example
+ * import type { FileBuilder } from "discord.js";
+ *
+ * function handle(input: FileBuilder | unknown) {
+ *   if (FileBuilder(input)) {
+ *     input.setURL("https://example.com/image.png");
+ *   }
+ * }
+ */
+declare function isFileBuilder(value: unknown): value is FileBuilder;
+
 /**
  * Checks whether the given value is a {@link SeparatorBuilder}.
  *
@@ -1187,5 +1262,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModal, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isFileBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateModalOptions, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData, Unstable_CheckboxData, Unstable_CheckboxGroupData, Unstable_RadioGroupData };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilderData, LabelBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, ModalBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, ChannelType, Guild, CommandInteractionOption, Client, ApplicationCommand, GuildEmoji, GuildMember, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, ComponentEmojiResolvable, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, Attachment, AttachmentBuilder, MessageActionRowComponentBuilder, TextDisplayBuilder, SeparatorBuilder, FileBuilder, SectionBuilder, MediaGalleryBuilder, ContainerBuilder, ContainerComponentBuilder as ContainerComponentBuilder$1, ColorResolvable, ComponentType, ContainerComponentData, ContainerComponent, APIUnfurledMediaItem, MediaGalleryItemData, TextInputBuilder, TextInputComponentData, TextInputStyle, LabelBuilder, LabelBuilderData, ComponentInLabelData, ModalBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, EmbedAssetData, User, ClientUser, ImageURLOptions, EmbedFooterData, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, MediaGalleryItemBuilder, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -216,7 +216,7 @@ type CreateComponentData = ComponentData | ContainerBuilder;
 type ContainerComponentBuilder = Exclude<ContainerComponentBuilder$1, ActionRowBuilder> | ActionRowBuilder<MessageActionRowComponentBuilder>;
 type CreateComponentsReturn<IsContainer> = IsContainer extends true ? ContainerComponentBuilder[] : (ContainerComponentBuilder | ContainerBuilder)[];
 type CreateComponentsData<IsContainer> = IsContainer extends true ? ComponentData : ComponentData | ContainerBuilder;
-declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer> = CreateComponentsData<IsContainer>>(...data: (Data | Data[])[]): CreateComponentsReturn<IsContainer>;
+declare function createComponents<IsContainer extends boolean = false, Data extends CreateComponentsData<IsContainer>[] = CreateComponentsData<IsContainer>[]>(...data: (Data | Data[])): CreateComponentsReturn<IsContainer>;
 
 type ContainerColor = (string & {}) | ColorResolvable;
 type ContainerInComponentType = ComponentType.TextDisplay | ComponentType.ActionRow | ComponentType.Section | ComponentType.Separator | ComponentType.MediaGallery | ComponentType.File;
@@ -261,6 +261,9 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
      * container.setComponent(1, null); // Removes the component at index 1.
      */
     setComponent(index: number, data: ComponentData | null): this;
+    insertComponent(data: ComponentData): this;
+    insertComponent(index: number, data?: ComponentData): this;
+    private _spliceComponents;
     /**
      * Retrieves a component from the container at the specified index, optionally filtering by component type.
      *
@@ -281,6 +284,14 @@ declare class ContainerPlusBuilder extends ContainerBuilder {
     componentAt(index: number, type: ComponentType.Separator): SeparatorBuilder | undefined;
     componentAt(index: number, type: ComponentType.MediaGallery): MediaGalleryBuilder | undefined;
     componentAt(index: number, type: ComponentType.File): FileBuilder | undefined;
+    get buttonComponents(): ButtonBuilder[];
+    get sectionComponents(): SectionBuilder[];
+    get selectMenuComponents(): AnySelectMenuBuilder[];
+    get textDisplayComponents(): TextDisplayBuilder[];
+    get actionRowComponents(): (ActionRowBuilder<ButtonBuilder> | ActionRowBuilder<AnySelectMenuBuilder>)[];
+    get mediaGalleryComponents(): MediaGalleryBuilder[];
+    get fileComponents(): FileBuilder[];
+    get separatorComponents(): SeparatorBuilder[];
 }
 /**
  * Creates one or multiple {@link ContainerPlusBuilder} components with optional accent color and child components.
@@ -370,7 +381,7 @@ interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
  */
 declare function createFile(source: FileSource, options?: CreateFileOptions): FileBuilder;
 
-type MediaGallerySource = MediaGalleryItemData | string | Attachment | AttachmentBuilder | null | undefined;
+type MediaGallerySource = MediaGalleryItemData | Attachment | AttachmentBuilder | string | null | undefined | boolean;
 /**
  * Creates a {@link MediaGalleryBuilder} instance with a collection of media items, which can be images, attachments, or URLs.
  *
@@ -422,11 +433,46 @@ declare function createModalInput(data: Omit<TextInputComponentData, "type" | "s
     style?: TextInputStyle;
 }): ActionRowBuilder<TextInputBuilder>;
 
-type CreateLabelData = Omit<LabelBuilderData, "type">;
-type ComponentInLabelBuilder = NonNullable<CreateLabelData["component"]>;
+interface Unstable_CheckboxData {
+    type: ComponentType.Checkbox;
+    customId: string;
+    default?: boolean;
+    id?: number;
+}
+interface Unstable_CheckboxGroupData {
+    type: ComponentType.CheckboxGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    minValues?: number;
+    maxValues?: number;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface Unstable_RadioGroupData {
+    type: ComponentType.RadioGroup;
+    id?: number;
+    customId: string;
+    required?: boolean;
+    options: {
+        label: string;
+        value: string;
+        description?: string;
+        default?: boolean;
+    }[];
+}
+
+interface CreateLabelData extends Omit<LabelBuilderData, "type" | "component"> {
+    component?: LabelBuilderData["component"] | ComponentInLabelData | Unstable_CheckboxData | Unstable_CheckboxGroupData | Unstable_RadioGroupData;
+}
 declare function createLabel(data: CreateLabelData): LabelBuilder;
-declare function createLabel(label: string, description?: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
-declare function createLabel(label: string, component?: ComponentInLabelBuilder, id?: number): LabelBuilder;
+declare function createLabel(label: string, description?: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
+declare function createLabel(label: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
 
 type ModalComponents = LabelBuilder | TextDisplayBuilder | string | null | boolean | undefined;
 type ResolveModalData = {
@@ -471,7 +517,17 @@ declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveM
 declare function modalFieldsToRecord<const T = ModalFieldsRecord>(data: ResolveModalData, parse: (record: ModalFieldsRecord) => T): T;
 type ModalFields = (LabelComponentData | TextDisplayComponentData)[];
 declare function createModalFields(...components: ModalComponents[]): ModalFields;
+interface CreateModalOptions {
+    customId: string;
+    title: string;
+    components: ModalComponents[];
+}
+declare function createModal(data: Partial<CreateModalOptions>): ModalBuilder;
+declare function createModal(customId: string): ModalBuilder;
+declare function createModal(customId: string, title: string): ModalBuilder;
+declare function createModal(customId: string, title: string, ...components: ModalComponents[]): ModalBuilder;
 
+type NullableValues = null | undefined | boolean;
 /**
  * Creates an {@link ActionRowBuilder} containing one or more UI components.
  *
@@ -511,7 +567,7 @@ declare function createModalFields(...components: ModalComponents[]): ModalField
  *     })
  * );
  */
-declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
+declare function createRow<Component extends AnyComponentBuilder>(...components: (NullableValues | Component | Component[])[]): ActionRowBuilder<Component>;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
 /**
@@ -1084,7 +1140,6 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 declare function isActionRowBuilder(value: unknown): value is ActionRowBuilder;
 declare function isActionRowBuilder(value: unknown, withComponents: "selects"): value is ActionRowBuilder<AnySelectMenuBuilder>;
 declare function isActionRowBuilder(value: unknown, withComponents: "buttons"): value is ActionRowBuilder<ButtonBuilder>;
-declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): value is ActionRowBuilder<TextInputBuilder>;
 
 /**
  * Checks whether the given value is a {@link SectionBuilder}.
@@ -1106,6 +1161,26 @@ declare function isActionRowBuilder(value: unknown, withComponents: "inputs"): v
  */
 declare function isSectionBuilder(value: unknown): value is SectionBuilder;
 
+/**
+ * Checks whether the given value is a {@link FileBuilder}.
+ *
+ * This function returns `true` if the value is an instance of `FileBuilder`,
+ * or if it structurally matches by constructor name.
+ *
+ * @param value - The value to check.
+ * @returns `true` if the value is a `FileBuilder`, otherwise `false`.
+ *
+ * @example
+ * import type { FileBuilder } from "discord.js";
+ *
+ * function handle(input: FileBuilder | unknown) {
+ *   if (FileBuilder(input)) {
+ *     input.setURL("https://example.com/image.png");
+ *   }
+ * }
+ */
+declare function isFileBuilder(value: unknown): value is FileBuilder;
+
 /**
  * Checks whether the given value is a {@link SeparatorBuilder}.
  *
@@ -1187,5 +1262,5 @@ declare function isTextInputBuilder(value: unknown): value is TextInputBuilder;
  */
 declare function isMessage(value: unknown): value is Message;
 
-export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
-export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ComponentInLabelBuilder, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateLabelData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModal, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageURLInfo, isActionRowBuilder, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, isChannelSelectMenuBuilder, isContainerBuilder, isFileBuilder, isMediaGalleryBuilder, isMediaGalleryItemBuilder, isMentionableSelectMenuBuilder, isMessage, isModalBuilder, isRoleSelectMenuBuilder, isSectionBuilder, isSeparatorBuilder, isStringSelectMenuBuilder, isTextDisplayBuilder, isTextInputBuilder, isUserSelectMenuBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
+export type { AnyEmbedData, AnySelectMenuBuilder, ComponentBuildersData, ComponentData, ContainerColor, ContainerComponentBuilder, ContainerData, ContainerInComponentType, CreateComponentData, CreateModalOptions, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData, Unstable_CheckboxData, Unstable_CheckboxGroupData, Unstable_RadioGroupData };

package/dist/index.mjs

@@ -18,7 +18,7 @@ export { createFile } from './functions/components/file.mjs';
 export { createMediaGallery } from './functions/components/gallery.mjs';
 export { createModalInput, createTextInput } from './functions/components/input.mjs';
 export { createLabel } from './functions/components/label.mjs';
-export { createModalFields, modalFieldsToRecord } from './functions/components/modal.mjs';
+export { createModal, createModalFields, modalFieldsToRecord } from './functions/components/modal.mjs';
 export { createRow } from './functions/components/row.mjs';
 export { createSection } from './functions/components/section.mjs';
 export { createSeparator } from './functions/components/separator.mjs';
@@ -39,6 +39,7 @@ export { isModalBuilder } from './guards/components/modal.mjs';
 export { isActionRowBuilder } from './guards/components/row.mjs';
 export { isSectionBuilder } from './guards/components/section.mjs';
 export { isAnySelectMenuBuilder, isChannelSelectMenuBuilder, isMentionableSelectMenuBuilder, isRoleSelectMenuBuilder, isStringSelectMenuBuilder, isUserSelectMenuBuilder } from './guards/components/selectmenu.mjs';
+export { isFileBuilder } from './guards/components/file.mjs';
 export { isSeparatorBuilder } from './guards/components/separator.mjs';
 export { isTextDisplayBuilder } from './guards/components/textdisplay.mjs';
 export { isTextInputBuilder } from './guards/components/textinput.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.6.4",
+  "version": "1.7.1",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",
@@ -39,7 +39,7 @@
     "test": "vitest"
   },
   "peerDependencies": {
-    "discord.js": "^14.24.2"
+    "discord.js": "^14.25.1"
   },
   "devDependencies": {
     "@magicyan/config": "*",