@pisell/materials 1.8.25 → 1.8.27

package/lib/components/pisell-config-provider/context.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+export interface PisellContextType {
+    platform: 'h5' | 'pc' | 'ipad';
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    /** 获取货币符号 */
+    getSymbolic?: () => string;
+}
+export declare const PisellContext: import("react").Context<PisellContextType>;
+/**
+ * provider外获取当前全局配置
+ */
+declare class GlobalConfig {
+    private config;
+    constructor();
+    setConfig(config: PisellContextType): void;
+    getConfig(): PisellContextType;
+}
+export declare const globalConfig: GlobalConfig;
+export default PisellContext;

package/lib/components/pisell-config-provider/index.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { PisellContextType } from './context';
+interface PisellConfigProviderType {
+    platform?: PisellContextType['platform'];
+    children: React.ReactNode;
+    /** 货币符号 */
+    symbol?: string;
+    /** 当前语言环境 */
+    locale?: string;
+    getSymbolic?: () => string;
+}
+declare const PisellConfigProvider: React.FC<PisellConfigProviderType>;
+export default PisellConfigProvider;

package/lib/components/pisellAdjustPrice/PisellAdjustPriceInputNumber.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { InputNumberProps } from 'antd/es/input-number';
 export interface PisellAdjustPriceInputNumberProps extends Omit<InputNumberProps, 'onChange'> {
     value?: number;
@@ -5,5 +6,5 @@ export interface PisellAdjustPriceInputNumberProps extends Omit<InputNumberProps
     defaultValue?: number;
     onChange?: (val: number) => void;
 }
-declare const PisellAdjustPriceInputNumber: (props: PisellAdjustPriceInputNumberProps) => JSX.Element;
+declare const PisellAdjustPriceInputNumber: (props: PisellAdjustPriceInputNumberProps) => React.JSX.Element;
 export default PisellAdjustPriceInputNumber;

package/lib/components/pisellAdjustPrice/index.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import './index.less';
+import { PisellAdjustPriceProps } from './type';
+declare const PisellAdjustPrice: (props: PisellAdjustPriceProps) => React.JSX.Element;
+export default PisellAdjustPrice;

package/lib/components/pisellAdjustPrice/status.d.ts

@@ -0,0 +1,32 @@
+export declare const defaultConfig: {
+    dark: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+    light: {
+        backgroundColor: string;
+        containerBackgroundColor: string;
+        buttonBackgroundColor: string;
+        textColor: string;
+        resetButtonBackgroundColor: string;
+        resetButtonTextColor: string;
+        isDoneButtonFollowTheme: boolean;
+        doneButtonBackgroundColor: string;
+        doneButtonTextColor: string;
+        isShowMainText: boolean;
+        mainTextColor: string;
+        isShowSubText: boolean;
+        subTextColor: string;
+    };
+};

package/lib/components/pisellAdjustPrice/type.d.ts

@@ -0,0 +1,22 @@
+export interface PisellAdjustPriceProps {
+    value?: number;
+    originValue: number;
+    defaultValue?: number;
+    onChange?: (val: number) => void;
+    selectType?: 'light' | 'dark';
+    backgroundColor?: string;
+    containerBackgroundColor?: string;
+    buttonBackgroundColor?: string;
+    textColor?: string;
+    resetButtonBackgroundColor?: string;
+    resetButtonTextColor?: string;
+    isDoneButtonFollowTheme?: boolean;
+    doneButtonBackgroundColor?: string;
+    doneButtonTextColor?: string;
+    isShowMainText?: boolean;
+    mainTextColor?: string;
+    isShowSubText?: boolean;
+    subTextColor?: string;
+    resetText?: string;
+    doneText?: string;
+}

package/lib/components/pisellAlert/index.d.ts

@@ -18,5 +18,5 @@ export interface PisellAlertProps extends AlertProps {
  * @param props
  * @constructor
  */
-declare const PisellAlert: (props: PisellAlertProps) => false | JSX.Element;
+declare const PisellAlert: (props: PisellAlertProps) => false | React.JSX.Element;
 export default PisellAlert;

package/lib/components/pisellCard/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { CardProps } from 'antd';
 import './index.less';
 export interface PisellCardProps extends CardProps {
@@ -15,5 +16,5 @@ export interface PisellCardProps extends CardProps {
  * @param props
  * @constructor
  */
-declare const PisellCard: (props: PisellCardProps) => JSX.Element;
+declare const PisellCard: (props: PisellCardProps) => React.JSX.Element;
 export default PisellCard;

package/lib/components/pisellCheckboxGroup/index.d.ts

@@ -0,0 +1,40 @@
+import React from 'react';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellCheckboxGroupOption {
+    label: string;
+    value: string;
+    disabled?: boolean;
+    error?: boolean;
+    [key: string]: any;
+}
+declare type PisellCheckboxGroupValue = string | string[] | any;
+export interface PisellCheckboxGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    platform?: PisellContextType['platform'];
+    direction?: 'horizontal' | 'vertical';
+    fullWidth?: boolean;
+    gap?: number;
+    padding?: number;
+    options: PisellCheckboxGroupOption[];
+    onChange?: (value: PisellCheckboxGroupValue, item: PisellCheckboxGroupOption) => void;
+    value?: PisellCheckboxGroupValue;
+    renderOption?: (option: PisellCheckboxGroupOption, active: boolean, index: number) => React.ReactNode;
+    rowKey?: string;
+    mode?: 'multiple' | 'single';
+    iconPosition?: 'left' | 'right' | 'hide';
+    optionClassName?: string;
+    optionActiveClassName?: string;
+    onChangeDebounce?: boolean;
+    onItemClick?: (e: React.MouseEvent<HTMLDivElement>, option: PisellCheckboxGroupOption) => void;
+    showActiveBackground?: boolean;
+}
+/**
+ * @title: PisellCheckboxGroup
+ * @description: 选中组件
+ * @param {PisellCheckboxGroupProps} props
+ * @return {*}
+ * @Author: zhiwei.Wang
+ * @Date: 2024-08-16 10:34
+ */
+declare const PisellCheckboxGroup: (props: PisellCheckboxGroupProps) => React.JSX.Element;
+export default PisellCheckboxGroup;

package/lib/components/pisellCountdown/index.d.ts

@@ -20,5 +20,5 @@ export declare type PisellCountdownProps = React.HTMLAttributes<HTMLSpanElement>
     /** 格式化倒计时展示 参考 dayjs */
     format?: string;
 };
-declare const PisellCountdown: (props: PisellCountdownProps) => JSX.Element;
+declare const PisellCountdown: (props: PisellCountdownProps) => React.JSX.Element;
 export default PisellCountdown;

package/lib/components/pisellDataSourceContainer/PisellDataSourceContainer.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { DataSourceContainerProps } from './type';
-declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => JSX.Element;
+declare const PisellDataSourceContainer: (props: DataSourceContainerProps) => React.JSX.Element;
 export default PisellDataSourceContainer;

package/lib/components/pisellDataSourceContainer/components/Pagination/index.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { DataSourceContainerContextType } from '../../type';
+declare const _default: React.ForwardRefExoticComponent<Omit<Partial<import("antd").PaginationProps> & DataSourceContainerContextType & React.RefAttributes<unknown> & {
+    refId?: string | undefined;
+}, "ref"> & React.RefAttributes<any>>;
+export default _default;

package/lib/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -1,5 +1,6 @@
+/// <reference types="react" />
 declare const useDataSourceKey: () => {
-    dataSourceKey: string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined;
-    dataSourceKeyRef: import("react").MutableRefObject<string | import("../../dataSourceComponents/provider/dataSource/DataSourceContext").DataSourceType | undefined>;
+    dataSourceKey: string | undefined;
+    dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;
 };
 export default useDataSourceKey;

package/lib/components/pisellDataSourceContainer/provider/HandleActions.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import { DataSourceContainerProps, HandleActionContextType } from '../type';
 export declare const HandleActionContext: React.Context<HandleActionContextType | null>;
-export declare const HandleActionsProvider: (props: DataSourceContainerProps) => JSX.Element;
+export declare const HandleActionsProvider: (props: DataSourceContainerProps) => React.JSX.Element;
 export declare const useHandleActionProvider: () => HandleActionContextType;

package/lib/components/pisellDatePicker/datePickerCpt.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { PickerDateProps } from 'antd/es/date-picker/generatePicker';
 import { Dayjs } from 'dayjs';
 import './detePickerCpt.less';
@@ -17,5 +18,5 @@ export interface DatePickerCptProps extends PickerDateProps<Dayjs> {
  * @param props
  * @constructor
  */
-declare const DatePickerCpt: (props: DatePickerCptProps) => JSX.Element;
+declare const DatePickerCpt: (props: DatePickerCptProps) => React.JSX.Element;
 export default DatePickerCpt;

package/lib/components/pisellDatePicker/index.d.ts

@@ -1,2 +1,3 @@
-declare const PisellDatePicker: (props: any) => JSX.Element;
+/// <reference types="react" />
+declare const PisellDatePicker: (props: any) => import("react").JSX.Element;
 export default PisellDatePicker;

package/lib/components/pisellDraggable/components/Remove/Remove.d.ts

@@ -1,3 +1,3 @@
-/// <reference types="react" />
+import React from 'react';
 import { ActionProps } from '../Action';
-export declare function Remove(props: ActionProps): JSX.Element;
+export declare function Remove(props: ActionProps): React.JSX.Element;

package/lib/components/pisellDraggable/components/TreeItem/SortableTreeItem.d.ts

@@ -5,5 +5,5 @@ interface Props extends TreeItemProps {
     id: UniqueIdentifier;
     __designMode?: string;
 }
-declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => JSX.Element>;
+declare const _default: React.MemoExoticComponent<({ id, depth, ...props }: Props) => React.JSX.Element>;
 export default _default;

package/lib/components/pisellDraggable/index.d.ts

@@ -30,6 +30,6 @@ interface Props {
     /** 自定义拖拽判断函数，返回false时阻止拖拽 */
     canDrop?: (dragItem: FlattenedItem, dropTarget: FlattenedItem, parentId: UniqueIdentifier | null, parentNode: any) => boolean;
 }
-export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): JSX.Element;
-declare const Demo: (props: Props) => JSX.Element;
+export declare function SortableTree({ collapsible, value, indicator, indentationWidth, removable, renderItem, onChange, onRemoveBefore, __designMode, maxLevel, canDrop, }: Props): React.JSX.Element;
+declare const Demo: (props: Props) => React.JSX.Element;
 export default Demo;

package/lib/components/pisellDropSort/components/SortableItem/index.d.ts

@@ -22,5 +22,5 @@ interface SortableItemProps {
     /** 获取item样式 */
     getItemStyle?: (itemProps: TreeItem) => React.CSSProperties;
 }
-declare const SortableItem: (props: SortableItemProps) => JSX.Element;
+declare const SortableItem: (props: SortableItemProps) => React.JSX.Element;
 export default SortableItem;

package/lib/components/pisellEmpty/index.d.ts

@@ -15,5 +15,5 @@ export interface PisellEmptyProps extends EmptyProps {
     /** 最大宽度 */
     maxWidth?: number;
 }
-declare const PisellEmpty: (props: PisellEmptyProps) => JSX.Element;
+declare const PisellEmpty: (props: PisellEmptyProps) => React.JSX.Element;
 export default PisellEmpty;

package/lib/components/pisellFilter/index.d.ts

@@ -1,3 +1,4 @@
+import React from 'react';
 import { PisellFilterProps } from './type';
-declare const PisellFilter: (props: PisellFilterProps) => JSX.Element;
+declare const PisellFilter: (props: PisellFilterProps) => React.JSX.Element;
 export default PisellFilter;

package/lib/components/pisellFloatingPanel/index.d.ts

@@ -13,5 +13,5 @@ export interface PisellFloatingPanelProps {
     style?: React.CSSProperties;
     retractIconStyle?: React.CSSProperties;
 }
-declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => JSX.Element;
+declare const PisellFloatingPanel: (props: PisellFloatingPanelProps) => React.JSX.Element;
 export default PisellFloatingPanel;

package/lib/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -417,6 +417,20 @@ function PisellFloorMapLayoutInner(props, ref) {
   );
   const showSidebar = isFloorMapView && mode === "edit" && config && dataSources;
   const editPanelVisible = isFloorMapView && mode === "edit" && Boolean(editPanelParams) && Boolean(config) && Boolean(dataSources);
+  const handleMapAreaBackgroundClick = (0, import_react.useCallback)(
+    (e) => {
+      if (!isFloorMapView || mode !== "edit") return;
+      const t = e.target;
+      if (t.closest(`.${PREFIX}-editable-item`)) return;
+      if (t.closest(`.${PREFIX}-edit-panel-wrap`)) return;
+      if (t.closest(`.${PREFIX}-view-controls`)) return;
+      if (t.closest(`.${PREFIX}-viewport-overlay`)) return;
+      if (t.closest(`.${PREFIX}-place-overlay`)) return;
+      if (t.closest(`.${PREFIX}-map-drop-layer`)) return;
+      setSelectedId(null);
+    },
+    [isFloorMapView, mode, setSelectedId]
+  );
   return /* @__PURE__ */ import_react.default.createElement(
     "div",
     {
@@ -544,6 +558,7 @@ function PisellFloorMapLayoutInner(props, ref) {
             minWidth: 0,
             overflow: "hidden"
           },
+          onClick: handleMapAreaBackgroundClick,
           onDragEnter: (e) => {
             if (!isFloorMapView || mode !== "edit") return;
             if (!(0, import_floorMapDropUtils.isFloorMapPaletteDrag)(e.dataTransfer)) return;
@@ -576,6 +591,7 @@ function PisellFloorMapLayoutInner(props, ref) {
             initialPositionY,
             minScale: zoomConfig.minScale,
             maxScale: zoomConfig.maxScale,
+            limitToBounds: pan.boundary !== "none",
             ...{ step: zoomConfig.step },
             panning: {
               disabled: pan.enabled === false || isInteractingWithElement,

package/lib/components/pisellFloorMapLayout/components/CanvasTabs.d.ts

@@ -1,4 +1,9 @@
-/// <reference types="react" />
+/**
+ * CanvasTabs - 多画布 Tab，支持切换、动态添加、删除与重命名（编辑态）
+ * - 展示名：可选 `nameKey` + `locales.getText`，否则用 `name`（字符串或多语言对象）
+ * - 角标：可选 `tabBadge` 或由布局层注入合并后的数量
+ */
+import React from 'react';
 import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
 import './CanvasTabs.less';
 export interface CanvasTabsProps {
@@ -18,5 +23,5 @@ export interface CanvasTabsProps {
     onRenameCanvas?: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
     className?: string;
 }
-export declare function CanvasTabs(props: CanvasTabsProps): JSX.Element;
+export declare function CanvasTabs(props: CanvasTabsProps): React.JSX.Element;
 export default CanvasTabs;

package/lib/components/pisellFloorMapLayout/components/EditableItemLayer.d.ts

@@ -42,5 +42,5 @@ export interface EditableItemLayerProps<T extends FloorMapItemBase = FloorMapMer
         onDelete: () => void;
     } | null;
 }
-export declare function EditableItemLayer<T extends FloorMapItemBase>(props: EditableItemLayerProps<T>): JSX.Element;
+export declare function EditableItemLayer<T extends FloorMapItemBase>(props: EditableItemLayerProps<T>): React.JSX.Element;
 export default EditableItemLayer;

package/lib/components/pisellFloorMapLayout/components/EditableItemLayer.js

@@ -172,13 +172,6 @@ function EditableItemLayer(props) {
     },
     [items, getItemStyle, onInteractionChange]
   );
-  const handleCanvasHitClick = (0, import_react.useCallback)(
-    (e) => {
-      if (e.target !== e.currentTarget) return;
-      onSelect(null);
-    },
-    [onSelect]
-  );
   import_react.default.useEffect(() => {
     if (!interaction) return;
     const onMove = (e) => {
@@ -263,6 +256,7 @@ function EditableItemLayer(props) {
   const handleItemClick = (0, import_react.useCallback)(
     (e, item) => {
       if (interaction) return;
+      e.stopPropagation();
       onSelect(item.id);
     },
     [interaction, onSelect]
@@ -336,14 +330,6 @@ function EditableItemLayer(props) {
     getMergedItemWrapperStyle,
     editQuickBar
   ]);
-  const canvasHitLayer = /* @__PURE__ */ import_react.default.createElement(
-    "div",
-    {
-      className: `${PREFIX}-editable-canvas-hit`,
-      onClick: handleCanvasHitClick,
-      "aria-hidden": true
-    }
-  );
   return /* @__PURE__ */ import_react.default.createElement(
     "div",
     {
@@ -371,9 +357,8 @@ function EditableItemLayer(props) {
           transform: `translate(${contentOffsetX}px, ${contentOffsetY}px)`
         }
       },
-      canvasHitLayer,
       itemNodes
-    ) : /* @__PURE__ */ import_react.default.createElement(import_react.default.Fragment, null, canvasHitLayer, itemNodes)
+    ) : itemNodes
   );
 }
 var EditableItemLayer_default = EditableItemLayer;

package/lib/components/pisellFloorMapLayout/components/EditableItemLayer.less

@@ -1,18 +1,6 @@
-/* 根节点不拦截事件；空白处点击由 .editable-canvas-hit 承接（显式 pointer-events: auto），以免继承 none */
+/* 根节点需可命中图元；点空白取消选中由 PisellFloorMapLayout 的 map-area onClick 处理 */
 .pisell-floor-map-layout-editable-item-layer {
   cursor: default;
-  pointer-events: none;
-}
-
-/** 铺满内容区、叠在图元之下，用于点击空白取消选中；不参与拖拽图元 */
-.pisell-floor-map-layout-editable-canvas-hit {
-  position: absolute;
-  left: 0;
-  top: 0;
-  box-sizing: border-box;
-  width: 100%;
-  height: 100%;
-  z-index: 0;
   pointer-events: auto;
 }
 

package/lib/components/pisellFloorMapLayout/components/FigmaTableCard.d.ts

@@ -1,4 +1,8 @@
-/// <reference types="react" />
+/**
+ * Figma 样式餐桌/圆桌卡片：上下小条 + 白底卡片 + 状态色边框
+ * 供 Floor Map Story 与 Sales Grid 平面图复用
+ */
+import React from 'react';
 import type { FloorMapMergedItem, FloorMapDataSources } from '../types';
 export declare type FigmaTableStatus = 'available' | 'reserved' | 'waiting' | 'dining' | 'billed' | 'availableSoon';
 /** 方桌/圆桌卡片展示用数据结构（与 Figma 设计一致，支持桌号/状态/人数/区域等） */
@@ -30,10 +34,10 @@ export interface FigmaTableCardItem {
 /** 从 merged item + dataSources 得到卡片数据 */
 export declare function getFigmaTableCardFromMerged(item: FloorMapMergedItem, dataSources: FloorMapDataSources): FigmaTableCardItem;
 /** 渲染 Figma 样式的方桌卡片（上下小条 + 白底卡片 + 状态边框） */
-export declare function renderFigmaStyleTableCard(cardItem: FigmaTableCardItem): JSX.Element;
+export declare function renderFigmaStyleTableCard(cardItem: FigmaTableCardItem): React.JSX.Element;
 /** 渲染 Figma 样式的圆桌卡片（圆形轮廓，展示桌号/状态/人数/区域） */
-export declare function renderFigmaStyleRoundTableCard(cardItem: FigmaTableCardItem): JSX.Element;
+export declare function renderFigmaStyleRoundTableCard(cardItem: FigmaTableCardItem): React.JSX.Element;
 /** 返回用于 renderItemByKind.table 的渲染函数（方桌） */
-export declare function getRenderItemByKindTable(dataSources: FloorMapDataSources): (item: unknown) => JSX.Element;
+export declare function getRenderItemByKindTable(dataSources: FloorMapDataSources): (item: unknown) => React.JSX.Element;
 /** 返回用于 renderItemByKind.roundTable 的渲染函数（圆桌） */
-export declare function getRenderItemByKindRoundTable(dataSources: FloorMapDataSources): (item: unknown) => JSX.Element;
+export declare function getRenderItemByKindRoundTable(dataSources: FloorMapDataSources): (item: unknown) => React.JSX.Element;

package/lib/components/pisellFloorMapLayout/components/FloorMapDataForm.d.ts

@@ -1,4 +1,8 @@
-/// <reference types="react" />
+/**
+ * FloorMapDataForm - 数据源落位的数据表单，调用 onDataSourceRecordSave
+ * 支持通过 columns 配置列标签与控件类型（string/number/select），与表格列一致
+ */
+import React from 'react';
 import type { FloorMapDataSources, DataSourceFormColumn } from '../types';
 import './FloorMapDataForm.less';
 export interface FloorMapDataFormProps {
@@ -13,5 +17,5 @@ export interface FloorMapDataFormProps {
     className?: string;
 }
 /** 简单通用表单：可编辑记录中的字段；支持 columns 配置标签与控件类型 */
-export declare function FloorMapDataForm(props: FloorMapDataFormProps): JSX.Element;
+export declare function FloorMapDataForm(props: FloorMapDataFormProps): React.JSX.Element;
 export default FloorMapDataForm;

package/lib/components/pisellFloorMapLayout/components/FloorMapEditPanel.d.ts

@@ -1,4 +1,7 @@
-/// <reference types="react" />
+/**
+ * FloorMapEditPanel - 选中图元后的编辑面板：画布属性 + 可选数据绑定 + 数据源记录表单
+ */
+import React from 'react';
 import type { FloorMapEditPanelParams, FloorMapViewConfig, FloorMapDataSources } from '../types';
 import './FloorMapEditPanel.less';
 export interface FloorMapEditPanelProps extends FloorMapEditPanelParams {
@@ -7,5 +10,5 @@ export interface FloorMapEditPanelProps extends FloorMapEditPanelParams {
     savingRecord?: boolean;
     className?: string;
 }
-export declare function FloorMapEditPanel(props: FloorMapEditPanelProps): JSX.Element;
+export declare function FloorMapEditPanel(props: FloorMapEditPanelProps): React.JSX.Element;
 export default FloorMapEditPanel;

package/lib/components/pisellFloorMapLayout/components/FloorMapEditQuickActions.d.ts

@@ -1,4 +1,7 @@
-/// <reference types="react" />
+/**
+ * 编辑态选中图元旁的快捷操作：锁定 / 复制 / 删除（与侧栏同源逻辑）
+ */
+import React from 'react';
 export interface FloorMapEditQuickActionLabels {
     lock: string;
     unlock: string;
@@ -18,4 +21,4 @@ export interface FloorMapEditQuickActionsProps {
     onDuplicate: () => void;
     onDelete: () => void;
 }
-export declare function FloorMapEditQuickActions(props: FloorMapEditQuickActionsProps): JSX.Element;
+export declare function FloorMapEditQuickActions(props: FloorMapEditQuickActionsProps): React.JSX.Element;

package/lib/components/pisellFloorMapLayout/components/FloorMapEditTopBar.d.ts

@@ -34,5 +34,5 @@ export interface FloorMapEditTopBarProps {
     hideCanvasTabs?: boolean;
     className?: string;
 }
-export declare function FloorMapEditTopBar(props: FloorMapEditTopBarProps): JSX.Element | null;
+export declare function FloorMapEditTopBar(props: FloorMapEditTopBarProps): React.JSX.Element | null;
 export default FloorMapEditTopBar;

package/lib/components/pisellFloorMapLayout/components/FloorMapImageElement.d.ts

@@ -1,6 +1,9 @@
-/// <reference types="react" />
+/**
+ * 平面图「图片图元」内层展示：支持 URL、object-fit 铺满；无地址或加载失败时占位
+ */
+import React from 'react';
 export interface FloorMapImageElementProps {
     imageUrl?: string;
     name?: string;
 }
-export declare function FloorMapImageElement(props: FloorMapImageElementProps): JSX.Element;
+export declare function FloorMapImageElement(props: FloorMapImageElementProps): React.JSX.Element;

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

@@ -31,5 +31,5 @@ export interface FloorMapToolbarProps {
     /** 触摸拖放结束后吞掉按钮 click，避免误触切换落点模式 */
     consumeToolbarClickIfTouchDrag?: () => boolean;
 }
-export declare function FloorMapToolbar(props: FloorMapToolbarProps): JSX.Element;
+export declare function FloorMapToolbar(props: FloorMapToolbarProps): React.JSX.Element;
 export default FloorMapToolbar;

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

@@ -49,5 +49,5 @@ export interface ItemLayerProps<T extends FloorMapItemBase> {
     onInteractionChange?: (active: boolean) => void;
     className?: string;
 }
-export declare function ItemLayer<T extends FloorMapItemBase>(props: ItemLayerProps<T>): JSX.Element;
+export declare function ItemLayer<T extends FloorMapItemBase>(props: ItemLayerProps<T>): React.JSX.Element;
 export default ItemLayer;

package/lib/components/pisellFloorMapLayout/components/MapLayer.d.ts

@@ -23,5 +23,5 @@ export interface MapLayerProps {
     /** 自定义类名 */
     className?: string;
 }
-export declare function MapLayer(props: MapLayerProps): JSX.Element;
+export declare function MapLayer(props: MapLayerProps): React.JSX.Element;
 export default MapLayer;

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

@@ -42,5 +42,5 @@ export interface ViewControlsProps {
      */
     autoCollapseDockMs?: number;
 }
-export declare function ViewControls(props: ViewControlsProps): JSX.Element | null;
+export declare function ViewControls(props: ViewControlsProps): React.JSX.Element | null;
 export default ViewControls;

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

@@ -16,4 +16,4 @@ export interface ViewControlsWithZoomProps {
     dockExpandedTrailing?: React.ReactNode;
     autoCollapseDockMs?: number;
 }
-export declare function ViewControlsWithZoom(props: ViewControlsWithZoomProps): JSX.Element;
+export declare function ViewControlsWithZoom(props: ViewControlsWithZoomProps): React.JSX.Element;

package/lib/components/pisellFloorMapLayout/context/FloorMapLayoutContext.d.ts

@@ -13,4 +13,4 @@ export interface FloorMapLayoutProviderProps {
     children: React.ReactNode;
 }
 /** 注入 `FloorMapLayoutContextValue`；`value` 建议由调用方 `useMemo` 稳定化 */
-export declare function FloorMapLayoutProvider({ value, children, }: FloorMapLayoutProviderProps): JSX.Element;
+export declare function FloorMapLayoutProvider({ value, children, }: FloorMapLayoutProviderProps): React.JSX.Element;

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;