@pisell/materials 6.11.223 → 6.11.225

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

@@ -0,0 +1,29 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../../types';
+export declare type FilterValueType = {
+    quickFilter: FilterItemProps[];
+    otherFilter: FilterItemProps[];
+    /** 筛选项表单值，字段名 -> 值，与 Form 的 values 一致 */
+    values?: Record<string, any>;
+};
+export declare type FilterListProps = {
+    value?: FilterValueType;
+    hiddenQuickFilter?: boolean;
+    hiddenOtherFilter?: boolean;
+    onChange?: (value: FilterValueType) => void;
+    quickFilterMaxLength: number;
+    formFiltersPrefix: string;
+    renderItem?: (item: any, otherProps?: any) => React.ReactNode;
+    placement?: 'top' | 'left' | 'right' | 'bottom' | 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight' | 'leftTop' | 'leftBottom' | 'rightTop' | 'rightBottom';
+    /** 筛选按钮尺寸，与 antd Button size 一致 */
+    size?: 'small' | 'middle' | 'large';
+    /** 筛选触发按钮的 className，用于定制样式（如与设计系统对齐） */
+    buttonClassName?: string;
+    /** 筛选按钮文案，不传则使用 materials 内置多语言 */
+    buttonText?: string;
+    /**
+     * 手机窄屏布局：筛选项内下拉禁用搜索框，并避免打开时自动聚焦。
+     * RecordBoard compact-narrow / 预约手机 Table 等场景传入。
+     */
+    phoneLayout?: boolean;
+};

package/es/components/filter/components/FilterItem/AsyncOptionsSelectWrapper.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 筛选项中 singleSelect/multipleSelect 的异步 options 包装器。
+ * 当列配置传入 getOptions（同步或异步）时，先解析再渲染 PisellSingleSelect/PisellMultipleSelect。
+ */
+import React from 'react';
+export declare type GetOptionsFn = (() => {
+    label: string;
+    value: any;
+}[]) | (() => Promise<{
+    label: string;
+    value: any;
+}[]>);
+export interface AsyncOptionsSelectWrapperProps {
+    getOptions: GetOptionsFn;
+    fieldType: 'singleSelect' | 'multipleSelect';
+    value?: any;
+    onChange?: (value: any, option?: any) => void;
+    [key: string]: any;
+}
+declare const AsyncOptionsSelectWrapper: React.FC<AsyncOptionsSelectWrapperProps>;
+export default AsyncOptionsSelectWrapper;

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

@@ -0,0 +1,52 @@
+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 注入）
+ *
+ * other 扩展（节选）：
+ * - useAntdMobileRangePicker?: 手机布局下是否用 PisellMobileDateRangePicker（antd-mobile）替代 MUI 单框范围；
+ *   true 强制启用（无 showTime 时）；false 强制关闭；缺省时仅对字段名 orderDate 自动启用。
+ */
+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

@@ -0,0 +1,22 @@
+import React from 'react';
+import './index.less';
+export declare type ItemValue = string | number;
+export interface Item {
+    value: ItemValue;
+    label: React.ReactNode;
+    disabled: boolean;
+    type: 'text' | 'primary';
+    style?: React.CSSProperties;
+    size?: number;
+}
+export interface KeyboardProps {
+    id?: string;
+    className?: string;
+    style?: React.CSSProperties;
+    onChange?: (value?: ItemValue) => void;
+    items?: Item[];
+    rightItems?: Item[];
+    keydown?: boolean;
+}
+declare const _default: React.MemoExoticComponent<(props: KeyboardProps) => JSX.Element>;
+export default _default;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellBatchActionBar 组件导出
+ * @description 批量操作栏组件，用于承载基于选中对象的批量行为操作
+ */
+export { default } from './PisellBatchActionBar';
+export type { PisellBatchActionBarProps, BatchActionItem, DefaultActionsConfig, BatchActionConfirmConfig, BatchActionBarPosition, } from './types';

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

@@ -0,0 +1,237 @@
+import type { CSSProperties, ReactNode } from 'react';
+/**
+ * 布局模式
+ */
+export declare type BatchActionBarPosition = 'sticky-top' | 'sticky-bottom' | 'float' | 'inline';
+/**
+ * 确认弹窗配置
+ */
+export interface BatchActionConfirmConfig {
+    /**
+     * 弹窗标题
+     */
+    title?: string;
+    /**
+     * 弹窗描述内容
+     */
+    description?: string;
+    /**
+     * 确认按钮文案
+     */
+    okText?: string;
+    /**
+     * 取消按钮文案
+     */
+    cancelText?: string;
+}
+/**
+ * 默认操作按钮配置
+ * @description 固定四个基础操作按钮：全选、反选、取消选择、删除
+ */
+export interface DefaultActionsConfig {
+    /**
+     * 是否显示默认操作按钮（全选、反选、取消选择、删除）
+     * @default true
+     */
+    showDefaultActions?: boolean;
+    /**
+     * 是否显示全选按钮
+     * @default true
+     */
+    showSelectAll?: boolean;
+    /**
+     * 是否显示反选按钮
+     * @default true
+     */
+    showInvert?: boolean;
+    /**
+     * 是否显示取消选择按钮
+     * @default true
+     */
+    showClear?: boolean;
+    /**
+     * 是否显示删除按钮
+     * @default true
+     */
+    showDelete?: boolean;
+}
+/**
+ * 自定义操作按钮配置
+ */
+export interface BatchActionItem {
+    /**
+     * 操作唯一标识
+     */
+    key: string;
+    /**
+     * 按钮文案
+     */
+    label: ReactNode;
+    /**
+     * 按钮图标
+     */
+    icon?: ReactNode;
+    /**
+     * 按钮尺寸
+     * @description 对应 GraphicTextCard 的 size 属性
+     * @default 'small'
+     */
+    size?: 'small' | 'default' | 'large';
+    /**
+     * 是否禁用
+     * @description 支持函数形式，基于 selection 动态判断
+     */
+    disabled?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示
+     * @description 支持函数形式，基于 selection 动态判断
+     * @default true
+     */
+    visible?: boolean | ((selectedKeys: React.Key[], selectedRows?: any[]) => boolean);
+    /**
+     * 是否显示 loading 状态
+     */
+    loading?: boolean;
+    /**
+     * 是否需要确认弹窗
+     * @default false
+     */
+    confirm?: boolean | BatchActionConfirmConfig;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 按钮组标识
+     * @description 相同 group 的按钮会分组展示
+     */
+    group?: string;
+    /**
+     * 按钮点击回调
+     * @description 如果配置了此回调，会优先使用此回调，否则使用组件级别的 onActionClick
+     */
+    onClick?: (selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}
+/**
+ * PisellBatchActionBar 组件 Props
+ * @description 批量操作栏组件，用于承载基于选中对象的批量行为操作
+ */
+export interface PisellBatchActionBarProps {
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+    /**
+     * 选中的 key 数组
+     * @description 必填，用于感知选择状态
+     */
+    selectedKeys: React.Key[];
+    /**
+     * 选中的行数据数组
+     * @description 可选，用于传递给操作回调
+     */
+    selectedRows?: any[];
+    /**
+     * 总数据量
+     * @description 用于判断全选状态
+     */
+    total?: number;
+    /**
+     * 当前页数据量
+     * @description 用于判断全选当前页状态
+     */
+    currentPageTotal?: number;
+    /**
+     * 当前页数据 key 数组
+     * @description 用于判断全选当前页状态
+     */
+    currentPageKeys?: React.Key[];
+    /**
+     * 布局模式
+     * @default 'float'
+     */
+    position?: BatchActionBarPosition;
+    /**
+     * 吸顶/吸底时的偏移量
+     * @default 0
+     */
+    offset?: number;
+    /**
+     * 是否显示选中数量提示
+     * @default true
+     */
+    showSelectedCount?: boolean;
+    /**
+     * 选中数量提示文案
+     * @description 支持字符串模板（使用 {count} 占位符）或函数形式，默认使用国际化文本
+     * @default getText('batch-action-bar-selected-count', count)
+     */
+    selectedCountText?: string | ((count: number) => string);
+    /**
+     * 默认操作按钮配置
+     * @description 只包含前三个基础选择操作按钮，其他操作按钮通过 actions 传入
+     */
+    defaultActions?: DefaultActionsConfig;
+    /**
+     * 自定义操作按钮配置
+     */
+    actions?: BatchActionItem[];
+    /**
+     * 操作按钮排序
+     * @description 通过 key 数组控制按钮顺序
+     */
+    actionOrder?: string[];
+    /**
+     * 是否启用溢出折叠
+     * @default true
+     */
+    enableOverflow?: boolean;
+    /**
+     * 溢出折叠阈值（按钮数量）
+     * @default 5
+     */
+    overflowThreshold?: number;
+    /**
+     * "更多"按钮文案
+     * @description 默认使用国际化文本
+     * @default getText('batch-action-bar-more')
+     */
+    moreText?: string;
+    /**
+     * 全选回调
+     */
+    onSelectAll?: () => void;
+    /**
+     * 反选回调
+     * @description 反选操作，将当前选中的变为未选中，未选中的变为选中
+     */
+    onInvert?: () => void;
+    /**
+     * 清空选择回调
+     */
+    onClear?: () => void;
+    /**
+     * 删除回调
+     * @description 删除选中项，点击后会先弹出确认弹窗
+     */
+    onDelete?: (selectedKeys: React.Key[], selectedRows?: any[]) => void;
+    /**
+     * 删除确认弹窗配置
+     * @description 自定义删除确认弹窗的标题和内容
+     */
+    deleteConfirmConfig?: BatchActionConfirmConfig;
+    /**
+     * 自定义操作按钮点击回调
+     * @description 当 actions 中的按钮被点击时触发，通过 action.key 区分不同的操作
+     * @description 如果 action 中配置了 onClick，则优先使用 action.onClick
+     */
+    onActionClick?: (key: string, selectedKeys: React.Key[], selectedRows?: any[]) => void | Promise<void>;
+}

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 禁用态视图组件
+ *
+ * 负责渲染禁用态的输入框
+ *
+ * @param props 组件 Props
+ */
+declare const DisabledView: React.FC<PisellCurrencyProps>;
+export default DisabledView;

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

@@ -0,0 +1,17 @@
+import React from 'react';
+import type { PisellCurrencyProps } from '../types';
+/**
+ * PisellCurrency 只读态视图组件
+ *
+ * 负责渲染只读态的纯文本展示
+ *
+ * 功能：
+ * - 格式化货币数值并展示
+ * - 添加货币符号（无空格）
+ * - 支持自定义字体样式
+ * - 处理空值显示
+ *
+ * @param props 组件 Props
+ */
+declare const ReadOnlyView: React.FC<PisellCurrencyProps>;
+export default ReadOnlyView;

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

@@ -0,0 +1,6 @@
+/**
+ * PisellCurrency 子组件导出
+ */
+export { default as ReadOnlyView } from './ReadOnlyView';
+export { default as EditView } from './EditView';
+export { default as DisabledView } from './DisabledView';

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

@@ -0,0 +1,5 @@
+/**
+ * PisellCurrency 工具函数导出
+ */
+export { formatCurrency } from './currencyFormatter';
+export type { CurrencyFormatOptions } from './currencyFormatter';

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

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

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/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/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/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/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 {};