@kungal/ui-core 2.43.0 → 2.44.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @kungal/ui-core
 
+## 2.44.0
+
+### Minor Changes
+
+- 7cd484e: KunAvatar draws avatar frames. `KunUser` gains an optional `avatarDecoration: { src, animatedSrc? }`, and any avatar whose user carries one gets the frame around it — `KunUserChip` included, with no change at the call site. The asset is a square canvas 1.2× the avatar with the avatar circle centred, the geometry Discord's decorations and Steam's avatar frames use; the frame hangs 10% outside the avatar on every side as an absolutely positioned, `pointer-events: none`, `aria-hidden` overlay, so it moves no layout and never takes the avatar link's click.
+
+  The new `decoration` prop decides when the animated asset plays: `hover` (the default) shows the still frame and plays the animation while the avatar is hovered or focused, `always` plays it continuously, `static` never animates, and `none` hides the frame. Frames are not drawn below the `md` size, where they are illegible, and `KunAvatarGroup` never draws them — its 4px gap cannot hold two frames overhanging by 10%. A reader who asked for reduced motion always gets the still image, through a native `<picture>` `<source media="(prefers-reduced-motion: reduce)">`, so it is right in the server-rendered HTML with no script.
+
+  Nothing changes for a user without `avatarDecoration`: no extra element, no inline style.
+
 ## 2.43.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -151,6 +151,20 @@ interface KunUser {
     id: number;
     name: string;
     avatar: string;
+    /**
+     * An avatar frame drawn around the avatar (NextMoe `cosmetics.avatar_frame`).
+     * Absent or null → no frame.
+     */
+    avatarDecoration?: KunAvatarDecoration | null;
+}
+/**
+ * A frame asset on a square canvas 1.2× the avatar, the avatar circle centred
+ * in it. `src` is the still image; `animatedSrc`, when present, is played on
+ * hover or always, depending on KunAvatar's `decoration`.
+ */
+interface KunAvatarDecoration {
+    src: string;
+    animatedSrc?: string;
 }
 
 interface KunIconData {
@@ -163,4 +177,4 @@ declare const registerKunIcons: (icons: Record<string, KunIconData>) => void;
 declare const getKunIcon: (name: string) => KunIconData | undefined;
 declare const hasKunIcon: (name: string) => boolean;
 
-export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, cn, decodeIfEncoded, getKunIcon, getRandomSticker, hasKunIcon, kunBgClasses, kunBorderClasses, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, translateKunMessage };
+export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, cn, decodeIfEncoded, getKunIcon, getRandomSticker, hasKunIcon, kunBgClasses, kunBorderClasses, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, translateKunMessage };

package/dist/index.d.ts

@@ -151,6 +151,20 @@ interface KunUser {
     id: number;
     name: string;
     avatar: string;
+    /**
+     * An avatar frame drawn around the avatar (NextMoe `cosmetics.avatar_frame`).
+     * Absent or null → no frame.
+     */
+    avatarDecoration?: KunAvatarDecoration | null;
+}
+/**
+ * A frame asset on a square canvas 1.2× the avatar, the avatar circle centred
+ * in it. `src` is the still image; `animatedSrc`, when present, is played on
+ * hover or always, depending on KunAvatar's `decoration`.
+ */
+interface KunAvatarDecoration {
+    src: string;
+    animatedSrc?: string;
 }
 
 interface KunIconData {
@@ -163,4 +177,4 @@ declare const registerKunIcons: (icons: Record<string, KunIconData>) => void;
 declare const getKunIcon: (name: string) => KunIconData | undefined;
 declare const hasKunIcon: (name: string) => boolean;
 
-export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, cn, decodeIfEncoded, getKunIcon, getRandomSticker, hasKunIcon, kunBgClasses, kunBorderClasses, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, translateKunMessage };
+export { KUN_AVATAR_FALLBACK, KUN_CATALOG_ZH_CN, KUN_DEFAULT_ROUNDED, KUN_SHATTER_PHYSICS, KUN_SWIPE_DISMISS_PHYSICS, type KunAvatarDecoration, type KunIconData, KunMessageCatalog, KunMessagePath, KunMessages, type KunSelectionSize, type KunUIColor, type KunUIRounded, type KunUISize, type KunUIVariant, type KunUser, cn, decodeIfEncoded, getKunIcon, getRandomSticker, hasKunIcon, kunBgClasses, kunBorderClasses, kunChipSizeClasses, kunControlSizeClasses, kunControlSquareClasses, kunFocusRingClasses, kunFocusRingWithinClasses, kunPanelRoundedClass, kunRingClasses, kunRoundedClasses, kunSelectionSizeClasses, kunSoftBgClasses, kunSolidBgClasses, kunSolidClasses, kunSolidFgClasses, kunTextClasses, kunVariantClasses, pickAvatarFallback, randomNum, registerKunIcon, registerKunIcons, resolveRounded, translateKunMessage };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kungal/ui-core",
-  "version": "2.43.0",
+  "version": "2.44.0",
   "description": "KunUI framework-agnostic core — design types, cn(), variant matrix, radius system, utils. No Vue/React.",
   "type": "module",
   "keywords": [