@pisell/utils 1.0.56 → 1.0.57

package/es/common/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 公共工具和类型导出
+ */
+export type { DisplayState, ValidationResult } from './types';
+export { getDisplayState } from './stateHelper';

package/es/common/index.js

@@ -0,0 +1,5 @@
+/**
+ * 公共工具和类型导出
+ */
+
+export { getDisplayState } from "./stateHelper";

package/es/common/stateHelper.d.ts

@@ -0,0 +1,18 @@
+import type { DisplayState } from './types';
+/**
+ * 根据 mode 和 disabled 计算组件的显示状态
+ *
+ * 状态优先级：disabled > mode
+ * 当 disabled=true 时，无论 mode 是什么，都显示为禁用态
+ *
+ * @param mode 状态模式（'read' | 'edit'）
+ * @param disabled 是否禁用
+ * @returns 显示状态（'read' | 'edit' | 'disabled'）
+ *
+ * @example
+ * getDisplayState('edit', false) // 'edit'
+ * getDisplayState('read', false) // 'read'
+ * getDisplayState('edit', true)  // 'disabled'
+ * getDisplayState('read', true)  // 'disabled'
+ */
+export declare function getDisplayState(mode?: 'read' | 'edit', disabled?: boolean): DisplayState;

package/es/common/stateHelper.js

@@ -0,0 +1,25 @@
+/**
+ * 根据 mode 和 disabled 计算组件的显示状态
+ * 
+ * 状态优先级：disabled > mode
+ * 当 disabled=true 时，无论 mode 是什么，都显示为禁用态
+ * 
+ * @param mode 状态模式（'read' | 'edit'）
+ * @param disabled 是否禁用
+ * @returns 显示状态（'read' | 'edit' | 'disabled'）
+ * 
+ * @example
+ * getDisplayState('edit', false) // 'edit'
+ * getDisplayState('read', false) // 'read'
+ * getDisplayState('edit', true)  // 'disabled'
+ * getDisplayState('read', true)  // 'disabled'
+ */
+export function getDisplayState(mode, disabled) {
+  // disabled 优先级最高
+  if (disabled) {
+    return 'disabled';
+  }
+
+  // 返回基础模式，默认为 edit
+  return mode || 'edit';
+}

package/es/common/types.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 公共类型定义
+ * 供所有输入组件使用
+ */
+/**
+ * 显示状态类型
+ *
+ * 所有输入组件的三种状态：
+ * - read: 只读态，纯文本展示
+ * - edit: 编辑态，显示输入控件
+ * - disabled: 禁用态，禁用的输入控件
+ */
+export declare type DisplayState = 'read' | 'edit' | 'disabled';
+/**
+ * 校验结果类型
+ *
+ * 所有输入组件的校验结果统一格式
+ */
+export interface ValidationResult {
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+}

package/es/common/types.js

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

package/es/index.d.ts

@@ -0,0 +1,24 @@
+export * from './otherUtils';
+export * from './typeUtils';
+export * from './document';
+export * from './date';
+export * from './platform';
+export * from './log';
+export * from './format';
+export * from './escPosPrinter';
+export * from './miniRedux';
+export * from './jsBridge';
+export * from './image';
+export * from './locales';
+export * from './arrayUtils';
+export * from './walletValidity';
+export * from './common';
+export * from './text-input';
+export * from './number-input';
+export * from './select';
+export declare const setPisellUtilsConfig: (config: {
+    [key: string]: any;
+}) => void;
+export declare const getPisellUtilsConfig: () => {
+    [key: string]: any;
+};

package/es/index.js

@@ -18,6 +18,10 @@ export * from "./image";
 export * from "./locales";
 export * from "./arrayUtils";
 export * from "./walletValidity";
+export * from "./common";
+export * from "./text-input";
+export * from "./number-input";
+export * from "./select";
 // export { default as firebase } from './firebase';
 
 export var setPisellUtilsConfig = function setPisellUtilsConfig(config) {

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";
+
+// 格式化相关类型

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

@@ -0,0 +1,96 @@
+/**
+ * 数值输入组件公共类型定义
+ * 供 PisellNumber、PisellCurrency、PisellPercent 等组件使用
+ */
+export type { DisplayState, ValidationResult } from '../common';
+/**
+ * 数值输入状态 Hook 返回值
+ */
+export interface NumberInputState {
+    /**
+     * 当前值
+     */
+    value: number | null | undefined;
+    /**
+     * 是否已被触摸（交互过）
+     */
+    isTouched: boolean;
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+    /**
+     * 值变更处理函数
+     */
+    handleChange: (value: number | null) => void;
+    /**
+     * 失焦处理函数
+     */
+    handleBlur: () => void;
+    /**
+     * 聚焦处理函数
+     */
+    handleFocus: () => void;
+}
+/**
+ * 基础数值输入 Props（供校验和状态管理使用）
+ */
+export interface BaseNumberInputProps {
+    /**
+     * 当前值（受控）
+     */
+    value?: number | null;
+    /**
+     * 默认值（非受控）
+     */
+    defaultValue?: number | null;
+    /**
+     * 是否必填
+     */
+    required?: boolean;
+    /**
+     * 最小值
+     */
+    min?: number;
+    /**
+     * 最大值
+     */
+    max?: number;
+    /**
+     * 自定义校验函数
+     * @param value 当前值
+     * @returns true 表示通过，false 或错误信息字符串表示不通过
+     */
+    validator?: (value: number | null) => boolean | string;
+    /**
+     * 校验触发时机
+     * - onChange: 输入时即时校验
+     * - onBlur: 失焦时校验
+     * - both: 输入和失焦时都校验
+     */
+    validateTrigger?: 'onChange' | 'onBlur' | 'both';
+    /**
+     * 自定义错误提示信息
+     */
+    errorMessage?: string;
+    /**
+     * 值变更回调
+     */
+    onChange?: (value: number | null) => void;
+    /**
+     * 失焦回调
+     */
+    onBlur?: (value: number | null) => void;
+    /**
+     * 聚焦回调
+     */
+    onFocus?: () => void;
+    /**
+     * 校验回调
+     */
+    onValidate?: (isValid: boolean, errors: string[]) => void;
+}

package/es/number-input/types.js

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

package/es/number-input/utils/formatter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 数值格式化工具函数
+ */
+/**
+ * 格式化选项
+ */
+export interface NumberFormatOptions {
+    /** 小数精度 */
+    precision?: number;
+    /** 是否使用千分位分隔符 */
+    useGrouping?: boolean;
+    /** 自定义格式化函数 */
+    formatter?: (value: number | null) => string;
+}
+/**
+ * 格式化数值
+ *
+ * @param value 数值
+ * @param options 格式化选项
+ * @returns 格式化后的字符串，null 时返回 null
+ *
+ * @example
+ * formatNumber(1234.567, { precision: 2, useGrouping: true })
+ * // 返回: "1,234.57"
+ *
+ * @example
+ * formatNumber(1234, { precision: 0, useGrouping: true })
+ * // 返回: "1,234"
+ */
+export declare function formatNumber(value: number | null | undefined, options?: NumberFormatOptions): string | null;
+/**
+ * 添加千分位分隔符
+ *
+ * @param value 数值
+ * @returns 添加千分位后的字符串
+ *
+ * @example
+ * addThousandsSeparator(1234567)
+ * // 返回: "1,234,567"
+ */
+export declare function addThousandsSeparator(value: number): string;
+/**
+ * 格式化精度
+ *
+ * @param value 数值
+ * @param precision 小数位数
+ * @returns 格式化后的数值
+ *
+ * @example
+ * formatPrecision(1.2345, 2)
+ * // 返回: 1.23
+ */
+export declare function formatPrecision(value: number, precision: number): number;

package/es/number-input/utils/formatter.js

@@ -0,0 +1,82 @@
+/**
+ * 数值格式化工具函数
+ */
+
+/**
+ * 格式化选项
+ */
+
+/**
+ * 格式化数值
+ * 
+ * @param value 数值
+ * @param options 格式化选项
+ * @returns 格式化后的字符串，null 时返回 null
+ * 
+ * @example
+ * formatNumber(1234.567, { precision: 2, useGrouping: true })
+ * // 返回: "1,234.57"
+ * 
+ * @example
+ * formatNumber(1234, { precision: 0, useGrouping: true })
+ * // 返回: "1,234"
+ */
+export function formatNumber(value) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  // 处理空值
+  if (value === null || value === undefined) {
+    return null;
+  }
+  var precision = options.precision,
+    _options$useGrouping = options.useGrouping,
+    useGrouping = _options$useGrouping === void 0 ? false : _options$useGrouping,
+    formatter = options.formatter;
+
+  // 优先使用自定义格式化函数
+  if (formatter) {
+    return formatter(value);
+  }
+
+  // 使用 toLocaleString 进行格式化
+  if (useGrouping || precision !== undefined) {
+    return value.toLocaleString('zh-CN', {
+      minimumFractionDigits: precision,
+      maximumFractionDigits: precision,
+      useGrouping: useGrouping
+    });
+  }
+
+  // 默认转字符串
+  return String(value);
+}
+
+/**
+ * 添加千分位分隔符
+ * 
+ * @param value 数值
+ * @returns 添加千分位后的字符串
+ * 
+ * @example
+ * addThousandsSeparator(1234567)
+ * // 返回: "1,234,567"
+ */
+export function addThousandsSeparator(value) {
+  return value.toLocaleString('zh-CN', {
+    useGrouping: true
+  });
+}
+
+/**
+ * 格式化精度
+ * 
+ * @param value 数值
+ * @param precision 小数位数
+ * @returns 格式化后的数值
+ * 
+ * @example
+ * formatPrecision(1.2345, 2)
+ * // 返回: 1.23
+ */
+export function formatPrecision(value, precision) {
+  return Number(value.toFixed(precision));
+}

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

@@ -0,0 +1,7 @@
+/**
+ * 数值输入工具函数导出
+ */
+export { validateValue } from './validation';
+export { getDisplayState } from '../../common';
+export { formatNumber, addThousandsSeparator, formatPrecision } from './formatter';
+export type { NumberFormatOptions } from './formatter';

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

@@ -0,0 +1,8 @@
+/**
+ * 数值输入工具函数导出
+ */
+
+export { validateValue } from "./validation";
+// getDisplayState 已移到公共模块，从 common 重新导出
+export { getDisplayState } from "../../common";
+export { formatNumber, addThousandsSeparator, formatPrecision } from "./formatter";

package/es/number-input/utils/validation.d.ts

@@ -0,0 +1,27 @@
+import type { BaseNumberInputProps, ValidationResult } from '../types';
+/**
+ * 校验数值输入
+ *
+ * 按照优先级执行校验规则：
+ * 1. 必填校验（required）
+ * 2. 最小值校验（min）
+ * 3. 最大值校验（max）
+ * 4. 自定义校验函数（validator）
+ *
+ * @param value 待校验的值
+ * @param props 校验配置
+ * @returns 校验结果对象，包含 isValid 和 errors
+ *
+ * @example
+ * validateValue(10, { required: true, min: 0, max: 100 })
+ * // { isValid: true, errors: [] }
+ *
+ * @example
+ * validateValue(null, { required: true })
+ * // { isValid: false, errors: ['此字段为必填项'] }
+ *
+ * @example
+ * validateValue(150, { min: 0, max: 100 })
+ * // { isValid: false, errors: ['不能大于 100'] }
+ */
+export declare function validateValue(value: number | null | undefined, props: BaseNumberInputProps): ValidationResult;

package/es/number-input/utils/validation.js

@@ -0,0 +1,67 @@
+/**
+ * 校验数值输入
+ * 
+ * 按照优先级执行校验规则：
+ * 1. 必填校验（required）
+ * 2. 最小值校验（min）
+ * 3. 最大值校验（max）
+ * 4. 自定义校验函数（validator）
+ * 
+ * @param value 待校验的值
+ * @param props 校验配置
+ * @returns 校验结果对象，包含 isValid 和 errors
+ * 
+ * @example
+ * validateValue(10, { required: true, min: 0, max: 100 })
+ * // { isValid: true, errors: [] }
+ * 
+ * @example
+ * validateValue(null, { required: true })
+ * // { isValid: false, errors: ['此字段为必填项'] }
+ * 
+ * @example
+ * validateValue(150, { min: 0, max: 100 })
+ * // { isValid: false, errors: ['不能大于 100'] }
+ */
+export function validateValue(value, props) {
+  var errors = [];
+
+  // 1. 必填校验
+  if (props.required && (value === null || value === undefined)) {
+    errors.push(props.errorMessage || '此字段为必填项');
+    return {
+      isValid: false,
+      errors: errors
+    };
+  }
+
+  // 如果值为空且非必填，直接返回有效
+  if (value === null || value === undefined) {
+    return {
+      isValid: true,
+      errors: errors
+    };
+  }
+
+  // 2. 最小值校验
+  if (props.min !== undefined && value < props.min) {
+    errors.push("\u4E0D\u80FD\u5C0F\u4E8E ".concat(props.min));
+  }
+
+  // 3. 最大值校验
+  if (props.max !== undefined && value > props.max) {
+    errors.push("\u4E0D\u80FD\u5927\u4E8E ".concat(props.max));
+  }
+
+  // 4. 自定义校验函数
+  if (props.validator) {
+    var result = props.validator(value);
+    if (result !== true) {
+      errors.push(typeof result === 'string' ? result : '校验失败');
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors: errors
+  };
+}