@pisell/materials 6.11.15 → 6.11.17

package/es/components/filter/types.d.ts

@@ -0,0 +1,48 @@
+import { ModeType } from "../table/types";
+/**
+ * 筛选总配置
+ */
+export declare type FilterType = {
+    /** 筛选是否展示 */
+    show: boolean;
+    /** 筛选项排序按钮是否展示 */
+    sortButtonShow: boolean;
+    /** 筛选列表 */
+    list: FilterItemProps[];
+    items?: string[];
+    /** 快速筛选最大长度 */
+    quickFilterMaxLength: number;
+    /** 配置存储模式 */
+    storageMode: "" | "localStorage";
+    /** 筛选列表项dom */
+    dom?: any;
+};
+/**
+ * 筛选列表项配置
+ * - type 为 single/input/rangePicker 等时使用内置或映射组件
+ * - type 为 "custom" 时使用 other.component，组件接收 value/onChange（由 Form 注入）
+ */
+export declare type FilterItemProps = {
+    type: "single" | "input" | "datePicker" | "rangePicker" | "rangePickerNew" | "search" | "custom";
+    name?: string | string[];
+    key: string;
+    props?: object;
+    label?: string;
+    sort?: boolean;
+    localFilter?: boolean;
+    other: Record<string, any>;
+    isCustom?: boolean;
+    columnKey?: string;
+    isHidden?: boolean;
+};
+/**
+ * 筛选组件属性
+ */
+export interface FilterProps {
+    filter: FilterType;
+    isRenderFormContent: boolean;
+    onValuesChange?: () => void;
+    tableId?: string;
+    viewMode?: ModeType;
+    isMobile?: boolean;
+}

package/es/components/keyboard/index.d.ts

@@ -18,5 +18,5 @@ export interface KeyboardProps {
     rightItems?: Item[];
     keydown?: boolean;
 }
-declare const _default: React.MemoExoticComponent<(props: KeyboardProps) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<(props: KeyboardProps) => React.JSX.Element>;
 export default _default;

package/es/components/list/index.d.ts

@@ -1,6 +1,7 @@
+import React from "react";
 import "./index.less";
 declare const List: {
-    (props: any): JSX.Element;
+    (props: any): React.JSX.Element;
     Item: import("antd/es/list/Item").ListItemTypeProps;
 };
 export default List;

package/es/components/lowCodePage/index.d.ts

@@ -1,5 +1,6 @@
+import React from "react";
 declare type LowCodePageProps = {
     id: number;
 };
-declare const LowCodePage: (props: LowCodePageProps) => JSX.Element;
+declare const LowCodePage: (props: LowCodePageProps) => React.JSX.Element;
 export default LowCodePage;

package/es/components/page/index.d.ts

@@ -1,8 +1,9 @@
+import React from 'react';
 import { ConfigProviderProps } from '../config-provider';
 interface PageProps extends ConfigProviderProps {
     variablesConfig?: {
         disabledHistoryListener?: boolean;
     };
 }
-declare const Page: (props: PageProps) => JSX.Element;
+declare const Page: (props: PageProps) => React.JSX.Element;
 export default Page;

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

@@ -10,5 +10,5 @@ interface PageHeaderProps {
     className?: string;
     style?: React.CSSProperties;
 }
-declare const PageHeader: (props: PageHeaderProps) => JSX.Element | null;
+declare const PageHeader: (props: PageHeaderProps) => React.JSX.Element | null;
 export default PageHeader;

package/es/components/pisellAdjustPrice/PisellAdjustPriceInputNumber.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="react" />
+import React from 'react';
 import { InputNumberProps } from 'antd/es/input-number';
 export interface PisellAdjustPriceInputNumberProps extends Omit<InputNumberProps, 'onChange'> {
     value?: number;
@@ -6,5 +6,5 @@ export interface PisellAdjustPriceInputNumberProps extends Omit<InputNumberProps
     defaultValue?: number;
     onChange?: (val: number) => void;
 }
-declare const PisellAdjustPriceInputNumber: (props: PisellAdjustPriceInputNumberProps) => JSX.Element;
+declare const PisellAdjustPriceInputNumber: (props: PisellAdjustPriceInputNumberProps) => React.JSX.Element;
 export default PisellAdjustPriceInputNumber;

package/es/components/pisellAdjustPrice/index.d.ts

@@ -1,4 +1,5 @@
+import React from 'react';
 import './index.less';
 import { PisellAdjustPriceProps } from './type';
-declare const PisellAdjustPrice: (props: PisellAdjustPriceProps) => JSX.Element;
+declare const PisellAdjustPrice: (props: PisellAdjustPriceProps) => React.JSX.Element;
 export default PisellAdjustPrice;

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

@@ -18,5 +18,5 @@ export interface PisellAlertProps extends AlertProps {
  * @param props
  * @constructor
  */
-declare const PisellAlert: (props: PisellAlertProps) => false | JSX.Element;
+declare const PisellAlert: (props: PisellAlertProps) => false | React.JSX.Element;
 export default PisellAlert;

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

@@ -1,4 +1,4 @@
-/// <reference types="react" />
+import React from 'react';
 import { CardProps } from 'antd';
 import './index.less';
 export interface PisellCardProps extends CardProps {
@@ -16,5 +16,5 @@ export interface PisellCardProps extends CardProps {
  * @param props
  * @constructor
  */
-declare const PisellCard: (props: PisellCardProps) => JSX.Element;
+declare const PisellCard: (props: PisellCardProps) => React.JSX.Element;
 export default PisellCard;

package/es/components/pisellCheckboxGroup/index.d.ts

@@ -36,5 +36,5 @@ export interface PisellCheckboxGroupProps extends React.HTMLAttributes<HTMLDivEl
  * @Author: zhiwei.Wang
  * @Date: 2024-08-16 10:34
  */
-declare const PisellCheckboxGroup: (props: PisellCheckboxGroupProps) => JSX.Element;
+declare const PisellCheckboxGroup: (props: PisellCheckboxGroupProps) => React.JSX.Element;
 export default PisellCheckboxGroup;

package/es/components/pisellCountdown/index.d.ts

@@ -20,5 +20,5 @@ export declare type PisellCountdownProps = React.HTMLAttributes<HTMLSpanElement>
     /** 格式化倒计时展示 参考 dayjs */
     format?: string;
 };
-declare const PisellCountdown: (props: PisellCountdownProps) => JSX.Element;
+declare const PisellCountdown: (props: PisellCountdownProps) => React.JSX.Element;
 export default PisellCountdown;

package/es/components/pisellCurrency/PisellCurrency.stories.d.ts

@@ -0,0 +1,56 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellCurrency } from './PisellCurrency';
+/**
+ * PisellCurrency 组件 Storybook
+ */
+declare const meta: Meta<typeof PisellCurrency>;
+export default meta;
+declare type Story = StoryObj<typeof PisellCurrency>;
+/**
+ * 基础示例 - 人民币
+ */
+export declare const Basic: Story;
+/**
+ * 不同货币
+ */
+export declare const DifferentCurrencies: Story;
+/**
+ * 只读态展示
+ */
+export declare const ReadOnly: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 不显示货币符号
+ */
+export declare const WithoutSymbol: Story;
+/**
+ * 禁止负数（商品价格）
+ */
+export declare const NoNegative: Story;
+/**
+ * 允许负数（退款金额）
+ */
+export declare const AllowNegative: Story;
+/**
+ * 表单场景
+ */
+export declare const InForm: Story;
+/**
+ * 表格场景
+ */
+export declare const InTable: Story;
+/**
+ * 不同精度
+ */
+export declare const DifferentPrecision: Story;
+/**
+ * 只读态样式
+ */
+export declare const ReadOnlyStyles: Story;
+/**
+ * 空值处理
+ */
+export declare const EmptyValue: Story;

package/es/components/pisellCurrency/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * PisellCurrency 组件导出
+ */
+import PisellCurrency from './PisellCurrency';
+export { PisellCurrency };
+export type { PisellCurrencyProps } from './types';
+export type { DisplayState, ValidationResult, NumberInputState, BaseNumberInputProps } from './types';

package/es/components/pisellDataSourceContainer/PisellDataSourceContainer.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DataSourceContainerProps } from './type';
-declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => JSX.Element;
+declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => React.JSX.Element;
 export default PisellDataSourceContainer;

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

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

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

@@ -1,5 +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 HandleActionsProvider: (props: DataSourceContainerProps) => React.JSX.Element;
 export declare const useHandleActionProvider: () => HandleActionContextType;

package/es/components/pisellDatePicker/datePickerCpt.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="react" />
+import React from 'react';
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './detePickerCpt.less';
@@ -18,5 +18,5 @@ export interface DatePickerCptProps extends PickerDateProps<Dayjs> {
  * @param props
  * @constructor
  */
-declare const DatePickerCpt: (props: DatePickerCptProps) => JSX.Element;
+declare const DatePickerCpt: (props: DatePickerCptProps) => React.JSX.Element;
 export default DatePickerCpt;

package/es/components/pisellDatePicker/index.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="react" />
-declare const PisellDatePicker: (props: any) => JSX.Element;
+declare const PisellDatePicker: (props: any) => import("react").JSX.Element;
 export default PisellDatePicker;

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

@@ -0,0 +1,7 @@
+import type { DateTimeDisplayFormatPreset } from '../types';
+/**
+ * PisellDateTimeDisplay 按语言预设的格式
+ * - zh-cn：完整日期 - 时间 星期（如 2025-12-31 - 2:00 周四）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
+ * - en：时间 星期, 日期（如 2:00 Sat, 21 Mar, 2026）；默认不展示相对日，可传 dateFormat.showRelativeDay: true 开启
+ */
+export declare const DATETIME_DISPLAY_FORMATS: Record<string, Partial<DateTimeDisplayFormatPreset>>;

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

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