@pisell/utils 1.0.57 → 1.0.59

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

@@ -1,25 +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;
+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/lib/number-input/index.d.ts

@@ -1,14 +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';
+/**
+ * 数值输入组件公共逻辑导出
+ *
+ * 供以下组件使用：
+ * - 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/lib/number-input/types.d.ts

@@ -1,96 +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;
-}
+/**
+ * 数值输入组件公共类型定义
+ * 供 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/lib/number-input/utils/formatter.d.ts

@@ -1,53 +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;
+/**
+ * 数值格式化工具函数
+ */
+/**
+ * 格式化选项
+ */
+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/lib/number-input/utils/index.d.ts

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

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

@@ -1,27 +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;
+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/lib/otherUtils.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @title: 判断是否无痕模式
+ * @description:
+ * @return: *
+ * @Author: shengjie.zuo
+ * @Date: 2024-09-4 09:58:22
+ */
+export declare const detectIncognito: () => Promise<{
+    isPrivate: boolean;
+    browserName: string;
+} | {
+    isPrivate: boolean;
+}>;
+/**
+ * @Description: 生成唯一id
+ * @Author: wzw
+ * @Date: 2020-12-01 14:20:29
+ * @param {*}
+ * @return {*}
+ */
+export declare const getUniqueId: (prefix?: string, maxLength?: number) => string;
+/**
+ * @title: 对数组进行增|删
+ * @description: 用于多选选中和取消选中的处理
+ * @param {any} list
+ * @param {any} item
+ * @param {string} key
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2023-12-19 16:44
+ */
+export declare const changeArray: <T>(list: T[] | undefined, item: T, key?: string) => T[];
+/**
+ * @title: 判断某个字段是否在列表内
+ * @description:
+ * @param {*} T
+ * @param {boolean} param2
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2023-12-19 16:54
+ */
+export declare const getItemByArray: <T>(list: T[] | undefined, item: T, key?: string) => boolean;
+export declare const createArray: (length: number, returnItem: any) => unknown[];
+/**
+ * 根据对象内容生成唯一id
+ * @param obj
+ */
+export declare const generateUniqueIdByObj: (obj: Record<string, any>) => any;

package/lib/platform.d.ts

@@ -1,9 +1,9 @@
-export declare const isIpad: () => boolean;
-export declare const isMobile: () => boolean;
-export declare const isAndroid: () => boolean;
-export declare const isIos: () => boolean;
-export declare const checkEnv: () => number;
-export declare const isWx: () => boolean;
-export declare const isIOS: () => boolean;
-export declare const isWxApp: () => boolean;
-export declare const isSafari: () => boolean;
+export declare const isIpad: () => boolean;
+export declare const isMobile: () => boolean;
+export declare const isAndroid: () => boolean;
+export declare const isIos: () => boolean;
+export declare const checkEnv: () => number;
+export declare const isWx: () => boolean;
+export declare const isIOS: () => boolean;
+export declare const isWxApp: () => boolean;
+export declare const isSafari: () => boolean;

package/lib/select/hooks/index.d.ts

@@ -1,5 +1,5 @@
-/**
- * Select Hooks 导出
- */
-export { useSelectState, useMultipleSelectState } from './useSelectState';
-export { useDebouncedSearch } from './useDebouncedSearch';
+/**
+ * Select Hooks 导出
+ */
+export { useSelectState, useMultipleSelectState } from './useSelectState';
+export { useDebouncedSearch } from './useDebouncedSearch';

package/lib/select/hooks/useDebouncedSearch.d.ts

@@ -1,20 +1,20 @@
-/**
- * 防抖搜索 Hook
- * 对用户输入进行防抖处理，避免频繁触发搜索
- */
-/**
- * 防抖搜索 Hook
- * @template T 值的类型
- * @param initialValue 初始值
- * @param delay 防抖延迟时间（毫秒）
- * @param callback 防抖后的回调函数
- * @returns [防抖后的值, 设置值函数]
- *
- * @example
- * ```tsx
- * const [debouncedSearch, setSearchInput] = useDebouncedSearch('', 300, (text) => {
- *   console.log('搜索关键词:', text);
- * });
- * ```
- */
-export declare function useDebouncedSearch<T = string>(initialValue: T, delay: number, callback?: (value: T) => void): [T, (value: T) => void];
+/**
+ * 防抖搜索 Hook
+ * 对用户输入进行防抖处理，避免频繁触发搜索
+ */
+/**
+ * 防抖搜索 Hook
+ * @template T 值的类型
+ * @param initialValue 初始值
+ * @param delay 防抖延迟时间（毫秒）
+ * @param callback 防抖后的回调函数
+ * @returns [防抖后的值, 设置值函数]
+ *
+ * @example
+ * ```tsx
+ * const [debouncedSearch, setSearchInput] = useDebouncedSearch('', 300, (text) => {
+ *   console.log('搜索关键词:', text);
+ * });
+ * ```
+ */
+export declare function useDebouncedSearch<T = string>(initialValue: T, delay: number, callback?: (value: T) => void): [T, (value: T) => void];

package/lib/select/hooks/useSelectState.d.ts

@@ -1,19 +1,19 @@
-/**
- * Select 状态管理 Hook
- * 处理受控/非受控模式，适用于单选和多选
- */
-import type { UseSelectStateOptions, UseMultipleSelectStateOptions, SelectState, MultipleSelectState } from '../types';
-/**
- * 单选状态管理 Hook
- * @template T 值的类型
- * @param options Hook 配置选项
- * @returns 状态管理对象
- */
-export declare function useSelectState<T = string | number>(options: UseSelectStateOptions<T>): SelectState<T>;
-/**
- * 多选状态管理 Hook
- * @template T 值的类型
- * @param options Hook 配置选项
- * @returns 状态管理对象
- */
-export declare function useMultipleSelectState<T = string | number>(options: UseMultipleSelectStateOptions<T>): MultipleSelectState<T>;
+/**
+ * Select 状态管理 Hook
+ * 处理受控/非受控模式，适用于单选和多选
+ */
+import type { UseSelectStateOptions, UseMultipleSelectStateOptions, SelectState, MultipleSelectState } from '../types';
+/**
+ * 单选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
+ */
+export declare function useSelectState<T = string | number>(options: UseSelectStateOptions<T>): SelectState<T>;
+/**
+ * 多选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
+ */
+export declare function useMultipleSelectState<T = string | number>(options: UseMultipleSelectStateOptions<T>): MultipleSelectState<T>;

package/lib/select/index.d.ts

@@ -1,8 +1,8 @@
-/**
- * Select 组件相关工具和类型导出
- * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
- */
-export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, MultipleSelectState, TagDisplayInfo, UseSelectStateOptions, UseMultipleSelectStateOptions, BaseSelectProps, } from './types';
-export { useSelectState, useMultipleSelectState } from './hooks/useSelectState';
-export { useDebouncedSearch } from './hooks/useDebouncedSearch';
-export { filterOptions, defaultFilterOption, sortOptions, calculateTagDisplay, findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './utils';
+/**
+ * Select 组件相关工具和类型导出
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+ */
+export type { SelectOption, FilterOptionFunc, SortDirection, SelectState, MultipleSelectState, TagDisplayInfo, UseSelectStateOptions, UseMultipleSelectStateOptions, BaseSelectProps, } from './types';
+export { useSelectState, useMultipleSelectState } from './hooks/useSelectState';
+export { useDebouncedSearch } from './hooks/useDebouncedSearch';
+export { filterOptions, defaultFilterOption, sortOptions, calculateTagDisplay, findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './utils';