chore: docs

Author: twlite

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.