@pisell/utils 3.0.5 → 3.0.7

package/lib/number-input/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * 数值输入组件公共类型定义
+ * 供 PisellNumber、PisellCurrency、PisellPercent 等组件使用
+ */
+export type { DisplayState, ValidationResult } from '../common';
+/**
+ * 数值输入状态 Hook 返回值
+ */
+export interface NumberInputState {
+    /**
+     * 当前值
+     */
+    value: number | null | undefined;
+    /**
+     * 是否已被触摸（交互过）
+     */
+    isTouched: boolean;
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+    /**
+     * 值变更处理函数
+     */
+    handleChange: (value: number | null) => void;
+    /**
+     * 失焦处理函数
+     */
+    handleBlur: () => void;
+    /**
+     * 聚焦处理函数
+     */
+    handleFocus: () => void;
+}
+/**
+ * 基础数值输入 Props（供校验和状态管理使用）
+ */
+export interface BaseNumberInputProps {
+    /**
+     * 当前值（受控）
+     */
+    value?: number | null;
+    /**
+     * 默认值（非受控）
+     */
+    defaultValue?: number | null;
+    /**
+     * 是否必填
+     */
+    required?: boolean;
+    /**
+     * 最小值
+     */
+    min?: number;
+    /**
+     * 最大值
+     */
+    max?: number;
+    /**
+     * 自定义校验函数
+     * @param value 当前值
+     * @returns true 表示通过，false 或错误信息字符串表示不通过
+     */
+    validator?: (value: number | null) => boolean | string;
+    /**
+     * 校验触发时机
+     * - onChange: 输入时即时校验
+     * - onBlur: 失焦时校验
+     * - both: 输入和失焦时都校验
+     */
+    validateTrigger?: 'onChange' | 'onBlur' | 'both';
+    /**
+     * 自定义错误提示信息
+     */
+    errorMessage?: string;
+    /**
+     * 值变更回调
+     */
+    onChange?: (value: number | null) => void;
+    /**
+     * 失焦回调
+     */
+    onBlur?: (value: number | null) => void;
+    /**
+     * 聚焦回调
+     */
+    onFocus?: () => void;
+    /**
+     * 校验回调
+     */
+    onValidate?: (isValid: boolean, errors: string[]) => void;
+}

package/lib/number-input/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/number-input/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/number-input/utils/formatter.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 数值格式化工具函数
+ */
+/**
+ * 格式化选项
+ */
+export interface NumberFormatOptions {
+    /** 小数精度 */
+    precision?: number;
+    /** 是否使用千分位分隔符 */
+    useGrouping?: boolean;
+    /** 自定义格式化函数 */
+    formatter?: (value: number | null) => string;
+}
+/**
+ * 格式化数值
+ *
+ * @param value 数值
+ * @param options 格式化选项
+ * @returns 格式化后的字符串，null 时返回 null
+ *
+ * @example
+ * formatNumber(1234.567, { precision: 2, useGrouping: true })
+ * // 返回: "1,234.57"
+ *
+ * @example
+ * formatNumber(1234, { precision: 0, useGrouping: true })
+ * // 返回: "1,234"
+ */
+export declare function formatNumber(value: number | null | undefined, options?: NumberFormatOptions): string | null;
+/**
+ * 添加千分位分隔符
+ *
+ * @param value 数值
+ * @returns 添加千分位后的字符串
+ *
+ * @example
+ * addThousandsSeparator(1234567)
+ * // 返回: "1,234,567"
+ */
+export declare function addThousandsSeparator(value: number): string;
+/**
+ * 格式化精度
+ *
+ * @param value 数值
+ * @param precision 小数位数
+ * @returns 格式化后的数值
+ *
+ * @example
+ * formatPrecision(1.2345, 2)
+ * // 返回: 1.23
+ */
+export declare function formatPrecision(value: number, precision: number): number;

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

@@ -0,0 +1,55 @@
+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/formatter.ts
+var formatter_exports = {};
+__export(formatter_exports, {
+  addThousandsSeparator: () => addThousandsSeparator,
+  formatNumber: () => formatNumber,
+  formatPrecision: () => formatPrecision
+});
+module.exports = __toCommonJS(formatter_exports);
+function formatNumber(value, options = {}) {
+  if (value === null || value === void 0) {
+    return null;
+  }
+  const { precision, useGrouping = false, formatter } = options;
+  if (formatter) {
+    return formatter(value);
+  }
+  if (useGrouping || precision !== void 0) {
+    return value.toLocaleString("zh-CN", {
+      minimumFractionDigits: precision,
+      maximumFractionDigits: precision,
+      useGrouping
+    });
+  }
+  return String(value);
+}
+function addThousandsSeparator(value) {
+  return value.toLocaleString("zh-CN", { useGrouping: true });
+}
+function formatPrecision(value, precision) {
+  return Number(value.toFixed(precision));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addThousandsSeparator,
+  formatNumber,
+  formatPrecision
+});

package/lib/number-input/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 数值输入工具函数导出
+ */
+export { validateValue } from './validation';
+export { getDisplayState } from '../../common';
+export { formatNumber, addThousandsSeparator, formatPrecision } from './formatter';
+export type { NumberFormatOptions } from './formatter';

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

@@ -0,0 +1,39 @@
+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/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  addThousandsSeparator: () => import_formatter.addThousandsSeparator,
+  formatNumber: () => import_formatter.formatNumber,
+  formatPrecision: () => import_formatter.formatPrecision,
+  getDisplayState: () => import_common.getDisplayState,
+  validateValue: () => import_validation.validateValue
+});
+module.exports = __toCommonJS(utils_exports);
+var import_validation = require("./validation");
+var import_common = require("../../common");
+var import_formatter = require("./formatter");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addThousandsSeparator,
+  formatNumber,
+  formatPrecision,
+  getDisplayState,
+  validateValue
+});

package/lib/number-input/utils/validation.d.ts

@@ -0,0 +1,27 @@
+import type { BaseNumberInputProps, ValidationResult } from '../types';
+/**
+ * 校验数值输入
+ *
+ * 按照优先级执行校验规则：
+ * 1. 必填校验（required）
+ * 2. 最小值校验（min）
+ * 3. 最大值校验（max）
+ * 4. 自定义校验函数（validator）
+ *
+ * @param value 待校验的值
+ * @param props 校验配置
+ * @returns 校验结果对象，包含 isValid 和 errors
+ *
+ * @example
+ * validateValue(10, { required: true, min: 0, max: 100 })
+ * // { isValid: true, errors: [] }
+ *
+ * @example
+ * validateValue(null, { required: true })
+ * // { isValid: false, errors: ['此字段为必填项'] }
+ *
+ * @example
+ * validateValue(150, { min: 0, max: 100 })
+ * // { isValid: false, errors: ['不能大于 100'] }
+ */
+export declare function validateValue(value: number | null | undefined, props: BaseNumberInputProps): ValidationResult;

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.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @title: 判断是否无痕模式
+ * @description:
+ * @return: *
+ * @Author: shengjie.zuo
+ * @Date: 2024-09-4 09:58:22
+ */
+export declare const detectIncognito: () => Promise<{
+    isPrivate: boolean;
+    browserName: string;
+} | {
+    isPrivate: boolean;
+}>;
+/**
+ * @Description: 生成唯一id
+ * @Author: wzw
+ * @Date: 2020-12-01 14:20:29
+ * @param {*}
+ * @return {*}
+ */
+export declare const getUniqueId: (prefix?: string, maxLength?: number) => string;
+/**
+ * @title: 对数组进行增|删
+ * @description: 用于多选选中和取消选中的处理
+ * @param {any} list
+ * @param {any} item
+ * @param {string} key
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2023-12-19 16:44
+ */
+export declare const changeArray: <T>(list: T[] | undefined, item: T, key?: string) => T[];
+/**
+ * @title: 判断某个字段是否在列表内
+ * @description:
+ * @param {*} T
+ * @param {boolean} param2
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2023-12-19 16:54
+ */
+export declare const getItemByArray: <T>(list: T[] | undefined, item: T, key?: string) => boolean;
+export declare const createArray: (length: number, returnItem: any) => unknown[];
+/**
+ * 根据对象内容生成唯一id
+ * @param obj
+ */
+export declare const generateUniqueIdByObj: (obj: Record<string, any>) => any;

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';