@pisell/materials 6.11.17 → 6.11.18

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.js

@@ -0,0 +1,175 @@
+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); }
+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 _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 _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 _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; }
+import React, { useCallback, useMemo } from 'react';
+import classNames from 'classnames';
+import { Row } from "./components";
+import { useExpandedKeys } from "./hooks";
+import "./PisellHierarchicalSummaryList.less";
+
+/** 根节点类名，供上层用同一 DOM 包裹列表与其它区块时使用 */
+export var PREFIX_CLS = 'pisell-hierarchical-summary-list';
+function normalizeItems(items) {
+  return items.filter(function (i) {
+    return !i.hidden;
+  }).slice().sort(function (a, b) {
+    var _a$order, _b$order;
+    return ((_a$order = a.order) !== null && _a$order !== void 0 ? _a$order : 0) - ((_b$order = b.order) !== null && _b$order !== void 0 ? _b$order : 0);
+  });
+}
+function walkForDefaultExpandedKeys(options) {
+  var items = options.items,
+    defaultExpandedLevel = options.defaultExpandedLevel,
+    getKey = options.getKey;
+  if (!defaultExpandedLevel || defaultExpandedLevel <= 0) return [];
+  var keys = [];
+  var dfs = function dfs(list, level, parentPathKeys) {
+    if (level > defaultExpandedLevel) return;
+    var normalized = normalizeItems(list);
+    normalized.forEach(function (item, index) {
+      var _item$key, _item$children;
+      var key = (_item$key = item.key) !== null && _item$key !== void 0 ? _item$key : getKey(item, {
+        level: level,
+        index: index,
+        parentPathKeys: parentPathKeys
+      });
+      var children = normalizeItems((_item$children = item.children) !== null && _item$children !== void 0 ? _item$children : []);
+      var hasChildren = children.length > 0;
+      var canExpandThisLevel = level < defaultExpandedLevel;
+      if (hasChildren && canExpandThisLevel) {
+        keys.push(key);
+        dfs(children, level + 1, [].concat(_toConsumableArray(parentPathKeys), [key]));
+      }
+    });
+  };
+  dfs(items, 1, []);
+  return keys;
+}
+export var PisellHierarchicalSummaryList = /*#__PURE__*/React.memo(function (_ref) {
+  var items = _ref.items,
+    expandedKeys = _ref.expandedKeys,
+    defaultExpandedKeys = _ref.defaultExpandedKeys,
+    _ref$defaultExpandedL = _ref.defaultExpandedLevel,
+    defaultExpandedLevel = _ref$defaultExpandedL === void 0 ? 0 : _ref$defaultExpandedL,
+    onExpandedKeysChange = _ref.onExpandedKeysChange,
+    _ref$accordion = _ref.accordion,
+    accordion = _ref$accordion === void 0 ? false : _ref$accordion,
+    maxRenderLevel = _ref.maxRenderLevel,
+    maxExpandLevel = _ref.maxExpandLevel,
+    _ref$indent = _ref.indent,
+    indent = _ref$indent === void 0 ? 16 : _ref$indent,
+    _ref$rowGap = _ref.rowGap,
+    rowGap = _ref$rowGap === void 0 ? 8 : _ref$rowGap,
+    padding = _ref.padding,
+    gaps = _ref.gaps,
+    levelConfig = _ref.levelConfig,
+    renderLabel = _ref.renderLabel,
+    renderValue = _ref.renderValue,
+    getKeyProp = _ref.getKey,
+    aggregate = _ref.aggregate,
+    className = _ref.className,
+    style = _ref.style,
+    _ref$renderRoot = _ref.renderRoot,
+    renderRoot = _ref$renderRoot === void 0 ? true : _ref$renderRoot;
+  var rootStyle = useMemo(function () {
+    return _objectSpread(_objectSpread({}, style), padding !== undefined ? {
+      padding: typeof padding === 'number' ? "".concat(padding, "px") : padding
+    } : {});
+  }, [padding, style]);
+  var getKey = useCallback(function (item, ctx) {
+    if (item.key !== undefined && item.key !== null) return item.key;
+    if (getKeyProp) return getKeyProp(item, ctx);
+    var parent = ctx.parentPathKeys.map(String).join('/');
+    return "lvl".concat(ctx.level, ":").concat(parent ? "".concat(parent, "/") : '').concat(ctx.index);
+  }, [getKeyProp]);
+  var computedDefaultExpandedKeys = useMemo(function () {
+    return walkForDefaultExpandedKeys({
+      items: items,
+      defaultExpandedLevel: defaultExpandedLevel,
+      getKey: getKey
+    });
+  }, [defaultExpandedLevel, getKey, items]);
+  var mergedDefaultExpandedKeys = useMemo(function () {
+    var merged = new Set();
+    (defaultExpandedKeys !== null && defaultExpandedKeys !== void 0 ? defaultExpandedKeys : []).forEach(function (k) {
+      return merged.add(k);
+    });
+    computedDefaultExpandedKeys.forEach(function (k) {
+      return merged.add(k);
+    });
+    return Array.from(merged);
+  }, [computedDefaultExpandedKeys, defaultExpandedKeys]);
+  var expandedController = useExpandedKeys({
+    expandedKeys: expandedKeys,
+    defaultExpandedKeys: mergedDefaultExpandedKeys,
+    onExpandedKeysChange: onExpandedKeysChange
+  });
+  var normalizedRootItems = useMemo(function () {
+    return normalizeItems(items);
+  }, [items]);
+  var toggleExpanded = useCallback(function (key, options) {
+    var _options$siblingKeys;
+    var prev = expandedController.expandedKeys;
+    var set = new Set(prev);
+    var isExpanded = set.has(key);
+    if (isExpanded) {
+      set.delete(key);
+      expandedController.setExpandedKeys(Array.from(set));
+      return;
+    }
+    if (accordion && options !== null && options !== void 0 && (_options$siblingKeys = options.siblingKeys) !== null && _options$siblingKeys !== void 0 && _options$siblingKeys.length) {
+      options.siblingKeys.forEach(function (k) {
+        return set.delete(k);
+      });
+    }
+    set.add(key);
+    expandedController.setExpandedKeys(Array.from(set));
+  }, [accordion, expandedController]);
+  var rowsContent = normalizedRootItems.map(function (item, index) {
+    var _item$key2;
+    var rootLevel = index === 0 ? 1 : 2;
+    return /*#__PURE__*/React.createElement(Row, {
+      key: (_item$key2 = item.key) !== null && _item$key2 !== void 0 ? _item$key2 : getKey(item, {
+        level: rootLevel,
+        index: index,
+        parentPathKeys: []
+      }),
+      prefixCls: PREFIX_CLS,
+      item: item,
+      level: rootLevel,
+      index: index,
+      parentPathKeys: [],
+      expandedKeySet: expandedController.expandedKeySet,
+      toggleExpanded: toggleExpanded,
+      getKey: getKey,
+      levelConfig: levelConfig,
+      indent: indent,
+      rowGap: rowGap,
+      gaps: gaps,
+      maxRenderLevel: maxRenderLevel,
+      maxExpandLevel: maxExpandLevel,
+      aggregate: aggregate,
+      renderLabel: renderLabel,
+      renderValue: renderValue
+    });
+  });
+  if (renderRoot === false) {
+    return /*#__PURE__*/React.createElement("div", {
+      style: rootStyle
+    }, rowsContent);
+  }
+  return /*#__PURE__*/React.createElement("div", {
+    className: classNames(PREFIX_CLS, className),
+    style: rootStyle
+  }, rowsContent);
+});
+PisellHierarchicalSummaryList.displayName = 'PisellHierarchicalSummaryList';

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.less

@@ -0,0 +1,129 @@
+/**
+ * PisellHierarchicalSummaryList 组件样式
+ * 布局与结构在此定义；行内文案/颜色/字重等可由 levelConfig（labelTextStyle / valueTextStyle / metaTextStyle）
+ * 通过 Row 内联样式覆盖，便于上层 1:1 复刻设计稿。
+ */
+
+@prefix: pisell-hierarchical-summary-list;
+
+.@{prefix} {
+  width: 100%;
+  background: #fff;
+  padding: 20px;
+
+  /* 标题栏（L1/L2）上下 20px，展开后下边距 16px，由 Row 内联 style 控制 */
+
+  &-node {
+    &:first-child {
+      margin-top: 0 !important;
+    }
+  }
+
+  &-row {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 8px;
+    width: 100%;
+  }
+
+  &-row-expandable {
+    cursor: pointer;
+  }
+
+  &-row-left {
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    min-width: 0;
+    flex: 1;
+  }
+
+  /* 默认样式，可由 levelConfig.labelTextStyle 覆盖；flex: 0 0 auto 使 itemsCount 紧挨标题左侧而非靠右 */
+
+  &-row-label {
+    flex: 0 0 auto;
+    min-width: 0;
+    color: #1b1b1b;
+    font-size: 16px;
+    line-height: 24px;
+    font-weight: 700;
+    white-space: normal;
+    word-break: break-word;
+  }
+
+  &-row-meta {
+    display: inline-flex;
+    align-items: center;
+    gap: 4px;
+    flex-shrink: 0;
+  }
+
+  /* 默认样式，可由 levelConfig.metaTextStyle 覆盖；itemsCount 等 meta 文案颜色 #667085 */
+
+  &-row-dot,
+  &-row-items-count,
+  &-row-info {
+    color: #667085;
+    font-size: 16px;
+    line-height: 24px;
+  }
+
+  &-row-items-count {
+    font-weight: 400;
+    white-space: nowrap;
+  }
+
+  /* 子项列表左侧圆点（level 3+），颜色与 meta 一致 */
+
+  &-row-bullet {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    flex-shrink: 0;
+    line-height: 24px;
+  }
+
+  &-row-info {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    line-height: 1;
+  }
+
+  &-row-right {
+    display: inline-flex;
+    align-items: center;
+    justify-content: flex-end;
+    gap: 6px;
+    flex-shrink: 0;
+    white-space: nowrap;
+  }
+
+  /* 默认样式，可由 levelConfig.valueTextStyle 覆盖 */
+
+  &-row-value {
+    color: #1b1b1b;
+    font-size: 16px;
+    line-height: 24px;
+    font-weight: 700;
+  }
+
+  &-row-extra {
+    display: inline-flex;
+    align-items: center;
+  }
+
+  &-row-expand-icon {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    width: 24px;
+    height: 24px;
+  }
+
+  &-children {
+    width: 100%;
+  }
+}
+

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.stories.d.ts

@@ -0,0 +1,10 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellHierarchicalSummaryList } from './PisellHierarchicalSummaryList';
+declare const meta: Meta<typeof PisellHierarchicalSummaryList>;
+export default meta;
+declare type Story = StoryObj<typeof PisellHierarchicalSummaryList>;
+export declare const Default: Story;
+export declare const Accordion: Story;
+export declare const MaxExpandLevel: Story;
+export declare const AggregateSum: Story;
+export declare const FullFeatured: Story;

package/es/components/pisellHierarchicalSummaryList/PisellHierarchicalSummaryList.stories.js

@@ -0,0 +1,237 @@
+import React from 'react';
+import { PisellHierarchicalSummaryList } from "./PisellHierarchicalSummaryList";
+var demoItems = [{
+  key: 'l1',
+  label: 'Label',
+  value: /*#__PURE__*/React.createElement("span", {
+    style: {
+      color: '#1570EF'
+    }
+  }, "Value"),
+  children: [{
+    key: 'l2',
+    label: 'Label',
+    value: 'Value',
+    children: [{
+      key: 'l3-1',
+      label: 'Label',
+      itemsCount: 'N items',
+      value: 'Value'
+    }, {
+      key: 'l3-2',
+      label: 'Label',
+      infoTooltip: 'Tooltip',
+      value: 'Value'
+    }, {
+      key: 'l3-3',
+      label: 'Label',
+      value: 'Value'
+    }, {
+      key: 'l3-4',
+      label: 'Label',
+      itemsCount: '2 items',
+      value: 'Value',
+      children: [{
+        key: 'l4-1',
+        label: /*#__PURE__*/React.createElement("span", {
+          style: {
+            color: '#667085'
+          }
+        }, "\u2022 Label"),
+        value: /*#__PURE__*/React.createElement("span", {
+          style: {
+            color: '#667085'
+          }
+        }, "Value")
+      }, {
+        key: 'l4-2',
+        label: /*#__PURE__*/React.createElement("span", {
+          style: {
+            color: '#667085'
+          }
+        }, "\u2022 Label"),
+        value: /*#__PURE__*/React.createElement("span", {
+          style: {
+            color: '#667085'
+          }
+        }, "Value")
+      }]
+    }]
+  }]
+}];
+var meta = {
+  title: 'Data Display/PisellHierarchicalSummaryList',
+  component: PisellHierarchicalSummaryList,
+  tags: ['autodocs'],
+  argTypes: {
+    defaultExpandedLevel: {
+      control: 'number',
+      description: '默认展开层级（非受控初始化）'
+    },
+    accordion: {
+      control: 'boolean',
+      description: '手风琴模式（同级仅一个展开）'
+    },
+    maxRenderLevel: {
+      control: 'number',
+      description: '最大渲染层级'
+    },
+    maxExpandLevel: {
+      control: 'number',
+      description: '最大可展开层级'
+    },
+    indent: {
+      control: 'number',
+      description: '缩进（px）'
+    },
+    rowGap: {
+      control: 'number',
+      description: '行间距（px）'
+    }
+  }
+};
+export default meta;
+export var Default = {
+  args: {
+    items: demoItems,
+    defaultExpandedLevel: 2
+  }
+};
+export var Accordion = {
+  args: {
+    items: demoItems,
+    defaultExpandedLevel: 3,
+    accordion: true
+  }
+};
+export var MaxExpandLevel = {
+  args: {
+    items: demoItems,
+    defaultExpandedLevel: 5,
+    maxExpandLevel: 2
+  }
+};
+export var AggregateSum = {
+  args: {
+    items: [{
+      key: 'sum-root',
+      label: 'Total',
+      children: [{
+        key: 'a',
+        label: 'A',
+        value: 10
+      }, {
+        key: 'b',
+        label: 'B',
+        value: 20
+      }, {
+        key: 'c',
+        label: 'C',
+        value: 5,
+        children: [{
+          key: 'c-1',
+          label: 'C-1',
+          value: 2
+        }]
+      }]
+    }],
+    defaultExpandedLevel: 2,
+    aggregate: {
+      mode: 'sum',
+      format: function format(sum) {
+        return "$".concat(sum);
+      }
+    }
+  }
+};
+export var FullFeatured = {
+  args: {
+    items: demoItems,
+    defaultExpandedLevel: 3,
+    accordion: false,
+    maxRenderLevel: 4,
+    maxExpandLevel: 3,
+    indent: 16,
+    rowGap: 8,
+    levelConfig: {
+      1: {
+        rowStyle: {
+          background: '#F5F5F5',
+          padding: '8px 12px',
+          borderRadius: 8
+        },
+        labelTextStyle: {
+          fontWeight: 700
+        },
+        valueTextStyle: {
+          color: '#1570EF',
+          fontWeight: 700
+        }
+      },
+      2: {
+        rowStyle: {
+          padding: '4px 8px'
+        },
+        labelTextStyle: {
+          fontWeight: 600
+        },
+        showDotSeparator: true
+      },
+      3: {
+        rowStyle: {
+          padding: '2px 8px'
+        },
+        labelTextStyle: {
+          color: '#1B1B1B',
+          fontWeight: 500
+        },
+        valueTextStyle: {
+          color: '#1B1B1B',
+          fontWeight: 500
+        }
+      },
+      4: {
+        rowStyle: {
+          paddingLeft: 0
+        },
+        labelTextStyle: {
+          color: '#667085',
+          fontWeight: 400
+        },
+        valueTextStyle: {
+          color: '#667085',
+          fontWeight: 400
+        }
+      }
+    },
+    aggregate: {
+      mode: 'sum',
+      getNumberValue: function getNumberValue(item) {
+        if (typeof item.value === 'number') return item.value;
+        return null;
+      },
+      format: function format(sum, _ref) {
+        var level = _ref.level;
+        return level === 1 ? "Total $".concat(sum) : "$".concat(sum);
+      }
+    },
+    renderLabel: function renderLabel(item, ctx) {
+      if (ctx.level === 1) {
+        return /*#__PURE__*/React.createElement("span", null, item.label, ' ', item.itemsCount ? /*#__PURE__*/React.createElement("span", {
+          style: {
+            color: '#667085',
+            marginLeft: 4
+          }
+        }, item.itemsCount) : null);
+      }
+      return item.label;
+    },
+    renderValue: function renderValue(item, ctx) {
+      var _item$value;
+      if (ctx.aggregatedValue !== undefined) {
+        return ctx.aggregatedValue;
+      }
+      return (_item$value = item.value) !== null && _item$value !== void 0 ? _item$value : '—';
+    }
+  }
+};

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

@@ -0,0 +1,35 @@
+import React from 'react';
+import type { PisellHierarchicalSummaryListAggregateConfig, PisellHierarchicalSummaryListItem, PisellHierarchicalSummaryListKey, PisellHierarchicalSummaryListLevelConfig, PisellHierarchicalSummaryListRenderContext } from '../types';
+export interface RowProps {
+    prefixCls: string;
+    item: PisellHierarchicalSummaryListItem;
+    level: number;
+    index: number;
+    parentPathKeys: PisellHierarchicalSummaryListKey[];
+    expandedKeySet: ReadonlySet<PisellHierarchicalSummaryListKey>;
+    toggleExpanded: (key: PisellHierarchicalSummaryListKey, options?: {
+        siblingKeys?: PisellHierarchicalSummaryListKey[];
+    }) => void;
+    getKey: (item: PisellHierarchicalSummaryListItem, ctx: {
+        level: number;
+        index: number;
+        parentPathKeys: PisellHierarchicalSummaryListKey[];
+    }) => PisellHierarchicalSummaryListKey;
+    levelConfig?: Record<number, PisellHierarchicalSummaryListLevelConfig>;
+    indent: number;
+    rowGap: number;
+    gaps?: {
+        row?: number;
+        rowLeft?: number;
+        meta?: number;
+        rowRight?: number;
+    };
+    maxRenderLevel?: number;
+    maxExpandLevel?: number;
+    aggregate?: PisellHierarchicalSummaryListAggregateConfig;
+    renderLabel?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    renderValue?: (item: PisellHierarchicalSummaryListItem, ctx: PisellHierarchicalSummaryListRenderContext) => React.ReactNode;
+    /** 父行是否带有 itemsCount（仅此类子项显示圆点 + #667085，其他保持黑色） */
+    parentHasItemsCount?: boolean;
+}
+export declare const Row: React.FC<RowProps>;