@pisell/utils 1.0.55 → 1.0.57

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

@@ -0,0 +1,42 @@
+/**
+ * Select 组件辅助函数
+ */
+import type { SelectOption } from '../types';
+/**
+ * 根据值查找选项对象
+ * @template T 选项值的类型
+ * @param value 选项值
+ * @param options 选项列表
+ * @returns 找到的选项对象，如果没找到返回 undefined
+ */
+export declare function findOptionByValue<T = string | number>(value: T, options: SelectOption<T>[]): SelectOption<T> | undefined;
+/**
+ * 根据值数组查找选项对象数组
+ * @template T 选项值的类型
+ * @param values 选项值数组
+ * @param options 选项列表
+ * @returns 找到的选项对象数组
+ */
+export declare function findOptionsByValues<T = string | number>(values: T[], options: SelectOption<T>[]): SelectOption<T>[];
+/**
+ * 判断选项是否被选中（单选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValue 当前选中值
+ * @returns 是否选中
+ */
+export declare function isOptionSelected<T = string | number>(optionValue: T, selectedValue: T | null | undefined): boolean;
+/**
+ * 判断选项是否被选中（多选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValues 当前选中值数组
+ * @returns 是否选中
+ */
+export declare function isOptionSelectedInMultiple<T = string | number>(optionValue: T, selectedValues: T[]): boolean;
+/**
+ * 生成唯一 ID
+ * @param prefix ID 前缀
+ * @returns 唯一 ID
+ */
+export declare function generateId(prefix?: string): string;

package/es/select/utils/helpers.js

@@ -0,0 +1,61 @@
+/**
+ * Select 组件辅助函数
+ */
+
+/**
+ * 根据值查找选项对象
+ * @template T 选项值的类型
+ * @param value 选项值
+ * @param options 选项列表
+ * @returns 找到的选项对象，如果没找到返回 undefined
+ */
+export function findOptionByValue(value, options) {
+  return options.find(function (opt) {
+    return opt.value === value;
+  });
+}
+
+/**
+ * 根据值数组查找选项对象数组
+ * @template T 选项值的类型
+ * @param values 选项值数组
+ * @param options 选项列表
+ * @returns 找到的选项对象数组
+ */
+export function findOptionsByValues(values, options) {
+  return values.map(function (val) {
+    return findOptionByValue(val, options);
+  }).filter(Boolean);
+}
+
+/**
+ * 判断选项是否被选中（单选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValue 当前选中值
+ * @returns 是否选中
+ */
+export function isOptionSelected(optionValue, selectedValue) {
+  return selectedValue !== null && selectedValue !== undefined && optionValue === selectedValue;
+}
+
+/**
+ * 判断选项是否被选中（多选）
+ * @template T 选项值的类型
+ * @param optionValue 选项值
+ * @param selectedValues 当前选中值数组
+ * @returns 是否选中
+ */
+export function isOptionSelectedInMultiple(optionValue, selectedValues) {
+  return selectedValues.includes(optionValue);
+}
+
+/**
+ * 生成唯一 ID
+ * @param prefix ID 前缀
+ * @returns 唯一 ID
+ */
+export function generateId() {
+  var prefix = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'select';
+  return "".concat(prefix, "-").concat(Math.random().toString(36).substr(2, 9));
+}

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

@@ -0,0 +1,7 @@
+/**
+ * Select 工具函数导出
+ */
+export { calculateTagDisplay } from './tagAggregation';
+export { filterOptions, defaultFilterOption } from './filterOptions';
+export { sortOptions } from './sortOptions';
+export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId, } from './helpers';

package/es/select/utils/index.js

@@ -0,0 +1,8 @@
+/**
+ * Select 工具函数导出
+ */
+
+export { calculateTagDisplay } from "./tagAggregation";
+export { filterOptions, defaultFilterOption } from "./filterOptions";
+export { sortOptions } from "./sortOptions";
+export { findOptionByValue, findOptionsByValues, isOptionSelected, isOptionSelectedInMultiple, generateId } from "./helpers";

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

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

package/es/select/utils/sortOptions.js

@@ -0,0 +1,32 @@
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread 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 _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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; }
+/**
+ * 选项排序工具函数
+ */
+
+/**
+ * 排序选项列表
+ * @template T 选项值的类型
+ * @param options 原始选项列表
+ * @param direction 排序方向（'asc' 升序 | 'desc' 降序）
+ * @returns 排序后的选项列表（新数组）
+ */
+export function sortOptions(options) {
+  var direction = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'asc';
+  // 创建副本避免修改原数组
+  var sortedOptions = _toConsumableArray(options);
+  sortedOptions.sort(function (a, b) {
+    var labelA = a.label.toLowerCase();
+    var labelB = b.label.toLowerCase();
+    if (direction === 'asc') {
+      return labelA.localeCompare(labelB);
+    } else {
+      return labelB.localeCompare(labelA);
+    }
+  });
+  return sortedOptions;
+}

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

@@ -0,0 +1,25 @@
+/**
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
+ */
+import type { SelectOption, TagDisplayInfo } from '../types';
+/**
+ * 计算需要显示的标签和聚合信息
+ * @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
+ * // }
+ * ```
+ */
+export declare function calculateTagDisplay<T = string | number>(selectedValues: T[], options: SelectOption<T>[], maxTagCount: number): TagDisplayInfo<T>;

package/es/select/utils/tagAggregation.js

@@ -0,0 +1,48 @@
+/**
+ * 标签聚合工具函数
+ * 用于多选下拉组件的标签显示逻辑
+ */
+
+/**
+ * 计算需要显示的标签和聚合信息
+ * @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
+ * // }
+ * ```
+ */
+export function calculateTagDisplay(selectedValues, options, maxTagCount) {
+  // 根据选中值找到对应的选项对象
+  var selectedOptions = selectedValues.map(function (v) {
+    return options.find(function (opt) {
+      return opt.value === v;
+    });
+  }).filter(Boolean);
+
+  // 如果选中数量不超过 maxTagCount，全部显示
+  if (selectedOptions.length <= maxTagCount) {
+    return {
+      visibleTags: selectedOptions,
+      hiddenTags: [],
+      hiddenCount: 0
+    };
+  }
+
+  // 否则进行聚合
+  return {
+    visibleTags: selectedOptions.slice(0, maxTagCount),
+    hiddenTags: selectedOptions.slice(maxTagCount),
+    hiddenCount: selectedOptions.length - maxTagCount
+  };
+}

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

@@ -0,0 +1,4 @@
+/**
+ * 文本输入 Hooks 导出
+ */
+export { useTextInputState } from './useTextInputState';

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

@@ -0,0 +1,5 @@
+/**
+ * 文本输入 Hooks 导出
+ */
+
+export { useTextInputState } from "./useTextInputState";

package/es/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/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/lib/common/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 公共工具和类型导出
+ */
+export type { DisplayState, ValidationResult } from './types';
+export { getDisplayState } from './stateHelper';

package/lib/common/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/common/index.ts
+var common_exports = {};
+__export(common_exports, {
+  getDisplayState: () => import_stateHelper.getDisplayState
+});
+module.exports = __toCommonJS(common_exports);
+var import_stateHelper = require("./stateHelper");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getDisplayState
+});

package/lib/common/stateHelper.d.ts

@@ -0,0 +1,18 @@
+import type { DisplayState } from './types';
+/**
+ * 根据 mode 和 disabled 计算组件的显示状态
+ *
+ * 状态优先级：disabled > mode
+ * 当 disabled=true 时，无论 mode 是什么，都显示为禁用态
+ *
+ * @param mode 状态模式（'read' | 'edit'）
+ * @param disabled 是否禁用
+ * @returns 显示状态（'read' | 'edit' | 'disabled'）
+ *
+ * @example
+ * getDisplayState('edit', false) // 'edit'
+ * getDisplayState('read', false) // 'read'
+ * getDisplayState('edit', true)  // 'disabled'
+ * getDisplayState('read', true)  // 'disabled'
+ */
+export declare function getDisplayState(mode?: 'read' | 'edit', disabled?: boolean): DisplayState;