@pisell/materials 6.3.27 → 6.3.29

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

@@ -0,0 +1,11 @@
+import React from 'react';
+import type { RecordBoardToolBarProps as ToolBarPropsType } from '../../types';
+import './ToolBarFilter.less';
+/**
+ * RecordBoard 下的工具栏：使用 PisellToolBar。
+ * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
+ * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
+ */
+declare const RecordBoardToolBar: React.FC<RecordBoardToolBarProps>;
+export declare type RecordBoardToolBarProps = ToolBarPropsType;
+export default RecordBoardToolBar;

package/es/components/pisellRecordBoard/shellFrame/ToolBar/index.js

@@ -0,0 +1,215 @@
+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 _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 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); }
+import React, { useCallback, useMemo } from 'react';
+import { Button, Space } from 'antd';
+import SwitchVertical01 from '@pisell/icon/es/SwitchVertical01';
+import PisellToolBar from "../../../pisellGridPro/ToolBar";
+import { PisellFind } from "../../../pisellFind";
+import PisellFilter from "../../../pisellFilter";
+import Sort from "../../../sort";
+import ToolBarReset from "../ToolBarReset";
+import ToolBarQuickFilter from "../ToolBarQuickFilter";
+import RecordBoardColumnSetting from "../ColumnSetting";
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+import { locales as utilsLocales } from '@pisell/utils';
+import { getText } from "../../../../locales";
+import "./ToolBarFilter.less";
+
+/** 与 Quick Filter 同源：优先 utils，若 utils 返回 key（未命中）则用 materials 再回退 */
+function getSortButtonText() {
+  var key = 'pisell2.recordBoard.toolbar.sort';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || getText('sort-button-text');
+}
+function getFilterButtonText() {
+  var key = 'pisell2.recordBoard.toolbar.filter';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || getText('table-action-filter-button');
+}
+import { deriveFilterFromColumns, deriveSortFromColumns } from "../../utils/recordBoardColumns";
+
+/** 默认搜索参数字段名，与 context.searchParams 对应 */
+var DEFAULT_SEARCH_FIELD = 'keyword';
+
+/** 筛选在 searchParams 中的字段名 */
+var FILTER_PARAMS_FIELD = 'filter';
+
+/** 排序在 searchParams 中的字段名 */
+var SORT_PARAMS_FIELD = 'sort';
+
+/** 筛选无值时使用的默认筛选项，避免点开为空；业务可通过 childComponentProps.toolBar.filter.defaultFilterValue 覆盖。文案通过 getText 多语言。 */
+function getDefaultFilterValue() {
+  return {
+    quickFilter: [],
+    otherFilter: []
+  };
+}
+
+/**
+ * RecordBoard 下的工具栏：使用 PisellToolBar。
+ * 左侧默认 PisellFind（inline）；右侧默认 PisellFilter。通过 childComponentProps.toolBar.search / toolBar.filter 为对象时透传对应组件 props，为 false 时不渲染。
+ * 可透传 topLeft、topRight、bottomLeft、bottomRight、tabs。
+ */
+var RecordBoardToolBar = function RecordBoardToolBar(props) {
+  var _ctx$childComponentPr, _ctx$childComponentPr2, _searchParams$DEFAULT, _ctx$childComponentPr3, _formFiltersPrefix, _size, _filterResetKey;
+  var ctx = useRecordBoardContext({
+    displayName: 'toolBar'
+  });
+  var searchParams = ctx.searchParams,
+    onSearch = ctx.onSearch;
+  var slots = (_ctx$childComponentPr = (_ctx$childComponentPr2 = ctx.childComponentProps) === null || _ctx$childComponentPr2 === void 0 ? void 0 : _ctx$childComponentPr2.toolBar) !== null && _ctx$childComponentPr !== void 0 ? _ctx$childComponentPr : {};
+  var keyword = (_searchParams$DEFAULT = searchParams === null || searchParams === void 0 ? void 0 : searchParams[DEFAULT_SEARCH_FIELD]) !== null && _searchParams$DEFAULT !== void 0 ? _searchParams$DEFAULT : '';
+  var handleSearch = useCallback(function (value) {
+    onSearch(_objectSpread(_objectSpread({}, searchParams), {}, _defineProperty({}, DEFAULT_SEARCH_FIELD, value || undefined)));
+  }, [onSearch, searchParams]);
+  var gridColumns = (_ctx$childComponentPr3 = ctx.childComponentProps) === null || _ctx$childComponentPr3 === void 0 || (_ctx$childComponentPr3 = _ctx$childComponentPr3.grid) === null || _ctx$childComponentPr3 === void 0 ? void 0 : _ctx$childComponentPr3.columns;
+  var derivedFilterFromColumns = useMemo(function () {
+    return Array.isArray(gridColumns) && gridColumns.length > 0 ? deriveFilterFromColumns(gridColumns) : null;
+  }, [gridColumns]);
+  var derivedSortFromColumnsList = useMemo(function () {
+    return Array.isArray(gridColumns) && gridColumns.length > 0 ? deriveSortFromColumns(gridColumns) : [];
+  }, [gridColumns]);
+  var searchConfig = slots.search;
+  var hideSearch = searchConfig === false;
+
+  /** 默认 inline：triggerType="input" + displayType="inline"，放在 toolbar 左侧。showConfirmButton 优先取 toolBar.search，未配置时默认 true。 */
+  var searchNode = hideSearch ? null : /*#__PURE__*/React.createElement(PisellFind, _extends({
+    triggerType: "input",
+    displayType: "inline",
+    showConfirmButton: _typeof(searchConfig) === 'object' && searchConfig !== null && 'showConfirmButton' in searchConfig ? searchConfig.showConfirmButton : true,
+    value: keyword,
+    onChange: function onChange(v) {
+      return handleSearch(v);
+    },
+    onSearch: handleSearch
+  }, _typeof(searchConfig) === 'object' && searchConfig !== null ? searchConfig : {}));
+
+  // 快筛统一放在左侧 QuickFilter；右侧 Filter 弹层只保留高级筛选，不展示快筛
+  var quickFilterConfig = slots.quickFilter;
+  var quickFilterList = useMemo(function () {
+    var _ref;
+    if (quickFilterConfig === false) return [];
+    var fromConfig = _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null && Array.isArray(quickFilterConfig.filterList) ? quickFilterConfig.filterList : null;
+    return (_ref = fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter) !== null && _ref !== void 0 ? _ref : [];
+  }, [quickFilterConfig, derivedFilterFromColumns === null || derivedFilterFromColumns === void 0 ? void 0 : derivedFilterFromColumns.quickFilter]);
+  var showQuickFilterLeft = quickFilterList.length > 0;
+  var quickFilterNode = showQuickFilterLeft ? /*#__PURE__*/React.createElement(ToolBarQuickFilter, {
+    filterList: quickFilterList,
+    formFiltersPrefix: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_formFiltersPrefix = quickFilterConfig.formFiltersPrefix) !== null && _formFiltersPrefix !== void 0 ? _formFiltersPrefix : '' : '',
+    size: _typeof(quickFilterConfig) === 'object' && quickFilterConfig !== null ? (_size = quickFilterConfig.size) !== null && _size !== void 0 ? _size : 'large' : 'large'
+  }) : null;
+  var topLeft = /*#__PURE__*/React.createElement("div", {
+    className: "record-board-toolbar-top-left"
+  }, quickFilterNode, searchNode ? /*#__PURE__*/React.createElement("div", {
+    className: "record-board-toolbar-find-wrap"
+  }, searchNode) : null, slots.topLeft);
+  var sortConfig = slots.sort;
+  var hideSort = sortConfig === false;
+  var sortValue = searchParams === null || searchParams === void 0 ? void 0 : searchParams[SORT_PARAMS_FIELD];
+  var handleSortChange = useCallback(function (val) {
+    onSearch(_objectSpread(_objectSpread({}, searchParams), {}, _defineProperty({}, SORT_PARAMS_FIELD, val || undefined)));
+  }, [onSearch, searchParams]);
+  var sortList = useMemo(function () {
+    var fromConfig = _typeof(sortConfig) === 'object' && sortConfig !== null && Array.isArray(sortConfig.list) ? sortConfig.list : null;
+    return fromConfig !== null && fromConfig !== void 0 ? fromConfig : derivedSortFromColumnsList;
+  }, [sortConfig, derivedSortFromColumnsList]);
+  var sortNode = hideSort ? null : /*#__PURE__*/React.createElement(Sort, _extends({}, _typeof(sortConfig) === 'object' && sortConfig !== null ? sortConfig : {}, {
+    list: sortList,
+    value: sortValue,
+    onChange: handleSortChange,
+    placement: "bottomLeft",
+    button: /*#__PURE__*/React.createElement(Button, {
+      className: "record-board-toolbar-filter-btn",
+      icon: /*#__PURE__*/React.createElement(SwitchVertical01, null),
+      size: "large"
+    }, getSortButtonText())
+  }));
+  var filterConfig = slots.filter;
+  var hideFilter = filterConfig === false;
+  var filterValue = searchParams === null || searchParams === void 0 ? void 0 : searchParams[FILTER_PARAMS_FIELD];
+  var hasFilterList = Array.isArray(filterValue === null || filterValue === void 0 ? void 0 : filterValue.quickFilter) && filterValue.quickFilter.length > 0 || Array.isArray(filterValue === null || filterValue === void 0 ? void 0 : filterValue.otherFilter) && filterValue.otherFilter.length > 0;
+  var hasFilterValues = _typeof(filterValue === null || filterValue === void 0 ? void 0 : filterValue.values) === 'object' && filterValue.values !== null && Object.keys(filterValue.values).length > 0;
+  var hasFilterItems = hasFilterList || hasFilterValues;
+  var defaultFilterFromConfig = _typeof(filterConfig) === 'object' && filterConfig !== null && filterConfig.defaultFilterValue ? filterConfig.defaultFilterValue : null;
+  var effectiveFilterValue = useMemo(function () {
+    var _defaultFilterFromCon, _defaultFilterFromCon2, _base$values;
+    var base = filterValue != null && hasFilterItems ? filterValue : defaultFilterFromConfig ? defaultFilterFromConfig : derivedFilterFromColumns && (derivedFilterFromColumns.quickFilter.length > 0 || derivedFilterFromColumns.otherFilter.length > 0) ? derivedFilterFromColumns : getDefaultFilterValue();
+    var quickFilter = Array.isArray(base.quickFilter) && base.quickFilter.length > 0 ? base.quickFilter : (_defaultFilterFromCon = defaultFilterFromConfig === null || defaultFilterFromConfig === void 0 ? void 0 : defaultFilterFromConfig.quickFilter) !== null && _defaultFilterFromCon !== void 0 ? _defaultFilterFromCon : [];
+    var otherFilter = Array.isArray(base.otherFilter) && base.otherFilter.length > 0 ? base.otherFilter : (_defaultFilterFromCon2 = defaultFilterFromConfig === null || defaultFilterFromConfig === void 0 ? void 0 : defaultFilterFromConfig.otherFilter) !== null && _defaultFilterFromCon2 !== void 0 ? _defaultFilterFromCon2 : [];
+    // 若 otherFilter 来自 base（如 sessionStorage 恢复），JSON 会丢失函数（如 other.component），导致 custom 项空白；用 config 同 key 项补回 component/label 等
+    if (otherFilter === base.otherFilter && Array.isArray(defaultFilterFromConfig === null || defaultFilterFromConfig === void 0 ? void 0 : defaultFilterFromConfig.otherFilter) && defaultFilterFromConfig.otherFilter.length > 0) {
+      var configMap = new Map(defaultFilterFromConfig.otherFilter.map(function (c) {
+        var _ref2, _c$key;
+        return [(_ref2 = (_c$key = c.key) !== null && _c$key !== void 0 ? _c$key : c.name) !== null && _ref2 !== void 0 ? _ref2 : '', c];
+      }));
+      otherFilter = otherFilter.map(function (item) {
+        var _ref3, _item$key, _configItem$label, _configItem$other$pla, _configItem$other, _item$other;
+        var key = (_ref3 = (_item$key = item.key) !== null && _item$key !== void 0 ? _item$key : item.name) !== null && _ref3 !== void 0 ? _ref3 : '';
+        var configItem = configMap.get(key);
+        if (!configItem) return item;
+        // 优先用 config 的 label/placeholder（当前语言），避免 session 恢复的旧语言覆盖
+        return _objectSpread(_objectSpread(_objectSpread({}, configItem), item), {}, {
+          label: (_configItem$label = configItem.label) !== null && _configItem$label !== void 0 ? _configItem$label : item.label,
+          other: _objectSpread(_objectSpread(_objectSpread({}, configItem === null || configItem === void 0 ? void 0 : configItem.other), item === null || item === void 0 ? void 0 : item.other), {}, {
+            placeholder: (_configItem$other$pla = configItem === null || configItem === void 0 || (_configItem$other = configItem.other) === null || _configItem$other === void 0 ? void 0 : _configItem$other.placeholder) !== null && _configItem$other$pla !== void 0 ? _configItem$other$pla : item === null || item === void 0 || (_item$other = item.other) === null || _item$other === void 0 ? void 0 : _item$other.placeholder
+          })
+        });
+      });
+    }
+    return _objectSpread(_objectSpread({}, base), {}, {
+      quickFilter: quickFilter,
+      otherFilter: otherFilter,
+      values: (_base$values = base.values) !== null && _base$values !== void 0 ? _base$values : {}
+    });
+  }, [filterValue, hasFilterItems, defaultFilterFromConfig, derivedFilterFromColumns]);
+
+  // 右侧 Filter 只展示高级筛选，快筛全部在左侧
+  var filterValueForPisellFilter = useMemo(function () {
+    return _objectSpread(_objectSpread({}, effectiveFilterValue), {}, {
+      quickFilter: []
+    });
+  }, [effectiveFilterValue]);
+  var handleFilterChange = useCallback(function (value) {
+    var _currentFilter$values, _value$values;
+    var currentFilter = searchParams === null || searchParams === void 0 ? void 0 : searchParams[FILTER_PARAMS_FIELD];
+    var currentValues = (_currentFilter$values = currentFilter === null || currentFilter === void 0 ? void 0 : currentFilter.values) !== null && _currentFilter$values !== void 0 ? _currentFilter$values : {};
+    var incomingValues = (_value$values = value === null || value === void 0 ? void 0 : value.values) !== null && _value$values !== void 0 ? _value$values : {};
+    var nextFilter = _objectSpread(_objectSpread({}, value), {}, {
+      values: _objectSpread(_objectSpread({}, currentValues), incomingValues)
+    });
+    onSearch(_objectSpread(_objectSpread({}, searchParams), {}, _defineProperty({}, FILTER_PARAMS_FIELD, nextFilter)));
+  }, [onSearch, searchParams]);
+  var filterResetKey = (_filterResetKey = ctx.filterResetKey) !== null && _filterResetKey !== void 0 ? _filterResetKey : 0;
+  var filterNode = hideFilter ? null : /*#__PURE__*/React.createElement(PisellFilter, _extends({
+    key: "record-board-filter-".concat(filterResetKey),
+    value: filterValueForPisellFilter,
+    onChange: handleFilterChange,
+    hasForm: true,
+    quickFilterMaxLength: 100,
+    formFiltersPrefix: "",
+    size: "large",
+    buttonClassName: "record-board-toolbar-filter-btn",
+    hiddenQuickFilter: true,
+    placement: "bottomLeft"
+  }, _typeof(filterConfig) === 'object' && filterConfig !== null ? filterConfig : {}));
+  var showColumnSetting = slots.columnSetting !== false && Array.isArray(gridColumns) && gridColumns.length > 0;
+  var topRight = /*#__PURE__*/React.createElement(Space, null, showColumnSetting ? /*#__PURE__*/React.createElement(RecordBoardColumnSetting, null) : null, sortNode, filterNode, /*#__PURE__*/React.createElement(ToolBarReset, {
+    size: "large"
+  }), slots.topRight);
+  return /*#__PURE__*/React.createElement(PisellToolBar, {
+    className: slots.className,
+    style: slots.style,
+    tabs: slots.tabs,
+    topLeft: topLeft,
+    topRight: topRight,
+    bottomLeft: slots.bottomLeft,
+    bottomRight: slots.bottomRight
+  });
+};
+RecordBoardToolBar.displayName = 'RecordBoard.ToolBar';
+export default RecordBoardToolBar;

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

@@ -0,0 +1,17 @@
+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/ToolBarQuickFilter/index.js

@@ -0,0 +1,77 @@
+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 _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 _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, { useCallback, useEffect } from 'react';
+import { Form } from 'antd';
+import QuickFilter from "../../../filter/components/QuickFilter";
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+/** 筛选在 searchParams 中的字段名，与 ToolBar 一致 */
+var FILTER_PARAMS_FIELD = 'filter';
+/**
+ * RecordBoard 工具栏左侧内联快速筛选：将 quickFilter 直接展示在 ToolBar 左侧，不放入 Filter 弹层。
+ * 与 searchParams.filter 联动，变更写入 searchParams.filter.values 并触发 onSearch。
+ * 启用时建议 ToolBar 对 PisellFilter 传 hiddenQuickFilter: true，仅保留高级筛选在弹层内。
+ */
+var ToolBarQuickFilter = function ToolBarQuickFilter(_ref) {
+  var _filterValue$values;
+  var _ref$filterList = _ref.filterList,
+    filterList = _ref$filterList === void 0 ? [] : _ref$filterList,
+    _ref$formFiltersPrefi = _ref.formFiltersPrefix,
+    formFiltersPrefix = _ref$formFiltersPrefi === void 0 ? '' : _ref$formFiltersPrefi,
+    _ref$size = _ref.size,
+    size = _ref$size === void 0 ? 'large' : _ref$size;
+  var ctx = useRecordBoardContext();
+  var searchParams = ctx.searchParams,
+    onSearch = ctx.onSearch;
+  var _Form$useForm = Form.useForm(),
+    _Form$useForm2 = _slicedToArray(_Form$useForm, 1),
+    form = _Form$useForm2[0];
+  var filterValue = searchParams === null || searchParams === void 0 ? void 0 : searchParams[FILTER_PARAMS_FIELD];
+  var currentValues = (_filterValue$values = filterValue === null || filterValue === void 0 ? void 0 : filterValue.values) !== null && _filterValue$values !== void 0 ? _filterValue$values : {};
+  useEffect(function () {
+    var next = _typeof(currentValues) === 'object' && currentValues !== null ? currentValues : {};
+    var byNames = filterList.reduce(function (acc, item) {
+      var _item$name, _next$String;
+      var name = (_item$name = item.name) !== null && _item$name !== void 0 ? _item$name : item.key;
+      if (name != null) acc[String(name)] = (_next$String = next[String(name)]) !== null && _next$String !== void 0 ? _next$String : undefined;
+      return acc;
+    }, {});
+    form.setFieldsValue(byNames);
+  }, [currentValues, form, filterList]);
+  var handleValuesChange = useCallback(function (_, allValues) {
+    if (_typeof(allValues) !== 'object' || allValues === null) return;
+    var nextFilter = _objectSpread(_objectSpread({}, filterValue), {}, {
+      values: _objectSpread(_objectSpread({}, currentValues), allValues)
+    });
+    onSearch(_objectSpread(_objectSpread({}, searchParams), {}, _defineProperty({}, FILTER_PARAMS_FIELD, nextFilter)));
+  }, [searchParams, filterValue, currentValues, onSearch]);
+  if (!Array.isArray(filterList) || filterList.length === 0) {
+    return null;
+  }
+  return /*#__PURE__*/React.createElement(Form, {
+    form: form,
+    layout: "inline",
+    size: size,
+    onValuesChange: handleValuesChange,
+    style: {
+      marginRight: 0
+    },
+    className: "record-board-toolbar-quick-filter-form"
+  }, /*#__PURE__*/React.createElement(QuickFilter, {
+    value: {
+      quickFilter: filterList
+    },
+    formFiltersPrefix: formFiltersPrefix
+  }));
+};
+ToolBarQuickFilter.displayName = 'RecordBoard.ToolBarQuickFilter';
+export default ToolBarQuickFilter;

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

@@ -0,0 +1,16 @@
+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/ToolBarReset/index.js

@@ -0,0 +1,65 @@
+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 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); }
+import React, { useCallback } from 'react';
+import { Button } from 'antd';
+import { ReloadOutlined } from '@ant-design/icons';
+import { locales as utilsLocales } from '@pisell/utils';
+import { useRecordBoardContext } from "../../hooks/useRecordBoardContext";
+import { getText } from "../../../../locales";
+import "./index.less";
+
+/** 与 Quick Filter 同源：优先 utils，若 utils 返回 key（未命中）则用 materials 再回退 */
+function getResetButtonText() {
+  var key = 'pisell2.recordBoard.toolbar.reset';
+  var u = utilsLocales.getText(key);
+  return u && u !== key ? u : getText(key) || getText('record-board-toolbar-reset');
+}
+
+/** 筛选在 searchParams 中的字段名，与 ToolBar 一致 */
+var FILTER_PARAMS_FIELD = 'filter';
+/** 排序在 searchParams 中的字段名，与 ToolBar 一致 */
+var SORT_PARAMS_FIELD = 'sort';
+/**
+ * RecordBoard 工具栏重置按钮：清空筛选与排序并刷新表格。
+ * 点击后以空 filter.values、清空 sort 调用 onSearch，并调用 onReset（若提供）。
+ */
+var ToolBarReset = function ToolBarReset(_ref) {
+  var _ref$size = _ref.size,
+    size = _ref$size === void 0 ? 'large' : _ref$size,
+    _ref$type = _ref.type,
+    type = _ref$type === void 0 ? 'default' : _ref$type,
+    children = _ref.children;
+  var defaultResetText = getResetButtonText();
+  var _useRecordBoardContex = useRecordBoardContext(),
+    searchParams = _useRecordBoardContex.searchParams,
+    onSearch = _useRecordBoardContex.onSearch,
+    onReset = _useRecordBoardContex.onReset,
+    setFilterResetKey = _useRecordBoardContex.setFilterResetKey;
+  var handleReset = useCallback(function () {
+    var _currentFilter$otherF;
+    setFilterResetKey === null || setFilterResetKey === void 0 || setFilterResetKey(function (prev) {
+      return prev + 1;
+    });
+    var currentFilter = searchParams === null || searchParams === void 0 ? void 0 : searchParams[FILTER_PARAMS_FIELD];
+    var nextParams = _objectSpread(_objectSpread({}, searchParams), {}, _defineProperty(_defineProperty({}, FILTER_PARAMS_FIELD, _objectSpread(_objectSpread({}, currentFilter), {}, {
+      quickFilter: [],
+      otherFilter: (_currentFilter$otherF = currentFilter === null || currentFilter === void 0 ? void 0 : currentFilter.otherFilter) !== null && _currentFilter$otherF !== void 0 ? _currentFilter$otherF : [],
+      values: {}
+    })), SORT_PARAMS_FIELD, undefined));
+    onSearch(nextParams);
+    onReset === null || onReset === void 0 || onReset();
+  }, [searchParams, onSearch, onReset, setFilterResetKey]);
+  return /*#__PURE__*/React.createElement(Button, {
+    className: "record-board-toolbar-reset",
+    type: type,
+    icon: /*#__PURE__*/React.createElement(ReloadOutlined, null),
+    onClick: handleReset,
+    size: size
+  }, children !== null && children !== void 0 ? children : defaultResetText);
+};
+ToolBarReset.displayName = 'RecordBoard.ToolBarReset';
+export default ToolBarReset;

package/es/components/pisellRecordBoard/shellFrame/ToolBarReset/index.less

@@ -0,0 +1,41 @@
+/**
+ * ToolBarReset 按钮样式
+ * 依据 Figma Pisell 2.0 Component Library - Secondary Button (node-id=13629-5167)
+ * - 边框: 1px solid #E5E7EB (neutral-200)
+ * - 圆角: 8px
+ * - 背景: #FFFFFF (neutral-0)
+ * - 文字: 16px Medium, line-height 24px, #374151 (neutral-700)
+ * - 内边距: 12px 20px，高度 50px
+ */
+.record-board-toolbar-reset {
+  &.pisell-lowcode-btn {
+    height: 50px;
+    padding: 12px 20px;
+    font-size: 16px;
+    font-weight: 600;
+    line-height: 24px;
+    color: #374151;
+    background-color: #ffffff;
+    border: 1px solid #e5e7eb;
+    border-width: 1px;
+    border-radius: 8px;
+    box-shadow: 0px 1px 2px rgba(16, 24, 40, 0.05);
+
+    &.pisell-lowcode-btn-lg {
+      height: 50px;
+      padding: 12px 20px;
+      font-size: 16px;
+    }
+
+    &:hover:not(:disabled) {
+      color: #374151;
+      background-color: #f9fafb;
+      border-color: #e5e7eb;
+    }
+
+    &:focus-visible {
+      outline: none;
+      box-shadow: 0 0 0 2px rgba(59, 130, 246, 0.2);
+    }
+  }
+}

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

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

package/es/components/pisellRecordBoard/shellFrame/index.js

@@ -0,0 +1,104 @@
+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 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); }
+import React, { useRef, useEffect } from 'react';
+import { PisellShellFrame } from "../../pisellShellFrame";
+import { useRecordBoardContext } from "../hooks/useRecordBoardContext";
+import RecordBoardToolBar from "./ToolBar";
+import RecordBoardBatchActionBar from "./BatchActionBar";
+import RecordBoardPagination from "./Pagination";
+import RecordBoardSearch from "./Search";
+import ToolBarReset from "./ToolBarReset";
+import ToolBarQuickFilter from "./ToolBarQuickFilter";
+
+/** fillHeight 时内容区可滚动、分页器贴底；默认表头 sticky；grid.scroll.autoCalc 时需测量高度供 scroll.y */
+var FILL_HEIGHT_SCROLL_STYLE = {
+  flex: 1,
+  minHeight: 0,
+  overflow: 'auto'
+};
+
+/** 测量滚动区高度并写入 context，供 Grid 在 scroll.autoCalc 时计算 scroll.y（对齐 table useGenScroll）。autoCalc 时 overflow 为 hidden，仅 Table 内部滚动。 */
+function ScrollAreaMeasurer(_ref) {
+  var children = _ref.children,
+    onHeight = _ref.onHeight,
+    autoCalc = _ref.autoCalc;
+  var ref = useRef(null);
+  useEffect(function () {
+    var el = ref.current;
+    if (!el) return;
+    var ro = new ResizeObserver(function (entries) {
+      var entry = entries[0];
+      if (entry) onHeight(entry.contentRect.height);
+    });
+    ro.observe(el);
+    onHeight(el.getBoundingClientRect().height);
+    return function () {
+      ro.disconnect();
+      onHeight(null);
+    };
+  }, [onHeight]);
+  return /*#__PURE__*/React.createElement("div", {
+    ref: ref,
+    className: "pisell-record-board-scroll-body",
+    style: _objectSpread(_objectSpread({}, FILL_HEIGHT_SCROLL_STYLE), {}, {
+      overflow: autoCalc ? 'hidden' : 'auto'
+    })
+  }, children);
+}
+var FILL_HEIGHT_WRAPPER_STYLE = {
+  flex: 1,
+  minHeight: 0,
+  display: 'flex',
+  flexDirection: 'column'
+};
+
+/**
+ * Shell Frame：基于 PisellShellFrame 的 RecordBoard 壳层。
+ * 提供工具栏、多选操作条、分页；与 Layout 同级，包裹在 Layout 外层。
+ * 默认占满父容器高度，内容区可滚动，分页器固定在底部。
+ *
+ * 使用方式：
+ * <PisellRecordBoard>
+ *   <PisellRecordBoard.ShellFrame>
+ *     <PisellRecordBoard.GridLayout />
+ *   </PisellRecordBoard.ShellFrame>
+ * </PisellRecordBoard>
+ */
+var RecordBoardShellFrame = function RecordBoardShellFrame(_ref2) {
+  var _ctx$setScrollAreaHei, _ctx$childComponentPr;
+  var children = _ref2.children,
+    className = _ref2.className,
+    style = _ref2.style;
+  var ctx = useRecordBoardContext({
+    displayName: 'RecordBoard.ShellFrame'
+  });
+  var fillHeight = (ctx === null || ctx === void 0 ? void 0 : ctx.fillHeight) === true;
+  var bodyContent = fillHeight ? /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(ScrollAreaMeasurer, {
+    onHeight: (_ctx$setScrollAreaHei = ctx === null || ctx === void 0 ? void 0 : ctx.setScrollAreaHeight) !== null && _ctx$setScrollAreaHei !== void 0 ? _ctx$setScrollAreaHei : function () {},
+    autoCalc: ctx === null || ctx === void 0 || (_ctx$childComponentPr = ctx.childComponentProps) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.grid) === null || _ctx$childComponentPr === void 0 || (_ctx$childComponentPr = _ctx$childComponentPr.scroll) === null || _ctx$childComponentPr === void 0 ? void 0 : _ctx$childComponentPr.autoCalc
+  }, children), /*#__PURE__*/React.createElement(RecordBoardPagination, null)) : /*#__PURE__*/React.createElement(React.Fragment, null, children, /*#__PURE__*/React.createElement(RecordBoardPagination, null));
+  var shellStyle = fillHeight && style ? _objectSpread(_objectSpread({}, style), FILL_HEIGHT_WRAPPER_STYLE) : fillHeight ? FILL_HEIGHT_WRAPPER_STYLE : style;
+  var wrapper = /*#__PURE__*/React.createElement(PisellShellFrame, {
+    className: className,
+    style: shellStyle,
+    config: {
+      showToolbar: true,
+      showBatchActionBar: true
+    },
+    toolbar: /*#__PURE__*/React.createElement(RecordBoardToolBar, null),
+    batchActionBar: /*#__PURE__*/React.createElement(RecordBoardBatchActionBar, null)
+  }, bodyContent);
+  if (fillHeight) {
+    return /*#__PURE__*/React.createElement("div", {
+      style: FILL_HEIGHT_WRAPPER_STYLE
+    }, wrapper);
+  }
+  return wrapper;
+};
+RecordBoardShellFrame.displayName = 'RecordBoard.ShellFrame';
+export default RecordBoardShellFrame;
+export { RecordBoardToolBar, RecordBoardBatchActionBar, RecordBoardPagination, RecordBoardSearch, ToolBarReset, ToolBarQuickFilter };