@pisell/materials 6.11.14 → 6.11.16

package/lib/components/pisellDataSourceContainer/hooks/useHandleAction.d.ts

@@ -1,32 +0,0 @@
-import { DataSourceContainerProps } from '../type';
-import { FormInstance } from 'antd';
-declare const useHandleAction: (initialParams: Record<string, any> | undefined, options: DataSourceContainerProps['pagination'], form: FormInstance | undefined) => {
-    list: {
-        pagination?: {
-            pageNumber: number;
-            pageSize: number;
-        } | undefined;
-        data: {
-            list: any;
-            count: any;
-        };
-        onSearch: (newParams?: Record<string, any>) => void;
-        onReset: () => void;
-        onPageChange: (pageNumber: number, pageSize: number) => void;
-        loading: boolean;
-        error?: Error | undefined;
-        params: any;
-        cancel: () => void;
-        refresh: () => void;
-        refreshAsync: () => Promise<any>;
-        run: (...params: any) => void;
-        runAsync: (...params: any) => Promise<any>;
-        mutate: (data?: any) => void;
-    };
-    get: import("ahooks/es/useRequest/src/types").Result<any, any>;
-    update: import("ahooks/es/useRequest/src/types").Result<any, any>;
-    create: import("ahooks/es/useRequest/src/types").Result<any, any>;
-    destroy: import("ahooks/es/useRequest/src/types").Result<any, any>;
-    getCurrentRecord: () => any;
-};
-export default useHandleAction;

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

@@ -1,28 +0,0 @@
-import React from 'react';
-import Filter from './components/Filter';
-import QuickFilter from './components/Filter/QuickFilter';
-import FilterButton from './components/Filter/FilterButton';
-import Sort from './components/Sort';
-import Table from './components/Table';
-import Pagination from './components/Pagination';
-import ColumnsSetting from './components/ColumnsSetting';
-import withContainer from './utils/withContainer';
-import useContainerContext from './hooks/useContainerContext';
-import { DataSourceContainerProps } from './type';
-/**
- * PisellDataSourceContainer 复合组件类型定义
- */
-interface PisellDataSourceContainerType extends React.FC<DataSourceContainerProps> {
-    Filter: typeof Filter;
-    QuickFilter: typeof QuickFilter;
-    FilterButton: typeof FilterButton;
-    Sort: typeof Sort;
-    Table: typeof Table;
-    Pagination: typeof Pagination;
-    ColumnsSetting: typeof ColumnsSetting;
-    withContainer: typeof withContainer;
-    useContainerContext: typeof useContainerContext;
-}
-declare const PisellDataSourceContainer: PisellDataSourceContainerType;
-export default PisellDataSourceContainer;
-export type { DataSourceContainerProps } from './type';

package/lib/components/pisellDataSourceContainer/provider/ChildComponentProps.d.ts

@@ -1,13 +0,0 @@
-import React, { ReactNode } from 'react';
-import { FormInstance } from 'antd';
-import { ChildComponentPropsType } from '../type';
-declare type ChildComponentPropsContextType = ChildComponentPropsType & {
-    form: FormInstance;
-};
-interface ChildComponentPropsProviderProps {
-    childComponentProps?: ChildComponentPropsType;
-    children: ReactNode;
-}
-export declare const ChildComponentPropsProvider: React.FC<ChildComponentPropsProviderProps>;
-export declare const useChildComponentPropsContext: () => ChildComponentPropsContextType;
-export {};

package/lib/components/pisellDataSourceContainer/provider/HandleActions.d.ts

@@ -1,5 +0,0 @@
-import React from 'react';
-import { DataSourceContainerProps, HandleActionContextType } from '../type';
-export declare const HandleActionContext: React.Context<HandleActionContextType | null>;
-export declare const HandleActionsProvider: (props: DataSourceContainerProps) => React.JSX.Element;
-export declare const useHandleActionProvider: () => HandleActionContextType;

package/lib/components/pisellDataSourceContainer/provider/RefManager.d.ts

@@ -1,9 +0,0 @@
-import React from 'react';
-import { RefManagerContextType } from '../type';
-export declare const RefManagerContext: React.Context<RefManagerContextType | null>;
-interface RefManagerProviderProps {
-    children: React.ReactNode;
-}
-export declare const RefManagerProvider: React.FC<RefManagerProviderProps>;
-export declare const useRefManagerProvider: () => RefManagerContextType;
-export {};

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

@@ -1,35 +0,0 @@
-import React from 'react';
-import 'dayjs/locale/zh-cn';
-import 'dayjs/locale/en';
-import type { PisellDateTimeDisplayProps } from './types';
-import './PisellDateTimeDisplay.less';
-/**
- * PisellDateTimeDisplay 组件
- *
- * @description
- * 专注于展示当前时间的组件，支持：
- * - 当前日期、时间、星期展示
- * - 多种布局方式（水平、垂直、单行）
- * - 丰富的格式化配置
- * - 自动刷新
- * - 国际化支持
- *
- * @example
- * // 基础用法
- * <PisellDateTimeDisplay />
- *
- * // 自定义格式
- * <PisellDateTimeDisplay
- *   layout="vertical"
- *   timeFormat={{ use12Hour: true, showSeconds: true }}
- *   dateFormat={{ showYear: true, showChineseUnit: true }}
- * />
- *
- * // 自定义格式化字符串
- * <PisellDateTimeDisplay
- *   customFormat="YYYY-MM-DD HH:mm:ss"
- * />
- */
-export declare const PisellDateTimeDisplay: React.FC<PisellDateTimeDisplayProps>;
-declare const _default: React.NamedExoticComponent<PisellDateTimeDisplayProps>;
-export default _default;

package/lib/components/pisellDateTimeDisplay/PisellDateTimeDisplay.stories.d.ts

@@ -1,195 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import PisellDateTimeDisplay from './PisellDateTimeDisplay';
-/**
- * PisellDateTimeDisplay 组件 Storybook
- */
-declare const meta: Meta<typeof PisellDateTimeDisplay>;
-export default meta;
-declare type Story = StoryObj<typeof PisellDateTimeDisplay>;
-/**
- * 基础示例
- */
-export declare const Basic: Story;
-/**
- * 水平布局（默认）
- */
-export declare const HorizontalLayout: Story;
-/**
- * 垂直布局
- */
-export declare const VerticalLayout: Story;
-/**
- * 单行布局
- */
-export declare const InlineLayout: Story;
-/**
- * 单行布局 - 自定义分隔符
- */
-export declare const InlineWithCustomSeparator: Story;
-/**
- * 中文完整日期格式：2025-12-31 - 2:00 周四
- * 单行、日期在前、日期与时间之间 " - "、时间与星期之间空格
- */
-export declare const InlineDateTimeWeekdayZh: Story;
-/**
- * 12小时制
- */
-export declare const Time12Hour: Story;
-/**
- * 显示秒
- */
-export declare const TimeWithSeconds: Story;
-/**
- * 12小时制 + 显示秒
- */
-export declare const Time12HourWithSeconds: Story;
-/**
- * 小时补零
- */
-export declare const TimePadHour: Story;
-/**
- * 只显示小时
- */
-export declare const TimeOnlyHour: Story;
-/**
- * 完整日期（Y-M-D）
- */
-export declare const DateFullYMD: Story;
-/**
- * 月-日-年 格式
- */
-export declare const DateMDY: Story;
-/**
- * 日-月-年 格式
- */
-export declare const DateDMY: Story;
-/**
- * 中文日期带单位
- */
-export declare const DateChinese: Story;
-/**
- * 相对日：今天/昨天/明天
- * 与「当前日期」同天显示「今天」，前一天「昨天」，后一天「明天」；其他日期仍按原格式。
- * 参考日为 dayjs()，随时间变化：例如 2 月 4 日当天，2 月 4 日显示「今天」，2 月 3 日显示「昨天」。
- */
-export declare const RelativeDay: Story;
-/**
- * 相对日 - 英文
- */
-export declare const RelativeDayEn: Story;
-/**
- * 相对日 - 自定义文案
- */
-export declare const RelativeDayCustomLabels: Story;
-/**
- * 英文完整月份
- */
-export declare const DateFullMonth: Story;
-/**
- * 自定义分隔符
- */
-export declare const DateCustomSeparator: Story;
-/**
- * 星期完整展示（英文）
- */
-export declare const WeekdayFull: Story;
-/**
- * 星期完整展示（中文）
- */
-export declare const WeekdayFullChinese: Story;
-/**
- * 星期单字母展示
- */
-export declare const WeekdaySingleLetter: Story;
-/**
- * 只显示时间
- */
-export declare const OnlyTime: Story;
-/**
- * 只显示日期
- */
-export declare const OnlyDate: Story;
-/**
- * 自定义字段顺序
- */
-export declare const CustomFieldOrder: Story;
-/**
- * 自定义格式化 - ISO 格式
- */
-export declare const CustomFormatISO: Story;
-/**
- * 自定义格式化 - 中文格式
- */
-export declare const CustomFormatChinese: Story;
-/**
- * 自定义格式化 - 包含星期
- */
-export declare const CustomFormatWithWeekday: Story;
-/**
- * 中文环境
- */
-export declare const LocaleChinese: Story;
-/**
- * 英文环境
- */
-export declare const LocaleEnglish: Story;
-/**
- * 自定义容器样式
- */
-export declare const CustomContainerStyle: Story;
-/**
- * 自定义文本样式
- */
-export declare const CustomTextStyle: Story;
-/**
- * 居中对齐
- */
-export declare const CenterAlign: Story;
-/**
- * 禁用自动刷新
- */
-export declare const DisableRefresh: Story;
-/**
- * 自定义刷新间隔（5秒）
- */
-export declare const CustomRefreshInterval: Story;
-/**
- * 应用场景 - 后台首页
- */
-export declare const ScenarioDashboard: Story;
-/**
- * 应用场景 - 状态栏
- */
-export declare const ScenarioStatusBar: Story;
-/**
- * 应用场景 - 欢迎页
- */
-export declare const ScenarioWelcome: Story;
-/**
- * 应用场景 - 大屏展示
- */
-export declare const ScenarioLargeScreen: Story;
-/**
- * 多语言对比
- */
-export declare const MultiLanguage: Story;
-/**
- * 时间格式对比
- */
-export declare const TimeFormats: Story;
-/**
- * 日期格式对比
- */
-export declare const DateFormats: Story;
-/**
- * 星期格式对比
- */
-export declare const WeekdayFormats: Story;
-/**
- * 所有布局对比
- */
-export declare const AllLayouts: Story;
-/**
- * 深色主题
- */
-export declare const DarkTheme: Story;

package/lib/components/pisellDateTimeDisplay/components/DateDisplay.d.ts

@@ -1,48 +0,0 @@
-import React from 'react';
-import { type Dayjs } from 'dayjs';
-import type { DateFormatConfig, TextStyleConfig } from '../types';
-/**
- * DateDisplay 组件 Props
- */
-export interface DateDisplayProps {
-    /**
-     * 日期对象
-     */
-    date: Dayjs;
-    /**
-     * 日期格式配置
-     */
-    format?: DateFormatConfig;
-    /**
-     * 参考日期（用于「今天/昨天/明天」判定，默认当前时间 dayjs()）
-     */
-    referenceDate?: Dayjs;
-    /**
-     * 文本样式
-     */
-    style?: TextStyleConfig;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * 日期展示组件
- *
- * @description
- * - 格式化并展示日期
- * - 支持 showRelativeDay：今天/昨天/明天时用相对日替换原日期展示，不展示具体日期
- * - 支持不同的日期顺序（YMD/MDY/DMY）
- * - 支持年月日字段显隐
- * - 支持中文单位（年、月、日）
- * - 支持英文月份格式（简写/完整/数字）
- *
- * @example
- * <DateDisplay
- *   date={dayjs()}
- *   format={{ order: 'YMD', showYear: true, showChineseUnit: true }}
- *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
- * />
- */
-export declare const DateDisplay: React.FC<DateDisplayProps>;
-export default DateDisplay;

package/lib/components/pisellDateTimeDisplay/components/TimeDisplay.d.ts

@@ -1,42 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-import type { TimeFormatConfig, TextStyleConfig } from '../types';
-/**
- * TimeDisplay 组件 Props
- */
-export interface TimeDisplayProps {
-    /**
-     * 时间对象
-     */
-    time: Dayjs;
-    /**
-     * 时间格式配置
-     */
-    format?: TimeFormatConfig;
-    /**
-     * 文本样式
-     */
-    style?: TextStyleConfig;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * 时间展示组件
- *
- * @description
- * - 格式化并展示时间
- * - 支持 12/24 小时制
- * - 支持显示秒
- * - 支持小时补零
- *
- * @example
- * <TimeDisplay
- *   time={dayjs()}
- *   format={{ use12Hour: false, showSeconds: true }}
- *   style={{ fontSize: 24, fontWeight: 600, color: '#000' }}
- * />
- */
-export declare const TimeDisplay: React.FC<TimeDisplayProps>;
-export default TimeDisplay;

package/lib/components/pisellDateTimeDisplay/components/WeekdayDisplay.d.ts

@@ -1,57 +0,0 @@
-import React from 'react';
-import type { Dayjs } from 'dayjs';
-import type { WeekdayFormatConfig, TextStyleConfig } from '../types';
-/**
- * WeekdayDisplay 组件 Props
- */
-export interface WeekdayDisplayProps {
-    /**
-     * 日期对象（用于获取星期）
-     */
-    weekday: Dayjs;
-    /**
-     * 星期格式配置
-     */
-    format?: WeekdayFormatConfig;
-    /**
-     * 文本样式
-     */
-    style?: TextStyleConfig;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-}
-/**
- * 星期展示组件
- *
- * @description
- * - 格式化并展示星期
- * - 支持完整/缩写/单字母模式
- * - 自动支持中英文
- *
- * @example
- * // 默认（缩写）
- * <WeekdayDisplay
- *   weekday={dayjs()}
- *   format={{ full: false, singleLetter: false }}
- *   style={{ fontSize: 18, fontWeight: 400, color: '#666' }}
- * />
- * // => "Sat" / "周六"
- *
- * // 完整
- * <WeekdayDisplay
- *   weekday={dayjs()}
- *   format={{ full: true }}
- * />
- * // => "Saturday" / "星期六"
- *
- * // 单字母
- * <WeekdayDisplay
- *   weekday={dayjs()}
- *   format={{ singleLetter: true }}
- * />
- * // => "S" / "六"
- */
-export declare const WeekdayDisplay: React.FC<WeekdayDisplayProps>;
-export default WeekdayDisplay;

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

@@ -1,6 +0,0 @@
-export { TimeDisplay } from './TimeDisplay';
-export { DateDisplay } from './DateDisplay';
-export { WeekdayDisplay } from './WeekdayDisplay';
-export type { TimeDisplayProps } from './TimeDisplay';
-export type { DateDisplayProps } from './DateDisplay';
-export type { WeekdayDisplayProps } from './WeekdayDisplay';

package/lib/components/pisellDateTimeDisplay/hooks/index.d.ts

@@ -1,2 +0,0 @@
-export { useCurrentTime } from './useCurrentTime';
-export type { UseCurrentTimeOptions } from './useCurrentTime';

package/lib/components/pisellDateTimeDisplay/hooks/useCurrentTime.d.ts

@@ -1,46 +0,0 @@
-import { Dayjs } from 'dayjs';
-/**
- * useCurrentTime Hook 配置项
- */
-export interface UseCurrentTimeOptions {
-    /**
-     * 刷新间隔（毫秒）
-     * @default 60000
-     */
-    refreshInterval?: number;
-    /**
-     * 是否禁用自动刷新
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * dayjs locale
-     * @default 优先使用全局配置，其次使用 i18n 当前语言（getCurrentLocale）
-     * @example 'zh-CN' | 'zh-HK' | 'en' | 'en-US' | 'ja'
-     */
-    locale?: string;
-    /**
-     * 时间更新回调
-     */
-    onUpdate?: (time: Dayjs) => void;
-}
-/**
- * 管理当前时间状态的自定义 Hook
- *
- * @description
- * - 自动创建定时器刷新时间
- * - 支持自定义刷新间隔
- * - 支持国际化（locale）：优先级为 用户指定 > 全局配置 > i18n 当前语言
- * - 组件卸载时自动清除定时器
- *
- * @example
- * const currentTime = useCurrentTime({
- *   refreshInterval: 1000,
- *   locale: 'zh-CN',
- *   onUpdate: (time) => console.log(time.format())
- * });
- *
- * @param options 配置项
- * @returns 当前时间（Dayjs 对象）
- */
-export declare function useCurrentTime(options?: UseCurrentTimeOptions): Dayjs;

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

@@ -1,3 +0,0 @@
-export { default as PisellDateTimeDisplay } from './PisellDateTimeDisplay';
-export type { PisellDateTimeDisplayProps, LayoutDirection, DateOrder, TextAlign, FieldType, TimeFormatConfig, DateFormatConfig, WeekdayFormatConfig, FieldConfig, TextStyleConfig, ContainerStyleConfig, } from './types';
-export { default } from './PisellDateTimeDisplay';

package/lib/components/pisellDateTimeDisplay/utils/formatDate.d.ts

@@ -1,21 +0,0 @@
-import type { Dayjs } from 'dayjs';
-import type { DateFormatConfig } from '../types';
-/**
- * 格式化日期
- * @param date dayjs 日期对象
- * @param config 日期格式配置
- * @returns 格式化后的日期字符串
- *
- * @example
- * // 英文环境
- * formatDate(dayjs(), { order: 'YMD', shortMonth: true, showYear: true })
- * // => "2026-Mar-21"
- *
- * // 中文环境
- * formatDate(dayjs(), { order: 'YMD', showChineseUnit: true, showYear: true })
- * // => "2026年3月21日"
- *
- * formatDate(dayjs(), { order: 'MDY', shortMonth: false, showYear: true })
- * // => "March 21, 2026"
- */
-export declare function formatDate(date: Dayjs, config?: DateFormatConfig): string;

package/lib/components/pisellDateTimeDisplay/utils/formatDateOrRelative.d.ts

@@ -1,17 +0,0 @@
-import type { Dayjs } from 'dayjs';
-import type { DateFormatConfig, WeekdayFormatConfig } from '../types';
-/**
- * 获取「日期部分」的展示文案（相对日内置在 datetime）
- * - 若开启 showRelativeDay 且日期为今天/昨天/明天，返回相对日文案（如「今天」「Yesterday」）
- * - 否则返回「星期, 日期」格式（用于时间区间跨天等场景）
- *
- * 供 PisellDateTimeDisplay、PisellTimeRangeDisplay 等统一使用，相对时间逻辑只在此处维护
- */
-export declare function getDatePartDisplay(params: {
-    date: Dayjs;
-    dateFormat?: DateFormatConfig;
-    weekdayFormat?: WeekdayFormatConfig;
-    referenceDate: Dayjs;
-    /** 覆盖日期格式（如跨天时的 order: 'DMY', shortMonth: true） */
-    dateFormatOverride?: Partial<DateFormatConfig>;
-}): string;