@pisell/materials 6.11.20 → 6.11.21

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

@@ -1,8 +0,0 @@
-export { TimeRangeBlock } from './TimeRangeBlock';
-export { DateBlock } from './DateBlock';
-export { WeekdayBlock } from './WeekdayBlock';
-export { DurationBlock } from './DurationBlock';
-export type { TimeRangeBlockProps } from './TimeRangeBlock';
-export type { DateBlockProps } from './DateBlock';
-export type { WeekdayBlockProps } from './WeekdayBlock';
-export type { DurationBlockProps } from './DurationBlock';

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

@@ -1,3 +0,0 @@
-export { PisellTimeRangeDisplay, default } from './PisellTimeRangeDisplay';
-export type { PisellTimeRangeDisplayProps, LayoutDirection, TimeRangeFieldType, TimeRangeFieldConfig, DurationFormatConfig, DayjsLike, } from './types';
-export type { TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, ContainerStyleConfig, TextStyleConfig, TextAlign, } from './types';

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

@@ -1,4 +0,0 @@
-export { parseTimeRange } from './parseTimeRange';
-export type { ParseTimeRangeResult } from './parseTimeRange';
-export { formatDuration } from './formatDuration';
-export { formatTime, formatDate, formatWeekday, getDayjsLocale, getRelativeDay, getRelativeDayLabel, getDatePartDisplay, } from '../../pisellDateTimeDisplay/utils';

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

@@ -1,17 +0,0 @@
-import React from 'react';
-import './index.less';
-export interface PisellToastProps {
-    /** 提示内容	 */
-    content: React.ReactNode;
-    /** 自动关闭的延时，单位秒。设为 0 时不自动关闭 */
-    duration?: number;
-    /** 是否展示action */
-    showAction?: boolean;
-    /** action文案 */
-    actionText?: string;
-    /** 关闭时触发的回调函数 */
-    onClose?: () => void;
-}
-declare const PisellToast: (props: PisellToastProps) => void;
-export { useToast } from './squareToast';
-export default PisellToast;

package/lib/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/lib/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/lib/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/lib/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/lib/components/pisellUrl/PisellUrl.d.ts

@@ -1,37 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from './types';
-import './PisellUrl.less';
-/**
- * PisellUrl URL 链接组件
- *
- * URL 链接输入/展示组件，支持只读、编辑、禁用三种状态。
- * 基于 Ant Design Input 组件开发，提供 URL 格式校验、协议自动补全、
- * 链接跳转和协议/路径显示控制功能。
- *
- * @param props 组件 Props
- *
- * @example
- * // 编辑态（URL 输入）
- * <PisellUrl
- *   placeholder="请输入网址"
- *   required
- * />
- *
- * @example
- * // 只读态（可跳转）
- * <PisellUrl
- *   mode="read"
- *   value="https://www.example.com"
- *   enableLinkClick
- * />
- *
- * @example
- * // 协议自动补全
- * <PisellUrl
- *   autoCompleteProtocol
- *   defaultProtocol="https://"
- * />
- */
-export declare const PisellUrl: React.FC<PisellUrlProps>;
-declare const _default: React.NamedExoticComponent<PisellUrlProps>;
-export default _default;

package/lib/components/pisellUrl/PisellUrl.stories.d.ts

@@ -1,108 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import { PisellUrl } from './PisellUrl';
-/**
- * PisellUrl 是一个 URL 地址输入/展示组件。
- *
- * ## 功能特性
- * - 支持三种状态：只读、编辑、禁用
- * - URL 格式校验
- * - 协议自动补全
- * - 链接跳转（新窗口，安全性保障）
- * - 协议/路径显示控制
- * - 协议白名单限制
- */
-declare const meta: Meta<typeof PisellUrl>;
-export default meta;
-declare type Story = StoryObj<typeof PisellUrl>;
-/**
- * 基础编辑态
- */
-export declare const Basic: Story;
-/**
- * 协议自动补全
- */
-export declare const WithProtocolAutoComplete: Story;
-/**
- * 只读态 - 可跳转
- */
-export declare const ReadMode: Story;
-/**
- * 只读态 - 隐藏协议
- */
-export declare const ReadModeHideProtocol: Story;
-/**
- * 只读态 - 仅域名
- */
-export declare const ReadModeDomainOnly: Story;
-/**
- * 禁用态（编辑）
- */
-export declare const DisabledEdit: Story;
-/**
- * 禁用态（只读）
- */
-export declare const DisabledRead: Story;
-/**
- * 必填校验
- */
-export declare const Required: Story;
-/**
- * 格式校验（实时）
- */
-export declare const FormatValidation: Story;
-/**
- * 协议限制（仅 HTTPS）
- */
-export declare const HttpsOnly: Story;
-/**
- * 协议必需
- */
-export declare const RequireProtocol: Story;
-/**
- * 显示清空按钮
- */
-export declare const WithClearButton: Story;
-/**
- * 自动聚焦
- */
-export declare const WithAutoFocus: Story;
-/**
- * 自定义样式（只读态）
- */
-export declare const CustomStyle: Story;
-/**
- * 显示控制对比
- */
-export declare const DisplayFormatComparison: Story;
-/**
- * 校验时机对比
- */
-export declare const ValidateTriggerComparison: Story;
-/**
- * 所有状态展示
- */
-export declare const AllStates: Story;
-/**
- * 完整功能示例
- */
-export declare const CompleteExample: Story;
-/**
- * 协议补全演示
- */
-export declare const ProtocolCompleteDemo: Story;
-/**
- * 链接跳转演示
- */
-export declare const LinkClickDemo: Story;
-/**
- * 协议限制演示
- */
-export declare const ProtocolRestrictionDemo: Story;
-/**
- * 完整交互示例
- */
-export declare const InteractiveExample: Story;
-/**
- * 协议默认值对比
- */
-export declare const ProtocolDefaultComparison: Story;

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

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from '../types';
-/**
- * PisellUrl 禁用态视图组件
- *
- * 职责：
- * - 渲染禁用状态的 URL 组件
- * - 根据原始 mode 选择渲染 ReadOnlyView 或 EditView
- * - 应用禁用样式（透明度 40%）
- *
- * @param props 组件 Props
- */
-declare const DisabledView: React.FC<PisellUrlProps>;
-export default DisabledView;

package/lib/components/pisellUrl/components/ReadOnlyView.d.ts

@@ -1,15 +0,0 @@
-import React from 'react';
-import type { PisellUrlProps } from '../types';
-/**
- * PisellUrl 只读态视图组件
- *
- * 职责：
- * - 渲染只读态 URL 链接展示
- * - 支持点击新窗口打开链接（安全性保障）
- * - 支持协议/路径隐藏
- * - 支持链接图标
- *
- * @param props 组件 Props
- */
-declare const ReadOnlyView: React.FC<PisellUrlProps>;
-export default ReadOnlyView;

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

@@ -1,7 +0,0 @@
-/**
- * PisellUrl 组件导出文件
- */
-import PisellUrl from './PisellUrl';
-export { PisellUrl };
-export default PisellUrl;
-export type { PisellUrlProps } from './types';

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

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

package/lib/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/lib/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/lib/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/lib/components/productCard/cartSkuCard/components/AmountFooter/index.d.ts

@@ -1,4 +0,0 @@
-import React from 'react';
-import './index.less';
-declare const Footer: ({ item, hideDivider, type, isOnlyTotal }: any) => React.JSX.Element;
-export default Footer;

package/lib/components/productCard/cartSkuCard/components/Gift/index.d.ts

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