kira-arts 1.3.0 → 1.3.1

package/README.md

@@ -4,6 +4,8 @@ A TypeScript library for generating Discord-style visual cards — profiles, wel
 
 **📚 Full documentation, live examples, and a Playground: [documentation](https://kira-arts.chocofactory.dev/)**
 
+> 🔧 **Heads up:** the documentation is currently hosted at `kira-arts.chocofactory.dev`. This will move to a dedicated, more formal custom domain/branding in an upcoming release — the link above will be kept up to date when that happens.
+
 [![npm version](https://img.shields.io/npm/v/kira-arts.svg)](https://www.npmjs.com/package/kira-arts)
 [![npm downloads](https://img.shields.io/npm/dm/kira-arts.svg)](https://www.npmjs.com/package/kira-arts)
 [![install size](https://packagephobia.com/badge?p=kira-arts)](https://packagephobia.com/result?p=kira-arts)
@@ -15,7 +17,7 @@ A TypeScript library for generating Discord-style visual cards — profiles, wel
 [![release](https://github.com/worddevs/kira-arts/actions/workflows/release.yml/badge.svg)](https://github.com/worddevs/kira-arts/actions/workflows/release.yml)
 [![GitHub stars](https://img.shields.io/github/stars/worddevs/kira-arts.svg?style=flat)](https://github.com/worddevs/kira-arts/stargazers)
 [![GitHub forks](https://img.shields.io/github/forks/worddevs/kira-arts.svg?style=flat)](https://github.com/worddevs/kira-arts/network/members)
-[![contributors](https://img.shields.io/github/contributors/worddevs/kira-arts.svg)](https://github.com/worddevs/kira-arts/graphs/contributors)
+[![contributors](https://img.shields.io/badge/contributors-2-orange)](https://github.com/worddevs/kira-arts/graphs/contributors)
 [![last commit](https://img.shields.io/github/last-commit/worddevs/kira-arts.svg)](https://github.com/worddevs/kira-arts/commits/main)
 [![open issues](https://img.shields.io/github/issues/worddevs/kira-arts.svg)](https://github.com/worddevs/kira-arts/issues)
 [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](./CONTRIBUTING.md)
@@ -25,7 +27,7 @@ A TypeScript library for generating Discord-style visual cards — profiles, wel
 
 - 🖼️ Profile, Welcome/Leave, Level Up, Achievement, Leaderboard, Ship (compatibility), and Now Playing cards
 - 🎵 Now Playing card ships with adapters for moonlink.js, Lavalink-based clients, discord-player, and distube
-- 🎨 8 built-in themes, Nitro/role-color aware borders
+- 🎨 8 built-in themes, Nitro/role-color aware borders, and up to 4-color custom gradients
 - 🧾 Output as `png`, `jpeg`, or `webp`, ready to use as a discord.js `AttachmentBuilder`
 
 ## 📦 Installation
@@ -47,24 +49,71 @@ import { setClient, profileImage, toAttachment } from "kira-arts";
 
 const client = new Client({ intents: [GatewayIntentBits.Guilds] });
 
-client.once("ready", () => {
+client.once("clientReady", () => {
   setClient(client); // 👈 required before generating any card
 });
 
-client.login(process.env.TOKEN);
+client.on("interactionCreate", async (interaction) => {
+  if (interaction.isChatInputCommand()) return;
+
+  if (interaction.commandName === "card") {
+    const buffer = await profileImage(interaction.user.id, {
+      guildId: interaction.guild?.id,
+      useRoleColor: true,
+      presenceStatus: interaction.member?.presence?.status,
+      customBadges: extraBadges.length ? extraBadges : undefined,
+      badgesFrame: true,
+    });
+
+    await interaction.reply({ files: [toAttachment(buffer, "profile", "png")] });
+  }
+});
 
-const buffer = await profileImage(userId, { guildId, useRoleColor: true, theme: "discord" });
-await interaction.reply({ files: [toAttachment(buffer, "profile", "png")] });
+client.login(process.env.TOKEN);
 ```
 
 Every other card, the music adapters, theming, caching, error handling, and output options are documented with live examples at **[documentation](https://kira-arts.chocofactory.dev/)**.
 
+## 🃏 Cards at a glance
+
+| Card            | Function                          | What it's for                               |
+| --------------- | --------------------------------- | ------------------------------------------- |
+| Profile         | `profileImage()`                  | Avatar, badges, nameplate, server tag, rank |
+| Welcome / Leave | `welcomeImage()` / `leaveImage()` | Member join/leave events                    |
+| Level Up        | `levelUpImage()`                  | XP progress bar on level-up                 |
+| Achievement     | `achievementImage()`              | Unlockable achievements with rarity tiers   |
+| Leaderboard     | `leaderboardImage()`              | Server ranking table                        |
+| Ship            | `shipImage()`                     | Compatibility between two users             |
+| Now Playing     | `nowPlayingImage()`               | Music player card with source detection     |
+
+## 🤝 Contributors
+
+Kira-Arts is developed and maintained by the WordDevs community.
+
+<a href="https://github.com/worddevs/kira-arts/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=worddevs/kira-arts" alt="Contributors" />
+</a>
+
 ## 📄 License
 
-Apache-2.0 © [worddevs](https://github.com/worddevs)
+Kira-Arts is released under the **Apache-2.0 License**.
+
+Copyright © [worddevs](https://github.com/worddevs)
 
 ## 🔗 Links
 
-- Documentation: https://kira-arts.chocofactory.dev/
-- Repository: https://github.com/worddevs/kira-arts
-- Issues: https://github.com/worddevs/kira-arts/issues
+- 📚 **Documentation:** https://kira-arts.chocofactory.dev/
+- 📦 **NPM:** https://www.npmjs.com/package/kira-arts
+- 💻 **Repository:** https://github.com/worddevs/kira-arts
+- 🐛 **Issues:** https://github.com/worddevs/kira-arts/issues
+- 🔀 **Contributing:** https://github.com/worddevs/kira-arts/blob/main/CONTRIBUTING.md
+
+---
+
+<p align="center">
+  Made with 💞 by <a href="https://github.com/worddevs">WordDevs</a>
+</p>
+
+<p align="center">
+  <sub>Built with TypeScript and powered by <code>@napi-rs/canvas</code>.</sub>
+</p>

package/dist/index.cjs

@@ -441,7 +441,6 @@ function normalizeDisplayText(value) {
   if (typeof value !== "string") return value;
   try {
     const normalized = value.normalize("NFKC");
-    if (normalized !== value) return normalized;
     return applyMathScriptFallback(normalized);
   } catch {
     return value;
@@ -647,7 +646,7 @@ function getDateOrString(dateInput, createdTimestamp, localDateType = "en") {
     return (/* @__PURE__ */ new Date(+createdTimestamp)).toLocaleDateString(localDateType, dateOptions);
   }
 }
-function formatGiveawayEndText(endsAt, from = Date.now(), localDateType = "es") {
+function formatGiveawayEndText(endsAt, from = Date.now(), localDateType = "en") {
   const target = endsAt instanceof Date ? endsAt : new Date(endsAt);
   const diffMs = target.getTime() - from;
   const isEs = localDateType.startsWith("es");
@@ -718,6 +717,14 @@ function formatDuration(ms) {
   }
   return `${minutes}:${seconds}`;
 }
+function normalizeDisplayText2(text) {
+  if (!text) return text;
+  try {
+    return text.normalize("NFKC");
+  } catch {
+    return text;
+  }
+}
 
 // Public/ProfileImage.files.json
 var ProfileImage_files_default = {
@@ -905,7 +912,17 @@ async function genAvatarFrame(data, options) {
   const ctx = canvas.getContext("2d");
   const frameUrl = data?.decoration?.avatarFrame;
   const avatarFrame = await (0, import_canvas6.loadImage)(frameUrl);
-  ctx.drawImage(avatarFrame, 25, 18, 269, 269);
+  if (options?.squareAvatar) {
+    const roundValue = 30 * (269 / 225);
+    ctx.save();
+    ctx.beginPath();
+    ctx.roundRect(25, 18, 269, 269, [roundValue]);
+    ctx.clip();
+    ctx.drawImage(avatarFrame, 25, 18, 269, 269);
+    ctx.restore();
+  } else {
+    ctx.drawImage(avatarFrame, 25, 18, 269, 269);
+  }
   if (options?.presenceStatus) {
     canvas = await cutAvatarStatus(canvas, options);
   }
@@ -1879,6 +1896,36 @@ function applyTextEffect(ctx, effect, glowColor) {
 
 // Src/Utils/MemberEeventCard/pills.ts
 var import_canvas14 = require("@napi-rs/canvas");
+var JOIN_DOT_COLOR = "#3ba55d";
+var LEAVE_DOT_COLOR = "#ed4245";
+function drawEventKindPill(ctx, width, kind, label) {
+  const dotColor = kind === "welcome" ? JOIN_DOT_COLOR : LEAVE_DOT_COLOR;
+  const dotSize = 7;
+  const paddingX = 12;
+  const pillHeight = 26;
+  const gap = 8;
+  ctx.font = withFallback("12px Helvetica Bold");
+  const textWidth = ctx.measureText(label).width;
+  const pillWidth = paddingX * 2 + dotSize + gap + textWidth;
+  const pillX = width / 2 - pillWidth / 2;
+  const pillY = 16;
+  ctx.save();
+  ctx.beginPath();
+  ctx.roundRect(pillX, pillY, pillWidth, pillHeight, [pillHeight / 2]);
+  ctx.fillStyle = "rgba(10, 10, 14, 0.55)";
+  ctx.fill();
+  ctx.restore();
+  const dotCx = pillX + paddingX + dotSize / 2;
+  const dotCy = pillY + pillHeight / 2;
+  ctx.beginPath();
+  ctx.arc(dotCx, dotCy, dotSize / 2, 0, Math.PI * 2);
+  ctx.fillStyle = dotColor;
+  ctx.fill();
+  ctx.textAlign = "left";
+  ctx.fillStyle = "#ffffff";
+  ctx.font = withFallback("12px Helvetica Bold");
+  ctx.fillText(label, pillX + paddingX + dotSize + gap, pillY + pillHeight / 2 + 4);
+}
 async function drawServerTagPill(ctx, serverTag) {
   const text = truncateText(serverTag.text, 12);
   const iconSize = serverTag.badgeURL ? 18 : 0;
@@ -1952,19 +1999,35 @@ async function drawMemberEventCard(ctx, width, height, avatarUrl, username, layo
   if (bannerImage) {
     drawCoverImage(ctx, bannerImage, 0, 0, width, height);
     const overlay = ctx.createLinearGradient(0, 0, 0, height);
-    overlay.addColorStop(0, "rgba(8, 9, 12, 0.1)");
-    overlay.addColorStop(0.3, "rgba(8, 9, 12, 0.3)");
-    overlay.addColorStop(0.55, "rgba(13, 15, 20, 0.55)");
-    overlay.addColorStop(1, "rgba(13, 15, 20, 0.9)");
+    overlay.addColorStop(0, "rgba(8, 9, 12, 0.15)");
+    overlay.addColorStop(0.3, "rgba(8, 9, 12, 0.35)");
+    overlay.addColorStop(0.55, "rgba(13, 15, 20, 0.6)");
+    overlay.addColorStop(1, "rgba(13, 15, 20, 0.92)");
     ctx.fillStyle = overlay;
     ctx.fillRect(0, 0, width, height);
   } else {
-    const grd = ctx.createLinearGradient(0, 0, width, BANNER_HEIGHT);
-    grd.addColorStop(0, hexToRgba(layout.accentColor, 0.85));
-    grd.addColorStop(1, hexToRgba(layout.accentColor, 0.3));
+    const grd = ctx.createLinearGradient(0, 0, width, BANNER_HEIGHT * 1.4);
+    grd.addColorStop(0, hexToRgba(layout.accentColor, 0.95));
+    grd.addColorStop(0.55, hexToRgba(layout.accentColor, 0.55));
+    grd.addColorStop(1, hexToRgba(layout.accentColor, 0.18));
     ctx.fillStyle = grd;
     ctx.fillRect(0, 0, width, BANNER_HEIGHT);
   }
+  const spotlight = ctx.createRadialGradient(
+    width / 2,
+    BANNER_HEIGHT,
+    0,
+    width / 2,
+    BANNER_HEIGHT,
+    BANNER_HEIGHT * 1.15
+  );
+  spotlight.addColorStop(0, hexToRgba(layout.accentColor, 0.35));
+  spotlight.addColorStop(1, hexToRgba(layout.accentColor, 0));
+  ctx.fillStyle = spotlight;
+  ctx.fillRect(0, 0, width, height);
+  if (layout.kindLabel) {
+    drawEventKindPill(ctx, width, layout.kind, layout.kindLabel);
+  }
   if (layout.serverTag) {
     await drawServerTagPill(ctx, layout.serverTag);
   }
@@ -2020,6 +2083,13 @@ async function drawMemberEventCard(ctx, width, height, avatarUrl, username, layo
   ctx.font = withFallback(`${Math.round(30 * fontScale)}px Helvetica Bold`);
   ctx.fillStyle = layout.usernameColor ? parseHex(layout.usernameColor) : "#FFFFFF";
   ctx.fillText(truncateText(username, 24), width / 2, cursorY);
+  applyTextEffect(ctx, "none", glowColor);
+  const dividerY = cursorY + 14 * fontScale;
+  const dividerWidth = 36 * fontScale;
+  ctx.beginPath();
+  ctx.roundRect(width / 2 - dividerWidth / 2, dividerY, dividerWidth, 3, [2]);
+  ctx.fillStyle = hexToRgba(layout.accentColor, 0.9);
+  ctx.fill();
   if (layout.message) {
     cursorY += 32 * fontScale;
     applyTextEffect(ctx, layout.messageEffect, glowColor);
@@ -2028,11 +2098,11 @@ async function drawMemberEventCard(ctx, width, height, avatarUrl, username, layo
     ctx.fillText(truncateText(layout.message, 64), width / 2, cursorY);
   }
   applyTextEffect(ctx, "none", glowColor);
-  if (layout.memberCount != null) {
+  if (layout.memberCount != null && layout.memberCountText) {
     cursorY += 30 * fontScale;
     ctx.font = withFallback(`bold ${Math.round(16 * fontScale)}px Helvetica Bold`);
     ctx.fillStyle = hexToRgba(layout.accentColor, 1);
-    ctx.fillText(`Miembro #${layout.memberCount}`, width / 2, cursorY);
+    ctx.fillText(layout.memberCountText, width / 2, cursorY);
   }
   if (layout.dateText) {
     cursorY += 26 * fontScale;
@@ -2059,7 +2129,16 @@ var DEFAULT_ACCENT2 = "#2DD4BF";
 function formatMessage(template, username, guildName, memberCount) {
   return template.replace(/\{username\}/g, username).replace(/\{user\}/g, username).replace(/\{server\}/g, guildName).replace(/\{memberCount\}/g, memberCount != null ? String(memberCount) : "");
 }
-async function renderMemberEventCard(userId, guildName, defaultMessage, options = {}) {
+function formatMemberCount(memberCount, localDateType) {
+  const isEs = localDateType.startsWith("es");
+  return isEs ? `Member #${memberCount}` : `Member #${memberCount}`;
+}
+function formatKindLabel(kind, localDateType) {
+  const isEs = localDateType.startsWith("es");
+  if (kind === "welcome") return isEs ? "NEW MEMBER" : "NEW MEMBER";
+  return isEs ? "MEMBER LEFT" : "MEMBER LEFT";
+}
+async function renderMemberEventCard(userId, guildName, defaultMessage, options = {}, kind = "welcome") {
   if (!userId || typeof userId !== "string") {
     throw new KiraError("A valid userId is required", "VALIDATION" /* Validation */);
   }
@@ -2067,7 +2146,7 @@ async function renderMemberEventCard(userId, guildName, defaultMessage, options
     throw new KiraError("A valid guildName is required", "VALIDATION" /* Validation */);
   }
   const data = await fetchUserData(userId, options.guildId, options.bypassCache);
-  const username = data.basicInfo.globalName || data.basicInfo.username;
+  const username = normalizeDisplayText2(data.basicInfo.globalName || data.basicInfo.username);
   const avatarUrl = data.assets.avatarURL ?? data.assets.defaultAvatarURL;
   const palette = getThemePalette(options.theme);
   const accentColor = options.accentColor ? parseHex(options.accentColor) : palette?.accentColor ? parseHex(palette.accentColor) : DEFAULT_ACCENT2;
@@ -2080,16 +2159,23 @@ async function renderMemberEventCard(userId, guildName, defaultMessage, options
     roleColor: data.decoration.roleColor,
     fallback: palette?.borderColor ?? [accentColor]
   });
+  const localDateType = options.localDateType ?? "es";
   const rawMessage = options.message ?? defaultMessage;
-  const message = formatMessage(rawMessage, username, guildName, options.memberCount);
-  const dateText = options.showDate ? getDateOrString(options.date, Date.now(), options.localDateType ?? "es") : void 0;
+  const message = normalizeDisplayText2(
+    formatMessage(rawMessage, username, normalizeDisplayText2(guildName), options.memberCount)
+  );
+  const dateText = options.showDate ? getDateOrString(options.date, Date.now(), localDateType) : void 0;
+  const memberCountText = options.memberCount != null ? formatMemberCount(options.memberCount, localDateType) : void 0;
   const fontScale = options.fontScale && options.fontScale > 0 ? options.fontScale : 1;
   const avatarFrameUrl = options.showAvatarDecoration ? data.decoration.avatarFrame : null;
   const serverTag = options.showServerTag ? data.decoration.serverTag : null;
   const badges = options.showBadges ? data.assets.badges : void 0;
   const layout = {
+    kind,
+    kindLabel: formatKindLabel(kind, localDateType),
     message,
     memberCount: options.memberCount,
+    memberCountText,
     dateText,
     accentColor,
     borderColors,
@@ -2116,15 +2202,15 @@ async function renderMemberEventCard(userId, guildName, defaultMessage, options
 }
 
 // Src/Cards/welcomeImage.ts
-var DEFAULT_WELCOME_MESSAGE = "\xA1Welcome to {server}!";
+var DEFAULT_WELCOME_MESSAGE = "Welcome to {server}!";
 async function welcomeImage(userId, guildName, options = {}) {
-  return renderMemberEventCard(userId, guildName, DEFAULT_WELCOME_MESSAGE, options);
+  return renderMemberEventCard(userId, guildName, DEFAULT_WELCOME_MESSAGE, options, "welcome");
 }
 
 // Src/Cards/leaveImage.ts
-var DEFAULT_LEAVE_MESSAGE = "{username} has left {server}.";
+var DEFAULT_LEAVE_MESSAGE = "{username} has left {server}";
 async function leaveImage(userId, guildName, options = {}) {
-  return renderMemberEventCard(userId, guildName, DEFAULT_LEAVE_MESSAGE, options);
+  return renderMemberEventCard(userId, guildName, DEFAULT_LEAVE_MESSAGE, options, "leave");
 }
 
 // Src/Utils/LevelUpCard/constants.ts
@@ -2541,7 +2627,7 @@ var RARITY_COLORS = {
 };
 var RARITY_LABELS = {
   common: "Common",
-  rare: "Queer",
+  rare: "Rare",
   epic: "Epic",
   legendary: "Legendary"
 };
@@ -3730,7 +3816,7 @@ function drawConfetti(ctx, width, height, colors) {
   ctx.restore();
 }
 function drawStatusPill(ctx, x, y, active, color) {
-  const text = active ? "ACTIVO" : "FINALIZADO";
+  const text = active ? "ACTIVE" : "ENDED";
   ctx.save();
   ctx.font = withFallback("bold 12px Helvetica Bold");
   const textWidth = ctx.measureText(text).width;
@@ -3825,7 +3911,7 @@ async function drawGiveawayCard(ctx, width, height, layout) {
   ctx.textAlign = "left";
   ctx.textBaseline = "middle";
   ctx.fillStyle = "rgba(255, 255, 255, 0.85)";
-  ctx.fillText("SORTEO", PADDING2 + 32, cursorY + 12);
+  ctx.fillText("GIVEAWAY", PADDING2 + 32, cursorY + 12);
   drawStatusPill(ctx, width - PADDING2, cursorY, layout.status !== "ended", statusColor);
   cursorY += 56;
   ctx.textAlign = "left";
@@ -3861,13 +3947,13 @@ async function drawGiveawayCard(ctx, width, height, layout) {
   const midGap = 26;
   const trophyGap = 12;
   const maxRowWidth = width - PADDING2 * 2;
-  const winnersLabel = `${layout.winnersCount} ${layout.winnersCount === 1 ? "ganador" : "ganadores"}`;
+  const winnersLabel = `${layout.winnersCount} ${layout.winnersCount === 1 ? "winner" : "winners"}`;
   ctx.font = withFallback("15px Helvetica");
   const winnersLabelWidth = ctx.measureText(winnersLabel).width;
   const fixedWidth = HOST_AVATAR_SIZE + avatarGap + midGap + trophySize + trophyGap + winnersLabelWidth;
   const hostMaxWidth = layout.hostName ? Math.max(60, maxRowWidth - fixedWidth) : 0;
   ctx.font = withFallback("15px Helvetica");
-  const hostText = layout.hostName ? truncateTextToWidth(ctx, `Organiza ${layout.hostName}`, hostMaxWidth) : "";
+  const hostText = layout.hostName ? truncateTextToWidth(ctx, `Hosted by ${layout.hostName}`, hostMaxWidth) : "";
   const hostTextWidth = layout.hostName ? ctx.measureText(hostText).width : 0;
   const rowWidth = layout.hostName ? HOST_AVATAR_SIZE + avatarGap + hostTextWidth + midGap + trophySize + trophyGap + winnersLabelWidth : trophySize + trophyGap + winnersLabelWidth;
   let rowX = width / 2 - rowWidth / 2;
@@ -3901,7 +3987,7 @@ async function drawGiveawayCard(ctx, width, height, layout) {
     const infoColor = "rgba(255, 255, 255, 0.5)";
     ctx.font = withFallback("13px Helvetica");
     const dateTextWidth = ctx.measureText(layout.dateText).width;
-    const participantsText = layout.participantsCount !== void 0 ? `${layout.participantsCount} ${layout.participantsCount === 1 ? "participante" : "participantes"}` : void 0;
+    const participantsText = layout.participantsCount !== void 0 ? `${layout.participantsCount} ${layout.participantsCount === 1 ? "participant" : "participants"}` : void 0;
     const separator = "  \u2022  ";
     const separatorWidth = participantsText ? ctx.measureText(separator).width : 0;
     const participantsTextWidth = participantsText ? ctx.measureText(participantsText).width : 0;
@@ -3922,7 +4008,7 @@ async function drawGiveawayCard(ctx, width, height, layout) {
   }
   if (hasWinners) {
     const shown = winners.slice(0, MAX_WINNERS_SHOWN);
-    const remaining = winners.length - shown.length;
+    const remaining = layout.winnersCount - shown.length;
     const slotWidth = 92;
     const rowWidth2 = shown.length * slotWidth;
     const startX = width / 2 - rowWidth2 / 2 + slotWidth / 2;
@@ -3938,7 +4024,7 @@ async function drawGiveawayCard(ctx, width, height, layout) {
     if (remaining > 0) {
       ctx.font = withFallback("13px Helvetica");
       ctx.fillStyle = "rgba(255, 255, 255, 0.55)";
-      ctx.fillText(`+${remaining} m\xE1s`, width / 2, height - PADDING2 + 4);
+      ctx.fillText(`+${remaining} more`, width / 2, height - PADDING2 + 4);
     }
   }
   ctx.restore();
@@ -3965,6 +4051,7 @@ async function giveawayImage(prize, options = {}) {
   const hostData = options.hostId ? await fetchUserData(options.hostId, options.guildId, bypassCache) : void 0;
   const hostName = options.hostName ?? hostData?.basicInfo.globalName ?? hostData?.basicInfo.username;
   const hostAvatarUrl = options.hostAvatar ?? hostData?.assets.avatarURL ?? hostData?.assets.defaultAvatarURL;
+  const totalWinnerIds = options.winnerIds?.length ?? 0;
   const winnerIds = options.winnerIds?.slice(0, MAX_WINNERS_SHOWN) ?? [];
   const winnerDataList = await Promise.all(
     winnerIds.map((winnerId) => fetchUserData(winnerId, options.guildId, bypassCache))
@@ -3973,7 +4060,7 @@ async function giveawayImage(prize, options = {}) {
     username: data.basicInfo.globalName || data.basicInfo.username,
     avatarUrl: data.assets.avatarURL ?? data.assets.defaultAvatarURL
   }));
-  const winnersCount = options.winnersCount ?? (winnerIds.length > 0 ? winnerIds.length : 1);
+  const winnersCount = options.winnersCount ?? (totalWinnerIds > 0 ? totalWinnerIds : 1);
   const palette = getThemePalette(options.theme);
   const accentColor = options.accentColor ? parseHex(options.accentColor) : palette?.accentColor ?? DEFAULT_ACCENT6;
   const borderColors = resolveCardColors({
@@ -3985,7 +4072,7 @@ async function giveawayImage(prize, options = {}) {
     roleColor: hostData?.decoration.roleColor,
     fallback: palette?.borderColor ?? [accentColor]
   });
-  const dateText = status === "ended" ? options.endedText ?? "Sorteo finalizado" : options.endsAt ? formatGiveawayEndText(options.endsAt, Date.now(), options.localDateType ?? "es") : void 0;
+  const dateText = status === "ended" ? options.endedText ?? "Giveaway ended" : options.endsAt ? formatGiveawayEndText(options.endsAt, Date.now(), options.localDateType ?? "en") : void 0;
   const layout = {
     prize,
     description: options.description,