@coffic/cosy-ui 0.8.28 → 0.8.29

package/dist/index-astro.ts

@@ -38,7 +38,6 @@ export * from './src-astro/products';
 export * from './src-astro/register';
 export * from './src-astro/section';
 export * from './src-astro/sidebar';
-export * from './src-astro/sidebar-nav';
 export * from './src-astro/speak';
 export * from './src-astro/stack';
 export * from './src-astro/team-member';

package/dist/index-collection.ts

@@ -2,103 +2,104 @@ import { defineCollection, z } from 'astro:content';
 import { glob } from 'astro/loaders';
 
 export const makeArticleCollection = (base: string) => {
-  return defineCollection({
-    loader: glob({
-      pattern: '**/*.{md,mdx}',
-      base,
-    }),
-    schema: z.object({
-      title: z.string().optional(),
-      folder: z.boolean().optional(),
-      order: z.number().optional(),
-      description: z.string().optional(),
-    }),
-  });
+    return defineCollection({
+        loader: glob({
+            pattern: '**/*.{md,mdx}',
+            base,
+        }),
+        schema: z.object({
+            title: z.string().optional(),
+            folder: z.boolean().optional(),
+            order: z.number().optional(),
+            description: z.string().optional(),
+        }),
+    });
 };
 
 export const makeBlogCollection = (base: string) => {
-  return defineCollection({
-    loader: glob({
-      pattern: '**/*.{md,mdx}',
-      base,
-    }),
-    schema: z.object({
-      title: z.string(),
-      description: z.string().optional(),
-      tags: z.array(z.string()).optional(),
-      date: z.date().optional(),
-      authors: z
-        .array(
-          z.object({
-            name: z.string(),
-            picture: z.string().optional(),
-            url: z.string().optional(),
-          })
-        )
-        .optional(),
-    }),
-  });
+    return defineCollection({
+        loader: glob({
+            pattern: '**/*.{md,mdx}',
+            base,
+        }),
+        schema: z.object({
+            title: z.string(),
+            description: z.string().optional(),
+            tags: z.array(z.string()).optional(),
+            date: z.date().optional(),
+            authors: z
+                .array(
+                    z.object({
+                        name: z.string(),
+                        picture: z.string().optional(),
+                        url: z.string().optional(),
+                    })
+                )
+                .optional(),
+        }),
+    });
 };
 
 export const makeCourseCollection = (base: string) => {
-  return defineCollection({
-    loader: glob({
-      pattern: '**/*.{md,mdx}',
-      base,
-    }),
-    schema: z.object({
-      title: z.string().optional(),
-      description: z.string().optional(),
-      folder: z.boolean().optional(),
-      order: z.number().optional(),
-    }),
-  });
+    return defineCollection({
+        loader: glob({
+            pattern: '**/*.{md,mdx}',
+            base,
+        }),
+        schema: z.object({
+            title: z.string().optional(),
+            description: z.string().optional(),
+            folder: z.boolean().optional(),
+            order: z.number().optional(),
+            badge: z.string().optional(),
+        }),
+    });
 };
 
 export const 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(),
-    }),
-  });
+    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 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(),
-    }),
-  });
+    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 makeMetaCollection = (base: string) => {
-  return defineCollection({
-    loader: glob({
-      pattern: '**/*.{md,mdx}',
-      base,
-    }),
-    schema: z.object({
-      title: z.string().optional(),
-      description: z.string().optional(),
-    }),
-  });
+    return defineCollection({
+        loader: glob({
+            pattern: '**/*.{md,mdx}',
+            base,
+        }),
+        schema: z.object({
+            title: z.string().optional(),
+            description: z.string().optional(),
+        }),
+    });
 };

package/dist/src-astro/entities/CourseDoc.ts

@@ -7,95 +7,96 @@ import { COLLECTION_COURSE } from '../database/CourseDB';
 import { BaseDoc } from './BaseDoc';
 
 export default class CourseDoc extends BaseDoc<
-  typeof COLLECTION_COURSE,
-  CourseEntry
+    typeof COLLECTION_COURSE,
+    CourseEntry
 > {
-  constructor(entry: CourseEntry) {
-    super(entry);
-  }
+    constructor(entry: CourseEntry) {
+        super(entry);
+    }
 
-  static fromEntry(entry: CourseEntry) {
-    return new CourseDoc(entry);
-  }
+    static fromEntry(entry: CourseEntry) {
+        return new CourseDoc(entry);
+    }
 
-  getLink(): string {
-    return LinkUtil.getCourseLink(this.entry.id);
-  }
+    getLink(): string {
+        return LinkUtil.getCourseLink(this.entry.id);
+    }
 
-  getOrder(): number {
-    return this.entry.data.order ?? 0;
-  }
+    getOrder(): number {
+        return this.entry.data.order ?? 0;
+    }
 
-  isFolder(): boolean {
-    return this.entry.data.folder ?? false;
-  }
+    isFolder(): boolean {
+        return this.entry.data.folder ?? false;
+    }
 
-  async getTopDoc(): Promise<CourseDoc | null> {
-    const id = this.getTopDocId();
-    const doc = await courseDB.find(id);
-    return doc;
-  }
+    async getTopDoc(): Promise<CourseDoc | null> {
+        const id = this.getTopDocId();
+        const doc = await courseDB.find(id);
+        return doc;
+    }
 
-  async getAncestor(level: number): Promise<CourseDoc | null> {
-    const debug = false;
-    if (debug) {
-      cosyLogger.info(`获取 ${this.entry.id} 的祖先文档，level: ${level}`);
+    async getAncestor(level: number): Promise<CourseDoc | null> {
+        const debug = false;
+        if (debug) {
+            cosyLogger.info(`获取 ${this.entry.id} 的祖先文档，level: ${level}`);
+        }
+
+        if (level >= this.getLevel()) {
+            if (debug) {
+                cosyLogger.info(`祖先文档为自身`);
+            }
+            return this;
+        }
+
+        const id = this.getAncestorId(level);
+        const doc = await courseDB.find(id);
+        return doc;
     }
 
-    if (level >= this.getLevel()) {
-      if (debug) {
-        cosyLogger.info(`祖先文档为自身`);
-      }
-      return this;
+    /**
+     * 获取子文档
+     * @returns 子文档列表
+     */
+    async getChildren(): Promise<CourseDoc[]> {
+        const debug = false;
+        const children = (await courseDB.getChildren(this.entry.id)).sort(
+            (a, b) => a.getOrder() - b.getOrder()
+        );
+        if (debug && children.length > 0) {
+            cosyLogger.array(
+                `${this.entry.id} 的子文档(${children.length})`,
+                children.map((child) => `#${child.getOrder()} ${child.entry.id}`)
+            );
+        }
+        return children;
     }
 
-    const id = this.getAncestorId(level);
-    const doc = await courseDB.find(id);
-    return doc;
-  }
+    override async toSidebarItem(): Promise<SidebarItemEntity> {
+        const debug = false;
+        const children = await this.getChildren();
+        let childItems = await Promise.all(
+            children.map((child) => child.toSidebarItem())
+        );
 
-  /**
-   * 获取子文档
-   * @returns 子文档列表
-   */
-  async getChildren(): Promise<CourseDoc[]> {
-    const debug = false;
-    const children = (await courseDB.getChildren(this.entry.id)).sort(
-      (a, b) => a.getOrder() - b.getOrder()
-    );
-    if (debug && children.length > 0) {
-      cosyLogger.array(
-        `${this.entry.id} 的子文档(${children.length})`,
-        children.map((child) => `#${child.getOrder()} ${child.entry.id}`)
-      );
-    }
-    return children;
-  }
+        if (this.isBook()) {
+            childItems = [...childItems];
+        }
 
-  override async toSidebarItem(): Promise<SidebarItemEntity> {
-    const debug = false;
-    const children = await this.getChildren();
-    let childItems = await Promise.all(
-      children.map((child) => child.toSidebarItem())
-    );
+        if (debug) {
+            cosyLogger.info(`${this.entry.id} 的侧边栏项目`);
+            console.log(childItems);
+        }
 
-    if (this.isBook()) {
-      childItems = [...childItems];
+        return new SidebarItemEntity({
+            text: this.getTitle(),
+            items: childItems,
+            link: this.getLink(),
+            badge: this.entry.data.badge,
+        });
     }
 
-    if (debug) {
-      cosyLogger.info(`${this.entry.id} 的侧边栏项目`);
-      console.log(childItems);
+    isBook(): boolean {
+        return this.entry.id.split('/').length === 2;
     }
-
-    return new SidebarItemEntity({
-      text: this.getTitle(),
-      items: childItems,
-      link: this.getLink(),
-    });
-  }
-
-  isBook(): boolean {
-    return this.entry.id.split('/').length === 2;
-  }
 }

package/dist/src-astro/entities/SidebarItem.ts

@@ -5,71 +5,73 @@ import { type ISidebarItem } from '../types/sidebar';
  * 用于构建网站的侧边栏导航
  */
 export class SidebarItemEntity implements ISidebarItem {
-  text: string;
-  href: string;
-  items: ISidebarItem[];
+    text: string;
+    href: string;
+    items: ISidebarItem[];
+    badge?: string | number;
 
-  constructor(props: { text: string; link?: string; items?: ISidebarItem[] }) {
-    this.text = props.text;
-    this.href = props.link || '';
-    this.items = props.items || [];
-  }
+    constructor(props: { text: string; link?: string; items?: ISidebarItem[]; badge?: string | number }) {
+        this.text = props.text;
+        this.href = props.link || '';
+        this.items = props.items || [];
+        this.badge = props.badge;
+    }
 
-  /**
-   * 添加子项目
-   * @param item 要添加的子项目
-   */
-  addItem(item: SidebarItemEntity): void {
-    this.items.push(item);
-  }
+    /**
+     * 添加子项目
+     * @param item 要添加的子项目
+     */
+    addItem(item: SidebarItemEntity): void {
+        this.items.push(item);
+    }
 
-  /**
-   * 获取所有子项目
-   * @returns 子项目数组
-   */
-  getItems(): SidebarItemEntity[] {
-    return this.items.map((item) => new SidebarItemEntity(item));
-  }
+    /**
+     * 获取所有子项目
+     * @returns 子项目数组
+     */
+    getItems(): SidebarItemEntity[] {
+        return this.items.map((item) => new SidebarItemEntity(item));
+    }
 
-  /**
-   * 获取项目标签
-   * @returns 项目标签
-   */
-  getLabel(): string {
-    return this.text;
-  }
+    /**
+     * 获取项目标签
+     * @returns 项目标签
+     */
+    getLabel(): string {
+        return this.text;
+    }
 
-  /**
-   * 获取项目链接
-   * @returns 项目链接
-   */
-  getLink(): string {
-    return this.href;
-  }
+    /**
+     * 获取项目链接
+     * @returns 项目链接
+     */
+    getLink(): string {
+        return this.href;
+    }
 
-  /**
-   * 获取包括自身在内的所有项目
-   * @returns 包括自身在内的所有项目
-   */
-  getItemsIncludingSelf(): SidebarItemEntity[] {
-    return [this, ...this.getItems()];
-  }
+    /**
+     * 获取包括自身在内的所有项目
+     * @returns 包括自身在内的所有项目
+     */
+    getItemsIncludingSelf(): SidebarItemEntity[] {
+        return [this, ...this.getItems()];
+    }
 
-  /**
-   * 判断是否是分组（有子项目）
-   * @returns 是否是分组
-   */
-  isGroup(): boolean {
-    return this.items.length > 0;
-  }
+    /**
+     * 判断是否是分组（有子项目）
+     * @returns 是否是分组
+     */
+    isGroup(): boolean {
+        return this.items.length > 0;
+    }
 
-  /**
-   * 判断是否不是分组
-   * @returns 是否不是分组
-   */
-  isNotGroup(): boolean {
-    return !this.isGroup();
-  }
+    /**
+     * 判断是否不是分组
+     * @returns 是否不是分组
+     */
+    isNotGroup(): boolean {
+        return !this.isGroup();
+    }
 }
 
 /**
@@ -77,13 +79,13 @@ export class SidebarItemEntity implements ISidebarItem {
  * 实现此接口的类可以提供侧边栏项目
  */
 export interface SidebarProvider {
-  /**
-   * 转换为侧边栏项目
-   */
-  toSidebarItem(): Promise<SidebarItemEntity>;
+    /**
+     * 转换为侧边栏项目
+     */
+    toSidebarItem(): Promise<SidebarItemEntity>;
 
-  /**
-   * 获取顶级侧边栏项目
-   */
-  getTopSidebarItem?(): Promise<SidebarItemEntity>;
+    /**
+     * 获取顶级侧边栏项目
+     */
+    getTopSidebarItem?(): Promise<SidebarItemEntity>;
 }

package/dist/src-astro/footer/Footer.astro

@@ -176,6 +176,7 @@ import {
 } from '../../index-astro';
 import FooterSection from './FooterSection.astro';
 import '../../style.ts';
+import FooterCopyright from './FooterCopyright.astro';
 
 const {
   siteName,
@@ -367,17 +368,11 @@ const debugClasses = debug
 }
 
 {/* 底部版权信息 */}
-<div
-  class:list={[
-    'cosy:footer cosy:footer-center cosy:p-4 cosy:bg-base-300',
-    debugClasses.footer,
-  ]}>
-  <aside
-    class:list={['cosy:items-center cosy:grid-flow-col', debugClasses.aside]}>
-    <p class="cosy:opacity-70 cosy:text-sm">
-      © {currentYear}
-      {company} - {copyright || t('allRightsReserved')}
-    </p>
-    {icp && <p class="cosy:opacity-70 cosy:ml-4 cosy:text-sm">{icp}</p>}
-  </aside>
-</div>
+<FooterCopyright
+  company={company}
+  copyright={copyright}
+  icp={icp}
+  currentYear={currentYear}
+  t={t}
+  debugClasses={debugClasses}
+/>

package/dist/src-astro/footer/FooterCopyright.astro

@@ -0,0 +1,29 @@
+---
+/**
+ * @component FooterCopyright
+ * @description 页脚底部版权信息组件。
+ * @props
+ * @prop {string} company - 公司名称
+ * @prop {string} copyright - 版权信息
+ * @prop {string} icp - ICP备案号（可选）
+ * @prop {number} currentYear - 当前年份
+ * @prop {Function} t - 文本获取函数
+ * @prop {object} debugClasses - 调试样式类
+ */
+const { company, copyright, icp, currentYear, t, debugClasses } = Astro.props;
+---
+
+<div
+  class:list={[
+    'cosy:footer cosy:footer-center cosy:p-4 cosy:bg-base-300',
+    debugClasses?.footer,
+  ]}>
+  <aside
+    class:list={['cosy:items-center cosy:grid-flow-col', debugClasses?.aside]}>
+    <p class="cosy:opacity-70 cosy:text-sm">
+      © {currentYear}
+      {company} - {copyright || (t && t('allRightsReserved'))}
+    </p>
+    {icp && <p class="cosy:opacity-70 cosy:ml-4 cosy:text-sm">{icp}</p>}
+  </aside>
+</div>

package/dist/src-astro/footer/FooterSection.astro

@@ -33,6 +33,9 @@ const { title, links } = Astro.props;
             <Link
               href={link.href}
               size="sm"
+              ghost
+              btn
+              color="primary"
               target={link.external ? '_blank' : '_self'}
               variant="text">
               {link.name}

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

@@ -260,6 +260,12 @@ export interface Props {
    * @default false
    */
   debug?: boolean;
+
+  /**
+   * 主内容区 padding 尺寸
+   * @default 'md'
+   */
+  mainPadding?: 'none' | 'sm' | 'md' | 'lg' | 'xl';
 }
 
 const {
@@ -273,18 +279,27 @@ const {
   sidebarCollapsed = false,
   sidebarSize = 'md',
   sidebarTheme = 'default',
-  mainBackgroundTheme = 'transparent',
+  mainBackgroundTheme = 'base-100',
   enableToast = true,
   enableConfirmDialog = true,
   head,
   class: className,
   'class:list': classList,
   debug = false,
+  mainPadding = 'md',
   ...rest
 } = Astro.props;
 
 const currentPath = Astro.url.pathname;
 const mainBackgroundStyles = getMainBackgroundTheme(mainBackgroundTheme);
+
+const mainPaddingMap = {
+  none: '',
+  sm: 'cosy:p-2',
+  md: 'cosy:p-4',
+  lg: 'cosy:p-8',
+  xl: 'cosy:p-12',
+};
 ---
 
 <BaseLayout
@@ -328,7 +343,11 @@ const mainBackgroundStyles = getMainBackgroundTheme(mainBackgroundTheme);
 
       <!-- 页面内容 -->
       <main
-        class:list={['cosy:flex-1 cosy:p-4 cosy:lg:p-6', mainBackgroundStyles]}>
+        class:list={[
+          'cosy:flex-1',
+          mainPaddingMap[mainPadding],
+          mainBackgroundStyles,
+        ]}>
         <slot />
       </main>
     </div>

package/dist/src-astro/layout-dashboard/types.ts

@@ -159,8 +159,8 @@ export const mainBackgroundThemeMap: Record<MainBackgroundTheme, string> = {
  * @param theme 主内容区域背景主题
  * @returns 对应的样式类名
  */
-export function getMainBackgroundTheme(theme: MainBackgroundTheme = 'transparent'): string {
+export function getMainBackgroundTheme(theme: MainBackgroundTheme = 'base-100'): string {
     return mainBackgroundThemeMap[theme];
 }
 
-export { getIconFromHref, getNavItemIcon, getUserMenuItemIcon } from './tools'; 
+export { getIconFromHref, getNavItemIcon, getUserMenuItemIcon } from './tools';