@object-ui/app-shell 11.4.0 → 11.5.0

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

@@ -367,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',
@@ -834,6 +862,8 @@ const ENGINE_STRINGS_EN = {
     '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',
@@ -867,11 +897,74 @@ const ENGINE_STRINGS_EN = {
     // 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)',
@@ -913,6 +1006,7 @@ const ENGINE_STRINGS_EN = {
     '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',
@@ -946,6 +1040,17 @@ const ENGINE_STRINGS_EN = {
     '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)',
@@ -1214,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': '关闭列',
@@ -1679,6 +1812,8 @@ const ENGINE_STRINGS_ZH = {
     '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': '加载失败',
@@ -1712,11 +1847,74 @@ const ENGINE_STRINGS_ZH = {
     // 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} 已创建(可写)',
@@ -1758,6 +1956,7 @@ const ENGINE_STRINGS_ZH = {
     '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': '记录',
@@ -1791,6 +1990,17 @@ const ENGINE_STRINGS_ZH = {
     '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': '名称(如:录用通知)',

package/dist/views/metadata-admin/inspectors/AppNavInspector.d.ts

@@ -6,11 +6,18 @@
  * `<rootKey>[i]` for top-level items, `<rootKey>[i].children[j]` for
  * nested. This inspector walks the same path to read/write.
  *
- * For simplicity v1 only edits the leaf node (label / path / icon /
- * kind). Reparenting and re-ordering happen elsewhere (drag handles,
- * the top-level SchemaForm).
+ * Target editing is contract-first (#2245): a `type` selector plus
+ * per-type typed-target pickers replacing the old off-spec `path` /
+ * `kind` free-text fields the runtime never read. `object` items expose
+ * the four landing modes matching resolveHref precedence (default /
+ * named view / record deep-link / filters slice on `/data`, ADR-0055);
+ * the mode is derived from field presence — never persisted — and every
+ * edit clears the other modes' fields plus all legacy keys, so touching
+ * a legacy item migrates it to spec shape. A live href preview renders
+ * the REAL runtime landing via resolveHref, making "declared =
+ * enforced" visible while editing.
  */
 import * as React from 'react';
 import type { MetadataInspectorProps } from '../inspector-registry';
-export declare function AppNavInspector({ selection, draft, onPatch, onClearSelection, onSelectionChange, locale, readOnly }: MetadataInspectorProps): React.JSX.Element;
+export declare function AppNavInspector({ selection, draft, name, onPatch, onClearSelection, onSelectionChange, locale, readOnly }: MetadataInspectorProps): React.JSX.Element;
 export declare const APP_NAV_ROOT_KEYS: string[];

package/dist/views/metadata-admin/inspectors/AppNavInspector.js

@@ -1,8 +1,34 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+// Copyright (c) 2025 ObjectStack. Licensed under the Apache-2.0 license.
+/**
+ * AppNavInspector — scoped editor for the selected app navigation item.
+ *
+ * Apps accept nav under several keys (nav / navigation / tabs / items
+ * / menu). The preview emits selection id as a dotted path
+ * `<rootKey>[i]` for top-level items, `<rootKey>[i].children[j]` for
+ * nested. This inspector walks the same path to read/write.
+ *
+ * Target editing is contract-first (#2245): a `type` selector plus
+ * per-type typed-target pickers replacing the old off-spec `path` /
+ * `kind` free-text fields the runtime never read. `object` items expose
+ * the four landing modes matching resolveHref precedence (default /
+ * named view / record deep-link / filters slice on `/data`, ADR-0055);
+ * the mode is derived from field presence — never persisted — and every
+ * edit clears the other modes' fields plus all legacy keys, so touching
+ * a legacy item migrates it to spec shape. A live href preview renders
+ * the REAL runtime landing via resolveHref, making "declared =
+ * enforced" visible while editing.
+ */
+import * as React from 'react';
+import { resolveHref } from '@object-ui/layout';
+import { Plus, X } from 'lucide-react';
 import { t } from '../i18n';
+import { useMetadataClient } from '../useMetadata';
+import { useObjectFields } from '../previews/useObjectFields';
 import { InspectorShell, InspectorReorderButtons, InspectorTextField, InspectorSelectField, InspectorRemoveButton, InspectorEmptyState, spliceArray, moveArray, } from './_shared';
+import { InspectorComboField } from './InspectorComboField';
+import { NAV_ITEM_TYPES, NAV_TYPE_TARGETS, OBJECT_TARGET_MODES, OBJECT_MODE_FIELDS, inferNavItemType, deriveObjectTargetMode, clearedTargetPatch, ensureNavId, } from './nav-target';
 const ROOT_KEYS = ['nav', 'navigation', 'tabs', 'items', 'menu'];
-const KINDS = ['object', 'page', 'dashboard', 'report', 'link', 'group'];
 /** Parse "nav[0].children[2]" → [{key:'nav', index:0}, {key:'children', index:2}]. */
 function parsePath(id) {
     const segs = id.split('.');
@@ -82,16 +108,111 @@ function writeSiblings(draft, hops, nextSiblings) {
     arr[parentHop.index] = parentCopy;
     return { [rootKey]: root };
 }
-export function AppNavInspector({ selection, draft, onPatch, onClearSelection, onSelectionChange, locale, readOnly }) {
+/** Fetch a metadata type's items as combobox options (name → label (name)). */
+function useMetadataOptions(type) {
+    const client = useMetadataClient();
+    const [state, setState] = React.useState({
+        options: [],
+        loading: !!type,
+    });
+    React.useEffect(() => {
+        if (!type) {
+            setState({ options: [], loading: false });
+            return;
+        }
+        let cancelled = false;
+        setState((s) => ({ ...s, loading: true }));
+        client
+            .list(type)
+            .then((rows) => {
+            if (cancelled)
+                return;
+            const options = (Array.isArray(rows) ? rows : [])
+                .filter((r) => r && typeof r.name === 'string' && r.name)
+                .map((r) => ({
+                value: String(r.name),
+                label: typeof r.label === 'string' && r.label && r.label !== r.name ? `${r.label} (${r.name})` : String(r.name),
+            }));
+            setState({ options, loading: false });
+        })
+            .catch(() => {
+            if (!cancelled)
+                setState({ options: [], loading: false });
+        });
+        return () => {
+            cancelled = true;
+        };
+    }, [client, type]);
+    return state;
+}
+/** Preview template context that keeps template vars VISIBLE in the href. */
+const PREVIEW_CTX = {
+    currentUserId: '{current_user_id}',
+    currentOrgId: '{current_org_id}',
+};
+/** Key/value rows editor for the `filters` landing mode (ADR-0055). */
+function FiltersEditor({ objectName, filters, onCommit, disabled, locale, }) {
+    const { fields } = useObjectFields(objectName || undefined);
+    const fieldOptions = React.useMemo(() => fields.map((f) => ({ value: f.name, label: f.label && f.label !== f.name ? `${f.label} (${f.name})` : f.name })), [fields]);
+    const entries = Object.entries(filters);
+    const update = (index, key, value) => {
+        const next = entries.slice();
+        next[index] = [key, value];
+        onCommit(Object.fromEntries(next.filter(([k]) => k !== '')));
+    };
+    const remove = (index) => {
+        const next = entries.slice();
+        next.splice(index, 1);
+        onCommit(Object.fromEntries(next));
+    };
+    return (_jsxs("div", { className: "space-y-1.5", children: [_jsx("div", { className: "text-[11px] font-medium text-muted-foreground", children: t('engine.inspector.appNav.filters', locale) }), entries.map(([field, value], i) => (_jsxs("div", { className: "flex items-center gap-1", children: [_jsx("div", { className: "min-w-0 flex-1", children: _jsx(InspectorComboField, { value: field, onCommit: (v) => update(i, v, value), options: fieldOptions, placeholder: t('engine.inspector.appNav.filtersField', locale), disabled: disabled, mono: true }) }), _jsx("span", { className: "text-xs text-muted-foreground", children: "=" }), _jsx("input", { value: value, onChange: (e) => update(i, field, e.target.value), placeholder: t('engine.inspector.appNav.filtersValue', locale), disabled: disabled, className: "h-7 w-0 min-w-0 flex-1 rounded border bg-background px-2 font-mono text-xs", "data-testid": `nav-filter-value-${field || 'new'}` }), _jsx("button", { type: "button", onClick: () => remove(i), disabled: disabled, className: "rounded p-1 text-muted-foreground hover:bg-muted", "aria-label": t('engine.inspector.appNav.filtersRemove', locale), "data-testid": `nav-filter-remove-${field || 'new'}`, children: _jsx(X, { className: "h-3 w-3" }) })] }, `${field}-${i}`))), _jsxs("button", { type: "button", onClick: () => onCommit({ ...filters, '': '' }), disabled: disabled || Object.prototype.hasOwnProperty.call(filters, ''), className: "inline-flex items-center gap-1 rounded border px-2 py-1 text-[11px] text-muted-foreground hover:bg-muted", "data-testid": "nav-filter-add", children: [_jsx(Plus, { className: "h-3 w-3" }), t('engine.inspector.appNav.filtersAdd', locale)] }), _jsx("p", { className: "text-[11px] text-muted-foreground", children: t('engine.inspector.appNav.filtersHint', locale) })] }));
+}
+export function AppNavInspector({ selection, draft, name, onPatch, onClearSelection, onSelectionChange, locale, readOnly }) {
     const hops = parsePath(selection.id);
     const { node, parent, index } = hops ? readAt(draft, hops) : { node: null, parent: [], index: -1 };
+    const navType = node ? inferNavItemType(node) : null;
+    const objectMode = node ? deriveObjectTargetMode(node) : 'default';
+    const objectName = String(node?.objectName ?? node?.object ?? '');
+    // Hooks run unconditionally (before the not-found early return) to keep
+    // the Rules of Hooks satisfied; `undefined` type disables the fetch.
+    const objectOptions = useMetadataOptions(navType === 'object' ? 'object' : undefined);
+    const targetMeta = navType && navType !== 'object' ? NAV_TYPE_TARGETS[navType].metaType : undefined;
+    const targetOptions = useMetadataOptions(targetMeta);
+    const viewOptionsRaw = useMetadataOptions(navType === 'object' && objectMode === 'view' ? 'view' : undefined);
+    // Views are named `<object>.<key>` (MetadataProvider) — scope the picker
+    // to the bound object instead of offering the whole workspace's views.
+    const viewOptions = React.useMemo(() => objectName
+        ? viewOptionsRaw.options.filter((o) => o.value.startsWith(`${objectName}.`) || !o.value.includes('.'))
+        : viewOptionsRaw.options, [viewOptionsRaw.options, objectName]);
     if (!hops || !node) {
         return (_jsx(InspectorShell, { kindLabel: t('engine.inspector.appNav.kind', locale), title: selection.label ?? selection.id, onClose: onClearSelection, closeLabel: t('engine.inspector.appNav.close', locale), children: _jsx(InspectorEmptyState, { message: selection.id }) }));
     }
-    const labelOf = node.label ?? node.title ?? node.name ?? node.path ?? selection.id;
-    const path = node.path ?? node.href ?? node.route ?? '';
+    const labelOf = node.label ?? node.title ?? node.name ?? selection.id;
+    /**
+     * Every write enforces the spec invariants: snake_case `id`, an explicit
+     * `type`, and the caller-provided field clears — editing a legacy item
+     * IS its migration to spec shape.
+     */
     const patch = (updates) => {
-        onPatch(writeAt(draft, hops, { ...node, ...updates }));
+        const nextType = (updates.type ?? node.type ?? navType ?? undefined);
+        onPatch(writeAt(draft, hops, {
+            ...node,
+            id: ensureNavId(node, parent),
+            ...(nextType ? { type: nextType } : {}),
+            ...updates,
+        }));
+    };
+    const switchType = (nextType) => {
+        const targetKey = NAV_TYPE_TARGETS[nextType].targetKey;
+        const keep = nextType === 'object' ? OBJECT_MODE_FIELDS.default : targetKey ? [targetKey] : [];
+        patch({ type: nextType, ...clearedTargetPatch(keep) });
+    };
+    const switchObjectMode = (mode) => {
+        const cleared = clearedTargetPatch(OBJECT_MODE_FIELDS[mode]);
+        if (mode === 'filters')
+            patch({ ...cleared, objectName, filters: node.filters ?? {} });
+        else
+            patch({ ...cleared, objectName });
     };
     const remove = () => {
         onPatch(writeAt(draft, hops, null));
@@ -105,6 +226,19 @@ export function AppNavInspector({ selection, draft, onPatch, onClearSelection, o
         const newId = prefix ? `${prefix}.${leafKey}[${to}]` : `${leafKey}[${to}]`;
         onSelectionChange?.({ kind: 'nav', id: newId, label: String(labelOf) });
     };
-    return (_jsxs(InspectorShell, { kindLabel: t('engine.inspector.appNav.kind', locale), title: String(labelOf), onClose: onClearSelection, closeLabel: t('engine.inspector.appNav.close', locale), headerActions: _jsx(InspectorReorderButtons, { index: index, total: parent.length, onMove: move, upLabel: t('engine.inspector.reorder.up', locale), downLabel: t('engine.inspector.reorder.down', locale), disabled: readOnly }), footer: _jsx(InspectorRemoveButton, { label: t('engine.inspector.appNav.remove', locale), onClick: remove, disabled: readOnly }), children: [_jsx(InspectorTextField, { label: t('engine.inspector.appNav.label', locale), value: String(node.label ?? node.title ?? node.name ?? ''), onCommit: (v) => patch({ label: v }), disabled: readOnly }), _jsx(InspectorTextField, { label: t('engine.inspector.appNav.path', locale), value: String(path), onCommit: (v) => patch({ path: v }), disabled: readOnly, mono: true }), _jsx(InspectorTextField, { label: t('engine.inspector.appNav.icon', locale), value: String(node.icon ?? ''), onCommit: (v) => patch({ icon: v }), disabled: readOnly }), _jsx(InspectorSelectField, { label: t('engine.inspector.appNav.kindField', locale), value: node.kind, options: KINDS.map((v) => ({ value: v, label: v })), onCommit: (v) => patch({ kind: v }), disabled: readOnly })] }));
+    // Live landing preview — the REAL runtime URL for the current config
+    // (resolveHref is the single source of truth), template vars kept
+    // visible. `#` reads as "no target yet".
+    const previewHref = navType && navType !== 'group'
+        ? resolveHref({ ...node, type: navType }, `/apps/${name || 'app'}`, PREVIEW_CTX).href
+        : null;
+    const target = NAV_TYPE_TARGETS[navType ?? 'group'];
+    return (_jsxs(InspectorShell, { kindLabel: t('engine.inspector.appNav.kind', locale), title: String(labelOf), onClose: onClearSelection, closeLabel: t('engine.inspector.appNav.close', locale), headerActions: _jsx(InspectorReorderButtons, { index: index, total: parent.length, onMove: move, upLabel: t('engine.inspector.reorder.up', locale), downLabel: t('engine.inspector.reorder.down', locale), disabled: readOnly }), footer: _jsx(InspectorRemoveButton, { label: t('engine.inspector.appNav.remove', locale), onClick: remove, disabled: readOnly }), children: [_jsx(InspectorTextField, { label: t('engine.inspector.appNav.label', locale), value: String(node.label ?? node.title ?? node.name ?? ''), onCommit: (v) => patch({ label: v }), disabled: readOnly }), _jsx(InspectorTextField, { label: t('engine.inspector.appNav.icon', locale), value: String(node.icon ?? ''), onCommit: (v) => patch({ icon: v }), disabled: readOnly }), _jsx(InspectorSelectField, { label: t('engine.inspector.appNav.typeField', locale), value: navType ?? '', options: NAV_ITEM_TYPES.map((v) => ({ value: v, label: t(`engine.inspector.appNav.type.${v}`, locale) })), onCommit: (v) => switchType(v), disabled: readOnly }), navType === 'object' && (_jsxs(_Fragment, { children: [_jsx(InspectorComboField, { label: t('engine.inspector.appNav.object', locale), value: objectName, options: objectOptions.options, loading: objectOptions.loading, onCommit: (v) => patch({ objectName: v, object: undefined }), disabled: readOnly, mono: true }), _jsx(InspectorSelectField, { label: t('engine.inspector.appNav.targetMode', locale), value: objectMode, options: OBJECT_TARGET_MODES.map((m) => ({ value: m, label: t(`engine.inspector.appNav.mode.${m}`, locale) })), onCommit: (v) => switchObjectMode(v), disabled: readOnly || !objectName }), objectMode === 'view' && (_jsx(InspectorComboField, { label: t('engine.inspector.appNav.view', locale), value: String(node.viewName ?? ''), options: viewOptions, loading: viewOptionsRaw.loading, onCommit: (v) => patch({ viewName: v }), disabled: readOnly, mono: true })), objectMode === 'record' && (_jsxs(_Fragment, { children: [_jsx(InspectorTextField, { label: t('engine.inspector.appNav.recordId', locale), value: String(node.recordId ?? ''), onCommit: (v) => patch({ recordId: v }), disabled: readOnly, mono: true }), _jsx("p", { className: "text-[11px] text-muted-foreground", children: t('engine.inspector.appNav.recordIdHint', locale) }), _jsx(InspectorSelectField, { label: t('engine.inspector.appNav.recordMode', locale), value: String(node.recordMode ?? 'view'), options: [
+                                    { value: 'view', label: t('engine.inspector.appNav.recordModeView', locale) },
+                                    { value: 'edit', label: t('engine.inspector.appNav.recordModeEdit', locale) },
+                                ], onCommit: (v) => patch({ recordMode: v }), disabled: readOnly })] })), objectMode === 'filters' && (_jsx(FiltersEditor, { objectName: objectName, filters: node.filters ?? {}, onCommit: (next) => patch({ filters: next }), disabled: readOnly, locale: locale }))] })), navType && navType !== 'object' && navType !== 'group' && target.targetKey && (target.metaType ? (_jsx(InspectorComboField, { label: t(`engine.inspector.appNav.type.${navType}`, locale), value: String(node[target.targetKey] ?? ''), options: targetOptions.options, loading: targetOptions.loading, onCommit: (v) => patch({ [target.targetKey]: v }), disabled: readOnly, mono: true })) : (_jsxs(_Fragment, { children: [_jsx(InspectorTextField, { label: t('engine.inspector.appNav.url', locale), value: String(node.url ?? node.href ?? ''), onCommit: (v) => patch({ url: v, href: undefined }), disabled: readOnly, mono: true }), _jsx(InspectorSelectField, { label: t('engine.inspector.appNav.urlTarget', locale), value: String(node.target ?? '_self'), options: [
+                            { value: '_self', label: t('engine.inspector.appNav.urlTargetSelf', locale) },
+                            { value: '_blank', label: t('engine.inspector.appNav.urlTargetBlank', locale) },
+                        ], onCommit: (v) => patch({ target: v }), disabled: readOnly })] }))), previewHref && (_jsxs("div", { className: "rounded border bg-muted/30 px-2 py-1.5", "data-testid": "nav-target-preview", children: [_jsx("div", { className: "text-[10px] font-medium uppercase tracking-wide text-muted-foreground", children: t('engine.inspector.appNav.preview', locale) }), _jsx("div", { className: "break-all font-mono text-[11px]", children: previewHref })] }))] }));
 }
 export const APP_NAV_ROOT_KEYS = ROOT_KEYS;

package/dist/views/metadata-admin/inspectors/FlowReferenceField.d.ts

@@ -33,10 +33,15 @@ export interface FlowReferenceContext {
     /** The node currently being edited — used to resolve sibling config keys. */
     node: Record<string, unknown> | null;
 }
+interface Option {
+    value: string;
+    label: string;
+}
 /** A concrete (non-polymorphic) reference resolution. */
 export interface ResolvedRef {
     kind: ReferenceKind;
     objectSource?: string;
+    connectorSource?: string;
 }
 /**
  * Resolve a (possibly polymorphic) reference spec to a concrete kind. For a
@@ -45,6 +50,14 @@ export interface ResolvedRef {
  * the caller then renders plain free text.
  */
 export declare function resolveRefKind(ref: FlowReferenceSpec | undefined, sibling: (key: string) => unknown): ResolvedRef | undefined;
+/**
+ * Resolve the chosen connector name for a `connector-action` reference — read
+ * from the sibling key on this node's `connectorConfig` block (default
+ * `connectorId`), which is where the connector picker writes it.
+ */
+export declare function resolveConnectorName(kind: ReferenceKind, connectorSource: string | undefined, ctx: FlowReferenceContext): string | undefined;
+/** A connector descriptor's action list → combobox options (exported for test). */
+export declare function connectorActionsToOptions(actions: unknown): Option[];
 export interface ReferenceComboboxProps {
     /** The resolved concrete reference, or undefined → plain free text. */
     resolved: ResolvedRef | undefined;
@@ -81,3 +94,4 @@ export interface FlowReferenceFieldProps {
  * `template` follows `actionType`).
  */
 export declare function FlowReferenceField({ field, value, onCommit, disabled, context }: FlowReferenceFieldProps): React.JSX.Element;
+export {};