From 36404e7a55c420210d51e9cf3f1601ea887187aa Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Sun, 9 Aug 2026 18:16:11 +0000
Subject: [PATCH] fix(metadata-admin): page block inspector curated labels
 follow the locale (#3913)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The inspector's chrome went through `t('engine.inspector.pageBlock.*')` from the
start while the panel's CONTENTS did not: every `label` in
`previews/block-config.ts` was an English literal handed straight to the field
components. A zh-CN admin opening any page block read 「属性」 over a stack of
English field names.

All 157 label literals (152 field/option labels + 5 addLabel) are now
translation keys resolved through `t(key, locale)` at render, with 154 distinct
keys added to both the en-US and zh-CN sides of `metadata-admin/i18n.ts`. The
English text is unchanged: substituting every key back to its en value
reproduces the pre-change data region byte-for-byte.

Key shape is derived from the label's POSITION in BLOCK_CONFIG
(`.field.<blockType>.<name>`, `.add.<blockType>.<name>`,
`.option.<fieldName>.<value>`) and a test re-derives it, because these keys
differ by one segment: copy-pasting a neighbouring block's key yields one that
EXISTS in both locales and renders a plausible label for the wrong property, so
an existence-only check is green for it. Positional keys also let one English
word take different Chinese per block (`element:button.label` is 「按钮文字」,
`page:tabs.items.label` is 「标签」).

`addLabel` becomes REQUIRED on the array variant: it was optional and the
inspector fell back to a bare English 'Add' that no locale table could reach.
Requiring it deletes the fallback rather than translating it.

Option labels are translated too, including the ones ColorVariantPicker renders
only as aria-label/title.
---
 ...block-inspector-curated-label-i18n-3913.md |  41 ++
 .../src/views/metadata-admin/i18n.ts          | 317 ++++++++++++++++
 .../PageBlockInspector.i18n.test.tsx          | 172 +++++++++
 .../inspectors/PageBlockInspector.tsx         |  38 +-
 .../__tests__/block-config-i18n.test.ts       | 255 +++++++++++++
 .../previews/__tests__/block-config.test.ts   |  10 +-
 .../metadata-admin/previews/block-config.ts   | 357 ++++++++++--------
 7 files changed, 1017 insertions(+), 173 deletions(-)
 create mode 100644 .changeset/page-block-inspector-curated-label-i18n-3913.md
 create mode 100644 packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.i18n.test.tsx
 create mode 100644 packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config-i18n.test.ts

diff --git a/.changeset/page-block-inspector-curated-label-i18n-3913.md b/.changeset/page-block-inspector-curated-label-i18n-3913.md
new file mode 100644
index 0000000000..5ef3d668e1
--- /dev/null
+++ b/.changeset/page-block-inspector-curated-label-i18n-3913.md
@@ -0,0 +1,41 @@
+---
+"@object-ui/app-shell": patch
+---
+
+Page block inspector: the PROPERTIES panel's curated field labels now follow the session locale instead of always rendering English
+
+`PageBlockInspector`'s chrome went through the translation table from the start —
+`t('engine.inspector.pageBlock.properties')` and its siblings — while the panel's
+CONTENTS did not. Every `label` in `previews/block-config.ts` was an English
+literal handed straight to the field components, so a zh-CN admin opening any
+page block read 「属性」 over a stack of English field names: two languages in one
+panel, reproducible on any block with no special data.
+
+All 157 label literals (152 field/option labels + 5 `addLabel`s) are now
+translation keys resolved through `t(key, locale)` at render, with 154 distinct
+keys added to both the `en-US` and `zh-CN` sides of
+`views/metadata-admin/i18n.ts`. The English text is unchanged: every key's `en`
+value is the literal it replaced, verified by substituting all 157 keys back and
+diffing the result byte-for-byte against the pre-change file.
+
+The key is a function of the label's POSITION in `BLOCK_CONFIG`
+(`engine.inspector.pageBlock.field.<blockType>.<name>`, `.add.<blockType>.<name>`,
+`.option.<fieldName>.<value>`), and a test re-derives all three shapes from the
+table's own structure. That is what makes the realistic mistake visible: these
+keys differ by one segment, so adding a block by copy-pasting a neighbour's key
+yields a key that EXISTS in both locales and renders a plausible label belonging
+to a different property — an existence-only check is green for it. Positional
+keys also let one English word take different Chinese per block, which the panel
+needs: `element:button.label` is a button caption 「按钮文字」 while
+`page:tabs.items.label` is a tab title 「标签」, and `Add section` is 「添加分区」
+here but stays 「添加分组」 in the form-layout canvas.
+
+`addLabel` is now REQUIRED on the `array` field variant. It was optional and the
+inspector fell back to a bare English `'Add'` — an untranslatable literal no
+locale table could reach. Requiring it deletes the fallback instead of
+translating it, so a new array field cannot compile without naming its
+add-button key.
+
+Option labels are translated too, including the ones `ColorVariantPicker` renders
+only as `aria-label`/`title`, where an untranslated string is invisible to a text
+query.
diff --git a/packages/app-shell/src/views/metadata-admin/i18n.ts b/packages/app-shell/src/views/metadata-admin/i18n.ts
index a35116697c..257e0566dd 100644
--- a/packages/app-shell/src/views/metadata-admin/i18n.ts
+++ b/packages/app-shell/src/views/metadata-admin/i18n.ts
@@ -478,6 +478,166 @@ const ENGINE_STRINGS_EN: Record<string, string> = {
   'engine.inspector.pageBlock.advanced': 'Advanced',
   'engine.inspector.pageBlock.remove': 'Remove block',
   'engine.inspector.pageBlock.outlineLabel': 'Blocks',
+  // Page block inspector — curated property labels (#3913).
+  // These are the `label` / `addLabel` / option-label values of
+  // `previews/block-config.ts`; that file stores the KEY and the inspector
+  // resolves it through `t()` at render. Key shape is derived from the label's
+  // position in BLOCK_CONFIG and pinned by
+  // `previews/__tests__/block-config-i18n.test.ts` — see that file's header.
+  'engine.inspector.pageBlock.field.object-grid.objectName': 'Object',
+  'engine.inspector.pageBlock.field.object-grid.columns': 'Columns',
+  'engine.inspector.pageBlock.field.object-grid.pageSize': 'Page size',
+  'engine.inspector.pageBlock.field.object-grid.striped': 'Striped rows',
+  'engine.inspector.pageBlock.field.object-grid.bordered': 'Bordered',
+  'engine.inspector.pageBlock.field.object-form.objectName': 'Object',
+  'engine.inspector.pageBlock.field.object-form.mode': 'Mode',
+  'engine.inspector.pageBlock.option.mode.create': 'Create',
+  'engine.inspector.pageBlock.option.mode.edit': 'Edit',
+  'engine.inspector.pageBlock.option.mode.view': 'View',
+  'engine.inspector.pageBlock.field.object-form.formType': 'Form type',
+  'engine.inspector.pageBlock.option.formType.simple': 'Simple',
+  'engine.inspector.pageBlock.option.formType.tabbed': 'Tabbed',
+  'engine.inspector.pageBlock.option.formType.wizard': 'Wizard',
+  'engine.inspector.pageBlock.option.formType.split': 'Split',
+  'engine.inspector.pageBlock.option.formType.drawer': 'Drawer',
+  'engine.inspector.pageBlock.option.formType.modal': 'Modal',
+  'engine.inspector.pageBlock.field.object-form.layout': 'Layout',
+  'engine.inspector.pageBlock.option.layout.vertical': 'Vertical',
+  'engine.inspector.pageBlock.option.layout.horizontal': 'Horizontal',
+  'engine.inspector.pageBlock.option.layout.inline': 'Inline',
+  'engine.inspector.pageBlock.option.layout.grid': 'Grid',
+  'engine.inspector.pageBlock.field.object-form.columns': 'Columns (grid layout)',
+  'engine.inspector.pageBlock.field.object-form.fields': 'Fields',
+  'engine.inspector.pageBlock.field.object-form.title': 'Title',
+  'engine.inspector.pageBlock.field.object-form.description': 'Description',
+  'engine.inspector.pageBlock.field.object-metric.objectName': 'Object',
+  'engine.inspector.pageBlock.field.object-metric.label': 'Label',
+  'engine.inspector.pageBlock.field.object-metric.description': 'Description',
+  'engine.inspector.pageBlock.field.object-metric.icon': 'Icon',
+  'engine.inspector.pageBlock.field.object-metric.colorVariant': 'Color',
+  'engine.inspector.pageBlock.option.colorVariant.default': 'Default',
+  'engine.inspector.pageBlock.option.colorVariant.blue': 'Blue',
+  'engine.inspector.pageBlock.option.colorVariant.teal': 'Teal',
+  'engine.inspector.pageBlock.option.colorVariant.orange': 'Orange',
+  'engine.inspector.pageBlock.option.colorVariant.purple': 'Purple',
+  'engine.inspector.pageBlock.option.colorVariant.success': 'Success',
+  'engine.inspector.pageBlock.option.colorVariant.warning': 'Warning',
+  'engine.inspector.pageBlock.option.colorVariant.danger': 'Danger',
+  'engine.inspector.pageBlock.field.object-metric.format': 'Format',
+  'engine.inspector.pageBlock.option.format.number': 'Number',
+  'engine.inspector.pageBlock.option.format.currency': 'Currency',
+  'engine.inspector.pageBlock.option.format.percent': 'Percent',
+  'engine.inspector.pageBlock.field.object-metric.prefix': 'Prefix',
+  'engine.inspector.pageBlock.field.object-metric.suffix': 'Suffix',
+  'engine.inspector.pageBlock.field.object-kanban.objectName': 'Object',
+  'engine.inspector.pageBlock.field.object-kanban.groupField': 'Group by field',
+  'engine.inspector.pageBlock.field.object-kanban.titleField': 'Title field',
+  'engine.inspector.pageBlock.field.object-kanban.cardFields': 'Card fields',
+  'engine.inspector.pageBlock.field.grid.columns': 'Columns',
+  'engine.inspector.pageBlock.field.grid.gap': 'Gap',
+  'engine.inspector.pageBlock.field.element:text.content': 'Content',
+  'engine.inspector.pageBlock.field.element:text.variant': 'Variant',
+  'engine.inspector.pageBlock.option.variant.heading': 'Heading',
+  'engine.inspector.pageBlock.option.variant.subheading': 'Subheading',
+  'engine.inspector.pageBlock.option.variant.body': 'Body',
+  'engine.inspector.pageBlock.option.variant.caption': 'Caption',
+  'engine.inspector.pageBlock.field.element:text.align': 'Align',
+  'engine.inspector.pageBlock.option.align.left': 'Left',
+  'engine.inspector.pageBlock.option.align.center': 'Center',
+  'engine.inspector.pageBlock.option.align.right': 'Right',
+  'engine.inspector.pageBlock.field.element:image.src': 'Source URL',
+  'engine.inspector.pageBlock.field.element:image.alt': 'Alt text',
+  'engine.inspector.pageBlock.field.element:image.fit': 'Fit',
+  'engine.inspector.pageBlock.option.fit.cover': 'Cover',
+  'engine.inspector.pageBlock.option.fit.contain': 'Contain',
+  'engine.inspector.pageBlock.option.fit.fill': 'Fill',
+  'engine.inspector.pageBlock.field.element:definition-list.items': 'Items',
+  'engine.inspector.pageBlock.add.element:definition-list.items': 'Add item',
+  'engine.inspector.pageBlock.field.element:definition-list.items.label': 'Label',
+  'engine.inspector.pageBlock.field.element:definition-list.items.value': 'Value',
+  'engine.inspector.pageBlock.field.element:definition-list.columns': 'Columns (1 or 2)',
+  'engine.inspector.pageBlock.field.element:definition-list.inline': 'Inline (label · value)',
+  'engine.inspector.pageBlock.field.element:repeater.object': 'Object',
+  'engine.inspector.pageBlock.field.element:repeater.titleField': 'Title field',
+  'engine.inspector.pageBlock.field.element:repeater.fields': 'Fields',
+  'engine.inspector.pageBlock.field.element:repeater.limit': 'Limit',
+  'engine.inspector.pageBlock.field.element:repeater.emptyText': 'Empty text',
+  'engine.inspector.pageBlock.field.element:repeater.divided': 'Dividers between rows',
+  'engine.inspector.pageBlock.field.element:number.object': 'Object',
+  'engine.inspector.pageBlock.field.element:number.field': 'Field',
+  'engine.inspector.pageBlock.field.element:number.aggregate': 'Aggregate',
+  'engine.inspector.pageBlock.option.aggregate.count': 'Count',
+  'engine.inspector.pageBlock.option.aggregate.sum': 'Sum',
+  'engine.inspector.pageBlock.option.aggregate.avg': 'Average',
+  'engine.inspector.pageBlock.option.aggregate.min': 'Min',
+  'engine.inspector.pageBlock.option.aggregate.max': 'Max',
+  'engine.inspector.pageBlock.field.element:number.format': 'Format',
+  'engine.inspector.pageBlock.field.element:number.prefix': 'Prefix',
+  'engine.inspector.pageBlock.field.element:number.suffix': 'Suffix',
+  'engine.inspector.pageBlock.field.element:button.label': 'Label',
+  'engine.inspector.pageBlock.field.element:button.variant': 'Variant',
+  'engine.inspector.pageBlock.option.variant.primary': 'Primary',
+  'engine.inspector.pageBlock.option.variant.secondary': 'Secondary',
+  'engine.inspector.pageBlock.option.variant.danger': 'Danger',
+  'engine.inspector.pageBlock.option.variant.ghost': 'Ghost',
+  'engine.inspector.pageBlock.option.variant.link': 'Link',
+  'engine.inspector.pageBlock.field.element:button.size': 'Size',
+  'engine.inspector.pageBlock.option.size.small': 'Small',
+  'engine.inspector.pageBlock.option.size.medium': 'Medium',
+  'engine.inspector.pageBlock.option.size.large': 'Large',
+  'engine.inspector.pageBlock.field.element:button.icon': 'Icon',
+  'engine.inspector.pageBlock.field.element:button.action': 'Action',
+  'engine.inspector.pageBlock.field.page:header.title': 'Title',
+  'engine.inspector.pageBlock.field.page:header.subtitle': 'Subtitle',
+  'engine.inspector.pageBlock.field.page:header.icon': 'Icon',
+  'engine.inspector.pageBlock.field.page:header.breadcrumb': 'Show breadcrumb',
+  'engine.inspector.pageBlock.field.page:card.title': 'Title',
+  'engine.inspector.pageBlock.field.page:card.bordered': 'Bordered',
+  'engine.inspector.pageBlock.field.page:tabs.items': 'Tabs',
+  'engine.inspector.pageBlock.add.page:tabs.items': 'Add tab',
+  'engine.inspector.pageBlock.field.page:tabs.items.key': 'Key',
+  'engine.inspector.pageBlock.field.page:tabs.items.label': 'Label',
+  'engine.inspector.pageBlock.field.page:accordion.title': 'Title',
+  'engine.inspector.pageBlock.field.page:accordion.items': 'Sections',
+  'engine.inspector.pageBlock.add.page:accordion.items': 'Add section',
+  'engine.inspector.pageBlock.field.page:accordion.items.value': 'Key',
+  'engine.inspector.pageBlock.field.page:accordion.items.label': 'Label',
+  'engine.inspector.pageBlock.field.record:related_list.objectName': 'Object',
+  'engine.inspector.pageBlock.field.record:related_list.relationshipField': 'Relationship field',
+  'engine.inspector.pageBlock.field.record:related_list.title': 'Title',
+  'engine.inspector.pageBlock.field.record:related_list.limit': 'Limit',
+  'engine.inspector.pageBlock.field.record:highlights.fields': 'Fields',
+  'engine.inspector.pageBlock.field.record:details.sections': 'Sections',
+  'engine.inspector.pageBlock.add.record:details.sections': 'Add section',
+  'engine.inspector.pageBlock.field.record:details.sections.name': 'Name (i18n key)',
+  'engine.inspector.pageBlock.field.record:details.sections.label': 'Label',
+  'engine.inspector.pageBlock.field.record:details.sections.columns': 'Columns',
+  'engine.inspector.pageBlock.field.record:details.sections.fields': 'Fields',
+  'engine.inspector.pageBlock.field.record:alert.severity': 'Severity',
+  'engine.inspector.pageBlock.option.severity.info': 'Info',
+  'engine.inspector.pageBlock.option.severity.warning': 'Warning',
+  'engine.inspector.pageBlock.option.severity.error': 'Error',
+  'engine.inspector.pageBlock.option.severity.success': 'Success',
+  'engine.inspector.pageBlock.field.record:alert.title': 'Title',
+  'engine.inspector.pageBlock.field.record:alert.body': 'Body',
+  'engine.inspector.pageBlock.field.record:alert.icon': 'Icon',
+  'engine.inspector.pageBlock.field.record:alert.dismissible': 'Dismissible',
+  'engine.inspector.pageBlock.field.record:path.statusField': 'Status field',
+  'engine.inspector.pageBlock.field.record:path.stages': 'Stages',
+  'engine.inspector.pageBlock.add.record:path.stages': 'Add stage',
+  'engine.inspector.pageBlock.field.record:path.stages.value': 'Value',
+  'engine.inspector.pageBlock.field.record:path.stages.label': 'Label',
+  'engine.inspector.pageBlock.field.record:quick_actions.actionNames': 'Action names',
+  'engine.inspector.pageBlock.field.record:quick_actions.location': 'Location',
+  'engine.inspector.pageBlock.option.location.record_header': 'Record header',
+  'engine.inspector.pageBlock.option.location.record_more': 'Record more menu',
+  'engine.inspector.pageBlock.option.location.record_section': 'Record section',
+  'engine.inspector.pageBlock.option.location.record_related': 'Record related',
+  'engine.inspector.pageBlock.option.location.list_toolbar': 'List toolbar',
+  'engine.inspector.pageBlock.option.location.list_item': 'List item',
+  'engine.inspector.pageBlock.option.location.global_nav': 'Global nav',
+  'engine.inspector.pageBlock.field.ai:input.agentName': 'Agent',
+  'engine.inspector.pageBlock.field.ai:input.placeholder': 'Input placeholder',
   // Report default ("home") inspector
   'engine.inspector.report.kind': 'Report',
   'engine.inspector.report.close': 'Close report',
@@ -2037,6 +2197,163 @@ const ENGINE_STRINGS_ZH: Record<string, string> = {
   'engine.inspector.pageBlock.advanced': '高级属性',
   'engine.inspector.pageBlock.remove': '删除区块',
   'engine.inspector.pageBlock.outlineLabel': '区块',
+  // 页面区块检查器 —— curated 属性 label(#3913)。
+  // 键形状与 en 侧一一对应,由 `previews/__tests__/block-config-i18n.test.ts`
+  // 按 BLOCK_CONFIG 的结构重新推导并断言两语齐备。
+  'engine.inspector.pageBlock.field.object-grid.objectName': '对象',
+  'engine.inspector.pageBlock.field.object-grid.columns': '列',
+  'engine.inspector.pageBlock.field.object-grid.pageSize': '每页条数',
+  'engine.inspector.pageBlock.field.object-grid.striped': '斑马纹行',
+  'engine.inspector.pageBlock.field.object-grid.bordered': '显示边框',
+  'engine.inspector.pageBlock.field.object-form.objectName': '对象',
+  'engine.inspector.pageBlock.field.object-form.mode': '模式',
+  'engine.inspector.pageBlock.option.mode.create': '新建',
+  'engine.inspector.pageBlock.option.mode.edit': '编辑',
+  'engine.inspector.pageBlock.option.mode.view': '查看',
+  'engine.inspector.pageBlock.field.object-form.formType': '表单类型',
+  'engine.inspector.pageBlock.option.formType.simple': '简单',
+  'engine.inspector.pageBlock.option.formType.tabbed': '标签页',
+  'engine.inspector.pageBlock.option.formType.wizard': '向导',
+  'engine.inspector.pageBlock.option.formType.split': '分栏',
+  'engine.inspector.pageBlock.option.formType.drawer': '抽屉',
+  'engine.inspector.pageBlock.option.formType.modal': '弹窗',
+  'engine.inspector.pageBlock.field.object-form.layout': '布局',
+  'engine.inspector.pageBlock.option.layout.vertical': '纵向',
+  'engine.inspector.pageBlock.option.layout.horizontal': '横向',
+  'engine.inspector.pageBlock.option.layout.inline': '行内',
+  'engine.inspector.pageBlock.option.layout.grid': '网格',
+  'engine.inspector.pageBlock.field.object-form.columns': '列数（网格布局）',
+  'engine.inspector.pageBlock.field.object-form.fields': '字段',
+  'engine.inspector.pageBlock.field.object-form.title': '标题',
+  'engine.inspector.pageBlock.field.object-form.description': '描述',
+  'engine.inspector.pageBlock.field.object-metric.objectName': '对象',
+  'engine.inspector.pageBlock.field.object-metric.label': '标签',
+  'engine.inspector.pageBlock.field.object-metric.description': '描述',
+  'engine.inspector.pageBlock.field.object-metric.icon': '图标',
+  'engine.inspector.pageBlock.field.object-metric.colorVariant': '颜色',
+  'engine.inspector.pageBlock.option.colorVariant.default': '默认',
+  'engine.inspector.pageBlock.option.colorVariant.blue': '蓝色',
+  'engine.inspector.pageBlock.option.colorVariant.teal': '青色',
+  'engine.inspector.pageBlock.option.colorVariant.orange': '橙色',
+  'engine.inspector.pageBlock.option.colorVariant.purple': '紫色',
+  'engine.inspector.pageBlock.option.colorVariant.success': '成功',
+  'engine.inspector.pageBlock.option.colorVariant.warning': '警告',
+  'engine.inspector.pageBlock.option.colorVariant.danger': '危险',
+  'engine.inspector.pageBlock.field.object-metric.format': '格式',
+  'engine.inspector.pageBlock.option.format.number': '数字',
+  'engine.inspector.pageBlock.option.format.currency': '货币',
+  'engine.inspector.pageBlock.option.format.percent': '百分比',
+  'engine.inspector.pageBlock.field.object-metric.prefix': '前缀',
+  'engine.inspector.pageBlock.field.object-metric.suffix': '后缀',
+  'engine.inspector.pageBlock.field.object-kanban.objectName': '对象',
+  'engine.inspector.pageBlock.field.object-kanban.groupField': '分组字段',
+  'engine.inspector.pageBlock.field.object-kanban.titleField': '标题字段',
+  'engine.inspector.pageBlock.field.object-kanban.cardFields': '卡片字段',
+  'engine.inspector.pageBlock.field.grid.columns': '列数',
+  'engine.inspector.pageBlock.field.grid.gap': '间距',
+  'engine.inspector.pageBlock.field.element:text.content': '内容',
+  'engine.inspector.pageBlock.field.element:text.variant': '样式',
+  'engine.inspector.pageBlock.option.variant.heading': '标题',
+  'engine.inspector.pageBlock.option.variant.subheading': '副标题',
+  'engine.inspector.pageBlock.option.variant.body': '正文',
+  'engine.inspector.pageBlock.option.variant.caption': '说明文字',
+  'engine.inspector.pageBlock.field.element:text.align': '对齐',
+  'engine.inspector.pageBlock.option.align.left': '左对齐',
+  'engine.inspector.pageBlock.option.align.center': '居中',
+  'engine.inspector.pageBlock.option.align.right': '右对齐',
+  'engine.inspector.pageBlock.field.element:image.src': '图片地址',
+  'engine.inspector.pageBlock.field.element:image.alt': '替代文本',
+  'engine.inspector.pageBlock.field.element:image.fit': '填充方式',
+  'engine.inspector.pageBlock.option.fit.cover': '覆盖',
+  'engine.inspector.pageBlock.option.fit.contain': '包含',
+  'engine.inspector.pageBlock.option.fit.fill': '拉伸',
+  'engine.inspector.pageBlock.field.element:definition-list.items': '条目',
+  'engine.inspector.pageBlock.add.element:definition-list.items': '添加条目',
+  'engine.inspector.pageBlock.field.element:definition-list.items.label': '标签',
+  'engine.inspector.pageBlock.field.element:definition-list.items.value': '值',
+  'engine.inspector.pageBlock.field.element:definition-list.columns': '列数（1 或 2）',
+  'engine.inspector.pageBlock.field.element:definition-list.inline': '行内（标签 · 值）',
+  'engine.inspector.pageBlock.field.element:repeater.object': '对象',
+  'engine.inspector.pageBlock.field.element:repeater.titleField': '标题字段',
+  'engine.inspector.pageBlock.field.element:repeater.fields': '字段',
+  'engine.inspector.pageBlock.field.element:repeater.limit': '条数上限',
+  'engine.inspector.pageBlock.field.element:repeater.emptyText': '空数据提示',
+  'engine.inspector.pageBlock.field.element:repeater.divided': '行间分隔线',
+  'engine.inspector.pageBlock.field.element:number.object': '对象',
+  'engine.inspector.pageBlock.field.element:number.field': '字段',
+  'engine.inspector.pageBlock.field.element:number.aggregate': '聚合方式',
+  'engine.inspector.pageBlock.option.aggregate.count': '计数',
+  'engine.inspector.pageBlock.option.aggregate.sum': '求和',
+  'engine.inspector.pageBlock.option.aggregate.avg': '平均值',
+  'engine.inspector.pageBlock.option.aggregate.min': '最小值',
+  'engine.inspector.pageBlock.option.aggregate.max': '最大值',
+  'engine.inspector.pageBlock.field.element:number.format': '格式',
+  'engine.inspector.pageBlock.field.element:number.prefix': '前缀',
+  'engine.inspector.pageBlock.field.element:number.suffix': '后缀',
+  'engine.inspector.pageBlock.field.element:button.label': '按钮文字',
+  'engine.inspector.pageBlock.field.element:button.variant': '样式',
+  'engine.inspector.pageBlock.option.variant.primary': '主要',
+  'engine.inspector.pageBlock.option.variant.secondary': '次要',
+  'engine.inspector.pageBlock.option.variant.danger': '危险',
+  'engine.inspector.pageBlock.option.variant.ghost': '幽灵',
+  'engine.inspector.pageBlock.option.variant.link': '链接',
+  'engine.inspector.pageBlock.field.element:button.size': '尺寸',
+  'engine.inspector.pageBlock.option.size.small': '小',
+  'engine.inspector.pageBlock.option.size.medium': '中',
+  'engine.inspector.pageBlock.option.size.large': '大',
+  'engine.inspector.pageBlock.field.element:button.icon': '图标',
+  'engine.inspector.pageBlock.field.element:button.action': '动作',
+  'engine.inspector.pageBlock.field.page:header.title': '标题',
+  'engine.inspector.pageBlock.field.page:header.subtitle': '副标题',
+  'engine.inspector.pageBlock.field.page:header.icon': '图标',
+  'engine.inspector.pageBlock.field.page:header.breadcrumb': '显示面包屑',
+  'engine.inspector.pageBlock.field.page:card.title': '标题',
+  'engine.inspector.pageBlock.field.page:card.bordered': '显示边框',
+  'engine.inspector.pageBlock.field.page:tabs.items': '标签页',
+  'engine.inspector.pageBlock.add.page:tabs.items': '添加标签页',
+  'engine.inspector.pageBlock.field.page:tabs.items.key': '键',
+  'engine.inspector.pageBlock.field.page:tabs.items.label': '标签',
+  'engine.inspector.pageBlock.field.page:accordion.title': '标题',
+  'engine.inspector.pageBlock.field.page:accordion.items': '分区',
+  'engine.inspector.pageBlock.add.page:accordion.items': '添加分区',
+  'engine.inspector.pageBlock.field.page:accordion.items.value': '键',
+  'engine.inspector.pageBlock.field.page:accordion.items.label': '标签',
+  'engine.inspector.pageBlock.field.record:related_list.objectName': '对象',
+  'engine.inspector.pageBlock.field.record:related_list.relationshipField': '关联字段',
+  'engine.inspector.pageBlock.field.record:related_list.title': '标题',
+  'engine.inspector.pageBlock.field.record:related_list.limit': '条数上限',
+  'engine.inspector.pageBlock.field.record:highlights.fields': '字段',
+  'engine.inspector.pageBlock.field.record:details.sections': '分区',
+  'engine.inspector.pageBlock.add.record:details.sections': '添加分区',
+  'engine.inspector.pageBlock.field.record:details.sections.name': '名称（i18n 键）',
+  'engine.inspector.pageBlock.field.record:details.sections.label': '标签',
+  'engine.inspector.pageBlock.field.record:details.sections.columns': '列数',
+  'engine.inspector.pageBlock.field.record:details.sections.fields': '字段',
+  'engine.inspector.pageBlock.field.record:alert.severity': '严重度',
+  'engine.inspector.pageBlock.option.severity.info': '信息',
+  'engine.inspector.pageBlock.option.severity.warning': '警告',
+  'engine.inspector.pageBlock.option.severity.error': '错误',
+  'engine.inspector.pageBlock.option.severity.success': '成功',
+  'engine.inspector.pageBlock.field.record:alert.title': '标题',
+  'engine.inspector.pageBlock.field.record:alert.body': '正文',
+  'engine.inspector.pageBlock.field.record:alert.icon': '图标',
+  'engine.inspector.pageBlock.field.record:alert.dismissible': '可关闭',
+  'engine.inspector.pageBlock.field.record:path.statusField': '状态字段',
+  'engine.inspector.pageBlock.field.record:path.stages': '阶段',
+  'engine.inspector.pageBlock.add.record:path.stages': '添加阶段',
+  'engine.inspector.pageBlock.field.record:path.stages.value': '值',
+  'engine.inspector.pageBlock.field.record:path.stages.label': '标签',
+  'engine.inspector.pageBlock.field.record:quick_actions.actionNames': '动作名称',
+  'engine.inspector.pageBlock.field.record:quick_actions.location': '位置',
+  'engine.inspector.pageBlock.option.location.record_header': '记录头部',
+  'engine.inspector.pageBlock.option.location.record_more': '记录更多菜单',
+  'engine.inspector.pageBlock.option.location.record_section': '记录分区',
+  'engine.inspector.pageBlock.option.location.record_related': '记录关联列表',
+  'engine.inspector.pageBlock.option.location.list_toolbar': '列表工具栏',
+  'engine.inspector.pageBlock.option.location.list_item': '列表行',
+  'engine.inspector.pageBlock.option.location.global_nav': '全局导航',
+  'engine.inspector.pageBlock.field.ai:input.agentName': '智能体',
+  'engine.inspector.pageBlock.field.ai:input.placeholder': '输入框占位提示',
   // Report default ("home") inspector
   'engine.inspector.report.kind': '报表',
   'engine.inspector.report.close': '关闭报表',
diff --git a/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.i18n.test.tsx b/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.i18n.test.tsx
new file mode 100644
index 0000000000..3d1b48acae
--- /dev/null
+++ b/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.i18n.test.tsx
@@ -0,0 +1,172 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+/**
+ * objectui#3913 — the PROPERTIES panel renders in the session's language.
+ *
+ * The sibling `previews/__tests__/block-config-i18n.test.ts` pins the TABLE
+ * (every label is a key its position implies, and both locales define it). That
+ * is a fact about data. This file pins the fact about the screen, and they are
+ * different: `renderField` reaches `f.label` from eleven places — eight as a
+ * `label=` prop, three as `<Label>` children — plus option lists handed to
+ * `InspectorSelectField` / `ColorVariantPicker`, and each is a separate chance
+ * to forward a raw key. A table full of correct keys still renders
+ * `engine.inspector.pageBlock.field.…` on screen if one branch skips `t()`.
+ *
+ * So the assertions here are deliberately about visible strings, and they run
+ * the same block twice — once per locale — because the defect was never "no
+ * translation exists" but "this panel does not ask for one".
+ */
+
+import { describe, it, expect, afterEach } from 'vitest';
+import { render, screen, cleanup } from '@testing-library/react';
+import { PageSchema } from '@objectstack/spec/ui';
+import { PageBlockInspector } from './PageBlockInspector';
+
+afterEach(cleanup);
+
+const BLOCK_PATH = 'regions[0].components[0]';
+
+/** A record page carrying one block of `type`, with the given properties. */
+function pageDraft(type: string, properties: Record<string, unknown> = {}): Record<string, unknown> {
+  return PageSchema.parse({
+    name: 'contact_record',
+    label: 'Contact',
+    type: 'record',
+    object: 'contact',
+    template: 'default',
+    regions: [{ name: 'main', components: [{ type, id: 'b1', properties }] }],
+  }) as unknown as Record<string, unknown>;
+}
+
+function renderInspector(draft: Record<string, unknown>, locale: 'en-US' | 'zh-CN') {
+  render(
+    <PageBlockInspector
+      type="page"
+      name="contact_record"
+      draft={draft}
+      selection={{ kind: 'block', id: BLOCK_PATH }}
+      onPatch={() => {}}
+      onClearSelection={() => {}}
+      readOnly={false}
+      locale={locale as never}
+    />,
+  );
+}
+
+/** No raw translation key may reach the DOM in any locale. */
+function expectNoRawKeys() {
+  expect(document.body.textContent ?? '').not.toContain('engine.inspector.pageBlock.');
+}
+
+describe('PageBlockInspector PROPERTIES labels follow the locale (#3913)', () => {
+  it('renders curated field labels in Chinese under zh-CN', () => {
+    renderInspector(pageDraft('object-grid'), 'zh-CN');
+
+    // `object-grid`: object-picker + field-list + number + two booleans, i.e.
+    // four different `renderField` branches in one panel.
+    expect(screen.getByText('对象')).toBeTruthy();
+    expect(screen.getByText('列')).toBeTruthy();
+    expect(screen.getByText('每页条数')).toBeTruthy();
+    expect(screen.getByText('斑马纹行')).toBeTruthy();
+    expect(screen.getByText('显示边框')).toBeTruthy();
+    // The English literals must be gone, not merely joined by Chinese ones.
+    expect(screen.queryByText('Striped rows')).toBeNull();
+    expect(screen.queryByText('Page size')).toBeNull();
+    expectNoRawKeys();
+  });
+
+  it('renders the same panel in English under en-US, unchanged', () => {
+    renderInspector(pageDraft('object-grid'), 'en-US');
+
+    expect(screen.getByText('Object')).toBeTruthy();
+    expect(screen.getByText('Columns')).toBeTruthy();
+    expect(screen.getByText('Page size')).toBeTruthy();
+    expect(screen.getByText('Striped rows')).toBeTruthy();
+    expect(screen.getByText('Bordered')).toBeTruthy();
+    expectNoRawKeys();
+  });
+
+  it('translates the array add button — the branch that had no key at all', () => {
+    // `addLabel` was optional and the array branch fell back to a bare English
+    // `'Add'`. It is now required, so that fallback is deleted rather than
+    // translated — a new array field cannot compile without its key.
+    renderInspector(pageDraft('record:details', { sections: [{ label: 'Contact info' }] }), 'zh-CN');
+
+    expect(screen.getByText('分区')).toBeTruthy();
+    expect(screen.getByText('添加分区')).toBeTruthy();
+    expect(screen.queryByText('Add section')).toBeNull();
+    expectNoRawKeys();
+  });
+
+  /**
+   * NOT asserted anywhere above, deliberately: that this panel contains no
+   * English at all. It still does, and the boundary is worth pinning.
+   *
+   * `FieldListField` and the `string-list` branch render their row-adder as a
+   * hardcoded `<Plus /> Add`, and `aria-label`s ("Remove", "Remove item"), the
+   * JSON parse error ("Invalid JSON") and two placeholders ("field name",
+   * "snake_case object") are literals in `PageBlockInspector.tsx` itself. None
+   * of them was ever a `block-config` label — different mechanism, different
+   * surface — so they are outside objectui#3913 and filed as objectui#3963.
+   *
+   * Asserting their PRESENCE (rather than quietly not mentioning them) means the
+   * day objectui#3963 lands, this case fails and has to be tightened, instead of
+   * the two fixes silently overlapping and leaving nobody sure what is covered.
+   */
+  it('leaves only the known non-block-config chrome in English (objectui#3963)', () => {
+    renderInspector(pageDraft('record:details', { sections: [{ label: 'Contact info' }] }), 'zh-CN');
+
+    // The section's `fields` item editor is a `field-list`; its adder is chrome.
+    const adders = screen.getAllByRole('button').filter((b) => b.textContent?.trim() === 'Add');
+    expect(adders.length).toBeGreaterThan(0);
+    expect(screen.getAllByLabelText('Remove item').length).toBeGreaterThan(0);
+  });
+
+  it('translates nested array-item labels, not just the container', () => {
+    // Item fields recurse through `renderField` with a different read/write
+    // pair; a fix applied only to the top level would leave these English.
+    renderInspector(pageDraft('record:details', { sections: [{ label: 'Contact info' }] }), 'zh-CN');
+
+    expect(screen.getByText('名称（i18n 键）')).toBeTruthy();
+    expect(screen.getByText('标签')).toBeTruthy();
+    expect(screen.getByText('列数')).toBeTruthy();
+    expect(screen.getByText('字段')).toBeTruthy();
+    expect(screen.queryByText('Name (i18n key)')).toBeNull();
+  });
+
+  it('translates select OPTION labels, not only the field label', () => {
+    // Options are a separate hop: they are passed as data to
+    // `InspectorSelectField`, so translating `f.label` alone leaves the
+    // dropdown's own text English. `severity` renders its current value.
+    renderInspector(pageDraft('record:alert', { severity: 'warning' }), 'zh-CN');
+
+    expect(screen.getByText('严重度')).toBeTruthy();
+    expect(screen.getByText('警告')).toBeTruthy();
+    expect(screen.queryByText('Warning')).toBeNull();
+    expect(screen.getByText('可关闭')).toBeTruthy();
+    expectNoRawKeys();
+  });
+
+  it('translates color-swatch option labels (the accessible name)', () => {
+    // `ColorVariantPicker` renders option labels as `aria-label`/`title` only —
+    // invisible to a text query, and exactly where an untranslated key hides.
+    renderInspector(pageDraft('object-metric', { colorVariant: 'blue' }), 'zh-CN');
+
+    expect(screen.getByLabelText('蓝色')).toBeTruthy();
+    expect(screen.getByLabelText('成功')).toBeTruthy();
+    expect(screen.queryByLabelText('Blue')).toBeNull();
+  });
+
+  it('keeps the panel chrome and its contents in ONE language', () => {
+    // The bug in one assertion: the section heading was already translated
+    // while everything under it was not.
+    renderInspector(pageDraft('page:header'), 'zh-CN');
+
+    expect(screen.getByText('属性')).toBeTruthy(); // chrome, already worked
+    expect(screen.getByText('标题')).toBeTruthy(); // contents, the fix
+    expect(screen.getByText('副标题')).toBeTruthy();
+    expect(screen.getByText('显示面包屑')).toBeTruthy();
+    expect(screen.queryByText('Subtitle')).toBeNull();
+    expect(screen.queryByText('Show breadcrumb')).toBeNull();
+  });
+});
diff --git a/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.tsx b/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.tsx
index b6d9708922..8c7fba7e87 100644
--- a/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.tsx
+++ b/packages/app-shell/src/views/metadata-admin/inspectors/PageBlockInspector.tsx
@@ -378,6 +378,16 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
     (key) => !curatedNames.has(key) && !STRUCTURAL_PROP_KEYS.has(key),
   );
 
+  // Curated labels are translation KEYS, not display text (#3913). The panel's
+  // chrome went through `t()` from the start while its contents did not, so a
+  // zh-CN admin read 「属性」 over a stack of English field names. `t()` returns
+  // the key unchanged when it is missing, so an untranslated field is loud in
+  // every locale rather than silently English in one.
+  const fieldLabel = (key: string) => t(key, locale);
+  /** Option labels are keys too — translate before handing them to a picker. */
+  const optionLabels = <T extends { value: string; label: string }>(options: T[]) =>
+    options.map((o) => ({ ...o, label: t(o.label, locale) }));
+
   // Generic, recursive field renderer. `read`/`write` abstract the value source
   // (the block's `properties` at the top level, or an item object inside an
   // `array` field), so the same code drives nested array-item editors.
@@ -391,39 +401,39 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
     switch (f.kind) {
       case 'number':
         return (
-          <InspectorNumberField key={k} label={f.label}
+          <InspectorNumberField key={k} label={fieldLabel(f.label)}
             value={typeof read(f.name) === 'number' ? (read(f.name) as number) : undefined}
             placeholder={f.placeholder} onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
       case 'boolean':
         return (
-          <InspectorCheckboxField key={k} label={f.label} value={!!read(f.name)}
+          <InspectorCheckboxField key={k} label={fieldLabel(f.label)} value={!!read(f.name)}
             onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
       case 'color':
         return (
           <div key={k} className="space-y-1">
-            <Label className="text-xs text-muted-foreground">{f.label}</Label>
+            <Label className="text-xs text-muted-foreground">{fieldLabel(f.label)}</Label>
             <ColorVariantPicker
               value={read(f.name) != null ? String(read(f.name)) : undefined}
               onChange={(v) => write(f.name, v)}
               disabled={readOnly}
-              options={f.options}
+              options={f.options ? optionLabels(f.options) : undefined}
             />
           </div>
         );
       case 'select':
         return (
-          <InspectorSelectField key={k} label={f.label}
+          <InspectorSelectField key={k} label={fieldLabel(f.label)}
             value={read(f.name) != null ? String(read(f.name)) : undefined}
-            options={f.options} onCommit={(v) => write(f.name, v)} disabled={readOnly} />
+            options={optionLabels(f.options)} onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
       case 'json':
         // Same editor the "Advanced" section uses, but reachable for a prop the
         // block does not have yet — Advanced enumerates existing keys only, so
         // without this a curated JSON prop could be edited and never added.
         return (
-          <InspectorJsonField key={k} label={f.label} value={read(f.name)}
+          <InspectorJsonField key={k} label={fieldLabel(f.label)} value={read(f.name)}
             placeholder={f.placeholder}
             onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
@@ -431,7 +441,7 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
         const arr = Array.isArray(read(f.name)) ? (read(f.name) as unknown[]) : [];
         return (
           <div key={k} className="space-y-1.5">
-            <Label className="text-xs text-muted-foreground">{f.label}</Label>
+            <Label className="text-xs text-muted-foreground">{fieldLabel(f.label)}</Label>
             {arr.map((s, i) => (
               <div key={i} className="flex items-center gap-1.5">
                 <Input className="h-8 text-sm" value={String(s ?? '')} placeholder={f.placeholder} disabled={readOnly}
@@ -454,7 +464,7 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
         const arr = Array.isArray(read(f.name)) ? (read(f.name) as unknown[]) : [];
         return (
           <div key={k} className="space-y-2">
-            <Label className="text-xs text-muted-foreground">{f.label}</Label>
+            <Label className="text-xs text-muted-foreground">{fieldLabel(f.label)}</Label>
             {arr.map((item, i) => {
               const itemObj = item && typeof item === 'object' ? (item as Record<string, unknown>) : {};
               return (
@@ -479,7 +489,7 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
             })}
             {!readOnly && (
               <Button type="button" variant="outline" size="sm" onClick={() => write(f.name, [...arr, {}])}>
-                <Plus className="mr-1 h-3.5 w-3.5" /> {f.addLabel || 'Add'}
+                <Plus className="mr-1 h-3.5 w-3.5" /> {fieldLabel(f.addLabel)}
               </Button>
             )}
           </div>
@@ -487,24 +497,24 @@ export function PageBlockInspector({ selection, draft, onPatch, onClearSelection
       }
       case 'object-picker':
         return (
-          <ObjectPickerField key={k} label={f.label}
+          <ObjectPickerField key={k} label={fieldLabel(f.label)}
             value={read(f.name) != null ? String(read(f.name)) : undefined}
             onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
       case 'field-picker':
         return (
-          <FieldPickerField key={k} label={f.label} objectName={resolveObject(f)}
+          <FieldPickerField key={k} label={fieldLabel(f.label)} objectName={resolveObject(f)}
             value={read(f.name) != null ? String(read(f.name)) : undefined}
             onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
       case 'field-list':
         return (
-          <FieldListField key={k} label={f.label} objectName={resolveObject(f)}
+          <FieldListField key={k} label={fieldLabel(f.label)} objectName={resolveObject(f)}
             value={read(f.name)} onChange={(v) => write(f.name, v)} disabled={readOnly} />
         );
       default:
         return (
-          <InspectorTextField key={k} label={f.label}
+          <InspectorTextField key={k} label={fieldLabel(f.label)}
             value={read(f.name) != null ? String(read(f.name)) : ''}
             placeholder={(f as any).placeholder} onCommit={(v) => write(f.name, v)} disabled={readOnly} />
         );
diff --git a/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config-i18n.test.ts b/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config-i18n.test.ts
new file mode 100644
index 0000000000..00407bbe2f
--- /dev/null
+++ b/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config-i18n.test.ts
@@ -0,0 +1,255 @@
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+
+/**
+ * objectui#3913 — every curated page-block label is a translation key that
+ * BOTH locales define, and the key is the one its POSITION implies.
+ *
+ * ## What was broken
+ *
+ * `PageBlockInspector`'s chrome went through `t('engine.inspector.pageBlock.*')`
+ * from the start; the panel's CONTENTS — the 152 field/option labels and 5
+ * `addLabel`s of `block-config.ts` — were English literals handed straight to
+ * the field components. A zh-CN admin opening any page block therefore read
+ * 「属性」 over a stack of English field names: two languages in one panel, no
+ * special data needed to reproduce.
+ *
+ * ## Why the assertions are two, not one
+ *
+ * "Does the key exist in both tables?" is the obvious check and it is not
+ * enough. The keys are near-identical strings differing by one segment
+ * (`…field.object-grid.columns` vs `…field.object-form.columns`), so the
+ * realistic mistake when adding a block is not a typo — it is copy-pasting a
+ * neighbouring block's key, which EXISTS in both locales and renders a plausible
+ * label belonging to a different property. An existence-only check is green for
+ * that, and the author reads a correct-looking panel that edits the wrong-named
+ * field.
+ *
+ * So the key is DERIVED here from the label's position in `BLOCK_CONFIG` and
+ * compared with what the table stores. Derivation is what makes the mistake
+ * mechanically visible, and it is the reason the key shape is positional in the
+ * first place rather than semantic.
+ *
+ *   field label          engine.inspector.pageBlock.field.<blockType>.<name>
+ *   nested item label    engine.inspector.pageBlock.field.<blockType>.<array>.<name>
+ *   array add button     engine.inspector.pageBlock.add.<blockType>.<name>
+ *   select/color option  engine.inspector.pageBlock.option.<fieldName>.<value>
+ *
+ * Option keys omit the block type on purpose (so `format`'s number/currency/
+ * percent are translated once and shared by `object-metric` and
+ * `element:number`); field keys carry it on purpose, because the same English
+ * word needs different Chinese per block — `element:button.label` is a button
+ * caption 「按钮文字」 while `page:tabs.items.label` is a tab title 「标签」.
+ *
+ * Completeness is asserted through `t()` rather than by importing the tables:
+ * `t()` returns the key unchanged on a miss, so `t(key, locale) === key` is
+ * exactly "this locale has no translation" — measured through the same accessor
+ * the component uses, not a private table this test would have to be given.
+ */
+
+import { describe, it, expect } from 'vitest';
+import { BLOCK_CONFIG, type BlockPropField } from '../block-config';
+import { t } from '../../i18n';
+
+const PREFIX = 'engine.inspector.pageBlock';
+
+/** One translatable label site: where it lives, what key that implies, what is stored. */
+interface LabelSite {
+  /** `field` | `add` | `option` — which key family. */
+  family: 'field' | 'add' | 'option';
+  /** The key the site's position implies. */
+  derived: string;
+  /** The key `block-config.ts` actually stores there. */
+  stored: string;
+  /** Human-readable position, for assertion messages. */
+  where: string;
+}
+
+/** Walk BLOCK_CONFIG and derive a key for every label / addLabel / option label. */
+function labelSites(): LabelSite[] {
+  const sites: LabelSite[] = [];
+
+  const walk = (f: BlockPropField, blockType: string, path: string[]) => {
+    const dotted = [...path, f.name].join('.');
+    sites.push({
+      family: 'field',
+      derived: `${PREFIX}.field.${blockType}.${dotted}`,
+      stored: f.label,
+      where: `${blockType}.${dotted} (label)`,
+    });
+
+    if (f.kind === 'array') {
+      sites.push({
+        family: 'add',
+        derived: `${PREFIX}.add.${blockType}.${dotted}`,
+        stored: f.addLabel,
+        where: `${blockType}.${dotted} (addLabel)`,
+      });
+      for (const itf of f.itemFields) walk(itf, blockType, [...path, f.name]);
+    }
+
+    // `select` always has options; `color` may. Both render their labels.
+    const options = (f as { options?: Array<{ value: string; label: string }> }).options;
+    if (Array.isArray(options)) {
+      for (const o of options) {
+        sites.push({
+          family: 'option',
+          derived: `${PREFIX}.option.${f.name}.${o.value}`,
+          stored: o.label,
+          where: `${blockType}.${dotted} option=${o.value}`,
+        });
+      }
+    }
+  };
+
+  for (const [blockType, fields] of Object.entries(BLOCK_CONFIG)) {
+    for (const f of fields) walk(f, blockType, []);
+  }
+  return sites;
+}
+
+const SITES = labelSites();
+
+/**
+ * Keys whose two locales are deliberately identical (an acronym, a symbol —
+ * nothing to translate). EMPTY today, and it is a ledger rather than a rule: a
+ * genuinely locale-invariant label is added here with its reason, so "the zh
+ * column is a copy of the en column" stays a red build everywhere else.
+ */
+const LOCALE_INVARIANT = new Set<string>();
+
+describe('block-config labels are translation keys (#3913)', () => {
+  it('collects every label site — the walk itself is not empty', () => {
+    // Guards the derivation: a refactor that stops finding labels would make
+    // every per-site assertion below vacuous by iterating nothing.
+    expect(SITES.length).toBeGreaterThan(150);
+    const families = SITES.reduce<Record<string, number>>((acc, s) => {
+      acc[s.family] = (acc[s.family] ?? 0) + 1;
+      return acc;
+    }, {});
+    // 152 `label:` + 5 `addLabel:` literals at the time of the fix; option sites
+    // are counted per USE, so shared option lists (`format`, `ALIGN_OPTS`) are
+    // visited once per referencing field.
+    expect(families.field).toBeGreaterThan(80);
+    expect(families.add).toBe(5);
+    expect(families.option).toBeGreaterThan(50);
+  });
+
+  it('stores exactly the key its position implies', () => {
+    // The copy-paste guard. A neighbouring block's key exists in both locales,
+    // so nothing else in this file would notice it.
+    const wrong = SITES.filter((s) => s.stored !== s.derived).map(
+      (s) => `${s.where}: stored '${s.stored}' but position implies '${s.derived}'`,
+    );
+    expect(wrong).toEqual([]);
+  });
+
+  it('no label is left as display text', () => {
+    // Belt to the braces above: an English literal cannot even look like a key.
+    const literals = SITES.filter((s) => !s.stored.startsWith(`${PREFIX}.`)).map(
+      (s) => `${s.where}: '${s.stored}'`,
+    );
+    expect(literals).toEqual([]);
+  });
+
+  it('every key resolves in en-US', () => {
+    const missing = SITES.filter((s) => t(s.derived, 'en-US') === s.derived).map((s) => s.derived);
+    expect([...new Set(missing)]).toEqual([]);
+  });
+
+  it('every key resolves in zh-CN', () => {
+    // The defect this issue filed, as a structural assertion: a field added to
+    // BLOCK_CONFIG without a zh translation is red here rather than shipping as
+    // an English box in a Chinese panel.
+    const missing = SITES.filter((s) => t(s.derived, 'zh-CN') === s.derived).map((s) => s.derived);
+    expect([...new Set(missing)]).toEqual([]);
+  });
+
+  it('zh-CN is actually translated, not a copy of en-US', () => {
+    const untranslated = SITES.filter(
+      (s) => !LOCALE_INVARIANT.has(s.derived) && t(s.derived, 'zh-CN') === t(s.derived, 'en-US'),
+    ).map((s) => `${s.derived} = '${t(s.derived, 'en-US')}'`);
+    // If a label really is locale-invariant, add it to LOCALE_INVARIANT above
+    // with the reason — do not weaken this assertion.
+    expect([...new Set(untranslated)]).toEqual([]);
+  });
+
+  it('one key never carries two different meanings', () => {
+    // Option keys drop the block type, so the same key is reached from several
+    // positions by design — but only ever for the same concept. Two positions
+    // sharing a key while meaning different things would translate one of them
+    // wrongly, and `t()` cannot tell.
+    const byKey = new Map<string, Set<string>>();
+    for (const s of SITES) {
+      if (!byKey.has(s.derived)) byKey.set(s.derived, new Set());
+      byKey.get(s.derived)!.add(s.family);
+    }
+    const crossFamily = [...byKey.entries()]
+      .filter(([, families]) => families.size > 1)
+      .map(([key, families]) => `${key}: ${[...families].join('+')}`);
+    expect(crossFamily).toEqual([]);
+
+    // A `field`/`add` key is positional and must therefore be unique outright;
+    // only `option` keys may legitimately repeat.
+    const positional = SITES.filter((s) => s.family !== 'option').map((s) => s.derived);
+    expect(positional.length).toBe(new Set(positional).size);
+  });
+});
+
+/**
+ * The English side must not have moved. `en-US` is this repo's baseline
+ * language and the table is what the drift discipline protects, so the fix is
+ * only correct if it changed WHERE the English text comes from and not the text
+ * itself. Sampled across every field kind plus all five add buttons — the
+ * remaining keys were substituted mechanically from the pre-change literals
+ * (see the PR), which is why a sample is a regression pin here rather than the
+ * proof of the migration.
+ */
+describe('en-US labels are unchanged by the key migration (#3913)', () => {
+  const EXPECTED: Record<string, string> = {
+    // object-picker / field-list / number / boolean
+    'engine.inspector.pageBlock.field.object-grid.objectName': 'Object',
+    'engine.inspector.pageBlock.field.object-grid.columns': 'Columns',
+    'engine.inspector.pageBlock.field.object-grid.pageSize': 'Page size',
+    'engine.inspector.pageBlock.field.object-grid.striped': 'Striped rows',
+    // the same field NAME in another block, with different text — the case that
+    // makes the key positional
+    'engine.inspector.pageBlock.field.object-form.columns': 'Columns (grid layout)',
+    'engine.inspector.pageBlock.field.element:definition-list.columns': 'Columns (1 or 2)',
+    'engine.inspector.pageBlock.field.grid.columns': 'Columns',
+    // text / json / color / field-picker
+    'engine.inspector.pageBlock.field.element:image.src': 'Source URL',
+    'engine.inspector.pageBlock.field.element:button.action': 'Action',
+    'engine.inspector.pageBlock.field.object-metric.colorVariant': 'Color',
+    'engine.inspector.pageBlock.field.object-kanban.groupField': 'Group by field',
+    // string-list / array container
+    'engine.inspector.pageBlock.field.record:quick_actions.actionNames': 'Action names',
+    'engine.inspector.pageBlock.field.record:details.sections': 'Sections',
+    // the #3819 label, whose wording is itself load-bearing
+    'engine.inspector.pageBlock.field.record:details.sections.name': 'Name (i18n key)',
+    // all five add buttons
+    'engine.inspector.pageBlock.add.element:definition-list.items': 'Add item',
+    'engine.inspector.pageBlock.add.page:tabs.items': 'Add tab',
+    'engine.inspector.pageBlock.add.page:accordion.items': 'Add section',
+    'engine.inspector.pageBlock.add.record:details.sections': 'Add section',
+    'engine.inspector.pageBlock.add.record:path.stages': 'Add stage',
+    // options, incl. the shared `format` list and the shared ALIGN_OPTS
+    'engine.inspector.pageBlock.option.format.currency': 'Currency',
+    'engine.inspector.pageBlock.option.align.center': 'Center',
+    'engine.inspector.pageBlock.option.location.record_more': 'Record more menu',
+    'engine.inspector.pageBlock.option.severity.warning': 'Warning',
+  };
+
+  it('renders the pre-change English text for every sampled key', () => {
+    for (const [key, text] of Object.entries(EXPECTED)) {
+      expect(t(key, 'en-US'), key).toBe(text);
+    }
+  });
+
+  it('every sampled key is one the table really reaches', () => {
+    // Without this, a renamed key would leave the sample above asserting
+    // `t()`'s key-passthrough against itself and passing.
+    const derived = new Set(SITES.map((s) => s.derived));
+    const orphans = Object.keys(EXPECTED).filter((k) => !derived.has(k));
+    expect(orphans).toEqual([]);
+  });
+});
diff --git a/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config.test.ts b/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config.test.ts
index df76968e7f..7730b8b560 100644
--- a/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config.test.ts
+++ b/packages/app-shell/src/views/metadata-admin/previews/__tests__/block-config.test.ts
@@ -2,6 +2,7 @@ import { describe, it, expect } from 'vitest';
 import { PageComponentType, RecordDetailsProps } from '@objectstack/spec/ui';
 import { BLOCK_CONFIG, blockHasConfig } from '../block-config';
 import { BLOCK_TYPE_META, PALETTE_EXCLUSIONS } from '../block-types';
+import { t } from '../../i18n';
 
 describe('block-config', () => {
   it('exposes a configurable panel for every content block with authorable props', () => {
@@ -118,7 +119,14 @@ describe('record:details sections ↔ spec section-entry coverage (#3819)', () =
     // The label must say what the box is FOR. A bare "Name" next to "Label"
     // reads as a second display string, which is how an author ends up typing
     // a heading into the anchor.
-    expect(nameField!.label).toMatch(/i18n/i);
+    //
+    // Asserted on the RESOLVED label, in both locales, because `label` now
+    // holds a translation key (#3913). Matching /i18n/i against the key itself
+    // would be a claim about the key's spelling, not about the words an author
+    // reads — and it would pass or fail for reasons unrelated to the wording
+    // this case exists to protect.
+    expect(t(nameField!.label, 'en-US')).toMatch(/i18n/i);
+    expect(t(nameField!.label, 'zh-CN')).toMatch(/i18n/i);
   });
 
   it('lists `name` before `label` — the entry identity comes first', () => {
diff --git a/packages/app-shell/src/views/metadata-admin/previews/block-config.ts b/packages/app-shell/src/views/metadata-admin/previews/block-config.ts
index ad02713b90..9220fdfff6 100644
--- a/packages/app-shell/src/views/metadata-admin/previews/block-config.ts
+++ b/packages/app-shell/src/views/metadata-admin/previews/block-config.ts
@@ -20,6 +20,36 @@
  *                                       Advanced only lists keys the block
  *                                       ALREADY has, so it can edit such a prop
  *                                       but never add one.
+ *
+ * ## `label` / `addLabel` hold a TRANSLATION KEY, not display text (#3913)
+ *
+ * Every `label`, every option `label` and every `addLabel` in this file is a key
+ * into `../i18n.ts`, resolved by `PageBlockInspector` through `t(key, locale)` at
+ * render. They used to be English literals, which is how a zh-CN admin got a
+ * panel headed 「属性」 with every box under it named in English — the section
+ * chrome went through `t()` and the panel's own content never did.
+ *
+ * The key is a function of WHERE the label lives, and that is the load-bearing
+ * part rather than a naming preference:
+ *
+ *   field label          engine.inspector.pageBlock.field.<blockType>.<name>
+ *   nested item label    engine.inspector.pageBlock.field.<blockType>.<array>.<name>
+ *   array add button     engine.inspector.pageBlock.add.<blockType>.<name>
+ *   select/color option  engine.inspector.pageBlock.option.<fieldName>.<value>
+ *
+ * `previews/__tests__/block-config-i18n.test.ts` re-derives all four shapes from
+ * the table's own structure and asserts (a) the stored key equals the derived
+ * one and (b) both locales define it. So a field added here without a
+ * translation is red, and so is a key copy-pasted from a neighbouring block —
+ * the second is the failure a bare "does the key exist?" check cannot see.
+ *
+ * Option keys deliberately omit the block type, so `format`'s number/currency/
+ * percent are translated once for `object-metric` and `element:number`. Field
+ * keys deliberately DO carry it, because the same English word needs different
+ * Chinese in different blocks: `element:button.label` is the button's caption
+ * (「按钮文字」) while `page:tabs.items.label` is a tab's title (「标签」), and
+ * `Add section` is 「添加分区」 here but 「添加分组」 in the form-layout canvas
+ * (`designer.canvas.addSection`). One key per meaning is why that is expressible.
  */
 
 /** Where a field/field-list picker resolves its object from:
@@ -27,13 +57,22 @@
  *  - 'self' — a sibling property on the same block (objectProp) */
 export type ObjectSource = { objectFrom: 'page' } | { objectFrom: 'self'; objectProp: string };
 
+/**
+ * One curated property editor. Every `label` is a translation key — see the
+ * file header for the four key shapes and the test that enforces them.
+ */
 export type BlockPropField =
   | { name: string; label: string; kind: 'text'; placeholder?: string }
   | { name: string; label: string; kind: 'number'; placeholder?: string }
   | { name: string; label: string; kind: 'boolean' }
   | { name: string; label: string; kind: 'select'; options: Array<{ value: string; label: string }> }
   | { name: string; label: string; kind: 'string-list'; placeholder?: string }
-  | { name: string; label: string; kind: 'array'; itemFields: BlockPropField[]; addLabel?: string }
+  // `addLabel` is REQUIRED (#3913). It was optional, and the inspector rendered
+  // a bare English `'Add'` when it was absent — an untranslatable literal that
+  // no locale table could reach. Making the contract require it is the fix that
+  // deletes the fallback instead of translating it: a new array field cannot
+  // compile without naming its add-button key.
+  | { name: string; label: string; kind: 'array'; itemFields: BlockPropField[]; addLabel: string }
   | { name: string; label: string; kind: 'json'; placeholder?: string }
   | { name: string; label: string; kind: 'color'; options?: Array<{ value: string; label: string }> }
   // Schema-driven pickers — dropdowns populated from the live metadata.
@@ -41,10 +80,12 @@ export type BlockPropField =
   | ({ name: string; label: string; kind: 'field-picker'; placeholder?: string } & ObjectSource)
   | ({ name: string; label: string; kind: 'field-list'; placeholder?: string } & ObjectSource);
 
+/** Shared alignment options. The keys name the field (`align`), so reusing this
+ *  const on a field called anything else turns the key-derivation pin red. */
 const ALIGN_OPTS = [
-  { value: 'left', label: 'Left' },
-  { value: 'center', label: 'Center' },
-  { value: 'right', label: 'Right' },
+  { value: 'left', label: 'engine.inspector.pageBlock.option.align.left' },
+  { value: 'center', label: 'engine.inspector.pageBlock.option.align.center' },
+  { value: 'right', label: 'engine.inspector.pageBlock.option.align.right' },
 ];
 
 export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
@@ -55,118 +96,118 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
   // cover the common props; anything else surfaces in the generic "Advanced"
   // section of PageBlockInspector so the panel is never out of sync with source.
   'object-grid': [
-    { name: 'objectName', label: 'Object', kind: 'object-picker' },
-    { name: 'columns', label: 'Columns', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
-    { name: 'pageSize', label: 'Page size', kind: 'number', placeholder: '20' },
-    { name: 'striped', label: 'Striped rows', kind: 'boolean' },
-    { name: 'bordered', label: 'Bordered', kind: 'boolean' },
+    { name: 'objectName', label: 'engine.inspector.pageBlock.field.object-grid.objectName', kind: 'object-picker' },
+    { name: 'columns', label: 'engine.inspector.pageBlock.field.object-grid.columns', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'pageSize', label: 'engine.inspector.pageBlock.field.object-grid.pageSize', kind: 'number', placeholder: '20' },
+    { name: 'striped', label: 'engine.inspector.pageBlock.field.object-grid.striped', kind: 'boolean' },
+    { name: 'bordered', label: 'engine.inspector.pageBlock.field.object-grid.bordered', kind: 'boolean' },
   ],
   'object-form': [
-    { name: 'objectName', label: 'Object', kind: 'object-picker' },
+    { name: 'objectName', label: 'engine.inspector.pageBlock.field.object-form.objectName', kind: 'object-picker' },
     {
-      name: 'mode', label: 'Mode', kind: 'select',
+      name: 'mode', label: 'engine.inspector.pageBlock.field.object-form.mode', kind: 'select',
       options: [
-        { value: 'create', label: 'Create' },
-        { value: 'edit', label: 'Edit' },
-        { value: 'view', label: 'View' },
+        { value: 'create', label: 'engine.inspector.pageBlock.option.mode.create' },
+        { value: 'edit', label: 'engine.inspector.pageBlock.option.mode.edit' },
+        { value: 'view', label: 'engine.inspector.pageBlock.option.mode.view' },
       ],
     },
     {
-      name: 'formType', label: 'Form type', kind: 'select',
+      name: 'formType', label: 'engine.inspector.pageBlock.field.object-form.formType', kind: 'select',
       options: [
-        { value: 'simple', label: 'Simple' },
-        { value: 'tabbed', label: 'Tabbed' },
-        { value: 'wizard', label: 'Wizard' },
-        { value: 'split', label: 'Split' },
-        { value: 'drawer', label: 'Drawer' },
-        { value: 'modal', label: 'Modal' },
+        { value: 'simple', label: 'engine.inspector.pageBlock.option.formType.simple' },
+        { value: 'tabbed', label: 'engine.inspector.pageBlock.option.formType.tabbed' },
+        { value: 'wizard', label: 'engine.inspector.pageBlock.option.formType.wizard' },
+        { value: 'split', label: 'engine.inspector.pageBlock.option.formType.split' },
+        { value: 'drawer', label: 'engine.inspector.pageBlock.option.formType.drawer' },
+        { value: 'modal', label: 'engine.inspector.pageBlock.option.formType.modal' },
       ],
     },
     {
-      name: 'layout', label: 'Layout', kind: 'select',
+      name: 'layout', label: 'engine.inspector.pageBlock.field.object-form.layout', kind: 'select',
       options: [
-        { value: 'vertical', label: 'Vertical' },
-        { value: 'horizontal', label: 'Horizontal' },
-        { value: 'inline', label: 'Inline' },
-        { value: 'grid', label: 'Grid' },
+        { value: 'vertical', label: 'engine.inspector.pageBlock.option.layout.vertical' },
+        { value: 'horizontal', label: 'engine.inspector.pageBlock.option.layout.horizontal' },
+        { value: 'inline', label: 'engine.inspector.pageBlock.option.layout.inline' },
+        { value: 'grid', label: 'engine.inspector.pageBlock.option.layout.grid' },
       ],
     },
-    { name: 'columns', label: 'Columns (grid layout)', kind: 'number', placeholder: '2' },
-    { name: 'fields', label: 'Fields', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
-    { name: 'title', label: 'Title', kind: 'text' },
-    { name: 'description', label: 'Description', kind: 'text' },
+    { name: 'columns', label: 'engine.inspector.pageBlock.field.object-form.columns', kind: 'number', placeholder: '2' },
+    { name: 'fields', label: 'engine.inspector.pageBlock.field.object-form.fields', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.object-form.title', kind: 'text' },
+    { name: 'description', label: 'engine.inspector.pageBlock.field.object-form.description', kind: 'text' },
   ],
   'object-metric': [
-    { name: 'objectName', label: 'Object', kind: 'object-picker' },
-    { name: 'label', label: 'Label', kind: 'text' },
-    { name: 'description', label: 'Description', kind: 'text' },
-    { name: 'icon', label: 'Icon', kind: 'text', placeholder: 'lucide icon name' },
+    { name: 'objectName', label: 'engine.inspector.pageBlock.field.object-metric.objectName', kind: 'object-picker' },
+    { name: 'label', label: 'engine.inspector.pageBlock.field.object-metric.label', kind: 'text' },
+    { name: 'description', label: 'engine.inspector.pageBlock.field.object-metric.description', kind: 'text' },
+    { name: 'icon', label: 'engine.inspector.pageBlock.field.object-metric.icon', kind: 'text', placeholder: 'lucide icon name' },
     {
-      name: 'colorVariant', label: 'Color', kind: 'color',
+      name: 'colorVariant', label: 'engine.inspector.pageBlock.field.object-metric.colorVariant', kind: 'color',
       options: [
-        { value: 'default', label: 'Default' },
-        { value: 'blue', label: 'Blue' },
-        { value: 'teal', label: 'Teal' },
-        { value: 'orange', label: 'Orange' },
-        { value: 'purple', label: 'Purple' },
-        { value: 'success', label: 'Success' },
-        { value: 'warning', label: 'Warning' },
-        { value: 'danger', label: 'Danger' },
+        { value: 'default', label: 'engine.inspector.pageBlock.option.colorVariant.default' },
+        { value: 'blue', label: 'engine.inspector.pageBlock.option.colorVariant.blue' },
+        { value: 'teal', label: 'engine.inspector.pageBlock.option.colorVariant.teal' },
+        { value: 'orange', label: 'engine.inspector.pageBlock.option.colorVariant.orange' },
+        { value: 'purple', label: 'engine.inspector.pageBlock.option.colorVariant.purple' },
+        { value: 'success', label: 'engine.inspector.pageBlock.option.colorVariant.success' },
+        { value: 'warning', label: 'engine.inspector.pageBlock.option.colorVariant.warning' },
+        { value: 'danger', label: 'engine.inspector.pageBlock.option.colorVariant.danger' },
       ],
     },
     {
-      name: 'format', label: 'Format', kind: 'select',
+      name: 'format', label: 'engine.inspector.pageBlock.field.object-metric.format', kind: 'select',
       options: [
-        { value: 'number', label: 'Number' },
-        { value: 'currency', label: 'Currency' },
-        { value: 'percent', label: 'Percent' },
+        { value: 'number', label: 'engine.inspector.pageBlock.option.format.number' },
+        { value: 'currency', label: 'engine.inspector.pageBlock.option.format.currency' },
+        { value: 'percent', label: 'engine.inspector.pageBlock.option.format.percent' },
       ],
     },
-    { name: 'prefix', label: 'Prefix', kind: 'text' },
-    { name: 'suffix', label: 'Suffix', kind: 'text' },
+    { name: 'prefix', label: 'engine.inspector.pageBlock.field.object-metric.prefix', kind: 'text' },
+    { name: 'suffix', label: 'engine.inspector.pageBlock.field.object-metric.suffix', kind: 'text' },
     // `aggregate` ({ field, function }) and `filter` are nested/complex — they
     // render in the generic Advanced section as editable JSON.
   ],
   'object-kanban': [
-    { name: 'objectName', label: 'Object', kind: 'object-picker' },
-    { name: 'groupField', label: 'Group by field', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
-    { name: 'titleField', label: 'Title field', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
-    { name: 'cardFields', label: 'Card fields', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'objectName', label: 'engine.inspector.pageBlock.field.object-kanban.objectName', kind: 'object-picker' },
+    { name: 'groupField', label: 'engine.inspector.pageBlock.field.object-kanban.groupField', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'titleField', label: 'engine.inspector.pageBlock.field.object-kanban.titleField', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'cardFields', label: 'engine.inspector.pageBlock.field.object-kanban.cardFields', kind: 'field-list', objectFrom: 'self', objectProp: 'objectName' },
   ],
 
   // ── Layout grid ───────────────────────────────────────────────────────────
   grid: [
-    { name: 'columns', label: 'Columns', kind: 'number', placeholder: '3' },
-    { name: 'gap', label: 'Gap', kind: 'number', placeholder: '4' },
+    { name: 'columns', label: 'engine.inspector.pageBlock.field.grid.columns', kind: 'number', placeholder: '3' },
+    { name: 'gap', label: 'engine.inspector.pageBlock.field.grid.gap', kind: 'number', placeholder: '4' },
   ],
 
   // ── Content elements ──────────────────────────────────────────────────────
   'element:text': [
-    { name: 'content', label: 'Content', kind: 'text', placeholder: 'Text…' },
+    { name: 'content', label: 'engine.inspector.pageBlock.field.element:text.content', kind: 'text', placeholder: 'Text…' },
     {
       name: 'variant',
-      label: 'Variant',
+      label: 'engine.inspector.pageBlock.field.element:text.variant',
       kind: 'select',
       options: [
-        { value: 'heading', label: 'Heading' },
-        { value: 'subheading', label: 'Subheading' },
-        { value: 'body', label: 'Body' },
-        { value: 'caption', label: 'Caption' },
+        { value: 'heading', label: 'engine.inspector.pageBlock.option.variant.heading' },
+        { value: 'subheading', label: 'engine.inspector.pageBlock.option.variant.subheading' },
+        { value: 'body', label: 'engine.inspector.pageBlock.option.variant.body' },
+        { value: 'caption', label: 'engine.inspector.pageBlock.option.variant.caption' },
       ],
     },
-    { name: 'align', label: 'Align', kind: 'select', options: ALIGN_OPTS },
+    { name: 'align', label: 'engine.inspector.pageBlock.field.element:text.align', kind: 'select', options: ALIGN_OPTS },
   ],
   'element:image': [
-    { name: 'src', label: 'Source URL', kind: 'text', placeholder: 'https://…' },
-    { name: 'alt', label: 'Alt text', kind: 'text' },
+    { name: 'src', label: 'engine.inspector.pageBlock.field.element:image.src', kind: 'text', placeholder: 'https://…' },
+    { name: 'alt', label: 'engine.inspector.pageBlock.field.element:image.alt', kind: 'text' },
     {
       name: 'fit',
-      label: 'Fit',
+      label: 'engine.inspector.pageBlock.field.element:image.fit',
       kind: 'select',
       options: [
-        { value: 'cover', label: 'Cover' },
-        { value: 'contain', label: 'Contain' },
-        { value: 'fill', label: 'Fill' },
+        { value: 'cover', label: 'engine.inspector.pageBlock.option.fit.cover' },
+        { value: 'contain', label: 'engine.inspector.pageBlock.option.fit.contain' },
+        { value: 'fill', label: 'engine.inspector.pageBlock.option.fit.fill' },
       ],
     },
   ],
@@ -175,78 +216,78 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
   'element:definition-list': [
     {
       name: 'items',
-      label: 'Items',
+      label: 'engine.inspector.pageBlock.field.element:definition-list.items',
       kind: 'array',
-      addLabel: 'Add item',
+      addLabel: 'engine.inspector.pageBlock.add.element:definition-list.items',
       itemFields: [
-        { name: 'label', label: 'Label', kind: 'text' },
-        { name: 'value', label: 'Value', kind: 'text' },
+        { name: 'label', label: 'engine.inspector.pageBlock.field.element:definition-list.items.label', kind: 'text' },
+        { name: 'value', label: 'engine.inspector.pageBlock.field.element:definition-list.items.value', kind: 'text' },
       ],
     },
-    { name: 'columns', label: 'Columns (1 or 2)', kind: 'number', placeholder: '1' },
-    { name: 'inline', label: 'Inline (label · value)', kind: 'boolean' },
+    { name: 'columns', label: 'engine.inspector.pageBlock.field.element:definition-list.columns', kind: 'number', placeholder: '1' },
+    { name: 'inline', label: 'engine.inspector.pageBlock.field.element:definition-list.inline', kind: 'boolean' },
   ],
   'element:repeater': [
-    { name: 'object', label: 'Object', kind: 'object-picker' },
-    { name: 'titleField', label: 'Title field', kind: 'field-picker', objectFrom: 'self', objectProp: 'object' },
-    { name: 'fields', label: 'Fields', kind: 'field-list', objectFrom: 'self', objectProp: 'object' },
-    { name: 'limit', label: 'Limit', kind: 'number', placeholder: '10' },
-    { name: 'emptyText', label: 'Empty text', kind: 'text' },
-    { name: 'divided', label: 'Dividers between rows', kind: 'boolean' },
+    { name: 'object', label: 'engine.inspector.pageBlock.field.element:repeater.object', kind: 'object-picker' },
+    { name: 'titleField', label: 'engine.inspector.pageBlock.field.element:repeater.titleField', kind: 'field-picker', objectFrom: 'self', objectProp: 'object' },
+    { name: 'fields', label: 'engine.inspector.pageBlock.field.element:repeater.fields', kind: 'field-list', objectFrom: 'self', objectProp: 'object' },
+    { name: 'limit', label: 'engine.inspector.pageBlock.field.element:repeater.limit', kind: 'number', placeholder: '10' },
+    { name: 'emptyText', label: 'engine.inspector.pageBlock.field.element:repeater.emptyText', kind: 'text' },
+    { name: 'divided', label: 'engine.inspector.pageBlock.field.element:repeater.divided', kind: 'boolean' },
   ],
   'element:number': [
-    { name: 'object', label: 'Object', kind: 'object-picker' },
-    { name: 'field', label: 'Field', kind: 'field-picker', objectFrom: 'self', objectProp: 'object' },
+    { name: 'object', label: 'engine.inspector.pageBlock.field.element:number.object', kind: 'object-picker' },
+    { name: 'field', label: 'engine.inspector.pageBlock.field.element:number.field', kind: 'field-picker', objectFrom: 'self', objectProp: 'object' },
     {
       name: 'aggregate',
-      label: 'Aggregate',
+      label: 'engine.inspector.pageBlock.field.element:number.aggregate',
       kind: 'select',
       options: [
-        { value: 'count', label: 'Count' },
-        { value: 'sum', label: 'Sum' },
-        { value: 'avg', label: 'Average' },
-        { value: 'min', label: 'Min' },
-        { value: 'max', label: 'Max' },
+        { value: 'count', label: 'engine.inspector.pageBlock.option.aggregate.count' },
+        { value: 'sum', label: 'engine.inspector.pageBlock.option.aggregate.sum' },
+        { value: 'avg', label: 'engine.inspector.pageBlock.option.aggregate.avg' },
+        { value: 'min', label: 'engine.inspector.pageBlock.option.aggregate.min' },
+        { value: 'max', label: 'engine.inspector.pageBlock.option.aggregate.max' },
       ],
     },
     {
       name: 'format',
-      label: 'Format',
+      label: 'engine.inspector.pageBlock.field.element:number.format',
       kind: 'select',
       options: [
-        { value: 'number', label: 'Number' },
-        { value: 'currency', label: 'Currency' },
-        { value: 'percent', label: 'Percent' },
+        { value: 'number', label: 'engine.inspector.pageBlock.option.format.number' },
+        { value: 'currency', label: 'engine.inspector.pageBlock.option.format.currency' },
+        { value: 'percent', label: 'engine.inspector.pageBlock.option.format.percent' },
       ],
     },
-    { name: 'prefix', label: 'Prefix', kind: 'text' },
-    { name: 'suffix', label: 'Suffix', kind: 'text' },
+    { name: 'prefix', label: 'engine.inspector.pageBlock.field.element:number.prefix', kind: 'text' },
+    { name: 'suffix', label: 'engine.inspector.pageBlock.field.element:number.suffix', kind: 'text' },
   ],
   'element:button': [
-    { name: 'label', label: 'Label', kind: 'text' },
+    { name: 'label', label: 'engine.inspector.pageBlock.field.element:button.label', kind: 'text' },
     {
       name: 'variant',
-      label: 'Variant',
+      label: 'engine.inspector.pageBlock.field.element:button.variant',
       kind: 'select',
       options: [
-        { value: 'primary', label: 'Primary' },
-        { value: 'secondary', label: 'Secondary' },
-        { value: 'danger', label: 'Danger' },
-        { value: 'ghost', label: 'Ghost' },
-        { value: 'link', label: 'Link' },
+        { value: 'primary', label: 'engine.inspector.pageBlock.option.variant.primary' },
+        { value: 'secondary', label: 'engine.inspector.pageBlock.option.variant.secondary' },
+        { value: 'danger', label: 'engine.inspector.pageBlock.option.variant.danger' },
+        { value: 'ghost', label: 'engine.inspector.pageBlock.option.variant.ghost' },
+        { value: 'link', label: 'engine.inspector.pageBlock.option.variant.link' },
       ],
     },
     {
       name: 'size',
-      label: 'Size',
+      label: 'engine.inspector.pageBlock.field.element:button.size',
       kind: 'select',
       options: [
-        { value: 'small', label: 'Small' },
-        { value: 'medium', label: 'Medium' },
-        { value: 'large', label: 'Large' },
+        { value: 'small', label: 'engine.inspector.pageBlock.option.size.small' },
+        { value: 'medium', label: 'engine.inspector.pageBlock.option.size.medium' },
+        { value: 'large', label: 'engine.inspector.pageBlock.option.size.large' },
       ],
     },
-    { name: 'icon', label: 'Icon', kind: 'text', placeholder: 'lucide icon name' },
+    { name: 'icon', label: 'engine.inspector.pageBlock.field.element:button.icon', kind: 'text', placeholder: 'lucide icon name' },
     // Without `action` a button renders inert, and the generic "Advanced"
     // section can only edit properties the block ALREADY has — so a button
     // created in Studio had no way to become interactive at all. The spec
@@ -254,7 +295,7 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
     // editor is the honest fit until the inspector can render a nested schema.
     {
       name: 'action',
-      label: 'Action',
+      label: 'engine.inspector.pageBlock.field.element:button.action',
       kind: 'json',
       placeholder: '{ "type": "url", "target": "/environments" }',
     },
@@ -262,50 +303,50 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
 
   // ── Layout containers ─────────────────────────────────────────────────────
   'page:header': [
-    { name: 'title', label: 'Title', kind: 'text' },
-    { name: 'subtitle', label: 'Subtitle', kind: 'text' },
-    { name: 'icon', label: 'Icon', kind: 'text', placeholder: 'lucide icon name' },
-    { name: 'breadcrumb', label: 'Show breadcrumb', kind: 'boolean' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.page:header.title', kind: 'text' },
+    { name: 'subtitle', label: 'engine.inspector.pageBlock.field.page:header.subtitle', kind: 'text' },
+    { name: 'icon', label: 'engine.inspector.pageBlock.field.page:header.icon', kind: 'text', placeholder: 'lucide icon name' },
+    { name: 'breadcrumb', label: 'engine.inspector.pageBlock.field.page:header.breadcrumb', kind: 'boolean' },
   ],
   'page:card': [
-    { name: 'title', label: 'Title', kind: 'text' },
-    { name: 'bordered', label: 'Bordered', kind: 'boolean' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.page:card.title', kind: 'text' },
+    { name: 'bordered', label: 'engine.inspector.pageBlock.field.page:card.bordered', kind: 'boolean' },
   ],
   'page:tabs': [
     {
       name: 'items',
-      label: 'Tabs',
+      label: 'engine.inspector.pageBlock.field.page:tabs.items',
       kind: 'array',
-      addLabel: 'Add tab',
+      addLabel: 'engine.inspector.pageBlock.add.page:tabs.items',
       itemFields: [
-        { name: 'key', label: 'Key', kind: 'text' },
-        { name: 'label', label: 'Label', kind: 'text' },
+        { name: 'key', label: 'engine.inspector.pageBlock.field.page:tabs.items.key', kind: 'text' },
+        { name: 'label', label: 'engine.inspector.pageBlock.field.page:tabs.items.label', kind: 'text' },
       ],
     },
   ],
   'page:accordion': [
-    { name: 'title', label: 'Title', kind: 'text' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.page:accordion.title', kind: 'text' },
     {
       name: 'items',
-      label: 'Sections',
+      label: 'engine.inspector.pageBlock.field.page:accordion.items',
       kind: 'array',
-      addLabel: 'Add section',
+      addLabel: 'engine.inspector.pageBlock.add.page:accordion.items',
       itemFields: [
-        { name: 'value', label: 'Key', kind: 'text' },
-        { name: 'label', label: 'Label', kind: 'text' },
+        { name: 'value', label: 'engine.inspector.pageBlock.field.page:accordion.items.value', kind: 'text' },
+        { name: 'label', label: 'engine.inspector.pageBlock.field.page:accordion.items.label', kind: 'text' },
       ],
     },
   ],
 
   // ── Record context ────────────────────────────────────────────────────────
   'record:related_list': [
-    { name: 'objectName', label: 'Object', kind: 'object-picker' },
-    { name: 'relationshipField', label: 'Relationship field', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
-    { name: 'title', label: 'Title', kind: 'text' },
-    { name: 'limit', label: 'Limit', kind: 'number', placeholder: '10' },
+    { name: 'objectName', label: 'engine.inspector.pageBlock.field.record:related_list.objectName', kind: 'object-picker' },
+    { name: 'relationshipField', label: 'engine.inspector.pageBlock.field.record:related_list.relationshipField', kind: 'field-picker', objectFrom: 'self', objectProp: 'objectName' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.record:related_list.title', kind: 'text' },
+    { name: 'limit', label: 'engine.inspector.pageBlock.field.record:related_list.limit', kind: 'number', placeholder: '10' },
   ],
   'record:highlights': [
-    { name: 'fields', label: 'Fields', kind: 'field-list', objectFrom: 'page' },
+    { name: 'fields', label: 'engine.inspector.pageBlock.field.record:highlights.fields', kind: 'field-list', objectFrom: 'page' },
   ],
   'record:details': [
     {
@@ -327,61 +368,61 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
       // has no pattern/validate affordance — see the type above — and adding
       // one for a single field is outside this fix.
       name: 'sections',
-      label: 'Sections',
+      label: 'engine.inspector.pageBlock.field.record:details.sections',
       kind: 'array',
-      addLabel: 'Add section',
+      addLabel: 'engine.inspector.pageBlock.add.record:details.sections',
       itemFields: [
-        { name: 'name', label: 'Name (i18n key)', kind: 'text', placeholder: 'snake_case, e.g. contact_info' },
-        { name: 'label', label: 'Label', kind: 'text' },
-        { name: 'columns', label: 'Columns', kind: 'number', placeholder: '2' },
-        { name: 'fields', label: 'Fields', kind: 'field-list', objectFrom: 'page' },
+        { name: 'name', label: 'engine.inspector.pageBlock.field.record:details.sections.name', kind: 'text', placeholder: 'snake_case, e.g. contact_info' },
+        { name: 'label', label: 'engine.inspector.pageBlock.field.record:details.sections.label', kind: 'text' },
+        { name: 'columns', label: 'engine.inspector.pageBlock.field.record:details.sections.columns', kind: 'number', placeholder: '2' },
+        { name: 'fields', label: 'engine.inspector.pageBlock.field.record:details.sections.fields', kind: 'field-list', objectFrom: 'page' },
       ],
     },
   ],
   'record:alert': [
     {
       name: 'severity',
-      label: 'Severity',
+      label: 'engine.inspector.pageBlock.field.record:alert.severity',
       kind: 'select',
       options: [
-        { value: 'info', label: 'Info' },
-        { value: 'warning', label: 'Warning' },
-        { value: 'error', label: 'Error' },
-        { value: 'success', label: 'Success' },
+        { value: 'info', label: 'engine.inspector.pageBlock.option.severity.info' },
+        { value: 'warning', label: 'engine.inspector.pageBlock.option.severity.warning' },
+        { value: 'error', label: 'engine.inspector.pageBlock.option.severity.error' },
+        { value: 'success', label: 'engine.inspector.pageBlock.option.severity.success' },
       ],
     },
-    { name: 'title', label: 'Title', kind: 'text' },
-    { name: 'body', label: 'Body', kind: 'text' },
-    { name: 'icon', label: 'Icon', kind: 'text', placeholder: 'lucide icon name' },
-    { name: 'dismissible', label: 'Dismissible', kind: 'boolean' },
+    { name: 'title', label: 'engine.inspector.pageBlock.field.record:alert.title', kind: 'text' },
+    { name: 'body', label: 'engine.inspector.pageBlock.field.record:alert.body', kind: 'text' },
+    { name: 'icon', label: 'engine.inspector.pageBlock.field.record:alert.icon', kind: 'text', placeholder: 'lucide icon name' },
+    { name: 'dismissible', label: 'engine.inspector.pageBlock.field.record:alert.dismissible', kind: 'boolean' },
   ],
   'record:path': [
-    { name: 'statusField', label: 'Status field', kind: 'field-picker', objectFrom: 'page' },
+    { name: 'statusField', label: 'engine.inspector.pageBlock.field.record:path.statusField', kind: 'field-picker', objectFrom: 'page' },
     {
       name: 'stages',
-      label: 'Stages',
+      label: 'engine.inspector.pageBlock.field.record:path.stages',
       kind: 'array',
-      addLabel: 'Add stage',
+      addLabel: 'engine.inspector.pageBlock.add.record:path.stages',
       itemFields: [
-        { name: 'value', label: 'Value', kind: 'text' },
-        { name: 'label', label: 'Label', kind: 'text' },
+        { name: 'value', label: 'engine.inspector.pageBlock.field.record:path.stages.value', kind: 'text' },
+        { name: 'label', label: 'engine.inspector.pageBlock.field.record:path.stages.label', kind: 'text' },
       ],
     },
   ],
   'record:quick_actions': [
-    { name: 'actionNames', label: 'Action names', kind: 'string-list', placeholder: 'action name' },
+    { name: 'actionNames', label: 'engine.inspector.pageBlock.field.record:quick_actions.actionNames', kind: 'string-list', placeholder: 'action name' },
     {
       name: 'location',
-      label: 'Location',
+      label: 'engine.inspector.pageBlock.field.record:quick_actions.location',
       kind: 'select',
       options: [
-        { value: 'record_header', label: 'Record header' },
-        { value: 'record_more', label: 'Record more menu' },
-        { value: 'record_section', label: 'Record section' },
-        { value: 'record_related', label: 'Record related' },
-        { value: 'list_toolbar', label: 'List toolbar' },
-        { value: 'list_item', label: 'List item' },
-        { value: 'global_nav', label: 'Global nav' },
+        { value: 'record_header', label: 'engine.inspector.pageBlock.option.location.record_header' },
+        { value: 'record_more', label: 'engine.inspector.pageBlock.option.location.record_more' },
+        { value: 'record_section', label: 'engine.inspector.pageBlock.option.location.record_section' },
+        { value: 'record_related', label: 'engine.inspector.pageBlock.option.location.record_related' },
+        { value: 'list_toolbar', label: 'engine.inspector.pageBlock.option.location.list_toolbar' },
+        { value: 'list_item', label: 'engine.inspector.pageBlock.option.location.list_item' },
+        { value: 'global_nav', label: 'engine.inspector.pageBlock.option.location.global_nav' },
       ],
     },
   ],
@@ -391,8 +432,8 @@ export const BLOCK_CONFIG: Record<string, BlockPropField[]> = {
   // renderer — see block-types.ts PALETTE_EXCLUSIONS, #2943). A config panel
   // for an unauthorable block is how the contradiction stayed invisible.
   'ai:input': [
-    { name: 'agentName', label: 'Agent', kind: 'text', placeholder: 'agent name' },
-    { name: 'placeholder', label: 'Input placeholder', kind: 'text' },
+    { name: 'agentName', label: 'engine.inspector.pageBlock.field.ai:input.agentName', kind: 'text', placeholder: 'agent name' },
+    { name: 'placeholder', label: 'engine.inspector.pageBlock.field.ai:input.placeholder', kind: 'text' },
   ],
 };