@pisell/materials 1.8.23 → 1.8.24

package/es/components/pisellEmail/utils/emailHelper.d.ts

@@ -0,0 +1,66 @@
+/**
+ * 邮箱辅助函数
+ */
+import type { MailtoOptions } from '../types';
+/**
+ * 提取邮箱域名
+ * @param email 邮箱地址
+ * @returns 域名部分
+ *
+ * @example
+ * extractEmailDomain('user@example.com') // 'example.com'
+ */
+export declare function extractEmailDomain(email: string): string;
+/**
+ * 提取邮箱本地部分
+ * @param email 邮箱地址
+ * @returns 本地部分（@ 前面的部分）
+ *
+ * @example
+ * extractEmailLocal('user@example.com') // 'user'
+ */
+export declare function extractEmailLocal(email: string): string;
+/**
+ * 规范化邮箱地址（转小写）
+ * @param email 邮箱地址
+ * @returns 规范化后的邮箱地址
+ *
+ * @example
+ * normalizeEmail('User@Example.COM') // 'user@example.com'
+ */
+export declare function normalizeEmail(email: string): string;
+/**
+ * 邮箱域名脱敏（partial 模式）
+ * 只显示本地部分的第一个字符，其余用 *** 替代
+ *
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱（u***@gmail.com）
+ *
+ * @example
+ * hideEmailDomain('user@gmail.com') // 'u***@gmail.com'
+ */
+export declare function hideEmailDomain(email: string): string;
+/**
+ * 邮箱域名完全隐藏（full 模式）
+ * 隐藏整个域名部分
+ *
+ * @param email 邮箱地址
+ * @returns 脱敏后的邮箱（user@***）
+ *
+ * @example
+ * maskEmailDomain('user@gmail.com') // 'user@***'
+ */
+export declare function maskEmailDomain(email: string): string;
+/**
+ * 处理 mailto 点击，唤起邮件客户端
+ *
+ * @param email 邮箱地址
+ * @param options mailto 可选参数（主题、正文、抄送等）
+ *
+ * @example
+ * handleEmailClick('support@example.com', {
+ *   subject: '产品咨询',
+ *   body: '您好，我想咨询...'
+ * })
+ */
+export declare function handleEmailClick(email: string, options?: MailtoOptions): void;

package/es/components/pisellEmail/utils/emailValidator.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 邮箱校验工具函数
+ */
+/**
+ * 标准邮箱格式校验
+ * @param email 邮箱地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateEmail('user@example.com') // true
+ * validateEmail('invalid-email') // false
+ */
+export declare function validateEmail(email: string): boolean;
+/**
+ * 严格邮箱格式校验（RFC 5322）
+ * @param email 邮箱地址
+ * @returns 是否通过校验
+ *
+ * @example
+ * validateEmailStrict('user@example.com') // true
+ */
+export declare function validateEmailStrict(email: string): boolean;
+/**
+ * 邮箱分部校验
+ * 检查邮箱的各个部分是否符合规范
+ *
+ * @param email 邮箱地址
+ * @returns 校验结果
+ */
+export declare function validateEmailParts(email: string): {
+    isValid: boolean;
+    errors: string[];
+};
+/**
+ * 域名白名单/黑名单校验
+ *
+ * @param email 邮箱地址
+ * @param allowedDomains 白名单域名列表
+ * @param blockedDomains 黑名单域名列表
+ * @returns 校验结果
+ */
+export declare function validateEmailDomain(email: string, allowedDomains?: string[], blockedDomains?: string[]): {
+    isValid: boolean;
+    errors: string[];
+};

package/es/components/pisellEmail/utils/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * PisellEmail 工具函数导出
+ */
+export * from './emailValidator';
+export * from './emailHelper';
+export * from './domainSuggestions';

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

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

package/es/components/pisellFind/PisellFind.stories.d.ts

@@ -0,0 +1,45 @@
+import type { Meta, StoryObj } from '@storybook/react';
+import { PisellFind } from './index';
+/**
+ * PisellFind 组件 Storybook
+ * 基于 PisellLookup 的组件内查找优化版本
+ */
+declare const meta: Meta<typeof PisellFind>;
+export default meta;
+declare type Story = StoryObj<typeof PisellFind>;
+/**
+ * 基础示例 - 列表查找
+ */
+export declare const Basic: Story;
+/**
+ * 表格查找
+ */
+export declare const TableFind: Story;
+/**
+ * Input 模式查找
+ */
+export declare const InputMode: Story;
+/**
+ * 使用 Ref 控制
+ */
+export declare const WithRef: Story;
+/**
+ * 显示确认按钮
+ */
+export declare const WithConfirmButton: Story;
+/**
+ * 关闭历史记录
+ */
+export declare const NoHistory: Story;
+/**
+ * 多字段搜索
+ */
+export declare const MultiFieldSearch: Story;
+/**
+ * Drawer 模式
+ */
+export declare const DrawerMode: Story;
+/**
+ * Playground - 自由配置
+ */
+export declare const Playground: Story;

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

@@ -0,0 +1,40 @@
+import React from 'react';
+import type { PisellLookupProps, PisellLookupRef } from '../pisellLookup';
+/**
+ * PisellFind Props
+ * 继承 PisellLookup 的所有 Props
+ */
+export declare type PisellFindProps = PisellLookupProps;
+/**
+ * PisellFind Ref
+ * 继承 PisellLookup 的所有 Ref 方法
+ */
+export declare type PisellFindRef = PisellLookupRef;
+/**
+ * PisellFind 组件
+ * 基于 PisellLookup 的组件内查找优化版本
+ *
+ * 核心特点：
+ * - 默认使用 button 触发器
+ * - 默认不显示确认按钮（输入即搜索）
+ * - 默认开启搜索历史
+ * - 默认不展示结果区（结果在页面其他位置展示）
+ *
+ * @example
+ * ```tsx
+ * // 基础用法
+ * <PisellFind
+ *   onSearch={(keyword) => {
+ *     const filtered = data.filter(item => item.name.includes(keyword));
+ *     setFilteredData(filtered);
+ *   }}
+ * />
+ *
+ * // 切换为 Input 模式
+ * <PisellFind
+ *   triggerType="input"
+ *   onSearch={(keyword) => filterData(keyword)}
+ * />
+ * ```
+ */
+export declare const PisellFind: React.ForwardRefExoticComponent<PisellLookupProps & React.RefAttributes<PisellLookupRef>>;

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

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

package/es/components/pisellFloorMapLayout/PisellFloorMapLayout.js

@@ -554,7 +554,8 @@ function PisellFloorMapLayoutInner(props, ref) {
       onItemClick: handleItemClick,
       onItemHover: onItemHover,
       onItemLeave: onItemLeave,
-      getMergedItemWrapperStyle: getMergedItemWrapperStyle
+      getMergedItemWrapperStyle: getMergedItemWrapperStyle,
+      onInteractionChange: setIsInteractingWithElement
     }), isFloorMapView && mode === 'edit' && (placeMode === null || placeMode === void 0 ? void 0 : placeMode.type) === 'scene' && /*#__PURE__*/React.createElement("div", {
       className: placeOverlayClass,
       style: {

package/es/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/es/components/pisellFloorMapLayout/components/CanvasTabs.d.ts

@@ -0,0 +1,22 @@
+/// <reference types="react" />
+import type { FloorMapCanvas, FloorMapCanvasNameI18n } from '../types';
+import './CanvasTabs.less';
+export interface CanvasTabsProps {
+    /** 画布列表 */
+    canvases: FloorMapCanvas[];
+    /** 当前画布 id */
+    currentCanvasId: string | null;
+    /** 切换画布 */
+    onTabChange: (canvasId: string) => void;
+    /** 是否允许添加/删除/重命名画布（编辑态） */
+    canEdit?: boolean;
+    /** 添加画布 */
+    onAddCanvas?: () => void;
+    /** 删除画布（至少保留一个画布时可调用） */
+    onRemoveCanvas?: (canvasId: string) => void;
+    /** 重命名画布（对象写入 `name`，并清除 `nameKey`） */
+    onRenameCanvas?: (canvasId: string, name: string | FloorMapCanvasNameI18n) => void;
+    className?: string;
+}
+export declare function CanvasTabs(props: CanvasTabsProps): JSX.Element;
+export default CanvasTabs;

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

@@ -0,0 +1,39 @@
+/// <reference types="react" />
+import type { FloorMapMergedItem, FloorMapDataSources } from '../types';
+export declare type FigmaTableStatus = 'available' | 'reserved' | 'waiting' | 'dining' | 'billed' | 'availableSoon';
+/** 方桌/圆桌卡片展示用数据结构（与 Figma 设计一致，支持桌号/状态/人数/区域等） */
+export interface FigmaTableCardItem {
+    id: string;
+    /**
+     * 无绑定或无可展示数据行时与蘸料摆台占位一致：浅灰底 + 虚线框 + 提示文案
+     * @see getRenderItemByKindCondimentStation（RecordBoard Story）
+     */
+    isNoDataPlaceholder?: boolean;
+    placeholderBorderColor?: string;
+    placeholderHint?: string;
+    /** 占位主标题：优先图元名称，否则「餐桌」/「圆桌」 */
+    placeholderTitle?: string;
+    /** 桌号/名称，空闲态居中显示 */
+    displayName?: string;
+    status?: FigmaTableStatus;
+    customerName?: string;
+    reserveTime?: string;
+    /** 当前用餐人数（与 Figma 设计一致） */
+    guests?: number;
+    /** 可坐人数（与表格列「可坐人数」绑定） */
+    capacity?: number;
+    dishes?: string;
+    duration?: string;
+    /** 区域（与表格列「区域」绑定，如大厅/包厢A） */
+    area?: string;
+}
+/** 从 merged item + dataSources 得到卡片数据 */
+export declare function getFigmaTableCardFromMerged(item: FloorMapMergedItem, dataSources: FloorMapDataSources): FigmaTableCardItem;
+/** 渲染 Figma 样式的方桌卡片（上下小条 + 白底卡片 + 状态边框） */
+export declare function renderFigmaStyleTableCard(cardItem: FigmaTableCardItem): JSX.Element;
+/** 渲染 Figma 样式的圆桌卡片（圆形轮廓，展示桌号/状态/人数/区域） */
+export declare function renderFigmaStyleRoundTableCard(cardItem: FigmaTableCardItem): JSX.Element;
+/** 返回用于 renderItemByKind.table 的渲染函数（方桌） */
+export declare function getRenderItemByKindTable(dataSources: FloorMapDataSources): (item: unknown) => JSX.Element;
+/** 返回用于 renderItemByKind.roundTable 的渲染函数（圆桌） */
+export declare function getRenderItemByKindRoundTable(dataSources: FloorMapDataSources): (item: unknown) => JSX.Element;

package/es/components/pisellFloorMapLayout/components/FigmaTableCard.js

@@ -5,6 +5,10 @@
 import React from 'react';
 import { Avatar } from 'antd';
 import { UserOutlined, ClockCircleOutlined, TeamOutlined, AuditOutlined, FieldTimeOutlined, EnvironmentOutlined } from '@ant-design/icons';
+import { locales } from '@pisell/utils';
+var I18N_CARD = 'pisell-floor-map-layout.card-placeholder';
+var I18N_FIGMA = 'pisell-floor-map-layout.figma-card';
+
 /** Figma 设计 token（Pisell 2.0 Component Library） */
 var FIGMA = {
   white: '#FFFFFF',
@@ -53,7 +57,7 @@ export function getFigmaTableCardFromMerged(item, dataSources) {
   var el = item._sceneElement;
   var binding = el === null || el === void 0 ? void 0 : el.dataBinding;
   var titleFromElement = (el === null || el === void 0 ? void 0 : el.name) != null && String(el.name).trim() ? String(el.name).trim() : '';
-  var kindLabel = item.elementKind === 'roundTable' ? '圆桌' : '餐桌';
+  var kindLabel = locales.getText(item.elementKind === 'roundTable' ? "".concat(I18N_FIGMA, ".kind-round-table") : "".concat(I18N_FIGMA, ".kind-square-table"));
   var hasDataSource = Boolean((binding === null || binding === void 0 ? void 0 : binding.dataSourceKey) && String(binding.dataSourceKey).trim() !== '');
   var rid = (binding === null || binding === void 0 ? void 0 : binding.recordId) != null ? String(binding.recordId).trim() : '';
   var boundToData = Boolean(hasDataSource && rid !== '');
@@ -65,7 +69,7 @@ export function getFigmaTableCardFromMerged(item, dataSources) {
   if (!hasLiveRow) {
     /** 记录缺失或与「未选数据源」占位同一视觉（虚线 #bfbfbf），便于识别为待处理态 */
     var borderColor = '#bfbfbf';
-    var hint = !hasDataSource || !rid ? hasDataSource ? '已选择数据源，请在侧栏选择数据行' : '未绑定数据行：请在侧栏选择数据源与记录' : rid.startsWith('new_') ? "\u65B0".concat(kindLabel, "\u5360\u4F4D\uFF0C\u53EF\u5728\u4FA7\u680F\u7ED1\u5B9A\u5177\u4F53\u8BB0\u5F55") : '未找到对应记录：请检查绑定或数据列表';
+    var hint = !hasDataSource || !rid ? hasDataSource ? locales.getText("".concat(I18N_CARD, ".hint-select-row")) : locales.getText("".concat(I18N_CARD, ".hint-bind-datasource")) : rid.startsWith('new_') ? locales.getText("".concat(I18N_CARD, ".hint-new-slot")).replace(/\{kind\}/g, kindLabel) : locales.getText("".concat(I18N_CARD, ".hint-row-not-found"));
     return {
       id: item.id,
       isNoDataPlaceholder: true,
@@ -165,7 +169,7 @@ function TableCardInfoRows(_ref3) {
   if (!hasCapacity && !hasArea) return null;
   return /*#__PURE__*/React.createElement(React.Fragment, null, hasCapacity && /*#__PURE__*/React.createElement(FigmaCardRow, {
     icon: /*#__PURE__*/React.createElement(TeamOutlined, null)
-  }, /*#__PURE__*/React.createElement("span", null, "\u53EF\u5750 ", cardItem.capacity, " \u4EBA")), hasArea && /*#__PURE__*/React.createElement(FigmaCardRow, {
+  }, /*#__PURE__*/React.createElement("span", null, locales.getText("".concat(I18N_FIGMA, ".capacity-seats")).replace(/\{n\}/g, String(cardItem.capacity)))), hasArea && /*#__PURE__*/React.createElement(FigmaCardRow, {
     icon: /*#__PURE__*/React.createElement(EnvironmentOutlined, null)
   }, /*#__PURE__*/React.createElement("span", null, cardItem.area)));
 }
@@ -234,7 +238,7 @@ function TableCardContent(_ref4) {
     icon: /*#__PURE__*/React.createElement(ClockCircleOutlined, null)
   }, /*#__PURE__*/React.createElement("span", null, cardItem.reserveTime))), (status === 'dining' || status === 'waiting' || status === 'billed' || status === 'availableSoon') && cardItem.guests != null && /*#__PURE__*/React.createElement(React.Fragment, null, /*#__PURE__*/React.createElement(FigmaCardRow, {
     icon: /*#__PURE__*/React.createElement(TeamOutlined, null)
-  }, /*#__PURE__*/React.createElement("span", null, cardItem.guests, " \u4EBA")), cardItem.dishes && /*#__PURE__*/React.createElement(FigmaCardRow, {
+  }, /*#__PURE__*/React.createElement("span", null, locales.getText("".concat(I18N_FIGMA, ".guests-count")).replace(/\{n\}/g, String(cardItem.guests)))), cardItem.dishes && /*#__PURE__*/React.createElement(FigmaCardRow, {
     icon: /*#__PURE__*/React.createElement(AuditOutlined, null)
   }, /*#__PURE__*/React.createElement("span", null, cardItem.dishes)), cardItem.duration && /*#__PURE__*/React.createElement(FigmaCardRow, {
     icon: /*#__PURE__*/React.createElement(FieldTimeOutlined, null)
@@ -247,7 +251,7 @@ function TableCardContent(_ref4) {
 function renderTableKindNoDataPlaceholder(cardItem, shape) {
   var _cardItem$placeholder, _cardItem$placeholder2, _cardItem$placeholder3;
   var borderColor = (_cardItem$placeholder = cardItem.placeholderBorderColor) !== null && _cardItem$placeholder !== void 0 ? _cardItem$placeholder : '#bfbfbf';
-  var title = (_cardItem$placeholder2 = cardItem.placeholderTitle) !== null && _cardItem$placeholder2 !== void 0 ? _cardItem$placeholder2 : '餐桌';
+  var title = (_cardItem$placeholder2 = cardItem.placeholderTitle) !== null && _cardItem$placeholder2 !== void 0 ? _cardItem$placeholder2 : locales.getText("".concat(I18N_FIGMA, ".default-table"));
   var hint = (_cardItem$placeholder3 = cardItem.placeholderHint) !== null && _cardItem$placeholder3 !== void 0 ? _cardItem$placeholder3 : '';
   return /*#__PURE__*/React.createElement("div", {
     style: {
@@ -382,7 +386,7 @@ export function renderFigmaStyleRoundTableCard(cardItem) {
     style: {
       marginRight: 4
     }
-  }), "\u53EF\u5750 ", cardItem.capacity, " \u4EBA"), cardItem.area != null && cardItem.area !== '' && /*#__PURE__*/React.createElement("span", null, /*#__PURE__*/React.createElement(EnvironmentOutlined, {
+  }), locales.getText("".concat(I18N_FIGMA, ".capacity-seats")).replace(/\{n\}/g, String(cardItem.capacity))), cardItem.area != null && cardItem.area !== '' && /*#__PURE__*/React.createElement("span", null, /*#__PURE__*/React.createElement(EnvironmentOutlined, {
     style: {
       marginRight: 4
     }
@@ -406,13 +410,13 @@ export function renderFigmaStyleRoundTableCard(cardItem) {
       color: FIGMA.gray700,
       marginTop: 2
     }
-  }, cardItem.guests, " \u4EBA"), (cardItem.capacity != null || cardItem.area != null && cardItem.area !== '') && /*#__PURE__*/React.createElement("div", {
+  }, locales.getText("".concat(I18N_FIGMA, ".guests-count")).replace(/\{n\}/g, String(cardItem.guests))), (cardItem.capacity != null || cardItem.area != null && cardItem.area !== '') && /*#__PURE__*/React.createElement("div", {
     style: {
       fontSize: 12,
       color: FIGMA.gray700,
       marginTop: 2
     }
-  }, cardItem.capacity != null && "\u53EF\u5750 ".concat(cardItem.capacity, " \u4EBA"), cardItem.capacity != null && cardItem.area && ' · ', cardItem.area))));
+  }, cardItem.capacity != null && locales.getText("".concat(I18N_FIGMA, ".capacity-seats")).replace(/\{n\}/g, String(cardItem.capacity)), cardItem.capacity != null && cardItem.area && ' · ', cardItem.area))));
 }
 
 /** 返回用于 renderItemByKind.table 的渲染函数（方桌） */

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

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import type { FloorMapDataSources, DataSourceFormColumn } from '../types';
+import './FloorMapDataForm.less';
+export interface FloorMapDataFormProps {
+    dataSourceKey: string;
+    recordId: string;
+    record: Record<string, unknown>;
+    dataSources: FloorMapDataSources;
+    onSave: (dataSourceKey: string, id: string, newData: Record<string, unknown>) => void;
+    saving?: boolean;
+    /** 列配置：标签、类型（string/number/select）、选项（select 时）；不传则自动列举 record 除 id 外字段 */
+    columns?: DataSourceFormColumn[];
+    className?: string;
+}
+/** 简单通用表单：可编辑记录中的字段；支持 columns 配置标签与控件类型 */
+export declare function FloorMapDataForm(props: FloorMapDataFormProps): JSX.Element;
+export default FloorMapDataForm;

package/es/components/pisellFloorMapLayout/components/FloorMapDataForm.js

@@ -17,8 +17,10 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import React, { useState, useCallback, useEffect } from 'react';
 import classNames from 'classnames';
 import { Form, Input, InputNumber, Select, Button } from 'antd';
+import { locales } from '@pisell/utils';
 import "./FloorMapDataForm.less";
 var PREFIX = 'pisell-floor-map-layout';
+var I18N_DF = 'pisell-floor-map-layout.data-form';
 function renderFormControl(col, value) {
   var _col$type, _col$options;
   var type = (_col$type = col.type) !== null && _col$type !== void 0 ? _col$type : 'string';
@@ -97,7 +99,7 @@ export function FloorMapDataForm(props) {
       className: classNames("".concat(PREFIX, "-data-form"), className)
     }, /*#__PURE__*/React.createElement("p", {
       className: "".concat(PREFIX, "-data-form-empty")
-    }, "\u65E0\u989D\u5916\u5B57\u6BB5\u53EF\u7F16\u8F91"));
+    }, locales.getText("".concat(I18N_DF, ".empty"))));
   }
   return /*#__PURE__*/React.createElement("div", {
     className: classNames("".concat(PREFIX, "-data-form"), className)
@@ -126,6 +128,6 @@ export function FloorMapDataForm(props) {
     htmlType: "submit",
     loading: saving,
     disabled: !changed
-  }, "\u4FDD\u5B58\u8BB0\u5F55"))));
+  }, locales.getText("".concat(I18N_DF, ".save-record"))))));
 }
 export default FloorMapDataForm;

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

@@ -0,0 +1,11 @@
+/// <reference types="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): JSX.Element;
+export default FloorMapEditPanel;

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

@@ -0,0 +1,36 @@
+/**
+ * FloorMapEditTopBar - 编辑态顶栏
+ * - `mode="compact"`：画布 Tab + 可选 `canvasTabsBarTrailing` + 全屏入口（非全屏；保存多在侧栏）
+ * - `mode="full"`：画布 Tab + `canvasTabsBarTrailing` + 保存（仅非浏览器全屏时）+ 全屏退出 + 扩展操作
+ */
+import React from 'react';
+import type { CanvasTabsProps } from './CanvasTabs';
+import type { FloorMapControlsConfig, FloorMapViewConfig } from '../types';
+import './FloorMapEditTopBar.less';
+export declare type FloorMapEditTopBarMode = 'full' | 'compact';
+export interface FloorMapEditTopBarProps {
+    /** full：全屏时的完整顶栏；compact：非全屏时 Tab + 全屏入口 */
+    mode?: FloorMapEditTopBarMode;
+    config: FloorMapViewConfig;
+    canvases: CanvasTabsProps['canvases'];
+    currentCanvasId: CanvasTabsProps['currentCanvasId'];
+    onTabChange: CanvasTabsProps['onTabChange'];
+    canEditTabs?: CanvasTabsProps['canEdit'];
+    onAddCanvas?: CanvasTabsProps['onAddCanvas'];
+    onRemoveCanvas?: CanvasTabsProps['onRemoveCanvas'];
+    onRenameCanvas?: CanvasTabsProps['onRenameCanvas'];
+    onSave?: () => void;
+    saving?: boolean;
+    saveError?: Error | string;
+    layoutDirty?: boolean;
+    toggleFullscreen?: () => void;
+    isFullscreen?: boolean;
+    controls?: FloorMapControlsConfig;
+    /** 顶栏右侧扩展（如「区域定位」等），仅 full 模式 */
+    extraActions?: React.ReactNode;
+    /** 画布 Tab 同排最右侧业务区（在「进入全屏」/「退出全屏」与保存等之前） */
+    canvasTabsBarTrailing?: React.ReactNode;
+    className?: string;
+}
+export declare function FloorMapEditTopBar(props: FloorMapEditTopBarProps): JSX.Element;
+export default FloorMapEditTopBar;

package/es/components/pisellFloorMapLayout/components/FloorMapEditTopBar.js

@@ -92,7 +92,7 @@ export function FloorMapEditTopBar(props) {
     }, /*#__PURE__*/React.createElement(FullscreenOutlined, null)) : null) : null);
   }
   return /*#__PURE__*/React.createElement("div", {
-    className: classNames("".concat(PREFIX, "-edit-top-bar"), className),
+    className: classNames("".concat(PREFIX, "-edit-top-bar"), "".concat(PREFIX, "-edit-top-bar--full-chrome"), className),
     role: "toolbar",
     "aria-label": topBarLabels.aria
   }, /*#__PURE__*/React.createElement("div", {

package/es/components/pisellFloorMapLayout/components/FloorMapEditTopBar.less

@@ -129,12 +129,13 @@
   }
 
   /**
-   * 只读顶栏（`edit-top-bar` + `read-canvas-tabs-bar` 并列）与编辑态 compact：
-   * 与左侧 Tab 同一浅灰底，去掉右侧白底与竖线分割。
+   * 只读顶栏（`edit-top-bar` + `read-canvas-tabs-bar` 并列）、编辑态 compact、
+   * 以及全屏/locked 时的 full 顶栏：与左侧 Tab 同一浅灰底，去掉右侧大块白底与竖线分割。
    */
 
   &.pisell-floor-map-layout-read-canvas-tabs-bar,
-  &--compact {
+  &--compact,
+  &--full-chrome {
     background: rgba(0, 0, 0, 0.04);
 
     .pisell-floor-map-layout-edit-top-bar-actions {

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

@@ -0,0 +1,6 @@
+/// <reference types="react" />
+export interface FloorMapImageElementProps {
+    imageUrl?: string;
+    name?: string;
+}
+export declare function FloorMapImageElement(props: FloorMapImageElementProps): JSX.Element;

package/es/components/pisellFloorMapLayout/components/FloorMapImageElement.js

@@ -8,7 +8,9 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  * 平面图「图片图元」内层展示：支持 URL、object-fit 铺满；无地址或加载失败时占位
  */
 import React, { useEffect, useState } from 'react';
+import { locales } from '@pisell/utils';
 var PREFIX = 'pisell-floor-map-layout';
+var I18N_IMG = 'pisell-floor-map-layout.image-element';
 export function FloorMapImageElement(props) {
   var imageUrl = props.imageUrl,
     name = props.name;
@@ -20,7 +22,7 @@ export function FloorMapImageElement(props) {
   useEffect(function () {
     setBroken(false);
   }, [trimmed]);
-  var label = name != null && String(name).trim() ? String(name).trim() : '图片图元';
+  var label = name != null && String(name).trim() ? String(name).trim() : locales.getText("".concat(I18N_IMG, ".default-name"));
   if (!trimmed || broken) {
     return /*#__PURE__*/React.createElement("div", {
       className: "".concat(PREFIX, "-image-element-placeholder"),
@@ -48,7 +50,7 @@ export function FloorMapImageElement(props) {
         color: '#595959',
         marginBottom: 4
       }
-    }, label), /*#__PURE__*/React.createElement("span", null, !trimmed ? '在侧栏填写图片地址；可调层级置于桌位下方作底图' : '图片加载失败，请检查地址'));
+    }, label), /*#__PURE__*/React.createElement("span", null, !trimmed ? locales.getText("".concat(I18N_IMG, ".hint-no-url")) : locales.getText("".concat(I18N_IMG, ".hint-load-fail"))));
   }
   return /*#__PURE__*/React.createElement("img", {
     src: trimmed,

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

@@ -0,0 +1,35 @@
+/**
+ * FloorMapToolbar - 编辑态左侧侧边栏：按分类添加图元、绑定数据源与行；保存可选（默认用顶栏）
+ */
+import React from 'react';
+import type { FloorMapViewConfig, FloorMapDataSources, FloorMapMergedItem, FloorMapSceneElement, FloorMapPlaceMode } from '../types';
+import { type FloorMapPaletteDragPayload } from '../utils/floorMapDropUtils';
+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;
+}
+export declare function FloorMapToolbar(props: FloorMapToolbarProps): JSX.Element;
+export default FloorMapToolbar;