@lunibee/builders 0.2.0 → 0.2.2

package/src/embed.ts

@@ -30,24 +30,28 @@ export interface APIEmbed {
 }
 
 /** Builds compile-time-safe rich embed payloads for Discord API requests. */
-export class EmbedBuilder {
+export class CreateEmbed {
     readonly #data: APIEmbed = {};
-    /** Sets the embed title. @param value Title text. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ public setTitle(
-        value: string,
+    /** Sets the embed title. @param value Title text, or null to clear. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ public setTitle(
+        value: string | null,
     ): this {
-        this.#data.title = validate(value, 256, "Embed title");
+        if (value === null) delete this.#data.title;
+        else this.#data.title = validate(value, 256, "Embed title");
         return this;
     }
-    /** Sets the embed description. @param value Description text. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ public setDescription(
-        value: string,
+    /** Sets the embed description. @param value Description text, or null to clear. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ public setDescription(
+        value: string | null,
     ): this {
-        this.#data.description = validate(value, 4096, "Embed description");
+        if (value === null) delete this.#data.description;
+        else
+            this.#data.description = validate(value, 4096, "Embed description");
         return this;
     }
-    /** Sets the embed URL. @param value Absolute URL. @returns This builder. @throws {TypeError} If URL is invalid. */ public setURL(
-        value: string,
+    /** Sets the embed URL. @param value Absolute URL, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ public setURL(
+        value: string | null,
     ): this {
-        this.#data.url = url(value, "Embed URL");
+        if (value === null) delete this.#data.url;
+        else this.#data.url = url(value, "Embed URL");
         return this;
     }
     /** Sets the embed color. @param value RGB integer. @returns This builder. @throws {RangeError} If color is outside 24-bit RGB range. */ public setColor(
@@ -92,16 +96,24 @@ export class EmbedBuilder {
         };
         return this;
     }
-    /** Sets the thumbnail URL. @param value Thumbnail URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ public setThumbnail(
-        value: { url: string } | string,
+    /** Sets the thumbnail URL. @param value Thumbnail URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ public setThumbnail(
+        value: { url: string } | string | null,
     ): this {
+        if (value === null) {
+            delete this.#data.thumbnail;
+            return this;
+        }
         const valueURL = typeof value === "string" ? value : value.url;
         this.#data.thumbnail = { url: url(valueURL, "Thumbnail URL") };
         return this;
     }
-    /** Sets the image URL. @param value Image URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ public setImage(
-        value: { url: string } | string,
+    /** Sets the image URL. @param value Image URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ public setImage(
+        value: { url: string } | string | null,
     ): this {
+        if (value === null) {
+            delete this.#data.image;
+            return this;
+        }
         const valueURL = typeof value === "string" ? value : value.url;
         this.#data.image = { url: url(valueURL, "Image URL") };
         return this;
@@ -191,3 +203,12 @@ function url(value: string, field: string): string {
         throw new TypeError(`${field} must be a valid URL.`, { cause: error });
     }
 }
+
+// ─── Deprecated names (0.2.2), removed in 2.0 ────────────────────────────────
+// Builders are now `CreateX` (`ButtonBuilder` → `CreateButton`); `…Style` became
+// `…Type` and `…Type` became `…Enum`.
+
+/** @deprecated Use {@link CreateEmbed}. Removed in 2.0. */
+export const EmbedBuilder = CreateEmbed;
+/** @deprecated Use {@link CreateEmbed}. Removed in 2.0. */
+export type EmbedBuilder = CreateEmbed;

package/src/index.ts

@@ -1,45 +1,114 @@
-export { EmbedBuilder } from "./embed.js";
+export { CreateEmbed } from "./embed.js";
 export type { EmbedField } from "./embed.js";
 export {
-    ButtonBuilder,
-    ButtonStyle,
-    ComponentType,
-    ActionRowBuilder,
-    StringSelectBuilder,
-    StringSelectMenuBuilder,
-    EntitySelectBuilder,
-    UserSelectMenuBuilder,
-    RoleSelectMenuBuilder,
-    MentionableSelectMenuBuilder,
-    ChannelSelectMenuBuilder,
-    ModalBuilder,
-    TextInputBuilder,
-    TextInputStyle,
-    ContainerBuilder,
-    SectionBuilder,
-    TextDisplayBuilder,
-    MediaGalleryBuilder,
-    FileComponentBuilder,
-    SeparatorBuilder,
-    ThumbnailBuilder,
-    ContentInventoryEntryBuilder,
+    CreateButton,
+    ButtonType,
+    ComponentEnum,
+    CreateActionRow,
+    CreateStringSelect,
+    CreateStringSelectMenu,
+    CreateEntitySelect,
+    CreateUserSelectMenu,
+    CreateRoleSelectMenu,
+    CreateMentionableSelectMenu,
+    CreateChannelSelectMenu,
+    CreateModal,
+    CreateTextInput,
+    TextInputType,
+    CreateContainer,
+    CreateSection,
+    CreateTextDisplay,
+    CreateMediaGallery,
+    CreateFileComponent,
+    CreateSeparator,
+    CreateThumbnail,
+    CreateContentInventoryEntry,
+    componentsV2Message,
 } from "./components.js";
 export {
-    SlashCommandBuilder,
-    StringOptionBuilder,
-    IntegerOptionBuilder,
-    NumberOptionBuilder,
+    CreateSlashCommand,
+    CreateStringOption,
+    CreateIntegerOption,
+    CreateNumberOption,
+    CreateBooleanOption,
+    CreateUserOption,
+    CreateChannelOption,
+    CreateRoleOption,
+    CreateMentionableOption,
+    CreateAttachmentOption,
+    CreateSubcommand,
+    CreateSubcommandGroup,
+    ApplicationCommandOptionEnum,
+    CreateUserCommand,
+    CreateMessageCommand,
+    CreateContextMenuCommand,
+} from "./commands.js";
+export { CreateAttachment, type AttachmentData } from "./attachment.js";
+
+// Deprecated names (0.2.2), removed in 2.0.
+export { AttachmentBuilder } from "./attachment.js";
+export { EmbedBuilder } from "./embed.js";
+export {
+    AttachmentOptionBuilder,
     BooleanOptionBuilder,
-    UserOptionBuilder,
     ChannelOptionBuilder,
-    RoleOptionBuilder,
+    CommandOptionBuilder,
+    ContextMenuCommandBuilder,
+    IntegerOptionBuilder,
     MentionableOptionBuilder,
-    AttachmentOptionBuilder,
+    MessageCommandBuilder,
+    NumberOptionBuilder,
+    RoleOptionBuilder,
+    SlashCommandBuilder,
+    StringOptionBuilder,
     SubcommandBuilder,
     SubcommandGroupBuilder,
-    ApplicationCommandOptionType,
     UserCommandBuilder,
-    MessageCommandBuilder,
-    ContextMenuCommandBuilder,
+    UserOptionBuilder,
+    ApplicationCommandOptionType,
 } from "./commands.js";
-export { AttachmentBuilder, type AttachmentData } from "./attachment.js";
+export {
+    ButtonBuilder,
+    ChannelSelectMenuBuilder,
+    ContainerBuilder,
+    ContentInventoryEntryBuilder,
+    EntitySelectBuilder,
+    FileComponentBuilder,
+    MediaGalleryBuilder,
+    MentionableSelectMenuBuilder,
+    ModalBuilder,
+    RoleSelectMenuBuilder,
+    SectionBuilder,
+    SeparatorBuilder,
+    StringSelectBuilder,
+    StringSelectMenuBuilder,
+    TextDisplayBuilder,
+    TextInputBuilder,
+    ThumbnailBuilder,
+    UserSelectMenuBuilder,
+    ActionRowBuilder,
+    ButtonStyle,
+    TextInputStyle,
+    ComponentType,
+} from "./components.js";
+export type {
+    APIComponent,
+    APIComponentEmoji,
+    APIActionRowChild,
+    APIActionRowComponent,
+    APIButtonComponent,
+    APISelectOption,
+    APISelectDefaultValue,
+    APIStringSelectComponent,
+    APIEntitySelectComponent,
+    APITextInputComponent,
+    APIModalComponent,
+    APIContainerComponent,
+    APISectionComponent,
+    APITextDisplayComponent,
+    APIMediaGalleryComponent,
+    APIFileComponent,
+    APISeparatorComponent,
+    APIThumbnailComponent,
+    APIContentInventoryEntryComponent,
+} from "./components.js";