@pisell/materials 6.11.1 → 6.11.3

package/lib/components/pisellDataSourceContainer/type.d.ts

@@ -1,84 +0,0 @@
-import { DataSourceContextProps, DataSourceContextType } from '../dataSourceComponents/provider/dataSource/DataSourceContext';
-import { Result } from 'ahooks/es/useRequest/src/types';
-import { TableProps as AntdTableProps, PaginationProps, TabsProps as AntdTabsProps, FormInstance as AntdFormInstance } from 'antd';
-import { SortListProps } from '../sort/types';
-import { FilterItemProps } from '../filter/types';
-import { FilterListProps } from '../filter/components/FilterButton/types';
-/**
- * 子组件属性集合类型定义
- */
-export interface ChildComponentPropsType {
-    /** Filter 组件属性 */
-    filterComponent?: {
-        value: {
-            quickFilter?: FilterItemProps[];
-            otherFilter?: FilterItemProps[];
-        };
-        formFiltersPrefix?: string;
-        quickFilterMaxLength?: number;
-    };
-    /** QuickFilter 组件属性 */
-    quickFilterComponent?: {
-        filterList: FilterItemProps[];
-        formFiltersPrefix?: string;
-    };
-    /** FilterButton 组件属性 */
-    filterButtonComponent?: FilterListProps;
-    /** tabsComponent 组件属性 */
-    tabsComponent?: {
-        items: AntdTabsProps['items'];
-        type?: 'default' | 'button' | 'buttonGroup' | 'dropdown';
-    };
-    /** Sort 组件属性 */
-    sortComponent?: SortListProps;
-    /** Table 组件属性 */
-    tableComponent?: AntdTableProps<any>;
-    /** ColumnsSetting 组件属性 */
-    columnsSettingComponent?: {
-        value?: Record<string, any>[];
-        onChange?: (val: Record<string, any>[]) => void;
-    };
-    /** Pagination 组件属性 */
-    paginationComponent?: PaginationProps;
-}
-export interface DataSourceContainerProps extends DataSourceContextProps {
-    pagination?: boolean | {
-        pageNumber: number;
-        pageSize: number;
-    };
-    childComponentProps?: ChildComponentPropsType;
-}
-/**
- * 扩展的 HandleActionContextType
- */
-export interface HandleActionContextType extends Omit<DataSourceContextType, 'list'> {
-    list: Result<any, any> & {
-        onSearch: (newParams?: Record<string, any>) => void;
-        onReset: () => void;
-        onPageChange: (pageNumber: number, pageSize: number) => void;
-        pagination?: {
-            pageNumber: number;
-            pageSize: number;
-        };
-    };
-}
-export interface RefManagerContextType {
-    getRef: <T = any>(id: string) => T | undefined;
-    registerRef: <T = any>(id: string, ref: T) => void;
-    unregisterRef: (id: string) => void;
-    getSharedState: <T = any>(key: string) => T | undefined;
-    setSharedState: <T = any>(key: string, value: T) => void;
-    subscribeSharedState: <T = any>(key: string, callback: (value: T) => void) => () => void;
-}
-export interface DataSourceContainerContextType {
-    serverActions: HandleActionContextType;
-    refManager: RefManagerContextType;
-    form: AntdFormInstance;
-}
-export interface UseContainerContextReturnType {
-    serverActions: HandleActionContextType;
-    refManager: RefManagerContextType;
-    form: AntdFormInstance;
-    onValuesChange: (changedValues: Record<string, any>, allValues: Record<string, any>) => void;
-    [key: string]: any;
-}

package/lib/components/pisellDataSourceContainer/utils/formatData.d.ts

@@ -1,9 +0,0 @@
-declare const formatListResult: (result: any) => {
-    list: any;
-    count: any;
-};
-declare const formatListParams: (params: any) => {
-    page: any;
-    pageSize: any;
-};
-export { formatListParams, formatListResult };

package/lib/components/pisellDataSourceContainer/utils/withContainer.d.ts

@@ -1,9 +0,0 @@
-import React, { ComponentType } from 'react';
-import { UseContainerContextReturnType } from '../type';
-/**
- * 支持自定义 ID 的组件 Props
- */
-declare function withContainer<P extends object, R = any>(WrappedComponent: ComponentType<P & UseContainerContextReturnType>, displayName: string): React.ForwardRefExoticComponent<React.PropsWithoutRef<P & {
-    refId?: string | undefined;
-}> & React.RefAttributes<R>>;
-export default withContainer;

package/lib/components/pisellEmail/PisellEmail.stories.d.ts

@@ -1,116 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellEmail } from './PisellEmail';
-/**
- * PisellEmail 是一个邮箱地址输入/展示组件。
- *
- * ## 功能特性
- * - 支持三种状态：只读、编辑、禁用
- * - 邮箱格式校验（标准/严格）
- * - 域名智能补全
- * - mailto 邮件发送
- * - 域名隐藏/脱敏
- * - 白名单/黑名单域名限制
- */
-declare const meta: Meta<typeof PisellEmail>;
-export default meta;
-declare type Story = StoryObj<typeof PisellEmail>;
-/**
- * 基础编辑态
- */
-export declare const Basic: Story;
-/**
- * 域名智能补全
- */
-export declare const WithAutoComplete: Story;
-/**
- * 自定义补全域名
- */
-export declare const CustomDomains: Story;
-/**
- * 只读态 - 可发邮件
- */
-export declare const ReadMode: Story;
-/**
- * 只读态 - 带邮件图标
- */
-export declare const ReadModeWithIcon: Story;
-/**
- * 只读态 - 域名部分隐藏
- */
-export declare const ReadModePartialMask: Story;
-/**
- * 只读态 - 域名完全隐藏
- */
-export declare const ReadModeFullMask: Story;
-/**
- * 禁用态（编辑）
- */
-export declare const DisabledEdit: Story;
-/**
- * 禁用态（只读）
- */
-export declare const DisabledRead: Story;
-/**
- * 必填校验
- */
-export declare const Required: Story;
-/**
- * 格式校验（实时）
- */
-export declare const FormatValidation: Story;
-/**
- * 严格格式校验
- */
-export declare const StrictValidation: Story;
-/**
- * 白名单域名限制
- */
-export declare const AllowedDomains: Story;
-/**
- * 黑名单域名限制
- */
-export declare const BlockedDomains: Story;
-/**
- * 显示清空按钮
- */
-export declare const WithClearButton: Story;
-/**
- * 自动聚焦
- */
-export declare const WithAutoFocus: Story;
-/**
- * 自定义样式（只读态）
- */
-export declare const CustomStyle: Story;
-/**
- * 脱敏模式对比
- */
-export declare const MaskingComparison: Story;
-/**
- * 校验时机对比
- */
-export declare const ValidateTriggerComparison: Story;
-/**
- * 完整功能示例
- */
-export declare const CompleteExample: Story;
-/**
- * 域名补全演示
- */
-export declare const AutoCompleteDemo: Story;
-/**
- * mailto 功能演示
- */
-export declare const MailtoDemo: Story;
-/**
- * 白名单/黑名单演示
- */
-export declare const DomainRestrictionDemo: Story;
-/**
- * 所有状态展示
- */
-export declare const AllStates: Story;
-/**
- * 完整交互示例
- */
-export declare const InteractiveExample: Story;

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

@@ -1,14 +0,0 @@
-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/lib/components/pisellEmail/components/ReadOnlyView.d.ts

@@ -1,15 +0,0 @@
-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/constants/emailDomains.d.ts

@@ -1,5 +0,0 @@
-/**
- * 常用邮箱域名列表
- * 用于域名自动补全功能
- */
-export declare const COMMON_EMAIL_DOMAINS: string[];

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

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

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

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

package/lib/components/pisellEmail/utils/domainSuggestions.d.ts

@@ -1,15 +0,0 @@
-/**
- * 域名补全工具函数（框架占位符）
- * 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/lib/components/pisellEmail/utils/emailHelper.d.ts

@@ -1,66 +0,0 @@
-/**
- * 邮箱辅助函数
- */
-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/lib/components/pisellEmail/utils/emailValidator.d.ts

@@ -1,45 +0,0 @@
-/**
- * 邮箱校验工具函数
- */
-/**
- * 标准邮箱格式校验
- * @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/lib/components/pisellEmail/utils/index.d.ts

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

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

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

package/lib/components/pisellFilter/type.d.ts

@@ -1,5 +0,0 @@
-import { FilterListProps } from '../filter/components/FilterButton/types';
-import { FormInstance } from 'antd';
-export declare type PisellFilterProps = FilterListProps & FormInstance & {
-    hasForm?: boolean;
-};

package/lib/components/pisellGridPro/GridPro.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import './index.less';
-export interface GridProProps {
-    className?: string;
-    children?: React.ReactNode;
-    style?: React.CSSProperties;
-}
-declare const PisellGridPro: (props: GridProProps) => JSX.Element;
-export default PisellGridPro;

package/lib/components/pisellGridPro/GridView/index.d.ts

@@ -1,5 +0,0 @@
-import './index.less';
-import { GridViewProps } from './type';
-export type { GridViewProps };
-declare const GridView: (props: GridViewProps) => JSX.Element;
-export default GridView;

package/lib/components/pisellGridPro/GridView/type.d.ts

@@ -1,3 +0,0 @@
-import { PisellScrollViewProps } from '../../PisellScrollView/types';
-export interface GridViewProps extends PisellScrollViewProps {
-}

package/lib/components/pisellGridPro/ToolBar/index.d.ts

@@ -1,6 +0,0 @@
-import React from 'react';
-import './index.less';
-import { ToolBarProps } from './type';
-export type { ToolBarProps };
-declare const Toolbar: React.FC<ToolBarProps>;
-export default Toolbar;

package/lib/components/pisellGridPro/ToolBar/type.d.ts

@@ -1,10 +0,0 @@
-/// <reference types="react" />
-export interface ToolBarProps {
-    className?: string;
-    style?: React.CSSProperties;
-    tabs?: React.ReactNode;
-    topLeft?: React.ReactNode;
-    topRight?: React.ReactNode;
-    bottomLeft?: React.ReactNode;
-    bottomRight?: React.ReactNode;
-}

package/lib/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-import { StatCardItem } from '../../types';
-import './index.less';
-/**
- * StatCard 统计卡片组件
- * @description 用于展示单个统计数据，包含标题、数值和对比信息
- * @author Pisell Team
- */
-declare const StatCard: React.FC<StatCardItem>;
-export default StatCard;

package/lib/components/pisellGridPro/components/DataCard/index.d.ts

@@ -1,5 +0,0 @@
-import { DataCardProps } from './types';
-export type { DataCardProps };
-import './index.less';
-declare const DataCard: (props: DataCardProps) => JSX.Element | null;
-export default DataCard;

package/lib/components/pisellGridPro/components/DataCard/types.d.ts

@@ -1,70 +0,0 @@
-import React from 'react';
-/**
- * PisellGridProDataCard 组件属性接口
- */
-export interface DataCardProps {
-    /**
-     * 统计卡片数据列表
-     */
-    dataItems?: StatCardItem[];
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: React.CSSProperties;
-}
-/**
- * 统计卡片数据项接口
- */
-export interface StatCardItem {
-    /**
-     * 唯一标识
-     */
-    key: string;
-    /**
-     * 卡片标题
-     * @example "Total Orders"
-     */
-    title: React.ReactNode;
-    /**
-     * 主要数值
-     * @example 50 或 "$1580"
-     */
-    value: React.ReactNode;
-    /**
-     * 对比数值
-     * @example "+12" 或 "-230"
-     */
-    compareValue?: React.ReactNode;
-    /**
-     * 对比趋势
-     * @description up-增长(绿色), down-下降(红色)
-     * @default undefined
-     */
-    trend?: 'up' | 'down';
-    /**
-     * 对比前缀文本
-     * @default "v.s. pre"
-     */
-    comparePrefix?: string;
-    /**
-     * 是否显示对比信息
-     * @default true
-     */
-    showCompare?: boolean;
-    /**
-     * 自定义卡片样式
-     */
-    style?: React.CSSProperties;
-    /**
-     * 自定义卡片类名
-     */
-    className?: string;
-    /**
-     * 点击回调
-     */
-    onClick?: () => void;
-}

package/lib/components/pisellGridPro/components/Footer/index.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import './index.less';
-export interface FooterProps {
-    className?: string;
-    children?: React.ReactNode;
-    style?: React.CSSProperties;
-}
-declare const Footer: (props: FooterProps) => JSX.Element;
-export default Footer;

package/lib/components/pisellGridPro/components/Header/index.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import './index.less';
-export interface HeaderProps {
-    title?: React.ReactNode;
-    badge?: React.ReactNode;
-    subTitle?: React.ReactNode;
-    actionsList?: React.ReactNode;
-    className?: string;
-    style?: React.CSSProperties;
-}
-declare const Header: React.FC<HeaderProps>;
-export default Header;

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

@@ -1,4 +0,0 @@
-import { GridProProps } from './GridPro';
-export type { GridProProps };
-declare const PisellGridPro: any;
-export default PisellGridPro;

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

@@ -1,14 +0,0 @@
-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;