commandkit 1.2.1-dev.20260411010608 → 1.2.1-dev.20260411122819

package/dist/app/router/CommandsRouter.js

@@ -6,6 +6,7 @@ let node_path = require("node:path");
 let node_fs_promises = require("node:fs/promises");
 
 //#region src/app/router/CommandsRouter.ts
+const ROOT_NODE_ID = "__commandkit_router_root__";
 /**
 * @private
 * @internal
@@ -32,6 +33,31 @@ const COMMAND_PATTERN = /^([^+().][^().]*)\.(m|c)?(j|t)sx?$/;
 */
 const CATEGORY_PATTERN = /^\(.+\)$/;
 /**
+* @private
+* @internal
+*/
+const COMMAND_DIRECTORY_PATTERN = /^\[([^\][\\\/]+)\]$/;
+/**
+* @private
+* @internal
+*/
+const GROUP_DIRECTORY_PATTERN = /^\{([^}{\\\/]+)\}$/;
+/**
+* @private
+* @internal
+*/
+const COMMAND_DEFINITION_PATTERN = /^command\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
+const GROUP_DEFINITION_PATTERN = /^group\.(m|c)?(j|t)sx?$/;
+/**
+* @private
+* @internal
+*/
+const SUBCOMMAND_FILE_PATTERN = /^([^+().][^().]*)\.subcommand\.(m|c)?(j|t)sx?$/;
+/**
 * Handles discovery and parsing of command and middleware files in the filesystem.
 */
 var CommandsRouter = class {
@@ -46,6 +72,21 @@ var CommandsRouter = class {
 	*/
 	middlewares = new discord_js.Collection();
 	/**
+	* @private
+	* @internal
+	*/
+	treeNodes = new discord_js.Collection();
+	/**
+	* @private
+	* @internal
+	*/
+	compiledRoutes = new discord_js.Collection();
+	/**
+	* @private
+	* @internal
+	*/
+	diagnostics = [];
+	/**
 	* Creates a new CommandsRouter instance.
 	* @param options - Configuration options for the router
 	*/
@@ -53,12 +94,16 @@ var CommandsRouter = class {
 		this.options = options;
 	}
 	/**
-	* Populates the router with existing command and middleware data.
+	* Populates the router with existing command, middleware, and tree data.
 	* @param data - Parsed command data to populate with
 	*/
 	populate(data) {
+		this.clear();
 		for (const [id, command] of Object.entries(data.commands)) this.commands.set(id, command);
 		for (const [id, middleware] of Object.entries(data.middlewares)) this.middlewares.set(id, middleware);
+		for (const [id, node] of Object.entries(data.treeNodes ?? {})) this.treeNodes.set(id, node);
+		for (const [key, route] of Object.entries(data.compiledRoutes ?? {})) this.compiledRoutes.set(key, route);
+		this.diagnostics = [...data.diagnostics ?? []];
 	}
 	/**
 	* Checks if the configured entrypoint path exists.
@@ -89,69 +134,380 @@ var CommandsRouter = class {
 		return CATEGORY_PATTERN.test(name);
 	}
 	/**
-	* Clears all loaded commands and middleware.
+	* @private
+	* @internal
+	*/
+	isCommandDirectory(name) {
+		return COMMAND_DIRECTORY_PATTERN.test(name);
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	isGroupDirectory(name) {
+		return GROUP_DIRECTORY_PATTERN.test(name);
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	isCommandDefinition(name) {
+		return COMMAND_DEFINITION_PATTERN.test(name);
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	isGroupDefinition(name) {
+		return GROUP_DEFINITION_PATTERN.test(name);
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	isSubcommandFile(name) {
+		return SUBCOMMAND_FILE_PATTERN.test(name);
+	}
+	/**
+	* Clears all loaded commands, middleware, and compiled tree data.
 	*/
 	clear() {
 		this.commands.clear();
 		this.middlewares.clear();
+		this.treeNodes.clear();
+		this.compiledRoutes.clear();
+		this.diagnostics = [];
 	}
 	/**
 	* Scans the filesystem for commands and middleware files.
 	* @returns Parsed command data
 	*/
 	async scan() {
-		const entries = await (0, node_fs_promises.readdir)(this.options.entrypoint, { withFileTypes: true });
-		for (const entry of entries) {
-			if (entry.name.startsWith("_")) continue;
-			const fullPath = (0, node_path.join)(this.options.entrypoint, entry.name);
-			if (entry.isDirectory()) {
-				const category = this.isCategory(entry.name) ? entry.name.slice(1, -1) : null;
-				await this.traverse(fullPath, category);
-			} else await this.handle(entry);
-		}
+		this.clear();
+		this.initializeRootNode();
+		await this.traverseDirectory(this.options.entrypoint, "normal", null, ROOT_NODE_ID);
 		await this.applyMiddlewares();
+		this.compileTree();
 		return this.toJSON();
 	}
 	/**
-	* Gets the raw command and middleware collections.
-	* @returns Object containing commands and middlewares collections
+	* Gets the raw command, middleware, and compiled tree collections.
+	* @returns Object containing router collections
 	*/
 	getData() {
 		return {
 			commands: this.commands,
-			middlewares: this.middlewares
+			middlewares: this.middlewares,
+			treeNodes: this.treeNodes,
+			compiledRoutes: this.compiledRoutes,
+			diagnostics: this.diagnostics
+		};
+	}
+	/**
+	* Gets only the internal command tree and compiled route data.
+	* @returns Object containing tree data
+	*/
+	getTreeData() {
+		return {
+			treeNodes: this.treeNodes,
+			compiledRoutes: this.compiledRoutes,
+			diagnostics: this.diagnostics
 		};
 	}
 	/**
 	* Converts the loaded data to a JSON-serializable format.
-	* @returns Plain object with commands and middlewares
+	* @returns Plain object with commands, middleware, and tree data
 	*/
 	toJSON() {
 		return {
 			commands: Object.fromEntries(this.commands.entries()),
-			middlewares: Object.fromEntries(this.middlewares.entries())
+			middlewares: Object.fromEntries(this.middlewares.entries()),
+			treeNodes: Object.fromEntries(this.treeNodes.entries()),
+			compiledRoutes: Object.fromEntries(this.compiledRoutes.entries()),
+			diagnostics: this.diagnostics
 		};
 	}
 	/**
 	* @private
 	* @internal
 	*/
-	async traverse(path, category) {
+	initializeRootNode() {
+		this.treeNodes.set(ROOT_NODE_ID, {
+			id: ROOT_NODE_ID,
+			source: "root",
+			kind: "root",
+			token: "",
+			route: [],
+			category: null,
+			parentId: null,
+			childIds: [],
+			directoryPath: this.options.entrypoint,
+			definitionPath: null,
+			relativePath: "",
+			shorthand: false,
+			executable: false
+		});
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	async traverseDirectory(path, state, category, parentId, token) {
+		let node = null;
+		if (state === "command") {
+			node = this.createTreeNode({
+				source: "directory",
+				token,
+				category,
+				parentId,
+				directoryPath: path,
+				definitionPath: null,
+				shorthand: false
+			});
+			if (!node) return;
+		} else if (state === "group") {
+			node = this.createTreeNode({
+				source: "group",
+				token,
+				category,
+				parentId,
+				directoryPath: path,
+				definitionPath: null,
+				shorthand: false
+			});
+			if (!node) return;
+		}
+		const currentNodeId = node ? node.id : parentId;
 		const entries = await (0, node_fs_promises.readdir)(path, { withFileTypes: true });
 		for (const entry of entries) {
 			if (entry.name.startsWith("_")) continue;
+			const fullPath = (0, node_path.join)(path, entry.name);
 			if (entry.isFile()) {
-				if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) await this.handle(entry, category);
-			} else if (entry.isDirectory() && this.isCategory(entry.name) && category) {
-				const nestedCategory = this.isCategory(entry.name) ? `${category}:${entry.name.slice(1, -1)}` : null;
-				await this.traverse((0, node_path.join)(path, entry.name), nestedCategory);
+				if (state === "command") {
+					if (this.isCommandDefinition(entry.name)) {
+						node.definitionPath = fullPath;
+						node.relativePath = this.replaceEntrypoint(fullPath);
+						continue;
+					}
+					if (this.isSubcommandFile(entry.name)) {
+						this.createTreeNode({
+							source: "shorthand",
+							token: entry.name.match(SUBCOMMAND_FILE_PATTERN)[1],
+							category,
+							parentId: currentNodeId,
+							directoryPath: path,
+							definitionPath: fullPath,
+							shorthand: true
+						});
+						continue;
+					}
+					if (this.isMiddleware(entry.name)) {
+						await this.handle(entry, category);
+						continue;
+					}
+					if (this.isCommand(entry.name)) this.addDiagnostic("UNSUPPORTED_FILE_IN_COMMAND_DIRECTORY", "Only command.ts, middleware files, and subcommand shorthand files are supported inside a command directory.", fullPath);
+				} else if (state === "group") {
+					if (this.isGroupDefinition(entry.name)) {
+						node.definitionPath = fullPath;
+						node.relativePath = this.replaceEntrypoint(fullPath);
+						continue;
+					}
+					if (this.isSubcommandFile(entry.name)) {
+						this.createTreeNode({
+							source: "shorthand",
+							token: entry.name.match(SUBCOMMAND_FILE_PATTERN)[1],
+							category,
+							parentId: currentNodeId,
+							directoryPath: path,
+							definitionPath: fullPath,
+							shorthand: true
+						});
+						continue;
+					}
+					if (this.isMiddleware(entry.name)) {
+						await this.handle(entry, category);
+						continue;
+					}
+					if (this.isCommand(entry.name)) this.addDiagnostic("UNSUPPORTED_FILE_IN_GROUP_DIRECTORY", "Only group.ts, middleware files, and subcommand shorthand files are supported inside a group directory.", fullPath);
+				} else {
+					if (this.isSubcommandFile(entry.name)) {
+						if (currentNodeId === ROOT_NODE_ID) this.addDiagnostic("ORPHAN_SUBCOMMAND_FILE", "Subcommand shorthand files must be nested inside a command or group directory.", fullPath);
+						else this.createTreeNode({
+							source: "shorthand",
+							token: entry.name.match(SUBCOMMAND_FILE_PATTERN)[1],
+							category,
+							parentId: currentNodeId,
+							directoryPath: path,
+							definitionPath: fullPath,
+							shorthand: true
+						});
+						continue;
+					}
+					if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) {
+						const result = await this.handle(entry, category);
+						if (result.command) this.createFlatCommandNode(result.command);
+					}
+				}
+				continue;
+			}
+			if (!entry.isDirectory()) continue;
+			if (this.isCommandDirectory(entry.name)) {
+				if (state === "command" || state === "group") await this.traverseDirectory(fullPath, "command", category, currentNodeId, entry.name.match(COMMAND_DIRECTORY_PATTERN)[1]);
+				else if (currentNodeId !== ROOT_NODE_ID) this.addDiagnostic("NESTED_COMMAND_NOT_ALLOWED", "Command directories cannot be nested under group or subcommand directories unless they are part of a hierarchical structure.", fullPath);
+				else await this.traverseDirectory(fullPath, "command", category, ROOT_NODE_ID, entry.name.match(COMMAND_DIRECTORY_PATTERN)[1]);
+				continue;
+			}
+			if (this.isGroupDirectory(entry.name)) {
+				if (currentNodeId === ROOT_NODE_ID) this.addDiagnostic("ROOT_GROUP_NOT_ALLOWED", "Group directories must be nested inside a command directory.", fullPath);
+				else await this.traverseDirectory(fullPath, "group", category, currentNodeId, entry.name.match(GROUP_DIRECTORY_PATTERN)[1]);
+				continue;
+			}
+			if (this.isCategory(entry.name)) {
+				const nestedCategory = category ? `${category}:${entry.name.slice(1, -1)}` : entry.name.slice(1, -1);
+				await this.traverseDirectory(fullPath, "normal", nestedCategory, currentNodeId);
+				continue;
+			}
+			await this.traverseDirectory(fullPath, "normal", category, currentNodeId);
+		}
+		if (state === "command" && node && !node.definitionPath) this.addDiagnostic("MISSING_COMMAND_DEFINITION", "Command directories must include a command.ts file.", path);
+		else if (state === "group" && node && !node.definitionPath) this.addDiagnostic("MISSING_GROUP_DEFINITION", "Group directories must include a group.ts file.", path);
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	createFlatCommandNode(command) {
+		this.createTreeNode({
+			id: command.id,
+			source: "flat",
+			token: command.name,
+			category: command.category,
+			parentId: ROOT_NODE_ID,
+			directoryPath: command.parentPath,
+			definitionPath: command.path,
+			shorthand: false
+		});
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	createTreeNode(options) {
+		const parent = this.treeNodes.get(options.parentId);
+		if (!parent) {
+			this.addDiagnostic("MISSING_PARENT_NODE", `Unable to create command tree node "${options.token}" because its parent node was not found.`, options.directoryPath);
+			return null;
+		}
+		if (parent.childIds.some((childId) => {
+			var _this$treeNodes$get;
+			return ((_this$treeNodes$get = this.treeNodes.get(childId)) === null || _this$treeNodes$get === void 0 ? void 0 : _this$treeNodes$get.token) === options.token;
+		})) {
+			this.addDiagnostic("DUPLICATE_SIBLING_TOKEN", `Duplicate command token "${options.token}" found under the same parent.`, options.definitionPath ?? options.directoryPath);
+			return null;
+		}
+		const route = [...parent.route, options.token];
+		const node = {
+			id: options.id ?? crypto.randomUUID(),
+			source: options.source,
+			kind: this.resolveNodeKind(options.source, route.length),
+			token: options.token,
+			route,
+			category: options.category,
+			parentId: options.parentId,
+			childIds: [],
+			directoryPath: options.directoryPath,
+			definitionPath: options.definitionPath,
+			relativePath: this.replaceEntrypoint(options.definitionPath ?? options.directoryPath),
+			shorthand: options.shorthand,
+			executable: false
+		};
+		this.treeNodes.set(node.id, node);
+		parent.childIds.push(node.id);
+		return node;
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	resolveNodeKind(source, depth) {
+		switch (source) {
+			case "root": return "root";
+			case "flat": return "flat";
+			case "group": return "group";
+			case "shorthand": return "subcommand";
+			case "directory": return depth === 1 ? "command" : "subcommand";
+			default: return source;
+		}
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	compileTree() {
+		this.compiledRoutes.clear();
+		for (const node of this.treeNodes.values()) {
+			if (node.id === ROOT_NODE_ID) continue;
+			const hasChildren = node.childIds.length > 0;
+			node.executable = !!node.definitionPath && node.kind !== "group" && !hasChildren;
+			if (node.kind === "subcommand" && hasChildren) this.addDiagnostic("SUBCOMMAND_CANNOT_HAVE_CHILDREN", `Subcommand "${node.route.join(".")}" cannot contain child command nodes.`, node.definitionPath ?? node.directoryPath);
+			if (node.kind === "command") {
+				const childKinds = new Set(node.childIds.map((childId) => {
+					var _this$treeNodes$get2;
+					return (_this$treeNodes$get2 = this.treeNodes.get(childId)) === null || _this$treeNodes$get2 === void 0 ? void 0 : _this$treeNodes$get2.kind;
+				}).filter(Boolean));
+				if (childKinds.has("group") && childKinds.has("subcommand")) this.addDiagnostic("MIXED_ROOT_CHILDREN", `Command "${node.route.join(".")}" cannot mix direct subcommands and subcommand groups.`, node.definitionPath ?? node.directoryPath);
 			}
+			if (!node.executable || !node.definitionPath) continue;
+			const key = node.route.join(".");
+			const routeKind = node.kind;
+			this.compiledRoutes.set(key, {
+				id: node.id,
+				key,
+				kind: routeKind,
+				token: node.token,
+				route: node.route,
+				category: node.category,
+				definitionPath: node.definitionPath,
+				relativePath: this.replaceEntrypoint(node.definitionPath),
+				nodeId: node.id,
+				middlewares: this.collectCompiledMiddlewares(node)
+			});
 		}
 	}
 	/**
 	* @private
 	* @internal
 	*/
+	collectCompiledMiddlewares(node) {
+		const allMiddlewares = Array.from(this.middlewares.values());
+		const globalMiddlewares = allMiddlewares.filter((middleware) => middleware.global).map((middleware) => middleware.id);
+		const directoryMiddlewares = allMiddlewares.filter((middleware) => {
+			return !middleware.global && !middleware.command && middleware.parentPath === node.directoryPath;
+		}).map((middleware) => middleware.id);
+		const commandSpecificMiddlewares = allMiddlewares.filter((middleware) => {
+			return middleware.command === node.token && middleware.parentPath === node.directoryPath;
+		}).map((middleware) => middleware.id);
+		return [
+			...globalMiddlewares,
+			...directoryMiddlewares,
+			...commandSpecificMiddlewares
+		];
+	}
+	/**
+	* @private
+	* @internal
+	*/
+	addDiagnostic(code, message, path) {
+		this.diagnostics.push({
+			code,
+			message,
+			path: (0, node_path.normalize)(path)
+		});
+	}
+	/**
+	* @private
+	* @internal
+	*/
 	async handle(entry, category = null) {
 		const name = entry.name;
 		const path = (0, node_path.join)(entry.parentPath, entry.name);
@@ -166,7 +522,9 @@ var CommandsRouter = class {
 				middlewares: []
 			};
 			this.commands.set(command.id, command);
-		} else if (this.isMiddleware(name)) {
+			return { command };
+		}
+		if (this.isMiddleware(name)) {
 			var _name$match;
 			const middleware = {
 				id: crypto.randomUUID(),
@@ -178,7 +536,9 @@ var CommandsRouter = class {
 				command: COMMAND_MIDDLEWARE_PATTERN.test(name) ? ((_name$match = name.match(COMMAND_MIDDLEWARE_PATTERN)) === null || _name$match === void 0 ? void 0 : _name$match[1]) || null : null
 			};
 			this.middlewares.set(middleware.id, middleware);
+			return { middleware };
 		}
+		return {};
 	}
 	/**
 	* @private
@@ -189,7 +549,9 @@ var CommandsRouter = class {
 			const commandPath = command.parentPath;
 			const allMiddlewares = Array.from(this.middlewares.values());
 			const commandSpecificMiddlewares = allMiddlewares.filter((middleware) => middleware.command === command.name).map((middleware) => middleware.id);
-			const directorySpecificMiddlewares = allMiddlewares.filter((middleware) => !middleware.global && !middleware.command && middleware.parentPath === commandPath).map((middleware) => middleware.id);
+			const directorySpecificMiddlewares = allMiddlewares.filter((middleware) => {
+				return !middleware.global && !middleware.command && middleware.parentPath === commandPath;
+			}).map((middleware) => middleware.id);
 			command.middlewares = [
 				...allMiddlewares.filter((middleware) => middleware.global).map((middleware) => middleware.id),
 				...directorySpecificMiddlewares,

package/dist/app/router/CommandsRouter.js.map

@@ -1 +1 @@
-{"version":3,"file":"CommandsRouter.js","names":[],"sources":["../../../src/app/router/CommandsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { Dirent, existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { basename, extname, join, normalize } from 'node:path';\n\n/**\n * Represents a command with its metadata and middleware associations.\n */\nexport interface Command {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  middlewares: Array<string>;\n  category: string | null;\n}\n\n/**\n * Represents a middleware with its metadata and scope.\n */\nexport interface Middleware {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  global: boolean;\n  command: string | null;\n}\n\n/**\n * Data structure containing parsed commands and middleware.\n */\nexport interface ParsedCommandData {\n  commands: Record<string, Command>;\n  middlewares: Record<string, Middleware>;\n}\n\n/**\n * Configuration options for the commands router.\n */\nexport interface CommandsRouterOptions {\n  entrypoint: string;\n}\n\n/**\n * @private\n * @internal\n */\nconst MIDDLEWARE_PATTERN = /^\\+middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_MIDDLEWARE_PATTERN =\n  /^\\+([^+().][^().]*)\\.middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst GLOBAL_MIDDLEWARE_PATTERN = /^\\+global-middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_PATTERN = /^([^+().][^().]*)\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst CATEGORY_PATTERN = /^\\(.+\\)$/;\n\n/**\n * Handles discovery and parsing of command and middleware files in the filesystem.\n */\nexport class CommandsRouter {\n  /**\n   * @private\n   * @internal\n   */\n  private commands = new Collection<string, Command>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private middlewares = new Collection<string, Middleware>();\n\n  /**\n   * Creates a new CommandsRouter instance.\n   * @param options - Configuration options for the router\n   */\n  public constructor(private readonly options: CommandsRouterOptions) {}\n\n  /**\n   * Populates the router with existing command and middleware data.\n   * @param data - Parsed command data to populate with\n   */\n  public populate(data: ParsedCommandData) {\n    for (const [id, command] of Object.entries(data.commands)) {\n      this.commands.set(id, command);\n    }\n\n    for (const [id, middleware] of Object.entries(data.middlewares)) {\n      this.middlewares.set(id, middleware);\n    }\n  }\n\n  /**\n   * Checks if the configured entrypoint path exists.\n   * @returns True if the path exists\n   */\n  public isValidPath(): boolean {\n    return existsSync(this.options.entrypoint);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommand(name: string): boolean {\n    return COMMAND_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isMiddleware(name: string): boolean {\n    return (\n      MIDDLEWARE_PATTERN.test(name) ||\n      GLOBAL_MIDDLEWARE_PATTERN.test(name) ||\n      COMMAND_MIDDLEWARE_PATTERN.test(name)\n    );\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCategory(name: string): boolean {\n    return CATEGORY_PATTERN.test(name);\n  }\n\n  /**\n   * Clears all loaded commands and middleware.\n   */\n  public clear() {\n    this.commands.clear();\n    this.middlewares.clear();\n  }\n\n  /**\n   * Scans the filesystem for commands and middleware files.\n   * @returns Parsed command data\n   */\n  public async scan() {\n    const entries = await readdir(this.options.entrypoint, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      const fullPath = join(this.options.entrypoint, entry.name);\n\n      if (entry.isDirectory()) {\n        const category = this.isCategory(entry.name)\n          ? entry.name.slice(1, -1)\n          : null;\n\n        await this.traverse(fullPath, category);\n      } else {\n        await this.handle(entry);\n      }\n    }\n\n    await this.applyMiddlewares();\n\n    return this.toJSON();\n  }\n\n  /**\n   * Gets the raw command and middleware collections.\n   * @returns Object containing commands and middlewares collections\n   */\n  public getData() {\n    return {\n      commands: this.commands,\n      middlewares: this.middlewares,\n    };\n  }\n\n  /**\n   * Converts the loaded data to a JSON-serializable format.\n   * @returns Plain object with commands and middlewares\n   */\n  public toJSON() {\n    return {\n      commands: Object.fromEntries(this.commands.entries()),\n      middlewares: Object.fromEntries(this.middlewares.entries()),\n    };\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async traverse(path: string, category: string | null) {\n    const entries = await readdir(path, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      // ignore _ prefixed files\n      if (entry.name.startsWith('_')) continue;\n\n      if (entry.isFile()) {\n        if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) {\n          await this.handle(entry, category);\n        }\n      } else if (\n        entry.isDirectory() &&\n        this.isCategory(entry.name) &&\n        category\n      ) {\n        // nested category\n        const nestedCategory = this.isCategory(entry.name)\n          ? `${category}:${entry.name.slice(1, -1)}`\n          : null;\n        await this.traverse(join(path, entry.name), nestedCategory);\n      }\n\n      // TODO: handle subcommands\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async handle(entry: Dirent, category: string | null = null) {\n    const name = entry.name;\n    const path = join(entry.parentPath, entry.name);\n\n    if (this.isCommand(name)) {\n      const command: Command = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        category,\n        parentPath: entry.parentPath,\n        relativePath: this.replaceEntrypoint(path),\n        middlewares: [],\n      };\n\n      this.commands.set(command.id, command);\n    } else if (this.isMiddleware(name)) {\n      const middleware: Middleware = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        relativePath: this.replaceEntrypoint(path),\n        parentPath: entry.parentPath,\n        global: GLOBAL_MIDDLEWARE_PATTERN.test(name),\n        command: COMMAND_MIDDLEWARE_PATTERN.test(name)\n          ? name.match(COMMAND_MIDDLEWARE_PATTERN)?.[1] || null\n          : null,\n      };\n\n      this.middlewares.set(middleware.id, middleware);\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private applyMiddlewares() {\n    this.commands.forEach((command) => {\n      const commandPath = command.parentPath;\n      const allMiddlewares = Array.from(this.middlewares.values());\n\n      const commandSpecificMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.command === command.name)\n        .map((middleware) => middleware.id);\n\n      const directorySpecificMiddlewares = allMiddlewares\n        .filter(\n          (middleware) =>\n            !middleware.global &&\n            !middleware.command &&\n            middleware.parentPath === commandPath,\n        )\n        .map((middleware) => middleware.id);\n\n      const globalMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.global)\n        .map((middleware) => middleware.id);\n\n      command.middlewares = [\n        ...globalMiddlewares,\n        ...directorySpecificMiddlewares,\n        ...commandSpecificMiddlewares,\n      ];\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private replaceEntrypoint(path: string) {\n    const normalized = normalize(path);\n    return normalized.replace(this.options.entrypoint, '');\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"CommandsRouter.js","names":[],"sources":["../../../src/app/router/CommandsRouter.ts"],"sourcesContent":["import { Collection } from 'discord.js';\nimport { Dirent, existsSync } from 'node:fs';\nimport { readdir } from 'node:fs/promises';\nimport { basename, extname, join, normalize } from 'node:path';\nimport {\n  CommandRouteDiagnostic,\n  CommandTreeNode,\n  CommandTreeNodeKind,\n  CompiledCommandRoute,\n} from './CommandTree';\n\n/**\n * Represents a command with its metadata and middleware associations.\n */\nexport interface Command {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  middlewares: Array<string>;\n  category: string | null;\n}\n\n/**\n * Represents a middleware with its metadata and scope.\n */\nexport interface Middleware {\n  id: string;\n  name: string;\n  path: string;\n  relativePath: string;\n  parentPath: string;\n  global: boolean;\n  command: string | null;\n}\n\n/**\n * Data structure containing parsed commands, middleware, and tree data.\n */\nexport interface ParsedCommandData {\n  commands: Record<string, Command>;\n  middlewares: Record<string, Middleware>;\n  treeNodes?: Record<string, CommandTreeNode>;\n  compiledRoutes?: Record<string, CompiledCommandRoute>;\n  diagnostics?: CommandRouteDiagnostic[];\n}\n\n/**\n * Configuration options for the commands router.\n */\nexport interface CommandsRouterOptions {\n  entrypoint: string;\n}\n\nconst ROOT_NODE_ID = '__commandkit_router_root__';\n\n/**\n * @private\n * @internal\n */\nconst MIDDLEWARE_PATTERN = /^\\+middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_MIDDLEWARE_PATTERN =\n  /^\\+([^+().][^().]*)\\.middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst GLOBAL_MIDDLEWARE_PATTERN = /^\\+global-middleware\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_PATTERN = /^([^+().][^().]*)\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst CATEGORY_PATTERN = /^\\(.+\\)$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_DIRECTORY_PATTERN = /^\\[([^\\][\\\\\\/]+)\\]$/;\n\n/**\n * @private\n * @internal\n */\nconst GROUP_DIRECTORY_PATTERN = /^\\{([^}{\\\\\\/]+)\\}$/;\n\n/**\n * @private\n * @internal\n */\nconst COMMAND_DEFINITION_PATTERN = /^command\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst GROUP_DEFINITION_PATTERN = /^group\\.(m|c)?(j|t)sx?$/;\n\n/**\n * @private\n * @internal\n */\nconst SUBCOMMAND_FILE_PATTERN =\n  /^([^+().][^().]*)\\.subcommand\\.(m|c)?(j|t)sx?$/;\n\n/**\n * Handles discovery and parsing of command and middleware files in the filesystem.\n */\nexport class CommandsRouter {\n  /**\n   * @private\n   * @internal\n   */\n  private commands = new Collection<string, Command>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private middlewares = new Collection<string, Middleware>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private treeNodes = new Collection<string, CommandTreeNode>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private compiledRoutes = new Collection<string, CompiledCommandRoute>();\n\n  /**\n   * @private\n   * @internal\n   */\n  private diagnostics: CommandRouteDiagnostic[] = [];\n\n  /**\n   * Creates a new CommandsRouter instance.\n   * @param options - Configuration options for the router\n   */\n  public constructor(private readonly options: CommandsRouterOptions) {}\n\n  /**\n   * Populates the router with existing command, middleware, and tree data.\n   * @param data - Parsed command data to populate with\n   */\n  public populate(data: ParsedCommandData): void {\n    this.clear();\n\n    for (const [id, command] of Object.entries(data.commands)) {\n      this.commands.set(id, command);\n    }\n\n    for (const [id, middleware] of Object.entries(data.middlewares)) {\n      this.middlewares.set(id, middleware);\n    }\n\n    for (const [id, node] of Object.entries(data.treeNodes ?? {})) {\n      this.treeNodes.set(id, node);\n    }\n\n    for (const [key, route] of Object.entries(data.compiledRoutes ?? {})) {\n      this.compiledRoutes.set(key, route);\n    }\n\n    this.diagnostics = [...(data.diagnostics ?? [])];\n  }\n\n  /**\n   * Checks if the configured entrypoint path exists.\n   * @returns True if the path exists\n   */\n  public isValidPath(): boolean {\n    return existsSync(this.options.entrypoint);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommand(name: string): boolean {\n    return COMMAND_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isMiddleware(name: string): boolean {\n    return (\n      MIDDLEWARE_PATTERN.test(name) ||\n      GLOBAL_MIDDLEWARE_PATTERN.test(name) ||\n      COMMAND_MIDDLEWARE_PATTERN.test(name)\n    );\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCategory(name: string): boolean {\n    return CATEGORY_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommandDirectory(name: string): boolean {\n    return COMMAND_DIRECTORY_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isGroupDirectory(name: string): boolean {\n    return GROUP_DIRECTORY_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isCommandDefinition(name: string): boolean {\n    return COMMAND_DEFINITION_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isGroupDefinition(name: string): boolean {\n    return GROUP_DEFINITION_PATTERN.test(name);\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private isSubcommandFile(name: string): boolean {\n    return SUBCOMMAND_FILE_PATTERN.test(name);\n  }\n\n  /**\n   * Clears all loaded commands, middleware, and compiled tree data.\n   */\n  public clear(): void {\n    this.commands.clear();\n    this.middlewares.clear();\n    this.treeNodes.clear();\n    this.compiledRoutes.clear();\n    this.diagnostics = [];\n  }\n\n  /**\n   * Scans the filesystem for commands and middleware files.\n   * @returns Parsed command data\n   */\n  public async scan(): Promise<ParsedCommandData> {\n    this.clear();\n    this.initializeRootNode();\n\n    await this.traverseDirectory(\n      this.options.entrypoint,\n      'normal',\n      null,\n      ROOT_NODE_ID,\n    );\n\n    await this.applyMiddlewares();\n    this.compileTree();\n\n    return this.toJSON();\n  }\n\n  /**\n   * Gets the raw command, middleware, and compiled tree collections.\n   * @returns Object containing router collections\n   */\n  public getData(): {\n    commands: Collection<string, Command>;\n    middlewares: Collection<string, Middleware>;\n    treeNodes: Collection<string, CommandTreeNode>;\n    compiledRoutes: Collection<string, CompiledCommandRoute>;\n    diagnostics: CommandRouteDiagnostic[];\n  } {\n    return {\n      commands: this.commands,\n      middlewares: this.middlewares,\n      treeNodes: this.treeNodes,\n      compiledRoutes: this.compiledRoutes,\n      diagnostics: this.diagnostics,\n    };\n  }\n\n  /**\n   * Gets only the internal command tree and compiled route data.\n   * @returns Object containing tree data\n   */\n  public getTreeData(): {\n    treeNodes: Collection<string, CommandTreeNode>;\n    compiledRoutes: Collection<string, CompiledCommandRoute>;\n    diagnostics: CommandRouteDiagnostic[];\n  } {\n    return {\n      treeNodes: this.treeNodes,\n      compiledRoutes: this.compiledRoutes,\n      diagnostics: this.diagnostics,\n    };\n  }\n\n  /**\n   * Converts the loaded data to a JSON-serializable format.\n   * @returns Plain object with commands, middleware, and tree data\n   */\n  public toJSON(): ParsedCommandData {\n    return {\n      commands: Object.fromEntries(this.commands.entries()),\n      middlewares: Object.fromEntries(this.middlewares.entries()),\n      treeNodes: Object.fromEntries(this.treeNodes.entries()),\n      compiledRoutes: Object.fromEntries(this.compiledRoutes.entries()),\n      diagnostics: this.diagnostics,\n    };\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private initializeRootNode() {\n    this.treeNodes.set(ROOT_NODE_ID, {\n      id: ROOT_NODE_ID,\n      source: 'root',\n      kind: 'root',\n      token: '',\n      route: [],\n      category: null,\n      parentId: null,\n      childIds: [],\n      directoryPath: this.options.entrypoint,\n      definitionPath: null,\n      relativePath: '',\n      shorthand: false,\n      executable: false,\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async traverseDirectory(\n    path: string,\n    state: 'normal' | 'command' | 'group',\n    category: string | null,\n    parentId: string,\n    token?: string,\n  ) {\n    let node: CommandTreeNode | null = null;\n\n    if (state === 'command') {\n      node = this.createTreeNode({\n        source: 'directory',\n        token: token!,\n        category,\n        parentId,\n        directoryPath: path,\n        definitionPath: null,\n        shorthand: false,\n      });\n      if (!node) return;\n    } else if (state === 'group') {\n      node = this.createTreeNode({\n        source: 'group',\n        token: token!,\n        category,\n        parentId,\n        directoryPath: path,\n        definitionPath: null,\n        shorthand: false,\n      });\n      if (!node) return;\n    }\n\n    const currentNodeId = node ? node.id : parentId;\n\n    const entries = await readdir(path, {\n      withFileTypes: true,\n    });\n\n    for (const entry of entries) {\n      if (entry.name.startsWith('_')) continue;\n\n      const fullPath = join(path, entry.name);\n\n      if (entry.isFile()) {\n        if (state === 'command') {\n          if (this.isCommandDefinition(entry.name)) {\n            node!.definitionPath = fullPath;\n            node!.relativePath = this.replaceEntrypoint(fullPath);\n            continue;\n          }\n          if (this.isSubcommandFile(entry.name)) {\n            this.createTreeNode({\n              source: 'shorthand',\n              token: entry.name.match(SUBCOMMAND_FILE_PATTERN)![1],\n              category,\n              parentId: currentNodeId,\n              directoryPath: path,\n              definitionPath: fullPath,\n              shorthand: true,\n            });\n            continue;\n          }\n          if (this.isMiddleware(entry.name)) {\n            await this.handle(entry, category);\n            continue;\n          }\n          if (this.isCommand(entry.name)) {\n            this.addDiagnostic(\n              'UNSUPPORTED_FILE_IN_COMMAND_DIRECTORY',\n              'Only command.ts, middleware files, and subcommand shorthand files are supported inside a command directory.',\n              fullPath,\n            );\n          }\n        } else if (state === 'group') {\n          if (this.isGroupDefinition(entry.name)) {\n            node!.definitionPath = fullPath;\n            node!.relativePath = this.replaceEntrypoint(fullPath);\n            continue;\n          }\n          if (this.isSubcommandFile(entry.name)) {\n            this.createTreeNode({\n              source: 'shorthand',\n              token: entry.name.match(SUBCOMMAND_FILE_PATTERN)![1],\n              category,\n              parentId: currentNodeId,\n              directoryPath: path,\n              definitionPath: fullPath,\n              shorthand: true,\n            });\n            continue;\n          }\n          if (this.isMiddleware(entry.name)) {\n            await this.handle(entry, category);\n            continue;\n          }\n          if (this.isCommand(entry.name)) {\n            this.addDiagnostic(\n              'UNSUPPORTED_FILE_IN_GROUP_DIRECTORY',\n              'Only group.ts, middleware files, and subcommand shorthand files are supported inside a group directory.',\n              fullPath,\n            );\n          }\n        } else {\n          if (this.isSubcommandFile(entry.name)) {\n            if (currentNodeId === ROOT_NODE_ID) {\n              this.addDiagnostic(\n                'ORPHAN_SUBCOMMAND_FILE',\n                'Subcommand shorthand files must be nested inside a command or group directory.',\n                fullPath,\n              );\n            } else {\n              this.createTreeNode({\n                source: 'shorthand',\n                token: entry.name.match(SUBCOMMAND_FILE_PATTERN)![1],\n                category,\n                parentId: currentNodeId,\n                directoryPath: path,\n                definitionPath: fullPath,\n                shorthand: true,\n              });\n            }\n            continue;\n          }\n          if (this.isCommand(entry.name) || this.isMiddleware(entry.name)) {\n            const result = await this.handle(entry, category);\n            if (result.command) {\n              this.createFlatCommandNode(result.command);\n            }\n          }\n        }\n        continue;\n      }\n\n      if (!entry.isDirectory()) continue;\n\n      if (this.isCommandDirectory(entry.name)) {\n        if (state === 'command' || state === 'group') {\n          await this.traverseDirectory(\n            fullPath,\n            'command',\n            category,\n            currentNodeId,\n            entry.name.match(COMMAND_DIRECTORY_PATTERN)![1],\n          );\n        } else if (currentNodeId !== ROOT_NODE_ID) {\n          this.addDiagnostic(\n            'NESTED_COMMAND_NOT_ALLOWED',\n            'Command directories cannot be nested under group or subcommand directories unless they are part of a hierarchical structure.',\n            fullPath,\n          );\n        } else {\n          await this.traverseDirectory(\n            fullPath,\n            'command',\n            category,\n            ROOT_NODE_ID,\n            entry.name.match(COMMAND_DIRECTORY_PATTERN)![1],\n          );\n        }\n        continue;\n      }\n\n      if (this.isGroupDirectory(entry.name)) {\n        if (currentNodeId === ROOT_NODE_ID) {\n          this.addDiagnostic(\n            'ROOT_GROUP_NOT_ALLOWED',\n            'Group directories must be nested inside a command directory.',\n            fullPath,\n          );\n        } else {\n          await this.traverseDirectory(\n            fullPath,\n            'group',\n            category,\n            currentNodeId,\n            entry.name.match(GROUP_DIRECTORY_PATTERN)![1],\n          );\n        }\n        continue;\n      }\n\n      if (this.isCategory(entry.name)) {\n        const nestedCategory = category\n          ? `${category}:${entry.name.slice(1, -1)}`\n          : entry.name.slice(1, -1);\n        await this.traverseDirectory(\n          fullPath,\n          'normal',\n          nestedCategory,\n          currentNodeId,\n        );\n        continue;\n      }\n\n      await this.traverseDirectory(fullPath, 'normal', category, currentNodeId);\n    }\n\n    if (state === 'command' && node && !node.definitionPath) {\n      this.addDiagnostic(\n        'MISSING_COMMAND_DEFINITION',\n        'Command directories must include a command.ts file.',\n        path,\n      );\n    } else if (state === 'group' && node && !node.definitionPath) {\n      this.addDiagnostic(\n        'MISSING_GROUP_DEFINITION',\n        'Group directories must include a group.ts file.',\n        path,\n      );\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private createFlatCommandNode(command: Command) {\n    this.createTreeNode({\n      id: command.id,\n      source: 'flat',\n      token: command.name,\n      category: command.category,\n      parentId: ROOT_NODE_ID,\n      directoryPath: command.parentPath,\n      definitionPath: command.path,\n      shorthand: false,\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private createTreeNode(options: {\n    id?: string;\n    source: Exclude<CommandTreeNode['source'], 'root'>;\n    token: string;\n    category: string | null;\n    parentId: string;\n    directoryPath: string;\n    definitionPath: string | null;\n    shorthand: boolean;\n  }) {\n    const parent = this.treeNodes.get(options.parentId);\n\n    if (!parent) {\n      this.addDiagnostic(\n        'MISSING_PARENT_NODE',\n        `Unable to create command tree node \"${options.token}\" because its parent node was not found.`,\n        options.directoryPath,\n      );\n      return null;\n    }\n\n    const duplicate = parent.childIds.some((childId) => {\n      return this.treeNodes.get(childId)?.token === options.token;\n    });\n\n    if (duplicate) {\n      this.addDiagnostic(\n        'DUPLICATE_SIBLING_TOKEN',\n        `Duplicate command token \"${options.token}\" found under the same parent.`,\n        options.definitionPath ?? options.directoryPath,\n      );\n      return null;\n    }\n\n    const route = [...parent.route, options.token];\n    const node: CommandTreeNode = {\n      id: options.id ?? crypto.randomUUID(),\n      source: options.source,\n      kind: this.resolveNodeKind(options.source, route.length),\n      token: options.token,\n      route,\n      category: options.category,\n      parentId: options.parentId,\n      childIds: [],\n      directoryPath: options.directoryPath,\n      definitionPath: options.definitionPath,\n      relativePath: this.replaceEntrypoint(\n        options.definitionPath ?? options.directoryPath,\n      ),\n      shorthand: options.shorthand,\n      executable: false,\n    };\n\n    this.treeNodes.set(node.id, node);\n    parent.childIds.push(node.id);\n\n    return node;\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private resolveNodeKind(\n    source: CommandTreeNode['source'],\n    depth: number,\n  ): CommandTreeNodeKind {\n    switch (source) {\n      case 'root':\n        return 'root';\n      case 'flat':\n        return 'flat';\n      case 'group':\n        return 'group';\n      case 'shorthand':\n        return 'subcommand';\n      case 'directory':\n        return depth === 1 ? 'command' : 'subcommand';\n      default:\n        return source satisfies never;\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private compileTree() {\n    this.compiledRoutes.clear();\n\n    for (const node of this.treeNodes.values()) {\n      if (node.id === ROOT_NODE_ID) continue;\n\n      const hasChildren = node.childIds.length > 0;\n      node.executable =\n        !!node.definitionPath && node.kind !== 'group' && !hasChildren;\n\n      if (node.kind === 'subcommand' && hasChildren) {\n        this.addDiagnostic(\n          'SUBCOMMAND_CANNOT_HAVE_CHILDREN',\n          `Subcommand \"${node.route.join('.')}\" cannot contain child command nodes.`,\n          node.definitionPath ?? node.directoryPath,\n        );\n      }\n\n      if (node.kind === 'command') {\n        const childKinds = new Set(\n          node.childIds\n            .map((childId) => this.treeNodes.get(childId)?.kind)\n            .filter(Boolean),\n        );\n\n        if (childKinds.has('group') && childKinds.has('subcommand')) {\n          this.addDiagnostic(\n            'MIXED_ROOT_CHILDREN',\n            `Command \"${node.route.join('.')}\" cannot mix direct subcommands and subcommand groups.`,\n            node.definitionPath ?? node.directoryPath,\n          );\n        }\n      }\n\n      if (!node.executable || !node.definitionPath) continue;\n\n      const key = node.route.join('.');\n      const routeKind = node.kind as Exclude<\n        CommandTreeNodeKind,\n        'root' | 'group'\n      >;\n      this.compiledRoutes.set(key, {\n        id: node.id,\n        key,\n        kind: routeKind,\n        token: node.token,\n        route: node.route,\n        category: node.category,\n        definitionPath: node.definitionPath,\n        relativePath: this.replaceEntrypoint(node.definitionPath),\n        nodeId: node.id,\n        middlewares: this.collectCompiledMiddlewares(node),\n      });\n    }\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private collectCompiledMiddlewares(node: CommandTreeNode) {\n    const allMiddlewares = Array.from(this.middlewares.values());\n    const globalMiddlewares = allMiddlewares\n      .filter((middleware) => middleware.global)\n      .map((middleware) => middleware.id);\n\n    const directoryMiddlewares = allMiddlewares\n      .filter((middleware) => {\n        return (\n          !middleware.global &&\n          !middleware.command &&\n          middleware.parentPath === node.directoryPath\n        );\n      })\n      .map((middleware) => middleware.id);\n\n    const commandSpecificMiddlewares = allMiddlewares\n      .filter((middleware) => {\n        return (\n          middleware.command === node.token &&\n          middleware.parentPath === node.directoryPath\n        );\n      })\n      .map((middleware) => middleware.id);\n\n    return [\n      ...globalMiddlewares,\n      ...directoryMiddlewares,\n      ...commandSpecificMiddlewares,\n    ];\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private addDiagnostic(code: string, message: string, path: string) {\n    this.diagnostics.push({\n      code,\n      message,\n      path: normalize(path),\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private async handle(entry: Dirent, category: string | null = null) {\n    const name = entry.name;\n    const path = join(entry.parentPath, entry.name);\n\n    if (this.isCommand(name)) {\n      const command: Command = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        category,\n        parentPath: entry.parentPath,\n        relativePath: this.replaceEntrypoint(path),\n        middlewares: [],\n      };\n\n      this.commands.set(command.id, command);\n      return { command };\n    }\n\n    if (this.isMiddleware(name)) {\n      const middleware: Middleware = {\n        id: crypto.randomUUID(),\n        name: basename(path, extname(path)),\n        path,\n        relativePath: this.replaceEntrypoint(path),\n        parentPath: entry.parentPath,\n        global: GLOBAL_MIDDLEWARE_PATTERN.test(name),\n        command: COMMAND_MIDDLEWARE_PATTERN.test(name)\n          ? name.match(COMMAND_MIDDLEWARE_PATTERN)?.[1] || null\n          : null,\n      };\n\n      this.middlewares.set(middleware.id, middleware);\n      return { middleware };\n    }\n\n    return {};\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private applyMiddlewares() {\n    this.commands.forEach((command) => {\n      const commandPath = command.parentPath;\n      const allMiddlewares = Array.from(this.middlewares.values());\n\n      const commandSpecificMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.command === command.name)\n        .map((middleware) => middleware.id);\n\n      const directorySpecificMiddlewares = allMiddlewares\n        .filter((middleware) => {\n          return (\n            !middleware.global &&\n            !middleware.command &&\n            middleware.parentPath === commandPath\n          );\n        })\n        .map((middleware) => middleware.id);\n\n      const globalMiddlewares = allMiddlewares\n        .filter((middleware) => middleware.global)\n        .map((middleware) => middleware.id);\n\n      command.middlewares = [\n        ...globalMiddlewares,\n        ...directorySpecificMiddlewares,\n        ...commandSpecificMiddlewares,\n      ];\n    });\n  }\n\n  /**\n   * @private\n   * @internal\n   */\n  private replaceEntrypoint(path: string) {\n    const normalized = normalize(path);\n    return normalized.replace(this.options.entrypoint, '');\n  }\n}\n"],"mappings":"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"}

package/dist/app/router/EventsRouter.d.ts

@@ -1,2 +1,2 @@
-import { i as ParsedEvent, n as EventsRouterOptions, r as EventsTree, t as EventsRouter } from "../../EventsRouter-EuuSu6NH.js";
+import { i as ParsedEvent, n as EventsRouterOptions, r as EventsTree, t as EventsRouter } from "../../EventsRouter-Dyr_oJJD.js";
 export { EventsRouter, EventsRouterOptions, EventsTree, ParsedEvent };

package/dist/app/router/index.d.ts

@@ -1,3 +1,4 @@
-import { a as ParsedCommandData, i as Middleware, n as CommandsRouter, r as CommandsRouterOptions, t as Command } from "../../CommandsRouter-DiNoF0dq.js";
-import { i as ParsedEvent, n as EventsRouterOptions, r as EventsTree, t as EventsRouter } from "../../EventsRouter-EuuSu6NH.js";
-export { Command, CommandsRouter, CommandsRouterOptions, EventsRouter, EventsRouterOptions, EventsTree, Middleware, ParsedCommandData, ParsedEvent };
+import { a as CompiledCommandRoute, i as CommandTreeNodeSource, n as CommandTreeNode, r as CommandTreeNodeKind, t as CommandRouteDiagnostic } from "../../CommandTree-DwfiCsOl.js";
+import { a as ParsedCommandData, i as Middleware, n as CommandsRouter, r as CommandsRouterOptions, t as Command } from "../../CommandsRouter-D-b3xv38.js";
+import { i as ParsedEvent, n as EventsRouterOptions, r as EventsTree, t as EventsRouter } from "../../EventsRouter-Dyr_oJJD.js";
+export { Command, CommandRouteDiagnostic, CommandTreeNode, CommandTreeNodeKind, CommandTreeNodeSource, CommandsRouter, CommandsRouterOptions, CompiledCommandRoute, EventsRouter, EventsRouterOptions, EventsTree, Middleware, ParsedCommandData, ParsedEvent };

package/dist/checkbox-CvQGiyRe.d.ts

@@ -0,0 +1,28 @@
+import { t as MaybeArray } from "./types-DZy7U-Ld.js";
+import { CheckboxBuilder, CheckboxComponentData, CheckboxGroupBuilder, CheckboxGroupComponentData, CheckboxGroupOptionBuilder } from "discord.js";
+
+//#region src/components/interactive/checkbox/checkbox.d.ts
+interface CheckboxProps extends Omit<CheckboxComponentData, 'type' | 'required'> {
+  id?: number;
+  default?: boolean;
+}
+declare function Checkbox(props: CheckboxProps): CheckboxBuilder;
+interface CheckboxGroupOptionProps {
+  label: string;
+  value: string;
+  description?: string;
+  default?: boolean;
+}
+declare function CheckboxGroupOption(props: CheckboxGroupOptionProps): CheckboxGroupOptionBuilder;
+interface CheckboxGroupProps extends Omit<CheckboxGroupComponentData, 'type' | 'options'> {
+  id?: number;
+  customId: string;
+  children?: MaybeArray<CheckboxGroupOptionBuilder>;
+  minValues?: number;
+  maxValues?: number;
+  required?: boolean;
+}
+declare function CheckboxGroup(props: CheckboxGroupProps): CheckboxGroupBuilder;
+//#endregion
+export { CheckboxGroupProps as a, CheckboxGroupOptionProps as i, CheckboxGroup as n, CheckboxProps as o, CheckboxGroupOption as r, Checkbox as t };
+//# sourceMappingURL=checkbox-CvQGiyRe.d.ts.map

package/dist/cli/build.d.ts

@@ -1,4 +1,4 @@
-import { W as CompilerPlugin } from "../analytics-engine-uBNaD2CQ.js";
+import { W as CompilerPlugin } from "../analytics-engine-BimOLPwO.js";
 import { t as MaybeArray } from "../types-DZy7U-Ld.js";
 
 //#region src/cli/build.d.ts