@magicyan/discord 1.6.3 → 1.7.0

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/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');
@@ -106,6 +107,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

@@ -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.
@@ -1084,7 +1095,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 +1116,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 +1217,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 { 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, isFileBuilder, 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 };

package/dist/index.d.mts

@@ -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.
@@ -1084,7 +1095,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 +1116,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 +1217,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 { 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, isFileBuilder, 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 };

package/dist/index.d.ts

@@ -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.
@@ -1084,7 +1095,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 +1116,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 +1217,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 { 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, isFileBuilder, 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 };

package/dist/index.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.3",
+  "version": "1.7.0",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",
@@ -49,6 +49,6 @@
     "vitest": "^2.1.9"
   },
   "dependencies": {
-    "@magicyan/core": "^1.1.5"
+    "@magicyan/core": "^1.2.0"
   }
 }