@pisell/materials 1.0.1059 → 1.0.1062

package/lib/components/pisellHierarchicalSummaryList/hooks/useExpandedKeys.js

@@ -0,0 +1,51 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellHierarchicalSummaryList/hooks/useExpandedKeys.ts
+var useExpandedKeys_exports = {};
+__export(useExpandedKeys_exports, {
+  useExpandedKeys: () => useExpandedKeys
+});
+module.exports = __toCommonJS(useExpandedKeys_exports);
+var import_react = require("react");
+function useExpandedKeys(options) {
+  const { expandedKeys, defaultExpandedKeys, onExpandedKeysChange } = options;
+  const [inner, setInner] = (0, import_react.useState)(
+    defaultExpandedKeys ?? []
+  );
+  const merged = expandedKeys ?? inner;
+  const setExpandedKeys = (0, import_react.useCallback)(
+    (next) => {
+      onExpandedKeysChange == null ? void 0 : onExpandedKeysChange(next);
+      if (expandedKeys === void 0) {
+        setInner(next);
+      }
+    },
+    [expandedKeys, onExpandedKeysChange]
+  );
+  const expandedKeySet = (0, import_react.useMemo)(() => new Set(merged), [merged]);
+  return {
+    expandedKeys: merged,
+    expandedKeySet,
+    setExpandedKeys
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useExpandedKeys
+});

package/lib/components/pisellHierarchicalSummaryList/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * PisellHierarchicalSummaryList 组件导出
+ */
+export { PisellHierarchicalSummaryList, PREFIX_CLS as HIERARCHICAL_SUMMARY_LIST_PREFIX_CLS, } from './PisellHierarchicalSummaryList';
+export type * from './types';

package/lib/components/pisellHierarchicalSummaryList/index.js

@@ -0,0 +1,31 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellHierarchicalSummaryList/index.tsx
+var pisellHierarchicalSummaryList_exports = {};
+__export(pisellHierarchicalSummaryList_exports, {
+  HIERARCHICAL_SUMMARY_LIST_PREFIX_CLS: () => import_PisellHierarchicalSummaryList.PREFIX_CLS,
+  PisellHierarchicalSummaryList: () => import_PisellHierarchicalSummaryList.PisellHierarchicalSummaryList
+});
+module.exports = __toCommonJS(pisellHierarchicalSummaryList_exports);
+var import_PisellHierarchicalSummaryList = require("./PisellHierarchicalSummaryList");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HIERARCHICAL_SUMMARY_LIST_PREFIX_CLS,
+  PisellHierarchicalSummaryList
+});

package/lib/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/lib/components/pisellHierarchicalSummaryList/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/pisellHierarchicalSummaryList/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/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/lib/components/pisellRecordBoard/PisellRecordBoard.js

@@ -37,6 +37,15 @@ var import_utils = require("@pisell/utils");
 var import_RecordBoardProvider = require("./context/RecordBoardProvider");
 var import_recordBoardColumns = require("./utils/recordBoardColumns");
 var defaultPagination = { pageNumber: 1, pageSize: 50 };
+function readBodyViewFromStorage(key, fallback) {
+  if (typeof window === "undefined" || !key) return fallback;
+  try {
+    const raw = localStorage.getItem(key);
+    if (raw === "grid" || raw === "floorMap") return raw;
+  } catch {
+  }
+  return fallback;
+}
 function mergeChildComponentProps(props) {
   const hasAny = props.grid != null || props.toolBar != null || props.search != null || props.paginationConfig != null || props.batchActionBar != null || props.cardList != null;
   if (!hasAny) return void 0;
@@ -75,7 +84,16 @@ function getDefaultRecordBoardContext(layoutType, selection, rowKey) {
     scrollAreaHeight: null,
     setScrollAreaHeight: void 0,
     filterResetKey: void 0,
-    setFilterResetKey: void 0
+    setFilterResetKey: void 0,
+    bodyView: "grid",
+    setBodyView: () => {
+    },
+    floorMapProps: void 0,
+    floorMapLayoutContext: void 0,
+    defaultBodyView: void 0,
+    floorMapLayoutRef: void 0,
+    dataSources: void 0,
+    gridDataSourceKey: void 0
   };
 }
 var PisellRecordBoard = (props) => {
@@ -84,6 +102,8 @@ var PisellRecordBoard = (props) => {
     layoutType = "grid",
     rowKey: rowKeyProp,
     data: dataProp,
+    dataSources: dataSourcesProp,
+    gridDataSourceKey: gridDataSourceKeyProp,
     loading: loadingProp,
     total: totalProp,
     pagination: paginationProp,
@@ -91,6 +111,13 @@ var PisellRecordBoard = (props) => {
     searchParams: searchParamsProp,
     onSearch: onSearchProp,
     onReset: onResetProp,
+    floorMap: floorMapProp,
+    floorMapLayoutContext: floorMapLayoutContextProp,
+    defaultBodyView,
+    bodyViewStorageKey,
+    floorMapLayoutRef,
+    className: classNameProp,
+    style: styleProp,
     ...rest
   } = props;
   const fillHeight = true;
@@ -112,6 +139,22 @@ var PisellRecordBoard = (props) => {
   const [internalSelectedRows, setInternalSelectedRows] = (0, import_react.useState)([]);
   const [scrollAreaHeight, setScrollAreaHeight] = (0, import_react.useState)(null);
   const [filterResetKey, setFilterResetKey] = (0, import_react.useState)(0);
+  const [bodyView, setBodyViewState] = (0, import_react.useState)(() => {
+    const fallback = defaultBodyView === "floorMap" ? "floorMap" : "grid";
+    return readBodyViewFromStorage(bodyViewStorageKey, fallback);
+  });
+  const setBodyView = (0, import_react.useCallback)(
+    (v) => {
+      setBodyViewState(v);
+      if (typeof window !== "undefined" && bodyViewStorageKey) {
+        try {
+          localStorage.setItem(bodyViewStorageKey, v);
+        } catch {
+        }
+      }
+    },
+    [bodyViewStorageKey]
+  );
   const [internalColumnVisibility, setInternalColumnVisibility] = (0, import_react.useState)(() => {
     var _a, _b;
     const fromConfig = ((_a = props.grid) == null ? void 0 : _a.defaultHiddenColumnKeys) ?? [];
@@ -182,10 +225,24 @@ var PisellRecordBoard = (props) => {
       },
       rowKeyProp
     );
-    const data = dataProp !== void 0 ? dataProp : defaultCtx.data;
-    const loading = loadingProp !== void 0 ? loadingProp : defaultCtx.loading;
-    const total = totalProp !== void 0 ? totalProp : defaultCtx.total;
     const pagination = paginationProp !== void 0 ? paginationProp : defaultCtx.pagination;
+    let data;
+    let total;
+    if (dataProp !== void 0) {
+      data = dataProp;
+      total = totalProp !== void 0 ? totalProp : defaultCtx.total;
+    } else if (dataSourcesProp != null && gridDataSourceKeyProp != null && gridDataSourceKeyProp !== "") {
+      const raw = dataSourcesProp[gridDataSourceKeyProp] ?? [];
+      total = totalProp !== void 0 ? totalProp : raw.length;
+      const { pageNumber, pageSize } = pagination;
+      const safeSize = Math.max(1, pageSize);
+      const start = Math.max(0, (pageNumber - 1) * safeSize);
+      data = raw.slice(start, start + safeSize);
+    } else {
+      data = defaultCtx.data;
+      total = totalProp !== void 0 ? totalProp : defaultCtx.total;
+    }
+    const loading = loadingProp !== void 0 ? loadingProp : defaultCtx.loading;
     const onPageChange = onPageChangeProp ?? defaultCtx.onPageChange;
     const searchParams = searchParamsProp !== void 0 ? searchParamsProp : defaultCtx.searchParams;
     const onSearch = onSearchProp ?? defaultCtx.onSearch;
@@ -200,6 +257,8 @@ var PisellRecordBoard = (props) => {
       ...defaultCtx,
       layoutType,
       rowKey,
+      dataSources: dataSourcesProp,
+      gridDataSourceKey: gridDataSourceKeyProp,
       data,
       loading,
       total,
@@ -220,12 +279,20 @@ var PisellRecordBoard = (props) => {
       scrollAreaHeight,
       setScrollAreaHeight,
       filterResetKey,
-      setFilterResetKey
+      setFilterResetKey,
+      bodyView,
+      setBodyView,
+      floorMapProps: floorMapProp,
+      floorMapLayoutContext: floorMapLayoutContextProp,
+      defaultBodyView,
+      floorMapLayoutRef
     };
   }, [
     layoutType,
     rowKeyProp,
     dataProp,
+    dataSourcesProp,
+    gridDataSourceKeyProp,
     loadingProp,
     totalProp,
     paginationProp,
@@ -243,18 +310,25 @@ var PisellRecordBoard = (props) => {
     onColumnOrderChangeInternal,
     fillHeight,
     scrollAreaHeight,
-    filterResetKey
+    filterResetKey,
+    floorMapProp,
+    floorMapLayoutContextProp,
+    defaultBodyView,
+    floorMapLayoutRef,
+    bodyView,
+    setBodyView
   ]);
   const content = /* @__PURE__ */ import_react.default.createElement(import_RecordBoardProvider.RecordBoardProvider, { value: contextValue }, children);
   return /* @__PURE__ */ import_react.default.createElement(
     "div",
     {
-      className: "pisell-record-board-root",
+      className: classNameProp ? `pisell-record-board-root ${classNameProp}` : "pisell-record-board-root",
       style: {
         height: "100%",
         display: "flex",
         flexDirection: "column",
-        minHeight: 0
+        minHeight: 0,
+        ...styleProp
       }
     },
     content

package/lib/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 弹层内；重置清空筛选与排序。
  */