@pisell/utils 3.0.6 → 3.0.7

package/es/select/utils/helpers.js

@@ -1,51 +1,61 @@
-//#region src/select/utils/helpers.ts
 /**
-* 根据值查找选项对象
-* @template T 选项值的类型
-* @param value 选项值
-* @param options 选项列表
-* @returns 找到的选项对象，如果没找到返回 undefined
-*/
-function findOptionByValue(value, options) {
-	return options.find((opt) => opt.value === value);
-}
+ * Select 组件辅助函数
+ */
+
 /**
-* 根据值数组查找选项对象数组
-* @template T 选项值的类型
-* @param values 选项值数组
-* @param options 选项列表
-* @returns 找到的选项对象数组
-*/
-function findOptionsByValues(values, options) {
-	return values.map((val) => findOptionByValue(val, options)).filter(Boolean);
+ * 根据值查找选项对象
+ * @template T 选项值的类型
+ * @param value 选项值
+ * @param options 选项列表
+ * @returns 找到的选项对象，如果没找到返回 undefined
+ */
+export function findOptionByValue(value, options) {
+  return options.find(function (opt) {
+    return opt.value === value;
+  });
 }
+
 /**
-* 判断选项是否被选中（单选）
-* @template T 选项值的类型
-* @param optionValue 选项值
-* @param selectedValue 当前选中值
-* @returns 是否选中
-*/
-function isOptionSelected(optionValue, selectedValue) {
-	return selectedValue !== null && selectedValue !== void 0 && optionValue === selectedValue;
+ * 根据值数组查找选项对象数组
+ * @template T 选项值的类型
+ * @param values 选项值数组
+ * @param options 选项列表
+ * @returns 找到的选项对象数组
+ */
+export function findOptionsByValues(values, options) {
+  return values.map(function (val) {
+    return findOptionByValue(val, options);
+  }).filter(Boolean);
 }
+
 /**
-* 判断选项是否被选中（多选）
-* @template T 选项值的类型
-* @param optionValue 选项值
-* @param selectedValues 当前选中值数组
-* @returns 是否选中
-*/
-function isOptionSelectedInMultiple(optionValue, selectedValues) {
-	return selectedValues.includes(optionValue);
+ * 判断选项是否被选中（单选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValue 当前选中值
+ * @returns 是否选中
+ */
+export function isOptionSelected(optionValue, selectedValue) {
+  return selectedValue !== null && selectedValue !== undefined && optionValue === selectedValue;
 }
+
 /**
-* 生成唯一 ID
-* @param prefix ID 前缀
-* @returns 唯一 ID
-*/
-function generateId(prefix = "select") {
-	return `${prefix}-${Math.random().toString(36).substr(2, 9)}`;
+ * 判断选项是否被选中（多选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValues 当前选中值数组
+ * @returns 是否选中
+ */
+export function isOptionSelectedInMultiple(optionValue, selectedValues) {
+  return selectedValues.includes(optionValue);
 }
-//#endregion
-export { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple };
+
+/**
+ * 生成唯一 ID
+ * @param prefix ID 前缀
+ * @returns 唯一 ID
+ */
+export function generateId() {
+  var prefix = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'select';
+  return "".concat(prefix, "-").concat(Math.random().toString(36).substr(2, 9));
+}

package/es/select/utils/index.d.ts

@@ -1,4 +1,7 @@
-import { calculateTagDisplay } from "./tagAggregation.js";
-import { defaultFilterOption, filterOptions } from "./filterOptions.js";
-import { sortOptions } from "./sortOptions.js";
-import { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple } from "./helpers.js";
+/**
+ * Select 工具函数导出
+ */
+export { calculateTagDisplay } from './tagAggregation';
+export { filterOptions, defaultFilterOption } from './filterOptions';
+export { sortOptions } from './sortOptions';
+export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './helpers';

package/es/select/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Select 工具函数导出
+ */
+
+export { calculateTagDisplay } from "./tagAggregation";
+export { filterOptions, defaultFilterOption } from "./filterOptions";
+export { sortOptions } from "./sortOptions";
+export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId } from "./helpers";

package/es/select/utils/sortOptions.d.ts

@@ -1,6 +1,7 @@
-import { SelectOption, SortDirection } from "../types.js";
-
-//#region src/select/utils/sortOptions.d.ts
+/**
+ * 选项排序工具函数
+ */
+import type { SelectOption, SortDirection } from '../types';
 /**
  * 排序选项列表
  * @template T 选项值的类型
@@ -8,6 +9,4 @@ import { SelectOption, SortDirection } from "../types.js";
  * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
  * @returns 排序后的选项列表（新数组）
  */
-declare function sortOptions<T = string | number>(options: SelectOption<T>[], direction?: SortDirection): SelectOption<T>[];
-//#endregion
-export { sortOptions };
+export declare function sortOptions<T = string | number>(options: SelectOption<T>[], direction?: SortDirection): SelectOption<T>[];

package/es/select/utils/sortOptions.js

@@ -1,20 +1,32 @@
-//#region src/select/utils/sortOptions.ts
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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; }
 /**
-* 排序选项列表
-* @template T 选项值的类型
-* @param options 原始选项列表
-* @param direction 排序方向（'asc' 升序 | 'desc' 降序）
-* @returns 排序后的选项列表（新数组）
-*/
-function sortOptions(options, direction = "asc") {
-	const sortedOptions = [...options];
-	sortedOptions.sort((a, b) => {
-		const labelA = a.label.toLowerCase();
-		const labelB = b.label.toLowerCase();
-		if (direction === "asc") return labelA.localeCompare(labelB);
-		else return labelB.localeCompare(labelA);
-	});
-	return sortedOptions;
-}
-//#endregion
-export { sortOptions };
+ * 选项排序工具函数
+ */
+
+/**
+ * 排序选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+ * @returns 排序后的选项列表（新数组）
+ */
+export function sortOptions(options) {
+  var direction = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'asc';
+  // 创建副本避免修改原数组
+  var sortedOptions = _toConsumableArray(options);
+  sortedOptions.sort(function (a, b) {
+    var labelA = a.label.toLowerCase();
+    var labelB = b.label.toLowerCase();
+    if (direction === 'asc') {
+      return labelA.localeCompare(labelB);
+    } else {
+      return labelB.localeCompare(labelA);
+    }
+  });
+  return sortedOptions;
+}

package/es/select/utils/tagAggregation.d.ts

@@ -1,6 +1,8 @@
-import { SelectOption, TagDisplayInfo } from "../types.js";
-
-//#region src/select/utils/tagAggregation.d.ts
+/**
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
+ */
+import type { SelectOption, TagDisplayInfo } from '../types';
 /**
  * 计算需要显示的标签和聚合信息
  * @template T 选项值的类型
@@ -20,6 +22,4 @@ import { SelectOption, TagDisplayInfo } from "../types.js";
  * // }
  * ```
  */
-declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
-//#endregion
-export { calculateTagDisplay };
+export declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;

package/es/select/utils/tagAggregation.js

@@ -1,35 +1,48 @@
-//#region src/select/utils/tagAggregation.ts
 /**
-* 计算需要显示的标签和聚合信息
-* @template T 选项值的类型
-* @param selectedValues 当前选中的值数组
-* @param options 所有选项列表
-* @param maxTagCount 最多显示的标签数量
-* @returns 标签显示信息
-* 
-* @example
-* ```tsx
-* const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
-* // 返回：
-* // {
-* //   visibleTags: [option_a, option_b],
-* //   hiddenTags: [option_c, option_d],
-* //   hiddenCount: 2
-* // }
-* ```
-*/
-function calculateTagDisplay(selectedValues, options, maxTagCount) {
-	const selectedOptions = selectedValues.map((v) => options.find((opt) => opt.value === v)).filter(Boolean);
-	if (selectedOptions.length <= maxTagCount) return {
-		visibleTags: selectedOptions,
-		hiddenTags: [],
-		hiddenCount: 0
-	};
-	return {
-		visibleTags: selectedOptions.slice(0, maxTagCount),
-		hiddenTags: selectedOptions.slice(maxTagCount),
-		hiddenCount: selectedOptions.length - maxTagCount
-	};
-}
-//#endregion
-export { calculateTagDisplay };
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
+ */
+
+/**
+ * 计算需要显示的标签和聚合信息
+ * @template T 选项值的类型
+ * @param selectedValues 当前选中的值数组
+ * @param options 所有选项列表
+ * @param maxTagCount 最多显示的标签数量
+ * @returns 标签显示信息
+ * 
+ * @example
+ * ```tsx
+ * const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
+ * // 返回：
+ * // {
+ * //   visibleTags: [option_a, option_b],
+ * //   hiddenTags: [option_c, option_d],
+ * //   hiddenCount: 2
+ * // }
+ * ```
+ */
+export function calculateTagDisplay(selectedValues, options, maxTagCount) {
+  // 根据选中值找到对应的选项对象
+  var selectedOptions = selectedValues.map(function (v) {
+    return options.find(function (opt) {
+      return opt.value === v;
+    });
+  }).filter(Boolean);
+
+  // 如果选中数量不超过 maxTagCount，全部显示
+  if (selectedOptions.length <= maxTagCount) {
+    return {
+      visibleTags: selectedOptions,
+      hiddenTags: [],
+      hiddenCount: 0
+    };
+  }
+
+  // 否则进行聚合
+  return {
+    visibleTags: selectedOptions.slice(0, maxTagCount),
+    hiddenTags: selectedOptions.slice(maxTagCount),
+    hiddenCount: selectedOptions.length - maxTagCount
+  };
+}

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

@@ -0,0 +1,4 @@
+/**
+ * 文本输入 Hooks 导出
+ */
+export { useTextInputState } from './useTextInputState';

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

@@ -0,0 +1,5 @@
+/**
+ * 文本输入 Hooks 导出
+ */
+
+export { useTextInputState } from "./useTextInputState";

package/es/text-input/hooks/useTextInputState.d.ts

@@ -1,6 +1,4 @@
-import { BaseTextInputProps, TextInputState } from "../types.js";
-
-//#region src/text-input/hooks/useTextInputState.d.ts
+import type { BaseTextInputProps, TextInputState } from '../types';
 /**
  * 文本输入状态管理 Hook
  *
@@ -23,6 +21,4 @@ import { BaseTextInputProps, TextInputState } from "../types.js";
  * // 非受控模式
  * const state = useTextInputState({ defaultValue: 'hello' });
  */
-declare function useTextInputState(props: BaseTextInputProps): TextInputState;
-//#endregion
-export { useTextInputState };
+export declare function useTextInputState(props: BaseTextInputProps): TextInputState;

package/es/text-input/hooks/useTextInputState.js

@@ -1,70 +1,127 @@
-import { validateValue } from "../utils/validation.js";
-import { useCallback, useState } from "react";
-//#region src/text-input/hooks/useTextInputState.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 = useTextInputState({ value: 'hello', onChange: (v) => console.log(v) });
-* 
-* // 非受控模式
-* const state = useTextInputState({ defaultValue: 'hello' });
-*/
-function useTextInputState(props) {
-	const isControlled = props.value !== void 0;
-	const [innerValue, setInnerValue] = useState(props.defaultValue || "");
-	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 || "");
-		}, [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 { useTextInputState };
+ * 文本输入状态管理 Hook
+ * 
+ * 管理组件的内部状态，包括：
+ * - 值管理（受控/非受控模式）
+ * - 校验状态管理
+ * - 事件处理函数封装
+ * 
+ * 支持受控和非受控两种模式：
+ * - 受控模式：value 由外部传入，组件不维护内部状态
+ * - 非受控模式：使用 defaultValue，组件维护内部状态
+ * 
+ * @param props 组件 Props（包含校验配置）
+ * @returns 文本输入状态对象
+ * 
+ * @example
+ * // 受控模式
+ * const state = useTextInputState({ value: 'hello', onChange: (v) => console.log(v) });
+ * 
+ * // 非受控模式
+ * const state = useTextInputState({ defaultValue: 'hello' });
+ */
+export function useTextInputState(props) {
+  // 判断是否为受控组件
+  var isControlled = props.value !== undefined;
+
+  // 内部状态（仅非受控模式使用）
+  var _useState = useState(props.defaultValue || ''),
+    _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 || '');
+  }, [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/text-input/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 文本输入组件公共逻辑导出
+ *
+ * 供以下组件使用：
+ * - PisellSingleLineText
+ * - PisellLongText
+ * - PisellPhone
+ * - PisellEmail
+ * - PisellUrl
+ */
+export type { DisplayState, ValidationResult, TextInputState, BaseTextInputProps, } from './types';
+export { useTextInputState } from './hooks';
+export { getDisplayState } from './utils';
+export { validateValue as validateTextValue } from './utils';

package/es/text-input/index.js

@@ -0,0 +1,20 @@
+/**
+ * 文本输入组件公共逻辑导出
+ * 
+ * 供以下组件使用：
+ * - PisellSingleLineText
+ * - PisellLongText
+ * - PisellPhone
+ * - PisellEmail
+ * - PisellUrl
+ */
+
+// 类型
+
+// Hooks
+export { useTextInputState } from "./hooks";
+
+// 工具函数
+export { getDisplayState } from "./utils";
+// 使用别名导出避免与 number-input 的 validateValue 重名
+export { validateValue as validateTextValue } from "./utils";