@pisell/utils 3.0.5 → 3.0.7

package/es/jsBridge/index.d.ts

@@ -1,113 +1,11 @@
-declare type LanguageNumber = {
-    en: number;
-    zh_CN: number;
-    zh_HK: number;
-};
-declare type LanguageString = {
-    en: string;
-    zh_CN: string;
-    zh_HK: string;
-} | string;
-/**
- * 打印小票
- */
-declare type WebPrint0 = {
-    /**
-     * 打印类型
-     * 0: 小票
-     * 1：ITS备货单/划菜单
-     * 2：手环
-     */
-    type: "0";
-    data: {
-        /** 订单ID */
-        order_id: string;
-    };
-    /** 打印语言对应的数量 */
-    language: LanguageNumber;
-};
-/**
- * 打印ITS备货单/划菜单
- */
-declare type WebPrint1 = {
-    /**
-     * 打印类型
-     * 0: 小票
-     * 1：ITS备货单/划菜单
-     * 2：手环
-     */
-    type: "1";
-    data: {
-        /** 0:备货 1：划单 */
-        mode: "0" | "1";
-        resource: LanguageString;
-        /** 订单备注 */
-        order_note: string;
-        /** 订单时间或商品下单时间 */
-        time: string;
-        /** 订单编号 */
-        order_number?: string;
-        /** 商品 */
-        products: {
-            /** 商品名称 */
-            product_title: LanguageString;
-            /** 商品规格 */
-            product_option_string: LanguageString;
-            /** 商品备注 */
-            product_note: string;
-            /** 商品数量 */
-            product_quantity: number;
-            /** 加菜标识 待定 */
-            is_append?: boolean;
-            /** 退菜标识 待定 */
-            is_removed?: boolean;
-        }[];
-    };
-    /** 打印语言对应的数量 */
-    language: LanguageNumber;
-};
-declare type WebPrint2 = {
-    /**
-     * 打印类型
-     * 0: 小票
-     * 1：ITS备货单/划菜单
-     * 2：手环
-     */
-    type: "2";
-    data: {
-        /** 0: 普通票 1:成人票 2:免费成人票 */
-        type: "0" | "1" | "2";
-        /** 发行编码 */
-        encoded: string;
-        /** 编码 */
-        code: string;
-        /** 到期时间 */
-        expire_date: string;
-        areas: {
-            /** 区域名字 */
-            area_name: string;
-            /** 区域代码 */
-            area_code: string;
-            /** 可用次数 */
-            limit_num: number;
-            /**  已用次数 */
-            used_num: number;
-        }[];
-    };
-};
-declare type WebPrintParams = WebPrint0 | WebPrint1 | WebPrint2;
+import { WebPrintParams, DataManagerParams, WebPaymentParams } from './types';
 /**
  * webView页面中调用打印机打印
  * 此api暂时只支持native app平台下ios手机
  * @param params
  * @param callback
  */
-export declare function webPrint(params: WebPrintParams, callback: (...arg: any) => void): void;
-declare type DataManagerParams = {
-    module: "set" | "get";
-    key: string;
-    data?: any;
-};
+export declare function webPrint(params: WebPrintParams, callback: (...arg: any) => void, onError?: (error: any) => void): void;
 /**
  * webView页面中调用APP内的数据
  * 此api暂时只支持native app平台下ios手机
@@ -115,4 +13,10 @@ declare type DataManagerParams = {
  * @param callback
  */
 export declare function dataManager(params: DataManagerParams, callback: (...arg: any) => void, onError: () => void): void;
-export {};
+/**
+ * webView页面中调用APP内的支付
+ * 此api暂时只支持native app平台下ios
+ * @param params
+ * @param callback
+ */
+export declare function webPayment(params: WebPaymentParams, callback: (...arg: any) => void, onError?: (error: any) => void): void;

package/es/jsBridge/index.js

@@ -1,30 +1,25 @@
 import regDeviceApi from "./regDeviceApi";
-
-/**
- * 打印小票
- */
-
-/**
- * 打印ITS备货单/划菜单
- */
-
 /**
  * webView页面中调用打印机打印
  * 此api暂时只支持native app平台下ios手机
  * @param params
  * @param callback
  */
-export function webPrint(params, _callback) {
+export function webPrint(params, _callback, onError) {
   regDeviceApi().then(function (jsBridge) {
     jsBridge.callDeviceApi({
-      apiName: "webPrint",
+      apiName: 'webPrint',
       params: params,
       callback: function callback() {
         _callback && _callback.apply(void 0, arguments);
       }
     });
+  }).catch(function (err) {
+    onError === null || onError === void 0 || onError(err);
+    console.error('webPrint', err);
   });
 }
+
 /**
  * webView页面中调用APP内的数据
  * 此api暂时只支持native app平台下ios手机
@@ -34,11 +29,32 @@ export function webPrint(params, _callback) {
 export function dataManager(params, _callback2, onError) {
   regDeviceApi().then(function (jsBridge) {
     jsBridge.callDeviceApi({
-      apiName: "dataManager",
+      apiName: 'dataManager',
       params: params,
       callback: function callback() {
         _callback2 && _callback2.apply(void 0, arguments);
       }
     });
   }).catch(onError);
+}
+
+/**
+ * webView页面中调用APP内的支付
+ * 此api暂时只支持native app平台下ios
+ * @param params
+ * @param callback
+ */
+export function webPayment(params, _callback3, onError) {
+  regDeviceApi().then(function (jsBridge) {
+    jsBridge.callDeviceApi({
+      apiName: 'webPayment',
+      params: params,
+      callback: function callback() {
+        _callback3 && _callback3.apply(void 0, arguments);
+      }
+    });
+  }).catch(function (err) {
+    onError === null || onError === void 0 || onError(err);
+    console.error('webPayment', err);
+  });
 }

package/es/jsBridge/types.d.ts

@@ -0,0 +1,149 @@
+declare type LanguageNumber = {
+    en: number;
+    zh_CN: number;
+    zh_HK: number;
+};
+declare type LanguageString = {
+    en: string;
+    zh_CN: string;
+    zh_HK: string;
+} | string;
+/**
+ * 打印小票
+ */
+export declare type WebPrint0 = {
+    /**
+     * 打印类型
+     * 0: 小票
+     * 1：ITS备货单/划菜单
+     * 2：手环
+     */
+    type: '0';
+    data: {
+        /** 订单ID */
+        order_id: string;
+    };
+    /** 打印语言对应的数量 */
+    language: LanguageNumber;
+};
+/**
+ * 打印ITS备货单/划菜单
+ */
+export declare type WebPrint1 = {
+    /**
+     * 打印类型
+     * 0: 小票
+     * 1：ITS备货单/划菜单
+     * 2：手环
+     */
+    type: '1';
+    data: {
+        /** 0:备货 1：划单 */
+        mode: '0' | '1';
+        resource: LanguageString;
+        /** 订单备注 */
+        order_note: string;
+        /** 订单时间或商品下单时间 */
+        time: string;
+        /** 订单编号 */
+        order_number?: string;
+        /** 商品 */
+        products: {
+            /** 商品名称 */
+            product_title: LanguageString;
+            /** 商品规格 */
+            product_option_string: LanguageString;
+            /** 商品备注 */
+            product_note: string;
+            /** 商品数量 */
+            product_quantity: number;
+            /** 加菜标识 待定 */
+            is_append?: boolean;
+            /** 退菜标识 待定 */
+            is_removed?: boolean;
+        }[];
+    };
+    /** 打印语言对应的数量 */
+    language: LanguageNumber;
+};
+/**
+ * 打印手环
+ */
+export declare type WebPrint2 = {
+    /**
+     * 打印类型
+     * 0: 小票
+     * 1：ITS备货单/划菜单
+     * 2：手环
+     */
+    type: '2';
+    data: {
+        /** 0: 普通票 1:成人票 2:免费成人票 */
+        type: '0' | '1' | '2';
+        /** 发行编码 */
+        encoded: string;
+        /** 编码 */
+        code: string;
+        /** 到期时间 */
+        expire_date: string;
+        areas: {
+            /** 区域名字 */
+            area_name: string;
+            /** 区域代码 */
+            area_code: string;
+            /** 可用次数 */
+            limit_num: number;
+            /**  已用次数 */
+            used_num: number;
+        }[];
+    };
+};
+/**
+ * 打印充值卡
+ */
+export declare type WebPrint4 = {
+    type: '4';
+    data: {
+        order_id: string;
+    };
+};
+/**
+ * 打印订单中所有
+ */
+export declare type WebPrint99 = {
+    type: '99';
+    data: {
+        order_id: string;
+        machine_code_print_info: {
+            [key: string]: any;
+        }[];
+        small_ticket_data: {
+            [key: string]: any;
+        };
+    };
+};
+/**
+ * 打印
+ */
+export declare type WebPrintParams = WebPrint0 | WebPrint1 | WebPrint2 | WebPrint4 | WebPrint99;
+/**
+ * 数据管理
+ */
+export declare type DataManagerParams = {
+    module: 'set' | 'get';
+    key: string;
+    data?: any;
+};
+/**
+ * 支付
+ */
+export declare type WebPaymentParams = {
+    module: 'payment' | 'refund' | string;
+    key: 'mx51' | string;
+    data?: {
+        order_id: string | number;
+        amount: string | number;
+        surcharge?: string | number;
+    };
+};
+export {};

package/es/jsBridge/types.js

@@ -0,0 +1 @@
+export {};

package/es/locales.d.ts

@@ -1,12 +1,9 @@
 export declare const locales: {
     init: (_localeMaps: any, _locale: string) => void;
     getText: (id: string) => any;
+    getLocale: () => string;
     locale: string;
     localeMap: any;
-    localeMaps: {
-        en: {};
-        'zh-CN': {};
-        'zh-HK': {};
-    };
+    localeMaps: any;
     formatLocale: (_locale: string) => string;
 };

package/es/locales.js

@@ -8,7 +8,9 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 var localeMaps = {
   en: {},
   'zh-CN': {},
-  'zh-HK': {}
+  'zh-HK': {},
+  'ja': {},
+  'pt': {}
 };
 
 // 当前语言
@@ -17,16 +19,37 @@ var locale = 'en';
 // 当前语言对应的多语言
 var localeMap = {};
 
-// 语言格式化
+// 语言格式化（兼容 BCP 47，如 ja-JP、pt-BR）
 var formatLocale = function formatLocale(_locale) {
   var obj = {
-    'en': 'en',
+    en: 'en',
+    'en-US': 'en',
+    'en-us': 'en',
     'zh-CN': 'zh-CN',
+    'zh-cn': 'zh-CN',
     'zh-HK': 'zh-HK',
+    'zh-hk': 'zh-HK',
     'zh-TW': 'zh-HK',
-    'en-US': 'en'
+    'zh-tw': 'zh-HK',
+    ja: 'ja',
+    'ja-JP': 'ja',
+    'ja-jp': 'ja',
+    pt: 'pt',
+    'pt-BR': 'pt',
+    'pt-br': 'pt',
+    'pt-PT': 'pt',
+    'pt-pt': 'pt'
   };
-  return obj[_locale] || 'en';
+  var direct = obj[_locale];
+  if (direct) return direct;
+  var norm = String(_locale || '').trim().replace(/_/g, '-').toLowerCase();
+  if (obj[norm]) return obj[norm];
+  if (norm.startsWith('ja')) return 'ja';
+  if (norm.startsWith('pt')) return 'pt';
+  if (norm.startsWith('zh-hk') || norm.startsWith('zh-tw')) return 'zh-HK';
+  if (norm.startsWith('zh-cn')) return 'zh-CN';
+  if (norm.startsWith('en')) return 'en';
+  return 'en';
 };
 
 /**
@@ -51,7 +74,6 @@ var init = function init(_localeMaps, _locale) {
 
   // 更新当前语言对应的多语言
   localeMap = localeMaps[locale];
-  console.log('多语言注入成功, 当前语言为:' + locale);
 };
 
 /**
@@ -63,11 +85,18 @@ var init = function init(_localeMaps, _locale) {
  * @Date: 2024-01-17 21:39
  */
 var getText = function getText(id) {
-  return localeMap[id] || id;
+  var _localeMaps2;
+  return localeMap[id] || ((_localeMaps2 = localeMaps) === null || _localeMaps2 === void 0 || (_localeMaps2 = _localeMaps2['en']) === null || _localeMaps2 === void 0 ? void 0 : _localeMaps2[id]) || id;
+};
+
+/** 获取当前语言（与 getText 同源，供 datetime 等组件与 getText 语言一致） */
+var getLocale = function getLocale() {
+  return locale;
 };
 export var locales = {
   init: init,
   getText: getText,
+  getLocale: getLocale,
   locale: locale,
   localeMap: localeMap,
   localeMaps: localeMaps,

package/es/miniRedux.js

@@ -10,7 +10,7 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
-import React, { createContext, useCallback, useReducer, forwardRef, useRef } from 'react';
+import React, { createContext, useCallback, useMemo, useReducer, forwardRef, useRef } from 'react';
 import { jsx as _jsx } from "react/jsx-runtime";
 export var miniRedux = function miniRedux(_ref2) {
   var _ref2$namespace = _ref2.namespace,
@@ -49,6 +49,11 @@ export var miniRedux = function miniRedux(_ref2) {
           });
         }
       }, []);
+
+      // 缓存Context value，避免不必要的重新渲染
+      var contextValue = useMemo(function () {
+        return _defineProperty(_defineProperty({}, namespace, providerState), "dispatch", _dispatch);
+      }, [providerState, _dispatch]);
       var _props = _objectSpread(_objectSpread({}, props), {}, _defineProperty(_defineProperty({}, namespace, providerState), "dispatch", _dispatch));
       var _ref = null;
       if (_props.forwardedRef) {
@@ -56,7 +61,7 @@ export var miniRedux = function miniRedux(_ref2) {
         delete _props.forwardedRef;
       }
       return /*#__PURE__*/_jsx(Context.Provider, {
-        value: _defineProperty(_defineProperty({}, namespace, providerState), "dispatch", _dispatch),
+        value: contextValue,
         children: /*#__PURE__*/_jsx(ComponentUi, _objectSpread(_objectSpread({}, _props), {}, {
           ref: ref
         }))

package/es/number-input/hooks/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 数值输入 Hooks 导出
+ */
+export { useNumberInputState } from './useNumberInputState';

package/es/number-input/hooks/index.js

@@ -0,0 +1,5 @@
+/**
+ * 数值输入 Hooks 导出
+ */
+
+export { useNumberInputState } from "./useNumberInputState";

package/es/number-input/hooks/useNumberInputState.d.ts

@@ -0,0 +1,25 @@
+import type { BaseNumberInputProps, NumberInputState } from '../types';
+/**
+ * 数值输入状态管理 Hook
+ *
+ * 管理组件的内部状态，包括：
+ * - 值管理（受控/非受控模式）
+ * - 校验状态管理
+ * - 事件处理函数封装
+ *
+ * 支持受控和非受控两种模式：
+ * - 受控模式：value 由外部传入，组件不维护内部状态
+ * - 非受控模式：使用 defaultValue，组件维护内部状态
+ *
+ * @param props 组件 Props（包含校验配置）
+ * @returns 数值输入状态对象
+ *
+ * @example
+ * // 受控模式
+ * const state = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
+ *
+ * @example
+ * // 非受控模式
+ * const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
+ */
+export declare function useNumberInputState(props: BaseNumberInputProps): NumberInputState;

package/es/number-input/hooks/useNumberInputState.js

@@ -0,0 +1,129 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useState, useCallback } from 'react';
+import { validateValue } from "../utils/validation";
+/**
+ * 数值输入状态管理 Hook
+ * 
+ * 管理组件的内部状态，包括：
+ * - 值管理（受控/非受控模式）
+ * - 校验状态管理
+ * - 事件处理函数封装
+ * 
+ * 支持受控和非受控两种模式：
+ * - 受控模式：value 由外部传入，组件不维护内部状态
+ * - 非受控模式：使用 defaultValue，组件维护内部状态
+ * 
+ * @param props 组件 Props（包含校验配置）
+ * @returns 数值输入状态对象
+ * 
+ * @example
+ * // 受控模式
+ * const state = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
+ * 
+ * @example
+ * // 非受控模式
+ * const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
+ */
+export function useNumberInputState(props) {
+  var _props$defaultValue;
+  // 判断是否为受控组件
+  var isControlled = props.value !== undefined;
+
+  // 内部状态（仅非受控模式使用）
+  var _useState = useState((_props$defaultValue = props.defaultValue) !== null && _props$defaultValue !== void 0 ? _props$defaultValue : null),
+    _useState2 = _slicedToArray(_useState, 2),
+    innerValue = _useState2[0],
+    setInnerValue = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isTouched = _useState4[0],
+    setIsTouched = _useState4[1];
+  var _useState5 = useState(true),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isValid = _useState6[0],
+    setIsValid = _useState6[1];
+  var _useState7 = useState([]),
+    _useState8 = _slicedToArray(_useState7, 2),
+    errors = _useState8[0],
+    setErrors = _useState8[1];
+
+  // 当前值（受控模式优先使用 props.value）
+  var currentValue = isControlled ? props.value : innerValue;
+
+  /**
+   * 值变更处理函数
+   * 
+   * 1. 更新内部状态（非受控模式）
+   * 2. 根据 validateTrigger 决定是否立即校验
+   * 3. 触发外部 onChange 回调
+   */
+  var handleChange = useCallback(function (newValue) {
+    var _props$onChange;
+    // 更新内部状态（非受控模式）
+    if (!isControlled) {
+      setInnerValue(newValue);
+    }
+
+    // 根据配置决定是否立即校验
+    var shouldValidate = props.validateTrigger === 'onChange' || props.validateTrigger === 'both';
+    if (shouldValidate) {
+      var _props$onValidate;
+      var validation = validateValue(newValue, props);
+      setIsValid(validation.isValid);
+      setErrors(validation.errors);
+      (_props$onValidate = props.onValidate) === null || _props$onValidate === void 0 || _props$onValidate.call(props, validation.isValid, validation.errors);
+    }
+
+    // 触发外部回调
+    (_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, newValue);
+  }, [isControlled, props]);
+
+  /**
+   * 失焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 执行失焦时的校验（根据 validateTrigger）
+   * 3. 触发外部 onBlur 回调
+   */
+  var handleBlur = useCallback(function () {
+    var _props$onBlur;
+    setIsTouched(true);
+
+    // 失焦时执行校验（如果 validateTrigger 不是 'onChange'）
+    var shouldValidate = props.validateTrigger !== 'onChange';
+    if (shouldValidate) {
+      var _props$onValidate2;
+      var validation = validateValue(currentValue, props);
+      setIsValid(validation.isValid);
+      setErrors(validation.errors);
+      (_props$onValidate2 = props.onValidate) === null || _props$onValidate2 === void 0 || _props$onValidate2.call(props, validation.isValid, validation.errors);
+    }
+    (_props$onBlur = props.onBlur) === null || _props$onBlur === void 0 || _props$onBlur.call(props, currentValue !== null && currentValue !== void 0 ? currentValue : null);
+  }, [currentValue, props]);
+
+  /**
+   * 聚焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 触发外部 onFocus 回调
+   */
+  var handleFocus = useCallback(function () {
+    var _props$onFocus;
+    setIsTouched(true);
+    (_props$onFocus = props.onFocus) === null || _props$onFocus === void 0 || _props$onFocus.call(props);
+  }, [props]);
+  return {
+    value: currentValue,
+    isTouched: isTouched,
+    isValid: isValid,
+    errors: errors,
+    handleChange: handleChange,
+    handleBlur: handleBlur,
+    handleFocus: handleFocus
+  };
+}

package/es/number-input/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 数值输入组件公共逻辑导出
+ *
+ * 供以下组件使用：
+ * - PisellNumber
+ * - PisellCurrency
+ * - PisellPercent
+ * - 其他数值输入组件
+ */
+export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps, } from './types';
+export { useNumberInputState } from './hooks';
+export { getDisplayState, formatNumber, addThousandsSeparator, formatPrecision, } from './utils';
+export { validateValue as validateNumberValue } from './utils';
+export type { NumberFormatOptions } from './utils';

package/es/number-input/index.js

@@ -0,0 +1,21 @@
+/**
+ * 数值输入组件公共逻辑导出
+ * 
+ * 供以下组件使用：
+ * - PisellNumber
+ * - PisellCurrency
+ * - PisellPercent
+ * - 其他数值输入组件
+ */
+
+// 类型
+
+// Hooks
+export { useNumberInputState } from "./hooks";
+
+// 工具函数
+export { getDisplayState, formatNumber, addThousandsSeparator, formatPrecision } from "./utils";
+// 使用别名导出避免与 text-input 的 validateValue 重名
+export { validateValue as validateNumberValue } from "./utils";
+
+// 格式化相关类型