@coffic/cosy-ui 0.8.29 → 0.9.2

package/dist/src/utils/i18n.ts

@@ -1,9 +1,3 @@
-/**
- * 国际化文本配置
- *
- * 提供组件的多语言文本内容
- */
-
 // 定义文本内容的类型
 type TextContent = Record<string, Record<string, string>>;
 

package/dist/src/utils/language.ts

@@ -1,6 +1,4 @@
-import { getRelativeLocaleUrl } from 'astro:i18n';
 import type { AstroGlobal } from 'astro';
-import { cosyLogger } from '../../src-astro/cosy';
 
 // 默认语言
 export const DEFAULT_LANGUAGE = 'en';
@@ -11,111 +9,92 @@ export const DEFAULT_LANGUAGE = 'en';
  * 提供语言相关的工具函数，用于多语言支持
  */
 export class LanguageUtil {
-  static getRelativeLink(locale: string, astro: AstroGlobal): string {
-    const debug = false;
-    const currentLocale = astro.currentLocale;
-    const originalPath = astro.originPathname;
-    const result = getRelativeLocaleUrl(
-      locale,
-      originalPath.replaceAll('/' + currentLocale, '')
-    );
-
-    if (debug) {
-      cosyLogger.debug(
-        `getRelativeLink: locale=${locale}, currentPath=${originalPath}, currentLocale=${currentLocale}, result=${result}`
-      );
-    }
-
-    return result;
-  }
-
-  static getLanguageName(code: string | undefined): string {
-    switch (code) {
-      case 'en':
-        return 'English';
-      case 'zh-cn':
-        return '简体中文';
-      case 'zh':
-        return '中文';
-      case undefined:
-      default:
-        return 'not known';
+    static getLanguageName(code: string | undefined): string {
+        switch (code) {
+            case 'en':
+                return 'English';
+            case 'zh-cn':
+                return '简体中文';
+            case 'zh':
+                return '中文';
+            default:
+                return code || 'not known';
+        }
     }
-  }
 
-  /**
-   * 获取当前语言
-   * @param astro Astro全局对象
-   * @returns 当前应使用的语言代码
-   */
-  static getCurrentLanguage(astro: AstroGlobal): string {
-    // 尝试从Astro全局对象中获取语言
-    const astroLang = astro.currentLocale;
-    if (astroLang) {
-      return astroLang;
-    }
-    // 尝试从URL中获取语言
-    const urlLang = this.getLanguageFromURL(astro.url.pathname);
-    if (urlLang) {
-      return urlLang;
-    }
-
-    // 尝试从浏览器设置中获取语言
-    const browserLang = this.getLanguageFromBrowser();
-    if (browserLang) {
-      return browserLang;
+    /**
+     * 获取当前语言
+     * @param astro Astro全局对象
+     * @returns 当前应使用的语言代码
+     */
+    static getCurrentLanguage(astro: AstroGlobal): string {
+        // 尝试从Astro全局对象中获取语言
+        const astroLang = astro.currentLocale;
+        if (astroLang) {
+            return astroLang;
+        }
+        // 尝试从URL中获取语言
+        const urlLang = this.getLanguageFromURL(astro.url.pathname);
+        if (urlLang) {
+            return urlLang;
+        }
+
+        // 尝试从浏览器设置中获取语言
+        const browserLang = this.getLanguageFromBrowser();
+        if (browserLang) {
+            return browserLang;
+        }
+
+        // 尝试从Astro全局对象中获取语言
+        const preferredLocale = astro.preferredLocale;
+        if (preferredLocale) {
+            return preferredLocale;
+        }
+
+        // 如果无法检测，返回默认语言
+        return DEFAULT_LANGUAGE;
     }
 
-    // 尝试从Astro全局对象中获取语言
-    const preferredLocale = astro.preferredLocale;
-    if (preferredLocale) {
-      return preferredLocale;
+    /**
+     * 从URL中提取语言代码
+     * @param url 当前URL
+     * @returns 从URL中提取的语言代码，如果无法提取则返回undefined
+     */
+    private static 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 = currentUrl.match(/^\/([\w-]+)\//);
+        if (pathMatch) {
+            return pathMatch[1];
+        }
+
+        // 尝试从查询参数中提取语言代码
+        // 例如: ?lang=zh-cn
+        const urlParams = new URLSearchParams(currentUrl.split('?')[1]);
+        const langParam = urlParams.get('lang');
+        if (langParam) {
+            return langParam;
+        }
+
+        return undefined;
     }
 
-    // 如果无法检测，返回默认语言
-    return DEFAULT_LANGUAGE;
-  }
-
-  /**
-   * 从URL中提取语言代码
-   * @param url 当前URL
-   * @returns 从URL中提取的语言代码，如果无法提取则返回undefined
-   */
-  private static getLanguageFromURL(url: string): string | undefined {
-    let currentUrl = url;
+    /**
+     * 从浏览器设置中获取首选语言
+     * @returns 从浏览器设置中获取的语言代码，如果无法获取则返回undefined
+     */
+    private static getLanguageFromBrowser(): string | undefined {
+        if (typeof navigator === 'undefined') return undefined;
 
-    if (currentUrl === undefined) {
-      if (typeof window === 'undefined') return undefined;
-      currentUrl = window.location.href;
+        // 获取浏览器语言
+        const browserLang = navigator.language.toLowerCase();
+        return browserLang;
     }
-
-    // 尝试从路径中提取语言代码
-    // 例如: /zh-cn/components/button
-    const pathMatch = currentUrl.match(/^\/([\w-]+)\//);
-    if (pathMatch) {
-      return pathMatch[1];
-    }
-
-    // 尝试从查询参数中提取语言代码
-    // 例如: ?lang=zh-cn
-    const urlParams = new URLSearchParams(currentUrl.split('?')[1]);
-    const langParam = urlParams.get('lang');
-    if (langParam) {
-      return langParam;
-    }
-
-    return undefined;
-  }
-
-  /**
-   * 从浏览器设置中获取首选语言
-   * @returns 从浏览器设置中获取的语言代码，如果无法获取则返回undefined
-   */
-  private static getLanguageFromBrowser(): string | undefined {
-    if (typeof navigator === 'undefined') return undefined;
-
-    // 获取浏览器语言
-    const browserLang = navigator.language.toLowerCase();
-    return browserLang;
-  }
 }

package/dist/src-astro/header/Header.astro

@@ -12,17 +12,34 @@
  * 2. 响应式适配 - 在移动端和桌面端都有合适的展现形式
  * 3. 可定制性 - 支持多种配置选项，适应不同网站的风格和需求
  * 4. 多语言支持 - 内置语言切换功能，便于构建国际化网站
+ *
+ * @usage
+ * 基本用法：
+ * ```astro
+ * <Header />
+ * ```
+ *
+ * 启用语言切换功能：
+ * ```astro
+ * ---
+ * import * as astroI18n from 'astro:i18n';
+ * ---
+ * <Header astroI18n={astroI18n} />
+ * ```
+ *
+ * @props
+ * - astroI18n - 完整的 astro:i18n 模块（启用语言切换时需要）
  */
 import {
+  Image,
   LanguageSwitcher,
+  Link,
   LinkUtil,
   type IHeaderProps,
   type INavItem,
   NavItems,
-  Link,
-  Image,
   ThemeSwitcher,
-} from '@coffic/cosy-ui';
+} from '../../index-astro';
 import Logo from '../../src/assets/logo-rounded.png';
 
 export interface Props extends IHeaderProps {
@@ -31,7 +48,6 @@ export interface Props extends IHeaderProps {
 
 const {
   height = 'md',
-  languages = ['zh-cn', 'en'],
   logo = Logo,
   logoHref = '/',
   navItems = [],
@@ -42,6 +58,7 @@ const {
   paddingVertical = 'none',
   navPosition = 'center',
   showThemeSwitcher = true,
+  astroI18n,
 } = Astro.props;
 
 // 根据高度设置样式
@@ -79,6 +96,10 @@ const logoSizeClasses = {
 
 const logoSizeClass = logoSizeClasses[height];
 const linkHeightClass = linkHeightClasses[height];
+
+// 检查 i18n 是否启用，通过 Astro.currentLocale 来判断
+let isI18nEnabled = Astro.currentLocale !== undefined;
+
 const currentPath = Astro.url.pathname;
 const activeLink = LinkUtil.getActiveLink(
   currentPath,
@@ -200,7 +221,7 @@ const activeLink = LinkUtil.getActiveLink(
       }
 
       {showThemeSwitcher && <ThemeSwitcher />}
-      {languages.length > 1 && <LanguageSwitcher languages={languages} />}
+      {isI18nEnabled && <LanguageSwitcher astroI18n={astroI18n} />}
 
       <slot name="navbar-end" />
     </div>

package/dist/src-astro/language-switcher/LanguageSwitcher.astro

@@ -14,55 +14,84 @@
  * 4. 一致的视觉风格 - 使用与整体设计系统一致的下拉菜单样式
  *
  * @usage
- * 基本用法：
+ * 基本用法（需要用户传入 astro:i18n 模块）：
  * ```astro
- * <LanguageSwitcher />
+ * ---
+ * import * as astroI18n from 'astro:i18n';
+ * ---
+ * <LanguageSwitcher astroI18n={astroI18n} />
  * ```
  *
- * 自定义语言列表：
- * ```astro
- * <LanguageSwitcher
- *   languages={['zh-cn', 'en']}
- * />
- * ```
+ * @props
+ * - astroI18n - 完整的 astro:i18n 模块
+ * - class - 自定义CSS类名
  */
 
-import { ChevronDownIcon, LanguageUtil } from '../../index-astro';
+import { ChevronDownIcon, Link, ListItem } from '../../index-astro';
+import {
+  checkSwitcherRenderState,
+  generateSwitcherLinks,
+  type SwitcherLink,
+} from './switcher_util';
 import '../../style.ts';
 
 interface Props {
-  languages: string[];
+  /**
+   * 完整的 astro:i18n 模块
+   */
+  astroI18n?: any;
+
   /**
    * 自定义类名
    */
   class?: string;
 }
 
-const { languages = ['zh-cn', 'en'], class: className = '' } = Astro.props;
+const { astroI18n, class: className = '' } = Astro.props;
+
+// 检查渲染状态
+const renderState = checkSwitcherRenderState(Astro.currentLocale, astroI18n);
 
-const currentLocale = Astro.currentLocale;
-const currentLanguageName = LanguageUtil.getLanguageName(currentLocale);
+// 输出警告信息
+if (renderState.warnings) {
+  renderState.warnings.forEach((warning) => console.warn(warning));
+}
+
+let links: SwitcherLink[] = [];
+
+// 如果应该渲染，生成切换链接
+if (renderState.shouldRender && Astro.currentLocale) {
+  try {
+    links = generateSwitcherLinks(
+      astroI18n,
+      Astro.currentLocale,
+      Astro.url.pathname
+    );
+  } catch (error) {
+    // 如果生成链接失败，设置为不渲染
+    renderState.shouldRender = false;
+  }
+}
 ---
 
-<!-- 语言切换按钮 -->
-<div class={`cosy:dropdown cosy:dropdown-end ${className}`}>
-  <div tabindex="0" role="button" class:list={['cosy:btn cosy:btn-ghost']}>
-    <span class="cosy:mr-1">{currentLanguageName}</span>
-    <ChevronDownIcon size="16px" class="cosy:w-4 cosy:h-4" />
-  </div>
-  <ul
-    tabindex="0"
-    class="cosy:z-[1] cosy:bg-base-100 cosy:shadow cosy:p-2 cosy:rounded-box cosy:w-32 cosy:dropdown-content cosy:menu">
-    {
-      languages.map((lang) => (
-        <li class={currentLocale === lang ? 'cosy:disabled' : ''}>
-          <a
-            href={LanguageUtil.getRelativeLink(lang, Astro)}
-            class={currentLocale === lang ? 'cosy:active' : ''}>
-            {LanguageUtil.getLanguageName(lang)}
-          </a>
-        </li>
-      ))
-    }
-  </ul>
-</div>
+{
+  renderState.shouldRender && (
+    <div class={`cosy:dropdown cosy:dropdown-end ${className}`}>
+      <div tabindex="0" role="button" class:list={['cosy:btn cosy:btn-ghost']}>
+        <span class="cosy:mr-1">{renderState.currentLanguageName}</span>
+        <ChevronDownIcon size="16px" class="cosy:w-4 cosy:h-4" />
+      </div>
+      <ul
+        tabindex="0"
+        class="cosy:z-[1] cosy:bg-base-100 cosy:shadow cosy:p-2 cosy:rounded-box cosy:w-32 cosy:dropdown-content cosy:menu">
+        {links.map((link) => (
+          <ListItem>
+            <Link href={link.url} active={Astro.currentLocale === link.locale}>
+              {link.name}
+            </Link>
+          </ListItem>
+        ))}
+      </ul>
+    </div>
+  )
+}

package/dist/src-astro/language-switcher/index.ts

@@ -1,11 +1,3 @@
 import LanguageSwitcher from './LanguageSwitcher.astro';
-import LanguageSwitcherBasic from './LanguageSwitcherBasic.astro';
-import BasicSourceCode from './LanguageSwitcherBasic.astro?raw';
-import { extractSimpleExample } from '../../src/utils/component';
 
-export { LanguageSwitcher, LanguageSwitcherBasic };
-
-// 导出示例源代码
-export const LanguageSwitcherExampleCodes = {
-  Basic: extractSimpleExample(BasicSourceCode, 'LanguageSwitcher'),
-};
+export { LanguageSwitcher };

package/dist/src-astro/language-switcher/switcher_util.ts

@@ -0,0 +1,84 @@
+import { LanguageUtil } from "../../src/utils/language"
+
+export interface SwitcherLink {
+    locale: string;
+    name: string;
+    url: string;
+}
+
+/**
+ * 获取基础 URL
+ */
+export const getBaseUrl = (): string => {
+    return import.meta.env.BASE_URL || '/';
+};
+
+/**
+ * 从 URL 中提取语言代码
+ */
+export const getLocaleFromUrl = (url: string): string => {
+    return url.replace(getBaseUrl(), '').split('/')[0];
+};
+
+/**
+ * 生成语言切换链接
+ * @param astroI18n - astro:i18n 模块
+ * @param currentLocale - 当前语言代码
+ * @param pathname - 当前页面路径
+ * @returns 语言切换链接数组
+ */
+export const generateSwitcherLinks = (
+    astroI18n: any,
+    currentLocale: string,
+    pathname: string
+): SwitcherLink[] => {
+    try {
+        const { getRelativeLocaleUrl, getRelativeLocaleUrlList } = astroI18n;
+
+        const currentLocalURLPrefix = getRelativeLocaleUrl(currentLocale, '');
+        const pathWithSlash = pathname + '/';
+        const slug = pathWithSlash.replace(currentLocalURLPrefix, '');
+        const urls = getRelativeLocaleUrlList(slug);
+
+        return urls.map((url: string) => ({
+            locale: getLocaleFromUrl(url),
+            name: LanguageUtil.getLanguageName(getLocaleFromUrl(url)),
+            url: url,
+        }));
+    } catch (error) {
+        console.warn('LanguageSwitcher: Error generating switcher links:', error);
+        throw error;
+    }
+};
+
+/**
+ * 检查语言切换器是否应该渲染
+ * @param currentLocale - 当前语言代码
+ * @param astroI18n - astro:i18n 模块
+ * @returns 是否应该渲染的状态信息
+ */
+export const checkSwitcherRenderState = (
+    currentLocale: string | undefined,
+    astroI18n: any
+): {
+    shouldRender: boolean;
+    currentLanguageName?: string;
+    warnings?: string[];
+} => {
+    const warnings: string[] = [];
+
+    if (!currentLocale) {
+        warnings.push('LanguageSwitcher: i18n is not enabled in the current project');
+        return { shouldRender: false, warnings };
+    }
+
+    if (!astroI18n) {
+        warnings.push('LanguageSwitcher: astroI18n module is required. Please pass the astro:i18n module as a prop.');
+        return { shouldRender: false, warnings };
+    }
+
+    return {
+        shouldRender: true,
+        currentLanguageName: LanguageUtil.getLanguageName(currentLocale),
+    };
+};

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

@@ -115,7 +115,7 @@ const hrefToIconMap: Record<string, string> = {
  */
 export function getIconFromHref(href: string, fallbackIcon: string = 'folder'): string {
     // 将 href 转换为小写并移除路径分隔符
-    const normalizedHref = href.toLowerCase().replace(/[\/\-_]/g, '');
+    const normalizedHref = href.toLowerCase().replace(/[/\-_]/g, '');
 
     // 遍历映射表，找到匹配的关键词
     for (const [keyword, iconName] of Object.entries(hrefToIconMap)) {

package/dist/src-astro/link/Link.astro

@@ -100,6 +100,7 @@ interface Props extends HTMLAttributes<'a'> {
     | 'warning'
     | 'error';
   align?: 'left' | 'center' | 'right';
+  active?: boolean;
 }
 
 const {
@@ -121,6 +122,7 @@ const {
   fullWidth = false,
   color,
   align,
+  active = false,
   ...rest
 } = Astro.props;
 
@@ -159,7 +161,10 @@ const classes = [
   animation === 'hover-scale' &&
     'cosy:hover:scale-105 cosy:transition-transform',
 
-  // 新增：按钮风格
+  // Active state
+  active && 'cosy:active',
+
+  // 按钮风格
   btn && 'cosy:btn',
   btn && size === 'sm' && 'cosy:btn-sm',
   btn && size === 'lg' && 'cosy:btn-lg',

package/dist/src-astro/list/ListItem.astro

@@ -1,10 +1,35 @@
 ---
 /**
  * @component ListItem
- * @description List item component with loading animations
- * @props loading?: boolean
- * @props duration?: number
- * @props animationType?: string
+ *
+ * @description
+ * ListItem 组件用于在列表中显示单个项目。它内置了多种加载动画效果，可以方便地通过 `loading` 属性来控制加载状态，并通过 `loadingAnimationType` 属性切换不同的加载Loading动画样式。
+ *
+ * @usage
+ * 基本用法：
+ * ```astro
+ * <ListItem>这是一个列表项</ListItem>
+ * ```
+ *
+ * 加载状态：
+ * ```astro
+ * <ListItem loading={true}>加载中的列表项</ListItem>
+ * ```
+ *
+ * 指定加载动画类型：
+ * ```astro
+ * <ListItem loading={true} loadingAnimationType="pulse">使用脉冲动画加载</ListItem>
+ * <ListItem loading={true} loadingAnimationType="icon-left">使用左侧图标动画加载</ListItem>
+ * ```
+ *
+ * @props
+ * @prop {string} [class] - 自定义 CSS 类名。
+ * @prop {boolean} [loading=false] - 控制是否显示加载动画。
+ * @prop {number} [duration] - 动画的持续时间（单位：毫秒）。
+ * @prop {('none'|'ring'|'icon-left'|'icon-right'|'breath'|'pulse'|'glow')} [loadingAnimationType='none'] - 加载动画的类型。
+ *
+ * @slots
+ * @slot default - 列表项的内容。
  */
 import '../../style.ts';
 import ListItemRing from './ListItemRing.astro';
@@ -14,16 +39,38 @@ import ListItemBreath from './ListItemBreath.astro';
 import ListItemPulse from './ListItemPulse.astro';
 import ListItemGlow from './ListItemGlow.astro';
 
+interface Props {
+  class?: string;
+  loading?: boolean;
+  duration?: number;
+  loadingAnimationType?:
+    | 'none'
+    | 'ring'
+    | 'icon-left'
+    | 'icon-right'
+    | 'breath'
+    | 'pulse'
+    | 'glow';
+}
+
 const {
   loading = false,
   duration,
-  animationType = 'ring',
+  loadingAnimationType = 'none',
   ...restProps
 } = Astro.props;
 ---
 
 {
-  animationType === 'ring' && (
+  loadingAnimationType === 'none' && (
+    <li {...restProps}>
+      <slot />
+    </li>
+  )
+}
+
+{
+  loadingAnimationType === 'ring' && (
     <ListItemRing loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemRing>
@@ -31,7 +78,7 @@ const {
 }
 
 {
-  animationType === 'icon-left' && (
+  loadingAnimationType === 'icon-left' && (
     <ListItemIconLeft loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemIconLeft>
@@ -39,7 +86,7 @@ const {
 }
 
 {
-  animationType === 'icon-right' && (
+  loadingAnimationType === 'icon-right' && (
     <ListItemIconRight loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemIconRight>
@@ -47,7 +94,7 @@ const {
 }
 
 {
-  animationType === 'breath' && (
+  loadingAnimationType === 'breath' && (
     <ListItemBreath loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemBreath>
@@ -55,7 +102,7 @@ const {
 }
 
 {
-  animationType === 'pulse' && (
+  loadingAnimationType === 'pulse' && (
     <ListItemPulse loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemPulse>
@@ -63,7 +110,7 @@ const {
 }
 
 {
-  animationType === 'glow' && (
+  loadingAnimationType === 'glow' && (
     <ListItemGlow loading={loading} duration={duration} {...restProps}>
       <slot />
     </ListItemGlow>

package/dist/src-astro/types/header.ts

@@ -1,87 +1,88 @@
 import type { INavItem } from './nav';
+import type { ImageMetadata } from 'astro';
 
 export interface IHeaderProps {
-  /**
-   * 侧边栏是否默认展开
-   * @default false
-   */
-  defaultSidebarOpen?: boolean;
+    /**
+     * 侧边栏是否默认展开
+     * @default false
+     */
+    defaultSidebarOpen?: boolean;
 
-  /**
-   * 导航栏高度
-   * @default "md"
-   */
-  height?: '3xs' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * 完整的 astro:i18n 模块（启用语言切换时需要）
+     */
+    astroI18n?: any;
 
-  /**
-   * 语言选项列表
-   */
-  languages?: string[];
+    /**
+     * 导航栏高度
+     * @default "md"
+     */
+    height?: '3xs' | '2xs' | 'xs' | 'sm' | 'md' | 'lg' | 'xl';
 
-  /**
-   * Logo图片元数据
-   */
-  logo?: ImageMetadata;
+    /**
+     * Logo图片元数据
+     */
+    logo?: ImageMetadata;
 
-  /**
-   * Logo 链接地址
-   * @default "/"
-   */
-  logoHref?: string;
+    /**
+     * Logo 链接地址
+     * @default "/"
+     */
+    logoHref?: string;
 
-  /**
-   * 导航菜单项
-   */
-  navItems?: INavItem[];
+    /**
+     * 导航菜单项
+     */
+    navItems?: INavItem[];
 
-  /**
-   * 导航栏位置
-   * @default "start"
-   */
-  navPosition?: 'start' | 'center' | 'end';
+    /**
+     * 导航栏位置
+     * @default "start"
+     */
+    navPosition?: 'start' | 'center' | 'end';
 
-  /**
-   * 水平内边距
-   * @default "md"
-   */
-  paddingHorizontal?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
+    /**
+     * 水平内边距
+     * @default "md"
+     */
+    paddingHorizontal?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 
-  /**
-   * 垂直内边距
-   * @default "md"
-   */
-  paddingVertical?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
+    /**
+     * 垂直内边距
+     * @default "md"
+     */
+    paddingVertical?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | '2xl' | '3xl';
 
-  /**
-   * 圆角大小
-   * @default "md"
-   */
-  rounded?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
+    /**
+     * 圆角大小
+     * @default "md"
+     */
+    rounded?: 'none' | 'sm' | 'md' | 'lg' | 'xl' | 'full';
 
-  /**
-   * 是否显示侧边栏切换按钮
-   * @default false
-   */
-  showSidebarToggle?: boolean;
+    /**
+     * 是否显示侧边栏切换按钮
+     * @default false
+     */
+    showSidebarToggle?: boolean;
 
-  /**
-   * 是否显示主题切换按钮
-   * @default false
-   */
-  showThemeSwitcher?: boolean;
+    /**
+     * 是否显示主题切换按钮
+     * @default false
+     */
+    showThemeSwitcher?: boolean;
 
-  /**
-   * 社交媒体链接列表
-   */
-  socialLinks?: Array<{
-    name: string;
-    url: string;
-    icon: any;
-  }>;
+    /**
+     * 社交媒体链接列表
+     */
+    socialLinks?: Array<{
+        name: string;
+        url: string;
+        icon: any;
+    }>;
 
-  /**
-   * 是否固定在顶部
-   * @default true
-   */
-  sticky?: boolean;
+    /**
+     * 是否固定在顶部
+     * @default true
+     */
+    sticky?: boolean;
 }

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

@@ -5,67 +5,67 @@ import type { IMetaProps } from './meta';
 import type { ISidebarProps } from './sidebar';
 
 export interface IAppLayoutProps {
-  /**
-   * 是否显示侧边栏
-   * @default true
-   */
-  showSidebar?: boolean;
+    /**
+     * 是否显示侧边栏
+     * @default true
+     */
+    showSidebar?: boolean;
 
-  /**
-   * 是否显示页眉
-   * @default true
-   */
-  showHeader?: boolean;
+    /**
+     * 是否显示页眉
+     * @default true
+     */
+    showHeader?: boolean;
 
-  /**
-   * 是否显示页脚
-   * @default true
-   */
-  showFooter?: boolean;
+    /**
+     * 是否显示页脚
+     * @default true
+     */
+    showFooter?: boolean;
 
-  /**
-   * 自定义头部内容
-   */
-  head?: astroHTML.JSX.Element;
+    /**
+     * 自定义头部内容
+     */
+    head?: any;
 
-  /**
-   * 自定义头部内容
-   */
-  headerConfig: IHeaderProps;
+    /**
+     * 自定义头部内容
+     */
+    headerConfig: IHeaderProps;
 
-  /**
-   * 侧边栏配置
-   */
-  sidebarConfig: ISidebarProps;
+    /**
+     * 侧边栏配置
+     */
+    sidebarConfig: ISidebarProps;
 
-  /**
-   * 主内容配置
-   */
-  mainContentConfig: IMainContentProps;
+    /**
+     * 主内容配置
+     */
+    mainContentConfig: IMainContentProps;
 
-  /**
-   * 页面类名
-   */
-  class?: string;
+    /**
+     * 页面类名
+     */
+    class?: string;
 
-  /**
-   * 类名列表
-   */
-  'class:list'?: any;
+    /**
+     * 类名列表
+     */
+    'class:list'?: any;
 
-  /**
-   * 调试模式，显示各个部分的边框
-   * @default false
-   */
-  debug?: boolean;
+    /**
+     * 调试模式，显示各个部分的边框
+     * @default false
+     */
+    debug?: boolean;
 
-  /**
-   * 元数据配置
-   */
-  metaConfig: IMetaProps;
+    /**
+     * 元数据配置
+     */
+    metaConfig: IMetaProps;
 
-  /**
-   * 页脚相关配置
-   */
-  footerConfig: IFooterProps;
+    /**
+     * 页脚相关配置
+     */
+    footerConfig: IFooterProps;
 }

package/dist/src-astro/types/meta.ts

@@ -1,3 +1,5 @@
+import type { ImageMetadata } from 'astro';
+
 export interface IMetaProps {
     title: string;
     description: string;
@@ -41,7 +43,7 @@ export interface IMetaProps {
     /**
      * 自定义头部内容
      */
-    head?: astroHTML.JSX.Element;
+    head?: any;
 
     /**
      * 页面类名

package/package.json

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

package/dist/src-astro/language-switcher/LanguageSwitcherBasic.astro

@@ -1,7 +0,0 @@
----
-import LanguageSwitcher from './LanguageSwitcher.astro';
----
-
-<div class="cosy:flex cosy:justify-center">
-  <LanguageSwitcher languages={['zh-cn', 'en']} />
-</div>

package/dist/src-vue/utils/language.ts

@@ -1,121 +0,0 @@
-import { getRelativeLocaleUrl } from 'astro:i18n';
-import type { AstroGlobal } from 'astro';
-import { cosyLogger } from '../cosy';
-
-// 默认语言
-export const DEFAULT_LANGUAGE = 'en';
-
-/**
- * 语言工具模块
- *
- * 提供语言相关的工具函数，用于多语言支持
- */
-export class LanguageUtil {
-  static getRelativeLink(locale: string, astro: AstroGlobal): string {
-    const debug = false;
-    const currentLocale = astro.currentLocale;
-    const originalPath = astro.originPathname;
-    const result = getRelativeLocaleUrl(
-      locale,
-      originalPath.replaceAll('/' + currentLocale, '')
-    );
-
-    if (debug) {
-      cosyLogger.debug(
-        `getRelativeLink: locale=${locale}, currentPath=${originalPath}, currentLocale=${currentLocale}, result=${result}`
-      );
-    }
-
-    return result;
-  }
-
-  static getLanguageName(code: string | undefined): string {
-    switch (code) {
-      case 'en':
-        return 'English';
-      case 'zh-cn':
-        return '简体中文';
-      case 'zh':
-        return '中文';
-      case undefined:
-      default:
-        return 'not known';
-    }
-  }
-
-  /**
-   * 获取当前语言
-   * @param astro Astro全局对象
-   * @returns 当前应使用的语言代码
-   */
-  static getCurrentLanguage(astro: AstroGlobal): string {
-    // 尝试从Astro全局对象中获取语言
-    const astroLang = astro.currentLocale;
-    if (astroLang) {
-      return astroLang;
-    }
-    // 尝试从URL中获取语言
-    const urlLang = this.getLanguageFromURL(astro.url.pathname);
-    if (urlLang) {
-      return urlLang;
-    }
-
-    // 尝试从浏览器设置中获取语言
-    const browserLang = this.getLanguageFromBrowser();
-    if (browserLang) {
-      return browserLang;
-    }
-
-    // 尝试从Astro全局对象中获取语言
-    const preferredLocale = astro.preferredLocale;
-    if (preferredLocale) {
-      return preferredLocale;
-    }
-
-    // 如果无法检测，返回默认语言
-    return DEFAULT_LANGUAGE;
-  }
-
-  /**
-   * 从URL中提取语言代码
-   * @param url 当前URL
-   * @returns 从URL中提取的语言代码，如果无法提取则返回undefined
-   */
-  private static 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 = currentUrl.match(/^\/([\w-]+)\//);
-    if (pathMatch) {
-      return pathMatch[1];
-    }
-
-    // 尝试从查询参数中提取语言代码
-    // 例如: ?lang=zh-cn
-    const urlParams = new URLSearchParams(currentUrl.split('?')[1]);
-    const langParam = urlParams.get('lang');
-    if (langParam) {
-      return langParam;
-    }
-
-    return undefined;
-  }
-
-  /**
-   * 从浏览器设置中获取首选语言
-   * @returns 从浏览器设置中获取的语言代码，如果无法获取则返回undefined
-   */
-  private static getLanguageFromBrowser(): string | undefined {
-    if (typeof navigator === 'undefined') return undefined;
-
-    // 获取浏览器语言
-    const browserLang = navigator.language.toLowerCase();
-    return browserLang;
-  }
-}