@pisell/materials 1.8.23 → 1.8.25

package/es/components/pisellFloorMapLayout/utils/floorMapElementKindUtils.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
+ */
+import type { FloorMapElementKindConfig, FloorMapViewConfig, FloorMapSceneElement, FloorMapDataSources, FloorMapElementDataBindingPolicy } from '../types';
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export declare function isFloorMapImageElementKind(kind: string | undefined): boolean;
+/** dataBindingPolicy 缺省视为 none */
+export declare function resolveDataBindingPolicy(kind: FloorMapElementKindConfig | undefined): FloorMapElementDataBindingPolicy;
+export declare function getElementKindConfig(config: Pick<FloorMapViewConfig, 'elementKinds'> | undefined, elementKind: string | undefined): FloorMapElementKindConfig | undefined;
+/**
+ * 与调色板分组一致：取与当前图元 **同一 categoryId**（含未填 categoryId 时落到首个分类）下的可切换种类，
+ * 排除舞台、底图。若仅有一种则编辑面板可不展示切换器。
+ */
+export declare function getSwappableElementKindsInSameCategory(config: FloorMapViewConfig, elementKind: string | undefined): FloorMapElementKindConfig[];
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 kind 时的草稿 patch（绑定不兼容则清空）
+ */
+export declare function patchSceneElementForKindSwitch(config: FloorMapViewConfig, element: FloorMapSceneElement, nextKindValue: string): Partial<FloorMapSceneElement>;
+/**
+ * @returns 人类可读错误文案；无问题时返回 null
+ */
+export declare function getSceneElementRenderIssue(element: FloorMapSceneElement, kind: FloorMapElementKindConfig | undefined, dataSources: FloorMapDataSources | undefined): string | null;

package/es/components/pisellFloorMapLayout/utils/floorMapElementKindUtils.js

@@ -10,6 +10,7 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  */
 
 import { FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND } from "../types";
+import { locales } from '@pisell/utils';
 import { STAGE_DECO_DEFAULT } from "./floorMapStageDefaults";
 
 /** 与 RecordBoard Story 一致：`floorMapImage` */
@@ -111,12 +112,12 @@ export function getSceneElementRenderIssue(element, kind, dataSources) {
   var policy = resolveDataBindingPolicy(kind);
   var binding = element.dataBinding;
   if (policy === 'required' && !binding) {
-    return '该图元须绑定数据源行';
+    return locales.getText('pisell-floor-map-layout.binding-error.required-row');
   }
   if (!binding) return null;
   var keys = kind === null || kind === void 0 ? void 0 : kind.allowedDataSourceKeys;
   if (keys !== null && keys !== void 0 && keys.length && !keys.includes(binding.dataSourceKey)) {
-    return "\u6570\u636E\u6E90\u300C".concat(binding.dataSourceKey, "\u300D\u4E0D\u5728\u8BE5\u56FE\u5143\u5141\u8BB8\u5217\u8868\u5185");
+    return locales.getText('pisell-floor-map-layout.binding-error.ds-not-allowed').replace(/\{key\}/g, binding.dataSourceKey);
   }
   var rows = dataSources === null || dataSources === void 0 ? void 0 : dataSources[binding.dataSourceKey];
   var rid = binding.recordId != null ? String(binding.recordId).trim() : '';
@@ -142,7 +143,7 @@ export function getSceneElementRenderIssue(element, kind, dataSources) {
       for (_iterator.s(); !(_step = _iterator.n()).done;) {
         var f = _step.value;
         if (row[f] === undefined || row[f] === null || row[f] === '') {
-          return "\u6570\u636E\u884C\u7F3A\u5C11\u5FC5\u586B\u5B57\u6BB5\uFF1A".concat(f);
+          return locales.getText('pisell-floor-map-layout.binding-error.missing-field').replace(/\{field\}/g, f);
         }
       }
     } catch (err) {

package/es/components/pisellFloorMapLayout/utils/floorMapFallbackRender.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 无 renderItemByKind 时的占位渲染（装饰、舞台等），避免画布上不显示
+ */
+import React from 'react';
+import type { FloorMapMergedItem } from '../types';
+/**
+ * @returns 与 PisellFloorMapLayout 内联 fallback 一致的渲染函数（useCallback 由调用方包裹）
+ */
+/** 绑定校验失败或 renderItemByKind 抛错时的占位 */
+export declare function renderFloorMapRenderError(message: string): React.ReactNode;
+export declare function renderFloorMapFallbackPlaceholder(item: FloorMapMergedItem): React.ReactNode;

package/es/components/pisellFloorMapLayout/utils/floorMapStageDefaults.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 舞台/区域类装饰：落点默认尺寸与默认显示名（与 FLOOR_MAP_STAGE_ELEMENT_KIND 配套）
+ */
+export declare const STAGE_DECO_DEFAULT: {
+    readonly width: 320;
+    readonly height: 120;
+    readonly name: "舞台";
+};

package/es/components/pisellFloorMapLayout/utils/floorMapViewConfigDiff.d.ts

@@ -0,0 +1,8 @@
+import type { FloorMapViewConfig } from '../types';
+/**
+ * 与 {@link useFloorMapEditState} 中 `useEffect` 逻辑一致：补全 `canvasUi`、空 `elementKinds` 时的默认调色板、`sceneElements`。
+ * 用于从上游 prop 得到「可与当前 draft 公平比较」的基准配置。
+ */
+export declare function normalizeFloorMapViewConfigFromProp(floorMapConfigProp: FloorMapViewConfig): FloorMapViewConfig;
+/** 判断当前编辑草稿是否与基准配置一致（数组顺序无关） */
+export declare function floorMapViewConfigsEqual(a: FloorMapViewConfig, b: FloorMapViewConfig): boolean;

package/es/components/pisellFloorMapLayout/utils/layoutMeasurements.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 平面图/布局内容区尺寸计算：格子与像素单位、gap 解析、包围盒
+ */
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+/** 默认每格像素 */
+export declare const DEFAULT_CELL_SIZE = 64;
+/** 默认 item 间距（像素） */
+export declare const DEFAULT_ITEM_GAP = 8;
+/**
+ * 将 mapLayer.gap 解析为像素数
+ */
+export declare function gapToPx(gap: number | string | undefined): number;
+/**
+ * 根据 items 计算内容区像素宽高
+ * - cell：按格子数 + cellSize + itemGap 计算
+ * - pixel：按 item 的 x/y/width/height 像素取边界（仅右/下边界，用于非 floor map 或兼容）
+ */
+export declare function getContentSize<T extends FloorMapItemBase>(items: T[], cellSize: number, itemGap: number, itemUnit: FloorMapItemUnit): {
+    contentWidth: number;
+    contentHeight: number;
+};
+/**
+ * pixel 模式下取 items 包围盒（含左/上），用于画布四周扩 padding 时的尺寸与偏移
+ */
+export declare function getPixelBoundingBox<T extends FloorMapItemBase>(items: T[], cellSize: number): {
+    minLeft: number;
+    minTop: number;
+    maxRight: number;
+    maxBottom: number;
+} | null;

package/es/components/pisellFloorMapLayout/utils/mergeCanvasesForTabs.d.ts

@@ -0,0 +1,7 @@
+import type { FloorMapCanvas, FloorMapViewConfig } from '../types';
+/**
+ * 为画布 Tab 合并展示用字段：
+ * - `tabBadge` 若在配置中已给出则原样使用（含 0）；
+ * - 否则用当前 `sceneElements` 中属于该画布的数量，且仅在大于 0 时展示角标。
+ */
+export declare function mergeCanvasesForTabs(config: FloorMapViewConfig): FloorMapCanvas[];

package/es/components/pisellFloorMapLayout/utils/snap.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 吸附：将坐标或尺寸按 snapStep 取整；snapStep 为 0 不吸附
+ */
+export declare function snapValue(value: number, snapStep: number): number;
+export declare function snapRect(x: number, y: number, width: number, height: number, snapStep: number): {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+};

package/es/components/pisellGridPro/GridPro.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface GridProProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const PisellGridPro: (props: GridProProps) => JSX.Element;
+export default PisellGridPro;

package/es/components/pisellGridPro/GridView/index.d.ts

@@ -0,0 +1,5 @@
+import './index.less';
+import { GridViewProps } from './type';
+export type { GridViewProps };
+declare const GridView: (props: GridViewProps) => JSX.Element;
+export default GridView;

package/es/components/pisellGridPro/GridView/type.d.ts

@@ -0,0 +1,3 @@
+import { PisellScrollViewProps } from '../../PisellScrollView/types';
+export interface GridViewProps extends PisellScrollViewProps {
+}

package/es/components/pisellGridPro/ToolBar/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import './index.less';
+import { ToolBarProps } from './type';
+export type { ToolBarProps };
+declare const Toolbar: React.FC<ToolBarProps>;
+export default Toolbar;

package/es/components/pisellGridPro/ToolBar/type.d.ts

@@ -0,0 +1,10 @@
+/// <reference types="react" />
+export interface ToolBarProps {
+    className?: string;
+    style?: React.CSSProperties;
+    tabs?: React.ReactNode;
+    topLeft?: React.ReactNode;
+    topRight?: React.ReactNode;
+    bottomLeft?: React.ReactNode;
+    bottomRight?: React.ReactNode;
+}

package/es/components/pisellGridPro/components/DataCard/components/StatCard/index.d.ts

@@ -0,0 +1,10 @@
+import React from 'react';
+import { StatCardItem } from '../../types';
+import './index.less';
+/**
+ * StatCard 统计卡片组件
+ * @description 用于展示单个统计数据，包含标题、数值和对比信息
+ * @author Pisell Team
+ */
+declare const StatCard: React.FC<StatCardItem>;
+export default StatCard;

package/es/components/pisellGridPro/components/DataCard/index.d.ts

@@ -0,0 +1,5 @@
+import { DataCardProps } from './types';
+export type { DataCardProps };
+import './index.less';
+declare const DataCard: (props: DataCardProps) => JSX.Element | null;
+export default DataCard;

package/es/components/pisellGridPro/components/DataCard/types.d.ts

@@ -0,0 +1,70 @@
+import React from 'react';
+/**
+ * PisellGridProDataCard 组件属性接口
+ */
+export interface DataCardProps {
+    /**
+     * 统计卡片数据列表
+     */
+    dataItems?: StatCardItem[];
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: React.CSSProperties;
+}
+/**
+ * 统计卡片数据项接口
+ */
+export interface StatCardItem {
+    /**
+     * 唯一标识
+     */
+    key: string;
+    /**
+     * 卡片标题
+     * @example "Total Orders"
+     */
+    title: React.ReactNode;
+    /**
+     * 主要数值
+     * @example 50 或 "$1580"
+     */
+    value: React.ReactNode;
+    /**
+     * 对比数值
+     * @example "+12" 或 "-230"
+     */
+    compareValue?: React.ReactNode;
+    /**
+     * 对比趋势
+     * @description up-增长(绿色), down-下降(红色)
+     * @default undefined
+     */
+    trend?: 'up' | 'down';
+    /**
+     * 对比前缀文本
+     * @default "v.s. pre"
+     */
+    comparePrefix?: string;
+    /**
+     * 是否显示对比信息
+     * @default true
+     */
+    showCompare?: boolean;
+    /**
+     * 自定义卡片样式
+     */
+    style?: React.CSSProperties;
+    /**
+     * 自定义卡片类名
+     */
+    className?: string;
+    /**
+     * 点击回调
+     */
+    onClick?: () => void;
+}

package/es/components/pisellGridPro/components/Footer/index.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import './index.less';
+export interface FooterProps {
+    className?: string;
+    children?: React.ReactNode;
+    style?: React.CSSProperties;
+}
+declare const Footer: (props: FooterProps) => JSX.Element;
+export default Footer;

package/es/components/pisellGridPro/components/Header/index.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+import './index.less';
+export interface HeaderProps {
+    title?: React.ReactNode;
+    badge?: React.ReactNode;
+    subTitle?: React.ReactNode;
+    actionsList?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+}
+declare const Header: React.FC<HeaderProps>;
+export default Header;

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

@@ -0,0 +1,4 @@
+import { GridProProps } from './GridPro';
+export type { GridProProps };
+declare const PisellGridPro: any;
+export default PisellGridPro;

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

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { PisellHierarchicalSummaryListProps } from './types';
+import './PisellHierarchicalSummaryList.less';
+/** 根节点类名，供上层用同一 DOM 包裹列表与其它区块时使用 */
+export declare const PREFIX_CLS = "pisell-hierarchical-summary-list";
+export declare const PisellHierarchicalSummaryList: React.FC<PisellHierarchicalSummaryListProps>;

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/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>;

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

@@ -0,0 +1 @@
+export { Row } from './Row';

package/es/components/pisellHierarchicalSummaryList/hooks/index.d.ts

@@ -0,0 +1,2 @@
+export { useExpandedKeys } from './useExpandedKeys';
+export type { ExpandedKeysController, UseExpandedKeysOptions } from './useExpandedKeys';

package/es/components/pisellHierarchicalSummaryList/hooks/useExpandedKeys.d.ts

@@ -0,0 +1,15 @@
+import type { PisellHierarchicalSummaryListKey } from '../types';
+export interface UseExpandedKeysOptions {
+    expandedKeys?: PisellHierarchicalSummaryListKey[];
+    defaultExpandedKeys?: PisellHierarchicalSummaryListKey[];
+    onExpandedKeysChange?: (keys: PisellHierarchicalSummaryListKey[]) => void;
+}
+export interface ExpandedKeysController {
+    expandedKeys: PisellHierarchicalSummaryListKey[];
+    expandedKeySet: ReadonlySet<PisellHierarchicalSummaryListKey>;
+    setExpandedKeys: (next: PisellHierarchicalSummaryListKey[]) => void;
+}
+/**
+ * 展开态管理（兼容受控/非受控）。
+ */
+export declare function useExpandedKeys(options: UseExpandedKeysOptions): ExpandedKeysController;

package/es/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/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/pisellInformationEntry/Scan/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 export interface ScanProps {
     onChange: (val: string) => void;

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 import './index.less';

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps, ButtonProps } from 'antd';
 import { PisellContextType } from "../../../pisell-config-provider/context";
 export interface CopyProps extends InputProps {

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { InputProps } from 'antd';
 import './index.less';
 import { PisellContextType } from "../../../pisell-config-provider/context";