@pisell/materials 6.11.108 → 6.11.109

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

@@ -0,0 +1,45 @@
+/** 批量落点时图元之间的间距（内容坐标 px） */
+export declare const BATCH_PLACE_GAP = 16;
+export interface BatchPlacementSize {
+    width: number;
+    height: number;
+}
+export interface BatchPlacementRect {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface BatchPlacementLayoutContext {
+    /** 当前画布已有图元（用于计算右侧锚点） */
+    existingElements: BatchPlacementRect[];
+    contentWidth: number;
+    contentHeight: number;
+    /** 与 mapLayer.boundingPadding 一致的单侧 padding */
+    boundingPadding?: number;
+}
+/**
+ * 行列数尽量接近正方形（复用全览网格算法）。
+ */
+export declare function getSquareishGridDims(count: number): {
+    cols: number;
+    rows: number;
+};
+/**
+ * 计算批量落点左上角坐标列表（行优先：先填满第一行再换行）。
+ */
+export declare function computeBatchScenePlacementPositions(sizes: BatchPlacementSize[], ctx: BatchPlacementLayoutContext): Array<{
+    x: number;
+    y: number;
+}>;
+export interface PlacementBoundingBox {
+    minLeft: number;
+    minTop: number;
+    maxRight: number;
+    maxBottom: number;
+}
+/** 由批量落点坐标与尺寸计算轴对齐包围盒（可加 margin 便于视口聚焦留边） */
+export declare function getPlacementBoundingBox(positions: Array<{
+    x: number;
+    y: number;
+}>, sizes: BatchPlacementSize[], margin?: number): PlacementBoundingBox | null;

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

@@ -0,0 +1,267 @@
+/**
+ * 拓扑连线：锚点坐标、自动选边、正交折线路径
+ */
+import type { FloorMapEdge, FloorMapEdgeAnchor, FloorMapEdgeRouting, FloorMapItemBase } from '../types';
+export interface FloorMapItemPixelRect {
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}
+export interface FloorMapEdgeRoute {
+    edgeId: string;
+    points: [number, number][];
+    pathD: string;
+}
+declare const ANCHORS: FloorMapEdgeAnchor[];
+/**
+ * 将图元逻辑坐标转为内容区像素矩形（与 EditableItemLayer 一致）
+ */
+export declare function getItemPixelRect<T extends FloorMapItemBase>(item: T, options: {
+    cellSize: number;
+    itemUnit: 'cell' | 'pixel';
+    itemGap?: number;
+    override?: Partial<FloorMapItemPixelRect>;
+}): FloorMapItemPixelRect;
+export declare function rectCenter(rect: FloorMapItemPixelRect): {
+    x: number;
+    y: number;
+};
+/**
+ * 锚点在矩形边框上的坐标
+ */
+export declare function getAnchorPoint(rect: FloorMapItemPixelRect, anchor: FloorMapEdgeAnchor): {
+    x: number;
+    y: number;
+};
+/** 与 EdgeLayer 端口标签 pill 高度一致 */
+export declare const EDGE_PORT_LABEL_HEIGHT = 18;
+/** 标签中心相对边框锚点的外移间距（px） */
+export declare const EDGE_PORT_LABEL_OFFSET_GAP = 6;
+/**
+ * 编辑态连线锚点圆点外移距离（px），避开 EditableItemLayer 边中点 20×20 缩放手柄。
+ */
+export declare const EDGE_PORT_MARKER_OUTSET = 16;
+/** 折线绕开图元矩形的间距（px） */
+export declare const EDGE_ROUTE_RECT_CLEARANCE = 10;
+/**
+ * 编辑态锚点圆点 UI 位置（相对图元局部坐标），沿外法线外移，连线几何仍用 {@link getAnchorPoint}。
+ */
+export declare function getPortMarkerDisplayPoint(rect: FloorMapItemPixelRect, anchor: FloorMapEdgeAnchor, outset?: number): {
+    x: number;
+    y: number;
+};
+export declare function getPortLabelPosition(rect: FloorMapItemPixelRect, anchor: FloorMapEdgeAnchor, options?: {
+    labelHeight?: number;
+    gap?: number;
+}): {
+    x: number;
+    y: number;
+};
+/** 折线中段连接类型标签相对路径的默认外偏移（px） */
+export declare const EDGE_CENTER_LABEL_OFFSET = 8;
+export declare type EdgeCenterLabelPlacement = 'middle' | 'target-tail' | 'source-tail' | 'longest-horizontal';
+/** 与 EdgeLayer PortLabel 估算宽度一致 */
+export declare function estimateEdgeLabelWidth(text: string): number;
+/**
+ * 在折线指定段上计算标签中心（水平段：标签在线上方；竖直段：标签在线左侧）。
+ */
+export declare function getEdgeCenterLabelPositionOnSegment(points: [number, number][], segIndex: number, options?: {
+    along?: number;
+    offsetPx?: number;
+    perpOffsetPx?: number;
+}): {
+    x: number;
+    y: number;
+} | null;
+/**
+ * 计算边 `label`（如 connection_type）在正交折线上的显示位置。
+ * 默认 `target-tail`：靠近路径末端（目标端），避免标在水平总线中段互相重叠。
+ */
+export declare function getEdgeCenterLabelPosition(points: [number, number][], options?: {
+    placement?: EdgeCenterLabelPlacement;
+    offsetPx?: number;
+    /** 0–1，沿标签所在段的位置 */
+    along?: number;
+    /** 垂直于段的额外偏移（水平段：y 方向；竖直段：x 方向，正数向左） */
+    perpOffsetPx?: number;
+    /** 指定段索引；缺省时由 placement 推导 */
+    segIndex?: number;
+}): {
+    x: number;
+    y: number;
+} | null;
+/** 标签防碰撞：中心点最小间距（px，约等于 pill 高度 + 间距） */
+export declare const EDGE_CENTER_LABEL_MIN_GAP = 22;
+export interface ResolveEdgeCenterLabelItem {
+    edgeId: string;
+    sourceId: string;
+    targetId: string;
+    points: [number, number][];
+    label?: string;
+}
+/**
+ * 为多条边的连接类型标签分配互不重叠的位置。
+ * - 多边汇入同一目标：优先标在各自「水平总线」段中点（天然错开）
+ * - 仍重叠时按 pill 宽高做 bbox 分离；必要时在目标图元左侧纵向堆叠
+ */
+export declare function resolveEdgeCenterLabelPositions(items: ResolveEdgeCenterLabelItem[], options?: {
+    placement?: EdgeCenterLabelPlacement;
+    offsetPx?: number;
+    rectsById?: Map<string, FloorMapItemPixelRect>;
+}): Map<string, {
+    x: number;
+    y: number;
+}>;
+/**
+ * 未指定锚点时，选朝向对方最近的一侧
+ */
+export declare function pickAutoAnchor(from: FloorMapItemPixelRect, to: FloorMapItemPixelRect): FloorMapEdgeAnchor;
+/** 拉线吸附端口时的命中半径（与 {@link EDGE_PORT_MARKER_OUTSET} 同量级） */
+export declare const EDGE_PORT_SNAP_THRESHOLD = 16;
+export interface DrawingTargetHit {
+    instanceId: string;
+    anchor: FloorMapEdgeAnchor;
+}
+/**
+ * 距矩形四边锚点最近的一侧
+ */
+export declare function pickNearestAnchorOnRect(pt: {
+    x: number;
+    y: number;
+}, rect: FloorMapItemPixelRect): FloorMapEdgeAnchor;
+/**
+ * 拉线过程中解析目标：优先吸附到端口圆点，否则落在图元内时取最近端口。
+ */
+export declare function resolveDrawingTargetAtPoint(pt: {
+    x: number;
+    y: number;
+}, instanceIds: string[], rectsById: Map<string, FloorMapItemPixelRect>, excludeInstanceId: string, snapThreshold?: number): DrawingTargetHit | null;
+/** 折线是否有线段穿过矩形内部 */
+export declare function pathCrossesRectInterior(points: [number, number][], rect: FloorMapItemPixelRect): boolean;
+export interface RouteOrthogonalOptions {
+    /** 需要绕开的图元矩形（通常为对端节点） */
+    obstacleRects?: FloorMapItemPixelRect[];
+    clearance?: number;
+    /** @deprecated 使用 obstacleRects；保留兼容，等价于 [targetRect] */
+    sourceRect?: FloorMapItemPixelRect;
+    targetRect?: FloorMapItemPixelRect;
+    /**
+     * 通道偏移（px，带符号）：用于让多条共享同一通道的连线错开，避免视觉重叠。
+     * 影响 Z 型中点（midX/midY）与外侧公共通道（above/below/left/right）。
+     */
+    channelOffset?: number;
+}
+/**
+ * 正交连线：先最短路径，再对穿框段绕一圈。
+ */
+export declare function routeOrthogonal(sourcePt: {
+    x: number;
+    y: number;
+}, sourceSide: FloorMapEdgeAnchor, targetPt: {
+    x: number;
+    y: number;
+}, targetSide: FloorMapEdgeAnchor, 
+/** @deprecated 已取消固定 stub；可传 number（忽略）或 RouteOrthogonalOptions */
+stubOrOptions?: number | RouteOrthogonalOptions, maybeOptions?: RouteOrthogonalOptions): [number, number][];
+/**
+ * 折线转带圆角的 SVG path d
+ */
+export declare function pathFromPoints(points: [number, number][], radius?: number): string;
+export interface BuildEdgeRouteOptions {
+    /** 共享通道时的横向/纵向错位偏移 */
+    channelOffset?: number;
+    /** 用户手动调整后的路由覆盖；优先于 edge.routing 字段 */
+    routingOverride?: FloorMapEdgeRouting;
+}
+/**
+ * 把一条已存在的 path 快照（snapshot）的两端「平移对齐」到新的源/目标锚点位置，
+ * 中间路径完全保留。用于「手动编辑过的连线」在图元被拖动后只更新最近两端。
+ *
+ * 规则：
+ * - 首段（snapshot[0] → snapshot[1]）：
+ *   - 若是水平段（y0 === y1）：新 snapshot[0] = srcPt；新 snapshot[1] = (原 snapshot[1].x, srcPt.y)
+ *   - 若是竖直段（x0 === x1）：新 snapshot[0] = srcPt；新 snapshot[1] = (srcPt.x, 原 snapshot[1].y)
+ *   - 若是斜段（理论上 snapshot 都是正交，但兜底）：仅平移 snapshot[0]，snapshot[1] 保持不变
+ * - 末段（snapshot[n-2] → snapshot[n-1]）：对称处理
+ * - 同时对 snapshot[2] / snapshot[n-3] 做"必要的轴向跟随"：snapshot[1] → snapshot[2] 段必须保持
+ *   正交，因此 snapshot[2] 的相邻轴坐标需要跟随 snapshot[1] 更新（同理末端）。
+ */
+export declare function alignSnapshotToAnchors(snapshot: [number, number][], srcPt: {
+    x: number;
+    y: number;
+}, tgtPt: {
+    x: number;
+    y: number;
+}): [number, number][];
+/**
+ * 将「中段坐标覆盖」应用到一条正交折线 path 上。
+ *
+ * 内部段（既非首段也非末段）按顺序对应 `midSegmentPositions[k]`。
+ * - 水平段（y1 === y2）→ 把 result[i].y / result[i+1].y 都改成 v
+ * - 竖直段（x1 === x2）→ 把 result[i].x / result[i+1].x 都改成 v
+ *
+ * 移动一个内部段只是平移它的主轴坐标，相邻段（必是另一个方向）会随之延长/缩短，
+ * 不会破坏正交性。多余的 override 项被忽略，null/undefined 项跳过。
+ */
+/** 首/末段拖动后默认插入的 stub 长度（px）；过短时按段长 50% 自动缩小 */
+export declare const DEFAULT_EDGE_STUB_LENGTH = 24;
+/**
+ * 在路径起点处插入 stub 转角：把首段变成「沿首段实际方向走 stub → 90° 转弯 →
+ * 走到原 corner」。
+ *
+ * 注意：方向取自 *path 首段实际指向*（points[0]→points[1]），而非 sourceAnchor 字段——
+ * 这样在 path 已经经过手动编辑、首段方向与锚点 outward 不一致时仍能正确插入。
+ *
+ * 路径点数 +2；新增 2 个内部段（stub 段 + 「被拖动段」）。被拖动段的初始另一轴
+ * 坐标与原首段重合（视觉直线），后续由拖动调整。
+ */
+export declare function applySourceStub(points: [number, number][], stubLength: number | undefined, 
+/** @deprecated 仅向后兼容，实际方向由 path 首段决定 */
+sourceAnchor?: FloorMapEdgeAnchor): [number, number][];
+/**
+ * 对称地在路径末端插入 stub 转角。方向取自 *path 末段实际指向*。
+ *
+ * 路径点数 +2；新增 2 个内部段（「被拖动段」 + stub 段）。
+ */
+export declare function applyTargetStub(points: [number, number][], stubLength: number | undefined, 
+/** @deprecated 仅向后兼容，实际方向由 path 末段决定 */
+targetAnchor?: FloorMapEdgeAnchor): [number, number][];
+export declare function applyMidSegmentOverrides(points: [number, number][], overrides: (number | null | undefined)[] | undefined): [number, number][];
+/**
+ * 返回正交折线中所有「内部段」的元信息（不含首段与末段），
+ * 供 UI 渲染中段手柄使用。
+ */
+export interface EdgeInnerSegmentInfo {
+    /** 该内部段在 `midSegmentPositions` 中的索引（0 = path 的第 2 段） */
+    index: number;
+    /** path.points 中该段起点的下标（终点为 i+1） */
+    pointIndex: number;
+    axis: 'h' | 'v';
+    /** 段的主轴坐标：水平段 = y，竖直段 = x */
+    position: number;
+    /** 段中点坐标（用于摆放手柄） */
+    midX: number;
+    midY: number;
+    /** 段长度（绝对值），用于判定是否值得渲染手柄（防止极短段误触） */
+    length: number;
+}
+export declare function getEdgeInnerSegments(points: [number, number][]): EdgeInnerSegmentInfo[];
+export declare function buildEdgeRoute(edge: FloorMapEdge, rectsById: Map<string, FloorMapItemPixelRect>, options?: BuildEdgeRouteOptions): FloorMapEdgeRoute | null;
+/**
+ * 去掉路径中"三点共线"的冗余中间点（比如 routeOrthogonal 里 srcPt → sOut →
+ * 中段折点都在同一 y 上时，sOut 是冗余的）。
+ *
+ * 保留零长度段：用户拖动 first/last 段创建 stub 时，stubEnd 与 midCorner 短暂
+ * 重合（零长度），不能被合并掉，否则会立刻丢失新插入的转角结构。
+ */
+export declare function simplifyCollinearPath(points: [number, number][]): [number, number][];
+/**
+ * 按 edge 顺序分配交替偏移，让落到同一通道的多条线错开。
+ * 序列：0, +step, -step, +2*step, -2*step, ...
+ */
+export declare function getEdgeChannelOffset(index: number, step?: number): number;
+/** 命中检测：点到折线最近距离 */
+export declare function distanceToPolyline(px: number, py: number, points: [number, number][]): number;
+export declare function hitTestEdgeAtPoint(px: number, py: number, routes: FloorMapEdgeRoute[], threshold?: number): string | null;
+export { ANCHORS as FLOOR_MAP_EDGE_ANCHORS };

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

@@ -0,0 +1,20 @@
+import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
+/**
+ * 合并平面图 Tab 用多语言包（与业务侧 `locales.init` 可叠加）。
+ */
+export declare function initFloorMapLayoutLocales(engineLocale: string): void;
+/**
+ * 从多语言对象中取当前 locale 下展示字符串，缺省按 en → 其余首个非空。
+ */
+export declare function pickFloorMapCanvasI18nString(obj: FloorMapCanvasNameI18n, engineLocale: string): string;
+/**
+ * 画布在 Tab / 下拉中的展示名：
+ * 1. `name` 为多语言对象时 **优先** 按引擎 locale 取字段（与配置内嵌文案一致）；
+ * 2. 否则 `nameKey` + `locales.getText`（需业务侧已 init 对应语言包）；
+ * 3. 否则 `name` 字符串。
+ */
+export declare function getFloorMapCanvasDisplayName(canvas: FloorMapCanvas, engineLocale: string): string;
+/**
+ * 打开重命名弹层时的初始多语言值（与 Translation 表单一致）。
+ */
+export declare function seedFloorMapCanvasNameI18n(canvas: FloorMapCanvas, displayFallback: string): FloorMapCanvasNameI18n;

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

@@ -0,0 +1,83 @@
+/**
+ * 平面图内容区尺寸：由 items + padding 推导 contentWidth/Height 与 offset。
+ * 供 useFloorMapTransformMetrics（单画布视口）与 FloorMapOverview（多画布平铺）共用，
+ * 避免两处各自维护包围盒算法。
+ */
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+/** 内容区宽高与图元层偏移（与 Transform content 坐标系一致） */
+export interface FloorMapContentStage {
+    contentWidth: number;
+    contentHeight: number;
+    contentOffsetX: number;
+    contentOffsetY: number;
+    /**
+     * 使用 pixel 包围盒时的单侧 padding，用于 initialPosition 对齐；
+     * 非包围盒路径为 null。
+     */
+    alignPadSingle: number | null;
+}
+export interface ComputeFloorMapContentStageParams<T extends FloorMapItemBase = FloorMapItemBase> {
+    items: T[];
+    cellSize: number;
+    itemGap: number;
+    itemUnit: FloorMapItemUnit;
+    /** 单侧 bounding padding（与 mapLayer.boundingPadding 一致） */
+    boundingPadding: number;
+    /**
+     * 为 true 且 itemUnit 为 pixel、items 非空时，按图元包围盒扩边；
+     * 平面图主视图传 isFloorMapView，全览缩略图传 true。
+     */
+    preferPixelBoundingBox?: boolean;
+}
+/**
+ * 根据 items 计算内容区尺寸与偏移。
+ * 算法与 {@link useFloorMapTransformMetrics} 内原 useMemo 一致（不含「撑满视口」扩展）。
+ */
+export declare function computeFloorMapContentStage<T extends FloorMapItemBase>(params: ComputeFloorMapContentStageParams<T>): FloorMapContentStage;
+/**
+ * 全览网格行列：n≤3 单行；n≥4 用 ceil(√n) 列、ceil(n/cols) 行，行列接近且末行空格最少。
+ * 例：2→2×1，3→3×1，4→2×2，5/6→3×2，7-9→3×3，10-12→4×3。
+ *
+ * 仅供旧版「等大缩略图卡片」全览使用；新版 All 视图按原始尺寸装箱，请用
+ * {@link packCanvasesIntoShelves}。
+ */
+export declare function getOverviewGridDims(count: number): {
+    cols: number;
+    rows: number;
+};
+/** 装箱输入：每个画布在统一比例尺下的原始尺寸（像素） */
+export interface PackCanvasItem {
+    width: number;
+    height: number;
+}
+/** 装箱产物：每个画布的左上角坐标 + 总布局尺寸（不含外侧 padding） */
+export interface PackCanvasResult {
+    positions: Array<{
+        x: number;
+        y: number;
+    }>;
+    totalWidth: number;
+    totalHeight: number;
+}
+/**
+ * 多画布 All 视图的紧凑装箱（Bottom-Left Fill, BLF）：
+ *
+ * - 保留输入顺序（与 Tab 顺序一致），不旋转、不缩放，原始尺寸即渲染尺寸；
+ * - 对每张画布枚举候选落点 = `{(0,0)} ∪ 已放画布的{右侧, 下方}角`；过滤掉与已放冲突
+ *   的位置，再挑 **y 最小、再 x 最小** 的位置落下——优先填低洼，自然会把矮 / 窄画布
+ *   塞进高画布旁的空白；不会出现「等最高画布把整行撑满才换行」导致的大量空白；
+ * - 目标外框宽度 `targetWidth = max(最宽画布, √(总面积 × {@link aspectBias}))`，
+ *   令整体形状趋于 `aspectBias:1`（默认 2.5 → 宽:高 ≈ 2.5:1，轻微偏横）；
+ *   单张画布若本身比 targetWidth 还宽，仍允许独自首行铺开，避免被截。
+ *
+ * 复杂度 O(n²)（每个画布对所有已放做候选 + 冲突校验），n 通常 < 20，性能足够。
+ * 比旧的行装填（shelf packing）能显著减少长高画布旁的留白。
+ *
+ * @param boxes - 待装箱画布尺寸（保持顺序）
+ * @param gap - 画布之间的像素间距（同时作为冲突检测的最小净距）
+ * @param aspectBias - 目标宽高比偏置（width:height）；越大越横向，默认 2.5
+ *   - `1.5` ~ `2`：接近正方形，仅略偏横
+ *   - `2.5` ~ `3`：明显但温和的横向布局（推荐）
+ *   - `>= 4`：强横向，画布数较多时易接近单行
+ */
+export declare function packCanvasesIntoShelves(boxes: PackCanvasItem[], gap: number, aspectBias?: number): PackCanvasResult;

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

@@ -0,0 +1,35 @@
+/**
+ * 图元种类解析与绑定展示前校验（供合并项渲染、工具栏逻辑复用）
+ */
+import type { FloorMapElementKindConfig, FloorMapViewConfig, FloorMapSceneElement, FloorMapDataSources, FloorMapElementDataBindingPolicy } from '../types';
+/** 与 RecordBoard Story 一致：`floorMapImage` */
+export declare function isFloorMapImageElementKind(kind: string | undefined): boolean;
+/** 内置图形图元：与 image 类似的「无数据源 + 视觉填充」单体 kind */
+export declare function isFloorMapBuiltinShapeElementKind(kind: string | undefined): boolean;
+/** dataBindingPolicy 缺省视为 none */
+export declare function resolveDataBindingPolicy(kind: FloorMapElementKindConfig | undefined): FloorMapElementDataBindingPolicy;
+/**
+ * 侧栏调色板：点击即可落点，无需数据源 / 数据行等二次选择。
+ * 含预约「装饰」下的内置图形（厕所/分隔/柱子等）、底图图片等（`dataBindingPolicy: none`）。
+ * 不含舞台；内置图形须带 `builtinShapeKey` 由 {@link isDirectPlacePaletteEntry} 判断。
+ */
+export declare function isDirectPlacePaletteKind(kind: FloorMapElementKindConfig | undefined): boolean;
+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[];
+/** 绑定资源类图元（dataBindingPolicy 为 required/optional）新建默认尺寸 */
+export declare const FLOOR_MAP_RESOURCE_PLACE_DEFAULT: {
+    readonly width: 300;
+    readonly height: 200;
+};
+/**
+ * 在右侧编辑面板将图元改为同分类下的另一种 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/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/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/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';