@zamlia/mini-ui 0.0.12 → 0.0.13

package/lib/index.d.ts

@@ -2,6 +2,87 @@ import React, { CSSProperties, PropsWithChildren, MutableRefObject } from 'react
 import { PopupProps, DialogProps } from '@nutui/nutui-react-taro';
 import { ITouchEvent } from '@tarojs/components';
 
+/**
+ * 组件类型统一入口 - Components
+ * 约定：组件 Props 以 XxxProps 命名，Ref 以 XxxRef 命名
+ */
+/** 组件基础 Props：通用可选能力 */
+interface BaseComponentProps {
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+}
+
+/**
+ * 工具类型统一入口 - Utils
+ * 约定：请求参数以 XxxParams 命名，返回/结果以 XxxResult 命名，实体以语义命名（如 GeoLocation）
+ */
+/**
+ * 经纬度信息
+ */
+type GeoLocation = {
+    /** 经度 */
+    longitude: number;
+    /** 纬度 */
+    latitude: number;
+};
+/**
+ * 弹窗
+ */
+type ShowToast = {
+    /** 提示的内容 */
+    title: string;
+    /** 接口调用结束的回调函数（调用成功、失败都会执行） */
+    complete?: (res: TaroGeneral.CallbackResult) => void;
+    /** 提示的延迟时间 */
+    duration?: number;
+    /** 接口调用失败的回调函数 */
+    fail?: (res: TaroGeneral.CallbackResult) => void;
+    /** 图标
+     *
+     * 可选值：
+     * - 'success': 显示成功图标，此时 title 文本最多显示 7 个汉字长度;
+     * - 'error': 显示失败图标，此时 title 文本最多显示 7 个汉字长度;
+     * - 'loading': 显示加载图标，此时 title 文本最多显示 7 个汉字长度;
+     * - 'none': 不显示图标，此时 title 文本最多可显示两行 */
+    icon?: 'success' | 'error' | 'loading' | 'none';
+    /** 自定义图标的本地路径，image 的优先级高于 icon */
+    image?: string;
+    /** 是否显示透明蒙层，防止触摸穿透 */
+    mask?: boolean;
+    /** 接口调用成功的回调函数 */
+    success?: (res: TaroGeneral.CallbackResult) => void;
+};
+type SignType = 
+/** 仅在微信支付 v2 版本接口适用 */
+'MD5'
+/** 仅在微信支付 v2 版本接口适用 */
+ | 'HMAC-SHA256'
+/** 仅在微信支付 v3 版本接口适用 */
+ | 'RSA';
+/**
+ * 微信支付结果
+ */
+type WechatPayResult = {
+    timeStamp: string;
+    nonceStr: string;
+    packageValue: string;
+    signType?: SignType;
+    paySign: string;
+    tradeId: string;
+};
+/**
+ * 微信支付参数
+ */
+interface WechatPayParams {
+    timeStamp: string;
+    nonceStr: string;
+    package: string;
+    signType?: SignType;
+    paySign: string;
+}
+
 type BottomPopupProps = {
     /**
      * 标题
@@ -536,50 +617,90 @@ declare const CitySelectButton: React.FC<CitySelectButtonProps>;
  */
 declare const Utils: {
     /**
-     * 检查值是否为空
-     * @param value 要检查的值
-     * @returns 如果值为空返回 true，否则返回 false
-     */
-    isEmpty(value: any): boolean;
+     * 获取随机数
+     * @public
+     * @param {number} min 最小值
+     * @param {number} max 最大值
+     * @returns {number}
+    */
+    getRandom(min: number, max: number): number;
+    /**
+     * base64转图片Url
+     * @public
+     * @param {string} base64Url base64 url
+     * @returns {string}
+    */
+    base64ToImgUrl(base64Url: string): string;
     /**
      * 深拷贝对象
      * @param obj 要拷贝的对象
      * @returns 深拷贝后的新对象
      */
     cloneDeep<T>(obj: T): T;
-    /**
-     * 判断 URL 是否是图片
-     * @param url 要检查的 URL
-     * @returns 如果是图片返回 true，否则返回 false
-     *
-     * @example
-     * isImg('https://example.com/image.jpg') // => true
-     * isImg('https://example.com/image.png') // => true
-     * isImg('https://example.com/video.mp4') // => false
-     */
-    isImg(url: string): boolean;
-    /**
-     * 判断 URL 是否是视频
-     * @param url 要检查的 URL
-     * @returns 如果是视频返回 true，否则返回 false
-     *
-     * @example
-     * isVideo('https://example.com/video.mp4') // => true
-     * isVideo('https://example.com/video.mov') // => true
-     * isVideo('https://example.com/image.jpg') // => false
-     */
-    isVideo(url: string): boolean;
-    /**
-     * 将字符串多余长度转化为...
-     * @param str 字符串
-     * @param len 字符串长度
-     */
-    substr(str: string, len: number): string;
     /**
      * 等待
      */
     delay: (delayTime?: number) => Promise<void>;
+    onlinePay: (payParams: WechatPayParams, tradeId?: string) => Promise<boolean>;
+    wechatPay: (payParams: WechatPayParams, tradeId?: string) => Promise<boolean>;
+    aliPay: (tradeId?: string) => Promise<boolean>;
+    dev: () => void;
+    env: (isCapitalization?: boolean) => string;
+    envText: () => string;
+    showToast: (params: ShowToast & {
+        delay
+        /**
+         * 深拷贝对象
+         * @param obj 要拷贝的对象
+         * @returns 深拷贝后的新对象
+         */
+        ?: number;
+    }) => void;
+    setCopyContent(content: string): void;
+    scanCode: (isonlyFromCamera?: boolean) => Promise<string>;
+    miniLogin: () => Promise<void | string>;
+    getLocation(): Promise<GeoLocation>;
+    updateVersion(): void;
+    openLocation: (location?: number[], options?: {
+        scale?: number;
+        name?: string;
+        address?: string;
+    }) => void;
+    previewImage(current: string, urlArr: string[]): void;
+    setCacheParams: (params: Record<string, any>) => void;
+    getCacheParams: () => Record<string, any>;
+    removeCacheParams: () => void;
+    jsonStrToObj(jsonStr: string): Record<string, any>;
+    objectToParams(params: Record<string, any>): string;
+    objectCleanEmpty(obj: Record<string, any>): Record<string, any>;
+    shuffle(arr: (Record<string, any> | string | number)[]): (Record<string, any> | string | number)[];
+    arrayToTree<T>(array?: T[], id?: string, parentId?: string, children?: string): Array<T>;
+    formatAmount(amount: string | number): string;
+    formatDate(time: string, format?: string): string;
+    formatDateCn(dateStr: string): string;
+    substr(str: string, len: number): string;
+    generateNonceStr: (len: number) => string;
+    urlEcode: (url: string) => string;
+    urlDecode: (url: string) => string;
+    hexToRgbaColor(colorCode: string, opacity?: number): string;
+    isAlipay: () => boolean;
+    isWeapp: () => boolean;
+    isNumberStr(str: string): boolean;
+    isText: (value: string) => boolean;
+    isHexColor(text: string): boolean;
+    isRgbOrRgbaColor(text: string): boolean;
+    isMobile(text: string): boolean;
+    isPhone(text: string): boolean;
+    isEmail(text: string): boolean;
+    isURL(text: string): boolean;
+    isIdCard(text: string): boolean;
+    isMoney(text: string): boolean;
+    isName(text: string): boolean;
+    isCompanyCode(text: string): boolean;
+    isEmpty(value: any): boolean;
+    isImg(url: string): boolean;
+    isVideo(url: string): boolean;
 };
 
 export { _default as BottomPopup, Card, CitySelectButton, DataSelect, Modal, NavBar, Page, PaymentMethodSelect, WrappedPullToPushRefresh as PullToPushRefresh, Radio, Tabs, UploadFile, Utils, VideoView };
-export type { BottomPopupProps, CardProps, CitySelectButtonProps, DataSelectProps, ModalProps, NavBarProps, PageProps, PaymentMethod, PaymentMethodSelectProps, PullToPushRefreshProps, RadioProps, TabsProps, UploadFileProps, VideoViewProps };
+export type { BaseComponentProps, BottomPopupProps, CardProps, CitySelectButtonProps, DataSelectProps, GeoLocation, ModalProps, NavBarProps, PageProps, PaymentMethod, PaymentMethodSelectProps, PullToPushRefreshProps, RadioProps, ShowToast, TabsProps, UploadFileProps, VideoViewProps, WechatPayParams, WechatPayResult };

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAA;AAGnC,cAAc,uBAAuB,CAAA;AAGrC,cAAc,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,SAAS,CAAA;AAGvB,cAAc,qBAAqB,CAAA;AAGnC,cAAc,uBAAuB,CAAA;AAGrC,cAAc,SAAS,CAAA"}