@pisell/materials 6.11.223 → 6.11.225

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

@@ -0,0 +1,44 @@
+import type { FloorMapItemUnit, FloorMapLayerConfig, FloorMapMergedItem, FloorMapViewConfig } from '../types';
+/** 单个画布在 All 视图中的「区域」描述 */
+export interface OverviewCanvasArea {
+    canvasId: string;
+    items: FloorMapMergedItem[];
+    /** 内容区尺寸（已按 boundingPadding 扩边） */
+    contentWidth: number;
+    contentHeight: number;
+    /** ItemLayer 内部图元层偏移（与单画布一致） */
+    contentOffsetX: number;
+    contentOffsetY: number;
+    cellSize: number;
+    /**
+     * 区块在大画布坐标系中的左上角（含外置标题带）。
+     * 带边框的画布内容区从 `y + titleBandHeight` 起算。
+     */
+    x: number;
+    y: number;
+    /** 外置标题带高度，与 {@link FLOOR_MAP_OVERVIEW_TITLE_BAND_HEIGHT} 一致 */
+    titleBandHeight: number;
+}
+export interface OverviewLayout {
+    areas: OverviewCanvasArea[];
+    /** 大画布总宽（不含外侧 padding，由调用方在 MapLayer/contentStage 端处理） */
+    totalWidth: number;
+    totalHeight: number;
+}
+/**
+ * 构造 All 视图布局。
+ *
+ * - 顺序：按 `canvas.order` 升序，与顶部 Tab 顺序一致；
+ * - 尺寸：每个画布按 {@link computeFloorMapContentStage}（含其自己的 boundingPadding）
+ *   推导内容尺寸，所有画布共享同一比例尺，不缩放；
+ * - 装箱：{@link packCanvasesIntoShelves} 行装填，目标行宽 ≈ √总面积。
+ */
+export declare function buildFloorMapOverviewLayout(params: {
+    config: FloorMapViewConfig;
+    /** 全局 mapLayer（与画布级 mapLayer 合并后仅用于推导 boundingPadding / gap） */
+    globalMapLayer?: FloorMapLayerConfig;
+    cellSize: number;
+    itemUnit: FloorMapItemUnit;
+    /** 区域之间在大画布坐标系下的间距（像素） */
+    areaGap: number;
+}): OverviewLayout;

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

@@ -0,0 +1,27 @@
+import type { PisellCardPickerCardBadge, PisellCardPickerCardMeta, PisellCardPickerCategoryConfig, PisellCardPickerItem } from './floorMapResourcePickerTypes';
+import { parseNestedPathSegments } from './floorMapResourcePickerTypes';
+/** @deprecated 使用 PisellCardPickerItem */
+export declare type FloorMapResourcePickerRecord = PisellCardPickerItem;
+/** 平面图资源选择卡片 meta：在通用 meta 基础上确保 id 存在，便于搜索文本拼接 */
+export interface FloorMapResourcePickerCardMeta extends PisellCardPickerCardMeta {
+    id: string;
+}
+/** 人数/容量：无值或为 0 时不展示 */
+export declare function resolveResourcePickerCapacity(record: PisellCardPickerItem): string | undefined;
+/**
+ * 预约桌位：从 `area` 解析路径，最多 3 段。
+ * 当前资源多为单段（如 `party_room1`）；将来 `广东/中山/三乡` 会自动出现二、三级筛选行。
+ */
+export declare function getFloorMapResourcePickerCategoryPath(record: PisellCardPickerItem): ReturnType<typeof parseNestedPathSegments>;
+/** 平面图 / 预约：area 最多三级；仅展示 chip，不显示行左侧「区域」等标签 */
+export declare function getFloorMapCardPickerCategoryConfig(): PisellCardPickerCategoryConfig;
+/**
+ * 把 capacity 字符串包装成「人数图标 + 数值」badge。
+ * 抽出来便于业务侧组合（如再追加 status badge 等）。
+ */
+export declare function buildResourceCapacityBadge(capacity?: string): PisellCardPickerCardBadge | null;
+/**
+ * 小卡片主标题 + 标签（人数等；区域已在筛选区展示，副文案不再重复 area）。
+ */
+export declare function getFloorMapResourcePickerCardMeta(record: PisellCardPickerItem): FloorMapResourcePickerCardMeta;
+export declare function floorMapResourcePickerRecordSearchText(record: PisellCardPickerItem): string;

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

@@ -0,0 +1,109 @@
+/**
+ * 平面图资源选择槽位的通用类型与工具。
+ * 默认由 `@pisell/materials` 的 `PisellResourcePickerModal` 承担；
+ * 业务可通过 `renderFilterBar` 注入 Tabbar 等筛选区，或通过 `renderResourcePickerModal` 整页覆盖。
+ */
+import type { ReactNode } from 'react';
+/** 选择模式 */
+export declare type PisellCardPickerMode = 'single' | 'multiple';
+/** 可选条目：至少包含稳定主键 id */
+export interface PisellCardPickerItem {
+    id: string;
+    [key: string]: unknown;
+}
+/** 分类路径，最多 3 级（不足时后续为 null；未选层级表示「全部」） */
+export declare type PisellCardPickerCategoryPath = [
+    string | null | undefined,
+    string | null | undefined,
+    string | null | undefined
+];
+/** 单级分类配置（最多 3 级） */
+export interface PisellCardPickerCategoryLevelConfig {
+    /** 嵌套模式下该级行左侧标签（如「省」「市」「区/镇」） */
+    label?: string;
+    /**
+     * parallel 模式：从 item[field] 读取该维度的 key。
+     * nested 模式：请用 getCategoryPath / nestedPathField 从单字段拆路径。
+     */
+    field?: string;
+}
+/**
+ * nested：同一维度嵌套分级（广东 → 中山 → 三乡），子级依赖父级已选。
+ * parallel：三个独立维度（每级互不影响）。
+ */
+export declare type PisellCardPickerCategoryMode = 'nested' | 'parallel';
+/** 分类筛选配置（最多 3 级；数据只有 1 级时 UI 只展示有值的那一行） */
+export interface PisellCardPickerCategoryConfig {
+    /** 默认 nested */
+    mode?: PisellCardPickerCategoryMode;
+    /**
+     * 最多 3 级配置位。
+     * nested：单字段拆路径；仅 1 段时只出现第 1 行，多段时再逐级出现。
+     */
+    levels: [
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?,
+        PisellCardPickerCategoryLevelConfig?
+    ];
+    /** 自定义 [L1,L2,L3]；优先于 levels[].field */
+    getCategoryPath?: (item: PisellCardPickerItem) => PisellCardPickerCategoryPath;
+    /**
+     * nested 便捷项：从 item[nestedPathField] 用 `/` `>` 等拆成最多 3 段。
+     * 与 getCategoryPath 同时存在时以 getCategoryPath 为准。
+     */
+    nestedPathField?: string;
+}
+/**
+ * 卡片小标签（如人数、状态、面积等）。
+ * - text：必填，纯文本内容
+ * - icon：可选 ReactNode，前置图标（如 TeamOutlined）
+ * 业务自由组合多个；空数组等价于不展示。
+ */
+export interface PisellCardPickerCardBadge {
+    text: string;
+    icon?: ReactNode;
+}
+export interface PisellCardPickerCardMeta {
+    title: string;
+    subtitles: string[];
+    /**
+     * 卡片末行的标签数组（如人数 / 状态）。比 subtitle 更紧凑，支持前置 icon。
+     */
+    badges?: PisellCardPickerCardBadge[];
+    /**
+     * 左侧缩略图/预览节点。传入字符串走内置 `<img>`，传入 ReactNode 直接渲染
+     * （如平面图 View All 的 palette preview cell）。
+     */
+    image?: ReactNode | string;
+}
+/**
+ * 平面图工具栏「打开资源选择」槽位 props。
+ * 与 `PisellProResourcePickerModalProps` 字段对齐；业务注入 modal 时可透传
+ * `categoryConfig` / `getSearchText` / `getCardMeta` 等扩展项。
+ */
+export interface FloorMapResourcePickerSlotProps {
+    open: boolean;
+    onClose: () => void;
+    onConfirm: (selectedIds: string[]) => void;
+    records: PisellCardPickerItem[];
+    mode?: PisellCardPickerMode;
+    value?: string[];
+    title?: string;
+    disabledIds?: string[];
+    /** 最多三级分类；不传则仅搜索 + 列表 */
+    categoryConfig?: PisellCardPickerCategoryConfig;
+    getSearchText?: (record: PisellCardPickerItem) => string;
+    getCardMeta?: (record: PisellCardPickerItem) => PisellCardPickerCardMeta;
+    renderCard?: (record: PisellCardPickerItem, ctx: {
+        selected: boolean;
+        disabled: boolean;
+    }) => ReactNode;
+    zIndex?: number;
+    width?: number;
+    className?: string;
+}
+/**
+ * 把单字段中的层级路径解析为 [L1, L2, L3]。
+ * 例：`广东/中山/三乡` → `['广东','中山','三乡']`；不足三级后续为 null。
+ */
+export declare function parseNestedPathSegments(raw: unknown, maxDepth?: number): PisellCardPickerCategoryPath;

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

@@ -0,0 +1,24 @@
+import type { FloorMapMergedItem } from '../types';
+export interface SelectionZoneRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+/** 该图元是否为选区 */
+export declare function isSelectionZoneItem(item: {
+    elementKind?: string;
+}): boolean;
+/** zoneRect 是否「完全包含」itemRect（含边界，允许 1px 容差以抵消取整误差） */
+export declare function rectFullyContains(zoneRect: SelectionZoneRect, itemRect: SelectionZoneRect, tolerance?: number): boolean;
+/**
+ * 计算选区成员 id 列表（输入为像素矩形坐标系）。
+ *
+ * @param zoneId      选区自身 id（排除自身）
+ * @param zoneRect    选区矩形（像素）
+ * @param itemRects   画布上全部图元及其像素矩形
+ */
+export declare function computeSelectionZoneMemberIds(zoneId: string, zoneRect: SelectionZoneRect, itemRects: Array<{
+    item: FloorMapMergedItem;
+    rect: SelectionZoneRect;
+}>): string[];

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

@@ -0,0 +1,34 @@
+import type { FloorMapElementKindConfig } from '../types';
+import { type FloorMapBuiltinShapeDef } from './floorMapBuiltinShapes';
+/** @deprecated 使用 {@link FLOOR_MAP_TOOLBAR_PALETTE_SIDEBAR_LIMIT} */
+export declare const FLOOR_MAP_TOOLBAR_PALETTE_VISIBLE_LIMIT = 5;
+/** 解析侧栏每类展示上限（至少 1） */
+export declare function resolvePaletteSidebarVisibleLimit(limit?: number): number;
+/** 分类下图元数是否应显示「查看全部」 */
+export declare function shouldShowPaletteViewAll(entryCount: number, limit?: number): boolean;
+/** 侧栏直接展示的 palette 条目（前 N 项） */
+export declare function getPaletteSidebarVisibleEntries<T>(entries: T[], limit?: number): T[];
+/** 批量从弹窗落点时的单项描述（与 {@link FloorMapPlaceMode} scene 子集对齐） */
+export interface FloorMapPaletteBulkPlaceItem {
+    elementKind: string;
+    builtinShapeKey?: string;
+}
+/**
+ * 侧栏 / 弹窗共用的 palette 条目：普通 kind 一项；内置图形 kind 按预设展开多项。
+ */
+export interface FloorMapToolbarPaletteEntry {
+    key: string;
+    kind: FloorMapElementKindConfig;
+    builtinShapeKey?: string;
+    label: string;
+    shapeDef?: FloorMapBuiltinShapeDef;
+}
+/** 该 palette 条目是否点击即落画布（装饰内置图形单卡、无绑定 kind 等） */
+export declare function isDirectPlacePaletteEntry(entry: FloorMapToolbarPaletteEntry): boolean;
+export declare function buildToolbarPaletteEntries(kinds: FloorMapElementKindConfig[], resolveBuiltinLabel: (shapeDef: FloorMapBuiltinShapeDef) => string): FloorMapToolbarPaletteEntry[];
+/** palette 条目 → 批量落点 payload（每项数量 1） */
+export declare function paletteEntriesToBulkPlaceItems(entries: FloorMapToolbarPaletteEntry[]): FloorMapPaletteBulkPlaceItem[];
+/**
+ * 按弹窗内各条目数量展开为落点列表（数量为 n 则重复 n 次，落点时阶梯偏移）。
+ */
+export declare function expandPaletteEntriesByQuantity(entries: FloorMapToolbarPaletteEntry[], quantities: Readonly<Record<string, number>>): FloorMapPaletteBulkPlaceItem[];

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