@pisell/utils 3.0.5 → 3.0.6

package/lib/miniRedux.d.ts

@@ -1,16 +1,23 @@
+//#region src/miniRedux.d.ts
 interface MiniReduxProps<State, Namespace> {
-    namespace?: Namespace;
-    state?: State;
-    reducers?: any;
-    effects?: any;
+  namespace?: Namespace;
+  state?: State;
+  reducers?: any;
+  effects?: any;
 }
-export declare const miniRedux: <State extends Record<string, any>, Namespace extends string>({ namespace, state, reducers, effects, }: MiniReduxProps<State, Namespace>) => {
-    Context: React.Context<{ [K in Namespace]: State; } & {
-        dispatch: (params: {
-            type: string;
-            payload: any;
-        }) => void;
-    }>;
-    Provider: (ComponentUi: any) => any;
+declare const miniRedux: <State extends Record<string, any>, Namespace extends string>({
+  namespace,
+  state,
+  reducers,
+  effects
+}: MiniReduxProps<State, Namespace>) => {
+  Context: React.Context<{ [K in Namespace]: State } & {
+    dispatch: (params: {
+      type: string;
+      payload: any;
+    }) => void;
+  }>;
+  Provider: (ComponentUi: any) => any;
 };
-export {};
+//#endregion
+export { miniRedux };

package/lib/miniRedux.js

@@ -1,92 +1,44 @@
-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_objectSpread2 = require("./_virtual/_@oxc-project_runtime@0.122.0/helpers/objectSpread2.js");
+let react = require("react");
+react = require_runtime.__toESM(react);
+//#region src/miniRedux.tsx
+const miniRedux = ({ namespace = "state", state, reducers = {}, effects = {} }) => {
+	const Context = (0, react.createContext)({});
+	const Provider = (ComponentUi) => {
+		return (0, react.forwardRef)((props, ref) => {
+			const stateRef = (0, react.useRef)();
+			const [providerState, dispatch] = (0, react.useReducer)((state, { type, payload }) => {
+				if (reducers[type]) return reducers[type](state, payload) || state;
+				else return state;
+			}, state);
+			stateRef.current = providerState;
+			const _dispatch = (0, react.useCallback)(({ type, payload }) => {
+				if (effects[type]) effects[type].call(null, stateRef.current, payload, dispatch);
+				else if (reducers[type]) dispatch({
+					type,
+					payload
+				});
+			}, []);
+			const contextValue = (0, react.useMemo)(() => ({
+				[namespace]: providerState,
+				dispatch: _dispatch
+			}), [providerState, _dispatch]);
+			let _props = require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, props), {}, {
+				[namespace]: providerState,
+				dispatch: _dispatch
+			});
+			if (_props.forwardedRef) {
+				_props.forwardedRef;
+				delete _props.forwardedRef;
+			}
+			return /* @__PURE__ */ react.default.createElement(Context.Provider, { value: contextValue }, /* @__PURE__ */ react.default.createElement(ComponentUi, require_objectSpread2._objectSpread2(require_objectSpread2._objectSpread2({}, _props), {}, { ref })));
+		});
+	};
+	return {
+		Context,
+		Provider
+	};
 };
-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 __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/miniRedux.tsx
-var miniRedux_exports = {};
-__export(miniRedux_exports, {
-  miniRedux: () => miniRedux
-});
-module.exports = __toCommonJS(miniRedux_exports);
-var import_react = __toESM(require("react"));
-var miniRedux = ({
-  namespace = "state",
-  state,
-  reducers = {},
-  effects = {}
-}) => {
-  const Context = (0, import_react.createContext)({});
-  const Provider = (ComponentUi) => {
-    const Components = (0, import_react.forwardRef)((props, ref) => {
-      const stateRef = (0, import_react.useRef)();
-      const [providerState, dispatch] = (0, import_react.useReducer)(
-        (state2, { type, payload }) => {
-          if (reducers[type]) {
-            return reducers[type](state2, payload) || state2;
-          } else {
-            return state2;
-          }
-        },
-        state
-      );
-      stateRef.current = providerState;
-      const _dispatch = (0, import_react.useCallback)(({ type, payload }) => {
-        if (effects[type]) {
-          effects[type].call(null, stateRef.current, payload, dispatch);
-        } else if (reducers[type]) {
-          dispatch({ type, payload });
-        }
-      }, []);
-      let _props = {
-        ...props,
-        [namespace]: providerState,
-        dispatch: _dispatch
-      };
-      let _ref = null;
-      if (_props.forwardedRef) {
-        _ref = _props.forwardedRef;
-        delete _props.forwardedRef;
-      }
-      return /* @__PURE__ */ import_react.default.createElement(
-        Context.Provider,
-        {
-          value: { [namespace]: providerState, dispatch: _dispatch }
-        },
-        /* @__PURE__ */ import_react.default.createElement(ComponentUi, { ..._props, ref })
-      );
-    });
-    return Components;
-  };
-  return {
-    Context,
-    Provider
-  };
-};
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  miniRedux
-});
+//#endregion
+exports.miniRedux = miniRedux;

package/lib/number-input/hooks/useNumberInputState.d.ts

@@ -0,0 +1,29 @@
+import { BaseNumberInputProps, NumberInputState } from "../types.js";
+
+//#region src/number-input/hooks/useNumberInputState.d.ts
+/**
+ * 数值输入状态管理 Hook
+ *
+ * 管理组件的内部状态，包括：
+ * - 值管理（受控/非受控模式）
+ * - 校验状态管理
+ * - 事件处理函数封装
+ *
+ * 支持受控和非受控两种模式：
+ * - 受控模式：value 由外部传入，组件不维护内部状态
+ * - 非受控模式：使用 defaultValue，组件维护内部状态
+ *
+ * @param props 组件 Props（包含校验配置）
+ * @returns 数值输入状态对象
+ *
+ * @example
+ * // 受控模式
+ * const state = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
+ *
+ * @example
+ * // 非受控模式
+ * const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
+ */
+declare function useNumberInputState(props: BaseNumberInputProps): NumberInputState;
+//#endregion
+export { useNumberInputState };

package/lib/number-input/hooks/useNumberInputState.js

@@ -0,0 +1,73 @@
+require("../../_virtual/_rolldown/runtime.js");
+const require_validation = require("../utils/validation.js");
+let react = require("react");
+//#region src/number-input/hooks/useNumberInputState.ts
+/**
+* 数值输入状态管理 Hook
+* 
+* 管理组件的内部状态，包括：
+* - 值管理（受控/非受控模式）
+* - 校验状态管理
+* - 事件处理函数封装
+* 
+* 支持受控和非受控两种模式：
+* - 受控模式：value 由外部传入，组件不维护内部状态
+* - 非受控模式：使用 defaultValue，组件维护内部状态
+* 
+* @param props 组件 Props（包含校验配置）
+* @returns 数值输入状态对象
+* 
+* @example
+* // 受控模式
+* const state = useNumberInputState({ value: 10, onChange: (v) => console.log(v) });
+* 
+* @example
+* // 非受控模式
+* const state = useNumberInputState({ defaultValue: 10, min: 0, max: 100 });
+*/
+function useNumberInputState(props) {
+	var _props$defaultValue;
+	const isControlled = props.value !== void 0;
+	const [innerValue, setInnerValue] = (0, react.useState)((_props$defaultValue = props.defaultValue) !== null && _props$defaultValue !== void 0 ? _props$defaultValue : null);
+	const [isTouched, setIsTouched] = (0, react.useState)(false);
+	const [isValid, setIsValid] = (0, react.useState)(true);
+	const [errors, setErrors] = (0, react.useState)([]);
+	const currentValue = isControlled ? props.value : innerValue;
+	return {
+		value: currentValue,
+		isTouched,
+		isValid,
+		errors,
+		handleChange: (0, react.useCallback)((newValue) => {
+			var _props$onChange;
+			if (!isControlled) setInnerValue(newValue);
+			if (props.validateTrigger === "onChange" || props.validateTrigger === "both") {
+				var _props$onValidate;
+				const validation = require_validation.validateValue(newValue, props);
+				setIsValid(validation.isValid);
+				setErrors(validation.errors);
+				(_props$onValidate = props.onValidate) === null || _props$onValidate === void 0 || _props$onValidate.call(props, validation.isValid, validation.errors);
+			}
+			(_props$onChange = props.onChange) === null || _props$onChange === void 0 || _props$onChange.call(props, newValue);
+		}, [isControlled, props]),
+		handleBlur: (0, react.useCallback)(() => {
+			var _props$onBlur;
+			setIsTouched(true);
+			if (props.validateTrigger !== "onChange") {
+				var _props$onValidate2;
+				const validation = require_validation.validateValue(currentValue, props);
+				setIsValid(validation.isValid);
+				setErrors(validation.errors);
+				(_props$onValidate2 = props.onValidate) === null || _props$onValidate2 === void 0 || _props$onValidate2.call(props, validation.isValid, validation.errors);
+			}
+			(_props$onBlur = props.onBlur) === null || _props$onBlur === void 0 || _props$onBlur.call(props, currentValue !== null && currentValue !== void 0 ? currentValue : null);
+		}, [currentValue, props]),
+		handleFocus: (0, react.useCallback)(() => {
+			var _props$onFocus;
+			setIsTouched(true);
+			(_props$onFocus = props.onFocus) === null || _props$onFocus === void 0 || _props$onFocus.call(props);
+		}, [props])
+	};
+}
+//#endregion
+exports.useNumberInputState = useNumberInputState;

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

@@ -0,0 +1,96 @@
+import { DisplayState, ValidationResult } from "../common/types.js";
+
+//#region src/number-input/types.d.ts
+/**
+ * 数值输入状态 Hook 返回值
+ */
+interface NumberInputState {
+  /**
+   * 当前值
+   */
+  value: number | null | undefined;
+  /**
+   * 是否已被触摸（交互过）
+   */
+  isTouched: boolean;
+  /**
+   * 是否校验通过
+   */
+  isValid: boolean;
+  /**
+   * 错误信息数组
+   */
+  errors: string[];
+  /**
+   * 值变更处理函数
+   */
+  handleChange: (value: number | null) => void;
+  /**
+   * 失焦处理函数
+   */
+  handleBlur: () => void;
+  /**
+   * 聚焦处理函数
+   */
+  handleFocus: () => void;
+}
+/**
+ * 基础数值输入 Props（供校验和状态管理使用）
+ */
+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;
+}
+//#endregion
+export { BaseNumberInputProps, NumberInputState };

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

@@ -0,0 +1,56 @@
+//#region src/number-input/utils/formatter.d.ts
+/**
+ * 数值格式化工具函数
+ */
+/**
+ * 格式化选项
+ */
+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"
+ */
+declare function formatNumber(value: number | null | undefined, options?: NumberFormatOptions): string | null;
+/**
+ * 添加千分位分隔符
+ *
+ * @param value 数值
+ * @returns 添加千分位后的字符串
+ *
+ * @example
+ * addThousandsSeparator(1234567)
+ * // 返回: "1,234,567"
+ */
+declare function addThousandsSeparator(value: number): string;
+/**
+ * 格式化精度
+ *
+ * @param value 数值
+ * @param precision 小数位数
+ * @returns 格式化后的数值
+ *
+ * @example
+ * formatPrecision(1.2345, 2)
+ * // 返回: 1.23
+ */
+declare function formatPrecision(value: number, precision: number): number;
+//#endregion
+export { NumberFormatOptions, addThousandsSeparator, formatNumber, formatPrecision };

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

@@ -0,0 +1,58 @@
+//#region src/number-input/utils/formatter.ts
+/**
+* 格式化数值
+* 
+* @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"
+*/
+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);
+}
+/**
+* 添加千分位分隔符
+* 
+* @param value 数值
+* @returns 添加千分位后的字符串
+* 
+* @example
+* addThousandsSeparator(1234567)
+* // 返回: "1,234,567"
+*/
+function addThousandsSeparator(value) {
+	return value.toLocaleString("zh-CN", { useGrouping: true });
+}
+/**
+* 格式化精度
+* 
+* @param value 数值
+* @param precision 小数位数
+* @returns 格式化后的数值
+* 
+* @example
+* formatPrecision(1.2345, 2)
+* // 返回: 1.23
+*/
+function formatPrecision(value, precision) {
+	return Number(value.toFixed(precision));
+}
+//#endregion
+exports.addThousandsSeparator = addThousandsSeparator;
+exports.formatNumber = formatNumber;
+exports.formatPrecision = formatPrecision;

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

@@ -0,0 +1,32 @@
+import { ValidationResult } from "../../common/types.js";
+import { BaseNumberInputProps } from "../types.js";
+
+//#region src/number-input/utils/validation.d.ts
+/**
+ * 校验数值输入
+ *
+ * 按照优先级执行校验规则：
+ * 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'] }
+ */
+declare function validateValue(value: number | null | undefined, props: BaseNumberInputProps): ValidationResult;
+//#endregion
+export { validateValue };

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

@@ -0,0 +1,52 @@
+//#region src/number-input/utils/validation.ts
+/**
+* 校验数值输入
+* 
+* 按照优先级执行校验规则：
+* 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'] }
+*/
+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
+	};
+}
+//#endregion
+exports.validateValue = validateValue;

package/lib/otherUtils.d.ts

@@ -0,0 +1,51 @@
+//#region src/otherUtils.d.ts
+/**
+ * @title: 判断是否无痕模式
+ * @description:
+ * @return: *
+ * @Author: shengjie.zuo
+ * @Date: 2024-09-4 09:58:22
+ */
+declare const detectIncognito: () => Promise<{
+  isPrivate: boolean;
+  browserName: string;
+} | {
+  isPrivate: boolean;
+}>;
+/**
+ * @Description: 生成唯一id
+ * @Author: wzw
+ * @Date: 2020-12-01 14:20:29
+ * @param {*}
+ * @return {*}
+ */
+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
+ */
+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
+ */
+declare const getItemByArray: <T>(list: T[] | undefined, item: T, key?: string) => boolean;
+declare const createArray: (length: number, returnItem: any) => unknown[];
+/**
+ * 根据对象内容生成唯一id
+ * @param obj
+ */
+declare const generateUniqueIdByObj: (obj: Record<string, any>) => any;
+//#endregion
+export { changeArray, createArray, detectIncognito, generateUniqueIdByObj, getItemByArray, getUniqueId };