@tplc/wot 1.0.7 → 1.0.9

package/locale/lang/vi-VN.ts

@@ -1,3 +1,15 @@
+/*
+ * @Author: 810505339
+ * @Date: 2025-02-11 21:17:21
+ * @LastEditors: 810505339
+ * @LastEditTime: 2025-02-15 21:32:57
+ * @FilePath: \wot-design-uni\src\uni_modules\wot-design-uni\locale\lang\vi-VN.ts
+ * 记得注释
+ */
+/**
+ * This file contains localization strings for various components in Vietnamese.
+ */
+
 export default {
   calendar: {
     placeholder: 'Vui lòng chọn',
@@ -16,7 +28,7 @@ export default {
     endWeek: 'Tuần kết thúc',
     startMonth: 'Tháng bắt đầu',
     endMonth: 'Tháng kết thúc',
-    monthFormat: 'Tháng YYYY MM',
+    monthFormat: 'Tháng YYYY MM'
   },
   calendarView: {
     startTime: 'Bắt đầu',
@@ -30,7 +42,7 @@ export default {
     month: 'MM',
     hour: (value: number) => `${value} giờ`,
     minute: (value: number) => `${value} phút`,
-    second: (value: number) => `${value} giây`,
+    second: (value: number) => `${value} giây`
   },
   collapse: { expand: 'Mở rộng', retract: 'Thu gọn' },
   colPicker: { title: 'Vui lòng chọn', placeholder: 'Vui lòng chọn', select: 'Vui lòng chọn' },
@@ -40,50 +52,35 @@ export default {
     to: 'đến',
     placeholder: 'Vui lòng chọn',
     confirm: 'Hoàn thành',
-    cancel: 'Hủy bỏ',
-  },
-  loadmore: {
-    loading: 'Đang tải...',
-    finished: 'Đã tải xong',
-    error: 'Tải thất bại',
-    retry: 'Nhấp để thử lại',
-  },
-  messageBox: {
-    inputPlaceholder: 'Vui lòng nhập',
-    confirm: 'Xác nhận',
-    cancel: 'Hủy bỏ',
-    inputNoValidate: 'Dữ liệu không hợp lệ',
+    cancel: 'Hủy bỏ'
   },
+  loadmore: { loading: 'Đang tải...', finished: 'Đã tải xong', error: 'Tải thất bại', retry: 'Nhấp để thử lại' },
+  messageBox: { inputPlaceholder: 'Vui lòng nhập', confirm: 'Xác nhận', cancel: 'Hủy bỏ', inputNoValidate: 'Dữ liệu không hợp lệ' },
   numberKeyboard: { confirm: 'Hoàn thành' },
   pagination: {
     prev: 'Trang trước',
     next: 'Trang sau',
     page: (value: number) => `Trang hiện tại: ${value}`,
     total: (total: number) => `Tổng số dữ liệu: ${total}`,
-    size: (size: number) => `Kích thước trang: ${size}`,
+    size: (size: number) => `Kích thước trang: ${size}`
   },
   picker: { cancel: 'Hủy bỏ', done: 'Hoàn thành', placeholder: 'Vui lòng chọn' },
   imgCropper: { confirm: 'Hoàn thành', cancel: 'Hủy bỏ' },
   search: { search: 'Tìm kiếm', cancel: 'Hủy bỏ' },
-  steps: {
-    wait: 'Chưa bắt đầu',
-    finished: 'Đã hoàn thành',
-    process: 'Đang tiến hành',
-    failed: 'Thất bại',
-  },
+  steps: { wait: 'Chưa bắt đầu', finished: 'Đã hoàn thành', process: 'Đang tiến hành', failed: 'Thất bại' },
   tabs: { all: 'Tất cả' },
   upload: { error: 'Tải lên thất bại' },
   input: { placeholder: 'Vui lòng nhập...' },
-  selectPicker: {
-    title: 'Vui lòng chọn',
-    placeholder: 'Vui lòng chọn',
-    select: 'Xác nhận',
-    confirm: 'Xác nhận',
-    filterPlaceholder: 'Tìm kiếm',
-  },
+  selectPicker: { title: 'Vui lòng chọn', placeholder: 'Vui lòng chọn', select: 'Xác nhận', confirm: 'Xác nhận', filterPlaceholder: 'Tìm kiếm' },
   tag: { placeholder: 'Vui lòng nhập', add: 'thêm' },
   textarea: { placeholder: 'Vui lòng nhập...' },
   tableCol: {
-    indexLabel: 'Số sê-ri',
+    indexLabel: 'Số sê-ri'
   },
+  signature: {
+    confirmText: 'Xác nhận',
+    clearText: 'Xóa',
+    revokeText: 'Hoàn tác',
+    restoreText: 'Khôi phục'
+  }
 }

package/locale/lang/zh-CN.ts

@@ -1,3 +1,7 @@
+/**
+ * This file contains localization strings for various components.
+ */
+
 export default {
   calendar: {
     placeholder: '请选择',
@@ -16,7 +20,7 @@ export default {
     endWeek: '结束周',
     startMonth: '开始月',
     endMonth: '结束月',
-    monthFormat: 'YYYY年MM月',
+    monthFormat: 'YYYY年MM月'
   },
   calendarView: {
     startTime: '开始',
@@ -28,7 +32,7 @@ export default {
       wed: '三',
       thu: '四',
       fri: '五',
-      sat: '六',
+      sat: '六'
     },
     rangePrompt: (maxRange: number) => `选择天数不能超过${maxRange}天`,
     rangePromptWeek: (maxRange: number) => `选择周数不能超过${maxRange}周`,
@@ -38,16 +42,16 @@ export default {
     month: 'M月',
     hour: (value: number) => `${value}时`,
     minute: (value: number) => `${value}分`,
-    second: (value: number) => `${value}秒`,
+    second: (value: number) => `${value}秒`
   },
   collapse: {
     expand: '展开',
-    retract: '收起',
+    retract: '收起'
   },
   colPicker: {
     title: '请选择',
     placeholder: '请选择',
-    select: '请选择',
+    select: '请选择'
   },
   datetimePicker: {
     start: '开始时间',
@@ -55,73 +59,79 @@ export default {
     to: '至',
     placeholder: '请选择',
     confirm: '完成',
-    cancel: '取消',
+    cancel: '取消'
   },
   loadmore: {
     loading: '正在努力加载中...',
     finished: '已加载完毕',
     error: '加载失败',
-    retry: '点击重试',
+    retry: '点击重试'
   },
   messageBox: {
     inputPlaceholder: '请输入',
     confirm: '确定',
     cancel: '取消',
-    inputNoValidate: '输入的数据不合法',
+    inputNoValidate: '输入的数据不合法'
   },
   numberKeyboard: {
-    confirm: '完成',
+    confirm: '完成'
   },
   pagination: {
     prev: '上一页',
     next: '下一页',
     page: (value: number) => `当前页：${value}`,
     total: (total: number) => `当前数据：${total}条`,
-    size: (size: number) => `分页大小：${size}`,
+    size: (size: number) => `分页大小：${size}`
   },
   picker: {
     cancel: '取消',
     done: '完成',
-    placeholder: '请选择',
+    placeholder: '请选择'
   },
   imgCropper: {
     confirm: '完成',
-    cancel: '取消',
+    cancel: '取消'
   },
   search: {
     search: '搜索',
-    cancel: '取消',
+    cancel: '取消'
   },
   steps: {
     wait: '未开始',
     finished: '已完成',
     process: '进行中',
-    failed: '失败',
+    failed: '失败'
   },
   tabs: {
-    all: '全部',
+    all: '全部'
   },
   upload: {
-    error: '上传失败',
+    error: '上传失败'
   },
   input: {
-    placeholder: '请输入...',
+    placeholder: '请输入...'
   },
   selectPicker: {
     title: '请选择',
     placeholder: '请选择',
     select: '请选择',
     confirm: '确认',
-    filterPlaceholder: '搜索',
+    filterPlaceholder: '搜索'
   },
   tag: {
     placeholder: '请输入',
-    add: '新增标签',
+    add: '新增标签'
   },
   textarea: {
-    placeholder: '请输入...',
+    placeholder: '请输入...'
   },
   tableCol: {
-    indexLabel: '序号',
-  },
+    indexLabel: '序号'
+  },
+  signature: {
+    confirmText: '确认',
+    clearText: '清空',
+    revokeText: '撤销',
+    restoreText: '恢复'
+  }
 }

package/locale/lang/zh-HK.ts

@@ -1,3 +1,7 @@
+/**
+ * This file contains the default export for various UI components in Traditional Chinese.
+ */
+
 export default {
   calendar: {
     placeholder: '請選擇',
@@ -16,7 +20,7 @@ export default {
     endWeek: '結束週',
     startMonth: '開始月',
     endMonth: '結束月',
-    monthFormat: 'YYYY年MM月',
+    monthFormat: 'YYYY年MM月'
   },
   calendarView: {
     startTime: '開始',
@@ -30,37 +34,20 @@ export default {
     month: 'M月',
     hour: (value: number) => `${value}時`,
     minute: (value: number) => `${value}分`,
-    second: (value: number) => `${value}秒`,
+    second: (value: number) => `${value}秒`
   },
   collapse: { expand: '展開', retract: '收起' },
   colPicker: { title: '請選擇', placeholder: '請選擇', select: '請選擇' },
-  datetimePicker: {
-    start: '開始時間',
-    end: '結束時間',
-    to: '至',
-    placeholder: '請選擇',
-    confirm: '完成',
-    cancel: '取消',
-  },
-  loadmore: {
-    loading: '正在努力加載中...',
-    finished: '已加載完畢',
-    error: '加載失敗',
-    retry: '點擊重試',
-  },
-  messageBox: {
-    inputPlaceholder: '請輸入',
-    confirm: '確定',
-    cancel: '取消',
-    inputNoValidate: '輸入的數據不合法',
-  },
+  datetimePicker: { start: '開始時間', end: '結束時間', to: '至', placeholder: '請選擇', confirm: '完成', cancel: '取消' },
+  loadmore: { loading: '正在努力加載中...', finished: '已加載完畢', error: '加載失敗', retry: '點擊重試' },
+  messageBox: { inputPlaceholder: '請輸入', confirm: '確定', cancel: '取消', inputNoValidate: '輸入的數據不合法' },
   numberKeyboard: { confirm: '完成' },
   pagination: {
     prev: '上一頁',
     next: '下一頁',
     page: (value: number) => `當前頁：${value}`,
     total: (total: number) => `當前數據：${total}條`,
-    size: (size: number) => `分頁大小：${size}`,
+    size: (size: number) => `分頁大小：${size}`
   },
   picker: { cancel: '取消', done: '完成', placeholder: '請選擇' },
   imgCropper: { confirm: '完成', cancel: '取消' },
@@ -69,16 +56,16 @@ export default {
   tabs: { all: '全部' },
   upload: { error: '上傳失敗' },
   input: { placeholder: '請輸入...' },
-  selectPicker: {
-    title: '請選擇',
-    placeholder: '請選擇',
-    select: '確認',
-    confirm: '確認',
-    filterPlaceholder: '搜索',
-  },
+  selectPicker: { title: '請選擇', placeholder: '請選擇', select: '確認', confirm: '確認', filterPlaceholder: '搜索' },
   tag: { placeholder: '請輸入', add: '新增標籤' },
   textarea: { placeholder: '請輸入...' },
   tableCol: {
-    indexLabel: '序號',
+    indexLabel: '序號'
   },
+  signature: {
+    confirmText: '確認',
+    clearText: '清空',
+    revokeText: '撤銷',
+    restoreText: '恢復'
+  }
 }

package/locale/lang/zh-TW.ts

@@ -1,3 +1,11 @@
+/*
+ * @Author: 810505339
+ * @Date: 2025-02-11 21:17:21
+ * @LastEditors: 810505339
+ * @LastEditTime: 2025-02-18 13:05:10
+ * @FilePath: \wot-design-uni\src\uni_modules\wot-design-uni\locale\lang\zh-TW.ts
+ * 记得注释
+ */
 export default {
   calendar: {
     placeholder: '請選擇',
@@ -16,7 +24,7 @@ export default {
     endWeek: '結束週',
     startMonth: '開始月',
     endMonth: '結束月',
-    monthFormat: 'YYYY年MM月',
+    monthFormat: 'YYYY年MM月'
   },
   calendarView: {
     startTime: '開始',
@@ -30,37 +38,20 @@ export default {
     month: 'M月',
     hour: (value: number) => `${value} 時`,
     minute: (value: number) => `${value} 分`,
-    second: (value: number) => `${value} 秒`,
+    second: (value: number) => `${value} 秒`
   },
   collapse: { expand: '展開', retract: '收起' },
   colPicker: { title: '請選擇', placeholder: '請選擇', select: '請選擇' },
-  datetimePicker: {
-    start: '開始時間',
-    end: '結束時間',
-    to: '至',
-    placeholder: '請選擇',
-    confirm: '完成',
-    cancel: '取消',
-  },
-  loadmore: {
-    loading: '正在努力加載中...',
-    finished: '已加載完畢',
-    error: '加載失敗',
-    retry: '點擊重試',
-  },
-  messageBox: {
-    inputPlaceholder: '請輸入',
-    confirm: '確定',
-    cancel: '取消',
-    inputNoValidate: '輸入的數據不合法',
-  },
+  datetimePicker: { start: '開始時間', end: '結束時間', to: '至', placeholder: '請選擇', confirm: '完成', cancel: '取消' },
+  loadmore: { loading: '正在努力加載中...', finished: '已加載完畢', error: '加載失敗', retry: '點擊重試' },
+  messageBox: { inputPlaceholder: '請輸入', confirm: '確定', cancel: '取消', inputNoValidate: '輸入的數據不合法' },
   numberKeyboard: { confirm: '完成' },
   pagination: {
     prev: '上一頁',
     next: '下一頁',
     page: (value: number) => `當前頁：${value}`,
     total: (total: number) => `當前數據：${total}條`,
-    size: (size: number) => `分頁大小：${size}`,
+    size: (size: number) => `分頁大小：${size}`
   },
   picker: { cancel: '取消', done: '完成', placeholder: '請選擇' },
   imgCropper: { confirm: '完成', cancel: '取消' },
@@ -69,16 +60,16 @@ export default {
   tabs: { all: '全部' },
   upload: { error: '上傳失敗' },
   input: { placeholder: '請輸入...' },
-  selectPicker: {
-    title: '請選擇',
-    placeholder: '請選擇',
-    select: '確認',
-    confirm: '確認',
-    filterPlaceholder: '搜索',
-  },
+  selectPicker: { title: '請選擇', placeholder: '請選擇', select: '確認', confirm: '確認', filterPlaceholder: '搜索' },
   tag: { placeholder: '請輸入', add: '新增標籤' },
   textarea: { placeholder: '請輸入...' },
   tableCol: {
-    indexLabel: '序號',
+    indexLabel: '序號'
   },
+  signature: {
+    confirmText: '確認',
+    clearText: '清空',
+    revokeText: '撤銷',
+    restoreText: '恢復'
+  }
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "id": "@tplc/wot",
   "name": "@tplc/wot",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "keywords": [
     "wot-design-uni",
     "国际化",

package/types/components/common/interceptor.d.ts

@@ -0,0 +1,15 @@
+export type Interceptor = (...args: any[]) => Promise<boolean> | boolean | undefined | void
+export declare function callInterceptor(
+  interceptor: Interceptor | undefined,
+  {
+    args,
+    done,
+    canceled,
+    error,
+  }: {
+    args?: unknown[]
+    done: () => void
+    canceled?: () => void
+    error?: () => void
+  },
+): void

package/types/components/common/util.d.ts

@@ -67,6 +67,12 @@ export declare const checkPixelRange: (num: number, label?: string) => void
  * @returns {string} 十六进制颜色代码 (#RRGGBB)。
  */
 export declare function rgbToHex(r: number, g: number, b: number): string
+/**
+ * 将十六进制颜色代码转换为 RGB 颜色数组。
+ * @param hex 十六进制颜色代码（例如：'#RRGGBB'）
+ * @returns 包含红、绿、蓝三个颜色分量的数组
+ */
+export declare function hexToRgb(hex: string): number[]
 /**
  * 计算渐变色的中间变量数组。
  * @param {string} startColor 开始颜色
@@ -107,12 +113,14 @@ export type RectResultType<T extends boolean> = T extends true ? UniApp.NodeInfo
  * @param selector 节点选择器 #id,.class
  * @param all 是否返回所有 selector 对应的节点
  * @param scope 作用域（支付宝小程序无效）
+ * @param useFields 是否使用 fields 方法获取节点信息
  * @returns 节点信息或节点信息数组
  */
 export declare function getRect<T extends boolean>(
   selector: string,
   all: T,
   scope?: any,
+  useFields?: boolean,
 ): Promise<RectResultType<T>>
 /**
  * 将驼峰命名转换为短横线命名。
@@ -181,13 +189,25 @@ export declare function isBase64Image(url: string): boolean
  * @returns {string} 格式化后的 CSS 样式字符串
  */
 export declare function objToStyle(styles: Record<string, any> | Record<string, any>[]): string
+/**
+ * 判断一个对象是否包含任何字段
+ * @param obj 要检查的对象
+ * @returns {boolean} 如果对象为空（不包含任何字段）则返回 true，否则返回 false
+ */
+export declare function hasFields(obj: unknown): boolean
+/**
+ * 判断一个对象是否为空对象（不包含任何字段）
+ * @param obj 要检查的对象
+ * @returns {boolean} 如果对象为空（不包含任何字段）则返回 true，否则返回 false
+ */
+export declare function isEmptyObj(obj: unknown): boolean
 export declare const requestAnimationFrame: (cb?: () => void) => AbortablePromise<unknown>
 /**
  * 暂停指定时间函数
  * @param ms 延迟时间
  * @returns
  */
-export declare const pause: (ms: number) => AbortablePromise<unknown>
+export declare const pause: (ms?: number) => AbortablePromise<unknown>
 /**
  * 深拷贝函数，用于将对象进行完整复制。
  * @param obj 要深拷贝的对象
@@ -280,4 +300,44 @@ export declare function omitBy<O extends Record<string, any>>(
  * @returns 计算出的当前值
  */
 export declare function easingFn(t?: number, b?: number, c?: number, d?: number): number
+/**
+ * 从数组中寻找最接近目标值的元素
+ *
+ * @param arr 数组
+ * @param target 目标值
+ * @returns 最接近目标值的元素
+ */
+export declare function closest(arr: number[], target: number): number
+/**
+ * 系统信息接口，包含项目中实际使用的字段
+ */
+export interface SystemInfo {
+  /** 窗口宽度 */
+  windowWidth: number
+  /** 窗口高度 */
+  windowHeight: number
+  /** 窗口顶部位置 */
+  windowTop: number
+  /** 设备像素比 */
+  pixelRatio: number
+  /** 平台信息 */
+  platform: string
+  /** 主题模式 */
+  theme?: string
+  /** 状态栏高度 */
+  statusBarHeight?: number
+  /** 安全区域信息 */
+  safeArea?: UniApp.SafeArea
+  /** 屏幕高度 */
+  screenHeight: number
+  /** 安全区域插入信息 */
+  safeAreaInsets?: UniApp.SafeAreaInsets
+  [key: string]: any
+}
+/**
+ * 兼容微信小程序端获取系统信息的方法
+ * 在微信小程序端使用新的API替代getSystemInfoSync，在其他端仍然使用getSystemInfoSync
+ * @returns 系统信息对象
+ */
+export declare function getSystemInfo(): SystemInfo
 export {}

package/types/components/composables/useCell.d.ts

@@ -1,3 +1,3 @@
 export declare function useCell(): {
-  border: import('vue').ComputedRef<any>
+  border: import('vue').ComputedRef<number | false | null | undefined>
 }

package/types/components/composables/useLockScroll.d.ts

@@ -1,5 +1,4 @@
-declare function useLockScroll(shouldLock: () => boolean): {
+export declare const useLockScroll: (shouldLock: () => boolean) => {
   lock: () => void
   unlock: () => void
 }
-export default useLockScroll

package/types/components/composables/useParent.d.ts

@@ -15,7 +15,7 @@ export declare function useParent<T>(key: InjectionKey<ParentProvide<T>>):
       index: import('vue').ComputedRef<number>
     }
   | {
-      parent: any
+      parent: null
       index: import('vue').Ref<number>
     }
 export {}

package/types/components/composables/usePopover.d.ts

@@ -1,4 +1,4 @@
-export declare function usePopover(): {
+export declare function usePopover(visibleArrow?: boolean): {
   popStyle: import('vue').Ref<string>
   arrowStyle: import('vue').Ref<string>
   showStyle: import('vue').Ref<string>
@@ -34,7 +34,7 @@ export declare function usePopover(): {
       | 'right'
       | 'right-start'
       | 'right-end',
-    offset: number,
+    offset: number | number[] | Record<'x' | 'y', number>,
   ) => void
   noop: () => void
 }

package/types/components/composables/useUpload.d.ts

@@ -0,0 +1,41 @@
+import type {
+  ChooseFile,
+  ChooseFileOption,
+  UploadFileItem,
+  UploadMethod,
+  UploadStatusType,
+} from '../wd-upload/types'
+export declare const UPLOAD_STATUS: Record<string, UploadStatusType>
+export interface UseUploadReturn {
+  startUpload: (
+    file: UploadFileItem,
+    options: UseUploadOptions,
+  ) => UniApp.UploadTask | void | Promise<void>
+  abort: (task?: UniApp.UploadTask) => void
+  UPLOAD_STATUS: Record<string, UploadStatusType>
+  chooseFile: (options: ChooseFileOption) => Promise<ChooseFile[]>
+}
+export interface UseUploadOptions {
+  action: string
+  header?: Record<string, any>
+  name?: string
+  formData?: Record<string, any>
+  fileType?: 'image' | 'video' | 'audio'
+  statusCode?: number
+  statusKey?: string
+  uploadMethod?: UploadMethod
+  onSuccess?: (
+    res: UniApp.UploadFileSuccessCallbackResult,
+    file: UploadFileItem,
+    formData: Record<string, any>,
+  ) => void
+  onError?: (
+    res: UniApp.GeneralCallbackResult,
+    file: UploadFileItem,
+    formData: Record<string, any>,
+  ) => void
+  onProgress?: (res: UniApp.OnProgressUpdateResult, file: UploadFileItem) => void
+  abortPrevious?: boolean
+  extension?: string[]
+}
+export declare function useUpload(): UseUploadReturn

package/types/components/wd-action-sheet/types.d.ts

@@ -7,19 +7,19 @@ export type Action = {
   /**
    * 描述信息
    */
-  subname: string
+  subname?: string
   /**
    * 颜色
    */
-  color: string
+  color?: string
   /**
    * 禁用
    */
-  disabled: boolean
+  disabled?: boolean
   /**
    * 加载中状态
    */
-  loading: boolean
+  loading?: boolean
 }
 export type Panel = {
   /**
@@ -133,6 +133,15 @@ export declare const actionSheetProps: {
     type: BooleanConstructor
     default: boolean
   }
+  /**
+   * 是否从页面中脱离出来，用于解决各种 fixed 失效问题 (H5: teleport, APP: renderjs, 小程序: root-portal)
+   * 类型：boolean
+   * 默认值：false
+   */
+  rootPortal: {
+    type: BooleanConstructor
+    default: boolean
+  }
   customStyle: {
     type: import('vue').PropType<string>
     default: string