@pisell/utils 1.0.71 → 1.0.73

package/lib/select/utils/helpers.js

@@ -1,51 +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/select/utils/helpers.ts
-var helpers_exports = {};
-__export(helpers_exports, {
-  findOptionByValue: () => findOptionByValue,
-  findOptionsByValues: () => findOptionsByValues,
-  generateId: () => generateId,
-  isOptionSelected: () => isOptionSelected,
-  isOptionSelectedInMultiple: () => isOptionSelectedInMultiple
-});
-module.exports = __toCommonJS(helpers_exports);
+//#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);
+	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);
+	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;
+	return selectedValue !== null && selectedValue !== void 0 && optionValue === selectedValue;
 }
+/**
+* 判断选项是否被选中（多选）
+* @template T 选项值的类型
+* @param optionValue 选项值
+* @param selectedValues 当前选中值数组
+* @returns 是否选中
+*/
 function isOptionSelectedInMultiple(optionValue, selectedValues) {
-  return selectedValues.includes(optionValue);
+	return selectedValues.includes(optionValue);
 }
+/**
+* 生成唯一 ID
+* @param prefix ID 前缀
+* @returns 唯一 ID
+*/
 function generateId(prefix = "select") {
-  return `${prefix}-${Math.random().toString(36).substr(2, 9)}`;
+	return `${prefix}-${Math.random().toString(36).substr(2, 9)}`;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  findOptionByValue,
-  findOptionsByValues,
-  generateId,
-  isOptionSelected,
-  isOptionSelectedInMultiple
-});
+//#endregion
+exports.findOptionByValue = findOptionByValue;
+exports.findOptionsByValues = findOptionsByValues;
+exports.generateId = generateId;
+exports.isOptionSelected = isOptionSelected;
+exports.isOptionSelectedInMultiple = isOptionSelectedInMultiple;

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

@@ -1,7 +1,4 @@
-/**
- * Select 工具函数导出
- */
-export { calculateTagDisplay } from './tagAggregation';
-export { filterOptions, defaultFilterOption } from './filterOptions';
-export { sortOptions } from './sortOptions';
-export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './helpers';
+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/lib/select/utils/sortOptions.d.ts

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

package/lib/select/utils/sortOptions.js

@@ -1,41 +1,20 @@
-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/utils/sortOptions.ts
-var sortOptions_exports = {};
-__export(sortOptions_exports, {
-  sortOptions: () => sortOptions
-});
-module.exports = __toCommonJS(sortOptions_exports);
+//#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;
+	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;
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  sortOptions
-});
+//#endregion
+exports.sortOptions = sortOptions;

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

@@ -1,8 +1,6 @@
-/**
- * 标签聚合工具函数
- * 用于多选下拉组件的标签显示逻辑
- */
-import type { SelectOption, TagDisplayInfo } from '../types';
+import { SelectOption, TagDisplayInfo } from "../types.js";
+
+//#region src/select/utils/tagAggregation.d.ts
 /**
  * 计算需要显示的标签和聚合信息
  * @template T 选项值的类型
@@ -22,4 +20,6 @@ import type { SelectOption, TagDisplayInfo } from '../types';
  * // }
  * ```
  */
-export declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
+declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;
+//#endregion
+export { calculateTagDisplay };

package/lib/select/utils/tagAggregation.js

@@ -1,43 +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/select/utils/tagAggregation.ts
-var tagAggregation_exports = {};
-__export(tagAggregation_exports, {
-  calculateTagDisplay: () => calculateTagDisplay
-});
-module.exports = __toCommonJS(tagAggregation_exports);
+//#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
-  };
+	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
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  calculateTagDisplay
-});
+//#endregion
+exports.calculateTagDisplay = calculateTagDisplay;

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

@@ -1,4 +1,6 @@
-import type { BaseTextInputProps, TextInputState } from '../types';
+import { BaseTextInputProps, TextInputState } from "../types.js";
+
+//#region src/text-input/hooks/useTextInputState.d.ts
 /**
  * 文本输入状态管理 Hook
  *
@@ -21,4 +23,6 @@ import type { BaseTextInputProps, TextInputState } from '../types';
  * // 非受控模式
  * const state = useTextInputState({ defaultValue: 'hello' });
  */
-export declare function useTextInputState(props: BaseTextInputProps): TextInputState;
+declare function useTextInputState(props: BaseTextInputProps): TextInputState;
+//#endregion
+export { useTextInputState };

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

@@ -1,81 +1,71 @@
-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");
+require("../../_virtual/_rolldown/runtime.js");
+const require_validation = require("../utils/validation.js");
+let react = require("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] = (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
-  };
+	const isControlled = props.value !== void 0;
+	const [innerValue, setInnerValue] = (0, react.useState)(props.defaultValue || "");
+	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 || "");
+		}, [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])
+	};
 }
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  useTextInputState
-});
+//#endregion
+exports.useTextInputState = useTextInputState;

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

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

@@ -1,4 +1,7 @@
-import type { BaseTextInputProps, ValidationResult } from '../types';
+import { ValidationResult } from "../../common/types.js";
+import { BaseTextInputProps } from "../types.js";
+
+//#region src/text-input/utils/validation.d.ts
 /**
  * 校验文本输入值
  *
@@ -20,4 +23,6 @@ import type { BaseTextInputProps, ValidationResult } from '../types';
  * validateValue('', { required: true })
  * // { isValid: false, errors: ['此字段为必填项'] }
  */
-export declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;
+declare function validateValue(value: string, props: BaseTextInputProps): ValidationResult;
+//#endregion
+export { validateValue };