@pisell/materials 6.11.223 → 6.11.224

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

@@ -0,0 +1,61 @@
+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/lib/components/pisellFloorMapLayout/hooks/useFloorMapEdgeViewModel.d.ts

@@ -0,0 +1,15 @@
+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/lib/components/pisellFloorMapLayout/hooks/useFloorMapTransformMetrics.d.ts

@@ -0,0 +1,91 @@
+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/lib/components/pisellFloorMapLayout/hooks/useShopFloorPlanSubscription.d.ts

@@ -0,0 +1,19 @@
+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;

package/lib/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/lib/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/lib/components/pisellFloorMapLayout/shopFloorPlan/shopFloorPlanMapping.d.ts

@@ -0,0 +1,18 @@
+import type { FloorMapSceneElement } from '../types';
+import type { ShopFloorPlanLayoutItem } from './shopFloorPlanTypes';
+/**
+ * 将场景图元转为后端 layout 项（多画布时通常摊平到同一 layout）。
+ */
+export declare function sceneElementsToShopLayout(sceneElements: FloorMapSceneElement[]): ShopFloorPlanLayoutItem[];
+export declare type ShopLayoutToSceneOptions = {
+    canvasId: string;
+    dataSourceKey: string;
+    /** 后端 `type: rect` 映射到的 {@link FloorMapSceneElement.elementKind} */
+    rectElementKind: string;
+    /** 后端 `type: circle` 映射到的 elementKind */
+    circleElementKind: string;
+};
+/**
+ * 将扁平 layout 数组转为 `sceneElements`；图元种类由调用方传入（预约场景可传 boundTable / boundRoundTable 等）。
+ */
+export declare function shopLayoutToSceneElements(layout: ShopFloorPlanLayoutItem[], options: ShopLayoutToSceneOptions): FloorMapSceneElement[];

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