@pisell/materials 3.3.82 → 3.3.84

package/lib/components/pisellEmail/components/EditView.js

@@ -0,0 +1,123 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellEmail/components/EditView.tsx
+var EditView_exports = {};
+__export(EditView_exports, {
+  default: () => EditView_default
+});
+module.exports = __toCommonJS(EditView_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_icons = require("@ant-design/icons");
+var import_utils = require("@pisell/utils");
+var import_utils2 = require("../utils");
+var import_emailDomains = require("../constants/emailDomains");
+var EditView = (props) => {
+  const {
+    placeholder = "请输入邮箱地址",
+    maxLength = 254,
+    allowClear = false,
+    autoFocus = false,
+    disabled = false,
+    className,
+    style,
+    enableAutoComplete = true,
+    autoCompleteDomains,
+    strictValidation = false,
+    allowedDomains,
+    blockedDomains,
+    errorMessage,
+    onSelect
+  } = props;
+  const [suggestions, setSuggestions] = (0, import_react.useState)([]);
+  const domains = (0, import_react.useMemo)(() => {
+    return autoCompleteDomains || import_emailDomains.COMMON_EMAIL_DOMAINS;
+  }, [autoCompleteDomains]);
+  const { value, isValid, errors, handleChange, handleBlur, handleFocus } = (0, import_utils.useTextInputState)({
+    ...props,
+    validator: (val) => {
+      if (!val) return true;
+      const formatValid = strictValidation ? (0, import_utils2.validateEmailStrict)(val) : (0, import_utils2.validateEmail)(val);
+      if (!formatValid) {
+        return errorMessage || "邮箱地址格式不正确";
+      }
+      const domainValidation = (0, import_utils2.validateEmailDomain)(val, allowedDomains, blockedDomains);
+      if (!domainValidation.isValid) {
+        return domainValidation.errors[0];
+      }
+      return true;
+    }
+  });
+  const handleSearch = (searchText) => {
+    if (enableAutoComplete) {
+      const suggestions2 = (0, import_utils2.getEmailSuggestions)(searchText, domains);
+      setSuggestions(suggestions2);
+    }
+  };
+  const handleInputChange = (val) => {
+    handleChange(val);
+    handleSearch(val);
+  };
+  const handleSelectSuggestion = (val) => {
+    handleChange(val);
+    onSelect == null ? void 0 : onSelect(val);
+  };
+  const options = suggestions.map((email) => ({ value: email }));
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-email-edit" }, /* @__PURE__ */ import_react.default.createElement(
+    import_antd.AutoComplete,
+    {
+      value,
+      onChange: handleInputChange,
+      onSelect: handleSelectSuggestion,
+      onBlur: handleBlur,
+      onFocus: handleFocus,
+      options,
+      style: { width: "100%" },
+      disabled,
+      status: isValid ? void 0 : "error",
+      popupClassName: "pisell-email-autocomplete-dropdown"
+    },
+    /* @__PURE__ */ import_react.default.createElement(
+      import_antd.Input,
+      {
+        type: "email",
+        prefix: /* @__PURE__ */ import_react.default.createElement(import_icons.MailOutlined, null),
+        placeholder,
+        maxLength,
+        allowClear,
+        autoFocus,
+        className,
+        style,
+        "aria-label": props["aria-label"],
+        "aria-describedby": props["aria-describedby"]
+      }
+    )
+  ), !isValid && errors.length > 0 && /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-email-edit-error" }, errors[0]));
+};
+var EditView_default = EditView;

package/lib/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/lib/components/pisellEmail/components/ReadOnlyView.js

@@ -0,0 +1,99 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellEmail/components/ReadOnlyView.tsx
+var ReadOnlyView_exports = {};
+__export(ReadOnlyView_exports, {
+  default: () => ReadOnlyView_default
+});
+module.exports = __toCommonJS(ReadOnlyView_exports);
+var import_react = __toESM(require("react"));
+var import_antd = require("antd");
+var import_icons = require("@ant-design/icons");
+var import_utils = require("../utils");
+var ReadOnlyView = (props) => {
+  const {
+    value = "",
+    displayAsLink = true,
+    enableMailto = true,
+    showEmailIcon = false,
+    hideDomain = false,
+    maskPattern = "partial",
+    mailtoOptions,
+    fontSize = 16,
+    fontWeight = 500,
+    color = "#101828",
+    linkColor = "#7F56DA",
+    onMailto
+  } = props;
+  const displayEmail = hideDomain ? maskPattern === "full" ? (0, import_utils.maskEmailDomain)(value) : (0, import_utils.hideEmailDomain)(value) : value;
+  const handleMailto = () => {
+    if (enableMailto && value) {
+      onMailto == null ? void 0 : onMailto(value);
+      (0, import_utils.handleEmailClick)(value, mailtoOptions);
+    }
+  };
+  const canMailto = enableMailto && !!value;
+  const showAsLink = displayAsLink && canMailto;
+  return /* @__PURE__ */ import_react.default.createElement("div", { className: "pisell-email-read" }, /* @__PURE__ */ import_react.default.createElement(import_antd.Space, { size: "small" }, showAsLink ? /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Typography.Link,
+    {
+      onClick: handleMailto,
+      style: {
+        fontSize,
+        fontWeight,
+        color: linkColor
+      },
+      "aria-label": props["aria-label"],
+      "aria-describedby": props["aria-describedby"]
+    },
+    displayEmail
+  ) : /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Typography.Text,
+    {
+      style: {
+        fontSize,
+        fontWeight,
+        color
+      },
+      "aria-label": props["aria-label"],
+      "aria-describedby": props["aria-describedby"]
+    },
+    displayEmail
+  ), showEmailIcon && canMailto && /* @__PURE__ */ import_react.default.createElement(
+    import_antd.Button,
+    {
+      type: "link",
+      size: "small",
+      icon: /* @__PURE__ */ import_react.default.createElement(import_icons.MailOutlined, null),
+      onClick: handleMailto,
+      "aria-label": "发送邮件"
+    }
+  )));
+};
+var ReadOnlyView_default = ReadOnlyView;

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

@@ -0,0 +1,49 @@
+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/components/pisellEmail/constants/emailDomains.ts
+var emailDomains_exports = {};
+__export(emailDomains_exports, {
+  COMMON_EMAIL_DOMAINS: () => COMMON_EMAIL_DOMAINS
+});
+module.exports = __toCommonJS(emailDomains_exports);
+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"
+];
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  COMMON_EMAIL_DOMAINS
+});

package/lib/components/pisellEmail/constants/emailRegex.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/components/pisellEmail/constants/emailRegex.ts
+var emailRegex_exports = {};
+__export(emailRegex_exports, {
+  EMAIL_REGEX: () => EMAIL_REGEX,
+  STRICT_EMAIL_REGEX: () => STRICT_EMAIL_REGEX
+});
+module.exports = __toCommonJS(emailRegex_exports);
+var EMAIL_REGEX = /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/;
+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;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  EMAIL_REGEX,
+  STRICT_EMAIL_REGEX
+});

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

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

package/lib/components/pisellEmail/index.js

@@ -0,0 +1,40 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellEmail/index.tsx
+var pisellEmail_exports = {};
+__export(pisellEmail_exports, {
+  PisellEmail: () => import_PisellEmail.PisellEmail,
+  default: () => import_PisellEmail.default
+});
+module.exports = __toCommonJS(pisellEmail_exports);
+var import_PisellEmail = __toESM(require("./PisellEmail"));
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PisellEmail
+});

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

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

@@ -0,0 +1,42 @@
+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/components/pisellEmail/utils/domainSuggestions.ts
+var domainSuggestions_exports = {};
+__export(domainSuggestions_exports, {
+  getEmailSuggestions: () => getEmailSuggestions
+});
+module.exports = __toCommonJS(domainSuggestions_exports);
+var import_emailDomains = require("../constants/emailDomains");
+function getEmailSuggestions(input, domains = import_emailDomains.COMMON_EMAIL_DOMAINS) {
+  if (!input.includes("@")) {
+    return [];
+  }
+  const [localPart, partialDomain] = input.split("@");
+  if (!localPart) {
+    return [];
+  }
+  const matchedDomains = domains.filter(
+    (domain) => domain.toLowerCase().startsWith(partialDomain.toLowerCase())
+  );
+  return matchedDomains.map((domain) => `${localPart}@${domain}`);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getEmailSuggestions
+});

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