commandkit 0.1.11-dev.20250330073734 → 0.1.11-dev.20250330115232

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as discord_js from 'discord.js';
-import { RESTPostAPIApplicationCommandsJSONBody, Client, Interaction, CacheType, ClientEvents, Awaitable, ButtonBuilder, ButtonInteraction, Events, ModalBuilder, ModalSubmitInteraction, ActionRowBuilder, TextInputBuilder, ButtonStyle, ComponentEmojiResolvable, TextInputStyle, LocalizationMap, Locale, Message as Message$1, ApplicationCommandOptionType, GuildMember, Attachment, User, Role, CommandInteractionOption, ChatInputCommandInteraction, MessageContextMenuCommandInteraction, UserContextMenuCommandInteraction, AutocompleteInteraction, Collection, SlashCommandBuilder, ContextMenuCommandBuilder, PartialMessage } from 'discord.js';
+import { RESTPostAPIApplicationCommandsJSONBody, Client, Interaction, CacheType, ClientEvents, Awaitable, ButtonBuilder, ButtonInteraction, Events, ModalBuilder, ModalSubmitInteraction, ActionRowBuilder, TextInputBuilder, ButtonStyle, ComponentEmojiResolvable, TextInputStyle, StringSelectMenuBuilder, StringSelectMenuInteraction, ChannelSelectMenuBuilder, ChannelSelectMenuInteraction, MentionableSelectMenuBuilder, MentionableSelectMenuInteraction, UserSelectMenuBuilder, UserSelectMenuInteraction, RoleSelectMenuBuilder, RoleSelectMenuInteraction, BaseSelectMenuComponentData, StringSelectMenuOptionBuilder, SelectMenuComponentOptionData, APISelectMenuOption, UserSelectMenuComponentData, RoleSelectMenuComponentData, MentionableSelectMenuComponentData, ChannelSelectMenuComponentData, LocalizationMap, Locale, Message as Message$1, ApplicationCommandOptionType, GuildMember, Attachment, User, Role, CommandInteractionOption, ChatInputCommandInteraction, MessageContextMenuCommandInteraction, UserContextMenuCommandInteraction, AutocompleteInteraction, Collection, SlashCommandBuilder, ContextMenuCommandBuilder, PartialMessage } from 'discord.js';
 import EventEmitter from 'node:events';
 import { Channel } from 'diagnostics_channel';
 import * as commander from 'commander';
@@ -361,6 +361,264 @@ declare function ShortInput(props: TextInputProps): CommandKitElement<'text-inpu
  */
 declare function ParagraphInput(props: TextInputProps): CommandKitElement<'text-input'>;
 
+type SelectMenuKitPredicate<T> = (interaction: T) => Awaitable<boolean>;
+/**
+ * The handler to run when a modal is submitted. This handler is called with the interaction as the first argument.
+ * If the first argument is null, it means that the interaction collector has been destroyed.
+ */
+type OnSelectMenuKitSubmit<T, C> = CommandKitSelectMenuBuilderInteractionCollectorDispatch<T, C>;
+/**
+ * The handler to run when the interaction collector ends. This handler is called with the reason as the first argument.
+ * If the first argument is null, it means that the interaction collector has been destroyed.
+ */
+type OnSelectMenuKitEnd = CommandKitSelectMenuBuilderOnEnd;
+/**
+ * The handler to run when a modal is submitted. This handler is called with the interaction as the first argument.
+ * If the first argument is null, it means that the interaction collector has been destroyed.
+ */
+type CommandKitSelectMenuBuilderInteractionCollectorDispatch<T, C> = (interaction: T, context: C) => Awaitable<void>;
+type CommandKitSelectMenuBuilderOnEnd = (reason: string) => Awaitable<void>;
+type CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData = EventInterceptorContextData<Events.InteractionCreate>;
+
+declare class StringSelectMenuKit extends StringSelectMenuBuilder {
+    #private;
+    /**
+     * Sets the handler to run when the modal is submitted.
+     * @param handler - The handler to run when the modal is submitted.
+     * @param data - The context data for the interaction collector.
+     * @returns This instance of the modal builder.
+     * @example
+     * ```ts
+     * const modal = new StringSelectMenuKit()
+     *  .setTitle('My Modal')
+     *  .setCustomId('my-modal')
+     *  .filter((interaction) => interaction.user.id === '1234567890')
+     *  .onSelect(async (interaction) => {
+     *     await interaction.reply('You submitted the modal!');
+     *   })
+     *   .addComponents(actionRow1, actionRow2);
+     * ```
+     */
+    onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<StringSelectMenuInteraction, StringSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onError(handler: EventInterceptorErrorHandler): this;
+    /**
+     * Sets a filter for the interaction collector.
+     * @param predicate - The filter to use for the interaction collector.
+     * @returns This instance of the modal builder.
+     */
+    filter(predicate: SelectMenuKitPredicate<StringSelectMenuInteraction>): this;
+    private get customId();
+    dispose(): this;
+}
+
+declare class ChannelSelectMenuKit extends ChannelSelectMenuBuilder {
+    #private;
+    /**
+     * Sets the handler to run when the modal is submitted.
+     * @param handler - The handler to run when the modal is submitted.
+     * @param data - The context data for the interaction collector.
+     * @returns This instance of the modal builder.
+     * @example
+     * ```ts
+     * const modal = new ChannelSelectMenuKit()
+     *  .setTitle('My Modal')
+     *  .setCustomId('my-modal')
+     *  .filter((interaction) => interaction.Channel.id === '1234567890')
+     *  .onSelect(async (interaction) => {
+     *     await interaction.reply('You submitted the modal!');
+     *   })
+     *   .addComponents(actionRow1, actionRow2);
+     * ```
+     */
+    onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<ChannelSelectMenuInteraction, ChannelSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onError(handler: EventInterceptorErrorHandler): this;
+    /**
+     * Sets a filter for the interaction collector.
+     * @param predicate - The filter to use for the interaction collector.
+     * @returns This instance of the modal builder.
+     */
+    filter(predicate: SelectMenuKitPredicate<ChannelSelectMenuInteraction>): this;
+    private get customId();
+    dispose(): this;
+}
+
+declare class MentionableSelectMenuKit extends MentionableSelectMenuBuilder {
+    #private;
+    /**
+     * Sets the handler to run when the modal is submitted.
+     * @param handler - The handler to run when the modal is submitted.
+     * @param data - The context data for the interaction collector.
+     * @returns This instance of the modal builder.
+     * @example
+     * ```ts
+     * const modal = new MentionableSelectMenuKit()
+     *  .setTitle('My Modal')
+     *  .setCustomId('my-modal')
+     *  .filter((interaction) => interaction.Mentionable.id === '1234567890')
+     *  .onSelect(async (interaction) => {
+     *     await interaction.reply('You submitted the modal!');
+     *   })
+     *   .addComponents(actionRow1, actionRow2);
+     * ```
+     */
+    onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<MentionableSelectMenuInteraction, MentionableSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onError(handler: EventInterceptorErrorHandler): this;
+    /**
+     * Sets a filter for the interaction collector.
+     * @param predicate - The filter to use for the interaction collector.
+     * @returns This instance of the modal builder.
+     */
+    filter(predicate: SelectMenuKitPredicate<MentionableSelectMenuInteraction>): this;
+    private get customId();
+    dispose(): this;
+}
+
+declare class UserSelectMenuKit extends UserSelectMenuBuilder {
+    #private;
+    /**
+     * Sets the handler to run when the modal is submitted.
+     * @param handler - The handler to run when the modal is submitted.
+     * @param data - The context data for the interaction collector.
+     * @returns This instance of the modal builder.
+     * @example
+     * ```ts
+     * const modal = new UserSelectMenuKit()
+     *  .setTitle('My Modal')
+     *  .setCustomId('my-modal')
+     *  .filter((interaction) => interaction.user.id === '1234567890')
+     *  .onSelect(async (interaction) => {
+     *     await interaction.reply('You submitted the modal!');
+     *   })
+     *   .addComponents(actionRow1, actionRow2);
+     * ```
+     */
+    onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<UserSelectMenuInteraction, UserSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onError(handler: EventInterceptorErrorHandler): this;
+    /**
+     * Sets a filter for the interaction collector.
+     * @param predicate - The filter to use for the interaction collector.
+     * @returns This instance of the modal builder.
+     */
+    filter(predicate: SelectMenuKitPredicate<UserSelectMenuInteraction>): this;
+    private get customId();
+    dispose(): this;
+}
+
+declare class RoleSelectMenuKit extends RoleSelectMenuBuilder {
+    #private;
+    /**
+     * Sets the handler to run when the modal is submitted.
+     * @param handler - The handler to run when the modal is submitted.
+     * @param data - The context data for the interaction collector.
+     * @returns This instance of the modal builder.
+     * @example
+     * ```ts
+     * const modal = new RoleSelectMenuKit()
+     *  .setTitle('My Modal')
+     *  .setCustomId('my-modal')
+     *  .filter((interaction) => interaction.Role.id === '1234567890')
+     *  .onSelect(async (interaction) => {
+     *     await interaction.reply('You submitted the modal!');
+     *   })
+     *   .addComponents(actionRow1, actionRow2);
+     * ```
+     */
+    onSelect(handler: CommandKitSelectMenuBuilderInteractionCollectorDispatch<RoleSelectMenuInteraction, RoleSelectMenuKit>, data?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onEnd(handler: CommandKitSelectMenuBuilderOnEnd): this;
+    /**
+     * Sets the handler to run when the interaction collector ends.
+     * @param handler - The handler to run when the interaction collector ends.
+     * @returns This instance of the modal builder.
+     */
+    onError(handler: EventInterceptorErrorHandler): this;
+    /**
+     * Sets a filter for the interaction collector.
+     * @param predicate - The filter to use for the interaction collector.
+     * @returns This instance of the modal builder.
+     */
+    filter(predicate: SelectMenuKitPredicate<RoleSelectMenuInteraction>): this;
+    private get customId();
+    dispose(): this;
+}
+
+interface CommonSelectMenuProps<T, C> {
+    onSelect?: CommandKitSelectMenuBuilderInteractionCollectorDispatch<T, C>;
+    onEnd?: CommandKitSelectMenuBuilderOnEnd;
+    onError?: (error: Error) => any;
+    options?: CommandKitSelectMenuBuilderInteractionCollectorDispatchContextData;
+}
+interface SelectMenuProps<T, C> extends Partial<Omit<BaseSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<T, C> {
+}
+interface StringSelectMenuProps extends SelectMenuProps<StringSelectMenuInteraction, StringSelectMenuKit> {
+    children?: MaybeArray<StringSelectMenuOptionBuilder>;
+}
+type CommonBuilderKit = StringSelectMenuKit | UserSelectMenuKit | RoleSelectMenuKit | ChannelSelectMenuKit | MentionableSelectMenuKit;
+type ResolveBuilderInteraction<T> = T extends StringSelectMenuKit ? StringSelectMenuInteraction : T extends UserSelectMenuKit ? UserSelectMenuInteraction : T extends RoleSelectMenuKit ? RoleSelectMenuInteraction : T extends ChannelSelectMenuKit ? ChannelSelectMenuInteraction : T extends MentionableSelectMenuKit ? MentionableSelectMenuInteraction : never;
+declare function StringSelectMenu(props: StringSelectMenuProps): StringSelectMenuKit;
+type StringSelectMenuOptionProps = SelectMenuComponentOptionData | APISelectMenuOption;
+declare function StringSelectMenuOption(props: StringSelectMenuOptionProps): StringSelectMenuOptionBuilder;
+interface UserSelectMenuProps extends Partial<Omit<UserSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<UserSelectMenuInteraction, UserSelectMenuKit> {
+}
+declare function UserSelectMenu(props: UserSelectMenuProps): UserSelectMenuKit;
+interface RoleSelectMenuProps extends Partial<Omit<RoleSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<RoleSelectMenuInteraction, RoleSelectMenuKit> {
+}
+declare function RoleSelectMenu(props: RoleSelectMenuProps): RoleSelectMenuKit;
+interface MentionableSelectMenuProps extends Partial<Omit<MentionableSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<MentionableSelectMenuInteraction, MentionableSelectMenuKit> {
+}
+declare function MentionableSelectMenu(props: MentionableSelectMenuProps): MentionableSelectMenuKit;
+interface ChannelSelectMenuProps extends Partial<Omit<ChannelSelectMenuComponentData, 'type'>>, CommonSelectMenuProps<ChannelSelectMenuInteraction, ChannelSelectMenuKit> {
+}
+declare function ChannelSelectMenu(props: ChannelSelectMenuProps): ChannelSelectMenuKit;
+
 interface TranslatableCommand {
     name?: string;
     description?: string;
@@ -1697,4 +1955,4 @@ declare const version: 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, 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 CommandLocalizationTypeData, type CommandSource, type CommandTypeData, CommandsRouter, type CommandsRouterOptions, type CommonPluginRuntime, 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, 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 OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveKind, type ResolveResult, type RunCommand, RuntimePlugin, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, 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, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, 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, type CacheContext, type CacheEntry, type CacheMetadata, CacheProvider, ChannelSelectMenu, ChannelSelectMenuKit, 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 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 OnLoadArgs, type OnLoadOptions, type OnLoadResult, type OnModalKitEnd, type OnModalKitSubmit, type OnResolveArgs, type OnResolveOptions, type OnResolveResult, type OnSelectMenuKitEnd, type OnSelectMenuKitSubmit, ParagraphInput, type ParsedCommandData, type ParsedEvent, type ParsedMessageCommand, type PluginTransformParameters, type PreparedAppCommandExecution, type ResolvableCommand, type ResolveBuilderInteraction, type ResolveKind, type ResolveResult, RoleSelectMenu, RoleSelectMenuKit, type RoleSelectMenuProps, type RunCommand, RuntimePlugin, type SelectMenuKitPredicate, type SelectMenuProps, type Setup, ShortInput, type SlashCommand, type SlashCommandContext, type SlashCommandMiddlewareContext, StringSelectMenu, StringSelectMenuKit, 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 UserSelectMenuProps, afterCommand, bootstrapCommandkitCLI, cache, cacheLife, cacheTag, cancelAfterCommand, commandkit, createElement, createLogger, CommandKit as default, defineConfig, exitContext, exitMiddleware, fromEsbuildPlugin, getCommandKit, getConfig, getContext, 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 };