@pisell/materials 1.8.23 → 1.8.24

package/es/components/pisellDataSourceContainer/components/ColumnsSetting/index.d.ts

@@ -0,0 +1,28 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+export declare const COLUMNS_SHARED_STATE_KEYS: {
+    readonly columnsValue: (instanceId: string) => string;
+    readonly columnsChange: (instanceId: string) => string;
+};
+export interface ColumnsSettingProps {
+    scopeId?: string;
+    __id?: string;
+}
+export interface ColumnSettingItem {
+    key: string;
+    title: React.ReactNode;
+    titleString?: string;
+    dataIndex: string;
+    isShow: boolean;
+    sortIndex?: number;
+    fixed?: 'left' | 'right' | boolean;
+}
+/**
+ * 暴露给父组件的 ref 方法
+ */
+export interface ColumnsSettingRef {
+}
+declare const _default: React.ForwardRefExoticComponent<Omit<ColumnsSettingProps & DataSourceContainerContextType & React.RefAttributes<ColumnsSettingRef> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/ColumnsSetting/utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 列设置工具：持久化复用 @pisell/utils 的 saveColumnSettingToLocal / getColumnSettingFromLocal；
+ * mergeColumnSettingSimple 为 Table 列与本地缓存的合并逻辑，保留在此。
+ */
+import React from 'react';
+import { getColumnSettingFromLocal, clearColumnSettingFromLocal } from '@pisell/utils';
+export { getColumnSettingFromLocal, clearColumnSettingFromLocal };
+/** 与 DataSourceContainer ColumnsSetting 调用处类型兼容的列设置项（含 React.ReactNode title） */
+export interface ColumnSettingItemForSave {
+    key: string;
+    dataIndex: string;
+    title?: React.ReactNode;
+    titleString?: string;
+    isShow: boolean;
+    sortIndex?: number;
+    fixed?: 'left' | 'right' | boolean;
+}
+export declare const saveColumnSettingToLocal: (params: {
+    componentId: string;
+    columnSetting: ColumnSettingItemForSave[];
+}) => void;
+export declare const mergeColumnSettingSimple: ({ columns, componentId, }: {
+    columns: Record<string, any>[];
+    componentId?: string | undefined;
+}) => {
+    isShow: any;
+    sortIndex: any;
+}[];

package/es/components/pisellDataSourceContainer/components/Filter/FilterButton.d.ts

@@ -0,0 +1,7 @@
+import React from 'react';
+import { FormInstance } from 'antd';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("../../../filter/components/FilterButton/types").FilterListProps> & DataSourceContainerContextType & FormInstance<any> & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Filter/QuickFilter.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { FormInstance } from 'antd';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<{
+    filterList: import("../../../filter/types").FilterItemProps[];
+    formFiltersPrefix?: string | undefined;
+}> & DataSourceContainerContextType & FormInstance<any> & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Filter/index.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import { FormInstance } from 'antd';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<{
+    value: {
+        quickFilter?: import("../../../filter/types").FilterItemProps[] | undefined;
+        otherFilter?: import("../../../filter/types").FilterItemProps[] | undefined;
+    };
+    formFiltersPrefix?: string | undefined;
+    quickFilterMaxLength?: number | undefined;
+}> & DataSourceContainerContextType & FormInstance<any> & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Pagination/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("antd").PaginationProps> & DataSourceContainerContextType & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Sort/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { FormInstance } from 'antd';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("../../../sort/types").SortListProps> & DataSourceContainerContextType & {
+    name?: string | undefined;
+} & FormInstance<any> & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Table/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("antd").TableProps<any>> & DataSourceContainerContextType & {
+    scopeId?: string | undefined;
+    __id?: string | undefined;
+} & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/es/components/pisellDataSourceContainer/components/Table/useColumns.d.ts

@@ -0,0 +1,14 @@
+import { RefManagerContextType } from '../../type';
+/**
+ * useColumns Hook 参数
+ */
+interface UseColumnsParams {
+    columns: any[];
+    scopeId: string;
+    refManager: RefManagerContextType;
+    __id?: string;
+}
+declare const useColumns: (params: UseColumnsParams) => {
+    visibleColumns: any[];
+};
+export default useColumns;

package/es/components/pisellDataSourceContainer/hooks/useContainerContext.d.ts

@@ -0,0 +1,3 @@
+import { UseContainerContextReturnType } from '../type';
+declare const useContainerContext: (displayName?: string) => UseContainerContextReturnType;
+export default useContainerContext;

package/es/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -0,0 +1,5 @@
+declare const useDataSourceKey: () => {
+    dataSourceKey: string | undefined;
+    dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;
+};
+export default useDataSourceKey;

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

@@ -0,0 +1,32 @@
+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/es/components/pisellDataSourceContainer/index.d.ts

@@ -0,0 +1,28 @@
+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/es/components/pisellDataSourceContainer/provider/ChildComponentProps.d.ts

@@ -0,0 +1,13 @@
+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/es/components/pisellDataSourceContainer/provider/HandleActions.d.ts

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

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

@@ -0,0 +1,9 @@
+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/es/components/pisellDataSourceContainer/type.d.ts

@@ -0,0 +1,84 @@
+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/es/components/pisellDataSourceContainer/utils/withContainer.d.ts

@@ -0,0 +1,9 @@
+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/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.d.ts

@@ -0,0 +1,35 @@
+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/es/components/pisellDateTimeDisplay/PisellDateTimeDisplay.stories.d.ts

@@ -0,0 +1,195 @@
+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/es/components/pisellDateTimeDisplay/components/DateDisplay.d.ts

@@ -0,0 +1,48 @@
+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/es/components/pisellDateTimeDisplay/components/TimeDisplay.d.ts

@@ -0,0 +1,42 @@
+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;