@pisell/utils 3.0.5 → 3.0.7

package/lib/text-input/hooks/index.js

@@ -0,0 +1,29 @@
+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/text-input/hooks/index.ts
+var hooks_exports = {};
+__export(hooks_exports, {
+  useTextInputState: () => import_useTextInputState.useTextInputState
+});
+module.exports = __toCommonJS(hooks_exports);
+var import_useTextInputState = require("./useTextInputState");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTextInputState
+});

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

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

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

@@ -0,0 +1,81 @@
+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/text-input/hooks/useTextInputState.ts
+var useTextInputState_exports = {};
+__export(useTextInputState_exports, {
+  useTextInputState: () => useTextInputState
+});
+module.exports = __toCommonJS(useTextInputState_exports);
+var import_react = require("react");
+var import_validation = require("../utils/validation");
+function useTextInputState(props) {
+  const isControlled = props.value !== void 0;
+  const [innerValue, setInnerValue] = (0, import_react.useState)(props.defaultValue || "");
+  const [isTouched, setIsTouched] = (0, import_react.useState)(false);
+  const [isValid, setIsValid] = (0, import_react.useState)(true);
+  const [errors, setErrors] = (0, import_react.useState)([]);
+  const currentValue = isControlled ? props.value : innerValue;
+  const handleChange = (0, import_react.useCallback)(
+    (newValue) => {
+      var _a, _b;
+      if (!isControlled) {
+        setInnerValue(newValue);
+      }
+      const shouldValidate = props.validateTrigger === "onChange" || props.validateTrigger === "both";
+      if (shouldValidate) {
+        const validation = (0, import_validation.validateValue)(newValue, props);
+        setIsValid(validation.isValid);
+        setErrors(validation.errors);
+        (_a = props.onValidate) == null ? void 0 : _a.call(props, validation.isValid, validation.errors);
+      }
+      (_b = props.onChange) == null ? void 0 : _b.call(props, newValue);
+    },
+    [isControlled, props]
+  );
+  const handleBlur = (0, import_react.useCallback)(() => {
+    var _a, _b;
+    setIsTouched(true);
+    const shouldValidate = props.validateTrigger !== "onChange";
+    if (shouldValidate) {
+      const validation = (0, import_validation.validateValue)(currentValue || "", props);
+      setIsValid(validation.isValid);
+      setErrors(validation.errors);
+      (_a = props.onValidate) == null ? void 0 : _a.call(props, validation.isValid, validation.errors);
+    }
+    (_b = props.onBlur) == null ? void 0 : _b.call(props, currentValue || "");
+  }, [currentValue, props]);
+  const handleFocus = (0, import_react.useCallback)(() => {
+    var _a;
+    setIsTouched(true);
+    (_a = props.onFocus) == null ? void 0 : _a.call(props);
+  }, [props]);
+  return {
+    value: currentValue,
+    isTouched,
+    isValid,
+    errors,
+    handleChange,
+    handleBlur,
+    handleFocus
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTextInputState
+});

package/lib/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/lib/text-input/index.js

@@ -0,0 +1,35 @@
+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/text-input/index.ts
+var text_input_exports = {};
+__export(text_input_exports, {
+  getDisplayState: () => import_utils.getDisplayState,
+  useTextInputState: () => import_hooks.useTextInputState,
+  validateTextValue: () => import_utils2.validateValue
+});
+module.exports = __toCommonJS(text_input_exports);
+var import_hooks = require("./hooks");
+var import_utils = require("./utils");
+var import_utils2 = require("./utils");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDisplayState,
+  useTextInputState,
+  validateTextValue
+});

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

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

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

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

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

package/lib/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/lib/text-input/utils/validation.js

@@ -0,0 +1,60 @@
+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/text-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 ? 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) {
+    const regex = typeof props.pattern === "string" ? new RegExp(props.pattern) : props.pattern;
+    if (!regex.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
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  validateValue
+});

package/lib/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 {};