@object-ui/app-shell 11.2.0 → 11.4.0

package/dist/utils/index.js

@@ -1,6 +1,14 @@
 /**
  * Utility functions for ObjectStack Console
  */
+// Re-export the unified record display-name resolver (ADR-0079) so existing
+// importers of `@object-ui/app-shell`'s `getRecordDisplayName` /
+// `formatRecordTitle` keep working unchanged. The implementation now lives in
+// `@object-ui/core` (pure util, shared by every view plugin and field widget).
+export { getRecordDisplayName, deriveTitleField, isTitleEligibleField, 
+// `formatTitleTemplate` is the new canonical name; alias it to the legacy
+// `formatRecordTitle` export this module has always provided.
+formatTitleTemplate as formatRecordTitle, } from '@object-ui/core';
 export { resolveRecordFormTarget, resolveFormViewLayout, } from './recordFormNavigation';
 export { deriveRelatedLists } from './deriveRelatedLists';
 export { preferLocal } from './preferLocal';
@@ -32,104 +40,9 @@ export function capitalizeFirst(str) {
         return str;
     return str.charAt(0).toUpperCase() + str.slice(1);
 }
-// Sentinel used to mark empty-placeholder positions inside formatRecordTitle
-// so adjacent separators can be stripped in a second pass.
-const EMPTY_TOKEN = '\u0000';
-// Separator characters commonly placed between {fields} in titleFormat patterns
-// (hyphen, em/en dashes, pipes, slashes, middle dot, comma, colon).
-const SEPARATOR_CLASS = '[-\\u2013\\u2014|/·,:]';
-/**
- * Format a record title using the titleFormat pattern.
- *
- * Accepts either a legacy string template or an Expression envelope
- * (`{ dialect: 'template', source: string }`) emitted by `@objectstack/spec`'s
- * normalized templates. The placeholder syntax (`{field}`) is identical in both
- * shapes; only the wrapping object is new.
- *
- * Empty placeholders (missing or null/empty fields) are stripped along with
- * any orphan separator they leave behind, so a template like
- *   "{full_name} - {company}"
- * evaluated against `{ company: "Acme" }` resolves to `"Acme"` rather than
- * `" - Acme"`. Returns an empty string when no placeholder resolved.
- */
-export function formatRecordTitle(titleFormat, record) {
-    // Normalize Expression envelope ({ dialect, source }) → raw template string.
-    const template = typeof titleFormat === 'string'
-        ? titleFormat
-        : (titleFormat && typeof titleFormat === 'object' && typeof titleFormat.source === 'string')
-            ? titleFormat.source
-            : undefined;
-    if (!template || !record) {
-        return record?.id || record?._id || 'Record';
-    }
-    let anyResolved = false;
-    let out = template.replace(/\{([^{}]+)\}/g, (_match, fieldName) => {
-        // Support dotted paths (e.g. `{account.name}`) for $expanded lookups.
-        const parts = String(fieldName).trim().split('.');
-        let value = record;
-        for (const p of parts) {
-            if (value == null)
-                break;
-            value = value[p];
-        }
-        // Auto-extract display name from expanded reference objects, with a
-        // Salesforce-style fallback chain.
-        if (value && typeof value === 'object') {
-            const o = value;
-            let display = o.name ?? o.full_name ?? o.display_name ?? o.label ?? o.title ?? o.subject ?? null;
-            if (display == null || (typeof display === 'string' && !display.trim())) {
-                const composite = [o.salutation, o.first_name, o.last_name]
-                    .filter((p) => typeof p === 'string' && p.trim())
-                    .map((p) => p.trim())
-                    .join(' ');
-                if (composite)
-                    display = composite;
-                else if (typeof o.email === 'string' && o.email.trim())
-                    display = o.email.trim();
-                else
-                    display = null;
-            }
-            value = display;
-        }
-        if (value === null || value === undefined || value === '') {
-            return EMPTY_TOKEN;
-        }
-        anyResolved = true;
-        return String(value);
-    });
-    if (!anyResolved)
-        return '';
-    // Drop separators on either side of an empty token, then any leftover
-    // tokens, then collapse runs of whitespace.
-    const sepBefore = new RegExp(`\\s*${SEPARATOR_CLASS}\\s*${EMPTY_TOKEN}`, 'g');
-    const sepAfter = new RegExp(`${EMPTY_TOKEN}\\s*${SEPARATOR_CLASS}\\s*`, 'g');
-    out = out
-        .replace(sepBefore, '')
-        .replace(sepAfter, '')
-        .replace(new RegExp(EMPTY_TOKEN, 'g'), '')
-        .replace(/\s+/g, ' ')
-        .trim();
-    return out;
-}
-/**
- * Get display name for a record using titleFormat or fallback
- * @param objectDef Object definition with optional titleFormat
- * @param record The record data
- * @returns Display name for the record
- */
-export function getRecordDisplayName(objectDef, record) {
-    if (objectDef?.titleFormat) {
-        const formatted = formatRecordTitle(objectDef.titleFormat, record);
-        if (formatted)
-            return formatted;
-    }
-    return (record?.name ||
-        record?.full_name ||
-        record?.fullName ||
-        record?.title ||
-        record?.label ||
-        record?.subject ||
-        record?.id ||
-        record?._id ||
-        'Untitled');
-}
+// NOTE (ADR-0079): `formatRecordTitle` (now canonically `formatTitleTemplate`)
+// and `getRecordDisplayName` moved to `@object-ui/core` and are re-exported
+// from the top of this module. The previous local copies — a titleFormat-only
+// resolver that fell back to a hard-coded `name`/`title`/… list and bottomed
+// out at the literal 'Untitled' — are gone, so every surface now also honors
+// the object's `displayNameField` + type-aware derivation + `Record #<id>`.

package/dist/utils/resolveViewId.d.ts

@@ -0,0 +1,23 @@
+/**
+ * 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.
+ */
+/**
+ * Resolve a URL-requested view name against the object's actual view ids.
+ *
+ * Canonical view ids are fully qualified (`<object>.<viewKind>`, see
+ * MetadataProvider), but nav items emit their `viewName` verbatim — usually
+ * the short form — and legacy embedded listViews carry bare keys (including
+ * the `'all'` fallback view). Accept both directions (#2217):
+ *
+ * 1. exact id match;
+ * 2. short name (no `.`) → retry as `<objectName>.<name>`;
+ * 3. qualified name → retry with the `<objectName>.` prefix stripped.
+ *
+ * Returns the matching view id, or `undefined` when nothing matches — the
+ * caller decides how to fall back (and should warn rather than swallow it).
+ */
+export declare function resolveViewId(requested: string | undefined | null, viewIds: readonly string[], objectName: string): string | undefined;

package/dist/utils/resolveViewId.js

@@ -0,0 +1,37 @@
+/**
+ * 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.
+ */
+/**
+ * Resolve a URL-requested view name against the object's actual view ids.
+ *
+ * Canonical view ids are fully qualified (`<object>.<viewKind>`, see
+ * MetadataProvider), but nav items emit their `viewName` verbatim — usually
+ * the short form — and legacy embedded listViews carry bare keys (including
+ * the `'all'` fallback view). Accept both directions (#2217):
+ *
+ * 1. exact id match;
+ * 2. short name (no `.`) → retry as `<objectName>.<name>`;
+ * 3. qualified name → retry with the `<objectName>.` prefix stripped.
+ *
+ * Returns the matching view id, or `undefined` when nothing matches — the
+ * caller decides how to fall back (and should warn rather than swallow it).
+ */
+export function resolveViewId(requested, viewIds, objectName) {
+    if (!requested)
+        return undefined;
+    const has = (id) => viewIds.includes(id);
+    if (has(requested))
+        return requested;
+    const prefix = `${objectName}.`;
+    if (!requested.includes('.') && has(prefix + requested)) {
+        return prefix + requested;
+    }
+    if (requested.startsWith(prefix) && has(requested.slice(prefix.length))) {
+        return requested.slice(prefix.length);
+    }
+    return undefined;
+}

package/dist/utils/warnSuppressedListNav.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 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.
+ */
+export declare function warnSuppressedListNav(objectName: string, viewId: string, viewDef: Record<string, unknown> | null | undefined, listSchema: Record<string, unknown> | null | undefined): boolean;
+/** Test-only: clear the one-shot warning memory. */
+export declare function resetSuppressedListNavWarnings(): void;

package/dist/utils/warnSuppressedListNav.js

@@ -0,0 +1,40 @@
+/**
+ * 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.
+ */
+/**
+ * ADR-0053: on an object's default list ("views" mode) the ViewTabBar is the
+ * only navigation control — `userFilters` / `quickFilters` belong to page
+ * lists (InterfaceListPage, "filters" mode) and are suppressed by
+ * `ObjectView.renderListView`.
+ *
+ * The suppression is correct, but until the phase-4 guardrail (zod `refine`
+ * + `check` rule) lands, an author who puts `userFilters` on an object list
+ * view gets a valid schema and a page that renders nothing where they expect
+ * filter controls — zero signal at any layer (#2219). Surface the drop with
+ * a one-shot console warning per object/view.
+ *
+ * Returns whether the view carried a suppressed field (mainly for tests).
+ */
+const warned = new Set();
+export function warnSuppressedListNav(objectName, viewId, viewDef, listSchema) {
+    const offending = ['userFilters', 'quickFilters'].filter((k) => (viewDef?.[k] ?? listSchema?.[k]) != null);
+    if (offending.length === 0)
+        return false;
+    const key = `${objectName}.${viewId}`;
+    if (!warned.has(key)) {
+        warned.add(key);
+        console.warn(`[ObjectView] View "${viewId}" on object "${objectName}" defines ` +
+            `${offending.join(' and ')}, which are ignored on an object list view ` +
+            `(ADR-0053 "views" mode — the view switcher is the only nav control here). ` +
+            `Move them to a page list (InterfaceListPage "filters" mode).`);
+    }
+    return true;
+}
+/** Test-only: clear the one-shot warning memory. */
+export function resetSuppressedListNavWarnings() {
+    warned.clear();
+}

package/dist/views/DashboardView.js

@@ -13,7 +13,7 @@ import { DrillNavigationProvider } from '@object-ui/react';
 import { useOpenRecordList } from './useOpenRecordList';
 import { ModalForm } from '@object-ui/plugin-form';
 import { DashboardConfigPanel } from './DashboardConfigPanel';
-import { useAuth } from '@object-ui/auth';
+import { useIsWorkspaceAdmin } from '@object-ui/auth';
 import { toast } from 'sonner';
 import { Empty, EmptyTitle, EmptyDescription, Button, Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter, } from '@object-ui/components';
 import { LayoutDashboard, Pencil, TrendingUp, BarChart3, LineChart, PieChart, Table2, LayoutGrid, Plus, } from 'lucide-react';
@@ -77,8 +77,7 @@ export function DashboardView({ dataSource }) {
     const { dashboardLabel, dashboardDescription } = useObjectLabel();
     // Editing a dashboard 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 [isLoading, setIsLoading] = useState(true);
     const [configPanelOpen, setConfigPanelOpen] = useState(false);
     const [selectedWidgetId, setSelectedWidgetId] = useState(null);

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') {
@@ -319,7 +321,10 @@ export function InterfaceListPage({ page, className, onConfigChange, reserveEdit
             showGroup: false,
             showColor: false,
             allowExport: false,
-            inlineEdit: false,
+            // Inline record editing is a page-authored property: a list block opts in
+            // via `userActions.editInline` (default off). When on, clicking a cell
+            // edits it with the dedicated field widgets, same as the object views.
+            inlineEdit: userActions.editInline === true,
         };
         // eslint-disable-next-line react-hooks/exhaustive-deps
     }, [objectDefName, viewDefJson, cfg]);

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,10 +34,12 @@ 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';
-import { useAuth } from '@object-ui/auth';
+import { useAuth, useIsWorkspaceAdmin } from '@object-ui/auth';
 import { useRealtimeSubscription, useConflictResolution } from '@object-ui/collaboration';
 import { ActionProvider, useNavigationOverlay, SchemaRenderer } from '@object-ui/react';
 import { toast } from 'sonner';
@@ -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)
@@ -253,7 +256,7 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
     const [recordCount, setRecordCount] = useState(undefined);
     // Admin users automatically get design tools (no toggle needed)
     const { user, activeOrganization } = useAuth();
-    const isAdmin = user?.role === 'admin';
+    const isAdmin = useIsWorkspaceAdmin();
     const { can } = usePermissions();
     // Get Object Definition. The outer ObjectView wrapper already guards the
     // missing-object case, so this always resolves while this component is
@@ -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
@@ -1302,6 +1342,8 @@ function ObjectViewInner({ dataSource, objects, onEdit, externalRefreshKey }) {
                 persistViewPatch(viewDef.id, viewDef, { filter });
             }, onHiddenFieldsChange: (hidden) => {
                 persistViewPatch(viewDef.id, viewDef, { hiddenFields: hidden });
+            }, onInlineEditChange: (next) => {
+                persistViewPatch(viewDef.id, viewDef, { inlineEdit: next });
             }, onColumnStateChange: (state) => {
                 persistViewPatch(viewDef.id, viewDef, { columnState: state });
             }, userFilterSelections: initialUfSelections, onUserFilterSelectionsChange: handleUserFilterSelectionsChange, dataSource: ds }, key));
@@ -1367,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/PageView.js

@@ -15,7 +15,7 @@ import { SchemaRenderer, useAdapter } from '@object-ui/react';
 import { Empty, EmptyTitle, EmptyDescription, Spinner } from '@object-ui/components';
 import { FileText, Pencil } from 'lucide-react';
 import { useObjectTranslation } from '@object-ui/i18n';
-import { useAuth } from '@object-ui/auth';
+import { useIsWorkspaceAdmin } from '@object-ui/auth';
 import { MetadataPanel, useMetadataInspector } from './MetadataInspector';
 import { useMetadata } from '../providers/MetadataProvider';
 import { useExpressionContext } from '../providers/ExpressionProvider';
@@ -31,8 +31,7 @@ export function PageView() {
     const location = useLocation();
     // Editing a page mutates the shared metadata definition, so the entry point
     // is admin-only (mirrors the view/report/dashboard runtime editors).
-    const { user } = useAuth();
-    const isAdmin = user?.role === 'admin';
+    const isAdmin = useIsWorkspaceAdmin();
     const { pages, objects, getTypeStatus } = useMetadata();
     // ADR-0048 Phase 2 — prefer the page owned by the current app's package so
     // two packages shipping `page/<same-name>` each resolve within their own