@coffic/cosy-ui 0.6.36 → 0.6.40

package/dist/card/CardCourse.astro

@@ -0,0 +1,32 @@
+---
+import { Image } from 'astro:assets';
+import bookCover from '../assets/book.png';
+
+interface Props {
+	title: string;
+	link: string;
+}
+
+const { title, link } = Astro.props;
+---
+
+<div>
+	<a href={link} class="justify-center flex no-underline text-base-content">
+		<div class="w-56 h-80">
+			<div
+				class="bg-gradient-to-br w-full h-full from-accent/50 to-primary/30 rounded-3xl shadow-lg backdrop-blur-sm">
+				<div
+					class="bg-base-100/60 w-full h-full rounded-3xl border border-base-content/30 hover:scale-105 hover:shadow-2xl transform duration-200 backdrop-filter backdrop-blur-sm">
+					<div class="card-body p-1 h-full">
+						<Image src={bookCover} alt={title} class="h-3/5 w-full" />
+						<div>
+							<h2 class="text-lg text-center font-medium">
+								{title}
+							</h2>
+						</div>
+					</div>
+				</div>
+			</div>
+		</div>
+	</a>
+</div>

package/dist/card/index.ts

@@ -1,6 +1,6 @@
 
-
 export { default as Card } from './Card.astro';
+export { default as CardCourse } from './CardCourse.astro';
 export { default as CardBasic } from './CardBasic.astro';
 export { default as CardWithImage } from './CardWithImage.astro';
 export { default as CardLink } from './CardLink.astro';

package/dist/cosy.ts

@@ -0,0 +1,6 @@
+import { Logger } from './utils/logger';
+
+export const NAME = 'Cosy-UI';
+export const ERROR_PREFIX = 'Cosy-UI: ';
+
+export const cosyLogger = new Logger(NAME);

package/dist/database/BaseDB.ts

@@ -1,5 +1,6 @@
 import { getCollection, getEntry, type CollectionEntry, type DataEntryMap } from 'astro:content';
-import { logger } from '../utils/logger';
+import { cosyLogger, ERROR_PREFIX } from '../cosy';
+import type { BaseDoc } from '..';
 
 /**
  * BaseDB 是所有数据库类的基类，提供了通用的文档操作功能。
@@ -24,172 +25,207 @@ import { logger } from '../utils/logger';
  * @template Doc - 文档类型，通常是自定义的文档类
  */
 export abstract class BaseDB<
-	Collection extends keyof DataEntryMap,
-	Entry extends CollectionEntry<Collection>,
-	Doc,
+    Collection extends keyof DataEntryMap,
+    Entry extends CollectionEntry<Collection>,
+    Doc extends BaseDoc<Collection, Entry>,
 > {
-	/** 集合名称，必须在子类中指定 */
-	protected abstract collectionName: Collection;
-
-	/**
-	 * 创建文档实例的方法，必须在子类中实现
-	 * @param entry - 集合条目
-	 * @returns 文档实例
-	 */
-	protected abstract createDoc(entry: Entry): Doc;
-
-	/**
-	 * 获取所有文档的ID
-	 * @returns 返回所有文档的ID数组
-	 */
-	async getAllIds(): Promise<string[]> {
-		const entries = await getCollection(this.collectionName);
-		return entries.map((entry) => entry.id);
-	}
-
-	/**
-	 * 获取集合中的所有条目
-	 * @returns 返回所有条目的数组
-	 */
-	async getEntries(): Promise<Entry[]> {
-		const entries = await getCollection(this.collectionName);
-		return entries.map((entry) => entry as Entry);
-	}
-
-	/**
-	 * 获取指定深度的文档
-	 * 深度是指文档 ID 中斜杠的数量加1
-	 * 例如：
-	 * - "blog.md" 深度为1
-	 * - "zh-cn/blog.md" 深度为2
-	 * - "zh-cn/tech/blog.md" 深度为3
-	 *
-	 * @param depth - 文档深度
-	 * @returns 返回指定深度的文档数组
-	 */
-	async getDocsByDepth(depth: number): Promise<Doc[]> {
-		const entries = await getCollection(
-			this.collectionName,
-			({ id }) => id.split('/').length === depth
-		);
-		return entries.map((entry) => this.createDoc(entry as Entry));
-	}
-
-	/**
-	 * 根据ID查找单个文档
-	 * @param id - 文档ID
-	 * @returns 返回找到的文档，如果不存在则返回null
-	 */
-	async find(id: string): Promise<Doc | null> {
-		const debug = false;
-		if (debug) {
-			logger.info(`查找文档，ID: ${id}`);
-		}
-
-		if (typeof id !== 'string') {
-			throw new Error('ID must be a string, but got ' + typeof id);
-		}
-
-		// 获取所有文档的ID并排好顺序
-		if (debug) {
-			const allIds = (await this.getAllIds()).sort();
-			logger.array('所有文档的ID', allIds);
-		}
-
-		// 根据ID查找文档
-		const entry = await getEntry(this.collectionName, id);
-		return entry ? this.createDoc(entry as Entry) : null;
-	}
-
-	/**
-	 * 获取指定文档的直接子文档（不包括更深层级的文档）
-	 * 例如对于文档 "zh-cn/blog"：
-	 * - "zh-cn/blog/post1.md" 会被包含
-	 * - "zh-cn/blog/2024/post2.md" 不会被包含
-	 *
-	 * @param parentId - 父文档ID
-	 * @returns 返回子文档数组
-	 */
-	async getChildren(parentId: string): Promise<Doc[]> {
-		const parentLevel = parentId.split('/').length;
-		const childrenLevel = parentLevel + 1;
-
-		const entries = await getCollection(
-			this.collectionName,
-			({ id }) => id.startsWith(parentId) && id.split('/').length === childrenLevel
-		);
-
-		return entries.map((entry) => this.createDoc(entry as Entry));
-	}
-
-	/**
-	 * 获取指定文档的所有后代文档（包括所有层级）
-	 * 例如对于文档 "zh-cn/blog"，以下都会被包含：
-	 * - "zh-cn/blog/post1.md"
-	 * - "zh-cn/blog/2024/post2.md"
-	 * - "zh-cn/blog/2024/tech/post3.md"
-	 *
-	 * @param parentId - 父文档ID
-	 * @returns 返回所有后代文档数组
-	 */
-	async getDescendantDocs(parentId: string): Promise<Doc[]> {
-		const entries = await getCollection(this.collectionName, ({ id }) => id.startsWith(parentId));
-		return entries.map((entry) => this.createDoc(entry as Entry));
-	}
-
-	/**
-	 * 获取指定语言的顶级文档
-	 * 通过检查文档ID是否以指定语言代码开头来筛选
-	 *
-	 * @param lang - 语言代码（如 'zh-cn', 'en'）
-	 * @returns 返回指定语言的顶级文档数组
-	 */
-	async allDocsByLang(lang: string): Promise<Doc[]> {
-		const debug = false;
-		const docs = await this.getDocsByDepth(2);
-
-		if (debug) {
-			logger.array('所有顶级文档', docs);
-		}
-
-		return docs.filter((doc) => {
-			const id = (doc as any).getId();
-			return id && typeof id === 'string' && id.startsWith(lang);
-		});
-	}
-
-	/**
-	 * 获取用于 Astro 静态路由生成的路径参数
-	 * 为每个文档生成包含语言和slug的路径参数
-	 *
-	 * @returns 返回路径参数数组，每个元素包含 lang 和 slug
-	 * @example
-	 * ```typescript
-	 * const paths = await db.getStaticPaths();
-	 * // 返回格式：
-	 * // [
-	 * //   { params: { lang: 'zh-cn', slug: 'post1' } },
-	 * //   { params: { lang: 'en', slug: 'post1' } }
-	 * // ]
-	 * ```
-	 */
-	async getStaticPaths() {
-		const debug = false;
-		const docs = await this.getDescendantDocs('');
-		const paths = docs.map((doc) => {
-			const docWithMethods = doc as any;
-			return {
-				params: {
-					lang: docWithMethods.getLang?.() || '',
-					slug: docWithMethods.getSlug?.() || '',
-				},
-			};
-		});
-
-		if (debug) {
-			logger.array('所有文档的路径', paths);
-		}
-
-		return paths;
-	}
+    /** 集合名称，必须在子类中指定 */
+    protected abstract collectionName: Collection;
+
+    /**
+     * 创建文档实例的方法，必须在子类中实现
+     * @param entry - 集合条目
+     * @returns 文档实例
+     */
+    protected abstract createDoc(entry: Entry): Doc;
+
+    /**
+     * 获取所有文档的ID
+     * @returns 返回所有文档的ID数组
+     */
+    protected async getAllIds(): Promise<string[]> {
+        const entries = await getCollection(this.collectionName);
+        return entries.map(entry => entry.id);
+    }
+
+    /**
+     * 获取集合中的所有条目
+     * @returns 返回所有条目的数组
+     */
+    protected async getEntries(): Promise<Entry[]> {
+        return await getCollection(this.collectionName);
+    }
+
+    /**
+     * 获取指定深度的文档
+     * 深度是指文档 ID 中斜杠的数量加1
+     * 例如：
+     * - "blog.md" 深度为1
+     * - "zh-cn/blog.md" 深度为2
+     * - "zh-cn/tech/blog.md" 深度为3
+     *
+     * @param depth - 文档深度
+     * @returns 返回指定深度的文档数组
+     */
+    protected async getDocsByDepth(depth: number): Promise<Doc[]> {
+        const entries = await getCollection(
+            this.collectionName,
+            ({ id }: { id: string }) => id.split('/').length === depth
+        );
+
+        if (entries.length === 0) {
+            cosyLogger.warn(`[BaseDB] 没有找到深度为${depth}的文档(collection=${this.collectionName as string})`);
+            const allEntries = await getCollection(this.collectionName);
+            cosyLogger.array('[BaseDB] 所有文档', allEntries.map(entry => entry.id));
+            return [];
+        }
+
+        return entries.map(entry => this.createDoc(entry as Entry));
+    }
+
+    /**
+     * 根据ID查找单个文档
+     * @param id - 文档ID
+     * @param debug - 是否启用调试模式, 默认为false
+     * @throws 如果ID不是字符串类型，则抛出错误
+     * @throws 如果文档不存在，则返回null
+     * @throws 如果发生其他错误，则抛出错误
+     * @returns 返回找到的文档，如果不存在则返回null
+     */
+    async find(id: string, debug: boolean = false): Promise<Doc | null> {
+        if (debug) {
+            cosyLogger.info(`查找文档，ID: ${id}`);
+        }
+
+        if (id == undefined) {
+            cosyLogger.error('ID is undefined');
+            throw new Error(ERROR_PREFIX + 'ID is undefined');
+        }
+
+        if (typeof id !== 'string') {
+            cosyLogger.error('ID must be a string, but got ' + typeof id);
+            cosyLogger.debug(id);
+            throw new Error(ERROR_PREFIX + 'ID must be a string, but got ' + typeof id);
+        }
+
+        // 获取所有文档的ID并排好顺序
+        if (debug) {
+            const allIds = (await this.getAllIds()).sort();
+            cosyLogger.array('所有文档的ID', allIds);
+        }
+
+        // 根据ID查找文档
+        const entry = await getEntry(this.collectionName, id);
+        return entry ? this.createDoc(entry as Entry) : null;
+    }
+
+    /**
+     * 获取指定文档的直接子文档（不包括更深层级的文档）
+     * 例如对于文档 "zh-cn/blog"：
+     * - "zh-cn/blog/post1.md" 会被包含
+     * - "zh-cn/blog/2024/post2.md" 不会被包含
+     *
+     * @param parentId - 父文档ID
+     * @returns 返回子文档数组
+     */
+    async getChildren(parentId: string): Promise<Doc[]> {
+        const parentLevel = parentId.split('/').length;
+        const childrenLevel = parentLevel + 1;
+
+        const entries = await getCollection(
+            this.collectionName,
+            ({ id }: { id: string }) => id.startsWith(parentId) && id.split('/').length === childrenLevel
+        );
+
+        return entries.map(entry => this.createDoc(entry as Entry));
+    }
+
+    /**
+     * 获取指定文档的所有后代文档（包括所有层级）
+     * 例如对于文档 "zh-cn/blog"，以下都会被包含：
+     * - "zh-cn/blog/post1.md"
+     * - "zh-cn/blog/2024/post2.md"
+     * - "zh-cn/blog/2024/tech/post3.md"
+     *
+     * @param parentId - 父文档ID
+     * @returns 返回所有后代文档数组
+     */
+    async getDescendantDocs(parentId: string): Promise<Doc[]> {
+        const entries = await getCollection(this.collectionName, ({ id }: { id: string }) => id.startsWith(parentId));
+        return entries.map(entry => this.createDoc(entry as Entry));
+    }
+
+    /**
+     * 获取指定语言和级别的文档
+     * 通过检查文档ID是否以指定语言代码开头来筛选
+     *
+     * @param lang - 语言代码（如 'zh-cn', 'en'）
+     * @param level - 文档级别
+     * @returns 返回指定语言和级别的文档数组
+     */
+    protected async allDocsByLangAndLevel(lang: string, level: number = 1, debug: boolean = false): Promise<Doc[]> {
+        const collectionName = this.collectionName as string;
+        const docs = await this.getDocsByDepth(level);
+
+        if (debug) {
+            cosyLogger.array(`[BaseDB] 所有${level}级文档(lang=any,collection=${collectionName})`, docs);
+        }
+
+        if (docs.length === 0) {
+            cosyLogger.warn(`[BaseDB] 没有找到${level}级文档(lang=any,collection=${collectionName})`);
+            return [];
+        }
+
+        const filteredDocs = docs.filter((doc) => {
+            const id = (doc as any).getId();
+            return id && typeof id === 'string' && id.startsWith(lang);
+        });
+
+        if (debug) {
+            cosyLogger.array(`[BaseDB] 所有${level}级文档(lang=${lang},collection=${collectionName})`, filteredDocs);
+        }
+
+        if (filteredDocs.length === 0) {
+            cosyLogger.warn(`[BaseDB] 没有找到${level}级文档(lang=${lang},collection=${collectionName})`);
+            cosyLogger.array(`[BaseDB] 所有${level}级文档`, docs.map((doc) => doc.getId()));
+            return [];
+        }
+
+        return filteredDocs;
+    }
+
+    /**
+     * 获取用于 Astro 静态路由生成的路径参数
+     * 为每个文档生成包含语言和slug的路径参数
+     *
+     * @returns 返回路径参数数组，每个元素包含 lang 和 slug
+     * @example
+     * ```typescript
+     * const paths = await db.getStaticPaths();
+     * // 返回格式：
+     * // [
+     * //   { params: { lang: 'zh-cn', slug: 'post1' } },
+     * //   { params: { lang: 'en', slug: 'post1' } }
+     * // ]
+     * ```
+     */
+    async getStaticPaths() {
+        const debug = false;
+        const docs = await this.getDescendantDocs('');
+        const paths = docs.map((doc) => {
+            const docWithMethods = doc as any;
+            return {
+                params: {
+                    lang: docWithMethods.getLang?.() || '',
+                    slug: docWithMethods.getSlug?.() || '',
+                },
+            };
+        });
+
+        if (debug) {
+            cosyLogger.array('所有文档的路径', paths);
+        }
+
+        return paths;
+    }
 }

package/dist/database/BlogDB.ts

@@ -1,6 +1,6 @@
 import BlogDoc from '../entities/BlogDoc';
 import type Tag from '../entities/Tag';
-import { logger } from '../utils/logger';
+import { cosyLogger } from '../cosy';
 import { type CollectionEntry } from 'astro:content';
 import { BaseDB } from './BaseDB';
 
@@ -40,7 +40,7 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 		const entries = await this.getDocsByDepth(2);
 
 		if (debug) {
-			logger.array('所有博客文档', entries);
+			cosyLogger.array('所有博客文档', entries);
 		}
 
 		return entries;
@@ -62,10 +62,10 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 	/**
 	 * 获取用于 Astro 静态路由生成的路径参数，专门配合 [lang]/blogs/[slug].astro 使用
 	 *
+	 * @param debug - 是否开启调试模式
 	 * @returns 返回路径参数数组
 	 */
-	async getStaticPaths() {
-		const debug = false;
+	async getStaticPaths(debug: boolean = false) {
 		const docs = await this.allBlogs();
 
 		const paths = docs.map((doc) => {
@@ -78,7 +78,7 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 		});
 
 		if (debug) {
-			logger.array('所有博客文档的路径', paths);
+			cosyLogger.array('所有博客文档的路径', paths);
 		}
 
 		return paths;
@@ -123,7 +123,7 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 		const posts = await this.allBlogsByLang(lang);
 
 		if (debug) {
-			logger.array('posts', posts);
+			cosyLogger.array('posts', posts);
 		}
 
 		if (posts.length === 0) {
@@ -140,7 +140,7 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 		});
 
 		if (debug) {
-			logger.array('tags', Array.from(tagsMap.values()));
+			cosyLogger.array('tags', Array.from(tagsMap.values()));
 		}
 
 		return Array.from(tagsMap.values());
@@ -187,7 +187,7 @@ class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
 		});
 
 		if (debug) {
-			logger.array('所有的标签路径', paths);
+			cosyLogger.array('所有的标签路径', paths);
 		}
 
 		return paths;

package/dist/database/CourseDB.ts

@@ -11,9 +11,9 @@ export type CourseEntry = CollectionEntry<typeof COLLECTION_COURSE>;
  * 目录结构：
  * ```
  * courses/
- * ├── zh-cn/
- * │   ├── web-development/
- * │   │   ├── index.md
+ * ├── zh-cn/                  # 中文版本
+ * │   ├── web-development/    # 课程1
+ * │   │   ├── index.md        # 课程文档
  * │   │   ├── chapter1
  * │   │   │   ├── index.md
  * │   │   │   ├── content.md
@@ -22,10 +22,10 @@ export type CourseEntry = CollectionEntry<typeof COLLECTION_COURSE>;
  * │   │       ├── index.md
  * │   │       ├── content.md
  * │   │       └── ...
- * │   └── mobile-dev/
+ * │   └── mobile-dev/        # 课程2
  * │       ├── index.md
  * │       └── ...
- * └── en/
+ * └── en/                    # 英文版本
  *     └── ...
  * ```
  */

package/dist/database/ExperimentDB.ts

@@ -1,7 +1,7 @@
 import { type CollectionEntry } from 'astro:content';
 import { BaseDB } from './BaseDB';
 import ExperimentDoc from '../entities/ExperimentDoc';
-import { logger } from '../utils/logger';
+import { cosyLogger } from '../cosy';
 
 export const COLLECTION_EXPERIMENT = 'experiments' as const;
 export type ExperimentEntry = CollectionEntry<typeof COLLECTION_EXPERIMENT>;
@@ -13,7 +13,7 @@ export type ExperimentEntry = CollectionEntry<typeof COLLECTION_EXPERIMENT>;
  * ```
  * experiments/
  * ├── safari_itp/           # 实验目录
- * │   ├── images/          # 实验图片资源
+ * │   ├── images/           # 实验图片资源
  * │   ├── components/                  # 课程组件
  * │   ├── en/                          # 英文版本
  * │   │   ├── index.mdx                # 课程首页
@@ -61,14 +61,14 @@ class ExperimentDB extends BaseDB<typeof COLLECTION_EXPERIMENT, ExperimentEntry,
 	/**
 	 * 获取用于 Astro 静态路由生成的路径参数
 	 *
+	 * @param debug - 是否开启调试模式
 	 * @returns 返回路径参数数组
 	 */
-	async getStaticPaths() {
-		const debug = false;
+	async getStaticPaths(debug: boolean = false) {
 		const docs = await this.getEntries();
 
 		if (debug) {
-			logger.array('所有文档', docs);
+			cosyLogger.array('所有文档', docs);
 		}
 
 		const paths = docs.map((doc) => {
@@ -91,7 +91,7 @@ class ExperimentDB extends BaseDB<typeof COLLECTION_EXPERIMENT, ExperimentEntry,
 		});
 
 		if (debug) {
-			logger.array('所有文档的路径', paths);
+			cosyLogger.array('所有文档的路径', paths);
 		}
 
 		return paths;

package/dist/database/LessonDB.ts

@@ -1,7 +1,7 @@
 import { type CollectionEntry } from 'astro:content';
 import { BaseDB } from './BaseDB';
 import LessonDoc from '../entities/LessonDoc';
-import { logger } from '../utils/logger';
+import { cosyLogger } from '../cosy';
 
 export const COLLECTION_LESSON = 'lessons' as const;
 export type LessonEntry = CollectionEntry<typeof COLLECTION_LESSON>;
@@ -60,15 +60,15 @@ class LessonDB extends BaseDB<typeof COLLECTION_LESSON, LessonEntry, LessonDoc>
 
 	/**
 	 * 获取用于 Astro 静态路由生成的路径参数
-	 *
+	 * 
+	 * @param debug - 是否开启调试模式
 	 * @returns 返回路径参数数组
 	 */
-	async getStaticPaths() {
-		const debug = false;
+	async getStaticPaths(debug: boolean = false) {
 		const docs = await this.getEntries();
 
 		if (debug) {
-			logger.array('所有文档', docs);
+			cosyLogger.array('所有文档', docs);
 		}
 
 		const paths = docs.map((doc) => {
@@ -91,7 +91,7 @@ class LessonDB extends BaseDB<typeof COLLECTION_LESSON, LessonEntry, LessonDoc>
 		});
 
 		if (debug) {
-			logger.array('所有文档的路径', paths);
+			cosyLogger.array('所有文档的路径', paths);
 		}
 
 		return paths;

package/dist/database/MetaDB.ts

@@ -1,5 +1,5 @@
 import MetaDoc from '../entities/MetaDoc';
-import { logger } from '../utils/logger';
+import { cosyLogger } from '../cosy';
 import { type CollectionEntry } from 'astro:content';
 import { BaseDB } from './BaseDB';
 
@@ -47,10 +47,10 @@ class MetaDB extends BaseDB<typeof COLLECTION_META, MetaEntry, MetaDoc> {
 	/**
 	 * 获取用于 Astro 静态路由生成的路径参数，专门配合 [lang]/meta/[slug].astro 使用
 	 *
+	 * @param debug - 是否开启调试模式
 	 * @returns 返回路径参数数组
 	 */
-	async getStaticPaths() {
-		const debug = false;
+	async getStaticPaths(debug: boolean = false) {
 		const docs = await this.getDescendantDocs('');
 
 		const paths = docs.map((doc) => {
@@ -63,7 +63,7 @@ class MetaDB extends BaseDB<typeof COLLECTION_META, MetaEntry, MetaDoc> {
 		});
 
 		if (debug) {
-			logger.array('所有元数据文档的路径', paths);
+			cosyLogger.array('所有元数据文档的路径', paths);
 		}
 
 		return paths;