@pisell/utils 1.0.68 → 1.0.71

package/es/select/utils/helpers.js

@@ -1,13 +1,13 @@
-/**
- * Select 组件辅助函数
+/**
+ * Select 组件辅助函数
  */
 
-/**
- * 根据值查找选项对象
- * @template T 选项值的类型
- * @param value 选项值
- * @param options 选项列表
- * @returns 找到的选项对象，如果没找到返回 undefined
+/**
+ * 根据值查找选项对象
+ * @template T 选项值的类型
+ * @param value 选项值
+ * @param options 选项列表
+ * @returns 找到的选项对象，如果没找到返回 undefined
  */
 export function findOptionByValue(value, options) {
   return options.find(function (opt) {
@@ -15,12 +15,12 @@ export function findOptionByValue(value, options) {
   });
 }
 
-/**
- * 根据值数组查找选项对象数组
- * @template T 选项值的类型
- * @param values 选项值数组
- * @param options 选项列表
- * @returns 找到的选项对象数组
+/**
+ * 根据值数组查找选项对象数组
+ * @template T 选项值的类型
+ * @param values 选项值数组
+ * @param options 选项列表
+ * @returns 找到的选项对象数组
  */
 export function findOptionsByValues(values, options) {
   return values.map(function (val) {
@@ -28,32 +28,32 @@ export function findOptionsByValues(values, options) {
   }).filter(Boolean);
 }
 
-/**
- * 判断选项是否被选中（单选）
- * @template T 选项值的类型
- * @param optionValue 选项值
- * @param selectedValue 当前选中值
- * @returns 是否选中
+/**
+ * 判断选项是否被选中（单选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValue 当前选中值
+ * @returns 是否选中
  */
 export function isOptionSelected(optionValue, selectedValue) {
   return selectedValue !== null && selectedValue !== undefined && optionValue === selectedValue;
 }
 
-/**
- * 判断选项是否被选中（多选）
- * @template T 选项值的类型
- * @param optionValue 选项值
- * @param selectedValues 当前选中值数组
- * @returns 是否选中
+/**
+ * 判断选项是否被选中（多选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValues 当前选中值数组
+ * @returns 是否选中
  */
 export function isOptionSelectedInMultiple(optionValue, selectedValues) {
   return selectedValues.includes(optionValue);
 }
 
-/**
- * 生成唯一 ID
- * @param prefix ID 前缀
- * @returns 唯一 ID
+/**
+ * 生成唯一 ID
+ * @param prefix ID 前缀
+ * @returns 唯一 ID
  */
 export function generateId() {
   var prefix = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'select';

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

@@ -1,7 +1,7 @@
-/**
- * Select 工具函数导出
- */
-export { calculateTagDisplay } from './tagAggregation';
-export { filterOptions, defaultFilterOption } from './filterOptions';
-export { sortOptions } from './sortOptions';
-export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './helpers';
+/**
+ * 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

@@ -1,5 +1,5 @@
-/**
- * Select 工具函数导出
+/**
+ * Select 工具函数导出
  */
 
 export { calculateTagDisplay } from "./tagAggregation";

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

@@ -1,12 +1,12 @@
-/**
- * 选项排序工具函数
- */
-import type { SelectOption, SortDirection } from '../types';
-/**
- * 排序选项列表
- * @template T 选项值的类型
- * @param options 原始选项列表
- * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
- * @returns 排序后的选项列表（新数组）
- */
-export declare function sortOptions<T = string | number>(options: SelectOption<T>[], direction?: SortDirection): SelectOption<T>[];
+/**
+ * 选项排序工具函数
+ */
+import type { SelectOption, SortDirection } from '../types';
+/**
+ * 排序选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+ * @returns 排序后的选项列表（新数组）
+ */
+export declare function sortOptions<T = string | number>(options: SelectOption<T>[], direction?: SortDirection): SelectOption<T>[];

package/es/select/utils/sortOptions.js

@@ -4,16 +4,16 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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 排序后的选项列表（新数组）
+/**
+ * 排序选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+ * @returns 排序后的选项列表（新数组）
  */
 export function sortOptions(options) {
   var direction = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'asc';

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

@@ -1,25 +1,25 @@
-/**
- * 标签聚合工具函数
- * 用于多选下拉组件的标签显示逻辑
- */
-import type { SelectOption, TagDisplayInfo } from '../types';
-/**
- * 计算需要显示的标签和聚合信息
- * @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 declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
+/**
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
+ */
+import type { SelectOption, TagDisplayInfo } from '../types';
+/**
+ * 计算需要显示的标签和聚合信息
+ * @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 declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;

package/es/select/utils/tagAggregation.js

@@ -1,26 +1,26 @@
-/**
- * 标签聚合工具函数
- * 用于多选下拉组件的标签显示逻辑
+/**
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
  */
 
-/**
- * 计算需要显示的标签和聚合信息
- * @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
- * // }
- * ```
+/**
+ * 计算需要显示的标签和聚合信息
+ * @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) {
   // 根据选中值找到对应的选项对象

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

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

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

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

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

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

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

@@ -6,27 +6,27 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 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' });
+/**
+ * 文本输入状态管理 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) {
   // 判断是否为受控组件
@@ -53,12 +53,12 @@ export function useTextInputState(props) {
   // 当前值（受控模式优先使用 props.value）
   var currentValue = isControlled ? props.value : innerValue;
 
-  /**
-   * 值变更处理函数
-   * 
-   * 1. 更新内部状态（非受控模式）
-   * 2. 根据 validateTrigger 决定是否立即校验
-   * 3. 触发外部 onChange 回调
+  /**
+   * 值变更处理函数
+   * 
+   * 1. 更新内部状态（非受控模式）
+   * 2. 根据 validateTrigger 决定是否立即校验
+   * 3. 触发外部 onChange 回调
    */
   var handleChange = useCallback(function (newValue) {
     var _props$onChange;
@@ -81,12 +81,12 @@ export function useTextInputState(props) {
     (_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, newValue);
   }, [isControlled, props]);
 
-  /**
-   * 失焦处理函数
-   * 
-   * 1. 标记为已触摸
-   * 2. 执行失焦时的校验（根据 validateTrigger）
-   * 3. 触发外部 onBlur 回调
+  /**
+   * 失焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 执行失焦时的校验（根据 validateTrigger）
+   * 3. 触发外部 onBlur 回调
    */
   var handleBlur = useCallback(function () {
     var _props$onBlur;
@@ -104,11 +104,11 @@ export function useTextInputState(props) {
     (_props$onBlur = props.onBlur) === null || _props$onBlur === void 0 || _props$onBlur.call(props, currentValue || '');
   }, [currentValue, props]);
 
-  /**
-   * 聚焦处理函数
-   * 
-   * 1. 标记为已触摸
-   * 2. 触发外部 onFocus 回调
+  /**
+   * 聚焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 触发外部 onFocus 回调
    */
   var handleFocus = useCallback(function () {
     var _props$onFocus;

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

@@ -1,14 +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';
+/**
+ * 文本输入组件公共逻辑导出
+ *
+ * 供以下组件使用：
+ * - 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

@@ -1,12 +1,12 @@
-/**
- * 文本输入组件公共逻辑导出
- * 
- * 供以下组件使用：
- * - PisellSingleLineText
- * - PisellLongText
- * - PisellPhone
- * - PisellEmail
- * - PisellUrl
+/**
+ * 文本输入组件公共逻辑导出
+ * 
+ * 供以下组件使用：
+ * - PisellSingleLineText
+ * - PisellLongText
+ * - PisellPhone
+ * - PisellEmail
+ * - PisellUrl
  */
 
 // 类型

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

@@ -1,56 +1,56 @@
-/**
- * 文本输入组件公共类型定义
- * 供 PisellSingleLineText、PisellLongText、PisellPhone、PisellEmail、PisellUrl 等组件使用
- */
-export type { DisplayState, ValidationResult } from '../common';
-/**
- * 文本输入状态 Hook 返回值
- */
-export interface TextInputState {
-    /**
-     * 当前值
-     */
-    value: string | undefined;
-    /**
-     * 是否已被触摸（交互过）
-     */
-    isTouched: boolean;
-    /**
-     * 是否校验通过
-     */
-    isValid: boolean;
-    /**
-     * 错误信息数组
-     */
-    errors: string[];
-    /**
-     * 值变更处理函数
-     */
-    handleChange: (value: string) => void;
-    /**
-     * 失焦处理函数
-     */
-    handleBlur: () => void;
-    /**
-     * 聚焦处理函数
-     */
-    handleFocus: () => void;
-}
-/**
- * 基础文本输入 Props（供校验和状态管理使用）
- */
-export interface BaseTextInputProps {
-    value?: string;
-    defaultValue?: string;
-    required?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string | RegExp;
-    validator?: (value: string) => boolean | string;
-    validateTrigger?: 'onChange' | 'onBlur' | 'both';
-    errorMessage?: string;
-    onChange?: (value: string) => void;
-    onBlur?: (value: string) => void;
-    onFocus?: () => void;
-    onValidate?: (isValid: boolean, errors: string[]) => void;
-}
+/**
+ * 文本输入组件公共类型定义
+ * 供 PisellSingleLineText、PisellLongText、PisellPhone、PisellEmail、PisellUrl 等组件使用
+ */
+export type { DisplayState, ValidationResult } from '../common';
+/**
+ * 文本输入状态 Hook 返回值
+ */
+export interface TextInputState {
+    /**
+     * 当前值
+     */
+    value: string | undefined;
+    /**
+     * 是否已被触摸（交互过）
+     */
+    isTouched: boolean;
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+    /**
+     * 值变更处理函数
+     */
+    handleChange: (value: string) => void;
+    /**
+     * 失焦处理函数
+     */
+    handleBlur: () => void;
+    /**
+     * 聚焦处理函数
+     */
+    handleFocus: () => void;
+}
+/**
+ * 基础文本输入 Props（供校验和状态管理使用）
+ */
+export interface BaseTextInputProps {
+    value?: string;
+    defaultValue?: string;
+    required?: boolean;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string | RegExp;
+    validator?: (value: string) => boolean | string;
+    validateTrigger?: 'onChange' | 'onBlur' | 'both';
+    errorMessage?: string;
+    onChange?: (value: string) => void;
+    onBlur?: (value: string) => void;
+    onFocus?: () => void;
+    onValidate?: (isValid: boolean, errors: string[]) => void;
+}

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

@@ -1,5 +1,5 @@
-/**
- * 文本输入工具函数导出
- */
-export { getDisplayState } from '../../common';
-export { validateValue } from './validation';
+/**
+ * 文本输入工具函数导出
+ */
+export { getDisplayState } from '../../common';
+export { validateValue } from './validation';

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

@@ -1,5 +1,5 @@
-/**
- * 文本输入工具函数导出
+/**
+ * 文本输入工具函数导出
  */
 
 // getDisplayState 已移到公共模块，从 common 重新导出