@pisell/materials 1.0.1086 → 1.0.1087

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

@@ -0,0 +1,8 @@
+/**
+ * 将当前画布的 sceneElements 合并为 Layout 使用的 FloorMapMergedItem[]
+ */
+import type { FloorMapViewConfig, FloorMapMergedItem } from '../types';
+/**
+ * 合并指定画布下的 sceneElements 为一份 items（用于 ItemLayer / EditableItemLayer）
+ */
+export declare function mergeCanvasItems(canvasId: string, config: Pick<FloorMapViewConfig, 'sceneElements' | 'elementKinds'>, defaultCellSize?: number): FloorMapMergedItem[];

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

@@ -0,0 +1,21 @@
+import type { FloorMapDataSources, FloorMapMergedItem } from '../types';
+/**
+ * 数据源行：平面图 dataSources 列表项至少含 `id`（与 {@link FloorMapSceneElementDataBinding.recordId} 对应）。
+ */
+export declare type FloorMapDataSourceRow = {
+    id: string;
+    [key: string]: unknown;
+};
+/**
+ * 按画布图元上的 `dataBinding` 在 `dataSources[dataSourceKey]` 中查找对应行。
+ * 与 private-materials 预约 `findReservationRow` 算法一致：`recordId` 与行的 `id` 均按字符串比较。
+ */
+export declare function findFloorMapRowByDataBinding<T extends FloorMapDataSourceRow>(item: FloorMapMergedItem, dataSources: FloorMapDataSources): T | undefined;
+/**
+ * 当 {@link findFloorMapRowByDataBinding} 无结果时，占位卡可据此选择文案（业务层自行 i18n）。
+ */
+export declare type FloorMapBindingPlaceholderReason = 'missing_data_source_key' | 'missing_record_id' | 'new_unsaved_slot' | 'record_not_in_list';
+/**
+ * 若已能解析到数据源行则返回 `null`；否则返回占位原因（不含文案，便于各业务映射 locales）。
+ */
+export declare function getFloorMapBindingPlaceholderReason(item: FloorMapMergedItem, dataSources: FloorMapDataSources): FloorMapBindingPlaceholderReason | null;

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

@@ -0,0 +1,8 @@
+/**
+ * 平面图数据行在下拉选项中的展示文案（侧栏「选择数据行」、工具栏多选记录）
+ * 仅展示名称侧一条：main_field（取 ## 前段）→ code → name；不再拼接 id、form_code、status。
+ */
+export declare function formatDataRecordOptionLabel(record: {
+    id: string;
+    [k: string]: unknown;
+}): string;

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

@@ -0,0 +1,27 @@
+/**
+ * 平面图编辑态：侧栏图元拖拽到画布的 DataTransfer 与坐标
+ */
+/** 与 setData 一致，用于识别左侧图元栏发起的拖拽 */
+export declare const FLOOR_MAP_PALETTE_DRAG_MIME = "application/x-pisell-floor-map-element";
+export interface FloorMapPaletteDragPayload {
+    elementKind: string;
+    dataSourceKey?: string;
+    recordId?: string;
+    recordIds?: string[];
+}
+/**
+ * 与 {@link useFloorMapEditState} 落点一致：内容区 drop 的 offset 减去内容区 padding 偏移
+ */
+export declare function sceneXYFromContentDropOffset(offsetX: number, offsetY: number, contentOffset: {
+    x: number;
+    y: number;
+}): {
+    x: number;
+    y: number;
+};
+/** 是否为左侧图元栏拖拽（非本地文件 / 外链图片） */
+export declare function isFloorMapPaletteDrag(dt: DataTransfer | null): boolean;
+/**
+ * 解析侧栏拖拽 payload；非法时返回 null
+ */
+export declare function parsePaletteDragPayload(dt: DataTransfer): FloorMapPaletteDragPayload | null;

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

@@ -0,0 +1,17 @@
+import type { FloorMapViewConfig } from '../types';
+export declare type WrapFloorMapOnSaveWithRemotePersistParams = {
+    /** 与预约页一致：id 有效且为有限正整数 */
+    canPersist: boolean;
+    persistTargetId: number;
+    /** 写入远端（如 PUT shop floor-plan） */
+    persist: (id: number, config: FloorMapViewConfig) => Promise<unknown>;
+    /** 成功后将草稿同步到「远程补丁」状态，避免编辑态被旧 GET 覆盖 */
+    setRemoteFloorPlanView: (patch: Partial<FloorMapViewConfig>) => void;
+    onFloorPlanPersisted?: () => void;
+    prevOnSave?: (config: FloorMapViewConfig) => void;
+    onPersistError?: (err: unknown) => void;
+};
+/**
+ * 将 `floorMap.onSave` 包装为：先持久化到远端，再 `setRemoteFloorPlanView(floorMapSavedConfigToRemotePatch)` 与用户 `prevOnSave`。
+ */
+export declare function wrapFloorMapOnSaveWithRemotePersist(params: WrapFloorMapOnSaveWithRemotePersistParams): (config: FloorMapViewConfig) => void;

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/GridView/index.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import './index.less';
 import { GridViewProps } from './type';
 export type { GridViewProps };

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

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { DataCardProps } from './types';
 export type { DataCardProps };
 import './index.less';

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/pisellImport/PisellImport.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { PisellImportProps } from './types';
+import './PisellImport.less';
+/**
+ * PisellImport 导入触发器组件
+ *
+ * @description 点击后打开文件选择，支持 accept、multiple、maxSize 校验，选择完成后回调 onImport(files)
+ */
+export declare function PisellImport(props: PisellImportProps): JSX.Element;

package/es/components/pisellImport/PisellImport.stories.d.ts

@@ -0,0 +1,49 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellImport } from './PisellImport';
+declare const meta: Meta<typeof PisellImport>;
+export default meta;
+declare type Story = StoryObj<typeof PisellImport>;
+/**
+ * 默认 Button 形态
+ */
+export declare const Basic: Story;
+/**
+ * 仅图标形态
+ */
+export declare const IconOnly: Story;
+/**
+ * 三种尺寸 - Button
+ */
+export declare const SizesButton: Story;
+/**
+ * 三种尺寸 - Icon
+ */
+export declare const SizesIcon: Story;
+/**
+ * 默认样式 vs 主色样式
+ */
+export declare const DefaultVsPrimary: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 自定义文案
+ */
+export declare const CustomLabel: Story;
+/**
+ * 自定义图标（antd 图标）
+ */
+export declare const CustomIcon: Story;
+/**
+ * 文件选择：限制类型与大小
+ */
+export declare const FileSelect: Story;
+/**
+ * 多选文件
+ */
+export declare const MultipleFiles: Story;
+/**
+ * 与 Export 并排
+ */
+export declare const WithExport: Story;

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

@@ -0,0 +1,2 @@
+export { PisellImport } from './PisellImport';
+export type { PisellImportProps, VariantType, SizeType, ImportButtonType } from './types';