@object-ui/app-shell 11.4.0 → 11.5.0

package/dist/views/RecordDetailView.js

@@ -7,11 +7,11 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  * the object field definitions.
  */
 import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
-import { useParams, useNavigate, useLocation, Link } from 'react-router-dom';
+import { useParams, useNavigate, useLocation, useSearchParams, Link } from 'react-router-dom';
 import { DetailView, RecordChatterPanel, buildDefaultPageSchema, deriveFieldGroupDetailSections, extractMentions } from '@object-ui/plugin-detail';
 import { Empty, EmptyTitle, EmptyDescription } from '@object-ui/components';
 import { useAuth, createAuthenticatedFetch } from '@object-ui/auth';
-import { ActionProvider, useObjectTranslation, useObjectLabel, usePageAssignment, RecordContextProvider, SchemaRenderer, DiscussionContextProvider, HighlightFieldsProvider, useGlobalUndo } from '@object-ui/react';
+import { ActionProvider, useObjectTranslation, useObjectLabel, usePageAssignment, RecordContextProvider, SchemaRenderer, DiscussionContextProvider, HighlightFieldsProvider, useGlobalUndo, useDataInvalidation, notifyDataChanged } from '@object-ui/react';
 import { buildExpandFields } from '@object-ui/core';
 import { toast } from 'sonner';
 import { useRecordPresence, PresenceAvatars } from '@object-ui/collaboration';
@@ -27,6 +27,8 @@ import { ActionParamDialog } from './ActionParamDialog';
 import { ActionResultDialog } from './ActionResultDialog';
 import { FlowRunner } from './FlowRunner';
 import { RelatedRecordActionsBridge } from './RelatedRecordActionsBridge';
+import { withPageTabsUrlSync } from '../utils/pageTabsUrlSync';
+import { RECORD_DETAIL_TAB_PARAM } from '../urlParams';
 import { resolveActionParams } from '../utils/resolveActionParams';
 import { useRecordBreadcrumbTitle } from '../context/NavigationContext';
 import { useRecordApprovals } from '../hooks/useRecordApprovals';
@@ -80,6 +82,20 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
     const { showDebug } = useMetadataInspector();
     const { user } = useAuth();
     const navigate = useNavigate();
+    // objectui#2257 — the active detail tab is URL-addressable (`?tab=`), so it
+    // survives the page subtree remounting (refreshKey-style save refreshes;
+    // dev-StrictMode URL churn). Written with `replace` — switching tabs must
+    // not stack history entries (Back would page through tabs and fight the
+    // overlay contract where Back closes `?form=…`).
+    const [tabSearchParams, setTabSearchParams] = useSearchParams();
+    const activeTabParam = tabSearchParams.get(RECORD_DETAIL_TAB_PARAM) ?? undefined;
+    const handleTabChange = useCallback((value) => {
+        const sp = new URLSearchParams(window.location.search);
+        if (sp.get(RECORD_DETAIL_TAB_PARAM) === value)
+            return;
+        sp.set(RECORD_DETAIL_TAB_PARAM, value);
+        setTabSearchParams(sp, { replace: true });
+    }, [setTabSearchParams]);
     const location = useLocation();
     const originFrom = location.state?.from;
     const { t } = useObjectTranslation();
@@ -89,7 +105,6 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
     const [isLoading, setIsLoading] = useState(true);
     const [feedItems, setFeedItems] = useState([]);
     const [mentionSuggestions, setMentionSuggestions] = useState([]);
-    const [actionRefreshKey, setActionRefreshKey] = useState(0);
     // Screen-flow runtime: a paused `screen`-node flow launched from a record action.
     const [screenFlow, setScreenFlow] = useState(null);
     const [childRelatedData, setChildRelatedData] = useState({});
@@ -105,6 +120,17 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
     // Navigation code passes `record.id || record._id` directly into the URL
     // without adding any prefix, so no stripping is needed.
     const pureRecordId = recordId;
+    // #2269 — "refresh data, don't rebuild UI": after an action/save succeeds
+    // we INVALIDATE this record on the bus instead of bumping a key that
+    // remounted the whole DetailView (destroying tab/scroll/inline-edit state).
+    // `recordInvalidationNonce` is the read side: it bumps when THIS record (or
+    // its object) is invalidated by anyone — the form overlay, an action, an
+    // undo, or any dataSource write via the MutationEvent bridge.
+    const recordInvalidationNonce = useDataInvalidation(objectName || undefined, pureRecordId || undefined);
+    const notifyRecordChanged = useCallback(() => {
+        if (objectName)
+            notifyDataChanged({ objectName, recordId: pureRecordId || undefined });
+    }, [objectName, pureRecordId]);
     // Record-scoped presence ("who else is viewing this record"). The default
     // PresenceProvider source is a no-op, so this resolves to `[]` until a
     // realtime transport (WebSocket-backed source) is wired in by the host
@@ -231,7 +257,9 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             cancelled = true;
             window.removeEventListener('objectui:record-changed', onChanged);
         };
-    }, [effectivePage, objectName, pureRecordId, dataSource, objectDef]);
+        // #2269: recordInvalidationNonce re-runs this fetch in place whenever the
+        // record (or its object) is invalidated on the bus.
+    }, [effectivePage, objectName, pureRecordId, dataSource, objectDef, recordInvalidationNonce]);
     // Schema-driven path: derive a human-readable record title from the
     // loaded `pageRecord` so favourites (record:*) and the breadcrumb show
     // e.g. "Acme Corporation" instead of the raw record id. The legacy
@@ -308,7 +336,13 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
     // "Undo" button (for `undoable` actions) restores the record's prior values.
     const undoCtl = useGlobalUndo({
         dataSource,
-        onUndo: () => { setActionRefreshKey(k => k + 1); toast.success('Change undone'); },
+        onUndo: (op) => {
+            if (op?.objectName)
+                notifyDataChanged({ objectName: op.objectName, recordId: op.recordId });
+            else
+                notifyRecordChanged();
+            toast.success('Change undone');
+        },
     });
     const toastHandler = useCallback((message, options) => {
         if (options?.type === 'error') {
@@ -393,12 +427,12 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             }
             const shouldRefresh = action.refreshAfter === true;
             if (shouldRefresh) {
-                setActionRefreshKey(k => k + 1);
+                notifyRecordChanged();
             }
             else if (undo) {
                 // Even when refreshAfter isn't set, reflect the change so the user sees
                 // it (and the subsequent Undo) on the open record.
-                setActionRefreshKey(k => k + 1);
+                notifyRecordChanged();
             }
             return { success: true, reload: shouldRefresh, undo };
         }
@@ -451,7 +485,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             }
             const shouldRefresh = action.refreshAfter !== false;
             if (shouldRefresh) {
-                setActionRefreshKey(k => k + 1);
+                notifyRecordChanged();
             }
             return { success: true, data: json?.data, reload: shouldRefresh };
         }
@@ -565,7 +599,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                     }
                 }
                 if (action.refreshAfter === true)
-                    setActionRefreshKey(k => k + 1);
+                    notifyRecordChanged();
                 return { success: true };
             }
             const obj = action.objectName || objectName || 'global';
@@ -593,14 +627,16 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                     }
                     catch { /* ignore */ }
                 }
-                // Surface the failure — this custom new-tab path bypasses
-                // ActionRunner's toast-on-error, so otherwise the user gets no feedback.
-                toast.error(errMsg);
+                // Don't toast here. This handler always runs through the ActionRunner
+                // (registered as the `script` handler on the ActionProvider below, which
+                // wires `onToast`), whose post-execution hook surfaces the returned
+                // `error` as one toast. Toasting again double-fired the message
+                // (e.g. RECORD_LOCKED appeared twice). Mirrors useConsoleActionRuntime.
                 return { success: false, error: errMsg };
             }
             const shouldRefresh = action.refreshAfter !== false;
             if (shouldRefresh)
-                setActionRefreshKey(k => k + 1);
+                notifyRecordChanged();
             const result = json?.data;
             // ── redirectUrl convention ────────────────────────────────────────
             // A script-action handler can return `{ redirectUrl: 'https://…' }`
@@ -666,7 +702,8 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 catch { /* ignore */ }
             }
             const msg = error.message;
-            toast.error(msg);
+            // Don't toast here — the ActionRunner post-execution hook toasts the
+            // returned `error` once (see the failure branch above).
             return { success: false, error: msg };
         }
         finally {
@@ -699,7 +736,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             else {
                 return { success: false, error: `Unknown approval target: ${target}` };
             }
-            setActionRefreshKey((k) => k + 1);
+            notifyRecordChanged();
             return { success: true, reload: true };
         }
         catch (err) {
@@ -1519,6 +1556,10 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             primaryField,
             sections,
             autoTabs: true,
+            // objectui#2257 — URL-driven active tab (same `?tab=` contract as the
+            // schema path's page:tabs node).
+            defaultTab: activeTabParam,
+            onTabChange: handleTabChange,
             autoDiscoverRelated: true,
             ...(historyEnabled && {
                 history: {
@@ -1537,7 +1578,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             }),
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, [objectDef?.name, pureRecordId, childRelatedData, actionRefreshKey, appName, navigate, dataSource, t, objectLabel, objects, historyEnabled, historyEntries, historyLoading, approvals.available, approvals.canDecide, approvals.pendingRequest, approvals.latestRequest, embedded]);
+    }, [objectDef?.name, pureRecordId, childRelatedData, appName, navigate, dataSource, t, objectLabel, objects, historyEnabled, historyEntries, historyLoading, approvals.available, approvals.canDecide, approvals.pendingRequest, approvals.latestRequest, embedded, activeTabParam, handleTabChange]);
     if (isLoading) {
         return _jsx(SkeletonDetail, {});
     }
@@ -1730,7 +1771,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 // there as a renderer capability).
                 ...(assignedSlots ? { slots: assignedSlots } : {}),
             });
-        return (_jsxs("div", { className: "h-full bg-background overflow-hidden flex flex-col relative", children: [_jsxs("div", { className: "absolute top-2 sm:top-4 right-2 sm:right-4 z-50 flex items-center gap-2", children: [recordPresence.length > 0 && (_jsx(PresenceAvatars, { users: recordPresence, size: "sm", maxVisible: 3, showStatus: true })), _jsx(ManagedByBadge, { managedBy: objectDef?.managedBy })] }), _jsx(RecordContextProvider, { objectName: objectName, recordId: pureRecordId, data: pageRecord, objectSchema: objectDef, dataSource: dataSource, embedded: embedded, headerSystemActions: synthSystemActions, isFavorite: isRecordFavorite, onToggleFavorite: favoriteRecord ? handleToggleRecordFavorite : undefined, children: _jsx(HighlightFieldsProvider, { children: _jsx(DiscussionContextProvider, { items: feedItems, onAddComment: handleAddComment, onAddReply: handleAddReply, onToggleReaction: handleToggleReaction, mentionSuggestions: mentionSuggestions, children: _jsxs(ActionProvider, { context: { record: pageRecord || {}, objectName, user: currentUser }, onConfirm: confirmHandler, onToast: toastHandler, onNavigate: navigateHandler, onParamCollection: paramCollectionHandler, onResultDialog: resultDialogHandler, onModal: modalHandler, handlers: { api: apiHandler, flow: flowHandler, script: serverActionHandler, approval: approvalHandler }, children: [_jsxs("div", { className: "flex-1 overflow-hidden flex flex-row", children: [_jsxs("div", { className: "flex-1 overflow-auto p-3 sm:p-4 lg:p-6 scroll-pb-48", children: [originFrom?.pathname && originFrom?.label && (_jsxs(Link, { to: originFrom.pathname, className: "inline-flex items-center gap-1 mb-3 text-sm text-muted-foreground hover:text-foreground transition-colors", children: [_jsx(ChevronLeft, { className: "h-4 w-4" }), _jsx("span", { children: originFrom.label })] })), _jsx(RelatedRecordActionsBridge, { appName: appName, objects: objects, dataSource: dataSource, actionLabel: actionLabel, children: _jsx(SchemaRenderer, { schema: renderedPage }) }), showAutoDiscussion && (_jsx("div", { className: "mt-6", children: _jsx(RecordChatterPanel, { config: {
+        return (_jsxs("div", { className: "h-full bg-background overflow-hidden flex flex-col relative", children: [_jsxs("div", { className: "absolute top-2 sm:top-4 right-2 sm:right-4 z-50 flex items-center gap-2", children: [recordPresence.length > 0 && (_jsx(PresenceAvatars, { users: recordPresence, size: "sm", maxVisible: 3, showStatus: true })), _jsx(ManagedByBadge, { managedBy: objectDef?.managedBy })] }), _jsx(RecordContextProvider, { objectName: objectName, recordId: pureRecordId, data: pageRecord, objectSchema: objectDef, dataSource: dataSource, embedded: embedded, headerSystemActions: synthSystemActions, isFavorite: isRecordFavorite, onToggleFavorite: favoriteRecord ? handleToggleRecordFavorite : undefined, children: _jsx(HighlightFieldsProvider, { children: _jsx(DiscussionContextProvider, { items: feedItems, onAddComment: handleAddComment, onAddReply: handleAddReply, onToggleReaction: handleToggleReaction, mentionSuggestions: mentionSuggestions, children: _jsxs(ActionProvider, { context: { record: pageRecord || {}, objectName, user: currentUser }, onConfirm: confirmHandler, onToast: toastHandler, onNavigate: navigateHandler, onParamCollection: paramCollectionHandler, onResultDialog: resultDialogHandler, onModal: modalHandler, handlers: { api: apiHandler, flow: flowHandler, script: serverActionHandler, approval: approvalHandler }, children: [_jsxs("div", { className: "flex-1 overflow-hidden flex flex-row", children: [_jsxs("div", { className: "flex-1 overflow-auto p-3 sm:p-4 lg:p-6 scroll-pb-48", children: [originFrom?.pathname && originFrom?.label && (_jsxs(Link, { to: originFrom.pathname, className: "inline-flex items-center gap-1 mb-3 text-sm text-muted-foreground hover:text-foreground transition-colors", children: [_jsx(ChevronLeft, { className: "h-4 w-4" }), _jsx("span", { children: originFrom.label })] })), _jsx(RelatedRecordActionsBridge, { appName: appName, objects: objects, dataSource: dataSource, actionLabel: actionLabel, children: _jsx(SchemaRenderer, { schema: withPageTabsUrlSync(renderedPage, { defaultTab: activeTabParam, onTabChange: handleTabChange }) }) }), showAutoDiscussion && (_jsx("div", { className: "mt-6", children: _jsx(RecordChatterPanel, { config: {
                                                                 position: 'bottom',
                                                                 collapsible: false,
                                                                 feed: {
@@ -1747,7 +1788,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                     } }), _jsx(ActionResultDialog, { state: resultDialogState, onAcknowledge: () => {
                         resultDialogState.resolve?.();
                         setResultDialogState({ open: false });
-                    } }), _jsx(FlowRunner, { state: screenFlow, authFetch: authFetch, baseUrl: import.meta.env.VITE_SERVER_URL || '', dataSource: dataSource, objects: objects, onClose: () => setScreenFlow(null), onComplete: () => { setScreenFlow(null); setActionRefreshKey(k => k + 1); } })] }));
+                    } }), _jsx(FlowRunner, { state: screenFlow, authFetch: authFetch, baseUrl: import.meta.env.VITE_SERVER_URL || '', dataSource: dataSource, objects: objects, onClose: () => setScreenFlow(null), onComplete: () => { setScreenFlow(null); notifyRecordChanged(); } })] }));
     }
     return (_jsxs("div", { className: "h-full bg-background overflow-hidden flex flex-col relative", children: [_jsxs("div", { className: "absolute top-2 sm:top-4 right-2 sm:right-4 z-50 flex items-center gap-2", children: [recordPresence.length > 0 && (_jsx(PresenceAvatars, { users: recordPresence, size: "sm", maxVisible: 3, showStatus: true })), _jsx(ManagedByBadge, { managedBy: objectDef?.managedBy })] }), _jsxs("div", { className: "flex-1 overflow-hidden flex flex-row", children: [_jsx("div", { className: "flex-1 overflow-auto p-3 sm:p-4 lg:p-6 scroll-pb-48", children: _jsx("div", { className: "mx-auto w-full max-w-[1400px]", children: _jsxs(ActionProvider, { context: { record: {}, objectName, user: currentUser }, onConfirm: confirmHandler, onToast: toastHandler, onNavigate: navigateHandler, onParamCollection: paramCollectionHandler, onResultDialog: resultDialogHandler, onModal: modalHandler, handlers: { api: apiHandler, flow: flowHandler, script: serverActionHandler, approval: approvalHandler }, children: [_jsx(DetailView, { schema: detailSchema, dataSource: dataSource, objectLabel: objectLabel({ name: objectDef.name, label: objectDef.label }), isFavorite: isRecordFavorite, onToggleFavorite: favoriteRecord ? handleToggleRecordFavorite : undefined, onDataLoaded: (record) => {
                                             if (!record || typeof record !== 'object')
@@ -1769,7 +1810,7 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                                                     enableThreading: true,
                                                     showCommentInput: true,
                                                 },
-                                            }, items: feedItems, onAddComment: handleAddComment, onAddReply: handleAddReply, onToggleReaction: handleToggleReaction }) }, actionRefreshKey), modalElement] }) }) }), _jsx(MetadataPanel, { open: showDebug, sections: [{ title: 'View Schema', data: detailSchema }] })] }), _jsx(ActionConfirmDialog, { state: confirmState, onOpenChange: (open) => {
+                                            }, items: feedItems, onAddComment: handleAddComment, onAddReply: handleAddReply, onToggleReaction: handleToggleReaction }) }), modalElement] }) }) }), _jsx(MetadataPanel, { open: showDebug, sections: [{ title: 'View Schema', data: detailSchema }] })] }), _jsx(ActionConfirmDialog, { state: confirmState, onOpenChange: (open) => {
                     if (!open)
                         setConfirmState(s => ({ ...s, open: false }));
                 } }), _jsx(ActionParamDialog, { state: paramState, onOpenChange: (open) => {
@@ -1778,5 +1819,5 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 } }), _jsx(ActionResultDialog, { state: resultDialogState, onAcknowledge: () => {
                     resultDialogState.resolve?.();
                     setResultDialogState({ open: false });
-                } }), _jsx(FlowRunner, { state: screenFlow, authFetch: authFetch, baseUrl: import.meta.env.VITE_SERVER_URL || '', dataSource: dataSource, objects: objects, onClose: () => setScreenFlow(null), onComplete: () => { setScreenFlow(null); setActionRefreshKey(k => k + 1); } })] }));
+                } }), _jsx(FlowRunner, { state: screenFlow, authFetch: authFetch, baseUrl: import.meta.env.VITE_SERVER_URL || '', dataSource: dataSource, objects: objects, onClose: () => setScreenFlow(null), onComplete: () => { setScreenFlow(null); notifyRecordChanged(); } })] }));
 }

package/dist/views/RelatedRecordActionsBridge.d.ts

@@ -5,7 +5,16 @@
  * This source code is licensed under the MIT license found in the
  * LICENSE file in the root directory of this source tree.
  */
-/** Notify open related lists for `objectName` to refetch (see RelatedList). */
+/**
+ * Notify open related lists for `objectName` to refetch.
+ *
+ * Since #2269 this is a thin alias over the data-invalidation bus — the bus
+ * dispatches the legacy `objectui:related-changed` window event RelatedList
+ * listens for, plus every `useDataInvalidation` reader. Kept for callers
+ * whose writes BYPASS the dataSource (row actions over the ActionRunner);
+ * dataSource writes need no manual call (the MutationEvent bridge covers
+ * them).
+ */
 export declare function notifyRelatedChanged(objectName: string): void;
 /** i18n label resolver signature (matches `useObjectLabel().actionLabel`). */
 type ActionLabelFn = (objectName: string | undefined, actionName: string, fallback: string) => string;

package/dist/views/RelatedRecordActionsBridge.js

@@ -16,10 +16,18 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * (mounted inside the page's `ActionProvider`) closes that gap:
  *
  *   - 查看详情 → navigate to the child record's detail route
- *   - 增        → navigate to the child's `/new` page, pre-linking the parent
- *                 via `?<relationshipField>=<parentId>` (the convention
- *                 RecordFormPage already reads as create-mode initial values)
- *   - 改        → navigate to the child record's `/edit` page
+ *   - 增 / 改   → open the child form as an OVERLAY on the parent detail
+ *                 (#2604 D3: a child task's return target is ALWAYS the parent
+ *                 detail with the subtable refreshed — never a route, which
+ *                 would drop the parent's scroll/tab context and refetch it).
+ *                 Implemented by pushing the console's record-form URL params
+ *                 (`?form=…&formObject=…&formLink=…`) — the ONE global record
+ *                 form overlay in `AppContent` picks them up, pre-links the
+ *                 parent from `formLink`, sizes to the CHILD object, and on
+ *                 save stays put + refetches the child's related lists
+ *                 (`notifyRelatedChanged`). URL-driven means browser Back
+ *                 closes the overlay and a refresh reopens it STILL correctly
+ *                 parent-linked.
  *   - 删        → `dataSource.delete(child, id)` (RelatedList shows the confirm
  *                 dialog and refreshes afterwards)
  *   - 子对象 action → the child object's `list_item` actions, executed against
@@ -30,14 +38,22 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * absent (e.g. the Studio designer) the related list stays read-only.
  */
 import { useCallback, useMemo } from 'react';
-import { useNavigate } from 'react-router-dom';
-import { RelatedRecordActionsProvider, useAction, } from '@object-ui/react';
+import { useNavigate, useSearchParams } from 'react-router-dom';
+import { RelatedRecordActionsProvider, notifyDataChanged, useAction, } from '@object-ui/react';
 import { resolveCrudAffordances } from '../utils/crudAffordances';
-/** Notify open related lists for `objectName` to refetch (see RelatedList). */
+import { RECORD_FORM_PARAM, RECORD_FORM_OBJECT_PARAM, RECORD_FORM_LINK_PARAM } from '../urlParams';
+/**
+ * Notify open related lists for `objectName` to refetch.
+ *
+ * Since #2269 this is a thin alias over the data-invalidation bus — the bus
+ * dispatches the legacy `objectui:related-changed` window event RelatedList
+ * listens for, plus every `useDataInvalidation` reader. Kept for callers
+ * whose writes BYPASS the dataSource (row actions over the ActionRunner);
+ * dataSource writes need no manual call (the MutationEvent bridge covers
+ * them).
+ */
 export function notifyRelatedChanged(objectName) {
-    if (typeof window === 'undefined')
-        return;
-    window.dispatchEvent(new CustomEvent('objectui:related-changed', { detail: { objectName } }));
+    notifyDataChanged({ objectName });
 }
 /**
  * Derive the child object's row actions (metadata `actions` filtered to the
@@ -55,7 +71,22 @@ function deriveRowActions(childDef, actionLabel) {
 export function RelatedRecordActionsBridge({ appName, objects, dataSource, actionLabel, children, }) {
     const navigate = useNavigate();
     const { execute } = useAction();
+    const [, setSearchParams] = useSearchParams();
     const base = appName ? `/apps/${appName}` : '';
+    // #2604 D3 — open a child create/edit task as the console's global record
+    // form overlay, by URL params. Pushes ONE history entry (Back = close, the
+    // parent detail stays mounted underneath). The read side lives in
+    // `AppContent` (see its record-form URL contract).
+    const openChildForm = useCallback((opts) => {
+        const sp = new URLSearchParams(window.location.search);
+        sp.set(RECORD_FORM_PARAM, opts.recordId ?? 'new');
+        sp.set(RECORD_FORM_OBJECT_PARAM, opts.objectName);
+        if (opts.link)
+            sp.set(RECORD_FORM_LINK_PARAM, `${opts.link.field}:${opts.link.parentId}`);
+        else
+            sp.delete(RECORD_FORM_LINK_PARAM);
+        setSearchParams(sp); // push → Back closes the overlay
+    }, [setSearchParams]);
     // Execute a child object's row action against the clicked record. Reuses the
     // page's ActionRunner (confirm dialog, toast, param collection are handled by
     // it) but retargets it at the CHILD object + row via the action's
@@ -88,14 +119,16 @@ export function RelatedRecordActionsBridge({ appName, objects, dataSource, actio
             if (aff.create) {
                 handlers.onCreate = () => {
                     const canLink = relationshipField && parentId != null && parentId !== '';
-                    const qs = canLink
-                        ? `?${encodeURIComponent(relationshipField)}=${encodeURIComponent(String(parentId))}`
-                        : '';
-                    navigate(`${base}/${objectName}/new${qs}`);
+                    openChildForm({
+                        objectName,
+                        link: canLink
+                            ? { field: relationshipField, parentId: parentId }
+                            : undefined,
+                    });
                 };
             }
             if (aff.edit) {
-                handlers.onEdit = (id) => navigate(`${detailUrl(id)}/edit`);
+                handlers.onEdit = (id) => openChildForm({ objectName, recordId: String(id) });
             }
             if (aff.delete) {
                 handlers.onDelete = async (id) => {
@@ -109,6 +142,6 @@ export function RelatedRecordActionsBridge({ appName, objects, dataSource, actio
             }
             return handlers;
         },
-    }), [objects, base, navigate, dataSource, actionLabel, runRowAction]);
+    }), [objects, base, navigate, dataSource, actionLabel, runRowAction, openChildForm]);
     return (_jsx(RelatedRecordActionsProvider, { value: value, children: children }));
 }

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

@@ -21,6 +21,7 @@ import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-run
  */
 import * as React from 'react';
 import { useNavigate, useParams, useSearchParams } from 'react-router-dom';
+import { DESIGNER_SEL_PARAM, parseNavSelParam, formatNavSelParam, findNavPositionById, navIdAtPosition, } from './nav-selection';
 import { Save, RotateCcw, Trash2, History, Link2, Loader2, AlertTriangle, Layers3, GitCompareArrows, Boxes, Eye, Pencil, X, PanelRightClose, PanelRightOpen, Maximize2, Minimize2, MousePointer2, SlidersHorizontal, FileCode2, Zap, ZapOff, Send, Undo2, Lock, ShieldCheck, } from 'lucide-react';
 import { Button } from '@object-ui/components';
 import { Badge } from '@object-ui/components';
@@ -357,6 +358,44 @@ function MetadataResourceEditPageImpl({ type, name, createMode, embedded, }) {
         if (!editing)
             setSelection(null);
     }, [editing]);
+    // #2272 — designer deep-link: `?sel=nav:<id>` selects the nav item with
+    // that spec `id` (stable across reorders, unlike the positional selection
+    // ids the canvas/inspector exchange internally). Applied once per
+    // param/item; entering edit mode is implied — a selection is meaningless
+    // in the read-only state (the effect above would clear it).
+    const navSelParam = parseNavSelParam(searchParams.get(DESIGNER_SEL_PARAM));
+    const appliedNavSelRef = React.useRef(null);
+    React.useEffect(() => {
+        if (type !== 'app' || !navSelParam)
+            return;
+        if (appliedNavSelRef.current === `${name}:${navSelParam}`)
+            return;
+        if (!draft || Object.keys(draft).length === 0)
+            return;
+        const hit = findNavPositionById(draft, navSelParam);
+        if (!hit)
+            return;
+        appliedNavSelRef.current = `${name}:${navSelParam}`;
+        setEditing(true);
+        setSelection({ kind: 'nav', id: hit.selectionId, label: hit.label });
+    }, [type, name, navSelParam, draft]);
+    // Mirror nav selections back to the URL (replace — no history spam, same
+    // convention as ADR-0047 `uf_*`) so the designer's selected menu is
+    // shareable and survives reload. Non-nav selections clear the param.
+    React.useEffect(() => {
+        if (type !== 'app')
+            return;
+        const navId = selection?.kind === 'nav' ? navIdAtPosition(draft, selection.id) : null;
+        setSearchParams((prev) => {
+            const next = new URLSearchParams(prev);
+            if (navId)
+                next.set(DESIGNER_SEL_PARAM, formatNavSelParam(navId));
+            else
+                next.delete(DESIGNER_SEL_PARAM);
+            return next;
+        }, { replace: true });
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [type, selection]);
     // Snapshot of the last saved draft. Used by Cancel to revert in-flight
     // edits, and as the source-of-truth when entering edit mode.
     const draftSnapshotRef = React.useRef(null);