@terreno/admin-frontend 0.20.1 → 0.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/.ai/guidelines/core.md +10 -0
  2. package/dist/AdminBreadcrumbs.d.ts +13 -0
  3. package/dist/AdminBreadcrumbs.js +22 -0
  4. package/dist/AdminBreadcrumbs.js.map +1 -0
  5. package/dist/AdminFieldRenderer.js +3 -3
  6. package/dist/AdminFieldRenderer.js.map +1 -1
  7. package/dist/AdminFieldRendererCore.d.ts +2 -0
  8. package/dist/AdminFieldRendererCore.js +28 -18
  9. package/dist/AdminFieldRendererCore.js.map +1 -1
  10. package/dist/AdminHome.d.ts +22 -0
  11. package/dist/AdminHome.js +189 -0
  12. package/dist/AdminHome.js.map +1 -0
  13. package/dist/AdminModelForm.d.ts +24 -1
  14. package/dist/AdminModelForm.js +185 -14
  15. package/dist/AdminModelForm.js.map +1 -1
  16. package/dist/AdminModelList.d.ts +4 -0
  17. package/dist/AdminModelList.js +19 -4
  18. package/dist/AdminModelList.js.map +1 -1
  19. package/dist/AdminModelTable.d.ts +2 -27
  20. package/dist/AdminModelTable.js +316 -60
  21. package/dist/AdminModelTable.js.map +1 -1
  22. package/dist/AdminNestedArrayField.d.ts +1 -0
  23. package/dist/AdminNestedArrayField.js +26 -6
  24. package/dist/AdminNestedArrayField.js.map +1 -1
  25. package/dist/AdminObjectPicker.d.ts +1 -0
  26. package/dist/AdminObjectPicker.js +6 -2
  27. package/dist/AdminObjectPicker.js.map +1 -1
  28. package/dist/AdminPrimitiveArrayField.d.ts +1 -0
  29. package/dist/AdminPrimitiveArrayField.js +9 -8
  30. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  31. package/dist/AdminRefField.js +2 -2
  32. package/dist/AdminRefField.js.map +1 -1
  33. package/dist/AdminScriptList.js +114 -7
  34. package/dist/AdminScriptList.js.map +1 -1
  35. package/dist/AdminScriptRunModal.d.ts +5 -0
  36. package/dist/AdminScriptRunModal.js +136 -30
  37. package/dist/AdminScriptRunModal.js.map +1 -1
  38. package/dist/AdminShell.d.ts +39 -0
  39. package/dist/AdminShell.js +80 -0
  40. package/dist/AdminShell.js.map +1 -0
  41. package/dist/AdminShellLayout.d.ts +23 -0
  42. package/dist/AdminShellLayout.js +32 -0
  43. package/dist/AdminShellLayout.js.map +1 -0
  44. package/dist/AdminVersionConfig.d.ts +5 -0
  45. package/dist/AdminVersionConfig.js +15 -5
  46. package/dist/AdminVersionConfig.js.map +1 -1
  47. package/dist/ConfigurationScreen.js +3 -3
  48. package/dist/ConfigurationScreen.js.map +1 -1
  49. package/dist/ConsentFormEditor.js +2 -2
  50. package/dist/ConsentFormEditor.js.map +1 -1
  51. package/dist/ConsentFormList.js +1 -1
  52. package/dist/ConsentFormList.js.map +1 -1
  53. package/dist/ConsentResponseViewer.js +3 -3
  54. package/dist/ConsentResponseViewer.js.map +1 -1
  55. package/dist/DocumentStorageBrowser.js +1 -1
  56. package/dist/DocumentStorageBrowser.js.map +1 -1
  57. package/dist/adminModelListQueryParams.d.ts +14 -0
  58. package/dist/adminModelListQueryParams.js +51 -0
  59. package/dist/adminModelListQueryParams.js.map +1 -0
  60. package/dist/adminShellNav.d.ts +10 -0
  61. package/dist/adminShellNav.js +29 -0
  62. package/dist/adminShellNav.js.map +1 -0
  63. package/dist/index.d.ts +6 -1
  64. package/dist/index.js +5 -0
  65. package/dist/index.js.map +1 -1
  66. package/dist/scriptRunUtils.d.ts +36 -0
  67. package/dist/scriptRunUtils.js +121 -0
  68. package/dist/scriptRunUtils.js.map +1 -0
  69. package/dist/types.d.ts +70 -0
  70. package/dist/types.js.map +1 -1
  71. package/dist/useAdminApi.d.ts +1 -0
  72. package/dist/useAdminApi.js +11 -0
  73. package/dist/useAdminApi.js.map +1 -1
  74. package/dist/useAdminBackgroundTask.d.ts +12 -0
  75. package/dist/useAdminBackgroundTask.js +26 -0
  76. package/dist/useAdminBackgroundTask.js.map +1 -0
  77. package/dist/useAdminScripts.d.ts +19 -1
  78. package/dist/useAdminScripts.js +33 -4
  79. package/dist/useAdminScripts.js.map +1 -1
  80. package/package.json +4 -3
  81. package/src/AdminBreadcrumbs.test.tsx +27 -0
  82. package/src/AdminBreadcrumbs.tsx +63 -0
  83. package/src/AdminFieldRenderer.tsx +3 -0
  84. package/src/AdminFieldRendererCore.tsx +59 -1
  85. package/src/AdminHome.test.tsx +208 -0
  86. package/src/AdminHome.tsx +474 -0
  87. package/src/AdminModelForm.test.tsx +81 -1
  88. package/src/AdminModelForm.tsx +282 -34
  89. package/src/AdminModelList.test.tsx +1 -1
  90. package/src/AdminModelList.tsx +72 -39
  91. package/src/AdminModelTable.test.tsx +11 -0
  92. package/src/AdminModelTable.tsx +530 -92
  93. package/src/AdminNestedArrayField.tsx +59 -9
  94. package/src/AdminObjectPicker.tsx +19 -1
  95. package/src/AdminPrimitiveArrayField.tsx +30 -15
  96. package/src/AdminRefField.tsx +2 -0
  97. package/src/AdminScriptList.tsx +307 -30
  98. package/src/AdminScriptRunModal.tsx +410 -95
  99. package/src/AdminShell.tsx +296 -0
  100. package/src/AdminShellLayout.tsx +34 -0
  101. package/src/AdminVersionConfig.tsx +120 -76
  102. package/src/ConfigurationScreen.tsx +4 -2
  103. package/src/ConsentFormEditor.tsx +3 -1
  104. package/src/ConsentFormList.tsx +1 -1
  105. package/src/ConsentResponseViewer.tsx +3 -3
  106. package/src/DocumentStorageBrowser.tsx +1 -1
  107. package/src/adminModelListQueryParams.ts +61 -0
  108. package/src/adminShellNav.test.ts +29 -0
  109. package/src/adminShellNav.ts +33 -0
  110. package/src/index.tsx +6 -1
  111. package/src/isolated/AdminScriptRunModal.isolated.tsx +152 -1
  112. package/src/scriptRunUtils.test.ts +146 -0
  113. package/src/scriptRunUtils.ts +149 -0
  114. package/src/types.ts +69 -0
  115. package/src/useAdminApi.ts +11 -0
  116. package/src/useAdminBackgroundTask.ts +40 -0
  117. package/src/useAdminScripts.ts +56 -5
@@ -0,0 +1,474 @@
1
+ import {
2
+ Box,
3
+ Button,
4
+ Card,
5
+ Heading,
6
+ IconButton,
7
+ Page,
8
+ printDateAndTime,
9
+ Spinner,
10
+ Text,
11
+ } from "@terreno/ui";
12
+ import type {Href} from "expo-router";
13
+ import {router} from "expo-router";
14
+ import React, {useCallback, useMemo} from "react";
15
+ import {AdminVersionConfig} from "./AdminVersionConfig";
16
+ import type {AdminApi, AdminFieldValue, AdminModelConfig} from "./types";
17
+ import {resolveAdminBases} from "./types";
18
+ import {useAdminApi} from "./useAdminApi";
19
+ import {useAdminConfig} from "./useAdminConfig";
20
+
21
+ const BUILTIN_WIDGET_IDS = new Set([
22
+ "modelStats",
23
+ "modelsGrid",
24
+ "feature-flags-overrides",
25
+ "versionConfig",
26
+ "scriptRunner",
27
+ "recentActivity",
28
+ ]);
29
+
30
+ const normalizeWidgetIds = (ids: string[] | undefined): string[] => {
31
+ if (!ids?.length) {
32
+ return [];
33
+ }
34
+ const out: string[] = [];
35
+ const seen = new Set<string>();
36
+ for (const id of ids) {
37
+ const normalized = id === "modelStats" ? "modelsGrid" : id;
38
+ if (seen.has(normalized)) {
39
+ continue;
40
+ }
41
+ seen.add(normalized);
42
+ out.push(normalized);
43
+ }
44
+ return out;
45
+ };
46
+
47
+ const normalizeSidebarWidgets = (ids: string[] | undefined): string[] => {
48
+ const normalized = normalizeWidgetIds(ids);
49
+ if (!normalized.length) {
50
+ return normalized;
51
+ }
52
+ const tail = "recentActivity";
53
+ const without = normalized.filter((id) => id !== tail);
54
+ if (normalized.includes(tail)) {
55
+ return [...without, tail];
56
+ }
57
+ return normalized;
58
+ };
59
+
60
+ const warnUnknownWidget = (widgetId: string): void => {
61
+ if (BUILTIN_WIDGET_IDS.has(widgetId)) {
62
+ return;
63
+ }
64
+ if (typeof __DEV__ !== "undefined" && __DEV__) {
65
+ console.warn(
66
+ `[AdminHome] Unknown home widget id "${widgetId}". Register a built-in or remove it from admin config.`
67
+ );
68
+ }
69
+ };
70
+
71
+ interface AdminHomeProps {
72
+ /** @deprecated Use `apiBase`/`routeBase`. */
73
+ baseUrl?: string;
74
+ apiBase?: string;
75
+ routeBase?: string;
76
+ api: AdminApi;
77
+ /**
78
+ * When true, omits the outer {@link Page} wrapper so the dashboard can sit under a parent
79
+ * screen (for example, the Expo admin index together with tools and model cards).
80
+ */
81
+ embedded?: boolean;
82
+ }
83
+
84
+ const ModelGridCard: React.FC<{
85
+ api: AdminApi;
86
+ model: AdminModelConfig;
87
+ routeBase: string;
88
+ }> = ({api, model, routeBase}) => {
89
+ const {useListQuery} = useAdminApi(api, model.routePath, model.name);
90
+ const {data, isLoading} = useListQuery({limit: 1, page: 1}, {skip: !model.routePath});
91
+ const total = (data as {total?: number} | undefined)?.total;
92
+ const fieldCount = Object.keys(model.fields).length;
93
+ const createEnabled = model.permissions?.create !== false;
94
+
95
+ const onOpen = useCallback((): void => {
96
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
97
+ const href = `${prefix}/${model.name}` as Href;
98
+ router.push(href);
99
+ }, [routeBase, model.name]);
100
+
101
+ const onCreate = useCallback((): void => {
102
+ if (!createEnabled) {
103
+ return;
104
+ }
105
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
106
+ router.push(`${prefix}/${model.name}/create` as Href);
107
+ }, [createEnabled, routeBase, model.name]);
108
+
109
+ return (
110
+ <Box
111
+ accessibilityHint={`Open ${model.displayName} admin`}
112
+ accessibilityLabel={model.displayName}
113
+ border="default"
114
+ padding={3}
115
+ rounding="md"
116
+ width={220}
117
+ >
118
+ <Box alignItems="start" direction="row" gap={2} justifyContent="between">
119
+ <Box
120
+ accessibilityHint={`View ${model.displayName} list`}
121
+ accessibilityLabel={model.displayName}
122
+ flex="grow"
123
+ minWidth={0}
124
+ onClick={onOpen}
125
+ testID={`admin-home-models-grid-${model.name}`}
126
+ >
127
+ <Text bold>{model.displayName}</Text>
128
+ <Text color="secondaryDark" size="sm">
129
+ {`${fieldCount} fields`}
130
+ </Text>
131
+ <Box marginTop={1}>
132
+ {isLoading ? (
133
+ <Spinner />
134
+ ) : (
135
+ <Text
136
+ color="secondaryDark"
137
+ size="sm"
138
+ testID={`admin-home-model-count-${model.name}`}
139
+ >{`${total != null ? total : "—"} rows`}</Text>
140
+ )}
141
+ </Box>
142
+ </Box>
143
+ {createEnabled ? (
144
+ <IconButton
145
+ accessibilityHint={`Create new ${model.displayName}`}
146
+ accessibilityLabel={`Add ${model.displayName}`}
147
+ iconName="plus"
148
+ onClick={onCreate}
149
+ testID={`admin-home-model-add-${model.name}`}
150
+ tooltipText="Add new"
151
+ variant="secondary"
152
+ />
153
+ ) : null}
154
+ </Box>
155
+ </Box>
156
+ );
157
+ };
158
+
159
+ const ModelsGridWidget: React.FC<{
160
+ api: AdminApi;
161
+ models: AdminModelConfig[];
162
+ routeBase: string;
163
+ }> = ({api, models, routeBase}) => {
164
+ return (
165
+ <Card padding={4} testID="admin-home-widget-modelsGrid">
166
+ <Heading size="sm">Models</Heading>
167
+ <Box direction="row" gap={3} marginTop={2} wrap>
168
+ {models.map((m) => (
169
+ <ModelGridCard api={api} key={m.name} model={m} routeBase={routeBase} />
170
+ ))}
171
+ </Box>
172
+ </Card>
173
+ );
174
+ };
175
+
176
+ const FeatureFlagsOverridesWidget: React.FC<{
177
+ model?: AdminModelConfig;
178
+ routeBase: string;
179
+ }> = ({model, routeBase}) => {
180
+ const onOpen = useCallback((): void => {
181
+ if (!model) {
182
+ return;
183
+ }
184
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
185
+ router.push(`${prefix}/${model.name}` as Href);
186
+ }, [routeBase, model]);
187
+
188
+ return (
189
+ <Card padding={4} testID="admin-home-widget-feature-flags-overrides">
190
+ <Heading size="sm">Feature flags</Heading>
191
+ {model ? (
192
+ <Box marginTop={2}>
193
+ <Text color="secondaryDark" size="sm">
194
+ Quick access to feature flag records.
195
+ </Text>
196
+ <Box marginTop={2}>
197
+ <Button onClick={onOpen} text={`Open ${model.displayName}`} variant="outline" />
198
+ </Box>
199
+ </Box>
200
+ ) : (
201
+ <Box marginTop={2}>
202
+ <Text color="secondaryDark" size="sm">
203
+ No FeatureFlag model is registered in this admin config.
204
+ </Text>
205
+ </Box>
206
+ )}
207
+ </Card>
208
+ );
209
+ };
210
+
211
+ const RecentActivityWidget: React.FC<{
212
+ api: AdminApi;
213
+ auditModel?: AdminModelConfig;
214
+ }> = ({api, auditModel}) => {
215
+ const {useListQuery} = useAdminApi(api, auditModel?.routePath ?? "", auditModel?.name ?? "");
216
+ const {data, isLoading, isError} = useListQuery(
217
+ {limit: 8, page: 1, sort: "-createdAt"},
218
+ {skip: !auditModel?.routePath}
219
+ );
220
+
221
+ const rows = useMemo((): Record<string, AdminFieldValue>[] => {
222
+ const body = data as {data?: Record<string, AdminFieldValue>[]} | undefined;
223
+ return Array.isArray(body?.data) ? body.data : [];
224
+ }, [data]);
225
+
226
+ if (!auditModel) {
227
+ return (
228
+ <Card padding={4} testID="admin-home-widget-recentActivity">
229
+ <Heading size="sm">Recent activity</Heading>
230
+ <Box marginTop={2}>
231
+ <Text color="secondaryDark" size="sm">
232
+ Register an AdminAuditLog model to show recent mutations here.
233
+ </Text>
234
+ </Box>
235
+ </Card>
236
+ );
237
+ }
238
+
239
+ return (
240
+ <Card padding={4} testID="admin-home-widget-recentActivity">
241
+ <Heading size="sm">Recent activity</Heading>
242
+ {isLoading ? (
243
+ <Box alignItems="center" marginTop={3} padding={2}>
244
+ <Spinner />
245
+ </Box>
246
+ ) : null}
247
+ {isError ? (
248
+ <Box marginTop={2}>
249
+ <Text color="error" size="sm">
250
+ Could not load audit entries.
251
+ </Text>
252
+ </Box>
253
+ ) : null}
254
+ {!isLoading && !isError && rows.length === 0 ? (
255
+ <Box marginTop={2}>
256
+ <Text color="secondaryDark" size="sm">
257
+ No audit entries yet.
258
+ </Text>
259
+ </Box>
260
+ ) : null}
261
+ {!isLoading && !isError && rows.length > 0 ? (
262
+ <Box gap={2} marginTop={2}>
263
+ {rows.map((row) => {
264
+ const id = String(row._id ?? row.id ?? "");
265
+ const verb = String(row.verb ?? "");
266
+ const modelName = String(row.modelName ?? "");
267
+ const label = String(row.recordLabel ?? row.recordId ?? "");
268
+ const created = row.createdAt ?? row.created;
269
+ const when =
270
+ typeof created === "string" ? printDateAndTime(created, {defaultValue: created}) : "";
271
+ return (
272
+ <Box border="default" key={id || `${verb}-${label}`} padding={2} rounding="sm">
273
+ <Text size="sm">
274
+ <Text bold>{verb}</Text> {modelName}
275
+ {label ? ` — ${label}` : ""}
276
+ </Text>
277
+ {when ? (
278
+ <Text color="secondaryDark" size="sm">
279
+ {when}
280
+ </Text>
281
+ ) : null}
282
+ </Box>
283
+ );
284
+ })}
285
+ </Box>
286
+ ) : null}
287
+ </Card>
288
+ );
289
+ };
290
+
291
+ const ScriptRunnerWidget: React.FC<{routeBase: string}> = ({routeBase}) => {
292
+ const onScripts = useCallback((): void => {
293
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
294
+ router.push(`${prefix}/__scripts` as Href);
295
+ }, [routeBase]);
296
+
297
+ return (
298
+ <Card padding={4} testID="admin-home-widget-scriptRunner">
299
+ <Heading size="sm">Scripts</Heading>
300
+ <Box marginTop={1}>
301
+ <Text color="secondaryDark" size="sm">
302
+ Run registered admin maintenance scripts.
303
+ </Text>
304
+ </Box>
305
+ <Box marginTop={2}>
306
+ <Button onClick={onScripts} text="Open scripts" variant="primary" />
307
+ </Box>
308
+ </Card>
309
+ );
310
+ };
311
+
312
+ const renderWidget = (params: {
313
+ api: AdminApi;
314
+ apiBase: string;
315
+ routeBase: string;
316
+ widgetId: string;
317
+ models: AdminModelConfig[];
318
+ auditModel?: AdminModelConfig;
319
+ featureFlagModel?: AdminModelConfig;
320
+ }): React.ReactNode => {
321
+ const {api, apiBase, routeBase, widgetId, models, auditModel, featureFlagModel} = params;
322
+ warnUnknownWidget(widgetId);
323
+ switch (widgetId) {
324
+ case "modelStats":
325
+ return <ModelsGridWidget api={api} models={models} routeBase={routeBase} />;
326
+ case "modelsGrid":
327
+ return <ModelsGridWidget api={api} models={models} routeBase={routeBase} />;
328
+ case "feature-flags-overrides":
329
+ return <FeatureFlagsOverridesWidget model={featureFlagModel} routeBase={routeBase} />;
330
+ case "versionConfig":
331
+ return <AdminVersionConfig api={api} apiBase={apiBase} embedded routeBase={routeBase} />;
332
+ case "scriptRunner":
333
+ return <ScriptRunnerWidget routeBase={routeBase} />;
334
+ case "recentActivity":
335
+ return <RecentActivityWidget api={api} auditModel={auditModel} />;
336
+ default:
337
+ return null;
338
+ }
339
+ };
340
+
341
+ /**
342
+ * Config-driven admin home dashboard: renders `home.slots` from `/admin/config` with built-in
343
+ * widgets (model grid with counts, scripts, version config, audit recent activity).
344
+ * `navGlobal` and `contentTop` widget ids render together in one top row (same flex line, wrapping
345
+ * as needed) so strips like scripts + feature flags stay side by side.
346
+ */
347
+ export const AdminHome: React.FC<AdminHomeProps> = ({
348
+ baseUrl,
349
+ apiBase,
350
+ routeBase,
351
+ api,
352
+ embedded = false,
353
+ }) => {
354
+ const {apiBase: resolvedApiBase, routeBase: resolvedRouteBase} = resolveAdminBases({
355
+ apiBase,
356
+ baseUrl,
357
+ routeBase,
358
+ });
359
+ const {config, error, isLoading} = useAdminConfig(api, resolvedApiBase);
360
+
361
+ const models = (config?.models ?? []) as AdminModelConfig[];
362
+ const auditModel = useMemo(
363
+ () => models.find((m) => m.name === "AdminAuditLog" || m.routePath.includes("audit-log")),
364
+ [models]
365
+ );
366
+ const featureFlagModel = useMemo(
367
+ () => models.find((m) => m.name === "FeatureFlag" || m.displayName === "Feature Flags"),
368
+ [models]
369
+ );
370
+
371
+ const slots = config?.home?.slots;
372
+ const navGlobal = normalizeWidgetIds(slots?.navGlobal);
373
+ const contentTop = normalizeWidgetIds(slots?.contentTop);
374
+ /** Shown in one horizontal band so scripts, feature flags, etc. align on the same row. */
375
+ const topBandWidgetIds = useMemo(() => [...navGlobal, ...contentTop], [navGlobal, contentTop]);
376
+ const main = normalizeWidgetIds(slots?.main);
377
+ const sidebar = normalizeSidebarWidgets(slots?.sidebar);
378
+
379
+ if (isLoading) {
380
+ const loadingBody = (
381
+ <Box alignItems="center" justifyContent="center" padding={6} testID="admin-home-loading">
382
+ <Spinner />
383
+ </Box>
384
+ );
385
+ if (embedded) {
386
+ return loadingBody;
387
+ }
388
+ return (
389
+ <Page color="transparent" maxWidth="100%" padding={0} title={config?.home?.title ?? "Admin"}>
390
+ {loadingBody}
391
+ </Page>
392
+ );
393
+ }
394
+
395
+ if (error || !config) {
396
+ const errorBody = (
397
+ <Box padding={4} testID="admin-home-error">
398
+ <Text color="error">Failed to load admin configuration.</Text>
399
+ </Box>
400
+ );
401
+ if (embedded) {
402
+ return errorBody;
403
+ }
404
+ return (
405
+ <Page color="transparent" maxWidth="100%" padding={0} title="Admin">
406
+ {errorBody}
407
+ </Page>
408
+ );
409
+ }
410
+
411
+ const title = config.home?.title ?? "Admin";
412
+
413
+ const widgetParams = {
414
+ api,
415
+ apiBase: resolvedApiBase,
416
+ auditModel,
417
+ featureFlagModel,
418
+ models,
419
+ routeBase: resolvedRouteBase,
420
+ };
421
+
422
+ const dashboardBody = (
423
+ <Box gap={4} padding={0} width="100%">
424
+ {!embedded ? <Heading size="md">{title}</Heading> : null}
425
+
426
+ {topBandWidgetIds.length > 0 ? (
427
+ <Box direction="row" gap={3} testID="admin-home-slot-top" wrap>
428
+ {topBandWidgetIds.map((id) => (
429
+ <Box key={`top-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
430
+ ))}
431
+ </Box>
432
+ ) : null}
433
+
434
+ <Box alignItems="start" direction={embedded ? "column" : "row"} gap={4}>
435
+ {main.length > 0 ? (
436
+ <Box
437
+ flex="grow"
438
+ gap={3}
439
+ minWidth={embedded ? 0 : 280}
440
+ testID="admin-home-slot-main"
441
+ {...(embedded ? {width: "100%"} : {})}
442
+ >
443
+ {main.map((id) => (
444
+ <Box key={`mn-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
445
+ ))}
446
+ </Box>
447
+ ) : null}
448
+ {sidebar.length > 0 ? (
449
+ <Box
450
+ direction="column"
451
+ gap={3}
452
+ minWidth={embedded ? 0 : 280}
453
+ testID="admin-home-slot-sidebar"
454
+ width={embedded ? "100%" : 320}
455
+ >
456
+ {sidebar.map((id) => (
457
+ <Box key={`sb-${id}`}>{renderWidget({...widgetParams, widgetId: id})}</Box>
458
+ ))}
459
+ </Box>
460
+ ) : null}
461
+ </Box>
462
+ </Box>
463
+ );
464
+
465
+ if (embedded) {
466
+ return dashboardBody;
467
+ }
468
+
469
+ return (
470
+ <Page color="transparent" maxWidth="100%" padding={0} scroll title={title}>
471
+ {dashboardBody}
472
+ </Page>
473
+ );
474
+ };
@@ -124,7 +124,11 @@ describe("AdminModelForm", () => {
124
124
  />
125
125
  );
126
126
  expect(toJSON()).toBeDefined();
127
- expect(setOptions).toHaveBeenCalled();
127
+ expect(setOptions).toHaveBeenCalledWith(
128
+ expect.objectContaining({
129
+ title: "New User",
130
+ })
131
+ );
128
132
  });
129
133
 
130
134
  it("renders spinner during edit when the item is loading", () => {
@@ -140,6 +144,7 @@ describe("AdminModelForm", () => {
140
144
  />
141
145
  );
142
146
  expect(toJSON()).toBeDefined();
147
+ expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "User"}));
143
148
  });
144
149
 
145
150
  it("initializes form state from fetched item data in edit mode", () => {
@@ -160,6 +165,39 @@ describe("AdminModelForm", () => {
160
165
  />
161
166
  );
162
167
  expect(toJSON()).toBeDefined();
168
+ expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "Existing"}));
169
+ });
170
+
171
+ it("uses recordTitleField from model config for the navigation title", () => {
172
+ configState.config = {
173
+ ...config,
174
+ models: [
175
+ {
176
+ ...modelConfig,
177
+ fieldOrder: ["email", "name"],
178
+ fields: {
179
+ email: {required: false, type: "string"},
180
+ name: {required: false, type: "string"},
181
+ },
182
+ recordTitleField: "email",
183
+ },
184
+ ],
185
+ };
186
+ readState.data = {
187
+ email: "pick@me.com",
188
+ name: "Other",
189
+ };
190
+ const {toJSON} = renderWithTheme(
191
+ <AdminModelForm
192
+ api={{} as unknown as AdminApi}
193
+ baseUrl="/admin"
194
+ itemId="u1"
195
+ mode="edit"
196
+ modelName="User"
197
+ />
198
+ );
199
+ expect(toJSON()).toBeDefined();
200
+ expect(setOptions).toHaveBeenCalledWith(expect.objectContaining({title: "pick@me.com"}));
163
201
  });
164
202
 
165
203
  it("renders 'No editable fields' when the model has only system fields", () => {
@@ -618,6 +656,48 @@ describe("AdminModelForm", () => {
618
656
  expect(routerBack).not.toHaveBeenCalled();
619
657
  });
620
658
 
659
+ it("excludes readonly fields from the PATCH body on save", async () => {
660
+ configState.config = {
661
+ ...config,
662
+ models: [
663
+ {
664
+ ...modelConfig,
665
+ fieldOrder: ["email", "name"],
666
+ fields: {
667
+ email: {required: false, type: "string"},
668
+ name: {required: false, type: "string"},
669
+ },
670
+ readonlyFields: ["email"],
671
+ },
672
+ ],
673
+ };
674
+ readState.data = {email: "locked@x.com", name: "N"};
675
+ let savedHeaderRight: React.ReactElement | null = null;
676
+ setOptions.mockImplementation((opts: Record<string, unknown>) => {
677
+ if (opts?.headerRight) {
678
+ savedHeaderRight = opts.headerRight();
679
+ }
680
+ });
681
+ renderWithTheme(
682
+ <AdminModelForm
683
+ api={{} as unknown as AdminApi}
684
+ baseUrl="/admin"
685
+ itemId="u1"
686
+ mode="edit"
687
+ modelName="User"
688
+ />
689
+ );
690
+ const header = renderWithTheme(savedHeaderRight as unknown as React.ReactElement);
691
+ await act(async () => {
692
+ fireEvent.press(header.getByTestId("admin-save-button"));
693
+ await new Promise((r) => setTimeout(r, 600));
694
+ });
695
+ expect(updateFn).toHaveBeenCalled();
696
+ const arg = updateFn.mock.calls[0][0] as {body: Record<string, unknown>; id: string};
697
+ expect(arg.body.email).toBeUndefined();
698
+ expect(arg.body.name).toBeDefined();
699
+ });
700
+
621
701
  it("updates an existing item in edit mode", async () => {
622
702
  configState.config = config;
623
703
  readState.data = {active: true, age: 1, email: "e@x.com", name: "Name"};