@pisell/materials 6.3.25 → 6.3.27

package/es/components/pisellEmail/components/DisabledView.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import type { PisellEmailProps } from '../types';
+/**
+ * PisellEmail 禁用态视图组件
+ *
+ * 职责：
+ * - 渲染禁用状态的邮箱组件
+ * - 根据原始 mode 选择渲染 ReadOnlyView 或 EditView
+ * - 应用禁用样式（透明度 40%）
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellEmailProps>;
+export default DisabledView;

package/es/components/pisellEmail/components/DisabledView.js

@@ -0,0 +1,21 @@
+import React from 'react';
+import ReadOnlyView from "./ReadOnlyView";
+import EditView from "./EditView";
+/**
+ * PisellEmail 禁用态视图组件
+ * 
+ * 职责：
+ * - 渲染禁用状态的邮箱组件
+ * - 根据原始 mode 选择渲染 ReadOnlyView 或 EditView
+ * - 应用禁用样式（透明度 40%）
+ * 
+ * @param props 组件 Props
+ */
+var DisabledView = function DisabledView(props) {
+  var _props$mode = props.mode,
+    mode = _props$mode === void 0 ? 'edit' : _props$mode;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-email-disabled"
+  }, mode === 'read' ? /*#__PURE__*/React.createElement(ReadOnlyView, props) : /*#__PURE__*/React.createElement(EditView, props));
+};
+export default DisabledView;

package/es/components/pisellEmail/components/EditView.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PisellEmailProps } from '../types';
+/**
+ * PisellEmail 编辑态视图组件
+ *
+ * 职责：
+ * - 渲染编辑态邮箱输入框
+ * - 提供域名智能补全（基于 AutoComplete）
+ * - 实时格式校验（标准/严格）
+ * - 错误提示展示
+ *
+ * @param props 组件 Props
+ */
+declare const EditView: React.FC<PisellEmailProps>;
+export default EditView;

package/es/components/pisellEmail/components/EditView.js

@@ -0,0 +1,146 @@
+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); }
+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 React, { useState, useMemo } from 'react';
+import { AutoComplete, Input } from 'antd';
+import { MailOutlined } from '@ant-design/icons';
+import { useTextInputState } from '@pisell/utils';
+import { validateEmail, validateEmailStrict, validateEmailDomain, getEmailSuggestions } from "../utils";
+import { COMMON_EMAIL_DOMAINS } from "../constants/emailDomains";
+/**
+ * PisellEmail 编辑态视图组件
+ * 
+ * 职责：
+ * - 渲染编辑态邮箱输入框
+ * - 提供域名智能补全（基于 AutoComplete）
+ * - 实时格式校验（标准/严格）
+ * - 错误提示展示
+ * 
+ * @param props 组件 Props
+ */
+var EditView = function EditView(props) {
+  var _props$placeholder = props.placeholder,
+    placeholder = _props$placeholder === void 0 ? '请输入邮箱地址' : _props$placeholder,
+    _props$maxLength = props.maxLength,
+    maxLength = _props$maxLength === void 0 ? 254 : _props$maxLength,
+    _props$allowClear = props.allowClear,
+    allowClear = _props$allowClear === void 0 ? false : _props$allowClear,
+    _props$autoFocus = props.autoFocus,
+    autoFocus = _props$autoFocus === void 0 ? false : _props$autoFocus,
+    _props$disabled = props.disabled,
+    disabled = _props$disabled === void 0 ? false : _props$disabled,
+    className = props.className,
+    style = props.style,
+    _props$enableAutoComp = props.enableAutoComplete,
+    enableAutoComplete = _props$enableAutoComp === void 0 ? true : _props$enableAutoComp,
+    autoCompleteDomains = props.autoCompleteDomains,
+    _props$strictValidati = props.strictValidation,
+    strictValidation = _props$strictValidati === void 0 ? false : _props$strictValidati,
+    allowedDomains = props.allowedDomains,
+    blockedDomains = props.blockedDomains,
+    errorMessage = props.errorMessage,
+    onSelect = props.onSelect;
+
+  // 域名补全建议列表
+  var _useState = useState([]),
+    _useState2 = _slicedToArray(_useState, 2),
+    suggestions = _useState2[0],
+    setSuggestions = _useState2[1];
+
+  // 域名列表
+  var domains = useMemo(function () {
+    return autoCompleteDomains || COMMON_EMAIL_DOMAINS;
+  }, [autoCompleteDomains]);
+
+  // 状态管理（复用公共 Hook）
+  var _useTextInputState = useTextInputState(_objectSpread(_objectSpread({}, props), {}, {
+      validator: function validator(val) {
+        if (!val) return true;
+
+        // 1. 格式校验
+        var formatValid = strictValidation ? validateEmailStrict(val) : validateEmail(val);
+        if (!formatValid) {
+          return errorMessage || '邮箱地址格式不正确';
+        }
+
+        // 2. 域名白名单/黑名单校验
+        var domainValidation = validateEmailDomain(val, allowedDomains, blockedDomains);
+        if (!domainValidation.isValid) {
+          return domainValidation.errors[0];
+        }
+        return true;
+      }
+    })),
+    value = _useTextInputState.value,
+    isValid = _useTextInputState.isValid,
+    errors = _useTextInputState.errors,
+    handleChange = _useTextInputState.handleChange,
+    handleBlur = _useTextInputState.handleBlur,
+    handleFocus = _useTextInputState.handleFocus;
+
+  // 处理输入变化（生成域名补全建议）
+  var handleSearch = function handleSearch(searchText) {
+    if (enableAutoComplete) {
+      var _suggestions = getEmailSuggestions(searchText, domains);
+      setSuggestions(_suggestions);
+    }
+  };
+
+  // 处理输入
+  var handleInputChange = function handleInputChange(val) {
+    handleChange(val);
+    handleSearch(val);
+  };
+
+  // 选择补全建议
+  var handleSelectSuggestion = function handleSelectSuggestion(val) {
+    handleChange(val);
+    onSelect === null || onSelect === void 0 || onSelect(val);
+  };
+
+  // 转换为 AutoComplete 的 options 格式
+  var options = suggestions.map(function (email) {
+    return {
+      value: email
+    };
+  });
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-email-edit"
+  }, /*#__PURE__*/React.createElement(AutoComplete, {
+    value: value,
+    onChange: handleInputChange,
+    onSelect: handleSelectSuggestion,
+    onBlur: handleBlur,
+    onFocus: handleFocus,
+    options: options,
+    style: {
+      width: '100%'
+    },
+    disabled: disabled,
+    status: isValid ? undefined : 'error',
+    popupClassName: "pisell-email-autocomplete-dropdown"
+  }, /*#__PURE__*/React.createElement(Input, {
+    type: "email",
+    prefix: /*#__PURE__*/React.createElement(MailOutlined, null),
+    placeholder: placeholder,
+    maxLength: maxLength,
+    allowClear: allowClear,
+    autoFocus: autoFocus,
+    className: className,
+    style: style,
+    "aria-label": props['aria-label'],
+    "aria-describedby": props['aria-describedby']
+  })), !isValid && errors.length > 0 && /*#__PURE__*/React.createElement("div", {
+    className: "pisell-email-edit-error"
+  }, errors[0]));
+};
+export default EditView;

package/es/components/pisellEmail/components/ReadOnlyView.d.ts

@@ -0,0 +1,15 @@
+import React from 'react';
+import type { PisellEmailProps } from '../types';
+/**
+ * PisellEmail 只读态视图组件
+ *
+ * 职责：
+ * - 渲染只读态邮箱地址展示
+ * - 支持点击唤起邮件客户端（mailto）
+ * - 支持域名隐藏/脱敏（partial/full 模式）
+ * - 支持邮件图标按钮
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellEmailProps>;
+export default ReadOnlyView;

package/es/components/pisellEmail/components/ReadOnlyView.js

@@ -0,0 +1,81 @@
+import React from 'react';
+import { Typography, Button, Space } from 'antd';
+import { MailOutlined } from '@ant-design/icons';
+import { handleEmailClick, hideEmailDomain, maskEmailDomain } from "../utils";
+/**
+ * PisellEmail 只读态视图组件
+ * 
+ * 职责：
+ * - 渲染只读态邮箱地址展示
+ * - 支持点击唤起邮件客户端（mailto）
+ * - 支持域名隐藏/脱敏（partial/full 模式）
+ * - 支持邮件图标按钮
+ * 
+ * @param props 组件 Props
+ */
+var ReadOnlyView = function ReadOnlyView(props) {
+  var _props$value = props.value,
+    value = _props$value === void 0 ? '' : _props$value,
+    _props$displayAsLink = props.displayAsLink,
+    displayAsLink = _props$displayAsLink === void 0 ? true : _props$displayAsLink,
+    _props$enableMailto = props.enableMailto,
+    enableMailto = _props$enableMailto === void 0 ? true : _props$enableMailto,
+    _props$showEmailIcon = props.showEmailIcon,
+    showEmailIcon = _props$showEmailIcon === void 0 ? false : _props$showEmailIcon,
+    _props$hideDomain = props.hideDomain,
+    hideDomain = _props$hideDomain === void 0 ? false : _props$hideDomain,
+    _props$maskPattern = props.maskPattern,
+    maskPattern = _props$maskPattern === void 0 ? 'partial' : _props$maskPattern,
+    mailtoOptions = props.mailtoOptions,
+    _props$fontSize = props.fontSize,
+    fontSize = _props$fontSize === void 0 ? 16 : _props$fontSize,
+    _props$fontWeight = props.fontWeight,
+    fontWeight = _props$fontWeight === void 0 ? 500 : _props$fontWeight,
+    _props$color = props.color,
+    color = _props$color === void 0 ? '#101828' : _props$color,
+    _props$linkColor = props.linkColor,
+    linkColor = _props$linkColor === void 0 ? '#7F56DA' : _props$linkColor,
+    onMailto = props.onMailto;
+
+  // 处理域名隐藏/脱敏
+  var displayEmail = hideDomain ? maskPattern === 'full' ? maskEmailDomain(value) : hideEmailDomain(value) : value;
+
+  // 邮件发送处理
+  var handleMailto = function handleMailto() {
+    if (enableMailto && value) {
+      onMailto === null || onMailto === void 0 || onMailto(value);
+      handleEmailClick(value, mailtoOptions);
+    }
+  };
+  var canMailto = enableMailto && !!value;
+  var showAsLink = displayAsLink && canMailto;
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-email-read"
+  }, /*#__PURE__*/React.createElement(Space, {
+    size: "small"
+  }, showAsLink ? /*#__PURE__*/React.createElement(Typography.Link, {
+    onClick: handleMailto,
+    style: {
+      fontSize: fontSize,
+      fontWeight: fontWeight,
+      color: linkColor
+    },
+    "aria-label": props['aria-label'],
+    "aria-describedby": props['aria-describedby']
+  }, displayEmail) : /*#__PURE__*/React.createElement(Typography.Text, {
+    style: {
+      fontSize: fontSize,
+      fontWeight: fontWeight,
+      color: color
+    },
+    "aria-label": props['aria-label'],
+    "aria-describedby": props['aria-describedby']
+  }, displayEmail), showEmailIcon && canMailto && /*#__PURE__*/React.createElement(Button, {
+    type: "link",
+    size: "small",
+    icon: /*#__PURE__*/React.createElement(MailOutlined, null),
+    onClick: handleMailto,
+    "aria-label": "\u53D1\u9001\u90AE\u4EF6"
+  })));
+};
+export default ReadOnlyView;

package/es/components/pisellEmail/constants/emailDomains.js

@@ -0,0 +1,11 @@
+/**
+ * 常用邮箱域名列表
+ * 用于域名自动补全功能
+ */
+export var COMMON_EMAIL_DOMAINS = [
+// 国内常用邮箱
+'qq.com', '163.com', '126.com', 'sina.com', 'sina.cn', 'sohu.com', '139.com', '189.cn',
+// 国际常用邮箱
+'gmail.com', 'outlook.com', 'hotmail.com', 'yahoo.com', 'icloud.com', 'live.com', 'msn.com',
+// 企业邮箱示例（可自定义）
+'company.com'];

package/es/components/pisellEmail/constants/emailRegex.js

@@ -0,0 +1,15 @@
+/**
+ * 邮箱正则表达式常量
+ */
+
+/**
+ * 标准邮箱格式正则
+ * 覆盖99%的常见邮箱格式
+ */
+export var EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+
+/**
+ * 严格邮箱格式正则（RFC 5322）
+ * 支持更复杂的邮箱格式，符合 RFC 5322 标准
+ */
+export var STRICT_EMAIL_REGEX = /^(?:[a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*|"(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21\x23-\x5b\x5d-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])*")@(?:(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?|\[(?:(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9]))\.){3}(?:(2(5[0-5]|[0-4][0-9])|1[0-9][0-9]|[1-9]?[0-9])|[a-z0-9-]*[a-z0-9]:(?:[\x01-\x08\x0b\x0c\x0e-\x1f\x21-\x5a\x53-\x7f]|\\[\x01-\x09\x0b\x0c\x0e-\x7f])+)\])$/i;

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

@@ -0,0 +1,5 @@
+/**
+ * PisellEmail 组件导出文件
+ */
+export { PisellEmail, default } from './PisellEmail';
+export type { PisellEmailProps, MailtoOptions } from './types';

package/es/components/pisellEmail/index.js

@@ -0,0 +1,5 @@
+/**
+ * PisellEmail 组件导出文件
+ */
+
+export { PisellEmail, default } from "./PisellEmail";

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

@@ -0,0 +1,176 @@
+import type { CSSProperties } from 'react';
+import type { BaseTextInputProps } from '@pisell/utils';
+/**
+ * Mailto 邮件参数配置类型
+ */
+export interface MailtoOptions {
+    /**
+     * 邮件主题
+     * @example '产品咨询'
+     */
+    subject?: string;
+    /**
+     * 邮件正文
+     * @example '您好，我想咨询...'
+     */
+    body?: string;
+    /**
+     * 抄送地址
+     * @example 'cc@example.com'
+     */
+    cc?: string;
+    /**
+     * 密送地址
+     * @example 'bcc@example.com'
+     */
+    bcc?: string;
+}
+/**
+ * PisellEmail 组件 Props 类型定义
+ *
+ * 继承 BaseTextInputProps，添加邮箱特有的配置
+ */
+export interface PisellEmailProps extends BaseTextInputProps {
+    /**
+     * 状态模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 是否使用严格校验（RFC 5322）
+     * @default false
+     */
+    strictValidation?: boolean;
+    /**
+     * 白名单域名列表（仅允许指定域名）
+     * @example ['company.com', 'partner.com']
+     */
+    allowedDomains?: string[];
+    /**
+     * 黑名单域名列表（禁止某些域名）
+     * @example ['tempmail.com', '10minutemail.com']
+     */
+    blockedDomains?: string[];
+    /**
+     * 是否启用域名自动补全
+     * @default true
+     */
+    enableAutoComplete?: boolean;
+    /**
+     * 自定义补全域名列表
+     * @example ['gmail.com', 'company.com', 'custom.com']
+     */
+    autoCompleteDomains?: string[];
+    /**
+     * 是否显示所有建议（不过滤）
+     * @default false
+     */
+    showAllSuggestions?: boolean;
+    /**
+     * 选择补全建议回调
+     * @param value 选中的邮箱地址
+     */
+    onSelect?: (value: string) => void;
+    /**
+     * 是否启用 mailto（只读态）
+     * @default true
+     */
+    enableMailto?: boolean;
+    /**
+     * 是否显示邮件图标
+     * @default false
+     */
+    showEmailIcon?: boolean;
+    /**
+     * mailto 默认参数
+     */
+    mailtoOptions?: MailtoOptions;
+    /**
+     * 发送邮件回调
+     * @param email 邮箱地址
+     */
+    onMailto?: (email: string) => void;
+    /**
+     * 是否隐藏域名（只读态）
+     * @default false
+     */
+    hideDomain?: boolean;
+    /**
+     * 脱敏模式
+     * - partial: 部分隐藏（u***@gmail.com）
+     * - full: 完全隐藏（user@***）
+     * @default 'partial'
+     */
+    maskPattern?: 'partial' | 'full';
+    /**
+     * 是否显示为链接（只读态）
+     * @default true
+     */
+    displayAsLink?: boolean;
+    /**
+     * 字号
+     * @example '14px' 或 14
+     * @default 16
+     */
+    fontSize?: string | number;
+    /**
+     * 字重
+     * @example 'bold' 或 600
+     * @default 500
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     * @example '#000000'
+     * @default '#101828'
+     */
+    color?: string;
+    /**
+     * 链接颜色（只读态）
+     * @example '#1890ff'
+     * @default '#7F56DA'
+     */
+    linkColor?: string;
+    /**
+     * 占位文本
+     * @default '请输入邮箱地址'
+     */
+    placeholder?: string;
+    /**
+     * 最大长度（RFC 5321）
+     * @default 254
+     */
+    maxLength?: number;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否自动聚焦
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 描述
+     */
+    'aria-describedby'?: string;
+}
+export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/es/components/pisellEmail/types.js

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

package/es/components/pisellEmail/utils/domainSuggestions.js

@@ -0,0 +1,46 @@
+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; }
+/**
+ * 域名补全工具函数（框架占位符）
+ * TODO: 实现完整的补全逻辑
+ */
+
+import { COMMON_EMAIL_DOMAINS } from "../constants/emailDomains";
+
+/**
+ * 获取邮箱域名补全建议
+ * @param input 用户输入
+ * @param domains 域名列表
+ * @returns 补全建议列表
+ * 
+ * @example
+ * getEmailSuggestions('user@g', COMMON_EMAIL_DOMAINS) 
+ * // 返回: ['user@gmail.com']
+ */
+export function getEmailSuggestions(input) {
+  var domains = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : COMMON_EMAIL_DOMAINS;
+  if (!input.includes('@')) {
+    return [];
+  }
+  var _input$split = input.split('@'),
+    _input$split2 = _slicedToArray(_input$split, 2),
+    localPart = _input$split2[0],
+    partialDomain = _input$split2[1];
+  if (!localPart) {
+    return [];
+  }
+
+  // 过滤匹配的域名
+  var matchedDomains = domains.filter(function (domain) {
+    return domain.toLowerCase().startsWith(partialDomain.toLowerCase());
+  });
+
+  // 返回完整邮箱建议
+  return matchedDomains.map(function (domain) {
+    return "".concat(localPart, "@").concat(domain);
+  });
+}

package/es/components/pisellEmail/utils/emailHelper.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 邮箱辅助函数
+ */
+import type { MailtoOptions } from '../types';
+/**
+ * 提取邮箱域名
+ * @param email 邮箱地址
+ * @returns 域名部分
+ *
+ * @example
+ * extractEmailDomain('user@example.com') // 'example.com'
+ */
+export declare function extractEmailDomain(email: string): string;
+/**
+ * 提取邮箱本地部分
+ * @param email 邮箱地址
+ * @returns 本地部分（@ 前面的部分）
+ *
+ * @example
+ * extractEmailLocal('user@example.com') // 'user'
+ */
+export declare function extractEmailLocal(email: string): string;
+/**
+ * 规范化邮箱地址（转小写）
+ * @param email 邮箱地址
+ * @returns 规范化后的邮箱地址
+ *
+ * @example
+ * normalizeEmail('User@Example.COM') // 'user@example.com'
+ */
+export declare function normalizeEmail(email: string): string;
+/**
+ * 邮箱域名脱敏（partial 模式）
+ * 只显示本地部分的第一个字符，其余用 *** 替代
+ *
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱（u***@gmail.com）
+ *
+ * @example
+ * hideEmailDomain('user@gmail.com') // 'u***@gmail.com'
+ */
+export declare function hideEmailDomain(email: string): string;
+/**
+ * 邮箱域名完全隐藏（full 模式）
+ * 隐藏整个域名部分
+ *
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱（user@***）
+ *
+ * @example
+ * maskEmailDomain('user@gmail.com') // 'user@***'
+ */
+export declare function maskEmailDomain(email: string): string;
+/**
+ * 处理 mailto 点击，唤起邮件客户端
+ *
+ * @param email 邮箱地址
+ * @param options mailto 可选参数（主题、正文、抄送等）
+ *
+ * @example
+ * handleEmailClick('support@example.com', {
+ *   subject: '产品咨询',
+ *   body: '您好，我想咨询...'
+ * })
+ */
+export declare function handleEmailClick(email: string, options?: MailtoOptions): void;