@pisell/materials 1.8.20 → 1.8.21

package/es/components/pisellEmail/constants/emailRegex.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 邮箱正则表达式常量
+ */
+/**
+ * 标准邮箱格式正则
+ * 覆盖99%的常见邮箱格式
+ */
+export declare const EMAIL_REGEX: RegExp;
+/**
+ * 严格邮箱格式正则（RFC 5322）
+ * 支持更复杂的邮箱格式，符合 RFC 5322 标准
+ */
+export declare const STRICT_EMAIL_REGEX: RegExp;

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

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

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/utils/domainSuggestions.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 域名补全工具函数（框架占位符）
+ * TODO: 实现完整的补全逻辑
+ */
+/**
+ * 获取邮箱域名补全建议
+ * @param input 用户输入
+ * @param domains 域名列表
+ * @returns 补全建议列表
+ *
+ * @example
+ * getEmailSuggestions('user@g', COMMON_EMAIL_DOMAINS)
+ * // 返回: ['user@gmail.com']
+ */
+export declare function getEmailSuggestions(input: string, domains?: string[]): string[];

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;

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

@@ -0,0 +1,45 @@
+/**
+ * 邮箱校验工具函数
+ */
+/**
+ * 标准邮箱格式校验
+ * @param email 邮箱地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateEmail('user@example.com') // true
+ * validateEmail('invalid-email') // false
+ */
+export declare function validateEmail(email: string): boolean;
+/**
+ * 严格邮箱格式校验（RFC 5322）
+ * @param email 邮箱地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateEmailStrict('user@example.com') // true
+ */
+export declare function validateEmailStrict(email: string): boolean;
+/**
+ * 邮箱分部校验
+ * 检查邮箱的各个部分是否符合规范
+ *
+ * @param email 邮箱地址
+ * @returns 校验结果
+ */
+export declare function validateEmailParts(email: string): {
+    isValid: boolean;
+    errors: string[];
+};
+/**
+ * 域名白名单/黑名单校验
+ *
+ * @param email 邮箱地址
+ * @param allowedDomains 白名单域名列表
+ * @param blockedDomains 黑名单域名列表
+ * @returns 校验结果
+ */
+export declare function validateEmailDomain(email: string, allowedDomains?: string[], blockedDomains?: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

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

@@ -0,0 +1,6 @@
+/**
+ * PisellEmail 工具函数导出
+ */
+export * from './emailValidator';
+export * from './emailHelper';
+export * from './domainSuggestions';

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { PisellFilterProps } from './type';
 declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
 export default PisellFilter;

package/es/components/pisellFind/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props
+ */
+export declare type PisellFindProps = PisellLookupProps;
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <PisellFind
+ *   onSearch={(keyword) => {
+ *     const filtered = data.filter(item => item.name.includes(keyword));
+ *     setFilteredData(filtered);
+ *   }}
+ * />
+ *
+ * // 切换为 Input 模式
+ * <PisellFind
+ *   triggerType="input"
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;