@lunibee/builders 0.2.1 → 0.2.3

package/README.md

@@ -8,31 +8,31 @@ bun add @lunibee/builders
 
 ```ts
 import {
-    EmbedBuilder,
-    ActionRowBuilder,
-    ButtonBuilder,
-    ButtonStyle,
-    StringSelectMenuBuilder,
-    SlashCommandBuilder,
+    CreateEmbed,
+    CreateActionRow,
+    CreateButton,
+    ButtonType,
+    CreateStringSelectMenu,
+    CreateSlashCommand,
 } from "@lunibee/builders";
 
-const embed = new EmbedBuilder()
+const embed = new CreateEmbed()
     .setTitle("Welcome")
     .setDescription("Pick a role below.")
     .setColor(0xf5c542)
     .addFields([{ name: "Server", value: "Lunibee" }]);
 
-const buttons = new ActionRowBuilder().addComponents(
-    new ButtonBuilder().setCustomId("yes").setLabel("Yes").setStyle(ButtonStyle.Success),
+const buttons = new CreateActionRow().addComponents(
+    new CreateButton().setCustomId("yes").setLabel("Yes").setStyle(ButtonType.Success),
 );
 
-const menu = new ActionRowBuilder().addComponents(
-    new StringSelectMenuBuilder()
+const menu = new CreateActionRow().addComponents(
+    new CreateStringSelectMenu()
         .setCustomId("role")
         .addOptions({ label: "Developer", value: "dev" }),
 );
 
-const ping = new SlashCommandBuilder()
+const ping = new CreateSlashCommand()
     .setName("ping")
     .setDescription("Replies with pong")
     .addStringOption((option) => option.setName("message").setDescription("Echo text"));
@@ -44,26 +44,26 @@ console.log(embed.toJSON(), buttons.toJSON(), menu.toJSON(), ping.toJSON());
 
 | Area | Builders |
 |---|---|
-| Embeds | `EmbedBuilder` |
-| Buttons & rows | `ButtonBuilder`, `ActionRowBuilder` |
-| Select menus | `StringSelectBuilder` (alias `StringSelectMenuBuilder`), `EntitySelectBuilder`, `UserSelectMenuBuilder`, `RoleSelectMenuBuilder`, `ChannelSelectMenuBuilder`, `MentionableSelectMenuBuilder` |
-| Modals | `ModalBuilder`, `TextInputBuilder` |
-| Slash commands | `SlashCommandBuilder`, `SubcommandBuilder`, `SubcommandGroupBuilder`, option builders |
-| Context menus | `ContextMenuCommandBuilder` (`setType(2 \| 3)`), `UserCommandBuilder`, `MessageCommandBuilder` |
-| Components V2 | `ContainerBuilder`, `SectionBuilder`, `TextDisplayBuilder`, `MediaGalleryBuilder`, `FileComponentBuilder`, `SeparatorBuilder`, `ThumbnailBuilder` |
-| Files | `AttachmentBuilder` |
+| Embeds | `CreateEmbed` |
+| Buttons & rows | `CreateButton`, `CreateActionRow` |
+| Select menus | `CreateStringSelect` (alias `CreateStringSelectMenu`), `CreateEntitySelect`, `CreateUserSelectMenu`, `CreateRoleSelectMenu`, `CreateChannelSelectMenu`, `CreateMentionableSelectMenu` |
+| Modals | `CreateModal`, `CreateTextInput` |
+| Slash commands | `CreateSlashCommand`, `CreateSubcommand`, `CreateSubcommandGroup`, option builders |
+| Context menus | `CreateContextMenuCommand` (`setType(2 \| 3)`), `CreateUserCommand`, `CreateMessageCommand` |
+| Components V2 | `CreateContainer`, `CreateSection`, `CreateTextDisplay`, `CreateMediaGallery`, `CreateFileComponent`, `CreateSeparator`, `CreateThumbnail` |
+| Files | `CreateAttachment` |
 
 Every builder validates Discord's limits as you set values and serialises with `toJSON()`.
 
 ## What's new in 0.2.1
 
-- `ModalBuilder.addTextInputs(...inputs)` wraps each text input in its own row.
+- `CreateModal.addTextInputs(...inputs)` wraps each text input in its own row.
 - `componentsV2Message(components, options?)` builds a Components V2 message with the required flag.
-- `EmbedBuilder` setters (`setTitle`, `setDescription`, `setURL`, `setThumbnail`, `setImage`) clear the field with `null`.
-- `TextInputStyle` and `ComponentType` are usable as types; `ModalBuilder.toJSON()` is typed with a required `custom_id` and `title`.
+- `CreateEmbed` setters (`setTitle`, `setDescription`, `setURL`, `setThumbnail`, `setImage`) clear the field with `null`.
+- `TextInputType` and `ComponentEnum` are usable as types; `CreateModal.toJSON()` is typed with a required `custom_id` and `title`.
 
 ## What's new in 0.2.0
 
-`toJSON()` validates whole components (required fields, value bounds, action-row rules, button field exclusivity); `ButtonBuilder.setSKUId()` for premium buttons.
+`toJSON()` validates whole components (required fields, value bounds, action-row rules, button field exclusivity); `CreateButton.setSKUId()` for premium buttons.
 
 Docs: https://lunibee.js.org/core-concepts/builders/

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "@lunibee/builders",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "type": "module",
   "module": "./src/index.ts",
   "types": "./src/index.ts",
   "exports": {
     ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@lunibee/types": "^0.2.3"
   }
 }

package/src/attachment.ts

@@ -8,7 +8,7 @@ export interface AttachmentData {
 }
 
 /** Builder for message attachments and file uploads. */
-export class AttachmentBuilder {
+export class CreateAttachment {
     public name: string;
     public description?: string;
     public file: Uint8Array | ArrayBuffer | Blob | Buffer | string;
@@ -68,3 +68,12 @@ export class AttachmentBuilder {
         );
     }
 }
+
+// ─── Deprecated names (0.2.2), removed in 0.3.0 ────────────────────────────────
+// Builders are now `CreateX` (`ButtonBuilder` → `CreateButton`); `…Style` became
+// `…Type` and `…Type` became `…Enum`.
+
+/** @deprecated Use {@link CreateAttachment}. Removed in 0.3.0. */
+export const AttachmentBuilder = CreateAttachment;
+/** @deprecated Use {@link CreateAttachment}. Removed in 0.3.0. */
+export type AttachmentBuilder = CreateAttachment;

package/src/commands.ts

@@ -1,5 +1,5 @@
 /** Discord application command option types. */
-export const ApplicationCommandOptionType = {
+export const ApplicationCommandOptionEnum = {
     Subcommand: 1,
     SubcommandGroup: 2,
     String: 3,
@@ -12,9 +12,22 @@ export const ApplicationCommandOptionType = {
     Number: 10,
     Attachment: 11,
 } as const;
+/** One {@link ApplicationCommandOptionEnum} value, usable as a type. */
+export type ApplicationCommandOptionEnum =
+    (typeof ApplicationCommandOptionEnum)[keyof typeof ApplicationCommandOptionEnum];
+
+/** Throws unless every context is 0 (guilds), 1 (the bot's DMs) or 2 (other DMs). */
+function validateContexts(contexts: number[]): void {
+    if (
+        contexts.some(
+            (context) => context !== 0 && context !== 1 && context !== 2,
+        )
+    )
+        throw new RangeError("Command contexts must be 0, 1 or 2.");
+}
 
 /** Builds Discord application command payloads. */
-export class SlashCommandBuilder {
+export class CreateSlashCommand {
     readonly #data: Record<string, unknown> = { type: 1 };
     /** Sets the command name. */ public setName(name: string): this {
         validateName(name, "Command name");
@@ -28,9 +41,14 @@ export class SlashCommandBuilder {
         this.#data.description = description;
         return this;
     }
-    /** Sets whether the command is available in direct messages. */ public setDMPermission(
-        enabled: boolean,
-    ): this {
+    /** Sets where the command can be used: 0 guilds, 1 the bot's DMs, 2 other DMs. @throws {RangeError} For any other value. */
+    public setContexts(...contexts: number[]): this {
+        validateContexts(contexts);
+        this.#data.contexts = [...contexts];
+        return this;
+    }
+    /** @deprecated Discord deprecated `dm_permission`. Use {@link CreateSlashCommand.setContexts}: `setContexts(0)` for guilds only, `setContexts(0, 1)` to allow the bot's DMs. Removed in 0.3.0. */
+    public setDMPermission(enabled: boolean): this {
         this.#data.dm_permission = enabled;
         return this;
     }
@@ -57,61 +75,59 @@ export class SlashCommandBuilder {
         return this;
     }
     /** Adds a string option. */ public addStringOption(
-        configure: (option: StringOptionBuilder) => StringOptionBuilder,
+        configure: (option: CreateStringOption) => CreateStringOption,
     ): this {
-        return this.addOption(configure(new StringOptionBuilder()));
+        return this.addOption(configure(new CreateStringOption()));
     }
     /** Adds an integer option. */ public addIntegerOption(
-        configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder,
+        configure: (option: CreateIntegerOption) => CreateIntegerOption,
     ): this {
-        return this.addOption(configure(new IntegerOptionBuilder()));
+        return this.addOption(configure(new CreateIntegerOption()));
     }
     /** Adds a number option. */ public addNumberOption(
-        configure: (option: NumberOptionBuilder) => NumberOptionBuilder,
+        configure: (option: CreateNumberOption) => CreateNumberOption,
     ): this {
-        return this.addOption(configure(new NumberOptionBuilder()));
+        return this.addOption(configure(new CreateNumberOption()));
     }
     /** Adds a boolean option. */ public addBooleanOption(
-        configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder,
+        configure: (option: CreateBooleanOption) => CreateBooleanOption,
     ): this {
-        return this.addOption(configure(new BooleanOptionBuilder()));
+        return this.addOption(configure(new CreateBooleanOption()));
     }
     /** Adds a user option. */ public addUserOption(
-        configure: (option: UserOptionBuilder) => UserOptionBuilder,
+        configure: (option: CreateUserOption) => CreateUserOption,
     ): this {
-        return this.addOption(configure(new UserOptionBuilder()));
+        return this.addOption(configure(new CreateUserOption()));
     }
     /** Adds a channel option. */ public addChannelOption(
-        configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder,
+        configure: (option: CreateChannelOption) => CreateChannelOption,
     ): this {
-        return this.addOption(configure(new ChannelOptionBuilder()));
+        return this.addOption(configure(new CreateChannelOption()));
     }
     /** Adds a role option. */ public addRoleOption(
-        configure: (option: RoleOptionBuilder) => RoleOptionBuilder,
+        configure: (option: CreateRoleOption) => CreateRoleOption,
     ): this {
-        return this.addOption(configure(new RoleOptionBuilder()));
+        return this.addOption(configure(new CreateRoleOption()));
     }
     /** Adds a mentionable option. */ public addMentionableOption(
-        configure: (
-            option: MentionableOptionBuilder,
-        ) => MentionableOptionBuilder,
+        configure: (option: CreateMentionableOption) => CreateMentionableOption,
     ): this {
-        return this.addOption(configure(new MentionableOptionBuilder()));
+        return this.addOption(configure(new CreateMentionableOption()));
     }
     /** Adds an attachment option. */ public addAttachmentOption(
-        configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder,
+        configure: (option: CreateAttachmentOption) => CreateAttachmentOption,
     ): this {
-        return this.addOption(configure(new AttachmentOptionBuilder()));
+        return this.addOption(configure(new CreateAttachmentOption()));
     }
     /** Adds a subcommand. */ public addSubcommand(
-        configure: (option: SubcommandBuilder) => SubcommandBuilder,
+        configure: (option: CreateSubcommand) => CreateSubcommand,
     ): this {
-        return this.addOption(configure(new SubcommandBuilder()));
+        return this.addOption(configure(new CreateSubcommand()));
     }
     /** Adds a subcommand group. */ public addSubcommandGroup(
-        configure: (option: SubcommandGroupBuilder) => SubcommandGroupBuilder,
+        configure: (option: CreateSubcommandGroup) => CreateSubcommandGroup,
     ): this {
-        return this.addOption(configure(new SubcommandGroupBuilder()));
+        return this.addOption(configure(new CreateSubcommandGroup()));
     }
     /** Serializes the command payload. */ public toJSON(): Record<
         string,
@@ -120,7 +136,7 @@ export class SlashCommandBuilder {
         return structuredClone(this.#data);
     }
     /** Adds a validated top-level command option. */ protected addOption(
-        option: CommandOptionBuilder,
+        option: CreateCommandOption,
     ): this {
         const options = (this.#data.options as unknown[] | undefined) ?? [];
         if (options.length >= 25)
@@ -154,7 +170,7 @@ export class SlashCommandBuilder {
 }
 
 /** Base builder for command options. */
-export class CommandOptionBuilder {
+export class CreateCommandOption {
     protected readonly data: Record<string, unknown>;
     /** Creates an option builder. */ public constructor(type: number) {
         this.data = { type };
@@ -190,9 +206,9 @@ export class CommandOptionBuilder {
 }
 
 /** Builds a string command option. */
-export class StringOptionBuilder extends CommandOptionBuilder {
+export class CreateStringOption extends CreateCommandOption {
     /** Creates a string option. */ public constructor() {
-        super(ApplicationCommandOptionType.String);
+        super(ApplicationCommandOptionEnum.String);
     }
     /** Adds string choices. */ public addChoices(
         ...choices: Array<{ name: string; value: string }>
@@ -237,9 +253,9 @@ export class StringOptionBuilder extends CommandOptionBuilder {
     }
 }
 /** Builds an integer command option. */
-export class IntegerOptionBuilder extends CommandOptionBuilder {
+export class CreateIntegerOption extends CreateCommandOption {
     public constructor() {
-        super(ApplicationCommandOptionType.Integer);
+        super(ApplicationCommandOptionEnum.Integer);
     }
     public setMinValue(value: number): this {
         validateNumberRange(
@@ -268,7 +284,7 @@ export class IntegerOptionBuilder extends CommandOptionBuilder {
         this.data.max_value = value;
         return this;
     }
-    public setAutocomplete(enabled = true): this {
+    public override setAutocomplete(enabled = true): this {
         if (
             enabled &&
             Array.isArray(this.data.choices) &&
@@ -293,9 +309,9 @@ export class IntegerOptionBuilder extends CommandOptionBuilder {
     }
 }
 /** Builds a number command option. */
-export class NumberOptionBuilder extends CommandOptionBuilder {
+export class CreateNumberOption extends CreateCommandOption {
     public constructor() {
-        super(ApplicationCommandOptionType.Number);
+        super(ApplicationCommandOptionEnum.Number);
     }
     public setMinValue(value: number): this {
         validateNumberRange(
@@ -324,7 +340,7 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
         this.data.max_value = value;
         return this;
     }
-    public setAutocomplete(enabled = true): this {
+    public override setAutocomplete(enabled = true): this {
         if (
             enabled &&
             Array.isArray(this.data.choices) &&
@@ -348,34 +364,34 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
         return this;
     }
 }
-/** Builds a boolean command option. */ export class BooleanOptionBuilder extends CommandOptionBuilder {
+/** Builds a boolean command option. */ export class CreateBooleanOption extends CreateCommandOption {
     /** Creates a boolean option. */ public constructor() {
-        super(ApplicationCommandOptionType.Boolean);
+        super(ApplicationCommandOptionEnum.Boolean);
     }
 }
-/** Builds a user command option. */ export class UserOptionBuilder extends CommandOptionBuilder {
+/** Builds a user command option. */ export class CreateUserOption extends CreateCommandOption {
     /** Creates a user option. */ public constructor() {
-        super(ApplicationCommandOptionType.User);
+        super(ApplicationCommandOptionEnum.User);
     }
 }
-/** Builds a role command option. */ export class RoleOptionBuilder extends CommandOptionBuilder {
+/** Builds a role command option. */ export class CreateRoleOption extends CreateCommandOption {
     /** Creates a role option. */ public constructor() {
-        super(ApplicationCommandOptionType.Role);
+        super(ApplicationCommandOptionEnum.Role);
     }
 }
-/** Builds a mentionable command option. */ export class MentionableOptionBuilder extends CommandOptionBuilder {
+/** Builds a mentionable command option. */ export class CreateMentionableOption extends CreateCommandOption {
     /** Creates a mentionable option. */ public constructor() {
-        super(ApplicationCommandOptionType.Mentionable);
+        super(ApplicationCommandOptionEnum.Mentionable);
     }
 }
-/** Builds an attachment command option. */ export class AttachmentOptionBuilder extends CommandOptionBuilder {
+/** Builds an attachment command option. */ export class CreateAttachmentOption extends CreateCommandOption {
     /** Creates an attachment option. */ public constructor() {
-        super(ApplicationCommandOptionType.Attachment);
+        super(ApplicationCommandOptionEnum.Attachment);
     }
 }
-/** Builds a channel command option. */ export class ChannelOptionBuilder extends CommandOptionBuilder {
+/** Builds a channel command option. */ export class CreateChannelOption extends CreateCommandOption {
     /** Creates a channel option. */ public constructor() {
-        super(ApplicationCommandOptionType.Channel);
+        super(ApplicationCommandOptionEnum.Channel);
     }
     /** Restricts accepted channel types. */ public addChannelTypes(
         ...types: number[]
@@ -388,58 +404,56 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
         return this;
     }
 }
-/** Builds a nested subcommand. */ export class SubcommandBuilder extends CommandOptionBuilder {
+/** Builds a nested subcommand. */ export class CreateSubcommand extends CreateCommandOption {
     /** Creates a subcommand. */ public constructor() {
-        super(ApplicationCommandOptionType.Subcommand);
+        super(ApplicationCommandOptionEnum.Subcommand);
     }
     /** Adds a string option to this subcommand. */ public addStringOption(
-        configure: (option: StringOptionBuilder) => StringOptionBuilder,
+        configure: (option: CreateStringOption) => CreateStringOption,
     ): this {
-        return this.addChildOption(configure(new StringOptionBuilder()));
+        return this.addChildOption(configure(new CreateStringOption()));
     }
     /** Adds an integer option to this subcommand. */ public addIntegerOption(
-        configure: (option: IntegerOptionBuilder) => IntegerOptionBuilder,
+        configure: (option: CreateIntegerOption) => CreateIntegerOption,
     ): this {
-        return this.addChildOption(configure(new IntegerOptionBuilder()));
+        return this.addChildOption(configure(new CreateIntegerOption()));
     }
     /** Adds a number option to this subcommand. */ public addNumberOption(
-        configure: (option: NumberOptionBuilder) => NumberOptionBuilder,
+        configure: (option: CreateNumberOption) => CreateNumberOption,
     ): this {
-        return this.addChildOption(configure(new NumberOptionBuilder()));
+        return this.addChildOption(configure(new CreateNumberOption()));
     }
     /** Adds a boolean option to this subcommand. */ public addBooleanOption(
-        configure: (option: BooleanOptionBuilder) => BooleanOptionBuilder,
+        configure: (option: CreateBooleanOption) => CreateBooleanOption,
     ): this {
-        return this.addChildOption(configure(new BooleanOptionBuilder()));
+        return this.addChildOption(configure(new CreateBooleanOption()));
     }
     /** Adds a user option to this subcommand. */ public addUserOption(
-        configure: (option: UserOptionBuilder) => UserOptionBuilder,
+        configure: (option: CreateUserOption) => CreateUserOption,
     ): this {
-        return this.addChildOption(configure(new UserOptionBuilder()));
+        return this.addChildOption(configure(new CreateUserOption()));
     }
     /** Adds a channel option to this subcommand. */ public addChannelOption(
-        configure: (option: ChannelOptionBuilder) => ChannelOptionBuilder,
+        configure: (option: CreateChannelOption) => CreateChannelOption,
     ): this {
-        return this.addChildOption(configure(new ChannelOptionBuilder()));
+        return this.addChildOption(configure(new CreateChannelOption()));
     }
     /** Adds a role option to this subcommand. */ public addRoleOption(
-        configure: (option: RoleOptionBuilder) => RoleOptionBuilder,
+        configure: (option: CreateRoleOption) => CreateRoleOption,
     ): this {
-        return this.addChildOption(configure(new RoleOptionBuilder()));
+        return this.addChildOption(configure(new CreateRoleOption()));
     }
     /** Adds a mentionable option to this subcommand. */ public addMentionableOption(
-        configure: (
-            option: MentionableOptionBuilder,
-        ) => MentionableOptionBuilder,
+        configure: (option: CreateMentionableOption) => CreateMentionableOption,
     ): this {
-        return this.addChildOption(configure(new MentionableOptionBuilder()));
+        return this.addChildOption(configure(new CreateMentionableOption()));
     }
     /** Adds an attachment option to this subcommand. */ public addAttachmentOption(
-        configure: (option: AttachmentOptionBuilder) => AttachmentOptionBuilder,
+        configure: (option: CreateAttachmentOption) => CreateAttachmentOption,
     ): this {
-        return this.addChildOption(configure(new AttachmentOptionBuilder()));
+        return this.addChildOption(configure(new CreateAttachmentOption()));
     }
-    protected addChildOption(option: CommandOptionBuilder): this {
+    protected addChildOption(option: CreateCommandOption): this {
         const options = (this.data.options as unknown[] | undefined) ?? [];
         if (options.length >= 25)
             throw new RangeError(
@@ -469,7 +483,7 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
             options.some(
                 (existing) =>
                     (existing as Record<string, unknown>).type ===
-                    ApplicationCommandOptionType.Subcommand,
+                    ApplicationCommandOptionEnum.Subcommand,
             )
         )
             throw new RangeError(
@@ -480,19 +494,19 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
         return this;
     }
 }
-/** Builds a nested subcommand group. */ export class SubcommandGroupBuilder extends CommandOptionBuilder {
+/** Builds a nested subcommand group. */ export class CreateSubcommandGroup extends CreateCommandOption {
     /** Creates a subcommand group. */ public constructor() {
-        super(ApplicationCommandOptionType.SubcommandGroup);
+        super(ApplicationCommandOptionEnum.SubcommandGroup);
     }
     /** Adds a subcommand to this group. */ public addSubcommand(
-        configure: (option: SubcommandBuilder) => SubcommandBuilder,
+        configure: (option: CreateSubcommand) => CreateSubcommand,
     ): this {
         const options = (this.data.options as unknown[] | undefined) ?? [];
         if (options.length >= 25)
             throw new RangeError(
                 "A subcommand group cannot contain more than 25 subcommands.",
             );
-        const payload = configure(new SubcommandBuilder()).toJSON();
+        const payload = configure(new CreateSubcommand()).toJSON();
         if (
             options.some(
                 (existing) =>
@@ -502,7 +516,7 @@ export class NumberOptionBuilder extends CommandOptionBuilder {
             throw new RangeError(
                 `Duplicate subcommand name: ${String(payload.name)}.`,
             );
-        if (payload.type !== ApplicationCommandOptionType.Subcommand)
+        if (payload.type !== ApplicationCommandOptionEnum.Subcommand)
             throw new TypeError(
                 "Subcommand group children must be subcommands.",
             );
@@ -553,8 +567,8 @@ function validateNumberRange(
 // ─── Context Menu Builders ────────────────────────────────────────────────────
 
 /** Builder for application commands that appear in right-click context menus.
- * Discord.js-familiar: `new ContextMenuCommandBuilder().setName("x").setType(2)`. */
-export class ContextMenuCommandBuilder {
+ * Discord.js-familiar: `new CreateContextMenuCommand().setName("x").setType(2)`. */
+export class CreateContextMenuCommand {
     protected readonly data: Record<string, unknown>;
     public constructor(type: 2 | 3 = 2) {
         this.data = { type };
@@ -592,16 +606,30 @@ export class ContextMenuCommandBuilder {
             permissions === null ? null : BigInt(permissions).toString();
         return this;
     }
-    /** Sets whether the command is available in direct messages. */
+    /** @deprecated Discord deprecated `dm_permission`. Use {@link CreateContextMenuCommand.setContexts}: `setContexts(0)` for guilds only, `setContexts(0, 1)` to allow the bot's DMs. Removed in 0.3.0. */
     public setDMPermission(enabled: boolean): this {
         this.data.dm_permission = enabled;
         return this;
     }
-    /** Sets command integration types. */
+    /** Sets command integration types (0 guild install, 1 user install). */
     public setIntegrationTypes(...types: number[]): this {
         this.data.integration_types = [...types];
         return this;
     }
+    /** Sets where the command can be used: 0 guilds, 1 the bot's DMs, 2 other DMs. @throws {RangeError} For any other value. */
+    public setContexts(...contexts: number[]): this {
+        validateContexts(contexts);
+        this.data.contexts = [...contexts];
+        return this;
+    }
+    /** Sets the name shown per locale, e.g. `{ "es-ES": "Ver perfil" }`; null clears it. */
+    public setNameLocalizations(
+        localizations: Record<string, string> | null,
+    ): this {
+        this.data.name_localizations =
+            localizations === null ? null : { ...localizations };
+        return this;
+    }
     /** Serializes the command payload for the Discord API. */
     public toJSON(): Record<string, unknown> {
         return structuredClone(this.data);
@@ -610,9 +638,9 @@ export class ContextMenuCommandBuilder {
 
 /** Builds a User context menu command (appears when right-clicking a user, type 2).
  * @example
- * new UserCommandBuilder().setName("View Profile").toJSON()
+ * new CreateUserCommand().setName("View Profile").toJSON()
  */
-export class UserCommandBuilder extends ContextMenuCommandBuilder {
+export class CreateUserCommand extends CreateContextMenuCommand {
     public constructor() {
         super(2);
     }
@@ -620,10 +648,99 @@ export class UserCommandBuilder extends ContextMenuCommandBuilder {
 
 /** Builds a Message context menu command (appears when right-clicking a message, type 3).
  * @example
- * new MessageCommandBuilder().setName("Translate Message").toJSON()
+ * new CreateMessageCommand().setName("Translate Message").toJSON()
  */
-export class MessageCommandBuilder extends ContextMenuCommandBuilder {
+export class CreateMessageCommand extends CreateContextMenuCommand {
     public constructor() {
         super(3);
     }
 }
+
+// ─── Deprecated names (0.2.2), removed in 0.3.0 ────────────────────────────────
+// Builders are now `CreateX` (`ButtonBuilder` → `CreateButton`); `…Style` became
+// `…Type` and `…Type` became `…Enum`.
+
+/** @deprecated Use {@link CreateAttachmentOption}. Removed in 0.3.0. */
+export const AttachmentOptionBuilder = CreateAttachmentOption;
+/** @deprecated Use {@link CreateAttachmentOption}. Removed in 0.3.0. */
+export type AttachmentOptionBuilder = CreateAttachmentOption;
+
+/** @deprecated Use {@link CreateBooleanOption}. Removed in 0.3.0. */
+export const BooleanOptionBuilder = CreateBooleanOption;
+/** @deprecated Use {@link CreateBooleanOption}. Removed in 0.3.0. */
+export type BooleanOptionBuilder = CreateBooleanOption;
+
+/** @deprecated Use {@link CreateChannelOption}. Removed in 0.3.0. */
+export const ChannelOptionBuilder = CreateChannelOption;
+/** @deprecated Use {@link CreateChannelOption}. Removed in 0.3.0. */
+export type ChannelOptionBuilder = CreateChannelOption;
+
+/** @deprecated Use {@link CreateCommandOption}. Removed in 0.3.0. */
+export const CommandOptionBuilder = CreateCommandOption;
+/** @deprecated Use {@link CreateCommandOption}. Removed in 0.3.0. */
+export type CommandOptionBuilder = CreateCommandOption;
+
+/** @deprecated Use {@link CreateContextMenuCommand}. Removed in 0.3.0. */
+export const ContextMenuCommandBuilder = CreateContextMenuCommand;
+/** @deprecated Use {@link CreateContextMenuCommand}. Removed in 0.3.0. */
+export type ContextMenuCommandBuilder = CreateContextMenuCommand;
+
+/** @deprecated Use {@link CreateIntegerOption}. Removed in 0.3.0. */
+export const IntegerOptionBuilder = CreateIntegerOption;
+/** @deprecated Use {@link CreateIntegerOption}. Removed in 0.3.0. */
+export type IntegerOptionBuilder = CreateIntegerOption;
+
+/** @deprecated Use {@link CreateMentionableOption}. Removed in 0.3.0. */
+export const MentionableOptionBuilder = CreateMentionableOption;
+/** @deprecated Use {@link CreateMentionableOption}. Removed in 0.3.0. */
+export type MentionableOptionBuilder = CreateMentionableOption;
+
+/** @deprecated Use {@link CreateMessageCommand}. Removed in 0.3.0. */
+export const MessageCommandBuilder = CreateMessageCommand;
+/** @deprecated Use {@link CreateMessageCommand}. Removed in 0.3.0. */
+export type MessageCommandBuilder = CreateMessageCommand;
+
+/** @deprecated Use {@link CreateNumberOption}. Removed in 0.3.0. */
+export const NumberOptionBuilder = CreateNumberOption;
+/** @deprecated Use {@link CreateNumberOption}. Removed in 0.3.0. */
+export type NumberOptionBuilder = CreateNumberOption;
+
+/** @deprecated Use {@link CreateRoleOption}. Removed in 0.3.0. */
+export const RoleOptionBuilder = CreateRoleOption;
+/** @deprecated Use {@link CreateRoleOption}. Removed in 0.3.0. */
+export type RoleOptionBuilder = CreateRoleOption;
+
+/** @deprecated Use {@link CreateSlashCommand}. Removed in 0.3.0. */
+export const SlashCommandBuilder = CreateSlashCommand;
+/** @deprecated Use {@link CreateSlashCommand}. Removed in 0.3.0. */
+export type SlashCommandBuilder = CreateSlashCommand;
+
+/** @deprecated Use {@link CreateStringOption}. Removed in 0.3.0. */
+export const StringOptionBuilder = CreateStringOption;
+/** @deprecated Use {@link CreateStringOption}. Removed in 0.3.0. */
+export type StringOptionBuilder = CreateStringOption;
+
+/** @deprecated Use {@link CreateSubcommand}. Removed in 0.3.0. */
+export const SubcommandBuilder = CreateSubcommand;
+/** @deprecated Use {@link CreateSubcommand}. Removed in 0.3.0. */
+export type SubcommandBuilder = CreateSubcommand;
+
+/** @deprecated Use {@link CreateSubcommandGroup}. Removed in 0.3.0. */
+export const SubcommandGroupBuilder = CreateSubcommandGroup;
+/** @deprecated Use {@link CreateSubcommandGroup}. Removed in 0.3.0. */
+export type SubcommandGroupBuilder = CreateSubcommandGroup;
+
+/** @deprecated Use {@link CreateUserCommand}. Removed in 0.3.0. */
+export const UserCommandBuilder = CreateUserCommand;
+/** @deprecated Use {@link CreateUserCommand}. Removed in 0.3.0. */
+export type UserCommandBuilder = CreateUserCommand;
+
+/** @deprecated Use {@link CreateUserOption}. Removed in 0.3.0. */
+export const UserOptionBuilder = CreateUserOption;
+/** @deprecated Use {@link CreateUserOption}. Removed in 0.3.0. */
+export type UserOptionBuilder = CreateUserOption;
+
+/** @deprecated Use {@link ApplicationCommandOptionEnum}. Removed in 0.3.0. */
+export const ApplicationCommandOptionType = ApplicationCommandOptionEnum;
+/** @deprecated Use {@link ApplicationCommandOptionEnum}. Removed in 0.3.0. */
+export type ApplicationCommandOptionType = ApplicationCommandOptionEnum;