commandkit 0.1.11-dev.20250402101800 → 0.1.11-dev.20250402134911

package/dist/index.d.ts

@@ -796,6 +796,39 @@ declare function getContext(): CommandKitEnvironment | undefined;
  */
 declare function useEnvironment(): CommandKitEnvironment;
 
+declare class DefaultLocalizationStrategy implements LocalizationStrategy {
+    private readonly commandkit;
+    private translations;
+    constructor(commandkit: CommandKit);
+    locateTranslation(scope: string, locale: Locale): Promise<Translation | null>;
+    private generateLocaleTypes;
+    getTranslationStrict(scope: string, locale: Locale): Promise<Translation>;
+    getTranslation(scope: string, locale: Locale): Promise<Translation | null>;
+    translate(request: LocalizationTranslationRequest): Promise<TranslationResult>;
+    private applyTranslation;
+}
+
+/**
+ * Cancel upcoming middleware execution.
+ * If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
+ * If this is called inside a command itself, it will skip all post-stage middlewares.
+ * If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
+ */
+declare function exitMiddleware(): never;
+/**
+ * Rethrow the error if it is a CommandKit error.
+ * @param error The error to rethrow.
+ */
+declare function rethrow(error: unknown): void;
+/**
+ * Stops current command assuming it has been redirected to another command.
+ */
+declare function redirect(): never;
+
+type CommandSource = Interaction | Message$1;
+declare function isMessageSource(source: CommandSource): source is Message$1;
+declare function isInteractionSource(source: CommandSource): source is Interaction;
+
 interface CommandKitEnvironmentInternalData {
     executionError: Error | null;
     type: CommandKitEnvironmentType | null;
@@ -804,6 +837,7 @@ interface CommandKitEnvironmentInternalData {
     marker: string;
     markStart: number;
     markEnd: number;
+    context: Context | null;
 }
 declare class CommandKitEnvironment {
     #private;
@@ -813,6 +847,16 @@ declare class CommandKitEnvironment {
      * @param commandkit - The commandkit instance.
      */
     constructor(commandkit: CommandKit);
+    /**
+     * Set the context.
+     * @param context - The context to set.
+     */
+    setContext(context: Context): void;
+    /**
+     * Get the context. `null` if not set.
+     * @internal
+     */
+    get context(): Context | null;
     /**
      * Get the execution error.
      * @internal
@@ -1153,21 +1197,6 @@ interface CacheMetadata {
     /** Custom name for the cache entry */
     name?: string;
 }
-/**
- * Internal cache implementation
- * @internal
- * @private
- * This is used directly by the compiler if the function is annotated with `"use cache"` directive.
- * @example
- * ```ts
- * async function myCachedFunction() {
- *   "use cache";
- *   // can use cacheTag() and cacheLife() here to customize cache behavior
- *   return await db.query('SELECT * FROM users');
- * }
- * ```
- */
-declare function useCache<R extends any[], F extends AsyncFunction<R>>(fn: F, id?: string, params?: CacheMetadata): F;
 /**
  * Wraps an async function with caching capability
  * @template R - Array of argument types
@@ -1244,6 +1273,12 @@ declare function revalidate<T = unknown>(tag: string, ...args: any[]): Promise<T
  * ```
  */
 declare function isCachedFunction(fn: GenericFunction): boolean;
+/**
+ * **WARNING!!!! DO NOT USE THIS UNLESS YOU KNOW WHAT YOU ARE DOING!**
+ * @private
+ * @internal
+ */
+declare const zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired: any;
 
 interface Command {
     id: string;
@@ -1640,41 +1675,22 @@ declare abstract class PluginCommon<T extends PluginOptions = PluginOptions, C e
     deactivate(ctx: C): Promise<void>;
 }
 
-declare class DefaultLocalizationStrategy implements LocalizationStrategy {
-    private readonly commandkit;
-    private translations;
-    constructor(commandkit: CommandKit);
-    locateTranslation(scope: string, locale: Locale): Promise<Translation | null>;
-    private generateLocaleTypes;
-    getTranslationStrict(scope: string, locale: Locale): Promise<Translation>;
-    getTranslation(scope: string, locale: Locale): Promise<Translation | null>;
-    translate(request: LocalizationTranslationRequest): Promise<TranslationResult>;
-    private applyTranslation;
-}
-
-/**
- * Cancel upcoming middleware execution.
- * If this is called inside pre-stage middleware, the next run will be the actual command, skipping all other pre-stage middlewares.
- * If this is called inside a command itself, it will skip all post-stage middlewares.
- * If this is called inside post-stage middleware, it will skip all other post-stage middlewares.
- */
-declare function exitMiddleware(): never;
+declare const COMMANDKIT_CACHE_TAG: unique symbol;
+declare const COMMANDKIT_IS_DEV: boolean;
+declare const COMMANDKIT_IS_TEST: boolean;
 /**
- * Rethrow the error if it is a CommandKit error.
- * @param error The error to rethrow.
+ * Types of Hot Module Replacement events
  */
-declare function rethrow(error: unknown): void;
-/**
- * Stops current command assuming it has been redirected to another command.
- */
-declare function redirect(): never;
-
-type CommandSource = Interaction | Message$1;
-declare function isMessageSource(source: CommandSource): source is Message$1;
-declare function isInteractionSource(source: CommandSource): source is Interaction;
+declare const HMREventType: {
+    readonly ReloadCommands: "reload-commands";
+    readonly ReloadEvents: "reload-events";
+    readonly ReloadLocales: "reload-locales";
+    readonly Unknown: "unknown";
+};
+type HMREventType = (typeof HMREventType)[keyof typeof HMREventType];
 
 interface CommandKitHMREvent {
-    event: string;
+    event: HMREventType;
     path: string;
     accept: () => void;
     preventDefault: () => void;
@@ -1767,8 +1783,8 @@ interface CommandKitConfiguration {
 declare let commandkit: CommandKit;
 declare class CommandKit extends EventEmitter {
     #private;
-    private options;
-    readonly eventInterceptor: EventInterceptor;
+    private readonly options;
+    eventInterceptor: EventInterceptor;
     static readonly createElement: typeof createElement;
     static readonly Fragment: typeof Fragment;
     readonly config: CommandKitConfiguration;
@@ -1999,6 +2015,7 @@ declare const Logger: LoggerImpl;
 declare const version: string;
 
 declare function getCurrentDirectory(): string;
+declare function getSourceDirectories(): string[];
 
 /**
  * Creates a command line interface for CommandKit.
@@ -2007,4 +2024,4 @@ declare function getCurrentDirectory(): string;
  */
 declare function bootstrapCommandkitCLI(argv: string[], options?: commander.ParseOptions | undefined): Promise<void>;
 
-export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, type ApiTranslatableCommandOptions, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, type CommandLocalizationTypeData, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandName, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, provideContext, redirect, rethrow, revalidate, useCache as super_duper_secret_internal_for_use_cache_directive_of_commandkit_cli_do_not_use_it_directly_or_you_will_be_fired_from_your_job_kthxbai, useEnvironment, version };
+export { ActionRow, type ActionRowProps, type AnyCommandExecute, type AnyCommandKitElement, type ApiTranslatableCommandOptions, AppCommandHandler, type AsyncFunction, type AutocompleteCommand, type AutocompleteCommandContext, type AutocompleteCommandMiddlewareContext, Button, type ButtonChildrenLike, ButtonKit, type ButtonKitPredicate, type ButtonProps, COMMANDKIT_CACHE_TAG, COMMANDKIT_IS_DEV, COMMANDKIT_IS_TEST, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, type ChannelSelectMenuKitPredicate, type ChannelSelectMenuProps, type Command, type CommandContext, type CommandContextOptions, type CommandData, CommandExecutionMode, CommandKit, type CommandKitButtonBuilderInteractionCollectorDispatch, type CommandKitButtonBuilderInteractionCollectorDispatchContextData, type CommandKitButtonBuilderOnEnd, type CommandKitConfiguration, type CommandKitElement, type CommandKitElementData, CommandKitEnvironment, type CommandKitEnvironmentInternalData, CommandKitEnvironmentType, type CommandKitHMREvent, type CommandKitLoggerOptions, type CommandKitModalBuilderInteractionCollectorDispatch, type CommandKitModalBuilderInteractionCollectorDispatchContextData, type CommandKitModalBuilderOnEnd, type CommandKitOptions, type CommandKitPlugin, CommandKitPluginRuntime, type CommandKitSelectMenuBuilderInteractionCollectorDispatch, type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData, type CommandKitSelectMenuBuilderOnEnd, type CommandLocalizationTypeData, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonBuilderKit, type CommonPluginRuntime, type CommonSelectMenuProps, CompilerPlugin, CompilerPluginRuntime, Context, type ContextParameters, DefaultLocalizationStrategy, DefaultLogger, ElementType, EventInterceptor, type EventInterceptorContextData, type EventInterceptorErrorHandler, EventsRouter, type EventsRouterOptions, type EventsTree, Fragment, type FragmentElementProps, type GenericFunction, HMREventType, type ILogger, type InteractionCommandContext, type InteractionCommandMiddlewareContext, type LoadedCommand, type Loader, Localization, type LocalizationConfig, type LocalizationStrategy, type LocalizationTranslationRequest, type Location, Logger, type LoggerImpl, type MaybeArray, type MaybeFalsey, MemoryCache, MentionableSelectMenu, MentionableSelectMenuKit, type MentionableSelectMenuKitPredicate, type MentionableSelectMenuProps, type Message, type MessageCommand, type MessageCommandContext, type MessageCommandMiddlewareContext, MessageCommandOptions, type MessageCommandOptionsSchema, MessageCommandParser, type MessageContextMenuCommand, type MessageContextMenuCommandContext, type MessageContextMenuCommandMiddlewareContext, type Middleware, MiddlewareContext, type MiddlewareContextArgs, Modal, ModalKit, type ModalKitPredicate, type ModalProps, type OnButtonKitClick, type OnButtonKitEnd, type OnChannelSelectMenuKitSubmit, type OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnMentionableSelectMenuKitSubmit, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnRoleSelectMenuKitSubmit, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, type OnStringSelectMenuKitSubmit, type OnUserSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuKitPredicate, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, type StringSelectMenuKitPredicate, StringSelectMenuOption, type StringSelectMenuOptionProps, type StringSelectMenuProps, TextInput, type TextInputProps, type TransformedResult, type TranslatableArguments, type TranslatableCommand, type TranslatableCommandName, type TranslatableCommandOptions, type Translation, type TranslationResult, type Translator, type UserContextMenuCommand, type UserContextMenuCommandContext, type UserContextMenuCommandMiddlewareContext, UserSelectMenu, UserSelectMenuKit, type UserSelectMenuKitPredicate, type UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, getCurrentDirectory, getElement, getSourceDirectories, invalidate, isCachedFunction, isCommandKitElement, isCompilerPlugin, isInteractionSource, isMessageSource, isRuntimePlugin, makeContextAwareFunction, provideContext, redirect, rethrow, revalidate, useEnvironment, version, zzz_commandkit_secret_internal_use_cache_wrapper_do_not_use_or_you_will_be_fired };