@object-ui/app-shell 11.2.0 → 11.4.0

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 {};

package/dist/views/RelatedRecordActionsBridge.js

@@ -0,0 +1,114 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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.
+ */
+/**
+ * RelatedRecordActionsBridge — supplies the console's object-aware CRUD +
+ * action handlers to the `record:related_list` renderers on a detail page.
+ *
+ * The renderer (in `@object-ui/plugin-detail`) knows the child object, the FK
+ * back to the parent, and the parent id — but not the SPA routes, the
+ * create/edit form pages, or the per-object lifecycle affordances. This bridge
+ * (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
+ *   - 删        → `dataSource.delete(child, id)` (RelatedList shows the confirm
+ *                 dialog and refreshes afterwards)
+ *   - 子对象 action → the child object's `list_item` actions, executed against
+ *                 the clicked row through the page's shared ActionRunner
+ *
+ * Each affordance is gated by {@link resolveCrudAffordances} so system /
+ * append-only children never show New / Edit / Delete. When this bridge is
+ * 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 { resolveCrudAffordances } from '../utils/crudAffordances';
+/** Notify open related lists for `objectName` to refetch (see RelatedList). */
+export function notifyRelatedChanged(objectName) {
+    if (typeof window === 'undefined')
+        return;
+    window.dispatchEvent(new CustomEvent('objectui:related-changed', { detail: { objectName } }));
+}
+/**
+ * Derive the child object's row actions (metadata `actions` filtered to the
+ * `list_item` location), localized and shaped for the related-list row menu.
+ */
+function deriveRowActions(childDef, actionLabel) {
+    const actions = Array.isArray(childDef?.actions) ? childDef.actions : [];
+    return actions
+        .filter((a) => Array.isArray(a?.locations) && a.locations.includes('list_item'))
+        .map((a) => ({
+        ...a,
+        label: actionLabel(childDef.name, a.name, a.label || a.name),
+    }));
+}
+export function RelatedRecordActionsBridge({ appName, objects, dataSource, actionLabel, children, }) {
+    const navigate = useNavigate();
+    const { execute } = useAction();
+    const base = appName ? `/apps/${appName}` : '';
+    // 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
+    // `objectName` / `recordId`, which the record-detail action handlers honor.
+    const runRowAction = useCallback(async (childObject, record, action) => {
+        const id = record?.id ?? record?._id;
+        const def = {
+            ...action,
+            objectName: childObject,
+            ...(id != null ? { recordId: String(id) } : {}),
+            params: { ...action.params },
+        };
+        const res = await execute(def);
+        // Refresh open related lists for this child object after a successful
+        // mutating action (the row menu handler is otherwise fire-and-forget).
+        if (res?.success)
+            notifyRelatedChanged(childObject);
+    }, [execute]);
+    const value = useMemo(() => ({
+        resolve: ({ objectName, relationshipField, parentId }) => {
+            const childDef = objects.find((o) => o?.name === objectName);
+            if (!childDef || !base)
+                return {};
+            const aff = resolveCrudAffordances(childDef);
+            const detailUrl = (id) => `${base}/${objectName}/record/${encodeURIComponent(String(id))}`;
+            const handlers = {
+                // Viewing a child record is always allowed when the list is visible.
+                onView: (id) => navigate(detailUrl(id)),
+            };
+            if (aff.create) {
+                handlers.onCreate = () => {
+                    const canLink = relationshipField && parentId != null && parentId !== '';
+                    const qs = canLink
+                        ? `?${encodeURIComponent(relationshipField)}=${encodeURIComponent(String(parentId))}`
+                        : '';
+                    navigate(`${base}/${objectName}/new${qs}`);
+                };
+            }
+            if (aff.edit) {
+                handlers.onEdit = (id) => navigate(`${detailUrl(id)}/edit`);
+            }
+            if (aff.delete) {
+                handlers.onDelete = async (id) => {
+                    await dataSource?.delete?.(objectName, String(id));
+                };
+            }
+            const rowActions = deriveRowActions(childDef, actionLabel);
+            if (rowActions.length > 0) {
+                handlers.rowActions = rowActions;
+                handlers.onRowAction = (action, record) => runRowAction(objectName, record, action);
+            }
+            return handlers;
+        },
+    }), [objects, base, navigate, dataSource, actionLabel, runRowAction]);
+    return (_jsx(RelatedRecordActionsProvider, { value: value, children: children }));
+}

package/dist/views/ReportView.js

@@ -16,7 +16,7 @@ import { preferLocal } from '../utils/preferLocal';
 import { useAdapter } from '../providers/AdapterProvider';
 import { useMetadataClient } from './metadata-admin/useMetadata';
 import { persistRuntimeMetadata } from './runtime-metadata-persistence';
-import { useAuth } from '@object-ui/auth';
+import { useIsWorkspaceAdmin } from '@object-ui/auth';
 import { DrillDownDrawer } from '@object-ui/plugin-dashboard';
 import { DrillNavigationProvider } from '@object-ui/react';
 import { useOpenRecordList } from './useOpenRecordList';
@@ -40,8 +40,7 @@ export function ReportView({ dataSource }) {
     const metadataClient = useMetadataClient();
     // Editing a report mutates the SHARED definition, so it is an admin-only
     // quick-edit affordance (mirrors ObjectView's view-config gate).
-    const { user } = useAuth();
-    const isAdmin = user?.role === 'admin';
+    const isAdmin = useIsWorkspaceAdmin();
     const [configPanelOpen, setConfigPanelOpen] = useState(false);
     // Version counter — incremented on save to refresh the stable config reference
     const [configVersion, setConfigVersion] = useState(0);

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

@@ -44,16 +44,23 @@ async function apiJson(path, init) {
 /* -------------------------------------------------------------------------- */
 function ScopeBadge({ scope }) {
     const locale = React.useMemo(() => detectLocale(), []);
-    const s = scope ?? 'project';
-    const variant = s === 'project' ? 'default' : s === 'system' ? 'secondary' : 'outline';
-    const labelKey = s === 'project'
+    // Writability semantics, aligned with the builder (studio-design/packages-io):
+    // a SCOPE-LESS entry is a database base package (writable — authoring lives
+    // there), while `project` marks a read-only code package. Defaulting the
+    // missing scope to 'project' used to render both with the same badge, which
+    // contradicted the builder's 可写/只读 labeling for the very same package.
+    if (!scope) {
+        return (_jsx(Badge, { className: "bg-emerald-400/15 text-emerald-600 hover:bg-emerald-400/15 dark:text-emerald-300", children: t('engine.packages.scope.writable', locale) }));
+    }
+    const variant = scope === 'project' ? 'default' : scope === 'system' ? 'secondary' : 'outline';
+    const labelKey = scope === 'project'
         ? 'engine.packages.scope.project'
-        : s === 'system'
+        : scope === 'system'
             ? 'engine.packages.scope.system'
-            : s === 'cloud'
+            : scope === 'cloud'
                 ? 'engine.packages.scope.cloud'
                 : '';
-    return _jsx(Badge, { variant: variant, children: labelKey ? t(labelKey, locale) : s });
+    return _jsx(Badge, { variant: variant, children: labelKey ? t(labelKey, locale) : scope });
 }
 function StatusBadge({ pkg }) {
     const locale = React.useMemo(() => detectLocale(), []);
@@ -99,7 +106,11 @@ export function CreatePackageDialog({ open, onOpenChange, onCreated, }) {
                         name: name.trim(),
                         version: version.trim(),
                         type: 'app',
-                        scope: 'project',
+                        // No `scope`: runtime-created base packages are writable authoring
+                        // targets. `scope: 'project'` marks read-only CODE packages — the
+                        // old hardcode here made Setup-created bases read as 只读 in the
+                        // builder's switcher/landing while the builder's own creator made
+                        // writable ones. One creation semantic everywhere now.
                     },
                 }),
             });

package/dist/views/metadata-admin/PermissionMatrixEditor.d.ts

@@ -35,5 +35,22 @@ import * as React from 'react';
 export interface PermissionMatrixEditPageProps {
     type: string;
     name: string;
+    /**
+     * When set, the matrix is scoped to a single package (ADR-0086 P0): it lists
+     * only the objects that package declares, and Save merges just that slice
+     * back — other packages' contributed rows are left untouched. When omitted,
+     * the matrix operates at environment scope (all objects, whole-record save).
+     */
+    packageId?: string;
+    /**
+     * ADR-0086 P2 (D6/D7 — the package door). When editing under a `packageId`,
+     * a permission set is package **metadata**: Save writes a **draft** (not a
+     * live record), published atomically with the rest of the package. `onDraftSaved`
+     * notifies the surface so its pending-changes counter refreshes; `publishNonce`
+     * bumps on publish so the editor re-reads the now-published baseline (its draft
+     * is gone). Both are no-ops at environment scope, where Save stays live (D7).
+     */
+    onDraftSaved?: () => void;
+    publishNonce?: number;
 }
-export declare function PermissionMatrixEditPage({ type, name }: PermissionMatrixEditPageProps): React.JSX.Element;
+export declare function PermissionMatrixEditPage({ type, name, packageId, onDraftSaved, publishNonce }: PermissionMatrixEditPageProps): React.JSX.Element;