@pisell/materials 1.0.1054 → 1.0.1056

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

@@ -1,124 +0,0 @@
-import type { CSSProperties, ReactNode } from 'react';
-/**
- * 从 @pisell/utils 重新导出公共类型
- */
-export type { DisplayState } from '@pisell/utils';
-/**
- * PisellRating 组件 Props 类型定义
- *
- * 基于 Ant Design Rate 组件，独立实现
- */
-export interface PisellRatingProps {
-    /**
-     * 显示模式
-     * @default 'edit'
-     */
-    mode?: 'read' | 'edit';
-    /**
-     * 是否禁用
-     * @default false
-     */
-    disabled?: boolean;
-    /**
-     * 当前评分值（受控）
-     */
-    value?: number;
-    /**
-     * 默认评分值（非受控）
-     */
-    defaultValue?: number;
-    /**
-     * 评分变更回调
-     */
-    onChange?: (value: number) => void;
-    /**
-     * 星星数量
-     * @default 5
-     */
-    count?: number;
-    /**
-     * 最大评分值（同 count，为了与 Number 系列保持一致）
-     * @default 5
-     */
-    max?: number;
-    /**
-     * 是否允许半星评分
-     * @default false
-     */
-    allowHalf?: boolean;
-    /**
-     * 是否允许清除评分
-     * @default true
-     */
-    allowClear?: boolean;
-    /**
-     * 自定义字符
-     * @default StarFilled
-     */
-    character?: ReactNode | ((props: {
-        index: number;
-        value: number;
-    }) => ReactNode);
-    /**
-     * 评分描述文本数组
-     * @example ['很差', '差', '一般', '好', '很好']
-     */
-    tooltips?: string[];
-    /**
-     * 是否显示数值文本
-     * @default false
-     */
-    showValue?: boolean;
-    /**
-     * 是否显示评分人数
-     * @default false
-     */
-    showCount?: boolean;
-    /**
-     * 评分人数
-     */
-    reviewCount?: number;
-    /**
-     * 星星尺寸（仅影响样式）
-     * @default 20
-     */
-    size?: number;
-    /**
-     * 星星颜色（已选中）
-     * @default '#fadb14'
-     */
-    color?: string;
-    /**
-     * 星星颜色（未选中）
-     * @default '#d9d9d9'
-     */
-    unselectedColor?: string;
-    /**
-     * 悬停评分值变化回调
-     */
-    onHoverChange?: (value: number) => void;
-    /**
-     * 聚焦回调
-     */
-    onFocus?: () => void;
-    /**
-     * 失焦回调
-     */
-    onBlur?: () => void;
-    /**
-     * 自定义类名
-     */
-    className?: string;
-    /**
-     * 自定义样式
-     */
-    style?: CSSProperties;
-    /**
-     * ARIA 标签
-     */
-    'aria-label'?: string;
-    /**
-     * HTML id 属性
-     */
-    id?: string;
-}

package/es/components/pisellRecordBoard/PisellRecordBoard.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { RecordBoardProps } from './types';
-/**
- * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
- * 仅接受打散 props：列表/分页/搜索/多选/列显隐、以及 grid/toolBar/search/paginationConfig/batchActionBar/cardList。
- */
-declare const PisellRecordBoard: React.FC<RecordBoardProps>;
-export default PisellRecordBoard;

package/es/components/pisellRecordBoard/PisellRecordBoard.stories.d.ts

@@ -1,81 +0,0 @@
-import type { Meta, StoryObj } from '@storybook/react';
-import PisellRecordBoard from './index';
-declare const meta: Meta<typeof PisellRecordBoard>;
-export default meta;
-declare type Story = StoryObj<typeof PisellRecordBoard>;
-/**
- * Grid 布局 - 带 Table、分页、多选；列 type 驱动列/筛选/排序；筛选在 Filter 弹层内；重置清空筛选与排序。
- */
-export declare const GridLayoutWithTable: Story;
-/**
- * Grid 布局 - 多页分页示例（至少 25 页：250 条数据，每页 10 条）
- */
-export declare const GridWithMultiplePages: Story;
-/**
- * Grid 布局 - 同值列折叠：当前页某列全部同值或全部为空时，该列隐藏并在表格上方展示总结区（列名 + 统一值/空数据）。
- */
-export declare const GridLayoutWithCollapseUniformColumns: Story;
-/**
- * Grid 布局 - uniformCompare 示例：列值为对象时，用 uniformCompare(value, record) 返回用于比较的 string/number，全同则折叠。
- */
-export declare const GridLayoutWithUniformCompare: Story;
-/**
- * Grid 布局 - grid 透传 antd Table props：onRow（行点击）、rowClassName 等
- */
-export declare const GridWithOnRow: Story;
-/**
- * Grid 布局 - 与 GridLayoutWithTable 类似，列 type 驱动列/筛选/排序，筛选在弹层内。
- */
-export declare const GridLayoutWithColumnType: Story;
-/**
- * Grid 布局 - ToolBar 内直接配置 sort 与 filter（不依赖列派生）
- * toolBar.sort 用 getSortItems 手动配置选项，toolBar.filter 传 { defaultFilterValue }。
- */
-export declare const GridLayoutToolBarSortAndFilter: Story;
-/**
- * Grid 布局 - 快速筛选在 ToolBar 左侧内联展示（toolBar.quickFilter: true），右侧筛选弹层仅保留高级筛选。
- */
-export declare const GridLayoutWithQuickFilterOnLeft: Story;
-/**
- * 自定义左侧快速筛选 + Filter 弹层（高级筛选）+ 列自定义 render
- */
-export declare const CustomQuickFilterAndColumnsRender: Story;
-/**
- * 自定义 filter、自定义 sort、自定义 render
- * 展示列上显式配置：筛选（订单状态 single 在高级筛选、下单时间 rangePickerNew + 自定义 placeholder/width 在快筛）、
- * 排序（订单状态无 type，用 sort.getSortItems 自定义「状态 A-Z / Z-A」）、
- * 以及列的自定义 render（订单号加粗蓝色、状态标签、买家加粗）。
- */
-export declare const CustomFilterSortRender: Story;
-/**
- * Grid 布局 - ToolBar 内使用 PisellFind（toolBar.search: true）
- */
-export declare const GridLayoutWithPisellFindInToolBar: Story;
-/**
- * Grid 布局 - ToolBar 内 PisellFind 透传（toolBar.search: { triggerType: 'input' }）
- */
-export declare const GridLayoutToolBarSearchInput: Story;
-/**
- * Grid 布局 - 完整示例（表格 + 多选 + BatchActionBar 批量操作）
- */
-export declare const GridLayoutFull: Story;
-/**
- * 占位 / 设计态（不传 value，无数据源）
- */
-export declare const Placeholder: Story;
-/**
- * Card 布局占位
- */
-export declare const CardLayoutPlaceholder: Story;
-/**
- * 自定义组合：单独挂 ToolBar / BatchActionBar / Grid / Pagination
- */
-export declare const CustomComposition: Story;
-/**
- * 使用 PisellFind 搜索槽：Search（PisellFind）+ ToolBar + Grid + Pagination
- */
-export declare const WithPisellFindSearch: Story;
-/**
- * 仅 Search + Grid + 分页（无 ToolBar）
- */
-export declare const SearchAndGridOnly: Story;

package/es/components/pisellRecordBoard/context/RecordBoardContext.d.ts

@@ -1,3 +0,0 @@
-/// <reference types="react" />
-import type { RecordBoardContextValue } from '../types';
-export declare const RecordBoardContext: import("react").Context<RecordBoardContextValue | null>;

package/es/components/pisellRecordBoard/context/RecordBoardProvider.d.ts

@@ -1,11 +0,0 @@
-import React, { ReactNode } from 'react';
-import type { RecordBoardContextValue } from '../types';
-export interface RecordBoardProviderProps {
-    value: RecordBoardContextValue;
-    children: ReactNode;
-}
-/**
- * 仅负责注入 RecordBoard 上下文。
- * 实际的数据源、onSearch/onPageChange 由上层（如接 DataSourceContainer 或独立 fetch）提供。
- */
-export declare const RecordBoardProvider: React.FC<RecordBoardProviderProps>;

package/es/components/pisellRecordBoard/hooks/useRecordBoardContext.d.ts

@@ -1,16 +0,0 @@
-import type { RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps } from '../types';
-export interface UseRecordBoardContextOptions {
-    /** 子组件 displayName，用于从 childComponentProps 中取对应 props */
-    displayName?: keyof RecordBoardChildComponentProps;
-    /** 上层传入的 childComponentProps（若 Context 未提供则从参数传入） */
-    childComponentProps?: RecordBoardChildComponentProps;
-}
-/**
- * 消费 RecordBoard 上下文，供各 layout 内子组件（Search / ToolBar / Grid / CardList / Pagination）使用。
- * 若传入 displayName，返回会合并 childComponentProps[displayName] 便于透传。
- * 当 displayName 为 'grid' 时，返回类型包含 RecordBoardGridProps（columns、scroll、size）。
- */
-export declare function useRecordBoardContext(options: UseRecordBoardContextOptions & {
-    displayName: 'grid';
-}): RecordBoardContextValue & RecordBoardGridProps;
-export declare function useRecordBoardContext(options?: UseRecordBoardContextOptions): RecordBoardContextValue;

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

@@ -1,35 +0,0 @@
-import React from 'react';
-import GridLayout from './layouts/GridLayout';
-import CardLayout from './layouts/CardLayout';
-import RecordBoardShellFrame, { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch } from './shellFrame';
-import RecordBoardGridView from './layouts/GridLayout/Grid';
-import RecordBoardCardList from './layouts/CardLayout/CardList';
-import { useRecordBoardContext } from './hooks/useRecordBoardContext';
-import type { RecordBoardProps } from './types';
-/** RecordBoard 复合组件类型 */
-interface PisellRecordBoardType extends React.FC<RecordBoardProps> {
-    /** Shell Frame：对 Layout 的扩展，提供 ToolBar + BatchActionBar + children（Layout） */
-    ShellFrame: typeof RecordBoardShellFrame;
-    /** Grid 布局：仅内容区（表格 + 分页），需配合 ShellFrame 使用 */
-    GridLayout: typeof GridLayout;
-    /** 卡片布局：仅内容区（卡片列表 + 分页），需配合 ShellFrame 使用 */
-    CardLayout: typeof CardLayout;
-    /** 单独使用：搜索槽（PisellFind，绑定 searchParams.keyword / onSearch） */
-    Search: typeof RecordBoardSearch;
-    /** 单独使用：工具栏（PisellToolBar，含搜索/导出，可透传 topLeft/topRight 等） */
-    ToolBar: typeof RecordBoardToolBar;
-    /** 单独使用：分页槽 */
-    Pagination: typeof RecordBoardPagination;
-    /** 单独使用：Grid 视图（表格） */
-    Grid: typeof RecordBoardGridView;
-    /** 单独使用：卡片列表视图 */
-    CardList: typeof RecordBoardCardList;
-    /** 多选操作栏（基于 PisellBatchActionBar，有选中项时展示） */
-    BatchActionBar: typeof RecordBoardBatchActionBar;
-    /** 消费 RecordBoard 上下文 */
-    useRecordBoardContext: typeof useRecordBoardContext;
-}
-declare const PisellRecordBoard: PisellRecordBoardType;
-export default PisellRecordBoard;
-export type { RecordBoardProps, RecordBoardLayoutType, RecordBoardContextValue, RecordBoardChildComponentProps, RecordBoardGridProps, RecordBoardColumnType, RecordBoardFieldType, RecordBoardColumnFilterConfig, RecordBoardOptionItem, RecordBoardGetOptions, } from './types';
-export { useRecordBoardContext } from './hooks/useRecordBoardContext';

package/es/components/pisellRecordBoard/layouts/CardLayout/CardList.d.ts

@@ -1,12 +0,0 @@
-import React from 'react';
-import type { RecordBoardContextValue } from '../../types';
-export interface RecordBoardCardListProps extends Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
-    className?: string;
-    style?: React.CSSProperties;
-    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
-}
-/**
- * Card 布局下的数据视图：从 context 取 data / loading。
- */
-declare const RecordBoardCardList: React.FC<RecordBoardCardListProps>;
-export default RecordBoardCardList;

package/es/components/pisellRecordBoard/layouts/CardLayout/index.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-import RecordBoardCardList from './CardList';
-/**
- * Card 布局：仅内容区 = 卡片列表（不含分页）。
- * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
- * <PisellRecordBoard.ShellFrame><PisellRecordBoard.CardLayout /></PisellRecordBoard.ShellFrame>
- */
-declare const CardLayout: React.FC<{
-    className?: string;
-    style?: React.CSSProperties;
-}>;
-export default CardLayout;
-export { RecordBoardCardList as CardLayoutCardList };

package/es/components/pisellRecordBoard/layouts/GridLayout/Grid.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import type { TableProps } from 'antd';
-import type { RecordBoardContextValue } from '../../types';
-import './Grid.less';
-export interface RecordBoardGridViewProps extends Omit<TableProps<any>, 'dataSource' | 'loading' | 'pagination'>, Partial<Pick<RecordBoardContextValue, 'data' | 'loading'>> {
-    /** 列配置，同 antd Table columns */
-    columns?: TableProps<any>['columns'];
-    className?: string;
-    style?: React.CSSProperties;
-    /** 自定义渲染，传入后不再使用内置 Table */
-    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
-}
-declare const RecordBoardGridView: React.FC<RecordBoardGridViewProps>;
-export default RecordBoardGridView;

package/es/components/pisellRecordBoard/layouts/GridLayout/index.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-import RecordBoardGridView from './Grid';
-/**
- * Grid 布局：仅内容区 = 表格（不含分页）。
- * 工具栏、多选操作栏、分页由 Shell Frame 提供，使用时用 ShellFrame 包裹：
- * <PisellRecordBoard.ShellFrame><PisellRecordBoard.GridLayout /></PisellRecordBoard.ShellFrame>
- */
-declare const GridLayout: React.FC<{
-    className?: string;
-    style?: React.CSSProperties;
-}>;
-export default GridLayout;
-export { RecordBoardGridView as GridLayoutGrid };

package/es/components/pisellRecordBoard/shellFrame/BatchActionBar/index.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { PisellBatchActionBarProps } from '../../../pisellBatchActionBar';
-/**
- * RecordBoard 下的多选操作栏：从 context 取选中态与数据，渲染 PisellBatchActionBar。
- * 仅在有选中项时展示；全选/反选/清空基于当前页 data。
- */
-declare const RecordBoardBatchActionBar: React.FC<Partial<PisellBatchActionBarProps>>;
-export default RecordBoardBatchActionBar;

package/es/components/pisellRecordBoard/shellFrame/ColumnSetting/ColumnSettingPopover.d.ts

@@ -1,15 +0,0 @@
-/**
- * 列显示隐藏弹层内容：显隐切换 + 拖拽排序（参考 table Actions ColumnsSetting PopoverContent）。
- */
-import React from 'react';
-import type { RecordBoardColumnType } from '../../types';
-export interface ColumnSettingPopoverProps {
-    columns: RecordBoardColumnType[];
-    columnVisibility: Record<string, boolean>;
-    onColumnVisibilityChange: (visibility: Record<string, boolean>) => void;
-    /** 列 key 顺序（拖拽排序后持久化）；未传则按 columns 顺序 */
-    columnOrder?: string[] | null;
-    onColumnOrderChange?: (columnKeys: string[]) => void;
-}
-declare const ColumnSettingPopover: React.FC<ColumnSettingPopoverProps>;
-export default ColumnSettingPopover;

package/es/components/pisellRecordBoard/shellFrame/ColumnSetting/index.d.ts

@@ -1,8 +0,0 @@
-/**
- * RecordBoard 列显示隐藏设置（仅控制表格列展示，不控制 filter/sort）。
- * 参考 table Actions ColumnsSetting，仅保留显隐切换，无拖拽排序。
- */
-import React from 'react';
-import './index.less';
-declare const RecordBoardColumnSetting: React.FC;
-export default RecordBoardColumnSetting;

package/es/components/pisellRecordBoard/shellFrame/Pagination/index.d.ts

@@ -1,14 +0,0 @@
-import React from 'react';
-import './index.less';
-import type { RecordBoardContextValue } from '../../types';
-export interface RecordBoardPaginationProps extends Partial<Pick<RecordBoardContextValue, 'pagination' | 'total' | 'onPageChange' | 'loading'>> {
-    className?: string;
-    style?: React.CSSProperties;
-    render?: (ctx: RecordBoardContextValue) => React.ReactNode;
-}
-/**
- * RecordBoard 下的分页：接入 packages/materials 的 Pagination，从 context 取 pagination / total / onPageChange；可透传 childComponentProps.pagination。
- * 当 context 中 pagination 缺失时使用默认分页，避免在 Storybook 或未完整注入 context 时报错。
- */
-declare const RecordBoardPagination: React.FC<RecordBoardPaginationProps>;
-export default RecordBoardPagination;

package/es/components/pisellRecordBoard/shellFrame/Search/index.d.ts

@@ -1,10 +0,0 @@
-import React from 'react';
-export interface RecordBoardSearchProps {
-    [key: string]: any;
-}
-/**
- * RecordBoard 下的独立搜索槽：使用 PisellFind，绑定 context.searchParams.keyword 与 onSearch。
- * 可通过 childComponentProps.search 透传 PisellFind 的 props。
- */
-declare const RecordBoardSearch: React.FC<RecordBoardSearchProps>;
-export default RecordBoardSearch;

package/es/components/pisellRecordBoard/shellFrame/ToolBarQuickFilter/index.d.ts

@@ -1,17 +0,0 @@
-import React from 'react';
-import type { FilterItemProps } from '../../../filter/types';
-export interface ToolBarQuickFilterProps {
-    /** 快速筛选项列表（与 Filter 的 quickFilter 同结构），不传则从 columns 派生时由父级传入 */
-    filterList?: FilterItemProps[];
-    /** 表单字段前缀，与 PisellFilter 保持一致，默认 '' */
-    formFiltersPrefix?: string;
-    /** 表单项尺寸 */
-    size?: 'small' | 'middle' | 'large';
-}
-/**
- * RecordBoard 工具栏左侧内联快速筛选：将 quickFilter 直接展示在 ToolBar 左侧，不放入 Filter 弹层。
- * 与 searchParams.filter 联动，变更写入 searchParams.filter.values 并触发 onSearch。
- * 启用时建议 ToolBar 对 PisellFilter 传 hiddenQuickFilter: true，仅保留高级筛选在弹层内。
- */
-declare const ToolBarQuickFilter: React.FC<ToolBarQuickFilterProps>;
-export default ToolBarQuickFilter;

package/es/components/pisellRecordBoard/shellFrame/ToolBarReset/index.d.ts

@@ -1,16 +0,0 @@
-import React from 'react';
-import './index.less';
-export interface ToolBarResetProps {
-    /** 按钮尺寸，与 antd Button 一致，默认与筛选按钮对齐为 large */
-    size?: 'small' | 'middle' | 'large';
-    /** 按钮类型 */
-    type?: 'default' | 'primary' | 'link' | 'text';
-    /** 按钮文案，默认使用多语言「重置」 */
-    children?: React.ReactNode;
-}
-/**
- * RecordBoard 工具栏重置按钮：清空筛选与排序并刷新表格。
- * 点击后以空 filter.values、清空 sort 调用 onSearch，并调用 onReset（若提供）。
- */
-declare const ToolBarReset: React.FC<ToolBarResetProps>;
-export default ToolBarReset;

package/es/components/pisellRecordBoard/shellFrame/index.d.ts

@@ -1,26 +0,0 @@
-import React from 'react';
-import RecordBoardToolBar from './ToolBar';
-import RecordBoardBatchActionBar from './BatchActionBar';
-import RecordBoardPagination from './Pagination';
-import RecordBoardSearch from './Search';
-import ToolBarReset from './ToolBarReset';
-import ToolBarQuickFilter from './ToolBarQuickFilter';
-/**
- * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
- * 提供工具栏、多选操作条、分页；与 Layout 同级，包裹在 Layout 外层。
- * 默认占满父容器高度，内容区可滚动，分页器固定在底部。
- *
- * 使用方式：
- * <PisellRecordBoard>
- *   <PisellRecordBoard.ShellFrame>
- *     <PisellRecordBoard.GridLayout />
- *   </PisellRecordBoard.ShellFrame>
- * </PisellRecordBoard>
- */
-declare const RecordBoardShellFrame: React.FC<{
-    children?: React.ReactNode;
-    className?: string;
-    style?: React.CSSProperties;
-}>;
-export default RecordBoardShellFrame;
-export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter, };