@pisell/materials 1.0.1086 → 1.0.1087

package/lib/components/pisellImport/types.d.ts

@@ -0,0 +1,85 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 展示形态
+ * @description icon：仅图标；button：图标 + 文案
+ */
+export declare type VariantType = 'icon' | 'button';
+/**
+ * 尺寸
+ * @description 小、中、大三种尺寸，对应设计稿 padding 与字体
+ */
+export declare type SizeType = 'small' | 'medium' | 'large';
+/**
+ * 视觉类型
+ * @description default：默认边框/灰字；primary：主色描边或填充
+ */
+export declare type ImportButtonType = 'default' | 'primary';
+/**
+ * PisellImport 组件 Props
+ * @description 导入触发器 UI 组件，仅负责展示与点击回调，不内置导入逻辑
+ */
+export interface PisellImportProps {
+    /**
+     * 展示形态
+     * @default 'button'
+     */
+    variant?: VariantType;
+    /**
+     * 尺寸
+     * @default 'medium'
+     */
+    size?: SizeType;
+    /**
+     * 视觉类型（默认样式 / 主色样式）
+     * @default 'default'
+     */
+    type?: ImportButtonType;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Button 形态下的文案，不传时使用国际化默认文案
+     */
+    label?: ReactNode;
+    /**
+     * 自定义图标，不传时使用内置上传/导入图标
+     */
+    icon?: ReactNode;
+    /**
+     * 接受的文件类型
+     * @description 与 input[type=file] 的 accept 一致，如 ".xlsx,.csv" 或 "application/vnd.ms-excel"
+     */
+    accept?: string;
+    /**
+     * 是否允许多选
+     * @default false
+     */
+    multiple?: boolean;
+    /**
+     * 单文件最大体积（MB），超出时不会调用 onImport，并调用 onError
+     */
+    maxSize?: number;
+    /**
+     * 选择文件并校验通过后回调
+     * @description 用户选择文件后触发，e 为 input 的 change 事件
+     */
+    onImport?: (files: File[], e: React.ChangeEvent<HTMLInputElement>) => void;
+    /**
+     * 校验失败时回调（如文件过大）
+     */
+    onError?: (error: {
+        type: 'MAX_SIZE';
+        message: string;
+        file: File;
+    }) => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+}

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 export interface ScanProps {
     onChange: (val: string) => void;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 import './index.less';

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from 'antd';
 import './index.less';
 import { PisellContextType } from "../../../pisell-config-provider/context";

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from '../pisell-config-provider/context';
 declare const PisellInput: {

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { SpinProps } from 'antd';
 import './index.less';
 declare type MaskType = {

package/lib/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/lib/components/pisellLookup/components/LookupTrigger.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { LookupTriggerProps, LookupTriggerRef } from '../types';
+export declare const LookupTrigger: React.ForwardRefExoticComponent<LookupTriggerProps & React.RefAttributes<LookupTriggerRef>>;

package/lib/components/pisellModal/components/IpadModal/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PcModalProps } from '../PcModal';
 export interface IpadModalProps extends PcModalProps {
 }

package/lib/components/pisellModal/components/MobileModal/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { PcModalProps } from '../PcModal';
 import './index.less';
 export interface MobileModalProps extends PcModalProps {

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import IpadModal from './IpadModal';
 import MobileModal from './MobileModal';
 import PcModal from './PcModal';

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

@@ -0,0 +1,62 @@
+import React from 'react';
+import { ModalProps, ButtonProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+export interface PisellModalProps extends ModalProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /**
+     * 弹窗大小
+     * large 800
+     * middle 600
+     * small 400
+     * */
+    size?: 'large' | 'middle' | 'small';
+    /** 头部分割线是否展示 */
+    headerDivider?: boolean;
+    /** 底部分割线是否展示 */
+    footerDivider?: boolean;
+    /** 删除按钮props */
+    deleteButtonProps?: ButtonProps | null;
+    /** 删除事件 */
+    onDelete?: () => void;
+    /** 移动端展示时弹窗高度 默认null 在移动端全屏 */
+    mobileModalHeight?: string | number;
+    /** footer中额外操作按钮 */
+    actions?: React.ReactNode;
+    /** 取消按钮是否展示 */
+    cancelVisible?: boolean;
+    /** 确认按钮是否展示 */
+    okVisible?: boolean;
+    /** 是否展示header */
+    header?: boolean | null;
+    /**
+     * 透传至底层 Dialog 遮罩（antd Modal 运行时支持，但 ModalProps 类型未声明）
+     */
+    maskProps?: React.HTMLAttributes<HTMLDivElement>;
+}
+declare const PisellModal: {
+    (props: PisellModalProps): JSX.Element;
+    confirm: (props: import("./components/functions").PisellModalFuncProps) => {
+        destroy: () => void;
+        update: (configUpdate: import("antd").ModalFuncProps | ((prevConfig: import("antd").ModalFuncProps) => import("antd").ModalFuncProps)) => void;
+    };
+    info: (props: import("./components/functions").PisellModalFuncProps) => {
+        destroy: () => void;
+        update: (configUpdate: import("antd").ModalFuncProps | ((prevConfig: import("antd").ModalFuncProps) => import("antd").ModalFuncProps)) => void;
+    };
+    error: (props: import("./components/functions").PisellModalFuncProps) => {
+        destroy: () => void;
+        update: (configUpdate: import("antd").ModalFuncProps | ((prevConfig: import("antd").ModalFuncProps) => import("antd").ModalFuncProps)) => void;
+    };
+    warn: (props: import("./components/functions").PisellModalFuncProps) => any;
+    warning: (props: import("./components/functions").PisellModalFuncProps) => {
+        destroy: () => void;
+        update: (configUpdate: import("antd").ModalFuncProps | ((prevConfig: import("antd").ModalFuncProps) => import("antd").ModalFuncProps)) => void;
+    };
+    success: (props: import("./components/functions").PisellModalFuncProps) => {
+        destroy: () => void;
+        update: (configUpdate: import("antd").ModalFuncProps | ((prevConfig: import("antd").ModalFuncProps) => import("antd").ModalFuncProps)) => void;
+    };
+    Information: (props: import("./components/Information").InformationProps) => JSX.Element;
+};
+export default PisellModal;

package/lib/components/pisellMultipleSelect/PisellMultipleSelect.d.ts

@@ -0,0 +1,9 @@
+/**
+ * PisellMultipleSelect - 多选下拉组件
+ * 基于 Ant Design Select 封装，提供符合 Pisell 设计规范的多选功能
+ */
+import React from 'react';
+import type { PisellMultipleSelectProps, MultipleSelectRef } from './types';
+import './PisellMultipleSelect.less';
+declare const PisellMultipleSelect: React.ForwardRefExoticComponent<PisellMultipleSelectProps<string | number> & React.RefAttributes<MultipleSelectRef<string | number>>>;
+export default PisellMultipleSelect;

package/lib/components/pisellMultipleSelect/components/EditView.d.ts

@@ -0,0 +1,8 @@
+/**
+ * PisellMultipleSelect - EditView (编辑态视图)
+ * 正常可编辑状态下的渲染
+ */
+import React from 'react';
+import type { EditViewProps } from '../types';
+declare const EditView: React.ForwardRefExoticComponent<EditViewProps<string | number> & React.RefAttributes<any>>;
+export default EditView;

package/lib/components/pisellNavigationMenu/PisellNavigationMenu.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { PisellNavigationMenuProps } from './types';
+import './PisellNavigationMenu.less';
+declare const PisellNavigationMenu: React.FC<PisellNavigationMenuProps>;
+export default PisellNavigationMenu;

package/lib/components/pisellNumber/PisellNumber.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import type { PisellNumberProps } from './types';
+import './PisellNumber.less';
+/**
+ * PisellNumber 数值组件
+ *
+ * 通用的数值输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design InputNumber 组件开发，提供完整的校验框架。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 受控模式
+ * const [value, setValue] = useState(0);
+ * <PisellNumber
+ *   value={value}
+ *   onChange={setValue}
+ *   min={0}
+ *   max={100}
+ * />
+ *
+ * @example
+ * // 非受控模式
+ * <PisellNumber
+ *   defaultValue={10}
+ *   min={0}
+ *   max={999}
+ *   step={10}
+ * />
+ *
+ * @example
+ * // 只读态
+ * <PisellNumber
+ *   mode="read"
+ *   value={1234.567}
+ *   precision={2}
+ *   useGrouping
+ * />
+ */
+export declare const PisellNumber: React.FC<PisellNumberProps>;
+declare const MemoizedPisellNumber: React.NamedExoticComponent<PisellNumberProps>;
+export default MemoizedPisellNumber;

package/lib/components/pisellPhone/PisellPhone.d.ts

@@ -0,0 +1,36 @@
+import React from 'react';
+import type { PisellPhoneProps } from './types';
+import './PisellPhone.less';
+/**
+ * PisellPhone 电话号码组件
+ *
+ * 电话号码输入/展示组件，支持只读、编辑、禁用三种状态。
+ * 基于 Ant Design Input 和 Select 组件开发，提供国家码选择、自动格式化、格式校验和拨号功能。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 编辑态（中国手机号）
+ * <PisellPhone
+ *   placeholder="请输入手机号"
+ *   required
+ * />
+ *
+ * @example
+ * // 只读态（可拨号）
+ * <PisellPhone
+ *   mode="read"
+ *   value="13800000000"
+ *   countryCode="+86"
+ * />
+ *
+ * @example
+ * // 国家码选择
+ * <PisellPhone
+ *   showCountrySelector
+ *   availableCountryCodes={['+86', '+1', '+44']}
+ * />
+ */
+export declare const PisellPhone: React.FC<PisellPhoneProps>;
+declare const _default: React.NamedExoticComponent<PisellPhoneProps>;
+export default _default;

package/lib/components/pisellPhone/components/EditView.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { PisellPhoneProps } from '../types';
+/**
+ * PisellPhone 编辑态视图组件
+ *
+ * 负责渲染编辑态的电话号码输入，包含国家码选择器和号码输入框
+ *
+ * 功能：
+ * - 国家码选择器（下拉，支持搜索）
+ * - 电话号码输入（只保留数字）
+ * - 自动格式化（根据国家码）
+ * - 动态设置最大长度（根据国家码）
+ * - 实时或失焦校验
+ * - 错误提示展示
+ *
+ * @param props 组件 Props
+ */
+declare const EditView: React.FC<PisellPhoneProps>;
+export default EditView;

package/lib/components/pisellPhone/constants/countryCodes.d.ts

@@ -0,0 +1,21 @@
+import type { CountryCode } from '../types';
+/**
+ * 预设的国家码列表（24个常见国家）
+ * flag 使用正常文本（ISO 3166-1 alpha-2 两字母代码，如 CN、US）
+ *
+ * 包含：
+ * - 亚洲：中国、香港、澳门、台湾、日本、韩国、新加坡、马来西亚、泰国、印度
+ * - 欧洲：英国、法国、德国、意大利、西班牙、俄罗斯
+ * - 美洲：美国、加拿大、墨西哥、巴西
+ * - 大洋洲：澳大利亚、新西兰
+ * - 中东：阿联酋、沙特阿拉伯
+ */
+export declare const PRESET_COUNTRY_CODES: CountryCode[];
+/**
+ * 默认国家码
+ */
+export declare const DEFAULT_COUNTRY_CODE = "+86";
+/**
+ * 常用国家码（可作为默认的 commonCountryCodes）
+ */
+export declare const COMMON_COUNTRY_CODES: string[];

package/lib/components/pisellPhone/types.d.ts

@@ -0,0 +1,209 @@
+import type { CSSProperties } from 'react';
+import type { BaseTextInputProps } from '@pisell/utils';
+/**
+ * 国家码配置类型
+ */
+export interface CountryCode {
+    /**
+     * 国家码
+     * @example '+86', '+1', '+44'
+     */
+    code: string;
+    /**
+     * 国家名称
+     * @example '中国', '美国', '英国'
+     */
+    name: string;
+    /**
+     * 国家/地区展示用标识（正常文本，如 ISO 两字母代码 CN、US）
+     * @example 'CN', 'US', 'GB', 'HK'
+     */
+    flag: string;
+    /**
+     * 号码格式（可选，用于显示占位符）
+     * @example 'XXX XXXX XXXX', '(XXX) XXX-XXXX'
+     */
+    format?: string;
+    /**
+     * 最大长度
+     * @example 11 (中国), 10 (美国)
+     */
+    maxLength: number;
+    /**
+     * 校验正则
+     * @example /^1[3-9]\d{9}$/ (中国手机号)
+     */
+    pattern: RegExp;
+}
+/**
+ * PisellPhone 组件 Props 类型定义
+ *
+ * 继承 BaseTextInputProps，添加电话号码特有的配置
+ */
+export interface PisellPhoneProps extends BaseTextInputProps {
+    /**
+     * 状态模式
+     * @default 'edit'
+     */
+    mode?: 'read' | 'edit';
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * 当前选中的国家码
+     * @default '+86'
+     * @example '+86', '+1', '+44'
+     */
+    countryCode?: string;
+    /**
+     * 默认国家码（非受控模式）
+     * @default '+86'
+     */
+    defaultCountryCode?: string;
+    /**
+     * 是否显示国家码选择器
+     * @default true
+     */
+    showCountrySelector?: boolean;
+    /**
+     * 可用的国家码列表（从预设24个中过滤）
+     * @example ['+86', '+1', '+44']
+     */
+    availableCountryCodes?: string[];
+    /**
+     * 常用国家码（置顶显示）
+     * @example ['+86', '+1']
+     */
+    commonCountryCodes?: string[];
+    /**
+     * 完全自定义国家码列表（覆盖预设）
+     */
+    countryCodes?: CountryCode[];
+    /**
+     * 国家码变更回调
+     * @param code 新的国家码
+     */
+    onCountryCodeChange?: (code: string) => void;
+    /**
+     * 是否自动格式化
+     * @default true
+     */
+    autoFormat?: boolean;
+    /**
+     * 格式化规则
+     * @default 'auto'
+     */
+    formatRule?: 'mobile' | 'landline' | 'auto';
+    /**
+     * 格式化分隔符
+     * @default ' '
+     */
+    separator?: string;
+    /**
+     * 是否启用拨号（移动端）
+     * @default true
+     */
+    enableDial?: boolean;
+    /**
+     * 是否显示拨号图标
+     * @default false
+     */
+    showDialIcon?: boolean;
+    /**
+     * 拨号回调
+     * @param phone 完整的电话号码（含国家码）
+     */
+    onDial?: (phone: string) => void;
+    /**
+     * 是否脱敏显示（只读态）
+     * @default false
+     */
+    enableMasking?: boolean;
+    /**
+     * 脱敏模式
+     * - middle: 中间4位脱敏（138****0000）
+     * - last: 后4位脱敏（1380000****）
+     * - custom: 使用自定义函数
+     * @default 'middle'
+     */
+    maskPattern?: 'middle' | 'last' | 'custom';
+    /**
+     * 自定义脱敏函数
+     * @param phone 电话号码
+     * @returns 脱敏后的号码
+     */
+    customMask?: (phone: string) => string;
+    /**
+     * 是否显示国旗图标
+     * @default true
+     */
+    showFlag?: boolean;
+    /**
+     * 字号
+     * @example '14px' 或 14
+     * @default 16
+     */
+    fontSize?: string | number;
+    /**
+     * 字重
+     * @example 'bold' 或 600
+     * @default 500
+     */
+    fontWeight?: string | number;
+    /**
+     * 文本颜色
+     * @example '#000000'
+     * @default '#101828'
+     */
+    color?: string;
+    /**
+     * 占位文本
+     * @default '请输入电话号码'
+     */
+    placeholder?: string;
+    /**
+     * 最大长度（根据国家码自动设置）
+     */
+    maxLength?: number;
+    /**
+     * 是否显示清空按钮
+     * @default false
+     */
+    allowClear?: boolean;
+    /**
+     * 是否自动聚焦
+     * @default false
+     */
+    autoFocus?: boolean;
+    /**
+     * 是否校验格式
+     * @default true
+     */
+    validateFormat?: boolean;
+    /**
+     * 自定义校验函数
+     * @param phone 电话号码（纯数字）
+     * @param countryCode 国家码
+     * @returns true 表示校验通过，string 表示错误信息
+     */
+    customValidator?: (phone: string, countryCode: string) => boolean | string;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * ARIA 标签
+     */
+    'aria-label'?: string;
+    /**
+     * ARIA 描述
+     */
+    'aria-describedby'?: string;
+}
+export type { DisplayState, ValidationResult, TextInputState } from '@pisell/utils';

package/lib/components/pisellPhone/utils/countryCodeHelper.d.ts

@@ -0,0 +1,35 @@
+import type { CountryCode, PisellPhoneProps } from '../types';
+/**
+ * 根据国家码获取国家/地区展示标识（正常文本，如 CN、US）
+ * @param countryCode 国家码
+ * @returns 展示用标识，未匹配时返回 '--'
+ */
+export declare function getCountryFlag(countryCode: string): string;
+/**
+ * 根据国家码获取最大长度（数字位数）
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 最大长度（如中国 11 位数字）
+ */
+export declare function getMaxLength(countryCode: string, countryCodes: CountryCode[]): number;
+/**
+ * 根据国家码获取配置
+ * @param countryCode 国家码
+ * @param countryCodes 国家码列表
+ * @returns 国家码配置
+ */
+export declare function getCountryConfig(countryCode: string, countryCodes: CountryCode[]): CountryCode | undefined;
+/**
+ * 获取最终的国家码列表
+ *
+ * 优先级：
+ * 1. props.countryCodes（完全自定义）
+ * 2. props.availableCountryCodes（从预设中过滤）
+ * 3. PRESET_COUNTRY_CODES（默认全部24个）
+ *
+ * 然后根据 props.commonCountryCodes 排序（置顶）
+ *
+ * @param props 组件 Props
+ * @returns 国家码列表
+ */
+export declare function getCountryCodes(props: PisellPhoneProps): CountryCode[];

package/lib/components/pisellRating/PisellRating.d.ts

@@ -0,0 +1,31 @@
+import React from 'react';
+import type { PisellRatingProps } from './types';
+import './PisellRating.less';
+/**
+ * PisellRating 评分组件
+ *
+ * 基于 Ant Design Rate 组件开发，提供直观的星级评分交互。
+ * 支持只读、编辑、禁用三种状态。
+ *
+ * @param props 组件 Props
+ *
+ * @example
+ * // 基础使用
+ * const [rating, setRating] = useState(0);
+ * <PisellRating value={rating} onChange={setRating} />
+ *
+ * @example
+ * // 只读态
+ * <PisellRating mode="read" value={4.5} allowHalf />
+ *
+ * @example
+ * // 带评分描述
+ * <PisellRating
+ *   value={rating}
+ *   onChange={setRating}
+ *   tooltips={['很差', '差', '一般', '好', '很好']}
+ * />
+ */
+export declare const PisellRating: React.FC<PisellRatingProps>;
+declare const _default: React.NamedExoticComponent<PisellRatingProps>;
+export default _default;