@coffic/cosy-ui 0.9.4 → 0.9.5

package/dist/src-astro/database/BlogDB.ts

@@ -1,198 +0,0 @@
-import BlogDoc from '../entities/BlogDoc';
-import type Tag from '../entities/Tag';
-import { cosyLogger } from '../cosy';
-import { type CollectionEntry } from 'astro:content';
-import { BaseDB } from './BaseDB';
-
-export const COLLECTION_BLOG = 'blogs' as const;
-export type BlogEntry = CollectionEntry<typeof COLLECTION_BLOG>;
-
-/**
- * 博客数据库类，用于管理博客内容集合。
- *
- * 目录结构：
- * ```
- * blogs/
- * ├── zh-cn/
- * │   ├── typescript-intro.md      # 文章内容
- * │   ├── images/                  # 文章相关图片
- * │   └── web-performance.md
- * └── en/
- *     └── typescript-intro.md
- *     └── images/
- *     └── web-performance.md
- * ```
- */
-class BlogDB extends BaseDB<typeof COLLECTION_BLOG, BlogEntry, BlogDoc> {
-  protected collectionName = COLLECTION_BLOG;
-
-  protected createDoc(entry: BlogEntry): BlogDoc {
-    return BlogDoc.fromEntry(entry);
-  }
-
-  /**
-   * 获取所有博客
-   *
-   * @returns {Promise<BlogDoc[]>} 返回所有博客
-   */
-  async allBlogs(): Promise<BlogDoc[]> {
-    const debug = false;
-    const entries = await this.getDocsByDepth(2);
-
-    if (debug) {
-      cosyLogger.array('所有博客文档', entries);
-    }
-
-    return entries;
-  }
-
-  /**
-   * 获取指定语言的所有博客
-   *
-   * @param lang - 语言代码
-   * @returns {Promise<BlogDoc[]>} 返回指定语言的所有博客
-   */
-  async allBlogsByLang(lang: string): Promise<BlogDoc[]> {
-    const docs = await this.allBlogs();
-    const filteredEntries = docs.filter((doc) => doc.getId().startsWith(lang));
-
-    return filteredEntries;
-  }
-
-  /**
-   * 获取用于 Astro 静态路由生成的路径参数，专门配合 [lang]/blogs/[slug].astro 使用
-   *
-   * @param debug - 是否开启调试模式
-   * @returns 返回路径参数数组
-   */
-  async getStaticPaths(debug: boolean = false) {
-    const docs = await this.allBlogs();
-
-    const paths = docs.map((doc) => {
-      return {
-        params: {
-          lang: doc.getLang(),
-          slug: doc.getSlug(),
-        },
-      };
-    });
-
-    if (debug) {
-      cosyLogger.array('所有博客文档的路径', paths);
-    }
-
-    return paths;
-  }
-
-  /**
-   * 获取所有博客标签
-   * 标签会根据语言和名称去重，使用复合键 "lang:name" 确保唯一性
-   *
-   * @returns 返回所有标签数组
-   * 返回格式：
-   * [
-   *   { name: 'typescript', lang: 'zh-cn', count: 5 },
-   *   { name: 'javascript', lang: 'en', count: 3 }
-   * ]
-   */
-  async getTags(): Promise<Tag[]> {
-    const tagsMap = new Map<string, Tag>();
-    const posts = await this.allBlogs();
-
-    posts.forEach((post) => {
-      post.getTags().forEach((tag) => {
-        const key = `${tag.lang}:${tag.name}`;
-        if (!tagsMap.has(key)) {
-          tagsMap.set(key, tag);
-        }
-      });
-    });
-
-    return Array.from(tagsMap.values());
-  }
-
-  /**
-   * 获取指定语言的博客标签
-   *
-   * @param lang - 语言代码（如 'zh-cn', 'en'）
-   * @returns 返回指定语言的标签数组
-   */
-  async getTagsByLang(lang: string): Promise<Tag[]> {
-    const debug = false;
-    const tagsMap = new Map<string, Tag>();
-    const posts = await this.allBlogsByLang(lang);
-
-    if (debug) {
-      cosyLogger.array('posts', posts);
-    }
-
-    if (posts.length === 0) {
-      return [];
-    }
-
-    posts.forEach((post) => {
-      post.getTags().forEach((tag) => {
-        const key = `${tag.lang}:${tag.name}`;
-        if (!tagsMap.has(key)) {
-          tagsMap.set(key, tag);
-        }
-      });
-    });
-
-    if (debug) {
-      cosyLogger.array('tags', Array.from(tagsMap.values()));
-    }
-
-    return Array.from(tagsMap.values());
-  }
-
-  /**
-   * 获取指定标签和语言的博客文章
-   *
-   * @param tag - 标签名称
-   * @param lang - 语言代码
-   * @returns 返回匹配的博客文档数组
-   * @example
-   * ```typescript
-   * const posts = await blogDB.getBlogsByTag('typescript', 'zh-cn');
-   * // 返回所有包含 'typescript' 标签的中文博客
-   * ```
-   */
-  async getBlogsByTag(tag: string, lang: string): Promise<BlogDoc[]> {
-    const posts = await this.allBlogsByLang(lang);
-    return posts.filter((post) => post.getTags().some((t) => t.name === tag));
-  }
-
-  /**
-   * 获取标签的静态路径参数，用于生成标签页面的路由，专门配合 [lang]/blogs/tag/[name].astro 使用
-   *
-   * @returns 返回所有标签的路径参数数组
-   * 返回格式：
-   * [
-   *   { params: { lang: 'zh-cn', name: 'typescript' } },
-   *   { params: { lang: 'en', name: 'javascript' } }
-   * ]
-   */
-  async getTagsStaticPaths() {
-    const debug = false;
-    const tags = await this.getTags();
-
-    const paths = tags.map((tag) => {
-      return {
-        params: {
-          lang: tag.lang,
-          name: tag.name,
-        },
-      };
-    });
-
-    if (debug) {
-      cosyLogger.array('所有的标签路径', paths);
-    }
-
-    return paths;
-  }
-}
-
-// 创建并导出单例实例
-export const blogDB = new BlogDB();

package/dist/src-astro/database/CourseDB.ts

@@ -1,90 +0,0 @@
-import CourseDoc from '../entities/CourseDoc';
-import { getCollection, type CollectionEntry } from 'astro:content';
-import { BaseDB } from './BaseDB';
-
-export const COLLECTION_COURSE = 'courses' as const;
-export type CourseEntry = CollectionEntry<typeof COLLECTION_COURSE>;
-
-/**
- * 课程数据库类，用于管理课程内容集合。
- *
- * 目录结构：
- * ```
- * courses/
- * ├── zh-cn/                  # 中文版本
- * │   ├── web-development/    # 课程1
- * │   │   ├── index.md        # 课程文档
- * │   │   ├── chapter1
- * │   │   │   ├── index.md
- * │   │   │   ├── content.md
- * │   │   │   └── ...
- * │   │   └── chapter2
- * │   │       ├── index.md
- * │   │       ├── content.md
- * │   │       └── ...
- * │   └── mobile-dev/        # 课程2
- * │       ├── index.md
- * │       └── ...
- * └── en/                    # 英文版本
- *     └── ...
- * ```
- */
-class CourseDB extends BaseDB<
-  typeof COLLECTION_COURSE,
-  CourseEntry,
-  CourseDoc
-> {
-  protected collectionName = COLLECTION_COURSE;
-
-  protected createDoc(entry: CourseEntry): CourseDoc {
-    return new CourseDoc(entry);
-  }
-
-  /**
-   * 获取指定语言的所有顶级课程
-   *
-   * @param lang - 语言代码
-   * @returns 返回指定语言的顶级课程数组
-   */
-  async allCoursesByLang(lang: string): Promise<CourseDoc[]> {
-    const entries = await getCollection(COLLECTION_COURSE, ({ id }) => {
-      return id.startsWith(lang) && id.split('/').length === 2;
-    });
-    return entries.map((entry) => new CourseDoc(entry));
-  }
-
-  /**
-   * 获取用于 Astro 静态路由生成的路径参数，专门配合 [lang]/courses/[...slug].astro 使用
-   *
-   * @returns 返回路径参数数组
-   */
-  async getStaticPaths(): Promise<
-    { params: { lang: string; slug: string } }[]
-  > {
-    const entries = await getCollection(COLLECTION_COURSE);
-    return entries.map((entry) => {
-      const doc = new CourseDoc(entry);
-      return {
-        params: {
-          lang: doc.getLang(),
-          slug: doc.getSlug(),
-        },
-      };
-    });
-  }
-
-  /**
-   * 获取精选课程
-   * 返回指定语言的前4个顶级课程文档
-   *
-   * @param lang - 语言代码（如 'zh-cn', 'en'）
-   * @returns 返回精选课程文档数组（最多4个）
-   */
-  async getFamousCourses(lang: string): Promise<CourseDoc[]> {
-    const courses = await this.allCoursesByLang(lang);
-    return courses.slice(0, 4);
-  }
-}
-
-// 创建并导出单例实例
-export const courseDB = new CourseDB();

package/dist/src-astro/database/ExperimentDB.ts

@@ -1,106 +0,0 @@
-import { type CollectionEntry } from 'astro:content';
-import { BaseDB } from './BaseDB';
-import ExperimentDoc from '../entities/ExperimentDoc';
-import { cosyLogger } from '../cosy';
-
-export const COLLECTION_EXPERIMENT = 'experiments' as const;
-export type ExperimentEntry = CollectionEntry<typeof COLLECTION_EXPERIMENT>;
-
-/**
- * 实验数据库类，用于管理实验内容集合
- *
- * 目录结构：
- * ```
- * experiments/
- * ├── safari_itp/           # 实验目录
- * │   ├── images/           # 实验图片资源
- * │   ├── components/                  # 课程组件
- * │   ├── en/                          # 英文版本
- * │   │   ├── index.mdx                # 课程首页
- * │   │   ├── 1.mdx                    # 第一章
- * │   │   └── 2.mdx                    # 第二章
- * │   └── zh-cn/                       # 中文版本
- * │       ├── index.mdx                # 课程首页
- * │       ├── 1.mdx                    # 第一章
- * │       └── 2.mdx                    # 第二章
- * └── learn_astro/                     # 另一个课程
- *     ├── en/
- *     │   ├── index.mdx
- *     │   ├── 1.mdx
- *     │   └── 2.mdx
- *     └── zh-cn/
- *         ├── index.mdx
- *         ├── 1.mdx
- *         └── 2.mdx
- * ```
- *
- * 说明：
- * - 每个课程（如 build_your_own_web_toolbox）是一个独立的目录
- * - 课程目录可以包含多语言版本（en, zh-cn 等）
- * - 每个语言版本包含完整的课程内容
- * - 课程目录可以作为 git 子模块独立管理
- */
-class ExperimentDB extends BaseDB<
-  typeof COLLECTION_EXPERIMENT,
-  ExperimentEntry,
-  ExperimentDoc
-> {
-  protected collectionName = COLLECTION_EXPERIMENT;
-
-  protected createDoc(entry: ExperimentEntry): ExperimentDoc {
-    return new ExperimentDoc(entry);
-  }
-
-  /**
-   * 获取指定语言的所有课程
-   *
-   * @param {string} lang - 语言代码
-   * @returns {Promise<ExperimentDoc[]>} 返回指定语言的所有课程
-   */
-  async allExperiments(lang: string): Promise<ExperimentDoc[]> {
-    const docs = await this.getDocsByDepth(2);
-    return docs.filter((doc) => doc.getId().endsWith(lang));
-  }
-
-  /**
-   * 获取用于 Astro 静态路由生成的路径参数
-   *
-   * @param debug - 是否开启调试模式
-   * @returns 返回路径参数数组
-   */
-  async getStaticPaths(debug: boolean = false) {
-    const docs = await this.getEntries();
-
-    if (debug) {
-      cosyLogger.array('所有文档', docs);
-    }
-
-    const paths = docs.map((doc) => {
-      const id = doc.id;
-      const lang = id.split('/')[1];
-
-      let slug = '';
-      if (id.endsWith(lang)) {
-        slug = id.replace(`${lang}`, '');
-      } else {
-        slug = id.replace(`${lang}/`, '');
-      }
-
-      return {
-        params: {
-          lang: lang,
-          slug: slug,
-        },
-      };
-    });
-
-    if (debug) {
-      cosyLogger.array('所有文档的路径', paths);
-    }
-
-    return paths;
-  }
-}
-
-// 创建并导出单例实例
-export const experimentDB = new ExperimentDB();

package/dist/src-astro/database/LessonDB.ts

@@ -1,106 +0,0 @@
-import { type CollectionEntry } from 'astro:content';
-import { BaseDB } from './BaseDB';
-import LessonDoc from '../entities/LessonDoc';
-import { cosyLogger } from '../cosy';
-
-export const COLLECTION_LESSON = 'lessons' as const;
-export type LessonEntry = CollectionEntry<typeof COLLECTION_LESSON>;
-
-/**
- * 课程数据库类，用于管理课程内容集合
- *
- * 目录结构：
- * ```
- * lessons/
- * ├── build_your_own_web_toolbox/      # 课程目录
- * │   ├── images/                      # 课程图片资源
- * │   ├── components/                  # 课程组件
- * │   ├── en/                          # 英文版本
- * │   │   ├── index.mdx                # 课程首页
- * │   │   ├── 1.mdx                    # 第一章
- * │   │   └── 2.mdx                    # 第二章
- * │   └── zh-cn/                       # 中文版本
- * │       ├── index.mdx                # 课程首页
- * │       ├── 1.mdx                    # 第一章
- * │       └── 2.mdx                    # 第二章
- * └── learn_astro/                     # 另一个课程
- *     ├── en/
- *     │   ├── index.mdx
- *     │   ├── 1.mdx
- *     │   └── 2.mdx
- *     └── zh-cn/
- *         ├── index.mdx
- *         ├── 1.mdx
- *         └── 2.mdx
- * ```
- *
- * 说明：
- * - 每个课程（如 build_your_own_web_toolbox）是一个独立的目录
- * - 课程目录可以包含多语言版本（en, zh-cn 等）
- * - 每个语言版本包含完整的课程内容
- * - 课程目录可以作为 git 子模块独立管理
- */
-class LessonDB extends BaseDB<
-  typeof COLLECTION_LESSON,
-  LessonEntry,
-  LessonDoc
-> {
-  protected collectionName = COLLECTION_LESSON;
-
-  protected createDoc(entry: LessonEntry): LessonDoc {
-    return new LessonDoc(entry);
-  }
-
-  /**
-   * 获取指定语言的所有课程
-   *
-   * @param {string} lang - 语言代码
-   * @returns {Promise<LessonDoc[]>} 返回指定语言的所有课程
-   */
-  async allLessons(lang: string): Promise<LessonDoc[]> {
-    const docs = await this.getDocsByDepth(2);
-    return docs.filter((doc) => doc.getId().endsWith(lang));
-  }
-
-  /**
-   * 获取用于 Astro 静态路由生成的路径参数
-   *
-   * @param debug - 是否开启调试模式
-   * @returns 返回路径参数数组
-   */
-  async getStaticPaths(debug: boolean = false) {
-    const docs = await this.getEntries();
-
-    if (debug) {
-      cosyLogger.array('所有文档', docs);
-    }
-
-    const paths = docs.map((doc) => {
-      const id = doc.id;
-      const lang = id.split('/')[1];
-
-      let slug = '';
-      if (id.endsWith(lang)) {
-        slug = id.replace(`${lang}`, '');
-      } else {
-        slug = id.replace(`${lang}/`, '');
-      }
-
-      return {
-        params: {
-          lang: lang,
-          slug: slug,
-        },
-      };
-    });
-
-    if (debug) {
-      cosyLogger.array('所有文档的路径', paths);
-    }
-
-    return paths;
-  }
-}
-
-// 创建并导出单例实例
-export const lessonDB = new LessonDB();

package/dist/src-astro/database/MetaDB.ts

@@ -1,74 +0,0 @@
-import MetaDoc from '../entities/MetaDoc';
-import { cosyLogger } from '../cosy';
-import { type CollectionEntry } from 'astro:content';
-import { BaseDB } from './BaseDB';
-
-export const COLLECTION_META = 'meta' as const;
-export type MetaEntry = CollectionEntry<typeof COLLECTION_META>;
-
-/**
- * 元数据数据库类，用于管理网站的元数据内容集合（如"关于我们"等页面）
- *
- * 目录结构：
- * ```
- * meta/
- * ├── zh-cn/                          # 中文内容
- * │   ├── about.md                    # 关于我们
- * │   ├── advice.md                   # 建议
- * └── en/                             # 英文内容
- *     ├── about.md
- *     ├── privacy.md
- *     └── terms.md
- * ```
- */
-class MetaDB extends BaseDB<typeof COLLECTION_META, MetaEntry, MetaDoc> {
-  protected collectionName = COLLECTION_META;
-
-  protected createDoc(entry: MetaEntry): MetaDoc {
-    return new MetaDoc(entry);
-  }
-
-  /**
-   * 获取指定文档的兄弟文档
-   * 例如：对于 'zh-cn/about'，会返回 'zh-cn' 下的文档
-   *
-   * @param targetId - 目标文档ID
-   * @returns 返回兄弟文档数组（包括目标文档本身）
-   */
-  async getSiblings(targetId: string): Promise<MetaDoc[]> {
-    const target = await this.find(targetId);
-    if (!target) {
-      return [];
-    }
-    const docs = await this.getDocsByDepth(2);
-    return docs.filter((doc) => doc.getLang() === target.getLang());
-  }
-
-  /**
-   * 获取用于 Astro 静态路由生成的路径参数，专门配合 [lang]/meta/[slug].astro 使用
-   *
-   * @param debug - 是否开启调试模式
-   * @returns 返回路径参数数组
-   */
-  async getStaticPaths(debug: boolean = false) {
-    const docs = await this.getDescendantDocs('');
-
-    const paths = docs.map((doc) => {
-      return {
-        params: {
-          lang: doc.getLang(),
-          slug: doc.getSlug(),
-        },
-      };
-    });
-
-    if (debug) {
-      cosyLogger.array('所有元数据文档的路径', paths);
-    }
-
-    return paths;
-  }
-}
-
-// 创建并导出单例实例
-export const metaDB = new MetaDB();

package/dist/src-astro/database/index.ts

@@ -1,3 +0,0 @@
-export * from './LessonDB';
-export * from './CourseDB';
-export * from './MetaDB';