kira-arts 1.5.0 → 1.6.0

package/README.md

@@ -32,6 +32,7 @@ A TypeScript library for generating Discord-style visual cards — profiles, wel
 - ⚡ Built-in, configurable in-memory cache for fetched user data (`setCacheOptions`, `clearCache`, `getCacheSize`)
 - 🛡️ Typed error handling with `KiraError` and `KiraErrorCode`, instead of opaque runtime failures
 - 📦 Dual package: ESM and CommonJS builds, both with full type declarations, no extra config needed
+- 📐 Selectable `size` (`compact`, `standard`, `wide`) for Level Up cards, rendered as vectors so every size stays sharp
 
 ## 📦 Installation
 
@@ -82,21 +83,21 @@ Every other card, the music adapters, theming, caching, error handling, and outp
 
 ## 🃏 Cards at a glance
 
-| Card         | Function                                          | What it's for                                             |
-| ------------ | ------------------------------------------------- | --------------------------------------------------------- |
-| Profile      | `profileImage(userId, options)`                   | Avatar, badges, nameplate, server tag, rank               |
-| Welcome      | `welcomeImage(userId, guildName, options)`        | Member join events                                        |
-| Leave        | `leaveImage(userId, guildName, options)`          | Member leave events                                       |
-| Level Up     | `levelUpImage(userId, level, options)`            | XP progress bar on level-up                               |
-| Achievement  | `achievementImage(userId, title, options)`        | Unlockable achievements with rarity tiers                 |
-| Leaderboard  | `leaderboardImage(entries, options)`              | Server ranking table                                      |
-| Ship         | `shipImage(leftUserId, rightUserId, options)`     | Compatibility between two users                           |
-| Now Playing  | `nowPlayingImage(track, options)`                 | Music player card with source detection                   |
-| Giveaway     | `giveawayImage(prize, options)`                   | Prize, host, entry count, winners on end                  |
-| Birthday     | `birthdayImage(userId, options)`                  | Balloons, confetti, and an optional age/years counter     |
-| Marriage     | `marriageImage(leftUserId, rightUserId, options)` | Certificate-style card with automatic days-together count |
-| Weekly Recap | `weeklyRecapImage(userId, options)`               | Wrapped-style weekly summary with a 7-day activity chart  |
-| Code Snippet | `codeSnippetImage(code, options)`                 | Carbon-style syntax-highlighted code screenshot           |
+| Card         | Function                                          | What it's for                                               |
+| ------------ | ------------------------------------------------- | ----------------------------------------------------------- |
+| Profile      | `profileImage(userId, options)`                   | Avatar, badges, nameplate, server tag, rank                 |
+| Welcome      | `welcomeImage(userId, guildName, options)`        | Member join events                                          |
+| Leave        | `leaveImage(userId, guildName, options)`          | Member leave events                                         |
+| Level Up     | `levelUpImage(userId, level, options)`            | XP progress bar on level-up, in compact/standard/wide sizes |
+| Achievement  | `achievementImage(userId, title, options)`        | Unlockable achievements with rarity tiers                   |
+| Leaderboard  | `leaderboardImage(entries, options)`              | Server ranking table                                        |
+| Ship         | `shipImage(leftUserId, rightUserId, options)`     | Compatibility between two users                             |
+| Now Playing  | `nowPlayingImage(track, options)`                 | Music player card with source detection                     |
+| Giveaway     | `giveawayImage(prize, options)`                   | Prize, host, entry count, winners on end                    |
+| Birthday     | `birthdayImage(userId, options)`                  | Balloons, confetti, and an optional age/years counter       |
+| Marriage     | `marriageImage(leftUserId, rightUserId, options)` | Certificate-style card with automatic days-together count   |
+| Weekly Recap | `weeklyRecapImage(userId, options)`               | Wrapped-style weekly summary with a 7-day activity chart    |
+| Code Snippet | `codeSnippetImage(code, options)`                 | Carbon-style syntax-highlighted code screenshot             |
 
 ## 🛠️ Utilities
 

package/dist/index.cjs

@@ -1779,12 +1779,12 @@ const BANNER_SIZE_SCALE = {
 function normalizeFontScale(fontScale) {
 	return fontScale && fontScale > 0 ? fontScale : 1;
 }
-function normalizeSize(size) {
+function normalizeSize$1(size) {
 	return size === "compact" || size === "wide" ? size : "standard";
 }
 function computeEffectiveFontScale(layout) {
 	const fontScale = normalizeFontScale(layout.fontScale);
-	const size = normalizeSize(layout.size);
+	const size = normalizeSize$1(layout.size);
 	return fontScale * (layout.layoutStyle === "banner" ? BANNER_SIZE_SCALE[size] : CENTERED_FONT_SCALE[size]);
 }
 function computeAvatarSize(fontScale) {
@@ -1802,7 +1802,7 @@ function computeBodyHeight(hasMessage, hasSecondaryMessage, hasMemberCount, hasD
 }
 function getCardDimensions$9(layout) {
 	if (layout.layoutStyle === "banner") {
-		const preset = BANNER_DIMENSIONS[normalizeSize(layout.size)];
+		const preset = BANNER_DIMENSIONS[normalizeSize$1(layout.size)];
 		return {
 			width: preset.width,
 			height: preset.height
@@ -1817,7 +1817,7 @@ function getCardDimensions$9(layout) {
 	const bodyHeight = computeBodyHeight(hasMessage, hasSecondaryMessage, hasMemberCount, hasDate, fontScale);
 	const height = Math.round(170 + avatarSize / 2 + bodyHeight);
 	return {
-		width: CENTERED_WIDTH_PRESET[normalizeSize(layout.size)],
+		width: CENTERED_WIDTH_PRESET[normalizeSize$1(layout.size)],
 		height
 	};
 }
@@ -2574,12 +2574,27 @@ async function leaveImage(userId, guildName, options = {}) {
 	return renderMemberEventCard(userId, guildName, DEFAULT_LEAVE_MESSAGE, options, "leave");
 }
 
+//#endregion
+//#region Src/Utils/LevelUpCard/constants.ts
+const LEVEL_UP_SIZE_SCALE = {
+	compact: .8,
+	standard: 1,
+	wide: 1.2
+};
+
 //#endregion
 //#region Src/Utils/LevelUpCard/dimensions.ts
-function getCardDimensions$8() {
+function normalizeSize(size) {
+	return size === "compact" || size === "wide" ? size : "standard";
+}
+function getSizeScale(size) {
+	return LEVEL_UP_SIZE_SCALE[normalizeSize(size)];
+}
+function getCardDimensions$8(size) {
+	const scale = getSizeScale(size);
 	return {
-		width: 700,
-		height: 260
+		width: Math.round(700 * scale),
+		height: Math.round(260 * scale)
 	};
 }
 function createLevelUpCanvas(width, height) {
@@ -2901,9 +2916,13 @@ async function drawLevelUpCard(ctx, width, height, layout) {
 //#endregion
 //#region Src/Utils/levelUpCard.output.utils.ts
 async function genLevelUpPng(layout, output) {
-	const { width, height } = getCardDimensions$8();
+	const { width, height } = getCardDimensions$8(layout.size);
+	const scale = getSizeScale(layout.size);
 	const { canvas, ctx } = createLevelUpCanvas(width, height);
-	await drawLevelUpCard(ctx, width, height, layout);
+	ctx.save();
+	ctx.scale(scale, scale);
+	await drawLevelUpCard(ctx, 700, 260, layout);
+	ctx.restore();
 	return encodeCanvas(canvas, output);
 }
 
@@ -2934,6 +2953,7 @@ async function levelUpImage(userId, level, options = {}) {
 	const avatarFrameUrl = options.showAvatarDecoration !== false ? data.decoration.avatarFrame : null;
 	const badges = options.showBadges ? data.assets.badges : void 0;
 	const layout = {
+		size: options.size ?? "standard",
 		username,
 		avatarUrl,
 		level,