@pisell/utils 3.0.6 → 3.0.7

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

@@ -1,72 +1,129 @@
-import { validateValue } from "../utils/validation.js";
-import { useCallback, useState } from "react";
-//#region src/number-input/hooks/useNumberInputState.ts
+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 });
-*/
-function useNumberInputState(props) {
-	var _props$defaultValue;
-	const isControlled = props.value !== void 0;
-	const [innerValue, setInnerValue] = useState((_props$defaultValue = props.defaultValue) !== null && _props$defaultValue !== void 0 ? _props$defaultValue : null);
-	const [isTouched, setIsTouched] = useState(false);
-	const [isValid, setIsValid] = useState(true);
-	const [errors, setErrors] = useState([]);
-	const currentValue = isControlled ? props.value : innerValue;
-	return {
-		value: currentValue,
-		isTouched,
-		isValid,
-		errors,
-		handleChange: useCallback((newValue) => {
-			var _props$onChange;
-			if (!isControlled) setInnerValue(newValue);
-			if (props.validateTrigger === "onChange" || props.validateTrigger === "both") {
-				var _props$onValidate;
-				const 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]),
-		handleBlur: useCallback(() => {
-			var _props$onBlur;
-			setIsTouched(true);
-			if (props.validateTrigger !== "onChange") {
-				var _props$onValidate2;
-				const 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]),
-		handleFocus: useCallback(() => {
-			var _props$onFocus;
-			setIsTouched(true);
-			(_props$onFocus = props.onFocus) === null || _props$onFocus === void 0 || _props$onFocus.call(props);
-		}, [props])
-	};
-}
-//#endregion
-export { useNumberInputState };
+ * 数值输入状态管理 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

@@ -1,96 +1,96 @@
-import { DisplayState, ValidationResult } from "../common/types.js";
-
-//#region src/number-input/types.d.ts
+/**
+ * 数值输入组件公共类型定义
+ * 供 PisellNumber、PisellCurrency、PisellPercent 等组件使用
+ */
+export type { DisplayState, ValidationResult } from '../common';
 /**
  * 数值输入状态 Hook 返回值
  */
-interface NumberInputState {
-  /**
-   * 当前值
-   */
-  value: number | null | undefined;
-  /**
-   * 是否已被触摸（交互过）
-   */
-  isTouched: boolean;
-  /**
-   * 是否校验通过
-   */
-  isValid: boolean;
-  /**
-   * 错误信息数组
-   */
-  errors: string[];
-  /**
-   * 值变更处理函数
-   */
-  handleChange: (value: number | null) => void;
-  /**
-   * 失焦处理函数
-   */
-  handleBlur: () => void;
-  /**
-   * 聚焦处理函数
-   */
-  handleFocus: () => void;
+export interface NumberInputState {
+    /**
+     * 当前值
+     */
+    value: number | null | undefined;
+    /**
+     * 是否已被触摸（交互过）
+     */
+    isTouched: boolean;
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+    /**
+     * 值变更处理函数
+     */
+    handleChange: (value: number | null) => void;
+    /**
+     * 失焦处理函数
+     */
+    handleBlur: () => void;
+    /**
+     * 聚焦处理函数
+     */
+    handleFocus: () => void;
 }
 /**
  * 基础数值输入 Props（供校验和状态管理使用）
  */
-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;
+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;
 }
-//#endregion
-export { BaseNumberInputProps, NumberInputState };

package/es/number-input/types.js

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

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

@@ -1,17 +1,16 @@
-//#region src/number-input/utils/formatter.d.ts
 /**
  * 数值格式化工具函数
  */
 /**
  * 格式化选项
  */
-interface NumberFormatOptions {
-  /** 小数精度 */
-  precision?: number;
-  /** 是否使用千分位分隔符 */
-  useGrouping?: boolean;
-  /** 自定义格式化函数 */
-  formatter?: (value: number | null) => string;
+export interface NumberFormatOptions {
+    /** 小数精度 */
+    precision?: number;
+    /** 是否使用千分位分隔符 */
+    useGrouping?: boolean;
+    /** 自定义格式化函数 */
+    formatter?: (value: number | null) => string;
 }
 /**
  * 格式化数值
@@ -28,7 +27,7 @@ interface NumberFormatOptions {
  * formatNumber(1234, { precision: 0, useGrouping: true })
  * // 返回: "1,234"
  */
-declare function formatNumber(value: number | null | undefined, options?: NumberFormatOptions): string | null;
+export declare function formatNumber(value: number | null | undefined, options?: NumberFormatOptions): string | null;
 /**
  * 添加千分位分隔符
  *
@@ -39,7 +38,7 @@ declare function formatNumber(value: number | null | undefined, options?: Number
  * addThousandsSeparator(1234567)
  * // 返回: "1,234,567"
  */
-declare function addThousandsSeparator(value: number): string;
+export declare function addThousandsSeparator(value: number): string;
 /**
  * 格式化精度
  *
@@ -51,6 +50,4 @@ declare function addThousandsSeparator(value: number): string;
  * formatPrecision(1.2345, 2)
  * // 返回: 1.23
  */
-declare function formatPrecision(value: number, precision: number): number;
-//#endregion
-export { NumberFormatOptions, addThousandsSeparator, formatNumber, formatPrecision };
+export declare function formatPrecision(value: number, precision: number): number;

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

@@ -1,56 +1,82 @@
-//#region src/number-input/utils/formatter.ts
 /**
-* 格式化数值
-* 
-* @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"
-*/
-function formatNumber(value, options = {}) {
-	if (value === null || value === void 0) return null;
-	const { precision, useGrouping = false, formatter } = options;
-	if (formatter) return formatter(value);
-	if (useGrouping || precision !== void 0) return value.toLocaleString("zh-CN", {
-		minimumFractionDigits: precision,
-		maximumFractionDigits: precision,
-		useGrouping
-	});
-	return String(value);
-}
+ * 数值格式化工具函数
+ */
+
+/**
+ * 格式化选项
+ */
+
 /**
-* 添加千分位分隔符
-* 
-* @param value 数值
-* @returns 添加千分位后的字符串
-* 
-* @example
-* addThousandsSeparator(1234567)
-* // 返回: "1,234,567"
-*/
-function addThousandsSeparator(value) {
-	return value.toLocaleString("zh-CN", { useGrouping: true });
+ * 格式化数值
+ * 
+ * @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 数值
-* @param precision 小数位数
-* @returns 格式化后的数值
-* 
-* @example
-* formatPrecision(1.2345, 2)
-* // 返回: 1.23
-*/
-function formatPrecision(value, precision) {
-	return Number(value.toFixed(precision));
+ * 添加千分位分隔符
+ * 
+ * @param value 数值
+ * @returns 添加千分位后的字符串
+ * 
+ * @example
+ * addThousandsSeparator(1234567)
+ * // 返回: "1,234,567"
+ */
+export function addThousandsSeparator(value) {
+  return value.toLocaleString('zh-CN', {
+    useGrouping: true
+  });
 }
-//#endregion
-export { addThousandsSeparator, formatNumber, formatPrecision };
+
+/**
+ * 格式化精度
+ * 
+ * @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

@@ -1,7 +1,4 @@
-import { ValidationResult } from "../../common/types.js";
-import { BaseNumberInputProps } from "../types.js";
-
-//#region src/number-input/utils/validation.d.ts
+import type { BaseNumberInputProps, ValidationResult } from '../types';
 /**
  * 校验数值输入
  *
@@ -27,6 +24,4 @@ import { BaseNumberInputProps } from "../types.js";
  * validateValue(150, { min: 0, max: 100 })
  * // { isValid: false, errors: ['不能大于 100'] }
  */
-declare function validateValue(value: number | null | undefined, props: BaseNumberInputProps): ValidationResult;
-//#endregion
-export { validateValue };
+export declare function validateValue(value: number | null | undefined, props: BaseNumberInputProps): ValidationResult;