feat: pregenerate commands

.github/workflows/code-quality.yaml

@@ -31,7 +31,7 @@ jobs:
         run: pnpm dlx turbo check-types
 
       - name: Run CommandKit Command Handler Tests
-        run: pnpm test:commandkit
+        run: pnpm run test
 
       - name: Check Generated API Docs
         run: pnpm docgen:check

apps/test-bot/.gitignore

@@ -3,4 +3,4 @@
 compiled-commandkit.config.mjs
 *.db*
 .workflow-data/
-.swc/
+.swc/

apps/test-bot/commandkit-env.d.ts

@@ -1 +1 @@
-/// <reference path="node_modules/commandkit-types/index.d.ts" />
+/// <reference path="./.commandkit/types" />

apps/test-bot/tsconfig.json

@@ -11,11 +11,9 @@
     "skipLibCheck": true,
     "skipDefaultLibCheck": true,
     "allowJs": true,
-    "alwaysStrict": false,
     "checkJs": false,
     "strict": true,
     "strictNullChecks": true,
-    "baseUrl": ".",
     "paths": {
       "@/*": ["./src/*"]
     }

apps/website/docs/api-reference/commandkit/classes/app-command-handler.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## AppCommandHandler
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppCommandHandler.ts" sourceLine="201" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppCommandHandler.ts" sourceLine="219" packageName="commandkit" />
 
 Handles application commands for CommandKit, including loading, registration, and execution.
 Manages both slash commands and message commands with middleware support.
@@ -34,7 +34,7 @@ class AppCommandHandler {
     registerCommandHandler() => void;
     prepareCommandRun(source: Interaction | Message, cmdName?: string) => Promise<PreparedAppCommandExecution | null>;
     resolveMessageCommandName(name: string) => string;
-    reloadCommands() => Promise<void>;
+    reloadCommands(path?: string, changeType?: RouterFileChangeType) => Promise<void>;
     addExternalMiddleware(data: Middleware[]) => Promise<void>;
     addExternalCommands(data: Command[]) => Promise<void>;
     registerExternalLoadedMiddleware(data: LoadedMiddleware[]) => Promise<void>;
@@ -108,7 +108,7 @@ Prepares a command for execution by resolving the command and its middleware.
 
 ### reloadCommands
 
-<MemberInfo kind="method" type={`() => Promise&#60;void&#62;`}   />
+<MemberInfo kind="method" type={`(path?: string, changeType?: <a href='/docs/api-reference/commandkit/types/router-file-change-type#routerfilechangetype'>RouterFileChangeType</a>) => Promise&#60;void&#62;`}   />
 
 Reloads all commands and middleware from scratch.
 ### addExternalMiddleware

apps/website/docs/api-reference/commandkit/classes/app-events-handler.mdx

@@ -13,15 +13,15 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## AppEventsHandler
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppEventsHandler.ts" sourceLine="46" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppEventsHandler.ts" sourceLine="47" packageName="commandkit" />
 
 Handles Discord.js events and CommandKit custom events with support for namespacing and middleware.
 
 ```ts title="Signature"
 class AppEventsHandler {
     constructor(commandkit: CommandKit)
     getEvents() => AppEventsHandlerLoadedData[];
-    reloadEvents() => ;
+    reloadEvents(path?: string, changeType?: EventsRouterFileChangeType) => ;
     loadEvents() => ;
     unregisterAll() => ;
     registerAllClientEvents() => ;
@@ -43,7 +43,7 @@ Creates a new AppEventsHandler instance.
 Gets information about all loaded events.
 ### reloadEvents
 
-<MemberInfo kind="method" type={`() => `}   />
+<MemberInfo kind="method" type={`(path?: string, changeType?: <a href='/docs/api-reference/commandkit/types/events-router-file-change-type#eventsrouterfilechangetype'>EventsRouterFileChangeType</a>) => `}   />
 
 Reloads all events by unregistering existing ones and loading them again.
 ### loadEvents

apps/website/docs/api-reference/commandkit/classes/command-kit.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## CommandKit
 
-<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="96" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="112" packageName="commandkit" />
 
 The commandkit class that serves as the main entry point for the CommandKit framework.
 

apps/website/docs/api-reference/commandkit/classes/commands-router.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## CommandsRouter
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/router/CommandsRouter.ts" sourceLine="123" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/router/CommandsRouter.ts" sourceLine="132" packageName="commandkit" />
 
 Handles discovery and parsing of command and middleware files in the filesystem.
 
@@ -24,6 +24,7 @@ class CommandsRouter {
     isValidPath() => boolean;
     clear() => void;
     scan() => Promise<ParsedCommandData>;
+    scanIncremental(changedPath: string, _changeType: RouterFileChangeType = 'change') => Promise<ParsedCommandData>;
     getData() => {
     commands: Collection<string, Command>;
     middlewares: Collection<string, Middleware>;
@@ -67,6 +68,12 @@ Clears all loaded commands, middleware, and compiled tree data.
 <MemberInfo kind="method" type={`() => Promise&#60;<a href='/docs/api-reference/commandkit/interfaces/parsed-command-data#parsedcommanddata'>ParsedCommandData</a>&#62;`}   />
 
 Scans the filesystem for commands and middleware files.
+### scanIncremental
+
+<MemberInfo kind="method" type={`(changedPath: string, _changeType: <a href='/docs/api-reference/commandkit/types/router-file-change-type#routerfilechangetype'>RouterFileChangeType</a> = 'change') => Promise&#60;<a href='/docs/api-reference/commandkit/interfaces/parsed-command-data#parsedcommanddata'>ParsedCommandData</a>&#62;`}   />
+
+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.
 ### getData
 
 <MemberInfo kind="method" type={`() => {     commands: Collection&#60;string, <a href='/docs/api-reference/commandkit/interfaces/command#command'>Command</a>&#62;;     middlewares: Collection&#60;string, <a href='/docs/api-reference/commandkit/interfaces/middleware#middleware'>Middleware</a>&#62;;     treeNodes: Collection&#60;string, <a href='/docs/api-reference/commandkit/interfaces/command-tree-node#commandtreenode'>CommandTreeNode</a>&#62;;     compiledRoutes: Collection&#60;string, <a href='/docs/api-reference/commandkit/interfaces/compiled-command-route#compiledcommandroute'>CompiledCommandRoute</a>&#62;;     diagnostics: <a href='/docs/api-reference/commandkit/interfaces/command-route-diagnostic#commandroutediagnostic'>CommandRouteDiagnostic</a>[];   }`}   />

apps/website/docs/api-reference/commandkit/classes/events-router.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## EventsRouter
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/router/EventsRouter.ts" sourceLine="37" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/router/EventsRouter.ts" sourceLine="43" packageName="commandkit" />
 
 Router for discovering and managing event handler files in a directory structure.
 Events are represented by directories, and handlers are files within those directories.
@@ -26,8 +26,10 @@ class EventsRouter {
     entrypoints: string[]
     isValidPath() => ;
     clear() => ;
+    populate(events: EventsTree) => ;
     reload() => ;
     scan() => Promise<EventsTree>;
+    scanIncremental(changedPath: string, _changeType: EventsRouterFileChangeType = 'change') => Promise<EventsTree>;
     toJSON() => EventsTree;
 }
 ```
@@ -64,6 +66,11 @@ Checks if the entrypoint path is valid
 <MemberInfo kind="method" type={`() => `}   />
 
 Clear all parsed events
+### populate
+
+<MemberInfo kind="method" type={`(events: <a href='/docs/api-reference/commandkit/types/events-tree#eventstree'>EventsTree</a>) => `}   />
+
+Populates router state from pre-resolved event metadata.
 ### reload
 
 <MemberInfo kind="method" type={`() => `}   />
@@ -74,6 +81,11 @@ Reload and re-scan the entrypoint directory for events
 <MemberInfo kind="method" type={`() => Promise&#60;<a href='/docs/api-reference/commandkit/types/events-tree#eventstree'>EventsTree</a>&#62;`}   />
 
 Scan the entrypoint directory for events and their handlers
+### scanIncremental
+
+<MemberInfo kind="method" type={`(changedPath: string, _changeType: <a href='/docs/api-reference/commandkit/types/events-router-file-change-type#eventsrouterfilechangetype'>EventsRouterFileChangeType</a> = 'change') => Promise&#60;<a href='/docs/api-reference/commandkit/types/events-tree#eventstree'>EventsTree</a>&#62;`}   />
+
+Incrementally rescans only the event subtree impacted by a changed path.
 ### toJSON
 
 <MemberInfo kind="method" type={`() => <a href='/docs/api-reference/commandkit/types/events-tree#eventstree'>EventsTree</a>`}   />

apps/website/docs/api-reference/commandkit/functions/bootstrap-commandkit-cli.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## bootstrapCommandkitCLI
 
-<GenerationInfo sourceFile="packages/commandkit/src/cli/init.ts" sourceLine="19" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/cli/init.ts" sourceLine="24" packageName="commandkit" />
 
 Creates a command line interface for CommandKit.
 

apps/website/docs/api-reference/commandkit/functions/create-router-tree-artifact.mdx

@@ -0,0 +1,33 @@
+---
+title: "CreateRouterTreeArtifact"
+isDefaultIndex: false
+generated: true
+---
+
+import MemberInfo from '@site/src/components/MemberInfo';
+import GenerationInfo from '@site/src/components/GenerationInfo';
+import MemberDescription from '@site/src/components/MemberDescription';
+
+<!-- This file was generated from the CommandKit source. Do not modify. Instead, re-run the "docgen" script -->
+
+
+## createRouterTreeArtifact
+
+<GenerationInfo sourceFile="packages/commandkit/src/app/router/TreeArtifact.ts" sourceLine="17" packageName="commandkit" />
+
+
+
+```ts title="Signature"
+function createRouterTreeArtifact(options: {
+  outputRoot: string;
+  commandkitVersion: string;
+  commands: ParsedCommandData;
+  events: EventsTree;
+}): RouterTreeArtifact
+```
+Parameters
+
+### options
+
+<MemberInfo kind="parameter" type={`{   outputRoot: string;   commandkitVersion: string;   commands: <a href='/docs/api-reference/commandkit/interfaces/parsed-command-data#parsedcommanddata'>ParsedCommandData</a>;   events: <a href='/docs/api-reference/commandkit/types/events-tree#eventstree'>EventsTree</a>; }`} />
+

apps/website/docs/api-reference/commandkit/functions/get-types-file-path.mdx

@@ -0,0 +1,22 @@
+---
+title: "GetTypesFilePath"
+isDefaultIndex: false
+generated: true
+---
+
+import MemberInfo from '@site/src/components/MemberInfo';
+import GenerationInfo from '@site/src/components/GenerationInfo';
+import MemberDescription from '@site/src/components/MemberDescription';
+
+<!-- This file was generated from the CommandKit source. Do not modify. Instead, re-run the "docgen" script -->
+
+
+## getTypesFilePath
+
+<GenerationInfo sourceFile="packages/commandkit/src/utils/types-package.ts" sourceLine="10" packageName="commandkit" />
+
+
+
+```ts title="Signature"
+function getTypesFilePath(): void
+```

apps/website/docs/api-reference/commandkit/functions/hydrate-router-tree-artifact.mdx

@@ -0,0 +1,35 @@
+---
+title: "HydrateRouterTreeArtifact"
+isDefaultIndex: false
+generated: true
+---
+
+import MemberInfo from '@site/src/components/MemberInfo';
+import GenerationInfo from '@site/src/components/GenerationInfo';
+import MemberDescription from '@site/src/components/MemberDescription';
+
+<!-- This file was generated from the CommandKit source. Do not modify. Instead, re-run the "docgen" script -->
+
+
+## hydrateRouterTreeArtifact
+
+<GenerationInfo sourceFile="packages/commandkit/src/app/router/TreeArtifact.ts" sourceLine="64" packageName="commandkit" />
+
+
+
+```ts title="Signature"
+function hydrateRouterTreeArtifact(artifact: RouterTreeArtifact, outputRoot: string): {
+  commands: ParsedCommandData;
+  events: EventsTree;
+}
+```
+Parameters
+
+### artifact
+
+<MemberInfo kind="parameter" type={`<a href='/docs/api-reference/commandkit/interfaces/router-tree-artifact#routertreeartifact'>RouterTreeArtifact</a>`} />
+
+### outputRoot
+
+<MemberInfo kind="parameter" type={`string`} />
+

apps/website/docs/api-reference/commandkit/functions/on-application-bootstrap.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## onApplicationBootstrap
 
-<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="87" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="103" packageName="commandkit" />
 
 Registers a bootstrap hook that will be called when the CommandKit instance is created.
 This is useful for plugins that need to run some code after the CommandKit instance is fully initialized.

apps/website/docs/api-reference/commandkit/functions/on-bootstrap.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## onBootstrap
 
-<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="71" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/commandkit.ts" sourceLine="87" packageName="commandkit" />
 
 Registers a bootstrap hook that will be called when the CommandKit instance is created.
 This is useful for plugins that need to run some code after the CommandKit instance is fully initialized.

apps/website/docs/api-reference/commandkit/functions/register-dev-hooks.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## registerDevHooks
 
-<GenerationInfo sourceFile="packages/commandkit/src/utils/dev-hooks.ts" sourceLine="51" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/utils/dev-hooks.ts" sourceLine="63" packageName="commandkit" />
 
 Registers development hooks for CommandKit to handle HMR (Hot Module Replacement) events.
 

apps/website/docs/api-reference/commandkit/functions/validate-router-tree-artifact.mdx

@@ -0,0 +1,32 @@
+---
+title: "ValidateRouterTreeArtifact"
+isDefaultIndex: false
+generated: true
+---
+
+import MemberInfo from '@site/src/components/MemberInfo';
+import GenerationInfo from '@site/src/components/GenerationInfo';
+import MemberDescription from '@site/src/components/MemberDescription';
+
+<!-- This file was generated from the CommandKit source. Do not modify. Instead, re-run the "docgen" script -->
+
+
+## validateRouterTreeArtifact
+
+<GenerationInfo sourceFile="packages/commandkit/src/app/router/TreeArtifact.ts" sourceLine="34" packageName="commandkit" />
+
+
+
+```ts title="Signature"
+function validateRouterTreeArtifact(input: unknown, runtimeVersion: string): input is RouterTreeArtifact
+```
+Parameters
+
+### input
+
+<MemberInfo kind="parameter" type={`unknown`} />
+
+### runtimeVersion
+
+<MemberInfo kind="parameter" type={`string`} />
+

apps/website/docs/api-reference/commandkit/interfaces/app-command-native.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## AppCommandNative
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppCommandHandler.ts" sourceLine="61" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppCommandHandler.ts" sourceLine="62" packageName="commandkit" />
 
 Represents a native command structure used in CommandKit.
 This structure includes the command definition and various handlers for different interaction types.

apps/website/docs/api-reference/commandkit/interfaces/app-events-handler-loaded-data.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## AppEventsHandlerLoadedData
 
-<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppEventsHandler.ts" sourceLine="35" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/app/handlers/AppEventsHandler.ts" sourceLine="36" packageName="commandkit" />
 
 Data structure representing loaded event information for external consumption.
 

apps/website/docs/api-reference/commandkit/interfaces/command-kit-compiler-options.mdx

@@ -13,7 +13,7 @@ import MemberDescription from '@site/src/components/MemberDescription';
 
 ## CommandKitCompilerOptions
 
-<GenerationInfo sourceFile="packages/commandkit/src/config/types.ts" sourceLine="5" packageName="commandkit" />
+<GenerationInfo sourceFile="packages/commandkit/src/config/types.ts" sourceLine="10" packageName="commandkit" />