@pisell/materials 6.11.241 → 6.11.243

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