@pisell/utils 1.0.71 → 1.0.73

package/es/select/types.d.ts

@@ -1,36 +1,34 @@
-/**
- * Select 组件公共类型定义
- * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
- */
-import React from 'react';
-export type { DisplayState } from '../common';
+import { DisplayState } from "../common/types.js";
+import React from "react";
+
+//#region src/select/types.d.ts
 /**
  * 选项基础类型
  * @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;
+interface SelectOption<T = string | number> {
+  /**
+   * 选项值（唯一标识）
+   */
+  value: T;
+  /**
+   * 选项显示文本
+   */
+  label: string;
+  /**
+   * 是否禁用该选项
+   * @default false
+   */
+  disabled?: boolean;
+  /**
+   * 选项图标（可选）
+   */
+  icon?: React.ReactNode;
+  /**
+   * 标签背景色（多选时用于自定义标签颜色）
+   * @example '#61dafb'
+   */
+  color?: string;
 }
 /**
  * 选项过滤函数类型
@@ -39,218 +37,220 @@ export interface SelectOption<T = string | number> {
  * @param option 当前选项对象
  * @returns 是否保留该选项
  */
-export declare type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
+type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
 /**
  * 排序方向
  */
-export declare type SortDirection = 'asc' | 'desc';
+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;
+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;
+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;
+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';
+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';
+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;
+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;
 }
+//#endregion
+export { BaseSelectProps, FilterOptionFunc, MultipleSelectState, SelectOption, SelectState, SortDirection, TagDisplayInfo, UseMultipleSelectStateOptions, UseSelectStateOptions };

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

@@ -1,7 +1,6 @@
-/**
- * 选项过滤工具函数
- */
-import type { SelectOption, FilterOptionFunc } from '../types';
+import { FilterOptionFunc, SelectOption } from "../types.js";
+
+//#region src/select/utils/filterOptions.d.ts
 /**
  * 默认的选项过滤函数
  * 根据 label 进行模糊匹配（不区分大小写）
@@ -10,7 +9,7 @@ import type { SelectOption, FilterOptionFunc } from '../types';
  * @param option 选项对象
  * @returns 是否保留该选项
  */
-export declare function defaultFilterOption<T = string | number>(input: string, option: SelectOption<T>): boolean;
+declare function defaultFilterOption<T = string | number>(input: string, option: SelectOption<T>): boolean;
 /**
  * 过滤选项列表
  * @template T 选项值的类型
@@ -19,4 +18,6 @@ export declare function defaultFilterOption<T = string | number>(input: string,
  * @param filterFunc 自定义过滤函数（可选）
  * @returns 过滤后的选项列表
  */
-export declare function filterOptions<T = string | number>(options: SelectOption<T>[], searchText: string, filterFunc?: FilterOptionFunc<T>): SelectOption<T>[];
+declare function filterOptions<T = string | number>(options: SelectOption<T>[], searchText: string, filterFunc?: FilterOptionFunc<T>): SelectOption<T>[];
+//#endregion
+export { defaultFilterOption, filterOptions };

package/es/select/utils/filterOptions.js

@@ -1,34 +1,29 @@
+//#region src/select/utils/filterOptions.ts
 /**
- * 选项过滤工具函数
- */
-
-/**
- * 默认的选项过滤函数
- * 根据 label 进行模糊匹配（不区分大小写）
- * @template T 选项值的类型
- * @param input 搜索输入文本
- * @param option 选项对象
- * @returns 是否保留该选项
- */
-export function defaultFilterOption(input, option) {
-  if (!input) return true;
-  var searchText = input.toLowerCase();
-  var labelText = option.label.toLowerCase();
-  return labelText.includes(searchText);
+* 默认的选项过滤函数
+* 根据 label 进行模糊匹配（不区分大小写）
+* @template T 选项值的类型
+* @param input 搜索输入文本
+* @param option 选项对象
+* @returns 是否保留该选项
+*/
+function defaultFilterOption(input, option) {
+	if (!input) return true;
+	const searchText = input.toLowerCase();
+	return option.label.toLowerCase().includes(searchText);
 }
-
 /**
- * 过滤选项列表
- * @template T 选项值的类型
- * @param options 原始选项列表
- * @param searchText 搜索文本
- * @param filterFunc 自定义过滤函数（可选）
- * @returns 过滤后的选项列表
- */
-export function filterOptions(options, searchText, filterFunc) {
-  if (!searchText) return options;
-  var filterFn = filterFunc || defaultFilterOption;
-  return options.filter(function (opt) {
-    return filterFn(searchText, opt);
-  });
-}
+* 过滤选项列表
+* @template T 选项值的类型
+* @param options 原始选项列表
+* @param searchText 搜索文本
+* @param filterFunc 自定义过滤函数（可选）
+* @returns 过滤后的选项列表
+*/
+function filterOptions(options, searchText, filterFunc) {
+	if (!searchText) return options;
+	const filterFn = filterFunc || defaultFilterOption;
+	return options.filter((opt) => filterFn(searchText, opt));
+}
+//#endregion
+export { defaultFilterOption, filterOptions };

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

@@ -1,7 +1,6 @@
-/**
- * Select 组件辅助函数
- */
-import type { SelectOption } from '../types';
+import { SelectOption } from "../types.js";
+
+//#region src/select/utils/helpers.d.ts
 /**
  * 根据值查找选项对象
  * @template T 选项值的类型
@@ -9,7 +8,7 @@ import type { SelectOption } from '../types';
  * @param options 选项列表
  * @returns 找到的选项对象，如果没找到返回 undefined
  */
-export declare function findOptionByValue<T = string | number>(value: T, options: SelectOption<T>[]): SelectOption<T> | undefined;
+declare function findOptionByValue<T = string | number>(value: T, options: SelectOption<T>[]): SelectOption<T> | undefined;
 /**
  * 根据值数组查找选项对象数组
  * @template T 选项值的类型
@@ -17,7 +16,7 @@ export declare function findOptionByValue<T = string | number>(value: T, options
  * @param options 选项列表
  * @returns 找到的选项对象数组
  */
-export declare function findOptionsByValues<T = string | number>(values: T[], options: SelectOption<T>[]): SelectOption<T>[];
+declare function findOptionsByValues<T = string | number>(values: T[], options: SelectOption<T>[]): SelectOption<T>[];
 /**
  * 判断选项是否被选中（单选）
  * @template T 选项值的类型
@@ -25,7 +24,7 @@ export declare function findOptionsByValues<T = string | number>(values: T[], op
  * @param selectedValue 当前选中值
  * @returns 是否选中
  */
-export declare function isOptionSelected<T = string | number>(optionValue: T, selectedValue: T | null | undefined): boolean;
+declare function isOptionSelected<T = string | number>(optionValue: T, selectedValue: T | null | undefined): boolean;
 /**
  * 判断选项是否被选中（多选）
  * @template T 选项值的类型
@@ -33,10 +32,12 @@ export declare function isOptionSelected<T = string | number>(optionValue: T, se
  * @param selectedValues 当前选中值数组
  * @returns 是否选中
  */
-export declare function isOptionSelectedInMultiple<T = string | number>(optionValue: T, selectedValues: T[]): boolean;
+declare function isOptionSelectedInMultiple<T = string | number>(optionValue: T, selectedValues: T[]): boolean;
 /**
  * 生成唯一 ID
  * @param prefix ID 前缀
  * @returns 唯一 ID
  */
-export declare function generateId(prefix?: string): string;
+declare function generateId(prefix?: string): string;
+//#endregion
+export { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple };