@pisell/utils 3.0.5 → 3.0.6

package/es/select/utils/helpers.js

@@ -0,0 +1,51 @@
+//#region src/select/utils/helpers.ts
+/**
+* 根据值查找选项对象
+* @template T 选项值的类型
+* @param value 选项值
+* @param options 选项列表
+* @returns 找到的选项对象，如果没找到返回 undefined
+*/
+function findOptionByValue(value, options) {
+	return options.find((opt) => opt.value === value);
+}
+/**
+* 根据值数组查找选项对象数组
+* @template T 选项值的类型
+* @param values 选项值数组
+* @param options 选项列表
+* @returns 找到的选项对象数组
+*/
+function findOptionsByValues(values, options) {
+	return values.map((val) => findOptionByValue(val, options)).filter(Boolean);
+}
+/**
+* 判断选项是否被选中（单选）
+* @template T 选项值的类型
+* @param optionValue 选项值
+* @param selectedValue 当前选中值
+* @returns 是否选中
+*/
+function isOptionSelected(optionValue, selectedValue) {
+	return selectedValue !== null && selectedValue !== void 0 && optionValue === selectedValue;
+}
+/**
+* 判断选项是否被选中（多选）
+* @template T 选项值的类型
+* @param optionValue 选项值
+* @param selectedValues 当前选中值数组
+* @returns 是否选中
+*/
+function isOptionSelectedInMultiple(optionValue, selectedValues) {
+	return selectedValues.includes(optionValue);
+}
+/**
+* 生成唯一 ID
+* @param prefix ID 前缀
+* @returns 唯一 ID
+*/
+function generateId(prefix = "select") {
+	return `${prefix}-${Math.random().toString(36).substr(2, 9)}`;
+}
+//#endregion
+export { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple };

package/es/select/utils/index.d.ts

@@ -0,0 +1,4 @@
+import { calculateTagDisplay } from "./tagAggregation.js";
+import { defaultFilterOption, filterOptions } from "./filterOptions.js";
+import { sortOptions } from "./sortOptions.js";
+import { findOptionByValue, findOptionsByValues, generateId, isOptionSelected, isOptionSelectedInMultiple } from "./helpers.js";

package/es/select/utils/sortOptions.d.ts

@@ -0,0 +1,13 @@
+import { SelectOption, SortDirection } from "../types.js";
+
+//#region src/select/utils/sortOptions.d.ts
+/**
+ * 排序选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+ * @returns 排序后的选项列表（新数组）
+ */
+declare function sortOptions<T = string | number>(options: SelectOption<T>[], direction?: SortDirection): SelectOption<T>[];
+//#endregion
+export { sortOptions };

package/es/select/utils/sortOptions.js

@@ -0,0 +1,20 @@
+//#region src/select/utils/sortOptions.ts
+/**
+* 排序选项列表
+* @template T 选项值的类型
+* @param options 原始选项列表
+* @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+* @returns 排序后的选项列表（新数组）
+*/
+function sortOptions(options, direction = "asc") {
+	const sortedOptions = [...options];
+	sortedOptions.sort((a, b) => {
+		const labelA = a.label.toLowerCase();
+		const labelB = b.label.toLowerCase();
+		if (direction === "asc") return labelA.localeCompare(labelB);
+		else return labelB.localeCompare(labelA);
+	});
+	return sortedOptions;
+}
+//#endregion
+export { sortOptions };

package/es/select/utils/tagAggregation.d.ts

@@ -0,0 +1,25 @@
+import { SelectOption, TagDisplayInfo } from "../types.js";
+
+//#region src/select/utils/tagAggregation.d.ts
+/**
+ * 计算需要显示的标签和聚合信息
+ * @template T 选项值的类型
+ * @param selectedValues 当前选中的值数组
+ * @param options 所有选项列表
+ * @param maxTagCount 最多显示的标签数量
+ * @returns 标签显示信息
+ *
+ * @example
+ * ```tsx
+ * const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
+ * // 返回：
+ * // {
+ * //   visibleTags: [option_a, option_b],
+ * //   hiddenTags: [option_c, option_d],
+ * //   hiddenCount: 2
+ * // }
+ * ```
+ */
+declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
+//#endregion
+export { calculateTagDisplay };

package/es/select/utils/tagAggregation.js

@@ -0,0 +1,35 @@
+//#region src/select/utils/tagAggregation.ts
+/**
+* 计算需要显示的标签和聚合信息
+* @template T 选项值的类型
+* @param selectedValues 当前选中的值数组
+* @param options 所有选项列表
+* @param maxTagCount 最多显示的标签数量
+* @returns 标签显示信息
+* 
+* @example
+* ```tsx
+* const tagInfo = calculateTagDisplay(['a', 'b', 'c', 'd'], options, 2);
+* // 返回：
+* // {
+* //   visibleTags: [option_a, option_b],
+* //   hiddenTags: [option_c, option_d],
+* //   hiddenCount: 2
+* // }
+* ```
+*/
+function calculateTagDisplay(selectedValues, options, maxTagCount) {
+	const selectedOptions = selectedValues.map((v) => options.find((opt) => opt.value === v)).filter(Boolean);
+	if (selectedOptions.length <= maxTagCount) return {
+		visibleTags: selectedOptions,
+		hiddenTags: [],
+		hiddenCount: 0
+	};
+	return {
+		visibleTags: selectedOptions.slice(0, maxTagCount),
+		hiddenTags: selectedOptions.slice(maxTagCount),
+		hiddenCount: selectedOptions.length - maxTagCount
+	};
+}
+//#endregion
+export { calculateTagDisplay };

package/es/text-input/hooks/useTextInputState.d.ts

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

package/es/text-input/hooks/useTextInputState.js

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

package/es/text-input/types.d.ts

@@ -0,0 +1,56 @@
+import { DisplayState, ValidationResult } from "../common/types.js";
+
+//#region src/text-input/types.d.ts
+/**
+ * 文本输入状态 Hook 返回值
+ */
+interface TextInputState {
+  /**
+   * 当前值
+   */
+  value: string | undefined;
+  /**
+   * 是否已被触摸（交互过）
+   */
+  isTouched: boolean;
+  /**
+   * 是否校验通过
+   */
+  isValid: boolean;
+  /**
+   * 错误信息数组
+   */
+  errors: string[];
+  /**
+   * 值变更处理函数
+   */
+  handleChange: (value: string) => void;
+  /**
+   * 失焦处理函数
+   */
+  handleBlur: () => void;
+  /**
+   * 聚焦处理函数
+   */
+  handleFocus: () => void;
+}
+/**
+ * 基础文本输入 Props（供校验和状态管理使用）
+ */
+interface BaseTextInputProps {
+  value?: string;
+  defaultValue?: string;
+  required?: boolean;
+  minLength?: number;
+  maxLength?: number;
+  pattern?: string | RegExp;
+  validator?: (value: string) => boolean | string;
+  validateTrigger?: 'onChange' | 'onBlur' | 'both';
+  errorMessage?: string;
+  onChange?: (value: string) => void;
+  onBlur?: (value: string) => void;
+  onFocus?: () => void;
+  onValidate?: (isValid: boolean, errors: string[]) => void;
+}
+//#endregion
+export { BaseTextInputProps, TextInputState };

package/es/text-input/utils/validation.d.ts

@@ -0,0 +1,28 @@
+import { ValidationResult } from "../../common/types.js";
+import { BaseTextInputProps } from "../types.js";
+
+//#region src/text-input/utils/validation.d.ts
+/**
+ * 校验文本输入值
+ *
+ * 按照优先级执行校验规则：
+ * 1. 必填校验（required）
+ * 2. 最小长度校验（minLength）
+ * 3. 最大长度校验（maxLength）
+ * 4. 正则校验（pattern）
+ * 5. 自定义校验函数（validator）
+ *
+ * @param value 待校验的值
+ * @param props 校验配置
+ * @returns 校验结果对象，包含 isValid 和 errors
+ *
+ * @example
+ * validateValue('hello', { required: true, minLength: 3 })
+ * // { isValid: true, errors: [] }
+ *
+ * validateValue('', { required: true })
+ * // { isValid: false, errors: ['此字段为必填项'] }
+ */
+declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;
+//#endregion
+export { validateValue };

package/es/text-input/utils/validation.js

@@ -0,0 +1,51 @@
+//#region src/text-input/utils/validation.ts
+/**
+* 校验文本输入值
+* 
+* 按照优先级执行校验规则：
+* 1. 必填校验（required）
+* 2. 最小长度校验（minLength）
+* 3. 最大长度校验（maxLength）
+* 4. 正则校验（pattern）
+* 5. 自定义校验函数（validator）
+* 
+* @param value 待校验的值
+* @param props 校验配置
+* @returns 校验结果对象，包含 isValid 和 errors
+* 
+* @example
+* validateValue('hello', { required: true, minLength: 3 })
+* // { isValid: true, errors: [] }
+* 
+* validateValue('', { required: true })
+* // { isValid: false, errors: ['此字段为必填项'] }
+*/
+function validateValue(value, props) {
+	const errors = [];
+	if (props.required && !(value === null || value === void 0 ? void 0 : value.trim())) {
+		errors.push(props.errorMessage || "此字段为必填项");
+		return {
+			isValid: false,
+			errors
+		};
+	}
+	if (!value) return {
+		isValid: true,
+		errors
+	};
+	if (props.minLength !== void 0 && value.length < props.minLength) errors.push(`最少需要 ${props.minLength} 个字符`);
+	if (props.maxLength !== void 0 && value.length > props.maxLength) errors.push(`最多允许 ${props.maxLength} 个字符`);
+	if (props.pattern) {
+		if (!(typeof props.pattern === "string" ? new RegExp(props.pattern) : props.pattern).test(value)) errors.push(props.errorMessage || "格式不正确");
+	}
+	if (props.validator) {
+		const result = props.validator(value);
+		if (result !== true) errors.push(typeof result === "string" ? result : "校验失败");
+	}
+	return {
+		isValid: errors.length === 0,
+		errors
+	};
+}
+//#endregion
+export { validateValue };

package/es/typeUtils.d.ts

@@ -1,42 +1,45 @@
+//#region src/typeUtils.d.ts
 /**
  * 判断是否是函数
  * @param obj
  */
-export declare const isFunction: (obj: any) => obj is Function;
+declare const isFunction: (obj: any) => obj is Function;
 /**
  * 判断是否是数组
  * @param obj
  */
-export declare const isArr: (obj: any) => obj is any[];
+declare const isArr: (obj: any) => obj is any[];
 /**
  * 判断是否是字符串
  * @param obj
  */
-export declare const isString: (obj: any) => obj is string;
+declare const isString: (obj: any) => obj is string;
 /**
  * 判断是否是数字
  * @param obj
  */
-export declare const isNumber: (obj: any) => obj is number;
+declare const isNumber: (obj: any) => obj is number;
 /**
  * 判断是否是undefined
  * @param obj
  */
-export declare const isUndefined: (obj: any) => obj is undefined;
+declare const isUndefined: (obj: any) => obj is undefined;
 /**
  * 判断是否是boolean
  * @param obj
  */
-export declare const isBoolean: (obj: any) => obj is boolean;
+declare const isBoolean: (obj: any) => obj is boolean;
 /**
  * 判断是否是json字符串
  * @param v
  */
-export declare const isJson: (v: any) => boolean;
+declare const isJson: (v: any) => boolean;
 /**
  * @Title: 判断是否为对象
  * @Describe:
  * @Author: Wzw
  * @param {any} obj
  */
-export declare const isPlainObject: (obj: any) => boolean;
+declare const isPlainObject: (obj: any) => boolean;
+//#endregion
+export { isArr, isBoolean, isFunction, isJson, isNumber, isPlainObject, isString, isUndefined };

package/es/typeUtils.js

@@ -1,86 +1,63 @@
-/**
- * 判断是否是函数
- * @param obj
- */
-export var isFunction = function isFunction(obj) {
-  return typeof obj === 'function';
-};
-
-/**
- * 判断是否是数组
- * @param obj
- */
-export var isArr = function isArr(obj) {
-  return Array.isArray(obj);
+//#region src/typeUtils.ts
+/**
+* 判断是否是函数
+* @param obj
+*/
+const isFunction = (obj) => typeof obj === "function";
+/**
+* 判断是否是数组
+* @param obj
+*/
+const isArr = (obj) => Array.isArray(obj);
+/**
+* 判断是否是字符串
+* @param obj
+*/
+const isString = (obj) => typeof obj === "string";
+/**
+* 判断是否是数字
+* @param obj
+*/
+const isNumber = (obj) => typeof obj === "number";
+/**
+* 判断是否是undefined
+* @param obj
+*/
+const isUndefined = (obj) => typeof obj === "undefined";
+/**
+* 判断是否是boolean
+* @param obj
+*/
+const isBoolean = (obj) => typeof obj === "boolean";
+/**
+* 判断是否是json字符串
+* @param v
+*/
+const isJson = (v) => {
+	if (typeof v === "string") try {
+		return JSON.parse(v);
+	} catch (e) {
+		return false;
+	}
+	else return false;
 };
-
-/**
- * 判断是否是字符串
- * @param obj
- */
-export var isString = function isString(obj) {
-  return typeof obj === 'string';
+const getProto = Object.getPrototypeOf;
+const hasOwn = {}.hasOwnProperty;
+const fnToString = hasOwn.toString;
+const ObjectFunctionString = fnToString.call(Object);
+/**
+* @Title: 判断是否为对象
+* @Describe:
+* @Author: Wzw
+* @param {any} obj
+*/
+const isPlainObject = (obj) => {
+	var proto, Ctor;
+	if (!obj || toString.call(obj) !== "[object Object]") return false;
+	proto = getProto(obj);
+	if (!proto) return true;
+	Ctor = hasOwn.call(proto, "constructor") && proto.constructor;
+	return typeof Ctor === "function" && fnToString.call(Ctor) === ObjectFunctionString;
 };
-
-/**
- * 判断是否是数字
- * @param obj
- */
-export var isNumber = function isNumber(obj) {
-  return typeof obj === 'number';
-};
-
-/**
- * 判断是否是undefined
- * @param obj
- */
-export var isUndefined = function isUndefined(obj) {
-  return typeof obj === 'undefined';
-};
-
-/**
- * 判断是否是boolean
- * @param obj
- */
-export var isBoolean = function isBoolean(obj) {
-  return typeof obj === 'boolean';
-};
-
-/**
- * 判断是否是json字符串
- * @param v
- */
-export var isJson = function isJson(v) {
-  if (typeof v === 'string') {
-    try {
-      return JSON.parse(v);
-    } catch (e) {
-      return false;
-    }
-  } else {
-    return false;
-  }
-};
-var getProto = Object.getPrototypeOf;
-var hasOwn = {}.hasOwnProperty;
-var fnToString = hasOwn.toString;
-var ObjectFunctionString = fnToString.call(Object);
-
-/**
- * @Title: 判断是否为对象
- * @Describe:
- * @Author: Wzw
- * @param {any} obj
- */
-export var isPlainObject = function isPlainObject(obj) {
-  var proto, Ctor;
-  if (!obj || toString.call(obj) !== '[object Object]') {
-    return false;
-  }
-  proto = getProto(obj);
-  if (!proto) {
-    return true;
-  }
-  Ctor = hasOwn.call(proto, 'constructor') && proto.constructor;
-  return typeof Ctor === 'function' && fnToString.call(Ctor) === ObjectFunctionString;
-};
+//#endregion
+export { isArr, isBoolean, isFunction, isJson, isNumber, isPlainObject, isString, isUndefined };

package/es/walletValidity.d.ts

@@ -0,0 +1,57 @@
+//#region src/walletValidity.d.ts
+type Locale = 'en' | 'zh-CN' | 'zh-HK';
+interface ScheduleItem {
+  id: number;
+  name: string | {
+    [key: string]: string;
+  };
+  type: 'standard' | 'time-slots' | 'designation';
+  start_time: string | null;
+  end_time: string | null;
+  repeat_type: 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly';
+  repeat_rule: {
+    end: {
+      type: 'never' | 'date' | 'occurrence';
+      end_date: string | null;
+      occurrence: number | null;
+    };
+    frequency: number;
+    excluded_date: Array<{
+      start: string;
+      end: string;
+    }>;
+    included_date: any[];
+    frequency_date: number[];
+  } | null;
+  designation: Array<{
+    start_date: string;
+    start_time: string;
+    end_date: string;
+    end_time: string;
+  }> | null;
+  is_all: number;
+  time_slot: Array<{
+    start_time: string;
+    end_time: string;
+  }>;
+}
+interface WalletPassValidity {
+  start_date?: string | null;
+  expire_date?: string | null;
+  expire_time?: string | null;
+}
+/** 仅计算展示日期的交集，不修改日程的重复起点或每日使用时段。 */
+declare function getWalletValidityRange(start?: string | null, end?: string | null, validity?: WalletPassValidity): {
+  startDate: string | null;
+  endDate: string | null;
+  isEmpty: boolean;
+};
+/**
+ * 获取schedule摘要信息
+ * @param scheduleList 日程列表
+ * @param locale 语言设置
+ * @returns 摘要文本
+ */
+declare function getScheduleSummary(scheduleList: ScheduleItem[], locale?: Locale, validity?: WalletPassValidity): string;
+//#endregion
+export { Locale, WalletPassValidity, getScheduleSummary, getWalletValidityRange };