@pisell/utils 3.0.6 → 3.0.7

package/es/select/hooks/useDebouncedSearch.js

@@ -1,41 +1,55 @@
-import { useEffect, useState } from "react";
-//#region src/select/hooks/useDebouncedSearch.ts
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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; }
 /**
-* 防抖搜索 Hook
-* 对用户输入进行防抖处理，避免频繁触发搜索
-*/
+ * 防抖搜索 Hook
+ * 对用户输入进行防抖处理，避免频繁触发搜索
+ */
+
+import { useState, useEffect } from 'react';
+
 /**
-* 防抖搜索 Hook
-* @template T 值的类型
-* @param initialValue 初始值
-* @param delay 防抖延迟时间（毫秒）
-* @param callback 防抖后的回调函数
-* @returns [防抖后的值, 设置值函数]
-* 
-* @example
-* ```tsx
-* const [debouncedSearch, setSearchInput] = useDebouncedSearch('', 300, (text) => {
-*   console.log('搜索关键词:', text);
-* });
-* ```
-*/
-function useDebouncedSearch(initialValue, delay, callback) {
-	const [value, setValue] = useState(initialValue);
-	const [debouncedValue, setDebouncedValue] = useState(initialValue);
-	useEffect(() => {
-		const timer = setTimeout(() => {
-			setDebouncedValue(value);
-			callback === null || callback === void 0 || callback(value);
-		}, delay);
-		return () => {
-			clearTimeout(timer);
-		};
-	}, [
-		value,
-		delay,
-		callback
-	]);
-	return [debouncedValue, setValue];
-}
-//#endregion
-export { useDebouncedSearch };
+ * 防抖搜索 Hook
+ * @template T 值的类型
+ * @param initialValue 初始值
+ * @param delay 防抖延迟时间（毫秒）
+ * @param callback 防抖后的回调函数
+ * @returns [防抖后的值, 设置值函数]
+ * 
+ * @example
+ * ```tsx
+ * const [debouncedSearch, setSearchInput] = useDebouncedSearch('', 300, (text) => {
+ *   console.log('搜索关键词:', text);
+ * });
+ * ```
+ */
+export function useDebouncedSearch(initialValue, delay, callback) {
+  // 实时值（用户输入）
+  var _useState = useState(initialValue),
+    _useState2 = _slicedToArray(_useState, 2),
+    value = _useState2[0],
+    setValue = _useState2[1];
+
+  // 防抖后的值
+  var _useState3 = useState(initialValue),
+    _useState4 = _slicedToArray(_useState3, 2),
+    debouncedValue = _useState4[0],
+    setDebouncedValue = _useState4[1];
+  useEffect(function () {
+    // 创建定时器
+    var timer = setTimeout(function () {
+      setDebouncedValue(value);
+      // 触发回调
+      callback === null || callback === void 0 || callback(value);
+    }, delay);
+
+    // 清理定时器
+    return function () {
+      clearTimeout(timer);
+    };
+  }, [value, delay, callback]);
+  return [debouncedValue, setValue];
+}

package/es/select/hooks/useSelectState.d.ts

@@ -1,19 +1,19 @@
-import { MultipleSelectState, SelectState, UseMultipleSelectStateOptions, UseSelectStateOptions } from "../types.js";
-
-//#region src/select/hooks/useSelectState.d.ts
+/**
+ * Select 状态管理 Hook
+ * 处理受控/非受控模式，适用于单选和多选
+ */
+import type { UseSelectStateOptions, UseMultipleSelectStateOptions, SelectState, MultipleSelectState } from '../types';
 /**
  * 单选状态管理 Hook
  * @template T 值的类型
  * @param options Hook 配置选项
  * @returns 状态管理对象
  */
-declare function useSelectState<T = string | number>(options: UseSelectStateOptions<T>): SelectState<T>;
+export declare function useSelectState<T = string | number>(options: UseSelectStateOptions<T>): SelectState<T>;
 /**
  * 多选状态管理 Hook
  * @template T 值的类型
  * @param options Hook 配置选项
  * @returns 状态管理对象
  */
-declare function useMultipleSelectState<T = string | number>(options: UseMultipleSelectStateOptions<T>): MultipleSelectState<T>;
-//#endregion
-export { useMultipleSelectState, useSelectState };
+export declare function useMultipleSelectState<T = string | number>(options: UseMultipleSelectStateOptions<T>): MultipleSelectState<T>;

package/es/select/hooks/useSelectState.js

@@ -1,60 +1,117 @@
-import { useCallback, useState } from "react";
-//#region src/select/hooks/useSelectState.ts
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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 状态管理对象
-*/
-function useSelectState(options) {
-	const { value: controlledValue, defaultValue, onChange } = options;
-	const isControlled = controlledValue !== void 0;
-	const [internalValue, setInternalValue] = useState(defaultValue !== null && defaultValue !== void 0 ? defaultValue : null);
-	const value = isControlled ? controlledValue : internalValue;
-	const setValue = useCallback((newValue) => {
-		if (!isControlled) setInternalValue(newValue);
-		onChange === null || onChange === void 0 || onChange(newValue, null);
-	}, [isControlled, onChange]);
-	return {
-		value,
-		setValue,
-		clearValue: useCallback(() => {
-			setValue(null);
-		}, [setValue])
-	};
+ * 单选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
+ */
+export function useSelectState(options) {
+  var controlledValue = options.value,
+    defaultValue = options.defaultValue,
+    onChange = options.onChange;
+
+  // 判断是否为受控组件
+  var isControlled = controlledValue !== undefined;
+
+  // 内部状态（非受控模式使用）
+  var _useState = useState(defaultValue !== null && defaultValue !== void 0 ? defaultValue : null),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalValue = _useState2[0],
+    setInternalValue = _useState2[1];
+
+  // 当前值
+  var value = isControlled ? controlledValue : internalValue;
+
+  // 设置值
+  var setValue = useCallback(function (newValue) {
+    if (!isControlled) {
+      setInternalValue(newValue);
+    }
+    // 触发 onChange 回调
+    onChange === null || onChange === void 0 || onChange(newValue, null); // TODO: 传入对应的 option 对象
+  }, [isControlled, onChange]);
+
+  // 清空值
+  var clearValue = useCallback(function () {
+    setValue(null);
+  }, [setValue]);
+  return {
+    value: value,
+    setValue: setValue,
+    clearValue: clearValue
+  };
 }
+
 /**
-* 多选状态管理 Hook
-* @template T 值的类型
-* @param options Hook 配置选项
-* @returns 状态管理对象
-*/
-function useMultipleSelectState(options) {
-	const { value: controlledValue, defaultValue, onChange } = options;
-	const isControlled = controlledValue !== void 0;
-	const [internalValue, setInternalValue] = useState(defaultValue !== null && defaultValue !== void 0 ? defaultValue : []);
-	const value = isControlled ? controlledValue !== null && controlledValue !== void 0 ? controlledValue : [] : internalValue;
-	const setValue = useCallback((newValue) => {
-		if (!isControlled) setInternalValue(newValue);
-		onChange === null || onChange === void 0 || onChange(newValue, []);
-	}, [isControlled, onChange]);
-	return {
-		value,
-		setValue,
-		addValue: useCallback((val) => {
-			setValue([...value, val]);
-		}, [value, setValue]),
-		removeValue: useCallback((val) => {
-			setValue(value.filter((v) => v !== val));
-		}, [value, setValue]),
-		clearValue: useCallback(() => {
-			setValue([]);
-		}, [setValue])
-	};
-}
-//#endregion
-export { useMultipleSelectState, useSelectState };
+ * 多选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
+ */
+export function useMultipleSelectState(options) {
+  var controlledValue = options.value,
+    defaultValue = options.defaultValue,
+    onChange = options.onChange;
+
+  // 判断是否为受控组件
+  var isControlled = controlledValue !== undefined;
+
+  // 内部状态（非受控模式使用）
+  var _useState3 = useState(defaultValue !== null && defaultValue !== void 0 ? defaultValue : []),
+    _useState4 = _slicedToArray(_useState3, 2),
+    internalValue = _useState4[0],
+    setInternalValue = _useState4[1];
+
+  // 当前值
+  var value = isControlled ? controlledValue !== null && controlledValue !== void 0 ? controlledValue : [] : internalValue;
+
+  // 设置值
+  var setValue = useCallback(function (newValue) {
+    if (!isControlled) {
+      setInternalValue(newValue);
+    }
+    // 触发 onChange 回调
+    onChange === null || onChange === void 0 || onChange(newValue, []); // TODO: 传入对应的 options 数组
+  }, [isControlled, onChange]);
+
+  // 添加一个值
+  var addValue = useCallback(function (val) {
+    var newValue = [].concat(_toConsumableArray(value), [val]);
+    setValue(newValue);
+  }, [value, setValue]);
+
+  // 移除一个值
+  var removeValue = useCallback(function (val) {
+    var newValue = value.filter(function (v) {
+      return v !== val;
+    });
+    setValue(newValue);
+  }, [value, setValue]);
+
+  // 清空所有值
+  var clearValue = useCallback(function () {
+    setValue([]);
+  }, [setValue]);
+  return {
+    value: value,
+    setValue: setValue,
+    addValue: addValue,
+    removeValue: removeValue,
+    clearValue: clearValue
+  };
+}

package/es/select/index.d.ts

@@ -1,7 +1,8 @@
-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";
+/**
+ * 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

@@ -0,0 +1,13 @@
+/**
+ * Select 组件相关工具和类型导出
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+ */
+
+// 导出所有类型
+
+// 导出 Hooks
+export { useSelectState, useMultipleSelectState } from "./hooks/useSelectState";
+export { useDebouncedSearch } from "./hooks/useDebouncedSearch";
+
+// 导出工具函数
+export { filterOptions, defaultFilterOption, sortOptions, calculateTagDisplay, findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId } from "./utils";