@pisell/materials 6.11.107 → 6.11.108

package/es/components/pisellFloorMapLayout/components/FloorMapToolbar.d.ts

@@ -1,84 +0,0 @@
-/**
- * FloorMapToolbar - 编辑态左侧侧边栏：按分类添加图元、绑定数据源与行；保存可选（默认用顶栏）
- */
-import React from 'react';
-import type { FloorMapViewConfig, FloorMapDataSources, FloorMapMergedItem, FloorMapSceneElement, FloorMapPlaceMode } from '../types';
-import { type FloorMapPaletteDragPayload } from '../utils/floorMapDropUtils';
-import { type FloorMapPaletteBulkPlaceItem, type FloorMapToolbarPaletteEntry } from '../utils/floorMapToolbarPalette';
-import type { FloorMapResourcePickerSlotProps } from '../utils/floorMapResourcePickerTypes';
-import './FloorMapToolbar.less';
-export type { FloorMapPlaceMode as PlaceMode };
-export interface FloorMapToolbarProps {
-    config: FloorMapViewConfig;
-    dataSources: FloorMapDataSources;
-    dataSourceLabels?: Record<string, string>;
-    canCreate: boolean;
-    placeMode: FloorMapPlaceMode;
-    onPlaceModeChange: (mode: FloorMapPlaceMode) => void;
-    renderPreviewItem?: (item: FloorMapMergedItem) => React.ReactNode;
-    placementPreviewSize?: {
-        width: number;
-        height: number;
-    };
-    decorationPreviewSize?: number;
-    sceneElements?: FloorMapSceneElement[];
-    onSave?: () => void;
-    saving?: boolean;
-    saveError?: Error | string;
-    /** 布局草稿已相对持久化配置变更，提示用户点击本栏「保存」 */
-    layoutDirty?: boolean;
-    className?: string;
-    /** 触摸/笔：Pointer 拖拽落点（mouse 仍用 HTML5 DnD） */
-    onPaletteCardPointerDown?: (payload: FloorMapPaletteDragPayload, e: React.PointerEvent<HTMLButtonElement>) => void;
-    /** 触摸拖放结束后吞掉按钮 click，避免误触切换落点模式 */
-    consumeToolbarClickIfTouchDrag?: () => boolean;
-    /** 手机布局：侧栏悬浮覆盖画布（由 PisellFloorMapLayout + Less 控制定位） */
-    phoneLayout?: boolean;
-    /** 为 true 时初始为收起（预约手机编辑态默认收起图元栏） */
-    defaultCollapsed?: boolean;
-    /**
-     * 手机布局：选中图元种类后，一键在当前视口中心落点（与画布点击落点规则一致）。
-     */
-    onRequestPlaceAtCanvasCenter?: () => void;
-    /**
-     * 每个调色板分类在侧栏直接展示的图元数量；超出则显示「查看全部」（默认见
-     * floorMapLayoutConstants.FLOOR_MAP_TOOLBAR_PALETTE_SIDEBAR_LIMIT，默认 5）。
-     */
-    paletteSidebarVisibleLimit?: number;
-    /** 「查看全部」弹窗确认：批量落在画布右侧空白区（所有分类通用）。 */
-    onBulkAddPaletteToCanvas?: (items: FloorMapPaletteBulkPlaceItem[]) => void;
-    /**
-     * 「查看全部」弹窗渲染槽位：用于业务侧复用统一的选择弹窗（如 Selector + 数量选择）。
-     * 未传时使用内置 `FloorMapToolbarViewAllModal`（加减步进器）。
-     */
-    renderPaletteViewAllModal?: (props: {
-        open: boolean;
-        categoryLabel: string;
-        entries: FloorMapToolbarPaletteEntry[];
-        onClose: () => void;
-        onConfirm: (items: FloorMapPaletteBulkPlaceItem[]) => void;
-        renderEntryPreview: (entry: FloorMapToolbarPaletteEntry) => React.ReactNode;
-        /** 容器平台：手机布局透传 `'h5'`，默认 `'pc'` */
-        platform?: 'pc' | 'h5' | 'ipad';
-    }) => React.ReactNode;
-    /**
-     * 资源选择弹窗点「确定」：按已选 recordIds 落画布（多选走批量网格，单选落视口中心附近）。
-     * @returns 是否已成功写入草稿
-     */
-    onResourcePickerConfirmPlace?: (scene: Extract<FloorMapPlaceMode, {
-        type: 'scene';
-    }>) => boolean;
-    /**
-     * 资源选择 Modal 渲染（必传）。
-     * 通用基础 modal 已下线，业务侧需注入实现（如 `PisellProResourcePickerModal`）；
-     * 未注入时仅打 warn，不渲染选择弹窗，资源选择交互不可用。
-     */
-    renderResourcePickerModal?: (props: FloorMapResourcePickerSlotProps) => React.ReactNode;
-    /**
-     * 无二次选择的调色板项（装饰内置图形、底图图片、`dataBindingPolicy: none` 等）：
-     * 侧栏点击即落在画布右侧空白区，不进入「再点画布」落点模式。
-     */
-    onDirectPlacePaletteItem?: (item: FloorMapPaletteBulkPlaceItem) => void;
-}
-export declare function FloorMapToolbar(props: FloorMapToolbarProps): JSX.Element;
-export default FloorMapToolbar;

package/es/components/pisellFloorMapLayout/components/FloorMapToolbarViewAllModal.d.ts

@@ -1,20 +0,0 @@
-/**
- * 侧栏 palette「查看全部」：任意分类下图元超过展示上限时，弹窗内按数量多选并一键落点。
- */
-import React from 'react';
-import { type FloorMapPaletteBulkPlaceItem, type FloorMapToolbarPaletteEntry } from '../utils/floorMapToolbarPalette';
-export interface FloorMapToolbarViewAllModalProps {
-    open: boolean;
-    categoryLabel: string;
-    entries: FloorMapToolbarPaletteEntry[];
-    onClose: () => void;
-    onConfirm: (items: FloorMapPaletteBulkPlaceItem[]) => void;
-    renderEntryPreview: (entry: FloorMapToolbarPaletteEntry) => React.ReactNode;
-    /**
-     * 容器平台：透传到 `PisellContainer` 的 `props.platform`。
-     * 手机布局应传 `'h5'`，否则默认 `'pc'`。
-     */
-    platform?: 'pc' | 'h5' | 'ipad';
-}
-export declare function FloorMapToolbarViewAllModal(props: FloorMapToolbarViewAllModalProps): JSX.Element;
-export default FloorMapToolbarViewAllModal;

package/es/components/pisellFloorMapLayout/components/FloorMapZoneElement.d.ts

@@ -1,6 +0,0 @@
-/// <reference types="react" />
-import './FloorMapZoneElement.less';
-export interface FloorMapZoneElementProps {
-    name?: string;
-}
-export declare function FloorMapZoneElement(props: FloorMapZoneElementProps): JSX.Element;

package/es/components/pisellFloorMapLayout/components/ItemLayer.d.ts

@@ -1,59 +0,0 @@
-/**
- * ItemLayer - 楼层图展示层
- * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
- */
-import React from 'react';
-import type { FloorMapItemBase, FloorMapItemUnit, FloorMapRenderOptions } from '../types';
-import type { CSSProperties } from 'react';
-import './ItemLayer.less';
-export interface ItemLayerProps<T extends FloorMapItemBase> {
-    /** 资源列表 */
-    items: T[];
-    /** 每项渲染函数 */
-    renderItem: (item: T, index: number, options?: FloorMapRenderOptions) => React.ReactNode;
-    /** 画布缩放（与平面图 zoom 一致），透传给 renderItem 第三参数 */
-    viewportScale?: number;
-    /** 每项 key */
-    rowKey?: string | ((item: T, index: number) => string);
-    /** 每格像素尺寸（cell 单位时用；pixel 单位时作为缺省宽高） */
-    cellSize: number;
-    /** item 坐标与尺寸单位：cell 格子数，pixel 像素 */
-    itemUnit?: FloorMapItemUnit;
-    /** item 之间的间距（像素），仅 cell 单位时生效 */
-    itemGap?: number;
-    /** 内容区总宽度（像素），由 items 推导或外部传入 */
-    contentWidth: number;
-    /** 内容区总高度（像素） */
-    contentHeight: number;
-    /** 内容区 X 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
-    contentOffsetX?: number;
-    /** 内容区 Y 偏移 */
-    contentOffsetY?: number;
-    /** 是否启用 hover 事件 */
-    enableHover?: boolean;
-    /**
-     * 是否在 hover 时显示外沿描边（选中感高亮）。默认 true。
-     * 平面图只读态可由布局关闭，仅去掉描边，不影响 onItemHover。
-     */
-    itemHoverOutline?: boolean;
-    /** 点击回调 */
-    onItemClick?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
-    /** hover 进入 */
-    onItemHover?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
-    /** hover 离开 */
-    onItemLeave?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
-    /** 每项外层容器额外样式（与定位样式合并） */
-    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
-    /**
-     * 阅读态：与 {@link rowKey} 解析 id 相等的图元加选中外圈（如详情 Modal 打开时）。
-     */
-    readModeSelectedItemId?: string | null;
-    /**
-     * 与编辑态一致：在含 `data-pisell-floor-room-scroll-surface` 的区域内按下时置 true，
-     * 用于禁用 Transform 画布平移，避免图元内纵向滑动拖动画布。
-     */
-    onInteractionChange?: (active: boolean) => void;
-    className?: string;
-}
-export declare function ItemLayer<T extends FloorMapItemBase>(props: ItemLayerProps<T>): JSX.Element;
-export default ItemLayer;

package/es/components/pisellFloorMapLayout/components/NodePortMarkers.d.ts

@@ -1,20 +0,0 @@
-/**
- * NodePortMarkers - 选中图元时显示四向锚点，用于拉线
- */
-import React from 'react';
-import type { FloorMapEdgeAnchor } from '../types';
-import { type FloorMapItemPixelRect } from '../utils/edgeRouting';
-import './NodePortMarkers.less';
-export interface NodePortMarkersProps {
-    rect: FloorMapItemPixelRect;
-    contentOffsetX?: number;
-    contentOffsetY?: number;
-    /** 仅展示/高亮（拉线吸附目标），不可点击 */
-    previewOnly?: boolean;
-    onAnchorPointerDown?: (anchor: FloorMapEdgeAnchor, event: React.PointerEvent) => void;
-    highlightAnchors?: FloorMapEdgeAnchor[];
-    className?: string;
-    /** 画布 viewport scale，用于把圆点和外移距离按 1/scale 反向缩放，保持视觉尺寸恒定 */
-    viewportScale?: number;
-}
-export declare function NodePortMarkers(props: NodePortMarkersProps): JSX.Element;

package/es/components/pisellFloorMapLayout/components/ViewControls.d.ts

@@ -1,61 +0,0 @@
-/**
- * ViewControls - 内置视图控制：默认仅缩放；可选复位、区域定位、全屏等
- * 平面图（dockChrome）：Dock 折叠入口 + 展开条（含业务插槽、空闲自动收起）
- * 非平面图：单条横栏，缩放与工具始终同排（无 Menu 折叠）
- */
-import React from 'react';
-import type { FloorMapControlsConfig } from '../types';
-import './ViewControls.less';
-/** 从 react-zoom-pan-pinch 拿到的控制 API（由主组件传入） */
-export interface ViewControlsApi {
-    zoomIn: () => void;
-    zoomOut: () => void;
-    resetTransform: () => void;
-    /** 区域定位，可能由主组件基于 items 计算后封装 */
-    fitBounds?: () => void;
-    /** 切换全屏（requestFullscreen / exitFullscreen） */
-    toggleFullscreen?: () => void;
-}
-export interface ViewControlsProps {
-    /** 控制 API */
-    api: ViewControlsApi;
-    /** 显隐配置 */
-    config?: FloorMapControlsConfig;
-    /** 当前缩放比例（1 = 100%），用于 Stepper 展示 */
-    scale?: number;
-    /** 当前是否处于全屏 */
-    isFullscreen?: boolean;
-    /** 当前 transform 是否处于「适配视口」结果（用于按钮激活态） */
-    fitBoundsActive?: boolean;
-    className?: string;
-    /** 与 config.showGridToggle 联用：当前画布是否显示网格 */
-    mapGridVisible?: boolean;
-    /** 切换当前画布 draft 的 mapLayer.showGrid */
-    onToggleMapGrid?: () => void;
-    /** 当前是否显示连线层（与 `enableEdges` 联用） */
-    edgesLayerVisible?: boolean;
-    /** 切换连线层显隐；未传时不展示连线开关 */
-    onToggleEdgesLayer?: () => void;
-    /**
-     * 视口锁定态：true 时显示「已锁定」图标，并禁用所有改变视角的按钮
-     * （zoom +/- / reset / fitBounds）。pan / wheel / pinch 由调用方在 TransformWrapper 上同步关闭。
-     */
-    viewportLocked?: boolean;
-    /** 切换视口锁定；未传时不展示锁定按钮 */
-    onToggleViewportLock?: () => void;
-    /**
-     * 平面图 Dock：圆角浅底样式，默认折叠为单入口；展开后含缩放、工具、全屏与 dockExpandedTrailing
-     */
-    dockChrome?: boolean;
-    /** Dock 展开区内、与缩放/网格等按钮平级的业务工具按钮 */
-    dockExpandedToolButtons?: React.ReactNode;
-    /** Dock 展开区最右侧业务插槽（如「编辑画布」） */
-    dockExpandedTrailing?: React.ReactNode;
-    /**
-     * Dock 展开后无操作自动收起（毫秒）；0 表示不自动收起
-     * @default 10000
-     */
-    autoCollapseDockMs?: number;
-}
-export declare function ViewControls(props: ViewControlsProps): JSX.Element | null;
-export default ViewControls;

package/es/components/pisellFloorMapLayout/components/ViewControlsWithZoom.d.ts

@@ -1,28 +0,0 @@
-/**
- * 在 TransformWrapper 内用 useControls 拿到 zoom 控制并渲染 ViewControls，确保点击加减能缩放
- */
-import React from 'react';
-import type { FloorMapControlsConfig } from '../types';
-export interface ViewControlsWithZoomProps {
-    config?: FloorMapControlsConfig;
-    scale?: number;
-    isFullscreen?: boolean;
-    /** 当前 transform 是否吻合「适配视口」结果，用于按钮激活态 */
-    fitBoundsActive?: boolean;
-    fitBounds: () => void;
-    /** 未传时不展示全屏按钮（如编辑态 floorMapFullscreenMode 为 disabled） */
-    toggleFullscreen?: () => void;
-    mapGridVisible?: boolean;
-    onToggleMapGrid?: () => void;
-    edgesLayerVisible?: boolean;
-    onToggleEdgesLayer?: () => void;
-    /** 视口锁定态（true 时所有视角写入入口被禁用） */
-    viewportLocked?: boolean;
-    /** 切换视口锁定；未传时不展示锁定按钮 */
-    onToggleViewportLock?: () => void;
-    dockChrome?: boolean;
-    dockExpandedToolButtons?: React.ReactNode;
-    dockExpandedTrailing?: React.ReactNode;
-    autoCollapseDockMs?: number;
-}
-export declare function ViewControlsWithZoom(props: ViewControlsWithZoomProps): JSX.Element;

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

@@ -1,23 +0,0 @@
-/**
- * 楼层图布局子组件导出
- */
-export { MapLayer } from './MapLayer';
-export { ItemLayer } from './ItemLayer';
-export { ViewControls } from './ViewControls';
-export { ViewControlsWithZoom } from './ViewControlsWithZoom';
-export { CanvasTabs } from './CanvasTabs';
-export { EditableItemLayer } from './EditableItemLayer';
-export { FloorMapToolbar } from './FloorMapToolbar';
-export { FloorMapEditTopBar } from './FloorMapEditTopBar';
-export { FloorMapEditPanel } from './FloorMapEditPanel';
-export { FloorMapDataForm } from './FloorMapDataForm';
-export { FloorMapOverview } from './FloorMapOverview';
-export type { ViewControlsApi } from './ViewControls';
-export type { ViewControlsWithZoomProps } from './ViewControlsWithZoom';
-export type { CanvasTabsProps } from './CanvasTabs';
-export type { EditableItemLayerProps } from './EditableItemLayer';
-export type { FloorMapToolbarProps, PlaceMode } from './FloorMapToolbar';
-export type { FloorMapEditTopBarProps, FloorMapEditTopBarMode, } from './FloorMapEditTopBar';
-export type { FloorMapEditPanelProps } from './FloorMapEditPanel';
-export type { FloorMapDataFormProps } from './FloorMapDataForm';
-export type { FloorMapOverviewProps } from './FloorMapOverview';

package/es/components/pisellFloorMapLayout/context/mergeFloorMapLayoutContext.d.ts

@@ -1,5 +0,0 @@
-import type { FloorMapItemBase, FloorMapLayoutContextValue, PisellFloorMapLayoutProps } from '../types';
-/**
- * 将 `FloorMapLayoutContext` 与 Layout props 合并：各字段 props ?? ctx，props 显式值优先。
- */
-export declare function mergeFloorMapLayoutPropsFromContext<T extends FloorMapItemBase>(props: PisellFloorMapLayoutProps<T>, ctx: FloorMapLayoutContextValue | undefined): PisellFloorMapLayoutProps<T>;

package/es/components/pisellFloorMapLayout/floorMapLayoutConstants.d.ts

@@ -1,35 +0,0 @@
-/**
- * 平面图布局根节点 BEM 前缀，与 `PisellFloorMapLayout.less` 中主 class 一致。
- */
-export declare const FLOOR_MAP_LAYOUT_CLASS_PREFIX = "pisell-floor-map-layout";
-/** 手机左侧图元栏 Drawer，低于右侧属性抽屉 */
-export declare const FLOOR_MAP_PHONE_TOOLBAR_DRAWER_Z_INDEX = 2001;
-/** 手机右侧图元详情 Drawer */
-export declare const FLOOR_MAP_PHONE_EDIT_DRAWER_Z_INDEX = 2002;
-/**
- * 高于 {@link FLOOR_MAP_PHONE_EDIT_DRAWER_Z_INDEX}，用于面板内 Popconfirm 等，避免被抽屉挡住。
- */
-export declare const FLOOR_MAP_CONFIRM_OVERLAY_Z_INDEX = 2100;
-/**
- * 「全览」伪画布 Tab id。
- * 仅在阅读态、启用画布 > 1 时插入到画布 Tab 列表末尾，用来承载「同时查看所有画布」的入口。
- * 不会写入 `config.canvases`，也不参与视口持久化、items 计算等真实画布逻辑。
- */
-export declare const FLOOR_MAP_OVERVIEW_TAB_ID = "__pisell_floor_map_overview__";
-/**
- * 全览视图：每个画布区块上方预留的标题带高度（像素）。
- * 装箱时计入画布有效高度，保证画布之间的 gap 能容纳外置标题条。
- */
-export declare const FLOOR_MAP_OVERVIEW_TITLE_BAND_HEIGHT = 36;
-/** 全览视图：画布区块之间的最小间距（像素，含标题带外的净距） */
-export declare const FLOOR_MAP_OVERVIEW_AREA_GAP = 40;
-/**
- * 编辑态侧栏调色板：每个分类直接展示的图元数量上限。
- * 超出时显示「查看全部」，在弹窗内选择数量并批量落点（所有分类通用）。
- */
-export declare const FLOOR_MAP_TOOLBAR_PALETTE_SIDEBAR_LIMIT = 5;
-/**
- * 右下 ViewControls Dock 底部留白（px）：`bottom: 14` + chrome `56` + 与面板间距 `8`。
- * 编辑/连线属性面板滚动区 `padding-bottom` 引用同名 CSS 变量。
- */
-export declare const FLOOR_MAP_VIEWPORT_DOCK_BOTTOM_CLEARANCE = 78;

package/es/components/pisellFloorMapLayout/hooks/useFloorMapEdgeEditing.d.ts

@@ -1,61 +0,0 @@
-import type { MutableRefObject } from 'react';
-import type { FloorMapEdge, FloorMapEdgeAnchor, FloorMapItemBase, FloorMapMergedItem, FloorMapViewConfig } from '../types';
-import { type FloorMapItemPixelRect } from '../utils/edgeRouting';
-export interface FloorMapEdgeDrawingState {
-    fromInstanceId: string;
-    fromAnchor: FloorMapEdgeAnchor;
-}
-export interface UseFloorMapEdgeEditingParams<T extends FloorMapItemBase> {
-    enabled: boolean;
-    config: FloorMapViewConfig | null;
-    items: T[];
-    mergedItems: FloorMapMergedItem[];
-    cellSize: number;
-    itemUnit: 'cell' | 'pixel';
-    itemGap?: number;
-    contentOffsetRef: MutableRefObject<{
-        x: number;
-        y: number;
-    }>;
-    selectedId: string | null;
-    setSelectedId: (id: string | null) => void;
-    commitDraft: (updater: FloorMapViewConfig | ((prev: FloorMapViewConfig) => FloorMapViewConfig)) => void;
-    /** 画布内容区 DOM，用于 client → 内容坐标 */
-    mapContentRef: MutableRefObject<HTMLElement | null>;
-    scale?: number;
-}
-export declare function useFloorMapEdgeEditing<T extends FloorMapItemBase>(params: UseFloorMapEdgeEditingParams<T>): {
-    edges: FloorMapEdge[];
-    routes: import("../utils/edgeRouting").FloorMapEdgeRoute[];
-    rectsById: Map<string, FloorMapItemPixelRect>;
-    selectedEdgeId: string | null;
-    selectedEdge: FloorMapEdge | null;
-    selectedNodeRect: FloorMapItemPixelRect | null;
-    drawing: FloorMapEdgeDrawingState | null;
-    drawingTargetPreview: {
-        instanceId: string;
-        rect: FloorMapItemPixelRect;
-        anchor: FloorMapEdgeAnchor;
-    } | null;
-    ghostPathD: string | null;
-    selectNode: (id: string | null) => void;
-    selectEdge: (edgeId: string | null) => void;
-    clearEdgeSelection: () => void;
-    startDrawingFromAnchor: (instanceId: string, anchor: FloorMapEdgeAnchor) => void;
-    handleEdgeClick: (edgeId: string) => void;
-    handleMapBackgroundClick: () => void;
-    updateEdge: (edgeId: string, patch: Partial<FloorMapEdge>) => void;
-    deleteEdge: (edgeId: string) => void;
-    setPendingRectsById: import("react").Dispatch<import("react").SetStateAction<Record<string, Partial<FloorMapItemPixelRect>>>>;
-    startDraggingSegment: (params: {
-        edgeId: string;
-        role: 'first' | 'last' | 'inner';
-        segmentIndex: number;
-        axis: 'h' | 'v';
-        startPosition: number;
-        clientX: number;
-        clientY: number;
-        /** 用于计算 stub 长度上限 */
-        segmentLength?: number;
-    }) => void;
-};

package/es/components/pisellFloorMapLayout/hooks/useFloorMapEdgeViewModel.d.ts

@@ -1,15 +0,0 @@
-import type { FloorMapEdge, FloorMapEdgeRouting, FloorMapItemBase } from '../types';
-import { type FloorMapEdgeRoute, type FloorMapItemPixelRect } from '../utils/edgeRouting';
-export declare function useFloorMapEdgeViewModel<T extends FloorMapItemBase>(params: {
-    edges: FloorMapEdge[] | undefined;
-    items: T[];
-    cellSize: number;
-    itemUnit: 'cell' | 'pixel';
-    itemGap?: number;
-    pendingRectsById?: Record<string, Partial<FloorMapItemPixelRect>>;
-    /** 拖动中段手柄时的临时 routing 覆盖；优先于 edge.routing */
-    pendingRoutingByEdge?: Record<string, FloorMapEdgeRouting>;
-}): {
-    routes: FloorMapEdgeRoute[];
-    rectsById: Map<string, FloorMapItemPixelRect>;
-};

package/es/components/pisellFloorMapLayout/hooks/useFloorMapEditState.d.ts

@@ -1,79 +0,0 @@
-import type { MouseEvent, MutableRefObject } from 'react';
-import { type PlacementBoundingBox } from '../utils/batchScenePlacementLayout';
-import type { DataSourceFormColumn, FloorMapCanvasNameI18n, FloorMapDataSourceRecordFormContent, FloorMapDataSources, FloorMapItemBase, FloorMapMergedItem, FloorMapPlaceMode, FloorMapSceneElement, FloorMapViewConfig } from '../types';
-export interface UseFloorMapEditStateParams<T extends FloorMapItemBase> {
-    floorMapConfigProp: FloorMapViewConfig | undefined;
-    isFloorMapView: boolean;
-    itemsProp: T[];
-    cellSizeProp?: number;
-    dataSources: FloorMapDataSources | undefined;
-    onSave: ((config: FloorMapViewConfig) => void) | undefined;
-    onDataSourceRecordSave: ((dataSourceKey: string, id: string, newData: Record<string, unknown>) => void) | undefined;
-    dataSourceFormColumns: Record<string, DataSourceFormColumn[]> | undefined;
-    dataSourceRecordForm: Record<string, FloorMapDataSourceRecordFormContent> | undefined;
-    dataSourceLabels?: Record<string, string>;
-    layoutPrefix: string;
-    contentOffsetRef: MutableRefObject<{
-        x: number;
-        y: number;
-    }>;
-    showDataSourceRecordFormBlock?: boolean;
-    /** 批量落点后由布局层注入：将视口移至新增图元区域 */
-    focusViewportOnBoundsRef?: MutableRefObject<((bounds: PlacementBoundingBox) => void) | null>;
-}
-export declare function useFloorMapEditState<T extends FloorMapItemBase>(params: UseFloorMapEditStateParams<T>): {
-    config: FloorMapViewConfig | null;
-    currentCanvasId: string | null;
-    setCurrentCanvasId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    selectedId: string | null;
-    setSelectedId: import("react").Dispatch<import("react").SetStateAction<string | null>>;
-    placeMode: FloorMapPlaceMode;
-    setPlaceMode: import("react").Dispatch<import("react").SetStateAction<FloorMapPlaceMode>>;
-    mergedItems: FloorMapMergedItem[];
-    items: T[];
-    saving: boolean;
-    savingRecord: boolean;
-    handleAddCanvas: () => void;
-    handleRemoveCanvas: (canvasId: string) => void;
-    handleRenameCanvas: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
-    handleUpdateItem: (itemId: string, patch: Partial<{
-        x: number;
-        y: number;
-        width: number;
-        height: number;
-    }>) => void;
-    handleCanvasPlaceClick: (e: MouseEvent<HTMLDivElement>) => void;
-    handleSave: () => void;
-    discardDraft: () => void;
-    placeSceneElementFromPaletteDrop: (contentX: number, contentY: number, scene: Extract<FloorMapPlaceMode, {
-        type: 'scene';
-    }>) => boolean;
-    bulkPlacePaletteItems: (items: Array<{
-        elementKind: string;
-        builtinShapeKey?: string;
-    }>) => void;
-    editPanelParams: {
-        itemId: string;
-        sceneElement: FloorMapSceneElement;
-        onUpdate: (patch: Partial<FloorMapSceneElement>) => void;
-        onSaveRecord: ((dataSourceKey: string, id: string, newData: Record<string, unknown>) => void) | undefined;
-        onClose: () => void;
-        onDelete: (() => void) | undefined;
-        recordFormColumns: Record<string, DataSourceFormColumn[]> | undefined;
-        dataSourceRecordForm: Record<string, FloorMapDataSourceRecordFormContent> | undefined;
-        dataSourceLabels: Record<string, string> | undefined;
-        layoutDraftDirty: boolean;
-        showDataSourceRecordFormBlock: boolean | undefined;
-    } | null;
-    placeOverlayClass: string;
-    isLayoutDirty: boolean;
-    toggleDraftCanvasShowGrid: () => void;
-    toggleSelectedLayoutLock: () => void;
-    duplicateSelectedElement: () => void;
-    deleteSelectedElement: () => void;
-    undoDraft: () => void;
-    redoDraft: () => void;
-    canUndo: boolean;
-    canRedo: boolean;
-    commitDraft: (next: FloorMapViewConfig | ((prev: FloorMapViewConfig | null) => FloorMapViewConfig | null) | null, options?: import("./useDraftConfigHistory").DraftHistoryCommitOptions | undefined) => void;
-};

package/es/components/pisellFloorMapLayout/hooks/useFloorMapTransformMetrics.d.ts

@@ -1,91 +0,0 @@
-import type { MutableRefObject } from 'react';
-import type { FloorMapItemBase, FloorMapItemUnit, FloorMapZoomConfig } from '../types';
-import type { PlacementBoundingBox } from '../utils/batchScenePlacementLayout';
-/** react-zoom-pan-pinch TransformWrapper render 注入的上下文 */
-export declare type FloorMapTransformContext = {
-    zoomIn: () => void;
-    zoomOut: () => void;
-    resetTransform: () => void;
-    /**
-     * react-zoom-pan-pinch v3 实际签名：(x, y, scale, animationTime?, animationType?)
-     * 默认 animationTime≈200ms；传 0 立即落点，避免被前一次动画吃掉或与之冲突
-     * （restore / 缓存恢复路径应使用 0 立即覆盖已在缓动中的 fit 动画）。
-     * 这里只暴露我们用到的前 4 参；库 animationType 是 `keyof typeof animations` 联合，
-     * 暴露过来反而限制传入对象的兼容性，我们也确实不传它。
-     */
-    setTransform: (x: number, y: number, scale: number, animationTime?: number) => void;
-} | null;
-export interface UseFloorMapTransformMetricsParams<T extends FloorMapItemBase> {
-    items: T[];
-    cellSize: number;
-    itemGap: number;
-    effectiveItemUnit: FloorMapItemUnit;
-    isFloorMapView: boolean;
-    mode: 'read' | 'edit';
-    zoom: FloorMapZoomConfig;
-    transformRef: MutableRefObject<FloorMapTransformContext>;
-    /** 由父组件创建并传入 useFloorMapEditState，本 hook 每帧写入内容区偏移 */
-    contentOffsetRef: MutableRefObject<{
-        x: number;
-        y: number;
-    }>;
-    /** 与 mapLayer.boundingPadding 一致；未传用 DEFAULT_BOUNDING_PADDING */
-    boundingPadding?: number;
-    /**
-     * 平面图：当前画布 id（或其它在切换画布时应重置平移/对齐会话的 key）。
-     * 不传则不跑「异步加载图元后的首次左上对齐」逻辑。
-     */
-    frameResetKey?: string;
-    /**
-     * 视口持久化标识（通常拼自 canvasId）。传入后：
-     *   - 切换 / 挂载时若 localStorage 中有缓存，自动恢复 transform 并跳过本帧 autoFit；
-     *   - 用户拖动 / 缩放时（节流 300ms）写回缓存；
-     *   - 主动 fitBounds / 进入伪全屏后由 fitBounds 触发的写入也会同步保存。
-     * 不传则完全不读不写 localStorage。
-     */
-    viewportPersistKey?: string;
-}
-export declare function useFloorMapTransformMetrics<T extends FloorMapItemBase>(params: UseFloorMapTransformMetricsParams<T>): {
-    containerRef: import("react").RefObject<HTMLDivElement>;
-    mapAreaRef: import("react").RefObject<HTMLDivElement>;
-    viewportSize: {
-        width: number;
-        height: number;
-    };
-    mapAreaSize: {
-        width: number;
-        height: number;
-    };
-    contentWidth: number;
-    contentHeight: number;
-    contentOffsetX: number;
-    contentOffsetY: number;
-    initialPositionX: number;
-    initialPositionY: number;
-    zoomConfig: {
-        initialScale: number;
-        minScale: number;
-        maxScale: number;
-        step: number;
-    };
-    scale: number;
-    setScale: import("react").Dispatch<import("react").SetStateAction<number>>;
-    isFullscreen: boolean;
-    toggleFullscreen: () => void;
-    fitBounds: () => boolean;
-    focusContentBounds: (bounds: PlacementBoundingBox | null) => boolean;
-    isAtFitBounds: boolean;
-    notifyTransformed: (x: number, y: number, nextScale: number) => void;
-    persistCurrentViewport: () => void;
-    attachTransformContext: (ctx: NonNullable<FloorMapTransformContext>) => void;
-    lastTransformRef: MutableRefObject<{
-        x: number;
-        y: number;
-        scale: number;
-    }>;
-    isInteractingWithElement: boolean;
-    setIsInteractingWithElement: import("react").Dispatch<import("react").SetStateAction<boolean>>;
-    viewportLocked: boolean;
-    setViewportLocked: (next: boolean) => void;
-    toggleViewportLocked: () => void;
-};

package/es/components/pisellFloorMapLayout/hooks/useShopFloorPlanSubscription.d.ts

@@ -1,19 +0,0 @@
-import type { ShopFloorPlanDetail } from '../shopFloorPlan/shopFloorPlanTypes';
-import type { ShopFloorPlanByCodeRequestOptions } from '../shopFloorPlan/shopFloorPlanTypes';
-export declare type UseShopFloorPlanSubscriptionParams = {
-    /** `null` 时不发起请求（与预约页 `resolvedFloorPlanId` 一致）；清空状态由调用方处理 */
-    enabled: boolean;
-    code: string;
-    subscriberId: string;
-    ensureByCode: (code: string, opts?: ShopFloorPlanByCodeRequestOptions) => Promise<ShopFloorPlanDetail | null>;
-    unsubscribeQuery: (subscriberId: string) => Promise<void>;
-    onDetail: (detail: ShopFloorPlanDetail) => void;
-    onLoadError?: (err: unknown) => void;
-    /** 与预约一致：默认 true */
-    osServer?: boolean;
-};
-/**
- * 按 code 订阅店铺平面图：首包 Promise + WebSocket callback 均归一为 `onDetail`。
- * 不包含与业务默认 {@link FloorMapViewConfig} 的合并（由调用方在 `onDetail` 或后续 useMemo 完成）。
- */
-export declare function useShopFloorPlanSubscription(params: UseShopFloorPlanSubscriptionParams): void;