@pisell/materials 6.11.241 → 6.11.242

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

@@ -0,0 +1,84 @@
+/**
+ * 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): React.JSX.Element;
+export default FloorMapToolbar;

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

@@ -0,0 +1,20 @@
+/**
+ * 侧栏 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): React.JSX.Element;
+export default FloorMapToolbarViewAllModal;

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

@@ -0,0 +1,94 @@
+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>;
+    /**
+     * 网格显隐缓存命名空间（通常与视口 `viewportPersistNamespace` 同源，拼自业务/门店/平面图）。
+     * 传入后网格 localStorage key 变为 `prefix:namespace:canvasId`，隔离不同门店/场景；
+     * 不传则沿用 `prefix:canvasId`（向后兼容，跨场景可能共享）。
+     */
+    gridPersistNamespace?: string;
+}
+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;
+    handleUpdateItemsBatch: (patches: Array<{
+        id: 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/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * PisellFloorMapLayout 组件入口
+ * 空间布局视图：在二维平面按坐标渲染资源，支持缩放/平移/复位；支持 floorMapConfig + mode 平面图视图
+ */
+export { PisellFloorMapLayout } from './PisellFloorMapLayout';
+export type { PisellFloorMapLayoutProps, PisellFloorMapLayoutRef, FloorMapItemBase, FloorMapItemUnit, FloorMapLayerConfig, FloorMapZoomConfig, FloorMapPanConfig, FloorMapControlsConfig, FloorMapItemShape, FloorMapBackgroundType, FloorMapPanBoundary, FloorMapLayoutMode, FloorMapGridLayoutConfig, FloorMapCanvas, FloorMapCanvasNameI18n, FloorMapElement, FloorMapData, FloorMapViewConfig, FloorMapCanvasUiConfig, FloorMapSceneElement, FloorMapSceneElementDataBinding, FloorMapPlaceMode, FloorMapElementKindCategory, FloorMapElementDataBindingPolicy, FloorMapElementDefaultPresentation, FloorMapEdge, FloorMapEdgeAnchor, FloorMapEdgeStatus, FloorMapElementKindConfig, FloorMapElementType, FloorMapTextSlot, FloorMapDataSources, FloorMapRenderOptions, FloorMapEditPanelParams, DataSourceFormColumn, FloorMapMergedItem, FloorMapRecordFormRenderContext, FloorMapDataSourceRecordFormContent, FloorMapFullscreenMode, FloorMapLayoutContextValue, FloorMapViewportOverlayRenderArgs, } from './types';
+export { FLOOR_MAP_STAGE_ELEMENT_KIND, FLOOR_MAP_SELECTION_ZONE_ELEMENT_KIND, FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_BUILTIN_SHAPE_ELEMENT_KIND, } from './types';
+export { renderFloorMapFallbackPlaceholder } from './utils/floorMapFallbackRender';
+export { isFloorMapImageElementKind, isFloorMapBuiltinShapeElementKind, } from './utils/floorMapElementKindUtils';
+export { FLOOR_MAP_BUILTIN_SHAPES, getFloorMapBuiltinShapeDef, } from './utils/floorMapBuiltinShapes';
+export type { FloorMapBuiltinShapeDef, FloorMapBuiltinShapeRenderProps, } from './utils/floorMapBuiltinShapes';
+export { NAME_AS_TITLE_EXT_KEY, isElementNameAsTitleEnabled, buildNameAsTitleExtensionsPatch, resolveSceneElementDisplayTitle, } from './utils/floorMapElementNameAsTitle';
+export { findFloorMapRowByDataBinding, getFloorMapBindingPlaceholderReason, } from './utils/floorMapDataBindingUtils';
+export type { FloorMapDataSourceRow, FloorMapBindingPlaceholderReason, } from './utils/floorMapDataBindingUtils';
+export { createShopFloorPlanClient, SHOP_FLOOR_PLAN_DUPLICATE_CODE, } from './shopFloorPlan/shopFloorPlanClient';
+export type { ShopFloorPlanDetail, ShopFloorPlanLayoutItem, PostShopFloorPlanBody, PutShopFloorPlanBody, ShopFloorPlanByCodeRequestOptions, ShopFloorPlanHttpAdapter, CreateShopFloorPlanClientOptions, EnsureShopFloorPlanByCodeOptions, } from './shopFloorPlan/shopFloorPlanTypes';
+export type { UseShopFloorPlanSubscriptionParams } from './hooks/useShopFloorPlanSubscription';
+export { pickFloorPlanDetail, parseLayoutFieldToViewConfigPatch, mergeFloorPlanViewRemote, floorMapSavedConfigToRemotePatch, viewConfigToLayoutPayload, inferCanvasSizeFromScene, buildFloorPlanPutBody, isShopFloorPlanNotFoundResponse, isHttpNotFoundError, isFloorPlanDuplicateCodeError, } from './shopFloorPlan/shopFloorPlanPure';
+export { sceneElementsToShopLayout, shopLayoutToSceneElements, } from './shopFloorPlan/shopFloorPlanMapping';
+export { useShopFloorPlanSubscription } from './hooks/useShopFloorPlanSubscription';
+export { wrapFloorMapOnSaveWithRemotePersist, } from './utils/floorMapRemotePersist';
+export type { WrapFloorMapOnSaveWithRemotePersistParams } from './utils/floorMapRemotePersist';
+export { FloorMapLayoutProvider, useFloorMapLayoutContext, EMPTY_FLOOR_MAP_LAYOUT_CONTEXT, } from './context/FloorMapLayoutContext';
+export type { FloorMapLayoutProviderProps } from './context/FloorMapLayoutContext';
+export { mergeFloorMapLayoutPropsFromContext } from './context/mergeFloorMapLayoutContext';
+export type { FloorMapResourcePickerSlotProps, PisellCardPickerItem, PisellCardPickerMode, PisellCardPickerCategoryConfig, PisellCardPickerCategoryLevelConfig, PisellCardPickerCategoryPath, PisellCardPickerCategoryMode, PisellCardPickerCardMeta, } from './utils/floorMapResourcePickerTypes';
+export { parseNestedPathSegments } from './utils/floorMapResourcePickerTypes';
+export type { FloorMapResourcePickerRecord } from './utils/floorMapResourcePickerDisplay';
+export { getFloorMapResourcePickerCardMeta, getFloorMapCardPickerCategoryConfig, getFloorMapResourcePickerCategoryPath, floorMapResourcePickerRecordSearchText, } from './utils/floorMapResourcePickerDisplay';
+export { getFloorMapDisplayLocale, initFloorMapLayoutLocales, } from './utils/floorMapCanvasDisplay';
+/** 平面图内置文案表，供跨包组件在本包 `locales` 单例上自行 init */
+export { default as floorMapLayoutLocales } from './locales';
+export { FloorMapImageElement } from './components/FloorMapImageElement';
+export { FloorMapBuiltinShapeElement } from './components/FloorMapBuiltinShapeElement';
+export { FloorMapSelectionZoneElement } from './components/FloorMapSelectionZoneElement';
+export { isSelectionZoneItem, rectFullyContains, computeSelectionZoneMemberIds, } from './utils/floorMapSelectionZone';
+export type { SelectionZoneRect } from './utils/floorMapSelectionZone';
+export { getFigmaTableCardFromMerged, renderFigmaStyleTableCard, renderFigmaStyleRoundTableCard, getRenderItemByKindTable, getRenderItemByKindRoundTable, } from './components/FigmaTableCard';
+export type { FigmaTableCardItem, FigmaTableStatus, } from './components/FigmaTableCard';

package/es/components/pisellFloorMapLayout/shopFloorPlan/shopFloorPlanClient.d.ts

@@ -0,0 +1,10 @@
+import type { CreateShopFloorPlanClientOptions, EnsureShopFloorPlanByCodeOptions, PostShopFloorPlanBody, PutShopFloorPlanBody, ShopFloorPlanByCodeRequestOptions, ShopFloorPlanDetail } from './shopFloorPlanTypes';
+export { SHOP_FLOOR_PLAN_DUPLICATE_CODE } from './shopFloorPlanTypes';
+export declare function createShopFloorPlanClient(options: CreateShopFloorPlanClientOptions): {
+    unsubscribeShopFloorPlanCodeQuery(subscriberId: string): Promise<void>;
+    getShopFloorPlanByCode(code: string, subscribe?: ShopFloorPlanByCodeRequestOptions): Promise<ShopFloorPlanDetail | null>;
+    postShopFloorPlan: (body: PostShopFloorPlanBody) => Promise<ShopFloorPlanDetail | null>;
+    putShopFloorPlan(id: number, body: PutShopFloorPlanBody): Promise<unknown>;
+    ensureShopFloorPlanByCode: (code: string, subscribe?: EnsureShopFloorPlanByCodeOptions) => Promise<ShopFloorPlanDetail | null>;
+};
+export declare type ShopFloorPlanClient = ReturnType<typeof createShopFloorPlanClient>;

package/es/components/pisellFloorMapLayout/shopFloorPlan/shopFloorPlanPure.d.ts

@@ -0,0 +1,22 @@
+import type { FloorMapSceneElement, FloorMapViewConfig } from '../types';
+import type { PutShopFloorPlanBody, ShopFloorPlanDetail } from './shopFloorPlanTypes';
+export declare function pickFloorPlanDetail(res: unknown): ShopFloorPlanDetail | null;
+export declare function isShopFloorPlanNotFoundResponse(res: unknown): boolean;
+export declare function isHttpNotFoundError(err: unknown): boolean;
+export declare function isFloorPlanDuplicateCodeError(err: unknown): boolean;
+export declare function parseLayoutFieldToViewConfigPatch(raw: unknown): Partial<FloorMapViewConfig> | null;
+export declare function floorMapSavedConfigToRemotePatch(config: FloorMapViewConfig): Partial<FloorMapViewConfig>;
+export declare function mergeFloorPlanViewRemote(base: FloorMapViewConfig, remote: Partial<FloorMapViewConfig>): FloorMapViewConfig;
+export declare function viewConfigToLayoutPayload(config: FloorMapViewConfig): Record<string, unknown>;
+export declare function inferCanvasSizeFromScene(sceneElements: FloorMapSceneElement[], fallbackWidth?: number, fallbackHeight?: number, padding?: number): {
+    w: number;
+    h: number;
+};
+export declare function buildFloorPlanPutBody(config: FloorMapViewConfig, options: {
+    canvasWidth?: number;
+    canvasHeight?: number;
+    code?: string;
+    name?: Record<string, string>;
+    sort?: number;
+    status?: number;
+}): PutShopFloorPlanBody;