@magicyan/discord 1.7.3 → 1.7.4

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/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

@@ -30,6 +30,8 @@ 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');
@@ -93,6 +95,8 @@ 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, CheckboxComponentData, CheckboxBuilder, CheckboxGroupComponentData, CheckboxGroupBuilder, RadioGroupComponentData, RadioGroupBuilder, 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: {
@@ -620,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>;
@@ -949,6 +949,92 @@ type CreateRadioGroup = Omit<RadioGroupComponentData, "type">;
  */
 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;
@@ -1375,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, 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, 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 { 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 };

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, LabelBuilder, LabelBuilderData, ComponentInLabelData, ModalBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, CheckboxComponentData, CheckboxBuilder, CheckboxGroupComponentData, CheckboxGroupBuilder, RadioGroupComponentData, RadioGroupBuilder, 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: {
@@ -620,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>;
@@ -949,6 +949,92 @@ type CreateRadioGroup = Omit<RadioGroupComponentData, "type">;
  */
 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;
@@ -1375,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, 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, 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 { 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 };

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, LabelBuilder, LabelBuilderData, ComponentInLabelData, ModalBuilder, Collection, ModalData, LabelComponentData, TextDisplayComponentData, AnyComponentBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, FileUploadBuilder, CheckboxComponentData, CheckboxBuilder, CheckboxGroupComponentData, CheckboxGroupBuilder, RadioGroupComponentData, RadioGroupBuilder, 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: {
@@ -620,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>;
@@ -949,6 +949,92 @@ type CreateRadioGroup = Omit<RadioGroupComponentData, "type">;
  */
 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;
@@ -1375,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, 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, 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 { 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 };

package/dist/index.mjs

@@ -28,6 +28,8 @@ export { createThumbnail } from './functions/components/thumbnail.mjs';
 export { createFileUpload } from './functions/components/upload.mjs';
 export { createCheckbox, createCheckboxGroup } from './functions/components/checkbox.mjs';
 export { createRadioGroup } from './functions/components/radio.mjs';
+export { flattenMessageComponents } from './functions/components/flatten.mjs';
+export { findMessageComponentById } from './functions/components/find.mjs';
 export { createEmbedAsset } from './functions/embeds/assets.mjs';
 export { createEmbedAuthor } from './functions/embeds/author.mjs';
 export { EmbedPlusBuilder, createEmbed } from './functions/embeds/embedplus.mjs';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@magicyan/discord",
-  "version": "1.7.3",
+  "version": "1.7.4",
   "description": "Simple functions to facilitate discord bot development",
   "license": "MIT",
   "type": "module",