@pisell/materials 1.0.1023 → 1.8.1

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/pisellEmpty/index.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EmptyProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellEmptyProps extends EmptyProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /** 额外内容描述 */
+    extraDescription?: React.ReactNode;
+    /** 额外内容描述 */
+    icon?: React.ReactNode;
+    /** 自定义底部额外操作区域 */
+    footer?: React.ReactNode;
+    [key: string]: any;
+    /** 最大宽度 */
+    maxWidth?: number;
+}
+declare const PisellEmpty: (props: PisellEmptyProps) => React.JSX.Element;
+export default PisellEmpty;

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

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

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

@@ -0,0 +1,50 @@
+import React from 'react';
+import './index.less';
+interface ApplicableProductDetails {
+    amount: string;
+    type: string;
+    resource_id: number;
+    title: string;
+    original_amount: string;
+}
+interface Discount {
+    id: number;
+    product_name: string;
+    encoded: string;
+    code: string;
+    tag: string;
+    expire_time?: string;
+    product_id: number;
+    relation_type: string;
+    par_value: string;
+    used_par_value: string;
+    limit_status: string;
+    limited_relation_product_data: any;
+    balance: string;
+    format_title: any;
+    product: any;
+    savedAmount: number;
+    isDisabled: boolean;
+    isSelected?: boolean;
+    isAvailable?: boolean;
+    isUsed?: boolean;
+    applicableProductIds?: number[];
+    applicableProductDetails: ApplicableProductDetails[];
+    appliedProductDetails: any[];
+}
+export interface PisellGoodPassCardProps {
+    /**数据源 */
+    dataSource: Array<Discount>;
+    /**事件 */
+    onChange?: (current: {
+        id: string | number;
+        isSelected: boolean;
+    }) => void;
+    /**样式 */
+    style: React.CSSProperties;
+    /**快捷展示排序 */
+    mixedSort?: (val: Discount[]) => Discount[];
+    isInModal: boolean;
+}
+declare const index: (props: PisellGoodPassCardProps) => React.JSX.Element;
+export default index;

package/es/components/pisellGoodPassCard/index.less

@@ -29,6 +29,7 @@
     }
 
     .item-content {
+      color: var(--, #8157d5);
       font-size: 16px;
       font-style: normal;
       font-weight: 400;

package/es/components/pisellInformationEntry/Input/index.d.ts

@@ -4,5 +4,5 @@ export interface PisellEntryInputProps {
     onChange: (val: string) => void;
     searchDescribe?: React.ReactNode;
 }
-declare const PisellEntryInput: (props: PisellEntryInputProps) => JSX.Element;
+declare const PisellEntryInput: (props: PisellEntryInputProps) => React.JSX.Element;
 export default PisellEntryInput;

package/es/components/pisellInformationEntry/Scan/index.d.ts

@@ -1,8 +1,8 @@
-/// <reference types="react" />
+import React from 'react';
 import './index.less';
 export interface ScanProps {
     onChange: (val: string) => void;
     onCancel: () => void;
 }
-declare const Scan: (props: ScanProps) => JSX.Element;
+declare const Scan: (props: ScanProps) => React.JSX.Element;
 export default Scan;

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

@@ -29,5 +29,5 @@ export interface PisellInformationEntryProps extends Omit<React.HTMLAttributes<H
     /** 录入类型切换时候触发的 */
     onChangeType?: (val: null | EntryModeType['type']) => void;
 }
-declare const PisellInformationEntry: (props: PisellInformationEntryProps) => JSX.Element;
+declare const PisellInformationEntry: (props: PisellInformationEntryProps) => React.JSX.Element;
 export default PisellInformationEntry;

package/es/components/pisellInput/components/BankCard/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { InputProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 import './index.less';
@@ -6,5 +7,5 @@ export declare type BankCardProps = InputProps & {
     platform?: PisellContextType['platform'];
     onChange?: (val: string) => void;
 };
-declare const BankCard: (props: BankCardProps) => JSX.Element;
+declare const BankCard: (props: BankCardProps) => React.JSX.Element;
 export default BankCard;

package/es/components/pisellInput/components/Copy/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {
@@ -6,5 +7,5 @@ export interface CopyProps extends InputProps {
     /** 后缀button的透传配置 */
     buttonProps?: ButtonProps;
 }
-declare const Copy: (props: CopyProps) => JSX.Element;
+declare const Copy: (props: CopyProps) => React.JSX.Element;
 export default Copy;

package/es/components/pisellInput/components/SecurityCode/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { InputProps } from 'antd';
 import './index.less';
 import { PisellContextType } from "../../../pisell-config-provider/context";
@@ -7,5 +8,5 @@ export interface SecurityCodeProps extends Omit<InputProps, 'onChange'> {
     onChange?: (val: string) => void;
     showCVCIcon?: boolean;
 }
-declare const SecurityCode: (props: SecurityCodeProps) => JSX.Element;
+declare const SecurityCode: (props: SecurityCodeProps) => React.JSX.Element;
 export default SecurityCode;

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

@@ -1,13 +1,13 @@
-/// <reference types="react" />
+import React from 'react';
 import { InputProps } from 'antd';
 import { PisellContextType } from '../pisell-config-provider/context';
 declare const PisellInput: {
     (props: InputProps & {
         /** 平台 */
         platform?: PisellContextType['platform'];
-    }): JSX.Element;
-    BankCard: (props: import("./components/BankCard").BankCardProps) => JSX.Element;
-    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => JSX.Element;
-    Copy: (props: import("./components/Copy").CopyProps) => JSX.Element;
+    }): React.JSX.Element;
+    BankCard: (props: import("./components/BankCard").BankCardProps) => React.JSX.Element;
+    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => React.JSX.Element;
+    Copy: (props: import("./components/Copy").CopyProps) => React.JSX.Element;
 };
 export default PisellInput;

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

@@ -0,0 +1,14 @@
+import type { LayoutProps } from 'antd';
+import { Layout } from 'antd';
+import React from 'react';
+export interface PisellLayoutProps extends LayoutProps {
+    children?: React.ReactNode;
+}
+export interface CompoundedComponent extends React.FC<PisellLayoutProps> {
+    Header: typeof Layout.Header;
+    Content: typeof Layout.Content;
+    Footer: typeof Layout.Footer;
+    Sider: typeof Layout.Sider;
+}
+declare const PisellLayout: CompoundedComponent;
+export default PisellLayout;

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

@@ -1,3 +1,4 @@
+import React from 'react';
 import { SpinProps } from 'antd';
 import './index.less';
 declare type MaskType = {
@@ -15,5 +16,5 @@ export interface PisellLoadingProps extends SpinProps {
     /** 延迟显示加载效果的时间（防止闪烁）	 */
     delay?: number;
 }
-declare const PisellLoading: (props: PisellLoadingProps) => JSX.Element;
+declare const PisellLoading: (props: PisellLoadingProps) => React.JSX.Element;
 export default PisellLoading;

package/es/components/pisellLongText/PisellLongText.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { PisellLongTextProps } from './types';
+import './PisellLongText.less';
+/**
+ * PisellLongText 长文本/多行文本组件
+ *
+ * 多行文本输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design TextArea 组件开发，提供展开/折叠功能和完整的校验框架。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态
+ * <PisellLongText
+ *   placeholder="请输入内容"
+ *   rows={3}
+ *   maxLength={500}
+ *   showCount
+ * />
+ *
+ * @example
+ * // 只读态（展开折叠）
+ * <PisellLongText
+ *   mode="read"
+ *   value={longText}
+ *   maxLines={3}
+ *   enableExpand
+ * />
+ *
+ * @example
+ * // 自动高度
+ * <PisellLongText
+ *   autoSize={{ minRows: 3, maxRows: 10 }}
+ *   placeholder="自动调整高度"
+ * />
+ */
+export declare const PisellLongText: React.FC<PisellLongTextProps>;
+declare const _default: React.NamedExoticComponent<PisellLongTextProps>;
+export default _default;

package/es/components/pisellLongText/PisellLongText.stories.d.ts

@@ -0,0 +1,123 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellLongText } from './PisellLongText';
+/**
+ * PisellLongText 是一个多行文本输入/展示组件。
+ *
+ * ## 功能特性
+ * - 支持三种状态：只读、编辑、禁用
+ * - 展开/折叠功能（只读态）
+ * - 自动高度调整
+ * - 完整的校验框架
+ * - 字数统计
+ */
+declare const meta: Meta<typeof PisellLongText>;
+export default meta;
+declare type Story = StoryObj<typeof PisellLongText>;
+/**
+ * 基础编辑态示例
+ */
+export declare const Basic: Story;
+/**
+ * 只读态示例 - 短文本
+ */
+export declare const ReadMode: Story;
+/**
+ * 只读态 - 展开/折叠功能（核心）
+ */
+export declare const ReadModeExpandCollapse: Story;
+/**
+ * 只读态 - 自定义展开/收起文案
+ */
+export declare const ReadModeCustomExpandText: Story;
+/**
+ * 只读态 - 禁用展开功能
+ */
+export declare const ReadModeDisableExpand: Story;
+/**
+ * 只读态 - 字数统计
+ */
+export declare const ReadModeWithWordCount: Story;
+/**
+ * 只读态 - 展开 + 字数统计
+ */
+export declare const ReadModeExpandAndWordCount: Story;
+/**
+ * 禁用态示例
+ */
+export declare const Disabled: Story;
+/**
+ * 编辑态 - 默认行数
+ */
+export declare const EditModeCustomRows: Story;
+/**
+ * 编辑态 - 自动高度（boolean）
+ */
+export declare const EditModeAutoSize: Story;
+/**
+ * 编辑态 - 自动高度（范围限定）
+ */
+export declare const EditModeAutoSizeRange: Story;
+/**
+ * 编辑态 - minRows 和 maxRows
+ */
+export declare const EditModeMinMaxRows: Story;
+/**
+ * 编辑态 - 字数统计
+ */
+export declare const EditModeWithCount: Story;
+/**
+ * 编辑态 - 清空按钮
+ */
+export declare const EditModeWithClear: Story;
+/**
+ * 必填校验
+ */
+export declare const Required: Story;
+/**
+ * 长度校验
+ */
+export declare const LengthValidation: Story;
+/**
+ * 自定义校验 - 段落数量限制
+ */
+export declare const CustomValidatorParagraphs: Story;
+/**
+ * 组合校验
+ */
+export declare const CombinedValidation: Story;
+/**
+ * 自动高度 + 字数统计
+ */
+export declare const AutoSizeWithCount: Story;
+/**
+ * 保留换行和空格
+ */
+export declare const PreserveWhitespace: Story;
+/**
+ * 自定义样式（只读态）
+ */
+export declare const CustomStyle: Story;
+/**
+ * 完整功能示例
+ */
+export declare const FullFeatures: Story;
+/**
+ * 所有展开/折叠场景对比
+ */
+export declare const AllExpandScenarios: Story;
+/**
+ * 所有自动高度场景对比
+ */
+export declare const AllAutoSizeScenarios: Story;
+/**
+ * 校验场景对比
+ */
+export declare const ValidationScenarios: Story;
+/**
+ * 边界情况测试
+ */
+export declare const EdgeCases: Story;
+/**
+ * 完整功能演示
+ */
+export declare const CompleteExample: Story;