@terreno/admin-frontend 57.0.0 → 57.1.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 (150) 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 +15 -3
  16. package/dist/AdminModelForm.js.map +1 -1
  17. package/dist/AdminModelList.d.ts +2 -1
  18. package/dist/AdminModelList.js +2 -0
  19. package/dist/AdminModelList.js.map +1 -1
  20. package/dist/AdminModelTable.js +54 -97
  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 +126 -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/AdminShell.d.ts +2 -0
  43. package/dist/AdminShell.js +53 -19
  44. package/dist/AdminShell.js.map +1 -1
  45. package/dist/Constants.d.ts +4 -0
  46. package/dist/Constants.js +5 -0
  47. package/dist/Constants.js.map +1 -0
  48. package/dist/adminModelListQueryParams.d.ts +4 -0
  49. package/dist/adminModelListQueryParams.js +38 -3
  50. package/dist/adminModelListQueryParams.js.map +1 -1
  51. package/dist/index.d.ts +19 -1
  52. package/dist/index.js +17 -0
  53. package/dist/index.js.map +1 -1
  54. package/dist/types.d.ts +61 -0
  55. package/dist/types.js.map +1 -1
  56. package/dist/useAdminRoles.d.ts +65 -0
  57. package/dist/useAdminRoles.js +84 -0
  58. package/dist/useAdminRoles.js.map +1 -0
  59. package/dist/useDocumentStorageApi.js +2 -2
  60. package/dist/useDocumentStorageApi.js.map +1 -1
  61. package/dist/widgets/AIRequestsScreenWidget.d.ts +4 -0
  62. package/dist/widgets/AIRequestsScreenWidget.js +54 -0
  63. package/dist/widgets/AIRequestsScreenWidget.js.map +1 -0
  64. package/dist/widgets/CustomScreensListWidget.d.ts +4 -0
  65. package/dist/widgets/CustomScreensListWidget.js +21 -0
  66. package/dist/widgets/CustomScreensListWidget.js.map +1 -0
  67. package/dist/widgets/DocumentsScreenWidget.d.ts +4 -0
  68. package/dist/widgets/DocumentsScreenWidget.js +9 -0
  69. package/dist/widgets/DocumentsScreenWidget.js.map +1 -0
  70. package/dist/widgets/FeatureFlagsOverridesWidget.d.ts +4 -0
  71. package/dist/widgets/FeatureFlagsOverridesWidget.js +18 -0
  72. package/dist/widgets/FeatureFlagsOverridesWidget.js.map +1 -0
  73. package/dist/widgets/MissingWidget.d.ts +7 -0
  74. package/dist/widgets/MissingWidget.js +6 -0
  75. package/dist/widgets/MissingWidget.js.map +1 -0
  76. package/dist/widgets/ModelsGridWidget.d.ts +3 -0
  77. package/dist/widgets/ModelsGridWidget.js +30 -0
  78. package/dist/widgets/ModelsGridWidget.js.map +1 -0
  79. package/dist/widgets/RecentActivityWidget.d.ts +3 -0
  80. package/dist/widgets/RecentActivityWidget.js +27 -0
  81. package/dist/widgets/RecentActivityWidget.js.map +1 -0
  82. package/dist/widgets/ScriptRunnerWidget.d.ts +3 -0
  83. package/dist/widgets/ScriptRunnerWidget.js +12 -0
  84. package/dist/widgets/ScriptRunnerWidget.js.map +1 -0
  85. package/dist/widgets/VersionConfigScreenWidget.d.ts +3 -0
  86. package/dist/widgets/VersionConfigScreenWidget.js +7 -0
  87. package/dist/widgets/VersionConfigScreenWidget.js.map +1 -0
  88. package/dist/widgets/VersionConfigWidget.d.ts +3 -0
  89. package/dist/widgets/VersionConfigWidget.js +7 -0
  90. package/dist/widgets/VersionConfigWidget.js.map +1 -0
  91. package/dist/widgets/builtInFieldWidgets.d.ts +7 -0
  92. package/dist/widgets/builtInFieldWidgets.js +61 -0
  93. package/dist/widgets/builtInFieldWidgets.js.map +1 -0
  94. package/dist/widgets/builtInWidgets.d.ts +6 -0
  95. package/dist/widgets/builtInWidgets.js +31 -0
  96. package/dist/widgets/builtInWidgets.js.map +1 -0
  97. package/dist/widgets/consentWidgets.d.ts +3 -0
  98. package/dist/widgets/consentWidgets.js +8 -0
  99. package/dist/widgets/consentWidgets.js.map +1 -0
  100. package/dist/widgets/homeWidgetUtils.d.ts +3 -0
  101. package/dist/widgets/homeWidgetUtils.js +37 -0
  102. package/dist/widgets/homeWidgetUtils.js.map +1 -0
  103. package/package.json +3 -2
  104. package/src/AdminActionMenu.test.tsx +78 -0
  105. package/src/AdminActionMenu.tsx +106 -0
  106. package/src/AdminFieldRenderer.tsx +2 -0
  107. package/src/AdminFieldRendererCore.tsx +54 -133
  108. package/src/AdminFilterDrawer.test.tsx +89 -0
  109. package/src/AdminFilterDrawer.tsx +333 -0
  110. package/src/AdminHome.tsx +38 -325
  111. package/src/AdminModelForm.test.tsx +45 -0
  112. package/src/AdminModelForm.tsx +24 -1
  113. package/src/AdminModelList.tsx +4 -1
  114. package/src/AdminModelTable.test.tsx +73 -0
  115. package/src/AdminModelTable.tsx +105 -194
  116. package/src/AdminObjectPicker.tsx +49 -9
  117. package/src/AdminPrimitiveArrayField.tsx +5 -0
  118. package/src/AdminProvider.test.tsx +25 -0
  119. package/src/AdminProvider.tsx +121 -0
  120. package/src/AdminRefField.tsx +4 -0
  121. package/src/AdminRolesField.tsx +129 -0
  122. package/src/AdminRolesList.test.tsx +257 -0
  123. package/src/AdminRolesList.tsx +311 -0
  124. package/src/AdminScreenRouter.test.tsx +112 -0
  125. package/src/AdminScreenRouter.tsx +104 -0
  126. package/src/AdminShell.test.tsx +107 -1
  127. package/src/AdminShell.tsx +143 -67
  128. package/src/Constants.ts +5 -0
  129. package/src/adminModelListQueryParams.test.ts +69 -0
  130. package/src/adminModelListQueryParams.ts +49 -3
  131. package/src/index.tsx +50 -0
  132. package/src/isolated/AdminObjectPicker.isolated.tsx +10 -1
  133. package/src/types.ts +65 -0
  134. package/src/useAdminRoles.ts +146 -0
  135. package/src/useDocumentStorageApi.ts +2 -2
  136. package/src/widgets/AIRequestsScreenWidget.tsx +93 -0
  137. package/src/widgets/CustomScreensListWidget.tsx +56 -0
  138. package/src/widgets/DocumentsScreenWidget.tsx +11 -0
  139. package/src/widgets/FeatureFlagsOverridesWidget.tsx +48 -0
  140. package/src/widgets/MissingWidget.tsx +17 -0
  141. package/src/widgets/ModelsGridWidget.tsx +94 -0
  142. package/src/widgets/RecentActivityWidget.tsx +81 -0
  143. package/src/widgets/ScriptRunnerWidget.tsx +26 -0
  144. package/src/widgets/VersionConfigScreenWidget.tsx +12 -0
  145. package/src/widgets/VersionConfigWidget.tsx +7 -0
  146. package/src/widgets/builtInFieldWidgets.tsx +180 -0
  147. package/src/widgets/builtInWidgets.ts +51 -0
  148. package/src/widgets/consentWidgets.ts +13 -0
  149. package/src/widgets/homeWidgetUtils.ts +38 -0
  150. package/src/widgets/pluginWidgets.test.tsx +29 -0
@@ -33,6 +33,8 @@ export interface AdminShellProps {
33
33
  footer?: React.ReactNode;
34
34
  /** Optional right side of the top bar (e.g. primary action for the current screen). */
35
35
  headerActions?: React.ReactNode;
36
+ /** Path to RBAC roles screen (e.g. "/roles") */
37
+ rolesPath?: string;
36
38
  routeBase?: string;
37
39
  /** Extra custom screens merged with backend config for nav cards */
38
40
  customScreens?: AdminCustomScreen[];
@@ -59,6 +61,14 @@ const NavButton: React.FC<{
59
61
  </Box>
60
62
  );
61
63
 
64
+ const isAuditLogModel = (model: AdminModelConfig): boolean => {
65
+ return model.name === "AdminAuditLog" || model.routePath.includes("audit-log");
66
+ };
67
+
68
+ const isFeatureFlagModel = (model: AdminModelConfig): boolean => {
69
+ return model.name === "FeatureFlag" || model.displayName === "Feature Flags";
70
+ };
71
+
62
72
  interface AdminShellSidebarNavProps {
63
73
  allCustomScreens: AdminCustomScreen[];
64
74
  configurationPath?: string;
@@ -66,6 +76,7 @@ interface AdminShellSidebarNavProps {
66
76
  grouped: ReturnType<typeof groupAdminModelsByGroup>;
67
77
  navigate: (path: string) => void;
68
78
  onNavigate?: () => void;
79
+ rolesPath?: string;
69
80
  scripts: {name: string}[];
70
81
  sidebarVariant: AdminShellSidebarVariant;
71
82
  versionConfigPath: string;
@@ -78,12 +89,30 @@ const AdminShellSidebarNav: React.FC<AdminShellSidebarNavProps> = ({
78
89
  grouped,
79
90
  navigate,
80
91
  onNavigate,
92
+ rolesPath,
81
93
  scripts,
82
94
  sidebarVariant,
83
95
  versionConfigPath,
84
96
  }) => {
85
97
  const sidebarIsColorful = sidebarVariant === "colorful";
86
98
  const sectionLabelColor = sidebarIsColorful ? "inverted" : "secondaryDark";
99
+ const models = grouped.flatMap(({models: groupModels}) => groupModels);
100
+ const auditLogModel = models.find(isAuditLogModel);
101
+ const featureFlagModel = models.find(isFeatureFlagModel);
102
+ const visibleGrouped = grouped
103
+ .map(({group, models: groupModels}) => ({
104
+ group,
105
+ models: groupModels.filter((model) => !isAuditLogModel(model) && !isFeatureFlagModel(model)),
106
+ }))
107
+ .filter(({models: groupModels}) => groupModels.length > 0);
108
+ const hasPlatformLinks = Boolean(
109
+ scripts.length > 0 ||
110
+ rolesPath ||
111
+ versionConfigPath ||
112
+ auditLogModel ||
113
+ featureFlagModel ||
114
+ configurationPath
115
+ );
87
116
 
88
117
  const runNav = useCallback(
89
118
  (action: () => void): void => {
@@ -95,71 +124,48 @@ const AdminShellSidebarNav: React.FC<AdminShellSidebarNavProps> = ({
95
124
 
96
125
  return (
97
126
  <>
98
- <Box direction="column" flex="grow" gap={3} minHeight={0} overflow="scrollY">
99
- <NavButton
100
- label="Home"
101
- onPress={() => {
102
- runNav(() => {
103
- navigate("/");
104
- });
105
- }}
106
- sidebarVariant={sidebarVariant}
107
- testID="admin-shell-nav-home"
108
- />
109
- <Box direction="column" gap={1}>
110
- <Text bold color={sectionLabelColor} size="sm">
111
- Tools
112
- </Text>
113
- {scripts.length > 0 ? (
114
- <NavButton
115
- label="Scripts"
116
- onPress={() => {
117
- runNav(() => {
118
- navigate("/__scripts");
119
- });
120
- }}
121
- sidebarVariant={sidebarVariant}
122
- testID="admin-shell-nav-scripts"
123
- />
124
- ) : null}
127
+ <Box direction="column" flex="grow" gap={4} minHeight={0} overflow="scrollY">
128
+ <Box direction="column">
125
129
  <NavButton
126
- label="Version"
130
+ label="Home"
127
131
  onPress={() => {
128
132
  runNav(() => {
129
- navigate(versionConfigPath);
133
+ navigate("/");
130
134
  });
131
135
  }}
132
136
  sidebarVariant={sidebarVariant}
133
- testID="admin-shell-nav-version"
137
+ testID="admin-shell-nav-home"
134
138
  />
135
139
  </Box>
136
- <Box direction="column" gap={1}>
137
- <Text bold color={sectionLabelColor} size="sm">
138
- Models
139
- </Text>
140
- {grouped.map(({group, models}) => (
141
- <Box direction="column" gap={1} key={group}>
142
- <Text bold color={sectionLabelColor} size="sm">
143
- {group}
144
- </Text>
145
- {models.map((model) => (
146
- <NavButton
147
- key={model.name}
148
- label={model.displayName}
149
- onPress={() => {
150
- runNav(() => {
151
- navigate(`/${model.name}`);
152
- });
153
- }}
154
- sidebarVariant={sidebarVariant}
155
- testID={`admin-shell-nav-model-${model.name}`}
156
- />
157
- ))}
158
- </Box>
159
- ))}
160
- </Box>
140
+ {visibleGrouped.length > 0 ? (
141
+ <Box direction="column" gap={3} testID="admin-shell-nav-models">
142
+ <Text bold color={sectionLabelColor} size="sm">
143
+ Models
144
+ </Text>
145
+ {visibleGrouped.map(({group, models: groupModels}) => (
146
+ <Box direction="column" gap={1} key={group}>
147
+ <Text bold color={sectionLabelColor} size="sm">
148
+ {group}
149
+ </Text>
150
+ {groupModels.map((model) => (
151
+ <NavButton
152
+ key={model.name}
153
+ label={model.displayName}
154
+ onPress={() => {
155
+ runNav(() => {
156
+ navigate(`/${model.name}`);
157
+ });
158
+ }}
159
+ sidebarVariant={sidebarVariant}
160
+ testID={`admin-shell-nav-model-${model.name}`}
161
+ />
162
+ ))}
163
+ </Box>
164
+ ))}
165
+ </Box>
166
+ ) : null}
161
167
  {allCustomScreens.length > 0 ? (
162
- <Box direction="column" gap={1}>
168
+ <Box direction="column" gap={1} testID="admin-shell-nav-screens">
163
169
  <Text bold color={sectionLabelColor} size="sm">
164
170
  Screens
165
171
  </Text>
@@ -178,17 +184,85 @@ const AdminShellSidebarNav: React.FC<AdminShellSidebarNavProps> = ({
178
184
  ))}
179
185
  </Box>
180
186
  ) : null}
181
- {configurationPath ? (
182
- <NavButton
183
- label="Configuration"
184
- onPress={() => {
185
- runNav(() => {
186
- router.push(configurationPath as Href);
187
- });
188
- }}
189
- sidebarVariant={sidebarVariant}
190
- testID="admin-shell-nav-configuration"
191
- />
187
+ <Box flex="grow" />
188
+ {hasPlatformLinks ? (
189
+ <Box direction="column" gap={1} testID="admin-shell-nav-platform">
190
+ <Text bold color={sectionLabelColor} size="sm">
191
+ Platform
192
+ </Text>
193
+ {scripts.length > 0 ? (
194
+ <NavButton
195
+ label="Scripts"
196
+ onPress={() => {
197
+ runNav(() => {
198
+ navigate("/__scripts");
199
+ });
200
+ }}
201
+ sidebarVariant={sidebarVariant}
202
+ testID="admin-shell-nav-scripts"
203
+ />
204
+ ) : null}
205
+ {rolesPath ? (
206
+ <NavButton
207
+ label="Roles"
208
+ onPress={() => {
209
+ runNav(() => {
210
+ navigate(rolesPath);
211
+ });
212
+ }}
213
+ sidebarVariant={sidebarVariant}
214
+ testID="admin-shell-nav-roles"
215
+ />
216
+ ) : null}
217
+ {versionConfigPath ? (
218
+ <NavButton
219
+ label="Version"
220
+ onPress={() => {
221
+ runNav(() => {
222
+ navigate(versionConfigPath);
223
+ });
224
+ }}
225
+ sidebarVariant={sidebarVariant}
226
+ testID="admin-shell-nav-version"
227
+ />
228
+ ) : null}
229
+ {auditLogModel ? (
230
+ <NavButton
231
+ label="Audit Log"
232
+ onPress={() => {
233
+ runNav(() => {
234
+ navigate(`/${auditLogModel.name}`);
235
+ });
236
+ }}
237
+ sidebarVariant={sidebarVariant}
238
+ testID="admin-shell-nav-audit-log"
239
+ />
240
+ ) : null}
241
+ {featureFlagModel ? (
242
+ <NavButton
243
+ label="Feature Flags"
244
+ onPress={() => {
245
+ runNav(() => {
246
+ navigate(`/${featureFlagModel.name}`);
247
+ });
248
+ }}
249
+ sidebarVariant={sidebarVariant}
250
+ testID="admin-shell-nav-feature-flags"
251
+ />
252
+ ) : null}
253
+ {configurationPath ? (
254
+ <NavButton
255
+ label="Configuration"
256
+ onPress={() => {
257
+ runNav(() => {
258
+ router.push(configurationPath as Href);
259
+ });
260
+ }}
261
+ sidebarVariant={sidebarVariant}
262
+ testID="admin-shell-nav-configuration"
263
+ />
264
+ ) : null}
265
+ </Box>
192
266
  ) : null}
193
267
  </Box>
194
268
  {footer ? <Box marginTop={4}>{footer}</Box> : null}
@@ -219,6 +293,7 @@ export const AdminShell: React.FC<AdminShellProps> = ({
219
293
  customScreens: propCustomScreens,
220
294
  footer,
221
295
  headerActions,
296
+ rolesPath,
222
297
  routeBase,
223
298
  sidebarVariant = "colorful",
224
299
  versionConfigPath = "/version-config",
@@ -297,6 +372,7 @@ export const AdminShell: React.FC<AdminShellProps> = ({
297
372
  footer,
298
373
  grouped,
299
374
  navigate,
375
+ rolesPath,
300
376
  scripts,
301
377
  sidebarVariant,
302
378
  versionConfigPath,
@@ -0,0 +1,5 @@
1
+ /** Debounce delay for admin list search input before firing list queries. */
2
+ export const ADMIN_SEARCH_DEBOUNCE_MS = 250;
3
+
4
+ /** Viewport width below which filter UI uses a bottom sheet instead of a side drawer. */
5
+ export const ADMIN_FILTER_MOBILE_BREAKPOINT = 768;
@@ -0,0 +1,69 @@
1
+ import {describe, expect, it} from "bun:test";
2
+ import {assert} from "chai";
3
+
4
+ import {
5
+ adminFilterStateHasValues,
6
+ areAdminFilterStatesEqual,
7
+ buildAdminListQueryParams,
8
+ compactAdminFilterState,
9
+ } from "./adminModelListQueryParams";
10
+ import type {AdminModelConfig} from "./types";
11
+
12
+ const todoConfig = {
13
+ filters: [{field: "completed", kind: "boolean", label: "Completed"}],
14
+ searchFields: ["title"],
15
+ } as AdminModelConfig;
16
+
17
+ describe("compactAdminFilterState", () => {
18
+ it("drops undefined, empty string, and all", () => {
19
+ expect(
20
+ compactAdminFilterState({
21
+ active: false,
22
+ completed: undefined,
23
+ name: "",
24
+ role: "all",
25
+ title: " ",
26
+ })
27
+ ).toEqual({active: false});
28
+ });
29
+ });
30
+
31
+ describe("areAdminFilterStatesEqual", () => {
32
+ it("treats empty keys as equal to a missing applied state", () => {
33
+ expect(areAdminFilterStatesEqual({completed: undefined}, {})).toBe(true);
34
+ expect(areAdminFilterStatesEqual({completed: true}, {})).toBe(false);
35
+ });
36
+ });
37
+
38
+ describe("adminFilterStateHasValues", () => {
39
+ it("is false for an empty draft", () => {
40
+ expect(adminFilterStateHasValues({})).toBe(false);
41
+ expect(adminFilterStateHasValues({completed: undefined})).toBe(false);
42
+ });
43
+ });
44
+
45
+ describe("buildAdminListQueryParams", () => {
46
+ it("sends q for case-insensitive partial search instead of an exact field match", () => {
47
+ const params = buildAdminListQueryParams({
48
+ filterState: {},
49
+ limit: 25,
50
+ modelConfig: todoConfig,
51
+ page: 1,
52
+ searchDebounced: "TASK",
53
+ });
54
+ assert.equal(params.q, "TASK");
55
+ assert.isUndefined(params.title);
56
+ });
57
+
58
+ it("omits q when search is blank", () => {
59
+ const params = buildAdminListQueryParams({
60
+ filterState: {completed: true},
61
+ limit: 25,
62
+ modelConfig: todoConfig,
63
+ page: 1,
64
+ searchDebounced: " ",
65
+ });
66
+ assert.isUndefined(params.q);
67
+ assert.equal(params.completed, true);
68
+ });
69
+ });
@@ -4,6 +4,52 @@ export const ADMIN_LIST_MAX_SELECTION = 1000;
4
4
 
5
5
  export type AdminListFilterState = Record<string, string | boolean | undefined>;
6
6
 
7
+ const isEmptyFilterValue = (value: string | boolean | undefined): boolean => {
8
+ if (value === undefined || value === "") {
9
+ return true;
10
+ }
11
+ if (value === "all") {
12
+ return true;
13
+ }
14
+ return false;
15
+ };
16
+
17
+ /** Drops unset / "all" keys so draft vs applied comparison is stable. */
18
+ export const compactAdminFilterState = (
19
+ state: AdminListFilterState
20
+ ): Record<string, string | boolean> => {
21
+ const compacted: Record<string, string | boolean> = {};
22
+ const keys = Object.keys(state).sort();
23
+ for (const key of keys) {
24
+ const value = state[key];
25
+ if (isEmptyFilterValue(value)) {
26
+ continue;
27
+ }
28
+ if (typeof value === "boolean") {
29
+ compacted[key] = value;
30
+ continue;
31
+ }
32
+ compacted[key] = String(value).trim();
33
+ if (compacted[key] === "") {
34
+ delete compacted[key];
35
+ }
36
+ }
37
+ return compacted;
38
+ };
39
+
40
+ export const areAdminFilterStatesEqual = (
41
+ left: AdminListFilterState,
42
+ right: AdminListFilterState
43
+ ): boolean => {
44
+ return (
45
+ JSON.stringify(compactAdminFilterState(left)) === JSON.stringify(compactAdminFilterState(right))
46
+ );
47
+ };
48
+
49
+ export const adminFilterStateHasValues = (state: AdminListFilterState): boolean => {
50
+ return Object.keys(compactAdminFilterState(state)).length > 0;
51
+ };
52
+
7
53
  /**
8
54
  * Builds query params for `GET` admin modelRouter list routes from UI state.
9
55
  */
@@ -53,9 +99,9 @@ export const buildAdminListQueryParams = (input: {
53
99
  out[f.field] = String(raw);
54
100
  }
55
101
  }
56
- const firstSearchField = modelConfig.searchFields?.[0];
57
- if (firstSearchField && searchDebounced.trim() !== "") {
58
- out[firstSearchField] = searchDebounced.trim();
102
+ const searchFields = modelConfig.searchFields ?? [];
103
+ if (searchFields.length > 0 && searchDebounced.trim() !== "") {
104
+ out.q = searchDebounced.trim();
59
105
  }
60
106
  return out;
61
107
  };
package/src/index.tsx CHANGED
@@ -1,5 +1,7 @@
1
+ export {AdminActionMenu} from "./AdminActionMenu";
1
2
  export {type AdminBreadcrumbSegment, AdminBreadcrumbs} from "./AdminBreadcrumbs";
2
3
  export {AdminFieldRenderer} from "./AdminFieldRenderer";
4
+ export {AdminFilterDrawer} from "./AdminFilterDrawer";
3
5
  export {AdminHome} from "./AdminHome";
4
6
  export {AdminModelForm, type AdminModelFormScreenTitleParams} from "./AdminModelForm";
5
7
  export {AdminModelList} from "./AdminModelList";
@@ -7,7 +9,20 @@ export {AdminModelTable} from "./AdminModelTable";
7
9
  export {AdminNestedArrayField} from "./AdminNestedArrayField";
8
10
  export {AdminObjectPicker} from "./AdminObjectPicker";
9
11
  export {AdminPrimitiveArrayField} from "./AdminPrimitiveArrayField";
12
+ export type {AdminProviderProps} from "./AdminProvider";
13
+ export {
14
+ AdminProvider,
15
+ resetAdminWidgetWarningsForTests,
16
+ useAdminContext,
17
+ useDeprecatedCustomScreensProp,
18
+ useFieldWidget,
19
+ useHomeWidget,
20
+ useScreenWidget,
21
+ } from "./AdminProvider";
10
22
  export {AdminRefField, type AdminRefFieldProps} from "./AdminRefField";
23
+ export {AdminRolesField} from "./AdminRolesField";
24
+ export {AdminRolesList} from "./AdminRolesList";
25
+ export {AdminScreenRouter, type AdminScreenRouterProps} from "./AdminScreenRouter";
11
26
  export {AdminScriptList} from "./AdminScriptList";
12
27
  export {AdminScriptRunModal} from "./AdminScriptRunModal";
13
28
  export {AdminShell, type AdminShellProps, type AdminShellSidebarVariant} from "./AdminShell";
@@ -20,22 +35,32 @@ export {ConsentFormEditor} from "./ConsentFormEditor";
20
35
  export {ConsentFormList} from "./ConsentFormList";
21
36
  export {ConsentHistory} from "./ConsentHistory";
22
37
  export {ConsentResponseViewer} from "./ConsentResponseViewer";
38
+ export {ADMIN_FILTER_MOBILE_BREAKPOINT, ADMIN_SEARCH_DEBOUNCE_MS} from "./Constants";
23
39
  export {DocumentStorageBrowser} from "./DocumentStorageBrowser";
24
40
  export {generateConsentHistoryPdf} from "./generateConsentHistoryPdf";
25
41
  export {LocaleContentEditor} from "./LocaleContentEditor";
26
42
  export type {
43
+ AdminCapabilities,
27
44
  AdminConfigResponse,
28
45
  AdminCustomScreen,
29
46
  AdminFieldConfig,
47
+ AdminFieldWidgetProps,
48
+ AdminHomeWidgetProps,
30
49
  AdminModelConfig,
50
+ AdminProviderValue,
31
51
  AdminScreenProps,
52
+ AdminScreenWidgetProps,
32
53
  AdminScriptConfig,
54
+ AdminWidgetRegistry,
33
55
  BackgroundTask,
34
56
  DocumentFile,
35
57
  DocumentListResponse,
36
58
  DocumentStorageBrowserProps,
59
+ FieldWidgetComponent,
60
+ HomeWidgetComponent,
37
61
  RefFieldRendererProps,
38
62
  RefRendererMap,
63
+ ScreenWidgetComponent,
39
64
  } from "./types";
40
65
  export {resolveAdminBases, SYSTEM_FIELDS} from "./types";
41
66
  export {useAdminApi} from "./useAdminApi";
@@ -44,3 +69,28 @@ export {useAdminScripts} from "./useAdminScripts";
44
69
  export {useConfigurationApi} from "./useConfigurationApi";
45
70
  export * from "./useConsentHistory";
46
71
  export {useDocumentStorageApi} from "./useDocumentStorageApi";
72
+ export {
73
+ AI_ADMIN_WIDGETS,
74
+ AIRequestsScreenWidget,
75
+ } from "./widgets/AIRequestsScreenWidget";
76
+ export {
77
+ BUILT_IN_FIELD_WIDGETS,
78
+ BUILT_IN_HOME_WIDGETS,
79
+ BUILT_IN_SCREEN_WIDGETS,
80
+ BUILT_IN_WIDGET_REGISTRY,
81
+ mergeWidgetRegistry,
82
+ } from "./widgets/builtInWidgets";
83
+ export {CustomScreensListWidget} from "./widgets/CustomScreensListWidget";
84
+ export {CONSENT_ADMIN_WIDGETS} from "./widgets/consentWidgets";
85
+ export {
86
+ DOCUMENT_STORAGE_ADMIN_WIDGETS,
87
+ DocumentsScreenWidget,
88
+ } from "./widgets/DocumentsScreenWidget";
89
+ export {
90
+ FEATURE_FLAGS_ADMIN_WIDGETS,
91
+ FeatureFlagsOverridesWidget,
92
+ } from "./widgets/FeatureFlagsOverridesWidget";
93
+ export {ModelsGridWidget} from "./widgets/ModelsGridWidget";
94
+ export {RecentActivityWidget} from "./widgets/RecentActivityWidget";
95
+ export {ScriptRunnerWidget} from "./widgets/ScriptRunnerWidget";
96
+ export {VersionConfigWidget} from "./widgets/VersionConfigWidget";
@@ -4,7 +4,7 @@ import {beforeEach, describe, expect, it, mock} from "bun:test";
4
4
  import {renderWithTheme} from "@terreno/ui/src/test-utils";
5
5
  import {act, fireEvent} from "@testing-library/react-native";
6
6
  import React from "react";
7
- import {AdminObjectPicker} from "../AdminObjectPicker";
7
+ import {AdminObjectPicker as BaseAdminObjectPicker} from "../AdminObjectPicker";
8
8
  import type {AdminApi} from "../types";
9
9
 
10
10
  interface ApiState {
@@ -19,6 +19,11 @@ const apiState: ApiState = {
19
19
  selectedItem: undefined,
20
20
  };
21
21
 
22
+ // This suite exercises the search-as-you-type contract explicitly.
23
+ const AdminObjectPicker: React.FC<React.ComponentProps<typeof BaseAdminObjectPicker>> = (
24
+ props
25
+ ): React.ReactElement => <BaseAdminObjectPicker {...props} autocomplete />;
26
+
22
27
  const querySpecs: unknown[] = [];
23
28
  const makeApi = () => ({
24
29
  injectEndpoints: ({endpoints}: {endpoints: (b: unknown) => Record<string, unknown>}) => {
@@ -36,6 +41,7 @@ const makeApi = () => ({
36
41
  const cap = (s: string) => s.charAt(0).toUpperCase() + s.slice(1);
37
42
  const searchKey = keys.find((k) => k.startsWith("adminSearch_"));
38
43
  const readKey = keys.find((k) => k.startsWith("adminSearchRead_"));
44
+ const listKey = keys.find((k) => k.startsWith("adminPickerList_"));
39
45
  const enhanced: Record<string, unknown> = {};
40
46
  if (searchKey) {
41
47
  enhanced[`use${cap(searchKey)}Query`] = (_q: string, opts: Record<string, unknown>) => {
@@ -53,6 +59,9 @@ const makeApi = () => ({
53
59
  return {data: apiState.selectedItem};
54
60
  };
55
61
  }
62
+ if (listKey) {
63
+ enhanced[`use${cap(listKey)}Query`] = () => ({data: undefined, isFetching: false});
64
+ }
56
65
  return enhanced;
57
66
  },
58
67
  });
package/src/types.ts CHANGED
@@ -82,8 +82,13 @@ export interface AdminModelConfig {
82
82
  * picks a scalar label from common keys (`name`, `title`, …) then the first list column.
83
83
  */
84
84
  recordTitleField?: string;
85
+ /** Fields that use async autocomplete against the model list endpoint (Phase 3+). */
86
+ autocompleteFields?: string[];
87
+ /** Server-side excluded fields (scrubbed from responses; informational for forms). */
88
+ excludeFields?: string[];
85
89
  /** Admin UI v2 — declarative bulk actions */
86
90
  actions?: {
91
+ allowed?: boolean;
87
92
  background?: boolean;
88
93
  confirm?: string;
89
94
  id: string;
@@ -134,12 +139,69 @@ export interface AdminHome {
134
139
  title: string;
135
140
  }
136
141
 
142
+ export interface AdminCapabilities {
143
+ actions: boolean;
144
+ fieldsets: boolean;
145
+ filters: boolean;
146
+ realtime: boolean;
147
+ }
148
+
137
149
  export interface AdminConfigResponse {
150
+ capabilities?: AdminCapabilities;
138
151
  customScreens?: AdminCustomScreen[];
139
152
  home?: AdminHome;
140
153
  models: AdminModelConfig[];
141
154
  schemaVersion?: number;
142
155
  scripts: AdminScriptConfig[];
156
+ /** Plugin home widget ids merged from admin contributions (informational). */
157
+ widgetIds?: string[];
158
+ }
159
+
160
+ /** Props passed to home dashboard widgets resolved from `home.slots`. */
161
+ export interface AdminHomeWidgetProps {
162
+ api: AdminApi;
163
+ apiBase: string;
164
+ routeBase: string;
165
+ config: AdminConfigResponse;
166
+ models: AdminModelConfig[];
167
+ auditModel?: AdminModelConfig;
168
+ featureFlagModel?: AdminModelConfig;
169
+ }
170
+
171
+ /** Props passed to custom admin screen widgets registered in `widgets.screens`. */
172
+ export interface AdminScreenWidgetProps extends AdminScreenProps {
173
+ config: AdminConfigResponse;
174
+ screenName: string;
175
+ }
176
+
177
+ /** Props passed to per-field form widgets registered in `widgets.fields`. */
178
+ export interface AdminFieldWidgetProps extends AdminScreenProps {
179
+ errorText?: string;
180
+ fieldConfig: AdminFieldConfig;
181
+ fieldKey: string;
182
+ modelConfigs?: Array<{name: string; routePath: string}>;
183
+ onChange: (value: AdminFieldValue) => void;
184
+ parentFormState?: Record<string, AdminFieldValue>;
185
+ readOnly?: boolean;
186
+ refRenderers?: RefRendererMap;
187
+ value: AdminFieldValue;
188
+ }
189
+
190
+ export type HomeWidgetComponent = React.FC<AdminHomeWidgetProps>;
191
+ export type ScreenWidgetComponent = React.FC<AdminScreenWidgetProps>;
192
+ export type FieldWidgetComponent = React.FC<AdminFieldWidgetProps>;
193
+
194
+ export interface AdminWidgetRegistry {
195
+ fields: Record<string, FieldWidgetComponent>;
196
+ home: Record<string, HomeWidgetComponent>;
197
+ screens: Record<string, ScreenWidgetComponent>;
198
+ }
199
+
200
+ export interface AdminProviderValue {
201
+ api: AdminApi;
202
+ apiBase: string;
203
+ routeBase: string;
204
+ widgets: AdminWidgetRegistry;
143
205
  }
144
206
 
145
207
  export interface BackgroundTaskProgress {
@@ -251,6 +313,9 @@ export interface RefFieldRendererProps {
251
313
  helperText?: string;
252
314
  /** When true, the picker is display-only and does not submit changes. */
253
315
  readOnly?: boolean;
316
+ /** When true, query the referenced model search endpoint as the user types. */
317
+ autocomplete?: boolean;
318
+ testID?: string;
254
319
  }
255
320
 
256
321
  /**