@pisell/materials 3.3.82 → 3.3.83

package/es/components/pisellPhone/utils/phoneValidator.d.ts

@@ -0,0 +1,11 @@
+import type { CountryCode, PisellPhoneProps } from '../types';
+import type { ValidationResult } from '@pisell/utils';
+/**
+ * 电话号码校验
+ * @param phone 电话号码（纯数字）
+ * @param countryCode 国家码
+ * @param countryConfig 国家码配置
+ * @param props 组件 Props
+ * @returns 校验结果
+ */
+export declare function validatePhone(phone: string, countryCode: string, countryConfig: CountryCode | undefined, props: PisellPhoneProps): ValidationResult;

package/es/components/pisellPhone/utils/phoneValidator.js

@@ -0,0 +1,59 @@
+/**
+ * 电话号码校验
+ * @param phone 电话号码（纯数字）
+ * @param countryCode 国家码
+ * @param countryConfig 国家码配置
+ * @param props 组件 Props
+ * @returns 校验结果
+ */
+export function validatePhone(phone, countryCode, countryConfig, props) {
+  var errors = [];
+  var cleaned = phone.replace(/\D/g, '');
+
+  // 1. 必填校验
+  if (props.required && !cleaned) {
+    errors.push(props.errorMessage || '请输入电话号码');
+    return {
+      isValid: false,
+      errors: errors
+    };
+  }
+
+  // 如果为空且非必填，直接返回有效
+  if (!cleaned) {
+    return {
+      isValid: true,
+      errors: errors
+    };
+  }
+
+  // 2. 格式校验（如果启用）
+  if (props.validateFormat !== false && countryConfig) {
+    // 长度校验
+    if (cleaned.length !== countryConfig.maxLength) {
+      // 如果 pattern 支持范围（如 /^\d{10,11}$/），则判断是否在范围内
+      var patternStr = countryConfig.pattern.toString();
+      var isRangePattern = patternStr.includes(',');
+      if (!isRangePattern || !countryConfig.pattern.test(cleaned)) {
+        errors.push("\u7535\u8BDD\u53F7\u7801\u5E94\u4E3A ".concat(countryConfig.maxLength, " \u4F4D"));
+      }
+    }
+
+    // 正则校验
+    if (!countryConfig.pattern.test(cleaned)) {
+      errors.push(props.errorMessage || '电话号码格式不正确');
+    }
+  }
+
+  // 3. 自定义校验
+  if (props.customValidator) {
+    var result = props.customValidator(cleaned, countryCode);
+    if (result !== true) {
+      errors.push(typeof result === 'string' ? result : '校验失败');
+    }
+  }
+  return {
+    isValid: errors.length === 0,
+    errors: errors
+  };
+}

package/es/components/pisellRating/PisellRating.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { PisellRatingProps } from './types';
+import './PisellRating.less';
+/**
+ * PisellRating 评分组件
+ *
+ * 基于 Ant Design Rate 组件开发，提供直观的星级评分交互。
+ * 支持只读、编辑、禁用三种状态。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 基础使用
+ * const [rating, setRating] = useState(0);
+ * <PisellRating value={rating} onChange={setRating} />
+ *
+ * @example
+ * // 只读态
+ * <PisellRating mode="read" value={4.5} allowHalf />
+ *
+ * @example
+ * // 带评分描述
+ * <PisellRating
+ *   value={rating}
+ *   onChange={setRating}
+ *   tooltips={['很差', '差', '一般', '好', '很好']}
+ * />
+ */
+export declare const PisellRating: React.FC<PisellRatingProps>;
+declare const _default: React.NamedExoticComponent<PisellRatingProps>;
+export default _default;

package/es/components/pisellRating/PisellRating.js

@@ -0,0 +1,120 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import React from 'react';
+import { Rate } from 'antd';
+import { getDisplayState } from '@pisell/utils';
+import "./PisellRating.less";
+
+/**
+ * PisellRating 评分组件
+ * 
+ * 基于 Ant Design Rate 组件开发，提供直观的星级评分交互。
+ * 支持只读、编辑、禁用三种状态。
+ * 
+ * @param props 组件 Props
+ * 
+ * @example
+ * // 基础使用
+ * const [rating, setRating] = useState(0);
+ * <PisellRating value={rating} onChange={setRating} />
+ * 
+ * @example
+ * // 只读态
+ * <PisellRating mode="read" value={4.5} allowHalf />
+ * 
+ * @example
+ * // 带评分描述
+ * <PisellRating
+ *   value={rating}
+ *   onChange={setRating}
+ *   tooltips={['很差', '差', '一般', '好', '很好']}
+ * />
+ */
+export var PisellRating = function PisellRating(props) {
+  var _props$mode = props.mode,
+    mode = _props$mode === void 0 ? 'edit' : _props$mode,
+    _props$disabled = props.disabled,
+    disabled = _props$disabled === void 0 ? false : _props$disabled,
+    value = props.value,
+    defaultValue = props.defaultValue,
+    onChange = props.onChange,
+    count = props.count,
+    _props$max = props.max,
+    max = _props$max === void 0 ? count !== null && count !== void 0 ? count : 5 : _props$max,
+    _props$allowHalf = props.allowHalf,
+    allowHalf = _props$allowHalf === void 0 ? false : _props$allowHalf,
+    _props$allowClear = props.allowClear,
+    allowClear = _props$allowClear === void 0 ? true : _props$allowClear,
+    character = props.character,
+    tooltips = props.tooltips,
+    _props$showValue = props.showValue,
+    showValue = _props$showValue === void 0 ? false : _props$showValue,
+    _props$showCount = props.showCount,
+    showCount = _props$showCount === void 0 ? false : _props$showCount,
+    reviewCount = props.reviewCount,
+    _props$size = props.size,
+    size = _props$size === void 0 ? 20 : _props$size,
+    _props$color = props.color,
+    color = _props$color === void 0 ? '#fadb14' : _props$color,
+    _props$unselectedColo = props.unselectedColor,
+    unselectedColor = _props$unselectedColo === void 0 ? '#d9d9d9' : _props$unselectedColo,
+    onHoverChange = props.onHoverChange,
+    onFocus = props.onFocus,
+    onBlur = props.onBlur,
+    className = props.className,
+    style = props.style,
+    ariaLabel = props['aria-label'],
+    id = props.id;
+
+  // 计算显示状态
+  var displayState = getDisplayState(mode, disabled);
+
+  // 只读态 = disabled
+  var isReadOnly = displayState === 'read';
+  var isDisabled = displayState === 'disabled';
+
+  // 组合样式
+  var rateStyle = _objectSpread({
+    fontSize: size,
+    color: color
+  }, style);
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-rating pisell-rating-".concat(displayState, " ").concat(className || ''),
+    id: id
+  }, /*#__PURE__*/React.createElement(Rate, {
+    value: value,
+    defaultValue: defaultValue,
+    onChange: onChange,
+    onHoverChange: onHoverChange,
+    onFocus: onFocus,
+    onBlur: onBlur,
+    count: max,
+    allowHalf: allowHalf,
+    allowClear: allowClear,
+    character: character,
+    tooltips: tooltips,
+    disabled: isReadOnly || isDisabled,
+    style: rateStyle,
+    "aria-label": ariaLabel
+  }), showValue && value !== undefined && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-rating-value",
+    style: {
+      marginLeft: 8
+    }
+  }, value.toFixed(allowHalf ? 1 : 0)), showCount && reviewCount !== undefined && /*#__PURE__*/React.createElement("span", {
+    className: "pisell-rating-count",
+    style: {
+      marginLeft: 8,
+      color: '#999'
+    }
+  }, "(", reviewCount, " \u4EBA\u8BC4\u4EF7)"));
+};
+
+// 性能优化
+export default /*#__PURE__*/React.memo(PisellRating, function (prevProps, nextProps) {
+  return prevProps.value === nextProps.value && prevProps.mode === nextProps.mode && prevProps.disabled === nextProps.disabled;
+});

package/es/components/pisellRating/PisellRating.less

@@ -0,0 +1,41 @@
+// PisellRating 组件样式
+
+.pisell-rating {
+  display: inline-flex;
+  align-items: center;
+  
+  // 只读态
+  &-read {
+    .ant-rate {
+      cursor: default;
+      pointer-events: none;
+    }
+  }
+  
+  // 编辑态
+  &-edit {
+    .ant-rate {
+      cursor: pointer;
+    }
+  }
+  
+  // 禁用态
+  &-disabled {
+    opacity: 0.4;
+    
+    .ant-rate {
+      cursor: not-allowed;
+    }
+  }
+  
+  // 评分数值文本
+  &-value {
+    font-size: 14px;
+    color: rgba(0, 0, 0, 0.85);
+  }
+  
+  // 评分人数文本
+  &-count {
+    font-size: 14px;
+  }
+}

package/es/components/pisellRating/PisellRating.stories.d.ts

@@ -0,0 +1,53 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellRating } from './PisellRating';
+declare const meta: Meta<typeof PisellRating>;
+export default meta;
+declare type Story = StoryObj<typeof PisellRating>;
+/**
+ * 基础示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 半星评分
+ */
+export declare const HalfStar: Story;
+/**
+ * 显示数值
+ */
+export declare const WithValue: Story;
+/**
+ * 显示评分人数
+ */
+export declare const WithCount: Story;
+/**
+ * 带评分描述
+ */
+export declare const WithTooltips: Story;
+/**
+ * 自定义星星数量
+ */
+export declare const CustomCount: Story;
+/**
+ * 自定义图标 - 爱心
+ */
+export declare const HeartIcon: Story;
+/**
+ * 自定义图标 - 笑脸
+ */
+export declare const SmileIcon: Story;
+/**
+ * 商品评分场景
+ */
+export declare const ProductReview: Story;
+/**
+ * 不同尺寸
+ */
+export declare const Sizes: Story;

package/es/components/pisellRating/PisellRating.stories.js

@@ -0,0 +1,243 @@
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+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 { PisellRating } from "./PisellRating";
+import { useState } from 'react';
+import { Form } from 'antd';
+import { HeartFilled, SmileFilled } from '@ant-design/icons';
+var meta = {
+  title: 'Components/PisellRating',
+  component: PisellRating,
+  tags: ['autodocs']
+};
+export default meta;
+/**
+ * 基础示例
+ */
+export var Basic = {
+  args: {
+    value: 3
+  },
+  render: function render(args) {
+    var _useState = useState(args.value),
+      _useState2 = _slicedToArray(_useState, 2),
+      value = _useState2[0],
+      setValue = _useState2[1];
+    return /*#__PURE__*/React.createElement(PisellRating, _extends({}, args, {
+      value: value,
+      onChange: setValue
+    }));
+  }
+};
+
+/**
+ * 只读态
+ */
+export var ReadOnly = {
+  args: {
+    mode: 'read',
+    value: 4.5,
+    allowHalf: true
+  }
+};
+
+/**
+ * 禁用态
+ */
+export var Disabled = {
+  args: {
+    disabled: true,
+    value: 3
+  }
+};
+
+/**
+ * 半星评分
+ */
+export var HalfStar = {
+  render: function render() {
+    var _useState3 = useState(3.5),
+      _useState4 = _slicedToArray(_useState3, 2),
+      value = _useState4[0],
+      setValue = _useState4[1];
+    return /*#__PURE__*/React.createElement(PisellRating, {
+      value: value,
+      onChange: setValue,
+      allowHalf: true
+    });
+  }
+};
+
+/**
+ * 显示数值
+ */
+export var WithValue = {
+  args: {
+    mode: 'read',
+    value: 4.2,
+    allowHalf: true,
+    showValue: true
+  }
+};
+
+/**
+ * 显示评分人数
+ */
+export var WithCount = {
+  args: {
+    mode: 'read',
+    value: 4.5,
+    allowHalf: true,
+    showValue: true,
+    showCount: true,
+    reviewCount: 328
+  }
+};
+
+/**
+ * 带评分描述
+ */
+export var WithTooltips = {
+  render: function render() {
+    var _useState5 = useState(0),
+      _useState6 = _slicedToArray(_useState5, 2),
+      value = _useState6[0],
+      setValue = _useState6[1];
+    return /*#__PURE__*/React.createElement(PisellRating, {
+      value: value,
+      onChange: setValue,
+      tooltips: ['很差', '差', '一般', '好', '很好']
+    });
+  }
+};
+
+/**
+ * 自定义星星数量
+ */
+export var CustomCount = {
+  render: function render() {
+    var _useState7 = useState(6),
+      _useState8 = _slicedToArray(_useState7, 2),
+      value = _useState8[0],
+      setValue = _useState8[1];
+    return /*#__PURE__*/React.createElement(PisellRating, {
+      value: value,
+      onChange: setValue,
+      max: 10
+    });
+  }
+};
+
+/**
+ * 自定义图标 - 爱心
+ */
+export var HeartIcon = {
+  render: function render() {
+    var _useState9 = useState(3),
+      _useState10 = _slicedToArray(_useState9, 2),
+      value = _useState10[0],
+      setValue = _useState10[1];
+    return /*#__PURE__*/React.createElement(PisellRating, {
+      value: value,
+      onChange: setValue,
+      character: /*#__PURE__*/React.createElement(HeartFilled, null),
+      color: "#ff4d4f"
+    });
+  }
+};
+
+/**
+ * 自定义图标 - 笑脸
+ */
+export var SmileIcon = {
+  render: function render() {
+    var _useState11 = useState(4),
+      _useState12 = _slicedToArray(_useState11, 2),
+      value = _useState12[0],
+      setValue = _useState12[1];
+    return /*#__PURE__*/React.createElement(PisellRating, {
+      value: value,
+      onChange: setValue,
+      character: /*#__PURE__*/React.createElement(SmileFilled, null),
+      color: "#52c41a"
+    });
+  }
+};
+
+/**
+ * 商品评分场景
+ */
+export var ProductReview = {
+  render: function render() {
+    var _useState13 = useState(0),
+      _useState14 = _slicedToArray(_useState13, 2),
+      userRating = _useState14[0],
+      setUserRating = _useState14[1];
+    var averageRating = 4.2;
+    var reviewCount = 328;
+    return /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("div", {
+      style: {
+        marginBottom: 24
+      }
+    }, /*#__PURE__*/React.createElement("div", {
+      style: {
+        marginBottom: 8,
+        fontWeight: 'bold'
+      }
+    }, "\u5546\u54C1\u8BC4\u5206"), /*#__PURE__*/React.createElement(PisellRating, {
+      mode: "read",
+      value: averageRating,
+      allowHalf: true,
+      showValue: true,
+      showCount: true,
+      reviewCount: reviewCount
+    })), /*#__PURE__*/React.createElement(Form.Item, {
+      label: "\u60A8\u7684\u8BC4\u5206"
+    }, /*#__PURE__*/React.createElement(PisellRating, {
+      value: userRating,
+      onChange: setUserRating,
+      allowHalf: true,
+      tooltips: ['非常差', '差', '一般', '满意', '非常满意']
+    })));
+  }
+};
+
+/**
+ * 不同尺寸
+ */
+export var Sizes = {
+  render: function render() {
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        display: 'flex',
+        flexDirection: 'column',
+        gap: 16
+      }
+    }, /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("span", {
+      style: {
+        marginRight: 8
+      }
+    }, "\u5C0F\uFF1A"), /*#__PURE__*/React.createElement(PisellRating, {
+      value: 4,
+      size: 16
+    })), /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("span", {
+      style: {
+        marginRight: 8
+      }
+    }, "\u9ED8\u8BA4\uFF1A"), /*#__PURE__*/React.createElement(PisellRating, {
+      value: 4,
+      size: 20
+    })), /*#__PURE__*/React.createElement("div", null, /*#__PURE__*/React.createElement("span", {
+      style: {
+        marginRight: 8
+      }
+    }, "\u5927\uFF1A"), /*#__PURE__*/React.createElement(PisellRating, {
+      value: 4,
+      size: 24
+    })));
+  }
+};

package/es/components/pisellRating/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellRating 组件导出
+ */
+export { default as PisellRating } from './PisellRating';
+export type { PisellRatingProps } from './types';
+export type { DisplayState } from './types';

package/es/components/pisellRating/index.js

@@ -0,0 +1,7 @@
+/**
+ * PisellRating 组件导出
+ */
+
+export { default as PisellRating } from "./PisellRating";
+
+// 公共类型重新导出

package/es/components/pisellRating/types.d.ts

@@ -0,0 +1,124 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 从 @pisell/utils 重新导出公共类型
+ */
+export type { DisplayState } from '@pisell/utils';
+/**
+ * PisellRating 组件 Props 类型定义
+ *
+ * 基于 Ant Design Rate 组件，独立实现
+ */
+export interface PisellRatingProps {
+    /**
+     * 显示模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 当前评分值（受控）
+     */
+    value?: number;
+    /**
+     * 默认评分值（非受控）
+     */
+    defaultValue?: number;
+    /**
+     * 评分变更回调
+     */
+    onChange?: (value: number) => void;
+    /**
+     * 星星数量
+     * @default 5
+     */
+    count?: number;
+    /**
+     * 最大评分值（同 count，为了与 Number 系列保持一致）
+     * @default 5
+     */
+    max?: number;
+    /**
+     * 是否允许半星评分
+     * @default false
+     */
+    allowHalf?: boolean;
+    /**
+     * 是否允许清除评分
+     * @default true
+     */
+    allowClear?: boolean;
+    /**
+     * 自定义字符
+     * @default StarFilled
+     */
+    character?: ReactNode | ((props: {
+        index: number;
+        value: number;
+    }) => ReactNode);
+    /**
+     * 评分描述文本数组
+     * @example ['很差', '差', '一般', '好', '很好']
+     */
+    tooltips?: string[];
+    /**
+     * 是否显示数值文本
+     * @default false
+     */
+    showValue?: boolean;
+    /**
+     * 是否显示评分人数
+     * @default false
+     */
+    showCount?: boolean;
+    /**
+     * 评分人数
+     */
+    reviewCount?: number;
+    /**
+     * 星星尺寸（仅影响样式）
+     * @default 20
+     */
+    size?: number;
+    /**
+     * 星星颜色（已选中）
+     * @default '#fadb14'
+     */
+    color?: string;
+    /**
+     * 星星颜色（未选中）
+     * @default '#d9d9d9'
+     */
+    unselectedColor?: string;
+    /**
+     * 悬停评分值变化回调
+     */
+    onHoverChange?: (value: number) => void;
+    /**
+     * 聚焦回调
+     */
+    onFocus?: () => void;
+    /**
+     * 失焦回调
+     */
+    onBlur?: () => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * HTML id 属性
+     */
+    id?: string;
+}