@pisell/materials 1.8.41 → 1.8.42

package/es/components/pisellFloorMapLayout/locales-ja.js

@@ -13,6 +13,14 @@ var locales_ja_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": "フロアを追加",
@@ -26,6 +34,10 @@ var locales_ja_default = {
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-title": "キャンバスの名前を変更",
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "OK",
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "キャンセル",
+	"pisell-floor-map-layout.canvas-tabs.overview": "全体",
+	"pisell-floor-map-layout.canvas-tabs.overview-aria": "すべてのキャンバスを表示",
+	"pisell-floor-map-layout.overview.empty": "全体表示できるキャンバスがありません",
+	"pisell-floor-map-layout.overview.canvas-card-aria": "キャンバス {name} を開く",
 	"pisell-floor-map-layout.edit-panel.element-props": "要素のプロパティ",
 	"pisell-floor-map-layout.edit-panel.close-aria": "閉じる",
 	"pisell-floor-map-layout.edit-panel.hint-apply": "位置・サイズが変更されました。「適用」でキャンバスに反映してください。",
@@ -42,6 +54,11 @@ var locales_ja_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-builtin-shape": "組み込み図形",
+	"pisell-floor-map-layout.edit-panel.extra-builtin-shape": "組み込み図形から選択。レイヤーを下げてテーブルの下に敷くこともできます。",
+	"pisell-floor-map-layout.edit-panel.ph-builtin-shape": "図形を選択",
 	"pisell-floor-map-layout.edit-panel.label-image-url": "画像 URL",
 	"pisell-floor-map-layout.edit-panel.extra-image-url": "ネットワーク上の画像 URL を指定。重なり順を下げるとテーブルの下に配置できます。",
 	"pisell-floor-map-layout.edit-panel.ph-https": "https://...",
@@ -82,6 +99,9 @@ var locales_ja_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.toolbar.add-to-canvas": "キャンバスに追加",
 	"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": "表示をリセット",
@@ -92,6 +112,18 @@ var locales_ja_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.builtin-shape.default-name": "組み込み図形",
+	"pisell-floor-map-layout.builtin-shape.hint-no-key": "サイドバーで組み込み図形を選択してください。",
+	"pisell-floor-map-layout.builtin-shape.toilet": "トイレ",
+	"pisell-floor-map-layout.builtin-shape.divider": "パーティション",
+	"pisell-floor-map-layout.builtin-shape.column": "柱",
+	"pisell-floor-map-layout.builtin-shape.sofa": "ソファ",
+	"pisell-floor-map-layout.builtin-shape.door": "出入口",
+	"pisell-floor-map-layout.builtin-shape.flower-pot": "植木鉢",
+	"pisell-floor-map-layout.builtin-shape.palette-pick-label": "組み込み図形を選択",
+	"pisell-floor-map-layout.palette.builtin-shape": "組み込み図形",
 	"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": "サイドバーで画像 URL を入力。重なり順を下げるとテーブル下の背景にできます。",
@@ -109,7 +141,13 @@ var locales_ja_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.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": "間もなく"
 };
 //#endregion
 export { locales_ja_default as default };

package/es/components/pisellFloorMapLayout/locales-pt.js

@@ -13,6 +13,14 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.edit-top-bar.unsaved": "Não guardado",
 	"pisell-floor-map-layout.edit-top-bar.save": "Guardar",
 	"pisell-floor-map-layout.edit-top-bar.saving": "A guardar…",
+	"pisell-floor-map-layout.edit-top-bar.undo": "Anular",
+	"pisell-floor-map-layout.edit-top-bar.redo": "Refazer",
+	"pisell-floor-map-layout.edit-top-bar.cancel-edit": "Cancelar",
+	"pisell-floor-map-layout.edit-top-bar.finish-edit": "Concluir",
+	"pisell-floor-map-layout.edit-top-bar.cancel-confirm-title": "Alterações não guardadas",
+	"pisell-floor-map-layout.edit-top-bar.cancel-confirm-content": "Se sair desta página, quaisquer alterações não guardadas serão perdidas.",
+	"pisell-floor-map-layout.edit-top-bar.cancel-confirm-ok": "OK",
+	"pisell-floor-map-layout.edit-top-bar.cancel-confirm-cancel": "Cancelar",
 	"pisell-floor-map-layout.canvas-tabs.empty": "Sem canvas",
 	"pisell-floor-map-layout.canvas-tabs.add": "+ Adicionar piso",
 	"pisell-floor-map-layout.canvas-tabs.add-title": "Adicionar piso",
@@ -26,6 +34,10 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-title": "Renomear canvas",
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "OK",
 	"pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "Cancelar",
+	"pisell-floor-map-layout.canvas-tabs.overview": "Todos",
+	"pisell-floor-map-layout.canvas-tabs.overview-aria": "Visualizar todas as telas",
+	"pisell-floor-map-layout.overview.empty": "Nenhuma tela disponível para visão geral",
+	"pisell-floor-map-layout.overview.canvas-card-aria": "Abrir tela {name}",
 	"pisell-floor-map-layout.edit-panel.element-props": "Propriedades do elemento",
 	"pisell-floor-map-layout.edit-panel.close-aria": "Fechar",
 	"pisell-floor-map-layout.edit-panel.hint-apply": "Posição ou tamanho alterados. Clique em «Aplicar» para actualizar o canvas.",
@@ -42,6 +54,11 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.edit-panel.label-name-stage": "Nome (no canvas)",
 	"pisell-floor-map-layout.edit-panel.ph-name-stage": "Ex.: palco, cabine DJ, pista de dança",
 	"pisell-floor-map-layout.edit-panel.ph-name": "Nome do elemento",
+	"pisell-floor-map-layout.edit-panel.label-name-as-title": "Usar este nome como título do recurso",
+	"pisell-floor-map-layout.edit-panel.tip-name-as-title": "Quando ativado, este nome substitui o título do registro vinculado nos cards do mapa.",
+	"pisell-floor-map-layout.edit-panel.label-builtin-shape": "Forma embutida",
+	"pisell-floor-map-layout.edit-panel.extra-builtin-shape": "Escolha uma forma embutida; reduza a camada para colocar sob as mesas.",
+	"pisell-floor-map-layout.edit-panel.ph-builtin-shape": "Selecione uma forma",
 	"pisell-floor-map-layout.edit-panel.label-image-url": "URL da imagem",
 	"pisell-floor-map-layout.edit-panel.extra-image-url": "URL de imagem na rede. Baixe a ordem para colocar atrás das mesas.",
 	"pisell-floor-map-layout.edit-panel.ph-https": "https://...",
@@ -82,6 +99,9 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.toolbar.layout-dirty-hint": "O layout foi alterado. Use «Guardar» para confirmar.",
 	"pisell-floor-map-layout.toolbar.save": "Guardar",
 	"pisell-floor-map-layout.toolbar.saving": "A guardar…",
+	"pisell-floor-map-layout.toolbar.collapse": "Recolher painel",
+	"pisell-floor-map-layout.toolbar.expand": "Expandir painel",
+	"pisell-floor-map-layout.toolbar.add-to-canvas": "Adicionar à tela",
 	"pisell-floor-map-layout.view-controls.zoom-out-aria": "Reduzir zoom",
 	"pisell-floor-map-layout.view-controls.zoom-in-aria": "Aumentar zoom",
 	"pisell-floor-map-layout.view-controls.reset-aria": "Repor vista",
@@ -92,6 +112,18 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.view-controls.fullscreen-exit-aria": "Sair do ecrã inteiro",
 	"pisell-floor-map-layout.view-controls.expand-tools-aria": "Mostrar mais ferramentas de vista",
 	"pisell-floor-map-layout.view-controls.collapse-tools-aria": "Ocultar ferramentas extra",
+	"pisell-floor-map-layout.view-controls.viewport-lock-aria": "Bloquear vista (desativar deslocação e zoom)",
+	"pisell-floor-map-layout.view-controls.viewport-unlock-aria": "Desbloquear vista",
+	"pisell-floor-map-layout.builtin-shape.default-name": "Forma embutida",
+	"pisell-floor-map-layout.builtin-shape.hint-no-key": "Selecione uma forma embutida na barra lateral.",
+	"pisell-floor-map-layout.builtin-shape.toilet": "Banheiro",
+	"pisell-floor-map-layout.builtin-shape.divider": "Divisória",
+	"pisell-floor-map-layout.builtin-shape.column": "Coluna",
+	"pisell-floor-map-layout.builtin-shape.sofa": "Sofá",
+	"pisell-floor-map-layout.builtin-shape.door": "Porta",
+	"pisell-floor-map-layout.builtin-shape.flower-pot": "Vaso de planta",
+	"pisell-floor-map-layout.builtin-shape.palette-pick-label": "Escolher forma embutida",
+	"pisell-floor-map-layout.palette.builtin-shape": "Forma embutida",
 	"pisell-floor-map-layout.image-element.default-name": "Elemento de imagem",
 	"pisell-floor-map-layout.placement.fallback-image-name": "Fundo",
 	"pisell-floor-map-layout.image-element.hint-no-url": "Introduza o URL da imagem na barra lateral. Baixe a ordem para ficar atrás das mesas.",
@@ -109,7 +141,13 @@ var locales_pt_default = {
 	"pisell-floor-map-layout.figma-card.kind-square-table": "Mesa",
 	"pisell-floor-map-layout.figma-card.default-table": "Mesa",
 	"pisell-floor-map-layout.figma-card.capacity-seats": "Lotação {n}",
-	"pisell-floor-map-layout.figma-card.guests-count": "{n} pessoas"
+	"pisell-floor-map-layout.figma-card.guests-count": "{n} pessoas",
+	"pisell-floor-map-layout.figma-card.status-available": "Livre",
+	"pisell-floor-map-layout.figma-card.status-reserved": "Reservada",
+	"pisell-floor-map-layout.figma-card.status-waiting": "Aguardando",
+	"pisell-floor-map-layout.figma-card.status-dining": "Em uso",
+	"pisell-floor-map-layout.figma-card.status-billed": "Cobrada",
+	"pisell-floor-map-layout.figma-card.status-availableSoon": "Em breve"
 };
 //#endregion
 export { locales_pt_default as default };

package/es/components/pisellFloorMapLayout/locales.js

@@ -16,6 +16,14 @@ 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",
@@ -29,6 +37,10 @@ var locales_default = {
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-title": "Rename canvas",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "OK",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "Cancel",
+		"pisell-floor-map-layout.canvas-tabs.overview": "All",
+		"pisell-floor-map-layout.canvas-tabs.overview-aria": "View all canvases",
+		"pisell-floor-map-layout.overview.empty": "No canvas to display in overview.",
+		"pisell-floor-map-layout.overview.canvas-card-aria": "Open canvas {name}",
 		"pisell-floor-map-layout.edit-panel.element-props": "Element",
 		"pisell-floor-map-layout.edit-panel.close-aria": "Close",
 		"pisell-floor-map-layout.edit-panel.hint-apply": "Position or size changed — click Apply to update the canvas.",
@@ -45,9 +57,14 @@ 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://...",
+		"pisell-floor-map-layout.edit-panel.label-builtin-shape": "Built-in shape",
+		"pisell-floor-map-layout.edit-panel.extra-builtin-shape": "Pick a built-in graphic; lower the layer to place under tables.",
+		"pisell-floor-map-layout.edit-panel.ph-builtin-shape": "Select a shape",
 		"pisell-floor-map-layout.edit-panel.label-canvas": "Canvas",
 		"pisell-floor-map-layout.edit-panel.label-element-kind": "Element type",
 		"pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "Data binding was cleared because it does not apply to the new type.",
@@ -85,6 +102,9 @@ 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.toolbar.add-to-canvas": "Add to canvas",
 		"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",
@@ -95,10 +115,22 @@ 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.",
 		"pisell-floor-map-layout.image-element.hint-load-fail": "Failed to load image; check the URL.",
+		"pisell-floor-map-layout.builtin-shape.default-name": "Built-in shape",
+		"pisell-floor-map-layout.builtin-shape.hint-no-key": "Pick a built-in shape in the sidebar.",
+		"pisell-floor-map-layout.builtin-shape.toilet": "Toilet",
+		"pisell-floor-map-layout.builtin-shape.divider": "Divider",
+		"pisell-floor-map-layout.builtin-shape.column": "Column",
+		"pisell-floor-map-layout.builtin-shape.sofa": "Sofa",
+		"pisell-floor-map-layout.builtin-shape.door": "Door",
+		"pisell-floor-map-layout.builtin-shape.flower-pot": "Flower pot",
+		"pisell-floor-map-layout.builtin-shape.palette-pick-label": "Pick a built-in shape",
+		"pisell-floor-map-layout.palette.builtin-shape": "Built-in shape",
 		"pisell-floor-map-layout.data-form.empty": "No extra fields to edit",
 		"pisell-floor-map-layout.data-form.save-record": "Save record",
 		"pisell-floor-map-layout.binding-error.required-row": "This element must be bound to a data row.",
@@ -112,7 +144,13 @@ 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.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"
 	},
 	"zh-CN": {
 		"pisell-floor-map-layout.loading": "加载中…",
@@ -125,6 +163,14 @@ 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": "添加楼层",
@@ -138,6 +184,10 @@ var locales_default = {
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-title": "重命名画布",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "确定",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "取消",
+		"pisell-floor-map-layout.canvas-tabs.overview": "全览",
+		"pisell-floor-map-layout.canvas-tabs.overview-aria": "查看所有画布",
+		"pisell-floor-map-layout.overview.empty": "暂无可全览的画布",
+		"pisell-floor-map-layout.overview.canvas-card-aria": "打开画布 {name}",
 		"pisell-floor-map-layout.edit-panel.element-props": "图元属性",
 		"pisell-floor-map-layout.edit-panel.close-aria": "关闭",
 		"pisell-floor-map-layout.edit-panel.hint-apply": "位置、尺寸等已修改，请点击「应用」同步到画布。",
@@ -154,9 +204,14 @@ 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://...",
+		"pisell-floor-map-layout.edit-panel.label-builtin-shape": "内置图形",
+		"pisell-floor-map-layout.edit-panel.extra-builtin-shape": "从内置图形中选择；将层级调低可铺在桌位下方。",
+		"pisell-floor-map-layout.edit-panel.ph-builtin-shape": "请选择图形",
 		"pisell-floor-map-layout.edit-panel.label-canvas": "所属画布",
 		"pisell-floor-map-layout.edit-panel.label-element-kind": "图元类型",
 		"pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "新类型与原先绑定不兼容，已清除数据绑定。",
@@ -194,6 +249,9 @@ 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.toolbar.add-to-canvas": "添加到画布",
 		"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": "复位",
@@ -204,10 +262,22 @@ 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": "在侧栏填写图片地址；可调层级置于桌位下方作底图",
 		"pisell-floor-map-layout.image-element.hint-load-fail": "图片加载失败，请检查地址",
+		"pisell-floor-map-layout.builtin-shape.default-name": "内置图形",
+		"pisell-floor-map-layout.builtin-shape.hint-no-key": "在侧栏选择内置图形",
+		"pisell-floor-map-layout.builtin-shape.toilet": "厕所",
+		"pisell-floor-map-layout.builtin-shape.divider": "分隔",
+		"pisell-floor-map-layout.builtin-shape.column": "柱子",
+		"pisell-floor-map-layout.builtin-shape.sofa": "沙发",
+		"pisell-floor-map-layout.builtin-shape.door": "大门",
+		"pisell-floor-map-layout.builtin-shape.flower-pot": "花盆",
+		"pisell-floor-map-layout.builtin-shape.palette-pick-label": "选择内置图形",
+		"pisell-floor-map-layout.palette.builtin-shape": "内置图形",
 		"pisell-floor-map-layout.data-form.empty": "无额外字段可编辑",
 		"pisell-floor-map-layout.data-form.save-record": "保存记录",
 		"pisell-floor-map-layout.binding-error.required-row": "该图元须绑定数据源行",
@@ -221,7 +291,13 @@ 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.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": "即将可用"
 	},
 	"zh-HK": {
 		"pisell-floor-map-layout.loading": "載入中…",
@@ -234,6 +310,14 @@ 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": "添加樓層",
@@ -247,6 +331,10 @@ var locales_default = {
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-title": "重新命名畫布",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-ok": "確定",
 		"pisell-floor-map-layout.canvas-tabs.rename-modal-cancel": "取消",
+		"pisell-floor-map-layout.canvas-tabs.overview": "全覽",
+		"pisell-floor-map-layout.canvas-tabs.overview-aria": "檢視所有畫布",
+		"pisell-floor-map-layout.overview.empty": "暫無可全覽的畫布",
+		"pisell-floor-map-layout.overview.canvas-card-aria": "開啟畫布 {name}",
 		"pisell-floor-map-layout.edit-panel.element-props": "圖元屬性",
 		"pisell-floor-map-layout.edit-panel.close-aria": "關閉",
 		"pisell-floor-map-layout.edit-panel.hint-apply": "位置、尺寸等已修改，請點擊「套用」同步到畫布。",
@@ -263,9 +351,14 @@ 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://...",
+		"pisell-floor-map-layout.edit-panel.label-builtin-shape": "內置圖形",
+		"pisell-floor-map-layout.edit-panel.extra-builtin-shape": "從內置圖形中選擇；將層級調低可鋪在桌位下方。",
+		"pisell-floor-map-layout.edit-panel.ph-builtin-shape": "請選擇圖形",
 		"pisell-floor-map-layout.edit-panel.label-canvas": "所屬畫布",
 		"pisell-floor-map-layout.edit-panel.label-element-kind": "圖元類型",
 		"pisell-floor-map-layout.edit-panel.hint-kind-binding-cleared": "新類型與原先綁定不相容，已清除數據綁定。",
@@ -303,6 +396,9 @@ 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.toolbar.add-to-canvas": "新增到畫布",
 		"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": "復位",
@@ -313,10 +409,22 @@ 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": "在側欄填寫圖片地址；可調層級置於桌位下方作底圖",
 		"pisell-floor-map-layout.image-element.hint-load-fail": "圖片載入失敗，請檢查地址",
+		"pisell-floor-map-layout.builtin-shape.default-name": "內置圖形",
+		"pisell-floor-map-layout.builtin-shape.hint-no-key": "在側欄選擇內置圖形",
+		"pisell-floor-map-layout.builtin-shape.toilet": "廁所",
+		"pisell-floor-map-layout.builtin-shape.divider": "分隔",
+		"pisell-floor-map-layout.builtin-shape.column": "柱子",
+		"pisell-floor-map-layout.builtin-shape.sofa": "沙發",
+		"pisell-floor-map-layout.builtin-shape.door": "大門",
+		"pisell-floor-map-layout.builtin-shape.flower-pot": "花盆",
+		"pisell-floor-map-layout.builtin-shape.palette-pick-label": "選擇內置圖形",
+		"pisell-floor-map-layout.palette.builtin-shape": "內置圖形",
 		"pisell-floor-map-layout.data-form.empty": "無額外欄位可編輯",
 		"pisell-floor-map-layout.data-form.save-record": "儲存記錄",
 		"pisell-floor-map-layout.binding-error.required-row": "該圖元須綁定數據源列",
@@ -330,7 +438,13 @@ 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.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": "即將可用"
 	},
 	ja: locales_ja_default,
 	pt: locales_pt_default

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

@@ -1,3 +1,4 @@
+import { FloorMapAppearanceMode } from "./appearance/floorMapAppearance.js";
 import { CSSProperties, MouseEvent, ReactNode } from "react";
 
 //#region src/components/pisellFloorMapLayout/types.d.ts
@@ -51,7 +52,10 @@ interface FloorMapItemBase {
 interface FloorMapLayerConfig {
   /** 背景类型 */
   backgroundType?: FloorMapBackgroundType;
-  /** 纯色背景时的颜色（backgroundType 为 color 时有效） */
+  /**
+   * 纯色背景时的显式颜色（backgroundType 为 color 时有效）。
+   * 一旦配置，应优先于 `appearanceMode` 提供的画布背景兜底色。
+   */
   backgroundColor?: string;
   /** 图片背景 URL（backgroundType 为 image 时有效） */
   backgroundImage?: string;
@@ -116,6 +120,11 @@ interface FloorMapControlsConfig {
    * 是否显示网格开关（写入当前画布 draft 的 mapLayer.showGrid），默认 false
    */
   showGridToggle?: boolean;
+  /**
+   * 是否显示「视口锁定」按钮：锁定后画布的位置 / 缩放不允许通过任何用户交互（拖拽、滚轮、触摸缩放、缩放按钮、适配视口）改变，
+   * 防止误触改变视图。默认 false；平面图模式下由 PisellFloorMapLayout 默认置 true（与是否持久化视口到本地无关）。显式传 false 可隐藏。
+   */
+  showViewportLock?: boolean;
   /**
    * 悬浮控件条水平位置：`start` 左下（默认），`end` 右下
    */
@@ -209,6 +218,11 @@ interface FloorMapSceneElement {
   svgPath?: string;
   svgUrl?: string;
   imageUrl?: string;
+  /**
+   * 内置图形图元（`floorMapBuiltinShape`）的预设图形 key（如 `toilet`/`sofa` 等）。
+   * 非内置图形 kind 时不会被读取；由 {@link FLOOR_MAP_BUILTIN_SHAPES} 枚举驱动。
+   */
+  builtinShapeKey?: string;
   extensions?: Record<string, unknown>;
   dataBinding?: FloorMapSceneElementDataBinding;
   /**
@@ -226,6 +240,12 @@ declare const FLOOR_MAP_STAGE_ELEMENT_KIND = "stage";
  * 图片图元：无数据源绑定，通过 `imageUrl` 展示位图；适合铺底图或与业务图元叠放（调 `zIndex`）。
  */
 declare const FLOOR_MAP_IMAGE_ELEMENT_KIND = "floorMapImage";
+/**
+ * 内置图形图元：无数据源绑定，通过 `builtinShapeKey` 在内置枚举（厕所 / 分隔 / 柱子 /
+ * 沙发 / 大门）中选择预设图形。形状由 {@link FLOOR_MAP_BUILTIN_SHAPES} 驱动，
+ * 与图片图元等同地铺底 / 标记场地结构。
+ */
+declare const FLOOR_MAP_BUILTIN_SHAPE_ELEMENT_KIND = "floorMapBuiltinShape";
 /** 图元是否接受数据源及是否必填 */
 type FloorMapElementDataBindingPolicy = 'none' | 'optional' | 'required';
 /** 图元种类所属分类（调色板分组） */
@@ -272,6 +292,15 @@ interface FloorMapElementKindConfig {
   defaultImageUrl?: string;
   /** 无绑定或行缺失时的说明向展示 */
   defaultPresentation?: FloorMapElementDefaultPresentation;
+  /**
+   * 是否允许该 kind 的图元在编辑面板里勾选「将图元名作为资源标题」。
+   * 缺省 false：新增 kind 默认不显示该选项，需业务显式开启，向前兼容。
+   *
+   * 勾选效果（业务展示侧统一通过 {@link resolveSceneElementDisplayTitle} 接入）：
+   *   `el.name` 非空时优先于业务字段（如预约页的 `row.main_field`/`row.code`）作为标题；
+   *   未勾选保持现状（业务字段为主，`el.name` 仅作兜底）。
+   */
+  nameAsTitleConfigurable?: boolean;
 }
 /**
  * 画布/编辑器层能力：新建图元、布局与画布 Tab 的编辑权限
@@ -304,6 +333,11 @@ interface FloorMapViewConfig {
 /** 阅读态 renderItem 可选第三参数 */
 interface FloorMapRenderOptions {
   textSlotValues?: Record<string, string>;
+  /**
+   * 平面图画布当前缩放（如 TransformWrapper 的 scale）。
+   * 用于房间内卡片等需按「视觉短边」降级密度时与布局像素相乘。
+   */
+  viewportScale?: number;
 }
 /** 数据源记录表单列配置（用于编辑面板中的「数据源记录」区块） */
 interface DataSourceFormColumn {
@@ -362,7 +396,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' | 'showDataSourceRecordFormBlock' | 'viewportDockTrailing'>>;
+type FloorMapLayoutContextValue = Partial<Pick<PisellFloorMapLayoutProps<FloorMapItemBase>, 'floorMapConfig' | 'dataSources' | 'onSave' | 'onDataSourceRecordSave' | 'dataSourceLabels' | 'dataSourceFormColumns' | 'dataSourceRecordForm' | 'loading' | 'saveError' | 'onElementRenderError' | 'toolbarShowSave' | 'floorMapFullscreenMode' | 'appearanceMode' | 'showDataSourceRecordFormBlock' | 'viewportDockToolButtons' | 'viewportDockTrailing'>>;
 /**
  * PisellFloorMapLayout 组件 Props
  * @template T - 资源项类型，需继承 FloorMapItemBase 或兼容 id/x/y
@@ -434,10 +468,30 @@ 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;
   /**
    * 资源项点击回调
    */
@@ -452,6 +506,12 @@ 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 同时使用时生效
    */
@@ -466,6 +526,14 @@ 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 */
@@ -493,11 +561,19 @@ interface PisellFloorMapLayoutProps<T extends FloorMapItemBase = FloorMapItemBas
    * 为 false 时隐藏侧栏「数据源记录」表单区（保留数据绑定选源/选行）。
    */
   showDataSourceRecordFormBlock?: boolean;
+  /**
+   * 手机布局：编辑态顶栏拆成两行（画布 Tab 一行 + 撤销/完成等一行），并收紧内边距。
+   */
+  editTopBarPhoneLayout?: boolean;
   /**
    * 画布 Tab 行右侧扩展（阅读态顶栏、编辑态 compact/full 顶栏）。
    * 传入且阅读态仅单画布时仍会显示顶栏以便放置该插槽；全屏入口在左下 Dock（`viewportDockTrailing` 亦放 Dock，不占顶栏）。
    */
   canvasTabsBarTrailing?: ReactNode;
+  /**
+   * 视口左下角 Dock 展开区内、与缩放/网格等工具按钮平级的业务按钮插槽。
+   */
+  viewportDockToolButtons?: ReactNode;
   /**
    * 视口左下角 Dock 展开区业务插槽（与缩放/全屏同条），不占用顶栏 Tab 行；平面图模式推荐放「编辑画布」等。
    */
@@ -526,20 +602,20 @@ type FloorMapViewportOverlayRenderArgs<T extends FloorMapItemBase = FloorMapItem
   mode: 'read' | 'edit';
 };
 /**
- * PisellFloorMapLayout Ref 方法
- * @description 供外部调用缩放、复位、区域定位等
+ * `PisellFloorMapLayout` 通过 ref 暴露的 imperative API。
+ * 缩放/复位委托内部 `react-zoom-pan-pinch`；`fitBounds` / `saveLayout` 依赖当前画布与编辑状态。
  */
 interface PisellFloorMapLayoutRef {
-  /** 放大 */
+  /** 在允许范围内放大一级（与右下角「+」一致） */
   zoomIn: () => void;
-  /** 缩小 */
+  /** 在允许范围内缩小一级（与右下角「−」一致） */
   zoomOut: () => void;
-  /** 复位到默认缩放与位置 */
+  /** 重置 transform 为初始 scale 与 initialPosition（与「复位」控件一致） */
   reset: () => void;
-  /** 区域定位：使所有 items 落在视口内 */
+  /** 计算内容包盒并将视口平移/缩放至全部图元可见 */
   fitBounds: () => void;
-  /** 提交当前布局草稿（与顶栏/侧栏「保存」一致） */
+  /** 触发与顶栏/侧栏相同的保存流程（无 `onSave` 时内部可能为 no-op，由 hook 决定） */
   saveLayout: () => void;
 }
 //#endregion
-export { DataSourceFormColumn, FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND, FloorMapBackgroundType, FloorMapCanvas, FloorMapCanvasNameI18n, FloorMapCanvasUiConfig, FloorMapControlsConfig, FloorMapDataSourceRecordFormContent, FloorMapDataSources, FloorMapEdge, FloorMapElementDataBindingPolicy, FloorMapElementDefaultPresentation, FloorMapElementKindCategory, FloorMapElementKindConfig, FloorMapFullscreenMode, FloorMapGridLayoutConfig, FloorMapItemBase, FloorMapItemShape, FloorMapItemUnit, FloorMapLayerConfig, FloorMapLayoutContextValue, FloorMapLayoutMode, FloorMapMergedItem, FloorMapPanBoundary, FloorMapPanConfig, FloorMapRecordFormRenderContext, FloorMapRenderOptions, FloorMapSceneElement, FloorMapSceneElementDataBinding, FloorMapTextSlot, FloorMapViewConfig, FloorMapViewportOverlayRenderArgs, FloorMapZoomConfig, PisellFloorMapLayoutProps, PisellFloorMapLayoutRef };
+export { DataSourceFormColumn, FLOOR_MAP_BUILTIN_SHAPE_ELEMENT_KIND, FLOOR_MAP_IMAGE_ELEMENT_KIND, FLOOR_MAP_STAGE_ELEMENT_KIND, FloorMapBackgroundType, FloorMapCanvas, FloorMapCanvasNameI18n, FloorMapCanvasUiConfig, FloorMapControlsConfig, FloorMapDataSourceRecordFormContent, FloorMapDataSources, FloorMapEdge, FloorMapElementDataBindingPolicy, FloorMapElementDefaultPresentation, FloorMapElementKindCategory, FloorMapElementKindConfig, FloorMapFullscreenMode, FloorMapGridLayoutConfig, FloorMapItemBase, FloorMapItemShape, FloorMapItemUnit, FloorMapLayerConfig, FloorMapLayoutContextValue, FloorMapLayoutMode, FloorMapMergedItem, FloorMapPanBoundary, FloorMapPanConfig, FloorMapRecordFormRenderContext, FloorMapRenderOptions, FloorMapSceneElement, FloorMapSceneElementDataBinding, FloorMapTextSlot, FloorMapViewConfig, FloorMapViewportOverlayRenderArgs, FloorMapZoomConfig, PisellFloorMapLayoutProps, PisellFloorMapLayoutRef };