commandkit 0.1.6-dev.20231113071041 → 0.1.6-dev.20231124164938

package/dist/index.d.mts

@@ -1,70 +1,228 @@
 import { CommandInteraction, Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, PermissionsString, APIApplicationCommandOption, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
 
+/**
+ * Base props for commands.
+ */
 interface CommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: CommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The main CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for slash command run functions.
+ */
 interface SlashCommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: ChatInputCommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for context menu command run functions.
+ */
 interface ContextMenuCommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: ContextMenuCommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for command validations.
+ */
 interface ValidationFunctionProps {
+    /**
+     * Represents the command's interaction.
+     * Either a slash command or a context menu command interaction.
+     */
     interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction;
+    /**
+     * The client created in your main file.
+     * Represented as a ready client (`Client<true>`).
+     */
     client: Client<true>;
+    /**
+     * The command object that is being validated.
+     */
     commandObj: CommandObject;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Configuration for commands.
+ */
 interface CommandOptions {
+    /**
+     * Boolean indicating whether the command is guild-only.
+     * @deprecated - Use `dm_permission` in the command's data instead.
+     */
     guildOnly?: boolean;
+    /**
+     * Boolean indicating whether the command is developer only.
+     */
     devOnly?: boolean;
+    /**
+     * Boolean indicating whether the command is deleted and should not be registered.
+     */
     deleted?: boolean;
+    /**
+     * An array of user permissions.
+     *
+     * @example
+     * userPermissions: ['BanMembers']
+     */
     userPermissions?: PermissionsString[];
+    /**
+     * An array of bot permissions.
+     *
+     * @example
+     * botPermissions: ['BanMembers']
+     */
     botPermissions?: PermissionsString[];
     [key: string]: any;
 }
 declare enum CommandType {
+    /**
+     * Slash commands.
+     */
     'ChatInput' = 1,
+    /**
+     * Message context menu commands.
+     */
     'Message' = 3,
+    /**
+     * User context menu commands.
+     */
     'User' = 2
 }
 type LocaleString = 'id' | `en-${'GB' | 'US'}` | 'bg' | `zh-${'CN' | 'TW'}` | 'hr' | 'cs' | 'da' | 'nl' | 'fi' | 'fr' | 'de' | 'el' | 'hi' | 'hu' | 'it' | 'ja' | 'ko' | 'lt' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'es-ES' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi';
+/**
+ * Common items for command data.
+ */
 type BaseCommandData = {
+    /**
+     * The name of the command.
+     */
     name: string;
+    /**
+     * The type of the command.
+     */
     type?: CommandType;
+    /**
+     * i18n for the command name.
+     */
     name_localizations?: Partial<Record<LocaleString, string | null>>;
+    /**
+     * Whether to allow this command in DMs.
+     */
     dm_permission?: boolean;
+    /**
+     * Default permissions for members for the command.
+     */
     default_member_permissions?: string;
+    /**
+     * Whether the command is age-restricted.
+     */
     nsfw?: boolean;
 };
+/**
+ * Data for chat input commands.
+ */
 type ChatInputCommandData = BaseCommandData & {
+    /**
+     * The command's type.
+     */
     type?: CommandType.ChatInput;
+    /**
+     * The description of the command.
+     */
     description: string;
+    /**
+     * i18n for the command description.
+     */
     description_localizations?: Partial<Record<LocaleString, string | null>>;
+    /**
+     * Chat input command options.
+     */
     options?: Array<APIApplicationCommandOption>;
 };
+/**
+ * Represents any context menu command data.
+ */
 type UserOrMessageCommandData = BaseCommandData & {
     type: CommandType.User | CommandType.Message;
 };
 type CommandData = ChatInputCommandData | UserOrMessageCommandData;
 type CommandObject = {
+    /**
+     * Command data which is a slash command builder or raw JSON data.
+     * @example
+     * {
+     *      name: 'ping',
+     *      description: 'Replies with Pong!'
+     * }
+     */
     data: CommandData;
+    /**
+     * CommandKit command options.
+     * @example
+     * {
+     *      devOnly: true,
+     *      userPermissions: ['ManageGuild'],
+     *      botPermissions: ['ManageGuild'],
+     * }
+     */
     options?: CommandOptions;
+    /**
+     * The path to the command file.
+     */
     filePath: string;
+    /**
+     * The command's category.
+     */
     category: string | null;
     [key: string]: any;
 };
 declare enum ReloadType {
+    /**
+     * Reload developer/guild commands.
+     */
     Developer = "dev",
+    /**
+     * Reload global commands.
+     */
     Global = "global"
 }
 
+/**
+ * Options for instantiating a CommandKit handler.
+ */
 interface CommandKitOptions {
     /**
      * The Discord.js client object to use with CommandKit.
@@ -103,10 +261,18 @@ interface CommandKitOptions {
      */
     bulkRegister?: boolean;
 }
+/**
+ * A reload type for commands.
+ */
 type ReloadOptions = 'dev' | 'global' | ReloadType;
 
 declare class CommandKit {
     #private;
+    /**
+     * Create a new handler with CommandKit.
+     * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+     * @see {@link https://commandkit.js.org/docs/commandkit-setup}
+     */
     constructor(options: CommandKitOptions);
     /**
      * Updates application commands with the latest from "commandsPath".
@@ -196,6 +362,54 @@ declare class ButtonKit extends ButtonBuilder {
     onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
 }
 
+interface CommandKitConfig {
+    /**
+     * The source directory of the project.
+     */
+    src: string;
+    /**
+     * The main "javascript" file of the project.
+     */
+    main: string;
+    /**
+     * Whether or not to use the watch mode. Defaults to `true`.
+     */
+    watch: boolean;
+    /**
+     * The output directory of the project. Defaults to `dist`.
+     */
+    outDir: string;
+    /**
+     * Whether or not to include extra env utilities. Defaults to `true`.
+     */
+    envExtra: boolean;
+    /**
+     * Node.js cli options.
+     */
+    nodeOptions: string[];
+    /**
+     * Whether or not to clear default restart logs. Defaults to `true`.
+     */
+    clearRestartLogs: boolean;
+    /**
+     * Whether or not to minify the output. Defaults to `false`.
+     */
+    minify: boolean;
+    /**
+     * Whether or not to include sourcemaps in production build. Defaults to `false`.
+     */
+    sourcemap: boolean | 'inline';
+    /**
+     * Whether or not to include anti-crash handler in production. Defaults to `true`.
+     */
+    antiCrash: boolean;
+}
+declare function getConfig(): CommandKitConfig;
+declare const requiredProps: readonly ["src", "main"];
+type R = (typeof requiredProps)[number];
+type PartialConfig<T extends CommandKitConfig> = Partial<Omit<T, R>> & Pick<T, R>;
+declare function defineConfig(config: PartialConfig<CommandKitConfig>): Partial<CommandKitConfig>;
+
 type CommandKitEffectCallback = () => void;
 type CommandKitSignalInitializer<T> = T | (() => T);
 type CommandKitSignalUpdater<T> = T | ((prev: T) => T);
@@ -204,7 +418,16 @@ type CommandKitSignal<T> = readonly [
     (value: CommandKitSignalUpdater<T>) => void,
     () => void
 ];
+/**
+ * Creates a new signal.
+ * @param value - The initial value to use.
+ * @returns An array of functions: a getter, a setter, and a disposer.
+ */
 declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T>): CommandKitSignal<T>;
+/**
+ * Creates a new effect.
+ * @param callback - The callback function to execute.
+ */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal };
+export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };

package/dist/index.d.ts

@@ -1,70 +1,228 @@
 import { CommandInteraction, Client, ChatInputCommandInteraction, ContextMenuCommandInteraction, PermissionsString, APIApplicationCommandOption, ButtonInteraction, Awaitable, Message, InteractionCollectorOptions, ButtonBuilder } from 'discord.js';
 
+/**
+ * Base props for commands.
+ */
 interface CommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: CommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The main CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for slash command run functions.
+ */
 interface SlashCommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: ChatInputCommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for context menu command run functions.
+ */
 interface ContextMenuCommandProps {
+    /**
+     * Represents the command's interaction.
+     */
     interaction: ContextMenuCommandInteraction;
+    /**
+     * The client created in your main file.
+     */
     client: Client<true>;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Props for command validations.
+ */
 interface ValidationFunctionProps {
+    /**
+     * Represents the command's interaction.
+     * Either a slash command or a context menu command interaction.
+     */
     interaction: ChatInputCommandInteraction | ContextMenuCommandInteraction;
+    /**
+     * The client created in your main file.
+     * Represented as a ready client (`Client<true>`).
+     */
     client: Client<true>;
+    /**
+     * The command object that is being validated.
+     */
     commandObj: CommandObject;
+    /**
+     * The CommandKit handler that instantiated this.
+     */
     handler: CommandKit;
 }
+/**
+ * Configuration for commands.
+ */
 interface CommandOptions {
+    /**
+     * Boolean indicating whether the command is guild-only.
+     * @deprecated - Use `dm_permission` in the command's data instead.
+     */
     guildOnly?: boolean;
+    /**
+     * Boolean indicating whether the command is developer only.
+     */
     devOnly?: boolean;
+    /**
+     * Boolean indicating whether the command is deleted and should not be registered.
+     */
     deleted?: boolean;
+    /**
+     * An array of user permissions.
+     *
+     * @example
+     * userPermissions: ['BanMembers']
+     */
     userPermissions?: PermissionsString[];
+    /**
+     * An array of bot permissions.
+     *
+     * @example
+     * botPermissions: ['BanMembers']
+     */
     botPermissions?: PermissionsString[];
     [key: string]: any;
 }
 declare enum CommandType {
+    /**
+     * Slash commands.
+     */
     'ChatInput' = 1,
+    /**
+     * Message context menu commands.
+     */
     'Message' = 3,
+    /**
+     * User context menu commands.
+     */
     'User' = 2
 }
 type LocaleString = 'id' | `en-${'GB' | 'US'}` | 'bg' | `zh-${'CN' | 'TW'}` | 'hr' | 'cs' | 'da' | 'nl' | 'fi' | 'fr' | 'de' | 'el' | 'hi' | 'hu' | 'it' | 'ja' | 'ko' | 'lt' | 'no' | 'pl' | 'pt-BR' | 'ro' | 'ru' | 'es-ES' | 'sv-SE' | 'th' | 'tr' | 'uk' | 'vi';
+/**
+ * Common items for command data.
+ */
 type BaseCommandData = {
+    /**
+     * The name of the command.
+     */
     name: string;
+    /**
+     * The type of the command.
+     */
     type?: CommandType;
+    /**
+     * i18n for the command name.
+     */
     name_localizations?: Partial<Record<LocaleString, string | null>>;
+    /**
+     * Whether to allow this command in DMs.
+     */
     dm_permission?: boolean;
+    /**
+     * Default permissions for members for the command.
+     */
     default_member_permissions?: string;
+    /**
+     * Whether the command is age-restricted.
+     */
     nsfw?: boolean;
 };
+/**
+ * Data for chat input commands.
+ */
 type ChatInputCommandData = BaseCommandData & {
+    /**
+     * The command's type.
+     */
     type?: CommandType.ChatInput;
+    /**
+     * The description of the command.
+     */
     description: string;
+    /**
+     * i18n for the command description.
+     */
     description_localizations?: Partial<Record<LocaleString, string | null>>;
+    /**
+     * Chat input command options.
+     */
     options?: Array<APIApplicationCommandOption>;
 };
+/**
+ * Represents any context menu command data.
+ */
 type UserOrMessageCommandData = BaseCommandData & {
     type: CommandType.User | CommandType.Message;
 };
 type CommandData = ChatInputCommandData | UserOrMessageCommandData;
 type CommandObject = {
+    /**
+     * Command data which is a slash command builder or raw JSON data.
+     * @example
+     * {
+     *      name: 'ping',
+     *      description: 'Replies with Pong!'
+     * }
+     */
     data: CommandData;
+    /**
+     * CommandKit command options.
+     * @example
+     * {
+     *      devOnly: true,
+     *      userPermissions: ['ManageGuild'],
+     *      botPermissions: ['ManageGuild'],
+     * }
+     */
     options?: CommandOptions;
+    /**
+     * The path to the command file.
+     */
     filePath: string;
+    /**
+     * The command's category.
+     */
     category: string | null;
     [key: string]: any;
 };
 declare enum ReloadType {
+    /**
+     * Reload developer/guild commands.
+     */
     Developer = "dev",
+    /**
+     * Reload global commands.
+     */
     Global = "global"
 }
 
+/**
+ * Options for instantiating a CommandKit handler.
+ */
 interface CommandKitOptions {
     /**
      * The Discord.js client object to use with CommandKit.
@@ -103,10 +261,18 @@ interface CommandKitOptions {
      */
     bulkRegister?: boolean;
 }
+/**
+ * A reload type for commands.
+ */
 type ReloadOptions = 'dev' | 'global' | ReloadType;
 
 declare class CommandKit {
     #private;
+    /**
+     * Create a new handler with CommandKit.
+     * @param options - Options to use (client, commandsPath, eventsPath, etc.)
+     * @see {@link https://commandkit.js.org/docs/commandkit-setup}
+     */
     constructor(options: CommandKitOptions);
     /**
      * Updates application commands with the latest from "commandsPath".
@@ -196,6 +362,54 @@ declare class ButtonKit extends ButtonBuilder {
     onClick(handler: CommandKitButtonBuilderInteractionCollectorDispatch, data: CommandKitButtonBuilderInteractionCollectorDispatchContextData): this;
 }
 
+interface CommandKitConfig {
+    /**
+     * The source directory of the project.
+     */
+    src: string;
+    /**
+     * The main "javascript" file of the project.
+     */
+    main: string;
+    /**
+     * Whether or not to use the watch mode. Defaults to `true`.
+     */
+    watch: boolean;
+    /**
+     * The output directory of the project. Defaults to `dist`.
+     */
+    outDir: string;
+    /**
+     * Whether or not to include extra env utilities. Defaults to `true`.
+     */
+    envExtra: boolean;
+    /**
+     * Node.js cli options.
+     */
+    nodeOptions: string[];
+    /**
+     * Whether or not to clear default restart logs. Defaults to `true`.
+     */
+    clearRestartLogs: boolean;
+    /**
+     * Whether or not to minify the output. Defaults to `false`.
+     */
+    minify: boolean;
+    /**
+     * Whether or not to include sourcemaps in production build. Defaults to `false`.
+     */
+    sourcemap: boolean | 'inline';
+    /**
+     * Whether or not to include anti-crash handler in production. Defaults to `true`.
+     */
+    antiCrash: boolean;
+}
+declare function getConfig(): CommandKitConfig;
+declare const requiredProps: readonly ["src", "main"];
+type R = (typeof requiredProps)[number];
+type PartialConfig<T extends CommandKitConfig> = Partial<Omit<T, R>> & Pick<T, R>;
+declare function defineConfig(config: PartialConfig<CommandKitConfig>): Partial<CommandKitConfig>;
+
 type CommandKitEffectCallback = () => void;
 type CommandKitSignalInitializer<T> = T | (() => T);
 type CommandKitSignalUpdater<T> = T | ((prev: T) => T);
@@ -204,7 +418,16 @@ type CommandKitSignal<T> = readonly [
     (value: CommandKitSignalUpdater<T>) => void,
     () => void
 ];
+/**
+ * Creates a new signal.
+ * @param value - The initial value to use.
+ * @returns An array of functions: a getter, a setter, and a disposer.
+ */
 declare function createSignal<T = unknown>(value?: CommandKitSignalInitializer<T>): CommandKitSignal<T>;
+/**
+ * Creates a new effect.
+ * @param callback - The callback function to execute.
+ */
 declare function createEffect(callback: CommandKitEffectCallback): void;
 
-export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal };
+export { ButtonKit, CommandData, CommandKit, CommandKitButtonBuilderInteractionCollectorDispatch, CommandKitButtonBuilderInteractionCollectorDispatchContextData, CommandKitConfig, CommandKitEffectCallback, CommandKitSignal, CommandKitSignalInitializer, CommandKitSignalUpdater, CommandObject, CommandOptions, CommandProps, CommandType, ContextMenuCommandProps, ReloadType, SlashCommandProps, ValidationFunctionProps, createEffect, createSignal, defineConfig, getConfig };