@coffic/cosy-ui 0.3.67 → 0.4.3

package/dist/types/footer.ts

@@ -10,37 +10,134 @@ export interface Product {
 }
 
 export interface FooterProps {
-    siteName: string;
-    homeLink: string;
-    slogan: string;
+    /**
+     * 关于链接
+     */
+    aboutLink?: string;
+
+    /**
+     * 博客链接
+     */
+    blogLink?: string;
+
+    /**
+     * 职业链接
+     */
+    careersLink?: string;
+
+    /**
+     * 公司名称
+     */
     company: string;
+
+    /**
+     * 联系链接
+     */
+    contactLink?: string;
+
+    /**
+     * 版权信息
+     */
     copyright: string;
-    inspirationalSlogan: string;
+
+    /**
+     * 调试模式
+     */
     debug?: boolean;
+
+    /**
+     * 是否启用日志输出
+     * @default false
+     */
+    enableLogging?: boolean;
+
+    /**
+     * 常见问题链接
+     */
+    faqLink?: string;
+
+    /**
+     * 历史链接
+     */
+    historyLink?: string;
+
+    /**
+     * 首页链接
+     */
+    homeLink: string;
+
+    /**
+     * ICP备案号
+     */
     icp?: string;
+
+    /**
+     * 激励标语
+     */
+    inspirationalSlogan: string;
+
+    /**
+     * 语言代码，默认自动检测
+     */
+    lang?: string;
+
+    /**
+     * 徽标
+     */
     logo?: Logo;
-    products?: Product[];
-    aboutLink?: string;
-    contactLink?: string;
-    termsLink?: string;
+
+    /**
+     * 媒体链接
+     */
+    mediaLink?: string;
+
+    /**
+     * 新闻链接
+     */
+    newsLink?: string;
+
+    /**
+     * 合作伙伴链接
+     */
+    partnersLink?: string;
+
+    /**
+     * 隐私链接
+     */
     privacyLink?: string;
+
+    /**
+     * 产品
+     */
+    products?: Product[];
+
+    /**
+     * 站点名称
+     */
+    siteName: string;
+
+    /**
+     * 标语
+     */
+    slogan: string;
+
+    /**
+     * 社交链接
+     */
     socialLinks?: string[];
+
+    /**
+     * 团队链接
+     */
     teamLink?: string;
-    careersLink?: string;
-    newsLink?: string;
-    historyLink?: string;
-    partnersLink?: string;
-    blogLink?: string;
-    faqLink?: string;
-    mediaLink?: string;
-    techStackLink?: string;
+
     /**
-     * 语言代码，默认自动检测
+     * 技术栈链接
      */
-    lang?: string;
+    techStackLink?: string;
+
     /**
-     * 是否启用日志输出
-     * @default false
+     * 条款链接
      */
-    enableLogging?: boolean;
-} 
+    termsLink?: string;
+}

package/dist/types/header.ts

@@ -0,0 +1,70 @@
+export interface HeaderProps {
+    /**
+     * 基础路径，用于处理网站部署在二级目录的情况
+     * @default ""
+     */
+    basePath?: string;
+
+    /**
+     * 当前语言代码
+     */
+    currentLocale?: string;
+
+    /**
+     * 侧边栏是否默认展开
+     * @default false
+     */
+    defaultSidebarOpen?: boolean;
+
+    /**
+     * 导航栏高度
+     * @default "md"
+     */
+    height?: '3xs' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+
+    /**
+     * 语言选项列表
+     */
+    languages?: Array<{ code: string; name: string }>;
+
+    /**
+     * Logo图片元数据
+     */
+    logo: ImageMetadata;
+
+    /**
+     * Logo 链接地址
+     * @default "/"
+     */
+    logoHref?: string;
+
+    /**
+     * 导航菜单项
+     */
+    navItems?: Array<{
+        href: string;
+        label: string;
+        match: (path: string) => boolean;
+    }>;
+
+    /**
+     * 是否显示侧边栏切换按钮
+     * @default false
+     */
+    showSidebarToggle?: boolean;
+
+    /**
+     * 社交链接
+     */
+    socialLinks?: Array<{
+        name: string;
+        url: string;
+        icon: any;
+    }>;
+
+    /**
+     * 是否固定在顶部
+     * @default true
+     */
+    sticky?: boolean;
+}

package/dist/types/layout.ts

@@ -1,10 +1,71 @@
-export interface SidebarItem {
-    href: string;
-    text: string;
-    items?: SidebarItem[];
-}
-
-export interface SidebarSection {
-    title: string;
-    items: SidebarItem[];
-}
+import type { FooterProps } from "./footer";
+import type { HeaderProps } from "./header";
+import type { MainContentProps } from "./main";
+import type { MetaProps } from "./meta";
+import type { SidebarProps } from "./sidebar";
+
+export interface AppLayoutProps {
+    /**
+     * 是否显示侧边栏
+     * @default true
+     */
+    showSidebar?: boolean;
+
+    /**
+     * 是否显示页眉
+     * @default true
+     */
+    showHeader?: boolean;
+
+    /**
+     * 是否显示页脚
+     * @default true
+     */
+    showFooter?: boolean;
+
+    /**
+     * 自定义头部内容
+     */
+    head?: astroHTML.JSX.Element;
+
+    /**
+     * 自定义头部内容
+     */
+    headerConfig: HeaderProps;
+
+    /**
+     * 侧边栏配置
+     */
+    sidebarConfig: SidebarProps;
+
+    /**
+     * 主内容配置
+     */
+    mainContentConfig: MainContentProps;
+
+    /**
+     * 页面类名
+     */
+    class?: string;
+
+    /**
+     * 类名列表
+     */
+    'class:list'?: any;
+
+    /**
+     * 调试模式，显示各个部分的边框
+     * @default false
+     */
+    debug?: boolean;
+
+    /**
+     * 元数据配置
+     */
+    metaConfig: MetaProps;
+
+    /**
+     * 页脚相关配置
+     */
+    footerConfig: FooterProps;
+}

package/dist/types/main.ts

@@ -0,0 +1,69 @@
+export interface MainContentProps {
+    /**
+     * 容器大小
+     * @default "md"
+     */
+    size?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+
+    /**
+     * 水平内边距（通过 Container 组件的 padding 属性设置）
+     * @default "md"
+     */
+    padding?: 'none' | 'sm' | 'md' | 'lg' | 'xl';
+
+    /**
+   * 布局方式
+   * @default 'column'
+   */
+    layout?: 'row' | 'column';
+
+    /**
+     * 当前语言
+     */
+    currentLocale?: string;
+
+    /**
+     * 垂直内边距
+     * @default "md"
+     */
+    verticalPadding?: 'none' | 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | string;
+
+    /**
+     * 是否居中显示内容
+     * @default true
+     */
+    centered?: boolean;
+
+    /**
+     * 是否为文章布局
+     * @default false
+     */
+    isArticle?: boolean;
+
+    /**
+     * 是否显示目录
+     * @default false
+     */
+    showTableOfContents?: boolean;
+
+    /**
+     * 背景颜色
+     * @default undefined
+     */
+    backgroundColor?: 'primary' | 'secondary' | 'tertiary' | 'light' | 'dark' | string;
+
+    /**
+     * HTML id 属性
+     */
+    id?: string;
+
+    /**
+     * 类名
+     */
+    class?: string;
+
+    /**
+     * 类名列表
+     */
+    'class:list'?: any;
+}

package/dist/types/meta.ts

@@ -0,0 +1,50 @@
+export interface MetaProps {
+    title: string;
+    description: string;
+    keywords: string;
+    author: string;
+    robots: string;
+
+    /**
+     * 基础路径，用于处理网站部署在二级目录的情况
+     * @default ""
+     */
+    basePath?: string;
+
+    /**
+     * 站点名称
+     */
+    siteName?: string;
+
+    /**
+     * 页面语言
+     * @default "zh-CN"
+     */
+    lang?: string;
+
+    /**
+     * 是否包含视口元标签
+     * @default true
+     */
+    viewport?: boolean;
+
+    /**
+     * 自定义CSS
+     */
+    customStyles?: string;
+
+    /**
+     * 自定义头部内容
+     */
+    head?: astroHTML.JSX.Element;
+
+    /**
+     * 页面类名
+     */
+    class?: string;
+
+    /**
+     * 类名列表
+     */
+    'class:list'?: any;
+}

package/dist/types/sidebar.ts

@@ -0,0 +1,38 @@
+export interface SidebarItem {
+    href: string;
+    text: string;
+    items?: SidebarItem[];
+}
+
+export interface SidebarSection {
+    title: string;
+    items: SidebarItem[];
+}
+
+export interface SidebarProps {
+    /**
+     * 侧边栏项目
+     */
+    sidebarItems: SidebarSection[];
+
+    /**
+     * 桌面端类名
+     */
+    class?: string;
+
+    /**
+     * 是否开启调试模式，显示边框
+     * @default false
+     */
+    debug?: boolean;
+
+    /**
+     * 侧边栏顶部外边距
+     */
+    marginTop?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | string;
+
+    /**
+     * 侧边栏底部外边距
+     */
+    marginBottom?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl' | '4xl' | '5xl' | string;
+}

package/dist/utils/language.ts

@@ -5,7 +5,7 @@
  */
 
 // 支持的语言列表
-export const SUPPORTED_LANGUAGES = ['en', 'zh-cn'] as const;
+export const SUPPORTED_LANGUAGES = ['en', 'zh-cn', 'zh'] as const;
 export type SupportedLanguage = typeof SUPPORTED_LANGUAGES[number];
 
 // 语言来源枚举
@@ -49,21 +49,34 @@ export function getValidLanguage(lang?: string): SupportedLanguage {
 
 /**
  * 从URL中提取语言代码
+ * @param url 当前URL（可选）
  * @returns 从URL中提取的语言代码，如果无法提取则返回undefined
  */
-function getLanguageFromURL(): string | undefined {
-    if (typeof window === 'undefined') return undefined;
+function getLanguageFromURL(url?: string): string | undefined {
+    let currentUrl = url;
+
+    if (currentUrl === undefined) {
+        if (typeof window === 'undefined') return undefined;
+        currentUrl = window.location.href;
+    }
 
     // 尝试从路径中提取语言代码
     // 例如: /zh-cn/components/button
-    const pathMatch = window.location.pathname.match(/^\/([\w-]+)\//);
+    const pathMatch = currentUrl.match(/^\/([\w-]+)\//);
     if (pathMatch && isLanguageSupported(pathMatch[1])) {
         return pathMatch[1];
     }
 
+    // 如果网站运行在二级目录，则从路径中提取语言代码
+    // 例如: /docs/zh-cn/components/button
+    const pathMatch2 = currentUrl.match(/^\/([^\/]+)\/([\w-]+)\//);
+    if (pathMatch2 && isLanguageSupported(pathMatch2[2])) {
+        return pathMatch2[2];
+    }
+
     // 尝试从查询参数中提取语言代码
     // 例如: ?lang=zh-cn
-    const urlParams = new URLSearchParams(window.location.search);
+    const urlParams = new URLSearchParams(currentUrl.split('?')[1]);
     const langParam = urlParams.get('lang');
     if (langParam && isLanguageSupported(langParam)) {
         return langParam;
@@ -101,11 +114,12 @@ function getLanguageFromBrowser(): string | undefined {
 
 /**
  * 自动检测当前语言
+ * @param url 当前URL（可选）
  * @returns 检测到的语言信息，包括语言代码和来源
  */
-export function detectLanguage(): LanguageInfo {
+function detectLanguage(url?: string): LanguageInfo {
     // 尝试从URL中获取语言
-    const urlLang = getLanguageFromURL();
+    const urlLang = getLanguageFromURL(url);
     if (urlLang) {
         return {
             code: urlLang as SupportedLanguage,
@@ -132,9 +146,10 @@ export function detectLanguage(): LanguageInfo {
 /**
  * 获取当前语言
  * @param userLang 用户指定的语言（可选）
+ * @param url 当前URL（可选）
  * @returns 当前应使用的语言信息，包括语言代码和来源
  */
-export function getCurrentLanguage(userLang?: string): LanguageInfo {
+export function getCurrentLanguage(userLang?: string, url?: string): LanguageInfo {
     // 如果用户指定了语言，优先使用用户指定的语言
     if (userLang) {
         if (isLanguageSupported(userLang)) {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@coffic/cosy-ui",
-    "version": "0.3.67",
+    "version": "0.4.3",
     "description": "An astro component library",
     "author": {
         "name": "nookery",
@@ -17,7 +17,7 @@
         "astro",
         "cosy-ui"
     ],
-    "homepage": "https://github.com/CofficLab/cosy-ui",
+    "homepage": "https://cofficlab.github.io/cosy-ui/en/",
     "publishConfig": {
         "access": "public"
     },