@coffic/cosy-ui 0.7.4 → 0.8.6

package/dist/entities/Feature.ts

@@ -1,53 +0,0 @@
-class Feature {
-    private translations: Map<string, string>;
-    public emoji: string = '';
-    public link: string = '';
-    public presetIcon: string = '';
-
-    private constructor() {
-        this.translations = new Map();
-        this.translations.set('zh-cn', '');
-        this.translations.set('en', '');
-    }
-
-    public static createWithIcon(emoji: string): Feature {
-        const feature = new Feature();
-        feature.emoji = emoji;
-        return feature;
-    }
-
-    public static createWithPresetIcon(presetIcon: string): Feature {
-        const feature = new Feature();
-        feature.presetIcon = presetIcon;
-        return feature;
-    }
-
-    public setTitle(title: string, lang: string): Feature {
-        this.translations.set(lang, title);
-        return this;
-    }
-
-    public setLink(link: string): Feature {
-        this.link = link;
-        return this;
-    }
-
-    public setPresetIcon(presetIcon: string): Feature {
-        this.presetIcon = presetIcon;
-        return this;
-    }
-
-    public setZh(title: string): Feature {
-        return this.setTitle(title, 'zh-cn');
-    }
-
-    public setEn(title: string): Feature {
-        return this.setTitle(title, 'en');
-    }
-
-    public getTitle(lang: string): string {
-        return this.translations.get(lang) || '';
-    }
-}
-
-export default Feature;

package/dist/entities/LessonDoc.ts

@@ -1,148 +0,0 @@
-import type { LessonEntry } from '../database/LessonDB';
-import { lessonDB } from '../database/LessonDB';
-import { cosyLogger } from '../cosy';
-import { SidebarItemEntity } from './SidebarItem';
-import { LinkUtil } from '../utils/link';
-import { COLLECTION_LESSON } from '../database/LessonDB';
-import { BaseDoc } from './BaseDoc';
-import type { IHeadingType } from '../types/heading';
-
-/**
- * 课程文档类，配合 LessonDB 使用
- * 
- * 目录结构：
- * ```
- * 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 子模块独立管理
- */
-export default class LessonDoc extends BaseDoc<typeof COLLECTION_LESSON, LessonEntry> {
-	constructor(entry: LessonEntry) {
-		super(entry);
-	}
-
-	isBook(): boolean {
-		return this.entry.id.split('/').length === 2;
-	}
-
-	async getBookId(): Promise<string> {
-		return this.getTopDocId();
-	}
-
-	async getBook(): Promise<LessonDoc | null> {
-		const bookId = await this.getBookId();
-		return await lessonDB.find(bookId);
-	}
-
-	getLink(): string {
-		const debug = false;
-		const lang = this.getLang();
-		const link = LinkUtil.getLessonLink(lang, this.getId());
-
-		if (debug) {
-			cosyLogger.info(`获取 ${this.entry.id} 的链接: ${link}`);
-		}
-
-		return link;
-	}
-
-	/**
-	 * 获取文档的语言
-	 *
-	 * 文档的 id 格式为 `book-id/zh-cn/chapter-id/lesson-id`
-	 *
-	 * @returns 语言
-	 */
-	override getLang(): string {
-		const debug = false;
-
-		const parts = this.entry.id.split('/');
-		const lang = parts[1];
-
-		if (debug) {
-			cosyLogger.info(`获取 ${this.entry.id} 的语言: ${lang}`);
-		}
-
-		return lang;
-	}
-
-	getHTML(): string {
-		const debug = false;
-
-		if (debug) {
-			cosyLogger.info(`获取 ${this.entry.id} 的 HTML`);
-		}
-
-		return this.entry.rendered?.html || '';
-	}
-
-	getHeadings(): IHeadingType[] {
-		const debug = false;
-
-		if (debug) {
-			cosyLogger.info(`获取 ${this.entry.id} 的 headings`);
-		}
-
-		return (this.entry.rendered?.metadata?.headings as IHeadingType[]) || [];
-	}
-
-	async getTopDoc(): Promise<LessonDoc | null> {
-		const bookId = await this.getBookId();
-		return await lessonDB.find(bookId);
-	}
-
-	async getChildren(): Promise<LessonDoc[]> {
-		return await lessonDB.getChildren(this.entry.id);
-	}
-
-	async getDescendants(): Promise<LessonDoc[]> {
-		return await lessonDB.getDescendantDocs(this.entry.id);
-	}
-
-	override async toSidebarItem(): Promise<SidebarItemEntity> {
-		const debug = false;
-
-		const children = await this.getChildren();
-		let childItems = await Promise.all(children.map((child) => child.toSidebarItem()));
-
-		if (this.isBook()) {
-			childItems = [...childItems];
-		}
-
-		if (debug) {
-			cosyLogger.info(`${this.entry.id} 的侧边栏项目`);
-			console.log(childItems);
-		}
-
-		return new SidebarItemEntity({
-			text: this.getTitle(),
-			items: childItems,
-			link: this.getLink(),
-		});
-	}
-}

package/dist/entities/MetaDoc.ts

@@ -1,90 +0,0 @@
-import { SidebarItemEntity } from './SidebarItem';
-import type { MetaEntry } from '../database/MetaDB';
-import { LinkUtil } from '../utils/link';
-import { BaseDoc } from './BaseDoc';
-import { metaDB } from '../database/MetaDB';
-import { COLLECTION_META } from '../database/MetaDB';
-
-export default class MetaDoc extends BaseDoc<typeof COLLECTION_META, MetaEntry> {
-	constructor(entry: MetaEntry) {
-		super(entry);
-	}
-
-	static fromEntry(entry: MetaEntry) {
-		return new MetaDoc(entry);
-	}
-
-	getTopDoc(): Promise<MetaDoc | null> {
-		return Promise.resolve(null);
-	}
-
-	getChildren(): Promise<MetaDoc[]> {
-		return Promise.resolve([]);
-	}
-
-	getLink(): string {
-		return LinkUtil.getMetaLink(this.getLang(), this.getSlug());
-	}
-
-	getLang(): string {
-		return this.entry.id.split('/')[0];
-	}
-
-	/**
-	 * 获取元数据页面的 slug
-	 * 例如：
-	 *  ID: zh-cn/about 的 slug 为 about
-	 *  ID: en/privacy 的 slug 为 privacy
-	 */
-	override getSlug(): string {
-		// 从 ID 中获取 slug，即删除以/分割后的第一个元素
-		return this.getId().split('/').slice(1).join('/');
-	}
-
-	/**
-	 * 获取兄弟文档
-	 * 例如：对于 'zh-cn/about'，会返回 'zh-cn' 下的其他文档
-	 */
-	async getSiblingDocs(): Promise<MetaDoc[]> {
-		return await metaDB.getSiblings(this.entry.id);
-	}
-
-	/**
-	 * 获取兄弟文档的侧边栏项目
-	 */
-	async getSiblingSidebarItems(): Promise<SidebarItemEntity[]> {
-		const siblings = await this.getSiblingDocs();
-		const siblingItems = await Promise.all(
-			siblings.map((sibling) => {
-				return new SidebarItemEntity({
-					text: sibling.getTitle(),
-					link: sibling.getLink(),
-				});
-			})
-		);
-		return siblingItems;
-	}
-
-	/**
-	 * 重写侧边栏项目方法
-	 * 对于元数据页面，我们不显示子项目
-	 */
-	override async toSidebarItem(): Promise<SidebarItemEntity> {
-		return new SidebarItemEntity({
-			text: this.getTitle(),
-			link: this.getLink(),
-		});
-	}
-
-	/**
-	 * 重写顶级侧边栏项目方法
-	 * 对于元数据页面，我们显示所有兄弟页面作为侧边栏项目
-	 */
-	async getTopSidebarItem(): Promise<SidebarItemEntity> {
-		return new SidebarItemEntity({
-			text: '了解我们',
-			items: await this.getSiblingSidebarItems(),
-			link: '',
-		});
-	}
-}

package/dist/entities/SidebarItem.ts

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

package/dist/entities/Tag.ts

@@ -1,42 +0,0 @@
-import { blogDB } from '../database/BlogDB';
-import { SidebarItemEntity } from './SidebarItem';
-import { type ITagStaticPath } from '../types/static-path';
-import { LinkUtil } from '../utils/link';
-
-export class Tag {
-	name: string;
-	lang: string;
-	count: number;
-
-	constructor(name: string, count: number, lang: string) {
-		this.name = name;
-		this.count = count;
-		this.lang = lang;
-	}
-
-	toSidebarItem(lang: string): SidebarItemEntity {
-		return new SidebarItemEntity({
-			text: this.name,
-			link: LinkUtil.getTagLink(lang, this.name),
-		});
-	}
-
-	toTagPath(): ITagStaticPath {
-		return {
-			params: { slug: this.lang + '/blogs/tag/' + this.name },
-			props: { tag: this.name },
-		};
-	}
-
-	static async makeRootSidebarItem(lang: string): Promise<SidebarItemEntity> {
-		const tags = await blogDB.getTagsByLang(lang);
-
-		return new SidebarItemEntity({
-			text: 'Tags',
-			link: LinkUtil.getTagLink(lang, ''),
-			items: tags.map((tag: Tag) => tag.toSidebarItem(lang)),
-		});
-	}
-}
-
-export default Tag;

package/dist/env.d.ts

@@ -1,32 +0,0 @@
-/// <reference types="vite/client" />
-
-declare module '*.vue?raw' {
-	const content: string;
-	export default content;
-}
-
-// 添加图片模块声明
-declare module '*.png' {
-	const value: string;
-	export default value;
-}
-
-declare module '*.jpg' {
-	const value: string;
-	export default value;
-}
-
-declare module '*.jpeg' {
-	const value: string;
-	export default value;
-}
-
-declare module '*.svg' {
-	const value: string;
-	export default value;
-}
-
-declare module '*.gif' {
-	const value: string;
-	export default value;
-}

package/dist/errors/404.astro

@@ -1,27 +0,0 @@
----
-import { LinkUtil } from '../utils/link';
-const baseUrl = LinkUtil.getBaseUrl();
-const path = Astro.url.pathname;
-
-interface Error404Props {
-	debugKVs: Record<string, string>;
-}
-
-const { debugKVs = {} } = Astro.props as Error404Props;
----
-
-<div class="flex flex-col items-center justify-center h-screen">
-	<div class="flex flex-col justify-center items-center min-h-[50vh] text-center">
-		<h1 class="mb-4 font-bold text-4xl">404 - 页面未找到</h1>
-		<p class="mb-8 text-lg">抱歉，您要找的文档不存在。</p>
-		<p class="mb-8 text-lg">路径：{path}</p>
-		{
-			Object.entries(debugKVs).map(([key, value]) => (
-				<p class="mb-8 text-lg">
-					{key}: {value}
-				</p>
-			))
-		}
-		<a href={baseUrl} class="btn btn-primary"> 返回首页 </a>
-	</div>
-</div>

package/dist/errors/404Basic.astro

@@ -1,5 +0,0 @@
----
-import Error404 from './404.astro';
----
-
-<Error404 debugKVs={{ reason: '示例：页面不存在', try: '请检查链接是否正确' }} />

package/dist/errors/index.ts

@@ -1,11 +0,0 @@
-import Error404 from './404.astro';
-import Error404Basic from './404Basic.astro';
-import BasicSourceCode from './404Basic.astro?raw';
-import { extractSimpleExample } from '../utils/component';
-
-export { Error404, Error404Basic };
-
-// 导出示例源代码
-export const Error404ExampleCodes = {
-	Basic: extractSimpleExample(BasicSourceCode, 'Error404'),
-};

package/dist/flex/Flex.astro

@@ -1,138 +0,0 @@
----
-/**
- * @component Flex
- * 
- * @description
- * Flex 组件是一个灵活的弹性布局组件，用于创建各种排列和对齐方式的布局。
- * 它封装了 CSS Flexbox 的常用功能，提供简单易用的接口来控制子元素的排列方式。
- * 
- * @note
- * 此组件需要在 Root 组件内使用以确保样式正确加载。
- * 
- * @usage
- * ```astro
- * ---
- * import { Root, Flex } from '@coffic/cosy-ui';
- * ---
- * 
- * <Root>
- *   <Flex>
- *     <div>默认水平排列</div>
- *     <div>居中对齐</div>
- *   </Flex>
- * </Root>
- * ```
- */
-
-import type { HTMLAttributes } from 'astro/types';
-
-type Direction = 'row' | 'row-reverse' | 'column' | 'column-reverse';
-type Justify = 'start' | 'end' | 'center' | 'between' | 'around' | 'evenly';
-type Align = 'start' | 'end' | 'center' | 'stretch' | 'baseline';
-type Gap = 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
-
-interface Props extends HTMLAttributes<'div'> {
-  /**
-   * 排列方向
-   * @default "row"
-   */
-  direction?: Direction;
-  
-  /**
-   * 水平对齐方式
-   * @default "center"
-   */
-  justify?: Justify;
-  
-  /**
-   * 垂直对齐方式
-   * @default "center"
-   */
-  align?: Align;
-  
-  /**
-   * 是否允许换行
-   * @default false
-   */
-  wrap?: boolean;
-  
-  /**
-   * 元素间距
-   * @default "md"
-   */
-  gap?: Gap;
-  
-  /**
-   * 自定义类名
-   */
-  class?: string;
-  
-  /**
-   * 类名列表
-   */
-  'class:list'?: any;
-}
-
-const {
-  direction = 'row',
-  justify = 'center',
-  align = 'center',
-  wrap = false,
-  gap = 'md',
-  class: className = '',
-  'class:list': classList,
-  ...rest
-} = Astro.props;
-
-// 方向映射
-const directionClasses: Record<Direction, string> = {
-  'row': 'flex-row',
-  'row-reverse': 'flex-row-reverse',
-  'column': 'flex-col',
-  'column-reverse': 'flex-col-reverse'
-};
-
-// 水平对齐映射
-const justifyClasses: Record<Justify, string> = {
-  'start': 'justify-start',
-  'end': 'justify-end',
-  'center': 'justify-center',
-  'between': 'justify-between',
-  'around': 'justify-around',
-  'evenly': 'justify-evenly'
-};
-
-// 垂直对齐映射
-const alignClasses: Record<Align, string> = {
-  'start': 'items-start',
-  'end': 'items-end',
-  'center': 'items-center',
-  'stretch': 'items-stretch',
-  'baseline': 'items-baseline'
-};
-
-// 间距映射
-const gapClasses: Record<Gap, string> = {
-  'none': 'gap-0',
-  'xs': 'gap-2',
-  'sm': 'gap-4',
-  'md': 'gap-6',
-  'lg': 'gap-8',
-  'xl': 'gap-12'
-};
-
-// 构建最终类名
-const flexClasses = [
-  'flex',
-  directionClasses[direction as Direction],
-  justifyClasses[justify as Justify],
-  alignClasses[align as Align],
-  wrap ? 'flex-wrap' : 'flex-nowrap',
-  gapClasses[gap as Gap],
-  className
-].join(' ');
----
-
-<div class:list={[flexClasses, classList]} {...rest}>
-  <slot />
-</div>

package/dist/flex/FlexBasic.astro

@@ -1,9 +0,0 @@
----
-import Flex from './Flex.astro';
----
-
-<Flex gap="md" justify="center" align="center" style="height: 200px; background: #f3f4f6;">
-	<div style="background: #60a5fa; color: white; padding: 16px; border-radius: 8px;">元素 1</div>
-	<div style="background: #34d399; color: white; padding: 16px; border-radius: 8px;">元素 2</div>
-	<div style="background: #f59e42; color: white; padding: 16px; border-radius: 8px;">元素 3</div>
-</Flex>

package/dist/flex/index.ts

@@ -1,11 +0,0 @@
-import Flex from './Flex.astro';
-import FlexBasic from './FlexBasic.astro';
-import BasicSourceCode from './FlexBasic.astro?raw';
-import { extractSimpleExample } from '../utils/component';
-
-export { Flex, FlexBasic };
-
-// 导出示例源代码
-export const FlexExampleCodes = {
-	Basic: extractSimpleExample(BasicSourceCode, 'Flex'),
-};

package/dist/footer/EFooterBasic.astro

@@ -1,18 +0,0 @@
----
-/**
- * @component Footer.Basic
- *
- * @description
- * 基础Footer组件示例，展示最简单的页脚用法。
- */
-import { Footer } from '../index';
----
-
-<Footer
-	siteName="我的网站"
-	homeLink="/"
-	slogan="简单而强大"
-	company="我的公司"
-	copyright="保留所有权利"
-	inspirationalSlogan="构建美好的数字体验"
-/>

package/dist/footer/EFooterBasicContainer.astro

@@ -1,11 +0,0 @@
----
-import { CodeContainer } from '../index';
-import FooterBasic from './EFooterBasic.astro';
-import FooterBasicSourceCode from './EFooterBasic.astro?raw';
----
-
-<CodeContainer codes={[FooterBasicSourceCode]}>
-	<div id="tab-1">
-		<FooterBasic />
-	</div>
-</CodeContainer>