@pisell/materials 1.0.1078 → 1.0.1079

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

@@ -0,0 +1,19 @@
+import React from 'react';
+import { EmptyProps } from 'antd';
+import { PisellContextType } from '../pisell-config-provider/context';
+import './index.less';
+export interface PisellEmptyProps extends EmptyProps {
+    /** 平台 */
+    platform?: PisellContextType['platform'];
+    /** 额外内容描述 */
+    extraDescription?: React.ReactNode;
+    /** 额外内容描述 */
+    icon?: React.ReactNode;
+    /** 自定义底部额外操作区域 */
+    footer?: React.ReactNode;
+    /** 最大宽度 */
+    maxWidth?: number;
+    [key: string]: any;
+}
+declare const PisellEmpty: (props: PisellEmptyProps) => React.JSX.Element;
+export default PisellEmpty;

package/lib/components/pisellEntityCard/PisellEntityCard.d.ts

@@ -0,0 +1,8 @@
+import React from 'react';
+import type { PisellEntityCardProps } from './types';
+import './PisellEntityCard.less';
+/**
+ * PisellEntityCard 实体卡片
+ * 基于 PisellBaseCard，使用结构化配置展示实体信息，支持密度、布局、左滑删除与插槽
+ */
+export declare function PisellEntityCard({ children, className, style, hoverStyle, activeStyle, disabledStyle, clickable, disabled, onClick, media, primaryText, subtitleText, secondaryTexts, tags, actions, showMedia, showPrimaryText, showSubtitle, showSecondaryText, showTags, showActions, density, layout, width, swipeToDelete, onDelete, tagPosition, contentGap, primaryLineClamp, secondaryLineClamp: secondaryLineClampProp, renderMedia, renderPrimary, renderSubtitle, renderSecondary, renderTags, renderActions, }: PisellEntityCardProps): React.JSX.Element;

package/lib/components/pisellEntityCard/PisellEntityCard.stories.d.ts

@@ -0,0 +1,47 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellEntityCard } from './PisellEntityCard';
+declare const meta: Meta<typeof PisellEntityCard>;
+export default meta;
+declare type Story = StoryObj<typeof PisellEntityCard>;
+/** 默认：横向 B2，主文案 + 次级 + 头像 */
+export declare const Default: Story;
+/** 仅主文案（最小） */
+export declare const PrimaryOnly: Story;
+/** 主文案 + 头像 一行 */
+export declare const B1Line: Story;
+/** B2 横向：头像 + 主 + 次级两行 */
+export declare const B2Horizontal: Story;
+/** B2 竖向 */
+export declare const B2Vertical: Story;
+/** B5：次级最多 5 行 */
+export declare const B5Standard: Story;
+/** B9 全部展示 */
+export declare const B9Extended: Story;
+/** Action 区域默认关闭（不传 showActions 或 showActions: false） */
+export declare const ActionDefaultOff: Story;
+/** Action 仅文本 */
+export declare const ActionTextOnly: Story;
+/** Action 仅按钮 */
+export declare const ActionButtonOnly: Story;
+/** Action 仅图标（Figma 支持右侧按钮 - 编辑图标） */
+export declare const ActionIconOnly: Story;
+/** Action 混合：文本 + 按钮 + 图标，并各自自定义样式 */
+export declare const ActionMixedWithCustomStyle: Story;
+/** 带底部操作（兼容旧名） */
+export declare const WithActions: Story;
+/** 左滑删除（需在真机或模拟 touch 下左滑验证） */
+export declare const SwipeToDelete: Story;
+/** 标签 inline */
+export declare const TagPositionInline: Story;
+/** 宽度撑满父容器 */
+export declare const WidthFull: Story;
+/** 自定义主文案插槽 */
+export declare const SlotPrimary: Story;
+/** 缩略图类型媒体 */
+export declare const MediaThumbnail: Story;
+/** 图标类型媒体 */
+export declare const MediaIcon: Story;
+/** 可点击卡片 */
+export declare const Clickable: Story;
+/** 禁用态 */
+export declare const Disabled: Story;

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

@@ -0,0 +1,5 @@
+/**
+ * PisellEntityCard 组件导出
+ */
+export { PisellEntityCard } from './PisellEntityCard';
+export type { PisellEntityCardProps, EntityCardDensity, EntityCardLayout, EntityCardWidth, EntityCardMediaType, EntityCardMediaConfig, EntityCardSecondaryItem, EntityCardTagItem, EntityCardActionItem, EntityCardTagPosition, } from './types';

package/lib/components/pisellEntityCard/types.d.ts

@@ -0,0 +1,144 @@
+import type { CSSProperties, ReactNode } from 'react';
+import type { PisellBaseCardProps } from '../pisellBaseCard/types';
+/**
+ * 实体卡信息密度等级
+ * - B1: 最小单位，一行
+ * - B2: 主+次级两行
+ * - B5: 次级最多 5 行
+ * - B9: 全部展示
+ */
+export declare type EntityCardDensity = 'B1' | 'B2' | 'B5' | 'B9';
+/**
+ * 实体卡布局方向
+ */
+export declare type EntityCardLayout = 'horizontal' | 'vertical';
+/**
+ * 实体卡宽度模式
+ * - content: 由内容撑满
+ * - full: 撑满父容器
+ * - number: 固定像素宽度
+ */
+export declare type EntityCardWidth = 'content' | 'full' | number;
+/**
+ * 媒体类型：头像 / 缩略图 / 图标
+ */
+export declare type EntityCardMediaType = 'avatar' | 'thumbnail' | 'icon';
+/**
+ * 实体卡媒体配置（头像、缩略图、图标）
+ */
+export interface EntityCardMediaConfig {
+    /** 类型 */
+    type: EntityCardMediaType;
+    /** 图片地址（avatar/thumbnail 使用） */
+    src?: string;
+    /** 替换文本 / 描述 */
+    alt?: string;
+    /** 图标节点（type 为 icon 时使用） */
+    icon?: ReactNode;
+    /** 尺寸，如 24、48、64 或 CSS 值 */
+    size?: number | string;
+    /** 形状（avatar/thumbnail）：circle | square */
+    shape?: 'circle' | 'square';
+    /** 图标颜色（type 为 icon 时） */
+    color?: string;
+}
+/**
+ * 次级文案单项（可带提示）
+ */
+export interface EntityCardSecondaryItem {
+    /** 文本内容 */
+    text: string;
+    /** 是否显示提示 icon（如 info-circle） */
+    showTooltip?: boolean;
+}
+/**
+ * 实体卡标签项
+ */
+export interface EntityCardTagItem {
+    /** 标签文案 */
+    text: string;
+    /** 可选自定义样式 */
+    style?: CSSProperties;
+}
+/**
+ * 实体卡底部操作项
+ * 支持文本、按钮、图标三种形式，可各自通过 style / className 更改样式
+ */
+export interface EntityCardActionItem {
+    /** 展示形式：文本 / 按钮 / 图标 */
+    type: 'text' | 'button' | 'icon';
+    /** 文案（text/button 时显示） */
+    label?: string;
+    /** 图标节点（icon 时单独展示，或 button 旁图标） */
+    icon?: ReactNode;
+    /** 点击回调 */
+    onClick?: () => void;
+    /** 单项内联样式 */
+    style?: CSSProperties;
+    /** 单项类名，用于自定义样式 */
+    className?: string;
+}
+/**
+ * 标签展示位置：与主标题同行 / 次级信息下方
+ */
+export declare type EntityCardTagPosition = 'inline' | 'below';
+/**
+ * PisellEntityCard 组件 Props
+ * 基于 PisellBaseCard，使用结构化配置展示实体信息，支持密度、布局、左滑删除与插槽
+ */
+export interface PisellEntityCardProps extends PisellBaseCardProps {
+    /** 媒体区：头像 / 缩略图 / 图标配置 */
+    media?: EntityCardMediaConfig;
+    /** 主文案（Name/Title） */
+    primaryText?: string;
+    /** 副标题：与主标题同一行、紧跟主标题后的部分（如电话号），14px Regular #667085 */
+    subtitleText?: string;
+    /** 次级文案列表，顺序即展示顺序；可带 showTooltip */
+    secondaryTexts?: EntityCardSecondaryItem[];
+    /** 标签列表，顺序即展示顺序 */
+    tags?: EntityCardTagItem[];
+    /** 底部操作列表（View Detail、Select 等） */
+    actions?: EntityCardActionItem[];
+    /** 是否显示媒体区 @default true */
+    showMedia?: boolean;
+    /** 是否显示主文案 @default true */
+    showPrimaryText?: boolean;
+    /** 是否显示副标题（与主标题同行） @default true */
+    showSubtitle?: boolean;
+    /** 是否显示次级文案 @default true */
+    showSecondaryText?: boolean;
+    /** 是否显示标签 @default true */
+    showTags?: boolean;
+    /** 是否显示底部 Action 区 @default false */
+    showActions?: boolean;
+    /** 信息密度 @default 'B2' */
+    density?: EntityCardDensity;
+    /** 布局方向 @default 'horizontal' */
+    layout?: EntityCardLayout;
+    /** 卡片宽度 @default 'content' */
+    width?: EntityCardWidth;
+    /** 是否开启左滑删除 @default false */
+    swipeToDelete?: boolean;
+    /** 左滑后点击删除时回调 */
+    onDelete?: () => void;
+    /** 标签展示位置 @default 'below' */
+    tagPosition?: EntityCardTagPosition;
+    /** 内容区 gap（CSS gap 值） */
+    contentGap?: number | string;
+    /** 主文案行数限制（CSS -webkit-line-clamp） */
+    primaryLineClamp?: number;
+    /** 次级文案行数限制（按密度有默认值，可覆盖） */
+    secondaryLineClamp?: number;
+    /** 自定义渲染媒体区 */
+    renderMedia?: () => ReactNode;
+    /** 自定义渲染主文案区 */
+    renderPrimary?: () => ReactNode;
+    /** 自定义渲染副标题区（与主标题同行） */
+    renderSubtitle?: () => ReactNode;
+    /** 自定义渲染次级文案区 */
+    renderSecondary?: () => ReactNode;
+    /** 自定义渲染标签区 */
+    renderTags?: () => ReactNode;
+    /** 自定义渲染底部操作区 */
+    renderActions?: () => ReactNode;
+}

package/lib/components/pisellExport/PisellExport.d.ts

@@ -0,0 +1,9 @@
+import React from 'react';
+import type { PisellExportProps } from './types';
+import './PisellExport.less';
+/**
+ * PisellExport 导出触发器组件
+ *
+ * @description 仅负责 UI 展示与点击回调，不内置导出逻辑；支持 Icon/Button 两种形态与三种尺寸
+ */
+export declare function PisellExport(props: PisellExportProps): React.JSX.Element;

package/lib/components/pisellExport/PisellExport.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellExport } from './PisellExport';
+declare const meta: Meta<typeof PisellExport>;
+export default meta;
+declare type Story = StoryObj<typeof PisellExport>;
+/**
+ * 默认 Button 形态
+ */
+export declare const Basic: Story;
+/**
+ * 仅图标形态
+ */
+export declare const IconOnly: Story;
+/**
+ * 三种尺寸 - Button
+ */
+export declare const SizesButton: Story;
+/**
+ * 三种尺寸 - Icon
+ */
+export declare const SizesIcon: Story;
+/**
+ * 默认样式 vs 主色样式
+ */
+export declare const DefaultVsPrimary: Story;
+/**
+ * 禁用态
+ */
+export declare const Disabled: Story;
+/**
+ * 自定义文案
+ */
+export declare const CustomLabel: Story;
+/**
+ * 自定义图标（antd 图标）
+ */
+export declare const CustomIcon: Story;
+/**
+ * 点击回调示例
+ */
+export declare const WithCallback: Story;
+/**
+ * 设计稿矩阵：Button 形态 × 尺寸 × 类型
+ */
+export declare const ButtonMatrix: Story;

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

@@ -0,0 +1,2 @@
+export { PisellExport } from './PisellExport';
+export type { PisellExportProps, VariantType, SizeType, ExportButtonType } from './types';

package/lib/components/pisellExport/types.d.ts

@@ -0,0 +1,63 @@
+import type { CSSProperties, MouseEvent as ReactMouseEvent, ReactNode } from 'react';
+/**
+ * 展示形态
+ * @description icon：仅图标；button：图标 + 文案
+ */
+export declare type VariantType = 'icon' | 'button';
+/**
+ * 尺寸
+ * @description 小、中、大三种尺寸，对应设计稿 padding 与字体
+ */
+export declare type SizeType = 'small' | 'medium' | 'large';
+/**
+ * 视觉类型
+ * @description default：默认边框/灰字；primary：主色描边或填充
+ */
+export declare type ExportButtonType = 'default' | 'primary';
+/**
+ * PisellExport 组件 Props
+ * @description 导出触发器 UI 组件，仅负责展示与点击回调，不内置导出逻辑
+ */
+export interface PisellExportProps {
+    /**
+     * 展示形态
+     * @default 'button'
+     */
+    variant?: VariantType;
+    /**
+     * 尺寸
+     * @default 'medium'
+     */
+    size?: SizeType;
+    /**
+     * 视觉类型（默认样式 / 主色样式）
+     * @default 'default'
+     */
+    type?: ExportButtonType;
+    /**
+     * 是否禁用
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Button 形态下的文案，不传时使用国际化默认文案
+     */
+    label?: ReactNode;
+    /**
+     * 自定义图标，不传时使用内置下载图标（download-cloud-01）
+     */
+    icon?: ReactNode;
+    /**
+     * 点击触发导出
+     * @description 由调用方在此回调中实现导出请求、轮询、下载等逻辑
+     */
+    onExport?: (e: ReactMouseEvent<HTMLElement>) => void;
+    /**
+     * 自定义类名
+     */
+    className?: string;
+    /**
+     * 自定义样式
+     */
+    style?: CSSProperties;
+}

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

@@ -0,0 +1,7 @@
+import { FilterListProps } from '../filter/components/FilterButton/types';
+/**
+ * 筛选弹层 + 快筛列表；内部通过 Form.useForm 托管表单，无需也不应把 antd FormInstance 并入 props。
+ */
+export declare type PisellFilterProps = FilterListProps & {
+    hasForm?: boolean;
+};

package/lib/components/pisellFloorMapLayout/PisellFloorMapLayout.stories.d.ts

@@ -0,0 +1,55 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFloorMapLayout } from './PisellFloorMapLayout';
+/**
+ * PisellFloorMapLayout 楼层图布局
+ *
+ * 空间布局视图：在二维平面按坐标渲染资源（桌台/房间/工位等），
+ * 支持缩放、平移、复位、区域定位，仅负责展示与交互。
+ */
+declare const meta: Meta<typeof PisellFloorMapLayout>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFloorMapLayout>;
+/**
+ * 默认 - 纯色底 + 简单格子（格子单位，默认 item 间距 8px）
+ */
+export declare const Default: Story;
+/**
+ * 显示网格线（item 间距由 mapLayer.gap 控制）
+ */
+export declare const WithGrid: Story;
+/**
+ * 开启平移 - 可拖拽画布
+ */
+export declare const WithPan: Story;
+export declare const WithShapes: Story;
+export declare const WithVariableSizes: Story;
+export declare const PixelUnits: Story;
+/**
+ * 点击与 Hover 事件
+ */
+export declare const WithEvents: Story;
+/**
+ * Ref 调用 - 外部按钮控制缩放/复位/区域定位
+ */
+export declare const WithRefControls: Story;
+export declare const FloorMapViewEdit: Story;
+/**
+ * 平面图编辑态 + 自定义数据源记录表单（`dataSourceRecordForm.sales`）
+ */
+export declare const FloorMapViewEditCustomRecordForm: Story;
+/**
+ * Floor Map 视图 - 阅读态（方桌同样用 Figma 样式）
+ */
+export declare const FloorMapViewRead: Story;
+/**
+ * 自定义控制按钮显隐
+ */
+export declare const ControlsHidden: Story;
+/**
+ * `FloorMapLayoutProvider` 注入 `floorMapConfig` / `dataSources`；Layout 仅传展示向 props
+ */
+export declare const FloorMapWithLayoutProvider: Story;
+/**
+ * Figma 设计稿效果 - 餐厅桌台状态图（顶部 Tab + 图例参考 node 14131:6266，内容区不变）
+ */
+export declare const FigmaDesign: Story;

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

@@ -0,0 +1,46 @@
+/**
+ * EditableItemLayer - 编辑态图元层：拖拽、缩放、选中、吸附
+ */
+import React, { type CSSProperties } from 'react';
+import type { FloorMapItemBase, FloorMapMergedItem, FloorMapRenderOptions } from '../types';
+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;
+    /** 每项外层容器额外样式（与定位样式合并） */
+    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/lib/components/pisellFloorMapLayout/components/ItemLayer.d.ts

@@ -0,0 +1,53 @@
+/**
+ * ItemLayer - 楼层图展示层
+ * 按 items 的 (x, y) 与 cellSize 定位，用 renderItem 渲染每项内容
+ */
+import React from 'react';
+import type { FloorMapItemBase, FloorMapItemUnit } from '../types';
+import type { CSSProperties } from 'react';
+import './ItemLayer.less';
+export interface ItemLayerProps<T extends FloorMapItemBase> {
+    /** 资源列表 */
+    items: T[];
+    /** 每项渲染函数 */
+    renderItem: (item: T, index: number) => React.ReactNode;
+    /** 每项 key */
+    rowKey?: string | ((item: T, index: number) => string);
+    /** 每格像素尺寸（cell 单位时用；pixel 单位时作为缺省宽高） */
+    cellSize: number;
+    /** item 坐标与尺寸单位：cell 格子数，pixel 像素 */
+    itemUnit?: FloorMapItemUnit;
+    /** item 之间的间距（像素），仅 cell 单位时生效 */
+    itemGap?: number;
+    /** 内容区总宽度（像素），由 items 推导或外部传入 */
+    contentWidth: number;
+    /** 内容区总高度（像素） */
+    contentHeight: number;
+    /** 内容区 X 偏移（画布包围盒向左/上扩展时，图元层整体平移） */
+    contentOffsetX?: number;
+    /** 内容区 Y 偏移 */
+    contentOffsetY?: number;
+    /** 是否启用 hover 事件 */
+    enableHover?: boolean;
+    /**
+     * 是否在 hover 时显示外沿描边（选中感高亮）。默认 true。
+     * 平面图只读态可由布局关闭，仅去掉描边，不影响 onItemHover。
+     */
+    itemHoverOutline?: boolean;
+    /** 点击回调 */
+    onItemClick?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** hover 进入 */
+    onItemHover?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** hover 离开 */
+    onItemLeave?: (item: T, index: number, e: React.MouseEvent<HTMLElement>) => void;
+    /** 每项外层容器额外样式（与定位样式合并） */
+    getMergedItemWrapperStyle?: (item: T, index: number) => CSSProperties | undefined;
+    /**
+     * 与编辑态一致：在含 `data-pisell-floor-room-scroll-surface` 的区域内按下时置 true，
+     * 用于禁用 Transform 画布平移，避免图元内纵向滑动拖动画布。
+     */
+    onInteractionChange?: (active: boolean) => void;
+    className?: string;
+}
+export declare function ItemLayer<T extends FloorMapItemBase>(props: ItemLayerProps<T>): React.JSX.Element;
+export default ItemLayer;

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

@@ -0,0 +1,27 @@
+/**
+ * MapLayer - 楼层图底层
+ * 负责背景（无/纯色/图片/SVG）、网格线、padding、gap
+ */
+import React from 'react';
+import type { FloorMapLayerConfig } from '../types';
+import './MapLayer.less';
+export interface MapLayerProps {
+    /** 底层配置 */
+    config?: FloorMapLayerConfig;
+    /** 内容区域宽度（逻辑单位或像素，用于网格线计算） */
+    contentWidth?: number;
+    /** 内容区域高度 */
+    contentHeight?: number;
+    /** 每格像素尺寸（用于网格线间距） */
+    cellSize?: number;
+    /** 为 true 时不应用纯色背景，让画布底层网格透出 */
+    preferCanvasGrid?: boolean;
+    /** 为 true 时容器设置 pointer-events: none，空白处点击可透传到下层，供 react-zoom-pan-pinch 画布平移 */
+    pointerEventsNone?: boolean;
+    /** 子节点（展示层会叠在上方） */
+    children?: React.ReactNode;
+    /** 自定义类名 */
+    className?: string;
+}
+export declare function MapLayer(props: MapLayerProps): React.JSX.Element;
+export default MapLayer;

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

@@ -0,0 +1,19 @@
+/**
+ * 在 TransformWrapper 内用 useControls 拿到 zoom 控制并渲染 ViewControls，确保点击加减能缩放
+ */
+import React from 'react';
+import type { FloorMapControlsConfig } from '../types';
+export interface ViewControlsWithZoomProps {
+    config?: FloorMapControlsConfig;
+    scale?: number;
+    isFullscreen?: boolean;
+    fitBounds: () => void;
+    /** 未传时不展示全屏按钮（如编辑态 floorMapFullscreenMode 为 disabled） */
+    toggleFullscreen?: () => void;
+    mapGridVisible?: boolean;
+    onToggleMapGrid?: () => void;
+    dockChrome?: boolean;
+    dockExpandedTrailing?: React.ReactNode;
+    autoCollapseDockMs?: number;
+}
+export declare function ViewControlsWithZoom(props: ViewControlsWithZoomProps): React.JSX.Element;

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

@@ -0,0 +1,21 @@
+/**
+ * 楼层图布局子组件导出
+ */
+export { MapLayer } from './MapLayer';
+export { ItemLayer } from './ItemLayer';
+export { ViewControls } from './ViewControls';
+export { ViewControlsWithZoom } from './ViewControlsWithZoom';
+export { CanvasTabs } from './CanvasTabs';
+export { EditableItemLayer } from './EditableItemLayer';
+export { FloorMapToolbar } from './FloorMapToolbar';
+export { FloorMapEditTopBar } from './FloorMapEditTopBar';
+export { FloorMapEditPanel } from './FloorMapEditPanel';
+export { FloorMapDataForm } from './FloorMapDataForm';
+export type { ViewControlsApi } from './ViewControls';
+export type { ViewControlsWithZoomProps } from './ViewControlsWithZoom';
+export type { CanvasTabsProps } from './CanvasTabs';
+export type { EditableItemLayerProps } from './EditableItemLayer';
+export type { FloorMapToolbarProps, PlaceMode } from './FloorMapToolbar';
+export type { FloorMapEditTopBarProps, FloorMapEditTopBarMode, } from './FloorMapEditTopBar';
+export type { FloorMapEditPanelProps } from './FloorMapEditPanel';
+export type { FloorMapDataFormProps } from './FloorMapDataForm';

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

@@ -0,0 +1,16 @@
+/**
+ * 平面图数据/保存等注入上下文；单独页面包 `FloorMapLayoutProvider`，RecordBoard 由 Shell 内置 Provider。
+ */
+import React from 'react';
+import type { FloorMapLayoutContextValue } from '../types';
+/**
+ * 未传 `floorMapLayoutContext` 时 Shell 使用该稳定引用，避免无意义变更引用。
+ */
+export declare const EMPTY_FLOOR_MAP_LAYOUT_CONTEXT: FloorMapLayoutContextValue;
+export declare function useFloorMapLayoutContext(): FloorMapLayoutContextValue | undefined;
+export interface FloorMapLayoutProviderProps {
+    value: FloorMapLayoutContextValue;
+    children: React.ReactNode;
+}
+/** 注入 `FloorMapLayoutContextValue`；`value` 建议由调用方 `useMemo` 稳定化 */
+export declare function FloorMapLayoutProvider({ value, children, }: FloorMapLayoutProviderProps): React.JSX.Element;

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

@@ -0,0 +1,5 @@
+import type { FloorMapItemBase, FloorMapLayoutContextValue, PisellFloorMapLayoutProps } from '../types';
+/**
+ * 将 `FloorMapLayoutContext` 与 Layout props 合并：各字段 props ?? ctx，props 显式值优先。
+ */
+export declare function mergeFloorMapLayoutPropsFromContext<T extends FloorMapItemBase>(props: PisellFloorMapLayoutProps<T>, ctx: FloorMapLayoutContextValue | undefined): PisellFloorMapLayoutProps<T>;