@pisell/materials 6.3.26 → 6.3.28

package/es/components/pisellPhone/components/ReadOnlyView.js

@@ -7,7 +7,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import React from 'react';
 import { Typography, Button, Space } from 'antd';
 import { PhoneOutlined } from '@ant-design/icons';
-import { formatPhone, maskPhone, getCountryFlag } from "../utils";
+import { formatPhone, maskPhone } from "../utils";
 /**
  * PisellPhone 只读态视图组件
  * 
@@ -22,6 +22,7 @@ import { formatPhone, maskPhone, getCountryFlag } from "../utils";
  * @param props 组件 Props
  */
 var ReadOnlyView = function ReadOnlyView(props) {
+  var _props$fontSize, _props$fontWeight;
   var isMobile = /iPhone|iPad|iPod|Android/i.test(navigator.userAgent);
   var countryCode = props.countryCode || '+86';
 
@@ -50,19 +51,27 @@ var ReadOnlyView = function ReadOnlyView(props) {
     }
   };
   var canDial = props.enableDial !== false && isMobile;
+  var textColor = canDial ? '#7F56DA' : props.color || '#101828';
+  var textFontSize = (_props$fontSize = props.fontSize) !== null && _props$fontSize !== void 0 ? _props$fontSize : 16;
+  var textFontWeight = (_props$fontWeight = props.fontWeight) !== null && _props$fontWeight !== void 0 ? _props$fontWeight : 500;
   return /*#__PURE__*/React.createElement("div", {
     className: "pisell-phone-read ".concat(props.className || '')
   }, /*#__PURE__*/React.createElement(Space, {
     size: "small"
   }, props.showFlag !== false && /*#__PURE__*/React.createElement("span", {
-    className: "pisell-phone-flag"
-  }, getCountryFlag(countryCode)), /*#__PURE__*/React.createElement(Typography.Text, {
+    className: "pisell-phone-country-code",
+    style: {
+      fontSize: textFontSize,
+      fontWeight: textFontWeight,
+      color: textColor
+    }
+  }, countryCode), /*#__PURE__*/React.createElement(Typography.Text, {
     className: canDial ? 'pisell-phone-clickable' : '',
     onClick: canDial ? handleDial : undefined,
     style: _objectSpread({
-      fontSize: props.fontSize || 16,
-      fontWeight: props.fontWeight || 500,
-      color: canDial ? '#7F56DA' : props.color || '#101828',
+      fontSize: textFontSize,
+      fontWeight: textFontWeight,
+      color: textColor,
       cursor: canDial ? 'pointer' : 'default',
       textDecoration: canDial ? 'underline' : 'none'
     }, props.style)

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

@@ -1,7 +1,8 @@
 /**
  * PisellPhone 组件导出
  */
-export { default as PisellPhone } from './PisellPhone';
+import PisellPhone from './PisellPhone';
+export { PisellPhone };
 export type { PisellPhoneProps, CountryCode } from './types';
 export { PRESET_COUNTRY_CODES, DEFAULT_COUNTRY_CODE, COMMON_COUNTRY_CODES } from './constants/countryCodes';
 export type { DisplayState, ValidationResult, TextInputState } from './types';

package/es/components/pisellPhone/index.js

@@ -2,7 +2,22 @@
  * PisellPhone 组件导出
  */
 
-export { default as PisellPhone } from "./PisellPhone";
+import { getText } from "../../locales";
+import PisellPhone from "./PisellPhone";
+
+/** RecordBoard 列 type 联动排序：内置 A → Z / Z → A */
+PisellPhone.SortOptions = {
+  getSortItems: function getSortItems(fieldKey) {
+    return [{
+      key: "".concat(fieldKey, ":asc"),
+      label: getText('sort-a-z')
+    }, {
+      key: "".concat(fieldKey, ":desc"),
+      label: getText('sort-z-a')
+    }];
+  }
+};
+export { PisellPhone };
 // 导出预设国家码列表，方便使用
 export { PRESET_COUNTRY_CODES, DEFAULT_COUNTRY_CODE, COMMON_COUNTRY_CODES } from "./constants/countryCodes";
 

package/es/components/pisellPhone/utils/phoneFormatter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * 电话号码格式化工具
+ */
+/**
+ * 中国大陆手机号格式化：138 0000 0000
+ */
+export declare function formatChinaMobile(phone: string): string;
+/**
+ * 美国/加拿大号码格式化：(555) 123-4567
+ */
+export declare function formatUSPhone(phone: string): string;
+/**
+ * 英国号码格式化：1234 567 8900
+ */
+export declare function formatUKPhone(phone: string): string;
+/**
+ * 根据国家码格式化电话号码
+ * @param phone 电话号码（纯数字）
+ * @param countryCode 国家码
+ * @returns 格式化后的电话号码
+ */
+export declare function formatPhone(phone: string, countryCode: string): string;
+/**
+ * 电话号码脱敏
+ * @param phone 电话号码
+ * @param pattern 脱敏模式
+ * @returns 脱敏后的号码
+ *
+ * @example
+ * maskPhone('13800000000', 'middle') // '138****0000'
+ * maskPhone('13800000000', 'last')   // '1380000****'
+ */
+export declare function maskPhone(phone: string, pattern?: 'middle' | 'last'): string;
+/**
+ * 检测号码类型（中国）
+ * @param phone 电话号码
+ * @returns 号码类型
+ */
+export declare function detectPhoneType(phone: string): 'mobile' | 'landline' | 'unknown';

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

@@ -0,0 +1,24 @@
+import React from 'react';
+import './index.less';
+export interface PisellQRScannerProps {
+    /** 是否可见 */
+    visible: boolean;
+    /** 是否显示上传图片按钮 */
+    showUpload?: boolean;
+    /** 关闭回调 */
+    onClose: () => void;
+    /** 扫码成功回调 */
+    onScan: (value: string) => void;
+    /**
+     * 样式属性，可选
+     * 注意: 不应传入renderMode等不必要属性
+     */
+    style?: React.CSSProperties;
+    /** 类名，可选 */
+    className?: string;
+}
+/**
+ * 二维码扫描组件
+ */
+declare const PisellQRScanner: React.FC<PisellQRScannerProps>;
+export default PisellQRScanner;

package/es/components/pisellQuickFilter/type.d.ts

@@ -0,0 +1,12 @@
+/// <reference types="react" />
+import { FilterItemProps } from '../filter/types';
+import { FormInstance } from 'antd';
+export declare type PisellQuickFilterProps = FormInstance & {
+    hasForm?: boolean;
+    children?: React.ReactNode;
+    formFiltersPrefix: string;
+    filterList?: FilterItemProps[];
+    quickFilterMaxLength: number;
+    hiddenQuickFilter: boolean;
+    hiddenOtherFilter: boolean;
+};

package/es/components/pisellRating/PisellRating.less

@@ -1,41 +1,49 @@
-// PisellRating 组件样式
+/**
+ * PisellRating 组件样式
+ * 基于 Figma 设计规范，覆盖时使用 pisell-lowcode-xxx
+ */
 
 .pisell-rating {
   display: inline-flex;
   align-items: center;
-  
+
   // 只读态
   &-read {
-    .ant-rate {
+    .pisell-lowcode-rate {
       cursor: default;
       pointer-events: none;
     }
   }
-  
+
   // 编辑态
   &-edit {
-    .ant-rate {
+    .pisell-lowcode-rate {
       cursor: pointer;
     }
   }
-  
+
   // 禁用态
   &-disabled {
     opacity: 0.4;
-    
-    .ant-rate {
+
+    .pisell-lowcode-rate {
       cursor: not-allowed;
     }
   }
-  
-  // 评分数值文本
+
+  // 评分数值文本（与设计体系一致）
   &-value {
     font-size: 14px;
-    color: rgba(0, 0, 0, 0.85);
+    line-height: 1.5;
+    color: #101828; // Gray/900
+    margin-left: 8px;
   }
-  
+
   // 评分人数文本
   &-count {
     font-size: 14px;
+    line-height: 1.5;
+    color: #667085; // Gray/500
+    margin-left: 8px;
   }
 }

package/es/components/pisellRating/PisellRating.stories.js

@@ -10,7 +10,7 @@ import { useState } from 'react';
 import { Form } from 'antd';
 import { HeartFilled, SmileFilled } from '@ant-design/icons';
 var meta = {
-  title: 'Components/PisellRating',
+  title: '表单/表单组件/PisellRating',
   component: PisellRating,
   tags: ['autodocs']
 };

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

@@ -1,6 +1,7 @@
 /**
  * PisellRating 组件导出
  */
-export { default as PisellRating } from './PisellRating';
+import PisellRating from './PisellRating';
+export { PisellRating };
 export type { PisellRatingProps } from './types';
 export type { DisplayState } from './types';

package/es/components/pisellRating/index.js

@@ -2,6 +2,21 @@
  * PisellRating 组件导出
  */
 
-export { default as PisellRating } from "./PisellRating";
+import { getText } from "../../locales";
+import PisellRating from "./PisellRating";
+
+/** RecordBoard 列 type 联动排序：内置 0 → 9 / 9 → 0 */
+PisellRating.SortOptions = {
+  getSortItems: function getSortItems(fieldKey) {
+    return [{
+      key: "".concat(fieldKey, ":asc"),
+      label: getText('sort-0-9')
+    }, {
+      key: "".concat(fieldKey, ":desc"),
+      label: getText('sort-9-0')
+    }];
+  }
+};
+export { PisellRating };
 
 // 公共类型重新导出

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

@@ -0,0 +1,8 @@
+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.js

@@ -0,0 +1,243 @@
+var _excluded = ["children", "layoutType", "rowKey", "data", "loading", "total", "pagination", "onPageChange", "searchParams", "onSearch", "onReset"];
+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 _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+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; }
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
+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, { useMemo, useState, useCallback, useEffect } from 'react';
+import { getColumnVisibilityFromLocal, getRecordBoardColumnSettingFromLocal, saveColumnVisibilityToLocal } from '@pisell/utils';
+import { RecordBoardProvider } from "./context/RecordBoardProvider";
+import { getRecordBoardColumnKey } from "./utils/recordBoardColumns";
+var defaultPagination = {
+  pageNumber: 1,
+  pageSize: 50
+};
+
+/**
+ * 从打散 props 合并出 childComponentProps（供 context 使用）。
+ */
+function mergeChildComponentProps(props) {
+  var hasAny = props.grid != null || props.toolBar != null || props.search != null || props.paginationConfig != null || props.batchActionBar != null || props.cardList != null;
+  if (!hasAny) return undefined;
+  return _objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread(_objectSpread({}, props.grid != null && {
+    grid: props.grid
+  }), props.toolBar != null && {
+    toolBar: props.toolBar
+  }), props.search != null && {
+    search: props.search
+  }), props.paginationConfig != null && {
+    pagination: props.paginationConfig
+  }), props.batchActionBar != null && {
+    batchActionBar: props.batchActionBar
+  }), props.cardList != null && {
+    cardList: props.cardList
+  });
+}
+
+/**
+ * 默认的 context 值（用于无数据源时的占位 / 设计态）
+ */
+function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
+  return {
+    data: [],
+    loading: false,
+    total: 0,
+    pagination: defaultPagination,
+    onPageChange: function onPageChange() {},
+    searchParams: {},
+    onSearch: function onSearch() {},
+    onReset: function onReset() {},
+    layoutType: layoutType,
+    selectedKeys: selection.selectedKeys,
+    selectedRows: selection.selectedRows,
+    onSelectionChange: selection.onSelectionChange,
+    rowKey: rowKey,
+    childComponentProps: undefined,
+    scrollAreaHeight: null,
+    setScrollAreaHeight: undefined,
+    filterResetKey: undefined,
+    setFilterResetKey: undefined
+  };
+}
+
+/**
+ * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
+ * 仅接受打散 props：列表/分页/搜索/多选/列显隐、以及 grid/toolBar/search/paginationConfig/batchActionBar/cardList。
+ */
+var PisellRecordBoard = function PisellRecordBoard(props) {
+  var _props$columnVisibili;
+  var children = props.children,
+    _props$layoutType = props.layoutType,
+    layoutType = _props$layoutType === void 0 ? 'grid' : _props$layoutType,
+    rowKeyProp = props.rowKey,
+    dataProp = props.data,
+    loadingProp = props.loading,
+    totalProp = props.total,
+    paginationProp = props.pagination,
+    onPageChangeProp = props.onPageChange,
+    searchParamsProp = props.searchParams,
+    onSearchProp = props.onSearch,
+    onResetProp = props.onReset,
+    rest = _objectWithoutProperties(props, _excluded);
+
+  /** 默认占满父容器高度（父容器需有高度，如 height:100vh 或 height:100%） */
+  var fillHeight = true;
+
+  /** 列显隐持久化 key：优先 columnVisibilityStorageKey，其次 __id（与 DataSourceContainer 一致，复用 @pisell/utils 的 key 规则） */
+  var columnVisibilityStorageKey = (_props$columnVisibili = props.columnVisibilityStorageKey) !== null && _props$columnVisibili !== void 0 ? _props$columnVisibili : props.__id;
+  var mergedChildComponentProps = useMemo(function () {
+    return mergeChildComponentProps(props);
+  }, [props.grid, props.toolBar, props.search, props.paginationConfig, props.batchActionBar, props.cardList]);
+  var _useState = useState([]),
+    _useState2 = _slicedToArray(_useState, 2),
+    internalSelectedKeys = _useState2[0],
+    setInternalSelectedKeys = _useState2[1];
+  var _useState3 = useState([]),
+    _useState4 = _slicedToArray(_useState3, 2),
+    internalSelectedRows = _useState4[0],
+    setInternalSelectedRows = _useState4[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    scrollAreaHeight = _useState6[0],
+    setScrollAreaHeight = _useState6[1];
+  /** 点击重置时递增，供 ToolBar 给 PisellFilter 设 key 以强制重挂载，清空弹窗内高级筛选表单 */
+  var _useState7 = useState(0),
+    _useState8 = _slicedToArray(_useState7, 2),
+    filterResetKey = _useState8[0],
+    setFilterResetKey = _useState8[1];
+  var _useState9 = useState(function () {
+      var _props$grid$defaultHi, _props$grid, _props$grid$columns, _props$grid2;
+      var fromConfig = (_props$grid$defaultHi = (_props$grid = props.grid) === null || _props$grid === void 0 ? void 0 : _props$grid.defaultHiddenColumnKeys) !== null && _props$grid$defaultHi !== void 0 ? _props$grid$defaultHi : [];
+      var fromColumns = ((_props$grid$columns = (_props$grid2 = props.grid) === null || _props$grid2 === void 0 ? void 0 : _props$grid2.columns) !== null && _props$grid$columns !== void 0 ? _props$grid$columns : []).filter(function (col) {
+        return col.hidden === true;
+      }).map(function (col) {
+        return getRecordBoardColumnKey(col);
+      }).filter(Boolean);
+      var allHiddenKeys = Array.from(new Set([].concat(_toConsumableArray(fromConfig), _toConsumableArray(fromColumns))));
+      var defaultVis = {};
+      allHiddenKeys.forEach(function (k) {
+        defaultVis[k] = false;
+      });
+      if (typeof columnVisibilityStorageKey === 'string' && columnVisibilityStorageKey) {
+        if (typeof getRecordBoardColumnSettingFromLocal === 'function') {
+          var saved = getRecordBoardColumnSettingFromLocal(columnVisibilityStorageKey);
+          if (saved !== null && saved !== void 0 && saved.columnVisibility && Object.keys(saved.columnVisibility).length > 0) {
+            return _objectSpread(_objectSpread({}, defaultVis), saved.columnVisibility);
+          }
+        } else if (typeof getColumnVisibilityFromLocal === 'function') {
+          var savedVis = getColumnVisibilityFromLocal(columnVisibilityStorageKey);
+          if (savedVis && Object.keys(savedVis).length > 0) {
+            return _objectSpread(_objectSpread({}, defaultVis), savedVis);
+          }
+        }
+      }
+      return defaultVis;
+    }),
+    _useState10 = _slicedToArray(_useState9, 2),
+    internalColumnVisibility = _useState10[0],
+    setInternalColumnVisibility = _useState10[1];
+  var _useState11 = useState(function () {
+      if (typeof columnVisibilityStorageKey === 'string' && columnVisibilityStorageKey && typeof getRecordBoardColumnSettingFromLocal === 'function') {
+        var _saved$columnOrder;
+        var saved = getRecordBoardColumnSettingFromLocal(columnVisibilityStorageKey);
+        return (_saved$columnOrder = saved === null || saved === void 0 ? void 0 : saved.columnOrder) !== null && _saved$columnOrder !== void 0 ? _saved$columnOrder : null;
+      }
+      return null;
+    }),
+    _useState12 = _slicedToArray(_useState11, 2),
+    internalColumnOrder = _useState12[0],
+    setInternalColumnOrder = _useState12[1];
+  useEffect(function () {
+    if (typeof columnVisibilityStorageKey !== 'string' || !columnVisibilityStorageKey) return;
+    saveColumnVisibilityToLocal({
+      componentId: columnVisibilityStorageKey,
+      columnVisibility: internalColumnVisibility,
+      columnOrder: internalColumnOrder !== null && internalColumnOrder !== void 0 ? internalColumnOrder : undefined
+    });
+  }, [columnVisibilityStorageKey, internalColumnVisibility, internalColumnOrder]);
+  var onSelectionChangeInternal = useCallback(function (keys, rows) {
+    setInternalSelectedKeys(keys);
+    setInternalSelectedRows(rows);
+  }, []);
+  var onColumnVisibilityChangeInternal = useCallback(function (visibility) {
+    setInternalColumnVisibility(function (prev) {
+      return _objectSpread(_objectSpread({}, prev), visibility);
+    });
+  }, []);
+  var onColumnOrderChangeInternal = useCallback(function (columnKeys) {
+    setInternalColumnOrder(columnKeys);
+  }, []);
+  var contextValue = useMemo(function () {
+    var _gridSelection$select;
+    var defaultCtx = getDefaultRecordBoardContext(layoutType, {
+      selectedKeys: internalSelectedKeys,
+      selectedRows: internalSelectedRows,
+      onSelectionChange: onSelectionChangeInternal
+    }, rowKeyProp);
+    var data = dataProp !== undefined ? dataProp : defaultCtx.data;
+    var loading = loadingProp !== undefined ? loadingProp : defaultCtx.loading;
+    var total = totalProp !== undefined ? totalProp : defaultCtx.total;
+    var pagination = paginationProp !== undefined ? paginationProp : defaultCtx.pagination;
+    var onPageChange = onPageChangeProp !== null && onPageChangeProp !== void 0 ? onPageChangeProp : defaultCtx.onPageChange;
+    var searchParams = searchParamsProp !== undefined ? searchParamsProp : defaultCtx.searchParams;
+    var onSearch = onSearchProp !== null && onSearchProp !== void 0 ? onSearchProp : defaultCtx.onSearch;
+    var onReset = onResetProp !== null && onResetProp !== void 0 ? onResetProp : defaultCtx.onReset;
+    var rowKey = rowKeyProp !== null && rowKeyProp !== void 0 ? rowKeyProp : defaultCtx.rowKey;
+    var gridSelection = props.grid;
+    var hasControlledSelection = (gridSelection === null || gridSelection === void 0 ? void 0 : gridSelection.selectedKeys) != null && Array.isArray(gridSelection.selectedKeys) && typeof gridSelection.onSelectionChange === 'function';
+    var selectedKeys = hasControlledSelection ? gridSelection.selectedKeys : internalSelectedKeys;
+    var selectedRows = hasControlledSelection ? (_gridSelection$select = gridSelection.selectedRows) !== null && _gridSelection$select !== void 0 ? _gridSelection$select : [] : internalSelectedRows;
+    var onSelectionChange = hasControlledSelection ? gridSelection.onSelectionChange : onSelectionChangeInternal;
+    return _objectSpread(_objectSpread({}, defaultCtx), {}, {
+      layoutType: layoutType,
+      rowKey: rowKey,
+      data: data,
+      loading: loading,
+      total: total,
+      pagination: pagination,
+      onPageChange: onPageChange,
+      searchParams: searchParams,
+      onSearch: onSearch,
+      onReset: onReset,
+      selectedKeys: selectedKeys,
+      selectedRows: selectedRows,
+      onSelectionChange: onSelectionChange,
+      columnVisibility: internalColumnVisibility,
+      onColumnVisibilityChange: onColumnVisibilityChangeInternal,
+      columnOrder: internalColumnOrder,
+      onColumnOrderChange: onColumnOrderChangeInternal,
+      childComponentProps: mergedChildComponentProps !== null && mergedChildComponentProps !== void 0 ? mergedChildComponentProps : defaultCtx.childComponentProps,
+      fillHeight: fillHeight,
+      scrollAreaHeight: scrollAreaHeight,
+      setScrollAreaHeight: setScrollAreaHeight,
+      filterResetKey: filterResetKey,
+      setFilterResetKey: setFilterResetKey
+    });
+  }, [layoutType, rowKeyProp, dataProp, loadingProp, totalProp, paginationProp, onPageChangeProp, searchParamsProp, onSearchProp, onResetProp, mergedChildComponentProps, internalSelectedKeys, internalSelectedRows, onSelectionChangeInternal, internalColumnVisibility, onColumnVisibilityChangeInternal, internalColumnOrder, onColumnOrderChangeInternal, fillHeight, scrollAreaHeight, filterResetKey]);
+  var content = /*#__PURE__*/React.createElement(RecordBoardProvider, {
+    value: contextValue
+  }, children);
+  return /*#__PURE__*/React.createElement("div", {
+    className: "pisell-record-board-root",
+    style: {
+      height: '100%',
+      display: 'flex',
+      flexDirection: 'column',
+      minHeight: 0
+    }
+  }, content);
+};
+export default PisellRecordBoard;

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

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