@pisell/utils 3.0.5 → 3.0.6

package/lib/otherUtils.js

@@ -1,103 +1,91 @@
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
+const require_runtime = require("./_virtual/_rolldown/runtime.js");
+const require_asyncToGenerator = require("./_virtual/_@oxc-project_runtime@0.122.0/helpers/asyncToGenerator.js");
+let crypto_js_md5 = require("crypto-js/md5");
+crypto_js_md5 = require_runtime.__toESM(crypto_js_md5);
+let crypto_js_enc_hex = require("crypto-js/enc-hex");
+crypto_js_enc_hex = require_runtime.__toESM(crypto_js_enc_hex);
+let detectincognitojs = require("detectincognitojs");
+//#region src/otherUtils.ts
+/**
+* @title: 判断是否无痕模式
+* @description:
+* @return: *
+* @Author: shengjie.zuo
+* @Date: 2024-09-4 09:58:22
+*/
+const detectIncognito = function() {
+	var _ref = require_asyncToGenerator._asyncToGenerator(function* () {
+		try {
+			if (navigator.userAgent.toLowerCase().includes("honor")) return { isPrivate: false };
+			return yield (0, detectincognitojs.detectIncognito)();
+		} catch (error) {
+			console.warn("detectIncognito failed:", error);
+			return { isPrivate: false };
+		}
+	});
+	return function detectIncognito() {
+		return _ref.apply(this, arguments);
+	};
+}();
+/**
+* @Description: 生成唯一id
+* @Author: wzw
+* @Date: 2020-12-01 14:20:29
+* @param {*}
+* @return {*}
+*/
+const getUniqueId = (prefix = "", maxLength = 11) => {
+	return prefix + (Math.random() + "").replace(/\D/g, "").substring(0, maxLength);
 };
-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;
+/**
+* @title: 对数组进行增|删
+* @description: 用于多选选中和取消选中的处理
+* @param {any} list
+* @param {any} item
+* @param {string} key
+* @return {*}
+* @Author: zhiwei.Wang
+* @Date: 2023-12-19 16:44
+*/
+const changeArray = (list = [], item, key = "this") => {
+	let _list = JSON.parse(JSON.stringify(list));
+	let isSome = false;
+	if (key === "this") isSome = _list.includes(item);
+	else isSome = _list.some((d) => d[key] === item[key]);
+	if (isSome) _list = _list.filter((d) => {
+		if (key === "this") return d !== item;
+		return d[key] !== item[key];
+	});
+	else _list.push(item);
+	return _list;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/otherUtils.ts
-var otherUtils_exports = {};
-__export(otherUtils_exports, {
-  changeArray: () => changeArray,
-  createArray: () => createArray,
-  detectIncognito: () => detectIncognito,
-  generateUniqueIdByObj: () => generateUniqueIdByObj,
-  getItemByArray: () => getItemByArray,
-  getUniqueId: () => getUniqueId
-});
-module.exports = __toCommonJS(otherUtils_exports);
-var import_md5 = __toESM(require("crypto-js/md5"));
-var import_enc_hex = __toESM(require("crypto-js/enc-hex"));
-var import_detectincognitojs = require("detectincognitojs");
-var detectIncognito = async () => {
-  try {
-    if (navigator.userAgent.toLowerCase().includes("honor")) {
-      return {
-        isPrivate: false
-      };
-    }
-    return await (0, import_detectincognitojs.detectIncognito)();
-  } catch (error) {
-    console.warn("detectIncognito failed:", error);
-    return {
-      isPrivate: false
-    };
-  }
+/**
+* @title: 判断某个字段是否在列表内
+* @description: 
+* @param {*} T
+* @param {boolean} param2
+* @return {*}
+* @Author: zhiwei.Wang
+* @Date: 2023-12-19 16:54
+*/
+const getItemByArray = (list = [], item, key = "this") => {
+	if (key === "this") return list.includes(item);
+	return list.some((d) => d[key] === item[key]);
 };
-var getUniqueId = (prefix = "", maxLength = 11) => {
-  return prefix + (Math.random() + "").replace(/\D/g, "").substring(0, maxLength);
+const createArray = (length, returnItem) => {
+	return Array.from(new Array(length)).map(returnItem);
 };
-var changeArray = (list = [], item, key = "this") => {
-  let _list = JSON.parse(JSON.stringify(list));
-  let isSome = false;
-  if (key === "this") {
-    isSome = _list.includes(item);
-  } else {
-    isSome = _list.some((d) => d[key] === item[key]);
-  }
-  if (isSome) {
-    _list = _list.filter((d) => {
-      if (key === "this") {
-        return d !== item;
-      }
-      return d[key] !== item[key];
-    });
-  } else {
-    _list.push(item);
-  }
-  return _list;
+/**
+* 根据对象内容生成唯一id
+* @param obj
+*/
+const generateUniqueIdByObj = (obj) => {
+	return (0, crypto_js_md5.default)(JSON.stringify(obj)).toString(crypto_js_enc_hex.default.Hex);
 };
-var getItemByArray = (list = [], item, key = "this") => {
-  if (key === "this") {
-    return list.includes(item);
-  }
-  return list.some((d) => d[key] === item[key]);
-};
-var createArray = (length, returnItem) => {
-  return Array.from(new Array(length)).map(returnItem);
-};
-var generateUniqueIdByObj = (obj) => {
-  const jsonString = JSON.stringify(obj);
-  const hash = (0, import_md5.default)(jsonString);
-  return hash.toString(import_enc_hex.default.Hex);
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  changeArray,
-  createArray,
-  detectIncognito,
-  generateUniqueIdByObj,
-  getItemByArray,
-  getUniqueId
-});
+//#endregion
+exports.changeArray = changeArray;
+exports.createArray = createArray;
+exports.detectIncognito = detectIncognito;
+exports.generateUniqueIdByObj = generateUniqueIdByObj;
+exports.getItemByArray = getItemByArray;
+exports.getUniqueId = getUniqueId;

package/lib/platform.d.ts

@@ -1,9 +1,12 @@
-export declare const isIpad: () => boolean;
-export declare const isMobile: () => boolean;
-export declare const isAndroid: () => boolean;
-export declare const isIos: () => boolean;
-export declare const checkEnv: () => number;
-export declare const isWx: () => boolean;
-export declare const isIOS: () => boolean;
-export declare const isWxApp: () => boolean;
-export declare const isSafari: () => boolean;
+//#region src/platform.d.ts
+declare const isIpad: () => boolean;
+declare const isMobile: () => boolean;
+declare const isAndroid: () => boolean;
+declare const isIos: () => boolean;
+declare const checkEnv: () => number;
+declare const isWx: () => boolean;
+declare const isIOS: () => boolean;
+declare const isWxApp: () => boolean;
+declare const isSafari: () => boolean;
+//#endregion
+export { checkEnv, isAndroid, isIOS, isIos, isIpad, isMobile, isSafari, isWx, isWxApp };

package/lib/platform.js

@@ -1,132 +1,77 @@
-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 });
+//#region src/platform.ts
+const isBrowser = typeof window != "undefined" && window.document;
+const isIpad = () => {
+	var ua = navigator.userAgent;
+	var isSafari = ua.indexOf("Safari") != -1 && ua.indexOf("Version") != -1;
+	var isIphone = ua.indexOf("iPhone") != -1 && ua.indexOf("Version") != -1;
+	var isIPad = isSafari && !isIphone && "ontouchend" in document;
+	if (!/iphone|ios|ipad|android|mobile/i.test(navigator.userAgent.toLowerCase()) && !isIPad) return false;
+	return 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;
+const isMobile = () => {
+	let sUserAgent = window.navigator.userAgent.toLowerCase();
+	let bIsIpad = sUserAgent.match(/ipad/i) == "ipad";
+	let bIsIphoneOs = sUserAgent.match(/iphone os/i) == "iphone os";
+	let bIsMidp = sUserAgent.match(/midp/i) == "midp";
+	let bIsUc7 = sUserAgent.match(/rv:1.2.3.4/i) == "rv:1.2.3.4";
+	let bIsUc = sUserAgent.match(/ucweb/i) == "ucweb";
+	let bIsAndroid = sUserAgent.match(/android/i) == "android";
+	let bIsCE = sUserAgent.match(/windows ce/i) == "windows ce";
+	let bIsWM = sUserAgent.match(/windows mobile/i) == "windows mobile";
+	if (bIsIpad || bIsIphoneOs || bIsMidp || bIsUc7 || bIsUc || bIsAndroid || bIsCE || bIsWM || isIpad()) return true;
+	else return false;
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/platform.ts
-var platform_exports = {};
-__export(platform_exports, {
-  checkEnv: () => checkEnv,
-  isAndroid: () => isAndroid,
-  isIOS: () => isIOS,
-  isIos: () => isIos,
-  isIpad: () => isIpad,
-  isMobile: () => isMobile,
-  isSafari: () => isSafari,
-  isWx: () => isWx,
-  isWxApp: () => isWxApp
-});
-module.exports = __toCommonJS(platform_exports);
-var isBrowser = typeof window != "undefined" && window.document;
-var isIpad = () => {
-  var ua = navigator.userAgent;
-  var isSafari2 = ua.indexOf("Safari") != -1 && ua.indexOf("Version") != -1;
-  var isIphone = ua.indexOf("iPhone") != -1 && ua.indexOf("Version") != -1;
-  var isIPad = isSafari2 && !isIphone && "ontouchend" in document;
-  if (!/iphone|ios|ipad|android|mobile/i.test(
-    navigator.userAgent.toLowerCase()
-  ) && !isIPad) {
-    return false;
-  }
-  return true;
+const isAndroid = () => {
+	return navigator.userAgent.toLowerCase().indexOf("android") !== -1;
 };
-var isMobile = () => {
-  let sUserAgent = window.navigator.userAgent.toLowerCase();
-  let bIsIpad = sUserAgent.match(/ipad/i) == "ipad";
-  let bIsIphoneOs = sUserAgent.match(/iphone os/i) == "iphone os";
-  let bIsMidp = sUserAgent.match(/midp/i) == "midp";
-  let bIsUc7 = sUserAgent.match(/rv:1.2.3.4/i) == "rv:1.2.3.4";
-  let bIsUc = sUserAgent.match(/ucweb/i) == "ucweb";
-  let bIsAndroid = sUserAgent.match(/android/i) == "android";
-  let bIsCE = sUserAgent.match(/windows ce/i) == "windows ce";
-  let bIsWM = sUserAgent.match(/windows mobile/i) == "windows mobile";
-  if (bIsIpad || bIsIphoneOs || bIsMidp || bIsUc7 || bIsUc || bIsAndroid || bIsCE || bIsWM || isIpad()) {
-    return true;
-  } else {
-    return false;
-  }
+const isIos = () => {
+	return /iphone|ipad|ipod/.test(navigator.userAgent.toLowerCase());
 };
-var isAndroid = () => {
-  return navigator.userAgent.toLowerCase().indexOf("android") !== -1;
+const checkEnv = () => {
+	let env = 0;
+	let userAgent = window.navigator.userAgent;
+	let isOpera = userAgent.indexOf("Opera") > -1 || userAgent.indexOf("OPR") > -1;
+	let isIE = userAgent.indexOf("compatible") > -1 && userAgent.indexOf("MSIE") > -1;
+	let isIE11 = userAgent.indexOf("compatible") === -1 && userAgent.indexOf("Trident") > -1;
+	let isEdge = userAgent.indexOf("Edge") > -1;
+	let isFF = userAgent.indexOf("Firefox") > -1;
+	let isSafari = userAgent.indexOf("Safari") > -1 && userAgent.indexOf("Chrome") === -1;
+	let isChrome = userAgent.indexOf("Chrome") > -1 && userAgent.indexOf("; Win") > -1 && userAgent.indexOf("Safari") > -1;
+	if (isOpera || isIE || isIE11 || isEdge || isFF || isSafari || isChrome) env = 0;
+	else env = 1;
+	return env;
 };
-var isIos = () => {
-  return /iphone|ipad|ipod/.test(navigator.userAgent.toLowerCase());
+const isWx = () => {
+	if (isBrowser) {
+		let ua = "";
+		if (isBrowser) ua = window.navigator.userAgent.toLowerCase();
+		if (ua.match(/MicroMessenger/i) == "micromessenger") return true;
+		return false;
+	}
+	return false;
 };
-var checkEnv = () => {
-  let env = 0;
-  let userAgent = window.navigator.userAgent;
-  let isOpera = userAgent.indexOf("Opera") > -1 || userAgent.indexOf("OPR") > -1;
-  let isIE = userAgent.indexOf("compatible") > -1 && userAgent.indexOf("MSIE") > -1;
-  let isIE11 = userAgent.indexOf("compatible") === -1 && userAgent.indexOf("Trident") > -1;
-  let isEdge = userAgent.indexOf("Edge") > -1;
-  let isFF = userAgent.indexOf("Firefox") > -1;
-  let isSafari2 = userAgent.indexOf("Safari") > -1 && userAgent.indexOf("Chrome") === -1;
-  let isChrome = userAgent.indexOf("Chrome") > -1 && userAgent.indexOf("; Win") > -1 && userAgent.indexOf("Safari") > -1;
-  if (isOpera || isIE || isIE11 || isEdge || isFF || isSafari2 || isChrome) {
-    env = 0;
-  } else {
-    env = 1;
-  }
-  return env;
+const isIOS = () => {
+	if (isBrowser) return !!navigator.userAgent.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/);
+	return false;
 };
-var isWx = () => {
-  if (isBrowser) {
-    let ua = "";
-    if (isBrowser) {
-      ua = window.navigator.userAgent.toLowerCase();
-    }
-    if (ua.match(/MicroMessenger/i) == "micromessenger") {
-      return true;
-    }
-    return false;
-  }
-  return false;
+const isWxApp = () => {
+	if (isBrowser) return navigator.userAgent.indexOf("miniProgram") !== -1;
+	return false;
 };
-var isIOS = () => {
-  if (isBrowser) {
-    let u = navigator.userAgent;
-    let isiOS = !!u.match(/\(i[^;]+;( U;)? CPU.+Mac OS X/);
-    return isiOS;
-  }
-  return false;
+const isSafari = () => {
+	if (isBrowser) {
+		let userAgent = window.navigator.userAgent;
+		return userAgent.indexOf("Safari") > -1 && userAgent.indexOf("Chrome") === -1 && userAgent.indexOf("CriOS") === -1 && userAgent.indexOf("ChannelName/Feishu") === -1;
+	}
+	return false;
 };
-var isWxApp = () => {
-  if (isBrowser) {
-    let u = navigator.userAgent;
-    let isWxapp = u.indexOf("miniProgram") !== -1;
-    return isWxapp;
-  }
-  return false;
-};
-var isSafari = () => {
-  if (isBrowser) {
-    let userAgent = window.navigator.userAgent;
-    return userAgent.indexOf("Safari") > -1 && userAgent.indexOf("Chrome") === -1 && userAgent.indexOf("CriOS") === -1 && userAgent.indexOf("ChannelName/Feishu") === -1;
-  }
-  return false;
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  checkEnv,
-  isAndroid,
-  isIOS,
-  isIos,
-  isIpad,
-  isMobile,
-  isSafari,
-  isWx,
-  isWxApp
-});
+//#endregion
+exports.checkEnv = checkEnv;
+exports.isAndroid = isAndroid;
+exports.isIOS = isIOS;
+exports.isIos = isIos;
+exports.isIpad = isIpad;
+exports.isMobile = isMobile;
+exports.isSafari = isSafari;
+exports.isWx = isWx;
+exports.isWxApp = isWxApp;

package/lib/select/hooks/useDebouncedSearch.d.ts

@@ -0,0 +1,23 @@
+//#region src/select/hooks/useDebouncedSearch.d.ts
+/**
+ * 防抖搜索 Hook
+ * 对用户输入进行防抖处理，避免频繁触发搜索
+ */
+/**
+ * 防抖搜索 Hook
+ * @template T 值的类型
+ * @param initialValue 初始值
+ * @param delay 防抖延迟时间（毫秒）
+ * @param callback 防抖后的回调函数
+ * @returns [防抖后的值, 设置值函数]
+ *
+ * @example
+ * ```tsx
+ * const [debouncedSearch, setSearchInput] = useDebouncedSearch('', 300, (text) => {
+ *   console.log('搜索关键词:', text);
+ * });
+ * ```
+ */
+declare function useDebouncedSearch<T = string>(initialValue: T, delay: number, callback?: (value: T) => void): [T, (value: T) => void];
+//#endregion
+export { useDebouncedSearch };

package/lib/select/hooks/useDebouncedSearch.js

@@ -0,0 +1,42 @@
+require("../../_virtual/_rolldown/runtime.js");
+let react = require("react");
+//#region src/select/hooks/useDebouncedSearch.ts
+/**
+* 防抖搜索 Hook
+* 对用户输入进行防抖处理，避免频繁触发搜索
+*/
+/**
+* 防抖搜索 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] = (0, react.useState)(initialValue);
+	const [debouncedValue, setDebouncedValue] = (0, react.useState)(initialValue);
+	(0, react.useEffect)(() => {
+		const timer = setTimeout(() => {
+			setDebouncedValue(value);
+			callback === null || callback === void 0 || callback(value);
+		}, delay);
+		return () => {
+			clearTimeout(timer);
+		};
+	}, [
+		value,
+		delay,
+		callback
+	]);
+	return [debouncedValue, setValue];
+}
+//#endregion
+exports.useDebouncedSearch = useDebouncedSearch;

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

@@ -0,0 +1,19 @@
+import { MultipleSelectState, SelectState, UseMultipleSelectStateOptions, UseSelectStateOptions } from "../types.js";
+
+//#region src/select/hooks/useSelectState.d.ts
+/**
+ * 单选状态管理 Hook
+ * @template T 值的类型
+ * @param options Hook 配置选项
+ * @returns 状态管理对象
+ */
+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 };

package/lib/select/hooks/useSelectState.js

@@ -0,0 +1,62 @@
+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, 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, 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])
+	};
+}
+//#endregion
+exports.useMultipleSelectState = useMultipleSelectState;
+exports.useSelectState = useSelectState;

package/lib/select/index.d.ts

@@ -0,0 +1,7 @@
+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";