@pisell/materials 6.11.7 → 6.11.9

package/es/components/pisellLookup/utils/storage.d.ts

@@ -1,42 +0,0 @@
-/**
- * localStorage 工具函数
- * 用于管理搜索历史的存储
- */
-/**
- * 从 localStorage 加载历史记录
- * @param key 存储的 key
- * @returns 历史记录数组
- */
-export declare const loadHistory: (key: string) => string[];
-/**
- * 保存历史记录到 localStorage
- * @param key 存储的 key
- * @param history 历史记录数组
- * @param maxCount 最大数量限制
- */
-export declare const saveHistory: (key: string, history: string[], maxCount: number) => void;
-/**
- * 清除历史记录
- * @param key 存储的 key
- */
-export declare const clearHistory: (key: string) => void;
-/**
- * 添加历史记录项
- * @param key 存储的 key
- * @param item 新的历史记录项
- * @param maxCount 最大数量限制
- * @returns 更新后的历史记录数组
- */
-export declare const addHistoryItem: (key: string, item: string, maxCount: number) => string[];
-/**
- * 删除历史记录项
- * @param key 存储的 key
- * @param item 要删除的历史记录项
- * @returns 更新后的历史记录数组
- */
-export declare const removeHistoryItem: (key: string, item: string) => string[];
-/**
- * 检查 localStorage 是否可用
- * @returns 是否可用
- */
-export declare const isLocalStorageAvailable: () => boolean;

package/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/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/es/components/pisellToast/squareToast/index.d.ts

@@ -1,15 +0,0 @@
-import { clear, show, success, info, loading, fail, hide } from './methods';
-import './index.less';
-interface ToastInstance {
-    show: typeof show;
-    clear: typeof clear;
-    success: typeof success;
-    info: typeof info;
-    loading: typeof loading;
-    fail: typeof fail;
-    error: typeof fail;
-    hide: typeof hide;
-}
-declare const Toast: ToastInstance;
-export declare const useToast: () => ToastInstance;
-export default Toast;

package/es/components/pisellToast/squareToast/methods.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-import { ToastProps } from './toast';
-interface ToastInstance {
-    close: () => void;
-}
-declare const show: (configOrContent: Partial<ToastProps> | React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
-declare const clear: () => void;
-declare const success: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
-declare const info: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
-declare const loading: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
-declare const fail: (content: React.ReactNode, duration?: number, afterClose?: () => void) => ToastInstance;
-declare const hide: () => void;
-export { show, clear, success, info, loading, fail, hide };

package/es/components/pisellToast/squareToast/renderImperatively.d.ts

@@ -1,28 +0,0 @@
-import type { ReactElement } from 'react';
-import type { Root } from 'react-dom/client';
-import React from 'react';
-declare type ImperativeProps = {
-    open?: boolean;
-    onCancel?: () => void;
-    afterClose?: () => void;
-};
-declare type TargetElement = ReactElement<ImperativeProps>;
-export declare type ImperativeHandler = {
-    close: () => void;
-    replace: (element: TargetElement) => void;
-    isRendered?: () => boolean;
-};
-export declare type UnmountType = () => Promise<void>;
-export declare type RenderType = (node: React.ReactElement, container: Element | DocumentFragment) => UnmountType;
-declare const MARK = "__pisell_react_root__";
-declare type ContainerType = (Element | DocumentFragment) & {
-    [MARK]?: Root;
-};
-export declare function render(node: React.ReactElement, container: ContainerType): void;
-export declare function unmount(container: ContainerType): Promise<void>;
-/**
- * @deprecated 设置 React 渲染函数以兼容使用。
- */
-export declare function unstableSetRender(render?: RenderType): RenderType;
-export declare function renderImperatively(element: TargetElement): ImperativeHandler;
-export {};

package/es/components/pisellToast/squareToast/toast.d.ts

@@ -1,25 +0,0 @@
-import React from 'react';
-import './index.less';
-export declare type ToastType = 'success' | 'error' | 'warning' | 'info' | 'loading';
-export interface ToastProps {
-    /** Toast 类型 */
-    icon?: ToastType | React.ReactNode;
-    /** 显示的内容，支持文本或 React 节点 */
-    content: React.ReactNode;
-    /** 是否显示 */
-    open?: boolean;
-    /** 自动关闭时间，单位毫秒，0 表示不自动关闭 */
-    duration?: number;
-    /** 关闭 */
-    onCancel?: () => void;
-    /** 关闭后回调 */
-    afterClose?: () => void;
-    /** 自定义样式类名 */
-    className?: string;
-    /** 自定义样式 */
-    style?: React.CSSProperties;
-    /** 是否显示遮罩 */
-    mask?: boolean;
-}
-declare const Toast: React.FC<ToastProps>;
-export default Toast;

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

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

package/es/components/pisellUrl/utils/urlFormatter.d.ts

@@ -1,38 +0,0 @@
-/**
- * URL 格式化工具函数
- */
-/**
- * 格式化 URL 显示
- * @param url URL 地址
- * @param options 格式化选项
- * @returns 格式化后的 URL
- *
- * @example
- * formatUrlDisplay('https://www.example.com/path', { showProtocol: false })
- * // 'www.example.com/path'
- */
-export declare function formatUrlDisplay(url: string, options: {
-    showProtocol?: boolean;
-    showWww?: boolean;
-    showPathname?: boolean;
-    displayFormat?: 'full' | 'domain' | 'custom';
-    customFormat?: (url: string) => string;
-}): string;
-/**
- * 隐藏 URL 协议
- * @param url URL 地址
- * @returns 隐藏协议后的 URL
- *
- * @example
- * hideUrlProtocol('https://example.com') // 'example.com'
- */
-export declare function hideUrlProtocol(url: string): string;
-/**
- * 隐藏 www 前缀
- * @param url URL 地址
- * @returns 隐藏 www 后的 URL
- *
- * @example
- * hideWwwPrefix('https://www.example.com') // 'https://example.com'
- */
-export declare function hideWwwPrefix(url: string): string;

package/es/components/pisellUrl/utils/urlHelper.d.ts

@@ -1,63 +0,0 @@
-/**
- * URL 辅助函数
- */
-/**
- * 规范化 URL（补全协议）
- * @param url URL 地址
- * @param defaultProtocol 默认协议
- * @returns 规范化后的 URL
- *
- * @example
- * normalizeUrl('example.com', 'https://') // 'https://example.com'
- * normalizeUrl('http://example.com', 'https://') // 'http://example.com'
- */
-export declare function normalizeUrl(url: string, defaultProtocol?: string): string;
-/**
- * 智能补全协议（识别 localhost）
- * @param url URL 地址
- * @returns 规范化后的 URL
- *
- * @example
- * smartNormalizeUrl('localhost:3000') // 'http://localhost:3000'
- * smartNormalizeUrl('example.com') // 'https://example.com'
- */
-export declare function smartNormalizeUrl(url: string): string;
-/**
- * 提取域名
- * @param url URL 地址
- * @returns 域名
- *
- * @example
- * extractDomain('https://www.example.com/path') // 'www.example.com'
- */
-export declare function extractDomain(url: string): string;
-/**
- * 处理链接跳转（安全性保障）
- * @param url URL 地址
- * @param openInNewWindow 是否新窗口打开
- * @param defaultProtocol 默认协议
- *
- * @example
- * handleUrlClick('example.com', true, 'https://')
- */
-export declare function handleUrlClick(url: string, openInNewWindow?: boolean, defaultProtocol?: string): void;
-/**
- * 检测是否为安全链接（HTTPS）
- * @param url URL 地址
- * @returns 是否为 HTTPS
- *
- * @example
- * isSecureUrl('https://example.com') // true
- * isSecureUrl('http://example.com') // false
- */
-export declare function isSecureUrl(url: string): boolean;
-/**
- * 提取 URL 参数
- * @param url URL 地址
- * @returns 参数对象
- *
- * @example
- * extractUrlParams('https://example.com?foo=bar&baz=qux')
- * // { foo: 'bar', baz: 'qux' }
- */
-export declare function extractUrlParams(url: string): Record<string, string>;

package/es/components/pisellUrl/utils/urlValidator.d.ts

@@ -1,46 +0,0 @@
-/**
- * URL 校验工具函数
- */
-/**
- * URL 格式校验（使用 URL 构造函数）
- * @param url URL 地址
- * @returns 是否通过校验
- *
- * @example
- * validateUrl('https://example.com') // true
- * validateUrl('invalid-url') // false
- */
-export declare function validateUrl(url: string): boolean;
-/**
- * URL 正则校验（备选方法）
- * @param url URL 地址
- * @returns 是否通过校验
- */
-export declare function validateUrlByRegex(url: string): boolean;
-/**
- * 解析 URL 各部分
- * @param url URL 地址
- * @returns URL 各部分或 null
- *
- * @example
- * parseUrl('https://example.com:8080/path?key=value#hash')
- * // { protocol: 'https', host: 'example.com', port: '8080', ... }
- */
-export declare function parseUrl(url: string): {
-    protocol: string;
-    host: string;
-    port: string;
-    pathname: string;
-    search: string;
-    hash: string;
-} | null;
-/**
- * 协议白名单校验
- * @param url URL 地址
- * @param allowedProtocols 允许的协议列表
- * @returns 校验结果
- */
-export declare function validateUrlProtocol(url: string, allowedProtocols: string[]): {
-    isValid: boolean;
-    errors: string[];
-};

package/es/components/productCard/cartSkuCard/components/MultiDay/utils.d.ts

@@ -1,14 +0,0 @@
-interface InputItem {
-    start_date: string;
-    end_date: string;
-    total: number;
-    num: number;
-}
-interface OutputItem {
-    start_date: string;
-    end_date: string;
-    total: number;
-    num: number;
-}
-export declare function formatDateRanges(list: InputItem[]): OutputItem[];
-export {};