vimcord 1.0.21 → 1.0.23

package/dist/index.d.mts

@@ -35,6 +35,10 @@ interface CommandPermissions {
 interface CommandMetadata {
     /** Command category for categorizing commands */
     category?: string;
+    /** Command category emoji
+     * @remarks I recommend mapping your own category emojis separately instead of using this
+     */
+    categoryEmoji?: string;
     /** Command tags for categorizing commands */
     tags?: string[];
     /** Command usage examples */
@@ -304,7 +308,8 @@ interface PrefixCommandConfig extends BaseCommandConfig<CommandType.Prefix> {
     description?: string;
 }
 declare class PrefixCommandBuilder extends BaseCommandBuilder<CommandType.Prefix, PrefixCommandConfig> {
-    constructor(config: PrefixCommandConfig);
+    options: PrefixCommandConfig;
+    constructor(options: PrefixCommandConfig);
     /**
      * Specialized execution logic for Prefix Commands.
      */
@@ -350,7 +355,7 @@ interface SlashCommandConfig extends BaseCommandConfig<CommandType.Slash>, BaseA
 }
 declare class SlashCommandBuilder extends BaseCommandBuilder<CommandType.Slash, SlashCommandConfig> {
     builder: AnySlashCommandBuilder;
-    private readonly routes;
+    readonly routes: Map<string, (client: Vimcord<true>, interaction: ChatInputCommandInteraction) => any>;
     constructor(config: SlashCommandConfig);
     private handleExecution;
     private validateBuilder;
@@ -377,14 +382,22 @@ declare abstract class VimcordAppCommandManager<T extends CommandType.Slash | Co
     constructor(client: Vimcord, typeName: string);
     get(name: string): VimcordCommandBuilderByType<T> | undefined;
     /**
-     * Filters and returns commands based on deployment options
+     * Filters and returns commands based on deployment options alphabetically
      */
     getAll(options?: {
         names?: string[];
         fuzzyNames?: string[];
         globalOnly?: boolean;
         ignoreDeploymentOptions?: boolean;
-    }): Map<string, VimcordCommandBuilderByType<T>>;
+    }): VimcordCommandBuilderByType<T>[];
+    /**
+     * Groups commands by category alphabetically
+     */
+    sortByCategory(): {
+        name: string;
+        emoji: string | undefined;
+        commands: VimcordCommandBuilderByType<T>[];
+    }[];
     registerGlobal(options?: {
         commands?: string[];
         fuzzyCommands?: string[];
@@ -412,6 +425,14 @@ declare class VimcordPrefixCommandManager {
     commands: Map<string, VimcordCommandBuilderByType<CommandType.Prefix>>;
     constructor(client: Vimcord);
     resolve(trigger: string): PrefixCommandBuilder | undefined;
+    /**
+     * Groups commands by category alphabetically
+     */
+    sortByCategory(): {
+        name: string;
+        emoji: string | undefined;
+        commands: VimcordCommandBuilderByType<CommandType.Prefix>[];
+    }[];
     importFrom(dir: string | string[], replaceAll?: boolean): Promise<Map<string, PrefixCommandBuilder>>;
 }
 declare class VimcordCommandManager {
@@ -1019,7 +1040,7 @@ declare abstract class BaseCommandBuilder<T extends CommandType, O extends BaseC
     readonly uuid: string;
     readonly commandType: T;
     /** Local command configuration and hooks */
-    protected options: O;
+    readonly options: O;
     /** Internal state for rate limiting across different scopes */
     private readonly rlStores;
     /** * Mapping of CommandTypes to their respective config keys in the Vimcord client

package/dist/index.d.ts

@@ -35,6 +35,10 @@ interface CommandPermissions {
 interface CommandMetadata {
     /** Command category for categorizing commands */
     category?: string;
+    /** Command category emoji
+     * @remarks I recommend mapping your own category emojis separately instead of using this
+     */
+    categoryEmoji?: string;
     /** Command tags for categorizing commands */
     tags?: string[];
     /** Command usage examples */
@@ -304,7 +308,8 @@ interface PrefixCommandConfig extends BaseCommandConfig<CommandType.Prefix> {
     description?: string;
 }
 declare class PrefixCommandBuilder extends BaseCommandBuilder<CommandType.Prefix, PrefixCommandConfig> {
-    constructor(config: PrefixCommandConfig);
+    options: PrefixCommandConfig;
+    constructor(options: PrefixCommandConfig);
     /**
      * Specialized execution logic for Prefix Commands.
      */
@@ -350,7 +355,7 @@ interface SlashCommandConfig extends BaseCommandConfig<CommandType.Slash>, BaseA
 }
 declare class SlashCommandBuilder extends BaseCommandBuilder<CommandType.Slash, SlashCommandConfig> {
     builder: AnySlashCommandBuilder;
-    private readonly routes;
+    readonly routes: Map<string, (client: Vimcord<true>, interaction: ChatInputCommandInteraction) => any>;
     constructor(config: SlashCommandConfig);
     private handleExecution;
     private validateBuilder;
@@ -377,14 +382,22 @@ declare abstract class VimcordAppCommandManager<T extends CommandType.Slash | Co
     constructor(client: Vimcord, typeName: string);
     get(name: string): VimcordCommandBuilderByType<T> | undefined;
     /**
-     * Filters and returns commands based on deployment options
+     * Filters and returns commands based on deployment options alphabetically
      */
     getAll(options?: {
         names?: string[];
         fuzzyNames?: string[];
         globalOnly?: boolean;
         ignoreDeploymentOptions?: boolean;
-    }): Map<string, VimcordCommandBuilderByType<T>>;
+    }): VimcordCommandBuilderByType<T>[];
+    /**
+     * Groups commands by category alphabetically
+     */
+    sortByCategory(): {
+        name: string;
+        emoji: string | undefined;
+        commands: VimcordCommandBuilderByType<T>[];
+    }[];
     registerGlobal(options?: {
         commands?: string[];
         fuzzyCommands?: string[];
@@ -412,6 +425,14 @@ declare class VimcordPrefixCommandManager {
     commands: Map<string, VimcordCommandBuilderByType<CommandType.Prefix>>;
     constructor(client: Vimcord);
     resolve(trigger: string): PrefixCommandBuilder | undefined;
+    /**
+     * Groups commands by category alphabetically
+     */
+    sortByCategory(): {
+        name: string;
+        emoji: string | undefined;
+        commands: VimcordCommandBuilderByType<CommandType.Prefix>[];
+    }[];
     importFrom(dir: string | string[], replaceAll?: boolean): Promise<Map<string, PrefixCommandBuilder>>;
 }
 declare class VimcordCommandManager {
@@ -1019,7 +1040,7 @@ declare abstract class BaseCommandBuilder<T extends CommandType, O extends BaseC
     readonly uuid: string;
     readonly commandType: T;
     /** Local command configuration and hooks */
-    protected options: O;
+    readonly options: O;
     /** Internal state for rate limiting across different scopes */
     private readonly rlStores;
     /** * Mapping of CommandTypes to their respective config keys in the Vimcord client

package/dist/index.js

@@ -663,8 +663,9 @@ var EventBuilder = class _EventBuilder {
 
 // src/builders/prefixCommand.builder.ts
 var PrefixCommandBuilder = class extends BaseCommandBuilder {
-  constructor(config) {
-    super(1 /* Prefix */, config);
+  constructor(options) {
+    super(1 /* Prefix */, options);
+    this.options = options;
     const originalExecute = this.options.execute;
     this.options.execute = async (client, message) => {
       return await this.handleExecution(client, message, originalExecute);
@@ -1374,7 +1375,7 @@ var VimcordAppCommandManager = class {
     return this.commands.get(name);
   }
   /**
-   * Filters and returns commands based on deployment options
+   * Filters and returns commands based on deployment options alphabetically
    */
   getAll(options) {
     const matchedCommands = /* @__PURE__ */ new Map();
@@ -1396,7 +1397,31 @@ var VimcordAppCommandManager = class {
       if (options?.globalOnly && deployment.global === false) continue;
       matchedCommands.set(name, cmd);
     }
-    return matchedCommands;
+    return Array.from(matchedCommands.values()).sort((a, b) => a.builder.name.localeCompare(b.builder.name));
+  }
+  /**
+   * Groups commands by category alphabetically
+   */
+  sortByCategory() {
+    const categories = /* @__PURE__ */ new Map();
+    for (const cmd of this.commands.values()) {
+      const metadata = cmd.options.metadata;
+      if (!metadata?.category) continue;
+      let entry = categories.get(metadata.category);
+      if (!entry) {
+        entry = {
+          name: metadata.category,
+          emoji: metadata.categoryEmoji,
+          commands: []
+        };
+        categories.set(metadata.category, entry);
+      }
+      entry.commands.push(cmd);
+    }
+    return Array.from(categories.values()).sort((a, b) => a.name.localeCompare(b.name)).map((cat) => {
+      cat.commands.sort((a, b) => a.builder.name.localeCompare(b.builder.name));
+      return cat;
+    });
   }
   async registerGlobal(options) {
     const client = await this.client.whenReady();
@@ -1518,6 +1543,30 @@ var VimcordPrefixCommandManager = class {
       );
     });
   }
+  /**
+   * Groups commands by category alphabetically
+   */
+  sortByCategory() {
+    const categories = /* @__PURE__ */ new Map();
+    for (const cmd of this.commands.values()) {
+      const metadata = cmd.options.metadata;
+      if (!metadata?.category) continue;
+      let entry = categories.get(metadata.category);
+      if (!entry) {
+        entry = {
+          name: metadata.category,
+          emoji: metadata.categoryEmoji,
+          commands: []
+        };
+        categories.set(metadata.category, entry);
+      }
+      entry.commands.push(cmd);
+    }
+    return Array.from(categories.values()).sort((a, b) => a.name.localeCompare(b.name)).map((cat) => {
+      cat.commands.sort((a, b) => a.options.name.localeCompare(b.options.name));
+      return cat;
+    });
+  }
   async importFrom(dir, replaceAll = false) {
     if (replaceAll) this.commands.clear();
     const dirs = Array.isArray(dir) ? dir : [dir];
@@ -2175,7 +2224,7 @@ async function retryExponentialBackoff(fn, maxRetries = 3, retryDelay = 1e3) {
 }
 
 // package.json
-var version = "1.0.1";
+var version = "1.0.23";
 
 // src/client.ts
 import { randomUUID as randomUUID3 } from "crypto";