@pisell/materials 3.3.89 → 3.3.90

package/lib/components/pisellLookup/utils/trigger.d.ts

@@ -1,42 +0,0 @@
-import type { DisplayType, TriggerType } from '../types';
-/**
- * 触发器相关工具函数
- */
-/**
- * 根据触发器类型获取默认的展示类型
- * @param triggerType 触发器类型
- * @param hasTrigger 是否有自定义触发器
- * @returns 默认的展示类型
- */
-export declare const getDefaultDisplayType: (triggerType?: TriggerType, hasTrigger?: boolean) => DisplayType;
-/**
- * 判断是否为输入框触发器
- * @param triggerType 触发器类型
- * @returns 是否为输入框触发器
- */
-export declare const isInputTrigger: (triggerType?: TriggerType) => boolean;
-/**
- * 判断是否为按钮类触发器（button、icon、text、自定义）
- * @param triggerType 触发器类型
- * @param hasTrigger 是否有自定义触发器
- * @returns 是否为按钮类触发器
- */
-export declare const isButtonLikeTrigger: (triggerType?: TriggerType, hasTrigger?: boolean) => boolean;
-/**
- * 判断展示类型是否需要容器（modal、drawer）
- * @param displayType 展示类型
- * @returns 是否需要容器
- */
-export declare const needsContainer: (displayType?: DisplayType) => boolean;
-/**
- * 判断展示类型是否需要浮层（popup）
- * @param displayType 展示类型
- * @returns 是否需要浮层
- */
-export declare const needsPopup: (displayType?: DisplayType) => boolean;
-/**
- * 判断展示类型是否为内联（inline）
- * @param displayType 展示类型
- * @returns 是否为内联
- */
-export declare const isInline: (displayType?: DisplayType) => boolean;

package/lib/components/pisellMetricCard/components/MetricTitle.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { MetricTitleProps } from '../types';
-/**
- * MetricTitle 标题组件
- *
- * 负责渲染标题、副标题和提示信息
- * 支持自定义字号、字重、颜色等样式
- *
- * @param props 组件属性
- */
-declare const MetricTitle: React.FC<MetricTitleProps>;
-export default MetricTitle;

package/lib/components/pisellMetricCard/components/MetricValue.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { MetricValueProps } from '../types';
-/**
- * MetricValue 数值展示组件
- *
- * 负责渲染格式化后的主数值
- * 支持自定义字号、字重、颜色等样式
- *
- * @param props 组件属性
- */
-declare const MetricValue: React.FC<MetricValueProps>;
-export default MetricValue;

package/lib/components/pisellMetricCard/components/TrendIcon.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { TrendIconProps } from '../types';
-/**
- * TrendIcon 趋势箭头组件
- *
- * 根据趋势类型显示上升或下降箭头
- * - up: 显示上升箭头 ↑
- * - down: 显示下降箭头 ↓
- * - neutral: 不显示箭头
- *
- * @param props 组件属性
- */
-declare const TrendIcon: React.FC<TrendIconProps>;
-export default TrendIcon;

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

@@ -1,201 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-/**
- * 趋势类型
- */
-export declare type TrendType = 'up' | 'down' | 'neutral';
-/**
- * 数值格式化配置
- */
-export interface ValueFormatConfig {
-    /** 小数精度（小数位数），默认 0 */
-    precision?: number;
-    /** 是否使用千分位分隔符，默认 false */
-    useGrouping?: boolean;
-    /** 是否显示货币符号，默认 false */
-    showCurrencySymbol?: boolean;
-    /** 货币符号（如 $, ¥），默认 '' */
-    currencySymbol?: string;
-    /** 自定义格式化函数 */
-    formatter?: (value: number | null) => string;
-    /** 整数时隐藏小数部分，默认 true */
-    hideDecimalForWholeNumbers?: boolean;
-}
-/**
- * 环比配置
- */
-export interface ComparisonConfig {
-    /** 环比数值（支持正负值） */
-    value: number | string | null;
-    /** 环比前缀文本，默认 'v.s. pre' */
-    text?: string;
-    /** 是否显示趋势箭头，默认 true */
-    showTrendIcon?: boolean;
-    /** 正向趋势颜色，默认 '#52c41a' */
-    positiveColor?: string;
-    /** 负向趋势颜色，默认 '#ff4d4f' */
-    negativeColor?: string;
-    /** 环比字号，默认 14 */
-    size?: number | string;
-}
-/**
- * 样式配置
- */
-export interface MetricCardStyleConfig {
-    /** 卡片容器样式 */
-    card?: {
-        /** 是否显示边框，默认 true */
-        bordered?: boolean;
-        /** 圆角大小（px），默认 12 */
-        borderRadius?: number;
-        /** 内边距（px），默认 16 */
-        padding?: number;
-        /** 阴影效果，默认 true */
-        shadow?: boolean | string;
-        /** 背景色，默认 '#ffffff' */
-        background?: string;
-        /** 卡片宽度，默认 'auto' */
-        width?: string | number;
-    };
-    /** 标题样式 */
-    title?: {
-        /** 字号，默认 14 */
-        size?: number | string;
-        /** 字重，默认 400 */
-        weight?: number | string;
-        /** 颜色，默认 'rgba(0, 0, 0, 0.45)' */
-        color?: string;
-    };
-    /** 数值样式 */
-    value?: {
-        /** 字号，默认 30 */
-        size?: number | string;
-        /** 字重，默认 600 */
-        weight?: number | string;
-        /** 颜色，默认 'rgba(0, 0, 0, 0.85)' */
-        color?: string;
-    };
-}
-/**
- * PisellMetricCard 组件 Props
- *
- * 采用扁平 + 对象组合的设计，降低复杂度和耦合
- *
- * @example 基础用法
- * ```tsx
- * <PisellMetricCard
- *   title="Total Sales"
- *   value={1580}
- * />
- * ```
- *
- * @example 带格式化和环比
- * ```tsx
- * <PisellMetricCard
- *   title="Revenue"
- *   value={1580}
- *   format={{
- *     showCurrencySymbol: true,
- *     currencySymbol: '$',
- *     useGrouping: true
- *   }}
- *   comparison={{
- *     value: 120,
- *     text: 'v.s. last month'
- *   }}
- * />
- * ```
- */
-export interface PisellMetricCardProps {
-    /** 标题文本 */
-    title: string | ReactNode;
-    /** 主数值 */
-    value: number | string | null;
-    /** 副标题文本（可选） */
-    subtitle?: string | ReactNode;
-    /** 标签内容（可选） */
-    tag?: ReactNode;
-    /** 提示信息内容（可选） */
-    tooltip?: string | ReactNode;
-    /**
-     * 数值格式化配置
-     * @example format={{ precision: 2, useGrouping: true, currencySymbol: '$' }}
-     */
-    format?: ValueFormatConfig;
-    /**
-     * 环比配置
-     * @example comparison={{ value: 120, text: 'v.s. pre' }}
-     */
-    comparison?: ComparisonConfig;
-    /**
-     * 样式配置
-     * @example
-     * styleConfig={{
-     *   card: { borderRadius: 8, padding: 24 },
-     *   title: { size: 16, weight: 600 },
-     *   value: { size: 36, color: '#1890ff' }
-     * }}
-     */
-    styleConfig?: MetricCardStyleConfig;
-    /** 是否显示副标题，默认 false */
-    showSubtitle?: boolean;
-    /** 是否显示标签，默认 false */
-    showTag?: boolean;
-    /** 是否显示提示信息，默认 false */
-    showTooltip?: boolean;
-    /** 是否显示加载状态，默认 false */
-    loading?: boolean;
-    /** 鼠标悬停是否有交互效果，默认 true */
-    hoverable?: boolean;
-    /** 自定义类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: CSSProperties;
-    /** 点击卡片回调 */
-    onClick?: () => void;
-}
-/**
- * FormatOptions (别名，用于导出)
- */
-export interface FormatOptions extends ValueFormatConfig {
-}
-/**
- * MetricTitle 组件 Props
- */
-export interface MetricTitleProps {
-    title: string | ReactNode;
-    subtitle?: string | ReactNode;
-    tooltip?: string | ReactNode;
-    titleSize?: number | string;
-    titleWeight?: number | string;
-    titleColor?: string;
-}
-/**
- * MetricValue 组件 Props
- */
-export interface MetricValueProps {
-    value: string | null;
-    valueSize?: number | string;
-    valueWeight?: number | string;
-    valueColor?: string;
-}
-/**
- * MetricComparison 组件 Props
- */
-export interface MetricComparisonProps {
-    comparison: number | string | null;
-    comparisonText?: string;
-    showTrendIcon?: boolean;
-    positiveColor?: string;
-    negativeColor?: string;
-    comparisonSize?: number | string;
-    precision?: number;
-    showCurrencySymbol?: boolean;
-    currencySymbol?: string;
-}
-/**
- * TrendIcon 组件 Props
- */
-export interface TrendIconProps {
-    trend: TrendType;
-    color?: string;
-}

package/lib/components/pisellMetricCard/utils/calculateTrend.d.ts

@@ -1,14 +0,0 @@
-import type { TrendType } from '../types';
-/**
- * 计算趋势方向
- *
- * @param comparison 环比数值
- * @returns 'up' | 'down' | 'neutral'
- *
- * @example
- * calculateTrend(120) // 'up'
- * calculateTrend(-230) // 'down'
- * calculateTrend(0) // 'neutral'
- * calculateTrend(null) // 'neutral'
- */
-export declare function calculateTrend(comparison: number | string | null | undefined): TrendType;

package/lib/components/pisellPercent/utils/rangeConverter.d.ts

@@ -1,36 +0,0 @@
-/**
- * 百分比范围转换工具函数
- */
-/**
- * 将值转换为百分比（0-100）
- *
- * @param value 原始值
- * @param range 值的范围
- * @returns 转换后的百分比值（0-100）
- *
- * @example
- * // [0, 100] 范围 - 直接返回
- * convertToPercent(85.5, [0, 100])  // 返回: 85.5
- *
- * @example
- * // [0, 1] 范围 - 乘以 100
- * convertToPercent(0.855, [0, 1])  // 返回: 85.5
- *
- * @example
- * // 自定义范围 - 按比例计算
- * convertToPercent(855, [0, 1000])  // 返回: 85.5
- */
-export declare function convertToPercent(value: number | null | undefined, range: [number, number]): number | null;
-/**
- * 将百分比值转换回原始范围
- *
- * @param percent 百分比值（0-100）
- * @param range 目标范围
- * @returns 转换后的值
- *
- * @example
- * convertFromPercent(85.5, [0, 100])  // 返回: 85.5
- * convertFromPercent(85.5, [0, 1])    // 返回: 0.855
- * convertFromPercent(85.5, [0, 1000]) // 返回: 855
- */
-export declare function convertFromPercent(percent: number | null | undefined, range: [number, number]): number | null;

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

@@ -1,39 +0,0 @@
-/**
- * 电话号码格式化工具
- */
-/**
- * 中国大陆手机号格式化：138 0000 0000
- */
-export declare function formatChinaMobile(phone: string): string;
-/**
- * 美国/加拿大号码格式化：(555) 123-4567
- */
-export declare function formatUSPhone(phone: string): string;
-/**
- * 英国号码格式化：1234 567 8900
- */
-export declare function formatUKPhone(phone: string): string;
-/**
- * 根据国家码格式化电话号码
- * @param phone 电话号码（纯数字）
- * @param countryCode 国家码
- * @returns 格式化后的电话号码
- */
-export declare function formatPhone(phone: string, countryCode: string): string;
-/**
- * 电话号码脱敏
- * @param phone 电话号码
- * @param pattern 脱敏模式
- * @returns 脱敏后的号码
- *
- * @example
- * maskPhone('13800000000', 'middle') // '138****0000'
- * maskPhone('13800000000', 'last')   // '1380000****'
- */
-export declare function maskPhone(phone: string, pattern?: 'middle' | 'last'): string;
-/**
- * 检测号码类型（中国）
- * @param phone 电话号码
- * @returns 号码类型
- */
-export declare function detectPhoneType(phone: string): 'mobile' | 'landline' | 'unknown';

package/lib/components/pisellShellFrame/PisellShellFrame.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-import type { PisellShellFrameProps } from './types';
-import './PisellShellFrame.less';
-/**
- * PisellShellFrame：通用壳层布局组件。
- * 支持通过 config 控制各区域显隐，不同展示类型（表格/看板/日历/楼层图等）复用同一壳层。
- *
- * - 顶部：标题区（标题/副标题/辅助信息）、工具区（Toolbar）、统计区（Statistic List，可选折叠）
- * - 中间：滚动承载（可选）+ Layout 插槽（children）
- * - 底部：批量操作条（按选中状态出现）、状态提示区（加载/错误/同步提示等）
- */
-export declare const PisellShellFrame: React.FC<PisellShellFrameProps>;
-export default PisellShellFrame;

package/lib/components/pisellShellFrame/PisellShellFrame.stories.d.ts

@@ -1,15 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellShellFrame } from './PisellShellFrame';
-declare const meta: Meta<typeof PisellShellFrame>;
-export default meta;
-declare type Story = StoryObj<typeof PisellShellFrame>;
-/** 仅标题区 */
-export declare const TitleOnly: Story;
-/** 标题 + 工具区 */
-export declare const WithToolbar: Story;
-/** 标题 + 统计区（可折叠，国际化） */
-export declare const WithStatisticCollapsible: Story;
-/** 中间滚动 + 底部批量条 + 状态区 */
-export declare const WithScrollBatchAndStatus: Story;
-/** 全区域展示（默认展开统计） */
-export declare const Full: Story;

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

@@ -1,2 +0,0 @@
-export { PisellShellFrame, default } from './PisellShellFrame';
-export type { PisellShellFrameProps, PisellShellFrameConfig, PisellShellFrameScrollConfig, } from './types';

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

@@ -1,56 +0,0 @@
-import type { ReactNode, CSSProperties } from 'react';
-/**
- * 滚动配置：为 true 时使用默认滚动；为对象时传入样式或 scroll 相关配置。
- */
-export declare type PisellShellFrameScrollConfig = boolean | {
-    style?: CSSProperties;
-    className?: string;
-};
-/**
- * PisellShellFrame 配置：控制各区域的展示与行为。
- * 不同展示类型（表格/看板/日历等）复用同一壳层，通过配置控制显隐。
- */
-export interface PisellShellFrameConfig {
-    /** 是否展示顶部标题区（标题/副标题/辅助信息） */
-    showTitle?: boolean;
-    /** 是否展示顶部工具区（Toolbar） */
-    showToolbar?: boolean;
-    /** 是否展示顶部统计区（Statistic List） */
-    showStatistic?: boolean;
-    /** 统计区是否支持折叠，仅 showStatistic 为 true 时有效 */
-    statisticCollapsible?: boolean;
-    /** 中间内容区是否使用滚动承载包裹；为 true 时默认 overflow auto */
-    scroll?: PisellShellFrameScrollConfig;
-    /** 是否展示底部批量操作条（按选中状态出现由调用方控制，此处仅控制是否渲染该槽位） */
-    showBatchActionBar?: boolean;
-    /** 是否展示底部状态提示区（加载/错误/同步提示等） */
-    showStatusArea?: boolean;
-}
-/**
- * PisellShellFrame 组件 Props。
- * 通过 config 控制各区域显隐，通过 slot props 传入各区域内容。
- */
-export interface PisellShellFrameProps {
-    /** 类名 */
-    className?: string;
-    /** 内联样式 */
-    style?: CSSProperties;
-    /** 区域显隐与行为配置，未传则默认不展示可选区域 */
-    config?: PisellShellFrameConfig;
-    /** 标题 */
-    title?: ReactNode;
-    /** 副标题 */
-    subtitle?: ReactNode;
-    /** 标题区右侧辅助信息 */
-    titleExtra?: ReactNode;
-    /** 工具栏内容 */
-    toolbar?: ReactNode;
-    /** 统计列表内容（如 PisellStatisticList 或自定义） */
-    statisticList?: ReactNode;
-    /** 主内容（表格/看板/日历/楼层图等），当 config.scroll 为 true 时会被滚动容器包裹 */
-    children?: ReactNode;
-    /** 批量操作条，通常按选中状态显隐由调用方控制 */
-    batchActionBar?: ReactNode;
-    /** 状态提示（加载/错误/同步提示等） */
-    statusArea?: ReactNode;
-}

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

@@ -1,7 +0,0 @@
-import { SortListProps } from '../sort/types';
-import { FormInstance } from 'antd';
-export declare type PisellSortProps = SortListProps & {
-    name?: string;
-} & FormInstance & {
-    hasForm?: boolean;
-};

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

@@ -1,137 +0,0 @@
-import type { CSSProperties } from 'react';
-import type { Dayjs } from 'dayjs';
-import type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign } from '../pisellDateTimeDisplay/types';
-export type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign, };
-/**
- * 字段类型（时间区间、日期、星期、持续时长）
- * - time: 时间区间块（HH:mm-HH:mm 或跨天起止）
- * - date: 日期块
- * - weekday: 星期块
- * - duration: 持续时长块
- */
-export declare type TimeRangeFieldType = 'time' | 'date' | 'weekday' | 'duration';
-/**
- * 持续时长格式配置
- */
-export interface DurationFormatConfig {
-    /**
-     * 是否显示秒
-     * @default false
-     * @example true -> "2h30m23s" | false -> "2h30m"
-     */
-    showSeconds?: boolean;
-}
-/**
- * 字段配置
- */
-export interface TimeRangeFieldConfig {
-    /**
-     * 是否显示时间区间块
-     * @default true
-     */
-    showTimeRange?: boolean;
-    /**
-     * 是否显示日期块
-     * @default true
-     */
-    showDate?: boolean;
-    /**
-     * 是否显示星期块
-     * @default true
-     */
-    showWeekday?: boolean;
-    /**
-     * 是否显示持续时长块
-     * @default true
-     */
-    showDuration?: boolean;
-    /**
-     * 字段顺序（四类块可任意排序；默认 时间 日期 星期 持续时长，可实现「持续时间在前」等）
-     * @default ['weekday', 'date', 'time', 'duration'] 换行顺序：先持续时间 → 结束时间（跨天）→ 开始/结束时间与日期 → 星期
-     */
-    fieldOrder?: TimeRangeFieldType[];
-}
-/**
- * startAt / endAt 的 dayjs 兼容值
- */
-export declare type DayjsLike = Dayjs | string | number;
-/**
- * PisellTimeRangeDisplay 组件 Props
- */
-export interface PisellTimeRangeDisplayProps {
-    /**
-     * 开始时间（dayjs 兼容值）
-     */
-    startAt: DayjsLike;
-    /**
-     * 结束时间（dayjs 兼容值）
-     */
-    endAt: DayjsLike;
-    /**
-     * 文本对齐方式（单行/多行均生效）
-     * @default 'center'
-     */
-    textAlign?: TextAlign;
-    /**
-     * 字段显示与排序配置
-     */
-    fields?: TimeRangeFieldConfig;
-    /**
-     * 同一天时是否显示具体日期
-     * @default true
-     */
-    showDateForSameDay?: boolean;
-    /**
-     * 时间格式配置（复用 PisellDateTimeDisplay）
-     */
-    timeFormat?: TimeFormatConfig;
-    /**
-     * 日期格式配置（复用 PisellDateTimeDisplay）
-     */
-    dateFormat?: DateFormatConfig;
-    /**
-     * 星期格式配置（复用 PisellDateTimeDisplay）
-     */
-    weekdayFormat?: WeekdayFormatConfig;
-    /**
-     * 持续时长格式配置
-     */
-    durationFormat?: DurationFormatConfig;
-    /**
-     * 容器样式
-     */
-    containerStyle?: ContainerStyleConfig;
-    /**
-     * 时间区间文本样式
-     */
-    timeStyle?: TextStyleConfig;
-    /**
-     * 日期文本样式
-     */
-    dateStyle?: TextStyleConfig;
-    /**
-     * 星期文本样式
-     */
-    weekdayStyle?: TextStyleConfig;
-    /**
-     * 持续时长文本样式
-     */
-    durationStyle?: TextStyleConfig;
-    /**
-     * dayjs locale（语言代码）
-     * @default 优先使用全局配置，其次浏览器语言
-     */
-    locale?: string;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * 点击回调
-     */
-    onClick?: () => void;
-}

package/lib/components/pisellTimeRangeDisplay/utils/formatDuration.d.ts

@@ -1,14 +0,0 @@
-/**
- * 将毫秒数格式化为持续时间字符串（d h m s 或 天/时/分/秒）
- *
- * @param ms 持续时间（毫秒）
- * @param showSeconds 是否显示秒，默认 false
- * @param locale 语言代码，zh 时使用「天/时/分/秒」，否则使用 d/h/m/s
- * @returns 如 "2h30m"、"1d2h30m23s" 或 "2时30分"、"1天2时30分23秒"
- *
- * @example
- * formatDuration(9000000, false)        // => "2h30m"
- * formatDuration(9000000, false, 'zh-cn') // => "2时30分"
- * formatDuration(86400000, false)       // => "1d"
- */
-export declare function formatDuration(ms: number, showSeconds?: boolean, locale?: string): string;

package/lib/components/pisellTimeRangeDisplay/utils/parseTimeRange.d.ts

@@ -1,23 +0,0 @@
-import { type Dayjs } from 'dayjs';
-import type { DayjsLike } from '../types';
-export interface ParseTimeRangeResult {
-    /** 开始时间（已应用 locale） */
-    start: Dayjs;
-    /** 结束时间（已应用 locale） */
-    end: Dayjs;
-    /** 是否同一天（按本地时区自然日判定） */
-    isSameDay: boolean;
-}
-/**
- * 解析 startAt / endAt 为 Dayjs，并判定是否同一天
- *
- * @param startAt 开始时间（dayjs 兼容值）
- * @param endAt 结束时间（dayjs 兼容值）
- * @param locale dayjs locale，可选
- * @returns { start, end, isSameDay }
- *
- * @example
- * parseTimeRange('2026-02-04 09:00', '2026-02-04 18:00', 'zh-cn')
- * // => { start: Dayjs, end: Dayjs, isSameDay: true }
- */
-export declare function parseTimeRange(startAt: DayjsLike, endAt: DayjsLike, locale?: string): ParseTimeRangeResult;

package/lib/components/pisellUrl/utils/index.d.ts

@@ -1,6 +0,0 @@
-/**
- * PisellUrl 工具函数导出
- */
-export * from './urlValidator';
-export * from './urlHelper';
-export * from './urlFormatter';