@pisell/utils 3.0.5 → 3.0.7

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

@@ -0,0 +1,127 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useState, useCallback } from 'react';
+import { validateValue } from "../utils/validation";
+/**
+ * 文本输入状态管理 Hook
+ * 
+ * 管理组件的内部状态，包括：
+ * - 值管理（受控/非受控模式）
+ * - 校验状态管理
+ * - 事件处理函数封装
+ * 
+ * 支持受控和非受控两种模式：
+ * - 受控模式：value 由外部传入，组件不维护内部状态
+ * - 非受控模式：使用 defaultValue，组件维护内部状态
+ * 
+ * @param props 组件 Props（包含校验配置）
+ * @returns 文本输入状态对象
+ * 
+ * @example
+ * // 受控模式
+ * const state = useTextInputState({ value: 'hello', onChange: (v) => console.log(v) });
+ * 
+ * // 非受控模式
+ * const state = useTextInputState({ defaultValue: 'hello' });
+ */
+export function useTextInputState(props) {
+  // 判断是否为受控组件
+  var isControlled = props.value !== undefined;
+
+  // 内部状态（仅非受控模式使用）
+  var _useState = useState(props.defaultValue || ''),
+    _useState2 = _slicedToArray(_useState, 2),
+    innerValue = _useState2[0],
+    setInnerValue = _useState2[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    isTouched = _useState4[0],
+    setIsTouched = _useState4[1];
+  var _useState5 = useState(true),
+    _useState6 = _slicedToArray(_useState5, 2),
+    isValid = _useState6[0],
+    setIsValid = _useState6[1];
+  var _useState7 = useState([]),
+    _useState8 = _slicedToArray(_useState7, 2),
+    errors = _useState8[0],
+    setErrors = _useState8[1];
+
+  // 当前值（受控模式优先使用 props.value）
+  var currentValue = isControlled ? props.value : innerValue;
+
+  /**
+   * 值变更处理函数
+   * 
+   * 1. 更新内部状态（非受控模式）
+   * 2. 根据 validateTrigger 决定是否立即校验
+   * 3. 触发外部 onChange 回调
+   */
+  var handleChange = useCallback(function (newValue) {
+    var _props$onChange;
+    // 更新内部状态（非受控模式）
+    if (!isControlled) {
+      setInnerValue(newValue);
+    }
+
+    // 根据配置决定是否立即校验
+    var shouldValidate = props.validateTrigger === 'onChange' || props.validateTrigger === 'both';
+    if (shouldValidate) {
+      var _props$onValidate;
+      var 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]);
+
+  /**
+   * 失焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 执行失焦时的校验（根据 validateTrigger）
+   * 3. 触发外部 onBlur 回调
+   */
+  var handleBlur = useCallback(function () {
+    var _props$onBlur;
+    setIsTouched(true);
+
+    // 失焦时执行校验（如果 validateTrigger 不是 'onChange'）
+    var shouldValidate = props.validateTrigger !== 'onChange';
+    if (shouldValidate) {
+      var _props$onValidate2;
+      var 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]);
+
+  /**
+   * 聚焦处理函数
+   * 
+   * 1. 标记为已触摸
+   * 2. 触发外部 onFocus 回调
+   */
+  var handleFocus = useCallback(function () {
+    var _props$onFocus;
+    setIsTouched(true);
+    (_props$onFocus = props.onFocus) === null || _props$onFocus === void 0 || _props$onFocus.call(props);
+  }, [props]);
+  return {
+    value: currentValue,
+    isTouched: isTouched,
+    isValid: isValid,
+    errors: errors,
+    handleChange: handleChange,
+    handleBlur: handleBlur,
+    handleFocus: handleFocus
+  };
+}

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

@@ -0,0 +1,14 @@
+/**
+ * 文本输入组件公共逻辑导出
+ *
+ * 供以下组件使用：
+ * - PisellSingleLineText
+ * - PisellLongText
+ * - PisellPhone
+ * - PisellEmail
+ * - PisellUrl
+ */
+export type { DisplayState, ValidationResult, TextInputState, BaseTextInputProps, } from './types';
+export { useTextInputState } from './hooks';
+export { getDisplayState } from './utils';
+export { validateValue as validateTextValue } from './utils';

package/es/text-input/index.js

@@ -0,0 +1,20 @@
+/**
+ * 文本输入组件公共逻辑导出
+ * 
+ * 供以下组件使用：
+ * - PisellSingleLineText
+ * - PisellLongText
+ * - PisellPhone
+ * - PisellEmail
+ * - PisellUrl
+ */
+
+// 类型
+
+// Hooks
+export { useTextInputState } from "./hooks";
+
+// 工具函数
+export { getDisplayState } from "./utils";
+// 使用别名导出避免与 number-input 的 validateValue 重名
+export { validateValue as validateTextValue } from "./utils";

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

@@ -0,0 +1,56 @@
+/**
+ * 文本输入组件公共类型定义
+ * 供 PisellSingleLineText、PisellLongText、PisellPhone、PisellEmail、PisellUrl 等组件使用
+ */
+export type { DisplayState, ValidationResult } from '../common';
+/**
+ * 文本输入状态 Hook 返回值
+ */
+export interface TextInputState {
+    /**
+     * 当前值
+     */
+    value: string | undefined;
+    /**
+     * 是否已被触摸（交互过）
+     */
+    isTouched: boolean;
+    /**
+     * 是否校验通过
+     */
+    isValid: boolean;
+    /**
+     * 错误信息数组
+     */
+    errors: string[];
+    /**
+     * 值变更处理函数
+     */
+    handleChange: (value: string) => void;
+    /**
+     * 失焦处理函数
+     */
+    handleBlur: () => void;
+    /**
+     * 聚焦处理函数
+     */
+    handleFocus: () => void;
+}
+/**
+ * 基础文本输入 Props（供校验和状态管理使用）
+ */
+export 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;
+}

package/es/text-input/types.js

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,5 @@
+/**
+ * 文本输入工具函数导出
+ */
+export { getDisplayState } from '../../common';
+export { validateValue } from './validation';

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

@@ -0,0 +1,7 @@
+/**
+ * 文本输入工具函数导出
+ */
+
+// getDisplayState 已移到公共模块，从 common 重新导出
+export { getDisplayState } from "../../common";
+export { validateValue } from "./validation";

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

@@ -0,0 +1,23 @@
+import type { BaseTextInputProps, ValidationResult } from '../types';
+/**
+ * 校验文本输入值
+ *
+ * 按照优先级执行校验规则：
+ * 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: ['此字段为必填项'] }
+ */
+export declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;

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

@@ -0,0 +1,71 @@
+/**
+ * 校验文本输入值
+ * 
+ * 按照优先级执行校验规则：
+ * 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: ['此字段为必填项'] }
+ */
+export function validateValue(value, props) {
+  var errors = [];
+
+  // 1. 必填校验
+  if (props.required && !(value !== null && value !== void 0 && value.trim())) {
+    errors.push(props.errorMessage || '此字段为必填项');
+    return {
+      isValid: false,
+      errors: errors
+    };
+  }
+
+  // 如果值为空且非必填，直接返回有效
+  if (!value) {
+    return {
+      isValid: true,
+      errors: errors
+    };
+  }
+
+  // 2. 最小长度校验
+  if (props.minLength !== undefined && value.length < props.minLength) {
+    errors.push("\u6700\u5C11\u9700\u8981 ".concat(props.minLength, " \u4E2A\u5B57\u7B26"));
+  }
+
+  // 3. 最大长度校验（通常在输入时已被 Input 组件限制，这里是兜底校验）
+  if (props.maxLength !== undefined && value.length > props.maxLength) {
+    errors.push("\u6700\u591A\u5141\u8BB8 ".concat(props.maxLength, " \u4E2A\u5B57\u7B26"));
+  }
+
+  // 4. 正则校验
+  if (props.pattern) {
+    var regex = typeof props.pattern === 'string' ? new RegExp(props.pattern) : props.pattern;
+    if (!regex.test(value)) {
+      errors.push(props.errorMessage || '格式不正确');
+    }
+  }
+
+  // 5. 自定义校验函数
+  if (props.validator) {
+    var result = props.validator(value);
+    if (result !== true) {
+      errors.push(typeof result === 'string' ? result : '校验失败');
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors: errors
+  };
+}

package/es/walletValidity.d.ts

@@ -0,0 +1,55 @@
+export declare 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;
+    }>;
+}
+export interface WalletPassValidity {
+    start_date?: string | null;
+    expire_date?: string | null;
+    expire_time?: string | null;
+}
+/** 仅计算展示日期的交集，不修改日程的重复起点或每日使用时段。 */
+export 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 摘要文本
+ */
+export declare function getScheduleSummary(scheduleList: ScheduleItem[], locale?: Locale, validity?: WalletPassValidity): string;
+export {};