@magicyan/discord 1.4.5 → 1.4.7

package/dist/constants/separator.cjs

@@ -0,0 +1,28 @@
+'use strict';
+
+const separator = require('../functions/components/separator.cjs');
+
+const Separator = {
+  /**
+   * Default separator with small spacing and visible divider.
+   * Equivalent to: `createSeparator()`
+   */
+  Default: separator.createSeparator(),
+  /**
+   * Separator with large spacing and visible divider.
+   * Equivalent to: `createSeparator(true)`
+   */
+  Large: separator.createSeparator(true),
+  /**
+   * Separator with large spacing and no visible divider.
+   * Equivalent to: `createSeparator(true, false)`
+   */
+  LargeHidden: separator.createSeparator(true, false),
+  /**
+   * Separator with small spacing and no visible divider.
+   * Equivalent to: `createSeparator(false, false)`
+   */
+  Hidden: separator.createSeparator(false, false)
+};
+
+exports.Separator = Separator;

package/dist/constants/separator.mjs

@@ -0,0 +1,26 @@
+import { createSeparator } from '../functions/components/separator.mjs';
+
+const Separator = {
+  /**
+   * Default separator with small spacing and visible divider.
+   * Equivalent to: `createSeparator()`
+   */
+  Default: createSeparator(),
+  /**
+   * Separator with large spacing and visible divider.
+   * Equivalent to: `createSeparator(true)`
+   */
+  Large: createSeparator(true),
+  /**
+   * Separator with large spacing and no visible divider.
+   * Equivalent to: `createSeparator(true, false)`
+   */
+  LargeHidden: createSeparator(true, false),
+  /**
+   * Separator with small spacing and no visible divider.
+   * Equivalent to: `createSeparator(false, false)`
+   */
+  Hidden: createSeparator(false, false)
+};
+
+export { Separator };

package/dist/functions/components/buttons.cjs

@@ -1,10 +1,22 @@
 'use strict';
 
 const discord_js = require('discord.js');
+const row = require('./row.cjs');
 
 function createLinkButton(data) {
   data.label ?? (data.label = data.url);
   return new discord_js.ButtonBuilder({ style: discord_js.ButtonStyle.Link, ...data });
 }
+function wrapButtons(maxItemsPerRow, ...buttons) {
+  const items = buttons.flat();
+  const result = [];
+  for (let index = 0; index < items.length; index += maxItemsPerRow) {
+    result.push(row.createRow(
+      items.slice(index, index + maxItemsPerRow)
+    ));
+  }
+  return result;
+}
 
 exports.createLinkButton = createLinkButton;
+exports.wrapButtons = wrapButtons;

package/dist/functions/components/buttons.mjs

@@ -1,8 +1,19 @@
 import { ButtonBuilder, ButtonStyle } from 'discord.js';
+import { createRow } from './row.mjs';
 
 function createLinkButton(data) {
   data.label ?? (data.label = data.url);
   return new ButtonBuilder({ style: ButtonStyle.Link, ...data });
 }
+function wrapButtons(maxItemsPerRow, ...buttons) {
+  const items = buttons.flat();
+  const result = [];
+  for (let index = 0; index < items.length; index += maxItemsPerRow) {
+    result.push(createRow(
+      items.slice(index, index + maxItemsPerRow)
+    ));
+  }
+  return result;
+}
 
-export { createLinkButton };
+export { createLinkButton, wrapButtons };

package/dist/functions/components/components.cjs

@@ -8,7 +8,7 @@ const row = require('./row.cjs');
 const text = require('./text.cjs');
 
 function createComponents(...data) {
-  return data.filter((value) => value !== null && value !== void 0).map((component) => {
+  return data.flat().filter((value) => value !== null && value !== void 0).map((component) => {
     if (typeof component === "string") {
       return text.createTextDisplay(component);
     }

package/dist/functions/components/components.mjs

@@ -6,7 +6,7 @@ import { createRow } from './row.mjs';
 import { createTextDisplay } from './text.mjs';
 
 function createComponents(...data) {
-  return data.filter((value) => value !== null && value !== void 0).map((component) => {
+  return data.flat().filter((value) => value !== null && value !== void 0).map((component) => {
     if (typeof component === "string") {
       return createTextDisplay(component);
     }

package/dist/functions/components/container.cjs

@@ -7,7 +7,7 @@ const gallery = require('./gallery.cjs');
 const row = require('./row.cjs');
 const text = require('./text.cjs');
 
-function createContainer(data, ...components) {
+function createContainer(data, ...items) {
   const container = new discord_js.ContainerBuilder();
   const addComponent = (component) => {
     if (!component)
@@ -62,12 +62,16 @@ function createContainer(data, ...components) {
   if (isContainerData(data)) {
     if (data.accentColor)
       setColor(data.accentColor);
+    if (data.spoiler !== void 0)
+      container.setSpoiler(data.spoiler);
+    if (data.id !== void 0)
+      container.setId(data.id);
     for (const component of data.components)
       addComponent(component);
     return container;
   }
   setColor(data);
-  for (const component of components)
+  for (const component of items.flat())
     addComponent(component);
   return container;
 }

package/dist/functions/components/container.mjs

@@ -5,7 +5,7 @@ import { createMediaGallery } from './gallery.mjs';
 import { createRow } from './row.mjs';
 import { createTextDisplay } from './text.mjs';
 
-function createContainer(data, ...components) {
+function createContainer(data, ...items) {
   const container = new ContainerBuilder();
   const addComponent = (component) => {
     if (!component)
@@ -60,12 +60,16 @@ function createContainer(data, ...components) {
   if (isContainerData(data)) {
     if (data.accentColor)
       setColor(data.accentColor);
+    if (data.spoiler !== void 0)
+      container.setSpoiler(data.spoiler);
+    if (data.id !== void 0)
+      container.setId(data.id);
     for (const component of data.components)
       addComponent(component);
     return container;
   }
   setColor(data);
-  for (const component of components)
+  for (const component of items.flat())
     addComponent(component);
   return container;
 }

package/dist/functions/components/row.cjs

@@ -3,7 +3,9 @@
 const discord_js = require('discord.js');
 
 function createRow(...components) {
-  return new discord_js.ActionRowBuilder({ components });
+  return new discord_js.ActionRowBuilder({
+    components: components.flat()
+  });
 }
 
 exports.createRow = createRow;

package/dist/functions/components/row.mjs

@@ -1,7 +1,9 @@
 import { ActionRowBuilder } from 'discord.js';
 
 function createRow(...components) {
-  return new ActionRowBuilder({ components });
+  return new ActionRowBuilder({
+    components: components.flat()
+  });
 }
 
 export { createRow };

package/dist/functions/components/section.cjs

@@ -4,7 +4,7 @@ const discord_js = require('discord.js');
 const text = require('./text.cjs');
 const thumbnail = require('./thumbnail.cjs');
 
-function createSection(data) {
+function createSection(argA, argB) {
   const section = new discord_js.SectionBuilder();
   function setAccessory(data2) {
     if (data2 instanceof discord_js.ButtonBuilder) {
@@ -14,19 +14,14 @@ function createSection(data) {
       return section.setThumbnailAccessory(data2);
     }
     if (typeof data2 === "string") {
-      return section.setThumbnailAccessory(
-        thumbnail.createThumbnail(data2)
-      );
+      return section.setThumbnailAccessory(thumbnail.createThumbnail(data2));
     }
     if ("media" in data2 || "description" in data2) {
-      return section.setThumbnailAccessory(
-        thumbnail.createThumbnail(data2)
-      );
+      return section.setThumbnailAccessory(thumbnail.createThumbnail(data2));
     }
-    return section.setButtonAccessory(
-      new discord_js.ButtonBuilder(data2)
-    );
+    return section.setButtonAccessory(new discord_js.ButtonBuilder(data2));
   }
+  const data = typeof argA === "string" ? { content: argA, accessory: argB } : argA;
   if (data.accessory || data.button || data.thumbnail) {
     setAccessory(data.accessory ?? data.button ?? data.thumbnail);
   }
@@ -35,9 +30,7 @@ function createSection(data) {
       data.content.map((text$1) => text.createTextDisplay(text$1))
     );
   } else {
-    section.addTextDisplayComponents(
-      text.createTextDisplay(data.content)
-    );
+    section.addTextDisplayComponents(text.createTextDisplay(data.content));
   }
   return section;
 }

package/dist/functions/components/section.mjs

@@ -2,7 +2,7 @@ import { SectionBuilder, ButtonBuilder, ThumbnailBuilder } from 'discord.js';
 import { createTextDisplay } from './text.mjs';
 import { createThumbnail } from './thumbnail.mjs';
 
-function createSection(data) {
+function createSection(argA, argB) {
   const section = new SectionBuilder();
   function setAccessory(data2) {
     if (data2 instanceof ButtonBuilder) {
@@ -12,19 +12,14 @@ function createSection(data) {
       return section.setThumbnailAccessory(data2);
     }
     if (typeof data2 === "string") {
-      return section.setThumbnailAccessory(
-        createThumbnail(data2)
-      );
+      return section.setThumbnailAccessory(createThumbnail(data2));
     }
     if ("media" in data2 || "description" in data2) {
-      return section.setThumbnailAccessory(
-        createThumbnail(data2)
-      );
+      return section.setThumbnailAccessory(createThumbnail(data2));
     }
-    return section.setButtonAccessory(
-      new ButtonBuilder(data2)
-    );
+    return section.setButtonAccessory(new ButtonBuilder(data2));
   }
+  const data = typeof argA === "string" ? { content: argA, accessory: argB } : argA;
   if (data.accessory || data.button || data.thumbnail) {
     setAccessory(data.accessory ?? data.button ?? data.thumbnail);
   }
@@ -33,9 +28,7 @@ function createSection(data) {
       data.content.map((text) => createTextDisplay(text))
     );
   } else {
-    section.addTextDisplayComponents(
-      createTextDisplay(data.content)
-    );
+    section.addTextDisplayComponents(createTextDisplay(data.content));
   }
   return section;
 }

package/dist/functions/components/separator.cjs

@@ -2,10 +2,11 @@
 
 const discord_js = require('discord.js');
 
-function createSeparator(data = {}) {
+function createSeparator(argA, argB) {
+  const [large, divider] = typeof argA === "object" ? [argA.large, argA.divider] : [argA, argB];
   return new discord_js.SeparatorBuilder({
-    divider: data.divider,
-    spacing: data.large ? discord_js.SeparatorSpacingSize.Large : discord_js.SeparatorSpacingSize.Small
+    divider,
+    spacing: large ? discord_js.SeparatorSpacingSize.Large : discord_js.SeparatorSpacingSize.Small
   });
 }
 

package/dist/functions/components/separator.mjs

@@ -1,9 +1,10 @@
 import { SeparatorBuilder, SeparatorSpacingSize } from 'discord.js';
 
-function createSeparator(data = {}) {
+function createSeparator(argA, argB) {
+  const [large, divider] = typeof argA === "object" ? [argA.large, argA.divider] : [argA, argB];
   return new SeparatorBuilder({
-    divider: data.divider,
-    spacing: data.large ? SeparatorSpacingSize.Large : SeparatorSpacingSize.Small
+    divider,
+    spacing: large ? SeparatorSpacingSize.Large : SeparatorSpacingSize.Small
   });
 }
 

package/dist/index.cjs

@@ -3,6 +3,7 @@
 const chars = require('./constants/chars.cjs');
 const client = require('./constants/client.cjs');
 const embed = require('./constants/embed.cjs');
+const separator = require('./constants/separator.cjs');
 const misc = require('./functions/misc.cjs');
 const assets = require('./functions/embeds/assets.cjs');
 const author = require('./functions/embeds/author.cjs');
@@ -13,7 +14,7 @@ const buttons = require('./functions/components/buttons.cjs');
 const row = require('./functions/components/row.cjs');
 const file = require('./functions/components/file.cjs');
 const gallery = require('./functions/components/gallery.cjs');
-const separator = require('./functions/components/separator.cjs');
+const separator$1 = require('./functions/components/separator.cjs');
 const section = require('./functions/components/section.cjs');
 const text = require('./functions/components/text.cjs');
 const thumbnail = require('./functions/components/thumbnail.cjs');
@@ -39,6 +40,7 @@ exports.chars = chars.chars;
 exports.CustomItents = client.CustomItents;
 exports.CustomPartials = client.CustomPartials;
 exports.EmbedLimit = embed.EmbedLimit;
+exports.Separator = separator.Separator;
 exports.setMobileStatus = misc.setMobileStatus;
 exports.createEmbedAsset = assets.createEmbedAsset;
 exports.createEmbedAuthor = author.createEmbedAuthor;
@@ -47,10 +49,11 @@ exports.createEmbed = embedplus.createEmbed;
 exports.createEmbedFooter = footer.createEmbedFooter;
 exports.createEmbedFiles = files.createEmbedFiles;
 exports.createLinkButton = buttons.createLinkButton;
+exports.wrapButtons = buttons.wrapButtons;
 exports.createRow = row.createRow;
 exports.createFile = file.createFile;
 exports.createMediaGallery = gallery.createMediaGallery;
-exports.createSeparator = separator.createSeparator;
+exports.createSeparator = separator$1.createSeparator;
 exports.createSection = section.createSection;
 exports.createTextDisplay = text.createTextDisplay;
 exports.createThumbnail = thumbnail.createThumbnail;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, LinkButtonComponentData, AnyComponentBuilder, ActionRowBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, AnyComponentBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -31,6 +31,32 @@ declare enum EmbedLimit {
     URL = 2048
 }
 
+/**
+ * Predefined separator spacing variants for quick use.
+ */
+declare const Separator: {
+    /**
+     * Default separator with small spacing and visible divider.
+     * Equivalent to: `createSeparator()`
+     */
+    readonly Default: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and visible divider.
+     * Equivalent to: `createSeparator(true)`
+     */
+    readonly Large: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and no visible divider.
+     * Equivalent to: `createSeparator(true, false)`
+     */
+    readonly LargeHidden: discord_js.SeparatorBuilder;
+    /**
+     * Separator with small spacing and no visible divider.
+     * Equivalent to: `createSeparator(false, false)`
+     */
+    readonly Hidden: discord_js.SeparatorBuilder;
+};
+
 declare function setMobileStatus(): void;
 
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
@@ -182,8 +208,65 @@ declare function createEmbedFiles(embed: EmbedBuilder, options?: CreateEmbedFile
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
+/**
+ * Wraps buttons into multiple {@link ActionRowBuilder} instances with a maximum number of buttons per row.
+ *
+ * This function takes a list of {@link ButtonBuilder} instances (or arrays of them) and groups them into
+ * multiple `ActionRowBuilder<ButtonBuilder>` objects, ensuring that each row contains no more than the specified
+ * number of buttons.
+ *
+ * @param maxItemsPerRow - The maximum number of buttons to include in each row.
+ * @param buttons - A variadic list of {@link ButtonBuilder} instances or arrays of them to be wrapped.
+ *
+ * @returns An array of {@link ActionRowBuilder} instances, each containing up to `maxItemsPerRow` buttons.
+ *
+ * @example
+ * const button1 = new ButtonBuilder().setLabel("A").setCustomId("a").setStyle(ButtonStyle.Primary);
+ * const button2 = new ButtonBuilder().setLabel("B").setCustomId("b").setStyle(ButtonStyle.Primary);
+ * const button3 = new ButtonBuilder().setLabel("C").setCustomId("c").setStyle(ButtonStyle.Primary);
+ *
+ * const rows = wrapButtons(2, button1, button2, button3);
+ * // Result: Two rows, the first with [button1, button2], the second with [button3]
+ */
+declare function wrapButtons(maxItemsPerRow: number, ...buttons: (ButtonBuilder | ButtonBuilder[])[]): ActionRowBuilder<ButtonBuilder>[];
 
-declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
+/**
+ * Creates an {@link ActionRowBuilder} containing one or more UI components.
+ *
+ * This function accepts individual components or arrays of components, flattens them,
+ * and returns an action row builder suitable for use in Discord messages.
+ * It's designed to support any component builder type that extends {@link AnyComponentBuilder}.
+ *
+ * ---
+ * While this function supports any valid message component (such as buttons, select menus, etc.),
+ * the examples below demonstrate common use cases using {@link ButtonBuilder} and {@link StringSelectMenuBuilder}.
+ *
+ * @typeParam Component - A type extending {@link AnyComponentBuilder}, such as a button or select menu builder.
+ *
+ * @param components - A variadic list of component instances or arrays of component instances to include in the row.
+ *
+ * @returns An {@link ActionRowBuilder} instance containing all provided components.
+ *
+ * @example
+ * // Create a row with two buttons
+ * const row = createRow(
+ *   new ButtonBuilder().setCustomId("yes").setLabel("Yes").setStyle(ButtonStyle.Success),
+ *   new ButtonBuilder().setCustomId("no").setLabel("No").setStyle(ButtonStyle.Danger)
+ * );
+ *
+ * @example
+ * // Create a row with a string select menu
+ * const row = createRow([
+ *   new StringSelectMenuBuilder()
+ *     .setCustomId("choose")
+ *     .setPlaceholder("Make a selection")
+ *     .addOptions(
+ *       { label: "Option 1", value: "opt1" },
+ *       { label: "Option 2", value: "opt2" }
+ *     )
+ * ]);
+ */
+declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
 
 type FileSource = string | Attachment | AttachmentBuilder;
 interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
@@ -266,32 +349,42 @@ interface SeparatorData {
     large?: boolean;
 }
 /**
- * Creates a {@link SeparatorBuilder} component with customizable options for visibility and spacing.
+ * Creates a {@link SeparatorBuilder} component with configurable visibility and spacing.
  *
- * This function generates a separator that can be configured to either be visible or disabled,
- * and can have either small or large spacing between components. The default settings are for a
- * visible separator with small spacing.
+ * This function generates a separator component that can be customized for:
+ * - Visibility (`divider`: whether the visual divider line is shown).
+ * - Spacing (`large`: whether to use large or small spacing).
  *
- * **Parameters:**
- * - `divider` (optional): If `false`, the separator divider will be disabled and won't be rendered. Default is `true`.
- * - `large` (optional): If `true`, the separator will have a large spacing. Default is `false` (small spacing).
+ * It accepts parameters in two formats:
  *
- * @param data - An object containing the optional properties `divider` and `large` to configure the separator.
+ * **1. As an object:**
+ * @param data - An optional object with the following properties:
+ * - `divider` (boolean, optional): Whether the divider is visible. Defaults to `true`.
+ * - `large` (boolean, optional): Whether to use large spacing. Defaults to `false`.
+ *
+ * **2. As positional arguments:**
+ * @param large - Whether to use large spacing. Defaults to `false`.
+ * @param divider - Whether the divider is visible. Defaults to `true`.
  *
  * @returns A {@link SeparatorBuilder} instance with the specified configuration.
  *
  * @example
- * // Creating a separator with default settings (visible and small spacing)
+ * // Using object syntax with default options
  * const separator = createSeparator();
  *
  * @example
- * // Creating a disabled separator divider (not visible)
- * const separator = createSeparator({ divider: false });
+ * // Using object syntax to disable the divider and enable large spacing
+ * const separator = createSeparator({ divider: false, large: true });
+ *
+ * @example
+ * // Using positional arguments: large spacing, visible divider
+ * const separator = createSeparator(true, true);
  *
  * @example
- * // Creating a separator with large spacing
- * const separator = createSeparator({ large: true });
+ * // Using positional arguments: small spacing, hidden divider
+ * const separator = createSeparator(false, false);
  */
+declare function createSeparator(large?: boolean, divider?: boolean): SeparatorBuilder;
 declare function createSeparator(data?: SeparatorData): SeparatorBuilder;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
@@ -342,46 +435,53 @@ type SectionData = SectionAccessoryData & {
     content: string | string[];
 };
 /**
- * Creates a {@link SectionBuilder} component with customizable content, thumbnail, and optional button.
+ * Creates a {@link SectionBuilder} component with customizable text content and a single visual accessory.
  *
- * This function generates a section that can either have a button, a thumbnail, or both as accessories,
- * along with the provided content. The content can be a single string or an array of strings.
- * If both a button and a thumbnail are provided, only one can be set, as specified in the types.
+ * This function allows you to generate a section with content (as a string or an array of strings)
+ * and optionally include a single accessory, which can be a button or a thumbnail.
+ * You can provide the accessory in multiple forms: a builder instance, a plain data object, or a URL string (for thumbnails).
  *
- * **Parameters:**
- * - `content`: The main content of the section. This can either be a single string or an array of strings to be displayed.
- * - `button` (optional): A {@link ButtonBuilder} instance to be added as a button accessory. If provided, no thumbnail can be set.
- * - `thumbnail` (optional): A {@link ThumbnailData} object to set as the thumbnail accessory. If provided, no button can be set.
+ * ---
+ * ### Overloads:
+ *
+ * 1. `createSection(content, accessory)`
+ *    Pass content as a string and an accessory separately.
+ *
+ * 2. `createSection({ content, accessory | button | thumbnail })`
+ *    Pass an object with full configuration, using only one of the accessory types.
  *
- * @param data - An object containing the properties `content`, `button`, and `thumbnail` for configuring the section.
+ * ---
  *
- * @returns A {@link SectionBuilder} instance with the specified configuration.
+ * @param content - The main content of the section. Only used in overload 1.
+ * @param accessory - A {@link ButtonBuilder}, {@link ThumbnailBuilder}, or raw data used to build the accessory. Only used in overload 1.
+ *
+ * @param data - An object in overload 2 containing:
+ * - `content`: A string or array of strings for display.
+ * - `accessory`: (optional) A single accessory, either a button or thumbnail.
+ * - `button`: (optional) A {@link ButtonBuilder} or partial button data. Mutually exclusive with `thumbnail` and `accessory`.
+ * - `thumbnail`: (optional) A {@link ThumbnailBuilder}, {@link ThumbnailData}, or image URL. Mutually exclusive with `button` and `accessory`.
+ *
+ * @returns A configured {@link SectionBuilder} instance with the provided content and accessory.
  *
  * @example
- * // Creating a section with a success button
- * const section = createSection({
- *   content: "Welcome to the section!",
- *   button: new ButtonBuilder({
- *     customId: "welcome/button",
- *     label: "Click Me",
- *     style: ButtonStyle.Success,
- *   }),
- * });
+ * // Overload 1: Using content and accessory separately
+ * const section = createSection("Hello World", new ButtonBuilder().setLabel("Click"));
  *
  * @example
- * // Creating a section with a thumbnail and content
+ * // Overload 2: Using content and thumbnail URL via `thumbnail`
  * const section = createSection({
- *   content: "This is a section with a thumbnail.",
+ *   content: "Here's an image section",
  *   thumbnail: "https://example.com/image.png"
  * });
  *
  * @example
- * // Creating a section with an array of content strings and a thumbnail
+ * // Overload 2: Using content and button via `accessory`
  * const section = createSection({
- *   content: ["Line 1", "Line 2", "Line 3"],
- *   thumbnail: "https://example.com/image.png"
+ *   content: "Button section",
+ *   accessory: new ButtonBuilder().setCustomId("id").setLabel("Press").setStyle(ButtonStyle.Primary)
  * });
  */
+declare function createSection(content: string, accessory: SectionAccessory): SectionBuilder;
 declare function createSection(data: SectionData): SectionBuilder;
 
 /**
@@ -406,7 +506,8 @@ declare function createSection(data: SectionData): SectionBuilder;
 declare function createTextDisplay(content: string, id?: number): TextDisplayBuilder;
 
 type ComponentData = TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | MessageActionRowComponentBuilder[] | MessageActionRowComponentBuilder | Attachment | AttachmentBuilder | string | null | undefined;
-declare function createComponents(...data: (ComponentData | ContainerBuilder)[]): (TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
+type CreateComponentData = ComponentData | ContainerBuilder;
+declare function createComponents(...data: (CreateComponentData | CreateComponentData[])[]): (SeparatorBuilder | TextDisplayBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
 
 type ContainerColor = (string & {}) | ColorResolvable;
 interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "type" | "components"> {
@@ -456,7 +557,7 @@ interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "ty
  * const container = createContainer([255, 0, 0], "Red alert");
  */
 declare function createContainer(data: ContainerData): ContainerBuilder;
-declare function createContainer(data: ColorResolvable | string, ...components: ComponentData[]): ContainerBuilder;
+declare function createContainer(data: ColorResolvable | string, ...components: (ComponentData | ComponentData[])[]): ContainerBuilder;
 
 type GuildChannelType = Exclude<ChannelType, ChannelType.DM>;
 type FindChannelFilter<T extends GuildChannelType> = (channel: GetChannelType<T>) => boolean;
@@ -593,5 +694,5 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 
 declare function isButtonBuilder(value: unknown): value is ButtonBuilder;
 
-export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus };
+export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
 export type { AnyEmbedData, AnySelectMenuBuilder, ComponentData, ContainerColor, ContainerData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbnailData };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, LinkButtonComponentData, AnyComponentBuilder, ActionRowBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, AnyComponentBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -31,6 +31,32 @@ declare enum EmbedLimit {
     URL = 2048
 }
 
+/**
+ * Predefined separator spacing variants for quick use.
+ */
+declare const Separator: {
+    /**
+     * Default separator with small spacing and visible divider.
+     * Equivalent to: `createSeparator()`
+     */
+    readonly Default: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and visible divider.
+     * Equivalent to: `createSeparator(true)`
+     */
+    readonly Large: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and no visible divider.
+     * Equivalent to: `createSeparator(true, false)`
+     */
+    readonly LargeHidden: discord_js.SeparatorBuilder;
+    /**
+     * Separator with small spacing and no visible divider.
+     * Equivalent to: `createSeparator(false, false)`
+     */
+    readonly Hidden: discord_js.SeparatorBuilder;
+};
+
 declare function setMobileStatus(): void;
 
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
@@ -182,8 +208,65 @@ declare function createEmbedFiles(embed: EmbedBuilder, options?: CreateEmbedFile
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
+/**
+ * Wraps buttons into multiple {@link ActionRowBuilder} instances with a maximum number of buttons per row.
+ *
+ * This function takes a list of {@link ButtonBuilder} instances (or arrays of them) and groups them into
+ * multiple `ActionRowBuilder<ButtonBuilder>` objects, ensuring that each row contains no more than the specified
+ * number of buttons.
+ *
+ * @param maxItemsPerRow - The maximum number of buttons to include in each row.
+ * @param buttons - A variadic list of {@link ButtonBuilder} instances or arrays of them to be wrapped.
+ *
+ * @returns An array of {@link ActionRowBuilder} instances, each containing up to `maxItemsPerRow` buttons.
+ *
+ * @example
+ * const button1 = new ButtonBuilder().setLabel("A").setCustomId("a").setStyle(ButtonStyle.Primary);
+ * const button2 = new ButtonBuilder().setLabel("B").setCustomId("b").setStyle(ButtonStyle.Primary);
+ * const button3 = new ButtonBuilder().setLabel("C").setCustomId("c").setStyle(ButtonStyle.Primary);
+ *
+ * const rows = wrapButtons(2, button1, button2, button3);
+ * // Result: Two rows, the first with [button1, button2], the second with [button3]
+ */
+declare function wrapButtons(maxItemsPerRow: number, ...buttons: (ButtonBuilder | ButtonBuilder[])[]): ActionRowBuilder<ButtonBuilder>[];
 
-declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
+/**
+ * Creates an {@link ActionRowBuilder} containing one or more UI components.
+ *
+ * This function accepts individual components or arrays of components, flattens them,
+ * and returns an action row builder suitable for use in Discord messages.
+ * It's designed to support any component builder type that extends {@link AnyComponentBuilder}.
+ *
+ * ---
+ * While this function supports any valid message component (such as buttons, select menus, etc.),
+ * the examples below demonstrate common use cases using {@link ButtonBuilder} and {@link StringSelectMenuBuilder}.
+ *
+ * @typeParam Component - A type extending {@link AnyComponentBuilder}, such as a button or select menu builder.
+ *
+ * @param components - A variadic list of component instances or arrays of component instances to include in the row.
+ *
+ * @returns An {@link ActionRowBuilder} instance containing all provided components.
+ *
+ * @example
+ * // Create a row with two buttons
+ * const row = createRow(
+ *   new ButtonBuilder().setCustomId("yes").setLabel("Yes").setStyle(ButtonStyle.Success),
+ *   new ButtonBuilder().setCustomId("no").setLabel("No").setStyle(ButtonStyle.Danger)
+ * );
+ *
+ * @example
+ * // Create a row with a string select menu
+ * const row = createRow([
+ *   new StringSelectMenuBuilder()
+ *     .setCustomId("choose")
+ *     .setPlaceholder("Make a selection")
+ *     .addOptions(
+ *       { label: "Option 1", value: "opt1" },
+ *       { label: "Option 2", value: "opt2" }
+ *     )
+ * ]);
+ */
+declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
 
 type FileSource = string | Attachment | AttachmentBuilder;
 interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
@@ -266,32 +349,42 @@ interface SeparatorData {
     large?: boolean;
 }
 /**
- * Creates a {@link SeparatorBuilder} component with customizable options for visibility and spacing.
+ * Creates a {@link SeparatorBuilder} component with configurable visibility and spacing.
  *
- * This function generates a separator that can be configured to either be visible or disabled,
- * and can have either small or large spacing between components. The default settings are for a
- * visible separator with small spacing.
+ * This function generates a separator component that can be customized for:
+ * - Visibility (`divider`: whether the visual divider line is shown).
+ * - Spacing (`large`: whether to use large or small spacing).
  *
- * **Parameters:**
- * - `divider` (optional): If `false`, the separator divider will be disabled and won't be rendered. Default is `true`.
- * - `large` (optional): If `true`, the separator will have a large spacing. Default is `false` (small spacing).
+ * It accepts parameters in two formats:
  *
- * @param data - An object containing the optional properties `divider` and `large` to configure the separator.
+ * **1. As an object:**
+ * @param data - An optional object with the following properties:
+ * - `divider` (boolean, optional): Whether the divider is visible. Defaults to `true`.
+ * - `large` (boolean, optional): Whether to use large spacing. Defaults to `false`.
+ *
+ * **2. As positional arguments:**
+ * @param large - Whether to use large spacing. Defaults to `false`.
+ * @param divider - Whether the divider is visible. Defaults to `true`.
  *
  * @returns A {@link SeparatorBuilder} instance with the specified configuration.
  *
  * @example
- * // Creating a separator with default settings (visible and small spacing)
+ * // Using object syntax with default options
  * const separator = createSeparator();
  *
  * @example
- * // Creating a disabled separator divider (not visible)
- * const separator = createSeparator({ divider: false });
+ * // Using object syntax to disable the divider and enable large spacing
+ * const separator = createSeparator({ divider: false, large: true });
+ *
+ * @example
+ * // Using positional arguments: large spacing, visible divider
+ * const separator = createSeparator(true, true);
  *
  * @example
- * // Creating a separator with large spacing
- * const separator = createSeparator({ large: true });
+ * // Using positional arguments: small spacing, hidden divider
+ * const separator = createSeparator(false, false);
  */
+declare function createSeparator(large?: boolean, divider?: boolean): SeparatorBuilder;
 declare function createSeparator(data?: SeparatorData): SeparatorBuilder;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
@@ -342,46 +435,53 @@ type SectionData = SectionAccessoryData & {
     content: string | string[];
 };
 /**
- * Creates a {@link SectionBuilder} component with customizable content, thumbnail, and optional button.
+ * Creates a {@link SectionBuilder} component with customizable text content and a single visual accessory.
  *
- * This function generates a section that can either have a button, a thumbnail, or both as accessories,
- * along with the provided content. The content can be a single string or an array of strings.
- * If both a button and a thumbnail are provided, only one can be set, as specified in the types.
+ * This function allows you to generate a section with content (as a string or an array of strings)
+ * and optionally include a single accessory, which can be a button or a thumbnail.
+ * You can provide the accessory in multiple forms: a builder instance, a plain data object, or a URL string (for thumbnails).
  *
- * **Parameters:**
- * - `content`: The main content of the section. This can either be a single string or an array of strings to be displayed.
- * - `button` (optional): A {@link ButtonBuilder} instance to be added as a button accessory. If provided, no thumbnail can be set.
- * - `thumbnail` (optional): A {@link ThumbnailData} object to set as the thumbnail accessory. If provided, no button can be set.
+ * ---
+ * ### Overloads:
+ *
+ * 1. `createSection(content, accessory)`
+ *    Pass content as a string and an accessory separately.
+ *
+ * 2. `createSection({ content, accessory | button | thumbnail })`
+ *    Pass an object with full configuration, using only one of the accessory types.
  *
- * @param data - An object containing the properties `content`, `button`, and `thumbnail` for configuring the section.
+ * ---
  *
- * @returns A {@link SectionBuilder} instance with the specified configuration.
+ * @param content - The main content of the section. Only used in overload 1.
+ * @param accessory - A {@link ButtonBuilder}, {@link ThumbnailBuilder}, or raw data used to build the accessory. Only used in overload 1.
+ *
+ * @param data - An object in overload 2 containing:
+ * - `content`: A string or array of strings for display.
+ * - `accessory`: (optional) A single accessory, either a button or thumbnail.
+ * - `button`: (optional) A {@link ButtonBuilder} or partial button data. Mutually exclusive with `thumbnail` and `accessory`.
+ * - `thumbnail`: (optional) A {@link ThumbnailBuilder}, {@link ThumbnailData}, or image URL. Mutually exclusive with `button` and `accessory`.
+ *
+ * @returns A configured {@link SectionBuilder} instance with the provided content and accessory.
  *
  * @example
- * // Creating a section with a success button
- * const section = createSection({
- *   content: "Welcome to the section!",
- *   button: new ButtonBuilder({
- *     customId: "welcome/button",
- *     label: "Click Me",
- *     style: ButtonStyle.Success,
- *   }),
- * });
+ * // Overload 1: Using content and accessory separately
+ * const section = createSection("Hello World", new ButtonBuilder().setLabel("Click"));
  *
  * @example
- * // Creating a section with a thumbnail and content
+ * // Overload 2: Using content and thumbnail URL via `thumbnail`
  * const section = createSection({
- *   content: "This is a section with a thumbnail.",
+ *   content: "Here's an image section",
  *   thumbnail: "https://example.com/image.png"
  * });
  *
  * @example
- * // Creating a section with an array of content strings and a thumbnail
+ * // Overload 2: Using content and button via `accessory`
  * const section = createSection({
- *   content: ["Line 1", "Line 2", "Line 3"],
- *   thumbnail: "https://example.com/image.png"
+ *   content: "Button section",
+ *   accessory: new ButtonBuilder().setCustomId("id").setLabel("Press").setStyle(ButtonStyle.Primary)
  * });
  */
+declare function createSection(content: string, accessory: SectionAccessory): SectionBuilder;
 declare function createSection(data: SectionData): SectionBuilder;
 
 /**
@@ -406,7 +506,8 @@ declare function createSection(data: SectionData): SectionBuilder;
 declare function createTextDisplay(content: string, id?: number): TextDisplayBuilder;
 
 type ComponentData = TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | MessageActionRowComponentBuilder[] | MessageActionRowComponentBuilder | Attachment | AttachmentBuilder | string | null | undefined;
-declare function createComponents(...data: (ComponentData | ContainerBuilder)[]): (TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
+type CreateComponentData = ComponentData | ContainerBuilder;
+declare function createComponents(...data: (CreateComponentData | CreateComponentData[])[]): (SeparatorBuilder | TextDisplayBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
 
 type ContainerColor = (string & {}) | ColorResolvable;
 interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "type" | "components"> {
@@ -456,7 +557,7 @@ interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "ty
  * const container = createContainer([255, 0, 0], "Red alert");
  */
 declare function createContainer(data: ContainerData): ContainerBuilder;
-declare function createContainer(data: ColorResolvable | string, ...components: ComponentData[]): ContainerBuilder;
+declare function createContainer(data: ColorResolvable | string, ...components: (ComponentData | ComponentData[])[]): ContainerBuilder;
 
 type GuildChannelType = Exclude<ChannelType, ChannelType.DM>;
 type FindChannelFilter<T extends GuildChannelType> = (channel: GetChannelType<T>) => boolean;
@@ -593,5 +694,5 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 
 declare function isButtonBuilder(value: unknown): value is ButtonBuilder;
 
-export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus };
+export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
 export type { AnyEmbedData, AnySelectMenuBuilder, ComponentData, ContainerColor, ContainerData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbnailData };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, LinkButtonComponentData, AnyComponentBuilder, ActionRowBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
+import { GatewayIntentBits, Partials, Attachment, AttachmentBuilder, EmbedAssetData, Guild, GuildMember, User, ClientUser, ImageURLOptions, EmbedFooterData, ColorResolvable, APIEmbed, Embed, EmbedData, EmbedBuilder, AttachmentData, ButtonBuilder, ActionRowBuilder, LinkButtonComponentData, AnyComponentBuilder, FileBuilder, APIUnfurledMediaItem, MediaGalleryBuilder, MediaGalleryItemData, SeparatorBuilder, ThumbnailComponentData, ThumbnailBuilder, ButtonComponentData, SectionBuilder, TextDisplayBuilder, MessageActionRowComponentBuilder, ContainerBuilder, ContainerComponentData, ChannelType, CommandInteractionOption, Client, ApplicationCommand, TextInputBuilder, ModalSubmitInteraction, ModalSubmitFields, Collection, TextInputComponent, TextInputStyle, TextInputComponentData, GuildEmoji, GuildTextBasedChannel, Message, Role, WebhookClientOptions, WebhookClient, WebhookClientData, StringSelectMenuBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, ChannelSelectMenuBuilder, MentionableSelectMenuBuilder } from 'discord.js';
 export * from '@magicyan/core';
 
 declare const chars: {
@@ -31,6 +31,32 @@ declare enum EmbedLimit {
     URL = 2048
 }
 
+/**
+ * Predefined separator spacing variants for quick use.
+ */
+declare const Separator: {
+    /**
+     * Default separator with small spacing and visible divider.
+     * Equivalent to: `createSeparator()`
+     */
+    readonly Default: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and visible divider.
+     * Equivalent to: `createSeparator(true)`
+     */
+    readonly Large: discord_js.SeparatorBuilder;
+    /**
+     * Separator with large spacing and no visible divider.
+     * Equivalent to: `createSeparator(true, false)`
+     */
+    readonly LargeHidden: discord_js.SeparatorBuilder;
+    /**
+     * Separator with small spacing and no visible divider.
+     * Equivalent to: `createSeparator(false, false)`
+     */
+    readonly Hidden: discord_js.SeparatorBuilder;
+};
+
 declare function setMobileStatus(): void;
 
 type EmbedPlusAssetData = string | Attachment | AttachmentBuilder | EmbedAssetData | undefined | null;
@@ -182,8 +208,65 @@ declare function createEmbedFiles(embed: EmbedBuilder, options?: CreateEmbedFile
 interface CreateLinkButtonData extends Omit<LinkButtonComponentData, "style" | "type"> {
 }
 declare function createLinkButton(data: CreateLinkButtonData): ButtonBuilder;
+/**
+ * Wraps buttons into multiple {@link ActionRowBuilder} instances with a maximum number of buttons per row.
+ *
+ * This function takes a list of {@link ButtonBuilder} instances (or arrays of them) and groups them into
+ * multiple `ActionRowBuilder<ButtonBuilder>` objects, ensuring that each row contains no more than the specified
+ * number of buttons.
+ *
+ * @param maxItemsPerRow - The maximum number of buttons to include in each row.
+ * @param buttons - A variadic list of {@link ButtonBuilder} instances or arrays of them to be wrapped.
+ *
+ * @returns An array of {@link ActionRowBuilder} instances, each containing up to `maxItemsPerRow` buttons.
+ *
+ * @example
+ * const button1 = new ButtonBuilder().setLabel("A").setCustomId("a").setStyle(ButtonStyle.Primary);
+ * const button2 = new ButtonBuilder().setLabel("B").setCustomId("b").setStyle(ButtonStyle.Primary);
+ * const button3 = new ButtonBuilder().setLabel("C").setCustomId("c").setStyle(ButtonStyle.Primary);
+ *
+ * const rows = wrapButtons(2, button1, button2, button3);
+ * // Result: Two rows, the first with [button1, button2], the second with [button3]
+ */
+declare function wrapButtons(maxItemsPerRow: number, ...buttons: (ButtonBuilder | ButtonBuilder[])[]): ActionRowBuilder<ButtonBuilder>[];
 
-declare function createRow<Component extends AnyComponentBuilder>(...components: Component[]): ActionRowBuilder<Component>;
+/**
+ * Creates an {@link ActionRowBuilder} containing one or more UI components.
+ *
+ * This function accepts individual components or arrays of components, flattens them,
+ * and returns an action row builder suitable for use in Discord messages.
+ * It's designed to support any component builder type that extends {@link AnyComponentBuilder}.
+ *
+ * ---
+ * While this function supports any valid message component (such as buttons, select menus, etc.),
+ * the examples below demonstrate common use cases using {@link ButtonBuilder} and {@link StringSelectMenuBuilder}.
+ *
+ * @typeParam Component - A type extending {@link AnyComponentBuilder}, such as a button or select menu builder.
+ *
+ * @param components - A variadic list of component instances or arrays of component instances to include in the row.
+ *
+ * @returns An {@link ActionRowBuilder} instance containing all provided components.
+ *
+ * @example
+ * // Create a row with two buttons
+ * const row = createRow(
+ *   new ButtonBuilder().setCustomId("yes").setLabel("Yes").setStyle(ButtonStyle.Success),
+ *   new ButtonBuilder().setCustomId("no").setLabel("No").setStyle(ButtonStyle.Danger)
+ * );
+ *
+ * @example
+ * // Create a row with a string select menu
+ * const row = createRow([
+ *   new StringSelectMenuBuilder()
+ *     .setCustomId("choose")
+ *     .setPlaceholder("Make a selection")
+ *     .addOptions(
+ *       { label: "Option 1", value: "opt1" },
+ *       { label: "Option 2", value: "opt2" }
+ *     )
+ * ]);
+ */
+declare function createRow<Component extends AnyComponentBuilder>(...components: (Component | Component[])[]): ActionRowBuilder<Component>;
 
 type FileSource = string | Attachment | AttachmentBuilder;
 interface CreateFileOptions extends Omit<APIUnfurledMediaItem, "url"> {
@@ -266,32 +349,42 @@ interface SeparatorData {
     large?: boolean;
 }
 /**
- * Creates a {@link SeparatorBuilder} component with customizable options for visibility and spacing.
+ * Creates a {@link SeparatorBuilder} component with configurable visibility and spacing.
  *
- * This function generates a separator that can be configured to either be visible or disabled,
- * and can have either small or large spacing between components. The default settings are for a
- * visible separator with small spacing.
+ * This function generates a separator component that can be customized for:
+ * - Visibility (`divider`: whether the visual divider line is shown).
+ * - Spacing (`large`: whether to use large or small spacing).
  *
- * **Parameters:**
- * - `divider` (optional): If `false`, the separator divider will be disabled and won't be rendered. Default is `true`.
- * - `large` (optional): If `true`, the separator will have a large spacing. Default is `false` (small spacing).
+ * It accepts parameters in two formats:
  *
- * @param data - An object containing the optional properties `divider` and `large` to configure the separator.
+ * **1. As an object:**
+ * @param data - An optional object with the following properties:
+ * - `divider` (boolean, optional): Whether the divider is visible. Defaults to `true`.
+ * - `large` (boolean, optional): Whether to use large spacing. Defaults to `false`.
+ *
+ * **2. As positional arguments:**
+ * @param large - Whether to use large spacing. Defaults to `false`.
+ * @param divider - Whether the divider is visible. Defaults to `true`.
  *
  * @returns A {@link SeparatorBuilder} instance with the specified configuration.
  *
  * @example
- * // Creating a separator with default settings (visible and small spacing)
+ * // Using object syntax with default options
  * const separator = createSeparator();
  *
  * @example
- * // Creating a disabled separator divider (not visible)
- * const separator = createSeparator({ divider: false });
+ * // Using object syntax to disable the divider and enable large spacing
+ * const separator = createSeparator({ divider: false, large: true });
+ *
+ * @example
+ * // Using positional arguments: large spacing, visible divider
+ * const separator = createSeparator(true, true);
  *
  * @example
- * // Creating a separator with large spacing
- * const separator = createSeparator({ large: true });
+ * // Using positional arguments: small spacing, hidden divider
+ * const separator = createSeparator(false, false);
  */
+declare function createSeparator(large?: boolean, divider?: boolean): SeparatorBuilder;
 declare function createSeparator(data?: SeparatorData): SeparatorBuilder;
 
 type ThumbnailData = Partial<Omit<ThumbnailComponentData, "type">> | Attachment | AttachmentBuilder | string;
@@ -342,46 +435,53 @@ type SectionData = SectionAccessoryData & {
     content: string | string[];
 };
 /**
- * Creates a {@link SectionBuilder} component with customizable content, thumbnail, and optional button.
+ * Creates a {@link SectionBuilder} component with customizable text content and a single visual accessory.
  *
- * This function generates a section that can either have a button, a thumbnail, or both as accessories,
- * along with the provided content. The content can be a single string or an array of strings.
- * If both a button and a thumbnail are provided, only one can be set, as specified in the types.
+ * This function allows you to generate a section with content (as a string or an array of strings)
+ * and optionally include a single accessory, which can be a button or a thumbnail.
+ * You can provide the accessory in multiple forms: a builder instance, a plain data object, or a URL string (for thumbnails).
  *
- * **Parameters:**
- * - `content`: The main content of the section. This can either be a single string or an array of strings to be displayed.
- * - `button` (optional): A {@link ButtonBuilder} instance to be added as a button accessory. If provided, no thumbnail can be set.
- * - `thumbnail` (optional): A {@link ThumbnailData} object to set as the thumbnail accessory. If provided, no button can be set.
+ * ---
+ * ### Overloads:
+ *
+ * 1. `createSection(content, accessory)`
+ *    Pass content as a string and an accessory separately.
+ *
+ * 2. `createSection({ content, accessory | button | thumbnail })`
+ *    Pass an object with full configuration, using only one of the accessory types.
  *
- * @param data - An object containing the properties `content`, `button`, and `thumbnail` for configuring the section.
+ * ---
  *
- * @returns A {@link SectionBuilder} instance with the specified configuration.
+ * @param content - The main content of the section. Only used in overload 1.
+ * @param accessory - A {@link ButtonBuilder}, {@link ThumbnailBuilder}, or raw data used to build the accessory. Only used in overload 1.
+ *
+ * @param data - An object in overload 2 containing:
+ * - `content`: A string or array of strings for display.
+ * - `accessory`: (optional) A single accessory, either a button or thumbnail.
+ * - `button`: (optional) A {@link ButtonBuilder} or partial button data. Mutually exclusive with `thumbnail` and `accessory`.
+ * - `thumbnail`: (optional) A {@link ThumbnailBuilder}, {@link ThumbnailData}, or image URL. Mutually exclusive with `button` and `accessory`.
+ *
+ * @returns A configured {@link SectionBuilder} instance with the provided content and accessory.
  *
  * @example
- * // Creating a section with a success button
- * const section = createSection({
- *   content: "Welcome to the section!",
- *   button: new ButtonBuilder({
- *     customId: "welcome/button",
- *     label: "Click Me",
- *     style: ButtonStyle.Success,
- *   }),
- * });
+ * // Overload 1: Using content and accessory separately
+ * const section = createSection("Hello World", new ButtonBuilder().setLabel("Click"));
  *
  * @example
- * // Creating a section with a thumbnail and content
+ * // Overload 2: Using content and thumbnail URL via `thumbnail`
  * const section = createSection({
- *   content: "This is a section with a thumbnail.",
+ *   content: "Here's an image section",
  *   thumbnail: "https://example.com/image.png"
  * });
  *
  * @example
- * // Creating a section with an array of content strings and a thumbnail
+ * // Overload 2: Using content and button via `accessory`
  * const section = createSection({
- *   content: ["Line 1", "Line 2", "Line 3"],
- *   thumbnail: "https://example.com/image.png"
+ *   content: "Button section",
+ *   accessory: new ButtonBuilder().setCustomId("id").setLabel("Press").setStyle(ButtonStyle.Primary)
  * });
  */
+declare function createSection(content: string, accessory: SectionAccessory): SectionBuilder;
 declare function createSection(data: SectionData): SectionBuilder;
 
 /**
@@ -406,7 +506,8 @@ declare function createSection(data: SectionData): SectionBuilder;
 declare function createTextDisplay(content: string, id?: number): TextDisplayBuilder;
 
 type ComponentData = TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | MessageActionRowComponentBuilder[] | MessageActionRowComponentBuilder | Attachment | AttachmentBuilder | string | null | undefined;
-declare function createComponents(...data: (ComponentData | ContainerBuilder)[]): (TextDisplayBuilder | SeparatorBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
+type CreateComponentData = ComponentData | ContainerBuilder;
+declare function createComponents(...data: (CreateComponentData | CreateComponentData[])[]): (SeparatorBuilder | TextDisplayBuilder | FileBuilder | SectionBuilder | MediaGalleryBuilder | ActionRowBuilder<MessageActionRowComponentBuilder> | ContainerBuilder)[];
 
 type ContainerColor = (string & {}) | ColorResolvable;
 interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "type" | "components"> {
@@ -456,7 +557,7 @@ interface ContainerData extends Omit<ContainerComponentData, "accentColor" | "ty
  * const container = createContainer([255, 0, 0], "Red alert");
  */
 declare function createContainer(data: ContainerData): ContainerBuilder;
-declare function createContainer(data: ColorResolvable | string, ...components: ComponentData[]): ContainerBuilder;
+declare function createContainer(data: ColorResolvable | string, ...components: (ComponentData | ComponentData[])[]): ContainerBuilder;
 
 type GuildChannelType = Exclude<ChannelType, ChannelType.DM>;
 type FindChannelFilter<T extends GuildChannelType> = (channel: GetChannelType<T>) => boolean;
@@ -593,5 +694,5 @@ declare function isAnySelectMenuBuilder(value: unknown): value is AnySelectMenuB
 
 declare function isButtonBuilder(value: unknown): value is ButtonBuilder;
 
-export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus };
+export { CustomItents, CustomPartials, EmbedLimit, EmbedPlusBuilder, Separator, chars, commandMention, createComponents, createContainer, createEmbed, createEmbedAsset, createEmbedAuthor, createEmbedFiles, createEmbedFooter, createFile, createLinkButton, createMediaGallery, createModalFields, createModalInput, createRow, createSection, createSeparator, createTextDisplay, createThumbnail, createWebhookClient, extractMentionId, findChannel, findCommand, findEmoji, findMember, findMessage, findRole, getChannelUrlInfo, getMessageUrlInfo, isAnySelectMenuBuilder, isAttachment, isButtonBuilder, modalFieldsToRecord, setMobileStatus, wrapButtons };
 export type { AnyEmbedData, AnySelectMenuBuilder, ComponentData, ContainerColor, ContainerData, EmbedPlusAssetData, EmbedPlusAuthorData, EmbedPlusColorData, EmbedPlusData, EmbedPlusFooterData, EmbedPlusProperty, SectionAccessory, SectionAccessoryData, SectionButtonAccessory, SectionData, SectionThumbnailAccessory, SeparatorData, ThumbnailData };

package/dist/index.mjs

@@ -1,13 +1,14 @@
 export { chars } from './constants/chars.mjs';
 export { CustomItents, CustomPartials } from './constants/client.mjs';
 export { EmbedLimit } from './constants/embed.mjs';
+export { Separator } from './constants/separator.mjs';
 export { setMobileStatus } from './functions/misc.mjs';
 export { createEmbedAsset } from './functions/embeds/assets.mjs';
 export { createEmbedAuthor } from './functions/embeds/author.mjs';
 export { EmbedPlusBuilder, createEmbed } from './functions/embeds/embedplus.mjs';
 export { createEmbedFooter } from './functions/embeds/footer.mjs';
 export { createEmbedFiles } from './functions/embeds/files.mjs';
-export { createLinkButton } from './functions/components/buttons.mjs';
+export { createLinkButton, wrapButtons } from './functions/components/buttons.mjs';
 export { createRow } from './functions/components/row.mjs';
 export { createFile } from './functions/components/file.mjs';
 export { createMediaGallery } from './functions/components/gallery.mjs';

package/package.json

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