nexocord 1.2.0 → 1.2.1

package/dist/index.js

@@ -58897,30 +58897,30 @@ function getAttachmentName(attachment) {
   if (!attachment || typeof attachment !== "object") {
     throw new Error("Attachment must be an object with a valid file name.");
   }
-  const candidate = attachment;
-  const name = typeof candidate.name === "string" ? candidate.name : typeof candidate.data?.name === "string" ? candidate.data.name : undefined;
+  const file = attachment;
+  const name = typeof file.name === "string" ? file.name : typeof file.data?.name === "string" ? file.data.name : undefined;
   if (!name) {
     throw new Error("Attachment name was not found. Define a name in AttachmentBuilder options.");
   }
   return name;
 }
 // src/core/ui/utils/formatText.ts
-function wrap(content, marker) {
+function surround(content, marker) {
   return `${marker}${content}${marker}`;
 }
-function getInlineCodeDelimiter(content) {
-  let longestRun = 0;
-  let currentRun = 0;
+function getCodeFence(content) {
+  let maxRun = 0;
+  let run = 0;
   for (const character of content) {
     if (character === "`") {
-      currentRun += 1;
-      if (currentRun > longestRun)
-        longestRun = currentRun;
+      run += 1;
+      if (run > maxRun)
+        maxRun = run;
       continue;
     }
-    currentRun = 0;
+    run = 0;
   }
-  return "`".repeat(longestRun + 1);
+  return "`".repeat(maxRun + 1);
 }
 function toLines(input) {
   return Array.isArray(input) ? input : [input];
@@ -58930,25 +58930,25 @@ function formatLines(input, formatter) {
 `);
 }
 function formatText(content, options = {}) {
-  let formatted = toLines(content).join(`
+  let out = toLines(content).join(`
 `);
   if (options.underline)
-    formatted = wrap(formatted, "__");
+    out = surround(out, "__");
   if (options.italic)
-    formatted = wrap(formatted, "*");
+    out = surround(out, "*");
   if (options.bold)
-    formatted = wrap(formatted, "**");
+    out = surround(out, "**");
   if (typeof options.size === "number") {
     const prefix = options.size === 4 ? "-#" : "#".repeat(options.size);
-    return `${prefix} ${formatted}`;
+    return `${prefix} ${out}`;
   }
-  return formatted;
+  return out;
 }
 function formatInlineCode(content) {
   const text = toLines(content).join(`
 `);
-  const delimiter = getInlineCodeDelimiter(text);
-  return `${delimiter}${text}${delimiter}`;
+  const fence = getCodeFence(text);
+  return `${fence}${text}${fence}`;
 }
 function formatQuote(input) {
   return formatLines(input, (line) => `> ${line}`);
@@ -58959,38 +58959,34 @@ function formatSpoiler(input) {
 
 // src/core/ui/utils/formatList.ts
 function formatList(items, options = {}) {
-  return formatLines(items, (item, index) => {
-    if (options.ordered) {
-      return `${index + 1}. ${item}`;
-    }
-    return `- ${item}`;
-  });
+  return formatLines(items, (item, index) => options.ordered ? `${index + 1}. ${item}` : `- ${item}`);
 }
 // src/core/ui/utils/resolveSelectBase.ts
 function resolveSelectBase(customIdOrOpts, opts = {}) {
   if (typeof customIdOrOpts === "string") {
     return { id: customIdOrOpts, ...opts };
   }
-  const { customId, ...selectOptions } = customIdOrOpts;
-  return { id: customId, ...selectOptions };
+  const { customId, ...select } = customIdOrOpts;
+  return { id: customId, ...select };
 }
 // src/core/ui/utils/splitContainerArgs.ts
-function isContainerOptions(value) {
+function isOptions(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) {
     return false;
   }
   return "color" in value;
 }
 function splitContainerArgs(args) {
-  if (isContainerOptions(args[0])) {
+  const head = args[0];
+  if (!isOptions(head)) {
     return {
-      options: args[0],
-      components: args.slice(1)
+      options: {},
+      components: args
     };
   }
   return {
-    options: {},
-    components: args
+    options: head,
+    components: args.slice(1)
   };
 }
 // src/core/ui/builders/primitives.ts
@@ -59041,12 +59037,12 @@ function row(...components) {
   return { type: "row", components };
 }
 function buildEasyFile(url, fileOrSpoiler, spoiler = false) {
-  const hasFile = typeof fileOrSpoiler !== "boolean";
+  const hasAttachment = typeof fileOrSpoiler !== "boolean";
   return {
     type: "file",
     url,
-    spoiler: hasFile ? spoiler : fileOrSpoiler ?? false,
-    attachment: hasFile ? fileOrSpoiler : undefined
+    spoiler: hasAttachment ? spoiler : fileOrSpoiler ?? false,
+    attachment: hasAttachment ? fileOrSpoiler : undefined
   };
 }
 function buildFile(url, fileOrSpoiler, spoiler = false) {
@@ -59059,65 +59055,59 @@ function fromAttachment(attachment, spoiler = false) {
 var file = Object.assign(buildFile, { fromAttachment });
 
 // src/core/ui/builders/select.ts
-function createSelect(type, customId, opts) {
+function mkSelect(type, input, opts) {
+  const select = typeof input === "string" ? resolveSelectBase(input, opts) : resolveSelectBase(input);
   return {
     type,
-    ...resolveSelectBase(customId, opts)
+    ...select
   };
 }
-function createSelectFromObject(type, customIdOrOpts) {
-  const { customId, ...selectOptions } = customIdOrOpts;
-  return {
-    type,
-    ...resolveSelectBase({ customId, ...selectOptions })
-  };
-}
-function createSimpleSelectBuilder(type) {
-  function build(customIdOrOpts, opts) {
-    return typeof customIdOrOpts === "string" ? createSelect(type, customIdOrOpts, opts) : createSelectFromObject(type, customIdOrOpts);
+function mkSimpleBuilder(type) {
+  function build(input, opts) {
+    return mkSelect(type, input, opts);
   }
   return build;
 }
-var userSelect = createSimpleSelectBuilder("select.user");
-var roleSelect = createSimpleSelectBuilder("select.role");
-var mentionableSelect = createSimpleSelectBuilder("select.mentionable");
-function user(customIdOrOpts, opts) {
-  return typeof customIdOrOpts === "string" ? userSelect(customIdOrOpts, opts) : userSelect(customIdOrOpts);
+var userSelect = mkSimpleBuilder("select.user");
+var roleSelect = mkSimpleBuilder("select.role");
+var mentionableSelect = mkSimpleBuilder("select.mentionable");
+function user(input, opts) {
+  return userSelect(input, opts);
 }
-function role(customIdOrOpts, opts) {
-  return typeof customIdOrOpts === "string" ? roleSelect(customIdOrOpts, opts) : roleSelect(customIdOrOpts);
+function role(input, opts) {
+  return roleSelect(input, opts);
 }
-function mentionable(customIdOrOpts, opts) {
-  return typeof customIdOrOpts === "string" ? mentionableSelect(customIdOrOpts, opts) : mentionableSelect(customIdOrOpts);
+function mentionable(input, opts) {
+  return mentionableSelect(input, opts);
 }
-function channel(customIdOrOpts, channelTypes, opts = {}) {
-  if (typeof customIdOrOpts !== "string") {
-    const { channelTypes: resolvedChannelTypes, ...select } = customIdOrOpts;
+function channel(input, channelTypes, opts = {}) {
+  if (typeof input !== "string") {
+    const { channelTypes: chans, ...select } = input;
     return {
       type: "select.channel",
       ...resolveSelectBase(select),
-      channelTypes: resolvedChannelTypes
+      channelTypes: chans
     };
   }
-  const resolvedOpts = Array.isArray(channelTypes) ? opts : channelTypes;
   return {
     type: "select.channel",
-    ...resolveSelectBase(customIdOrOpts, resolvedOpts),
+    ...resolveSelectBase(input, Array.isArray(channelTypes) ? opts : channelTypes),
     channelTypes: Array.isArray(channelTypes) ? channelTypes : undefined
   };
 }
-function string(customIdOrOpts, options, opts = {}) {
-  if (typeof customIdOrOpts !== "string") {
-    const { options: stringOptions, ...select } = customIdOrOpts;
+function string(input, options, opts = {}) {
+  if (typeof input !== "string") {
+    const { options: items, ...select } = input;
     return {
       type: "select.string",
       ...resolveSelectBase(select),
-      options: stringOptions
+      options: items
     };
   }
+  const base = Array.isArray(options) ? opts : {};
   return {
     type: "select.string",
-    ...resolveSelectBase(customIdOrOpts, Array.isArray(options) ? opts : {}),
+    ...resolveSelectBase(input, base),
     options: Array.isArray(options) ? options : []
   };
 }
@@ -59144,6 +59134,9 @@ var ATTACHMENTS = Symbol("ui.display.attachments");
 var RENDERED = Symbol("ui.display.rendered");
 var RENDERED_ATTACHMENTS = Symbol("ui.display.rendered.attachments");
 // src/core/ui/validators/container.ts
+function isSelectComponent(component) {
+  return !("label" in component);
+}
 function validateComponents(components) {
   if (components.length > MAX_MESSAGE_COMPONENTS) {
     throw new Error("A message cannot contain more than 40 components.");
@@ -59168,7 +59161,7 @@ function validateRow(components) {
   if (components.length < 1 || components.length > MAX_ROW_COMPONENTS) {
     throw new Error("Action row must contain between 1 and 5 components.");
   }
-  const selectCount = components.filter((component) => !("label" in component)).length;
+  const selectCount = components.filter(isSelectComponent).length;
   if (selectCount > 0 && components.length > 1) {
     throw new Error("Select menus must be alone in an action row (max width layout rule).");
   }
@@ -59202,37 +59195,47 @@ function validateGallery(items) {
 }
 
 // src/core/ui/validators/button.ts
-function hasLengthBetween(value, min, max) {
+function isLink(button2) {
+  return "url" in button2 && typeof button2.url === "string";
+}
+function hasLen(value, min, max) {
   if (!value)
     return false;
   return value.length >= min && value.length <= max;
 }
 function validateButton(button2) {
-  if (!hasLengthBetween(button2.label, 1, MAX_BUTTON_LABEL_LENGTH)) {
+  if (!hasLen(button2.label, 1, MAX_BUTTON_LABEL_LENGTH)) {
     throw new Error("Button label must have between 1 and 80 characters.");
   }
-  if (!hasLengthBetween(button2.customId, 1, MAX_BUTTON_CUSTOM_ID_LENGTH)) {
+  if (isLink(button2)) {
+    validateUrl(button2.url);
+    return;
+  }
+  if (!hasLen(button2.customId, 1, MAX_BUTTON_CUSTOM_ID_LENGTH)) {
     throw new Error("Button custom id must have between 1 and 100 characters.");
   }
 }
 
 // src/core/ui/validators/select.ts
-function hasLengthBetween2(value, min, max) {
-  if (!value)
+function hasLen2(value, min, max) {
+  if (typeof value !== "string")
     return false;
   return value.length >= min && value.length <= max;
 }
+function checkStringSelect(select) {
+  if (select.options.length < 1 || select.options.length > MAX_STRING_SELECT_OPTIONS) {
+    throw new Error("String select must contain between 1 and 25 options.");
+  }
+}
 function validateSelect(select) {
-  if (!hasLengthBetween2(select.id, 1, 100)) {
+  if (!hasLen2(select.id, 1, 100)) {
     throw new Error("Select custom id must have between 1 and 100 characters.");
   }
-  if (select.placeholder && select.placeholder.length > MAX_SELECT_PLACEHOLDER_LENGTH) {
+  if (typeof select.placeholder === "string" && select.placeholder.length > MAX_SELECT_PLACEHOLDER_LENGTH) {
     throw new Error("Select placeholder cannot exceed 150 characters.");
   }
   if (select.type === "select.string") {
-    if (select.options.length < 1 || select.options.length > MAX_STRING_SELECT_OPTIONS) {
-      throw new Error("String select must contain between 1 and 25 options.");
-    }
+    checkStringSelect(select);
   }
 }
 
@@ -59252,16 +59255,29 @@ var validate = {
 
 // src/core/ui/normalizers/button.ts
 var import_discord4 = __toESM(require_src(), 1);
+function isLink2(button2) {
+  return "url" in button2 && typeof button2.url === "string";
+}
 function normalizeButton(button2) {
   validateButton(button2);
-  const built = new import_discord4.ButtonBuilder().setLabel(button2.label).setCustomId(button2.customId).setStyle(button2.style ?? import_discord4.ButtonStyle.Primary);
+  const btn = new import_discord4.ButtonBuilder().setLabel(button2.label);
+  if (isLink2(button2)) {
+    btn.setURL(button2.url).setStyle(button2.style ?? import_discord4.ButtonStyle.Link);
+  } else {
+    btn.setCustomId(button2.customId).setStyle(button2.style ?? import_discord4.ButtonStyle.Primary);
+  }
   if (button2.emoji) {
-    built.setEmoji({ name: button2.emoji });
+    btn.setEmoji({ name: button2.emoji });
   }
-  return built;
+  return btn;
 }
 function applyButtonData(button2, data) {
-  button2.setLabel(data.label).setCustomId(data.customId).setStyle(data.style ?? import_discord4.ButtonStyle.Primary);
+  button2.setLabel(data.label);
+  if (isLink2(data)) {
+    button2.setURL(data.url).setStyle(data.style ?? import_discord4.ButtonStyle.Link);
+  } else {
+    button2.setCustomId(data.customId).setStyle(data.style ?? import_discord4.ButtonStyle.Primary);
+  }
   if (data.emoji) {
     button2.setEmoji({ name: data.emoji });
   }
@@ -59272,10 +59288,8 @@ var import_discord7 = __toESM(require_src(), 1);
 
 // src/core/ui/normalizers/media.ts
 var import_discord5 = __toESM(require_src(), 1);
-function normalizeGallery(items) {
-  validateGallery(items);
-  const gallery2 = new import_discord5.MediaGalleryBuilder;
-  gallery2.addItems(...items.map((item) => (media) => {
+function toMediaItem(item) {
+  return (media) => {
     validateUrl(item.url);
     media.setURL(item.url);
     if (item.description)
@@ -59283,7 +59297,12 @@ function normalizeGallery(items) {
     if (item.spoiler)
       media.setSpoiler(item.spoiler);
     return media;
-  }));
+  };
+}
+function normalizeGallery(items) {
+  validateGallery(items);
+  const gallery2 = new import_discord5.MediaGalleryBuilder;
+  gallery2.addItems(...items.map(toMediaItem));
   return gallery2;
 }
 function normalizeFile(fileInput) {
@@ -59296,34 +59315,40 @@ function normalizeFile(fileInput) {
 
 // src/core/ui/normalizers/select.ts
 var import_discord6 = __toESM(require_src(), 1);
+function baseSelect(type, select, builder) {
+  validateSelect({ type, ...select });
+  return applySelectBase(builder, select);
+}
+function withChannelTypes(builder, channelTypes) {
+  if (channelTypes?.length)
+    builder.setChannelTypes(...channelTypes);
+  return builder;
+}
+function toStringOptions(select) {
+  return select.options.map((option) => ({
+    label: option.label,
+    value: option.value,
+    description: option.description,
+    default: option.default
+  }));
+}
 function normalizeUserSelect(select) {
-  validateSelect({ type: "select.user", ...select });
-  return applySelectBase(new import_discord6.UserSelectMenuBuilder, select);
+  return baseSelect("select.user", select, new import_discord6.UserSelectMenuBuilder);
 }
 function normalizeRoleSelect(select) {
-  validateSelect({ type: "select.role", ...select });
-  return applySelectBase(new import_discord6.RoleSelectMenuBuilder, select);
+  return baseSelect("select.role", select, new import_discord6.RoleSelectMenuBuilder);
 }
 function normalizeMentionableSelect(select) {
-  validateSelect({ type: "select.mentionable", ...select });
-  return applySelectBase(new import_discord6.MentionableSelectMenuBuilder, select);
+  return baseSelect("select.mentionable", select, new import_discord6.MentionableSelectMenuBuilder);
 }
 function normalizeChannelSelect(select) {
   validateSelect(select);
-  const builder = applySelectBase(new import_discord6.ChannelSelectMenuBuilder, select);
-  if (select.channelTypes?.length)
-    builder.setChannelTypes(...select.channelTypes);
-  return builder;
+  return applySelectBase(withChannelTypes(new import_discord6.ChannelSelectMenuBuilder, select.channelTypes), select);
 }
 function normalizeStringSelect(select) {
   validateSelect(select);
   const builder = applySelectBase(new import_discord6.StringSelectMenuBuilder, select);
-  builder.setOptions(...select.options.map((option) => ({
-    label: option.label,
-    value: option.value,
-    description: option.description,
-    default: option.default
-  })));
+  builder.setOptions(...toStringOptions(select));
   return builder;
 }
 function normalizeSelect(select) {
@@ -59344,14 +59369,24 @@ function normalizeSelect(select) {
 }
 
 // src/core/ui/normalizers/container.ts
-function isContainerChild(component) {
+function isChild(component) {
   return component instanceof import_discord7.TextDisplayBuilder || component instanceof import_discord7.SeparatorBuilder || component instanceof import_discord7.SectionBuilder || component instanceof import_discord7.MediaGalleryBuilder || component instanceof import_discord7.FileBuilder || component instanceof import_discord7.ActionRowBuilder;
 }
-function isDisplayComponent(component) {
-  return component instanceof import_discord7.ContainerBuilder || isContainerChild(component);
+function isDisplay(component) {
+  return component instanceof import_discord7.ContainerBuilder || isChild(component);
+}
+function isObject(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function isButton(component) {
+  if (!isObject(component)) {
+    return false;
+  }
+  const candidate = component;
+  return typeof candidate.label === "string" && (("customId" in candidate) || ("url" in candidate));
 }
-function isContainerNode(component) {
-  return !isContainerChild(component);
+function toRow(component) {
+  return new import_discord7.ActionRowBuilder().addComponents(normalizeButton(component));
 }
 function normalizeRowComponent(component) {
   return "label" in component ? normalizeButton(component) : normalizeSelect(component);
@@ -59370,6 +59405,20 @@ function normalizeSeparator(component) {
   }
   return separator2;
 }
+function setSectionButton(section, button2) {
+  section.setButtonAccessory((target) => applyButtonData(target, button2));
+}
+function setSectionThumb(section, thumbnail2) {
+  validateUrl(thumbnail2.url);
+  section.setThumbnailAccessory((target) => {
+    target.setURL(thumbnail2.url);
+    if (thumbnail2.description)
+      target.setDescription(thumbnail2.description);
+    if (thumbnail2.spoiler)
+      target.setSpoiler(thumbnail2.spoiler);
+    return target;
+  });
+}
 function normalizeSection(component) {
   validateSection(component);
   const section = new import_discord7.SectionBuilder;
@@ -59378,19 +59427,10 @@ function normalizeSection(component) {
     return (text2) => text2.setContent(content);
   }));
   if (component.button) {
-    section.setButtonAccessory((button2) => applyButtonData(button2, component.button));
+    setSectionButton(section, component.button);
   }
   if (component.thumbnail) {
-    const thumbnail2 = component.thumbnail;
-    validateUrl(thumbnail2.url);
-    section.setThumbnailAccessory((thumb) => {
-      thumb.setURL(thumbnail2.url);
-      if (thumbnail2.description)
-        thumb.setDescription(thumbnail2.description);
-      if (thumbnail2.spoiler)
-        thumb.setSpoiler(thumbnail2.spoiler);
-      return thumb;
-    });
+    setSectionThumb(section, component.thumbnail);
   }
   return section;
 }
@@ -59398,7 +59438,7 @@ function normalizeRow(component) {
   validateRow(component.components);
   return new import_discord7.ActionRowBuilder().addComponents(...component.components.map(normalizeRowComponent));
 }
-function normalizeContainerNode(component) {
+function normalizeNode(component) {
   switch (component.type) {
     case "text":
       return normalizeText(component);
@@ -59417,16 +59457,18 @@ function normalizeContainerNode(component) {
   }
 }
 function toContainerChild(component) {
-  if (isContainerChild(component))
+  if (isChild(component))
     return component;
-  if (isContainerNode(component))
-    return normalizeContainerNode(component);
-  return component;
+  if (isButton(component))
+    return toRow(component);
+  return normalizeNode(component);
 }
 function toDisplayComponent(component) {
-  if (isDisplayComponent(component))
+  if (isDisplay(component))
     return component;
-  return normalizeContainerNode(component);
+  if (isButton(component))
+    return toRow(component);
+  return normalizeNode(component);
 }
 function toDisplayComponents(...components) {
   return components.map(toDisplayComponent);
@@ -59446,7 +59488,7 @@ function getRenderedComponentsAttachments(components) {
   return components[RENDERED_ATTACHMENTS] ?? [];
 }
 function isEasyFileInput(component) {
-  if (!component || typeof component !== "object" || Array.isArray(component)) {
+  if (!isObject(component)) {
     return false;
   }
   const candidate = component;
@@ -59483,20 +59525,17 @@ function section(texts, opts = {}) {
 }
 function container(...args) {
   const { options, components } = splitContainerArgs(args);
-  const container2 = new import_discord8.ContainerBuilder;
-  container2.components.push(...components.map(toContainerChild));
+  const out = new import_discord8.ContainerBuilder;
+  out.components.push(...components.map(toContainerChild));
   if (options.color !== undefined) {
-    const accentColor = validate.color(options.color);
-    container2.setAccentColor(accentColor);
+    out.setAccentColor(validate.color(options.color));
   }
-  const attachments = collectAttachmentsFromContainerInputs(components);
-  return attachContainerAttachments(container2, attachments);
+  return attachContainerAttachments(out, collectAttachmentsFromContainerInputs(components));
 }
 function render(...components) {
-  const rendered = toDisplayComponents(...components);
-  validate.components(rendered);
-  const files = collectAttachmentsFromDisplayInputs(components);
-  return createRenderedComponents(rendered, files);
+  const out = toDisplayComponents(...components);
+  validate.components(out);
+  return createRenderedComponents(out, collectAttachmentsFromDisplayInputs(components));
 }
 function send(interaction, payload) {
   if (!isRenderedComponents(payload.components)) {
@@ -59504,8 +59543,10 @@ function send(interaction, payload) {
   }
   validate.components(payload.components);
   const flags = payload.ephemeral ? [import_discord8.MessageFlags.IsComponentsV2, import_discord8.MessageFlags.Ephemeral] : [import_discord8.MessageFlags.IsComponentsV2];
-  const autoFiles = getRenderedComponentsAttachments(payload.components);
-  const files = [...autoFiles, ...payload.files ?? []];
+  const files = [
+    ...getRenderedComponentsAttachments(payload.components),
+    ...payload.files ?? []
+  ];
   return interaction.reply({
     flags,
     components: payload.components,
@@ -63278,7 +63319,7 @@ __export(exports_util, {
   joinValues: () => joinValues,
   issue: () => issue,
   isPlainObject: () => isPlainObject,
-  isObject: () => isObject,
+  isObject: () => isObject2,
   hexToUint8Array: () => hexToUint8Array,
   getSizableOrigin: () => getSizableOrigin,
   getParsedType: () => getParsedType,
@@ -63441,7 +63482,7 @@ function slugify(input) {
   return input.toLowerCase().trim().replace(/[^\w\s-]/g, "").replace(/[\s_-]+/g, "-").replace(/^-+|-+$/g, "");
 }
 var captureStackTrace = "captureStackTrace" in Error ? Error.captureStackTrace : (..._args) => {};
-function isObject(data) {
+function isObject2(data) {
   return typeof data === "object" && data !== null && !Array.isArray(data);
 }
 var allowsEval = /* @__PURE__ */ cached(() => {
@@ -63460,7 +63501,7 @@ var allowsEval = /* @__PURE__ */ cached(() => {
   }
 });
 function isPlainObject(o) {
-  if (isObject(o) === false)
+  if (isObject2(o) === false)
     return false;
   const ctor = o.constructor;
   if (ctor === undefined)
@@ -63468,7 +63509,7 @@ function isPlainObject(o) {
   if (typeof ctor !== "function")
     return true;
   const prot = ctor.prototype;
-  if (isObject(prot) === false)
+  if (isObject2(prot) === false)
     return false;
   if (Object.prototype.hasOwnProperty.call(prot, "isPrototypeOf") === false) {
     return false;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexocord",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Framework TypeScript moderno para criar bots escaláveis ​​do Discord com discord.js v14, apresentando arquitetura modular, cli e utilitários amigáveis ​​para desenvolvedores.",
   "type": "module",
   "private": false,