taro-uno-ui 0.9.0 → 1.0.0

package/src/types/utils.ts

@@ -73,14 +73,10 @@ export type Truthy<T> = T extends false | 0 | '' | null | undefined ? never : T;
 // ==================== 字符串工具类型 ====================
 
 /** 首字母大写 */
-export type Capitalize<S extends string> = S extends `${infer First}${infer Rest}`
-  ? `${Uppercase<First>}${Rest}`
-  : S;
+export type Capitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Uppercase<First>}${Rest}` : S;
 
 /** 首字母小写 */
-export type Uncapitalize<S extends string> = S extends `${infer First}${infer Rest}`
-  ? `${Lowercase<First>}${Rest}`
-  : S;
+export type Uncapitalize<S extends string> = S extends `${infer First}${infer Rest}` ? `${Lowercase<First>}${Rest}` : S;
 
 /** 转换为连字符格式 */
 export type KebabCase<S> = S extends `${infer First}${infer Rest}`
@@ -90,9 +86,7 @@ export type KebabCase<S> = S extends `${infer First}${infer Rest}`
   : S;
 
 /** 转换为驼峰格式 */
-export type CamelCase<S> = S extends `${infer First}-${infer Rest}`
-  ? `${First}${Capitalize<CamelCase<Rest>>}`
-  : S;
+export type CamelCase<S> = S extends `${infer First}-${infer Rest}` ? `${First}${Capitalize<CamelCase<Rest>>}` : S;
 
 // ==================== 对象工具类型 ====================
 
@@ -108,8 +102,8 @@ export type DeepMerge<T, U> = T extends object
             ? DeepMerge<T[K], U[K]>
             : T[K]
           : K extends keyof U
-          ? U[K]
-          : never;
+            ? U[K]
+            : never;
       }
     : T
   : U;
@@ -202,9 +196,7 @@ export function isReactElement(value: unknown): value is React.ReactElement {
 }
 
 /** 类型守卫：检查是否为React组件 */
-export function isReactComponent<T extends React.ComponentType<any>>(
-  value: unknown,
-): value is T {
+export function isReactComponent<T extends React.ComponentType<any>>(value: unknown): value is T {
   return isFunction(value);
 }
 
@@ -231,9 +223,7 @@ export function isNotEmpty<T>(value: T | null | undefined): value is T {
 // ==================== 验证工具类型 ====================
 
 /** 验证结果类型 */
-export type ValidationResult<T> = 
-  | { success: true; data: T }
-  | { success: false; error: string };
+export type ValidationResult<T> = { success: true; data: T } | { success: false; error: string };
 
 /** 验证函数类型 */
 export type Validator<T> = (value: unknown) => ValidationResult<T>;
@@ -320,7 +310,7 @@ export function mergeStyles(...styles: (StyleObject | undefined)[]): StyleObject
 // ==================== 异步工具类型 ====================
 
 /** 异步状态类型 */
-export type AsyncState<T> = 
+export type AsyncState<T> =
   | { status: 'idle' }
   | { status: 'loading' }
   | { status: 'success'; data: T }
@@ -334,7 +324,7 @@ export type AsyncOperation<T> = Promise<T> & {
 /** 创建可取消的Promise */
 export function createCancellablePromise<T>(promise: Promise<T>): AsyncOperation<T> {
   let cancelled = false;
-  
+
   const cancellablePromise = promise.then(
     (data) => {
       if (cancelled) {
@@ -347,13 +337,13 @@ export function createCancellablePromise<T>(promise: Promise<T>): AsyncOperation
         throw new Error('Promise was cancelled');
       }
       throw error;
-    }
+    },
   ) as AsyncOperation<T>;
-  
+
   cancellablePromise.cancel = () => {
     cancelled = true;
   };
-  
+
   return cancellablePromise;
 }
 
@@ -407,4 +397,4 @@ export type InferArgs<T> = T extends (...args: infer A) => any ? A : never;
 /** 推断函数返回类型 */
 export type InferReturn<T> = T extends (...args: any) => infer R ? R : never;
 
-// ==================== 默认导出 ====================
+// ==================== 默认导出 ====================

package/src/utils/__tests__/responsiveUtils.test.ts

@@ -2,18 +2,19 @@
  * responsiveUtils 单元测试
  */
 
-import { renderHook, act } from '@testing-library/react';
+import { renderHook } from '@testing-library/react';
+import { describe, it, expect, vi } from 'vitest';
 import { useResponsive, getScreenSize, matchScreenSize, getResponsiveValue, generateResponsiveStyles } from '../responsiveUtils';
 
 // 模拟Taro环境
-jest.mock('@tarojs/taro', () => ({
-  getSystemInfoSync: jest.fn(() => ({
+vi.mock('@tarojs/taro', () => ({
+  getSystemInfoSync: vi.fn(() => ({
     windowWidth: 375,
     windowHeight: 667,
     statusBarHeight: 20,
     safeArea: { top: 20, bottom: 0, left: 0, right: 375 }
   })),
-  getMenuButtonBoundingClientRect: jest.fn(() => ({
+  getMenuButtonBoundingClientRect: vi.fn(() => ({
     width: 87,
     height: 32,
     top: 26,

package/src/utils/abort-controller.ts

@@ -0,0 +1,48 @@
+/**
+ * AbortController 兼容层
+ * 为小程序等不支持原生 AbortController 的环境提供兼容实现
+ */
+import { PlatformDetector } from './index';
+
+// 定义 AbortSignal 接口
+interface AbortSignal {
+  aborted: boolean;
+  onabort?: () => void;
+}
+
+// 定义兼容的 AbortController 接口
+export interface CompatibleAbortController {
+  signal: AbortSignal;
+  abort: () => void;
+}
+
+/**
+ * 创建兼容的 AbortController
+ * 在支持原生 AbortController 的环境中使用原生实现
+ * 在小程序等环境中使用模拟实现
+ */
+export function createAbortController(): CompatibleAbortController {
+  // 如果是小程序环境，使用模拟实现
+  if (PlatformDetector.isMiniProgram()) {
+    return {
+      signal: {
+        aborted: false,
+      },
+      abort: () => {
+        // 小程序环境下，AbortController 的信号主要用于取消请求
+        // 但小程序的 Taro.request 不支持 AbortController，所以这里只做简单标记
+        // 实际的请求取消需要在适配器中特殊处理
+      },
+    };
+  }
+
+  // 在 H5 和 React Native 环境中使用原生 AbortController
+  return new AbortController() as unknown as CompatibleAbortController;
+}
+
+/**
+ * 判断是否支持原生 AbortController
+ */
+export function isAbortControllerSupported(): boolean {
+  return typeof AbortController !== 'undefined' && PlatformDetector.isH5();
+}

package/src/utils/cache.ts

@@ -19,11 +19,7 @@ class DataCache {
   /**
    * 获取缓存数据或执行获取函数
    */
-  async fetch<T>(
-    key: string,
-    fetcher: () => Promise<T>,
-    options: CacheOptions = {}
-  ): Promise<T> {
+  async fetch<T>(key: string, fetcher: () => Promise<T>, options: CacheOptions = {}): Promise<T> {
     const { ttl = 5 * 60 * 1000, retries = 0 } = options;
 
     // 检查缓存
@@ -50,7 +46,7 @@ class DataCache {
         lastError = error as Error;
         if (i < retries) {
           // 等待后重试
-          await new Promise(resolve => setTimeout(resolve, 1000 * (i + 1)));
+          await new Promise((resolve) => setTimeout(resolve, 1000 * (i + 1)));
         }
       }
     }

package/src/utils/createNamespace.ts

@@ -7,13 +7,13 @@ export const createNamespace = (namespace: string) => {
   const bem = (name?: string, modifiers: string[] = []) => {
     const base = namespace;
     if (!name) return base;
-    
+
     const block = `${base}__${name}`;
     if (modifiers.length === 0) return block;
-    
+
     return modifiers
       .filter(Boolean)
-      .map(mod => `${block}--${mod}`)
+      .map((mod) => `${block}--${mod}`)
       .join(' ');
   };
 
@@ -21,4 +21,4 @@ export const createNamespace = (namespace: string) => {
     bem,
     namespace,
   };
-};
+};

package/src/utils/environment.ts

@@ -11,7 +11,11 @@ export const isBrowserEnvironment = (): boolean => {
  * Detect whether Taro runtime is available (mini-program / native bridge).
  */
 export const isTaroEnvironment = (): boolean => {
-  return typeof process !== 'undefined' && typeof process.env !== 'undefined' && typeof process.env['TARO_ENV'] !== 'undefined';
+  return (
+    typeof process !== 'undefined' &&
+    typeof process.env !== 'undefined' &&
+    typeof process.env['TARO_ENV'] !== 'undefined'
+  );
 };
 
 /**
@@ -25,11 +29,15 @@ export const resolvePlatform = (): Platform | 'unknown' => {
 };
 
 /**
- * Safe local storage wrapper guarding non-browser runtimes.
+ * Safe local storage wrapper guarding non-browser runtimes and incomplete localStorage implementations.
  */
 export const safeLocalStorage = {
   getItem(key: string): string | null {
-    if (!isBrowserEnvironment()) {
+    if (
+      !isBrowserEnvironment() ||
+      typeof window.localStorage === 'undefined' ||
+      typeof window.localStorage.getItem !== 'function'
+    ) {
       return null;
     }
 
@@ -42,7 +50,11 @@ export const safeLocalStorage = {
   },
 
   setItem(key: string, value: string): void {
-    if (!isBrowserEnvironment()) {
+    if (
+      !isBrowserEnvironment() ||
+      typeof window.localStorage === 'undefined' ||
+      typeof window.localStorage.setItem !== 'function'
+    ) {
       return;
     }
 
@@ -54,7 +66,11 @@ export const safeLocalStorage = {
   },
 
   removeItem(key: string): void {
-    if (!isBrowserEnvironment()) {
+    if (
+      !isBrowserEnvironment() ||
+      typeof window.localStorage === 'undefined' ||
+      typeof window.localStorage.removeItem !== 'function'
+    ) {
       return;
     }
 
@@ -66,7 +82,11 @@ export const safeLocalStorage = {
   },
 
   clear(): void {
-    if (!isBrowserEnvironment()) {
+    if (
+      !isBrowserEnvironment() ||
+      typeof window.localStorage === 'undefined' ||
+      typeof window.localStorage.clear !== 'function'
+    ) {
       return;
     }
 

package/src/utils/error-handler.ts

@@ -27,7 +27,7 @@ export interface AppError extends Error {
 class ErrorHandler {
   private static instance: ErrorHandler;
 
-  private constructor() { }
+  private constructor() {}
 
   static getInstance(): ErrorHandler {
     if (!ErrorHandler.instance) {
@@ -41,7 +41,7 @@ class ErrorHandler {
     type: ErrorType = ErrorType.UNKNOWN,
     severity: ErrorSeverity = ErrorSeverity.MEDIUM,
     code?: string,
-    details?: unknown
+    details?: unknown,
   ): AppError {
     const error = new Error(message) as AppError;
     error.type = type;

package/src/utils/errorLogger.ts

@@ -3,6 +3,8 @@
  * 提供统一的错误记录和上报功能
  */
 
+import { safeLocalStorage } from './environment';
+
 interface ErrorLog {
   timestamp: string;
   message: string;
@@ -33,7 +35,7 @@ class ErrorLogger {
       type,
       userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,
       url: typeof window !== 'undefined' ? window.location.href : undefined,
-      userId: this.getUserId()
+      userId: this.getUserId(),
     };
 
     this.addLog(errorLog);
@@ -52,7 +54,7 @@ class ErrorLogger {
       type,
       userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,
       url: typeof window !== 'undefined' ? window.location.href : undefined,
-      userId: this.getUserId()
+      userId: this.getUserId(),
     };
 
     this.addLog(errorLog);
@@ -83,12 +85,10 @@ class ErrorLogger {
    * 保存日志到本地存储
    */
   private saveToLocalStorage(): void {
-    if (typeof localStorage !== 'undefined') {
-      try {
-        localStorage.setItem('taro-uno-error-logs', JSON.stringify(this.logs));
-      } catch (e) {
-        console.warn('Failed to save error logs to localStorage:', e);
-      }
+    try {
+      safeLocalStorage.setItem('taro-uno-error-logs', JSON.stringify(this.logs));
+    } catch (e) {
+      console.warn('Failed to save error logs to localStorage:', e);
     }
   }
 
@@ -96,15 +96,13 @@ class ErrorLogger {
    * 从本地存储加载日志
    */
   private loadFromLocalStorage(): void {
-    if (typeof localStorage !== 'undefined') {
-      try {
-        const savedLogs = localStorage.getItem('taro-uno-error-logs');
-        if (savedLogs) {
-          this.logs = JSON.parse(savedLogs);
-        }
-      } catch (e) {
-        console.warn('Failed to load error logs from localStorage:', e);
+    try {
+      const savedLogs = safeLocalStorage.getItem('taro-uno-error-logs');
+      if (savedLogs) {
+        this.logs = JSON.parse(savedLogs);
       }
+    } catch (e) {
+      console.warn('Failed to load error logs from localStorage:', e);
     }
   }
 
@@ -154,9 +152,7 @@ class ErrorLogger {
    */
   clearLogs(): void {
     this.logs = [];
-    if (typeof localStorage !== 'undefined') {
-      localStorage.removeItem('taro-uno-error-logs');
-    }
+    safeLocalStorage.removeItem('taro-uno-error-logs');
   }
 
   /**
@@ -194,4 +190,4 @@ if (typeof window !== 'undefined') {
   errorLogger.init();
 }
 
-export default errorLogger;
+export default errorLogger;

package/src/utils/formatUtils.ts

@@ -14,10 +14,7 @@ interface DateFormatOptions {
 /** 日期时间格式化工具类 */
 export class DateTimeFormatUtils {
   /** 格式化日期 */
-  static formatDate(
-    date: Date | string | number,
-    options: DateFormatOptions = {}
-  ): string {
+  static formatDate(date: Date | string | number, options: DateFormatOptions = {}): string {
     const { format = 'YYYY-MM-DD' } = options;
     const d = new Date(date);
 
@@ -36,19 +33,19 @@ export class DateTimeFormatUtils {
 
     // 支持的格式化标记
     const replacements: Record<string, string> = {
-      'YYYY': String(year),
-      'YY': String(year).slice(-2),
-      'MM': month,
-      'M': String(d.getMonth() + 1),
-      'DD': day,
-      'D': String(d.getDate()),
-      'HH': hours,
-      'H': String(d.getHours()),
-      'mm': minutes,
-      'm': String(d.getMinutes()),
-      'ss': seconds,
-      's': String(d.getSeconds()),
-      'SSS': milliseconds,
+      YYYY: String(year),
+      YY: String(year).slice(-2),
+      MM: month,
+      M: String(d.getMonth() + 1),
+      DD: day,
+      D: String(d.getDate()),
+      HH: hours,
+      H: String(d.getHours()),
+      mm: minutes,
+      m: String(d.getMinutes()),
+      ss: seconds,
+      s: String(d.getSeconds()),
+      SSS: milliseconds,
     };
 
     // 应用格式化
@@ -108,12 +105,12 @@ export class DateTimeFormatUtils {
 
     const startTime = this.formatDate(startDate, { format: 'HH:mm' });
     const endTime = this.formatDate(endDate, { format: 'HH:mm' });
-    
+
     // 如果在同一天
     if (startDate.toDateString() === endDate.toDateString()) {
       return `${startTime} - ${endTime}`;
     }
-    
+
     // 如果不在同一天
     return `${this.formatDate(startDate, { format: 'MM-DD HH:mm' })} - ${this.formatDate(endDate, { format: 'MM-DD HH:mm' })}`;
   }
@@ -121,10 +118,11 @@ export class DateTimeFormatUtils {
   /** 获取星期几 */
   static getWeekday(date: Date | string | number, locale = 'zh-CN'): string {
     const d = new Date(date);
-    const weekdays = locale === 'zh-CN' 
-      ? ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六']
-      : ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
-    
+    const weekdays =
+      locale === 'zh-CN'
+        ? ['星期日', '星期一', '星期二', '星期三', '星期四', '星期五', '星期六']
+        : ['Sunday', 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday'];
+
     return weekdays[d.getDay()] || '';
   }
 
@@ -167,10 +165,7 @@ interface NumberFormatOptions {
 /** 数字格式化工具类 */
 export class NumberFormatUtils {
   /** 格式化数字 */
-  static formatNumber(
-    num: number,
-    options: NumberFormatOptions = {}
-  ): string {
+  static formatNumber(num: number, options: NumberFormatOptions = {}): string {
     const {
       locale = 'zh-CN',
       style = 'decimal',
@@ -192,11 +187,7 @@ export class NumberFormatUtils {
   }
 
   /** 格式化货币 */
-  static formatCurrency(
-    amount: number,
-    currency: string = 'CNY',
-    locale = 'zh-CN'
-  ): string {
+  static formatCurrency(amount: number, currency: string = 'CNY', locale = 'zh-CN'): string {
     return this.formatNumber(amount, {
       style: 'currency',
       currency,
@@ -205,11 +196,7 @@ export class NumberFormatUtils {
   }
 
   /** 格式化百分比 */
-  static formatPercent(
-    value: number,
-    decimals: number = 2,
-    locale = 'zh-CN'
-  ): string {
+  static formatPercent(value: number, decimals: number = 2, locale = 'zh-CN'): string {
     return this.formatNumber(value, {
       style: 'percent',
       minimumFractionDigits: decimals,
@@ -219,11 +206,7 @@ export class NumberFormatUtils {
   }
 
   /** 格式化文件大小 */
-  static formatFileSize(
-    bytes: number,
-    decimals: number = 2,
-    locale = 'zh-CN'
-  ): string {
+  static formatFileSize(bytes: number, decimals: number = 2, locale = 'zh-CN'): string {
     if (bytes === 0) return '0 B';
 
     const k = 1024;
@@ -235,11 +218,7 @@ export class NumberFormatUtils {
   }
 
   /** 格式化数字缩写 */
-  static formatNumberAbbreviation(
-    num: number,
-    decimals: number = 1,
-    locale = 'zh-CN'
-  ): string {
+  static formatNumberAbbreviation(num: number, decimals: number = 1, locale = 'zh-CN'): string {
     if (num < 1000) {
       return this.formatNumber(num, { locale });
     }
@@ -329,7 +308,7 @@ export class StringFormatUtils {
 
   /** 驼峰命名转下划线命名 */
   static camelToSnake(str: string): string {
-    return str.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);
+    return str.replace(/[A-Z]/g, (letter) => `_${letter.toLowerCase()}`);
   }
 
   /** 下划线命名转驼峰命名 */
@@ -344,7 +323,7 @@ export class StringFormatUtils {
 
   /** 驼峰命名转中划线命名 */
   static camelToKebab(str: string): string {
-    return str.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+    return str.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
   }
 
   /** 格式化手机号 */
@@ -381,13 +360,9 @@ export class StringFormatUtils {
   }
 
   /** 高亮关键词 */
-  static highlightKeywords(
-    text: string,
-    keywords: string[],
-    highlightClass = 'highlight'
-  ): string {
+  static highlightKeywords(text: string, keywords: string[], highlightClass = 'highlight'): string {
     let result = text;
-    keywords.forEach(keyword => {
+    keywords.forEach((keyword) => {
       const regex = new RegExp(`(${keyword})`, 'gi');
       result = result.replace(regex, `<span class="${highlightClass}">$1</span>`);
     });
@@ -415,25 +390,18 @@ export class StringFormatUtils {
 
   /** 生成UUID */
   static generateUUID(): string {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function(c) {
-      const r = Math.random() * 16 | 0;
-      const v = c === 'x' ? r : (r & 0x3 | 0x8);
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, function (c) {
+      const r = (Math.random() * 16) | 0;
+      const v = c === 'x' ? r : (r & 0x3) | 0x8;
       return v.toString(16);
     });
   }
 
   /** 格式化模板字符串 */
-  static template(
-    template: string,
-    data: Record<string, any>,
-    delimiter = '{%}'
-  ): string {
-    return template.replace(
-      new RegExp(`${delimiter}(\\w+)${delimiter}`, 'g'),
-      (_, key) => {
-        return data[key] !== undefined ? String(data[key]) : '';
-      }
-    );
+  static template(template: string, data: Record<string, any>, delimiter = '{%}'): string {
+    return template.replace(new RegExp(`${delimiter}(\\w+)${delimiter}`, 'g'), (_, key) => {
+      return data[key] !== undefined ? String(data[key]) : '';
+    });
   }
 }
 
@@ -441,4 +409,4 @@ export class StringFormatUtils {
 
 export const dateTimeFormat = DateTimeFormatUtils;
 export const numberFormat = NumberFormatUtils;
-export const stringFormat = StringFormatUtils;
+export const stringFormat = StringFormatUtils;