@terreno/admin-frontend 57.0.0 → 57.2.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 (158) hide show
  1. package/dist/AdminActionMenu.d.ts +15 -0
  2. package/dist/AdminActionMenu.js +56 -0
  3. package/dist/AdminActionMenu.js.map +1 -0
  4. package/dist/AdminFieldRenderer.js +2 -2
  5. package/dist/AdminFieldRenderer.js.map +1 -1
  6. package/dist/AdminFieldRendererCore.d.ts +2 -0
  7. package/dist/AdminFieldRendererCore.js +18 -47
  8. package/dist/AdminFieldRendererCore.js.map +1 -1
  9. package/dist/AdminFilterDrawer.d.ts +20 -0
  10. package/dist/AdminFilterDrawer.js +117 -0
  11. package/dist/AdminFilterDrawer.js.map +1 -0
  12. package/dist/AdminHome.d.ts +2 -4
  13. package/dist/AdminHome.js +15 -137
  14. package/dist/AdminHome.js.map +1 -1
  15. package/dist/AdminModelForm.js +29 -10
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +5 -1
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +56 -98
  21. package/dist/AdminModelTable.js.map +1 -1
  22. package/dist/AdminObjectPicker.d.ts +3 -0
  23. package/dist/AdminObjectPicker.js +27 -7
  24. package/dist/AdminObjectPicker.js.map +1 -1
  25. package/dist/AdminPrimitiveArrayField.d.ts +2 -0
  26. package/dist/AdminPrimitiveArrayField.js +3 -3
  27. package/dist/AdminPrimitiveArrayField.js.map +1 -1
  28. package/dist/AdminProvider.d.ts +16 -0
  29. package/dist/AdminProvider.js +84 -0
  30. package/dist/AdminProvider.js.map +1 -0
  31. package/dist/AdminRefField.js +2 -2
  32. package/dist/AdminRefField.js.map +1 -1
  33. package/dist/AdminRolesField.d.ts +9 -0
  34. package/dist/AdminRolesField.js +45 -0
  35. package/dist/AdminRolesField.js.map +1 -0
  36. package/dist/AdminRolesList.d.ts +3 -0
  37. package/dist/AdminRolesList.js +187 -0
  38. package/dist/AdminRolesList.js.map +1 -0
  39. package/dist/AdminScreenRouter.d.ts +13 -0
  40. package/dist/AdminScreenRouter.js +52 -0
  41. package/dist/AdminScreenRouter.js.map +1 -0
  42. package/dist/AdminScriptList.js +12 -10
  43. package/dist/AdminScriptList.js.map +1 -1
  44. package/dist/AdminShell.d.ts +2 -0
  45. package/dist/AdminShell.js +68 -21
  46. package/dist/AdminShell.js.map +1 -1
  47. package/dist/Constants.d.ts +4 -0
  48. package/dist/Constants.js +5 -0
  49. package/dist/Constants.js.map +1 -0
  50. package/dist/adminModelListQueryParams.d.ts +4 -0
  51. package/dist/adminModelListQueryParams.js +38 -3
  52. package/dist/adminModelListQueryParams.js.map +1 -1
  53. package/dist/adminPageAccess.d.ts +5 -0
  54. package/dist/adminPageAccess.js +19 -0
  55. package/dist/adminPageAccess.js.map +1 -0
  56. package/dist/index.d.ts +20 -1
  57. package/dist/index.js +18 -0
  58. package/dist/index.js.map +1 -1
  59. package/dist/types.d.ts +74 -0
  60. package/dist/types.js.map +1 -1
  61. package/dist/useAdminRoles.d.ts +65 -0
  62. package/dist/useAdminRoles.js +84 -0
  63. package/dist/useAdminRoles.js.map +1 -0
  64. package/dist/useDocumentStorageApi.js +2 -2
  65. package/dist/useDocumentStorageApi.js.map +1 -1
  66. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  67. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  68. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  69. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  70. package/dist/widgets/CustomScreensListWidget.js +21 -0
  71. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  72. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  73. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  74. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  75. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  76. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  77. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  78. package/dist/widgets/MissingWidget.d.ts +7 -0
  79. package/dist/widgets/MissingWidget.js +6 -0
  80. package/dist/widgets/MissingWidget.js.map +1 -0
  81. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  82. package/dist/widgets/ModelsGridWidget.js +30 -0
  83. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  84. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  85. package/dist/widgets/RecentActivityWidget.js +27 -0
  86. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  87. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  88. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  89. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  90. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  91. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  92. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  93. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  94. package/dist/widgets/VersionConfigWidget.js +7 -0
  95. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  96. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  97. package/dist/widgets/builtInFieldWidgets.js +61 -0
  98. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  99. package/dist/widgets/builtInWidgets.d.ts +6 -0
  100. package/dist/widgets/builtInWidgets.js +31 -0
  101. package/dist/widgets/builtInWidgets.js.map +1 -0
  102. package/dist/widgets/consentWidgets.d.ts +3 -0
  103. package/dist/widgets/consentWidgets.js +8 -0
  104. package/dist/widgets/consentWidgets.js.map +1 -0
  105. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  106. package/dist/widgets/homeWidgetUtils.js +37 -0
  107. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  108. package/package.json +3 -2
  109. package/src/AdminActionMenu.test.tsx +78 -0
  110. package/src/AdminActionMenu.tsx +106 -0
  111. package/src/AdminFieldRenderer.tsx +2 -0
  112. package/src/AdminFieldRendererCore.tsx +54 -133
  113. package/src/AdminFilterDrawer.test.tsx +89 -0
  114. package/src/AdminFilterDrawer.tsx +333 -0
  115. package/src/AdminHome.tsx +38 -325
  116. package/src/AdminModelForm.test.tsx +78 -0
  117. package/src/AdminModelForm.tsx +49 -10
  118. package/src/AdminModelList.tsx +7 -2
  119. package/src/AdminModelTable.test.tsx +73 -0
  120. package/src/AdminModelTable.tsx +108 -195
  121. package/src/AdminObjectPicker.tsx +49 -9
  122. package/src/AdminPrimitiveArrayField.tsx +5 -0
  123. package/src/AdminProvider.test.tsx +25 -0
  124. package/src/AdminProvider.tsx +121 -0
  125. package/src/AdminRefField.tsx +4 -0
  126. package/src/AdminRolesField.tsx +129 -0
  127. package/src/AdminRolesList.test.tsx +339 -0
  128. package/src/AdminRolesList.tsx +434 -0
  129. package/src/AdminScreenRouter.test.tsx +112 -0
  130. package/src/AdminScreenRouter.tsx +104 -0
  131. package/src/AdminScriptList.tsx +42 -30
  132. package/src/AdminShell.test.tsx +196 -1
  133. package/src/AdminShell.tsx +166 -69
  134. package/src/Constants.ts +5 -0
  135. package/src/adminModelListQueryParams.test.ts +69 -0
  136. package/src/adminModelListQueryParams.ts +49 -3
  137. package/src/adminPageAccess.test.ts +18 -0
  138. package/src/adminPageAccess.ts +18 -0
  139. package/src/index.tsx +51 -0
  140. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  141. package/src/types.ts +79 -0
  142. package/src/useAdminRoles.ts +146 -0
  143. package/src/useDocumentStorageApi.ts +2 -2
  144. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  145. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  146. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  147. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  148. package/src/widgets/MissingWidget.tsx +17 -0
  149. package/src/widgets/ModelsGridWidget.tsx +94 -0
  150. package/src/widgets/RecentActivityWidget.tsx +81 -0
  151. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  152. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  153. package/src/widgets/VersionConfigWidget.tsx +7 -0
  154. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  155. package/src/widgets/builtInWidgets.ts +51 -0
  156. package/src/widgets/consentWidgets.ts +13 -0
  157. package/src/widgets/homeWidgetUtils.ts +38 -0
  158. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -0,0 +1,56 @@
1
+ import {Box, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminCustomScreen, AdminHomeWidgetProps} from "../types";
6
+
7
+ const CustomScreenCard: React.FC<{
8
+ onPress: () => void;
9
+ screen: AdminCustomScreen;
10
+ }> = ({onPress, screen}) => (
11
+ <Card padding={4} testID={`admin-custom-screen-card-${screen.name}`}>
12
+ <Box
13
+ accessibilityHint={`Navigate to ${screen.displayName}`}
14
+ accessibilityLabel={screen.displayName}
15
+ gap={2}
16
+ onClick={onPress}
17
+ width={240}
18
+ >
19
+ <Heading size="md">{screen.displayName}</Heading>
20
+ <Text color="secondaryDark" size="sm">
21
+ {screen.description ?? "Custom screen"}
22
+ </Text>
23
+ </Box>
24
+ </Card>
25
+ );
26
+
27
+ /** Lists custom admin screens from config as navigable cards (tools section). */
28
+ export const CustomScreensListWidget: React.FC<AdminHomeWidgetProps> = ({config, routeBase}) => {
29
+ const screens = config.customScreens ?? [];
30
+
31
+ const onPress = useCallback(
32
+ (screenName: string): void => {
33
+ router.push(`${routeBase}/${screenName}` as Href);
34
+ },
35
+ [routeBase]
36
+ );
37
+
38
+ if (screens.length === 0) {
39
+ return null;
40
+ }
41
+
42
+ return (
43
+ <Box gap={2} testID="admin-home-widget-customScreens" width="100%">
44
+ <Heading size="sm">Screens</Heading>
45
+ <Box direction="row" gap={4} wrap>
46
+ {screens.map((screen) => (
47
+ <CustomScreenCard
48
+ key={screen.name}
49
+ onPress={() => onPress(screen.name)}
50
+ screen={screen}
51
+ />
52
+ ))}
53
+ </Box>
54
+ </Box>
55
+ );
56
+ };
@@ -0,0 +1,11 @@
1
+ import React from "react";
2
+ import {DocumentStorageBrowser} from "../DocumentStorageBrowser";
3
+ import type {AdminScreenWidgetProps, ScreenWidgetComponent} from "../types";
4
+
5
+ export const DocumentsScreenWidget: React.FC<AdminScreenWidgetProps> = ({api}) => {
6
+ return <DocumentStorageBrowser api={api} basePath="/documents" title="Documents" />;
7
+ };
8
+
9
+ export const DOCUMENT_STORAGE_ADMIN_WIDGETS: Record<string, ScreenWidgetComponent> = {
10
+ documents: DocumentsScreenWidget,
11
+ };
@@ -0,0 +1,48 @@
1
+ import {Box, Button, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps, HomeWidgetComponent} from "../types";
6
+
7
+ export const FeatureFlagsOverridesWidget: React.FC<AdminHomeWidgetProps> = ({
8
+ featureFlagModel,
9
+ routeBase,
10
+ }) => {
11
+ const onOpen = useCallback((): void => {
12
+ if (!featureFlagModel) {
13
+ return;
14
+ }
15
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
16
+ router.push(`${prefix}/${featureFlagModel.name}` as Href);
17
+ }, [routeBase, featureFlagModel]);
18
+
19
+ return (
20
+ <Card padding={4} testID="admin-home-widget-feature-flags-overrides">
21
+ <Heading size="sm">Feature flags</Heading>
22
+ {featureFlagModel ? (
23
+ <Box marginTop={2}>
24
+ <Text color="secondaryDark" size="sm">
25
+ Quick access to feature flag records.
26
+ </Text>
27
+ <Box marginTop={2}>
28
+ <Button
29
+ onClick={onOpen}
30
+ text={`Open ${featureFlagModel.displayName}`}
31
+ variant="outline"
32
+ />
33
+ </Box>
34
+ </Box>
35
+ ) : (
36
+ <Box marginTop={2}>
37
+ <Text color="secondaryDark" size="sm">
38
+ No FeatureFlag model is registered in this admin config.
39
+ </Text>
40
+ </Box>
41
+ )}
42
+ </Card>
43
+ );
44
+ };
45
+
46
+ export const FEATURE_FLAGS_ADMIN_WIDGETS: Record<string, HomeWidgetComponent> = {
47
+ "feature-flags-overrides": FeatureFlagsOverridesWidget,
48
+ };
@@ -0,0 +1,17 @@
1
+ import {Box, Text} from "@terreno/ui";
2
+ import React from "react";
3
+
4
+ interface MissingWidgetProps {
5
+ bucket: "fields" | "home" | "screens";
6
+ widgetId: string;
7
+ }
8
+
9
+ export const MissingWidget: React.FC<MissingWidgetProps> = ({bucket, widgetId}) => {
10
+ return (
11
+ <Box border="default" padding={3} rounding="md" testID={`admin-missing-widget-${widgetId}`}>
12
+ <Text color="secondaryDark" size="sm">
13
+ {`Unknown admin ${bucket} widget "${widgetId}". Register it on AdminProvider.widgets.${bucket}.`}
14
+ </Text>
15
+ </Box>
16
+ );
17
+ };
@@ -0,0 +1,94 @@
1
+ import {Box, Card, Heading, IconButton, Spinner, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps, AdminModelConfig} from "../types";
6
+ import {useAdminApi} from "../useAdminApi";
7
+
8
+ const ModelGridCard: React.FC<{
9
+ api: AdminHomeWidgetProps["api"];
10
+ model: AdminModelConfig;
11
+ routeBase: string;
12
+ }> = ({api, model, routeBase}) => {
13
+ const {useListQuery} = useAdminApi(api, model.routePath, model.name);
14
+ const {data, isLoading} = useListQuery({limit: 1, page: 1}, {skip: !model.routePath});
15
+ const total = (data as {total?: number} | undefined)?.total;
16
+ const fieldCount = Object.keys(model.fields).length;
17
+ const createEnabled = model.permissions?.create !== false;
18
+
19
+ const onOpen = useCallback((): void => {
20
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
21
+ const href = `${prefix}/${model.name}` as Href;
22
+ router.push(href);
23
+ }, [routeBase, model.name]);
24
+
25
+ const onCreate = useCallback((): void => {
26
+ if (!createEnabled) {
27
+ return;
28
+ }
29
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
30
+ router.push(`${prefix}/${model.name}/create` as Href);
31
+ }, [createEnabled, routeBase, model.name]);
32
+
33
+ return (
34
+ <Box
35
+ accessibilityHint={`Open ${model.displayName} admin`}
36
+ accessibilityLabel={model.displayName}
37
+ border="default"
38
+ padding={3}
39
+ rounding="md"
40
+ width={220}
41
+ >
42
+ <Box alignItems="start" direction="row" gap={2} justifyContent="between">
43
+ <Box
44
+ accessibilityHint={`View ${model.displayName} list`}
45
+ accessibilityLabel={model.displayName}
46
+ flex="grow"
47
+ minWidth={0}
48
+ onClick={onOpen}
49
+ testID={`admin-home-models-grid-${model.name}`}
50
+ >
51
+ <Text bold>{model.displayName}</Text>
52
+ <Text color="secondaryDark" size="sm">
53
+ {`${fieldCount} fields`}
54
+ </Text>
55
+ <Box marginTop={1}>
56
+ {isLoading ? (
57
+ <Spinner />
58
+ ) : (
59
+ <Text
60
+ color="secondaryDark"
61
+ size="sm"
62
+ testID={`admin-home-model-count-${model.name}`}
63
+ >{`${total != null ? total : "—"} rows`}</Text>
64
+ )}
65
+ </Box>
66
+ </Box>
67
+ {createEnabled ? (
68
+ <IconButton
69
+ accessibilityHint={`Create new ${model.displayName}`}
70
+ accessibilityLabel={`Add ${model.displayName}`}
71
+ iconName="plus"
72
+ onClick={onCreate}
73
+ testID={`admin-home-model-add-${model.name}`}
74
+ tooltipText="Add new"
75
+ variant="secondary"
76
+ />
77
+ ) : null}
78
+ </Box>
79
+ </Box>
80
+ );
81
+ };
82
+
83
+ export const ModelsGridWidget: React.FC<AdminHomeWidgetProps> = ({api, models, routeBase}) => {
84
+ return (
85
+ <Card padding={4} testID="admin-home-widget-modelsGrid">
86
+ <Heading size="sm">Models</Heading>
87
+ <Box direction="row" gap={3} marginTop={2} wrap>
88
+ {models.map((m) => (
89
+ <ModelGridCard api={api} key={m.name} model={m} routeBase={routeBase} />
90
+ ))}
91
+ </Box>
92
+ </Card>
93
+ );
94
+ };
@@ -0,0 +1,81 @@
1
+ import {Box, Card, Heading, printDateAndTime, Spinner, Text} from "@terreno/ui";
2
+ import React, {useMemo} from "react";
3
+ import type {AdminFieldValue, AdminHomeWidgetProps} from "../types";
4
+ import {useAdminApi} from "../useAdminApi";
5
+
6
+ export const RecentActivityWidget: React.FC<AdminHomeWidgetProps> = ({api, auditModel}) => {
7
+ const {useListQuery} = useAdminApi(api, auditModel?.routePath ?? "", auditModel?.name ?? "");
8
+ const {data, isLoading, isError} = useListQuery(
9
+ {limit: 8, page: 1, sort: "-createdAt"},
10
+ {skip: !auditModel?.routePath}
11
+ );
12
+
13
+ const rows = useMemo((): Record<string, AdminFieldValue>[] => {
14
+ const body = data as {data?: Record<string, AdminFieldValue>[]} | undefined;
15
+ return Array.isArray(body?.data) ? body.data : [];
16
+ }, [data]);
17
+
18
+ if (!auditModel) {
19
+ return (
20
+ <Card padding={4} testID="admin-home-widget-recentActivity">
21
+ <Heading size="sm">Recent activity</Heading>
22
+ <Box marginTop={2}>
23
+ <Text color="secondaryDark" size="sm">
24
+ Register an AdminAuditLog model to show recent mutations here.
25
+ </Text>
26
+ </Box>
27
+ </Card>
28
+ );
29
+ }
30
+
31
+ return (
32
+ <Card padding={4} testID="admin-home-widget-recentActivity">
33
+ <Heading size="sm">Recent activity</Heading>
34
+ {isLoading ? (
35
+ <Box alignItems="center" marginTop={3} padding={2}>
36
+ <Spinner />
37
+ </Box>
38
+ ) : null}
39
+ {isError ? (
40
+ <Box marginTop={2}>
41
+ <Text color="error" size="sm">
42
+ Could not load audit entries.
43
+ </Text>
44
+ </Box>
45
+ ) : null}
46
+ {!isLoading && !isError && rows.length === 0 ? (
47
+ <Box marginTop={2}>
48
+ <Text color="secondaryDark" size="sm">
49
+ No audit entries yet.
50
+ </Text>
51
+ </Box>
52
+ ) : null}
53
+ {!isLoading && !isError && rows.length > 0 ? (
54
+ <Box gap={2} marginTop={2}>
55
+ {rows.map((row) => {
56
+ const id = String(row._id ?? row.id ?? "");
57
+ const verb = String(row.verb ?? "");
58
+ const modelName = String(row.modelName ?? "");
59
+ const label = String(row.recordLabel ?? row.recordId ?? "");
60
+ const created = row.createdAt ?? row.created;
61
+ const when =
62
+ typeof created === "string" ? printDateAndTime(created, {defaultValue: created}) : "";
63
+ return (
64
+ <Box border="default" key={id || `${verb}-${label}`} padding={2} rounding="sm">
65
+ <Text size="sm">
66
+ <Text bold>{verb}</Text> {modelName}
67
+ {label ? ` — ${label}` : ""}
68
+ </Text>
69
+ {when ? (
70
+ <Text color="secondaryDark" size="sm">
71
+ {when}
72
+ </Text>
73
+ ) : null}
74
+ </Box>
75
+ );
76
+ })}
77
+ </Box>
78
+ ) : null}
79
+ </Card>
80
+ );
81
+ };
@@ -0,0 +1,26 @@
1
+ import {Box, Button, Card, Heading, Text} from "@terreno/ui";
2
+ import type {Href} from "expo-router";
3
+ import {router} from "expo-router";
4
+ import React, {useCallback} from "react";
5
+ import type {AdminHomeWidgetProps} from "../types";
6
+
7
+ export const ScriptRunnerWidget: React.FC<AdminHomeWidgetProps> = ({routeBase}) => {
8
+ const onScripts = useCallback((): void => {
9
+ const prefix = routeBase.endsWith("/") ? routeBase.slice(0, -1) : routeBase;
10
+ router.push(`${prefix}/__scripts` as Href);
11
+ }, [routeBase]);
12
+
13
+ return (
14
+ <Card padding={4} testID="admin-home-widget-scriptRunner">
15
+ <Heading size="sm">Scripts</Heading>
16
+ <Box marginTop={1}>
17
+ <Text color="secondaryDark" size="sm">
18
+ Run registered admin maintenance scripts.
19
+ </Text>
20
+ </Box>
21
+ <Box marginTop={2}>
22
+ <Button onClick={onScripts} text="Open scripts" variant="primary" />
23
+ </Box>
24
+ </Card>
25
+ );
26
+ };
@@ -0,0 +1,12 @@
1
+ import {AdminVersionConfig} from "../AdminVersionConfig";
2
+ import type {AdminScreenWidgetProps} from "../types";
3
+
4
+ /** Full-page version config screen (`version-config` route). */
5
+ export const VersionConfigScreenWidget: React.FC<AdminScreenWidgetProps> = ({
6
+ api,
7
+ apiBase,
8
+ baseUrl,
9
+ routeBase,
10
+ }) => {
11
+ return <AdminVersionConfig api={api} apiBase={apiBase} baseUrl={baseUrl} routeBase={routeBase} />;
12
+ };
@@ -0,0 +1,7 @@
1
+ import {AdminVersionConfig} from "../AdminVersionConfig";
2
+ import type {AdminHomeWidgetProps} from "../types";
3
+
4
+ /** Home-slot wrapper around the version config editor (embedded panel). */
5
+ export const VersionConfigWidget: React.FC<AdminHomeWidgetProps> = ({api, apiBase, routeBase}) => {
6
+ return <AdminVersionConfig api={api} apiBase={apiBase} embedded routeBase={routeBase} />;
7
+ };
@@ -0,0 +1,180 @@
1
+ import {MarkdownEditorField, SelectField, TextField} from "@terreno/ui";
2
+ import startCase from "lodash/startCase";
3
+ import React from "react";
4
+ import {CheckboxListEditor} from "../CheckboxListEditor";
5
+ import {LocaleContentEditor} from "../LocaleContentEditor";
6
+ import type {AdminFieldValue, AdminFieldWidgetProps} from "../types";
7
+
8
+ const serializeJsonValue = (val: AdminFieldValue): string => {
9
+ if (val == null) {
10
+ return "";
11
+ }
12
+ if (typeof val === "string") {
13
+ return val;
14
+ }
15
+ return JSON.stringify(val, null, 2);
16
+ };
17
+
18
+ export const MarkdownFieldWidget: React.FC<AdminFieldWidgetProps> = ({
19
+ fieldKey,
20
+ fieldConfig,
21
+ value,
22
+ onChange,
23
+ errorText,
24
+ readOnly,
25
+ }) => {
26
+ const label = startCase(fieldKey);
27
+ const isReadOnly = Boolean(readOnly);
28
+ return (
29
+ <MarkdownEditorField
30
+ disabled={isReadOnly}
31
+ errorText={errorText}
32
+ helperText={fieldConfig.description}
33
+ onChange={onChange}
34
+ testID={`admin-field-${fieldKey}`}
35
+ title={label}
36
+ value={typeof value === "string" ? value : ""}
37
+ />
38
+ );
39
+ };
40
+
41
+ export const TextareaFieldWidget: React.FC<AdminFieldWidgetProps> = ({
42
+ fieldKey,
43
+ fieldConfig,
44
+ value,
45
+ onChange,
46
+ errorText,
47
+ readOnly,
48
+ }) => {
49
+ const label = startCase(fieldKey);
50
+ const isReadOnly = Boolean(readOnly);
51
+ return (
52
+ <TextField
53
+ disabled={isReadOnly}
54
+ errorText={errorText}
55
+ grow
56
+ helperText={fieldConfig.description}
57
+ multiline
58
+ onChange={onChange}
59
+ rows={6}
60
+ testID={`admin-field-${fieldKey}`}
61
+ title={label}
62
+ value={typeof value === "string" ? value : ""}
63
+ />
64
+ );
65
+ };
66
+
67
+ export const CheckboxListFieldWidget: React.FC<AdminFieldWidgetProps> = ({
68
+ fieldKey,
69
+ fieldConfig,
70
+ value,
71
+ onChange,
72
+ errorText,
73
+ readOnly,
74
+ }) => {
75
+ const label = startCase(fieldKey);
76
+ const isReadOnly = Boolean(readOnly);
77
+ if (isReadOnly) {
78
+ return (
79
+ <TextField
80
+ disabled
81
+ grow
82
+ helperText={fieldConfig.description ?? "Read-only"}
83
+ multiline
84
+ onChange={() => {}}
85
+ rows={6}
86
+ testID={`admin-field-${fieldKey}`}
87
+ title={label}
88
+ value={serializeJsonValue(value)}
89
+ />
90
+ );
91
+ }
92
+ return (
93
+ <CheckboxListEditor
94
+ errorText={errorText}
95
+ helperText={fieldConfig.description}
96
+ onChange={onChange}
97
+ title={label}
98
+ value={
99
+ Array.isArray(value)
100
+ ? (value as React.ComponentProps<typeof CheckboxListEditor>["value"])
101
+ : []
102
+ }
103
+ />
104
+ );
105
+ };
106
+
107
+ export const LocaleContentFieldWidget: React.FC<AdminFieldWidgetProps> = ({
108
+ fieldKey,
109
+ fieldConfig,
110
+ value,
111
+ onChange,
112
+ errorText,
113
+ readOnly,
114
+ }) => {
115
+ const label = startCase(fieldKey);
116
+ const isReadOnly = Boolean(readOnly);
117
+ const localeValue =
118
+ value && typeof value === "object" && !Array.isArray(value)
119
+ ? (value as Record<string, string>)
120
+ : {};
121
+ if (isReadOnly) {
122
+ return (
123
+ <TextField
124
+ disabled
125
+ grow
126
+ helperText={fieldConfig.description ?? "Read-only"}
127
+ multiline
128
+ onChange={() => {}}
129
+ rows={8}
130
+ testID={`admin-field-${fieldKey}`}
131
+ title={label}
132
+ value={serializeJsonValue(localeValue)}
133
+ />
134
+ );
135
+ }
136
+ return (
137
+ <LocaleContentEditor
138
+ errorText={errorText}
139
+ helperText={fieldConfig.description}
140
+ onChange={onChange}
141
+ title={label}
142
+ value={localeValue}
143
+ />
144
+ );
145
+ };
146
+
147
+ export const LocaleDefaultFieldWidget: React.FC<AdminFieldWidgetProps> = ({
148
+ fieldKey,
149
+ fieldConfig,
150
+ value,
151
+ onChange,
152
+ errorText,
153
+ readOnly,
154
+ parentFormState,
155
+ }) => {
156
+ const label = startCase(fieldKey);
157
+ const isReadOnly = Boolean(readOnly);
158
+ const contentMap = parentFormState?.content;
159
+ const localeKeys =
160
+ contentMap && typeof contentMap === "object" && !Array.isArray(contentMap)
161
+ ? Object.keys(contentMap)
162
+ : [];
163
+ const hasLocales = localeKeys.length > 0;
164
+ const options = localeKeys.map((k) => ({label: k.toUpperCase(), value: k}));
165
+ return (
166
+ <SelectField
167
+ disabled={!hasLocales || isReadOnly}
168
+ errorText={errorText}
169
+ helperText={
170
+ hasLocales
171
+ ? fieldConfig.description
172
+ : "Add at least one locale with content before setting a default locale."
173
+ }
174
+ onChange={onChange}
175
+ options={options}
176
+ title={label}
177
+ value={typeof value === "string" ? value : ""}
178
+ />
179
+ );
180
+ };
@@ -0,0 +1,51 @@
1
+ import type {
2
+ AdminWidgetRegistry,
3
+ FieldWidgetComponent,
4
+ HomeWidgetComponent,
5
+ ScreenWidgetComponent,
6
+ } from "../types";
7
+ import {AI_ADMIN_WIDGETS} from "./AIRequestsScreenWidget";
8
+ import {MarkdownFieldWidget, TextareaFieldWidget} from "./builtInFieldWidgets";
9
+ import {CONSENT_ADMIN_WIDGETS} from "./consentWidgets";
10
+ import {DOCUMENT_STORAGE_ADMIN_WIDGETS} from "./DocumentsScreenWidget";
11
+ import {FeatureFlagsOverridesWidget} from "./FeatureFlagsOverridesWidget";
12
+ import {ModelsGridWidget} from "./ModelsGridWidget";
13
+ import {RecentActivityWidget} from "./RecentActivityWidget";
14
+ import {ScriptRunnerWidget} from "./ScriptRunnerWidget";
15
+ import {VersionConfigScreenWidget} from "./VersionConfigScreenWidget";
16
+ import {VersionConfigWidget} from "./VersionConfigWidget";
17
+
18
+ export const BUILT_IN_HOME_WIDGETS: Record<string, HomeWidgetComponent> = {
19
+ "feature-flags-overrides": FeatureFlagsOverridesWidget,
20
+ modelStats: ModelsGridWidget,
21
+ modelsGrid: ModelsGridWidget,
22
+ recentActivity: RecentActivityWidget,
23
+ scriptRunner: ScriptRunnerWidget,
24
+ versionConfig: VersionConfigWidget,
25
+ };
26
+
27
+ export const BUILT_IN_SCREEN_WIDGETS: Record<string, ScreenWidgetComponent> = {
28
+ ...AI_ADMIN_WIDGETS,
29
+ ...DOCUMENT_STORAGE_ADMIN_WIDGETS,
30
+ "version-config": VersionConfigScreenWidget,
31
+ };
32
+
33
+ export const BUILT_IN_FIELD_WIDGETS: Record<string, FieldWidgetComponent> = {
34
+ ...CONSENT_ADMIN_WIDGETS,
35
+ markdown: MarkdownFieldWidget,
36
+ textarea: TextareaFieldWidget,
37
+ };
38
+
39
+ export const BUILT_IN_WIDGET_REGISTRY: AdminWidgetRegistry = {
40
+ fields: BUILT_IN_FIELD_WIDGETS,
41
+ home: BUILT_IN_HOME_WIDGETS,
42
+ screens: BUILT_IN_SCREEN_WIDGETS,
43
+ };
44
+
45
+ export const mergeWidgetRegistry = (
46
+ userWidgets?: Partial<AdminWidgetRegistry>
47
+ ): AdminWidgetRegistry => ({
48
+ fields: {...BUILT_IN_FIELD_WIDGETS, ...userWidgets?.fields},
49
+ home: {...BUILT_IN_HOME_WIDGETS, ...userWidgets?.home},
50
+ screens: {...BUILT_IN_SCREEN_WIDGETS, ...userWidgets?.screens},
51
+ });
@@ -0,0 +1,13 @@
1
+ import type {FieldWidgetComponent} from "../types";
2
+ import {
3
+ CheckboxListFieldWidget,
4
+ LocaleContentFieldWidget,
5
+ LocaleDefaultFieldWidget,
6
+ } from "./builtInFieldWidgets";
7
+
8
+ /** Field widgets referenced by ConsentApp's contributed model configuration. */
9
+ export const CONSENT_ADMIN_WIDGETS: Record<string, FieldWidgetComponent> = {
10
+ "checkbox-list": CheckboxListFieldWidget,
11
+ "locale-content": LocaleContentFieldWidget,
12
+ "locale-default": LocaleDefaultFieldWidget,
13
+ };
@@ -0,0 +1,38 @@
1
+ export const BUILTIN_HOME_WIDGET_IDS = new Set([
2
+ "modelStats",
3
+ "modelsGrid",
4
+ "feature-flags-overrides",
5
+ "versionConfig",
6
+ "scriptRunner",
7
+ "recentActivity",
8
+ ]);
9
+
10
+ export const normalizeWidgetIds = (ids: string[] | undefined): string[] => {
11
+ if (!ids?.length) {
12
+ return [];
13
+ }
14
+ const out: string[] = [];
15
+ const seen = new Set<string>();
16
+ for (const id of ids) {
17
+ const normalized = id === "modelStats" ? "modelsGrid" : id;
18
+ if (seen.has(normalized)) {
19
+ continue;
20
+ }
21
+ seen.add(normalized);
22
+ out.push(normalized);
23
+ }
24
+ return out;
25
+ };
26
+
27
+ export const normalizeSidebarWidgets = (ids: string[] | undefined): string[] => {
28
+ const normalized = normalizeWidgetIds(ids);
29
+ if (!normalized.length) {
30
+ return normalized;
31
+ }
32
+ const tail = "recentActivity";
33
+ const without = normalized.filter((id) => id !== tail);
34
+ if (normalized.includes(tail)) {
35
+ return [...without, tail];
36
+ }
37
+ return normalized;
38
+ };
@@ -0,0 +1,29 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {AI_ADMIN_WIDGETS} from "./AIRequestsScreenWidget";
3
+ import {CONSENT_ADMIN_WIDGETS} from "./consentWidgets";
4
+ import {DOCUMENT_STORAGE_ADMIN_WIDGETS} from "./DocumentsScreenWidget";
5
+ import {
6
+ FEATURE_FLAGS_ADMIN_WIDGETS,
7
+ FeatureFlagsOverridesWidget,
8
+ } from "./FeatureFlagsOverridesWidget";
9
+
10
+ describe("plugin admin widget registries", () => {
11
+ it("exports feature flags home widgets by contribution id", () => {
12
+ expect(FEATURE_FLAGS_ADMIN_WIDGETS["feature-flags-overrides"]).toBe(
13
+ FeatureFlagsOverridesWidget
14
+ );
15
+ });
16
+
17
+ it("exports consent field widgets by configured widget id", () => {
18
+ expect(Object.keys(CONSENT_ADMIN_WIDGETS).sort()).toEqual([
19
+ "checkbox-list",
20
+ "locale-content",
21
+ "locale-default",
22
+ ]);
23
+ });
24
+
25
+ it("exports documents and AI request screen widgets by custom screen name", () => {
26
+ expect(DOCUMENT_STORAGE_ADMIN_WIDGETS.documents).toBeDefined();
27
+ expect(AI_ADMIN_WIDGETS["ai-requests"]).toBeDefined();
28
+ });
29
+ });