commandkit 1.0.0-dev.20250611020404 → 1.0.0-dev.20250611155146

package/dist/MessageCommandParser-ROLibZPX.d.ts

@@ -0,0 +1,195 @@
+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
+   * @param schema - Function that returns the options schema for a command
+   */
+  constructor(message: Message, prefix: string[], 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 { MessageCommandOptions, MessageCommandOptionsSchema, MessageCommandParser, ParsedMessageCommand };
+//# sourceMappingURL=MessageCommandParser-ROLibZPX.d.ts.map

package/dist/{Modal-Cxm6cs5c.d.ts → Modal-C6UTRdYQ.d.ts}

@@ -1,10 +1,14 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
-import { CommandKitModalBuilderInteractionCollectorDispatchContextData, OnModalKitEnd, OnModalKitSubmit } from "./ModalKit-CKtQ8eXW.js";
-import { CommandKitElement } from "./element-D_nyVwgB.js";
+import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { CommandKitModalBuilderInteractionCollectorDispatchContextData, OnModalKitEnd, OnModalKitSubmit } from "./ModalKit-Btz58KYn.js";
+import { CommandKitElement } from "./element-CAXu1XtK.js";
 import { MaybeArray } from "./types-CJ-XvOFN.js";
 import { ActionRowBuilder, TextInputBuilder, TextInputStyle } from "discord.js";
 
 //#region src/components/v1/modal/Modal.d.ts
+
+/**
+ * The properties for the modal component.
+ */
 interface ModalProps {
   customId?: string;
   title: string;
@@ -55,4 +59,4 @@ declare function ShortInput(props: TextInputProps): CommandKitElement<'text-inpu
 declare function ParagraphInput(props: TextInputProps): CommandKitElement<'text-input'>;
 //#endregion
 export { Modal, ModalProps, ParagraphInput, ShortInput, TextInput, TextInputProps };
-//# sourceMappingURL=Modal-Cxm6cs5c.d.ts.map
+//# sourceMappingURL=Modal-C6UTRdYQ.d.ts.map

package/dist/{ModalKit-CKtQ8eXW.d.ts → ModalKit-Btz58KYn.d.ts}

@@ -1,7 +1,12 @@
-import { EventInterceptorContextData, EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
+import { EventInterceptorContextData, EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
 import { Awaitable, Events, ModalBuilder, ModalSubmitInteraction } from "discord.js";
 
 //#region src/components/v1/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.
+ */
 type ModalKitPredicate = (interaction: ModalSubmitInteraction) => Awaitable<boolean>;
 /**
  * The handler to run when a modal is submitted. This handler is called with the interaction as the first argument.
@@ -18,8 +23,21 @@ type OnModalKitEnd = CommandKitModalBuilderOnEnd;
  * If the first argument is null, it means that the interaction collector has been destroyed.
  */
 type CommandKitModalBuilderInteractionCollectorDispatch = (interaction: ModalSubmitInteraction, context: ModalKit) => Awaitable<void>;
+/**
+ * The handler to run when the interaction collector ends. This handler is called with the reason as the first argument.
+ * If the first argument is null, it means that the interaction collector has been destroyed.
+ */
 type CommandKitModalBuilderOnEnd = (reason: string) => Awaitable<void>;
+/**
+ * The context data for the interaction collector.
+ * This includes the autoReset, time, filter, onEnd, and onError properties.
+ */
 type CommandKitModalBuilderInteractionCollectorDispatchContextData = EventInterceptorContextData<Events.InteractionCreate>;
+/**
+ * A builder for creating modals with additional features like interaction collectors and event handling.
+ * This class extends the ModalBuilder from discord.js and adds methods for handling interactions.
+ * It allows you to set a handler for when the modal is submitted, filter interactions, and handle the end of the interaction collector.
+ */
 declare class ModalKit extends ModalBuilder {
   #private;
   /**
@@ -59,8 +77,11 @@ declare class ModalKit extends ModalBuilder {
    */
   filter(predicate: ModalKitPredicate): this;
   private get customId();
+  /**
+   * Disposes of the modal collector and cleans up resources.
+   */
   dispose(): this;
 }
 //#endregion
 export { CommandKitModalBuilderInteractionCollectorDispatch, CommandKitModalBuilderInteractionCollectorDispatchContextData, CommandKitModalBuilderOnEnd, ModalKit, ModalKitPredicate, OnModalKitEnd, OnModalKitSubmit };
-//# sourceMappingURL=ModalKit-CKtQ8eXW.d.ts.map
+//# sourceMappingURL=ModalKit-Btz58KYn.d.ts.map

package/dist/{PluginCommon-DPqnQngK.js → PluginCommon-D_Z8Oiic.js}

@@ -2,14 +2,31 @@ const require_chunk = require('./chunk-nOFOJqeH.js');
 const node_crypto = require_chunk.__toESM(require("node:crypto"));
 
 //#region src/plugins/PluginCommon.ts
+/**
+* Enum representing the type of plugin.
+* - 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;
 }({});
+/**
+* Base class for CommandKit plugins.
+*/
 var PluginCommon = class {
+	/**
+	* Unique identifier for the plugin instance.
+	*/
 	id = (0, node_crypto.randomUUID)();
+	/**
+	* The time when the plugin was loaded, in milliseconds since the Unix epoch.
+	*/
 	loadedAt = Date.now();
+	/**
+	* Creates a new instance of the plugin.
+	*/
 	constructor(options) {
 		this.options = options;
 	}
@@ -22,6 +39,11 @@ var PluginCommon = class {
 	*/
 	async deactivate(ctx) {}
 };
+/**
+* Whether the given object is a CommandKit plugin.
+* @param plugin The object to check.
+* @returns Boolean indicating whether the object is a plugin.
+*/
 function isPlugin(plugin) {
 	return plugin instanceof PluginCommon;
 }
@@ -45,4 +67,4 @@ Object.defineProperty(exports, 'isPlugin', {
     return isPlugin;
   }
 });
-//# sourceMappingURL=PluginCommon-DPqnQngK.js.map
+//# sourceMappingURL=PluginCommon-D_Z8Oiic.js.map

package/dist/PluginCommon-D_Z8Oiic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginCommon-D_Z8Oiic.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;;AACF;;;;AAKA,IAAsB,eAAtB,MAGA;;;;CAQE,AAAgB,KAAK,6BAAY;;;;CAIjC,AAAgB,WAAW,KAAK,KAAK;;;;CASrC,AAAO,YAA+B,SAAY;EAAZ;CAAa;;;;CAKnD,MAAa,SAAS,KAAuB,CAAC;;;;CAK9C,MAAa,WAAW,KAAuB,CAAC;AAClD;;;;;;AAOA,SAAgB,SAChB,QACwC;AACtC,QAAO,kBAAkB;AAC3B"}

package/dist/{RoleSelectMenuKit-BSMKkru2.d.ts → RoleSelectMenuKit-C26lU3sN.d.ts}

@@ -1,10 +1,23 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
-import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-pvPJVTfe.js";
+import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-DOCvOVC4.js";
 import { RoleSelectMenuBuilder, RoleSelectMenuInteraction } from "discord.js";
 
 //#region src/components/v1/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;
   /**
@@ -44,8 +57,11 @@ declare class RoleSelectMenuKit extends RoleSelectMenuBuilder {
    */
   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 { OnRoleSelectMenuKitSubmit, RoleSelectMenuKit, RoleSelectMenuKitPredicate };
-//# sourceMappingURL=RoleSelectMenuKit-BSMKkru2.d.ts.map
+//# sourceMappingURL=RoleSelectMenuKit-C26lU3sN.d.ts.map

package/dist/{RuntimePlugin-BJoDa8ZR.js → RuntimePlugin-CehKbceZ.js}

@@ -1,6 +1,9 @@
-const require_PluginCommon = require('./PluginCommon-DPqnQngK.js');
+const require_PluginCommon = require('./PluginCommon-D_Z8Oiic.js');
 
 //#region src/plugins/RuntimePlugin.ts
+/**
+* CommandKit plugin that runs at the runtime.
+*/
 var RuntimePlugin = class extends require_PluginCommon.PluginCommon {
 	type = require_PluginCommon.PluginType.Runtime;
 	/**
@@ -127,4 +130,4 @@ Object.defineProperty(exports, 'isRuntimePlugin', {
     return isRuntimePlugin;
   }
 });
-//# sourceMappingURL=RuntimePlugin-BJoDa8ZR.js.map
+//# sourceMappingURL=RuntimePlugin-CehKbceZ.js.map

package/dist/RuntimePlugin-CehKbceZ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimePlugin-CehKbceZ.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  /**\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;;;;CAIlC,MAAa,qBACb,KACgB,CAAE;;;;CAKlB,MAAa,oBACb,KACgB,CAAE;;;;CAKlB,MAAa,mBACb,KACgB,CAAE;;;;CAKlB,MAAa,kBAAkB,KAA6C,CAAC;;;;CAK7E,MAAa,oBACb,KACgB,CAAE;;;;CAKlB,MAAa,mBACb,KACgB,CAAE;;;;;CAMlB,MAAa,oBACb,KACA,aACgB,CAAE;;;;;CAMlB,MAAa,uBACb,KACA,SACgB,CAAE;;;;;;;CAQlB,MAAa,eACb,KACA,KACA,QACA,SACA,SACmB;AACjB,SAAO;CACT;;;;;CAMA,MAAa,mBACb,KACgB,CAAE;;;;;CAMlB,MAAa,qBACb,KACgB,CAAE;;;;;;CAOlB,MAAa,WACb,KACA,OACgB,CAAE;;;;;;CAOlB,MAAM,eACN,KACA,UACqC;AACnC,SAAO;CACT;;;;;;CAOA,MAAM,yBACN,KACA,OACgB,CAAE;;;;;;;CAQlB,MAAM,+BACN,KACA,OACgB,CAAE;;;;;;;CAQlB,MAAM,yCACN,KACA,OACgB,CAAE;;;;;;;CAQlB,MAAM,8BACN,KACA,OACgB,CAAE;;;;;;CAOlB,MAAM,eACN,KACA,KACA,CAAE;;;;;;CAOF,MAAa,cACb,KACA,OACA,CAAE;AACJ;AAEA,SAAgB,gBAAgB,QAA0C;AACxE,QACE,kBAAkB,iBAClB,8BAAS,OAAO,IAAI,OAAO,SAAS,gCAAW;AAEnD"}

package/dist/SelectMenu-Diy87_ba.d.ts

@@ -0,0 +1,137 @@
+import { MaybeArray } from "./types-CJ-XvOFN.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd } from "./common-DOCvOVC4.js";
+import { StringSelectMenuKit } from "./StringSelectMenuKit-Bhs8U6WI.js";
+import { ChannelSelectMenuKit } from "./ChannelSelectMenuKit-BrXvBYNH.js";
+import { MentionableSelectMenuKit } from "./MentionableSelectMenuKit-CPTKqx-O.js";
+import { UserSelectMenuKit } from "./UserSelectMenuKit-CfqFJdxz.js";
+import { RoleSelectMenuKit } from "./RoleSelectMenuKit-C26lU3sN.js";
+import { APISelectMenuOption, BaseSelectMenuComponentData, ChannelSelectMenuComponentData, ChannelSelectMenuInteraction, MentionableSelectMenuComponentData, MentionableSelectMenuInteraction, RoleSelectMenuComponentData, RoleSelectMenuInteraction, SelectMenuComponentOptionData, StringSelectMenuInteraction, StringSelectMenuOptionBuilder, UserSelectMenuComponentData, UserSelectMenuInteraction } from "discord.js";
+
+//#region src/components/v1/select-menu/SelectMenu.d.ts
+
+/**
+ * Type for the common properties shared by all select menu builders.
+ */
+interface CommonSelectMenuProps<T, C> {
+  onSelect?: CommandKitSelectMenuBuilderInteractionCollectorDispatch<T, C>;
+  onEnd?: CommandKitSelectMenuBuilderOnEnd;
+  onError?: (error: Error) => any;
+  options?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData;
+}
+/**
+ * Type for the base select menu component data.
+ */
+interface SelectMenuProps<T, C> extends Partial<Omit<BaseSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<T, C> {}
+/**
+ * The properties for a string select menu component.
+ */
+interface StringSelectMenuProps extends SelectMenuProps<StringSelectMenuInteraction, StringSelectMenuKit> {
+  children?: MaybeArray<StringSelectMenuOptionBuilder>;
+}
+/**
+ * Type for the common builder kit that can be used with select menus.
+ */
+type CommonBuilderKit = StringSelectMenuKit | UserSelectMenuKit | RoleSelectMenuKit | ChannelSelectMenuKit | MentionableSelectMenuKit;
+/**
+ * Type that resolves to the specific interaction type based on the builder type.
+ * This is used to ensure that the interaction type matches the builder type.
+ * For example, if the builder is a StringSelectMenuKit, the interaction type will be StringSelectMenuInteraction.
+ * If the builder is a UserSelectMenuKit, the interaction type will be UserSelectMenuInteraction, and so on.
+ */
+type ResolveBuilderInteraction<T> = T extends StringSelectMenuKit ? StringSelectMenuInteraction : T extends UserSelectMenuKit ? UserSelectMenuInteraction : T extends RoleSelectMenuKit ? RoleSelectMenuInteraction : T extends ChannelSelectMenuKit ? ChannelSelectMenuInteraction : T extends MentionableSelectMenuKit ? MentionableSelectMenuInteraction : never;
+/**
+ * The StringSelectMenu component.
+ * @param props The properties for the string select menu component.
+ * @returns The string select menu builder instance.
+ * @example ```tsx
+ * import { StringSelectMenu } from 'commandkit';
+ *
+ * const stringSelectMenu = <StringSelectMenu
+ *   customId="my-select-menu"
+ *   placeholder="Select an option"
+ *   maxValues={1}
+ *   minValues={1}
+ * >
+ *   <StringSelectMenuOption label="Option 1" value="option1" />
+ *   <StringSelectMenuOption label="Option 2" value="option2" />
+ * </StringSelectMenu>
+ * ```
+ */
+declare function StringSelectMenu(props: StringSelectMenuProps): StringSelectMenuKit;
+/**
+ * Represents the properties for a string select menu option.
+ * This can be either a SelectMenuComponentOptionData or an APISelectMenuOption.
+ */
+type StringSelectMenuOptionProps = SelectMenuComponentOptionData | APISelectMenuOption;
+/**
+ * A select menu option for the string select menu.
+ * @param props The properties for the string select menu option.
+ * @returns The string select menu option builder instance.
+ * @example ```tsx
+ * import { StringSelectMenuOption } from 'commandkit';
+ *
+ * const option = <StringSelectMenuOption label="Option 1" value="option1" />;
+ * ```
+ */
+declare function StringSelectMenuOption(props: StringSelectMenuOptionProps): StringSelectMenuOptionBuilder;
+/**
+ * The UserSelectMenu component.
+ */
+interface UserSelectMenuProps extends Partial<Omit<UserSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<UserSelectMenuInteraction, UserSelectMenuKit> {}
+/**
+ * The UserSelectMenu component.
+ * @param props The properties for the user select menu component.
+ * @returns The user select menu builder instance.
+ * @example ```tsx
+ * import { UserSelectMenu } from 'commandkit';
+ *
+ * const userSelectMenu = <UserSelectMenu />
+ * ```
+ */
+declare function UserSelectMenu(props: UserSelectMenuProps): UserSelectMenuKit;
+/**
+ * The RoleSelectMenu component props.
+ */
+interface RoleSelectMenuProps extends Partial<Omit<RoleSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<RoleSelectMenuInteraction, RoleSelectMenuKit> {}
+/**
+ * The RoleSelectMenu component.
+ * @param props The properties for the role select menu component.
+ * @returns The role select menu builder instance.
+ * @example ```tsx
+ * import { RoleSelectMenu } from 'commandkit';
+ *
+ * const roleSelectMenu = <RoleSelectMenu />
+ * ```
+ */
+declare function RoleSelectMenu(props: RoleSelectMenuProps): RoleSelectMenuKit;
+/**
+ * The MentionableSelectMenu component props.
+ */
+interface MentionableSelectMenuProps extends Partial<Omit<MentionableSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<MentionableSelectMenuInteraction, MentionableSelectMenuKit> {}
+/**
+ * The MentionableSelectMenu component.
+ * @param props The properties for the mentionable select menu component.
+ * @returns The mentionable select menu builder instance.
+ * @example ```tsx
+ * import { MentionableSelectMenu } from 'commandkit';
+ * const mentionableSelectMenu = <MentionableSelectMenu />
+ * ```
+ */
+declare function MentionableSelectMenu(props: MentionableSelectMenuProps): MentionableSelectMenuKit;
+/**
+ * The ChannelSelectMenu component props.
+ */
+interface ChannelSelectMenuProps extends Partial<Omit<ChannelSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<ChannelSelectMenuInteraction, ChannelSelectMenuKit> {}
+/**
+ * The ChannelSelectMenu component.
+ * @param props The properties for the channel select menu component.
+ * @returns The channel select menu builder instance.
+ * @example ```tsx
+ * import { ChannelSelectMenu } from 'commandkit';
+ * const channelSelectMenu = <ChannelSelectMenu />
+ * ```
+ */
+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-Diy87_ba.d.ts.map

package/dist/{StringSelectMenuKit-B9FHTe48.d.ts → StringSelectMenuKit-Bhs8U6WI.d.ts}

@@ -1,10 +1,23 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
-import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-pvPJVTfe.js";
+import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-DOCvOVC4.js";
 import { StringSelectMenuBuilder, StringSelectMenuInteraction } from "discord.js";
 
 //#region src/components/v1/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;
   /**
@@ -44,8 +57,11 @@ declare class StringSelectMenuKit extends StringSelectMenuBuilder {
    */
   filter(predicate: SelectMenuKitPredicate<StringSelectMenuInteraction>): this;
   private get customId();
+  /**
+   * Disposes of the interaction collector and cleans up resources.
+   */
   dispose(): this;
 }
 //#endregion
 export { OnStringSelectMenuKitSubmit, StringSelectMenuKit, StringSelectMenuKitPredicate };
-//# sourceMappingURL=StringSelectMenuKit-B9FHTe48.d.ts.map
+//# sourceMappingURL=StringSelectMenuKit-Bhs8U6WI.d.ts.map

package/dist/{UserSelectMenuKit-DiP0imyo.d.ts → UserSelectMenuKit-CfqFJdxz.d.ts}

@@ -1,10 +1,23 @@
-import { EventInterceptorErrorHandler } from "./EventInterceptor-D_oEWSnF.js";
-import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-pvPJVTfe.js";
+import { EventInterceptorErrorHandler } from "./EventInterceptor-x-R2qshQ.js";
+import { CommandKitSelectMenuBuilderInteractionCollectorDispatch, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, CommandKitSelectMenuBuilderOnEnd, OnSelectMenuKitSubmit, SelectMenuKitPredicate } from "./common-DOCvOVC4.js";
 import { UserSelectMenuBuilder, UserSelectMenuInteraction } from "discord.js";
 
 //#region src/components/v1/select-menu/UserSelectMenuKit.d.ts
+
+/**
+ * Type for the handler function that is called when the user select menu is submitted.
+ */
 type OnUserSelectMenuKitSubmit = OnSelectMenuKitSubmit<UserSelectMenuInteraction, UserSelectMenuKit>;
+/**
+ * Type for the predicate function that filters user select menu interactions.
+ * It receives a UserSelectMenuInteraction and returns a boolean or a Promise that resolves to a boolean.
+ */
 type UserSelectMenuKitPredicate = SelectMenuKitPredicate<UserSelectMenuInteraction>;
+/**
+ * A builder for creating user select menus with additional features like interaction collectors and event handling.
+ * This class extends the UserSelectMenuBuilder from discord.js and adds methods for handling interactions.
+ * It allows you to set a handler for when the user select menu is submitted, filter interactions, and handle the end of the interaction collector.
+ */
 declare class UserSelectMenuKit extends UserSelectMenuBuilder {
   #private;
   /**
@@ -44,8 +57,11 @@ declare class UserSelectMenuKit extends UserSelectMenuBuilder {
    */
   filter(predicate: SelectMenuKitPredicate<UserSelectMenuInteraction>): this;
   private get customId();
+  /**
+   * Disposes of the user select menu kit, cleaning up any collectors and handlers.
+   */
   dispose(): this;
 }
 //#endregion
 export { OnUserSelectMenuKitSubmit, UserSelectMenuKit, UserSelectMenuKitPredicate };
-//# sourceMappingURL=UserSelectMenuKit-DiP0imyo.d.ts.map
+//# sourceMappingURL=UserSelectMenuKit-CfqFJdxz.d.ts.map