@pisell/materials 6.11.100 → 6.11.101

package/es/components/PisellCards/components/MultilevelCard/hooks/useMultilevelCardExpand.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { MultilevelCardTrigger } from '../types';
 /**
  * 管理 MultilevelCard 的展开/收起状态

package/es/components/PisellCards/components/PisellImageCard/hooks/useImageLoad.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 /**
  * 图片加载状态管理 Hook
  * @param src - 图片地址

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

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const PisellCards: {
     TabCard: (props: any) => import("react").JSX.Element;
     TextCard: (props: any) => import("react").JSX.Element;

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

@@ -9,6 +9,7 @@
  * <PisellFields.Number value={123} viewMode="readonly" />
  * <PisellFields.Currency value={1000} currencySymbol="$" />
  */
+/// <reference types="react" />
 declare const PisellFields: {
     SingleLineText: import("react").NamedExoticComponent<import("../pisellSingleLineText").PisellSingleLineTextProps>;
     LongText: import("react").NamedExoticComponent<import("../pisellLongText").PisellLongTextProps>;

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

@@ -13,6 +13,7 @@
  *   <Content />
  * </PisellLayouts.ScrollView>
  */
+/// <reference types="react" />
 declare const PisellLayouts: {
     BasicGrid: <T>(props: import("../PisellBasicGrid").PisellBasicGridProps<T>) => import("react").JSX.Element;
     ScrollView: import("react").ForwardRefExoticComponent<Omit<import("../PisellScrollView").PisellScrollViewProps, "ref"> & import("react").RefAttributes<import("../PisellScrollView").PisellScrollViewRef>>;

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

@@ -13,6 +13,7 @@
  * />
  * <PisellMetrics.StatisticList data={[...]} />
  */
+/// <reference types="react" />
 declare const PisellMetrics: {
     MetricCard: import("react").FC<import("../pisellMetricCard").PisellMetricCardProps>;
     StatisticList: (props: import("../pisellStatisticList").PisellStatisticListProps) => import("react").JSX.Element;

package/es/components/PisellScrollView/PisellScrollView.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import { PisellScrollViewProps, PisellScrollViewRef } from './types';
+import './PisellScrollView.less';
+declare const PisellScrollView: React.ForwardRefExoticComponent<Omit<PisellScrollViewProps, "ref"> & React.RefAttributes<PisellScrollViewRef>>;
+export default PisellScrollView;

package/es/components/PisellScrollView/components/Actions/index.d.ts

@@ -0,0 +1,18 @@
+import React from 'react';
+import type { ScrollEventData, PisellScrollViewProps, ScrollActionsConfig } from '../../types';
+import './index.less';
+interface ActionsContainerProps {
+    scrollState: ScrollEventData;
+    overflow: PisellScrollViewProps['overflow'];
+    scrollActionsConfig: ScrollActionsConfig;
+    containerRef: React.RefObject<HTMLDivElement>;
+    onClick: (direction: 'left' | 'right' | 'top' | 'bottom') => void;
+}
+/**
+ * ActionsContainer 根据 scrollActionsConfig 渲染滚动辅助操作。
+ *
+ * @example
+ * <ActionsContainer scrollActionsConfig={{ show: true, type: 'indicator' }} />
+ */
+declare const ActionsContainer: ({ containerRef, scrollState, overflow, scrollActionsConfig, onClick, }: ActionsContainerProps) => React.JSX.Element | null;
+export default ActionsContainer;

package/es/components/PisellScrollView/types.d.ts

@@ -0,0 +1,203 @@
+import React, { ReactNode, CSSProperties } from 'react';
+/**
+ * 滚动位置配置
+ */
+export interface ScrollPosition {
+    /** 竖向滚动位置（像素） */
+    scrollTop?: number;
+    /** 横向滚动位置（像素） */
+    scrollLeft?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动到元素配置
+ */
+export interface ScrollToElementConfig {
+    /** 目标元素 ID */
+    targetId: string;
+    /** 对齐方式 */
+    align?: 'start' | 'center' | 'end' | 'nearest';
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+    /** 偏移量 */
+    offset?: number;
+}
+/**
+ * 滚动百分比配置
+ */
+export interface ScrollPercentage {
+    /** 竖向滚动百分比 (0-100) */
+    percentY?: number;
+    /** 横向滚动百分比 (0-100) */
+    percentX?: number;
+    /** 滚动行为 */
+    behavior?: 'auto' | 'smooth';
+}
+/**
+ * 滚动按钮配置
+ */
+export interface ScrollActionsConfig {
+    show?: boolean;
+    /** 按钮类型 */
+    type: "backTop" | "rArrows" | "lrArrows" | "tbArrows" | "indicator" | "custom";
+    style?: CSSProperties;
+    scrollDistance?: number;
+    /** 按钮配置 根据type不同，配置不同 */
+    config?: any;
+}
+/**
+ * 滚动事件数据
+ */
+export interface ScrollEventData {
+    /** 当前滚动位置 */
+    scrollTop: number;
+    scrollLeft: number;
+    /** 滚动百分比 */
+    percentY: number;
+    percentX: number;
+    /** 可滚动高度/宽度 */
+    scrollHeight: number;
+    scrollWidth: number;
+    /** 容器尺寸 */
+    clientHeight: number;
+    clientWidth: number;
+    /** 滚动方向 */
+    direction: 'up' | 'down' | 'left' | 'right' | null;
+    /** 是否滚动到顶部 */
+    isScrollToTop: boolean;
+    /** 是否滚动到底部 */
+    isScrollToBottom: boolean;
+    /** 是否滚动到左边 */
+    isScrollToLeft: boolean;
+    /** 是否滚动到右边 */
+    isScrollToRight: boolean;
+    /** 是否已经产生滚动条 */
+    isOverflows: boolean;
+}
+/**
+ * 视图监听配置
+ */
+export interface IntersectionConfig {
+    /** 是否启用视图监听 */
+    enabled?: boolean;
+    /** 交叉阈值 (0-1) */
+    threshold?: number | number[];
+    /** 根边距 */
+    rootMargin?: string;
+    /** 元素进入视图回调 */
+    onEnterViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 元素离开视图回调 */
+    onLeaveViewport?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 可见度变化回调 */
+    onVisibilityChange?: (entry: IntersectionObserverEntry, element: Element) => void;
+    /** 需要监听的元素选择器 */
+    targetSelector?: string;
+}
+/**
+ * 吸附滚动配置
+ */
+export interface SnapScrollConfig {
+    /** 是否启用吸附滚动 */
+    enabled?: boolean;
+    /** 吸附类型 */
+    type?: 'mandatory' | 'proximity';
+    /** 吸附对齐方式 */
+    align?: 'start' | 'center' | 'end';
+    /** 吸附开始回调 */
+    onSnapStart?: (targetIndex: number, targetPosition: number) => void;
+    /** 吸附结束回调 */
+    onSnapEnd?: (currentIndex: number, currentPosition: number) => void;
+}
+/**
+ * PisellScrollView 组件 Props
+ */
+export interface PisellScrollViewProps {
+    /** 子元素 */
+    children?: ReactNode;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: CSSProperties;
+    /** 滚动方向 */
+    overflow?: 'auto' | 'scroll' | 'hidden' | 'x' | 'y' | 'both';
+    /** 滚动条样式 */
+    scrollbarStyle?: 'default' | 'thin' | 'minimal' | 'rounded' | 'overlay' | 'custom' | 'none';
+    /** 自定义滚动条类名（当 scrollbarStyle 为 'custom' 时使用） */
+    scrollbarClassName?: string;
+    /** 是否显示滚动按钮 */
+    showScrollButtons?: boolean;
+    /** 箭头操作 */
+    scrollActionsConfig?: ScrollActionsConfig;
+    /** 滚动时触发 */
+    onScroll?: (data: ScrollEventData) => void;
+    /** 开始滚动时触发 */
+    onScrollStart?: (data: ScrollEventData) => void;
+    /** 滚动结束时触发（防抖延迟，默认 150ms） */
+    onScrollEnd?: (data: ScrollEventData) => void;
+    /** 滚动结束防抖延迟时间（ms） */
+    scrollEndDelay?: number;
+    /** 到达顶部时触发 */
+    onReachTop?: (data: ScrollEventData) => void;
+    /** 到达底部时触发 */
+    onReachBottom?: (data: ScrollEventData) => void;
+    /** 到达左边时触发 */
+    onReachLeft?: (data: ScrollEventData) => void;
+    /** 到达右边时触发 */
+    onReachRight?: (data: ScrollEventData) => void;
+    /** 边界阈值（到达边界的像素阈值） */
+    reachThreshold?: number;
+    /** IntersectionObserver 配置 */
+    intersection?: IntersectionConfig;
+    /** 吸附滚动配置 */
+    snapScroll?: SnapScrollConfig;
+    /** 容器宽度 */
+    width?: number | string;
+    /** 容器高度 */
+    height?: number | string;
+    /** 最大宽度 */
+    maxWidth?: number | string;
+    /** 最大高度 */
+    maxHeight?: number | string;
+    /** 最小宽度 */
+    minWidth?: number | string;
+    /** 最小高度 */
+    minHeight?: number | string;
+    /** Ref 引用 */
+    ref?: React.Ref<PisellScrollViewRef>;
+    /** 设计模式 */
+    __designMode?: boolean;
+}
+/**
+ * 组件暴露的方法
+ */
+export interface PisellScrollViewRef {
+    /** 滚动到指定位置 */
+    scrollTo: (position: ScrollPosition) => void;
+    /** 滚动到指定元素 */
+    scrollToElement: (config: ScrollToElementConfig) => void;
+    /** 滚动到百分比位置 */
+    scrollToPercentage: (percentage: ScrollPercentage) => void;
+    /** 滚动到顶部 */
+    scrollToTop: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到底部 */
+    scrollToBottom: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最左侧 */
+    scrollToLeft: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到最右侧 */
+    scrollToRight: (behavior?: 'auto' | 'smooth') => void;
+    /** 获取当前滚动信息 */
+    getScrollData: () => ScrollEventData;
+    /** 获取滚动容器 DOM 元素 */
+    getScrollContainer: () => HTMLElement | null;
+    /** 滚动到指定吸附点（索引） */
+    scrollToSnapPoint: (index: number, behavior?: 'auto' | 'smooth') => void;
+    /** 获取所有吸附点位置 */
+    getSnapPoints: () => number[];
+    /** 获取当前吸附点索引 */
+    getCurrentSnapIndex: () => number;
+    /** 滚动到下一个吸附点 */
+    scrollToNextSnap: (behavior?: 'auto' | 'smooth') => void;
+    /** 滚动到上一个吸附点 */
+    scrollToPrevSnap: (behavior?: 'auto' | 'smooth') => void;
+}

package/es/components/batch-editor/fields/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const _default: {
     price: import("react").FC<import("./Price").PriceProps>;
     image: (props: import("./Image").ImageProps) => import("react").JSX.Element | null;

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

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

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

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

package/es/components/dataSourceComponents/dataSourceShow/dataSourceImage/index.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const DataSourceImage: (props: import("../utils").ParsedProps) => React.JSX.Element;
+export default DataSourceImage;

package/es/components/dataSourceComponents/dataSourceShow/dataSourceQRCode/index.d.ts

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

package/es/components/dataSourceComponents/dataSourceTable/hooks/useDataSourceKey.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const useDataSourceKey: () => {
     dataSourceKey: string | undefined;
     dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;

package/es/components/dataSourceComponents/dataSourceTable/hooks/useDrawerState.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const useDrawerState: (operationContent?: {
     [key: string]: import("react").ReactNode;
 } | undefined) => any;

package/es/components/dataSourceComponents/dataSourceTable/hooks/useTableProps.d.ts

@@ -19,7 +19,7 @@ interface UseTablePropsProps {
  */
 declare const useTableProps: (props: UseTablePropsProps) => {
     currentComponentId: any;
-    title: number | boolean | Iterable<React.ReactNode> | React.JSX.Element | (() => React.ReactNode) | null | undefined;
+    title: number | boolean | React.JSX.Element | Iterable<React.ReactNode> | (() => React.ReactNode) | null | undefined;
     pagination: {
         total: number;
         current: number;
@@ -28,7 +28,7 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         showSizeChanger: boolean;
     };
     columns: import("./useColumns").Column[];
-    subTitle: number | boolean | Iterable<React.ReactNode> | React.JSX.Element | (() => React.ReactNode) | null | undefined;
+    subTitle: number | boolean | React.JSX.Element | Iterable<React.ReactNode> | (() => React.ReactNode) | null | undefined;
     buttons: any[] | null;
     filter: {
         dom: any;
@@ -54,7 +54,7 @@ declare const useTableProps: (props: UseTablePropsProps) => {
         width: number;
         align: "center" | "left" | "right";
         fixed: false | "left" | "right";
-        type: "button" | "link";
+        type: "link" | "button";
         items: OperationItem[];
     } | undefined;
     operationContent?: {

package/es/components/dataSourceComponents/dataSourceTable/hooks/useTableQuery.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 import { DataSourceTableProps } from '../type';
 declare type Params = {
     pagination?: {

package/es/components/dataSourceComponents/fields/DatePicker/index.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+declare const DatePicker: React.FC<(import("antd").DatePickerProps & import("../../dataSourceForm/utils").WithModeProps) & import("../../dataSourceForm/utils").WithFormItemProps>;
+export default DatePicker;

package/es/components/dataSourceComponents/fields/Input.Mobile/serve.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

package/es/components/dataSourceComponents/fields/Input.Phone/serve.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 获取nocobase数据列表
+ */
+export declare const getCountryDataList: () => Promise<any>;
+export declare const getShopCountryDataList: (locale?: any) => Promise<any>;
+export interface Country {
+    id: number;
+    name: {
+        en: string;
+        'zh-CN': string;
+        'zh-HK': string;
+        'ja': string;
+        'pt': string;
+        original: string;
+    };
+    code: string;
+    calling_code: string;
+    currency_code: string;
+    sort: number;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    prefix: string;
+}
+export declare const useCountries: () => {
+    data: Country[];
+};

package/es/components/dataSourceComponents/fields/Tabs/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 /** 包装 DataSource 层（提供数据源上下文） */
 declare const FormItemTabs: (props: import("./type").TabsProps & import("../../dataSourceForm/utils").WithModeProps & import("../../dataSourceForm/utils").WithFormItemProps & {
     options?: any;

package/es/components/dataSourceComponents/fields/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const formFieldMap: {
     FormItemCheckbox: import("react").FC<{}> & {
         Group: import("react").FC<import("./Checkbox/type").CheckboxGroupProps & import("../dataSourceForm/utils").WithModeProps>;

package/es/components/date-picker/index.d.ts

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

package/es/components/filter/components/items/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 export declare const fieldMaps: {
     text: {
         field: {

package/es/components/filter/components/items/text/Editor/index.d.ts

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

package/es/components/filter/components/items/text/Preview/index.d.ts

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

package/es/components/filter/components/items/text/index.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const _default: {
     field: {
         field_icon: string;

package/es/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/es/components/pisellDataSourceContainer/hooks/useDataSourceKey.d.ts

@@ -1,3 +1,4 @@
+/// <reference types="react" />
 declare const useDataSourceKey: () => {
     dataSourceKey: string | undefined;
     dataSourceKeyRef: import("react").MutableRefObject<string | undefined>;

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * PisellFloorMapLayout - 空间布局视图
+ * 支持两种用法：1) 仅传入 items + renderItem（原有用法）；2) 传入 floorMapConfig + dataSources + mode 使用平面图视图（含多画布/编辑态）
+ */
+import React from 'react';
+import type { FloorMapItemBase, PisellFloorMapLayoutProps, PisellFloorMapLayoutRef } from './types';
+import './PisellFloorMapLayout.less';
+/** 空间布局根组件：阅读/编辑、列表与平面图双模式，ref 见 {@link PisellFloorMapLayoutRef} */
+declare const PisellFloorMapLayout: <T extends FloorMapItemBase = FloorMapItemBase>(props: PisellFloorMapLayoutProps<T> & {
+    ref?: React.Ref<PisellFloorMapLayoutRef | null> | undefined;
+}) => React.ReactElement;
+export { PisellFloorMapLayout };
+export default PisellFloorMapLayout;

package/es/components/pisellFloorMapLayout/appearance/floorMapAppearance.d.ts

@@ -0,0 +1,29 @@
+import type { FloorMapEdgeStatus } from '../types';
+export declare type FloorMapAppearanceMode = 'light' | 'dark';
+export interface FloorMapEdgeStatusStyle {
+    readonly stroke: string;
+    readonly dashed: boolean;
+}
+export interface FloorMapAppearanceTokens {
+    readonly mode: FloorMapAppearanceMode;
+    /**
+     * 外观模式提供的画布背景兜底色。
+     * 若调用方显式传入 `mapLayer.backgroundColor`，应以显式背景色为准。
+     */
+    readonly fallbackCanvasBackgroundColor: string;
+    /** 按连线状态默认描边样式 */
+    readonly edgeStatusStyles: Record<FloorMapEdgeStatus, FloorMapEdgeStatusStyle>;
+    readonly edgeSelectedStroke: string;
+    readonly edgeGhostStroke: string;
+    readonly edgePortLabelBackground: string;
+    readonly edgePortLabelText: string;
+    readonly edgePortLabelBorder: string;
+    /** 拖动/缩放图元时的边对齐辅助线颜色（主题色） */
+    readonly alignGuideStroke: string;
+}
+/**
+ * 按外观模式返回 floorMap 画布背景 token。
+ * 当前仅承载通用画布背景兜底色，不包含业务壳层颜色；
+ * 渲染层应先尊重显式 `mapLayer.backgroundColor`，再回退到这里的 token。
+ */
+export declare function getFloorMapAppearanceTokens(mode: FloorMapAppearanceMode): FloorMapAppearanceTokens;

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

@@ -0,0 +1,37 @@
+/**
+ * EdgeLayer - 拓扑连线 SVG 层（正交折线 + 端口标签）
+ */
+import React from 'react';
+import type { FloorMapAppearanceTokens } from '../appearance/floorMapAppearance';
+import type { FloorMapEdge } from '../types';
+import { type FloorMapEdgeRoute, type FloorMapItemPixelRect } from '../utils/edgeRouting';
+import './EdgeLayer.less';
+export interface EdgeLayerProps {
+    width: number;
+    height: number;
+    contentOffsetX?: number;
+    contentOffsetY?: number;
+    edges: FloorMapEdge[];
+    routes: FloorMapEdgeRoute[];
+    rectsById: Map<string, FloorMapItemPixelRect>;
+    appearance: FloorMapAppearanceTokens;
+    mode: 'read' | 'edit';
+    selectedEdgeId?: string | null;
+    ghostPathD?: string | null;
+    onEdgeClick?: (edgeId: string, event: React.MouseEvent) => void;
+    /** 画布 viewport scale，用于段手柄反向缩放 */
+    viewportScale?: number;
+    /** 段手柄拖动开始（含首/末段以触发 stub 插入） */
+    onSegmentDragStart?: (params: {
+        edgeId: string;
+        role: 'first' | 'last' | 'inner';
+        segmentIndex: number;
+        axis: 'h' | 'v';
+        startPosition: number;
+        clientX: number;
+        clientY: number;
+        segmentLength?: number;
+    }) => void;
+    className?: string;
+}
+export declare function EdgeLayer(props: EdgeLayerProps): React.JSX.Element;

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

@@ -0,0 +1,66 @@
+/**
+ * EditableItemLayer - 编辑态图元层：拖拽、缩放、选中、吸附
+ */
+import React, { type CSSProperties } from 'react';
+import type { FloorMapItemBase, FloorMapMergedItem, FloorMapRenderOptions } from '../types';
+import { type AlignGuide } from '../utils/alignSnap';
+import { type FloorMapEditQuickActionLabels } from './FloorMapEditQuickActions';
+import './EditableItemLayer.less';
+export interface EditableItemLayerProps<T extends FloorMapItemBase = FloorMapMergedItem> {
+    items: T[];
+    renderItem: (item: T, index: number, options?: FloorMapRenderOptions) => React.ReactNode;
+    rowKey?: string | ((item: T, index: number) => string);
+    cellSize: number;
+    itemUnit?: 'cell' | 'pixel';
+    itemGap?: number;
+    contentWidth: number;
+    contentHeight: number;
+    /** 内容区 X/Y 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
+    contentOffsetX?: number;
+    contentOffsetY?: number;
+    selectedId: string | null;
+    onSelect: (id: string | null) => void;
+    onUpdateItem: (itemId: string, patch: Partial<{
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }>) => void;
+    snapStep?: number;
+    /** 画布当前缩放，用于将屏幕位移转为内容位移 */
+    scale?: number;
+    /** 拖拽/缩放图元时通知父组件，用于禁用画布平移，避免松手时画布跟着动 */
+    onInteractionChange?: (active: boolean) => void;
+    /**
+     * 拖拽/缩放过程中的像素矩形（内容坐标），用于 EdgeLayer 实时重算连线。
+     * itemId 为 null 表示结束交互。
+     */
+    onLiveRectChange?: (itemId: string | null, rect: {
+        left: number;
+        top: number;
+        width: number;
+        height: number;
+    } | null) => void;
+    /**
+     * 对齐阈值（屏幕像素，组件内会按 scale 折算到内容坐标）。
+     * 0 或负数关闭对齐。
+     */
+    alignSnapThresholdPx?: number;
+    /** 命中的对齐辅助线变化；交互结束时回调一次空数组 */
+    onAlignGuidesChange?: (guides: AlignGuide[]) => void;
+    /** 对齐辅助线颜色（推荐用主题 token `alignGuideStroke`） */
+    alignGuideStroke?: string;
+    /** 每项外层容器额外样式（与定位样式合并） */
+    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
+    className?: string;
+    /** 编辑态选中时图元旁快捷栏（上锁 / 复制 / 删除） */
+    editQuickBar?: {
+        labels: FloorMapEditQuickActionLabels;
+        isLocked: boolean;
+        onToggleLock: () => void;
+        onDuplicate: () => void;
+        onDelete: () => void;
+    } | null;
+}
+export declare function EditableItemLayer<T extends FloorMapItemBase>(props: EditableItemLayerProps<T>): React.JSX.Element;
+export default EditableItemLayer;

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

@@ -0,0 +1,16 @@
+/**
+ * FloorMapEdgeEditPanel - 选中连线后的侧栏编辑
+ */
+import React from 'react';
+import type { FloorMapEdge, FloorMapViewConfig } from '../types';
+import './FloorMapEdgeEditPanel.less';
+export interface FloorMapEdgeEditPanelProps {
+    edge: FloorMapEdge;
+    config: FloorMapViewConfig;
+    onUpdate: (patch: Partial<FloorMapEdge>) => void;
+    onClose: () => void;
+    onDelete?: () => void;
+    layoutDraftDirty?: boolean;
+    className?: string;
+}
+export declare function FloorMapEdgeEditPanel(props: FloorMapEdgeEditPanelProps): React.JSX.Element;

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

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