@object-ui/app-shell 11.3.0 → 11.4.0

package/dist/views/InterfaceListPage.js

@@ -53,8 +53,9 @@ function resolveSourceView(objectDef, sourceView) {
 /**
  * Default column set when the resolved view carries none — mirrors
  * ObjectView's data-mode fallback so an interface page never renders a
- * column-less grid. Priority: curated `compactLayout`, else the first
- * business fields (system/audit columns excluded).
+ * column-less grid. Priority: the `highlightFields` semantic role
+ * (ADR-0085), else the first business fields (system/audit columns
+ * excluded).
  */
 const SYSTEM_FIELDS = new Set([
     'id', 'created_at', 'createdAt', 'updated_at', 'updatedAt',
@@ -62,8 +63,9 @@ const SYSTEM_FIELDS = new Set([
     'updated_by', 'updatedBy', '_version', '_rev',
 ]);
 function defaultColumnsFromObject(objectDef) {
-    if (Array.isArray(objectDef?.compactLayout) && objectDef.compactLayout.length > 0) {
-        return objectDef.compactLayout.filter((n) => objectDef.fields?.[n]);
+    const curated = objectDef?.highlightFields;
+    if (Array.isArray(curated) && curated.length > 0) {
+        return curated.filter((n) => objectDef.fields?.[n]);
     }
     const fields = objectDef?.fields;
     if (fields && typeof fields === 'object') {

package/dist/views/ObjectView.js

@@ -15,7 +15,7 @@ import { parseUserFilterParams, applyUserFilterParams } from './userFilterUrlSta
 const ObjectChart = lazy(() => import('@object-ui/plugin-charts').then((m) => ({ default: m.ObjectChart })));
 const ImportWizard = lazy(() => import('@object-ui/plugin-grid').then((m) => ({ default: m.ImportWizard })));
 import { ListView } from '@object-ui/plugin-list';
-import { ObjectView as PluginObjectView, ViewTabBar, ManageViewsDialog } from '@object-ui/plugin-view';
+import { ObjectView as PluginObjectView, ViewTabBar, ManageViewsDialog, deriveRecordSurface, overlayWidthFor } from '@object-ui/plugin-view';
 // Plugin registration is handled by the host app (e.g. apps/console/src/main.tsx
 // uses ComponentRegistry.registerLazy so heavy plugins stay code-split).
 // Do NOT add eager `import '@object-ui/plugin-*'` side-effect imports here.
@@ -34,6 +34,8 @@ import { ManagedByBadge } from '../components/ManagedByBadge';
 import { RecordDetailView } from './RecordDetailView';
 import { resolveCrudAffordances } from '../utils/crudAffordances';
 import { resolveManagedByEmptyState } from '../utils/managedByEmptyState';
+import { resolveViewId } from '../utils/resolveViewId';
+import { warnSuppressedListNav } from '../utils/warnSuppressedListNav';
 import { useObjectActions } from '../hooks/useObjectActions';
 import { useObjectTranslation, useObjectLabel } from '@object-ui/i18n';
 import { usePermissions } from '@object-ui/permissions';
@@ -190,8 +192,9 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
                     'updated_by', 'updatedBy', '_version', '_rev',
                 ]);
                 let defaultColumns = [];
-                if (Array.isArray(objectDef?.compactLayout) && objectDef.compactLayout.length > 0) {
-                    defaultColumns = objectDef.compactLayout.filter((n) => objectDef.fields?.[n]);
+                const curated = objectDef?.highlightFields;
+                if (Array.isArray(curated) && curated.length > 0) {
+                    defaultColumns = curated.filter((n) => objectDef.fields?.[n]);
                 }
                 else if (objectDef?.fields) {
                     defaultColumns = Object.entries(objectDef.fields)
@@ -430,7 +433,7 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
     // Resolve Views from objectDef.listViews (camelCase per @objectstack/spec)
     const views = useMemo(() => {
         // Default column resolution priority:
-        //   1. `compactLayout` (curated primary business fields).
+        //   1. The `highlightFields` semantic role (ADR-0085).
         //   2. Business fields only — exclude system-managed identifiers/audit
         //      columns (id, created_at, updated_at, …) and fields explicitly
         //      marked hidden/readonly on the schema. First 5 kept for compactness.
@@ -440,8 +443,9 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
             'updated_by', 'updatedBy', '_version', '_rev',
         ]);
         const resolveDefaultColumns = () => {
-            if (Array.isArray(objectDef.compactLayout) && objectDef.compactLayout.length > 0) {
-                return objectDef.compactLayout.filter((n) => objectDef.fields?.[n]);
+            const curated = objectDef.highlightFields;
+            if (Array.isArray(curated) && curated.length > 0) {
+                return curated.filter((n) => objectDef.fields?.[n]);
             }
             if (objectDef.fields) {
                 return Object.entries(objectDef.fields)
@@ -606,7 +610,20 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
         const def = views.find((v) => v.isDefault);
         return def?.id;
     }, [views]);
-    const activeViewId = viewId || searchParams.get('view') || defaultViewId || views[0]?.id;
+    // Canonical view ids are fully qualified (`<object>.<viewKind>`, see
+    // MetadataProvider), but nav items emit `viewName` verbatim — usually
+    // the short form — and legacy embedded listViews carry bare keys (incl.
+    // the `'all'` fallback). Resolve the URL-requested name in both
+    // directions, and never swallow a miss silently (#2217).
+    const requestedViewId = viewId || searchParams.get('view') || undefined;
+    const resolvedViewId = useMemo(() => resolveViewId(requestedViewId, views.map((v) => v.id), objectDef.name), [requestedViewId, views, objectDef.name]);
+    useEffect(() => {
+        if (requestedViewId && !resolvedViewId) {
+            console.warn(`[ObjectView] Requested view "${requestedViewId}" not found on object "${objectDef.name}"; ` +
+                `falling back to the default view. Known views: ${views.map((v) => v.id).join(', ')}`);
+        }
+    }, [requestedViewId, resolvedViewId, objectDef.name, views]);
+    const activeViewId = resolvedViewId || defaultViewId || views[0]?.id;
     const baseView = views.find((v) => v.id === activeViewId) || views[0];
     const activeView = viewDraft && viewDraft.id === baseView?.id
         ? { ...baseView, ...viewDraft }
@@ -874,8 +891,26 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
     // RecordDetailView owns its own route — only same-page click navigation
     // is drawer-by-default. Per-view config can still override (e.g. a heavy
     // detail object can set `navigation.mode = 'page'`).
-    const detailNavigation = useMemo(() => activeView?.navigation ??
-        objectDef.navigation ?? { mode: 'drawer', width: 'min(92vw, 1280px)' }, [activeView?.navigation, objectDef.navigation]);
+    const detailNavigation = useMemo(() => {
+        const authored = activeView?.navigation ?? objectDef.navigation;
+        if (authored) {
+            // Authored config wins. For an overlay, resolve the `size`
+            // bucket (or 'auto') to a viewport-clamped width when no explicit
+            // width was given — #2578: a pixel width can't be authored blind.
+            if (authored.mode === 'page')
+                return authored;
+            return {
+                ...authored,
+                width: authored.width ?? overlayWidthFor(authored.size, objectDef),
+            };
+        }
+        // #2578: derive surface + width from FIELD COUNT. Field-heavy → full
+        // page (cramped in a drawer); light → a drawer sized to the content
+        // and clamped to the viewport. Mobile always pages (in deriveRecordSurface).
+        return deriveRecordSurface(objectDef) === 'page'
+            ? { mode: 'page' }
+            : { mode: 'drawer', width: overlayWidthFor('auto', objectDef) };
+    }, [activeView?.navigation, objectDef]);
     const drawerRecordId = searchParams.get('recordId');
     /**
      * URL-derived equality filters in the form `?filter[<field>]=<value>`.
@@ -1066,6 +1101,11 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
                         className: 'h-[400px] w-full',
                     } }) }, key));
         }
+        // ADR-0053 wrong-context authoring: userFilters/quickFilters on an
+        // object list view are suppressed below — say so instead of letting
+        // the author stare at a toolbar with nothing where their filter
+        // controls should be (#2219).
+        warnSuppressedListNav(objectDef.name, viewDef.id || viewDef.name || '', viewDef, listSchema);
         const fullSchema = {
             ...listSchema,
             // Propagate appearance/view-config properties for live preview
@@ -1369,11 +1409,22 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
                                             // Import buttons stay visible without pushing the page
                                             // title off-screen.
                                             mobileMaxVisible: 0,
-                                        } })))] }) }) }), affordances.create && can(objectDef.name, 'create') && (_jsx("button", { type: "button", onClick: actions.create, className: "sm:hidden fixed right-4 bottom-36 z-40 h-12 w-12 rounded-full bg-primary text-primary-foreground shadow-lg active:scale-95 transition-transform inline-flex items-center justify-center", "aria-label": t('console.objectView.new'), "data-testid": "mobile-fab-create", children: _jsx(Plus, { className: "h-5 w-5" }) })), showImport && (_jsx(Suspense, { fallback: null, children: _jsx(ImportWizard, { open: showImport, onOpenChange: setShowImport, objectName: objectDef.name, objectLabel: objectLabel(objectDef), fields: Object.entries(objectDef.fields || {}).map(([name, def]) => ({
+                                        } })))] }) }) }), affordances.create && can(objectDef.name, 'create') && (_jsx("button", { type: "button", onClick: actions.create, className: "sm:hidden fixed right-4 bottom-36 z-40 h-12 w-12 rounded-full bg-primary text-primary-foreground shadow-lg active:scale-95 transition-transform inline-flex items-center justify-center", "aria-label": t('console.objectView.new'), "data-testid": "mobile-fab-create", children: _jsx(Plus, { className: "h-5 w-5" }) })), showImport && (_jsx(Suspense, { fallback: null, children: _jsx(ImportWizard, { open: showImport, onOpenChange: setShowImport, objectName: objectDef.name, objectLabel: objectLabel(objectDef), fields: Object.entries(objectDef.fields || {})
+                                // Only writable fields are importable targets. Computed
+                                // types (formula/summary/autonumber) and fields flagged
+                                // readonly / write:false are server-rejected, so we omit
+                                // them from the mapping step rather than let a user map to
+                                // a column the import will silently drop.
+                                .filter(([, def]) => !['formula', 'summary', 'autonumber'].includes(def?.type) &&
+                                !def?.readonly &&
+                                def?.permissions?.write !== false)
+                                .map(([name, def]) => ({
                                 name,
                                 label: def?.label || name,
                                 type: def?.type || 'text',
                                 required: !!def?.required,
+                                // Enum options seed the downloadable template's example row.
+                                ...(def?.options ? { options: def.options } : {}),
                             })), dataSource: dataSource, onComplete: (result) => {
                                 setRefreshKey(k => k + 1);
                                 const ok = result.importedRows;

package/dist/views/RecordDetailView.js

@@ -8,7 +8,7 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
  */
 import { useState, useEffect, useCallback, useMemo, useRef } from 'react';
 import { useParams, useNavigate, useLocation, Link } from 'react-router-dom';
-import { DetailView, RecordChatterPanel, buildDefaultPageSchema, extractMentions } from '@object-ui/plugin-detail';
+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';
@@ -26,6 +26,7 @@ import { ActionConfirmDialog } from './ActionConfirmDialog';
 import { ActionParamDialog } from './ActionParamDialog';
 import { ActionResultDialog } from './ActionResultDialog';
 import { FlowRunner } from './FlowRunner';
+import { RelatedRecordActionsBridge } from './RelatedRecordActionsBridge';
 import { resolveActionParams } from '../utils/resolveActionParams';
 import { useRecordBreadcrumbTitle } from '../context/NavigationContext';
 import { useRecordApprovals } from '../hooks/useRecordApprovals';
@@ -47,9 +48,8 @@ const AUDIT_FIELD_NAMES = new Set(['created_at', 'created_by', 'updated_at', 'up
 /**
  * System/tenant fields that the framework auto-injects on every record but
  * which carry no business value on a detail page. Hidden from the
- * auto-generated section (when the object has no explicit form sections).
- * Authors who really want to show these can still list them in
- * `objectDef.views.form.sections`.
+ * auto-generated sections. Authors who really want to surface one can
+ * assign it to a `fieldGroups` group explicitly (explicit listing wins).
  */
 const HIDDEN_SYSTEM_FIELD_NAMES = new Set([
     'organization_id', 'tenant_id', 'is_deleted', 'deleted_at',
@@ -359,29 +359,37 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 case 'opportunity_mark_lost':
                     await dataSource.update(objectName, pureRecordId, { stage: 'closed_lost', loss_reason: params.loss_reason });
                     break;
-                default:
-                    // Generic: update record with collected params
-                    if (Object.keys(params).length > 0) {
+                default: {
+                    // Generic: update record with collected params. Related-list row
+                    // actions retarget a CHILD record via explicit `objectName`/`recordId`;
+                    // otherwise the update falls back to this page's record.
+                    const targetObject = action.objectName ?? objectName;
+                    const targetId = action.recordId ?? pureRecordId;
+                    const isThisRecord = targetObject === objectName && String(targetId) === String(pureRecordId);
+                    if (Object.keys(params).length > 0 && targetObject && targetId != null) {
                         // Undoable single-record update: capture the changed fields' prior
                         // values from the loaded record so the success toast can offer Undo.
-                        if (action.undoable && pageRecord && objectName && pureRecordId) {
+                        // Only this page's record has its prior values loaded, so child-row
+                        // updates skip undo capture.
+                        if (action.undoable && isThisRecord && pageRecord) {
                             const undoData = {};
                             for (const k of Object.keys(params))
                                 undoData[k] = pageRecord[k] ?? null;
                             undo = {
-                                id: `undo-${objectName}-${pureRecordId}-${Date.now()}`,
+                                id: `undo-${targetObject}-${targetId}-${Date.now()}`,
                                 type: 'update',
-                                objectName,
-                                recordId: String(pureRecordId),
+                                objectName: targetObject,
+                                recordId: String(targetId),
                                 timestamp: Date.now(),
-                                description: action.label || `Undo ${objectName}`,
+                                description: action.label || `Undo ${targetObject}`,
                                 undoData,
                                 redoData: { ...params },
                             };
                         }
-                        await dataSource.update(objectName, pureRecordId, params);
+                        await dataSource.update(targetObject, String(targetId), params);
                     }
                     break;
+                }
             }
             const shouldRefresh = action.refreshAfter === true;
             if (shouldRefresh) {
@@ -419,8 +427,11 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
                 body: JSON.stringify({
-                    recordId: pureRecordId,
-                    objectName,
+                    // Related-list row actions retarget the flow at a CHILD record via
+                    // an explicit `recordId` / `objectName`; fall back to this page's
+                    // record when the action carries none (header/more actions).
+                    recordId: action.recordId ?? pureRecordId,
+                    objectName: action.objectName ?? objectName,
                     params: action.params ?? {},
                 }),
             });
@@ -561,7 +572,9 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             const res = await authFetch(`${baseUrl}/api/v1/actions/${encodeURIComponent(obj)}/${encodeURIComponent(targetName)}`, {
                 method: 'POST',
                 headers: { 'Content-Type': 'application/json' },
-                body: JSON.stringify({ recordId: pureRecordId, params }),
+                // Related-list row actions retarget a CHILD record via explicit
+                // `recordId`; header/more actions carry none and use this page's id.
+                body: JSON.stringify({ recordId: action.recordId ?? pureRecordId, params }),
             });
             const json = await res.json().catch(() => null);
             // The action route wraps the handler's return value in a {success, data}
@@ -1215,76 +1228,49 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
         if (!objectDef) {
             return { type: 'detail-view' };
         }
-        // Auto-detect primary field: prefer objectDef metadata, then 'name' or 'title' heuristic
+        // Auto-detect primary field: prefer objectDef metadata — `primaryField`
+        // (objectui-local override), then the spec-canonical `nameField` and its
+        // deprecated `displayNameField` alias (ADR-0079) — then the 'name'/'title'
+        // heuristic.
         const primaryField = objectDef.primaryField
+            || objectDef.nameField
+            || objectDef.displayNameField
             || Object.keys(objectDef.fields || {}).find((key) => key === 'name' || key === 'title');
-        // Build sections: prefer form sections from objectDef, fallback to flat field list
-        const formSections = objectDef.views?.form?.sections;
-        const sections = formSections && formSections.length > 0
-            ? formSections.map((sec) => ({
-                title: sec.name ? sectionLabel(objectDef.name, sec.name, sec.title || sec.name) : sec.title,
-                collapsible: sec.collapsible,
-                defaultCollapsed: sec.defaultCollapsed,
-                fields: (sec.fields || [])
-                    .filter((f) => {
-                    // Honor `hidden: true` on a field def even when the form
-                    // section explicitly lists it. Hidden fields are typically
-                    // internal artifacts (e.g. database URL, environment id)
-                    // that platform actions read but end-users shouldn't see.
-                    const fieldName = typeof f === 'string' ? f : f.name;
-                    const fieldDef = objectDef.fields?.[fieldName];
-                    return !fieldDef?.hidden;
-                })
-                    .map((f) => {
-                    const fieldName = typeof f === 'string' ? f : f.name;
-                    const fieldDef = objectDef.fields[fieldName];
-                    if (!fieldDef) {
-                        console.warn(`[RecordDetailView] Field "${fieldName}" not found in ${objectDef.name} definition`);
-                        return { name: fieldName, label: fieldName };
-                    }
-                    const refTarget = fieldDef.reference_to || fieldDef.reference;
-                    return {
-                        name: fieldName,
-                        label: fieldDef.label || fieldName,
-                        type: fieldDef.type || 'text',
-                        ...(fieldDef.options && { options: fieldDef.options }),
-                        ...(refTarget && { reference_to: refTarget }),
-                        ...(fieldDef.reference_field && { reference_field: fieldDef.reference_field }),
-                        ...(fieldDef.currency && { currency: fieldDef.currency }),
-                    };
-                }),
-            }))
-            : (() => {
-                // Auto-grouping (platform B): when no form sections are authored,
-                // split fields into a primary section and a collapsible
-                // "More details" section so long-form/secondary fields don't
-                // dilute the main grid. The primary section stays untitled so
-                // DetailSection still flattens its chrome when alone.
-                const allFields = Object.keys(objectDef.fields || {})
-                    .filter((key) => !AUDIT_FIELD_NAMES.has(key) && !HIDDEN_SYSTEM_FIELD_NAMES.has(key) && !objectDef.fields[key]?.hidden);
-                const toField = (key) => {
-                    const fieldDef = objectDef.fields[key];
-                    const refTarget = fieldDef.reference_to || fieldDef.reference;
-                    return {
-                        name: key,
-                        label: fieldDef.label || key,
-                        type: fieldDef.type || 'text',
-                        ...(fieldDef.options && { options: fieldDef.options }),
-                        ...(refTarget && { reference_to: refTarget }),
-                        ...(fieldDef.reference_field && { reference_field: fieldDef.reference_field }),
-                        ...(fieldDef.currency && { currency: fieldDef.currency }),
-                    };
+        // Build sections (ADR-0085: grouping is the `fieldGroups` semantic
+        // role — there is no per-surface sections override; per-page
+        // customization goes through an assigned Page schema):
+        //   1) sections derived from the object's `fieldGroups`;
+        //   2) auto-grouping (primary + collapsible "More details").
+        const sections = (() => {
+            const toField = (key) => {
+                const fieldDef = objectDef.fields[key];
+                const refTarget = fieldDef.reference_to || fieldDef.reference;
+                return {
+                    name: key,
+                    label: fieldDef.label || key,
+                    type: fieldDef.type || 'text',
+                    ...(fieldDef.options && { options: fieldDef.options }),
+                    ...(refTarget && { reference_to: refTarget }),
+                    ...(fieldDef.reference_field && { reference_field: fieldDef.reference_field }),
+                    ...(fieldDef.currency && { currency: fieldDef.currency }),
                 };
-                const primaryKeys = allFields.filter((k) => !isSecondaryField(k, objectDef.fields[k]));
-                const secondaryKeys = allFields.filter((k) => isSecondaryField(k, objectDef.fields[k]));
-                // Below ~6 primary fields the second section often looks awkward
-                // — keep the legacy single-untitled-section behaviour. Also
-                // honour the "no secondary fields" case the same way.
+            };
+            // Auto-grouping (platform B): split fields into a primary section
+            // and a collapsible "More details" section so long-form/secondary
+            // fields don't dilute the main grid. The primary section stays
+            // untitled so DetailSection still flattens its chrome when alone.
+            // Shared by the pure-fallback path and the ungrouped remainder of
+            // the fieldGroups path below.
+            const splitPrimarySecondary = (keys) => {
+                const primaryKeys = keys.filter((k) => !isSecondaryField(k, objectDef.fields[k]));
+                const secondaryKeys = keys.filter((k) => isSecondaryField(k, objectDef.fields[k]));
+                // Keep the legacy single-untitled-section behaviour when the
+                // split would leave one side empty.
                 if (secondaryKeys.length === 0 || primaryKeys.length === 0) {
                     return [
                         {
                             showBorder: false,
-                            fields: allFields.map(toField),
+                            fields: keys.map(toField),
                         },
                     ];
                 }
@@ -1302,7 +1288,31 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                         fields: secondaryKeys.map(toField),
                     },
                 ];
-            })();
+            };
+            // 1) fieldGroups-derived sections (the ADR-0085 semantic role,
+            //    same shared derivation the runtime form honours). Declared
+            //    groups render as titled cards in declared order; the
+            //    trailing untitled bucket (ungrouped fields) still goes
+            //    through the primary/"More details" split so long-form
+            //    fields stay tucked away.
+            const grouped = deriveFieldGroupDetailSections(objectDef);
+            if (grouped) {
+                return grouped.flatMap((sec) => {
+                    if (!sec.name) {
+                        return splitPrimarySecondary(sec.fields.map((f) => f.name));
+                    }
+                    return [{
+                            ...sec,
+                            title: sectionLabel(objectDef.name, sec.name, sec.title),
+                            showBorder: true,
+                        }];
+                });
+            }
+            // 3) Pure auto-grouping fallback.
+            const allFields = Object.keys(objectDef.fields || {})
+                .filter((key) => !AUDIT_FIELD_NAMES.has(key) && !HIDDEN_SYSTEM_FIELD_NAMES.has(key) && !objectDef.fields[key]?.hidden);
+            return splitPrimarySecondary(allFields);
+        })();
         // Audit fields (created_at/created_by/updated_at/updated_by) are NOT
         // appended as a section here — they are surfaced by `<RecordMetaFooter>`
         // (rendered by DetailView) as a single subtle line below the content,
@@ -1372,10 +1382,22 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             }
             return base;
         })();
-        // Build highlightFields: exclusively from objectDef metadata (no hardcoded fallback)
-        const highlightFields = objectDef.views?.detail?.highlightFields ?? [];
-        // Build sectionGroups from objectDef detail/form config if available
-        const sectionGroups = objectDef.views?.detail?.sectionGroups ?? objectDef.views?.form?.sectionGroups;
+        // Build highlightFields from the object's semantic role (ADR-0085).
+        // Bare field names resolve label/type from the field def.
+        const rawHighlightFields = objectDef.highlightFields ?? [];
+        const highlightFields = (Array.isArray(rawHighlightFields) ? rawHighlightFields : [])
+            .map((f) => {
+            const name = typeof f === 'string' ? f : f?.name;
+            if (!name)
+                return null;
+            const fieldDef = objectDef.fields?.[name];
+            return {
+                name,
+                label: fieldDef?.label || name,
+                ...(fieldDef?.type ? { type: fieldDef.type } : {}),
+            };
+        })
+            .filter((f) => !!f);
         // Build related entries from reverse-reference child objects.
         // `referenceField` is the FK field on the child pointing back to this
         // record — passed so the related-list renderer can hide the redundant
@@ -1468,9 +1490,10 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 // Surface the child object's canonical display field so the
                 // right-rail can show meaningful labels (`user_agent`, `email`,
                 // …) instead of opaque IDs like `kCc8mhJr0bRs0r9Ykd09…`.
-                displayField: childObjectDef?.displayNameField ||
-                    (Array.isArray(childObjectDef?.compactLayout)
-                        ? childObjectDef.compactLayout[0]
+                displayField: childObjectDef?.nameField ||
+                    childObjectDef?.displayNameField ||
+                    (Array.isArray(childObjectDef?.highlightFields)
+                        ? childObjectDef.highlightFields[0]
                         : undefined),
                 onNew,
                 onViewAll,
@@ -1505,7 +1528,6 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
             }),
             ...(related.length > 0 && { related }),
             ...(highlightFields.length > 0 && { highlightFields }),
-            ...(sectionGroups && sectionGroups.length > 0 && { sectionGroups }),
             ...(recordHeaderActions.length > 0 && {
                 actions: [{
                         type: 'action:bar',
@@ -1666,14 +1688,21 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
         const synthRelated = Array.isArray(detailSchema.related)
             ? detailSchema.related
                 .filter((r) => r?.api && r?.referenceField)
-                .map((r) => ({
-                title: r.title,
-                objectName: r.api,
-                relationshipField: r.referenceField,
-                ...(Array.isArray(r.columns) ? { columns: r.columns } : {}),
-                ...(typeof r.pageSize === 'number' ? { limit: r.pageSize } : {}),
-                ...(r.icon ? { icon: r.icon } : {}),
-            }))
+                .map((r) => {
+                // Carry the `relatedList: 'primary'` prominence flag from the derived
+                // relationship graph. Matched by (childObject, referenceField) — the
+                // unique key of a related list — so it is robust to ordering/filtering.
+                const derived = childRelations.find((c) => c.childObject === r.api && c.referenceField === r.referenceField);
+                return {
+                    title: r.title,
+                    objectName: r.api,
+                    relationshipField: r.referenceField,
+                    ...(Array.isArray(r.columns) ? { columns: r.columns } : {}),
+                    ...(typeof r.pageSize === 'number' ? { limit: r.pageSize } : {}),
+                    ...(r.icon ? { icon: r.icon } : {}),
+                    ...(derived?.isPrimary ? { isPrimary: true } : {}),
+                };
+            })
             : undefined;
         const synthHistory = detailSchema.history
             ? {
@@ -1694,16 +1723,14 @@ export function RecordDetailView({ dataSource, objects, onEdit, objectNameOverri
                 headerActions: synthHeaderActions,
                 related: synthRelated,
                 history: synthHistory,
-                // Per-object opt-outs read from `objectDef.detail.*`. Lets
-                // catalog/atomic objects (product, task, ...) keep a focused
-                // single-column layout instead of inheriting the rail.
-                showReferenceRail: objectDef?.detail?.showReferenceRail === true || undefined,
-                hideReferenceRail: objectDef?.detail?.hideReferenceRail === true || undefined,
-                hideRelatedTab: objectDef?.detail?.hideRelatedTab === true || undefined,
-                relatedLayout: objectDef?.detail?.relatedLayout === 'tabs' ? 'tabs' : undefined,
+                // ADR-0085 removed the per-object `detail.*` presentation
+                // toggles (show/hideReferenceRail, hideRelatedTab, relatedLayout)
+                // — the synth defaults apply; per-page layout goes through an
+                // assigned Page schema (`record:reference_rail` stays available
+                // 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(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: renderedPage }) }), showAutoDiscussion && (_jsx("div", { className: "mt-6", children: _jsx(RecordChatterPanel, { config: {
                                                                 position: 'bottom',
                                                                 collapsible: false,
                                                                 feed: {

package/dist/views/RecordFormPage.js

@@ -181,7 +181,13 @@ export function RecordFormPage({ mode }) {
     // `simple` here (see the form-layout-vs-presentation modelling note in #1890).
     const formDef = objectDef.form ?? objectDef.formViews?.default ?? {};
     const pageFormType = ['tabbed', 'wizard', 'split'].includes(formDef.type) ? formDef.type : 'simple';
-    const formLayoutProps = pageFormType !== 'simple' && Array.isArray(formDef.sections)
+    // Curated `sections` are wired through for EVERY layout family — a `simple`
+    // form view's sections still carry the authored field selection, order,
+    // grouping and per-field `visibleOn` predicates (#2212). Dropping them for
+    // `simple` made the page-mode form fall back to the raw schema (every field,
+    // no conditional visibility) while the New/Edit modal honored the same view
+    // via resolveFormViewLayout.
+    const formLayoutProps = Array.isArray(formDef.sections) && formDef.sections.length > 0
         ? {
             sections: formDef.sections,
             defaultTab: formDef.defaultTab,

package/dist/views/RelatedRecordActionsBridge.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * 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). */
+export declare function notifyRelatedChanged(objectName: string): void;
+/** i18n label resolver signature (matches `useObjectLabel().actionLabel`). */
+type ActionLabelFn = (objectName: string | undefined, actionName: string, fallback: string) => string;
+export interface RelatedRecordActionsBridgeProps {
+    /** Current app segment used to build `/apps/:appName/...` routes. */
+    appName?: string;
+    /** All object definitions (to resolve the child object + its actions). */
+    objects: any[];
+    /** Data source for delete + action dispatch. */
+    dataSource: any;
+    /** Localizes a child action's label (falls back to the raw label). */
+    actionLabel: ActionLabelFn;
+    children: React.ReactNode;
+}
+export declare function RelatedRecordActionsBridge({ appName, objects, dataSource, actionLabel, children, }: RelatedRecordActionsBridgeProps): import("react").JSX.Element;
+export {};