@pisell/utils 3.0.6 → 3.0.7

package/es/select/types.d.ts

@@ -1,34 +1,36 @@
-import { DisplayState } from "../common/types.js";
-import React from "react";
-
-//#region src/select/types.d.ts
+/**
+ * Select 组件公共类型定义
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+ */
+import React from 'react';
+export type { DisplayState } from '../common';
 /**
  * 选项基础类型
  * @template T 选项值的类型，默认为 string | number
  */
-interface SelectOption<T = string | number> {
-  /**
-   * 选项值（唯一标识）
-   */
-  value: T;
-  /**
-   * 选项显示文本
-   */
-  label: string;
-  /**
-   * 是否禁用该选项
-   * @default false
-   */
-  disabled?: boolean;
-  /**
-   * 选项图标（可选）
-   */
-  icon?: React.ReactNode;
-  /**
-   * 标签背景色（多选时用于自定义标签颜色）
-   * @example '#61dafb'
-   */
-  color?: string;
+export interface SelectOption<T = string | number> {
+    /**
+     * 选项值（唯一标识）
+     */
+    value: T;
+    /**
+     * 选项显示文本
+     */
+    label: string;
+    /**
+     * 是否禁用该选项
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 选项图标（可选）
+     */
+    icon?: React.ReactNode;
+    /**
+     * 标签背景色（多选时用于自定义标签颜色）
+     * @example '#61dafb'
+     */
+    color?: string;
 }
 /**
  * 选项过滤函数类型
@@ -37,220 +39,218 @@ interface SelectOption<T = string | number> {
  * @param option 当前选项对象
  * @returns 是否保留该选项
  */
-type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
+export declare type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
 /**
  * 排序方向
  */
-type SortDirection = 'asc' | 'desc';
+export declare type SortDirection = 'asc' | 'desc';
 /**
  * Select 状态 Hook 返回值（单选）
  * @template T 值的类型
  */
-interface SelectState<T = string | number> {
-  /**
-   * 当前选中值
-   */
-  value: T | null | undefined;
-  /**
-   * 设置选中值
-   */
-  setValue: (value: T | null) => void;
-  /**
-   * 清空选中值
-   */
-  clearValue: () => void;
+export interface SelectState<T = string | number> {
+    /**
+     * 当前选中值
+     */
+    value: T | null | undefined;
+    /**
+     * 设置选中值
+     */
+    setValue: (value: T | null) => void;
+    /**
+     * 清空选中值
+     */
+    clearValue: () => void;
 }
 /**
  * Multiple Select 状态 Hook 返回值（多选）
  * @template T 值的类型
  */
-interface MultipleSelectState<T = string | number> {
-  /**
-   * 当前选中值数组
-   */
-  value: T[];
-  /**
-   * 设置选中值数组
-   */
-  setValue: (value: T[]) => void;
-  /**
-   * 添加一个选中值
-   */
-  addValue: (value: T) => void;
-  /**
-   * 移除一个选中值
-   */
-  removeValue: (value: T) => void;
-  /**
-   * 清空所有选中值
-   */
-  clearValue: () => void;
+export interface MultipleSelectState<T = string | number> {
+    /**
+     * 当前选中值数组
+     */
+    value: T[];
+    /**
+     * 设置选中值数组
+     */
+    setValue: (value: T[]) => void;
+    /**
+     * 添加一个选中值
+     */
+    addValue: (value: T) => void;
+    /**
+     * 移除一个选中值
+     */
+    removeValue: (value: T) => void;
+    /**
+     * 清空所有选中值
+     */
+    clearValue: () => void;
 }
 /**
  * 标签显示信息（多选专用）
  * @template T 选项值的类型
  */
-interface TagDisplayInfo<T = string | number> {
-  /**
-   * 可见的标签列表
-   */
-  visibleTags: SelectOption<T>[];
-  /**
-   * 隐藏的标签列表
-   */
-  hiddenTags: SelectOption<T>[];
-  /**
-   * 隐藏的标签数量
-   */
-  hiddenCount: number;
+export interface TagDisplayInfo<T = string | number> {
+    /**
+     * 可见的标签列表
+     */
+    visibleTags: SelectOption<T>[];
+    /**
+     * 隐藏的标签列表
+     */
+    hiddenTags: SelectOption<T>[];
+    /**
+     * 隐藏的标签数量
+     */
+    hiddenCount: number;
 }
 /**
  * useSelectState Hook 的配置选项（单选）
  * @template T 值的类型
  */
-interface UseSelectStateOptions<T = string | number> {
-  /**
-   * 受控模式：当前值
-   */
-  value?: T | null;
-  /**
-   * 非受控模式：默认值
-   */
-  defaultValue?: T;
-  /**
-   * 值变化回调
-   */
-  onChange?: (value: T | null, option: SelectOption<T> | null) => void;
-  /**
-   * 模式（用于类型区分）
-   */
-  mode: 'single';
+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 值的类型
  */
-interface UseMultipleSelectStateOptions<T = string | number> {
-  /**
-   * 受控模式：当前值数组
-   */
-  value?: T[];
-  /**
-   * 非受控模式：默认值数组
-   */
-  defaultValue?: T[];
-  /**
-   * 值变化回调
-   */
-  onChange?: (value: T[], options: SelectOption<T>[]) => void;
-  /**
-   * 模式（用于类型区分）
-   */
-  mode: 'multiple';
+export interface UseMultipleSelectStateOptions<T = string | number> {
+    /**
+     * 受控模式：当前值数组
+     */
+    value?: T[];
+    /**
+     * 非受控模式：默认值数组
+     */
+    defaultValue?: T[];
+    /**
+     * 值变化回调
+     */
+    onChange?: (value: T[], options: SelectOption<T>[]) => void;
+    /**
+     * 模式（用于类型区分）
+     */
+    mode: 'multiple';
 }
 /**
  * 基础 Select Props（公共属性）
  * @template T 值的类型
  */
-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;
+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;
 }
-//#endregion
-export { BaseSelectProps, FilterOptionFunc, MultipleSelectState, SelectOption, SelectState, SortDirection, TagDisplayInfo, UseMultipleSelectStateOptions, UseSelectStateOptions };

package/es/select/types.js

@@ -0,0 +1 @@
+export {};

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

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

package/es/select/utils/filterOptions.js

@@ -1,29 +1,34 @@
-//#region src/select/utils/filterOptions.ts
 /**
-* 默认的选项过滤函数
-* 根据 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 过滤后的选项列表
-*/
-function filterOptions(options, searchText, filterFunc) {
-	if (!searchText) return options;
-	const filterFn = filterFunc || defaultFilterOption;
-	return options.filter((opt) => filterFn(searchText, opt));
+ * 默认的选项过滤函数
+ * 根据 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);
 }
-//#endregion
-export { defaultFilterOption, filterOptions };
+
+/**
+ * 过滤选项列表
+ * @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);
+  });
+}

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

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