@magicyan/discord 1.7.2 → 1.7.4

package/dist/functions/components/checkbox.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+const discord_js = require('discord.js');
+
+function createCheckbox(a, b, c) {
+  const builder = new discord_js.CheckboxBuilder();
+  if (typeof a === "string") {
+    Object.assign(builder.data, {
+      custom_id: a,
+      default: b,
+      id: c
+    });
+    return builder;
+  }
+  Object.assign(builder.data, {
+    ...a,
+    custom_id: a.customId
+  });
+  return builder;
+}
+function createCheckboxGroup(data) {
+  const builder = new discord_js.CheckboxGroupBuilder();
+  Object.assign(builder.data, {
+    ...data,
+    custom_id: data.customId,
+    max_values: data.maxValues,
+    min_values: data.minValues
+  });
+  builder.setOptions(...data.options);
+  return builder;
+}
+
+exports.createCheckbox = createCheckbox;
+exports.createCheckboxGroup = createCheckboxGroup;

package/dist/functions/components/checkbox.mjs

@@ -0,0 +1,31 @@
+import { CheckboxBuilder, CheckboxGroupBuilder } from 'discord.js';
+
+function createCheckbox(a, b, c) {
+  const builder = new CheckboxBuilder();
+  if (typeof a === "string") {
+    Object.assign(builder.data, {
+      custom_id: a,
+      default: b,
+      id: c
+    });
+    return builder;
+  }
+  Object.assign(builder.data, {
+    ...a,
+    custom_id: a.customId
+  });
+  return builder;
+}
+function createCheckboxGroup(data) {
+  const builder = new CheckboxGroupBuilder();
+  Object.assign(builder.data, {
+    ...data,
+    custom_id: data.customId,
+    max_values: data.maxValues,
+    min_values: data.minValues
+  });
+  builder.setOptions(...data.options);
+  return builder;
+}
+
+export { createCheckbox, createCheckboxGroup };

package/dist/functions/components/find.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+const flatten = require('./flatten.cjs');
+
+function findMessageComponentById(source, id, type) {
+  const components = flatten.flattenMessageComponents(source);
+  return components.find(
+    (c) => c.id === id && (type === void 0 || c.type === type)
+  ) ?? null;
+}
+
+exports.findMessageComponentById = findMessageComponentById;

package/dist/functions/components/find.mjs

@@ -0,0 +1,10 @@
+import { flattenMessageComponents } from './flatten.mjs';
+
+function findMessageComponentById(source, id, type) {
+  const components = flattenMessageComponents(source);
+  return components.find(
+    (c) => c.id === id && (type === void 0 || c.type === type)
+  ) ?? null;
+}
+
+export { findMessageComponentById };

package/dist/functions/components/flatten.cjs

@@ -0,0 +1,35 @@
+'use strict';
+
+const discord_js = require('discord.js');
+const utils = require('./utils.cjs');
+
+function flattenMessageComponents(source) {
+  const components = utils.resolveComponentsSource(source);
+  const hasNested = components.some(
+    (component) => component.type === discord_js.ComponentType.Container || component.type === discord_js.ComponentType.ActionRow || component.type === discord_js.ComponentType.Section
+  );
+  if (!hasNested)
+    return components;
+  const result = [];
+  function traverse(items) {
+    for (const component of items) {
+      result.push(component);
+      switch (component.type) {
+        case discord_js.ComponentType.Container:
+        case discord_js.ComponentType.ActionRow:
+          traverse(component.components);
+          break;
+        case discord_js.ComponentType.Section:
+          result.push(component.accessory);
+          if (component.components.length) {
+            traverse(component.components);
+          }
+          break;
+      }
+    }
+  }
+  traverse(components);
+  return result;
+}
+
+exports.flattenMessageComponents = flattenMessageComponents;

package/dist/functions/components/flatten.mjs

@@ -0,0 +1,33 @@
+import { ComponentType } from 'discord.js';
+import { resolveComponentsSource } from './utils.mjs';
+
+function flattenMessageComponents(source) {
+  const components = resolveComponentsSource(source);
+  const hasNested = components.some(
+    (component) => component.type === ComponentType.Container || component.type === ComponentType.ActionRow || component.type === ComponentType.Section
+  );
+  if (!hasNested)
+    return components;
+  const result = [];
+  function traverse(items) {
+    for (const component of items) {
+      result.push(component);
+      switch (component.type) {
+        case ComponentType.Container:
+        case ComponentType.ActionRow:
+          traverse(component.components);
+          break;
+        case ComponentType.Section:
+          result.push(component.accessory);
+          if (component.components.length) {
+            traverse(component.components);
+          }
+          break;
+      }
+    }
+  }
+  traverse(components);
+  return result;
+}
+
+export { flattenMessageComponents };

package/dist/functions/components/modal.cjs

@@ -15,6 +15,18 @@ function modalFieldsToRecord(data, parse) {
       acc[data2.customId] = Array.from(attachments?.values() ?? []).map((data3) => data3.url);
       return acc;
     }
+    if (data2.type === discord_js.ComponentType.CheckboxGroup) {
+      acc[data2.customId] = Array.from(data2.values);
+      return acc;
+    }
+    if (data2.type === discord_js.ComponentType.Checkbox) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
+    if (data2.type === discord_js.ComponentType.RadioGroup) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
     acc[data2.customId] = Array.from(data2.values ?? []);
     return acc;
   }, {});

package/dist/functions/components/modal.mjs

@@ -13,6 +13,18 @@ function modalFieldsToRecord(data, parse) {
       acc[data2.customId] = Array.from(attachments?.values() ?? []).map((data3) => data3.url);
       return acc;
     }
+    if (data2.type === ComponentType.CheckboxGroup) {
+      acc[data2.customId] = Array.from(data2.values);
+      return acc;
+    }
+    if (data2.type === ComponentType.Checkbox) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
+    if (data2.type === ComponentType.RadioGroup) {
+      acc[data2.customId] = data2.value;
+      return acc;
+    }
     acc[data2.customId] = Array.from(data2.values ?? []);
     return acc;
   }, {});

package/dist/functions/components/radio.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const discord_js = require('discord.js');
+
+function createRadioGroup(data) {
+  const builder = new discord_js.RadioGroupBuilder();
+  Object.assign(builder.data, {
+    ...data,
+    custom_id: data.customId
+  });
+  builder.setOptions(...data.options);
+  return builder;
+}
+
+exports.createRadioGroup = createRadioGroup;

package/dist/functions/components/radio.mjs

@@ -0,0 +1,13 @@
+import { RadioGroupBuilder } from 'discord.js';
+
+function createRadioGroup(data) {
+  const builder = new RadioGroupBuilder();
+  Object.assign(builder.data, {
+    ...data,
+    custom_id: data.customId
+  });
+  builder.setOptions(...data.options);
+  return builder;
+}
+
+export { createRadioGroup };

package/dist/functions/components/thumbnail.cjs

@@ -2,14 +2,21 @@
 
 const discord_js = require('discord.js');
 
-function createThumbnail(data) {
-  const thumbnail = new discord_js.ThumbnailBuilder();
+function createThumbnail(data, id) {
   if (typeof data === "string") {
-    return thumbnail.setURL(data);
+    return new discord_js.ThumbnailBuilder({
+      id,
+      media: { url: data }
+    });
   }
   if (data instanceof discord_js.AttachmentBuilder || data instanceof discord_js.Attachment) {
-    return thumbnail.setURL(`attachment://${data.name}`).setSpoiler(data.spoiler);
+    return new discord_js.ThumbnailBuilder({
+      media: { url: `attachment://${data.name}` },
+      spoiler: data.spoiler,
+      id
+    });
   }
+  data.id ?? (data.id = id);
   return new discord_js.ThumbnailBuilder(data);
 }
 

package/dist/functions/components/thumbnail.mjs

@@ -1,13 +1,20 @@
 import { ThumbnailBuilder, AttachmentBuilder, Attachment } from 'discord.js';
 
-function createThumbnail(data) {
-  const thumbnail = new ThumbnailBuilder();
+function createThumbnail(data, id) {
   if (typeof data === "string") {
-    return thumbnail.setURL(data);
+    return new ThumbnailBuilder({
+      id,
+      media: { url: data }
+    });
   }
   if (data instanceof AttachmentBuilder || data instanceof Attachment) {
-    return thumbnail.setURL(`attachment://${data.name}`).setSpoiler(data.spoiler);
+    return new ThumbnailBuilder({
+      media: { url: `attachment://${data.name}` },
+      spoiler: data.spoiler,
+      id
+    });
   }
+  data.id ?? (data.id = id);
   return new ThumbnailBuilder(data);
 }
 

package/dist/functions/components/utils.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function resolveComponentsSource(source) {
+  return Array.isArray(source) ? source : "message" in source ? source.message.components : source.components;
+}
+
+exports.resolveComponentsSource = resolveComponentsSource;

package/dist/functions/components/utils.mjs

@@ -0,0 +1,5 @@
+function resolveComponentsSource(source) {
+  return Array.isArray(source) ? source : "message" in source ? source.message.components : source.components;
+}
+
+export { resolveComponentsSource };

package/dist/index.cjs

@@ -28,6 +28,10 @@ const text = require('./functions/components/text.cjs');
 const thumbarea = require('./functions/components/thumbarea.cjs');
 const thumbnail = require('./functions/components/thumbnail.cjs');
 const upload = require('./functions/components/upload.cjs');
+const checkbox = require('./functions/components/checkbox.cjs');
+const radio = require('./functions/components/radio.cjs');
+const flatten = require('./functions/components/flatten.cjs');
+const find = require('./functions/components/find.cjs');
 const assets = require('./functions/embeds/assets.cjs');
 const author = require('./functions/embeds/author.cjs');
 const embedplus = require('./functions/embeds/embedplus.cjs');
@@ -88,6 +92,11 @@ exports.createTextDisplay = text.createTextDisplay;
 exports.createThumbArea = thumbarea.createThumbArea;
 exports.createThumbnail = thumbnail.createThumbnail;
 exports.createFileUpload = upload.createFileUpload;
+exports.createCheckbox = checkbox.createCheckbox;
+exports.createCheckboxGroup = checkbox.createCheckboxGroup;
+exports.createRadioGroup = radio.createRadioGroup;
+exports.flattenMessageComponents = flatten.flattenMessageComponents;
+exports.findMessageComponentById = find.findMessageComponentById;
 exports.createEmbedAsset = assets.createEmbedAsset;
 exports.createEmbedAuthor = author.createEmbedAuthor;
 exports.EmbedPlusBuilder = embedplus.EmbedPlusBuilder;

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, 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';
+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, CheckboxComponentData, CheckboxBuilder, CheckboxGroupComponentData, CheckboxGroupBuilder, RadioGroupComponentData, RadioGroupBuilder, TopLevelComponent, MessageActionRowComponent, ThumbnailComponent, MediaGalleryComponent, ButtonComponent, StringSelectMenuComponent, UserSelectMenuComponent, RoleSelectMenuComponent, MentionableSelectMenuComponent, ChannelSelectMenuComponent, SectionComponent, SeparatorComponent, FileComponent, TextDisplayComponent, 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: {
@@ -433,45 +433,70 @@ declare function createModalInput(data: Omit<TextInputComponentData, "type" | "s
     style?: TextInputStyle;
 }): ActionRowBuilder<TextInputBuilder>;
 
-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;
+    component?: LabelBuilderData["component"] | ComponentInLabelData;
 }
+/**
+ * Creates a label component using an object configuration.
+ *
+ * This overload is useful when you already have your label data
+ * structured in an object. Each field maps directly to the
+ * {@link LabelBuilderData} properties (except `type`).
+ *
+ * The `component` field can be either raw data or a JSON-encodable builder.
+ *
+ * @param data - The configuration object containing label properties.
+ * @returns A new {@link LabelBuilder} instance configured with the provided data.
+ *
+ * @example
+ * ```ts
+ * const label = createLabel({
+ *   label: "Username",
+ *   description: "Enter your username",
+ *   component: textInput
+ * });
+ * ```
+ */
 declare function createLabel(data: CreateLabelData): LabelBuilder;
+/**
+ * Creates a label component with label, description and optional component.
+ *
+ * Use this overload when you want to explicitly define the label text,
+ * description and optionally attach a component.
+ *
+ * @param label - The main label text.
+ * @param description - Additional descriptive text for the label.
+ * @param component - Optional component associated with the label.
+ * @param id - Optional numeric identifier for the component.
+ * @returns A new {@link LabelBuilder} instance configured with the provided values.
+ *
+ * @example
+ * ```ts
+ * const label = createLabel(
+ *   "Username",
+ *   "Enter your username",
+ *   textInput,
+ *   1
+ * );
+ * ```
+ */
 declare function createLabel(label: string, description?: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
+/**
+ * Creates a label component with a label and optional component.
+ *
+ * Use this overload when you don't need a description and want
+ * a simpler way to attach a component.
+ *
+ * @param label - The main label text.
+ * @param component - Optional component associated with the label.
+ * @param id - Optional numeric identifier for the component.
+ * @returns A new {@link LabelBuilder} instance configured with the provided values.
+ *
+ * @example
+ * ```ts
+ * const label = createLabel("Username", textInput, 1);
+ * ```
+ */
 declare function createLabel(label: string, component?: CreateLabelData["component"], id?: number): LabelBuilder;
 
 type ModalComponents = LabelBuilder | TextDisplayBuilder | string | null | boolean | undefined;
@@ -482,7 +507,7 @@ type ResolveModalData = {
 } | {
     fields: Collection<string, ModalData>;
 } | Collection<string, ModalData>;
-type ModalFieldsRecord = Record<string, string | string[]>;
+type ModalFieldsRecord = Record<string, string | string[] | boolean | null>;
 /**
  * Converts modal submitted fields into a plain record object, mapping each component `customId` to its value.
  *
@@ -595,7 +620,7 @@ type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment
  *   spoiler: true
  * });
  */
-declare function createThumbnail(data: ThumbnailData): ThumbnailBuilder;
+declare function createThumbnail(data: ThumbnailData, id?: number): ThumbnailBuilder;
 
 type SectionThumbnailAccessory = ThumbnailBuilder | ThumbnailData;
 type SectionButtonAccessory = ButtonBuilder | Partial<ButtonComponentData>;
@@ -836,6 +861,180 @@ declare function createFileUpload(customId: string, required?: boolean, maxValue
  */
 declare function createFileUpload(customId: string, maxValues?: number, minValues?: number): FileUploadBuilder;
 
+type CreateCheckboxData = Omit<CheckboxComponentData, "type">;
+/**
+ * Creates a checkbox component using an object configuration.
+ *
+ * This overload is useful when you already have your checkbox data
+ * structured in an object. Each field maps directly to the
+ * {@link CheckboxComponentData} properties (except `type`).
+ *
+ * @param data - The configuration object containing checkbox properties.
+ * @returns A new {@link CheckboxBuilder} instance configured with the provided data.
+ *
+ * @example
+ * ```ts
+ * const checkbox = createCheckbox({
+ *   customId: "accept_terms",
+ *   default: true
+ * });
+ * ```
+ */
+declare function createCheckbox(data: CreateCheckboxData): CheckboxBuilder;
+/**
+ * Creates a checkbox component using explicit parameters.
+ *
+ * Use this overload when you want a simpler and more direct way
+ * to define the checkbox without creating an object.
+ *
+ * @param customId - The custom identifier for the checkbox component.
+ * @param defaultValue - Whether the checkbox should be checked by default.
+ * @param id - Optional numeric identifier for the component.
+ * @returns A new {@link CheckboxBuilder} instance configured with the provided values.
+ *
+ * @example
+ * ```ts
+ * const checkbox = createCheckbox("accept_terms", true, 1);
+ * ```
+ */
+declare function createCheckbox(customId: string, defaultValue?: boolean, id?: number): CheckboxBuilder;
+type CreateCheckboxGroupData = Omit<CheckboxGroupComponentData, "type">;
+/**
+ * Creates a checkbox group component using an object configuration.
+ *
+ * This function is used to group multiple checkboxes together.
+ * Each field corresponds to the {@link CheckboxGroupComponentData} properties
+ * (except `type`), and the options are automatically applied.
+ *
+ * @param data - The configuration object containing the group settings and options.
+ * @returns A new {@link CheckboxGroupBuilder} instance configured with the provided data.
+ *
+ * @example
+ * ```ts
+ * const group = createCheckboxGroup({
+ *   customId: "preferences",
+ *   minValues: 1,
+ *   maxValues: 3,
+ *   options: [
+ *     { label: "Option A", value: "a" },
+ *     { label: "Option B", value: "b" }
+ *   ]
+ * });
+ * ```
+ */
+declare function createCheckboxGroup(data: CreateCheckboxGroupData): CheckboxGroupBuilder;
+
+type CreateRadioGroup = Omit<RadioGroupComponentData, "type">;
+/**
+ * Creates a radio group component using an object configuration.
+ *
+ * This function is used to define a group of mutually exclusive options,
+ * where only one option can be selected at a time.
+ * Each field maps directly to the {@link RadioGroupComponentData} properties
+ * (except `type`), and the options are automatically applied.
+ *
+ * @param data - The configuration object containing the group settings and options.
+ * @returns A new {@link RadioGroupBuilder} instance configured with the provided data.
+ *
+ * @example
+ * ```ts
+ * const group = createRadioGroup({
+ *   customId: "plan",
+ *   options: [
+ *     { label: "Free", value: "free" },
+ *     { label: "Pro", value: "pro" }
+ *   ]
+ * });
+ * ```
+ */
+declare function createRadioGroup(data: CreateRadioGroup): RadioGroupBuilder;
+
+type MessageComponentWithId = TopLevelComponent | MessageActionRowComponent | ThumbnailComponent | MediaGalleryComponent;
+type MessageComponentSource = MessageComponentWithId[] | {
+    components: MessageComponentWithId[];
+} | {
+    message: {
+        components: MessageComponentWithId[];
+    };
+};
+
+/**
+ * Recursively traverses a message component tree and returns a flat array
+ * containing all components found in the structure.
+ *
+ * Supports component sources as a direct component array, an object with
+ * a `components` property, or an object containing `message.components`.
+ *
+ * Nested components inside containers and action rows are traversed
+ * recursively. For section components, the accessory component and any
+ * nested components are also included in the result.
+ *
+ * @param source The source containing the message components to flatten.
+ * @returns A flat array containing all components found in traversal order.
+ */
+declare function flattenMessageComponents(source: MessageComponentSource): MessageComponentWithId[];
+
+/**
+ * Finds a component by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number): MessageComponentWithId | null;
+/**
+ * Finds a {@link ButtonComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.Button): ButtonComponent | null;
+/**
+ * Finds a {@link StringSelectMenuComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.StringSelect): StringSelectMenuComponent | null;
+/**
+ * Finds a {@link UserSelectMenuComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.UserSelect): UserSelectMenuComponent | null;
+/**
+ * Finds a {@link RoleSelectMenuComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.RoleSelect): RoleSelectMenuComponent | null;
+/**
+ * Finds a {@link MentionableSelectMenuComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.MentionableSelect): MentionableSelectMenuComponent | null;
+/**
+ * Finds a {@link ChannelSelectMenuComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.ChannelSelect): ChannelSelectMenuComponent | null;
+/**
+ * Finds a {@link ContainerComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.Container): ContainerComponent | null;
+/**
+ * Finds a {@link SectionComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.Section): SectionComponent | null;
+/**
+ * Finds a {@link MediaGalleryComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.MediaGallery): MediaGalleryComponent | null;
+/**
+ * Finds a {@link ThumbnailComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.Thumbnail): ThumbnailComponent | null;
+/**
+ * Finds a {@link SeparatorComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.Separator): SeparatorComponent | null;
+/**
+ * Finds a {@link FileComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.File): FileComponent | null;
+/**
+ * Finds a {@link TextDisplayComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.TextDisplay): TextDisplayComponent | null;
+/**
+ * Finds a {@link MessageActionRowComponent} by its identifier.
+ */
+declare function findMessageComponentById(source: MessageComponentSource, id: number, type: ComponentType.ActionRow): MessageActionRowComponent | null;
+
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
 type EmbedAssetOptions = Omit<EmbedAssetData, "url">;
 declare function createEmbedAsset(source: EmbedPlusAssetData, options?: EmbedAssetOptions): EmbedAssetData | undefined;
@@ -1262,5 +1461,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, 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 };
+export { ContainerPlusBuilder, CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createCheckbox, createCheckboxGroup, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createFileUpload, createLabel, createLinkButton, createMediaGallery, createModal, createModalFields, createModalInput, createRadioGroup, createRow, createSection, createSeparator, createTextDisplay, createTextInput, createThumbArea, createThumbnail, createWebhookClient, extractMentionId, fetchMessageFromURL, findChannel, findCommand, findEmoji, findMember, findMessage, findMessageComponentById, findRole, flattenMessageComponents, 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, CreateCheckboxData, CreateCheckboxGroupData, CreateComponentData, CreateModalOptions, CreateRadioGroup, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, FileUploadData, MagicComponentData, MediaGallerySource, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbAreaData, ThumbAreaThumbnail, ThumbnailData };