@pisell/utils 1.0.70 → 1.0.72

package/es/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/es/select/hooks/useSelectState.js

@@ -8,17 +8,17 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 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; }
-/**
- * Select 状态管理 Hook
- * 处理受控/非受控模式，适用于单选和多选
+/**
+ * Select 状态管理 Hook
+ * 处理受控/非受控模式，适用于单选和多选
  */
 
 import { useState, useCallback } from 'react';
-/**
- * 单选状态管理 Hook
- * @template T 值的类型
- * @param options Hook 配置选项
- * @returns 状态管理对象
+/**
+ * 单选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
  */
 export function useSelectState(options) {
   var controlledValue = options.value,
@@ -57,11 +57,11 @@ export function useSelectState(options) {
   };
 }
 
-/**
- * 多选状态管理 Hook
- * @template T 值的类型
- * @param options Hook 配置选项
- * @returns 状态管理对象
+/**
+ * 多选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
  */
 export function useMultipleSelectState(options) {
   var controlledValue = options.value,

package/es/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';

package/es/select/index.js

@@ -1,6 +1,6 @@
-/**
- * Select 组件相关工具和类型导出
- * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+/**
+ * Select 组件相关工具和类型导出
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
  */
 
 // 导出所有类型

package/es/select/types.d.ts

@@ -1,256 +1,256 @@
-/**
- * Select 组件公共类型定义
- * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
- */
-import React from 'react';
-export type { DisplayState } from '../common';
-/**
- * 选项基础类型
- * @template T 选项值的类型，默认为 string | number
- */
-export interface SelectOption<T = string | number> {
-    /**
-     * 选项值（唯一标识）
-     */
-    value: T;
-    /**
-     * 选项显示文本
-     */
-    label: string;
-    /**
-     * 是否禁用该选项
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 选项图标（可选）
-     */
-    icon?: React.ReactNode;
-    /**
-     * 标签背景色（多选时用于自定义标签颜色）
-     * @example '#61dafb'
-     */
-    color?: string;
-}
-/**
- * 选项过滤函数类型
- * @template T 选项值的类型
- * @param input 用户输入的搜索文本
- * @param option 当前选项对象
- * @returns 是否保留该选项
- */
-export declare type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
-/**
- * 排序方向
- */
-export declare type SortDirection = 'asc' | 'desc';
-/**
- * Select 状态 Hook 返回值（单选）
- * @template T 值的类型
- */
-export interface SelectState<T = string | number> {
-    /**
-     * 当前选中值
-     */
-    value: T | null | undefined;
-    /**
-     * 设置选中值
-     */
-    setValue: (value: T | null) => void;
-    /**
-     * 清空选中值
-     */
-    clearValue: () => void;
-}
-/**
- * Multiple Select 状态 Hook 返回值（多选）
- * @template T 值的类型
- */
-export interface MultipleSelectState<T = string | number> {
-    /**
-     * 当前选中值数组
-     */
-    value: T[];
-    /**
-     * 设置选中值数组
-     */
-    setValue: (value: T[]) => void;
-    /**
-     * 添加一个选中值
-     */
-    addValue: (value: T) => void;
-    /**
-     * 移除一个选中值
-     */
-    removeValue: (value: T) => void;
-    /**
-     * 清空所有选中值
-     */
-    clearValue: () => void;
-}
-/**
- * 标签显示信息（多选专用）
- * @template T 选项值的类型
- */
-export interface TagDisplayInfo<T = string | number> {
-    /**
-     * 可见的标签列表
-     */
-    visibleTags: SelectOption<T>[];
-    /**
-     * 隐藏的标签列表
-     */
-    hiddenTags: SelectOption<T>[];
-    /**
-     * 隐藏的标签数量
-     */
-    hiddenCount: number;
-}
-/**
- * useSelectState Hook 的配置选项（单选）
- * @template T 值的类型
- */
-export interface UseSelectStateOptions<T = string | number> {
-    /**
-     * 受控模式：当前值
-     */
-    value?: T | null;
-    /**
-     * 非受控模式：默认值
-     */
-    defaultValue?: T;
-    /**
-     * 值变化回调
-     */
-    onChange?: (value: T | null, option: SelectOption<T> | null) => void;
-    /**
-     * 模式（用于类型区分）
-     */
-    mode: 'single';
-}
-/**
- * useMultipleSelectState Hook 的配置选项（多选）
- * @template T 值的类型
- */
-export interface UseMultipleSelectStateOptions<T = string | number> {
-    /**
-     * 受控模式：当前值数组
-     */
-    value?: T[];
-    /**
-     * 非受控模式：默认值数组
-     */
-    defaultValue?: T[];
-    /**
-     * 值变化回调
-     */
-    onChange?: (value: T[], options: SelectOption<T>[]) => void;
-    /**
-     * 模式（用于类型区分）
-     */
-    mode: 'multiple';
-}
-/**
- * 基础 Select Props（公共属性）
- * @template T 值的类型
- */
-export interface BaseSelectProps<T = string | number> {
-    /**
-     * 选项列表（必填）
-     */
-    options: SelectOption<T>[];
-    /**
-     * 占位符文本
-     * @default '请选择'
-     */
-    placeholder?: string;
-    /**
-     * 是否显示搜索框
-     * @default false
-     */
-    showSearch?: boolean;
-    /**
-     * 是否显示清空按钮
-     * @default false
-     */
-    allowClear?: boolean;
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 是否只读
-     * @default false
-     */
-    readOnly?: boolean;
-    /**
-     * 尺寸
-     * @default 'middle'
-     */
-    size?: 'small' | 'middle' | 'large';
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: React.CSSProperties;
-    /**
-     * 标签文本
-     */
-    label?: string;
-    /**
-     * 辅助提示文本
-     */
-    helperText?: string;
-    /**
-     * 是否必填
-     * @default false
-     */
-    required?: boolean;
-    /**
-     * 是否显示错误状态
-     * @default false
-     */
-    error?: boolean;
-    /**
-     * 错误提示文本
-     */
-    errorText?: string;
-    /**
-     * 是否启用过滤
-     * @default false
-     */
-    filterable?: boolean;
-    /**
-     * 自定义过滤函数
-     */
-    filterOption?: FilterOptionFunc<T>;
-    /**
-     * 是否启用排序
-     * @default false
-     */
-    sortable?: boolean;
-    /**
-     * 排序方向
-     */
-    sortDirection?: SortDirection;
-    /**
-     * 搜索输入回调
-     */
-    onSearch?: (value: string) => void;
-    /**
-     * 获得焦点回调
-     */
-    onFocus?: (event: React.FocusEvent) => void;
-    /**
-     * 失去焦点回调
-     */
-    onBlur?: (event: React.FocusEvent) => void;
-    /**
-     * 下拉框显隐回调
-     */
-    onDropdownVisibleChange?: (visible: boolean) => void;
-}
+/**
+ * Select 组件公共类型定义
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+ */
+import React from 'react';
+export type { DisplayState } from '../common';
+/**
+ * 选项基础类型
+ * @template T 选项值的类型，默认为 string | number
+ */
+export interface SelectOption<T = string | number> {
+    /**
+     * 选项值（唯一标识）
+     */
+    value: T;
+    /**
+     * 选项显示文本
+     */
+    label: string;
+    /**
+     * 是否禁用该选项
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 选项图标（可选）
+     */
+    icon?: React.ReactNode;
+    /**
+     * 标签背景色（多选时用于自定义标签颜色）
+     * @example '#61dafb'
+     */
+    color?: string;
+}
+/**
+ * 选项过滤函数类型
+ * @template T 选项值的类型
+ * @param input 用户输入的搜索文本
+ * @param option 当前选项对象
+ * @returns 是否保留该选项
+ */
+export declare type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
+/**
+ * 排序方向
+ */
+export declare type SortDirection = 'asc' | 'desc';
+/**
+ * Select 状态 Hook 返回值（单选）
+ * @template T 值的类型
+ */
+export interface SelectState<T = string | number> {
+    /**
+     * 当前选中值
+     */
+    value: T | null | undefined;
+    /**
+     * 设置选中值
+     */
+    setValue: (value: T | null) => void;
+    /**
+     * 清空选中值
+     */
+    clearValue: () => void;
+}
+/**
+ * Multiple Select 状态 Hook 返回值（多选）
+ * @template T 值的类型
+ */
+export interface MultipleSelectState<T = string | number> {
+    /**
+     * 当前选中值数组
+     */
+    value: T[];
+    /**
+     * 设置选中值数组
+     */
+    setValue: (value: T[]) => void;
+    /**
+     * 添加一个选中值
+     */
+    addValue: (value: T) => void;
+    /**
+     * 移除一个选中值
+     */
+    removeValue: (value: T) => void;
+    /**
+     * 清空所有选中值
+     */
+    clearValue: () => void;
+}
+/**
+ * 标签显示信息（多选专用）
+ * @template T 选项值的类型
+ */
+export interface TagDisplayInfo<T = string | number> {
+    /**
+     * 可见的标签列表
+     */
+    visibleTags: SelectOption<T>[];
+    /**
+     * 隐藏的标签列表
+     */
+    hiddenTags: SelectOption<T>[];
+    /**
+     * 隐藏的标签数量
+     */
+    hiddenCount: number;
+}
+/**
+ * useSelectState Hook 的配置选项（单选）
+ * @template T 值的类型
+ */
+export interface UseSelectStateOptions<T = string | number> {
+    /**
+     * 受控模式：当前值
+     */
+    value?: T | null;
+    /**
+     * 非受控模式：默认值
+     */
+    defaultValue?: T;
+    /**
+     * 值变化回调
+     */
+    onChange?: (value: T | null, option: SelectOption<T> | null) => void;
+    /**
+     * 模式（用于类型区分）
+     */
+    mode: 'single';
+}
+/**
+ * useMultipleSelectState Hook 的配置选项（多选）
+ * @template T 值的类型
+ */
+export interface UseMultipleSelectStateOptions<T = string | number> {
+    /**
+     * 受控模式：当前值数组
+     */
+    value?: T[];
+    /**
+     * 非受控模式：默认值数组
+     */
+    defaultValue?: T[];
+    /**
+     * 值变化回调
+     */
+    onChange?: (value: T[], options: SelectOption<T>[]) => void;
+    /**
+     * 模式（用于类型区分）
+     */
+    mode: 'multiple';
+}
+/**
+ * 基础 Select Props（公共属性）
+ * @template T 值的类型
+ */
+export interface BaseSelectProps<T = string | number> {
+    /**
+     * 选项列表（必填）
+     */
+    options: SelectOption<T>[];
+    /**
+     * 占位符文本
+     * @default '请选择'
+     */
+    placeholder?: string;
+    /**
+     * 是否显示搜索框
+     * @default false
+     */
+    showSearch?: boolean;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 是否只读
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * 尺寸
+     * @default 'middle'
+     */
+    size?: 'small' | 'middle' | 'large';
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 标签文本
+     */
+    label?: string;
+    /**
+     * 辅助提示文本
+     */
+    helperText?: string;
+    /**
+     * 是否必填
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * 是否显示错误状态
+     * @default false
+     */
+    error?: boolean;
+    /**
+     * 错误提示文本
+     */
+    errorText?: string;
+    /**
+     * 是否启用过滤
+     * @default false
+     */
+    filterable?: boolean;
+    /**
+     * 自定义过滤函数
+     */
+    filterOption?: FilterOptionFunc<T>;
+    /**
+     * 是否启用排序
+     * @default false
+     */
+    sortable?: boolean;
+    /**
+     * 排序方向
+     */
+    sortDirection?: SortDirection;
+    /**
+     * 搜索输入回调
+     */
+    onSearch?: (value: string) => void;
+    /**
+     * 获得焦点回调
+     */
+    onFocus?: (event: React.FocusEvent) => void;
+    /**
+     * 失去焦点回调
+     */
+    onBlur?: (event: React.FocusEvent) => void;
+    /**
+     * 下拉框显隐回调
+     */
+    onDropdownVisibleChange?: (visible: boolean) => void;
+}

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

@@ -1,22 +1,22 @@
-/**
- * 选项过滤工具函数
- */
-import type { SelectOption, FilterOptionFunc } from '../types';
-/**
- * 默认的选项过滤函数
- * 根据 label 进行模糊匹配（不区分大小写）
- * @template T 选项值的类型
- * @param input 搜索输入文本
- * @param option 选项对象
- * @returns 是否保留该选项
- */
-export declare function defaultFilterOption<T = string | number>(input: string, option: SelectOption<T>): boolean;
-/**
- * 过滤选项列表
- * @template T 选项值的类型
- * @param options 原始选项列表
- * @param searchText 搜索文本
- * @param filterFunc 自定义过滤函数（可选）
- * @returns 过滤后的选项列表
- */
-export declare function filterOptions<T = string | number>(options: SelectOption<T>[], searchText: string, filterFunc?: FilterOptionFunc<T>): SelectOption<T>[];
+/**
+ * 选项过滤工具函数
+ */
+import type { SelectOption, FilterOptionFunc } from '../types';
+/**
+ * 默认的选项过滤函数
+ * 根据 label 进行模糊匹配（不区分大小写）
+ * @template T 选项值的类型
+ * @param input 搜索输入文本
+ * @param option 选项对象
+ * @returns 是否保留该选项
+ */
+export declare function defaultFilterOption<T = string | number>(input: string, option: SelectOption<T>): boolean;
+/**
+ * 过滤选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param searchText 搜索文本
+ * @param filterFunc 自定义过滤函数（可选）
+ * @returns 过滤后的选项列表
+ */
+export declare function filterOptions<T = string | number>(options: SelectOption<T>[], searchText: string, filterFunc?: FilterOptionFunc<T>): SelectOption<T>[];