@pisell/utils 1.0.72 → 1.0.73

package/lib/select/hooks/useSelectState.js

@@ -1,97 +1,62 @@
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/select/hooks/useSelectState.ts
-var useSelectState_exports = {};
-__export(useSelectState_exports, {
-  useMultipleSelectState: () => useMultipleSelectState,
-  useSelectState: () => useSelectState
-});
-module.exports = __toCommonJS(useSelectState_exports);
-var import_react = require("react");
+require("../../_virtual/_rolldown/runtime.js");
+let react = require("react");
+//#region src/select/hooks/useSelectState.ts
+/**
+* Select 状态管理 Hook
+* 处理受控/非受控模式，适用于单选和多选
+*/
+/**
+* 单选状态管理 Hook
+* @template T 值的类型
+* @param options Hook 配置选项
+* @returns 状态管理对象
+*/
 function useSelectState(options) {
-  const { value: controlledValue, defaultValue, onChange } = options;
-  const isControlled = controlledValue !== void 0;
-  const [internalValue, setInternalValue] = (0, import_react.useState)(
-    defaultValue ?? null
-  );
-  const value = isControlled ? controlledValue : internalValue;
-  const setValue = (0, import_react.useCallback)(
-    (newValue) => {
-      if (!isControlled) {
-        setInternalValue(newValue);
-      }
-      onChange == null ? void 0 : onChange(newValue, null);
-    },
-    [isControlled, onChange]
-  );
-  const clearValue = (0, import_react.useCallback)(() => {
-    setValue(null);
-  }, [setValue]);
-  return {
-    value,
-    setValue,
-    clearValue
-  };
+	const { value: controlledValue, defaultValue, onChange } = options;
+	const isControlled = controlledValue !== void 0;
+	const [internalValue, setInternalValue] = (0, react.useState)(defaultValue !== null && defaultValue !== void 0 ? defaultValue : null);
+	const value = isControlled ? controlledValue : internalValue;
+	const setValue = (0, react.useCallback)((newValue) => {
+		if (!isControlled) setInternalValue(newValue);
+		onChange === null || onChange === void 0 || onChange(newValue, null);
+	}, [isControlled, onChange]);
+	return {
+		value,
+		setValue,
+		clearValue: (0, react.useCallback)(() => {
+			setValue(null);
+		}, [setValue])
+	};
 }
+/**
+* 多选状态管理 Hook
+* @template T 值的类型
+* @param options Hook 配置选项
+* @returns 状态管理对象
+*/
 function useMultipleSelectState(options) {
-  const { value: controlledValue, defaultValue, onChange } = options;
-  const isControlled = controlledValue !== void 0;
-  const [internalValue, setInternalValue] = (0, import_react.useState)(
-    defaultValue ?? []
-  );
-  const value = isControlled ? controlledValue ?? [] : internalValue;
-  const setValue = (0, import_react.useCallback)(
-    (newValue) => {
-      if (!isControlled) {
-        setInternalValue(newValue);
-      }
-      onChange == null ? void 0 : onChange(newValue, []);
-    },
-    [isControlled, onChange]
-  );
-  const addValue = (0, import_react.useCallback)(
-    (val) => {
-      const newValue = [...value, val];
-      setValue(newValue);
-    },
-    [value, setValue]
-  );
-  const removeValue = (0, import_react.useCallback)(
-    (val) => {
-      const newValue = value.filter((v) => v !== val);
-      setValue(newValue);
-    },
-    [value, setValue]
-  );
-  const clearValue = (0, import_react.useCallback)(() => {
-    setValue([]);
-  }, [setValue]);
-  return {
-    value,
-    setValue,
-    addValue,
-    removeValue,
-    clearValue
-  };
+	const { value: controlledValue, defaultValue, onChange } = options;
+	const isControlled = controlledValue !== void 0;
+	const [internalValue, setInternalValue] = (0, react.useState)(defaultValue !== null && defaultValue !== void 0 ? defaultValue : []);
+	const value = isControlled ? controlledValue !== null && controlledValue !== void 0 ? controlledValue : [] : internalValue;
+	const setValue = (0, react.useCallback)((newValue) => {
+		if (!isControlled) setInternalValue(newValue);
+		onChange === null || onChange === void 0 || onChange(newValue, []);
+	}, [isControlled, onChange]);
+	return {
+		value,
+		setValue,
+		addValue: (0, react.useCallback)((val) => {
+			setValue([...value, val]);
+		}, [value, setValue]),
+		removeValue: (0, react.useCallback)((val) => {
+			setValue(value.filter((v) => v !== val));
+		}, [value, setValue]),
+		clearValue: (0, react.useCallback)(() => {
+			setValue([]);
+		}, [setValue])
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  useMultipleSelectState,
-  useSelectState
-});
+//#endregion
+exports.useMultipleSelectState = useMultipleSelectState;
+exports.useSelectState = useSelectState;

package/lib/select/index.d.ts

@@ -1,8 +1,7 @@
-/**
- * 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';
+import { BaseSelectProps, FilterOptionFunc, MultipleSelectState, SelectOption, SelectState, SortDirection, TagDisplayInfo, UseMultipleSelectStateOptions, UseSelectStateOptions } from "./types.js";
+import { useMultipleSelectState, useSelectState } from "./hooks/useSelectState.js";
+import { useDebouncedSearch } from "./hooks/useDebouncedSearch.js";
+import { calculateTagDisplay } from "./utils/tagAggregation.js";
+import { defaultFilterOption, filterOptions } from "./utils/filterOptions.js";
+import { sortOptions } from "./utils/sortOptions.js";
+import { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple } from "./utils/helpers.js";

package/lib/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/lib/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 };