@object-ui/app-shell 11.3.0 → 11.5.0

package/dist/views/metadata-admin/i18n.js

@@ -1,4 +1,26 @@
 // Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * Metadata admin i18n bundle (Phase 3f).
+ *
+ * Lightweight static label table for the 27 built-in metadata types,
+ * plus a tiny `t()` helper for engine UI strings.
+ *
+ * Why not i18next? The engine already consumes `label` from the
+ * server's `/meta/types` response (which is sourced from
+ * `DEFAULT_METADATA_TYPE_REGISTRY`). This bundle exists as a fallback
+ * for environments without translation bundles configured, and as the
+ * single source of truth for Chinese labels until the platform's
+ * `setup.translation.ts` ships zh-CN coverage.
+ *
+ * Usage:
+ *   import { translateMetadataType, t } from './i18n';
+ *   translateMetadataType('view', 'zh-CN')  // → '视图'
+ *   t('engine.directory.title', 'zh-CN')    // → '元数据'
+ *
+ * The DirectoryPage / PageShell call these to localise headings when
+ * the consumer hasn't wired the global i18n provider.
+ */
+import { useObjectTranslation } from '@object-ui/i18n';
 const TYPE_LABELS_EN = {
     // Data
     object: 'Object',
@@ -345,10 +367,38 @@ const ENGINE_STRINGS_EN = {
     'engine.inspector.appNav.kind': 'Nav Item',
     'engine.inspector.appNav.close': 'Close nav item',
     'engine.inspector.appNav.label': 'Label',
-    'engine.inspector.appNav.path': 'Path / Route',
     'engine.inspector.appNav.icon': 'Icon',
-    'engine.inspector.appNav.kindField': 'Kind',
     'engine.inspector.appNav.remove': 'Remove nav item',
+    'engine.inspector.appNav.typeField': 'Type',
+    'engine.inspector.appNav.type.object': 'Object',
+    'engine.inspector.appNav.type.page': 'Page',
+    'engine.inspector.appNav.type.dashboard': 'Dashboard',
+    'engine.inspector.appNav.type.report': 'Report',
+    'engine.inspector.appNav.type.url': 'Link (URL)',
+    'engine.inspector.appNav.type.group': 'Group',
+    'engine.inspector.appNav.object': 'Object',
+    'engine.inspector.appNav.targetMode': 'Landing',
+    'engine.inspector.appNav.mode.default': 'Default view (workspace)',
+    'engine.inspector.appNav.mode.view': 'Named view',
+    'engine.inspector.appNav.mode.record': 'Record deep-link',
+    'engine.inspector.appNav.mode.filters': 'Filtered slice (/data)',
+    'engine.inspector.appNav.view': 'View',
+    'engine.inspector.appNav.recordId': 'Record ID',
+    'engine.inspector.appNav.recordIdHint': 'Supports {current_user_id} and {current_org_id} template variables.',
+    'engine.inspector.appNav.recordMode': 'Open mode',
+    'engine.inspector.appNav.recordModeView': 'View',
+    'engine.inspector.appNav.recordModeEdit': 'Edit',
+    'engine.inspector.appNav.filters': 'URL filters',
+    'engine.inspector.appNav.filtersField': 'Field',
+    'engine.inspector.appNav.filtersValue': 'Value',
+    'engine.inspector.appNav.filtersAdd': 'Add condition',
+    'engine.inspector.appNav.filtersRemove': 'Remove condition',
+    'engine.inspector.appNav.filtersHint': 'One-off slice carried in the URL — promote it to a named view when it becomes curated and reused.',
+    'engine.inspector.appNav.url': 'URL',
+    'engine.inspector.appNav.urlTarget': 'Open in',
+    'engine.inspector.appNav.urlTargetSelf': 'Same tab',
+    'engine.inspector.appNav.urlTargetBlank': 'New tab',
+    'engine.inspector.appNav.preview': 'Resolved link',
     // View column inspector
     'engine.inspector.viewColumn.kind': 'Column',
     'engine.inspector.viewColumn.close': 'Close column',
@@ -547,9 +597,10 @@ const ENGINE_STRINGS_EN = {
     'engine.packages.col.version': 'Version',
     'engine.packages.col.scope': 'Scope',
     'engine.packages.col.status': 'Status',
-    'engine.packages.scope.project': 'Project',
+    'engine.packages.scope.project': 'Read-only · code',
     'engine.packages.scope.system': 'System',
     'engine.packages.scope.cloud': 'Cloud',
+    'engine.packages.scope.writable': 'Writable',
     'engine.packages.status.enabled': 'Enabled',
     'engine.packages.status.disabled': 'Disabled',
     'engine.packages.import.invalidJson': 'Selected file is not valid JSON.',
@@ -805,6 +856,234 @@ const ENGINE_STRINGS_EN = {
     // AI assistant entry points
     'designer.canvas.askAi': 'Ask AI',
     'designer.canvas.askAiGenerate': 'Generate fields with AI',
+    // ── StudioDesignSurface (ADR-0080 WYSIWYG design surface) ──────────────
+    // Shared chrome
+    'engine.studio.cancel': 'Cancel',
+    'engine.studio.create': 'Create',
+    'engine.studio.createDraft': 'Create (save as draft)',
+    'engine.studio.saveDraft': 'Save draft',
+    'engine.studio.data.savedDraft': 'Object “{label}” saved as draft',
+    'engine.studio.data.lastSaved': 'Saved {time}',
+    'engine.studio.publish': 'Publish',
+    'engine.studio.loading': 'Loading…',
+    'engine.studio.loadFailed': 'Failed to load',
+    'engine.studio.unpublishedDraft': 'Unpublished draft',
+    'engine.studio.unpublished': 'Unpublished',
+    'engine.studio.new': 'New',
+    'engine.studio.edit': 'Edit',
+    'engine.studio.done': 'Done',
+    'engine.studio.close': 'Close',
+    'engine.studio.deselect': 'Clear selection',
+    'engine.studio.home': 'Back to home',
+    // Pillar tab labels
+    'engine.studio.pillar.data': 'Data',
+    'engine.studio.pillar.automations': 'Automations',
+    'engine.studio.pillar.interfaces': 'Interfaces',
+    'engine.studio.pillar.access': 'Access',
+    // Header · package-level publish + app bridge
+    'engine.studio.changes': 'Changes',
+    'engine.studio.publishTitle': 'Confirm and publish all pending drafts at once (whole package · one atomic release)',
+    'engine.studio.publishNoneTitle': 'No drafts pending publish',
+    'engine.studio.publishedAll': 'Published all drafts in this package (one atomic release)',
+    'engine.studio.app.open': 'Open app',
+    'engine.studio.app.openTitle': 'Open app “{label}” (the published front-end)',
+    'engine.studio.app.create': 'Create app',
+    'engine.studio.app.noneTitle': 'This package has no app (front-end) yet — create one',
+    'engine.studio.app.willOpenAfterPublish': 'After publishing, this becomes “Open app”',
+    'engine.studio.app.pending': 'App “{label}” pending publish',
+    'engine.studio.app.namePlaceholder': 'App name (e.g. Order Center)',
+    'engine.studio.app.idPlaceholder': 'Identifier (e.g. orders_app)',
+    'engine.studio.app.savedDraft': 'App “{label}” saved as draft — open it after publishing',
+    // Package switcher
+    'engine.studio.pkg.switchTitle': 'Switch / create package',
+    'engine.studio.pkg.readonly': 'Read-only',
+    'engine.studio.pkg.readonlyHint': 'Read-only package — switch to or create a writable package to edit.',
+    'engine.studio.app.scaffoldNav': "Add this package's objects as menu items",
+    'engine.studio.landing.title': 'App Builder',
+    'engine.studio.landing.description': 'Design objects, forms, automations and interfaces inside a writable package; edits save as drafts and the whole package publishes in one release. Code-loaded packages are read-only (browse only).',
+    'engine.studio.landing.mineHeading': 'My packages (writable)',
+    'engine.studio.landing.noneWritable': 'No writable packages yet — create one to start.',
+    'engine.studio.landing.dup': 'Duplicate',
+    'engine.studio.landing.dupTitle': 'Duplicate this package into a new writable copy (like “duplicate base”)',
+    'engine.studio.landing.dupDefaultName': '{name} copy',
+    'engine.studio.landing.dupNamePlaceholder': 'Copy name',
+    'engine.studio.landing.dupIdPlaceholder': 'Copy package ID',
+    'engine.studio.landing.dupGo': 'Duplicate and open the builder',
+    'engine.studio.landing.dupCreated': 'Duplicated into writable package “{name}”',
+    'engine.studio.landing.createGo': 'Create and start building',
+    'engine.studio.landing.installedHeading': 'Installed (read-only · browsable)',
+    'engine.studio.designer.search': 'Search…',
+    'engine.studio.designer.select': 'Select…',
+    'engine.studio.designer.pickDate': 'Pick a date…',
+    'engine.studio.designer.fieldAria': '{label} — click to edit properties, drag to reorder',
+    'engine.studio.designer.groupUp': 'Move group up',
+    'engine.studio.designer.groupDown': 'Move group down',
+    'engine.studio.designer.groupDelete': 'Delete group',
+    'engine.studio.designer.groupDeleteTitle': 'Delete group (its fields move to Ungrouped)',
+    'engine.studio.designer.dropHere': 'Drag fields here',
+    'engine.studio.designer.ungrouped': 'Ungrouped',
+    'engine.studio.designer.newGroup': 'New group',
+    'engine.studio.designer.hint': 'Drag to reorder / move across groups · click a field to edit its properties',
+    'engine.studio.designer.addGroup': 'Add group',
+    'engine.studio.rules.title': 'Validation rules',
+    'engine.studio.rules.none': 'No validation rules yet.',
+    'engine.studio.rules.explain': 'Rules run when a record is saved: when the condition is true, the save is rejected with the message.',
+    'engine.studio.rules.noMessage': '(no message)',
+    'engine.studio.rules.pick': 'Select a rule on the left, or click “New” to create one.',
+    'engine.studio.rules.structured': '“{type}” rules carry structured configuration (state-machine transitions / format constraints etc.) and cannot be edited here yet — maintain them in the code package. Message: {message}',
+    'engine.studio.rules.none2': '(none)',
+    'engine.studio.rules.deleteRule': 'Delete rule',
+    'engine.studio.rules.nameLabel': 'Rule name (snake_case, unique)',
+    'engine.studio.rules.messageLabel': 'Error message (shown to the user when validation fails)',
+    'engine.studio.rules.messagePlaceholder': 'e.g. Completion date is required when status is Done',
+    'engine.studio.rules.celPre': 'Fail condition (CEL) — when the condition is ',
+    'engine.studio.rules.celTrue': 'true',
+    'engine.studio.rules.celMid': ', the save is rejected with the message above; new rules default to ',
+    'engine.studio.rules.celPost': ' (never fires) — replace it with a real condition.',
+    'engine.studio.rules.severity': 'Severity',
+    'engine.studio.rules.severityError': 'error (rejects the save)',
+    'engine.studio.rules.enabled': 'Enabled',
+    'engine.studio.rules.delete': 'Delete',
+    'engine.studio.settings.basics': 'Basics',
+    'engine.studio.settings.noInspector': 'No default object inspector registered.',
+    'engine.studio.settings.semanticRoles': 'Semantic roles',
+    'engine.studio.settings.semanticHint': 'Applied consistently across forms, lists and detail pages (ADR-0085)',
+    'engine.studio.settings.nameField': 'Record name field (nameField) — shown in titles, links and references',
+    'engine.studio.settings.autoDerive': '(auto-derived)',
+    'engine.studio.settings.stageField': 'Lifecycle field (stageField) — the detail page progress bar renders its options',
+    'engine.studio.settings.autoDetect': '(auto-detect status/stage-like field names)',
+    'engine.studio.settings.stageNone': 'None — this object has no linear flow; hide the progress bar',
+    'engine.studio.settings.highlightFields': 'Highlight fields (highlightFields) — default list columns, cards and detail header take the first 4; order is display order',
+    'engine.studio.settings.removeField': 'Remove {field}',
+    'engine.studio.settings.addFieldOption': '+ Add field…',
+    'engine.studio.settings.undeclared': '(not declared — surfaces pick heuristically)',
+    'engine.studio.pkg.writable': 'Writable',
+    'engine.studio.pkg.heading': 'Packages (apps)',
+    'engine.studio.pkg.none': 'No app packages yet',
+    'engine.studio.pkg.namePlaceholder': 'Name (e.g. Repair Center)',
+    'engine.studio.pkg.idPlaceholder': 'Package ID (e.g. com.example.repairs)',
+    'engine.studio.pkg.idStrippedNotice': 'Unsupported characters were removed — allowed: lowercase letters, digits, dots, hyphens, underscores',
+    'engine.studio.pkg.idFormatHint': 'Use a reverse-domain identifier with at least one dot, e.g. com.example.myapp',
+    'engine.studio.pkg.idFromNameUnavailable': 'No identifier could be suggested from this name — type one below (e.g. com.example.myapp)',
+    'engine.studio.pkg.createWritable': 'Create writable package',
+    'engine.studio.pkg.new': 'New package (writable base)',
+    'engine.studio.pkg.created': 'Package {name} created (writable)',
+    // Nav item inspector (Interfaces pillar)
+    'engine.studio.nav.selectItem': 'Select a menu item on the left.',
+    'engine.studio.nav.label': 'Label',
+    'engine.studio.nav.labelPlaceholder': 'e.g. Positions',
+    'engine.studio.nav.linkObject': 'Link to object',
+    'engine.studio.nav.chooseObject': '— Choose object —',
+    'engine.studio.nav.boundHint': 'This menu item opens that object’s record list.',
+    'engine.studio.nav.unboundHint': 'Choose an object; the menu item will open its record list.',
+    'engine.studio.nav.noObjects': 'This package has no objects yet — create one in the Data pillar first.',
+    // Interfaces pillar
+    'engine.studio.if.pickLeft': 'Select a menu item on the left',
+    'engine.studio.if.navHeading': '{app} · Navigation',
+    'engine.studio.if.editNavTitle': 'Edit navigation (drag to reorder / rename / add-remove)',
+    'engine.studio.if.doneEditTitle': 'Done editing',
+    'engine.studio.if.noApp': 'This package has no app yet.',
+    'engine.studio.if.noNavItems': 'No nav items yet — (click “Edit” above to add)',
+    'engine.studio.if.previewIsRuntime': 'Preview = runtime · same renderer',
+    'engine.studio.if.noAppTitle': 'This package has no app yet',
+    'engine.studio.if.noAppHint': 'Create an app to design its navigation and interfaces.',
+    'engine.studio.if.readonlyPreview': '{type} shows a read-only preview for now; design support is in progress.',
+    'engine.studio.if.editHint': 'Click a block → edit on the right · then “Save draft” → “Publish”',
+    'engine.studio.if.objectHintPre': 'Runtime list preview · edit fields / structure in the ',
+    'engine.studio.if.objectHintPost': ' pillar',
+    'engine.studio.inspector.props': 'Properties',
+    'engine.studio.inspector.emptyLine1': 'Click a block on the canvas,',
+    'engine.studio.inspector.emptyLine2': 'and edit its properties right here.',
+    // Data pillar
+    'engine.studio.data.newFieldLabel': 'New field',
+    'engine.studio.data.nameFieldLabel': 'Name',
+    'engine.studio.data.idExists': 'Identifier “{name}” already exists',
+    'engine.studio.data.fieldCount': '{count} fields',
+    'engine.studio.data.pickObject': 'Select an object',
+    'engine.studio.data.objects': 'Objects',
+    'engine.studio.data.searchObjects': 'Search objects…',
+    'engine.studio.data.noObjects': 'No objects yet — create one below to start',
+    'engine.studio.data.labelPlaceholder': 'Display name (e.g. Repair Ticket)',
+    'engine.studio.data.idPlaceholder': 'Identifier (e.g. repair_ticket)',
+    'engine.studio.data.newObject': 'New object',
+    'engine.studio.data.readOnlyPackage': 'This package is read-only — switch to or create a writable package to add objects',
+    'engine.studio.data.firstObjectTitle': 'Start with your first object',
+    'engine.studio.data.firstObjectHint': 'Objects are your app’s data foundation (e.g. “Orders”, “Customers”). Enter a display name and identifier at the bottom-left to create one; then design its fields, forms, and automations, and publish once at the end.',
+    'engine.studio.data.tab.records': 'Records',
+    'engine.studio.data.tab.form': 'Form',
+    'engine.studio.data.tab.rules': 'Validations',
+    'engine.studio.data.tab.settings': 'Settings',
+    'engine.studio.data.badge.grid': 'Runtime list · same renderer',
+    'engine.studio.data.badge.rules': 'Validation rules · draft',
+    'engine.studio.data.badge.settings': 'Object settings · draft',
+    'engine.studio.data.badge.formLayout': 'Form design · draft',
+    'engine.studio.data.badge.formPreview': 'Runtime form · published definition',
+    'engine.studio.data.addFieldTitle': 'Add a field (then set its type and properties on the right)',
+    'engine.studio.data.addField': 'Add field',
+    'engine.studio.data.editFieldProps': 'Edit field properties',
+    'engine.studio.data.draftObjectTitle': 'Unpublished new object',
+    'engine.studio.data.draftObjectHint': 'The Records grid queries real data, but this object has no table until it’s published. Design fields and groups in “Form · Layout” first, then click “Publish” in the top bar — after publishing, this becomes its live data grid.',
+    'engine.studio.data.goDesignFields': 'Go to “Form · Layout” to design fields',
+    'engine.studio.data.gridHint': 'Column “+” adds a field · pencil edits properties · drag a header to reorder · then “Save draft” → “Publish”',
+    'engine.studio.data.form.layout': 'Layout',
+    'engine.studio.data.form.preview': 'Preview',
+    'engine.studio.data.form.layoutBadge': 'Layout designer · draft (includes unpublished changes)',
+    'engine.studio.data.form.previewBadge': 'Runtime form · published definition',
+    'engine.studio.data.form.previewWarn': 'You have unpublished changes — this preview shows the pre-publish (published) state; confirm the draft in “Layout”, and to see the post-publish result, click “Publish” in the top bar first.',
+    'engine.studio.data.form.noPublishedTitle': 'No published definition yet',
+    'engine.studio.data.form.noPublishedHint': '“Preview” renders the published runtime form, but this object isn’t published yet. Confirm the draft in “Layout”, then click “Publish” in the top bar to preview.',
+    'engine.studio.data.formHint': 'Click any field → edit properties on the right · “Add field” adds a field · then “Save draft” → “Publish”',
+    'engine.studio.data.fieldProps': 'Field properties',
+    // Automations pillar
+    'engine.studio.auto.nodeStart': 'Start',
+    'engine.studio.auto.nodeEnd': 'End',
+    'engine.studio.auto.savedDraft': 'Automation “{label}” saved as draft',
+    'engine.studio.auto.defaultOff': 'Off by default · review before enabling',
+    'engine.studio.auto.heading': 'Automations · flow',
+    'engine.studio.auto.on': 'On',
+    'engine.studio.auto.off': 'Off',
+    'engine.studio.auto.offTitle': 'Disabled — will not run',
+    'engine.studio.auto.onBound': 'Enabled · bound to its trigger',
+    'engine.studio.auto.onUnbound': 'Enabled · no trigger (run manually)',
+    'engine.studio.auto.enabled': 'Enabled',
+    'engine.studio.auto.disabled': 'Disabled',
+    'engine.studio.auto.enableTitle': 'Enable this automation (publish to apply)',
+    'engine.studio.auto.disableTitle': 'Disable this automation (publish to apply)',
+    'engine.studio.auto.enabledToast': 'Enabled — publish to apply',
+    'engine.studio.auto.disabledToast': 'Disabled — publish to apply',
+    'engine.studio.auto.newTitle': 'New automation',
+    'engine.studio.auto.none': 'No automations yet — click “New” to start',
+    'engine.studio.auto.namePlaceholder': 'Name (e.g. Offer Notice)',
+    'engine.studio.auto.idPlaceholder': 'Identifier (e.g. offer_notice)',
+    'engine.studio.auto.canvasHint': 'Visual orchestration · click a node to configure',
+    'engine.studio.auto.pick': 'Select an automation',
+    'engine.studio.auto.editHint': 'Click a node → configure on the right · then “Save draft” → “Publish”',
+    'engine.studio.auto.config': 'Configuration',
+    'engine.studio.auto.emptyLine1': 'Click a node on the canvas,',
+    'engine.studio.auto.emptyLine2': 'and its configuration appears here.',
+    // Access pillar
+    'engine.studio.access.created': 'Permission set “{label}” created',
+    'engine.studio.access.title': 'Permission matrix',
+    'engine.studio.access.subtitle': 'Objects × CRUD · field-level R/W',
+    'engine.studio.access.bannerTitle': 'This matrix lists only the objects this package declares, and “Save” merges just that slice — grants contributed by other packages are preserved. Edits are saved as package drafts and go live when you Publish the package (top bar), exactly like Data and Interfaces.',
+    'engine.studio.access.banner': 'This package’s objects · saved as draft',
+    'engine.studio.access.heading': 'Permission sets / Profiles',
+    'engine.studio.access.search': 'Search permissions…',
+    'engine.studio.access.none': 'No permission sets yet — create one below',
+    'engine.studio.access.labelPlaceholder': 'Display name (e.g. Sales permissions)',
+    'engine.studio.access.idPlaceholder': 'Identifier (e.g. sales_perms)',
+    'engine.studio.access.new': 'New permission set',
+    'engine.studio.access.emptyMain': 'Create a permission set to start configuring',
+    'engine.studio.access.pick': 'Select a permission set',
+    // ── AppNavCanvas (nav-tree editor, used by Studio + AppPreview) ─────────
+    'engine.appNav.heading': 'Navigation',
+    'engine.appNav.addItem': 'Add nav item',
+    'engine.appNav.removeItem': 'Remove nav item',
+    'engine.appNav.empty': 'Empty — click “Add nav item” to start',
+    'engine.appNav.emptyReadonly': 'No top-level nav items yet',
+    'engine.appNav.newItem': 'New item',
+    'engine.appNav.itemOne': 'item',
+    'engine.appNav.itemOther': 'items',
 };
 const ENGINE_STRINGS_ZH = {
     'engine.package.writableRequired': '请先选择或新建一个可写的基座（package）——只读的代码包中无法新建该项。',
@@ -1040,10 +1319,38 @@ const ENGINE_STRINGS_ZH = {
     'engine.inspector.appNav.kind': '导航项',
     'engine.inspector.appNav.close': '关闭导航项',
     'engine.inspector.appNav.label': '名称',
-    'engine.inspector.appNav.path': '路径 / 路由',
     'engine.inspector.appNav.icon': '图标',
-    'engine.inspector.appNav.kindField': '类型',
     'engine.inspector.appNav.remove': '删除导航项',
+    'engine.inspector.appNav.typeField': '类型',
+    'engine.inspector.appNav.type.object': '对象',
+    'engine.inspector.appNav.type.page': '页面',
+    'engine.inspector.appNav.type.dashboard': '仪表盘',
+    'engine.inspector.appNav.type.report': '报表',
+    'engine.inspector.appNav.type.url': '链接(URL)',
+    'engine.inspector.appNav.type.group': '分组',
+    'engine.inspector.appNav.object': '对象',
+    'engine.inspector.appNav.targetMode': '落点',
+    'engine.inspector.appNav.mode.default': '默认视图(工作台)',
+    'engine.inspector.appNav.mode.view': '具名视图',
+    'engine.inspector.appNav.mode.record': '记录深链',
+    'engine.inspector.appNav.mode.filters': '参数化切面(/data)',
+    'engine.inspector.appNav.view': '视图',
+    'engine.inspector.appNav.recordId': '记录 ID',
+    'engine.inspector.appNav.recordIdHint': '支持 {current_user_id} 与 {current_org_id} 模板变量。',
+    'engine.inspector.appNav.recordMode': '打开方式',
+    'engine.inspector.appNav.recordModeView': '查看',
+    'engine.inspector.appNav.recordModeEdit': '编辑',
+    'engine.inspector.appNav.filters': 'URL 过滤条件',
+    'engine.inspector.appNav.filtersField': '字段',
+    'engine.inspector.appNav.filtersValue': '值',
+    'engine.inspector.appNav.filtersAdd': '添加条件',
+    'engine.inspector.appNav.filtersRemove': '移除条件',
+    'engine.inspector.appNav.filtersHint': '一次性切面由 URL 承载——当它值得沉淀复用时,请改建具名视图。',
+    'engine.inspector.appNav.url': '链接地址',
+    'engine.inspector.appNav.urlTarget': '打开位置',
+    'engine.inspector.appNav.urlTargetSelf': '当前标签页',
+    'engine.inspector.appNav.urlTargetBlank': '新标签页',
+    'engine.inspector.appNav.preview': '运行期落点',
     // View column inspector
     'engine.inspector.viewColumn.kind': '列',
     'engine.inspector.viewColumn.close': '关闭列',
@@ -1241,9 +1548,10 @@ const ENGINE_STRINGS_ZH = {
     'engine.packages.col.version': '版本',
     'engine.packages.col.scope': '范围',
     'engine.packages.col.status': '状态',
-    'engine.packages.scope.project': '项目',
+    'engine.packages.scope.project': '只读 · 代码包',
     'engine.packages.scope.system': '系统',
     'engine.packages.scope.cloud': '云端',
+    'engine.packages.scope.writable': '可写',
     'engine.packages.status.enabled': '已启用',
     'engine.packages.status.disabled': '已禁用',
     'engine.packages.import.invalidJson': '所选文件不是有效 JSON。',
@@ -1498,6 +1806,234 @@ const ENGINE_STRINGS_ZH = {
     // AI assistant entry points
     'designer.canvas.askAi': '问 AI',
     'designer.canvas.askAiGenerate': '用 AI 生成字段',
+    // ── StudioDesignSurface (ADR-0080 WYSIWYG design surface) ──────────────
+    // Shared chrome
+    'engine.studio.cancel': '取消',
+    'engine.studio.create': '创建',
+    'engine.studio.createDraft': '创建(存为草稿)',
+    'engine.studio.saveDraft': '保存草稿',
+    'engine.studio.data.savedDraft': '对象「{label}」已存为草稿',
+    'engine.studio.data.lastSaved': '已于 {time} 保存',
+    'engine.studio.publish': '发布',
+    'engine.studio.loading': '加载中…',
+    'engine.studio.loadFailed': '加载失败',
+    'engine.studio.unpublishedDraft': '未发布草稿',
+    'engine.studio.unpublished': '未发布',
+    'engine.studio.new': '新建',
+    'engine.studio.edit': '编辑',
+    'engine.studio.done': '完成',
+    'engine.studio.close': '关闭',
+    'engine.studio.deselect': '取消选择',
+    'engine.studio.home': '返回主页',
+    // Pillar tab labels
+    'engine.studio.pillar.data': '数据',
+    'engine.studio.pillar.automations': '自动化',
+    'engine.studio.pillar.interfaces': '界面',
+    'engine.studio.pillar.access': '权限',
+    // Header · package-level publish + app bridge
+    'engine.studio.changes': '变更',
+    'engine.studio.publishTitle': '一次性确认并发布全部待发布草稿(整包 · 一次原子发布)',
+    'engine.studio.publishNoneTitle': '没有待发布的草稿',
+    'engine.studio.publishedAll': '已发布本软件包的全部草稿(一次原子发布)',
+    'engine.studio.app.open': '打开应用',
+    'engine.studio.app.openTitle': '打开应用「{label}」(发布后的前端界面)',
+    'engine.studio.app.create': '创建应用',
+    'engine.studio.app.noneTitle': '这个软件包还没有应用(前端界面)— 创建一个',
+    'engine.studio.app.willOpenAfterPublish': '发布后这里会变成「打开应用」',
+    'engine.studio.app.pending': '应用「{label}」待发布',
+    'engine.studio.app.namePlaceholder': '应用名称(如:订单中心)',
+    'engine.studio.app.idPlaceholder': '标识符(如:orders_app)',
+    'engine.studio.app.savedDraft': '应用「{label}」已存为草稿 — 发布后即可打开',
+    // Package switcher
+    'engine.studio.pkg.switchTitle': '切换 / 新建软件包',
+    'engine.studio.pkg.readonly': '只读',
+    'engine.studio.pkg.readonlyHint': '只读软件包 — 请切换或新建可写软件包后再编辑。',
+    'engine.studio.app.scaffoldNav': '将本包的对象添加为菜单项',
+    'engine.studio.landing.title': '应用构建',
+    'engine.studio.landing.description': '在一个可写软件包里设计对象、表单、自动化与界面;编辑存为草稿,整包一次发布。源码加载的软件包为只读(仅可浏览)。',
+    'engine.studio.landing.mineHeading': '我的软件包(可写)',
+    'engine.studio.landing.noneWritable': '还没有可写软件包 — 新建一个开始。',
+    'engine.studio.landing.dup': '复制',
+    'engine.studio.landing.dupTitle': '复制这个软件包为新的可写副本(类似 duplicate base)',
+    'engine.studio.landing.dupDefaultName': '{name} 副本',
+    'engine.studio.landing.dupNamePlaceholder': '副本名称',
+    'engine.studio.landing.dupIdPlaceholder': '副本包 ID',
+    'engine.studio.landing.dupGo': '复制并进入构建器',
+    'engine.studio.landing.dupCreated': '已复制为可写软件包「{name}」',
+    'engine.studio.landing.createGo': '创建并开始构建',
+    'engine.studio.landing.installedHeading': '已安装(只读 · 可浏览)',
+    'engine.studio.designer.search': '搜索…',
+    'engine.studio.designer.select': '请选择…',
+    'engine.studio.designer.pickDate': '选择日期…',
+    'engine.studio.designer.fieldAria': '{label} — 点选改属性,拖动排序',
+    'engine.studio.designer.groupUp': '上移分组',
+    'engine.studio.designer.groupDown': '下移分组',
+    'engine.studio.designer.groupDelete': '删除分组',
+    'engine.studio.designer.groupDeleteTitle': '删除分组(字段归为未分组)',
+    'engine.studio.designer.dropHere': '拖字段到这里',
+    'engine.studio.designer.ungrouped': '未分组',
+    'engine.studio.designer.newGroup': '新分组',
+    'engine.studio.designer.hint': '拖动字段排序 / 拖到其它分组 · 点选字段改属性',
+    'engine.studio.designer.addGroup': '添加分组',
+    'engine.studio.rules.title': '验证规则',
+    'engine.studio.rules.none': '还没有验证规则。',
+    'engine.studio.rules.explain': '规则在保存记录时执行:条件为真 ⇒ 拒绝保存并提示消息。',
+    'engine.studio.rules.noMessage': '(无消息)',
+    'engine.studio.rules.pick': '选择左侧的规则进行编辑,或点「新增」创建一条。',
+    'engine.studio.rules.structured': '「{type}」类型的规则带有结构化配置(状态机转移表 / 格式约束等),暂不支持在此编辑 —— 请在代码包中维护。消息:{message}',
+    'engine.studio.rules.none2': '(无)',
+    'engine.studio.rules.deleteRule': '删除规则',
+    'engine.studio.rules.nameLabel': '规则名(snake_case,唯一)',
+    'engine.studio.rules.messageLabel': '错误消息(校验失败时展示给用户)',
+    'engine.studio.rules.messagePlaceholder': '例如:完成日期在状态为已完成时必填',
+    'engine.studio.rules.celPre': '失败条件(CEL)—— 条件为 ',
+    'engine.studio.rules.celTrue': '真',
+    'engine.studio.rules.celMid': ' 时,拒绝保存并显示上面的消息;新规则默认 ',
+    'engine.studio.rules.celPost': ' (永不触发),请改为真实条件。',
+    'engine.studio.rules.severity': '严重度',
+    'engine.studio.rules.severityError': 'error(拒绝保存)',
+    'engine.studio.rules.enabled': '启用',
+    'engine.studio.rules.delete': '删除',
+    'engine.studio.settings.basics': '基础信息',
+    'engine.studio.settings.noInspector': '未注册对象默认检查器。',
+    'engine.studio.settings.semanticRoles': '语义角色',
+    'engine.studio.settings.semanticHint': '跨表单 / 列表 / 详情统一生效(ADR-0085)',
+    'engine.studio.settings.nameField': '记录名称字段(nameField)—— 标题、链接、引用处显示的字段',
+    'engine.studio.settings.autoDerive': '(自动推导)',
+    'engine.studio.settings.stageField': '生命周期字段(stageField)—— 详情页顶部进度条按它的选项渲染',
+    'engine.studio.settings.autoDetect': '(自动探测 status/stage 等字段名)',
+    'engine.studio.settings.stageNone': '无 —— 这个对象没有线性流程,不显示进度条',
+    'engine.studio.settings.highlightFields': '重点字段(highlightFields)—— 默认列表列、卡片、详情顶栏取前 4;顺序即展示顺序',
+    'engine.studio.settings.removeField': '移除 {field}',
+    'engine.studio.settings.addFieldOption': '+ 添加字段…',
+    'engine.studio.settings.undeclared': '(未声明 —— 各处按启发式自动挑选)',
+    'engine.studio.pkg.writable': '可写',
+    'engine.studio.pkg.heading': '软件包(应用)',
+    'engine.studio.pkg.none': '暂无应用软件包',
+    'engine.studio.pkg.namePlaceholder': '名称(如:维修中心)',
+    'engine.studio.pkg.idPlaceholder': '包 ID(如:com.example.repairs)',
+    'engine.studio.pkg.idStrippedNotice': '已移除不支持的字符——仅允许小写字母、数字、点、连字符和下划线',
+    'engine.studio.pkg.idFormatHint': '请使用带至少一个点的反向域名标识,如 com.example.myapp',
+    'engine.studio.pkg.idFromNameUnavailable': '无法从该名称生成标识,请在下方手动输入(如 com.example.myapp)',
+    'engine.studio.pkg.createWritable': '创建可写软件包',
+    'engine.studio.pkg.new': '新建软件包(可写 base)',
+    'engine.studio.pkg.created': '软件包 {name} 已创建(可写)',
+    // Nav item inspector (Interfaces pillar)
+    'engine.studio.nav.selectItem': '在左侧选择一个菜单项。',
+    'engine.studio.nav.label': '标签',
+    'engine.studio.nav.labelPlaceholder': '如:职位',
+    'engine.studio.nav.linkObject': '链接到对象',
+    'engine.studio.nav.chooseObject': '— 选择对象 —',
+    'engine.studio.nav.boundHint': '这个菜单项会打开该对象的记录列表。',
+    'engine.studio.nav.unboundHint': '选择一个对象,菜单项将打开它的记录列表。',
+    'engine.studio.nav.noObjects': '这个软件包还没有对象 — 先到 Data 支柱创建。',
+    // Interfaces pillar
+    'engine.studio.if.pickLeft': '从左侧选择一个菜单项',
+    'engine.studio.if.navHeading': '{app} · 导航',
+    'engine.studio.if.editNavTitle': '编辑导航(拖拽排序 / 重命名 / 增删)',
+    'engine.studio.if.doneEditTitle': '完成编辑',
+    'engine.studio.if.noApp': '这个软件包还没有应用。',
+    'engine.studio.if.noNavItems': '还没有导航项 —(点上方「编辑」添加)',
+    'engine.studio.if.previewIsRuntime': '预览即运行 · 同一渲染器',
+    'engine.studio.if.noAppTitle': '这个软件包还没有应用',
+    'engine.studio.if.noAppHint': '创建一个应用来设计它的导航与界面。',
+    'engine.studio.if.readonlyPreview': '{type} 暂用只读预览,设计能力建设中。',
+    'engine.studio.if.editHint': '点选积木 → 右侧直接改 · 改完「保存草稿」→「发布」',
+    'engine.studio.if.objectHintPre': '运行态列表预览 · 改字段 / 结构请到 ',
+    'engine.studio.if.objectHintPost': ' 支柱',
+    'engine.studio.inspector.props': '属性',
+    'engine.studio.inspector.emptyLine1': '在画布里点选一个积木,',
+    'engine.studio.inspector.emptyLine2': '它的属性会在这里直接编辑。',
+    // Data pillar
+    'engine.studio.data.newFieldLabel': '新字段',
+    'engine.studio.data.nameFieldLabel': '名称',
+    'engine.studio.data.idExists': '标识符 "{name}" 已存在',
+    'engine.studio.data.fieldCount': '{count} 字段',
+    'engine.studio.data.pickObject': '选择一个对象',
+    'engine.studio.data.objects': '对象',
+    'engine.studio.data.searchObjects': '搜索对象…',
+    'engine.studio.data.noObjects': '还没有对象 — 在下方新建一个开始',
+    'engine.studio.data.labelPlaceholder': '显示名(如:报修工单)',
+    'engine.studio.data.idPlaceholder': '标识符(如:repair_ticket)',
+    'engine.studio.data.newObject': '新建对象',
+    'engine.studio.data.readOnlyPackage': '此包为只读——请切换到或新建一个可写的包后再添加对象',
+    'engine.studio.data.firstObjectTitle': '从第一个对象开始',
+    'engine.studio.data.firstObjectHint': '对象是应用的数据基座(如「订单」「客户」)。在左下角输入显示名与标识符即可创建;之后为它设计字段、表单与自动化,最后一次发布。',
+    'engine.studio.data.tab.records': '记录',
+    'engine.studio.data.tab.form': '表单',
+    'engine.studio.data.tab.rules': '验证',
+    'engine.studio.data.tab.settings': '设置',
+    'engine.studio.data.badge.grid': '运行态列表 · 同一渲染器',
+    'engine.studio.data.badge.rules': '验证规则 · 草稿',
+    'engine.studio.data.badge.settings': '对象设置 · 草稿',
+    'engine.studio.data.badge.formLayout': '表单设计 · 草稿',
+    'engine.studio.data.badge.formPreview': '运行态表单 · 已发布定义',
+    'engine.studio.data.addFieldTitle': '添加一个字段(随后在右侧设置类型与属性)',
+    'engine.studio.data.addField': '添加字段',
+    'engine.studio.data.editFieldProps': '编辑字段属性',
+    'engine.studio.data.draftObjectTitle': '未发布的新对象',
+    'engine.studio.data.draftObjectHint': '「记录」网格查询真实数据,而这个对象发布前还没有数据表。请先在「表单 · 布局」里设计字段与分组,然后点顶栏「发布」— 发布后这里就是它的实时数据网格。',
+    'engine.studio.data.goDesignFields': '去「表单 · 布局」设计字段',
+    'engine.studio.data.gridHint': '列头「+」加字段 · 笔形改属性 · 拖列头重排 · 改完「保存草稿」→「发布」',
+    'engine.studio.data.form.layout': '布局',
+    'engine.studio.data.form.preview': '预览',
+    'engine.studio.data.form.layoutBadge': '布局设计器 · 草稿(含未发布改动)',
+    'engine.studio.data.form.previewBadge': '运行态表单 · 已发布定义',
+    'engine.studio.data.form.previewWarn': '有未发布改动 — 此预览为发布前(已发布)的效果;草稿确认用「布局」,看发布后效果请先点顶栏「发布」',
+    'engine.studio.data.form.noPublishedTitle': '尚无已发布定义',
+    'engine.studio.data.form.noPublishedHint': '「预览」渲染已发布的运行态表单,而这个对象还未发布。在「布局」里确认草稿,点顶栏「发布」后即可预览。',
+    'engine.studio.data.formHint': '点选任意字段 → 右侧改属性 · 「添加字段」加字段 · 改完「保存草稿」→「发布」',
+    'engine.studio.data.fieldProps': '字段属性',
+    // Automations pillar
+    'engine.studio.auto.nodeStart': '开始',
+    'engine.studio.auto.nodeEnd': '结束',
+    'engine.studio.auto.savedDraft': '自动化「{label}」已存为草稿',
+    'engine.studio.auto.defaultOff': '默认 OFF · 审阅后再启用',
+    'engine.studio.auto.heading': '自动化 · flow',
+    'engine.studio.auto.on': '已启用',
+    'engine.studio.auto.off': '已停用',
+    'engine.studio.auto.offTitle': '已停用 — 不会运行',
+    'engine.studio.auto.onBound': '已启用 · 已绑定触发器',
+    'engine.studio.auto.onUnbound': '已启用 · 无触发器(手动运行)',
+    'engine.studio.auto.enabled': '已启用',
+    'engine.studio.auto.disabled': '已停用',
+    'engine.studio.auto.enableTitle': '启用此自动化(发布后生效)',
+    'engine.studio.auto.disableTitle': '停用此自动化(发布后生效)',
+    'engine.studio.auto.enabledToast': '已设为启用 — 发布后生效',
+    'engine.studio.auto.disabledToast': '已设为停用 — 发布后生效',
+    'engine.studio.auto.newTitle': '新建自动化',
+    'engine.studio.auto.none': '还没有自动化 — 点「新建」开始',
+    'engine.studio.auto.namePlaceholder': '名称(如:录用通知)',
+    'engine.studio.auto.idPlaceholder': '标识符(如:offer_notice)',
+    'engine.studio.auto.canvasHint': '可视化编排 · 点选节点配置',
+    'engine.studio.auto.pick': '选择一个自动化',
+    'engine.studio.auto.editHint': '点选节点 → 右侧配置 · 改完「保存草稿」→「发布」',
+    'engine.studio.auto.config': '配置',
+    'engine.studio.auto.emptyLine1': '在画布里点选一个节点,',
+    'engine.studio.auto.emptyLine2': '它的配置会在这里显示。',
+    // Access pillar
+    'engine.studio.access.created': '权限集「{label}」已创建',
+    'engine.studio.access.title': '权限矩阵',
+    'engine.studio.access.subtitle': '对象 × CRUD · 字段级读写',
+    'engine.studio.access.bannerTitle': '此矩阵仅列出本包声明的对象,「Save」只合并本包切片 —— 其他包贡献的授权原样保留。编辑保存为软件包草稿,点击顶栏「发布」后随整个包一起生效(与数据、界面一致)。',
+    'engine.studio.access.banner': '仅本包对象 · 保存为草稿',
+    'engine.studio.access.heading': '权限集 / Profile',
+    'engine.studio.access.search': '搜索权限…',
+    'engine.studio.access.none': '还没有权限集 — 在下方新建一个',
+    'engine.studio.access.labelPlaceholder': '显示名(如:销售权限)',
+    'engine.studio.access.idPlaceholder': '标识符(如:sales_perms)',
+    'engine.studio.access.new': '新建权限集',
+    'engine.studio.access.emptyMain': '新建一个权限集开始配置',
+    'engine.studio.access.pick': '选择一个权限集',
+    // ── AppNavCanvas (nav-tree editor, used by Studio + AppPreview) ─────────
+    'engine.appNav.heading': '导航',
+    'engine.appNav.addItem': '添加导航项',
+    'engine.appNav.removeItem': '删除导航项',
+    'engine.appNav.empty': '还没有导航项 — 点「添加导航项」开始',
+    'engine.appNav.emptyReadonly': '还没有顶层导航项',
+    'engine.appNav.newItem': '新菜单项',
+    'engine.appNav.itemOne': '项',
+    'engine.appNav.itemOther': '项',
 };
 function pickTable(locale) {
     const lower = (locale ?? '').toLowerCase();
@@ -1569,3 +2105,18 @@ export function detectLocale() {
         return 'zh-CN';
     return 'en-US';
 }
+/**
+ * React hook — the Studio/metadata-admin locale derived from the app's ACTIVE
+ * i18n language, collapsed to one of the two locales this catalog ships.
+ *
+ * Prefer this over {@link detectLocale} in components: `detectLocale()` reads
+ * `navigator.language`, which never changes when the user switches languages
+ * in-app via the LocaleSwitcher (that only moves the i18next instance). This
+ * follows the live `useObjectTranslation().language`, so the Studio pillars
+ * re-render in lock-step with the console locale — the same source the rest of
+ * the app (Home, forms, list views) renders from.
+ */
+export function useMetadataLocale() {
+    const { language } = useObjectTranslation();
+    return /^zh/i.test(language) ? 'zh-CN' : 'en-US';
+}