@coffic/cosy-ui 0.7.4 → 0.8.6

package/dist/utils/image.ts

@@ -1,126 +0,0 @@
-/**
- * 图片工具函数
- * 提供多种图片服务选项，用于生成示例图片
- */
-
-export type ImageProvider = 'picsum' | 'unsplash' | 'placeholder' | 'robohash';
-
-export interface ImageOptions {
-	width: number;
-	height: number;
-	tag?: string;
-	randomSeed?: number | string;
-	provider?: ImageProvider;
-	grayscale?: boolean;
-	blur?: number;
-}
-
-/**
- * 获取示例图片URL
- * @param options 图片选项配置
- * @returns 生成的图片URL
- *
- * @example
- * // 基本用法
- * getExampleImage({ width: 400, height: 300 })
- *
- * @example
- * // 使用Unsplash并添加标签
- * getExampleImage({
- *   width: 400,
- *   height: 300,
- *   provider: 'unsplash',
- *   tag: 'nature'
- * })
- */
-export function getExampleImage(options: ImageOptions): string {
-	const {
-		width,
-		height,
-		provider = 'picsum',
-		tag = '',
-		randomSeed = Math.floor(Math.random() * 1000),
-		grayscale = false,
-		blur = 0,
-	} = options;
-
-	switch (provider) {
-		case 'picsum': {
-			const picsumParams = [];
-			if (grayscale) picsumParams.push('grayscale');
-			if (blur > 0 && blur <= 10) picsumParams.push(`blur=${blur}`);
-
-			const picsumQuery = picsumParams.length
-				? `?${picsumParams.join('&')}`
-				: `?random=${randomSeed}`;
-
-			return `https://picsum.photos/${width}/${height}${picsumQuery}`;
-		}
-
-		case 'unsplash': {
-			const tagQuery = tag ? `?${tag}` : '';
-			return `https://source.unsplash.com/random/${width}x${height}${tagQuery}`;
-		}
-
-		case 'placeholder': {
-			const color = grayscale ? 'gray' : '';
-			const placeholderParams = [];
-			if (tag) placeholderParams.push(`text=${encodeURIComponent(tag)}`);
-			if (color) placeholderParams.push(`bg=${color}`);
-
-			const placeholderQuery = placeholderParams.length ? `?${placeholderParams.join('&')}` : '';
-
-			return `https://via.placeholder.com/${width}x${height}${placeholderQuery}`;
-		}
-
-		case 'robohash': {
-			const seed = String(tag || randomSeed);
-			return `https://robohash.org/${encodeURIComponent(seed)}?size=${width}x${height}`;
-		}
-
-		default: {
-			return `https://picsum.photos/${width}/${height}?random=${randomSeed}`;
-		}
-	}
-}
-
-/**
- * 获取产品示例图片
- * @param options 可选的图片选项配置
- */
-export function getProductImage(options: Partial<ImageOptions> = {}): string {
-	return getExampleImage({
-		width: options.width || 400,
-		height: options.height || 300,
-		provider: options.provider || 'picsum',
-		tag: options.tag || 'product',
-		...options,
-	});
-}
-
-/**
- * 获取头像示例图片
- * @param options 可选的图片选项配置
- */
-export function getAvatarImage(options: Partial<ImageOptions> = {}): string {
-	return getExampleImage({
-		width: options.width || 200,
-		height: options.height || 200,
-		provider: options.provider || 'robohash',
-		...options,
-	});
-}
-
-/**
- * 获取景观示例图片
- * @param options 可选的图片选项配置
- */
-export function getLandscapeImage(options: Partial<ImageOptions> = {}): string {
-	return getExampleImage({
-		width: options.width || 800,
-		height: options.height || 400,
-		provider: options.provider || 'unsplash',
-		tag: options.tag || 'landscape',
-		...options,
-	});
-}

package/dist/utils/lang_entry.ts

@@ -1,240 +0,0 @@
-/**
- * 多语言工具类
- * 
- * 这个类提供了一套完整的多语言文本管理工具，用于在组件库中处理国际化需求。
- * 主要特点：
- * - 提供链式API来创建和管理多语言文本
- * - 支持动态添加和获取不同语言的文本
- * - 可以通过属性访问器直接获取特定语言的文本
- * - 支持合并多个语言条目
- * 
- * 使用示例：
- * ```typescript
- * // 创建并设置多语言文本
- * const entry = new LangEntry()
- *   .setZh('你好')
- *   .setEn('Hello')
- *   .setJa('こんにちは');
- * 
- * // 获取特定语言的文本
- * console.log(entry.get('zh-cn')); // 你好
- * 
- * // 使用代理后可以通过属性访问
- * // 需要通过 langEntryHandler 创建代理
- * const proxiedEntry = new Proxy(entry, langEntryHandler);
- * console.log(proxiedEntry.en);      // Hello
- * console.log(proxiedEntry['zh-cn']); // 你好
- * ```
- */
-export class LangEntry {
-    private translations: Record<string, string> = {};
-
-    /**
-     * 设置中文文本
-     * 
-     * @param text 中文文本
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const entry = new LangEntry().setZh('你好');
-     */
-    setZh(text: string): LangEntry {
-        this.translations['zh-cn'] = text;
-        return this;
-    }
-
-    /**
-     * 设置英文文本
-     * 
-     * @param text 英文文本
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const entry = new LangEntry().setEn('Hello');
-     */
-    setEn(text: string): LangEntry {
-        this.translations['en'] = text;
-        return this;
-    }
-
-    /**
-     * 设置日文文本
-     * 
-     * @param text 日文文本
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const entry = new LangEntry().setJa('こんにちは');
-     */
-    setJa(text: string): LangEntry {
-        this.translations['ja'] = text;
-        return this;
-    }
-
-    /**
-     * 设置任意语言的文本
-     * 
-     * @param lang 语言代码，如 'fr' 表示法语，'de' 表示德语等
-     * @param text 文本内容
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const entry = new LangEntry().set('fr', 'Bonjour').set('de', 'Hallo');
-     */
-    set(lang: string, text: string): LangEntry {
-        this.translations[lang] = text;
-        return this;
-    }
-
-    /**
-     * 设置所有语言为相同的文本值
-     * 适用于不需要翻译的品牌名、专有名词等
-     * 
-     * @param text 所有语言共用的文本
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const brandName = new LangEntry().setAll('Cosy UI');
-     */
-    setAll(text: string): LangEntry {
-        // 如果已有语言，则更新它们
-        if (Object.keys(this.translations).length > 0) {
-            for (const lang of Object.keys(this.translations)) {
-                this.translations[lang] = text;
-            }
-        } else {
-            // 默认至少设置中英文
-            this.translations['zh-cn'] = text;
-            this.translations['en'] = text;
-        }
-        return this;
-    }
-
-    /**
-     * 获取指定语言的文本
-     * 
-     * @param lang 语言代码
-     * @param defaultValue 默认值，如果未找到翻译则返回此值
-     * @returns 指定语言的文本，如果不存在则返回默认值或第一个可用的翻译或空字符串
-     * @example
-     * const entry = new LangEntry().setZh('你好').setEn('Hello');
-     * console.log(entry.get('zh-cn'));        // 你好
-     * console.log(entry.get('fr', 'Default')); // Default
-     */
-    get(lang: string, defaultValue?: string): string {
-        return this.translations[lang] || defaultValue || this.getFirst() || '';
-    }
-
-    /**
-     * 获取第一个可用的翻译文本
-     * 
-     * @returns 第一个可用的翻译文本，如果没有任何翻译则返回 undefined
-     * @example
-     * const entry = new LangEntry().setEn('Hello').setZh('你好');
-     * console.log(entry.getFirst()); // 取决于对象属性顺序，可能是 'Hello' 或 '你好'
-     */
-    getFirst(): string | undefined {
-        const keys = Object.keys(this.translations);
-        return keys.length > 0 ? this.translations[keys[0]] : undefined;
-    }
-
-    /**
-     * 获取所有可用的语言代码
-     * 
-     * @returns 所有已设置翻译的语言代码数组
-     * @example
-     * const entry = new LangEntry().setZh('你好').setEn('Hello');
-     * console.log(entry.getLanguages()); // ['zh-cn', 'en']
-     */
-    getLanguages(): string[] {
-        return Object.keys(this.translations);
-    }
-
-    /**
-     * 获取所有翻译
-     * 
-     * @returns 包含所有语言翻译的对象副本
-     * @example
-     * const entry = new LangEntry().setZh('你好').setEn('Hello');
-     * console.log(entry.getAll()); // { 'zh-cn': '你好', 'en': 'Hello' }
-     */
-    getAll(): Record<string, string> {
-        return { ...this.translations };
-    }
-
-    /**
-     * 合并另一个语言条目
-     * 如果两个条目有相同的语言，则后者会覆盖前者
-     * 
-     * @param other 要合并的语言条目
-     * @returns 返回当前实例，支持链式调用
-     * @example
-     * const entry1 = new LangEntry().setZh('你好').setEn('Hello');
-     * const entry2 = new LangEntry().setJa('こんにちは').setEn('Hi');
-     * entry1.merge(entry2);
-     * console.log(entry1.getAll()); // { 'zh-cn': '你好', 'en': 'Hi', 'ja': 'こんにちは' }
-     */
-    merge(other: LangEntry): LangEntry {
-        Object.assign(this.translations, other.getAll());
-        return this;
-    }
-
-    /**
-     * 检查是否包含指定语言
-     * 
-     * @param lang 语言代码
-     * @returns 如果包含指定语言则返回 true，否则返回 false
-     * @example
-     * const entry = new LangEntry().setZh('你好').setEn('Hello');
-     * console.log(entry.has('zh-cn')); // true
-     * console.log(entry.has('ja'));    // false
-     */
-    has(lang: string): boolean {
-        return lang in this.translations;
-    }
-
-    /**
-     * 转换为普通对象
-     * 
-     * @returns 包含所有语言翻译的对象副本
-     * @example
-     * const entry = new LangEntry().setZh('你好').setEn('Hello');
-     * const obj = entry.toObject();
-     * console.log(obj); // { 'zh-cn': '你好', 'en': 'Hello' }
-     */
-    toObject(): Record<string, string> {
-        return { ...this.translations };
-    }
-
-    /**
-     * 允许以对象属性方式访问翻译
-     * 例如: entry['zh-cn'] 或 entry.en
-     * 
-     * 注意：这个索引签名本身不提供功能，实际的属性访问是通过 langEntryHandler 代理实现的
-     */
-    [key: string]: any;
-}
-
-/**
- * 创建索引访问器的Proxy处理程序
- * 
- * 这个处理程序允许通过属性访问方式获取语言翻译，例如：
- * - entry.en 代替 entry.get('en')
- * - entry['zh-cn'] 代替 entry.get('zh-cn')
- * 
- * @example
- * const entry = new LangEntry().setZh('你好').setEn('Hello');
- * const proxiedEntry = new Proxy(entry, langEntryHandler);
- * console.log(proxiedEntry.en);      // Hello
- * console.log(proxiedEntry['zh-cn']); // 你好
- */
-export const langEntryHandler: ProxyHandler<LangEntry> = {
-    get(target: LangEntry, prop: string | symbol): any {
-        // 如果是字符串属性并且不是LangEntry的方法，则尝试作为语言代码获取翻译
-        if (
-            typeof prop === 'string' &&
-            !(prop in Object.getPrototypeOf(target)) &&
-            prop !== 'translations'
-        ) {
-            return target.get(prop);
-        }
-
-        // 否则返回原始属性
-        return (target as any)[prop];
-    },
-};

package/dist/utils/lang_package.ts

@@ -1,150 +0,0 @@
-import { LangEntry, langEntryHandler } from "./lang_entry";
-
-/**
- * 提供快捷访问的LangPackage
- * 
- * 这个类提供了一系列静态方法，用于快速创建和配置多语言文本条目。
- * 它是对 LangEntry 类的便捷封装，简化了多语言文本的创建和管理过程。
- * 
- * 使用示例：
- * ```typescript
- * // 创建一个空的语言条目并逐步添加翻译
- * const emptyEntry = LangPackage.make();
- * emptyEntry.setZh('你好').setEn('Hello');
- * 
- * // 从对象创建语言条目
- * const fromObj = LangPackage.from({
- *   'zh-cn': '你好',
- *   'en': 'Hello',
- *   'ja': 'こんにちは'
- * });
- * 
- * // 创建只包含中英文的语言条目
- * const zhEnEntry = LangPackage.zhEn('你好', 'Hello');
- * 
- * // 创建所有语言都使用相同文本的条目（适用于品牌名等）
- * const brandName = LangPackage.common('Cosy UI');
- * 
- * // 访问翻译的方式
- * console.log(zhEnEntry.get('zh-cn')); // 你好
- * console.log(zhEnEntry['zh-cn']);     // 你好 (通过代理实现的属性访问)
- * console.log(zhEnEntry.en);           // Hello (简写形式)
- * ```
- */
-export class LangPackage {
-    /**
-     * 创建一个新的空语言条目
-     * 
-     * @returns 返回一个代理包装的 LangEntry 实例，可以通过属性方式访问翻译
-     * @example
-     * const entry = LangPackage.make();
-     * entry.setZh('你好').setEn('Hello');
-     */
-    static make(): LangEntry {
-        return new Proxy(new LangEntry(), langEntryHandler);
-    }
-
-    /**
-     * 从对象创建语言条目
-     * 
-     * @param obj 包含语言翻译的对象，键为语言代码，值为对应的翻译文本
-     * @returns 返回一个代理包装的 LangEntry 实例
-     * @example
-     * const entry = LangPackage.from({
-     *   'zh-cn': '你好',
-     *   'en': 'Hello',
-     *   'ja': 'こんにちは'
-     * });
-     */
-    static from(obj: Record<string, string>): LangEntry {
-        const entry = new LangEntry();
-        Object.entries(obj).forEach(([lang, text]) => {
-            entry.set(lang, text);
-        });
-        return new Proxy(entry, langEntryHandler);
-    }
-
-    /**
-     * 创建只包含中文和英文的语言条目
-     * 
-     * @param zh 中文文本
-     * @param en 英文文本
-     * @returns 返回一个代理包装的 LangEntry 实例
-     * @example
-     * const entry = LangPackage.zhEn('你好', 'Hello');
-     * console.log(entry.zh-cn); // 你好
-     * console.log(entry.en);    // Hello
-     */
-    static zhEn(zh: string, en: string): LangEntry {
-        return new Proxy(new LangEntry().setZh(zh).setEn(en), langEntryHandler);
-    }
-
-    /**
-     * 创建所有语言都使用相同文本的语言条目
-     * 适用于品牌名、产品名等不需要翻译的文本
-     * 
-     * @param text 所有语言共用的文本
-     * @returns 返回一个代理包装的 LangEntry 实例
-     * @example
-     * const brandName = LangPackage.common('Cosy UI');
-     * // 所有语言都会返回相同的值
-     * console.log(brandName.zh-cn); // Cosy UI
-     * console.log(brandName.en);    // Cosy UI
-     */
-    static common(text: string): LangEntry {
-        return new Proxy(new LangEntry().setAll(text), langEntryHandler);
-    }
-
-    /**
-     * 设置中文文本
-     * 快捷方法，直接返回一个新的LangEntry实例
-     * 
-     * @param text 中文文本
-     * @returns 返回一个代理包装的 LangEntry 实例，只包含中文翻译
-     * @example
-     * const entry = LangPackage.setZh('你好');
-     */
-    static setZh(text: string): LangEntry {
-        return new Proxy(new LangEntry().setZh(text), langEntryHandler);
-    }
-
-    /**
-     * 设置英文文本
-     * 快捷方法，直接返回一个新的LangEntry实例
-     * 
-     * @param text 英文文本
-     * @returns 返回一个代理包装的 LangEntry 实例，只包含英文翻译
-     * @example
-     * const entry = LangPackage.setEn('Hello');
-     */
-    static setEn(text: string): LangEntry {
-        return new Proxy(new LangEntry().setEn(text), langEntryHandler);
-    }
-
-    /**
-     * 设置日文文本
-     * 快捷方法，直接返回一个新的LangEntry实例
-     * 
-     * @param text 日文文本
-     * @returns 返回一个代理包装的 LangEntry 实例，只包含日文翻译
-     * @example
-     * const entry = LangPackage.setJa('こんにちは');
-     */
-    static setJa(text: string): LangEntry {
-        return new Proxy(new LangEntry().setJa(text), langEntryHandler);
-    }
-
-    /**
-     * 设置任意语言的文本
-     * 快捷方法，直接返回一个新的LangEntry实例
-     * 
-     * @param lang 语言代码
-     * @param text 文本内容
-     * @returns 返回一个代理包装的 LangEntry 实例，包含指定语言的翻译
-     * @example
-     * const entry = LangPackage.set('fr', 'Bonjour');
-     */
-    static set(lang: string, text: string): LangEntry {
-        return new Proxy(new LangEntry().set(lang, text), langEntryHandler);
-    }
-}

package/dist/utils/language.ts

@@ -1,118 +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;
-	}
-}