commandkit 1.2.0-rc.12 → 1.2.0-rc.13

package/dist/MessageCommandParser-q3dQcE5N.d.ts

@@ -0,0 +1,194 @@
+import { ApplicationCommandOptionType, Attachment, CommandInteractionOption, GuildMember, Message, Role, User } from "discord.js";
+import { Channel } from "diagnostics_channel";
+
+//#region src/app/commands/MessageCommandParser.d.ts
+/**
+ * Represents a parsed message command with its components.
+ */
+interface ParsedMessageCommand {
+  command: string;
+  options: {
+    name: string;
+    value: unknown;
+  }[];
+  subcommand?: string;
+  subcommandGroup?: string;
+}
+/**
+ * Schema defining the types of options for a message command.
+ */
+type MessageCommandOptionsSchema = Record<string, ApplicationCommandOptionType>;
+/**
+ * Parses message content into structured command data with options and subcommands.
+ */
+declare class MessageCommandParser {
+  #private;
+  message: Message;
+  private prefix;
+  private schema;
+  /**
+       * Creates a new message command parser.
+       * @param message - The Discord message to parse
+       * @param prefix - Array of valid command prefixes or a regular expression
+       * @param schema - Function that returns the options schema for a command
+       */
+  constructor(message: Message, prefix: string[] | RegExp, schema: (command: string) => MessageCommandOptionsSchema);
+  /**
+       * Gets the parsed command arguments.
+       * @returns Array of command arguments
+       */
+  getArgs(): string[];
+  /**
+       * Gets the message command options object for easy access to typed option values.
+       */
+  get options(): MessageCommandOptions;
+  /**
+       * Gets a specific option value by name.
+       * @param name - The option name
+       * @returns The option value or undefined if not found
+       */
+  getOption<T>(name: string): T | undefined;
+  /**
+       * Gets the main command name.
+       * @returns The command name
+       */
+  getCommand(): string;
+  /**
+       * Gets the subcommand name if present.
+       * @returns The subcommand name or undefined
+       */
+  getSubcommand(): string | undefined;
+  /**
+       * Gets the subcommand group name if present.
+       * @returns The subcommand group name or undefined
+       */
+  getSubcommandGroup(): string | undefined;
+  /**
+       * Gets the prefix used in the message.
+       * @returns The matched prefix or undefined
+       */
+  getPrefix(): string | undefined;
+  /**
+       * Gets the full command including subcommand group and subcommand.
+       * @returns The complete command string
+       */
+  getFullCommand(): string;
+  /**
+       * Parses the message content into structured command data.
+       * @returns The parsed command data
+       */
+  parse(): ParsedMessageCommand;
+}
+/**
+ * Provides typed access to message command options with methods similar to Discord.js interaction options.
+ */
+declare class MessageCommandOptions {
+  private parser;
+  /**
+       * Creates a new message command options instance.
+       * @param parser - The message command parser instance
+       */
+  constructor(parser: MessageCommandParser);
+  /**
+       * @private
+       * @internal
+       */
+  private assertOption;
+  /**
+       * Gets a guild member from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The guild member or null if not found
+       */
+  getMember(name: string): GuildMember | null;
+  getMember(name: string, required: true): GuildMember;
+  /**
+       * Gets an attachment from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The attachment or null if not found
+       */
+  getAttachment(name: string): Attachment | null;
+  getAttachment(name: string, required: true): Attachment;
+  /**
+       * Gets a boolean value from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The boolean value or null if not found
+       */
+  getBoolean(name: string): boolean | null;
+  getBoolean(name: string, required: true): boolean;
+  /**
+       * Gets a number value from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The number value or null if not found
+       */
+  getNumber(name: string): number | null;
+  getNumber(name: string, required: true): number;
+  /**
+       * Gets a string value from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The string value or null if not found
+       */
+  getString(name: string): string | null;
+  getString(name: string, required: true): string;
+  /**
+       * Gets an integer value from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The integer value or null if not found
+       */
+  getInteger(name: string): number | null;
+  getInteger(name: string, required: true): number;
+  /**
+       * Gets a user from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The user or null if not found
+       */
+  getUser(name: string): User | null;
+  getUser(name: string, required: true): User;
+  /**
+       * Gets a channel from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The channel or null if not found
+       */
+  getChannel(name: string): Channel | null;
+  getChannel(name: string, required: true): Channel;
+  /**
+       * Gets a role from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The role or null if not found
+       */
+  getRole(name: string): Role | null;
+  getRole(name: string, required: true): Role;
+  /**
+       * Gets a mentionable (user, member, or role) from the command options.
+       * @param name - The option name
+       * @param required - Whether the option is required
+       * @returns The mentionable or null if not found
+       */
+  getMentionable(name: string): NonNullable<CommandInteractionOption['member' | 'role' | 'user']> | null;
+  getMentionable(name: string, required: true): NonNullable<CommandInteractionOption['member' | 'role' | 'user']>;
+  /**
+       * Gets the subcommand name from the command.
+       * @param required - Whether the subcommand is required
+       * @returns The subcommand name or null if not found
+       */
+  getSubcommand(): string | null;
+  getSubcommand(required: true): string;
+  /**
+       * Gets the subcommand group name from the command.
+       * @param required - Whether the subcommand group is required
+       * @returns The subcommand group name or null if not found
+       */
+  getSubcommandGroup(): string | null;
+  getSubcommandGroup(required: true): string;
+}
+//#endregion
+export { ParsedMessageCommand as i, MessageCommandOptionsSchema as n, MessageCommandParser as r, MessageCommandOptions as t };
+//# sourceMappingURL=MessageCommandParser-q3dQcE5N.d.ts.map

package/dist/{Modal-Calb46SJ.d.ts → Modal-CZT9MZsy.d.ts}

@@ -1,11 +1,10 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
-import { CommandKitModalBuilderInteractionCollectorDispatchContextData, ModalKit, OnModalKitEnd, OnModalKitSubmit } from "./ModalKit-Cq2ns6jv.js";
-import { CommandKitElement } from "./element-CvNhvLZ8.js";
-import { MaybeArray } from "./types-CJ-XvOFN.js";
-import { TextInputStyle } from "discord.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
+import { i as ModalKit, n as CommandKitModalBuilderInteractionCollectorDispatchContextData, o as OnModalKitEnd, s as OnModalKitSubmit } from "./ModalKit-BWXI3Z26.js";
+import { n as CommandKitElement } from "./element-wQo0heGj.js";
+import { t as MaybeArray } from "./types-BywA9d2Z.js";
+import { FileUploadBuilder, FileUploadComponentData, TextInputStyle } from "discord.js";
 
 //#region src/components/interactive/modal/Modal.d.ts
-
 /**
  * The properties for the modal component.
  */
@@ -28,8 +27,8 @@ declare function Modal(props: ModalProps): CommandKitElement<'modal'>;
 interface TextInputProps {
   customId: string;
   /**
-   * @deprecated use the `<Label />` component instead.
-   */
+       * @deprecated use the `<Label />` component instead.
+       */
   label?: string;
   placeholder?: string;
   maxLength?: number;
@@ -60,6 +59,17 @@ declare function ShortInput(props: TextInputProps): CommandKitElement<'text-inpu
  * @example <ParagraphInput customId="input" label="Input" />
  */
 declare function ParagraphInput(props: TextInputProps): CommandKitElement<'text-input'>;
+interface FileUploadProps extends Omit<FileUploadComponentData, 'type' | 'required'> {
+  id?: number;
+  required?: boolean;
+}
+/**
+ * The file upload component.
+ * @param props The file upload properties.
+ * @returns The commandkit element.
+ * @example <FileUpload customId="file" />
+ */
+declare function FileUpload(props: FileUploadProps): FileUploadBuilder;
 //#endregion
-export { Modal, ModalProps, ParagraphInput, ShortInput, TextInput, TextInputProps };
-//# sourceMappingURL=Modal-Calb46SJ.d.ts.map
+export { ParagraphInput as a, TextInputProps as c, ModalProps as i, FileUploadProps as n, ShortInput as o, Modal as r, TextInput as s, FileUpload as t };
+//# sourceMappingURL=Modal-CZT9MZsy.d.ts.map

package/dist/{ModalKit-Cq2ns6jv.d.ts → ModalKit-BWXI3Z26.d.ts}

@@ -1,8 +1,7 @@
-import { EventInterceptorContextData, EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
 import { Awaitable, Events, ModalBuilder, ModalSubmitInteraction } from "discord.js";
 
 //#region src/components/interactive/modal/ModalKit.d.ts
-
 /**
  * The predicate function that filters modal interactions.
  * It receives a ModalSubmitInteraction and returns a boolean or a Promise that resolves to a boolean.
@@ -41,47 +40,47 @@ type CommandKitModalBuilderInteractionCollectorDispatchContextData = EventInterc
 declare class ModalKit extends ModalBuilder {
   #private;
   /**
-   * Sets the handler to run when the modal is submitted.
-   * @param handler - The handler to run when the modal is submitted.
-   * @param data - The context data for the interaction collector.
-   * @returns This instance of the modal builder.
-   * @example
-   * ```ts
-   * const modal = new ModalKit()
-   *  .setTitle('My Modal')
-   *  .setCustomId('my-modal')
-   *  .filter((interaction) => interaction.user.id === '1234567890')
-   *  .onSubmit(async (interaction) => {
-   *     await interaction.reply('You submitted the modal!');
-   *   })
-   *   .addComponents(actionRow1, actionRow2);
-   * ```
-   */
+       * Sets the handler to run when the modal is submitted.
+       * @param handler - The handler to run when the modal is submitted.
+       * @param data - The context data for the interaction collector.
+       * @returns This instance of the modal builder.
+       * @example
+       * ```ts
+       * const modal = new ModalKit()
+       *  .setTitle('My Modal')
+       *  .setCustomId('my-modal')
+       *  .filter((interaction) => interaction.user.id === '1234567890')
+       *  .onSubmit(async (interaction) => {
+       *     await interaction.reply('You submitted the modal!');
+       *   })
+       *   .addComponents(actionRow1, actionRow2);
+       * ```
+       */
   onSubmit(handler: CommandKitModalBuilderInteractionCollectorDispatch, data?: CommandKitModalBuilderInteractionCollectorDispatchContextData): this;
   /**
-   * Sets the handler to run when the interaction collector ends.
-   * @param handler - The handler to run when the interaction collector ends.
-   * @returns This instance of the modal builder.
-   */
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
   onEnd(handler: CommandKitModalBuilderOnEnd): this;
   /**
-   * Sets the handler to run when the interaction collector ends.
-   * @param handler - The handler to run when the interaction collector ends.
-   * @returns This instance of the modal builder.
-   */
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
   onError(handler: EventInterceptorErrorHandler): this;
   /**
-   * Sets a filter for the interaction collector.
-   * @param predicate - The filter to use for the interaction collector.
-   * @returns This instance of the modal builder.
-   */
+       * Sets a filter for the interaction collector.
+       * @param predicate - The filter to use for the interaction collector.
+       * @returns This instance of the modal builder.
+       */
   filter(predicate: ModalKitPredicate): this;
   private get customId();
   /**
-   * Disposes of the modal collector and cleans up resources.
-   */
+       * Disposes of the modal collector and cleans up resources.
+       */
   dispose(): this;
 }
 //#endregion
-export { CommandKitModalBuilderInteractionCollectorDispatch, CommandKitModalBuilderInteractionCollectorDispatchContextData, CommandKitModalBuilderOnEnd, ModalKit, ModalKitPredicate, OnModalKitEnd, OnModalKitSubmit };
-//# sourceMappingURL=ModalKit-Cq2ns6jv.d.ts.map
+export { ModalKitPredicate as a, ModalKit as i, CommandKitModalBuilderInteractionCollectorDispatchContextData as n, OnModalKitEnd as o, CommandKitModalBuilderOnEnd as r, OnModalKitSubmit as s, CommandKitModalBuilderInteractionCollectorDispatch as t };
+//# sourceMappingURL=ModalKit-BWXI3Z26.d.ts.map

package/dist/{PluginCommon-CPWV5xuX.js → PluginCommon-BLxWww5u.js}

@@ -1,6 +1,5 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
+const require_chunk = require('./chunk-kSYXY2_d.js');
 let node_crypto = require("node:crypto");
-node_crypto = require_chunk.__toESM(node_crypto);
 
 //#region src/plugins/PluginCommon.ts
 /**
@@ -8,10 +7,10 @@ node_crypto = require_chunk.__toESM(node_crypto);
 * - Compiler: A plugin that runs at compile time.
 * - Runtime: A plugin that runs at runtime.
 */
-let PluginType = /* @__PURE__ */ function(PluginType$1) {
-	PluginType$1["Compiler"] = "compiler";
-	PluginType$1["Runtime"] = "runtime";
-	return PluginType$1;
+let PluginType = /* @__PURE__ */ function(PluginType) {
+	PluginType["Compiler"] = "compiler";
+	PluginType["Runtime"] = "runtime";
+	return PluginType;
 }({});
 /**
 * Base class for CommandKit plugins.
@@ -68,4 +67,4 @@ Object.defineProperty(exports, 'isPlugin', {
     return isPlugin;
   }
 });
-//# sourceMappingURL=PluginCommon-CPWV5xuX.js.map
+//# sourceMappingURL=PluginCommon-BLxWww5u.js.map

package/dist/{PluginCommon-CPWV5xuX.js.map → PluginCommon-BLxWww5u.js.map}

@@ -1 +1 @@
-{"version":3,"file":"PluginCommon-CPWV5xuX.js","names":[],"sources":["../src/plugins/PluginCommon.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { CommonPluginRuntime } from './plugin-runtime/runtime';\n\n/**\n * The options for a CommandKit plugin.\n */\nexport type PluginOptions = Record<string, any>;\n\n/**\n * Enum representing the type of plugin.\n * - Compiler: A plugin that runs at compile time.\n * - Runtime: A plugin that runs at runtime.\n */\nexport enum PluginType {\n  Compiler = 'compiler',\n  Runtime = 'runtime',\n}\n\n/**\n * Base class for CommandKit plugins.\n */\nexport abstract class PluginCommon<\n  T extends PluginOptions = PluginOptions,\n  C extends CommonPluginRuntime = CommonPluginRuntime,\n> {\n  /**\n   * The type of the plugin, either Compiler or Runtime.\n   */\n  public abstract readonly type: PluginType;\n  /**\n   * Unique identifier for the plugin instance.\n   */\n  public readonly id = randomUUID();\n  /**\n   * The time when the plugin was loaded, in milliseconds since the Unix epoch.\n   */\n  public readonly loadedAt = Date.now();\n  /**\n   * The name of the plugin.\n   */\n  public abstract readonly name: string;\n\n  /**\n   * Creates a new instance of the plugin.\n   */\n  public constructor(protected readonly options: T) {}\n\n  /**\n   * Called when this plugin is activated\n   */\n  public async activate(ctx: C): Promise<void> {}\n\n  /**\n   * Called when this plugin is deactivated\n   */\n  public async deactivate(ctx: C): Promise<void> {}\n}\n\n/**\n * Whether the given object is a CommandKit plugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a plugin.\n */\nexport function isPlugin(\n  plugin: unknown,\n): plugin is PluginCommon<PluginOptions> {\n  return plugin instanceof PluginCommon;\n}\n"],"mappings":";;;;;;;;;;AAaA,IAAY,oDAAL;AACL;AACA;;;;;;AAMF,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB,kCAAiB;;;;CAIjC,AAAgB,WAAW,KAAK,KAAK;;;;CASrC,AAAO,YAAY,AAAmB,SAAY;EAAZ;;;;;CAKtC,MAAa,SAAS,KAAuB;;;;CAK7C,MAAa,WAAW,KAAuB;;;;;;;AAQjD,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB"}
+{"version":3,"file":"PluginCommon-BLxWww5u.js","names":[],"sources":["../src/plugins/PluginCommon.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { CommonPluginRuntime } from './plugin-runtime/runtime';\n\n/**\n * The options for a CommandKit plugin.\n */\nexport type PluginOptions = Record<string, any>;\n\n/**\n * Enum representing the type of plugin.\n * - Compiler: A plugin that runs at compile time.\n * - Runtime: A plugin that runs at runtime.\n */\nexport enum PluginType {\n  Compiler = 'compiler',\n  Runtime = 'runtime',\n}\n\n/**\n * Base class for CommandKit plugins.\n */\nexport abstract class PluginCommon<\n  T extends PluginOptions = PluginOptions,\n  C extends CommonPluginRuntime = CommonPluginRuntime,\n> {\n  /**\n   * The type of the plugin, either Compiler or Runtime.\n   */\n  public abstract readonly type: PluginType;\n  /**\n   * Unique identifier for the plugin instance.\n   */\n  public readonly id = randomUUID();\n  /**\n   * The time when the plugin was loaded, in milliseconds since the Unix epoch.\n   */\n  public readonly loadedAt = Date.now();\n  /**\n   * The name of the plugin.\n   */\n  public abstract readonly name: string;\n\n  /**\n   * Creates a new instance of the plugin.\n   */\n  public constructor(protected readonly options: T) {}\n\n  /**\n   * Called when this plugin is activated\n   */\n  public async activate(ctx: C): Promise<void> {}\n\n  /**\n   * Called when this plugin is deactivated\n   */\n  public async deactivate(ctx: C): Promise<void> {}\n}\n\n/**\n * Whether the given object is a CommandKit plugin.\n * @param plugin The object to check.\n * @returns Boolean indicating whether the object is a plugin.\n */\nexport function isPlugin(\n  plugin: unknown,\n): plugin is PluginCommon<PluginOptions> {\n  return plugin instanceof PluginCommon;\n}\n"],"mappings":";;;;;;;;;AAaA,IAAY,kDAAL;AACL;AACA;;;;;;AAMF,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB,kCAAiB;;;;CAIjC,AAAgB,WAAW,KAAK,KAAK;;;;CASrC,AAAO,YAAY,AAAmB,SAAY;EAAZ;;;;;CAKtC,MAAa,SAAS,KAAuB;;;;CAK7C,MAAa,WAAW,KAAuB;;;;;;;AAQjD,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB"}

package/dist/RoleSelectMenuKit-BY-JJ18w.d.ts

@@ -0,0 +1,66 @@
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-DnwCYit8.js";
+import { RoleSelectMenuBuilder, RoleSelectMenuInteraction } from "discord.js";
+
+//#region src/components/interactive/select-menu/RoleSelectMenuKit.d.ts
+/**
+ * Type for the handler function that is called when the role select menu is submitted.
+ */
+type OnRoleSelectMenuKitSubmit = OnSelectMenuKitSubmit<RoleSelectMenuInteraction, RoleSelectMenuKit>;
+/**
+ * Type for the predicate function that filters role select menu interactions.
+ * It receives a RoleSelectMenuInteraction and returns a boolean or a Promise that resolves to a boolean.
+ */
+type RoleSelectMenuKitPredicate = SelectMenuKitPredicate<RoleSelectMenuInteraction>;
+/**
+ * A builder for creating role select menus with additional features like interaction collectors and event handling.
+ * This class extends the RoleSelectMenuBuilder from discord.js and adds methods for handling interactions.
+ * It allows you to set a handler for when the role select menu is submitted, filter interactions, and handle the end of the interaction collector.
+ */
+declare class RoleSelectMenuKit extends RoleSelectMenuBuilder {
+  #private;
+  /**
+       * Sets the handler to run when the modal is submitted.
+       * @param handler - The handler to run when the modal is submitted.
+       * @param data - The context data for the interaction collector.
+       * @returns This instance of the modal builder.
+       * @example
+       * ```ts
+       * const modal = new RoleSelectMenuKit()
+       *  .setTitle('My Modal')
+       *  .setCustomId('my-modal')
+       *  .filter((interaction) => interaction.Role.id === '1234567890')
+       *  .onSelect(async (interaction) => {
+       *     await interaction.reply('You submitted the modal!');
+       *   })
+       *   .addComponents(actionRow1, actionRow2);
+       * ```
+       */
+  onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<RoleSelectMenuInteraction, RoleSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onError(handler: EventInterceptorErrorHandler): this;
+  /**
+       * Sets a filter for the interaction collector.
+       * @param predicate - The filter to use for the interaction collector.
+       * @returns This instance of the modal builder.
+       */
+  filter(predicate: SelectMenuKitPredicate<RoleSelectMenuInteraction>): this;
+  private get customId();
+  /**
+       * Disposes of the role select menu kit, cleaning up any resources and event listeners.
+       */
+  dispose(): this;
+}
+//#endregion
+export { RoleSelectMenuKit as n, RoleSelectMenuKitPredicate as r, OnRoleSelectMenuKitSubmit as t };
+//# sourceMappingURL=RoleSelectMenuKit-BY-JJ18w.d.ts.map

package/dist/{RuntimePlugin-COeXe8rP.js → RuntimePlugin-CtobluSU.js}

@@ -1,4 +1,4 @@
-const require_PluginCommon = require('./PluginCommon-CPWV5xuX.js');
+const require_PluginCommon = require('./PluginCommon-BLxWww5u.js');
 
 //#region src/plugins/RuntimePlugin.ts
 /**
@@ -131,4 +131,4 @@ Object.defineProperty(exports, 'isRuntimePlugin', {
     return isRuntimePlugin;
   }
 });
-//# sourceMappingURL=RuntimePlugin-COeXe8rP.js.map
+//# sourceMappingURL=RuntimePlugin-CtobluSU.js.map

package/dist/{RuntimePlugin-COeXe8rP.js.map → RuntimePlugin-CtobluSU.js.map}

@@ -1 +1 @@
-{"version":3,"file":"RuntimePlugin-COeXe8rP.js","names":[],"sources":["../src/plugins/RuntimePlugin.ts"],"sourcesContent":["import { Interaction, Message } from 'discord.js';\nimport {\n  isPlugin,\n  PluginCommon,\n  PluginOptions,\n  PluginType,\n} from './PluginCommon';\nimport type { CommandKitPluginRuntime } from './plugin-runtime/CommandKitPluginRuntime';\nimport { CommandBuilderLike, PreparedAppCommandExecution } from '../app';\nimport { CommandKitEnvironment } from '../context/environment';\nimport { CommandKitHMREvent } from '../utils/dev-hooks';\nimport { PreRegisterCommandsEvent } from '../app/register/CommandRegistrar';\nimport { CommandKitEventDispatch } from './types';\n\n/**\n * CommandKit plugin that runs at the runtime.\n */\nexport abstract class RuntimePlugin<\n  T extends PluginOptions = PluginOptions,\n> extends PluginCommon<T, CommandKitPluginRuntime> {\n  public readonly type = PluginType.Runtime;\n  public readonly preload = new Set<string>();\n\n  /**\n   * Called before commands are loaded\n   */\n  public async onBeforeCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands are loaded\n   */\n  public async onAfterCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before events are loaded\n   */\n  public async onBeforeEventsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after events are loaded\n   */\n  public async onAfterEventsLoad(ctx: CommandKitPluginRuntime): Promise<void> {}\n\n  /**\n   * Called before the client logs in\n   */\n  public async onBeforeClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after the client logs in\n   */\n  public async onAfterClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before interaction is handled\n   * @param interaction The interaction\n   */\n  public async onBeforeInteraction(\n    ctx: CommandKitPluginRuntime,\n    interaction: Interaction,\n  ): Promise<void> {}\n\n  /**\n   * Called before message command is processed\n   * @param message The message\n   */\n  public async onBeforeMessageCommand(\n    ctx: CommandKitPluginRuntime,\n    message: Message,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is executed. This method can execute the command itself.\n   * @param source The source that triggered the command\n   * @param command The command\n   * @param execute The function that executes the command\n   */\n  public async executeCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n    source: Interaction | Message,\n    command: PreparedAppCommandExecution,\n    execute: () => Promise<any>,\n  ): Promise<boolean> {\n    return false;\n  }\n\n  /**\n   * Called after events router is initialized\n   * @param ctx The context\n   */\n  public async onEventsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands router is initialized\n   * @param ctx The context\n   */\n  public async onCommandsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called when HMR event is received\n   * @param ctx The context\n   * @param event The event\n   */\n  public async performHMR(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitHMREvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is loaded for registration. This method can be used to modify the command data before it is loaded.\n   * @param ctx The context\n   * @param commands The command that is being loaded. This is a CommandBuilderLike object which represents Discord's command\n   */\n  async prepareCommand(\n    ctx: CommandKitPluginRuntime,\n    commands: CommandBuilderLike,\n  ): Promise<CommandBuilderLike | null> {\n    return null;\n  }\n\n  /**\n   * Called before command is registered to discord. This method can cancel the registration of the command and handle it manually.\n   * @param ctx The context\n   * @param data The command registration data\n   */\n  async onBeforeRegisterCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before global commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGlobalCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called before guilds of the command are resolved. It is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforePrepareGuildCommandsRegistration(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after guilds of the command are resolved. It is called after `onBeforePrepareGuildCommandsRegistration` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGuildCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called after command and all of its deferred functions are executed.\n   * @param ctx The context\n   * @param env The environment of the command. This environment contains the command execution data such as command context and more.\n   */\n  async onAfterCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n  ) {}\n\n  /**\n   * Called before emitting an event\n   * @param ctx The context\n   * @param event The event that is being emitted\n   */\n  public async willEmitEvent(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitEventDispatch,\n  ) {}\n}\n\nexport function isRuntimePlugin(plugin: unknown): plugin is RuntimePlugin {\n  return (\n    plugin instanceof RuntimePlugin ||\n    (isPlugin(plugin) && plugin.type === PluginType.Runtime)\n  );\n}\n"],"mappings":";;;;;;AAiBA,IAAsB,gBAAtB,cAEA,kCAAyC;CACvC,AAAgB,OAAO,gCAAW;CAClC,AAAgB,0BAAU,IAAI,KAAa;;;;CAK3C,MAAa,qBACb,KACgB;;;;CAKhB,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;CAKhB,MAAa,kBAAkB,KAA6C;;;;CAK5E,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,oBACb,KACA,aACgB;;;;;CAMhB,MAAa,uBACb,KACA,SACgB;;;;;;;CAQhB,MAAa,eACb,KACA,KACA,QACA,SACA,SACmB;AACjB,SAAO;;;;;;CAOT,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,qBACb,KACgB;;;;;;CAOhB,MAAa,WACb,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,UACqC;AACnC,SAAO;;;;;;;CAQT,MAAM,yBACN,KACA,OACgB;;;;;;;CAQhB,MAAM,+BACN,KACA,OACgB;;;;;;;CAQhB,MAAM,yCACN,KACA,OACgB;;;;;;;CAQhB,MAAM,8BACN,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,KACA;;;;;;CAOA,MAAa,cACb,KACA,OACA;;AAGF,SAAgB,gBAAgB,QAA0C;AACxE,QACE,kBAAkB,iBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}
+{"version":3,"file":"RuntimePlugin-CtobluSU.js","names":[],"sources":["../src/plugins/RuntimePlugin.ts"],"sourcesContent":["import { Interaction, Message } from 'discord.js';\nimport {\n  isPlugin,\n  PluginCommon,\n  PluginOptions,\n  PluginType,\n} from './PluginCommon';\nimport type { CommandKitPluginRuntime } from './plugin-runtime/CommandKitPluginRuntime';\nimport { CommandBuilderLike, PreparedAppCommandExecution } from '../app';\nimport { CommandKitEnvironment } from '../context/environment';\nimport { CommandKitHMREvent } from '../utils/dev-hooks';\nimport { PreRegisterCommandsEvent } from '../app/register/CommandRegistrar';\nimport { CommandKitEventDispatch } from './types';\n\n/**\n * CommandKit plugin that runs at the runtime.\n */\nexport abstract class RuntimePlugin<\n  T extends PluginOptions = PluginOptions,\n> extends PluginCommon<T, CommandKitPluginRuntime> {\n  public readonly type = PluginType.Runtime;\n  public readonly preload = new Set<string>();\n\n  /**\n   * Called before commands are loaded\n   */\n  public async onBeforeCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands are loaded\n   */\n  public async onAfterCommandsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before events are loaded\n   */\n  public async onBeforeEventsLoad(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after events are loaded\n   */\n  public async onAfterEventsLoad(ctx: CommandKitPluginRuntime): Promise<void> {}\n\n  /**\n   * Called before the client logs in\n   */\n  public async onBeforeClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after the client logs in\n   */\n  public async onAfterClientLogin(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called before interaction is handled\n   * @param interaction The interaction\n   */\n  public async onBeforeInteraction(\n    ctx: CommandKitPluginRuntime,\n    interaction: Interaction,\n  ): Promise<void> {}\n\n  /**\n   * Called before message command is processed\n   * @param message The message\n   */\n  public async onBeforeMessageCommand(\n    ctx: CommandKitPluginRuntime,\n    message: Message,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is executed. This method can execute the command itself.\n   * @param source The source that triggered the command\n   * @param command The command\n   * @param execute The function that executes the command\n   */\n  public async executeCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n    source: Interaction | Message,\n    command: PreparedAppCommandExecution,\n    execute: () => Promise<any>,\n  ): Promise<boolean> {\n    return false;\n  }\n\n  /**\n   * Called after events router is initialized\n   * @param ctx The context\n   */\n  public async onEventsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called after commands router is initialized\n   * @param ctx The context\n   */\n  public async onCommandsRouterInit(\n    ctx: CommandKitPluginRuntime,\n  ): Promise<void> {}\n\n  /**\n   * Called when HMR event is received\n   * @param ctx The context\n   * @param event The event\n   */\n  public async performHMR(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitHMREvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before command is loaded for registration. This method can be used to modify the command data before it is loaded.\n   * @param ctx The context\n   * @param commands The command that is being loaded. This is a CommandBuilderLike object which represents Discord's command\n   */\n  async prepareCommand(\n    ctx: CommandKitPluginRuntime,\n    commands: CommandBuilderLike,\n  ): Promise<CommandBuilderLike | null> {\n    return null;\n  }\n\n  /**\n   * Called before command is registered to discord. This method can cancel the registration of the command and handle it manually.\n   * @param ctx The context\n   * @param data The command registration data\n   */\n  async onBeforeRegisterCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before global commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGlobalCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called before guilds of the command are resolved. It is called after `onBeforeRegisterCommands` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforePrepareGuildCommandsRegistration(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called before guild commands registration. This method can cancel the registration of the command and handle it manually.\n   * This method is called after guilds of the command are resolved. It is called after `onBeforePrepareGuildCommandsRegistration` if that stage was not handled.\n   * @param ctx The context\n   * @param event The command registration data\n   */\n  async onBeforeRegisterGuildCommands(\n    ctx: CommandKitPluginRuntime,\n    event: PreRegisterCommandsEvent,\n  ): Promise<void> {}\n\n  /**\n   * Called after command and all of its deferred functions are executed.\n   * @param ctx The context\n   * @param env The environment of the command. This environment contains the command execution data such as command context and more.\n   */\n  async onAfterCommand(\n    ctx: CommandKitPluginRuntime,\n    env: CommandKitEnvironment,\n  ) {}\n\n  /**\n   * Called before emitting an event\n   * @param ctx The context\n   * @param event The event that is being emitted\n   */\n  public async willEmitEvent(\n    ctx: CommandKitPluginRuntime,\n    event: CommandKitEventDispatch,\n  ) {}\n}\n\nexport function isRuntimePlugin(plugin: unknown): plugin is RuntimePlugin {\n  return (\n    plugin instanceof RuntimePlugin ||\n    (isPlugin(plugin) && plugin.type === PluginType.Runtime)\n  );\n}\n"],"mappings":";;;;;;AAiBA,IAAsB,gBAAtB,cAEA,kCAA0B;CACxB,AAAgB,OAAO,gCAAW;CAClC,AAAgB,0BAAU,IAAI,KAAa;;;;CAK3C,MAAa,qBACb,KACgB;;;;CAKhB,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;CAKhB,MAAa,kBAAkB,KAA6C;;;;CAK5E,MAAa,oBACb,KACgB;;;;CAKhB,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,oBACb,KACA,aACgB;;;;;CAMhB,MAAa,uBACb,KACA,SACgB;;;;;;;CAQhB,MAAa,eACb,KACA,KACA,QACA,SACA,SACmB;AACjB,SAAO;;;;;;CAOT,MAAa,mBACb,KACgB;;;;;CAMhB,MAAa,qBACb,KACgB;;;;;;CAOhB,MAAa,WACb,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,UACqC;AACnC,SAAO;;;;;;;CAQT,MAAM,yBACN,KACA,OACgB;;;;;;;CAQhB,MAAM,+BACN,KACA,OACgB;;;;;;;CAQhB,MAAM,yCACN,KACA,OACgB;;;;;;;CAQhB,MAAM,8BACN,KACA,OACgB;;;;;;CAOhB,MAAM,eACN,KACA,KACA;;;;;;CAOA,MAAa,cACb,KACA,OACA;;AAGF,SAAgB,gBAAgB,QAA0C;AACxE,QACE,kBAAkB,iBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW"}

package/dist/{SelectMenu-VcDhOGoJ.d.ts → SelectMenu-q_b3Mjv9.d.ts}

@@ -1,14 +1,13 @@
-import { MaybeArray } from "./types-CJ-XvOFN.js";
-import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd } from "./common-DHTTnX82.js";
-import { StringSelectMenuKit } from "./StringSelectMenuKit-CJ0MzUZJ.js";
-import { ChannelSelectMenuKit } from "./ChannelSelectMenuKit-CsYgIyKe.js";
-import { MentionableSelectMenuKit } from "./MentionableSelectMenuKit-CO9phWMf.js";
-import { UserSelectMenuKit } from "./UserSelectMenuKit-C_J-9RJs.js";
-import { RoleSelectMenuKit } from "./RoleSelectMenuKit-DvBxzpWh.js";
+import { t as MaybeArray } from "./types-BywA9d2Z.js";
+import { n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-DnwCYit8.js";
+import { n as StringSelectMenuKit } from "./StringSelectMenuKit-lVhUMc3g.js";
+import { t as ChannelSelectMenuKit } from "./ChannelSelectMenuKit-HQZ4hH5s.js";
+import { t as MentionableSelectMenuKit } from "./MentionableSelectMenuKit-7URDUM3-.js";
+import { n as UserSelectMenuKit } from "./UserSelectMenuKit-CCj4Fpkr.js";
+import { n as RoleSelectMenuKit } from "./RoleSelectMenuKit-BY-JJ18w.js";
 import { APISelectMenuOption, BaseSelectMenuComponentData, ChannelSelectMenuComponentData, ChannelSelectMenuInteraction, MentionableSelectMenuComponentData, MentionableSelectMenuInteraction, RoleSelectMenuComponentData, RoleSelectMenuInteraction, SelectMenuComponentOptionData, StringSelectMenuInteraction, StringSelectMenuOptionBuilder, UserSelectMenuComponentData, UserSelectMenuInteraction } from "discord.js";
 
 //#region src/components/interactive/select-menu/SelectMenu.d.ts
-
 /**
  * Type for the common properties shared by all select menu builders.
  */
@@ -133,5 +132,5 @@ interface ChannelSelectMenuProps extends Partial<Omit<ChannelSelectMenuComponent
  */
 declare function ChannelSelectMenu(props: ChannelSelectMenuProps): ChannelSelectMenuKit;
 //#endregion
-export { ChannelSelectMenu, ChannelSelectMenuProps, CommonBuilderKit, CommonSelectMenuProps, MentionableSelectMenu, MentionableSelectMenuProps, ResolveBuilderInteraction, RoleSelectMenu, RoleSelectMenuProps, SelectMenuProps, StringSelectMenu, StringSelectMenuOption, StringSelectMenuOptionProps, StringSelectMenuProps, UserSelectMenu, UserSelectMenuProps };
-//# sourceMappingURL=SelectMenu-VcDhOGoJ.d.ts.map
+export { MentionableSelectMenu as a, RoleSelectMenu as c, StringSelectMenu as d, StringSelectMenuOption as f, UserSelectMenuProps as g, UserSelectMenu as h, CommonSelectMenuProps as i, RoleSelectMenuProps as l, StringSelectMenuProps as m, ChannelSelectMenuProps as n, MentionableSelectMenuProps as o, StringSelectMenuOptionProps as p, CommonBuilderKit as r, ResolveBuilderInteraction as s, ChannelSelectMenu as t, SelectMenuProps as u };
+//# sourceMappingURL=SelectMenu-q_b3Mjv9.d.ts.map

package/dist/StringSelectMenuKit-lVhUMc3g.d.ts

@@ -0,0 +1,66 @@
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-CZmWpS08.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-DnwCYit8.js";
+import { StringSelectMenuBuilder, StringSelectMenuInteraction } from "discord.js";
+
+//#region src/components/interactive/select-menu/StringSelectMenuKit.d.ts
+/**
+ * Type for the handler function that is called when the string select menu is submitted.
+ */
+type OnStringSelectMenuKitSubmit = OnSelectMenuKitSubmit<StringSelectMenuInteraction, StringSelectMenuKit>;
+/**
+ * Type for the predicate function that filters string select menu interactions.
+ * It receives a StringSelectMenuInteraction and returns a boolean or a Promise that resolves to a boolean.
+ */
+type StringSelectMenuKitPredicate = SelectMenuKitPredicate<StringSelectMenuInteraction>;
+/**
+ * A builder for creating string select menus with additional features like interaction collectors and event handling.
+ * This class extends the StringSelectMenuBuilder from discord.js and adds methods for handling interactions.
+ * It allows you to set a handler for when the string select menu is submitted, filter interactions, and handle the end of the interaction collector.
+ */
+declare class StringSelectMenuKit extends StringSelectMenuBuilder {
+  #private;
+  /**
+       * Sets the handler to run when the modal is submitted.
+       * @param handler - The handler to run when the modal is submitted.
+       * @param data - The context data for the interaction collector.
+       * @returns This instance of the modal builder.
+       * @example
+       * ```ts
+       * const modal = new StringSelectMenuKit()
+       *  .setTitle('My Modal')
+       *  .setCustomId('my-modal')
+       *  .filter((interaction) => interaction.user.id === '1234567890')
+       *  .onSelect(async (interaction) => {
+       *     await interaction.reply('You submitted the modal!');
+       *   })
+       *   .addComponents(actionRow1, actionRow2);
+       * ```
+       */
+  onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<StringSelectMenuInteraction, StringSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+  /**
+       * Sets the handler to run when the interaction collector ends.
+       * @param handler - The handler to run when the interaction collector ends.
+       * @returns This instance of the modal builder.
+       */
+  onError(handler: EventInterceptorErrorHandler): this;
+  /**
+       * Sets a filter for the interaction collector.
+       * @param predicate - The filter to use for the interaction collector.
+       * @returns This instance of the modal builder.
+       */
+  filter(predicate: SelectMenuKitPredicate<StringSelectMenuInteraction>): this;
+  private get customId();
+  /**
+       * Disposes of the interaction collector and cleans up resources.
+       */
+  dispose(): this;
+}
+//#endregion
+export { StringSelectMenuKit as n, StringSelectMenuKitPredicate as r, OnStringSelectMenuKitSubmit as t };
+//# sourceMappingURL=StringSelectMenuKit-lVhUMc3g.d.ts.map