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

package/README.md

@@ -1,5 +1,5 @@
 <div align="center">
-    <img src="https://raw.githubusercontent.com/neplextech/commandkit/main/apps/website/static/img/ckit_logo.svg" width="75%" />
+    <img src="https://raw.githubusercontent.com/neplexlabs/commandkit/main/apps/website/static/img/ckit_logo.svg" width="75%" />
     <br />
     <a href="https://commandkit.dev/discord"><img src="https://img.shields.io/discord/1055188344188973066?color=5865F2&logo=discord&logoColor=white" alt="support server" /></a>
     <a href="https://www.npmjs.com/package/commandkit"><img src="https://img.shields.io/npm/v/commandkit?maxAge=3600" alt="npm version" /></a>

package/cache.cjs

@@ -1,4 +1,5 @@
 const {
+  $ckitiucw,
   cacheTag,
   cacheLife,
   revalidateTag,
@@ -11,6 +12,7 @@ const {
 } = require('@commandkit/cache');
 
 module.exports = {
+  $ckitiucw,
   cacheTag,
   cacheLife,
   revalidateTag,

package/cache.d.ts

@@ -1,4 +1,5 @@
 export {
+  $ckitiucw,
   cacheTag,
   cacheLife,
   revalidateTag,

package/dist/{ActionRow-Bt9qi0Mb.d.ts → ActionRow-DSh9roc5.d.ts}

@@ -1,5 +1,4 @@
-import { n as CommandKitElement, t as AnyCommandKitElement } from "./element-DeLvTMfZ.js";
-
+import { n as CommandKitElement, t as AnyCommandKitElement } from "./element-BMZYAAQ-.js";
 //#region src/components/interactive/action-row/ActionRow.d.ts
 /**
  * The properties for the action row component.
@@ -16,4 +15,4 @@ interface ActionRowProps {
 declare function ActionRow(props: ActionRowProps): CommandKitElement<'action-row'>;
 //#endregion
 export { ActionRowProps as n, ActionRow as t };
-//# sourceMappingURL=ActionRow-Bt9qi0Mb.d.ts.map
+//# sourceMappingURL=ActionRow-DSh9roc5.d.ts.map

package/dist/{Button-DxJLcZIU.d.ts → Button-BPsE5ju0.d.ts}

@@ -1,9 +1,8 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as CommandKitButtonBuilderOnEnd, i as CommandKitButtonBuilderInteractionCollectorDispatchContextData, r as CommandKitButtonBuilderInteractionCollectorDispatch } from "./ButtonKit-BfcyvWfj.js";
-import { n as CommandKitElement } from "./element-DeLvTMfZ.js";
-import { t as MaybeArray } from "./types-DZy7U-Ld.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as CommandKitButtonBuilderOnEnd, i as CommandKitButtonBuilderInteractionCollectorDispatchContextData, r as CommandKitButtonBuilderInteractionCollectorDispatch } from "./ButtonKit-CNPmVg3h.js";
+import { n as CommandKitElement } from "./element-BMZYAAQ-.js";
+import { t as MaybeArray } from "./types-ur7SvktF.js";
 import { ButtonStyle, ComponentEmojiResolvable } from "discord.js";
-
 //#region src/components/interactive/button/Button.d.ts
 /**
  * The button children type.
@@ -35,4 +34,4 @@ interface ButtonProps {
 declare function Button(props: ButtonProps): CommandKitElement<'button-kit'>;
 //#endregion
 export { ButtonChildrenLike as n, ButtonProps as r, Button as t };
-//# sourceMappingURL=Button-DxJLcZIU.d.ts.map
+//# sourceMappingURL=Button-BPsE5ju0.d.ts.map

package/dist/{ButtonKit-BfcyvWfj.d.ts → ButtonKit-CNPmVg3h.d.ts}

@@ -1,6 +1,5 @@
-import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
+import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
 import { Awaitable, ButtonBuilder, ButtonInteraction, Events } from "discord.js";
-
 //#region src/components/interactive/button/ButtonKit.d.ts
 /**
  * The predicate function that filters button interactions.
@@ -83,4 +82,4 @@ declare class ButtonKit extends ButtonBuilder {
 }
 //#endregion
 export { CommandKitButtonBuilderOnEnd as a, CommandKitButtonBuilderInteractionCollectorDispatchContextData as i, ButtonKitPredicate as n, OnButtonKitClick as o, CommandKitButtonBuilderInteractionCollectorDispatch as r, OnButtonKitEnd as s, ButtonKit as t };
-//# sourceMappingURL=ButtonKit-BfcyvWfj.d.ts.map
+//# sourceMappingURL=ButtonKit-CNPmVg3h.d.ts.map

package/dist/{ChannelSelectMenuKit-DYkudikb.d.ts → ChannelSelectMenuKit-CcOdaLQ6.d.ts}

@@ -1,7 +1,6 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
 import { ChannelSelectMenuBuilder, ChannelSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/ChannelSelectMenuKit.d.ts
 /**
  * Type for the handler function that is called when the channel select menu is submitted.
@@ -63,4 +62,4 @@ declare class ChannelSelectMenuKit extends ChannelSelectMenuBuilder {
 }
 //#endregion
 export { ChannelSelectMenuKitPredicate as n, OnChannelSelectMenuKitSubmit as r, ChannelSelectMenuKit as t };
-//# sourceMappingURL=ChannelSelectMenuKit-DYkudikb.d.ts.map
+//# sourceMappingURL=ChannelSelectMenuKit-CcOdaLQ6.d.ts.map

package/dist/{CommandTree-DwfiCsOl.d.ts → CommandTree-qu-8oAEV.d.ts}

@@ -52,4 +52,4 @@ interface CommandRouteDiagnostic {
 }
 //#endregion
 export { CompiledCommandRoute as a, CommandTreeNodeSource as i, CommandTreeNode as n, CommandTreeNodeKind as r, CommandRouteDiagnostic as t };
-//# sourceMappingURL=CommandTree-DwfiCsOl.d.ts.map
+//# sourceMappingURL=CommandTree-qu-8oAEV.d.ts.map

package/dist/{CommandsRouter-D-b3xv38.d.ts → CommandsRouter-Co225Ae5.d.ts}

@@ -1,6 +1,5 @@
-import { a as CompiledCommandRoute, n as CommandTreeNode, t as CommandRouteDiagnostic } from "./CommandTree-DwfiCsOl.js";
+import { a as CompiledCommandRoute, n as CommandTreeNode, t as CommandRouteDiagnostic } from "./CommandTree-qu-8oAEV.js";
 import { Collection } from "discord.js";
-
 //#region src/app/router/CommandsRouter.d.ts
 /**
  * Represents a command with its metadata and middleware associations.
@@ -42,6 +41,7 @@ interface ParsedCommandData {
 interface CommandsRouterOptions {
   entrypoint: string;
 }
+type RouterFileChangeType = 'add' | 'change' | 'unlink' | 'unlinkDir';
 /**
  * Handles discovery and parsing of command and middleware files in the filesystem.
  */
@@ -136,6 +136,11 @@ declare class CommandsRouter {
    * @returns Parsed command data
    */
   scan(): Promise<ParsedCommandData>;
+  /**
+   * Incrementally updates only the top-level command subtree affected by a file change.
+   * Falls back to a full scan when the changed path cannot be safely scoped.
+   */
+  scanIncremental(changedPath: string, _changeType?: RouterFileChangeType): Promise<ParsedCommandData>;
   /**
    * Gets the raw command, middleware, and compiled tree collections.
    * @returns Object containing router collections
@@ -166,6 +171,16 @@ declare class CommandsRouter {
    * @internal
    */
   private initializeRootNode;
+  /**
+   * @private
+   * @internal
+   */
+  private ensureRootNode;
+  /**
+   * @private
+   * @internal
+   */
+  private pruneCommandSubtree;
   /**
    * @private
    * @internal
@@ -216,7 +231,12 @@ declare class CommandsRouter {
    * @internal
    */
   private replaceEntrypoint;
+  /**
+   * @private
+   * @internal
+   */
+  private isWithinPath;
 }
 //#endregion
-export { ParsedCommandData as a, Middleware as i, CommandsRouter as n, CommandsRouterOptions as r, Command as t };
-//# sourceMappingURL=CommandsRouter-D-b3xv38.d.ts.map
+export { ParsedCommandData as a, Middleware as i, CommandsRouter as n, RouterFileChangeType as o, CommandsRouterOptions as r, Command as t };
+//# sourceMappingURL=CommandsRouter-Co225Ae5.d.ts.map

package/dist/{EventInterceptor-D9JKMcfi.d.ts → EventInterceptor-wg378vJp.d.ts}

@@ -1,5 +1,4 @@
 import { Awaitable, Client, ClientEvents } from "discord.js";
-
 //#region src/components/common/EventInterceptor.d.ts
 interface EventInterceptorContextData<E extends keyof ClientEvents> {
   /**
@@ -88,4 +87,4 @@ declare class EventInterceptor {
 }
 //#endregion
 export { EventInterceptorContextData as n, EventInterceptorErrorHandler as r, EventInterceptor as t };
-//# sourceMappingURL=EventInterceptor-D9JKMcfi.d.ts.map
+//# sourceMappingURL=EventInterceptor-wg378vJp.d.ts.map

package/dist/{EventsRouter-Dyr_oJJD.d.ts → EventsRouter-Bt63ZuEF.d.ts}

@@ -1,4 +1,5 @@
 //#region src/app/router/EventsRouter.d.ts
+type EventsRouterFileChangeType = 'add' | 'change' | 'unlink' | 'unlinkDir';
 /**
  * Configuration options for the EventsRouter
  * @interface EventsRouterOptions
@@ -61,6 +62,10 @@ declare class EventsRouter {
    * Clear all parsed events
    */
   clear(): void;
+  /**
+   * Populates router state from pre-resolved event metadata.
+   */
+  populate(events: EventsTree): void;
   /**
    * Reload and re-scan the entrypoint directory for events
    * @returns Promise resolving to the updated events tree
@@ -71,6 +76,10 @@ declare class EventsRouter {
    * @returns Promise resolving to the events tree
    */
   scan(): Promise<EventsTree>;
+  /**
+   * Incrementally rescans only the event subtree impacted by a changed path.
+   */
+  scanIncremental(changedPath: string, _changeType?: EventsRouterFileChangeType): Promise<EventsTree>;
   /**
    * Convert the internal events Collection to a plain object
    * @returns Events tree as a plain object
@@ -84,7 +93,17 @@ declare class EventsRouter {
    * @returns Promise resolving to the parsed event metadata
    */
   private scanEvent;
+  /**
+   * @private
+   * @internal
+   */
+  private isWithinPath;
+  /**
+   * @private
+   * @internal
+   */
+  private resolveTopLevelBranch;
 }
 //#endregion
-export { ParsedEvent as i, EventsRouterOptions as n, EventsTree as r, EventsRouter as t };
-//# sourceMappingURL=EventsRouter-Dyr_oJJD.d.ts.map
+export { ParsedEvent as a, EventsTree as i, EventsRouterFileChangeType as n, EventsRouterOptions as r, EventsRouter as t };
+//# sourceMappingURL=EventsRouter-Bt63ZuEF.d.ts.map

package/dist/{MentionableSelectMenuKit-Mu4xqP6B.d.ts → MentionableSelectMenuKit-8_Nkgn_a.d.ts}

@@ -1,7 +1,6 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
 import { MentionableSelectMenuBuilder, MentionableSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/MentionableSelectMenuKit.d.ts
 /**
  * Type for the handler function that is called when the mentionable select menu is submitted.
@@ -58,4 +57,4 @@ declare class MentionableSelectMenuKit extends MentionableSelectMenuBuilder {
 }
 //#endregion
 export { MentionableSelectMenuKitPredicate as n, OnMentionableSelectMenuKitSubmit as r, MentionableSelectMenuKit as t };
-//# sourceMappingURL=MentionableSelectMenuKit-Mu4xqP6B.d.ts.map
+//# sourceMappingURL=MentionableSelectMenuKit-8_Nkgn_a.d.ts.map

package/dist/{MessageCommandParser-UTKsRvb9.d.ts → MessageCommandParser-BYbxHOSK.d.ts}

@@ -1,6 +1,5 @@
 import { ApplicationCommandOptionType, Attachment, CommandInteractionOption, GuildMember, Message, Role, User } from "discord.js";
 import { Channel } from "diagnostics_channel";
-
 //#region src/app/commands/MessageCommandParser.d.ts
 /**
  * Represents a parsed message command with its components.
@@ -197,4 +196,4 @@ declare class MessageCommandOptions {
 }
 //#endregion
 export { ParsedMessageCommand as i, MessageCommandOptionsSchema as n, MessageCommandParser as r, MessageCommandOptions as t };
-//# sourceMappingURL=MessageCommandParser-UTKsRvb9.d.ts.map
+//# sourceMappingURL=MessageCommandParser-BYbxHOSK.d.ts.map

package/dist/{Modal-v9rrcMl-.d.ts → Modal-DbWK6VmV.d.ts}

@@ -1,9 +1,8 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { i as ModalKit, n as CommandKitModalBuilderInteractionCollectorDispatchContextData, o as OnModalKitEnd, s as OnModalKitSubmit } from "./ModalKit-XJSM65SV.js";
-import { n as CommandKitElement } from "./element-DeLvTMfZ.js";
-import { t as MaybeArray } from "./types-DZy7U-Ld.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { i as ModalKit, n as CommandKitModalBuilderInteractionCollectorDispatchContextData, o as OnModalKitEnd, s as OnModalKitSubmit } from "./ModalKit-CnmUVpw-.js";
+import { n as CommandKitElement } from "./element-BMZYAAQ-.js";
+import { t as MaybeArray } from "./types-ur7SvktF.js";
 import { FileUploadBuilder, FileUploadComponentData, TextInputStyle } from "discord.js";
-
 //#region src/components/interactive/modal/Modal.d.ts
 /**
  * The properties for the modal component.
@@ -72,4 +71,4 @@ interface FileUploadProps extends Omit<FileUploadComponentData, 'type' | 'requir
 declare function FileUpload(props: FileUploadProps): FileUploadBuilder;
 //#endregion
 export { ParagraphInput as a, TextInputProps as c, ModalProps as i, FileUploadProps as n, ShortInput as o, Modal as r, TextInput as s, FileUpload as t };
-//# sourceMappingURL=Modal-v9rrcMl-.d.ts.map
+//# sourceMappingURL=Modal-DbWK6VmV.d.ts.map

package/dist/{ModalKit-XJSM65SV.d.ts → ModalKit-CnmUVpw-.d.ts}

@@ -1,6 +1,5 @@
-import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
+import { n as EventInterceptorContextData, r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
 import { Awaitable, Events, ModalBuilder, ModalSubmitInteraction } from "discord.js";
-
 //#region src/components/interactive/modal/ModalKit.d.ts
 /**
  * The predicate function that filters modal interactions.
@@ -83,4 +82,4 @@ declare class ModalKit extends ModalBuilder {
 }
 //#endregion
 export { ModalKitPredicate as a, ModalKit as i, CommandKitModalBuilderInteractionCollectorDispatchContextData as n, OnModalKitEnd as o, CommandKitModalBuilderOnEnd as r, OnModalKitSubmit as s, CommandKitModalBuilderInteractionCollectorDispatch as t };
-//# sourceMappingURL=ModalKit-XJSM65SV.d.ts.map
+//# sourceMappingURL=ModalKit-CnmUVpw-.d.ts.map

package/dist/{RoleSelectMenuKit-CCjcp3HY.d.ts → RoleSelectMenuKit-Bei7DHqD.d.ts}

@@ -1,7 +1,6 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
 import { RoleSelectMenuBuilder, RoleSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/RoleSelectMenuKit.d.ts
 /**
  * Type for the handler function that is called when the role select menu is submitted.
@@ -63,4 +62,4 @@ declare class RoleSelectMenuKit extends RoleSelectMenuBuilder {
 }
 //#endregion
 export { RoleSelectMenuKit as n, RoleSelectMenuKitPredicate as r, OnRoleSelectMenuKitSubmit as t };
-//# sourceMappingURL=RoleSelectMenuKit-CCjcp3HY.d.ts.map
+//# sourceMappingURL=RoleSelectMenuKit-Bei7DHqD.d.ts.map

package/dist/{SelectMenu-CY0vvoSu.d.ts → SelectMenu-Bce_PClo.d.ts}

@@ -1,12 +1,11 @@
-import { t as MaybeArray } from "./types-DZy7U-Ld.js";
-import { n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
-import { n as StringSelectMenuKit } from "./StringSelectMenuKit-G5nBTicX.js";
-import { t as ChannelSelectMenuKit } from "./ChannelSelectMenuKit-DYkudikb.js";
-import { t as MentionableSelectMenuKit } from "./MentionableSelectMenuKit-Mu4xqP6B.js";
-import { n as UserSelectMenuKit } from "./UserSelectMenuKit-D3SO_fXA.js";
-import { n as RoleSelectMenuKit } from "./RoleSelectMenuKit-CCjcp3HY.js";
+import { t as MaybeArray } from "./types-ur7SvktF.js";
+import { n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
+import { n as StringSelectMenuKit } from "./StringSelectMenuKit-CBeB9HqT.js";
+import { t as ChannelSelectMenuKit } from "./ChannelSelectMenuKit-CcOdaLQ6.js";
+import { t as MentionableSelectMenuKit } from "./MentionableSelectMenuKit-8_Nkgn_a.js";
+import { n as UserSelectMenuKit } from "./UserSelectMenuKit-DZmeZ_Tp.js";
+import { n as RoleSelectMenuKit } from "./RoleSelectMenuKit-Bei7DHqD.js";
 import { APISelectMenuOption, BaseSelectMenuComponentData, ChannelSelectMenuComponentData, ChannelSelectMenuInteraction, MentionableSelectMenuComponentData, MentionableSelectMenuInteraction, RoleSelectMenuComponentData, RoleSelectMenuInteraction, SelectMenuComponentOptionData, Snowflake, StringSelectMenuInteraction, StringSelectMenuOptionBuilder, UserSelectMenuComponentData, UserSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/SelectMenu.d.ts
 /**
  * Type for the common properties shared by all select menu builders.
@@ -137,4 +136,4 @@ interface ChannelSelectMenuProps extends Partial<Omit<ChannelSelectMenuComponent
 declare function ChannelSelectMenu(props: ChannelSelectMenuProps): ChannelSelectMenuKit;
 //#endregion
 export { MentionableSelectMenu as a, RoleSelectMenu as c, StringSelectMenu as d, StringSelectMenuOption as f, UserSelectMenuProps as g, UserSelectMenu as h, CommonSelectMenuProps as i, RoleSelectMenuProps as l, StringSelectMenuProps as m, ChannelSelectMenuProps as n, MentionableSelectMenuProps as o, StringSelectMenuOptionProps as p, CommonBuilderKit as r, ResolveBuilderInteraction as s, ChannelSelectMenu as t, SelectMenuProps as u };
-//# sourceMappingURL=SelectMenu-CY0vvoSu.d.ts.map
+//# sourceMappingURL=SelectMenu-Bce_PClo.d.ts.map

package/dist/{StringSelectMenuKit-G5nBTicX.d.ts → StringSelectMenuKit-CBeB9HqT.d.ts}

@@ -1,7 +1,6 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
 import { StringSelectMenuBuilder, StringSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/StringSelectMenuKit.d.ts
 /**
  * Type for the handler function that is called when the string select menu is submitted.
@@ -63,4 +62,4 @@ declare class StringSelectMenuKit extends StringSelectMenuBuilder {
 }
 //#endregion
 export { StringSelectMenuKit as n, StringSelectMenuKitPredicate as r, OnStringSelectMenuKitSubmit as t };
-//# sourceMappingURL=StringSelectMenuKit-G5nBTicX.d.ts.map
+//# sourceMappingURL=StringSelectMenuKit-CBeB9HqT.d.ts.map

package/dist/TreeArtifact-D6FZ5SVd.d.ts

@@ -0,0 +1,27 @@
+import { a as ParsedCommandData } from "./CommandsRouter-Co225Ae5.js";
+import { i as EventsTree } from "./EventsRouter-Bt63ZuEF.js";
+//#region src/app/router/TreeArtifact.d.ts
+declare const ROUTER_TREE_ARTIFACT_SCHEMA_VERSION = 1;
+declare const ROUTER_TREE_ARTIFACT_FILE = "router-tree.json";
+declare const ROUTER_TREE_ARTIFACT_DIRECTORY = ".commandkit";
+interface RouterTreeArtifact {
+  schemaVersion: number;
+  commandkitVersion: string;
+  generatedAt: string;
+  commands: ParsedCommandData;
+  events: EventsTree;
+}
+declare function createRouterTreeArtifact(options: {
+  outputRoot: string;
+  commandkitVersion: string;
+  commands: ParsedCommandData;
+  events: EventsTree;
+}): RouterTreeArtifact;
+declare function validateRouterTreeArtifact(input: unknown, runtimeVersion: string): input is RouterTreeArtifact;
+declare function hydrateRouterTreeArtifact(artifact: RouterTreeArtifact, outputRoot: string): {
+  commands: ParsedCommandData;
+  events: EventsTree;
+};
+//#endregion
+export { createRouterTreeArtifact as a, RouterTreeArtifact as i, ROUTER_TREE_ARTIFACT_FILE as n, hydrateRouterTreeArtifact as o, ROUTER_TREE_ARTIFACT_SCHEMA_VERSION as r, validateRouterTreeArtifact as s, ROUTER_TREE_ARTIFACT_DIRECTORY as t };
+//# sourceMappingURL=TreeArtifact-D6FZ5SVd.d.ts.map

package/dist/{UserSelectMenuKit-D3SO_fXA.d.ts → UserSelectMenuKit-DZmeZ_Tp.d.ts}

@@ -1,7 +1,6 @@
-import { r as EventInterceptorErrorHandler } from "./EventInterceptor-D9JKMcfi.js";
-import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CCvvgnxi.js";
+import { r as EventInterceptorErrorHandler } from "./EventInterceptor-wg378vJp.js";
+import { a as OnSelectMenuKitSubmit, n as CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, o as SelectMenuKitPredicate, r as CommandKitSelectMenuBuilderOnEnd, t as CommandKitSelectMenuBuilderInteractionCollectorDispatch } from "./common-CIbPzguv.js";
 import { UserSelectMenuBuilder, UserSelectMenuInteraction } from "discord.js";
-
 //#region src/components/interactive/select-menu/UserSelectMenuKit.d.ts
 /**
  * Type for the handler function that is called when the user select menu is submitted.
@@ -63,4 +62,4 @@ declare class UserSelectMenuKit extends UserSelectMenuBuilder {
 }
 //#endregion
 export { UserSelectMenuKit as n, UserSelectMenuKitPredicate as r, OnUserSelectMenuKitSubmit as t };
-//# sourceMappingURL=UserSelectMenuKit-D3SO_fXA.d.ts.map
+//# sourceMappingURL=UserSelectMenuKit-DZmeZ_Tp.d.ts.map

package/dist/analytics/analytics-engine.d.ts

@@ -1,2 +1,2 @@
-import { n as FilterFunction, t as AnalyticsEngine } from "../analytics-engine-BYA0ongA.js";
+import { n as FilterFunction, t as AnalyticsEngine } from "../analytics-engine-Bz1p7ud3.js";
 export { AnalyticsEngine, FilterFunction };

package/dist/analytics/analytics-engine.js

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

package/dist/analytics/analytics-provider.d.ts

@@ -1,2 +1,2 @@
-import { a as IdentifyEvent, i as AnalyticsProvider, r as AnalyticsEvent } from "../analytics-engine-BYA0ongA.js";
+import { a as IdentifyEvent, i as AnalyticsProvider, r as AnalyticsEvent } from "../analytics-engine-Bz1p7ud3.js";
 export { AnalyticsEvent, AnalyticsProvider, IdentifyEvent };

package/dist/analytics/constants.js

@@ -1,5 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_chunk = require('../chunk-BE-pF4vm.js');
 let node_crypto = require("node:crypto");
 
 //#region src/analytics/constants.ts

package/dist/analytics/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","names":[],"sources":["../../src/analytics/constants.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\n\n/**\n * @private\n * @internal\n */\nexport const DO_NOT_TRACK_KEY = `COMMANDKIT_ANALYTICS__DO_NOT_TRACK::${randomUUID()}`;\n\n/**\n * The analytics events that are used in CommandKit.\n * These events are used to track various actions and metrics within the CommandKit framework.\n */\nexport const AnalyticsEvents = {\n  // commands\n  COMMAND_EXECUTION: 'command_execution',\n  // feature flags\n  FEATURE_FLAG_METRICS: 'feature_flag_metrics',\n  FEATURE_FLAG_DECISION: 'feature_flag_decision',\n  // @commandkit/cache\n  CACHE_HIT: 'cache_hit',\n  CACHE_MISS: 'cache_miss',\n  CACHE_REVALIDATED: 'cache_revalidated',\n} as const;\n\n/**\n * The type of analytics events that can be tracked in CommandKit.\n * This type is derived from the keys of the `AnalyticsEvents` object.\n * It ensures that only valid analytics events can be used in the tracking functions.\n */\nexport type AnalyticsEvent =\n  (typeof AnalyticsEvents)[keyof typeof AnalyticsEvents];\n"],"mappings":";;;;;;;;;AAMA,MAAa,mBAAmB,oEAAmD;;;;;AAMnF,MAAa,kBAAkB;CAE7B,mBAAmB;CAEnB,sBAAsB;CACtB,uBAAuB;CAEvB,WAAW;CACX,YAAY;CACZ,mBAAmB;CACpB"}
+{"version":3,"file":"constants.js","names":[],"sources":[],"mappings":""}

package/dist/analytics/utils.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.getDoNotTrack = require_commandkit.getDoNotTrack;
 exports.noAnalytics = require_commandkit.noAnalytics;

package/dist/{analytics-engine-BYA0ongA.d.ts → analytics-engine-Bz1p7ud3.d.ts}

@@ -1,17 +1,19 @@
-import { t as EventInterceptor } from "./EventInterceptor-D9JKMcfi.js";
-import { a as Fragment, c as createElement } from "./element-DeLvTMfZ.js";
-import { t as MaybeArray } from "./types-DZy7U-Ld.js";
-import { r as MessageCommandParser, t as MessageCommandOptions } from "./MessageCommandParser-UTKsRvb9.js";
-import { i as Middleware, n as CommandsRouter, t as Command } from "./CommandsRouter-D-b3xv38.js";
-import { i as ParsedEvent, t as EventsRouter } from "./EventsRouter-Dyr_oJJD.js";
-import { o as HMREventType } from "./constants-GWSfiS4h.js";
+import { t as EventInterceptor } from "./EventInterceptor-wg378vJp.js";
+import { a as Fragment, c as createElement } from "./element-BMZYAAQ-.js";
+import { t as MaybeArray } from "./types-ur7SvktF.js";
+import "./index-DvqHpiuh.js";
+import { r as MessageCommandParser, t as MessageCommandOptions } from "./MessageCommandParser-BYbxHOSK.js";
+import "./helpers-vlnRvNJv.js";
+import { i as Middleware, n as CommandsRouter, o as RouterFileChangeType, t as Command } from "./CommandsRouter-Co225Ae5.js";
+import { a as ParsedEvent, n as EventsRouterFileChangeType, t as EventsRouter } from "./EventsRouter-Bt63ZuEF.js";
+import "./index-COt7nfC9.js";
+import { o as HMREventChangeType, s as HMREventType } from "./constants-kWgE3L9F.js";
 import EventEmitter from "node:events";
 import { AutocompleteInteraction, Awaitable, CacheType, ChatInputCommandInteraction, Client, ClientEvents, Collection, Constructable, ContextMenuCommandBuilder, ContextMenuCommandInteraction, Guild, Interaction, Locale, Message, MessageContextMenuCommandInteraction, PermissionsString, RESTPostAPIApplicationCommandsJSONBody, SlashCommandBuilder, TextBasedChannel, UserContextMenuCommandInteraction } from "discord.js";
 import { DirectiveTransformerOptions } from "directive-to-hof";
 import { InlineConfig } from "tsdown";
-
 //#region src/types.d.ts
-type Prettify<T> = { [K in keyof T]: T[K] } & {};
+type Prettify<T> = { [K in keyof T]: T[K]; } & {};
 /**
  * Options for instantiating a CommandKit handler.
  */
@@ -762,10 +764,20 @@ interface LoadedCommand {
    */
   data: AppCommand;
 }
+/**
+ * Global registry used to infer strongly-typed command identifiers.
+ * This namespace is augmented by generated `commandkit/types` declarations.
+ */
+declare global {
+  namespace CommandKitTypes {
+    interface Registry {}
+  }
+}
+type CommandTypeDataRegistryKeys = Exclude<keyof CommandKitTypes.Registry, '__commandkit_wide__'>;
 /**
  * Type representing command data identifier.
  */
-type CommandTypeData = string;
+type CommandTypeData = [CommandTypeDataRegistryKeys] extends [never] ? string : Extract<CommandTypeDataRegistryKeys, string>;
 /**
  * Type for commands that can be resolved by the handler.
  */
@@ -946,7 +958,7 @@ declare class AppCommandHandler {
   /**
    * Reloads all commands and middleware from scratch.
    */
-  reloadCommands(): Promise<void>;
+  reloadCommands(path?: string, changeType?: RouterFileChangeType): Promise<void>;
   /**
    * Adds external middleware data to be loaded.
    * @param data - Array of middleware data to add
@@ -1108,6 +1120,7 @@ interface LoadedEvent {
   event: ParsedEvent;
   listeners: EventListener[];
   mainListener?: EventListener;
+  onceListener?: EventListener;
   executedOnceListeners?: Set<ListenerFunction>;
 }
 /**
@@ -1143,11 +1156,16 @@ declare class AppEventsHandler {
   /**
    * Reloads all events by unregistering existing ones and loading them again.
    */
-  reloadEvents(): Promise<void>;
+  reloadEvents(path?: string, changeType?: EventsRouterFileChangeType): Promise<void>;
   /**
    * Loads all events from the events router and registers them with Discord.js client.
    */
   loadEvents(): Promise<void>;
+  /**
+   * @private
+   * @internal
+   */
+  private loadEventsFromTree;
   /**
    * Unregisters all event listeners and clears loaded events.
    */
@@ -1175,6 +1193,10 @@ interface IpcMessageCommand {
    * The path associated with the HMR event.
    */
   path: string;
+  /**
+   * The original filesystem change type that triggered this HMR event.
+   */
+  changeType?: HMREventChangeType;
   /**
    * An optional identifier for the HMR event, used for acknowledgment.
    */
@@ -1192,6 +1214,10 @@ interface CommandKitHMREvent {
    * The path associated with the HMR event.
    */
   path: string;
+  /**
+   * The original filesystem change type that triggered this HMR event.
+   */
+  changeType?: HMREventChangeType;
   /**
    * Accepts the HMR event, indicating that it has been handled.
    * This prevents further processing of the event.
@@ -2076,6 +2102,16 @@ interface CommandKitConfig {
      * @default null
      */
     devServerRuntime?: CommandKitJsRuntime | null;
+    /**
+     * Whether to emit and hydrate a pre-generated commands/events artifact in production builds.
+     * @default false
+     */
+    pregenerateCommands?: boolean;
+    /**
+     * Whether to use incremental router reconciliation in development HMR.
+     * @default false
+     */
+    incrementalRouter?: boolean;
   };
 }
 //#endregion
@@ -2083,11 +2119,11 @@ interface CommandKitConfig {
 /**
  * @private
  */
-type DeepRequired<T, OptionalKeys extends keyof T = never> = { [P in keyof T]-?: P extends OptionalKeys ? Partial<T[P]> : DeepRequired<T[P]> };
+type DeepRequired<T, OptionalKeys extends keyof T = never> = { [P in keyof T]-?: P extends OptionalKeys ? Partial<T[P]> : DeepRequired<T[P]>; };
 /**
  * @private
  */
-type DeepPartial<T> = { [P in keyof T]?: DeepPartial<T[P]> };
+type DeepPartial<T> = { [P in keyof T]?: DeepPartial<T[P]>; };
 /**
  * @private
  * @example
@@ -2387,4 +2423,4 @@ declare class AnalyticsEngine {
 }
 //#endregion
 export { RuntimePlugin as $, InteractionCommandMiddlewareContext as $t, MaybePromise as A, isCommandWorkerContext as At, isPlugin as B, CommandRegistrar as Bt, DecideFunction as C, AppCommandRunner as Ct, FeatureFlagDefinition as D, exitContext as Dt, FeatureFlag as E, GenericFunction as Et, JsonFlagProvider as F, CommandKitEnvironment as Ft, CompilerPlugin as G, AutocompleteCommandMiddlewareContext as Gt, CompilerPluginRuntime as H, AnyCommandExecute as Ht, CommandKitPluginRuntime as I, CommandKitEnvironmentInternalData as It, isCompilerPlugin as J, CommandContextOptions as Jt, PluginTransformParameters as K, ChatInputCommand as Kt, PluginCommon as L, CommandKitEnvironmentType as Lt, setFlagProvider as M, provideContext as Mt, FlagConfiguration as N, useEnvironment as Nt, FlagRunner as O, getCommandKit as Ot, FlagProvider as P, useStore as Pt, TemplateHandler as Q, InteractionCommandContext as Qt, PluginOptions as R, after as Rt, CustomEvaluationFunction as S, RunCommand as St, EventFlagContext as T, AsyncFunction as Tt, CommonDirectiveTransformer as U, AutocompleteCommand as Ut, CommonPluginRuntime as V, PreRegisterCommandsEvent as Vt, CommonDirectiveTransformerOptions as W, AutocompleteCommandContext as Wt, CommandKitPlugin as X, Context as Xt, CommandKitEventDispatch as Y, CommandExecutionMode as Yt, MaybeFalsey as Z, ContextParameters as Zt, CommandKitConfig as _, EventHandler as _n, CommandTypeData as _t, IdentifyEvent as a, MessageContextMenuCommandMiddlewareContext as an, AppEventsHandlerLoadedData as at, CommandFlagContext as b, PreparedAppCommandExecution as bt, CommandKitConfiguration as c, SlashCommandMiddlewareContext as cn, CommandKitEventsChannel as ct, onBootstrap as d, UserContextMenuCommandMiddlewareContext as dn, AppCommandHandler as dt, MessageCommand as en, isRuntimePlugin as et, DeepPartial as f, CommandContext as fn, AppCommandNative as ft, CommandKitCompilerOptions as g, CommandMetadataFunction as gn, CommandDataSchemaValue as gt, mergeDeep as h, CommandMetadata as hn, CommandDataSchemaKey as ht, AnalyticsProvider as i, MessageContextMenuCommandContext as in, AppEventsHandler as it, flag as j, makeContextAwareFunction as jt, IdentifyFunction as k, getContext as kt, commandkit as l, UserContextMenuCommand as ln, ListenerFunction as lt, ResolvedCommandKitConfig as m, CommandKitOptions as mn, CommandDataSchema as mt, FilterFunction as n, MessageCommandMiddlewareContext as nn, IpcMessageCommand as nt, BootstrapFunction as o, MiddlewareContext as on, EventListener as ot, DeepRequired as p, CommandData as pn, CommandBuilderLike as pt, TransformedResult as q, ChatInputCommandContext as qt, AnalyticsEvent as r, MessageContextMenuCommand as rn, registerDevHooks as rt, CommandKit as s, MiddlewareContextArgs as sn, LoadedEvent as st, AnalyticsEngine as t, MessageCommandContext as tn, CommandKitHMREvent as tt, onApplicationBootstrap as u, UserContextMenuCommandContext as un, AppCommand as ut, CommandKitJsRuntime as v, CustomAppCommandProps as vt, EvaluationContext as w, RunCommandOptions as wt, CustomEvaluationContext as x, ResolvableCommand as xt, FlagStore as y, LoadedCommand as yt, PluginType as z, cancelAfter as zt };
-//# sourceMappingURL=analytics-engine-BYA0ongA.d.ts.map
+//# sourceMappingURL=analytics-engine-Bz1p7ud3.d.ts.map

package/dist/app/commands/AppCommandRunner.d.ts

@@ -1,2 +1,2 @@
-import { Ct as AppCommandRunner, wt as RunCommandOptions } from "../../analytics-engine-BYA0ongA.js";
+import { Ct as AppCommandRunner, wt as RunCommandOptions } from "../../analytics-engine-Bz1p7ud3.js";
 export { AppCommandRunner, RunCommandOptions };

package/dist/app/commands/AppCommandRunner.js

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

package/dist/app/commands/Context.d.ts

@@ -1,2 +1,2 @@
-import { $t as InteractionCommandMiddlewareContext, Gt as AutocompleteCommandMiddlewareContext, Ht as AnyCommandExecute, Jt as CommandContextOptions, Kt as ChatInputCommand, Qt as InteractionCommandContext, Ut as AutocompleteCommand, Wt as AutocompleteCommandContext, Xt as Context, Yt as CommandExecutionMode, Zt as ContextParameters, an as MessageContextMenuCommandMiddlewareContext, cn as SlashCommandMiddlewareContext, dn as UserContextMenuCommandMiddlewareContext, en as MessageCommand, in as MessageContextMenuCommandContext, ln as UserContextMenuCommand, nn as MessageCommandMiddlewareContext, on as MiddlewareContext, qt as ChatInputCommandContext, rn as MessageContextMenuCommand, sn as MiddlewareContextArgs, tn as MessageCommandContext, un as UserContextMenuCommandContext } from "../../analytics-engine-BYA0ongA.js";
+import { $t as InteractionCommandMiddlewareContext, Gt as AutocompleteCommandMiddlewareContext, Ht as AnyCommandExecute, Jt as CommandContextOptions, Kt as ChatInputCommand, Qt as InteractionCommandContext, Ut as AutocompleteCommand, Wt as AutocompleteCommandContext, Xt as Context, Yt as CommandExecutionMode, Zt as ContextParameters, an as MessageContextMenuCommandMiddlewareContext, cn as SlashCommandMiddlewareContext, dn as UserContextMenuCommandMiddlewareContext, en as MessageCommand, in as MessageContextMenuCommandContext, ln as UserContextMenuCommand, nn as MessageCommandMiddlewareContext, on as MiddlewareContext, qt as ChatInputCommandContext, rn as MessageContextMenuCommand, sn as MiddlewareContextArgs, tn as MessageCommandContext, un as UserContextMenuCommandContext } from "../../analytics-engine-Bz1p7ud3.js";
 export { AnyCommandExecute, AutocompleteCommand, AutocompleteCommandContext, AutocompleteCommandMiddlewareContext, ChatInputCommand, ChatInputCommandContext, CommandContextOptions, CommandExecutionMode, Context, ContextParameters, InteractionCommandContext, InteractionCommandMiddlewareContext, MessageCommand, MessageCommandContext, MessageCommandMiddlewareContext, MessageContextMenuCommand, MessageContextMenuCommandContext, MessageContextMenuCommandMiddlewareContext, MiddlewareContext, MiddlewareContextArgs, SlashCommandMiddlewareContext, UserContextMenuCommand, UserContextMenuCommandContext, UserContextMenuCommandMiddlewareContext };

package/dist/app/commands/Context.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.CommandExecutionMode = require_commandkit.CommandExecutionMode;
 exports.Context = require_commandkit.Context;

package/dist/app/commands/MessageCommandParser.d.ts

@@ -1,2 +1,2 @@
-import { i as ParsedMessageCommand, n as MessageCommandOptionsSchema, r as MessageCommandParser, t as MessageCommandOptions } from "../../MessageCommandParser-UTKsRvb9.js";
+import { i as ParsedMessageCommand, n as MessageCommandOptionsSchema, r as MessageCommandParser, t as MessageCommandOptions } from "../../MessageCommandParser-BYbxHOSK.js";
 export { MessageCommandOptions, MessageCommandOptionsSchema, MessageCommandParser, ParsedMessageCommand };