@coffic/cosy-ui 0.9.93 → 0.9.94

package/dist/src/components/header/types.d.ts

@@ -26,6 +26,11 @@ export interface IHeaderProps {
      * 完整的 astro:i18n 模块（启用语言切换时需要）
      */
     astroI18n?: any;
+    /**
+     * 支持的语言列表，如：['zh-cn', 'en']
+     * 用于语言切换功能
+     */
+    locales?: string[];
     /**
      * 导航栏高度
      * @default 'md'

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

@@ -52,6 +52,7 @@ const {
 	showThemeSwitcher = true,
 	gap = 2,
 	astroI18n,
+	locales,
 } = Astro.props;
 
 // 根据高度设置样式（使用 common 中的 heightClasses）
@@ -142,8 +143,7 @@ const containerClassList = [
             activeLink={activeLink}
             linkHeightClass={linkHeightClass}
             showThemeSwitcher={showThemeSwitcher}
-            isI18nEnabled={isI18nEnabled}
-            astroI18n={astroI18n}>
+            locales={locales}>
             <slot name="navbar-end" />
         </HeaderEnd>
     </div>

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

@@ -17,8 +17,7 @@
  *   activeLink={activeLink}
  *   linkHeightClass={linkHeightClass}
  *   showThemeSwitcher={showThemeSwitcher}
- *   isI18nEnabled={isI18nEnabled}
- *   astroI18n={astroI18n}
+ *   locales={locales}
  * />
  * ```
  *
@@ -28,8 +27,7 @@
  * - activeLink - 当前激活的链接
  * - linkHeightClass - 链接高度类名
  * - showThemeSwitcher - 是否显示主题切换器
- * - isI18nEnabled - 是否启用国际化
- * - astroI18n - astro:i18n 模块
+ * - locales - 支持的语言列表（用于语言切换器）
  */
 import { type INavItem, LanguageSwitcher, MenuIcon } from "../../index-astro";
 import NavItems from "./NavItems.astro";
@@ -41,8 +39,7 @@ export interface Props {
 	activeLink: string;
 	linkHeightClass: string;
 	showThemeSwitcher: boolean;
-	isI18nEnabled: boolean;
-	astroI18n?: any;
+	locales?: string[];
 }
 
 const {
@@ -51,8 +48,7 @@ const {
 	activeLink,
 	linkHeightClass,
 	showThemeSwitcher,
-	isI18nEnabled,
-	astroI18n,
+	locales,
 } = Astro.props;
 ---
 
@@ -71,7 +67,7 @@ const {
   }
 
   {showThemeSwitcher && <ThemeSwitcher />}
-  {isI18nEnabled && <LanguageSwitcher astroI18n={astroI18n} />}
+  {locales && locales.length > 0 && <LanguageSwitcher locales={locales} />}
 
   <!-- 移动端汉堡菜单按钮 -->
   {

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

@@ -1,7 +1,4 @@
 ---
-
-
-
 /**
  * @component ThemeSwitcher
  *

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

@@ -24,6 +24,7 @@ export interface IHeaderPropsBuilder {
 	showThemeSwitcher(value?: boolean): IHeaderPropsBuilder;
 	gap(value: NonNullable<IHeaderProps["gap"]>): IHeaderPropsBuilder;
 	astroI18n(value: any): IHeaderPropsBuilder;
+	locales(value: NonNullable<IHeaderProps["locales"]>): IHeaderPropsBuilder;
 	build(): IHeaderProps;
 }
 
@@ -107,6 +108,10 @@ export function createHeaderProps(
 			props = { ...props, astroI18n: value };
 			return api;
 		},
+		locales(value) {
+			props = { ...props, locales: value };
+			return api;
+		},
 		build() {
 			return props;
 		},

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

@@ -1,16 +1,33 @@
 ---
-
-
 /**
  * @component LanguageSwitcher
  *
  * @description
- * LanguageSwitcher 组件提供一个语言切换下拉菜单，支持多语言网站的语言切换功能。
- * 组件会自动处理 URL 路径，确保在切换语言时保留当前页面路径。
+ * LanguageSwitcher 组件提供一个语言切换下拉菜单，适用于使用 [lang] 动态路由的多语言网站。
+ * 
+ * **URL 生成规则**：
+ * - 为每个语言生成格式为 `/{locale}{path}` 的 URL
+ * - 例如：`/zh-cn/manuals`、`/en/manuals`
+ * - 根路径：`/zh-cn`、`/en`
+ * 
+ * **适用场景**：
+ * ✅ 使用 Astro 动态路由 `src/pages/[lang]/xxx.astro`
+ * ✅ 所有语言都需要 URL 前缀（包括默认语言）
+ * 
+ * **不适用场景**：
+ * ❌ 使用标准 Astro i18n 路由（`prefixDefaultLocale: true` 且不使用 [lang] 路由）
+ * ❌ 默认语言不需要前缀的情况（如 `/` 对应英文，`/zh-cn` 对应中文）
+ * 
+ * 如果您的项目不符合上述适用场景，请不要使用此组件，或自行实现语言切换逻辑。
  *
  * @props
- * - astroI18n - 完整的 astro:i18n 模块
+ * - locales - 必填，支持的语言列表，如：['zh-cn', 'en']
  * - class - 自定义CSS类名
+ * 
+ * @example
+ * ```astro
+ * <LanguageSwitcher locales={['zh-cn', 'en']} />
+ * ```
  */
 
 import { cn } from '../../src/class';
@@ -18,17 +35,16 @@ import { ChevronDownIcon, GlobeIcon } from '../icons';
 import { Link } from '../link';
 import { ListItem } from '../list';
 import {
-    checkSwitcherRenderState,
     generateSwitcherLinks,
-    type IAstroI18n,
     type SwitcherLink,
 } from './util';
 
 interface Props {
     /**
-     * 完整的 astro:i18n 模块
+     * 必填：支持的语言列表
+     * 例如：['zh-cn', 'en']
      */
-    astroI18n?: IAstroI18n;
+    locales: string[];
 
     /**
      * 自定义类名
@@ -36,32 +52,29 @@ interface Props {
     class?: string;
 }
 
-const { astroI18n, class: className = '' } = Astro.props;
+const { locales, class: className = '' } = Astro.props;
 
-// 检查渲染状态
-const renderState = checkSwitcherRenderState(Astro.currentLocale, astroI18n);
+// 验证必填参数
+if (!locales || locales.length === 0) {
+    throw new Error('LanguageSwitcher: locales prop is required and must not be empty');
+}
 
-// 输出警告信息
-if (renderState.warnings) {
-    renderState.warnings.forEach((warning) => {
-        console.warn(warning);
-    });
+if (!Astro.currentLocale) {
+    throw new Error('LanguageSwitcher: Astro.currentLocale is not defined. Make sure i18n is configured.');
 }
 
 let links: SwitcherLink[] = [];
 
-// 如果应该渲染，生成切换链接
-if (renderState.shouldRender && Astro.currentLocale && astroI18n) {
-    try {
-        links = generateSwitcherLinks(
-            astroI18n,
-            Astro.currentLocale,
-            Astro.url.pathname
-        );
-    } catch (error) {
-        // 如果生成链接失败，设置为不渲染
-        renderState.shouldRender = false;
-    }
+// 生成切换链接
+try {
+    links = generateSwitcherLinks(
+        Astro.currentLocale,
+        Astro.url.pathname,
+        locales
+    );
+} catch (error) {
+    console.error('LanguageSwitcher: Failed to generate links:', error);
+    throw error;
 }
 
 // 使用 classBuilder 构建类名
@@ -101,12 +114,12 @@ const ulClass = cn()
 ---
 
 {
-    renderState.shouldRender && (
+    links.length > 0 && (
         <div class={dropdownClass}>
             <div tabindex="0" role="button" class={buttonClass}>
                 <GlobeIcon size="16px" class={iconClass} />
                 <span class={spanClass}>
-                    {renderState.currentLanguageName}
+                    {links.find(l => l.locale === Astro.currentLocale)?.name}
                 </span>
                 <ChevronDownIcon size="16px" class={chevronClass} />
             </div>

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

@@ -7,84 +7,104 @@ export interface SwitcherLink {
 }
 
 /**
- * Astro i18n 模块类型定义
+ * 获取路径部分（去除语言前缀）
+ * @param pathname - 完整路径
+ * @param localePrefix - 语言前缀（如 /zh-cn/ 或 /zh-cn）
+ * @returns 不含语言前缀的路径
  */
-export interface IAstroI18n {
-	getRelativeLocaleUrl: (locale: string, path: string) => string;
-	getRelativeLocaleUrlList: (slug: string) => string[];
-}
+const getPathWithoutLocale = (
+	pathname: string,
+	_currentLocale: string,
+	locales: string[],
+): string => {
+	// 规范化路径：移除末尾的斜杠（除非是根路径）
+	const normalizedPath =
+		pathname.endsWith("/") && pathname !== "/"
+			? pathname.slice(0, -1)
+			: pathname;
 
-/**
- * 获取基础 URL
- */
-export const getBaseUrl = (): string => {
-	return import.meta.env.BASE_URL || "/";
-};
+	// 如果是根路径，返回空字符串
+	if (normalizedPath === "/" || normalizedPath === "") {
+		return "";
+	}
 
-/**
- * 从 URL 中提取语言代码
- */
-export const getLocaleFromUrl = (url: string): string => {
-	return url.replace(getBaseUrl(), "").split("/")[0];
+	// 尝试移除语言前缀
+	// 检查是否以 /locale 或 /locale/ 开头
+	for (const locale of locales) {
+		const prefix = `/${locale}`;
+
+		// 情况1: /zh-cn -> 空（首页）
+		if (normalizedPath === prefix) {
+			return "";
+		}
+
+		// 情况2: /zh-cn/xxx -> /xxx
+		if (normalizedPath.startsWith(`${prefix}/`)) {
+			return normalizedPath.slice(prefix.length);
+		}
+	}
+
+	// 没有匹配到任何语言前缀，说明是默认语言（prefixDefaultLocale: false）
+	// 直接返回路径
+	return normalizedPath;
 };
 
 /**
  * 生成语言切换链接
- * @param astroI18n - astro:i18n 模块
- * @param currentLocale - 当前语言代码
- * @param pathname - 当前页面路径
+ *
+ * **URL 生成规则**：
+ * - 手动构建格式为 `/{locale}{path}` 的 URL
+ * - 适用于使用 [lang] 动态路由的项目
+ * - 所有语言都会有 URL 前缀，包括默认语言
+ *
+ * **示例**：
+ * - 当前页面：`/zh-cn/manuals` → 英文链接：`/en/manuals`
+ * - 当前页面：`/zh-cn` → 英文链接：`/en`
+ * - 当前页面：`/en/demos` → 中文链接：`/zh-cn/demos`
+ *
+ * @param currentLocale - 当前语言代码（如 'zh-cn'）
+ * @param pathname - 当前页面路径（如 '/zh-cn/manuals'）
+ * @param locales - 所有支持的语言列表（如 ['zh-cn', 'en']）
  * @returns 语言切换链接数组
  */
 export const generateSwitcherLinks = (
-	astroI18n: IAstroI18n,
 	currentLocale: string,
 	pathname: string,
+	locales: string[],
 ): SwitcherLink[] => {
 	try {
-		const { getRelativeLocaleUrl, getRelativeLocaleUrlList } = astroI18n;
+		if (locales.length === 0) {
+			console.warn("LanguageSwitcher: locales array is empty");
+			return [];
+		}
+
+		// 获取不含语言前缀的路径
+		const pathWithoutLocale = getPathWithoutLocale(
+			pathname,
+			currentLocale,
+			locales,
+		);
 
-		const currentLocalURLPrefix = getRelativeLocaleUrl(currentLocale, "");
-		const pathWithSlash = `${pathname}/`;
-		const slug = pathWithSlash.replace(currentLocalURLPrefix, "");
-		const urls = getRelativeLocaleUrlList(slug);
+		// 为每个语言生成切换链接
+		return locales.map((locale) => {
+			// 手动构建 URL：/{locale}{pathWithoutLocale}
+			// 去除尾部斜杠（除了根路径）
+			const basePath = `/${locale}${pathWithoutLocale}`;
+			const url =
+				basePath.endsWith("/") && basePath !== `/${locale}/`
+					? basePath.slice(0, -1)
+					: basePath === `/${locale}/`
+						? `/${locale}`
+						: basePath;
 
-		return urls.map((url: string) => ({
-			locale: getLocaleFromUrl(url),
-			name: LanguageUtil.getLanguageName(getLocaleFromUrl(url)),
-			url: url,
-		}));
+			return {
+				locale: locale,
+				name: LanguageUtil.getLanguageName(locale),
+				url: url,
+			};
+		});
 	} catch (error) {
-		console.warn("LanguageSwitcher: Error generating switcher links:", error);
+		console.error("LanguageSwitcher: Error generating switcher links:", error);
 		throw error;
 	}
 };
-
-/**
- * 检查语言切换器是否应该渲染
- * @param currentLocale - 当前语言代码
- * @param astroI18n - astro:i18n 模块
- * @returns 是否应该渲染的状态信息
- */
-export const checkSwitcherRenderState = (
-	currentLocale: string | undefined,
-	astroI18n: IAstroI18n | undefined,
-): {
-	shouldRender: boolean;
-	currentLanguageName?: string;
-	warnings?: string[];
-} => {
-	const warnings: string[] = [];
-
-	if (!currentLocale) {
-		return { shouldRender: false, warnings };
-	}
-
-	if (!astroI18n) {
-		return { shouldRender: false, warnings };
-	}
-
-	return {
-		shouldRender: true,
-		currentLanguageName: LanguageUtil.getLanguageName(currentLocale),
-	};
-};

package/package.json

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