lunibee 0.2.0 → 0.2.1

package/dist/builders/components.d.ts

@@ -23,6 +23,10 @@ export declare const TextInputStyle: {
     readonly Short: 1;
     readonly Paragraph: 2;
 };
+/** One {@link TextInputStyle} value, usable as a type. */
+export type TextInputStyle = (typeof TextInputStyle)[keyof typeof TextInputStyle];
+/** One {@link ComponentType} value, usable as a type. */
+export type ComponentType = (typeof ComponentType)[keyof typeof ComponentType];
 export interface APIComponentEmoji {
     id?: string | null;
     name?: string | null;
@@ -79,8 +83,8 @@ export interface APITextInputComponent {
 }
 export interface APIModalComponent {
     type: 9;
-    custom_id?: string;
-    title?: string;
+    custom_id: string;
+    title: string;
     components: APIActionRowComponent[];
 }
 export type APIActionRowChild = APIButtonComponent | APIStringSelectComponent | APIEntitySelectComponent | APITextInputComponent;
@@ -196,6 +200,8 @@ export declare class ModalBuilder {
     addComponents(...components: Array<{
         toJSON(): APIActionRowComponent;
     }>): this;
+    /** Adds text inputs, each in its own action row (Discord's modal layout). @param inputs Text inputs, at most 5 per modal. */
+    addTextInputs(...inputs: TextInputBuilder[]): this;
     toJSON(): APIModalComponent;
 }
 export declare class TextInputBuilder {
@@ -287,3 +293,20 @@ export declare class MentionableSelectMenuBuilder extends EntitySelectBuilder {
 export declare class ChannelSelectMenuBuilder extends EntitySelectBuilder {
     constructor();
 }
+/**
+ * A message payload laid out with Components V2: the components, and the flag
+ * Discord requires for them. A V2 message cannot also carry `content` or `embeds`.
+ * @param components Top-level components (containers, sections, text displays, action rows...).
+ * @param options Extra message fields, such as `allowed_mentions` or `ephemeral`; `flags` are combined.
+ * @example channel.send(componentsV2Message(new ContainerBuilder().addComponents(new TextDisplayBuilder().setContent("Hi"))))
+ */
+export declare function componentsV2Message<T extends Record<string, unknown> = Record<string, never>>(components: {
+    toJSON(): APIComponent;
+} | Array<{
+    toJSON(): APIComponent;
+}>, options?: T & {
+    flags?: number;
+}): {
+    components: APIComponent[];
+    flags: number;
+} & T;

package/dist/builders/embed.d.ts

@@ -35,19 +35,19 @@ export interface APIEmbed {
 /** Builds compile-time-safe rich embed payloads for Discord API requests. */
 export declare class EmbedBuilder {
     #private;
-    /** Sets the embed title. @param value Title text. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ setTitle(value: string): this;
-    /** Sets the embed description. @param value Description text. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ setDescription(value: string): this;
-    /** Sets the embed URL. @param value Absolute URL. @returns This builder. @throws {TypeError} If URL is invalid. */ setURL(value: string): this;
+    /** Sets the embed title. @param value Title text, or null to clear. @returns This builder. @throws {RangeError} If title exceeds Discord's limit. */ setTitle(value: string | null): this;
+    /** Sets the embed description. @param value Description text, or null to clear. @returns This builder. @throws {RangeError} If description exceeds Discord's limit. */ setDescription(value: string | null): this;
+    /** Sets the embed URL. @param value Absolute URL, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setURL(value: string | null): this;
     /** Sets the embed color. @param value RGB integer. @returns This builder. @throws {RangeError} If color is outside 24-bit RGB range. */ setColor(value: number): this;
     /** Sets the embed timestamp. @param value Date value. @returns This builder. @throws {RangeError} If date is invalid. */ setTimestamp(value?: Date): this;
     /** Sets the embed footer. @param value Footer payload. @returns This builder. @throws {RangeError} If footer text exceeds Discord's limit. */ setFooter(value: EmbedFooter): this;
     /** Sets the embed author. @param value Author payload. @returns This builder. @throws {RangeError} If author name exceeds Discord's limit. */ setAuthor(value: EmbedAuthor): this;
-    /** Sets the thumbnail URL. @param value Thumbnail URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ setThumbnail(value: {
+    /** Sets the thumbnail URL. @param value Thumbnail URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setThumbnail(value: {
         url: string;
-    } | string): this;
-    /** Sets the image URL. @param value Image URL or payload. @returns This builder. @throws {TypeError} If URL is invalid. */ setImage(value: {
+    } | string | null): this;
+    /** Sets the image URL. @param value Image URL or payload, or null to clear. @returns This builder. @throws {TypeError} If URL is invalid. */ setImage(value: {
         url: string;
-    } | string): this;
+    } | string | null): this;
     /** Adds embed fields. Accepts both the spread form `addFields(a, b)` and the
      * single-array form `addFields([a, b])` for discord.js `RestOrArray` parity.
      * @param fields Field payloads, spread or as a single array. @returns This builder. @throws {RangeError} If the 25-field limit is exceeded. */ addFields(...fields: EmbedField[] | [EmbedField[]]): this;

package/dist/builders/index.d.ts

@@ -1,5 +1,5 @@
 export { EmbedBuilder } 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, } from "./components.js";
+export { ButtonBuilder, ButtonStyle, ComponentType, ActionRowBuilder, StringSelectBuilder, StringSelectMenuBuilder, EntitySelectBuilder, UserSelectMenuBuilder, RoleSelectMenuBuilder, MentionableSelectMenuBuilder, ChannelSelectMenuBuilder, ModalBuilder, TextInputBuilder, TextInputStyle, ContainerBuilder, SectionBuilder, TextDisplayBuilder, MediaGalleryBuilder, FileComponentBuilder, SeparatorBuilder, ThumbnailBuilder, ContentInventoryEntryBuilder, componentsV2Message, } from "./components.js";
 export { SlashCommandBuilder, StringOptionBuilder, IntegerOptionBuilder, NumberOptionBuilder, BooleanOptionBuilder, UserOptionBuilder, ChannelOptionBuilder, RoleOptionBuilder, MentionableOptionBuilder, AttachmentOptionBuilder, SubcommandBuilder, SubcommandGroupBuilder, ApplicationCommandOptionType, UserCommandBuilder, MessageCommandBuilder, ContextMenuCommandBuilder, } from "./commands.js";
 export { AttachmentBuilder, type AttachmentData } from "./attachment.js";

package/dist/builders/index.js

@@ -3,15 +3,24 @@
 class EmbedBuilder {
   #data = {};
   setTitle(value) {
-    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;
   }
   setDescription(value) {
-    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;
   }
   setURL(value) {
-    this.#data.url = url(value, "Embed URL");
+    if (value === null)
+      delete this.#data.url;
+    else
+      this.#data.url = url(value, "Embed URL");
     return this;
   }
   setColor(value) {
@@ -43,11 +52,19 @@ class EmbedBuilder {
     return this;
   }
   setThumbnail(value) {
+    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;
   }
   setImage(value) {
+    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;
@@ -436,6 +453,9 @@ class ModalBuilder {
     this.#components.push(...components);
     return this;
   }
+  addTextInputs(...inputs) {
+    return this.addComponents(...inputs.map((input) => new ActionRowBuilder().addComponents(input)));
+  }
   toJSON() {
     if (!this.#custom_id || !this.#title)
       throw new TypeError("Modals require a custom ID and a title.");
@@ -443,8 +463,8 @@ class ModalBuilder {
       throw new RangeError("Modals require at least one component.");
     return {
       type: 9,
-      ...this.#custom_id ? { custom_id: this.#custom_id } : {},
-      ...this.#title ? { title: this.#title } : {},
+      custom_id: this.#custom_id,
+      title: this.#title,
       components: this.#components.map((component) => component.toJSON())
     };
   }
@@ -732,6 +752,17 @@ function assertSelect(data) {
   if ((data.min_values ?? 1) > (data.max_values ?? 1))
     throw new RangeError("min_values cannot exceed max_values.");
 }
+var IS_COMPONENTS_V2 = 1 << 15;
+function componentsV2Message(components, options) {
+  const list = Array.isArray(components) ? components : [components];
+  if (!list.length)
+    throw new TypeError("A Components V2 message needs at least one component.");
+  return {
+    ...options ?? {},
+    components: list.map((component) => component.toJSON()),
+    flags: (options?.flags ?? 0) | IS_COMPONENTS_V2
+  };
+}
 // packages/builders/src/commands.ts
 var ApplicationCommandOptionType = {
   Subcommand: 1,
@@ -1221,7 +1252,8 @@ export {
   ThumbnailBuilder,
   UserCommandBuilder,
   UserOptionBuilder,
-  UserSelectMenuBuilder
+  UserSelectMenuBuilder,
+  componentsV2Message
 };
 
-//# debugId=91BF5BFA3419A2E364756E2164756E21
+//# debugId=8C8B25AA416C8B5064756E2164756E21