@coffic/cosy-ui 0.9.68 → 0.9.71

package/dist/src-vue/button/class.ts

@@ -1,6 +1,23 @@
 import type { IButtonProps } from "./props";
 import { getBaseButtonClasses } from "../../src/components/button/class-all";
 
+/**
+ * 将可能的对象形式的 class 转换为字符串
+ * @param className 类名，可以是字符串或对象
+ * @returns 字符串形式的类名
+ */
+function normalizeClass(className: string | object | undefined): string {
+	if (!className) return "";
+	if (typeof className === "string") return className;
+	if (typeof className === "object") {
+		return Object.entries(className)
+			.filter(([, value]) => value)
+			.map(([key]) => key)
+			.join(" ");
+	}
+	return "";
+}
+
 /**
  * 计算 Button 组件的组合类名（Vue 版本）
  * @param props Button 组件的属性
@@ -17,6 +34,9 @@ export function getButtonCombinedClassesVue(props: IButtonProps): string {
 		class: className,
 	} = props;
 
+	// 规范化 class 属性
+	const normalizedClass = normalizeClass(className);
+
 	// 使用共用的工具函数计算基础类名
 	const baseClasses = getBaseButtonClasses({
 		variant,
@@ -25,7 +45,7 @@ export function getButtonCombinedClassesVue(props: IButtonProps): string {
 		wide,
 		block,
 		loading,
-		class: className,
+		class: normalizedClass,
 	});
 
 	return baseClasses.filter(Boolean).join(" ");

package/dist/src-vue/image-display/ImageGrid.vue

@@ -14,9 +14,7 @@ interface IImageGridProps {
 	maxDisplay: number;
 }
 
-interface IImageGridEmits {
-	(e: "imageClick", imageUrl: string): void;
-}
+type IImageGridEmits = (e: "imageClick", imageUrl: string) => void;
 
 const props = defineProps<IImageGridProps>();
 const emit = defineEmits<IImageGridEmits>();

package/dist/src-vue/image-display/ImageItem.vue

@@ -12,9 +12,7 @@ interface IImageItemProps {
 	size: "sm" | "md" | "lg";
 }
 
-interface IImageItemEmits {
-	(e: "imageClick", imageUrl: string): void;
-}
+type IImageItemEmits = (e: "imageClick", imageUrl: string) => void;
 
 const props = defineProps<IImageItemProps>();
 const emit = defineEmits<IImageItemEmits>();

package/dist/src-vue/image-display/ImagePreview.vue

@@ -12,9 +12,7 @@ interface IImagePreviewProps {
 	showPreview: boolean;
 }
 
-interface IImagePreviewEmits {
-	(e: "close"): void;
-}
+type IImagePreviewEmits = (e: "close") => void;
 
 const props = defineProps<IImagePreviewProps>();
 const emit = defineEmits<IImagePreviewEmits>();

package/dist/src-vue/image-display/types.ts

@@ -5,6 +5,4 @@ export interface IImageDisplayProps {
 	maxDisplay?: number;
 }
 
-export interface IImageDisplayEmits {
-	(e: "imageClick", imageUrl: string): void;
-}
+export type IImageDisplayEmits = (e: "imageClick", imageUrl: string) => void;

package/dist/src-vue/key-catcher/KeyCatcher.vue

@@ -38,7 +38,7 @@ const lastKey = ref<string | null>(null);
 let timer: ReturnType<typeof setTimeout> | null = null;
 
 const props = defineProps<{ showKey?: boolean }>();
-const emit = defineEmits<{ (e: "globalKey", key: string): void }>();
+const emit = defineEmits<(e: "globalKey", key: string) => void>();
 
 const handleKeydown = (event: KeyboardEvent) => {
 	if (

package/dist/src-vue/link/Link.vue

@@ -21,6 +21,8 @@ import { getLinkCombinedClassesVue } from "./class";
  * @props {boolean} [fullWidth=false] - 是否占满宽度
  * @props {boolean} [ghost=false] - 是否为幽灵按钮（需配合 btn 使用）
  * @props {string} href - 链接地址（必需）
+ * @props {string} [hoverImage] - 悬停时显示的图片URL
+ * @props {string} [hoverImageAlt] - 悬停图片的替代文本
  * @props {string} [icon] - 图标名称，支持所有可用的图标组件
  * @props {string} [navigationType] - 导航类型（需配合 navigation 变体使用）：previous、next
  * @props {boolean} [noUnderline=true] - 是否移除下划线

package/dist/src-vue/review/Review.vue

@@ -46,12 +46,17 @@ const {
 	px,
 	pl,
 	pr,
+	shadow, // 添加 shadow 属性
 	width,
 	rounded,
 	background,
 	border,
 	borderColor,
-	shadow,
+	subtitle,
+	title,
+	imageUrl,
+	href,
+	compact,
 } = props;
 
 // 生成星级评分
@@ -104,14 +109,19 @@ const formattedDate = computed(() => {
       border,
       borderColor,
       shadow,
+      subtitle,
+      title: userName, // 将 userName 作为 title 传递给 Card 组件
+      imageUrl,
+      href,
+      compact,
     }"
     :class="className"
     :class:list="classList">
     <div class="cosy:flex cosy:items-start cosy:gap-4">
       <Avatar
         v-if="avatar"
-        :src="avatar"
-        :alt="userName"
+        :avatar="avatar"
+        :userName="userName"
         size="md"
         class="cosy:flex-shrink-0" />
       <div class="cosy:flex-1">

package/dist/src-vue/review/Reviews.vue

@@ -133,3 +133,72 @@ const gridColumns = computed(() => {
 	return cols;
 });
 </script>
+
+<template>
+  <div :class="['cosy:w-full', className]" :class:list="classList">
+    <!-- 标题 -->
+    <Heading v-if="title" level="h2" class="cosy:mb-6">
+      {{ title }}
+    </Heading>
+
+    <!-- 统计信息 -->
+    <div
+      v-if="stats"
+      class="cosy:flex cosy:flex-col md:cosy:flex-row md:cosy:items-center md:cosy:justify-between cosy:gap-6 cosy:mb-8">
+      <div class="cosy:flex cosy:items-center cosy:gap-4">
+        <Text variant="h1" class="cosy:text-5xl cosy:font-bold">
+          {{ stats.averageRating.toFixed(1) }}
+        </Text>
+        <div>
+          <div class="cosy:flex cosy:items-center cosy:gap-1">
+            <SmartIcon
+              v-for="(star, index) in averageStarArray"
+              :key="index"
+              :name="
+                star.filled ? 'star-filled' : star.half ? 'star-half' : 'star'
+              "
+              class="cosy:w-5 cosy:h-5 cosy:text-yellow-400" />
+          </div>
+          <Text variant="small" class="cosy:text-gray-500">
+            {{ stats.totalReviews }} 条评价
+          </Text>
+        </div>
+      </div>
+
+      <!-- 评分分布 -->
+      <div class="cosy:space-y-1">
+        <div
+          v-for="(count, index) in stats.ratingDistribution"
+          :key="index"
+          class="cosy:flex cosy:items-center cosy:gap-2">
+          <Text variant="small" class="cosy:w-8">{{ 5 - index }}星</Text>
+          <div class="cosy:flex-1 cosy:h-2 cosy:bg-gray-200 cosy:rounded-full">
+            <div
+              class="cosy:h-full cosy:bg-yellow-400 cosy:rounded-full"
+              :style="{
+                width:
+                  stats.totalReviews > 0
+                    ? (count / stats.totalReviews) * 100 + '%'
+                    : '0%',
+              }"></div>
+          </div>
+          <Text variant="small" class="cosy:w-8">{{ count }}</Text>
+        </div>
+      </div>
+    </div>
+
+    <!-- 评价列表 -->
+    <Grid v-if="layout === 'grid'" v-bind="gridColumns" class="cosy:gap-6">
+      <Review
+        v-for="(review, index) in displayReviews"
+        :key="index"
+        v-bind="review" />
+    </Grid>
+    <div v-else class="cosy:space-y-6">
+      <Review
+        v-for="(review, index) in displayReviews"
+        :key="index"
+        v-bind="review" />
+    </div>
+  </div>
+</template>

package/dist/src-vue/review/index.ts

@@ -1,3 +1,7 @@
 export { default as Review } from "./Review.vue";
 export { default as Reviews } from "./Reviews.vue";
-export type { ReviewProps, ReviewsProps, ReviewData } from "./types";
+export type {
+	IReviewProps as ReviewProps,
+	IReviewsProps as ReviewsProps,
+	IReviewData as ReviewData,
+} from "./props";

package/dist/src-vue/review/props.ts

@@ -10,16 +10,7 @@ import type { ICardProps } from "../card/props";
  */
 export interface IReviewProps
 	extends IReviewPropsBase,
-		Omit<
-			ICardProps,
-			| keyof IReviewPropsBase
-			| "title"
-			| "subtitle"
-			| "imageUrl"
-			| "href"
-			| "compact"
-			| "shadow"
-		> {
+		Omit<ICardProps, keyof IReviewPropsBase> {
 	/**
 	 * 自定义类名
 	 */

package/dist/src-vue/status-bar/StatusBarItem.vue

@@ -55,9 +55,7 @@ const props = withDefaults(defineProps<Props>(), {
 	active: false,
 });
 
-const emit = defineEmits<{
-	(e: "click", event: MouseEvent): void;
-}>();
+const emit = defineEmits<(e: "click", event: MouseEvent) => void>();
 
 const handleClick = (event: MouseEvent) => {
 	if (props.clickable) {

package/dist/src-vue/utils/link.ts

@@ -24,7 +24,7 @@ export class LinkUtil {
 	 */
 	static normalizeLanguage(lang: string): string {
 		const normalizedLang = lang.toLowerCase().replace("zh-CN", "zh-cn");
-		if (normalizedLang.length == 0) {
+		if (normalizedLang.length === 0) {
 			console.error("lang is empty");
 			return "en";
 		}
@@ -32,7 +32,7 @@ export class LinkUtil {
 	}
 
 	static getHomeLink(lang: string): string {
-		return `${this.getBaseUrl}/${lang}`;
+		return `${LinkUtil.getBaseUrl}/${lang}`;
 	}
 
 	static getLessonsLink(lang: string): string {
@@ -62,10 +62,10 @@ export class LinkUtil {
 
 	static getLessonLink(lang: string, lessonId: string): string {
 		if (lessonId.endsWith(lang)) {
-			return `${this.getBaseUrl()}${lang}/lessons/${lessonId.replace(`${lang}`, "")}`;
+			return `${LinkUtil.getBaseUrl()}${lang}/lessons/${lessonId.replace(`${lang}`, "")}`;
 		} else {
 			const idWithoutLang = lessonId.replace(`${lang}/`, "");
-			return `${this.getBaseUrl()}${lang}/lessons/${idWithoutLang}`;
+			return `${LinkUtil.getBaseUrl()}${lang}/lessons/${idWithoutLang}`;
 		}
 	}
 
@@ -97,43 +97,43 @@ export class LinkUtil {
 	}
 
 	static getMetaLink(lang: string, slug: string): string {
-		return `/${this.normalizeLanguage(lang)}/meta/${slug}`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/meta/${slug}`;
 	}
 
 	static getSigninLink(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/signin`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/signin`;
 	}
 
 	static getAuthCallbackCookieLink(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/auth/callback_cookie`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/auth/callback_cookie`;
 	}
 
 	static getAuthCallbackTokenLink(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/auth/callback_token`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/auth/callback_token`;
 	}
 
 	static getAuthAccountLink(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/auth/account`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/auth/account`;
 	}
 
 	static getDashboardUrl(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/auth/dashboard`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/auth/dashboard`;
 	}
 
 	static getAuthErrorLink(lang: string): string {
-		return `/${this.normalizeLanguage(lang)}/auth/error`;
+		return `/${LinkUtil.normalizeLanguage(lang)}/auth/error`;
 	}
 
 	static getPrivacyLink(lang: string): string {
-		return this.getMetaLink(lang, "privacy");
+		return LinkUtil.getMetaLink(lang, "privacy");
 	}
 
 	static getTermsLink(lang: string): string {
-		return this.getMetaLink(lang, "terms");
+		return LinkUtil.getMetaLink(lang, "terms");
 	}
 
 	static getAboutLink(lang: string): string {
-		return this.getMetaLink(lang, "about");
+		return LinkUtil.getMetaLink(lang, "about");
 	}
 
 	/**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffic/cosy-ui",
-  "version": "0.9.68",
+  "version": "0.9.71",
   "description": "An astro component library",
   "author": {
     "name": "nookery",
@@ -63,35 +63,20 @@
     "shiki": "^3.9.1"
   },
   "devDependencies": {
-    "@astrojs/check": "^0.9.4",
     "@astrojs/mdx": "^4.3.3",
     "@astrojs/ts-plugin": "^1.10.4",
-    "@eslint/js": "^9.32.0",
     "@tailwindcss/typography": "^0.5.16",
     "@tailwindcss/vite": "^4.1.11",
     "@tsconfig/node22": "^22.0.2",
-    "@types/chai": "^5.2.2",
-    "@types/eslint": "^9.6.1",
     "@types/fs-extra": "^11.0.4",
-    "@types/mocha": "^10.0.10",
     "@types/node": "^22.17.0",
-    "@types/react": "^19.1.9",
-    "@typescript-eslint/parser": "^8.38.0",
-    "astro": "^5.12.8",
-    "chai": "^4.5.0",
     "daisyui": "^5.0.50",
-    "eslint": "^9.32.0",
-    "eslint-plugin-astro": "^1.3.1",
     "globals": "^16.3.0",
-    "mocha": "^10.8.2",
-    "prettier": "^3.6.2",
-    "prettier-plugin-astro": "^0.14.1",
     "rollup-plugin-copy": "^3.5.0",
     "sharp": "^0.33.5",
     "tailwindcss": "^4.1.11",
     "tsx": "^4.20.3",
     "typescript": "^5.9.2",
-    "typescript-eslint": "^8.38.0",
-    "vite": "^6.3.5"
+    "vite": "^7.1.10"
   }
 }