@coffic/cosy-ui 0.9.6 → 0.9.7

package/dist/src-astro/collection/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/src-astro/collection/entities/LessonDoc.ts

@@ -1,203 +0,0 @@
-import type { LessonEntry } from '../repos/LessonRepo';
-import { lessonRepo } from '../repos/LessonRepo';
-import { cosyLogger } from '../../cosy';
-import { SidebarItemEntity, type SidebarProvider } from './SidebarItem';
-import { LinkUtil } from '../../../src/utils/link';
-import { render } from 'astro:content';
-import type { IHeadingType } from '../../types/heading';
-import { BaseDoc } from './BaseDoc';
-
-/**
- * 课程文档类，配合 LessonRepo 使用
- *
- * 目录结构：
- * ```
- * 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 implements SidebarProvider {
-    entry: LessonEntry;
-
-    constructor(entry: LessonEntry) {
-        super();
-        this.entry = entry;
-    }
-
-    isBook(): boolean {
-        return this.entry.id.split('/').length === 2;
-    }
-
-    getAncestorIds(): string[] {
-        const parts = this.entry.id.split('/');
-        return parts
-            .slice(0, -1)
-            .map((_part: string, index: number) => parts.slice(0, index + 1).join('/'));
-    }
-
-    getAncestorId(level: number): string {
-        const ancestorIds = this.getAncestorIds();
-
-        if (level < 1) {
-            cosyLogger.error('Level must be greater than 0');
-            throw new Error('Level must be greater than 0');
-        }
-
-        if (level >= this.getLevel()) {
-            cosyLogger.debug('当前文档的ID：' + this.entry.id);
-            cosyLogger.debug('当前文档的Level：' + this.getLevel());
-            cosyLogger.debug('正在获取祖先ID，level：' + level);
-
-            throw new Error('Level must be less than the document level');
-        }
-
-        if (ancestorIds.length < level) {
-            cosyLogger.debug('当前文档的ID\n' + this.entry.id);
-            cosyLogger.array('当前文档的祖先IDs', ancestorIds);
-            cosyLogger.debug('正在获取祖先ID，level:\n' + level);
-
-            throw new Error('Level must be greater than 0');
-        }
-
-        return ancestorIds[level - 1];
-    }
-
-    getParentId(): string | null {
-        return this.getAncestorId(this.getLevel() - 1);
-    }
-
-    getTopDocId(): string {
-        const level = this.getLevel();
-        if (level <= 2) {
-            return this.entry.id;
-        }
-        return this.getAncestorId(2);
-    }
-
-    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;
-    }
-
-    getSlug(): string {
-        return this.getId().split('/').slice(1).join('/');
-    }
-
-    getDescription(): string {
-        return this.entry.data.description as string;
-    }
-
-    async getBookId(): Promise<string> {
-        return this.getTopDocId();
-    }
-
-    async getBook(): Promise<LessonDoc | null> {
-        const bookId = await this.getBookId();
-        return await lessonRepo.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;
-    }
-
-    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 lessonRepo.find(bookId);
-    }
-
-    async getChildren(): Promise<LessonDoc[]> {
-        return await lessonRepo.getChildren(this.entry.id);
-    }
-
-    async getDescendants(): Promise<LessonDoc[]> {
-        return await lessonRepo.getDescendantDocs(this.entry.id);
-    }
-
-    async render(): Promise<any> {
-        return await render(this.entry);
-    }
-
-    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(),
-        });
-    }
-
-    async getTopSidebarItem(): Promise<SidebarItemEntity> {
-        const topDoc = await this.getTopDoc();
-        if (topDoc) {
-            return await topDoc.toSidebarItem();
-        }
-        return new SidebarItemEntity({
-            text: this.getTitle(),
-            items: [],
-            link: this.getLink(),
-        });
-    }
-}

package/dist/src-astro/collection/entities/MetaDoc.ts

@@ -1,115 +0,0 @@
-import type { MetaEntry } from '../repos/MetaRepo';
-import { LinkUtil } from '../../../src/utils/link';
-import { metaRepo } from '../repos/MetaRepo';
-import { SidebarItemEntity, type SidebarProvider } from './SidebarItem';
-import { cosyLogger } from '../../cosy';
-import { BaseDoc } from './BaseDoc';
-
-export default class MetaDoc extends BaseDoc implements SidebarProvider {
-    entry: MetaEntry;
-    collectionName = 'meta' as const;
-
-    constructor(entry: MetaEntry) {
-        super();
-        this.entry = entry;
-    }
-
-    getAncestorIds(): string[] {
-        const parts = this.entry.id.split('/');
-        return parts
-            .slice(0, -1)
-            .map((_part: string, index: number) => parts.slice(0, index + 1).join('/'));
-    }
-
-    getAncestorId(level: number): string {
-        const ancestorIds = this.getAncestorIds();
-
-        if (level < 1) {
-            cosyLogger.error('Level must be greater than 0');
-            throw new Error('Level must be greater than 0');
-        }
-
-        if (level >= this.getLevel()) {
-            cosyLogger.debug('当前文档的ID：' + this.entry.id);
-            cosyLogger.debug('当前文档的Level：' + this.getLevel());
-            cosyLogger.debug('正在获取祖先ID，level：' + level);
-
-            throw new Error('Level must be less than the document level');
-        }
-
-        if (ancestorIds.length < level) {
-            cosyLogger.debug('当前文档的ID\n' + this.entry.id);
-            cosyLogger.array('当前文档的祖先IDs', ancestorIds);
-            cosyLogger.debug('正在获取祖先ID，level:\n' + level);
-
-            throw new Error('Level must be greater than 0');
-        }
-
-        return ancestorIds[level - 1];
-    }
-
-    getParentId(): string | null {
-        return this.getAncestorId(this.getLevel() - 1);
-    }
-
-    getTopDocId(): string {
-        const level = this.getLevel();
-        if (level <= 2) {
-            return this.entry.id;
-        }
-        return this.getAncestorId(2);
-    }
-
-    getSlug(): string {
-        // 从 ID 中获取 slug，即删除以/分割后的第一个元素
-        return this.getId().split('/').slice(1).join('/');
-    }
-
-    getDescription(): string {
-        return this.entry.data.description as string;
-    }
-
-    getTopDoc(): Promise<MetaDoc | null> {
-        return Promise.resolve(null);
-    }
-
-    getChildren(): Promise<MetaDoc[]> {
-        return Promise.resolve([]);
-    }
-
-    getLink(): string {
-        return LinkUtil.getMetaLink(this.getLang(), this.getSlug());
-    }
-
-    async getSiblingDocs(): Promise<MetaDoc[]> {
-        return await metaRepo.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;
-    }
-
-    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/src-astro/collection/entities/SidebarItem.ts

@@ -1,91 +0,0 @@
-import { type ISidebarItem } from '../../types/sidebar';
-
-/**
- * 侧边栏提供者接口
- * 实现此接口的类可以提供侧边栏项目
- */
-export interface SidebarProvider {
-    /**
-     * 转换为侧边栏项目
-     */
-    toSidebarItem(): Promise<SidebarItemEntity>;
-
-    /**
-     * 获取顶级侧边栏项目
-     */
-    getTopSidebarItem?(): Promise<SidebarItemEntity>;
-}
-
-/**
- * 侧边栏项目类
- * 用于构建网站的侧边栏导航
- */
-export class SidebarItemEntity implements ISidebarItem {
-    text: string;
-    href: string;
-    items: ISidebarItem[];
-    badge?: string | number;
-
-    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);
-    }
-
-    /**
-     * 获取所有子项目
-     * @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();
-    }
-}

package/dist/src-astro/collection/entities/Tag.ts

@@ -1,42 +0,0 @@
-import { blogRepo } from '../repos/BlogRepo';
-import { SidebarItemEntity } from './SidebarItem';
-import { type ITagStaticPath } from '../../types/static-path';
-import { LinkUtil } from '../../../src/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 blogRepo.getTagsByLang(lang);
-
-        return new SidebarItemEntity({
-            text: 'Tags',
-            link: LinkUtil.getTagLink(lang, ''),
-            items: tags.map((tag: Tag) => tag.toSidebarItem(lang)),
-        });
-    }
-}
-
-export default Tag;

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

@@ -1,11 +0,0 @@
-export * from './repos/BaseRepo';
-export * from './repos/BlogRepo';
-export * from './repos/ExperimentRepo';
-export * from './repos/LessonRepo';
-export * from './repos/MetaRepo';
-export * from './repos/CourseRepo';
-
-export * from './entities/BlogDoc';
-export * from './entities/ExperimentDoc';
-export * from './entities/LessonDoc';
-export * from './entities/MetaDoc';