@pisell/private-materials 3.4.81 → 3.4.83

package/es/plus/pisellSalesGrid/PisellSalesGrid.less

@@ -0,0 +1,16 @@
+/**
+ * PisellSalesGrid 样式
+ * 作用域限定在 .pisell-sales-grid 内，避免污染全局
+ */
+.pisell-sales-grid {
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+
+  /* Quick filter 内日期选择器宽度加大 */
+
+  .record-board-toolbar-quick-filter-form .pisell-date-range-picker {
+    min-width: 240px !important;
+  }
+}

package/es/plus/pisellSalesGrid/PisellSalesGrid.stories.d.ts

@@ -0,0 +1,14 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellSalesGrid } from './index';
+declare const meta: Meta<typeof PisellSalesGrid>;
+export default meta;
+declare type Story = StoryObj<typeof PisellSalesGrid>;
+export declare const CurrentPerspectiveFull: Story;
+export declare const CurrentPerspectiveBrief: Story;
+export declare const SinglePerspective: Story;
+export declare const WithColumnRenderers: Story;
+export declare const WithDefaultHiddenColumns: Story;
+export declare const WithToolbarSort: Story;
+export declare const WithToolbarSortCustomOptions: Story;
+export declare const WithToolbarFilter: Story;
+export declare const WithToolbarSortAndFilter: Story;

package/es/plus/pisellSalesGrid/PisellSalesGrid.stories.js

@@ -0,0 +1,559 @@
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+function _extends() { _extends = Object.assign ? Object.assign.bind() : function (target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i]; for (var key in source) { if (Object.prototype.hasOwnProperty.call(source, key)) { target[key] = source[key]; } } } return target; }; return _extends.apply(this, arguments); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import React, { useMemo, useState } from 'react';
+import { PisellSalesGrid } from "./index";
+
+/** 列配置与 RecordBoard 的 columns 兼容 */
+
+var meta = {
+  title: 'Pro Components/PisellSalesGrid',
+  component: PisellSalesGrid,
+  parameters: {
+    layout: 'padded',
+    docs: {
+      description: {
+        component: 'RecordBoard 的上层组件，与 RecordBoard 一致采用打散传参（data、loading、total、pagination、onSearch、多选等）。根据 currentPerspective 选择对应的一组 RecordBoard 配置渲染，不提供 Tab 切换 UI。多选通过 props 传入，SalesGrid 会合并进 grid 再传给 RecordBoard。perspective 的 childComponentProps.grid 可含 columns、scroll、onRow、rowClassName 等 Table 透传。'
+      }
+    }
+  },
+  tags: ['autodocs'],
+  argTypes: {
+    currentPerspective: {
+      description: '当前 Perspective key',
+      control: 'text'
+    },
+    perspectives: {
+      control: false
+    }
+  }
+};
+export default meta;
+var mockData = Array.from({
+  length: 20
+}, function (_, i) {
+  return {
+    id: "id-".concat(i + 1),
+    name: "\u5546\u54C1 ".concat(i + 1),
+    sku: "SKU".concat(String(1000 + i).padStart(4, '0')),
+    amount: 99 + i * 10,
+    status: ['在售', '下架', '待上架'][i % 3],
+    updateTime: "2024-02-".concat(String(10 + i % 18).padStart(2, '0'))
+  };
+});
+var columnsFull = [{
+  title: '名称',
+  dataIndex: 'name',
+  key: 'name',
+  width: 120
+}, {
+  title: 'SKU',
+  dataIndex: 'sku',
+  key: 'sku',
+  width: 100
+}, {
+  title: '金额',
+  dataIndex: 'amount',
+  key: 'amount',
+  width: 100,
+  type: 'currency',
+  fieldProps: {
+    currencySymbol: '¥'
+  }
+}, {
+  title: '状态',
+  dataIndex: 'status',
+  key: 'status',
+  width: 90
+}, {
+  title: '更新时间',
+  dataIndex: 'updateTime',
+  key: 'updateTime',
+  width: 120
+}];
+var columnsBrief = [{
+  title: '名称',
+  dataIndex: 'name',
+  key: 'name',
+  width: 160
+}, {
+  title: '金额',
+  dataIndex: 'amount',
+  key: 'amount',
+  width: 120,
+  type: 'currency',
+  fieldProps: {
+    currencySymbol: '¥'
+  }
+}, {
+  title: '状态',
+  dataIndex: 'status',
+  key: 'status',
+  width: 100
+}];
+var perspectives = [{
+  key: 'full',
+  label: '完整列表',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull
+    }
+  }
+}, {
+  key: 'brief',
+  label: '简要',
+  childComponentProps: {
+    grid: {
+      columns: columnsBrief
+    }
+  }
+}];
+function useMockDataSourceProps() {
+  var _useState = useState({
+      pageNumber: 1,
+      pageSize: 10
+    }),
+    _useState2 = _slicedToArray(_useState, 2),
+    page = _useState2[0],
+    setPage = _useState2[1];
+  var _useState3 = useState({}),
+    _useState4 = _slicedToArray(_useState3, 2),
+    searchParams = _useState4[0],
+    setSearchParams = _useState4[1];
+  var _useState5 = useState([]),
+    _useState6 = _slicedToArray(_useState5, 2),
+    selectedKeys = _useState6[0],
+    setSelectedKeys = _useState6[1];
+  var _useState7 = useState([]),
+    _useState8 = _slicedToArray(_useState7, 2),
+    selectedRows = _useState8[0],
+    setSelectedRows = _useState8[1];
+  return useMemo(function () {
+    return {
+      data: mockData.slice((page.pageNumber - 1) * page.pageSize, page.pageNumber * page.pageSize),
+      loading: false,
+      total: mockData.length,
+      pagination: page,
+      onPageChange: function onPageChange(pageNumber, pageSize) {
+        return setPage({
+          pageNumber: pageNumber,
+          pageSize: pageSize
+        });
+      },
+      searchParams: searchParams,
+      onSearch: function onSearch(params) {
+        setSearchParams(params);
+        setPage(function (p) {
+          return _objectSpread(_objectSpread({}, p), {}, {
+            pageNumber: 1
+          });
+        });
+      },
+      onReset: function onReset() {
+        return setSearchParams({});
+      },
+      selectedKeys: selectedKeys,
+      selectedRows: selectedRows,
+      onSelectionChange: function onSelectionChange(keys, rows) {
+        setSelectedKeys(keys);
+        setSelectedRows(rows);
+      },
+      rowKey: 'id'
+    };
+  }, [page, searchParams, selectedKeys, selectedRows]);
+}
+export var CurrentPerspectiveFull = {
+  render: function CurrentPerspectiveFullRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectives,
+      currentPerspective: "full"
+    })));
+  }
+};
+export var CurrentPerspectiveBrief = {
+  render: function CurrentPerspectiveBriefRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectives,
+      currentPerspective: "brief"
+    })));
+  }
+};
+export var SinglePerspective = {
+  render: function SinglePerspectiveRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: [perspectives[0]],
+      currentPerspective: "full"
+    })));
+  }
+};
+
+/** 使用 columnRenderers 覆盖 type 为 currency 的列渲染 */
+var columnRenderers = [{
+  type: 'currency',
+  render: function render(value) {
+    return /*#__PURE__*/React.createElement("span", {
+      style: {
+        color: '#52c41a',
+        fontWeight: 600
+      }
+    }, "\xA5 ", typeof value === 'number' ? value.toFixed(2) : value);
+  }
+}];
+export var WithColumnRenderers = {
+  render: function WithColumnRenderersRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectives,
+      currentPerspective: "full",
+      columnRenderers: columnRenderers
+    })));
+  }
+};
+
+/** 配置默认隐藏列：grid.defaultHiddenColumnKeys 指定列 key，这些列初始为隐藏，用户可在表头设置中重新勾选显示 */
+var perspectivesWithHiddenColumns = [{
+  key: 'full',
+  label: '完整列表',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull,
+      defaultHiddenColumnKeys: ['sku', 'updateTime']
+    }
+  }
+}];
+export var WithDefaultHiddenColumns = {
+  render: function WithDefaultHiddenColumnsRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectivesWithHiddenColumns,
+      currentPerspective: "full"
+    })));
+  },
+  parameters: {
+    docs: {
+      description: {
+        story: 'perspectives[].childComponentProps.grid.defaultHiddenColumnKeys 配置默认隐藏的列（如 sku、updateTime），初始加载时这些列不展示，用户可通过工具栏列设置重新勾选显示。'
+      }
+    }
+  }
+};
+
+/**
+ * 在 toolbar 里直接配置 sort：childComponentProps.toolBar.sort 传 { list }，
+ * list 为排序项数组，每项 name（字段 key）、label（展示名）、type（'string'|'number'|'date'|'option'）。
+ * 排序值写入 searchParams.sort，由业务 onSearch 接收后请求带排序参数。
+ */
+var perspectivesWithToolbarSort = [{
+  key: 'full',
+  label: '完整列表（工具栏配置排序）',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull
+    },
+    toolBar: {
+      sort: {
+        list: [{
+          name: 'amount',
+          label: '按金额',
+          type: 'number',
+          isCustom: false
+        }, {
+          name: 'name',
+          label: '按名称',
+          type: 'string',
+          isCustom: false
+        }, {
+          name: 'updateTime',
+          label: '按更新时间',
+          type: 'date',
+          isCustom: false
+        }]
+      }
+    }
+  }
+}];
+export var WithToolbarSort = {
+  render: function WithToolbarSortRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectivesWithToolbarSort,
+      currentPerspective: "full"
+    })));
+  },
+  parameters: {
+    docs: {
+      description: {
+        story: '通过 perspectives[].childComponentProps.toolBar.sort 直接配置排序：传 { list: [{ name, label, type }] }，工具栏展示排序按钮，选择后写入 searchParams.sort，由 onSearch 带回后端。'
+      }
+    }
+  }
+};
+
+/**
+ * 自定义排序选项：用 getSortItems(fieldKey) 返回 { key, label }[]，
+ * 完全自定义每个字段下的排序子项（key 为最终写入 searchParams.sort 的值，label 为展示文案）。
+ */
+var perspectivesWithCustomSortOptions = [{
+  key: 'full',
+  label: '完整列表（自定义排序文案）',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull
+    },
+    toolBar: {
+      sort: {
+        list: [{
+          name: 'amount',
+          label: '按金额',
+          isCustom: true,
+          getSortItems: function getSortItems(fieldKey) {
+            return [{
+              key: "".concat(fieldKey, ":asc"),
+              label: '从低到高'
+            }, {
+              key: "".concat(fieldKey, ":desc"),
+              label: '从高到低'
+            }];
+          }
+        }, {
+          name: 'name',
+          label: '按名称',
+          isCustom: true,
+          getSortItems: function getSortItems(fieldKey) {
+            return [{
+              key: "".concat(fieldKey, ":asc"),
+              label: 'A → Z'
+            }, {
+              key: "".concat(fieldKey, ":desc"),
+              label: 'Z → A'
+            }];
+          }
+        }]
+      }
+    }
+  }
+}];
+export var WithToolbarSortCustomOptions = {
+  render: function WithToolbarSortCustomOptionsRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectivesWithCustomSortOptions,
+      currentPerspective: "full"
+    })));
+  },
+  parameters: {
+    docs: {
+      description: {
+        story: '用 toolBar.sort.list[].getSortItems(fieldKey) 自定义排序选项：返回 { key, label }[]，key 写入 searchParams.sort，label 为下拉展示文案。可完全自定义文案（如「从低到高」「从高到低」）。'
+      }
+    }
+  }
+};
+
+/**
+ * 在 toolbar 里直接配置 filter：childComponentProps.toolBar.filter 传对象，
+ * 用 defaultFilterValue 提供筛选项列表（quickFilter / otherFilter 为 FilterItemProps[]），
+ * 筛选值写入 searchParams.filter，由 onSearch 接收。
+ */
+var perspectivesWithToolbarFilter = [{
+  key: 'full',
+  label: '完整列表（工具栏配置筛选）',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull
+    },
+    toolBar: {
+      filter: {
+        hiddenQuickFilter: true,
+        defaultFilterValue: {
+          quickFilter: [],
+          otherFilter: [{
+            type: 'single',
+            key: 'status',
+            name: 'status',
+            label: '状态',
+            props: {
+              options: [{
+                label: '全部',
+                value: 'all'
+              }, {
+                label: '在售',
+                value: '在售'
+              }, {
+                label: '下架',
+                value: '下架'
+              }, {
+                label: '待上架',
+                value: '待上架'
+              }]
+            },
+            other: {}
+          }, {
+            type: 'input',
+            key: 'keyword',
+            name: 'keyword',
+            label: '关键词',
+            props: {
+              placeholder: '名称 / SKU'
+            },
+            other: {}
+          }],
+          values: {}
+        }
+      }
+    }
+  }
+}];
+export var WithToolbarFilter = {
+  render: function WithToolbarFilterRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectivesWithToolbarFilter,
+      currentPerspective: "full"
+    })));
+  },
+  parameters: {
+    docs: {
+      description: {
+        story: '通过 perspectives[].childComponentProps.toolBar.filter 直接配置筛选：传 defaultFilterValue.{ quickFilter, otherFilter, values }，otherFilter 为 FilterItemProps[]（type: single/input/rangePicker/rangePickerNew 等，key/name/label/props）。选择后写入 searchParams.filter，由 onSearch 带回。'
+      }
+    }
+  }
+};
+
+/**
+ * 同一 perspective 的 toolBar 里同时配置 sort 与 filter：
+ * toolBar.sort 传 { list }，toolBar.filter 传 { defaultFilterValue }。
+ */
+var perspectivesWithToolbarSortAndFilter = [{
+  key: 'full',
+  label: '完整列表（排序 + 筛选）',
+  childComponentProps: {
+    grid: {
+      columns: columnsFull
+    },
+    toolBar: {
+      sort: {
+        list: [{
+          name: 'amount',
+          label: '按金额',
+          type: 'number',
+          isCustom: false
+        }, {
+          name: 'name',
+          label: '按名称',
+          type: 'string',
+          isCustom: false
+        }, {
+          name: 'updateTime',
+          label: '按更新时间',
+          type: 'date',
+          isCustom: false
+        }]
+      },
+      filter: {
+        hiddenQuickFilter: true,
+        defaultFilterValue: {
+          quickFilter: [],
+          otherFilter: [{
+            type: 'single',
+            key: 'status',
+            name: 'status',
+            label: '状态',
+            props: {
+              options: [{
+                label: '全部',
+                value: 'all'
+              }, {
+                label: '在售',
+                value: '在售'
+              }, {
+                label: '下架',
+                value: '下架'
+              }, {
+                label: '待上架',
+                value: '待上架'
+              }]
+            },
+            other: {}
+          }, {
+            type: 'input',
+            key: 'keyword',
+            name: 'keyword',
+            label: '关键词',
+            props: {
+              placeholder: '名称 / SKU'
+            },
+            other: {}
+          }],
+          values: {}
+        }
+      }
+    }
+  }
+}];
+export var WithToolbarSortAndFilter = {
+  render: function WithToolbarSortAndFilterRender() {
+    var dataSourceProps = useMockDataSourceProps();
+    return /*#__PURE__*/React.createElement("div", {
+      style: {
+        height: 400
+      }
+    }, /*#__PURE__*/React.createElement(PisellSalesGrid, _extends({}, dataSourceProps, {
+      perspectives: perspectivesWithToolbarSortAndFilter,
+      currentPerspective: "full"
+    })));
+  },
+  parameters: {
+    docs: {
+      description: {
+        story: '在 toolBar 里同时配置排序与筛选：toolBar.sort 传 { list }，toolBar.filter 传 { defaultFilterValue }。排序写入 searchParams.sort，筛选写入 searchParams.filter，均由 onSearch 带回。'
+      }
+    }
+  }
+};

package/es/plus/pisellSalesGrid/hooks/useActions.d.ts

@@ -0,0 +1,19 @@
+import React from 'react';
+interface UseActionsOptions {
+    onRefresh?: () => void;
+    onClearSelection?: () => void;
+}
+declare const useActions: (options?: UseActionsOptions) => ({
+    key: string;
+    label: any;
+    icon: string;
+    loading: boolean;
+    onClick: (keys: React.Key[], rows?: any[]) => Promise<void>;
+} | {
+    key: string;
+    label: any;
+    icon: string;
+    onClick: (keys: React.Key[], rows?: any[]) => void;
+    loading?: undefined;
+})[];
+export default useActions;