@coffic/cosy-ui 0.9.3 → 0.9.5

package/dist/src-astro/collection/repos/ExperimentRepo.ts

@@ -0,0 +1,121 @@
+import { defineCollection, z, type CollectionEntry } from 'astro:content';
+import { BaseDB } from './BaseRepo';
+import ExperimentDoc from '../entities/ExperimentDoc';
+import { cosyLogger } from '../../cosy';
+import { glob } from 'astro/loaders';
+
+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 ExperimentRepo 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;
+    }
+
+    makeExperimentCollection = (base: string) => {
+        return defineCollection({
+            loader: glob({
+                pattern: '**/*.{md,mdx}',
+                base,
+            }),
+            schema: z.object({
+                title: z.string().optional(),
+                description: z.string().optional(),
+                pubDate: z.date().optional(),
+            }),
+        });
+    };
+}
+
+// 创建并导出单例实例
+export const experimentRepo = new ExperimentRepo();

package/dist/src-astro/collection/repos/LessonRepo.ts

@@ -0,0 +1,128 @@
+import { defineCollection, z, type CollectionEntry } from 'astro:content';
+import { BaseDB } from './BaseRepo';
+import LessonDoc from '../entities/LessonDoc';
+import { cosyLogger } from '../../cosy';
+import { glob } from 'astro/loaders';
+
+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 LessonRepo 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;
+    }
+
+    makeLessonCollection = (base: string) => {
+        return defineCollection({
+            loader: glob({
+                pattern: '**/*.{md,mdx}',
+                base,
+            }),
+            schema: z.object({
+                title: z.string().optional(),
+                description: z.string().optional(),
+                authors: z
+                    .array(
+                        z.object({
+                            name: z.string(),
+                            picture: z.string().optional(),
+                        })
+                    )
+                    .optional(),
+            }),
+        });
+    };
+}
+
+// 创建并导出单例实例
+export const lessonRepo = new LessonRepo();

package/dist/src-astro/collection/repos/MetaRepo.ts

@@ -0,0 +1,89 @@
+import MetaDoc from '../entities/MetaDoc';
+import { cosyLogger } from '../../cosy';
+import { defineCollection, z, type CollectionEntry } from 'astro:content';
+import { BaseDB } from './BaseRepo';
+import { glob } from 'astro/loaders';
+
+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 MetaRepo 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;
+    }
+
+    makeMetaCollection = (base: string) => {
+        return defineCollection({
+            loader: glob({
+                pattern: '**/*.{md,mdx}',
+                base,
+            }),
+            schema: z.object({
+                title: z.string().optional(),
+                description: z.string().optional(),
+            }),
+        });
+    };
+
+}
+
+// 创建并导出单例实例
+export const metaRepo = new MetaRepo();

package/dist/src-astro/empty-state/EmptyState.astro

@@ -0,0 +1,100 @@
+---
+/**
+ * @component EmptyState
+ * @description 一个用于表示空状态的组件，通常在列表、搜索结果或任何需要数据的区域为空时使用。
+ *
+ * @usage
+ * ```astro
+ * <EmptyState
+ *   icon="users"
+ *   title="没有找到用户"
+ *   description="尝试更改筛选条件或创建一个新用户。"
+ * >
+ *   <Button>创建用户</Button>
+ * </EmptyState>
+ * ```
+ *
+ * @props
+ * - icon?: string - 在标题上方显示的图标名称。
+ * - title: string - 主标题，用于描述空状态。
+ * - description?: string - 对空状态的详细描述。
+ *
+ * @slots
+ * - default - 用于放置操作按钮，如"创建"或"返回"。
+ */
+import '../../style.ts';
+import * as Icons from '../icons';
+import type { EmptyStateProps, IconName } from './types';
+
+const { title, description, icon, ...rest } = Astro.props;
+
+const iconMap: Record<IconName, any> = {
+  SocialIcon: Icons.SocialIcon,
+  TwitterIcon: Icons.TwitterIcon,
+  UserIcon: Icons.UserIcon,
+  WarningIcon: Icons.WarningIcon,
+  XCircle: Icons.XCircle,
+  InfoIcon: Icons.InfoIcon,
+  LinkIcon: Icons.LinkIcon,
+  LinkedinIcon: Icons.LinkedinIcon,
+  MenuIcon: Icons.MenuIcon,
+  RefreshIcon: Icons.RefreshIcon,
+  SearchIcon: Icons.SearchIcon,
+  SuccessIcon: Icons.SuccessIcon,
+  SunCloudyIcon: Icons.SunCloudyIcon,
+  AlertTriangle: Icons.AlertTriangle,
+  CalendarIcon: Icons.CalendarIcon,
+  CheckCircle: Icons.CheckCircle,
+  CheckIcon: Icons.CheckIcon,
+  ClipboardIcon: Icons.ClipboardIcon,
+  CloseIcon: Icons.CloseIcon,
+  CodeIcon: Icons.CodeIcon,
+  DeleteIcon: Icons.DeleteIcon,
+  ErrorIcon: Icons.ErrorIcon,
+  GithubIcon: Icons.GithubIcon,
+  InfoCircle: Icons.InfoCircle,
+  InboxArchive: Icons.InboxArchive,
+  SettingsIcon: Icons.SettingsIcon,
+  ChevronDownIcon: Icons.ChevronDownIcon,
+  HomeIcon: Icons.HomeIcon,
+  DashboardIcon: Icons.DashboardIcon,
+  ChartIcon: Icons.ChartIcon,
+  DocumentIcon: Icons.DocumentIcon,
+  NotificationIcon: Icons.NotificationIcon,
+  UsersIcon: Icons.UsersIcon,
+  MessageIcon: Icons.MessageIcon,
+  MailIcon: Icons.MailIcon,
+  FolderIcon: Icons.FolderIcon,
+  StarIcon: Icons.StarIcon,
+  HeartIcon: Icons.HeartIcon,
+  SaveIcon: Icons.SaveIcon,
+  EditIcon: Icons.EditIcon,
+  ToolsIcon: Icons.ToolsIcon,
+  WalletIcon: Icons.WalletIcon,
+  ReportIcon: Icons.ReportIcon,
+  SecurityIcon: Icons.SecurityIcon,
+  UploadIcon: Icons.UploadIcon,
+  DownloadIcon: Icons.DownloadIcon,
+  LogOut: Icons.LogOut,
+  AppStoreIcon: Icons.AppStoreIcon,
+  WebsiteIcon: Icons.WebsiteIcon,
+};
+
+const IconComponent =
+  icon && iconMap[icon as IconName] ? iconMap[icon as IconName] : null;
+---
+
+<div class="cosy:text-center cosy:py-16 cosy:px-6" {...rest}>
+  {IconComponent && <IconComponent class="cosy:mx-auto cosy:h-12 cosy:w-12" />}
+  {title && <h3 class="cosy:mt-2 cosy:text-2xl cosy:font-bold">{title}</h3>}
+  {
+    description && (
+      <p class="cosy:mt-1 cosy:text-sm cosy:text-base-content/80">
+        {description}
+      </p>
+    )
+  }
+  <div class="cosy:mt-6 cosy:flex cosy:justify-center cosy:gap-4">
+    <slot />
+  </div>
+</div>

package/dist/src-astro/empty-state/index.ts

@@ -0,0 +1,2 @@
+export { default as EmptyState } from './EmptyState.astro';
+export type { EmptyStateProps, IconName } from './types'; 

package/dist/src-astro/empty-state/types.ts

@@ -0,0 +1,70 @@
+import type { HTMLAttributes } from 'astro/types';
+
+export const iconNames = [
+    'SocialIcon',
+    'TwitterIcon',
+    'UserIcon',
+    'WarningIcon',
+    'XCircle',
+    'InfoIcon',
+    'LinkIcon',
+    'LinkedinIcon',
+    'MenuIcon',
+    'RefreshIcon',
+    'SearchIcon',
+    'SuccessIcon',
+    'SunCloudyIcon',
+    'AlertTriangle',
+    'CalendarIcon',
+    'CheckCircle',
+    'CheckIcon',
+    'ClipboardIcon',
+    'CloseIcon',
+    'CodeIcon',
+    'DeleteIcon',
+    'ErrorIcon',
+    'GithubIcon',
+    'InfoCircle',
+    'InboxArchive',
+    'SettingsIcon',
+    'ChevronDownIcon',
+    'HomeIcon',
+    'DashboardIcon',
+    'ChartIcon',
+    'DocumentIcon',
+    'NotificationIcon',
+    'UsersIcon',
+    'MessageIcon',
+    'MailIcon',
+    'FolderIcon',
+    'StarIcon',
+    'HeartIcon',
+    'SaveIcon',
+    'EditIcon',
+    'ToolsIcon',
+    'WalletIcon',
+    'ReportIcon',
+    'SecurityIcon',
+    'UploadIcon',
+    'DownloadIcon',
+    'LogOut',
+    'AppStoreIcon',
+    'WebsiteIcon',
+] as const;
+
+export type IconName = (typeof iconNames)[number];
+
+export interface EmptyStateProps extends HTMLAttributes<'div'> {
+    /**
+     * The title of the empty state.
+     */
+    title?: string;
+    /**
+     * The description of the empty state.
+     */
+    description?: string;
+    /**
+     * The name of the icon to display.
+     */
+    icon?: IconName;
+}

package/dist/src-astro/layout-dashboard/DashboardLayout.astro

@@ -307,7 +307,7 @@ const mainPaddingMap = {
     </div>
 
     <!-- 主内容区 -->
-    <div class="cosy:drawer-content cosy:flex cosy:flex-col">
+    <div class="cosy:drawer-content cosy:flex cosy:flex-col cosy:h-screen">
       <!-- 顶部导航栏 -->
       <DashboardTopNavbar
         title={title}
@@ -320,6 +320,7 @@ const mainPaddingMap = {
       <main
         class:list={[
           'cosy:flex-1',
+          'cosy:overflow-y-auto',
           mainPaddingMap[mainPadding],
           'cosy:bg-base-100',
         ]}>

package/dist/src-astro/layout-dashboard/DashboardTopNavbar.astro

@@ -73,7 +73,8 @@ const defaultUserMenuItems: UserMenuItem[] = [
 const menuItems = userMenuItems || defaultUserMenuItems;
 ---
 
-<div class="cosy:navbar cosy:bg-base-100 cosy:shadow-sm">
+<div
+  class="cosy:navbar cosy:bg-base-100 cosy:shadow-2xl cosy:border-b cosy:border-base-300">
   <div class="cosy:navbar-start">
     <label
       for="dashboard-drawer"
@@ -88,31 +89,6 @@ const menuItems = userMenuItems || defaultUserMenuItems;
   </div>
 
   <div class="cosy:navbar-end cosy:gap-2">
-    <!-- 搜索框 -->
-    <div class="cosy:form-control cosy:hidden cosy:lg:flex">
-      <div class="cosy:input-group">
-        <input
-          type="text"
-          placeholder="搜索..."
-          class="cosy:input cosy:input-bordered cosy:input-sm cosy:w-48"
-        />
-        <button class="cosy:btn cosy:btn-square cosy:btn-sm">
-          <AstroIcon name="search" size="16px" stroke="currentColor" />
-        </button>
-      </div>
-    </div>
-
-    <!-- 通知 -->
-    <div class="cosy:indicator">
-      <button class="cosy:btn cosy:btn-ghost cosy:btn-circle">
-        <AstroIcon name="notification" size="18px" stroke="currentColor" />
-      </button>
-      <span
-        class="cosy:badge cosy:badge-xs cosy:badge-primary cosy:indicator-item"
-        >3</span
-      >
-    </div>
-
     <!-- 用户信息 -->
     {
       userName && (

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coffic/cosy-ui",
-  "version": "0.9.3",
+  "version": "0.9.5",
   "description": "An astro component library",
   "author": {
     "name": "nookery",