@pisell/materials 1.8.38 → 1.8.41

package/lib/components/pisellFloorMapLayout/locales.js

@@ -16,14 +16,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-top-bar.unsaved": "Unsaved",
 		"pisell-floor-map-layout.edit-top-bar.save": "Save",
 		"pisell-floor-map-layout.edit-top-bar.saving": "Saving…",
-		"pisell-floor-map-layout.edit-top-bar.undo": "Undo",
-		"pisell-floor-map-layout.edit-top-bar.redo": "Redo",
-		"pisell-floor-map-layout.edit-top-bar.cancel-edit": "Cancel",
-		"pisell-floor-map-layout.edit-top-bar.finish-edit": "Done",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-title": "Unsaved changes",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-content": "If you leave this page, any unsaved changes will be lost.",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok": "OK",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel": "Cancel",
 		"pisell-floor-map-layout.canvas-tabs.empty": "No canvas",
 		"pisell-floor-map-layout.canvas-tabs.add": "+ Add floor",
 		"pisell-floor-map-layout.canvas-tabs.add-title": "Add floor",
@@ -53,8 +45,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-panel.label-name-stage": "Display name (on canvas)",
 		"pisell-floor-map-layout.edit-panel.ph-name-stage": "e.g. stage, DJ booth, dance floor",
 		"pisell-floor-map-layout.edit-panel.ph-name": "Element name",
-		"pisell-floor-map-layout.edit-panel.label-name-as-title": "Use this name as the resource title",
-		"pisell-floor-map-layout.edit-panel.tip-name-as-title": "When enabled, this name overrides the bound record title in cards on the canvas.",
 		"pisell-floor-map-layout.edit-panel.label-image-url": "Image URL",
 		"pisell-floor-map-layout.edit-panel.extra-image-url": "Use a network image URL; lower layer to place under tables.",
 		"pisell-floor-map-layout.edit-panel.ph-https": "https://...",
@@ -95,8 +85,6 @@ var locales_default = {
 		"pisell-floor-map-layout.toolbar.layout-dirty-hint": "Layout changed — click Save to persist.",
 		"pisell-floor-map-layout.toolbar.save": "Save",
 		"pisell-floor-map-layout.toolbar.saving": "Saving…",
-		"pisell-floor-map-layout.toolbar.collapse": "Collapse panel",
-		"pisell-floor-map-layout.toolbar.expand": "Expand panel",
 		"pisell-floor-map-layout.view-controls.zoom-out-aria": "Zoom out",
 		"pisell-floor-map-layout.view-controls.zoom-in-aria": "Zoom in",
 		"pisell-floor-map-layout.view-controls.reset-aria": "Reset view",
@@ -107,8 +95,6 @@ var locales_default = {
 		"pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "Exit fullscreen",
 		"pisell-floor-map-layout.view-controls.expand-tools-aria": "Show more view tools",
 		"pisell-floor-map-layout.view-controls.collapse-tools-aria": "Hide extra view tools",
-		"pisell-floor-map-layout.view-controls.viewport-lock-aria": "Lock viewport (disable pan and zoom)",
-		"pisell-floor-map-layout.view-controls.viewport-unlock-aria": "Unlock viewport",
 		"pisell-floor-map-layout.image-element.default-name": "Image",
 		"pisell-floor-map-layout.placement.fallback-image-name": "Background",
 		"pisell-floor-map-layout.image-element.hint-no-url": "Enter the image URL in the sidebar; lower the layer to place under tables.",
@@ -126,13 +112,7 @@ var locales_default = {
 		"pisell-floor-map-layout.figma-card.kind-square-table": "Table",
 		"pisell-floor-map-layout.figma-card.default-table": "Table",
 		"pisell-floor-map-layout.figma-card.capacity-seats": "Seats {n}",
-		"pisell-floor-map-layout.figma-card.guests-count": "{n} guests",
-		"pisell-floor-map-layout.figma-card.status-available": "Available",
-		"pisell-floor-map-layout.figma-card.status-reserved": "Reserved",
-		"pisell-floor-map-layout.figma-card.status-waiting": "Waiting",
-		"pisell-floor-map-layout.figma-card.status-dining": "Dining",
-		"pisell-floor-map-layout.figma-card.status-billed": "Billed",
-		"pisell-floor-map-layout.figma-card.status-availableSoon": "Soon"
+		"pisell-floor-map-layout.figma-card.guests-count": "{n} guests"
 	},
 	"zh-CN": {
 		"pisell-floor-map-layout.loading": "加载中…",
@@ -145,14 +125,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-top-bar.unsaved": "未保存",
 		"pisell-floor-map-layout.edit-top-bar.save": "保存",
 		"pisell-floor-map-layout.edit-top-bar.saving": "保存中…",
-		"pisell-floor-map-layout.edit-top-bar.undo": "撤销",
-		"pisell-floor-map-layout.edit-top-bar.redo": "重做",
-		"pisell-floor-map-layout.edit-top-bar.cancel-edit": "取消",
-		"pisell-floor-map-layout.edit-top-bar.finish-edit": "完成",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-title": "未保存的更改",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-content": "如果退出此页面，任何未保存的更改都将丢失。",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok": "确定",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel": "取消",
 		"pisell-floor-map-layout.canvas-tabs.empty": "暂无画布",
 		"pisell-floor-map-layout.canvas-tabs.add": "+ 添加楼层",
 		"pisell-floor-map-layout.canvas-tabs.add-title": "添加楼层",
@@ -182,8 +154,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-panel.label-name-stage": "显示名称（画布上）",
 		"pisell-floor-map-layout.edit-panel.ph-name-stage": "如：舞台、DJ 台、舞池",
 		"pisell-floor-map-layout.edit-panel.ph-name": "图元名称",
-		"pisell-floor-map-layout.edit-panel.label-name-as-title": "将此名称作为资源标题",
-		"pisell-floor-map-layout.edit-panel.tip-name-as-title": "勾选后画布卡片标题以此名称为准，覆盖绑定的业务字段。",
 		"pisell-floor-map-layout.edit-panel.label-image-url": "图片地址（URL）",
 		"pisell-floor-map-layout.edit-panel.extra-image-url": "可填网络图片地址；将层级调低可铺在桌位下方作底图。",
 		"pisell-floor-map-layout.edit-panel.ph-https": "https://...",
@@ -224,8 +194,6 @@ var locales_default = {
 		"pisell-floor-map-layout.toolbar.layout-dirty-hint": "布局已修改，请点击「保存」持久化。",
 		"pisell-floor-map-layout.toolbar.save": "保存",
 		"pisell-floor-map-layout.toolbar.saving": "保存中…",
-		"pisell-floor-map-layout.toolbar.collapse": "收起面板",
-		"pisell-floor-map-layout.toolbar.expand": "展开面板",
 		"pisell-floor-map-layout.view-controls.zoom-out-aria": "缩小",
 		"pisell-floor-map-layout.view-controls.zoom-in-aria": "放大",
 		"pisell-floor-map-layout.view-controls.reset-aria": "复位",
@@ -236,8 +204,6 @@ var locales_default = {
 		"pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "退出全屏",
 		"pisell-floor-map-layout.view-controls.expand-tools-aria": "展开更多操作",
 		"pisell-floor-map-layout.view-controls.collapse-tools-aria": "收起更多操作",
-		"pisell-floor-map-layout.view-controls.viewport-lock-aria": "锁定视图（禁止拖拽和缩放）",
-		"pisell-floor-map-layout.view-controls.viewport-unlock-aria": "解锁视图",
 		"pisell-floor-map-layout.image-element.default-name": "图片图元",
 		"pisell-floor-map-layout.placement.fallback-image-name": "底图",
 		"pisell-floor-map-layout.image-element.hint-no-url": "在侧栏填写图片地址；可调层级置于桌位下方作底图",
@@ -255,13 +221,7 @@ var locales_default = {
 		"pisell-floor-map-layout.figma-card.kind-square-table": "餐桌",
 		"pisell-floor-map-layout.figma-card.default-table": "餐桌",
 		"pisell-floor-map-layout.figma-card.capacity-seats": "可坐 {n} 人",
-		"pisell-floor-map-layout.figma-card.guests-count": "{n} 人",
-		"pisell-floor-map-layout.figma-card.status-available": "空闲",
-		"pisell-floor-map-layout.figma-card.status-reserved": "已预订",
-		"pisell-floor-map-layout.figma-card.status-waiting": "等待",
-		"pisell-floor-map-layout.figma-card.status-dining": "用餐中",
-		"pisell-floor-map-layout.figma-card.status-billed": "已结账",
-		"pisell-floor-map-layout.figma-card.status-availableSoon": "即将可用"
+		"pisell-floor-map-layout.figma-card.guests-count": "{n} 人"
 	},
 	"zh-HK": {
 		"pisell-floor-map-layout.loading": "載入中…",
@@ -274,14 +234,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-top-bar.unsaved": "未儲存",
 		"pisell-floor-map-layout.edit-top-bar.save": "儲存",
 		"pisell-floor-map-layout.edit-top-bar.saving": "儲存中…",
-		"pisell-floor-map-layout.edit-top-bar.undo": "復原",
-		"pisell-floor-map-layout.edit-top-bar.redo": "取消復原",
-		"pisell-floor-map-layout.edit-top-bar.cancel-edit": "取消",
-		"pisell-floor-map-layout.edit-top-bar.finish-edit": "完成",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-title": "未儲存的變更",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-content": "如果退出此頁面，任何未儲存的變更都將遺失。",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok": "確定",
-		"pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel": "取消",
 		"pisell-floor-map-layout.canvas-tabs.empty": "暫無畫布",
 		"pisell-floor-map-layout.canvas-tabs.add": "+ 添加樓層",
 		"pisell-floor-map-layout.canvas-tabs.add-title": "添加樓層",
@@ -311,8 +263,6 @@ var locales_default = {
 		"pisell-floor-map-layout.edit-panel.label-name-stage": "顯示名稱（畫布上）",
 		"pisell-floor-map-layout.edit-panel.ph-name-stage": "如：舞台、DJ 台、舞池",
 		"pisell-floor-map-layout.edit-panel.ph-name": "圖元名稱",
-		"pisell-floor-map-layout.edit-panel.label-name-as-title": "將此名稱作為資源標題",
-		"pisell-floor-map-layout.edit-panel.tip-name-as-title": "勾選後畫布卡片標題以此名稱為準，覆蓋綁定的業務欄位。",
 		"pisell-floor-map-layout.edit-panel.label-image-url": "圖片地址（URL）",
 		"pisell-floor-map-layout.edit-panel.extra-image-url": "可填網絡圖片地址；將層級調低可鋪在桌位下方作底圖。",
 		"pisell-floor-map-layout.edit-panel.ph-https": "https://...",
@@ -353,8 +303,6 @@ var locales_default = {
 		"pisell-floor-map-layout.toolbar.layout-dirty-hint": "佈局已修改，請點擊「儲存」持久化。",
 		"pisell-floor-map-layout.toolbar.save": "儲存",
 		"pisell-floor-map-layout.toolbar.saving": "儲存中…",
-		"pisell-floor-map-layout.toolbar.collapse": "收起面板",
-		"pisell-floor-map-layout.toolbar.expand": "展開面板",
 		"pisell-floor-map-layout.view-controls.zoom-out-aria": "縮小",
 		"pisell-floor-map-layout.view-controls.zoom-in-aria": "放大",
 		"pisell-floor-map-layout.view-controls.reset-aria": "復位",
@@ -365,8 +313,6 @@ var locales_default = {
 		"pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "退出全螢幕",
 		"pisell-floor-map-layout.view-controls.expand-tools-aria": "展開更多操作",
 		"pisell-floor-map-layout.view-controls.collapse-tools-aria": "收起更多操作",
-		"pisell-floor-map-layout.view-controls.viewport-lock-aria": "鎖定視圖（禁止拖曳和縮放）",
-		"pisell-floor-map-layout.view-controls.viewport-unlock-aria": "解鎖視圖",
 		"pisell-floor-map-layout.image-element.default-name": "圖片圖元",
 		"pisell-floor-map-layout.placement.fallback-image-name": "底圖",
 		"pisell-floor-map-layout.image-element.hint-no-url": "在側欄填寫圖片地址；可調層級置於桌位下方作底圖",
@@ -384,13 +330,7 @@ var locales_default = {
 		"pisell-floor-map-layout.figma-card.kind-square-table": "餐桌",
 		"pisell-floor-map-layout.figma-card.default-table": "餐桌",
 		"pisell-floor-map-layout.figma-card.capacity-seats": "可坐 {n} 人",
-		"pisell-floor-map-layout.figma-card.guests-count": "{n} 人",
-		"pisell-floor-map-layout.figma-card.status-available": "空閒",
-		"pisell-floor-map-layout.figma-card.status-reserved": "已預訂",
-		"pisell-floor-map-layout.figma-card.status-waiting": "等待",
-		"pisell-floor-map-layout.figma-card.status-dining": "用餐中",
-		"pisell-floor-map-layout.figma-card.status-billed": "已結帳",
-		"pisell-floor-map-layout.figma-card.status-availableSoon": "即將可用"
+		"pisell-floor-map-layout.figma-card.guests-count": "{n} 人"
 	},
 	ja: require_locales_ja.default,
 	pt: require_locales_pt.default

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

@@ -1,4 +1,3 @@
-import { FloorMapAppearanceMode } from "./appearance/floorMapAppearance.js";
 import { CSSProperties, MouseEvent, ReactNode } from "react";
 
 //#region src/components/pisellFloorMapLayout/types.d.ts
@@ -52,10 +51,7 @@ interface FloorMapItemBase {
 interface FloorMapLayerConfig {
   /** 背景类型 */
   backgroundType?: FloorMapBackgroundType;
-  /**
-   * 纯色背景时的显式颜色（backgroundType 为 color 时有效）。
-   * 一旦配置，应优先于 `appearanceMode` 提供的画布背景兜底色。
-   */
+  /** 纯色背景时的颜色（backgroundType 为 color 时有效） */
   backgroundColor?: string;
   /** 图片背景 URL（backgroundType 为 image 时有效） */
   backgroundImage?: string;
@@ -120,11 +116,6 @@ interface FloorMapControlsConfig {
    * 是否显示网格开关（写入当前画布 draft 的 mapLayer.showGrid），默认 false
    */
   showGridToggle?: boolean;
-  /**
-   * 是否显示「视口锁定」按钮：锁定后画布的位置 / 缩放不允许通过任何用户交互（拖拽、滚轮、触摸缩放、缩放按钮、适配视口）改变，
-   * 防止误触改变视图。默认 false；平面图模式下由 PisellFloorMapLayout 默认置 true（与是否持久化视口到本地无关）。显式传 false 可隐藏。
-   */
-  showViewportLock?: boolean;
   /**
    * 悬浮控件条水平位置：`start` 左下（默认），`end` 右下
    */
@@ -281,15 +272,6 @@ interface FloorMapElementKindConfig {
   defaultImageUrl?: string;
   /** 无绑定或行缺失时的说明向展示 */
   defaultPresentation?: FloorMapElementDefaultPresentation;
-  /**
-   * 是否允许该 kind 的图元在编辑面板里勾选「将图元名作为资源标题」。
-   * 缺省 false：新增 kind 默认不显示该选项，需业务显式开启，向前兼容。
-   *
-   * 勾选效果（业务展示侧统一通过 {@link resolveSceneElementDisplayTitle} 接入）：
-   *   `el.name` 非空时优先于业务字段（如预约页的 `row.main_field`/`row.code`）作为标题；
-   *   未勾选保持现状（业务字段为主，`el.name` 仅作兜底）。
-   */
-  nameAsTitleConfigurable?: boolean;
 }
 /**
  * 画布/编辑器层能力：新建图元、布局与画布 Tab 的编辑权限
@@ -322,11 +304,6 @@ interface FloorMapViewConfig {
 /** 阅读态 renderItem 可选第三参数 */
 interface FloorMapRenderOptions {
   textSlotValues?: Record<string, string>;
-  /**
-   * 平面图画布当前缩放（如 TransformWrapper 的 scale）。
-   * 用于房间内卡片等需按「视觉短边」降级密度时与布局像素相乘。
-   */
-  viewportScale?: number;
 }
 /** 数据源记录表单列配置（用于编辑面板中的「数据源记录」区块） */
 interface DataSourceFormColumn {
@@ -385,7 +362,7 @@ type FloorMapFullscreenMode = 'toggle' | 'locked' | 'disabled';
  * 平面图 Layout 注入上下文：数据、保存、侧栏表单与状态等（不包含 renderItem/mapLayer 等展示向 props）。
  * 由 `FloorMapLayoutProvider` / RecordBoard `floorMapLayoutContext` 提供，与 `PisellFloorMapLayout` props 按 `??` 合并，props 优先。
  */
-type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'appearanceMode' | 'showDataSourceRecordFormBlock' | 'viewportDockToolButtons' | 'viewportDockTrailing'>>;
+type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'showDataSourceRecordFormBlock' | 'viewportDockTrailing'>>;
 /**
  * PisellFloorMapLayout 组件 Props
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
@@ -457,30 +434,10 @@ interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMapItemBas
    * 视图控制按钮显隐
    */
   controls?: FloorMapControlsConfig;
-  /**
-   * 视口（画布位置 + 缩放百分比）持久化开关，默认 `true`。
-   * 设为 `false` 时完全不读不写 localStorage，始终走 autoFit / 初始对齐行为。
-   *
-   * 仅在平面图模式（有 `floorMapConfig`）下生效；其它模式没有「画布」概念。
-   */
-  viewportPersist?: boolean;
-  /**
-   * 视口持久化的业务命名空间（建议传入店铺 / floor plan 维度的稳定标识，如 floor plan code）。
-   *
-   * 存储 key 形如 `pisell-floor-map-layout.viewport:<namespace>:<canvasId>`；
-   * 不传时 fallback 为仅用 `<canvasId>`，同一 `canvasId` 在跨业务场景（不同店铺 / 不同平面图）会共享视角，
-   * 若 `canvasId` 存在全局冲突（例如业务里使用固定常量作 canvasId），务必传入此字段做隔离。
-   */
-  viewportPersistNamespace?: string;
   /**
    * 是否开启 hover 高亮或 hover 事件，默认 true
    */
   enableHover?: boolean;
-  /**
-   * 阅读态（`mode === 'read'`）：与 {@link rowKey} 解析出的图元 id 相等时，外层容器加选中描边（如详情弹层打开时锚定画布上的桌位）。
-   * 传 `null` / `undefined` / 空字符串时不展示选中外圈。
-   */
-  readModeSelectedItemId?: string | null;
   /**
    * 资源项点击回调
    */
@@ -495,12 +452,6 @@ interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMapItemBas
   onItemLeave?: (item: T, index: number, event: MouseEvent<HTMLElement>) => void;
   /** 编辑态全屏按钮与顶栏形态，见 {@link FloorMapFullscreenMode} */
   floorMapFullscreenMode?: FloorMapFullscreenMode;
-  /**
-   * FloorMap 外观模式；当前仅提供画布背景兜底色。
-   * 若当前画布或根级 `mapLayer.backgroundColor` 显式传入颜色，应优先使用显式背景色。
-   * @default 'light'
-   */
-  appearanceMode?: FloorMapAppearanceMode;
   /**
    * 模式：read 仅展示，edit 可编辑；与 floorMapConfig 同时使用时生效
    */
@@ -515,14 +466,6 @@ interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMapItemBas
   dataSources?: FloorMapDataSources;
   /** 保存平面图配置，由上层调接口持久化 */
   onSave?: (config: FloorMapViewConfig) => void;
-  /**
-   * 退出编辑模式回调（不保存）。
-   * 传入后编辑态顶栏会展示「取消编辑」+「完成」两个按钮：
-   * - 取消编辑 → `onExitEdit()`（业务层负责把 `mode` 切回 `read`）
-   * - 完成 → 先 `onSave(config)` 再 `onExitEdit()`
-   * 不传则保持旧版「保存」按钮行为（仅保存，不退出）。
-   */
-  onExitEdit?: () => void;
   /** 保存单条数据源记录 */
   onDataSourceRecordSave?: (dataSourceKey: string, id: string, newData: Record<string, unknown>) => void;
   /** 数据源展示名，key 为 dataSourceKey */
@@ -555,10 +498,6 @@ interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMapItemBas
    * 传入且阅读态仅单画布时仍会显示顶栏以便放置该插槽；全屏入口在左下 Dock（`viewportDockTrailing` 亦放 Dock，不占顶栏）。
    */
   canvasTabsBarTrailing?: ReactNode;
-  /**
-   * 视口左下角 Dock 展开区内、与缩放/网格等工具按钮平级的业务按钮插槽。
-   */
-  viewportDockToolButtons?: ReactNode;
   /**
    * 视口左下角 Dock 展开区业务插槽（与缩放/全屏同条），不占用顶栏 Tab 行；平面图模式推荐放「编辑画布」等。
    */
@@ -587,19 +526,19 @@ type FloorMapViewportOverlayRenderArgs<T extends FloorMapItemBase = FloorMapItem
   mode: 'read' | 'edit';
 };
 /**
- * `PisellFloorMapLayout` 通过 ref 暴露的 imperative API。
- * 缩放/复位委托内部 `react-zoom-pan-pinch`；`fitBounds` / `saveLayout` 依赖当前画布与编辑状态。
+ * PisellFloorMapLayout Ref 方法
+ * @description 供外部调用缩放、复位、区域定位等
  */
 interface PisellFloorMapLayoutRef {
-  /** 在允许范围内放大一级（与右下角「+」一致） */
+  /** 放大 */
   zoomIn: () => void;
-  /** 在允许范围内缩小一级（与右下角「−」一致） */
+  /** 缩小 */
   zoomOut: () => void;
-  /** 重置 transform 为初始 scale 与 initialPosition（与「复位」控件一致） */
+  /** 复位到默认缩放与位置 */
   reset: () => void;
-  /** 计算内容包盒并将视口平移/缩放至全部图元可见 */
+  /** 区域定位：使所有 items 落在视口内 */
   fitBounds: () => void;
-  /** 触发与顶栏/侧栏相同的保存流程（无 `onSave` 时内部可能为 no-op，由 hook 决定） */
+  /** 提交当前布局草稿（与顶栏/侧栏「保存」一致） */
   saveLayout: () => void;
 }
 //#endregion

package/lib/components/pisellGoodPassCard/index.less

@@ -29,7 +29,6 @@
     }
 
     .item-content {
-      color: var(--, #8157d5);
       font-size: 16px;
       font-style: normal;
       font-weight: 400;

package/lib/components/pisellGridPro/GridView/docs/GridView.md

@@ -3,18 +3,21 @@ nav:
   title: 组件
   order: 1
 group:
-  title: Layout
+  title: 基础组件
   order: 1
-title: GridView
+title: GridView (PisellGridView)
 order: 10
 category: pro
 ---
 
 # GridView - 网格视图容器组件
 
-## 简介
+GridView（对外导出为 **PisellGridView**）是 PisellGridPro 的视图区域组件，提供带滚动的内容展示区域，通常与 Header、ToolBar、Footer 等配合使用，也可单独使用。
 
-GridView 是 PisellGridPro 的视图区域组件，提供带滚动功能的内容展示区域，通常与 ToolBar、Header、Footer 等组件配合使用，构建完整的网格布局界面。
+## 何时使用
+
+- 需要可滚动的主内容区，且与 PisellGridPro 一起构成标准页面布局
+- 单独需要一块「占满剩余高度并内部滚动」的容器时
 
 ## 特性
 
@@ -26,36 +29,33 @@ GridView 是 PisellGridPro 的视图区域组件，提供带滚动功能的内
 
 ## 基础用法
 
+从 `@pisell/materials` 引入 **PisellGridView** 使用，与 PisellGridPro、PisellToolBar 等组合构成完整页面布局。
+
 ```tsx
-import { GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridView } from '@pisell/materials';
 
 export default () => (
-  <GridView>
+  <PisellGridView>
     <div>内容区域 1</div>
     <div>内容区域 2</div>
     <div>内容区域 3</div>
-  </GridView>
+  </PisellGridView>
 );
 ```
 
 ## 与 PisellGridPro 配合使用
 
 ```tsx
-import { PisellGridPro, GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridPro, PisellToolBar, PisellGridView } from '@pisell/materials';
 
 export default () => (
   <PisellGridPro>
-    {/* 头部工具栏 */}
-    <PisellGridPro.ToolBar>
-      <div>工具栏</div>
-    </PisellGridPro.ToolBar>
-
-    {/* 视图区域 */}
-    <GridView>
+    <PisellToolBar topLeft={<div>工具栏</div>} />
+    <PisellGridView>
       <div>主要内容区域</div>
-    </GridView>
-
-    {/* 底部区域 */}
+    </PisellGridView>
     <PisellGridPro.Footer>
       <div>底部信息</div>
     </PisellGridPro.Footer>
@@ -65,23 +65,24 @@ export default () => (
 
 ## API
 
-### GridView Props
+### GridView (PisellGridView) Props
 
-| 参数      | 说明       | 类型              | 默认值 | 版本 |
+| 参数      | 说明       | 类型              | 默认值 | 必填 |
 | --------- | ---------- | ----------------- | ------ | ---- |
-| children  | 子元素内容 | `React.ReactNode` | -      | -    |
-| className | 自定义类名 | `string`          | -      | -    |
-| style     | 自定义样式 | `CSSProperties`   | -      | -    |
+| children  | 子元素内容 | `React.ReactNode` | -      | ✅   |
+| className | 自定义类名 | `string`          | -      | ❌   |
+| style     | 自定义样式 | `CSSProperties`   | -      | ❌   |
 
 ## 进阶用法
 
 ### 自定义样式
 
 ```tsx
-import { GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridView } from '@pisell/materials';
 
 export default () => (
-  <GridView
+  <PisellGridView
     className="custom-grid-view"
     style={{
       backgroundColor: '#f5f5f5',
@@ -89,18 +90,19 @@ export default () => (
     }}
   >
     <div>自定义样式的内容区域</div>
-  </GridView>
+  </PisellGridView>
 );
 ```
 
 ### 嵌套布局
 
 ```tsx
-import { GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridView } from '@pisell/materials';
 import { Row, Col } from 'antd';
 
 export default () => (
-  <GridView>
+  <PisellGridView>
     <Row gutter={16}>
       <Col span={8}>
         <div>列 1</div>
@@ -112,14 +114,15 @@ export default () => (
         <div>列 3</div>
       </Col>
     </Row>
-  </GridView>
+  </PisellGridView>
 );
 ```
 
 ### 包含数据卡片
 
 ```tsx
-import { GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridView } from '@pisell/materials';
 import { Card } from 'antd';
 
 const dataList = [
@@ -129,35 +132,35 @@ const dataList = [
 ];
 
 export default () => (
-  <GridView>
+  <PisellGridView>
     {dataList.map((item) => (
       <Card key={item.id} title={item.title} style={{ marginBottom: 16 }}>
         {item.content}
       </Card>
     ))}
-  </GridView>
+  </PisellGridView>
 );
 ```
 
 ### 完整的 GridPro 布局示例
 
 ```tsx
-import { PisellGridPro, GridView } from '@pisell/materials';
+import React from 'react';
+import { PisellGridPro, PisellToolBar, PisellGridView } from '@pisell/materials';
 import { Button, Space } from 'antd';
 
 export default () => (
   <PisellGridPro style={{ height: '100vh' }}>
-    {/* 工具栏 */}
-    <PisellGridPro.ToolBar>
-      <Space>
-        <Button type="primary">新建</Button>
-        <Button>刷新</Button>
-        <Button>导出</Button>
-      </Space>
-    </PisellGridPro.ToolBar>
-
-    {/* 视图区域 - 自动滚动 */}
-    <GridView>
+    <PisellToolBar
+      topLeft={
+        <Space>
+          <Button type="primary">新建</Button>
+          <Button>刷新</Button>
+          <Button>导出</Button>
+        </Space>
+      }
+    />
+    <PisellGridView>
       {Array.from({ length: 20 }).map((_, index) => (
         <div
           key={index}
@@ -171,9 +174,7 @@ export default () => (
           内容项 {index + 1}
         </div>
       ))}
-    </GridView>
-
-    {/* 底部 */}
+    </PisellGridView>
     <PisellGridPro.Footer>
       <div style={{ textAlign: 'center' }}>共 20 条数据</div>
     </PisellGridPro.Footer>

package/lib/components/pisellGridPro/ToolBar/docs/ToolBar.$tab-dev.md

@@ -1,9 +1,8 @@
 ---
-
-## title: 开发文档
-
+title: 开发文档
 order: 3
 category: sub-component
+---
 
 # ToolBar 开发文档
 
@@ -351,4 +350,3 @@ A: 根据 Figma 设计稿，左侧区域使用 8px 间距，右侧区域使用 1
   - 支持 tabs、topLeft、topRight、bottomLeft、bottomRight 六个插槽
   - 支持自定义 className 和 style
   - 基于 Figma 设计稿实现
-