@coffic/cosy-ui 0.4.3 → 0.4.7

package/dist/types/heading.ts

@@ -0,0 +1,13 @@
+/**
+ * 表示文档中的标题结构
+ */
+export interface Heading {
+    /** 标题深度，如 h1=1, h2=2, h3=3 等 */
+    depth: number;
+
+    /** 标题的唯一标识符，用于锚点链接 */
+    slug: string;
+
+    /** 标题文本内容 */
+    text: string;
+} 

package/dist/utils/link.ts

@@ -0,0 +1,216 @@
+import { logger } from "./logger";
+
+export default class LinkUtil {
+    /**
+     * 规范化语言代码
+     * @param lang - 语言代码
+     * @returns 规范化后的语言代码
+     */
+    static normalizeLanguage(lang: string): string {
+        const normalizedLang = lang.toLowerCase().replace('zh-CN', 'zh-cn');
+        if (normalizedLang.length == 0) {
+            console.error('lang is empty');
+            return 'en';
+        }
+        return normalizedLang;
+    }
+
+    static getHomeLink(lang: string): string {
+        return `/${lang}`;
+    }
+
+    static getLessonsLink(lang: string): string {
+        return `/${lang}/lessons`;
+    }
+
+    static getExperimentsLink(lang: string): string {
+        return `/${lang}/experiments`;
+    }
+
+    static getExperimentLink(lang: string, experimentId: string): string {
+        if (experimentId.endsWith(lang)) {
+            return `/${lang}/experiments/${experimentId.replace(`${lang}`, '')}`;
+        } else {
+            const idWithoutLang = experimentId.replace(`${lang}/`, '');
+            return `/${lang}/experiments/${idWithoutLang}`;
+        }
+    }
+
+    static getCoursesLink(lang: string): string {
+        return `/${lang}/courses`;
+    }
+
+    static getBlogsLink(lang: string): string {
+        return `/${lang}/blogs`;
+    }
+
+    static getLessonLink(lang: string, lessonId: string): string {
+        if (lessonId.endsWith(lang)) {
+            return `/${lang}/lessons/${lessonId.replace(`${lang}`, '')}`;
+        } else {
+            const idWithoutLang = lessonId.replace(`${lang}/`, '');
+            return `/${lang}/lessons/${idWithoutLang}`;
+        }
+    }
+
+    static getTagLink(lang: string, tagName: string): string {
+        return `/${lang}/blogs/tag/${tagName}`;
+    }
+
+    static getBlogLink(blogId: string, lang: string): string {
+        const debug = false
+        const blogIdWithoutLang = blogId.replace(`${lang}/`, '')
+
+        if (debug) {
+            logger.info(`获取博客文档链接，博客文档ID: ${blogId}`);
+        }
+
+        return `/${lang}/blogs/${blogIdWithoutLang}`;
+    }
+
+    static getCourseLink(courseId: string): string {
+        const debug = false
+        const lang = courseId.split('/')[0]
+        const courseIdWithoutLang = courseId.replace(`${lang}/`, '')
+
+        if (debug) {
+            logger.info(`获取课程文档链接，课程文档ID: ${courseId}`);
+        }
+
+        return `/${lang}/courses/${courseIdWithoutLang}`;
+    }
+
+    static getMetaLink(lang: string, slug: string): string {
+        return `/${this.normalizeLanguage(lang)}/meta/${slug}`;
+    }
+
+    static getSigninLink(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/signin`;
+    }
+
+    static getAuthCallbackCookieLink(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/auth/callback_cookie`;
+    }
+
+    static getAuthCallbackTokenLink(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/auth/callback_token`;
+    }
+
+    static getAuthAccountLink(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/auth/account`;
+    }
+
+    static getDashboardUrl(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/auth/dashboard`;
+    }
+
+    static getAuthErrorLink(lang: string): string {
+        return `/${this.normalizeLanguage(lang)}/auth/error`;
+    }
+
+    static getPrivacyLink(lang: string): string {
+        return this.getMetaLink(lang, 'privacy');
+    }
+
+    static getTermsLink(lang: string): string {
+        return this.getMetaLink(lang, 'terms');
+    }
+
+    static getAboutLink(lang: string): string {
+        return this.getMetaLink(lang, 'about');
+    }
+
+    /**
+     * 根据ID生成链接
+     * 
+     * 该函数根据文档ID生成对应的链接路径。
+     * 
+     * @param {string} id - 文档ID, 例如 'courses/zh-cn/supervisor/index.md'
+     * @returns {string} 返回生成的链接路径
+     * @example
+     * // 例如：
+     * // id=courses/zh-cn/supervisor/index.md，则返回/zh-cn/courses/supervisor
+     * // id=courses/en/supervisor/index.md，则返回/en/courses/supervisor
+     */
+    static getLink(id: string): string {
+        let category = id.split('/')[0];
+        let lang = id.split('/')[1];
+        let path = id.split('/').slice(2).join('/');
+
+        let link = `/${lang}/${category}/${path}`;
+        return link.replace(/\/+/g, '/');
+    }
+
+    /**
+     * 根据分类生成顶级链接
+     * 
+     * @param {string} category - 分类名称
+     * @param {string} lang - 语言代码，例如 'zh-cn', 'en'
+     * @returns {string} 返回生成的顶级链接路径
+     * @example
+     * // 例如：
+     * // category=courses, lang=zh-cn，则返回/zh-cn/courses
+     * // category=courses, lang=en，则返回/en/courses
+     */
+    static getTopLevelLink(category: string, lang: string): string {
+        return `/${lang}/${category}`;
+    }
+
+    /**
+     * 处理首页重定向
+     * @param locale - 语言代码
+     * @returns 规范化的语言代码
+     */
+    static homeRedirect(locale: string): string {
+        return locale || "en";
+    }
+
+    /**
+     * 检查是否为首页路径
+     * @param pathname - 路径
+     * @returns 是否为首页
+     */
+    static isHomePath(pathname: string): boolean {
+        return pathname === "/" || pathname === "";
+    }
+
+    static isHomeLink(path: string, lang: string): boolean {
+        return path === `/${lang}` || path === `/${lang}/`;
+    }
+
+    static isLessonsLink(path: string, lang: string): boolean {
+        return path === `/${lang}/lessons` ||
+            path === `/${lang}/lessons/` ||
+            path.startsWith(`/${lang}/lessons/`);
+    }
+
+    static isExperimentsLink(path: string, lang: string): boolean {
+        return path === `/${lang}/experiments` ||
+            path === `/${lang}/experiments/` ||
+            path.startsWith(`/${lang}/experiments/`);
+    }
+
+    static isCoursesLink(path: string, lang: string): boolean {
+        return path === `/${lang}/courses`
+            || path === `/${lang}/courses/`
+            || path.startsWith(`/${lang}/courses/`);
+    }
+
+    static isBlogsLink(path: string, lang: string): boolean {
+        return path === `/${lang}/blogs`
+            || path === `/${lang}/blogs/`
+            || path.startsWith(`/${lang}/blogs/`);
+    }
+
+    static getOAuthSuccessLink(currentOrigin: string): string {
+        return `${currentOrigin}/api/callback_success`;
+    }
+
+    static getOAuthErrorLink(currentOrigin: string): string {
+        return `${currentOrigin}/api/callback_error`;
+    }
+
+    static getLoginLink(currentOrigin: string): string {
+        return `${currentOrigin}/api/login`;
+    }
+}

package/dist/utils/logger.ts

@@ -0,0 +1,139 @@
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+
+// 控制是否显示时间戳
+const SHOW_TIMESTAMP = false;
+
+// ANSI 颜色代码
+const colors = {
+    reset: '\x1b[0m',
+    debug: '\x1b[36m', // 青色
+    info: '\x1b[32m',  // 绿色
+    warn: '\x1b[33m',  // 黄色
+    error: '\x1b[31m', // 红色
+    gray: '\x1b[90m',  // 灰色用于时间戳
+};
+
+class Logger {
+    private getCallerInfo(): string {
+        const error = new Error();
+        const stackLines = error.stack?.split('\n') || [];
+
+        // 从第3行开始查找，跳过不是来自logger.ts的第一个调用
+        let targetLine = '';
+        for (let i = 3; i < stackLines.length; i++) {
+            const line = stackLines[i];
+            if (!line.includes('logger.ts')) {
+                targetLine = line;
+                break;
+            }
+        }
+
+        if (!targetLine) return '';
+
+        // 匹配文件路径和行号
+        const match = targetLine.match(/\((.+):(\d+):\d+\)/) || targetLine.match(/at (.+):(\d+):\d+/);
+        if (!match) return '';
+
+        const [_, filePath, line] = match;
+        return `${filePath}:${line}`;
+    }
+
+    private formatArray(arr: any[]): string {
+        const MAX_LINES = 30;
+        const MAX_LENGTH = 100;
+
+        const truncateString = (str: string): string => {
+            return str.length > MAX_LENGTH ? str.slice(0, MAX_LENGTH) + '...' : str;
+        };
+
+        const truncateObject = (obj: any): any => {
+            if (typeof obj !== 'object' || obj === null) {
+                return typeof obj === 'string' ? truncateString(obj) : obj;
+            }
+
+            const result: any = Array.isArray(obj) ? [] : {};
+            for (const [key, value] of Object.entries(obj)) {
+                result[key] = typeof value === 'string' ? truncateString(value)
+                    : typeof value === 'object' ? truncateObject(value)
+                        : value;
+            }
+            return result;
+        };
+
+        const items = arr.slice(0, MAX_LINES).map(item => {
+            const truncatedItem = truncateObject(item);
+            // 使用2个空格缩进，并在每行前添加 "  • "
+            const jsonString = JSON.stringify(truncatedItem, null, 2)
+                .split('\n')
+                .map((line, index) => index === 0 ? `  • ${line}` : `    ${line}`)
+                .join('\n');
+            return jsonString;
+        });
+
+        let output = items.join('\n');
+        if (arr.length > MAX_LINES) {
+            const remainingCount = arr.length - MAX_LINES;
+            output += `\n  ⋮ ... and ${remainingCount} more items`;
+        }
+
+        return output;
+    }
+
+    private log(level: LogLevel, message: string | object | any[]) {
+        const caller = this.getCallerInfo();
+        // 使用本地时间，并格式化为 HH:mm:ss 格式
+        const timestamp = new Date().toLocaleTimeString('zh-CN', {
+            hour12: false,
+            hour: '2-digit',
+            minute: '2-digit',
+            second: '2-digit'
+        });
+
+        const formattedMessage = Array.isArray(message)
+            ? this.formatArray(message)
+            : typeof message === 'object'
+                ? JSON.stringify(message, null, 2)
+                : message;
+
+        const timestampPart = SHOW_TIMESTAMP
+            ? `${colors.gray}${timestamp}${colors.reset} `
+            : '';
+
+        const emoji = {
+            debug: '🔍',
+            info: '🐳',
+            warn: '🚨',
+            error: '❌'
+        }[level];
+
+        // eslint-disable-next-line no-console
+        console.log(
+            timestampPart +
+            `${colors[level]}${emoji} ${level.toUpperCase()}${colors.reset} ` +
+            `${colors.gray}:${colors.reset} ` +
+            `${colors[level]}${formattedMessage}${colors.reset}`
+        );
+    }
+
+    debug(message: string | object) {
+        this.log('debug', message);
+    }
+
+    info(message: string | object) {
+        this.log('info', message);
+    }
+
+    warn(message: string | object) {
+        this.log('warn', message);
+    }
+
+    error(message: string | object) {
+        this.log('error', message);
+    }
+
+    array(title: string, arr: any[]) {
+        this.log('info', title + '\n' + this.formatArray(arr));
+    }
+}
+
+export const logger = new Logger();

package/package.json

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

package/dist/components/layouts/DefaultLayout.astro

@@ -1,170 +0,0 @@
----
-/**
- * DefaultLayout组件
- * 
- * 包含常用页面结构的默认布局，包括简单的页眉和页脚
- * 
- * @example
- * ```astro
- * ---
- * import DefaultLayout from '../layouts/DefaultLayout.astro';
- * ---
- * 
- * <DefaultLayout title="页面标题" description="页面描述">
- *   <h1>页面内容</h1>
- *   <p>这是页面的主要内容</p>
- * </DefaultLayout>
- * ```
- */
-
-import BaseLayout from './BaseLayout.astro';
-import Link from '../base/Link.astro';
-
-// 导入样式
-import '../../app.css';
-
-export interface NavLink {
-  href: string;
-  label: string;
-}
-
-export interface Props {
-  /**
-   * 页面标题
-   */
-  title: string;
-  
-  /**
-   * 页面描述
-   */
-  description?: string;
-  
-  /**
-   * 页面关键词
-   */
-  keywords?: string;
-  
-  /**
-   * 是否显示页眉
-   * @default true
-   */
-  showHeader?: boolean;
-  
-  /**
-   * 是否显示页脚
-   * @default true
-   */
-  showFooter?: boolean;
-  
-  /**
-   * 网站名称
-   * @default "网站名称"
-   */
-  siteName?: string;
-  
-  /**
-   * 导航链接
-   */
-  navLinks?: NavLink[];
-  
-  /**
-   * 页面容器类名
-   */
-  containerClass?: string;
-  
-  /**
-   * 自定义头部内容
-   */
-  head?: astroHTML.JSX.Element;
-  
-  /**
-   * 页面类名
-   */
-  class?: string;
-  
-  /**
-   * 类名列表
-   */
-  'class:list'?: any;
-}
-
-const {
-  title,
-  description,
-  keywords,
-  showHeader = true,
-  showFooter = true,
-  siteName = "网站名称",
-  navLinks = [
-    { href: "/", label: "首页" },
-    { href: "/about", label: "关于" },
-    { href: "/contact", label: "联系我们" }
-  ],
-  containerClass = "container mx-auto px-4 py-8",
-  head,
-  class: className,
-  'class:list': classList,
-  ...rest
-} = Astro.props;
-
-const year = new Date().getFullYear();
----
-
-<BaseLayout 
-  title={title} 
-  description={description} 
-  keywords={keywords}
-  head={head}
-  class={className}
-  {...rest}
->
-  {showHeader && (
-    <header class="site-header">
-      <div class="container px-4 py-4">
-        <div class="header-content">
-          <div class="logo">
-            <a href="/" class="site-name">{siteName}</a>
-          </div>
-          
-          <nav class="main-nav">
-            <ul class="nav-list">
-              {navLinks.map((link: NavLink) => (
-                <li class="nav-item">
-                  <Link href={link.href} variant="text">{link.label}</Link>
-                </li>
-              ))}
-            </ul>
-          </nav>
-        </div>
-      </div>
-    </header>
-  )}
-  
-  <main class={containerClass}>
-    <slot />
-  </main>
-  
-  {showFooter && (
-    <footer class="site-footer">
-      <div class="container px-4 py-8">
-        <div class="footer-content">
-          <div class="footer-info">
-            <p class="copyright">&copy; {year} {siteName}. 保留所有权利。</p>
-          </div>
-          
-          <nav class="footer-nav">
-            <ul class="nav-list">
-              {navLinks.map((link: NavLink) => (
-                <li class="nav-item">
-                  <Link href={link.href} variant="text" size="sm">{link.label}</Link>
-                </li>
-              ))}
-            </ul>
-          </nav>
-        </div>
-      </div>
-    </footer>
-  )}
-  
-  <slot name="after-footer" />
-</BaseLayout>