@pisell/utils 1.0.55 → 1.0.57

package/lib/number-input/utils/validation.js

@@ -0,0 +1,54 @@
+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/number-input/utils/validation.ts
+var validation_exports = {};
+__export(validation_exports, {
+  validateValue: () => validateValue
+});
+module.exports = __toCommonJS(validation_exports);
+function validateValue(value, props) {
+  const errors = [];
+  if (props.required && (value === null || value === void 0)) {
+    errors.push(props.errorMessage || "此字段为必填项");
+    return { isValid: false, errors };
+  }
+  if (value === null || value === void 0) {
+    return { isValid: true, errors };
+  }
+  if (props.min !== void 0 && value < props.min) {
+    errors.push(`不能小于 ${props.min}`);
+  }
+  if (props.max !== void 0 && value > props.max) {
+    errors.push(`不能大于 ${props.max}`);
+  }
+  if (props.validator) {
+    const result = props.validator(value);
+    if (result !== true) {
+      errors.push(typeof result === "string" ? result : "校验失败");
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateValue
+});

package/lib/otherUtils.js

@@ -41,12 +41,19 @@ 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 () => {
-  if (navigator.userAgent.toLowerCase().includes("honor")) {
+  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
     };
   }
-  return await (0, import_detectincognitojs.detectIncognito)();
 };
 var getUniqueId = (prefix = "", maxLength = 11) => {
   return prefix + (Math.random() + "").replace(/\D/g, "").substring(0, maxLength);

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

@@ -0,0 +1,5 @@
+/**
+ * Select Hooks 导出
+ */
+export { useSelectState, useMultipleSelectState } from './useSelectState';
+export { useDebouncedSearch } from './useDebouncedSearch';

package/lib/select/hooks/index.js

@@ -0,0 +1,34 @@
+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/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useDebouncedSearch: () => import_useDebouncedSearch.useDebouncedSearch,
+  useMultipleSelectState: () => import_useSelectState.useMultipleSelectState,
+  useSelectState: () => import_useSelectState.useSelectState
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useSelectState = require("./useSelectState");
+var import_useDebouncedSearch = require("./useDebouncedSearch");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDebouncedSearch,
+  useMultipleSelectState,
+  useSelectState
+});

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

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

package/lib/select/hooks/useDebouncedSearch.js

@@ -0,0 +1,43 @@
+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/useDebouncedSearch.ts
+var useDebouncedSearch_exports = {};
+__export(useDebouncedSearch_exports, {
+  useDebouncedSearch: () => useDebouncedSearch
+});
+module.exports = __toCommonJS(useDebouncedSearch_exports);
+var import_react = require("react");
+function useDebouncedSearch(initialValue, delay, callback) {
+  const [value, setValue] = (0, import_react.useState)(initialValue);
+  const [debouncedValue, setDebouncedValue] = (0, import_react.useState)(initialValue);
+  (0, import_react.useEffect)(() => {
+    const timer = setTimeout(() => {
+      setDebouncedValue(value);
+      callback == null ? void 0 : callback(value);
+    }, delay);
+    return () => {
+      clearTimeout(timer);
+    };
+  }, [value, delay, callback]);
+  return [debouncedValue, setValue];
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useDebouncedSearch
+});

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

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

package/lib/select/hooks/useSelectState.js

@@ -0,0 +1,97 @@
+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");
+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
+  };
+}
+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
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useMultipleSelectState,
+  useSelectState
+});

package/lib/select/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 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/lib/select/index.js

@@ -0,0 +1,53 @@
+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/index.ts
+var select_exports = {};
+__export(select_exports, {
+  calculateTagDisplay: () => import_utils.calculateTagDisplay,
+  defaultFilterOption: () => import_utils.defaultFilterOption,
+  filterOptions: () => import_utils.filterOptions,
+  findOptionByValue: () => import_utils.findOptionByValue,
+  findOptionsByValues: () => import_utils.findOptionsByValues,
+  generateId: () => import_utils.generateId,
+  isOptionSelected: () => import_utils.isOptionSelected,
+  isOptionSelectedInMultiple: () => import_utils.isOptionSelectedInMultiple,
+  sortOptions: () => import_utils.sortOptions,
+  useDebouncedSearch: () => import_useDebouncedSearch.useDebouncedSearch,
+  useMultipleSelectState: () => import_useSelectState.useMultipleSelectState,
+  useSelectState: () => import_useSelectState.useSelectState
+});
+module.exports = __toCommonJS(select_exports);
+var import_useSelectState = require("./hooks/useSelectState");
+var import_useDebouncedSearch = require("./hooks/useDebouncedSearch");
+var import_utils = require("./utils");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  calculateTagDisplay,
+  defaultFilterOption,
+  filterOptions,
+  findOptionByValue,
+  findOptionsByValues,
+  generateId,
+  isOptionSelected,
+  isOptionSelectedInMultiple,
+  sortOptions,
+  useDebouncedSearch,
+  useMultipleSelectState,
+  useSelectState
+});

package/lib/select/types.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Select 组件公共类型定义
+ * 供 PisellSingleSelect、PisellMultipleSelect 等组件使用
+ */
+import React from 'react';
+export type { DisplayState } from '../common';
+/**
+ * 选项基础类型
+ * @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;
+}
+/**
+ * 选项过滤函数类型
+ * @template T 选项值的类型
+ * @param input 用户输入的搜索文本
+ * @param option 当前选项对象
+ * @returns 是否保留该选项
+ */
+export declare type FilterOptionFunc<T = string | number> = (input: string, option: SelectOption<T>) => boolean;
+/**
+ * 排序方向
+ */
+export declare 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;
+}
+/**
+ * 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;
+}
+/**
+ * 标签显示信息（多选专用）
+ * @template T 选项值的类型
+ */
+export 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';
+}
+/**
+ * useMultipleSelectState Hook 的配置选项（多选）
+ * @template T 值的类型
+ */
+export 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;
+}

package/lib/select/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

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

@@ -0,0 +1,22 @@
+/**
+ * 选项过滤工具函数
+ */
+import type { SelectOption, FilterOptionFunc } from '../types';
+/**
+ * 默认的选项过滤函数
+ * 根据 label 进行模糊匹配（不区分大小写）
+ * @template T 选项值的类型
+ * @param input 搜索输入文本
+ * @param option 选项对象
+ * @returns 是否保留该选项
+ */
+export declare function defaultFilterOption<T = string | number>(input: string, option: SelectOption<T>): boolean;
+/**
+ * 过滤选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param searchText 搜索文本
+ * @param filterFunc 自定义过滤函数（可选）
+ * @returns 过滤后的选项列表
+ */
+export declare function filterOptions<T = string | number>(options: SelectOption<T>[], searchText: string, filterFunc?: FilterOptionFunc<T>): SelectOption<T>[];