commandkit 1.2.1-dev.20260414125348 → 1.2.1-dev.20260920033200

package/dist/{commandkit-DTqT800J.js → commandkit-gJ4YjTy4.js}

@@ -1,5 +1,6 @@
-const require_chunk = require('./chunk-BE-pF4vm.js');
+const require_rolldown_runtime = require('./rolldown-runtime-C_NdSu1c.js');
 const require_utils_colors = require('./utils/colors.js');
+require('./components/interactive/action-row/ActionRow.js');
 const require_utils_error_codes = require('./utils/error-codes.js');
 const require_plugins_CompilerPlugin = require('./plugins/CompilerPlugin.js');
 const require_plugins_RuntimePlugin = require('./plugins/RuntimePlugin.js');
@@ -16,11 +17,18 @@ const require_app_commands_helpers = require('./app/commands/helpers.js');
 const require_app_commands_MessageCommandParser = require('./app/commands/MessageCommandParser.js');
 const require_app_router_CommandsRouter = require('./app/router/CommandsRouter.js');
 const require_app_router_EventsRouter = require('./app/router/EventsRouter.js');
+const require_app_router_TreeArtifact = require('./app/router/TreeArtifact.js');
+require('./app/router/index.js');
+const require_version = require('./version.js');
+require('./components/display/file.js');
+require('./components/display/separator.js');
+require('./components/display/text-display.js');
+require('./components/display/poll.js');
 const require_cli_common = require('./cli/common.js');
 const require_events_CommandKitEventsChannel = require('./events/CommandKitEventsChannel.js');
 const require_flags_store = require('./flags/store.js');
 let node_events = require("node:events");
-node_events = require_chunk.__toESM(node_events);
+node_events = require_rolldown_runtime.__toESM(node_events);
 let discord_js = require("discord.js");
 let node_async_hooks = require("node:async_hooks");
 let node_crypto = require("node:crypto");
@@ -28,6 +36,7 @@ let node_console = require("node:console");
 let util = require("util");
 let node_fs = require("node:fs");
 let node_path = require("node:path");
+let node_fs_promises = require("node:fs/promises");
 
 //#region src/context/async-context.ts
 const kCommandWorker = Symbol("commandkitCommandWorker");
@@ -387,17 +396,6 @@ var ModalKit = class extends discord_js.ModalBuilder {
 
 //#endregion
 //#region src/logger/DefaultLogger.ts
-/**
-* Log levels for the logger.
-*/
-var LogLevel = /* @__PURE__ */ function(LogLevel) {
-	LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
-	LogLevel[LogLevel["INFO"] = 1] = "INFO";
-	LogLevel[LogLevel["WARN"] = 2] = "WARN";
-	LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
-	LogLevel[LogLevel["DEFAULT"] = 4] = "DEFAULT";
-	return LogLevel;
-}(LogLevel || {});
 const execHandlerKind = {
 	autocomplete: "Autocomplete",
 	messageContextMenu: "MessageContextMenu",
@@ -406,18 +404,18 @@ const execHandlerKind = {
 	message: "Message"
 };
 const TextColorMap = {
-	[LogLevel.DEBUG]: require_utils_colors.default.blue,
-	[LogLevel.INFO]: require_utils_colors.default.green,
-	[LogLevel.WARN]: require_utils_colors.default.yellow,
-	[LogLevel.ERROR]: require_utils_colors.default.red,
-	[LogLevel.DEFAULT]: require_utils_colors.default.white
+	[0]: require_utils_colors.default.blue,
+	[1]: require_utils_colors.default.green,
+	[2]: require_utils_colors.default.yellow,
+	[3]: require_utils_colors.default.red,
+	[4]: require_utils_colors.default.white
 };
 const TextBgColorMap = {
-	[LogLevel.DEBUG]: require_utils_colors.default.bgBlue,
-	[LogLevel.INFO]: require_utils_colors.default.bgGreen,
-	[LogLevel.WARN]: require_utils_colors.default.bgYellow,
-	[LogLevel.ERROR]: require_utils_colors.default.bgRed,
-	[LogLevel.DEFAULT]: require_utils_colors.default.bgWhite
+	[0]: require_utils_colors.default.bgBlue,
+	[1]: require_utils_colors.default.bgGreen,
+	[2]: require_utils_colors.default.bgYellow,
+	[3]: require_utils_colors.default.bgRed,
+	[4]: require_utils_colors.default.bgWhite
 };
 const BoxChars = {
 	vertical: "│",
@@ -431,6 +429,8 @@ const BoxChars = {
 * It formats the log messages with timestamps, log levels, and context information.
 */
 var DefaultLogger = class {
+	stdout;
+	stderr;
 	logger;
 	/**
 	* Creates a new instance of DefaultLogger.
@@ -463,16 +463,16 @@ var DefaultLogger = class {
 	_getLevelLabel(level) {
 		let label;
 		switch (level) {
-			case LogLevel.DEBUG:
+			case 0:
 				label = "[DEBUG]";
 				break;
-			case LogLevel.INFO:
+			case 1:
 				label = "[INFO]";
 				break;
-			case LogLevel.WARN:
+			case 2:
 				label = "[WARN]";
 				break;
-			case LogLevel.ERROR:
+			case 3:
 				label = "[ERROR]";
 				break;
 			default: label = "[LOG]";
@@ -513,24 +513,24 @@ var DefaultLogger = class {
 		else this.logger.log(`${prefix} ${require_utils_colors.default.dim(BoxChars.corner)}`, colorFn(result));
 	}
 	debug(messageOrStrings, ...values) {
-		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.DEBUG, messageOrStrings, ...values);
-		else this._log(LogLevel.DEBUG, messageOrStrings);
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(0, messageOrStrings, ...values);
+		else this._log(0, messageOrStrings);
 	}
 	error(messageOrStrings, ...values) {
-		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.ERROR, messageOrStrings, ...values);
-		else this._log(LogLevel.ERROR, messageOrStrings);
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(3, messageOrStrings, ...values);
+		else this._log(3, messageOrStrings);
 	}
 	log(messageOrStrings, ...values) {
-		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.DEFAULT, messageOrStrings, ...values);
-		else this._log(LogLevel.DEFAULT, messageOrStrings);
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(4, messageOrStrings, ...values);
+		else this._log(4, messageOrStrings);
 	}
 	info(messageOrStrings, ...values) {
-		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.INFO, messageOrStrings, ...values);
-		else this._log(LogLevel.INFO, messageOrStrings);
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(1, messageOrStrings, ...values);
+		else this._log(1, messageOrStrings);
 	}
 	warn(messageOrStrings, ...values) {
-		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(LogLevel.WARN, messageOrStrings, ...values);
-		else this._log(LogLevel.WARN, messageOrStrings);
+		if (this._isTemplateStringsArray(messageOrStrings)) this._logTemplate(2, messageOrStrings, ...values);
+		else this._log(2, messageOrStrings);
 	}
 	_isTemplateStringsArray(value) {
 		return Array.isArray(value) && "raw" in value && Array.isArray(value.raw);
@@ -801,6 +801,7 @@ function createProxy(target) {
 * Represents the runtime environment for CommandKit plugins.
 */
 var CommandKitPluginRuntime = class {
+	commandkit;
 	plugins = new discord_js.Collection();
 	/**
 	* Creates a new instance of CommandKitPluginRuntime.
@@ -836,7 +837,12 @@ var CommandKitPluginRuntime = class {
 	* @param plugin The plugin to pre-load.
 	*/
 	async preload(plugin) {
-		for (const entrypoint of plugin.preload) await (entrypoint.startsWith("module:") ? import(entrypoint.slice(7)) : import(require_utils_resolve_file_url.toFileURL(`${getCurrentDirectory()}/${entrypoint}`)));
+		for (const entrypoint of plugin.preload) {
+			const path = entrypoint.startsWith("module:") ? entrypoint.slice(7) : require_utils_resolve_file_url.toFileURL(`${getCurrentDirectory()}/${entrypoint}`);
+			Logger.debug`Preloading plugin entrypoint: ${path}`;
+			const result = await import(path);
+			Logger.debug`Preloaded plugin entrypoint: ${path} with result: ${result}`;
+		}
 	}
 	/**
 	* Soft registers a plugin in the runtime.
@@ -918,19 +924,11 @@ var CommandKitPluginRuntime = class {
 //#endregion
 //#region src/plugins/plugin-runtime/CompilerPluginRuntime.ts
 /**
-* Enum representing the execution mode of a plugin.
-* It can be either 'activate' or 'deactivate'.
-* @private
-*/
-var PluginExecutionMode = /* @__PURE__ */ function(PluginExecutionMode) {
-	PluginExecutionMode["Activate"] = "activate";
-	PluginExecutionMode["Deactivate"] = "deactivate";
-	return PluginExecutionMode;
-}(PluginExecutionMode || {});
-/**
 * CompilerPluginRuntime is a runtime for managing compiler plugins in CommandKit.
 */
 var CompilerPluginRuntime = class {
+	plugins;
+	isDevMode;
 	name = "CompilerPluginRuntime";
 	initialized = false;
 	templates = /* @__PURE__ */ new Map();
@@ -965,7 +963,7 @@ var CompilerPluginRuntime = class {
 	*/
 	registerTemplate(name, handler) {
 		const ctx = this.#pluginContext.getStore();
-		if (!ctx || ctx.mode !== PluginExecutionMode.Activate) throw new Error("registerTemplate() must be called inside activate() method");
+		if (!ctx || ctx.mode !== "activate") throw new Error("registerTemplate() must be called inside activate() method");
 		if (this.templates.has(name)) throw new Error(`Template "${name}" already exists`);
 		this.templates.set(name, {
 			handler,
@@ -979,7 +977,7 @@ var CompilerPluginRuntime = class {
 	*/
 	unregisterTemplate(name) {
 		const ctx = this.#pluginContext.getStore();
-		if (!ctx || ctx.mode !== PluginExecutionMode.Deactivate) throw new Error("unregisterTemplate() must be called inside deactivate() method");
+		if (!ctx || ctx.mode !== "deactivate") throw new Error("unregisterTemplate() must be called inside deactivate() method");
 		const template = this.templates.get(name);
 		if (!template) throw new Error(`Template "${name}" does not exist`);
 		if (template.plugin !== ctx.plugin) throw new Error(`Template "${name}" is owned by plugin "${template.plugin.name}" and cannot be unregistered by "${ctx.plugin.name}"`);
@@ -1043,7 +1041,7 @@ var CompilerPluginRuntime = class {
 		for (const plugin of this.plugins) try {
 			await this.#pluginContext.run({
 				plugin,
-				mode: PluginExecutionMode.Activate
+				mode: "activate"
 			}, async () => {
 				var _plugin$activate;
 				await ((_plugin$activate = plugin.activate) === null || _plugin$activate === void 0 ? void 0 : _plugin$activate.call(plugin, this));
@@ -1062,7 +1060,7 @@ var CompilerPluginRuntime = class {
 		for (const plugin of this.plugins) try {
 			await this.#pluginContext.run({
 				plugin,
-				mode: PluginExecutionMode.Deactivate
+				mode: "deactivate"
 			}, async () => {
 				var _plugin$deactivate;
 				await ((_plugin$deactivate = plugin.deactivate) === null || _plugin$deactivate === void 0 ? void 0 : _plugin$deactivate.call(plugin, this));
@@ -1129,7 +1127,8 @@ var MacroPlugin = class extends require_plugins_CompilerPlugin.CompilerPlugin {
 	name = "MacroPlugin";
 	macroTransformer;
 	async activate() {
-		this.macroTransformer = new (await (import("use-macro"))).MacroTransformer();
+		const transform = await import("use-macro");
+		this.macroTransformer = new transform.MacroTransformer();
 	}
 	async deactivate() {
 		this.macroTransformer = null;
@@ -1177,7 +1176,11 @@ const defaultConfig = {
 		production: false
 	},
 	jsxDefaultOptionalComponents: true,
-	experimental: { devServerRuntime: null }
+	experimental: {
+		devServerRuntime: null,
+		pregenerateCommands: false,
+		incrementalRouter: false
+	}
 };
 
 //#endregion
@@ -1194,7 +1197,7 @@ function getConfig() {
 * @param config The configuration to use.
 */
 function defineConfig(config = {}) {
-	var _config$compilerOptio, _config$compilerOptio2, _config$compilerOptio3;
+	var _config$compilerOptio, _config$compilerOptio2, _config$compilerOptio3, _config$experimental, _config$experimental2;
 	defined = require_config_utils.mergeDeep(config, require_config_utils.mergeDeep({}, defaultConfig));
 	defined = {
 		compilerOptions: {
@@ -1236,7 +1239,9 @@ function defineConfig(config = {}) {
 		jsxDefaultOptionalComponents: config.jsxDefaultOptionalComponents ?? defaultConfig.jsxDefaultOptionalComponents,
 		experimental: {
 			...defaultConfig.experimental,
-			...config.experimental
+			...config.experimental,
+			pregenerateCommands: ((_config$experimental = config.experimental) === null || _config$experimental === void 0 ? void 0 : _config$experimental.pregenerateCommands) ?? defaultConfig.experimental.pregenerateCommands,
+			incrementalRouter: ((_config$experimental2 = config.experimental) === null || _config$experimental2 === void 0 ? void 0 : _config$experimental2.incrementalRouter) ?? defaultConfig.experimental.incrementalRouter
 		}
 	};
 	return defined;
@@ -1305,6 +1310,7 @@ function applyDefaultOptionalComponentBehavior(props) {
 * Represents the execution environment for CommandKit commands.
 */
 var CommandKitEnvironment = class {
+	commandkit;
 	#data = {
 		executionError: null,
 		type: null,
@@ -1512,6 +1518,8 @@ const CommandExecutionMode = {
 * command metadata, and various utility methods for command execution.
 */
 var Context = class Context {
+	commandkit;
+	config;
 	/**
 	* The interaction that triggered the command.
 	*/
@@ -1783,6 +1791,7 @@ var MiddlewareContext = class extends Context {
 * Manages middleware execution, environment setup, and command invocation.
 */
 var AppCommandRunner = class {
+	handler;
 	/**
 	* Creates a new AppCommandRunner instance.
 	* @param handler - The app command handler instance to use for command execution
@@ -1803,7 +1812,7 @@ var AppCommandRunner = class {
 		const executionMode = this.getExecutionMode(source);
 		let runCommand = null;
 		const env = new CommandKitEnvironment(commandkit);
-		env.setType(CommandKitEnvironmentType.CommandHandler);
+		env.setType("COMMAND_HANDLER");
 		env.variables.set("commandHandlerType", "app");
 		env.variables.set("currentCommandName", prepared.command.data.command.__routeKey ?? prepared.command.command.name);
 		env.variables.set("execHandlerKind", executionMode);
@@ -2025,6 +2034,7 @@ async function beforeExecute(ctx) {
 * Handles registration of Discord application commands (slash commands, context menus).
 */
 var CommandRegistrar = class {
+	commandkit;
 	/**
 	* @private
 	* @internal
@@ -2380,6 +2390,7 @@ const middlewareDataSchema = {
 * Manages both slash commands and message commands with middleware support.
 */
 var AppCommandHandler = class {
+	commandkit;
 	/**
 	* @private
 	* @internal
@@ -2459,7 +2470,9 @@ var AppCommandHandler = class {
 			const children = node.childIds;
 			children.forEach((childId, idx) => {
 				const isLastChild = idx === children.length - 1;
-				printHierarchicalNode(childId, indent + (isLastChild ? "└─" : "├─"), indent + (isLastChild ? "   " : "│  "));
+				const childPrefix = indent + (isLastChild ? "└─" : "├─");
+				const childIndent = indent + (isLastChild ? "   " : "│  ");
+				printHierarchicalNode(childId, childPrefix, childIndent);
 			});
 		};
 		const categoryBuckets = {};
@@ -2525,14 +2538,17 @@ var AppCommandHandler = class {
 				console.log(`${require_utils_colors.default.green(rootPrefix)} ${require_utils_colors.default.yellow(root.token)}${hasMw}`);
 				root.childIds.forEach((childId, idx) => {
 					const isLastChild = idx === root.childIds.length - 1;
-					printHierarchicalNode(childId, rootChildIndent + (isLastChild ? "└─" : "├─"), rootChildIndent + (isLastChild ? "   " : "│  "));
+					const childPrefix = rootChildIndent + (isLastChild ? "└─" : "├─");
+					const childIndentNext = rootChildIndent + (isLastChild ? "   " : "│  ");
+					printHierarchicalNode(childId, childPrefix, childIndentNext);
 				});
 				entryIndex++;
 			});
 			if (hasChildren) {
 				const children = categoryTree[category].sort();
 				children.forEach((childCategory, idx) => {
-					printCategory(childCategory, childIndent, idx === children.length - 1, childIndent);
+					const childIsLast = idx === children.length - 1;
+					printCategory(childCategory, childIndent, childIsLast, childIndent);
 				});
 			}
 		};
@@ -2549,7 +2565,8 @@ var AppCommandHandler = class {
 			return true;
 		}).sort();
 		topLevelCategories.forEach((category, index) => {
-			printCategory(category, "", index === topLevelCategories.length - 1);
+			const isLast = index === topLevelCategories.length - 1;
+			printCategory(category, "", isLast);
 		});
 	}
 	/**
@@ -2638,11 +2655,7 @@ var AppCommandHandler = class {
 		if (getConfig().disablePrefixCommands && source instanceof discord_js.Message) return null;
 		let parser;
 		let routeKey;
-		let usedCommandOverride = false;
-		if (cmdName) {
-			routeKey = this.normalizeRouteKey(cmdName);
-			usedCommandOverride = true;
-		}
+		if (cmdName) routeKey = this.normalizeRouteKey(cmdName);
 		if (!routeKey) if (source instanceof discord_js.Message) {
 			if (source.author.bot) return null;
 			const prefix = await this.commandkit.appConfig.getMessageCommandPrefix(source);
@@ -2672,7 +2685,7 @@ var AppCommandHandler = class {
 			routeKey = this.buildInteractionRouteKey(source);
 		}
 		const hint = require_app_commands_helpers.isInteractionSource(source) ? source.isUserContextMenuCommand() ? "user" : source.isMessageContextMenuCommand() ? "message" : void 0 : void 0;
-		const loadedCommand = hint ? this.findCommandByName(routeKey, hint) : this.findCommandByRoute(routeKey, usedCommandOverride);
+		const loadedCommand = hint ? this.findCommandByName(routeKey, hint) : this.findCommandByRoute(routeKey);
 		if (!loadedCommand) return null;
 		if ((source instanceof discord_js.CommandInteraction || source instanceof discord_js.AutocompleteInteraction) && source.guildId && ((_loadedCommand$metada3 = loadedCommand.metadata) === null || _loadedCommand$metada3 === void 0 || (_loadedCommand$metada3 = _loadedCommand$metada3.guilds) === null || _loadedCommand$metada3 === void 0 ? void 0 : _loadedCommand$metada3.length) && !((_loadedCommand$metada4 = loadedCommand.metadata) === null || _loadedCommand$metada4 === void 0 ? void 0 : _loadedCommand$metada4.guilds.includes(source.guildId))) return null;
 		if (source instanceof discord_js.Message) {
@@ -2756,9 +2769,14 @@ var AppCommandHandler = class {
 	/**
 	* Reloads all commands and middleware from scratch.
 	*/
-	async reloadCommands() {
-		var _this$commandkit$comm2;
-		await ((_this$commandkit$comm2 = this.commandkit.commandsRouter) === null || _this$commandkit$comm2 === void 0 ? void 0 : _this$commandkit$comm2.scan());
+	async reloadCommands(path, changeType) {
+		if (this.commandkit.config.experimental.incrementalRouter && path) {
+			var _this$commandkit$comm2;
+			await ((_this$commandkit$comm2 = this.commandkit.commandsRouter) === null || _this$commandkit$comm2 === void 0 ? void 0 : _this$commandkit$comm2.scanIncremental(path, changeType));
+		} else {
+			var _this$commandkit$comm3;
+			await ((_this$commandkit$comm3 = this.commandkit.commandsRouter) === null || _this$commandkit$comm3 === void 0 ? void 0 : _this$commandkit$comm3.scan());
+		}
 		this.loadedCommands.clear();
 		this.loadedMiddlewares.clear();
 		this.runtimeRouteIndex.clear();
@@ -2826,7 +2844,7 @@ var AppCommandHandler = class {
 		if (require_utils_constants.COMMANDKIT_IS_DEV) {
 			const commandNames = Array.from(this.runtimeRouteIndex.keys());
 			const aliases = Array.from(this.runtimeRouteIndex.values()).flatMap((v) => v.metadata.aliases || []);
-			await require_utils_types_package.rewriteCommandDeclaration(`type CommandTypeData = ${Array.from(new Set([...commandNames, ...aliases])).map((name) => JSON.stringify(name)).join(" | ")}`);
+			await require_utils_types_package.rewriteCommandDeclaration(Array.from(/* @__PURE__ */ new Set([...commandNames, ...aliases])));
 		}
 		await this.commandkit.plugins.execute((ctx, plugin) => {
 			return plugin.onAfterCommandsLoad(ctx);
@@ -2991,15 +3009,21 @@ var AppCommandHandler = class {
 			const isRootHierarchyLeaf = node.kind === "command";
 			const hasContextMenuHandlers = !!(commandFileData.userContextMenu || commandFileData.messageContextMenu);
 			const hasExecutableSlashHandlers = !!(commandFileData.chatInput || commandFileData.message || commandFileData.autocomplete);
+			const sanitizedCommandFileData = { ...commandFileData };
 			if (!isRootHierarchyLeaf && hasContextMenuHandlers) throw new Error(`Invalid export for hierarchical node ${routeKey}: context menu handlers are only supported for top-level root commands.`);
 			if (node.executable && handlerCount === 0) throw new Error(`Invalid export for hierarchical node ${routeKey}: executable leaves must provide at least one handler function`);
-			if (!node.executable && hasExecutableSlashHandlers) throw new Error(`Invalid export for hierarchical node ${routeKey}: non-leaf hierarchical nodes cannot export executable slash/prefix handlers`);
+			if (!node.executable && hasExecutableSlashHandlers) {
+				Logger.warn`Ignoring ${require_utils_colors.default.yellow("executable handlers")} exported by ${require_utils_colors.default.cyan("[non-leaf]")} hierarchical node ${require_utils_colors.default.magenta(`[${routeKey}]`)}. Move ${require_utils_colors.default.yellow("chatInput")}, ${require_utils_colors.default.yellow("message")}, or ${require_utils_colors.default.yellow("autocomplete")} handlers to a ${require_utils_colors.default.green("[leaf]")} command node.`;
+				delete sanitizedCommandFileData.chatInput;
+				delete sanitizedCommandFileData.message;
+				delete sanitizedCommandFileData.autocomplete;
+			}
 			const loadedCommand = {
 				discordId: null,
 				command,
 				metadata: resolvedMetadata,
 				data: {
-					...commandFileData,
+					...sanitizedCommandFileData,
 					metadata: resolvedMetadata,
 					command: {
 						...commandJson,
@@ -3102,6 +3126,7 @@ function setFlagProvider(provider) {
 * Class representing a feature flag in CommandKit.
 */
 var FeatureFlag = class {
+	options;
 	commandkit;
 	/**
 	* Create a new feature flag.
@@ -4269,6 +4294,7 @@ function Label(props) {
 * Handles Discord.js events and CommandKit custom events with support for namespacing and middleware.
 */
 var AppEventsHandler = class {
+	commandkit;
 	/**
 	* @private
 	* @internal
@@ -4298,8 +4324,19 @@ var AppEventsHandler = class {
 	/**
 	* Reloads all events by unregistering existing ones and loading them again.
 	*/
-	async reloadEvents() {
+	async reloadEvents(path, changeType) {
 		this.unregisterAll();
+		if (this.commandkit.config.experimental.incrementalRouter && path) {
+			await this.commandkit.plugins.execute((ctx, plugin) => {
+				return plugin.onBeforeEventsLoad(ctx);
+			});
+			await this.commandkit.eventsRouter.scanIncremental(path, changeType);
+			await this.loadEventsFromTree(this.commandkit.eventsRouter.toJSON());
+			await this.commandkit.plugins.execute((ctx, plugin) => {
+				return plugin.onAfterEventsLoad(ctx);
+			});
+			return;
+		}
 		await this.loadEvents();
 	}
 	/**
@@ -4310,6 +4347,17 @@ var AppEventsHandler = class {
 			return plugin.onBeforeEventsLoad(ctx);
 		});
 		const events = await this.commandkit.eventsRouter.scan();
+		await this.loadEventsFromTree(events);
+		await this.commandkit.plugins.execute((ctx, plugin) => {
+			return plugin.onAfterEventsLoad(ctx);
+		});
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	async loadEventsFromTree(events) {
+		this.loadedEvents.clear();
 		for (const event of Object.values(events)) {
 			const listeners = [];
 			for (const listener of event.listeners) {
@@ -4336,9 +4384,6 @@ var AppEventsHandler = class {
 			Logger.info(`✨ Loaded event ${event.event}${event.namespace ? ` of namespace ${event.namespace}` : ""} with ${len} listener${len === 1 ? "" : "s"}`);
 		}
 		this.registerAllClientEvents();
-		await this.commandkit.plugins.execute((ctx, plugin) => {
-			return plugin.onAfterEventsLoad(ctx);
-		});
 	}
 	/**
 	* Unregisters all event listeners and clears loaded events.
@@ -4477,6 +4522,11 @@ var AppEventsHandler = class {
 					once: false,
 					parallel: false
 				} : void 0,
+				onceListener: onceListeners.length > 0 ? {
+					handler: onceHandler,
+					once: true,
+					parallel: false
+				} : void 0,
 				executedOnceListeners
 			});
 			if (namespace) {
@@ -4494,11 +4544,11 @@ var AppEventsHandler = class {
 	*/
 	unregisterAllClientListeners() {
 		const client = this.commandkit.client;
-		for (const [key, { name, mainListener, namespace }] of this.loadedEvents.entries()) {
+		for (const [key, { name, mainListener, onceListener, namespace }] of this.loadedEvents.entries()) {
 			if (mainListener) if (namespace) this.commandkit.events.off(namespace, name, mainListener.handler);
 			else client.off(name, mainListener.handler);
-			else if (namespace) this.commandkit.events.removeAllListeners(namespace, name);
-			else client.removeAllListeners(name);
+			if (onceListener) if (namespace) this.commandkit.events.off(namespace, name, onceListener.handler);
+			else client.off(name, onceListener.handler);
 			this.loadedEvents.delete(key);
 			Logger.info(`🗑️ Unregistered event ${name}${namespace ? ` of namespace ${namespace}` : ""}`);
 		}
@@ -4554,8 +4604,9 @@ function registerDevHooks(commandkit) {
 	if (!require_utils_constants.COMMANDKIT_IS_DEV) return;
 	process.on("message", async (message) => {
 		if (typeof message !== "object" || message === null) return;
-		const { event, path, id } = message;
+		const { event, path: maybePath, id, changeType } = message;
 		if (!event) return;
+		const path = maybePath ?? "";
 		if (process.env.COMMANDKIT_DEBUG_HMR === "true") Logger.info(`Received HMR event: ${event}${path ? ` for ${path}` : ""}`);
 		let accepted = false, prevented = false, handled = false;
 		const hmrEvent = {
@@ -4566,7 +4617,8 @@ function registerDevHooks(commandkit) {
 				prevented = true;
 			},
 			path,
-			event
+			event,
+			changeType
 		};
 		try {
 			await commandkit.plugins.execute(async (ctx, plugin) => {
@@ -4577,11 +4629,11 @@ function registerDevHooks(commandkit) {
 			if (prevented) return;
 			switch (event) {
 				case require_utils_constants.HMREventType.ReloadCommands:
-					await commandkit.commandHandler.reloadCommands();
+					await commandkit.commandHandler.reloadCommands(path, changeType);
 					handled = true;
 					break;
 				case require_utils_constants.HMREventType.ReloadEvents:
-					await commandkit.eventHandler.reloadEvents();
+					await commandkit.eventHandler.reloadEvents(path, changeType);
 					handled = true;
 					break;
 				case require_utils_constants.HMREventType.Unknown:
@@ -4644,6 +4696,7 @@ function noAnalytics() {
 * This class allows you to register a provider, set a filter for events, and track or identify events.
 */
 var AnalyticsEngine = class {
+	commandkit;
 	#provider = null;
 	#filter = null;
 	/**
@@ -4763,6 +4816,7 @@ function onApplicationBootstrap(fn) {
 */
 var CommandKit = class CommandKit extends node_events.default {
 	#started = false;
+	#hydratedFromArtifact = false;
 	#clientProxy = createProxy({});
 	#client;
 	/**
@@ -4967,11 +5021,35 @@ var CommandKit = class CommandKit extends node_events.default {
 		await this.plugins.execute((ctx, plugin) => {
 			return plugin.onEventsRouterInit(ctx);
 		});
+		this.#hydratedFromArtifact = await this.#hydrateRoutersFromArtifact();
 		await this.#initEvents();
 		await this.#initCommands();
 	}
+	async #hydrateRoutersFromArtifact() {
+		if (require_utils_constants.COMMANDKIT_IS_DEV) return false;
+		if (require_utils_constants.COMMANDKIT_BOOTSTRAP_MODE !== "production") return false;
+		if (!this.config.experimental.pregenerateCommands) return false;
+		const outputRoot = getCurrentDirectory();
+		const artifactPath = (0, node_path.join)(outputRoot, require_app_router_TreeArtifact.ROUTER_TREE_ARTIFACT_DIRECTORY, require_app_router_TreeArtifact.ROUTER_TREE_ARTIFACT_FILE);
+		if (!(0, node_fs.existsSync)(artifactPath)) return false;
+		try {
+			const json = await (0, node_fs_promises.readFile)(artifactPath, "utf8");
+			const parsed = JSON.parse(json);
+			if (!require_app_router_TreeArtifact.validateRouterTreeArtifact(parsed, "1.2.1-dev.20260920033200")) {
+				Logger.warn(`Ignoring router tree artifact at ${artifactPath}: schema/version mismatch. Falling back to dynamic filesystem resolution.`);
+				return false;
+			}
+			const hydrated = require_app_router_TreeArtifact.hydrateRouterTreeArtifact(parsed, outputRoot);
+			this.commandsRouter.populate(hydrated.commands);
+			this.eventsRouter.populate(hydrated.events);
+			return true;
+		} catch (error) {
+			Logger.warn(`Failed to load router tree artifact at ${artifactPath}. Falling back to dynamic filesystem resolution. ${error}`);
+			return false;
+		}
+	}
 	async #initCommands() {
-		if (this.commandsRouter.isValidPath()) {
+		if (!this.#hydratedFromArtifact && this.commandsRouter.isValidPath()) {
 			const result = await this.commandsRouter.scan();
 			if (require_utils_constants.COMMANDKIT_IS_DEV) (0, node_fs.writeFileSync)("./.commandkit/commands.json", JSON.stringify(result, null, 2));
 		}
@@ -4979,7 +5057,7 @@ var CommandKit = class CommandKit extends node_events.default {
 		this.commandHandler.printBanner();
 	}
 	async #initEvents() {
-		if (this.eventsRouter.isValidPath()) await this.eventsRouter.scan();
+		if (!this.#hydratedFromArtifact && this.eventsRouter.isValidPath()) await this.eventsRouter.scan();
 		await this.eventHandler.loadEvents();
 	}
 	/**
@@ -5588,4 +5666,4 @@ Object.defineProperty(exports, 'useStore', {
     return useStore;
   }
 });
-//# sourceMappingURL=commandkit-DTqT800J.js.map
+//# sourceMappingURL=commandkit-gJ4YjTy4.js.map

package/dist/commandkit-gJ4YjTy4.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandkit-gJ4YjTy4.js","names":[],"sources":[],"mappings":""}

package/dist/commandkit.d.ts

@@ -1,2 +1,2 @@
-import { c as CommandKitConfiguration, d as onBootstrap, l as commandkit, o as BootstrapFunction, s as CommandKit, u as onApplicationBootstrap } from "./analytics-engine-BYA0ongA.js";
+import { c as CommandKitConfiguration, d as onBootstrap, l as commandkit, o as BootstrapFunction, s as CommandKit, u as onApplicationBootstrap } from "./analytics-engine-Bz1p7ud3.js";
 export { BootstrapFunction, CommandKit, CommandKitConfiguration, commandkit, onApplicationBootstrap, onBootstrap };

package/dist/commandkit.js

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_commandkit = require('./commandkit-DTqT800J.js');
+const require_commandkit = require('./commandkit-gJ4YjTy4.js');
 
 exports.CommandKit = require_commandkit.CommandKit;
 exports.commandkit = require_commandkit.commandkit;

package/dist/{common-CCvvgnxi.d.ts → common-CIbPzguv.d.ts}

@@ -1,6 +1,5 @@
-import { n as EventInterceptorContextData } from "./EventInterceptor-D9JKMcfi.js";
+import { n as EventInterceptorContextData } from "./EventInterceptor-wg378vJp.js";
 import { Awaitable, Events } from "discord.js";
-
 //#region src/components/interactive/select-menu/common.d.ts
 /**
  * The predicate function that filters select menu interactions.
@@ -26,4 +25,4 @@ type CommandKitSelectMenuBuilderOnEnd = (reason: string) => Awaitable<void>;
 type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData = EventInterceptorContextData<Events.InteractionCreate>;
 //#endregion
 export { OnSelectMenuKitSubmit as a, OnSelectMenuKitEnd as i, CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData as n, SelectMenuKitPredicate as o, CommandKitSelectMenuBuilderOnEnd as r, CommandKitSelectMenuBuilderInteractionCollectorDispatch as t };
-//# sourceMappingURL=common-CCvvgnxi.d.ts.map
+//# sourceMappingURL=common-CIbPzguv.d.ts.map

package/dist/components/common/EventInterceptor.d.ts

@@ -1,2 +1,2 @@
-import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler, t as EventInterceptor } from "../../EventInterceptor-D9JKMcfi.js";
+import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler, t as EventInterceptor } from "../../EventInterceptor-wg378vJp.js";
 export { EventInterceptor, EventInterceptorContextData, EventInterceptorErrorHandler };

package/dist/components/common/EventInterceptor.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
 * It also supports automatic cleanup of expired subscriptions.
 */
 var EventInterceptor = class {
+	client;
 	subscribers = /* @__PURE__ */ new Map();
 	globalHandlers = /* @__PURE__ */ new Map();
 	cleanupTimer = null;