@pisell/materials 1.8.17 → 1.8.19

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

@@ -0,0 +1,248 @@
+import type React from 'react';
+import type { CSSProperties } from 'react';
+export declare type PisellHierarchicalSummaryListKey = React.Key;
+export interface PisellHierarchicalSummaryListItem {
+    /**
+     * 行标题。最小字段（必填）
+     */
+    label: React.ReactNode;
+    /**
+     * 行数值。允许 ReactNode（string/number/组合展示）。
+     * 若不传且开启聚合，可能由 children 聚合得到。
+     */
+    value?: React.ReactNode;
+    /**
+     * 子级数据（无限层级递归）
+     */
+    children?: PisellHierarchicalSummaryListItem[];
+    /**
+     * 可选：稳定 key（推荐传入以保证展开态稳定）。
+     * 不传时组件会基于层级路径生成 key。
+     */
+    key?: PisellHierarchicalSummaryListKey;
+    /**
+     * 可选：是否隐藏该项
+     */
+    hidden?: boolean;
+    /**
+     * 可选：排序权重，值越小越靠前
+     */
+    order?: number;
+    /**
+     * 可选：条目数提示（如 "N items" / "N 条"），允许 ReactNode
+     */
+    itemsCount?: React.ReactNode;
+    /**
+     * 可选：信息提示 tooltip 内容（hover 触达）
+     */
+    infoTooltip?: React.ReactNode;
+    /**
+     * 可选：右侧 value 后附加轻量操作（tag/pill/button 等）
+     */
+    extra?: React.ReactNode;
+    /**
+     * 可选：覆盖当前行样式
+     */
+    rowStyle?: CSSProperties;
+    /**
+     * 可选：覆盖当前行类名
+     */
+    rowClassName?: string;
+    /**
+     * 可选：自定义展开内容。若设置，行可展开且展开后渲染此内容（不再渲染 children 列表）。
+     * 用于在列表中嵌入 Collapse 等自定义区块。
+     */
+    expandedContent?: React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListLevelTextStyle {
+    fontSize?: number | string;
+    fontWeight?: number | string;
+    color?: string;
+    /** 行高，如 24 或 '24px' */
+    lineHeight?: number | string;
+}
+export interface PisellHierarchicalSummaryListIconStyle {
+    /** 图标尺寸（px），用于 fontSize 或宽高一致时的边长） */
+    size?: number;
+    color?: string;
+    /** 图标容器宽（px），不传则用 size */
+    width?: number;
+    /** 图标容器高（px），不传则用 size */
+    height?: number;
+}
+export interface PisellHierarchicalSummaryListDividerStyle {
+    show?: boolean;
+    color?: string;
+    style?: 'solid' | 'dashed' | 'dotted';
+}
+export interface PisellHierarchicalSummaryListLevelConfig {
+    /**
+     * 层级缩进（px）。不传则继承全局 indent 规则。
+     */
+    indent?: number;
+    /**
+     * 是否显示 "·" 分隔符（标题区元信息前的点）
+     */
+    showDotSeparator?: boolean;
+    /**
+     * 层级内分割线
+     */
+    divider?: PisellHierarchicalSummaryListDividerStyle;
+    /**
+     * 行容器样式（背景/边框/padding/圆角/阴影等）
+     */
+    rowStyle?: CSSProperties;
+    /**
+     * 行容器类名
+     */
+    rowClassName?: string;
+    /**
+     * 标题文本样式
+     */
+    labelTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+    /**
+     * 数值文本样式
+     */
+    valueTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+    /**
+     * info icon 样式（size/color）
+     */
+    infoIconStyle?: PisellHierarchicalSummaryListIconStyle;
+    /**
+     * 展开/收起箭头 icon 样式（size/color）
+     */
+    expandIconStyle?: PisellHierarchicalSummaryListIconStyle;
+    /**
+     * 行内元信息样式（如 "·"、N items、info icon 的文案颜色/字号等）
+     */
+    metaTextStyle?: PisellHierarchicalSummaryListLevelTextStyle;
+}
+export declare type PisellHierarchicalSummaryListAggregateMode = 'none' | 'sum';
+export interface PisellHierarchicalSummaryListAggregateConfig {
+    /**
+     * 聚合模式
+     * - none: 不聚合
+     * - sum: 对子级 number 值求和（或使用 getNumberValue 提取）
+     * @default 'none'
+     */
+    mode?: PisellHierarchicalSummaryListAggregateMode;
+    /**
+     * 从条目提取 number 值，用于 sum 聚合。
+     * 默认：若 item.value 是 number，则使用该值；否则忽略。
+     */
+    getNumberValue?: (item: PisellHierarchicalSummaryListItem) => number | null | undefined;
+    /**
+     * 聚合结果格式化（sum 输出到 value 区）
+     */
+    format?: (sum: number, ctx: {
+        item: PisellHierarchicalSummaryListItem;
+        level: number;
+    }) => React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListRenderContext {
+    level: number;
+    pathKeys: PisellHierarchicalSummaryListKey[];
+    expanded: boolean;
+    hasChildren: boolean;
+    aggregatedValue?: React.ReactNode;
+}
+export interface PisellHierarchicalSummaryListProps {
+    /**
+     * 数据源
+     */
+    items: PisellHierarchicalSummaryListItem[];
+    /**
+     * 展开项 keys（受控）
+     */
+    expandedKeys?: PisellHierarchicalSummaryListKey[];
+    /**
+     * 默认展开项 keys（非受控）
+     */
+    defaultExpandedKeys?: PisellHierarchicalSummaryListKey[];
+    /**
+     * 默认展开层级（非受控初始化）。0 表示只展示 L1（不默认展开子级）。
+     * @default 0
+     */
+    defaultExpandedLevel?: number;
+    /**
+     * 展开项变化回调
+     */
+    onExpandedKeysChange?: (keys: PisellHierarchicalSummaryListKey[]) => void;
+    /**
+     * 手风琴模式：同一层级下仅允许一个子项展开
+     * @default false
+     */
+    accordion?: boolean;
+    /**
+     * 最大渲染层级（从 1 开始）。超过层级仍保留行，但不再渲染 children。
+     */
+    maxRenderLevel?: number;
+    /**
+     * 最大可展开层级（从 1 开始）。超过层级不显示展开箭头。
+     */
+    maxExpandLevel?: number;
+    /**
+     * 全局缩进（px），作用于 L2+；也可通过 levelConfig 覆盖。
+     * @default 16
+     */
+    indent?: number;
+    /**
+     * 行间距（px）
+     * @default 8
+     */
+    rowGap?: number;
+    /**
+     * 容器内边距（px 或 CSS 值），不传则使用 less 默认 20px
+     */
+    padding?: number | string;
+    /**
+     * 行内间距（px），用于 1:1 复刻设计稿
+     * - row: 行内左右两栏间距
+     * - rowLeft: 左侧 label 与 meta（· / N items）间距
+     * - meta: meta 内 dot / items-count / info 间距
+     * - rowRight: 右侧 value 与 extra / 展开图标间距
+     */
+    gaps?: {
+        row?: number;
+        rowLeft?: number;
+        meta?: number;
+        rowRight?: number;
+    };
+    /**
+     * 按层级配置样式与功能开关（key 为 level，从 1 开始）
+     */
+    levelConfig?: Record<number, PisellHierarchicalSummaryListLevelConfig>;
+    /**
+     * 自定义渲染 label
+     */
+    renderLabel?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    /**
+     * 自定义渲染 value
+     */
+    renderValue?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    /**
+     * 自定义 key 生成（当 item.key 不存在时使用）
+     */
+    getKey?: (item: PisellHierarchicalSummaryListItem, ctx: {
+        level: number;
+        index: number;
+        parentPathKeys: PisellHierarchicalSummaryListKey[];
+    }) => PisellHierarchicalSummaryListKey;
+    /**
+     * 聚合配置：支持内置或外部传入
+     */
+    aggregate?: PisellHierarchicalSummaryListAggregateConfig;
+    /**
+     * 根节点类名
+     */
+    className?: string;
+    /**
+     * 根节点样式
+     */
+    style?: CSSProperties;
+    /**
+     * 是否渲染根节点 div。为 false 时只渲染内部内容（用于外层用同一 DOM 包裹列表与其它区块）。
+     * @default true
+     */
+    renderRoot?: boolean;
+}

package/es/components/pisellHierarchicalSummaryList/types.js

@@ -0,0 +1 @@
+export {};

package/es/components/pisellInformationEntry/Input/index.d.ts

@@ -4,5 +4,5 @@ export interface PisellEntryInputProps {
     onChange: (val: string) => void;
     searchDescribe?: React.ReactNode;
 }
-declare const PisellEntryInput: (props: PisellEntryInputProps) => React.JSX.Element;
+declare const PisellEntryInput: (props: PisellEntryInputProps) => JSX.Element;
 export default PisellEntryInput;

package/es/components/pisellInformationEntry/Scan/index.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 import './index.less';
 export interface ScanProps {
     onChange: (val: string) => void;
     onCancel: () => void;
 }
-declare const Scan: (props: ScanProps) => React.JSX.Element;
+declare const Scan: (props: ScanProps) => JSX.Element;
 export default Scan;

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

@@ -29,5 +29,5 @@ export interface PisellInformationEntryProps extends Omit<React.HTMLAttributes<H
     /** 录入类型切换时候触发的 */
     onChangeType?: (val: null | EntryModeType['type']) => void;
 }
-declare const PisellInformationEntry: (props: PisellInformationEntryProps) => React.JSX.Element;
+declare const PisellInformationEntry: (props: PisellInformationEntryProps) => JSX.Element;
 export default PisellInformationEntry;

package/es/components/pisellInput/components/BankCard/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 import './index.less';
@@ -7,5 +7,5 @@ export declare type BankCardProps = InputProps & {
     platform?: PisellContextType['platform'];
     onChange?: (val: string) => void;
 };
-declare const BankCard: (props: BankCardProps) => React.JSX.Element;
+declare const BankCard: (props: BankCardProps) => JSX.Element;
 export default BankCard;

package/es/components/pisellInput/components/Copy/index.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {
@@ -7,5 +6,5 @@ export interface CopyProps extends InputProps {
     /** 后缀button的透传配置 */
     buttonProps?: ButtonProps;
 }
-declare const Copy: (props: CopyProps) => React.JSX.Element;
+declare const Copy: (props: CopyProps) => JSX.Element;
 export default Copy;

package/es/components/pisellInput/components/SecurityCode/index.d.ts

@@ -1,4 +1,4 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import './index.less';
 import { PisellContextType } from "../../../pisell-config-provider/context";
@@ -8,5 +8,5 @@ export interface SecurityCodeProps extends Omit<InputProps, 'onChange'> {
     onChange?: (val: string) => void;
     showCVCIcon?: boolean;
 }
-declare const SecurityCode: (props: SecurityCodeProps) => React.JSX.Element;
+declare const SecurityCode: (props: SecurityCodeProps) => JSX.Element;
 export default SecurityCode;

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

@@ -1,13 +1,13 @@
-import React from 'react';
+/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from '../pisell-config-provider/context';
 declare const PisellInput: {
     (props: InputProps & {
         /** 平台 */
         platform?: PisellContextType['platform'];
-    }): React.JSX.Element;
-    BankCard: (props: import("./components/BankCard").BankCardProps) => React.JSX.Element;
-    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => React.JSX.Element;
-    Copy: (props: import("./components/Copy").CopyProps) => React.JSX.Element;
+    }): JSX.Element;
+    BankCard: (props: import("./components/BankCard").BankCardProps) => JSX.Element;
+    SecurityCode: (props: import("./components/SecurityCode").SecurityCodeProps) => JSX.Element;
+    Copy: (props: import("./components/Copy").CopyProps) => JSX.Element;
 };
 export default PisellInput;

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

@@ -1,4 +1,3 @@
-import React from 'react';
 import { SpinProps } from 'antd';
 import './index.less';
 declare type MaskType = {
@@ -16,5 +15,5 @@ export interface PisellLoadingProps extends SpinProps {
     /** 延迟显示加载效果的时间（防止闪烁）	 */
     delay?: number;
 }
-declare const PisellLoading: (props: PisellLoadingProps) => React.JSX.Element;
+declare const PisellLoading: (props: PisellLoadingProps) => JSX.Element;
 export default PisellLoading;

package/es/components/pisellLookup/PisellLookup.js

@@ -428,15 +428,22 @@ var PisellLookupComponent = /*#__PURE__*/forwardRef(function (props, ref) {
 
   /**
    * 处理扫码
+   * 标记为手动操作，避免 setKeyword 触发的重渲染时防抖 effect 仍用旧的 debouncedKeyword('') 再触发一次 onSearch('')
    */
   var handleScan = useCallback(function (code) {
+    // 标记为手动操作，阻止实时搜索防抖在本次更新后误触 onSearch('')
+    isManualSelectRef.current = true;
     // 将扫码结果填入关键词
     setKeyword(code);
     // 触发搜索并保存历史记录
     handleConfirmSearch(code);
     // 触发扫码回调
     onScan === null || onScan === void 0 || onScan(code);
-  }, [setKeyword, handleConfirmSearch, onScan]);
+    // 延迟重置标记（与 handleClear 一致，等待防抖周期结束）
+    setTimeout(function () {
+      isManualSelectRef.current = false;
+    }, debounceTime + 100);
+  }, [setKeyword, handleConfirmSearch, onScan, debounceTime]);
 
   /**
    * 处理选择辅助项（历史/联想词/热门搜索）

package/es/components/pisellModal/components/Information/index.d.ts

@@ -17,5 +17,5 @@ export interface InformationProps extends PisellModalProps {
     /** 右上角关闭按钮是否展示 */
     closable?: boolean;
 }
-declare const Information: (props: InformationProps) => React.JSX.Element;
+declare const Information: (props: InformationProps) => JSX.Element;
 export default Information;

package/es/components/pisellModal/components/IpadModal/index.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
+/// <reference types="react" />
 import { PcModalProps } from '../PcModal';
 export interface IpadModalProps extends PcModalProps {
 }
-declare const IpadModal: (props: IpadModalProps) => React.JSX.Element;
+declare const IpadModal: (props: IpadModalProps) => JSX.Element;
 export default IpadModal;

package/es/components/pisellModal/components/PcModal/index.d.ts

@@ -26,5 +26,5 @@ export interface PcModalProps extends ModalProps {
     /** header是否展示 */
     header?: boolean | null;
 }
-declare const PcModal: (props: PcModalProps) => React.JSX.Element;
+declare const PcModal: (props: PcModalProps) => JSX.Element;
 export default PcModal;

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

@@ -3,8 +3,8 @@ import IpadModal from './IpadModal';
 import MobileModal from './MobileModal';
 import PcModal from './PcModal';
 declare const platformCpt: {
-    h5: (props: import("./MobileModal").MobileModalProps) => import("react").JSX.Element;
-    pc: (props: import("./PcModal").PcModalProps) => import("react").JSX.Element;
-    ipad: (props: import("./IpadModal").IpadModalProps) => import("react").JSX.Element;
+    h5: (props: import("./MobileModal").MobileModalProps) => JSX.Element;
+    pc: (props: import("./PcModal").PcModalProps) => JSX.Element;
+    ipad: (props: import("./IpadModal").IpadModalProps) => JSX.Element;
 };
 export { IpadModal, MobileModal, PcModal, platformCpt };

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/pisellRecordBoard/PisellRecordBoard.d.ts

@@ -2,7 +2,8 @@ import React from 'react';
 import type { RecordBoardProps } from './types';
 /**
  * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
- * 仅接受打散 props：列表/分页/搜索/多选/列显隐、以及 grid/toolBar/search/paginationConfig/batchActionBar/cardList。
+ * 打散 props：列表/分页/搜索/多选、grid/toolBar/…；可选根级 **floorMap**（兼容透传）。
+ * 平面图推荐在 ShellFrame 内使用 **PisellRecordBoard.FloorMap** 声明，与根级 `floorMap` 合并（子优先）。
  */
 declare const PisellRecordBoard: React.FC<RecordBoardProps>;
 export default PisellRecordBoard;

package/es/components/pisellRecordBoard/PisellRecordBoard.js

@@ -1,4 +1,4 @@
-var _excluded = ["children", "layoutType", "rowKey", "data", "loading", "total", "pagination", "onPageChange", "searchParams", "onSearch", "onReset"];
+var _excluded = ["children", "layoutType", "rowKey", "data", "dataSources", "gridDataSourceKey", "loading", "total", "pagination", "onPageChange", "searchParams", "onSearch", "onReset", "floorMap", "floorMapLayoutContext", "defaultBodyView", "className", "style"];
 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."); }
@@ -69,13 +69,21 @@ function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
     scrollAreaHeight: null,
     setScrollAreaHeight: undefined,
     filterResetKey: undefined,
-    setFilterResetKey: undefined
+    setFilterResetKey: undefined,
+    bodyView: 'grid',
+    setBodyView: function setBodyView() {},
+    floorMapProps: undefined,
+    floorMapLayoutContext: undefined,
+    defaultBodyView: undefined,
+    dataSources: undefined,
+    gridDataSourceKey: undefined
   };
 }
 
 /**
  * RecordBoard 容器：提供统一的 data / pagination / search 上下文。
- * 仅接受打散 props：列表/分页/搜索/多选/列显隐、以及 grid/toolBar/search/paginationConfig/batchActionBar/cardList。
+ * 打散 props：列表/分页/搜索/多选、grid/toolBar/…；可选根级 **floorMap**（兼容透传）。
+ * 平面图推荐在 ShellFrame 内使用 **PisellRecordBoard.FloorMap** 声明，与根级 `floorMap` 合并（子优先）。
  */
 var PisellRecordBoard = function PisellRecordBoard(props) {
   var _props$columnVisibili;
@@ -84,6 +92,8 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     layoutType = _props$layoutType === void 0 ? 'grid' : _props$layoutType,
     rowKeyProp = props.rowKey,
     dataProp = props.data,
+    dataSourcesProp = props.dataSources,
+    gridDataSourceKeyProp = props.gridDataSourceKey,
     loadingProp = props.loading,
     totalProp = props.total,
     paginationProp = props.pagination,
@@ -91,6 +101,11 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     searchParamsProp = props.searchParams,
     onSearchProp = props.onSearch,
     onResetProp = props.onReset,
+    floorMapProp = props.floorMap,
+    floorMapLayoutContextProp = props.floorMapLayoutContext,
+    defaultBodyView = props.defaultBodyView,
+    classNameProp = props.className,
+    styleProp = props.style,
     rest = _objectWithoutProperties(props, _excluded);
 
   /** 默认占满父容器高度（父容器需有高度，如 height:100vh 或 height:100%） */
@@ -119,6 +134,12 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     filterResetKey = _useState8[0],
     setFilterResetKey = _useState8[1];
   var _useState9 = useState(function () {
+      return defaultBodyView === 'floorMap' ? 'floorMap' : 'grid';
+    }),
+    _useState10 = _slicedToArray(_useState9, 2),
+    bodyView = _useState10[0],
+    setBodyView = _useState10[1];
+  var _useState11 = 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) {
@@ -146,10 +167,10 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       }
       return defaultVis;
     }),
-    _useState10 = _slicedToArray(_useState9, 2),
-    internalColumnVisibility = _useState10[0],
-    setInternalColumnVisibility = _useState10[1];
-  var _useState11 = useState(function () {
+    _useState12 = _slicedToArray(_useState11, 2),
+    internalColumnVisibility = _useState12[0],
+    setInternalColumnVisibility = _useState12[1];
+  var _useState13 = useState(function () {
       if (typeof columnVisibilityStorageKey === 'string' && columnVisibilityStorageKey && typeof getRecordBoardColumnSettingFromLocal === 'function') {
         var _saved$columnOrder;
         var saved = getRecordBoardColumnSettingFromLocal(columnVisibilityStorageKey);
@@ -157,9 +178,9 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       }
       return null;
     }),
-    _useState12 = _slicedToArray(_useState11, 2),
-    internalColumnOrder = _useState12[0],
-    setInternalColumnOrder = _useState12[1];
+    _useState14 = _slicedToArray(_useState13, 2),
+    internalColumnOrder = _useState14[0],
+    setInternalColumnOrder = _useState14[1];
   useEffect(function () {
     if (typeof columnVisibilityStorageKey !== 'string' || !columnVisibilityStorageKey) return;
     saveColumnVisibilityToLocal({
@@ -187,10 +208,34 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       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;
+
+    /**
+     * 表格数据：
+     * - 显式传入 `data` 时始终用 `data`（如服务端分页当前页）；
+     * - 否则若存在 `dataSources` + `gridDataSourceKey`，从对应数组做客户端分页切片。
+     */
+    var data;
+    var total;
+    if (dataProp !== undefined) {
+      data = dataProp;
+      total = totalProp !== undefined ? totalProp : defaultCtx.total;
+    } else if (dataSourcesProp != null && gridDataSourceKeyProp != null && gridDataSourceKeyProp !== '') {
+      var _dataSourcesProp$grid;
+      var raw = (_dataSourcesProp$grid = dataSourcesProp[gridDataSourceKeyProp]) !== null && _dataSourcesProp$grid !== void 0 ? _dataSourcesProp$grid : [];
+      total = totalProp !== undefined ? totalProp : raw.length;
+      var pageNumber = pagination.pageNumber,
+        pageSize = pagination.pageSize;
+      var safeSize = Math.max(1, pageSize);
+      var start = Math.max(0, (pageNumber - 1) * safeSize);
+      data = raw.slice(start, start + safeSize);
+    } else {
+      data = defaultCtx.data;
+      total = totalProp !== undefined ? totalProp : defaultCtx.total;
+    }
+    var loading = loadingProp !== undefined ? loadingProp : defaultCtx.loading;
     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;
@@ -204,6 +249,8 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
     return _objectSpread(_objectSpread({}, defaultCtx), {}, {
       layoutType: layoutType,
       rowKey: rowKey,
+      dataSources: dataSourcesProp,
+      gridDataSourceKey: gridDataSourceKeyProp,
       data: data,
       loading: loading,
       total: total,
@@ -224,20 +271,25 @@ var PisellRecordBoard = function PisellRecordBoard(props) {
       scrollAreaHeight: scrollAreaHeight,
       setScrollAreaHeight: setScrollAreaHeight,
       filterResetKey: filterResetKey,
-      setFilterResetKey: setFilterResetKey
+      setFilterResetKey: setFilterResetKey,
+      bodyView: bodyView,
+      setBodyView: setBodyView,
+      floorMapProps: floorMapProp,
+      floorMapLayoutContext: floorMapLayoutContextProp,
+      defaultBodyView: defaultBodyView
     });
-  }, [layoutType, rowKeyProp, dataProp, loadingProp, totalProp, paginationProp, onPageChangeProp, searchParamsProp, onSearchProp, onResetProp, mergedChildComponentProps, internalSelectedKeys, internalSelectedRows, onSelectionChangeInternal, internalColumnVisibility, onColumnVisibilityChangeInternal, internalColumnOrder, onColumnOrderChangeInternal, fillHeight, scrollAreaHeight, filterResetKey]);
+  }, [layoutType, rowKeyProp, dataProp, dataSourcesProp, gridDataSourceKeyProp, loadingProp, totalProp, paginationProp, onPageChangeProp, searchParamsProp, onSearchProp, onResetProp, mergedChildComponentProps, internalSelectedKeys, internalSelectedRows, onSelectionChangeInternal, internalColumnVisibility, onColumnVisibilityChangeInternal, internalColumnOrder, onColumnOrderChangeInternal, fillHeight, scrollAreaHeight, filterResetKey, floorMapProp, floorMapLayoutContextProp, defaultBodyView, bodyView]);
   var content = /*#__PURE__*/React.createElement(RecordBoardProvider, {
     value: contextValue
   }, children);
   return /*#__PURE__*/React.createElement("div", {
-    className: "pisell-record-board-root",
-    style: {
+    className: classNameProp ? "pisell-record-board-root ".concat(classNameProp) : 'pisell-record-board-root',
+    style: _objectSpread({
       height: '100%',
       display: 'flex',
       flexDirection: 'column',
       minHeight: 0
-    }
+    }, styleProp)
   }, content);
 };
 export default PisellRecordBoard;

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

@@ -3,6 +3,10 @@ import PisellRecordBoard from './index';
 declare const meta: Meta<typeof PisellRecordBoard>;
 export default meta;
 declare type Story = StoryObj<typeof PisellRecordBoard>;
+/**
+ * **默认 Story**：餐厅 **多数据源**——**餐桌** + **蘸料摆台**；根级 `dataSources` 同时包含两者；**表格只绑定餐桌一路**（`gridDataSourceKey`）；平面图同时渲染两类落位，无需 Segmented 切换列表。
+ */
+export declare const Default: Story;
 /**
  * Grid 布局 - 带 Table、分页、多选；列 type 驱动列/筛选/排序；筛选在 Filter 弹层内；重置清空筛选与排序。
  */