@pisell/materials 6.3.26 → 6.3.27

package/lib/components/page/index.js

@@ -42,6 +42,8 @@ var import_en_US = __toESM(require("antd/es/locale/en_US"));
 var import_zh_CN = __toESM(require("antd/es/locale/zh_CN"));
 var import_zh_TW = __toESM(require("antd/es/locale/zh_TW"));
 var import_zh_HK = __toESM(require("antd/es/locale/zh_HK"));
+var import_ja_JP = __toESM(require("antd/es/locale/ja_JP"));
+var import_pt_PT = __toESM(require("antd/es/locale/pt_PT"));
 var import_pisell_config_provider = __toESM(require("../pisell-config-provider"));
 var import_useEngineContext = __toESM(require("../../hooks/useEngineContext"));
 var import_tokens = require("../../theme/tokens");
@@ -50,7 +52,9 @@ var localMap = {
   "zh-CN": import_zh_CN.default,
   "zh-HK": import_zh_HK.default,
   "en-US": import_en_US.default,
-  en: import_en_US.default
+  en: import_en_US.default,
+  "ja": import_ja_JP.default,
+  "pt": import_pt_PT.default
 };
 var localeDateMap = {
   "en-US": {
@@ -67,6 +71,12 @@ var localeDateMap = {
   },
   "zh-CN": {
     adapterLocale: "zh-cn"
+  },
+  "ja": {
+    adapterLocale: "ja"
+  },
+  "pt": {
+    adapterLocale: "pt"
   }
 };
 var Page = (props) => {

package/lib/components/page-header/index.d.ts

@@ -0,0 +1,14 @@
+import React from 'react';
+import './index.less';
+interface PageHeaderProps {
+    title?: React.ReactNode;
+    showTitle?: boolean;
+    subTitle?: React.ReactNode;
+    showSubTitle?: boolean;
+    showDivider?: boolean;
+    extra?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const PageHeader: (props: PageHeaderProps) => React.JSX.Element | null;
+export default PageHeader;

package/lib/components/pisellAdjustPrice/status.d.ts

@@ -0,0 +1,32 @@
+export declare const defaultConfig: {
+    dark: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+    light: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+};

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

@@ -0,0 +1,22 @@
+import React from 'react';
+import { AlertProps } from 'antd';
+import './index.less';
+export interface PisellAlertProps extends AlertProps {
+    /** 是否展示忽略按钮 */
+    showDismiss?: boolean;
+    /** 忽略按钮内容 */
+    dismiss?: React.ReactNode;
+    /** 是否展示行为按钮 */
+    showView?: boolean;
+    /** 行为按钮内容 */
+    view?: React.ReactNode;
+    /** 行为按钮点击事件 */
+    onViewClick?: (e: any) => void;
+}
+/**
+ * PisellAlert警告提示组件
+ * @param props
+ * @constructor
+ */
+declare const PisellAlert: (props: PisellAlertProps) => false | React.JSX.Element;
+export default PisellAlert;

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

@@ -0,0 +1,23 @@
+import React from 'react';
+import './index.less';
+export interface Option {
+    id: string | number;
+    name: React.ReactNode;
+}
+export interface PisellAnchorProps {
+    options?: Option[];
+    tab?: string | number;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (key: string | number) => void;
+    onTabClick?: () => void;
+    containerRef?: React.RefObject<HTMLElement>;
+    /**
+     * 平台类型，仅用于样式调整，不再影响锚点滚动功能
+     * 无论pc还是h5模式，点击锚点都会自动滚动到对应内容
+     * @default 'pc'
+     */
+    platform?: 'pc' | 'h5';
+}
+declare const PisellAnchor: React.FC<PisellAnchorProps>;
+export default PisellAnchor;

package/lib/components/pisellAppCard/PisellAppCard.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellAppCardProps } from './types';
+import './PisellAppCard.less';
+declare const PisellAppCard: React.FC<PisellAppCardProps>;
+export default PisellAppCard;

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

@@ -0,0 +1,3 @@
+import PisellAppCard from './PisellAppCard';
+export default PisellAppCard;
+export type { PisellAppCardProps } from './types';

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

@@ -0,0 +1,34 @@
+import { CSSProperties } from 'react';
+export interface PisellAppCardProps {
+    /** 类名 */
+    className?: string;
+    /** 样式 */
+    style?: CSSProperties;
+    /** 头像地址 */
+    avatar?: string;
+    /** icon */
+    icon?: string;
+    /** 标签列表 */
+    tags?: Array<{
+        label: string;
+        color?: 'success' | 'warning' | 'error' | 'gray';
+        type: 'pill_color' | 'pill_outline';
+    }>;
+    /** 标题 */
+    title: string;
+    /** 描述 */
+    description?: string;
+    /** 底部按钮列表 */
+    bottomButtons?: Array<{
+        label: string;
+        onClick?: () => void;
+        type?: 'primary' | 'default' | 'dashed' | 'link' | 'text';
+        hidden: boolean;
+    }>;
+    /** 右侧更多操作列表 */
+    moreActions?: Array<{
+        label: string;
+        onClick?: () => void;
+        icon?: React.ReactNode;
+    }>;
+}

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

@@ -0,0 +1,19 @@
+import React from 'react';
+import type { AvatarProps } from 'antd';
+import './index.less';
+export declare type AvatarSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+export interface PisellAvatarProps extends Omit<AvatarProps, 'size' | 'shape'> {
+    shape?: 'circle' | 'square';
+    size?: AvatarSize;
+    src?: string;
+    alt?: string;
+    icon?: React.ReactNode;
+    children?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    useTextAvatar?: boolean;
+    borderRadius?: number;
+    onError?: () => boolean;
+}
+declare const PisellAvatar: React.FC<PisellAvatarProps>;
+export default PisellAvatar;

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

@@ -0,0 +1,20 @@
+import React from 'react';
+import { CardProps } from 'antd';
+import './index.less';
+export interface PisellCardProps extends CardProps {
+    bordered?: boolean;
+    selected?: boolean;
+    loading?: boolean;
+    padding?: number;
+    borderRadius?: number;
+    disabled?: boolean;
+    onClick?: () => void;
+    isClickable?: boolean;
+}
+/**
+ * Pisell 卡片容器组件
+ * @param props
+ * @constructor
+ */
+declare const PisellCard: (props: PisellCardProps) => React.JSX.Element;
+export default PisellCard;

package/lib/components/pisellCheckboxGroup/mock.d.ts

@@ -0,0 +1,4 @@
+export declare const mockList: {
+    label: string;
+    value: string;
+}[];

package/lib/components/pisellCountdown/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 格式化时间字符串函数
+ * 该函数将给定的持续时间（以秒为单位）格式化为指定格式的时间字符串
+ * @param duration - 持续时间，单位为秒。
+ * @param format - 时间格式字符串，其中包含要显示的时间单位及其格式。例如："[HH] hours, [mm] minutes, [ss] seconds"。
+ */
+export declare function formatTimeStr(duration: number, format: string): string;

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

@@ -0,0 +1,16 @@
+import React from 'react';
+import './index.less';
+export interface PisellCustomCheckboxGroupProps {
+    dataSource?: any[];
+    disabled?: boolean;
+    allowAdd?: boolean;
+    isMultiple?: boolean;
+    id?: string | string[];
+    onClick?: (value: any) => void;
+    onAdd?: () => void;
+    renderAddItem?: (item: any) => React.ReactNode;
+    [key: string]: any;
+    className?: string;
+}
+declare const PisellCustomCheckboxGroup: React.FC<PisellCustomCheckboxGroupProps>;
+export default PisellCustomCheckboxGroup;

package/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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/lib/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;