@pisell/utils 1.0.70 → 1.0.71

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

@@ -1,48 +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;
+/**
+ * @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';