commandkit 0.1.11-dev.20250314022547 → 0.1.11-dev.20250327153237

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { RESTPostAPIApplicationCommandsJSONBody, Client, Interaction, CacheType, PermissionsString, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, AutocompleteInteraction, ClientEvents, Awaitable, ButtonBuilder, ButtonInteraction, Events, ModalBuilder, ModalSubmitInteraction, ActionRowBuilder, TextInputBuilder, ButtonStyle, ComponentEmojiResolvable, TextInputStyle, LocalizationMap, Locale, Message as Message$1, ApplicationCommandOptionType, GuildMember, Attachment, User, Role, CommandInteractionOption, Collection, SlashCommandBuilder, ContextMenuCommandBuilder, PartialMessage } from 'discord.js';
+import { RESTPostAPIApplicationCommandsJSONBody, Client, Interaction, CacheType, PermissionsString, ChatInputCommandInteraction, ContextMenuCommandInteraction, UserContextMenuCommandInteraction, MessageContextMenuCommandInteraction, AutocompleteInteraction, ClientEvents, Awaitable, ButtonBuilder, ButtonInteraction, Events, ModalBuilder, ModalSubmitInteraction, ActionRowBuilder, TextInputBuilder, ButtonStyle, ComponentEmojiResolvable, TextInputStyle, LocalizationMap, Locale, Message as Message$1, ApplicationCommandOptionType, GuildMember, Attachment, User, Role, CommandInteractionOption, SlashCommandBuilder, ContextMenuCommandBuilder, PartialMessage } from 'discord.js';
 import EventEmitter from 'node:events';
 import { Channel } from 'diagnostics_channel';
 import * as commander from 'commander';
@@ -1026,141 +1026,6 @@ declare class MiddlewareContext<T extends CommandExecutionMode = CommandExecutio
     setCommandRunner(fn: RunCommand): void;
 }
 
-interface ParsedCommand {
-    id: string;
-    name: string;
-    path: string;
-    relativePath: string;
-    category: string | null;
-    subcommands: ParsedSubCommand[];
-    middlewareIds: string[];
-}
-interface ParsedMiddleware {
-    id: string;
-    path: string;
-    relativePath: string;
-}
-interface ParsedSubCommand {
-    name: string;
-    group: string | null;
-    path: string;
-    relativePath: string;
-    command: string;
-}
-interface CommandsRouterOptions {
-    entrypoint: string;
-}
-interface CommandsRouterData {
-    commands: Collection<string, ParsedCommand>;
-    middlewares: Collection<string, ParsedMiddleware>;
-}
-interface CommandsRouterRawData {
-    commands: Record<string, ParsedCommand>;
-    middlewares: Record<string, ParsedMiddleware>;
-}
-declare class CommandsRouter {
-    private readonly options;
-    private commands;
-    private middlewares;
-    constructor(options: CommandsRouterOptions);
-    fromData(data: CommandsRouterRawData): void;
-    isValidPath(): boolean;
-    getData(): CommandsRouterData;
-    toJSON(): CommandsRouterRawData;
-    clear(): void;
-    reload(): Promise<CommandsRouterRawData>;
-    scan(): Promise<CommandsRouterRawData>;
-    private traverse;
-    private applyBindings;
-    private distanceFromRoot;
-    private parseGroup;
-    private parseCategory;
-    private parseFileName;
-    private toRelativePath;
-}
-
-/**
- * Configuration options for the EventsRouter
- * @interface EventsRouterOptions
- */
-interface EventsRouterOptions {
-    /** Root directory path where event handlers are located */
-    entrypoint: string;
-}
-/**
- * Represents a parsed event with its handlers
- * @interface ParsedEvent
- */
-interface ParsedEvent {
-    /** Name of the event derived from directory name */
-    event: string;
-    /** Absolute path to the event directory */
-    path: string;
-    /** Array of file paths to event listener handlers */
-    listeners: string[];
-    /** Namespace of the event */
-    namespace: string | null;
-}
-/** Map of event names to their parsed metadata */
-type EventsTree = Record<string, ParsedEvent>;
-/**
- * Router for discovering and managing event handler files in a directory structure.
- * Events are represented by directories, and handlers are files within those directories.
- */
-declare class EventsRouter {
-    private options;
-    /** Internal storage of parsed events */
-    private events;
-    /**
-     * Creates a new EventsRouter instance
-     * @param options - Configuration options for the router
-     * @throws Error if entrypoint is not provided
-     */
-    constructor(options: EventsRouterOptions);
-    /**
-     * Find a parsed event by its name
-     * @param event - Name of the event to find
-     * @returns Parsed event metadata or null if not found
-     */
-    match(event: string): ParsedEvent | null;
-    /**
-     * Get the entrypoint directory path
-     * @returns Entrypoint directory path
-     */
-    get entrypoint(): string;
-    /**
-     * Checks if the entrypoint path is valid
-     */
-    isValidPath(): boolean;
-    /**
-     * Clear all parsed events
-     */
-    clear(): void;
-    /**
-     * Reload and re-scan the entrypoint directory for events
-     * @returns Promise resolving to the updated events tree
-     */
-    reload(): Promise<EventsTree>;
-    /**
-     * Scan the entrypoint directory for events and their handlers
-     * @returns Promise resolving to the events tree
-     */
-    scan(): Promise<EventsTree>;
-    /**
-     * Convert the internal events map to a plain object
-     * @returns Events tree as a plain object
-     */
-    toJSON(): EventsTree;
-    /**
-     * Recursively scan a directory for event handlers
-     * @param event - Name of the event
-     * @param path - Path to the event directory
-     * @param listeners - Array to collect listener file paths
-     * @returns Promise resolving to the parsed event metadata
-     */
-    private scanEvent;
-}
-
 declare class CommandRegistrar {
     readonly commandkit: CommandKit;
     private api;
@@ -1173,10 +1038,6 @@ declare class CommandRegistrar {
      * Gets the commands data.
      */
     getCommandsData(): CommandData[];
-    /**
-     * Process and merge subcommands into the parent command's options
-     */
-    private processSubcommands;
     /**
      * Registers loaded commands.
      */
@@ -1319,6 +1180,156 @@ declare function revalidate<T = unknown>(tag: string, ...args: any[]): Promise<T
  */
 declare function isCachedFunction(fn: GenericFunction): boolean;
 
+interface Command {
+    id: string;
+    name: string;
+    path: string;
+    relativePath: string;
+    parentPath: string;
+    middlewares: Array<string>;
+    category: string | null;
+}
+interface Middleware {
+    id: string;
+    name: string;
+    path: string;
+    relativePath: string;
+    parentPath: string;
+}
+interface ParsedCommandData {
+    commands: Record<string, Command>;
+    middlewares: Record<string, Middleware>;
+}
+interface CommandsRouterOptions {
+    entrypoint: string;
+}
+declare class CommandsRouter {
+    private readonly options;
+    private commands;
+    private middlewares;
+    constructor(options: CommandsRouterOptions);
+    populate(data: ParsedCommandData): void;
+    isValidPath(): boolean;
+    private isCommand;
+    private isMiddleware;
+    private isCategory;
+    clear(): void;
+    scan(): Promise<{
+        commands: {
+            [k: string]: Command;
+        };
+        middlewares: {
+            [k: string]: Middleware;
+        };
+    }>;
+    getData(): {
+        commands: Map<string, Command>;
+        middlewares: Map<string, Middleware>;
+    };
+    toJSON(): {
+        commands: {
+            [k: string]: Command;
+        };
+        middlewares: {
+            [k: string]: Middleware;
+        };
+    };
+    private traverse;
+    private handle;
+    private applyMiddlewares;
+    private replaceEntrypoint;
+}
+
+/**
+ * Configuration options for the EventsRouter
+ * @interface EventsRouterOptions
+ */
+interface EventsRouterOptions {
+    /** Root directory path where event handlers are located */
+    entrypoint: string;
+}
+/**
+ * Represents a parsed event with its handlers
+ * @interface ParsedEvent
+ */
+interface ParsedEvent {
+    /** Name of the event derived from directory name */
+    event: string;
+    /** Absolute path to the event directory */
+    path: string;
+    /** Array of file paths to event listener handlers */
+    listeners: string[];
+    /** Namespace of the event */
+    namespace: string | null;
+}
+/** Map of event names to their parsed metadata */
+type EventsTree = Record<string, ParsedEvent>;
+/**
+ * Router for discovering and managing event handler files in a directory structure.
+ * Events are represented by directories, and handlers are files within those directories.
+ */
+declare class EventsRouter {
+    private options;
+    /** Internal storage of parsed events */
+    private events;
+    /**
+     * Creates a new EventsRouter instance
+     * @param options - Configuration options for the router
+     * @throws Error if entrypoint is not provided
+     */
+    constructor(options: EventsRouterOptions);
+    /**
+     * Find a parsed event by its name
+     * @param event - Name of the event to find
+     * @returns Parsed event metadata or null if not found
+     */
+    match(event: string): ParsedEvent | null;
+    /**
+     * Get the entrypoint directory path
+     * @returns Entrypoint directory path
+     */
+    get entrypoint(): string;
+    /**
+     * Checks if the entrypoint path is valid
+     */
+    isValidPath(): boolean;
+    /**
+     * Clear all parsed events
+     */
+    clear(): void;
+    /**
+     * Reload and re-scan the entrypoint directory for events
+     * @returns Promise resolving to the updated events tree
+     */
+    reload(): Promise<EventsTree>;
+    /**
+     * Scan the entrypoint directory for events and their handlers
+     * @returns Promise resolving to the events tree
+     */
+    scan(): Promise<EventsTree>;
+    /**
+     * Convert the internal events map to a plain object
+     * @returns Events tree as a plain object
+     */
+    toJSON(): EventsTree;
+    /**
+     * Recursively scan a directory for event handlers
+     * @param event - Name of the event
+     * @param path - Path to the event directory
+     * @param listeners - Array to collect listener file paths
+     * @returns Promise resolving to the parsed event metadata
+     */
+    private scanEvent;
+}
+
+declare class AppCommandRunner {
+    #private;
+    private handler;
+    constructor(handler: AppCommandHandler);
+    runCommand(prepared: PreparedAppCommandExecution, source: Interaction | Message$1): Promise<void>;
+    getExecutionMode(source: Interaction | Message$1): CommandExecutionMode;
+}
+
 type RunCommand = <T extends AsyncFunction>(fn: T) => T;
 interface AppCommand {
     command: SlashCommandBuilder | Record<string, any>;
@@ -1333,31 +1344,23 @@ interface AppCommandMiddleware {
     afterExecute: (ctx: Context) => Awaitable<unknown>;
 }
 interface LoadedCommand {
-    command: ParsedCommand;
+    command: Command;
     data: AppCommand;
-    subcommands?: ParsedSubCommand[];
     guilds?: string[];
 }
 interface LoadedMiddleware {
-    middleware: ParsedMiddleware;
+    middleware: Middleware;
     data: AppCommandMiddleware;
 }
 interface PreparedAppCommandExecution {
     command: LoadedCommand;
-    subcommand?: LoadedSubCommand | null;
     middlewares: LoadedMiddleware[];
     messageCommandParser?: MessageCommandParser;
 }
-interface LoadedSubCommand {
-    subcommand: ParsedSubCommand;
-    data: AppCommand;
-}
 type CommandBuilderLike = SlashCommandBuilder | ContextMenuCommandBuilder | Record<string, any>;
 declare class AppCommandHandler {
-    #private;
     readonly commandkit: CommandKit;
     private loadedCommands;
-    private loadedSubCommands;
     private loadedMiddlewares;
     private commandNameToId;
     private subcommandPathToId;
@@ -1365,22 +1368,16 @@ declare class AppCommandHandler {
     private onInteraction;
     private onMessageCreate;
     private onMessageUpdate;
+    readonly commandRunner: AppCommandRunner;
     constructor(commandkit: CommandKit);
     getCommandsArray(): LoadedCommand[];
-    /**
-     * Get subcommand data by command ID and subcommand name
-     */
-    getSubcommandData(commandId: string, subcommandName: string): any;
     registerCommandHandler(): void;
-    getExecutionMode(source: Interaction | Message$1): CommandExecutionMode;
-    runCommand(prepared: PreparedAppCommandExecution, source: Interaction | Message$1): Promise<void>;
     prepareCommandRun(source: Interaction | Message$1): Promise<PreparedAppCommandExecution | null>;
     reloadCommands(): Promise<void>;
     loadCommands(): Promise<void>;
     private loadMiddleware;
     private loadCommand;
-    private loadSubcommand;
-    applyLocalizations(command: CommandBuilderLike, subcommand?: ParsedSubCommand): Promise<CommandBuilderLike>;
+    applyLocalizations(command: CommandBuilderLike): Promise<CommandBuilderLike>;
 }
 
 type ListenerFunction = GenericFunction | AsyncFunction;
@@ -1524,6 +1521,7 @@ declare abstract class CompilerPlugin<T extends PluginOptions = PluginOptions> e
      */
     onBuildEnd(): Promise<void>;
 }
+declare function isCompilerPlugin(plugin: unknown): plugin is CompilerPlugin;
 
 declare class CompilerPluginRuntime {
     private readonly plugins;
@@ -1543,6 +1541,7 @@ declare class CompilerPluginRuntime {
         setup: (build: Setup) => Promise<void>;
     };
 }
+declare function fromEsbuildPlugin(plugin: any): typeof CompilerPlugin;
 
 type CommonPluginRuntime = CommandKitPluginRuntime | CompilerPluginRuntime;
 
@@ -1643,6 +1642,7 @@ declare abstract class RuntimePlugin<T extends PluginOptions = PluginOptions> ex
      */
     executeCommand(ctx: CommandKitPluginRuntime, source: Interaction | Message$1, command: PreparedAppCommandExecution, execute: () => Promise<any>): Promise<boolean>;
 }
+declare function isRuntimePlugin(plugin: unknown): plugin is RuntimePlugin;
 
 declare class CommandKitPluginRuntime extends EventTarget {
     readonly commandkit: CommandKit;
@@ -1927,4 +1927,4 @@ declare const version: string;
  */
 declare function bootstrapCommandkitCLI(argv: string[], options?: commander.ParseOptions | undefined): Promise<void>;
 
-export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, type ApiTranslatableCommandOptions, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandObject, type CommandOptions, type CommandProps, CommandsRouter, type CommandsRouterData, type CommandsRouterOptions, type CommandsRouterRawData, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, Logger, type LoggerImpl, type MaybeArray, MemoryCache, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnModalKitEnd, type OnModalKitSubmit, ParagraphInput, type ParsedCommand, type ParsedEvent, type ParsedMessageCommand, type ParsedMiddleware, type ParsedSubCommand, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, type RunCommand, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCachedFunction, isCommandKitElement, makeContextAwareFunction, redirect, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };
+export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, type ApiTranslatableCommandOptions, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, type AutocompleteProps, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, type Command, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, type CommandFileObject, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandObject, type CommandOptions, type CommandProps, CommandsRouter, type CommandsRouterOptions, type CommonPluginRuntime, CompilerPlugin, CompilerPluginRuntime, Context, type ContextMenuCommandProps, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type MessageContextMenuCommandProps, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ReloadOptions, ReloadType, type ResolveKind, type ResolveResult, type RunCommand, RuntimePlugin, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, type SlashCommandProps, TextInput, type TextInputProps, type TransformedResult, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, type UserContextMenuCommandProps, type ValidationProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, dmOnly, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getElement, guildOnly, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isRuntimePlugin, makeContextAwareFunction, redirect, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };